@shapeshift-labs/frontier-lang-compiler 0.2.40 → 0.2.42

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

@@ -0,0 +1,19 @@
+import{nativeImportEntries}from'./nativeImportEntries.js';import{nativeImportSourceText}from'./nativeImportSourceText.js';
+export function semanticSliceSourceTextMap(imported, universalAst, value, options) {
+  const entries = new Map();
+  const add = (path, sourceText) => {
+    if (typeof sourceText !== 'string') return;
+    entries.set(path ?? '', sourceText);
+  };
+  add(options.sourcePath, options.sourceText);
+  add(value?.sourcePath, value?.sourceText);
+  for (const item of [imported, ...(imported ? nativeImportEntries(imported) : [])]) {
+    add(item?.sourcePath, nativeImportSourceText(item));
+    add(item?.nativeSource?.sourcePath, item?.nativeSource?.metadata?.sourcePreservation?.sourceText);
+  }
+  for (const nativeSource of universalAst?.nativeSources ?? []) {
+    add(nativeSource?.sourcePath, nativeSource?.metadata?.sourcePreservation?.sourceText);
+    add(nativeSource?.sourcePath, nativeSource?.ast?.metadata?.sourcePreservation?.sourceText);
+  }
+  return entries;
+}

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

@@ -0,0 +1,6 @@
+import{semanticSliceSpansOverlap}from'./semanticSliceSpansOverlap.js';
+export function semanticSliceSpanTouchesSelection(span, mappings, regions) {
+  if (!span) return false;
+  return mappings.some((mapping) => mapping.sourceSpan === span || semanticSliceSpansOverlap(mapping.sourceSpan, span))
+    || regions.some((region) => semanticSliceSpansOverlap(region.sourceSpan, span));
+}

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

@@ -0,0 +1,15 @@
+export function semanticSliceSpansOverlap(left, right) {
+  if (!left || !right) return false;
+  const leftPath = left.path ?? left.sourceId;
+  const rightPath = right.path ?? right.sourceId;
+  if (leftPath && rightPath && leftPath !== rightPath) return false;
+  if (typeof left.start === 'number' && typeof left.end === 'number' && typeof right.start === 'number' && typeof right.end === 'number') {
+    return left.start <= right.end && right.start <= left.end;
+  }
+  if (typeof left.startLine === 'number' && typeof right.startLine === 'number') {
+    const leftEnd = left.endLine ?? left.startLine;
+    const rightEnd = right.endLine ?? right.startLine;
+    return left.startLine <= rightEnd && right.startLine <= leftEnd;
+  }
+  return false;
+}

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

@@ -0,0 +1,13 @@
+import{normalizeSemanticSliceRef}from'./normalizeSemanticSliceRef.js';import{semanticSliceValueMatches}from'./semanticSliceValueMatches.js';
+export function semanticSliceSymbolMatchesRef(symbol, ref) {
+  const normalized = normalizeSemanticSliceRef(ref, 'symbol');
+  return [
+    symbol.id,
+    symbol.name,
+    symbol.displayName,
+    symbol.signature,
+    symbol.nativeAstNodeId,
+    symbol.metadata?.ownershipRegionId,
+    symbol.metadata?.ownershipRegionKey
+  ].filter(Boolean).some((value) => semanticSliceValueMatches(value, normalized));
+}

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

@@ -0,0 +1,3 @@
+export function semanticSliceSymbolSpan(symbol) {
+  return symbol.sourceSpan ?? symbol.definitionSpan ?? symbol.span;
+}

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

@@ -0,0 +1,7 @@
+export function semanticSliceSymbolTouchesSets(symbol, selection) {
+  return selection.selectedSymbols.has(symbol.id)
+    || selection.selectedNativeNodes.has(symbol.nativeAstNodeId)
+    || selection.selectedRegions.has(symbol.ownershipRegionId)
+    || selection.selectedRegions.has(symbol.metadata?.ownershipRegionId)
+    || selection.selectedRegions.has(symbol.metadata?.ownershipRegionKey);
+}

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

