@scriptc/compiler 0.4.1 → 0.4.3

package/dist/frontend/lowering/expressions/relational.js

@@ -1,4 +1,6 @@
 /* instanceof and in, including private-name and runtime-key in. */
+import { dateRootOf } from "../builtins/date-classes.js";
+import { keyedHelperName } from "../stable-names.js";
 import * as ts from "../../ts7/adapter.js";
 import { builtinClassInstanceOfAny, builtinClassKind } from "../builtins/builtin-class-dyn.js";
 import { checkedPrivateIn, localPrivateBrandClass, primitiveOperand, privateInMessage, } from "../private-brands.js";
@@ -24,12 +26,45 @@ import { InternalCompilerError } from "../../../errors.js";
 import { tryLowerExpression } from "./try-lower-expression.js";
 import { isJsSourceFile, locOf } from "../../program.js";
 import { checkedClassInstanceOf } from "../class-construction.js";
+import { unsupportedDiag } from "../../../diagnostics/diagnostic.js";
 import { globalSymbolKey } from "./global-symbols.js";
+import { builtinGlobalHasKey } from "../builtins/global-namespace-keys.js";
 import { foldedStringKeyOf } from "./object-literals.js";
 import { NARROW_FIRST, sideEffectFreeOptionValue } from "../surfaces.js";
 import { isExecExceptionType, refuseExecExceptionCode } from "../builtins/errors.js";
 import { hasRuntimeStatics } from "../class-runtime-statics.js";
 import { nullProtoRecordShape, recordNullProtoTest } from "../null-prototype.js";
