ttsc 0.30.3 → 0.31.0

package/lib/compiler/internal/project/createNativeProjectContextArgs.js

@@ -1,26 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createNativeProjectContextArgs = createNativeProjectContextArgs;
-exports.createNativeProjectContextJson = createNativeProjectContextJson;
-/** Serialize the retained project identity for a native sidecar invocation. */
+const createNativeProjectContextJson_1 = require("./createNativeProjectContextJson");
+/**
+ * Encode retained project identity as one native sidecar argument. The JSON
+ * serializer owns payload shape; the argument carries no shell quoting.
+ *
+ * @evidence contracts/common.md#principled-implementation One --project-context-json argument contains the shared serializer's complete identity payload, preserving the native host's flag/value boundary for direct argv spawning.
+ * @evidence contracts/common.md#clear-and-simple-design This adapter owns the CLI envelope only; createNativeProjectContextJson is the sole project-context wire-shape owner.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The flag name is a declared sidecar protocol constant and the payload comes from retained project identity, without per-consumer path guesses or shell interpolation.
+ * @evidence contracts/common.md#meaningful-documentation The native comment distinguishes envelope and payload responsibility and explains argv representation following the documentation skill.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The one-element argv array and encoded string transfer to the caller; this adapter retains no history or native resource.
+ * @evidence contracts/performance.md#efficient-algorithms The shared serializer encodes identity bytes once, then a fixed protocol prefix and one-element array form the envelope; string work and returned storage scale with the encoded payload bytes.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This invocation-data envelope coordinates no completed or in-flight producer computation.
+ * @evidence contracts/portability.md#os-neutral-implementation Native path spellings stay JSON-encoded inside one argv element with no shell quoting or separator rewriting; the spawning caller owns OS process argument transport.
+ */
 function createNativeProjectContextArgs(project, pluginConfigOrigin) {
     return [
         "--project-context-json=" +
-            createNativeProjectContextJson(project, pluginConfigOrigin),
+            (0, createNativeProjectContextJson_1.createNativeProjectContextJson)(project, pluginConfigOrigin),
     ];
 }
-/**
- * The identity payload itself, for a caller that spawns a sidecar without going
- * through the compiler's own argument list.
- *
- * Split from the flag so there is still exactly one place that decides what a
- * sidecar is told about the project. A second caller assembling the same JSON,
- * or slicing it back out of the flag, is how the two drift.
- */
-function createNativeProjectContextJson(project, pluginConfigOrigin) {
-    return JSON.stringify({
-        ...project.identity,
-        ...(pluginConfigOrigin === undefined ? {} : { pluginConfigOrigin }),
-    });
-}
 //# sourceMappingURL=createNativeProjectContextArgs.js.map

package/lib/compiler/internal/project/createNativeProjectContextArgs.js.map

