@shapeshift-labs/frontier-lang-compiler 0.2.35 → 0.2.36

package/dist/index.d.ts

@@ -20,7 +20,9 @@ import type {
   SourceMapRecord,
   SourcePreservationLevel,
   SourcePreservationRecord,
-  SourceSpan
+  SourceSpan,
+  UniversalAstLayerMap,
+  UniversalAstLayerRecord
 } from '@shapeshift-labs/frontier-lang-kernel';
 import type { Diagnostic } from '@shapeshift-labs/frontier-lang-checker';
 import type { EmitTypeScriptOptions, TypeScriptAstModule, TypeScriptDocumentSourceMapResult, TypeScriptGeneratedSourceMapResult } from '@shapeshift-labs/frontier-lang-typescript';
@@ -963,6 +965,9 @@ export interface SemanticImportSidecarImportEntry {
   readonly sourceMapMappingCount: number;
   readonly sourcePreservationRecordCount: number;
   readonly sourcePreservationLevels: readonly SourcePreservationLevel[];
+  readonly universalAstLayerCount: number;
+  readonly universalAstLayerNames: readonly string[];
+  readonly universalAstLayerIds: readonly string[];
   readonly readiness: SemanticMergeReadiness;
   readonly emptySemanticIndex: boolean;
   readonly regionTaxonomy?: SemanticImportRegionTaxonomySummary;
@@ -986,6 +991,14 @@ export interface SemanticImportSidecarSourcePreservationRecord {
   readonly reasons: readonly string[];
 }
 
+export interface SemanticImportSidecarUniversalAstLayerSummary {
+  readonly total: number;
+  readonly names: readonly string[];
+  readonly ids: readonly string[];
+  readonly byName: Readonly<Record<string, number>>;
+  readonly empty: boolean;
+}
+
 export interface SemanticImportSidecar {
   readonly kind: 'frontier.lang.semanticImportSidecar';
   readonly version: 1;
@@ -1014,6 +1027,7 @@ export interface SemanticImportSidecar {
     readonly sourceMapMappingIds: readonly string[];
     readonly records: readonly SemanticImportSidecarSourcePreservationRecord[];
   };
+  readonly universalAstLayers: SemanticImportSidecarUniversalAstLayerSummary;
   readonly patchHints: readonly SemanticImportPatchHint[];
   readonly mergeCandidates: readonly {
     readonly id?: string;
@@ -1043,6 +1057,8 @@ export interface SemanticImportSidecar {
     readonly regionKinds: number;
     readonly sourceMapMappings: number;
     readonly sourcePreservationRecords: number;
+    readonly universalAstLayers: number;
+    readonly universalAstLayerNames: readonly string[];
     readonly readiness: SemanticMergeReadiness;
     readonly emptySemanticIndex: boolean;
   };
@@ -2190,9 +2206,13 @@ export declare function diffNativeSourceImports(input: DiffNativeSourceImportsOp
 export declare function importNativeProject(input: ImportNativeProjectOptions): Promise<NativeProjectImportResult>;
 export declare function createUniversalAstFromDocument(document: FrontierLangDocument, input?: {
   readonly id?: string;
+  readonly nativeSources?: readonly NativeSourceNode[];
   readonly semanticIndex?: SemanticIndexRecord;
   readonly sourceMaps?: readonly SourceMapRecord[];
+  readonly losses?: readonly NativeAstLossRecord[];
   readonly evidence?: readonly EvidenceRecord[];
+  readonly mergeCandidates?: readonly SemanticMergeCandidateRecord[];
+  readonly layers?: UniversalAstLayerMap | readonly UniversalAstLayerRecord[];
   readonly metadata?: Record<string, unknown>;
 }): FrontierUniversalAstEnvelope;
 export declare function readUniversalAstJson(source: string): FrontierUniversalAstEnvelope;

package/dist/index.js

@@ -2565,6 +2565,7 @@ export function createSemanticImportSidecar(importResult, options = {}) {
   const lossSummary = summarizeNativeImportLosses(losses, { evidence });
   const regionTaxonomy = summarizeSemanticImportRegionTaxonomy(ownershipRegions);
   const sourcePreservation = summarizeKernelSourcePreservation(importResult, imports);
+  const universalAstLayers = summarizeSemanticImportSidecarUniversalAstLayers(importEntries);
   const readiness = mergeCandidates.reduce(
     (current, candidate) => maxSemanticMergeReadiness(current, candidate.readiness),
     lossSummary.semanticMergeReadiness
@@ -2586,6 +2587,7 @@ export function createSemanticImportSidecar(importResult, options = {}) {
       ids: sourceMaps.map((sourceMap) => sourceMap.id).filter(Boolean)
     },
     sourcePreservation,
+    universalAstLayers,
     patchHints,
     mergeCandidates: mergeCandidates.map((candidate) => ({
       id: candidate.id,
@@ -2615,6 +2617,8 @@ export function createSemanticImportSidecar(importResult, options = {}) {
       regionKinds: regionTaxonomy.presentKinds.length,
       sourceMapMappings: sourceMapMappings.length,
       sourcePreservationRecords: sourcePreservation.total,
+      universalAstLayers: universalAstLayers.total,
+      universalAstLayerNames: universalAstLayers.names,
       readiness,
       emptySemanticIndex: symbols.length === 0
     },
@@ -8577,6 +8581,7 @@ function semanticImportSidecarEntry(imported, index, options) {
   const sourceMaps = imported?.sourceMaps ?? imported?.universalAst?.sourceMaps ?? [];
   const sourceMapMappings = sourceMaps.flatMap((sourceMap) => sourceMap?.mappings ?? []);
   const sourcePreservationRecords = collectKernelSourcePreservationFromImport(imported);
+  const universalAstLayers = summarizeUniversalAstLayers(imported?.universalAst);
   const mappingsBySymbolId = new Map();
   for (const mapping of sourceMapMappings) {
     if (mapping.semanticSymbolId && !mappingsBySymbolId.has(mapping.semanticSymbolId)) {
@@ -8623,6 +8628,9 @@ function semanticImportSidecarEntry(imported, index, options) {
     sourceMapMappingCount: sourceMapMappings.length,
     sourcePreservationRecordCount: sourcePreservationRecords.length,
     sourcePreservationLevels: uniqueStrings(sourcePreservationRecords.map((record) => record.level).filter(Boolean)),
+    universalAstLayerCount: universalAstLayers.total,
+    universalAstLayerNames: universalAstLayers.names,
+    universalAstLayerIds: universalAstLayers.ids,
     readiness: imported?.metadata?.semanticMergeReadiness ?? imported?.mergeCandidates?.[0]?.readiness ?? 'needs-review',
     emptySemanticIndex: symbols.length === 0,
     regionTaxonomy,
@@ -8631,6 +8639,52 @@ function semanticImportSidecarEntry(imported, index, options) {
   };
 }
 
+function summarizeSemanticImportSidecarUniversalAstLayers(importEntries) {
+  const names = [];
+  const ids = [];
+  const byName = {};
+  for (const entry of importEntries) {
+    names.push(...(entry.universalAstLayerNames ?? []));
+    ids.push(...(entry.universalAstLayerIds ?? []));
+    for (const name of entry.universalAstLayerNames ?? []) {
+      byName[name] = (byName[name] ?? 0) + 1;
+    }
+  }
+  const uniqueNames = uniqueStrings(names);
+  return {
+    total: ids.length,
+    names: uniqueNames,
+    ids: uniqueStrings(ids),
+    byName,
+    empty: ids.length === 0
+  };
+}
+
+function summarizeUniversalAstLayers(universalAst) {
+  const layers = collectUniversalAstLayerRecords(universalAst?.layers);
+  const names = uniqueStrings(layers.map((layer) => layer.layer).filter(Boolean));
+  const ids = uniqueStrings(layers.map((layer) => layer.id).filter(Boolean));
+  const byName = {};
+  for (const layer of layers) {
+    if (!layer?.layer) continue;
+    byName[layer.layer] = (byName[layer.layer] ?? 0) + 1;
+  }
+  return {
+    total: layers.length,
+    names,
+    ids,
+    byName,
+    empty: layers.length === 0
+  };
+}
+
+function collectUniversalAstLayerRecords(layers) {
+  if (!layers) return [];
+  if (Array.isArray(layers)) return layers.filter(Boolean);
+  if (typeof layers !== 'object') return [];
+  return Object.values(layers).flatMap((value) => Array.isArray(value) ? value : [value]).filter(Boolean);
+}
+
 function semanticOwnershipRegionForSymbol(imported, symbol, mapping, nativeNode, options = {}) {
   const sourcePath = mapping?.sourceSpan?.path ?? symbol.definitionSpan?.path ?? nativeNode?.span?.path ?? imported?.sourcePath ?? imported?.nativeSource?.sourcePath ?? imported?.nativeAst?.sourcePath;
   const language = symbol.language ?? imported?.language ?? imported?.nativeAst?.language ?? imported?.nativeSource?.language;
@@ -9359,9 +9413,13 @@ export function createUniversalAstFromDocument(document, input = {}) {
   return createUniversalAstEnvelope({
     id: input.id ?? `universal_ast_${idFragment(document.id)}`,
     document,
+    nativeSources: input.nativeSources,
     semanticIndex: input.semanticIndex,
     sourceMaps: input.sourceMaps ?? [],
+    losses: input.losses,
     evidence: input.evidence ?? [],
+    mergeCandidates: input.mergeCandidates,
+    layers: input.layers,
     metadata: input.metadata
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapeshift-labs/frontier-lang-compiler",
-  "version": "0.2.35",
+  "version": "0.2.36",
   "description": "Compiler facade for Frontier Lang source documents and language projection adapters.",
   "type": "module",
   "main": "./dist/index.js",
@@ -59,7 +59,7 @@
     "@shapeshift-labs/frontier-lang-c": "0.2.5",
     "@shapeshift-labs/frontier-lang-checker": "0.3.4",
     "@shapeshift-labs/frontier-lang-javascript": "0.2.5",
-    "@shapeshift-labs/frontier-lang-kernel": "0.3.5",
+    "@shapeshift-labs/frontier-lang-kernel": "0.3.6",
     "@shapeshift-labs/frontier-lang-parser": "0.3.4",
     "@shapeshift-labs/frontier-lang-python": "0.2.5",
     "@shapeshift-labs/frontier-lang-rust": "0.2.5",