@workbench-kit/react 0.0.2-prototype.0.2.4 → 0.0.2-prototype.0.2.40

package/README.md

@@ -0,0 +1,172 @@
+# `@workbench-kit/react`
+
+React primitives and workbench chrome for integrating hosts (browser, desktop
+shells, and other React hosts).
+
+Published on npm with the **`prototype`** dist tag.
+
+## Install
+
+```powershell
+pnpm add @workbench-kit/react@prototype @workbench-kit/tokens@prototype
+```
+
+Peer: React 19.
+
+## Styles
+
+Import one bundle at the app entry. A host that renders the broad Workbench feature
+set should use the core bundle, which excludes only the optional Auth and Chat
+surfaces:
+
+```ts
+import '@workbench-kit/react/styles/core.css';
+```
+
+Use `@workbench-kit/react/styles.css` when the host also renders Auth or Chat.
+Component-only consumers can instead combine token styles with
+`@workbench-kit/react/primitives.css`.
+
+Focused entries avoid loading unrelated feature hubs:
+
+| Entry                                        | Owns                                                                                       |
+| -------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| `@workbench-kit/react/styles/foundation.css` | Theme tokens, Codicons, and shared scrollbars                                              |
+| `@workbench-kit/react/styles/overlay.css`    | Context-menu overlay rules and compact context-menu density; import after `foundation.css` |
+| `@workbench-kit/react/styles/core.css`       | Broad Workbench feature set except Auth and Chat                                           |
+| `@workbench-kit/react/styles.css`            | Full compatibility bundle                                                                  |
+
+For a non-shell surface that only uses co-located component styles and overlays:
+
+```ts
+import '@workbench-kit/react/styles/foundation.css';
+import '@workbench-kit/react/styles/overlay.css';
+```
+
+Use `core.css` for Workbench shell routes: shell composition commonly reaches Layout,
+Settings, Views, Workspace, and modal styles that a narrower name would not safely imply.
+When routes emit separate async CSS chunks, inspect the production manifest because
+bundlers can repeat a shared CSS import across chunks.
+
+The packed-consumer gate measures production `core.css` and focused overlay paths from
+packed tarballs. It checks required/forbidden selectors, the focused-to-core ratio,
+referenced static assets, and gzip budgets. Budget changes require an explicit initial-load
+review.
+
+## Quick start
+
+```tsx
+import { WorkbenchShell } from '@workbench-kit/react/workbench/shell';
+
+export function AppShell() {
+  return (
+    <div className="ui-workbench-host-root" style={{ height: '100vh' }}>
+      <WorkbenchShell
+        activityBar={{
+          items: [
+            { id: 'explorer', icon: <i className="codicon codicon-files" />, label: 'Explorer' },
+          ],
+        }}
+        rootClassName="ide-root"
+        secondaryArea={<main>Editor region</main>}
+        statusSections={[]}
+      />
+    </div>
+  );
+}
+```
+
+Full walkthrough: [Getting Started](../../docs/guides/getting-started.md).
+
+## Common subpaths
+
+| Subpath                                      | Purpose                              |
+| -------------------------------------------- | ------------------------------------ |
+| `@workbench-kit/react/primitives`            | App icons, controls, library layouts |
+| `@workbench-kit/react/workbench/shell`       | Workbench shell / activity bar       |
+| `@workbench-kit/react/workbench/workspace`   | Explorer, workspace editor panel     |
+| `@workbench-kit/react/workbench/chat`        | Chat panel and message surfaces      |
+| `@workbench-kit/react/overlay`               | Context menus, anchored overlays     |
+| `@workbench-kit/react/modal`                 | Low-level modal frame                |
+| `@workbench-kit/react/jdw`                   | JDW preview bridges                  |
+| `@workbench-kit/react/styles/foundation.css` | Theme/icon/scrollbar foundation      |
+| `@workbench-kit/react/styles/overlay.css`    | Focused context-menu overlay CSS     |
+| `@workbench-kit/react/styles/core.css`       | Core host CSS without Auth and Chat  |
+| `@workbench-kit/react/styles.css`            | Full CSS including Auth and Chat     |
+
+Import **only** through `exports`. Do not deep-import `src/` paths.
+
+## Host-owned app icon
+
+`AppIcon` standardizes icon sizing and image fitting without embedding a product
+mark. Supply either an image or custom content; the host remains responsible for
+the artwork.
+
+```tsx
+import { AppIcon } from '@workbench-kit/react/primitives';
+
+const appIcon = <AppIcon alt="Example app" src="/app-icon.svg" />;
+```
+
+## Quick Open providers
+
+`WorkbenchQuickOpen` is a file/provider overlay distinct from the command palette.
+Hosts (or `@workbench-kit/shell-react` `WorkbenchCommandHost`) pass pluggable
+providers; the default workspace-files provider wraps
+`searchWorkspaceFiles` from `@workbench-kit/workspace`.
+
+```ts
+import {
+  WorkbenchQuickOpen,
+  createWorkspaceFilesQuickOpenProvider,
+  type QuickOpenProvider,
+} from '@workbench-kit/react/workbench';
+
+const providers: QuickOpenProvider[] = [
+  createWorkspaceFilesQuickOpenProvider({
+    files: workspaceFiles,
+    recentPaths: ['src/App.tsx'],
+  }),
+];
+```
+
+Contract:
+
+- `provider.search(query, { signal })` returns items (sync or `Promise`); the context is
+  optional so simple and existing single-provider implementations can keep a one-argument function
+- Without `providerId`, providers search concurrently and contribute results as they settle;
+  final grouping is deterministic by declared provider order, then provider item order
+- A rejected or slow provider does not block results from other providers; query/provider changes
+  abort the prior signal and late results are ignored
+- `onProviderError` can observe an isolated provider failure without failing the whole search
+- Every result shows its provider label, and selection reports the matching `providerId`
+- Provider IDs are unique; item IDs only need to be stable within their provider
+- Set `providerId` to restrict the overlay to one provider
+- Empty query → all files, with optional `recentPaths` elevated first
+- Enter selects the active item; Escape closes (modal focus trap)
+- Shell default: Ctrl/Cmd+P opens Quick Open; Ctrl/Cmd+Shift+P opens the command palette
+
+## Learn more
+
+| Doc                                                                    | Purpose                       |
+| ---------------------------------------------------------------------- | ----------------------------- |
+| [Getting Started](../../docs/guides/getting-started.md)                | Install + minimal shell       |
+| [Component Map](../../docs/guides/component-map.md)                    | Surface → Storybook / sample  |
+| [Sample Screens](../../docs/guides/sample-screens.md)                  | Example screen recipes        |
+| [Consumer Capabilities](../../docs/workbench/consumer-capabilities.md) | Props / when-to-use contracts |
+| [API Reference](../../docs/guides/api-reference.md)                    | Package export index          |
+
+## Local verification (this monorepo)
+
+```powershell
+pnpm install
+pnpm build:workbench-extensions
+pnpm dev
+pnpm dev:storybook
+```
+
+Storybook stays a curated set of interaction stories — not a full package gallery.
+Demo and story modules under this package are for development; published consumers
+rely on the `exports` map and CSS entry points above.
+Storybook and the sample host intentionally keep `styles.css` so they exercise the
+full compatibility graph; focused production consumers are covered by the packed gate.

