@noego/wood 0.6.2 → 0.7.1

package/dist/testing/wood_lazy_runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/wood_lazy_runtime.ts"],"sourcesContent":["/**\n * Lazy, once-only runtime stages for `testWood(configPath)` environments.\n *\n * `build()` records registrations and installs overlays; the managed router,\n * `compose.start()` and the renderer tier are only initialized on the first\n * explicit use. Concurrent first uses share one initialization; a failed\n * initialization rolls the environment back (through the supplied rollback)\n * and every later use observes the same failure.\n */\nimport { TestWoodError } from './test_wood.js';\n\n/** A value that is initialized on first `acquire()` and readable once live. */\nexport interface LazyValue<T> {\n  readonly current: T | null;\n  acquire(): Promise<T>;\n}\n\nexport class LazyRuntimeStage<T> implements LazyValue<T> {\n  private pending: Promise<T> | null = null;\n  /** The bare `init()` attempt, settled (never rejecting) — excludes rollback. */\n  private attempt: Promise<void> | null = null;\n  private value: T | null = null;\n\n  constructor(\n    private readonly init: () => Promise<T>,\n    private readonly rollback: (error: unknown) => Promise<never>,\n  ) {}\n\n  /** The initialized value, or null while this stage has not been used yet. */\n  get current(): T | null {\n    return this.value;\n  }\n\n  /** True once initialization has been requested (whether or not it finished). */\n  get requested(): boolean {\n    return this.pending !== null;\n  }\n\n  /** Initialize exactly once; concurrent callers share the same promise. */\n  acquire(): Promise<T> {\n    if (!this.pending) {\n      const attempt = this.init();\n      this.attempt = attempt.then(() => undefined, () => undefined);\n      this.pending = attempt.then(\n        (value) => {\n          this.value = value;\n          return value;\n        },\n        (error) => this.rollback(error),\n      );\n    }\n    return this.pending;\n  }\n\n  /**\n   * Resolves once an in-flight initialization attempt has finished (either\n   * way); immediately when none was requested. Deliberately excludes the\n   * rollback so a disposer invoked *by* the rollback never waits on itself.\n   */\n  settled(): Promise<void> {\n    return this.attempt ?? Promise.resolve();\n  }\n\n  /** A derived view over one member of the initialized value. */\n  map<U>(project: (value: T) => U): LazyValue<U> {\n    const stage = this;\n    return {\n      get current() {\n        return stage.value === null ? null : project(stage.value);\n      },\n      acquire: async () => project(await stage.acquire()),\n    };\n  }\n}\n\n/**\n * A member whose runtime is initialized on first use. Async methods listed in\n * `asyncMethods` initialize the runtime and then delegate; every other member\n * delegates once initialized and fails with guidance before that.\n */\nexport function lazyMember<T extends object>(\n  label: string,\n  value: LazyValue<T>,\n  asyncMethods: ReadonlyArray<keyof T & string>,\n  hint: string,\n): T {\n  const isAsync = (property: PropertyKey): property is keyof T & string =>\n    typeof property === 'string' && asyncMethods.includes(property as keyof T & string);\n  return new Proxy({} as T, {\n    get(_target, property) {\n      const live = value.current;\n      if (live) {\n        const member = Reflect.get(live as object, property, live);\n        return typeof member === 'function' ? member.bind(live) : member;\n      }\n      if (isAsync(property)) {\n        return async (...args: unknown[]): Promise<unknown> => {\n          const initialized = await value.acquire();\n          const method = Reflect.get(initialized as object, property, initialized) as (...a: unknown[]) => unknown;\n          return method.apply(initialized, args);\n        };\n      }\n      // Promise resolution and inspection probe these; never treat them as use.\n      if (typeof property === 'symbol' || property === 'then' || property === 'constructor') return undefined;\n      throw new TestWoodError(\n        `${label}.${property} is not available before the runtime is initialized; ${hint}`,\n      );\n    },\n    has(_target, property) {\n      const live = value.current;\n      return live ? property in (live as object) : isAsync(property);\n    },\n  });\n}\n"],"mappings":"AASA,SAAS,qBAAqB;AAQvB,MAAM,iBAA4C;AAAA,EAMvD,YACmB,MACA,UACjB;AAFiB;AACA;AAPnB,SAAQ,UAA6B;AAErC;AAAA,SAAQ,UAAgC;AACxC,SAAQ,QAAkB;AAAA,EAKvB;AAAA;AAAA,EAGH,IAAI,UAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,YAAqB;AACvB,WAAO,KAAK,YAAY;AAAA,EAC1B;AAAA;AAAA,EAGA,UAAsB;AACpB,QAAI,CAAC,KAAK,SAAS;AACjB,YAAM,UAAU,KAAK,KAAK;AAC1B,WAAK,UAAU,QAAQ,KAAK,MAAM,QAAW,MAAM,MAAS;AAC5D,WAAK,UAAU,QAAQ;AAAA,QACrB,CAAC,UAAU;AACT,eAAK,QAAQ;AACb,iBAAO;AAAA,QACT;AAAA,QACA,CAAC,UAAU,KAAK,SAAS,KAAK;AAAA,MAChC;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,UAAyB;AACvB,WAAO,KAAK,WAAW,QAAQ,QAAQ;AAAA,EACzC;AAAA;AAAA,EAGA,IAAO,SAAwC;AAC7C,UAAM,QAAQ;AACd,WAAO;AAAA,MACL,IAAI,UAAU;AACZ,eAAO,MAAM,UAAU,OAAO,OAAO,QAAQ,MAAM,KAAK;AAAA,MAC1D;AAAA,MACA,SAAS,YAAY,QAAQ,MAAM,MAAM,QAAQ,CAAC;AAAA,IACpD;AAAA,EACF;AACF;AAOO,SAAS,WACd,OACA,OACA,cACA,MACG;AACH,QAAM,UAAU,CAAC,aACf,OAAO,aAAa,YAAY,aAAa,SAAS,QAA4B;AACpF,SAAO,IAAI,MAAM,CAAC,GAAQ;AAAA,IACxB,IAAI,SAAS,UAAU;AACrB,YAAM,OAAO,MAAM;AACnB,UAAI,MAAM;AACR,cAAM,SAAS,QAAQ,IAAI,MAAgB,UAAU,IAAI;AACzD,eAAO,OAAO,WAAW,aAAa,OAAO,KAAK,IAAI,IAAI;AAAA,MAC5D;AACA,UAAI,QAAQ,QAAQ,GAAG;AACrB,eAAO,UAAU,SAAsC;AACrD,gBAAM,cAAc,MAAM,MAAM,QAAQ;AACxC,gBAAM,SAAS,QAAQ,IAAI,aAAuB,UAAU,WAAW;AACvE,iBAAO,OAAO,MAAM,aAAa,IAAI;AAAA,QACvC;AAAA,MACF;AAEA,UAAI,OAAO,aAAa,YAAY,aAAa,UAAU,aAAa,cAAe,QAAO;AAC9F,YAAM,IAAI;AAAA,QACR,GAAG,KAAK,IAAI,QAAQ,wDAAwD,IAAI;AAAA,MAClF;AAAA,IACF;AAAA,IACA,IAAI,SAAS,UAAU;AACrB,YAAM,OAAO,MAAM;AACnB,aAAO,OAAO,YAAa,OAAkB,QAAQ,QAAQ;AAAA,IAC/D;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/testing/wood_test_selection.cjs

@@ -18,77 +18,56 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var wood_test_selection_exports = {};
 __export(wood_test_selection_exports, {
+  DECLARED_OWNERS: () => DECLARED_OWNERS,
+  hasRendererTier: () => hasRendererTier,
   resolveSelection: () => resolveSelection,
-  selectCatalog: () => selectCatalog,
-  selectOperations: () => selectOperations
+  selectOperations: () => selectOperations,
+  selectRendererCatalog: () => selectRendererCatalog,
+  selectViews: () => selectViews
 });
 module.exports = __toCommonJS(wood_test_selection_exports);
+var import_testing = require("@noego/testing");
 var import_page_catalog = require("../frontend/page_catalog.js");
 var import_test_wood = require("./test_wood.cjs");
-const DOM_MODES = ["happy-dom", "chromium"];
-function isMainSelection(value) {
-  if (value === true) return true;
-  if (!value || typeof value !== "object") return false;
-  const candidate = value;
-  const hasOperation = typeof candidate.operation === "string" && candidate.operation.length > 0;
-  const hasModule = typeof candidate.module === "string" && candidate.module.length > 0;
-  return hasOperation !== hasModule;
-}
-function isPagesSelection(value) {
-  if (value === true) return true;
-  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "string" && entry.length > 0);
+function hasRendererTier(selection) {
+  return selection.renderer !== null;
 }
+const DECLARED_OWNERS = Object.freeze(["main", "renderer"]);
 function resolveSelection(selection) {
-  if (!selection || typeof selection !== "object") {
-    throw new import_test_wood.TestWoodError("select() requires { main }, { pages }, or both (plus optional dom)");
-  }
-  const { main, pages, dom } = selection;
-  if (main !== void 0 && !isMainSelection(main)) {
-    throw new import_test_wood.TestWoodError("select({ main }) must be true, { operation: string } or { module: string }");
-  }
-  if (pages !== void 0 && !isPagesSelection(pages)) {
-    throw new import_test_wood.TestWoodError("select({ pages }) must be true or a non-empty list of page identities");
-  }
-  if (dom !== void 0 && !DOM_MODES.includes(dom)) {
-    throw new import_test_wood.TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(", ")}`);
-  }
-  if (dom !== void 0 && pages === void 0) {
-    throw new import_test_wood.TestWoodError("select({ dom }) requires { pages }: a component needs a page to mount");
+  if (!selection || typeof selection !== "object" || Array.isArray(selection)) {
+    throw new import_test_wood.TestWoodError("select() requires { main } and/or { renderer }");
   }
-  if (main === void 0 && pages === void 0) {
-    throw new import_test_wood.TestWoodError("select() built nothing: add { main } and/or { pages }");
+  const normalized = (0, import_testing.normalizeTestSelection)(selection, DECLARED_OWNERS);
+  if (normalized.main === void 0 && normalized.renderer === void 0) {
+    throw new import_test_wood.TestWoodError("select() built nothing: add { main } and/or { renderer }");
   }
-  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };
-}
-function operationIdentities(operations) {
-  if (!operations.size) return "the config defines no operations";
-  return `available operations:
-  ${[...operations.keys()].join("\n  ")}`;
+  return Object.freeze({
+    main: normalized.main ?? null,
+    renderer: normalized.renderer ?? null
+  });
 }
 function selectOperations(all, main) {
-  if (main === true) return new Map(all);
-  if ("module" in main) {
-    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));
-    if (matched.size) return matched;
-    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];
-    throw new import_test_wood.TestWoodError(
-      `unknown module "${main.module}"; ` + (modules.length ? `available modules: ${modules.join(", ")}` : "the config defines no modules")
-    );
-  }
-  const match = all.get(main.operation);
-  if (!match) {
-    throw new import_test_wood.TestWoodError(`no operation matches "${main.operation}"; ${operationIdentities(all)}`);
-  }
-  return /* @__PURE__ */ new Map([[main.operation, match]]);
+  if (main === null) return /* @__PURE__ */ new Map();
+  const source = [...all].map(([path, operation]) => ({ path, module: operation.module, operation }));
+  return new Map((0, import_testing.selectSourceEntries)(source, main, { owner: "main", native: true }).map((e) => [e.path, e.operation]));
 }
-function selectCatalog(views, pages) {
+function selectViews(views, renderer) {
   const catalog = new import_page_catalog.PageCatalog(views);
-  return pages === true ? catalog : catalog.select({ pages });
+  const source = catalog.all().map((view) => ({ path: (0, import_page_catalog.pageIdentity)(view), module: view.windowName, view }));
+  const windows = [...new Set(source.map((entry) => entry.module))];
+  const selected = (0, import_testing.selectSourceEntries)(source, renderer, { owner: "renderer", native: true, modules: windows });
+  return new import_page_catalog.PageCatalog(selected.map((entry) => entry.view));
+}
+function selectRendererCatalog(views, selection) {
+  return selection.renderer !== null ? selectViews(views(), selection.renderer) : null;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DECLARED_OWNERS,
+  hasRendererTier,
   resolveSelection,
-  selectCatalog,
-  selectOperations
+  selectOperations,
+  selectRendererCatalog,
+  selectViews
 });
 //# sourceMappingURL=wood_test_selection.cjs.map

package/dist/testing/wood_test_selection.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/wood_test_selection.ts"],"sourcesContent":["/**\n * `testWood(configPath).select({...})` — one declarative object says which\n * tiers exist and how they are observed:\n *\n *   main   true | { operation } | { module }   the router + real controllers\n *   pages  true | [identity, ...]              the renderer page catalog\n *   dom    'happy-dom' | 'chromium'            the page's real component\n *\n * A key that is absent is not built. `pages` implies `main: true`; `dom`\n * requires `pages`. Nothing opens at build — tests drive `open()`.\n */\nimport type { OperationDef, ViewDef } from '../types/index.cjs';\nimport { PageCatalog } from '../frontend/page_catalog.js';\nimport { TestWoodError } from './test_wood.cjs';\n\nexport type WoodMainSelection = true | { operation: string } | { module: string };\nexport type WoodDomMode = 'happy-dom' | 'chromium';\n\nexport interface WoodTestSelection {\n  main?: WoodMainSelection;\n  pages?: true | string[];\n  dom?: WoodDomMode;\n}\n\nexport interface ResolvedWoodSelection {\n  readonly main: WoodMainSelection;\n  readonly pages: true | string[] | null;\n  readonly dom: WoodDomMode | null;\n}\n\nconst DOM_MODES: readonly WoodDomMode[] = ['happy-dom', 'chromium'];\n\nfunction isMainSelection(value: unknown): value is WoodMainSelection {\n  if (value === true) return true;\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as { operation?: unknown; module?: unknown };\n  const hasOperation = typeof candidate.operation === 'string' && candidate.operation.length > 0;\n  const hasModule = typeof candidate.module === 'string' && candidate.module.length > 0;\n  return hasOperation !== hasModule;\n}\n\nfunction isPagesSelection(value: unknown): value is true | string[] {\n  if (value === true) return true;\n  return Array.isArray(value)\n    && value.length > 0\n    && value.every((entry) => typeof entry === 'string' && entry.length > 0);\n}\n\nexport function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection {\n  if (!selection || typeof selection !== 'object') {\n    throw new TestWoodError('select() requires { main }, { pages }, or both (plus optional dom)');\n  }\n  const { main, pages, dom } = selection;\n  if (main !== undefined && !isMainSelection(main)) {\n    throw new TestWoodError('select({ main }) must be true, { operation: string } or { module: string }');\n  }\n  if (pages !== undefined && !isPagesSelection(pages)) {\n    throw new TestWoodError('select({ pages }) must be true or a non-empty list of page identities');\n  }\n  if (dom !== undefined && !DOM_MODES.includes(dom)) {\n    throw new TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(', ')}`);\n  }\n  if (dom !== undefined && pages === undefined) {\n    throw new TestWoodError('select({ dom }) requires { pages }: a component needs a page to mount');\n  }\n  if (main === undefined && pages === undefined) {\n    throw new TestWoodError('select() built nothing: add { main } and/or { pages }');\n  }\n  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };\n}\n\nfunction operationIdentities(operations: Map<string, OperationDef>): string {\n  if (!operations.size) return 'the config defines no operations';\n  return `available operations:\\n  ${[...operations.keys()].join('\\n  ')}`;\n}\n\n/** Narrow the production operations to the selected main aperture. */\nexport function selectOperations(\n  all: Map<string, OperationDef>,\n  main: WoodMainSelection,\n): Map<string, OperationDef> {\n  if (main === true) return new Map(all);\n  if ('module' in main) {\n    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));\n    if (matched.size) return matched;\n    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];\n    throw new TestWoodError(\n      `unknown module \"${main.module}\"; ` +\n      (modules.length ? `available modules: ${modules.join(', ')}` : 'the config defines no modules'),\n    );\n  }\n  const match = all.get(main.operation);\n  if (!match) {\n    throw new TestWoodError(`no operation matches \"${main.operation}\"; ${operationIdentities(all)}`);\n  }\n  return new Map([[main.operation, match]]);\n}\n\n/** The renderer aperture: every production page, or exactly the named ones. */\nexport function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog {\n  const catalog = new PageCatalog(views);\n  return pages === true ? catalog : catalog.select({ pages });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,0BAA4B;AAC5B,uBAA8B;AAiB9B,MAAM,YAAoC,CAAC,aAAa,UAAU;AAElE,SAAS,gBAAgB,OAA4C;AACnE,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,QAAM,eAAe,OAAO,UAAU,cAAc,YAAY,UAAU,UAAU,SAAS;AAC7F,QAAM,YAAY,OAAO,UAAU,WAAW,YAAY,UAAU,OAAO,SAAS;AACpF,SAAO,iBAAiB;AAC1B;AAEA,SAAS,iBAAiB,OAA0C;AAClE,MAAI,UAAU,KAAM,QAAO;AAC3B,SAAO,MAAM,QAAQ,KAAK,KACrB,MAAM,SAAS,KACf,MAAM,MAAM,CAAC,UAAU,OAAO,UAAU,YAAY,MAAM,SAAS,CAAC;AAC3E;AAEO,SAAS,iBAAiB,WAA4D;AAC3F,MAAI,CAAC,aAAa,OAAO,cAAc,UAAU;AAC/C,UAAM,IAAI,+BAAc,oEAAoE;AAAA,EAC9F;AACA,QAAM,EAAE,MAAM,OAAO,IAAI,IAAI;AAC7B,MAAI,SAAS,UAAa,CAAC,gBAAgB,IAAI,GAAG;AAChD,UAAM,IAAI,+BAAc,4EAA4E;AAAA,EACtG;AACA,MAAI,UAAU,UAAa,CAAC,iBAAiB,KAAK,GAAG;AACnD,UAAM,IAAI,+BAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,QAAQ,UAAa,CAAC,UAAU,SAAS,GAAG,GAAG;AACjD,UAAM,IAAI,+BAAc,mCAAmC,UAAU,KAAK,IAAI,CAAC,EAAE;AAAA,EACnF;AACA,MAAI,QAAQ,UAAa,UAAU,QAAW;AAC5C,UAAM,IAAI,+BAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,SAAS,UAAa,UAAU,QAAW;AAC7C,UAAM,IAAI,+BAAc,uDAAuD;AAAA,EACjF;AACA,SAAO,EAAE,MAAM,QAAQ,MAAM,OAAO,SAAS,MAAM,KAAK,OAAO,KAAK;AACtE;AAEA,SAAS,oBAAoB,YAA+C;AAC1E,MAAI,CAAC,WAAW,KAAM,QAAO;AAC7B,SAAO;AAAA,IAA4B,CAAC,GAAG,WAAW,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;AACxE;AAGO,SAAS,iBACd,KACA,MAC2B;AAC3B,MAAI,SAAS,KAAM,QAAO,IAAI,IAAI,GAAG;AACrC,MAAI,YAAY,MAAM;AACpB,UAAM,UAAU,IAAI,IAAI,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,MAAM,UAAU,WAAW,KAAK,MAAM,CAAC;AAC5F,QAAI,QAAQ,KAAM,QAAO;AACzB,UAAM,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,UAAU,MAAM,EAAE,OAAO,OAAO,CAAC,CAAC;AACnG,UAAM,IAAI;AAAA,MACR,mBAAmB,KAAK,MAAM,SAC7B,QAAQ,SAAS,sBAAsB,QAAQ,KAAK,IAAI,CAAC,KAAK;AAAA,IACjE;AAAA,EACF;AACA,QAAM,QAAQ,IAAI,IAAI,KAAK,SAAS;AACpC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,+BAAc,yBAAyB,KAAK,SAAS,MAAM,oBAAoB,GAAG,CAAC,EAAE;AAAA,EACjG;AACA,SAAO,oBAAI,IAAI,CAAC,CAAC,KAAK,WAAW,KAAK,CAAC,CAAC;AAC1C;AAGO,SAAS,cAAc,OAAkB,OAAqC;AACnF,QAAM,UAAU,IAAI,gCAAY,KAAK;AACrC,SAAO,UAAU,OAAO,UAAU,QAAQ,OAAO,EAAE,MAAM,CAAC;AAC5D;","names":[]}
+{"version":3,"sources":["../../src/testing/wood_test_selection.ts"],"sourcesContent":["/**\n * Canonical `testWood(configPath).select({...})` source aperture.\n *\n * `main` and `renderer` use the shared @noego/testing OwnerSelection contract:\n * `{ module }`, `{ path }`, or `{}`. An omitted owner is omitted; selecting a\n * renderer never widens main. Browser/DOM hosting is selected separately with\n * `.browser()` / `.browser('happy_dom')`.\n */\nimport type { OperationDef, ViewDef } from '../types/index.cjs';\nimport { normalizeTestSelection, selectSourceEntries, type OwnerSelection } from '@noego/testing';\nimport { PageCatalog, pageIdentity } from '../frontend/page_catalog.js';\nimport { TestWoodError } from './test_wood.cjs';\n\nexport type WoodMainSelection = OwnerSelection;\nexport type WoodRendererSelection = OwnerSelection;\nexport type WoodDomMode = never;\n\nexport interface WoodTestSelection {\n  main?: WoodMainSelection;\n  renderer?: WoodRendererSelection;\n}\n\nexport interface ResolvedWoodSelection {\n  readonly main: WoodMainSelection | null;\n  readonly renderer: WoodRendererSelection | null;\n}\n\nexport function hasRendererTier(selection: ResolvedWoodSelection): boolean {\n  return selection.renderer !== null;\n}\n\nexport const DECLARED_OWNERS: readonly ('main' | 'renderer')[] = Object.freeze(['main', 'renderer']);\n\nexport function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection {\n  if (!selection || typeof selection !== 'object' || Array.isArray(selection)) {\n    throw new TestWoodError('select() requires { main } and/or { renderer }');\n  }\n  const normalized = normalizeTestSelection(selection, DECLARED_OWNERS);\n  if (normalized.main === undefined && normalized.renderer === undefined) {\n    throw new TestWoodError('select() built nothing: add { main } and/or { renderer }');\n  }\n  return Object.freeze({\n    main: normalized.main ?? null,\n    renderer: normalized.renderer ?? null,\n  });\n}\n\nexport function selectOperations(\n  all: Map<string, OperationDef>,\n  main: WoodMainSelection | null,\n): Map<string, OperationDef> {\n  if (main === null) return new Map();\n  const source = [...all].map(([path, operation]) => ({ path, module: operation.module, operation }));\n  return new Map(selectSourceEntries(source, main, { owner: 'main', native: true }).map(e => [e.path, e.operation]));\n}\n\nexport function selectViews(views: ViewDef[], renderer: WoodRendererSelection): PageCatalog {\n  const catalog = new PageCatalog(views);\n  const source = catalog.all().map((view) => ({ path: pageIdentity(view), module: view.windowName, view }));\n  const windows = [...new Set(source.map((entry) => entry.module))];\n  const selected = selectSourceEntries(source, renderer, { owner: 'renderer', native: true, modules: windows });\n  return new PageCatalog(selected.map((entry) => entry.view));\n}\n\nexport function selectRendererCatalog(views: () => ViewDef[], selection: ResolvedWoodSelection): PageCatalog | null {\n  return selection.renderer !== null ? selectViews(views(), selection.renderer) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,qBAAiF;AACjF,0BAA0C;AAC1C,uBAA8B;AAgBvB,SAAS,gBAAgB,WAA2C;AACzE,SAAO,UAAU,aAAa;AAChC;AAEO,MAAM,kBAAoD,OAAO,OAAO,CAAC,QAAQ,UAAU,CAAC;AAE5F,SAAS,iBAAiB,WAA4D;AAC3F,MAAI,CAAC,aAAa,OAAO,cAAc,YAAY,MAAM,QAAQ,SAAS,GAAG;AAC3E,UAAM,IAAI,+BAAc,gDAAgD;AAAA,EAC1E;AACA,QAAM,iBAAa,uCAAuB,WAAW,eAAe;AACpE,MAAI,WAAW,SAAS,UAAa,WAAW,aAAa,QAAW;AACtE,UAAM,IAAI,+BAAc,0DAA0D;AAAA,EACpF;AACA,SAAO,OAAO,OAAO;AAAA,IACnB,MAAM,WAAW,QAAQ;AAAA,IACzB,UAAU,WAAW,YAAY;AAAA,EACnC,CAAC;AACH;AAEO,SAAS,iBACd,KACA,MAC2B;AAC3B,MAAI,SAAS,KAAM,QAAO,oBAAI,IAAI;AAClC,QAAM,SAAS,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC,MAAM,SAAS,OAAO,EAAE,MAAM,QAAQ,UAAU,QAAQ,UAAU,EAAE;AAClG,SAAO,IAAI,QAAI,oCAAoB,QAAQ,MAAM,EAAE,OAAO,QAAQ,QAAQ,KAAK,CAAC,EAAE,IAAI,OAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACnH;AAEO,SAAS,YAAY,OAAkB,UAA8C;AAC1F,QAAM,UAAU,IAAI,gCAAY,KAAK;AACrC,QAAM,SAAS,QAAQ,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,UAAM,kCAAa,IAAI,GAAG,QAAQ,KAAK,YAAY,KAAK,EAAE;AACxG,QAAM,UAAU,CAAC,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAChE,QAAM,eAAW,oCAAoB,QAAQ,UAAU,EAAE,OAAO,YAAY,QAAQ,MAAM,SAAS,QAAQ,CAAC;AAC5G,SAAO,IAAI,gCAAY,SAAS,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC;AAC5D;AAEO,SAAS,sBAAsB,OAAwB,WAAsD;AAClH,SAAO,UAAU,aAAa,OAAO,YAAY,MAAM,GAAG,UAAU,QAAQ,IAAI;AAClF;","names":[]}

package/dist/testing/wood_test_selection.d.cts

@@ -1,39 +1,33 @@
 import { OperationDef } from '../types/operations.cjs';
 import { ViewDef } from '../types/views.cjs';
+import { OwnerSelection } from '@noego/testing';
 import { PageCatalog } from '../frontend/page_catalog.cjs';
 
 /**
- * `testWood(configPath).select({...})` — one declarative object says which
- * tiers exist and how they are observed:
+ * Canonical `testWood(configPath).select({...})` source aperture.
  *
- *   main   true | { operation } | { module }   the router + real controllers
- *   pages  true | [identity, ...]              the renderer page catalog
- *   dom    'happy-dom' | 'chromium'            the page's real component
- *
- * A key that is absent is not built. `pages` implies `main: true`; `dom`
- * requires `pages`. Nothing opens at build — tests drive `open()`.
+ * `main` and `renderer` use the shared @noego/testing OwnerSelection contract:
+ * `{ module }`, `{ path }`, or `{}`. An omitted owner is omitted; selecting a
+ * renderer never widens main. Browser/DOM hosting is selected separately with
+ * `.browser()` / `.browser('happy_dom')`.
  */
 
-type WoodMainSelection = true | {
-    operation: string;
-} | {
-    module: string;
-};
-type WoodDomMode = 'happy-dom' | 'chromium';
+type WoodMainSelection = OwnerSelection;
+type WoodRendererSelection = OwnerSelection;
+type WoodDomMode = never;
 interface WoodTestSelection {
     main?: WoodMainSelection;
-    pages?: true | string[];
-    dom?: WoodDomMode;
+    renderer?: WoodRendererSelection;
 }
 interface ResolvedWoodSelection {
-    readonly main: WoodMainSelection;
-    readonly pages: true | string[] | null;
-    readonly dom: WoodDomMode | null;
+    readonly main: WoodMainSelection | null;
+    readonly renderer: WoodRendererSelection | null;
 }
+declare function hasRendererTier(selection: ResolvedWoodSelection): boolean;
+declare const DECLARED_OWNERS: readonly ('main' | 'renderer')[];
 declare function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection;
-/** Narrow the production operations to the selected main aperture. */
-declare function selectOperations(all: Map<string, OperationDef>, main: WoodMainSelection): Map<string, OperationDef>;
-/** The renderer aperture: every production page, or exactly the named ones. */
-declare function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog;
+declare function selectOperations(all: Map<string, OperationDef>, main: WoodMainSelection | null): Map<string, OperationDef>;
+declare function selectViews(views: ViewDef[], renderer: WoodRendererSelection): PageCatalog;
+declare function selectRendererCatalog(views: () => ViewDef[], selection: ResolvedWoodSelection): PageCatalog | null;
 
-export { type ResolvedWoodSelection, type WoodDomMode, type WoodMainSelection, type WoodTestSelection, resolveSelection, selectCatalog, selectOperations };
+export { DECLARED_OWNERS, type ResolvedWoodSelection, type WoodDomMode, type WoodMainSelection, type WoodRendererSelection, type WoodTestSelection, hasRendererTier, resolveSelection, selectOperations, selectRendererCatalog, selectViews };

package/dist/testing/wood_test_selection.d.ts

@@ -1,39 +1,33 @@
 import { OperationDef } from '../types/operations.js';
 import { ViewDef } from '../types/views.js';
+import { OwnerSelection } from '@noego/testing';
 import { PageCatalog } from '../frontend/page_catalog.js';
 
 /**
- * `testWood(configPath).select({...})` — one declarative object says which
- * tiers exist and how they are observed:
+ * Canonical `testWood(configPath).select({...})` source aperture.
  *
- *   main   true | { operation } | { module }   the router + real controllers
- *   pages  true | [identity, ...]              the renderer page catalog
- *   dom    'happy-dom' | 'chromium'            the page's real component
- *
- * A key that is absent is not built. `pages` implies `main: true`; `dom`
- * requires `pages`. Nothing opens at build — tests drive `open()`.
+ * `main` and `renderer` use the shared @noego/testing OwnerSelection contract:
+ * `{ module }`, `{ path }`, or `{}`. An omitted owner is omitted; selecting a
+ * renderer never widens main. Browser/DOM hosting is selected separately with
+ * `.browser()` / `.browser('happy_dom')`.
  */
 
-type WoodMainSelection = true | {
-    operation: string;
-} | {
-    module: string;
-};
-type WoodDomMode = 'happy-dom' | 'chromium';
+type WoodMainSelection = OwnerSelection;
+type WoodRendererSelection = OwnerSelection;
+type WoodDomMode = never;
 interface WoodTestSelection {
     main?: WoodMainSelection;
-    pages?: true | string[];
-    dom?: WoodDomMode;
+    renderer?: WoodRendererSelection;
 }
 interface ResolvedWoodSelection {
-    readonly main: WoodMainSelection;
-    readonly pages: true | string[] | null;
-    readonly dom: WoodDomMode | null;
+    readonly main: WoodMainSelection | null;
+    readonly renderer: WoodRendererSelection | null;
 }
+declare function hasRendererTier(selection: ResolvedWoodSelection): boolean;
+declare const DECLARED_OWNERS: readonly ('main' | 'renderer')[];
 declare function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection;
-/** Narrow the production operations to the selected main aperture. */
-declare function selectOperations(all: Map<string, OperationDef>, main: WoodMainSelection): Map<string, OperationDef>;
-/** The renderer aperture: every production page, or exactly the named ones. */
-declare function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog;
+declare function selectOperations(all: Map<string, OperationDef>, main: WoodMainSelection | null): Map<string, OperationDef>;
+declare function selectViews(views: ViewDef[], renderer: WoodRendererSelection): PageCatalog;
+declare function selectRendererCatalog(views: () => ViewDef[], selection: ResolvedWoodSelection): PageCatalog | null;
 
-export { type ResolvedWoodSelection, type WoodDomMode, type WoodMainSelection, type WoodTestSelection, resolveSelection, selectCatalog, selectOperations };
+export { DECLARED_OWNERS, type ResolvedWoodSelection, type WoodDomMode, type WoodMainSelection, type WoodRendererSelection, type WoodTestSelection, hasRendererTier, resolveSelection, selectOperations, selectRendererCatalog, selectViews };

package/dist/testing/wood_test_selection.js

@@ -1,68 +1,44 @@
-import { PageCatalog } from "../frontend/page_catalog.js";
+import { normalizeTestSelection, selectSourceEntries } from "@noego/testing";
+import { PageCatalog, pageIdentity } from "../frontend/page_catalog.js";
 import { TestWoodError } from "./test_wood.js";
-const DOM_MODES = ["happy-dom", "chromium"];
-function isMainSelection(value) {
-  if (value === true) return true;
-  if (!value || typeof value !== "object") return false;
-  const candidate = value;
-  const hasOperation = typeof candidate.operation === "string" && candidate.operation.length > 0;
-  const hasModule = typeof candidate.module === "string" && candidate.module.length > 0;
-  return hasOperation !== hasModule;
-}
-function isPagesSelection(value) {
-  if (value === true) return true;
-  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "string" && entry.length > 0);
+function hasRendererTier(selection) {
+  return selection.renderer !== null;
 }
+const DECLARED_OWNERS = Object.freeze(["main", "renderer"]);
 function resolveSelection(selection) {
-  if (!selection || typeof selection !== "object") {
-    throw new TestWoodError("select() requires { main }, { pages }, or both (plus optional dom)");
-  }
-  const { main, pages, dom } = selection;
-  if (main !== void 0 && !isMainSelection(main)) {
-    throw new TestWoodError("select({ main }) must be true, { operation: string } or { module: string }");
-  }
-  if (pages !== void 0 && !isPagesSelection(pages)) {
-    throw new TestWoodError("select({ pages }) must be true or a non-empty list of page identities");
-  }
-  if (dom !== void 0 && !DOM_MODES.includes(dom)) {
-    throw new TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(", ")}`);
-  }
-  if (dom !== void 0 && pages === void 0) {
-    throw new TestWoodError("select({ dom }) requires { pages }: a component needs a page to mount");
+  if (!selection || typeof selection !== "object" || Array.isArray(selection)) {
+    throw new TestWoodError("select() requires { main } and/or { renderer }");
   }
-  if (main === void 0 && pages === void 0) {
-    throw new TestWoodError("select() built nothing: add { main } and/or { pages }");
+  const normalized = normalizeTestSelection(selection, DECLARED_OWNERS);
+  if (normalized.main === void 0 && normalized.renderer === void 0) {
+    throw new TestWoodError("select() built nothing: add { main } and/or { renderer }");
   }
-  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };
-}
-function operationIdentities(operations) {
-  if (!operations.size) return "the config defines no operations";
-  return `available operations:
-  ${[...operations.keys()].join("\n  ")}`;
+  return Object.freeze({
+    main: normalized.main ?? null,
+    renderer: normalized.renderer ?? null
+  });
 }
 function selectOperations(all, main) {
-  if (main === true) return new Map(all);
-  if ("module" in main) {
-    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));
-    if (matched.size) return matched;
-    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];
-    throw new TestWoodError(
-      `unknown module "${main.module}"; ` + (modules.length ? `available modules: ${modules.join(", ")}` : "the config defines no modules")
-    );
-  }
-  const match = all.get(main.operation);
-  if (!match) {
-    throw new TestWoodError(`no operation matches "${main.operation}"; ${operationIdentities(all)}`);
-  }
-  return /* @__PURE__ */ new Map([[main.operation, match]]);
+  if (main === null) return /* @__PURE__ */ new Map();
+  const source = [...all].map(([path, operation]) => ({ path, module: operation.module, operation }));
+  return new Map(selectSourceEntries(source, main, { owner: "main", native: true }).map((e) => [e.path, e.operation]));
 }
-function selectCatalog(views, pages) {
+function selectViews(views, renderer) {
   const catalog = new PageCatalog(views);
-  return pages === true ? catalog : catalog.select({ pages });
+  const source = catalog.all().map((view) => ({ path: pageIdentity(view), module: view.windowName, view }));
+  const windows = [...new Set(source.map((entry) => entry.module))];
+  const selected = selectSourceEntries(source, renderer, { owner: "renderer", native: true, modules: windows });
+  return new PageCatalog(selected.map((entry) => entry.view));
+}
+function selectRendererCatalog(views, selection) {
+  return selection.renderer !== null ? selectViews(views(), selection.renderer) : null;
 }
 export {
+  DECLARED_OWNERS,
+  hasRendererTier,
   resolveSelection,
-  selectCatalog,
-  selectOperations
+  selectOperations,
+  selectRendererCatalog,
+  selectViews
 };
 //# sourceMappingURL=wood_test_selection.js.map

package/dist/testing/wood_test_selection.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/wood_test_selection.ts"],"sourcesContent":["/**\n * `testWood(configPath).select({...})` — one declarative object says which\n * tiers exist and how they are observed:\n *\n *   main   true | { operation } | { module }   the router + real controllers\n *   pages  true | [identity, ...]              the renderer page catalog\n *   dom    'happy-dom' | 'chromium'            the page's real component\n *\n * A key that is absent is not built. `pages` implies `main: true`; `dom`\n * requires `pages`. Nothing opens at build — tests drive `open()`.\n */\nimport type { OperationDef, ViewDef } from '../types/index.js';\nimport { PageCatalog } from '../frontend/page_catalog.js';\nimport { TestWoodError } from './test_wood.js';\n\nexport type WoodMainSelection = true | { operation: string } | { module: string };\nexport type WoodDomMode = 'happy-dom' | 'chromium';\n\nexport interface WoodTestSelection {\n  main?: WoodMainSelection;\n  pages?: true | string[];\n  dom?: WoodDomMode;\n}\n\nexport interface ResolvedWoodSelection {\n  readonly main: WoodMainSelection;\n  readonly pages: true | string[] | null;\n  readonly dom: WoodDomMode | null;\n}\n\nconst DOM_MODES: readonly WoodDomMode[] = ['happy-dom', 'chromium'];\n\nfunction isMainSelection(value: unknown): value is WoodMainSelection {\n  if (value === true) return true;\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as { operation?: unknown; module?: unknown };\n  const hasOperation = typeof candidate.operation === 'string' && candidate.operation.length > 0;\n  const hasModule = typeof candidate.module === 'string' && candidate.module.length > 0;\n  return hasOperation !== hasModule;\n}\n\nfunction isPagesSelection(value: unknown): value is true | string[] {\n  if (value === true) return true;\n  return Array.isArray(value)\n    && value.length > 0\n    && value.every((entry) => typeof entry === 'string' && entry.length > 0);\n}\n\nexport function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection {\n  if (!selection || typeof selection !== 'object') {\n    throw new TestWoodError('select() requires { main }, { pages }, or both (plus optional dom)');\n  }\n  const { main, pages, dom } = selection;\n  if (main !== undefined && !isMainSelection(main)) {\n    throw new TestWoodError('select({ main }) must be true, { operation: string } or { module: string }');\n  }\n  if (pages !== undefined && !isPagesSelection(pages)) {\n    throw new TestWoodError('select({ pages }) must be true or a non-empty list of page identities');\n  }\n  if (dom !== undefined && !DOM_MODES.includes(dom)) {\n    throw new TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(', ')}`);\n  }\n  if (dom !== undefined && pages === undefined) {\n    throw new TestWoodError('select({ dom }) requires { pages }: a component needs a page to mount');\n  }\n  if (main === undefined && pages === undefined) {\n    throw new TestWoodError('select() built nothing: add { main } and/or { pages }');\n  }\n  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };\n}\n\nfunction operationIdentities(operations: Map<string, OperationDef>): string {\n  if (!operations.size) return 'the config defines no operations';\n  return `available operations:\\n  ${[...operations.keys()].join('\\n  ')}`;\n}\n\n/** Narrow the production operations to the selected main aperture. */\nexport function selectOperations(\n  all: Map<string, OperationDef>,\n  main: WoodMainSelection,\n): Map<string, OperationDef> {\n  if (main === true) return new Map(all);\n  if ('module' in main) {\n    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));\n    if (matched.size) return matched;\n    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];\n    throw new TestWoodError(\n      `unknown module \"${main.module}\"; ` +\n      (modules.length ? `available modules: ${modules.join(', ')}` : 'the config defines no modules'),\n    );\n  }\n  const match = all.get(main.operation);\n  if (!match) {\n    throw new TestWoodError(`no operation matches \"${main.operation}\"; ${operationIdentities(all)}`);\n  }\n  return new Map([[main.operation, match]]);\n}\n\n/** The renderer aperture: every production page, or exactly the named ones. */\nexport function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog {\n  const catalog = new PageCatalog(views);\n  return pages === true ? catalog : catalog.select({ pages });\n}\n"],"mappings":"AAYA,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAiB9B,MAAM,YAAoC,CAAC,aAAa,UAAU;AAElE,SAAS,gBAAgB,OAA4C;AACnE,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,QAAM,eAAe,OAAO,UAAU,cAAc,YAAY,UAAU,UAAU,SAAS;AAC7F,QAAM,YAAY,OAAO,UAAU,WAAW,YAAY,UAAU,OAAO,SAAS;AACpF,SAAO,iBAAiB;AAC1B;AAEA,SAAS,iBAAiB,OAA0C;AAClE,MAAI,UAAU,KAAM,QAAO;AAC3B,SAAO,MAAM,QAAQ,KAAK,KACrB,MAAM,SAAS,KACf,MAAM,MAAM,CAAC,UAAU,OAAO,UAAU,YAAY,MAAM,SAAS,CAAC;AAC3E;AAEO,SAAS,iBAAiB,WAA4D;AAC3F,MAAI,CAAC,aAAa,OAAO,cAAc,UAAU;AAC/C,UAAM,IAAI,cAAc,oEAAoE;AAAA,EAC9F;AACA,QAAM,EAAE,MAAM,OAAO,IAAI,IAAI;AAC7B,MAAI,SAAS,UAAa,CAAC,gBAAgB,IAAI,GAAG;AAChD,UAAM,IAAI,cAAc,4EAA4E;AAAA,EACtG;AACA,MAAI,UAAU,UAAa,CAAC,iBAAiB,KAAK,GAAG;AACnD,UAAM,IAAI,cAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,QAAQ,UAAa,CAAC,UAAU,SAAS,GAAG,GAAG;AACjD,UAAM,IAAI,cAAc,mCAAmC,UAAU,KAAK,IAAI,CAAC,EAAE;AAAA,EACnF;AACA,MAAI,QAAQ,UAAa,UAAU,QAAW;AAC5C,UAAM,IAAI,cAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,SAAS,UAAa,UAAU,QAAW;AAC7C,UAAM,IAAI,cAAc,uDAAuD;AAAA,EACjF;AACA,SAAO,EAAE,MAAM,QAAQ,MAAM,OAAO,SAAS,MAAM,KAAK,OAAO,KAAK;AACtE;AAEA,SAAS,oBAAoB,YAA+C;AAC1E,MAAI,CAAC,WAAW,KAAM,QAAO;AAC7B,SAAO;AAAA,IAA4B,CAAC,GAAG,WAAW,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;AACxE;AAGO,SAAS,iBACd,KACA,MAC2B;AAC3B,MAAI,SAAS,KAAM,QAAO,IAAI,IAAI,GAAG;AACrC,MAAI,YAAY,MAAM;AACpB,UAAM,UAAU,IAAI,IAAI,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,MAAM,UAAU,WAAW,KAAK,MAAM,CAAC;AAC5F,QAAI,QAAQ,KAAM,QAAO;AACzB,UAAM,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,UAAU,MAAM,EAAE,OAAO,OAAO,CAAC,CAAC;AACnG,UAAM,IAAI;AAAA,MACR,mBAAmB,KAAK,MAAM,SAC7B,QAAQ,SAAS,sBAAsB,QAAQ,KAAK,IAAI,CAAC,KAAK;AAAA,IACjE;AAAA,EACF;AACA,QAAM,QAAQ,IAAI,IAAI,KAAK,SAAS;AACpC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,cAAc,yBAAyB,KAAK,SAAS,MAAM,oBAAoB,GAAG,CAAC,EAAE;AAAA,EACjG;AACA,SAAO,oBAAI,IAAI,CAAC,CAAC,KAAK,WAAW,KAAK,CAAC,CAAC;AAC1C;AAGO,SAAS,cAAc,OAAkB,OAAqC;AACnF,QAAM,UAAU,IAAI,YAAY,KAAK;AACrC,SAAO,UAAU,OAAO,UAAU,QAAQ,OAAO,EAAE,MAAM,CAAC;AAC5D;","names":[]}
+{"version":3,"sources":["../../src/testing/wood_test_selection.ts"],"sourcesContent":["/**\n * Canonical `testWood(configPath).select({...})` source aperture.\n *\n * `main` and `renderer` use the shared @noego/testing OwnerSelection contract:\n * `{ module }`, `{ path }`, or `{}`. An omitted owner is omitted; selecting a\n * renderer never widens main. Browser/DOM hosting is selected separately with\n * `.browser()` / `.browser('happy_dom')`.\n */\nimport type { OperationDef, ViewDef } from '../types/index.js';\nimport { normalizeTestSelection, selectSourceEntries, type OwnerSelection } from '@noego/testing';\nimport { PageCatalog, pageIdentity } from '../frontend/page_catalog.js';\nimport { TestWoodError } from './test_wood.js';\n\nexport type WoodMainSelection = OwnerSelection;\nexport type WoodRendererSelection = OwnerSelection;\nexport type WoodDomMode = never;\n\nexport interface WoodTestSelection {\n  main?: WoodMainSelection;\n  renderer?: WoodRendererSelection;\n}\n\nexport interface ResolvedWoodSelection {\n  readonly main: WoodMainSelection | null;\n  readonly renderer: WoodRendererSelection | null;\n}\n\nexport function hasRendererTier(selection: ResolvedWoodSelection): boolean {\n  return selection.renderer !== null;\n}\n\nexport const DECLARED_OWNERS: readonly ('main' | 'renderer')[] = Object.freeze(['main', 'renderer']);\n\nexport function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection {\n  if (!selection || typeof selection !== 'object' || Array.isArray(selection)) {\n    throw new TestWoodError('select() requires { main } and/or { renderer }');\n  }\n  const normalized = normalizeTestSelection(selection, DECLARED_OWNERS);\n  if (normalized.main === undefined && normalized.renderer === undefined) {\n    throw new TestWoodError('select() built nothing: add { main } and/or { renderer }');\n  }\n  return Object.freeze({\n    main: normalized.main ?? null,\n    renderer: normalized.renderer ?? null,\n  });\n}\n\nexport function selectOperations(\n  all: Map<string, OperationDef>,\n  main: WoodMainSelection | null,\n): Map<string, OperationDef> {\n  if (main === null) return new Map();\n  const source = [...all].map(([path, operation]) => ({ path, module: operation.module, operation }));\n  return new Map(selectSourceEntries(source, main, { owner: 'main', native: true }).map(e => [e.path, e.operation]));\n}\n\nexport function selectViews(views: ViewDef[], renderer: WoodRendererSelection): PageCatalog {\n  const catalog = new PageCatalog(views);\n  const source = catalog.all().map((view) => ({ path: pageIdentity(view), module: view.windowName, view }));\n  const windows = [...new Set(source.map((entry) => entry.module))];\n  const selected = selectSourceEntries(source, renderer, { owner: 'renderer', native: true, modules: windows });\n  return new PageCatalog(selected.map((entry) => entry.view));\n}\n\nexport function selectRendererCatalog(views: () => ViewDef[], selection: ResolvedWoodSelection): PageCatalog | null {\n  return selection.renderer !== null ? selectViews(views(), selection.renderer) : null;\n}\n"],"mappings":"AASA,SAAS,wBAAwB,2BAAgD;AACjF,SAAS,aAAa,oBAAoB;AAC1C,SAAS,qBAAqB;AAgBvB,SAAS,gBAAgB,WAA2C;AACzE,SAAO,UAAU,aAAa;AAChC;AAEO,MAAM,kBAAoD,OAAO,OAAO,CAAC,QAAQ,UAAU,CAAC;AAE5F,SAAS,iBAAiB,WAA4D;AAC3F,MAAI,CAAC,aAAa,OAAO,cAAc,YAAY,MAAM,QAAQ,SAAS,GAAG;AAC3E,UAAM,IAAI,cAAc,gDAAgD;AAAA,EAC1E;AACA,QAAM,aAAa,uBAAuB,WAAW,eAAe;AACpE,MAAI,WAAW,SAAS,UAAa,WAAW,aAAa,QAAW;AACtE,UAAM,IAAI,cAAc,0DAA0D;AAAA,EACpF;AACA,SAAO,OAAO,OAAO;AAAA,IACnB,MAAM,WAAW,QAAQ;AAAA,IACzB,UAAU,WAAW,YAAY;AAAA,EACnC,CAAC;AACH;AAEO,SAAS,iBACd,KACA,MAC2B;AAC3B,MAAI,SAAS,KAAM,QAAO,oBAAI,IAAI;AAClC,QAAM,SAAS,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC,MAAM,SAAS,OAAO,EAAE,MAAM,QAAQ,UAAU,QAAQ,UAAU,EAAE;AAClG,SAAO,IAAI,IAAI,oBAAoB,QAAQ,MAAM,EAAE,OAAO,QAAQ,QAAQ,KAAK,CAAC,EAAE,IAAI,OAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AACnH;AAEO,SAAS,YAAY,OAAkB,UAA8C;AAC1F,QAAM,UAAU,IAAI,YAAY,KAAK;AACrC,QAAM,SAAS,QAAQ,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,aAAa,IAAI,GAAG,QAAQ,KAAK,YAAY,KAAK,EAAE;AACxG,QAAM,UAAU,CAAC,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAChE,QAAM,WAAW,oBAAoB,QAAQ,UAAU,EAAE,OAAO,YAAY,QAAQ,MAAM,SAAS,QAAQ,CAAC;AAC5G,SAAO,IAAI,YAAY,SAAS,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC;AAC5D;AAEO,SAAS,sBAAsB,OAAwB,WAAsD;AAClH,SAAO,UAAU,aAAa,OAAO,YAAY,MAAM,GAAG,UAAU,QAAQ,IAAI;AAClF;","names":[]}

