@noego/wood 0.6.2 → 0.7.0

package/dist/testing/registration_only_root.js

@@ -1,5 +1,24 @@
+import { defineModule, LoadAs } from "@noego/ioc";
 import { createWoodRoot } from "../runtime/get_container.js";
 import { TestWoodError } from "./test_wood.js";
+const APPLICATION_TEST_MARK = /* @__PURE__ */ Symbol.for("@noego/testing.application.v1");
+function refine(binding, lifetime) {
+  if (lifetime === "singleton") binding.singleton();
+  else if (lifetime === "scoped") binding.scoped();
+  else if (lifetime === "transient") binding.transient();
+}
+function lifetimeOf(options) {
+  switch (options?.loadAs) {
+    case LoadAs.Singleton:
+      return "singleton";
+    case LoadAs.Scoped:
+      return "scoped";
+    case LoadAs.Transient:
+      return "transient";
+    default:
+      return void 0;
+  }
+}
 function errorMessage(error) {
   const message = error instanceof Error ? error.message : String(error);
   const nested = error?.failures;
@@ -28,12 +47,24 @@ async function cleanupAll(message, actions) {
   if (failures.length) throw new TestWoodCleanupError(message, failures);
 }
 class RegistrationOnlyRoot {
-  constructor(hookName) {
+  /**
+   * @param hookName the app hook that may register on this root
+   * @param applicationTest the config path identifying the application test;
+   *   registered on the ACTUAL root under the shared
+   *   `@noego/testing.application.v1` marker before any hook runs, so
+   *   frameworks reading the IoC async-context ABI (e.g. Proper's migration
+   *   guard) recognize Wood startup/invocation as an application test.
+   *   Production roots are never marked.
+   */
+  constructor(hookName, applicationTest) {
     this.hookName = hookName;
     this.owners = /* @__PURE__ */ new Set();
     this.actualRoot = createWoodRoot();
     this.target = null;
     this.replayed = false;
+    /** Every production registration as a declarative binding (the shared overlay catalog input). */
+    this.declarations = [];
+    this.actualRoot.registerFunction(APPLICATION_TEST_MARK, () => applicationTest, { owned: false });
     const registrationOnly = this;
     this.root = new Proxy(this.actualRoot, {
       get(_target, property) {
@@ -41,6 +72,8 @@ class RegistrationOnlyRoot {
           return (classDefinition, options) => {
             registrationOnly.assertRecording("registerClass");
             registrationOnly.declare(classDefinition);
+            const lifetime = lifetimeOf(options);
+            registrationOnly.declarations.push((bind) => refine(bind(classDefinition).toSelf(), lifetime));
             registrationOnly.actualRoot.registerClass(classDefinition, options);
           };
         }
@@ -48,9 +81,10 @@ class RegistrationOnlyRoot {
           return (token, factory, options) => {
             registrationOnly.assertRecording("registerFunction");
             registrationOnly.declare(token);
-            for (const dependency of options?.param ?? []) {
-              registrationOnly.declare(dependency);
-            }
+            const dependencies = [...options?.param ?? []];
+            for (const dependency of dependencies) registrationOnly.declare(dependency);
+            const lifetime = lifetimeOf(options);
+            registrationOnly.declarations.push((bind) => refine(bind(token).toFactory(factory, dependencies), lifetime));
             registrationOnly.actualRoot.registerFunction(token, factory, options);
           };
         }
@@ -88,6 +122,25 @@ class RegistrationOnlyRoot {
       this.declare(injected?.has(index) ? injected.get(index) : design[index]);
     }
   }
+  /**
+   * Declare a token this root binds later (at runtime initialization) as a
+   * provider so the shared overlay catalog can resolve replacements for it.
+   * The placeholder factory is description only and never resolves.
+   */
+  declareBinding(token, lifetime) {
+    this.declare(token);
+    const hookName = this.hookName;
+    this.declarations.push((bind) => refine(bind(token).toFactory(() => {
+      throw new TestWoodError(`${hookName} declared-only binding ${String(token)} has no production factory`);
+    }, []), lifetime));
+  }
+  /** The recorded production registrations as a declarative module (description only, never built). */
+  module() {
+    const declarations = [...this.declarations];
+    return defineModule(`@noego/wood/testing/${this.hookName}`, (bind) => {
+      for (const declaration of declarations) declaration(bind);
+    });
+  }
   replay(root) {
     if (this.replayed) throw new TestWoodError(`${this.hookName} registrations were already replayed`);
     this.replayed = true;
@@ -105,11 +158,12 @@ class RegistrationOnlyRoot {
     }
   }
 }
-async function buildRecordedEnvironment(builder, recorded, owner) {
+async function buildRecordedEnvironment(builder, recorded, owner, borrowedTokens = []) {
   const partial = { root: recorded.actualRoot };
   try {
     const environment = await builder.build({
       root: recorded.actualRoot,
+      borrowedTokens,
       prepare: (freshRoot) => {
         partial.root = freshRoot;
         recorded.replay(freshRoot);
@@ -133,6 +187,7 @@ async function buildRecordedEnvironment(builder, recorded, owner) {
   }
 }
 export {
+  APPLICATION_TEST_MARK,
   RegistrationOnlyRoot,
   TestWoodCleanupError,
   buildRecordedEnvironment,

package/dist/testing/registration_only_root.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/registration_only_root.ts"],"sourcesContent":["import type { IContainer } from '@noego/ioc';\nimport { createWoodRoot } from '../runtime/get_container.js';\nimport type { TestEnvironment, TestIocBuilder } from '@noego/testing';\nimport { TestWoodError } from './test_wood.js';\n\n\nexport interface CleanupFailure {\n  readonly owner: string;\n  readonly error: unknown;\n}\n\nfunction errorMessage(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  const nested = (error as { failures?: Array<{ error: unknown }> } | null)?.failures;\n  return Array.isArray(nested) ? message + ': ' + nested.map(failure => errorMessage(failure.error)).join('; ') : message;\n}\n\n/**\n * Error raised after every requested owner has been given a chance to clean up.\n * The structured failures are retained for assertions and callers that need to\n * inspect the original errors.\n */\nexport class TestWoodCleanupError extends TestWoodError {\n  readonly failures: readonly CleanupFailure[];\n\n  constructor(message: string, failures: readonly CleanupFailure[], cause?: unknown) {\n    super(\n      `${message} (${failures.length} failure(s)):\\n  ` +\n      failures.map(({ owner, error }) => `${owner}: ${errorMessage(error)}`).join('\\n  '),\n    );\n    this.name = 'TestWoodCleanupError';\n    this.failures = failures;\n    if (cause !== undefined) (this as Error & { cause?: unknown }).cause = cause;\n  }\n}\n\n/** Run every cleanup action in order, collecting rather than short-circuiting. */\nexport async function cleanupAll(\n  message: string,\n  actions: ReadonlyArray<readonly [owner: string, action: () => void | Promise<void>]>,\n): Promise<void> {\n  const failures: CleanupFailure[] = [];\n  for (const [owner, action] of actions) {\n    try {\n      await action();\n    } catch (error) {\n      failures.push({ owner, error });\n    }\n  }\n  if (failures.length) throw new TestWoodCleanupError(message, failures);\n}\n\n/**\n * A registration-only view of the real root owned by this environment.\n *\n * Registrations land immediately on that root; shared @noego/testing applies\n * scenario overlays to it without replay. Resolution is unavailable until it has been\n * built and the test overlays and method decorator are installed.\n */\nexport class RegistrationOnlyRoot {\n  readonly owners = new Set<unknown>();\n  readonly root: IContainer;\n\n  readonly actualRoot = createWoodRoot();\n  private target: IContainer | null = null;\n  private replayed = false;\n\n  constructor(private readonly hookName: string) {\n    const registrationOnly = this;\n    this.root = new Proxy(this.actualRoot, {\n      get(_target, property) {\n        if (property === 'registerClass') {\n          return (classDefinition: new (...args: any[]) => unknown, options?: unknown): void => {\n            registrationOnly.assertRecording('registerClass');\n            registrationOnly.declare(classDefinition);\n            registrationOnly.actualRoot.registerClass(classDefinition, options as never);\n          };\n        }\n        if (property === 'registerFunction') {\n          return (token: unknown, factory: (...args: any[]) => unknown, options?: unknown): void => {\n            registrationOnly.assertRecording('registerFunction');\n            registrationOnly.declare(token);\n            for (const dependency of (options as { param?: unknown[] } | undefined)?.param ?? []) {\n              registrationOnly.declare(dependency);\n            }\n            registrationOnly.actualRoot.registerFunction(token, factory, options as never);\n          };\n        }\n        if (property === 'isRegistered') {\n          return (token: unknown): boolean =>\n            registrationOnly.target?.isRegistered(token) ?? registrationOnly.owners.has(token);\n        }\n        if (property === 'isDisposed') {\n          return (): boolean => registrationOnly.target?.isDisposed() ?? false;\n        }\n\n        const live = registrationOnly.target;\n        if (live) {\n          const value = Reflect.get(live as object, property, live);\n          return typeof value === 'function' ? value.bind(live) : value;\n        }\n\n        return (..._args: unknown[]): never => {\n          const method = String(property);\n          throw new TestWoodError(\n            `${registrationOnly.hookName} may only register dependencies before test overlays; ` +\n            `${method}() attempted eager resolution or root mutation. Move resolution to start(), ` +\n            'a page lifecycle, or the built test environment.',\n          );\n        };\n      },\n    });\n  }\n\n  declare(token: unknown): void {\n    if (this.owners.has(token)) return;\n    this.owners.add(token);\n    if (typeof token !== 'function') return;\n    const injected = (Reflect as any).getMetadata?.(\n      Symbol.for('ioc:inject:tokens'),\n      token,\n    ) as Map<number, unknown> | undefined;\n    const design = (Reflect as any).getMetadata?.('design:paramtypes', token) ?? [];\n    const indices = new Set<number>([...design.keys(), ...(injected?.keys() ?? [])]);\n    for (const index of indices) {\n      this.declare(injected?.has(index) ? injected.get(index) : design[index]);\n    }\n  }\n\n  replay(root: IContainer): void {\n    if (this.replayed) throw new TestWoodError(`${this.hookName} registrations were already replayed`);\n    this.replayed = true;\n    if (root !== this.actualRoot) throw new TestWoodError('testWood requires @noego/testing with build({ root }) support; update the shared testing package.');\n  }\n\n  bind(root: IContainer): void {\n    if (!this.replayed) throw new TestWoodError(`${this.hookName} registrations must be replayed before binding`);\n    this.target = root;\n  }\n\n  private assertRecording(method: string): void {\n    if (this.replayed) {\n      throw new TestWoodError(\n        `${this.hookName} cannot call ${method}() after test overlays have been installed`,\n      );\n    }\n  }\n}\n\n/**\n * Materialize shared @noego/testing overlays on the same production root,\n * disposing the partially built root if materialization fails.\n */\nexport async function buildRecordedEnvironment(\n  builder: TestIocBuilder,\n  recorded: RegistrationOnlyRoot,\n  owner: string,\n): Promise<TestEnvironment> {\n  const partial: { root?: IContainer } = { root: recorded.actualRoot };\n  try {\n    const environment = await builder.build({\n      root: recorded.actualRoot,\n      prepare: (freshRoot) => {\n        partial.root = freshRoot;\n        recorded.replay(freshRoot);\n      },\n    });\n    recorded.bind(environment.root);\n    return environment;\n  } catch (error) {\n    const failures: CleanupFailure[] = [];\n    if (partial.root) {\n      try {\n        await partial.root.dispose();\n      } catch (cleanupError) {\n        failures.push({ owner: `${owner} root rollback`, error: cleanupError });\n      }\n    }\n    if (failures.length) {\n      throw new TestWoodCleanupError(`${owner} build failed and rollback failed`, failures, error);\n    }\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/testing/registration_only_root.ts"],"sourcesContent":["import type { ApplicationModule, BindFunction, BindingRefinement, IContainer, Lifetime } from '@noego/ioc';\nimport { defineModule, LoadAs } from '@noego/ioc';\nimport { createWoodRoot } from '../runtime/get_container.js';\nimport type { TestEnvironment, TestIocBuilder } from '@noego/testing';\nimport { TestWoodError } from './test_wood.js';\n\ntype ContainerOptions = { loadAs?: LoadAs; param?: unknown[] };\n\n/** Shared application-test marker (same symbol `@noego/app` registers). */\nexport const APPLICATION_TEST_MARK = Symbol.for('@noego/testing.application.v1');\n\nfunction refine(binding: BindingRefinement, lifetime: Lifetime | undefined): void {\n  if (lifetime === 'singleton') binding.singleton();\n  else if (lifetime === 'scoped') binding.scoped();\n  else if (lifetime === 'transient') binding.transient();\n}\n\nfunction lifetimeOf(options: Partial<ContainerOptions> | undefined): Lifetime | undefined {\n  switch (options?.loadAs) {\n    case LoadAs.Singleton: return 'singleton';\n    case LoadAs.Scoped: return 'scoped';\n    case LoadAs.Transient: return 'transient';\n    default: return undefined;\n  }\n}\n\n\nexport interface CleanupFailure {\n  readonly owner: string;\n  readonly error: unknown;\n}\n\nfunction errorMessage(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  const nested = (error as { failures?: Array<{ error: unknown }> } | null)?.failures;\n  return Array.isArray(nested) ? message + ': ' + nested.map(failure => errorMessage(failure.error)).join('; ') : message;\n}\n\n/**\n * Error raised after every requested owner has been given a chance to clean up.\n * The structured failures are retained for assertions and callers that need to\n * inspect the original errors.\n */\nexport class TestWoodCleanupError extends TestWoodError {\n  readonly failures: readonly CleanupFailure[];\n\n  constructor(message: string, failures: readonly CleanupFailure[], cause?: unknown) {\n    super(\n      `${message} (${failures.length} failure(s)):\\n  ` +\n      failures.map(({ owner, error }) => `${owner}: ${errorMessage(error)}`).join('\\n  '),\n    );\n    this.name = 'TestWoodCleanupError';\n    this.failures = failures;\n    if (cause !== undefined) (this as Error & { cause?: unknown }).cause = cause;\n  }\n}\n\n/** Run every cleanup action in order, collecting rather than short-circuiting. */\nexport async function cleanupAll(\n  message: string,\n  actions: ReadonlyArray<readonly [owner: string, action: () => void | Promise<void>]>,\n): Promise<void> {\n  const failures: CleanupFailure[] = [];\n  for (const [owner, action] of actions) {\n    try {\n      await action();\n    } catch (error) {\n      failures.push({ owner, error });\n    }\n  }\n  if (failures.length) throw new TestWoodCleanupError(message, failures);\n}\n\n/**\n * A registration-only view of the real root owned by this environment.\n *\n * Registrations land immediately on that root; shared @noego/testing applies\n * scenario overlays to it without replay. Resolution is unavailable until it has been\n * built and the test overlays and method decorator are installed.\n */\nexport class RegistrationOnlyRoot {\n  readonly owners = new Set<unknown>();\n  readonly root: IContainer;\n\n  readonly actualRoot = createWoodRoot();\n  private target: IContainer | null = null;\n  private replayed = false;\n  /** Every production registration as a declarative binding (the shared overlay catalog input). */\n  private readonly declarations: Array<(bind: BindFunction) => void> = [];\n\n  /**\n   * @param hookName the app hook that may register on this root\n   * @param applicationTest the config path identifying the application test;\n   *   registered on the ACTUAL root under the shared\n   *   `@noego/testing.application.v1` marker before any hook runs, so\n   *   frameworks reading the IoC async-context ABI (e.g. Proper's migration\n   *   guard) recognize Wood startup/invocation as an application test.\n   *   Production roots are never marked.\n   */\n  constructor(private readonly hookName: string, applicationTest: string) {\n    this.actualRoot.registerFunction(APPLICATION_TEST_MARK, () => applicationTest, { owned: false });\n    const registrationOnly = this;\n    this.root = new Proxy(this.actualRoot, {\n      get(_target, property) {\n        if (property === 'registerClass') {\n          return (classDefinition: new (...args: any[]) => unknown, options?: unknown): void => {\n            registrationOnly.assertRecording('registerClass');\n            registrationOnly.declare(classDefinition);\n            const lifetime = lifetimeOf(options as Partial<ContainerOptions> | undefined);\n            registrationOnly.declarations.push((bind) => refine(bind(classDefinition).toSelf(), lifetime));\n            registrationOnly.actualRoot.registerClass(classDefinition, options as never);\n          };\n        }\n        if (property === 'registerFunction') {\n          return (token: unknown, factory: (...args: any[]) => unknown, options?: unknown): void => {\n            registrationOnly.assertRecording('registerFunction');\n            registrationOnly.declare(token);\n            const dependencies = [...((options as { param?: unknown[] } | undefined)?.param ?? [])];\n            for (const dependency of dependencies) registrationOnly.declare(dependency);\n            const lifetime = lifetimeOf(options as Partial<ContainerOptions> | undefined);\n            registrationOnly.declarations.push((bind) => refine(bind(token).toFactory(factory, dependencies), lifetime));\n            registrationOnly.actualRoot.registerFunction(token, factory, options as never);\n          };\n        }\n        if (property === 'isRegistered') {\n          return (token: unknown): boolean =>\n            registrationOnly.target?.isRegistered(token) ?? registrationOnly.owners.has(token);\n        }\n        if (property === 'isDisposed') {\n          return (): boolean => registrationOnly.target?.isDisposed() ?? false;\n        }\n\n        const live = registrationOnly.target;\n        if (live) {\n          const value = Reflect.get(live as object, property, live);\n          return typeof value === 'function' ? value.bind(live) : value;\n        }\n\n        return (..._args: unknown[]): never => {\n          const method = String(property);\n          throw new TestWoodError(\n            `${registrationOnly.hookName} may only register dependencies before test overlays; ` +\n            `${method}() attempted eager resolution or root mutation. Move resolution to start(), ` +\n            'a page lifecycle, or the built test environment.',\n          );\n        };\n      },\n    });\n  }\n\n  declare(token: unknown): void {\n    if (this.owners.has(token)) return;\n    this.owners.add(token);\n    if (typeof token !== 'function') return;\n    const injected = (Reflect as any).getMetadata?.(\n      Symbol.for('ioc:inject:tokens'),\n      token,\n    ) as Map<number, unknown> | undefined;\n    const design = (Reflect as any).getMetadata?.('design:paramtypes', token) ?? [];\n    const indices = new Set<number>([...design.keys(), ...(injected?.keys() ?? [])]);\n    for (const index of indices) {\n      this.declare(injected?.has(index) ? injected.get(index) : design[index]);\n    }\n  }\n\n  /**\n   * Declare a token this root binds later (at runtime initialization) as a\n   * provider so the shared overlay catalog can resolve replacements for it.\n   * The placeholder factory is description only and never resolves.\n   */\n  declareBinding(token: unknown, lifetime: Lifetime): void {\n    this.declare(token);\n    const hookName = this.hookName;\n    this.declarations.push((bind) => refine(bind(token).toFactory(() => {\n      throw new TestWoodError(`${hookName} declared-only binding ${String(token)} has no production factory`);\n    }, []), lifetime));\n  }\n\n  /** The recorded production registrations as a declarative module (description only, never built). */\n  module(): ApplicationModule {\n    const declarations = [...this.declarations];\n    return defineModule(`@noego/wood/testing/${this.hookName}`, (bind) => {\n      for (const declaration of declarations) declaration(bind);\n    });\n  }\n\n  replay(root: IContainer): void {\n    if (this.replayed) throw new TestWoodError(`${this.hookName} registrations were already replayed`);\n    this.replayed = true;\n    if (root !== this.actualRoot) throw new TestWoodError('testWood requires @noego/testing with build({ root }) support; update the shared testing package.');\n  }\n\n  bind(root: IContainer): void {\n    if (!this.replayed) throw new TestWoodError(`${this.hookName} registrations must be replayed before binding`);\n    this.target = root;\n  }\n\n  private assertRecording(method: string): void {\n    if (this.replayed) {\n      throw new TestWoodError(\n        `${this.hookName} cannot call ${method}() after test overlays have been installed`,\n      );\n    }\n  }\n}\n\n/**\n * Materialize shared @noego/testing overlays on the same production root,\n * disposing the partially built root if materialization fails.\n */\nexport async function buildRecordedEnvironment(\n  builder: TestIocBuilder,\n  recorded: RegistrationOnlyRoot,\n  owner: string,\n  borrowedTokens: readonly unknown[] = [],\n): Promise<TestEnvironment> {\n  const partial: { root?: IContainer } = { root: recorded.actualRoot };\n  try {\n    const environment = await builder.build({\n      root: recorded.actualRoot,\n      borrowedTokens,\n      prepare: (freshRoot) => {\n        partial.root = freshRoot;\n        recorded.replay(freshRoot);\n      },\n    });\n    recorded.bind(environment.root);\n    return environment;\n  } catch (error) {\n    const failures: CleanupFailure[] = [];\n    if (partial.root) {\n      try {\n        await partial.root.dispose();\n      } catch (cleanupError) {\n        failures.push({ owner: `${owner} root rollback`, error: cleanupError });\n      }\n    }\n    if (failures.length) {\n      throw new TestWoodCleanupError(`${owner} build failed and rollback failed`, failures, error);\n    }\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/testing/runner_importer.cjs

@@ -0,0 +1,75 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var runner_importer_exports = {};
+__export(runner_importer_exports, {
+  vitestModuleImporter: () => vitestModuleImporter
+});
+module.exports = __toCommonJS(runner_importer_exports);
+var import_node_path = __toESM(require("node:path"), 1);
+var import_node_module = require("node:module");
+var import_node_fs = require("node:fs");
+var import_node_url = require("node:url");
+var import_test_wood = require("./test_wood.cjs");
+async function vitestModuleImporter(configPath) {
+  const roots = [.../* @__PURE__ */ new Set([process.cwd(), import_node_path.default.dirname(import_node_path.default.resolve(configPath))])];
+  let entry;
+  let version;
+  for (const root of roots) {
+    const require2 = (0, import_node_module.createRequire)(import_node_path.default.join(root, "package.json"));
+    try {
+      const manifest = require2.resolve("vitest/package.json");
+      const pkg = JSON.parse((0, import_node_fs.readFileSync)(manifest, "utf8"));
+      version = pkg.version;
+      const exported = pkg.exports?.["."]?.import;
+      const imported = typeof exported === "string" ? exported : exported?.default;
+      if (typeof imported !== "string") throw new Error("Vitest has no declared ESM entry");
+      entry = import_node_path.default.resolve(import_node_path.default.dirname(manifest), imported);
+      break;
+    } catch {
+    }
+  }
+  if (!entry || !version) throw new import_test_wood.TestWoodError("testWood under Vitest requires a project-local Vitest installation; none was found");
+  if (![2, 3, 4].includes(Number(version.split(".")[0]))) {
+    throw new import_test_wood.TestWoodError(`testWood under Vitest: unsupported Vitest version ${version}; expected a qualified 2.x, 3.x or 4.x project`);
+  }
+  const runner = await import(
+    /* @vite-ignore */
+    (0, import_node_url.pathToFileURL)(entry).href
+  );
+  if (typeof runner.vi?.importActual !== "function") {
+    throw new import_test_wood.TestWoodError(`testWood under Vitest: Vitest ${version} has no public importActual module API`);
+  }
+  const importActual = runner.vi.importActual.bind(runner.vi);
+  return (absolutePath) => importActual(absolutePath);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  vitestModuleImporter
+});
+//# sourceMappingURL=runner_importer.cjs.map

package/dist/testing/runner_importer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/runner_importer.ts"],"sourcesContent":["/**\n * Project-local Vitest module identity for `testWood(configPath)` builds.\n *\n * Under Vitest, hook/controller/loader modules are imported through the\n * runner's public module API (`vi.importActual`) rather than a raw dynamic\n * import, so the framework's load of a source file is the SAME module the\n * test file imported (one class identity, one token identity). The closure\n * belongs to one build and one project; nothing process-global is touched.\n */\nimport path from 'node:path';\nimport { createRequire } from 'node:module';\nimport { readFileSync } from 'node:fs';\nimport { pathToFileURL } from 'node:url';\nimport type { ModuleImporter } from './wood_config_source.cjs';\nimport { TestWoodError } from './test_wood.cjs';\n\nexport async function vitestModuleImporter(configPath: string): Promise<ModuleImporter> {\n  const roots = [...new Set([process.cwd(), path.dirname(path.resolve(configPath))])];\n  let entry: string | undefined;\n  let version: string | undefined;\n  for (const root of roots) {\n    const require = createRequire(path.join(root, 'package.json'));\n    try {\n      const manifest = require.resolve('vitest/package.json');\n      const pkg = JSON.parse(readFileSync(manifest, 'utf8')) as { version: string; exports?: Record<string, unknown> };\n      version = pkg.version;\n      const exported = (pkg.exports?.['.'] as { import?: string | { default?: string } } | undefined)?.import;\n      const imported = typeof exported === 'string' ? exported : exported?.default;\n      if (typeof imported !== 'string') throw new Error('Vitest has no declared ESM entry');\n      entry = path.resolve(path.dirname(manifest), imported);\n      break;\n    } catch { /* try the source config's project before reporting unavailable */ }\n  }\n  if (!entry || !version) throw new TestWoodError('testWood under Vitest requires a project-local Vitest installation; none was found');\n  if (![2, 3, 4].includes(Number(version.split('.')[0]))) {\n    throw new TestWoodError(`testWood under Vitest: unsupported Vitest version ${version}; expected a qualified 2.x, 3.x or 4.x project`);\n  }\n  const runner = await import(/* @vite-ignore */ pathToFileURL(entry).href) as {\n    vi?: { importActual?: (path: string) => Promise<unknown> };\n  };\n  if (typeof runner.vi?.importActual !== 'function') {\n    throw new TestWoodError(`testWood under Vitest: Vitest ${version} has no public importActual module API`);\n  }\n  const importActual = runner.vi.importActual.bind(runner.vi);\n  return (absolutePath) => importActual(absolutePath);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,uBAAiB;AACjB,yBAA8B;AAC9B,qBAA6B;AAC7B,sBAA8B;AAE9B,uBAA8B;AAE9B,eAAsB,qBAAqB,YAA6C;AACtF,QAAM,QAAQ,CAAC,GAAG,oBAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,iBAAAA,QAAK,QAAQ,iBAAAA,QAAK,QAAQ,UAAU,CAAC,CAAC,CAAC,CAAC;AAClF,MAAI;AACJ,MAAI;AACJ,aAAW,QAAQ,OAAO;AACxB,UAAMC,eAAU,kCAAc,iBAAAD,QAAK,KAAK,MAAM,cAAc,CAAC;AAC7D,QAAI;AACF,YAAM,WAAWC,SAAQ,QAAQ,qBAAqB;AACtD,YAAM,MAAM,KAAK,UAAM,6BAAa,UAAU,MAAM,CAAC;AACrD,gBAAU,IAAI;AACd,YAAM,WAAY,IAAI,UAAU,GAAG,GAA8D;AACjG,YAAM,WAAW,OAAO,aAAa,WAAW,WAAW,UAAU;AACrE,UAAI,OAAO,aAAa,SAAU,OAAM,IAAI,MAAM,kCAAkC;AACpF,cAAQ,iBAAAD,QAAK,QAAQ,iBAAAA,QAAK,QAAQ,QAAQ,GAAG,QAAQ;AACrD;AAAA,IACF,QAAQ;AAAA,IAAqE;AAAA,EAC/E;AACA,MAAI,CAAC,SAAS,CAAC,QAAS,OAAM,IAAI,+BAAc,oFAAoF;AACpI,MAAI,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,SAAS,OAAO,QAAQ,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG;AACtD,UAAM,IAAI,+BAAc,qDAAqD,OAAO,gDAAgD;AAAA,EACtI;AACA,QAAM,SAAS,MAAM;AAAA;AAAA,QAA0B,+BAAc,KAAK,EAAE;AAAA;AAGpE,MAAI,OAAO,OAAO,IAAI,iBAAiB,YAAY;AACjD,UAAM,IAAI,+BAAc,iCAAiC,OAAO,wCAAwC;AAAA,EAC1G;AACA,QAAM,eAAe,OAAO,GAAG,aAAa,KAAK,OAAO,EAAE;AAC1D,SAAO,CAAC,iBAAiB,aAAa,YAAY;AACpD;","names":["path","require"]}

package/dist/testing/runner_importer.d.cts

@@ -0,0 +1,8 @@
+import { ModuleImporter } from './wood_config_source.cjs';
+import '../types/config.cjs';
+import '../types/operations.cjs';
+import '../types/views.cjs';
+
+declare function vitestModuleImporter(configPath: string): Promise<ModuleImporter>;
+
+export { vitestModuleImporter };

package/dist/testing/runner_importer.d.ts

@@ -0,0 +1,8 @@
+import { ModuleImporter } from './wood_config_source.js';
+import '../types/config.js';
+import '../types/operations.js';
+import '../types/views.js';
+
+declare function vitestModuleImporter(configPath: string): Promise<ModuleImporter>;
+
+export { vitestModuleImporter };

package/dist/testing/runner_importer.js

@@ -0,0 +1,41 @@
+import path from "node:path";
+import { createRequire } from "node:module";
+import { readFileSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { TestWoodError } from "./test_wood.js";
+async function vitestModuleImporter(configPath) {
+  const roots = [.../* @__PURE__ */ new Set([process.cwd(), path.dirname(path.resolve(configPath))])];
+  let entry;
+  let version;
+  for (const root of roots) {
+    const require2 = createRequire(path.join(root, "package.json"));
+    try {
+      const manifest = require2.resolve("vitest/package.json");
+      const pkg = JSON.parse(readFileSync(manifest, "utf8"));
+      version = pkg.version;
+      const exported = pkg.exports?.["."]?.import;
+      const imported = typeof exported === "string" ? exported : exported?.default;
+      if (typeof imported !== "string") throw new Error("Vitest has no declared ESM entry");
+      entry = path.resolve(path.dirname(manifest), imported);
+      break;
+    } catch {
+    }
+  }
+  if (!entry || !version) throw new TestWoodError("testWood under Vitest requires a project-local Vitest installation; none was found");
+  if (![2, 3, 4].includes(Number(version.split(".")[0]))) {
+    throw new TestWoodError(`testWood under Vitest: unsupported Vitest version ${version}; expected a qualified 2.x, 3.x or 4.x project`);
+  }
+  const runner = await import(
+    /* @vite-ignore */
+    pathToFileURL(entry).href
+  );
+  if (typeof runner.vi?.importActual !== "function") {
+    throw new TestWoodError(`testWood under Vitest: Vitest ${version} has no public importActual module API`);
+  }
+  const importActual = runner.vi.importActual.bind(runner.vi);
+  return (absolutePath) => importActual(absolutePath);
+}
+export {
+  vitestModuleImporter
+};
+//# sourceMappingURL=runner_importer.js.map

package/dist/testing/runner_importer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/runner_importer.ts"],"sourcesContent":["/**\n * Project-local Vitest module identity for `testWood(configPath)` builds.\n *\n * Under Vitest, hook/controller/loader modules are imported through the\n * runner's public module API (`vi.importActual`) rather than a raw dynamic\n * import, so the framework's load of a source file is the SAME module the\n * test file imported (one class identity, one token identity). The closure\n * belongs to one build and one project; nothing process-global is touched.\n */\nimport path from 'node:path';\nimport { createRequire } from 'node:module';\nimport { readFileSync } from 'node:fs';\nimport { pathToFileURL } from 'node:url';\nimport type { ModuleImporter } from './wood_config_source.js';\nimport { TestWoodError } from './test_wood.js';\n\nexport async function vitestModuleImporter(configPath: string): Promise<ModuleImporter> {\n  const roots = [...new Set([process.cwd(), path.dirname(path.resolve(configPath))])];\n  let entry: string | undefined;\n  let version: string | undefined;\n  for (const root of roots) {\n    const require = createRequire(path.join(root, 'package.json'));\n    try {\n      const manifest = require.resolve('vitest/package.json');\n      const pkg = JSON.parse(readFileSync(manifest, 'utf8')) as { version: string; exports?: Record<string, unknown> };\n      version = pkg.version;\n      const exported = (pkg.exports?.['.'] as { import?: string | { default?: string } } | undefined)?.import;\n      const imported = typeof exported === 'string' ? exported : exported?.default;\n      if (typeof imported !== 'string') throw new Error('Vitest has no declared ESM entry');\n      entry = path.resolve(path.dirname(manifest), imported);\n      break;\n    } catch { /* try the source config's project before reporting unavailable */ }\n  }\n  if (!entry || !version) throw new TestWoodError('testWood under Vitest requires a project-local Vitest installation; none was found');\n  if (![2, 3, 4].includes(Number(version.split('.')[0]))) {\n    throw new TestWoodError(`testWood under Vitest: unsupported Vitest version ${version}; expected a qualified 2.x, 3.x or 4.x project`);\n  }\n  const runner = await import(/* @vite-ignore */ pathToFileURL(entry).href) as {\n    vi?: { importActual?: (path: string) => Promise<unknown> };\n  };\n  if (typeof runner.vi?.importActual !== 'function') {\n    throw new TestWoodError(`testWood under Vitest: Vitest ${version} has no public importActual module API`);\n  }\n  const importActual = runner.vi.importActual.bind(runner.vi);\n  return (absolutePath) => importActual(absolutePath);\n}\n"],"mappings":"AASA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAE9B,SAAS,qBAAqB;AAE9B,eAAsB,qBAAqB,YAA6C;AACtF,QAAM,QAAQ,CAAC,GAAG,oBAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,KAAK,QAAQ,KAAK,QAAQ,UAAU,CAAC,CAAC,CAAC,CAAC;AAClF,MAAI;AACJ,MAAI;AACJ,aAAW,QAAQ,OAAO;AACxB,UAAMA,WAAU,cAAc,KAAK,KAAK,MAAM,cAAc,CAAC;AAC7D,QAAI;AACF,YAAM,WAAWA,SAAQ,QAAQ,qBAAqB;AACtD,YAAM,MAAM,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AACrD,gBAAU,IAAI;AACd,YAAM,WAAY,IAAI,UAAU,GAAG,GAA8D;AACjG,YAAM,WAAW,OAAO,aAAa,WAAW,WAAW,UAAU;AACrE,UAAI,OAAO,aAAa,SAAU,OAAM,IAAI,MAAM,kCAAkC;AACpF,cAAQ,KAAK,QAAQ,KAAK,QAAQ,QAAQ,GAAG,QAAQ;AACrD;AAAA,IACF,QAAQ;AAAA,IAAqE;AAAA,EAC/E;AACA,MAAI,CAAC,SAAS,CAAC,QAAS,OAAM,IAAI,cAAc,oFAAoF;AACpI,MAAI,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,SAAS,OAAO,QAAQ,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG;AACtD,UAAM,IAAI,cAAc,qDAAqD,OAAO,gDAAgD;AAAA,EACtI;AACA,QAAM,SAAS,MAAM;AAAA;AAAA,IAA0B,cAAc,KAAK,EAAE;AAAA;AAGpE,MAAI,OAAO,OAAO,IAAI,iBAAiB,YAAY;AACjD,UAAM,IAAI,cAAc,iCAAiC,OAAO,wCAAwC;AAAA,EAC1G;AACA,QAAM,eAAe,OAAO,GAAG,aAAa,KAAK,OAAO,EAAE;AAC1D,SAAO,CAAC,iBAAiB,aAAa,YAAY;AACpD;","names":["require"]}