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

package/dist/data/import-map.js

@@ -0,0 +1,160 @@
+/**
+ * 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 { DiagnosticList, isObject } from '../internal/diagnostics.js';
+/** The URL prefix of a package root under `base`. */
+export function packageRoot(pkg, options) {
+    return options.versioned
+        ? `${options.base}${pkg.name}@${pkg.version ?? '0.0.0'}/`
+        : `${options.base}${pkg.name}/`;
+}
+/** Development first, so previews and the shell keep their diagnostics. */
+export const DEFAULT_CONDITIONS = ['development', 'browser', 'import'];
+/** Resolve one export target: a path, `null` (excluded), or `undefined` (no condition applies). */
+export function resolveTarget(target, conditions) {
+    if (typeof target === 'string')
+        return target;
+    if (target === null)
+        return null;
+    if (Array.isArray(target)) {
+        for (const item of target) {
+            const resolved = resolveTarget(item, conditions);
+            if (resolved !== undefined)
+                return resolved;
+        }
+        return undefined;
+    }
+    if (isObject(target)) {
+        for (const [condition, value] of Object.entries(target)) {
+            if (condition !== 'default' && !conditions.has(condition))
+                continue;
+            const resolved = resolveTarget(value, conditions);
+            if (resolved !== undefined)
+                return resolved;
+        }
+    }
+    return undefined;
+}
+/** `exports` as a subpath map, or `undefined` when the package declares none. */
+function subpaths(pkg, out) {
+    const { exports } = pkg;
+    if (exports === undefined)
+        return undefined;
+    if (typeof exports === 'string' || Array.isArray(exports) || exports === null)
+        return { '.': exports };
+    if (!isObject(exports)) {
+        out.warn('data.importMap.exports', `${pkg.name}: "exports" is not a string, array, or object.`, `/${pkg.name}/exports`);
+        return {};
+    }
+    const keys = Object.keys(exports);
+    const relative = keys.filter((key) => key.startsWith('.'));
+    if (relative.length === 0)
+        return { '.': exports };
+    if (relative.length !== keys.length) {
+        out.warn('data.importMap.exports', `${pkg.name}: "exports" mixes subpaths and conditions; Node rejects it, so it is skipped.`, `/${pkg.name}/exports`);
+        return {};
+    }
+    return exports;
+}
+/**
+ * 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 function resolveExport(pkg, subpath, conditions = DEFAULT_CONDITIONS) {
+    const map = subpaths(pkg, new DiagnosticList());
+    if (map === undefined) {
+        if (subpath !== '.')
+            return subpath;
+        const main = pkg.module ?? pkg.main ?? './index.js';
+        return main.startsWith('./') ? main : `./${main}`;
+    }
+    const active = new Set(conditions);
+    const relative = (target) => typeof target === 'string' && target.startsWith('./') ? target : undefined;
+    if (Object.hasOwn(map, subpath))
+        return relative(resolveTarget(map[subpath], active));
+    let best;
+    for (const key of Object.keys(map)) {
+        const star = key.indexOf('*');
+        if (star === -1)
+            continue;
+        const prefix = key.slice(0, star);
+        const suffix = key.slice(star + 1);
+        const matches = subpath.length >= prefix.length + suffix.length &&
+            subpath.startsWith(prefix) &&
+            subpath.endsWith(suffix);
+        if (matches && (!best || prefix.length > best.prefix.length))
+            best = { key, prefix, suffix };
+    }
+    if (!best)
+        return undefined;
+    const target = relative(resolveTarget(map[best.key], active));
+    const match = subpath.slice(best.prefix.length, subpath.length - best.suffix.length);
+    return target?.replaceAll('*', match);
+}
+/**
+ * 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 function createImportMap(packages, options) {
+    if (!options.base.endsWith('/'))
+        throw new TypeError(`createImportMap: base "${options.base}" must end with "/".`);
+    const out = new DiagnosticList();
+    const conditions = new Set(options.conditions ?? DEFAULT_CONDITIONS);
+    const imports = {};
+    const seen = new Map();
+    for (const pkg of packages) {
+        if (seen.has(pkg.name)) {
+            const first = seen.get(pkg.name);
+            if (first !== pkg.version) {
+                out.warn('data.importMap.duplicate', `${pkg.name} is in the module graph as ${first ?? 'an unversioned copy'} and ${pkg.version ?? 'an unversioned copy'}; the document loads ${first ?? 'the first'} only.`, `/${pkg.name}`);
+            }
+            continue;
+        }
+        seen.set(pkg.name, pkg.version);
+        const root = packageRoot(pkg, options);
+        const map = subpaths(pkg, out);
+        if (map === undefined) {
+            const main = pkg.module ?? pkg.main;
+            if (main)
+                imports[pkg.name] = root + main.replace(/^\.\//, '');
+            imports[`${pkg.name}/`] = root;
+            continue;
+        }
+        for (const [key, target] of Object.entries(map)) {
+            if (key === './package.json')
+                continue;
+            const resolved = resolveTarget(target, conditions);
+            if (typeof resolved !== 'string')
+                continue;
+            if (!resolved.startsWith('./')) {
+                out.warn('data.importMap.target', `${pkg.name}: export "${key}" points at "${resolved}", which is not a relative path; skipped.`, `/${pkg.name}/exports/${key}`);
+                continue;
+            }
+            const star = key.indexOf('*');
+            if (star === -1) {
+                imports[key === '.' ? pkg.name : `${pkg.name}/${key.slice(2)}`] = root + resolved.slice(2);
+                continue;
+            }
+            const keyPrefix = key.slice(0, star);
+            const targetStar = resolved.indexOf('*');
+            const targetPrefix = resolved.slice(0, targetStar);
+            if (targetStar === -1 ||
+                !keyPrefix.endsWith('/') ||
+                !targetPrefix.endsWith('/') ||
+                key.slice(star + 1) !== resolved.slice(targetStar + 1)) {
+                out.warn('data.importMap.pattern', `${pkg.name}: export pattern "${key}" → "${resolved}" has no exact import-map prefix; skipped.`, `/${pkg.name}/exports/${key}`);
+                continue;
+            }
+            imports[`${pkg.name}/${keyPrefix.slice(2)}`] = root + targetPrefix.slice(2);
+        }
+    }
+    const sorted = {};
+    for (const key of Object.keys(imports).sort())
+        sorted[key] = imports[key];
+    return { importMap: { imports: sorted }, diagnostics: out.items };
+}
+//# sourceMappingURL=import-map.js.map

package/dist/data/import-map.js.map

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

package/dist/data/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@oddkin/workbench/data` — the Workbench index and per-page data files built from analyzer
+ * outputs, configuration, authored content, and token inspection, plus import maps from package
+ * `exports` (workbench.md §2.1). DOM-free; the Node tooling writes these files and the shell
+ * reads them.
+ */
+export { buildWorkbenchData, pageFile, serializeData } from './build.js';
+export type { WorkbenchDataInput } from './build.js';
+export { createImportMap, DEFAULT_CONDITIONS, packageRoot, resolveExport, resolveTarget, } from './import-map.js';
+export type { ImportMap, ImportMapOptions, PackageManifest } from './import-map.js';
+export { DATA_VERSION, INDEX_FORMAT, PAGE_FORMAT } from './types.js';
+export type { BasicPageData, ComponentPageData, ExampleSetLike, FoundationPageData, InspectedTokenLike, JsonObject, LibraryInput, PageData, TokenInspectionLike, WorkbenchBranding, WorkbenchData, WorkbenchIndex, } from './types.js';
+export type { WorkbenchDiagnostic } from '../internal/diagnostics.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/data/index.js

