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

package/dist/examples/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * `@oddkin/workbench/examples` — authored examples, defined once and reused by Workbench,
+ * documentation, browser tests, Theme Studio, and agents (ADR 0021). DOM-free: importing
+ * this entry never touches the DOM; fixtures run only inside preview frames and tests.
+ */
+import type { Scope } from '@oddkin/core';
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+export type { WorkbenchDiagnostic } from '../internal/diagnostics.js';
+type DataKeys<E> = {
+    [K in keyof E]-?: E[K] extends (...args: never[]) => unknown ? never : K;
+}[keyof E];
+/** Public data properties of an element type, excluding those every `HTMLElement` has. */
+export type ElementProps<E> = Partial<Pick<E, Exclude<DataKeys<E>, keyof HTMLElement>>>;
+/** The element type for a tag: from `HTMLElementTagNameMap` when registered there. */
+export type ElementFor<T extends string> = T extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[T] : HTMLElement & {
+    [property: string]: unknown;
+};
+export interface ExampleFixtureContext<E extends Element = Element> {
+    /** Owns listeners, timers, and effects; disposed when the preview or test ends. */
+    readonly scope: Scope;
+    /** The example's element, already created with its props, attributes, and slots. */
+    readonly element: E;
+    /** Render more content into the preview root; returns its first element. */
+    mount(content: unknown): Element;
+}
+/**
+ * Marks an example as a common mistake. It is never offered as a preset or recommendation; it
+ * explains what goes wrong, names the diagnostic `validateUsage` reports for it, and points at
+ * the correct example in the same set.
+ */
+export interface IncorrectUsage {
+    readonly explanation: string;
+    /** Diagnostic code `validateUsage` reports, e.g. `usage.attribute.propertyOnly`. */
+    readonly diagnostic: string;
+    /** Name of the correct example in the same set. */
+    readonly correct: string;
+}
+export interface ExampleDefinition<E extends Element = HTMLElement> {
+    readonly label?: string;
+    /** Property values, checked against the element type (TypeScript) or metadata (checkExamples). */
+    readonly props?: ElementProps<E>;
+    readonly attributes?: Readonly<Record<string, string | null>>;
+    /** Plain-text slot content keyed by slot name; `default` is the default slot. */
+    readonly slots?: Readonly<Record<string, string>>;
+    readonly previewRoles?: readonly string[];
+    /** Offered as a preset on the component page. */
+    readonly preset?: boolean;
+    readonly recommended?: boolean;
+    readonly guidance?: string;
+    /** A common mistake, explained (see `IncorrectUsage`). */
+    readonly incorrect?: IncorrectUsage;
+    /** Owned setup code; runs only in preview frames and tests. */
+    readonly fixture?: (context: ExampleFixtureContext<E>) => void | Promise<void>;
+}
+export interface ExampleSet<E extends Element = HTMLElement> {
+    readonly component: string;
+    readonly examples: Readonly<Record<string, ExampleDefinition<E>>>;
+}
+/**
+ * Define the examples for one component. With TypeScript and a registered tag
+ * (`HTMLElementTagNameMap`), unknown property keys and wrong value types are compile errors.
+ */
+export declare function defineExamples<T extends string>(tag: T, examples: Readonly<Record<string, ExampleDefinition<ElementFor<T>>>>): ExampleSet<ElementFor<T>>;
+export declare const EXAMPLES_SCHEMA = "https://oddkin.dev/schemas/examples/v1.json";
+/** The serializable layer (`examples.v1`); fixtures appear only as `hasFixture`. */
+export interface ExamplesJSON {
+    readonly schema: typeof EXAMPLES_SCHEMA;
+    readonly component: string;
+    readonly examples: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+}
+export declare function toExamplesJSON<E extends Element>(set: ExampleSet<E>): ExamplesJSON;
+/** Example id shared with metadata, docs content, and agents: `example:<tag>/<name>`. */
+export declare const exampleId: (tag: string, name: string) => string;
+/** The parts of a component contract that examples are checked against (e.g. from CEM). */
+export interface ExampleContract {
+    readonly properties?: readonly string[];
+    readonly slots?: readonly string[];
+}
+/**
+ * Check names and, when a contract is given, property keys and slot names. Plain JavaScript
+ * authors get the same checks TypeScript gives at compile time.
+ */
+export declare function checkExamples<E extends Element>(set: ExampleSet<E>, contract?: ExampleContract): WorkbenchDiagnostic[];
+/** What `validateUsage` checks examples against: the published contract of the element. */
+export interface UsageContract {
+    /** Public writable properties; `attribute` is absent for property-only ones (`.items`). */
+    readonly properties: readonly {
+        name: string;
+        type?: string | undefined;
+        attribute?: string | undefined;
+    }[];
+    readonly slots: readonly string[];
+}
+/**
+ * Diagnostics for how each example uses the element, from its published contract: rich data
+ * written as an attribute, `"false"` on a boolean attribute, values outside an enum, unknown
+ * attributes, and unknown slots. Correct examples produce none; an incorrect example produces
+ * the diagnostic it declares.
+ */
+export declare function validateUsage<E extends Element>(set: ExampleSet<E>, contract: UsageContract): WorkbenchDiagnostic[];
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/examples/index.js