@@ -1 +1 @@
-{"version":3,"file":"createNativeProjectContextArgs.js","sourceRoot":"","sources":["../../../../src/compiler/internal/project/createNativeProjectContextArgs.ts"],"names":[],"mappings":";;;;AAEA,+EAA+E;AAC/E,wCACE,OAAiC,EACjC,kBAA2B;IAE3B,OAAO;QACL,yBAAyB;YACvB,8BAA8B,CAAC,OAAO,EAAE,kBAAkB,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,wCACE,OAAiC,EACjC,kBAA2B;IAE3B,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,GAAG,OAAO,CAAC,QAAQ;QACnB,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"createNativeProjectContextArgs.js","sourceRoot":"","sources":["../../../../src/compiler/internal/project/createNativeProjectContextArgs.ts"],"names":[],"mappings":";;;AACA,qFAAkF;AAElF;;;;;;;;;;;;GAYG;AACH,wCACE,OAAiC,EACjC,kBAA2B;IAE3B,OAAO;QACL,yBAAyB;YACvB,IAAA,+DAA8B,EAAC,OAAO,EAAE,kBAAkB,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/lib/compiler/internal/project/createNativeProjectContextJson.d.ts

@@ -0,0 +1,19 @@
+import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITtscParsedProjectConfig";
+/**
+ * The identity payload itself, for a caller that spawns a sidecar without going
+ * through the compiler's own argument list.
+ *
+ * Split from the flag so there is still exactly one place that decides what a
+ * sidecar is told about the project. A second caller assembling the same JSON,
+ * or slicing it back out of the flag, is how the two drift.
+ *
+ * @evidence contracts/common.md#principled-implementation JSON.stringify encodes the retained identity fields and includes pluginConfigOrigin only when explicitly provided, preserving the protocol's distinction between absent origin and an override.
+ * @evidence contracts/common.md#clear-and-simple-design One payload serializer serves argument and environment consumers so project-context field selection cannot drift between independent assembly paths.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Identity comes from the resolved project record rather than reinterpreting paths from a generated wrapper or substituting a known consumer's project directory.
+ * @evidence contracts/common.md#meaningful-documentation Purpose and ownership rationale occupy separate native paragraphs, with acknowledgments separated according to the documentation skill.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The serialized string is returned to the caller and nothing is retained.
+ * @evidence contracts/performance.md#efficient-algorithms One shallow identity copy and JSON serialization preserve the selected fields; encoding time and returned text scale with identity string bytes, not just the fixed field count.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work One serialization per call from its arguments; nothing is shared.
+ * @evidence contracts/portability.md#os-neutral-implementation JSON encoding preserves the supplied native path spellings, including separators and quoting characters, as structured protocol data without shell quoting, case folding or independent filesystem-identity certification.
+ */
+export declare function createNativeProjectContextJson(project: ITtscParsedProjectConfig, pluginConfigOrigin?: string): string;

package/lib/compiler/internal/project/createNativeProjectContextJson.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNativeProjectContextJson = createNativeProjectContextJson;
+/**
+ * The identity payload itself, for a caller that spawns a sidecar without going
+ * through the compiler's own argument list.
+ *
+ * Split from the flag so there is still exactly one place that decides what a
+ * sidecar is told about the project. A second caller assembling the same JSON,
+ * or slicing it back out of the flag, is how the two drift.
+ *
+ * @evidence contracts/common.md#principled-implementation JSON.stringify encodes the retained identity fields and includes pluginConfigOrigin only when explicitly provided, preserving the protocol's distinction between absent origin and an override.
+ * @evidence contracts/common.md#clear-and-simple-design One payload serializer serves argument and environment consumers so project-context field selection cannot drift between independent assembly paths.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Identity comes from the resolved project record rather than reinterpreting paths from a generated wrapper or substituting a known consumer's project directory.
+ * @evidence contracts/common.md#meaningful-documentation Purpose and ownership rationale occupy separate native paragraphs, with acknowledgments separated according to the documentation skill.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The serialized string is returned to the caller and nothing is retained.
+ * @evidence contracts/performance.md#efficient-algorithms One shallow identity copy and JSON serialization preserve the selected fields; encoding time and returned text scale with identity string bytes, not just the fixed field count.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work One serialization per call from its arguments; nothing is shared.
+ * @evidence contracts/portability.md#os-neutral-implementation JSON encoding preserves the supplied native path spellings, including separators and quoting characters, as structured protocol data without shell quoting, case folding or independent filesystem-identity certification.
+ */
+function createNativeProjectContextJson(project, pluginConfigOrigin) {
+    return JSON.stringify({
+        ...project.identity,
+        ...(pluginConfigOrigin === undefined ? {} : { pluginConfigOrigin }),
+    });
+}
+//# sourceMappingURL=createNativeProjectContextJson.js.map

package/lib/compiler/internal/project/createNativeProjectContextJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNativeProjectContextJson.js","sourceRoot":"","sources":["../../../../src/compiler/internal/project/createNativeProjectContextJson.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,wCACE,OAAiC,EACjC,kBAA2B;IAE3B,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,GAAG,OAAO,CAAC,QAAQ;QACnB,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}

package/lib/compiler/internal/project/parseJsonc.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Parse the text of a JSONC configuration file, a `tsconfig.json` or a
+ * `jsconfig.json`, by the grammar TypeScript-Go reads one with.
+ *
+ * This parser models the compiler's config literal grammar: comments that end
+ * at any ECMAScript line terminator (`\n`, `\r`, U+2028, U+2029), every
+ * character it counts as whitespace (a byte-order mark, a no-break space, the
+ * Unicode space separators), trailing commas, hexadecimal, octal, binary,
+ * fractional and separated numbers, valid string escapes, and a file holding no
+ * value at all, which reads as an empty object. It rejects: a key or string
+ * that is not double-quoted (TS1327), a value that is not a literal (TS1328), a
+ * legacy octal number (TS1121), a missing comma, and text after the root value.
+ * Legacy octal and decimal string escapes and malformed hexadecimal or Unicode
+ * escapes are rejected because the compiler scanner reports them, even when it
+ * constructs a recovery string. Raw U+2028/U+2029 remain string data; escaped
+ * line terminators continue the string. Returned objects preserve their
+ * authored keys, including an empty key and `__proto__`; this is not a
+ * reproduction of the compiler's recovery AST projection or diagnostic
+ * messages. Comment stripping over `JSON.parse` would reject the supported
+ * non-JSON literal forms.
+ *
+ * The one reading of that grammar in the workspace. ttsc's own project reader
+ * reads every config through it (`readJsoncFile`), and `@ttsc/unplugin` reads
+ * the configs it builds its membership policy and alias overlay from through
+ * the `ttsc/tsconfig` entry, so the two cannot disagree about what a config
+ * says. A failure names the line and UTF-16 column of the original text,
+ * treating CRLF as one line end and recognizing U+2028/U+2029 line ends.
+ *
+ * @param input The file's text as read.
+ * @returns The parsed value.
+ * @throws A `SyntaxError` naming the position of text that is not a config.
+ * @evidence contracts/common.md#principled-implementation Recursive descent follows the compiler config's literal, trivia and comma grammar; explicit property definition preserves __proto__ as data, and JavaScript Number represents numeric values rather than preserving arbitrary-precision source spelling. Error positions count the original UTF-16 text and ECMAScript line terminators.
+ * @evidence contracts/common.md#clear-and-simple-design One cursor owns token consumption and positioned failures, while bounded lexical helpers handle strings, numbers and trivia. Public parsing returns a fresh value; filesystem attribution and object-root validation remain reader responsibilities.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The parser implements the supported compiler grammar directly instead of stripping comments into a narrower JSON grammar or accepting particular config filenames and fixture values.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain accepted grammar, rejected forms, shared consumers and original-text positions, followed by native parameter/result/failure tags and separated acknowledgments following the documentation skill.
+ * @evidence contracts/performance.md#efficient-algorithms The cursor advances through N text units; sticky token patterns avoid materializing the remaining suffix for every literal, and string spans are joined once rather than appended character by character. Parsing retains O(N) value storage and O(D) recursive frames for depth D; an error-position scan adds at most O(N). Native stack limits still bound supported nesting depth.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each call returns a fresh mutable object/array tree; sharing a previous parse would expose one caller's mutations to another. This pure parser owns no immutable-result cache or coordinated config lifecycle.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The reader and lexical span arrays are invocation-local, and the parsed value transfers to its caller; no historical config tree, descriptor or task is retained in the module.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation parseJsonc computes from its arguments only; it opens no file, builds no path and calls no platform or process API.
+ */
+export declare function parseJsonc(input: string): unknown;

