@vanrot/testing 0.1.0 → 0.2.0

package/dist/accessibility.d.ts

@@ -0,0 +1,19 @@
+export interface AccessibilityAssertionsOptions {
+    source?: string;
+}
+export interface RoleAssertionOptions {
+    name?: string | RegExp;
+}
+export interface AccessibilityAssertions {
+    readonly expect: {
+        role(role: string, options?: RoleAssertionOptions): HTMLElement;
+        enabled(role: string, options?: RoleAssertionOptions): void;
+        disabled(role: string, options?: RoleAssertionOptions): void;
+        focusOn(element: Element): void;
+        focusMoves(from: HTMLElement, to: HTMLElement, action: () => void | Promise<void>): Promise<void>;
+        semanticButton(element: Element): void;
+    };
+}
+export declare function createAccessibilityAssertions(root: Element, options?: AccessibilityAssertionsOptions): AccessibilityAssertions;
+export declare function findByRole(root: Element, role: string, options?: RoleAssertionOptions): HTMLElement | null;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../src/accessibility.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE;QACf,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,WAAW,CAAC;QAChE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;QAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;QAC7D,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;QAChC,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClG,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;KACxC,CAAC;CACH;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAuEzB;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,WAAW,GAAG,IAAI,CAmBpB"}

package/dist/accessibility.js

@@ -0,0 +1,133 @@
+import { expect } from 'vitest';
+export function createAccessibilityAssertions(root, options = {}) {
+    return {
+        expect: {
+            role(role, roleOptions = {}) {
+                const element = findByRole(root, role, roleOptions);
+                if (element === null) {
+                    throw new Error(message(options, `Expected role "${role}"${formatName(roleOptions)}.`));
+                }
+                return element;
+            },
+            enabled(role, roleOptions = {}) {
+                const element = findByRole(root, role, roleOptions);
+                if (element === null) {
+                    throw new Error(message(options, `Expected enabled role "${role}"${formatName(roleOptions)}.`));
+                }
+                expect(isDisabled(element), message(options, `Expected role "${role}" to be enabled.`)).toBe(false);
+            },
+            disabled(role, roleOptions = {}) {
+                const element = findByRole(root, role, roleOptions);
+                if (element === null) {
+                    throw new Error(message(options, `Expected disabled role "${role}"${formatName(roleOptions)}.`));
+                }
+                expect(isDisabled(element), message(options, `Expected role "${role}" to be disabled.`)).toBe(true);
+            },
+            focusOn(element) {
+                expect(document.activeElement, message(options, `Expected focus on <${element.tagName.toLowerCase()}>.`)).toBe(element);
+            },
+            async focusMoves(from, to, action) {
+                from.focus();
+                await action();
+                await Promise.resolve();
+                expect(document.activeElement, message(options, `Expected focus to move from <${from.tagName.toLowerCase()}> to <${to.tagName.toLowerCase()}>.`)).toBe(to);
+            },
+            semanticButton(element) {
+                if (element.tagName.toLowerCase() === 'button') {
+                    return;
+                }
+                throw new Error(message(options, `Expected a semantic <button> for role "button", received <${element.tagName.toLowerCase()}>.`));
+            },
+        },
+    };
+}
+export function findByRole(root, role, options = {}) {
+    const elements = root instanceof HTMLElement
+        ? [root, ...Array.from(root.querySelectorAll('*'))]
+        : Array.from(root.querySelectorAll('*'));
+    for (const element of elements) {
+        if (readRole(element) !== role) {
+            continue;
+        }
+        if (options.name !== undefined && !matchesName(readAccessibleName(element), options.name)) {
+            continue;
+        }
+        return element;
+    }
+    return null;
+}
+function readRole(element) {
+    const explicitRole = element.getAttribute('role');
+    if (explicitRole !== null && explicitRole.length > 0) {
+        return explicitRole;
+    }
+    const tagName = element.tagName.toLowerCase();
+    if (tagName === 'button') {
+        return 'button';
+    }
+    if (tagName === 'a' && element.hasAttribute('href')) {
+        return 'link';
+    }
+    if (tagName === 'input') {
+        return readInputRole(element);
+    }
+    if (/^h[1-6]$/.test(tagName)) {
+        return 'heading';
+    }
+    return null;
+}
+function readInputRole(input) {
+    if (input.type === 'checkbox') {
+        return 'checkbox';
+    }
+    if (input.type === 'radio') {
+        return 'radio';
+    }
+    if (input.type === 'button' || input.type === 'submit' || input.type === 'reset') {
+        return 'button';
+    }
+    return 'textbox';
+}
+function readAccessibleName(element) {
+    const ariaLabel = element.getAttribute('aria-label');
+    if (ariaLabel !== null) {
+        return ariaLabel.trim();
+    }
+    const labelledBy = element.getAttribute('aria-labelledby');
+    if (labelledBy !== null) {
+        return labelledBy
+            .split(/\s+/)
+            .map((id) => document.getElementById(id)?.textContent?.trim() ?? '')
+            .filter((value) => value.length > 0)
+            .join(' ');
+    }
+    if (element instanceof HTMLInputElement && element.value.length > 0) {
+        return element.value;
+    }
+    return (element.textContent ?? '').replace(/\s+/g, ' ').trim();
+}
+function matchesName(actual, expected) {
+    if (typeof expected === 'string') {
+        return actual === expected;
+    }
+    return expected.test(actual);
+}
+function isDisabled(element) {
+    if (element.getAttribute('aria-disabled') === 'true') {
+        return true;
+    }
+    return 'disabled' in element && Boolean(element.disabled);
+}
+function formatName(options) {
+    if (options.name === undefined) {
+        return '';
+    }
+    return ` named "${String(options.name)}"`;
+}
+function message(options, text) {
+    if (options.source === undefined) {
+        return text;
+    }
+    return `${options.source}: ${text}`;
+}
+//# sourceMappingURL=accessibility.js.map

