@vobs/test-utils 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vobsjs
+
+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/dist/index.d.ts

@@ -0,0 +1,57 @@
+/** @license MIT
+ * Copyright (c) 2026 vobsjs
+ * @vobs/test-utils
+ */
+import { type I18nInstance, type I18nOptions } from '@vobs/i18n';
+import { type IconDefinition, type IconRegistry } from '@vobs/icons';
+import type { PageEnvironment, PageInstance, TemplateEnvironment } from '@vobs/runtime-core';
+import { type PageDefinition } from '@vobs/runtime-dom';
+import { type RenderPageOptions, type RenderPageResult } from '@vobs/server-renderer';
+import { type ThemeController, type ThemeControllerOptions, type ThemeTarget } from '@vobs/ui';
+import { type UiEnvironment } from '@vobs/ui/icons';
+export interface TestEnvironmentOptions extends Partial<PageEnvironment> {
+    readonly baseUrl?: string;
+    readonly errors?: unknown[];
+}
+export interface TestContainer extends Element {
+    readonly items: Element[];
+}
+export interface TestPageHarness {
+    readonly container: TestContainer;
+    readonly environment: PageEnvironment;
+    readonly instance: PageInstance;
+    cleanup(): void;
+}
+export interface UiTestContextOptions {
+    readonly i18n?: I18nOptions;
+    readonly icons?: Readonly<Record<string, IconDefinition>>;
+    readonly theme?: Omit<ThemeControllerOptions, 'target'>;
+}
+export interface UiTestContext {
+    readonly i18n: I18nInstance;
+    readonly icons: IconRegistry;
+    readonly ui: UiEnvironment;
+    readonly themeTarget: TestThemeTarget;
+    readonly theme: ThemeController;
+    cleanup(): void;
+}
+export interface TestThemeTarget extends ThemeTarget {
+    readonly attributes: Readonly<Record<string, string>>;
+    readonly variables: ReadonlyMap<string, string>;
+}
+export declare function createTestEnvironment(options?: TestEnvironmentOptions): PageEnvironment;
+export declare function createTestContainer(initialRoot?: Element): TestContainer;
+export declare function mountTestPage(page: PageDefinition, options?: {
+    readonly container?: TestContainer;
+    readonly environment?: TestEnvironmentOptions;
+}): Promise<TestPageHarness>;
+export declare function hydrateTestPage(page: PageDefinition, options: {
+    readonly container: TestContainer;
+    readonly environment?: TestEnvironmentOptions;
+}): Promise<TestPageHarness>;
+export declare function renderTestPage<Scope extends object, InitialState = unknown>(options: Omit<RenderPageOptions<Scope, InitialState>, 'environment'> & {
+    readonly environment?: TemplateEnvironment;
+}): RenderPageResult;
+export declare function createUiTestContext(options?: UiTestContextOptions): UiTestContext;
+export declare function createThemeTestTarget(): TestThemeTarget;
+export declare function cleanup(): void;

package/dist/index.js

