@shapeshift-labs/frontier-lang-compiler 0.2.103 → 0.2.105

package/dist/declarations/js-ts-semantic-merge-contracts.d.ts

@@ -0,0 +1,287 @@
+import type {
+  FrontierSourceLanguage,
+  SemanticMergeReadiness,
+  SourceSpan
+} from '@shapeshift-labs/frontier-lang-kernel';
+
+export type JsTsSemanticMergeLanguage = 'javascript' | 'typescript' | 'jsx' | 'tsx' | FrontierSourceLanguage | string;
+export type JsTsSemanticMergeSourceTokenKind =
+  | 'identifier'
+  | 'keyword'
+  | 'literal'
+  | 'operator'
+  | 'punctuation'
+  | 'template'
+  | 'jsx-text'
+  | 'unknown'
+  | string;
+export type JsTsSemanticMergeTriviaKind = 'whitespace' | 'newline' | 'line-comment' | 'block-comment' | 'directive' | 'shebang' | string;
+export type JsTsSemanticMergeSemanticRegionKind =
+  | 'program'
+  | 'module'
+  | 'import'
+  | 'export'
+  | 'class'
+  | 'interface'
+  | 'type-alias'
+  | 'function'
+  | 'method'
+  | 'field'
+  | 'variable'
+  | 'statement'
+  | 'expression'
+  | 'jsx'
+  | 'unknown'
+  | string;
+export type JsTsSemanticMergeThreeWaySide = 'base' | 'left' | 'right' | 'merged' | string;
+export type JsTsSemanticMergeThreeWayMatchStatus =
+  | 'matched'
+  | 'base-only'
+  | 'left-only'
+  | 'right-only'
+  | 'moved'
+  | 'renamed'
+  | 'ambiguous'
+  | 'missing'
+  | string;
+export type JsTsSemanticMergeStructuredEditKind =
+  | 'insert'
+  | 'delete'
+  | 'replace'
+  | 'move'
+  | 'rename'
+  | 'reorder'
+  | 'update-import'
+  | 'update-export'
+  | 'update-signature'
+  | 'update-body'
+  | 'update-type'
+  | 'update-jsx'
+  | 'update-trivia'
+  | string;
+export type JsTsSemanticMergeConflictClass =
+  | 'same-token-edit'
+  | 'same-region-edit'
+  | 'delete-modify'
+  | 'move-edit'
+  | 'rename-rename'
+  | 'import-order'
+  | 'type-surface-drift'
+  | 'trivia-preservation'
+  | 'behavior-evidence-needed'
+  | string;
+export type JsTsSemanticMergeConflictRisk = 'low' | 'medium' | 'high' | string;
+export type JsTsSemanticMergeGateStatus = 'passed' | 'warning' | 'failed' | 'skipped' | 'blocked' | string;
+
+/** Source-token evidence for JS/TS semantic merge without binding to a parser library. */
+export interface JsTsSemanticMergeSourceToken {
+  readonly schema: 'frontier.lang.jsTsSemanticMergeSourceToken.v1';
+  readonly id: string;
+  readonly kind: JsTsSemanticMergeSourceTokenKind;
+  readonly language?: JsTsSemanticMergeLanguage;
+  readonly sourcePath?: string;
+  readonly sourceHash?: string;
+  readonly text?: string;
+  readonly textHash?: string;
+  readonly span: SourceSpan;
+  readonly triviaBeforeIds?: readonly string[];
+  readonly triviaAfterIds?: readonly string[];
+  readonly semanticRegionId?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+
+/** Trivia span evidence for comments, whitespace, directives, and JSX/source preservation. */
+export interface JsTsSemanticMergeTriviaSpan {
+  readonly schema: 'frontier.lang.jsTsSemanticMergeTriviaSpan.v1';
+  readonly id: string;
+  readonly kind: JsTsSemanticMergeTriviaKind;
+  readonly language?: JsTsSemanticMergeLanguage;
+  readonly sourcePath?: string;
+  readonly sourceHash?: string;
+  readonly text?: string;
+  readonly textHash?: string;
+  readonly span: SourceSpan;
+  readonly attachesToTokenId?: string;
+  readonly attachesToRegionId?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+
+/** Parser-neutral semantic region used to compare JS/TS declarations, statements, JSX, and type surfaces. */
+export interface JsTsSemanticMergeSemanticRegion {
+  readonly schema: 'frontier.lang.jsTsSemanticMergeSemanticRegion.v1';
+  readonly id: string;
+  readonly kind: JsTsSemanticMergeSemanticRegionKind;
+  readonly regionKey: string;
+  readonly conflictKey: string;
+  readonly language?: JsTsSemanticMergeLanguage;
+  readonly sourcePath?: string;
+  readonly sourceHash?: string;
+  readonly stableHash?: string;
+  readonly symbolId?: string;
+  readonly symbolName?: string;
+  readonly symbolKind?: string;
+  readonly parentRegionId?: string;
+  readonly childRegionIds?: readonly string[];
+  readonly tokenIds?: readonly string[];
+  readonly triviaIds?: readonly string[];
+  readonly span?: SourceSpan;
+  readonly metadata?: Record<string, unknown>;
+}
+
+export interface JsTsSemanticMergeThreeWayEndpoint {
+  readonly side: JsTsSemanticMergeThreeWaySide;
+  readonly regionId?: string;
+  readonly tokenId?: string;
+  readonly sourcePath?: string;
+  readonly sourceHash?: string;
+  readonly span?: SourceSpan;
+  readonly semanticHash?: string;
+  readonly textHash?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+
+/** Three-way match record connecting base, left, and right JS/TS merge evidence. */
+export interface JsTsSemanticMergeThreeWayMatch {
+  readonly schema: 'frontier.lang.jsTsSemanticMergeThreeWayMatch.v1';
+  readonly id: string;
+  readonly matchKey: string;
+  readonly status: JsTsSemanticMergeThreeWayMatchStatus;
+  readonly confidence: number;
+  readonly base?: JsTsSemanticMergeThreeWayEndpoint;
+  readonly left?: JsTsSemanticMergeThreeWayEndpoint;
+  readonly right?: JsTsSemanticMergeThreeWayEndpoint;
+  readonly regionIds?: readonly string[];
+  readonly tokenIds?: readonly string[];
+  readonly reasonCodes: readonly string[];
+  readonly metadata?: Record<string, unknown>;
+}
+
+/** Structured JS/TS edit evidence, separate from concrete parser or diff-library nodes. */
+export interface JsTsSemanticMergeStructuredEdit {
+  readonly schema: 'frontier.lang.jsTsSemanticMergeStructuredEdit.v1';
+  readonly id: string;
+  readonly editKey: string;
+  readonly side: JsTsSemanticMergeThreeWaySide;
+  readonly kind: JsTsSemanticMergeStructuredEditKind;
+  readonly targetRegionId?: string;
+  readonly targetTokenId?: string;
+  readonly sourcePath?: string;
+  readonly beforeHash?: string;
+  readonly afterHash?: string;
+  readonly replacementTextHash?: string;
+  readonly insertedTextHash?: string;
+  readonly deletedTextHash?: string;
+  readonly matchIds?: readonly string[];
+  readonly regionIds?: readonly string[];
+  readonly tokenIds?: readonly string[];
+  readonly triviaIds?: readonly string[];
+  readonly conflictKey?: string;
+  readonly reasonCodes: readonly string[];
+  readonly evidenceIds?: readonly string[];
+  readonly metadata?: Record<string, unknown>;
+}
+
+export interface JsTsSemanticMergeConflictSide {
+  readonly side: JsTsSemanticMergeThreeWaySide;
+  readonly sourcePath?: string;
+  readonly sourceHash?: string;
+  readonly editIds?: readonly string[];
+  readonly regionIds?: readonly string[];
+  readonly tokenIds?: readonly string[];
+  readonly summary?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+
+/** Normalized explanation for a JS/TS semantic merge conflict. */
+export interface JsTsSemanticMergeConflictExplanation {
+  readonly kind: 'frontier.lang.jsTsSemanticMergeConflictExplanation';
+  readonly version: 1;
+  readonly schema: 'frontier.lang.jsTsSemanticMergeConflictExplanation.v1';
+  readonly id: string;
+  readonly stableId: string;
+  readonly hash: string;
+  readonly conflictClass: JsTsSemanticMergeConflictClass;
+  readonly risk: JsTsSemanticMergeConflictRisk;
+  readonly readiness: SemanticMergeReadiness | string;
+  readonly language?: JsTsSemanticMergeLanguage;
+  readonly sourcePath?: string;
+  readonly title?: string;
+  readonly summary?: string;
+  readonly conflictKeys: readonly string[];
+  readonly matchIds: readonly string[];
+  readonly editIds: readonly string[];
+  readonly regionIds: readonly string[];
+  readonly tokenIds: readonly string[];
+  readonly triviaIds: readonly string[];
+  readonly evidenceIds: readonly string[];
+  readonly reasonCodes: readonly string[];
+  readonly sides: {
+    readonly base?: JsTsSemanticMergeConflictSide;
+    readonly left?: JsTsSemanticMergeConflictSide;
+    readonly right?: JsTsSemanticMergeConflictSide;
+  };
+  readonly suggestedAction: 'merge' | 'manual-review' | 'rerun-gates' | 'block' | string;
+  readonly metadata?: Record<string, unknown>;
+}
+
+export interface JsTsSemanticMergeGateCheck {
+  readonly id: string;
+  readonly name?: string;
+  readonly status: JsTsSemanticMergeGateStatus;
+  readonly readiness?: SemanticMergeReadiness | string;
+  readonly reasonCodes: readonly string[];
+  readonly evidenceIds?: readonly string[];
+  readonly hash?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+
+/** Merge gate result for deciding whether normalized JS/TS merge evidence can proceed. */
+export interface JsTsSemanticMergeGateResult {
+  readonly kind: 'frontier.lang.jsTsSemanticMergeGateResult';
+  readonly version: 1;
+  readonly schema: 'frontier.lang.jsTsSemanticMergeGateResult.v1';
+  readonly id: string;
+  readonly stableId: string;
+  readonly hash: string;
+  readonly gateId: string;
+  readonly status: JsTsSemanticMergeGateStatus;
+  readonly readiness: SemanticMergeReadiness | string;
+  readonly mergeable: boolean;
+  readonly action: 'merge' | 'review' | 'skip' | 'block' | string;
+  readonly confidence: number;
+  readonly checks: readonly JsTsSemanticMergeGateCheck[];
+  readonly conflictExplanations: readonly JsTsSemanticMergeConflictExplanation[];
+  readonly conflictExplanationIds: readonly string[];
+  readonly structuredEditIds: readonly string[];
+  readonly semanticRegionIds: readonly string[];
+  readonly evidenceIds: readonly string[];
+  readonly reasonCodes: readonly string[];
+  readonly summary: {
+    readonly checks: number;
+    readonly conflicts: number;
+    readonly failedChecks: number;
+    readonly warningChecks: number;
+    readonly blockedChecks: number;
+    readonly evidenceIds: number;
+    readonly reasonCodes: readonly string[];
+  };
+  readonly metadata?: Record<string, unknown>;
+}
+
+export type JsTsSemanticMergeConflictExplanationInput =
+  Partial<JsTsSemanticMergeConflictExplanation> & Record<string, unknown>;
+export type JsTsSemanticMergeGateResultInput =
+  Partial<JsTsSemanticMergeGateResult> & Record<string, unknown>;
+
+export interface CreateJsTsSemanticMergeConflictExplanationOptions extends JsTsSemanticMergeConflictExplanationInput {
+  readonly conflictKey?: string;
+}
+
+export interface CreateJsTsSemanticMergeGateResultOptions extends JsTsSemanticMergeGateResultInput {
+  readonly conflicts?: readonly JsTsSemanticMergeConflictExplanationInput[];
+}
+
+export declare const JsTsSemanticMergeConflictClasses: readonly JsTsSemanticMergeConflictClass[];
+export declare const JsTsSemanticMergeGateStatuses: readonly JsTsSemanticMergeGateStatus[];
+export declare function createJsTsSemanticMergeConflictExplanation(input?: JsTsSemanticMergeConflictExplanationInput, options?: CreateJsTsSemanticMergeConflictExplanationOptions): JsTsSemanticMergeConflictExplanation;
+export declare function createJsTsSemanticMergeGateResult(input?: JsTsSemanticMergeGateResultInput, options?: CreateJsTsSemanticMergeGateResultOptions): JsTsSemanticMergeGateResult;

package/dist/declarations/js-ts-semantic-merge.d.ts

@@ -0,0 +1,4 @@
+export * from './js-ts-safe-merge.js';
+export * from './js-ts-safe-member-merge.js';
+export * from './js-ts-semantic-merge-contracts.js';
+export * from './js-ts-semantic-conflict-sidecars.js';

package/dist/declarations/native-import-losses.d.ts

@@ -98,10 +98,13 @@ export type NativeImportRegionTaxonomyKind =
   | 'symbol'
   | 'declaration'
   | 'import'
+  | 'export'
   | 'body'
   | 'call'
   | 'type'
+  | 'controlFlow'
   | 'effect'
+  | 'mutation'
   | 'property'
   | 'config'
   | 'content'

package/dist/declarations/semantic-edit-replay-diagnostics.d.ts

@@ -12,6 +12,18 @@ export interface SemanticEditReplayDiagnostic {
   readonly status?: SemanticEditReplayStatus | string;
   readonly operationId?: string;
   readonly sourcePath?: string;
+  readonly originalSourcePath?: string;
+  readonly targetSourcePath?: string;
+  readonly anchorKey?: string;
+  readonly targetAnchorKey?: string;
+  readonly sourceIdentityStatus?: 'same-source' | 'moved-source' | string;
+  readonly sourceIdentityAnchorKey?: string;
+  readonly targetIdentityAnchorKey?: string;
+  readonly sourceIdentitySourcePath?: string;
+  readonly targetIdentitySourcePath?: string;
+  readonly semanticIdentityHash?: string;
+  readonly sourceIdentityHash?: string;
+  readonly editContentHash?: string;
   readonly symbolName?: string;
   readonly symbolKind?: string;
   readonly editKind?: 'replace' | 'insert' | 'delete' | string;

package/dist/declarations/semantic-edit-script.d.ts

@@ -137,15 +137,18 @@ export interface SemanticEditProjectionEdit {
   readonly semanticKey?: string;
   readonly semanticIdentityHash?: string;
   readonly sourceIdentityHash?: string;
+  readonly sourceIdentityStatus?: 'same-source' | 'moved-source' | string;
+  readonly sourceIdentityAnchorKey?: string; readonly targetIdentityAnchorKey?: string;
+  readonly sourceIdentitySourcePath?: string; readonly targetIdentitySourcePath?: string;
   readonly operationContentHash?: string;
   readonly editContentHash?: string;
-  readonly headStart: number;
-  readonly headEnd: number;
-  readonly workerStart?: number;
-  readonly workerEnd?: number;
+  readonly headStart: number; readonly headEnd: number;
+  readonly workerStart?: number; readonly workerEnd?: number;
+  readonly headAnchorStart?: number; readonly headAnchorEnd?: number;
   readonly deletedBytes: number;
   readonly replacementBytes: number;
   readonly deletedTextHash?: string;
+  readonly deletedText?: string;
   readonly replacementTextHash?: string;
   readonly deletedTextLineEndingStableHash?: string;
   readonly replacementTextLineEndingStableHash?: string;

package/dist/declarations/semantic-patch-bundle-index.d.ts

@@ -11,6 +11,12 @@ export interface SemanticPatchBundleRecordIndex {
   readonly sourceMapLinkIds: readonly string[];
   readonly evidenceIds: readonly string[];
   readonly proofIds: readonly string[];
+  readonly lineageResolutionIds: readonly string[];
+  readonly lineageEventIds: readonly string[];
+  readonly lineageSourcePaths: readonly string[];
+  readonly lineageEvidenceIds: readonly string[];
+  readonly lineageProofIds: readonly string[];
+  readonly lineageReasonCodes: readonly string[];
   readonly historyIds: readonly string[];
   readonly semanticOperationIds: readonly string[];
   readonly semanticEditScriptIds: readonly string[];
@@ -18,11 +24,13 @@ export interface SemanticPatchBundleRecordIndex {
   readonly semanticEditReplayIds: readonly string[];
   readonly semanticEditReplayStatuses: readonly string[];
   readonly semanticEditReplayActions: readonly string[];
+  readonly semanticEditReplayReasonCodes: readonly string[];
   readonly semanticEditAdmissionStatuses: readonly string[];
   readonly semanticEditAdmissionActions: readonly string[];
   readonly semanticEditAdmissionReadinesses: readonly string[];
   readonly semanticEditReplayCurrentHashes: readonly string[];
   readonly semanticEditReplayOutputHashes: readonly string[];
+  readonly sourceBackprojectionModes: readonly string[];
   readonly semanticEditKeys: readonly string[];
   readonly semanticIdentityHashes: readonly string[];
   readonly sourceIdentityHashes: readonly string[];
@@ -33,12 +41,18 @@ export interface SemanticPatchBundleRecordIndex {
   readonly semanticTransformIdentityHashes: readonly string[];
   readonly semanticTransformContentHashes: readonly string[];
   readonly projectionIdentityHashes: readonly string[];
+  readonly transformBaseHashes: readonly string[];
+  readonly transformTargetHashes: readonly string[];
   readonly semanticTransformReadinesses: readonly string[];
   readonly semanticTransformEvidenceIds: readonly string[];
   readonly transformSourceLanguages: readonly string[];
   readonly transformTargetLanguages: readonly string[];
   readonly transformSourcePaths: readonly string[];
   readonly transformTargetPaths: readonly string[];
+  readonly transformCrossLanguages: readonly string[];
+  readonly transformSourceMapIds: readonly string[];
+  readonly transformSourceMapLinkIds: readonly string[];
+  readonly transformSourceMapMappingIds: readonly string[];
   readonly targetPortabilityStatuses: readonly string[];
   readonly targetPortabilityActions: readonly string[];
   readonly targetPortabilityReasonCodes: readonly string[];
@@ -47,3 +61,34 @@ export interface SemanticPatchBundleRecordIndex {
   readonly readinesses: readonly string[];
   readonly admissionStatuses: readonly string[];
 }
+
+export interface SemanticPatchBundleRecordQueryIndexFilters {
+  readonly lineageResolutionId?: string | readonly string[];
+  readonly lineageResolutionIds?: readonly string[];
+  readonly lineageEventId?: string | readonly string[];
+  readonly lineageEventIds?: readonly string[];
+  readonly lineageSourcePath?: string | readonly string[];
+  readonly lineageSourcePaths?: readonly string[];
+  readonly lineageEvidenceId?: string | readonly string[];
+  readonly lineageEvidenceIds?: readonly string[];
+  readonly lineageProofId?: string | readonly string[];
+  readonly lineageProofIds?: readonly string[];
+  readonly lineageReasonCode?: string | readonly string[];
+  readonly lineageReasonCodes?: readonly string[];
+  readonly sourceBackprojectionMode?: string | readonly string[];
+  readonly sourceBackprojectionModes?: readonly string[];
+  readonly semanticEditReplayReasonCode?: string | readonly string[];
+  readonly semanticEditReplayReasonCodes?: readonly string[];
+  readonly transformBaseHash?: string | readonly string[];
+  readonly transformBaseHashes?: readonly string[];
+  readonly transformTargetHash?: string | readonly string[];
+  readonly transformTargetHashes?: readonly string[];
+  readonly transformCrossLanguage?: boolean | string | readonly string[];
+  readonly transformCrossLanguages?: readonly string[];
+  readonly transformSourceMapId?: string | readonly string[];
+  readonly transformSourceMapIds?: readonly string[];
+  readonly transformSourceMapLinkId?: string | readonly string[];
+  readonly transformSourceMapLinkIds?: readonly string[];
+  readonly transformSourceMapMappingId?: string | readonly string[];
+  readonly transformSourceMapMappingIds?: readonly string[];
+}

package/dist/declarations/semantic-patch-bundle.d.ts

@@ -9,11 +9,11 @@ import type {
 import type { NativeSourceChangeKind, NativeSourceChangeSet } from './native-diff.js';
 import type { SemanticEditBundleAdmission } from './semantic-edit-bundle.js';
 import type { SemanticEditProjection, SemanticEditReplay, SemanticEditScript } from './semantic-edit-script.js';
-import type { SemanticPatchBundleRecordIndex } from './semantic-patch-bundle-index.js';
+import type { SemanticPatchBundleRecordIndex, SemanticPatchBundleRecordQueryIndexFilters } from './semantic-patch-bundle-index.js';
 import type { SemanticTransformIdentityRecord } from './semantic-transform-identity.js';
 import type { BidirectionalTargetPortabilityRecord } from './bidirectional-target-change.js';
 
-export type { SemanticPatchBundleRecordIndex } from './semantic-patch-bundle-index.js';
+export type { SemanticPatchBundleRecordIndex, SemanticPatchBundleRecordQueryIndexFilters } from './semantic-patch-bundle-index.js';
 
 export type SemanticPatchBundleAdmissionStatus = 'proposed' | 'queued' | 'admitted' | 'needs-review' | 'blocked' | 'rejected' | string;
 
@@ -78,6 +78,7 @@ export interface SemanticPatchBundleSourceMapLink {
   readonly precision?: string;
   readonly sourceSpan?: SourceSpan;
   readonly generatedSpan?: SourceMapMappingRecord['generatedSpan'];
+  readonly sourceReplacementText?: string; readonly sourceReplacementTextHash?: string;
   readonly regionKey?: string;
   readonly regionKind?: string;
 }
@@ -121,10 +122,12 @@ export interface SemanticPatchBundleTransformAdmission {
   readonly transformKeys?: readonly string[];
   readonly contentHashes?: readonly string[];
   readonly projectionIdentityHashes?: readonly string[];
+  readonly baseHashes?: readonly string[]; readonly targetHashes?: readonly string[];
   readonly sourceLanguages?: readonly string[];
   readonly targetLanguages?: readonly string[];
   readonly sourcePaths?: readonly string[];
   readonly targetPaths?: readonly string[];
+  readonly sourceMapIds?: readonly string[]; readonly sourceMapLinkIds?: readonly string[]; readonly sourceMapMappingIds?: readonly string[];
   readonly evidenceIds?: readonly string[];
 }
 
@@ -214,7 +217,7 @@ export interface CreateSemanticPatchBundleRecordOptions {
 
 export type CreateSemanticPatchBundleRecordInput = NativeSourceChangeSet | Partial<SemanticPatchBundleRecord> | Record<string, unknown>;
 
-export interface SemanticPatchBundleRecordQuery {
+export interface SemanticPatchBundleRecordQuery extends SemanticPatchBundleRecordQueryIndexFilters {
   readonly id?: string | readonly string[];
   readonly ids?: readonly string[];
   readonly patchId?: string | readonly string[];
@@ -312,7 +315,6 @@ export interface SemanticPatchBundleRecordQuery {
   readonly admissionStatus?: SemanticPatchBundleAdmissionStatus | readonly string[];
   readonly admissionStatuses?: readonly string[];
 }
-
 export declare const SemanticPatchBundleAdmissionStatuses: readonly SemanticPatchBundleAdmissionStatus[];
 export declare function createSemanticPatchBundleRecord(input?: CreateSemanticPatchBundleRecordInput, options?: CreateSemanticPatchBundleRecordOptions): SemanticPatchBundleRecord;
 export declare function querySemanticPatchBundleRecords(records: SemanticPatchBundleRecord | readonly SemanticPatchBundleRecord[], query?: SemanticPatchBundleRecordQuery): readonly SemanticPatchBundleRecord[];

package/dist/declarations/semantic-sidecar-example.d.ts

@@ -0,0 +1,18 @@
+import type { SemanticImportSidecar } from './semantic-sidecar.js';
+
+export interface SemanticImportSidecarSourceRevisionExample {
+  readonly path: string;
+  readonly hash: string;
+  readonly identityHash: string;
+  readonly text?: string;
+}
+
+export interface SemanticImportSidecarCompactExample {
+  readonly schema: 'frontier.lang.semanticImportSidecar.example.compact.v1';
+  readonly baseSource: SemanticImportSidecarSourceRevisionExample;
+  readonly headSource: SemanticImportSidecarSourceRevisionExample;
+  readonly identityHashes: Readonly<Record<string, string>>;
+  readonly sidecar: SemanticImportSidecar;
+}
+
+export declare const compactSemanticSidecarExample: SemanticImportSidecarCompactExample;

package/dist/declarations/semantic-transform-identity.d.ts

@@ -20,6 +20,9 @@ export interface SemanticTransformIdentityRecord {
   readonly transformIdentityHash?: string;
   readonly projectionIdentityHash?: string;
   readonly transformContentHash?: string;
+  readonly sourceMapIds?: readonly string[];
+  readonly sourceMapLinkIds?: readonly string[];
+  readonly sourceMapMappingIds?: readonly string[];
   readonly readiness?: string;
   readonly confidence?: number;
   readonly evidenceIds?: readonly string[];

package/dist/declarations/source-preservation.d.ts

@@ -54,11 +54,16 @@ export type NativeSourceTokenKind =
   | 'keyword'
   | 'number'
   | 'string'
+  | 'template'
+  | 'regex-like'
+  | 'jsx'
   | 'operator'
   | 'punctuation'
   | 'comment'
+  | 'source-map-comment'
   | 'whitespace'
   | 'newline'
+  | 'shebang'
   | 'directive'
   | 'unknown'
   | string;
@@ -81,6 +86,65 @@ export interface NativeSourcePreservedDirective {
   readonly metadata?: Record<string, unknown>;
 }
 
+export type NativeSourceLedgerSpanRole =
+  | 'token'
+  | 'trivia'
+  | 'comment'
+  | 'directive'
+  | 'module-keyword'
+  | 'brace'
+  | 'protected'
+  | string;
+
+export interface NativeSourceLedgerSpan {
+  readonly id: string;
+  readonly kind: string;
+  readonly role: NativeSourceLedgerSpanRole;
+  readonly text?: string;
+  readonly textHash: string;
+  readonly span: SourceSpan;
+  readonly metadata?: Record<string, unknown>;
+}
+
+export interface NativeSourceLedgerSummary {
+  readonly spans: number;
+  readonly tokens: number;
+  readonly trivia: number;
+  readonly comments: number;
+  readonly shebangs: number;
+  readonly directives: number;
+  readonly sourceMapComments: number;
+  readonly importExportSpans: number;
+  readonly braces: number;
+  readonly protectedRegions: number;
+  readonly stringRegions: number;
+  readonly templateRegions: number;
+  readonly regexLikeRegions: number;
+  readonly jsxRegions: number;
+  readonly triviaByKind?: Record<string, number>;
+  readonly tokenByKind?: Record<string, number>;
+  readonly directiveByKind?: Record<string, number>;
+  readonly truncated: boolean;
+}
+
+export interface NativeSourceLedger {
+  readonly kind: 'frontier.lang.jsTsSourceLedger';
+  readonly version: 1;
+  readonly language: FrontierSourceLanguage | string;
+  readonly sourcePath?: string;
+  readonly sourceHash: string;
+  readonly spans: readonly NativeSourceLedgerSpan[];
+  readonly tokens: readonly NativeSourceLedgerSpan[];
+  readonly trivia: readonly NativeSourceLedgerSpan[];
+  readonly comments: readonly NativeSourceLedgerSpan[];
+  readonly shebangs: readonly NativeSourceLedgerSpan[];
+  readonly directives: readonly NativeSourceLedgerSpan[];
+  readonly importExportSpans: readonly NativeSourceLedgerSpan[];
+  readonly braces: readonly NativeSourceLedgerSpan[];
+  readonly protectedRegions: readonly NativeSourceLedgerSpan[];
+  readonly summary: NativeSourceLedgerSummary;
+}
+
 export interface NativeSourcePreservation {
   readonly kind: 'frontier.lang.nativeSourcePreservation';
   readonly version: 1;
@@ -96,12 +160,18 @@ export interface NativeSourcePreservation {
   readonly tokens: readonly NativeSourcePreservedToken[];
   readonly trivia: readonly NativeSourcePreservedToken[];
   readonly directives: readonly NativeSourcePreservedDirective[];
+  readonly ledger?: NativeSourceLedger;
   readonly summary: {
     readonly tokens: number;
     readonly trivia: number;
     readonly directives: number;
     readonly comments: number;
     readonly whitespace: number;
+    readonly ledger?: NativeSourceLedgerSummary;
+    readonly sourceMapComments?: number;
+    readonly protectedRegions?: number;
+    readonly importExportSpans?: number;
+    readonly braces?: number;
     readonly exactSourceAvailable: boolean;
     readonly truncated: boolean;
   };
@@ -119,8 +189,10 @@ export interface CreateNativeSourcePreservationOptions {
   readonly includeTokens?: boolean;
   readonly includeTrivia?: boolean;
   readonly includeDirectives?: boolean;
+  readonly includeSourceLedger?: boolean;
   readonly maxTokens?: number;
   readonly maxTrivia?: number;
   readonly maxDirectives?: number;
+  readonly maxLedgerSpans?: number;
   readonly metadata?: Record<string, unknown>;
 }

package/dist/declarations/universal-capability.d.ts

@@ -49,6 +49,7 @@ import type { JavaAstNativeImporterAdapterOptions, KotlinPsiNativeImporterAdapte
 import type { NativeTargetProjectionAdapterCoverageInput, NativeTargetProjectionAdapterSummary, NativeTargetProjectionAdapterInput, NativeTargetProjectionAdapterResult, NativeTargetProjectionAdapter, NativeTargetProjectionAdapterResolverInput, NativeTargetProjectionResult } from './target-adapters.js';
 import type { NativeProjectSourceInput, ImportNativeProjectOptions, NativeProjectImportResult, NativeSourceProjectionMode, ProjectNativeImportToSourceOptions, NativeSourceProjectionDeclaration, NativeSourceProjectionResult, NativeSourceCompileOutputMode, CompileNativeSourceOptions, NativeSourceCompileResult } from './native-project.js';
 import type { NativeImportRoundtripReadinessStatus, NativeImportRoundtripReadinessOptions, NativeImportRoundtripReadinessClassification } from './roundtrip.js';
+import type { UniversalRepresentationCoverage } from './universal-representation-coverage.js';
 
 export interface UniversalCapabilityLanguageRow {
   readonly language: FrontierSourceLanguage | string;
@@ -89,6 +90,7 @@ export interface UniversalCapabilityLanguageRow {
     readonly knownLossKinds: readonly NativeImportKnownLossKind[];
     readonly sourceMapMappings: number;
   };
+  readonly representation: UniversalRepresentationCoverage;
   readonly blockers: readonly string[];
   readonly review: readonly string[];
 }
@@ -111,6 +113,8 @@ export interface UniversalCapabilityMatrix {
     readonly unsupportedTargetFeatures: number;
     readonly exactSourceProjection: number;
     readonly nativeSourceStubs: number;
+    readonly representationConstructs: number;
+    readonly representationMissing: number;
     readonly blockers: number;
     readonly reviewReasons: number;
     readonly readyLanguages: number;