package/dist/testing-api.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var testing_api_exports = {};
+module.exports = __toCommonJS(testing_api_exports);
+//# sourceMappingURL=testing-api.cjs.map

package/dist/testing-api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing-api.ts"],"sourcesContent":["/**\n * Project-augmentable object-shaped operation API exposed by testWood.\n *\n * Wood codegen augments this interface in each application with that\n * application's GeneratedWoodBridge contract.\n */\nexport interface WoodTestApi {}\n\n/**\n * Same operation tree as WoodTestApi, but every leaf accepts unknown input.\n * Use this only when a test intentionally attacks runtime validation with a\n * malformed payload; normal operation calls belong on TestWoodEnvironment.api.\n */\nexport type WoodTestRawApi<T = WoodTestApi> = {\n  [K in keyof T]: T[K] extends (...args: infer _Args) => infer _Return\n    ? (data?: unknown) => Promise<unknown>\n    : T[K] extends object\n      ? WoodTestRawApi<T[K]>\n      : never;\n};\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/testing-api.d.cts

@@ -0,0 +1,18 @@
+/**
+ * Project-augmentable object-shaped operation API exposed by testWood.
+ *
+ * Wood codegen augments this interface in each application with that
+ * application's GeneratedWoodBridge contract.
+ */
+interface WoodTestApi {
+}
+/**
+ * Same operation tree as WoodTestApi, but every leaf accepts unknown input.
+ * Use this only when a test intentionally attacks runtime validation with a
+ * malformed payload; normal operation calls belong on TestWoodEnvironment.api.
+ */
+type WoodTestRawApi<T = WoodTestApi> = {
+    [K in keyof T]: T[K] extends (...args: infer _Args) => infer _Return ? (data?: unknown) => Promise<unknown> : T[K] extends object ? WoodTestRawApi<T[K]> : never;
+};
+
+export type { WoodTestApi, WoodTestRawApi };

