@contractspec/bundle.library 3.4.3 → 3.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.library",
-  "version": "3.4.3",
+  "version": "3.5.0",
   "type": "module",
   "scripts": {
     "clean": "rm -rf dist",
@@ -114,6 +114,24 @@
       "node": "./dist/node/application/mcp/providerRankingMcp.js",
       "default": "./dist/application/mcp/providerRankingMcp.js"
     },
+    "./bundles": {
+      "types": "./dist/bundles/index.d.ts",
+      "bun": "./dist/bundles/index.js",
+      "node": "./dist/node/bundles/index.js",
+      "default": "./dist/bundles/index.js"
+    },
+    "./bundles/index": {
+      "types": "./dist/bundles/index.d.ts",
+      "bun": "./dist/bundles/index.js",
+      "node": "./dist/node/bundles/index.js",
+      "default": "./dist/bundles/index.js"
+    },
+    "./bundles/LibraryBundle": {
+      "types": "./dist/bundles/LibraryBundle.d.ts",
+      "bun": "./dist/bundles/LibraryBundle.js",
+      "node": "./dist/node/bundles/LibraryBundle.js",
+      "default": "./dist/bundles/LibraryBundle.js"
+    },
     "./components/docs": {
       "types": "./dist/components/docs/index.d.ts",
       "bun": "./dist/components/docs/index.js",
@@ -1284,6 +1302,12 @@
       "node": "./dist/node/components/shell/WorkspaceProjectShellLayout.js",
       "default": "./dist/components/shell/WorkspaceProjectShellLayout.js"
     },
+    "./components/shell/WorkspaceShellRenderer": {
+      "types": "./dist/components/shell/WorkspaceShellRenderer.d.ts",
+      "bun": "./dist/components/shell/WorkspaceShellRenderer.js",
+      "node": "./dist/node/components/shell/WorkspaceShellRenderer.js",
+      "default": "./dist/components/shell/WorkspaceShellRenderer.js"
+    },
     "./components/shell/WorkspaceSidebar": {
       "types": "./dist/components/shell/WorkspaceSidebar.d.ts",
       "bun": "./dist/components/shell/WorkspaceSidebar.js",
@@ -2137,21 +2161,22 @@
   },
   "dependencies": {
     "@apollo/client": "^4.1.6",
-    "@contractspec/lib.contracts-spec": "3.4.3",
-    "@contractspec/lib.contracts-library": "3.4.3",
-    "@contractspec/lib.content-gen": "3.4.3",
-    "@contractspec/lib.contracts-runtime-server-mcp": "3.4.3",
-    "@contractspec/lib.design-system": "3.4.3",
-    "@contractspec/lib.provider-ranking": "0.4.3",
-    "@contractspec/lib.example-shared-ui": "3.4.3",
-    "@contractspec/lib.knowledge": "3.4.3",
-    "@contractspec/lib.logger": "3.4.3",
-    "@contractspec/lib.runtime-sandbox": "2.4.3",
-    "@contractspec/lib.schema": "3.4.3",
-    "@contractspec/lib.ui-kit-web": "3.4.3",
-    "@contractspec/lib.ui-link": "3.4.3",
-    "@contractspec/module.context-storage": "0.4.3",
-    "@contractspec/module.examples": "3.4.3",
+    "@contractspec/lib.contracts-spec": "3.5.0",
+    "@contractspec/lib.contracts-library": "3.5.0",
+    "@contractspec/lib.content-gen": "3.5.0",
+    "@contractspec/lib.contracts-runtime-server-mcp": "3.5.0",
+    "@contractspec/lib.design-system": "3.5.0",
+    "@contractspec/lib.surface-runtime": "0.3.0",
+    "@contractspec/lib.provider-ranking": "0.5.0",
+    "@contractspec/lib.example-shared-ui": "4.0.0",
+    "@contractspec/lib.knowledge": "3.5.0",
+    "@contractspec/lib.logger": "3.5.0",
+    "@contractspec/lib.runtime-sandbox": "2.5.0",
+    "@contractspec/lib.schema": "3.5.0",
+    "@contractspec/lib.ui-kit-web": "3.5.0",
+    "@contractspec/lib.ui-link": "3.5.0",
+    "@contractspec/module.context-storage": "0.5.0",
+    "@contractspec/module.examples": "3.5.0",
     "@dnd-kit/core": "^6.1.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -2159,23 +2184,23 @@
     "@scaleway/sdk": "^3.3.1",
     "@scaleway/sdk-client": "^2.2.1",
     "drizzle-orm": "^0.45.1",
-    "framer-motion": "^12.35.0",
+    "framer-motion": "^12.35.1",
     "lucide-react": "^0.577.0",
     "posthog-js": "^1.359.1",
     "posthog-node": "^5.28.0",
     "posthog-react-native": "^4.37.1",
     "react-hook-form": "^7.71.2",
     "zod": "^4.3.5",
-    "@contractspec/lib.contracts-integrations": "3.4.3",
-    "@contractspec/lib.contracts-runtime-server-rest": "3.4.3",
-    "@contractspec/lib.contracts-runtime-server-graphql": "3.4.3"
+    "@contractspec/lib.contracts-integrations": "3.5.0",
+    "@contractspec/lib.contracts-runtime-server-rest": "3.5.0",
+    "@contractspec/lib.contracts-runtime-server-graphql": "3.5.0"
   },
   "devDependencies": {
     "@types/react": "~19.2.14",
-    "@contractspec/tool.typescript": "3.4.3",
+    "@contractspec/tool.typescript": "3.5.0",
     "typescript": "^5.9.3",
     "@types/bun": "~1.3.10",
-    "@contractspec/tool.bun": "3.4.3"
+    "@contractspec/tool.bun": "3.5.0"
   },
   "publishConfig": {
     "access": "public",
@@ -2277,6 +2302,24 @@
         "node": "./dist/node/application/mcp/providerRankingMcp.js",
         "default": "./dist/application/mcp/providerRankingMcp.js"
       },
