@rezi-ui/core 0.1.0-alpha.7 → 0.1.0-alpha.71

package/dist/testing/semanticScenario.js

@@ -0,0 +1,347 @@
+import { createApp } from "../app/createApp.js";
+import { ZR_KEY_BACKSPACE, ZR_KEY_DELETE, ZR_KEY_DOWN, ZR_KEY_END, ZR_KEY_ENTER, ZR_KEY_ESCAPE, ZR_KEY_F1, ZR_KEY_F2, ZR_KEY_F3, ZR_KEY_F4, ZR_KEY_F5, ZR_KEY_F6, ZR_KEY_F7, ZR_KEY_F8, ZR_KEY_F9, ZR_KEY_F10, ZR_KEY_F11, ZR_KEY_F12, ZR_KEY_HOME, ZR_KEY_LEFT, ZR_KEY_PAGE_DOWN, ZR_KEY_PAGE_UP, ZR_KEY_RIGHT, ZR_KEY_SPACE, ZR_KEY_TAB, ZR_KEY_UP, ZR_MOD_ALT, ZR_MOD_CTRL, ZR_MOD_META, ZR_MOD_SHIFT, charToKeyCode, } from "../keybindings/keyCodes.js";
+import { DEFAULT_TERMINAL_CAPS } from "../terminalCaps.js";
+import { defaultTheme } from "../theme/defaultTheme.js";
+import { evaluateScenarioResult } from "./assertions.js";
+import { encodeZrevBatchV1 } from "./events.js";
+import { createTestRenderer } from "./renderer.js";
+import { createScenarioScreenSnapshot, } from "./scenario.js";
+// The harness batches a bounded number of microtask turns after each injected
+// event so async widget state settles deterministically without open-ended spins.
+function flushMicrotasks(count = 20) {
+    let promise = Promise.resolve();
+    for (let i = 0; i < count; i++) {
+        promise = promise.then(() => Promise.resolve());
+    }
+    return promise;
+}
+function colorModeToCapsColor(mode) {
+    if (mode === "16")
+        return 1;
+    if (mode === "256")
+        return 2;
+    if (mode === "truecolor")
+        return 3;
+    return 0;
+}
+function toTerminalCaps(profile) {
+    return Object.freeze({
+        ...DEFAULT_TERMINAL_CAPS,
+        colorMode: colorModeToCapsColor(profile.colorMode),
+        supportsMouse: profile.supportsMouse,
+        supportsBracketedPaste: profile.supportsBracketedPaste,
+        supportsFocusEvents: profile.supportsFocusEvents,
+        supportsOsc52: profile.supportsOsc52,
+        supportsCursorShape: true,
+    });
+}
+class SemanticHarnessBackend {
+    #caps;
+    #waiters = [];
+    #buffered = [];
+    constructor(caps) {
+        this.#caps = caps;
+    }
+    start() {
+        return Promise.resolve();
+    }
+    stop() {
+        return Promise.resolve();
+    }
+    dispose() { }
+    requestFrame(_drawlist) {
+        return Promise.resolve();
+    }
+    pollEvents() {
+        const next = this.#buffered.shift();
+        if (next)
+            return Promise.resolve(next);
+        return new Promise((resolve) => {
+            this.#waiters.push(resolve);
+        });
+    }
+    postUserEvent(_tag, _payload) { }
+    getCaps() {
+        return Promise.resolve(this.#caps);
+    }
+    pushBytes(bytes) {
+        const batch = {
+            bytes,
+            droppedBatches: 0,
+            release: () => { },
+        };
+        const waiter = this.#waiters.shift();
+        if (waiter) {
+            waiter(batch);
+            return;
+        }
+        this.#buffered.push(batch);
+    }
+}
+function keyNameToCode(key) {
+    if (typeof key === "number")
+        return key;
+    const normalized = key.trim().toLowerCase();
+    if (normalized.length === 1)
+        return charToKeyCode(normalized) ?? 0;
+    const functionKey = /^f(\d{1,2})$/u.exec(normalized);
+    if (functionKey) {
+        const functionKeyCodes = [
+            ZR_KEY_F1,
+            ZR_KEY_F2,
+            ZR_KEY_F3,
+            ZR_KEY_F4,
+            ZR_KEY_F5,
+            ZR_KEY_F6,
+            ZR_KEY_F7,
+            ZR_KEY_F8,
+            ZR_KEY_F9,
+            ZR_KEY_F10,
+            ZR_KEY_F11,
+            ZR_KEY_F12,
+        ];
+        const index = Number(functionKey[1]) - 1;
+        const code = functionKeyCodes[index];
+        if (code !== undefined)
+            return code;
+    }
+    switch (normalized) {
+        case "enter":
+        case "return":
+            return ZR_KEY_ENTER;
+        case "escape":
+        case "esc":
+            return ZR_KEY_ESCAPE;
+        case "tab":
+            return ZR_KEY_TAB;
+        case "space":
+            return ZR_KEY_SPACE;
+        case "backspace":
+            return ZR_KEY_BACKSPACE;
+        case "delete":
+        case "del":
+            return ZR_KEY_DELETE;
+        case "home":
+            return ZR_KEY_HOME;
+        case "end":
+            return ZR_KEY_END;
+        case "pageup":
+            return ZR_KEY_PAGE_UP;
+        case "pagedown":
+            return ZR_KEY_PAGE_DOWN;
+        case "left":
+            return ZR_KEY_LEFT;
+        case "right":
+            return ZR_KEY_RIGHT;
+        case "up":
+            return ZR_KEY_UP;
+        case "down":
+            return ZR_KEY_DOWN;
+        default:
+            throw new Error(`Unsupported semantic scenario key ${JSON.stringify(key)}`);
+    }
+}
+function keyModsToMask(mods) {
+    let mask = 0;
+    for (const mod of mods ?? []) {
+        if (mod === "shift")
+            mask |= ZR_MOD_SHIFT;
+        else if (mod === "ctrl")
+            mask |= ZR_MOD_CTRL;
+        else if (mod === "alt")
+            mask |= ZR_MOD_ALT;
+        else if (mod === "meta")
+            mask |= ZR_MOD_META;
+    }
+    return mask;
+}
+function eventToZrevEvents(event) {
+    switch (event.kind) {
+        case "text":
+            return Object.freeze(Array.from(event.text).map((glyph) => ({
+                kind: "text",
+                timeMs: 1,
+                codepoint: glyph.codePointAt(0) ?? 0,
+            })));
+        case "paste":
+            return Object.freeze([
+                {
+                    kind: "paste",
+                    timeMs: 1,
+                    bytes: new TextEncoder().encode(event.text),
+                },
+            ]);
+        case "resize":
+            return Object.freeze([
+                {
+                    kind: "resize",
+                    timeMs: 1,
+                    cols: event.cols,
+                    rows: event.rows,
+                },
+            ]);
+        case "terminalBytes":
+            throw new Error("Semantic scenarios do not support terminalBytes input");
+        case "key":
+            return Object.freeze([
+                {
+                    kind: "key",
+                    timeMs: 1,
+                    key: keyNameToCode(event.key),
+                    mods: keyModsToMask(event.mods),
+                    action: "down",
+                },
+            ]);
+    }
+}
+function focusIdFromBreadcrumbs(snapshot) {
+    return snapshot === null ? null : snapshot.focus.focusedId;
+}
+function asCursorSnapshot(snapshot) {
+    if (snapshot === null || snapshot.cursor === null)
+        return null;
+    if (snapshot.cursor.visible) {
+        return Object.freeze({
+            visible: true,
+            x: snapshot.cursor.x,
+            y: snapshot.cursor.y,
+            shape: snapshot.cursor.shape,
+            blink: snapshot.cursor.blink,
+        });
+    }
+    return Object.freeze({
+        visible: false,
+        shape: snapshot.cursor.shape,
+        blink: snapshot.cursor.blink,
+    });
+}
+export async function runSemanticScenario(opts) {
+    if (opts.scenario.scriptedInput.some((step) => step.event.kind === "terminalBytes")) {
+        return Object.freeze({
+            mode: "semantic",
+            status: "FAIL",
+            pass: false,
+            actions: Object.freeze([]),
+            steps: Object.freeze([]),
+            finalScreen: createScenarioScreenSnapshot(opts.scenario.viewport, ""),
+            finalCursor: null,
+            mismatches: Object.freeze([
+                Object.freeze({
+                    code: "ZR_SCENARIO_UNSUPPORTED",
+                    path: "scriptedInput",
+                    detail: "Semantic scenarios do not support terminalBytes input; use PTY mode",
+                }),
+            ]),
+        });
+    }
+    const fixture = opts.createFixture();
+    const backend = new SemanticHarnessBackend(toTerminalCaps(opts.scenario.capabilityProfile));
+    let latestState = fixture.initialState;
+    let latestBreadcrumbs = null;
+    const actions = [];
+    const fatal = [];
+    const runtimeApp = createApp({
+        backend,
+        initialState: fixture.initialState,
+        config: {
+            internal_onRender: (metrics) => {
+                const breadcrumbs = metrics.runtimeBreadcrumbs;
+                if (breadcrumbs)
+                    latestBreadcrumbs = breadcrumbs;
+            },
+        },
+    });
+    fixture.setup?.(runtimeApp);
+    runtimeApp.onEvent((event) => {
+        if (event.kind === "action")
+            actions.push(event);
+        if (event.kind === "fatal")
+            fatal.push({ code: event.code, detail: event.detail });
+    });
+    runtimeApp.view((state) => {
+        latestState = state;
+        return fixture.view(state);
+    });
+    const renderer = createTestRenderer({
+        viewport: opts.scenario.viewport,
+        theme: fixture.theme ?? defaultTheme.definition,
+    });
+    let currentViewport = { ...opts.scenario.viewport };
+    const steps = [];
+    try {
+        await runtimeApp.start();
+        backend.pushBytes(encodeZrevBatchV1({
+            events: [
+                {
+                    kind: "resize",
+                    timeMs: 0,
+                    cols: currentViewport.cols,
+                    rows: currentViewport.rows,
+                },
+            ],
+        }));
+        await flushMicrotasks();
+        for (let index = 0; index < opts.scenario.scriptedInput.length; index++) {
+            const step = opts.scenario.scriptedInput[index];
+            if (step === undefined)
+                continue;
+            const events = eventToZrevEvents(step.event);
+            if (step.event.kind === "resize") {
+                currentViewport = { cols: step.event.cols, rows: step.event.rows };
+            }
+            backend.pushBytes(encodeZrevBatchV1({ events }));
+            await flushMicrotasks();
+            const focusedId = focusIdFromBreadcrumbs(latestBreadcrumbs);
+            const screenRender = renderer.render(fixture.view(latestState), {
+                viewport: currentViewport,
+                theme: fixture.theme ?? defaultTheme.definition,
+                focusedId,
+            });
+            steps.push(Object.freeze({
+                step: index + 1,
+                screen: createScenarioScreenSnapshot(currentViewport, screenRender.toText()),
+                cursor: asCursorSnapshot(latestBreadcrumbs),
+                actions: Object.freeze(actions.slice()),
+            }));
+        }
+    }
+    finally {
+        try {
+            await runtimeApp.stop();
+        }
+        catch {
+            // ignore harness teardown failures
+        }
+        runtimeApp.dispose();
+    }
+    const lastStep = steps[steps.length - 1] ??
+        Object.freeze({
+            step: 0,
+            screen: createScenarioScreenSnapshot(currentViewport, ""),
+            cursor: asCursorSnapshot(latestBreadcrumbs),
+            actions: Object.freeze(actions.slice()),
+        });
+    const result = evaluateScenarioResult(opts.scenario, {
+        mode: "semantic",
+        actions: Object.freeze(actions.slice()),
+        steps: Object.freeze(steps),
+        finalScreen: lastStep.screen,
+        finalCursor: lastStep.cursor,
+    });
+    if (fatal.length === 0)
+        return result;
+    return Object.freeze({
+        ...result,
+        status: "FAIL",
+        pass: false,
+        mismatches: Object.freeze([
+            ...result.mismatches,
+            ...fatal.map((item, index) => Object.freeze({
+                code: "ZR_SCENARIO_RUNTIME_FATAL",
+                path: `fatal[${String(index)}]`,
+                detail: `${item.code}: ${item.detail}`,
+            })),
+        ]),
+    });
+}
+//# sourceMappingURL=semanticScenario.js.map

package/dist/testing/semanticScenario.js.map

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

package/dist/testing/snapshot.d.ts

@@ -0,0 +1,73 @@
+/**
+ * packages/core/src/testing/snapshot.ts — Golden frame snapshot system.
+ *
+ * Why: Provides deterministic, platform-stable visual snapshots for regression
+ * testing. Captures the text output of createTestRenderer.toText() along with
+ * metadata (theme, viewport, scene name) for meaningful diffs.
+ *
+ * Snapshot format:
+ *   - Header line with metadata (theme, viewport, scene)
+ *   - Text-based representation of the rendered frame
+ *   - Deterministic across platforms (uses toText() which is platform-agnostic)
+ *
+ * @see docs/design-system.md
+ */
+import type { VNode } from "../widgets/types.js";
+import { type TestRendererOptions } from "./renderer.js";
+/**
+ * Metadata stored alongside each snapshot.
+ */
+export type SnapshotMetadata = Readonly<{
+    /** Scene identifier */
+    scene: string;
+    /** Theme name */
+    theme: string;
+    /** Viewport dimensions */
+    viewport: {
+        cols: number;
+        rows: number;
+    };
+    /** Timestamp of capture (ISO 8601) */
+    capturedAt: string;
+    /** Design system version */
+    version: string;
+}>;
+/**
+ * A captured snapshot.
+ */
+export type Snapshot = Readonly<{
+    metadata: SnapshotMetadata;
+    /** Rendered text content */
+    content: string;
+}>;
+/**
+ * Serialize a snapshot to a stable string format.
+ */
+export declare function serializeSnapshot(snapshot: Snapshot): string;
+/**
+ * Parse a serialized snapshot back into a Snapshot object.
+ */
+export declare function parseSnapshot(text: string): Snapshot | null;
+/**
+ * Capture a snapshot of a VNode scene.
+ *
+ * @param scene - Scene name for identification
+ * @param vnode - The VNode tree to render
+ * @param options - Renderer options (viewport, theme)
+ * @param themeName - Theme name for metadata
+ * @returns Captured snapshot
+ */
+export declare function captureSnapshot(scene: string, vnode: VNode, options: TestRendererOptions, themeName: string): Snapshot;
+/**
+ * Compare two snapshots and return a diff result.
+ */
+export type SnapshotDiffResult = Readonly<{
+    /** Whether the snapshots match */
+    match: boolean;
+    /** Lines that differ (0-indexed) */
+    changedLines: readonly number[];
+    /** Human-readable diff summary */
+    summary: string;
+}>;
+export declare function diffSnapshots(expected: Snapshot, actual: Snapshot): SnapshotDiffResult;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/testing/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/testing/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,KAAK,mBAAmB,EAAsB,MAAM,eAAe,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAW5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CA+C3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,MAAM,GAChB,QAAQ,CAgBV;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,kCAAkC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,kBAAkB,CA8BtF"}

package/dist/testing/snapshot.js

@@ -0,0 +1,138 @@
+/**
+ * packages/core/src/testing/snapshot.ts — Golden frame snapshot system.
+ *
+ * Why: Provides deterministic, platform-stable visual snapshots for regression
+ * testing. Captures the text output of createTestRenderer.toText() along with
+ * metadata (theme, viewport, scene name) for meaningful diffs.
+ *
+ * Snapshot format:
+ *   - Header line with metadata (theme, viewport, scene)
+ *   - Text-based representation of the rendered frame
+ *   - Deterministic across platforms (uses toText() which is platform-agnostic)
+ *
+ * @see docs/design-system.md
+ */
+import { createTestRenderer } from "./renderer.js";
+/**
+ * Serialize a snapshot to a stable string format.
+ */
+export function serializeSnapshot(snapshot) {
+    const meta = snapshot.metadata;
+    const header = [
+        `# Snapshot: ${meta.scene}`,
+        `# Theme: ${meta.theme}`,
+        `# Viewport: ${meta.viewport.cols}x${meta.viewport.rows}`,
+        `# Version: ${meta.version}`,
+        `# Captured: ${meta.capturedAt}`,
+        "---",
+    ].join("\n");
+    return `${header}\n${snapshot.content}\n`;
+}
+/**
+ * Parse a serialized snapshot back into a Snapshot object.
+ */
+export function parseSnapshot(text) {
+    const lines = text.split("\n");
+    let scene = "";
+    let theme = "";
+    let cols = 80;
+    let rows = 24;
+    let version = "";
+    let capturedAt = "";
+    let contentStart = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        if (line === "---") {
+            contentStart = i + 1;
+            break;
+        }
+        if (line.startsWith("# Snapshot: "))
+            scene = line.slice(12);
+        else if (line.startsWith("# Theme: "))
+            theme = line.slice(9);
+        else if (line.startsWith("# Viewport: ")) {
+            const match = line.slice(12).match(/^(\d+)x(\d+)$/);
+            if (match) {
+                const colsText = match[1];
+                const rowsText = match[2];
+                if (colsText !== undefined && rowsText !== undefined) {
+                    cols = Number.parseInt(colsText, 10);
+                    rows = Number.parseInt(rowsText, 10);
+                }
+            }
+        }
+        else if (line.startsWith("# Version: "))
+            version = line.slice(11);
+        else if (line.startsWith("# Captured: "))
+            capturedAt = line.slice(12);
+    }
+    if (contentStart === -1)
+        return null;
+    const content = lines.slice(contentStart).join("\n").trimEnd();
+    return {
+        metadata: {
+            scene,
+            theme,
+            viewport: { cols, rows },
+            capturedAt,
+            version,
+        },
+        content,
+    };
+}
+/**
+ * Capture a snapshot of a VNode scene.
+ *
+ * @param scene - Scene name for identification
+ * @param vnode - The VNode tree to render
+ * @param options - Renderer options (viewport, theme)
+ * @param themeName - Theme name for metadata
+ * @returns Captured snapshot
+ */
+export function captureSnapshot(scene, vnode, options, themeName) {
+    const renderer = createTestRenderer(options);
+    const result = renderer.render(vnode);
+    const content = result.toText();
+    const viewport = options.viewport ?? { cols: 80, rows: 24 };
+    return {
+        metadata: {
+            scene,
+            theme: themeName,
+            viewport: { cols: viewport.cols, rows: viewport.rows },
+            capturedAt: new Date().toISOString(),
+            version: "1.0.0",
+        },
+        content,
+    };
+}
+export function diffSnapshots(expected, actual) {
+    const expectedLines = expected.content.split("\n");
+    const actualLines = actual.content.split("\n");
+    const maxLines = Math.max(expectedLines.length, actualLines.length);
+    const changedLines = [];
+    for (let i = 0; i < maxLines; i++) {
+        const e = expectedLines[i] ?? "";
+        const a = actualLines[i] ?? "";
+        if (e !== a) {
+            changedLines.push(i);
+        }
+    }
+    const match = changedLines.length === 0;
+    let summary;
+    if (match) {
+        summary = `Snapshot "${expected.metadata.scene}" matches.`;
+    }
+    else {
+        const lines = changedLines.slice(0, 10).map((i) => {
+            const e = expectedLines[i] ?? "(missing)";
+            const a = actualLines[i] ?? "(missing)";
+            return `  Line ${i + 1}:\n    expected: ${JSON.stringify(e)}\n    actual:   ${JSON.stringify(a)}`;
+        });
+        const more = changedLines.length > 10 ? `\n  ... and ${changedLines.length - 10} more` : "";
+        summary = `Snapshot "${expected.metadata.scene}" differs in ${changedLines.length} line(s):\n${lines.join("\n")}${more}`;
+    }
+    return { match, changedLines, summary };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/testing/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/testing/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAA4B,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA2B7E;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC/B,MAAM,MAAM,GAAG;QACb,eAAe,IAAI,CAAC,KAAK,EAAE;QAC3B,YAAY,IAAI,CAAC,KAAK,EAAE;QACxB,eAAe,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;QACzD,cAAc,IAAI,CAAC,OAAO,EAAE;QAC5B,eAAe,IAAI,CAAC,UAAU,EAAE;QAChC,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,GAAG,MAAM,KAAK,QAAQ,CAAC,OAAO,IAAI,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;aACvD,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACxD,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACpD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBACrD,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACrC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;aAC/D,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,YAAY,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAE/D,OAAO;QACL,QAAQ,EAAE;YACR,KAAK;YACL,KAAK;YACL,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;YACxB,UAAU;YACV,OAAO;SACR;QACD,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,KAAY,EACZ,OAA4B,EAC5B,SAAiB;IAEjB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAE5D,OAAO;QACL,QAAQ,EAAE;YACR,KAAK;YACL,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;YACtD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO,EAAE,OAAO;SACjB;QACD,OAAO;KACR,CAAC;AACJ,CAAC;AAcD,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,MAAgB;IAChE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACZ,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC;IAExC,IAAI,OAAe,CAAC;IACpB,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,GAAG,aAAa,QAAQ,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAChD,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;YAC1C,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;YACxC,OAAO,UAAU,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,eAAe,YAAY,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,OAAO,GAAG,aAAa,QAAQ,CAAC,QAAQ,CAAC,KAAK,gBAAgB,YAAY,CAAC,MAAM,cAAc,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IAC3H,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/theme/blend.d.ts

@@ -0,0 +1,6 @@
+import { type Rgb24 } from "../widgets/style.js";
+/**
+ * Blend two RGB colors using `t` in [0..1].
+ */
+export declare function blendRgb(a: Rgb24, b: Rgb24, t: number): Rgb24;
+//# sourceMappingURL=blend.d.ts.map

package/dist/theme/blend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blend.d.ts","sourceRoot":"","sources":["../../src/theme/blend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAyB,MAAM,qBAAqB,CAAC;AAMxE;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAO7D"}

package/dist/theme/blend.js

@@ -0,0 +1,12 @@
+import { rgb, rgbB, rgbG, rgbR } from "../widgets/style.js";
+function blendChannel(a, b, t) {
+    return Math.round(a + (b - a) * t);
+}
+/**
+ * Blend two RGB colors using `t` in [0..1].
+ */
+export function blendRgb(a, b, t) {
+    const clampedT = Math.max(0, Math.min(1, t));
+    return rgb(blendChannel(rgbR(a), rgbR(b), clampedT), blendChannel(rgbG(a), rgbG(b), clampedT), blendChannel(rgbB(a), rgbB(b), clampedT));
+}
+//# sourceMappingURL=blend.js.map

package/dist/theme/blend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blend.js","sourceRoot":"","sources":["../../src/theme/blend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAExE,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,CAAQ,EAAE,CAAQ,EAAE,CAAS;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,GAAG,CACR,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EACxC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EACxC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CACzC,CAAC;AACJ,CAAC"}

package/dist/theme/contrast.d.ts

@@ -0,0 +1,13 @@
+/**
+ * packages/core/src/theme/contrast.ts — WCAG contrast calculations.
+ *
+ * Why: Shared utility for deterministic accessibility checks against
+ * foreground/background color pairs.
+ */
+import { type Rgb24 } from "../widgets/style.js";
+/**
+ * Compute WCAG 2.x contrast ratio between two colors.
+ * Returns a value in the range [1, 21], independent of argument order.
+ */
+export declare function contrastRatio(fg: Rgb24, bg: Rgb24): number;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/theme/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../src/theme/contrast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAoB,MAAM,qBAAqB,CAAC;AAenE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,CAM1D"}

package/dist/theme/contrast.js

@@ -0,0 +1,31 @@
+/**
+ * packages/core/src/theme/contrast.ts — WCAG contrast calculations.
+ *
+ * Why: Shared utility for deterministic accessibility checks against
+ * foreground/background color pairs.
+ */
+import { rgbB, rgbG, rgbR } from "../widgets/style.js";
+function srgbToLinear(channel) {
+    const srgb = channel / 255;
+    if (srgb <= 0.04045)
+        return srgb / 12.92;
+    return ((srgb + 0.055) / 1.055) ** 2.4;
+}
+function relativeLuminance(color) {
+    const r = srgbToLinear(rgbR(color));
+    const g = srgbToLinear(rgbG(color));
+    const b = srgbToLinear(rgbB(color));
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+/**
+ * Compute WCAG 2.x contrast ratio between two colors.
+ * Returns a value in the range [1, 21], independent of argument order.
+ */
+export function contrastRatio(fg, bg) {
+    const fgLum = relativeLuminance(fg);
+    const bgLum = relativeLuminance(bg);
+    const lighter = Math.max(fgLum, bgLum);
+    const darker = Math.min(fgLum, bgLum);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+//# sourceMappingURL=contrast.js.map

package/dist/theme/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../../src/theme/contrast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEnE,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,IAAI,GAAG,OAAO,GAAG,GAAG,CAAC;IAC3B,IAAI,IAAI,IAAI,OAAO;QAAE,OAAO,IAAI,GAAG,KAAK,CAAC;IACzC,OAAO,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;AACzC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAY;IACrC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAS,EAAE,EAAS;IAChD,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC"}