@vnejs/test-utils 0.1.1

package/dist/create-core-global-state.d.ts

@@ -0,0 +1,4 @@
+export declare const createCoreGlobalState: (overrides?: Record<string, unknown>) => {
+    stack: import("@vnejs/contracts.core.stack").ModuleGlobalStateStack;
+    scenario: import("@vnejs/contracts.core.scenario").ModuleGlobalStateScenario;
+};

package/dist/create-core-global-state.js

@@ -0,0 +1,7 @@
+import { DEFAULT_MODULE_GLOBAL_STATE_SCENARIO } from "@vnejs/contracts.core.scenario";
+import { DEFAULT_MODULE_GLOBAL_STATE_STACK } from "@vnejs/contracts.core.stack";
+export const createCoreGlobalState = (overrides = {}) => ({
+    stack: structuredClone(DEFAULT_MODULE_GLOBAL_STATE_STACK),
+    scenario: structuredClone(DEFAULT_MODULE_GLOBAL_STATE_SCENARIO),
+    ...overrides,
+});

package/dist/harness.d.ts

@@ -0,0 +1,16 @@
+import type { ModuleGlobalStateRegistry, ModuleInject } from "@vnejs/module";
+import { Observer } from "@vnejs/observer";
+export type TestModuleInstance = {
+    name: string;
+    inject: (arg?: ModuleInject) => void;
+    subscribe: () => void;
+    observer?: Observer;
+};
+export type CreateTestModuleOptions = Partial<ModuleInject> & {
+    subscribe?: boolean;
+};
+export declare const createTestModule: <T extends TestModuleInstance>(ModuleClass: new () => T, { subscribe, ...injectArg }?: CreateTestModuleOptions) => {
+    module: T;
+    observer: Observer;
+    state: ModuleGlobalStateRegistry;
+};

package/dist/harness.js

@@ -0,0 +1,16 @@
+import { Observer } from "@vnejs/observer";
+export const createTestModule = (ModuleClass, { subscribe = true, ...injectArg } = {}) => {
+    const observer = new Observer();
+    const state = (injectArg.state ?? {});
+    const module = new ModuleClass();
+    module.inject({
+        observer,
+        state,
+        shared: (injectArg.shared ?? {}),
+        media: injectArg.media ?? {},
+        ...injectArg,
+    });
+    if (subscribe)
+        module.subscribe();
+    return { module, observer, state };
+};

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createCoreGlobalState } from "./create-core-global-state.js";
+export { createTestModule, type CreateTestModuleOptions, type TestModuleInstance } from "./harness.js";
+export { registerCoreVne } from "./register-core-vne.js";
+export { registerVnePlugin } from "./register-vne.js";
+export { resetDom } from "./reset-dom.js";
+export { spyEvent } from "./spy-event.js";
+export { stubEvent, stubLogsEmit, stubVendorEvents } from "./stub-event.js";
+export { mockFullscreen } from "./mocks/dom.js";
+export { createLocalforageMock } from "./mocks/localforage.js";

package/dist/index.js

@@ -0,0 +1,9 @@
+export { createCoreGlobalState } from "./create-core-global-state.js";
+export { createTestModule } from "./harness.js";
+export { registerCoreVne } from "./register-core-vne.js";
+export { registerVnePlugin } from "./register-vne.js";
+export { resetDom } from "./reset-dom.js";
+export { spyEvent } from "./spy-event.js";
+export { stubEvent, stubLogsEmit, stubVendorEvents } from "./stub-event.js";
+export { mockFullscreen } from "./mocks/dom.js";
+export { createLocalforageMock } from "./mocks/localforage.js";

package/dist/mocks/dom.d.ts

@@ -0,0 +1,9 @@
+export type MockFullscreenOptions = {
+    fullscreenElement?: Element | null;
+};
+export declare const mockFullscreen: ({ fullscreenElement }?: MockFullscreenOptions) => {
+    requestFullscreen: () => Promise<undefined>;
+    exitFullscreen: () => Promise<undefined>;
+    getRequestCount: () => number;
+    getExitCount: () => number;
+};

