@utopia-studio-design/design-system-cli 0.4.0 → 0.5.0

package/data/docs/observability.md

@@ -0,0 +1,165 @@
+# Ceramic Observability
+
+Ceramic observability has two explicit modes. It is not a hidden backdoor:
+
+- `operational` starts when a host configures and enables a collector. It
+  records only minimized error diagnostics, uses an in-memory page-session ID,
+  ignores actor/account IDs and custom properties, and does not use telemetry
+  cookies, `sessionStorage`, `localStorage`, usage events, or page-view events.
+  It needs no consent click, but hosts must publish notice, assess their lawful
+  basis, and provide an immediate opt-out.
+- `consented` records the allow-listed usage plan and optional opaque cohorts
+  only after explicit consent.
+
+## Decisions this data supports
+
+- Which Ceramic versions, components, and public composition paths are in use?
+- Which anonymous app/account cohort is encountering a repeated error?
+- Which route, viewport class, locale, direction, and release are affected?
+- Did a CLI command succeed or fail, without collecting its arguments or path?
+- Did a fixed error fingerprint stop recurring after a release?
+
+## Data minimization contract
+
+Consented Ceramic telemetry may collect:
+
+- event name and timestamp;
+- opaque app, account, actor, session, and event IDs;
+- component and operation names;
+- package version and application release;
+- route template supplied by the host;
+- locale, direction, and viewport bucket;
+- stable error code, error class, and non-reversible fingerprint;
+- allow-listed short boolean, numeric, or non-email string properties.
+
+Ceramic does not collect:
+
+- names, email addresses, raw database IDs, or authentication identifiers;
+- DOM, form values, user copy, component props, command arguments, or cwd;
+- error messages or raw stacks;
+- IP addresses in retained records;
+- session replay, screenshots, keystrokes, or network payloads.
+
+Operational mode accepts only `component_error` and `runtime_error`, and removes
+`accountId`, `actorId`, custom properties, and persistent telemetry storage even
+if the host passes them.
+
+In consented mode, pass pre-hashed or otherwise opaque `accountId` and `actorId` values. The SDK
+rejects identifiers with whitespace or email syntax. Route resolvers should
+return route templates such as `/projects/:projectId`, not raw URLs containing
+customer identifiers.
+
+## Start the private collector and dashboard
+
+Create two different random secrets:
+
+```sh
+export CERAMIC_TELEMETRY_INGEST_KEY="$(openssl rand -hex 32)"
+export CERAMIC_TELEMETRY_ADMIN_TOKEN="$(openssl rand -hex 32)"
+export CERAMIC_TELEMETRY_ALLOWED_ORIGINS="http://localhost:5173"
+npm run observability:start
+```
+
+Open `http://127.0.0.1:4318` and enter the admin token. The collector binds to
+loopback by default, retains data for 30 days, and stores newline-delimited JSON
+under `.ceramic/observability/`, which is ignored by Git.
+
+The dashboard shows aggregate event, error, app, opaque actor/account,
+component, release, and fingerprint counts plus the latest sanitized events.
+The admin can export the aggregate response or delete all retained events.
+
+For a shared deployment, place the collector behind TLS, SSO or a private
+network, persistent encrypted storage, rate limiting, and backups appropriate
+to the retention policy. Do not expose the Node reference collector directly
+to the public internet. The admin token must never be put in a `VITE_*`
+variable or browser bundle.
+
+## Configure a React/browser consumer
+
+```tsx
+import {
+  configureCeramicTelemetry,
+  installCeramicGlobalErrorTracking,
+  trackCeramicEvent,
+} from '@utopia-studio-design/design-system/Telemetry'
+
+configureCeramicTelemetry({
+  enabled: diagnosticsPreference !== 'disabled',
+  consent: 'unknown',
+  mode: 'operational',
+  appId: 'renacore-dashboard',
+  endpoint: 'https://observability.example.com',
+  ingestKey: publicWriteOnlyIngestKey,
+  packageVersion: '0.6.0',
+  release: appRelease,
+  routeResolver: () => currentRouteTemplate,
+  sampleRate: 0.1,
+})
+
+const removeGlobalTracking = installCeramicGlobalErrorTracking()
+```
+
+Global error listeners are never installed automatically by the package. The
+host owns notice, lawful-basis assessment, opt-out, route normalization,
+installation, and cleanup. Errors are sampled at 100%. Repeated reports with the same
+fingerprint inside two seconds are deduplicated so a component boundary and a
+global listener do not create duplicate incidents.
+
+Ceramic's validated `asChild` paths report `ERR_COMPOSITION_CHILD` through the
+configured client before throwing their explanatory development error. With no
+configured and enabled client, this call is a no-op.
+
+To enable usage events, obtain separate explicit consent and configure
+`mode: "consented"`, `consent: "granted"`, and any opaque cohort IDs.
+
+## Configure CLI diagnostics
+
+CLI telemetry is also disabled by default and never sends command arguments,
+queries, target directories, generated file names, or cwd.
+
+```sh
+export CERAMIC_TELEMETRY_ENABLED=true
+export CERAMIC_TELEMETRY_MODE=operational
+export CERAMIC_TELEMETRY_ENDPOINT=https://observability.example.com
+export CERAMIC_TELEMETRY_INGEST_KEY=replace-with-write-only-key
+export CERAMIC_TELEMETRY_APP_ID=renacore-dashboard
+npx utopia-ds doctor --json
+```
+
+Operational CLI mode sends failed completion only, without actor/account IDs.
+Consented mode additionally requires `CERAMIC_TELEMETRY_MODE=consented` and
+`CERAMIC_TELEMETRY_CONSENT=granted`, and may send successful completion and
+opaque cohorts. Network failure never changes CLI output or exit status.
+
+## Event plan
+
+| Event | Trigger | Decision fields |
+| --- | --- | --- |
+| `app_started` | Consented SDK initialization | app, release, package version |
+| `component_used` | Explicit host instrumentation | component, operation, route |
+| `component_error` | Ceramic component contract failure | component, operation, error code/fingerprint |
+| `runtime_error` | Explicit boundary/global error capture | route, release, error code/fingerprint |
+| `cli_command_completed` | Operational failure or consented CLI process exit | command, success, version |
+
+## Public notice and controls
+
+The Ceramic documentation site publishes `#/terms` and `#/privacy`. Its privacy
+page includes a browser-level operational-diagnostics opt-out and honors Global
+Privacy Control and Do Not Track. Consumer applications must publish their own
+notice and control because they determine the collector, purpose, retention,
+recipients, and jurisdiction.
+
+## Operations and deletion
+
+- Default retention: 30 days; configure 1–365 days.
+- `GET /health`: unauthenticated liveness only.
+- `POST /v1/events`: write-only ingest-key authentication.
+- `GET /v1/summary`: admin Bearer authentication.
+- `DELETE /v1/events`: admin Bearer authentication and full retained-data deletion.
+- `DELETE /v1/events?actorId=<opaque-id>` or `?accountId=<opaque-id>`:
+  selective deletion for a consent withdrawal or data-subject request.
+- Rotate ingest and admin secrets independently.
+- Treat the ingest key as public/write-only when used in browsers.
+- Treat the admin token as a server-side secret.
+- Publish a privacy notice before enabling identifiable account or actor
+  cohorts in a production consumer.

