@llui/test 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Franco Ponticelli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @llui/test
+
+Test harness for [LLui](https://github.com/fponticelli/llui) components.
+
+`testComponent`, `testView`, `propertyTest`, `replayTrace`, `assertEffects` — mount components in jsdom, send messages, assert on state + DOM.
+
+```bash
+pnpm add -D @llui/test
+```
+
+## License
+
+MIT

package/dist/assert-effects.d.ts

@@ -0,0 +1,2 @@
+export declare function assertEffects<E>(actual: E[], expected: Array<Partial<E>>): void;
+//# sourceMappingURL=assert-effects.d.ts.map

package/dist/assert-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-effects.d.ts","sourceRoot":"","sources":["../src/assert-effects.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAmB/E"}

package/dist/assert-effects.js

@@ -0,0 +1,34 @@
+export function assertEffects(actual, expected) {
+    if (actual.length !== expected.length) {
+        throw new Error(`Expected ${expected.length} effects, got ${actual.length}.\n` +
+            `Actual: ${JSON.stringify(actual, null, 2)}`);
+    }
+    for (let i = 0; i < expected.length; i++) {
+        const act = actual[i];
+        const exp = expected[i];
+        if (!partialMatch(act, exp)) {
+            throw new Error(`Effect at index ${i} does not match.\n` +
+                `Expected (partial): ${JSON.stringify(exp, null, 2)}\n` +
+                `Actual: ${JSON.stringify(act, null, 2)}`);
+        }
+    }
+}
+function partialMatch(actual, expected) {
+    if (expected === undefined)
+        return true;
+    if (actual === expected)
+        return true;
+    if (expected === null || actual === null)
+        return actual === expected;
+    if (typeof expected === 'object' && typeof actual === 'object') {
+        const expObj = expected;
+        const actObj = actual;
+        for (const key of Object.keys(expObj)) {
+            if (!partialMatch(actObj[key], expObj[key]))
+                return false;
+        }
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=assert-effects.js.map

package/dist/assert-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-effects.js","sourceRoot":"","sources":["../src/assert-effects.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAI,MAAW,EAAE,QAA2B;IACvE,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,YAAY,QAAQ,CAAC,MAAM,iBAAiB,MAAM,CAAC,MAAM,KAAK;YAC5D,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC/C,CAAA;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACrB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,mBAAmB,CAAC,oBAAoB;gBACtC,uBAAuB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;gBACvD,WAAW,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC5C,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAe,EAAE,QAAiB;IACtD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACpC,IAAI,QAAQ,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,KAAK,QAAQ,CAAA;IAEpE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,QAAmC,CAAA;QAClD,MAAM,MAAM,GAAG,MAAiC,CAAA;QAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;QAC3D,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { testComponent } from './test-component';
+export { testView } from './test-view';
+export { assertEffects } from './assert-effects';
+export { propertyTest } from './property-test';
+export { replayTrace } from './replay-trace';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { testComponent } from './test-component';
+export { testView } from './test-view';
+export { assertEffects } from './assert-effects';
+export { propertyTest } from './property-test';
+export { replayTrace } from './replay-trace';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/property-test.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentDef } from '@llui/dom';
+export declare function propertyTest<S, M, E>(def: ComponentDef<S, M, E>, config: {
+    invariants: Array<(state: S, effects: E[]) => boolean>;
+    messageGenerators: Record<string, ((state: S) => M) | (() => M)>;
+    runs?: number;
+    maxSequenceLength?: number;
+}): void;
+//# sourceMappingURL=property-test.d.ts.map

package/dist/property-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-test.d.ts","sourceRoot":"","sources":["../src/property-test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAClC,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1B,MAAM,EAAE;IACN,UAAU,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAA;IACtD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAChE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,GACA,IAAI,CA+BN"}

package/dist/property-test.js

@@ -0,0 +1,44 @@
+export function propertyTest(def, config) {
+    const runs = config.runs ?? 1000;
+    const maxLen = config.maxSequenceLength ?? 50;
+    const genNames = Object.keys(config.messageGenerators);
+    if (genNames.length === 0) {
+        throw new Error('propertyTest: at least one message generator required');
+    }
+    for (let run = 0; run < runs; run++) {
+        const [initState, initEffects] = def.init();
+        let state = initState;
+        const sequence = [];
+        // Check invariants on initial state
+        checkInvariants(config.invariants, state, initEffects, sequence);
+        const seqLen = 1 + Math.floor(Math.random() * maxLen);
+        for (let step = 0; step < seqLen; step++) {
+            const genName = genNames[Math.floor(Math.random() * genNames.length)];
+            const gen = config.messageGenerators[genName];
+            const msg = gen.length === 0 ? gen() : gen(state);
+            sequence.push({ name: genName, msg });
+            const [newState, effects] = def.update(state, msg);
+            state = newState;
+            checkInvariants(config.invariants, state, effects, sequence);
+        }
+    }
+}
+function checkInvariants(invariants, state, effects, sequence) {
+    for (let i = 0; i < invariants.length; i++) {
+        if (!invariants[i](state, effects)) {
+            // Attempt to shrink
+            const shrunk = shrinkSequence(sequence);
+            const seqStr = shrunk.map((s) => s.name).join(' → ');
+            throw new Error(`propertyTest: invariant ${i} violated after sequence: [${seqStr}]\n` +
+                `State: ${JSON.stringify(state)}\n` +
+                `Effects: ${JSON.stringify(effects)}`);
+        }
+    }
+}
+function shrinkSequence(sequence) {
+    // Simple shrinking: try removing each element from the end
+    // A full implementation would do binary search shrinking
+    // For now, just return the sequence as-is (no shrinking)
+    return sequence;
+}
+//# sourceMappingURL=property-test.js.map

package/dist/property-test.js.map

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

package/dist/replay-trace.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentDef } from '@llui/dom';
+export interface LluiTrace<S, M, E> {
+    lluiTrace: 1;
+    component: string;
+    generatedBy: string;
+    timestamp: string;
+    entries: Array<{
+        msg: M;
+        expectedState: S;
+        expectedEffects: E[];
+    }>;
+}
+export declare function replayTrace<S, M, E>(def: ComponentDef<S, M, E>, trace: LluiTrace<S, M, E>): void;
+//# sourceMappingURL=replay-trace.d.ts.map

package/dist/replay-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-trace.d.ts","sourceRoot":"","sources":["../src/replay-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChC,SAAS,EAAE,CAAC,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,CAAC,CAAA;QACN,aAAa,EAAE,CAAC,CAAA;QAChB,eAAe,EAAE,CAAC,EAAE,CAAA;KACrB,CAAC,CAAA;CACH;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CA8BhG"}

package/dist/replay-trace.js

@@ -0,0 +1,56 @@
+export function replayTrace(def, trace) {
+    const [initState] = def.init();
+    let state = initState;
+    for (let i = 0; i < trace.entries.length; i++) {
+        const entry = trace.entries[i];
+        const [newState, effects] = def.update(state, entry.msg);
+        // Compare state
+        if (!deepEqual(newState, entry.expectedState)) {
+            throw new Error(`replayTrace: state diverged at step ${i}\n` +
+                `Message: ${JSON.stringify(entry.msg)}\n` +
+                `Expected: ${JSON.stringify(entry.expectedState)}\n` +
+                `Actual: ${JSON.stringify(newState)}`);
+        }
+        // Compare effects
+        if (!deepEqual(effects, entry.expectedEffects)) {
+            throw new Error(`replayTrace: effects diverged at step ${i}\n` +
+                `Message: ${JSON.stringify(entry.msg)}\n` +
+                `Expected effects: ${JSON.stringify(entry.expectedEffects)}\n` +
+                `Actual effects: ${JSON.stringify(effects)}`);
+        }
+        state = newState;
+    }
+}
+function deepEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== 'object')
+        return false;
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b))
+            return false;
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            if (!deepEqual(a[i], b[i]))
+                return false;
+        }
+        return true;
+    }
+    const aObj = a;
+    const bObj = b;
+    const aKeys = Object.keys(aObj);
+    const bKeys = Object.keys(bObj);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const key of aKeys) {
+        if (!deepEqual(aObj[key], bObj[key]))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=replay-trace.js.map

package/dist/replay-trace.js.map

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

package/dist/test-component.d.ts

@@ -0,0 +1,16 @@
+import type { ComponentDef } from '@llui/dom';
+export interface TestHarness<S, M, E> {
+    state: S;
+    effects: E[];
+    allEffects: E[];
+    history: Array<{
+        prevState: S;
+        msg: M;
+        nextState: S;
+        effects: E[];
+    }>;
+    send: (msg: M) => void;
+    sendAll: (msgs: M[]) => S;
+}
+export declare function testComponent<S, M, E>(def: ComponentDef<S, M, E>, initialData?: unknown): TestHarness<S, M, E>;
+//# sourceMappingURL=test-component.d.ts.map

package/dist/test-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-component.d.ts","sourceRoot":"","sources":["../src/test-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,MAAM,WAAW,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAClC,KAAK,EAAE,CAAC,CAAA;IACR,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,UAAU,EAAE,CAAC,EAAE,CAAA;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAA;IACpE,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAA;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACnC,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1B,WAAW,CAAC,EAAE,OAAO,GACpB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CA2BtB"}

package/dist/test-component.js

@@ -0,0 +1,25 @@
+export function testComponent(def, initialData) {
+    const [initState, initEffects] = def.init(initialData);
+    const harness = {
+        state: initState,
+        effects: initEffects,
+        allEffects: [...initEffects],
+        history: [],
+        send(msg) {
+            const prevState = harness.state;
+            const [nextState, effects] = def.update(prevState, msg);
+            harness.history.push({ prevState, msg, nextState, effects });
+            harness.state = nextState;
+            harness.effects = effects;
+            harness.allEffects.push(...effects);
+        },
+        sendAll(msgs) {
+            for (const msg of msgs) {
+                harness.send(msg);
+            }
+            return harness.state;
+        },
+    };
+    return harness;
+}
+//# sourceMappingURL=test-component.js.map

package/dist/test-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-component.js","sourceRoot":"","sources":["../src/test-component.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,aAAa,CAC3B,GAA0B,EAC1B,WAAqB;IAErB,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,GAAI,GAAG,CAAC,IAAoC,CAAC,WAAW,CAAC,CAAA;IAEvF,MAAM,OAAO,GAAyB;QACpC,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,WAAW;QACpB,UAAU,EAAE,CAAC,GAAG,WAAW,CAAC;QAC5B,OAAO,EAAE,EAAE;QAEX,IAAI,CAAC,GAAM;YACT,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAA;YAC/B,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;YACvD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;YAC5D,OAAO,CAAC,KAAK,GAAG,SAAS,CAAA;YACzB,OAAO,CAAC,OAAO,GAAG,OAAO,CAAA;YACzB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;QACrC,CAAC;QAED,OAAO,CAAC,IAAS;YACf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACnB,CAAC;YACD,OAAO,OAAO,CAAC,KAAK,CAAA;QACtB,CAAC;KACF,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/test-view.d.ts

@@ -0,0 +1,31 @@
+import type { ComponentDef, AppHandle } from '@llui/dom';
+export interface ViewHarness<M> {
+    /** Mounted container — useful for advanced cases. */
+    readonly container: HTMLElement;
+    /** The AppHandle returned by mountApp — expose dispose/flush. */
+    readonly handle: AppHandle;
+    /** Query a single element. */
+    query(selector: string): Element | null;
+    /** Query all matching elements. */
+    queryAll(selector: string): Element[];
+    /** Read the element's text content. Returns empty string if the element is missing. */
+    text(selector: string): string;
+    /** Read an element's attribute. */
+    attr(selector: string, name: string): string | null;
+    /** Dispatch a message and flush synchronously. */
+    send(msg: M): void;
+    /** Click an element and flush. Throws if no element matches. */
+    click(selector: string): void;
+    /** Set an input's value and dispatch an 'input' event, then flush. */
+    input(selector: string, value: string): void;
+    /** Dispatch a custom event and flush. Default bubbles: true. */
+    fire(selector: string, type: string, init?: EventInit): void;
+    /** Dispose + remove DOM. Idempotent. */
+    unmount(): void;
+}
+/**
+ * Mount a component against a fresh container and return an interactive harness.
+ * Simulates events + auto-flushes so tests can chain assertions naturally.
+ */
+export declare function testView<S, M, E>(def: ComponentDef<S, M, E>, state: S): ViewHarness<M>;
+//# sourceMappingURL=test-view.d.ts.map

package/dist/test-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-view.d.ts","sourceRoot":"","sources":["../src/test-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGxD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,8BAA8B;IAC9B,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;IACvC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;IACrC,uFAAuF;IACvF,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,mCAAmC;IACnC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnD,kDAAkD;IAClD,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAA;IAClB,gEAAgE;IAChE,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,sEAAsE;IACtE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5C,gEAAgE;IAChE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IAC5D,wCAAwC;IACxC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CA2DtF"}

package/dist/test-view.js

@@ -0,0 +1,64 @@
+import { mountApp } from '@llui/dom';
+/**
+ * Mount a component against a fresh container and return an interactive harness.
+ * Simulates events + auto-flushes so tests can chain assertions naturally.
+ */
+export function testView(def, state) {
+    const container = document.createElement('div');
+    const testDef = {
+        ...def,
+        init: () => [state, []],
+    };
+    // Capture the component's send via a view interceptor.
+    let sendFn = null;
+    const originalView = testDef.view;
+    testDef.view = (h) => {
+        sendFn = h.send;
+        return originalView(h);
+    };
+    const handle = mountApp(container, testDef);
+    let disposed = false;
+    function required(selector) {
+        const el = container.querySelector(selector);
+        if (!el)
+            throw new Error(`[testView] no element matches selector ${JSON.stringify(selector)}`);
+        return el;
+    }
+    return {
+        container,
+        handle,
+        query: (s) => container.querySelector(s),
+        queryAll: (s) => Array.from(container.querySelectorAll(s)),
+        text: (s) => container.querySelector(s)?.textContent ?? '',
+        attr: (s, name) => container.querySelector(s)?.getAttribute(name) ?? null,
+        send(msg) {
+            if (!sendFn)
+                throw new Error('[testView] send unavailable (mount failed?)');
+            sendFn(msg);
+            handle.flush();
+        },
+        click(selector) {
+            const el = required(selector);
+            el.click();
+            handle.flush();
+        },
+        input(selector, value) {
+            const el = required(selector);
+            el.value = value;
+            el.dispatchEvent(new Event('input', { bubbles: true }));
+            handle.flush();
+        },
+        fire(selector, type, init) {
+            const el = required(selector);
+            el.dispatchEvent(new Event(type, { bubbles: true, ...init }));
+            handle.flush();
+        },
+        unmount() {
+            if (disposed)
+                return;
+            disposed = true;
+            handle.dispose();
+        },
+    };
+}
+//# sourceMappingURL=test-view.js.map

package/dist/test-view.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@llui/test",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@llui/dom": "workspace:*"
+  },
+  "description": "LLui test harness — testComponent, testView, propertyTest, replayTrace, assertEffects",
+  "keywords": [
+    "llui",
+    "test",
+    "testing",
+    "harness",
+    "property-test"
+  ],
+  "author": "Franco Ponticelli <franco.ponticelli@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fponticelli/llui.git",
+    "directory": "packages/test"
+  },
+  "bugs": {
+    "url": "https://github.com/fponticelli/llui/issues"
+  },
+  "homepage": "https://github.com/fponticelli/llui/tree/main/packages/test#readme"
+}