@noego/wood 0.5.1 → 0.6.1

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, 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    // Explicit Singleton lifetime: these return renderer-root globals, and\n    // registerFunction defaults to Transient — rejected by ioc >= 0.5's\n    // captive-lifetime validation under singleton dependents.\n    const singleton = { loadAs: 0 /* LoadAs.Singleton */ };\n    scopedContainer.registerFunction(Navigation, () => getNavigation(), singleton);\n    scopedContainer.registerFunction(App, () => getApp(), singleton);\n    scopedContainer.registerFunction(Ipc, () => getIpc(), singleton);\n  }\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveControllerInScope(\n  scope: WoodScopedContainer,\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\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 scope.registerClass === 'function') {\n    scope.registerClass(ControllerClass);\n  }\n\n  return await scope.get(ControllerClass);\n}\n\nasync function disposeScopeQuietly(scope: { dispose?: () => Promise<void> } | null): Promise<void> {\n  if (!scope || typeof scope.dispose !== 'function') return;\n  try {\n    await scope.dispose();\n  } catch (error) {\n    console.error('[wood] renderer scope disposal failed:', error);\n  }\n}\n\n/**\n * One page scope per view lifecycle: the view controller and every\n * non-preservable layout controller resolve from the SAME scope, so Scoped\n * services/state are shared within the page (the NoEgo renderer model).\n * Layouts marked preservable in the manifest own dedicated scopes that\n * survive page transitions and dispose when the layout finally leaves.\n */\nasync function createControllerSet(\n  entry: GeneratedAppViewEntry,\n  preservedDepth = 0,\n): Promise<{\n  controller: unknown;\n  layoutControllers: Array<unknown>;\n  pageScope: WoodScopedContainer;\n  layoutScopes: Array<WoodScopedContainer | null>;\n}> {\n  const pageScope = createScopedContainer();\n  const layoutControllers: unknown[] = [];\n  const layoutScopes: Array<WoodScopedContainer | null> = [];\n  const createdLayoutScopes: WoodScopedContainer[] = [];\n\n  try {\n    for (let i = 0; i < preservedDepth; i += 1) {\n      layoutControllers.push(undefined);\n      layoutScopes.push(null);\n    }\n\n    for (let i = preservedDepth; i < entry.layoutControllerClasses.length; i += 1) {\n      const LayoutController = entry.layoutControllerClasses[i];\n      if (!LayoutController) {\n        layoutControllers.push(undefined);\n        layoutScopes.push(null);\n        continue;\n      }\n      const preservable = entry.layoutPreserve?.[i] === true;\n      let scope = pageScope;\n      if (preservable) {\n        scope = createScopedContainer();\n        createdLayoutScopes.push(scope);\n      }\n      const controller = await resolveControllerInScope(\n        scope,\n        entry,\n        LayoutController,\n        \\`layout[\\${i}]\\`,\n      );\n      layoutControllers.push(controller);\n      layoutScopes.push(preservable ? scope : null);\n    }\n\n    const controller = entry.controllerClass\n      ? await resolveControllerInScope(pageScope, entry, entry.controllerClass, 'page')\n      : undefined;\n\n    return { controller, layoutControllers, pageScope, layoutScopes };\n  } catch (error) {\n    // Failed transitions must not orphan scopes: dispose everything this\n    // set created before rethrowing.\n    for (const scope of createdLayoutScopes) await disposeScopeQuietly(scope as any);\n    await disposeScopeQuietly(pageScope as any);\n    throw error;\n  }\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 initialSet = await createControllerSet(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialControllerSet: initialSet,\n      createControllerSetFn: createControllerSet,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"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","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  // Renderer builtins belong to the root created by getContainer().\n  // Page scopes inherit them; re-registering resolved ancestor singletons is invalid.\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveControllerInScope(\n  scope: WoodScopedContainer,\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\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 scope.registerClass === 'function') {\n    scope.registerClass(ControllerClass);\n  }\n\n  return await scope.get(ControllerClass);\n}\n\nasync function disposeScopeQuietly(scope: { dispose?: () => Promise<void> } | null): Promise<void> {\n  if (!scope || typeof scope.dispose !== 'function') return;\n  try {\n    await scope.dispose();\n  } catch (error) {\n    console.error('[wood] renderer scope disposal failed:', error);\n  }\n}\n\n/**\n * One page scope per view lifecycle: the view controller and every\n * non-preservable layout controller resolve from the SAME scope, so Scoped\n * services/state are shared within the page (the NoEgo renderer model).\n * Layouts marked preservable in the manifest own dedicated scopes that\n * survive page transitions and dispose when the layout finally leaves.\n */\nasync function createControllerSet(\n  entry: GeneratedAppViewEntry,\n  preservedDepth = 0,\n): Promise<{\n  controller: unknown;\n  layoutControllers: Array<unknown>;\n  pageScope: WoodScopedContainer;\n  layoutScopes: Array<WoodScopedContainer | null>;\n}> {\n  const pageScope = createScopedContainer();\n  const layoutControllers: unknown[] = [];\n  const layoutScopes: Array<WoodScopedContainer | null> = [];\n  const createdLayoutScopes: WoodScopedContainer[] = [];\n\n  try {\n    for (let i = 0; i < preservedDepth; i += 1) {\n      layoutControllers.push(undefined);\n      layoutScopes.push(null);\n    }\n\n    for (let i = preservedDepth; i < entry.layoutControllerClasses.length; i += 1) {\n      const LayoutController = entry.layoutControllerClasses[i];\n      if (!LayoutController) {\n        layoutControllers.push(undefined);\n        layoutScopes.push(null);\n        continue;\n      }\n      const preservable = entry.layoutPreserve?.[i] === true;\n      let scope = pageScope;\n      if (preservable) {\n        scope = createScopedContainer();\n        createdLayoutScopes.push(scope);\n      }\n      const controller = await resolveControllerInScope(\n        scope,\n        entry,\n        LayoutController,\n        \\`layout[\\${i}]\\`,\n      );\n      layoutControllers.push(controller);\n      layoutScopes.push(preservable ? scope : null);\n    }\n\n    const controller = entry.controllerClass\n      ? await resolveControllerInScope(pageScope, entry, entry.controllerClass, 'page')\n      : undefined;\n\n    return { controller, layoutControllers, pageScope, layoutScopes };\n  } catch (error) {\n    // Failed transitions must not orphan scopes: dispose everything this\n    // set created before rethrowing.\n    for (const scope of createdLayoutScopes) await disposeScopeQuietly(scope as any);\n    await disposeScopeQuietly(pageScope as any);\n    throw error;\n  }\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 initialSet = await createControllerSet(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialControllerSet: initialSet,\n      createControllerSetFn: createControllerSet,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/controller/cleanup.cjs

