@oddkin/workbench 0.0.0-stage → 1.0.0-beta.0

package/dist/conformance/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * `@oddkin/workbench/conformance` — portable conformance suites (conformance.v1). DOM-free at
+ * import: suites are data plus case functions that touch the DOM only when a runner calls them.
+ * Contract: docs/architecture/change-impact-and-verification.md §3; ADR 0034.
+ */
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+/** Declared changes an invariant is about. Identity invariants apply only to value changes. */
+export type ChangeKind = 'theme-value' | 'density' | 'programmatic' | 'keyed-reorder' | 'reconnect' | 'invalid-draft';
+/** The subset of a test runner's `expect` that suites use (Vitest and Jest compatible). */
+export interface Matchers {
+    toBe(expected: unknown): void;
+    toEqual(expected: unknown): void;
+    toBeGreaterThan(expected: number): void;
+    toContain(expected: unknown): void;
+}
+export type Expect = (actual: unknown, message?: string) => Matchers;
+/** Real user input from the project's browser runner (e.g. Vitest's `userEvent`). */
+export interface UserInput {
+    click(element: Element): Promise<unknown>;
+    keyboard(text: string): Promise<unknown>;
+}
+/** Locates documented anatomy roles in an implementation. */
+export interface Adapter {
+    /** The element that plays `role` (e.g. `control`), or null if absent. */
+    part(host: HTMLElement, role: string): HTMLElement | null;
+    /** Resolve once pending updates are committed. */
+    settle(host: HTMLElement): Promise<void>;
+}
+export interface MountOptions {
+    readonly attributes?: Readonly<Record<string, string>>;
+    readonly content?: string;
+    /** Markup to place the element in; `{{element}}` marks its position, e.g. inside a form. */
+    readonly within?: string;
+}
+export interface ConformanceContext {
+    /** Tag name of the implementation under test. */
+    readonly tag: string;
+    readonly expect: Expect;
+    readonly user: UserInput;
+    readonly adapter: Adapter;
+    /** Mount the implementation in a fresh container owned by this case. */
+    mount(options?: MountOptions): Promise<HTMLElement>;
+    /** Live counts of owned work (`scopeStats()` from `@oddkin/core/scope`). */
+    ownedWork(): Readonly<Record<string, number>>;
+    /** Resolve after the current task, letting deferred default actions run. */
+    nextTask(): Promise<void>;
+}
+export interface ConformanceCase {
+    readonly id: string;
+    readonly title: string;
+    readonly kind: 'assertion' | 'invariant';
+    /** For invariants: the declared change that must preserve the asserted relationship. */
+    readonly change?: ChangeKind;
+    readonly run: (context: ConformanceContext) => Promise<void> | void;
+}
+export interface ConformanceSuite {
+    /** Stable suite id, e.g. `oddkin.button`. */
+    readonly id: string;
+    /** Suite version (semver), tied to the contract version range below. */
+    readonly version: string;
+    /** The foundation contract verified: a component id and the versions it targets. */
+    readonly contract: {
+        readonly component: string;
+        readonly versions: string;
+    };
+    readonly description?: string;
+    /** Public capabilities an implementation must provide. */
+    readonly requires: {
+        readonly properties?: readonly string[];
+        readonly events?: readonly string[];
+        readonly slots?: readonly string[];
+        readonly anatomy?: readonly string[];
+    };
+    readonly cases: readonly ConformanceCase[];
+}
+/** Freeze a suite. Use `checkConformance` (or a test) to validate it. */
+export declare function defineConformance(suite: ConformanceSuite): ConformanceSuite;
+/** Structural problems in a suite, as diagnostics with JSON-pointer paths. */
+export declare function checkConformance(suite: ConformanceSuite): WorkbenchDiagnostic[];
+/** The serializable `conformance.v1` description of a suite (no functions). */
+export declare function toConformanceJSON(suite: ConformanceSuite): Record<string, unknown>;
+/** One case outcome. Untested cases are `not-executed`, never `passed`. */
+export interface CaseResult {
+    readonly case: string;
+    readonly state: 'passed' | 'failed' | 'not-executed';
+    readonly message?: string;
+}
+/** A `conformance-result.v1` record: evidence for one implementation, configuration, and browser. */
+export interface ConformanceResult {
+    readonly schema: 'https://oddkin.dev/schemas/conformance-result/v1.json';
+    readonly suite: {
+        readonly id: string;
+        readonly version: string;
+    };
+    readonly implementation: {
+        readonly tag: string;
+        readonly package?: string;
+        readonly definition?: string;
+    };
+    readonly configuration: Readonly<Record<string, string>>;
+    readonly environment: {
+        readonly userAgent: string;
+    };
+    readonly date: string;
+    readonly results: readonly CaseResult[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GACpB,aAAa,GAAG,SAAS,GAAG,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,CAAC;AAE/F,2FAA2F;AAC3F,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACpC;AACD,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC;AAErE,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED,6DAA6D;AAC7D,MAAM,WAAW,OAAO;IACtB,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAC1D,kDAAkD;IAClD,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,4EAA4E;IAC5E,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAC5C;AAWD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAE3E;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,CAwB/E;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAelF;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,cAAc,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qGAAqG;AACrG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,uDAAuD,CAAC;IACzE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC"}

package/dist/conformance/index.js

@@ -0,0 +1,60 @@
+/**
+ * `@oddkin/workbench/conformance` — portable conformance suites (conformance.v1). DOM-free at
+ * import: suites are data plus case functions that touch the DOM only when a runner calls them.
+ * Contract: docs/architecture/change-impact-and-verification.md §3; ADR 0034.
+ */
+import { DiagnosticList } from '../internal/diagnostics.js';
+const CHANGES = [
+    'theme-value',
+    'density',
+    'programmatic',
+    'keyed-reorder',
+    'reconnect',
+    'invalid-draft',
+];
+/** Freeze a suite. Use `checkConformance` (or a test) to validate it. */
+export function defineConformance(suite) {
+    return Object.freeze({ ...suite, cases: Object.freeze([...suite.cases]) });
+}
+/** Structural problems in a suite, as diagnostics with JSON-pointer paths. */
+export function checkConformance(suite) {
+    const out = new DiagnosticList();
+    if (!/^[a-z][\w.-]*$/.test(suite.id))
+        out.error('conformance.id.invalid', `Suite id "${suite.id}" must be a lowercase id.`, '/id');
+    if (!/^\d+\.\d+\.\d+/.test(suite.version))
+        out.error('conformance.version.invalid', 'Suite version must be semver.', '/version');
+    if (!/^component:[a-z][\w.]*-[\w.-]*$/.test(suite.contract.component))
+        out.error('conformance.contract.invalid', 'Use a component id such as "component:odd-button".', '/contract/component');
+    if (!suite.cases.length)
+        out.error('conformance.cases.empty', 'A suite needs cases.', '/cases');
+    const seen = new Set();
+    suite.cases.forEach((c, index) => {
+        const path = `/cases/${index}`;
+        if (seen.has(c.id))
+            out.error('conformance.case.duplicate', `Case "${c.id}" repeats.`, path);
+        seen.add(c.id);
+        if (c.kind === 'invariant' && !(c.change && CHANGES.includes(c.change)))
+            out.error('conformance.invariant.change', `Invariant "${c.id}" must name a change.`, path);
+        if (c.kind === 'assertion' && c.change)
+            out.error('conformance.assertion.change', `Assertion "${c.id}" names a change.`, path);
+    });
+    return out.items;
+}
+/** The serializable `conformance.v1` description of a suite (no functions). */
+export function toConformanceJSON(suite) {
+    return {
+        schema: 'https://oddkin.dev/schemas/conformance/v1.json',
+        id: suite.id,
+        version: suite.version,
+        contract: { ...suite.contract },
+        ...(suite.description ? { description: suite.description } : {}),
+        requires: { ...suite.requires },
+        cases: suite.cases.map((c) => ({
+            id: c.id,
+            title: c.title,
+            kind: c.kind,
+            ...(c.change ? { change: c.change } : {}),
+        })),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/conformance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"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"}

package/dist/data/build.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Build the Workbench data files from analyzer outputs, configuration, authored content, and the
+ * token inspection the foundations reference (workbench.md §2.1). Pure and deterministic: the same
+ * inputs give the same files, and no build time enters them.
+ */
+import { type DocsContent, type ResolvedWorkbenchConfig, type WorkbenchConfig } from '../config/index.js';
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+import { type ThemeStudioInput } from './theme-studio.js';
+import { type LibraryInput, type PageData, type TokenInspectionLike, type WorkbenchData, type WorkbenchIndex } from './types.js';
+export type { ThemeStudioInput } from './theme-studio.js';
+export interface WorkbenchDataInput {
+    readonly config: WorkbenchConfig | ResolvedWorkbenchConfig;
+    /** The documented packages, in configuration order. */
+    readonly libraries: readonly LibraryInput[];
+    /** Authored content (`oddkin.docs.ts`). */
+    readonly docs?: DocsContent;
+    /** The token inspection the foundations reference (their `generation` source). */
+    readonly tokens?: TokenInspectionLike;
+    /** Theme Studio's baseline configuration and generator, loaded by dev tooling. */
+    readonly theme?: ThemeStudioInput;
+    /** Diagnostics from reading these inputs; reported first, with the data's own. */
+    readonly diagnostics?: readonly WorkbenchDiagnostic[];
+}
+/** The data file of a page, relative to the index: `pages/components/odd-button.json`. */
+export declare function pageFile(id: string): string;
+/**
+ * Build the index and the visible pages' data. `data` is undefined only when the configuration
+ * is invalid; every other problem is a diagnostic and leaves the affected value unknown.
+ */
+export declare function buildWorkbenchData(input: WorkbenchDataInput): {
+    data: WorkbenchData | undefined;
+    diagnostics: WorkbenchDiagnostic[];
+};
+/** Serialize a data file: two-space JSON with a final newline, so output is byte-stable. */
+export declare function serializeData(value: WorkbenchIndex | PageData): string;
+//# sourceMappingURL=build.d.ts.map

package/dist/data/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/data/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGhG,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,uBAAuB,CAAC;IAC3D,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvD;AAKD,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAsKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG;IAC7D,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAwFA;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,QAAQ,GAAG,MAAM,CAEtE"}

package/dist/data/build.js

@@ -0,0 +1,248 @@
+/**
+ * Build the Workbench data files from analyzer outputs, configuration, authored content, and the
+ * token inspection the foundations reference (workbench.md §2.1). Pure and deterministic: the same
+ * inputs give the same files, and no build time enters them.
+ */
+import { resolveWorkbenchConfig, } from '../config/index.js';
+import { DiagnosticList, isObject } from '../internal/diagnostics.js';
+import { buildPageRegistry } from '../pages/build.js';
+import { FOUNDATIONS } from '../pages/defaults.js';
+import { themeStudioPage } from './theme-studio.js';
+import { DATA_VERSION, INDEX_FORMAT, PAGE_FORMAT, } from './types.js';
+/** Top-level metadata fields that describe one package rather than a record of facts. */
+const PER_PACKAGE = new Set(['schema', 'oddkinVersion', 'library', 'diagnostics']);
+/** The data file of a page, relative to the index: `pages/components/odd-button.json`. */
+export function pageFile(id) {
+    return `pages/${id.split('/').map(encodeURIComponent).join('/')}.json`;
+}
+/**
+ * One metadata view over several packages. Records (components, examples, foundations, …) are
+ * merged by id; the same id with different content in two packages keeps the first and is
+ * diagnosed. A prefix shared by every package is kept for page titles.
+ */
+function mergeMetadata(libraries, out) {
+    const merged = {};
+    const owner = new Map();
+    const prefixes = new Set();
+    for (const library of libraries) {
+        const metadata = library.metadata;
+        if (!metadata)
+            continue;
+        const prefix = metadata['library']?.prefix;
+        if (typeof prefix === 'string' && prefix)
+            prefixes.add(prefix);
+        for (const [field, value] of Object.entries(metadata)) {
+            if (PER_PACKAGE.has(field) || !isObject(value))
+                continue;
+            const target = (merged[field] ??= {});
+            for (const [id, entry] of Object.entries(value)) {
+                if (!(id in target)) {
+                    target[id] = entry;
+                    owner.set(`${field}/${id}`, library.name);
+                }
+                else if (JSON.stringify(target[id]) !== JSON.stringify(entry)) {
+                    out.warn('data.metadata.conflict', `${library.name} and ${owner.get(`${field}/${id}`)} both describe ${field} "${id}" differently; the first is used.`, `/${field}/${id}`);
+                }
+            }
+        }
+    }
+    return {
+        ...merged,
+        ...(prefixes.size === 1 ? { library: { prefix: [...prefixes][0] } } : {}),
+    };
+}
+/** Custom-element declarations by tag; the first package that declares a tag wins, as in the registry. */
+function declarations(libraries) {
+    const found = new Map();
+    for (const library of libraries) {
+        for (const module of library.cem?.modules ?? []) {
+            for (const declaration of module.declarations ?? []) {
+                if (!declaration.customElement || !declaration.tagName || found.has(declaration.tagName))
+                    continue;
+                found.set(declaration.tagName, { declaration, module: module.path, package: library.name });
+            }
+        }
+    }
+    return found;
+}
+const tokenName = (id) => id.replace(/^token:/, '');
+/** Authored content by page id, with renamed ids resolved through `aliases`. */
+function authoredPages(docs) {
+    const byId = new Map();
+    for (const [key, content] of Object.entries(docs?.pages ?? {}))
+        byId.set(docs?.aliases?.[key] ?? key, content);
+    return byId;
+}
+function componentPage(page, declared, metadata, definitions, inspection, content) {
+    const tag = declared.declaration.tagName;
+    const enrichment = Object.values(metadata.components ?? {}).find((c) => c.tag === tag);
+    const authored = definitions.get(tag) ?? {};
+    const listed = Object.entries(metadata.examples ?? {}).filter(([, example]) => example.component === `component:${tag}`);
+    const named = new Set(listed.map(([, example]) => example.name));
+    const examples = [
+        ...listed.map(([id, example]) => {
+            const definition = authored[example.name];
+            return { id, ...example, ...(definition ? { definition } : {}) };
+        }),
+        // Examples the metadata does not list yet (no analyzer run since they were authored).
+        ...Object.entries(authored)
+            .filter(([name]) => !named.has(name))
+            .map(([name, definition]) => ({
+            id: `example:${tag}/${name}`,
+            component: `component:${tag}`,
+            name,
+            definition,
+        })),
+    ];
+    const reads = enrichment?.tokenReads ?? [];
+    const seen = new Set();
+    const tokens = reads.flatMap((read) => {
+        const name = isObject(read) && typeof read['token'] === 'string' ? read['token'] : undefined;
+        if (!name || seen.has(name))
+            return [];
+        seen.add(name);
+        return [inspection?.get(name) ?? { name, missing: true }];
+    });
+    const guidance = content?.sections?.['guidance']?.guidance?.trim();
+    const prose = {
+        ...(content?.useFor?.length ? { useFor: content.useFor } : {}),
+        ...(content?.notFor?.length ? { notFor: content.notFor } : {}),
+        ...(guidance ? { guidance } : {}),
+    };
+    return {
+        format: PAGE_FORMAT,
+        version: DATA_VERSION,
+        id: page.id,
+        kind: 'component',
+        tag,
+        package: declared.package,
+        module: declared.module,
+        declaration: declared.declaration,
+        ...(enrichment ? { enrichment: enrichment } : {}),
+        examples,
+        ...(tokens.length ? { tokens } : {}),
+        ...(Object.keys(prose).length ? { authored: prose } : {}),
+    };
+}
+function foundationPage(page, foundation, inspection, out) {
+    const listed = Array.isArray(foundation['tokens']) ? foundation['tokens'] : [];
+    const tokens = listed
+        .filter((id) => typeof id === 'string')
+        .map((id) => {
+        const name = tokenName(id);
+        const token = inspection?.get(name);
+        if (token)
+            return token;
+        // Without an inspection, one diagnostic covers every page (see buildWorkbenchData).
+        if (inspection) {
+            out.warn('data.token.missing', `${page.id} lists token "${name}", which the token inspection does not contain; its value is shown as unknown.`, `/pages/${page.id}/tokens/${name}`);
+        }
+        return { name, missing: true };
+    });
+    return {
+        format: PAGE_FORMAT,
+        version: DATA_VERSION,
+        id: page.id,
+        kind: 'foundation',
+        foundation,
+        tokens,
+    };
+}
+/**
+ * Build the index and the visible pages' data. `data` is undefined only when the configuration
+ * is invalid; every other problem is a diagnostic and leaves the affected value unknown.
+ */
+export function buildWorkbenchData(input) {
+    const out = new DiagnosticList();
+    const loading = input.diagnostics ?? [];
+    const { config, diagnostics: configDiagnostics } = resolveWorkbenchConfig(input.config);
+    if (!config)
+        return { data: undefined, diagnostics: [...loading, ...configDiagnostics] };
+    const metadata = mergeMetadata(input.libraries, out);
+    const { registry, diagnostics: registryDiagnostics } = buildPageRegistry({
+        config,
+        cem: input.libraries.flatMap((library) => (library.cem ? [library.cem] : [])),
+        metadata,
+        ...(input.docs ? { docs: input.docs } : {}),
+    });
+    // The registry resolves the same configuration again; its diagnostics include the config's.
+    out.items.unshift(...loading, ...registryDiagnostics);
+    if (!registry)
+        return { data: undefined, diagnostics: out.items };
+    const declared = declarations(input.libraries);
+    const inspection = input.tokens
+        ? new Map(input.tokens.tokens.map((token) => [token.name, token]))
+        : undefined;
+    if (!inspection && Object.keys(metadata.foundations ?? {}).length > 0) {
+        out.warn('data.tokens.missing', 'Foundations reference tokens, but no token inspection was supplied; their values are shown as unknown.', '/foundations');
+    }
+    const pages = {};
+    const files = {};
+    const authored = authoredPages(input.docs);
+    const definitions = new Map();
+    for (const library of input.libraries)
+        for (const set of library.examples ?? []) {
+            const tag = set.component.replace(/^component:/, '');
+            if (!definitions.has(tag))
+                definitions.set(tag, set.examples);
+        }
+    for (const page of registry.pages) {
+        if (!page.visible)
+            continue;
+        let data;
+        if (page.kind === 'component') {
+            const entry = declared.get(page.id.slice('components/'.length));
+            if (!entry)
+                continue;
+            data = componentPage(page, entry, metadata, definitions, inspection, authored.get(page.id));
+        }
+        else if (page.kind === 'foundation') {
+            const id = FOUNDATIONS.find((f) => `foundations/${f.slug}` === page.id)?.id;
+            const foundation = id ? metadata.foundations?.[`foundation:${id}`] : undefined;
+            if (!foundation)
+                continue;
+            data = foundationPage(page, foundation, inspection, out);
+        }
+        else if (page.id === 'theme-studio') {
+            continue;
+        }
+        else {
+            data = { format: PAGE_FORMAT, version: DATA_VERSION, id: page.id, kind: page.kind };
+        }
+        pages[page.id] = data;
+        files[page.id] = pageFile(page.id);
+    }
+    const studio = registry.pages.find((page) => page.visible && page.id === 'theme-studio');
+    if (studio) {
+        const components = Object.values(pages).filter((page) => page.kind === 'component');
+        pages[studio.id] = themeStudioPage(studio.id, components, config, input.theme ?? {}, out);
+        files[studio.id] = pageFile(studio.id);
+    }
+    const first = input.libraries[0];
+    const index = {
+        format: INDEX_FORMAT,
+        version: DATA_VERSION,
+        branding: {
+            name: config.branding.name ?? first?.name ?? 'Workbench',
+            ...(config.branding.logo ? { logo: config.branding.logo } : {}),
+            links: config.branding.links ?? [],
+        },
+        libraries: input.libraries.map((library) => {
+            const prefix = library.metadata?.library?.prefix;
+            return {
+                name: library.name,
+                version: library.version,
+                ...(typeof prefix === 'string' && prefix ? { prefix } : {}),
+            };
+        }),
+        registry,
+        pages: files,
+        diagnostics: out.items,
+    };
+    return { data: { index, pages }, diagnostics: out.items };
+}
+/** Serialize a data file: two-space JSON with a final newline, so output is byte-stable. */
+export function serializeData(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+//# sourceMappingURL=build.js.map

package/dist/data/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/data/build.ts"],"names":[],"mappings":"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"}

package/dist/data/import-map.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Import maps from package `exports` (workbench.md §2.1): the shell and each preview frame load
+ * published package files as they are, without a bundler, and resolve bare specifiers through an
+ * import map generated from the packages in their module graph.
+ */
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+/** The `package.json` fields that decide how a package's modules are addressed. */
+export interface PackageManifest {
+    readonly name: string;
+    readonly version?: string;
+    readonly exports?: unknown;
+    readonly main?: string;
+    readonly module?: string;
+}
+export interface ImportMapOptions {
+    /** URL prefix under which every package root is served, as `${base}${name}/`. Ends with `/`. */
+    readonly base: string;
+    /**
+     * Serve each package root as `${base}${name}@${version}/`, so documents that load different
+     * copies of one package never share a URL. Default false.
+     */
+    readonly versioned?: boolean;
+    /**
+     * Active export conditions. Within each conditions object, keys keep their declared priority
+     * (as in Node); `default` always applies. Default: development, browser, import.
+     */
+    readonly conditions?: readonly string[];
+}
+/** The URL prefix of a package root under `base`. */
+export declare function packageRoot(pkg: PackageManifest, options: Pick<ImportMapOptions, 'base' | 'versioned'>): string;
+export interface ImportMap {
+    readonly imports: Readonly<Record<string, string>>;
+}
+/** Development first, so previews and the shell keep their diagnostics. */
+export declare const DEFAULT_CONDITIONS: readonly ['development', 'browser', 'import'];
+/** Resolve one export target: a path, `null` (excluded), or `undefined` (no condition applies). */
+export declare function resolveTarget(target: unknown, conditions: ReadonlySet<string>): string | null | undefined;
+/**
+ * The package-relative file (`./dist/x.js`) that an export subpath (`.` or `./x`) resolves to,
+ * as Node resolves it: exact keys first, then the pattern with the longest prefix. Without
+ * `exports`, every file is reachable and `.` is `module`, `main`, or `./index.js`.
+ */
+export declare function resolveExport(pkg: PackageManifest, subpath: string, conditions?: readonly string[]): string | undefined;
+/**
+ * The import map for `packages`, in the order given: a package name seen again (another copy of
+ * the same package) is skipped with a diagnostic, since one document can load one copy per
+ * specifier. Subpath patterns become prefix mappings when the prefix mapping is exact.
+ */
+export declare function createImportMap(packages: readonly PackageManifest[], options: ImportMapOptions): {
+    importMap: ImportMap;
+    diagnostics: WorkbenchDiagnostic[];
+};
+//# sourceMappingURL=import-map.d.ts.map

package/dist/data/import-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-map.d.ts","sourceRoot":"","sources":["../../src/data/import-map.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEhG,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,CAAC,GACpD,MAAM,CAIR;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,YAAI,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEhF,mGAAmG;AACnG,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,MAAM,GAAG,IAAI,GAAG,SAAS,CAkB3B;AAiCD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,SAAS,MAAM,EAAuB,GACjD,MAAM,GAAG,SAAS,CA2BpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,OAAO,EAAE,gBAAgB,GACxB;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAmE9D"}