+/** The class value an `instanceof` right-hand side holds. A JavaScript
+ * object's property holding a program class (`holder.type`) reads as a
+ * checked-dynamic value that the checker types as the class: it converts
+ * to the class value. Runtime-provided classes keep their own lowering. */
+function classValueOperand(lowerer, right, type) {
+    if (!isJsSourceFile(ts.getSourceFileOfNode(right)) ||
+        ts.isIdentifier(right) ||
+        lowerer.classes.get(type.className)?.def.runtime)
+        return lowerer.lowerExpr(right);
+    const value = lowerer.lowerExprExpecting(right, DYN);
+    if (value.type.kind !== "dyn")
+        return value;
+    return { kind: "dynCheck", value, type, loc: locOf(right) };
+}
+/** The value kinds that never hold an instance of a program class. */
+const NO_CLASS_INSTANCE_KINDS = new Set([
+    "f64",
+    "bigint",
+    "date",
+    "string",
+    "bool",
+    "array",
+    "map",
+    "set",
+    "regex",
+    "bytes",
+    "symbol",
+    "promise",
+    "undefinedT",
+    "nullT",
+]);
 /** `x instanceof C` for a program-declared class C. When x's static
  * class and C are both in extends-hierarchies the test is dynamic — the
  * O(1) preorder-interval check against the vtable (`instanceOf` node).
@@ -122,6 +157,10 @@ export function lowerInstanceOf(lowerer, expr, loc) {
             loc,
         };
     }
+    if (lowerer.isStdlibGlobal(expr.right, "FinalizationRegistry")) {
+        const value = lowerer.coerceInto(expr.left, lowerer.lowerExpr(expr.left), DYN);
+        return { kind: "libCall", fn: "finalizationRegistry.is", args: [value], type: BOOL, loc };
+    }
     const rhsBuiltin = ts.isIdentifier(expr.right)
         ? lowerer.builtinImportOf(expr.right)
         : ts.isPropertyAccessExpression(expr.right)
@@ -246,7 +285,11 @@ export function lowerInstanceOf(lowerer, expr, loc) {
                 stmts: [{ kind: "exprStmt", expr: value, loc }],
                 result: {
                     kind: "boolLit",
-                    value: value.type.kind === (date ? "date" : "url"),
+                    value: value.type.kind === (date ? "date" : "url") ||
+                        // An instance of a class declared `extends Date`.
+                        (date &&
+                            value.type.kind === "object" &&
+                            dateRootOf(lowerer.classes.get(value.type.className)) !== null),
                     type: BOOL,
                     loc,
                 },
@@ -266,6 +309,20 @@ export function lowerInstanceOf(lowerer, expr, loc) {
                 type: BOOL,
                 loc,
             };
+        // A codec in untyped storage is its record's handle box.
+        const codec = ["TextEncoder", "TextDecoder"].find((name) => lowerer.isStdlibGlobal(expr.right, name));
+        if (codec && lowerer.mapTypeOf(lowerer.typeOf(expr.left))?.kind === "dyn") {
+            return {
+                kind: "libCall",
+                fn: "text.codecIs",
+                args: [
+                    lowerer.lowerExprExpecting(expr.left, DYN),
+                    { kind: "boolLit", value: codec === "TextDecoder", type: BOOL, loc },
+                ],
+                type: BOOL,
+                loc,
+            };
+        }
         if (lowerer.isStdlibGlobal(expr.right, "ReadableStream")) {
             const value = lowerer.lowerExprExpecting(expr.left, DYN);
             return { kind: "libCall", fn: "fetch.streamIs", args: [value], type: BOOL, loc };
@@ -358,7 +415,57 @@ export function lowerInstanceOf(lowerer, expr, loc) {
         // (itself — no descendants can flow into the slot), so the answer
         // folds statically exactly like the named-target folds below.
         const rhsClassval = storedClassValueType(lowerer, expr.right);
-        if (rhsClassval?.kind === "classval" && !lowerer.caughtLocalOf(expr.left)) {
+        // A catch binding against a class held by a binding (`var E = class
+        // extends Error {}`). The binding holds the declared class or one of its
+        // subclasses. Without subclasses the test is the class's caught test,
+        // after the right operand's read; otherwise a payload of the declared
+        // class is tested against the class the binding holds.
+        const caught = lowerer.caughtLocalOf(expr.left);
+        const caughtTarget = rhsClassval?.kind === "classval" && caught
+            ? lowerer.classes.get(rhsClassval.className)
+            : undefined;
+        if (caught && caughtTarget && !caughtTarget.localClass && !caughtTarget.def.runtime) {
+            const classValue = lowerer.lowerExpr(expr.right);
+            if (caughtTarget.subclasses.length === 0) {
+                return {
+                    kind: "seqExpr",
+                    stmts: [{ kind: "exprStmt", expr: classValue, loc }],
+                    result: caughtClassInstanceOf(lowerer, caught.id, caughtTarget, loc),
+                    type: BOOL,
+                    loc,
+                };
+            }
+            if (classValue.type.kind !== "classval")
+                lowerer.badType(expr.right, lowerer.typeOf(expr.right));
+            const held = lowerer.declareHiddenLocal("%instanceofClass", classValue.type);
+            const instance = { kind: "object", className: caughtTarget.def.name };
+            return {
+                kind: "seqExpr",
+                stmts: [{ kind: "varDecl", localId: held.id, init: classValue, loc }],
+                result: {
+                    kind: "logical",
+                    op: "&&",
+                    left: caughtClassInstanceOf(lowerer, caught.id, caughtTarget, loc),
+                    right: {
+                        kind: "instanceOfValue",
+                        value: {
+                            kind: "caughtNarrow",
+                            value: varRef(caught.id, CAUGHT, loc),
+                            type: instance,
+                            loc,
+                        },
+                        classValue: varRef(held.id, classValue.type, loc),
+                        type: BOOL,
+                        loc,
+                    },
+                    type: BOOL,
+                    loc,
+                },
+                type: BOOL,
+                loc,
+            };
+        }
+        if (rhsClassval?.kind === "classval" && !caught) {
             const targetInfo = lowerer.classes.get(rhsClassval.className);
             if (!targetInfo) {
                 // The type world names a class the lowering never registered
@@ -382,7 +489,7 @@ export function lowerInstanceOf(lowerer, expr, loc) {
                 if (targetInfo.def.runtime) {
                     lowerer.unsupported("SC1090", expr, "'instanceof' through a runtime-provided class value on an untyped value (give the operand a class type first)");
                 }
-                const classValue = lowerer.lowerExpr(expr.right);
+                const classValue = classValueOperand(lowerer, expr.right, rhsClassval);
                 return classInstanceOf(lowerer, left, targetInfo, loc, classValue);
             }
             // A union of class instances against a runtime class value (`new K()`
@@ -392,6 +499,22 @@ export function lowerInstanceOf(lowerer, expr, loc) {
                 if (tested)
                     return tested;
             }
+            // A value whose type holds no class instance (a primitive, a native
+            // collection, a date, a regex, an array) is never an instance
+            // of a program class: false, after both operands evaluate.
+            if (!targetInfo.def.runtime && NO_CLASS_INSTANCE_KINDS.has(left.type.kind)) {
+                const classValue = classValueOperand(lowerer, expr.right, rhsClassval);
+                return {
+                    kind: "seqExpr",
+                    stmts: [
+                        { kind: "exprStmt", expr: left, loc },
+                        { kind: "exprStmt", expr: classValue, loc },
+                    ],
+                    result: { kind: "boolLit", value: false, type: BOOL, loc },
+                    type: BOOL,
+                    loc,
+                };
+            }
             if (left.type.kind !== "object") {
                 lowerer.unsupported("SC1090", expr, "'instanceof' on values other than class instances (narrow union-typed values first)");
             }
@@ -400,7 +523,7 @@ export function lowerInstanceOf(lowerer, expr, loc) {
                 throw new InternalCompilerError(`lowerer bug: unknown class ${left.type.className}`);
             if ((lowerer.inHierarchy(targetInfo) && lowerer.inHierarchy(lhsInfo)) ||
                 (targetInfo.localClass !== undefined && lhsInfo.localClass !== undefined)) {
-                const classValue = lowerer.lowerExpr(expr.right);
+                const classValue = classValueOperand(lowerer, expr.right, rhsClassval);
                 if (classValue.type.kind !== "classval")
                     lowerer.badType(expr.right, lowerer.typeOf(expr.right));
                 const writableTest = writableClassValueTest(lowerer, left, classValue, targetInfo, lhsInfo, loc);
@@ -425,10 +548,13 @@ export function lowerInstanceOf(lowerer, expr, loc) {
             }
             lowerer.unsupported("SC1090", expr, "statically-decided 'instanceof' on computed operands (bind the values to variables first)");
         }
+        // A checked-dynamic right-hand side (a constructor read from a table, a
+        // structural constructor type, a builtin constructor held as `any`):
+        // the runtime's instanceof over the value, in both source languages.
         const constructor = tryLowerExpression(lowerer, expr.right);
-        if (constructor?.type.kind === "dyn" && isJsSourceFile(ts.getSourceFileOfNode(expr))) {
+        if (constructor?.type.kind === "dyn") {
             const value = lowerer.coerceInto(expr.left, lowerer.lowerExpr(expr.left), DYN);
-            return checkedClassInstanceOf(lowerer, value, constructor, loc);
+            return checkedClassInstanceOf(lowerer, value, constructor, dynInstanceOfRefusal(lowerer, expr), loc);
         }
         // `this instanceof Glob` in a JavaScript constructor function: the
         // function's prototype against the value's prototype chain.
@@ -470,35 +596,34 @@ export function lowerInstanceOf(lowerer, expr, loc) {
     // narrowing then types the branches; reads bridge through caughtRead.
     const caughtLocal = lowerer.caughtLocalOf(expr.left);
     if (caughtLocal) {
-        const caughtInstanceOf = (info) => {
-            if (!lowerer.inHierarchy(info)) {
-                const value = varRef(caughtLocal.id, CAUGHT, loc);
-                return {
-                    kind: "ternary",
-                    cond: {
-                        kind: "caughtTest",
-                        value,
-                        test: "instanceof",
-                        className: info.def.name,
+        const caughtInstanceOf = (info) => caughtClassInstanceOf(lowerer, caughtLocal.id, info, loc);
+        let test = caughtInstanceOf(target);
+        // A thrown checked-dynamic object whose prototype chain reaches
+        // Error.prototype (an ES5 constructor function inheriting from it).
+        if (target.def.name === "%Error" && lowerer.errorPrototypeValues) {
+            const value = varRef(caughtLocal.id, CAUGHT, loc);
+            test = {
+                kind: "logical",
+                op: "||",
+                left: test,
+                right: {
+                    kind: "logical",
+                    op: "&&",
+                    left: { kind: "caughtTest", value, test: "dynamic", type: BOOL, loc },
+                    right: {
+                        kind: "libCall",
+                        fn: "dyn.inheritsErrorPrototype",
+                        args: [{ kind: "caughtToDyn", value, type: DYN, loc }],
                         type: BOOL,
                         loc,
                     },
-                    then: { kind: "boolLit", value: true, type: BOOL, loc },
-                    else_: classInstanceOf(lowerer, { kind: "caughtToDyn", value, type: DYN, loc }, info, loc),
                     type: BOOL,
                     loc,
-                };
-            }
-            return {
-                kind: "caughtTest",
-                value: { kind: "varRef", localId: caughtLocal.id, type: CAUGHT, loc },
-                test: "instanceof",
-                className: info.def.name,
+                },
                 type: BOOL,
                 loc,
             };
-        };
-        const test = caughtInstanceOf(target);
+        }
         return duplex
             ? { kind: "logical", op: "||", left: test, right: caughtInstanceOf(duplex), type: BOOL, loc }
             : test;
@@ -521,9 +646,35 @@ export function lowerInstanceOf(lowerer, expr, loc) {
         !target.localClass) {
         return classInstanceOf(lowerer, left, target, loc);
     }
-    if (left.type.kind === "dyn" && target.def.name === "%Error") {
+    if (left.type.kind === "dyn" && target.def.name === "%Error" && !lowerer.errorPrototypeValues) {
         return { kind: "dynTest", test: "error", value: left, type: BOOL, loc };
     }
+    // An object whose prototype chain reaches Error.prototype (an ES5
+    // constructor function inheriting from it) is an instance as well.
+    if (left.type.kind === "dyn" && target.def.name === "%Error") {
+        const local = lowerer.declareHiddenLocal("%instanceofValue", DYN);
+        const value = varRef(local.id, DYN, loc);
+        return {
+            kind: "seqExpr",
+            stmts: [{ kind: "varDecl", localId: local.id, init: left, loc }],
+            result: {
+                kind: "logical",
+                op: "||",
+                left: { kind: "dynTest", test: "error", value, type: BOOL, loc },
+                right: {
+                    kind: "libCall",
+                    fn: "dyn.inheritsErrorPrototype",
+                    args: [value],
+                    type: BOOL,
+                    loc,
+                },
+                type: BOOL,
+                loc,
+            },
+            type: BOOL,
+            loc,
+        };
+    }
     // `u instanceof TypeError` (and the other BUILTIN error classes) on a
     // dyn value: the from_error cache holds the checked-dynamic tree↔error identity edge,
     // so the runtime resolves the encoding back to its error and asks the
@@ -569,7 +720,7 @@ export function lowerInstanceOf(lowerer, expr, loc) {
             const key = `instanceof.union:${unionId}:${target.def.name}`;
             let helper = lowerer.valueHelpers.get(key);
             if (!helper) {
-                helper = `%instanceof.union.${lowerer.valueHelpers.size}`;
+                helper = keyedHelperName(lowerer, "%instanceof.union", key);
                 lowerer.valueHelpers.set(key, helper);
                 const value = { kind: "varRef", localId: "value.0", type: left.type, loc };
                 const body = [];
@@ -796,6 +947,36 @@ function writableClassValueTest(lowerer, left, classValue, targetInfo, lhsInfo,
         loc,
     };
 }
+/** A catch binding tested against a program class: the runtime test against
+ * the class's preorder interval (false for non-hierarchy-object payloads). */
+function caughtClassInstanceOf(lowerer, caughtId, info, loc) {
+    if (!lowerer.inHierarchy(info)) {
+        const value = varRef(caughtId, CAUGHT, loc);
+        return {
+            kind: "ternary",
+            cond: {
+                kind: "caughtTest",
+                value,
+                test: "instanceof",
+                className: info.def.name,
+                type: BOOL,
+                loc,
+            },
+            then: { kind: "boolLit", value: true, type: BOOL, loc },
+            else_: classInstanceOf(lowerer, { kind: "caughtToDyn", value, type: DYN, loc }, info, loc),
+            type: BOOL,
+            loc,
+        };
+    }
+    return {
+        kind: "caughtTest",
+        value: { kind: "varRef", localId: caughtId, type: CAUGHT, loc },
+        test: "instanceof",
+        className: info.def.name,
+        type: BOOL,
+        loc,
+    };
+}
 /** A statically decided `instanceof` still reads its class after the left
  * operand: a class with an initialization flag throws there before its
  * declaration ran. */
