@workbench-kit/shell-react 0.0.2-prototype.0.2.6 → 0.0.2-prototype.0.2.8

package/README.md

@@ -0,0 +1,41 @@
+# `@workbench-kit/shell-react`
+
+React shell and host assembly for Workbench Kit: `WorkbenchProvider`,
+`WorkbenchShell`, editor area wiring, layout/appearance persistence helpers, and
+settings/profile/help composition.
+
+Published on npm with the **`prototype`** dist tag.
+
+## Install
+
+```powershell
+pnpm add @workbench-kit/shell-react@prototype @workbench-kit/react@prototype @workbench-kit/tokens@prototype
+```
+
+Peer: React 19.
+
+## Quick start
+
+```tsx
+import { WorkbenchProvider, WorkbenchShell } from '@workbench-kit/shell-react';
+
+export function App() {
+  return (
+    <WorkbenchProvider>
+      <WorkbenchShell title="Workbench" primarySidebar={<aside />} />
+    </WorkbenchProvider>
+  );
+}
+```
+
+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
+[Getting Started](../../docs/guides/getting-started.md).
+
+## Related docs
+
+- [Component Map](../../docs/guides/component-map.md)
+- [Sample Screens](../../docs/guides/sample-screens.md)
+- [Consumer Capabilities](../../docs/workbench/consumer-capabilities.md)
+- Sample host: [`examples/workbench-sample`](../../examples/workbench-sample/README.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbench-kit/shell-react",
-  "version": "0.0.2-prototype.0.2.6",
+  "version": "0.0.2-prototype.0.2.8",
   "private": false,
   "type": "module",
   "exports": {
@@ -17,15 +17,15 @@
     "@radix-ui/react-select": "^2.3.4",
     "@radix-ui/react-slot": "^1.3.0",
     "@xyflow/react": "^12.11.2",
-    "jsonata": "^1.8.7",
+    "jsonata": "^2.2.0",
     "react-table-mapping": "^1.0.3",
-    "@workbench-kit/react": "0.0.2-prototype.0.2.6",
-    "@workbench-kit/workbench-config": "0.0.2-prototype.0.2.6",
-    "@workbench-kit/tokens": "0.0.2-prototype.0.2.6",
-    "@workbench-kit/field-remap": "0.0.2-prototype.0.2.6",
-    "@workbench-kit/workspace": "0.0.2-prototype.0.2.6",
-    "@workbench-kit/platform": "0.0.2-prototype.0.2.6",
-    "@workbench-kit/workbench-core": "0.0.2-prototype.0.2.6"
+    "@workbench-kit/react": "0.0.2-prototype.0.2.8",
+    "@workbench-kit/field-remap": "0.0.2-prototype.0.2.8",
+    "@workbench-kit/tokens": "0.0.2-prototype.0.2.8",
+    "@workbench-kit/workbench-config": "0.0.2-prototype.0.2.8",
+    "@workbench-kit/workbench-core": "0.0.2-prototype.0.2.8",
+    "@workbench-kit/workspace": "0.0.2-prototype.0.2.8",
+    "@workbench-kit/platform": "0.0.2-prototype.0.2.8"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/{chat-ai-mock-proposals.ts → chat/ai-mock-proposals.ts}

@@ -1,39 +1,39 @@
-import type { WorkbenchChatCommandProposalInput } from './use-workbench-chat-command-proposals.js';
-
-const MOCK_AI_COMMAND_PROPOSALS: readonly WorkbenchChatCommandProposalInput[] = [
-  {
-    commandId: 'workbench.showActivity.explorer',
-    description: 'Focus the Explorer activity in the primary sidebar.',
-    id: 'mock-proposal-show-explorer',
-    label: 'Show Explorer',
-  },
-  {
-    commandId: 'workbench.togglePrimarySidebar',
-    description: 'Toggle the primary sidebar visibility.',
-    id: 'mock-proposal-toggle-sidebar',
-    label: 'Toggle Primary Sidebar',
-  },
-];
-
-export function createMockAiChatCommandProposals(
-  userMessage: string,
-): readonly WorkbenchChatCommandProposalInput[] {
-  const normalized = userMessage.trim().toLocaleLowerCase();
-  if (!normalized || normalized === 'help') {
-    return [];
-  }
-
-  return MOCK_AI_COMMAND_PROPOSALS;
-}
-
-export function createMockAiChatResponseContent(userMessage: string) {
-  const proposals = createMockAiChatCommandProposals(userMessage);
-  if (!proposals.length) {
-    return `Received: ${userMessage}`;
-  }
-
-  return [
-    `I can help with "${userMessage.trim()}".`,
-    'Review the suggested commands below. Safe commands run automatically; workspace changes require approval.',
-  ].join('\n\n');
-}
+import type { WorkbenchChatCommandProposalInput } from './use-chat-command-proposals.js';
+
+const MOCK_AI_COMMAND_PROPOSALS: readonly WorkbenchChatCommandProposalInput[] = [
+  {
+    commandId: 'workbench.showActivity.explorer',
+    description: 'Focus the Explorer activity in the primary sidebar.',
+    id: 'mock-proposal-show-explorer',
+    label: 'Show Explorer',
+  },
+  {
+    commandId: 'workbench.togglePrimarySidebar',
+    description: 'Toggle the primary sidebar visibility.',
+    id: 'mock-proposal-toggle-sidebar',
+    label: 'Toggle Primary Sidebar',
+  },
+];
+
+export function createMockAiChatCommandProposals(
+  userMessage: string,
+): readonly WorkbenchChatCommandProposalInput[] {
+  const normalized = userMessage.trim().toLocaleLowerCase();
+  if (!normalized || normalized === 'help') {
+    return [];
+  }
+
+  return MOCK_AI_COMMAND_PROPOSALS;
+}
+
+export function createMockAiChatResponseContent(userMessage: string) {
+  const proposals = createMockAiChatCommandProposals(userMessage);
+  if (!proposals.length) {
+    return `Received: ${userMessage}`;
+  }
+
+  return [
+    `I can help with "${userMessage.trim()}".`,
+    'Review the suggested commands below. Safe commands run automatically; workspace changes require approval.',
+  ].join('\n\n');
+}

package/src/{chat-command-input.ts → chat/command-input.ts}

@@ -1,52 +1,52 @@
-export type WorkbenchChatCommandInputParseResult =
-  | { type: 'none' }
-  | { type: 'unknown'; token: string }
-  | { commandId: string; message: string; type: 'invalid-arguments' }
-  | { args: readonly unknown[]; commandId: string; type: 'run' };
-
-export function parseWorkbenchChatCommandInput(
-  input: string,
-  isValidCommandId: (id: string) => boolean,
-): WorkbenchChatCommandInputParseResult {
-  const trimmed = input.trim();
-  if (!trimmed.startsWith('/')) {
-    return { type: 'none' };
-  }
-
-  const [rawToken] = trimmed.slice(1).split(/\s+/, 1);
-  if (!rawToken) {
-    return { token: '', type: 'unknown' };
-  }
-
-  if (!isValidCommandId(rawToken)) {
-    return { token: rawToken, type: 'unknown' };
-  }
-
-  const argumentText = getSlashCommandArgumentText(trimmed, rawToken);
-  if (!argumentText) {
-    return {
-      args: [],
-      commandId: rawToken,
-      type: 'run',
-    };
-  }
-
-  try {
-    return {
-      args: [JSON.parse(argumentText) as unknown],
-      commandId: rawToken,
-      type: 'run',
-    };
-  } catch {
-    return {
-      commandId: rawToken,
-      message:
-        'Command arguments must be valid JSON. Use /command.id {"key":"value"} or /command.id "value".',
-      type: 'invalid-arguments',
-    };
-  }
-}
-
-function getSlashCommandArgumentText(trimmedInput: string, commandId: string) {
-  return trimmedInput.slice(1 + commandId.length).trim();
-}
+export type WorkbenchChatCommandInputParseResult =
+  | { type: 'none' }
+  | { type: 'unknown'; token: string }
+  | { commandId: string; message: string; type: 'invalid-arguments' }
+  | { args: readonly unknown[]; commandId: string; type: 'run' };
+
+export function parseWorkbenchChatCommandInput(
+  input: string,
+  isValidCommandId: (id: string) => boolean,
+): WorkbenchChatCommandInputParseResult {
+  const trimmed = input.trim();
+  if (!trimmed.startsWith('/')) {
+    return { type: 'none' };
+  }
+
+  const [rawToken] = trimmed.slice(1).split(/\s+/, 1);
+  if (!rawToken) {
+    return { token: '', type: 'unknown' };
+  }
+
+  if (!isValidCommandId(rawToken)) {
+    return { token: rawToken, type: 'unknown' };
+  }
+
+  const argumentText = getSlashCommandArgumentText(trimmed, rawToken);
+  if (!argumentText) {
+    return {
+      args: [],
+      commandId: rawToken,
+      type: 'run',
+    };
+  }
+
+  try {
+    return {
+      args: [JSON.parse(argumentText) as unknown],
+      commandId: rawToken,
+      type: 'run',
+    };
+  } catch {
+    return {
+      commandId: rawToken,
+      message:
+        'Command arguments must be valid JSON. Use /command.id {"key":"value"} or /command.id "value".',
+      type: 'invalid-arguments',
+    };
+  }
+}
+
+function getSlashCommandArgumentText(trimmedInput: string, commandId: string) {
+  return trimmedInput.slice(1 + commandId.length).trim();
+}

package/src/{chat-command-policy.ts → chat/command-policy.ts}

@@ -1,54 +1,54 @@
-import type {
-  ResolveWorkbenchCommandExecutionPolicyInput,
-  WorkbenchCommandExecutionPolicy,
-} from '@workbench-kit/react/workbench';
-import type { WorkbenchStorageReader } from '@workbench-kit/workbench-core';
-
-import { readPersistedLocalPreferences } from './preference-settings-storage.js';
-
-export const WORKBENCH_AI_CHAT_COMMAND_DEFAULT_POLICY_KEY = 'workbench.chat.aiCommandDefaultPolicy';
-
-function isWorkbenchCommandExecutionPolicy(
-  value: unknown,
-): value is WorkbenchCommandExecutionPolicy {
-  return value === 'auto-allow' || value === 'approval-required' || value === 'auto-deny';
-}
-
-export function readWorkbenchAiChatCommandPolicyInput(
-  storageKey?: string,
-  storage?: WorkbenchStorageReader,
-): ResolveWorkbenchCommandExecutionPolicyInput {
-  const preferences = readPersistedLocalPreferences(storageKey, storage);
-  const configuredDefault = preferences[WORKBENCH_AI_CHAT_COMMAND_DEFAULT_POLICY_KEY];
-
-  return {
-    defaultPolicy: isWorkbenchCommandExecutionPolicy(configuredDefault)
-      ? configuredDefault
-      : undefined,
-    mutatingDefaultPolicy: 'approval-required',
-  };
-}
-
-export function createWorkbenchAiChatCommandPolicyById(
-  entries: Readonly<Record<string, WorkbenchCommandExecutionPolicy>>,
-): ResolveWorkbenchCommandExecutionPolicyInput {
-  return {
-    policyByCommandId: entries,
-  };
-}
-
-export function mergeWorkbenchAiChatCommandPolicyInput(
-  ...inputs: readonly ResolveWorkbenchCommandExecutionPolicyInput[]
-): ResolveWorkbenchCommandExecutionPolicyInput {
-  return inputs.reduce<ResolveWorkbenchCommandExecutionPolicyInput>(
-    (merged, input) => ({
-      defaultPolicy: input.defaultPolicy ?? merged.defaultPolicy,
-      mutatingDefaultPolicy: input.mutatingDefaultPolicy ?? merged.mutatingDefaultPolicy,
-      policyByCommandId: {
-        ...merged.policyByCommandId,
-        ...input.policyByCommandId,
-      },
-    }),
-    {},
-  );
-}
+import type {
+  ResolveWorkbenchCommandExecutionPolicyInput,
+  WorkbenchCommandExecutionPolicy,
+} from '@workbench-kit/react/workbench';
+import type { WorkbenchStorageReader } from '@workbench-kit/workbench-core';
+
+import { readPersistedLocalPreferences } from '../management/preference-settings-storage.js';
+
+export const WORKBENCH_AI_CHAT_COMMAND_DEFAULT_POLICY_KEY = 'workbench.chat.aiCommandDefaultPolicy';
+
+function isWorkbenchCommandExecutionPolicy(
+  value: unknown,
+): value is WorkbenchCommandExecutionPolicy {
+  return value === 'auto-allow' || value === 'approval-required' || value === 'auto-deny';
+}
+
+export function readWorkbenchAiChatCommandPolicyInput(
+  storageKey?: string,
+  storage?: WorkbenchStorageReader,
+): ResolveWorkbenchCommandExecutionPolicyInput {
+  const preferences = readPersistedLocalPreferences(storageKey, storage);
+  const configuredDefault = preferences[WORKBENCH_AI_CHAT_COMMAND_DEFAULT_POLICY_KEY];
+
+  return {
+    defaultPolicy: isWorkbenchCommandExecutionPolicy(configuredDefault)
+      ? configuredDefault
+      : undefined,
+    mutatingDefaultPolicy: 'approval-required',
+  };
+}
+
+export function createWorkbenchAiChatCommandPolicyById(
+  entries: Readonly<Record<string, WorkbenchCommandExecutionPolicy>>,
+): ResolveWorkbenchCommandExecutionPolicyInput {
+  return {
+    policyByCommandId: entries,
+  };
+}
+
+export function mergeWorkbenchAiChatCommandPolicyInput(
+  ...inputs: readonly ResolveWorkbenchCommandExecutionPolicyInput[]
+): ResolveWorkbenchCommandExecutionPolicyInput {
+  return inputs.reduce<ResolveWorkbenchCommandExecutionPolicyInput>(
+    (merged, input) => ({
+      defaultPolicy: input.defaultPolicy ?? merged.defaultPolicy,
+      mutatingDefaultPolicy: input.mutatingDefaultPolicy ?? merged.mutatingDefaultPolicy,
+      policyByCommandId: {
+        ...merged.policyByCommandId,
+        ...input.policyByCommandId,
+      },
+    }),
+    {},
+  );
+}