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

package/dist/testing/referenceScenarios/textareaMultilineEditing.js

@@ -0,0 +1,100 @@
+import { ui } from "../../ui.js";
+export const referenceTextareaMultilineScenario = Object.freeze({
+    schemaVersion: 1,
+    id: "textarea-multiline-editing",
+    title: "Textarea preserves multiline editing behavior",
+    widgetFamily: "input-textarea",
+    behaviorStatement: "A focused textarea inserts a newline on Enter and continues editing on the following line.",
+    evidenceRefs: Object.freeze([
+        "docs/widgets/textarea.md",
+        "docs/guide/input-and-focus.md",
+        "packages/core/src/runtime/__tests__/inputEditor.state.test.ts",
+        "packages/core/src/app/__tests__/widgetRenderer.integration.test.ts",
+    ]),
+    viewport: Object.freeze({ cols: 40, rows: 12 }),
+    theme: Object.freeze({ mode: "named", value: "default" }),
+    capabilityProfile: Object.freeze({
+        supportsMouse: false,
+        supportsBracketedPaste: false,
+        supportsFocusEvents: false,
+        supportsOsc52: false,
+        colorMode: "none",
+    }),
+    scriptedInput: Object.freeze([
+        Object.freeze({ atMs: 0, event: Object.freeze({ kind: "key", key: "enter" }) }),
+        Object.freeze({ atMs: 1, event: Object.freeze({ kind: "text", text: "x" }) }),
+    ]),
+    expectedActions: Object.freeze([
+        Object.freeze({ id: "notes", action: "input", value: "ab\n", cursor: 3 }),
+        Object.freeze({ id: "notes", action: "input", value: "ab\nx", cursor: 4 }),
+    ]),
+    expectedScreenCheckpoints: Object.freeze([
+        Object.freeze({
+            id: "newline-inserted",
+            afterStep: 1,
+            assertionRef: "screen_region_assertion",
+            args: Object.freeze({
+                x: 0,
+                y: 3,
+                width: 40,
+                height: 1,
+                match: "includes",
+                text: Object.freeze(['Value:"ab\\n"']),
+            }),
+        }),
+        Object.freeze({
+            id: "second-line-edit",
+            afterStep: 2,
+            assertionRef: "screen_region_assertion",
+            args: Object.freeze({
+                x: 0,
+                y: 3,
+                width: 40,
+                height: 1,
+                match: "includes",
+                text: Object.freeze(['Value:"ab\\nx"']),
+            }),
+        }),
+    ]),
+    invariants: Object.freeze([
+        Object.freeze({
+            id: "no-single-line-collapse",
+            assertionRef: "invariant_assertion",
+            args: Object.freeze({
+                kind: "action_absence",
+                action: Object.freeze({
+                    id: "notes",
+                    action: "input",
+                    payloadSubset: Object.freeze({ value: "abx" }),
+                }),
+            }),
+        }),
+    ]),
+    fidelityRequirement: "semantic-only",
+});
+export const createReferenceTextareaMultilineFixture = () => {
+    let app;
+    return Object.freeze({
+        initialState: Object.freeze({ value: "ab" }),
+        setup(nextApp) {
+            app = nextApp;
+        },
+        view(state) {
+            return ui.focusTrap({ id: "textarea-trap", active: true, initialFocus: "notes" }, [
+                ui.column({ p: 1, gap: 1 }, [
+                    ui.text("Textarea scenario"),
+                    ui.text(`Value:${JSON.stringify(state.value)}`),
+                    ui.textarea({
+                        id: "notes",
+                        value: state.value,
+                        rows: 4,
+                        onInput: (value) => {
+                            app.update({ value });
+                        },
+                    }),
+                ]),
+            ]);
+        },
+    });
+};
+//# sourceMappingURL=textareaMultilineEditing.js.map

package/dist/testing/referenceScenarios/textareaMultilineEditing.js.map

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

package/dist/testing/referenceScenarios/virtualListResizeStorm.d.ts