package/dist/mocks/dom.js

@@ -0,0 +1,21 @@
+export const mockFullscreen = ({ fullscreenElement = null } = {}) => {
+    Object.defineProperty(document, "fullscreenElement", { value: fullscreenElement, configurable: true });
+    let requestCount = 0;
+    let exitCount = 0;
+    const requestFullscreen = () => {
+        requestCount += 1;
+        return Promise.resolve(undefined);
+    };
+    const exitFullscreen = () => {
+        exitCount += 1;
+        return Promise.resolve(undefined);
+    };
+    document.body.requestFullscreen = requestFullscreen;
+    document.exitFullscreen = exitFullscreen;
+    return {
+        requestFullscreen,
+        exitFullscreen,
+        getRequestCount: () => requestCount,
+        getExitCount: () => exitCount,
+    };
+};

package/dist/mocks/localforage.d.ts

@@ -0,0 +1,11 @@
+export declare const createLocalforageMock: (store?: Record<string, unknown>) => {
+    default: {
+        INDEXEDDB: number;
+        ready: (callback: () => void) => Promise<void>;
+        config: () => undefined;
+        getItem: (key: string) => Promise<{} | null>;
+        setItem: (key: string, value: unknown) => Promise<unknown>;
+        removeItem: (key: string) => Promise<void>;
+        keys: () => Promise<string[]>;
+    };
+};

package/dist/mocks/localforage.js

@@ -0,0 +1,20 @@
+export const createLocalforageMock = (store = {}) => ({
+    default: {
+        INDEXEDDB: 0,
+        ready: (callback) => {
+            callback();
+            return Promise.resolve();
+        },
+        config: () => undefined,
+        getItem: (key) => Promise.resolve(store[key] ?? null),
+        setItem: (key, value) => {
+            store[key] = value;
+            return Promise.resolve(value);
+        },
+        removeItem: (key) => {
+            delete store[key];
+            return Promise.resolve();
+        },
+        keys: () => Promise.resolve(Object.keys(store)),
+    },
+});

package/dist/register-core-vne.d.ts

@@ -0,0 +1,2 @@
+import type { VneNamespace } from "@vnejs/shared";
+export declare const registerCoreVne: (namespaces?: VneNamespace[]) => void;

package/dist/register-core-vne.js