@@ -0,0 +1,10 @@
+/**
+ * `@oddkin/workbench/data` — the Workbench index and per-page data files built from analyzer
+ * outputs, configuration, authored content, and token inspection, plus import maps from package
+ * `exports` (workbench.md §2.1). DOM-free; the Node tooling writes these files and the shell
+ * reads them.
+ */
+export { buildWorkbenchData, pageFile, serializeData } from './build.js';
+export { createImportMap, DEFAULT_CONDITIONS, packageRoot, resolveExport, resolveTarget, } from './import-map.js';
+export { DATA_VERSION, INDEX_FORMAT, PAGE_FORMAT } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/data/theme-studio.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Theme Studio's page data (workbench.md §6): the baseline theme configuration, the generation
+ * worker, and the specimen roles, each mapped to a documented component through an example that
+ * claims the role (`previewRoles`) or through `themeStudio.preview.roles`; never by tag name alone.
+ */
+import type { ResolvedWorkbenchConfig } from '../config/index.js';
+import type { DiagnosticList } from '../internal/diagnostics.js';
+import { type ComponentPageData, type JsonObject, type ThemeStudioPageData } from './types.js';
+/** The default `theme-specimen` recipe's roles, in display order, with their captions. */
+export declare const SPECIMEN_ROLES: Readonly<Record<string, string>>;
+/** What dev tooling loaded for Theme Studio. */
+export interface ThemeStudioInput {
+    /** The baseline configuration's JSON model (`loadConfig`). */
+    readonly config?: JsonObject;
+    /** Where it came from, as written in the Workbench configuration. */
+    readonly source?: string;
+    /** URL of the generation worker module. */
+    readonly worker?: string;
+}
+export declare function themeStudioPage(id: string, components: readonly ComponentPageData[], config: ResolvedWorkbenchConfig, input: ThemeStudioInput, out: DiagnosticList): ThemeStudioPageData;
+//# sourceMappingURL=theme-studio.d.ts.map