package/lib/compiler/internal/project/parseJsonc.js

@@ -0,0 +1,317 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJsonc = parseJsonc;
+/**
+ * Parse the text of a JSONC configuration file, a `tsconfig.json` or a
+ * `jsconfig.json`, by the grammar TypeScript-Go reads one with.
+ *
+ * This parser models the compiler's config literal grammar: comments that end
+ * at any ECMAScript line terminator (`\n`, `\r`, U+2028, U+2029), every
+ * character it counts as whitespace (a byte-order mark, a no-break space, the
+ * Unicode space separators), trailing commas, hexadecimal, octal, binary,
+ * fractional and separated numbers, valid string escapes, and a file holding no
+ * value at all, which reads as an empty object. It rejects: a key or string
+ * that is not double-quoted (TS1327), a value that is not a literal (TS1328), a
+ * legacy octal number (TS1121), a missing comma, and text after the root value.
+ * Legacy octal and decimal string escapes and malformed hexadecimal or Unicode
+ * escapes are rejected because the compiler scanner reports them, even when it
+ * constructs a recovery string. Raw U+2028/U+2029 remain string data; escaped
+ * line terminators continue the string. Returned objects preserve their
+ * authored keys, including an empty key and `__proto__`; this is not a
+ * reproduction of the compiler's recovery AST projection or diagnostic
+ * messages. Comment stripping over `JSON.parse` would reject the supported
+ * non-JSON literal forms.
+ *
+ * The one reading of that grammar in the workspace. ttsc's own project reader
+ * reads every config through it (`readJsoncFile`), and `@ttsc/unplugin` reads
+ * the configs it builds its membership policy and alias overlay from through
+ * the `ttsc/tsconfig` entry, so the two cannot disagree about what a config
+ * says. A failure names the line and UTF-16 column of the original text,
+ * treating CRLF as one line end and recognizing U+2028/U+2029 line ends.
+ *
+ * @param input The file's text as read.
+ * @returns The parsed value.
+ * @throws A `SyntaxError` naming the position of text that is not a config.
+ * @evidence contracts/common.md#principled-implementation Recursive descent follows the compiler config's literal, trivia and comma grammar; explicit property definition preserves __proto__ as data, and JavaScript Number represents numeric values rather than preserving arbitrary-precision source spelling. Error positions count the original UTF-16 text and ECMAScript line terminators.
+ * @evidence contracts/common.md#clear-and-simple-design One cursor owns token consumption and positioned failures, while bounded lexical helpers handle strings, numbers and trivia. Public parsing returns a fresh value; filesystem attribution and object-root validation remain reader responsibilities.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The parser implements the supported compiler grammar directly instead of stripping comments into a narrower JSON grammar or accepting particular config filenames and fixture values.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain accepted grammar, rejected forms, shared consumers and original-text positions, followed by native parameter/result/failure tags and separated acknowledgments following the documentation skill.
+ * @evidence contracts/performance.md#efficient-algorithms The cursor advances through N text units; sticky token patterns avoid materializing the remaining suffix for every literal, and string spans are joined once rather than appended character by character. Parsing retains O(N) value storage and O(D) recursive frames for depth D; an error-position scan adds at most O(N). Native stack limits still bound supported nesting depth.
+ *
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Each call returns a fresh mutable object/array tree; sharing a previous parse would expose one caller's mutations to another. This pure parser owns no immutable-result cache or coordinated config lifecycle.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The reader and lexical span arrays are invocation-local, and the parsed value transfers to its caller; no historical config tree, descriptor or task is retained in the module.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation parseJsonc computes from its arguments only; it opens no file, builds no path and calls no platform or process API.
+ */
+function parseJsonc(input) {
+    const reader = new JsoncReader(input);
+    reader.skipTrivia();
+    if (reader.done())
+        return {};
+    const value = reader.readValue();
+    reader.skipTrivia();
+    if (!reader.done())
+        reader.fail("Unexpected text after the root value");
+    return value;
+}
+/** A cursor over config text that reads one value at a time. */
+class JsoncReader {
+    text;
+    pos = 0;
+    constructor(text) {
+        this.text = text;
+    }
+    done() {
+        return this.pos >= this.text.length;
+    }
+    /** Skip whitespace, line terminators, and comments. */
+    skipTrivia() {
+        while (!this.done()) {
+            const current = this.text.charCodeAt(this.pos);
+            if (isWhiteSpace(current) || isLineBreak(current)) {
+                this.pos += 1;
+            }
+            else if (this.text.startsWith("//", this.pos)) {
+                this.pos += 2;
+                while (!this.done() && !isLineBreak(this.text.charCodeAt(this.pos)))
+                    this.pos += 1;
+            }
+            else if (this.text.startsWith("/*", this.pos)) {
+                const end = this.text.indexOf("*/", this.pos + 2);
+                if (end === -1)
+                    this.fail("Unterminated comment");
+                this.pos = end + 2;
+            }
+            else {
+                return;
+            }
+        }
+    }
+    readValue() {
+        const current = this.text[this.pos];
+        if (current === "{")
+            return this.readObject();
+        if (current === "[")
+            return this.readArray();
+        if (current === '"')
+            return this.readString();
+        if (current === "'")
+            this.fail("String literal with double quotes expected");
+        if (current === "-") {
+            // A prefix minus, which the compiler parses with trivia after it.
+            this.pos += 1;
+            this.skipTrivia();
+            return -this.readNumber();
+        }
+        if (current !== undefined && isNumberStart(this.text, this.pos))
+            return this.readNumber();
+        const word = this.matchToken(IDENTIFIER_LITERAL)?.[0];
+        if (word === "true" || word === "false" || word === "null") {
+            this.pos += word.length;
+            return word === "true" ? true : word === "false" ? false : null;
+        }
+        return this.fail(this.done()
+            ? "Unexpected end of text"
+            : "Property value can only be string literal, numeric literal, 'true', 'false', 'null', object literal or array literal");
+    }
+    /** Raise a failure positioned at the cursor. */
+    fail(message) {
+        let line = 1;
+        let column = 1;
+        for (let i = 0; i < this.pos && i < this.text.length; i += 1) {
+            const current = this.text.charCodeAt(i);
+            if (current === 0x0d && this.text.charCodeAt(i + 1) === 0x0a)
+                continue;
+            if (isLineBreak(current)) {
+                line += 1;
+                column = 1;
+            }
+            else {
+                column += 1;
+            }
+        }
+        throw new SyntaxError(`${message} (line ${line} column ${column})`);
+    }
+    readObject() {
+        const result = {};
+        this.pos += 1;
+        this.readElements("}", () => {
+            if (this.text[this.pos] !== '"')
+                this.fail("String literal with double quotes expected");
+            const key = this.readString();
+            this.skipTrivia();
+            if (this.text[this.pos] !== ":")
+                this.fail("':' expected");
+            this.pos += 1;
+            this.skipTrivia();
+            // A defined property, so a `__proto__` key stays an ordinary key.
+            Object.defineProperty(result, key, {
+                configurable: true,
+                enumerable: true,
+                value: this.readValue(),
+                writable: true,
+            });
+        });
+        return result;
+    }
+    readArray() {
+        const result = [];
+        this.pos += 1;
+        this.readElements("]", () => result.push(this.readValue()));
+        return result;
+    }
+    /** Read comma-separated elements up to `close`, allowing a trailing comma. */
+    readElements(close, readElement) {
+        this.skipTrivia();
+        while (this.text[this.pos] !== close) {
+            if (this.done())
+                this.fail(`'${close}' expected`);
+            readElement();
+            this.skipTrivia();
+            if (this.text[this.pos] === ",") {
+                this.pos += 1;
+                this.skipTrivia();
+            }
+            else if (this.text[this.pos] !== close) {
+                this.fail("',' expected");
+            }
+        }
+        this.pos += 1;
+    }
+    readString() {
+        this.pos += 1;
+        let start = this.pos;
+        const spans = [];
+        for (;;) {
+            if (this.done() ||
+                this.text[this.pos] === "\r" ||
+                this.text[this.pos] === "\n")
+                this.fail("Unterminated string literal");
+            const current = this.text[this.pos];
+            if (current === '"') {
+                spans.push(this.text.slice(start, this.pos));
+                this.pos += 1;
+                return spans.join("");
+            }
+            if (current !== "\\") {
+                this.pos += 1;
+                continue;
+            }
+            spans.push(this.text.slice(start, this.pos), this.readEscape());
+            start = this.pos;
+        }
+    }
+    /** Read one escape sequence, starting at its backslash. */
+    readEscape() {
+        this.pos += 1;
+        if (this.done())
+            this.fail("Unexpected end of text");
+        const current = this.text[this.pos];
+        this.pos += 1;
+        const simple = SIMPLE_ESCAPES[current];
+        if (simple !== undefined)
+            return simple;
+        if (current === "0" && !/[0-9]/.test(this.text[this.pos] ?? ""))
+            return "\0";
+        if (/[0-9]/.test(current))
+            this.fail("Octal and decimal escape sequences are not allowed");
+        if (current === "x")
+            return this.readHexEscape(2);
+        if (current === "u") {
+            if (this.text[this.pos] !== "{")
+                return this.readHexEscape(4);
+            const hex = this.matchToken(UNICODE_CODE_POINT_ESCAPE);
+            if (hex === null || parseInt(hex[1], 16) > 0x10ffff)
+                this.fail("Invalid Unicode escape sequence");
+            this.pos += hex[0].length;
+            return String.fromCodePoint(parseInt(hex[1], 16));
+        }
+        if (current === "\r") {
+            if (this.text[this.pos] === "\n")
+                this.pos += 1;
+            return "";
+        }
+        if (isLineBreak(current.charCodeAt(0)))
+            return "";
+        return current;
+    }
+    /**
+     * Read the exact digit count of a `\x` or `\u` escape. Compiler scanner
+     * diagnostics make an incomplete escape invalid configuration text.
+     */
+    readHexEscape(length) {
+        const start = this.pos - 2;
+        while (this.pos - start - 2 < length &&
+            /[0-9A-Fa-f]/.test(this.text[this.pos] ?? ""))
+            this.pos += 1;
+        const hex = this.text.slice(start + 2, this.pos);
+        if (hex.length !== length)
+            this.fail("Hexadecimal digit expected");
+        return String.fromCharCode(parseInt(hex, 16));
+    }
+    readNumber() {
+        const token = this.matchToken(NUMERIC_LITERAL)?.[0];
+        if (token === undefined)
+            return this.fail("Numeric literal expected");
+        if (/^0[0-9]/.test(token))
+            this.fail("Octal literals are not allowed");
+        this.pos += token.length;
+        // A separator in the wrong place, a second `.`, or a suffix stops the
+        // literal early; the compiler reports what follows it.
+        if (/^[\w$.]/.test(this.text[this.pos] ?? ""))
+            this.fail("Invalid character after a numeric literal");
+        return Number(token.replaceAll("_", ""));
+    }
+    /** Reset a sticky pattern to this cursor before every match. */
+    matchToken(pattern) {
+        pattern.lastIndex = this.pos;
+        return pattern.exec(this.text);
+    }
+}
+const IDENTIFIER_LITERAL = /[A-Za-z_$][\w$]*/y;
+const UNICODE_CODE_POINT_ESCAPE = /\{([0-9A-Fa-f]+)\}/y;
+/**
+ * An ECMAScript numeric literal without a sign: hexadecimal, octal, binary, or
+ * decimal with an optional fraction and exponent, each digit run allowing
+ * single `_` separators between digits.
+ */
+const NUMERIC_LITERAL = new RegExp([
+    "0[xX][0-9A-Fa-f]+(?:_[0-9A-Fa-f]+)*",
+    "0[oO][0-7]+(?:_[0-7]+)*",
+    "0[bB][01]+(?:_[01]+)*",
+    "(?:[0-9]+(?:_[0-9]+)*(?:\\.(?:[0-9]+(?:_[0-9]+)*)?)?|\\.[0-9]+(?:_[0-9]+)*)(?:[eE][+-]?[0-9]+(?:_[0-9]+)*)?",
+].join("|"), "y");
+const SIMPLE_ESCAPES = {
+    '"': '"',
+    "'": "'",
+    "\\": "\\",
+    b: "\b",
+    f: "\f",
+    n: "\n",
+    r: "\r",
+    t: "\t",
+    v: "\v",
+};
+/** Whether a number starts at `pos`: a digit, or a `.` before a digit. */
+function isNumberStart(text, pos) {
+    return /[0-9]/.test(text[pos]) || /^\.[0-9]/.test(text.slice(pos, pos + 2));
+}
+/** TypeScript-Go's `IsLineBreak`: the ECMAScript line terminators. */
+function isLineBreak(code) {
+    return code === 0x0a || code === 0x0d || code === 0x2028 || code === 0x2029;
+}
+/** TypeScript-Go's `IsWhiteSpaceSingleLine`. */
+function isWhiteSpace(code) {
+    return (code === 0x20 ||
+        code === 0x09 ||
+        code === 0x0b ||
+        code === 0x0c ||
+        code === 0x85 ||
+        code === 0xa0 ||
+        code === 0x1680 ||
+        (code >= 0x2000 && code <= 0x200b) ||
+        code === 0x202f ||
+        code === 0x205f ||
+        code === 0x3000 ||
+        code === 0xfeff);
+}
+//# sourceMappingURL=parseJsonc.js.map