@@ -1196,6 +1377,18 @@ export function lowerInExpression(lowerer, expr, loc) {
         }
         lowerer.unsupported("SC1090", expr.left, "'in' with computed (non-literal) keys (a const whose type is one string literal folds; a string-typed key answers over index-signature record receivers)");
     }
+    // A feature probe on a builtin constructor global (`"captureStackTrace"
+    // in Error`): the global is a fixed object, so the answer is static.
+    {
+        let recvNode = expr.right;
+        while (ts.isParenthesizedExpression(recvNode))
+            recvNode = recvNode.expression;
+        if (ts.isIdentifier(recvNode) && lowerer.isStdlibGlobal(recvNode, recvNode.text)) {
+            const has = builtinGlobalHasKey(recvNode.text, key);
+            if (has !== null)
+                return { kind: "boolLit", value: has, type: BOOL, loc };
+        }
+    }
     // A receiver re-read (the static folds below) is safe for plain reads
     // AND for side-effect-free expressions (an object literal of literals
     // — the `"a" in { a: true }` shape).
@@ -1258,6 +1451,32 @@ export function lowerInExpression(lowerer, expr, loc) {
         if (helper)
             recv = { kind: "call", callee: helper, args: [recv], type: siteType, loc };
     }
+    // A builtin class held as a brand record (TextEncoder, TextDecoder: only
+    // `%`-prefixed internal fields): its members are the class's prototype
+    // members, which the standard library declares, so `"encodeInto" in
+    // encoder` answers from the checker's type, plus Object.prototype's keys.
+    // The receiver evaluates for its effects.
+    if (recv.type.kind === "record") {
+        const shape = lowerer.shapes.get(recv.type.shapeId);
+        if (shape && shape.fields.length > 0 && shape.fields.every((f) => f.name.startsWith("%"))) {
+            const declared = lowerer.checker.getPropertyOfType(lowerer.typeOf(expr.right), key) !== undefined;
+            const answer = {
+                kind: "boolLit",
+                value: declared || OBJECT_PROTOTYPE_KEYS.has(key),
+                type: BOOL,
+                loc,
+            };
+            if (recv.kind === "varRef")
+                return answer;
+            return {
+                kind: "seqExpr",
+                stmts: [{ kind: "exprStmt", expr: recv, loc }],
+                result: answer,
+                type: BOOL,
+                loc,
+            };
+        }
+    }
     // Error-rooted receivers (builtin or user subclass — the isErrnoException
     // predicate's `err instanceof Error && "code" in err` shape): `code`
     // answers from the runtime error's code slot (stamped by fs/system/
