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

package/dist/conformance/button.js

@@ -0,0 +1,233 @@
+/**
+ * Conformance suite for the `odd-button` foundation contract. Implementation-agnostic: it
+ * reaches the element only through its tag, public properties, native events, and the
+ * documented `control` anatomy role (a native, focusable `<button>`).
+ */
+import { defineConformance } from './index.js';
+const control = (ctx, host) => {
+    const part = ctx.adapter.part(host, 'control');
+    ctx.expect(part !== null, 'the implementation exposes its control').toBe(true);
+    return part;
+};
+const countClicks = (host) => {
+    const counter = { count: 0 };
+    host.addEventListener('click', () => counter.count++);
+    return counter;
+};
+export const buttonConformance = defineConformance({
+    id: 'oddkin.button',
+    version: '0.1.0',
+    contract: { component: 'component:odd-button', versions: '0.x' },
+    description: 'Interaction contract shared by odd-button and its product implementations.',
+    requires: {
+        properties: [
+            'appearance',
+            'size',
+            'type',
+            'disabled',
+            'loading',
+            'fullWidth',
+            'name',
+            'value',
+            'label',
+        ],
+        events: ['click'],
+        slots: ['', 'start', 'end'],
+        anatomy: ['control'],
+    },
+    cases: [
+        {
+            id: 'properties-attributes',
+            title: 'Attributes convert to properties; boolean and enum state reflects',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = (await ctx.mount({
+                    attributes: { appearance: 'primary', 'full-width': '' },
+                    content: 'Go',
+                }));
+                ctx.expect(host['appearance']).toBe('primary');
+                ctx.expect(host['fullWidth']).toBe(true);
+                host['disabled'] = true;
+                host['size'] = 'lg';
+                await ctx.adapter.settle(host);
+                ctx.expect(host.hasAttribute('disabled')).toBe(true);
+                ctx.expect(host.getAttribute('size')).toBe('lg');
+            },
+        },
+        {
+            id: 'native-control',
+            title: 'The control is a native button and the default slot names it',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = await ctx.mount({ content: 'Save' });
+                const part = control(ctx, host);
+                ctx.expect(part.localName).toBe('button');
+                ctx.expect(part.type).toBe('button');
+            },
+        },
+        {
+            id: 'keyboard-activation',
+            title: 'Click, Enter, and Space each dispatch one click at the host',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = await ctx.mount({ content: 'Save' });
+                const clicks = countClicks(host);
+                await ctx.user.click(host);
+                host.focus();
+                await ctx.user.keyboard('{Enter}');
+                await ctx.user.keyboard(' ');
+                ctx.expect(clicks.count).toBe(3);
+            },
+        },
+        {
+            id: 'focus',
+            title: 'Focusing the host focuses the control',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = await ctx.mount({ content: 'Save' });
+                host.focus();
+                const active = host.shadowRoot?.activeElement ?? document.activeElement;
+                ctx.expect(active).toBe(control(ctx, host));
+            },
+        },
+        {
+            id: 'disabled',
+            title: 'Disabled ignores activation and is not focusable',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = await ctx.mount({ attributes: { disabled: '' }, content: 'Save' });
+                const clicks = countClicks(host);
+                host.click();
+                control(ctx, host).click();
+                host.focus();
+                ctx.expect(clicks.count).toBe(0);
+                ctx.expect(host.shadowRoot?.activeElement ?? null).toBe(null);
+            },
+        },
+        {
+            id: 'loading',
+            title: 'Loading ignores activation but stays focusable and exposes aria-disabled',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = await ctx.mount({ attributes: { loading: '' }, content: 'Save' });
+                const clicks = countClicks(host);
+                host.focus();
+                await ctx.user.keyboard('{Enter}');
+                host.click();
+                ctx.expect(clicks.count).toBe(0);
+                ctx.expect(host.shadowRoot?.activeElement).toBe(control(ctx, host));
+                ctx.expect(control(ctx, host).getAttribute('aria-disabled')).toBe('true');
+            },
+        },
+        {
+            id: 'form-submission',
+            title: 'type="submit" submits its form once, including name and value',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = await ctx.mount({
+                    attributes: { type: 'submit', name: 'intent', value: 'save' },
+                    content: 'Save',
+                    within: '<form><input name="q" value="a">{{element}}</form>',
+                });
+                const form = host.closest('form');
+                const submitted = [];
+                form.addEventListener('submit', (event) => {
+                    event.preventDefault();
+                    submitted.push([...new FormData(form, event.submitter)]);
+                });
+                await ctx.user.click(host);
+                await ctx.nextTask();
+                ctx.expect(submitted).toEqual([
+                    [
+                        ['q', 'a'],
+                        ['intent', 'save'],
+                    ],
+                ]);
+            },
+        },
+        {
+            id: 'cancelled-click',
+            title: 'A cancelled click does not submit',
+            kind: 'assertion',
+            async run(ctx) {
+                const host = await ctx.mount({
+                    attributes: { type: 'submit' },
+                    content: 'Save',
+                    within: '<form>{{element}}</form>',
+                });
+                let submits = 0;
+                host.closest('form').addEventListener('submit', (event) => {
+                    event.preventDefault();
+                    submits++;
+                });
+                host.addEventListener('click', (event) => event.preventDefault());
+                await ctx.user.click(host);
+                await ctx.nextTask();
+                ctx.expect(submits).toBe(0);
+            },
+        },
+        {
+            id: 'reconnect',
+            title: 'Reconnecting neither leaks owned work nor duplicates activation',
+            kind: 'invariant',
+            change: 'reconnect',
+            async run(ctx) {
+                const host = await ctx.mount({
+                    attributes: { type: 'submit' },
+                    content: 'Save',
+                    within: '<form>{{element}}</form>',
+                });
+                const form = host.closest('form');
+                const parent = host.parentNode;
+                const before = ctx.ownedWork();
+                for (let i = 0; i < 5; i++) {
+                    host.remove();
+                    parent.append(host);
+                    await ctx.adapter.settle(host);
+                }
+                ctx.expect(ctx.ownedWork()).toEqual(before);
+                let submits = 0;
+                form.addEventListener('submit', (event) => {
+                    event.preventDefault();
+                    submits++;
+                });
+                await ctx.user.click(host);
+                await ctx.nextTask();
+                ctx.expect(submits).toBe(1);
+            },
+        },
+        {
+            id: 'programmatic-updates',
+            title: 'Programmatic property changes dispatch no user-intent events',
+            kind: 'invariant',
+            change: 'programmatic',
+            async run(ctx) {
+                const host = (await ctx.mount({ content: 'Save' }));
+                const events = [];
+                for (const type of ['click', 'input', 'change'])
+                    host.addEventListener(type, () => events.push(type));
+                host['appearance'] = 'ghost';
+                host['value'] = 'x';
+                host['loading'] = true;
+                host['disabled'] = true;
+                await ctx.adapter.settle(host);
+                ctx.expect(events).toEqual([]);
+            },
+        },
+        {
+            id: 'theme-value',
+            title: 'A theme-value change keeps the control node and applies',
+            kind: 'invariant',
+            change: 'theme-value',
+            async run(ctx) {
+                const host = await ctx.mount({ content: 'Save' });
+                const before = control(ctx, host);
+                host.parentElement.style.setProperty('--odd-button-radius', '0px');
+                await ctx.adapter.settle(host);
+                ctx.expect(control(ctx, host)).toBe(before);
+                ctx.expect(getComputedStyle(before).borderTopLeftRadius).toBe('0px');
+            },
+        },
+    ],
+});
+//# sourceMappingURL=button.js.map

