@noego/wood 0.4.8 → 0.4.10

package/dist/automation/waits_executor.js

@@ -0,0 +1,79 @@
+import { automationError, automationOk } from "./errors.js";
+import { readAutomationSnapshot, waitForRendererIdle } from "./introspection_reader.js";
+import { toPlaywrightLocator } from "./locator.js";
+const DEFAULT_TIMEOUT_MS = 5e3;
+function matchesUrl(actual, expected, match = "exact") {
+  if (match === "exact") return actual === expected;
+  if (match === "regex") {
+    try {
+      return new RegExp(expected).test(actual);
+    } catch {
+      return false;
+    }
+  }
+  const escaped = expected.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${escaped}$`).test(actual);
+}
+async function awaitCondition(page, condition, options) {
+  const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const started = Date.now();
+  let lastObserved = null;
+  if (condition.kind === "trace" || condition.kind === "target") {
+    return automationError("UNSUPPORTED", `${condition.kind} waits require an unavailable ${condition.kind} observation capability.`, { details: { capability: condition.kind, lastObserved } });
+  }
+  try {
+    if (condition.kind === "visible" || condition.kind === "hidden" || condition.kind === "attached" || condition.kind === "detached") {
+      await toPlaywrightLocator(page, condition.target).waitFor({ state: condition.kind, timeout: timeoutMs });
+    } else if (condition.kind === "enabled") {
+      const locator = toPlaywrightLocator(page, condition.target);
+      await locator.waitFor({ state: "visible", timeout: timeoutMs });
+      await page.waitForFunction((element) => !element.disabled && element.getAttribute("aria-disabled") !== "true", await locator.elementHandle(), { timeout: timeoutMs });
+    } else if (condition.kind === "app_idle") {
+      lastObserved = await readAutomationSnapshot(page);
+      if (!await waitForRendererIdle(page, { timeoutMs })) throw new Error("Renderer did not become idle.");
+    } else if (condition.kind === "url") {
+      while (!matchesUrl(lastObserved = page.url(), condition.value, condition.match)) {
+        if (Date.now() - started >= timeoutMs) throw new Error("URL did not match.");
+        await page.waitForTimeout(25);
+      }
+    } else if (condition.kind === "route") {
+      while (true) {
+        const snapshot = await readAutomationSnapshot(page);
+        lastObserved = snapshot?.currentRoute ?? null;
+        const route = snapshot?.currentRoute;
+        const includes = (wanted, actual) => !wanted || Object.entries(wanted).every(([key, value]) => actual[key] === value);
+        if (route?.page === condition.page && includes(condition.params, route.params) && includes(condition.query, route.query)) break;
+        if (Date.now() - started >= timeoutMs) throw new Error("Route did not match.");
+        await page.waitForTimeout(25);
+      }
+    } else if (condition.kind === "scroll_edge") {
+      const locator = condition.container.kind === "locator" ? toPlaywrightLocator(page, condition.container.target) : null;
+      await page.waitForFunction(({ element, edge }) => {
+        const node = element ?? document.scrollingElement ?? document.documentElement;
+        return edge === "top" ? node.scrollTop <= 0 : edge === "bottom" ? node.scrollTop + node.clientHeight >= node.scrollHeight - 1 : edge === "left" ? node.scrollLeft <= 0 : node.scrollLeft + node.clientWidth >= node.scrollWidth - 1;
+      }, { element: locator ? await locator.elementHandle() : null, edge: condition.edge }, { timeout: timeoutMs });
+    } else {
+      const locator = condition.target ? toPlaywrightLocator(page, condition.target) : null;
+      lastObserved = await page.evaluate(async ({ element, frames }) => {
+        const target = element;
+        let previous = target?.getBoundingClientRect() ?? { x: 0, y: 0, width: innerWidth, height: innerHeight };
+        let stable = 0;
+        while (stable < frames) {
+          await new Promise((resolve) => requestAnimationFrame(() => resolve()));
+          const next = target?.getBoundingClientRect() ?? { x: 0, y: 0, width: innerWidth, height: innerHeight };
+          stable = next.x === previous.x && next.y === previous.y && next.width === previous.width && next.height === previous.height ? stable + 1 : 0;
+          previous = next;
+        }
+        return { x: previous.x, y: previous.y, width: previous.width, height: previous.height, stableFrames: stable };
+      }, { element: locator ? await locator.elementHandle() : null, frames: condition.kind === "visual_stable" ? condition.frames ?? 3 : 3 });
+    }
+    return automationOk({ waitedMs: Date.now() - started });
+  } catch (error) {
+    return automationError("ACTION_FAILED", `Timed out waiting for ${condition.kind} after ${timeoutMs}ms.`, { details: { timeoutMs, lastObserved, cause: error instanceof Error ? error.message : String(error) } });
+  }
+}
+export {
+  awaitCondition,
+  matchesUrl
+};
+//# sourceMappingURL=waits_executor.js.map

package/dist/automation/waits_executor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/waits_executor.ts"],"sourcesContent":["import type { Page } from 'playwright';\nimport { automationError, automationOk, type WoodAutomationResult } from './errors.js';\nimport { readAutomationSnapshot, waitForRendererIdle } from './introspection_reader.js';\nimport { toPlaywrightLocator } from './locator.js';\nimport type { WoodWaitCondition } from './waits.js';\n\nconst DEFAULT_TIMEOUT_MS = 5_000;\n\nexport function matchesUrl(actual: string, expected: string, match: 'exact' | 'glob' | 'regex' = 'exact'): boolean {\n  if (match === 'exact') return actual === expected;\n  if (match === 'regex') {\n    try { return new RegExp(expected).test(actual); } catch { return false; }\n  }\n  const escaped = expected.replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&').replace(/\\*/g, '.*').replace(/\\?/g, '.');\n  return new RegExp(`^${escaped}$`).test(actual);\n}\n\nexport async function awaitCondition(page: Page, condition: WoodWaitCondition, options?: { timeoutMs?: number }): Promise<WoodAutomationResult<{ waitedMs: number }>> {\n  const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const started = Date.now();\n  let lastObserved: unknown = null;\n  if (condition.kind === 'trace' || condition.kind === 'target') {\n    return automationError('UNSUPPORTED', `${condition.kind} waits require an unavailable ${condition.kind} observation capability.`, { details: { capability: condition.kind, lastObserved } });\n  }\n  try {\n    if (condition.kind === 'visible' || condition.kind === 'hidden' || condition.kind === 'attached' || condition.kind === 'detached') {\n      await toPlaywrightLocator(page, condition.target).waitFor({ state: condition.kind, timeout: timeoutMs });\n    } else if (condition.kind === 'enabled') {\n      const locator = toPlaywrightLocator(page, condition.target);\n      await locator.waitFor({ state: 'visible', timeout: timeoutMs });\n      await page.waitForFunction((element) => !(element as HTMLInputElement).disabled && element.getAttribute('aria-disabled') !== 'true', await locator.elementHandle(), { timeout: timeoutMs });\n    } else if (condition.kind === 'app_idle') {\n      lastObserved = await readAutomationSnapshot(page);\n      if (!(await waitForRendererIdle(page, { timeoutMs }))) throw new Error('Renderer did not become idle.');\n    } else if (condition.kind === 'url') {\n      while (!matchesUrl(lastObserved = page.url(), condition.value, condition.match)) {\n        if (Date.now() - started >= timeoutMs) throw new Error('URL did not match.');\n        await page.waitForTimeout(25);\n      }\n    } else if (condition.kind === 'route') {\n      while (true) {\n        const snapshot = await readAutomationSnapshot(page);\n        lastObserved = snapshot?.currentRoute ?? null;\n        const route = snapshot?.currentRoute;\n        const includes = (wanted: Record<string, string> | undefined, actual: Record<string, string>) =>\n          !wanted || Object.entries(wanted).every(([key, value]) => actual[key] === value);\n        if (route?.page === condition.page && includes(condition.params, route.params) && includes(condition.query, route.query)) break;\n        if (Date.now() - started >= timeoutMs) throw new Error('Route did not match.');\n        await page.waitForTimeout(25);\n      }\n    } else if (condition.kind === 'scroll_edge') {\n      const locator = condition.container.kind === 'locator' ? toPlaywrightLocator(page, condition.container.target) : null;\n      await page.waitForFunction(({ element, edge }) => {\n        const node = (element as HTMLElement | null) ?? document.scrollingElement ?? document.documentElement;\n        return edge === 'top' ? node.scrollTop <= 0 : edge === 'bottom' ? node.scrollTop + node.clientHeight >= node.scrollHeight - 1 : edge === 'left' ? node.scrollLeft <= 0 : node.scrollLeft + node.clientWidth >= node.scrollWidth - 1;\n      }, { element: locator ? await locator.elementHandle() : null, edge: condition.edge }, { timeout: timeoutMs });\n    } else {\n      const locator = condition.target ? toPlaywrightLocator(page, condition.target) : null;\n      lastObserved = await page.evaluate(async ({ element, frames }) => {\n        const target = element as Element | null;\n        let previous = target?.getBoundingClientRect() ?? { x: 0, y: 0, width: innerWidth, height: innerHeight };\n        let stable = 0;\n        while (stable < frames) {\n          await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));\n          const next = target?.getBoundingClientRect() ?? { x: 0, y: 0, width: innerWidth, height: innerHeight };\n          stable = next.x === previous.x && next.y === previous.y && next.width === previous.width && next.height === previous.height ? stable + 1 : 0;\n          previous = next;\n        }\n        return { x: previous.x, y: previous.y, width: previous.width, height: previous.height, stableFrames: stable };\n      }, { element: locator ? await locator.elementHandle() : null, frames: condition.kind === 'visual_stable' ? condition.frames ?? 3 : 3 });\n    }\n    return automationOk({ waitedMs: Date.now() - started });\n  } catch (error) {\n    return automationError('ACTION_FAILED', `Timed out waiting for ${condition.kind} after ${timeoutMs}ms.`, { details: { timeoutMs, lastObserved, cause: error instanceof Error ? error.message : String(error) } });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/client/index.d.cts

@@ -6,6 +6,7 @@ export { FrameworkTracer, TraceProvider, TraceProviderConfiguration, TraceProvid
 export { ControllerEvents, ControllerInput, ControllerState, PageController } from './controller_contract.cjs';
 export { ControllerLifecycle } from '../controller/controller_lifecycle.cjs';
 export { WoodAppEnv } from '../runtime/app_env.cjs';
+import '../navigation/automation_introspection.cjs';
 import '../ipc/shared.cjs';
 import 'rxjs';
 import '@noego/ioc';

package/dist/client/index.d.ts

@@ -6,6 +6,7 @@ export { FrameworkTracer, TraceProvider, TraceProviderConfiguration, TraceProvid
 export { ControllerEvents, ControllerInput, ControllerState, PageController } from './controller_contract.js';
 export { ControllerLifecycle } from '../controller/controller_lifecycle.js';
 export { WoodAppEnv } from '../runtime/app_env.js';
+import '../navigation/automation_introspection.js';
 import '../ipc/shared.js';
 import 'rxjs';
 import '@noego/ioc';

package/dist/codegen/renderer_app_generator.cjs

@@ -215,7 +215,7 @@ function generateRendererApp(views, options) {
   return `${(0, import_generated_file_notice.generatedFileNotice)(RENDERER_APP_SOURCE_INSTRUCTIONS)}
 import { mount } from 'svelte';
 import { App, getApp, getContainer } from '@noego/wood/client';
-import { Navigation, getNavigation } from '@noego/wood/navigation';
+import { Navigation, getNavigation, installAutomationIntrospection } from '@noego/wood/navigation';
 import { Ipc, getIpc } from '@noego/wood/ipc';
 import NavigationShell from '@noego/wood/navigation-shell';
 ${importLines.join("\n")}
@@ -389,10 +389,25 @@ async function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {
   return entry;
 }
 
+function isAutomationBuild(): boolean {
+  try {
+    const env = (import.meta as { env?: { DEV?: boolean; MODE?: string } }).env;
+    return Boolean(env?.DEV) || env?.MODE === 'test';
+  } catch {
+    return false;
+  }
+}
+
 export async function app(target: Element) {
   const entry = await resolveInitialEntry();
 
   getNavigation().replace(entry.key, {}, {});
+
+  // Dev/test-only Axe introspection surface; never present in production builds.
+  if (isAutomationBuild()) {
+    const bootstrapWindow = await getWoodBridge()?.__window?.current?.();
+    installAutomationIntrospection({ windowId: bootstrapWindow?.windowId ?? null });
+  }
   const controller = await createViewController(entry);
   const layoutControllers = await createLayoutControllers(entry);
 

package/dist/codegen/renderer_app_generator.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/renderer_app_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { ViewDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst RENDERER_APP_SOURCE_INSTRUCTIONS = [\n  'To change routes, page components, layouts, or renderer controllers, edit the views YAML',\n  'configured by wood.config.yml renderer.openapi and the matching UI source files.',\n] as const;\n\nexport interface RendererAppGeneratorOptions {\n  /** Absolute path to renderer component root (e.g. /app/ui) */\n  componentDir: string;\n  /** Absolute output directory where generated file will be written */\n  outDir: string;\n  /** Optional explicit default view key (e.g. \"main.chat\") */\n  entryViewKey?: string;\n}\n\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  return rel.replace(/\\\\/g, '/');\n}\n\nfunction resolveFromComponentDir(componentDir: string, fileRef: string): string {\n  if (path.isAbsolute(fileRef)) {\n    return fileRef;\n  }\n\n  const normalizedRef = fileRef.replace(/\\\\/g, '/');\n  const componentDirName = path.basename(componentDir).replace(/\\\\/g, '/');\n\n  if (normalizedRef.startsWith(componentDirName + '/')) {\n    const stripped = normalizedRef.slice(componentDirName.length + 1);\n    return path.resolve(componentDir, stripped);\n  }\n\n  return path.resolve(componentDir, normalizedRef);\n}\n\nfunction viewKey(view: ViewDef): string {\n  return `${view.windowName}.${view.pageName}`;\n}\n\nfunction toIdentifier(prefix: string, value: string): string {\n  const core = value\n    .replace(/[^a-zA-Z0-9]+/g, ' ')\n    .trim()\n    .split(/\\s+/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return `${prefix}${core || 'Component'}`;\n}\n\nfunction escapeSingleQuoted(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n\nconst CONTROLLER_FILE_SUFFIXES = [\n  '.ts',\n  '.js',\n  '.controller.ts',\n  '.controller.js',\n] as const;\n\nconst CONTROLLER_INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\nfunction resolveControllerFile(controllerRef: string, componentDir: string): string | null {\n  const normalized = controllerRef.trim();\n  const basePath = resolveFromComponentDir(componentDir, normalized);\n\n  if (existsSync(basePath)) {\n    return basePath;\n  }\n\n  if (path.extname(basePath)) {\n    return null;\n  }\n\n  for (const suffix of CONTROLLER_FILE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  for (const indexFile of CONTROLLER_INDEX_CANDIDATES) {\n    const candidate = path.resolve(basePath, indexFile);\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveDefaultViewKey(sortedViews: ViewDef[], entryViewKey?: string): string {\n  if (sortedViews.length === 0) return '';\n\n  const configuredEntry = entryViewKey?.trim();\n  if (!configuredEntry) {\n    return viewKey(sortedViews[0]);\n  }\n\n  const availableKeys = sortedViews.map((view) => viewKey(view));\n  if (availableKeys.includes(configuredEntry)) {\n    return configuredEntry;\n  }\n\n  throw new Error(\n    `Renderer entry \"${configuredEntry}\" was not found in parsed views. Available view keys: ${availableKeys.join(', ')}`,\n  );\n}\n\nexport function generateRendererApp(\n  views: ViewDef[],\n  options: RendererAppGeneratorOptions,\n): string {\n  const sortedViews = [...views].sort((a, b) => viewKey(a).localeCompare(viewKey(b)));\n  const defaultViewKey = resolveDefaultViewKey(sortedViews, options.entryViewKey);\n\n  const importLines: string[] = [];\n  const viewIdentifiers = new Map<string, string>();\n  const layoutIdentifiers = new Map<string, string>();\n  const controllerIdentifiers = new Map<string, { identifier: string; importPath: string }>();\n  const usedNames = new Set<string>();\n\n  const allocateName = (prefix: string, filePath: string): string => {\n    const base = toIdentifier(prefix, filePath);\n    let name = base;\n    let suffix = 2;\n    while (usedNames.has(name)) {\n      name = `${base}${suffix}`;\n      suffix += 1;\n    }\n    usedNames.add(name);\n    return name;\n  };\n\n  const ensureControllerImported = (controllerRef: string, owningViewKey: string): void => {\n    if (controllerIdentifiers.has(controllerRef)) return;\n\n    const resolvedControllerFile = resolveControllerFile(controllerRef, options.componentDir);\n    if (!resolvedControllerFile) {\n      throw new Error(\n        `Renderer app codegen failed: controller \"${controllerRef}\" for view \"${owningViewKey}\" was not found. ` +\n        'Controller must point to an existing file with a default exported class.',\n      );\n    }\n\n    const identifier = allocateName('PageController', controllerRef);\n    const importPath = computeImportPath(options.outDir, resolvedControllerFile);\n    controllerIdentifiers.set(controllerRef, { identifier, importPath });\n    importLines.push(`import ${identifier} from '${importPath}';`);\n  };\n\n  for (const view of sortedViews) {\n    if (!viewIdentifiers.has(view.viewPath)) {\n      const identifier = allocateName('View', view.viewPath);\n      viewIdentifiers.set(view.viewPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, view.viewPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    for (const layoutPath of view.layouts) {\n      if (layoutIdentifiers.has(layoutPath)) continue;\n      const identifier = allocateName('Layout', layoutPath);\n      layoutIdentifiers.set(layoutPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, layoutPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    if (view.controller) {\n      ensureControllerImported(view.controller, viewKey(view));\n    }\n\n    for (const layoutController of view.layoutControllers ?? []) {\n      if (!layoutController) continue;\n      ensureControllerImported(layoutController, viewKey(view));\n    }\n  }\n\n  const manifestEntries = sortedViews.map((view) => {\n    const key = viewKey(view);\n    const viewIdentifier = viewIdentifiers.get(view.viewPath)!;\n    const layoutList = view.layouts.map((layoutPath) => layoutIdentifiers.get(layoutPath)!);\n    const controllerPath = view.controller ? `'${escapeSingleQuoted(view.controller)}'` : 'undefined';\n    const controllerClass = view.controller\n      ? controllerIdentifiers.get(view.controller)!.identifier\n      : 'undefined';\n    const layoutControllerRefs = view.layoutControllers;\n    if (layoutControllerRefs && layoutControllerRefs.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout controller count for view \"${key}\" does not match layout count.`,\n      );\n    }\n    const normalizedLayoutControllerRefs = layoutControllerRefs ?? Array.from(\n      { length: view.layouts.length },\n      () => undefined,\n    );\n    const layoutControllerPaths = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? `'${escapeSingleQuoted(controllerRef)}'` : 'undefined'))\n      .join(', ')}]`;\n    const layoutControllerClasses = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? controllerIdentifiers.get(controllerRef)!.identifier : 'undefined'))\n      .join(', ')}]`;\n    const layoutPreserve = view.layoutPreserve ?? Array.from(\n      { length: view.layouts.length },\n      () => false,\n    );\n    if (layoutPreserve.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout preserve count for view \"${key}\" does not match layout count.`,\n      );\n    }\n\n    return `  '${escapeSingleQuoted(key)}': {\n    key: '${escapeSingleQuoted(key)}',\n    windowName: '${escapeSingleQuoted(view.windowName)}',\n    pageName: '${escapeSingleQuoted(view.pageName)}',\n    viewPath: '${escapeSingleQuoted(view.viewPath)}',\n    layoutPaths: ${JSON.stringify(view.layouts)},\n    layoutControllers: ${layoutControllerPaths},\n    layoutPreserve: ${JSON.stringify(layoutPreserve)},\n    controller: ${controllerPath},\n    layoutControllerClasses: ${layoutControllerClasses},\n    controllerClass: ${controllerClass},\n    view: ${viewIdentifier},\n    layouts: [${layoutList.join(', ')}],\n  },`;\n  });\n\n  return `${generatedFileNotice(RENDERER_APP_SOURCE_INSTRUCTIONS)}\nimport { mount } from 'svelte';\nimport { App, getApp, getContainer } from '@noego/wood/client';\nimport { Navigation, getNavigation } from '@noego/wood/navigation';\nimport { Ipc, getIpc } from '@noego/wood/ipc';\nimport NavigationShell from '@noego/wood/navigation-shell';\n${importLines.join('\\n')}\n\ninterface GeneratedAppViewEntry {\n  key: string;\n  windowName: string;\n  pageName: string;\n  viewPath: string;\n  layoutPaths: string[];\n  layoutControllers: Array<string | undefined>;\n  layoutPreserve: boolean[];\n  controller?: string;\n  layoutControllerClasses: Array<any | undefined>;\n  controllerClass?: any;\n  view: any;\n  layouts: any[];\n}\n\nconst VIEW_MANIFEST: Record<string, GeneratedAppViewEntry> = {\n${manifestEntries.join('\\n')}\n};\n\nfunction getViewManifestEntry(viewKey: string): GeneratedAppViewEntry | null {\n  return VIEW_MANIFEST[viewKey] ?? null;\n}\n\ninterface WoodScopedContainer {\n  get(token: any): unknown | Promise<unknown>;\n  registerClass?(token: any): void;\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\ninterface WoodContainer extends WoodScopedContainer {\n  extend?(): WoodScopedContainer;\n}\n\nfunction createScopedContainer(): WoodScopedContainer {\n  const container = getContainer() as WoodContainer;\n  if (typeof container.extend !== 'function') {\n    throw new Error('Wood client container does not support extend().');\n  }\n\n  const scopedContainer = container.extend();\n\n  if (!scopedContainer || typeof scopedContainer.get !== 'function') {\n    throw new Error('Wood client container does not support get().');\n  }\n\n  if (typeof scopedContainer.registerFunction === 'function') {\n    scopedContainer.registerFunction(Navigation, () => getNavigation());\n    scopedContainer.registerFunction(App, () => getApp());\n    scopedContainer.registerFunction(Ipc, () => getIpc());\n  }\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveController(\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\n  const scopedContainer = createScopedContainer();\n\n  if (typeof ControllerClass !== 'function') {\n    throw new Error(\n      \\`Controller for \\${contextLabel} in view \"\\${entry.key}\" is invalid. Expected a default exported class.\\`,\n    );\n  }\n\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(ControllerClass);\n  }\n\n  return await scopedContainer.get(ControllerClass);\n}\n\nasync function createViewController(\n  entry: GeneratedAppViewEntry,\n): Promise<unknown> {\n  if (!entry.controllerClass) {\n    return undefined;\n  }\n\n  return await resolveController(entry, entry.controllerClass, 'page');\n}\n\nasync function createLayoutControllers(\n  entry: GeneratedAppViewEntry,\n  startIndex = 0,\n): Promise<Array<unknown>> {\n  const controllers: unknown[] = [];\n\n  for (let i = 0; i < startIndex; i += 1) {\n    controllers.push(undefined);\n  }\n\n  for (let i = startIndex; i < entry.layoutControllerClasses.length; i += 1) {\n    const LayoutController = entry.layoutControllerClasses[i];\n    if (!LayoutController) {\n      controllers.push(undefined);\n      continue;\n    }\n    const controller = await resolveController(\n      entry,\n      LayoutController,\n      \\`layout[\\${i}]\\`,\n    );\n    controllers.push(controller);\n  }\n\n  return controllers;\n}\n\nconst DEFAULT_VIEW_KEY = '${escapeSingleQuoted(defaultViewKey)}';\n\ntype WoodWindowBootstrapInfo = {\n  ok?: boolean;\n  windowId?: string;\n  defaultRoute?: string;\n};\n\ntype WoodBootstrapBridgeLike = {\n  __window?: {\n    current?: () => Promise<WoodWindowBootstrapInfo>;\n  };\n};\n\nfunction getWoodBridge(): WoodBootstrapBridgeLike | null {\n  const globalObj = globalThis as typeof globalThis & {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    window?: {\n      __NOEGO_WOOD_BRIDGE__?: unknown;\n    };\n  };\n\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__ ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n\n  return bridge as WoodBootstrapBridgeLike;\n}\n\nasync function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {\n  if (!DEFAULT_VIEW_KEY) {\n    throw new Error('No views available in renderer manifest. Define at least one view in renderer OpenAPI YAML.');\n  }\n\n  const bridge = getWoodBridge();\n  const bootstrapWindow = await bridge?.__window?.current?.();\n  const requestedRoute = bootstrapWindow?.defaultRoute;\n\n  if (requestedRoute) {\n    const routeEntry = getViewManifestEntry(requestedRoute);\n    if (routeEntry) {\n      return routeEntry;\n    }\n  }\n\n  const entry = getViewManifestEntry(DEFAULT_VIEW_KEY);\n  if (!entry) {\n    throw new Error(\\`Default view \"\\${DEFAULT_VIEW_KEY}\" is missing from generated view manifest.\\`);\n  }\n\n  return entry;\n}\n\nexport async function app(target: Element) {\n  const entry = await resolveInitialEntry();\n\n  getNavigation().replace(entry.key, {}, {});\n  const controller = await createViewController(entry);\n  const layoutControllers = await createLayoutControllers(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialController: controller,\n      initialLayoutControllers: layoutControllers,\n      createViewControllerFn: createViewController,\n      createLayoutControllersFn: createLayoutControllers,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../../src/codegen/renderer_app_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { ViewDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst RENDERER_APP_SOURCE_INSTRUCTIONS = [\n  'To change routes, page components, layouts, or renderer controllers, edit the views YAML',\n  'configured by wood.config.yml renderer.openapi and the matching UI source files.',\n] as const;\n\nexport interface RendererAppGeneratorOptions {\n  /** Absolute path to renderer component root (e.g. /app/ui) */\n  componentDir: string;\n  /** Absolute output directory where generated file will be written */\n  outDir: string;\n  /** Optional explicit default view key (e.g. \"main.chat\") */\n  entryViewKey?: string;\n}\n\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  return rel.replace(/\\\\/g, '/');\n}\n\nfunction resolveFromComponentDir(componentDir: string, fileRef: string): string {\n  if (path.isAbsolute(fileRef)) {\n    return fileRef;\n  }\n\n  const normalizedRef = fileRef.replace(/\\\\/g, '/');\n  const componentDirName = path.basename(componentDir).replace(/\\\\/g, '/');\n\n  if (normalizedRef.startsWith(componentDirName + '/')) {\n    const stripped = normalizedRef.slice(componentDirName.length + 1);\n    return path.resolve(componentDir, stripped);\n  }\n\n  return path.resolve(componentDir, normalizedRef);\n}\n\nfunction viewKey(view: ViewDef): string {\n  return `${view.windowName}.${view.pageName}`;\n}\n\nfunction toIdentifier(prefix: string, value: string): string {\n  const core = value\n    .replace(/[^a-zA-Z0-9]+/g, ' ')\n    .trim()\n    .split(/\\s+/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return `${prefix}${core || 'Component'}`;\n}\n\nfunction escapeSingleQuoted(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n\nconst CONTROLLER_FILE_SUFFIXES = [\n  '.ts',\n  '.js',\n  '.controller.ts',\n  '.controller.js',\n] as const;\n\nconst CONTROLLER_INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\nfunction resolveControllerFile(controllerRef: string, componentDir: string): string | null {\n  const normalized = controllerRef.trim();\n  const basePath = resolveFromComponentDir(componentDir, normalized);\n\n  if (existsSync(basePath)) {\n    return basePath;\n  }\n\n  if (path.extname(basePath)) {\n    return null;\n  }\n\n  for (const suffix of CONTROLLER_FILE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  for (const indexFile of CONTROLLER_INDEX_CANDIDATES) {\n    const candidate = path.resolve(basePath, indexFile);\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveDefaultViewKey(sortedViews: ViewDef[], entryViewKey?: string): string {\n  if (sortedViews.length === 0) return '';\n\n  const configuredEntry = entryViewKey?.trim();\n  if (!configuredEntry) {\n    return viewKey(sortedViews[0]);\n  }\n\n  const availableKeys = sortedViews.map((view) => viewKey(view));\n  if (availableKeys.includes(configuredEntry)) {\n    return configuredEntry;\n  }\n\n  throw new Error(\n    `Renderer entry \"${configuredEntry}\" was not found in parsed views. Available view keys: ${availableKeys.join(', ')}`,\n  );\n}\n\nexport function generateRendererApp(\n  views: ViewDef[],\n  options: RendererAppGeneratorOptions,\n): string {\n  const sortedViews = [...views].sort((a, b) => viewKey(a).localeCompare(viewKey(b)));\n  const defaultViewKey = resolveDefaultViewKey(sortedViews, options.entryViewKey);\n\n  const importLines: string[] = [];\n  const viewIdentifiers = new Map<string, string>();\n  const layoutIdentifiers = new Map<string, string>();\n  const controllerIdentifiers = new Map<string, { identifier: string; importPath: string }>();\n  const usedNames = new Set<string>();\n\n  const allocateName = (prefix: string, filePath: string): string => {\n    const base = toIdentifier(prefix, filePath);\n    let name = base;\n    let suffix = 2;\n    while (usedNames.has(name)) {\n      name = `${base}${suffix}`;\n      suffix += 1;\n    }\n    usedNames.add(name);\n    return name;\n  };\n\n  const ensureControllerImported = (controllerRef: string, owningViewKey: string): void => {\n    if (controllerIdentifiers.has(controllerRef)) return;\n\n    const resolvedControllerFile = resolveControllerFile(controllerRef, options.componentDir);\n    if (!resolvedControllerFile) {\n      throw new Error(\n        `Renderer app codegen failed: controller \"${controllerRef}\" for view \"${owningViewKey}\" was not found. ` +\n        'Controller must point to an existing file with a default exported class.',\n      );\n    }\n\n    const identifier = allocateName('PageController', controllerRef);\n    const importPath = computeImportPath(options.outDir, resolvedControllerFile);\n    controllerIdentifiers.set(controllerRef, { identifier, importPath });\n    importLines.push(`import ${identifier} from '${importPath}';`);\n  };\n\n  for (const view of sortedViews) {\n    if (!viewIdentifiers.has(view.viewPath)) {\n      const identifier = allocateName('View', view.viewPath);\n      viewIdentifiers.set(view.viewPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, view.viewPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    for (const layoutPath of view.layouts) {\n      if (layoutIdentifiers.has(layoutPath)) continue;\n      const identifier = allocateName('Layout', layoutPath);\n      layoutIdentifiers.set(layoutPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, layoutPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    if (view.controller) {\n      ensureControllerImported(view.controller, viewKey(view));\n    }\n\n    for (const layoutController of view.layoutControllers ?? []) {\n      if (!layoutController) continue;\n      ensureControllerImported(layoutController, viewKey(view));\n    }\n  }\n\n  const manifestEntries = sortedViews.map((view) => {\n    const key = viewKey(view);\n    const viewIdentifier = viewIdentifiers.get(view.viewPath)!;\n    const layoutList = view.layouts.map((layoutPath) => layoutIdentifiers.get(layoutPath)!);\n    const controllerPath = view.controller ? `'${escapeSingleQuoted(view.controller)}'` : 'undefined';\n    const controllerClass = view.controller\n      ? controllerIdentifiers.get(view.controller)!.identifier\n      : 'undefined';\n    const layoutControllerRefs = view.layoutControllers;\n    if (layoutControllerRefs && layoutControllerRefs.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout controller count for view \"${key}\" does not match layout count.`,\n      );\n    }\n    const normalizedLayoutControllerRefs = layoutControllerRefs ?? Array.from(\n      { length: view.layouts.length },\n      () => undefined,\n    );\n    const layoutControllerPaths = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? `'${escapeSingleQuoted(controllerRef)}'` : 'undefined'))\n      .join(', ')}]`;\n    const layoutControllerClasses = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? controllerIdentifiers.get(controllerRef)!.identifier : 'undefined'))\n      .join(', ')}]`;\n    const layoutPreserve = view.layoutPreserve ?? Array.from(\n      { length: view.layouts.length },\n      () => false,\n    );\n    if (layoutPreserve.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout preserve count for view \"${key}\" does not match layout count.`,\n      );\n    }\n\n    return `  '${escapeSingleQuoted(key)}': {\n    key: '${escapeSingleQuoted(key)}',\n    windowName: '${escapeSingleQuoted(view.windowName)}',\n    pageName: '${escapeSingleQuoted(view.pageName)}',\n    viewPath: '${escapeSingleQuoted(view.viewPath)}',\n    layoutPaths: ${JSON.stringify(view.layouts)},\n    layoutControllers: ${layoutControllerPaths},\n    layoutPreserve: ${JSON.stringify(layoutPreserve)},\n    controller: ${controllerPath},\n    layoutControllerClasses: ${layoutControllerClasses},\n    controllerClass: ${controllerClass},\n    view: ${viewIdentifier},\n    layouts: [${layoutList.join(', ')}],\n  },`;\n  });\n\n  return `${generatedFileNotice(RENDERER_APP_SOURCE_INSTRUCTIONS)}\nimport { mount } from 'svelte';\nimport { App, getApp, getContainer } from '@noego/wood/client';\nimport { Navigation, getNavigation, installAutomationIntrospection } from '@noego/wood/navigation';\nimport { Ipc, getIpc } from '@noego/wood/ipc';\nimport NavigationShell from '@noego/wood/navigation-shell';\n${importLines.join('\\n')}\n\ninterface GeneratedAppViewEntry {\n  key: string;\n  windowName: string;\n  pageName: string;\n  viewPath: string;\n  layoutPaths: string[];\n  layoutControllers: Array<string | undefined>;\n  layoutPreserve: boolean[];\n  controller?: string;\n  layoutControllerClasses: Array<any | undefined>;\n  controllerClass?: any;\n  view: any;\n  layouts: any[];\n}\n\nconst VIEW_MANIFEST: Record<string, GeneratedAppViewEntry> = {\n${manifestEntries.join('\\n')}\n};\n\nfunction getViewManifestEntry(viewKey: string): GeneratedAppViewEntry | null {\n  return VIEW_MANIFEST[viewKey] ?? null;\n}\n\ninterface WoodScopedContainer {\n  get(token: any): unknown | Promise<unknown>;\n  registerClass?(token: any): void;\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\ninterface WoodContainer extends WoodScopedContainer {\n  extend?(): WoodScopedContainer;\n}\n\nfunction createScopedContainer(): WoodScopedContainer {\n  const container = getContainer() as WoodContainer;\n  if (typeof container.extend !== 'function') {\n    throw new Error('Wood client container does not support extend().');\n  }\n\n  const scopedContainer = container.extend();\n\n  if (!scopedContainer || typeof scopedContainer.get !== 'function') {\n    throw new Error('Wood client container does not support get().');\n  }\n\n  if (typeof scopedContainer.registerFunction === 'function') {\n    scopedContainer.registerFunction(Navigation, () => getNavigation());\n    scopedContainer.registerFunction(App, () => getApp());\n    scopedContainer.registerFunction(Ipc, () => getIpc());\n  }\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveController(\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\n  const scopedContainer = createScopedContainer();\n\n  if (typeof ControllerClass !== 'function') {\n    throw new Error(\n      \\`Controller for \\${contextLabel} in view \"\\${entry.key}\" is invalid. Expected a default exported class.\\`,\n    );\n  }\n\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(ControllerClass);\n  }\n\n  return await scopedContainer.get(ControllerClass);\n}\n\nasync function createViewController(\n  entry: GeneratedAppViewEntry,\n): Promise<unknown> {\n  if (!entry.controllerClass) {\n    return undefined;\n  }\n\n  return await resolveController(entry, entry.controllerClass, 'page');\n}\n\nasync function createLayoutControllers(\n  entry: GeneratedAppViewEntry,\n  startIndex = 0,\n): Promise<Array<unknown>> {\n  const controllers: unknown[] = [];\n\n  for (let i = 0; i < startIndex; i += 1) {\n    controllers.push(undefined);\n  }\n\n  for (let i = startIndex; i < entry.layoutControllerClasses.length; i += 1) {\n    const LayoutController = entry.layoutControllerClasses[i];\n    if (!LayoutController) {\n      controllers.push(undefined);\n      continue;\n    }\n    const controller = await resolveController(\n      entry,\n      LayoutController,\n      \\`layout[\\${i}]\\`,\n    );\n    controllers.push(controller);\n  }\n\n  return controllers;\n}\n\nconst DEFAULT_VIEW_KEY = '${escapeSingleQuoted(defaultViewKey)}';\n\ntype WoodWindowBootstrapInfo = {\n  ok?: boolean;\n  windowId?: string;\n  defaultRoute?: string;\n};\n\ntype WoodBootstrapBridgeLike = {\n  __window?: {\n    current?: () => Promise<WoodWindowBootstrapInfo>;\n  };\n};\n\nfunction getWoodBridge(): WoodBootstrapBridgeLike | null {\n  const globalObj = globalThis as typeof globalThis & {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    window?: {\n      __NOEGO_WOOD_BRIDGE__?: unknown;\n    };\n  };\n\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__ ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n\n  return bridge as WoodBootstrapBridgeLike;\n}\n\nasync function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {\n  if (!DEFAULT_VIEW_KEY) {\n    throw new Error('No views available in renderer manifest. Define at least one view in renderer OpenAPI YAML.');\n  }\n\n  const bridge = getWoodBridge();\n  const bootstrapWindow = await bridge?.__window?.current?.();\n  const requestedRoute = bootstrapWindow?.defaultRoute;\n\n  if (requestedRoute) {\n    const routeEntry = getViewManifestEntry(requestedRoute);\n    if (routeEntry) {\n      return routeEntry;\n    }\n  }\n\n  const entry = getViewManifestEntry(DEFAULT_VIEW_KEY);\n  if (!entry) {\n    throw new Error(\\`Default view \"\\${DEFAULT_VIEW_KEY}\" is missing from generated view manifest.\\`);\n  }\n\n  return entry;\n}\n\nfunction isAutomationBuild(): boolean {\n  try {\n    const env = (import.meta as { env?: { DEV?: boolean; MODE?: string } }).env;\n    return Boolean(env?.DEV) || env?.MODE === 'test';\n  } catch {\n    return false;\n  }\n}\n\nexport async function app(target: Element) {\n  const entry = await resolveInitialEntry();\n\n  getNavigation().replace(entry.key, {}, {});\n\n  // Dev/test-only Axe introspection surface; never present in production builds.\n  if (isAutomationBuild()) {\n    const bootstrapWindow = await getWoodBridge()?.__window?.current?.();\n    installAutomationIntrospection({ windowId: bootstrapWindow?.windowId ?? null });\n  }\n  const controller = await createViewController(entry);\n  const layoutControllers = await createLayoutControllers(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialController: controller,\n      initialLayoutControllers: layoutControllers,\n      createViewControllerFn: createViewController,\n      createLayoutControllersFn: createLayoutControllers,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"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","names":["path"]}

package/dist/codegen/renderer_app_generator.js

@@ -182,7 +182,7 @@ function generateRendererApp(views, options) {
   return `${generatedFileNotice(RENDERER_APP_SOURCE_INSTRUCTIONS)}
 import { mount } from 'svelte';
 import { App, getApp, getContainer } from '@noego/wood/client';
-import { Navigation, getNavigation } from '@noego/wood/navigation';
+import { Navigation, getNavigation, installAutomationIntrospection } from '@noego/wood/navigation';
 import { Ipc, getIpc } from '@noego/wood/ipc';
 import NavigationShell from '@noego/wood/navigation-shell';
 ${importLines.join("\n")}
@@ -356,10 +356,25 @@ async function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {
   return entry;
 }
 
+function isAutomationBuild(): boolean {
+  try {
+    const env = (import.meta as { env?: { DEV?: boolean; MODE?: string } }).env;
+    return Boolean(env?.DEV) || env?.MODE === 'test';
+  } catch {
+    return false;
+  }
+}
+
 export async function app(target: Element) {
   const entry = await resolveInitialEntry();
 
   getNavigation().replace(entry.key, {}, {});
+
+  // Dev/test-only Axe introspection surface; never present in production builds.
+  if (isAutomationBuild()) {
+    const bootstrapWindow = await getWoodBridge()?.__window?.current?.();
+    installAutomationIntrospection({ windowId: bootstrapWindow?.windowId ?? null });
+  }
   const controller = await createViewController(entry);
   const layoutControllers = await createLayoutControllers(entry);
 

package/dist/codegen/renderer_app_generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/renderer_app_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { ViewDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst RENDERER_APP_SOURCE_INSTRUCTIONS = [\n  'To change routes, page components, layouts, or renderer controllers, edit the views YAML',\n  'configured by wood.config.yml renderer.openapi and the matching UI source files.',\n] as const;\n\nexport interface RendererAppGeneratorOptions {\n  /** Absolute path to renderer component root (e.g. /app/ui) */\n  componentDir: string;\n  /** Absolute output directory where generated file will be written */\n  outDir: string;\n  /** Optional explicit default view key (e.g. \"main.chat\") */\n  entryViewKey?: string;\n}\n\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  return rel.replace(/\\\\/g, '/');\n}\n\nfunction resolveFromComponentDir(componentDir: string, fileRef: string): string {\n  if (path.isAbsolute(fileRef)) {\n    return fileRef;\n  }\n\n  const normalizedRef = fileRef.replace(/\\\\/g, '/');\n  const componentDirName = path.basename(componentDir).replace(/\\\\/g, '/');\n\n  if (normalizedRef.startsWith(componentDirName + '/')) {\n    const stripped = normalizedRef.slice(componentDirName.length + 1);\n    return path.resolve(componentDir, stripped);\n  }\n\n  return path.resolve(componentDir, normalizedRef);\n}\n\nfunction viewKey(view: ViewDef): string {\n  return `${view.windowName}.${view.pageName}`;\n}\n\nfunction toIdentifier(prefix: string, value: string): string {\n  const core = value\n    .replace(/[^a-zA-Z0-9]+/g, ' ')\n    .trim()\n    .split(/\\s+/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return `${prefix}${core || 'Component'}`;\n}\n\nfunction escapeSingleQuoted(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n\nconst CONTROLLER_FILE_SUFFIXES = [\n  '.ts',\n  '.js',\n  '.controller.ts',\n  '.controller.js',\n] as const;\n\nconst CONTROLLER_INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\nfunction resolveControllerFile(controllerRef: string, componentDir: string): string | null {\n  const normalized = controllerRef.trim();\n  const basePath = resolveFromComponentDir(componentDir, normalized);\n\n  if (existsSync(basePath)) {\n    return basePath;\n  }\n\n  if (path.extname(basePath)) {\n    return null;\n  }\n\n  for (const suffix of CONTROLLER_FILE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  for (const indexFile of CONTROLLER_INDEX_CANDIDATES) {\n    const candidate = path.resolve(basePath, indexFile);\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveDefaultViewKey(sortedViews: ViewDef[], entryViewKey?: string): string {\n  if (sortedViews.length === 0) return '';\n\n  const configuredEntry = entryViewKey?.trim();\n  if (!configuredEntry) {\n    return viewKey(sortedViews[0]);\n  }\n\n  const availableKeys = sortedViews.map((view) => viewKey(view));\n  if (availableKeys.includes(configuredEntry)) {\n    return configuredEntry;\n  }\n\n  throw new Error(\n    `Renderer entry \"${configuredEntry}\" was not found in parsed views. Available view keys: ${availableKeys.join(', ')}`,\n  );\n}\n\nexport function generateRendererApp(\n  views: ViewDef[],\n  options: RendererAppGeneratorOptions,\n): string {\n  const sortedViews = [...views].sort((a, b) => viewKey(a).localeCompare(viewKey(b)));\n  const defaultViewKey = resolveDefaultViewKey(sortedViews, options.entryViewKey);\n\n  const importLines: string[] = [];\n  const viewIdentifiers = new Map<string, string>();\n  const layoutIdentifiers = new Map<string, string>();\n  const controllerIdentifiers = new Map<string, { identifier: string; importPath: string }>();\n  const usedNames = new Set<string>();\n\n  const allocateName = (prefix: string, filePath: string): string => {\n    const base = toIdentifier(prefix, filePath);\n    let name = base;\n    let suffix = 2;\n    while (usedNames.has(name)) {\n      name = `${base}${suffix}`;\n      suffix += 1;\n    }\n    usedNames.add(name);\n    return name;\n  };\n\n  const ensureControllerImported = (controllerRef: string, owningViewKey: string): void => {\n    if (controllerIdentifiers.has(controllerRef)) return;\n\n    const resolvedControllerFile = resolveControllerFile(controllerRef, options.componentDir);\n    if (!resolvedControllerFile) {\n      throw new Error(\n        `Renderer app codegen failed: controller \"${controllerRef}\" for view \"${owningViewKey}\" was not found. ` +\n        'Controller must point to an existing file with a default exported class.',\n      );\n    }\n\n    const identifier = allocateName('PageController', controllerRef);\n    const importPath = computeImportPath(options.outDir, resolvedControllerFile);\n    controllerIdentifiers.set(controllerRef, { identifier, importPath });\n    importLines.push(`import ${identifier} from '${importPath}';`);\n  };\n\n  for (const view of sortedViews) {\n    if (!viewIdentifiers.has(view.viewPath)) {\n      const identifier = allocateName('View', view.viewPath);\n      viewIdentifiers.set(view.viewPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, view.viewPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    for (const layoutPath of view.layouts) {\n      if (layoutIdentifiers.has(layoutPath)) continue;\n      const identifier = allocateName('Layout', layoutPath);\n      layoutIdentifiers.set(layoutPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, layoutPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    if (view.controller) {\n      ensureControllerImported(view.controller, viewKey(view));\n    }\n\n    for (const layoutController of view.layoutControllers ?? []) {\n      if (!layoutController) continue;\n      ensureControllerImported(layoutController, viewKey(view));\n    }\n  }\n\n  const manifestEntries = sortedViews.map((view) => {\n    const key = viewKey(view);\n    const viewIdentifier = viewIdentifiers.get(view.viewPath)!;\n    const layoutList = view.layouts.map((layoutPath) => layoutIdentifiers.get(layoutPath)!);\n    const controllerPath = view.controller ? `'${escapeSingleQuoted(view.controller)}'` : 'undefined';\n    const controllerClass = view.controller\n      ? controllerIdentifiers.get(view.controller)!.identifier\n      : 'undefined';\n    const layoutControllerRefs = view.layoutControllers;\n    if (layoutControllerRefs && layoutControllerRefs.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout controller count for view \"${key}\" does not match layout count.`,\n      );\n    }\n    const normalizedLayoutControllerRefs = layoutControllerRefs ?? Array.from(\n      { length: view.layouts.length },\n      () => undefined,\n    );\n    const layoutControllerPaths = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? `'${escapeSingleQuoted(controllerRef)}'` : 'undefined'))\n      .join(', ')}]`;\n    const layoutControllerClasses = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? controllerIdentifiers.get(controllerRef)!.identifier : 'undefined'))\n      .join(', ')}]`;\n    const layoutPreserve = view.layoutPreserve ?? Array.from(\n      { length: view.layouts.length },\n      () => false,\n    );\n    if (layoutPreserve.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout preserve count for view \"${key}\" does not match layout count.`,\n      );\n    }\n\n    return `  '${escapeSingleQuoted(key)}': {\n    key: '${escapeSingleQuoted(key)}',\n    windowName: '${escapeSingleQuoted(view.windowName)}',\n    pageName: '${escapeSingleQuoted(view.pageName)}',\n    viewPath: '${escapeSingleQuoted(view.viewPath)}',\n    layoutPaths: ${JSON.stringify(view.layouts)},\n    layoutControllers: ${layoutControllerPaths},\n    layoutPreserve: ${JSON.stringify(layoutPreserve)},\n    controller: ${controllerPath},\n    layoutControllerClasses: ${layoutControllerClasses},\n    controllerClass: ${controllerClass},\n    view: ${viewIdentifier},\n    layouts: [${layoutList.join(', ')}],\n  },`;\n  });\n\n  return `${generatedFileNotice(RENDERER_APP_SOURCE_INSTRUCTIONS)}\nimport { mount } from 'svelte';\nimport { App, getApp, getContainer } from '@noego/wood/client';\nimport { Navigation, getNavigation } from '@noego/wood/navigation';\nimport { Ipc, getIpc } from '@noego/wood/ipc';\nimport NavigationShell from '@noego/wood/navigation-shell';\n${importLines.join('\\n')}\n\ninterface GeneratedAppViewEntry {\n  key: string;\n  windowName: string;\n  pageName: string;\n  viewPath: string;\n  layoutPaths: string[];\n  layoutControllers: Array<string | undefined>;\n  layoutPreserve: boolean[];\n  controller?: string;\n  layoutControllerClasses: Array<any | undefined>;\n  controllerClass?: any;\n  view: any;\n  layouts: any[];\n}\n\nconst VIEW_MANIFEST: Record<string, GeneratedAppViewEntry> = {\n${manifestEntries.join('\\n')}\n};\n\nfunction getViewManifestEntry(viewKey: string): GeneratedAppViewEntry | null {\n  return VIEW_MANIFEST[viewKey] ?? null;\n}\n\ninterface WoodScopedContainer {\n  get(token: any): unknown | Promise<unknown>;\n  registerClass?(token: any): void;\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\ninterface WoodContainer extends WoodScopedContainer {\n  extend?(): WoodScopedContainer;\n}\n\nfunction createScopedContainer(): WoodScopedContainer {\n  const container = getContainer() as WoodContainer;\n  if (typeof container.extend !== 'function') {\n    throw new Error('Wood client container does not support extend().');\n  }\n\n  const scopedContainer = container.extend();\n\n  if (!scopedContainer || typeof scopedContainer.get !== 'function') {\n    throw new Error('Wood client container does not support get().');\n  }\n\n  if (typeof scopedContainer.registerFunction === 'function') {\n    scopedContainer.registerFunction(Navigation, () => getNavigation());\n    scopedContainer.registerFunction(App, () => getApp());\n    scopedContainer.registerFunction(Ipc, () => getIpc());\n  }\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveController(\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\n  const scopedContainer = createScopedContainer();\n\n  if (typeof ControllerClass !== 'function') {\n    throw new Error(\n      \\`Controller for \\${contextLabel} in view \"\\${entry.key}\" is invalid. Expected a default exported class.\\`,\n    );\n  }\n\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(ControllerClass);\n  }\n\n  return await scopedContainer.get(ControllerClass);\n}\n\nasync function createViewController(\n  entry: GeneratedAppViewEntry,\n): Promise<unknown> {\n  if (!entry.controllerClass) {\n    return undefined;\n  }\n\n  return await resolveController(entry, entry.controllerClass, 'page');\n}\n\nasync function createLayoutControllers(\n  entry: GeneratedAppViewEntry,\n  startIndex = 0,\n): Promise<Array<unknown>> {\n  const controllers: unknown[] = [];\n\n  for (let i = 0; i < startIndex; i += 1) {\n    controllers.push(undefined);\n  }\n\n  for (let i = startIndex; i < entry.layoutControllerClasses.length; i += 1) {\n    const LayoutController = entry.layoutControllerClasses[i];\n    if (!LayoutController) {\n      controllers.push(undefined);\n      continue;\n    }\n    const controller = await resolveController(\n      entry,\n      LayoutController,\n      \\`layout[\\${i}]\\`,\n    );\n    controllers.push(controller);\n  }\n\n  return controllers;\n}\n\nconst DEFAULT_VIEW_KEY = '${escapeSingleQuoted(defaultViewKey)}';\n\ntype WoodWindowBootstrapInfo = {\n  ok?: boolean;\n  windowId?: string;\n  defaultRoute?: string;\n};\n\ntype WoodBootstrapBridgeLike = {\n  __window?: {\n    current?: () => Promise<WoodWindowBootstrapInfo>;\n  };\n};\n\nfunction getWoodBridge(): WoodBootstrapBridgeLike | null {\n  const globalObj = globalThis as typeof globalThis & {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    window?: {\n      __NOEGO_WOOD_BRIDGE__?: unknown;\n    };\n  };\n\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__ ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n\n  return bridge as WoodBootstrapBridgeLike;\n}\n\nasync function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {\n  if (!DEFAULT_VIEW_KEY) {\n    throw new Error('No views available in renderer manifest. Define at least one view in renderer OpenAPI YAML.');\n  }\n\n  const bridge = getWoodBridge();\n  const bootstrapWindow = await bridge?.__window?.current?.();\n  const requestedRoute = bootstrapWindow?.defaultRoute;\n\n  if (requestedRoute) {\n    const routeEntry = getViewManifestEntry(requestedRoute);\n    if (routeEntry) {\n      return routeEntry;\n    }\n  }\n\n  const entry = getViewManifestEntry(DEFAULT_VIEW_KEY);\n  if (!entry) {\n    throw new Error(\\`Default view \"\\${DEFAULT_VIEW_KEY}\" is missing from generated view manifest.\\`);\n  }\n\n  return entry;\n}\n\nexport async function app(target: Element) {\n  const entry = await resolveInitialEntry();\n\n  getNavigation().replace(entry.key, {}, {});\n  const controller = await createViewController(entry);\n  const layoutControllers = await createLayoutControllers(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialController: controller,\n      initialLayoutControllers: layoutControllers,\n      createViewControllerFn: createViewController,\n      createLayoutControllersFn: createLayoutControllers,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"AAAA,SAAS,kBAAkB;AAC3B,OAAO,UAAU;AAEjB,SAAS,2BAA2B;AAEpC,MAAM,mCAAmC;AAAA,EACvC;AAAA,EACA;AACF;AAWA,SAAS,kBAAkB,SAAiB,QAAwB;AAClE,MAAI,MAAM,KAAK,SAAS,SAAS,MAAM;AAEvC,MAAI,CAAC,IAAI,WAAW,GAAG,GAAG;AACxB,UAAM,OAAO;AAAA,EACf;AAEA,SAAO,IAAI,QAAQ,OAAO,GAAG;AAC/B;AAEA,SAAS,wBAAwB,cAAsB,SAAyB;AAC9E,MAAI,KAAK,WAAW,OAAO,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,QAAQ,QAAQ,OAAO,GAAG;AAChD,QAAM,mBAAmB,KAAK,SAAS,YAAY,EAAE,QAAQ,OAAO,GAAG;AAEvE,MAAI,cAAc,WAAW,mBAAmB,GAAG,GAAG;AACpD,UAAM,WAAW,cAAc,MAAM,iBAAiB,SAAS,CAAC;AAChE,WAAO,KAAK,QAAQ,cAAc,QAAQ;AAAA,EAC5C;AAEA,SAAO,KAAK,QAAQ,cAAc,aAAa;AACjD;AAEA,SAAS,QAAQ,MAAuB;AACtC,SAAO,GAAG,KAAK,UAAU,IAAI,KAAK,QAAQ;AAC5C;AAEA,SAAS,aAAa,QAAgB,OAAuB;AAC3D,QAAM,OAAO,MACV,QAAQ,kBAAkB,GAAG,EAC7B,KAAK,EACL,MAAM,KAAK,EACX,IAAI,CAAC,YAAY,QAAQ,OAAO,CAAC,EAAE,YAAY,IAAI,QAAQ,MAAM,CAAC,CAAC,EACnE,KAAK,EAAE;AAEV,SAAO,GAAG,MAAM,GAAG,QAAQ,WAAW;AACxC;AAEA,SAAS,mBAAmB,OAAuB;AACjD,SAAO,MAAM,QAAQ,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAK;AACzD;AAEA,MAAM,2BAA2B;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,8BAA8B;AAAA,EAClC;AAAA,EACA;AACF;AAEA,SAAS,sBAAsB,eAAuB,cAAqC;AACzF,QAAM,aAAa,cAAc,KAAK;AACtC,QAAM,WAAW,wBAAwB,cAAc,UAAU;AAEjE,MAAI,WAAW,QAAQ,GAAG;AACxB,WAAO;AAAA,EACT;AAEA,MAAI,KAAK,QAAQ,QAAQ,GAAG;AAC1B,WAAO;AAAA,EACT;AAEA,aAAW,UAAU,0BAA0B;AAC7C,UAAM,YAAY,WAAW;AAC7B,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,aAAW,aAAa,6BAA6B;AACnD,UAAM,YAAY,KAAK,QAAQ,UAAU,SAAS;AAClD,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,sBAAsB,aAAwB,cAA+B;AACpF,MAAI,YAAY,WAAW,EAAG,QAAO;AAErC,QAAM,kBAAkB,cAAc,KAAK;AAC3C,MAAI,CAAC,iBAAiB;AACpB,WAAO,QAAQ,YAAY,CAAC,CAAC;AAAA,EAC/B;AAEA,QAAM,gBAAgB,YAAY,IAAI,CAAC,SAAS,QAAQ,IAAI,CAAC;AAC7D,MAAI,cAAc,SAAS,eAAe,GAAG;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,IAAI;AAAA,IACR,mBAAmB,eAAe,yDAAyD,cAAc,KAAK,IAAI,CAAC;AAAA,EACrH;AACF;AAEO,SAAS,oBACd,OACA,SACQ;AACR,QAAM,cAAc,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,QAAQ,CAAC,EAAE,cAAc,QAAQ,CAAC,CAAC,CAAC;AAClF,QAAM,iBAAiB,sBAAsB,aAAa,QAAQ,YAAY;AAE9E,QAAM,cAAwB,CAAC;AAC/B,QAAM,kBAAkB,oBAAI,IAAoB;AAChD,QAAM,oBAAoB,oBAAI,IAAoB;AAClD,QAAM,wBAAwB,oBAAI,IAAwD;AAC1F,QAAM,YAAY,oBAAI,IAAY;AAElC,QAAM,eAAe,CAAC,QAAgB,aAA6B;AACjE,UAAM,OAAO,aAAa,QAAQ,QAAQ;AAC1C,QAAI,OAAO;AACX,QAAI,SAAS;AACb,WAAO,UAAU,IAAI,IAAI,GAAG;AAC1B,aAAO,GAAG,IAAI,GAAG,MAAM;AACvB,gBAAU;AAAA,IACZ;AACA,cAAU,IAAI,IAAI;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,2BAA2B,CAAC,eAAuB,kBAAgC;AACvF,QAAI,sBAAsB,IAAI,aAAa,EAAG;AAE9C,UAAM,yBAAyB,sBAAsB,eAAe,QAAQ,YAAY;AACxF,QAAI,CAAC,wBAAwB;AAC3B,YAAM,IAAI;AAAA,QACR,4CAA4C,aAAa,eAAe,aAAa;AAAA,MAEvF;AAAA,IACF;AAEA,UAAM,aAAa,aAAa,kBAAkB,aAAa;AAC/D,UAAM,aAAa,kBAAkB,QAAQ,QAAQ,sBAAsB;AAC3E,0BAAsB,IAAI,eAAe,EAAE,YAAY,WAAW,CAAC;AACnE,gBAAY,KAAK,UAAU,UAAU,UAAU,UAAU,IAAI;AAAA,EAC/D;AAEA,aAAW,QAAQ,aAAa;AAC9B,QAAI,CAAC,gBAAgB,IAAI,KAAK,QAAQ,GAAG;AACvC,YAAM,aAAa,aAAa,QAAQ,KAAK,QAAQ;AACrD,sBAAgB,IAAI,KAAK,UAAU,UAAU;AAC7C,YAAM,MAAM,wBAAwB,QAAQ,cAAc,KAAK,QAAQ;AACvE,YAAM,aAAa,kBAAkB,QAAQ,QAAQ,GAAG;AACxD,kBAAY,KAAK,UAAU,UAAU,UAAU,UAAU,IAAI;AAAA,IAC/D;AAEA,eAAW,cAAc,KAAK,SAAS;AACrC,UAAI,kBAAkB,IAAI,UAAU,EAAG;AACvC,YAAM,aAAa,aAAa,UAAU,UAAU;AACpD,wBAAkB,IAAI,YAAY,UAAU;AAC5C,YAAM,MAAM,wBAAwB,QAAQ,cAAc,UAAU;AACpE,YAAM,aAAa,kBAAkB,QAAQ,QAAQ,GAAG;AACxD,kBAAY,KAAK,UAAU,UAAU,UAAU,UAAU,IAAI;AAAA,IAC/D;AAEA,QAAI,KAAK,YAAY;AACnB,+BAAyB,KAAK,YAAY,QAAQ,IAAI,CAAC;AAAA,IACzD;AAEA,eAAW,oBAAoB,KAAK,qBAAqB,CAAC,GAAG;AAC3D,UAAI,CAAC,iBAAkB;AACvB,+BAAyB,kBAAkB,QAAQ,IAAI,CAAC;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,kBAAkB,YAAY,IAAI,CAAC,SAAS;AAChD,UAAM,MAAM,QAAQ,IAAI;AACxB,UAAM,iBAAiB,gBAAgB,IAAI,KAAK,QAAQ;AACxD,UAAM,aAAa,KAAK,QAAQ,IAAI,CAAC,eAAe,kBAAkB,IAAI,UAAU,CAAE;AACtF,UAAM,iBAAiB,KAAK,aAAa,IAAI,mBAAmB,KAAK,UAAU,CAAC,MAAM;AACtF,UAAM,kBAAkB,KAAK,aACzB,sBAAsB,IAAI,KAAK,UAAU,EAAG,aAC5C;AACJ,UAAM,uBAAuB,KAAK;AAClC,QAAI,wBAAwB,qBAAqB,WAAW,KAAK,QAAQ,QAAQ;AAC/E,YAAM,IAAI;AAAA,QACR,kEAAkE,GAAG;AAAA,MACvE;AAAA,IACF;AACA,UAAM,iCAAiC,wBAAwB,MAAM;AAAA,MACnE,EAAE,QAAQ,KAAK,QAAQ,OAAO;AAAA,MAC9B,MAAM;AAAA,IACR;AACA,UAAM,wBAAwB,IAAI,+BAC/B,IAAI,CAAC,kBAAmB,gBAAgB,IAAI,mBAAmB,aAAa,CAAC,MAAM,WAAY,EAC/F,KAAK,IAAI,CAAC;AACb,UAAM,0BAA0B,IAAI,+BACjC,IAAI,CAAC,kBAAmB,gBAAgB,sBAAsB,IAAI,aAAa,EAAG,aAAa,WAAY,EAC3G,KAAK,IAAI,CAAC;AACb,UAAM,iBAAiB,KAAK,kBAAkB,MAAM;AAAA,MAClD,EAAE,QAAQ,KAAK,QAAQ,OAAO;AAAA,MAC9B,MAAM;AAAA,IACR;AACA,QAAI,eAAe,WAAW,KAAK,QAAQ,QAAQ;AACjD,YAAM,IAAI;AAAA,QACR,gEAAgE,GAAG;AAAA,MACrE;AAAA,IACF;AAEA,WAAO,MAAM,mBAAmB,GAAG,CAAC;AAAA,YAC5B,mBAAmB,GAAG,CAAC;AAAA,mBAChB,mBAAmB,KAAK,UAAU,CAAC;AAAA,iBACrC,mBAAmB,KAAK,QAAQ,CAAC;AAAA,iBACjC,mBAAmB,KAAK,QAAQ,CAAC;AAAA,mBAC/B,KAAK,UAAU,KAAK,OAAO,CAAC;AAAA,yBACtB,qBAAqB;AAAA,sBACxB,KAAK,UAAU,cAAc,CAAC;AAAA,kBAClC,cAAc;AAAA,+BACD,uBAAuB;AAAA,uBAC/B,eAAe;AAAA,YAC1B,cAAc;AAAA,gBACV,WAAW,KAAK,IAAI,CAAC;AAAA;AAAA,EAEnC,CAAC;AAED,SAAO,GAAG,oBAAoB,gCAAgC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM/D,YAAY,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBtB,gBAAgB,KAAK,IAAI,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;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,4BAmGA,mBAAmB,cAAc,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2E9D;","names":[]}
+{"version":3,"sources":["../../src/codegen/renderer_app_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { ViewDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst RENDERER_APP_SOURCE_INSTRUCTIONS = [\n  'To change routes, page components, layouts, or renderer controllers, edit the views YAML',\n  'configured by wood.config.yml renderer.openapi and the matching UI source files.',\n] as const;\n\nexport interface RendererAppGeneratorOptions {\n  /** Absolute path to renderer component root (e.g. /app/ui) */\n  componentDir: string;\n  /** Absolute output directory where generated file will be written */\n  outDir: string;\n  /** Optional explicit default view key (e.g. \"main.chat\") */\n  entryViewKey?: string;\n}\n\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  return rel.replace(/\\\\/g, '/');\n}\n\nfunction resolveFromComponentDir(componentDir: string, fileRef: string): string {\n  if (path.isAbsolute(fileRef)) {\n    return fileRef;\n  }\n\n  const normalizedRef = fileRef.replace(/\\\\/g, '/');\n  const componentDirName = path.basename(componentDir).replace(/\\\\/g, '/');\n\n  if (normalizedRef.startsWith(componentDirName + '/')) {\n    const stripped = normalizedRef.slice(componentDirName.length + 1);\n    return path.resolve(componentDir, stripped);\n  }\n\n  return path.resolve(componentDir, normalizedRef);\n}\n\nfunction viewKey(view: ViewDef): string {\n  return `${view.windowName}.${view.pageName}`;\n}\n\nfunction toIdentifier(prefix: string, value: string): string {\n  const core = value\n    .replace(/[^a-zA-Z0-9]+/g, ' ')\n    .trim()\n    .split(/\\s+/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return `${prefix}${core || 'Component'}`;\n}\n\nfunction escapeSingleQuoted(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n\nconst CONTROLLER_FILE_SUFFIXES = [\n  '.ts',\n  '.js',\n  '.controller.ts',\n  '.controller.js',\n] as const;\n\nconst CONTROLLER_INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\nfunction resolveControllerFile(controllerRef: string, componentDir: string): string | null {\n  const normalized = controllerRef.trim();\n  const basePath = resolveFromComponentDir(componentDir, normalized);\n\n  if (existsSync(basePath)) {\n    return basePath;\n  }\n\n  if (path.extname(basePath)) {\n    return null;\n  }\n\n  for (const suffix of CONTROLLER_FILE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  for (const indexFile of CONTROLLER_INDEX_CANDIDATES) {\n    const candidate = path.resolve(basePath, indexFile);\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveDefaultViewKey(sortedViews: ViewDef[], entryViewKey?: string): string {\n  if (sortedViews.length === 0) return '';\n\n  const configuredEntry = entryViewKey?.trim();\n  if (!configuredEntry) {\n    return viewKey(sortedViews[0]);\n  }\n\n  const availableKeys = sortedViews.map((view) => viewKey(view));\n  if (availableKeys.includes(configuredEntry)) {\n    return configuredEntry;\n  }\n\n  throw new Error(\n    `Renderer entry \"${configuredEntry}\" was not found in parsed views. Available view keys: ${availableKeys.join(', ')}`,\n  );\n}\n\nexport function generateRendererApp(\n  views: ViewDef[],\n  options: RendererAppGeneratorOptions,\n): string {\n  const sortedViews = [...views].sort((a, b) => viewKey(a).localeCompare(viewKey(b)));\n  const defaultViewKey = resolveDefaultViewKey(sortedViews, options.entryViewKey);\n\n  const importLines: string[] = [];\n  const viewIdentifiers = new Map<string, string>();\n  const layoutIdentifiers = new Map<string, string>();\n  const controllerIdentifiers = new Map<string, { identifier: string; importPath: string }>();\n  const usedNames = new Set<string>();\n\n  const allocateName = (prefix: string, filePath: string): string => {\n    const base = toIdentifier(prefix, filePath);\n    let name = base;\n    let suffix = 2;\n    while (usedNames.has(name)) {\n      name = `${base}${suffix}`;\n      suffix += 1;\n    }\n    usedNames.add(name);\n    return name;\n  };\n\n  const ensureControllerImported = (controllerRef: string, owningViewKey: string): void => {\n    if (controllerIdentifiers.has(controllerRef)) return;\n\n    const resolvedControllerFile = resolveControllerFile(controllerRef, options.componentDir);\n    if (!resolvedControllerFile) {\n      throw new Error(\n        `Renderer app codegen failed: controller \"${controllerRef}\" for view \"${owningViewKey}\" was not found. ` +\n        'Controller must point to an existing file with a default exported class.',\n      );\n    }\n\n    const identifier = allocateName('PageController', controllerRef);\n    const importPath = computeImportPath(options.outDir, resolvedControllerFile);\n    controllerIdentifiers.set(controllerRef, { identifier, importPath });\n    importLines.push(`import ${identifier} from '${importPath}';`);\n  };\n\n  for (const view of sortedViews) {\n    if (!viewIdentifiers.has(view.viewPath)) {\n      const identifier = allocateName('View', view.viewPath);\n      viewIdentifiers.set(view.viewPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, view.viewPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    for (const layoutPath of view.layouts) {\n      if (layoutIdentifiers.has(layoutPath)) continue;\n      const identifier = allocateName('Layout', layoutPath);\n      layoutIdentifiers.set(layoutPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, layoutPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    if (view.controller) {\n      ensureControllerImported(view.controller, viewKey(view));\n    }\n\n    for (const layoutController of view.layoutControllers ?? []) {\n      if (!layoutController) continue;\n      ensureControllerImported(layoutController, viewKey(view));\n    }\n  }\n\n  const manifestEntries = sortedViews.map((view) => {\n    const key = viewKey(view);\n    const viewIdentifier = viewIdentifiers.get(view.viewPath)!;\n    const layoutList = view.layouts.map((layoutPath) => layoutIdentifiers.get(layoutPath)!);\n    const controllerPath = view.controller ? `'${escapeSingleQuoted(view.controller)}'` : 'undefined';\n    const controllerClass = view.controller\n      ? controllerIdentifiers.get(view.controller)!.identifier\n      : 'undefined';\n    const layoutControllerRefs = view.layoutControllers;\n    if (layoutControllerRefs && layoutControllerRefs.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout controller count for view \"${key}\" does not match layout count.`,\n      );\n    }\n    const normalizedLayoutControllerRefs = layoutControllerRefs ?? Array.from(\n      { length: view.layouts.length },\n      () => undefined,\n    );\n    const layoutControllerPaths = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? `'${escapeSingleQuoted(controllerRef)}'` : 'undefined'))\n      .join(', ')}]`;\n    const layoutControllerClasses = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? controllerIdentifiers.get(controllerRef)!.identifier : 'undefined'))\n      .join(', ')}]`;\n    const layoutPreserve = view.layoutPreserve ?? Array.from(\n      { length: view.layouts.length },\n      () => false,\n    );\n    if (layoutPreserve.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout preserve count for view \"${key}\" does not match layout count.`,\n      );\n    }\n\n    return `  '${escapeSingleQuoted(key)}': {\n    key: '${escapeSingleQuoted(key)}',\n    windowName: '${escapeSingleQuoted(view.windowName)}',\n    pageName: '${escapeSingleQuoted(view.pageName)}',\n    viewPath: '${escapeSingleQuoted(view.viewPath)}',\n    layoutPaths: ${JSON.stringify(view.layouts)},\n    layoutControllers: ${layoutControllerPaths},\n    layoutPreserve: ${JSON.stringify(layoutPreserve)},\n    controller: ${controllerPath},\n    layoutControllerClasses: ${layoutControllerClasses},\n    controllerClass: ${controllerClass},\n    view: ${viewIdentifier},\n    layouts: [${layoutList.join(', ')}],\n  },`;\n  });\n\n  return `${generatedFileNotice(RENDERER_APP_SOURCE_INSTRUCTIONS)}\nimport { mount } from 'svelte';\nimport { App, getApp, getContainer } from '@noego/wood/client';\nimport { Navigation, getNavigation, installAutomationIntrospection } from '@noego/wood/navigation';\nimport { Ipc, getIpc } from '@noego/wood/ipc';\nimport NavigationShell from '@noego/wood/navigation-shell';\n${importLines.join('\\n')}\n\ninterface GeneratedAppViewEntry {\n  key: string;\n  windowName: string;\n  pageName: string;\n  viewPath: string;\n  layoutPaths: string[];\n  layoutControllers: Array<string | undefined>;\n  layoutPreserve: boolean[];\n  controller?: string;\n  layoutControllerClasses: Array<any | undefined>;\n  controllerClass?: any;\n  view: any;\n  layouts: any[];\n}\n\nconst VIEW_MANIFEST: Record<string, GeneratedAppViewEntry> = {\n${manifestEntries.join('\\n')}\n};\n\nfunction getViewManifestEntry(viewKey: string): GeneratedAppViewEntry | null {\n  return VIEW_MANIFEST[viewKey] ?? null;\n}\n\ninterface WoodScopedContainer {\n  get(token: any): unknown | Promise<unknown>;\n  registerClass?(token: any): void;\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\ninterface WoodContainer extends WoodScopedContainer {\n  extend?(): WoodScopedContainer;\n}\n\nfunction createScopedContainer(): WoodScopedContainer {\n  const container = getContainer() as WoodContainer;\n  if (typeof container.extend !== 'function') {\n    throw new Error('Wood client container does not support extend().');\n  }\n\n  const scopedContainer = container.extend();\n\n  if (!scopedContainer || typeof scopedContainer.get !== 'function') {\n    throw new Error('Wood client container does not support get().');\n  }\n\n  if (typeof scopedContainer.registerFunction === 'function') {\n    scopedContainer.registerFunction(Navigation, () => getNavigation());\n    scopedContainer.registerFunction(App, () => getApp());\n    scopedContainer.registerFunction(Ipc, () => getIpc());\n  }\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveController(\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\n  const scopedContainer = createScopedContainer();\n\n  if (typeof ControllerClass !== 'function') {\n    throw new Error(\n      \\`Controller for \\${contextLabel} in view \"\\${entry.key}\" is invalid. Expected a default exported class.\\`,\n    );\n  }\n\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(ControllerClass);\n  }\n\n  return await scopedContainer.get(ControllerClass);\n}\n\nasync function createViewController(\n  entry: GeneratedAppViewEntry,\n): Promise<unknown> {\n  if (!entry.controllerClass) {\n    return undefined;\n  }\n\n  return await resolveController(entry, entry.controllerClass, 'page');\n}\n\nasync function createLayoutControllers(\n  entry: GeneratedAppViewEntry,\n  startIndex = 0,\n): Promise<Array<unknown>> {\n  const controllers: unknown[] = [];\n\n  for (let i = 0; i < startIndex; i += 1) {\n    controllers.push(undefined);\n  }\n\n  for (let i = startIndex; i < entry.layoutControllerClasses.length; i += 1) {\n    const LayoutController = entry.layoutControllerClasses[i];\n    if (!LayoutController) {\n      controllers.push(undefined);\n      continue;\n    }\n    const controller = await resolveController(\n      entry,\n      LayoutController,\n      \\`layout[\\${i}]\\`,\n    );\n    controllers.push(controller);\n  }\n\n  return controllers;\n}\n\nconst DEFAULT_VIEW_KEY = '${escapeSingleQuoted(defaultViewKey)}';\n\ntype WoodWindowBootstrapInfo = {\n  ok?: boolean;\n  windowId?: string;\n  defaultRoute?: string;\n};\n\ntype WoodBootstrapBridgeLike = {\n  __window?: {\n    current?: () => Promise<WoodWindowBootstrapInfo>;\n  };\n};\n\nfunction getWoodBridge(): WoodBootstrapBridgeLike | null {\n  const globalObj = globalThis as typeof globalThis & {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    window?: {\n      __NOEGO_WOOD_BRIDGE__?: unknown;\n    };\n  };\n\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__ ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n\n  return bridge as WoodBootstrapBridgeLike;\n}\n\nasync function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {\n  if (!DEFAULT_VIEW_KEY) {\n    throw new Error('No views available in renderer manifest. Define at least one view in renderer OpenAPI YAML.');\n  }\n\n  const bridge = getWoodBridge();\n  const bootstrapWindow = await bridge?.__window?.current?.();\n  const requestedRoute = bootstrapWindow?.defaultRoute;\n\n  if (requestedRoute) {\n    const routeEntry = getViewManifestEntry(requestedRoute);\n    if (routeEntry) {\n      return routeEntry;\n    }\n  }\n\n  const entry = getViewManifestEntry(DEFAULT_VIEW_KEY);\n  if (!entry) {\n    throw new Error(\\`Default view \"\\${DEFAULT_VIEW_KEY}\" is missing from generated view manifest.\\`);\n  }\n\n  return entry;\n}\n\nfunction isAutomationBuild(): boolean {\n  try {\n    const env = (import.meta as { env?: { DEV?: boolean; MODE?: string } }).env;\n    return Boolean(env?.DEV) || env?.MODE === 'test';\n  } catch {\n    return false;\n  }\n}\n\nexport async function app(target: Element) {\n  const entry = await resolveInitialEntry();\n\n  getNavigation().replace(entry.key, {}, {});\n\n  // Dev/test-only Axe introspection surface; never present in production builds.\n  if (isAutomationBuild()) {\n    const bootstrapWindow = await getWoodBridge()?.__window?.current?.();\n    installAutomationIntrospection({ windowId: bootstrapWindow?.windowId ?? null });\n  }\n  const controller = await createViewController(entry);\n  const layoutControllers = await createLayoutControllers(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialController: controller,\n      initialLayoutControllers: layoutControllers,\n      createViewControllerFn: createViewController,\n      createLayoutControllersFn: createLayoutControllers,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -43,3 +43,4 @@ import './runtime/app_env.cjs';
 import 'rxjs';
 import '@noego/telemetry/core';
 import '@noego/ioc';
+import './navigation/automation_introspection.cjs';

package/dist/index.d.ts

@@ -43,3 +43,4 @@ import './runtime/app_env.js';
 import 'rxjs';
 import '@noego/telemetry/core';
 import '@noego/ioc';
+import './navigation/automation_introspection.js';

package/dist/navigation/automation_introspection.cjs

@@ -0,0 +1,110 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var automation_introspection_exports = {};
+__export(automation_introspection_exports, {
+  WOOD_AUTOMATION_GLOBAL_KEY: () => WOOD_AUTOMATION_GLOBAL_KEY,
+  installAutomationIntrospection: () => installAutomationIntrospection
+});
+module.exports = __toCommonJS(automation_introspection_exports);
+var import_index = require("./index.cjs");
+const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+function toRoute(entry) {
+  if (!entry) {
+    return null;
+  }
+  return { page: entry.page, params: { ...entry.params }, query: { ...entry.query } };
+}
+function installAutomationIntrospection(options = {}) {
+  const globalObject = options.globalObject ?? globalThis;
+  const navigation = (0, import_index.getNavigation)();
+  let routeRevision = 0;
+  const listeners = /* @__PURE__ */ new Set();
+  const unsubscribeNavigation = navigation.subscribe((entry) => {
+    routeRevision += 1;
+    const event = { kind: "route", entry: toRoute(entry) };
+    for (const listener of listeners) {
+      listener(event);
+    }
+  });
+  const surface = {
+    version: 1,
+    snapshot: () => ({
+      version: 1,
+      windowId: options.windowId ?? null,
+      currentRoute: toRoute(navigation.getCurrent()),
+      navigationDepth: navigation.getPages().length,
+      rendererReady: true,
+      pendingWork: {
+        // Bounded placeholders until render/bridge instrumentation lands;
+        // consumers must treat unknown pending work as zero, not omit checks.
+        bridgeCalls: 0,
+        renders: 0,
+        animations: 0
+      }
+    }),
+    waitForIdle: (waitOptions) => {
+      const timeoutMs = waitOptions?.timeoutMs ?? 2e3;
+      const idleFramesRequired = waitOptions?.idleFrames ?? 3;
+      const raf = typeof requestAnimationFrame === "function" ? (cb) => requestAnimationFrame(() => cb()) : (cb) => void setTimeout(cb, 16);
+      return new Promise((resolve) => {
+        const startedAt = Date.now();
+        let lastSeenRevision = routeRevision;
+        let idleFrames = 0;
+        const step = () => {
+          if (Date.now() - startedAt > timeoutMs) {
+            resolve(false);
+            return;
+          }
+          if (routeRevision !== lastSeenRevision) {
+            lastSeenRevision = routeRevision;
+            idleFrames = 0;
+          } else {
+            idleFrames += 1;
+            if (idleFrames >= idleFramesRequired) {
+              resolve(true);
+              return;
+            }
+          }
+          raf(step);
+        };
+        raf(step);
+      });
+    },
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+  globalObject[WOOD_AUTOMATION_GLOBAL_KEY] = surface;
+  return () => {
+    unsubscribeNavigation();
+    listeners.clear();
+    if (globalObject[WOOD_AUTOMATION_GLOBAL_KEY] === surface) {
+      delete globalObject[WOOD_AUTOMATION_GLOBAL_KEY];
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WOOD_AUTOMATION_GLOBAL_KEY,
+  installAutomationIntrospection
+});
+//# sourceMappingURL=automation_introspection.cjs.map

package/dist/navigation/automation_introspection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/navigation/automation_introspection.ts"],"sourcesContent":["/**\n * Dev/test-only automation introspection (Axe.md AXE-WP-02).\n *\n * Exposes a narrow, versioned inspection surface for the Axe live driver:\n * current route, readiness, and route-change subscription. It exposes no\n * privileged operations.\n *\n * Deviation from the spec's `bridge.__automation` shape: the preload bridge\n * (`__NOEGO_WOOD_BRIDGE__`) is a sealed contextBridge object that renderer\n * code cannot extend, so the surface is installed as the sibling main-world\n * global `__NOEGO_WOOD_AUTOMATION__`. Axe reads it the same way.\n *\n * This module lives in the renderer bundle. It must only be installed in\n * development and explicit test builds — the generated renderer app gates the\n * install call; this module never self-installs on import.\n */\n\nimport { getNavigation, type NavigationEntry } from './index.cjs';\n\nexport const WOOD_AUTOMATION_GLOBAL_KEY = '__NOEGO_WOOD_AUTOMATION__';\n\nexport interface WoodAutomationSnapshot {\n  version: 1;\n  windowId: string | null;\n  currentRoute: {\n    page: string;\n    params: Record<string, string>;\n    query: Record<string, string>;\n  } | null;\n  navigationDepth: number;\n  rendererReady: boolean;\n  pendingWork: {\n    bridgeCalls: number;\n    renders: number;\n    animations: number;\n  };\n}\n\nexport type WoodAutomationEvent =\n  | { kind: 'route'; entry: WoodAutomationSnapshot['currentRoute'] };\n\nexport interface WoodAutomationIntrospection {\n  version: 1;\n  snapshot: () => WoodAutomationSnapshot;\n  waitForIdle: (options?: { timeoutMs?: number; idleFrames?: number }) => Promise<boolean>;\n  subscribe: (listener: (event: WoodAutomationEvent) => void) => () => void;\n}\n\nexport interface InstallAutomationIntrospectionOptions {\n  /** Wood window identity when known at install time. */\n  windowId?: string | null;\n  /** Override for tests; defaults to `globalThis`. */\n  globalObject?: Record<string, unknown>;\n}\n\nfunction toRoute(entry: NavigationEntry | null): WoodAutomationSnapshot['currentRoute'] {\n  if (!entry) {\n    return null;\n  }\n  return { page: entry.page, params: { ...entry.params }, query: { ...entry.query } };\n}\n\n/**\n * Install the introspection global. Idempotent: repeated installs replace the\n * previous surface (fresh navigation subscription, updated windowId).\n * Returns an uninstall function.\n */\nexport function installAutomationIntrospection(\n  options: InstallAutomationIntrospectionOptions = {},\n): () => void {\n  const globalObject = options.globalObject ?? (globalThis as unknown as Record<string, unknown>);\n  const navigation = getNavigation();\n\n  let routeRevision = 0;\n  const listeners = new Set<(event: WoodAutomationEvent) => void>();\n\n  const unsubscribeNavigation = navigation.subscribe((entry) => {\n    routeRevision += 1;\n    const event: WoodAutomationEvent = { kind: 'route', entry: toRoute(entry) };\n    for (const listener of listeners) {\n      listener(event);\n    }\n  });\n\n  const surface: WoodAutomationIntrospection = {\n    version: 1,\n    snapshot: () => ({\n      version: 1,\n      windowId: options.windowId ?? null,\n      currentRoute: toRoute(navigation.getCurrent()),\n      navigationDepth: navigation.getPages().length,\n      rendererReady: true,\n      pendingWork: {\n        // Bounded placeholders until render/bridge instrumentation lands;\n        // consumers must treat unknown pending work as zero, not omit checks.\n        bridgeCalls: 0,\n        renders: 0,\n        animations: 0,\n      },\n    }),\n    waitForIdle: (waitOptions) => {\n      const timeoutMs = waitOptions?.timeoutMs ?? 2_000;\n      const idleFramesRequired = waitOptions?.idleFrames ?? 3;\n      const raf: (cb: () => void) => void =\n        typeof requestAnimationFrame === 'function'\n          ? (cb) => requestAnimationFrame(() => cb())\n          : (cb) => void setTimeout(cb, 16);\n\n      return new Promise<boolean>((resolve) => {\n        const startedAt = Date.now();\n        let lastSeenRevision = routeRevision;\n        let idleFrames = 0;\n\n        const step = (): void => {\n          if (Date.now() - startedAt > timeoutMs) {\n            resolve(false);\n            return;\n          }\n          if (routeRevision !== lastSeenRevision) {\n            lastSeenRevision = routeRevision;\n            idleFrames = 0;\n          } else {\n            idleFrames += 1;\n            if (idleFrames >= idleFramesRequired) {\n              resolve(true);\n              return;\n            }\n          }\n          raf(step);\n        };\n\n        raf(step);\n      });\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n\n  globalObject[WOOD_AUTOMATION_GLOBAL_KEY] = surface;\n\n  return () => {\n    unsubscribeNavigation();\n    listeners.clear();\n    if (globalObject[WOOD_AUTOMATION_GLOBAL_KEY] === surface) {\n      delete globalObject[WOOD_AUTOMATION_GLOBAL_KEY];\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBA,mBAAoD;AAE7C,MAAM,6BAA6B;AAoC1C,SAAS,QAAQ,OAAuE;AACtF,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,SAAO,EAAE,MAAM,MAAM,MAAM,QAAQ,EAAE,GAAG,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,MAAM,MAAM,EAAE;AACpF;AAOO,SAAS,+BACd,UAAiD,CAAC,GACtC;AACZ,QAAM,eAAe,QAAQ,gBAAiB;AAC9C,QAAM,iBAAa,4BAAc;AAEjC,MAAI,gBAAgB;AACpB,QAAM,YAAY,oBAAI,IAA0C;AAEhE,QAAM,wBAAwB,WAAW,UAAU,CAAC,UAAU;AAC5D,qBAAiB;AACjB,UAAM,QAA6B,EAAE,MAAM,SAAS,OAAO,QAAQ,KAAK,EAAE;AAC1E,eAAW,YAAY,WAAW;AAChC,eAAS,KAAK;AAAA,IAChB;AAAA,EACF,CAAC;AAED,QAAM,UAAuC;AAAA,IAC3C,SAAS;AAAA,IACT,UAAU,OAAO;AAAA,MACf,SAAS;AAAA,MACT,UAAU,QAAQ,YAAY;AAAA,MAC9B,cAAc,QAAQ,WAAW,WAAW,CAAC;AAAA,MAC7C,iBAAiB,WAAW,SAAS,EAAE;AAAA,MACvC,eAAe;AAAA,MACf,aAAa;AAAA;AAAA;AAAA,QAGX,aAAa;AAAA,QACb,SAAS;AAAA,QACT,YAAY;AAAA,MACd;AAAA,IACF;AAAA,IACA,aAAa,CAAC,gBAAgB;AAC5B,YAAM,YAAY,aAAa,aAAa;AAC5C,YAAM,qBAAqB,aAAa,cAAc;AACtD,YAAM,MACJ,OAAO,0BAA0B,aAC7B,CAAC,OAAO,sBAAsB,MAAM,GAAG,CAAC,IACxC,CAAC,OAAO,KAAK,WAAW,IAAI,EAAE;AAEpC,aAAO,IAAI,QAAiB,CAAC,YAAY;AACvC,cAAM,YAAY,KAAK,IAAI;AAC3B,YAAI,mBAAmB;AACvB,YAAI,aAAa;AAEjB,cAAM,OAAO,MAAY;AACvB,cAAI,KAAK,IAAI,IAAI,YAAY,WAAW;AACtC,oBAAQ,KAAK;AACb;AAAA,UACF;AACA,cAAI,kBAAkB,kBAAkB;AACtC,+BAAmB;AACnB,yBAAa;AAAA,UACf,OAAO;AACL,0BAAc;AACd,gBAAI,cAAc,oBAAoB;AACpC,sBAAQ,IAAI;AACZ;AAAA,YACF;AAAA,UACF;AACA,cAAI,IAAI;AAAA,QACV;AAEA,YAAI,IAAI;AAAA,MACV,CAAC;AAAA,IACH;AAAA,IACA,WAAW,CAAC,aAAa;AACvB,gBAAU,IAAI,QAAQ;AACtB,aAAO,MAAM;AACX,kBAAU,OAAO,QAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAEA,eAAa,0BAA0B,IAAI;AAE3C,SAAO,MAAM;AACX,0BAAsB;AACtB,cAAU,MAAM;AAChB,QAAI,aAAa,0BAA0B,MAAM,SAAS;AACxD,aAAO,aAAa,0BAA0B;AAAA,IAChD;AAAA,EACF;AACF;","names":[]}

package/dist/navigation/automation_introspection.d.cts

@@ -0,0 +1,60 @@
+/**
+ * Dev/test-only automation introspection (Axe.md AXE-WP-02).
+ *
+ * Exposes a narrow, versioned inspection surface for the Axe live driver:
+ * current route, readiness, and route-change subscription. It exposes no
+ * privileged operations.
+ *
+ * Deviation from the spec's `bridge.__automation` shape: the preload bridge
+ * (`__NOEGO_WOOD_BRIDGE__`) is a sealed contextBridge object that renderer
+ * code cannot extend, so the surface is installed as the sibling main-world
+ * global `__NOEGO_WOOD_AUTOMATION__`. Axe reads it the same way.
+ *
+ * This module lives in the renderer bundle. It must only be installed in
+ * development and explicit test builds — the generated renderer app gates the
+ * install call; this module never self-installs on import.
+ */
+declare const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+interface WoodAutomationSnapshot {
+    version: 1;
+    windowId: string | null;
+    currentRoute: {
+        page: string;
+        params: Record<string, string>;
+        query: Record<string, string>;
+    } | null;
+    navigationDepth: number;
+    rendererReady: boolean;
+    pendingWork: {
+        bridgeCalls: number;
+        renders: number;
+        animations: number;
+    };
+}
+type WoodAutomationEvent = {
+    kind: 'route';
+    entry: WoodAutomationSnapshot['currentRoute'];
+};
+interface WoodAutomationIntrospection {
+    version: 1;
+    snapshot: () => WoodAutomationSnapshot;
+    waitForIdle: (options?: {
+        timeoutMs?: number;
+        idleFrames?: number;
+    }) => Promise<boolean>;
+    subscribe: (listener: (event: WoodAutomationEvent) => void) => () => void;
+}
+interface InstallAutomationIntrospectionOptions {
+    /** Wood window identity when known at install time. */
+    windowId?: string | null;
+    /** Override for tests; defaults to `globalThis`. */
+    globalObject?: Record<string, unknown>;
+}
+/**
+ * Install the introspection global. Idempotent: repeated installs replace the
+ * previous surface (fresh navigation subscription, updated windowId).
+ * Returns an uninstall function.
+ */
+declare function installAutomationIntrospection(options?: InstallAutomationIntrospectionOptions): () => void;
+
+export { type InstallAutomationIntrospectionOptions, WOOD_AUTOMATION_GLOBAL_KEY, type WoodAutomationEvent, type WoodAutomationIntrospection, type WoodAutomationSnapshot, installAutomationIntrospection };