@@ -1630,7 +1849,7 @@ function lowerRuntimeKeyIn(lowerer, expr, loc) {
     const hkey = `haskey:${recvT.shapeId}`;
     let helper = lowerer.valueHelpers.get(hkey);
     if (!helper) {
-        helper = `%rec.haskey.${lowerer.valueHelpers.size}`;
+        helper = keyedHelperName(lowerer, "%rec.haskey", hkey);
         lowerer.valueHelpers.set(hkey, helper);
         const recT = { kind: "record", shapeId: recvT.shapeId };
         const k = varRef("k.0", STRING, loc);
@@ -1721,4 +1940,22 @@ function lowerRuntimeKeyIn(lowerer, expr, loc) {
     }
     return { kind: "call", callee: helper, args: [keyIr, recv], type: BOOL, loc };
 }
+/** Standard-library constructors the untyped instanceof helper has no
+ * instance test for: an untyped `x instanceof Object` always refuses. */
+const DYN_INSTANCEOF_REFUSED = new Set(["Object", "Function"]);
+/** The SC1090 message `x instanceof C` throws, with the site's position,
+ * when `C` is a runtime constructor with no instance test. A right-hand
+ * side that names one of DYN_INSTANCEOF_REFUSED always reaches that
+ * refusal, so the site is listed with the runtime fences. */
+function dynInstanceOfRefusal(lowerer, expr) {
+    const diag = unsupportedDiag("SC1090", locOf(expr), "instanceof against this native constructor");
+    const symbol = lowerer.checker.getSymbolAtLocation(expr.right);
+    if (symbol !== undefined &&
+        lowerer.isStdlibSymbol(symbol) &&
+        DYN_INSTANCEOF_REFUSED.has(ts.symbolName(symbol)))
+        lowerer.runtimeFences.push(diag);
+    const sf = ts.getSourceFileOfNode(expr);
+    const line = ts.getLineAndCharacterOfPosition(sf, diag.loc.start).line + 1;
+    return `${diag.message} [${diag.code} at ${diag.loc.file}:${line}]`;
+}
 //# sourceMappingURL=relational.js.map