@@ -0,0 +1,35 @@
+import { CONSTANTS as COMPONENTS_CONST, PLUGIN_NAME as COMPONENTS, SUBSCRIBE_EVENTS as COMPONENTS_EVENTS } from "@vnejs/contracts.core.components";
+import { CONSTANTS as INTERACT_CONST, PLUGIN_NAME as INTERACT, SUBSCRIBE_EVENTS as INTERACT_EVENTS } from "@vnejs/contracts.core.interact";
+import { CONSTANTS as LOGS_CONST, PLUGIN_NAME as LOGS, SETTINGS_KEYS as LOGS_SETTINGS, SUBSCRIBE_EVENTS as LOGS_EVENTS } from "@vnejs/contracts.core.logs";
+import { PLUGIN_NAME as MEMORY, SUBSCRIBE_EVENTS as MEMORY_EVENTS } from "@vnejs/contracts.core.memory";
+import { CONSTANTS as MEDIA_CONST, PLUGIN_NAME as MEDIA, SUBSCRIBE_EVENTS as MEDIA_EVENTS } from "@vnejs/contracts.core.media";
+import { CONSTANTS as PLATFORMS_CONST, PARAMS as PLATFORMS_PARAMS, PLUGIN_NAME as PLATFORMS } from "@vnejs/contracts.core.platforms";
+import { CONSTANTS as SCENARIO_CONST, PARAMS as SCENARIO_PARAMS, PLUGIN_NAME as SCENARIO, SUBSCRIBE_EVENTS as SCENARIO_EVENTS } from "@vnejs/contracts.core.scenario";
+import { CONSTANTS as SETTINGS_CONST, PLUGIN_NAME as SETTINGS, SUBSCRIBE_EVENTS as SETTINGS_EVENTS } from "@vnejs/contracts.core.settings";
+import { CONSTANTS as STACK_CONST, PLUGIN_NAME as STACK, SUBSCRIBE_EVENTS as STACK_EVENTS } from "@vnejs/contracts.core.stack";
+import { CONSTANTS as STATE_CONST, PLUGIN_NAME as STATE, SUBSCRIBE_EVENTS as STATE_EVENTS } from "@vnejs/contracts.core.state";
+import { PARAMS as STORAGE_PARAMS, PLUGIN_NAME as STORAGE, SUBSCRIBE_EVENTS as STORAGE_EVENTS } from "@vnejs/contracts.core.storage";
+import { CONSTANTS as SYSTEM_CONST, PLUGIN_NAME as SYSTEM, SUBSCRIBE_EVENTS as SYSTEM_EVENTS } from "@vnejs/contracts.core.system";
+import { PLUGIN_NAME as VENDORS, SUBSCRIBE_EVENTS as VENDORS_EVENTS } from "@vnejs/contracts.core.vendors";
+import { registerVnePlugin } from "./register-vne.js";
+const CORE_REGISTRATIONS = [
+    { namespace: SYSTEM, shape: { constants: SYSTEM_CONST, events: SYSTEM_EVENTS } },
+    { namespace: LOGS, shape: { constants: LOGS_CONST, events: LOGS_EVENTS, settings: LOGS_SETTINGS } },
+    { namespace: PLATFORMS, shape: { constants: PLATFORMS_CONST, params: PLATFORMS_PARAMS } },
+    { namespace: STORAGE, shape: { events: STORAGE_EVENTS, params: STORAGE_PARAMS } },
+    { namespace: MEMORY, shape: { events: MEMORY_EVENTS } },
+    { namespace: VENDORS, shape: { events: VENDORS_EVENTS } },
+    { namespace: COMPONENTS, shape: { constants: COMPONENTS_CONST, events: COMPONENTS_EVENTS } },
+    { namespace: INTERACT, shape: { constants: INTERACT_CONST, events: INTERACT_EVENTS } },
+    { namespace: MEDIA, shape: { constants: MEDIA_CONST, events: MEDIA_EVENTS } },
+    { namespace: SCENARIO, shape: { constants: SCENARIO_CONST, events: SCENARIO_EVENTS, params: SCENARIO_PARAMS } },
+    { namespace: SETTINGS, shape: { constants: SETTINGS_CONST, events: SETTINGS_EVENTS } },
+    { namespace: STACK, shape: { constants: STACK_CONST, events: STACK_EVENTS } },
+    { namespace: STATE, shape: { constants: STATE_CONST, events: STATE_EVENTS } },
+];
+export const registerCoreVne = (namespaces) => {
+    for (const { namespace, shape } of CORE_REGISTRATIONS) {
+        if (!namespaces || namespaces.includes(namespace))
+            registerVnePlugin(namespace, shape);
+    }
+};

package/dist/register-vne.d.ts

@@ -0,0 +1,2 @@
+import type { VneNamespace, VnePluginShape } from "@vnejs/shared";
+export declare const registerVnePlugin: (namespace: VneNamespace, { constants, events, settings, params }?: VnePluginShape) => void;

package/dist/register-vne.js

@@ -0,0 +1,7 @@
+import { VNE } from "@vnejs/shared";
+export const registerVnePlugin = (namespace, { constants = {}, events = {}, settings = {}, params = {} } = {}) => {
+    VNE.EVENTS[namespace] = { ...events };
+    VNE.CONST[namespace] = { ...constants };
+    VNE.SETTINGS[namespace] = { ...settings };
+    VNE.PARAMS[namespace] = { ...params };
+};

