@texuli/spec 0.8.0 → 0.10.0

package/dist/generated/typescript/design-system.js

@@ -0,0 +1,3 @@
+// Generated by @texuli/spec from schemas/design-system.schema.json. Do not edit: run the spec generator.
+// Spec 0.10.0, digest afcb9e3ed6b74b833a0f7477a657168621785ee98602ff582aa047e2d86aef17
+export {};

package/dist/generated/typescript/diagnostics.js

@@ -1,3 +1,3 @@
 // Generated by @texuli/spec from schemas/diagnostics.schema.json. Do not edit: run the spec generator.
-// Spec 0.8.0, digest f6b6388280d247eb9c3106a925111f35b90d1ec3b59c23652542f06a9f103daf
+// Spec 0.10.0, digest afcb9e3ed6b74b833a0f7477a657168621785ee98602ff582aa047e2d86aef17
 export {};

package/dist/generated/typescript/manifest.js

@@ -1,3 +1,3 @@
 // Generated by @texuli/spec from schemas/manifest.schema.json. Do not edit: run the spec generator.
-// Spec 0.8.0, digest f6b6388280d247eb9c3106a925111f35b90d1ec3b59c23652542f06a9f103daf
+// Spec 0.10.0, digest afcb9e3ed6b74b833a0f7477a657168621785ee98602ff582aa047e2d86aef17
 export {};

package/dist/generated/typescript/vocabulary.d.ts

@@ -1,5 +1,5 @@
 /** The built catalog this vocabulary was projected from. */
-export declare const SPEC_CATALOG_HASH = "598075e391ed95dcba46e120d2fbb706e8ff67d0d5bdeb3c0741f334f439b264";
+export declare const SPEC_CATALOG_HASH = "1372c1dde6017747a7fd62bf309b2c30484effeae209585b46c97506b0a8842c";
 /** Every closed component id, sorted. */
 export declare const SPEC_COMPONENT_IDS: readonly ["action-form", "alert", "alert-dialog", "analytics-grid", "app-nav", "badge", "banner", "blocks-code", "blocks-data", "blocks-diagram", "blocks-embed", "blocks-interactive", "blocks-map", "blocks-media", "blocks-structure", "blocks-text", "breadcrumb", "button", "button-group", "callout", "canvas", "card", "charts-area", "charts-bar", "charts-bubble", "charts-bullet", "charts-canvas-renderer", "charts-cartesian", "charts-combo", "charts-donut", "charts-funnel", "charts-gauge", "charts-geo-map", "charts-geo-point-map", "charts-heatmap", "charts-line", "charts-network", "charts-pie", "charts-progress-ring", "charts-sankey", "charts-scatter", "charts-sparkline", "charts-stacked-bar", "charts-sunburst", "charts-treemap", "chat-message", "chat-thread", "checkbox", "chip", "code", "combobox", "command-palette", "content-layout", "context-menu", "context-menu-trigger", "control-choice", "control-filter", "control-slider", "control-toggle", "data-board", "data-calendar", "data-cohort-table", "data-dashboard", "data-dashboard-widget", "data-files", "data-filter-builder", "data-grid", "data-map", "data-notification-inbox", "data-timeline", "data-tree-view", "deck-slide", "description", "detail-panel", "dialog", "document", "drawer", "dropdown-menu", "dropdown-menu-content", "dropdown-menu-item", "dropdown-menu-trigger", "empty-state", "error-state", "field", "field-error", "flow-action", "flow-view", "form", "form-field", "form-submit", "host-region", "hover-card", "hover-card-content", "icon-button", "inline-text", "input", "input-group", "kbd", "kpi", "label", "layout-auth-split", "layout-blog", "layout-card", "layout-chrome", "layout-dashboard-grid", "layout-deck", "layout-doc", "layout-docs", "layout-drawer", "layout-dual-sidebar", "layout-editorial", "layout-grid", "layout-host", "layout-landing", "layout-marketing", "layout-page", "layout-pricing", "layout-row", "layout-settings", "layout-sidebar", "layout-split", "layout-stack", "layout-tile", "layout-top-nav", "layout-wizard", "media-composition-canvas", "media-composition-svg", "media-image", "menubar", "menubar-trigger", "multi-select", "nav-icon", "navigation-menu", "pagination", "popover", "popover-content", "radio", "radio-group", "responsive-modal", "schema-form", "screen-outlet", "select", "select-content", "select-group", "select-item", "select-label", "select-portal", "select-separator", "select-trigger", "select-value", "select-viewport", "sheet", "sidebar", "sortable-list", "split-view", "spreadsheet", "stat", "stepper", "switch", "table", "tag", "text-counter", "textarea", "time-field", "timeline", "toaster", "tooltip", "workflow-graph"];
 export type SpecComponentId = (typeof SPEC_COMPONENT_IDS)[number];
