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

package/dist/node/static.js

@@ -0,0 +1,157 @@
+/**
+ * `oddkin workbench build`: the dev server's URL layout written as files for a static host
+ * (workbench.md §2.1, §10). The output directory maps to `hosting.basePath`: the shell at its
+ * root, data and the frame document under `_oddkin/`, and each package's published browser files
+ * under `_oddkin/m/<name>@<version>/`, copied as published. In history mode every page path, and
+ * every legacy path, gets a copy of the shell, so deep links and refreshes load on any static
+ * host; `404.html` is the shell too, for hosts that serve it for unknown paths. Legacy paths
+ * redirect in the app, which keeps their query (`/playground?component=…`). Hash mode writes
+ * the shell once. No Node or analyzer backend is needed to serve the result.
+ */
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DiagnosticList } from '../internal/diagnostics.js';
+import { writeGenerated } from './generated.js';
+import { readPackage } from './packages.js';
+import { ASSET_DIR, buildWorkbench } from './workbench.js';
+/**
+ * Package files a browser loads. Type declarations, sources, and documents stay behind, and so
+ * do source maps: only developer tools read them, and they name sources packages do not publish.
+ */
+const BROWSER_FILE = /\.(m?js|css|json|svg|png|jpe?g|gif|webp|avif|ico|woff2?|ttf|otf)$/i;
+const GLOB = /[*?[\]{}!]/;
+/** Regular files below `dir` as sorted POSIX paths; links, `node_modules`, and dot entries skipped. */
+async function walk(dir, prefix = '') {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    for (const entry of entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))) {
+        if (entry.name.startsWith('.') || entry.name === 'node_modules')
+            continue;
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory())
+            files.push(...(await walk(join(dir, entry.name), rel)));
+        else if (entry.isFile())
+            files.push(rel);
+    }
+    return files;
+}
+/**
+ * A package's published browser files: what its `files` field names (as npm packs it), or, for
+ * a package installed without one, everything in it.
+ */
+async function publishedFiles(dir, manifest, name, out) {
+    const field = manifest.files;
+    const listed = Array.isArray(field)
+        ? field.filter((f) => typeof f === 'string')
+        : undefined;
+    let files;
+    if (!listed || listed.some((entry) => GLOB.test(entry))) {
+        if (listed)
+            out.warn('node.build.filesPattern', `${name}: "files" uses patterns; every file in the package is considered.`, `/packages/${name}/files`);
+        files = await walk(dir);
+    }
+    else {
+        const all = await walk(dir);
+        const roots = listed.map((entry) => entry.replace(/^\.\//, '').replace(/\/+$/, ''));
+        files = all.filter((file) => file === 'package.json' ||
+            roots.some((root) => file === root || file.startsWith(`${root}/`)));
+    }
+    return files.filter((file) => BROWSER_FILE.test(file));
+}
+/** Every path the shell's router answers in history mode (app/routes.ts `shellRoutes`). */
+export function shellPaths(build) {
+    const registry = build.data?.index.registry;
+    if (!registry)
+        return [];
+    const paths = new Set();
+    for (const page of registry.pages) {
+        if (!page.visible)
+            continue;
+        paths.add(page.route);
+        for (const legacy of page.legacyRoutes ?? [])
+            paths.add(legacy);
+    }
+    if (!registry.pages.some((p) => p.id === 'products' && p.visible))
+        paths.add('/foundations/products');
+    return [...paths]
+        .map((path) => path.split('/').filter(Boolean).join('/'))
+        .filter(Boolean)
+        .sort();
+}
+/**
+ * The files below `_oddkin/` (relative to the base path): data, the frame document and import
+ * maps, Theme Studio's worker, and the packages' published browser files. A site that serves its
+ * own pages and embeds the panels (apps/docs) needs these and no shell.
+ */
+export async function embedFiles(build) {
+    const out = new DiagnosticList();
+    const files = new Map();
+    if (!build.config)
+        return { files, diagnostics: out.items };
+    for (const [path, content] of build.files)
+        files.set(`${ASSET_DIR}${path}`, content);
+    const packages = [...build.packages].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    for (const [versioned, dir] of packages) {
+        const name = versioned.slice(0, versioned.lastIndexOf('@'));
+        for (const file of await publishedFiles(dir, readPackage(dir).manifest, name, out))
+            files.set(`${ASSET_DIR}m/${versioned}/${file}`, { source: join(dir, ...file.split('/')) });
+    }
+    // Every browser file each document's import map names is in the output.
+    const base = build.config.hosting.basePath;
+    const prefix = `${base}${ASSET_DIR}`;
+    for (const name of ['shell.importmap.json', 'frame.importmap.json']) {
+        const map = JSON.parse(build.files.get(name) ?? '{"imports":{}}');
+        for (const [specifier, url] of Object.entries(map.imports)) {
+            if (!url.startsWith(prefix) || !BROWSER_FILE.test(url))
+                continue;
+            if (!files.has(url.slice(base.length)))
+                out.warn('node.build.unpublished', `"${specifier}" maps to ${url}, which is not among its package's published files; importing it fails.`, `/${name}/imports/${specifier}`);
+        }
+    }
+    return { files, diagnostics: out.items };
+}
+/**
+ * Build the Workbench and write it as a static app. Writes nothing when the configuration or
+ * metadata has errors. The output directory carries the generated-directory marker, so a later
+ * build replaces it and an unmarked directory is refused (`GeneratedDirectoryError`).
+ */
+export async function buildStatic(options = {}) {
+    const build = await buildWorkbench({
+        ...(options.config ? { config: options.config } : {}),
+        ...(options.hosting ? { hosting: options.hosting } : {}),
+    });
+    const out = new DiagnosticList();
+    out.items.push(...build.diagnostics);
+    const nothing = { build, out: undefined, files: [], written: [], removed: [] };
+    if (!build.config || !build.data || !build.shell || out.items.some((d) => d.severity === 'error'))
+        return { ...nothing, diagnostics: out.items };
+    const files = new Map();
+    files.set('index.html', build.shell);
+    if (build.config.hosting.routing === 'history') {
+        for (const path of shellPaths(build))
+            files.set(`${path}/index.html`, build.shell);
+        files.set('404.html', build.shell);
+    }
+    const embedded = await embedFiles(build);
+    for (const [path, content] of embedded.files)
+        files.set(path, content);
+    out.items.push(...embedded.diagnostics);
+    const target = options.out ?? join(build.root, '.oddkin', 'workbench-build');
+    const sorted = new Map([...files].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)));
+    const { written, removed } = await writeGenerated(target, sorted);
+    return {
+        build,
+        out: target,
+        files: [...sorted.keys()],
+        written,
+        removed,
+        diagnostics: out.items,
+    };
+}
+//# sourceMappingURL=static.js.map