package/dist/reset-dom.d.ts

@@ -0,0 +1 @@
+export declare const resetDom: () => void;

package/dist/reset-dom.js

@@ -0,0 +1,4 @@
+export const resetDom = () => {
+    document.body.innerHTML = "";
+    document.head.innerHTML = "";
+};

package/dist/spy-event.d.ts

@@ -0,0 +1,7 @@
+import type { Observer } from "@vnejs/observer";
+export declare const spyEvent: (observer: Observer, event: string) => {
+    calls: unknown[][];
+    count: () => number;
+    last: () => unknown[] | undefined;
+    first: () => unknown[];
+};

package/dist/spy-event.js

@@ -0,0 +1,12 @@
+export const spyEvent = (observer, event) => {
+    const calls = [];
+    observer.subscribe(event, (...args) => {
+        calls.push(args);
+    });
+    return {
+        calls,
+        count: () => calls.length,
+        last: () => calls.at(-1),
+        first: () => calls[0],
+    };
+};

package/dist/stub-event.d.ts

@@ -0,0 +1,4 @@
+import type { Observer } from "@vnejs/observer";
+export declare const stubEvent: (observer: Observer, event: string, handler?: (...args: unknown[]) => unknown) => void;
+export declare const stubLogsEmit: (observer: Observer) => void;
+export declare const stubVendorEvents: (observer: Observer) => void;

package/dist/stub-event.js

@@ -0,0 +1,10 @@
+import { SUBSCRIBE_EVENTS as LOGS_EVENTS } from "@vnejs/contracts.core.logs";
+import { SUBSCRIBE_EVENTS as VENDORS_EVENTS } from "@vnejs/contracts.core.vendors";
+export const stubEvent = (observer, event, handler = () => undefined) => {
+    observer.subscribe(event, handler);
+};
+export const stubLogsEmit = (observer) => stubEvent(observer, LOGS_EVENTS.EMIT);
+export const stubVendorEvents = (observer) => {
+    stubEvent(observer, VENDORS_EVENTS.UID, () => "test-uid");
+    stubEvent(observer, VENDORS_EVENTS.CLONE, (value) => structuredClone(value));
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@vnejs/test-utils",
+  "version": "0.1.1",
+  "description": "Test harness utilities for @vnejs plugin modules",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "npx @vnejs/monorepo package",
+    "publish:major": "npx @vnejs/monorepo publish major --access public",
+    "publish:minor": "npx @vnejs/monorepo publish minor --access public",
+    "publish:patch": "npx @vnejs/monorepo publish patch --access public"
+  },
+  "license": "ISC",
+  "dependencies": {
+    "@vnejs/observer": "~0.1.0",
+    "@vnejs/shared": "~0.1.0"
+  },
+  "peerDependencies": {
+    "@vnejs/module": "~0.1.0"
+  },
+  "devDependencies": {
+    "@vnejs/configs.ts-common": "~0.1.0",
+    "@vnejs/contracts.core.components": "~0.1.0",
+    "@vnejs/contracts.core.interact": "~0.1.0",
+    "@vnejs/contracts.core.logs": "~0.1.0",
+    "@vnejs/contracts.core.media": "~0.1.0",
+    "@vnejs/contracts.core.memory": "~0.1.0",
+    "@vnejs/contracts.core.platforms": "~0.1.0",
+    "@vnejs/contracts.core.scenario": "~0.1.0",
+    "@vnejs/contracts.core.settings": "~0.1.0",
+    "@vnejs/contracts.core.stack": "~0.1.0",
+    "@vnejs/contracts.core.state": "~0.1.0",
+    "@vnejs/contracts.core.storage": "~0.1.0",
+    "@vnejs/contracts.core.system": "~0.1.0",
+    "@vnejs/contracts.core.vendors": "~0.1.0",
+    "@vnejs/module": "~0.1.0"
+  }
+}