package/package.json

@@ -1,8 +1,18 @@
 {
   "name": "@workbench-kit/react",
-  "version": "0.0.2-prototype.0.2.4",
+  "version": "0.0.2-prototype.0.2.40",
   "private": false,
+  "sideEffects": [
+    "**/*.css"
+  ],
   "type": "module",
+  "typesVersions": {
+    "*": {
+      "overlay/context-menu-item": [
+        "src/overlay/context-menu-item.ts"
+      ]
+    }
+  },
   "exports": {
     ".": "./src/index.ts",
     "./drag-mime": "./src/utils/dragMime.ts",
@@ -11,7 +21,7 @@
     "./editor-tabs": "./src/workbench/editor-tabs/index.ts",
     "./icons": "./src/icons/index.ts",
     "./overlay": "./src/overlay/index.ts",
-    "./brand": "./src/brand/index.ts",
+    "./overlay/context-menu-item": "./src/overlay/context-menu-item.ts",
     "./primitives": "./src/primitives/index.ts",
     "./primitives.css": "./src/primitives/styles.css",
     "./workbench/auth": "./src/workbench/auth/index.ts",
@@ -20,17 +30,20 @@
     "./workbench/management": "./src/workbench/management/index.ts",
     "./workbench/settings": "./src/workbench/settings/index.ts",
     "./workbench": "./src/workbench/index.ts",
-    "./workbench/activityBarOrder": "./src/workbench/activityBarOrder.ts",
-    "./workbench/markdown-preview": "./src/workbench/MarkdownPreview.tsx",
-    "./workbench/shell": "./src/workbench/shell.ts",
-    "./workbench/theme-provider": "./src/workbench/WorkbenchThemeProvider.tsx",
-    "./workbench/themePresets": "./src/workbench/themePresets.ts",
-    "./workbench/split-view": "./src/workbench/SplitView.tsx",
+    "./workbench/activityBarOrder": "./src/workbench/shell/activityBarOrder.ts",
+    "./workbench/command-ui": "./src/workbench/commands/command-ui.ts",
+    "./workbench/markdown-preview": "./src/workbench/markdown/MarkdownPreview.tsx",
+    "./workbench/shell": "./src/workbench/shell/shell.ts",
+    "./workbench/standalone": "./src/workbench/shell/standalone.ts",
+    "./workbench/theme": "./src/workbench/theme/theme.ts",
+    "./workbench/theme-provider": "./src/workbench/theme/WorkbenchThemeProvider.tsx",
+    "./workbench/themePresets": "./src/workbench/theme/themePresets.ts",
+    "./workbench/split-view": "./src/workbench/shell/SplitView.tsx",
     "./workbench/workspace": "./src/workbench/workspace/index.ts",
     "./workbench/workspace/editor": "./src/workbench/workspace/WorkspaceEditor.tsx",
     "./workbench/workspace/explorer": "./src/workbench/workspace/WorkspaceExplorer.tsx",
     "./workbench/workspace/file-icon": "./src/icons/file-icon.ts",
-    "./workbench/commands": "./src/workbench/commands.ts",
+    "./workbench/commands": "./src/workbench/commands/commands.ts",
     "./jdw": "./src/jdw/index.ts",
     "./jdw/document": "./src/jdw/document.ts",
     "./jdw/parse": "./src/jdw/parse.ts",
@@ -41,6 +54,9 @@
     "./widget-tree": "./src/widget-tree/index.ts",
     "./widget-asset": "./src/widget-asset/index.ts",
     "./widget-studio": "./src/widget-studio/index.ts",
+    "./styles/core.css": "./src/styles/core.css",
+    "./styles/foundation.css": "./src/styles/foundation.css",
+    "./styles/overlay.css": "./src/styles/overlay.css",
     "./styles.css": "./src/styles.css",
     "./workbench-menu-surfaces.css": "./src/workbench-menu-surfaces.css"
   },
@@ -54,18 +70,18 @@
     "!src/**/*.stories.tsx"
   ],
   "dependencies": {
-    "@dnd-kit/core": "^6.3.1",
     "@vscode/codicons": "^0.0.45",
     "remark-gfm": "^4.0.1",
-    "@workbench-kit/monaco": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/jdw": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/contracts": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/platform": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/services": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/workspace": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/runtime": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/adapters": "0.0.2-prototype.0.2.4",
-    "@workbench-kit/tokens": "0.0.2-prototype.0.2.4"
+    "rehype-sanitize": "^6.0.0",
+    "@workbench-kit/adapters": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/contracts": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/jdw": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/monaco": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/services": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/platform": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/tokens": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/workspace": "0.0.2-prototype.0.2.40",
+    "@workbench-kit/runtime": "0.0.2-prototype.0.2.40"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -88,7 +104,8 @@
     "directory": "packages/react"
   },
   "scripts": {
-    "test": "pnpm exec vitest run --config ../../vitest.config.ts src/widget-tree",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "test": "pnpm exec vitest run --config ../../vitest.config.ts src",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:exact-optional": "tsc -p typecheck-exact-optional/tsconfig.emit.json && tsc -p typecheck-exact-optional/tsconfig.json --noEmit"
   }
 }

