@scriptc/compiler 0.4.0 → 0.4.2

package/dist/frontend/lowering/lower-classes.js

@@ -1,9 +1,13 @@
+import { DATE_TIME_FIELD, dateRootOf, dateSuperCall, isDatePrototypeMethod, lowerDateSuperMethodCall, } from "./builtins/date-classes.js";
+import { lowerDateStaticCall } from "./builtins/dates.js";
+import { keyedHelperName } from "./stable-names.js";
 import { lowerValueReturningConstructorNew } from "./js-dynamic-objects.js";
 import { adaptPromiseExecutor } from "./promise-executor-adapter.js";
 import { dynUndefinedExpr, nodeThrowExpr, varRef } from "../../ir/build.js";
 import { constructedFromValue, constructedValue, superIntoResultSlot, } from "./constructor-returns.js";
 import { checkedIterableSpread } from "./checked-iterable-spread.js";
 import { lowerReadlineUiNew } from "./builtins/readline.js";
+import { builtinMemberRequireDecl } from "./builtins/module-bindings.js";
 import { checkedClassUnionAssertion } from "./class-assertions.js";
 import { collectClassMethodMutations } from "./class-method-mutations.js";
 import { InternalCompilerError } from "../../errors.js";
@@ -28,14 +32,15 @@ import { bodyReadsArguments } from "../arguments-usage.js";
 import { errorNameAfterField, errorViewFields } from "./error-name-order.js";
 import { checkedJsDocumentedParameter, documentedParameter, generatorMeta, } from "./call-signatures.js";
 import { omittedArgFor } from "./call-arguments.js";
-import { isGenericCallableMemberType, jsOpenObjectType, typeKey, withUnitArm, } from "../type-mapper.js";
-import { cjsClassExprWholeExportOf, isCjsJsFile, isJsSourceFile, isModuleExportsAccess, locOf, } from "../program.js";
+import { checkerTypeDescription, isGenericCallableMemberType, jsOpenObjectType, typeKey, withUnitArm, } from "../type-mapper.js";
+import { canonicalBuiltinModule, cjsClassExprWholeExportOf, isCjsJsFile, isJsSourceFile, isModuleExportsAccess, locOf, requireSpecOf, } from "../program.js";
 import { PoisonError, dynFallbackType, jsFuncNameOf, newFnCtx, own } from "./lowerer.js";
 import { isAssertClassNew } from "./assert-instances.js";
+import { isCjsRequireGlobal } from "./lower-node-module.js";
 import { lowerArrayConstructor } from "./containers/array-construction.js";
 import { lowerMapSeedNew, lowerSetSeedNew } from "./containers/collection-methods.js";
 import { lowerObjectConstructor } from "./containers/indexed-objects.js";
-import { knownBufEncoding } from "./containers/bytes.js";
+import { knownBufEncoding, lowerNodeModulesBufferConstruct } from "./containers/bytes.js";
 import { isSafeToRepeat } from "./expressions/evaluation-safety.js";
 import { lowerSearchParamsNew } from "./builtins/url.js";
 import { lowerTextCodecNew } from "./builtins/text-codecs.js";
@@ -46,7 +51,7 @@ import { builtinEventTargetBaseOf, eventTargetApiMembers, eventTargetApiMethod,
 import { emitOverrideShapeReason, emitSpecSuperForward, emitterRooted, lowerEmitterSuperCall, } from "./lower-event-emitter.js";
 import { declSymbolOf } from "./lower-modules.js";
 import { classSymbolKeyOf, classSymbolKeyOfSymbol, symbolFieldDisplayName, } from "./symbol-fields.js";
-import { lowerHttpAgentNew, lowerHttpServerNew } from "./lower-server.js";
+import { lowerHttpAgentNew, lowerHttpServerNew, lowerTlsSocketNew } from "./lower-server.js";
 import { ambientNsRootOf, ambientUndefReadType, ambientUndefVarRootOf, ambientUndefinedFnSymbolOf, contextualUndefReadType, fenceEarlyAliasUse, fenceEarlyNsMemberRef, nsMemberIdentOf, nsUndefRead, } from "./lower-namespaces.js";
 import { mixinResultBindingClassOf } from "./lower-mixins.js";
 import { hasLexicalPrivateReference, hasStaticThis, rejectStaticThis } from "./static-this.js";
@@ -491,8 +496,10 @@ export function registerBuiltinErrorClasses(lowerer) {
             throwingSetters: [],
             staticFields: [],
         };
-        if (base)
+        if (base) {
             base.subclasses.push(info);
+            lowerer.subclassLinks++;
+        }
         lowerer.classes.set(irName, info);
     }
 }
@@ -526,6 +533,22 @@ export function registerBuiltinEmitterClass(lowerer) {
     };
     lowerer.classes.set(RUNTIME_EMITTER_CLASS, info);
 }