package/lib/compiler/internal/project/parseJsonc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseJsonc.js","sourceRoot":"","sources":["../../../../src/compiler/internal/project/parseJsonc.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,oBAA2B,KAAa;IACtC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,UAAU,EAAE,CAAC;IACpB,IAAI,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,MAAM,CAAC,UAAU,EAAE,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gEAAgE;AAChE,MAAM,WAAW;IAGqB,IAAI;IAFhC,GAAG,GAAG,CAAC,CAAC;IAEhB,YAAoC,IAAY;oBAAZ,IAAI;IAAW,CAAC;IAE7C,IAAI;QACT,OAAO,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,uDAAuD;IAChD,UAAU;QACf,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACjE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBAClD,IAAI,GAAG,KAAK,CAAC,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBAClD,IAAI,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAEM,SAAS;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,OAAO,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7C,IAAI,OAAO,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,OAAO,KAAK,GAAG;YACjB,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC1D,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,kEAAkE;YAClE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACd,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;YAC7D,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3D,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC;YACxB,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,IAAI,EAAE;YACT,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,sHAAsH,CAC3H,CAAC;IACJ,CAAC;IAED,gDAAgD;IACzC,IAAI,CAAC,OAAe;QACzB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,SAAS;YACvE,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,CAAC;gBACV,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,WAAW,CAAC,GAAG,OAAO,UAAU,IAAI,WAAW,MAAM,GAAG,CAAC,CAAC;IACtE,CAAC;IAEO,UAAU;QAChB,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE;YAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;gBAC7B,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;gBAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3D,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACd,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,kEAAkE;YAClE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;gBACjC,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI;gBAChB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE;gBACvB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS;QACf,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8EAA8E;IACtE,YAAY,CAAC,KAAa,EAAE,WAAuB;QACzD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;YAClD,WAAW,EAAE,CAAC;YACd,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBACd,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;gBACzC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAChB,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,SAAS,CAAC;YACR,IACE,IAAI,CAAC,IAAI,EAAE;gBACX,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI;gBAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI;gBAE5B,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC;YACrC,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7C,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBACd,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;YACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBACd,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAChE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACnB,CAAC;IACH,CAAC;IAED,2DAA2D;IACnD,UAAU;QAChB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,OAAO,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;YACvD,IAAI,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,QAAQ;gBAClD,IAAI,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1B,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAChD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,aAAa,CAAC,MAAc;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QAC3B,OACE,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,GAAG,MAAM;YAC7B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAE7C,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAEO,UAAU;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACtE,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC;QACzB,sEAAsE;QACtE,uDAAuD;QACvD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,gEAAgE;IACxD,UAAU,CAAC,OAAe;QAChC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC;QAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAED,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAC/C,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,MAAM,eAAe,GAAG,IAAI,MAAM,CAChC;IACE,qCAAqC;IACrC,yBAAyB;IACzB,uBAAuB;IACvB,6GAA6G;CAC9G,CAAC,IAAI,CAAC,GAAG,CAAC,EACX,GAAG,CACJ,CAAC;AAEF,MAAM,cAAc,GAA2B;IAC7C,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,IAAI;IACV,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAC;AAEF,0EAA0E;AAC1E,SAAS,aAAa,CAAC,IAAY,EAAE,GAAW;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,sEAAsE;AACtE,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,CAAC;AAC9E,CAAC;AAED,gDAAgD;AAChD,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,CACL,IAAI,KAAK,IAAI;QACb,IAAI,KAAK,IAAI;QACb,IAAI,KAAK,IAAI;QACb,IAAI,KAAK,IAAI;QACb,IAAI,KAAK,IAAI;QACb,IAAI,KAAK,IAAI;QACb,IAAI,KAAK,MAAM;QACf,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;QAClC,IAAI,KAAK,MAAM;QACf,IAAI,KAAK,MAAM;QACf,IAAI,KAAK,MAAM;QACf,IAAI,KAAK,MAAM,CAChB,CAAC;AACJ,CAAC"}