@@ -0,0 +1,8 @@
+import type { ScenarioDefinition, ScenarioFixtureFactory } from "../scenario.js";
+interface VirtualListResizeStormState {
+    readonly activated: string;
+}
+export declare const referenceVirtualListResizeStormScenario: ScenarioDefinition;
+export declare const createReferenceVirtualListResizeStormFixture: ScenarioFixtureFactory<VirtualListResizeStormState>;
+export {};
+//# sourceMappingURL=virtualListResizeStorm.d.ts.map

package/dist/testing/referenceScenarios/virtualListResizeStorm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualListResizeStorm.d.ts","sourceRoot":"","sources":["../../../src/testing/referenceScenarios/virtualListResizeStorm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,UAAU,2BAA2B;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,uCAAuC,EAAE,kBA6DpD,CAAC;AAEH,eAAO,MAAM,4CAA4C,EAAE,sBAAsB,CAC/E,2BAA2B,CA2B5B,CAAC"}

package/dist/testing/referenceScenarios/virtualListResizeStorm.js

@@ -0,0 +1,88 @@
+import { ui } from "../../ui.js";
+export const referenceVirtualListResizeStormScenario = Object.freeze({
+    schemaVersion: 1,
+    id: "virtual-list-resize-storm-stays-interactive",
+    title: "Virtual list stays interactive through a resize storm",
+    widgetFamily: "table-tree-virtual-list",
+    behaviorStatement: "Repeated viewport changes must not wedge a virtual list; later keyboard navigation and activation still work.",
+    evidenceRefs: Object.freeze([
+        "docs/widgets/virtual-list.md",
+        "docs/terminal-io-contract.md",
+        "packages/core/src/widgets/__tests__/virtualList.contract.test.ts",
+        "packages/core/src/app/__tests__/widgetBehavior.contracts.test.ts",
+    ]),
+    viewport: Object.freeze({ cols: 40, rows: 10 }),
+    theme: Object.freeze({ mode: "named", value: "default" }),
+    capabilityProfile: Object.freeze({
+        supportsMouse: false,
+        supportsBracketedPaste: false,
+        supportsFocusEvents: false,
+        supportsOsc52: false,
+        colorMode: "none",
+    }),
+    scriptedInput: Object.freeze([
+        Object.freeze({ atMs: 0, event: Object.freeze({ kind: "resize", cols: 52, rows: 12 }) }),
+        Object.freeze({ atMs: 10, event: Object.freeze({ kind: "resize", cols: 34, rows: 8 }) }),
+        Object.freeze({ atMs: 20, event: Object.freeze({ kind: "resize", cols: 60, rows: 14 }) }),
+        Object.freeze({ atMs: 30, event: Object.freeze({ kind: "resize", cols: 40, rows: 10 }) }),
+        Object.freeze({ atMs: 60, event: Object.freeze({ kind: "key", key: "down" }) }),
+        Object.freeze({ atMs: 70, event: Object.freeze({ kind: "key", key: "enter" }) }),
+    ]),
+    expectedScreenCheckpoints: Object.freeze([
+        Object.freeze({
+            id: "activation-after-resize-storm",
+            afterStep: 6,
+            assertionRef: "screen_region_assertion",
+            args: Object.freeze({
+                x: 0,
+                y: 0,
+                width: 40,
+                height: 2,
+                match: "includes",
+                text: Object.freeze(["Activated:1"]),
+            }),
+        }),
+    ]),
+    invariants: Object.freeze([
+        Object.freeze({
+            id: "no-ghost-activation",
+            assertionRef: "invariant_assertion",
+            args: Object.freeze({
+                kind: "action_absence",
+                action: Object.freeze({
+                    id: "missing-list-action",
+                    action: "press",
+                }),
+            }),
+        }),
+    ]),
+    fidelityRequirement: "terminal-real",
+    notes: "The oracle stays behavior-first: later activation must still work after repeated resizes, without asserting exact row geometry during the storm.",
+});
+export const createReferenceVirtualListResizeStormFixture = () => {
+    let app;
+    const items = Object.freeze(Array.from({ length: 100 }, (_, index) => index));
+    return Object.freeze({
+        initialState: Object.freeze({ activated: "-" }),
+        setup(nextApp) {
+            app = nextApp;
+        },
+        view(state) {
+            return ui.focusTrap({ id: "resize-trap", active: true, initialFocus: "list" }, [
+                ui.column({}, [
+                    ui.text(`Activated:${state.activated}`),
+                    ui.virtualList({
+                        id: "list",
+                        items,
+                        itemHeight: 1,
+                        renderItem: (item, _index, focused) => ui.text(focused ? `> ${String(item)}` : String(item)),
+                        onSelect: (item) => {
+                            app.update({ activated: String(item) });
+                        },
+                    }),
+                ]),
+            ]);
+        },
+    });
+};
+//# sourceMappingURL=virtualListResizeStorm.js.map

