@scriptc/compiler 0.0.33 → 0.0.35

package/dist/library/semantic-source.d.ts

@@ -0,0 +1,13 @@
+/** Content identity after discarding TypeScript comments proven to be trivia. */
+export declare function semanticSourceDigest(path: string, source: string): string;
+export declare function semanticallyEqualSource(path: string, previous: string, current: string): boolean;
+/** Build a cheap old-line to current-line mapper for semantically identical
+ * sources. C emission records only a location's line, not its byte offset, so
+ * representative semantic tokens anchor each old line across trivia edits. */
+export declare function createSourceLineRebaser(path: string, previous: string, current: string): (line: number) => number;
+/** True when every existing source line keeps its physical line number. This
+ * is the safe subset for reusing a C TU whose annotations retain line numbers
+ * but not enough provenance to distinguish synthetic byte-zero locations. */
+export declare function sourceLineRebaseIsIdentity(path: string, previous: string, current: string): boolean;
+/** Rebase every SrcLoc-shaped object in a deserialized cache payload. */
+export declare function rebaseSourceLocations<T>(value: T, previousSources: ReadonlyMap<string, string>, currentSources: ReadonlyMap<string, string>): T;

package/dist/library/semantic-source.js

@@ -0,0 +1,257 @@
+import { createHash } from "node:crypto";
+import { extname } from "node:path";
+import ts from "typescript5";
+const TOKEN_PATTERN = /(?:\s+|\/\/[^\r\n\u2028\u2029]*|\/\*[\s\S]*?\*\/|(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`)|(?:0[xX][0-9a-fA-F]+|0[bB][01]+|0[oO][0-7]+|(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?)|(?:(?:[$_\p{ID_Start}]|\\u(?:[0-9a-fA-F]{4}|\{[0-9a-fA-F]+\}))(?:(?:[$_\u200C\u200D\p{ID_Continue}]|\\u(?:[0-9a-fA-F]{4}|\{[0-9a-fA-F]+\})))*)|(?:===|!==|>>>|>>=|<<=|\*\*=|&&=|\|\|=|\?\?=|=>|==|!=|<=|>=|\+\+|--|&&|\|\||\?\?|\?\.|\*\*|<<|>>>|>>|\+=|-=|\*=|\/=|%=|&=|\|=|\^=)|[^\s])/guy;
+const LINE_BREAK_PATTERN = /[\r\n\u2028\u2029]/;
+function commentCanAffectCompilation(path, text) {
+    const extension = extname(path).toLowerCase();
+    // JavaScript's checker surface is JSDoc-driven, so every comment remains
+    // semantic there. JSON and unknown source spellings stay conservative too.
+    if (extension !== ".ts" && extension !== ".mts" && extension !== ".cts")
+        return true;
+    // TypeScript comments are ordinary trivia except for compiler directives,
+    // triple-slash references, and the pure annotations consumed by lowering.
+    return text.startsWith("///") || text.includes("@") || text.includes("#");
+}
+function semanticTokens(path, source) {
+    // Slash is context-sensitive in JavaScript: after `else`, for example,
+    // `/[//a]/` is one regex token even though a standalone scanner can see
+    // the inner `//` as a comment. Use TypeScript's parser as the authority for
+    // both syntax validity (including a shebang's byte-zero requirement) and
+    // exact regular-expression spans, then keep the cheap scanner for trivia
+    // equivalence and location mapping.
+    const sourceFile = ts.createSourceFile(path, source, ts.ScriptTarget.Latest, true);
+    const parseDiagnostics = sourceFile.parseDiagnostics;
+    if (parseDiagnostics.length > 0)
+        return null;
+    const regexEnds = new Map();
+    const collectRegex = (node) => {
+        if (ts.isRegularExpressionLiteral(node))
+            regexEnds.set(node.getStart(sourceFile), node.end);
+        ts.forEachChild(node, collectRegex);
+    };
+    collectRegex(sourceFile);
+    const tokens = [];
+    let lineBreakBefore = false;
+    TOKEN_PATTERN.lastIndex = 0;
+    while (TOKEN_PATTERN.lastIndex < source.length) {
+        const match = TOKEN_PATTERN.exec(source);
+        if (match === null)
+            throw new Error(`semantic scanner stopped at ${TOKEN_PATTERN.lastIndex}`);
+        let text = match[0];
+        const start = match.index;
+        let end = start + text.length;
+        if (/^\s+$/.test(text)) {
+            if (LINE_BREAK_PATTERN.test(text))
+                lineBreakBefore = true;
+            continue;
+        }
+        const regexEnd = regexEnds.get(start);
+        if (regexEnd !== undefined) {
+            end = regexEnd;
+            text = source.slice(start, end);
+            TOKEN_PATTERN.lastIndex = end;
+            tokens.push({ kind: "token", text, lineBreakBefore, start, end });
+            lineBreakBefore = false;
+            continue;
+        }
+        const comment = text.startsWith("//") || text.startsWith("/*");
+        if (comment) {
+            if (!commentCanAffectCompilation(path, text)) {
+                if (LINE_BREAK_PATTERN.test(text))
+                    lineBreakBefore = true;
+                continue;
+            }
+        }
+        tokens.push({ kind: comment ? "comment" : "token", text, lineBreakBefore, start, end });
+        lineBreakBefore = false;
+    }
+    return tokens;
+}
+function tokensEqual(left, right) {
+    return left.length === right.length && left.every((token, index) => {
+        const other = right[index];
+        return token.kind === other.kind &&
+            token.text === other.text &&
+            (index === 0 || token.lineBreakBefore === other.lineBreakBefore);
+    });
+}
+/** Content identity after discarding TypeScript comments proven to be trivia. */
+export function semanticSourceDigest(path, source) {
+    const hash = createHash("sha256").update("scriptc-semantic-source-v1\0");
+    const tokens = semanticTokens(path, source);
+    if (tokens === null)
+        return hash.update("invalid\0").update(source).digest("hex");
+    for (const token of tokens) {
+        hash.update(String(token.kind)).update("\0")
+            .update(token.lineBreakBefore ? "nl" : "same-line").update("\0")
+            .update(token.text).update("\0");
+    }
+    return hash.digest("hex");
+}
+export function semanticallyEqualSource(path, previous, current) {
+    const left = semanticTokens(path, previous);
+    const right = semanticTokens(path, current);
+    return left !== null && right !== null && tokensEqual(left, right);
+}
+function offsetMapper(path, previous, current) {
+    const oldTokens = semanticTokens(path, previous);
+    const newTokens = semanticTokens(path, current);
+    if (oldTokens === null || newTokens === null || !tokensEqual(oldTokens, newTokens)) {
+        return { start: (offset) => offset, end: (offset) => offset };
+    }
+    const map = (offset, bias) => {
+        if (offset <= 0)
+            return 0;
+        if (offset >= previous.length)
+            return current.length;
+        let lo = 0;
+        let hi = oldTokens.length - 1;
+        while (lo <= hi) {
+            const mid = (lo + hi) >> 1;
+            const token = oldTokens[mid];
+            if (bias === "start" ? offset < token.start : offset <= token.start)
+                hi = mid - 1;
+            else if (bias === "start" ? offset >= token.end : offset > token.end)
+                lo = mid + 1;
+            else
+                return newTokens[mid].start + Math.min(offset - token.start, token.end - token.start);
+        }
+        const before = hi >= 0 ? oldTokens[hi] : undefined;
+        const after = lo < oldTokens.length ? oldTokens[lo] : undefined;
+        if (before === undefined) {
+            return Math.max(0, newTokens[lo].start - (after.start - offset));
+        }
+        if (after === undefined) {
+            return Math.min(current.length, newTokens[hi].end + (offset - before.end));
+        }
+        const oldGap = after.start - before.end;
+        const newBefore = newTokens[hi];
+        const newAfter = newTokens[lo];
+        if (oldGap <= 0)
+            return newBefore.end;
+        const fraction = (offset - before.end) / oldGap;
+        return Math.round(newBefore.end + fraction * (newAfter.start - newBefore.end));
+    };
+    return {
+        start: (offset) => map(offset, "start"),
+        end: (offset) => map(offset, "end"),
+    };
+}
+function lineStarts(source) {
+    const starts = [0];
+    for (let offset = 0; offset < source.length; offset++) {
+        if (source[offset] === "\n")
+            starts.push(offset + 1);
+    }
+    return starts;
+}
+function lineAt(starts, offset) {
+    let lo = 0;
+    let hi = starts.length - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (starts[mid] <= offset)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return lo + 1;
+}
+/** Build a cheap old-line to current-line mapper for semantically identical
+ * sources. C emission records only a location's line, not its byte offset, so
+ * representative semantic tokens anchor each old line across trivia edits. */
+export function createSourceLineRebaser(path, previous, current) {
+    const oldTokens = semanticTokens(path, previous);
+    const newTokens = semanticTokens(path, current);
+    if (oldTokens === null || newTokens === null || !tokensEqual(oldTokens, newTokens)) {
+        return (line) => line;
+    }
+    const oldStarts = lineStarts(previous);
+    const newStarts = lineStarts(current);
+    const firstTokenByLine = new Map();
+    for (let index = 0; index < oldTokens.length; index++) {
+        const line = lineAt(oldStarts, oldTokens[index].start);
+        if (!firstTokenByLine.has(line))
+            firstTokenByLine.set(line, index);
+    }
+    const mapper = offsetMapper(path, previous, current);
+    return (line) => {
+        if (!Number.isSafeInteger(line) || line < 1 || line > oldStarts.length)
+            return line;
+        const tokenIndex = firstTokenByLine.get(line);
+        const offset = tokenIndex === undefined
+            ? mapper.start(oldStarts[line - 1])
+            : newTokens[tokenIndex].start;
+        return lineAt(newStarts, offset);
+    };
+}
+/** True when every existing source line keeps its physical line number. This
+ * is the safe subset for reusing a C TU whose annotations retain line numbers
+ * but not enough provenance to distinguish synthetic byte-zero locations. */
+export function sourceLineRebaseIsIdentity(path, previous, current) {
+    const oldTokens = semanticTokens(path, previous);
+    const newTokens = semanticTokens(path, current);
+    if (oldTokens === null || newTokens === null || !tokensEqual(oldTokens, newTokens)) {
+        return false;
+    }
+    const oldStarts = lineStarts(previous);
+    const newStarts = lineStarts(current);
+    // The C emitter counts only LF bytes. TypeScript also treats bare CR and
+    // the Unicode separators as line breaks, so normalizing one of those to LF
+    // preserves semantic tokens while moving later annotations to a different
+    // emitter line. Check every corresponding token, including multiple
+    // TypeScript lines that the emitter previously collapsed into one.
+    for (let index = 0; index < oldTokens.length; index++) {
+        if (lineAt(oldStarts, oldTokens[index].start) !==
+            lineAt(newStarts, newTokens[index].start))
+            return false;
+    }
+    const rebase = createSourceLineRebaser(path, previous, current);
+    let line = 1;
+    if (rebase(line) !== line)
+        return false;
+    for (let offset = 0; offset < previous.length; offset++) {
+        if (previous[offset] !== "\n")
+            continue;
+        line++;
+        if (rebase(line) !== line)
+            return false;
+    }
+    return true;
+}
+/** Rebase every SrcLoc-shaped object in a deserialized cache payload. */
+export function rebaseSourceLocations(value, previousSources, currentSources) {
+    const mappers = new Map();
+    for (const [path, previous] of previousSources) {
+        const current = currentSources.get(path);
+        if (current !== undefined)
+            mappers.set(path, offsetMapper(path, previous, current));
+    }
+    const visit = (node) => {
+        if (node === null || typeof node !== "object")
+            return;
+        const record = node;
+        if (typeof record["file"] === "string" &&
+            typeof record["start"] === "number" &&
+            typeof record["end"] === "number") {
+            const map = mappers.get(record["file"]);
+            if (map !== undefined) {
+                const start = record["start"];
+                const end = record["end"];
+                record["start"] = map.start(start);
+                record["end"] = start === end ? record["start"] : map.end(end);
+            }
+            return;
+        }
+        for (const child of Object.values(record)) {
+            if (Array.isArray(child))
+                child.forEach(visit);
+            else
+                visit(child);
+        }
+    };
+    visit(value);
+    return value;
+}
+//# sourceMappingURL=semantic-source.js.map

package/dist/library/semantic-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-source.js","sourceRoot":"","sources":["../../src/library/semantic-source.ts"],"names":[],"mappings":"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"}

package/dist/library/semantic-source.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/library/semantic-source.test.js

@@ -0,0 +1,113 @@
+import { expect, test } from "vitest";
+import { createSourceLineRebaser, rebaseSourceLocations, semanticallyEqualSource, semanticSourceDigest, sourceLineRebaseIsIdentity } from "./semantic-source.js";
+test("ordinary TypeScript comments and formatting preserve semantic identity", () => {
+    const before = "// old note\nexport function value(): number { return 1; }\n";
+    const after = "/* a longer replacement note */\n\nexport function value(): number { return 1; }\n";
+    expect(semanticallyEqualSource("entry.ts", before, after)).toBe(true);
+    expect(semanticSourceDigest("entry.ts", before)).toBe(semanticSourceDigest("entry.ts", after));
+});
+test("directives, pure annotations, JavaScript comments, and tokens remain semantic", () => {
+    expect(semanticallyEqualSource("entry.ts", "// @ts-expect-error\nconst x: number = 'x';\n", "// harmless\nconst x: number = 'x';\n")).toBe(false);
+    expect(semanticallyEqualSource("entry.ts", "const x = /* @__PURE__ */ make();\n", "const x = /* ordinary */ make();\n")).toBe(false);
+    expect(semanticallyEqualSource("entry.js", "/** @returns {number} */\nexport function value() { return 1; }\n", "/* ordinary */\nexport function value() { return 1; }\n")).toBe(false);
+    expect(semanticallyEqualSource("entry.ts", "return 1;\n", "return 2;\n")).toBe(false);
+});
+test("line breaks introduced by comments retain ASI-sensitive identity", () => {
+    expect(semanticallyEqualSource("entry.ts", "function f() { return /* same line */ value; }\n", "function f() { return /* split\nline */ value; }\n")).toBe(false);
+});
+test("comments cannot merge keywords with Unicode or escaped identifiers", () => {
+    for (const [before, after] of [
+        [
+            "const π = 1, typeofπ = 0; export const value = typeof/**/π ? 1 : 0;\n",
+            "const π = 1, typeofπ = 0; export const value = typeofπ ? 1 : 0;\n",
+        ],
+        [
+            String.raw `const π = 1, typeofπ = 0; export const value = typeof/**/\u03c0 ? 1 : 0;` + "\n",
+            String.raw `const π = 1, typeofπ = 0; export const value = typeof\u03c0 ? 1 : 0;` + "\n",
+        ],
+    ]) {
+        expect(semanticallyEqualSource("entry.ts", before, after)).toBe(false);
+        expect(semanticSourceDigest("entry.ts", before)).not.toBe(semanticSourceDigest("entry.ts", after));
+    }
+});
+test("ECMAScript line separators retain ASI and single-line-comment boundaries", () => {
+    for (const separator of ["\u2028", "\u2029"]) {
+        expect(semanticallyEqualSource("entry.ts", "function f() { return value; }\n", `function f() { return${separator}value; }\n`)).toBe(false);
+        expect(semanticallyEqualSource("entry.ts", `export const a = 1; // note${separator}export const b = 1;\n`, `export const a = 1; // note${separator}export const b = 2;\n`)).toBe(false);
+    }
+});
+test("source locations rebase across changed comment trivia", () => {
+    const before = "// old\nexport function value() { return 1; }\n";
+    const after = "/* much longer\n * note\n */\nexport function value() { return 1; }\n";
+    const oldStart = before.indexOf("return");
+    const oldEnd = oldStart + "return 1".length;
+    const payload = { loc: { file: "/entry.ts", start: oldStart, end: oldEnd } };
+    rebaseSourceLocations(payload, new Map([["/entry.ts", before]]), new Map([["/entry.ts", after]]));
+    expect(payload.loc.start).toBe(after.indexOf("return"));
+    expect(payload.loc.end).toBe(after.indexOf("return") + "return 1".length);
+});
+test("source lines rebase across changed comment trivia", () => {
+    const before = "// old\nexport function value() {\n  return 1;\n}\n";
+    const after = "/* much longer\n * note\n */\n\nexport function value() {\n  return 1;\n}\n";
+    const rebase = createSourceLineRebaser("/entry.ts", before, after);
+    expect(rebase(2)).toBe(5);
+    expect(rebase(3)).toBe(6);
+    expect(rebase(4)).toBe(7);
+    expect(sourceLineRebaseIsIdentity("/entry.ts", before, after)).toBe(false);
+    expect(sourceLineRebaseIsIdentity("/entry.ts", "// old\nexport function value() { return 1; }\n", "/* replacement */\nexport function value() { return 1; }\n")).toBe(true);
+});
+test("C source lines reject normalization of non-LF separators", () => {
+    for (const separator of ["\r", "\u2028", "\u2029"]) {
+        const before = `export const first = 1;${separator}export const second = 2;\n`;
+        const after = before.replace(separator, "\n");
+        expect(semanticallyEqualSource("/entry.ts", before, after)).toBe(true);
+        expect(sourceLineRebaseIsIdentity("/entry.ts", before, after)).toBe(false);
+    }
+});
+test("source locations at adjacent token boundaries rebase past inserted comments", () => {
+    const before = "export function value() { return left+right; }\n";
+    const after = "export function value() { return left+/* note */right; }\n";
+    const oldStart = before.indexOf("right");
+    const payload = {
+        loc: { file: "/entry.ts", start: oldStart, end: oldStart + "right".length },
+        empty: { file: "/entry.ts", start: oldStart, end: oldStart },
+    };
+    rebaseSourceLocations(payload, new Map([["/entry.ts", before]]), new Map([["/entry.ts", after]]));
+    expect(payload.loc.start).toBe(after.indexOf("right"));
+    expect(payload.loc.end).toBe(after.indexOf("right") + "right".length);
+    expect(payload.empty).toEqual({ file: "/entry.ts", start: after.indexOf("right"), end: after.indexOf("right") });
+});
+test("comment markers inside strings, templates, and regex literals are tokens", () => {
+    for (const [before, after] of [
+        ['const value = "/* old */";\n', 'const value = "/* new */";\n'],
+        ["const value = `// old`;\n", "const value = `// new`;\n"],
+        ["const value = /a\\/\\/*old/;\n", "const value = /a\\/\\/*new/;\n"],
+    ]) {
+        expect(semanticallyEqualSource("entry.ts", before, after)).toBe(false);
+    }
+});
+test("contextual regex literals cannot hide token edits as comments", () => {
+    for (const [before, after] of [
+        [
+            "if (flag) {} else /[//a]/.test(value);\n",
+            "if (flag) {} else /[//b]/.test(value);\n",
+        ],
+        [
+            "if (flag) /[//a]/.test(value);\n",
+            "if (flag) /[//b]/.test(value);\n",
+        ],
+        [
+            "do /[//a]/.test(value); while (flag);\n",
+            "do /[//b]/.test(value); while (flag);\n",
+        ],
+    ]) {
+        expect(semanticallyEqualSource("entry.ts", before, after)).toBe(false);
+    }
+});
+test("trivia cannot move a shebang away from the start of the file", () => {
+    const before = "#!/usr/bin/env node\nexport const value = 1;\n";
+    const after = `// inserted comment\n${before}`;
+    expect(semanticallyEqualSource("entry.ts", before, after)).toBe(false);
+    expect(semanticallyEqualSource("entry.ts", "export const value = 1;\n", "// inserted comment\nexport const value = 1;\n")).toBe(true);
+});
+//# sourceMappingURL=semantic-source.test.js.map

package/dist/library/semantic-source.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-source.test.js","sourceRoot":"","sources":["../../src/library/semantic-source.test.ts"],"names":[],"mappings":"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"}

package/dist/library/sidecar.d.ts

@@ -244,3 +244,9 @@ export type SidecarBuildResult = {
     diagnostics: ScrDiagnostic[];
 };
 export declare function buildSidecar(input: SidecarBuildInput): SidecarBuildResult;
+/**
+ * A semantic-cache hit has already validated/projected the sidecar. Only the
+ * exact-source identity fields may change after comment trivia edits; retain
+ * the established property order and replace those two values in place.
+ */
+export declare function updateSidecarIdentity(json: string, buildId: string, sourceHash: string): string;

package/dist/library/sidecar.js

@@ -1220,4 +1220,15 @@ export function buildSidecar(input) {
         throw e;
     }
 }
+/**
+ * A semantic-cache hit has already validated/projected the sidecar. Only the
+ * exact-source identity fields may change after comment trivia edits; retain
+ * the established property order and replace those two values in place.
+ */
+export function updateSidecarIdentity(json, buildId, sourceHash) {
+    const doc = JSON.parse(json);
+    doc.source_hash = sourceHash;
+    doc.build_id = buildId;
+    return JSON.stringify(doc, null, 2) + "\n";
+}
 //# sourceMappingURL=sidecar.js.map