package/lib/compiler/internal/project/readJsonFile.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Read and parse a strict-JSON configuration file (`package.json`), naming it
+ * on parse failure. Native file-read failures propagate from Node unchanged.
+ *
+ * A leading UTF-8 BOM is accepted, matching the tsconfig reader: the two
+ * readers are consulted for the same project and disagreeing about a byte order
+ * mark would only surprise the user who hit it.
+ *
+ * The parsed value remains unknown; its consuming contract validates root
+ * shape.
+ *
+ * @evidence contracts/common.md#principled-implementation JSON.parse owns strict JSON syntax after one length-preserving leading-BOM replacement; returning unknown avoids claiming that arbitrary valid JSON is already a package-record shape.
+ * @evidence contracts/common.md#clear-and-simple-design The reader owns filename-attributed parse errors and delegates BOM and error rendering to shared text helpers; root-shape validation belongs to each consuming schema.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Malformed configuration remains an error with its real filename, without comment stripping or an empty-object fallback that would weaken strict JSON semantics.
+ * @evidence contracts/common.md#meaningful-documentation Purpose, BOM rationale and unknown-root ownership are documented in native paragraphs following the documentation skill; obsolete comment-stripping claims were removed.
+ * @evidence contracts/portability.md#os-neutral-implementation Node receives the native filename and explicit UTF-8 decoding; a BOM is a text-format distinction rather than an OS-specific path or newline rule.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Node owns the synchronous file-read handle lifecycle; input and normalized text are local, while the caller owns the returned parsed value. Completion makes local references reclaimable without guaranteeing immediate engine reclamation or independent backing storage for returned strings; no historical file registry is retained here.
+ * @evidence contracts/performance.md#efficient-algorithms One native UTF-8 read, optional length-preserving BOM replacement and builtin JSON.parse incur file/path lookup, byte decoding and parsed-value construction costs. Temporary text and returned values grow with input content; fixed call counts do not make the delegated work constant, and no second parse or comment-removal pass is added.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This reader owns no cross-request config coordination or validity proof; it reads current mutable file content and returns a caller-owned value rather than sharing an unvalidated historical result.
+ */
+export declare function readJsonFile(file: string): unknown;