package/dist/testing/referenceScenarios/virtualListResizeStorm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualListResizeStorm.js","sourceRoot":"","sources":["../../../src/testing/referenceScenarios/virtualListResizeStorm.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAOjC,MAAM,CAAC,MAAM,uCAAuC,GAAuB,MAAM,CAAC,MAAM,CAAC;IACvF,aAAa,EAAE,CAAC;IAChB,EAAE,EAAE,6CAA6C;IACjD,KAAK,EAAE,uDAAuD;IAC9D,YAAY,EAAE,yBAAyB;IACvC,iBAAiB,EACf,+GAA+G;IACjH,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QAC1B,8BAA8B;QAC9B,8BAA8B;QAC9B,kEAAkE;QAClE,kEAAkE;KACnE,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACzD,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;QAC/B,aAAa,EAAE,KAAK;QACpB,sBAAsB,EAAE,KAAK;QAC7B,mBAAmB,EAAE,KAAK;QAC1B,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,MAAM;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACzF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACzF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC/E,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;KACjF,CAAC;IACF,yBAAyB,EAAE,MAAM,CAAC,MAAM,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC;YACZ,EAAE,EAAE,+BAA+B;YACnC,SAAS,EAAE,CAAC;YACZ,YAAY,EAAE,yBAAyB;YACvC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;gBAClB,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,CAAC;gBACJ,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,CAAC;gBACT,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;aACrC,CAAC;SACH,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,MAAM,CAAC,MAAM,CAAC;YACZ,EAAE,EAAE,qBAAqB;YACzB,YAAY,EAAE,qBAAqB;YACnC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;gBAClB,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;oBACpB,EAAE,EAAE,qBAAqB;oBACzB,MAAM,EAAE,OAAO;iBAChB,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IACF,mBAAmB,EAAE,eAAe;IACpC,KAAK,EACH,kJAAkJ;CACrJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4CAA4C,GAErD,GAAG,EAAE;IACP,IAAI,GAAsC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QAC/C,KAAK,CAAC,OAAO;YACX,GAAG,GAAG,OAAO,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,KAAK;YACR,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE;gBAC7E,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE;oBACZ,EAAE,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,SAAS,EAAE,CAAC;oBACvC,EAAE,CAAC,WAAW,CAAC;wBACb,EAAE,EAAE,MAAM;wBACV,KAAK;wBACL,UAAU,EAAE,CAAC;wBACb,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CACpC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;wBACvD,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE;4BACzB,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC1C,CAAC;qBACF,CAAC;iBACH,CAAC;aACH,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/testing/renderer.d.ts