@@ -0,0 +1,16 @@
+import{semanticSliceSymbolSpan}from'./semanticSliceSymbolSpan.js';
+export function semanticSliceTouchedSymbol(symbol) {
+  return {
+    id: symbol.id,
+    name: symbol.name,
+    kind: symbol.kind,
+    nativeAstNodeId: symbol.nativeAstNodeId,
+    span: semanticSliceSymbolSpan(symbol),
+    conflictKey: symbol.metadata?.ownershipRegionKey ? `region:${symbol.metadata.ownershipRegionKey}` : `symbol:${symbol.id}`,
+    metadata: {
+      ownershipRegionId: symbol.ownershipRegionId ?? symbol.metadata?.ownershipRegionId,
+      ownershipRegionKind: symbol.ownershipRegionKind ?? symbol.metadata?.ownershipRegionKind,
+      signatureHash: symbol.signatureHash
+    }
+  };
+}

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

@@ -0,0 +1,6 @@
+export function semanticSliceValueMatches(value, ref) {
+  if (!value || !ref) return false;
+  const left = String(value);
+  const right = String(ref);
+  return left === right || left.endsWith(`:${right}`) || left.includes(right);
+}

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

@@ -0,0 +1,7 @@
+export function semanticTokenModifiers(bitset, modifiers = []) {
+  const result = [];
+  for (let index = 0; index < modifiers.length; index += 1) {
+    if ((bitset & (1 << index)) > 0) result.push(modifiers[index]);
+  }
+  return result;
+}

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

@@ -0,0 +1,13 @@
+export function serializableDiagnostic(diagnostic) {
+  return {
+    id: diagnostic.id,
+    severity: diagnostic.severity,
+    code: diagnostic.code,
+    phase: diagnostic.phase,
+    kind: diagnostic.kind,
+    message: diagnostic.message,
+    path: diagnostic.path,
+    span: diagnostic.span,
+    metadata: diagnostic.metadata
+  };
+}

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

@@ -0,0 +1,10 @@
+export function serializableIncludeGraphSummary(value) {
+  if (!value || typeof value !== 'object') return undefined;
+  if (Array.isArray(value)) return { edgeCount: value.length };
+  const summary = {};
+  if (typeof value.hash === 'string') summary.hash = value.hash;
+  if (typeof value.root === 'string') summary.root = value.root;
+  if (Array.isArray(value.edges)) summary.edgeCount = value.edges.length;
+  if (Array.isArray(value.includes)) summary.includeCount = value.includes.length;
+  return Object.keys(summary).length ? summary : { present: true };
+}

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