package/lib/compiler/internal/project/readJsonFile.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readJsonFile = readJsonFile;
+const node_fs_1 = __importDefault(require("node:fs"));
+const ConfigJsonText_1 = require("./ConfigJsonText");
+/**
+ * Read and parse a strict-JSON configuration file (`package.json`), naming it
+ * on parse failure. Native file-read failures propagate from Node unchanged.
+ *
+ * A leading UTF-8 BOM is accepted, matching the tsconfig reader: the two
+ * readers are consulted for the same project and disagreeing about a byte order
+ * mark would only surprise the user who hit it.
+ *
+ * The parsed value remains unknown; its consuming contract validates root
+ * shape.
+ *
+ * @evidence contracts/common.md#principled-implementation JSON.parse owns strict JSON syntax after one length-preserving leading-BOM replacement; returning unknown avoids claiming that arbitrary valid JSON is already a package-record shape.
+ * @evidence contracts/common.md#clear-and-simple-design The reader owns filename-attributed parse errors and delegates BOM and error rendering to shared text helpers; root-shape validation belongs to each consuming schema.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Malformed configuration remains an error with its real filename, without comment stripping or an empty-object fallback that would weaken strict JSON semantics.
+ * @evidence contracts/common.md#meaningful-documentation Purpose, BOM rationale and unknown-root ownership are documented in native paragraphs following the documentation skill; obsolete comment-stripping claims were removed.
+ * @evidence contracts/portability.md#os-neutral-implementation Node receives the native filename and explicit UTF-8 decoding; a BOM is a text-format distinction rather than an OS-specific path or newline rule.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Node owns the synchronous file-read handle lifecycle; input and normalized text are local, while the caller owns the returned parsed value. Completion makes local references reclaimable without guaranteeing immediate engine reclamation or independent backing storage for returned strings; no historical file registry is retained here.
+ * @evidence contracts/performance.md#efficient-algorithms One native UTF-8 read, optional length-preserving BOM replacement and builtin JSON.parse incur file/path lookup, byte decoding and parsed-value construction costs. Temporary text and returned values grow with input content; fixed call counts do not make the delegated work constant, and no second parse or comment-removal pass is added.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This reader owns no cross-request config coordination or validity proof; it reads current mutable file content and returns a caller-owned value rather than sharing an unvalidated historical result.
+ */
+function readJsonFile(file) {
+    const text = ConfigJsonText_1.ConfigJsonText.stripLeadingBom(node_fs_1.default.readFileSync(file, "utf8"));
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`ttsc: failed to parse ${file}: ${ConfigJsonText_1.ConfigJsonText.describe(error)}`);
+    }
+}
+//# sourceMappingURL=readJsonFile.js.map