+      "./bundles": {
+        "types": "./dist/bundles/index.d.ts",
+        "bun": "./dist/bundles/index.js",
+        "node": "./dist/node/bundles/index.js",
+        "default": "./dist/bundles/index.js"
+      },
+      "./bundles/index": {
+        "types": "./dist/bundles/index.d.ts",
+        "bun": "./dist/bundles/index.js",
+        "node": "./dist/node/bundles/index.js",
+        "default": "./dist/bundles/index.js"
+      },
+      "./bundles/LibraryBundle": {
+        "types": "./dist/bundles/LibraryBundle.d.ts",
+        "bun": "./dist/bundles/LibraryBundle.js",
+        "node": "./dist/node/bundles/LibraryBundle.js",
+        "default": "./dist/bundles/LibraryBundle.js"
+      },
       "./components/docs": {
         "types": "./dist/components/docs/index.d.ts",
         "bun": "./dist/components/docs/index.js",
@@ -3447,6 +3490,12 @@
         "node": "./dist/node/components/shell/WorkspaceProjectShellLayout.js",
         "default": "./dist/components/shell/WorkspaceProjectShellLayout.js"
       },
+      "./components/shell/WorkspaceShellRenderer": {
+        "types": "./dist/components/shell/WorkspaceShellRenderer.d.ts",
+        "bun": "./dist/components/shell/WorkspaceShellRenderer.js",
+        "node": "./dist/node/components/shell/WorkspaceShellRenderer.js",
+        "default": "./dist/components/shell/WorkspaceShellRenderer.js"
+      },
       "./components/shell/WorkspaceSidebar": {
         "types": "./dist/components/shell/WorkspaceSidebar.d.ts",
         "bun": "./dist/components/shell/WorkspaceSidebar.js",

package/src/bundles/LibraryBundle.ts

@@ -0,0 +1,152 @@
+/**
+ * Library bundle spec for workspace shell (sandbox, docs, templates).
+ * Uses @contractspec/lib.surface-runtime for adaptive, preference-driven layouts.
+ */
+
+import { defineModuleBundle } from '@contractspec/lib.surface-runtime/spec';
+
+export const LibraryBundle = defineModuleBundle({
+  meta: {
+    key: 'library.workspace',
+    version: '0.1.0',
+    title: 'Library Workspace',
+    description:
+      'Workspace shell for docs, templates, sandbox, and feature discovery',
+    owners: ['team-platform'],
+    tags: ['library', 'workspace', 'docs', 'sandbox', 'templates'],
+    stability: 'experimental',
+  },
+
+  routes: [
+    {
+      routeId: 'sandbox',
+      path: '/sandbox',
+      defaultSurface: 'workspace-shell',
+    },
+    {
+      routeId: 'docs',
+      path: '/docs',
+      defaultSurface: 'workspace-shell',
+    },
+    {
+      routeId: 'docs-slug',
+      path: '/docs/:slug',
+      defaultSurface: 'workspace-shell',
+    },
+    {
+      routeId: 'studio',
+      path: '/studio/:projectSlug',
+      defaultSurface: 'workspace-shell',
+    },
+  ],
+
+  surfaces: {
+    'workspace-shell': {
+      surfaceId: 'workspace-shell',
+      kind: 'workbench',
+      title: 'Workspace Shell',
+      slots: [
+        {
+          slotId: 'header',
+          role: 'header',
+          accepts: ['action-bar'],
+          cardinality: 'many',
+        },
+        {
+          slotId: 'sidebar',
+          role: 'secondary',
+          accepts: ['entity-section', 'custom-widget'],
+          cardinality: 'one',
+        },
+        {
+          slotId: 'primary',
+          role: 'primary',
+          accepts: [
+            'entity-section',
+            'rich-doc',
+            'data-view',
+            'form',
+            'custom-widget',
+          ],
+          cardinality: 'many',
+          mutableByAi: true,
+          mutableByUser: true,
+        },
+        {
+          slotId: 'assistant',
+          role: 'assistant',
+          accepts: ['assistant-panel', 'chat-thread'],
+          cardinality: 'many',
+          mutableByAi: true,
+          mutableByUser: true,
+        },
+      ],
+
+      layouts: [
+        {
+          layoutId: 'sidebar-main',
+          title: 'Sidebar + Main',
+          root: {
+            type: 'panel-group',
+            direction: 'horizontal',
+            persistKey: 'library.workspace.sidebar-main',
+            children: [
+              { type: 'slot', slotId: 'sidebar' },
+              {
+                type: 'panel-group',
+                direction: 'vertical',
+                persistKey: 'library.workspace.content',
+                children: [
+                  { type: 'slot', slotId: 'header' },
+                  { type: 'slot', slotId: 'primary' },
+                ],
+              },
+            ],
+          },
+        },
+        {
+          layoutId: 'sidebar-main-assistant',
+          title: 'Sidebar + Main + Assistant',
+          root: {
+            type: 'panel-group',
+            direction: 'horizontal',
+            persistKey: 'library.workspace.sidebar-main-assistant',
+            children: [
+              { type: 'slot', slotId: 'sidebar' },
+              {
+                type: 'panel-group',
+                direction: 'vertical',
+                persistKey: 'library.workspace.content',
+                children: [
+                  { type: 'slot', slotId: 'header' },
+                  { type: 'slot', slotId: 'primary' },
+                ],
+              },
+              { type: 'slot', slotId: 'assistant' },
+            ],
+          },
+        },
+      ],
+
+      data: [],
+
+      verification: {
+        dimensions: {
+          guidance:
+            'Can reveal walkthrough notes, field help, and contextual hints.',
+          density:
+            'Can select compact, balanced, or dense layouts for docs and templates.',
+          dataDepth:
+            'Controls content depth, pagination size, and inline expansion.',
+          control:
+            'Shows advanced commands and raw config only when allowed.',
+          media:
+            'Supports text-first docs, visual templates, and hybrid modes.',
+          pace: 'Maps to motion tokens and confirmation behavior.',
+          narrative:
+            'Can order summary before or after detail sections.',
+        },
+      },
+    },
+  },
+});

package/src/bundles/index.ts

@@ -0,0 +1 @@
+export { LibraryBundle } from './LibraryBundle';

package/src/components/shell/WorkspaceShellRenderer.tsx

@@ -0,0 +1,90 @@
+'use client';
+
+import * as React from 'react';
+import { SidebarProvider } from '@contractspec/lib.ui-kit-web/ui/sidebar';
+import {
+  BundleProvider,
+  BundleRenderer,
+} from '@contractspec/lib.surface-runtime/react';
+import type { ResolvedSurfacePlan } from '@contractspec/lib.surface-runtime/runtime/resolve-bundle';
+import { WorkspaceHeader } from './WorkspaceHeader';
+import { WorkspaceSidebar } from './WorkspaceSidebar';
+import type {
+  WorkspaceHeaderProps,
+  ShellSelect,
+  ShellSelectOption,
+} from './WorkspaceHeader';
+import type {
+  WorkspaceSidebarProps,
+  ShellModuleItem,
+} from './WorkspaceSidebar';
+
+export type { ShellSelect, ShellSelectOption, ShellModuleItem };
+
+export interface WorkspaceShellRendererProps
+  extends WorkspaceSidebarProps,
+    WorkspaceHeaderProps {
+  plan: ResolvedSurfacePlan;
+  assistant?: React.ReactNode;
+  children: React.ReactNode;
+  className?: string;
+}
+
+/**
+ * Renders the library workspace using surface-runtime BundleRenderer.
+ * Uses the resolved plan for adaptive layout and preferences.
+ * Replaces WorkspaceProjectShellLayout when surface-runtime is available.
+ */
+export function WorkspaceShellRenderer({
+  plan,
+  title,
+  subtitle,
+  workspaceSelect,
+  projectSelect,
+  environmentSelect,
+  stickyHeaderOffsetPx,
+  headerRight,
+  modules,
+  activeModuleId,
+  onModuleChange,
+  sidebarFooter,
+  assistant,
+  children,
+  className,
+}: WorkspaceShellRendererProps) {
+  const slotContent: Partial<Record<string, React.ReactNode>> = {
+    header: (
+      <WorkspaceHeader
+        title={title}
+        subtitle={subtitle}
+        workspaceSelect={workspaceSelect}
+        projectSelect={projectSelect}
+        environmentSelect={environmentSelect}
+        stickyHeaderOffsetPx={stickyHeaderOffsetPx}
+        headerRight={headerRight}
+      />
+    ),
+    sidebar: (
+      <WorkspaceSidebar
+        modules={modules}
+        activeModuleId={activeModuleId}
+        onModuleChange={onModuleChange}
+        sidebarFooter={sidebarFooter}
+      />
+    ),
+    primary: <main className={className ? `m-4 ${className}` : 'm-4'}>{children}</main>,
+  };
+  if (assistant != null) {
+    slotContent.assistant = assistant;
+  }
+
+  return (
+    <SidebarProvider>
+      <BundleProvider plan={plan}>
+        <div className="bg-background min-h-svh">
+          <BundleRenderer slotContent={slotContent} />
+        </div>
+      </BundleProvider>
+    </SidebarProvider>
+  );
+}

package/src/components/shell/index.ts

@@ -1,3 +1,4 @@
 export * from './WorkspaceHeader';
 export * from './WorkspaceSidebar';
 export * from './WorkspaceProjectShellLayout';
+export * from './WorkspaceShellRenderer';