@@ -0,0 +1,6 @@
+export function shortNodeText(node) {
+  if (!node || typeof node.text !== 'string') return undefined;
+  const text = node.text.trim();
+  if (!text || text.length > 160) return undefined;
+  return text.replace(/^['"]|['"]$/g, '');
+}

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

@@ -0,0 +1,8 @@
+import{renderCAstWithSourceMap}from'@shapeshift-labs/frontier-lang-c';import{renderJavaScriptAstWithSourceMap}from'@shapeshift-labs/frontier-lang-javascript';import{renderPythonAstWithSourceMap}from'@shapeshift-labs/frontier-lang-python';import{renderRustAstWithSourceMap}from'@shapeshift-labs/frontier-lang-rust';import{renderTypeScriptAstWithSourceMap}from'@shapeshift-labs/frontier-lang-typescript';
+export const sourceMapRenderers = Object.freeze({
+  typescript: renderTypeScriptAstWithSourceMap,
+  javascript: renderJavaScriptAstWithSourceMap,
+  rust: renderRustAstWithSourceMap,
+  python: renderPythonAstWithSourceMap,
+  c: renderCAstWithSourceMap
+});

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

@@ -0,0 +1,5 @@
+export function sourcePreservationFromProjectionContext(context) {
+  return context.nativeSource?.metadata?.sourcePreservation
+    ?? context.nativeAst?.metadata?.sourcePreservation
+    ?? context.nativeSource?.ast?.metadata?.sourcePreservation;
+}

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

@@ -0,0 +1,4 @@
+export function sourceSpanPathMatches(span, sourcePath) {
+  if (!span || !sourcePath) return false;
+  return span.path === sourcePath || span.sourceId === sourcePath;
+}

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

@@ -0,0 +1,12 @@
+export function sourceTextForSpan(sourceText, span) {
+  if (typeof sourceText !== 'string' || !span) return undefined;
+  if (typeof span.start === 'number' && typeof span.end === 'number' && span.end >= span.start) {
+    return sourceText.slice(span.start, span.end);
+  }
+  if (typeof span.startLine === 'number') {
+    const lines = sourceText.split(/\r?\n/);
+    const endLine = typeof span.endLine === 'number' && span.endLine >= span.startLine ? span.endLine : span.startLine;
+    return lines.slice(span.startLine - 1, endLine).join('\n');
+  }
+  return undefined;
+}

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

@@ -0,0 +1,12 @@
+export function spanFromCSharpLineFields(node, input) {
+  const startLine = node.startLine ?? node.line ?? node.beginLine;
+  if (typeof startLine !== 'number') return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: node.path ?? node.filePath ?? node.file ?? input.sourcePath,
+    startLine,
+    startColumn: node.startColumn ?? node.column ?? node.beginColumn,
+    endLine: node.endLine,
+    endColumn: node.endColumn
+  };
+}

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

@@ -0,0 +1,18 @@
+export function spanFromCSharpLineSpan(lineSpan, input) {
+  if (!lineSpan || typeof lineSpan !== 'object') return undefined;
+  const start = lineSpan.startLinePosition ?? lineSpan.StartLinePosition ?? lineSpan.start ?? lineSpan.Start;
+  const end = lineSpan.endLinePosition ?? lineSpan.EndLinePosition ?? lineSpan.end ?? lineSpan.End;
+  const line = start?.line ?? start?.Line;
+  if (typeof line !== 'number') return undefined;
+  const character = start.character ?? start.Character ?? start.column ?? start.Column;
+  const endLine = end?.line ?? end?.Line;
+  const endCharacter = end?.character ?? end?.Character ?? end?.column ?? end?.Column;
+  return {
+    sourceId: input.sourceHash,
+    path: lineSpan.path ?? lineSpan.filePath ?? lineSpan.FilePath ?? input.sourcePath,
+    startLine: line + 1,
+    startColumn: typeof character === 'number' ? character + 1 : undefined,
+    endLine: typeof endLine === 'number' ? endLine + 1 : undefined,
+    endColumn: typeof endCharacter === 'number' ? endCharacter + 1 : undefined
+  };
+}

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

@@ -0,0 +1,19 @@
+import{csharpRoslynPosition}from'./csharpRoslynPosition.js';import{spanFromCSharpLineFields}from'./spanFromCSharpLineFields.js';import{spanFromCSharpLineSpan}from'./spanFromCSharpLineSpan.js';
+export function spanFromCSharpRoslynNode(node, input, options = {}) {
+  const lineSpan = node.lineSpan ?? node.location?.lineSpan ?? node.location?.LineSpan ?? node.FileLinePositionSpan;
+  const fromLineSpan = spanFromCSharpLineSpan(lineSpan, input);
+  if (fromLineSpan) return fromLineSpan;
+  const direct = spanFromCSharpLineFields(node, input);
+  if (direct) return direct;
+  const start = csharpRoslynPosition(node.start ?? node.Start ?? node.span?.start ?? node.Span?.Start ?? node.position, options);
+  const end = csharpRoslynPosition(node.end ?? node.End ?? node.span?.end ?? node.Span?.End, options);
+  if (!start) return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: start.path ?? end?.path ?? input.sourcePath,
+    startLine: start.line,
+    startColumn: start.column,
+    endLine: end?.line,
+    endColumn: end?.column
+  };
+}

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

@@ -0,0 +1,17 @@
+import{clangLocPosition}from'./clangLocPosition.js';
+export function spanFromClangAstNode(node, input) {
+  const range = node.range ?? {};
+  const begin = range.begin ?? node.loc ?? node.spellingLoc ?? node.expansionLoc;
+  const end = range.end ?? node.end;
+  const start = clangLocPosition(begin);
+  if (!start) return undefined;
+  const finish = clangLocPosition(end);
+  return {
+    sourceId: input.sourceHash,
+    path: start.path ?? finish?.path ?? input.sourcePath,
+    startLine: start.line,
+    startColumn: start.column,
+    endLine: finish?.line,
+    endColumn: finish?.column
+  };
+}

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

