@llui/test

Test harness for LLui components. Mount components in jsdom, send messages, and assert on state and DOM.

pnpm add -D @llui/test

Usage

import { testView } from '@llui/test'
import { counterDef } from './counter'

const harness = testView(counterDef, { count: 0 })

harness.click('[data-testid="increment"]')
harness.flush()

expect(harness.text('[data-testid="display"]')).toBe('1')
harness.unmount()

API

testComponent

testComponent(def) => { state, send, flush, effects }

Mount a component definition headlessly. Returns current state snapshot and message dispatch.

testView

testView(def, state?) => ViewHarness<M>

Mount a component into jsdom with full DOM. Returns a harness with DOM query and interaction methods.

| Method | Description | | ------------------------ | ----------------------------------------------- | | .send(msg) | Dispatch a message | | .flush() | Force synchronous update (skip microtask queue) | | .click(selector) | Simulate click on element | | .input(selector, val) | Set input value and fire input event | | .text(selector) | Get textContent of element | | .attr(selector, name) | Get attribute value | | .query(selector) | querySelector on mounted DOM | | .queryAll(selector) | querySelectorAll on mounted DOM | | .fire(selector, event) | Dispatch a custom event | | .unmount() | Tear down the component and clean up |

assertEffects

assertEffects(effects, expected) => void

Deep-equal assertion on effect arrays. Provides clear diff output on mismatch.

propertyTest

propertyTest(gen, prop) => void

Property-based testing. Generates random inputs via gen and checks prop holds for all.

replayTrace

replayTrace(def, trace) => void

Replay a recorded message trace against a component definition. Asserts state at each step.

License

MIT