@@ -0,0 +1,39 @@
+"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 cleanup_exports = {};
+__export(cleanup_exports, {
+  cleanupAll: () => cleanupAll
+});
+module.exports = __toCommonJS(cleanup_exports);
+async function cleanupAll(steps, message = "Wood cleanup failed") {
+  const errors = [];
+  for (const step of steps) {
+    try {
+      await step();
+    } catch (error) {
+      errors.push(error);
+    }
+  }
+  if (errors.length) throw Object.assign(new Error(message), { errors, cause: errors[0] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cleanupAll
+});
+//# sourceMappingURL=cleanup.cjs.map

package/dist/controller/cleanup.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controller/cleanup.ts"],"sourcesContent":["/** Attempt every owner in order, preserving all failures (including non-Error throws). */\nexport async function cleanupAll(steps: ReadonlyArray<() => unknown | Promise<unknown>>, message = 'Wood cleanup failed'): Promise<void> {\n  const errors: unknown[] = [];\n  for (const step of steps) {\n    try { await step(); } catch (error) { errors.push(error); }\n  }\n  if (errors.length) throw Object.assign(new Error(message), { errors, cause: errors[0] });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,eAAsB,WAAW,OAAwD,UAAU,uBAAsC;AACvI,QAAM,SAAoB,CAAC;AAC3B,aAAW,QAAQ,OAAO;AACxB,QAAI;AAAE,YAAM,KAAK;AAAA,IAAG,SAAS,OAAO;AAAE,aAAO,KAAK,KAAK;AAAA,IAAG;AAAA,EAC5D;AACA,MAAI,OAAO,OAAQ,OAAM,OAAO,OAAO,IAAI,MAAM,OAAO,GAAG,EAAE,QAAQ,OAAO,OAAO,CAAC,EAAE,CAAC;AACzF;","names":[]}

package/dist/controller/cleanup.d.cts

@@ -0,0 +1,4 @@
+/** Attempt every owner in order, preserving all failures (including non-Error throws). */
+declare function cleanupAll(steps: ReadonlyArray<() => unknown | Promise<unknown>>, message?: string): Promise<void>;
+
+export { cleanupAll };

package/dist/controller/cleanup.d.ts

@@ -0,0 +1,4 @@
+/** Attempt every owner in order, preserving all failures (including non-Error throws). */
+declare function cleanupAll(steps: ReadonlyArray<() => unknown | Promise<unknown>>, message?: string): Promise<void>;
+
+export { cleanupAll };

package/dist/controller/cleanup.js

@@ -0,0 +1,15 @@
+async function cleanupAll(steps, message = "Wood cleanup failed") {
+  const errors = [];
+  for (const step of steps) {
+    try {
+      await step();
+    } catch (error) {
+      errors.push(error);
+    }
+  }
+  if (errors.length) throw Object.assign(new Error(message), { errors, cause: errors[0] });
+}
+export {
+  cleanupAll
+};
+//# sourceMappingURL=cleanup.js.map

package/dist/controller/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controller/cleanup.ts"],"sourcesContent":["/** Attempt every owner in order, preserving all failures (including non-Error throws). */\nexport async function cleanupAll(steps: ReadonlyArray<() => unknown | Promise<unknown>>, message = 'Wood cleanup failed'): Promise<void> {\n  const errors: unknown[] = [];\n  for (const step of steps) {\n    try { await step(); } catch (error) { errors.push(error); }\n  }\n  if (errors.length) throw Object.assign(new Error(message), { errors, cause: errors[0] });\n}\n"],"mappings":"AACA,eAAsB,WAAW,OAAwD,UAAU,uBAAsC;AACvI,QAAM,SAAoB,CAAC;AAC3B,aAAW,QAAQ,OAAO;AACxB,QAAI;AAAE,YAAM,KAAK;AAAA,IAAG,SAAS,OAAO;AAAE,aAAO,KAAK,KAAK;AAAA,IAAG;AAAA,EAC5D;AACA,MAAI,OAAO,OAAQ,OAAM,OAAO,OAAO,IAAI,MAAM,OAAO,GAAG,EAAE,QAAQ,OAAO,OAAO,CAAC,EAAE,CAAC;AACzF;","names":[]}

package/dist/controller/controller_lifecycle.cjs

@@ -18,13 +18,15 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var controller_lifecycle_exports = {};
 __export(controller_lifecycle_exports, {
-  disposeControllerLifecycle: () => disposeControllerLifecycle
+  disposeControllerLifecycle: () => disposeControllerLifecycle,
+  guardControllerLifecycleOnce: () => guardControllerLifecycleOnce
 });
 module.exports = __toCommonJS(controller_lifecycle_exports);
 async function disposeControllerLifecycle(target) {
   if (!target || typeof target !== "object" && typeof target !== "function") {
     return;
   }
+  guardControllerLifecycleOnce(target);
   const lifecycle = target;
   if (typeof lifecycle.dispose === "function") {
     await lifecycle.dispose();
@@ -34,8 +36,30 @@ async function disposeControllerLifecycle(target) {
     await lifecycle.destroy();
   }
 }
+const guardedControllers = /* @__PURE__ */ new WeakSet();
+function guardControllerLifecycleOnce(target) {
+  if (!target || typeof target !== "object" && typeof target !== "function") return;
+  if (guardedControllers.has(target)) return;
+  guardedControllers.add(target);
+  const instance = target;
+  for (const name of ["dispose", "destroy"]) {
+    const original = instance[name];
+    if (typeof original !== "function") continue;
+    let called = false;
+    Object.defineProperty(instance, name, {
+      configurable: true,
+      writable: true,
+      value: function(...args) {
+        if (called) return;
+        called = true;
+        return original.apply(this, args);
+      }
+    });
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  disposeControllerLifecycle
+  disposeControllerLifecycle,
+  guardControllerLifecycleOnce
 });
 //# sourceMappingURL=controller_lifecycle.cjs.map

package/dist/controller/controller_lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n  destroy?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported\n * for existing page controllers.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n    return;\n  }\n  if (typeof lifecycle.destroy === 'function') {\n    await lifecycle.destroy();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AACxB;AAAA,EACF;AACA,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n  destroy?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported\n * for existing page controllers.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  guardControllerLifecycleOnce(target);\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n    return;\n  }\n  if (typeof lifecycle.destroy === 'function') {\n    await lifecycle.destroy();\n  }\n}\n\nconst guardedControllers = new WeakSet<object>();\n\n/** Share one teardown attempt between the explicit controller owner and IoC. */\nexport function guardControllerLifecycleOnce(target: unknown): void {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) return;\n  if (guardedControllers.has(target as object)) return;\n  guardedControllers.add(target as object);\n  const instance = target as Record<string, unknown>;\n  for (const name of ['dispose', 'destroy'] as const) {\n    const original = instance[name];\n    if (typeof original !== 'function') continue;\n    let called = false;\n    Object.defineProperty(instance, name, {\n      configurable: true, writable: true,\n      value: function (this: unknown, ...args: unknown[]) {\n        if (called) return;\n        called = true;\n        return original.apply(this, args);\n      },\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,+BAA6B,MAAM;AACnC,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AACxB;AAAA,EACF;AACA,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;AAEA,MAAM,qBAAqB,oBAAI,QAAgB;AAGxC,SAAS,6BAA6B,QAAuB;AAClE,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,WAAa;AAC7E,MAAI,mBAAmB,IAAI,MAAgB,EAAG;AAC9C,qBAAmB,IAAI,MAAgB;AACvC,QAAM,WAAW;AACjB,aAAW,QAAQ,CAAC,WAAW,SAAS,GAAY;AAClD,UAAM,WAAW,SAAS,IAAI;AAC9B,QAAI,OAAO,aAAa,WAAY;AACpC,QAAI,SAAS;AACb,WAAO,eAAe,UAAU,MAAM;AAAA,MACpC,cAAc;AAAA,MAAM,UAAU;AAAA,MAC9B,OAAO,YAA4B,MAAiB;AAClD,YAAI,OAAQ;AACZ,iBAAS;AACT,eAAO,SAAS,MAAM,MAAM,IAAI;AAAA,MAClC;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/controller/controller_lifecycle.d.cts

@@ -8,5 +8,7 @@ interface ControllerLifecycle {
  * for existing page controllers.
  */
 declare function disposeControllerLifecycle(target: unknown): Promise<void>;
+/** Share one teardown attempt between the explicit controller owner and IoC. */
+declare function guardControllerLifecycleOnce(target: unknown): void;
 
-export { type ControllerLifecycle, disposeControllerLifecycle };
+export { type ControllerLifecycle, disposeControllerLifecycle, guardControllerLifecycleOnce };

package/dist/controller/controller_lifecycle.d.ts

@@ -8,5 +8,7 @@ interface ControllerLifecycle {
  * for existing page controllers.
  */
 declare function disposeControllerLifecycle(target: unknown): Promise<void>;
+/** Share one teardown attempt between the explicit controller owner and IoC. */
+declare function guardControllerLifecycleOnce(target: unknown): void;
 
-export { type ControllerLifecycle, disposeControllerLifecycle };
+export { type ControllerLifecycle, disposeControllerLifecycle, guardControllerLifecycleOnce };

package/dist/controller/controller_lifecycle.js

@@ -2,6 +2,7 @@ async function disposeControllerLifecycle(target) {
   if (!target || typeof target !== "object" && typeof target !== "function") {
     return;
   }
+  guardControllerLifecycleOnce(target);
   const lifecycle = target;
   if (typeof lifecycle.dispose === "function") {
     await lifecycle.dispose();
@@ -11,7 +12,29 @@ async function disposeControllerLifecycle(target) {
     await lifecycle.destroy();
   }
 }
+const guardedControllers = /* @__PURE__ */ new WeakSet();
+function guardControllerLifecycleOnce(target) {
+  if (!target || typeof target !== "object" && typeof target !== "function") return;
+  if (guardedControllers.has(target)) return;
+  guardedControllers.add(target);
+  const instance = target;
+  for (const name of ["dispose", "destroy"]) {
+    const original = instance[name];
+    if (typeof original !== "function") continue;
+    let called = false;
+    Object.defineProperty(instance, name, {
+      configurable: true,
+      writable: true,
+      value: function(...args) {
+        if (called) return;
+        called = true;
+        return original.apply(this, args);
+      }
+    });
+  }
+}
 export {
-  disposeControllerLifecycle
+  disposeControllerLifecycle,
+  guardControllerLifecycleOnce
 };
 //# sourceMappingURL=controller_lifecycle.js.map

package/dist/controller/controller_lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n  destroy?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported\n * for existing page controllers.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n    return;\n  }\n  if (typeof lifecycle.destroy === 'function') {\n    await lifecycle.destroy();\n  }\n}\n"],"mappings":"AAUA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AACxB;AAAA,EACF;AACA,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n  destroy?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported\n * for existing page controllers.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  guardControllerLifecycleOnce(target);\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n    return;\n  }\n  if (typeof lifecycle.destroy === 'function') {\n    await lifecycle.destroy();\n  }\n}\n\nconst guardedControllers = new WeakSet<object>();\n\n/** Share one teardown attempt between the explicit controller owner and IoC. */\nexport function guardControllerLifecycleOnce(target: unknown): void {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) return;\n  if (guardedControllers.has(target as object)) return;\n  guardedControllers.add(target as object);\n  const instance = target as Record<string, unknown>;\n  for (const name of ['dispose', 'destroy'] as const) {\n    const original = instance[name];\n    if (typeof original !== 'function') continue;\n    let called = false;\n    Object.defineProperty(instance, name, {\n      configurable: true, writable: true,\n      value: function (this: unknown, ...args: unknown[]) {\n        if (called) return;\n        called = true;\n        return original.apply(this, args);\n      },\n    });\n  }\n}\n"],"mappings":"AAUA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,+BAA6B,MAAM;AACnC,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AACxB;AAAA,EACF;AACA,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;AAEA,MAAM,qBAAqB,oBAAI,QAAgB;AAGxC,SAAS,6BAA6B,QAAuB;AAClE,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,WAAa;AAC7E,MAAI,mBAAmB,IAAI,MAAgB,EAAG;AAC9C,qBAAmB,IAAI,MAAgB;AACvC,QAAM,WAAW;AACjB,aAAW,QAAQ,CAAC,WAAW,SAAS,GAAY;AAClD,UAAM,WAAW,SAAS,IAAI;AAC9B,QAAI,OAAO,aAAa,WAAY;AACpC,QAAI,SAAS;AACb,WAAO,eAAe,UAAU,MAAM;AAAA,MACpC,cAAc;AAAA,MAAM,UAAU;AAAA,MAC9B,OAAO,YAA4B,MAAiB;AAClD,YAAI,OAAQ;AACZ,iBAAS;AACT,eAAO,SAAS,MAAM,MAAM,IAAI;AAAA,MAClC;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/frontend/frontend_lifecycle.cjs

@@ -21,6 +21,7 @@ __export(frontend_lifecycle_exports, {
   FrontendLifecycleOwner: () => FrontendLifecycleOwner
 });
 module.exports = __toCommonJS(frontend_lifecycle_exports);
+var import_cleanup = require("../controller/cleanup.js");
 var import_work_registry = require("./work_registry.js");
 class FrontendLifecycleOwner {
   constructor(registry, owner) {
@@ -56,15 +57,12 @@ class FrontendLifecycleOwner {
   get isDisposed() {
     return this.disposed;
   }
-  /** Abort owned work and dispose owned resources in reverse order. */
-  async dispose() {
-    if (this.disposed) return;
+  dispose() {
+    if (this.closing) return this.closing;
     this.disposed = true;
     this.abortController.abort();
-    for (const resource of this.resources.reverse()) {
-      await resource.dispose();
-    }
-    this.resources.length = 0;
+    const resources = this.resources.splice(0).reverse();
+    return this.closing = (0, import_cleanup.cleanupAll)(resources.map((resource) => () => resource.dispose()), "Wood frontend lifecycle cleanup failed");
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/frontend/frontend_lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/frontend/frontend_lifecycle.ts"],"sourcesContent":["/**\n * Production lifecycle owners for deliberately detached frontend work\n * (18A D-FAS-01 §2.2). Two natural owners exist per environment:\n *\n *   page lifecycle         — default for PageController work; aborted and\n *                            disposed when that page ends\n *   application lifecycle  — explicit for work that intentionally survives\n *                            page navigation; disposed with the environment\n *\n * PageControllers/client services register their own deliberately detached\n * finite work through their injected lifecycle owner — tests do not repair\n * unowned product code by wrapping it in track() from the outside.\n */\nimport { WorkRegistry, FrontendWorkError } from './work_registry.js';\n\nexport interface FrontendLifecycle {\n  readonly signal: AbortSignal;\n\n  track<T>(\n    work: Promise<T>,\n    options: {\n      label: string;\n      kind?: string;\n    },\n  ): Promise<T>;\n\n  own(resource: { dispose(): void | Promise<void> }): void;\n}\n\nexport class FrontendLifecycleOwner implements FrontendLifecycle {\n  private readonly abortController = new AbortController();\n  private readonly resources: Array<{ dispose(): void | Promise<void> }> = [];\n  private disposed = false;\n\n  constructor(\n    private readonly registry: WorkRegistry,\n    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */\n    readonly owner: string,\n  ) {}\n\n  get signal(): AbortSignal {\n    return this.abortController.signal;\n  }\n\n  track<T>(work: Promise<T>, options: { label: string; kind?: string }): Promise<T> {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot track \"${options.label}\": lifecycle \"${this.owner}\" is disposed. ` +\n        'Work started after a page/environment ended is a product lifecycle bug.',\n      );\n    }\n    return this.registry.track(work, {\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: this.owner,\n    });\n  }\n\n  own(resource: { dispose(): void | Promise<void> }): void {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot own a resource: lifecycle \"${this.owner}\" is disposed.`,\n      );\n    }\n    this.resources.push(resource);\n  }\n\n  get isDisposed(): boolean {\n    return this.disposed;\n  }\n\n  /** Abort owned work and dispose owned resources in reverse order. */\n  async dispose(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.abortController.abort();\n    for (const resource of this.resources.reverse()) {\n      await resource.dispose();\n    }\n    this.resources.length = 0;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,2BAAgD;AAgBzC,MAAM,uBAAoD;AAAA,EAK/D,YACmB,UAER,OACT;AAHiB;AAER;AAPX,SAAiB,kBAAkB,IAAI,gBAAgB;AACvD,SAAiB,YAAwD,CAAC;AAC1E,SAAQ,WAAW;AAAA,EAMhB;AAAA,EAEH,IAAI,SAAsB;AACxB,WAAO,KAAK,gBAAgB;AAAA,EAC9B;AAAA,EAEA,MAAS,MAAkB,SAAuD;AAChF,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,iBAAiB,QAAQ,KAAK,iBAAiB,KAAK,KAAK;AAAA,MAE3D;AAAA,IACF;AACA,WAAO,KAAK,SAAS,MAAM,MAAM;AAAA,MAC/B,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ,QAAQ;AAAA,MACtB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,UAAqD;AACvD,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,qCAAqC,KAAK,KAAK;AAAA,MACjD;AAAA,IACF;AACA,SAAK,UAAU,KAAK,QAAQ;AAAA,EAC9B;AAAA,EAEA,IAAI,aAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,UAAyB;AAC7B,QAAI,KAAK,SAAU;AACnB,SAAK,WAAW;AAChB,SAAK,gBAAgB,MAAM;AAC3B,eAAW,YAAY,KAAK,UAAU,QAAQ,GAAG;AAC/C,YAAM,SAAS,QAAQ;AAAA,IACzB;AACA,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"sources":["../../src/frontend/frontend_lifecycle.ts"],"sourcesContent":["/**\n * Production lifecycle owners for deliberately detached frontend work\n * (18A D-FAS-01 §2.2). Two natural owners exist per environment:\n *\n *   page lifecycle         — default for PageController work; aborted and\n *                            disposed when that page ends\n *   application lifecycle  — explicit for work that intentionally survives\n *                            page navigation; disposed with the environment\n *\n * PageControllers/client services register their own deliberately detached\n * finite work through their injected lifecycle owner — tests do not repair\n * unowned product code by wrapping it in track() from the outside.\n */\nimport { cleanupAll } from '../controller/cleanup.js';\nimport { WorkRegistry, FrontendWorkError } from './work_registry.js';\n\nexport interface FrontendLifecycle {\n  readonly signal: AbortSignal;\n\n  track<T>(\n    work: Promise<T>,\n    options: {\n      label: string;\n      kind?: string;\n    },\n  ): Promise<T>;\n\n  own(resource: { dispose(): void | Promise<void> }): void;\n}\n\nexport class FrontendLifecycleOwner implements FrontendLifecycle {\n  private readonly abortController = new AbortController();\n  private readonly resources: Array<{ dispose(): void | Promise<void> }> = [];\n  private disposed = false;\n\n  constructor(\n    private readonly registry: WorkRegistry,\n    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */\n    readonly owner: string,\n  ) {}\n\n  get signal(): AbortSignal {\n    return this.abortController.signal;\n  }\n\n  track<T>(work: Promise<T>, options: { label: string; kind?: string }): Promise<T> {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot track \"${options.label}\": lifecycle \"${this.owner}\" is disposed. ` +\n        'Work started after a page/environment ended is a product lifecycle bug.',\n      );\n    }\n    return this.registry.track(work, {\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: this.owner,\n    });\n  }\n\n  own(resource: { dispose(): void | Promise<void> }): void {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot own a resource: lifecycle \"${this.owner}\" is disposed.`,\n      );\n    }\n    this.resources.push(resource);\n  }\n\n  get isDisposed(): boolean {\n    return this.disposed;\n  }\n\n  /** Abort owned work and dispose owned resources in reverse order. */\n  private closing?: Promise<void>;\n  dispose(): Promise<void> {\n    if (this.closing) return this.closing;\n    this.disposed = true;\n    this.abortController.abort();\n    const resources = this.resources.splice(0).reverse();\n    return this.closing = cleanupAll(resources.map(resource => () => resource.dispose()), 'Wood frontend lifecycle cleanup failed');\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,qBAA2B;AAC3B,2BAAgD;AAgBzC,MAAM,uBAAoD;AAAA,EAK/D,YACmB,UAER,OACT;AAHiB;AAER;AAPX,SAAiB,kBAAkB,IAAI,gBAAgB;AACvD,SAAiB,YAAwD,CAAC;AAC1E,SAAQ,WAAW;AAAA,EAMhB;AAAA,EAEH,IAAI,SAAsB;AACxB,WAAO,KAAK,gBAAgB;AAAA,EAC9B;AAAA,EAEA,MAAS,MAAkB,SAAuD;AAChF,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,iBAAiB,QAAQ,KAAK,iBAAiB,KAAK,KAAK;AAAA,MAE3D;AAAA,IACF;AACA,WAAO,KAAK,SAAS,MAAM,MAAM;AAAA,MAC/B,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ,QAAQ;AAAA,MACtB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,UAAqD;AACvD,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,qCAAqC,KAAK,KAAK;AAAA,MACjD;AAAA,IACF;AACA,SAAK,UAAU,KAAK,QAAQ;AAAA,EAC9B;AAAA,EAEA,IAAI,aAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA,EAIA,UAAyB;AACvB,QAAI,KAAK,QAAS,QAAO,KAAK;AAC9B,SAAK,WAAW;AAChB,SAAK,gBAAgB,MAAM;AAC3B,UAAM,YAAY,KAAK,UAAU,OAAO,CAAC,EAAE,QAAQ;AACnD,WAAO,KAAK,cAAU,2BAAW,UAAU,IAAI,cAAY,MAAM,SAAS,QAAQ,CAAC,GAAG,wCAAwC;AAAA,EAChI;AACF;","names":[]}

package/dist/frontend/frontend_lifecycle.d.cts

@@ -1,19 +1,5 @@
 import { WorkRegistry } from './work_registry.cjs';
 
-/**
- * Production lifecycle owners for deliberately detached frontend work
- * (18A D-FAS-01 §2.2). Two natural owners exist per environment:
- *
- *   page lifecycle         — default for PageController work; aborted and
- *                            disposed when that page ends
- *   application lifecycle  — explicit for work that intentionally survives
- *                            page navigation; disposed with the environment
- *
- * PageControllers/client services register their own deliberately detached
- * finite work through their injected lifecycle owner — tests do not repair
- * unowned product code by wrapping it in track() from the outside.
- */
-
 interface FrontendLifecycle {
     readonly signal: AbortSignal;
     track<T>(work: Promise<T>, options: {
@@ -44,6 +30,7 @@ declare class FrontendLifecycleOwner implements FrontendLifecycle {
     }): void;
     get isDisposed(): boolean;
     /** Abort owned work and dispose owned resources in reverse order. */
+    private closing?;
     dispose(): Promise<void>;
 }
 

package/dist/frontend/frontend_lifecycle.d.ts

@@ -1,19 +1,5 @@
 import { WorkRegistry } from './work_registry.js';
 
-/**
- * Production lifecycle owners for deliberately detached frontend work
- * (18A D-FAS-01 §2.2). Two natural owners exist per environment:
- *
- *   page lifecycle         — default for PageController work; aborted and
- *                            disposed when that page ends
- *   application lifecycle  — explicit for work that intentionally survives
- *                            page navigation; disposed with the environment
- *
- * PageControllers/client services register their own deliberately detached
- * finite work through their injected lifecycle owner — tests do not repair
- * unowned product code by wrapping it in track() from the outside.
- */
-
 interface FrontendLifecycle {
     readonly signal: AbortSignal;
     track<T>(work: Promise<T>, options: {
@@ -44,6 +30,7 @@ declare class FrontendLifecycleOwner implements FrontendLifecycle {
     }): void;
     get isDisposed(): boolean;
     /** Abort owned work and dispose owned resources in reverse order. */
+    private closing?;
     dispose(): Promise<void>;
 }
 

package/dist/frontend/frontend_lifecycle.js

@@ -1,3 +1,4 @@
+import { cleanupAll } from "../controller/cleanup.js";
 import { FrontendWorkError } from "./work_registry.js";
 class FrontendLifecycleOwner {
   constructor(registry, owner) {
@@ -33,15 +34,12 @@ class FrontendLifecycleOwner {
   get isDisposed() {
     return this.disposed;
   }
-  /** Abort owned work and dispose owned resources in reverse order. */
-  async dispose() {
-    if (this.disposed) return;
+  dispose() {
+    if (this.closing) return this.closing;
     this.disposed = true;
     this.abortController.abort();
-    for (const resource of this.resources.reverse()) {
-      await resource.dispose();
-    }
-    this.resources.length = 0;
+    const resources = this.resources.splice(0).reverse();
+    return this.closing = cleanupAll(resources.map((resource) => () => resource.dispose()), "Wood frontend lifecycle cleanup failed");
   }
 }
 export {

package/dist/frontend/frontend_lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/frontend/frontend_lifecycle.ts"],"sourcesContent":["/**\n * Production lifecycle owners for deliberately detached frontend work\n * (18A D-FAS-01 §2.2). Two natural owners exist per environment:\n *\n *   page lifecycle         — default for PageController work; aborted and\n *                            disposed when that page ends\n *   application lifecycle  — explicit for work that intentionally survives\n *                            page navigation; disposed with the environment\n *\n * PageControllers/client services register their own deliberately detached\n * finite work through their injected lifecycle owner — tests do not repair\n * unowned product code by wrapping it in track() from the outside.\n */\nimport { WorkRegistry, FrontendWorkError } from './work_registry.js';\n\nexport interface FrontendLifecycle {\n  readonly signal: AbortSignal;\n\n  track<T>(\n    work: Promise<T>,\n    options: {\n      label: string;\n      kind?: string;\n    },\n  ): Promise<T>;\n\n  own(resource: { dispose(): void | Promise<void> }): void;\n}\n\nexport class FrontendLifecycleOwner implements FrontendLifecycle {\n  private readonly abortController = new AbortController();\n  private readonly resources: Array<{ dispose(): void | Promise<void> }> = [];\n  private disposed = false;\n\n  constructor(\n    private readonly registry: WorkRegistry,\n    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */\n    readonly owner: string,\n  ) {}\n\n  get signal(): AbortSignal {\n    return this.abortController.signal;\n  }\n\n  track<T>(work: Promise<T>, options: { label: string; kind?: string }): Promise<T> {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot track \"${options.label}\": lifecycle \"${this.owner}\" is disposed. ` +\n        'Work started after a page/environment ended is a product lifecycle bug.',\n      );\n    }\n    return this.registry.track(work, {\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: this.owner,\n    });\n  }\n\n  own(resource: { dispose(): void | Promise<void> }): void {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot own a resource: lifecycle \"${this.owner}\" is disposed.`,\n      );\n    }\n    this.resources.push(resource);\n  }\n\n  get isDisposed(): boolean {\n    return this.disposed;\n  }\n\n  /** Abort owned work and dispose owned resources in reverse order. */\n  async dispose(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.abortController.abort();\n    for (const resource of this.resources.reverse()) {\n      await resource.dispose();\n    }\n    this.resources.length = 0;\n  }\n}\n"],"mappings":"AAaA,SAAuB,yBAAyB;AAgBzC,MAAM,uBAAoD;AAAA,EAK/D,YACmB,UAER,OACT;AAHiB;AAER;AAPX,SAAiB,kBAAkB,IAAI,gBAAgB;AACvD,SAAiB,YAAwD,CAAC;AAC1E,SAAQ,WAAW;AAAA,EAMhB;AAAA,EAEH,IAAI,SAAsB;AACxB,WAAO,KAAK,gBAAgB;AAAA,EAC9B;AAAA,EAEA,MAAS,MAAkB,SAAuD;AAChF,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,iBAAiB,QAAQ,KAAK,iBAAiB,KAAK,KAAK;AAAA,MAE3D;AAAA,IACF;AACA,WAAO,KAAK,SAAS,MAAM,MAAM;AAAA,MAC/B,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ,QAAQ;AAAA,MACtB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,UAAqD;AACvD,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,qCAAqC,KAAK,KAAK;AAAA,MACjD;AAAA,IACF;AACA,SAAK,UAAU,KAAK,QAAQ;AAAA,EAC9B;AAAA,EAEA,IAAI,aAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,UAAyB;AAC7B,QAAI,KAAK,SAAU;AACnB,SAAK,WAAW;AAChB,SAAK,gBAAgB,MAAM;AAC3B,eAAW,YAAY,KAAK,UAAU,QAAQ,GAAG;AAC/C,YAAM,SAAS,QAAQ;AAAA,IACzB;AACA,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"sources":["../../src/frontend/frontend_lifecycle.ts"],"sourcesContent":["/**\n * Production lifecycle owners for deliberately detached frontend work\n * (18A D-FAS-01 §2.2). Two natural owners exist per environment:\n *\n *   page lifecycle         — default for PageController work; aborted and\n *                            disposed when that page ends\n *   application lifecycle  — explicit for work that intentionally survives\n *                            page navigation; disposed with the environment\n *\n * PageControllers/client services register their own deliberately detached\n * finite work through their injected lifecycle owner — tests do not repair\n * unowned product code by wrapping it in track() from the outside.\n */\nimport { cleanupAll } from '../controller/cleanup.js';\nimport { WorkRegistry, FrontendWorkError } from './work_registry.js';\n\nexport interface FrontendLifecycle {\n  readonly signal: AbortSignal;\n\n  track<T>(\n    work: Promise<T>,\n    options: {\n      label: string;\n      kind?: string;\n    },\n  ): Promise<T>;\n\n  own(resource: { dispose(): void | Promise<void> }): void;\n}\n\nexport class FrontendLifecycleOwner implements FrontendLifecycle {\n  private readonly abortController = new AbortController();\n  private readonly resources: Array<{ dispose(): void | Promise<void> }> = [];\n  private disposed = false;\n\n  constructor(\n    private readonly registry: WorkRegistry,\n    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */\n    readonly owner: string,\n  ) {}\n\n  get signal(): AbortSignal {\n    return this.abortController.signal;\n  }\n\n  track<T>(work: Promise<T>, options: { label: string; kind?: string }): Promise<T> {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot track \"${options.label}\": lifecycle \"${this.owner}\" is disposed. ` +\n        'Work started after a page/environment ended is a product lifecycle bug.',\n      );\n    }\n    return this.registry.track(work, {\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: this.owner,\n    });\n  }\n\n  own(resource: { dispose(): void | Promise<void> }): void {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot own a resource: lifecycle \"${this.owner}\" is disposed.`,\n      );\n    }\n    this.resources.push(resource);\n  }\n\n  get isDisposed(): boolean {\n    return this.disposed;\n  }\n\n  /** Abort owned work and dispose owned resources in reverse order. */\n  private closing?: Promise<void>;\n  dispose(): Promise<void> {\n    if (this.closing) return this.closing;\n    this.disposed = true;\n    this.abortController.abort();\n    const resources = this.resources.splice(0).reverse();\n    return this.closing = cleanupAll(resources.map(resource => () => resource.dispose()), 'Wood frontend lifecycle cleanup failed');\n  }\n}\n"],"mappings":"AAaA,SAAS,kBAAkB;AAC3B,SAAuB,yBAAyB;AAgBzC,MAAM,uBAAoD;AAAA,EAK/D,YACmB,UAER,OACT;AAHiB;AAER;AAPX,SAAiB,kBAAkB,IAAI,gBAAgB;AACvD,SAAiB,YAAwD,CAAC;AAC1E,SAAQ,WAAW;AAAA,EAMhB;AAAA,EAEH,IAAI,SAAsB;AACxB,WAAO,KAAK,gBAAgB;AAAA,EAC9B;AAAA,EAEA,MAAS,MAAkB,SAAuD;AAChF,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,iBAAiB,QAAQ,KAAK,iBAAiB,KAAK,KAAK;AAAA,MAE3D;AAAA,IACF;AACA,WAAO,KAAK,SAAS,MAAM,MAAM;AAAA,MAC/B,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ,QAAQ;AAAA,MACtB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,UAAqD;AACvD,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,qCAAqC,KAAK,KAAK;AAAA,MACjD;AAAA,IACF;AACA,SAAK,UAAU,KAAK,QAAQ;AAAA,EAC9B;AAAA,EAEA,IAAI,aAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA,EAIA,UAAyB;AACvB,QAAI,KAAK,QAAS,QAAO,KAAK;AAC9B,SAAK,WAAW;AAChB,SAAK,gBAAgB,MAAM;AAC3B,UAAM,YAAY,KAAK,UAAU,OAAO,CAAC,EAAE,QAAQ;AACnD,WAAO,KAAK,UAAU,WAAW,UAAU,IAAI,cAAY,MAAM,SAAS,QAAQ,CAAC,GAAG,wCAAwC;AAAA,EAChI;AACF;","names":[]}