package/src/create-core-global-state.ts

@@ -0,0 +1,8 @@
+import { DEFAULT_MODULE_GLOBAL_STATE_SCENARIO } from "@vnejs/contracts.core.scenario";
+import { DEFAULT_MODULE_GLOBAL_STATE_STACK } from "@vnejs/contracts.core.stack";
+
+export const createCoreGlobalState = (overrides: Record<string, unknown> = {}) => ({
+  stack: structuredClone(DEFAULT_MODULE_GLOBAL_STATE_STACK),
+  scenario: structuredClone(DEFAULT_MODULE_GLOBAL_STATE_SCENARIO),
+  ...overrides,
+});

package/src/harness.ts

@@ -0,0 +1,33 @@
+import type { ModuleGlobalStateRegistry, ModuleInject, ModuleShared } from "@vnejs/module";
+import { Observer } from "@vnejs/observer";
+
+export type TestModuleInstance = {
+  name: string;
+  inject: (arg?: ModuleInject) => void;
+  subscribe: () => void;
+  observer?: Observer;
+};
+
+export type CreateTestModuleOptions = Partial<ModuleInject> & {
+  subscribe?: boolean;
+};
+
+export const createTestModule = <T extends TestModuleInstance>(
+  ModuleClass: new () => T,
+  { subscribe = true, ...injectArg }: CreateTestModuleOptions = {},
+) => {
+  const observer = new Observer();
+  const state = (injectArg.state ?? {}) as ModuleGlobalStateRegistry;
+  const module = new ModuleClass();
+
+  module.inject({
+    observer,
+    state,
+    shared: (injectArg.shared ?? {}) as ModuleShared,
+    media: injectArg.media ?? {},
+    ...injectArg,
+  });
+  if (subscribe) module.subscribe();
+
+  return { module, observer, state };
+};

package/src/index.ts

@@ -0,0 +1,9 @@
+export { createCoreGlobalState } from "./create-core-global-state.js";
+export { createTestModule, type CreateTestModuleOptions, type TestModuleInstance } from "./harness.js";
+export { registerCoreVne } from "./register-core-vne.js";
+export { registerVnePlugin } from "./register-vne.js";
+export { resetDom } from "./reset-dom.js";
+export { spyEvent } from "./spy-event.js";
+export { stubEvent, stubLogsEmit, stubVendorEvents } from "./stub-event.js";
+export { mockFullscreen } from "./mocks/dom.js";
+export { createLocalforageMock } from "./mocks/localforage.js";

package/src/mocks/dom.ts

@@ -0,0 +1,30 @@
+export type MockFullscreenOptions = {
+  fullscreenElement?: Element | null;
+};
+
+export const mockFullscreen = ({ fullscreenElement = null }: MockFullscreenOptions = {}) => {
+  Object.defineProperty(document, "fullscreenElement", { value: fullscreenElement, configurable: true });
+
+  let requestCount = 0;
+  let exitCount = 0;
+
+  const requestFullscreen = () => {
+    requestCount += 1;
+    return Promise.resolve(undefined);
+  };
+
+  const exitFullscreen = () => {
+    exitCount += 1;
+    return Promise.resolve(undefined);
+  };
+
+  document.body.requestFullscreen = requestFullscreen;
+  document.exitFullscreen = exitFullscreen;
+
+  return {
+    requestFullscreen,
+    exitFullscreen,
+    getRequestCount: () => requestCount,
+    getExitCount: () => exitCount,
+  };
+};

package/src/mocks/localforage.ts

