@scriptc/compiler 0.3.6 → 0.4.1

package/dist/frontend/arguments-usage.js

@@ -37,4 +37,102 @@ export function bodyReadsArguments(fn) {
     });
     return found;
 }
+/** Whether an expression is assigned, updated or deleted. */
+function isWritten(expr) {
+    let node = expr;
+    while (ts.isParenthesizedExpression(node.parent))
+        node = node.parent;
+    const parent = node.parent;
+    if (ts.isBinaryExpression(parent))
+        return (parent.left === node &&
+            parent.operatorToken.kind >= ts.SyntaxKind.FirstAssignment &&
+            parent.operatorToken.kind <= ts.SyntaxKind.LastAssignment);
+    if (ts.isPrefixUnaryExpression(parent) || ts.isPostfixUnaryExpression(parent))
+        return (parent.operator === ts.SyntaxKind.PlusPlusToken ||
+            parent.operator === ts.SyntaxKind.MinusMinusToken);
+    if (ts.isForInStatement(parent) || ts.isForOfStatement(parent))
+        return parent.initializer === node;
+    if (ts.isArrayLiteralExpression(parent) ||
+        ts.isSpreadElement(parent) ||
+        ts.isShorthandPropertyAssignment(parent) ||
+        (ts.isPropertyAssignment(parent) && parent.initializer === node))
+        return isWritten(parent);
+    if (ts.isObjectLiteralExpression(parent) || ts.isSpreadAssignment(parent))
+        return isWritten(parent);
+    return ts.isDeleteExpression(parent);
+}
+/** Whether an identifier assigns its binding where it declares it: a
+ * `var` with an initializer or in a for-in/for-of head, a destructured
+ * element, or a function declaration's name. A redeclared parameter keeps
+ * its binding, so each of these writes the parameter. */
+function isDeclarationWrite(id) {
+    const parent = id.parent;
+    if (ts.isVariableDeclaration(parent) && parent.name === id) {
+        if (parent.initializer !== undefined)
+            return true;
+        const head = parent.parent?.parent;
+        return ((ts.isForInStatement(head) || ts.isForOfStatement(head)) && head.initializer === parent.parent);
+    }
+    if (ts.isBindingElement(parent))
+        return parent.name === id;
+    return ts.isFunctionDeclaration(parent) && parent.name === id;
+}
+/** Whether sloppy-mode `arguments` in `fn`'s own body behaves exactly like
+ * an unmapped copy of the call's arguments. A mapped arguments object
+ * aliases the named parameters, so it differs from a copy only when one
+ * side is written after the other is read: reading `arguments.length`
+ * never observes the aliasing, and element reads cannot observe it while
+ * nothing writes an element or a parameter. The object itself must not
+ * escape, since another holder could write through it. */
+export function argumentsAliasingUnobservable(fn) {
+    if (fn.body === undefined)
+        return false;
+    let elementReads = false;
+    let escapes = false;
+    ts.walkPreorder(fn.body, (node) => {
+        if (ts.isTypeNode(node))
+            return "skip";
+        if (ts.isFunctionLike(node) && !ts.isArrowFunction(node) && node !== fn)
+            return "skip";
+        if (!ts.isIdentifier(node) || node.text !== "arguments" || !isArgumentsRead(node))
+            return undefined;
+        const parent = node.parent;
+        if (ts.isPropertyAccessExpression(parent) &&
+            parent.expression === node &&
+            parent.name.text === "length" &&
+            !isWritten(parent))
+            return undefined;
+        if (ts.isElementAccessExpression(parent) && parent.expression === node && !isWritten(parent)) {
+            elementReads = true;
+            return undefined;
+        }
+        escapes = true;
+        return "stop";
+    });
+    if (escapes)
+        return false;
+    if (!elementReads)
+        return true;
+    const names = new Set();
+    for (const p of fn.parameters.nodes) {
+        if (!ts.isIdentifier(p.name))
+            return false;
+        names.add(p.name.text);
+    }
+    // Any write to a parameter's name, including from nested closures and
+    // shadowing bindings, conservatively counts as a parameter write.
+    let paramWritten = false;
+    ts.walkPreorder(fn.body, (node) => {
+        if (ts.isTypeNode(node))
+            return "skip";
+        if (ts.isIdentifier(node) &&
+            names.has(node.text) &&
+            (isWritten(node) || isDeclarationWrite(node))) {
+            paramWritten = true;
+            return "stop";
+        }
+        return undefined;
+    });
+    return !paramWritten;
+}
 //# sourceMappingURL=arguments-usage.js.map