+/** `class Bus extends require("events") {}` in a CommonJS module: the
+ * events module is the EventEmitter class itself, so the base is the
+ * runtime emitter, exactly as through a `require("events")` binding. */
+export function builtinRequireBaseOf(lowerer, node) {
+    let expr = node;
+    while (ts.isParenthesizedExpression(expr))
+        expr = expr.expression;
+    if (!ts.isCallExpression(expr) || !isJsSourceFile(expr.getSourceFile()))
+        return null;
+    const spec = requireSpecOf(expr);
+    if (spec === null || canonicalBuiltinModule(spec) !== "events")
+        return null;
+    if (!isCjsRequireGlobal(lowerer, expr.expression))
+        return null;
+    return lowerer.classes.get(RUNTIME_EMITTER_CLASS) ?? null;
+}
 /** The runtime-provided node:stream classes as eagerly-registered
  * ClassInfos (the emitter story): mapType names `%Readable` et al the
  * moment a stream type appears, so the infos must exist before any
@@ -557,8 +580,10 @@ export function registerBuiltinStreamClasses(lowerer) {
             throwingSetters: [],
             staticFields: [],
         };
-        if (base)
+        if (base) {
             base.subclasses.push(info);
+            lowerer.subclassLinks++;
+        }
         lowerer.classes.set(irName, info);
     }
 }
@@ -583,10 +608,15 @@ export function builtinStreamInfoOf(lowerer, symbol) {
         // member to the stdlib class symbol. The declaration itself is
         // alias plumbing (streamClassAliasDecl — both declaration walks
         // skip it).
+        // A `var`/`let` binding of the inline require member
+        // (`var Transform = require("stream").Transform`) is the same alias
+        // plumbing as builtinMemberRequireDecl's: its declaration owns no
+        // storage either way.
         const decl = symbol.valueDeclaration;
         if (decl &&
             ts.isVariableDeclaration(decl) &&
-            (ts.getCombinedNodeFlags(decl) & ts.NodeFlags.Const) !== 0 &&
+            ((ts.getCombinedNodeFlags(decl) & ts.NodeFlags.Const) !== 0 ||
+                builtinMemberRequireDecl(decl.name, decl.initializer)) &&
             decl.initializer !== undefined &&
             ts.isPropertyAccessExpression(decl.initializer) &&
             !decl.initializer.questionDotToken &&
@@ -891,7 +921,8 @@ export function builtinEmitterInfoOf(lowerer, symbol) {
         const decl = symbol.valueDeclaration;
         if (decl !== undefined &&
             ts.isVariableDeclaration(decl) &&
-            (ts.getCombinedNodeFlags(decl) & ts.NodeFlags.Const) !== 0 &&
+            ((ts.getCombinedNodeFlags(decl) & ts.NodeFlags.Const) !== 0 ||
+                builtinMemberRequireDecl(decl.name, decl.initializer)) &&
             decl.initializer !== undefined &&
             ts.isPropertyAccessExpression(decl.initializer) &&
             !decl.initializer.questionDotToken &&
@@ -1334,6 +1365,7 @@ mixin) {
                 : (computedBase?.classInfo ?? null);
         let genericBase;
         let callableBase;
+        let extendsDate = false;
         let factoryBaseExpression;
         const adoptCallableBase = (expression) => {
             if (familyMode || inst || mixin)
@@ -1491,6 +1523,11 @@ mixin) {
             // callee is NOT a mixin function keeps the computed-expression
             // fence below.
             if (t && ts.isCallExpression(t.expression) && !t.typeArguments?.nodes) {
+                const requiredBase = builtinRequireBaseOf(lowerer, t.expression);
+                if (requiredBase) {
+                    base = requiredBase;
+                    continue;
+                }
                 const mixinBase = lowerer.mixinCallClassInfoOf(t.expression);
                 if (mixinBase) {
                     base = mixinBase;
@@ -1509,6 +1546,12 @@ mixin) {
                     continue;
                 lowerer.unsupported("SC1090", clause, "extending computed expressions");
             }
+            if (!familyMode && !inst && !mixin && lowerer.isStdlibGlobal(t.expression, "Date")) {
+                if (t.typeArguments?.nodes)
+                    lowerer.unsupported("SC1090", t, "extending generic classes");
+                extendsDate = true;
+                continue;
+            }
             const symbol = lowerer.resolveValueSymbol(t.expression);
             // Extending a REBINDABLE decorated class (analysis already ran —
             // this collection is a class expression or a generic
@@ -1709,7 +1752,8 @@ mixin) {
         };
         for (const member of decl.members.nodes) {
             if ((functionLocalClass(decl) || checkedStatics) &&
-                isJsSourceFile(ts.getSourceFileOfNode(decl)) &&
+                (isJsSourceFile(ts.getSourceFileOfNode(decl)) ||
+                    (functionLocalClass(decl) && ts.isMethodDeclaration(member))) &&
                 (ts.isClassStaticBlockDeclaration(member) ||
                     ts
                         .getModifiers(member)
@@ -3365,7 +3409,8 @@ mixin) {
         // synthesized constructor forwards the same params to super).
         const ctorParams = ctor && !mixinForwarding
             ? lowerer.paramShapes(ctor.parameters.nodes)
-            : (base?.ctorParams ?? (callableBase ? [{ type: DYN, mode: "dynRest" }] : []));
+            : (base?.ctorParams ??
+                (callableBase || extendsDate ? [{ type: DYN, mode: "dynRest" }] : []));
         if (ctor &&
             !mixinForwarding &&
             isJsSourceFile(ts.getSourceFileOfNode(ctor)) &&
@@ -3392,6 +3437,7 @@ mixin) {
                 // Redeclared INHERITED fields contribute no slot (their
                 // initializers assign the prefix slot).
                 fields: [
+                    ...(extendsDate ? [{ name: DATE_TIME_FIELD, type: DATE_T }] : []),
                     ...(base?.def.fields ?? []),
                     ...fieldOrder
                         .filter((f) => f.redeclared !== true)
@@ -3423,6 +3469,7 @@ mixin) {
             base,
             ...(genericBase ? { genericBase } : {}),
             ...(callableBase ? { callableBase } : {}),
+            ...(extendsDate ? { extendsDate: true } : {}),
             ...(factoryBaseExpression ? { factoryBaseExpression } : {}),
             subclasses: [],
             throwingSetters,
@@ -3463,6 +3510,7 @@ mixin) {
                 path: inst.path,
                 family: inst.family,
                 bindings: inst.bindings,
+                tsBindings: inst.tsBindings,
                 typeArgsText: inst.typeArgsText,
                 ordinal: inst.ordinal,
             };
@@ -3493,8 +3541,10 @@ mixin) {
             };
             lowerer.genericClassByDecl.set(decl, info.generic);
         }
-        if (base)
+        if (base) {
             base.subclasses.push(info);
+            lowerer.subclassLinks++;
+        }
         lowerer.classes.set(className, info);
         if (computedBase && !functionLocalClass(decl)) {
             info.def.baseValueGlobal = `%g.${className}.computedBase`;
@@ -3596,8 +3646,10 @@ export function genericClassInstanceType(lowerer, decl, ref, mapArgument) {
         .getTypeArguments(ref)
         .slice(0, gci.typeParams.length);
     const mapped = [];
+    const tsArgs = [];
     if (args.length === gci.typeParams.length) {
         for (const a of args) {
+            tsArgs.push(lowerer.typeParamTsResolver(a) ?? a);
             const m = lowerer.mapTypeOf(a, mapArgument);
             if (!m || m.kind === "void") {
                 // An UNBOUND type parameter argument (`Box<T>` outside any
@@ -3618,9 +3670,34 @@ export function genericClassInstanceType(lowerer, decl, ref, mapArgument) {
             if (!b)
                 return null;
             mapped.push(b);
-        }
-    }
-    const key = mapped.map(typeKey).join(",");
+            const bound = lowerer.typeParamTsBindings?.get(tp);
+            if (bound)
+                tsArgs.push(bound);
+        }
+    }
+    // A type parameter that a conditional type in the class depends on
+    // (`K extends "required" ? T : T | undefined`) is bound to its checker
+    // type for the members, and that type keys the instance: mapType alone
+    // widens a literal, so Field<string, "required"> and Field<string,
+    // "optional"> would otherwise share one layout. The other parameters get
+    // no checker binding, so nothing in the members depends on a literal
+    // the key does not carry.
+    gci.literalSensitive ??= literalSensitiveTypeParams(lowerer, gci);
+    const sensitive = (i) => tsArgs.length === gci.typeParams.length && gci.literalSensitive.has(gci.typeParams[i]);
+    const checkerKey = gci.typeParams
+        .map((_, i) => (sensitive(i) ? `#${tsArgs[i].id}` : "*"))
+        .join(",");
+    const key = mapped.map(typeKey).join(",") + (gci.literalSensitive.size > 0 ? `@${checkerKey}` : "");
+    const literalText = (i) => {
+        const arg = sensitive(i) ? tsArgs[i] : undefined;
+        if (arg?.isStringLiteralType())
+            return JSON.stringify(arg.value);
+        if (arg?.isNumberLiteralType())
+            return String(arg.value);
+        if (arg && arg.flags & ts.TypeFlags.BooleanLiteral)
+            return lowerer.checker.typeToString(arg);
+        return null;
+    };
     const existing = gci.instances.get(key);
     if (existing) {
         if (existing.info)
@@ -3634,18 +3711,40 @@ export function genericClassInstanceType(lowerer, decl, ref, mapArgument) {
         lowerer.unsupported("SC1090", decl, `unbounded generic class instantiation ('${gci.baseName}' exceeded ${MAX_INSTANTIATION_RECURSION} recursive specializations on one demand path)`);
     }
     const ordinal = gci.instances.size;
-    const name = `${gci.family.def.name}%${ordinal}`;
+    // The name does not take the checker type ids of the key: a literal
+    // argument is named by its text, another checker type by its
+    // description. Two keys that still describe alike number the later one.
+    const nameKey = mapped.map(typeKey).join(",") +
+        (gci.literalSensitive.size > 0
+            ? `@${gci.typeParams
+                .map((_, i) => sensitive(i)
+                ? (literalText(i) ?? checkerTypeDescription(tsArgs[i], lowerer.typeCtx))
+                : "*")
+                .join(",")}`
+            : "");
+    const prefix = `${gci.family.def.name}%`;
+    const taken = new Set([...gci.instances.values()].map((instance) => instance.name));
+    let name = keyedHelperName(lowerer, prefix, nameKey, "");
+    for (let n = 1; taken.has(name); n++)
+        name = keyedHelperName(lowerer, prefix, `${nameKey}#${n}`, "");
     const entry = { name, info: null };
     gci.instances.set(key, entry);
     const bindings = new Map();
     gci.typeParams.forEach((tp, i) => bindings.set(tp, mapped[i]));
-    const rendered = mapped.map((m) => lowerer.fmt(m)).join(", ");
+    const tsBindings = new Map();
+    gci.typeParams.forEach((tp, i) => {
+        if (sensitive(i))
+            tsBindings.set(tp, tsArgs[i]);
+    });
+    const rendered = mapped.map((m, i) => literalText(i) ?? lowerer.fmt(m)).join(", ");
     const typeArgsText = `<${rendered.length > 80 ? rendered.slice(0, 77) + "..." : rendered}>`;
     const prevBindings = lowerer.typeParamBindings;
+    const prevTsBindings = lowerer.typeParamTsBindings;
     const prevContext = lowerer.instantiationContext;
     const previousPath = lowerer.genericInstantiationPath;
     lowerer.genericInstantiationPath = path;
     lowerer.typeParamBindings = bindings;
+    lowerer.typeParamTsBindings = tsBindings;
     lowerer.instantiationContext = `instantiating class '${gci.baseName}' with ${typeArgsText}`;
     try {
         lowerer.collectClassShapeInner(decl, undefined, {
@@ -3653,6 +3752,7 @@ export function genericClassInstanceType(lowerer, decl, ref, mapArgument) {
             family: gci.family,
             name,
             bindings,
+            tsBindings,
             typeArgsText,
             ordinal,
         });
@@ -3667,6 +3767,7 @@ export function genericClassInstanceType(lowerer, decl, ref, mapArgument) {
     }
     finally {
         lowerer.typeParamBindings = prevBindings;
+        lowerer.typeParamTsBindings = prevTsBindings;
         lowerer.instantiationContext = prevContext;
         lowerer.genericInstantiationPath = previousPath;
     }
@@ -3681,6 +3782,65 @@ export function genericClassInstanceType(lowerer, decl, ref, mapArgument) {
     lowerer.onLateClassCollected?.(info);
     return { kind: "object", className: name };
 }
+/** The class's type parameters that a conditional type inside it depends
+ * on: the parameters named within a type node that is a conditional type
+ * or reaches one through the type aliases and interfaces it refers to
+ * (`get(): Value<T, K>` with `type Value<T, K> = K extends "required" ? T
+ * : T | undefined`, also when the alias wraps the conditional in a union
+ * or another alias). Their arguments pick the conditional's branch. */
+function literalSensitiveTypeParams(lowerer, gci) {
+    const params = new Set(gci.typeParams);
+    const found = new Set();
+    const reaches = new Map();
+    const declarationsReach = (symbol) => {
+        const target = symbol.flags & ts.SymbolFlags.Alias ? lowerer.checker.getAliasedSymbol(symbol) : symbol;
+        const known = reaches.get(target);
+        if (known !== undefined)
+            return known;
+        reaches.set(target, false); // a recursive alias reaches through its other parts
+        const result = target.declarations.some((d) => ts.isTypeAliasDeclaration(d)
+            ? reachesConditional(d.type)
+            : ts.isInterfaceDeclaration(d)
+                ? d.members.nodes.some(reachesConditional)
+                : false);
+        reaches.set(target, result);
+        return result;
+    };
+    const reachesConditional = (node) => {
+        if (ts.isConditionalTypeNode(node))
+            return true;
+        if (ts.isTypeReferenceNode(node)) {
+            const name = ts.isIdentifier(node.typeName) ? node.typeName : node.typeName.right;
+            const symbol = lowerer.checker.getSymbolAtLocation(name);
+            if (symbol && !params.has(symbol) && declarationsReach(symbol))
+                return true;
+        }
+        let found = false;
+        ts.forEachChild(node, (child) => {
+            if (!found && reachesConditional(child))
+                found = true;
+        });
+        return found;
+    };
+    const collect = (node) => {
+        if (ts.isTypeReferenceNode(node) && ts.isIdentifier(node.typeName)) {
+            const symbol = lowerer.checker.getSymbolAtLocation(node.typeName);
+            if (symbol && params.has(symbol))
+                found.add(symbol);
+        }
+        ts.forEachChild(node, collect);
+    };
+    const visit = (node) => {
+        if (ts.isTypeNode(node) && reachesConditional(node)) {
+            collect(node);
+            return;
+        }
+        ts.forEachChild(node, visit);
+    };
+    for (const member of gci.decl.members.nodes)
+        visit(member);
+    return found;
+}
 /** Runs a member-lowering thunk under an INSTANTIATION's type-parameter
  * bindings (the generic-fn typeParamResolver mechanism) — the checker
  * keeps reporting the unsubstituted `T`s inside the shared body AST.
@@ -3716,11 +3876,13 @@ function withInstanceBindings(lowerer, info, fn) {
         }
     }
     const prevBindings = lowerer.typeParamBindings;
+    const prevTsBindings = lowerer.typeParamTsBindings;
     const prevContext = lowerer.instantiationContext;
     const prevSuppress = lowerer.suppressStats;
     const previousPath = lowerer.genericInstantiationPath;
     lowerer.genericInstantiationPath = gi.path;
     lowerer.typeParamBindings = gi.bindings;
+    lowerer.typeParamTsBindings = gi.tsBindings;
     lowerer.instantiationContext = `instantiating class '${gi.family.generic?.baseName ?? info.def.jsName ?? ""}' with ${gi.typeArgsText}`;
     lowerer.suppressStats = prevSuppress || gi.ordinal > 0;
     try {
@@ -3728,6 +3890,7 @@ function withInstanceBindings(lowerer, info, fn) {
     }
     finally {
         lowerer.typeParamBindings = prevBindings;
+        lowerer.typeParamTsBindings = prevTsBindings;
         lowerer.instantiationContext = prevContext;
         lowerer.suppressStats = prevSuppress;
         lowerer.genericInstantiationPath = previousPath;
@@ -4455,6 +4618,13 @@ export function lowerStaticFieldRead(lowerer, expr) {
         return null;
     const loc = locOf(expr);
     const found = findStaticOn(lowerer, info, expr.name.text);
+    // A Date static read as a value through a class declared `extends Date`:
+    // the statics lower only as calls.
+    if (!found &&
+        dateRootOf(info) &&
+        ["now", "parse", "UTC"].includes(expr.name.text) &&
+        !(ts.isCallExpression(expr.parent) && expr.parent.expression === expr))
+        lowerer.noLowering(`Date.${expr.name.text} read through a class that extends Date`, expr);
     if (hasRuntimeStatics(info) && !found?.field)
         return {
             kind: "dynKeyGet",
@@ -4492,8 +4662,18 @@ export function lowerStaticFieldRead(lowerer, expr) {
     }
     // `C.name` — the JS-observable class name, a compile-time constant on
     // the direct spelling (tsc rejects user statics named `name`, so the
-    // chain above can never shadow it in TypeScript sources).
+    // chain above can never shadow it in TypeScript sources). A class of an
+    // import cycle reads it from its class object instead, whose reference
+    // checks the class's initialization (checkCycleBindingAccesses).
     if (expr.name.text === "name" && info.def.jsName !== undefined) {
+        if (lowerer.classInitFlags.get(info.def.name)?.cycle === true)
+            return {
+                kind: "libCall",
+                fn: "class.name",
+                args: [classValueRef(lowerer, info, expr.expression)],
+                type: STRING,
+                loc,
+            };
         return { kind: "strLit", value: info.def.jsName, type: STRING, loc };
     }
     if (info.callableBase)
@@ -4648,9 +4828,10 @@ export function lowerClassExpressionInfo(lowerer, expr) {
             expr.members.nodes.some((member) => decoratorNodesOf(member).length ||
                 (!isJsSourceFile(ts.getSourceFileOfNode(expr)) &&
                     (ts.isClassStaticBlockDeclaration(member) ||
-                        ts
-                            .getModifiers(member)
-                            ?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword))) ||
+                        (!ts.isMethodDeclaration(member) &&
+                            ts
+                                .getModifiers(member)
+                                ?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword)))) ||
                 (ts.isMethodDeclaration(member) && member.typeParameters?.nodes.length)))) {
         lowerer.unsupported("SC1090", expr, "function-local classes with statics, decorators, or generic members");
     }
@@ -4661,7 +4842,7 @@ export function lowerClassExpressionInfo(lowerer, expr) {
             !lowerer.computedClassBases.has(lowerer.classNamer(expr))) {
             const heritage = expr.heritageClauses?.nodes.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword)?.types?.nodes[0]?.expression;
             if (heritage &&
-                (ts.isCallExpression(heritage) ||
+                ((ts.isCallExpression(heritage) && !builtinRequireBaseOf(lowerer, heritage)) ||
                     (ts.isIdentifier(heritage) &&
                         (lowerer.peekLocal(heritage) ?? lowerer.globalOf(heritage)) != null))) {
                 let value = lowerer.lowerExpr(heritage);
@@ -4893,9 +5074,49 @@ export function lowerClassExpression(lowerer, expr) {
             loc,
         });
     }
-    return info.localClass
-        ? initializeRuntimeStatics(lowerer, info, value.kind === "classRef" ? { ...value, captures: info.localClass.captureSources } : value)
-        : value;
+    if (!info.localClass)
+        return value;
+    const classValue = initializeRuntimeStatics(lowerer, info, value.kind === "classRef" ? { ...value, captures: info.localClass.captureSources } : value);
+    // The base resolves statically here, but Node still evaluates the
+    // heritage expression each time the class definition runs, first.
+    const heritage = heritageWithEffects(expr);
+    if (heritage === undefined)
+        return classValue;
+    return {
+        kind: "seqExpr",
+        stmts: [lowerer.lowerExprStatement(heritage)],
+        result: classValue,
+        type: classValue.type,
+        loc: classValue.loc,
+    };
+}
+/** The `extends` expression of `decl` when evaluating it can have effects
+ * (a call, construction, assignment, update, delete, await or yield
+ * outside nested functions). */
+function heritageWithEffects(decl) {
+    const heritage = decl.heritageClauses?.nodes.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword)?.types?.nodes[0]?.expression;
+    if (heritage === undefined)
+        return undefined;
+    const effects = (node) => {
+        if (ts.isFunctionLike(node) || ts.isClassDeclaration(node) || ts.isClassExpression(node))
+            return false;
+        if (ts.isCallExpression(node) ||
+            ts.isNewExpression(node) ||
+            ts.isTaggedTemplateExpression(node) ||
+            ts.isDeleteExpression(node) ||
+            ts.isAwaitExpression(node) ||
+            ts.isYieldExpression(node) ||
+            (ts.isPrefixUnaryExpression(node) &&
+                (node.operator === ts.SyntaxKind.PlusPlusToken ||
+                    node.operator === ts.SyntaxKind.MinusMinusToken)) ||
+            ts.isPostfixUnaryExpression(node) ||
+            (ts.isBinaryExpression(node) &&
+                node.operatorToken.kind >= ts.SyntaxKind.FirstAssignment &&
+                node.operatorToken.kind <= ts.SyntaxKind.LastAssignment))
+            return true;
+        return ts.forEachChild(node, (child) => effects(child) || undefined) ?? false;
+    };
+    return effects(heritage) ? heritage : undefined;
 }
 /** The EXACT class a receiver expression is statically known to BE (not
  * merely be typed by): the class name itself, or a `const` binding
@@ -5156,6 +5377,13 @@ function staticCallOn(lowerer, call, access, info, throughValue) {
     const runtimeStatic = directRuntimeStaticCall(lowerer, call, access, info, throughValue);
     if (runtimeStatic)
         return runtimeStatic;
+    // Date's statics through a class declared `extends Date`
+    // (`Moment.UTC(...)`), which inherits them.
+    if (dateRootOf(info) && !findStaticOn(lowerer, info, access.name.text)) {
+        const date = lowerDateStaticCall(lowerer, call, access.name.text);
+        if (date)
+            return date;
+    }
     if ((hasRuntimeStatics(info) && !findStaticOn(lowerer, info, access.name.text)?.field) ||
         (info.callableBase &&
             !findStaticOn(lowerer, info, access.name.text) &&
@@ -5568,14 +5796,21 @@ function thunkAsyncSlot(overridden, mName) {
     if (overridden.sig.async !== true)
         return;
     const declarer = overridden.declarer;
+    // The slot answers the body's promise: an untyped async method's `dyn`
+    // result is the promise's payload, so the slot's ABI is that promise. An
+    // async generator method's slot keeps its generator object.
+    const ret = overridden.sig.gen || overridden.sig.ret.kind === "promise"
+        ? overridden.sig.ret
+        : { kind: "promise", inner: overridden.sig.ret };
     declarer.returnAdapters ??= new Map();
     if (!declarer.returnAdapters.has(mName)) {
         declarer.returnAdapters.set(mName, {
             params: [...overridden.sig.params],
-            ret: overridden.sig.ret,
+            ret,
             async: true,
         });
     }
+    overridden.sig.ret = ret;
     delete overridden.sig.async;
 }
 function overrideReturnAbi(lowerer, declared, inherited, className, base) {
@@ -6242,7 +6477,7 @@ function lowerClassCtorInner(lowerer, info) {
                 lowerer.ctx.argumentsLocal = local;
             }
             body.push(...declared.prologue);
-            if (!ctorBase && !info.callableBase) {
+            if (!ctorBase && !info.callableBase && !info.extendsDate) {
                 // Node's base-class order: field initializers run at the start
                 // of construction, the parameter-property assignments open the
                 // constructor body (probed — a field initializer reading a
@@ -6257,7 +6492,7 @@ function lowerClassCtorInner(lowerer, info) {
             }
         }
         else {
-            if (ctorBase || info.callableBase) {
+            if (ctorBase || info.callableBase || info.extendsDate) {
                 // Synthetic forwarding params (the inherited ABI signature).
                 // Nothing references them by symbol — only the super call below,
                 // which forwards the already-completed values UNCHANGED (defaults
@@ -6440,7 +6675,7 @@ export function classIteratorDrainCall(lowerer, src, loc, elemT) {
     const key = `${cit.className}:${typeKey(outElem)}`;
     let name = lowerer.iterDrainHelpers.get(key);
     if (!name) {
-        name = `%iter.drain.${lowerer.iterDrainHelpers.size}`;
+        name = keyedHelperName(lowerer, "%iter.drain", key);
         lowerer.iterDrainHelpers.set(key, name);
         const recvT = { kind: "object", className: cit.className };
         const recvRef = { kind: "varRef", localId: "r.0", type: recvT, loc };
@@ -6548,7 +6783,7 @@ export function classIteratorRestDrainCall(lowerer, cit, itVal, loc) {
     const key = `it:${cit.iterT.className}`;
     let name = lowerer.iterDrainHelpers.get(key);
     if (!name) {
-        name = `%iter.drain.${lowerer.iterDrainHelpers.size}`;
+        name = keyedHelperName(lowerer, "%iter.drain", key);
         lowerer.iterDrainHelpers.set(key, name);
         const itRef = { kind: "varRef", localId: "it.0", type: cit.iterT, loc };
         const outRef = { kind: "varRef", localId: "out.0", type: outT, loc };
@@ -7043,12 +7278,39 @@ function superCallInStatementPosition(call) {
         const parent = node.parent;
         if (ts.isExpressionStatement(parent))
             return true;
+        if (ts.isIfStatement(parent)) {
+            const lead = superConditionLead(parent.expression);
+            return lead !== null && call.pos >= lead.left.pos && call.end <= lead.left.end;
+        }
         const comma = ts.isBinaryExpression(parent) && parent.operatorToken.kind === ts.SyntaxKind.CommaToken;
         if (!comma && !ts.isParenthesizedExpression(parent))
             return false;
         node = parent;
     }
 }
+/** The comma chain of an `if` condition whose leading operands hold a
+ * super() call (`if (super(), r === 0) throw ...`, as minifiers join a
+ * super statement with the next test), or null. The if statement runs the
+ * chain's left operand as a statement first and tests its right operand,
+ * which is what the comma evaluates. */
+export function superConditionLead(cond) {
+    let expr = cond;
+    while (ts.isParenthesizedExpression(expr))
+        expr = expr.expression;
+    if (!ts.isBinaryExpression(expr) || expr.operatorToken.kind !== ts.SyntaxKind.CommaToken)
+        return null;
+    const holdsSuperCall = (operand) => {
+        let e = operand;
+        while (ts.isParenthesizedExpression(e))
+            e = e.expression;
+        if (ts.isCallExpression(e))
+            return e.expression.kind === ts.SyntaxKind.SuperKeyword;
+        return (ts.isBinaryExpression(e) &&
+            e.operatorToken.kind === ts.SyntaxKind.CommaToken &&
+            (holdsSuperCall(e.left) || holdsSuperCall(e.right)));
+    };
+    return holdsSuperCall(expr.left) ? expr : null;
+}
 /** Super statements initialize the base and then the derived fields on
  * whichever control-flow path executes. Repeated calls are explicitly
  * refused until native layouts can allocate a second receiver. */
