@noego/wood 0.6.1 → 0.7.0

package/dist/testing/native_browser/renderer_entry.cjs

@@ -0,0 +1,148 @@
+"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 renderer_entry_exports = {};
+__export(renderer_entry_exports, {
+  nativeRendererEntry: () => nativeRendererEntry
+});
+module.exports = __toCommonJS(renderer_entry_exports);
+var import_node_module = require("node:module");
+var import_node_path = __toESM(require("node:path"), 1);
+function nativeRendererEntry(source) {
+  const operations = [...source.operations];
+  const reflection = (0, import_node_module.createRequire)(import_node_path.default.join(source.configDir, "package.json")).resolve("reflect-metadata");
+  const rendererCompose = source.hookModule(source.config.renderer.compose);
+  const composeImport = rendererCompose ? `import configureRenderer from ${JSON.stringify(rendererCompose)};` : "const configureRenderer = null;";
+  return `import ${JSON.stringify(reflection)};
+import { flushSync, tick, unmount } from 'svelte';
+import { buildTransportBridge } from '@noego/wood/transport';
+import { getContainer, TraceProviderConfiguration, flushRendererLogs } from '@noego/wood/client';
+import * as generated from './app.ts';
+${composeImport}
+
+const route = window.__woodNativeRoute;
+const callbacks = new Map();
+const subscriptionChanges = new Set();
+const requests = new Set();
+let mounted;
+let closing;
+function track(set, task) {
+  const promise = Promise.resolve(task);
+  set.add(promise);
+  promise.then(() => set.delete(promise), () => set.delete(promise));
+  return promise;
+}
+async function subscriptionsReady() {
+  while (subscriptionChanges.size) await Promise.all([...subscriptionChanges]);
+}
+const transport = {
+  invoke(channel, payload) {
+    return track(requests, (async () => {
+      await subscriptionsReady();
+      return window.__woodNativeInvoke(channel, payload === undefined ? {} : payload);
+    })());
+  },
+  subscribe(channel, callback) {
+    let listeners = callbacks.get(channel);
+    if (!listeners) {
+      listeners = new Set();
+      callbacks.set(channel, listeners);
+      track(subscriptionChanges, window.__woodNativeSubscribe(channel, true));
+    }
+    listeners.add(callback);
+    return () => {
+      listeners.delete(callback);
+      if (listeners.size === 0) {
+        callbacks.delete(channel);
+        track(subscriptionChanges, window.__woodNativeSubscribe(channel, false));
+      }
+    };
+  },
+};
+window.__woodNativeEmit = (channel, payload) => {
+  for (const callback of callbacks.get(channel) ?? []) callback(payload);
+};
+const bridge = buildTransportBridge(new Map(${JSON.stringify(operations)}), transport).bridge;
+bridge.__window = { current: async () => ({ok: true, windowId: route.page.split('.')[0], defaultRoute: route.page}) };
+bridge.__woodConfig = async () => ({trace: {enabled: true, minLevel: 'debug'}});
+bridge.__trace = payload => track(requests, window.__woodNativeTrace(payload));
+// These are preload infrastructure channels, never product operation replacements.
+bridge.__logBatch = batch => track(requests, window.__woodNativeLog(batch));
+window.__NOEGO_WOOD_BRIDGE__ = bridge;
+
+window.__woodNativeFlush = async () => {
+  await tick();
+  flushSync();
+  await subscriptionsReady();
+  flushRendererLogs();
+  while (requests.size) await Promise.all([...requests]);
+  await tick();
+  flushSync();
+};
+window.__woodNativeDispose = () => closing ??= (async () => {
+  const errors = [];
+  const attempt = async fn => {try {await fn();} catch (error) {errors.push(error);}};
+  await attempt(() => mounted?.disposeNavigation?.());
+  await attempt(() => mounted && unmount(mounted));
+  await attempt(() => window.__woodNativeFlush());
+  await attempt(() => getContainer().dispose());
+  callbacks.clear();
+  if (errors.length) {
+    const describe = (error, depth = 0) => {
+      const message = error?.message ?? String(error);
+      const nested = error?.errors ?? error?.failures?.map(failure => failure.error);
+      return depth < 4 && Array.isArray(nested)
+        ? message + ': ' + nested.map(value => describe(value, depth + 1)).join('; ')
+        : message;
+    };
+    throw new AggregateError(errors, 'Native Wood renderer teardown failed: ' + errors.map(error => describe(error)).join('; '));
+  }
+})();
+window.__woodNativeReady = (async () => {
+  const container = getContainer();
+  if (configureRenderer) await configureRenderer(container);
+  const config = await container.get(TraceProviderConfiguration);
+  config.configureRuntime('renderer');
+  config.configureEnabled(true);
+  config.configureMinLevel('debug');
+  mounted = await generated.app(document.getElementById('app'), {params: route.params, query: route.query});
+  await tick();
+  flushSync();
+  // Subscribe before open() resolves: do not invent event replay to hide a race.
+  await subscriptionsReady();
+})();
+// A host always awaits readiness. Attach a handler now so an immediate mount
+// failure cannot become an unhandled rejection before the host reads it.
+window.__woodNativeReady.catch(() => {});
+`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  nativeRendererEntry
+});
+//# sourceMappingURL=renderer_entry.cjs.map