@@ -0,0 +1,146 @@
+/** @license MIT
+ * Copyright (c) 2026 vobsjs
+ * @vobs/test-utils
+ */
+import { createI18n } from '@vobs/i18n';
+import { createIconRegistry } from '@vobs/icons';
+import { Scheduler } from '@vobs/reactivity';
+import { createDefaultUrlPolicy } from '@vobs/runtime-dom';
+import { renderPage } from '@vobs/server-renderer';
+import { createThemeController, } from '@vobs/ui';
+import { createUiEnvironment } from '@vobs/ui/icons';
+const cleanups = new Set();
+export function createTestEnvironment(options = {}) {
+    const errors = options.errors;
+    const environment = {
+        scheduler: options.scheduler ?? new Scheduler(),
+        security: options.security ?? {
+            urlPolicy: createDefaultUrlPolicy(options.baseUrl ?? 'https://example.test/'),
+        },
+        onError: options.onError ??
+            ((error) => {
+                errors?.push(error);
+                if (errors === undefined)
+                    throw error;
+            }),
+        ...(options.components === undefined ? {} : { components: options.components }),
+        ...(options.slots === undefined ? {} : { slots: options.slots }),
+        ...(options.route === undefined ? {} : { route: options.route }),
+        ...(options.initialState === undefined ? {} : { initialState: options.initialState }),
+    };
+    return environment;
+}
+export function createTestContainer(initialRoot) {
+    const items = initialRoot === undefined ? [] : [initialRoot];
+    const appendNodes = (nodes) => {
+        for (const node of nodes) {
+            if (typeof node !== 'string')
+                items.push(node);
+        }
+    };
+    return {
+        items,
+        get firstElementChild() {
+            return items[0] ?? null;
+        },
+        append(...nodes) {
+            appendNodes(nodes);
+        },
+        replaceChildren(...nodes) {
+            items.length = 0;
+            appendNodes(nodes);
+        },
+        querySelectorAll() {
+            return [];
+        },
+    };
+}
+export async function mountTestPage(page, options = {}) {
+    const container = options.container ?? createTestContainer();
+    const environment = createTestEnvironment(options.environment);
+    const instance = await page.mount(environment);
+    container.append(instance.root);
+    return createPageHarness(container, environment, instance);
+}
+export async function hydrateTestPage(page, options) {
+    const environment = createTestEnvironment(options.environment);
+    const instance = await page.hydrate(options.container, environment);
+    return createPageHarness(options.container, environment, instance);
+}
+export function renderTestPage(options) {
+    return renderPage({
+        ...options,
+        environment: options.environment ?? createTestEnvironment(),
+    });
+}
+export function createUiTestContext(options = {}) {
+    const i18n = createI18n(options.i18n ?? { locale: 'en-US', messages: {} });
+    const icons = createIconRegistry(options.icons ?? {});
+    const ui = createUiEnvironment({ icons });
+    const themeTarget = createThemeTestTarget();
+    const theme = createThemeController({
+        target: themeTarget,
+        ...(options.theme ?? {}),
+    });
+    const cleanup = trackCleanup(() => {
+        theme.destroy();
+    });
+    return {
+        i18n,
+        icons,
+        ui,
+        themeTarget,
+        theme,
+        cleanup,
+    };
+}
+export function createThemeTestTarget() {
+    const attributes = {};
+    const variables = new Map();
+    return {
+        attributes,
+        variables,
+        setAttribute(name, value) {
+            attributes[name] = value;
+        },
+        style: {
+            setProperty(name, value) {
+                variables.set(name, value);
+            },
+            removeProperty(name) {
+                const current = variables.get(name) ?? '';
+                variables.delete(name);
+                return current;
+            },
+        },
+    };
+}
+export function cleanup() {
+    const pending = Array.from(cleanups).reverse();
+    cleanups.clear();
+    for (const dispose of pending)
+        dispose();
+}
+function createPageHarness(container, environment, instance) {
+    const cleanupHarness = trackCleanup(() => {
+        instance.destroy();
+    });
+    return {
+        container,
+        environment,
+        instance,
+        cleanup: cleanupHarness,
+    };
+}
+function trackCleanup(dispose) {
+    let active = true;
+    const cleanupOnce = () => {
+        if (!active)
+            return;
+        active = false;
+        cleanups.delete(cleanupOnce);
+        dispose();
+    };
+    cleanups.add(cleanupOnce);
+    return cleanupOnce;
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@vobs/test-utils",
+  "version": "0.1.0",
+  "description": "Mount, hydrate and cleanup test harnesses for vobs applications and components.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "vobsjs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vobsjs/vobs.git",
+    "directory": "packages/tools/test-utils"
+  },
+  "bugs": {
+    "url": "https://github.com/vobsjs/vobs/issues"
+  },
+  "homepage": "https://github.com/vobsjs/vobs#readme",
+  "dependencies": {
+    "@vobs/icons": "0.1.0",
+    "@vobs/i18n": "0.1.0",
+    "@vobs/reactivity": "0.1.0",
+    "@vobs/runtime-core": "0.1.0",
+    "@vobs/runtime-dom": "0.1.0",
+    "@vobs/server-renderer": "0.1.0",
+    "@vobs/ui": "0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "main": "./dist/index.js",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}