package/dist/frontend/arguments-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"arguments-usage.js","sourceRoot":"","sources":["../../src/frontend/arguments-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,mFAAmF;AACnF,SAAS,eAAe,CAAC,EAAiB;IACxC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;IACzB,0EAA0E;IAC1E,mEAAmE;IACnE,IAAI,EAAE,CAAC,6BAA6B,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAK,MAAuC,CAAC,IAAI,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE;QACxF,OAAO,KAAK,CAAC;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED;2DAC2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,EAAW;IAC5C,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,0EAA0E;IAC1E,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QACvC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAChF,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACxE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"arguments-usage.js","sourceRoot":"","sources":["../../src/frontend/arguments-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,mFAAmF;AACnF,SAAS,eAAe,CAAC,EAAiB;IACxC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;IACzB,0EAA0E;IAC1E,mEAAmE;IACnE,IAAI,EAAE,CAAC,6BAA6B,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAK,MAAuC,CAAC,IAAI,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE;QACxF,OAAO,KAAK,CAAC;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED;2DAC2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,EAAW;IAC5C,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,0EAA0E;IAC1E,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QACvC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAChF,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACxE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAC7D,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC;QAC/B,OAAO,CACL,MAAM,CAAC,IAAI,KAAK,IAAI;YACpB,MAAM,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe;YAC1D,MAAM,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAC1D,CAAC;IACJ,IAAI,EAAE,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC;QAC3E,OAAO,CACL,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa;YAC/C,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC,UAAU,CAAC,eAAe,CAClD,CAAC;IACJ,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAC5D,OAAO,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;IACrC,IACE,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC;QACnC,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC;QAC1B,EAAE,CAAC,6BAA6B,CAAC,MAAM,CAAC;QACxC,CAAC,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;QAEhE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC;QACvE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;yDAGyD;AACzD,SAAS,kBAAkB,CAAC,EAAiB;IAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;QAC3D,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;QACnC,OAAO,CACL,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC,MAAM,CAC/F,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;IAC3D,OAAO,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;0DAM0D;AAC1D,MAAM,UAAU,6BAA6B,CAAC,EAA2B;IACvE,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QACvC,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,MAAM,CAAC;QACvF,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;YAC/E,OAAO,SAAS,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IACE,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC;YACrC,MAAM,CAAC,UAAU,KAAK,IAAI;YAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;YAC7B,CAAC,SAAS,CAAC,MAAM,CAAC;YAElB,OAAO,SAAS,CAAC;QACnB,IAAI,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7F,YAAY,GAAG,IAAI,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,IAAI,OAAO;QAAE,OAAO,KAAK,CAAC;IAC1B,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,sEAAsE;IACtE,kEAAkE;IAClE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QACvC,IACE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;YACrB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YACpB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAC7C,CAAC;YACD,YAAY,GAAG,IAAI,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,YAAY,CAAC;AACvB,CAAC"}

package/dist/frontend/arguments-usage.test.d.ts

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

package/dist/frontend/arguments-usage.test.js

@@ -0,0 +1,32 @@
+import { afterAll, expect, test } from "vitest";
+import { argumentsAliasingUnobservable } from "./arguments-usage.js";
+import * as ts from "./ts7/adapter.js";
+import { closeSourceParser, parseSourceFile } from "./ts7/source-parser-node.js";
+afterAll(closeSourceParser);
+function unobservable(source) {
+    const file = parseSourceFile("scan.js", source, "js");
+    const fn = file.statements.nodes.find(ts.isFunctionDeclaration);
+    if (fn === undefined)
+        throw new Error("no function declaration");
+    return argumentsAliasingUnobservable(fn);
+}
+test("element reads stay unobservable while nothing writes a parameter", () => {
+    expect(unobservable("function f(a, b) { return arguments[0] + arguments.length; }")).toBe(true);
+    expect(unobservable("function f(a) { var a; return arguments[0]; }")).toBe(true);
+    expect(unobservable("function f(a) { var b = 1; return arguments[0] + b; }")).toBe(true);
+});
+test("a parameter written by assignment or by a declaration makes element reads observable", () => {
+    for (const body of [
+        "a = 5;",
+        "a++;",
+        "var a = 5;",
+        "for (var a in o);",
+        "for (var a of o);",
+        "var { a } = o;",
+        "var [a] = o;",
+        "function a() {}",
+    ]) {
+        expect(unobservable(`function f(a, o) { ${body} return arguments[0]; }`), body).toBe(false);
+    }
+});
+//# sourceMappingURL=arguments-usage.test.js.map

package/dist/frontend/arguments-usage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments-usage.test.js","sourceRoot":"","sources":["../../src/frontend/arguments-usage.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEjF,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAE5B,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC;IAChE,IAAI,EAAE,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACjE,OAAO,6BAA6B,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC5E,MAAM,CAAC,YAAY,CAAC,8DAA8D,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChG,MAAM,CAAC,YAAY,CAAC,+CAA+C,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,MAAM,CAAC,YAAY,CAAC,uDAAuD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3F,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sFAAsF,EAAE,GAAG,EAAE;IAChG,KAAK,MAAM,IAAI,IAAI;QACjB,QAAQ;QACR,MAAM;QACN,YAAY;QACZ,mBAAmB;QACnB,mBAAmB;QACnB,gBAAgB;QAChB,cAAc;QACd,iBAAiB;KAClB,EAAE,CAAC;QACF,MAAM,CAAC,YAAY,CAAC,sBAAsB,IAAI,yBAAyB,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/frontend/builtin-modules.d.ts

@@ -1,5 +1,5 @@
 /** The node builtin modules with scriptc lowerings, by canonical bare name. */
-export declare const SUPPORTED_BUILTIN_MODULES: readonly ["fs", "path", "path/posix", "path/win32", "os", "url", "fs/promises", "crypto", "zlib", "child_process", "net", "http", "tls", "https", "dgram", "dns", "util", "util/types", "string_decoder", "querystring", "readline", "readline/promises", "http2", "assert", "assert/strict", "worker_threads", "buffer", "cluster", "tty", "async_hooks", "events", "stream", "stream/promises", "stream/consumers", "test", "timers", "timers/promises", "diagnostics_channel", "perf_hooks", "module", "console", "process"];
+export declare const SUPPORTED_BUILTIN_MODULES: readonly ["fs", "path", "path/posix", "path/win32", "os", "url", "fs/promises", "crypto", "zlib", "child_process", "net", "http", "tls", "https", "dgram", "dns", "util", "util/types", "string_decoder", "querystring", "readline", "readline/promises", "http2", "assert", "assert/strict", "worker_threads", "buffer", "cluster", "tty", "async_hooks", "events", "stream", "stream/promises", "stream/consumers", "test", "timers", "timers/promises", "diagnostics_channel", "perf_hooks", "module", "console", "process", "v8", "stream/web", "dns/promises", "punycode", "constants"];
 /** The builtin modules whose DEFAULT import binding lowers: node:assert's
  * module object IS a callable function (`import assert from "node:assert";
  * assert(x)`), and node:events' module object IS the EventEmitter class
@@ -11,11 +11,25 @@ export declare function builtinDefaultImportModule(spec: string): string | null;
  * for both "fs" and "node:fs" — or null for everything else. The lowering
  * tables and the preflight allowlist share this one normalization. */
 export declare function canonicalBuiltinModule(spec: string): string | null;
+/** The builtin module an npm package specifier is served as, or null. */
+export declare function npmBuiltinAliasOf(spec: string): string | null;
 /** Both specifier spellings of every supported builtin (prefix-only ones
- * keep just the node: form) — the ambient-module allowlist preflight uses. */
+ * keep just the node: form) — the ambient-module allowlist preflight uses
+ * — plus the npm packages served as builtins. */
 export declare const SUPPORTED_NODE_MODULES: readonly string[];