package/dist/data/theme-studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-studio.d.ts","sourceRoot":"","sources":["../../src/data/theme-studio.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAEf,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,0FAA0F;AAC1F,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY3D,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,MAAM,EAAE,uBAAuB,EAC/B,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,cAAc,GAClB,mBAAmB,CA0GrB"}

package/dist/data/theme-studio.js

@@ -0,0 +1,116 @@
+import { presets } from '../panels/model.js';
+import { DATA_VERSION, PAGE_FORMAT, } from './types.js';
+/** The default `theme-specimen` recipe's roles, in display order, with their captions. */
+export const SPECIMEN_ROLES = {
+    surface: 'Surface',
+    heading: 'Heading',
+    bodyText: 'Body text',
+    link: 'Link',
+    badge: 'Badge',
+    textInput: 'Text input',
+    checkbox: 'Checkbox',
+    switch: 'Switch',
+    primaryAction: 'Primary action',
+    secondaryAction: 'Secondary action',
+    navigation: 'Navigation',
+};
+const roleId = (value) => value.replace(/^role:/, '');
+export function themeStudioPage(id, components, config, input, out) {
+    const registration = (page) => {
+        const value = page.enrichment?.['registration'];
+        return typeof value === 'string' ? value : undefined;
+    };
+    const role = (name, page, exampleName, source) => {
+        const entry = registration(page);
+        const all = presets(page);
+        const example = exampleName
+            ? all.find((p) => p.name === exampleName)
+            : (all.find((p) => p.name === 'default') ?? all.find((p) => p.state && !p.incorrect));
+        if (!entry || !example?.state)
+            return undefined;
+        return {
+            role: name,
+            label: SPECIMEN_ROLES[name] ?? name,
+            tag: page.tag,
+            registration: entry,
+            example: example.id,
+            properties: example.state.properties,
+            attributes: example.state.attributes,
+            slots: example.state.slots,
+            source,
+        };
+    };
+    // Roles claimed by examples; a role claimed by two components stays unmapped.
+    const claims = new Map();
+    for (const page of components)
+        for (const example of page.examples) {
+            const roles = example['previewRoles'];
+            const name = example['name'];
+            if (!Array.isArray(roles) || typeof name !== 'string')
+                continue;
+            for (const r of roles)
+                if (typeof r === 'string')
+                    claims.set(roleId(r), [...(claims.get(roleId(r)) ?? []), { page, example: name }]);
+        }
+    const missing = [];
+    const byTag = new Map(components.map((page) => [page.tag, page]));
+    const mapped = new Map();
+    for (const [name, target] of Object.entries(config.themeStudio.preview.roles ?? {})) {
+        const tag = typeof target === 'string' ? target : target.component;
+        const page = byTag.get(tag);
+        const resolved = page && role(name, page, typeof target === 'string' ? undefined : target.example, 'config');
+        if (resolved)
+            mapped.set(name, resolved);
+        else
+            out.warn('data.themeStudio.role', `themeStudio.preview.roles.${name}: <${tag}> is not a documented component with a registration entry and that example.`, `/themeStudio/preview/roles/${name}`);
+    }
+    for (const [name, claimants] of claims) {
+        if (mapped.has(name))
+            continue;
+        const tags = [...new Set(claimants.map((c) => c.page.tag))];
+        const only = claimants[0];
+        if (tags.length === 1 && claimants.length === 1 && only) {
+            const resolved = role(name, only.page, only.example, 'example');
+            if (resolved)
+                mapped.set(name, resolved);
+        }
+        else
+            missing.push({
+                item: `role:${name}`,
+                supply: `themeStudio.preview.roles.${name} (claimed by ${claimants.map((c) => `${c.page.tag}/${c.example}`).join(', ')})`,
+            });
+    }
+    const order = Object.keys(SPECIMEN_ROLES);
+    const rank = (name) => (order.includes(name) ? order.indexOf(name) : order.length);
+    const roles = [...mapped.values()].sort((a, b) => rank(a.role) - rank(b.role) || a.role.localeCompare(b.role));
+    for (const name of order)
+        if (!mapped.has(name) && !claims.has(name))
+            missing.push({
+                item: `role:${name}`,
+                supply: `an example with previewRoles: ['${name}'], or themeStudio.preview.roles.${name}`,
+            });
+    if (!input.config)
+        missing.unshift({
+            item: 'config',
+            supply: 'themeStudio.themeConfig (a theme configuration file)',
+        });
+    if (!input.worker)
+        missing.unshift({
+            item: 'generator',
+            supply: 'a documented package that depends on @oddkin/tokens (its ./generate export)',
+        });
+    return {
+        format: PAGE_FORMAT,
+        version: DATA_VERSION,
+        id,
+        kind: 'tool',
+        studio: {
+            ...(input.config ? { config: input.config } : {}),
+            ...(input.source ? { source: input.source } : {}),
+            ...(input.worker ? { worker: input.worker } : {}),
+            roles,
+            missing,
+        },
+    };
+}
+//# sourceMappingURL=theme-studio.js.map