package/dist/node/static.js.map

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

package/dist/node/workbench.d.ts

@@ -0,0 +1,43 @@
+import type { ResolvedWorkbenchConfig, Routing } from '../config/index.js';
+import { type ImportMap } from '../data/import-map.js';
+import type { WorkbenchData } from '../data/types.js';
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+import { type WorkbenchInputs } from './inputs.js';
+/** This package's root (two levels above `dist/node/` and `src/node/`). */
+export declare const WORKBENCH_DIR: string;
+/** Everything the Workbench serves besides the shell lives below `<base>_oddkin/`. */
+export declare const ASSET_DIR = "_oddkin/";
+export interface WorkbenchBuild {
+    readonly root: string;
+    readonly configFile: string | undefined;
+    readonly config: ResolvedWorkbenchConfig | undefined;
+    readonly data: WorkbenchData | undefined;
+    readonly inputs: WorkbenchInputs | undefined;
+    /** Generated files below `<base>_oddkin/` by relative path: index, page data, import maps. */
+    readonly files: ReadonlyMap<string, string>;
+    /** `name@version` → directory for every package the shell or a frame may load. */
+    readonly packages: ReadonlyMap<string, string>;
+    /** Import map of preview frames: the documented packages and their dependencies. */
+    readonly frameImportMap: ImportMap | undefined;
+    /** The shell page; undefined without a valid configuration. */
+    readonly shell: string | undefined;
+    readonly diagnostics: readonly WorkbenchDiagnostic[];
+}
+export interface BuildOptions {
+    /** A configuration file or the directory holding it. Default: the working directory. */
+    readonly config?: string;
+    /** Point the shell at the live-update stream (dev server). */
+    readonly events?: boolean;
+    /** Replaces the configuration's `hosting` values. */
+    readonly hosting?: {
+        readonly basePath?: string;
+        readonly routing?: Routing;
+    };
+}
+/** Theme Studio's generation worker, next to the data files. */
+export declare const THEME_WORKER = "theme-studio.worker.js";
+/** Build everything the Workbench serves or writes for one configuration. Never throws for bad input. */
+export declare function buildWorkbench(options?: BuildOptions): Promise<WorkbenchBuild>;
+/** A diagnostic as one line: `error code /path: message`. */
+export declare function formatDiagnostic(d: WorkbenchDiagnostic): string;
+//# sourceMappingURL=workbench.d.ts.map