package/dist/testing/native_browser/renderer_entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/native_browser/renderer_entry.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport path from 'node:path';\nimport type { WoodConfigSource } from '../wood_config_source.js';\n\n/**\n * Identical renderer bootstrap for Chromium and happy-dom's isolated VM realm.\n * Production codegen owns controllers, layouts, data loaders and navigation.\n * Only the host transport differs. No components or Node globals are faked.\n */\nexport function nativeRendererEntry(source: WoodConfigSource): string {\n  const operations = [...source.operations];\n  const reflection = createRequire(path.join(source.configDir, 'package.json')).resolve('reflect-metadata');\n  const rendererCompose = source.hookModule(source.config.renderer.compose);\n  const composeImport = rendererCompose\n    ? `import configureRenderer from ${JSON.stringify(rendererCompose)};`\n    : 'const configureRenderer = null;';\n  return `import ${JSON.stringify(reflection)};\nimport { flushSync, tick, unmount } from 'svelte';\nimport { buildTransportBridge } from '@noego/wood/transport';\nimport { getContainer, TraceProviderConfiguration, flushRendererLogs } from '@noego/wood/client';\nimport * as generated from './app.ts';\n${composeImport}\n\nconst route = window.__woodNativeRoute;\nconst callbacks = new Map();\nconst subscriptionChanges = new Set();\nconst requests = new Set();\nlet mounted;\nlet closing;\nfunction track(set, task) {\n  const promise = Promise.resolve(task);\n  set.add(promise);\n  promise.then(() => set.delete(promise), () => set.delete(promise));\n  return promise;\n}\nasync function subscriptionsReady() {\n  while (subscriptionChanges.size) await Promise.all([...subscriptionChanges]);\n}\nconst transport = {\n  invoke(channel, payload) {\n    return track(requests, (async () => {\n      await subscriptionsReady();\n      return window.__woodNativeInvoke(channel, payload === undefined ? {} : payload);\n    })());\n  },\n  subscribe(channel, callback) {\n    let listeners = callbacks.get(channel);\n    if (!listeners) {\n      listeners = new Set();\n      callbacks.set(channel, listeners);\n      track(subscriptionChanges, window.__woodNativeSubscribe(channel, true));\n    }\n    listeners.add(callback);\n    return () => {\n      listeners.delete(callback);\n      if (listeners.size === 0) {\n        callbacks.delete(channel);\n        track(subscriptionChanges, window.__woodNativeSubscribe(channel, false));\n      }\n    };\n  },\n};\nwindow.__woodNativeEmit = (channel, payload) => {\n  for (const callback of callbacks.get(channel) ?? []) callback(payload);\n};\nconst bridge = buildTransportBridge(new Map(${JSON.stringify(operations)}), transport).bridge;\nbridge.__window = { current: async () => ({ok: true, windowId: route.page.split('.')[0], defaultRoute: route.page}) };\nbridge.__woodConfig = async () => ({trace: {enabled: true, minLevel: 'debug'}});\nbridge.__trace = payload => track(requests, window.__woodNativeTrace(payload));\n// These are preload infrastructure channels, never product operation replacements.\nbridge.__logBatch = batch => track(requests, window.__woodNativeLog(batch));\nwindow.__NOEGO_WOOD_BRIDGE__ = bridge;\n\nwindow.__woodNativeFlush = async () => {\n  await tick();\n  flushSync();\n  await subscriptionsReady();\n  flushRendererLogs();\n  while (requests.size) await Promise.all([...requests]);\n  await tick();\n  flushSync();\n};\nwindow.__woodNativeDispose = () => closing ??= (async () => {\n  const errors = [];\n  const attempt = async fn => {try {await fn();} catch (error) {errors.push(error);}};\n  await attempt(() => mounted?.disposeNavigation?.());\n  await attempt(() => mounted && unmount(mounted));\n  await attempt(() => window.__woodNativeFlush());\n  await attempt(() => getContainer().dispose());\n  callbacks.clear();\n  if (errors.length) {\n    const describe = (error, depth = 0) => {\n      const message = error?.message ?? String(error);\n      const nested = error?.errors ?? error?.failures?.map(failure => failure.error);\n      return depth < 4 && Array.isArray(nested)\n        ? message + ': ' + nested.map(value => describe(value, depth + 1)).join('; ')\n        : message;\n    };\n    throw new AggregateError(errors, 'Native Wood renderer teardown failed: ' + errors.map(error => describe(error)).join('; '));\n  }\n})();\nwindow.__woodNativeReady = (async () => {\n  const container = getContainer();\n  if (configureRenderer) await configureRenderer(container);\n  const config = await container.get(TraceProviderConfiguration);\n  config.configureRuntime('renderer');\n  config.configureEnabled(true);\n  config.configureMinLevel('debug');\n  mounted = await generated.app(document.getElementById('app'), {params: route.params, query: route.query});\n  await tick();\n  flushSync();\n  // Subscribe before open() resolves: do not invent event replay to hide a race.\n  await subscriptionsReady();\n})();\n// A host always awaits readiness. Attach a handler now so an immediate mount\n// failure cannot become an unhandled rejection before the host reads it.\nwindow.__woodNativeReady.catch(() => {});\n`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA8B;AAC9B,uBAAiB;AAQV,SAAS,oBAAoB,QAAkC;AACpE,QAAM,aAAa,CAAC,GAAG,OAAO,UAAU;AACxC,QAAM,iBAAa,kCAAc,iBAAAA,QAAK,KAAK,OAAO,WAAW,cAAc,CAAC,EAAE,QAAQ,kBAAkB;AACxG,QAAM,kBAAkB,OAAO,WAAW,OAAO,OAAO,SAAS,OAAO;AACxE,QAAM,gBAAgB,kBAClB,iCAAiC,KAAK,UAAU,eAAe,CAAC,MAChE;AACJ,SAAO,UAAU,KAAK,UAAU,UAAU,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAK3C,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8CA4C+B,KAAK,UAAU,UAAU,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqDxE;","names":["path"]}

package/dist/testing/native_browser/renderer_entry.d.cts

@@ -0,0 +1,13 @@
+import { WoodConfigSource } from '../wood_config_source.cjs';
+import '../../types/config.cjs';
+import '../../types/operations.cjs';
+import '../../types/views.cjs';
+
+/**
+ * Identical renderer bootstrap for Chromium and happy-dom's isolated VM realm.
+ * Production codegen owns controllers, layouts, data loaders and navigation.
+ * Only the host transport differs. No components or Node globals are faked.
+ */
+declare function nativeRendererEntry(source: WoodConfigSource): string;
+
+export { nativeRendererEntry };

package/dist/testing/native_browser/renderer_entry.d.ts

@@ -0,0 +1,13 @@
+import { WoodConfigSource } from '../wood_config_source.js';
+import '../../types/config.js';
+import '../../types/operations.js';
+import '../../types/views.js';
+
+/**
+ * Identical renderer bootstrap for Chromium and happy-dom's isolated VM realm.
+ * Production codegen owns controllers, layouts, data loaders and navigation.
+ * Only the host transport differs. No components or Node globals are faked.
+ */
+declare function nativeRendererEntry(source: WoodConfigSource): string;
+
+export { nativeRendererEntry };

package/dist/testing/native_browser/renderer_entry.js

@@ -0,0 +1,114 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+function nativeRendererEntry(source) {
+  const operations = [...source.operations];
+  const reflection = createRequire(path.join(source.configDir, "package.json")).resolve("reflect-metadata");
+  const rendererCompose = source.hookModule(source.config.renderer.compose);
+  const composeImport = rendererCompose ? `import configureRenderer from ${JSON.stringify(rendererCompose)};` : "const configureRenderer = null;";
+  return `import ${JSON.stringify(reflection)};
+import { flushSync, tick, unmount } from 'svelte';
+import { buildTransportBridge } from '@noego/wood/transport';
+import { getContainer, TraceProviderConfiguration, flushRendererLogs } from '@noego/wood/client';
+import * as generated from './app.ts';
+${composeImport}
+
+const route = window.__woodNativeRoute;
+const callbacks = new Map();
+const subscriptionChanges = new Set();
+const requests = new Set();
+let mounted;
+let closing;
+function track(set, task) {
+  const promise = Promise.resolve(task);
+  set.add(promise);
+  promise.then(() => set.delete(promise), () => set.delete(promise));
+  return promise;
+}
+async function subscriptionsReady() {
+  while (subscriptionChanges.size) await Promise.all([...subscriptionChanges]);
+}
+const transport = {
+  invoke(channel, payload) {
+    return track(requests, (async () => {
+      await subscriptionsReady();
+      return window.__woodNativeInvoke(channel, payload === undefined ? {} : payload);
+    })());
+  },
+  subscribe(channel, callback) {
+    let listeners = callbacks.get(channel);
+    if (!listeners) {
+      listeners = new Set();
+      callbacks.set(channel, listeners);
+      track(subscriptionChanges, window.__woodNativeSubscribe(channel, true));
+    }
+    listeners.add(callback);
+    return () => {
+      listeners.delete(callback);
+      if (listeners.size === 0) {
+        callbacks.delete(channel);
+        track(subscriptionChanges, window.__woodNativeSubscribe(channel, false));
+      }
+    };
+  },
+};
+window.__woodNativeEmit = (channel, payload) => {
+  for (const callback of callbacks.get(channel) ?? []) callback(payload);
+};
+const bridge = buildTransportBridge(new Map(${JSON.stringify(operations)}), transport).bridge;
+bridge.__window = { current: async () => ({ok: true, windowId: route.page.split('.')[0], defaultRoute: route.page}) };
+bridge.__woodConfig = async () => ({trace: {enabled: true, minLevel: 'debug'}});
+bridge.__trace = payload => track(requests, window.__woodNativeTrace(payload));
+// These are preload infrastructure channels, never product operation replacements.
+bridge.__logBatch = batch => track(requests, window.__woodNativeLog(batch));
+window.__NOEGO_WOOD_BRIDGE__ = bridge;
+
+window.__woodNativeFlush = async () => {
+  await tick();
+  flushSync();
+  await subscriptionsReady();
+  flushRendererLogs();
+  while (requests.size) await Promise.all([...requests]);
+  await tick();
+  flushSync();
+};
+window.__woodNativeDispose = () => closing ??= (async () => {
+  const errors = [];
+  const attempt = async fn => {try {await fn();} catch (error) {errors.push(error);}};
+  await attempt(() => mounted?.disposeNavigation?.());
+  await attempt(() => mounted && unmount(mounted));
+  await attempt(() => window.__woodNativeFlush());
+  await attempt(() => getContainer().dispose());
+  callbacks.clear();
+  if (errors.length) {
+    const describe = (error, depth = 0) => {
+      const message = error?.message ?? String(error);
+      const nested = error?.errors ?? error?.failures?.map(failure => failure.error);
+      return depth < 4 && Array.isArray(nested)
+        ? message + ': ' + nested.map(value => describe(value, depth + 1)).join('; ')
+        : message;
+    };
+    throw new AggregateError(errors, 'Native Wood renderer teardown failed: ' + errors.map(error => describe(error)).join('; '));
+  }
+})();
+window.__woodNativeReady = (async () => {
+  const container = getContainer();
+  if (configureRenderer) await configureRenderer(container);
+  const config = await container.get(TraceProviderConfiguration);
+  config.configureRuntime('renderer');
+  config.configureEnabled(true);
+  config.configureMinLevel('debug');
+  mounted = await generated.app(document.getElementById('app'), {params: route.params, query: route.query});
+  await tick();
+  flushSync();
+  // Subscribe before open() resolves: do not invent event replay to hide a race.
+  await subscriptionsReady();
+})();
+// A host always awaits readiness. Attach a handler now so an immediate mount
+// failure cannot become an unhandled rejection before the host reads it.
+window.__woodNativeReady.catch(() => {});
+`;
+}
+export {
+  nativeRendererEntry
+};
+//# sourceMappingURL=renderer_entry.js.map

package/dist/testing/native_browser/renderer_entry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/native_browser/renderer_entry.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport path from 'node:path';\nimport type { WoodConfigSource } from '../wood_config_source.js';\n\n/**\n * Identical renderer bootstrap for Chromium and happy-dom's isolated VM realm.\n * Production codegen owns controllers, layouts, data loaders and navigation.\n * Only the host transport differs. No components or Node globals are faked.\n */\nexport function nativeRendererEntry(source: WoodConfigSource): string {\n  const operations = [...source.operations];\n  const reflection = createRequire(path.join(source.configDir, 'package.json')).resolve('reflect-metadata');\n  const rendererCompose = source.hookModule(source.config.renderer.compose);\n  const composeImport = rendererCompose\n    ? `import configureRenderer from ${JSON.stringify(rendererCompose)};`\n    : 'const configureRenderer = null;';\n  return `import ${JSON.stringify(reflection)};\nimport { flushSync, tick, unmount } from 'svelte';\nimport { buildTransportBridge } from '@noego/wood/transport';\nimport { getContainer, TraceProviderConfiguration, flushRendererLogs } from '@noego/wood/client';\nimport * as generated from './app.ts';\n${composeImport}\n\nconst route = window.__woodNativeRoute;\nconst callbacks = new Map();\nconst subscriptionChanges = new Set();\nconst requests = new Set();\nlet mounted;\nlet closing;\nfunction track(set, task) {\n  const promise = Promise.resolve(task);\n  set.add(promise);\n  promise.then(() => set.delete(promise), () => set.delete(promise));\n  return promise;\n}\nasync function subscriptionsReady() {\n  while (subscriptionChanges.size) await Promise.all([...subscriptionChanges]);\n}\nconst transport = {\n  invoke(channel, payload) {\n    return track(requests, (async () => {\n      await subscriptionsReady();\n      return window.__woodNativeInvoke(channel, payload === undefined ? {} : payload);\n    })());\n  },\n  subscribe(channel, callback) {\n    let listeners = callbacks.get(channel);\n    if (!listeners) {\n      listeners = new Set();\n      callbacks.set(channel, listeners);\n      track(subscriptionChanges, window.__woodNativeSubscribe(channel, true));\n    }\n    listeners.add(callback);\n    return () => {\n      listeners.delete(callback);\n      if (listeners.size === 0) {\n        callbacks.delete(channel);\n        track(subscriptionChanges, window.__woodNativeSubscribe(channel, false));\n      }\n    };\n  },\n};\nwindow.__woodNativeEmit = (channel, payload) => {\n  for (const callback of callbacks.get(channel) ?? []) callback(payload);\n};\nconst bridge = buildTransportBridge(new Map(${JSON.stringify(operations)}), transport).bridge;\nbridge.__window = { current: async () => ({ok: true, windowId: route.page.split('.')[0], defaultRoute: route.page}) };\nbridge.__woodConfig = async () => ({trace: {enabled: true, minLevel: 'debug'}});\nbridge.__trace = payload => track(requests, window.__woodNativeTrace(payload));\n// These are preload infrastructure channels, never product operation replacements.\nbridge.__logBatch = batch => track(requests, window.__woodNativeLog(batch));\nwindow.__NOEGO_WOOD_BRIDGE__ = bridge;\n\nwindow.__woodNativeFlush = async () => {\n  await tick();\n  flushSync();\n  await subscriptionsReady();\n  flushRendererLogs();\n  while (requests.size) await Promise.all([...requests]);\n  await tick();\n  flushSync();\n};\nwindow.__woodNativeDispose = () => closing ??= (async () => {\n  const errors = [];\n  const attempt = async fn => {try {await fn();} catch (error) {errors.push(error);}};\n  await attempt(() => mounted?.disposeNavigation?.());\n  await attempt(() => mounted && unmount(mounted));\n  await attempt(() => window.__woodNativeFlush());\n  await attempt(() => getContainer().dispose());\n  callbacks.clear();\n  if (errors.length) {\n    const describe = (error, depth = 0) => {\n      const message = error?.message ?? String(error);\n      const nested = error?.errors ?? error?.failures?.map(failure => failure.error);\n      return depth < 4 && Array.isArray(nested)\n        ? message + ': ' + nested.map(value => describe(value, depth + 1)).join('; ')\n        : message;\n    };\n    throw new AggregateError(errors, 'Native Wood renderer teardown failed: ' + errors.map(error => describe(error)).join('; '));\n  }\n})();\nwindow.__woodNativeReady = (async () => {\n  const container = getContainer();\n  if (configureRenderer) await configureRenderer(container);\n  const config = await container.get(TraceProviderConfiguration);\n  config.configureRuntime('renderer');\n  config.configureEnabled(true);\n  config.configureMinLevel('debug');\n  mounted = await generated.app(document.getElementById('app'), {params: route.params, query: route.query});\n  await tick();\n  flushSync();\n  // Subscribe before open() resolves: do not invent event replay to hide a race.\n  await subscriptionsReady();\n})();\n// A host always awaits readiness. Attach a handler now so an immediate mount\n// failure cannot become an unhandled rejection before the host reads it.\nwindow.__woodNativeReady.catch(() => {});\n`;\n}\n"],"mappings":"AAAA,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AAQV,SAAS,oBAAoB,QAAkC;AACpE,QAAM,aAAa,CAAC,GAAG,OAAO,UAAU;AACxC,QAAM,aAAa,cAAc,KAAK,KAAK,OAAO,WAAW,cAAc,CAAC,EAAE,QAAQ,kBAAkB;AACxG,QAAM,kBAAkB,OAAO,WAAW,OAAO,OAAO,SAAS,OAAO;AACxE,QAAM,gBAAgB,kBAClB,iCAAiC,KAAK,UAAU,eAAe,CAAC,MAChE;AACJ,SAAO,UAAU,KAAK,UAAU,UAAU,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAK3C,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8CA4C+B,KAAK,UAAU,UAAU,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqDxE;","names":[]}

package/dist/testing/registration_only_root.cjs

@@ -18,14 +18,34 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var registration_only_root_exports = {};
 __export(registration_only_root_exports, {
+  APPLICATION_TEST_MARK: () => APPLICATION_TEST_MARK,
   RegistrationOnlyRoot: () => RegistrationOnlyRoot,
   TestWoodCleanupError: () => TestWoodCleanupError,
   buildRecordedEnvironment: () => buildRecordedEnvironment,
   cleanupAll: () => cleanupAll
 });
 module.exports = __toCommonJS(registration_only_root_exports);
+var import_ioc = require("@noego/ioc");
 var import_get_container = require("../runtime/get_container.js");
 var import_test_wood = require("./test_wood.cjs");
+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 import_ioc.LoadAs.Singleton:
+      return "singleton";
+    case import_ioc.LoadAs.Scoped:
+      return "scoped";
+    case import_ioc.LoadAs.Transient:
+      return "transient";
+    default:
+      return void 0;
+  }
+}
 function errorMessage(error) {
   const message = error instanceof Error ? error.message : String(error);
   const nested = error?.failures;
@@ -54,12 +74,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 = (0, import_get_container.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) {
@@ -67,6 +99,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);
           };
         }
