npm - @emeryld/rrroutes-contract - Versions diffs - 2.7.6 → 2.7.7 - Mend

@emeryld/rrroutes-contract 2.7.6 → 2.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +1 -0
package/dist/export/defaultViewerTemplate.d.ts +1 -1
package/dist/export/exportFinalizedLeaves.d.ts +7 -1
package/dist/export/extractLeafSourceByAst.d.ts +8 -0
package/dist/index.cjs +247 -82
package/dist/index.cjs.map +1 -1
package/dist/index.mjs +247 -82
package/dist/index.mjs.map +1 -1
package/package.json +1 -1
package/tools/finalized-leaves-viewer.html +18 -7

package/README.md CHANGED Viewed

@@ -390,6 +390,7 @@ const payload = await exportFinalizedLeaves(registry, {
 `payload` contains:
 - `_meta`: export/documentation metadata
+  - when source extraction is enabled, `_meta.sourceExtraction` also includes diagnostics (`reason`, `stats`)
 - `leaves`: contract-native serialized leaves
 - `schemaFlatByLeaf`: flattened schema map per leaf
 - `sourceByLeaf` (when `includeSource` is true): AST-derived definition + schema source metadata keyed by `METHOD path`

package/dist/export/defaultViewerTemplate.d.ts CHANGED Viewed

	@@ -1 +1 @@
1	- export declare const DEFAULT_VIEWER_TEMPLATE = "<!doctype html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>Finalized Leaves Viewer</title>\n <style>\n :root {\n --bg: #f5f7fb;\n --surface: #ffffff;\n --border: #d6ddea;\n --text: #172033;\n --muted: #5b6680;\n --accent: #1858c6;\n }\n body {\n margin: 0;\n font-family: 'Iosevka Web', 'SFMono-Regular', Menlo, Consolas, monospace;\n color: var(--text);\n background: linear-gradient(180deg, var(--bg), #eef2fa);\n }\n .wrap { max-width: 1100px; margin: 0 auto; padding: 20px; }\n .card { background: var(--surface); border: 1px solid var(--border); border-radius: 12px; padding: 14px; }\n .meta { color: var(--muted); font-size: 12px; }\n #results { margin-top: 12px; display: grid; gap: 8px; }\n details { background: var(--surface); border: 1px solid var(--border); border-radius: 10px; padding: 8px 10px; }\n summary { cursor: pointer; font-weight: 700; color: var(--accent); }\n pre { margin: 10px 0 0; overflow: auto; border: 1px solid var(--border); border-radius: 8px; padding: 10px; background: #fafcff; }\n </style>\n </head>\n <body>\n <div class=\"wrap\">\n <h1>Finalized Leaves Viewer (Baked)</h1>\n <div class=\"card\">\n <div id=\"status\" class=\"meta\">Waiting for baked payload...</div>\n </div>\n <div id=\"results\"></div>\n </div>\n\n <!--__FINALIZED_LEAVES_BAKED_PAYLOAD__-->\n\n <script>\n const statusEl = document.getElementById('status')\n const resultsEl = document.getElementById('results')\n const payload = window.__FINALIZED_LEAVES_PAYLOAD\n\n if (!payload \|\| !Array.isArray(payload.leaves)) {\n statusEl.textContent = 'No baked payload found in this HTML file.'\n } else {\n statusEl.textContent = 'Loaded baked payload with ' + payload.leaves.length + ' routes.'\n\n const toHref = (source) => {\n if (!source \|\| !source.file) return null\n const normalizedPath = String(source.file).replace(/\\\\/g, '/')\n const prefix = normalizedPath.startsWith('/') ? 'file://' : 'file:///'\n return prefix + encodeURI(normalizedPath)\n }\n\n payload.leaves.forEach((leaf) => {\n const details = document.createElement('details')\n const summary = document.createElement('summary')\n summary.textContent = String(leaf.method \|\| '').toUpperCase() + ' ' + (leaf.path \|\| '')\n\n const pre = document.createElement('pre')\n pre.textContent = JSON.stringify(leaf, null, 2)\n\n const source = payload.sourceByLeaf && payload.sourceByLeaf[leaf.key]\n let sourceWrap = null\n if (source) {\n sourceWrap = document.createElement('div')\n sourceWrap.className = 'meta'\n\n const definitionHref = toHref(source.definition)\n if (definitionHref) {\n const label = document.createElement('div')\n const link = document.createElement('a')\n link.href = definitionHref\n link.target = '_blank'\n link.rel = 'noopener noreferrer'\n link.textContent =\n '~~definition:~~ ' +\n source.definition.file +\n ':' +\n source.definition.line +\n ':' +\n source.definition.column\n label.appendChild(~~link~~)\n sourceWrap.appendChild(label)\n }\n\n if (source.schemas && typeof source.schemas === 'object') {\n Object.entries(source.schemas).forEach(([name, schema]) => {\n if (!schema) return\n const href = toHref(schema)\n const row = document.createElement('div')\n if (href) {\n const link = document.createElement('a')\n link.href = href\n link.target = '_blank'\n link.rel = 'noopener noreferrer'\n link.textContent =\n name ~~+\n~~ ': ' ~~+\n~~ (schema.sourceName \|\| schema.tag \|\| '<anonymous>') +\n ' (' ~~+\n~~ schema.file ~~+\n~~ ':' ~~+\n~~ schema.line ~~+\n~~ ':' ~~+\n~~ schema.column ~~+\n~~ ')'\n row.appendChild(~~link~~)\n } else {\n row.textContent = name + ': ' + (schema.sourceName \|\| schema.tag \|\| '<anonymous>')\n }\n sourceWrap.appendChild(row)\n })\n }\n\n }\n\n details.appendChild(summary)\n if (sourceWrap) details.appendChild(sourceWrap)\n details.appendChild(pre)\n resultsEl.appendChild(details)\n })\n }\n </script>\n </body>\n</html>\n";
1	+ export declare const DEFAULT_VIEWER_TEMPLATE = "<!doctype html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>Finalized Leaves Viewer</title>\n <style>\n :root {\n --bg: #f5f7fb;\n --surface: #ffffff;\n --border: #d6ddea;\n --text: #172033;\n --muted: #5b6680;\n --accent: #1858c6;\n }\n body {\n margin: 0;\n font-family: 'Iosevka Web', 'SFMono-Regular', Menlo, Consolas, monospace;\n color: var(--text);\n background: linear-gradient(180deg, var(--bg), #eef2fa);\n }\n .wrap { max-width: 1100px; margin: 0 auto; padding: 20px; }\n .card { background: var(--surface); border: 1px solid var(--border); border-radius: 12px; padding: 14px; }\n .meta { color: var(--muted); font-size: 12px; }\n #results { margin-top: 12px; display: grid; gap: 8px; }\n details { background: var(--surface); border: 1px solid var(--border); border-radius: 10px; padding: 8px 10px; }\n summary { cursor: pointer; font-weight: 700; color: var(--accent); }\n pre { margin: 10px 0 0; overflow: auto; border: 1px solid var(--border); border-radius: 8px; padding: 10px; background: #fafcff; }\n </style>\n </head>\n <body>\n <div class=\"wrap\">\n <h1>Finalized Leaves Viewer (Baked)</h1>\n <div class=\"card\">\n <div id=\"status\" class=\"meta\">Waiting for baked payload...</div>\n </div>\n <div id=\"results\"></div>\n </div>\n\n <!--__FINALIZED_LEAVES_BAKED_PAYLOAD__-->\n\n <script>\n const statusEl = document.getElementById('status')\n const resultsEl = document.getElementById('results')\n const payload = window.__FINALIZED_LEAVES_PAYLOAD\n\n if (!payload \|\| !Array.isArray(payload.leaves)) {\n statusEl.textContent = 'No baked payload found in this HTML file.'\n } else {\n statusEl.textContent = 'Loaded baked payload with ' + payload.leaves.length + ' routes.'\n\n const toHref = (source) => {\n if (!source \|\| !source.file) return null\n const normalizedPath = String(source.file).replace(/\\\\/g, '/')\n const prefix = normalizedPath.startsWith('/') ? 'file://' : 'file:///'\n return prefix + encodeURI(normalizedPath)\n }\n\n payload.leaves.forEach((leaf) => {\n const details = document.createElement('details')\n const summary = document.createElement('summary')\n summary.textContent = String(leaf.method \|\| '').toUpperCase() + ' ' + (leaf.path \|\| '')\n\n const pre = document.createElement('pre')\n pre.textContent = JSON.stringify(leaf, null, 2)\n\n const source = payload.sourceByLeaf && payload.sourceByLeaf[leaf.key]\n let sourceWrap = null\n if (source) {\n sourceWrap = document.createElement('div')\n sourceWrap.className = 'meta'\n\n const definitionHref = toHref(source.definition)\n if (definitionHref) {\n const label = document.createElement('div')\n const link = document.createElement('a')\n link.href = definitionHref\n link.target = '_blank'\n link.rel = 'noopener noreferrer'\n link.textContent = 'definition'\n label.appendChild(link)\n const location = document.createElement('span')\n location.textContent =\n ' (' +\n source.definition.file +\n ':' +\n source.definition.line +\n ':' +\n source.definition.column +\n ')'\n label.appendChild(location)\n sourceWrap.appendChild(label)\n }\n\n if (source.schemas && typeof source.schemas === 'object') {\n Object.entries(source.schemas).forEach(([name, schema]) => {\n if (!schema) return\n const href = toHref(schema)\n const row = document.createElement('div')\n if (href) {\n const link = document.createElement('a')\n link.href = href\n link.target = '_blank'\n link.rel = 'noopener noreferrer'\n link.textContent =\n name + ': ' + (schema.sourceName \|\| schema.tag \|\| '<anonymous>')\n row.appendChild(link)\n const location = document.createElement('span')\n location.textContent =\n ' (' + schema.file + ':' + schema.line + ':' + schema.column + ')'\n row.appendChild(location)\n } else {\n row.textContent = name + ': ' + (schema.sourceName \|\| schema.tag \|\| '<anonymous>')\n }\n sourceWrap.appendChild(row)\n })\n }\n\n }\n\n details.appendChild(summary)\n if (sourceWrap) details.appendChild(sourceWrap)\n details.appendChild(pre)\n resultsEl.appendChild(details)\n })\n }\n </script>\n </body>\n</html>\n";

package/dist/export/exportFinalizedLeaves.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import type { AnyLeafLowProfile } from '../core/routesV3.core';
 import type { FinalizedRegistry } from '../core/routesV3.finalize';
 import { type FlatSchemaMap } from './flattenSchema';
 import { type SerializeLeafContractOptions, type SerializedLeafContract } from './serializeLeafContract';
-import { type LeafSourceByKey } from './extractLeafSourceByAst';
+import { type LeafSourceByKey, type SourceExtractionReason } from './extractLeafSourceByAst';
 export type ExportFinalizedLeavesInput = readonly AnyLeafLowProfile[] | FinalizedRegistry<readonly AnyLeafLowProfile[]>;
 export type ExportFinalizedLeavesMeta = {
     generatedAt: string;
@@ -14,6 +14,12 @@ export type ExportFinalizedLeavesMeta = {
         exportName?: string;
         tsconfigPath?: string;
         resolvedLeafCount: number;
+        reason?: SourceExtractionReason;
+        stats?: {
+            visitedSymbols: number;
+            visitedFiles: number;
+            unresolvedReferences: number;
+        };
     };
     fieldCatalog: {
         leaf: string[];

package/dist/export/extractLeafSourceByAst.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 declare const SCHEMA_KEYS: readonly ["bodySchema", "querySchema", "paramsSchema", "outputSchema", "outputMetaSchema", "queryExtensionSchema"];
+export type SourceExtractionReason = 'module_not_in_program' | 'export_not_found' | 'unsupported_expression_shape' | 'resolved_zero_leaves';
 type SchemaKey = (typeof SCHEMA_KEYS)[number];
 export type LeafSourceLocation = {
     file: string;
@@ -22,9 +23,16 @@ export type ExtractLeafSourceByAstOptions = {
     tsconfigPath?: string;
     cwd?: string;
 };
+export type ExtractLeafSourceByAstStats = {
+    visitedSymbols: number;
+    visitedFiles: number;
+    unresolvedReferences: number;
+};
 export type ExtractLeafSourceByAstResult = {
     sourceByLeaf: LeafSourceByKey;
     tsconfigPath?: string;
+    reason?: SourceExtractionReason;
+    stats: ExtractLeafSourceByAstStats;
 };
 export declare function extractLeafSourceByAst({ modulePath, exportName, tsconfigPath, cwd, }: ExtractLeafSourceByAstOptions): ExtractLeafSourceByAstResult;
 export {};

package/dist/index.cjs CHANGED Viewed

@@ -825,14 +825,18 @@ var DEFAULT_VIEWER_TEMPLATE = `<!doctype html>
               link.href = definitionHref
               link.target = '_blank'
               link.rel = 'noopener noreferrer'
-              link.textContent =
-                'definition: ' +
+              link.textContent = 'definition'
+              label.appendChild(link)
+              const location = document.createElement('span')
+              location.textContent =
+                ' (' +
                 source.definition.file +
                 ':' +
                 source.definition.line +
                 ':' +
-                source.definition.column
-              label.appendChild(link)
+                source.definition.column +
+                ')'
+              label.appendChild(location)
               sourceWrap.appendChild(label)
             }
@@ -847,17 +851,12 @@ var DEFAULT_VIEWER_TEMPLATE = `<!doctype html>
                   link.target = '_blank'
                   link.rel = 'noopener noreferrer'
                   link.textContent =
-                    name +
-                    ': ' +
-                    (schema.sourceName || schema.tag || '<anonymous>') +
-                    ' (' +
-                    schema.file +
-                    ':' +
-                    schema.line +
-                    ':' +
-                    schema.column +
-                    ')'
+                    name + ': ' + (schema.sourceName || schema.tag || '<anonymous>')
                   row.appendChild(link)
+                  const location = document.createElement('span')
+                  location.textContent =
+                    ' (' + schema.file + ':' + schema.line + ':' + schema.column + ')'
+                  row.appendChild(location)
                 } else {
                   row.textContent = name + ': ' + (schema.sourceName || schema.tag || '<anonymous>')
                 }
@@ -890,6 +889,7 @@ var SCHEMA_KEYS = [
   "queryExtensionSchema"
 ];
 var HTTP_METHODS = /* @__PURE__ */ new Set(["get", "post", "put", "patch", "delete"]);
+var MAX_RECURSION_DEPTH = 120;
 function toLocation(node) {
   const sourceFile = node.getSourceFile();
   const { line, character } = sourceFile.getLineAndCharacterOfPosition(
@@ -901,6 +901,10 @@ function toLocation(node) {
     column: character + 1
   };
 }
+function markFile(ctx, sourceFile) {
+  if (!sourceFile) return;
+  ctx.visitedFilePaths.add(import_node_path.default.resolve(sourceFile.fileName));
+}
 function trimPreview(text, max = 80) {
   const normalized = text.replace(/\s+/g, " ").trim();
   return normalized.length > max ? `${normalized.slice(0, max)}...` : normalized;
@@ -958,7 +962,7 @@ function findSourceFile(program, filePath) {
   const normalizedWanted = import_node_path.default.normalize(wanted);
   return program.getSourceFiles().find((file) => import_node_path.default.normalize(import_node_path.default.resolve(file.fileName)) === normalizedWanted);
 }
-function expressionFromDeclaration(declaration) {
+function declarationToExpression(declaration) {
   if (!declaration) return void 0;
   if (import_typescript.default.isVariableDeclaration(declaration)) {
     return declaration.initializer;
@@ -975,14 +979,95 @@ function expressionFromDeclaration(declaration) {
   if (import_typescript.default.isBindingElement(declaration)) {
     return declaration.initializer;
   }
+  if (import_typescript.default.isEnumMember(declaration)) {
+    return declaration.initializer;
+  }
   return void 0;
 }
-function resolveIdentifierExpression(identifier, ctx) {
-  const symbol = ctx.checker.getSymbolAtLocation(identifier);
-  if (!symbol) return void 0;
+function symbolKey(symbol) {
+  const decl = symbol.declarations?.[0];
+  if (!decl) return `${symbol.getName()}#${symbol.flags}`;
+  const file = import_node_path.default.resolve(decl.getSourceFile().fileName);
+  return `${file}:${decl.getStart()}:${symbol.getName()}`;
+}
+function resolveSymbolFromNode(node, ctx) {
+  const symbol = ctx.checker.getSymbolAtLocation(node);
+  if (!symbol) {
+    ctx.unresolvedReferences += 1;
+    return void 0;
+  }
   const target = getAliasedSymbolIfNeeded(ctx.checker, symbol);
-  const declaration = target.declarations?.[0];
-  return expressionFromDeclaration(declaration);
+  const key = symbolKey(target);
+  ctx.visitedSymbolKeys.add(key);
+  return target;
+}
+function getExpressionFromSymbol(symbol, ctx, depth) {
+  const key = symbolKey(symbol);
+  if (ctx.activeSymbols.has(key)) return void 0;
+  if (depth > MAX_RECURSION_DEPTH) return void 0;
+  ctx.activeSymbols.add(key);
+  try {
+    const declaration = symbol.declarations?.[0];
+    markFile(ctx, declaration?.getSourceFile());
+    const direct = declarationToExpression(declaration);
+    if (direct) return direct;
+    if (declaration && import_typescript.default.isImportSpecifier(declaration)) {
+      const target = getAliasedSymbolIfNeeded(ctx.checker, symbol);
+      if (target !== symbol) {
+        return getExpressionFromSymbol(target, ctx, depth + 1);
+      }
+    }
+    return void 0;
+  } finally {
+    ctx.activeSymbols.delete(key);
+  }
+}
+function resolveIdentifierExpression(identifier, ctx, depth) {
+  const symbol = resolveSymbolFromNode(identifier, ctx);
+  if (!symbol) return void 0;
+  return getExpressionFromSymbol(symbol, ctx, depth);
+}
+function resolvePropertyExpression(expression, ctx, depth) {
+  if (depth > MAX_RECURSION_DEPTH) return void 0;
+  if (import_typescript.default.isPropertyAccessExpression(expression)) {
+    const symbol = resolveSymbolFromNode(expression.name, ctx);
+    if (symbol) {
+      const fromSymbol = getExpressionFromSymbol(symbol, ctx, depth + 1);
+      if (fromSymbol) return fromSymbol;
+    }
+  } else if (expression.argumentExpression) {
+    const symbol = resolveSymbolFromNode(expression.argumentExpression, ctx);
+    if (symbol) {
+      const fromSymbol = getExpressionFromSymbol(symbol, ctx, depth + 1);
+      if (fromSymbol) return fromSymbol;
+    }
+  }
+  const ownerExpr = evaluateExpressionReference(expression.expression, ctx, depth + 1);
+  const owner = ownerExpr ? maybeObjectLiteral(ownerExpr, ctx, depth + 1) : void 0;
+  if (!owner) return void 0;
+  const propName = import_typescript.default.isPropertyAccessExpression(expression) ? expression.name.text : expression.argumentExpression && import_typescript.default.isStringLiteralLike(expression.argumentExpression) ? expression.argumentExpression.text : void 0;
+  if (!propName) return void 0;
+  for (const property of owner.properties) {
+    if (import_typescript.default.isPropertyAssignment(property) && getTextName(property.name) === propName) {
+      return property.initializer;
+    }
+    if (import_typescript.default.isShorthandPropertyAssignment(property) && property.name.text === propName) {
+      return property.name;
+    }
+  }
+  return void 0;
+}
+function evaluateExpressionReference(expression, ctx, depth) {
+  const resolved = unwrapExpression(expression);
+  markFile(ctx, resolved.getSourceFile());
+  if (depth > MAX_RECURSION_DEPTH) return void 0;
+  if (import_typescript.default.isIdentifier(resolved)) {
+    return resolveIdentifierExpression(resolved, ctx, depth + 1);
+  }
+  if (import_typescript.default.isPropertyAccessExpression(resolved) || import_typescript.default.isElementAccessExpression(resolved)) {
+    return resolvePropertyExpression(resolved, ctx, depth + 1);
+  }
+  return void 0;
 }
 function resolveExportExpression(sourceFile, exportName, checker) {
   const moduleSymbol = getModuleSymbol(checker, sourceFile);
@@ -991,12 +1076,12 @@ function resolveExportExpression(sourceFile, exportName, checker) {
   const explicit = exports2.find((entry) => entry.getName() === exportName);
   if (explicit) {
     const declaration = getAliasedSymbolIfNeeded(checker, explicit).declarations?.[0];
-    return expressionFromDeclaration(declaration);
+    return declarationToExpression(declaration);
   }
   const defaultExport = exports2.find((entry) => entry.getName() === "default");
   if (!defaultExport) return void 0;
   const defaultDecl = getAliasedSymbolIfNeeded(checker, defaultExport).declarations?.[0];
-  const defaultExpr = expressionFromDeclaration(defaultDecl);
+  const defaultExpr = declarationToExpression(defaultDecl);
   if (!defaultExpr) return void 0;
   const resolved = unwrapExpression(defaultExpr);
   if (!import_typescript.default.isObjectLiteralExpression(resolved)) return void 0;
@@ -1008,24 +1093,25 @@ function resolveExportExpression(sourceFile, exportName, checker) {
   }
   return void 0;
 }
-function maybeObjectLiteral(expression, ctx) {
-  if (!expression) return void 0;
+function maybeObjectLiteral(expression, ctx, depth = 0) {
+  if (!expression || depth > MAX_RECURSION_DEPTH) return void 0;
   const resolved = unwrapExpression(expression);
+  markFile(ctx, resolved.getSourceFile());
   if (import_typescript.default.isObjectLiteralExpression(resolved)) return resolved;
-  if (import_typescript.default.isIdentifier(resolved)) {
-    const target = resolveIdentifierExpression(resolved, ctx);
-    if (!target) return void 0;
-    return maybeObjectLiteral(target, ctx);
-  }
-  return void 0;
+  const referenced = evaluateExpressionReference(resolved, ctx, depth + 1);
+  if (!referenced) return void 0;
+  return maybeObjectLiteral(referenced, ctx, depth + 1);
 }
-function collectSchemaExpressionsFromObject(objectLiteral, ctx) {
+function collectSchemaExpressionsFromObject(objectLiteral, ctx, depth) {
   const schemas = {};
   for (const property of objectLiteral.properties) {
     if (import_typescript.default.isSpreadAssignment(property)) {
-      const spreadObject = maybeObjectLiteral(property.expression, ctx);
+      const spreadObject = maybeObjectLiteral(property.expression, ctx, depth + 1);
       if (!spreadObject) continue;
-      Object.assign(schemas, collectSchemaExpressionsFromObject(spreadObject, ctx));
+      Object.assign(
+        schemas,
+        collectSchemaExpressionsFromObject(spreadObject, ctx, depth + 1)
+      );
       continue;
     }
     if (import_typescript.default.isPropertyAssignment(property)) {
@@ -1042,10 +1128,10 @@ function collectSchemaExpressionsFromObject(objectLiteral, ctx) {
   }
   return schemas;
 }
-function extractSchemaExpressions(cfgExpression, ctx) {
-  const objectLiteral = maybeObjectLiteral(cfgExpression, ctx);
+function extractSchemaExpressions(cfgExpression, ctx, depth) {
+  const objectLiteral = maybeObjectLiteral(cfgExpression, ctx, depth);
   if (!objectLiteral) return {};
-  return collectSchemaExpressionsFromObject(objectLiteral, ctx);
+  return collectSchemaExpressionsFromObject(objectLiteral, ctx, depth);
 }
 function getNearestVariableName(node) {
   let current = node;
@@ -1057,31 +1143,45 @@ function getNearestVariableName(node) {
   }
   return void 0;
 }
-function evaluateBranchExpression(expression, ctx) {
+function isAllAccess(expression) {
+  if (import_typescript.default.isPropertyAccessExpression(expression)) {
+    return expression.name.text === "all";
+  }
+  return Boolean(
+    expression.argumentExpression && import_typescript.default.isStringLiteralLike(expression.argumentExpression) && expression.argumentExpression.text === "all"
+  );
+}
+function evaluateBranchExpression(expression, ctx, depth) {
   const resolved = unwrapExpression(expression);
+  markFile(ctx, resolved.getSourceFile());
+  if (depth > MAX_RECURSION_DEPTH) return void 0;
   if (import_typescript.default.isIdentifier(resolved)) {
-    const valueExpr = resolveIdentifierExpression(resolved, ctx);
+    const valueExpr = resolveIdentifierExpression(resolved, ctx, depth + 1);
     if (!valueExpr) return void 0;
-    return evaluateBranchExpression(valueExpr, ctx);
+    return evaluateBranchExpression(valueExpr, ctx, depth + 1);
   }
   if (!import_typescript.default.isCallExpression(resolved)) return void 0;
   const call = resolved;
   if (import_typescript.default.isIdentifier(call.expression) && call.expression.text === "resource") {
     const firstArg = call.arguments[0];
-    if (!firstArg || !import_typescript.default.isStringLiteralLike(firstArg)) return void 0;
+    if (!firstArg || !import_typescript.default.isStringLiteralLike(firstArg)) {
+      ctx.unsupportedShapeSeen = true;
+      return void 0;
+    }
     return { base: normalizeResourceBase(firstArg.text), leaves: [] };
   }
-  if (!import_typescript.default.isPropertyAccessExpression(call.expression)) return void 0;
+  if (!import_typescript.default.isPropertyAccessExpression(call.expression)) {
+    ctx.unsupportedShapeSeen = true;
+    return void 0;
+  }
   const owner = call.expression.expression;
   const method = call.expression.name.text;
-  const branch = evaluateBranchExpression(owner, ctx);
+  const branch = evaluateBranchExpression(owner, ctx, depth + 1);
   if (!branch) return void 0;
-  if (method === "with") {
-    return branch;
-  }
+  if (method === "with") return branch;
   if (HTTP_METHODS.has(method)) {
     const cfgExpression = call.arguments[0];
-    const schemas = extractSchemaExpressions(cfgExpression, ctx);
+    const schemas = extractSchemaExpressions(cfgExpression, ctx, depth + 1);
     const nextLeaf = {
       method,
       path: branch.base,
@@ -1095,7 +1195,7 @@ function evaluateBranchExpression(expression, ctx) {
   }
   if (method === "sub") {
     const mountedLeaves = call.arguments.flatMap(
-      (arg) => evaluateLeavesFromExpression(arg, ctx)
+      (arg) => evaluateLeavesFromExpression(arg, ctx, depth + 1)
     );
     const prefixed = mountedLeaves.map((leaf) => ({
       ...leaf,
@@ -1106,29 +1206,44 @@ function evaluateBranchExpression(expression, ctx) {
       leaves: [...branch.leaves, ...prefixed]
     };
   }
+  ctx.unsupportedShapeSeen = true;
   return void 0;
 }
-function evaluateLeavesFromExpression(expression, ctx) {
+function expressionKey(expression) {
+  const source = expression.getSourceFile();
+  return `${import_node_path.default.resolve(source.fileName)}:${expression.getStart(source)}:${expression.getEnd()}:${expression.kind}`;
+}
+function evaluateLeavesFromExpression(expression, ctx, depth = 0) {
   const resolved = unwrapExpression(expression);
-  const key = resolved.getStart(resolved.getSourceFile());
-  if (ctx.visitedExpressionStarts.has(key)) {
-    return [];
-  }
-  ctx.visitedExpressionStarts.add(key);
+  markFile(ctx, resolved.getSourceFile());
+  const key = expressionKey(resolved);
+  if (ctx.activeExpressionKeys.has(key)) return [];
+  if (depth > MAX_RECURSION_DEPTH) return [];
+  ctx.activeExpressionKeys.add(key);
   try {
     if (import_typescript.default.isIdentifier(resolved)) {
-      const valueExpr = resolveIdentifierExpression(resolved, ctx);
+      const valueExpr = resolveIdentifierExpression(resolved, ctx, depth + 1);
       if (!valueExpr) return [];
-      return evaluateLeavesFromExpression(valueExpr, ctx);
+      return evaluateLeavesFromExpression(valueExpr, ctx, depth + 1);
+    }
+    if (import_typescript.default.isPropertyAccessExpression(resolved) || import_typescript.default.isElementAccessExpression(resolved)) {
+      if (isAllAccess(resolved)) {
+        return evaluateLeavesFromExpression(resolved.expression, ctx, depth + 1);
+      }
+      const refExpr = resolvePropertyExpression(resolved, ctx, depth + 1);
+      if (refExpr) {
+        return evaluateLeavesFromExpression(refExpr, ctx, depth + 1);
+      }
+      return [];
     }
     if (import_typescript.default.isArrayLiteralExpression(resolved)) {
       const leaves = [];
       for (const element of resolved.elements) {
         if (import_typescript.default.isSpreadElement(element)) {
-          leaves.push(...evaluateLeavesFromExpression(element.expression, ctx));
+          leaves.push(...evaluateLeavesFromExpression(element.expression, ctx, depth + 1));
           continue;
         }
-        leaves.push(...evaluateLeavesFromExpression(element, ctx));
+        leaves.push(...evaluateLeavesFromExpression(element, ctx, depth + 1));
       }
       return leaves;
     }
@@ -1138,34 +1253,43 @@ function evaluateLeavesFromExpression(expression, ctx) {
         if (callName === "finalize") {
           const arg = resolved.arguments[0];
           if (!arg) return [];
-          return evaluateLeavesFromExpression(arg, ctx);
+          return evaluateLeavesFromExpression(arg, ctx, depth + 1);
         }
         if (callName === "mergeArrays") {
           return resolved.arguments.flatMap(
-            (arg) => evaluateLeavesFromExpression(arg, ctx)
+            (arg) => evaluateLeavesFromExpression(arg, ctx, depth + 1)
           );
         }
       }
       if (import_typescript.default.isPropertyAccessExpression(resolved.expression)) {
         const prop = resolved.expression.name.text;
         if (prop === "done") {
-          const branch2 = evaluateBranchExpression(resolved.expression.expression, ctx);
+          const branch2 = evaluateBranchExpression(
+            resolved.expression.expression,
+            ctx,
+            depth + 1
+          );
           return branch2?.leaves ?? [];
         }
       }
+      const refExpr = evaluateExpressionReference(resolved, ctx, depth + 1);
+      if (refExpr) return evaluateLeavesFromExpression(refExpr, ctx, depth + 1);
+      ctx.unsupportedShapeSeen = true;
+      return [];
     }
-    const branch = evaluateBranchExpression(resolved, ctx);
-    return branch?.leaves ?? [];
+    const branch = evaluateBranchExpression(resolved, ctx, depth + 1);
+    if (branch) return branch.leaves;
+    ctx.unsupportedShapeSeen = true;
+    return [];
   } finally {
-    ctx.visitedExpressionStarts.delete(key);
+    ctx.activeExpressionKeys.delete(key);
   }
 }
 function resolveSchemaMetadata(expression, ctx) {
   const resolved = unwrapExpression(expression);
   if (import_typescript.default.isIdentifier(resolved)) {
-    const symbol = ctx.checker.getSymbolAtLocation(resolved);
-    const target = symbol ? getAliasedSymbolIfNeeded(ctx.checker, symbol) : void 0;
-    const declaration = target?.declarations?.[0];
+    const symbol = resolveSymbolFromNode(resolved, ctx);
+    const declaration = symbol?.declarations?.[0];
     const locationNode = declaration ? import_typescript.default.isVariableDeclaration(declaration) ? declaration.name : declaration : resolved;
     const sourceName = declaration && import_typescript.default.isVariableDeclaration(declaration) && import_typescript.default.isIdentifier(declaration.name) ? declaration.name.text : resolved.text;
     return {
@@ -1203,13 +1327,25 @@ function parseTsConfig(cwd, tsconfigPath) {
     void 0,
     resolvedTsconfig
   );
-  if (parsed.errors.length > 0) {
+  const nonEmptyInputErrors = parsed.errors.filter((entry) => entry.code !== 18003);
+  if (nonEmptyInputErrors.length > 0) {
     throw new Error(
-      parsed.errors.map((entry) => import_typescript.default.flattenDiagnosticMessageText(entry.messageText, "\n")).join("\n")
+      nonEmptyInputErrors.map((entry) => import_typescript.default.flattenDiagnosticMessageText(entry.messageText, "\n")).join("\n")
     );
   }
   return { resolvedTsconfig, parsed };
 }
+function createProgramWithFallback(parsed, moduleFileAbs) {
+  const base = import_typescript.default.createProgram({
+    rootNames: parsed.fileNames,
+    options: parsed.options
+  });
+  if (findSourceFile(base, moduleFileAbs)) {
+    return base;
+  }
+  const rootNames = Array.from(/* @__PURE__ */ new Set([...parsed.fileNames, moduleFileAbs]));
+  return import_typescript.default.createProgram({ rootNames, options: parsed.options });
+}
 function extractLeafSourceByAst({
   modulePath,
   exportName,
@@ -1218,32 +1354,43 @@ function extractLeafSourceByAst({
 }) {
   const parsedConfig = parseTsConfig(cwd, tsconfigPath);
   if (!parsedConfig) {
-    return { sourceByLeaf: {} };
+    return {
+      sourceByLeaf: {},
+      reason: "module_not_in_program",
+      stats: { visitedSymbols: 0, visitedFiles: 0, unresolvedReferences: 0 }
+    };
   }
-  const program = import_typescript.default.createProgram({
-    rootNames: parsedConfig.parsed.fileNames,
-    options: parsedConfig.parsed.options
-  });
+  const moduleAbs = import_node_path.default.resolve(cwd, modulePath);
+  const program = createProgramWithFallback(parsedConfig.parsed, moduleAbs);
   const checker = program.getTypeChecker();
-  const moduleFile = findSourceFile(program, import_node_path.default.resolve(cwd, modulePath));
+  const moduleFile = findSourceFile(program, moduleAbs);
   if (!moduleFile) {
     return {
       sourceByLeaf: {},
-      tsconfigPath: parsedConfig.resolvedTsconfig
+      tsconfigPath: parsedConfig.resolvedTsconfig,
+      reason: "module_not_in_program",
+      stats: { visitedSymbols: 0, visitedFiles: 0, unresolvedReferences: 0 }
     };
   }
   const exportedExpression = resolveExportExpression(moduleFile, exportName, checker);
   if (!exportedExpression) {
     return {
       sourceByLeaf: {},
-      tsconfigPath: parsedConfig.resolvedTsconfig
+      tsconfigPath: parsedConfig.resolvedTsconfig,
+      reason: "export_not_found",
+      stats: { visitedSymbols: 0, visitedFiles: 1, unresolvedReferences: 0 }
     };
   }
   const ctx = {
     checker,
-    visitedExpressionStarts: /* @__PURE__ */ new Set()
+    activeExpressionKeys: /* @__PURE__ */ new Set(),
+    activeSymbols: /* @__PURE__ */ new Set(),
+    visitedSymbolKeys: /* @__PURE__ */ new Set(),
+    visitedFilePaths: /* @__PURE__ */ new Set([import_node_path.default.resolve(moduleFile.fileName)]),
+    unresolvedReferences: 0,
+    unsupportedShapeSeen: false
   };
-  const evaluatedLeaves = evaluateLeavesFromExpression(exportedExpression, ctx);
+  const evaluatedLeaves = evaluateLeavesFromExpression(exportedExpression, ctx, 0);
   const sourceByLeaf = {};
   for (const leaf of evaluatedLeaves) {
     const key = buildLeafKey(leaf.method, leaf.path);
@@ -1251,17 +1398,27 @@ function extractLeafSourceByAst({
       ...toLocation(leaf.definitionNode),
       symbolName: getNearestVariableName(leaf.definitionNode)
     };
+    ctx.visitedFilePaths.add(definition.file);
     const schemas = {};
     for (const schemaKey of SCHEMA_KEYS) {
       const schemaExpression = leaf.schemas[schemaKey];
       if (!schemaExpression) continue;
-      schemas[schemaKey] = resolveSchemaMetadata(schemaExpression, ctx);
+      const schemaMeta = resolveSchemaMetadata(schemaExpression, ctx);
+      ctx.visitedFilePaths.add(schemaMeta.file);
+      schemas[schemaKey] = schemaMeta;
     }
     sourceByLeaf[key] = { definition, schemas };
   }
+  const reason = Object.keys(sourceByLeaf).length > 0 ? void 0 : ctx.unsupportedShapeSeen ? "unsupported_expression_shape" : "resolved_zero_leaves";
   return {
     sourceByLeaf,
-    tsconfigPath: parsedConfig.resolvedTsconfig
+    tsconfigPath: parsedConfig.resolvedTsconfig,
+    reason,
+    stats: {
+      visitedSymbols: ctx.visitedSymbolKeys.size,
+      visitedFiles: ctx.visitedFilePaths.size,
+      unresolvedReferences: ctx.unresolvedReferences
+    }
   };
 }
@@ -1444,7 +1601,9 @@ async function exportFinalizedLeaves(input, options = {}) {
         modulePath: import_node_path2.default.resolve(modulePath),
         exportName,
         tsconfigPath: extracted.tsconfigPath,
-        resolvedLeafCount: Object.keys(sourceByLeaf).length
+        resolvedLeafCount: Object.keys(sourceByLeaf).length,
+        reason: extracted.reason,
+        stats: extracted.stats
       };
     } else {
       sourceExtraction = {
@@ -1452,7 +1611,13 @@ async function exportFinalizedLeaves(input, options = {}) {
         enabled: false,
         exportName,
         tsconfigPath: options.tsconfigPath ? import_node_path2.default.resolve(options.tsconfigPath) : void 0,
-        resolvedLeafCount: 0
+        resolvedLeafCount: 0,
+        reason: "resolved_zero_leaves",
+        stats: {
+          visitedSymbols: 0,
+          visitedFiles: 0,
+          unresolvedReferences: 0
+        }
       };
     }
   }