docs(packages/codegen): clarify comment (#25959)

Follow-on after #25957. Not sure how this crazily-formatted comment snuck by me. Also clarify the wording - what's this weird obsession with the word "spelling" Mr Claude? Speak English bruv!
This commit is contained in:
overlookmotel committed 2026-08-21 14:08:12 +00:00
1 parent 6c5ad1b723
commit 3b09c04fb3
1 file changed
+5 -2
+5 -2
View File
@@ -453,8 +453,11 @@ function recordSourceMapping(state: State, node: MappableNode, location: Locatio
if (location === LOCATION_NAMED && typeof node.name === "string") {
// A mapping carries a name only when the identifier printed differs from the one in the source.
// When possible, the mapping records the source spelling; if the source range is invalid, it falls back to the printed name.
// Almost every identifier is printed exactly as it appeared, so we do a first quick check and only fall back to scanning with Unicode property regexps in rare cases.
// When possible, the mapping records the name from source, but if the source range is invalid,
// it falls back to the printed name.
//
// Almost every identifier is printed exactly as it was in source, so we do a quick check first,
// and only fall back to expensive scanning with Unicode property regexps in rare cases.
//
// A span can reach past the name it begins with, since a TypeScript annotation is absorbed into it,
// so a match has to be followed by a character which cannot continue an identifier.