@@ -0,0 +1,14 @@
+import{goAstPosition}from'./goAstPosition.js';
+export function spanFromGoAstNode(node, input, options = {}) {
+  const start = goAstPosition(node.Pos ?? node.pos ?? node.Name?.NamePos ?? node.name?.namePos ?? node.Package, options);
+  const end = goAstPosition(node.End ?? node.end ?? node.EndPos ?? node.endPos, options);
+  if (!start) return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: start.path ?? end?.path ?? input.sourcePath,
+    startLine: start.line,
+    startColumn: start.column,
+    endLine: end?.line,
+    endColumn: end?.column
+  };
+}

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

@@ -0,0 +1,36 @@
+import{javaAstPosition}from'./javaAstPosition.js';import{spanFromJavaLineFields}from'./spanFromJavaLineFields.js';import{spanFromJavaRange}from'./spanFromJavaRange.js';
+export function spanFromJavaAstNode(node, input, options = {}) {
+  const direct = spanFromJavaRange(node.range ?? node.loc ?? node.location, input)
+    ?? spanFromJavaLineFields(node, input);
+  if (direct) return direct;
+  const start = javaAstPosition(
+    node.begin ?? node.start ?? node.pos ?? node.position ?? node.startPosition ?? node.name?.range?.begin ?? node.name?.loc?.start,
+    options
+  );
+  const end = javaAstPosition(
+    node.end ?? node.endPosition ?? node.stopPosition ?? node.finishPosition ?? node.name?.range?.end ?? node.name?.loc?.end,
+    options
+  );
+  const sourceRange = node.sourceRange ?? node.rangeInfo;
+  const sourceStart = javaAstPosition(
+    sourceRange?.start ?? sourceRange?.offset ?? sourceRange?.startPosition,
+    options
+  );
+  const sourceEnd = javaAstPosition(
+    typeof sourceRange?.offset === 'number' && typeof sourceRange?.length === 'number'
+      ? sourceRange.offset + sourceRange.length
+      : sourceRange?.end ?? sourceRange?.endPosition,
+    options
+  );
+  const resolvedStart = start ?? sourceStart;
+  const resolvedEnd = end ?? sourceEnd;
+  if (!resolvedStart) return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: resolvedStart.path ?? resolvedEnd?.path ?? input.sourcePath,
+    startLine: resolvedStart.line,
+    startColumn: resolvedStart.column,
+    endLine: resolvedEnd?.line,
+    endColumn: resolvedEnd?.column
+  };
+}

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

@@ -0,0 +1,12 @@
+export function spanFromJavaLineFields(node, input) {
+  const startLine = node.startLine ?? node.line ?? node.beginLine ?? node.lineno;
+  if (typeof startLine !== 'number') return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: node.path ?? node.file ?? node.filename ?? input.sourcePath,
+    startLine,
+    startColumn: node.startColumn ?? node.column ?? node.beginColumn ?? node.col,
+    endLine: node.endLine ?? node.end_lineno,
+    endColumn: node.endColumn ?? node.end_col_offset
+  };
+}

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

@@ -0,0 +1,22 @@
+export function spanFromJavaRange(range, input) {
+  if (!range || typeof range !== 'object') return undefined;
+  const start = range.begin ?? range.start;
+  const end = range.end ?? range.stop;
+  if (start && typeof start === 'object') {
+    const startLine = start.line ?? start.Line;
+    const startColumn = start.column ?? start.col ?? start.Column ?? start.character;
+    const endLine = end?.line ?? end?.Line;
+    const endColumn = end?.column ?? end?.col ?? end?.Column ?? end?.character;
+    if (typeof startLine === 'number') {
+      return {
+        sourceId: input.sourceHash,
+        path: start.path ?? start.file ?? end?.path ?? end?.file ?? input.sourcePath,
+        startLine,
+        startColumn,
+        endLine,
+        endColumn
+      };
+    }
+  }
+  return undefined;
+}

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

@@ -0,0 +1,12 @@
+export function spanFromKotlinLineFields(node, input) {
+  const startLine = node.startLine ?? node.line ?? node.beginLine;
+  if (typeof startLine !== 'number') return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: node.path ?? node.filePath ?? node.file ?? input.sourcePath,
+    startLine,
+    startColumn: node.startColumn ?? node.column ?? node.beginColumn,
+    endLine: node.endLine,
+    endColumn: node.endColumn
+  };
+}

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

