@noego/wood 0.6.1 → 0.7.0

package/dist/loader/loader_orchestration.d.cts

@@ -0,0 +1,66 @@
+import { RequestData } from '../types/context.cjs';
+
+/**
+ * Shared page/layout data-loader orchestration.
+ *
+ * One implementation, three callers: the generated production renderer app
+ * (`createControllerSet`), the Node frontend application surface
+ * (`constructPage`) and the main-process `LoaderRunner`. It is deliberately
+ * free of Node APIs so it ships to the browser through `@noego/wood/navigation`.
+ *
+ * Convention: a view `pages/chat.svelte` MAY have a companion loader
+ * `pages/chat.load.ts` whose DEFAULT export is `(request: RequestData) =>
+ * data`. Discovery (does the companion exist?) is a build-time concern of the
+ * caller (codegen, the test config source, the runner); this module only
+ * defines the companion identity and executes an already-resolved set:
+ * layouts in stack order (outermost first), then the view. A layout carried
+ * over from the previous page (`preservedDepth`) is never re-run.
+ */
+
+type DataLoader = (request: RequestData) => unknown;
+/** Companion suffixes, in resolution order; more than one present is ambiguous. */
+declare const LOADER_COMPANION_SUFFIXES: readonly [".load.ts", ".load.js"];
+/** The companion loader candidates for a `.svelte` view path (empty for other files). */
+declare function loaderCompanionCandidates(viewPath: string): string[];
+/** Loaders resolved for one view: index-aligned with the layout stack; `null` = no loader. */
+interface ViewLoaderSet {
+    readonly layouts: ReadonlyArray<DataLoader | null>;
+    readonly view: DataLoader | null;
+}
+/** A loader ran and produced `data` (which may legitimately be `undefined`). */
+interface LoadedData {
+    readonly data: unknown;
+}
+/** Index-aligned outcome; `null` where no loader exists or the layout was preserved. */
+interface ViewLoaderResult {
+    readonly layouts: ReadonlyArray<LoadedData | null>;
+    readonly view: LoadedData | null;
+}
+interface RouteInput {
+    readonly params: Record<string, string>;
+    readonly query: Record<string, string>;
+}
+declare const NO_LOADERS: ViewLoaderSet;
+/** The request a page/layout loader receives (`url` is the page identity). */
+declare function createLoaderRequest(page: string, route: RouteInput): RequestData;
+/** A loader module's default export must be a function; anything else is a source error. */
+declare function assertDataLoader(value: unknown, label: string): DataLoader;
+/**
+ * Execute a view's loaders: layouts from `preservedDepth` in stack order,
+ * then the view. Any failure rejects — the caller owns rollback.
+ */
+declare function runViewLoaders(set: ViewLoaderSet, request: RequestData, preservedDepth?: number): Promise<ViewLoaderResult>;
+/**
+ * The argument a controller's `initialize()` receives: `{ params, query }`
+ * exactly as before when the controller has no loader, plus `data` when one
+ * ran for it.
+ */
+declare function initializeArgument(route: RouteInput, loaded: LoadedData | null | undefined): {
+    params: Record<string, string>;
+    query: Record<string, string>;
+    data?: unknown;
+};
+/** Call `initialize(argument)` when the controller declares one. */
+declare function initializeController(controller: unknown, argument: unknown): Promise<void>;
+
+export { type DataLoader, LOADER_COMPANION_SUFFIXES, type LoadedData, NO_LOADERS, type RouteInput, type ViewLoaderResult, type ViewLoaderSet, assertDataLoader, createLoaderRequest, initializeArgument, initializeController, loaderCompanionCandidates, runViewLoaders };

package/dist/loader/loader_orchestration.d.ts

@@ -0,0 +1,66 @@
+import { RequestData } from '../types/context.js';
+
+/**
+ * Shared page/layout data-loader orchestration.
+ *
+ * One implementation, three callers: the generated production renderer app
+ * (`createControllerSet`), the Node frontend application surface
+ * (`constructPage`) and the main-process `LoaderRunner`. It is deliberately
+ * free of Node APIs so it ships to the browser through `@noego/wood/navigation`.
+ *
+ * Convention: a view `pages/chat.svelte` MAY have a companion loader
+ * `pages/chat.load.ts` whose DEFAULT export is `(request: RequestData) =>
+ * data`. Discovery (does the companion exist?) is a build-time concern of the
+ * caller (codegen, the test config source, the runner); this module only
+ * defines the companion identity and executes an already-resolved set:
+ * layouts in stack order (outermost first), then the view. A layout carried
+ * over from the previous page (`preservedDepth`) is never re-run.
+ */
+
+type DataLoader = (request: RequestData) => unknown;
+/** Companion suffixes, in resolution order; more than one present is ambiguous. */
+declare const LOADER_COMPANION_SUFFIXES: readonly [".load.ts", ".load.js"];
+/** The companion loader candidates for a `.svelte` view path (empty for other files). */
+declare function loaderCompanionCandidates(viewPath: string): string[];
+/** Loaders resolved for one view: index-aligned with the layout stack; `null` = no loader. */
+interface ViewLoaderSet {
+    readonly layouts: ReadonlyArray<DataLoader | null>;
+    readonly view: DataLoader | null;
+}
+/** A loader ran and produced `data` (which may legitimately be `undefined`). */
+interface LoadedData {
+    readonly data: unknown;
+}
+/** Index-aligned outcome; `null` where no loader exists or the layout was preserved. */
+interface ViewLoaderResult {
+    readonly layouts: ReadonlyArray<LoadedData | null>;
+    readonly view: LoadedData | null;
+}
+interface RouteInput {
+    readonly params: Record<string, string>;
+    readonly query: Record<string, string>;
+}
+declare const NO_LOADERS: ViewLoaderSet;
+/** The request a page/layout loader receives (`url` is the page identity). */
+declare function createLoaderRequest(page: string, route: RouteInput): RequestData;
+/** A loader module's default export must be a function; anything else is a source error. */
+declare function assertDataLoader(value: unknown, label: string): DataLoader;
+/**
+ * Execute a view's loaders: layouts from `preservedDepth` in stack order,
+ * then the view. Any failure rejects — the caller owns rollback.
+ */
+declare function runViewLoaders(set: ViewLoaderSet, request: RequestData, preservedDepth?: number): Promise<ViewLoaderResult>;
+/**
+ * The argument a controller's `initialize()` receives: `{ params, query }`
+ * exactly as before when the controller has no loader, plus `data` when one
+ * ran for it.
+ */
+declare function initializeArgument(route: RouteInput, loaded: LoadedData | null | undefined): {
+    params: Record<string, string>;
+    query: Record<string, string>;
+    data?: unknown;
+};
+/** Call `initialize(argument)` when the controller declares one. */
+declare function initializeController(controller: unknown, argument: unknown): Promise<void>;
+
+export { type DataLoader, LOADER_COMPANION_SUFFIXES, type LoadedData, NO_LOADERS, type RouteInput, type ViewLoaderResult, type ViewLoaderSet, assertDataLoader, createLoaderRequest, initializeArgument, initializeController, loaderCompanionCandidates, runViewLoaders };

package/dist/loader/loader_orchestration.js