package/dist/conformance/button.js.map

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

package/dist/conformance/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * `@oddkin/workbench/conformance` — portable conformance suites (conformance.v1). DOM-free at
+ * import: suites are data plus case functions that touch the DOM only when a runner calls them.
+ * Contract: docs/architecture/change-impact-and-verification.md §3; ADR 0034.
+ */
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+/** Declared changes an invariant is about. Identity invariants apply only to value changes. */
+export type ChangeKind = 'theme-value' | 'density' | 'programmatic' | 'keyed-reorder' | 'reconnect' | 'invalid-draft';
+/** The subset of a test runner's `expect` that suites use (Vitest and Jest compatible). */
+export interface Matchers {
+    toBe(expected: unknown): void;
+    toEqual(expected: unknown): void;
+    toBeGreaterThan(expected: number): void;
+    toContain(expected: unknown): void;
+}
+export type Expect = (actual: unknown, message?: string) => Matchers;
+/** Real user input from the project's browser runner (e.g. Vitest's `userEvent`). */
+export interface UserInput {
+    click(element: Element): Promise<unknown>;
+    keyboard(text: string): Promise<unknown>;
+}
+/** Locates documented anatomy roles in an implementation. */
+export interface Adapter {
+    /** The element that plays `role` (e.g. `control`), or null if absent. */
+    part(host: HTMLElement, role: string): HTMLElement | null;
+    /** Resolve once pending updates are committed. */
+    settle(host: HTMLElement): Promise<void>;
+}
+export interface MountOptions {
+    readonly attributes?: Readonly<Record<string, string>>;
+    readonly content?: string;
+    /** Markup to place the element in; `{{element}}` marks its position, e.g. inside a form. */
+    readonly within?: string;
+}
+export interface ConformanceContext {
+    /** Tag name of the implementation under test. */
+    readonly tag: string;
+    readonly expect: Expect;
+    readonly user: UserInput;
+    readonly adapter: Adapter;
+    /** Mount the implementation in a fresh container owned by this case. */
+    mount(options?: MountOptions): Promise<HTMLElement>;
+    /** Live counts of owned work (`scopeStats()` from `@oddkin/core/scope`). */
+    ownedWork(): Readonly<Record<string, number>>;
+    /** Resolve after the current task, letting deferred default actions run. */
+    nextTask(): Promise<void>;
+}
+export interface ConformanceCase {
+    readonly id: string;
+    readonly title: string;
+    readonly kind: 'assertion' | 'invariant';
+    /** For invariants: the declared change that must preserve the asserted relationship. */
+    readonly change?: ChangeKind;
+    readonly run: (context: ConformanceContext) => Promise<void> | void;
+}
+export interface ConformanceSuite {
+    /** Stable suite id, e.g. `oddkin.button`. */
+    readonly id: string;
+    /** Suite version (semver), tied to the contract version range below. */
+    readonly version: string;
+    /** The foundation contract verified: a component id and the versions it targets. */
+    readonly contract: {
+        readonly component: string;
+        readonly versions: string;
+    };
+    readonly description?: string;
+    /** Public capabilities an implementation must provide. */
+    readonly requires: {
+        readonly properties?: readonly string[];
+        readonly events?: readonly string[];
+        readonly slots?: readonly string[];
+        readonly anatomy?: readonly string[];
+    };
+    readonly cases: readonly ConformanceCase[];
+}
+/** Freeze a suite. Use `checkConformance` (or a test) to validate it. */
+export declare function defineConformance(suite: ConformanceSuite): ConformanceSuite;
+/** Structural problems in a suite, as diagnostics with JSON-pointer paths. */
+export declare function checkConformance(suite: ConformanceSuite): WorkbenchDiagnostic[];
+/** The serializable `conformance.v1` description of a suite (no functions). */
+export declare function toConformanceJSON(suite: ConformanceSuite): Record<string, unknown>;
+/** One case outcome. Untested cases are `not-executed`, never `passed`. */
+export interface CaseResult {
+    readonly case: string;
+    readonly state: 'passed' | 'failed' | 'not-executed';
+    readonly message?: string;
+}
+/** A `conformance-result.v1` record: evidence for one implementation, configuration, and browser. */
+export interface ConformanceResult {
+    readonly schema: 'https://oddkin.dev/schemas/conformance-result/v1.json';
+    readonly suite: {
+        readonly id: string;
+        readonly version: string;
+    };
+    readonly implementation: {
+        readonly tag: string;
+        readonly package?: string;
+        readonly definition?: string;
+    };
+    readonly configuration: Readonly<Record<string, string>>;
+    readonly environment: {
+        readonly userAgent: string;
+    };
+    readonly date: string;
+    readonly results: readonly CaseResult[];
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/conformance/index.js

@@ -0,0 +1,60 @@
+/**
+ * `@oddkin/workbench/conformance` — portable conformance suites (conformance.v1). DOM-free at
+ * import: suites are data plus case functions that touch the DOM only when a runner calls them.
+ * Contract: docs/architecture/change-impact-and-verification.md §3; ADR 0034.
+ */
+import { DiagnosticList } from '../internal/diagnostics.js';
+const CHANGES = [
+    'theme-value',
+    'density',
+    'programmatic',
+    'keyed-reorder',
+    'reconnect',
+    'invalid-draft',
+];
+/** Freeze a suite. Use `checkConformance` (or a test) to validate it. */
+export function defineConformance(suite) {
+    return Object.freeze({ ...suite, cases: Object.freeze([...suite.cases]) });
+}
+/** Structural problems in a suite, as diagnostics with JSON-pointer paths. */
+export function checkConformance(suite) {
+    const out = new DiagnosticList();
+    if (!/^[a-z][\w.-]*$/.test(suite.id))
+        out.error('conformance.id.invalid', `Suite id "${suite.id}" must be a lowercase id.`, '/id');
+    if (!/^\d+\.\d+\.\d+/.test(suite.version))
+        out.error('conformance.version.invalid', 'Suite version must be semver.', '/version');
+    if (!/^component:[a-z][\w.]*-[\w.-]*$/.test(suite.contract.component))
+        out.error('conformance.contract.invalid', 'Use a component id such as "component:odd-button".', '/contract/component');
+    if (!suite.cases.length)
+        out.error('conformance.cases.empty', 'A suite needs cases.', '/cases');
+    const seen = new Set();
+    suite.cases.forEach((c, index) => {
+        const path = `/cases/${index}`;
+        if (seen.has(c.id))
+            out.error('conformance.case.duplicate', `Case "${c.id}" repeats.`, path);
+        seen.add(c.id);
+        if (c.kind === 'invariant' && !(c.change && CHANGES.includes(c.change)))
+            out.error('conformance.invariant.change', `Invariant "${c.id}" must name a change.`, path);
+        if (c.kind === 'assertion' && c.change)
+            out.error('conformance.assertion.change', `Assertion "${c.id}" names a change.`, path);
+    });
+    return out.items;
+}
+/** The serializable `conformance.v1` description of a suite (no functions). */
+export function toConformanceJSON(suite) {
+    return {
+        schema: 'https://oddkin.dev/schemas/conformance/v1.json',
+        id: suite.id,
+        version: suite.version,
+        contract: { ...suite.contract },
+        ...(suite.description ? { description: suite.description } : {}),
+        requires: { ...suite.requires },
+        cases: suite.cases.map((c) => ({
+            id: c.id,
+            title: c.title,
+            kind: c.kind,
+            ...(c.change ? { change: c.change } : {}),
+        })),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/conformance/index.js.map

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

package/dist/data/build.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Build the Workbench data files from analyzer outputs, configuration, authored content, and the
+ * token inspection the foundations reference (workbench.md §2.1). Pure and deterministic: the same
+ * inputs give the same files, and no build time enters them.
+ */
+import { type DocsContent, type ResolvedWorkbenchConfig, type WorkbenchConfig } from '../config/index.js';
+import { type WorkbenchDiagnostic } from '../internal/diagnostics.js';
+import { type ThemeStudioInput } from './theme-studio.js';
+import { type LibraryInput, type PageData, type TokenInspectionLike, type WorkbenchData, type WorkbenchIndex } from './types.js';
+export type { ThemeStudioInput } from './theme-studio.js';
+export interface WorkbenchDataInput {
+    readonly config: WorkbenchConfig | ResolvedWorkbenchConfig;
+    /** The documented packages, in configuration order. */
+    readonly libraries: readonly LibraryInput[];
+    /** Authored content (`oddkin.docs.ts`). */
+    readonly docs?: DocsContent;
+    /** The token inspection the foundations reference (their `generation` source). */
+    readonly tokens?: TokenInspectionLike;
+    /** Theme Studio's baseline configuration and generator, loaded by dev tooling. */
+    readonly theme?: ThemeStudioInput;
+    /** Diagnostics from reading these inputs; reported first, with the data's own. */
+    readonly diagnostics?: readonly WorkbenchDiagnostic[];
+}
+/** The data file of a page, relative to the index: `pages/components/odd-button.json`. */
+export declare function pageFile(id: string): string;
+/**
+ * Build the index and the visible pages' data. `data` is undefined only when the configuration
+ * is invalid; every other problem is a diagnostic and leaves the affected value unknown.
+ */
+export declare function buildWorkbenchData(input: WorkbenchDataInput): {
+    data: WorkbenchData | undefined;
+    diagnostics: WorkbenchDiagnostic[];
+};
+/** Serialize a data file: two-space JSON with a final newline, so output is byte-stable. */
+export declare function serializeData(value: WorkbenchIndex | PageData): string;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/data/build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIhG,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,uBAAuB,CAAC;IAC3D,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvD;AAKD,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAkLD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG;IAC7D,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CA2FA;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,QAAQ,GAAG,MAAM,CAEtE"}