@@ -0,0 +1,106 @@
+import { DiagnosticList } from '../internal/diagnostics.js';
+/**
+ * Define the examples for one component. With TypeScript and a registered tag
+ * (`HTMLElementTagNameMap`), unknown property keys and wrong value types are compile errors.
+ */
+export function defineExamples(tag, examples) {
+    return Object.freeze({ component: tag, examples: Object.freeze({ ...examples }) });
+}
+export const EXAMPLES_SCHEMA = 'https://oddkin.dev/schemas/examples/v1.json';
+export function toExamplesJSON(set) {
+    const examples = {};
+    for (const [name, example] of Object.entries(set.examples)) {
+        const { fixture, ...rest } = example;
+        examples[name] = {
+            ...JSON.parse(JSON.stringify(rest)),
+            ...(fixture ? { hasFixture: true } : {}),
+        };
+    }
+    return { schema: EXAMPLES_SCHEMA, component: set.component, examples };
+}
+/** Example id shared with metadata, docs content, and agents: `example:<tag>/<name>`. */
+export const exampleId = (tag, name) => `example:${tag}/${name}`;
+const TAG = /^[a-z][a-z0-9]*(-[a-z0-9]+)+$/;
+const NAME = /^[a-zA-Z][a-zA-Z0-9-]*$/;
+/**
+ * Check names and, when a contract is given, property keys and slot names. Plain JavaScript
+ * authors get the same checks TypeScript gives at compile time.
+ */
+export function checkExamples(set, contract) {
+    const out = new DiagnosticList();
+    if (!TAG.test(set.component)) {
+        out.error('examples.component.invalid', `"${set.component}" is not a valid custom element name.`, '/component');
+    }
+    const properties = contract?.properties ? new Set(contract.properties) : undefined;
+    const slots = contract?.slots ? new Set(contract.slots.map((s) => s || 'default')) : undefined;
+    for (const [name, example] of Object.entries(set.examples)) {
+        const path = `/examples/${name}`;
+        if (!NAME.test(name)) {
+            out.error('examples.name.invalid', `Example name "${name}" must start with a letter and use letters, digits, and hyphens.`, path);
+        }
+        // An incorrect example breaks the contract on purpose; validateUsage reports how.
+        const checked = example.incorrect ? {} : example;
+        for (const key of Object.keys(checked.props ?? {})) {
+            if (properties && !properties.has(key)) {
+                out.error('examples.prop.unknown', `<${set.component}> has no public property "${key}" (example "${name}").`, `${path}/props/${key}`);
+            }
+        }
+        for (const slot of Object.keys(checked.slots ?? {})) {
+            if (slots && !slots.has(slot)) {
+                out.error('examples.slot.unknown', `<${set.component}> declares no slot "${slot}" (example "${name}").`, `${path}/slots/${slot}`);
+            }
+        }
+        const incorrect = example.incorrect;
+        if (incorrect) {
+            const correct = set.examples[incorrect.correct];
+            if (!correct || correct.incorrect)
+                out.error('examples.incorrect.correct', `Incorrect example "${name}" must name a correct example of <${set.component}>, not "${incorrect.correct}".`, `${path}/incorrect/correct`);
+            if (!incorrect.explanation.trim() || !/^[a-z]+(\.[a-zA-Z-]+)+$/.test(incorrect.diagnostic))
+                out.error('examples.incorrect.explanation', `Incorrect example "${name}" needs an explanation and a diagnostic code.`, `${path}/incorrect`);
+            if (example.preset || example.recommended || example.previewRoles?.length)
+                out.error('examples.incorrect.recommended', `Incorrect example "${name}" cannot be a preset, a recommendation, or a preview role.`, path);
+        }
+    }
+    return out.items;
+}
+// Attributes every element accepts.
+const GLOBAL_ATTRIBUTE = /^(?:id|class|style|slot|part|lang|dir|title|hidden|inert|tabindex|role|autofocus|exportparts|data-.+|aria-.+)$/;
+const unionOf = (type) => type && /^"[^"]*"( \| "[^"]*")*$/.test(type)
+    ? [...type.matchAll(/"([^"]*)"/g)].map((m) => m[1])
+    : undefined;
+/**
+ * Diagnostics for how each example uses the element, from its published contract: rich data
+ * written as an attribute, `"false"` on a boolean attribute, values outside an enum, unknown
+ * attributes, and unknown slots. Correct examples produce none; an incorrect example produces
+ * the diagnostic it declares.
+ */
+export function validateUsage(set, contract) {
+    const out = new DiagnosticList();
+    const byAttribute = new Map(contract.properties.filter((p) => p.attribute).map((p) => [p.attribute, p]));
+    const slots = new Set(contract.slots.map((s) => s || 'default'));
+    const tag = set.component;
+    for (const [name, example] of Object.entries(set.examples)) {
+        const path = `/examples/${name}`;
+        for (const [attribute, value] of Object.entries(example.attributes ?? {})) {
+            const at = `${path}/attributes/${attribute}`;
+            const property = byAttribute.get(attribute);
+            const named = contract.properties.find((p) => p.name === attribute);
+            if (!property && named && !named.attribute)
+                out.error('usage.attribute.propertyOnly', `<${tag}> reads "${attribute}" only as a property; set .${attribute} with a value, not an attribute string.`, at);
+            else if (!property && !GLOBAL_ATTRIBUTE.test(attribute))
+                out.error('usage.attribute.unknown', `<${tag}> has no attribute "${attribute}"${named ? `; use "${named.attribute}"` : ''}.`, at);
+            else if (property?.type === 'boolean' && value === 'false')
+                out.error('usage.boolean.false', `[${attribute}="false"] still turns ${property.name} on: the attribute's presence means true. Remove the attribute instead.`, at);
+            else {
+                const allowed = unionOf(property?.type);
+                if (value !== null && allowed && !allowed.includes(value))
+                    out.error('usage.attribute.value', `<${tag}> ${attribute}="${value}" is not one of ${allowed.join(', ')}; the default is used.`, at);
+            }
+        }
+        for (const slot of Object.keys(example.slots ?? {}))
+            if (!slots.has(slot))
+                out.error('usage.slot.unknown', `<${tag}> declares no slot "${slot}"; the content is not shown.`, `${path}/slots/${slot}`);
+    }
+    return out.items;
+}
+//# sourceMappingURL=index.js.map

package/dist/examples/index.js.map

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

package/dist/frame/index.d.ts

@@ -0,0 +1,9 @@
+import { type JsonValue } from '../protocol/index.js';
+/**
+ * A plain-JSON summary of an event detail: cycles, DOM nodes, functions, `Map`/`Set`, errors,
+ * and class instances are described rather than transferred, and the result is size-capped.
+ */
+export declare function summarizeDetail(value: unknown): JsonValue;
+/** Install the runtime on a frame's own Window. Exported for controlled browser tests. */
+export declare function installFrameRuntime(win?: Window): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/frame/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAYL,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAsN9B;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAuDzD;AA4GD,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAe,GAAG,IAAI,CAmG9D"}