@hachej/boring-workspace 0.1.59 → 0.1.61

package/dist/boring-workspace.css

@@ -1 +1 @@
-.dv-shell{--dv-background-color: var(--background);--dv-paneview-header-border-color: var(--border);--dv-tabs-and-actions-container-font-size: .8125rem;--dv-tabs-and-actions-container-height: 52px;--dv-tab-close-icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='10' height='10' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%3E%3C/svg%3E");--dv-group-view-background-color: var(--background);--dv-tabs-and-actions-container-background-color: var(--background);--dv-activegroup-visiblepanel-tab-background-color: var(--background);--dv-activegroup-hiddenpanel-tab-background-color: var(--muted);--dv-inactivegroup-visiblepanel-tab-background-color: var(--background);--dv-inactivegroup-hiddenpanel-tab-background-color: var(--muted);--dv-activegroup-visiblepanel-tab-color: var(--foreground);--dv-activegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-inactivegroup-visiblepanel-tab-color: var(--foreground);--dv-inactivegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-tab-divider-color: transparent;--dv-drag-over-background-color: oklch(from var(--accent) l c h / .3);--dv-drag-over-border-color: var(--accent);--dv-separator-border: var(--border);color:var(--foreground);background-color:var(--background)}.dv-shell .dv-tabs-and-actions-container,.dv-shell .tabs-and-actions-container{background-color:var(--background)!important;border-bottom:1px solid oklch(from var(--border) l c h / .4);padding:6px 8px 0;gap:4px;align-items:flex-end}.dv-shell .dv-tabs-container,.dv-shell .tab-container{background-color:transparent!important;gap:4px;align-self:stretch;display:flex;align-items:flex-end}.workbench-dockview .dv-shell .dv-tabs-and-actions-container,.workbench-dockview .dv-shell .tabs-and-actions-container,.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{height:44px!important}.workbench-dockview[data-collapsed-sources=true] .dv-tabs-and-actions-container,.workbench-dockview[data-collapsed-sources=true] .tabs-and-actions-container{padding-left:44px!important}.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{padding-right:44px!important}.dv-shell .dv-tab,.dv-shell .tab{color:var(--muted-foreground)!important;background-color:transparent!important;border:1px solid transparent;border-top-left-radius:8px;border-top-right-radius:8px;transition:color .18s cubic-bezier(.22,1,.36,1),background-color .18s cubic-bezier(.22,1,.36,1),border-color .18s cubic-bezier(.22,1,.36,1);min-width:120px;max-width:220px;padding:0;height:34px;align-self:end;font-size:12.5px;letter-spacing:-.01em}.dv-shell .dv-tab:hover,.dv-shell .tab:hover{color:var(--foreground)!important;background-color:oklch(from var(--foreground) l c h / .04)!important}.dv-shell .dv-tab>*,.dv-shell .tab>*{width:100%;height:100%}.dv-shell .dv-tab.dv-active-tab,.dv-shell .tab.active-tab{color:var(--foreground)!important;background-color:var(--background)!important;border-color:oklch(from var(--border) l c h / .5);border-bottom-color:var(--background);margin-bottom:-1px;position:relative;z-index:1;font-weight:500}.dv-shell .dv-tab.dv-active-tab:before,.dv-shell .tab.active-tab:before{content:"";position:absolute;left:10px;right:10px;top:-1px;height:2px;background:var(--accent);border-radius:0 0 2px 2px;opacity:0;transition:opacity .2s cubic-bezier(.22,1,.36,1)}.dv-shell .dv-tab.dv-active-tab:hover:before,.dv-shell .tab.active-tab:hover:before{opacity:.7}.dv-shell{--dv-sash-color: transparent;--dv-active-sash-color: transparent;--dv-active-sash-transition-delay: 0s}.dv-shell .sash-container .sash,.dv-shell .dv-sash-container .dv-sash{transition:box-shadow .16s cubic-bezier(.22,1,.36,1),background-color .16s cubic-bezier(.22,1,.36,1)}.dv-shell .dv-split-view-container.dv-horizontal>.dv-sash-container>.dv-sash{width:12px;margin-left:-4px}.dv-shell .dv-split-view-container.dv-vertical>.dv-sash-container>.dv-sash{height:12px;margin-top:-4px}.dv-shell .dv-split-view-container.dv-horizontal>.dv-sash-container>.dv-sash:hover,.dv-shell .dv-split-view-container.dv-horizontal>.dv-sash-container>.dv-sash:active{box-shadow:inset 0 0 0 1px oklch(from var(--primary) l c h / .45),inset 5px 0 oklch(from var(--primary) l c h / .35),inset 6px 0 oklch(from var(--primary) l c h / .35)}.dv-shell .dv-split-view-container.dv-vertical>.dv-sash-container>.dv-sash:hover,.dv-shell .dv-split-view-container.dv-vertical>.dv-sash-container>.dv-sash:active{box-shadow:inset 0 0 0 1px oklch(from var(--primary) l c h / .45),inset 0 5px oklch(from var(--primary) l c h / .35),inset 0 6px oklch(from var(--primary) l c h / .35)}.dv-shell .drop-target-dropzone>.drop-target-selection,.dv-shell .dv-drop-target-dropzone>.dv-drop-target-selection{background-color:oklch(from var(--primary) l c h / .15);border:2px dashed var(--primary);border-radius:calc(var(--radius) - 2px)}.dv-shell .watermark,.dv-shell .dv-watermark{color:var(--muted-foreground)}.dv-shell,.dv-shell .dv-dockview,.dv-shell .dv-groupview,.dv-shell .groupview,.dv-shell .groupview>.content-container,.dv-shell .dv-view-container,.dv-shell .view-container{background-color:var(--background)}.dv-shell .dv-groupview,.dv-shell .groupview{color:var(--foreground)}.dv-shell .right-actions-container,.dv-shell .left-actions-container,.dv-shell .dv-right-actions-container,.dv-shell .dv-left-actions-container{color:var(--muted-foreground);display:flex;align-items:center;align-self:stretch}.dv-shell .right-actions-container:hover,.dv-shell .left-actions-container:hover,.dv-shell .dv-right-actions-container:hover,.dv-shell .dv-left-actions-container:hover{color:var(--foreground)}.dv-shell .dv-drag-image{opacity:.85;border:1px solid var(--border);border-radius:calc(var(--radius) - 2px);box-shadow:0 4px 12px #00000026}.dv-chat-stage{--dv-tabs-and-actions-container-height: 32px;--dv-tabs-and-actions-container-font-size: .75rem;--dv-activegroup-visiblepanel-tab-background-color: transparent;--dv-activegroup-hiddenpanel-tab-background-color: transparent;--dv-inactivegroup-visiblepanel-tab-background-color: transparent;--dv-inactivegroup-hiddenpanel-tab-background-color: transparent}.dv-shell.dv-chat-stage .dv-tabs-and-actions-container{border-bottom:none;padding:0;gap:0;align-items:stretch}.dv-shell.dv-chat-stage .dv-tabs-and-actions-container.dv-single-tab .dv-tabs-container{width:100%}.dv-shell.dv-chat-stage .dv-tab,.dv-shell.dv-chat-stage .dv-tab.dv-active-tab{width:100%;height:100%;min-width:0;max-width:none;flex:1 1 auto;align-self:stretch;margin-bottom:0;padding:0;border:none;border-radius:0;background-color:transparent!important}.dv-shell.dv-chat-stage .dv-tab.dv-active-tab:before{content:none}.dv-chat-stage .dv-default-tab-action{display:none}.dv-chat-stage .dv-groupview{position:relative}.dv-chat-stage .dv-groupview:after{content:"";position:absolute;top:0;right:0;bottom:0;left:0;z-index:40;pointer-events:none;background:transparent;transition:background-color .22s cubic-bezier(.22,1,.36,1),box-shadow .22s cubic-bezier(.22,1,.36,1)}[data-boring-workspace-part=chat-pane-stage][data-multi-pane=true] .dv-groupview:not(.dv-active-group):after{background:oklch(from var(--foreground) l c h / .035)}
+.dv-shell{--dv-background-color: var(--background);--dv-paneview-header-border-color: var(--border);--dv-tabs-and-actions-container-font-size: .8125rem;--dv-tabs-and-actions-container-height: 52px;--dv-tab-close-icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='10' height='10' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%3E%3C/svg%3E");--dv-group-view-background-color: var(--background);--dv-tabs-and-actions-container-background-color: var(--background);--dv-activegroup-visiblepanel-tab-background-color: var(--background);--dv-activegroup-hiddenpanel-tab-background-color: var(--muted);--dv-inactivegroup-visiblepanel-tab-background-color: var(--background);--dv-inactivegroup-hiddenpanel-tab-background-color: var(--muted);--dv-activegroup-visiblepanel-tab-color: var(--foreground);--dv-activegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-inactivegroup-visiblepanel-tab-color: var(--foreground);--dv-inactivegroup-hiddenpanel-tab-color: var(--muted-foreground);--dv-tab-divider-color: transparent;--dv-drag-over-background-color: oklch(from var(--accent) l c h / .3);--dv-drag-over-border-color: var(--accent);--dv-separator-border: var(--border);color:var(--foreground);background-color:var(--background)}.dv-shell .dv-tabs-and-actions-container,.dv-shell .tabs-and-actions-container{background-color:var(--background)!important;border-bottom:1px solid oklch(from var(--border) l c h / .4);padding:6px 8px 0;gap:4px;align-items:flex-end}.dv-shell .dv-tabs-container,.dv-shell .tab-container{background-color:transparent!important;gap:4px;align-self:stretch;display:flex;align-items:flex-end}.workbench-dockview .dv-shell .dv-tabs-and-actions-container,.workbench-dockview .dv-shell .tabs-and-actions-container,.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{height:44px!important}.workbench-dockview[data-left-block-collapsed=true] .dv-tabs-and-actions-container,.workbench-dockview[data-left-block-collapsed=true] .tabs-and-actions-container{padding-left:44px!important}[data-boring-workspace-part=plugin-tabs-shell][data-boring-state=collapsed] .dv-chat-stage .dv-tabs-and-actions-container,[data-boring-workspace-part=plugin-tabs-shell][data-boring-state=collapsed] .dv-chat-stage .tabs-and-actions-container{padding-left:48px!important}.workbench-dockview .dv-tabs-and-actions-container,.workbench-dockview .tabs-and-actions-container{padding-right:72px!important}.dv-shell .dv-tab,.dv-shell .tab{color:var(--muted-foreground)!important;background-color:transparent!important;border:1px solid transparent;border-top-left-radius:8px;border-top-right-radius:8px;transition:color .18s cubic-bezier(.22,1,.36,1),background-color .18s cubic-bezier(.22,1,.36,1),border-color .18s cubic-bezier(.22,1,.36,1);min-width:120px;max-width:220px;padding:0;height:34px;align-self:end;font-size:12.5px;letter-spacing:-.01em}.dv-shell .dv-tab:hover,.dv-shell .tab:hover{color:var(--foreground)!important;background-color:oklch(from var(--foreground) l c h / .04)!important}.dv-shell .dv-tab>*,.dv-shell .tab>*{width:100%;height:100%}.dv-shell .dv-tab.dv-active-tab,.dv-shell .tab.active-tab{color:var(--foreground)!important;background-color:var(--background)!important;border-color:oklch(from var(--border) l c h / .5);border-bottom-color:var(--background);margin-bottom:-1px;position:relative;z-index:1;font-weight:500}.dv-shell .dv-tab.dv-active-tab:before,.dv-shell .tab.active-tab:before{content:"";position:absolute;left:10px;right:10px;top:-1px;height:2px;background:var(--accent);border-radius:0 0 2px 2px;opacity:0;transition:opacity .2s cubic-bezier(.22,1,.36,1)}.dv-shell .dv-tab.dv-active-tab:hover:before,.dv-shell .tab.active-tab:hover:before{opacity:.7}.dv-shell{--dv-sash-color: transparent;--dv-active-sash-color: transparent;--dv-active-sash-transition-delay: 0s}.dv-shell .sash-container .sash,.dv-shell .dv-sash-container .dv-sash{transition:box-shadow .16s cubic-bezier(.22,1,.36,1),background-color .16s cubic-bezier(.22,1,.36,1)}.dv-shell .dv-split-view-container.dv-horizontal>.dv-sash-container>.dv-sash{width:12px;margin-left:-4px}.dv-shell .dv-split-view-container.dv-vertical>.dv-sash-container>.dv-sash{height:12px;margin-top:-4px}.dv-shell .dv-split-view-container.dv-horizontal>.dv-sash-container>.dv-sash:hover,.dv-shell .dv-split-view-container.dv-horizontal>.dv-sash-container>.dv-sash:active{box-shadow:inset 0 0 0 1px oklch(from var(--primary) l c h / .45),inset 5px 0 oklch(from var(--primary) l c h / .35),inset 6px 0 oklch(from var(--primary) l c h / .35)}.dv-shell .dv-split-view-container.dv-vertical>.dv-sash-container>.dv-sash:hover,.dv-shell .dv-split-view-container.dv-vertical>.dv-sash-container>.dv-sash:active{box-shadow:inset 0 0 0 1px oklch(from var(--primary) l c h / .45),inset 0 5px oklch(from var(--primary) l c h / .35),inset 0 6px oklch(from var(--primary) l c h / .35)}.dv-shell .drop-target-dropzone>.drop-target-selection,.dv-shell .dv-drop-target-dropzone>.dv-drop-target-selection{background-color:oklch(from var(--primary) l c h / .15);border:2px dashed var(--primary);border-radius:calc(var(--radius) - 2px)}.dv-shell .watermark,.dv-shell .dv-watermark{color:var(--muted-foreground)}.dv-shell,.dv-shell .dv-dockview,.dv-shell .dv-groupview,.dv-shell .groupview,.dv-shell .groupview>.content-container,.dv-shell .dv-view-container,.dv-shell .view-container{background-color:var(--background)}.dv-shell .dv-groupview,.dv-shell .groupview{color:var(--foreground)}.dv-shell .right-actions-container,.dv-shell .left-actions-container,.dv-shell .dv-right-actions-container,.dv-shell .dv-left-actions-container{color:var(--muted-foreground);display:flex;align-items:center;align-self:stretch}.dv-shell .right-actions-container:hover,.dv-shell .left-actions-container:hover,.dv-shell .dv-right-actions-container:hover,.dv-shell .dv-left-actions-container:hover{color:var(--foreground)}.dv-shell .dv-drag-image{opacity:.85;border:1px solid var(--border);border-radius:calc(var(--radius) - 2px);box-shadow:0 4px 12px #00000026}.dv-chat-stage{--dv-tabs-and-actions-container-height: 32px;--dv-tabs-and-actions-container-font-size: .75rem;--dv-activegroup-visiblepanel-tab-background-color: transparent;--dv-activegroup-hiddenpanel-tab-background-color: transparent;--dv-inactivegroup-visiblepanel-tab-background-color: transparent;--dv-inactivegroup-hiddenpanel-tab-background-color: transparent}.dv-shell.dv-chat-stage .dv-tabs-and-actions-container{height:var(--dv-tabs-and-actions-container-height);box-sizing:border-box;flex-shrink:0;border-bottom:none;padding:0;gap:0;align-items:stretch}.dv-shell.dv-chat-stage .dv-tabs-and-actions-container.dv-single-tab .dv-scrollable,.dv-shell.dv-chat-stage .dv-tabs-and-actions-container.dv-single-tab .dv-tabs-container,.dv-shell.dv-chat-stage .dv-tabs-and-actions-container.dv-single-tab .dv-react-part{height:100%}.dv-shell.dv-chat-stage .dv-tabs-and-actions-container.dv-single-tab .dv-tabs-container{width:100%;align-items:stretch}.dv-shell.dv-chat-stage .dv-tab,.dv-shell.dv-chat-stage .dv-tab.dv-active-tab{width:100%;height:100%;min-width:0;max-width:none;flex:1 1 auto;align-self:stretch;margin-bottom:0;padding:0;border:none;border-radius:0;background-color:transparent!important}.dv-shell.dv-chat-stage .dv-tab.dv-active-tab:before{content:none}.dv-chat-stage .dv-default-tab-action{display:none}.dv-chat-stage .dv-groupview{position:relative}.dv-chat-stage .dv-groupview:after{content:"";position:absolute;top:0;right:0;bottom:0;left:0;z-index:40;pointer-events:none;background:transparent;transition:background-color .22s cubic-bezier(.22,1,.36,1),box-shadow .22s cubic-bezier(.22,1,.36,1)}[data-boring-workspace-part=chat-pane-stage][data-multi-pane=true] .dv-groupview:not(.dv-active-group):after{background:oklch(from var(--foreground) l c h / .035)}

package/dist/events.d.ts

@@ -2,7 +2,7 @@
  * Tiny typed event bus. ~30 lines, no runtime deps.
  *
  * Design constraints (locked by reviewer feedback in
- * `docs/plans/UNIFIED_EVENT_BUS.md`):
+ * `packages/workspace/docs/plans/archive/UNIFIED_EVENT_BUS.md`):
  *
  * - Synchronous emit only. Slow subscribers fire-and-forget their own async work.
  * - Snapshot listeners before iterating so subscribe / unsubscribe
@@ -32,7 +32,7 @@ interface UiCommand {
  * All in-process cross-cutting signals flow through one typed map.
  * Adding a new event = adding a key here.
  *
- * See `docs/plans/UNIFIED_EVENT_BUS.md` for the design rationale and
+ * See `packages/workspace/docs/plans/archive/UNIFIED_EVENT_BUS.md` for the design rationale and
  * the planned future events. Those are intentionally NOT pre-declared
  * — they get added when their concrete emitter and consumer land in
  * the same step.

package/dist/plugin.d.ts

@@ -1,6 +1,6 @@
 import { ComponentType, ReactNode } from 'react';
-import { P as PaneProps, a as PanelConfig, S as SurfaceOpenRequest, c as SurfacePanelResolution } from './surface-DmIalUmP.js';
-export { W as WORKSPACE_OPEN_PATH_SURFACE_KIND } from './surface-DmIalUmP.js';
+import { P as PaneProps, a as PanelConfig, g as WorkspaceSourceProps, h as SurfaceResolverExample, S as SurfaceOpenRequest, c as SurfacePanelResolution } from './surface-CDklwi48.js';
+export { W as WORKSPACE_OPEN_PATH_SURFACE_KIND, i as WorkspaceSourceOpenPanelConfig } from './surface-CDklwi48.js';
 export { B as BoringPackageBoringField, a as BoringPackagePiField, b as BoringPackagePiSource, c as BoringPackagePiSourceObject, d as BoringPluginManifestErrorCode, e as BoringPluginManifestIssue, f as BoringPluginManifestValidationResult, g as BoringPluginPackageJson, i as isSafePluginRelativePath, h as isValidBoringPluginId, v as validateBoringPluginManifest } from './manifest-C2vVgH_e.js';
 import { a as UiCommand, C as CommandResult, U as UiBridge } from './ui-bridge-BbuUZ5iC.js';
 import 'dockview-react';
@@ -66,19 +66,6 @@ interface CatalogConfig {
     onSelect: (row: CatalogRow) => void;
     pluginId?: string;
 }
-interface LeftTabParams {
-    rootDir?: string;
-    query?: string;
-    searchQuery?: string;
-    bridge?: unknown;
-    chromeless?: boolean;
-    /** Optional DOM target for left-tab toolbar actions owned by the pane. */
-    chromeActionsElement?: Element | null;
-    revealFileTreeRequest?: {
-        path: string;
-        seq: number;
-    } | null;
-}
 
 interface BoringFrontPanelRegistration<T = unknown> {
     id: string;
@@ -89,7 +76,7 @@ interface BoringFrontPanelRegistration<T = unknown> {
     icon?: ComponentType<{
         className?: string;
     }>;
-    placement?: string;
+    placement?: PanelConfig["placement"];
     requiresCapabilities?: string[];
     essential?: boolean;
     lazy?: boolean;
@@ -97,6 +84,21 @@ interface BoringFrontPanelRegistration<T = unknown> {
     supportsFullPage?: boolean;
     source?: string;
 }
+interface BoringFrontWorkspaceSourceRegistration<T = unknown> {
+    id: string;
+    component: ComponentType<WorkspaceSourceProps<T>> | (() => Promise<{
+        default: ComponentType<WorkspaceSourceProps<T>>;
+    }>);
+    label?: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    requiresCapabilities?: string[];
+    lazy?: boolean;
+    chromeless?: boolean;
+    defaultPanelId?: string;
+    source?: string;
+}
 interface BoringFrontPanelCommandRegistration {
     id: string;
     title: string;
@@ -106,19 +108,6 @@ interface BoringFrontPanelCommandRegistration {
     shortcut?: string;
     when?: () => boolean;
 }
-interface BoringFrontLeftTabRegistration<T = LeftTabParams> {
-    id: string;
-    title: string;
-    panelId: string;
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    component?: PanelConfig<T>["component"];
-    lazy?: boolean;
-    chromeless?: boolean;
-    requiresCapabilities?: string[];
-    source?: string;
-}
 interface BoringFrontProviderRegistration {
     id: string;
     component: PluginProvider;
@@ -130,6 +119,11 @@ interface BoringFrontBindingRegistration {
 interface BoringFrontSurfaceResolverRegistration {
     id?: string;
     kind: string;
+    title?: string;
+    description?: string;
+    targetHint?: string;
+    examples?: SurfaceResolverExample[];
+    metaSchema?: Record<string, unknown>;
     source?: string;
     resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | null | undefined;
 }
@@ -143,8 +137,8 @@ interface BoringFrontAPI {
     registerBinding(registration: BoringFrontBindingRegistration): void;
     registerCatalog(registration: CatalogConfig): void;
     registerPanel<T = unknown>(registration: BoringFrontPanelRegistration<T>): void;
+    registerWorkspaceSource<T = unknown>(registration: BoringFrontWorkspaceSourceRegistration<T>): void;
     registerPanelCommand(registration: BoringFrontPanelCommandRegistration): void;
-    registerLeftTab<T = LeftTabParams>(registration: BoringFrontLeftTabRegistration<T>): void;
     registerSurfaceResolver(registration: BoringFrontSurfaceResolverRegistration): void;
     registerToolRenderer(registration: BoringFrontToolRendererRegistration): void;
 }
@@ -169,8 +163,8 @@ interface DefinePluginConfig {
     id: string;
     label?: string;
     panels?: ReadonlyArray<BoringFrontPanelRegistration<any>>;
+    workspaceSources?: ReadonlyArray<BoringFrontWorkspaceSourceRegistration<any>>;
     commands?: ReadonlyArray<BoringFrontPanelCommandRegistration>;
-    leftTabs?: ReadonlyArray<BoringFrontLeftTabRegistration<any>>;
     surfaceResolvers?: ReadonlyArray<BoringFrontSurfaceResolverRegistration>;
     providers?: ReadonlyArray<BoringFrontProviderRegistration>;
     bindings?: ReadonlyArray<BoringFrontBindingRegistration>;
@@ -196,8 +190,8 @@ interface CapturedBoringFrontRegistrations {
     bindings: BoringFrontBindingRegistration[];
     catalogs: CatalogConfig[];
     panels: BoringFrontPanelRegistration<any>[];
+    workspaceSources: BoringFrontWorkspaceSourceRegistration<any>[];
     panelCommands: BoringFrontPanelCommandRegistration[];
-    leftTabs: BoringFrontLeftTabRegistration<any>[];
     surfaceResolvers: BoringFrontSurfaceResolverRegistration[];
     toolRenderers: BoringFrontToolRendererRegistration[];
 }
@@ -277,4 +271,4 @@ declare function openPanel(args: OpenPanelArgs): Promise<CommandResult>;
  */
 declare function notify(msg: string, level?: "info" | "warn" | "error"): Promise<CommandResult>;
 
-export { type BoringFrontAPI, type BoringFrontBindingRegistration, type BoringFrontFactory, type BoringFrontFactoryWithId, type BoringFrontLeftTabRegistration, type BoringFrontPanelCommandRegistration, type BoringFrontPanelRegistration, type BoringFrontProviderRegistration, type BoringFrontSetup, type BoringFrontSurfaceResolverRegistration, type CapturedBoringFrontRegistrations, type CapturedFrontPlugin, type CapturingBoringFrontAPIHandle, type DefinePluginConfig, NoWorkspaceUiBridgeError, type OpenPanelArgs, PaneProps, captureFrontPlugin, createCapturingBoringFrontAPI, definePlugin, execWorkspaceUi, getWorkspaceUiBridge, notify, openPanel };
+export { type BoringFrontAPI, type BoringFrontBindingRegistration, type BoringFrontFactory, type BoringFrontFactoryWithId, type BoringFrontPanelCommandRegistration, type BoringFrontPanelRegistration, type BoringFrontProviderRegistration, type BoringFrontSetup, type BoringFrontSurfaceResolverRegistration, type BoringFrontWorkspaceSourceRegistration, type CapturedBoringFrontRegistrations, type CapturedFrontPlugin, type CapturingBoringFrontAPIHandle, type DefinePluginConfig, NoWorkspaceUiBridgeError, type OpenPanelArgs, PaneProps, WorkspaceSourceProps, captureFrontPlugin, createCapturingBoringFrontAPI, definePlugin, execWorkspaceUi, getWorkspaceUiBridge, notify, openPanel };

package/dist/plugin.js

@@ -13,7 +13,7 @@ function definePlugin(config) {
   if (typeof config !== "object" || config === null) {
     if (typeof config === "string" || typeof config === "function") {
       throw new Error(
-        "definePlugin now takes a single declarative config object: definePlugin({ id, label?, panels, commands, leftTabs, surfaceResolvers, setup? }). The legacy positional form was removed \u2014 use the new shape."
+        "definePlugin now takes a single declarative config object: definePlugin({ id, label?, panels, commands, surfaceResolvers, setup? }). The legacy positional form was removed \u2014 use the new shape."
       );
     }
     throw new Error("definePlugin: expected a config object");
@@ -23,8 +23,8 @@ function definePlugin(config) {
   }
   const factory = (api) => {
     for (const panel of config.panels ?? []) api.registerPanel(panel);
+    for (const source of config.workspaceSources ?? []) api.registerWorkspaceSource(source);
     for (const command of config.commands ?? []) api.registerPanelCommand(command);
-    for (const tab of config.leftTabs ?? []) api.registerLeftTab(tab);
     for (const resolver of config.surfaceResolvers ?? []) api.registerSurfaceResolver(resolver);
     for (const provider of config.providers ?? []) api.registerProvider(provider);
     for (const binding of config.bindings ?? []) api.registerBinding(binding);
@@ -55,8 +55,8 @@ function createCapturingBoringFrontAPI(options = {}) {
   const bindings = [];
   const catalogs = [];
   const panels = [];
+  const workspaceSources = [];
   const panelCommands = [];
-  const leftTabs = [];
   const surfaceResolvers = [];
   const toolRenderers = [];
   const seen = /* @__PURE__ */ new Map();
@@ -86,25 +86,27 @@ function createCapturingBoringFrontAPI(options = {}) {
       catalogs.push(registration);
     },
     registerPanel(registration) {
+      if (registration.placement === "left-tab" || registration.placement === "workspace-source") {
+        throw new PluginError(
+          "validation",
+          `plugin "${options.pluginId ?? "<plugin>"}" uses removed panel placement "${registration.placement}" for "${registration.id}". Use registerWorkspaceSource / definePlugin({ workspaceSources }) instead.`
+        );
+      }
       claim("panel", registration.id);
       panels.push(registration);
     },
+    registerWorkspaceSource(registration) {
+      claim("workspace-source", registration.id);
+      workspaceSources.push(registration);
+    },
     registerPanelCommand(registration) {
       claim("command", registration.id);
       panelCommands.push(registration);
     },
-    registerLeftTab(registration) {
-      claim("left-tab", registration.id);
-      leftTabs.push(registration);
-    },
     registerSurfaceResolver(registration) {
       const id = registration.id ?? `${options.pluginId ?? "anon"}:${registration.kind}`;
       claim("surface-resolver", id);
-      if (registration.id === void 0) {
-        ;
-        registration.id = id;
-      }
-      surfaceResolvers.push(registration);
+      surfaceResolvers.push({ ...registration, id });
     },
     registerToolRenderer(registration) {
       claim("tool-renderer", registration.id);
@@ -116,8 +118,8 @@ function createCapturingBoringFrontAPI(options = {}) {
         bindings: clone(bindings),
         catalogs: clone(catalogs),
         panels: clone(panels),
+        workspaceSources: clone(workspaceSources),
         panelCommands: clone(panelCommands),
-        leftTabs: clone(leftTabs),
         surfaceResolvers: clone(surfaceResolvers),
         toolRenderers: clone(toolRenderers)
       };

package/dist/shared.d.ts

@@ -1,6 +1,6 @@
 export { C as CommandResult, a as UiCommand, b as UiState, W as WorkspaceBridge } from './ui-bridge-BbuUZ5iC.js';
 export { f as BridgeActorAttribution, g as BridgeActorKind, B as BridgeAuthContext, d as BridgeCallerClass, e as BridgeIdempotencyPolicy, h as BridgeRedactedActorRef, i as WorkspaceBridgeCallFailure, a as WorkspaceBridgeCallRequest, b as WorkspaceBridgeCallResponse, j as WorkspaceBridgeCallSuccess, c as WorkspaceBridgeError, k as WorkspaceBridgeErrorCode, l as WorkspaceBridgeFileAssetPointer, m as WorkspaceBridgeJsonValue, W as WorkspaceBridgeOperationDefinition, n as createWorkspaceBridgeError } from './workspace-bridge-rpc-A98RA5o6.js';
-export { C as CommandConfig, P as PaneProps, a as PanelConfig, b as PanelRegistration, S as SurfaceOpenRequest, c as SurfacePanelResolution, d as SurfaceResolverConfig, e as SurfaceResolverRegistration, W as WORKSPACE_OPEN_PATH_SURFACE_KIND, f as definePanel } from './surface-DmIalUmP.js';
+export { C as CommandConfig, P as PaneProps, a as PanelConfig, b as PanelRegistration, S as SurfaceOpenRequest, c as SurfacePanelResolution, d as SurfaceResolverConfig, e as SurfaceResolverRegistration, W as WORKSPACE_OPEN_PATH_SURFACE_KIND, f as definePanel } from './surface-CDklwi48.js';
 export { A as AgentTool, J as JSONSchema, T as ToolExecContext, a as ToolResult } from './agent-tool-CB0RQyx9.js';
 import 'react';
 import 'dockview-react';

package/dist/{surface-DmIalUmP.d.ts → surface-CDklwi48.d.ts}

@@ -35,20 +35,35 @@ interface PaneProps<T = unknown> {
     /** Optional className forwarded to the pane's root element. */
     className?: string;
 }
+interface WorkspaceSourceOpenPanelConfig {
+    id: string;
+    component: string;
+    title?: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Props for workspace source panes hosted in the left workspace rail.
+ * These are not Dockview panels: they receive only source-pane params and
+ * the explicit actions that the source host supports.
+ */
+interface WorkspaceSourceProps<T = unknown> {
+    params: T;
+    className?: string;
+    openPanel?: (config: WorkspaceSourceOpenPanelConfig) => void;
+}
+type PanelPlacement = "left" | "center" | "right" | "bottom" | "shared-dockview" | "workspace-page" | "right-tab";
 interface PanelConfig<T = any> {
     id: string;
     title: string;
     icon?: ComponentType<{
         className?: string;
     }>;
-    /** Placement hint: "left" | "center" | "right" | "bottom" | "left-tab" | "right-tab" */
-    placement?: string;
+    /** Placement hint. Public plugin placements: "workspace-page" | "shared-dockview". */
+    placement?: PanelPlacement | string;
     requiresCapabilities?: string[];
     essential?: boolean;
     chromeless?: boolean;
     supportsFullPage?: boolean;
-    /** Center-panel id opened when this config is used as a left-tab category. */
-    defaultPanelId?: string;
     /** Source: "builtin" | "app" */
     source?: string;
     pluginId?: string;
@@ -105,7 +120,20 @@ interface SurfacePanelResolution {
     params?: Record<string, unknown>;
     score?: number;
 }
-interface SurfaceResolverConfig {
+interface SurfaceResolverExample {
+    target: string;
+    label?: string;
+    meta?: Record<string, unknown>;
+}
+interface SurfaceResolverMetadata {
+    kind?: string;
+    title?: string;
+    description?: string;
+    targetHint?: string;
+    examples?: SurfaceResolverExample[];
+    metaSchema?: Record<string, unknown>;
+}
+interface SurfaceResolverConfig extends SurfaceResolverMetadata {
     id: string;
     resolve: (request: SurfaceOpenRequest) => SurfacePanelResolution | undefined;
     source?: string;
@@ -113,4 +141,4 @@ interface SurfaceResolverConfig {
 }
 type SurfaceResolverRegistration = Omit<SurfaceResolverConfig, "id">;
 
-export { type CommandConfig as C, type PaneProps as P, type SurfaceOpenRequest as S, WORKSPACE_OPEN_PATH_SURFACE_KIND as W, type PanelConfig as a, type PanelRegistration as b, type SurfacePanelResolution as c, type SurfaceResolverConfig as d, type SurfaceResolverRegistration as e, definePanel as f };
+export { type CommandConfig as C, type PaneProps as P, type SurfaceOpenRequest as S, WORKSPACE_OPEN_PATH_SURFACE_KIND as W, type PanelConfig as a, type PanelRegistration as b, type SurfacePanelResolution as c, type SurfaceResolverConfig as d, type SurfaceResolverRegistration as e, definePanel as f, type WorkspaceSourceProps as g, type SurfaceResolverExample as h, type WorkspaceSourceOpenPanelConfig as i };

package/dist/testing.d.ts

@@ -225,14 +225,12 @@ declare interface PanelConfig<T = any> {
     icon?: ComponentType<{
         className?: string;
     }>;
-    /** Placement hint: "left" | "center" | "right" | "bottom" | "left-tab" | "right-tab" */
-    placement?: string;
+    /** Placement hint. Public plugin placements: "workspace-page" | "shared-dockview". */
+    placement?: PanelPlacement | string;
     requiresCapabilities?: string[];
     essential?: boolean;
     chromeless?: boolean;
     supportsFullPage?: boolean;
-    /** Center-panel id opened when this config is used as a left-tab category. */
-    defaultPanelId?: string;
     /** Source: "builtin" | "app" */
     source?: string;
     pluginId?: string;
@@ -249,6 +247,8 @@ declare interface PanelConfig<T = any> {
     }>);
 }
 
+declare type PanelPlacement = "left" | "center" | "right" | "bottom" | "shared-dockview" | "workspace-page" | "right-tab";
+
 declare type PanelRegistration<T = any> = Omit<PanelConfig<T>, 'id'>;
 
 declare class PanelRegistry {

package/dist/testing.js

@@ -1,12 +1,11 @@
 import { jsx as Ba } from "react/jsx-runtime";
 import * as Pa from "react";
 import { createElement as is, useMemo as wn, useLayoutEffect as us, isValidElement as ss, cloneElement as ds, useSyncExternalStore as Gi } from "react";
-import { i as cs, w as fs, v as ps } from "./WorkspaceProvider-Bp1Sm40K.js";
-import { d as ms } from "./panel-DnvDNQac.js";
+import { i as cs, O as fs, x as ps, v as ms } from "./WorkspaceProvider-kf-pjz6V.js";
 import * as bs from "react-dom/test-utils";
 import ka from "react-dom";
 import * as xn from "react-dom/client";
-import { bootClean as ov, openPaneViaBridge as lv, openWorkbench as iv } from "./testing-e2e.js";
+import { bootClean as nv, openPaneViaBridge as ov, openWorkbench as lv } from "./testing-e2e.js";
 function vs() {
   return is(
     "div",
@@ -15,7 +14,7 @@ function vs() {
   );
 }
 const hs = [
-  ms({
+  fs({
     id: "workspace-testing-default-panel",
     title: "Workspace Test Panel",
     component: vs,
@@ -208,7 +207,7 @@ function Es({
       globalThis.fetch = d;
     };
   }, [r]), /* @__PURE__ */ Ba("div", { "data-boring-workspace-testing": "", className: c === "dark" ? "dark" : void 0, children: /* @__PURE__ */ Ba(
-    fs,
+    ps,
     {
       panels: u,
       apiBaseUrl: a,
@@ -216,7 +215,7 @@ function Es({
       defaultTheme: c,
       persistenceEnabled: !1,
       bridgeEndpoint: null,
-      children: /* @__PURE__ */ Ba(ps, { apiBaseUrl: a, authHeaders: s, timeout: o, children: e })
+      children: /* @__PURE__ */ Ba(ms, { apiBaseUrl: a, authHeaders: s, timeout: o, children: e })
     }
   ) });
 }
@@ -10604,7 +10603,7 @@ if ((typeof process > "u" || !((Wi = process.env) != null && Wi.RTL_SKIP_AUTO_CL
     ve(e);
   });
 }
-function Xb(e, r = {}) {
+function Jb(e, r = {}) {
   const {
     fixtures: t,
     bridge: a = xs(),
@@ -10642,7 +10641,7 @@ const Fb = () => {
     { id: "s5", title: "Old exploration", updatedAt: e - 960 * 60 * 6e4 }
   ];
 };
-function Qb(e = {}) {
+function Xb(e = {}) {
   var c;
   const r = e.initial ?? Fb();
   let t = {
@@ -10671,7 +10670,7 @@ function Qb(e = {}) {
     }
   };
 }
-function Zb(e) {
+function Qb(e) {
   return Gi(e.subscribe, e.getState, e.getState);
 }
 function jb() {
@@ -10702,7 +10701,7 @@ function Hb(e, r) {
     } catch {
     }
 }
-function ev(e = {}) {
+function Zb(e = {}) {
   const r = e.storageKey ?? "workspace:sessions", t = e.initial ?? jb;
   let a = $b(r, t);
   const s = /* @__PURE__ */ new Set(), c = (o) => {
@@ -10733,7 +10732,7 @@ function ev(e = {}) {
     }
   };
 }
-function rv(e) {
+function ev(e) {
   return Gi(e.subscribe, e.getState, e.getState);
 }
 const G = () => {
@@ -10808,7 +10807,7 @@ function Vb() {
     onDidActivePanelChange_: V.event
   };
 }
-function tv(e) {
+function rv(e) {
   const r = e !== null && typeof e == "object" && "params" in e ? e : { params: e }, t = r.panelId ?? "test-panel", a = zb(t), s = Vb();
   return {
     params: r.params,
@@ -10822,15 +10821,15 @@ function tv(e) {
 }
 export {
   Es as TestWorkspaceProvider,
-  ov as bootClean,
-  ev as createLocalStorageSessions,
+  nv as bootClean,
+  Zb as createLocalStorageSessions,
   xs as createMockBridge,
-  tv as createMockPaneProps,
+  rv as createMockPaneProps,
   Yi as createMockRegistry,
-  Qb as createMockSessions,
-  lv as openPaneViaBridge,
-  iv as openWorkbench,
-  Xb as renderPane,
-  rv as useLocalStorageSessions,
-  Zb as useMockSessions
+  Xb as createMockSessions,
+  ov as openPaneViaBridge,
+  lv as openWorkbench,
+  Jb as renderPane,
+  ev as useLocalStorageSessions,
+  Qb as useMockSessions
 };