@reforgium/presentia 2.0.0 → 2.1.1

package/bin/presentia-gen-namespaces.mjs

@@ -1,1248 +1,1248 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-
-let projectRoot = '';
-let localeValidator = null;
-let generatorReport = null;
-
-const getArg = (args, name, fallback) => {
-  const idx = args.indexOf(name);
-
-  return idx >= 0 && args[idx + 1] ? args[idx + 1] : fallback;
-};
-
-const KEY_RE = /^[a-z0-9_-]+\.[a-z0-9_.-]+$/i;
-const visitedFiles = new Set();
-const visitedRouteExports = new Set();
-
-function fail(message) {
-  throw new Error(`[presentia-gen-namespaces] ${message}`);
-}
-
-function createReport() {
-  return {
-    issues: [],
-    addIssue(issue) {
-      this.issues.push(issue);
-    },
-  };
-}
-
-function readText(filePath) {
-  return fs.readFileSync(filePath, 'utf8');
-}
-
-function tryReadJson(filePath) {
-  if (!fs.existsSync(filePath)) {
-    return null;
-  }
-
-  return JSON.parse(readText(filePath));
-}
-
-function collectJsonFiles(dir) {
-  const out = [];
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const full = path.join(dir, entry.name);
-
-    if (entry.isDirectory()) {
-      out.push(...collectJsonFiles(full));
-      continue;
-    }
-
-    if (entry.isFile() && entry.name.endsWith('.json')) {
-      out.push(full);
-    }
-  }
-
-  return out;
-}
-
-function namespaceFromLocaleFile(filePath) {
-  const base = path.basename(filePath);
-  const parts = base.split('.');
-
-  if (parts.length >= 3) {
-    return parts.slice(0, -2).join('.');
-  }
-
-  return parts.slice(0, -1).join('.');
-}
-
-function flattenLocaleKeys(value, prefix = '') {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) {
-    return [];
-  }
-
-  const out = [];
-
-  for (const [key, nested] of Object.entries(value)) {
-    const next = prefix ? `${prefix}.${key}` : key;
-
-    if (nested && typeof nested === 'object' && !Array.isArray(nested)) {
-      out.push(...flattenLocaleKeys(nested, next));
-    } else {
-      out.push(next);
-    }
-  }
-
-  return out;
-}
-
-function createLocaleValidator(localesPath) {
-  if (!localesPath) {
-    return null;
-  }
-
-  if (!fs.existsSync(localesPath)) {
-    fail(`locales directory not found: ${localesPath}`);
-  }
-
-  const namespaceSet = new Set();
-  const keySet = new Set();
-
-  for (const file of collectJsonFiles(localesPath)) {
-    const ns = namespaceFromLocaleFile(file);
-
-    if (!ns) {
-      continue;
-    }
-
-    namespaceSet.add(ns);
-
-    try {
-      const json = JSON.parse(readText(file));
-
-      for (const key of flattenLocaleKeys(json)) {
-        keySet.add(`${ns}.${key}`);
-      }
-    } catch {
-      // Ignore malformed locale files in generator mode.
-    }
-  }
-
-  return {
-    hasNamespace(ns) {
-      return namespaceSet.has(ns);
-    },
-    hasKey(key) {
-      return keySet.has(key);
-    },
-  };
-}
-
-function loadTsconfig(filePath, seen = new Set()) {
-  const resolved = path.resolve(filePath);
-
-  if (!fs.existsSync(resolved) || seen.has(resolved)) {
-    return { compilerOptions: {}, _dir: path.dirname(resolved) };
-  }
-
-  seen.add(resolved);
-  const json = JSON.parse(readText(resolved));
-  const base = json.extends
-    ? loadTsconfig(resolveExtendsPath(path.dirname(resolved), json.extends), seen)
-    : { compilerOptions: {}, _dir: path.dirname(resolved) };
-  const compilerOptions = {
-    ...(base.compilerOptions ?? {}),
-    ...(json.compilerOptions ?? {}),
-    paths: {
-      ...((base.compilerOptions && base.compilerOptions.paths) || {}),
-      ...((json.compilerOptions && json.compilerOptions.paths) || {}),
-    },
-  };
-
-  return { ...base, ...json, compilerOptions, _dir: path.dirname(resolved) };
-}
-
-function resolveExtendsPath(baseDir, value) {
-  if (value.startsWith('.')) {
-    return withJsonSuffix(path.resolve(baseDir, value));
-  }
-
-  return withJsonSuffix(path.resolve(baseDir, value));
-}
-
-function withJsonSuffix(filePath) {
-  return filePath.endsWith('.json') ? filePath : `${filePath}.json`;
-}
-
-function stripComments(source) {
-  let out = '';
-  let quote = null;
-  let escape = false;
-
-  for (let i = 0; i < source.length; i++) {
-    const ch = source[i];
-    const next = source[i + 1];
-
-    if (quote) {
-      out += ch;
-
-      if (escape) {
-        escape = false;
-      } else if (ch === '\\') {
-        escape = true;
-      } else if (ch === quote) {
-        quote = null;
-      }
-
-      continue;
-    }
-
-    if (ch === '"' || ch === "'" || ch === '`') {
-      quote = ch;
-      out += ch;
-      continue;
-    }
-
-    if (ch === '/' && next === '/') {
-      while (i < source.length && source[i] !== '\n') {
-        i++;
-      }
-      out += '\n';
-      continue;
-    }
-
-    if (ch === '/' && next === '*') {
-      i += 2;
-      while (i < source.length && !(source[i] === '*' && source[i + 1] === '/')) {
-        i++;
-      }
-      i++;
-      continue;
-    }
-
-    out += ch;
-  }
-
-  return out;
-}
-
-function findMatching(source, start, openChar, closeChar) {
-  let depth = 0;
-  let quote = null;
-  let escape = false;
-
-  for (let i = start; i < source.length; i++) {
-    const ch = source[i];
-    const next = source[i + 1];
-
-    if (quote) {
-      if (escape) {
-        escape = false;
-      } else if (ch === '\\') {
-        escape = true;
-      } else if (ch === quote) {
-        quote = null;
-      }
-      continue;
-    }
-
-    if (ch === '"' || ch === "'" || ch === '`') {
-      quote = ch;
-      continue;
-    }
-
-    if (ch === '/' && next === '/') {
-      while (i < source.length && source[i] !== '\n') {
-        i++;
-      }
-      continue;
-    }
-
-    if (ch === '/' && next === '*') {
-      i += 2;
-      while (i < source.length && !(source[i] === '*' && source[i + 1] === '/')) {
-        i++;
-      }
-      i++;
-      continue;
-    }
-
-    if (ch === openChar) {
-      depth++;
-      continue;
-    }
-
-    if (ch === closeChar) {
-      depth--;
-      if (depth === 0) {
-        return i;
-      }
-    }
-  }
-
-  return -1;
-}
-
-function extractArrayLiteral(source, anchorPattern) {
-  const match = anchorPattern.exec(source);
-
-  if (!match) {
-    return null;
-  }
-
-  const preferredStart = match.index + match[0].length - 1;
-  const start = source[preferredStart] === '[' ? preferredStart : source.indexOf('[', preferredStart);
-  const end = findMatching(source, start, '[', ']');
-
-  if (start < 0 || end < 0) {
-    return null;
-  }
-
-  return source.slice(start, end + 1);
-}
-
-function splitTopLevelItems(arrayLiteral) {
-  const inner = arrayLiteral.trim().replace(/^\[/, '').replace(/\]$/, '');
-  const items = [];
-  let token = '';
-  let depthBrace = 0;
-  let depthBracket = 0;
-  let depthParen = 0;
-  let quote = null;
-  let escape = false;
-
-  for (let i = 0; i < inner.length; i++) {
-    const ch = inner[i];
-    const next = inner[i + 1];
-
-    token += ch;
-
-    if (quote) {
-      if (escape) {
-        escape = false;
-      } else if (ch === '\\') {
-        escape = true;
-      } else if (ch === quote) {
-        quote = null;
-      }
-      continue;
-    }
-
-    if (ch === '"' || ch === "'" || ch === '`') {
-      quote = ch;
-      continue;
-    }
-
-    if (ch === '/' && next === '/') {
-      while (i < inner.length && inner[i] !== '\n') {
-        token += inner[++i] ?? '';
-      }
-      continue;
-    }
-
-    if (ch === '/' && next === '*') {
-      token += inner[++i] ?? '';
-      while (i < inner.length && !(inner[i] === '*' && inner[i + 1] === '/')) {
-        token += inner[++i] ?? '';
-      }
-      token += inner[++i] ?? '';
-      continue;
-    }
-
-    if (ch === '{') depthBrace++;
-    if (ch === '}') depthBrace--;
-    if (ch === '[') depthBracket++;
-    if (ch === ']') depthBracket--;
-    if (ch === '(') depthParen++;
-    if (ch === ')') depthParen--;
-
-    if (ch === ',' && depthBrace === 0 && depthBracket === 0 && depthParen === 0) {
-      const trimmed = token.slice(0, -1).trim();
-      if (trimmed) {
-        items.push(trimmed);
-      }
-      token = '';
-    }
-  }
-
-  const trimmed = token.trim();
-  if (trimmed) {
-    items.push(trimmed);
-  }
-
-  return items;
-}
-
-function extractObjectLiterals(arrayLiteral) {
-  return splitTopLevelItems(arrayLiteral).filter((item) => item.startsWith('{'));
-}
-
-function parseImports(source) {
-  const imports = new Map();
-  const re = /import\s+\{([^}]+)\}\s+from\s+['"]([^'"]+)['"]/g;
-  let match;
-
-  while ((match = re.exec(source))) {
-    const specifier = match[2];
-    const names = match[1]
-      .split(',')
-      .map((part) => part.trim())
-      .filter(Boolean);
-
-    for (const name of names) {
-      const [imported, local] = name.split(/\s+as\s+/);
-
-      imports.set((local ?? imported).trim(), {
-        imported: imported.trim(),
-        specifier,
-      });
-    }
-  }
-
-  return imports;
-}
-
-function resolveFile(basePath) {
-  const candidates = [
-    basePath,
-    `${basePath}.ts`,
-    `${basePath}.tsx`,
-    `${basePath}.js`,
-    `${basePath}.mjs`,
-    path.join(basePath, 'index.ts'),
-    path.join(basePath, 'index.tsx'),
-    path.join(basePath, 'index.js'),
-    path.join(basePath, 'index.mjs'),
-  ];
-
-  return candidates.find((candidate) => fs.existsSync(candidate) && fs.statSync(candidate).isFile()) ?? null;
-}
-
-function createPathResolver(routesFilePath, tsconfig) {
-  const importerDir = path.dirname(routesFilePath);
-  const configBase = path.resolve(tsconfig._dir, tsconfig.compilerOptions?.baseUrl ?? '.');
-  const pathEntries = Object.entries(tsconfig.compilerOptions?.paths ?? {});
-
-  return (specifier, fromFile) => {
-    const fromDir = fromFile ? path.dirname(fromFile) : importerDir;
-
-    if (specifier.startsWith('.')) {
-      return resolveFile(path.resolve(fromDir, specifier));
-    }
-
-    for (const [pattern, targets] of pathEntries) {
-      const matches = matchPathPattern(specifier, pattern);
-
-      if (!matches) {
-        continue;
-      }
-
-      for (const target of targets) {
-        const candidate = target.replace('*', matches);
-        const resolved = resolveFile(path.resolve(configBase, candidate));
-
-        if (resolved) {
-          return resolved;
-        }
-      }
-    }
-
-    return resolveFile(path.resolve(configBase, specifier));
-  };
-}
-
-function matchPathPattern(specifier, pattern) {
-  if (!pattern.includes('*')) {
-    return specifier === pattern ? '' : null;
-  }
-
-  const [prefix, suffix] = pattern.split('*');
-
-  if (!specifier.startsWith(prefix) || !specifier.endsWith(suffix)) {
-    return null;
-  }
-
-  return specifier.slice(prefix.length, specifier.length - suffix.length);
-}
-
-function parseConstObjects(filePath, resolver, cache = new Map()) {
-  if (cache.has(filePath)) {
-    return cache.get(filePath);
-  }
-
-  const source = stripComments(readText(filePath));
-  const objects = new Map();
-  const exportedRe = /export\s+const\s+(\w+)\s*=\s*\{/g;
-  let match;
-
-  while ((match = exportedRe.exec(source))) {
-    const name = match[1];
-    const start = source.indexOf('{', match.index);
-    const end = findMatching(source, start, '{', '}');
-
-    if (start < 0 || end < 0) {
-      continue;
-    }
-
-    const parsed = parseSimpleValueExpression(source.slice(start, end + 1));
-
-    if (parsed && typeof parsed === 'object') {
-      objects.set(name, parsed);
-    }
-  }
-
-  const exportedArrayRe = /export\s+const\s+(\w+)\s*=\s*\[/g;
-
-  while ((match = exportedArrayRe.exec(source))) {
-    const name = match[1];
-    const start = source.indexOf('[', match.index);
-    const end = findMatching(source, start, '[', ']');
-
-    if (start < 0 || end < 0) {
-      continue;
-    }
-
-    const parsed = parseSimpleValueExpression(source.slice(start, end + 1));
-
-    if (Array.isArray(parsed)) {
-      objects.set(name, parsed);
-    }
-  }
-
-  const imports = parseImports(source);
-
-  for (const [localName, imported] of imports) {
-    const resolved = resolver(imported.specifier, filePath);
-
-    if (!resolved) {
-      continue;
-    }
-
-    const nestedObjects = parseConstObjects(resolved, resolver, cache);
-    const importedValue = nestedObjects.get(imported.imported);
-
-    if (importedValue) {
-      objects.set(localName, importedValue);
-    }
-  }
-
-  cache.set(filePath, objects);
-
-  return objects;
-}
-
-function parseSimpleObjectLiteral(source) {
-  const object = {};
-  const inner = source.trim().replace(/^\{/, '').replace(/\}$/, '');
-
-  for (const entry of splitTopLevelItems(`[${inner}]`)) {
-    const idx = entry.indexOf(':');
-
-    if (idx < 0) {
-      continue;
-    }
-
-    const key = entry.slice(0, idx).trim().replace(/^['"]|['"]$/g, '');
-    const valueExpr = entry.slice(idx + 1).trim();
-    const value = parseSimpleValueExpression(valueExpr);
-
-    if (key && value !== null) {
-      object[key] = value;
-    }
-  }
-
-  return object;
-}
-
-function parseSimpleValueExpression(value) {
-  const trimmed = value.trim();
-  const stringLiteral = parseStringLiteral(trimmed);
-
-  if (stringLiteral !== null) {
-    return stringLiteral;
-  }
-
-  if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
-    const items = splitTopLevelItems(trimmed)
-      .map((item) => parseSimpleValueExpression(item))
-      .filter((item) => item !== null);
-
-    return items.every((item) => typeof item === 'string') ? items : null;
-  }
-
-  if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
-    return parseSimpleObjectLiteral(trimmed);
-  }
-
-  return null;
-}
-
-function parseStringLiteral(value) {
-  const trimmed = value.trim();
-
-  if ((trimmed.startsWith("'") && trimmed.endsWith("'")) || (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
-    return trimmed.slice(1, -1);
-  }
-
-  return null;
-}
-
-function resolvePathExpression(expr, constObjects) {
-  const trimmed = expr.trim();
-  const literal = parseStringLiteral(trimmed);
-
-  if (literal !== null) {
-    return literal;
-  }
-
-  const refMatch = /^(\w+)\.(\w+)$/.exec(trimmed);
-
-  if (!refMatch) {
-    return null;
-  }
-
-  const object = constObjects.get(refMatch[1]);
-
-  if (!object) {
-    return null;
-  }
-
-  return object[refMatch[2]] ?? null;
-}
-
-function resolveConstExpression(expr, constObjects) {
-  const trimmed = expr.trim();
-  const literal = parseSimpleValueExpression(trimmed);
-
-  if (literal !== null) {
-    return literal;
-  }
-
-  if (constObjects.has(trimmed)) {
-    return constObjects.get(trimmed);
-  }
-
-  const refMatch = /^(\w+)\.(\w+)$/.exec(trimmed);
-
-  if (!refMatch) {
-    return null;
-  }
-
-  const object = constObjects.get(refMatch[1]);
-
-  if (!object || typeof object !== 'object') {
-    return null;
-  }
-
-  return object[refMatch[2]] ?? null;
-}
-
-function normalizePathPath(value) {
-  const trimmed = (value ?? '').trim().replace(/^\/+|\/+$/g, '');
-
-  return trimmed;
-}
-
-function joinRoutePath(parentPath, childPath) {
-  const normalizedParent = normalizePathPath(parentPath);
-  const normalizedChild = normalizePathPath(childPath);
-
-  if (!normalizedParent && !normalizedChild) {
-    return '/';
-  }
-
-  if (!normalizedParent) {
-    return `/${normalizedChild}`;
-  }
-
-  if (!normalizedChild) {
-    return `/${normalizedParent}`;
-  }
-
-  return `/${normalizedParent}/${normalizedChild}`;
-}
-
-function extractFieldExpression(objectText, fieldName) {
-  const inner = objectText.trim().replace(/^\{/, '').replace(/\}$/, '');
-
-  for (const entry of splitTopLevelItems(`[${inner}]`)) {
-    const idx = entry.indexOf(':');
-
-    if (idx < 0) {
-      continue;
-    }
-
-    const key = entry.slice(0, idx).trim().replace(/^['"]|['"]$/g, '');
-
-    if (key === fieldName) {
-      return entry.slice(idx + 1).trim();
-    }
-  }
-
-  return null;
-}
-
-function extractChildrenArray(objectText) {
-  const expr = extractFieldExpression(objectText, 'children');
-
-  if (!expr || !expr.startsWith('[')) {
-    return null;
-  }
-
-  return expr;
-}
-
-function extractRouteDataNamespaces(objectText, constObjects, reportContext) {
-  const dataExpr = extractFieldExpression(objectText, 'data');
-
-  if (!dataExpr || !dataExpr.startsWith('{')) {
-    return [];
-  }
-
-  const namespaces = new Set(extractKeyLiterals(dataExpr).filter(isAcceptedKey).map(namespaceFromKey).filter(Boolean));
-  const explicitNamespaces = extractExplicitNamespaceArray(dataExpr, 'presentiaNamespaces', constObjects);
-
-  if (extractFieldExpression(dataExpr, 'presentiaNamespaces') && !explicitNamespaces.length) {
-    generatorReport?.addIssue({
-      type: 'unsupported-data-namespaces',
-      filePath: reportContext.routesFile,
-      routePath: reportContext.fullPath,
-      message: 'Could not statically resolve data.presentiaNamespaces',
-    });
-  }
-
-  for (const ns of explicitNamespaces) {
-    namespaces.add(ns);
-  }
-
-  return [...namespaces];
-}
-
-function extractExplicitNamespaceArray(objectText, fieldName, constObjects) {
-  const expr = extractFieldExpression(objectText, fieldName);
-
-  if (!expr) {
-    return [];
-  }
-
-  const resolved = resolveConstExpression(expr, constObjects);
-
-  if (!Array.isArray(resolved)) {
-    return [];
-  }
-
-  return resolved.map((value) => String(value).trim()).filter(isAcceptedNamespace);
-}
-
-function parseLoadComponent(objectText) {
-  return parseLazyImportExpression(extractFieldExpression(objectText, 'loadComponent'));
-}
-
-function parseLoadChildren(objectText) {
-  return parseLazyImportExpression(extractFieldExpression(objectText, 'loadChildren'));
-}
-
-function parseLazyImportExpression(expr) {
-
-  if (!expr) {
-    return null;
-  }
-
-  const importMatch = /import\(\s*['"]([^'"]+)['"]\s*\)/.exec(expr);
-  const exportMatch = /\.([A-Za-z0-9_]+)\s*\)?\s*$/.exec(expr);
-
-  if (!importMatch || !exportMatch) {
-    return null;
-  }
-
-  return { specifier: importMatch[1], exportName: exportMatch[1] };
-}
-
-function parseRoutes(arrayLiteral, context) {
-  const routes = [];
-
-  for (const objectText of extractObjectLiterals(arrayLiteral)) {
-    const pathExpr = extractFieldExpression(objectText, 'path');
-    const redirectExpr = extractFieldExpression(objectText, 'redirectTo');
-    const pathValue = pathExpr ? resolvePathExpression(pathExpr, context.constObjects) : null;
-    const ownPath = normalizePathPath(pathValue ?? '');
-    const fullPath = joinRoutePath(context.parentPath, ownPath);
-    const routeDataNamespaces = extractRouteDataNamespaces(objectText, context.constObjects, {
-      routesFile: context.routesFile,
-      fullPath,
-    });
-    const componentRefs = [];
-    const componentExpr = extractFieldExpression(objectText, 'component');
-
-    if (componentExpr) {
-      const localName = componentExpr.trim();
-      const imported = context.imports.get(localName);
-
-      if (imported) {
-        const resolved = context.resolver(imported.specifier, context.routesFile);
-
-        if (!resolved) {
-          generatorReport?.addIssue({
-            type: 'unresolved-component',
-            filePath: context.routesFile,
-            routePath: fullPath,
-            message: `Could not resolve component import "${imported.specifier}"`,
-          });
-        }
-
-        componentRefs.push({
-          filePath: resolved,
-          exportName: imported.imported,
-        });
-      }
-    }
-
-    const lazyComponent = parseLoadComponent(objectText);
-    if (lazyComponent) {
-      const resolved = context.resolver(lazyComponent.specifier, context.routesFile);
-
-      if (!resolved) {
-        generatorReport?.addIssue({
-          type: 'unresolved-load-component',
-          filePath: context.routesFile,
-          routePath: fullPath,
-          message: `Could not resolve loadComponent import "${lazyComponent.specifier}"`,
-        });
-      }
-
-      componentRefs.push({
-        filePath: resolved,
-        exportName: lazyComponent.exportName,
-      });
-    }
-
-    const lazyChildren = parseLoadChildren(objectText);
-
-    const componentNamespaces = componentRefs.flatMap((componentRef) =>
-      componentRef.filePath ? collectComponentNamespaces(componentRef.filePath, componentRef.exportName, context) : [],
-    );
-    const inheritedNamespaces = unique([...context.inheritedNamespaces, ...componentNamespaces, ...routeDataNamespaces]);
-    const childrenArray = extractChildrenArray(objectText);
-
-    if (childrenArray) {
-      routes.push(
-        ...parseRoutes(childrenArray, {
-          ...context,
-          parentPath: fullPath,
-          inheritedNamespaces,
-        }),
-      );
-    }
-
-    if (lazyChildren) {
-      const childRoutesFile = context.resolver(lazyChildren.specifier, context.routesFile);
-
-      if (childRoutesFile) {
-        routes.push(
-          ...parseRoutesFromExport(childRoutesFile, lazyChildren.exportName, {
-            ...context,
-            inheritedNamespaces,
-            parentPath: fullPath,
-            routesFile: childRoutesFile,
-          }),
-        );
-      } else {
-        generatorReport?.addIssue({
-          type: 'unresolved-load-children',
-          filePath: context.routesFile,
-          routePath: fullPath,
-          message: `Could not resolve loadChildren import "${lazyChildren.specifier}"`,
-        });
-      }
-    }
-
-    const isConcreteRoute = !redirectExpr && (componentRefs.length > 0 || routeDataNamespaces.length > 0);
-
-    if (isConcreteRoute) {
-      routes.push({
-        path: fullPath,
-        namespaces: inheritedNamespaces,
-      });
-    }
-  }
-
-  return routes;
-}
-
-function parseRoutesFromExport(filePath, exportName, context) {
-  const visitKey = `${filePath}#${exportName}#${context.parentPath}`;
-
-  if (visitedRouteExports.has(visitKey)) {
-    return [];
-  }
-
-  visitedRouteExports.add(visitKey);
-
-  const source = stripComments(readText(filePath));
-  const arrayLiteral =
-    extractArrayLiteral(source, new RegExp(`\\bexport\\s+const\\s+${exportName}\\s*:\\s*[^=]+=\\s*\\[`, 'g')) ??
-    extractArrayLiteral(source, new RegExp(`\\bexport\\s+const\\s+${exportName}\\s*=\\s*\\[`, 'g'));
-
-  if (!arrayLiteral) {
-    return [];
-  }
-
-  return parseRoutes(arrayLiteral, {
-    ...context,
-    constObjects: parseConstObjects(filePath, context.resolver),
-    imports: parseImports(source),
-    routesFile: filePath,
-  });
-}
-
-function collectComponentNamespaces(filePath, exportName, context) {
-  const key = `${filePath}#${exportName}`;
-
-  if (visitedFiles.has(key) || !filePath || !fs.existsSync(filePath)) {
-    return [];
-  }
-
-  visitedFiles.add(key);
-
-  const source = stripComments(readText(filePath));
-  const imports = parseImports(source);
-  const namespaces = new Set(collectNamespacesFromCode(source));
-
-  for (const htmlContent of extractTemplateContents(source, filePath)) {
-    for (const ns of collectNamespacesFromTemplate(htmlContent)) {
-      namespaces.add(ns);
-    }
-  }
-
-  for (const importedName of extractStandaloneImports(source)) {
-    const imported = imports.get(importedName);
-
-    if (!imported) {
-      generatorReport?.addIssue({
-        type: 'unsupported-standalone-import',
-        filePath,
-        exportName,
-        message: `Could not resolve standalone import "${importedName}" from component imports`,
-      });
-      continue;
-    }
-
-    const resolved = context.resolver(imported.specifier, filePath);
-
-    if (!resolved || !resolved.startsWith(projectRoot)) {
-      continue;
-    }
-
-    for (const ns of collectComponentNamespaces(resolved, imported.imported, context)) {
-      namespaces.add(ns);
-    }
-  }
-
-  return [...namespaces];
-}
-
-function extractTemplateContents(source, filePath) {
-  const contents = [];
-  const templateUrlRe = /templateUrl\s*:\s*['"]([^'"]+)['"]/g;
-  let match;
-
-  while ((match = templateUrlRe.exec(source))) {
-    const resolved = resolveFile(path.resolve(path.dirname(filePath), match[1]));
-
-    if (resolved) {
-      contents.push(readText(resolved));
-    }
-  }
-
-  const templateRe = /template\s*:\s*(`[\s\S]*?`|'(?:\\.|[^'])*'|"(?:\\.|[^"])*")/g;
-
-  while ((match = templateRe.exec(source))) {
-    const raw = match[1];
-
-    if (raw.startsWith('`')) {
-      contents.push(raw.slice(1, -1));
-    } else {
-      contents.push(raw.slice(1, -1));
-    }
-  }
-
-  return contents;
-}
-
-function extractStandaloneImports(source) {
-  const importsArray = extractArrayLiteral(source, /\bimports\s*:/g);
-
-  if (!importsArray) {
-    return [];
-  }
-
-  return splitTopLevelItems(importsArray)
-    .map((item) => item.replace(/\s/g, ''))
-    .filter((item) => /^[A-Za-z_][A-Za-z0-9_]*$/.test(item));
-}
-
-function collectNamespacesFromTemplate(content) {
-  const namespaces = new Set();
-  const langPipeRe = /['"`]([A-Za-z0-9_.-]+)['"`]\s*\|\s*lang\b/g;
-  const methodLikeRe = /\[\s*reLang(?:Key)?\s*\]\s*=\s*['"`]([^'"`]+)['"`]/g;
-  const tagWithReLangRe = /<[^>]*\breLang\b[^>]*>/g;
-  const reLangAttrsBindings = extractBindingExpressions(content, 'reLangAttrs');
-  const reLangConfigBindings = extractBindingExpressions(content, 'reLang');
-  let match;
-
-  while ((match = langPipeRe.exec(content))) {
-    const ns = acceptedNamespaceFromKey(match[1]);
-    if (ns) namespaces.add(ns);
-  }
-
-  while ((match = methodLikeRe.exec(content))) {
-    const ns = acceptedNamespaceFromKey(match[1]);
-    if (ns) namespaces.add(ns);
-  }
-
-  while ((match = tagWithReLangRe.exec(content))) {
-    for (const key of extractKeyLiterals(match[0])) {
-      const ns = acceptedNamespaceFromKey(key);
-      if (ns) namespaces.add(ns);
-    }
-  }
-
-  for (const expr of reLangAttrsBindings) {
-    const parsed = parseSimpleValueExpression(expr);
-
-    if (!parsed || typeof parsed !== 'object') {
-      continue;
-    }
-
-    for (const value of Object.values(parsed)) {
-      if (typeof value !== 'string') {
-        continue;
-      }
-
-      const ns = acceptedNamespaceFromKey(value);
-      if (ns) namespaces.add(ns);
-    }
-  }
-
-  for (const expr of reLangConfigBindings) {
-    const parsed = parseSimpleValueExpression(expr);
-
-    if (!parsed || typeof parsed !== 'object') {
-      continue;
-    }
-
-    if (typeof parsed.textKey === 'string') {
-      const ns = acceptedNamespaceFromKey(parsed.textKey);
-      if (ns) namespaces.add(ns);
-    }
-
-    if (parsed.attrs && typeof parsed.attrs === 'object') {
-      for (const value of Object.values(parsed.attrs)) {
-        if (typeof value !== 'string') {
-          continue;
-        }
-
-        const ns = acceptedNamespaceFromKey(value);
-        if (ns) namespaces.add(ns);
-      }
-    }
-  }
-
-  return [...namespaces];
-}
-
-function extractBindingExpressions(content, bindingName) {
-  const out = [];
-  const re = new RegExp(`\\[\\s*${bindingName}\\s*\\]\\s*=\\s*([\"'])([\\s\\S]*?)\\1`, 'g');
-  let match;
-
-  while ((match = re.exec(content))) {
-    out.push(match[2]);
-  }
-
-  return out;
-}
-
-function collectNamespacesFromCode(content) {
-  const namespaces = new Set();
-  const methodRe = /\.\s*(?:get|observe|translate)\s*\(\s*['"`]([^'"`]+)['"`]/g;
-  let match;
-
-  while ((match = methodRe.exec(content))) {
-    const ns = acceptedNamespaceFromKey(match[1]);
-    if (ns) namespaces.add(ns);
-  }
-
-  return [...namespaces];
-}
-
-function extractKeyLiterals(content) {
-  const out = [];
-  const re = /['"`]([A-Za-z0-9_.-]+)['"`]/g;
-  let match;
-
-  while ((match = re.exec(content))) {
-    if (KEY_RE.test(match[1])) {
-      out.push(match[1]);
-    }
-  }
-
-  return out;
-}
-
-function namespaceFromKey(key) {
-  if (!KEY_RE.test(key)) {
-    return null;
-  }
-
-  const [ns] = key.split('.', 1);
-
-  return ns || null;
-}
-
-function acceptedNamespaceFromKey(key) {
-  if (!isAcceptedKey(key)) {
-    return null;
-  }
-
-  return namespaceFromKey(key);
-}
-
-function isAcceptedKey(key) {
-  if (!KEY_RE.test(key)) {
-    return false;
-  }
-
-  if (!localeValidator) {
-    return true;
-  }
-
-  return localeValidator.hasKey(key);
-}
-
-function isAcceptedNamespace(ns) {
-  if (!ns) {
-    return false;
-  }
-
-  if (!localeValidator) {
-    return true;
-  }
-
-  return localeValidator.hasNamespace(ns);
-}
-
-function unique(values) {
-  return [...new Set(values.filter(Boolean))];
-}
-
-function toManifest(routes) {
-  const manifest = new Map();
-
-  for (const route of routes) {
-    if (!route.namespaces.length) {
-      continue;
-    }
-
-    const existing = manifest.get(route.path) ?? [];
-
-    manifest.set(route.path, unique([...existing, ...route.namespaces]).sort());
-  }
-
-  return manifest;
-}
-
-function formatManifest(manifest, name) {
-  const entries = [...manifest.entries()].sort(([a], [b]) => a.localeCompare(b));
-  const lines = entries.map(([routePath, namespaces]) => {
-    const nsList = namespaces.map((ns) => `'${ns}'`).join(', ');
-
-    return `  '${routePath}': [${nsList}],`;
-  });
-
-  return `/* auto-generated by presentia-gen-namespaces */\nexport const ${name} = {\n${lines.join('\n')}\n} as const;\n`;
-}
-
-function formatReport(report) {
-  return JSON.stringify(report, null, 2);
-}
-
-export function generateNamespaceManifest(cliArgs = process.argv.slice(2), currentWorkingDir = process.cwd()) {
-  const routesFile = path.resolve(currentWorkingDir, getArg(cliArgs, '--routes', 'src/app/app.routes.ts'));
-  const outputFile = path.resolve(currentWorkingDir, getArg(cliArgs, '--out', 'src/app/presentia-route-namespaces.ts'));
-  const tsconfigFile = path.resolve(currentWorkingDir, getArg(cliArgs, '--tsconfig', 'tsconfig.json'));
-  const localesDirArg = getArg(cliArgs, '--locales', '');
-  const exportName = getArg(cliArgs, '--name', 'PRESENTIA_ROUTE_NAMESPACES');
-  const reportFileArg = getArg(cliArgs, '--report', '');
-  const printReport = cliArgs.includes('--print-report');
-
-  projectRoot = path.resolve(currentWorkingDir, getArg(cliArgs, '--project', path.dirname(routesFile)));
-  localeValidator = createLocaleValidator(localesDirArg ? path.resolve(currentWorkingDir, localesDirArg) : null);
-  generatorReport = createReport();
-
-  visitedFiles.clear();
-  visitedRouteExports.clear();
-
-  if (!fs.existsSync(routesFile)) {
-    fail(`routes file not found: ${routesFile}`);
-  }
-
-  const tsconfig = loadTsconfig(tsconfigFile);
-  const resolver = createPathResolver(routesFile, tsconfig);
-  const routesSource = stripComments(readText(routesFile));
-  const routesArray = extractArrayLiteral(routesSource, /\b(?:const|let|var)\s+\w+\s*:\s*[^=]+=\s*\[/) ??
-    extractArrayLiteral(routesSource, /\b(?:const|let|var)\s+\w+\s*=\s*\[/);
-
-  if (!routesArray) {
-    fail(`unable to find routes array in: ${routesFile}`);
-  }
-
-  const constObjects = parseConstObjects(routesFile, resolver);
-  const imports = parseImports(routesSource);
-  const routes = parseRoutes(routesArray, {
-    constObjects,
-    imports,
-    inheritedNamespaces: [],
-    parentPath: '',
-    resolver,
-    routesFile,
-  });
-  const manifest = toManifest(routes);
-  const content = formatManifest(manifest, exportName);
-  const report = {
-    routesFile,
-    outputFile,
-    routeCount: manifest.size,
-    issueCount: generatorReport.issues.length,
-    issues: generatorReport.issues,
-  };
-
-  fs.mkdirSync(path.dirname(outputFile), { recursive: true });
-  fs.writeFileSync(outputFile, content, 'utf8');
-
-  if (reportFileArg) {
-    const reportFile = path.resolve(currentWorkingDir, reportFileArg);
-
-    fs.mkdirSync(path.dirname(reportFile), { recursive: true });
-    fs.writeFileSync(reportFile, formatReport(report), 'utf8');
-  }
-
-  if (printReport && report.issueCount) {
-    console.warn(formatReport(report));
-  }
-
-  return { manifest, content, outputFile, report };
-}
-
-const isCliEntrypoint = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
-
-if (isCliEntrypoint) {
-  try {
-    const { manifest, outputFile, report } = generateNamespaceManifest();
-
-    console.log(`[presentia-gen-namespaces] Generated ${manifest.size} routes -> ${outputFile}`);
-    if (report.issueCount) {
-      console.warn(`[presentia-gen-namespaces] Reported ${report.issueCount} static-analysis issue(s)`);
-    }
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-}
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+let projectRoot = '';
+let localeValidator = null;
+let generatorReport = null;
+
+const getArg = (args, name, fallback) => {
+  const idx = args.indexOf(name);
+
+  return idx >= 0 && args[idx + 1] ? args[idx + 1] : fallback;
+};
+
+const KEY_RE = /^[a-z0-9_-]+\.[a-z0-9_.-]+$/i;
+const visitedFiles = new Set();
+const visitedRouteExports = new Set();
+
+function fail(message) {
+  throw new Error(`[presentia-gen-namespaces] ${message}`);
+}
+
+function createReport() {
+  return {
+    issues: [],
+    addIssue(issue) {
+      this.issues.push(issue);
+    },
+  };
+}
+
+function readText(filePath) {
+  return fs.readFileSync(filePath, 'utf8');
+}
+
+function tryReadJson(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  return JSON.parse(readText(filePath));
+}
+
+function collectJsonFiles(dir) {
+  const out = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+
+    if (entry.isDirectory()) {
+      out.push(...collectJsonFiles(full));
+      continue;
+    }
+
+    if (entry.isFile() && entry.name.endsWith('.json')) {
+      out.push(full);
+    }
+  }
+
+  return out;
+}
+
+function namespaceFromLocaleFile(filePath) {
+  const base = path.basename(filePath);
+  const parts = base.split('.');
+
+  if (parts.length >= 3) {
+    return parts.slice(0, -2).join('.');
+  }
+
+  return parts.slice(0, -1).join('.');
+}
+
+function flattenLocaleKeys(value, prefix = '') {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return [];
+  }
+
+  const out = [];
+
+  for (const [key, nested] of Object.entries(value)) {
+    const next = prefix ? `${prefix}.${key}` : key;
+
+    if (nested && typeof nested === 'object' && !Array.isArray(nested)) {
+      out.push(...flattenLocaleKeys(nested, next));
+    } else {
+      out.push(next);
+    }
+  }
+
+  return out;
+}
+
+function createLocaleValidator(localesPath) {
+  if (!localesPath) {
+    return null;
+  }
+
+  if (!fs.existsSync(localesPath)) {
+    fail(`locales directory not found: ${localesPath}`);
+  }
+
+  const namespaceSet = new Set();
+  const keySet = new Set();
+
+  for (const file of collectJsonFiles(localesPath)) {
+    const ns = namespaceFromLocaleFile(file);
+
+    if (!ns) {
+      continue;
+    }
+
+    namespaceSet.add(ns);
+
+    try {
+      const json = JSON.parse(readText(file));
+
+      for (const key of flattenLocaleKeys(json)) {
+        keySet.add(`${ns}.${key}`);
+      }
+    } catch {
+      // Ignore malformed locale files in generator mode.
+    }
+  }
+
+  return {
+    hasNamespace(ns) {
+      return namespaceSet.has(ns);
+    },
+    hasKey(key) {
+      return keySet.has(key);
+    },
+  };
+}
+
+function loadTsconfig(filePath, seen = new Set()) {
+  const resolved = path.resolve(filePath);
+
+  if (!fs.existsSync(resolved) || seen.has(resolved)) {
+    return { compilerOptions: {}, _dir: path.dirname(resolved) };
+  }
+
+  seen.add(resolved);
+  const json = JSON.parse(stripComments(readText(resolved)));
+  const base = json.extends
+    ? loadTsconfig(resolveExtendsPath(path.dirname(resolved), json.extends), seen)
+    : { compilerOptions: {}, _dir: path.dirname(resolved) };
+  const compilerOptions = {
+    ...(base.compilerOptions ?? {}),
+    ...(json.compilerOptions ?? {}),
+    paths: {
+      ...((base.compilerOptions && base.compilerOptions.paths) || {}),
+      ...((json.compilerOptions && json.compilerOptions.paths) || {}),
+    },
+  };
+
+  return { ...base, ...json, compilerOptions, _dir: path.dirname(resolved) };
+}
+
+function resolveExtendsPath(baseDir, value) {
+  if (value.startsWith('.')) {
+    return withJsonSuffix(path.resolve(baseDir, value));
+  }
+
+  return withJsonSuffix(path.resolve(baseDir, value));
+}
+
+function withJsonSuffix(filePath) {
+  return filePath.endsWith('.json') ? filePath : `${filePath}.json`;
+}
+
+function stripComments(source) {
+  let out = '';
+  let quote = null;
+  let escape = false;
+
+  for (let i = 0; i < source.length; i++) {
+    const ch = source[i];
+    const next = source[i + 1];
+
+    if (quote) {
+      out += ch;
+
+      if (escape) {
+        escape = false;
+      } else if (ch === '\\') {
+        escape = true;
+      } else if (ch === quote) {
+        quote = null;
+      }
+
+      continue;
+    }
+
+    if (ch === '"' || ch === "'" || ch === '`') {
+      quote = ch;
+      out += ch;
+      continue;
+    }
+
+    if (ch === '/' && next === '/') {
+      while (i < source.length && source[i] !== '\n') {
+        i++;
+      }
+      out += '\n';
+      continue;
+    }
+
+    if (ch === '/' && next === '*') {
+      i += 2;
+      while (i < source.length && !(source[i] === '*' && source[i + 1] === '/')) {
+        i++;
+      }
+      i++;
+      continue;
+    }
+
+    out += ch;
+  }
+
+  return out;
+}
+
+function findMatching(source, start, openChar, closeChar) {
+  let depth = 0;
+  let quote = null;
+  let escape = false;
+
+  for (let i = start; i < source.length; i++) {
+    const ch = source[i];
+    const next = source[i + 1];
+
+    if (quote) {
+      if (escape) {
+        escape = false;
+      } else if (ch === '\\') {
+        escape = true;
+      } else if (ch === quote) {
+        quote = null;
+      }
+      continue;
+    }
+
+    if (ch === '"' || ch === "'" || ch === '`') {
+      quote = ch;
+      continue;
+    }
+
+    if (ch === '/' && next === '/') {
+      while (i < source.length && source[i] !== '\n') {
+        i++;
+      }
+      continue;
+    }
+
+    if (ch === '/' && next === '*') {
+      i += 2;
+      while (i < source.length && !(source[i] === '*' && source[i + 1] === '/')) {
+        i++;
+      }
+      i++;
+      continue;
+    }
+
+    if (ch === openChar) {
+      depth++;
+      continue;
+    }
+
+    if (ch === closeChar) {
+      depth--;
+      if (depth === 0) {
+        return i;
+      }
+    }
+  }
+
+  return -1;
+}
+
+function extractArrayLiteral(source, anchorPattern) {
+  const match = anchorPattern.exec(source);
+
+  if (!match) {
+    return null;
+  }
+
+  const preferredStart = match.index + match[0].length - 1;
+  const start = source[preferredStart] === '[' ? preferredStart : source.indexOf('[', preferredStart);
+  const end = findMatching(source, start, '[', ']');
+
+  if (start < 0 || end < 0) {
+    return null;
+  }
+
+  return source.slice(start, end + 1);
+}
+
+function splitTopLevelItems(arrayLiteral) {
+  const inner = arrayLiteral.trim().replace(/^\[/, '').replace(/\]$/, '');
+  const items = [];
+  let token = '';
+  let depthBrace = 0;
+  let depthBracket = 0;
+  let depthParen = 0;
+  let quote = null;
+  let escape = false;
+
+  for (let i = 0; i < inner.length; i++) {
+    const ch = inner[i];
+    const next = inner[i + 1];
+
+    token += ch;
+
+    if (quote) {
+      if (escape) {
+        escape = false;
+      } else if (ch === '\\') {
+        escape = true;
+      } else if (ch === quote) {
+        quote = null;
+      }
+      continue;
+    }
+
+    if (ch === '"' || ch === "'" || ch === '`') {
+      quote = ch;
+      continue;
+    }
+
+    if (ch === '/' && next === '/') {
+      while (i < inner.length && inner[i] !== '\n') {
+        token += inner[++i] ?? '';
+      }
+      continue;
+    }
+
+    if (ch === '/' && next === '*') {
+      token += inner[++i] ?? '';
+      while (i < inner.length && !(inner[i] === '*' && inner[i + 1] === '/')) {
+        token += inner[++i] ?? '';
+      }
+      token += inner[++i] ?? '';
+      continue;
+    }
+
+    if (ch === '{') depthBrace++;
+    if (ch === '}') depthBrace--;
+    if (ch === '[') depthBracket++;
+    if (ch === ']') depthBracket--;
+    if (ch === '(') depthParen++;
+    if (ch === ')') depthParen--;
+
+    if (ch === ',' && depthBrace === 0 && depthBracket === 0 && depthParen === 0) {
+      const trimmed = token.slice(0, -1).trim();
+      if (trimmed) {
+        items.push(trimmed);
+      }
+      token = '';
+    }
+  }
+
+  const trimmed = token.trim();
+  if (trimmed) {
+    items.push(trimmed);
+  }
+
+  return items;
+}
+
+function extractObjectLiterals(arrayLiteral) {
+  return splitTopLevelItems(arrayLiteral).filter((item) => item.startsWith('{'));
+}
+
+function parseImports(source) {
+  const imports = new Map();
+  const re = /import\s+\{([^}]+)\}\s+from\s+['"]([^'"]+)['"]/g;
+  let match;
+
+  while ((match = re.exec(source))) {
+    const specifier = match[2];
+    const names = match[1]
+      .split(',')
+      .map((part) => part.trim())
+      .filter(Boolean);
+
+    for (const name of names) {
+      const [imported, local] = name.split(/\s+as\s+/);
+
+      imports.set((local ?? imported).trim(), {
+        imported: imported.trim(),
+        specifier,
+      });
+    }
+  }
+
+  return imports;
+}
+
+function resolveFile(basePath) {
+  const candidates = [
+    basePath,
+    `${basePath}.ts`,
+    `${basePath}.tsx`,
+    `${basePath}.js`,
+    `${basePath}.mjs`,
+    path.join(basePath, 'index.ts'),
+    path.join(basePath, 'index.tsx'),
+    path.join(basePath, 'index.js'),
+    path.join(basePath, 'index.mjs'),
+  ];
+
+  return candidates.find((candidate) => fs.existsSync(candidate) && fs.statSync(candidate).isFile()) ?? null;
+}
+
+function createPathResolver(routesFilePath, tsconfig) {
+  const importerDir = path.dirname(routesFilePath);
+  const configBase = path.resolve(tsconfig._dir, tsconfig.compilerOptions?.baseUrl ?? '.');
+  const pathEntries = Object.entries(tsconfig.compilerOptions?.paths ?? {});
+
+  return (specifier, fromFile) => {
+    const fromDir = fromFile ? path.dirname(fromFile) : importerDir;
+
+    if (specifier.startsWith('.')) {
+      return resolveFile(path.resolve(fromDir, specifier));
+    }
+
+    for (const [pattern, targets] of pathEntries) {
+      const matches = matchPathPattern(specifier, pattern);
+
+      if (!matches) {
+        continue;
+      }
+
+      for (const target of targets) {
+        const candidate = target.replace('*', matches);
+        const resolved = resolveFile(path.resolve(configBase, candidate));
+
+        if (resolved) {
+          return resolved;
+        }
+      }
+    }
+
+    return resolveFile(path.resolve(configBase, specifier));
+  };
+}
+
+function matchPathPattern(specifier, pattern) {
+  if (!pattern.includes('*')) {
+    return specifier === pattern ? '' : null;
+  }
+
+  const [prefix, suffix] = pattern.split('*');
+
+  if (!specifier.startsWith(prefix) || !specifier.endsWith(suffix)) {
+    return null;
+  }
+
+  return specifier.slice(prefix.length, specifier.length - suffix.length);
+}
+
+function parseConstObjects(filePath, resolver, cache = new Map()) {
+  if (cache.has(filePath)) {
+    return cache.get(filePath);
+  }
+
+  const source = stripComments(readText(filePath));
+  const objects = new Map();
+  const exportedRe = /export\s+const\s+(\w+)\s*=\s*\{/g;
+  let match;
+
+  while ((match = exportedRe.exec(source))) {
+    const name = match[1];
+    const start = source.indexOf('{', match.index);
+    const end = findMatching(source, start, '{', '}');
+
+    if (start < 0 || end < 0) {
+      continue;
+    }
+
+    const parsed = parseSimpleValueExpression(source.slice(start, end + 1));
+
+    if (parsed && typeof parsed === 'object') {
+      objects.set(name, parsed);
+    }
+  }
+
+  const exportedArrayRe = /export\s+const\s+(\w+)\s*=\s*\[/g;
+
+  while ((match = exportedArrayRe.exec(source))) {
+    const name = match[1];
+    const start = source.indexOf('[', match.index);
+    const end = findMatching(source, start, '[', ']');
+
+    if (start < 0 || end < 0) {
+      continue;
+    }
+
+    const parsed = parseSimpleValueExpression(source.slice(start, end + 1));
+
+    if (Array.isArray(parsed)) {
+      objects.set(name, parsed);
+    }
+  }
+
+  const imports = parseImports(source);
+
+  for (const [localName, imported] of imports) {
+    const resolved = resolver(imported.specifier, filePath);
+
+    if (!resolved) {
+      continue;
+    }
+
+    const nestedObjects = parseConstObjects(resolved, resolver, cache);
+    const importedValue = nestedObjects.get(imported.imported);
+
+    if (importedValue) {
+      objects.set(localName, importedValue);
+    }
+  }
+
+  cache.set(filePath, objects);
+
+  return objects;
+}
+
+function parseSimpleObjectLiteral(source) {
+  const object = {};
+  const inner = source.trim().replace(/^\{/, '').replace(/\}$/, '');
+
+  for (const entry of splitTopLevelItems(`[${inner}]`)) {
+    const idx = entry.indexOf(':');
+
+    if (idx < 0) {
+      continue;
+    }
+
+    const key = entry.slice(0, idx).trim().replace(/^['"]|['"]$/g, '');
+    const valueExpr = entry.slice(idx + 1).trim();
+    const value = parseSimpleValueExpression(valueExpr);
+
+    if (key && value !== null) {
+      object[key] = value;
+    }
+  }
+
+  return object;
+}
+
+function parseSimpleValueExpression(value) {
+  const trimmed = value.trim();
+  const stringLiteral = parseStringLiteral(trimmed);
+
+  if (stringLiteral !== null) {
+    return stringLiteral;
+  }
+
+  if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+    const items = splitTopLevelItems(trimmed)
+      .map((item) => parseSimpleValueExpression(item))
+      .filter((item) => item !== null);
+
+    return items.every((item) => typeof item === 'string') ? items : null;
+  }
+
+  if (trimmed.startsWith('{') && trimmed.endsWith('}')) {
+    return parseSimpleObjectLiteral(trimmed);
+  }
+
+  return null;
+}
+
+function parseStringLiteral(value) {
+  const trimmed = value.trim();
+
+  if ((trimmed.startsWith("'") && trimmed.endsWith("'")) || (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+    return trimmed.slice(1, -1);
+  }
+
+  return null;
+}
+
+function resolvePathExpression(expr, constObjects) {
+  const trimmed = expr.trim();
+  const literal = parseStringLiteral(trimmed);
+
+  if (literal !== null) {
+    return literal;
+  }
+
+  const refMatch = /^(\w+)\.(\w+)$/.exec(trimmed);
+
+  if (!refMatch) {
+    return null;
+  }
+
+  const object = constObjects.get(refMatch[1]);
+
+  if (!object) {
+    return null;
+  }
+
+  return object[refMatch[2]] ?? null;
+}
+
+function resolveConstExpression(expr, constObjects) {
+  const trimmed = expr.trim();
+  const literal = parseSimpleValueExpression(trimmed);
+
+  if (literal !== null) {
+    return literal;
+  }
+
+  if (constObjects.has(trimmed)) {
+    return constObjects.get(trimmed);
+  }
+
+  const refMatch = /^(\w+)\.(\w+)$/.exec(trimmed);
+
+  if (!refMatch) {
+    return null;
+  }
+
+  const object = constObjects.get(refMatch[1]);
+
+  if (!object || typeof object !== 'object') {
+    return null;
+  }
+
+  return object[refMatch[2]] ?? null;
+}
+
+function normalizePathPath(value) {
+  const trimmed = (value ?? '').trim().replace(/^\/+|\/+$/g, '');
+
+  return trimmed;
+}
+
+function joinRoutePath(parentPath, childPath) {
+  const normalizedParent = normalizePathPath(parentPath);
+  const normalizedChild = normalizePathPath(childPath);
+
+  if (!normalizedParent && !normalizedChild) {
+    return '/';
+  }
+
+  if (!normalizedParent) {
+    return `/${normalizedChild}`;
+  }
+
+  if (!normalizedChild) {
+    return `/${normalizedParent}`;
+  }
+
+  return `/${normalizedParent}/${normalizedChild}`;
+}
+
+function extractFieldExpression(objectText, fieldName) {
+  const inner = objectText.trim().replace(/^\{/, '').replace(/\}$/, '');
+
+  for (const entry of splitTopLevelItems(`[${inner}]`)) {
+    const idx = entry.indexOf(':');
+
+    if (idx < 0) {
+      continue;
+    }
+
+    const key = entry.slice(0, idx).trim().replace(/^['"]|['"]$/g, '');
+
+    if (key === fieldName) {
+      return entry.slice(idx + 1).trim();
+    }
+  }
+
+  return null;
+}
+
+function extractChildrenArray(objectText) {
+  const expr = extractFieldExpression(objectText, 'children');
+
+  if (!expr || !expr.startsWith('[')) {
+    return null;
+  }
+
+  return expr;
+}
+
+function extractRouteDataNamespaces(objectText, constObjects, reportContext) {
+  const dataExpr = extractFieldExpression(objectText, 'data');
+
+  if (!dataExpr || !dataExpr.startsWith('{')) {
+    return [];
+  }
+
+  const namespaces = new Set(extractKeyLiterals(dataExpr).filter(isAcceptedKey).map(namespaceFromKey).filter(Boolean));
+  const explicitNamespaces = extractExplicitNamespaceArray(dataExpr, 'presentiaNamespaces', constObjects);
+
+  if (extractFieldExpression(dataExpr, 'presentiaNamespaces') && !explicitNamespaces.length) {
+    generatorReport?.addIssue({
+      type: 'unsupported-data-namespaces',
+      filePath: reportContext.routesFile,
+      routePath: reportContext.fullPath,
+      message: 'Could not statically resolve data.presentiaNamespaces',
+    });
+  }
+
+  for (const ns of explicitNamespaces) {
+    namespaces.add(ns);
+  }
+
+  return [...namespaces];
+}
+
+function extractExplicitNamespaceArray(objectText, fieldName, constObjects) {
+  const expr = extractFieldExpression(objectText, fieldName);
+
+  if (!expr) {
+    return [];
+  }
+
+  const resolved = resolveConstExpression(expr, constObjects);
+
+  if (!Array.isArray(resolved)) {
+    return [];
+  }
+
+  return resolved.map((value) => String(value).trim()).filter(isAcceptedNamespace);
+}
+
+function parseLoadComponent(objectText) {
+  return parseLazyImportExpression(extractFieldExpression(objectText, 'loadComponent'));
+}
+
+function parseLoadChildren(objectText) {
+  return parseLazyImportExpression(extractFieldExpression(objectText, 'loadChildren'));
+}
+
+function parseLazyImportExpression(expr) {
+
+  if (!expr) {
+    return null;
+  }
+
+  const importMatch = /import\(\s*['"]([^'"]+)['"]\s*\)/.exec(expr);
+  const exportMatch = /\.([A-Za-z0-9_]+)\s*\)?\s*$/.exec(expr);
+
+  if (!importMatch || !exportMatch) {
+    return null;
+  }
+
+  return { specifier: importMatch[1], exportName: exportMatch[1] };
+}
+
+function parseRoutes(arrayLiteral, context) {
+  const routes = [];
+
+  for (const objectText of extractObjectLiterals(arrayLiteral)) {
+    const pathExpr = extractFieldExpression(objectText, 'path');
+    const redirectExpr = extractFieldExpression(objectText, 'redirectTo');
+    const pathValue = pathExpr ? resolvePathExpression(pathExpr, context.constObjects) : null;
+    const ownPath = normalizePathPath(pathValue ?? '');
+    const fullPath = joinRoutePath(context.parentPath, ownPath);
+    const routeDataNamespaces = extractRouteDataNamespaces(objectText, context.constObjects, {
+      routesFile: context.routesFile,
+      fullPath,
+    });
+    const componentRefs = [];
+    const componentExpr = extractFieldExpression(objectText, 'component');
+
+    if (componentExpr) {
+      const localName = componentExpr.trim();
+      const imported = context.imports.get(localName);
+
+      if (imported) {
+        const resolved = context.resolver(imported.specifier, context.routesFile);
+
+        if (!resolved) {
+          generatorReport?.addIssue({
+            type: 'unresolved-component',
+            filePath: context.routesFile,
+            routePath: fullPath,
+            message: `Could not resolve component import "${imported.specifier}"`,
+          });
+        }
+
+        componentRefs.push({
+          filePath: resolved,
+          exportName: imported.imported,
+        });
+      }
+    }
+
+    const lazyComponent = parseLoadComponent(objectText);
+    if (lazyComponent) {
+      const resolved = context.resolver(lazyComponent.specifier, context.routesFile);
+
+      if (!resolved) {
+        generatorReport?.addIssue({
+          type: 'unresolved-load-component',
+          filePath: context.routesFile,
+          routePath: fullPath,
+          message: `Could not resolve loadComponent import "${lazyComponent.specifier}"`,
+        });
+      }
+
+      componentRefs.push({
+        filePath: resolved,
+        exportName: lazyComponent.exportName,
+      });
+    }
+
+    const lazyChildren = parseLoadChildren(objectText);
+
+    const componentNamespaces = componentRefs.flatMap((componentRef) =>
+      componentRef.filePath ? collectComponentNamespaces(componentRef.filePath, componentRef.exportName, context) : [],
+    );
+    const inheritedNamespaces = unique([...context.inheritedNamespaces, ...componentNamespaces, ...routeDataNamespaces]);
+    const childrenArray = extractChildrenArray(objectText);
+
+    if (childrenArray) {
+      routes.push(
+        ...parseRoutes(childrenArray, {
+          ...context,
+          parentPath: fullPath,
+          inheritedNamespaces,
+        }),
+      );
+    }
+
+    if (lazyChildren) {
+      const childRoutesFile = context.resolver(lazyChildren.specifier, context.routesFile);
+
+      if (childRoutesFile) {
+        routes.push(
+          ...parseRoutesFromExport(childRoutesFile, lazyChildren.exportName, {
+            ...context,
+            inheritedNamespaces,
+            parentPath: fullPath,
+            routesFile: childRoutesFile,
+          }),
+        );
+      } else {
+        generatorReport?.addIssue({
+          type: 'unresolved-load-children',
+          filePath: context.routesFile,
+          routePath: fullPath,
+          message: `Could not resolve loadChildren import "${lazyChildren.specifier}"`,
+        });
+      }
+    }
+
+    const isConcreteRoute = !redirectExpr && (componentRefs.length > 0 || routeDataNamespaces.length > 0);
+
+    if (isConcreteRoute) {
+      routes.push({
+        path: fullPath,
+        namespaces: inheritedNamespaces,
+      });
+    }
+  }
+
+  return routes;
+}
+
+function parseRoutesFromExport(filePath, exportName, context) {
+  const visitKey = `${filePath}#${exportName}#${context.parentPath}`;
+
+  if (visitedRouteExports.has(visitKey)) {
+    return [];
+  }
+
+  visitedRouteExports.add(visitKey);
+
+  const source = stripComments(readText(filePath));
+  const arrayLiteral =
+    extractArrayLiteral(source, new RegExp(`\\bexport\\s+const\\s+${exportName}\\s*:\\s*[^=]+=\\s*\\[`, 'g')) ??
+    extractArrayLiteral(source, new RegExp(`\\bexport\\s+const\\s+${exportName}\\s*=\\s*\\[`, 'g'));
+
+  if (!arrayLiteral) {
+    return [];
+  }
+
+  return parseRoutes(arrayLiteral, {
+    ...context,
+    constObjects: parseConstObjects(filePath, context.resolver),
+    imports: parseImports(source),
+    routesFile: filePath,
+  });
+}
+
+function collectComponentNamespaces(filePath, exportName, context) {
+  const key = `${filePath}#${exportName}`;
+
+  if (visitedFiles.has(key) || !filePath || !fs.existsSync(filePath)) {
+    return [];
+  }
+
+  visitedFiles.add(key);
+
+  const source = stripComments(readText(filePath));
+  const imports = parseImports(source);
+  const namespaces = new Set(collectNamespacesFromCode(source));
+
+  for (const htmlContent of extractTemplateContents(source, filePath)) {
+    for (const ns of collectNamespacesFromTemplate(htmlContent)) {
+      namespaces.add(ns);
+    }
+  }
+
+  for (const importedName of extractStandaloneImports(source)) {
+    const imported = imports.get(importedName);
+
+    if (!imported) {
+      generatorReport?.addIssue({
+        type: 'unsupported-standalone-import',
+        filePath,
+        exportName,
+        message: `Could not resolve standalone import "${importedName}" from component imports`,
+      });
+      continue;
+    }
+
+    const resolved = context.resolver(imported.specifier, filePath);
+
+    if (!resolved || !resolved.startsWith(projectRoot)) {
+      continue;
+    }
+
+    for (const ns of collectComponentNamespaces(resolved, imported.imported, context)) {
+      namespaces.add(ns);
+    }
+  }
+
+  return [...namespaces];
+}
+
+function extractTemplateContents(source, filePath) {
+  const contents = [];
+  const templateUrlRe = /templateUrl\s*:\s*['"]([^'"]+)['"]/g;
+  let match;
+
+  while ((match = templateUrlRe.exec(source))) {
+    const resolved = resolveFile(path.resolve(path.dirname(filePath), match[1]));
+
+    if (resolved) {
+      contents.push(readText(resolved));
+    }
+  }
+
+  const templateRe = /template\s*:\s*(`[\s\S]*?`|'(?:\\.|[^'])*'|"(?:\\.|[^"])*")/g;
+
+  while ((match = templateRe.exec(source))) {
+    const raw = match[1];
+
+    if (raw.startsWith('`')) {
+      contents.push(raw.slice(1, -1));
+    } else {
+      contents.push(raw.slice(1, -1));
+    }
+  }
+
+  return contents;
+}
+
+function extractStandaloneImports(source) {
+  const importsArray = extractArrayLiteral(source, /\bimports\s*:/g);
+
+  if (!importsArray) {
+    return [];
+  }
+
+  return splitTopLevelItems(importsArray)
+    .map((item) => item.replace(/\s/g, ''))
+    .filter((item) => /^[A-Za-z_][A-Za-z0-9_]*$/.test(item));
+}
+
+function collectNamespacesFromTemplate(content) {
+  const namespaces = new Set();
+  const langPipeRe = /['"`]([A-Za-z0-9_.-]+)['"`]\s*\|\s*lang\b/g;
+  const methodLikeRe = /\[\s*reLang(?:Key)?\s*\]\s*=\s*['"`]([^'"`]+)['"`]/g;
+  const tagWithReLangRe = /<[^>]*\breLang\b[^>]*>/g;
+  const reLangAttrsBindings = extractBindingExpressions(content, 'reLangAttrs');
+  const reLangConfigBindings = extractBindingExpressions(content, 'reLang');
+  let match;
+
+  while ((match = langPipeRe.exec(content))) {
+    const ns = acceptedNamespaceFromKey(match[1]);
+    if (ns) namespaces.add(ns);
+  }
+
+  while ((match = methodLikeRe.exec(content))) {
+    const ns = acceptedNamespaceFromKey(match[1]);
+    if (ns) namespaces.add(ns);
+  }
+
+  while ((match = tagWithReLangRe.exec(content))) {
+    for (const key of extractKeyLiterals(match[0])) {
+      const ns = acceptedNamespaceFromKey(key);
+      if (ns) namespaces.add(ns);
+    }
+  }
+
+  for (const expr of reLangAttrsBindings) {
+    const parsed = parseSimpleValueExpression(expr);
+
+    if (!parsed || typeof parsed !== 'object') {
+      continue;
+    }
+
+    for (const value of Object.values(parsed)) {
+      if (typeof value !== 'string') {
+        continue;
+      }
+
+      const ns = acceptedNamespaceFromKey(value);
+      if (ns) namespaces.add(ns);
+    }
+  }
+
+  for (const expr of reLangConfigBindings) {
+    const parsed = parseSimpleValueExpression(expr);
+
+    if (!parsed || typeof parsed !== 'object') {
+      continue;
+    }
+
+    if (typeof parsed.textKey === 'string') {
+      const ns = acceptedNamespaceFromKey(parsed.textKey);
+      if (ns) namespaces.add(ns);
+    }
+
+    if (parsed.attrs && typeof parsed.attrs === 'object') {
+      for (const value of Object.values(parsed.attrs)) {
+        if (typeof value !== 'string') {
+          continue;
+        }
+
+        const ns = acceptedNamespaceFromKey(value);
+        if (ns) namespaces.add(ns);
+      }
+    }
+  }
+
+  return [...namespaces];
+}
+
+function extractBindingExpressions(content, bindingName) {
+  const out = [];
+  const re = new RegExp(`\\[\\s*${bindingName}\\s*\\]\\s*=\\s*([\"'])([\\s\\S]*?)\\1`, 'g');
+  let match;
+
+  while ((match = re.exec(content))) {
+    out.push(match[2]);
+  }
+
+  return out;
+}
+
+function collectNamespacesFromCode(content) {
+  const namespaces = new Set();
+  const methodRe = /\.\s*(?:get|observe|translate)\s*\(\s*['"`]([^'"`]+)['"`]/g;
+  let match;
+
+  while ((match = methodRe.exec(content))) {
+    const ns = acceptedNamespaceFromKey(match[1]);
+    if (ns) namespaces.add(ns);
+  }
+
+  return [...namespaces];
+}
+
+function extractKeyLiterals(content) {
+  const out = [];
+  const re = /['"`]([A-Za-z0-9_.-]+)['"`]/g;
+  let match;
+
+  while ((match = re.exec(content))) {
+    if (KEY_RE.test(match[1])) {
+      out.push(match[1]);
+    }
+  }
+
+  return out;
+}
+
+function namespaceFromKey(key) {
+  if (!KEY_RE.test(key)) {
+    return null;
+  }
+
+  const [ns] = key.split('.', 1);
+
+  return ns || null;
+}
+
+function acceptedNamespaceFromKey(key) {
+  if (!isAcceptedKey(key)) {
+    return null;
+  }
+
+  return namespaceFromKey(key);
+}
+
+function isAcceptedKey(key) {
+  if (!KEY_RE.test(key)) {
+    return false;
+  }
+
+  if (!localeValidator) {
+    return true;
+  }
+
+  return localeValidator.hasKey(key);
+}
+
+function isAcceptedNamespace(ns) {
+  if (!ns) {
+    return false;
+  }
+
+  if (!localeValidator) {
+    return true;
+  }
+
+  return localeValidator.hasNamespace(ns);
+}
+
+function unique(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+
+function toManifest(routes) {
+  const manifest = new Map();
+
+  for (const route of routes) {
+    if (!route.namespaces.length) {
+      continue;
+    }
+
+    const existing = manifest.get(route.path) ?? [];
+
+    manifest.set(route.path, unique([...existing, ...route.namespaces]).sort());
+  }
+
+  return manifest;
+}
+
+function formatManifest(manifest, name) {
+  const entries = [...manifest.entries()].sort(([a], [b]) => a.localeCompare(b));
+  const lines = entries.map(([routePath, namespaces]) => {
+    const nsList = namespaces.map((ns) => `'${ns}'`).join(', ');
+
+    return `  '${routePath}': [${nsList}],`;
+  });
+
+  return `/* auto-generated by presentia-gen-namespaces */\nexport const ${name} = {\n${lines.join('\n')}\n} as const;\n`;
+}
+
+function formatReport(report) {
+  return JSON.stringify(report, null, 2);
+}
+
+export function generateNamespaceManifest(cliArgs = process.argv.slice(2), currentWorkingDir = process.cwd()) {
+  const routesFile = path.resolve(currentWorkingDir, getArg(cliArgs, '--routes', 'src/app/app.routes.ts'));
+  const outputFile = path.resolve(currentWorkingDir, getArg(cliArgs, '--out', 'src/app/presentia-route-namespaces.ts'));
+  const tsconfigFile = path.resolve(currentWorkingDir, getArg(cliArgs, '--tsconfig', 'tsconfig.json'));
+  const localesDirArg = getArg(cliArgs, '--locales', '');
+  const exportName = getArg(cliArgs, '--name', 'PRESENTIA_ROUTE_NAMESPACES');
+  const reportFileArg = getArg(cliArgs, '--report', '');
+  const printReport = cliArgs.includes('--print-report');
+
+  projectRoot = path.resolve(currentWorkingDir, getArg(cliArgs, '--project', path.dirname(routesFile)));
+  localeValidator = createLocaleValidator(localesDirArg ? path.resolve(currentWorkingDir, localesDirArg) : null);
+  generatorReport = createReport();
+
+  visitedFiles.clear();
+  visitedRouteExports.clear();
+
+  if (!fs.existsSync(routesFile)) {
+    fail(`routes file not found: ${routesFile}`);
+  }
+
+  const tsconfig = loadTsconfig(tsconfigFile);
+  const resolver = createPathResolver(routesFile, tsconfig);
+  const routesSource = stripComments(readText(routesFile));
+  const routesArray = extractArrayLiteral(routesSource, /\b(?:const|let|var)\s+\w+\s*:\s*[^=]+=\s*\[/) ??
+    extractArrayLiteral(routesSource, /\b(?:const|let|var)\s+\w+\s*=\s*\[/);
+
+  if (!routesArray) {
+    fail(`unable to find routes array in: ${routesFile}`);
+  }
+
+  const constObjects = parseConstObjects(routesFile, resolver);
+  const imports = parseImports(routesSource);
+  const routes = parseRoutes(routesArray, {
+    constObjects,
+    imports,
+    inheritedNamespaces: [],
+    parentPath: '',
+    resolver,
+    routesFile,
+  });
+  const manifest = toManifest(routes);
+  const content = formatManifest(manifest, exportName);
+  const report = {
+    routesFile,
+    outputFile,
+    routeCount: manifest.size,
+    issueCount: generatorReport.issues.length,
+    issues: generatorReport.issues,
+  };
+
+  fs.mkdirSync(path.dirname(outputFile), { recursive: true });
+  fs.writeFileSync(outputFile, content, 'utf8');
+
+  if (reportFileArg) {
+    const reportFile = path.resolve(currentWorkingDir, reportFileArg);
+
+    fs.mkdirSync(path.dirname(reportFile), { recursive: true });
+    fs.writeFileSync(reportFile, formatReport(report), 'utf8');
+  }
+
+  if (printReport && report.issueCount) {
+    console.warn(formatReport(report));
+  }
+
+  return { manifest, content, outputFile, report };
+}
+
+const isCliEntrypoint = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+
+if (isCliEntrypoint) {
+  try {
+    const { manifest, outputFile, report } = generateNamespaceManifest();
+
+    console.log(`[presentia-gen-namespaces] Generated ${manifest.size} routes -> ${outputFile}`);
+    if (report.issueCount) {
+      console.warn(`[presentia-gen-namespaces] Reported ${report.issueCount} static-analysis issue(s)`);
+    }
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}