package/dist/node/workbench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench.d.ts","sourceRoot":"","sources":["../../src/node/workbench.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIhG,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAI/D,2EAA2E;AAC3E,eAAO,MAAM,aAAa,QAAoD,CAAC;AAG/E,sFAAsF;AACtF,eAAO,MAAM,SAAS,aAAa,CAAC;AAMpC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,oFAAoF;IACpF,QAAQ,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/C,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/E;AAID,gEAAgE;AAChE,eAAO,MAAM,YAAY,2BAA2B,CAAC;AAkFrD,yGAAyG;AACzG,wBAAsB,cAAc,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2HxF;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAE/D"}

package/dist/node/workbench.js

@@ -0,0 +1,204 @@
+/**
+ * One Workbench build from a configuration: the data files, the import maps of the shell and of
+ * preview frames, the packages they load, and the shell page (workbench.md §2.1). Used by
+ * `workbench dev` now and by `workbench build` (M7).
+ */
+import { fileURLToPath } from 'node:url';
+import { buildWorkbenchData, pageFile, serializeData } from '../data/build.js';
+import { createImportMap, packageRoot, resolveExport, } from '../data/import-map.js';
+import { DiagnosticList, isObject } from '../internal/diagnostics.js';
+import { loadWorkbenchConfig } from './config.js';
+import { exampleModule, registrationsByTag } from './example-modules.js';
+import { frameHtml, shellHtml } from './html.js';
+import { loadInputs } from './inputs.js';
+import { packageGraph, readPackage } from './packages.js';
+import { preloadGraph } from './preload.js';
+/** This package's root (two levels above `dist/node/` and `src/node/`). */
+export const WORKBENCH_DIR = fileURLToPath(new URL('../../', import.meta.url));
+/** Node-only dependencies of `@oddkin/workbench`: never part of the shell's module graph. */
+const NODE_ONLY = ['@oddkin/analyzer'];
+/** Everything the Workbench serves besides the shell lives below `<base>_oddkin/`. */
+export const ASSET_DIR = '_oddkin/';
+/** The shell's own stylesheet: the default theme's tokens. */
+const SHELL_STYLES = { package: '@oddkin/tokens', export: './css/default.css' };
+/** The shell page's arrangement classes (`.odd-cluster`, `.odd-grid`, ?; layout-recipes.md ?12). */
+const SHELL_LAYOUT = { package: '@oddkin/components', export: './css/layout.css' };
+const versioned = (pkg) => `${pkg.name}@${pkg.version}`;
+/** Theme Studio's generation worker, next to the data files. */
+export const THEME_WORKER = 'theme-studio.worker.js';
+/**
+ * Workers have no import map, so the generator is imported by URL (its graph has no bare
+ * specifiers). Requests are `{ id, draft }`; replies carry plain data only (theming ?8).
+ */
+const themeWorker = (generator) => `import { generate } from ${JSON.stringify(generator)};
+
+self.addEventListener('message', (event) => {
+  const { id, draft } = event.data;
+  const start = performance.now();
+  try {
+    const result = generate(draft);
+    self.postMessage({ id, ok: result.ok, css: result.css, diagnostics: result.diagnostics, ms: performance.now() - start });
+  } catch (error) {
+    self.postMessage({ id, ok: false, diagnostics: [{ severity: 'error', code: 'generate.failed', path: '', message: String(error) }], ms: performance.now() - start });
+  }
+});
+`;
+/** The manifest fields import maps read, under the name importers use. */
+const manifests = (graph) => graph.map((pkg) => ({ ...pkg.manifest, name: pkg.name, version: pkg.version }));
+const FONT = /\.(woff2?|ttf|otf)$/i;
+/**
+ * Preview-frame assets (`assets` in the configuration): package export specifiers such as
+ * `@oddkin/tokens/css/default.css`, resolved through the package's `exports` to its versioned
+ * URL. Stylesheets are linked and fonts preloaded. Without configured assets, frames load the
+ * default token stylesheet when the frame graph has it.
+ */
+function frameAssets(config, graph, documented, base, out) {
+    const stylesheets = [];
+    const fonts = [];
+    const specifiers = config.assets.length
+        ? config.assets
+        : documented.some((pkg) => pkg.name === SHELL_STYLES.package)
+            ? [`${SHELL_STYLES.package}${SHELL_STYLES.export.slice(1)}`]
+            : [];
+    config.assets.forEach((specifier, i) => {
+        if (/^(\.{0,2}\/|[a-z]+:)/i.test(specifier))
+            out.warn('node.assets.unsupported', `Asset "${specifier}" is a path or URL; frames load package export specifiers (for example "@scope/pkg/theme.css") for now.`, `/assets/${i}`);
+    });
+    for (const specifier of specifiers) {
+        if (/^(\.{0,2}\/|[a-z]+:)/i.test(specifier))
+            continue;
+        const parts = specifier.split('/');
+        const name = specifier.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0];
+        const subpath = `.${specifier.slice(name.length)}`;
+        const pkg = graph.find((p) => p.name === name);
+        const path = pkg ? resolveExport(pkg.manifest, subpath) : undefined;
+        const index = config.assets.indexOf(specifier);
+        if (!pkg || !path) {
+            out.warn('node.assets.unresolved', `Asset "${specifier}" does not resolve: ${pkg ? `${name} does not export "${subpath}"` : `${name} is not a documented package or one of their dependencies`}.`, index >= 0 ? `/assets/${index}` : '/assets');
+            continue;
+        }
+        const url = `${packageRoot({ ...pkg.manifest, name: pkg.name, version: pkg.version }, { base, versioned: true })}${path.slice(2)}`;
+        if (FONT.test(path))
+            fonts.push(url);
+        else if (/\.css$/i.test(path))
+            stylesheets.push(url);
+        else
+            out.warn('node.assets.kind', `Asset "${specifier}" is neither a stylesheet nor a font; frames load only those.`, index >= 0 ? `/assets/${index}` : '/assets');
+    }
+    return { stylesheets, fonts };
+}
+/** Build everything the Workbench serves or writes for one configuration. Never throws for bad input. */
+export async function buildWorkbench(options = {}) {
+    const loaded = await loadWorkbenchConfig(options.config, options.hosting);
+    const empty = {
+        root: loaded.root,
+        configFile: loaded.file,
+        data: undefined,
+        inputs: undefined,
+        files: new Map(),
+        packages: new Map(),
+        frameImportMap: undefined,
+        shell: undefined,
+    };
+    const config = loaded.config;
+    if (!config)
+        return { ...empty, config, diagnostics: loaded.diagnostics };
+    const out = new DiagnosticList();
+    const inputs = await loadInputs(loaded.root, config, out);
+    const base = `${config.hosting.basePath}${ASSET_DIR}m/`;
+    const self = readPackage(WORKBENCH_DIR, '@oddkin/workbench');
+    const graphs = new DiagnosticList();
+    const shellGraph = packageGraph([self], WORKBENCH_DIR, graphs, { skip: NODE_ONLY });
+    const shell = createImportMap(manifests(shellGraph), { base, versioned: true });
+    const frame = createImportMap(manifests([...inputs.graph, ...shellGraph]), {
+        base,
+        versioned: true,
+    });
+    // Theme Studio generates with the documented library's own generator, in a Worker.
+    const generator = frame.importMap.imports['@oddkin/tokens/generate'];
+    const worker = generator ? `${config.hosting.basePath}${ASSET_DIR}${THEME_WORKER}` : undefined;
+    const { data, diagnostics } = buildWorkbenchData({
+        config,
+        libraries: inputs.libraries,
+        ...(inputs.docs ? { docs: inputs.docs } : {}),
+        ...(inputs.tokens ? { tokens: inputs.tokens } : {}),
+        theme: { ...inputs.theme, ...(worker ? { worker } : {}) },
+        diagnostics: out.items,
+    });
+    const result = new DiagnosticList();
+    result.items.push(...diagnostics, ...graphs.items, ...shell.diagnostics, ...frame.diagnostics);
+    if (!data)
+        return { ...empty, config, inputs, diagnostics: result.items };
+    const packages = new Map();
+    for (const pkg of [...shellGraph, ...inputs.graph])
+        if (!packages.has(versioned(pkg)))
+            packages.set(versioned(pkg), pkg.dir);
+    const assets = `${config.hosting.basePath}${ASSET_DIR}`;
+    const roots = new Map([...packages].map(([name, dir]) => [`${base}${name}/`, dir]));
+    const files = new Map([['index.json', serializeData(data.index)]]);
+    // Frames run an example's fixture from its example module, which ships beside the page data.
+    const registrations = registrationsByTag(inputs.libraries);
+    const pages = { ...data.pages };
+    for (const [id, page] of Object.entries(pages)) {
+        const file = page.kind === 'component' ? inputs.exampleFiles.get(page.tag) : undefined;
+        if (page.kind !== 'component' ||
+            !file ||
+            !page.examples.some((example) => {
+                const definition = example['definition'];
+                return isObject(definition) && definition['hasFixture'] === true;
+            }))
+            continue;
+        try {
+            files.set(`examples/${page.tag}.js`, await exampleModule(file, registrations));
+            pages[id] = { ...page, exampleModule: `${assets}examples/${page.tag}.js` };
+        }
+        catch (error) {
+            result.warn('node.examples.module', `${file}: ${error instanceof Error ? error.message : String(error)}; its fixtures do not run in previews.`, `/pages/${id}`);
+        }
+    }
+    for (const [id, page] of Object.entries(pages))
+        files.set(pageFile(id), serializeData(page));
+    if (generator)
+        files.set(THEME_WORKER, themeWorker(generator));
+    files.set('frame.importmap.json', `${JSON.stringify(frame.importMap, null, 2)}\n`);
+    files.set('shell.importmap.json', `${JSON.stringify(shell.importMap, null, 2)}\n`);
+    const assetsForFrames = frameAssets(config, [...inputs.graph, ...shellGraph], inputs.graph, base, result);
+    files.set('frame.html', frameHtml({
+        title: `${data.index.branding.name} preview`,
+        importMap: frame.importMap,
+        module: '@oddkin/workbench/frame',
+        preload: preloadGraph(frame.importMap, '@oddkin/workbench/frame', roots),
+        ...assetsForFrames,
+    }));
+    const shellStylesheets = [SHELL_STYLES, SHELL_LAYOUT].flatMap(({ package: name, export: path }) => {
+        const pkg = shellGraph.find((entry) => entry.name === name);
+        const file = pkg && resolveExport(pkg.manifest, path);
+        return pkg && file ? [`${packageRoot(pkg, { base, versioned: true })}${file.slice(2)}`] : [];
+    });
+    return {
+        root: loaded.root,
+        configFile: loaded.file,
+        config,
+        data: { ...data, pages },
+        inputs,
+        files,
+        packages,
+        frameImportMap: frame.importMap,
+        shell: shellHtml({
+            title: data.index.branding.name,
+            ...(config.content.defaultLocale ? { lang: config.content.defaultLocale } : {}),
+            importMap: shell.importMap,
+            stylesheets: shellStylesheets,
+            index: `${assets}index.json`,
+            ...(options.events ? { events: `${assets}events` } : {}),
+            module: '@oddkin/workbench/app/define',
+            preload: preloadGraph(shell.importMap, '@oddkin/workbench/app/define', roots),
+        }),
+        diagnostics: result.items,
+    };
+}
+/** A diagnostic as one line: `error code /path: message`. */
+export function formatDiagnostic(d) {
+    return `${d.severity} ${d.code}${d.path ? ` ${d.path}` : ''}: ${d.message}`;
+}
+//# sourceMappingURL=workbench.js.map

