@dudousxd/nestjs-codegen 0.26.0 → 0.27.1

package/dist/extension/index.d.cts

@@ -1,2 +1,2 @@
-export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-Bbw73Kkb.cjs';
+export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-Dc4s883u.cjs';
 import 'ts-morph';

package/dist/extension/index.d.ts

@@ -1,2 +1,2 @@
-export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-Bbw73Kkb.js';
+export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-Dc4s883u.js';
 import 'ts-morph';

package/dist/{index-Bbw73Kkb.d.cts → index-Dc4s883u.d.cts}

@@ -238,9 +238,22 @@ interface UserConfig {
     validation: ValidationOption;
     /** Inertia page discovery. Omit when you don't use Inertia. */
     pages?: {
-        glob: string;
+        /**
+         * Page files of the default Inertia app (`InertiaModule.forRoot`), relative to `cwd`. One
+         * glob or several; a page is named relative to the static base of the glob that matched it
+         * (`inertia/pages/users/Show.tsx` under `inertia/pages/**\/*.tsx` → `users/Show`).
+         */
+        glob: string | string[];
         propsExport?: string;
-        componentNameStrategy?: 'relative-no-ext' | 'kebab' | ((path: string) => string);
+        componentNameStrategy?: PageNameStrategy;
+        /**
+         * Further Inertia apps, one per `InertiaModule.forFeature({ scope })`, keyed by scope name.
+         * Each has its own page glob(s); its page names get a prefix (default `'<scope>/'`, so
+         * `minimal/pages/Home.tsx` → `minimal/Home`, the name its `@Inertia('minimal/Home')`
+         * handlers render). Every page of every scope lands in `InertiaPages`/`InertiaPageName`;
+         * `InertiaScopePages` lists each scope's page names.
+         */
+        scopes?: Record<string, PageScopeConfig>;
     };
     contracts?: {
         /** Glob pattern (relative to cwd) for controller files. Default: `'src/**\/\*.controller.ts'` */
@@ -248,6 +261,11 @@ interface UserConfig {
         /** Debounce delay in ms before re-running route discovery. Default: `500` */
         debounceMs?: number;
     };
+    /**
+     * @deprecated Has no effect: discovery never read it. For several Inertia apps use
+     * `pages.scopes`; for several controller sets use one `contracts.glob` (brace/extglob).
+     * A config that sets it gets a warning.
+     */
     scopes?: Record<string, ScopeConfig>;
     codegen?: {
         outDir?: string;
@@ -344,14 +362,33 @@ interface UserConfig {
      */
     driftGuard?: boolean;
 }
+/** @deprecated See `UserConfig.scopes`. */
 interface ScopeConfig {
     glob: string;
     prefix?: string;
 }
+/** How a page file's path (relative to its glob's static base) becomes its component name. */
+type PageNameStrategy = 'relative-no-ext' | 'kebab' | ((path: string) => string);
+/** One more Inertia app (an `InertiaModule.forFeature({ scope })`) — see `pages.scopes`. */
+interface PageScopeConfig {
+    /** Page files of this app, relative to `cwd`. */
+    glob: string | string[];
+    /** Prepended to every page name of this scope. Default `'<scope>/'`; `''` for none. */
+    prefix?: string;
+    /** Naming strategy for this scope's pages. Default: `pages.componentNameStrategy`. */
+    componentNameStrategy?: PageNameStrategy;
+}
+interface ResolvedPageScopeConfig {
+    glob: string | string[];
+    prefix: string;
+    componentNameStrategy: PageNameStrategy;
+}
 interface ResolvedPagesConfig {
-    glob: string;
+    glob: string | string[];
     propsExport: string;
-    componentNameStrategy: 'relative-no-ext' | 'kebab' | ((path: string) => string);
+    componentNameStrategy: PageNameStrategy;
+    /** Feature scopes (not including the default app), with defaults applied. */
+    scopes: Record<string, ResolvedPageScopeConfig>;
 }
 interface ResolvedContractsConfig {
     /** Glob pattern relative to `codegen.cwd` for watching controller files. */

package/dist/{index-Bbw73Kkb.d.ts → index-Dc4s883u.d.ts}

@@ -238,9 +238,22 @@ interface UserConfig {
     validation: ValidationOption;
     /** Inertia page discovery. Omit when you don't use Inertia. */
     pages?: {
-        glob: string;
+        /**
+         * Page files of the default Inertia app (`InertiaModule.forRoot`), relative to `cwd`. One
+         * glob or several; a page is named relative to the static base of the glob that matched it
+         * (`inertia/pages/users/Show.tsx` under `inertia/pages/**\/*.tsx` → `users/Show`).
+         */
+        glob: string | string[];
         propsExport?: string;
-        componentNameStrategy?: 'relative-no-ext' | 'kebab' | ((path: string) => string);
+        componentNameStrategy?: PageNameStrategy;
+        /**
+         * Further Inertia apps, one per `InertiaModule.forFeature({ scope })`, keyed by scope name.
+         * Each has its own page glob(s); its page names get a prefix (default `'<scope>/'`, so
+         * `minimal/pages/Home.tsx` → `minimal/Home`, the name its `@Inertia('minimal/Home')`
+         * handlers render). Every page of every scope lands in `InertiaPages`/`InertiaPageName`;
+         * `InertiaScopePages` lists each scope's page names.
+         */
+        scopes?: Record<string, PageScopeConfig>;
     };
     contracts?: {
         /** Glob pattern (relative to cwd) for controller files. Default: `'src/**\/\*.controller.ts'` */
@@ -248,6 +261,11 @@ interface UserConfig {
         /** Debounce delay in ms before re-running route discovery. Default: `500` */
         debounceMs?: number;
     };
+    /**
+     * @deprecated Has no effect: discovery never read it. For several Inertia apps use
+     * `pages.scopes`; for several controller sets use one `contracts.glob` (brace/extglob).
+     * A config that sets it gets a warning.
+     */
     scopes?: Record<string, ScopeConfig>;
     codegen?: {
         outDir?: string;
@@ -344,14 +362,33 @@ interface UserConfig {
      */
     driftGuard?: boolean;
 }
+/** @deprecated See `UserConfig.scopes`. */
 interface ScopeConfig {
     glob: string;
     prefix?: string;
 }
+/** How a page file's path (relative to its glob's static base) becomes its component name. */
+type PageNameStrategy = 'relative-no-ext' | 'kebab' | ((path: string) => string);
+/** One more Inertia app (an `InertiaModule.forFeature({ scope })`) — see `pages.scopes`. */
+interface PageScopeConfig {
+    /** Page files of this app, relative to `cwd`. */
+    glob: string | string[];
+    /** Prepended to every page name of this scope. Default `'<scope>/'`; `''` for none. */
+    prefix?: string;
+    /** Naming strategy for this scope's pages. Default: `pages.componentNameStrategy`. */
+    componentNameStrategy?: PageNameStrategy;
+}
+interface ResolvedPageScopeConfig {
+    glob: string | string[];
+    prefix: string;
+    componentNameStrategy: PageNameStrategy;
+}
 interface ResolvedPagesConfig {
-    glob: string;
+    glob: string | string[];
     propsExport: string;
-    componentNameStrategy: 'relative-no-ext' | 'kebab' | ((path: string) => string);
+    componentNameStrategy: PageNameStrategy;
+    /** Feature scopes (not including the default app), with defaults applied. */
+    scopes: Record<string, ResolvedPageScopeConfig>;
 }
 interface ResolvedContractsConfig {
     /** Glob pattern relative to `codegen.cwd` for watching controller files. */

package/dist/index.cjs

@@ -149,12 +149,33 @@ function validateUserConfig(userConfig) {
       "validation adapter is required \u2014 install @dudousxd/nestjs-codegen-zod and pass zodAdapter, or use @dudousxd/nestjs-codegen-valibot / -arktype"
     );
   }
-  if (userConfig.pages && typeof userConfig.pages.glob !== "string") {
+  if (userConfig.pages && !isGlobInput(userConfig.pages.glob)) {
     throw new ConfigError(
-      "Config validation failed: `pages.glob` must be a string when `pages` is set"
+      "Config validation failed: `pages.glob` must be a string or a non-empty array of strings when `pages` is set"
+    );
+  }
+  for (const [scope, scopeConfig] of Object.entries(userConfig.pages?.scopes ?? {})) {
+    if (scope === "default") {
+      throw new ConfigError(
+        'Config validation failed: `pages.scopes` cannot declare "default" \u2014 the default app is `pages.glob` (InertiaModule.forRoot).'
+      );
+    }
+    if (!isGlobInput(scopeConfig?.glob)) {
+      throw new ConfigError(
+        `Config validation failed: \`pages.scopes.${scope}.glob\` must be a string or a non-empty array of strings`
+      );
+    }
+  }
+  if (userConfig.scopes && Object.keys(userConfig.scopes).length > 0) {
+    console.warn(
+      "[nestjs-codegen] The top-level `scopes` option has no effect and is deprecated. For several Inertia apps use `pages.scopes` (one entry per InertiaModule.forFeature scope); for several controller sets use one `contracts.glob` (e.g. a brace glob)."
     );
   }
 }
+function isGlobInput(value) {
+  if (typeof value === "string") return true;
+  return Array.isArray(value) && value.length > 0 && value.every((glob) => typeof glob === "string");
+}
 function applyDefaults(userConfig, cwd) {
   validateUserConfig(userConfig);
   const outDir = userConfig.codegen?.outDir ? resolveAbsolute(cwd, userConfig.codegen.outDir) : (0, import_node_path.join)(cwd, ".nestjs-codegen");
@@ -181,7 +202,17 @@ function applyDefaults(userConfig, cwd) {
     pages: userConfig.pages ? {
       glob: userConfig.pages.glob,
       propsExport: userConfig.pages.propsExport ?? "ComponentProps",
-      componentNameStrategy: userConfig.pages.componentNameStrategy ?? "relative-no-ext"
+      componentNameStrategy: userConfig.pages.componentNameStrategy ?? "relative-no-ext",
+      scopes: Object.fromEntries(
+        Object.entries(userConfig.pages.scopes ?? {}).map(([scope, scopeConfig]) => [
+          scope,
+          {
+            glob: scopeConfig.glob,
+            prefix: scopeConfig.prefix ?? `${scope}/`,
+            componentNameStrategy: scopeConfig.componentNameStrategy ?? userConfig.pages?.componentNameStrategy ?? "relative-no-ext"
+          }
+        ])
+      )
     } : null,
     contracts: {
       glob: userConfig.contracts?.glob ?? "src/**/*.controller.ts",
@@ -258,23 +289,81 @@ var import_promises2 = require("fs/promises");
 var import_node_path2 = require("path");
 var import_fast_glob = __toESM(require("fast-glob"), 1);
 var NON_PAGE_FILE_RE = /\.(?:test|spec|stories|story)\.(?:tsx?|jsx?|vue|svelte)$/i;
+var MAGIC_SEGMENT_RE = /[*?{}[\]()!]/;
+function globStaticBase(glob) {
+  const segments = glob.split("/");
+  const staticSegments = [];
+  for (const segment of segments.slice(0, -1)) {
+    if (MAGIC_SEGMENT_RE.test(segment)) break;
+    staticSegments.push(segment);
+  }
+  return staticSegments.join("/");
+}
 async function discoverPages(opts) {
-  const allFiles = await (0, import_fast_glob.default)(opts.glob, { cwd: opts.cwd, absolute: true });
-  const files = allFiles.filter((f) => !NON_PAGE_FILE_RE.test(f));
-  files.sort();
-  const globStatic = opts.glob.split("*")[0]?.replace(/\/$/, "") ?? "";
-  const pagesBase = (0, import_node_path2.join)(opts.cwd, globStatic);
+  const globs = typeof opts.glob === "string" ? [opts.glob] : opts.glob;
+  const prefix = opts.prefix ?? "";
+  const scope = opts.scope ?? "default";
+  const seenFiles = /* @__PURE__ */ new Set();
   const out = [];
-  for (const file of files) {
-    const rel = (0, import_node_path2.relative)(opts.cwd, file);
-    const nameRel = (0, import_node_path2.relative)(pagesBase, file);
-    const name = computeName(nameRel, opts.componentNameStrategy);
-    const source = await (0, import_promises2.readFile)(file, "utf8");
-    const propsSource = extractPropsSource(source, opts.propsExport);
-    out.push({ name, absolutePath: file, relativePath: rel, propsSource });
+  for (const glob of globs) {
+    const files = (await (0, import_fast_glob.default)(glob, { cwd: opts.cwd, absolute: true })).filter((f) => !NON_PAGE_FILE_RE.test(f) && !seenFiles.has(f)).sort();
+    const pagesBase = (0, import_node_path2.join)(opts.cwd, globStaticBase(glob));
+    for (const file of files) {
+      seenFiles.add(file);
+      const rel = (0, import_node_path2.relative)(opts.cwd, file);
+      const nameRel = (0, import_node_path2.relative)(pagesBase, file).split(import_node_path2.sep).join("/");
+      const name = `${prefix}${computeName(nameRel, opts.componentNameStrategy)}`;
+      const source = await (0, import_promises2.readFile)(file, "utf8");
+      const propsSource = extractPropsSource(source, opts.propsExport);
+      out.push({ name, absolutePath: file, relativePath: rel, propsSource, scope });
+    }
+  }
+  assertUniqueNames(out);
+  return out;
+}
+async function discoverPageScopes(config) {
+  const pages = config.pages;
+  if (!pages) return [];
+  const common = { cwd: config.codegen.cwd, propsExport: pages.propsExport };
+  const out = await discoverPages({
+    ...common,
+    glob: pages.glob,
+    componentNameStrategy: pages.componentNameStrategy
+  });
+  for (const [scope, scopeConfig] of Object.entries(pages.scopes ?? {})) {
+    out.push(
+      ...await discoverPages({
+        ...common,
+        glob: scopeConfig.glob,
+        componentNameStrategy: scopeConfig.componentNameStrategy,
+        prefix: scopeConfig.prefix,
+        scope
+      })
+    );
   }
+  assertUniqueNames(out);
   return out;
 }
+function allPageGlobs(config) {
+  if (!config.pages) return [];
+  const asList = (glob) => typeof glob === "string" ? [glob] : glob;
+  return [
+    ...asList(config.pages.glob),
+    ...Object.values(config.pages.scopes ?? {}).flatMap((scope) => asList(scope.glob))
+  ];
+}
+function assertUniqueNames(pages) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const previous = byName.get(page.name);
+    if (previous) {
+      throw new Error(
+        `Two Inertia pages resolve to the component name "${page.name}": ${previous.relativePath} (scope "${previous.scope}") and ${page.relativePath} (scope "${page.scope}"). Give one of them another name, directory or scope prefix.`
+      );
+    }
+    byName.set(page.name, page);
+  }
+}
 function computeName(rel, strat) {
   if (typeof strat === "function") return strat(rel);
   const noExt = rel.replace(/\.(tsx?|vue|svelte)$/, "");
@@ -686,10 +775,11 @@ function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
   }
   return [];
 }
-function resolveImportedType(name, sourceFile, project) {
+function resolveImportedType(name, sourceFile, project, seen = /* @__PURE__ */ new Set()) {
   for (const importDecl of sourceFile.getImportDeclarations()) {
-    const namedImport = importDecl.getNamedImports().find((n) => n.getName() === name);
+    const namedImport = importDecl.getNamedImports().find((n) => (n.getAliasNode()?.getText() ?? n.getName()) === name);
     if (!namedImport) continue;
+    const sourceName = namedImport.getName();
     const moduleSpecifier = importDecl.getModuleSpecifierValue();
     const candidates = resolveModuleSpecifier(moduleSpecifier, sourceFile, project);
     for (const candidate of candidates) {
@@ -701,17 +791,17 @@ function resolveImportedType(name, sourceFile, project) {
           continue;
         }
       }
-      const result = findTypeInFile(name, importedFile);
+      const result = findTypeInFile(sourceName, importedFile);
       if (result) return result;
-      const viaReExport = resolveReExportedType(name, importedFile, project, /* @__PURE__ */ new Set());
+      const viaReExport = resolveReExportedType(sourceName, importedFile, project, /* @__PURE__ */ new Set());
       if (viaReExport) return viaReExport;
     }
     if (candidates.length === 0) {
-      const viaCompiler = resolveBareSpecifierType(name, importDecl, project);
+      const viaCompiler = resolveBareSpecifierType(sourceName, importDecl, project);
       if (viaCompiler) return viaCompiler;
     }
   }
-  return resolveReExportedType(name, sourceFile, project, /* @__PURE__ */ new Set());
+  return resolveReExportedType(name, sourceFile, project, seen);
 }
 function resolveBareSpecifierType(name, importDecl, project) {
   let target;
@@ -726,9 +816,9 @@ function resolveBareSpecifierType(name, importDecl, project) {
   return resolveReExportedType(name, target, project, /* @__PURE__ */ new Set());
 }
 function resolveReExportedType(name, file, project, seen) {
-  const filePath = file.getFilePath();
-  if (seen.has(filePath)) return null;
-  seen.add(filePath);
+  const visit = `${file.getFilePath()}#${name}`;
+  if (seen.has(visit)) return null;
+  seen.add(visit);
   for (const exportDecl of file.getExportDeclarations()) {
     const moduleSpecifier = exportDecl.getModuleSpecifierValue();
     const namedExports = exportDecl.getNamedExports();
@@ -750,7 +840,7 @@ function resolveReExportedType(name, file, project, seen) {
     const sourceName = namedExports.find((n) => (n.getAliasNode()?.getText() ?? n.getName()) === name)?.getName() ?? name;
     const local = findTypeInFile(sourceName, file);
     if (local) return local;
-    const imported = resolveImportedType(sourceName, file, project);
+    const imported = resolveImportedType(sourceName, file, project, seen);
     if (imported) return imported;
   }
   return null;
@@ -4145,28 +4235,28 @@ function renderFetcherRequest(req, binaryResponse) {
 }
 function emitReqHelper() {
   return [
-    "/** Awaitable request handle. `await api.x.y({...})` runs the fetch; extensions add query/mutation helpers. */",
-    "type __Req<R> = {",
-    "  then<T1 = R, T2 = never>(",
+    "/** An awaitable request handle: a lazy, memoized `Promise` that also carries `fetch()` and the members extensions add. */",
+    "export type RequestHandle<R, M = {}> = Promise<R> & { fetch(): Promise<R> } & M;",
+    "class __Request<R> extends Promise<R> {",
+    "  static override get [Symbol.species](): PromiseConstructor {",
+    "    return Promise;",
+    "  }",
+    "  private __run: () => Promise<R>;",
+    "  private __p: Promise<R> | undefined;",
+    "  constructor(run: () => Promise<R>) {",
+    "    super(() => {});",
+    "    this.__run = run;",
+    "  }",
+    "  override then<T1 = R, T2 = never>(",
     "    onfulfilled?: ((value: R) => T1 | PromiseLike<T1>) | null,",
     "    onrejected?: ((reason: unknown) => T2 | PromiseLike<T2>) | null,",
-    "  ): Promise<T1 | T2>;",
-    "  catch<T = never>(onrejected?: ((reason: unknown) => T | PromiseLike<T>) | null): Promise<R | T>;",
-    "  finally(onfinally?: (() => void) | null): Promise<R>;",
-    "  fetch(): Promise<R>;",
-    "};",
-    "function __req<R>(run: () => Promise<R>): __Req<R> {",
-    "  let __p: Promise<R> | undefined;",
-    "  const __promise = () => {",
-    "    __p ??= run();",
-    "    return __p;",
-    "  };",
-    "  return {",
-    "    then: (onfulfilled, onrejected) => __promise().then(onfulfilled, onrejected),",
-    "    catch: (onrejected) => __promise().catch(onrejected),",
-    "    finally: (onfinally) => __promise().finally(onfinally),",
-    "    fetch: run,",
-    "  };",
+    "  ): Promise<T1 | T2> {",
+    "    this.__p ??= this.__run();",
+    "    return this.__p.then(onfulfilled, onrejected);",
+    "  }",
+    "}",
+    "function __req<R, M extends object = {}>(run: () => Promise<R>, members?: M): RequestHandle<R, M> {",
+    "  return Object.assign(new __Request<R>(run), { fetch: run }, members) as RequestHandle<R, M>;",
     "}",
     ""
   ];
@@ -4184,18 +4274,26 @@ function emitFilterFieldGuard() {
   ];
 }
 function renderLeaf(pad, objKey, req, requestExpr, members, streamExpr) {
-  const lines = [`${pad}${objKey}: (input?: ${req.inputType}) => ({`];
-  lines.push(`${pad}  ...__req<${req.responseType}>(() => ${requestExpr}),`);
+  const memberLines = [];
   if (req.filterFieldsExpr) {
-    lines.push(`${pad}  filterFields: ${req.filterFieldsExpr},`);
+    memberLines.push(`${pad}    filterFields: ${req.filterFieldsExpr},`);
   }
   if (streamExpr) {
-    lines.push(`${pad}  stream: () => ${streamExpr},`);
+    memberLines.push(`${pad}    stream: () => ${streamExpr},`);
   }
   for (const [name, value] of Object.entries(members)) {
-    lines.push(`${pad}  ${name}: ${value},`);
-  }
-  lines.push(`${pad}}),`);
+    memberLines.push(`${pad}    ${name}: ${value},`);
+  }
+  const body = [requestExpr, ...memberLines].join("\n");
+  const param = /\binput\b/.test(body) ? `input?: ${req.inputType}` : "";
+  const lines = [`${pad}${objKey}: (${param}) =>`];
+  if (memberLines.length === 0) {
+    lines.push(`${pad}  __req<${req.responseType}>(() => ${requestExpr}),`);
+    return lines;
+  }
+  lines.push(`${pad}  __req(() => ${requestExpr}, {`);
+  lines.push(...memberLines);
+  lines.push(`${pad}  }),`);
   return lines;
 }
 function renderStreamExpr(req) {
@@ -4329,6 +4427,23 @@ var EMPTY_PATH_NAMESPACE = [
 function isClientCallable(route) {
   return route.method.toUpperCase() !== "ALL";
 }
+var ROUTES_IMPORT_PLACEHOLDER = "/* @@routes-import@@ */";
+var ROUTES_EXPORTS = [
+  // Called, never mentioned in prose: match the call so a comment saying "route" doesn't count.
+  { name: "route", typeOnly: false },
+  { name: "ROUTES", typeOnly: false },
+  { name: "RouteName", typeOnly: true },
+  { name: "ExtractParams", typeOnly: true },
+  { name: "RouteParams", typeOnly: true }
+];
+function finishRoutesImport(lines) {
+  const body = lines.filter((l) => l !== ROUTES_IMPORT_PLACEHOLDER).join("\n");
+  const used = ROUTES_EXPORTS.filter(
+    ({ name }) => new RegExp(name === "route" ? "\\broute\\(" : `\\b${name}\\b`).test(body)
+  ).map(({ name, typeOnly }) => typeOnly ? `type ${name}` : name);
+  const importLine = used.length ? `import { ${used.join(", ")} } from './routes.js';` : null;
+  return lines.flatMap((l) => l === ROUTES_IMPORT_PLACEHOLDER ? importLine ? [importLine] : [] : [l]).join("\n");
+}
 function buildApiFile(routes, outDir, opts = {}) {
   const fetcherImportPath = opts.fetcherImportPath;
   const serialization = opts.serialization ?? "json";
@@ -4388,9 +4503,7 @@ function buildApiFile(routes, outDir, opts = {}) {
     for (const imp of ext.apiHeader?.(ctx)?.imports ?? []) pushImport(imp);
   }
   lines.push(...extImports);
-  lines.push(
-    "import { route, ROUTES, type RouteName, type ExtractParams, type RouteParams } from './routes.js';"
-  );
+  lines.push(ROUTES_IMPORT_PLACEHOLDER);
   const runtimeImport = fetcherImportPath ?? "@dudousxd/nestjs-client";
   lines.push(`import type { Fetcher } from '${runtimeImport}';`);
   if (serialization === "json" && contracted.length > 0) {
@@ -4441,7 +4554,7 @@ function buildApiFile(routes, outDir, opts = {}) {
         lines.push(...statements, "");
       }
     }
-    return lines.join("\n");
+    return finishRoutesImport(lines);
   }
   const tree = /* @__PURE__ */ new Map();
   for (const r of contracted) {
@@ -4494,7 +4607,7 @@ function buildApiFile(routes, outDir, opts = {}) {
       lines.push(...statements, "");
     }
   }
-  return lines.join("\n");
+  return finishRoutesImport(lines);
 }
 
 // src/emit/emit-cache.ts
@@ -4507,6 +4620,7 @@ async function emitCache(pages, outDir) {
       const s = await (0, import_promises4.stat)(p.absolutePath);
       return {
         name: p.name,
+        scope: p.scope ?? "default",
         relativePath: p.relativePath,
         mtime: s.mtime.toISOString()
       };
@@ -5301,10 +5415,11 @@ async function emitPages(pages, outDir, _options = {}) {
   }).join("\n");
   const propsHelper = "\nexport type InertiaProps<K extends InertiaPageName> = import('@dudousxd/nestjs-inertia').InertiaPages[K];\n";
   const sharedPropsBlock = buildSharedPropsBlock(_options.sharedProps ?? null);
+  const scopesBlock = buildScopesBlock(pages);
   const content = `// Generated by @dudousxd/nestjs-codegen. Do not edit.
 
 export type InertiaPageName = ${pageNameUnion};
-${propsHelper}
+${propsHelper}${scopesBlock}
 declare module '@dudousxd/nestjs-inertia' {
   interface InertiaPages {
 ${augBody}
@@ -5313,6 +5428,31 @@ ${sharedPropsBlock}}
 `;
   await (0, import_promises9.writeFile)((0, import_node_path13.join)(outDir, "pages.d.ts"), content, "utf8");
 }
+function buildScopesBlock(pages) {
+  const byScope = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const scope = page.scope ?? "default";
+    const names = byScope.get(scope) ?? [];
+    names.push(JSON.stringify(page.name));
+    byScope.set(scope, names);
+  }
+  if (![...byScope.keys()].some((scope) => scope !== "default")) return "";
+  if (!byScope.has("default")) byScope.set("default", []);
+  const scopes = ["default", ...[...byScope.keys()].filter((s) => s !== "default")];
+  const body = scopes.map((scope) => {
+    const key = needsQuotes(scope) ? JSON.stringify(scope) : scope;
+    const names = byScope.get(scope) ?? [];
+    return `  ${key}: ${names.length ? names.join(" | ") : "never"};`;
+  }).join("\n");
+  return `
+/** The page names of each Inertia app: \`default\` (forRoot) and every \`pages.scopes\` entry. */
+export interface InertiaScopePages {
+${body}
+}
+
+export type InertiaScopePageName<S extends keyof InertiaScopePages> = InertiaScopePages[S];
+`;
+}
 function buildSharedPropsBlock(sharedProps) {
   if (!sharedProps) return "";
   if (sharedProps.isImportRef) {
@@ -5520,8 +5660,7 @@ function diffConfigKeyHashes(previous, current) {
   return [...keys].filter((key) => previous[key] !== current[key]).sort();
 }
 async function discoverInputFiles(config) {
-  const globs = [config.contracts.glob, config.forms.watch];
-  if (config.pages) globs.push(config.pages.glob);
+  const globs = [config.contracts.glob, config.forms.watch, ...allPageGlobs(config)];
   const cwd = config.codegen.cwd;
   const matched = await (0, import_fast_glob3.default)(globs, { cwd, absolute: true, onlyFiles: true });
   return [...new Set(matched)].sort();
@@ -5652,12 +5791,7 @@ async function generate(config, inputRoutes = [], entryPoint = "cli") {
   }
   if (config.pages) {
     const pagesConfig = config.pages;
-    const pages = await discoverPages({
-      glob: pagesConfig.glob,
-      cwd: config.codegen.cwd,
-      propsExport: pagesConfig.propsExport,
-      componentNameStrategy: pagesConfig.componentNameStrategy
-    });
+    const pages = await discoverPageScopes(config);
     const sharedProps = discoverSharedPropsFromConfig(config);
     await emitPages(pages, config.codegen.outDir, {
       propsExport: pagesConfig.propsExport,
@@ -5832,12 +5966,17 @@ async function watch(config, onChange, options = {}) {
     await runInitialPass();
   }
   let pagesDebounceTimer;
-  const pagesGlob = config.pages?.glob ?? ".nestjs-codegen-no-pages";
-  const pagesWatcher = import_chokidar.default.watch((0, import_node_path18.join)(config.codegen.cwd, pagesGlob), {
-    ignoreInitial: true,
-    persistent: true,
-    awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
-  });
+  const pageGlobs = allPageGlobs(config);
+  const pagesWatcher = import_chokidar.default.watch(
+    (pageGlobs.length ? pageGlobs : [".nestjs-codegen-no-pages"]).map(
+      (glob) => (0, import_node_path18.join)(config.codegen.cwd, glob)
+    ),
+    {
+      ignoreInitial: true,
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
+    }
+  );
   function schedulePagesRegenerate() {
     if (pagesDebounceTimer !== void 0) {
       clearTimeout(pagesDebounceTimer);
@@ -6000,7 +6139,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.26.0";
+var VERSION = "0.27.1";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodegenError,