docs: reframe ECMA-426 support as core + draft proposals

The previous copy claimed "full ECMA-426 compliance", which overstated
what's actually in the published core versus what lives in draft
proposals (scopes, debugId, rangeMappings, sourcesFunctionMappings).
Update README, ROADMAP, crate/package READMEs, and badge text to
separate stable core support from explicitly-labelled draft proposal
support, and fix ROADMAP links to point at the canonical tc39/ecma426
proposal files.

Author: BartWaardenburg

README.md

@@ -5,9 +5,9 @@
 [![crates.io](https://img.shields.io/crates/v/srcmap-sourcemap.svg)](https://crates.io/crates/srcmap-sourcemap)
 [![docs.rs](https://docs.rs/srcmap-sourcemap/badge.svg)](https://docs.rs/srcmap-sourcemap)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![ECMA-426](https://img.shields.io/badge/ECMA--426-compliant-44cc11.svg)](https://tc39.es/ecma426/)
+[![ECMA-426](https://img.shields.io/badge/ECMA--426-core%20%2B%20proposals-44cc11.svg)](https://tc39.es/ecma426/)
 
-> The source map SDK for Rust tooling. Parse, generate, remap, and compose — with full [ECMA-426](https://tc39.es/ecma426/) compliance.
+> The source map SDK for Rust tooling. Parse, generate, remap, and compose — with stable [ECMA-426](https://tc39.es/ecma426/) core support plus selected draft proposals.
 
 A standalone source map library that any Rust tool can embed. If you're building a bundler, compiler, minifier, linter, or symbolication service — srcmap gives you the complete source map stack so you don't have to build it yourself.
 
@@ -44,7 +44,7 @@ srcmap-remapping = "0.3"    # if you compose/concatenate source maps
 | Composition/remapping | **yes** | limited | no | yes |
 | Concatenation | **yes** | no | yes | yes |
 | Indexed source maps | **yes** | yes | no | no |
-| ECMA-426 scopes | **yes** | no | no | no |
+| Scopes proposal | **yes** | no | no | no |
 | Stack trace symbolication | **yes** | yes | no | no |
 | Hermes/React Native | **yes** | yes | no | no |
 | RAM bundle parsing | **yes** | no | no | no |
@@ -136,19 +136,23 @@ let mut buf = Vec::new();
 vlq_encode(&mut buf, 42);
 ```
 
-## Spec conformance
+## Spec support
 
-Full [ECMA-426](https://tc39.es/ecma426/) (Source Map v3) compliance:
+Stable [ECMA-426](https://tc39.es/ecma426/) core support:
 
-- All standard fields: `version`, `file`, `sourceRoot`, `sources`, `sourcesContent`, `names`, `mappings`
-- `rangeMappings` for range-based source mapping (ECMA-426 Stage 2 proposal)
-- `ignoreList` for filtering third-party sources
-- Indexed source maps with `sections` — flattened with source/name deduplication
-- Proper `sourceRoot` resolution
-- `debugId` for associating generated files with source maps
-- Scopes & variables (first Rust implementation of the [ECMA-426 scopes proposal](https://tc39.es/ecma426/) — draft, may evolve)
+- Standard Source Map v3 fields: `version`, `file`, `sourceRoot`, `sources`, `sourcesContent`, `names`, `mappings`
+- `ignoreList`
+- Indexed source maps with `sections`
+- `sourceRoot` resolution
+- Required extension tolerance for unrecognized properties
 - Robust error handling for malformed input
 
+Draft proposal support:
+
+- `debugId` (ECMA-426 draft proposal, not part of the published core standard)
+- Scopes & variables via [`srcmap-scopes`](https://crates.io/crates/srcmap-scopes) (first Rust implementation of the [ECMA-426 scopes proposal](https://github.com/tc39/ecma426/blob/main/proposals/scopes.md))
+- `rangeMappings` (ECMA-426 Stage 2 proposal)
+
 ## Performance
 
 For Rust consumers there is no FFI overhead. Benchmarked with Criterion:

ROADMAP.md

@@ -4,9 +4,11 @@ What's next for srcmap, and why.
 
 ## Function Name Mappings
 
-**ECMA-426, standardized** — [bloomberg.github.io/js-blog/post/standardizing-source-maps](https://bloomberg.github.io/js-blog/post/standardizing-source-maps/)
+**Interop work, not part of published ECMA-426 core today** — [bloomberg.github.io/js-blog/post/standardizing-source-maps](https://bloomberg.github.io/js-blog/post/standardizing-source-maps/)
 
-A `"sourcesFunctionMappings"` array parallel to `"sources"`, where each entry is a VLQ-encoded string mapping generated positions to original function names. Previously the `x_com_bloomberg_sourcesFunctionMappings` extension, now standardized in ECMA-426.
+A `"sourcesFunctionMappings"` array parallel to `"sources"`, where each entry is a VLQ-encoded string mapping generated positions to original function names. Previously the `x_com_bloomberg_sourcesFunctionMappings` extension, and worth tracking for ecosystem interoperability.
+
+Note: this repository tracks it as forward-looking ecosystem interoperability work. It is not currently in the published ECMA-426 core standard or the official `tc39/ecma426` proposal set.
 
 This is a simpler alternative to the full scopes proposal for resolving minified function names in stack traces. Tools that don't need full scope/binding information can use this field alone. For tools that support scopes, `FindOriginalFunctionName` from the scopes proposal supersedes this — but both should be supported for interop, since most source maps in the wild won't have scopes data.
 
@@ -29,7 +31,7 @@ This is a simpler alternative to the full scopes proposal for resolving minified
 
 ### Open issues to track
 
-**Boundary rules for generated ranges** ([tc39/ecma426#249](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)): Defines where generated ranges must start and end relative to JavaScript syntax. Key rules:
+**Boundary rules for generated ranges** ([tc39/ecma426#249](https://github.com/tc39/ecma426/blob/main/proposals/scopes.md)): Defines where generated ranges must start and end relative to JavaScript syntax. Key rules:
 
 - Generated ranges must be strictly well-nested with syntactic scopes (no partial overlap)
 - For callable scopes (functions, arrows, methods), the range starts inside the opening boundary (before default parameter evaluation)
@@ -39,31 +41,31 @@ This is a simpler alternative to the full scopes proposal for resolving minified
   - `BlockStatement`: opening = `{`, closing = `}`, not callable
   - `ClassDeclaration`: opening = `class` to `{`, closing = `}`, not callable
 
-**Stack frame reconstruction algorithm** ([tc39/ecma426#219](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)): Three operations being standardized:
+**Stack frame reconstruction algorithm** ([tc39/ecma426#219](https://github.com/tc39/ecma426/blob/main/proposals/scopes.md)): Three operations being standardized:
 
 1. `FindOriginalFunctionName(position)` — find innermost generated range, walk scope chain outward to find `isStackFrame = true` scope
 2. `SymbolizeStackTrace(rawFrames)` — translate generated stack traces to original, expand inlined frames and collapse outlined frames across different bundles
 3. `BuildScopeChain(position)` — return `OriginalScopeWithValues[]` mapping original variables to concrete JS values
 
-**Hidden scopes** ([tc39/ecma426#113](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)): A generated range without an `originalScope` reference signals compiler-generated code. Combined with `isFunctionScope`: if `range.isFunctionScope && !range.hasDefinition`, the function frame should be omitted from stack traces.
+**Hidden scopes** ([tc39/ecma426#113](https://github.com/tc39/ecma426/blob/main/proposals/scopes.md)): A generated range without an `originalScope` reference signals compiler-generated code. Combined with `isFunctionScope`: if `range.isFunctionScope && !range.hasDefinition`, the function frame should be omitted from stack traces.
 
-**Null variable names** ([tc39/ecma426#244](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)): When a `names` index is invalid, the variable entry becomes `null` (or empty string) instead of causing a parse error. Variables array type becomes `(string | null)[]`.
+**Null variable names** ([tc39/ecma426#244](https://github.com/tc39/ecma426/blob/main/proposals/scopes.md)): When a `names` index is invalid, the variable entry becomes `null` (or empty string) instead of causing a parse error. Variables array type becomes `(string | null)[]`.
 
 ### What to implement
 
 - [ ] Validate generated range boundaries against JavaScript syntax rules (#249)
-- [ ] `FindOriginalFunctionName` in the symbolicate crate
+- [x] `FindOriginalFunctionName` in the symbolicate crate
 - [ ] `SymbolizeStackTrace` with inlining expansion and outlining collapse (#219)
 - [ ] `BuildScopeChain` for debugger integration
-- [ ] Handle hidden scopes (`isFunctionScope && !hasDefinition`) in stack trace output
+- [x] Handle hidden scopes (`isFunctionScope && !hasDefinition`) in stack trace output
 - [ ] Tolerate null variable names (#244)
 - [ ] Track Chrome DevTools scopes codec ([@chrome-devtools/source-map-scopes-codec](https://jsr.io/@chrome-devtools/source-map-scopes-codec)) for compatibility
 
 ---
 
 ## Sources Hash `[Stage 1 — not implementing yet]`
 
-**ECMA-426 proposal, Stage 1** — [tc39/ecma426#208](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)
+**ECMA-426 proposal, Stage 1** — [sources-hash proposal](https://github.com/tc39/ecma426/blob/main/proposals/sources-hash.md)
 
 A new `"sourcesHash"` array parallel to `"sources"`, containing content hashes for source file integrity verification.
 
@@ -94,7 +96,7 @@ Hash algorithm is implementation-defined (SHA-256 recommended). Format is a pref
 
 ## Debug ID Extraction `[Stage 2 — not implementing yet]`
 
-**ECMA-426 proposal, Stage 2** — [tc39/ecma426#207](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)
+**ECMA-426 proposal, Stage 2** — [debug-id proposal](https://github.com/tc39/ecma426/blob/main/proposals/debug-id.md)
 
 srcmap already parses `debugId` from source map JSON. What's missing is extracting it from generated JavaScript/CSS files via the `//# debugId=<UUID>` comment.
 
@@ -119,7 +121,7 @@ srcmap already parses `debugId` from source map JSON. What's missing is extracti
 
 ## Mappings v2 Encoding `[Discussion — not implementing yet]`
 
-**ECMA-426 discussion** — [tc39/ecma426#155](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)
+**ECMA-426 discussion** — [range-mappings proposal](https://github.com/tc39/ecma426/blob/main/proposals/range-mappings.md)
 
 A proposed encoding that eliminates `,` and `;` separators and packs metadata into VLQ bits. Claims ~35-50% raw size reduction.
 
@@ -154,7 +156,7 @@ This is early-stage and may never land. Worth implementing as an experimental en
 
 ## Env Metadata `[Stage 1 — not implementing yet]`
 
-**ECMA-426 proposal, Stage 1** — [tc39/ecma426 proposals/env.md](https://github.com/nicolo-ribaudo/ecma-426/blob/main/proposals/range-mappings.md)
+**ECMA-426 proposal, Stage 1** — [env proposal](https://github.com/tc39/ecma426/blob/main/proposals/env.md)
 
 Environment metadata for source maps. The proposal is minimal at Stage 1 — track for details before implementing.
 

crates/cli/README.md

@@ -27,7 +27,7 @@ cargo install srcmap-cli
 | `concat` | Concatenate multiple source maps into one |
 | `remap` | Compose/remap source maps through a transform chain |
 | `symbolicate` | Symbolicate a stack trace using source maps |
-| `scopes` | Inspect ECMA-426 scopes and variable bindings |
+| `scopes` | Inspect scopes-proposal data and variable bindings |
 | `fetch` | Fetch a JS/CSS bundle and its source map from a URL |
 | `sources` | List or extract original sources from a source map |
 | `schema` | Describe all commands as JSON (for agent introspection) |
@@ -65,7 +65,7 @@ srcmap remap minified.js.map --dir ./sourcemaps -o original.js.map
 # Symbolicate a stack trace
 srcmap symbolicate stacktrace.txt --dir ./sourcemaps
 
-# Inspect ECMA-426 scopes
+# Inspect scopes-proposal data
 srcmap scopes bundle.js.map
 
 # Fetch a bundle and its source map from a URL

crates/generator/README.md

@@ -80,11 +80,11 @@ On-the-fly VLQ encoder that emits mappings as they are added, without collecting
 | `add_source(path) -> u32` | Register a source file (deduped) |
 | `add_name(name) -> u32` | Register a name (deduped) |
 | `set_source_root(root)` | Set the `sourceRoot` prefix |
-| `set_debug_id(id)` | Set the `debugId` field |
+| `set_debug_id(id)` | Set the `debugId` proposal field |
 | `add_to_ignore_list(source_idx)` | Mark a source as ignored (third-party) |
 | `add_mapping(...)` | Add a mapping (encoded immediately) |
 | `add_named_mapping(...)` | Add a mapping with a name |
-| `add_range_mapping(...)` | Add a range mapping (ECMA-426) |
+| `add_range_mapping(...)` | Add a range mapping (ECMA-426 Stage 2 proposal) |
 | `add_named_range_mapping(...)` | Add a named range mapping |
 | `to_json() -> String` | Serialize to source map v3 JSON |
 | `to_decoded_map() -> SourceMap` | Build a `SourceMap` directly |

crates/sourcemap/README.md

@@ -130,7 +130,7 @@ assert_eq!(pos.column, 0);
 - **Lazy reverse index** built on first `generated_position_for` call
 - **Indexed source maps** (`sections`) with automatic flattening
 - **Zero-copy JSON parsing** via borrowed mappings string
-- **Range mappings** (`rangeMappings` field, ECMA-426 Stage 2) with cross-line delta lookup
+- **Range mappings** (`rangeMappings` field, ECMA-426 Stage 2 proposal) with cross-line delta lookup
 - **Lazy iterator** (`MappingsIter`) for zero-allocation streaming over encoded mappings
 - **Robust error handling** for malformed input
 

crates/symbolicate/README.md

@@ -37,7 +37,7 @@ println!("{result}"); // Pretty-printed symbolicated stack
 | `parse_stack_trace_full(input)` | Parse into `ParsedStack` (message + frames) |
 | `symbolicate(stack, loader)` | Parse and resolve through source maps |
 | `symbolicate_batch(stacks, maps)` | Batch symbolication with pre-loaded maps |
-| `resolve_by_debug_id(id, maps)` | Find a source map by its ECMA-426 debug ID |
+| `resolve_by_debug_id(id, maps)` | Find a source map by its `debugId` proposal field |
 | `to_json(stack)` | Serialize a `SymbolicatedStack` to JSON |
 
 ## Supported stack trace formats

packages/sourcemap-wasm/README.md

@@ -116,7 +116,7 @@ Parse a source map from a JSON string.
 | `ignoreList` | `number[]` | Source ignore list indices |
 | `file` | `string \| undefined` | Output filename |
 | `sourceRoot` | `string \| undefined` | Source root prefix |
-| `debugId` | `string \| undefined` | ECMA-426 debug ID |
+| `debugId` | `string \| undefined` | `debugId` proposal field |
 | `lineCount` | `number` | Number of generated lines |
 | `mappingCount` | `number` | Total decoded mappings |
 | `hasRangeMappings` | `boolean` | Whether any range mappings exist |
@@ -158,7 +158,7 @@ A fast-scan alternative to `SourceMap` that defers VLQ decoding until lookup tim
 | `ignoreList` | `number[]` | Source ignore list indices |
 | `file` | `string \| undefined` | Output filename |
 | `sourceRoot` | `string \| undefined` | Source root prefix |
-| `debugId` | `string \| undefined` | ECMA-426 debug ID |
+| `debugId` | `string \| undefined` | `debugId` proposal field |
 | `lineCount` | `number` | Number of generated lines |
 
 ---
@@ -211,7 +211,7 @@ sm.free();
 | `ignoreList` | `number[]` | Source ignore list indices |
 | `file` | `string \| undefined` | Output filename |
 | `sourceRoot` | `string \| undefined` | Source root prefix |
-| `debugId` | `string \| undefined` | ECMA-426 debug ID |
+| `debugId` | `string \| undefined` | `debugId` proposal field |
 | `lineCount` | `number` | Number of generated lines |
 
 ## Performance