@workbench-kit/shell-react 0.0.2-prototype.0.2.20 → 0.0.2-prototype.0.2.22

package/README.md

@@ -17,17 +17,32 @@ Peer: React 19.
 ## Quick start
 
 ```tsx
-import { WorkbenchProvider, WorkbenchShell } from '@workbench-kit/shell-react';
+import { BUILTIN_WORKBENCH_EXTENSIONS } from '@workbench-kit/shell-react';
+import { EditorArea } from '@workbench-kit/shell-react';
+import { WorkbenchProvider } from '@workbench-kit/shell-react/provider';
+import { WorkbenchShell } from '@workbench-kit/shell-react/shell';
 
 export function App() {
   return (
-    <WorkbenchProvider>
-      <WorkbenchShell title="Workbench" primarySidebar={<aside />} />
+    <WorkbenchProvider availableExtensions={BUILTIN_WORKBENCH_EXTENSIONS}>
+      <WorkbenchShell title="Workbench" primarySidebar={<aside />} editorArea={<EditorArea />} />
     </WorkbenchProvider>
   );
 }
 ```
 
+`WorkbenchProvider` has no implicit extensions. Product hosts pass their own
+extension list; hosts that want the Kit Explorer/Search/Settings set opt into
+`BUILTIN_WORKBENCH_EXTENSIONS` explicitly. Pure layout persistence helpers are
+available from the non-React `@workbench-kit/shell-react/layout-storage` subpath.
+`WorkbenchShell` also has no implicit editor surface: pass `editorArea` when the
+host wants the Kit editor, or omit it for a product-owned editor region.
+
+Performance-sensitive hosts should import orchestration from the focused
+`provider`, `shell`, `command-host`, `command-palette`, and
+`command-descriptors` subpaths. The root barrel remains the discovery surface,
+not the default runtime import graph.
+
 Prefer this package when the host needs provider + shell orchestration. For
 layout-only chrome without host services, start from
 `@workbench-kit/react/workbench/shell` — see

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbench-kit/shell-react",
-  "version": "0.0.2-prototype.0.2.20",
+  "version": "0.0.2-prototype.0.2.22",
   "private": false,
   "sideEffects": [
     "**/*.css"
@@ -8,8 +8,14 @@
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
+    "./command-descriptors": "./src/commands/use-command-descriptors.ts",
+    "./command-host": "./src/workbench/command-host.tsx",
+    "./command-palette": "./src/workbench/command-palette.ts",
     "./field-remap": "./src/field-remap/index.ts",
-    "./field-remap/view.css": "./src/field-remap/view.css"
+    "./field-remap/view.css": "./src/field-remap/view.css",
+    "./layout-storage": "./src/workbench/layout-storage.ts",
+    "./provider": "./src/shell/provider.tsx",
+    "./shell": "./src/shell/shell.tsx"
   },
   "files": [
     "src",
@@ -24,14 +30,14 @@
     "@xyflow/react": "^12.11.2",
     "jsonata": "^2.2.0",
     "react-table-mapping": "^1.0.3",
-    "@workbench-kit/platform": "0.0.2-prototype.0.2.20",
-    "@workbench-kit/field-remap": "0.0.2-prototype.0.2.20",
-    "@workbench-kit/tokens": "0.0.2-prototype.0.2.20",
-    "@workbench-kit/react": "0.0.2-prototype.0.2.20",
-    "@workbench-kit/workbench-core": "0.0.2-prototype.0.2.20",
-    "@workbench-kit/workbench-config": "0.0.2-prototype.0.2.20",
-    "@workbench-kit/workbench-extension-sdk": "0.0.2-prototype.0.2.20",
-    "@workbench-kit/workspace": "0.0.2-prototype.0.2.20"
+    "@workbench-kit/react": "0.0.2-prototype.0.2.22",
+    "@workbench-kit/field-remap": "0.0.2-prototype.0.2.22",
+    "@workbench-kit/platform": "0.0.2-prototype.0.2.22",
+    "@workbench-kit/tokens": "0.0.2-prototype.0.2.22",
+    "@workbench-kit/workbench-config": "0.0.2-prototype.0.2.22",
+    "@workbench-kit/workbench-extension-sdk": "0.0.2-prototype.0.2.22",
+    "@workbench-kit/workspace": "0.0.2-prototype.0.2.22",
+    "@workbench-kit/workbench-core": "0.0.2-prototype.0.2.22"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/shell/provider.tsx

@@ -34,7 +34,6 @@ import {
   type WorkbenchLayoutStateInput,
   type ViewHostFactory,
 } from '@workbench-kit/workbench-core';
-import { BUILTIN_WORKBENCH_EXTENSIONS } from '../extensions/builtin-extensions.js';
 import {
   ContextKeyService,
   createWorkbenchPermissionContextKeys,
@@ -96,12 +95,12 @@ export interface WorkbenchWorkspaceHostPort extends WorkbenchEditorSavePort {
 
 export type { WorkbenchStorageAdapter };
 
-const DEFAULT_AVAILABLE_EXTENSIONS = BUILTIN_WORKBENCH_EXTENSIONS;
-
+const EMPTY_AVAILABLE_EXTENSIONS: readonly WorkbenchExtensionDescription[] = Object.freeze([]);
 const EMPTY_HOST_THEMES: readonly WorkbenchHostThemeRegistration[] = Object.freeze([]);
 const EMPTY_USER_COMMANDS: readonly WorkbenchUserCommandDefinition[] = Object.freeze([]);
 
 export interface WorkbenchProviderProps {
+  /** Extensions available to this host. Defaults to none; hosts opt into built-ins explicitly. */
   availableExtensions?: readonly WorkbenchExtensionDescription[];
   children: ReactNode;
   contextKeyValues?: Readonly<Record<string, ContextKeyValue>> | undefined;
@@ -219,7 +218,7 @@ export function WorkbenchProvider({
   viewHostFactories,
   workspaceHostPort,
 }: WorkbenchProviderProps) {
-  const hostAvailableExtensions = availableExtensions ?? DEFAULT_AVAILABLE_EXTENSIONS;
+  const hostAvailableExtensions = availableExtensions ?? EMPTY_AVAILABLE_EXTENSIONS;
   const deferredDisposeRef = useRef<DeferredProviderDispose | undefined>(undefined);
   const shouldPersistEditorState =
     persistEditorState ??

package/src/shell/shell.tsx

@@ -27,7 +27,6 @@ import {
   useResolvedWorkbenchTheme,
 } from '@workbench-kit/react/workbench';
 
-import { EditorArea } from '../editor/area.js';
 import { BUILTIN_COMMANDS_VIEW_CONTAINER_ID } from '../commands/view-data.js';
 import { BUILTIN_EXTENSIONS_VIEW_CONTAINER_ID } from '../extensions/view-data.js';
 import {
@@ -198,7 +197,7 @@ export function WorkbenchShell({
   showPanelLayoutToggle = true,
   showAuxiliarySidebarLayoutToggle = true,
 }: WorkbenchShellProps) {
-  const resolvedEditorArea = editorArea ?? <EditorArea />;
+  const resolvedEditorArea = editorArea ?? null;
   const resolvedWorkbenchTheme = useResolvedWorkbenchTheme(theme ?? 'system');
   const activeThemePreset =
     lightPreset !== undefined && darkPreset !== undefined

package/src/workbench/layout-storage.ts

@@ -4,11 +4,13 @@ import {
 } from '@workbench-kit/workbench-config';
 import {
   createWorkbenchLayoutState,
-  type WorkbenchStorageReader,
-  type WorkbenchStorageWriter,
   type WorkbenchLayoutState,
   type WorkbenchLayoutStateInput,
-} from '@workbench-kit/workbench-core';
+} from '@workbench-kit/workbench-core/layout';
+import type {
+  WorkbenchStorageReader,
+  WorkbenchStorageWriter,
+} from '@workbench-kit/workbench-core/storage';
 
 import {
   readLocalJsonStorage,