@noego/wood 0.6.2 → 0.7.1

package/dist/test-wood.js

@@ -0,0 +1,115 @@
+import { fileURLToPath } from "node:url";
+const logs = /* @__PURE__ */ new WeakMap();
+function derive(builder, method, args) {
+  const state = logs.get(builder);
+  const copied = [...args];
+  const optionsIndex = method === "method" ? 3 : 2;
+  if (!["select", "use"].includes(method) && copied[optionsIndex] !== void 0) {
+    copied[optionsIndex] = Object.freeze({ ...copied[optionsIndex] });
+  }
+  if (method === "load" && typeof copied[0] !== "string") copied[0] = Object.freeze({ ...copied[0] });
+  const child = Object.create(WoodTestBuilder.prototype);
+  logs.set(child, {
+    config: state.config,
+    commands: Object.freeze([...state.commands, Object.freeze({ method, args: Object.freeze(copied) })])
+  });
+  return Object.freeze(child);
+}
+function plain(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value) && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+function copyOwner(owner, input) {
+  if (!plain(input) || Reflect.ownKeys(input).some((key) => key !== "module" && key !== "path") || Reflect.ownKeys(input).length > 1) {
+    throw new TypeError(`select({ ${owner} }) takes module OR path, or {}`);
+  }
+  const value = { ...input };
+  if (typeof value.module === "string") value.module = Object.freeze([value.module]);
+  else if (Array.isArray(value.module)) value.module = Object.freeze([...value.module]);
+  if (Array.isArray(value.path)) value.path = Object.freeze([...value.path]);
+  return Object.freeze(value);
+}
+function copySelection(selection) {
+  if (!plain(selection) || Reflect.ownKeys(selection).some((key) => key !== "main" && key !== "renderer")) {
+    throw new TypeError("select requires { main } and/or { renderer }");
+  }
+  const out = {};
+  if ("main" in selection) out.main = copyOwner("main", selection.main);
+  if ("renderer" in selection) out.renderer = copyOwner("renderer", selection.renderer);
+  if (!("main" in out) && !("renderer" in out)) throw new TypeError("select requires { main } and/or { renderer }");
+  return Object.freeze(out);
+}
+function identity(value, what) {
+  if (typeof value !== "string" || !value.trim()) throw new TypeError(`${what} requires a nonempty identity`);
+}
+class WoodTestBuilder {
+  constructor() {
+  }
+  fetch(configure) {
+    if (typeof configure !== "function") throw new TypeError("fetch() requires a route configuration callback");
+    return derive(this, "fetch", [configure]);
+  }
+  browser(host = "playwright") {
+    if (host !== "playwright" && host !== "happy_dom") throw new TypeError("browser() accepts playwright or happy_dom");
+    return derive(this, "browser", [host]);
+  }
+  select(selection) {
+    return derive(this, "select", [copySelection(selection)]);
+  }
+  use(stub) {
+    if (!stub || typeof stub !== "object") throw new TypeError("use() expects a testStub() description");
+    return derive(this, "use", [stub]);
+  }
+  class(target, replacement, options) {
+    return derive(this, "class", options === void 0 ? [target, replacement] : [target, replacement, options]);
+  }
+  function(target, replacement, options) {
+    return derive(this, "function", options === void 0 ? [target, replacement] : [target, replacement, options]);
+  }
+  method(target, method, replacement, options) {
+    identity(method, "method()");
+    return derive(this, "method", options === void 0 ? [target, method, replacement] : [target, method, replacement, options]);
+  }
+  value(target, replacement, options) {
+    return derive(this, "value", options === void 0 ? [target, replacement] : [target, replacement, options]);
+  }
+  middleware(identity_, replacement, options) {
+    identity(identity_, "middleware()");
+    return derive(this, "middleware", options === void 0 ? [identity_, replacement] : [identity_, replacement, options]);
+  }
+  load(identity_, replacement, options) {
+    return derive(this, "load", options === void 0 ? [identity_, replacement] : [identity_, replacement, options]);
+  }
+  /**
+   * Load the implementation and replay the recorded calls in order. Under
+   * Vitest the build binds to the project-local runner's module registry so
+   * production modules keep the identity the test file imported.
+   */
+  async build() {
+    const state = logs.get(this);
+    const implementation = await import("./testing/index.js");
+    let builder = implementation.testWood(state.config);
+    if (process.env.VITEST) builder = builder.importer(await implementation.vitestModuleImporter(state.config));
+    for (const command of state.commands) {
+      if (command.method === "use") {
+        const { stubEntries } = await import("@noego/testing");
+        stubEntries(command.args[0]);
+      }
+      builder = builder[command.method].apply(builder, [...command.args]);
+    }
+    const environment = await builder.build();
+    const { registerTestResource } = await import("@noego/testing");
+    return await registerTestResource(environment, "testWood");
+  }
+}
+function testWood(configPath) {
+  const config = configPath instanceof URL ? fileURLToPath(configPath) : typeof configPath === "string" && configPath.startsWith("file:") ? fileURLToPath(configPath) : configPath;
+  if (typeof config !== "string" || !config.trim()) throw new TypeError("testWood requires an original wood.config.yml path or file URL");
+  const builder = Object.create(WoodTestBuilder.prototype);
+  logs.set(builder, { config, commands: Object.freeze([]) });
+  return Object.freeze(builder);
+}
+export {
+  WoodTestBuilder,
+  testWood
+};
+//# sourceMappingURL=test-wood.js.map