package/lib/compiler/internal/project/readJsonFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readJsonFile.js","sourceRoot":"","sources":["../../../../src/compiler/internal/project/readJsonFile.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAEzB,qDAAkD;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,sBAA6B,IAAY;IACvC,MAAM,IAAI,GAAG,+BAAc,CAAC,eAAe,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,KAAK,+BAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/compiler/internal/project/readJsoncFile.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Read and parse a JSONC (JSON with comments and trailing commas) configuration
+ * file — tsconfig.json, jsconfig.json — naming parse and root-shape failures.
+ * Native file-read failures propagate from Node unchanged.
+ *
+ * The root must be an object, as the compiler requires (its TS5092). A root of
+ * `null`, an array, or a primitive is valid JSONC but not a configuration, and
+ * is reported here with the compiler's wording instead of surfacing later as a
+ * property read on a non-object.
+ *
+ * @evidence contracts/common.md#principled-implementation The shared JSONC parser establishes literal syntax, and an explicit object/non-null/non-array guard establishes the compiler config's object root before returning a record to project readers.
+ * @evidence contracts/common.md#clear-and-simple-design This boundary owns file reading, filename attribution and config-root validation; lexical parsing remains in parseJsonc so consumers share one grammar.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Invalid syntax and root shapes remain named errors rather than being replaced by empty configs that could hide user configuration mistakes.
+ * @evidence contracts/common.md#meaningful-documentation Separate paragraphs explain file attribution and the distinction between valid JSONC values and permitted config roots, following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Node reads the supplied native path as UTF-8; native basename selects jsconfig.json root wording only for that exact filename, matching the compiler's choice. Parsing counts text line terminators independently of OS newline conventions, with no path-case assumption.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Node owns the synchronous file-read handle lifecycle; text and parser state are local, while the caller owns the returned config tree. Successful return or failure makes local state reclaimable without a forced engine-reclamation deadline; no historical config population or live observer is retained here.
+ * @evidence contracts/performance.md#efficient-algorithms A native UTF-8 read delegates path lookup and byte decoding, then the shared parser consumes text, constructs a value and can scan the original text for a failure position. Work and temporary/output storage depend on file content and parser nesting; one reader call does not make that delegated parsing constant. Root-shape checks are fixed, and filename attribution formats path/error text.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This reader coordinates no completed or in-flight configs across requests; current file parsing and fresh mutable output belong to its caller, which must own any higher-level validity proof.
+ */
+export declare function readJsoncFile(file: string): Record<string, unknown>;