package/data/docs/quick-start-ai.md

@@ -42,6 +42,30 @@ export function SaveAction() {
 }
 ```
 
+For navigation, keep the anchor or framework link as the single interactive
+element:
+
+```tsx
+import Link from 'next/link'
+import { Button } from '@utopia-studio-design/design-system/Button'
+
+<Button asChild variant="outline" size="sm">
+  <a href="/docs">Docs</a>
+</Button>
+
+<Button asChild startContent={<FolderIcon />}>
+  <Link href="/settings">Settings</Link>
+</Button>
+```
+
+`asChild` accepts exactly one non-Fragment React element. The child must forward
+`ref`, `className`, events, `children`, and accessibility props to one
+interactive element. Anchor and Link props such as `href`, `target`, and
+`aria-*` are preserved. When `disabled` or `loading` is true, Ceramic does not
+pass the invalid `disabled` attribute to a link: it applies
+`aria-disabled="true"`, `tabIndex={-1}`, and blocks click activation while
+keeping the original `href`.
+
 ## Set Motion Policy
 
 Ceramic maps BeUI-inspired interaction patterns to semantic roles: `press`, `page`, `expand`, `reveal`, and `icon`. Set the application default once and override only when a local workflow needs to be static.
@@ -68,6 +92,8 @@ Never bypass `MotionProvider`, semantic motion tokens, or `prefers-reduced-motio
 npx utopia-ds manifest --json
 npx utopia-ds search "Arabic settings form" --json
 npx utopia-ds component Button --json