+/** node:v8 is importable (packages require it at top level and touch it
+ * only on optional paths), and getHeapStatistics answers allocator-derived
+ * figures; every other member observes the engine itself. Member fences
+ * carry this reason instead of a module-level refusal. */
+export declare const V8_MEMBER_REASON = "by design: this member observes V8 engine internals \u2014 heap snapshots and spaces, GC and CPU profiles, flags, serialize/deserialize \u2014 and a compiled binary embeds no V8 engine to observe";
 /** The SC1010 feature string for an unsupported module specifier: the
  * plain "the 'x' module" for pending surface, with the out-of-scope
  * reason appended for the modules above. Every "the '<spec>' module"
  * fence site words through this one helper. */
 export declare function unsupportedModuleFeatureOf(spec: string): string;
+/** The ESNext temporal global's name. Node 24 does not define it: programs
+ * that name it type-check against TS 7's lib slice (program.ts adds it only
+ * for them) and lower to Node's answers. Spelled in two pieces so the
+ * compiler's own sources never trip program.ts's scan when scriptc
+ * compiles itself. */
+export declare const TEMPORAL_GLOBAL: string;

package/dist/frontend/builtin-modules.js

@@ -42,6 +42,11 @@ export const SUPPORTED_BUILTIN_MODULES = [
     "module",
     "console",
     "process",
+    "v8",
+    "stream/web",
+    "dns/promises",
+    "punycode",
+    "constants",
 ];
 /** Builtins Node itself serves ONLY under the node: prefix —
  * require("test") is MODULE_NOT_FOUND in Node, so the bare name stays a
@@ -72,11 +77,29 @@ export function canonicalBuiltinModule(spec) {
     const bare = spec.startsWith("node:") ? spec.slice(5) : spec;
     if (bare === spec && PREFIX_ONLY_BUILTIN_MODULES.has(bare))
         return null;
-    return SUPPORTED_BUILTIN_MODULES.includes(bare) ? bare : null;
+    if (SUPPORTED_BUILTIN_MODULES.includes(bare))
+        return bare;
+    return bare === spec ? npmBuiltinAliasOf(spec) : null;
+}
+/** npm packages served as a builtin module instead of compiling their
+ * JavaScript (maintainer decision): graceful-fs monkeypatches the fs
+ * module object and queues retries on EMFILE/ENFILE, which statically
+ * lowered fs calls cannot honor, and it behaves as fs everywhere else. Its
+ * import and require resolve to node:fs; gracefulify is a no-op statement.
+ * The one documented difference: no retry queueing under file-descriptor
+ * exhaustion. */
+const NPM_BUILTIN_ALIASES = { "graceful-fs": "fs" };
+/** The builtin module an npm package specifier is served as, or null. */
+export function npmBuiltinAliasOf(spec) {
+    return Object.hasOwn(NPM_BUILTIN_ALIASES, spec) ? (NPM_BUILTIN_ALIASES[spec] ?? null) : null;
 }
 /** Both specifier spellings of every supported builtin (prefix-only ones
- * keep just the node: form) — the ambient-module allowlist preflight uses. */
-export const SUPPORTED_NODE_MODULES = SUPPORTED_BUILTIN_MODULES.flatMap((m) => PREFIX_ONLY_BUILTIN_MODULES.has(m) ? [`node:${m}`] : [m, `node:${m}`]);
+ * keep just the node: form) — the ambient-module allowlist preflight uses
+ * — plus the npm packages served as builtins. */
+export const SUPPORTED_NODE_MODULES = [
+    ...SUPPORTED_BUILTIN_MODULES.flatMap((m) => PREFIX_ONLY_BUILTIN_MODULES.has(m) ? [`node:${m}`] : [m, `node:${m}`]),
+    ...Object.keys(NPM_BUILTIN_ALIASES),
+];
 /* ── out-of-scope builtins ───────────────────────────────────────────────
  * Builtin modules a compiled binary is not going to serve — not "yet",
  * but by construction — each with the reason its SC1010 fence prints.
@@ -84,16 +107,20 @@ export const SUPPORTED_NODE_MODULES = SUPPORTED_BUILTIN_MODULES.flatMap((m) => P
  * so 'node:sqlite' keys as 'sqlite'. Exact-match only: an npm package
  * whose name collides with none of these keys keeps the generic wording.
  * Everything absent from this table stays the plain "not supported yet"
- * story — genuinely pending surface (console's Console class, stream/web)
- * must not read as permanently refused. */
+ * story — genuinely pending surface (console's Console class) must not
+ * read as permanently refused. */
 /** Node's own HTTP/TLS/stream implementation internals, requireable by
  * legacy convention (underscore-prefixed lib/ modules). They expose
  * Node-internal objects — parsers, wrap handles, the Agent's socket
  * pools — that only exist inside Node's own stack. */
 const NODE_INTERNAL_REASON = "a Node-internal module: it exposes Node's own implementation objects, which the scriptc runtime does not replicate";
-const V8_REASON = "it observes V8 engine internals — heap statistics and snapshots, GC and CPU profiles, serialize/deserialize — and a compiled binary embeds no V8 engine to observe";
+/** node:v8 is importable (packages require it at top level and touch it
+ * only on optional paths), and getHeapStatistics answers allocator-derived
+ * figures; every other member observes the engine itself. Member fences
+ * carry this reason instead of a module-level refusal. */
+export const V8_MEMBER_REASON = "by design: this member observes V8 engine internals — heap snapshots and spaces, GC and CPU profiles, flags, serialize/deserialize — and a compiled binary embeds no V8 engine to observe";
 const OUT_OF_SCOPE_BUILTIN_REASONS = {
-    v8: V8_REASON,
+    vm: "it compiles and runs JavaScript source at runtime, and a compiled binary embeds no JavaScript engine to run it",
     inspector: "it drives the V8 inspector protocol — debugger, profiler, heap access — and a compiled binary embeds no V8 engine to inspect",
     "inspector/promises": "it drives the V8 inspector protocol — debugger, profiler, heap access — and a compiled binary embeds no V8 engine to inspect",
     sqlite: "it wraps the SQLite library bundled into the node executable, and scriptc binaries bundle no SQLite engine",
@@ -124,4 +151,10 @@ export function unsupportedModuleFeatureOf(spec) {
         : undefined;
     return reason === undefined ? `the '${spec}' module` : `the '${spec}' module (${reason})`;
 }
+/** The ESNext temporal global's name. Node 24 does not define it: programs
+ * that name it type-check against TS 7's lib slice (program.ts adds it only
+ * for them) and lower to Node's answers. Spelled in two pieces so the
+ * compiler's own sources never trip program.ts's scan when scriptc
+ * compiles itself. */
+export const TEMPORAL_GLOBAL = "Tempo" + "ral";
 //# sourceMappingURL=builtin-modules.js.map

package/dist/frontend/builtin-modules.js.map

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

package/dist/frontend/builtin-package-aliases.d.ts

@@ -0,0 +1,24 @@
+export interface BuiltinAlias {
+    /** The expression the module's export evaluates to, or null when only
+     * its member reads have a builtin spelling. */
+    whole: string | null;
+    /** For an export that carries another object's members (readable-stream's
+     * entry): member reads of these names read `object`'s members. */
+    members?: {
+        object: string;
+        names: ReadonlySet<string>;
+    };
+}
+/** The builtin a package module is on Node 24, or null. `subpath` is the
+ * file inside the package ("" for its main entry). */
+export declare function builtinAliasOf(pkg: string, version: string, subpath: string): BuiltinAlias | null;
+/** Package names the table can alias (a cheap pre-filter). */
+export declare const BUILTIN_ALIAS_PACKAGES: ReadonlySet<string>;
+/** The package, version and in-package file a bundler's module key names
+ * when it carries a version (pnpm's `node_modules/.pnpm/<name>@<version>/
+ * node_modules/<name>/<file>`), or null. */
+export declare function versionedPackageOfKey(key: string): {
+    name: string;
+    version: string;
+    subpath: string;
+} | null;

package/dist/frontend/builtin-package-aliases.js

@@ -0,0 +1,133 @@
+/* Polyfill packages whose behavior on Node 24 IS a Node builtin. The
+ * package-shim registry (package-shims.ts) consults this table: a require
+ * of such a package, from an installed copy's importer or through a bundled
+ * __commonJS chunk whose path names the package, compiles as the builtin
+ * expression its module evaluates to on Node 24, at the require's position
+ * (loading a builtin runs no code, and none of these packages has an
+ * observable side effect at load).
+ *
+ * Each entry names the major versions whose entry modules were checked:
+ *
+ * - isarray 0.x, 1.x, 2.x: `module.exports = Array.isArray || function …`;
+ *   Node always has Array.isArray, so the export is Array.isArray itself.
+ * - safe-buffer 5.x: `module.exports = buffer` when Buffer.from, alloc,
+ *   allocUnsafe and allocUnsafeSlow exist (Node 6 and later); the rest of
+ *   the module only builds its unexported SafeBuffer fallback.
+ * - process-nextick-args 2.x: `module.exports = process` unless
+ *   process.version is v0.x or a pre-1.8 v1.x.
+ * - inherits 2.x: inherits.js exports require("util").inherits (2.0.1
+ *   directly, 2.0.3 and later whenever it is a function, always on Node).
+ * - util-deprecate 1.x: node.js (its Node entry) is
+ *   `module.exports = require("util").deprecate`.
+ * - readable-stream 2.x, 3.x, 4.x: a documented divergence. The package
+ *   ships a JavaScript copy of Node's streams; its READABLE_STREAM=disable
+ *   behavior hands out Node's own stream classes instead, and that is what
+ *   compiles:
+ *   - 2.x readable.js exports stream.Readable carrying Readable, Writable,
+ *     Duplex, Transform, PassThrough and Stream; writable.js exports
+ *     stream.Writable and duplex/transform/passthrough.js read the entry;
+ *   - 3.x (a copy of Node 10's streams) readable.js exports the same
+ *     members plus finished and pipeline. Its own disable branch throws on
+ *     Node 24 (it Object.assigns every stream export onto stream.Readable,
+ *     which inherits the getter-only `promises` accessor), so 3.x maps the
+ *     members its default branch exports onto the builtin's;
+ *   - 4.x lib/ours/index.js exports a plain object of named stream exports.
+ *   The lib/_stream_*.js implementation files map to the matching builtin
+ *   classes as well (Node itself loads the package's JavaScript
+ *   implementations through them, whatever the environment). Without the
+ *   variable Node runs the package's own JavaScript streams. */
+const STREAM_CLASSES = ["Readable", "Writable", "Duplex", "Transform", "PassThrough"];
+/** The members readable-stream 4.x's entry copies from `stream` under
+ * READABLE_STREAM=disable. */
+const RS4_ENTRY_EXPORTS = [
+    "_uint8ArrayToBuffer",
+    "_isUint8Array",
+    "isDisturbed",
+    "isErrored",
+    "isReadable",
+    ...STREAM_CLASSES,
+    "addAbortSignal",
+    "finished",
+    "destroy",
+    "pipeline",
+    "compose",
+    "Stream",
+];
+function majorOf(version) {
+    return Number(/^(\d+)\./.exec(version)?.[1] ?? Number.NaN);
+}
+function stripJs(subpath) {
+    return subpath.replace(/^\.\//, "").replace(/\.js$/, "");
+}
+/** The builtin a package module is on Node 24, or null. `subpath` is the
+ * file inside the package ("" for its main entry). */
+export function builtinAliasOf(pkg, version, subpath) {
+    const major = majorOf(version);
+    const file = stripJs(subpath);
+    switch (pkg) {
+        case "isarray":
+            return (major === 0 || major === 1 || major === 2) && (file === "" || file === "index")
+                ? { whole: "Array.isArray" }
+                : null;
+        case "safe-buffer":
+            return major === 5 && (file === "" || file === "index")
+                ? { whole: 'require("buffer")' }
+                : null;
+        case "process-nextick-args":
+            return major === 2 && (file === "" || file === "index") ? { whole: "process" } : null;
+        case "inherits":
+            return major === 2 && (file === "" || file === "inherits")
+                ? { whole: 'require("util").inherits' }
+                : null;
+        case "util-deprecate":
+            return major === 1 && (file === "" || file === "node")
+                ? { whole: 'require("util").deprecate' }
+                : null;
+        case "readable-stream": {
+            if (major !== 2 && major !== 3 && major !== 4)
+                return null;
+            const stream = 'require("stream")';
+            const entry = major === 4 ? file === "lib/ours/index" : file === "readable";
+            if (file === "" || entry) {
+                if (major === 4)
+                    return { whole: null, members: { object: stream, names: new Set(RS4_ENTRY_EXPORTS) } };
+                const names = new Set([
+                    ...STREAM_CLASSES,
+                    "Stream",
+                    ...(major === 3 ? ["finished", "pipeline"] : []),
+                ]);
+                return { whole: `${stream}.Readable`, members: { object: stream, names } };
+            }
+            for (const cls of STREAM_CLASSES) {
+                const lower = cls.toLowerCase();
+                if (file === `lib/_stream_${lower}` || (major === 2 && file === lower))
+                    return { whole: `${stream}.${cls}` };
+            }
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+/** Package names the table can alias (a cheap pre-filter). */
+export const BUILTIN_ALIAS_PACKAGES = new Set([
+    "isarray",
+    "safe-buffer",
+    "process-nextick-args",
+    "inherits",
+    "util-deprecate",
+    "readable-stream",
+]);
+/** The package, version and in-package file a bundler's module key names
+ * when it carries a version (pnpm's `node_modules/.pnpm/<name>@<version>/
+ * node_modules/<name>/<file>`), or null. */
+export function versionedPackageOfKey(key) {
+    const m = /(?:^|\/)node_modules\/\.pnpm\/((?:@[^/+]+\+)?[^/@]+)@([^/_]+)[^/]*\/node_modules\/((?:@[^/]+\/)?[^/]+)\/(.+)$/.exec(key);
+    if (m === null)
+        return null;
+    const [, storeName, version, name, subpath] = m;
+    if (storeName.replace("+", "/") !== name)
+        return null;
+    return { name: name, version: version, subpath: subpath };
+}
+//# sourceMappingURL=builtin-package-aliases.js.map

package/dist/frontend/builtin-package-aliases.js.map

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

package/dist/frontend/builtin-package-aliases.test.d.ts

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

package/dist/frontend/builtin-package-aliases.test.js

@@ -0,0 +1,48 @@
+import { expect, test } from "vitest";
+import { builtinAliasOf, versionedPackageOfKey } from "./builtin-package-aliases.js";
+test("aliases name the builtin each checked major's module is on Node 24", () => {
+    expect(builtinAliasOf("isarray", "1.0.0", "")).toEqual({ whole: "Array.isArray" });
+    expect(builtinAliasOf("isarray", "0.0.1", "index.js")).toEqual({ whole: "Array.isArray" });
+    expect(builtinAliasOf("isarray", "3.0.0", "")).toBeNull();
+    expect(builtinAliasOf("safe-buffer", "5.1.2", "")).toEqual({ whole: 'require("buffer")' });
+    expect(builtinAliasOf("process-nextick-args", "2.0.1", "")).toEqual({ whole: "process" });
+    expect(builtinAliasOf("process-nextick-args", "1.0.7", "")).toBeNull();
+    expect(builtinAliasOf("inherits", "2.0.4", "inherits.js")).toEqual({
+        whole: 'require("util").inherits',
+    });
+    // The browser file is the package's own implementation.
+    expect(builtinAliasOf("inherits", "2.0.4", "inherits_browser.js")).toBeNull();
+    expect(builtinAliasOf("util-deprecate", "1.0.2", "node.js")).toEqual({
+        whole: 'require("util").deprecate',
+    });
+    expect(builtinAliasOf("util-deprecate", "1.0.2", "browser.js")).toBeNull();
+});
+test("readable-stream aliases follow each major's layout", () => {
+    const rs2 = builtinAliasOf("readable-stream", "2.3.8", "readable.js");
+    expect(rs2?.whole).toBe('require("stream").Readable');
+    expect([...(rs2?.members?.names ?? [])].sort()).toEqual(["Duplex", "PassThrough", "Readable", "Stream", "Transform", "Writable"].sort());
+    expect(builtinAliasOf("readable-stream", "2.3.8", "writable.js")?.whole).toBe('require("stream").Writable');
+    expect(builtinAliasOf("readable-stream", "2.3.8", "lib/_stream_duplex.js")?.whole).toBe('require("stream").Duplex');
+    expect(builtinAliasOf("readable-stream", "2.3.8", "lib/internal/streams/destroy.js")).toBeNull();
+    // 3.x has no root writable.js; its entry also carries finished and pipeline.
+    const rs3 = builtinAliasOf("readable-stream", "3.6.2", "");
+    expect(rs3?.whole).toBe('require("stream").Readable');
+    expect([...(rs3?.members?.names ?? [])]).toContain("pipeline");
+    expect(builtinAliasOf("readable-stream", "3.6.2", "lib/_stream_writable.js")?.whole).toBe('require("stream").Writable');
+    expect(builtinAliasOf("readable-stream", "3.6.2", "writable.js")).toBeNull();
+    expect(builtinAliasOf("readable-stream", "3.6.2", "lib/internal/streams/pipeline.js")).toBeNull();
+    const rs4 = builtinAliasOf("readable-stream", "4.7.0", "lib/ours/index.js");
+    expect(rs4?.whole).toBeNull();
+    expect(rs4?.members?.names.has("pipeline")).toBe(true);
+    expect(rs4?.members?.names.has("promises")).toBe(false);
+    expect(builtinAliasOf("readable-stream", "4.7.0", "transform.js")).toBeNull();
+    expect(builtinAliasOf("readable-stream", "4.7.0", "lib/_stream_transform.js")?.whole).toBe('require("stream").Transform');
+});
+test("pnpm module keys name the package, version and file", () => {
+    expect(versionedPackageOfKey("../node_modules/.pnpm/isarray@1.0.0/node_modules/isarray/index.js")).toEqual({ name: "isarray", version: "1.0.0", subpath: "index.js" });
+    expect(versionedPackageOfKey("node_modules/.pnpm/@scope+pkg@2.1.0_peer@1.0.0/node_modules/@scope/pkg/lib/a.js")).toEqual({ name: "@scope/pkg", version: "2.1.0", subpath: "lib/a.js" });
+    // A store entry's own dependency links name other packages.
+    expect(versionedPackageOfKey("node_modules/.pnpm/from2@2.3.0/node_modules/readable-stream/readable.js")).toBeNull();
+    expect(versionedPackageOfKey("node_modules/isarray/index.js")).toBeNull();
+});
+//# sourceMappingURL=builtin-package-aliases.test.js.map

package/dist/frontend/builtin-package-aliases.test.js.map

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