package/dist/data/theme-studio.js.map

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

package/dist/data/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Workbench data files (workbench.md §2.1): a small index the shell loads first, and one data
+ * file per page that its route loads lazily. Internal formats shared by the Node tooling and the
+ * browser shell of the same Workbench version; `version` changes when a shape changes.
+ */
+import type { WorkbenchDiagnostic } from '../internal/diagnostics.js';
+import type { JsonValue } from '../protocol/index.js';
+import type { CemPackage, OddkinMetadataLike, PageKind, PageRegistry } from '../pages/types.js';
+export declare const INDEX_FORMAT = "oddkin.workbench-index";
+export declare const PAGE_FORMAT = "oddkin.workbench-page";
+export declare const DATA_VERSION = 1;
+/** A JSON object as read from a published file. */
+export type JsonObject = {
+    readonly [key: string]: unknown;
+};
+/** One documented package and its published outputs. */
+export interface LibraryInput {
+    readonly name: string;
+    readonly version: string;
+    /** Its standard Custom Elements Manifest (`customElements`). */
+    readonly cem?: CemPackage;
+    /** Its `oddkin.metadata.json`, when the package publishes Oddkin enrichment. */
+    readonly metadata?: OddkinMetadataLike;
+    /** Authored example sets as data (`toExamplesJSON()` of each `defineExamples` module). */
+    readonly examples?: readonly ExampleSetLike[];
+}
+/** One component's examples as plain data (`@oddkin/workbench/examples` `ExamplesJSON`). */
+export interface ExampleSetLike {
+    readonly component: string;
+    readonly examples: Readonly<Record<string, JsonObject>>;
+}
+/** A token as published by a token inspection (`@oddkin/tokens/inspect/*.json`). */
+export interface InspectedTokenLike {
+    readonly name: string;
+    readonly cssVariable?: string;
+    readonly category?: string;
+    readonly type?: string;
+    readonly origin?: string;
+    readonly definition?: unknown;
+    readonly value?: unknown;
+    readonly description?: string;
+}
+export interface TokenInspectionLike {
+    readonly theme?: string;
+    readonly tokens: readonly InspectedTokenLike[];
+}
+export interface WorkbenchBranding {
+    readonly name: string;
+    readonly logo?: string;
+    readonly links: readonly {
+        readonly label: string;
+        readonly href: string;
+    }[];
+}
+export interface WorkbenchIndex {
+    readonly format: typeof INDEX_FORMAT;
+    readonly version: typeof DATA_VERSION;
+    readonly branding: WorkbenchBranding;
+    /** The documented packages, in configuration order. */
+    readonly libraries: readonly {
+        readonly name: string;
+        readonly version: string;
+        readonly prefix?: string;
+    }[];
+    readonly registry: PageRegistry;
+    /** Page id → its data file, relative to the index. Visible pages only. */
+    readonly pages: Readonly<Record<string, string>>;
+    readonly diagnostics: readonly WorkbenchDiagnostic[];
+}
+interface PageDataBase {
+    readonly format: typeof PAGE_FORMAT;
+    readonly version: typeof DATA_VERSION;
+    readonly id: string;
+}
+/** A component page: its published facts, verbatim, for the detail panels to present. */
+export interface ComponentPageData extends PageDataBase {
+    readonly kind: 'component';
+    readonly tag: string;
+    /** The package whose manifest declares the element. */
+    readonly package: string;
+    /** The CEM module that declares it. */
+    readonly module: string;
+    /** The CEM declaration, verbatim. */
+    readonly declaration: JsonObject;
+    /** The Oddkin enrichment entry, verbatim, when published. */
+    readonly enrichment?: JsonObject;
+    /**
+     * Authored examples for the element (metadata `examples`), verbatim, with their ids. When the
+     * example set was loaded, `definition` holds its values (label, props, attributes, slots,
+     * preset, guidance, incorrect, `hasFixture`).
+     */
+    readonly examples: readonly JsonObject[];
+    /**
+     * The tokens the component reads (`tokenReads`), resolved from the token inspection in their
+     * order. A token missing from the inspection keeps only its name (`missing: true`).
+     */
+    readonly tokens?: readonly (InspectedTokenLike & {
+        readonly missing?: true;
+    })[];
+    /**
+     * Authored content for the page (`oddkin.docs.ts`): intended use and section guidance. Absent
+     * when nothing is authored.
+     */
+    readonly authored?: {
+        readonly useFor?: readonly string[];
+        readonly notFor?: readonly string[];
+        readonly guidance?: string;
+    };
+}
+/** A foundation page: its metadata and the referenced tokens from the token inspection. */
+export interface FoundationPageData extends PageDataBase {
+    readonly kind: 'foundation';
+    /** The foundation's metadata entry, verbatim. */
+    readonly foundation: JsonObject;
+    /**
+     * The tokens the foundation lists, in its order. A token missing from the inspection keeps
+     * only its name (`missing: true`); its value is never guessed.
+     */
+    readonly tokens: readonly (InspectedTokenLike & {
+        readonly missing?: true;
+    })[];
+}
+/** Overview, tool, products, and home pages: their content comes from the index for now. */
+export interface BasicPageData extends PageDataBase {
+    readonly kind: Exclude<PageKind, 'component' | 'foundation'>;
+}
+/** A specimen role played by a documented component in one of its examples. */
+export interface SpecimenRole {
+    readonly role: string;
+    /** Visible caption. */
+    readonly label: string;
+    readonly tag: string;
+    /** The component's published registration entry. */
+    readonly registration: string;
+    /** The example whose values the specimen uses. */
+    readonly example: `example:${string}/${string}`;
+    readonly properties: Readonly<Record<string, JsonValue>>;
+    readonly attributes: Readonly<Record<string, string>>;
+    readonly slots: Readonly<Record<string, string>>;
+    /** Mapped by `themeStudio.preview.roles` or claimed by the example (`previewRoles`). */
+    readonly source: 'config' | 'example';
+}
+/** Theme Studio (workbench.md ?6): the baseline configuration, its generator, and specimens. */
+export interface ThemeStudioPageData extends PageDataBase {
+    readonly kind: 'tool';
+    readonly studio: {
+        /** The baseline theme configuration's JSON model. */
+        readonly config?: JsonObject;
+        /** The configuration file, as `themeStudio.themeConfig` names it. */
+        readonly source?: string;
+        /** URL of the generation worker (the library's own `@oddkin/tokens/generate`). */
+        readonly worker?: string;
+        readonly roles: readonly SpecimenRole[];
+        /** Absent inputs, each with what supplies it; shown on the page, never guessed. */
+        readonly missing: readonly {
+            readonly item: string;
+            readonly supply: string;
+        }[];
+    };
+}
+export type PageData = ComponentPageData | FoundationPageData | ThemeStudioPageData | BasicPageData;
+export interface WorkbenchData {
+    readonly index: WorkbenchIndex;
+    /** Page id → data, for every entry of `index.pages`. */
+    readonly pages: Readonly<Record<string, PageData>>;
+}
+/** Re-exported for callers that build the registry input themselves. */
+export type { CemPackage, OddkinMetadataLike };
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/data/types.js

@@ -0,0 +1,4 @@
+export const INDEX_FORMAT = 'oddkin.workbench-index';
+export const PAGE_FORMAT = 'oddkin.workbench-page';
+export const DATA_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/data/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,YAAY,GAAG,wBAAwB,CAAC;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC"}