package/dist/accessibility.js.map

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

package/dist/async.d.ts

@@ -0,0 +1,31 @@
+export interface FlushTestingTasksOptions {
+    turns?: number;
+}
+export interface WaitForDomUpdateOptions {
+    timeoutMs?: number;
+    intervalMs?: number;
+    message?: string;
+}
+export interface VitestTimerLike {
+    advanceTimersByTimeAsync?: (ms: number) => Promise<unknown>;
+    advanceTimersByTime?: (ms: number) => unknown;
+    runOnlyPendingTimersAsync?: () => Promise<unknown>;
+    runOnlyPendingTimers?: () => unknown;
+}
+export interface FakeTimerBridge {
+    advanceBy(ms: number): Promise<void>;
+    runPending(): Promise<void>;
+    flush(): Promise<void>;
+}
+export interface AsyncTestScope {
+    addAbortController(controller: AbortController): void;
+    addCleanup(cleanup: () => void | Promise<void>): void;
+    track<T>(promise: Promise<T>): Promise<T>;
+    pendingCount(): number;
+    cleanup(): Promise<void>;
+}
+export declare function flushTestingTasks(options?: FlushTestingTasksOptions): Promise<void>;
+export declare function waitForDomUpdate(assertion: () => void | Promise<void>, options?: WaitForDomUpdateOptions): Promise<void>;
+export declare function createFakeTimerBridge(timers: VitestTimerLike): FakeTimerBridge;
+export declare function createAsyncTestScope(): AsyncTestScope;
+//# sourceMappingURL=async.d.ts.map

package/dist/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../src/async.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,wBAAwB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACtD,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,YAAY,IAAI,MAAM,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7F;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACrC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAwB9E;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CA4CrD"}

package/dist/async.js