@@ -74,9 +108,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);
           };
         }
@@ -114,6 +149,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 import_test_wood.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 (0, import_ioc.defineModule)(`@noego/wood/testing/${this.hookName}`, (bind) => {
+      for (const declaration of declarations) declaration(bind);
+    });
+  }
   replay(root) {
     if (this.replayed) throw new import_test_wood.TestWoodError(`${this.hookName} registrations were already replayed`);
     this.replayed = true;
@@ -131,11 +185,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);
@@ -160,6 +215,7 @@ async function buildRecordedEnvironment(builder, recorded, owner) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  APPLICATION_TEST_MARK,
   RegistrationOnlyRoot,
   TestWoodCleanupError,
   buildRecordedEnvironment,

package/dist/testing/registration_only_root.cjs.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.cjs';\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.cjs';\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/registration_only_root.d.cts

@@ -1,7 +1,9 @@
-import { IContainer } from '@noego/ioc';
+import { IContainer, Lifetime, ApplicationModule } from '@noego/ioc';
 import { TestIocBuilder, TestEnvironment } from '@noego/testing';
 import { TestWoodError } from './test_wood.cjs';
 
+/** Shared application-test marker (same symbol `@noego/app` registers). */
+declare const APPLICATION_TEST_MARK: unique symbol;
 interface CleanupFailure {
     readonly owner: string;
     readonly error: unknown;
@@ -31,8 +33,27 @@ declare class RegistrationOnlyRoot {
     readonly actualRoot: IContainer;
     private target;
     private replayed;
-    constructor(hookName: string);
+    /** Every production registration as a declarative binding (the shared overlay catalog input). */
+    private readonly declarations;
+    /**
+     * @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: string, applicationTest: string);
     declare(token: unknown): void;
+    /**
+     * 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: unknown, lifetime: Lifetime): void;
+    /** The recorded production registrations as a declarative module (description only, never built). */
+    module(): ApplicationModule;
     replay(root: IContainer): void;
     bind(root: IContainer): void;
     private assertRecording;
@@ -41,6 +62,6 @@ declare class RegistrationOnlyRoot {
  * Materialize shared @noego/testing overlays on the same production root,
  * disposing the partially built root if materialization fails.
  */
-declare function buildRecordedEnvironment(builder: TestIocBuilder, recorded: RegistrationOnlyRoot, owner: string): Promise<TestEnvironment>;
+declare function buildRecordedEnvironment(builder: TestIocBuilder, recorded: RegistrationOnlyRoot, owner: string, borrowedTokens?: readonly unknown[]): Promise<TestEnvironment>;
 
-export { type CleanupFailure, RegistrationOnlyRoot, TestWoodCleanupError, buildRecordedEnvironment, cleanupAll };
+export { APPLICATION_TEST_MARK, type CleanupFailure, RegistrationOnlyRoot, TestWoodCleanupError, buildRecordedEnvironment, cleanupAll };

package/dist/testing/registration_only_root.d.ts

@@ -1,7 +1,9 @@
-import { IContainer } from '@noego/ioc';
+import { IContainer, Lifetime, ApplicationModule } from '@noego/ioc';
 import { TestIocBuilder, TestEnvironment } from '@noego/testing';
 import { TestWoodError } from './test_wood.js';
 
+/** Shared application-test marker (same symbol `@noego/app` registers). */
+declare const APPLICATION_TEST_MARK: unique symbol;
 interface CleanupFailure {
     readonly owner: string;
     readonly error: unknown;
@@ -31,8 +33,27 @@ declare class RegistrationOnlyRoot {
     readonly actualRoot: IContainer;
     private target;
     private replayed;
-    constructor(hookName: string);
+    /** Every production registration as a declarative binding (the shared overlay catalog input). */
+    private readonly declarations;
+    /**
+     * @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: string, applicationTest: string);
     declare(token: unknown): void;
+    /**
+     * 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: unknown, lifetime: Lifetime): void;
+    /** The recorded production registrations as a declarative module (description only, never built). */
+    module(): ApplicationModule;
     replay(root: IContainer): void;
     bind(root: IContainer): void;
     private assertRecording;
@@ -41,6 +62,6 @@ declare class RegistrationOnlyRoot {
  * Materialize shared @noego/testing overlays on the same production root,
  * disposing the partially built root if materialization fails.
  */
-declare function buildRecordedEnvironment(builder: TestIocBuilder, recorded: RegistrationOnlyRoot, owner: string): Promise<TestEnvironment>;
+declare function buildRecordedEnvironment(builder: TestIocBuilder, recorded: RegistrationOnlyRoot, owner: string, borrowedTokens?: readonly unknown[]): Promise<TestEnvironment>;
 
-export { type CleanupFailure, RegistrationOnlyRoot, TestWoodCleanupError, buildRecordedEnvironment, cleanupAll };
+export { APPLICATION_TEST_MARK, type CleanupFailure, RegistrationOnlyRoot, TestWoodCleanupError, buildRecordedEnvironment, cleanupAll };