@open-mercato/cli 0.6.8-develop.7032.1.70d74d4bfe → 0.6.8-develop.7037.1.ea0277b01e

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

@@ -32,6 +32,7 @@ import {
   conditionalExpression,
   createGeneratedSourceFile,
   elementAccess,
+  escapeGeneratedJsonLiteral,
   returnStatement,
   getSourceText,
   identifier,
@@ -44,6 +45,7 @@ import {
   optionalPropertyAccess,
   parenthesized,
   propertyAccess,
+  renderGeneratedValue,
   spreadExpression,
   type GeneratedObjectEntry,
   variableStatement,
@@ -133,7 +135,7 @@ type DashboardWidgetEntry = {
   importPath: string
 }
 
-type CommandLoaderGenerationEntry = {
+export type CommandLoaderGenerationEntry = {
   moduleId: string
   key: string
   importPath: string
@@ -159,7 +161,7 @@ type RuntimeApiMethodMetadata = {
 type PageRouteGenerationResult = {
   eagerRoutes: string[]
   runtimeRoutes: string[]
-  manifestRoutes: string[]
+  manifestRoutes: WriterFunction[]
   manifestShardRoutes: RouteManifestShardEntry[]
   metadataRoutes: RouteManifestShardEntry[]
   routePatterns: string[]
@@ -190,7 +192,7 @@ function assertUniqueBackendRoutePattern(
 type ApiRouteGenerationResult = {
   eagerApis: string[]
   runtimeApis: string[]
-  manifestApis: string[]
+  manifestApis: WriterFunction[]
   manifestShardApis: RouteManifestShardEntry[]
   metadataApis: RouteManifestShardEntry[]
 }
@@ -1194,11 +1196,7 @@ function requiresRuntimePageMetadataFromSourceFile(sourceFile: string): boolean
 }
 
 function toLiteral(value: unknown): string {
-  return JSON.stringify(value)
-    .replace(/</g, '\\u003c')
-    .replace(/>/g, '\\u003e')
-    .replace(/\u2028/g, '\\u2028')
-    .replace(/\u2029/g, '\\u2029')
+  return escapeGeneratedJsonLiteral(JSON.stringify(value))
 }
 
 const GENERATED_MODULE_RELATIVE_PREFIXES = ['@/', '../../src/modules/', './'] as const
@@ -1440,32 +1438,81 @@ function collectCommandLoaderEntries(
   return entries
 }
 
-function renderCommandLoadersFile(entries: CommandLoaderGenerationEntry[]): string {
+export function renderCommandLoadersFile(entries: CommandLoaderGenerationEntry[]): string {
   const seenCommandIds = new Map<string, string>()
-  const rendered: string[] = []
+  const loaderEntries: WriterFunction[] = []
 
   for (const entry of entries) {
-    const loadExpr = `() => ${buildDynamicImportExpression(entry.importPath)}`
+    const loadValue = arrowFunction({
+      body: importExpression(sanitizeGeneratedModuleSpecifier(entry.importPath)),
+    })
     for (const id of entry.ids) {
       const previous = seenCommandIds.get(id)
       if (previous && previous !== entry.key) {
         throw new Error(`[generate] Duplicate command id "${id}" discovered in "${previous}" and "${entry.key}"`)
       }
       seenCommandIds.set(id, entry.key)
-      rendered.push(`  { moduleId: ${toLiteral(entry.moduleId)}, id: ${toLiteral(id)}, key: ${toLiteral(entry.key)}, load: ${loadExpr} },`)
+      loaderEntries.push(objectLiteral([
+        { name: 'moduleId', value: entry.moduleId },
+        { name: 'id', value: id },
+        { name: 'key', value: entry.key },
+        { name: 'load', value: loadValue },
+      ]))
     }
-    rendered.push(`  { moduleId: ${toLiteral(entry.moduleId)}, key: ${toLiteral(entry.key)}, load: ${loadExpr} },`)
+    loaderEntries.push(objectLiteral([
+      { name: 'moduleId', value: entry.moduleId },
+      { name: 'key', value: entry.key },
+      { name: 'load', value: loadValue },
+    ]))
   }
 
-  return `// AUTO-GENERATED by mercato generate command-loaders
-import type { CommandLoader } from '@open-mercato/shared/lib/commands'
+  const sourceFile = createGeneratedSourceFile('command-loaders.generated.ts')
+  addAutoGeneratedComment(sourceFile, 'command-loaders')
+
+  addImportSpec(sourceFile, {
+    moduleSpecifier: '@open-mercato/shared/lib/commands',
+    isTypeOnly: true,
+    namedImports: [{ name: 'CommandLoader' }],
+  })
+
+  sourceFile.addVariableStatement({
+    declarationKind: VariableDeclarationKind.Const,
+    isExported: true,
+    declarations: [
+      {
+        name: 'commandLoaderEntries',
+        type: 'CommandLoader[]',
+        initializer: arrayLiteral(loaderEntries, writeValue),
+      },
+    ],
+  })
+  sourceFile.addExportAssignment({
+    isExportEquals: false,
+    expression: 'commandLoaderEntries',
+  })
+
+  return getSourceText(sourceFile)
+}
 
-export const commandLoaderEntries: CommandLoader[] = [
-${rendered.join('\n')}
-]
+export function renderBootstrapRegistrationsFile(options: {
+  entryImports: string[]
+  registrationImports: string[]
+  calls: string[]
+}): string {
+  const uniqueImports = [...new Set([...options.entryImports, ...options.registrationImports])]
 
-export default commandLoaderEntries
-`
+  const sourceFile = createGeneratedSourceFile('bootstrap-registrations.generated.ts')
+  addAutoGeneratedComment(sourceFile, 'registry')
+  addImportStatements(sourceFile, uniqueImports)
+
+  sourceFile.addFunction({
+    name: 'runBootstrapRegistrations',
+    isExported: true,
+    returnType: 'void',
+    statements: options.calls,
+  })
+
+  return getSourceText(sourceFile)
 }
 
 function serializeGeneratedImport(statement: GeneratedImportStatement): string {
@@ -1721,8 +1768,38 @@ 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 buildPageRouteManifestSpread(metaExpr: string, routePath: string): WriterFunction {
+  return callExpression(identifier('resolvePageRouteMetadata'), [routePath || '/', identifier(metaExpr)])
+}
+
+function buildManifestRouteLoader(importPath: string): WriterFunction {
+  return arrowFunction({
+    async: true,
+    body: block((writer) => {
+      writeStatements(writer, [
+        variableStatement({
+          name: 'mod',
+          initializer: awaitExpression(importExpression(sanitizeGeneratedModuleSpecifier(importPath))),
+        }),
+        returnStatement(
+          asExpression(
+            parenthesized(nullishCoalesce([
+              propertyAccess(identifier('mod'), 'default'),
+              identifier('mod'),
+            ])),
+            'any',
+          ),
+        ),
+      ])
+    }),
+  })
+}
+
+function buildManifestApiLoader(importPath: string): WriterFunction {
+  return arrowFunction({
+    async: true,
+    body: importExpression(sanitizeGeneratedModuleSpecifier(importPath)),
+  })
 }
 
 function normalizeBreadcrumb(raw: unknown): SerializablePageMetadata['breadcrumb'] {
@@ -2041,7 +2118,7 @@ async function processPageFiles(options: {
   const metaPrefix = type === 'frontend' ? 'M' : 'BM'
   const eagerRoutes: string[] = []
   const runtimeRoutes: string[] = []
-  const manifestRoutes: string[] = []
+  const manifestRoutes: WriterFunction[] = []
   const manifestShardRoutes: RouteManifestShardEntry[] = []
   const metadataRoutes: RouteManifestShardEntry[] = []
   const routePatterns: string[] = []
@@ -2116,18 +2193,25 @@ async function processPageFiles(options: {
     const manifestBaseProps = buildPageRouteManifestSpread(manifestMetaExpr, routePath)
     eagerRoutes.push(`{ ${baseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
     runtimeRoutes.push(`{ ${runtimeBaseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
-    const metadataDeclaration = `{ moduleId: ${toLiteral(modId)}, ${manifestBaseProps} }`
-    const manifestDeclaration = `{ moduleId: ${toLiteral(modId)}, ${manifestBaseProps}, load: async () => { const mod = await ${buildDynamicImportExpression(importPath)}; return (mod.default ?? mod) as any } }`
-    manifestRoutes.push(manifestDeclaration)
+    const metadataEntries: GeneratedObjectEntry[] = [
+      { name: 'moduleId', value: modId },
+      { kind: 'spread', value: manifestBaseProps },
+    ]
+    const manifestEntry = objectLiteral([
+      ...metadataEntries,
+      { name: 'load', value: buildManifestRouteLoader(importPath) },
+    ])
+    const shardImports = manifestImportStatement ? [manifestImportStatement] : []
+    manifestRoutes.push(manifestEntry)
     manifestShardRoutes.push({
       path: routePath,
-      declaration: manifestDeclaration,
-      imports: manifestImportStatement ? [manifestImportStatement] : [],
+      declaration: renderGeneratedValue(manifestEntry),
+      imports: shardImports,
     })
     metadataRoutes.push({
       path: routePath,
-      declaration: metadataDeclaration,
-      imports: manifestImportStatement ? [manifestImportStatement] : [],
+      declaration: renderGeneratedValue(objectLiteral(metadataEntries)),
+      imports: shardImports,
     })
     routePatterns.push(routePath)
   }
@@ -2207,18 +2291,25 @@ async function processPageFiles(options: {
     const manifestBaseProps = buildPageRouteManifestSpread(manifestMetaExpr, routePath)
     eagerRoutes.push(`{ ${baseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
     runtimeRoutes.push(`{ ${runtimeBaseProps}, Component: ${buildLazyRouteComponentExpression(importPath)} }`)
-    const metadataDeclaration = `{ moduleId: ${toLiteral(modId)}, ${manifestBaseProps} }`
-    const manifestDeclaration = `{ moduleId: ${toLiteral(modId)}, ${manifestBaseProps}, load: async () => { const mod = await ${buildDynamicImportExpression(importPath)}; return (mod.default ?? mod) as any } }`
-    manifestRoutes.push(manifestDeclaration)
+    const metadataEntries: GeneratedObjectEntry[] = [
+      { name: 'moduleId', value: modId },
+      { kind: 'spread', value: manifestBaseProps },
+    ]
+    const manifestEntry = objectLiteral([
+      ...metadataEntries,
+      { name: 'load', value: buildManifestRouteLoader(importPath) },
+    ])
+    const shardImports = manifestImportStatement ? [manifestImportStatement] : []
+    manifestRoutes.push(manifestEntry)
     manifestShardRoutes.push({
       path: routePath,
-      declaration: manifestDeclaration,
-      imports: manifestImportStatement ? [manifestImportStatement] : [],
+      declaration: renderGeneratedValue(manifestEntry),
+      imports: shardImports,
     })
     metadataRoutes.push({
       path: routePath,
-      declaration: metadataDeclaration,
-      imports: manifestImportStatement ? [manifestImportStatement] : [],
+      declaration: renderGeneratedValue(objectLiteral(metadataEntries)),
+      imports: shardImports,
     })
     routePatterns.push(routePath)
   }
@@ -2250,7 +2341,7 @@ async function processApiRoutes(options: {
 
   const eagerApis: string[] = []
   const runtimeApis: string[] = []
-  const manifestApis: string[] = []
+  const manifestApis: WriterFunction[] = []
   const manifestShardApis: RouteManifestShardEntry[] = []
   const metadataApis: RouteManifestShardEntry[] = []
 
@@ -2283,11 +2374,19 @@ async function processApiRoutes(options: {
     eagerImports.push(buildImportStatement(`* as ${importName}`, importPath))
     eagerApis.push(`{ path: ((${importName} as any).metadata?.path ?? ${toLiteral(routePath)}), metadata: (${importName} as any).metadata, handlers: ${importName} as any${docsPart} }`)
     runtimeApis.push(`{ path: ${toLiteral(resolvedPath)}, metadata: ${metadataLiteral}, handlers: { ${exportedMethods.map((method) => `${method}: async (req: Request, ctx?: any) => { const mod = await ${buildDynamicImportExpression(importPath)}; return (mod as any).${method}(req, ctx) }`).join(', ')} } }`)
-    const metadataDeclaration = `{ moduleId: ${toLiteral(modId)}, kind: ${toLiteral('route-file')}, path: ${toLiteral(resolvedPath)}, methods: [${exportedMethods.map((method) => toLiteral(method)).join(', ')}] }`
-    const manifestDeclaration = `{ moduleId: ${toLiteral(modId)}, kind: ${toLiteral('route-file')}, path: ${toLiteral(resolvedPath)}, methods: [${exportedMethods.map((method) => toLiteral(method)).join(', ')}], load: async () => ${buildDynamicImportExpression(importPath)} }`
-    manifestApis.push(manifestDeclaration)
-    manifestShardApis.push({ path: resolvedPath, declaration: manifestDeclaration })
-    metadataApis.push({ path: resolvedPath, declaration: metadataDeclaration })
+    const metadataEntries: GeneratedObjectEntry[] = [
+      { name: 'moduleId', value: modId },
+      { name: 'kind', value: 'route-file' },
+      { name: 'path', value: resolvedPath },
+      { name: 'methods', value: arrayLiteral(exportedMethods, writeValue) },
+    ]
+    const manifestEntry = objectLiteral([
+      ...metadataEntries,
+      { name: 'load', value: buildManifestApiLoader(importPath) },
+    ])
+    manifestApis.push(manifestEntry)
+    manifestShardApis.push({ path: resolvedPath, declaration: renderGeneratedValue(manifestEntry) })
+    metadataApis.push({ path: resolvedPath, declaration: renderGeneratedValue(objectLiteral(metadataEntries)) })
   }
 
   // Single files (plain scripts, not route.*, not tests, skip method dirs)
@@ -2319,11 +2418,19 @@ async function processApiRoutes(options: {
     eagerImports.push(buildImportStatement(`* as ${importName}`, importPath))
     eagerApis.push(`{ path: ((${importName} as any).metadata?.path ?? ${toLiteral(routePath)}), metadata: (${importName} as any).metadata, handlers: ${importName} as any${docsPart} }`)
     runtimeApis.push(`{ path: ${toLiteral(resolvedPath)}, metadata: ${metadataLiteral}, handlers: { ${exportedMethods.map((entryMethod) => `${entryMethod}: async (req: Request, ctx?: any) => { const mod = await ${buildDynamicImportExpression(importPath)}; return (mod as any).${entryMethod}(req, ctx) }`).join(', ')} } }`)
-    const metadataDeclaration = `{ moduleId: ${toLiteral(modId)}, kind: ${toLiteral('route-file')}, path: ${toLiteral(resolvedPath)}, methods: [${exportedMethods.map((entryMethod) => toLiteral(entryMethod)).join(', ')}] }`
-    const manifestDeclaration = `{ moduleId: ${toLiteral(modId)}, kind: ${toLiteral('route-file')}, path: ${toLiteral(resolvedPath)}, methods: [${exportedMethods.map((entryMethod) => toLiteral(entryMethod)).join(', ')}], load: async () => ${buildDynamicImportExpression(importPath)} }`
-    manifestApis.push(manifestDeclaration)
-    manifestShardApis.push({ path: resolvedPath, declaration: manifestDeclaration })
-    metadataApis.push({ path: resolvedPath, declaration: metadataDeclaration })
+    const metadataEntries: GeneratedObjectEntry[] = [
+      { name: 'moduleId', value: modId },
+      { name: 'kind', value: 'route-file' },
+      { name: 'path', value: resolvedPath },
+      { name: 'methods', value: arrayLiteral(exportedMethods, writeValue) },
+    ]
+    const manifestEntry = objectLiteral([
+      ...metadataEntries,
+      { name: 'load', value: buildManifestApiLoader(importPath) },
+    ])
+    manifestApis.push(manifestEntry)
+    manifestShardApis.push({ path: resolvedPath, declaration: renderGeneratedValue(manifestEntry) })
+    metadataApis.push({ path: resolvedPath, declaration: renderGeneratedValue(objectLiteral(metadataEntries)) })
   }
 
   // Legacy per-method
@@ -2365,11 +2472,20 @@ async function processApiRoutes(options: {
       eagerImports.push(buildImportStatement(`${importName}, * as ${metaName}`, importPath))
       eagerApis.push(`{ method: ${toLiteral(method)}, path: (${metaName}.metadata?.path ?? ${toLiteral(routePath)}), handler: ${importName}, metadata: ${metaName}.metadata${docsPart} }`)
       runtimeApis.push(`{ method: ${toLiteral(method)}, path: ${toLiteral(resolvedPath)}, handler: async (req: Request, ctx?: any) => { const mod = await ${buildDynamicImportExpression(importPath)}; const handler = ((mod as any).default ?? (mod as any).${method} ?? (mod as any).handler) as any; return handler(req, ctx) }, metadata: ${metadataLiteral} }`)
-      const metadataDeclaration = `{ moduleId: ${toLiteral(modId)}, kind: ${toLiteral('legacy')}, method: ${toLiteral(method)}, path: ${toLiteral(resolvedPath)}, methods: [${toLiteral(method)}] }`
-      const manifestDeclaration = `{ moduleId: ${toLiteral(modId)}, kind: ${toLiteral('legacy')}, method: ${toLiteral(method)}, path: ${toLiteral(resolvedPath)}, methods: [${toLiteral(method)}], load: async () => ${buildDynamicImportExpression(importPath)} }`
-      manifestApis.push(manifestDeclaration)
-      manifestShardApis.push({ path: resolvedPath, declaration: manifestDeclaration })
-      metadataApis.push({ path: resolvedPath, declaration: metadataDeclaration })
+      const metadataEntries: GeneratedObjectEntry[] = [
+        { name: 'moduleId', value: modId },
+        { name: 'kind', value: 'legacy' },
+        { name: 'method', value: method },
+        { name: 'path', value: resolvedPath },
+        { name: 'methods', value: arrayLiteral([method], writeValue) },
+      ]
+      const manifestEntry = objectLiteral([
+        ...metadataEntries,
+        { name: 'load', value: buildManifestApiLoader(importPath) },
+      ])
+      manifestApis.push(manifestEntry)
+      manifestShardApis.push({ path: resolvedPath, declaration: renderGeneratedValue(manifestEntry) })
+      metadataApis.push({ path: resolvedPath, declaration: renderGeneratedValue(objectLiteral(metadataEntries)) })
     }
   }
 
@@ -2382,17 +2498,6 @@ async function processApiRoutes(options: {
   }
 }
 
-function processSubscribers(discovered: DiscoveredSubscriber[]): string[] {
-  const subscribers: string[] = []
-  for (const { id, importPath, metadata } of discovered) {
-    const subscriberId = metadata?.id ?? id
-    subscribers.push(
-      `{ id: ${toLiteral(subscriberId)}, event: ${toLiteral(metadata?.event ?? '')}, persistent: ${metadata?.persistent === undefined ? 'undefined' : toLiteral(metadata.persistent)}, sync: ${metadata?.sync === undefined ? 'undefined' : toLiteral(metadata.sync)}, priority: ${metadata?.priority === undefined ? 'undefined' : toLiteral(metadata.priority)}, handler: createLazyModuleSubscriber(() => ${buildDynamicImportExpression(importPath)}, ${toLiteral(subscriberId)}) }`
-    )
-  }
-  return subscribers
-}
-
 /**
  * Registry helper emitted for a worker that declares `metadata.onJobAbandoned`.
  *
@@ -2406,53 +2511,6 @@ function workersDeclareAbandonHook(discovered: DiscoveredWorker[]): boolean {
   return discovered.some(({ metadata }) => metadata.hasJobAbandonedHook === true)
 }
 
-function processWorkers(discovered: DiscoveredWorker[]): string[] {
-  const workers: string[] = []
-  for (const { id, importPath, metadata } of discovered) {
-    const workerId = metadata.id ?? id
-    workers.push(
-      `{ id: ${toLiteral(workerId)}, queue: ${toLiteral(metadata.queue)}, concurrency: ${toLiteral(metadata.concurrency ?? 1)}${metadata.lockDuration === undefined ? '' : `, lockDuration: ${toLiteral(metadata.lockDuration)}`}${metadata.maxStalledCount === undefined ? '' : `, maxStalledCount: ${toLiteral(metadata.maxStalledCount)}`}${metadata.hasJobAbandonedHook ? `, onJobAbandoned: ${ABANDON_HOOK_FACTORY}(() => ${buildDynamicImportExpression(importPath)}, ${toLiteral(workerId)})` : ''}, handler: createLazyModuleWorker(() => ${buildDynamicImportExpression(importPath)}, ${toLiteral(workerId)}) }`
-    )
-  }
-  return workers
-}
-
-function processTranslations(options: {
-  discovered: DiscoveredTranslation[]
-  modId: string
-  appImportBase: string
-  pkgImportBase: string
-  imports: string[]
-  extraImports?: string[]
-}): string[] {
-  const { discovered, modId, appImportBase, pkgImportBase, imports, extraImports } = options
-  const translations: string[] = []
-  for (const { locale, coreHas, appHas } of discovered) {
-    if (coreHas && appHas) {
-      const cName = `T_${toVar(modId)}_${toVar(locale)}_C`
-      const aName = `T_${toVar(modId)}_${toVar(locale)}_A`
-      imports.push(buildImportStatement(cName, `${pkgImportBase}/i18n/${locale}.json`))
-      imports.push(buildImportStatement(aName, `${appImportBase}/i18n/${locale}.json`))
-      extraImports?.push(buildImportStatement(cName, `${pkgImportBase}/i18n/${locale}.json`))
-      extraImports?.push(buildImportStatement(aName, `${appImportBase}/i18n/${locale}.json`))
-      translations.push(
-        `'${locale}': { ...( ${cName} as unknown as Record<string,string> ), ...( ${aName} as unknown as Record<string,string> ) }`
-      )
-    } else if (appHas) {
-      const aName = `T_${toVar(modId)}_${toVar(locale)}_A`
-      imports.push(buildImportStatement(aName, `${appImportBase}/i18n/${locale}.json`))
-      extraImports?.push(buildImportStatement(aName, `${appImportBase}/i18n/${locale}.json`))
-      translations.push(`'${locale}': ${aName} as unknown as Record<string,string>`)
-    } else if (coreHas) {
-      const cName = `T_${toVar(modId)}_${toVar(locale)}_C`
-      imports.push(buildImportStatement(cName, `${pkgImportBase}/i18n/${locale}.json`))
-      extraImports?.push(buildImportStatement(cName, `${pkgImportBase}/i18n/${locale}.json`))
-      translations.push(`'${locale}': ${cName} as unknown as Record<string,string>`)
-    }
-  }
-  return translations
-}
-
 /**
  * Resolves a convention file and pushes its import + config entry to standalone arrays.
  * Used for files that produce their own generated output (notifications, AI tools, events, analytics, enrichers, etc.).
@@ -2597,6 +2655,64 @@ function buildModuleDashboardWidgetsValue(entries: DashboardWidgetEntry[]): Writ
   )
 }
 
+/**
+ * Wraps expressions that are still produced as pre-rendered strings by collaborators this
+ * change does not convert (page routes, api handlers, dashboard widgets) so they can sit
+ * inside an AST-built array without being re-quoted as string literals. It disappears once
+ * those producers emit writers themselves — see the follow-up noted in the spec's Non-Goals.
+ */
+function preRenderedExpressionList(expressions: readonly string[]): WriterFunction {
+  return arrayLiteral(expressions.map((expression) => identifier(expression)), writeValue)
+}
+
+/**
+ * `(X.<first> ?? X.<second>)` — the member-fallback shape the main registry path emits.
+ * It is deliberately not `namespaceFallback`, which the app path uses: that helper walks
+ * the members in an IIFE and treats only `!= null` as present, which is a different
+ * expression. Converging the two is a behaviour change, not a formatting one.
+ */
+function legacyNamespaceMemberFallback(importName: string, members: readonly [string, string]): WriterFunction {
+  return parenthesized(nullishCoalesce([
+    propertyAccess(identifier(importName), members[0]),
+    propertyAccess(identifier(importName), members[1]),
+  ]))
+}
+
+function buildLegacyModuleListValue(options: {
+  importName: string
+  members: readonly [string, string]
+  castType: string
+}): WriterFunction {
+  return logicalOr([
+    asExpression(legacyNamespaceMemberFallback(options.importName, options.members), options.castType),
+    emptyArray(),
+  ])
+}
+
+function buildLegacyModuleSetupValue(importName: string): WriterFunction {
+  return logicalOr([
+    legacyNamespaceMemberFallback(importName, ['default', 'setup']),
+    identifier('undefined'),
+  ])
+}
+
+function buildLegacyIntegrationListValue(
+  importName: string,
+  pluralMember: string,
+  singularMember: string,
+  castType: string,
+): WriterFunction {
+  const singular = propertyAccess(identifier(importName), singularMember)
+
+  return asExpression(
+    parenthesized(nullishCoalesce([
+      propertyAccess(identifier(importName), pluralMember),
+      parenthesized(conditionalExpression(singular, arrayLiteral([singular], writeValue), emptyArray())),
+    ])),
+    castType,
+  )
+}
+
 function buildModuleIntegrationListValue(
   importName: string,
   pluralMember: string,
@@ -2644,7 +2760,12 @@ function buildModulesInfoExpression(): WriterFunction {
 function renderAstModuleRegistryFile(options: {
   fileName: string
   generator: string
-  imports: string[]
+  /**
+   * Import statements, or the structured specs generator extensions push onto the shared
+   * import array via `processStandaloneConfig`. Both shapes reach this emitter at runtime,
+   * so both are normalised here rather than at each call site.
+   */
+  imports: GeneratedImportStatement[]
   moduleEntries: WriterFunction[]
   includeCreateElementImport?: boolean
   includeAbandonHookImport?: boolean
@@ -2667,7 +2788,7 @@ function renderAstModuleRegistryFile(options: {
       { name: 'Module', isTypeOnly: true },
     ],
   })
-  addImportStatements(sourceFile, options.imports)
+  addImportStatements(sourceFile, options.imports.map((entry) => serializeGeneratedImport(entry)))
 
   sourceFile.addVariableStatement({
     declarationKind: VariableDeclarationKind.Const,
@@ -2698,6 +2819,52 @@ function renderAstModuleRegistryFile(options: {
   return getSourceText(sourceFile)
 }
 
+function renderAstManifestFile(options: {
+  fileName: string
+  typeName: string
+  exportName: string
+  imports?: string[]
+  entries: WriterFunction[]
+}): string {
+  const sourceFile = createGeneratedSourceFile(options.fileName)
+  addAutoGeneratedComment(sourceFile, 'registry')
+
+  const usesPageRouteMetadataHelper = options.typeName === 'FrontendRouteManifestEntry'
+    || options.typeName === 'BackendRouteManifestEntry'
+  addImportSpec(sourceFile, usesPageRouteMetadataHelper
+    ? {
+      moduleSpecifier: '@open-mercato/shared/modules/registry',
+      namedImports: [
+        { name: 'resolvePageRouteMetadata' },
+        { name: options.typeName, isTypeOnly: true },
+      ],
+    }
+    : {
+      moduleSpecifier: '@open-mercato/shared/modules/registry',
+      isTypeOnly: true,
+      namedImports: [{ name: options.typeName }],
+    })
+  addImportStatements(sourceFile, options.imports ?? [])
+
+  sourceFile.addVariableStatement({
+    declarationKind: VariableDeclarationKind.Const,
+    isExported: true,
+    declarations: [
+      {
+        name: options.exportName,
+        type: `${options.typeName}[]`,
+        initializer: arrayLiteral(options.entries, writeValue),
+      },
+    ],
+  })
+  sourceFile.addExportAssignment({
+    isExportEquals: false,
+    expression: options.exportName,
+  })
+
+  return getSourceText(sourceFile)
+}
+
 function renderAstLegacyAliasFile(options: {
   fileName: string
   exportName: string
@@ -2761,70 +2928,10 @@ function renderEnabledModuleIdsFile(moduleIds: readonly string[]): string {
   return getSourceText(sourceFile)
 }
 
-function renderLegacyCompatibleArray(entries: readonly string[]): string {
-  return `[
-  ${entries.join(',\n  ')}
-]`
-}
-
 function buildLazyRouteComponentExpression(importPath: string): string {
   return `async (props: any) => { const mod = await ${buildDynamicImportExpression(importPath)}; const Component = (mod.default ?? mod) as any; return createElement(Component, props) }`
 }
 
-function renderAstLegacyModuleRegistryOutput(options: {
-  fileName: string
-  imports: GeneratedImportStatement[]
-  moduleEntries: string[]
-  includeCreateElementImport?: boolean
-  includeAbandonHookImport?: boolean
-}): string {
-  // Derived from what is actually being written, not from a flag the caller has to remember: an
-  // import that must be opted into at every render site produces a file referencing an undeclared
-  // name the first time someone forgets, and the file only fails at `build:app`.
-  const needsAbandonHookImport = options.includeAbandonHookImport
-    || options.moduleEntries.some((entry) => entry.includes(ABANDON_HOOK_FACTORY))
-  const importSection = [
-    ...(options.includeCreateElementImport ? ["import { createElement } from 'react'"] : []),
-    needsAbandonHookImport
-      ? "import { createLazyModuleSubscriber, createLazyModuleWorker, createLazyModuleWorkerAbandonHook, type Module } from '@open-mercato/shared/modules/registry'"
-      : "import { createLazyModuleSubscriber, createLazyModuleWorker, type Module } from '@open-mercato/shared/modules/registry'",
-    ...options.imports.map((entry) => serializeGeneratedImport(entry)),
-  ].join('\n')
-
-  return `// AUTO-GENERATED by mercato generate registry
-${importSection}
-
-export const modules: Module[] = ${renderLegacyCompatibleArray(options.moduleEntries)}
-export const modulesInfo = modules.map(m => ({ id: m.id, ...(m.info || {}) }))
-export default modules
-`
-}
-
-function renderAstLegacyManifestOutput(options: {
-  fileName: string
-  typeName: string
-  exportName: string
-  imports?: GeneratedImportStatement[]
-  entries: string[]
-}): string {
-  const usesPageRouteMetadataHelper = options.typeName === 'FrontendRouteManifestEntry'
-    || options.typeName === 'BackendRouteManifestEntry'
-  const importSection = [
-    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')
-
-  return `// AUTO-GENERATED by mercato generate registry
-${importSection}
-
-export const ${options.exportName}: ${options.typeName}[] = ${renderLegacyCompatibleArray(options.entries)}
-
-export default ${options.exportName}
-`
-}
-
 function buildRuntimeRouteComponent(importPath: string): WriterFunction {
   return arrowFunction({
     async: true,
@@ -3469,11 +3576,11 @@ async function generateModuleRegistryFromDiscovery(options: ModuleRegistryRender
   const runtimeImports: string[] = []
   const frontendRouteManifestImports: string[] = []
   const backendRouteManifestImports: string[] = []
-  const moduleDecls: string[] = []
-  const runtimeModuleDecls: string[] = []
-  const frontendRouteManifestDecls: string[] = []
-  const backendRouteManifestDecls: string[] = []
-  const apiRouteManifestDecls: string[] = []
+  const moduleDecls: WriterFunction[] = []
+  const runtimeModuleDecls: WriterFunction[] = []
+  const frontendRouteManifestDecls: WriterFunction[] = []
+  const backendRouteManifestDecls: WriterFunction[] = []
+  const apiRouteManifestDecls: WriterFunction[] = []
   const backendRouteShardEntries: RouteManifestShardEntry[] = []
   const backendRouteMetadataEntries: RouteManifestShardEntry[] = []
   const apiRouteShardEntries: RouteManifestShardEntry[] = []
@@ -3506,9 +3613,9 @@ async function generateModuleRegistryFromDiscovery(options: ModuleRegistryRender
     const runtimeBackendRoutes: string[] = []
     const runtimeApis: string[] = []
     let cliImportName: string | null = null
-    const translations: string[] = []
-    const subscribers: string[] = []
-    const workers: string[] = []
+    const translations: GeneratedObjectEntry[] = []
+    const subscribers: WriterFunction[] = []
+    const workers: WriterFunction[] = []
     let infoImportName: string | null = null
     let extensionsImportName: string | null = null
     let fieldsImportName: string | null = null
@@ -3722,7 +3829,7 @@ async function generateModuleRegistryFromDiscovery(options: ModuleRegistryRender
     }
 
     // 16. Translations
-    translations.push(...processTranslations({
+    translations.push(...processTranslationsAst({
       discovered: discovered.translations,
       modId,
       appImportBase,
@@ -3732,12 +3839,12 @@ async function generateModuleRegistryFromDiscovery(options: ModuleRegistryRender
     }))
 
     // 17. Subscribers
-    subscribers.push(...processSubscribers(await discovered.getSubscribers()))
+    subscribers.push(...processSubscribersAst(await discovered.getSubscribers()))
 
     // 18. Workers
     const discoveredWorkersForModule = await discovered.getWorkers()
     if (workersDeclareAbandonHook(discoveredWorkersForModule)) hasAbandonHookWorkers = true
-    workers.push(...processWorkers(discoveredWorkersForModule))
+    workers.push(...processWorkersAst(discoveredWorkersForModule))
 
     // Build combined customFieldSets expression
     {
@@ -3760,44 +3867,120 @@ async function generateModuleRegistryFromDiscovery(options: ModuleRegistryRender
       }
     }
 
-    moduleDecls.push(`{
-      id: ${toLiteral(modId)},
-      ${infoImportName ? `info: ${infoImportName}.metadata,` : ''}
-      ${frontendRoutes.length ? `frontendRoutes: [${frontendRoutes.join(', ')}],` : ''}
-      ${backendRoutes.length ? `backendRoutes: [${backendRoutes.join(', ')}],` : ''}
-      ${apis.length ? `apis: [${apis.join(', ')}],` : ''}
-      ${cliImportName ? `cli: ${cliImportName},` : ''}
-      ${translations.length ? `translations: { ${translations.join(', ')} },` : ''}
-      ${subscribers.length ? `subscribers: [${subscribers.join(', ')}],` : ''}
-      ${workers.length ? `workers: [${workers.join(', ')}],` : ''}
-      ${extensionsImportName ? `entityExtensions: ((${extensionsImportName}.default ?? ${extensionsImportName}.extensions) as import('@open-mercato/shared/modules/entities').EntityExtension[]) || [],` : ''}
-      customFieldSets: ${customFieldSetsExpr},
-      ${featuresImportName ? `features: ((${featuresImportName}.default ?? ${featuresImportName}.features) as any) || [],` : ''}
-      ${customEntitiesImportName ? `customEntities: ((${customEntitiesImportName}.default ?? ${customEntitiesImportName}.entities) as any) || [],` : ''}
-      ${dashboardWidgets.length ? `dashboardWidgets: [${dashboardWidgets.join(', ')}],` : ''}
-      ${setupImportName ? `setup: (${setupImportName}.default ?? ${setupImportName}.setup) || undefined,` : ''}
-      ${encryptionImportName ? `defaultEncryptionMaps: ((${encryptionImportName}.default ?? ${encryptionImportName}.defaultEncryptionMaps) as import('@open-mercato/shared/modules/encryption').ModuleEncryptionMap[]) || [],` : ''}
-      ${integrationExports ? `integrations: ((${integrationExports}.integrations ?? (${integrationExports}.integration ? [${integrationExports}.integration] : [])) as import('@open-mercato/shared/modules/integrations/types').IntegrationDefinition[]),` : ''}
-      ${integrationExports ? `bundles: ((${integrationExports}.bundles ?? (${integrationExports}.bundle ? [${integrationExports}.bundle] : [])) as import('@open-mercato/shared/modules/integrations/types').IntegrationBundle[]),` : ''}
-    }`)
-    runtimeModuleDecls.push(`{
-      id: ${toLiteral(modId)},
-      ${infoImportName ? `info: ${infoImportName}.metadata,` : ''}
-      ${runtimeFrontendRoutes.length ? `frontendRoutes: [${runtimeFrontendRoutes.join(', ')}],` : ''}
-      ${runtimeBackendRoutes.length ? `backendRoutes: [${runtimeBackendRoutes.join(', ')}],` : ''}
-      ${runtimeApis.length ? `apis: [${runtimeApis.join(', ')}],` : ''}
-      ${translations.length ? `translations: { ${translations.join(', ')} },` : ''}
-      ${subscribers.length ? `subscribers: [${subscribers.join(', ')}],` : ''}
-      ${workers.length ? `workers: [${workers.join(', ')}],` : ''}
-      ${extensionsImportName ? `entityExtensions: ((${extensionsImportName}.default ?? ${extensionsImportName}.extensions) as import('@open-mercato/shared/modules/entities').EntityExtension[]) || [],` : ''}
-      customFieldSets: ${customFieldSetsExpr},
-      ${featuresImportName ? `features: ((${featuresImportName}.default ?? ${featuresImportName}.features) as any) || [],` : ''}
-      ${customEntitiesImportName ? `customEntities: ((${customEntitiesImportName}.default ?? ${customEntitiesImportName}.entities) as any) || [],` : ''}
-      ${setupImportName ? `setup: (${setupImportName}.default ?? ${setupImportName}.setup) || undefined,` : ''}
-      ${encryptionImportName ? `defaultEncryptionMaps: ((${encryptionImportName}.default ?? ${encryptionImportName}.defaultEncryptionMaps) as import('@open-mercato/shared/modules/encryption').ModuleEncryptionMap[]) || [],` : ''}
-      ${integrationExports ? `integrations: ((${integrationExports}.integrations ?? (${integrationExports}.integration ? [${integrationExports}.integration] : [])) as import('@open-mercato/shared/modules/integrations/types').IntegrationDefinition[]),` : ''}
-      ${integrationExports ? `bundles: ((${integrationExports}.bundles ?? (${integrationExports}.bundle ? [${integrationExports}.bundle] : [])) as import('@open-mercato/shared/modules/integrations/types').IntegrationBundle[]),` : ''}
-    }`)
+    const identityEntries: GeneratedObjectEntry[] = [{ name: 'id', value: modId }]
+    if (infoImportName) {
+      identityEntries.push({ name: 'info', value: propertyAccess(identifier(infoImportName), 'metadata') })
+    }
+
+    const sharedTailEntries: GeneratedObjectEntry[] = []
+    if (translations.length > 0) {
+      sharedTailEntries.push({ name: 'translations', value: objectLiteral(translations) })
+    }
+    if (subscribers.length > 0) {
+      sharedTailEntries.push({ name: 'subscribers', value: arrayLiteral(subscribers, writeValue) })
+    }
+    if (workers.length > 0) {
+      sharedTailEntries.push({ name: 'workers', value: arrayLiteral(workers, writeValue) })
+    }
+    if (extensionsImportName) {
+      sharedTailEntries.push({
+        name: 'entityExtensions',
+        value: buildLegacyModuleListValue({
+          importName: extensionsImportName,
+          members: ['default', 'extensions'],
+          castType: "import('@open-mercato/shared/modules/entities').EntityExtension[]",
+        }),
+      })
+    }
+    sharedTailEntries.push({ name: 'customFieldSets', value: identifier(customFieldSetsExpr) })
+    if (featuresImportName) {
+      sharedTailEntries.push({
+        name: 'features',
+        value: buildLegacyModuleListValue({
+          importName: featuresImportName,
+          members: ['default', 'features'],
+          castType: 'any',
+        }),
+      })
+    }
+    if (customEntitiesImportName) {
+      sharedTailEntries.push({
+        name: 'customEntities',
+        value: buildLegacyModuleListValue({
+          importName: customEntitiesImportName,
+          members: ['default', 'entities'],
+          castType: 'any',
+        }),
+      })
+    }
+
+    const setupAndBeyondEntries: GeneratedObjectEntry[] = []
+    if (setupImportName) {
+      setupAndBeyondEntries.push({ name: 'setup', value: buildLegacyModuleSetupValue(setupImportName) })
+    }
+    if (encryptionImportName) {
+      setupAndBeyondEntries.push({
+        name: 'defaultEncryptionMaps',
+        value: buildLegacyModuleListValue({
+          importName: encryptionImportName,
+          members: ['default', 'defaultEncryptionMaps'],
+          castType: "import('@open-mercato/shared/modules/encryption').ModuleEncryptionMap[]",
+        }),
+      })
+    }
+    if (integrationExports) {
+      setupAndBeyondEntries.push({
+        name: 'integrations',
+        value: buildLegacyIntegrationListValue(
+          integrationExports,
+          'integrations',
+          'integration',
+          "import('@open-mercato/shared/modules/integrations/types').IntegrationDefinition[]",
+        ),
+      })
+      setupAndBeyondEntries.push({
+        name: 'bundles',
+        value: buildLegacyIntegrationListValue(
+          integrationExports,
+          'bundles',
+          'bundle',
+          "import('@open-mercato/shared/modules/integrations/types').IntegrationBundle[]",
+        ),
+      })
+    }
+
+    const eagerEntries: GeneratedObjectEntry[] = [...identityEntries]
+    if (frontendRoutes.length > 0) {
+      eagerEntries.push({ name: 'frontendRoutes', value: preRenderedExpressionList(frontendRoutes) })
+    }
+    if (backendRoutes.length > 0) {
+      eagerEntries.push({ name: 'backendRoutes', value: preRenderedExpressionList(backendRoutes) })
+    }
+    if (apis.length > 0) {
+      eagerEntries.push({ name: 'apis', value: preRenderedExpressionList(apis) })
+    }
+    if (cliImportName) {
+      eagerEntries.push({ name: 'cli', value: identifier(cliImportName) })
+    }
+    eagerEntries.push(...sharedTailEntries)
+    if (dashboardWidgets.length > 0) {
+      eagerEntries.push({ name: 'dashboardWidgets', value: preRenderedExpressionList(dashboardWidgets) })
+    }
+    eagerEntries.push(...setupAndBeyondEntries)
+    moduleDecls.push(objectLiteral(eagerEntries))
+
+    const runtimeEntries: GeneratedObjectEntry[] = [...identityEntries]
+    if (runtimeFrontendRoutes.length > 0) {
+      runtimeEntries.push({ name: 'frontendRoutes', value: preRenderedExpressionList(runtimeFrontendRoutes) })
+    }
+    if (runtimeBackendRoutes.length > 0) {
+      runtimeEntries.push({ name: 'backendRoutes', value: preRenderedExpressionList(runtimeBackendRoutes) })
+    }
+    if (runtimeApis.length > 0) {
+      runtimeEntries.push({ name: 'apis', value: preRenderedExpressionList(runtimeApis) })
+    }
+    runtimeEntries.push(...sharedTailEntries, ...setupAndBeyondEntries)
+    runtimeModuleDecls.push(objectLiteral(runtimeEntries))
   }
 
   // === UMES Conflict Detection ===
@@ -3898,35 +4081,37 @@ async function generateModuleRegistryFromDiscovery(options: ModuleRegistryRender
     }
   }
 
-  const output = renderAstLegacyModuleRegistryOutput({
+  const output = renderAstModuleRegistryFile({
     fileName: 'modules.generated.ts',
+    generator: 'registry',
     imports,
     moduleEntries: moduleDecls,
     includeCreateElementImport: hasRouteComponents,
     includeAbandonHookImport: hasAbandonHookWorkers,
   })
-  const runtimeOutput = renderAstLegacyModuleRegistryOutput({
+  const runtimeOutput = renderAstModuleRegistryFile({
     fileName: 'modules.runtime.generated.ts',
+    generator: 'registry',
     imports: runtimeImports,
     moduleEntries: runtimeModuleDecls,
     includeCreateElementImport: true,
     includeAbandonHookImport: hasAbandonHookWorkers,
   })
-  const frontendRoutesOutput = renderAstLegacyManifestOutput({
+  const frontendRoutesOutput = renderAstManifestFile({
     fileName: 'frontend-routes.generated.ts',
     typeName: 'FrontendRouteManifestEntry',
     exportName: 'frontendRoutes',
     imports: frontendRouteManifestImports,
     entries: frontendRouteManifestDecls,
   })
-  const backendRoutesOutput = renderAstLegacyManifestOutput({
+  const backendRoutesOutput = renderAstManifestFile({
     fileName: 'backend-routes.generated.ts',
     typeName: 'BackendRouteManifestEntry',
     exportName: 'backendRoutes',
     imports: backendRouteManifestImports,
     entries: backendRouteManifestDecls,
   })
-  const apiRoutesOutput = renderAstLegacyManifestOutput({
+  const apiRoutesOutput = renderAstManifestFile({
     fileName: 'api-routes.generated.ts',
     typeName: 'ApiRouteManifestEntry',
     exportName: 'apiRoutes',
@@ -4066,15 +4251,11 @@ async function generateModuleRegistryFromDiscovery(options: ModuleRegistryRender
       allRegImports.push(...reg.registrationImports)
       allCalls.push(reg.buildCall(reg.entriesExportName))
     }
-    const uniqueImports = [...new Set([...allEntryImports, ...allRegImports])]
-    const importSection = uniqueImports.join('\n')
-    const body = `  ${allCalls.join('\n  ')}`
-    const bootstrapRegsOutput = `// AUTO-GENERATED by mercato generate registry
-${importSection ? `${importSection}\n` : ''}
-export function runBootstrapRegistrations(): void {
-${body}
-}
-`
+    const bootstrapRegsOutput = renderBootstrapRegistrationsFile({
+      entryImports: allEntryImports,
+      registrationImports: allRegImports,
+      calls: allCalls,
+    })
     writeGeneratedFile({ outFile: bootstrapRegsOutFile, checksumFile: bootstrapRegsChecksumFile, content: bootstrapRegsOutput, structureChecksum, result, quiet })
   }