@noego/wood 0.4.10 → 0.5.0

package/dist/navigation/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["import { emitRendererTrace } from '../tracing/index.js';\n\nconst NAVIGATION_SYMBOL = Symbol.for('@noego/wood.navigation');\nconst HISTORY_STATE_MARKER = '__wood_navigation_state__';\n\nexport interface NavigationEntry {\n  page: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  options: NavigationOptions;\n}\n\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\n\ntype NavigationHistoryState = NavigationEntry & {\n  [HISTORY_STATE_MARKER]: true;\n};\n\ntype NavigationListener = (entry: NavigationEntry | null) => void;\n\nexport class Navigation {\n  private entries: NavigationEntry[] = [];\n  private index = -1;\n  private listeners = new Set<NavigationListener>();\n\n  getCurrent(): NavigationEntry | null {\n    if (this.index < 0 || this.index >= this.entries.length) {\n      return null;\n    }\n    return this.cloneEntry(this.entries[this.index]);\n  }\n\n  getPages(): NavigationEntry[] {\n    return this.entries.map((entry) => this.cloneEntry(entry));\n  }\n\n  getParams(): Record<string, string> {\n    const current = this.getCurrent();\n    if (!current) {\n      return {};\n    }\n    return { ...current.params };\n  }\n\n  replace(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n\n    if (this.index < 0) {\n      this.entries.push(entry);\n      this.index = 0;\n    } else {\n      this.entries[this.index] = entry;\n    }\n\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.replace',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  go(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n    if (this.index < this.entries.length - 1) {\n      this.entries = this.entries.slice(0, this.index + 1);\n    }\n    this.entries.push(entry);\n    this.index = this.entries.length - 1;\n\n    this.writeWindowHistory('pushState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.go',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  goto(delta: number): NavigationEntry | null {\n    return this.moveCursor(delta);\n  }\n\n  goBack(): NavigationEntry | null {\n    return this.goto(-1);\n  }\n\n  goForward(): NavigationEntry | null {\n    return this.goto(1);\n  }\n\n  subscribe(listener: NavigationListener): () => void {\n    this.listeners.add(listener);\n    listener(this.getCurrent());\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private moveCursor(delta: number): NavigationEntry | null {\n    if (delta === 0) {\n      return this.getCurrent();\n    }\n\n    const nextIndex = this.index + delta;\n    if (nextIndex < 0 || nextIndex >= this.entries.length) {\n      return this.getCurrent();\n    }\n\n    this.index = nextIndex;\n    const entry = this.entries[this.index];\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.goto',\n      payload: {\n        delta,\n        page: entry.page,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  private notify(): void {\n    const current = this.getCurrent();\n    for (const listener of this.listeners) {\n      listener(current);\n    }\n  }\n\n  private createEntry(\n    page: string,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    options: NavigationOptions,\n  ): NavigationEntry {\n    return {\n      page,\n      params: this.normalizeRecord(params),\n      query: this.normalizeRecord(query),\n      options: { ...options },\n    };\n  }\n\n  private cloneEntry(entry: NavigationEntry): NavigationEntry {\n    return {\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n  }\n\n  private normalizeRecord(input: Record<string, string>): Record<string, string> {\n    const output: Record<string, string> = {};\n    for (const [key, value] of Object.entries(input ?? {})) {\n      output[String(key)] = String(value);\n    }\n    return output;\n  }\n\n  private writeWindowHistory(\n    mode: 'pushState' | 'replaceState',\n    entry: NavigationEntry,\n  ): void {\n    if (typeof window === 'undefined') {\n      return;\n    }\n\n    const state: NavigationHistoryState = {\n      [HISTORY_STATE_MARKER]: true,\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n\n    window.history[mode](state, '');\n  }\n}\n\ntype GlobalWithNavigation = typeof globalThis & {\n  [NAVIGATION_SYMBOL]?: Navigation;\n};\n\nfunction createNavigationInstance(): Navigation {\n  return new Navigation();\n}\n\nexport function getNavigation(): Navigation {\n  const globalObj = globalThis as GlobalWithNavigation;\n  if (!globalObj[NAVIGATION_SYMBOL]) {\n    globalObj[NAVIGATION_SYMBOL] = createNavigationInstance();\n  }\n  return globalObj[NAVIGATION_SYMBOL];\n}\n\nexport function goto(\n  delta: number,\n): NavigationEntry | null {\n  return getNavigation().goto(delta);\n}\n\nexport function go(\n  page: string,\n  params: Record<string, string> = {},\n  query: Record<string, string> = {},\n  options: NavigationOptions = {},\n): NavigationEntry {\n  return getNavigation().go(page, params, query, options);\n}\n\nexport function goback(): NavigationEntry | null {\n  return goto(-1);\n}\n\n/** Test-only helper to clear the navigation singleton. */\nexport function clearNavigationForTests(): void {\n  const globalObj = globalThis as GlobalWithNavigation;\n  delete globalObj[NAVIGATION_SYMBOL];\n}\n\n// Dev/test-only automation introspection surface (Axe AXE-WP-02).\n// Benign import cycle: automation_introspection uses getNavigation lazily.\n// NOTE: keep these re-exports single-line — the tsup extension-rewrite plugin\n// only rewrites single-line import/export specifiers.\nexport { installAutomationIntrospection, WOOD_AUTOMATION_GLOBAL_KEY } from './automation_introspection.js';\nexport type { WoodAutomationSnapshot, WoodAutomationEvent, WoodAutomationIntrospection, InstallAutomationIntrospectionOptions } from './automation_introspection.js';\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["import { emitRendererTrace } from '../tracing/index.js';\n\nconst NAVIGATION_SYMBOL = Symbol.for('@noego/wood.navigation');\nconst HISTORY_STATE_MARKER = '__wood_navigation_state__';\n\nexport interface NavigationEntry {\n  page: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  options: NavigationOptions;\n}\n\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\n\ntype NavigationHistoryState = NavigationEntry & {\n  [HISTORY_STATE_MARKER]: true;\n};\n\ntype NavigationListener = (entry: NavigationEntry | null) => void;\n\nexport class Navigation {\n  private entries: NavigationEntry[] = [];\n  private index = -1;\n  private listeners = new Set<NavigationListener>();\n\n  getCurrent(): NavigationEntry | null {\n    if (this.index < 0 || this.index >= this.entries.length) {\n      return null;\n    }\n    return this.cloneEntry(this.entries[this.index]);\n  }\n\n  getPages(): NavigationEntry[] {\n    return this.entries.map((entry) => this.cloneEntry(entry));\n  }\n\n  getParams(): Record<string, string> {\n    const current = this.getCurrent();\n    if (!current) {\n      return {};\n    }\n    return { ...current.params };\n  }\n\n  replace(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n\n    if (this.index < 0) {\n      this.entries.push(entry);\n      this.index = 0;\n    } else {\n      this.entries[this.index] = entry;\n    }\n\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.replace',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  go(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n    if (this.index < this.entries.length - 1) {\n      this.entries = this.entries.slice(0, this.index + 1);\n    }\n    this.entries.push(entry);\n    this.index = this.entries.length - 1;\n\n    this.writeWindowHistory('pushState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.go',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  goto(delta: number): NavigationEntry | null {\n    return this.moveCursor(delta);\n  }\n\n  goBack(): NavigationEntry | null {\n    return this.goto(-1);\n  }\n\n  goForward(): NavigationEntry | null {\n    return this.goto(1);\n  }\n\n  subscribe(listener: NavigationListener): () => void {\n    this.listeners.add(listener);\n    listener(this.getCurrent());\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private moveCursor(delta: number): NavigationEntry | null {\n    if (delta === 0) {\n      return this.getCurrent();\n    }\n\n    const nextIndex = this.index + delta;\n    if (nextIndex < 0 || nextIndex >= this.entries.length) {\n      return this.getCurrent();\n    }\n\n    this.index = nextIndex;\n    const entry = this.entries[this.index];\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.goto',\n      payload: {\n        delta,\n        page: entry.page,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  private notify(): void {\n    const current = this.getCurrent();\n    for (const listener of this.listeners) {\n      listener(current);\n    }\n  }\n\n  private createEntry(\n    page: string,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    options: NavigationOptions,\n  ): NavigationEntry {\n    return {\n      page,\n      params: this.normalizeRecord(params),\n      query: this.normalizeRecord(query),\n      options: { ...options },\n    };\n  }\n\n  private cloneEntry(entry: NavigationEntry): NavigationEntry {\n    return {\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n  }\n\n  private normalizeRecord(input: Record<string, string>): Record<string, string> {\n    const output: Record<string, string> = {};\n    for (const [key, value] of Object.entries(input ?? {})) {\n      output[String(key)] = String(value);\n    }\n    return output;\n  }\n\n  private writeWindowHistory(\n    mode: 'pushState' | 'replaceState',\n    entry: NavigationEntry,\n  ): void {\n    if (typeof window === 'undefined') {\n      return;\n    }\n\n    const state: NavigationHistoryState = {\n      [HISTORY_STATE_MARKER]: true,\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n\n    window.history[mode](state, '');\n  }\n}\n\ntype GlobalWithNavigation = typeof globalThis & {\n  [NAVIGATION_SYMBOL]?: Navigation;\n};\n\nfunction createNavigationInstance(): Navigation {\n  return new Navigation();\n}\n\nexport function getNavigation(): Navigation {\n  const globalObj = globalThis as GlobalWithNavigation;\n  if (!globalObj[NAVIGATION_SYMBOL]) {\n    globalObj[NAVIGATION_SYMBOL] = createNavigationInstance();\n  }\n  return globalObj[NAVIGATION_SYMBOL];\n}\n\nexport function goto(\n  delta: number,\n): NavigationEntry | null {\n  return getNavigation().goto(delta);\n}\n\nexport function go(\n  page: string,\n  params: Record<string, string> = {},\n  query: Record<string, string> = {},\n  options: NavigationOptions = {},\n): NavigationEntry {\n  return getNavigation().go(page, params, query, options);\n}\n\nexport function goback(): NavigationEntry | null {\n  return goto(-1);\n}\n\n/** Test-only helper to clear the navigation singleton. */\nexport function clearNavigationForTests(): void {\n  const globalObj = globalThis as GlobalWithNavigation;\n  delete globalObj[NAVIGATION_SYMBOL];\n}\n\n// Dev/test-only automation introspection surface (Axe AXE-WP-02).\n// Benign import cycle: automation_introspection uses getNavigation lazily.\n// NOTE: keep these re-exports single-line — the tsup extension-rewrite plugin\n// only rewrites single-line import/export specifiers.\nexport { installAutomationIntrospection, WOOD_AUTOMATION_GLOBAL_KEY } from './automation_introspection.js';\nexport type { WoodAutomationSnapshot, WoodAutomationEvent, WoodAutomationIntrospection, InstallAutomationIntrospectionOptions } from './automation_introspection.js';\nexport { computePreservedLayoutDepth } from './layout_preservation.js';\nexport type { LayoutStack } from './layout_preservation.js';\n"],"mappings":"AAAA,SAAS,yBAAyB;AAElC,MAAM,oBAAoB,uBAAO,IAAI,wBAAwB;AAC7D,MAAM,uBAAuB;AAmBtB,MAAM,WAAW;AAAA,EAAjB;AACL,SAAQ,UAA6B,CAAC;AACtC,SAAQ,QAAQ;AAChB,SAAQ,YAAY,oBAAI,IAAwB;AAAA;AAAA,EAEhD,aAAqC;AACnC,QAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,QAAQ,QAAQ;AACvD,aAAO;AAAA,IACT;AACA,WAAO,KAAK,WAAW,KAAK,QAAQ,KAAK,KAAK,CAAC;AAAA,EACjD;AAAA,EAEA,WAA8B;AAC5B,WAAO,KAAK,QAAQ,IAAI,CAAC,UAAU,KAAK,WAAW,KAAK,CAAC;AAAA,EAC3D;AAAA,EAEA,YAAoC;AAClC,UAAM,UAAU,KAAK,WAAW;AAChC,QAAI,CAAC,SAAS;AACZ,aAAO,CAAC;AAAA,IACV;AACA,WAAO,EAAE,GAAG,QAAQ,OAAO;AAAA,EAC7B;AAAA,EAEA,QACE,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,UAAM,QAAQ,KAAK,YAAY,MAAM,QAAQ,OAAO,OAAO;AAE3D,QAAI,KAAK,QAAQ,GAAG;AAClB,WAAK,QAAQ,KAAK,KAAK;AACvB,WAAK,QAAQ;AAAA,IACf,OAAO;AACL,WAAK,QAAQ,KAAK,KAAK,IAAI;AAAA,IAC7B;AAEA,SAAK,mBAAmB,gBAAgB,KAAK;AAC7C,SAAK,OAAO;AACZ,sBAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP,MAAM,MAAM;AAAA,QACZ,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,SAAS,MAAM;AAAA,MACjB;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,GACE,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,UAAM,QAAQ,KAAK,YAAY,MAAM,QAAQ,OAAO,OAAO;AAC3D,QAAI,KAAK,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACxC,WAAK,UAAU,KAAK,QAAQ,MAAM,GAAG,KAAK,QAAQ,CAAC;AAAA,IACrD;AACA,SAAK,QAAQ,KAAK,KAAK;AACvB,SAAK,QAAQ,KAAK,QAAQ,SAAS;AAEnC,SAAK,mBAAmB,aAAa,KAAK;AAC1C,SAAK,OAAO;AACZ,sBAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP,MAAM,MAAM;AAAA,QACZ,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,SAAS,MAAM;AAAA,MACjB;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,KAAK,OAAuC;AAC1C,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,SAAiC;AAC/B,WAAO,KAAK,KAAK,EAAE;AAAA,EACrB;AAAA,EAEA,YAAoC;AAClC,WAAO,KAAK,KAAK,CAAC;AAAA,EACpB;AAAA,EAEA,UAAU,UAA0C;AAClD,SAAK,UAAU,IAAI,QAAQ;AAC3B,aAAS,KAAK,WAAW,CAAC;AAC1B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AAAA,EAEQ,WAAW,OAAuC;AACxD,QAAI,UAAU,GAAG;AACf,aAAO,KAAK,WAAW;AAAA,IACzB;AAEA,UAAM,YAAY,KAAK,QAAQ;AAC/B,QAAI,YAAY,KAAK,aAAa,KAAK,QAAQ,QAAQ;AACrD,aAAO,KAAK,WAAW;AAAA,IACzB;AAEA,SAAK,QAAQ;AACb,UAAM,QAAQ,KAAK,QAAQ,KAAK,KAAK;AACrC,SAAK,mBAAmB,gBAAgB,KAAK;AAC7C,SAAK,OAAO;AACZ,sBAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP;AAAA,QACA,MAAM,MAAM;AAAA,MACd;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEQ,SAAe;AACrB,UAAM,UAAU,KAAK,WAAW;AAChC,eAAW,YAAY,KAAK,WAAW;AACrC,eAAS,OAAO;AAAA,IAClB;AAAA,EACF;AAAA,EAEQ,YACN,MACA,QACA,OACA,SACiB;AACjB,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,KAAK,gBAAgB,MAAM;AAAA,MACnC,OAAO,KAAK,gBAAgB,KAAK;AAAA,MACjC,SAAS,EAAE,GAAG,QAAQ;AAAA,IACxB;AAAA,EACF;AAAA,EAEQ,WAAW,OAAyC;AAC1D,WAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,MAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,MACxB,SAAS,EAAE,GAAG,MAAM,QAAQ;AAAA,IAC9B;AAAA,EACF;AAAA,EAEQ,gBAAgB,OAAuD;AAC7E,UAAM,SAAiC,CAAC;AACxC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,CAAC,CAAC,GAAG;AACtD,aAAO,OAAO,GAAG,CAAC,IAAI,OAAO,KAAK;AAAA,IACpC;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,mBACN,MACA,OACM;AACN,QAAI,OAAO,WAAW,aAAa;AACjC;AAAA,IACF;AAEA,UAAM,QAAgC;AAAA,MACpC,CAAC,oBAAoB,GAAG;AAAA,MACxB,MAAM,MAAM;AAAA,MACZ,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,MAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,MACxB,SAAS,EAAE,GAAG,MAAM,QAAQ;AAAA,IAC9B;AAEA,WAAO,QAAQ,IAAI,EAAE,OAAO,EAAE;AAAA,EAChC;AACF;AAMA,SAAS,2BAAuC;AAC9C,SAAO,IAAI,WAAW;AACxB;AAEO,SAAS,gBAA4B;AAC1C,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,iBAAiB,GAAG;AACjC,cAAU,iBAAiB,IAAI,yBAAyB;AAAA,EAC1D;AACA,SAAO,UAAU,iBAAiB;AACpC;AAEO,SAAS,KACd,OACwB;AACxB,SAAO,cAAc,EAAE,KAAK,KAAK;AACnC;AAEO,SAAS,GACd,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,SAAO,cAAc,EAAE,GAAG,MAAM,QAAQ,OAAO,OAAO;AACxD;AAEO,SAAS,SAAiC;AAC/C,SAAO,KAAK,EAAE;AAChB;AAGO,SAAS,0BAAgC;AAC9C,QAAM,YAAY;AAClB,SAAO,UAAU,iBAAiB;AACpC;AAMA,SAAS,gCAAgC,kCAAkC;AAE3E,SAAS,mCAAmC;","names":[]}

package/dist/{middleware/__fixtures__/middleware/auth.cjs → navigation/layout_preservation.cjs}

@@ -16,29 +16,27 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var auth_exports = {};
-__export(auth_exports, {
-  is_admin: () => is_admin,
-  is_authenticated: () => is_authenticated
+var layout_preservation_exports = {};
+__export(layout_preservation_exports, {
+  computePreservedLayoutDepth: () => computePreservedLayoutDepth
 });
-module.exports = __toCommonJS(auth_exports);
-function is_admin(ctx) {
-  const session = ctx.getSession();
-  if (!session?.admin) {
-    throw new Error("Unauthorized: admin required");
+module.exports = __toCommonJS(layout_preservation_exports);
+function computePreservedLayoutDepth(from, to, options = {}) {
+  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);
+  let depth = 0;
+  for (let index = 0; index < maxDepth; index += 1) {
+    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;
+    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;
+    if (options.preserveLayouts === false) break;
+    if (options.preserveLayouts !== true && (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)) {
+      break;
+    }
+    depth += 1;
   }
-  ctx.set("admin", session.admin);
-}
-function is_authenticated(ctx) {
-  const session = ctx.getSession();
-  if (!session?.user) {
-    throw new Error("Unauthorized: authentication required");
-  }
-  ctx.set("user", session.user);
+  return depth;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  is_admin,
-  is_authenticated
+  computePreservedLayoutDepth
 });
-//# sourceMappingURL=auth.cjs.map
+//# sourceMappingURL=layout_preservation.cjs.map

package/dist/navigation/layout_preservation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/navigation/layout_preservation.ts"],"sourcesContent":["/**\n * Layout preservation depth — the single production rule for how many\n * leading layouts a navigation transition keeps mounted.\n *\n * One implementation, two callers: the renderer's NavigationShell (real\n * component transitions) and the Node frontend application slice\n * (`createFrontendSurface`). They must agree — a slice test that preserved\n * a layout the renderer rebuilds, or vice versa, would be evidence about a\n * rule that does not exist in production.\n *\n * The rule: walk the layout stacks in parallel and keep a layout only while\n * BOTH sides declare the same layout path, the same layout controller, and\n * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`\n * overrides the declaration in both directions.\n */\nimport type { NavigationOptions } from './index.js';\n\n/** The layout stack of one view, in the shape both callers can supply. */\nexport interface LayoutStack {\n  layoutPaths: readonly string[];\n  layoutControllers?: ReadonlyArray<string | undefined>;\n  layoutPreserve?: readonly boolean[];\n}\n\nexport function computePreservedLayoutDepth(\n  from: LayoutStack,\n  to: LayoutStack,\n  options: NavigationOptions = {},\n): number {\n  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);\n  let depth = 0;\n  for (let index = 0; index < maxDepth; index += 1) {\n    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;\n    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;\n    if (options.preserveLayouts === false) break;\n    if (\n      options.preserveLayouts !== true &&\n      (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)\n    ) {\n      break;\n    }\n    depth += 1;\n  }\n  return depth;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBO,SAAS,4BACd,MACA,IACA,UAA6B,CAAC,GACtB;AACR,QAAM,WAAW,KAAK,IAAI,KAAK,YAAY,QAAQ,GAAG,YAAY,MAAM;AACxE,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,UAAU,SAAS,GAAG;AAChD,QAAI,KAAK,YAAY,KAAK,MAAM,GAAG,YAAY,KAAK,EAAG;AACvD,QAAI,KAAK,oBAAoB,KAAK,MAAM,GAAG,oBAAoB,KAAK,EAAG;AACvE,QAAI,QAAQ,oBAAoB,MAAO;AACvC,QACE,QAAQ,oBAAoB,SAC3B,KAAK,iBAAiB,KAAK,MAAM,QAAQ,GAAG,iBAAiB,KAAK,MAAM,OACzE;AACA;AAAA,IACF;AACA,aAAS;AAAA,EACX;AACA,SAAO;AACT;","names":[]}

package/dist/navigation/layout_preservation.d.cts

@@ -0,0 +1,2 @@
+export { LayoutStack, computePreservedLayoutDepth } from './index.cjs';
+import './automation_introspection.cjs';

package/dist/navigation/layout_preservation.d.ts

@@ -0,0 +1,2 @@
+export { LayoutStack, computePreservedLayoutDepth } from './index.js';
+import './automation_introspection.js';

package/dist/navigation/layout_preservation.js

@@ -0,0 +1,18 @@
+function computePreservedLayoutDepth(from, to, options = {}) {
+  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);
+  let depth = 0;
+  for (let index = 0; index < maxDepth; index += 1) {
+    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;
+    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;
+    if (options.preserveLayouts === false) break;
+    if (options.preserveLayouts !== true && (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)) {
+      break;
+    }
+    depth += 1;
+  }
+  return depth;
+}
+export {
+  computePreservedLayoutDepth
+};
+//# sourceMappingURL=layout_preservation.js.map

package/dist/navigation/layout_preservation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/navigation/layout_preservation.ts"],"sourcesContent":["/**\n * Layout preservation depth — the single production rule for how many\n * leading layouts a navigation transition keeps mounted.\n *\n * One implementation, two callers: the renderer's NavigationShell (real\n * component transitions) and the Node frontend application slice\n * (`createFrontendSurface`). They must agree — a slice test that preserved\n * a layout the renderer rebuilds, or vice versa, would be evidence about a\n * rule that does not exist in production.\n *\n * The rule: walk the layout stacks in parallel and keep a layout only while\n * BOTH sides declare the same layout path, the same layout controller, and\n * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`\n * overrides the declaration in both directions.\n */\nimport type { NavigationOptions } from './index.js';\n\n/** The layout stack of one view, in the shape both callers can supply. */\nexport interface LayoutStack {\n  layoutPaths: readonly string[];\n  layoutControllers?: ReadonlyArray<string | undefined>;\n  layoutPreserve?: readonly boolean[];\n}\n\nexport function computePreservedLayoutDepth(\n  from: LayoutStack,\n  to: LayoutStack,\n  options: NavigationOptions = {},\n): number {\n  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);\n  let depth = 0;\n  for (let index = 0; index < maxDepth; index += 1) {\n    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;\n    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;\n    if (options.preserveLayouts === false) break;\n    if (\n      options.preserveLayouts !== true &&\n      (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)\n    ) {\n      break;\n    }\n    depth += 1;\n  }\n  return depth;\n}\n"],"mappings":"AAwBO,SAAS,4BACd,MACA,IACA,UAA6B,CAAC,GACtB;AACR,QAAM,WAAW,KAAK,IAAI,KAAK,YAAY,QAAQ,GAAG,YAAY,MAAM;AACxE,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,UAAU,SAAS,GAAG;AAChD,QAAI,KAAK,YAAY,KAAK,MAAM,GAAG,YAAY,KAAK,EAAG;AACvD,QAAI,KAAK,oBAAoB,KAAK,MAAM,GAAG,oBAAoB,KAAK,EAAG;AACvE,QAAI,QAAQ,oBAAoB,MAAO;AACvC,QACE,QAAQ,oBAAoB,SAC3B,KAAK,iBAAiB,KAAK,MAAM,QAAQ,GAAG,iBAAiB,KAAK,MAAM,OACzE;AACA;AAAA,IACF;AACA,aAAS;AAAA,EACX;AACA,SAAO;AACT;","names":[]}

package/dist/parser/index.cjs

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var parser_exports = {};
 __export(parser_exports, {
   parseOperations: () => import_operations_parser.parseOperations,
+  parseOperationsDocument: () => import_operations_parser.parseOperationsDocument,
   parseOperationsFile: () => import_operations_parser.parseOperationsFile,
   parseViews: () => import_views_parser.parseViews,
   parseViewsFile: () => import_views_parser.parseViewsFile
@@ -29,6 +30,7 @@ var import_views_parser = require("./views_parser.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile,
   parseViews,
   parseViewsFile

package/dist/parser/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsFile } from './operations_parser.cjs';\nexport { parseViews, parseViewsFile } from './views_parser.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAAqD;AACrD,0BAA2C;","names":[]}
+{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.cjs';\nexport { parseViews, parseViewsFile } from './views_parser.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAA8E;AAC9E,0BAA2C;","names":[]}

package/dist/parser/index.d.cts

@@ -1,4 +1,4 @@
-export { parseOperations, parseOperationsFile } from './operations_parser.cjs';
+export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.cjs';
 export { parseViews, parseViewsFile } from './views_parser.cjs';
 import '../types/operations.cjs';
 import '../types/views.cjs';

package/dist/parser/index.d.ts

@@ -1,4 +1,4 @@
-export { parseOperations, parseOperationsFile } from './operations_parser.js';
+export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.js';
 export { parseViews, parseViewsFile } from './views_parser.js';
 import '../types/operations.js';
 import '../types/views.js';

package/dist/parser/index.js

@@ -1,7 +1,8 @@
-import { parseOperations, parseOperationsFile } from "./operations_parser.js";
+import { parseOperations, parseOperationsDocument, parseOperationsFile } from "./operations_parser.js";
 import { parseViews, parseViewsFile } from "./views_parser.js";
 export {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile,
   parseViews,
   parseViewsFile

package/dist/parser/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsFile } from './operations_parser.js';\nexport { parseViews, parseViewsFile } from './views_parser.js';\n"],"mappings":"AAAA,SAAS,iBAAiB,2BAA2B;AACrD,SAAS,YAAY,sBAAsB;","names":[]}
+{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.js';\nexport { parseViews, parseViewsFile } from './views_parser.js';\n"],"mappings":"AAAA,SAAS,iBAAiB,yBAAyB,2BAA2B;AAC9E,SAAS,YAAY,sBAAsB;","names":[]}

package/dist/parser/operations_parser.cjs

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var operations_parser_exports = {};
 __export(operations_parser_exports, {
   parseOperations: () => parseOperations,
+  parseOperationsDocument: () => parseOperationsDocument,
   parseOperationsFile: () => parseOperationsFile
 });
 module.exports = __toCommonJS(operations_parser_exports);
@@ -36,6 +37,9 @@ var import_js_yaml = __toESM(require("js-yaml"), 1);
 var import_fs = require("fs");
 function parseOperations(yamlContent) {
   const doc = import_js_yaml.default.load(yamlContent);
+  return parseOperationsDocument(doc);
+}
+function parseOperationsDocument(doc) {
   const operations = /* @__PURE__ */ new Map();
   if (doc === null || doc === void 0) {
     throw new Error('Operations document is empty: expected a top-level "operations:" or "module:" mapping.');
@@ -84,6 +88,7 @@ function parseOperations(yamlContent) {
         }
         set(channel, {
           channel,
+          module: moduleName,
           controller: opEntry.controller ?? moduleController ?? "",
           action: opEntry.action,
           middleware,
@@ -110,6 +115,7 @@ function parseOperationsFile(filePath) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile
 });
 //# sourceMappingURL=operations_parser.cjs.map

package/dist/parser/operations_parser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.cjs';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiB;AACjB,gBAA6B;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,eAAAA,QAAK,KAAK,WAAW;AACjC,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,cAAU,wBAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":["yaml"]}
+{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.cjs';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  return parseOperationsDocument(doc);\n}\n\n/**\n * Parse an already-loaded operations document (the object form of the YAML).\n * This is the production parser; parseOperations/parseOperationsFile are\n * thin loaders over it, and test environments select from the same\n * identities it produces.\n */\nexport function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef> {\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          module: moduleName,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAiB;AACjB,gBAA6B;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,eAAAA,QAAK,KAAK,WAAW;AACjC,SAAO,wBAAwB,GAAG;AACpC;AAQO,SAAS,wBAAwB,KAAuD;AAC7F,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,cAAU,wBAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":["yaml"]}

package/dist/parser/operations_parser.d.cts

@@ -1,7 +1,14 @@
-import { OperationDef } from '../types/operations.cjs';
+import { OperationDef, RawOperationsDocument } from '../types/operations.cjs';
 
 declare function parseOperations(yamlContent: string): Map<string, OperationDef>;
+/**
+ * Parse an already-loaded operations document (the object form of the YAML).
+ * This is the production parser; parseOperations/parseOperationsFile are
+ * thin loaders over it, and test environments select from the same
+ * identities it produces.
+ */
+declare function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef>;
 /** Parse from file path */
 declare function parseOperationsFile(filePath: string): Map<string, OperationDef>;
 
-export { parseOperations, parseOperationsFile };
+export { parseOperations, parseOperationsDocument, parseOperationsFile };

package/dist/parser/operations_parser.d.ts

@@ -1,7 +1,14 @@
-import { OperationDef } from '../types/operations.js';
+import { OperationDef, RawOperationsDocument } from '../types/operations.js';
 
 declare function parseOperations(yamlContent: string): Map<string, OperationDef>;
+/**
+ * Parse an already-loaded operations document (the object form of the YAML).
+ * This is the production parser; parseOperations/parseOperationsFile are
+ * thin loaders over it, and test environments select from the same
+ * identities it produces.
+ */
+declare function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef>;
 /** Parse from file path */
 declare function parseOperationsFile(filePath: string): Map<string, OperationDef>;
 
-export { parseOperations, parseOperationsFile };
+export { parseOperations, parseOperationsDocument, parseOperationsFile };

package/dist/parser/operations_parser.js

@@ -2,6 +2,9 @@ import yaml from "js-yaml";
 import { readFileSync } from "fs";
 function parseOperations(yamlContent) {
   const doc = yaml.load(yamlContent);
+  return parseOperationsDocument(doc);
+}
+function parseOperationsDocument(doc) {
   const operations = /* @__PURE__ */ new Map();
   if (doc === null || doc === void 0) {
     throw new Error('Operations document is empty: expected a top-level "operations:" or "module:" mapping.');
@@ -50,6 +53,7 @@ function parseOperations(yamlContent) {
         }
         set(channel, {
           channel,
+          module: moduleName,
           controller: opEntry.controller ?? moduleController ?? "",
           action: opEntry.action,
           middleware,
@@ -75,6 +79,7 @@ function parseOperationsFile(filePath) {
 }
 export {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile
 };
 //# sourceMappingURL=operations_parser.js.map

package/dist/parser/operations_parser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.js';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,KAAK,KAAK,WAAW;AACjC,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":[]}
+{"version":3,"sources":["../../src/parser/operations_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type { OperationDef, RawOperationsDocument, RawModuleDef, RawOperationEntry, RawModuleOperationEntry } from '../types/index.js';\n\nexport function parseOperations(yamlContent: string): Map<string, OperationDef> {\n  const doc = yaml.load(yamlContent) as RawOperationsDocument;\n  return parseOperationsDocument(doc);\n}\n\n/**\n * Parse an already-loaded operations document (the object form of the YAML).\n * This is the production parser; parseOperations/parseOperationsFile are\n * thin loaders over it, and test environments select from the same\n * identities it produces.\n */\nexport function parseOperationsDocument(doc: RawOperationsDocument): Map<string, OperationDef> {\n  const operations = new Map<string, OperationDef>();\n\n  if (doc === null || doc === undefined) {\n    throw new Error('Operations document is empty: expected a top-level \"operations:\" or \"module:\" mapping.');\n  }\n  if (typeof doc !== 'object' || Array.isArray(doc)) {\n    throw new Error('Operations document must be a mapping with \"operations:\" and/or \"module:\" keys.');\n  }\n  if (!doc.operations && !doc.module) {\n    throw new Error('Operations document defines no operations: expected an \"operations:\" or \"module:\" key.');\n  }\n\n  // A channel may only be defined once. Two operations sharing a channel would\n  // silently overwrite each other (last-wins), dropping an RPC with no warning.\n  const set = (channel: string, def: OperationDef): void => {\n    if (operations.has(channel)) {\n      throw new Error(`Duplicate operation channel \"${channel}\": each channel may only be defined once.`);\n    }\n    operations.set(channel, def);\n  };\n\n  // 1. Parse flat operations (top-level `operations:` key)\n  if (doc.operations) {\n    for (const [channel, entry] of Object.entries(doc.operations)) {\n      set(channel, {\n        channel,\n        controller: entry.controller,\n        action: entry.action,\n        middleware: entry.middleware ?? [],\n        inputSchema: entry.input,\n        outputSchema: entry.output,\n      });\n    }\n  }\n\n  // 2. Parse module operations (`module:` key)\n  if (doc.module) {\n    for (const [moduleName, moduleDef] of Object.entries(doc.module)) {\n      const moduleController = moduleDef.controller;\n      const moduleMiddleware = moduleDef.middleware ?? [];\n\n      if (moduleDef.operations === null || moduleDef.operations === undefined) {\n        throw new Error(`Module \"${moduleName}\" has no \"operations:\" block.`);\n      }\n      if (typeof moduleDef.operations !== 'object' || Array.isArray(moduleDef.operations)) {\n        throw new Error(`Module \"${moduleName}\" \"operations:\" must be a mapping of operation names.`);\n      }\n\n      for (const [opName, opEntry] of Object.entries(moduleDef.operations)) {\n        const channel = `${moduleName}.${opName}`;\n\n        // Middleware: if operation explicitly sets middleware to [] or null, clear inherited\n        // Otherwise, prepend module middleware to operation middleware\n        let middleware: string[];\n        if (opEntry.middleware === null || (Array.isArray(opEntry.middleware) && opEntry.middleware.length === 0)) {\n          middleware = [];\n        } else {\n          middleware = [...moduleMiddleware, ...(opEntry.middleware ?? [])];\n        }\n\n        set(channel, {\n          channel,\n          module: moduleName,\n          controller: opEntry.controller ?? moduleController ?? '',\n          action: opEntry.action,\n          middleware,\n          inputSchema: opEntry.input,\n          outputSchema: opEntry.output,\n        });\n      }\n    }\n  }\n\n  // 3. Validate: every operation must have a controller and action\n  for (const [channel, op] of operations) {\n    if (!op.controller) {\n      throw new Error(`Operation \"${channel}\" has no controller defined`);\n    }\n    if (!op.action) {\n      throw new Error(`Operation \"${channel}\" has no action defined`);\n    }\n  }\n\n  return operations;\n}\n\n/** Parse from file path */\nexport function parseOperationsFile(filePath: string): Map<string, OperationDef> {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseOperations(content);\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAGtB,SAAS,gBAAgB,aAAgD;AAC9E,QAAM,MAAM,KAAK,KAAK,WAAW;AACjC,SAAO,wBAAwB,GAAG;AACpC;AAQO,SAAS,wBAAwB,KAAuD;AAC7F,QAAM,aAAa,oBAAI,IAA0B;AAEjD,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AACA,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,iFAAiF;AAAA,EACnG;AACA,MAAI,CAAC,IAAI,cAAc,CAAC,IAAI,QAAQ;AAClC,UAAM,IAAI,MAAM,wFAAwF;AAAA,EAC1G;AAIA,QAAM,MAAM,CAAC,SAAiB,QAA4B;AACxD,QAAI,WAAW,IAAI,OAAO,GAAG;AAC3B,YAAM,IAAI,MAAM,gCAAgC,OAAO,2CAA2C;AAAA,IACpG;AACA,eAAW,IAAI,SAAS,GAAG;AAAA,EAC7B;AAGA,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,SAAS,KAAK,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AAC7D,UAAI,SAAS;AAAA,QACX;AAAA,QACA,YAAY,MAAM;AAAA,QAClB,QAAQ,MAAM;AAAA,QACd,YAAY,MAAM,cAAc,CAAC;AAAA,QACjC,aAAa,MAAM;AAAA,QACnB,cAAc,MAAM;AAAA,MACtB,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,IAAI,QAAQ;AACd,eAAW,CAAC,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI,MAAM,GAAG;AAChE,YAAM,mBAAmB,UAAU;AACnC,YAAM,mBAAmB,UAAU,cAAc,CAAC;AAElD,UAAI,UAAU,eAAe,QAAQ,UAAU,eAAe,QAAW;AACvE,cAAM,IAAI,MAAM,WAAW,UAAU,+BAA+B;AAAA,MACtE;AACA,UAAI,OAAO,UAAU,eAAe,YAAY,MAAM,QAAQ,UAAU,UAAU,GAAG;AACnF,cAAM,IAAI,MAAM,WAAW,UAAU,uDAAuD;AAAA,MAC9F;AAEA,iBAAW,CAAC,QAAQ,OAAO,KAAK,OAAO,QAAQ,UAAU,UAAU,GAAG;AACpE,cAAM,UAAU,GAAG,UAAU,IAAI,MAAM;AAIvC,YAAI;AACJ,YAAI,QAAQ,eAAe,QAAS,MAAM,QAAQ,QAAQ,UAAU,KAAK,QAAQ,WAAW,WAAW,GAAI;AACzG,uBAAa,CAAC;AAAA,QAChB,OAAO;AACL,uBAAa,CAAC,GAAG,kBAAkB,GAAI,QAAQ,cAAc,CAAC,CAAE;AAAA,QAClE;AAEA,YAAI,SAAS;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,YAAY,QAAQ,cAAc,oBAAoB;AAAA,UACtD,QAAQ,QAAQ;AAAA,UAChB;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,cAAc,QAAQ;AAAA,QACxB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,IAAI,MAAM,cAAc,OAAO,6BAA6B;AAAA,IACpE;AACA,QAAI,CAAC,GAAG,QAAQ;AACd,YAAM,IAAI,MAAM,cAAc,OAAO,yBAAyB;AAAA,IAChE;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,oBAAoB,UAA6C;AAC/E,QAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,SAAO,gBAAgB,OAAO;AAChC;","names":[]}

package/dist/parser/views_parser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":["yaml"]}
+{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types/index.cjs';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":["yaml"]}

package/dist/parser/views_parser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/parser/views_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync } from 'fs';\nimport type {\n  ViewDef,\n  RawViewsDocument,\n  RawLayoutEntry,\n  RawLayoutObjectEntry,\n  RawLayoutConfig,\n  RawLayoutGroupEntry,\n} from '../types/index.js';\n\nfunction validateControllerValue(controller: unknown, contextLabel: string): string | undefined {\n  if (controller === undefined) return undefined;\n  if (typeof controller !== 'string' || controller.trim().length === 0) {\n    throw new Error(`${contextLabel} has invalid controller. Expected a non-empty string.`);\n  }\n  return controller.trim();\n}\n\nfunction validatePreserveValue(preserve: unknown, contextLabel: string): boolean {\n  if (preserve === undefined) return false;\n  if (typeof preserve !== 'boolean') {\n    throw new Error(`${contextLabel} has invalid preserve. Expected a boolean.`);\n  }\n  return preserve;\n}\n\nfunction parseLayoutEntry(entry: RawLayoutEntry, viewKey: string, index: number): { path: string; controller?: string; preserve: boolean } {\n  if (typeof entry === 'string') {\n    const path = entry.trim();\n    if (!path) {\n      throw new Error(`View \"${viewKey}\" has invalid layout entry at index ${index}. Expected a non-empty path string.`);\n    }\n    return { path, preserve: false };\n  }\n\n  const layoutObj = entry as RawLayoutObjectEntry;\n  const layoutPath = layoutObj.path ?? layoutObj.view ?? layoutObj.layout;\n  if (typeof layoutPath !== 'string' || layoutPath.trim().length === 0) {\n    throw new Error(\n      `View \"${viewKey}\" has invalid layout object at index ${index}. ` +\n      'Expected one of: path, view, or layout as a non-empty string.',\n    );\n  }\n\n  return {\n    path: layoutPath.trim(),\n    controller: validateControllerValue(layoutObj.controller, `View \"${viewKey}\" layout[${index}]`),\n    preserve: validatePreserveValue(layoutObj.preserve, `View \"${viewKey}\" layout[${index}]`),\n  };\n}\n\nfunction isLayoutGroupEntry(entry: unknown): entry is RawLayoutGroupEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return Object.prototype.hasOwnProperty.call(entry, 'views');\n}\n\nfunction isLayoutObjectEntry(entry: unknown): entry is RawLayoutObjectEntry {\n  if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return false;\n  return (\n    Object.prototype.hasOwnProperty.call(entry, 'path') ||\n    Object.prototype.hasOwnProperty.call(entry, 'view') ||\n    Object.prototype.hasOwnProperty.call(entry, 'layout') ||\n    Object.prototype.hasOwnProperty.call(entry, 'controller')\n  );\n}\n\nfunction normalizeLayouts(rawLayout: RawLayoutConfig | undefined, viewKey: string): {\n  entries: RawLayoutEntry[];\n  inheritedController?: string;\n  inheritedPreserve?: boolean;\n} {\n  if (rawLayout === undefined) {\n    return { entries: [] };\n  }\n\n  if (Array.isArray(rawLayout)) {\n    return { entries: rawLayout };\n  }\n\n  if (typeof rawLayout === 'string') {\n    return { entries: [rawLayout] };\n  }\n\n  if (isLayoutGroupEntry(rawLayout)) {\n    if (!Array.isArray(rawLayout.views)) {\n      throw new Error(`View \"${viewKey}\" has invalid layout object. \"views\" must be an array.`);\n    }\n\n    return {\n      entries: rawLayout.views,\n      inheritedController: validateControllerValue(rawLayout.controller, `View \"${viewKey}\" layout`),\n      inheritedPreserve: validatePreserveValue(rawLayout.preserve, `View \"${viewKey}\" layout`),\n    };\n  }\n\n  if (isLayoutObjectEntry(rawLayout)) {\n    return { entries: [rawLayout] };\n  }\n\n  throw new Error(\n    `View \"${viewKey}\" has invalid layout definition. Expected an array, a string path, or an object with \"views\".`,\n  );\n}\n\n/**\n * Parse views YAML content into a flat array of ViewDef.\n * Supports Wood-native `view:` format (dot-path keys).\n */\nexport function parseViews(yamlContent: string): ViewDef[] {\n  const doc = yaml.load(yamlContent) as RawViewsDocument;\n  const views: ViewDef[] = [];\n\n  // Wood-native `view:` format\n  // First segment = window name, rest = page name\n  if (doc.view) {\n    for (const [dotPath, entry] of Object.entries(doc.view)) {\n      const segments = dotPath.split('.');\n      const windowName = segments[0];\n      const pageName = segments.slice(1).join('.');\n\n      const normalizedLayouts = normalizeLayouts(entry.layout, dotPath);\n      const parsedLayouts = normalizedLayouts.entries.map((layoutEntry, index) =>\n        parseLayoutEntry(layoutEntry, dotPath, index),\n      );\n      if (normalizedLayouts.inheritedController) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets a layout controller but has no layout views. Define at least one layout entry.`,\n          );\n        }\n\n        const firstLayoutController = parsedLayouts[0].controller;\n        if (firstLayoutController && firstLayoutController !== normalizedLayouts.inheritedController) {\n          throw new Error(\n            `View \"${dotPath}\" has conflicting layout controllers. Use either layout.controller or layout.views[0].controller.`,\n          );\n        }\n        parsedLayouts[0].controller ??= normalizedLayouts.inheritedController;\n      }\n      if (normalizedLayouts.inheritedPreserve) {\n        if (parsedLayouts.length === 0) {\n          throw new Error(\n            `View \"${dotPath}\" sets layout preserve but has no layout views. Define at least one layout entry.`,\n          );\n        }\n        parsedLayouts[0].preserve = true;\n      }\n\n      const layoutPaths = parsedLayouts.map((layout) => layout.path);\n      const layoutControllers = parsedLayouts.map((layout) => layout.controller);\n      const layoutPreserve = parsedLayouts.map((layout) => layout.preserve);\n\n      const viewController = validateControllerValue(entry.controller, `View \"${dotPath}\"`);\n\n      const viewDef: ViewDef = {\n        windowName,\n        pageName,\n        viewPath: entry.view,\n        layouts: layoutPaths,\n        middleware: entry.middleware,\n        controller: viewController,\n      };\n\n      if (layoutControllers.some((value) => value !== undefined)) {\n        viewDef.layoutControllers = layoutControllers;\n      }\n      if (layoutPreserve.some((value) => value)) {\n        viewDef.layoutPreserve = layoutPreserve;\n      }\n\n      views.push(viewDef);\n    }\n  }\n\n  return views;\n}\n\n/** Read a YAML file from disk and parse it into ViewDef[]. */\nexport function parseViewsFile(filePath: string): ViewDef[] {\n  const content = readFileSync(filePath, 'utf-8');\n  return parseViews(content);\n}\n"],"mappings":"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","names":[]}

package/dist/router/index.d.cts

@@ -1,2 +1,3 @@
 export { RESERVED_CHANNELS, ReservedChannel, ReservedChannelHandler, WoodRouter } from './wood_router.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';

package/dist/router/index.d.ts

@@ -1,2 +1,3 @@
 export { RESERVED_CHANNELS, ReservedChannel, ReservedChannelHandler, WoodRouter } from './wood_router.js';
 import '../types/operations.js';
+import '../types/context.js';

package/dist/router/wood_router.cjs

@@ -29,6 +29,7 @@ var import_middleware_pipeline = require("../middleware/middleware_pipeline.cjs"
 var import_controller_resolver = require("../controller/controller_resolver.cjs");
 var import_controller_lifecycle = require("../controller/controller_lifecycle.cjs");
 var import_logger = require("@noego/logger");
+var import_ioc = require("@noego/ioc");
 var import_tracing = require("../tracing/index.js");
 const logger = (0, import_logger.getLogger)("wood:router");
 function extractTraceConversationId(value) {
@@ -53,6 +54,10 @@ const RESERVED_CHANNELS = [
   "__woodConfig",
   "__traceBatch"
 ];
+function controllerAlreadyRegistered(scope, ControllerClass) {
+  const candidate = scope;
+  return typeof candidate.isRegistered === "function" && candidate.isRegistered(ControllerClass);
+}
 class WoodRouter {
   // IoC Container
   constructor(options) {
@@ -168,8 +173,14 @@ class WoodRouter {
     }
     const ControllerClass = await this.controllerResolver.resolveClass(opDef.controller);
     const scopedContainer = this.container.extend();
-    const instance = await scopedContainer.instance(ControllerClass);
-    const args = (0, import_controller_resolver.buildControllerArgs)(ipcContext, scopedContainer);
+    if (!controllerAlreadyRegistered(scopedContainer, ControllerClass) && typeof scopedContainer.registerClass === "function") {
+      scopedContainer.registerClass(ControllerClass);
+    }
+    const instance = await import_ioc.ExecutionContext.run(
+      scopedContainer,
+      () => scopedContainer.instance(ControllerClass)
+    );
+    const args = (0, import_controller_resolver.usesOperationContext)(ControllerClass) ? (0, import_controller_resolver.buildOperationContext)(channel, ipcContext) : (0, import_controller_resolver.buildControllerArgs)(ipcContext, scopedContainer);
     const action = instance[opDef.action];
     let result;
     let actionError;
@@ -179,7 +190,7 @@ class WoodRouter {
           `Controller "${opDef.controller}" has no action "${opDef.action}"`
         );
       }
-      result = await action.call(instance, args);
+      result = await import_ioc.ExecutionContext.run(scopedContainer, () => action.call(instance, args));
       (0, import_tracing.publishMainTrace)("debug", {
         source: "wood.router",
         type: "dispatch.success",
@@ -206,6 +217,9 @@ class WoodRouter {
     } finally {
       try {
         await (0, import_controller_lifecycle.disposeControllerLifecycle)(instance);
+        if (typeof scopedContainer.dispose === "function") {
+          await scopedContainer.dispose();
+        }
       } catch (disposeError) {
         (0, import_tracing.publishMainTrace)("error", {
           source: "wood.router",
@@ -236,6 +250,15 @@ class WoodRouter {
   registerController(name, ControllerClass) {
     this.controllerResolver.register(name, ControllerClass);
   }
+  /**
+   * Pre-register the executable for a production middleware identity so it
+   * resolves from the registry instead of the filesystem — the bundled-mode
+   * path for middleware, and the seam test environments use to replace an
+   * identity's behavior without touching source topology.
+   */
+  registerMiddleware(spec, middleware) {
+    this.middlewareResolver.register(spec, middleware);
+  }
   /**
    * Register an import path for a controller. The controller will be lazily
    * imported from this path when first needed, avoiding circular dependencies.
@@ -243,6 +266,15 @@ class WoodRouter {
   registerControllerPath(name, importPath) {
     this.controllerResolver.registerPath(name, importPath);
   }
+  /**
+   * Register a caller-owned lazy loader for a controller: the module is
+   * imported through the CALLER's `() => import('…literal specifier…')` only
+   * on first dispatch, preserving the caller's module identity for the
+   * controller graph (thin production slices in tests).
+   */
+  registerControllerLoader(name, loader) {
+    this.controllerResolver.registerLoader(name, loader);
+  }
   /**
    * Validate that every controller referenced in loaded operations is
    * pre-registered in the controller resolver. Call this after