@@ -0,0 +1,19 @@
+import{kotlinPsiPosition}from'./kotlinPsiPosition.js';import{spanFromKotlinLineFields}from'./spanFromKotlinLineFields.js';import{spanFromKotlinRange}from'./spanFromKotlinRange.js';
+export function spanFromKotlinPsiNode(node, input, options = {}) {
+  const direct = spanFromKotlinLineFields(node, input);
+  if (direct) return direct;
+  const range = node.sourceRange ?? node.range ?? node.span ?? node.textRange;
+  const fromRange = spanFromKotlinRange(range, input);
+  if (fromRange) return fromRange;
+  const start = kotlinPsiPosition(node.start ?? node.startOffset ?? range?.startOffset ?? range?.start, options);
+  const end = kotlinPsiPosition(node.end ?? node.endOffset ?? range?.endOffset ?? range?.end, options);
+  if (!start) return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: start.path ?? end?.path ?? input.sourcePath,
+    startLine: start.line,
+    startColumn: start.column,
+    endLine: end?.line,
+    endColumn: end?.column
+  };
+}

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

@@ -0,0 +1,18 @@
+export function spanFromKotlinRange(range, input) {
+  if (!range || typeof range !== 'object') return undefined;
+  const start = range.start ?? range.startPosition ?? range.lowerBound ?? range.begin;
+  const end = range.end ?? range.endPosition ?? range.upperBound;
+  const line = start?.line ?? start?.Line;
+  if (typeof line !== 'number') return undefined;
+  const column = start.column ?? start.character ?? start.offset ?? start.Column;
+  const endLine = end?.line ?? end?.Line;
+  const endColumn = end?.column ?? end?.character ?? end?.offset ?? end?.Column;
+  return {
+    sourceId: input.sourceHash,
+    path: range.path ?? range.filePath ?? range.file ?? input.sourcePath,
+    startLine: line,
+    startColumn: typeof column === 'number' ? column : undefined,
+    endLine: typeof endLine === 'number' ? endLine : undefined,
+    endColumn: typeof endColumn === 'number' ? endColumn : undefined
+  };
+}

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

@@ -0,0 +1,11 @@
+export function spanFromLoc(loc, input) {
+  if (!loc?.start) return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: input.sourcePath ?? loc.filename,
+    startLine: loc.start.line,
+    startColumn: typeof loc.start.column === 'number' ? loc.start.column + 1 : undefined,
+    endLine: loc.end?.line,
+    endColumn: typeof loc.end?.column === 'number' ? loc.end.column + 1 : undefined
+  };
+}

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

@@ -0,0 +1,12 @@
+export function spanFromLspRange(range, sourcePath, sourceHash, base = 0) {
+  if (!range) return undefined;
+  const source = range.start && range.end ? range : { start: range, end: range.end ?? range };
+  return {
+    sourceId: sourceHash,
+    path: sourcePath,
+    startLine: Number(source.start?.line ?? source.startLine ?? 0) + (base === 0 ? 1 : 0),
+    startColumn: Number(source.start?.character ?? source.startColumn ?? 0) + (base === 0 ? 1 : 0),
+    endLine: Number(source.end?.line ?? source.endLine ?? source.start?.line ?? 0) + (base === 0 ? 1 : 0),
+    endColumn: Number(source.end?.character ?? source.endColumn ?? source.start?.character ?? 0) + (base === 0 ? 1 : 0)
+  };
+}

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

@@ -0,0 +1,15 @@
+export function spanFromPythonAstNode(node, input) {
+  const line = node.lineno ?? node.line;
+  if (typeof line !== 'number') return undefined;
+  const col = node.col_offset ?? node.colOffset;
+  const endLine = node.end_lineno ?? node.endLine;
+  const endCol = node.end_col_offset ?? node.endColOffset;
+  return {
+    sourceId: input.sourceHash,
+    path: input.sourcePath,
+    startLine: line,
+    startColumn: typeof col === 'number' ? col + 1 : undefined,
+    endLine: typeof endLine === 'number' ? endLine : undefined,
+    endColumn: typeof endCol === 'number' ? endCol + 1 : undefined
+  };
+}

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