+npx utopia-ds registry --list --json
+npx utopia-ds layout validate ./dashboard-layout.json --json
 npx utopia-ds template --list --json
 npx utopia-ds template template-saas-solution-homepage --copy ./saas-solution-website
 npx utopia-ds template template-saas-solution-homepage --theme dextrum --copy ./dextrum-website
@@ -94,7 +120,35 @@ The MCP server exposes the same API as the CLI. A generated `.mcp.json` uses:
 }
 ```
 
-Available tools include search, component/template/theme/doc discovery, and doctor. An MCP client must never receive capabilities that the CLI cannot expose.
+Available tools include search, component/template/theme/doc discovery,
+composition-registry discovery, layout and agent-mutation validation, and
+doctor. An MCP client must never receive capabilities that the CLI cannot
+expose.
+
+## Compose Modular Dashboards
+
+Use the Ceramic Composition Registry before generating or rearranging dashboard
+blocks:
+
+```sh
+npx utopia-ds registry --list --json
+npx utopia-ds registry metric-grid --json
+npx utopia-ds layout validate ./dashboard-layout.json --json
+```
+
+Registry definitions expose only reviewed semantic props, responsive spans,
+states, data requirements, locks, and agent permissions. Layout JSON must not
+contain arbitrary CSS, colors, shadows, radii, spacing, class names, or token
+overrides. Read `npx utopia-ds docs composition-registry --dense` for the full
+contract and optional Puck adapter boundary.
+
+## Optional diagnostics
+
+Ceramic telemetry is disabled by default. If a product has an approved
+diagnostics consent flow, configure the write-only SDK and private dashboard
+using `npx utopia-ds docs observability --dense`. Never collect names, emails,
+DOM content, component props, command arguments, filesystem paths, error
+messages, or raw stacks.
 
 ## Agent Decision Loop
 

package/data/manifests/blocks.json

@@ -0,0 +1,392 @@
+{
+  "version": "1.0.0",
+  "intent": "Copyable Ceramic compositions that demonstrate a reviewed interaction contract without turning product workflow into a core primitive.",
+  "blocks": [
+    {
+      "id": "interaction-workbench",
+      "title": "Interaction Workbench",
+      "status": "available",
+      "category": "interaction-lab",
+      "purpose": "A deterministic lab for selection, logical grid navigation, typeahead, reordering, resizing, virtualization, undo, RTL, and reduced motion.",
+      "bundlePath": "blocks/interaction-workbench",
+      "sourcePath": "blocks/interaction-workbench/InteractionWorkbench.tsx",
+      "exportName": "InteractionWorkbench",
+      "requiredImports": [
+        "@utopia-studio-design/design-system",
+        "@utopia-studio-design/design-system/Interaction"
+      ],
+      "contracts": [
+        "single, multiple, range, and select-all selection",
+        "roving focus and logical grid navigation",
+        "pointer drag with keyboard and touch alternatives",
+        "resize with keyboard-operable native range input",
+        "virtualized range calculation and stable item keys",
+        "undo and redo command history"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "analytics-chart-card",
+      "title": "Analytics Chart Card",
+      "status": "available",
+      "category": "analytics",
+      "purpose": "A page-ready chart composition with governed states, semantic series, keyboard exploration, and optional exact-value evidence.",
+      "bundlePath": "blocks/analytics-dashboard",
+      "sourcePath": "blocks/analytics-dashboard/AnalyticsDashboardBlocks.tsx",
+      "exportName": "AnalyticsChartCard",
+      "requiredImports": [
+        "@utopia-studio-design/design-system/Charts"
+      ],
+      "contracts": [
+        "line, bar, area, stacked, scatter, and donut families",
+        "loading, empty, error, partial, and ready states",
+        "keyboard point exploration and live exact values",
+        "semantic series and pattern differentiation"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "kpi-grid",
+      "title": "KPI Grid",
+      "status": "available",
+      "category": "analytics",
+      "purpose": "A governed metric group with locale-aware values, comparisons, density, and complete data states.",
+      "bundlePath": "blocks/analytics-dashboard",
+      "sourcePath": "blocks/analytics-dashboard/AnalyticsMetricBlocks.tsx",
+      "exportName": "KPIGrid",
+      "requiredImports": [
+        "@utopia-studio-design/design-system/Badge"
+      ],
+      "contracts": [
+        "locale-aware number, percent, and currency formatting",
+        "compact, default, and comfortable density",
+        "loading, empty, error, partial, and ready states"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "comparison-chart-panel",
+      "title": "Comparison Chart Panel",
+      "status": "available",
+      "category": "analytics",
+      "purpose": "A benchmark and period-comparison chart panel with semantic annotations.",
+      "bundlePath": "blocks/analytics-dashboard",
+      "sourcePath": "blocks/analytics-dashboard/AnalyticsDashboardBlocks.tsx",
+      "exportName": "ComparisonChartPanel",
+      "requiredImports": [
+        "@utopia-studio-design/design-system/Charts"
+      ],
+      "contracts": [
+        "benchmark annotation",
+        "period comparison",
+        "legend synchronization",
+        "accessible summary"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "chart-with-data-table",
+      "title": "Chart with Data Table",
+      "status": "available",
+      "category": "analytics",
+      "purpose": "A chart paired with a semantic table as the exact-value and screen-reader alternative.",
+      "bundlePath": "blocks/analytics-dashboard",
+      "sourcePath": "blocks/analytics-dashboard/AnalyticsDashboardBlocks.tsx",
+      "exportName": "ChartWithDataTable",
+      "requiredImports": [
+        "@utopia-studio-design/design-system/Charts"
+      ],
+      "contracts": [
+        "visual and table data parity",
+        "component-owned horizontal overflow",
+        "semantic caption, row headers, and column headers"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "database-toolbar",
+      "title": "Database Toolbar",
+      "status": "available",
+      "category": "database",
+      "purpose": "Search, filter, sort, group, and create controls for a schema-driven record workspace.",
+      "bundlePath": "blocks/database-workspace",
+      "sourcePath": "blocks/database-workspace/DatabaseWorkspaceBlocks.tsx",
+      "exportName": "DatabaseToolbar",
+      "requiredImports": ["@utopia-studio-design/design-system/Database"],
+      "contracts": ["query controls", "saved view context", "permission-aware create action"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "database-table-block",
+      "title": "Database Table Block",
+      "status": "available",
+      "category": "database",
+      "purpose": "A virtualized, editable semantic record grid with controlled persistence and mobile record transformation.",
+      "bundlePath": "blocks/database-workspace",
+      "sourcePath": "blocks/database-workspace/DatabaseWorkspaceBlocks.tsx",
+      "exportName": "DatabaseTableBlock",
+      "requiredImports": ["@utopia-studio-design/design-system/Database"],
+      "contracts": ["schema-driven properties", "grid keyboard model", "virtualization", "optimistic recovery"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "saved-views-bar",
+      "title": "Saved Views Bar",
+      "status": "available",
+      "category": "database",
+      "purpose": "An explicit saved-view switcher for governed filter, sort, grouping, and visibility presets.",
+      "bundlePath": "blocks/database-workspace",
+      "sourcePath": "blocks/database-workspace/DatabaseWorkspaceBlocks.tsx",
+      "exportName": "SavedViewsBar",
+      "requiredImports": ["@utopia-studio-design/design-system/Database"],
+      "contracts": ["controlled active view", "current view semantics"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "record-detail-drawer",
+      "title": "Record Detail Drawer",
+      "status": "available",
+      "category": "database",
+      "purpose": "A mobile and desktop detail surface that preserves every property outside the dense grid.",
+      "bundlePath": "blocks/database-workspace",
+      "sourcePath": "blocks/database-workspace/DatabaseWorkspaceBlocks.tsx",
+      "exportName": "RecordDetailDrawer",
+      "requiredImports": ["@utopia-studio-design/design-system/Database"],
+      "contracts": ["dialog semantics", "complete property detail", "logical inline-end placement"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "bulk-action-bar",
+      "title": "Bulk Action Bar",
+      "status": "available",
+      "category": "database",
+      "purpose": "A permission-aware action surface for selected records.",
+      "bundlePath": "blocks/database-workspace",
+      "sourcePath": "blocks/database-workspace/DatabaseWorkspaceBlocks.tsx",
+      "exportName": "BulkActionBar",
+      "requiredImports": ["@utopia-studio-design/design-system/Button"],
+      "contracts": ["selection count", "clear selection", "bulk mutation action"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "scheduler-shell",
+      "title": "Scheduler Shell",
+      "status": "available",
+      "category": "calendar",
+      "purpose": "An application scheduler shell with Month, Week, Day, Agenda, timezone, recurrence, conflict, and mutation contracts.",
+      "bundlePath": "blocks/calendar-application",
+      "sourcePath": "blocks/calendar-application/CalendarApplicationBlocks.tsx",
+      "exportName": "SchedulerShell",
+      "requiredImports": ["@utopia-studio-design/design-system/Calendar"],
+      "contracts": ["controlled events and adapter", "accessible agenda", "keyboard and touch move alternatives", "responsive view transition"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "calendar-sidebar",
+      "title": "Calendar Sidebar",
+      "status": "available",
+      "category": "calendar",
+      "purpose": "Date and resource controls for a multi-calendar scheduler.",
+      "bundlePath": "blocks/calendar-application",
+      "sourcePath": "blocks/calendar-application/CalendarApplicationBlocks.tsx",
+      "exportName": "CalendarSidebar",
+      "requiredImports": ["@utopia-studio-design/design-system/Calendar"],
+      "contracts": ["controlled date", "resource visibility", "logical sidebar placement"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "event-editor-drawer",
+      "title": "Event Editor Drawer",
+      "status": "available",
+      "category": "calendar",
+      "purpose": "A modal event editor with occurrence-versus-series scope, validation, dismissal, and focus restoration.",
+      "bundlePath": "blocks/calendar-application",
+      "sourcePath": "blocks/calendar-application/CalendarApplicationBlocks.tsx",
+      "exportName": "EventEditorDrawer",
+      "requiredImports": ["@utopia-studio-design/design-system/Calendar"],
+      "contracts": ["modal focus and scroll lock", "Escape dismissal", "recurrence edit scope", "required and chronological date validation", "async save recovery with preserved draft", "controlled save and delete"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "agenda-panel",
+      "title": "Agenda Panel",
+      "status": "available",
+      "category": "calendar",
+      "purpose": "A chronological semantic event list that remains available beside or instead of visual time grids.",
+      "bundlePath": "blocks/calendar-application",
+      "sourcePath": "blocks/calendar-application/CalendarApplicationBlocks.tsx",
+      "exportName": "AgendaPanel",
+      "requiredImports": ["@utopia-studio-design/design-system/Calendar"],
+      "contracts": ["chronological event order", "screen-reader names", "equivalent event activation"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "timezone-selector",
+      "title": "Timezone Selector",
+      "status": "available",
+      "category": "calendar",
+      "purpose": "An explicit IANA timezone selector for cross-timezone event display.",
+      "bundlePath": "blocks/calendar-application",
+      "sourcePath": "blocks/calendar-application/CalendarApplicationBlocks.tsx",
+      "exportName": "TimezoneSelector",
+      "requiredImports": ["@utopia-studio-design/design-system/Calendar"],
+      "contracts": ["IANA timezone values", "controlled selection", "visible display context"],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "activity-feed",
+      "title": "Activity Feed",
+      "status": "available",
+      "category": "operations",
+      "purpose": "A locale-aware chronological activity stream with grouped views, semantic sources, timezone formatting, and recoverable pagination.",
+      "bundlePath": "blocks/activity-feed",
+      "sourcePath": "blocks/activity-feed/ActivityFeedBlock.tsx",
+      "exportName": "ActivityFeedBlock",
+      "requiredImports": [
+        "@utopia-studio-design/design-system/Badge",
+        "@utopia-studio-design/design-system/Button",
+        "@utopia-studio-design/design-system/DataDisplay",
+        "@utopia-studio-design/design-system/Utilities"
+      ],
+      "contracts": [
+        "actor-independent localized activity labels",
+        "none, day, and source grouping",
+        "locale and IANA timezone-aware timestamps",
+        "inherit, auto, LTR, and RTL direction modes",
+        "loading, empty, error, and ready states",
+        "recoverable page-size pagination",
+        "product-owned records and backend cursors"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "agent-status",
+      "title": "Agent Status",
+      "status": "available",
+      "category": "agentic",
+      "purpose": "A locale-aware execution surface for progress, risk, approval, failure, and completion with product-owned operational data and decisions.",
+      "bundlePath": "blocks/agent-status",
+      "sourcePath": "blocks/agent-status/AgentStatusBlock.tsx",
+      "exportName": "AgentStatusBlock",
+      "requiredImports": [
+        "@utopia-studio-design/design-system/Badge",
+        "@utopia-studio-design/design-system/Button",
+        "@utopia-studio-design/design-system/DataDisplay",
+        "@utopia-studio-design/design-system/Utilities"
+      ],
+      "contracts": [
+        "queued, running, approval, blocked, failed, and completed states",
+        "localized progress, risk, timestamps, and accessible state labels",
+        "inherit, auto, LTR, and RTL direction modes",
+        "loading, empty, error, filtered-empty, and ready states",
+        "product-owned execution records and approval callbacks",
+        "sanitized summaries without raw prompts, stacks, credentials, or command output"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "todo-list",
+      "title": "To-do List",
+      "status": "available",
+      "category": "productivity",
+      "purpose": "A focused task list with controlled product data, semantic filters, completion, due context, priority, and complete loading states.",
+      "bundlePath": "blocks/dashboard-composer",
+      "sourcePath": "blocks/dashboard-composer/DashboardComposerBlocks.tsx",
+      "exportName": "TodoListBlock",
+      "requiredImports": [
+        "@utopia-studio-design/design-system/Badge",
+        "@utopia-studio-design/design-system/Button",
+        "@utopia-studio-design/design-system/Forms"
+      ],
+      "contracts": [
+        "controlled and uncontrolled task data",
+        "keyboard and pointer completion",
+        "semantic task filters",
+        "loading, empty, error, and ready states",
+        "product-owned persistence"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "ceramic-dashboard-renderer",
+      "title": "Ceramic Dashboard Renderer",
+      "status": "available",
+      "category": "composition",
+      "purpose": "A Layout JSON runtime that maps registered definitions to product renderers and validates every agent-style move or removal.",
+      "bundlePath": "blocks/dashboard-composer",
+      "sourcePath": "blocks/dashboard-composer/DashboardComposerBlocks.tsx",
+      "exportName": "CeramicDashboardRenderer",
+      "requiredImports": ["@utopia-studio-design/design-system/Composition"],
+      "contracts": [
+        "versioned layout validation",
+        "product-supplied renderer map",
+        "locked block and region enforcement",
+        "keyboard and touch arrange controls",
+        "responsive registered placement"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    },
+    {
+      "id": "ceramic-puck-adapter",
+      "title": "Ceramic Puck Adapter",
+      "status": "available",
+      "category": "composition",
+      "purpose": "An optional visual-editor adapter that generates Puck fields and permissions from the Ceramic registry, then validates Puck output before producing Layout JSON.",
+      "bundlePath": "blocks/dashboard-composer",
+      "sourcePath": "blocks/dashboard-composer/CeramicPuckAdapter.tsx",
+      "exportName": "createCeramicPuckConfig",
+      "requiredImports": [
+        "@puckeditor/core",
+        "@utopia-studio-design/design-system/Composition"
+      ],
+      "contracts": [
+        "registry-generated component palette and semantic fields",
+        "Puck Data and Ceramic Layout JSON conversion",
+        "locked block and region permissions",
+        "validated publish boundary",
+        "no arbitrary style payloads"
+      ],
+      "rtlReady": true,
+      "reducedMotion": true,
+      "responsiveMinimum": "320px"
+    }
+  ]
+}

package/data/manifests/catalog.json

@@ -193,10 +193,13 @@
             "Avatar",
             "Badge",
             "Bubble",
-            "Calendar",
-            "Carousel",
-            "Chart",
-            "Data Table",
+        "Calendar",
+        "Scheduler Root",
+        "Carousel",
+        "Chart",
+        "Chart Root",
+        "Database Root",
+        "Data Table",
             "Empty",
             "Item",
             "Kbd",