package/lib/compiler/internal/project/readJsoncFile.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readJsoncFile = readJsoncFile;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const ConfigJsonText_1 = require("./ConfigJsonText");
+const parseJsonc_1 = require("./parseJsonc");
+/**
+ * Read and parse a JSONC (JSON with comments and trailing commas) configuration
+ * file — tsconfig.json, jsconfig.json — naming parse and root-shape failures.
+ * Native file-read failures propagate from Node unchanged.
+ *
+ * The root must be an object, as the compiler requires (its TS5092). A root of
+ * `null`, an array, or a primitive is valid JSONC but not a configuration, and
+ * is reported here with the compiler's wording instead of surfacing later as a
+ * property read on a non-object.
+ *
+ * @evidence contracts/common.md#principled-implementation The shared JSONC parser establishes literal syntax, and an explicit object/non-null/non-array guard establishes the compiler config's object root before returning a record to project readers.
+ * @evidence contracts/common.md#clear-and-simple-design This boundary owns file reading, filename attribution and config-root validation; lexical parsing remains in parseJsonc so consumers share one grammar.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Invalid syntax and root shapes remain named errors rather than being replaced by empty configs that could hide user configuration mistakes.
+ * @evidence contracts/common.md#meaningful-documentation Separate paragraphs explain file attribution and the distinction between valid JSONC values and permitted config roots, following the documentation skill.
+ * @evidence contracts/portability.md#os-neutral-implementation Node reads the supplied native path as UTF-8; native basename selects jsconfig.json root wording only for that exact filename, matching the compiler's choice. Parsing counts text line terminators independently of OS newline conventions, with no path-case assumption.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Node owns the synchronous file-read handle lifecycle; text and parser state are local, while the caller owns the returned config tree. Successful return or failure makes local state reclaimable without a forced engine-reclamation deadline; no historical config population or live observer is retained here.
+ * @evidence contracts/performance.md#efficient-algorithms A native UTF-8 read delegates path lookup and byte decoding, then the shared parser consumes text, constructs a value and can scan the original text for a failure position. Work and temporary/output storage depend on file content and parser nesting; one reader call does not make that delegated parsing constant. Root-shape checks are fixed, and filename attribution formats path/error text.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This reader coordinates no completed or in-flight configs across requests; current file parsing and fresh mutable output belong to its caller, which must own any higher-level validity proof.
+ */
+function readJsoncFile(file) {
+    const text = node_fs_1.default.readFileSync(file, "utf8");
+    let parsed;
+    try {
+        parsed = (0, parseJsonc_1.parseJsonc)(text);
+    }
+    catch (error) {
+        throw new Error(`ttsc: failed to parse ${file}: ${ConfigJsonText_1.ConfigJsonText.describe(error)}`);
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        const name = node_path_1.default.basename(file) === "jsconfig.json"
+            ? "jsconfig.json"
+            : "tsconfig.json";
+        throw new Error(`ttsc: failed to parse ${file}: The root value of a '${name}' file must be an object.`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=readJsoncFile.js.map

package/lib/compiler/internal/project/readJsoncFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readJsoncFile.js","sourceRoot":"","sources":["../../../../src/compiler/internal/project/readJsoncFile.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,qDAAkD;AAClD,6CAA0C;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,uBAA8B,IAAY;IACxC,MAAM,IAAI,GAAG,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,uBAAU,EAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,KAAK,+BAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,GACR,mBAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,eAAe;YACrC,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,eAAe,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,0BAA0B,IAAI,2BAA2B,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC"}