@@ -0,0 +1,51 @@
+const LOADER_COMPANION_SUFFIXES = [".load.ts", ".load.js"];
+function loaderCompanionCandidates(viewPath) {
+  if (!/\.svelte$/.test(viewPath)) return [];
+  const base = viewPath.replace(/\.svelte$/, "");
+  return LOADER_COMPANION_SUFFIXES.map((suffix) => base + suffix);
+}
+const NO_LOADERS = Object.freeze({ layouts: Object.freeze([]), view: null });
+function createLoaderRequest(page, route) {
+  return {
+    url: page,
+    params: { ...route.params },
+    query: { ...route.query },
+    context: {},
+    headers: {}
+  };
+}
+function assertDataLoader(value, label) {
+  if (typeof value !== "function") {
+    throw new TypeError(`${label} must default-export a loader function (request) => data`);
+  }
+  return value;
+}
+async function runViewLoaders(set, request, preservedDepth = 0) {
+  const layouts = [];
+  for (let index = 0; index < set.layouts.length; index += 1) {
+    const loader = index < preservedDepth ? null : set.layouts[index];
+    layouts.push(loader ? { data: await loader(request) } : null);
+  }
+  const view = set.view ? { data: await set.view(request) } : null;
+  return { layouts, view };
+}
+function initializeArgument(route, loaded) {
+  const base = { params: route.params, query: route.query };
+  return loaded ? { ...base, data: loaded.data } : base;
+}
+async function initializeController(controller, argument) {
+  const initialize = controller?.initialize;
+  if (typeof initialize !== "function") return;
+  await initialize.call(controller, argument);
+}
+export {
+  LOADER_COMPANION_SUFFIXES,
+  NO_LOADERS,
+  assertDataLoader,
+  createLoaderRequest,
+  initializeArgument,
+  initializeController,
+  loaderCompanionCandidates,
+  runViewLoaders
+};
+//# sourceMappingURL=loader_orchestration.js.map

package/dist/loader/loader_orchestration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/loader/loader_orchestration.ts"],"sourcesContent":["/**\n * Shared page/layout data-loader orchestration.\n *\n * One implementation, three callers: the generated production renderer app\n * (`createControllerSet`), the Node frontend application surface\n * (`constructPage`) and the main-process `LoaderRunner`. It is deliberately\n * free of Node APIs so it ships to the browser through `@noego/wood/navigation`.\n *\n * Convention: a view `pages/chat.svelte` MAY have a companion loader\n * `pages/chat.load.ts` whose DEFAULT export is `(request: RequestData) =>\n * data`. Discovery (does the companion exist?) is a build-time concern of the\n * caller (codegen, the test config source, the runner); this module only\n * defines the companion identity and executes an already-resolved set:\n * layouts in stack order (outermost first), then the view. A layout carried\n * over from the previous page (`preservedDepth`) is never re-run.\n */\nimport type { RequestData } from '../types/context.js';\n\nexport type DataLoader = (request: RequestData) => unknown;\n\n/** Companion suffixes, in resolution order; more than one present is ambiguous. */\nexport const LOADER_COMPANION_SUFFIXES = ['.load.ts', '.load.js'] as const;\n\n/** The companion loader candidates for a `.svelte` view path (empty for other files). */\nexport function loaderCompanionCandidates(viewPath: string): string[] {\n  if (!/\\.svelte$/.test(viewPath)) return [];\n  const base = viewPath.replace(/\\.svelte$/, '');\n  return LOADER_COMPANION_SUFFIXES.map((suffix) => base + suffix);\n}\n\n/** Loaders resolved for one view: index-aligned with the layout stack; `null` = no loader. */\nexport interface ViewLoaderSet {\n  readonly layouts: ReadonlyArray<DataLoader | null>;\n  readonly view: DataLoader | null;\n}\n\n/** A loader ran and produced `data` (which may legitimately be `undefined`). */\nexport interface LoadedData {\n  readonly data: unknown;\n}\n\n/** Index-aligned outcome; `null` where no loader exists or the layout was preserved. */\nexport interface ViewLoaderResult {\n  readonly layouts: ReadonlyArray<LoadedData | null>;\n  readonly view: LoadedData | null;\n}\n\nexport interface RouteInput {\n  readonly params: Record<string, string>;\n  readonly query: Record<string, string>;\n}\n\nexport const NO_LOADERS: ViewLoaderSet = Object.freeze({ layouts: Object.freeze([]), view: null });\n\n/** The request a page/layout loader receives (`url` is the page identity). */\nexport function createLoaderRequest(page: string, route: RouteInput): RequestData {\n  return {\n    url: page,\n    params: { ...route.params },\n    query: { ...route.query },\n    context: {},\n    headers: {},\n  };\n}\n\n/** A loader module's default export must be a function; anything else is a source error. */\nexport function assertDataLoader(value: unknown, label: string): DataLoader {\n  if (typeof value !== 'function') {\n    throw new TypeError(`${label} must default-export a loader function (request) => data`);\n  }\n  return value as DataLoader;\n}\n\n/**\n * Execute a view's loaders: layouts from `preservedDepth` in stack order,\n * then the view. Any failure rejects — the caller owns rollback.\n */\nexport async function runViewLoaders(\n  set: ViewLoaderSet,\n  request: RequestData,\n  preservedDepth = 0,\n): Promise<ViewLoaderResult> {\n  const layouts: Array<LoadedData | null> = [];\n  for (let index = 0; index < set.layouts.length; index += 1) {\n    const loader = index < preservedDepth ? null : set.layouts[index];\n    layouts.push(loader ? { data: await loader(request) } : null);\n  }\n  const view = set.view ? { data: await set.view(request) } : null;\n  return { layouts, view };\n}\n\n/**\n * The argument a controller's `initialize()` receives: `{ params, query }`\n * exactly as before when the controller has no loader, plus `data` when one\n * ran for it.\n */\nexport function initializeArgument(\n  route: RouteInput,\n  loaded: LoadedData | null | undefined,\n): { params: Record<string, string>; query: Record<string, string>; data?: unknown } {\n  const base = { params: route.params, query: route.query };\n  return loaded ? { ...base, data: loaded.data } : base;\n}\n\n/** Call `initialize(argument)` when the controller declares one. */\nexport async function initializeController(controller: unknown, argument: unknown): Promise<void> {\n  const initialize = (controller as { initialize?: unknown } | null)?.initialize;\n  if (typeof initialize !== 'function') return;\n  await (initialize as (argument: unknown) => unknown).call(controller, argument);\n}\n"],"mappings":"AAqBO,MAAM,4BAA4B,CAAC,YAAY,UAAU;AAGzD,SAAS,0BAA0B,UAA4B;AACpE,MAAI,CAAC,YAAY,KAAK,QAAQ,EAAG,QAAO,CAAC;AACzC,QAAM,OAAO,SAAS,QAAQ,aAAa,EAAE;AAC7C,SAAO,0BAA0B,IAAI,CAAC,WAAW,OAAO,MAAM;AAChE;AAwBO,MAAM,aAA4B,OAAO,OAAO,EAAE,SAAS,OAAO,OAAO,CAAC,CAAC,GAAG,MAAM,KAAK,CAAC;AAG1F,SAAS,oBAAoB,MAAc,OAAgC;AAChF,SAAO;AAAA,IACL,KAAK;AAAA,IACL,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,IAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,IACxB,SAAS,CAAC;AAAA,IACV,SAAS,CAAC;AAAA,EACZ;AACF;AAGO,SAAS,iBAAiB,OAAgB,OAA2B;AAC1E,MAAI,OAAO,UAAU,YAAY;AAC/B,UAAM,IAAI,UAAU,GAAG,KAAK,0DAA0D;AAAA,EACxF;AACA,SAAO;AACT;AAMA,eAAsB,eACpB,KACA,SACA,iBAAiB,GACU;AAC3B,QAAM,UAAoC,CAAC;AAC3C,WAAS,QAAQ,GAAG,QAAQ,IAAI,QAAQ,QAAQ,SAAS,GAAG;AAC1D,UAAM,SAAS,QAAQ,iBAAiB,OAAO,IAAI,QAAQ,KAAK;AAChE,YAAQ,KAAK,SAAS,EAAE,MAAM,MAAM,OAAO,OAAO,EAAE,IAAI,IAAI;AAAA,EAC9D;AACA,QAAM,OAAO,IAAI,OAAO,EAAE,MAAM,MAAM,IAAI,KAAK,OAAO,EAAE,IAAI;AAC5D,SAAO,EAAE,SAAS,KAAK;AACzB;AAOO,SAAS,mBACd,OACA,QACmF;AACnF,QAAM,OAAO,EAAE,QAAQ,MAAM,QAAQ,OAAO,MAAM,MAAM;AACxD,SAAO,SAAS,EAAE,GAAG,MAAM,MAAM,OAAO,KAAK,IAAI;AACnD;AAGA,eAAsB,qBAAqB,YAAqB,UAAkC;AAChG,QAAM,aAAc,YAAgD;AACpE,MAAI,OAAO,eAAe,WAAY;AACtC,QAAO,WAA8C,KAAK,YAAY,QAAQ;AAChF;","names":[]}