package/dist/node/workbench.js.map

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

package/dist/pages/build.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Build the page registry from standard CEM, optional Oddkin enrichment, authored content, and
+ * configuration. Pure and deterministic; no build time enters the output.
+ */
+import { type DocsContent, type ResolvedWorkbenchConfig, type WorkbenchConfig } from '../config/index.js';
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+import { type CemPackage, type OddkinMetadataLike, type PageRegistry } from './types.js';
+export interface RegistryInput {
+    readonly config: WorkbenchConfig | ResolvedWorkbenchConfig;
+    /** Standard Custom Elements Manifest(s). Enough for the Components baseline. */
+    readonly cem?: CemPackage | readonly CemPackage[];
+    /** `oddkin.metadata.json` enrichment (foundations, categories, examples, products, docs). */
+    readonly metadata?: OddkinMetadataLike;
+    /** Authored content (`oddkin.docs.ts` / Markdown front matter). */
+    readonly docs?: DocsContent;
+}
+/** Build the registry. `registry` is undefined only when the configuration is invalid. */
+export declare function buildPageRegistry(input: RegistryInput): {
+    registry: PageRegistry | undefined;
+    diagnostics: WorkbenchDiagnostic[];
+};
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/pages/build.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,kBAAkB,EAGvB,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,uBAAuB,CAAC;IAC3D,gFAAgF;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;IAClD,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;CAC7B;AA0DD,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG;IACvD,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAgRA"}