@@ -0,0 +1,128 @@
+/**
+ * packages/core/src/testing/renderer.ts — High-level widget test renderer.
+ *
+ * Why: Widget tests should not manually wire commit -> layout -> drawlist.
+ * This helper runs the full pipeline and exposes semantic query helpers.
+ */
+import type { Rect } from "../layout/types.js";
+import { type Theme } from "../theme/theme.js";
+import type { ThemeDefinition } from "../theme/tokens.js";
+import type { TextStyle } from "../widgets/style.js";
+import type { VNode } from "../widgets/types.js";
+export type TestViewport = Readonly<{
+    cols: number;
+    rows: number;
+}>;
+type TestNodeProps = Readonly<Record<string, unknown> & {
+    id?: unknown;
+    label?: unknown;
+}>;
+export type TestRendererMode = "test" | "runtime";
+export type TestRendererOptions = Readonly<{
+    viewport?: TestViewport;
+    theme?: Theme | ThemeDefinition;
+    focusedId?: string | null;
+    tick?: number;
+    mode?: TestRendererMode;
+    trace?: (event: TestRenderTraceEvent) => void;
+    traceDetail?: boolean;
+}>;
+export type TestRenderOptions = Readonly<{
+    viewport?: TestViewport;
+    theme?: Theme | ThemeDefinition;
+    focusedId?: string | null;
+    tick?: number;
+    mode?: TestRendererMode;
+    traceDetail?: boolean;
+}>;
+export type TestRenderTraceEvent = Readonly<{
+    renderId: number;
+    viewport: TestViewport;
+    focusedId: string | null;
+    tick: number;
+    timings: Readonly<{
+        commitMs: number;
+        layoutMs: number;
+        drawMs: number;
+        textMs: number;
+        totalMs: number;
+    }>;
+    nodeCount: number;
+    opCount: number;
+    opCounts: Readonly<Record<TestRecordedOp["kind"], number>>;
+    clipDepthMax: number;
+    textChars: number;
+    textLines: number;
+    nonBlankLines: number;
+    widestLine: number;
+    minRectY: number;
+    maxRectBottom: number;
+    zeroHeightRects: number;
+    detailIncluded: boolean;
+    nodes?: readonly TestRenderNode[];
+    ops?: readonly TestRecordedOp[];
+    text?: string;
+}>;
+export type TestRenderNode = Readonly<{
+    kind: VNode["kind"];
+    rect: Rect;
+    props: TestNodeProps;
+    id: string | null;
+    path: readonly number[];
+    text?: string;
+}>;
+export type TestRenderLayoutVisitor = (rect: Rect, props: TestNodeProps) => void;
+export type TestRenderResult = Readonly<{
+    viewport: TestViewport;
+    focusedId: string | null;
+    /** Low-level draw ops recorded by the test builder. Useful for asserting rendering behavior. */
+    ops: readonly TestRecordedOp[];
+    nodes: readonly TestRenderNode[];
+    forEachLayoutNode: (visit: TestRenderLayoutVisitor) => void;
+    findText: (text: string) => TestRenderNode | null;
+    findById: (id: string) => TestRenderNode | null;
+    findAll: (kind: VNode["kind"] | string) => readonly TestRenderNode[];
+    toText: () => string;
+}>;
+export type TestRenderer = Readonly<{
+    render: (vnode: VNode, opts?: TestRenderOptions) => TestRenderResult;
+    reset: () => void;
+}>;
+export type TestRecordedOp = Readonly<{
+    kind: "clear";
+}> | Readonly<{
+    kind: "clearTo";
+    cols: number;
+    rows: number;
+    style?: TextStyle;
+}> | Readonly<{
+    kind: "fillRect";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    style?: TextStyle;
+}> | Readonly<{
+    kind: "drawText";
+    x: number;
+    y: number;
+    text: string;
+    style?: TextStyle;
+}> | Readonly<{
+    kind: "pushClip";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}> | Readonly<{
+    kind: "popClip";
+}>;
+/**
+ * Create a high-level renderer for deterministic widget tests.
+ *
+ * Repeated `render(...)` calls reuse committed runtime state so tests can model
+ * real update sequences without manual commit/layout plumbing.
+ */
+export declare function createTestRenderer(opts?: TestRendererOptions): TestRenderer;
+export {};
+//# sourceMappingURL=renderer.d.ts.map

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

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