fix(sourcemaps)!: preserve nullable source declarations

Accept absent map-level sourcesContent and preserve null source-name slots alongside known originals and aligned content. Represent unnamed local declarations explicitly, retain leaf-local and flattened indices, and preserve declared indexed-section order across consumers.

Account for added indices before browser output allocation. Accept legacy retained rows without indices. Consolidate public CLI/MCP source-map fixtures and update the stale named-source-only assertion.

BREAKING CHANGE: Browser source-map original and mapping rows expose null for unavailable source names instead of inventing an unknown-source string. New index fields are optional when reading older retained evidence.

Refs #2023, #2024
This commit is contained in:
morluto
2026-10-12 11:10:49 +08:00
parent c0904b4c1a
commit ee50ed121e
13 changed files with 361 additions and 70 deletions
@@ -1,6 +1,7 @@
import {
addArtifactContainsEdge,
addStaticInferenceEdge,
artifactLocalIdentity,
createElectronRoleNode,
linkElectronRoleToAsset,
type JavaScriptArtifactGraphContext,
@@ -118,22 +119,34 @@ export const addJavaScriptSourceMapOriginals = (
if (mapFile === undefined || mapNode === undefined) continue;
const coverage = completeApplicationCoverage();
for (const original of sourceMap.sources) {
const reference = original.reference;
const node = context.accumulator.addNode({
kind: "source-module",
identity: {
strategy: "source-map-original",
stability: "source-map-exact",
source_map_sha256: mapFile.sha256,
original_source: original.reference.source_name,
source_root: original.reference.source_root,
source_sha256: original.content_sha256,
},
kind: reference === null ? "unknown" : "source-module",
identity:
reference === null
? artifactLocalIdentity(
mapFile.sha256,
"source-map-unnamed-declaration",
String(original.declaration_index),
)
: {
strategy: "source-map-original",
stability: "source-map-exact",
source_map_sha256: mapFile.sha256,
original_source: reference.source_name,
source_root: reference.source_root,
source_sha256: original.content_sha256,
},
observations: [
{
label: original.reference.source_name || null,
source_map_reference: original.reference,
label: reference?.source_name || null,
source_map_reference: reference,
properties: {
source_index: original.source_index,
declaration_index: original.declaration_index,
source_name_available: reference !== null,
content_available: original.content !== null,
content_sha256: original.content_sha256,
},
evidence: artifactObservationEvidence({
sha256: mapFile.sha256,
@@ -151,8 +164,10 @@ export const addJavaScriptSourceMapOriginals = (
target_node_id: node.node_id,
relation: "contains",
properties: {
original_source: original.reference.source_name,
source_root: original.reference.source_root,
source_index: original.source_index,
declaration_index: original.declaration_index,
original_source: reference?.source_name ?? null,
source_root: reference?.source_root ?? null,
},
evidence: artifactObservationEvidence({
sha256: mapFile.sha256,