@@ -0,0 +1,95 @@
+export async function flushTestingTasks(options = {}) {
+    const turns = options.turns ?? 1;
+    for (let turn = 0; turn < turns; turn += 1) {
+        await Promise.resolve();
+    }
+}
+export async function waitForDomUpdate(assertion, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 1000;
+    const intervalMs = options.intervalMs ?? 5;
+    const startedAt = Date.now();
+    let lastError;
+    while (Date.now() - startedAt <= timeoutMs) {
+        try {
+            await assertion();
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            await sleep(intervalMs);
+            await flushTestingTasks();
+        }
+    }
+    const detail = lastError instanceof Error ? lastError.message : String(lastError);
+    throw new Error(options.message ?? `Timed out waiting for DOM update. Last error: ${detail}`);
+}
+export function createFakeTimerBridge(timers) {
+    return {
+        async advanceBy(ms) {
+            if (timers.advanceTimersByTimeAsync !== undefined) {
+                await timers.advanceTimersByTimeAsync(ms);
+            }
+            else {
+                timers.advanceTimersByTime?.(ms);
+            }
+            await flushTestingTasks();
+        },
+        async runPending() {
+            if (timers.runOnlyPendingTimersAsync !== undefined) {
+                await timers.runOnlyPendingTimersAsync();
+            }
+            else {
+                timers.runOnlyPendingTimers?.();
+            }
+            await flushTestingTasks();
+        },
+        async flush() {
+            await this.runPending();
+        },
+    };
+}
+export function createAsyncTestScope() {
+    const pending = new Set();
+    const cleanups = [];
+    const abortControllers = [];
+    let cleaned = false;
+    return {
+        addAbortController(controller) {
+            abortControllers.push(controller);
+        },
+        addCleanup(cleanup) {
+            cleanups.push(cleanup);
+        },
+        track(promise) {
+            let tracked;
+            tracked = promise.finally(() => {
+                pending.delete(tracked);
+            });
+            pending.add(tracked);
+            return tracked;
+        },
+        pendingCount() {
+            return pending.size;
+        },
+        async cleanup() {
+            if (cleaned) {
+                return;
+            }
+            cleaned = true;
+            for (const controller of abortControllers) {
+                controller.abort();
+            }
+            await Promise.allSettled([...pending]);
+            for (const cleanup of cleanups.reverse()) {
+                await cleanup();
+            }
+            await flushTestingTasks();
+        },
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=async.js.map

package/dist/async.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,12 @@
 export type { ComponentTestBody, ComponentTestBuilder, } from './component-test.js';
 export { testComponent } from './component-test.js';
 export type { Screen } from './screen.js';
+export type { PageTestBody, PageTestBuilder, PageTestCleanup, PageTestHarness } from './page-test.js';
+export { runPageTest, testPage } from './page-test.js';
+export type { AccessibilityAssertions, AccessibilityAssertionsOptions, RoleAssertionOptions, } from './accessibility.js';
+export { createAccessibilityAssertions, findByRole } from './accessibility.js';
+export type { AsyncTestScope, FakeTimerBridge, FlushTestingTasksOptions, VitestTimerLike, WaitForDomUpdateOptions, } from './async.js';
+export { createAsyncTestScope, createFakeTimerBridge, flushTestingTasks, waitForDomUpdate, } from './async.js';
+export type { RouterTestHarness, RouterTestOptions } from './router.js';
+export { setupRouterTest } from './router.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtG,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EACV,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,6BAA6B,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EACV,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,2 +1,6 @@
 export { testComponent } from './component-test.js';
+export { runPageTest, testPage } from './page-test.js';
+export { createAccessibilityAssertions, findByRole } from './accessibility.js';
+export { createAsyncTestScope, createFakeTimerBridge, flushTestingTasks, waitForDomUpdate, } from './async.js';
+export { setupRouterTest } from './router.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAMvD,OAAO,EAAE,6BAA6B,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQ/E,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/page-test.d.ts

@@ -0,0 +1,19 @@
+import { type ComponentType } from '@vanrot/runtime';
+import { type Screen } from './screen.js';
+export type PageTestCleanup = () => void | Promise<void>;
+export type PageTestBody = (page: PageTestHarness) => void | Promise<void>;
+export interface PageTestBuilder {
+    can(description: string, body: PageTestBody): void;
+}
+export interface PageTestHarness {
+    readonly root: HTMLElement;
+    readonly target: HTMLElement;
+    readonly screen: Screen;
+    readonly click: Screen['click'];
+    addCleanup(cleanup: PageTestCleanup): void;
+    rerender(Component: ComponentType): Promise<void>;
+    cleanup(): Promise<void>;
+}
+export declare function testPage(Page: ComponentType): PageTestBuilder;
+export declare function runPageTest(Page: ComponentType, body: PageTestBody): Promise<void>;
+//# sourceMappingURL=page-test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page-test.d.ts","sourceRoot":"","sources":["../src/page-test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAQ7D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDxF"}

package/dist/page-test.js

@@ -0,0 +1,59 @@
+import { mount } from '@vanrot/runtime';
+import { test } from 'vitest';
+import { createScreen } from './screen.js';
+export function testPage(Page) {
+    return {
+        can(description, body) {
+            test(description, async function () {
+                await runPageTest(Page, body);
+            });
+        },
+    };
+}
+export async function runPageTest(Page, body) {
+    const target = document.createElement('main');
+    target.setAttribute('data-vanrot-test-page-root', '');
+    document.body.append(target);
+    let app = null;
+    let cleaned = false;
+    const cleanups = [];
+    const screen = createScreen(target);
+    const mountPage = (Component) => {
+        app?.destroy();
+        target.replaceChildren();
+        app = mount(Component, target);
+    };
+    const cleanup = async () => {
+        if (cleaned) {
+            return;
+        }
+        cleaned = true;
+        app?.destroy();
+        app = null;
+        target.remove();
+        for (const registeredCleanup of cleanups.reverse()) {
+            await registeredCleanup();
+        }
+    };
+    const harness = {
+        root: target,
+        target,
+        screen,
+        click: screen.click,
+        addCleanup(registeredCleanup) {
+            cleanups.push(registeredCleanup);
+        },
+        async rerender(Component) {
+            mountPage(Component);
+        },
+        cleanup,
+    };
+    mountPage(Page);
+    try {
+        await body(harness);
+    }
+    finally {
+        await cleanup();
+    }
+}
+//# sourceMappingURL=page-test.js.map

package/dist/page-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-test.js","sourceRoot":"","sources":["../src/page-test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAsC,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAmBxD,MAAM,UAAU,QAAQ,CAAC,IAAmB;IAC1C,OAAO;QACL,GAAG,CAAC,WAAmB,EAAE,IAAkB;YACzC,IAAI,CAAC,WAAW,EAAE,KAAK;gBACrB,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAmB,EAAE,IAAkB;IACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,CAAC,YAAY,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE7B,IAAI,GAAG,GAAqB,IAAI,CAAC;IACjC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,CAAC,SAAwB,EAAQ,EAAE;QACnD,GAAG,EAAE,OAAO,EAAE,CAAC;QACf,MAAM,CAAC,eAAe,EAAE,CAAC;QACzB,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,OAAO,GAAG,IAAI,CAAC;QACf,GAAG,EAAE,OAAO,EAAE,CAAC;QACf,GAAG,GAAG,IAAI,CAAC;QACX,MAAM,CAAC,MAAM,EAAE,CAAC;QAEhB,KAAK,MAAM,iBAAiB,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACnD,MAAM,iBAAiB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAAoB;QAC/B,IAAI,EAAE,MAAM;QACZ,MAAM;QACN,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,CAAC,iBAAkC;YAC3C,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,SAAwB;YACrC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QACD,OAAO;KACR,CAAC;IAEF,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,21 @@
+import { type DefinedRoute, type DefinedRouteTable, type RouteParams, type RouteQuery, type RouteUrlInput } from '@vanrot/router';
+export interface RouterTestOptions {
+    initialRoute?: DefinedRoute;
+    initialPath?: string;
+    params?: RouteParams;
+    query?: RouteQuery;
+}
+export interface RouterTestHarness {
+    readonly routes: DefinedRouteTable;
+    routeUrl(route: DefinedRoute, input?: RouteUrlInput): string;
+    navigate(route: DefinedRoute, input?: RouteUrlInput): Promise<boolean>;
+    cleanup(): Promise<void>;
+    readonly expect: {
+        currentRoute(route: DefinedRoute): void;
+        currentPath(path: string): void;
+        params(params: RouteParams): void;
+        query(query: RouteQuery): void;
+    };
+}
+export declare function setupRouterTest(routes: DefinedRouteTable, options?: RouterTestOptions): Promise<RouterTestHarness>;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE;QACf,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;QACxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;QAClC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;KAChC,CAAC;CACH;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAkE5B"}

package/dist/router.js

@@ -0,0 +1,82 @@
+import { buildRouteUrl, getCurrentRouteChain, navigate as navigatePath, provideRouter, resolveRoutePage, } from '@vanrot/router';
+import { resetRouterForTests } from '@vanrot/router/internal';
+import { expect } from 'vitest';
+export async function setupRouterTest(routes, options = {}) {
+    let cleaned = false;
+    resetRouterForTests();
+    const initialPath = options.initialPath ??
+        (options.initialRoute !== undefined
+            ? buildRouteUrl(options.initialRoute, routeUrlInputFromOptions(options))
+            : '/');
+    window.history.replaceState(null, '', initialPath);
+    await provideRouter(routes);
+    await resolveCurrentPage();
+    const assertActive = () => {
+        if (cleaned) {
+            throw new Error('Router test has already been cleaned up.');
+        }
+    };
+    const harness = {
+        routes,
+        routeUrl(route, input = {}) {
+            assertActive();
+            return buildRouteUrl(route, input);
+        },
+        async navigate(route, input = {}) {
+            assertActive();
+            const didNavigate = await navigatePath(buildRouteUrl(route, input));
+            if (didNavigate) {
+                await resolveCurrentPage();
+            }
+            return didNavigate;
+        },
+        async cleanup() {
+            if (cleaned) {
+                return;
+            }
+            cleaned = true;
+            resetRouterForTests();
+            window.history.replaceState(null, '', '/');
+        },
+        expect: {
+            currentRoute(route) {
+                assertActive();
+                expect(readCurrentRoute()?.route).toBe(route);
+            },
+            currentPath(path) {
+                assertActive();
+                expect(`${window.location.pathname}${window.location.search}`).toBe(path);
+            },
+            params(params) {
+                assertActive();
+                expect(readCurrentRoute()?.params).toEqual(params);
+            },
+            query(query) {
+                assertActive();
+                expect(readCurrentRoute()?.query).toEqual(query);
+            },
+        },
+    };
+    return harness;
+}
+function readCurrentRoute() {
+    const chain = getCurrentRouteChain();
+    if (chain === null) {
+        return null;
+    }
+    return chain.chain[chain.chain.length - 1] ?? null;
+}
+function routeUrlInputFromOptions(options) {
+    return {
+        ...(options.params !== undefined ? { params: options.params } : {}),
+        ...(options.query !== undefined ? { query: options.query } : {}),
+    };
+}
+async function resolveCurrentPage() {
+    const match = readCurrentRoute();
+    if (match === null) {
+        return;
+    }
+    await resolveRoutePage(match.route);
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanrot/testing",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "engines": {
     "node": ">=22.14.0"
@@ -18,6 +18,7 @@
     "dist"
   ],
   "dependencies": {
+    "@vanrot/router": "0.2.0",
     "@vanrot/runtime": "0.1.0"
   },
   "peerDependencies": {
@@ -27,11 +28,11 @@
     "vitest": "^4.0.14"
   },
   "scripts": {
-    "prebuild": "pnpm --filter @vanrot/runtime build",
+    "prebuild": "pnpm --filter @vanrot/router build",
     "build": "tsc -p tsconfig.json",
-    "pretypecheck": "pnpm --filter @vanrot/runtime build",
+    "pretypecheck": "pnpm --filter @vanrot/router build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "pretest": "pnpm --filter @vanrot/runtime build",
+    "pretest": "pnpm --filter @vanrot/router build",
     "test": "vitest run",
     "clean": "node -e \"import('node:fs').then(({ rmSync }) => rmSync('dist', { recursive: true, force: true }))\""
   },