@@ -7080,9 +7342,11 @@ export function lowerDerivedCtorBody(lowerer, info, thisLocal, forward) {
                 loc,
             },
         ];
-        if (info.callableBase) {
+        if (info.callableBase || info.extendsDate) {
             if (superCall.arguments.nodes.some(ts.isSpreadElement))
-                lowerer.unsupported("SC1090", superCall, "spreading explicit super arguments into an ordinary constructor");
+                lowerer.unsupported("SC1090", superCall, info.extendsDate
+                    ? "spreading super arguments into the Date constructor"
+                    : "spreading explicit super arguments into an ordinary constructor");
             const pack = {
                 kind: "dynArrLit",
                 elems: superCall.arguments.nodes.map((arg) => lowerer.lowerExprExpecting(arg, DYN)),
@@ -7225,6 +7489,8 @@ export function superCallStmt(lowerer, info, thisLocal, args, loc) {
         type: { kind: "object", className: info.def.name },
         loc,
     };
+    if (info.extendsDate)
+        return dateSuperCall(thisRef, info, args[0], loc);
     if (info.callableBase)
         return {
             kind: "exprStmt",
@@ -7327,6 +7593,22 @@ export function superCallStmt(lowerer, info, thisLocal, args, loc) {
  * super dispatch is static in JS too, never through the dynamic class. */
 export function lowerSuperMethodCall(lowerer, call, access) {
     const cls = lowerer.currentClass;
+    // `super.toISOString()` in a class declared `extends Date`.
+    if (cls?.extendsDate && !cls.base) {
+        const thisL = lowerer.resolveThis();
+        if (!thisL)
+            lowerer.unsupported("SC1080", access);
+        const thisRef = {
+            kind: "varRef",
+            localId: thisL.id,
+            type: thisL.type,
+            loc: locOf(call),
+        };
+        const date = lowerDateSuperMethodCall(lowerer, call, access.name.text, cls, thisRef);
+        if (date)
+            return date;
+        lowerer.unsupported("SC1090", access, `'super.${access.name.text}' (Date.prototype does not declare it)`);
+    }
     if (!cls?.base) {
         // tsc rejects super outside derived-class bodies first; defensive.
         lowerer.unsupported("SC1090", access, "'super' outside a derived class");
@@ -7374,6 +7656,18 @@ export function lowerSuperMethodCall(lowerer, call, access) {
         // `super.dispatchEvent(e)`, `super.preventDefault()`: the inherited
         // runtime members over this method's own `this` (subclasses cannot
         // override them, so the static answer is the runtime's).
+        if (dateRootOf(cls.base) && isDatePrototypeMethod(access.name.text)) {
+            const thisL = lowerer.resolveThis();
+            if (!thisL)
+                lowerer.unsupported("SC1080", access);
+            const thisRef = {
+                kind: "varRef",
+                localId: thisL.id,
+                type: thisL.type,
+                loc: locOf(call),
+            };
+            return lowerDateSuperMethodCall(lowerer, call, access.name.text, cls.base, thisRef);
+        }
         if (eventTargetApiMethod(cls.base, access.name.text)) {
             const thisL = lowerer.resolveThis();
             if (!thisL)
@@ -7738,6 +8032,12 @@ function isCollectionOrErrorClass(ref) {
 }
 export function lowerNew(lowerer, expr) {
     const loc = locOf(expr);
+    // A dependency's deprecated `new Buffer(...)` fallback (containers/bytes.ts).
+    {
+        const buffer = lowerNodeModulesBufferConstruct(lowerer, expr);
+        if (buffer)
+            return buffer;
+    }
     // new Function(...): Node's EvalError under
     // --disallow-code-generation-from-strings (code-generation.ts).
     if (codeGenerationCalleeOf(lowerer, expr.expression) === "Function")
@@ -8005,6 +8305,13 @@ export function lowerNew(lowerer, expr) {
         if (httpServer)
             return httpServer;
     }
+    // `new tls.TLSSocket(socket, options)` — the server-mode wrap of an open
+    // socket (lower-server).
+    {
+        const tlsSocket = lowerTlsSocketNew(lowerer, expr);
+        if (tlsSocket)
+            return tlsSocket;
+    }
     // `new http.Agent(opts?)` / `new https.Agent(opts?)` — the Agent
     // handle (lower-server): getName/destroy/counters through the dyn
     // handle ops, requests thread it via the agent option.
@@ -8730,7 +9037,7 @@ export function lowerNew(lowerer, expr) {
             const key = `x509.record:${isBytes ? "bytes" : "str"}`;
             let helper = lowerer.valueHelpers.get(key);
             if (!helper) {
-                helper = `%x509.record.${lowerer.valueHelpers.size}`;
+                helper = keyedHelperName(lowerer, "%x509.record", key);
                 lowerer.valueHelpers.set(key, helper);
                 const dataT = data.type;
                 const dRef = { kind: "varRef", localId: "d.0", type: dataT, loc };