foldkit 0.43.2 → 0.44.0

package/dist/test/scene.js

@@ -0,0 +1,373 @@
+import { Array, Effect, Function, Option, Predicate, pipe } from 'effect';
+import { dual } from 'effect/Function';
+import { Dispatch } from '../runtime';
+import { assertAllCommandsResolved, assertNoUnresolvedCommands, resolveByName, } from './internal';
+import { attr, resolveTarget, textContent } from './query';
+export { find, findAll, textContent, attr, getByRole, getAllByRole, getByText, getByPlaceholder, getByLabel, role, placeholder, label, selector, text, within, } from './query';
+export { sceneMatchers } from './matchers';
+const UNINITIALIZED = Symbol('uninitialized');
+const toInternal = (simulation) => 
+// eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+simulation;
+// CAPTURING DISPATCH
+const createCapturingDispatch = () => {
+    let capturedMessage;
+    return {
+        dispatch: Dispatch.of({
+            dispatchAsync: () => Effect.void,
+            dispatchSync: (dispatchedMessage) => {
+                capturedMessage = dispatchedMessage;
+            },
+        }),
+        getCapturedMessage: () => capturedMessage,
+        reset: () => {
+            capturedMessage = undefined;
+        },
+    };
+};
+// RENDERING
+const renderView = (viewFn, model, dispatch) => {
+    const maybeVNode = Effect.runSync(Effect.provideService(viewFn(model), Dispatch, dispatch));
+    if (Predicate.isNull(maybeVNode)) {
+        throw new Error('The view function returned null.\n\n' +
+            'Scene tests require a non-null view. ' +
+            'If you need to test null-view states, use Story.story instead.');
+    }
+    return maybeVNode;
+};
+// INTERACTION HELPERS
+const EVENT_NAMES = {
+    click: 'OnClick',
+    submit: 'OnSubmit',
+    input: 'OnInput',
+    keydown: 'OnKeyDown or OnKeyDownPreventDefault',
+};
+const invokeAndCapture = (simulation, target, eventName, invokeHandler) => {
+    const internal = toInternal(simulation);
+    const { maybeElement, description } = resolveTarget(internal.html, target);
+    if (Option.isNone(maybeElement)) {
+        throw new Error(`I could not find an element matching ${description}.\n\n` +
+            'Check that your selector matches an element in the current view.');
+    }
+    const element = maybeElement.value;
+    const maybeHandler = Option.fromNullable(element.data?.on?.[eventName]);
+    if (Option.isNone(maybeHandler)) {
+        const attributeName = EVENT_NAMES[eventName] ?? eventName;
+        throw new Error(`I found an element matching ${description} but it has no ${eventName} handler.\n\n` +
+            `Make sure the element has an ${attributeName} attribute.`);
+    }
+    internal.capturingDispatch.reset();
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+    invokeHandler(maybeHandler.value);
+    const captured = internal.capturingDispatch.getCapturedMessage();
+    if (Predicate.isUndefined(captured)) {
+        return simulation;
+    }
+    assertNoUnresolvedCommands(internal.commands, 'when an interaction dispatched a new Message');
+    /* eslint-disable @typescript-eslint/consistent-type-assertions */
+    const capturedMessage = captured;
+    const result = internal.updateFn(internal.model, capturedMessage);
+    const [nextModel, commands] = result;
+    const outMessage = result.length === 3 ? result[2] : internal.outMessage;
+    return {
+        ...internal,
+        model: nextModel,
+        message: capturedMessage,
+        commands: Array.appendAll(internal.commands, commands),
+        outMessage,
+    };
+    /* eslint-enable @typescript-eslint/consistent-type-assertions */
+};
+const DEFAULT_KEYBOARD_MODIFIERS = {
+    shiftKey: false,
+    ctrlKey: false,
+    altKey: false,
+    metaKey: false,
+};
+// STEPS
+/** Sets the initial Model for a scene test. */
+export { with_ as with };
+const with_ = (model) => {
+    const step = (simulation) => {
+        const internal = toInternal(simulation);
+        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+        return { ...internal, model };
+    };
+    /* eslint-disable @typescript-eslint/consistent-type-assertions */
+    return Object.assign(step, {
+        _phantomModel: undefined,
+    });
+    /* eslint-enable @typescript-eslint/consistent-type-assertions */
+};
+/** Resolves a specific pending Command with the given result Message. */
+export const resolve = (definition, resultMessage, toParentMessage) => (simulation) => {
+    /* eslint-disable @typescript-eslint/consistent-type-assertions */
+    const internal = toInternal(simulation);
+    const messageForUpdate = (Predicate.isUndefined(toParentMessage)
+        ? resultMessage
+        : toParentMessage(resultMessage));
+    const next = resolveByName(internal, definition.name, messageForUpdate);
+    if (Predicate.isUndefined(next)) {
+        const pending = Array.isNonEmptyReadonlyArray(internal.commands)
+            ? pipe(internal.commands, Array.map(({ name }) => `    ${name}`), Array.join('\n'))
+            : '    (none)';
+        throw new Error(`I tried to resolve "${definition.name}" but it wasn't in the pending Commands.\n\n` +
+            `Pending Commands:\n${pending}\n\n` +
+            'Make sure the previous Message produced this Command.');
+    }
+    return next;
+    /* eslint-enable @typescript-eslint/consistent-type-assertions */
+};
+/** Resolves all listed Commands with their result Messages. Handles cascading resolution. */
+export const resolveAll = (pairs) => (simulation) => {
+    const internal = toInternal(simulation);
+    const resolvers = {};
+    for (const [definition, resultMessage] of pairs) {
+        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+        resolvers[definition.name] = resultMessage;
+    }
+    /* eslint-disable @typescript-eslint/consistent-type-assertions */
+    let current = {
+        ...internal,
+        resolvers: { ...internal.resolvers, ...resolvers },
+    };
+    const MAX_CASCADE_DEPTH = 100;
+    for (let depth = 0; depth < MAX_CASCADE_DEPTH; depth++) {
+        const resolvable = current.commands.find(({ name }) => name in current.resolvers);
+        if (Predicate.isUndefined(resolvable)) {
+            break;
+        }
+        const next = resolveByName(current, resolvable.name, current.resolvers[resolvable.name]);
+        if (Predicate.isUndefined(next)) {
+            break;
+        }
+        current = next;
+        if (depth === MAX_CASCADE_DEPTH - 1) {
+            throw new Error('resolveAll hit the maximum cascade depth (100). ' +
+                'This usually means Commands are producing Commands in an infinite cycle.');
+        }
+    }
+    return current;
+    /* eslint-enable @typescript-eslint/consistent-type-assertions */
+};
+/** Runs a function for side effects (e.g. assertions) without breaking the step chain. */
+export const tap = (f) => (simulation) => {
+    f(simulation);
+    return simulation;
+};
+// INTERACTION STEPS
+/** Simulates a click on the element matching the target. */
+export const click = (target) => (simulation) => invokeAndCapture(simulation, target, 'click', handler => {
+    handler();
+});
+/** Simulates form submission on the element matching the target. */
+export const submit = (target) => (simulation) => invokeAndCapture(simulation, target, 'submit', handler => {
+    handler({ preventDefault: Function.constVoid });
+});
+/** Simulates typing a value into the input matching the target.
+ *  Dual: `type(target, value)` or `type(value)` for data-last piping. */
+export { type_ as type };
+const type_ = dual(2, (target, value) => (simulation) => invokeAndCapture(simulation, target, 'input', handler => {
+    handler({ target: { value } });
+}));
+/** Simulates a keydown event on the element matching the target.
+ *  Dual: `keydown(target, key, modifiers?)` or `keydown(key, modifiers?)` for data-last piping. */
+export const keydown = dual((args) => args.length >= 2 && typeof args[1] === 'string', (target, key, modifiers) => (simulation) => invokeAndCapture(simulation, target, 'keydown', handler => {
+    handler({
+        key,
+        ...DEFAULT_KEYBOARD_MODIFIERS,
+        ...modifiers,
+        preventDefault: Function.constVoid,
+    });
+}));
+const wrapAssertion = (locator, assertion, isNot) => (simulation) => {
+    const internal = toInternal(simulation);
+    assertion(locator(internal.html), locator.description, isNot);
+    return simulation;
+};
+const assertOnElement = (check, expectation) => (maybeElement, description, isNot) => {
+    if (Option.isNone(maybeElement)) {
+        if (!isNot) {
+            throw new Error(`Expected element matching ${description} to ${expectation} but the element does not exist.`);
+        }
+        return;
+    }
+    const { pass, actual } = check(maybeElement.value);
+    if (isNot ? pass : !pass) {
+        throw new Error(isNot
+            ? `Expected element matching ${description} not to ${expectation} but it does.`
+            : `Expected element matching ${description} to ${expectation} but ${actual}.`);
+    }
+};
+const assertExists = (maybeElement, description, isNot) => {
+    const exists = Option.isSome(maybeElement);
+    if (isNot ? exists : !exists) {
+        throw new Error(isNot
+            ? `Expected element matching ${description} not to exist but it does.`
+            : `Expected element matching ${description} to exist but it does not.`);
+    }
+};
+const assertAbsent = (maybeElement, description, isNot) => {
+    const absent = Option.isNone(maybeElement);
+    if (isNot ? absent : !absent) {
+        throw new Error(isNot
+            ? `Expected element matching ${description} not to be absent but it is.`
+            : `Expected element matching ${description} to be absent but it exists.`);
+    }
+};
+const assertHasText = (expected) => assertOnElement(vnode => ({
+    pass: textContent(vnode) === expected,
+    actual: `received "${textContent(vnode)}"`,
+}), `have text "${expected}"`);
+const assertContainsText = (expected) => assertOnElement(vnode => ({
+    pass: textContent(vnode).includes(expected),
+    actual: `received "${textContent(vnode)}"`,
+}), `contain text "${expected}"`);
+const assertHasAttr = (name, value) => assertOnElement(vnode => {
+    const actualValue = attr(vnode, name);
+    if (Predicate.isUndefined(value)) {
+        return {
+            pass: Option.isSome(actualValue),
+            actual: 'the attribute is not present',
+        };
+    }
+    return Option.match(actualValue, {
+        onNone: () => ({
+            pass: false,
+            actual: 'the attribute is not present',
+        }),
+        onSome: actual => ({
+            pass: actual === value,
+            actual: `received "${actual}"`,
+        }),
+    });
+}, Predicate.isUndefined(value)
+    ? `have attribute "${name}"`
+    : `have attribute ${name}="${value}"`);
+const assertHasClass = (expected) => assertOnElement(vnode => ({
+    pass: vnode.data?.class?.[expected] === true,
+    actual: 'it does not',
+}), `have class "${expected}"`);
+const assertHasStyle = (name, value) => assertOnElement(vnode => {
+    const maybeActualValue = Option.fromNullable(vnode.data?.style?.[name]);
+    if (Predicate.isUndefined(value)) {
+        return {
+            pass: Option.isSome(maybeActualValue),
+            actual: 'it is not present',
+        };
+    }
+    return Option.match(maybeActualValue, {
+        onNone: () => ({ pass: false, actual: 'it is not present' }),
+        onSome: actualValue => ({
+            pass: String(actualValue) === value,
+            actual: `received "${actualValue}"`,
+        }),
+    });
+}, Predicate.isUndefined(value)
+    ? `have style "${name}"`
+    : `have style ${name}="${value}"`);
+const assertHasHook = (name) => assertOnElement(vnode => {
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+    const hooks = vnode.data?.hook;
+    return {
+        pass: typeof hooks?.[name] === 'function',
+        actual: 'it is not present',
+    };
+}, `have hook "${name}"`);
+const assertHasHandler = (name) => assertOnElement(vnode => ({
+    pass: vnode.data?.on?.[name] !== undefined,
+    actual: 'it is not present',
+}), `have handler "${name}"`);
+const assertHasValue = (expected) => assertOnElement(vnode => {
+    const actualValue = attr(vnode, 'value');
+    return Option.match(actualValue, {
+        onNone: () => ({
+            pass: false,
+            actual: 'the element has no value',
+        }),
+        onSome: actual => ({
+            pass: actual === expected,
+            actual: `received "${actual}"`,
+        }),
+    });
+}, `have value "${expected}"`);
+const isDisabled = (vnode) => {
+    const disabled = attr(vnode, 'disabled');
+    if (Option.isSome(disabled) && disabled.value !== 'false') {
+        return true;
+    }
+    const ariaDisabled = attr(vnode, 'aria-disabled');
+    return Option.isSome(ariaDisabled) && ariaDisabled.value === 'true';
+};
+const assertIsDisabled = assertOnElement(vnode => ({
+    pass: isDisabled(vnode),
+    actual: 'it is not disabled',
+}), 'be disabled');
+const assertIsEnabled = assertOnElement(vnode => ({
+    pass: !isDisabled(vnode),
+    actual: 'it is disabled',
+}), 'be enabled');
+const assertIsChecked = assertOnElement(vnode => {
+    const checked = attr(vnode, 'checked');
+    const ariaChecked = attr(vnode, 'aria-checked');
+    const pass = (Option.isSome(checked) && checked.value !== 'false') ||
+        (Option.isSome(ariaChecked) && ariaChecked.value === 'true');
+    return { pass, actual: 'it is not checked' };
+}, 'be checked');
+const buildExpectChain = (locator, isNot) => ({
+    toExist: () => wrapAssertion(locator, assertExists, isNot),
+    toBeAbsent: () => wrapAssertion(locator, assertAbsent, isNot),
+    toHaveText: (expected) => wrapAssertion(locator, assertHasText(expected), isNot),
+    toContainText: (expected) => wrapAssertion(locator, assertContainsText(expected), isNot),
+    toHaveAttr: (name, value) => wrapAssertion(locator, assertHasAttr(name, value), isNot),
+    toHaveClass: (expected) => wrapAssertion(locator, assertHasClass(expected), isNot),
+    toHaveStyle: (name, value) => wrapAssertion(locator, assertHasStyle(name, value), isNot),
+    toHaveHook: (name) => wrapAssertion(locator, assertHasHook(name), isNot),
+    toHaveHandler: (name) => wrapAssertion(locator, assertHasHandler(name), isNot),
+    toHaveValue: (expected) => wrapAssertion(locator, assertHasValue(expected), isNot),
+    toBeDisabled: () => wrapAssertion(locator, assertIsDisabled, isNot),
+    toBeEnabled: () => wrapAssertion(locator, assertIsEnabled, isNot),
+    toBeChecked: () => wrapAssertion(locator, assertIsChecked, isNot),
+});
+/** Creates an inline assertion step. Resolves the Locator against
+ *  the current view and asserts on the result. */
+export { expect_ as expect };
+const expect_ = (locator) => ({
+    ...buildExpectChain(locator, false),
+    not: buildExpectChain(locator, true),
+});
+// SUBMODEL VIEW ADAPTER
+/** Adapts a submodel view for Scene testing. In the Submodel pattern, the view
+ *  takes a `toParentMessage` function that maps child Messages to parent Messages.
+ *  Scene tests the child in isolation, so `childView` passes the identity function
+ *  and erases the parent type. */
+export const childView = (viewFn) => model => viewFn(model, message => message);
+// SCENE
+/** Executes a scene test. Throws if any Commands remain unresolved. */
+export const scene = (config, ...steps) => {
+    const capturingDispatch = createCapturingDispatch();
+    /* eslint-disable @typescript-eslint/consistent-type-assertions */
+    const seed = {
+        model: UNINITIALIZED,
+        message: undefined,
+        commands: [],
+        outMessage: undefined,
+        updateFn: config.update,
+        resolvers: {},
+        html: undefined,
+        viewFn: config.view,
+        capturingDispatch,
+    };
+    const result = steps.reduce((current, step) => {
+        const next = step(current);
+        const internal = toInternal(next);
+        if (internal.model !== UNINITIALIZED) {
+            const html = renderView(internal.viewFn, internal.model, internal.capturingDispatch.dispatch);
+            return { ...internal, html };
+        }
+        return next;
+    }, seed);
+    /* eslint-enable @typescript-eslint/consistent-type-assertions */
+    const internal = toInternal(result);
+    assertAllCommandsResolved(internal.commands);
+};

package/dist/test/{index.d.ts → story.d.ts}

@@ -1,10 +1,8 @@
 import type { CommandDefinition } from '../command';
-/** A Command in a test simulation, identified by name. */
-export type AnyCommand = Readonly<{
-    name: string;
-}>;
+import type { AnyCommand, ResolverPair } from './internal';
+export type { AnyCommand, ResolverPair };
 /** An immutable test simulation of a Foldkit program. */
-export type Simulation<Model, Message, OutMessage = undefined> = Readonly<{
+export type StorySimulation<Model, Message, OutMessage = undefined> = Readonly<{
     model: Model;
     message: Message | undefined;
     commands: ReadonlyArray<AnyCommand>;
@@ -13,28 +11,26 @@ export type Simulation<Model, Message, OutMessage = undefined> = Readonly<{
 /** A callable step that sets the initial Model. Carries phantom type for compile-time validation. */
 export type WithStep<Model> = Readonly<{
     _phantomModel: Model;
-}> & (<M, Message, OutMessage = undefined>(simulation: Simulation<M, Message, OutMessage>) => Simulation<M, Message, OutMessage>);
+}> & (<M, Message, OutMessage = undefined>(simulation: StorySimulation<M, Message, OutMessage>) => StorySimulation<M, Message, OutMessage>);
+/** A single step in a story — either a {@link WithStep} or a simulation transform. */
+export type StoryStep<Model, Message, OutMessage> = WithStep<NoInfer<Model>> | ((simulation: StorySimulation<Model, Message, OutMessage>) => StorySimulation<Model, Message, OutMessage>);
 /** Sets the initial Model for a test story. */
 export { with_ as with };
 declare const with_: <Model>(model: Model) => WithStep<Model>;
 /** Sends a Message through update. Commands stay pending until resolve or resolveAll. */
-export declare const message: <Message>(message_: NoInfer<Message>) => <Model, OutMessage = undefined>(simulation: Simulation<Model, Message, OutMessage>) => Simulation<Model, Message, OutMessage>;
+export declare const message: <Message>(message_: NoInfer<Message>) => <Model, OutMessage = undefined>(simulation: StorySimulation<Model, Message, OutMessage>) => StorySimulation<Model, Message, OutMessage>;
 /** Resolves a specific pending Command with the given result Message. */
 export declare const resolve: {
-    <Name extends string, ResultMessage>(definition: CommandDefinition<Name, ResultMessage>, resultMessage: ResultMessage): <Model, Message, OutMessage = undefined>(simulation: Simulation<Model, Message, OutMessage>) => Simulation<Model, Message, OutMessage>;
-    <Name extends string, ResultMessage, ParentMessage>(definition: CommandDefinition<Name, ResultMessage>, resultMessage: ResultMessage, toParentMessage: (message: ResultMessage) => ParentMessage): <Model, Message, OutMessage = undefined>(simulation: Simulation<Model, Message, OutMessage>) => Simulation<Model, Message, OutMessage>;
+    <Name extends string, ResultMessage>(definition: CommandDefinition<Name, ResultMessage>, resultMessage: ResultMessage): <Model, Message, OutMessage = undefined>(simulation: StorySimulation<Model, Message, OutMessage>) => StorySimulation<Model, Message, OutMessage>;
+    <Name extends string, ResultMessage, ParentMessage>(definition: CommandDefinition<Name, ResultMessage>, resultMessage: ResultMessage, toParentMessage: (message: ResultMessage) => ParentMessage): <Model, Message, OutMessage = undefined>(simulation: StorySimulation<Model, Message, OutMessage>) => StorySimulation<Model, Message, OutMessage>;
 };
-/** A Command definition paired with the result Message to resolve it with. */
-export type ResolverPair<Name extends string = string, ResultMessage = unknown> = readonly [CommandDefinition<Name, ResultMessage>, ResultMessage];
 /** Resolves all listed Commands with their result Messages. Handles cascading resolution. */
-export declare const resolveAll: (pairs: ReadonlyArray<ResolverPair>) => <Model, Message, OutMessage = undefined>(simulation: Simulation<Model, Message, OutMessage>) => Simulation<Model, Message, OutMessage>;
-/** Runs a function for side effects (e.g. assertions) without breaking the pipe chain. */
-export declare const tap: <Model, Message, OutMessage = undefined>(f: (simulation: Simulation<Model, Message, OutMessage>) => void) => (simulation: Simulation<Model, Message, OutMessage>) => Simulation<Model, Message, OutMessage>;
-/** A single step in a test story — either a {@link WithStep} or a simulation transform. */
-export type StoryStep<Model, Message, OutMessage> = WithStep<NoInfer<Model>> | ((simulation: Simulation<Model, Message, OutMessage>) => Simulation<Model, Message, OutMessage>);
+export declare const resolveAll: (pairs: ReadonlyArray<ResolverPair>) => <Model, Message, OutMessage = undefined>(simulation: StorySimulation<Model, Message, OutMessage>) => StorySimulation<Model, Message, OutMessage>;
+/** Runs a function for side effects (e.g. assertions) without breaking the step chain. */
+export declare const tap: <Model, Message, OutMessage = undefined>(f: (simulation: StorySimulation<Model, Message, OutMessage>) => void) => (simulation: StorySimulation<Model, Message, OutMessage>) => StorySimulation<Model, Message, OutMessage>;
 /** Executes a test story. Throws if any Commands remain unresolved. */
 export declare const story: {
     <Model, Message, OutMessage>(updateFn: (model: Model, message: Message) => readonly [Model, ReadonlyArray<AnyCommand>, OutMessage], ...steps: ReadonlyArray<StoryStep<Model, Message, OutMessage>>): void;
     <Model, Message>(updateFn: (model: Model, message: Message) => readonly [Model, ReadonlyArray<AnyCommand>], ...steps: ReadonlyArray<StoryStep<Model, Message, undefined>>): void;
 };
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=story.d.ts.map

package/dist/test/story.d.ts.map

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

package/dist/test/{index.js → story.js}

@@ -1,26 +1,9 @@
 import { Array, Predicate, pipe } from 'effect';
+import { assertAllCommandsResolved, assertNoUnresolvedCommands, resolveByName, } from './internal';
 const toInternal = (simulation) => 
 // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
 simulation;
-const resolveByName = (internal, commandName, resolverMessage) => {
-    const commandIndex = internal.commands.findIndex(({ name }) => name === commandName);
-    if (commandIndex === -1) {
-        return undefined;
-    }
-    const remainingCommands = Array.remove(internal.commands, commandIndex);
-    const result = internal.updateFn(internal.model, resolverMessage);
-    const nextModel = result[0];
-    const newCommands = result[1];
-    const outMessage = result.length === 3 ? result[2] : internal.outMessage;
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    return {
-        ...internal,
-        model: nextModel,
-        message: resolverMessage,
-        commands: Array.appendAll(remainingCommands, newCommands),
-        outMessage,
-    };
-};
+// STEPS
 /** Sets the initial Model for a test story. */
 export { with_ as with };
 const with_ = (model) => {
@@ -38,13 +21,7 @@ const with_ = (model) => {
 /** Sends a Message through update. Commands stay pending until resolve or resolveAll. */
 export const message = (message_) => (simulation) => {
     const internal = toInternal(simulation);
-    if (Array.isNonEmptyReadonlyArray(internal.commands)) {
-        const names = pipe(internal.commands, Array.map(({ name }) => `    ${name}`), Array.join('\n'));
-        throw new Error(`I found unresolved Commands when you sent a new Message:\n\n${names}\n\n` +
-            'Resolve all Commands before sending the next Message.\n' +
-            'Use Test.resolve(Definition, ResultMessage) for each one,\n' +
-            'or Test.resolveAll([...pairs]) to resolve them all at once.');
-    }
+    assertNoUnresolvedCommands(internal.commands, 'when you sent a new Message');
     const result = internal.updateFn(internal.model, message_);
     const nextModel = result[0];
     const commands = result[1];
@@ -85,6 +62,7 @@ export const resolveAll = (pairs) => (simulation) => {
         // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
         resolvers[definition.name] = resultMessage;
     }
+    /* eslint-disable @typescript-eslint/consistent-type-assertions */
     let current = {
         ...internal,
         resolvers: { ...internal.resolvers, ...resolvers },
@@ -99,21 +77,21 @@ export const resolveAll = (pairs) => (simulation) => {
         if (Predicate.isUndefined(next)) {
             break;
         }
-        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
         current = next;
         if (depth === MAX_CASCADE_DEPTH - 1) {
             throw new Error('resolveAll hit the maximum cascade depth (100). ' +
                 'This usually means Commands are producing Commands in an infinite cycle.');
         }
     }
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     return current;
+    /* eslint-enable @typescript-eslint/consistent-type-assertions */
 };
-/** Runs a function for side effects (e.g. assertions) without breaking the pipe chain. */
+/** Runs a function for side effects (e.g. assertions) without breaking the step chain. */
 export const tap = (f) => (simulation) => {
     f(simulation);
     return simulation;
 };
+// STORY
 /** Executes a test story. Throws if any Commands remain unresolved. */
 export const story = (updateFn, ...steps) => {
     /* eslint-disable @typescript-eslint/consistent-type-assertions */
@@ -128,11 +106,5 @@ export const story = (updateFn, ...steps) => {
     const result = steps.reduce((current, step) => step(current), seed);
     /* eslint-enable @typescript-eslint/consistent-type-assertions */
     const internal = toInternal(result);
-    if (Array.isNonEmptyReadonlyArray(internal.commands)) {
-        const names = pipe(internal.commands, Array.map(({ name }) => `    ${name}`), Array.join('\n'));
-        throw new Error(`I found Commands without resolvers:\n\n${names}\n\n` +
-            'Every Command produced by update needs to be resolved.\n' +
-            'Use Test.resolve(Definition, ResultMessage) for each one,\n' +
-            'or Test.resolveAll([...pairs]) to resolve them all at once.');
-    }
+    assertAllCommandsResolved(internal.commands);
 };

package/dist/test/vitest-setup.d.ts

@@ -0,0 +1,19 @@
+declare module 'vitest' {
+    interface Assertion<T> {
+        toHaveText(expected: string): this;
+        toContainText(expected: string): this;
+        toHaveClass(expected: string): this;
+        toHaveAttr(name: string, value?: string): this;
+        toHaveStyle(name: string, value?: string): this;
+        toHaveHook(name: string): this;
+        toHaveHandler(name: string): this;
+        toHaveValue(expected: string): this;
+        toBeDisabled(): this;
+        toBeEnabled(): this;
+        toBeChecked(): this;
+        toExist(): this;
+        toBeAbsent(): this;
+    }
+}
+export {};
+//# sourceMappingURL=vitest-setup.d.ts.map

package/dist/test/vitest-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.d.ts","sourceRoot":"","sources":["../../src/test/vitest-setup.ts"],"names":[],"mappings":"AAIA,OAAO,QAAQ,QAAQ,CAAC;IAEtB,UAAU,SAAS,CAAC,CAAC;QACnB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QAClC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACrC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACnC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC9C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QAC9B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACjC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACnC,YAAY,IAAI,IAAI,CAAA;QACpB,WAAW,IAAI,IAAI,CAAA;QACnB,WAAW,IAAI,IAAI,CAAA;QACnB,OAAO,IAAI,IAAI,CAAA;QACf,UAAU,IAAI,IAAI,CAAA;KACnB;CACF"}

package/dist/test/vitest-setup.js

@@ -0,0 +1,3 @@
+import { expect } from 'vitest';
+import { sceneMatchers } from './matchers';
+expect.extend(sceneMatchers);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foldkit",
-  "version": "0.43.2",
+  "version": "0.44.0",
   "description": "A frontend framework for TypeScript, built on Effect, using The Elm Architecture",
   "type": "module",
   "main": "./dist/index.js",
@@ -174,10 +174,10 @@
   },
   "scripts": {
     "clean": "rimraf dist *.tsbuildinfo",
-    "build": "pnpm run clean && node scripts/inline-css.js && tsc -b",
-    "watch": "node scripts/inline-css.js && tsc -b --watch",
-    "lint": "eslint src --ignore-pattern '**/*.test.ts'",
-    "typecheck": "node scripts/inline-css.js && tsc -b --noEmit",
+    "build": "pnpm run clean && node scripts/inline-css.js && tsc -b tsconfig.build.json",
+    "watch": "node scripts/inline-css.js && tsc -b tsconfig.build.json --watch",
+    "lint": "eslint src",
+    "typecheck": "node scripts/inline-css.js && tsc -b tsconfig.build.json --noEmit",
     "test": "vitest run",
     "docs": "typedoc"
   }

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEnD,yDAAyD;AACzD,MAAM,MAAM,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,IAAI,QAAQ,CAAC;IACxE,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IACnC,UAAU,EAAE,UAAU,CAAA;CACvB,CAAC,CAAA;AAEF,qGAAqG;AACrG,MAAM,MAAM,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC;IAAE,aAAa,EAAE,KAAK,CAAA;CAAE,CAAC,GAC9D,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,EAClC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,KAC3C,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;AAsD1C,+CAA+C;AAC/C,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,CAAA;AACxB,QAAA,MAAM,KAAK,GAAI,KAAK,EAAE,OAAO,KAAK,KAAG,QAAQ,CAAC,KAAK,CAiBlD,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,OAAO,GACjB,OAAO,EAAE,UAAU,OAAO,CAAC,OAAO,CAAC,MACnC,KAAK,EAAE,UAAU,GAAG,SAAS,EAC5B,YAAY,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KACjD,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CA8BvC,CAAA;AAEH,yEAAyE;AACzE,eAAO,MAAM,OAAO,EAAE;IACpB,CAAC,IAAI,SAAS,MAAM,EAAE,aAAa,EACjC,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,EAClD,aAAa,EAAE,aAAa,GAC3B,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,EACxC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAC/C,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;IAC3C,CAAC,IAAI,SAAS,MAAM,EAAE,aAAa,EAAE,aAAa,EAChD,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,EAClD,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,GACzD,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,EACxC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAC/C,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;CAkC1C,CAAA;AAEH,8EAA8E;AAC9E,MAAM,MAAM,YAAY,CACtB,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,aAAa,GAAG,OAAO,IACrB,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,aAAa,CAAC,CAAA;AAEpE,6FAA6F;AAC7F,eAAO,MAAM,UAAU,GACpB,OAAO,aAAa,CAAC,YAAY,CAAC,MAClC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,EACrC,YAAY,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KACjD,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CA+CvC,CAAA;AAEH,0FAA0F;AAC1F,eAAO,MAAM,GAAG,GACb,KAAK,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,EACrC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,IAAI,MAG/D,YAAY,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KACjD,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAGvC,CAAA;AAEH,2FAA2F;AAC3F,MAAM,MAAM,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,IAC5C,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GACxB,CAAC,CACC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAC/C,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;AAEhD,uEAAuE;AACvE,eAAO,MAAM,KAAK,EAAE;IAClB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EACzB,QAAQ,EAAE,CACR,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,KACb,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,EAC5D,GAAG,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,GAC7D,IAAI,CAAA;IACP,CAAC,KAAK,EAAE,OAAO,EACb,QAAQ,EAAE,CACR,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,KACb,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAChD,GAAG,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,GAC5D,IAAI,CAAA;CAyCR,CAAA"}