@open-mercato/cli 0.6.6-develop.6361.1.e790d2aa34 → 0.6.6-develop.6363.1.03c5e3429a

package/dist/lib/utils.js

@@ -170,7 +170,7 @@ function writeGeneratedFile(options) {
   const { outFile, checksumFile, content, structureChecksum, result, quiet } = options;
   const checksum = { content: calculateChecksum(content), structure: structureChecksum };
   const existing = readChecksumRecord(checksumFile);
-  const shouldWrite = !existing || existing.content !== checksum.content || existing.structure !== checksum.structure;
+  const shouldWrite = !fs.existsSync(outFile) || !existing || existing.content !== checksum.content || existing.structure !== checksum.structure;
   if (shouldWrite) {
     fs.mkdirSync(path.dirname(outFile), { recursive: true });
     fs.writeFileSync(outFile, content);

package/dist/lib/utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/utils.ts"],
-  "sourcesContent": ["import fs from 'node:fs'\nimport path from 'node:path'\nimport crypto from 'node:crypto'\nimport { pathToFileURL } from 'node:url'\n\nexport type ChecksumRecord = {\n  content: string\n  structure: string\n}\n\nexport interface GeneratorResult {\n  filesWritten: string[]\n  filesUnchanged: string[]\n  errors: string[]\n}\n\nexport function calculateChecksum(content: string): string {\n  return crypto.createHash('md5').update(content).digest('hex')\n}\n\nexport function readChecksumRecord(filePath: string): ChecksumRecord | null {\n  if (!fs.existsSync(filePath)) {\n    return null\n  }\n  try {\n    const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as Partial<ChecksumRecord>\n    if (parsed && typeof parsed.content === 'string' && typeof parsed.structure === 'string') {\n      return { content: parsed.content, structure: parsed.structure }\n    }\n  } catch {\n    // Invalid checksum file\n  }\n  return null\n}\n\nexport function writeChecksumRecord(filePath: string, record: ChecksumRecord): void {\n  fs.writeFileSync(filePath, JSON.stringify(record) + '\\n')\n}\n\nfunction collectStructureEntries(target: string, base: string, acc: string[]): void {\n  let entries: fs.Dirent[]\n  try {\n    entries = fs.readdirSync(target, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))\n  } catch (err) {\n    acc.push(`error:${path.relative(base, target)}:${(err as Error).message}`)\n    return\n  }\n\n  for (const entry of entries) {\n    const fullPath = path.join(target, entry.name)\n    const rel = path.relative(base, fullPath)\n    try {\n      const stat = fs.statSync(fullPath)\n      if (entry.isDirectory()) {\n        acc.push(`dir:${rel}:${stat.mtimeMs}`)\n        collectStructureEntries(fullPath, base, acc)\n      } else if (entry.isFile()) {\n        acc.push(`file:${rel}:${stat.size}:${stat.mtimeMs}`)\n      } else {\n        acc.push(`other:${rel}:${stat.mtimeMs}`)\n      }\n    } catch {\n      // File was deleted between readdir and stat - skip it\n      continue\n    }\n  }\n}\n\nexport function calculateStructureChecksum(paths: string[]): string {\n  const normalized = Array.from(new Set(paths.map((p) => path.resolve(p)))).sort((a, b) => a.localeCompare(b))\n  const entries: string[] = []\n  for (const target of normalized) {\n    if (!fs.existsSync(target)) {\n      entries.push(`missing:${target}`)\n      continue\n    }\n    const stat = fs.statSync(target)\n    entries.push(`${stat.isDirectory() ? 'dir' : 'file'}:${target}:${stat.mtimeMs}`)\n    if (stat.isDirectory()) collectStructureEntries(target, target, entries)\n  }\n  return calculateChecksum(entries.join('\\n'))\n}\n\nexport function writeIfChanged(\n  filePath: string,\n  content: string,\n  checksumPath?: string,\n  structureChecksum?: string\n): boolean {\n  const newChecksum = calculateChecksum(content)\n\n  if (checksumPath) {\n    const existingRecord = readChecksumRecord(checksumPath)\n    const newRecord: ChecksumRecord = {\n      content: newChecksum,\n      structure: structureChecksum || '',\n    }\n\n    const shouldWrite =\n      !existingRecord ||\n      existingRecord.content !== newRecord.content ||\n      (structureChecksum && existingRecord.structure !== newRecord.structure)\n\n    if (shouldWrite) {\n      ensureDir(filePath)\n      fs.writeFileSync(filePath, content)\n      writeChecksumRecord(checksumPath, newRecord)\n      return true\n    }\n    return false\n  }\n\n  // Simple comparison without checksum file\n  if (fs.existsSync(filePath)) {\n    const existing = fs.readFileSync(filePath, 'utf8')\n    if (existing === content) {\n      return false\n    }\n  }\n\n  ensureDir(filePath)\n  fs.writeFileSync(filePath, content)\n  return true\n}\n\nexport function ensureDir(filePath: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n}\n\n// Allowed path substrings for safe deletion. Include both POSIX and Windows separators.\nconst ALLOWED_RIMRAF_PATTERNS = [\n  '/generated/',\n  '/dist/',\n  '/.mercato/',\n  '/entities/',\n  '\\\\generated\\\\',\n  '\\\\dist\\\\',\n  '\\\\.mercato\\\\',\n  '\\\\entities\\\\',\n]\n\nexport function rimrafDir(dir: string, opts?: { allowedPatterns?: string[] }): void {\n  if (!fs.existsSync(dir)) return\n\n  // Safety check: only allow deletion within known safe directories\n  const resolved = path.resolve(dir)\n  const allowed = opts?.allowedPatterns ?? ALLOWED_RIMRAF_PATTERNS\n\n  // Normalize resolved path to support matching against both POSIX and Windows patterns\n  const normalized = {\n    posix: resolved.replace(/\\\\/g, '/'),\n    win: resolved.replace(/\\//g, '\\\\'),\n  }\n\n  if (!allowed.some((pattern) => normalized.posix.includes(pattern) || normalized.win.includes(pattern))) {\n    throw new Error(`Refusing to delete directory outside allowed paths: ${resolved}. Allowed patterns: ${allowed.join(', ')}`)\n  }\n\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n    const p = path.join(dir, entry.name)\n    if (entry.isDirectory()) rimrafDir(p, opts)\n    else fs.unlinkSync(p)\n  }\n  fs.rmdirSync(dir)\n}\n\nexport function toVar(s: string): string {\n  return s.replace(/[^a-zA-Z0-9_]/g, '_')\n}\n\nexport function toSnake(s: string): string {\n  return s\n    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n    .replace(/\\W+/g, '_')\n    .replace(/_{2,}/g, '_')\n    .replace(/(?:^_+|_+$)/g, '')\n    .toLowerCase()\n}\n\nexport function sourceFileHasNamedExport(filePath: string, exportName: string): boolean {\n  let source: string\n  try {\n    source = fs.readFileSync(filePath, 'utf8')\n  } catch {\n    return false\n  }\n\n  const escaped = exportName.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n  if (new RegExp(`export\\\\s+(?:const|let|var|function|class|async\\\\s+function)\\\\s+${escaped}\\\\b`).test(source)) {\n    return true\n  }\n  if (new RegExp(`export\\\\s+\\\\{[^}]*\\\\b${escaped}\\\\b[^}]*\\\\}`).test(source)) {\n    return true\n  }\n  return false\n}\n\nexport async function moduleHasExport(filePath: string, exportName: string): Promise<boolean> {\n  if (sourceFileHasNamedExport(filePath, exportName)) {\n    return true\n  }\n  try {\n    const isAbsolutePath = path.isAbsolute(filePath)\n    const importUrl = isAbsolutePath ? pathToFileURL(filePath).href : filePath\n    const mod = await import(importUrl)\n    return mod != null && Object.prototype.hasOwnProperty.call(mod, exportName)\n  } catch {\n    return false\n  }\n}\n\nexport function logGenerationResult(label: string, changed: boolean): void {\n  if (changed) {\n    console.log(`Generated ${label}`)\n  }\n}\n\nexport function createGeneratorResult(): GeneratorResult {\n  return {\n    filesWritten: [],\n    filesUnchanged: [],\n    errors: [],\n  }\n}\n\nexport function writeGeneratedFile(options: {\n  outFile: string\n  checksumFile: string\n  content: string\n  structureChecksum: string\n  result: GeneratorResult\n  quiet?: boolean\n}): void {\n  const { outFile, checksumFile, content, structureChecksum, result, quiet } = options\n  const checksum = { content: calculateChecksum(content), structure: structureChecksum }\n  const existing = readChecksumRecord(checksumFile)\n  const shouldWrite =\n    !existing ||\n    existing.content !== checksum.content ||\n    existing.structure !== checksum.structure\n  if (shouldWrite) {\n    fs.mkdirSync(path.dirname(outFile), { recursive: true })\n    fs.writeFileSync(outFile, content)\n    writeChecksumRecord(checksumFile, checksum)\n    result.filesWritten.push(outFile)\n  } else {\n    result.filesUnchanged.push(outFile)\n  }\n  if (!quiet) logGenerationResult(path.relative(process.cwd(), outFile), shouldWrite)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import fs from 'node:fs'\nimport path from 'node:path'\nimport crypto from 'node:crypto'\nimport { pathToFileURL } from 'node:url'\n\nexport type ChecksumRecord = {\n  content: string\n  structure: string\n}\n\nexport interface GeneratorResult {\n  filesWritten: string[]\n  filesUnchanged: string[]\n  errors: string[]\n}\n\nexport function calculateChecksum(content: string): string {\n  return crypto.createHash('md5').update(content).digest('hex')\n}\n\nexport function readChecksumRecord(filePath: string): ChecksumRecord | null {\n  if (!fs.existsSync(filePath)) {\n    return null\n  }\n  try {\n    const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as Partial<ChecksumRecord>\n    if (parsed && typeof parsed.content === 'string' && typeof parsed.structure === 'string') {\n      return { content: parsed.content, structure: parsed.structure }\n    }\n  } catch {\n    // Invalid checksum file\n  }\n  return null\n}\n\nexport function writeChecksumRecord(filePath: string, record: ChecksumRecord): void {\n  fs.writeFileSync(filePath, JSON.stringify(record) + '\\n')\n}\n\nfunction collectStructureEntries(target: string, base: string, acc: string[]): void {\n  let entries: fs.Dirent[]\n  try {\n    entries = fs.readdirSync(target, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))\n  } catch (err) {\n    acc.push(`error:${path.relative(base, target)}:${(err as Error).message}`)\n    return\n  }\n\n  for (const entry of entries) {\n    const fullPath = path.join(target, entry.name)\n    const rel = path.relative(base, fullPath)\n    try {\n      const stat = fs.statSync(fullPath)\n      if (entry.isDirectory()) {\n        acc.push(`dir:${rel}:${stat.mtimeMs}`)\n        collectStructureEntries(fullPath, base, acc)\n      } else if (entry.isFile()) {\n        acc.push(`file:${rel}:${stat.size}:${stat.mtimeMs}`)\n      } else {\n        acc.push(`other:${rel}:${stat.mtimeMs}`)\n      }\n    } catch {\n      // File was deleted between readdir and stat - skip it\n      continue\n    }\n  }\n}\n\nexport function calculateStructureChecksum(paths: string[]): string {\n  const normalized = Array.from(new Set(paths.map((p) => path.resolve(p)))).sort((a, b) => a.localeCompare(b))\n  const entries: string[] = []\n  for (const target of normalized) {\n    if (!fs.existsSync(target)) {\n      entries.push(`missing:${target}`)\n      continue\n    }\n    const stat = fs.statSync(target)\n    entries.push(`${stat.isDirectory() ? 'dir' : 'file'}:${target}:${stat.mtimeMs}`)\n    if (stat.isDirectory()) collectStructureEntries(target, target, entries)\n  }\n  return calculateChecksum(entries.join('\\n'))\n}\n\nexport function writeIfChanged(\n  filePath: string,\n  content: string,\n  checksumPath?: string,\n  structureChecksum?: string\n): boolean {\n  const newChecksum = calculateChecksum(content)\n\n  if (checksumPath) {\n    const existingRecord = readChecksumRecord(checksumPath)\n    const newRecord: ChecksumRecord = {\n      content: newChecksum,\n      structure: structureChecksum || '',\n    }\n\n    const shouldWrite =\n      !existingRecord ||\n      existingRecord.content !== newRecord.content ||\n      (structureChecksum && existingRecord.structure !== newRecord.structure)\n\n    if (shouldWrite) {\n      ensureDir(filePath)\n      fs.writeFileSync(filePath, content)\n      writeChecksumRecord(checksumPath, newRecord)\n      return true\n    }\n    return false\n  }\n\n  // Simple comparison without checksum file\n  if (fs.existsSync(filePath)) {\n    const existing = fs.readFileSync(filePath, 'utf8')\n    if (existing === content) {\n      return false\n    }\n  }\n\n  ensureDir(filePath)\n  fs.writeFileSync(filePath, content)\n  return true\n}\n\nexport function ensureDir(filePath: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n}\n\n// Allowed path substrings for safe deletion. Include both POSIX and Windows separators.\nconst ALLOWED_RIMRAF_PATTERNS = [\n  '/generated/',\n  '/dist/',\n  '/.mercato/',\n  '/entities/',\n  '\\\\generated\\\\',\n  '\\\\dist\\\\',\n  '\\\\.mercato\\\\',\n  '\\\\entities\\\\',\n]\n\nexport function rimrafDir(dir: string, opts?: { allowedPatterns?: string[] }): void {\n  if (!fs.existsSync(dir)) return\n\n  // Safety check: only allow deletion within known safe directories\n  const resolved = path.resolve(dir)\n  const allowed = opts?.allowedPatterns ?? ALLOWED_RIMRAF_PATTERNS\n\n  // Normalize resolved path to support matching against both POSIX and Windows patterns\n  const normalized = {\n    posix: resolved.replace(/\\\\/g, '/'),\n    win: resolved.replace(/\\//g, '\\\\'),\n  }\n\n  if (!allowed.some((pattern) => normalized.posix.includes(pattern) || normalized.win.includes(pattern))) {\n    throw new Error(`Refusing to delete directory outside allowed paths: ${resolved}. Allowed patterns: ${allowed.join(', ')}`)\n  }\n\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n    const p = path.join(dir, entry.name)\n    if (entry.isDirectory()) rimrafDir(p, opts)\n    else fs.unlinkSync(p)\n  }\n  fs.rmdirSync(dir)\n}\n\nexport function toVar(s: string): string {\n  return s.replace(/[^a-zA-Z0-9_]/g, '_')\n}\n\nexport function toSnake(s: string): string {\n  return s\n    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n    .replace(/\\W+/g, '_')\n    .replace(/_{2,}/g, '_')\n    .replace(/(?:^_+|_+$)/g, '')\n    .toLowerCase()\n}\n\nexport function sourceFileHasNamedExport(filePath: string, exportName: string): boolean {\n  let source: string\n  try {\n    source = fs.readFileSync(filePath, 'utf8')\n  } catch {\n    return false\n  }\n\n  const escaped = exportName.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n  if (new RegExp(`export\\\\s+(?:const|let|var|function|class|async\\\\s+function)\\\\s+${escaped}\\\\b`).test(source)) {\n    return true\n  }\n  if (new RegExp(`export\\\\s+\\\\{[^}]*\\\\b${escaped}\\\\b[^}]*\\\\}`).test(source)) {\n    return true\n  }\n  return false\n}\n\nexport async function moduleHasExport(filePath: string, exportName: string): Promise<boolean> {\n  if (sourceFileHasNamedExport(filePath, exportName)) {\n    return true\n  }\n  try {\n    const isAbsolutePath = path.isAbsolute(filePath)\n    const importUrl = isAbsolutePath ? pathToFileURL(filePath).href : filePath\n    const mod = await import(importUrl)\n    return mod != null && Object.prototype.hasOwnProperty.call(mod, exportName)\n  } catch {\n    return false\n  }\n}\n\nexport function logGenerationResult(label: string, changed: boolean): void {\n  if (changed) {\n    console.log(`Generated ${label}`)\n  }\n}\n\nexport function createGeneratorResult(): GeneratorResult {\n  return {\n    filesWritten: [],\n    filesUnchanged: [],\n    errors: [],\n  }\n}\n\nexport function writeGeneratedFile(options: {\n  outFile: string\n  checksumFile: string\n  content: string\n  structureChecksum: string\n  result: GeneratorResult\n  quiet?: boolean\n}): void {\n  const { outFile, checksumFile, content, structureChecksum, result, quiet } = options\n  const checksum = { content: calculateChecksum(content), structure: structureChecksum }\n  const existing = readChecksumRecord(checksumFile)\n  const shouldWrite =\n    !fs.existsSync(outFile) ||\n    !existing ||\n    existing.content !== checksum.content ||\n    existing.structure !== checksum.structure\n  if (shouldWrite) {\n    fs.mkdirSync(path.dirname(outFile), { recursive: true })\n    fs.writeFileSync(outFile, content)\n    writeChecksumRecord(checksumFile, checksum)\n    result.filesWritten.push(outFile)\n  } else {\n    result.filesUnchanged.push(outFile)\n  }\n  if (!quiet) logGenerationResult(path.relative(process.cwd(), outFile), shouldWrite)\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/cli",
-  "version": "0.6.6-develop.6361.1.e790d2aa34",
+  "version": "0.6.6-develop.6363.1.03c5e3429a",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -60,8 +60,8 @@
     "@mikro-orm/decorators": "^7.1.4",
     "@mikro-orm/migrations": "^7.1.4",
     "@mikro-orm/postgresql": "^7.1.4",
-    "@open-mercato/queue": "0.6.6-develop.6361.1.e790d2aa34",
-    "@open-mercato/shared": "0.6.6-develop.6361.1.e790d2aa34",
+    "@open-mercato/queue": "0.6.6-develop.6363.1.03c5e3429a",
+    "@open-mercato/shared": "0.6.6-develop.6363.1.03c5e3429a",
     "cross-spawn": "^7.0.6",
     "pg": "8.22.0",
     "semver": "^7.8.5",
@@ -71,10 +71,10 @@
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "@open-mercato/shared": "0.6.6-develop.6361.1.e790d2aa34"
+    "@open-mercato/shared": "0.6.6-develop.6363.1.03c5e3429a"
   },
   "devDependencies": {
-    "@open-mercato/shared": "0.6.6-develop.6361.1.e790d2aa34",
+    "@open-mercato/shared": "0.6.6-develop.6363.1.03c5e3429a",
     "@types/jest": "^30.0.0",
     "jest": "^30.4.2",
     "ts-jest": "^29.4.11"

package/src/lib/generators/__tests__/module-subset.test.ts

@@ -214,7 +214,7 @@ describe('generateModuleRegistry with module subsets', () => {
     `))
     expect(readGenerated(tmpDir, 'frontend-routes.generated.ts')).toBe(dedent(`
       // AUTO-GENERATED by mercato generate registry
-      import type { FrontendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
+      import { resolvePageRouteMetadata, type FrontendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
 
       export const frontendRoutes: FrontendRouteManifestEntry[] = [
         
@@ -224,7 +224,7 @@ describe('generateModuleRegistry with module subsets', () => {
     `))
     expect(readGenerated(tmpDir, 'backend-routes.generated.ts')).toBe(dedent(`
       // AUTO-GENERATED by mercato generate registry
-      import type { BackendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
+      import { resolvePageRouteMetadata, type BackendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
 
       export const backendRoutes: BackendRouteManifestEntry[] = [
         
@@ -309,20 +309,20 @@ describe('generateModuleRegistry with module subsets', () => {
     `))
     expect(readGenerated(tmpDir, 'frontend-routes.generated.ts')).toBe(dedent(`
       // AUTO-GENERATED by mercato generate registry
-      import type { FrontendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
+      import { resolvePageRouteMetadata, type FrontendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
 
       export const frontendRoutes: FrontendRouteManifestEntry[] = [
-        { moduleId: "orders", pattern: "/", requireAuth: ((undefined as any))?.requireAuth, requireRoles: ((undefined as any))?.requireRoles, requireFeatures: ((undefined as any))?.requireFeatures, requireCustomerAuth: ((undefined as any))?.requireCustomerAuth, requireCustomerFeatures: ((undefined as any))?.requireCustomerFeatures, nav: ((undefined as any))?.nav, title: ((undefined as any))?.pageTitle ?? ((undefined as any))?.title, titleKey: ((undefined as any))?.pageTitleKey ?? ((undefined as any))?.titleKey, group: ((undefined as any))?.pageGroup ?? ((undefined as any))?.group, groupKey: ((undefined as any))?.pageGroupKey ?? ((undefined as any))?.groupKey, icon: ((undefined as any))?.icon, order: ((undefined as any))?.pageOrder ?? ((undefined as any))?.order, priority: ((undefined as any))?.pagePriority ?? ((undefined as any))?.priority, navHidden: ((undefined as any))?.navHidden, visible: ((undefined as any))?.visible, enabled: ((undefined as any))?.enabled, breadcrumb: ((undefined as any))?.breadcrumb, pageContext: ((undefined as any))?.pageContext, placement: ((undefined as any))?.placement, load: async () => { const mod = await import("@open-mercato/core/modules/orders/frontend/page"); return (mod.default ?? mod) as any } }
+        { moduleId: "orders", ...resolvePageRouteMetadata("/", (undefined as any)), load: async () => { const mod = await import("@open-mercato/core/modules/orders/frontend/page"); return (mod.default ?? mod) as any } }
       ]
 
       export default frontendRoutes
     `))
     expect(readGenerated(tmpDir, 'backend-routes.generated.ts')).toBe(dedent(`
       // AUTO-GENERATED by mercato generate registry
-      import type { BackendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
+      import { resolvePageRouteMetadata, type BackendRouteManifestEntry } from '@open-mercato/shared/modules/registry'
 
       export const backendRoutes: BackendRouteManifestEntry[] = [
-        { moduleId: "orders", pattern: "/backend/orders", requireAuth: ((undefined as any))?.requireAuth, requireRoles: ((undefined as any))?.requireRoles, requireFeatures: ((undefined as any))?.requireFeatures, requireCustomerAuth: ((undefined as any))?.requireCustomerAuth, requireCustomerFeatures: ((undefined as any))?.requireCustomerFeatures, nav: ((undefined as any))?.nav, title: ((undefined as any))?.pageTitle ?? ((undefined as any))?.title, titleKey: ((undefined as any))?.pageTitleKey ?? ((undefined as any))?.titleKey, group: ((undefined as any))?.pageGroup ?? ((undefined as any))?.group, groupKey: ((undefined as any))?.pageGroupKey ?? ((undefined as any))?.groupKey, icon: ((undefined as any))?.icon, order: ((undefined as any))?.pageOrder ?? ((undefined as any))?.order, priority: ((undefined as any))?.pagePriority ?? ((undefined as any))?.priority, navHidden: ((undefined as any))?.navHidden, visible: ((undefined as any))?.visible, enabled: ((undefined as any))?.enabled, breadcrumb: ((undefined as any))?.breadcrumb, pageContext: ((undefined as any))?.pageContext, placement: ((undefined as any))?.placement, load: async () => { const mod = await import("@open-mercato/core/modules/orders/backend/page"); return (mod.default ?? mod) as any } }
+        { moduleId: "orders", ...resolvePageRouteMetadata("/backend/orders", (undefined as any)), load: async () => { const mod = await import("@open-mercato/core/modules/orders/backend/page"); return (mod.default ?? mod) as any } }
       ]
 
       export default backendRoutes
@@ -463,14 +463,22 @@ describe('generateModuleRegistry with module subsets', () => {
     expect(output).toContain('subscriber_event_meta:on-created')
   })
 
-  it('keeps backend route metadata runtime-backed when icons are non-serializable', async () => {
+  it('keeps runtime metadata fallback for settings/profile route icons that are not serializable yet', async () => {
     touchFile(
-      path.join(tmpDir, 'packages', 'core', 'src', 'modules', 'iconic', 'backend', 'dashboard', 'page.tsx'),
+      path.join(tmpDir, 'packages', 'core', 'src', 'modules', 'iconic', 'backend', 'settings', 'page.tsx'),
       'export default function Page() { return null }\n',
     )
     touchFile(
-      path.join(tmpDir, 'packages', 'core', 'src', 'modules', 'iconic', 'backend', 'dashboard', 'page.meta.ts'),
-      "import React from 'react'\nconst icon = React.createElement('svg', null)\nexport const metadata = { requireAuth: true, pageTitle: 'Dashboard', icon }\n",
+      path.join(tmpDir, 'packages', 'core', 'src', 'modules', 'iconic', 'backend', 'settings', 'page.meta.ts'),
+      "import React from 'react'\nconst icon = React.createElement('svg', null)\nexport const metadata = { requireAuth: true, pageTitle: 'Settings', pageContext: 'settings', icon }\n",
+    )
+    touchFile(
+      path.join(tmpDir, 'packages', 'core', 'src', 'modules', 'iconic', 'backend', 'profile', 'page.tsx'),
+      'export default function Page() { return null }\n',
+    )
+    touchFile(
+      path.join(tmpDir, 'packages', 'core', 'src', 'modules', 'iconic', 'backend', 'profile', 'page.meta.ts'),
+      "import React from 'react'\nconst icon = React.createElement('svg', null)\nexport const metadata = { requireAuth: true, pageTitle: 'Profile', pageContext: 'profile', icon }\n",
     )
 
     const enabled: ModuleEntry[] = [
@@ -481,9 +489,12 @@ describe('generateModuleRegistry with module subsets', () => {
 
     expect(result.errors).toEqual([])
     const output = readGenerated(tmpDir, 'backend-routes.generated.ts')!
-    expect(output).toMatch(/import \* as .* from "@open-mercato\/core\/modules\/iconic\/backend\/dashboard\/page\.meta"/)
-    expect(output).not.toContain('"pageTitle":"Dashboard"')
-    expect(output).toContain('pattern: "/backend/dashboard"')
+    expect(output).toMatch(/import \* as .* from "@open-mercato\/core\/modules\/iconic\/backend\/settings\/page\.meta"/)
+    expect(output).toMatch(/import \* as .* from "@open-mercato\/core\/modules\/iconic\/backend\/profile\/page\.meta"/)
+    expect(output).toContain('resolvePageRouteMetadata("/backend/settings", (((BMManifest')
+    expect(output).toContain('resolvePageRouteMetadata("/backend/profile", (((BMManifest')
+    expect(output).not.toContain('"pageContext":"settings"')
+    expect(output).not.toContain('"pageContext":"profile"')
   })
 
   it('handles module with only widgets — no pages or subscribers', async () => {
@@ -1447,6 +1458,10 @@ describe('generateModuleRegistryApp with module subsets', () => {
     const output = readGenerated(tmpDir, 'modules.app.generated.ts')
     expect(output).not.toBeNull()
     expect(output).toContain('export const modules: Module[] = [')
+
+    const bootstrapOutput = readGenerated(tmpDir, 'modules.bootstrap.generated.ts')
+    expect(bootstrapOutput).not.toBeNull()
+    expect(bootstrapOutput).toContain('export const modules: Module[] = [')
   })
 
   it('app output excludes CLI commands and keeps lazy workers/subscribers', async () => {
@@ -1482,6 +1497,15 @@ describe('generateModuleRegistryApp with module subsets', () => {
     expect(output).toContain('createLazyModuleSubscriber')
     expect(output).toContain('createLazyModuleWorker')
     expect(output).toContain('dashboardWidgets:')
+
+    const bootstrapOutput = readGenerated(tmpDir, 'modules.bootstrap.generated.ts')!
+    expect(bootstrapOutput).toContain('id: "runtime_mod"')
+    expect(bootstrapOutput).not.toContain('cli:')
+    expect(bootstrapOutput).toContain('subscribers:')
+    expect(bootstrapOutput).toContain('workers:')
+    expect(bootstrapOutput).toContain('createLazyModuleSubscriber')
+    expect(bootstrapOutput).toContain('createLazyModuleWorker')
+    expect(bootstrapOutput).toContain('dashboardWidgets:')
   })
 })
 

package/src/lib/generators/__tests__/output-snapshots.test.ts

@@ -691,6 +691,7 @@ describe('generator output compatibility', () => {
     'message-types.generated.ts',
     'messages.client.generated.ts',
     'modules.generated.ts',
+    'modules.i18n.generated.ts',
     'modules.runtime.generated.ts',
     'notification-handlers.generated.ts',
     'notifications.client.generated.ts',
@@ -720,6 +721,7 @@ describe('generator output compatibility', () => {
       'entities.ids.generated.ts',
       'entity-fields-registry.ts',
       'modules.app.generated.ts',
+      'modules.bootstrap.generated.ts',
       'modules.cli.generated.ts',
       'enabled-module-ids.generated.ts',
     ]))

package/src/lib/generators/__tests__/structural-contracts.test.ts

@@ -572,7 +572,7 @@ describe('frontend-routes.generated.ts', () => {
 
   it('contains orders frontend route with correct pattern', () => {
     expect(content).toContain('moduleId: "orders"')
-    expect(content).toContain('pattern: "/"')
+    expect(content).toContain('resolvePageRouteMetadata("/",')
   })
 })
 
@@ -602,10 +602,15 @@ describe('backend-routes.generated.ts', () => {
   })
 
   it('each route entry has pattern, moduleId, and load function', () => {
-    expect(content).toContain('pattern:')
-    expect(content).toContain('requireAuth:')
+    expect(content).toContain('resolvePageRouteMetadata(')
     expect(content).toContain('load: async () =>')
   })
+
+  it('keeps backend page imports lazy in route entries', () => {
+    expect(content).toContain('@open-mercato/core/modules/orders/backend')
+    expect(content).toContain('load: async () =>')
+    expect(content).toContain('import("@open-mercato/core/modules/orders/backend')
+  })
 })
 
 describe('api-routes.generated.ts', () => {
@@ -632,6 +637,11 @@ describe('api-routes.generated.ts', () => {
     expect(content).toContain('path: "/products"')
     expect(content).toMatch(/methods:.*GET.*POST.*PUT.*DELETE/)
   })
+
+  it('keeps API handler imports lazy in route entries', () => {
+    expect(content).toContain('@open-mercato/core/modules/orders/api')
+    expect(content).toContain('load: async () => import(')
+  })
 })
 
 // ---------------------------------------------------------------------------
@@ -1241,14 +1251,39 @@ describe('modules.app.generated.ts', () => {
   })
 })
 
+describe('modules.bootstrap.generated.ts', () => {
+  it('exports a bootstrap-only module manifest without route components', async () => {
+    const enabled = scaffoldFixture()
+    const resolver = createMockResolver(enabled)
+    await generateModuleRegistryApp({ resolver, quiet: true })
+    const content = readGenerated('modules.bootstrap.generated.ts')
+
+    expect(content).toContain('export const modules: Module[] = [')
+    expect(content).toContain('export default modules')
+    expect(content).toContain('id: "orders"')
+    expect(content).toContain('subscribers:')
+    expect(content).toContain('orders.order.created')
+    expect(content).toContain('setup:')
+    expect(content).toContain('features:')
+
+    expect(content).not.toContain('frontendRoutes:')
+    expect(content).not.toContain('backendRoutes:')
+    expect(content).not.toContain('createElement')
+    expect(content).not.toContain('/page.meta')
+    expect(content).not.toContain('/frontend/')
+    expect(content).not.toContain('/backend/')
+    expect(content).not.toContain('cli:')
+  })
+})
+
 describe('bootstrap-modules.generated.ts', () => {
-  it('exports legacy bootstrapModules alias from modules.app.generated.ts', async () => {
+  it('exports legacy bootstrapModules alias from modules.bootstrap.generated.ts', async () => {
     const enabled = scaffoldFixture()
     const resolver = createMockResolver(enabled)
     await generateModuleRegistryApp({ resolver, quiet: true })
     const content = readGenerated('bootstrap-modules.generated.ts')
 
-    expect(content).toContain('modules.app.generated')
+    expect(content).toContain('modules.bootstrap.generated')
     expect(content).toContain('export const bootstrapModules: Module[] = modules')
   })
 })

package/src/lib/generators/module-registry.ts

@@ -1377,6 +1377,10 @@ function buildPageRouteProps(metaExpr: string, routePath: string): string {
   return `pattern: ${toLiteral(routePath || '/')}, requireAuth: (${metaExpr})?.requireAuth, requireRoles: (${metaExpr})?.requireRoles, requireFeatures: (${metaExpr})?.requireFeatures, requireCustomerAuth: (${metaExpr})?.requireCustomerAuth, requireCustomerFeatures: (${metaExpr})?.requireCustomerFeatures, nav: (${metaExpr})?.nav, title: (${metaExpr})?.pageTitle ?? (${metaExpr})?.title, titleKey: (${metaExpr})?.pageTitleKey ?? (${metaExpr})?.titleKey, group: (${metaExpr})?.pageGroup ?? (${metaExpr})?.group, groupKey: (${metaExpr})?.pageGroupKey ?? (${metaExpr})?.groupKey, icon: (${metaExpr})?.icon, order: (${metaExpr})?.pageOrder ?? (${metaExpr})?.order, priority: (${metaExpr})?.pagePriority ?? (${metaExpr})?.priority, navHidden: (${metaExpr})?.navHidden, visible: (${metaExpr})?.visible, enabled: (${metaExpr})?.enabled, breadcrumb: (${metaExpr})?.breadcrumb, pageContext: (${metaExpr})?.pageContext, placement: (${metaExpr})?.placement`
 }
 
+function buildPageRouteManifestSpread(metaExpr: string, routePath: string): string {
+  return `...resolvePageRouteMetadata(${toLiteral(routePath || '/')}, ${metaExpr})`
+}
+
 function normalizeBreadcrumb(raw: unknown): SerializablePageMetadata['breadcrumb'] {
   if (!Array.isArray(raw)) return undefined
   const breadcrumb = raw
@@ -1583,7 +1587,7 @@ async function processPageFiles(options: {
         sourceFile: metaPath,
         metaPath,
         runtimeExpr: `(((${manifestMetaImportName} as any).metadata) as any)`,
-        allowRuntimeFallback: type === 'backend',
+        allowRuntimeFallback: true,
       })
       manifestMetaExpr = manifestMetadata.manifestExpr
       if (manifestMetadata.requiresRuntimeImport) {
@@ -1601,7 +1605,7 @@ async function processPageFiles(options: {
       const manifestMetadata = await loadPageMetadataForManifest({
         sourceFile,
         runtimeExpr: `(((${manifestMetaImportName} as any).metadata) as any)`,
-        allowRuntimeFallback: type === 'backend',
+        allowRuntimeFallback: true,
       })
       manifestMetaExpr = manifestMetadata.manifestExpr
       if (manifestMetadata.requiresRuntimeImport) {
@@ -1614,7 +1618,7 @@ async function processPageFiles(options: {
     }
     const baseProps = buildPageRouteProps(metaExpr, routePath)
     const runtimeBaseProps = buildPageRouteProps(runtimeMetaExpr, routePath)
-    const manifestBaseProps = buildPageRouteProps(manifestMetaExpr, routePath)
+    const manifestBaseProps = buildPageRouteManifestSpread(manifestMetaExpr, routePath)
     eagerRoutes.push(`{ ${baseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
     runtimeRoutes.push(`{ ${runtimeBaseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
     manifestRoutes.push(`{ moduleId: ${toLiteral(modId)}, ${manifestBaseProps}, load: async () => { const mod = await ${buildDynamicImportExpression(importPath)}; return (mod.default ?? mod) as any } }`)
@@ -1661,7 +1665,7 @@ async function processPageFiles(options: {
         sourceFile: metaPath,
         metaPath,
         runtimeExpr: `(((${manifestMetaImportName} as any).metadata) as any)`,
-        allowRuntimeFallback: type === 'backend',
+        allowRuntimeFallback: false,
       })
       manifestMetaExpr = manifestMetadata.manifestExpr
       if (manifestMetadata.requiresRuntimeImport) {
@@ -1679,7 +1683,7 @@ async function processPageFiles(options: {
       const manifestMetadata = await loadPageMetadataForManifest({
         sourceFile,
         runtimeExpr: `(((${manifestMetaImportName} as any).metadata) as any)`,
-        allowRuntimeFallback: type === 'backend',
+        allowRuntimeFallback: false,
       })
       manifestMetaExpr = manifestMetadata.manifestExpr
       if (manifestMetadata.requiresRuntimeImport) {
@@ -1692,7 +1696,7 @@ async function processPageFiles(options: {
     }
     const baseProps = buildPageRouteProps(metaExpr, routePath)
     const runtimeBaseProps = buildPageRouteProps(runtimeMetaExpr, routePath)
-    const manifestBaseProps = buildPageRouteProps(manifestMetaExpr, routePath)
+    const manifestBaseProps = buildPageRouteManifestSpread(manifestMetaExpr, routePath)
     eagerRoutes.push(`{ ${baseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
     runtimeRoutes.push(`{ ${runtimeBaseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
     manifestRoutes.push(`{ moduleId: ${toLiteral(modId)}, ${manifestBaseProps}, load: async () => { const mod = await ${buildDynamicImportExpression(importPath)}; return (mod.default ?? mod) as any } }`)
@@ -2291,8 +2295,12 @@ function renderAstLegacyManifestOutput(options: {
   imports?: GeneratedImportStatement[]
   entries: string[]
 }): string {
+  const usesPageRouteMetadataHelper = options.typeName === 'FrontendRouteManifestEntry'
+    || options.typeName === 'BackendRouteManifestEntry'
   const importSection = [
-    `import type { ${options.typeName} } from '@open-mercato/shared/modules/registry'`,
+    usesPageRouteMetadataHelper
+      ? `import { resolvePageRouteMetadata, type ${options.typeName} } from '@open-mercato/shared/modules/registry'`
+      : `import type { ${options.typeName} } from '@open-mercato/shared/modules/registry'`,
     ...(options.imports ?? []).map((entry) => serializeGeneratedImport(entry)),
   ].join('\n')
 
@@ -2631,8 +2639,9 @@ function processTranslationsAst(options: {
   appImportBase: string
   pkgImportBase: string
   imports: string[]
+  extraImports?: string[]
 }): GeneratedObjectEntry[] {
-  const { roots, modId, appImportBase, pkgImportBase, imports } = options
+  const { roots, modId, appImportBase, pkgImportBase, imports, extraImports } = options
   const i18nApp = path.join(roots.appBase, 'i18n')
   const pkgI18nBase = resolveStandaloneSourceMirrorBase(roots.pkgBase) ?? roots.pkgBase
   const i18nCore = path.join(pkgI18nBase, 'i18n')
@@ -2665,6 +2674,8 @@ function processTranslationsAst(options: {
       const appName = `T_${toVar(modId)}_${toVar(locale)}_A`
       imports.push(buildImportStatement(coreName, `${pkgImportBase}/i18n/${locale}.json`))
       imports.push(buildImportStatement(appName, `${appImportBase}/i18n/${locale}.json`))
+      extraImports?.push(buildImportStatement(coreName, `${pkgImportBase}/i18n/${locale}.json`))
+      extraImports?.push(buildImportStatement(appName, `${appImportBase}/i18n/${locale}.json`))
       translations.push({
         name: JSON.stringify(locale),
         value: objectLiteral([
@@ -2678,6 +2689,7 @@ function processTranslationsAst(options: {
     if (appHas) {
       const appName = `T_${toVar(modId)}_${toVar(locale)}_A`
       imports.push(buildImportStatement(appName, `${appImportBase}/i18n/${locale}.json`))
+      extraImports?.push(buildImportStatement(appName, `${appImportBase}/i18n/${locale}.json`))
       translations.push({
         name: JSON.stringify(locale),
         value: asExpression(identifier(appName), 'unknown as Record<string, string>'),
@@ -2688,6 +2700,7 @@ function processTranslationsAst(options: {
     if (coreHas) {
       const coreName = `T_${toVar(modId)}_${toVar(locale)}_C`
       imports.push(buildImportStatement(coreName, `${pkgImportBase}/i18n/${locale}.json`))
+      extraImports?.push(buildImportStatement(coreName, `${pkgImportBase}/i18n/${locale}.json`))
       translations.push({
         name: JSON.stringify(locale),
         value: asExpression(identifier(coreName), 'unknown as Record<string, string>'),
@@ -3367,6 +3380,10 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
   const outputDir = resolver.getOutputDir()
   const outFile = path.join(outputDir, 'modules.app.generated.ts')
   const checksumFile = path.join(outputDir, 'modules.app.generated.checksum')
+  const bootstrapOutFile = path.join(outputDir, 'modules.bootstrap.generated.ts')
+  const bootstrapChecksumFile = path.join(outputDir, 'modules.bootstrap.generated.checksum')
+  const i18nOutFile = path.join(outputDir, 'modules.i18n.generated.ts')
+  const i18nChecksumFile = path.join(outputDir, 'modules.i18n.generated.checksum')
   const legacyOutFile = path.join(outputDir, 'bootstrap-modules.generated.ts')
   const legacyChecksumFile = path.join(outputDir, 'bootstrap-modules.generated.checksum')
   const enabledIdsOutFile = path.join(outputDir, 'enabled-module-ids.generated.ts')
@@ -3379,7 +3396,11 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
     verifyThirdPartyModuleShape(entry, resolver.getModulePaths(entry).pkgBase)
   }
   const imports: string[] = []
+  const bootstrapImports: string[] = []
+  const i18nImports: string[] = []
   const moduleDecls: WriterFunction[] = []
+  const bootstrapModuleDecls: WriterFunction[] = []
+  const i18nModuleDecls: WriterFunction[] = []
   const importIdRef = { value: 0 }
   const trackedRoots = new Set<string>()
   const requiresByModule = new Map<string, string[]>()
@@ -3418,6 +3439,7 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
       infoImportName = `I${importIdRef.value++}_${toVar(modId)}`
       const importPath = sanitizeGeneratedModuleSpecifier(indexResolved.importPath)
       imports.push(buildImportStatement(`* as ${infoImportName}`, importPath))
+      bootstrapImports.push(buildImportStatement(`* as ${infoImportName}`, importPath))
       try {
         // eslint-disable-next-line @typescript-eslint/no-var-requires
         const mod = require(indexResolved.absolutePath)
@@ -3429,11 +3451,13 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
 
     {
       const setup = resolveConventionFile(roots, imps, 'setup.ts', 'SETUP', modId, importIdRef, imports)
+      if (setup) bootstrapImports.push(buildImportStatement(`* as ${setup.importName}`, setup.importPath))
       if (setup) setupImportName = setup.importName
     }
 
     {
       const encryption = resolveConventionFile(roots, imps, 'encryption.ts', 'ENCRYPTION', modId, importIdRef, imports)
+      if (encryption) bootstrapImports.push(buildImportStatement(`* as ${encryption.importName}`, encryption.importPath))
       if (encryption) encryptionImportName = encryption.importName
     }
 
@@ -3442,12 +3466,13 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
       if (resolved) {
         const importName = `INTEGRATION_${toVar(modId)}_${importIdRef.value++}`
         imports.push(buildImportStatement(`* as ${importName}`, resolved.importPath))
+        bootstrapImports.push(buildImportStatement(`* as ${importName}`, resolved.importPath))
         integrationImportName = importName
       }
     }
 
     {
-      const ext = resolveConventionFile(roots, imps, 'data/extensions.ts', 'X', modId, importIdRef, imports)
+      const ext = resolveConventionFile(roots, imps, 'data/extensions.ts', 'X', modId, importIdRef, imports, bootstrapImports)
       if (ext) extensionsImportName = ext.importName
     }
 
@@ -3457,17 +3482,18 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
         const importName = `ACL_${toVar(modId)}_${importIdRef.value++}`
         const importPath = sanitizeGeneratedModuleSpecifier(aclResolved.importPath)
         imports.push(buildImportStatement(`* as ${importName}`, importPath))
+        bootstrapImports.push(buildImportStatement(`* as ${importName}`, importPath))
         featuresImportName = importName
       }
     }
 
     {
-      const ce = resolveConventionFile(roots, imps, 'ce.ts', 'CE', modId, importIdRef, imports)
+      const ce = resolveConventionFile(roots, imps, 'ce.ts', 'CE', modId, importIdRef, imports, bootstrapImports)
       if (ce) customEntitiesImportName = ce.importName
     }
 
     {
-      const fields = resolveConventionFile(roots, imps, 'data/fields.ts', 'F', modId, importIdRef, imports)
+      const fields = resolveConventionFile(roots, imps, 'data/fields.ts', 'F', modId, importIdRef, imports, bootstrapImports)
       if (fields) fieldsImportName = fields.importName
     }
 
@@ -3511,13 +3537,17 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
       }
     }
 
+    const translationImports: string[] = []
     translations.push(...processTranslationsAst({
       roots,
       modId,
       appImportBase,
       pkgImportBase: imps.pkgBase,
       imports,
+      extraImports: translationImports,
     }))
+    bootstrapImports.push(...translationImports)
+    i18nImports.push(...translationImports)
 
     subscribers.push(...await processSubscribersAst({
       roots,
@@ -3547,18 +3577,16 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
       { name: 'id', value: modId },
       { name: 'customFieldSets', value: buildModuleCustomFieldSetsValue({ fieldsImportName, customEntitiesImportName, moduleId: modId }) },
     ]
+    const i18nModuleEntries: GeneratedObjectEntry[] = [
+      { name: 'id', value: modId },
+    ]
 
     if (infoImportName) {
       moduleEntries.push({ name: 'info', value: propertyAccess(identifier(infoImportName), 'metadata') })
     }
-    if (frontendRoutes.length > 0) {
-      moduleEntries.push({ name: 'frontendRoutes', value: arrayLiteral(frontendRoutes, writeValue) })
-    }
-    if (backendRoutes.length > 0) {
-      moduleEntries.push({ name: 'backendRoutes', value: arrayLiteral(backendRoutes, writeValue) })
-    }
     if (translations.length > 0) {
       moduleEntries.push({ name: 'translations', value: objectLiteral(translations) })
+      i18nModuleEntries.push({ name: 'translations', value: objectLiteral(translations) })
     }
     if (subscribers.length > 0) {
       moduleEntries.push({ name: 'subscribers', value: arrayLiteral(subscribers, writeValue) })
@@ -3642,7 +3670,17 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
       })
     }
 
-    moduleDecls.push(objectLiteral(moduleEntries))
+    const routeAwareModuleEntries = [...moduleEntries]
+    if (frontendRoutes.length > 0) {
+      routeAwareModuleEntries.push({ name: 'frontendRoutes', value: arrayLiteral(frontendRoutes, writeValue) })
+    }
+    if (backendRoutes.length > 0) {
+      routeAwareModuleEntries.push({ name: 'backendRoutes', value: arrayLiteral(backendRoutes, writeValue) })
+    }
+
+    moduleDecls.push(objectLiteral(routeAwareModuleEntries))
+    bootstrapModuleDecls.push(objectLiteral(moduleEntries))
+    i18nModuleDecls.push(objectLiteral(i18nModuleEntries))
   }
 
   const output = renderAstModuleRegistryFile({
@@ -3652,11 +3690,23 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
     moduleEntries: moduleDecls,
     includeCreateElementImport: hasRouteComponents,
   })
+  const bootstrapOutput = renderAstModuleRegistryFile({
+    fileName: 'modules.bootstrap.generated.ts',
+    generator: 'registry (bootstrap version)',
+    imports: bootstrapImports,
+    moduleEntries: bootstrapModuleDecls,
+  })
+  const i18nOutput = renderAstModuleRegistryFile({
+    fileName: 'modules.i18n.generated.ts',
+    generator: 'registry (i18n version)',
+    imports: i18nImports,
+    moduleEntries: i18nModuleDecls,
+  })
   const legacyOutput = renderAstLegacyAliasFile({
     fileName: 'bootstrap-modules.generated.ts',
     exportName: 'bootstrapModules',
     exportType: 'Module[]',
-    sourceFileName: 'modules.app.generated.ts',
+    sourceFileName: 'modules.bootstrap.generated.ts',
     initializer: identifier('modules'),
   })
 
@@ -3684,6 +3734,8 @@ export async function generateModuleRegistryApp(options: ModuleRegistryOptions):
 
   const structureChecksum = calculateStructureChecksum(Array.from(trackedRoots))
   writeGeneratedFile({ outFile, checksumFile, content: output, structureChecksum, result, quiet })
+  writeGeneratedFile({ outFile: bootstrapOutFile, checksumFile: bootstrapChecksumFile, content: bootstrapOutput, structureChecksum, result, quiet })
+  writeGeneratedFile({ outFile: i18nOutFile, checksumFile: i18nChecksumFile, content: i18nOutput, structureChecksum, result, quiet })
   writeGeneratedFile({ outFile: legacyOutFile, checksumFile: legacyChecksumFile, content: legacyOutput, structureChecksum, result, quiet })
 
   const enabledIdsOutput = renderEnabledModuleIdsFile(enabled.map((entry) => entry.id))

package/src/lib/utils.ts

@@ -235,6 +235,7 @@ export function writeGeneratedFile(options: {
   const checksum = { content: calculateChecksum(content), structure: structureChecksum }
   const existing = readChecksumRecord(checksumFile)
   const shouldWrite =
+    !fs.existsSync(outFile) ||
     !existing ||
     existing.content !== checksum.content ||
     existing.structure !== checksum.structure