@@ -0,0 +1,20 @@
+import{rustSynColumnToOneBased}from'./rustSynColumnToOneBased.js';
+export function spanFromRustSynNode(node, input) {
+  const span = node.span ?? node.ident?.span ?? node.sig?.ident?.span ?? node.name?.span;
+  if (!span || typeof span !== 'object') return undefined;
+  const start = span.start ?? span.lo ?? span.begin;
+  const end = span.end ?? span.hi;
+  const startLine = span.startLine ?? span.line ?? start?.line;
+  const startColumn = span.startColumn ?? span.column ?? start?.column;
+  const endLine = span.endLine ?? end?.line;
+  const endColumn = span.endColumn ?? end?.column;
+  if (typeof startLine !== 'number') return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: input.sourcePath,
+    startLine,
+    startColumn: typeof startColumn === 'number' ? rustSynColumnToOneBased(startColumn, span) : undefined,
+    endLine: typeof endLine === 'number' ? endLine : undefined,
+    endColumn: typeof endColumn === 'number' ? rustSynColumnToOneBased(endColumn, span) : undefined
+  };
+}

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

@@ -0,0 +1,40 @@
+export function spanFromScipOccurrence(occurrence, sourcePath, sourceHash) {
+  if (occurrence.single_line_range || occurrence.singleLineRange) {
+    const range = occurrence.single_line_range ?? occurrence.singleLineRange;
+    return {
+      sourceId: sourceHash,
+      path: sourcePath,
+      startLine: Number(range.line ?? 0) + 1,
+      startColumn: Number(range.start_character ?? range.startCharacter ?? 0) + 1,
+      endLine: Number(range.line ?? 0) + 1,
+      endColumn: Number(range.end_character ?? range.endCharacter ?? 0) + 1
+    };
+  }
+  if (occurrence.multi_line_range || occurrence.multiLineRange) {
+    const range = occurrence.multi_line_range ?? occurrence.multiLineRange;
+    return {
+      sourceId: sourceHash,
+      path: sourcePath,
+      startLine: Number(range.start_line ?? range.startLine ?? 0) + 1,
+      startColumn: Number(range.start_character ?? range.startCharacter ?? 0) + 1,
+      endLine: Number(range.end_line ?? range.endLine ?? 0) + 1,
+      endColumn: Number(range.end_character ?? range.endCharacter ?? 0) + 1
+    };
+  }
+  const range = occurrence.range;
+  if (Array.isArray(range) && range.length >= 3) {
+    const startLine = Number(range[0] ?? 0);
+    const startColumn = Number(range[1] ?? 0);
+    const endLine = range.length >= 4 ? Number(range[2] ?? startLine) : startLine;
+    const endColumn = range.length >= 4 ? Number(range[3] ?? startColumn) : Number(range[2] ?? startColumn);
+    return {
+      sourceId: sourceHash,
+      path: sourcePath,
+      startLine: startLine + 1,
+      startColumn: startColumn + 1,
+      endLine: endLine + 1,
+      endColumn: endColumn + 1
+    };
+  }
+  return undefined;
+}

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

@@ -0,0 +1,11 @@
+export function spanFromSemanticDbRange(range, sourcePath, sourceHash) {
+  if (!range) return undefined;
+  return {
+    sourceId: sourceHash,
+    path: sourcePath,
+    startLine: Number(range.start_line ?? range.startLine ?? 0) + 1,
+    startColumn: Number(range.start_character ?? range.startCharacter ?? 0) + 1,
+    endLine: Number(range.end_line ?? range.endLine ?? 0) + 1,
+    endColumn: Number(range.end_character ?? range.endCharacter ?? 0) + 1
+  };
+}

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

@@ -0,0 +1,12 @@
+export function spanFromSwiftLineFields(node, input) {
+  const startLine = node.startLine ?? node.line ?? node.beginLine;
+  if (typeof startLine !== 'number') return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: node.path ?? node.filePath ?? node.file ?? input.sourcePath,
+    startLine,
+    startColumn: node.startColumn ?? node.column ?? node.beginColumn,
+    endLine: node.endLine,
+    endColumn: node.endColumn
+  };
+}

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

@@ -0,0 +1,18 @@
+export function spanFromSwiftRange(range, input) {
+  if (!range || typeof range !== 'object') return undefined;
+  const start = range.start ?? range.lowerBound ?? range.begin;
+  const end = range.end ?? range.upperBound;
+  const line = start?.line ?? start?.Line;
+  if (typeof line !== 'number') return undefined;
+  const column = start.column ?? start.character ?? start.utf8Column ?? start.Column;
+  const endLine = end?.line ?? end?.Line;
+  const endColumn = end?.column ?? end?.character ?? end?.utf8Column ?? end?.Column;
+  return {
+    sourceId: input.sourceHash,
+    path: range.path ?? range.filePath ?? range.file ?? input.sourcePath,
+    startLine: line,
+    startColumn: typeof column === 'number' ? column : undefined,
+    endLine: typeof endLine === 'number' ? endLine : undefined,
+    endColumn: typeof endColumn === 'number' ? endColumn : undefined
+  };
+}

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