package/dist/test-wood.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/test-wood.ts"],"sourcesContent":["import type { ConfigureFetch } from '@noego/testing/fetch';\n/**\n * Production-safe Wood testing facade, exported from the `@noego/wood` root.\n *\n * Importing `@noego/wood` or declaring a test loads no testing, DOM,\n * Playwright or Electron modules: every call is recorded on an immutable\n * builder and replayed onto the real `@noego/wood/testing` implementation\n * only inside `build()`.\n *\n * The canonical surface is exactly:\n *\n *   select({ main?, renderer? })   what exists (module | path | {} per owner)\n *   use(testStub())                compose a shared replacement description\n *   class / function / method / value   exact declared tokens\n *   middleware(identity, …)        the executable behind a source middleware id\n *   load(identity, …)              the page/layout companion data loader\n *   browser([happy_dom])           native Page (default) or happy-dom Window\n *   build()                        no selection = every declared owner, whole\n *\n * Explicit browser() selects a native renderer host. Without it, renderer\n * selection stays in the fast in-process Node controller tier.\n */\nimport { fileURLToPath } from 'node:url';\nimport type {\n  ExecutableReplacement,\n  LoaderIdentity,\n  MethodDescriptor,\n  OwnerSelection,\n  ClassToken, ReplacementClass,\n  ReplacementFunction,\n  ReplacementOptions,\n  TestStub,\n} from '@noego/testing';\nimport type { TestWoodBuilder } from './testing/index.js';\nimport type { WoodBrowserHost, WoodTestEnvironmentFor } from './testing/native_browser/native_browser.types.js';\n\nexport interface WoodTestSelection {\n  readonly main?: OwnerSelection;\n  readonly renderer?: OwnerSelection;\n}\n\ntype Method = 'select' | 'use' | 'class' | 'function' | 'method' | 'value' | 'middleware' | 'load' | 'browser' | 'fetch';\ntype Command = Readonly<{ method: Method; args: readonly unknown[] }>;\nconst logs = new WeakMap<object, { config: string; commands: readonly Command[] }>();\n\nfunction derive<H extends WoodBrowserHost | null>(builder: WoodTestBuilder<H>, method: Method, args: readonly unknown[]): WoodTestBuilder<H> {\n  const state = logs.get(builder)!;\n  const copied = [...args];\n  const optionsIndex = method === 'method' ? 3 : 2;\n  if (!['select', 'use'].includes(method) && copied[optionsIndex] !== undefined) {\n    copied[optionsIndex] = Object.freeze({ ...(copied[optionsIndex] as ReplacementOptions) });\n  }\n  if (method === 'load' && typeof copied[0] !== 'string') copied[0] = Object.freeze({ ...(copied[0] as object) });\n  const child = Object.create(WoodTestBuilder.prototype) as WoodTestBuilder<H>;\n  logs.set(child, {\n    config: state.config,\n    commands: Object.freeze([...state.commands, Object.freeze({ method, args: Object.freeze(copied) })]),\n  });\n  return Object.freeze(child);\n}\n\nfunction plain(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === 'object' && !Array.isArray(value)\n    && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);\n}\nfunction copyOwner(owner: string, input: unknown): OwnerSelection {\n  if (!plain(input)\n    || Reflect.ownKeys(input).some(key => key !== 'module' && key !== 'path')\n    || Reflect.ownKeys(input).length > 1) {\n    throw new TypeError(`select({ ${owner} }) takes module OR path, or {}`);\n  }\n  const value = { ...(input as Record<string, unknown>) };\n  if (typeof value.module === 'string') value.module = Object.freeze([value.module]);\n  else if (Array.isArray(value.module)) value.module = Object.freeze([...value.module]);\n  if (Array.isArray(value.path)) value.path = Object.freeze([...value.path]);\n  return Object.freeze(value) as OwnerSelection;\n}\n\n/** Structural copy only; owner contents are validated by the shared contract at build. */\nfunction copySelection(selection: WoodTestSelection): WoodTestSelection {\n  if (!plain(selection)\n    || Reflect.ownKeys(selection).some(key => key !== 'main' && key !== 'renderer')) {\n    throw new TypeError('select requires { main } and/or { renderer }');\n  }\n  const out: { main?: OwnerSelection; renderer?: OwnerSelection } = {};\n  if ('main' in selection) out.main = copyOwner('main', selection.main);\n  if ('renderer' in selection) out.renderer = copyOwner('renderer', selection.renderer);\n  if (!('main' in out) && !('renderer' in out)) throw new TypeError('select requires { main } and/or { renderer }');\n  return Object.freeze(out);\n}\n\nfunction identity(value: unknown, what: string): void {\n  if (typeof value !== 'string' || !value.trim()) throw new TypeError(`${what} requires a nonempty identity`);\n}\n\n/** The root-export builder: a recorder over the `@noego/wood/testing` builder's canonical surface. */\nexport class WoodTestBuilder<H extends WoodBrowserHost | null = null> {\n  private constructor() {}\n  fetch(configure: ConfigureFetch): WoodTestBuilder<H> {\n    if (typeof configure !== 'function') throw new TypeError('fetch() requires a route configuration callback');\n    return derive(this, 'fetch', [configure]);\n  }\n  /** No argument = Playwright/Chromium; happy_dom = a native happy-dom Window. */\n  browser(): WoodTestBuilder<'playwright'>;\n  browser(host: 'playwright'): WoodTestBuilder<'playwright'>;\n  browser(host: 'happy_dom'): WoodTestBuilder<'happy_dom'>;\n  browser(host: WoodBrowserHost = 'playwright'): WoodTestBuilder<WoodBrowserHost> {\n    if (host !== 'playwright' && host !== 'happy_dom') throw new TypeError('browser() accepts playwright or happy_dom');\n    return derive(this, 'browser', [host]) as WoodTestBuilder<WoodBrowserHost>;\n  }\n  select(selection: WoodTestSelection): WoodTestBuilder<H> { return derive(this, 'select', [copySelection(selection)]); }\n  use(stub: TestStub): WoodTestBuilder<H> {\n    if (!stub || typeof stub !== 'object') throw new TypeError('use() expects a testStub() description');\n    return derive(this, 'use', [stub]);\n  }\n  class<T>(target: ClassToken<T>, replacement: ReplacementClass<T>, options?: ReplacementOptions): WoodTestBuilder<H> {\n    return derive(this, 'class', options === undefined ? [target, replacement] : [target, replacement, options]);\n  }\n  function(target: unknown, replacement: ReplacementFunction, options?: ReplacementOptions): WoodTestBuilder<H> {\n    return derive(this, 'function', options === undefined ? [target, replacement] : [target, replacement, options]);\n  }\n  method(target: unknown, method: string, replacement: MethodDescriptor, options?: ReplacementOptions): WoodTestBuilder<H> {\n    identity(method, 'method()');\n    return derive(this, 'method', options === undefined ? [target, method, replacement] : [target, method, replacement, options]);\n  }\n  value(target: unknown, replacement: unknown, options?: ReplacementOptions): WoodTestBuilder<H> {\n    return derive(this, 'value', options === undefined ? [target, replacement] : [target, replacement, options]);\n  }\n  middleware(identity_: string, replacement: ExecutableReplacement, options?: ReplacementOptions): WoodTestBuilder<H> {\n    identity(identity_, 'middleware()');\n    return derive(this, 'middleware', options === undefined ? [identity_, replacement] : [identity_, replacement, options]);\n  }\n  load(identity_: LoaderIdentity, replacement: ExecutableReplacement, options?: ReplacementOptions): WoodTestBuilder<H> {\n    return derive(this, 'load', options === undefined ? [identity_, replacement] : [identity_, replacement, options]);\n  }\n  /**\n   * Load the implementation and replay the recorded calls in order. Under\n   * Vitest the build binds to the project-local runner's module registry so\n   * production modules keep the identity the test file imported.\n   */\n  async build(): Promise<WoodTestEnvironmentFor<H>> {\n    const state = logs.get(this)!;\n    const implementation = await import('./testing/index.js');\n    let builder: TestWoodBuilder = implementation.testWood(state.config);\n    if (process.env.VITEST) builder = builder.importer(await implementation.vitestModuleImporter(state.config));\n    for (const command of state.commands) {\n      if (command.method === 'use') {\n        const { stubEntries } = await import('@noego/testing');\n        stubEntries(command.args[0] as TestStub); // reject legacy IoC presets on the canonical root facade\n      }\n      builder = (builder[command.method] as (...args: unknown[]) => TestWoodBuilder).apply(builder, [...command.args]);\n    }\n    const environment = await builder.build();\n    const { registerTestResource } = await import('@noego/testing');\n    return await registerTestResource(environment, 'testWood') as WoodTestEnvironmentFor<H>;\n  }\n}\n\nexport function testWood(configPath: string | URL): WoodTestBuilder {\n  const config = configPath instanceof URL ? fileURLToPath(configPath)\n    : typeof configPath === 'string' && configPath.startsWith('file:') ? fileURLToPath(configPath) : configPath;\n  if (typeof config !== 'string' || !config.trim()) throw new TypeError('testWood requires an original wood.config.yml path or file URL');\n  const builder = Object.create(WoodTestBuilder.prototype) as WoodTestBuilder;\n  logs.set(builder, { config, commands: Object.freeze([]) });\n  return Object.freeze(builder);\n}\n"],"mappings":"AAsBA,SAAS,qBAAqB;AAqB9B,MAAM,OAAO,oBAAI,QAAkE;AAEnF,SAAS,OAAyC,SAA6B,QAAgB,MAA8C;AAC3I,QAAM,QAAQ,KAAK,IAAI,OAAO;AAC9B,QAAM,SAAS,CAAC,GAAG,IAAI;AACvB,QAAM,eAAe,WAAW,WAAW,IAAI;AAC/C,MAAI,CAAC,CAAC,UAAU,KAAK,EAAE,SAAS,MAAM,KAAK,OAAO,YAAY,MAAM,QAAW;AAC7E,WAAO,YAAY,IAAI,OAAO,OAAO,EAAE,GAAI,OAAO,YAAY,EAAyB,CAAC;AAAA,EAC1F;AACA,MAAI,WAAW,UAAU,OAAO,OAAO,CAAC,MAAM,SAAU,QAAO,CAAC,IAAI,OAAO,OAAO,EAAE,GAAI,OAAO,CAAC,EAAa,CAAC;AAC9G,QAAM,QAAQ,OAAO,OAAO,gBAAgB,SAAS;AACrD,OAAK,IAAI,OAAO;AAAA,IACd,QAAQ,MAAM;AAAA,IACd,UAAU,OAAO,OAAO,CAAC,GAAG,MAAM,UAAU,OAAO,OAAO,EAAE,QAAQ,MAAM,OAAO,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC;AAAA,EACrG,CAAC;AACD,SAAO,OAAO,OAAO,KAAK;AAC5B;AAEA,SAAS,MAAM,OAAkD;AAC/D,SAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,MAC7D,OAAO,eAAe,KAAK,MAAM,OAAO,aAAa,OAAO,eAAe,KAAK,MAAM;AAC9F;AACA,SAAS,UAAU,OAAe,OAAgC;AAChE,MAAI,CAAC,MAAM,KAAK,KACX,QAAQ,QAAQ,KAAK,EAAE,KAAK,SAAO,QAAQ,YAAY,QAAQ,MAAM,KACrE,QAAQ,QAAQ,KAAK,EAAE,SAAS,GAAG;AACtC,UAAM,IAAI,UAAU,YAAY,KAAK,iCAAiC;AAAA,EACxE;AACA,QAAM,QAAQ,EAAE,GAAI,MAAkC;AACtD,MAAI,OAAO,MAAM,WAAW,SAAU,OAAM,SAAS,OAAO,OAAO,CAAC,MAAM,MAAM,CAAC;AAAA,WACxE,MAAM,QAAQ,MAAM,MAAM,EAAG,OAAM,SAAS,OAAO,OAAO,CAAC,GAAG,MAAM,MAAM,CAAC;AACpF,MAAI,MAAM,QAAQ,MAAM,IAAI,EAAG,OAAM,OAAO,OAAO,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC;AACzE,SAAO,OAAO,OAAO,KAAK;AAC5B;AAGA,SAAS,cAAc,WAAiD;AACtE,MAAI,CAAC,MAAM,SAAS,KACf,QAAQ,QAAQ,SAAS,EAAE,KAAK,SAAO,QAAQ,UAAU,QAAQ,UAAU,GAAG;AACjF,UAAM,IAAI,UAAU,8CAA8C;AAAA,EACpE;AACA,QAAM,MAA4D,CAAC;AACnE,MAAI,UAAU,UAAW,KAAI,OAAO,UAAU,QAAQ,UAAU,IAAI;AACpE,MAAI,cAAc,UAAW,KAAI,WAAW,UAAU,YAAY,UAAU,QAAQ;AACpF,MAAI,EAAE,UAAU,QAAQ,EAAE,cAAc,KAAM,OAAM,IAAI,UAAU,8CAA8C;AAChH,SAAO,OAAO,OAAO,GAAG;AAC1B;AAEA,SAAS,SAAS,OAAgB,MAAoB;AACpD,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,EAAG,OAAM,IAAI,UAAU,GAAG,IAAI,+BAA+B;AAC5G;AAGO,MAAM,gBAAyD;AAAA,EAC5D,cAAc;AAAA,EAAC;AAAA,EACvB,MAAM,WAA+C;AACnD,QAAI,OAAO,cAAc,WAAY,OAAM,IAAI,UAAU,iDAAiD;AAC1G,WAAO,OAAO,MAAM,SAAS,CAAC,SAAS,CAAC;AAAA,EAC1C;AAAA,EAKA,QAAQ,OAAwB,cAAgD;AAC9E,QAAI,SAAS,gBAAgB,SAAS,YAAa,OAAM,IAAI,UAAU,2CAA2C;AAClH,WAAO,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC;AAAA,EACvC;AAAA,EACA,OAAO,WAAkD;AAAE,WAAO,OAAO,MAAM,UAAU,CAAC,cAAc,SAAS,CAAC,CAAC;AAAA,EAAG;AAAA,EACtH,IAAI,MAAoC;AACtC,QAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,OAAM,IAAI,UAAU,wCAAwC;AACnG,WAAO,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;AAAA,EACnC;AAAA,EACA,MAAS,QAAuB,aAAkC,SAAkD;AAClH,WAAO,OAAO,MAAM,SAAS,YAAY,SAAY,CAAC,QAAQ,WAAW,IAAI,CAAC,QAAQ,aAAa,OAAO,CAAC;AAAA,EAC7G;AAAA,EACA,SAAS,QAAiB,aAAkC,SAAkD;AAC5G,WAAO,OAAO,MAAM,YAAY,YAAY,SAAY,CAAC,QAAQ,WAAW,IAAI,CAAC,QAAQ,aAAa,OAAO,CAAC;AAAA,EAChH;AAAA,EACA,OAAO,QAAiB,QAAgB,aAA+B,SAAkD;AACvH,aAAS,QAAQ,UAAU;AAC3B,WAAO,OAAO,MAAM,UAAU,YAAY,SAAY,CAAC,QAAQ,QAAQ,WAAW,IAAI,CAAC,QAAQ,QAAQ,aAAa,OAAO,CAAC;AAAA,EAC9H;AAAA,EACA,MAAM,QAAiB,aAAsB,SAAkD;AAC7F,WAAO,OAAO,MAAM,SAAS,YAAY,SAAY,CAAC,QAAQ,WAAW,IAAI,CAAC,QAAQ,aAAa,OAAO,CAAC;AAAA,EAC7G;AAAA,EACA,WAAW,WAAmB,aAAoC,SAAkD;AAClH,aAAS,WAAW,cAAc;AAClC,WAAO,OAAO,MAAM,cAAc,YAAY,SAAY,CAAC,WAAW,WAAW,IAAI,CAAC,WAAW,aAAa,OAAO,CAAC;AAAA,EACxH;AAAA,EACA,KAAK,WAA2B,aAAoC,SAAkD;AACpH,WAAO,OAAO,MAAM,QAAQ,YAAY,SAAY,CAAC,WAAW,WAAW,IAAI,CAAC,WAAW,aAAa,OAAO,CAAC;AAAA,EAClH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAA4C;AAChD,UAAM,QAAQ,KAAK,IAAI,IAAI;AAC3B,UAAM,iBAAiB,MAAM,OAAO,oBAAoB;AACxD,QAAI,UAA2B,eAAe,SAAS,MAAM,MAAM;AACnE,QAAI,QAAQ,IAAI,OAAQ,WAAU,QAAQ,SAAS,MAAM,eAAe,qBAAqB,MAAM,MAAM,CAAC;AAC1G,eAAW,WAAW,MAAM,UAAU;AACpC,UAAI,QAAQ,WAAW,OAAO;AAC5B,cAAM,EAAE,YAAY,IAAI,MAAM,OAAO,gBAAgB;AACrD,oBAAY,QAAQ,KAAK,CAAC,CAAa;AAAA,MACzC;AACA,gBAAW,QAAQ,QAAQ,MAAM,EAA8C,MAAM,SAAS,CAAC,GAAG,QAAQ,IAAI,CAAC;AAAA,IACjH;AACA,UAAM,cAAc,MAAM,QAAQ,MAAM;AACxC,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,gBAAgB;AAC9D,WAAO,MAAM,qBAAqB,aAAa,UAAU;AAAA,EAC3D;AACF;AAEO,SAAS,SAAS,YAA2C;AAClE,QAAM,SAAS,sBAAsB,MAAM,cAAc,UAAU,IAC/D,OAAO,eAAe,YAAY,WAAW,WAAW,OAAO,IAAI,cAAc,UAAU,IAAI;AACnG,MAAI,OAAO,WAAW,YAAY,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,UAAU,gEAAgE;AACtI,QAAM,UAAU,OAAO,OAAO,gBAAgB,SAAS;AACvD,OAAK,IAAI,SAAS,EAAE,QAAQ,UAAU,OAAO,OAAO,CAAC,CAAC,EAAE,CAAC;AACzD,SAAO,OAAO,OAAO,OAAO;AAC9B;","names":[]}

package/dist/testing/browser.cjs

@@ -28,8 +28,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var browser_exports = {};
 __export(browser_exports, {
-  browser: () => browser,
+  browserAssertions: () => browserAssertions,
   createBrowserBridgeFixture: () => createBrowserBridgeFixture,
+  createBrowserFixture: () => createBrowserFixture,
+  createWoodBrowserResolver: () => createWoodBrowserResolver,
+  loadSveltePlugin: () => loadSveltePlugin,
   startSharedBrowserViteServer: () => startSharedBrowserViteServer
 });
 module.exports = __toCommonJS(browser_exports);
@@ -40,6 +43,7 @@ var import_node_path = __toESM(require("node:path"), 1);
 var import_node_url = require("node:url");
 var import_tracing = require("../tracing/index.js");
 var import_trace_testing = require("../trace-testing/index.js");
+var import_renderer_app_generator = require("../codegen/renderer_app_generator.cjs");
 var import_geometry = require("./geometry.js");
 const DEFAULT_VIEWPORT = {
   width: 1280,
@@ -97,6 +101,16 @@ async function waitForBoundedClose(promise, timeoutMs = DEFAULT_RESOURCE_CLOSE_T
     clearTimeout(timeout);
   }
 }
+async function closeRequired(promise, owner) {
+  let timeout;
+  try {
+    await Promise.race([promise, new Promise((_, reject) => {
+      timeout = setTimeout(() => reject(new Error(`${owner} cleanup timed out`)), DEFAULT_RESOURCE_CLOSE_TIMEOUT_MS);
+    })]);
+  } finally {
+    if (timeout) clearTimeout(timeout);
+  }
+}
 function channelToManifestEntry(channel, handler) {
   const pathSegments = channel.split(".").filter(Boolean);
   const action = pathSegments.length > 0 ? pathSegments[pathSegments.length - 1] : channel;
@@ -256,6 +270,11 @@ function createWoodBrowserResolver(rootDir) {
     name: "wood-browser-resolver",
     enforce: "pre",
     resolveId(source) {
+      if (source.startsWith("@noego/wood/")) {
+        const resolved = resolvePackageModule(rootDir, source);
+        const esm = resolved?.endsWith(".cjs") ? resolved.replace(/\.cjs$/, ".js") : resolved;
+        return esm && import_node_fs.default.existsSync(esm) ? esm : null;
+      }
       if (source === "svelte") {
         return svelteClientEntry;
       }
@@ -339,14 +358,14 @@ function workerRuntimeKey(input) {
   ].join("::");
 }
 async function createBrowserWorkerRuntime(input) {
-  let browser2 = null;
+  let browser = null;
   let cacheRoot = null;
   let ownedServer = null;
   try {
     const playwrightBrowser = await loadPlaywright(input.browserName, input.rootDir);
     if (input.wsEndpoint) {
       try {
-        browser2 = await playwrightBrowser.connect(input.wsEndpoint);
+        browser = await playwrightBrowser.connect(input.wsEndpoint);
       } catch (error) {
         if (!browserConnectWarnings.has(input.wsEndpoint)) {
           browserConnectWarnings.add(input.wsEndpoint);
@@ -357,8 +376,8 @@ async function createBrowserWorkerRuntime(input) {
         }
       }
     }
-    if (!browser2) {
-      browser2 = await playwrightBrowser.launch({ headless: input.headless });
+    if (!browser) {
+      browser = await playwrightBrowser.launch({ headless: input.headless });
     }
     let vite;
     if (input.viteUrl) {
@@ -378,7 +397,7 @@ async function createBrowserWorkerRuntime(input) {
       };
     }
     return {
-      browser: browser2,
+      browser,
       vite,
       rootDir: input.rootDir,
       key: input.key,
@@ -388,7 +407,7 @@ async function createBrowserWorkerRuntime(input) {
     };
   } catch (error) {
     await Promise.all([
-      browser2?.close().catch(() => void 0),
+      browser?.close().catch(() => void 0),
       ownedServer?.close().catch(() => void 0)
     ]);
     if (cacheRoot) {
@@ -499,7 +518,19 @@ function assertFileExists(filePath, label) {
 function writeEntry(tempDir, name, source) {
   import_node_fs.default.mkdirSync(tempDir, { recursive: true });
   const entryPath = import_node_path.default.join(tempDir, `${name}.ts`);
-  import_node_fs.default.writeFileSync(entryPath, source);
+  import_node_fs.default.writeFileSync(entryPath, `import { unmount as __woodHarnessUnmount } from 'svelte';
+` + source + `
+let __woodHarnessClosing;
+window.__WOOD_BROWSER_UNMOUNT__ = () => __woodHarnessClosing ??= Promise.resolve().then(async () => {
+  const app = window.__WOOD_BROWSER_APP__;
+  if (!app) return;
+  try { await app.disposeNavigation?.(); }
+  finally {
+    await __woodHarnessUnmount(app);
+    window.__WOOD_BROWSER_APP__ = undefined;
+  }
+});
+`);
   return entryPath;
 }
 function writeHtml(tempDir, name, entryPath, cssFiles) {
@@ -532,103 +563,6 @@ function findView(views, routeKey) {
   }
   return found;
 }
-function resolveComponentPath(rootDir, componentDir, filePath) {
-  if (import_node_path.default.isAbsolute(filePath)) return filePath;
-  const base = componentDir ? resolveFromRoot(rootDir, componentDir) : rootDir;
-  const componentDirName = componentDir ? import_node_path.default.basename(componentDir) : "";
-  if (componentDirName && filePath.replace(/\\/g, "/").startsWith(`${componentDirName}/`)) {
-    return import_node_path.default.resolve(base, filePath.slice(componentDirName.length + 1));
-  }
-  return import_node_path.default.resolve(base, filePath);
-}
-function buildRouteEntrySource(input) {
-  const { view, rootDir, componentDir, routeKey, route } = input;
-  const viewPath = resolveComponentPath(rootDir, componentDir, view.viewPath);
-  const layoutPaths = view.layouts.map((layout) => resolveComponentPath(rootDir, componentDir, layout));
-  const controllerPath = view.controller ? resolveComponentPath(rootDir, componentDir, view.controller) : null;
-  const layoutControllerPaths = view.layoutControllers?.map(
-    (controller) => controller ? resolveComponentPath(rootDir, componentDir, controller) : null
-  ) ?? [];
-  const imports = [
-    `import { mount } from 'svelte';`,
-    `import NavigationShell from '@noego/wood/navigation-shell';`,
-    `import { getContainer } from '@noego/wood/client';`,
-    `import { getNavigation } from '@noego/wood/navigation';`,
-    `import ViewComponent from '${viteImport(viewPath)}';`,
-    ...layoutPaths.map((layoutPath, index) => `import Layout${index} from '${viteImport(layoutPath)}';`),
-    ...controllerPath ? [`import PageController from '${viteImport(controllerPath)}';`] : [],
-    ...layoutControllerPaths.map(
-      (controllerPath2, index) => controllerPath2 ? `import LayoutController${index} from '${viteImport(controllerPath2)}';` : ""
-    ).filter(Boolean)
-  ];
-  const layoutControllerClasses = layoutControllerPaths.map(
-    (controllerPath2, index) => controllerPath2 ? `LayoutController${index}` : "undefined"
-  );
-  return `${imports.join("\n")}
-
-const entry = {
-  key: ${JSON.stringify(routeKey)},
-  windowName: ${JSON.stringify(view.windowName)},
-  pageName: ${JSON.stringify(view.pageName)},
-  viewPath: ${JSON.stringify(view.viewPath)},
-  layoutPaths: ${JSON.stringify(view.layouts)},
-  layoutControllers: ${JSON.stringify(view.layoutControllers ?? [])},
-  controller: ${JSON.stringify(view.controller)},
-  layoutControllerClasses: [${layoutControllerClasses.join(", ")}],
-  controllerClass: ${controllerPath ? "PageController" : "undefined"},
-  view: ViewComponent,
-  layouts: [${layoutPaths.map((_, index) => `Layout${index}`).join(", ")}],
-};
-
-function createScopedContainer() {
-  const root = getContainer();
-  const scope = root.extend();
-  return scope;
-}
-
-async function resolveController(ControllerClass) {
-  if (!ControllerClass) return undefined;
-  const scope = createScopedContainer();
-  scope.registerClass?.(ControllerClass);
-  return await scope.get(ControllerClass);
-}
-
-async function createViewController(nextEntry) {
-  return await resolveController(nextEntry.controllerClass);
-}
-
-async function createLayoutControllers(nextEntry) {
-  const controllers = [];
-  for (const ControllerClass of nextEntry.layoutControllerClasses) {
-    controllers.push(await resolveController(ControllerClass));
-  }
-  return controllers;
-}
-
-function getViewManifestEntry(nextKey) {
-  return nextKey === entry.key ? entry : null;
-}
-
-const navigation = getNavigation();
-navigation.replace(entry.key, ${JSON.stringify(route.params)}, ${JSON.stringify(route.query)});
-
-const controller = await createViewController(entry);
-const layoutControllers = await createLayoutControllers(entry);
-
-window.__WOOD_BROWSER_APP__ = mount(NavigationShell, {
-  target: document.getElementById('app'),
-  props: {
-    manifest: { [entry.key]: entry },
-    initialEntry: entry,
-    initialController: controller,
-    initialLayoutControllers: layoutControllers,
-    createViewControllerFn: createViewController,
-    createLayoutControllersFn: createLayoutControllers,
-    getViewManifestEntryFn: getViewManifestEntry,
-  },
-});
-`;
-}
 function buildGeneratedAppEntrySource(input) {
   const hasRouteContext = Object.keys(input.route.params).length > 0 || Object.keys(input.route.query).length > 0;
   const rendererTraceEnable = input.enableRendererTrace ? `try {
@@ -638,14 +572,14 @@ function buildGeneratedAppEntrySource(input) {
   traceConfiguration.configureEnabled(true);
 } catch (error) { /* best-effort renderer-trace enable */ }` : "";
   const navigationApply = hasRouteContext ? `getNavigation().replace(${JSON.stringify(input.routeKey)}, ${JSON.stringify(input.route.params)}, ${JSON.stringify(input.route.query)});` : "";
-  return `import { app } from '${viteImport(input.generatedApp)}';
+  return `import * as generated from '${viteImport(input.generatedApp)}';
 import { getNavigation } from '${input.navigationModule}';
 import { getContainer, TraceProviderConfiguration } from '${input.clientModule}';
 window.__WOOD_BROWSER_DEFAULT_ROUTE__ = ${JSON.stringify(input.routeKey)};
-window.__WOOD_BROWSER_APP__ = await app(document.getElementById('app'));
+window.__WOOD_BROWSER_APP__ = await generated.app(document.getElementById('app'), ${JSON.stringify(input.route)});
 window.__WOOD_BROWSER_NAV__ = getNavigation();
 ${rendererTraceEnable}
-${navigationApply}
+if (!generated.supportsInitialRoute) { ${navigationApply} }
 `;
 }
 function buildComponentEntrySource(input) {
@@ -1048,7 +982,7 @@ async function captureCoverage(page, selector) {
     await cdp.detach().catch(() => void 0);
   }
 }
-function createExpect(page, outputDir) {
+function browserAssertions(page, outputDir = import_node_path.default.resolve(".wood-browser-output")) {
   async function waitForVisible(selector) {
     const locator = page.locator(selector).first();
     try {
@@ -1369,19 +1303,7 @@ function createSurface(input) {
     page: input.page,
     bridge: input.bridge,
     navigation: createMountedNavigation(input.page),
-    expect: createExpect(input.page, input.outputDir),
-    locator(selector) {
-      return input.page.locator(selector);
-    },
-    async click(selector) {
-      await input.page.locator(selector).click();
-    },
-    async fill(selector, value) {
-      await input.page.locator(selector).fill(value);
-    },
-    async evaluate(fn) {
-      return await input.page.evaluate(fn);
-    },
+    assertions: browserAssertions(input.page, input.outputDir),
     destroy: input.destroy
   };
 }
@@ -1418,17 +1340,17 @@ async function openMountPage(input) {
     bridge: mountedBridge,
     outputDir: import_node_path.default.join(input.runtime.rootDir, "test-results", "wood-browser"),
     destroy: async () => {
-      await page.evaluate(() => {
-        const app = window.__WOOD_BROWSER_APP__;
-        if (app && typeof app === "object" && typeof app.$destroy === "function") {
-          app.$destroy();
-        }
-      }).catch(() => void 0);
+      if (!page.isClosed()) await page.evaluate(() => window.__WOOD_BROWSER_UNMOUNT__?.());
     }
   });
 }
-async function createHarness(config = {}) {
+async function createBrowserFixture(config = {}) {
   const rootDir = normalizeRoot(config.rootDir);
+  const css = (config.css ?? []).map((cssPath) => {
+    const resolved = resolveFromRoot(rootDir, cssPath);
+    assertFileExists(resolved, "CSS file");
+    return resolved;
+  });
   const browserName = config.browser?.browserName ?? "chromium";
   const headless = config.browser?.headless ?? true;
   const workerRuntime = await acquireBrowserWorkerRuntime({
@@ -1437,7 +1359,7 @@ async function createHarness(config = {}) {
     headless
   });
   let released = false;
-  let destroyed = false;
+  let destroying;
   let tempDir = null;
   let context = null;
   let page = null;
@@ -1476,11 +1398,6 @@ async function createHarness(config = {}) {
     rootDir,
     transportCleanups: []
   };
-  const css = (config.css ?? []).map((cssPath) => {
-    const resolved = resolveFromRoot(rootDir, cssPath);
-    assertFileExists(resolved, "CSS file");
-    return resolved;
-  });
   return {
     page,
     ...traceRecorder ? { traceRecorder } : {},
@@ -1495,12 +1412,20 @@ async function createHarness(config = {}) {
         const viewsPath = resolveFromRoot(rootDir, config.viewsConfig);
         const views = await loadViews(viewsPath);
         const view = findView(views, routeKey);
-        entrySource = buildRouteEntrySource({
+        const generatedApp = import_node_path.default.join(runtime.tempDir, `route-app-${routeKey.replace(/[^a-zA-Z0-9_-]/g, "-")}.ts`);
+        import_node_fs.default.writeFileSync(generatedApp, (0, import_renderer_app_generator.generateRendererApp)([view], {
+          componentDir: config.componentDir ? resolveFromRoot(rootDir, config.componentDir) : rootDir,
+          outDir: runtime.tempDir,
+          entryViewKey: routeKey
+        }));
+        entrySource = buildGeneratedAppEntrySource({
+          generatedApp,
           routeKey,
-          view,
-          rootDir,
-          componentDir: config.componentDir,
-          route
+          route,
+          navigationModule: resolveEsmModule(rootDir, "@noego/wood/navigation"),
+          clientModule: resolveEsmModule(rootDir, "@noego/wood/client"),
+          enableRendererTrace: config.trace?.enabled === true,
+          traceMinLevel: config.trace?.minLevel ?? "debug"
         });
       } else if (config.generatedApp) {
         const generatedApp = resolveFromRoot(rootDir, config.generatedApp);
@@ -1515,7 +1440,7 @@ async function createHarness(config = {}) {
           traceMinLevel: config.trace?.minLevel ?? "debug"
         });
       } else {
-        throw new Error("mountRoute requires either viewsConfig or generatedApp in browser.createHarness().");
+        throw new Error("mountRoute requires either viewsConfig or generatedApp in createBrowserFixture().");
       }
       const mounted = await openMountPage({
         runtime,
@@ -1613,34 +1538,38 @@ async function createHarness(config = {}) {
     async flushRendererTraces() {
       await page.evaluate(() => window.__woodBrowserTraceFlush?.()).catch(() => void 0);
     },
-    async destroy() {
-      if (destroyed) {
-        return;
-      }
-      destroyed = true;
-      for (const cleanup of runtime.transportCleanups.splice(0)) {
-        try {
-          cleanup();
-        } catch {
-        }
-      }
-      await Promise.all([
-        waitForBoundedClose(page.close()),
-        waitForBoundedClose(context.close())
-      ]);
-      traceRecorder?.disable();
-      import_node_fs.default.rmSync(tempDir, { recursive: true, force: true });
-      releaseRuntimeOnce();
+    destroy() {
+      return destroying ?? (destroying = Promise.resolve().then(async () => {
+        const errors = [];
+        const attempt = async (action) => {
+          try {
+            await action();
+          } catch (error) {
+            errors.push(error);
+          }
+        };
+        if (!page.isClosed()) await attempt(() => closeRequired(
+          page.evaluate(() => window.__WOOD_BROWSER_UNMOUNT__?.()),
+          "renderer"
+        ));
+        for (const cleanup of runtime.transportCleanups.splice(0)) await attempt(cleanup);
+        await attempt(() => closeRequired(page.close(), "browser page"));
+        await attempt(() => closeRequired(context.close(), "browser context"));
+        await attempt(() => traceRecorder?.disable());
+        await attempt(() => import_node_fs.default.rmSync(tempDir, { recursive: true, force: true }));
+        releaseRuntimeOnce();
+        if (errors.length) throw Object.assign(new Error("Wood browser cleanup failed: " + errors.map((error) => error instanceof Error ? error.message : String(error)).join("; ")), { errors });
+      }));
     }
   };
 }
-const browser = {
-  createHarness
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  browser,
+  browserAssertions,
   createBrowserBridgeFixture,
+  createBrowserFixture,
+  createWoodBrowserResolver,
+  loadSveltePlugin,
   startSharedBrowserViteServer
 });
 //# sourceMappingURL=browser.cjs.map