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

package/README.md

@@ -238,6 +238,29 @@ console.log(project.outputProjectSymbolGraph.importEdges[0].packageName); // "@p
 console.log(project.outputProjectSymbolGraph.importEdges[0].packageExportCondition); // "import"
 ```
 
+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
+edges record `packageImportKey`, `packageImportCondition`, and
+`packageImportTarget` so merge admission can distinguish private aliases from
+external or unresolved imports:
+
+```js
+const project = safeMergeJsTsProject({
+  includeOutputProjectSymbolGraph: true,
+  moduleResolution: {
+    imports: { '#internal/*': { import: './src/internal/*.ts', default: './src/internal/*.js' } },
+    packageExportConditions: ['import', 'default']
+  },
+  baseFiles,
+  workerFiles,
+  headFiles
+});
+
+console.log(project.outputProjectSymbolGraph.importEdges[0].resolutionKind); // "package-import-source"
+console.log(project.outputProjectSymbolGraph.importEdges[0].packageImportKey); // "#internal/*"
+```
+
 Named re-export identities also include symbol links when the project graph has
 enough evidence. For `export { thing as renamedThing } from './thing.js'`,
 `reExportIdentities[]` records the source module, imported/exported names,

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

@@ -1,6 +1,7 @@
 export type NativeProjectModuleResolutionPaths = Readonly<Record<string, readonly string[] | string>>;
 export type NativeProjectPackageExportTarget = string | readonly string[] | NativeProjectPackageConditionalExports;
 export type NativeProjectPackageExports = NativeProjectPackageExportTarget | Readonly<Record<string, NativeProjectPackageExportTarget>>;
+export type NativeProjectPackageImports = Readonly<Record<string, NativeProjectPackageExportTarget>>;
 
 export interface NativeProjectPackageConditionalExports {
   readonly [condition: string]: NativeProjectPackageExportTarget;
@@ -12,12 +13,17 @@ export interface NativeProjectPackageResolutionOptions {
   readonly main?: string;
   readonly types?: string;
   readonly exports?: NativeProjectPackageExports;
+  readonly imports?: NativeProjectPackageImports;
 }
 
 export interface NativeProjectModuleResolutionOptions {
+  readonly root?: string;
+  readonly packageRoot?: string;
   readonly baseUrl?: string;
   readonly paths?: NativeProjectModuleResolutionPaths;
   readonly aliases?: NativeProjectModuleResolutionPaths;
+  readonly imports?: NativeProjectPackageImports;
+  readonly packageImports?: NativeProjectPackageImports;
   readonly packages?: Readonly<Record<string, NativeProjectPackageResolutionOptions>>;
   readonly conditions?: readonly string[];
   readonly packageExportConditions?: readonly string[];

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

@@ -107,10 +107,9 @@ export interface NativeProjectSymbolGraphModuleEdgeRecord {
   readonly resolvedModulePath?: string;
   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' | string;
-  readonly packageName?: string;
-  readonly packageSubpath?: string;
-  readonly packageExportCondition?: 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 packageName?: string; readonly packageSubpath?: string; readonly packageExportCondition?: string;
+  readonly packageImportKey?: string; readonly packageImportCondition?: string; readonly packageImportTarget?: string;
   readonly importKind?: string;
   readonly exportKind?: string;
   readonly importedName?: string;

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

@@ -243,6 +243,9 @@ function moduleEdgeRecord(relation, moduleEdgeByRelation, symbolsById, documents
     packageName: resolution?.packageName,
     packageSubpath: resolution?.packageSubpath,
     packageExportCondition: resolution?.packageExportCondition,
+    packageImportKey: resolution?.packageImportKey,
+    packageImportCondition: resolution?.packageImportCondition,
+    packageImportTarget: resolution?.packageImportTarget,
     importKind: firstString(moduleEdge.importKind, value.importKind, symbolMetadata.importKind),
     exportKind: firstString(moduleEdge.exportKind, value.exportKind, symbolMetadata.exportKind),
     importedName: firstString(moduleEdge.importedName, value.importedName, symbolMetadata.importedName),

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

@@ -13,6 +13,7 @@ export function resolveRelativeProjectModule(sourcePath, moduleSpecifier, docume
 export function resolveProjectModule(sourcePath, moduleSpecifier, documentsByPath, moduleResolution) {
   if (!sourcePath || !moduleSpecifier) return undefined;
   if (String(moduleSpecifier).startsWith('.')) return resolveRelativeProjectModule(sourcePath, moduleSpecifier, documentsByPath);
+  if (String(moduleSpecifier).startsWith('#')) return resolvePackageImportProjectModule(sourcePath, moduleSpecifier, documentsByPath, moduleResolution);
   return resolveConfiguredProjectModule(moduleSpecifier, documentsByPath, moduleResolution);
 }
 
@@ -74,6 +75,32 @@ function resolveConfiguredProjectModule(moduleSpecifier, documentsByPath, module
   return firstMissing ?? (packageInfo ? { kind: 'package-external', ...packageInfo } : undefined);
 }
 
+function resolvePackageImportProjectModule(sourcePath, moduleSpecifier, documentsByPath, moduleResolution = {}) {
+  const packageContext = packageImportContext(sourcePath, moduleResolution);
+  const importsValue = packageContext.imports;
+  if (!importsValue) return { kind: 'package-import-external', packageImportKey: moduleSpecifier };
+  const match = packageImportMapValue(importsValue, moduleSpecifier);
+  if (!match) return { kind: 'package-import-external', packageImportKey: moduleSpecifier };
+  let firstMissing;
+  for (const target of exportTargetsForValue(match.value, packageConditions(moduleResolution))) {
+    const packageImportTarget = target.path;
+    if (!packageImportTarget || !String(packageImportTarget).startsWith('.')) {
+      return { kind: 'package-import-external', packageImportKey: match.key, packageImportCondition: target.condition, packageImportTarget };
+    }
+    const candidatePath = normalizeProjectPath(joinProjectPath(packageContext.root, packageImportTarget));
+    const resolved = moduleTargetDocument(candidatePath, documentsByPath);
+    const record = {
+      packageImportKey: match.key,
+      packageImportCondition: target.condition,
+      packageImportTarget,
+      packageName: packageContext.packageName
+    };
+    if (resolved) return { path: resolved.path, documentId: resolved.id, kind: 'package-import-source', ...record };
+    firstMissing ??= { path: candidatePath, kind: 'package-import-missing', ...record };
+  }
+  return firstMissing ?? { kind: 'package-import-external', packageImportKey: match.key };
+}
+
 function configuredModuleCandidates(moduleSpecifier, moduleResolution = {}, packageInfo) {
   const compilerOptions = moduleResolution.compilerOptions ?? {};
   const baseUrl = normalizeProjectPath(moduleResolution.baseUrl ?? compilerOptions.baseUrl ?? '');
@@ -136,6 +163,31 @@ function packageExportTargets(exportsValue, subpath, conditions) {
   return exportTargetsForValue(exportMapValue(exportsValue, subpath), conditions);
 }
 
+function packageImportMapValue(importsValue, moduleSpecifier) {
+  if (!isRecord(importsValue)) return undefined;
+  if (Object.prototype.hasOwnProperty.call(importsValue, moduleSpecifier)) return { key: moduleSpecifier, value: importsValue[moduleSpecifier] };
+  for (const [pattern, value] of Object.entries(importsValue)) {
+    const capture = patternCapture(moduleSpecifier, pattern);
+    if (capture !== undefined) return { key: pattern, value: replaceExportTargetCapture(value, capture) };
+  }
+  return undefined;
+}
+
+function packageImportContext(sourcePath, moduleResolution = {}) {
+  const packages = Object.entries(moduleResolution.packages ?? {})
+    .map(([packageName, options]) => ({
+      packageName,
+      root: normalizeProjectPath(options.root ?? ''),
+      imports: options.imports
+    }))
+    .filter((entry) => entry.imports && pathInsideRoot(sourcePath, entry.root))
+    .sort((left, right) => right.root.length - left.root.length);
+  return packages[0] ?? {
+    root: normalizeProjectPath(moduleResolution.packageRoot ?? moduleResolution.root ?? ''),
+    imports: moduleResolution.imports ?? moduleResolution.packageImports
+  };
+}
+
 function exportMapValue(exportsValue, subpath) {
   if (!isRecord(exportsValue) || !Object.keys(exportsValue).some((key) => key.startsWith('.'))) return subpath === '.' ? exportsValue : undefined;
   return exportsValue[subpath] ?? patternExportMapValue(exportsValue, subpath);
@@ -229,7 +281,10 @@ function packageResolutionFields(candidate, packageInfo) {
   return {
     packageName: candidate.packageName ?? packageInfo?.packageName,
     packageSubpath: candidate.packageSubpath ?? packageInfo?.packageSubpath,
-    packageExportCondition: candidate.packageExportCondition
+    packageExportCondition: candidate.packageExportCondition,
+    packageImportKey: candidate.packageImportKey,
+    packageImportCondition: candidate.packageImportCondition,
+    packageImportTarget: candidate.packageImportTarget
   };
 }
 
@@ -250,3 +305,9 @@ function normalizeProjectPath(path) {
   }
   return parts.join('/');
 }
+
+function pathInsideRoot(sourcePath, root) {
+  if (!root) return true;
+  const normalized = normalizeProjectPath(sourcePath);
+  return normalized === root || normalized.startsWith(`${root}/`);
+}

package/package.json

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