@@ -0,0 +1,19 @@
+import{spanFromSwiftLineFields}from'./spanFromSwiftLineFields.js';import{spanFromSwiftRange}from'./spanFromSwiftRange.js';import{swiftSyntaxPosition}from'./swiftSyntaxPosition.js';
+export function spanFromSwiftSyntaxNode(node, input, options = {}) {
+  const direct = spanFromSwiftLineFields(node, input);
+  if (direct) return direct;
+  const range = node.sourceRange ?? node.range ?? node.span;
+  const fromRange = spanFromSwiftRange(range, input);
+  if (fromRange) return fromRange;
+  const start = swiftSyntaxPosition(node.position ?? node.absolutePosition ?? node.start ?? range?.start, options);
+  const end = swiftSyntaxPosition(node.endPosition ?? node.end ?? range?.end, options);
+  if (!start) return undefined;
+  return {
+    sourceId: input.sourceHash,
+    path: start.path ?? end?.path ?? input.sourcePath,
+    startLine: start.line,
+    startColumn: start.column,
+    endLine: end?.line,
+    endColumn: end?.column
+  };
+}

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

@@ -0,0 +1,13 @@
+export function spanFromTreeSitterNode(node, input) {
+  const start = node.startPosition;
+  if (!start) return undefined;
+  const end = node.endPosition;
+  return {
+    sourceId: input.sourceHash,
+    path: input.sourcePath,
+    startLine: start.row + 1,
+    startColumn: start.column + 1,
+    endLine: end ? end.row + 1 : undefined,
+    endColumn: end ? end.column + 1 : undefined
+  };
+}

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

@@ -0,0 +1,15 @@
+export function spanFromTypeScriptNode(node, sourceFile) {
+  const start = typeof node.getStart === 'function' ? node.getStart(sourceFile) : node.pos;
+  const end = typeof node.getEnd === 'function' ? node.getEnd() : node.end;
+  if (typeof start !== 'number' || typeof sourceFile?.getLineAndCharacterOfPosition !== 'function') return undefined;
+  const startPos = sourceFile.getLineAndCharacterOfPosition(start);
+  const endPos = typeof end === 'number' ? sourceFile.getLineAndCharacterOfPosition(end) : undefined;
+  return {
+    sourceId: sourceFile.sourceHash,
+    path: sourceFile.fileName,
+    startLine: startPos.line + 1,
+    startColumn: startPos.character + 1,
+    endLine: endPos ? endPos.line + 1 : undefined,
+    endColumn: endPos ? endPos.character + 1 : undefined
+  };
+}

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

@@ -0,0 +1,7 @@
+import{identifierName}from'./identifierName.js';
+export function stringFromTsExpression(node) {
+  if (!node) return undefined;
+  if (typeof node.text === 'string') return node.text;
+  if (typeof node.value === 'string') return node.value;
+  return identifierName(node);
+}

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

@@ -0,0 +1,16 @@
+import{countBy}from'../../native-import-utils.js';
+export function summarizeNativeChangedRegionProjections(regions) {
+  const projections = (regions ?? [])
+    .map((region) => region?.metadata?.changedRegionProjection)
+    .filter(Boolean);
+  return {
+    schema: 'frontier.lang.changedRegionProjectionSummary.v1',
+    total: regions?.length ?? 0,
+    withProjection: projections.length,
+    reviewRequired: projections.filter((projection) => projection.reviewRequired === true).length,
+    autoMergeClaims: projections.filter((projection) => projection.autoMergeClaim === true).length,
+    sourceMapLinks: projections.reduce((sum, projection) => sum + (projection.sourceMapLinks?.length ?? 0), 0),
+    byAction: countBy(projections.map((projection) => projection.admission?.action ?? 'unknown')),
+    byRegionKind: countBy(projections.map((projection) => projection.region?.kind ?? 'unknown'))
+  };
+}