package/dist/loader/loader_runner.cjs

@@ -35,69 +35,74 @@ var import_path = __toESM(require("path"), 1);
 var import_node_url = require("node:url");
 var import_fs = require("fs");
 var import_logger = require("@noego/logger");
+var import_loader_orchestration = require("./loader_orchestration.cjs");
 const logger = (0, import_logger.getLogger)("wood:loader");
 function toImportSpecifier(spec) {
   return import_path.default.isAbsolute(spec) ? (0, import_node_url.pathToFileURL)(spec).href : spec;
 }
+function mtimeOf(filePath) {
+  try {
+    return (0, import_fs.statSync)(filePath).mtimeMs;
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+}
 class LoaderRunner {
   constructor(componentDir) {
     this.cache = /* @__PURE__ */ new Map();
     this.componentDir = componentDir;
   }
   /**
-   * Discover the loader file for a view component.
-   * Convention: for `pages/chat/main.svelte`, look for `pages/chat/main.load.ts`
+   * Discover the loader file for a view component. Exactly one companion
+   * may exist; more than one is ambiguous and an error, none is `null`.
    */
   getLoaderPath(viewPath) {
-    const basePath = viewPath.replace(/\.svelte$/, ".load.ts");
-    return import_path.default.resolve(this.componentDir, basePath);
+    const present = [];
+    for (const candidate of (0, import_loader_orchestration.loaderCompanionCandidates)(viewPath)) {
+      const filePath = import_path.default.resolve(this.componentDir, candidate);
+      const mtime = mtimeOf(filePath);
+      if (mtime !== null) present.push({ filePath, mtime });
+    }
+    if (present.length > 1) {
+      throw new Error(
+        `Ambiguous loader for "${viewPath}": ${present.map((entry) => entry.filePath).join(", ")}; keep exactly one companion`
+      );
+    }
+    return present[0] ?? null;
   }
   /**
-   * Load a loader function with mtime-based cache invalidation.
-   * Returns null when no loader file exists (not an error).
+   * Load a loader function with mtime-based cache invalidation. Returns
+   * `null` only when no companion exists; an import failure or a module
+   * without a default loader function is an error.
    */
-  async loadLoader(loaderPath) {
-    try {
-      const stat = (0, import_fs.statSync)(loaderPath);
-      const mtime = stat.mtimeMs;
-      const cached = this.cache.get(loaderPath);
-      if (cached && cached.mtime === mtime) {
-        return cached.fn;
-      }
-      const mod = await import(`${toImportSpecifier(loaderPath)}?t=${Date.now()}`);
-      const fn = mod.default;
-      if (typeof fn !== "function") {
-        logger.warn(`Loader at "${loaderPath}" does not export a default function`);
-        return null;
-      }
-      logger.debug(`Loaded loader: ${loaderPath}`);
-      this.cache.set(loaderPath, { fn, mtime, filePath: loaderPath });
-      return fn;
-    } catch {
-      return null;
+  async loadLoader(viewPath) {
+    const located = this.getLoaderPath(viewPath);
+    if (!located) return null;
+    const { filePath, mtime } = located;
+    const cached = this.cache.get(filePath);
+    if (cached && cached.mtime === mtime) {
+      return cached.fn;
     }
+    const mod = await import(`${toImportSpecifier(filePath)}?t=${Date.now()}`);
+    const fn = (0, import_loader_orchestration.assertDataLoader)(mod.default, `Loader at "${filePath}"`);
+    logger.debug(`Loaded loader: ${filePath}`);
+    this.cache.set(filePath, { fn, mtime, filePath });
+    return fn;
   }
   /**
-   * Execute all loaders for a matched route.
-   * Layout loaders run in parallel, view loader runs after.
+   * Execute all loaders for a matched route: layouts in stack order, then
+   * the view (shared orchestration).
    */
   async executeLoaders(viewDef, requestData) {
-    const layoutLoaderPromises = viewDef.layouts.map(async (layoutPath) => {
-      const loaderPath = this.getLoaderPath(layoutPath);
-      const loader = await this.loadLoader(loaderPath);
-      if (loader) {
-        return loader(requestData);
-      }
-      return void 0;
-    });
-    const layoutData = await Promise.all(layoutLoaderPromises);
-    const viewLoaderPath = this.getLoaderPath(viewDef.viewPath);
-    const viewLoader = await this.loadLoader(viewLoaderPath);
-    const viewData = viewLoader ? await viewLoader(requestData) : {};
+    const layouts = [];
+    for (const layoutPath of viewDef.layouts) layouts.push(await this.loadLoader(layoutPath));
+    const view = await this.loadLoader(viewDef.viewPath);
+    const result = await (0, import_loader_orchestration.runViewLoaders)({ layouts, view }, requestData);
     logger.debug(`Executed loaders for view "${viewDef.pageName}": ${viewDef.layouts.length} layout(s)`);
     return {
-      layoutData: layoutData.filter((d) => d !== void 0),
-      viewData
+      layoutData: result.layouts.filter((entry) => entry !== null).map((entry) => entry.data),
+      viewData: result.view ? result.view.data : {}
     };
   }
   /** Clear the loader cache. */

package/dist/loader/loader_runner.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/loader/loader_runner.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { statSync } from 'fs';\nimport { getLogger } from '@noego/logger';\nimport type { RequestData, LoaderResult } from '../types/context.cjs';\nimport type { ViewDef } from '../types/views.cjs';\n\nconst logger = getLogger('wood:loader');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\ninterface LoaderEntry {\n  fn: (request: RequestData) => Promise<unknown>;\n  mtime: number;\n  filePath: string;\n}\n\nexport class LoaderRunner {\n  private cache = new Map<string, LoaderEntry>();\n  private componentDir: string;\n\n  constructor(componentDir: string) {\n    this.componentDir = componentDir;\n  }\n\n  /**\n   * Discover the loader file for a view component.\n   * Convention: for `pages/chat/main.svelte`, look for `pages/chat/main.load.ts`\n   */\n  private getLoaderPath(viewPath: string): string {\n    const basePath = viewPath.replace(/\\.svelte$/, '.load.ts');\n    return path.resolve(this.componentDir, basePath);\n  }\n\n  /**\n   * Load a loader function with mtime-based cache invalidation.\n   * Returns null when no loader file exists (not an error).\n   */\n  private async loadLoader(loaderPath: string): Promise<((request: RequestData) => Promise<unknown>) | null> {\n    try {\n      const stat = statSync(loaderPath);\n      const mtime = stat.mtimeMs;\n\n      const cached = this.cache.get(loaderPath);\n      if (cached && cached.mtime === mtime) {\n        return cached.fn;\n      }\n\n      // Dynamic import with cache-bust query for dev reloading\n      const mod = await import(`${toImportSpecifier(loaderPath)}?t=${Date.now()}`);\n      const fn = mod.default;\n\n      if (typeof fn !== 'function') {\n        logger.warn(`Loader at \"${loaderPath}\" does not export a default function`);\n        return null;\n      }\n\n      logger.debug(`Loaded loader: ${loaderPath}`);\n      this.cache.set(loaderPath, { fn, mtime, filePath: loaderPath });\n      return fn;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Execute all loaders for a matched route.\n   * Layout loaders run in parallel, view loader runs after.\n   */\n  async executeLoaders(\n    viewDef: ViewDef,\n    requestData: RequestData,\n  ): Promise<LoaderResult> {\n    // Load layout loaders in parallel\n    const layoutLoaderPromises = viewDef.layouts.map(async (layoutPath) => {\n      const loaderPath = this.getLoaderPath(layoutPath);\n      const loader = await this.loadLoader(loaderPath);\n      if (loader) {\n        return loader(requestData);\n      }\n      return undefined;\n    });\n\n    const layoutData = await Promise.all(layoutLoaderPromises);\n\n    // Load view loader\n    const viewLoaderPath = this.getLoaderPath(viewDef.viewPath);\n    const viewLoader = await this.loadLoader(viewLoaderPath);\n    const viewData = viewLoader ? await viewLoader(requestData) : {};\n\n    logger.debug(`Executed loaders for view \"${viewDef.pageName}\": ${viewDef.layouts.length} layout(s)`);\n\n    return {\n      layoutData: layoutData.filter((d) => d !== undefined),\n      viewData,\n    };\n  }\n\n  /** Clear the loader cache. */\n  clearCache(): void {\n    this.cache.clear();\n    logger.debug('Loader cache cleared');\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AACjB,sBAA8B;AAC9B,gBAAyB;AACzB,oBAA0B;AAI1B,MAAM,aAAS,yBAAU,aAAa;AAItC,SAAS,kBAAkB,MAAsB;AAC/C,SAAO,YAAAA,QAAK,WAAW,IAAI,QAAI,+BAAc,IAAI,EAAE,OAAO;AAC5D;AAQO,MAAM,aAAa;AAAA,EAIxB,YAAY,cAAsB;AAHlC,SAAQ,QAAQ,oBAAI,IAAyB;AAI3C,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,cAAc,UAA0B;AAC9C,UAAM,WAAW,SAAS,QAAQ,aAAa,UAAU;AACzD,WAAO,YAAAA,QAAK,QAAQ,KAAK,cAAc,QAAQ;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,WAAW,YAAkF;AACzG,QAAI;AACF,YAAM,WAAO,oBAAS,UAAU;AAChC,YAAM,QAAQ,KAAK;AAEnB,YAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,UAAI,UAAU,OAAO,UAAU,OAAO;AACpC,eAAO,OAAO;AAAA,MAChB;AAGA,YAAM,MAAM,MAAM,OAAO,GAAG,kBAAkB,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC;AACzE,YAAM,KAAK,IAAI;AAEf,UAAI,OAAO,OAAO,YAAY;AAC5B,eAAO,KAAK,cAAc,UAAU,sCAAsC;AAC1E,eAAO;AAAA,MACT;AAEA,aAAO,MAAM,kBAAkB,UAAU,EAAE;AAC3C,WAAK,MAAM,IAAI,YAAY,EAAE,IAAI,OAAO,UAAU,WAAW,CAAC;AAC9D,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eACJ,SACA,aACuB;AAEvB,UAAM,uBAAuB,QAAQ,QAAQ,IAAI,OAAO,eAAe;AACrE,YAAM,aAAa,KAAK,cAAc,UAAU;AAChD,YAAM,SAAS,MAAM,KAAK,WAAW,UAAU;AAC/C,UAAI,QAAQ;AACV,eAAO,OAAO,WAAW;AAAA,MAC3B;AACA,aAAO;AAAA,IACT,CAAC;AAED,UAAM,aAAa,MAAM,QAAQ,IAAI,oBAAoB;AAGzD,UAAM,iBAAiB,KAAK,cAAc,QAAQ,QAAQ;AAC1D,UAAM,aAAa,MAAM,KAAK,WAAW,cAAc;AACvD,UAAM,WAAW,aAAa,MAAM,WAAW,WAAW,IAAI,CAAC;AAE/D,WAAO,MAAM,8BAA8B,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,MAAM,YAAY;AAEnG,WAAO;AAAA,MACL,YAAY,WAAW,OAAO,CAAC,MAAM,MAAM,MAAS;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,aAAmB;AACjB,SAAK,MAAM,MAAM;AACjB,WAAO,MAAM,sBAAsB;AAAA,EACrC;AACF;","names":["path"]}
+{"version":3,"sources":["../../src/loader/loader_runner.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { statSync } from 'fs';\nimport { getLogger } from '@noego/logger';\nimport type { RequestData, LoaderResult } from '../types/context.cjs';\nimport type { ViewDef } from '../types/views.cjs';\nimport {\n  assertDataLoader,\n  loaderCompanionCandidates,\n  runViewLoaders,\n  type DataLoader,\n} from './loader_orchestration.cjs';\n\nconst logger = getLogger('wood:loader');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\ninterface LoaderEntry {\n  fn: DataLoader;\n  mtime: number;\n  filePath: string;\n}\n\nfunction mtimeOf(filePath: string): number | null {\n  try {\n    return statSync(filePath).mtimeMs;\n  } catch (error) {\n    if ((error as { code?: string }).code === 'ENOENT') return null;\n    throw error;\n  }\n}\n\n/**\n * Main-process loader runner over the shared companion convention\n * (`pages/chat/main.svelte` → `pages/chat/main.load.ts`), executed through\n * the same orchestration the renderer and the Node frontend surface use.\n */\nexport class LoaderRunner {\n  private cache = new Map<string, LoaderEntry>();\n  private componentDir: string;\n\n  constructor(componentDir: string) {\n    this.componentDir = componentDir;\n  }\n\n  /**\n   * Discover the loader file for a view component. Exactly one companion\n   * may exist; more than one is ambiguous and an error, none is `null`.\n   */\n  private getLoaderPath(viewPath: string): { filePath: string; mtime: number } | null {\n    const present: Array<{ filePath: string; mtime: number }> = [];\n    for (const candidate of loaderCompanionCandidates(viewPath)) {\n      const filePath = path.resolve(this.componentDir, candidate);\n      const mtime = mtimeOf(filePath);\n      if (mtime !== null) present.push({ filePath, mtime });\n    }\n    if (present.length > 1) {\n      throw new Error(\n        `Ambiguous loader for \"${viewPath}\": ${present.map((entry) => entry.filePath).join(', ')}; keep exactly one companion`,\n      );\n    }\n    return present[0] ?? null;\n  }\n\n  /**\n   * Load a loader function with mtime-based cache invalidation. Returns\n   * `null` only when no companion exists; an import failure or a module\n   * without a default loader function is an error.\n   */\n  private async loadLoader(viewPath: string): Promise<DataLoader | null> {\n    const located = this.getLoaderPath(viewPath);\n    if (!located) return null;\n    const { filePath, mtime } = located;\n\n    const cached = this.cache.get(filePath);\n    if (cached && cached.mtime === mtime) {\n      return cached.fn;\n    }\n\n    // Dynamic import with cache-bust query for dev reloading\n    const mod = (await import(`${toImportSpecifier(filePath)}?t=${Date.now()}`)) as { default?: unknown };\n    const fn = assertDataLoader(mod.default, `Loader at \"${filePath}\"`);\n\n    logger.debug(`Loaded loader: ${filePath}`);\n    this.cache.set(filePath, { fn, mtime, filePath });\n    return fn;\n  }\n\n  /**\n   * Execute all loaders for a matched route: layouts in stack order, then\n   * the view (shared orchestration).\n   */\n  async executeLoaders(\n    viewDef: ViewDef,\n    requestData: RequestData,\n  ): Promise<LoaderResult> {\n    const layouts: Array<DataLoader | null> = [];\n    for (const layoutPath of viewDef.layouts) layouts.push(await this.loadLoader(layoutPath));\n    const view = await this.loadLoader(viewDef.viewPath);\n\n    const result = await runViewLoaders({ layouts, view }, requestData);\n\n    logger.debug(`Executed loaders for view \"${viewDef.pageName}\": ${viewDef.layouts.length} layout(s)`);\n\n    return {\n      layoutData: result.layouts.filter((entry) => entry !== null).map((entry) => entry.data),\n      viewData: result.view ? result.view.data : {},\n    };\n  }\n\n  /** Clear the loader cache. */\n  clearCache(): void {\n    this.cache.clear();\n    logger.debug('Loader cache cleared');\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AACjB,sBAA8B;AAC9B,gBAAyB;AACzB,oBAA0B;AAG1B,kCAKO;AAEP,MAAM,aAAS,yBAAU,aAAa;AAItC,SAAS,kBAAkB,MAAsB;AAC/C,SAAO,YAAAA,QAAK,WAAW,IAAI,QAAI,+BAAc,IAAI,EAAE,OAAO;AAC5D;AAQA,SAAS,QAAQ,UAAiC;AAChD,MAAI;AACF,eAAO,oBAAS,QAAQ,EAAE;AAAA,EAC5B,SAAS,OAAO;AACd,QAAK,MAA4B,SAAS,SAAU,QAAO;AAC3D,UAAM;AAAA,EACR;AACF;AAOO,MAAM,aAAa;AAAA,EAIxB,YAAY,cAAsB;AAHlC,SAAQ,QAAQ,oBAAI,IAAyB;AAI3C,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,cAAc,UAA8D;AAClF,UAAM,UAAsD,CAAC;AAC7D,eAAW,iBAAa,uDAA0B,QAAQ,GAAG;AAC3D,YAAM,WAAW,YAAAA,QAAK,QAAQ,KAAK,cAAc,SAAS;AAC1D,YAAM,QAAQ,QAAQ,QAAQ;AAC9B,UAAI,UAAU,KAAM,SAAQ,KAAK,EAAE,UAAU,MAAM,CAAC;AAAA,IACtD;AACA,QAAI,QAAQ,SAAS,GAAG;AACtB,YAAM,IAAI;AAAA,QACR,yBAAyB,QAAQ,MAAM,QAAQ,IAAI,CAAC,UAAU,MAAM,QAAQ,EAAE,KAAK,IAAI,CAAC;AAAA,MAC1F;AAAA,IACF;AACA,WAAO,QAAQ,CAAC,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,WAAW,UAA8C;AACrE,UAAM,UAAU,KAAK,cAAc,QAAQ;AAC3C,QAAI,CAAC,QAAS,QAAO;AACrB,UAAM,EAAE,UAAU,MAAM,IAAI;AAE5B,UAAM,SAAS,KAAK,MAAM,IAAI,QAAQ;AACtC,QAAI,UAAU,OAAO,UAAU,OAAO;AACpC,aAAO,OAAO;AAAA,IAChB;AAGA,UAAM,MAAO,MAAM,OAAO,GAAG,kBAAkB,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;AACxE,UAAM,SAAK,8CAAiB,IAAI,SAAS,cAAc,QAAQ,GAAG;AAElE,WAAO,MAAM,kBAAkB,QAAQ,EAAE;AACzC,SAAK,MAAM,IAAI,UAAU,EAAE,IAAI,OAAO,SAAS,CAAC;AAChD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eACJ,SACA,aACuB;AACvB,UAAM,UAAoC,CAAC;AAC3C,eAAW,cAAc,QAAQ,QAAS,SAAQ,KAAK,MAAM,KAAK,WAAW,UAAU,CAAC;AACxF,UAAM,OAAO,MAAM,KAAK,WAAW,QAAQ,QAAQ;AAEnD,UAAM,SAAS,UAAM,4CAAe,EAAE,SAAS,KAAK,GAAG,WAAW;AAElE,WAAO,MAAM,8BAA8B,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,MAAM,YAAY;AAEnG,WAAO;AAAA,MACL,YAAY,OAAO,QAAQ,OAAO,CAAC,UAAU,UAAU,IAAI,EAAE,IAAI,CAAC,UAAU,MAAM,IAAI;AAAA,MACtF,UAAU,OAAO,OAAO,OAAO,KAAK,OAAO,CAAC;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA,EAGA,aAAmB;AACjB,SAAK,MAAM,MAAM;AACjB,WAAO,MAAM,sBAAsB;AAAA,EACrC;AACF;","names":["path"]}

package/dist/loader/loader_runner.d.cts

@@ -1,23 +1,29 @@
 import { RequestData, LoaderResult } from '../types/context.cjs';
 import { ViewDef } from '../types/views.cjs';
 
+/**
+ * Main-process loader runner over the shared companion convention
+ * (`pages/chat/main.svelte` → `pages/chat/main.load.ts`), executed through
+ * the same orchestration the renderer and the Node frontend surface use.
+ */
 declare class LoaderRunner {
     private cache;
     private componentDir;
     constructor(componentDir: string);
     /**
-     * Discover the loader file for a view component.
-     * Convention: for `pages/chat/main.svelte`, look for `pages/chat/main.load.ts`
+     * Discover the loader file for a view component. Exactly one companion
+     * may exist; more than one is ambiguous and an error, none is `null`.
      */
     private getLoaderPath;
     /**
-     * Load a loader function with mtime-based cache invalidation.
-     * Returns null when no loader file exists (not an error).
+     * Load a loader function with mtime-based cache invalidation. Returns
+     * `null` only when no companion exists; an import failure or a module
+     * without a default loader function is an error.
      */
     private loadLoader;
     /**
-     * Execute all loaders for a matched route.
-     * Layout loaders run in parallel, view loader runs after.
+     * Execute all loaders for a matched route: layouts in stack order, then
+     * the view (shared orchestration).
      */
     executeLoaders(viewDef: ViewDef, requestData: RequestData): Promise<LoaderResult>;
     /** Clear the loader cache. */

package/dist/loader/loader_runner.d.ts

@@ -1,23 +1,29 @@
 import { RequestData, LoaderResult } from '../types/context.js';
 import { ViewDef } from '../types/views.js';
 
+/**
+ * Main-process loader runner over the shared companion convention
+ * (`pages/chat/main.svelte` → `pages/chat/main.load.ts`), executed through
+ * the same orchestration the renderer and the Node frontend surface use.
+ */
 declare class LoaderRunner {
     private cache;
     private componentDir;
     constructor(componentDir: string);
     /**
-     * Discover the loader file for a view component.
-     * Convention: for `pages/chat/main.svelte`, look for `pages/chat/main.load.ts`
+     * Discover the loader file for a view component. Exactly one companion
+     * may exist; more than one is ambiguous and an error, none is `null`.
      */
     private getLoaderPath;
     /**
-     * Load a loader function with mtime-based cache invalidation.
-     * Returns null when no loader file exists (not an error).
+     * Load a loader function with mtime-based cache invalidation. Returns
+     * `null` only when no companion exists; an import failure or a module
+     * without a default loader function is an error.
      */
     private loadLoader;
     /**
-     * Execute all loaders for a matched route.
-     * Layout loaders run in parallel, view loader runs after.
+     * Execute all loaders for a matched route: layouts in stack order, then
+     * the view (shared orchestration).
      */
     executeLoaders(viewDef: ViewDef, requestData: RequestData): Promise<LoaderResult>;
     /** Clear the loader cache. */

package/dist/loader/loader_runner.js

@@ -2,69 +2,78 @@ import path from "path";
 import { pathToFileURL } from "node:url";
 import { statSync } from "fs";
 import { getLogger } from "@noego/logger";
+import {
+  assertDataLoader,
+  loaderCompanionCandidates,
+  runViewLoaders
+} from "./loader_orchestration.js";
 const logger = getLogger("wood:loader");
 function toImportSpecifier(spec) {
   return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;
 }
+function mtimeOf(filePath) {
+  try {
+    return statSync(filePath).mtimeMs;
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+}
 class LoaderRunner {
   constructor(componentDir) {
     this.cache = /* @__PURE__ */ new Map();
     this.componentDir = componentDir;
   }
   /**
-   * Discover the loader file for a view component.
-   * Convention: for `pages/chat/main.svelte`, look for `pages/chat/main.load.ts`
+   * Discover the loader file for a view component. Exactly one companion
+   * may exist; more than one is ambiguous and an error, none is `null`.
    */
   getLoaderPath(viewPath) {
-    const basePath = viewPath.replace(/\.svelte$/, ".load.ts");
-    return path.resolve(this.componentDir, basePath);
+    const present = [];
+    for (const candidate of loaderCompanionCandidates(viewPath)) {
+      const filePath = path.resolve(this.componentDir, candidate);
+      const mtime = mtimeOf(filePath);
+      if (mtime !== null) present.push({ filePath, mtime });
+    }
+    if (present.length > 1) {
+      throw new Error(
+        `Ambiguous loader for "${viewPath}": ${present.map((entry) => entry.filePath).join(", ")}; keep exactly one companion`
+      );
+    }
+    return present[0] ?? null;
   }
   /**
-   * Load a loader function with mtime-based cache invalidation.
-   * Returns null when no loader file exists (not an error).
+   * Load a loader function with mtime-based cache invalidation. Returns
+   * `null` only when no companion exists; an import failure or a module
+   * without a default loader function is an error.
    */
-  async loadLoader(loaderPath) {
-    try {
-      const stat = statSync(loaderPath);
-      const mtime = stat.mtimeMs;
-      const cached = this.cache.get(loaderPath);
-      if (cached && cached.mtime === mtime) {
-        return cached.fn;
-      }
-      const mod = await import(`${toImportSpecifier(loaderPath)}?t=${Date.now()}`);
-      const fn = mod.default;
-      if (typeof fn !== "function") {
-        logger.warn(`Loader at "${loaderPath}" does not export a default function`);
-        return null;
-      }
-      logger.debug(`Loaded loader: ${loaderPath}`);
-      this.cache.set(loaderPath, { fn, mtime, filePath: loaderPath });
-      return fn;
-    } catch {
-      return null;
+  async loadLoader(viewPath) {
+    const located = this.getLoaderPath(viewPath);
+    if (!located) return null;
+    const { filePath, mtime } = located;
+    const cached = this.cache.get(filePath);
+    if (cached && cached.mtime === mtime) {
+      return cached.fn;
     }
+    const mod = await import(`${toImportSpecifier(filePath)}?t=${Date.now()}`);
+    const fn = assertDataLoader(mod.default, `Loader at "${filePath}"`);
+    logger.debug(`Loaded loader: ${filePath}`);
+    this.cache.set(filePath, { fn, mtime, filePath });
+    return fn;
   }
   /**
-   * Execute all loaders for a matched route.
-   * Layout loaders run in parallel, view loader runs after.
+   * Execute all loaders for a matched route: layouts in stack order, then
+   * the view (shared orchestration).
    */
   async executeLoaders(viewDef, requestData) {
-    const layoutLoaderPromises = viewDef.layouts.map(async (layoutPath) => {
-      const loaderPath = this.getLoaderPath(layoutPath);
-      const loader = await this.loadLoader(loaderPath);
-      if (loader) {
-        return loader(requestData);
-      }
-      return void 0;
-    });
-    const layoutData = await Promise.all(layoutLoaderPromises);
-    const viewLoaderPath = this.getLoaderPath(viewDef.viewPath);
-    const viewLoader = await this.loadLoader(viewLoaderPath);
-    const viewData = viewLoader ? await viewLoader(requestData) : {};
+    const layouts = [];
+    for (const layoutPath of viewDef.layouts) layouts.push(await this.loadLoader(layoutPath));
+    const view = await this.loadLoader(viewDef.viewPath);
+    const result = await runViewLoaders({ layouts, view }, requestData);
     logger.debug(`Executed loaders for view "${viewDef.pageName}": ${viewDef.layouts.length} layout(s)`);
     return {
-      layoutData: layoutData.filter((d) => d !== void 0),
-      viewData
+      layoutData: result.layouts.filter((entry) => entry !== null).map((entry) => entry.data),
+      viewData: result.view ? result.view.data : {}
     };
   }
   /** Clear the loader cache. */

package/dist/loader/loader_runner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/loader/loader_runner.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { statSync } from 'fs';\nimport { getLogger } from '@noego/logger';\nimport type { RequestData, LoaderResult } from '../types/context.js';\nimport type { ViewDef } from '../types/views.js';\n\nconst logger = getLogger('wood:loader');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\ninterface LoaderEntry {\n  fn: (request: RequestData) => Promise<unknown>;\n  mtime: number;\n  filePath: string;\n}\n\nexport class LoaderRunner {\n  private cache = new Map<string, LoaderEntry>();\n  private componentDir: string;\n\n  constructor(componentDir: string) {\n    this.componentDir = componentDir;\n  }\n\n  /**\n   * Discover the loader file for a view component.\n   * Convention: for `pages/chat/main.svelte`, look for `pages/chat/main.load.ts`\n   */\n  private getLoaderPath(viewPath: string): string {\n    const basePath = viewPath.replace(/\\.svelte$/, '.load.ts');\n    return path.resolve(this.componentDir, basePath);\n  }\n\n  /**\n   * Load a loader function with mtime-based cache invalidation.\n   * Returns null when no loader file exists (not an error).\n   */\n  private async loadLoader(loaderPath: string): Promise<((request: RequestData) => Promise<unknown>) | null> {\n    try {\n      const stat = statSync(loaderPath);\n      const mtime = stat.mtimeMs;\n\n      const cached = this.cache.get(loaderPath);\n      if (cached && cached.mtime === mtime) {\n        return cached.fn;\n      }\n\n      // Dynamic import with cache-bust query for dev reloading\n      const mod = await import(`${toImportSpecifier(loaderPath)}?t=${Date.now()}`);\n      const fn = mod.default;\n\n      if (typeof fn !== 'function') {\n        logger.warn(`Loader at \"${loaderPath}\" does not export a default function`);\n        return null;\n      }\n\n      logger.debug(`Loaded loader: ${loaderPath}`);\n      this.cache.set(loaderPath, { fn, mtime, filePath: loaderPath });\n      return fn;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Execute all loaders for a matched route.\n   * Layout loaders run in parallel, view loader runs after.\n   */\n  async executeLoaders(\n    viewDef: ViewDef,\n    requestData: RequestData,\n  ): Promise<LoaderResult> {\n    // Load layout loaders in parallel\n    const layoutLoaderPromises = viewDef.layouts.map(async (layoutPath) => {\n      const loaderPath = this.getLoaderPath(layoutPath);\n      const loader = await this.loadLoader(loaderPath);\n      if (loader) {\n        return loader(requestData);\n      }\n      return undefined;\n    });\n\n    const layoutData = await Promise.all(layoutLoaderPromises);\n\n    // Load view loader\n    const viewLoaderPath = this.getLoaderPath(viewDef.viewPath);\n    const viewLoader = await this.loadLoader(viewLoaderPath);\n    const viewData = viewLoader ? await viewLoader(requestData) : {};\n\n    logger.debug(`Executed loaders for view \"${viewDef.pageName}\": ${viewDef.layouts.length} layout(s)`);\n\n    return {\n      layoutData: layoutData.filter((d) => d !== undefined),\n      viewData,\n    };\n  }\n\n  /** Clear the loader cache. */\n  clearCache(): void {\n    this.cache.clear();\n    logger.debug('Loader cache cleared');\n  }\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAI1B,MAAM,SAAS,UAAU,aAAa;AAItC,SAAS,kBAAkB,MAAsB;AAC/C,SAAO,KAAK,WAAW,IAAI,IAAI,cAAc,IAAI,EAAE,OAAO;AAC5D;AAQO,MAAM,aAAa;AAAA,EAIxB,YAAY,cAAsB;AAHlC,SAAQ,QAAQ,oBAAI,IAAyB;AAI3C,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,cAAc,UAA0B;AAC9C,UAAM,WAAW,SAAS,QAAQ,aAAa,UAAU;AACzD,WAAO,KAAK,QAAQ,KAAK,cAAc,QAAQ;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,WAAW,YAAkF;AACzG,QAAI;AACF,YAAM,OAAO,SAAS,UAAU;AAChC,YAAM,QAAQ,KAAK;AAEnB,YAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,UAAI,UAAU,OAAO,UAAU,OAAO;AACpC,eAAO,OAAO;AAAA,MAChB;AAGA,YAAM,MAAM,MAAM,OAAO,GAAG,kBAAkB,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC;AACzE,YAAM,KAAK,IAAI;AAEf,UAAI,OAAO,OAAO,YAAY;AAC5B,eAAO,KAAK,cAAc,UAAU,sCAAsC;AAC1E,eAAO;AAAA,MACT;AAEA,aAAO,MAAM,kBAAkB,UAAU,EAAE;AAC3C,WAAK,MAAM,IAAI,YAAY,EAAE,IAAI,OAAO,UAAU,WAAW,CAAC;AAC9D,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eACJ,SACA,aACuB;AAEvB,UAAM,uBAAuB,QAAQ,QAAQ,IAAI,OAAO,eAAe;AACrE,YAAM,aAAa,KAAK,cAAc,UAAU;AAChD,YAAM,SAAS,MAAM,KAAK,WAAW,UAAU;AAC/C,UAAI,QAAQ;AACV,eAAO,OAAO,WAAW;AAAA,MAC3B;AACA,aAAO;AAAA,IACT,CAAC;AAED,UAAM,aAAa,MAAM,QAAQ,IAAI,oBAAoB;AAGzD,UAAM,iBAAiB,KAAK,cAAc,QAAQ,QAAQ;AAC1D,UAAM,aAAa,MAAM,KAAK,WAAW,cAAc;AACvD,UAAM,WAAW,aAAa,MAAM,WAAW,WAAW,IAAI,CAAC;AAE/D,WAAO,MAAM,8BAA8B,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,MAAM,YAAY;AAEnG,WAAO;AAAA,MACL,YAAY,WAAW,OAAO,CAAC,MAAM,MAAM,MAAS;AAAA,MACpD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,aAAmB;AACjB,SAAK,MAAM,MAAM;AACjB,WAAO,MAAM,sBAAsB;AAAA,EACrC;AACF;","names":[]}
+{"version":3,"sources":["../../src/loader/loader_runner.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { statSync } from 'fs';\nimport { getLogger } from '@noego/logger';\nimport type { RequestData, LoaderResult } from '../types/context.js';\nimport type { ViewDef } from '../types/views.js';\nimport {\n  assertDataLoader,\n  loaderCompanionCandidates,\n  runViewLoaders,\n  type DataLoader,\n} from './loader_orchestration.js';\n\nconst logger = getLogger('wood:loader');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\ninterface LoaderEntry {\n  fn: DataLoader;\n  mtime: number;\n  filePath: string;\n}\n\nfunction mtimeOf(filePath: string): number | null {\n  try {\n    return statSync(filePath).mtimeMs;\n  } catch (error) {\n    if ((error as { code?: string }).code === 'ENOENT') return null;\n    throw error;\n  }\n}\n\n/**\n * Main-process loader runner over the shared companion convention\n * (`pages/chat/main.svelte` → `pages/chat/main.load.ts`), executed through\n * the same orchestration the renderer and the Node frontend surface use.\n */\nexport class LoaderRunner {\n  private cache = new Map<string, LoaderEntry>();\n  private componentDir: string;\n\n  constructor(componentDir: string) {\n    this.componentDir = componentDir;\n  }\n\n  /**\n   * Discover the loader file for a view component. Exactly one companion\n   * may exist; more than one is ambiguous and an error, none is `null`.\n   */\n  private getLoaderPath(viewPath: string): { filePath: string; mtime: number } | null {\n    const present: Array<{ filePath: string; mtime: number }> = [];\n    for (const candidate of loaderCompanionCandidates(viewPath)) {\n      const filePath = path.resolve(this.componentDir, candidate);\n      const mtime = mtimeOf(filePath);\n      if (mtime !== null) present.push({ filePath, mtime });\n    }\n    if (present.length > 1) {\n      throw new Error(\n        `Ambiguous loader for \"${viewPath}\": ${present.map((entry) => entry.filePath).join(', ')}; keep exactly one companion`,\n      );\n    }\n    return present[0] ?? null;\n  }\n\n  /**\n   * Load a loader function with mtime-based cache invalidation. Returns\n   * `null` only when no companion exists; an import failure or a module\n   * without a default loader function is an error.\n   */\n  private async loadLoader(viewPath: string): Promise<DataLoader | null> {\n    const located = this.getLoaderPath(viewPath);\n    if (!located) return null;\n    const { filePath, mtime } = located;\n\n    const cached = this.cache.get(filePath);\n    if (cached && cached.mtime === mtime) {\n      return cached.fn;\n    }\n\n    // Dynamic import with cache-bust query for dev reloading\n    const mod = (await import(`${toImportSpecifier(filePath)}?t=${Date.now()}`)) as { default?: unknown };\n    const fn = assertDataLoader(mod.default, `Loader at \"${filePath}\"`);\n\n    logger.debug(`Loaded loader: ${filePath}`);\n    this.cache.set(filePath, { fn, mtime, filePath });\n    return fn;\n  }\n\n  /**\n   * Execute all loaders for a matched route: layouts in stack order, then\n   * the view (shared orchestration).\n   */\n  async executeLoaders(\n    viewDef: ViewDef,\n    requestData: RequestData,\n  ): Promise<LoaderResult> {\n    const layouts: Array<DataLoader | null> = [];\n    for (const layoutPath of viewDef.layouts) layouts.push(await this.loadLoader(layoutPath));\n    const view = await this.loadLoader(viewDef.viewPath);\n\n    const result = await runViewLoaders({ layouts, view }, requestData);\n\n    logger.debug(`Executed loaders for view \"${viewDef.pageName}\": ${viewDef.layouts.length} layout(s)`);\n\n    return {\n      layoutData: result.layouts.filter((entry) => entry !== null).map((entry) => entry.data),\n      viewData: result.view ? result.view.data : {},\n    };\n  }\n\n  /** Clear the loader cache. */\n  clearCache(): void {\n    this.cache.clear();\n    logger.debug('Loader cache cleared');\n  }\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAG1B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,MAAM,SAAS,UAAU,aAAa;AAItC,SAAS,kBAAkB,MAAsB;AAC/C,SAAO,KAAK,WAAW,IAAI,IAAI,cAAc,IAAI,EAAE,OAAO;AAC5D;AAQA,SAAS,QAAQ,UAAiC;AAChD,MAAI;AACF,WAAO,SAAS,QAAQ,EAAE;AAAA,EAC5B,SAAS,OAAO;AACd,QAAK,MAA4B,SAAS,SAAU,QAAO;AAC3D,UAAM;AAAA,EACR;AACF;AAOO,MAAM,aAAa;AAAA,EAIxB,YAAY,cAAsB;AAHlC,SAAQ,QAAQ,oBAAI,IAAyB;AAI3C,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,cAAc,UAA8D;AAClF,UAAM,UAAsD,CAAC;AAC7D,eAAW,aAAa,0BAA0B,QAAQ,GAAG;AAC3D,YAAM,WAAW,KAAK,QAAQ,KAAK,cAAc,SAAS;AAC1D,YAAM,QAAQ,QAAQ,QAAQ;AAC9B,UAAI,UAAU,KAAM,SAAQ,KAAK,EAAE,UAAU,MAAM,CAAC;AAAA,IACtD;AACA,QAAI,QAAQ,SAAS,GAAG;AACtB,YAAM,IAAI;AAAA,QACR,yBAAyB,QAAQ,MAAM,QAAQ,IAAI,CAAC,UAAU,MAAM,QAAQ,EAAE,KAAK,IAAI,CAAC;AAAA,MAC1F;AAAA,IACF;AACA,WAAO,QAAQ,CAAC,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,WAAW,UAA8C;AACrE,UAAM,UAAU,KAAK,cAAc,QAAQ;AAC3C,QAAI,CAAC,QAAS,QAAO;AACrB,UAAM,EAAE,UAAU,MAAM,IAAI;AAE5B,UAAM,SAAS,KAAK,MAAM,IAAI,QAAQ;AACtC,QAAI,UAAU,OAAO,UAAU,OAAO;AACpC,aAAO,OAAO;AAAA,IAChB;AAGA,UAAM,MAAO,MAAM,OAAO,GAAG,kBAAkB,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;AACxE,UAAM,KAAK,iBAAiB,IAAI,SAAS,cAAc,QAAQ,GAAG;AAElE,WAAO,MAAM,kBAAkB,QAAQ,EAAE;AACzC,SAAK,MAAM,IAAI,UAAU,EAAE,IAAI,OAAO,SAAS,CAAC;AAChD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eACJ,SACA,aACuB;AACvB,UAAM,UAAoC,CAAC;AAC3C,eAAW,cAAc,QAAQ,QAAS,SAAQ,KAAK,MAAM,KAAK,WAAW,UAAU,CAAC;AACxF,UAAM,OAAO,MAAM,KAAK,WAAW,QAAQ,QAAQ;AAEnD,UAAM,SAAS,MAAM,eAAe,EAAE,SAAS,KAAK,GAAG,WAAW;AAElE,WAAO,MAAM,8BAA8B,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,MAAM,YAAY;AAEnG,WAAO;AAAA,MACL,YAAY,OAAO,QAAQ,OAAO,CAAC,UAAU,UAAU,IAAI,EAAE,IAAI,CAAC,UAAU,MAAM,IAAI;AAAA,MACtF,UAAU,OAAO,OAAO,OAAO,KAAK,OAAO,CAAC;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA,EAGA,aAAmB;AACjB,SAAK,MAAM,MAAM;AACjB,WAAO,MAAM,sBAAsB;AAAA,EACrC;AACF;","names":[]}