@@ -154,20 +154,24 @@ export interface SpecComponentProps {
         description: string;
         fullDomain?: string;
         interactive?: string;
+        locale?: string;
         mode?: 'light' | 'dark';
         series: readonly unknown[];
         title: string;
         visibleDomain?: string;
+        xKind?: 'linear' | 'category' | 'time';
     };
     'charts-bar': {
         annotations?: string;
         description: string;
         fullDomain?: string;
         interactive?: string;
+        locale?: string;
         mode?: 'light' | 'dark';
         series: readonly unknown[];
         title: string;
         visibleDomain?: string;
+        xKind?: 'linear' | 'category' | 'time';
     };
     'charts-bubble': {
         annotations?: string;
@@ -202,20 +206,24 @@ export interface SpecComponentProps {
         fullDomain?: string;
         interactive?: string;
         kind: 'line' | 'area' | 'bar' | 'stacked-bar' | 'combo';
+        locale?: string;
         mode?: 'light' | 'dark';
         series: readonly unknown[];
         title: string;
         visibleDomain?: string;
+        xKind?: 'linear' | 'category' | 'time';
     };
     'charts-combo': {
         annotations?: string;
         description: string;
         fullDomain?: string;
         interactive?: string;
+        locale?: string;
         mode?: 'light' | 'dark';
         series: readonly unknown[];
         title: string;
         visibleDomain?: string;
+        xKind?: 'linear' | 'category' | 'time';
     };
     'charts-donut': {
         data: readonly unknown[];
@@ -281,10 +289,12 @@ export interface SpecComponentProps {
         description: string;
         fullDomain?: string;
         interactive?: string;
+        locale?: string;
         mode?: 'light' | 'dark';
         series: readonly unknown[];
         title: string;
         visibleDomain?: string;
+        xKind?: 'linear' | 'category' | 'time';
     };
     'charts-network': {
         description?: string;
@@ -350,10 +360,12 @@ export interface SpecComponentProps {
         description: string;
         fullDomain?: string;
         interactive?: string;
+        locale?: string;
         mode?: 'light' | 'dark';
         series: readonly unknown[];
         title: string;
         visibleDomain?: string;
+        xKind?: 'linear' | 'category' | 'time';
     };
     'charts-sunburst': {
         description: string;
@@ -433,6 +445,7 @@ export interface SpecComponentProps {
         recentEmptyLabel?: string;
         recentItems?: readonly unknown[];
         recentLabel?: string;
+        searchLabel?: string;
         shortcut?: boolean;
         size?: 'sm' | 'md' | 'lg';
         title?: string;
@@ -520,6 +533,7 @@ export interface SpecComponentProps {
     'data-filter-builder': {
         disabled?: boolean;
         fields: readonly unknown[];
+        issues?: readonly unknown[];
         label: string;
         maxDepth?: number;
         value?: Readonly<Record<string, unknown>>;

package/dist/generated/typescript/vocabulary.js

@@ -1,7 +1,7 @@
 // Generated by @texuli/spec from catalog/components.json. Do not edit: run the spec generator.
-// Spec 0.8.0, digest f6b6388280d247eb9c3106a925111f35b90d1ec3b59c23652542f06a9f103daf
+// Spec 0.10.0, digest afcb9e3ed6b74b833a0f7477a657168621785ee98602ff582aa047e2d86aef17
 /** The built catalog this vocabulary was projected from. */
-export const SPEC_CATALOG_HASH = '598075e391ed95dcba46e120d2fbb706e8ff67d0d5bdeb3c0741f334f439b264';
+export const SPEC_CATALOG_HASH = '1372c1dde6017747a7fd62bf309b2c30484effeae209585b46c97506b0a8842c';
 /** Every closed component id, sorted. */
 export const SPEC_COMPONENT_IDS = [
     'action-form',

package/dist/generated/typescript/workflow.js

@@ -1,3 +1,3 @@
 // Generated by @texuli/spec from schemas/workflow.schema.json. Do not edit: run the spec generator.
-// Spec 0.8.0, digest f6b6388280d247eb9c3106a925111f35b90d1ec3b59c23652542f06a9f103daf
+// Spec 0.10.0, digest afcb9e3ed6b74b833a0f7477a657168621785ee98602ff582aa047e2d86aef17
 export {};

package/dist/migrations/0.8.0-0.9.0.d.ts

@@ -0,0 +1,8 @@
+import type { SpecMigration } from './types.js';
+/**
+ * 0.8.0 → 0.9.0 is additive (PLAN_011 T-gaps-87-95): it refreshes the catalog
+ * projection (the button pending note and the gap props that reach the
+ * manifests) and removes nothing. Every 0.8.0 envelope is a valid 0.9.0
+ * envelope, so the step only stamps `spec`.
+ */
+export declare const migration080to090: SpecMigration;

package/dist/migrations/0.8.0-0.9.0.js

@@ -0,0 +1,11 @@
+/**
+ * 0.8.0 → 0.9.0 is additive (PLAN_011 T-gaps-87-95): it refreshes the catalog
+ * projection (the button pending note and the gap props that reach the
+ * manifests) and removes nothing. Every 0.8.0 envelope is a valid 0.9.0
+ * envelope, so the step only stamps `spec`.
+ */
+export const migration080to090 = Object.freeze({
+    from: '0.8.0',
+    to: '0.9.0',
+    migrate: (envelope) => ({ ...envelope, spec: '0.9.0' }),
+});

package/dist/migrations/0.9.0-0.10.0.d.ts

@@ -0,0 +1,10 @@
+import type { SpecMigration } from './types.js';
+/**
+ * 0.9.0 → 0.10.0 is additive (PLAN_011 T-ds-spec, ADR-021): it adds the
+ * design-system document schema (`schemas/design-system.schema.json`, the
+ * `@texuli/spec/design-system` subpath) and the optional envelope
+ * `designSystem` (`$defs.designSystemReference`, T-ds-blueprint, ADR-024).
+ * Every 0.9.0 envelope is a valid 0.10.0 envelope, so the step only stamps
+ * `spec`: it never adds, moves or reads a `designSystem`.
+ */
+export declare const migration090to0100: SpecMigration;

package/dist/migrations/0.9.0-0.10.0.js

@@ -0,0 +1,13 @@
+/**
+ * 0.9.0 → 0.10.0 is additive (PLAN_011 T-ds-spec, ADR-021): it adds the
+ * design-system document schema (`schemas/design-system.schema.json`, the
+ * `@texuli/spec/design-system` subpath) and the optional envelope
+ * `designSystem` (`$defs.designSystemReference`, T-ds-blueprint, ADR-024).
+ * Every 0.9.0 envelope is a valid 0.10.0 envelope, so the step only stamps
+ * `spec`: it never adds, moves or reads a `designSystem`.
+ */
+export const migration090to0100 = Object.freeze({
+    from: '0.9.0',
+    to: '0.10.0',
+    migrate: (envelope) => ({ ...envelope, spec: '0.10.0' }),
+});

package/dist/migrations/index.js

@@ -6,6 +6,8 @@ import { migration040to050 } from "./0.4.0-0.5.0.js";
 import { migration050to060 } from "./0.5.0-0.6.0.js";
 import { migration060to070 } from "./0.6.0-0.7.0.js";
 import { migration070to080 } from "./0.7.0-0.8.0.js";
+import { migration080to090 } from "./0.8.0-0.9.0.js";
+import { migration090to0100 } from "./0.9.0-0.10.0.js";
 /** The version an envelope without `spec` was written for. */
 export const UNDECLARED_SPEC_VERSION = '0.2.0';
 /** Every step, in order; each `to` is the next step's `from`. */
@@ -16,6 +18,8 @@ export const SPEC_MIGRATIONS = Object.freeze([
     migration050to060,
     migration060to070,
     migration070to080,
+    migration080to090,
+    migration090to0100,
 ]);
 /**
  * Bring a blueprint envelope up to `target` (the current spec by default)

package/dist/validate.js

@@ -31,6 +31,18 @@ export function validateBlueprint(input, documents, options = {}) {
             message: 'The blueprint is bound to another catalog.',
         });
     }
+    // Spec 0.10.0 (ADR-024): the schema has no unions, so "exactly one of ref
+    // and inline" is checked here. The inline document's own rules belong to
+    // `checkDesignSystemReference` (`@texuli/spec/design-system`), which
+    // `@texuli/catalog`'s `validateDraft` runs through the host's check.
+    const system = input.designSystem;
+    if (isRecord(system) && Object.hasOwn(system, 'ref') === Object.hasOwn(system, 'inline')) {
+        diagnostics.push({
+            code: 'schema',
+            path: '$.designSystem',
+            message: 'one-of: A design system sets exactly one of ref and inline.',
+        });
+    }
     const { workflowSchema: schema, validateWorkflowGraph: validate } = documents;
     const workflow = schema && validate ? { schema, validate } : undefined;
     const state = checkStateDeclarations(input.state, diagnostics, workflow);

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** The semantic version of the spec documents in this package. */
-export declare const SPEC_VERSION = "0.8.0";
+export declare const SPEC_VERSION = "0.10.0";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** The semantic version of the spec documents in this package. */
-export const SPEC_VERSION = '0.8.0';
+export const SPEC_VERSION = '0.10.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@texuli/spec",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "The schema-first blueprint contract: JSON schemas, the catalog vocabulary, deterministic TypeScript and Kotlin projections, and the conformance harness.",
   "keywords": [
     "svelte",
@@ -54,6 +54,10 @@
     "./source": {
       "types": "./dist/source.d.ts",
       "default": "./dist/source.js"
+    },
+    "./design-system": {
+      "types": "./dist/design-system/index.d.ts",
+      "default": "./dist/design-system/index.js"
     }
   },
   "files": [