@@ -0,0 +1,20 @@
+export const createLocalforageMock = (store: Record<string, unknown> = {}) => ({
+  default: {
+    INDEXEDDB: 0,
+    ready: (callback: () => void) => {
+      callback();
+      return Promise.resolve();
+    },
+    config: () => undefined,
+    getItem: (key: string) => Promise.resolve(store[key] ?? null),
+    setItem: (key: string, value: unknown) => {
+      store[key] = value;
+      return Promise.resolve(value);
+    },
+    removeItem: (key: string) => {
+      delete store[key];
+      return Promise.resolve();
+    },
+    keys: () => Promise.resolve(Object.keys(store)),
+  },
+});

package/src/register-core-vne.ts

@@ -0,0 +1,41 @@
+import type { VneNamespace, VnePluginShape } from "@vnejs/shared";
+
+import { CONSTANTS as COMPONENTS_CONST, PLUGIN_NAME as COMPONENTS, SUBSCRIBE_EVENTS as COMPONENTS_EVENTS } from "@vnejs/contracts.core.components";
+import { CONSTANTS as INTERACT_CONST, PLUGIN_NAME as INTERACT, SUBSCRIBE_EVENTS as INTERACT_EVENTS } from "@vnejs/contracts.core.interact";
+import { CONSTANTS as LOGS_CONST, PLUGIN_NAME as LOGS, SETTINGS_KEYS as LOGS_SETTINGS, SUBSCRIBE_EVENTS as LOGS_EVENTS } from "@vnejs/contracts.core.logs";
+import { PLUGIN_NAME as MEMORY, SUBSCRIBE_EVENTS as MEMORY_EVENTS } from "@vnejs/contracts.core.memory";
+import { CONSTANTS as MEDIA_CONST, PLUGIN_NAME as MEDIA, SUBSCRIBE_EVENTS as MEDIA_EVENTS } from "@vnejs/contracts.core.media";
+import { CONSTANTS as PLATFORMS_CONST, PARAMS as PLATFORMS_PARAMS, PLUGIN_NAME as PLATFORMS } from "@vnejs/contracts.core.platforms";
+import { CONSTANTS as SCENARIO_CONST, PARAMS as SCENARIO_PARAMS, PLUGIN_NAME as SCENARIO, SUBSCRIBE_EVENTS as SCENARIO_EVENTS } from "@vnejs/contracts.core.scenario";
+import { CONSTANTS as SETTINGS_CONST, PLUGIN_NAME as SETTINGS, SUBSCRIBE_EVENTS as SETTINGS_EVENTS } from "@vnejs/contracts.core.settings";
+import { CONSTANTS as STACK_CONST, PLUGIN_NAME as STACK, SUBSCRIBE_EVENTS as STACK_EVENTS } from "@vnejs/contracts.core.stack";
+import { CONSTANTS as STATE_CONST, PLUGIN_NAME as STATE, SUBSCRIBE_EVENTS as STATE_EVENTS } from "@vnejs/contracts.core.state";
+import { PARAMS as STORAGE_PARAMS, PLUGIN_NAME as STORAGE, SUBSCRIBE_EVENTS as STORAGE_EVENTS } from "@vnejs/contracts.core.storage";
+import { CONSTANTS as SYSTEM_CONST, PLUGIN_NAME as SYSTEM, SUBSCRIBE_EVENTS as SYSTEM_EVENTS } from "@vnejs/contracts.core.system";
+import { PLUGIN_NAME as VENDORS, SUBSCRIBE_EVENTS as VENDORS_EVENTS } from "@vnejs/contracts.core.vendors";
+
+import { registerVnePlugin } from "./register-vne.js";
+
+type CoreRegistration = { namespace: VneNamespace; shape: VnePluginShape };
+
+const CORE_REGISTRATIONS: CoreRegistration[] = [
+  { namespace: SYSTEM, shape: { constants: SYSTEM_CONST, events: SYSTEM_EVENTS } },
+  { namespace: LOGS, shape: { constants: LOGS_CONST, events: LOGS_EVENTS, settings: LOGS_SETTINGS } },
+  { namespace: PLATFORMS, shape: { constants: PLATFORMS_CONST, params: PLATFORMS_PARAMS } },
+  { namespace: STORAGE, shape: { events: STORAGE_EVENTS, params: STORAGE_PARAMS } },
+  { namespace: MEMORY, shape: { events: MEMORY_EVENTS } },
+  { namespace: VENDORS, shape: { events: VENDORS_EVENTS } },
+  { namespace: COMPONENTS, shape: { constants: COMPONENTS_CONST, events: COMPONENTS_EVENTS } },
+  { namespace: INTERACT, shape: { constants: INTERACT_CONST, events: INTERACT_EVENTS } },
+  { namespace: MEDIA, shape: { constants: MEDIA_CONST, events: MEDIA_EVENTS } },
+  { namespace: SCENARIO, shape: { constants: SCENARIO_CONST, events: SCENARIO_EVENTS, params: SCENARIO_PARAMS } },
+  { namespace: SETTINGS, shape: { constants: SETTINGS_CONST, events: SETTINGS_EVENTS } },
+  { namespace: STACK, shape: { constants: STACK_CONST, events: STACK_EVENTS } },
+  { namespace: STATE, shape: { constants: STATE_CONST, events: STATE_EVENTS } },
+];
+
+export const registerCoreVne = (namespaces?: VneNamespace[]) => {
+  for (const { namespace, shape } of CORE_REGISTRATIONS) {
+    if (!namespaces || namespaces.includes(namespace)) registerVnePlugin(namespace, shape);
+  }
+};