package/dist/testing-api.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Project-augmentable object-shaped operation API exposed by testWood.
+ *
+ * Wood codegen augments this interface in each application with that
+ * application's GeneratedWoodBridge contract.
+ */
+interface WoodTestApi {
+}
+/**
+ * Same operation tree as WoodTestApi, but every leaf accepts unknown input.
+ * Use this only when a test intentionally attacks runtime validation with a
+ * malformed payload; normal operation calls belong on TestWoodEnvironment.api.
+ */
+type WoodTestRawApi<T = WoodTestApi> = {
+    [K in keyof T]: T[K] extends (...args: infer _Args) => infer _Return ? (data?: unknown) => Promise<unknown> : T[K] extends object ? WoodTestRawApi<T[K]> : never;
+};
+
+export type { WoodTestApi, WoodTestRawApi };

package/dist/testing-api.js

@@ -0,0 +1 @@
+//# sourceMappingURL=testing-api.js.map

package/dist/testing-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/config.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["/** Configuration types for wood.config.yml */\n\n/** Top-level Wood configuration parsed from wood.config.yml */\nexport interface WoodConfig {\n  root: string;\n  outDir: string;\n  app: {\n    boot: string;\n    watch: string[];\n  };\n  main: {\n    entry: string;\n    controllers: string;\n    middleware: string;\n    openapi: string;\n    watch: string[];\n    testing?: MainTestingConfig;\n  };\n  renderer: {\n    openapi: string;\n    componentDir: string;\n    controllers: string;\n    entry?: string;\n    watch?: string[];\n    testing?: RendererTestingConfig;\n  };\n  windows: Record<string, WindowDef>;\n  database?: {\n    path: string;\n    migrations?: string;\n  };\n  assets?: string[];\n  dev?: DevConfig;\n  build?: ElectronBuilderConfig;\n  observability?: ObservabilityConfig;\n}\n\n/**\n * Test-composition hooks for the main process (`main.testing`). Only the\n * application can know how its backend composes on a fresh IoC root; the\n * config names the module so `@noego/wood/testing`'s `testWood(configPath)`\n * finds it without any test-site wiring.\n */\nexport interface MainTestingConfig {\n  /**\n   * Module (config-relative path) whose default export composes the app's\n   * backend on the root the test builder hands it. See `WoodComposeMain`\n   * in `@noego/wood/testing`.\n   */\n  compose?: string;\n}\n\n/** Test-composition hooks for the renderer (`renderer.testing`). */\nexport interface RendererTestingConfig {\n  /**\n   * Module (config-relative path) whose default export mounts a page's real\n   * component for a controller under a DOM driver. See `WoodPageHost` in\n   * `@noego/wood/testing`.\n   */\n  host?: string;\n}\n\n/**\n * Renderer→main IPC trace batching policy. Owned here (wood.config.yml) per\n * the NoEgo observability architecture: the generated preload embeds the\n * resolved values but is not the configuration owner, and changing this policy\n * never changes instrumentation call sites or record semantics.\n */\nexport interface RendererTraceBatchingConfig {\n  maxQueuedEvents: number;\n  maxBatchEvents: number;\n  acknowledgementTimeoutMs: number;\n  retryLimit: number;\n  retryBaseDelayMs: number;\n}\n\nexport interface ObservabilityConfig {\n  trace?: {\n    rendererToMain?: {\n      batching?: RendererTraceBatchingConfig;\n    };\n  };\n}\n\n/** BrowserWindow definition from the `windows` section of wood.config.yml */\nexport interface WindowDef {\n  title: string;\n  width: number;\n  height: number;\n  defaultRoute: string;\n  frame?: boolean;\n  transparent?: boolean;\n  resizable?: boolean;\n  alwaysOnTop?: boolean;\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  show?: boolean;\n  parent?: string;\n  modal?: boolean;\n  vibrancy?: string;\n  backgroundMaterial?: string;\n  rememberBounds?: boolean;\n  contextMenu?: 'native' | 'custom';\n  acceptFirstMouse?: boolean;\n  nativeQuitFallback?: boolean;\n  titleBarStyle?: 'default' | 'hidden' | 'hiddenInset' | 'customButtonsOnHover';\n  trafficLightPosition?: { x: number; y: number };\n  titleBarOverlay?: boolean | { color?: string; symbolColor?: string; height?: number };\n}\n\n/** Dev-mode settings from the `dev` section of wood.config.yml */\nexport interface DevConfig {\n  port?: number;\n  watch?: boolean;\n  splitServe?: boolean;\n  electronArgs?: string[];\n  inspectPort?: number;\n  backendInspectPort?: number;\n}\n\n/** Electron-builder packaging configuration from the `build` section */\nexport interface ElectronBuilderConfig {\n  appId: string;\n  productName: string;\n  mac?: Record<string, unknown>;\n  win?: Record<string, unknown>;\n  linux?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["/** Configuration types for wood.config.yml */\n\n/** Top-level Wood configuration parsed from wood.config.yml */\nexport interface WoodConfig {\n  root: string;\n  outDir: string;\n  app: {\n    boot: string;\n    watch: string[];\n  };\n  main: {\n    entry: string;\n    controllers: string;\n    middleware: string;\n    openapi: string;\n    watch: string[];\n    testing?: MainTestingConfig;\n  };\n  renderer: {\n    openapi: string;\n    componentDir: string;\n    /** Config-relative global styles for native renderer hosts. */\n    css?: string[];\n    controllers: string;\n    /** Production renderer-root registration module. */\n    compose?: string;\n    entry?: string;\n    watch?: string[];\n    testing?: RendererTestingConfig;\n  };\n  windows: Record<string, WindowDef>;\n  database?: {\n    path: string;\n    migrations?: string;\n  };\n  assets?: string[];\n  dev?: DevConfig;\n  build?: ElectronBuilderConfig;\n  observability?: ObservabilityConfig;\n}\n\n/**\n * Test-composition hooks for the main process (`main.testing`). Only the\n * application can know how its backend composes on a fresh IoC root; the\n * config names the module so `@noego/wood/testing`'s `testWood(configPath)`\n * finds it without any test-site wiring.\n */\nexport interface MainTestingConfig {\n  /**\n   * Module (config-relative path) whose default export composes the app's\n   * backend on the root the test builder hands it. See `WoodComposeMain`\n   * in `@noego/wood/testing`.\n   */\n  compose?: string;\n}\n\n/** Test-composition hooks for the renderer (`renderer.testing`). */\nexport interface RendererTestingConfig {\n  /**\n   * Module (config-relative path) whose default export mounts a page's real\n   * component for a controller under a DOM driver. See `WoodPageHost` in\n   * `@noego/wood/testing`.\n   */\n  host?: string;\n}\n\n/**\n * Renderer→main IPC trace batching policy. Owned here (wood.config.yml) per\n * the NoEgo observability architecture: the generated preload embeds the\n * resolved values but is not the configuration owner, and changing this policy\n * never changes instrumentation call sites or record semantics.\n */\nexport interface RendererTraceBatchingConfig {\n  maxQueuedEvents: number;\n  maxBatchEvents: number;\n  acknowledgementTimeoutMs: number;\n  retryLimit: number;\n  retryBaseDelayMs: number;\n}\n\nexport interface ObservabilityConfig {\n  trace?: {\n    rendererToMain?: {\n      batching?: RendererTraceBatchingConfig;\n    };\n  };\n}\n\n/** BrowserWindow definition from the `windows` section of wood.config.yml */\nexport interface WindowDef {\n  title: string;\n  width: number;\n  height: number;\n  defaultRoute: string;\n  frame?: boolean;\n  transparent?: boolean;\n  resizable?: boolean;\n  alwaysOnTop?: boolean;\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  show?: boolean;\n  parent?: string;\n  modal?: boolean;\n  vibrancy?: string;\n  backgroundMaterial?: string;\n  rememberBounds?: boolean;\n  contextMenu?: 'native' | 'custom';\n  acceptFirstMouse?: boolean;\n  nativeQuitFallback?: boolean;\n  titleBarStyle?: 'default' | 'hidden' | 'hiddenInset' | 'customButtonsOnHover';\n  trafficLightPosition?: { x: number; y: number };\n  titleBarOverlay?: boolean | { color?: string; symbolColor?: string; height?: number };\n}\n\n/** Dev-mode settings from the `dev` section of wood.config.yml */\nexport interface DevConfig {\n  port?: number;\n  watch?: boolean;\n  splitServe?: boolean;\n  electronArgs?: string[];\n  inspectPort?: number;\n  backendInspectPort?: number;\n}\n\n/** Electron-builder packaging configuration from the `build` section */\nexport interface ElectronBuilderConfig {\n  appId: string;\n  productName: string;\n  mac?: Record<string, unknown>;\n  win?: Record<string, unknown>;\n  linux?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/config.d.cts

@@ -18,7 +18,11 @@ interface WoodConfig {
     renderer: {
         openapi: string;
         componentDir: string;
+        /** Config-relative global styles for native renderer hosts. */
+        css?: string[];
         controllers: string;
+        /** Production renderer-root registration module. */
+        compose?: string;
         entry?: string;
         watch?: string[];
         testing?: RendererTestingConfig;

package/dist/types/config.d.ts

@@ -18,7 +18,11 @@ interface WoodConfig {
     renderer: {
         openapi: string;
         componentDir: string;
+        /** Config-relative global styles for native renderer hosts. */
+        css?: string[];
         controllers: string;
+        /** Production renderer-root registration module. */
+        compose?: string;
         entry?: string;
         watch?: string[];
         testing?: RendererTestingConfig;