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

package/dist/pages/defaults.js

@@ -0,0 +1,88 @@
+/**
+ * Built-in titles for pages and sections (workbench-pages.md §4–§8). Generic structure only:
+ * no library facts. Moves to the localizable `./content` catalog with the shell (M5).
+ */
+/** Foundation ids (oddkin-metadata v1) → page slug and title, in default order. */
+export const FOUNDATIONS = [
+    { id: 'tokens', slug: 'token-architecture', title: 'Token architecture' },
+    { id: 'color', slug: 'color', title: 'Color' },
+    { id: 'typography', slug: 'typography', title: 'Typography' },
+    { id: 'spacing', slug: 'spacing', title: 'Spacing' },
+    { id: 'borders-and-radii', slug: 'borders-and-radii', title: 'Borders and radii' },
+    { id: 'elevation', slug: 'elevation', title: 'Elevation' },
+    { id: 'motion', slug: 'motion', title: 'Motion' },
+    { id: 'themes', slug: 'themes', title: 'Themes' },
+    { id: 'responsive', slug: 'responsive-behavior', title: 'Responsive behavior' },
+];
+export const SECTION_TITLES = {
+    // Foundations
+    'tiers-and-naming': 'Tiers and naming',
+    pipeline: 'Source-to-output pipeline',
+    'trace-a-token': 'Trace a token',
+    consumption: 'Consumption',
+    'aliases-and-overrides': 'Aliases and overrides',
+    'dependency-policy': 'Dependency policy and direct reads',
+    'every-token': 'Every token',
+    palettes: 'Palettes and ramps',
+    'semantic-roles': 'Semantic roles',
+    'interactive-states': 'Interactive states',
+    'product-variations': 'Product variations',
+    'contrast-pairs': 'Contrast pairs',
+    families: 'Families',
+    scale: 'Scale',
+    'composite-styles': 'Composite styles',
+    specimens: 'Specimens',
+    vocabulary: 'Semantic vocabulary',
+    precedence: 'Precedence and layout behavior',
+    'border-widths': 'Border widths and styles',
+    'border-colors': 'Border colour roles',
+    radii: 'Radii',
+    'component-mappings': 'Component mappings',
+    samples: 'Samples',
+    levels: 'Levels',
+    'theme-variations': 'Theme variations',
+    'durations-and-easing': 'Durations and easing',
+    roles: 'Roles',
+    'try-a-duration': 'Try a duration',
+    'reduced-motion': 'Reduced motion',
+    'themes-and-modes': 'Available themes and modes',
+    'scope-contract': 'Scope contract',
+    composition: 'Composition and precedence',
+    comparisons: 'Comparisons',
+    usage: 'Usage snippets',
+    'which-query': 'Which query to use',
+    conditions: 'Conditions and thresholds',
+    profiles: 'Profiles',
+    'responsive-roles': 'Responsive roles',
+    recipes: 'Recipes',
+    'resize-a-container': 'Resize a container',
+    reflow: 'Reflow and overflow',
+    source: 'Source',
+    // Components
+    overview: 'Overview',
+    'interactive-example': 'Interactive example',
+    api: 'API',
+    examples: 'Examples',
+    tokens: 'Tokens',
+    'behavior-and-accessibility': 'Behavior and accessibility',
+    guidance: 'Guidance',
+    'known-limitations': 'Known limitations',
+};
+/** `contrast-pairs` → `Contrast pairs` for ids without a built-in title. */
+export function sectionTitle(id) {
+    const known = SECTION_TITLES[id];
+    if (known)
+        return known;
+    const words = id.replace(/-/g, ' ');
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+/** `DemoCounter` → `Demo counter`; `side-nav` → `Side nav`. */
+export function humanize(name) {
+    const words = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[-_]+/g, ' ')
+        .trim()
+        .toLowerCase();
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+//# sourceMappingURL=defaults.js.map

package/dist/pages/defaults.js.map

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

package/dist/pages/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@oddkin/workbench/pages` — the page registry (ADR 0023): one build-time source for routes,
+ * primary navigation, sidebars, overview cards, search, visibility, and legacy redirects.
+ * DOM-free; the M5 shell renders from it.
+ */
+export { buildPageRegistry } from './build.js';
+export type { RegistryInput } from './build.js';
+export { cards, href, onThisPage, primaryNavigation, resolveLegacyRoute, searchEntries, sidebar, staticRedirects, } from './navigation.js';
+export type { RedirectResult } from './navigation.js';
+export { FOUNDATIONS } from './defaults.js';
+export { PAGE_REGISTRY_SCHEMA } from './types.js';
+export type { Availability, CemDeclaration, CemPackage, DocMetaLike, FactLike, FoundationMetaLike, OddkinMetadataLike, PageEntry, PageKind, PageRegistry, SectionEntry, } from './types.js';
+export type { WorkbenchDiagnostic } from '../internal/diagnostics.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,KAAK,EACL,IAAI,EACJ,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,OAAO,EACP,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/pages/index.js

@@ -0,0 +1,10 @@
+/**
+ * `@oddkin/workbench/pages` — the page registry (ADR 0023): one build-time source for routes,
+ * primary navigation, sidebars, overview cards, search, visibility, and legacy redirects.
+ * DOM-free; the M5 shell renders from it.
+ */
+export { buildPageRegistry } from './build.js';
+export { cards, href, onThisPage, primaryNavigation, resolveLegacyRoute, searchEntries, sidebar, staticRedirects, } from './navigation.js';
+export { FOUNDATIONS } from './defaults.js';
+export { PAGE_REGISTRY_SCHEMA } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/pages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EACL,KAAK,EACL,IAAI,EACJ,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,OAAO,EACP,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/pages/navigation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Projections of the registry. Every navigation surface reads from the same registry, so
+ * routes, primary navigation, sidebars, cards, and search cannot drift apart.
+ */
+import type { PageEntry, PageRegistry } from './types.js';
+/** Visible primary navigation entries in configured order. */
+export declare function primaryNavigation(registry: PageRegistry): PageEntry[];
+/** Contextual sidebar for a section, grouped when the section has groups. */
+export declare function sidebar(registry: PageRegistry, section: string): {
+    group: string | undefined;
+    pages: PageEntry[];
+}[];
+/** Overview cards for a section (never Theme Studio). */
+export declare function cards(registry: PageRegistry, section: string): PageEntry[];
+/** Search entries: every visible page that opts into search. */
+export declare function searchEntries(registry: PageRegistry): {
+    id: string;
+    title: string;
+    summary?: string;
+    tags: readonly string[];
+    route: string;
+}[];
+/** "On this page" entries: visible sections, only when there are at least two. */
+export declare function onThisPage(page: PageEntry): {
+    id: string;
+    title: string;
+}[];
+/** URL for a route under the base path, in history or hash mode. */
+export declare function href(registry: PageRegistry, route: string): string;
+export type RedirectResult = {
+    readonly kind: 'redirect';
+    readonly to: string;
+} | {
+    readonly kind: 'notice';
+    readonly code: 'products.disabled';
+};
+/**
+ * Resolve a legacy route (relative to the base path). `/playground?component=<tag>` goes to
+ * that component when it exists, keeping other parameters; `/foundations/products` without
+ * Products and modes gives a notice instead of a redirect.
+ */
+export declare function resolveLegacyRoute(registry: PageRegistry, path: string, search?: string): RedirectResult | undefined;
+/** Static redirect stubs for history-mode builds (meta refresh + canonical link). */
+export declare function staticRedirects(registry: PageRegistry): {
+    from: string;
+    to: string;
+}[];
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/pages/navigation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ1D,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,CAMrE;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CACrB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,EAAE,CAKrD;AAED,yDAAyD;AACzD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAE1E;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,GACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAU3F;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAG3E;AAED,oEAAoE;AACpE,wBAAgB,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,GACV,cAAc,GAAG,SAAS,CAsB5B;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,CAKtF"}

package/dist/pages/navigation.js

@@ -0,0 +1,83 @@
+const byOrder = (pages) => pages
+    .map((page, index) => ({ page, index }))
+    .sort((a, b) => (a.page.order ?? a.index) - (b.page.order ?? b.index) || a.index - b.index)
+    .map((p) => p.page);
+/** Visible primary navigation entries in configured order. */
+export function primaryNavigation(registry) {
+    const byId = new Map(registry.pages.map((p) => [p.id, p]));
+    return registry.primaryNav.flatMap((id) => {
+        const page = byId.get(id);
+        return page?.visible ? [page] : [];
+    });
+}
+/** Contextual sidebar for a section, grouped when the section has groups. */
+export function sidebar(registry, section) {
+    const pages = registry.pages.filter((p) => p.visible && p.nav.sidebar && p.section === section);
+    const groups = new Map();
+    for (const page of pages)
+        groups.set(page.group, [...(groups.get(page.group) ?? []), page]);
+    return [...groups].map(([group, entries]) => ({ group, pages: byOrder(entries) }));
+}
+/** Overview cards for a section (never Theme Studio). */
+export function cards(registry, section) {
+    return byOrder(registry.pages.filter((p) => p.visible && p.nav.card && p.section === section));
+}
+/** Search entries: every visible page that opts into search. */
+export function searchEntries(registry) {
+    return registry.pages
+        .filter((p) => p.visible && p.nav.search)
+        .map((p) => ({
+        id: p.id,
+        title: p.title,
+        ...(p.summary ? { summary: p.summary } : {}),
+        tags: p.tags ?? [],
+        route: p.route,
+    }));
+}
+/** "On this page" entries: visible sections, only when there are at least two. */
+export function onThisPage(page) {
+    const visible = page.sections.filter((s) => s.visible);
+    return visible.length >= 2 ? visible.map(({ id, title }) => ({ id, title })) : [];
+}
+/** URL for a route under the base path, in history or hash mode. */
+export function href(registry, route) {
+    const relative = route.replace(/^\//, '');
+    return registry.routing === 'hash'
+        ? `${registry.basePath}#/${relative}`
+        : `${registry.basePath}${relative}`;
+}
+/**
+ * Resolve a legacy route (relative to the base path). `/playground?component=<tag>` goes to
+ * that component when it exists, keeping other parameters; `/foundations/products` without
+ * Products and modes gives a notice instead of a redirect.
+ */
+export function resolveLegacyRoute(registry, path, search = '') {
+    const params = new URLSearchParams(search);
+    if (path === '/playground') {
+        const tag = params.get('component');
+        const target = tag
+            ? registry.pages.find((p) => p.id === `components/${tag}` && p.visible)
+            : undefined;
+        const owner = registry.pages.find((p) => p.visible && p.legacyRoutes?.includes(path));
+        if (!target && !owner)
+            return undefined;
+        params.delete('component');
+        const rest = params.toString();
+        return { kind: 'redirect', to: `${(target ?? owner)?.route}${rest ? `?${rest}` : ''}` };
+    }
+    const owner = registry.pages.find((p) => p.visible && p.legacyRoutes?.includes(path));
+    if (owner)
+        return { kind: 'redirect', to: `${owner.route}${search}` };
+    if (path === '/foundations/products' &&
+        !registry.pages.some((p) => p.id === 'products' && p.visible)) {
+        return { kind: 'notice', code: 'products.disabled' };
+    }
+    return undefined;
+}
+/** Static redirect stubs for history-mode builds (meta refresh + canonical link). */
+export function staticRedirects(registry) {
+    if (registry.routing !== 'history')
+        return [];
+    return registry.pages.flatMap((p) => p.visible ? (p.legacyRoutes ?? []).map((from) => ({ from, to: p.route })) : []);
+}
+//# sourceMappingURL=navigation.js.map

