@contractspec/bundle.library 3.8.12 → 3.9.2

package/src/components/docs/specs/SpecsConnectPage.tsx

@@ -20,6 +20,12 @@ const artifacts = [
 	},
 ];
 
+const adoptionOutputs = [
+	'`.contractspec/adoption/catalog.json` mirrored from the bundled ContractSpec catalog',
+	'family-aware reuse recommendations for `ui`, `contracts`, `integrations`, `runtime`, `sharedLibs`, and `solutions`',
+	'verdict thresholds that can prefer workspace reuse, ContractSpec reuse, review, or explicit denial before a new implementation starts',
+];
+
 const adoptionSteps = [
 	'Enable `connect` in `.contractsrc.json` and keep your protected, immutable, generated, and smoke-check policies explicit.',
 	'Run `contractspec connect context` and `contractspec connect plan` before risky work so the agent is operating on task-scoped evidence, not ambient repo assumptions.',
@@ -81,6 +87,8 @@ export function SpecsConnectPage() {
 					language="bash"
 					filename="contractspec-connect"
 					code={`contractspec connect init --scope workspace
+contractspec connect adoption sync --json
+printf '{"goal":"Prefer an existing release helper before adding a new one"}' | contractspec connect adoption resolve --family sharedLibs --stdin --json
 contractspec connect context --task refactor-docs --paths packages/libs/contracts-spec/src/control-plane/contracts.ts --json
 printf '{"objective":"Document the control-plane contract surface","commands":["bun run typecheck"]}' | contractspec connect plan --task refactor-docs --stdin --json
 printf '{"operation":"edit","path":"packages/libs/contracts-spec/src/control-plane/contracts.ts"}' | contractspec connect verify --task refactor-docs --tool acp.fs.access --stdin --json
@@ -112,6 +120,28 @@ contractspec connect replay <decisionId> --json`}
 				</div>
 			</section>
 
+			<section className="editorial-panel space-y-5">
+				<div className="space-y-2">
+					<h2 className="font-serif text-3xl tracking-[-0.03em]">
+						Reuse-first adoption is part of the workflow
+					</h2>
+					<p className="text-muted-foreground text-sm leading-7">
+						Connect adoption keeps reuse guidance in the same local control
+						surface. Before a new contract family, helper, or runtime
+						abstraction lands, Connect can mirror the bundled catalog and
+						resolve the best reuse candidate by family.
+					</p>
+				</div>
+				<ul className="editorial-list">
+					{adoptionOutputs.map((item) => (
+						<li key={item}>
+							<span className="editorial-list-marker" />
+							<span>{item}</span>
+						</li>
+					))}
+				</ul>
+			</section>
+
 			<section className="grid gap-5 lg:grid-cols-2">
 				<article className="editorial-panel space-y-4">
 					<h2 className="font-serif text-3xl tracking-[-0.03em]">

package/src/components/docs/specs/SpecsDataViewsPage.tsx

@@ -1,6 +1,55 @@
 import Link from '@contractspec/lib.ui-link';
 import { ChevronRight } from 'lucide-react';
 
+const SPECS_DATAVIEWS_EXAMPLE = `import { defineDataView } from '@contractspec/lib.contracts-spec/data-views';
+import { ListDataGridShowcaseRowsQuery } from '@contractspec/example.data-grid-showcase/contracts/data-grid-showcase.operation';
+
+export const DataGridShowcaseDataView = defineDataView({
+  meta: {
+    key: 'examples.data-grid-showcase.table',
+    version: '1.0.0',
+    entity: 'account',
+    title: 'Data Grid Showcase Table',
+    description:
+      'Declarative DataViewSpec for the ContractSpec table showcase.',
+    domain: 'examples',
+    owners: ['@platform.core'],
+    tags: ['examples', 'table', 'data-grid'],
+    stability: 'experimental',
+  },
+  source: {
+    primary: {
+      key: ListDataGridShowcaseRowsQuery.meta.key,
+      version: ListDataGridShowcaseRowsQuery.meta.version,
+    },
+  },
+  view: {
+    kind: 'table',
+    executionMode: 'client',
+    selection: 'multiple',
+    columnVisibility: true,
+    columnResizing: true,
+    columnPinning: true,
+    rowExpansion: {
+      fields: ['notes', 'renewalDate', 'lastActivityAt'],
+    },
+    initialState: {
+      pageSize: 4,
+      hiddenColumns: ['notes'],
+      pinnedColumns: {
+        left: ['account'],
+      },
+      sorting: [{ field: 'arr', desc: true }],
+    },
+    fields: [
+      { key: 'account', label: 'Account', dataPath: 'account', sortable: true },
+      { key: 'owner', label: 'Owner', dataPath: 'owner', sortable: true },
+      { key: 'status', label: 'Status', dataPath: 'status', sortable: true },
+      { key: 'notes', label: 'Notes', dataPath: 'notes' },
+    ],
+  },
+});`;
+
 // export const metadata = {
 //   title: 'DataViews: ContractSpec Docs',
 //   description:
@@ -69,51 +118,23 @@ export function SpecsDataViewsPage() {
 			<div className="space-y-4">
 				<h2 className="font-bold text-2xl">Example DataViewSpec</h2>
 				<p className="text-muted-foreground">
-					Here's a DataView for listing orders in TypeScript:
+					Here is the canonical table contract used by the live{' '}
+					<Link
+						href="/docs/examples/data-grid-showcase"
+						className="text-[color:var(--rust)] underline underline-offset-4"
+					>
+						Data Grid Showcase
+					</Link>
+					:
 				</p>
 				<div className="overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm">
-					<pre>{`import { defineDataView } from '@contractspec/lib.contracts-spec';
-import { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
-
-export const OrderList = defineDataView({
-  meta: {
-    key: 'order.list',
-    version: '1.0.0',
-    description: 'List of recent orders',
-  },
-  source: {
-    type: 'database',
-    table: 'orders',
-  },
-  fields: [
-    { name: 'orderId', type: 'uuid', sortable: true },
-    { name: 'customerName', type: 'string', searchable: true },
-    { name: 'total', type: 'number', sortable: true },
-    { 
-      name: 'status', 
-      type: 'enum', 
-      values: ['pending', 'processing', 'shipped'],
-      filterable: true 
-    },
-    { 
-      name: 'createdAt', 
-      type: 'timestamp', 
-      sortable: true, 
-      defaultSort: 'desc' 
-    },
-  ],
-  filters: [
-    { name: 'status', field: 'status', operator: 'in' },
-    { name: 'dateRange', field: 'createdAt', operator: 'between' },
-    { name: 'minTotal', field: 'total', operator: 'gte' },
-  ],
-  pagination: {
-    type: 'cursor',
-    defaultPageSize: 50,
-    maxPageSize: 200,
-  },
-});`}</pre>
+					<pre>{SPECS_DATAVIEWS_EXAMPLE}</pre>
 				</div>
+				<p className="text-muted-foreground text-sm">
+					This one contract drives the DataView lane, while the same rows and
+					controller also feed the raw web primitive, native-first primitive,
+					and composed design-system demos.
+				</p>
 			</div>
 
 			<div className="space-y-4">

package/src/index.ts

@@ -1,10 +1,10 @@
+export * from './bundles/LibraryBundle';
 export * from './components/docs';
 export * from './components/integrations';
 export * from './components/legal';
 export * from './components/shared';
 export * from './components/shell';
 export * from './components/templates';
-
 // App config and features
 export * from './config';
 export * from './features';

package/src/components/docs/generated/docs-index.mobile-demo-tasks.json

@@ -1,34 +0,0 @@
-[
-	{
-		"id": "mobile-demo.tasks/mobile-demo.tasks",
-		"title": "mobile-demo.tasks",
-		"summary": "Task-list demo feature for the Expo app, covering list, create, and status updates.\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.core\n- **Tags**: mobile, tasks, expo, example",
-		"route": "/docs/reference/mobile-demo.tasks/mobile-demo.tasks",
-		"source": "generated",
-		"contentPath": "mobile-demo.tasks/mobile-demo.tasks.md"
-	},
-	{
-		"id": "mobile-demo.tasks/task.create",
-		"title": "task.create",
-		"summary": "Create a new task.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.core\n- **Tags**: task, mobile\n- **File**: `packages/apps/mobile-demo/src/contracts/task.contract.ts`",
-		"route": "/docs/reference/mobile-demo.tasks/task.create",
-		"source": "generated",
-		"contentPath": "mobile-demo.tasks/task.create.md"
-	},
-	{
-		"id": "mobile-demo.tasks/task.list",
-		"title": "task.list",
-		"summary": "List all tasks.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.core\n- **Tags**: task, mobile\n- **File**: `packages/apps/mobile-demo/src/contracts/task.contract.ts`",
-		"route": "/docs/reference/mobile-demo.tasks/task.list",
-		"source": "generated",
-		"contentPath": "mobile-demo.tasks/task.list.md"
-	},
-	{
-		"id": "mobile-demo.tasks/task.updateStatus",
-		"title": "task.updateStatus",
-		"summary": "Toggle task done status.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.core\n- **Tags**: task, mobile\n- **File**: `packages/apps/mobile-demo/src/contracts/task.contract.ts`",
-		"route": "/docs/reference/mobile-demo.tasks/task.updateStatus",
-		"source": "generated",
-		"contentPath": "mobile-demo.tasks/task.updateStatus.md"
-	}
-]