@shapeshift-labs/frontier-lang-compiler 0.2.117 → 0.2.118

package/README.md

@@ -238,6 +238,12 @@ console.log(project.outputProjectSymbolGraph.importEdges[0].packageName); // "@p
 console.log(project.outputProjectSymbolGraph.importEdges[0].packageExportCondition); // "import"
 ```
 
+NodeNext-style JS extension specifiers can resolve to supplied TS source files.
+For example, `import './runtime.js'` can resolve to `src/runtime.ts` when that is
+the available project document. Graph edges record `resolutionPathVariant` as
+`"extension-substitution"` so coordinators can distinguish exact source matches
+from source-extension substitutions during stale checks and merge admission.
+
 Package `imports` maps are also modeled for `#internal` specifiers. Top-level
 `moduleResolution.imports` applies from `packageRoot`/`root`, while
 `packages[name].imports` applies to the nearest configured package root. Graph

package/dist/declarations/native-project.d.ts

@@ -108,6 +108,7 @@ export interface NativeProjectSymbolGraphModuleEdgeRecord {
   readonly targetDocumentId?: string;
   readonly resolvedTargetSymbolId?: string;
   readonly resolutionKind?: 'relative-source' | 'relative-missing' | 'alias-source' | 'alias-missing' | 'path-alias-source' | 'path-alias-missing' | 'base-url-source' | 'base-url-missing' | 'package-source' | 'package-missing' | 'package-external' | 'package-import-source' | 'package-import-missing' | 'package-import-external' | string;
+  readonly resolutionPathVariant?: 'exact' | 'extension-substitution' | 'extensionless' | 'index' | string;
   readonly packageName?: string; readonly packageSubpath?: string; readonly packageExportCondition?: string;
   readonly packageImportKey?: string; readonly packageImportCondition?: string; readonly packageImportTarget?: string;
   readonly importKind?: string;

package/dist/internal/index-impl/createNativeProjectImportResult.js

@@ -240,6 +240,7 @@ function moduleEdgeRecord(relation, moduleEdgeByRelation, symbolsById, documents
     resolvedModulePath: resolution?.path,
     targetDocumentId: resolution?.documentId,
     resolutionKind: resolution?.kind,
+    resolutionPathVariant: resolution?.resolutionPathVariant,
     packageName: resolution?.packageName,
     packageSubpath: resolution?.packageSubpath,
     packageExportCondition: resolution?.packageExportCondition,

package/dist/internal/index-impl/projectSymbolGraphModulePathCandidates.js

@@ -0,0 +1,52 @@
+export function modulePathCandidates(path) {
+  const normalized = String(path ?? '');
+  return uniqueCandidates([
+    candidate(normalized, 'exact'),
+    ...extensionSubstitutionCandidates(normalized),
+    ...extensionlessCandidates(normalized),
+    ...indexCandidates(normalized)
+  ]);
+}
+
+function extensionSubstitutionCandidates(path) {
+  const entries = [
+    ['.js', ['.ts', '.tsx', '.d.ts', '.jsx']],
+    ['.jsx', ['.tsx', '.ts', '.d.ts']],
+    ['.mjs', ['.mts', '.ts', '.d.mts']],
+    ['.cjs', ['.cts', '.ts', '.d.cts']]
+  ];
+  for (const [from, targets] of entries) {
+    if (!path.endsWith(from)) continue;
+    const base = path.slice(0, -from.length);
+    return targets.map((target) => candidate(`${base}${target}`, 'extension-substitution'));
+  }
+  return [];
+}
+
+function extensionlessCandidates(path) {
+  if (hasKnownExtension(path)) return [];
+  return ['.js', '.ts', '.tsx', '.jsx', '.mjs', '.mts', '.cjs', '.cts', '.d.ts']
+    .map((extension) => candidate(`${path}${extension}`, 'extensionless'));
+}
+
+function indexCandidates(path) {
+  return ['.js', '.ts', '.tsx', '.jsx', '.mjs', '.mts', '.cjs', '.cts', '.d.ts']
+    .map((extension) => candidate(`${path}/index${extension}`, 'index'));
+}
+
+function hasKnownExtension(path) {
+  return /\.(?:[cm]?[jt]sx?|d\.[cm]?ts)$/.test(path);
+}
+
+function candidate(path, variant) {
+  return { path, variant };
+}
+
+function uniqueCandidates(candidates) {
+  const seen = new Set();
+  return candidates.filter((entry) => {
+    if (!entry.path || seen.has(entry.path)) return false;
+    seen.add(entry.path);
+    return true;
+  });
+}

package/dist/internal/index-impl/projectSymbolGraphModuleResolution.js

@@ -1,3 +1,5 @@
+import { modulePathCandidates } from './projectSymbolGraphModulePathCandidates.js';
+
 export function resolveRelativeProjectModule(sourcePath, moduleSpecifier, documentsByPath) {
   if (!sourcePath || !moduleSpecifier || !moduleSpecifier.startsWith('.')) return undefined;
   const base = sourcePath.includes('/') ? sourcePath.slice(0, sourcePath.lastIndexOf('/')) : '';
@@ -6,6 +8,7 @@ export function resolveRelativeProjectModule(sourcePath, moduleSpecifier, docume
   return {
     path: target?.path ?? unresolvedPath,
     documentId: target?.id,
+    resolutionPathVariant: target?.resolutionPathVariant,
     kind: target ? 'relative-source' : 'relative-missing'
   };
 }
@@ -69,7 +72,7 @@ function resolveConfiguredProjectModule(moduleSpecifier, documentsByPath, module
   for (const candidate of candidates) {
     const target = moduleTargetDocument(candidate.path, documentsByPath);
     const packageFields = packageResolutionFields(candidate, packageInfo);
-    if (target) return { path: target.path, documentId: target.id, kind: `${candidate.kind}-source`, ...packageFields };
+    if (target) return { path: target.path, documentId: target.id, resolutionPathVariant: target.resolutionPathVariant, kind: `${candidate.kind}-source`, ...packageFields };
     firstMissing ??= { path: candidate.path, kind: `${candidate.kind}-missing`, ...packageFields };
   }
   return firstMissing ?? (packageInfo ? { kind: 'package-external', ...packageInfo } : undefined);
@@ -95,7 +98,7 @@ function resolvePackageImportProjectModule(sourcePath, moduleSpecifier, document
       packageImportTarget,
       packageName: packageContext.packageName
     };
-    if (resolved) return { path: resolved.path, documentId: resolved.id, kind: 'package-import-source', ...record };
+    if (resolved) return { path: resolved.path, documentId: resolved.id, resolutionPathVariant: resolved.resolutionPathVariant, kind: 'package-import-source', ...record };
     firstMissing ??= { path: candidatePath, kind: 'package-import-missing', ...record };
   }
   return firstMissing ?? { kind: 'package-import-external', packageImportKey: match.key };
@@ -224,16 +227,12 @@ function packageFallbackTargets(options, subpath) {
 
 function moduleTargetDocument(path, documentsByPath) {
   for (const candidate of modulePathCandidates(path)) {
-    const document = documentsByPath.get(candidate);
-    if (document) return document;
+    const document = documentsByPath.get(candidate.path);
+    if (document) return { ...document, resolutionPathVariant: candidate.variant };
   }
   return undefined;
 }
 
-function modulePathCandidates(path) {
-  return [path, `${path}.js`, `${path}.ts`, `${path}.tsx`, `${path}.jsx`, `${path}.d.ts`, `${path}/index.js`, `${path}/index.ts`, `${path}/index.d.ts`];
-}
-
 function targetExportName(edge) {
   const name = edge.importedName ?? edge.localName ?? edge.exportedName;
   if (!name || name === '*') return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-lang-compiler",
-  "version": "0.2.117",
+  "version": "0.2.118",
   "description": "Compiler facade for Frontier Lang source documents and language projection adapters.",
   "type": "module",
   "main": "./dist/index.js",