package/src/index.ts

@@ -1,7 +1,5 @@
 export { Modal } from './modal/Modal';
 export type { ModalBodyLayout, ModalBodyPadding, ModalProps } from './modal/Modal';
-export { TilepaperAppIcon } from './brand/TilepaperAppIcon';
-export type { TilepaperAppIconProps } from './brand/TilepaperAppIcon';
 export {
   WorkbenchIcon,
   WorkbenchIconProvider,
@@ -20,7 +18,12 @@ export type {
   WorkbenchIconRenderProps,
   WorkbenchIconResolver,
 } from './icons';
-export { commandMenuItemsToContextMenuItems } from './workbench/commands';
+export { commandMenuItemsToContextMenuItems } from './workbench/commands/commands';
+export type {
+  ExtensionManagementEntry,
+  ExtensionManagementPanelProps,
+  ExtensionManagementTransition,
+} from './workbench/management';
 export {
   WorkbenchArtifactModeControls,
   WorkbenchArtifactPreview,
@@ -31,7 +34,7 @@ export {
   getWorkbenchPreviewRenderer,
   getWorkbenchPreviewRendererMatch,
   selectWorkbenchPreviewRenderer,
-} from './workbench/ArtifactShell';
+} from './workbench/shell/ArtifactShell';
 export type {
   WorkbenchArtifactDescriptor,
   WorkbenchArtifactMode,
@@ -44,7 +47,7 @@ export type {
   WorkbenchPreviewRendererContext,
   WorkbenchPreviewRendererMatch,
   WorkbenchPreviewRendererMatchReason,
-} from './workbench/ArtifactShell';
+} from './workbench/shell/ArtifactShell';
 export {
   WorkbenchCommandGroupShell,
   WorkbenchCommandList,
@@ -58,7 +61,16 @@ export {
   getWorkbenchCommandStatusLabel,
   groupWorkbenchCommands,
   isWorkbenchCommandRunnable,
-} from './workbench/CommandPalette';
+} from './workbench/commands/CommandPalette';
+export {
+  DEFAULT_QUICK_OPEN_SEARCH_DEBOUNCE_MS,
+  WORKSPACE_FILES_QUICK_OPEN_PROVIDER_ID,
+  WorkbenchQuickOpen,
+  createWorkspaceFilesQuickOpenProvider,
+  getNextQuickOpenItemIndex,
+  isQuickOpenItemSelectable,
+  resolveQuickOpenItemPath,
+} from './workbench/commands/WorkbenchQuickOpen';
 export {
   WorkbenchShortcutCommandBridge,
   getWorkbenchShortcutCommandBindings,
@@ -66,7 +78,7 @@ export {
   matchesWorkbenchShortcut,
   runWorkbenchShortcutCommand,
   useWorkbenchShortcutCommands,
-} from './workbench/ShortcutCommandBridge';
+} from './workbench/commands/ShortcutCommandBridge';
 export type {
   WorkbenchCommandDescriptor,
   WorkbenchCommandDescriptorOverrides,
@@ -86,7 +98,15 @@ export type {
   WorkbenchCommandSideEffect,
   WorkbenchCommandStatus,
   WorkbenchCommandSuggestProps,
-} from './workbench/CommandPalette';
+} from './workbench/commands/CommandPalette';
+export type {
+  CreateWorkspaceFilesQuickOpenProviderOptions,
+  QuickOpenItem,
+  QuickOpenProvider,
+  QuickOpenSearchContext,
+  QuickOpenSelectContext,
+  WorkbenchQuickOpenProps,
+} from './workbench/commands/WorkbenchQuickOpen';
 export type {
   UseWorkbenchShortcutCommandsOptions,
   WorkbenchShortcutCommandBinding,
@@ -98,7 +118,7 @@ export type {
   WorkbenchShortcutEventLike,
   WorkbenchShortcutMatchInput,
   WorkbenchShortcutPlatform,
-} from './workbench/ShortcutCommandBridge';
+} from './workbench/commands/ShortcutCommandBridge';
 export {
   WorkbenchConfirmationFlow,
   getWorkbenchConfirmationButtonVariant,
@@ -107,7 +127,7 @@ export {
   getWorkbenchConfirmationStatus,
   getWorkbenchConfirmationVariant,
   isWorkbenchConfirmationActionDisabled,
-} from './workbench/ConfirmationFlow';
+} from './workbench/commands/ConfirmationFlow';
 export type {
   WorkbenchConfirmationAction,
   WorkbenchConfirmationCancelContext,
@@ -118,7 +138,7 @@ export type {
   WorkbenchConfirmationReason,
   WorkbenchConfirmationSideEffect,
   WorkbenchConfirmationVariant,
-} from './workbench/ConfirmationFlow';
+} from './workbench/commands/ConfirmationFlow';
 export {
   WorkbenchAuthGate,
   WorkbenchLoginBrandMark,
@@ -161,7 +181,7 @@ export {
   getWorkbenchTimelineEventLabel,
   getWorkbenchTimelineEventStatus,
   getWorkbenchTimelineMetadataEntries,
-} from './workbench/Timeline';
+} from './workbench/shell/Timeline';
 export type {
   WorkbenchTimelineEvent,
   WorkbenchTimelineEventKind,
@@ -173,7 +193,7 @@ export type {
   WorkbenchTimelineRenderMetadata,
   WorkbenchTimelineRenderPayload,
   WorkbenchTimelineVariant,
-} from './workbench/Timeline';
+} from './workbench/shell/Timeline';
 export { ConfirmDialog } from './modal/ConfirmDialog';
 export type { ConfirmDialogProps } from './modal/ConfirmDialog';
 export { ContextMenu } from './overlay/ContextMenu';
@@ -198,15 +218,20 @@ export type {
 export {
   createPointerPassthroughController,
   isPointerOverHitRegion,
+  resolvePointerHitTarget,
 } from './overlay/pointerPassthroughRegion';
 export type {
+  PointerHitTestDocument,
   PointerOverHitRegionOptions,
   PointerPassthroughController,
   PointerPassthroughControllerOptions,
   PointerPassthroughPort,
 } from './overlay/pointerPassthroughRegion';
 export { usePointerPassthroughRegion } from './overlay/usePointerPassthroughRegion';
-export type { UsePointerPassthroughRegionOptions } from './overlay/usePointerPassthroughRegion';
+export type {
+  PointerHitTargetResolver,
+  UsePointerPassthroughRegionOptions,
+} from './overlay/usePointerPassthroughRegion';
 export {
   getWorkbenchStatusDescriptor,
   getWorkbenchStatusLabel,
@@ -216,17 +241,16 @@ export {
   isWorkbenchStatusDisabled,
   isWorkbenchStatusUnavailable,
   workbenchStatusFromLifecycleStatus,
-} from './workbench/status';
+} from './workbench/shell/status';
 export type {
   WorkbenchStatus,
   WorkbenchStatusDescriptor,
   WorkbenchStatusVariant,
-} from './workbench/status';
+} from './workbench/shell/status';
 export {
   FilterBar,
   FilterBarActiveChips,
   FilterBarRow,
-  FilterChip,
   HelpText,
   Panel,
   PanelBody,
@@ -251,7 +275,6 @@ export type {
   FilterBarActiveChipsProps,
   FilterBarRowProps,
   FilterBarProps,
-  FilterChipProps,
   HelpTextProps,
   PanelBodyProps,
   PanelFooterProps,
@@ -276,6 +299,7 @@ export {
   SideBarHeaderControl,
   SideBarList,
   SideBarListItem,
+  SideBarTree,
   SideBarViewFrame,
   SideBarRow,
   SidebarActionIconBar,
@@ -286,12 +310,20 @@ export {
   WorkbenchSidebarSection,
   WorkbenchSidebarSectionHeader,
   WorkbenchSidebarSectionStack,
+  flattenVisibleSideBarTreeItems,
+  isSideBarTreeBranch,
+  selectSideBarTreeIds,
+  toggleSideBarTreeId,
   useSidebarSectionBaseDepth,
 } from './layout/sidebar';
 export type {
   SideBarHeaderControlProps,
   SideBarListItemProps,
   SideBarListProps,
+  SideBarTreeItem,
+  SideBarTreeProps,
+  SideBarTreeSelectionMode,
+  SideBarTreeVisibleNode,
   SideBarViewFrameProps,
   SideBarRowProps,
   SidebarActionIconBarProps,
@@ -567,7 +599,7 @@ export {
   StatusBar as WorkbenchStatusBar,
   StatusBarItem as WorkbenchStatusBarItem,
   StatusBarSection as WorkbenchStatusBarSection,
-} from './workbench/StatusBar';
+} from './workbench/shell/StatusBar';
 export type {
   StatusBarItemModel as WorkbenchStatusBarItemModel,
   StatusBarItemProps as WorkbenchStatusBarItemProps,
@@ -575,9 +607,11 @@ export type {
   StatusBarSectionAlign as WorkbenchStatusBarSectionAlign,
   StatusBarSectionModel as WorkbenchStatusBarSectionModel,
   StatusBarSectionProps as WorkbenchStatusBarSectionProps,
-} from './workbench/StatusBar';
+} from './workbench/shell/StatusBar';
 export { AbsoluteBox } from './primitives';
 export type { AbsoluteBoxProps, WorkbenchRect } from './primitives';
+export { AppIcon } from './primitives';
+export type { AppIconProps, AppIconSize } from './primitives';
 export { Badge } from './primitives';
 export type { BadgeProps } from './primitives';
 export { Button } from './primitives';
@@ -643,8 +677,13 @@ export type {
 } from './primitives';
 export { CatalogFilterOverlay } from './primitives';
 export type { CatalogFilterOverlayProps } from './primitives';
-export { LibraryDetailLayout } from './primitives';
-export type { LibraryDetailLayoutMode, LibraryDetailLayoutProps } from './primitives';
+export { LibraryDetailLayout, resolveLibraryDetailHeroCoverMedia } from './primitives';
+export type {
+  LibraryDetailLayoutMode,
+  LibraryDetailLayoutProps,
+  ResolveLibraryDetailHeroCoverMediaInput,
+  ResolvedLibraryDetailHeroCoverMedia,
+} from './primitives';
 export { WorkbenchMediaPlaceholder } from './primitives';
 export type { WorkbenchMediaPlaceholderProps } from './primitives';
 export { WorkbenchMediaSlot } from './primitives';
@@ -685,8 +724,8 @@ export type {
   WorkspaceDraftsContextValue,
   WorkspaceDraftsProviderProps,
 } from './workbench/workspace/WorkspaceDraftsContext';
-export { StructuredArtifactEditor } from './workbench/StructuredArtifactEditor';
-export type { StructuredArtifactEditorProps } from './workbench/StructuredArtifactEditor';
+export { StructuredArtifactEditor } from './workbench/shell/StructuredArtifactEditor';
+export type { StructuredArtifactEditorProps } from './workbench/shell/StructuredArtifactEditor';
 export { createStringDragMime, createTypedDragMime } from './utils/dragMime';
 export type { TypedDragMime, TypedDragMimeOptions } from './utils/dragMime';
 export {
@@ -698,29 +737,30 @@ export {
   readEditorTabDragPayload,
   resolveEditorTabDropTarget,
   resolveEditorTabStripDropTarget,
-} from './workbench/editor-tabs-dnd';
-export type { EditorTabDragPayload, EditorTabDropTarget } from './workbench/editor-tabs-dnd';
-export { useEditorTabsStripDnd } from './workbench/useEditorTabsStripDnd';
+} from './workbench/editor/editor-tabs-dnd';
+export type { EditorTabDragPayload, EditorTabDropTarget } from './workbench/editor/editor-tabs-dnd';
+export { useEditorTabsStripDnd } from './workbench/editor/useEditorTabsStripDnd';
 export type {
   UseEditorTabsStripDndOptions,
   UseEditorTabsStripDndResult,
-} from './workbench/useEditorTabsStripDnd';
-export { WorkbenchEditorTabs } from './workbench/WorkbenchEditorTabs';
-export type { WorkbenchEditorTabsProps } from './workbench/WorkbenchEditorTabs';
+} from './workbench/editor/useEditorTabsStripDnd';
+export { WorkbenchEditorTabs } from './workbench/editor/WorkbenchEditorTabs';
+export type { WorkbenchEditorTabsProps } from './workbench/editor/WorkbenchEditorTabs';
 export {
   createWorkbenchStandaloneEditorTabCommandContext,
   createWorkbenchStandaloneEditorTabContextMenuItems,
   isWorkbenchEditorTabClosable,
-} from './workbench/editorTabContextMenu';
+} from './workbench/editor/editorTabContextMenu';
 export type {
   CreateWorkbenchStandaloneEditorTabCommandContextInput,
+  CreateWorkbenchStandaloneEditorTabContextMenuItemsInput,
   WorkbenchStandaloneEditorTabLike,
-} from './workbench/editorTabContextMenu';
-export { useWorkbenchEditorTabContextMenu } from './workbench/useWorkbenchEditorTabContextMenu';
+} from './workbench/editor/editorTabContextMenu';
+export { useWorkbenchEditorTabContextMenu } from './workbench/editor/useWorkbenchEditorTabContextMenu';
 export type {
   UseWorkbenchEditorTabContextMenuOptions,
   UseWorkbenchEditorTabContextMenuResult,
-} from './workbench/useWorkbenchEditorTabContextMenu';
+} from './workbench/editor/useWorkbenchEditorTabContextMenu';
 export {
   clampPreviewViewportZoom,
   computePreviewViewportFitScale,

package/src/jdw/JsonCodeEditorPane.tsx

@@ -20,7 +20,7 @@ import {
   StatusBar as WorkbenchStatusBar,
   StatusBarItem as WorkbenchStatusBarItem,
   StatusBarSection as WorkbenchStatusBarSection,
-} from '../workbench/StatusBar';
+} from '../workbench/shell/StatusBar';
 import { WorkspaceEditor, type WorkspaceEditorTheme } from '../workbench/workspace/WorkspaceEditor';
 import type { WorkspaceFile } from '../workbench/workspace/types';
 
