Workbench Lexicon
Basalt enforces a strict one concept, one word vocabulary rule (CONVENTIONS §1.6). We avoid synonyms ("strip", "bar", "group", "session") for concepts that already have established names in the architecture.
Core UI & Layout Terms
| Term | Meaning | Canonical Code Examples |
|---|---|---|
| view | A side-dock panel hosted in the left or right dock. | viewRegistry, FileExplorerView, BacklinksView |
| leaf | The visual content type rendered inside an active tab. | leafRegistry, MarkdownLeaf, tab.leafType |
| tab | A single open document item in a pane's tab strip. | TabModel, useTabsStore, WorkspaceTabsBar |
| pane | A container node in the split-layout tree hosting one or more tabs. | PaneId, LayoutNode, ROOT_PANE_ID |
| ribbon | The narrow, far-left quick-access action icon bar. | Ribbon, RibbonItem |
| dock | The collapsible side panel container (left or right). | SideDock, dockCommands |
| header band | The top 40px workspace row containing window controls and title. | HeaderBandRule |
| active note | The note currently open in the focused tab and pane. | useActiveNoteStore |
Plugin Architecture Terms (ADR-054 – ADR-058)
| Term | Meaning | Canonical Code Examples |
|---|---|---|
| plugin | A compiled WebAssembly component located in .basalt/plugins/<id>/. | PluginId, manifest.json |
| plugin host | The Rust module orchestrating plugin discovery, compilation, and sandbox execution. | PluginHost::boot(), PluginHost |
| WIT world | The versioned WebAssembly Interface Type contract defining guest imports and exports. | basalt:plugin@0.2.0, plugin.wit |
| capability | A permission token declared in the plugin manifest and enforced at the host seam. | "vault:read", "editor:cm6", "net:http" |
| guest SDK | The Rust crate providing bindings and macros for authoring plugins. | basalt-plugin-sdk, generate_plugin! |
| plugin port | Host-side Rust trait seam decoupling plugin capabilities from the concrete app. | VaultPort, StoragePort, NetPort |
| plugin adapter | Concrete implementation connecting a plugin port to actual app state. | AppVaultPort, AppStoragePort |
Benchmark & Performance Terms
| Term | Meaning | Canonical Code Examples |
|---|---|---|
| surface | A measurable UI surface (modal, view, note leaf, or direct function). | SurfaceSpec, SurfaceKind |
| tier | A dataset scale evaluated during benchmarks (e.g. 1k, 5k, 25k notes). | tiers: [{ id: "vault-25k", ... }] |
| phase | A measured execution step (e.g. mount, keystroke, drag). | { id: "mount", run(ctx) } |
| rep | One repetition of a measured phase for statistical p50/p95 gathering. | reps: 20 |