package/src/register-vne.ts

@@ -0,0 +1,12 @@
+import { VNE } from "@vnejs/shared";
+import type { VneNamespace, VnePluginShape } from "@vnejs/shared";
+
+export const registerVnePlugin = (
+  namespace: VneNamespace,
+  { constants = {}, events = {}, settings = {}, params = {} }: VnePluginShape = {},
+) => {
+  (VNE.EVENTS as Record<string, unknown>)[namespace] = { ...events };
+  (VNE.CONST as Record<string, unknown>)[namespace] = { ...constants };
+  (VNE.SETTINGS as Record<string, unknown>)[namespace] = { ...settings };
+  (VNE.PARAMS as Record<string, unknown>)[namespace] = { ...params };
+};

package/src/reset-dom.ts

@@ -0,0 +1,4 @@
+export const resetDom = () => {
+  document.body.innerHTML = "";
+  document.head.innerHTML = "";
+};

package/src/spy-event.ts

@@ -0,0 +1,16 @@
+import type { Observer } from "@vnejs/observer";
+
+export const spyEvent = (observer: Observer, event: string) => {
+  const calls: unknown[][] = [];
+
+  observer.subscribe(event, (...args: unknown[]) => {
+    calls.push(args);
+  });
+
+  return {
+    calls,
+    count: () => calls.length,
+    last: () => calls.at(-1),
+    first: () => calls[0],
+  };
+};

package/src/stub-event.ts

@@ -0,0 +1,18 @@
+import { SUBSCRIBE_EVENTS as LOGS_EVENTS } from "@vnejs/contracts.core.logs";
+import { SUBSCRIBE_EVENTS as VENDORS_EVENTS } from "@vnejs/contracts.core.vendors";
+import type { Observer } from "@vnejs/observer";
+
+export const stubEvent = (
+  observer: Observer,
+  event: string,
+  handler: (...args: unknown[]) => unknown = () => undefined,
+) => {
+  observer.subscribe(event, handler);
+};
+
+export const stubLogsEmit = (observer: Observer) => stubEvent(observer, LOGS_EVENTS.EMIT);
+
+export const stubVendorEvents = (observer: Observer) => {
+  stubEvent(observer, VENDORS_EVENTS.UID, () => "test-uid");
+  stubEvent(observer, VENDORS_EVENTS.CLONE, (value) => structuredClone(value));
+};

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@vnejs/configs.ts-common/tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["dist", "node_modules"]
+}