@@ -245,11 +245,12 @@ export function JsonCodeEditorPane({
   const configureJsonSchema = (monaco: WorkbenchMonaco, path: string) => {
     if (!jsonSchema) return;
 
-    const jsonDefaults = (
-      monaco.languages.json as unknown as {
-        jsonDefaults?: { setDiagnosticsOptions: (options: unknown) => void };
-      }
-    ).jsonDefaults;
+    const jsonLanguage = monaco.languages.json as unknown as
+      | {
+          jsonDefaults?: { setDiagnosticsOptions: (options: unknown) => void };
+        }
+      | undefined;
+    const jsonDefaults = jsonLanguage?.jsonDefaults;
     if (!jsonDefaults) return;
 
     jsonDefaults.setDiagnosticsOptions({

package/src/jdw/builtins/renderBuiltinWidgetLeaf.tsx

@@ -1,9 +1,7 @@
 import { createElement, type CSSProperties, type ReactNode } from 'react';
 import type { GenericWidget } from '@workbench-kit/jdw';
 
-function readNumber(value: unknown): number | undefined {
-  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-}
+import { readNumber } from '../../utils/readNumber';
 
 function readString(value: unknown): string | undefined {
   return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;

package/src/jdw/createBuiltinJdwRegistry.ts

@@ -10,6 +10,7 @@ import {
   type GenericWidget,
 } from '@workbench-kit/jdw';
 
+import { readNumber } from '../utils/readNumber';
 import { renderBuiltinWidgetLeaf } from './builtins/renderBuiltinWidgetLeaf.js';
 
 const LAYOUT_INSPECTOR = [
@@ -73,10 +74,6 @@ function build(widget: WidgetTypeShape) {
   return renderBuiltinWidgetLeaf(widget as GenericWidget);
 }
 
-function readNumber(value: unknown): number | undefined {
-  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-}
-
 function readString(value: unknown): string | undefined {
   return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
 }

package/src/jdw/cssRenderBackend.tsx

@@ -22,6 +22,7 @@ import {
   type WidgetPath,
 } from '@workbench-kit/jdw';
 
+import { readNumber } from '../utils/readNumber';
 import { renderBuiltinWidgetLeaf } from './builtins/renderBuiltinWidgetLeaf.js';
 import { BUILTIN_JDW_REGISTRY } from './createBuiltinJdwRegistry.js';
 export interface CssRenderBackendOptions {
@@ -45,10 +46,6 @@ const LAYOUT_CONTAINER_TYPES = new Set([
   'sized_box',
 ]);
 
-function readNumber(value: unknown): number | undefined {
-  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-}
-
 function renderFromRegistry(
   registry: WidgetRegistryContract<unknown>,
   widget: GenericWidget,

package/src/jdw/fixtures/jdw-fixtures.ts

@@ -35,18 +35,3 @@ export const JDW_FIXTURE_ROW_FLEX = `{
   }
 }
 `;
-
-export const JDW_FIXTURE_GRID_CELLS = `{
-  "type": "grid",
-  "args": {
-    "columns": 2,
-    "gap": 8,
-    "padding": 12,
-    "children": [
-      { "type": "text", "args": { "text": "A", "col": 0, "row": 0 } },
-      { "type": "text", "args": { "text": "B", "col": 1, "row": 0 } },
-      { "type": "text", "args": { "text": "Wide", "col": 0, "row": 1, "colSpan": 2 } }
-    ]
-  }
-}
-`;