package/dist/pages/navigation.js.map

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

package/dist/pages/types.d.ts

@@ -0,0 +1,143 @@
+/** Page registry contracts (`page-registry.v1`, ADR 0023, workbench-pages.md §2). */
+export declare const PAGE_REGISTRY_SCHEMA = "https://oddkin.dev/schemas/page-registry/v1.json";
+export type PageKind = 'home' | 'overview' | 'foundation' | 'component' | 'tool' | 'products' | 'guide';
+export type Availability = 'full' | 'partial' | 'unavailable';
+export interface SectionEntry {
+    /** Stable section id; drives "On this page" anchors and authored content keys. */
+    readonly id: string;
+    readonly title: string;
+    readonly visible: boolean;
+    readonly source: 'generated' | 'built-in' | 'authored';
+}
+export interface PageEntry {
+    /** Stable id, e.g. `foundations/spacing`, `components/acme-button`, `theme-studio`. */
+    readonly id: string;
+    /** Relative to the base path, starting with `/`. */
+    readonly route: string;
+    readonly section: string;
+    readonly kind: PageKind;
+    readonly eyebrow?: string;
+    readonly title: string;
+    readonly summary?: string;
+    /** Sidebar and catalog group (component category). */
+    readonly group?: string;
+    readonly tags?: readonly string[];
+    /** ISO date, only from authored content or source history (ADR 0027); never build time. */
+    readonly updated?: string;
+    readonly order?: number;
+    readonly visible: boolean;
+    readonly availability: Availability;
+    /** Where the page appears. All false when the page is not visible. */
+    readonly nav: {
+        readonly primary?: boolean;
+        readonly sidebar?: boolean;
+        readonly card?: boolean;
+        readonly search?: boolean;
+    };
+    readonly sections: readonly SectionEntry[];
+    /** Old routes that redirect here. */
+    readonly legacyRoutes?: readonly string[];
+}
+export interface PageRegistry {
+    readonly schema: typeof PAGE_REGISTRY_SCHEMA;
+    readonly basePath: string;
+    readonly routing: 'history' | 'hash';
+    /** Ordered ids of visible pages shown in primary navigation. */
+    readonly primaryNav: readonly string[];
+    readonly pages: readonly PageEntry[];
+}
+export interface CemDeclaration {
+    readonly kind: string;
+    readonly name: string;
+    readonly customElement?: boolean;
+    readonly tagName?: string;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly members?: readonly {
+        readonly kind: string;
+        readonly name: string;
+        readonly privacy?: string;
+        readonly static?: boolean;
+    }[];
+    readonly attributes?: readonly {
+        readonly name: string;
+    }[];
+    readonly events?: readonly {
+        readonly name: string;
+    }[];
+    readonly slots?: readonly {
+        readonly name: string;
+    }[];
+    readonly cssParts?: readonly {
+        readonly name: string;
+    }[];
+    readonly cssProperties?: readonly {
+        readonly name: string;
+    }[];
+    readonly cssStates?: readonly {
+        readonly name: string;
+    }[];
+}
+/** A Custom Elements Manifest (schema 2.x); only the fields the registry reads. */
+export interface CemPackage {
+    readonly modules: readonly {
+        readonly path: string;
+        readonly declarations?: readonly CemDeclaration[];
+    }[];
+}
+export interface FactLike<T> {
+    readonly value?: T;
+    readonly known?: boolean;
+    readonly provenance: 'extracted' | 'authored' | 'observed' | 'verified';
+}
+export interface FoundationMetaLike {
+    readonly id: string;
+    readonly sections: readonly {
+        readonly id: string;
+        readonly available: boolean;
+        readonly reason?: string;
+    }[];
+    readonly tokens: readonly string[];
+}
+export interface DocMetaLike {
+    readonly title?: FactLike<string>;
+    readonly summary?: FactLike<string>;
+    readonly tags?: readonly string[];
+    readonly updated?: FactLike<string>;
+    readonly order?: number;
+    readonly visible?: boolean;
+}
+/** The oddkin-metadata v1 fields the registry reads. */
+export interface OddkinMetadataLike {
+    readonly library?: {
+        readonly name?: string;
+        readonly prefix?: string;
+    };
+    readonly components?: Readonly<Record<string, {
+        readonly tag: string;
+        readonly category?: string;
+        readonly tokenReads?: readonly unknown[];
+        readonly styleMappings?: readonly unknown[];
+        readonly a11y?: unknown;
+        readonly keyboard?: unknown;
+        readonly limitations?: readonly unknown[];
+    }>>;
+    readonly tokens?: unknown;
+    readonly examples?: Readonly<Record<string, {
+        readonly component: string;
+        readonly name: string;
+        readonly incorrect?: object;
+    }>>;
+    readonly foundations?: Readonly<Record<string, FoundationMetaLike>>;
+    readonly categories?: Readonly<Record<string, {
+        readonly label: string;
+        readonly description?: string;
+        readonly order?: number;
+    }>>;
+    readonly products?: Readonly<Record<string, {
+        readonly id: string;
+        readonly source: string;
+    }>>;
+    readonly docs?: Readonly<Record<string, DocMetaLike>>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/pages/types.js

@@ -0,0 +1,3 @@
+/** Page registry contracts (`page-registry.v1`, ADR 0023, workbench-pages.md §2). */
+export const PAGE_REGISTRY_SCHEMA = 'https://oddkin.dev/schemas/page-registry/v1.json';
+//# sourceMappingURL=types.js.map

package/dist/pages/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pages/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,CAAC,MAAM,oBAAoB,GAAG,kDAAkD,CAAC"}

package/dist/panels/catalog-define.d.ts

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

package/dist/panels/catalog-define.d.ts.map

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

package/dist/panels/catalog-define.js

@@ -0,0 +1,7 @@
+/// <reference path="./catalog.ts" preserve="true" />
+// Registers <oddkin-catalog-panel> and the card element its cards use.
+import '@oddkin/components/define/card';
+import { define } from '@oddkin/core/element';
+import { OddkinCatalogPanel } from './catalog.js';
+define('oddkin-catalog-panel', OddkinCatalogPanel);
+//# sourceMappingURL=catalog-define.js.map

package/dist/panels/catalog-define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-define.js","sourceRoot":"","sources":["../../src/panels/catalog-define.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,uEAAuE;AACvE,OAAO,gCAAgC,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC"}

package/dist/panels/catalog.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `<oddkin-catalog-panel>`: the components catalog (workbench-pages.md §6) as an embeddable
+ * panel: search, category filter, counts, and grouped cards from the page registry. Cards load
+ * no component modules and mount no previews. Filter changes update the panel and dispatch
+ * `oddkin-catalog-filter` so the host can mirror them in its URL.
+ */
+import { OddkinElement } from '@oddkin/core/element';
+import type { WorkbenchIndex } from '../data/types.js';
+import type { StyleInput } from '@oddkin/core/styles';
+export interface CatalogFilterDetail {
+    readonly query: string;
+    readonly category: string;
+}
+declare const OddkinCatalogPanel_base: import("@oddkin/core/element").WithProps<typeof OddkinElement, {
+    readonly index: import("@oddkin/core/element").PropDefinition<WorkbenchIndex | undefined>;
+    readonly href: import("@oddkin/core/element").PropDefinition<(route: string) => string>;
+    readonly query: import("@oddkin/core/element").PropDefinition<string>;
+    readonly category: import("@oddkin/core/element").PropDefinition<string>;
+}>;
+export declare class OddkinCatalogPanel extends OddkinCatalogPanel_base {
+    static styles: StyleInput;
+    protected render(): import("@oddkin/core/template").TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'oddkin-catalog-panel': OddkinCatalogPanel;
+    }
+    interface HTMLElementEventMap {
+        'oddkin-catalog-filter': CustomEvent<CatalogFilterDetail>;
+    }
+}
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/panels/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/panels/catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAQ,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;;;yEAI2B,MAAM,KAAK,MAAM;;;;AAF7C,qBAAa,kBAAmB,SAAQ,uBAgBtC;IACA,OAAgB,MAAM,EAAE,UAAU,CAAoC;IAEtE,UAAmB,MAAM,mDAyBxB;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,sBAAsB,EAAE,kBAAkB,CAAC;KAC5C;IACD,UAAU,mBAAmB;QAC3B,uBAAuB,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAC;KAC3D;CACF"}

