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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brian Brady
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,67 @@
-# Temporary Holding Version
+# @oddkin/workbench
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Metadata-driven documentation tooling for any custom-element library. **Status:** the DOM-free contract entries, the data files, the shell, panels, isolated previews, Theme Studio, and the Node tooling (`oddkin analyze`, `oddkin workbench dev`, `oddkin workbench build`) exist (design: [workbench.md](../../docs/architecture/workbench.md) §2.1 and §5.1).
+
+**Stability:** Workbench is versioned `1.0.0` with the other Oddkin packages, but its own contracts are **not frozen by 1.0.0** ([ADR 0047](../../docs/architecture/decisions/0047-m8-checkpoint-candidate-v1-contracts.md)): the configuration (`workbench-config.v1`), the page registry (`page-registry.v1`), authored content (`docs-content.v1`), example links (`share-payload.v1`), Theme Studio compositions (`theme-studio-composition.v1`), the preview frame protocol, and the conformance suites and results (`conformance.v1`, `conformance-result.v1`). Until they are frozen they can change in a minor release ([release-process.md](../../docs/release-process.md) §1). The format `defineExamples()` writes, `examples.v1`, is a candidate v1 contract.
+
+| Entry | Contents |
+| --- | --- |
+| `@oddkin/workbench/examples` | `defineExamples(tag, examples)`, typed from `HTMLElementTagNameMap` (unknown property keys and wrong value types are compile errors); `toExamplesJSON` (the `examples.v1` serializable layer, with fixtures reduced to `hasFixture`); `checkExamples(set, contract)` for plain-JavaScript authors; `exampleId` |
+| `@oddkin/workbench/config` | `defineWorkbenchConfig`, `resolveWorkbenchConfig` (defaults and diagnostics matching `workbench-config.v1`), `defineDocs` (`docs-content.v1`) |
+| `@oddkin/workbench/pages` | `buildPageRegistry({ config, cem, metadata?, docs? })` producing `page-registry.v1`, plus the projections every navigation surface uses: `primaryNavigation`, `sidebar`, `cards`, `searchEntries`, `onThisPage`, `href`, `resolveLegacyRoute`, `staticRedirects` |
+| `@oddkin/workbench/data` | `buildWorkbenchData({ config, libraries, docs?, tokens?, diagnostics? })`: one or more packages' CEM and enrichment, authored content, and a token inspection → a small index (registry, branding, libraries, the components that can preview, diagnostics) and one data file per visible page (`pageFile(id)`), serialized byte-stably with `serializeData`; `createImportMap(packages, { base, versioned?, conditions? })` builds import maps from package `exports`, and `resolveExport` resolves one subpath to its file |
+| `@oddkin/workbench/node` | Node only. `buildWorkbench({ config?, events? })` loads `oddkin.config.*` (TypeScript through Node's type stripping), the documented packages and their dependencies, their manifests, enrichment, and referenced token inspection, and authored `oddkin.docs.*`, and returns the data files, both import maps, and the shell page; `buildStatic` (`workbench build`), `shellPaths`, `startDevServer`, `writeGenerated` (the marked `.oddkin/workbench/`), `loadWorkbenchConfig`, `loadInputs`, `packageGraph`, and `run` (the command) |
+| `@oddkin/workbench/testing` | `mountExample(set, name, container?)` runs an authored example and its fixture in a browser test; `runConformance` runs a conformance suite with the project's own `expect` |
+| `@oddkin/workbench/panels/{catalog,component,foundation}` | The embeddable panels' classes; `…/define` registers `<oddkin-catalog-panel>`, `<oddkin-component-panel>`, or `<oddkin-foundation-panel>` (see [Embedding the panels](#embedding-the-panels)) |
+| `@oddkin/workbench/frame` | The preview frame runtime, imported by the frame document |
+
+The examples, config, pages, and data entries import without a DOM and have no runtime dependencies (`@oddkin/core` is used for types only). Shipped component code never imports them; colocated `*.examples.ts` files may, because they are development-only sources excluded from the package build (ADR 0021).
+
+## The `oddkin` command
+
+```sh
+oddkin analyze <tsconfig.json> [options]     # @oddkin/analyzer's own command, same options and exit codes
+oddkin workbench dev [--config <file or directory>] [--port <number>] [--host <name>] [--no-watch]
+oddkin workbench build [--config <file or directory>] [--out <directory>] [--base <path>] [--routing history|hash]
+```
+
+`workbench dev` serves the Workbench at `http://localhost:4175/` (the configured base path): the shell for page paths (history mode; in hash mode only at the entry, like a static host without rewrites), the data under `_oddkin/`, and package files under `_oddkin/m/<name>@<version>/`. It writes the same data into `.oddkin/workbench/`, a directory it marks and owns, watches the configuration, content, manifests, metadata, and the packages' files, and pushes an `update` event over Server-Sent Events (`_oddkin/events`) after each rebuild. An invalid edit keeps the last valid data and reports diagnostics. A watched directory that is deleted or replaced, as reinstalling a package does, is watched again once it is back, and the data is rebuilt from it. Exit codes: 0 success, 1 errors, 2 usage.
+
+`workbench build` writes the same layout as files for a static host, by default into `.oddkin/workbench-build/` (marked and owned like the dev directory; an unmarked directory is refused): the shell, `_oddkin/` data and frame document, and each package's published browser files (no type declarations, sources, or source maps). `--base` and `--routing` replace the configuration's `hosting` values. In history mode every page path and legacy path is a copy of the shell, so deep links and refreshes load on a host without rewrites, and `404.html` is the shell for hosts that serve it; legacy paths redirect in the app, keeping their query. Hash mode writes the shell once. Nothing is written when the configuration or metadata has errors; an import-map target that a package does not publish is a `node.build.unpublished` warning. Output is deterministic, and a rebuild rewrites only changed files and removes stale ones. Theme Studio generates in the browser, so the result needs no Node or analyzer backend.
+
+## Embedding the panels
+
+A site that renders its own pages can show the catalog, component, and foundation panels without the Workbench shell; the Oddkin docs site does (`apps/docs`). The contract is not frozen by 1.0.0 (see Stability above); `e2e/workbench-embed.spec.ts` checks it with a page of its own in three browsers.
+
+1. **Build the files in Node.** `buildWorkbench({ config, hosting: { basePath } })` from `@oddkin/workbench/node` reads the configuration (`oddkin.config.*`, and authored content in `oddkin.docs.*` beside it), the documented packages, their metadata, and their authored examples. `embedFiles(build)` returns every file the panels and previews load, as paths below the base path, each a string or `{ source }` (a file to copy):
+   - `_oddkin/index.json`: the index (registry, branding, libraries, the components whose element registers and so can preview, diagnostics), the panels' `index`;
+   - `_oddkin/pages/…json`: one file per visible page, named by `index.pages[id]`, the panels' `page`, with each example's values (read in Node from the `*.examples.ts` sources; a browser cannot build them; for an installed package, which ships no sources, the values its `oddkin.metadata.json` records);
+   - `_oddkin/examples/<tag>.js`: for a component whose examples have fixtures, its `*.examples.ts` source with the types stripped, which a frame imports to run the fixture of the example it mounts (the page file names it as `exampleModule`). Fixtures that write markup with `innerHTML` need a frame without enforced Trusted Types, or a policy the site chooses. When the module is not served or a fixture throws, the frame keeps the element and the panel says that the example's setup did not run;
+   - `_oddkin/frame.html`, the preview frame document, and the import maps as JSON: `frame.importmap.json` (the documented packages and the frame runtime) and `shell.importmap.json` (also Workbench's own entries, the panels included);
+   - `_oddkin/theme-studio.worker.js`, Theme Studio's generator;
+   - `_oddkin/m/<name>@<version>/…`: each package's published browser files.
+
+   Serve them at `<basePath>_oddkin/…`, the URLs `oddkin workbench dev` uses. A `node.build.unpublished` warning names an import-map target that a package does not publish.
+2. **The frame document.** Previews run in same-origin frames, one realm each. `_oddkin/frame.html` loads the theme stylesheet, maps the packages with an inline import map, and starts the runtime with an inline module script (`import "@oddkin/workbench/frame"`); its body is `<main data-oddkin-preview>`. A site whose policy allows no inline script or style writes its own frame document with the same parts: an element with `data-oddkin-preview`, the theme's stylesheet, an import map that resolves the documented packages and `@oddkin/workbench/frame`, and a module script file that imports `@oddkin/workbench/frame` (`apps/docs/frame.html`). The runtime imports each component's registration entry by its bare specifier through that import map: the `registration` of its `oddkin.metadata.json` entry, or, for a library with a standard Custom Elements Manifest only, the module whose exports hold the tag's `custom-element-definition`, reached through the package's `exports` (the page file names it as `registration`). The host adds `frame` and `generation` query parameters to the frame's URL.
+3. **The host page.** Import the registrations (`@oddkin/workbench/panels/catalog/define`, `…/component/define`, `…/foundation/define`) with a bundler or through an import map (`shell.importmap.json` maps them), load a theme stylesheet (the panels read Oddkin tokens), and set the panels' properties from the files above.
+4. **Policy.** Previews need `frame-src 'self'`, and the data fetches `connect-src 'self'`. The panels render with Oddkin's template engine, which works under `require-trusted-types-for 'script'` with `trusted-types oddkin-template`, and need no inline script or style; only the generated frame document has them.
+5. **Panels.**
+
+   | Element | Properties | Events and methods |
+   | --- | --- | --- |
+   | `<oddkin-catalog-panel>` | `index`; `href(route)`, which maps a Workbench route such as `/components/odd-button` to the site's URL for it; `groups`, the categories to list (unset: all); `preview(page)`, a live preview node for a card, the same node for the same page (cards load no component code without it); `query`; `category` | `oddkin-catalog-filter` (`detail: { query, category }`, bubbles, composed) when the reader filters, for the site to mirror in its URL |
+   | `<oddkin-component-panel>` | `index`; `page`, the component's page file; `href`; `frameUrl`, the frame document's URL (empty: no preview); `layout`, `'workbench'` (default) or `'reference'`, the documentation page: links to the page's sections, the interactive example without Workbench's preset, preview settings, example link, and event log, and absent items left out instead of labelled; `examplePreview(page, exampleId)`, a live element for an example card, which only a host that loads the library can supply; `sections`, the section ids to show for a host's tabs (`overview`, `interactive-example`, `api`, `examples`, `tokens`, `behavior-and-accessibility`, `guidance`, `source`, `known-limitations`; `null`, the default, shows every section): the others stay rendered but hidden, so the example's preview and controls survive a tab switch, and the panel leaves out its own section links | `previewState` and `previews` (read-only); `replacePreview()` loads fresh frames after the component's code changed. Copy example link (Workbench layout) writes `href(route)` with a `preview` query parameter, which a panel reads when it loads |
+   | `<oddkin-foundation-panel>` | `index`, `page`, `href` | — |
+
+6. **Ordering.** A frame handles requests one at a time, in the order they were sent, and `createIsolatedPreview` sends each one after the previous one has settled (its timeout counts from then). An edit made while a preview still loads its module graph applies to the element that mount creates.
+
+## Registry rules
+
+- **Inputs:** standard CEM is enough for the Components baseline, previews included when a module the package exports holds the element's `custom-element-definition`. `oddkin.metadata.json` enrichment adds foundations, categories, examples (with their values when the analyzer could read them from the source), products, and `docs` facts. Authored content (`defineDocs`) overrides prose and presentation only; generated facts win.
+- **Stable ids:** `foundations/<slug>`, `components/<tag>`, `theme-studio`, `products`. Routes and the base path can change without changing ids.
+- **Honest absence:** a foundation page appears only when enrichment declares it and at least one section has data. Foundations stays as a destination with `availability: 'unavailable'` when no foundation data exists. Components without enrichment are `partial`. Authored `visible: true` cannot show a page or section whose data is missing.
+- **Theme Studio** is a primary destination and never a Foundations card or sidebar entry. **Products and modes** is absent unless enabled, and hidden with `pages.products.empty` when no products resolve.
+- **Dates** come only from authored content or enrichment facts (authored or source history); unknown dates are omitted and build time is never used.
+- **Legacy routes:** `/playground` → `/components` (or `/components/<tag>` from `?component=`, keeping other parameters); `/foundations/theme-studio` → Theme Studio; `/foundations/products` → Products, or a `products.disabled` notice.
+
+Tests: `test/pages.test.ts` (real analyzer output for `examples/core-counter` plus an independent fixture library, validated against `page-registry.v1` and `oddkin-metadata.v1`), `test/data.test.ts` (the published outputs of `@oddkin/components` and `@oddkin/ai`, the default theme's token inspection, the Acme fixture, and import maps from real package `exports`), `test/node-*.test.ts` (throwaway projects with an Acme library, the real components through `tests/fixtures/workbench-oddkin`, the dev server over HTTP and Server-Sent Events, and the built command in a real Node process), `test/config.test.ts`, `test/examples.test.ts`, and the type-level `test/examples.types.ts`.

package/dist/app/card-previews.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentPageData } from '../data/types.js';
+import type { PageEntry } from '../pages/types.js';
+export interface CardPreviews {
+    /** The card's preview host: the same node for the same page. */
+    preview(entry: PageEntry): Node | undefined;
+    dispose(): void;
+}
+export declare function cardPreviews(options: {
+    readonly document: Document;
+    readonly frameUrl: string;
+    /** The component page's data, or `undefined` when it has none. */
+    readonly page: (id: string, signal: AbortSignal) => Promise<ComponentPageData | undefined>;
+}): CardPreviews;
+//# sourceMappingURL=card-previews.d.ts.map

package/dist/app/card-previews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-previews.d.ts","sourceRoot":"","sources":["../../src/app/card-previews.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAInD,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;CAC5F,GAAG,YAAY,CAsHf"}

package/dist/app/card-previews.js

@@ -0,0 +1,140 @@
+/**
+ * Live previews for the shell's catalog cards. The shell registers no library element in its own
+ * realm, so each card shows its component's first example in a preview frame, created when the
+ * card nears the view and loaded two at a time (a card scrolled past before its turn waits until
+ * it comes back); the card's link stays its only stop. Frames are bounded: past `KEPT`, the frames
+ * of the cards longest out of view are released and load again when their cards come back, as a
+ * frame does whose card a filter took out and back (moving a frame reloads its document).
+ */
+import { createScope } from '@oddkin/core/scope';
+import { initialState, presets, registrationOf } from '../panels/model.js';
+import { createIsolatedPreview } from '../preview/frame.js';
+const LOADING = 2;
+/** Frames kept in all; the frames of cards near the view are never released. */
+const KEPT = 12;
+export function cardPreviews(options) {
+    const { document: doc, frameUrl } = options;
+    const scope = createScope({ name: 'workbench-card-previews' });
+    const hosts = new Map();
+    const loads = new Map();
+    /** Hosts whose load has started: loading, showing a frame, or with nothing to show. */
+    const started = new Set();
+    /** Frames by host, the card that came near the view longest ago first. */
+    const frames = new Map();
+    const near = new Set();
+    /** Hosts near the view that have not started, in the order they came near. */
+    const queue = [];
+    let loading = 0;
+    const release = (host) => {
+        frames.get(host)?.dispose();
+        frames.delete(host);
+        started.delete(host);
+    };
+    const trim = () => {
+        for (const host of [...frames.keys()]) {
+            if (frames.size <= KEPT)
+                return;
+            if (!near.has(host))
+                release(host);
+        }
+    };
+    const next = () => {
+        while (loading < LOADING && queue.length && !scope.disposed) {
+            const host = queue.shift();
+            started.add(host);
+            loading++;
+            void loads.get(host)()
+                .catch(() => { })
+                .finally(() => {
+                loading--;
+                next();
+            });
+        }
+    };
+    const observer = new IntersectionObserver((records) => {
+        for (const { target, isIntersecting } of records) {
+            const at = queue.indexOf(target);
+            if (isIntersecting) {
+                near.add(target);
+                const frame = frames.get(target);
+                if (frame) {
+                    // Most recently near the view: the last to be released.
+                    frames.delete(target);
+                    frames.set(target, frame);
+                }
+                else if (!started.has(target) && at < 0)
+                    queue.push(target);
+            }
+            else {
+                near.delete(target);
+                if (at >= 0)
+                    queue.splice(at, 1);
+            }
+        }
+        trim();
+        next();
+    }, { rootMargin: '200px' });
+    scope.add(() => {
+        observer.disconnect();
+        for (const frame of frames.values())
+            frame.dispose();
+        frames.clear();
+    }, 'card previews');
+    const load = (host, entry) => async () => {
+        const page = await options.page(entry.id, scope.signal);
+        const registration = page && registrationOf(page);
+        // Released while its page data loaded: it starts again when its card comes back.
+        if (!page || registration === undefined || scope.disposed || !started.has(host))
+            return;
+        const state = initialState(page);
+        const fixture = presets(page).some((p) => p.name === state.preset && p.fixture);
+        const preview = createIsolatedPreview({
+            document: doc,
+            container: host,
+            frameUrl,
+            title: `${entry.title} preview`,
+        });
+        frames.set(host, preview);
+        trim();
+        preview.iframe.style.blockSize = '100%';
+        preview.iframe.tabIndex = -1;
+        await preview.request('mount', {
+            tag: page.tag,
+            registration,
+            example: `example:${page.tag}/${state.preset}`,
+            properties: state.properties,
+            attributes: state.attributes,
+            slots: state.slots,
+            styles: state.styles ?? {},
+            ...(fixture && page.exampleModule ? { fixture: page.exampleModule } : {}),
+        });
+        // Moving a frame (a filter took its card out and back) loads a new, empty document.
+        const mounted = preview.iframe.contentDocument;
+        preview.iframe.addEventListener('load', () => {
+            if (frames.get(host) !== preview || preview.iframe.contentDocument === mounted)
+                return;
+            release(host);
+            if (near.has(host))
+                queue.push(host);
+            next();
+        });
+    };
+    return {
+        preview(entry) {
+            if (entry.kind !== 'component' || scope.disposed)
+                return undefined;
+            let host = hosts.get(entry.id);
+            if (!host) {
+                host = doc.createElement('div');
+                host.className = 'wb-card-frame';
+                host.inert = true;
+                hosts.set(entry.id, host);
+                loads.set(host, load(host, entry));
+                observer.observe(host);
+            }
+            return host;
+        },
+        dispose: () => scope.dispose(),
+    };
+}
+//# sourceMappingURL=card-previews.js.map

package/dist/app/card-previews.js.map

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

package/dist/app/copy.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Built-in shell copy (English). Generic and conditional: it never states facts about the
+ * library, which come from generated data. Moves to the localizable `./content` catalog (item 818).
+ */
+export declare const COPY: {
+    readonly skip: 'Skip to main content';
+    readonly loading: 'Loading the Workbench…';
+    readonly indexFailed: 'The Workbench index could not be loaded';
+    readonly indexIncompatible: 'This index was written by a different Workbench version';
+    readonly primaryNavigation: 'Primary';
+    readonly search: 'Search';
+    readonly searchPlaceholder: 'Search pages';
+    readonly componentSearch: 'Search components';
+    readonly componentSearchPlaceholder: 'Find a component…';
+    readonly componentSearchHint: 'Search by name or purpose';
+    readonly componentCount: (count: number) => string;
+    readonly categoryCount: (count: number) => string;
+    readonly categoryFilter: 'Category';
+    readonly allCategories: 'All';
+    readonly viewPage: (component: boolean) => "Read more" | "View reference";
+    readonly componentResults: (shown: number, total: number) => string;
+    readonly noComponentResults: 'No components match these filters.';
+    readonly searchResults: (shown: number, total: number) => string;
+    readonly appearance: 'Appearance';
+    readonly appearances: {
+        readonly system: 'System';
+        readonly light: 'Light';
+        readonly dark: 'Dark';
+    };
+    readonly overviewEyebrow: 'Design system';
+    readonly summaries: Readonly<Record<string, string>>;
+    readonly allPages: (title: string) => string;
+    readonly showSection: (title: string) => string;
+    readonly hideSection: (title: string) => string;
+    readonly onThisPage: 'On this page';
+    readonly updated: 'Updated';
+    readonly sectionPending: 'This Workbench build does not display this section yet.';
+    readonly toolPending: 'This Workbench build does not include Theme Studio yet.';
+    readonly noFoundations: 'No foundation data supplied';
+    readonly noFoundationsHelp: 'Foundation pages appear when the library publishes Oddkin metadata with foundations, generated from a theme configuration.';
+    readonly noComponents: 'No components were found in the library’s Custom Elements Manifest.';
+    readonly notFound: 'Page not found';
+    readonly notFoundText: (path: string) => string;
+    readonly pageFailed: 'This page could not be loaded';
+    readonly productsDisabled: 'Products and modes is not enabled in this Workbench.';
+    readonly stale: (errors: number) => string;
+};
+//# sourceMappingURL=copy.d.ts.map

package/dist/app/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/app/copy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;aACf,IAAI,EAAE,sBAAsB;aAC5B,OAAO,EAAE,wBAAwB;aACjC,WAAW,EAAE,yCAAyC;aACtD,iBAAiB,EAAE,yDAAyD;aAC5E,iBAAiB,EAAE,SAAS;aAC5B,MAAM,EAAE,QAAQ;aAChB,iBAAiB,EAAE,cAAc;aACjC,eAAe,EAAE,mBAAmB;aACpC,0BAA0B,EAAE,mBAAmB;aAC/C,mBAAmB,EAAE,2BAA2B;aAChD,cAAc,UAAU,MAAM;aAC9B,aAAa,UAAU,MAAM;aAC7B,cAAc,EAAE,UAAU;aAC1B,aAAa,EAAE,KAAK;aACpB,QAAQ,cAAc,OAAO;aAC7B,gBAAgB,UAAU,MAAM,SAAS,MAAM;aAE/C,kBAAkB,EAAE,oCAAoC;aACxD,aAAa,UAAU,MAAM,SAAS,MAAM;aAM5C,UAAU,EAAE,YAAY;aACxB,WAAW;iBAAI,MAAM,EAAE,QAAQ;iBAAE,KAAK,EAAE,OAAO;iBAAE,IAAI,EAAE,MAAM;;aAC7D,eAAe,EAAE,eAAe;aAChC,SAAS,EAIJ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aACrC,QAAQ,UAAU,MAAM;aACxB,WAAW,UAAU,MAAM;aAC3B,WAAW,UAAU,MAAM;aAC3B,UAAU,EAAE,cAAc;aAC1B,OAAO,EAAE,SAAS;aAClB,cAAc,EAAE,yDAAyD;aACzE,WAAW,EAAE,yDAAyD;aACtE,aAAa,EAAE,6BAA6B;aAC5C,iBAAiB,EACf,4HAA4H;aAC9H,YAAY,EAAE,qEAAqE;aACnF,QAAQ,EAAE,gBAAgB;aAC1B,YAAY,SAAS,MAAM;aAC3B,UAAU,EAAE,+BAA+B;aAC3C,gBAAgB,EAAE,sDAAsD;aACxE,KAAK,WAAW,MAAM;CAEd,CAAC"}

package/dist/app/copy.js

@@ -0,0 +1,52 @@
+/**
+ * Built-in shell copy (English). Generic and conditional: it never states facts about the
+ * library, which come from generated data. Moves to the localizable `./content` catalog (item 818).
+ */
+export const COPY = {
+    skip: 'Skip to main content',
+    loading: 'Loading the Workbench…',
+    indexFailed: 'The Workbench index could not be loaded',
+    indexIncompatible: 'This index was written by a different Workbench version',
+    primaryNavigation: 'Primary',
+    search: 'Search',
+    searchPlaceholder: 'Search pages',
+    componentSearch: 'Search components',
+    componentSearchPlaceholder: 'Find a component…',
+    componentSearchHint: 'Search by name or purpose',
+    componentCount: (count) => `${count} ${count === 1 ? 'component' : 'components'}`,
+    categoryCount: (count) => `${count} ${count === 1 ? 'category' : 'categories'}`,
+    categoryFilter: 'Category',
+    allCategories: 'All',
+    viewPage: (component) => (component ? 'View reference' : 'Read more'),
+    componentResults: (shown, total) => `Showing ${shown} of ${total} ${total === 1 ? 'component' : 'components'}`,
+    noComponentResults: 'No components match these filters.',
+    searchResults: (shown, total) => total === 0
+        ? 'No results'
+        : shown < total
+            ? `Showing ${shown} of ${total} results`
+            : `${total} ${total === 1 ? 'result' : 'results'}`,
+    appearance: 'Appearance',
+    appearances: { system: 'System', light: 'Light', dark: 'Dark' },
+    overviewEyebrow: 'Design system',
+    summaries: {
+        foundations: 'The shared values and rules that components are built on.',
+        components: 'Every documented component, grouped by category.',
+        'theme-studio': 'Edit the theme configuration and preview it on real components.',
+    },
+    allPages: (title) => `All ${title.toLowerCase()}`,
+    showSection: (title) => `Show ${title.toLowerCase()}`,
+    hideSection: (title) => `Hide ${title.toLowerCase()}`,
+    onThisPage: 'On this page',
+    updated: 'Updated',
+    sectionPending: 'This Workbench build does not display this section yet.',
+    toolPending: 'This Workbench build does not include Theme Studio yet.',
+    noFoundations: 'No foundation data supplied',
+    noFoundationsHelp: 'Foundation pages appear when the library publishes Oddkin metadata with foundations, generated from a theme configuration.',
+    noComponents: 'No components were found in the library’s Custom Elements Manifest.',
+    notFound: 'Page not found',
+    notFoundText: (path) => `There is no page at ${path}.`,
+    pageFailed: 'This page could not be loaded',
+    productsDisabled: 'Products and modes is not enabled in this Workbench.',
+    stale: (errors) => `The latest changes could not be applied (${errors} ${errors === 1 ? 'error' : 'errors'}); the last valid version is shown.`,
+};
+//# sourceMappingURL=copy.js.map

package/dist/app/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../src/app/copy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,wBAAwB;IACjC,WAAW,EAAE,yCAAyC;IACtD,iBAAiB,EAAE,yDAAyD;IAC5E,iBAAiB,EAAE,SAAS;IAC5B,MAAM,EAAE,QAAQ;IAChB,iBAAiB,EAAE,cAAc;IACjC,eAAe,EAAE,mBAAmB;IACpC,0BAA0B,EAAE,mBAAmB;IAC/C,mBAAmB,EAAE,2BAA2B;IAChD,cAAc,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,EAAE;IACzF,aAAa,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,EAAE;IACvF,cAAc,EAAE,UAAU;IAC1B,aAAa,EAAE,KAAK;IACpB,QAAQ,EAAE,CAAC,SAAkB,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC;IAC9E,gBAAgB,EAAE,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CACjD,WAAW,KAAK,OAAO,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,EAAE;IAC5E,kBAAkB,EAAE,oCAAoC;IACxD,aAAa,EAAE,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAC9C,KAAK,KAAK,CAAC;QACT,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,KAAK,GAAG,KAAK;YACb,CAAC,CAAC,WAAW,KAAK,OAAO,KAAK,UAAU;YACxC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE;IACxD,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE;IAC/D,eAAe,EAAE,eAAe;IAChC,SAAS,EAAE;QACT,WAAW,EAAE,2DAA2D;QACxE,UAAU,EAAE,kDAAkD;QAC9D,cAAc,EAAE,iEAAiE;KAC9C;IACrC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,WAAW,EAAE,EAAE;IACzD,WAAW,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE;IAC7D,WAAW,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE;IAC7D,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,yDAAyD;IACzE,WAAW,EAAE,yDAAyD;IACtE,aAAa,EAAE,6BAA6B;IAC5C,iBAAiB,EACf,4HAA4H;IAC9H,YAAY,EAAE,qEAAqE;IACnF,QAAQ,EAAE,gBAAgB;IAC1B,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,uBAAuB,IAAI,GAAG;IAC9D,UAAU,EAAE,+BAA+B;IAC3C,gBAAgB,EAAE,sDAAsD;IACxE,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE,CACxB,4CAA4C,MAAM,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,qCAAqC;CACtH,CAAC"}

package/dist/app/define.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="shell.d.ts" preserve="true" />
+import '@oddkin/components/define/card';
+//# sourceMappingURL=define.d.ts.map

package/dist/app/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/app/define.ts"],"names":[],"mappings":";AAEA,OAAO,gCAAgC,CAAC"}

package/dist/app/define.js

@@ -0,0 +1,10 @@
+/// <reference path="./shell.ts" preserve="true" />
+// Registers <oddkin-workbench>, its detail-content elements, and the components the shell renders.
+import '@oddkin/components/define/card';
+import { define } from '@oddkin/core/element';
+import { WorkbenchComponentDetail, WorkbenchFoundationDetail } from './details.js';
+import { OddkinWorkbench } from './shell.js';
+define('oddkin-workbench', OddkinWorkbench);
+define('oddkin-workbench-component', WorkbenchComponentDetail);
+define('oddkin-workbench-foundation', WorkbenchFoundationDetail);
+//# sourceMappingURL=define.js.map

package/dist/app/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/app/define.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,mGAAmG;AACnG,OAAO,gCAAgC,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;AAC5C,MAAM,CAAC,4BAA4B,EAAE,wBAAwB,CAAC,CAAC;AAC/D,MAAM,CAAC,6BAA6B,EAAE,yBAAyB,CAAC,CAAC"}

package/dist/app/details.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The shell's detail content: the public panels' renderers in the light DOM, so the shell's
+ * "On this page" links and URL fragments reach the section headings.
+ */
+import { ComponentDetailElement } from '../panels/component-detail.js';
+import { FoundationDetailElement } from '../panels/foundation-detail.js';
+import type { StyleInput } from '@oddkin/core/styles';
+export declare class WorkbenchComponentDetail extends ComponentDetailElement {
+    static shadowRootOptions: null;
+    static styles: StyleInput;
+}
+export declare class WorkbenchFoundationDetail extends FoundationDetailElement {
+    static shadowRootOptions: null;
+    static styles: StyleInput;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'oddkin-workbench-component': WorkbenchComponentDetail;
+        'oddkin-workbench-foundation': WorkbenchFoundationDetail;
+    }
+}
+//# sourceMappingURL=details.d.ts.map

package/dist/app/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../src/app/details.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,qBAAa,wBAAyB,SAAQ,sBAAsB;IAClE,OAAgB,iBAAiB,OAAQ;IACzC,OAAgB,MAAM,EAAE,UAAU,CAAkC;CACrE;AAED,qBAAa,yBAA0B,SAAQ,uBAAuB;IACpE,OAAgB,iBAAiB,OAAQ;IACzC,OAAgB,MAAM,EAAE,UAAU,CAAiB;CACpD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,4BAA4B,EAAE,wBAAwB,CAAC;QACvD,6BAA6B,EAAE,yBAAyB,CAAC;KAC1D;CACF"}

package/dist/app/details.js

@@ -0,0 +1,17 @@
+/**
+ * The shell's detail content: the public panels' renderers in the light DOM, so the shell's
+ * "On this page" links and URL fragments reach the section headings.
+ */
+import { ComponentDetailElement } from '../panels/component-detail.js';
+import { FoundationDetailElement } from '../panels/foundation-detail.js';
+import { contentStyles } from '../panels/styles.js';
+import { exampleStyles } from '../panels/example-styles.js';
+export class WorkbenchComponentDetail extends ComponentDetailElement {
+    static shadowRootOptions = null;
+    static styles = [contentStyles, exampleStyles];
+}
+export class WorkbenchFoundationDetail extends FoundationDetailElement {
+    static shadowRootOptions = null;
+    static styles = contentStyles;
+}
+//# sourceMappingURL=details.js.map

package/dist/app/details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.js","sourceRoot":"","sources":["../../src/app/details.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,OAAO,wBAAyB,SAAQ,sBAAsB;IAClE,MAAM,CAAU,iBAAiB,GAAG,IAAI,CAAC;IACzC,MAAM,CAAU,MAAM,GAAe,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CACrE;AAED,MAAM,OAAO,yBAA0B,SAAQ,uBAAuB;IACpE,MAAM,CAAU,iBAAiB,GAAG,IAAI,CAAC;IACzC,MAAM,CAAU,MAAM,GAAe,aAAa,CAAC;CACpD"}

package/dist/app/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@oddkin/workbench/app` — the Workbench shell (workbench.md §2.1): `<oddkin-workbench>` and the
+ * DOM-free pieces it is built from (registry routes, search). Registration is the separate,
+ * side-effecting `@oddkin/workbench/app/define`.
+ */
+export { OddkinWorkbench } from './shell.js';
+export type { WorkbenchSource } from './shell.js';
+export { shellRoutes } from './routes.js';
+export type { PageLoader, ShellView } from './routes.js';
+export { search, searchItems } from './search.js';
+export type { SearchItem } from './search.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/app/index.js

@@ -0,0 +1,9 @@
+/**
+ * `@oddkin/workbench/app` — the Workbench shell (workbench.md §2.1): `<oddkin-workbench>` and the
+ * DOM-free pieces it is built from (registry routes, search). Registration is the separate,
+ * side-effecting `@oddkin/workbench/app/define`.
+ */
+export { OddkinWorkbench } from './shell.js';
+export { shellRoutes } from './routes.js';
+export { search, searchItems } from './search.js';
+//# sourceMappingURL=index.js.map

package/dist/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/app/routes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The shell's routes, generated from the page registry (workbench-pages.md §2): every visible
+ * page, legacy routes as redirects, and the Products notice. DOM-free, so it can be tested
+ * with `matchRoutes` in Node.
+ */
+import { type AnyRoute, type RouteContext } from '@oddkin/app/router';
+import type { PageEntry, PageRegistry } from '../pages/types.js';
+/** What a route level shows: a registry page with the data its loader returned, or a notice. */
+export type ShellView = {
+    readonly kind: 'page';
+    readonly page: PageEntry;
+    readonly data: unknown;
+} | {
+    readonly kind: 'notice';
+    readonly code: 'products.disabled';
+};
+/** Loads a page's data (and anything its view needs) for one navigation. */
+export type PageLoader = (page: PageEntry, context: RouteContext<unknown, unknown>) => unknown | PromiseLike<unknown>;
+/**
+ * Routes for every visible page (nested by path segment), each legacy route of a visible page
+ * as a redirect resolved like `resolveLegacyRoute`, `/foundations/products` as a notice when
+ * Products and modes is not shown, and, without a home page, `/` redirecting to the first
+ * primary destination that has content.
+ */
+export declare function shellRoutes(registry: PageRegistry, load: PageLoader): AnyRoute[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/app/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/app/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAS,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,gGAAgG;AAChG,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEpE,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,KACpC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AA6DpC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,EAAE,CAgChF"}

package/dist/app/routes.js

@@ -0,0 +1,96 @@
+/**
+ * The shell's routes, generated from the page registry (workbench-pages.md §2): every visible
+ * page, legacy routes as redirects, and the Products notice. DOM-free, so it can be tested
+ * with `matchRoutes` in Node.
+ */
+import { route } from '@oddkin/app/router';
+import { resolveLegacyRoute } from '../pages/navigation.js';
+function level(registry, node, load) {
+    const { page, redirect, notice } = node;
+    if (page) {
+        return {
+            name: page.id,
+            title: page.title,
+            load: async (context) => ({
+                kind: 'page',
+                page,
+                data: await load(page, context),
+            }),
+        };
+    }
+    if (redirect) {
+        const from = redirect;
+        return {
+            redirect: ({ location }) => {
+                const result = resolveLegacyRoute(registry, from, location.search);
+                return result?.kind === 'redirect' ? result.to : '/';
+            },
+        };
+    }
+    if (notice) {
+        return {
+            title: 'Products and modes',
+            load: () => ({ kind: 'notice', code: notice }),
+        };
+    }
+    return undefined;
+}
+function toRoutes(registry, node, load) {
+    const routes = [];
+    for (const [segment, child] of node.children) {
+        const own = level(registry, child, load);
+        const children = toRoutes(registry, child, load);
+        if (children.length)
+            routes.push(route({
+                path: segment,
+                children: own ? [route({ ...own, path: '' }), ...children] : children,
+            }));
+        else if (own)
+            routes.push(route({ ...own, path: segment }));
+    }
+    return routes;
+}
+/**
+ * Routes for every visible page (nested by path segment), each legacy route of a visible page
+ * as a redirect resolved like `resolveLegacyRoute`, `/foundations/products` as a notice when
+ * Products and modes is not shown, and, without a home page, `/` redirecting to the first
+ * primary destination that has content.
+ */
+export function shellRoutes(registry, load) {
+    const root = { children: new Map() };
+    const at = (path) => {
+        let node = root;
+        for (const segment of path.split('/').filter(Boolean)) {
+            let child = node.children.get(segment);
+            if (!child)
+                node.children.set(segment, (child = { children: new Map() }));
+            node = child;
+        }
+        return node;
+    };
+    for (const page of registry.pages)
+        if (page.visible)
+            at(page.route).page = page;
+    for (const page of registry.pages) {
+        if (!page.visible)
+            continue;
+        for (const legacy of page.legacyRoutes ?? []) {
+            const node = at(legacy);
+            if (!node.page)
+                node.redirect = legacy;
+        }
+    }
+    if (!registry.pages.some((p) => p.id === 'products' && p.visible)) {
+        const node = at('/foundations/products');
+        if (!node.page)
+            node.notice = 'products.disabled';
+    }
+    const own = level(registry, root, load);
+    // Without a home page, the base URL goes to the first primary destination with content: a
+    // library without foundation data opens on its components, not on an explanation.
+    const primary = registry.primaryNav.flatMap((id) => registry.pages.filter((p) => p.id === id && p.visible));
+    const first = primary.find((p) => p.availability !== 'unavailable') ?? primary[0];
+    const entry = own ?? (first && first.route !== '/' ? { redirect: first.route } : undefined);
+    return [...(entry ? [route({ ...entry, path: '' })] : []), ...toRoutes(registry, root, load)];
+}
+//# sourceMappingURL=routes.js.map