package/dist/panels/catalog.js

@@ -0,0 +1,54 @@
+/**
+ * `<oddkin-catalog-panel>`: the components catalog (workbench-pages.md §6) as an embeddable
+ * panel: search, category filter, counts, and grouped cards from the page registry. Cards load
+ * no component modules and mount no previews. Filter changes update the panel and dispatch
+ * `oddkin-catalog-filter` so the host can mirror them in its URL.
+ */
+import { OddkinElement, prop } from '@oddkin/core/element';
+import { html } from '@oddkin/core/template';
+import { overviewBody } from '../app/views.js';
+import { contentStyles, panelHostStyles } from './styles.js';
+export class OddkinCatalogPanel extends OddkinElement.with({
+    index: prop.object({ description: 'The Workbench index.' }),
+    href: prop.custom({
+        default: () => (route) => route,
+        coerce: (value) => typeof value === 'function'
+            ? { ok: true, value: value }
+            : { ok: false, reason: 'expected a function' },
+        description: 'Maps a Workbench route to a URL.',
+    }),
+    query: prop.string({ default: '', attribute: false, description: 'Search text.' }),
+    category: prop.string({
+        default: '',
+        attribute: false,
+        description: "Category label to show; '' shows every category.",
+    }),
+}) {
+    static styles = [panelHostStyles, contentStyles];
+    render() {
+        const index = this.index;
+        const page = index?.registry.pages.find((p) => p.id === 'components');
+        if (!index || !page)
+            return html `<div class="wb-content"></div>`;
+        const ctx = {
+            registry: index.registry,
+            href: (route) => this.href(route),
+            lang: this.ownerDocument.documentElement.lang || 'en',
+            catalog: {
+                query: this.query,
+                category: this.category,
+                update: (query, category) => {
+                    this.query = query;
+                    this.category = category;
+                    this.dispatchEvent(new CustomEvent('oddkin-catalog-filter', {
+                        bubbles: true,
+                        composed: true,
+                        detail: { query, category },
+                    }));
+                },
+            },
+        };
+        return html `<div class="wb-content">${overviewBody(ctx, page)}</div>`;
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/panels/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/panels/catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO7D,MAAM,OAAO,kBAAmB,SAAQ,aAAa,CAAC,IAAI,CAAC;IACzD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAiB,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;IAC3E,IAAI,EAAE,IAAI,CAAC,MAAM,CAA4B;QAC3C,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK;QACvC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAChB,OAAO,KAAK,KAAK,UAAU;YACzB,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAkC,EAAE;YACzD,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE;QAClD,WAAW,EAAE,kCAAkC;KAChD,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;IAClF,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,kDAAkD;KAChE,CAAC;CACH,CAAC;IACA,MAAM,CAAU,MAAM,GAAe,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAEnD,MAAM;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAA,gCAAgC,CAAC;QACjE,MAAM,GAAG,GAAgB;YACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,IAAI,IAAI;YACrD,OAAO,EAAE;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;oBAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;oBACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;oBACzB,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAsB,uBAAuB,EAAE;wBAC5D,OAAO,EAAE,IAAI;wBACb,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;qBAC5B,CAAC,CACH,CAAC;gBACJ,CAAC;aACF;SACF,CAAC;QACF,OAAO,IAAI,CAAA,2BAA2B,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC;IACxE,CAAC;CACF"}

package/dist/panels/component-define.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="component.d.ts" preserve="true" />
+export {};
+//# sourceMappingURL=component-define.d.ts.map

package/dist/panels/component-define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-define.d.ts","sourceRoot":"","sources":["../../src/panels/component-define.ts"],"names":[],"mappings":""}

package/dist/panels/component-define.js

@@ -0,0 +1,6 @@
+/// <reference path="./component.ts" preserve="true" />
+// Registers <oddkin-component-panel>.
+import { define } from '@oddkin/core/element';
+import { OddkinComponentPanel } from './component.js';
+define('oddkin-component-panel', OddkinComponentPanel);
+//# sourceMappingURL=component-define.js.map

package/dist/panels/component-define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-define.js","sourceRoot":"","sources":["../../src/panels/component-define.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,sCAAsC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/panels/component-detail.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Component detail content (workbench-pages.md §7): every section of a component page, with the
+ * editable API table as the only control surface over one isolated preview (or a light/dark
+ * pair). Rendered by the public `<oddkin-component-panel>` (open shadow root) and by the shell
+ * (light DOM, so "On this page" fragments resolve).
+ */
+import { OddkinElement } from '@oddkin/core/element';
+import { type Scope } from '@oddkin/core/scope';
+import type { ComponentPageData, WorkbenchIndex } from '../data/types.js';
+import { type IsolatedPreview } from '../preview/frame.js';
+import { type PreviewState } from './model.js';
+import type { StyleInput } from '@oddkin/core/styles';
+export interface EventLogEntry {
+    readonly id: number;
+    readonly name: string;
+    readonly time: number;
+    readonly bubbles: boolean;
+    readonly composed: boolean;
+    readonly target: string;
+    readonly detail?: string;
+}
+declare const ComponentDetailElement_base: import("@oddkin/core/element").WithProps<typeof OddkinElement, {
+    readonly page: import("@oddkin/core/element").PropDefinition<ComponentPageData | undefined>;
+    readonly index: import("@oddkin/core/element").PropDefinition<WorkbenchIndex | undefined>;
+    readonly href: import("@oddkin/core/element").PropDefinition<(route: string) => string>;
+    readonly frameUrl: import("@oddkin/core/element").PropDefinition<string>;
+}>;
+export declare class ComponentDetailElement extends ComponentDetailElement_base {
+    #private;
+    static styles: StyleInput;
+    constructor();
+    /** Current preview configuration (for tests and embedding); read-only snapshot. */
+    get previewState(): PreviewState;
+    /** Live preview frames, in order (light first when shown side by side). */
+    get previews(): readonly IsolatedPreview[];
+    protected connected(scope: Scope): void;
+    /**
+     * Replace the preview realms with fresh frame documents and mount the current configuration
+     * again. The shell calls this when component code changes (a registration cannot be redefined
+     * in the same realm).
+     */
+    replacePreview(): Promise<void>;
+    protected render(): import("@oddkin/core/template").TemplateResult;
+}
+export {};
+//# sourceMappingURL=component-detail.d.ts.map

package/dist/panels/component-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-detail.d.ts","sourceRoot":"","sources":["../../src/panels/component-detail.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAQ,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAc,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,EAqBL,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;;;;yEAqE2B,MAAM,KAAK,MAAM;;;AAH7C,qBAAa,sBAAuB,SAAQ,2BAgB1C;;IACA,OAAgB,MAAM,EAAE,UAAU,CAAoC;IA4BtE,cAGC;IAED,mFAAmF;IACnF,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,2EAA2E;IAC3E,IAAI,QAAQ,IAAI,SAAS,eAAe,EAAE,CAEzC;IAED,UAAmB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAU/C;IA8QD;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IA6ED,UAAmB,MAAM,mDAkBxB;CA8vBF"}