@scriptc/compiler 0.2.3 → 0.2.5

package/dist/frontend/lowering/generic-functions.js

@@ -0,0 +1,1727 @@
+import * as ts from "../ts7/adapter.js";
+import { bodyReadsArguments } from "../arguments-usage.js";
+import { DYN, isUnitType, typeEquals, } from "../../ir/ir.js";
+import { isJsSourceFile, locOf } from "../program.js";
+import { typeKey } from "../type-mapper.js";
+import { PoisonError, dynFallbackType, neverTaintedJsType, newFnCtx } from "./lowerer.js";
+import { tryLowerExpression } from "./expressions/try-lower-expression.js";
+import { findGenericMethodOn } from "./lower-classes.js";
+import { nsPathPrefix } from "./lower-namespaces.js";
+import { declSymbolOf } from "./lower-modules.js";
+import { npmStaticPackageOfPath } from "../npm-static.js";
+import { rejectStaticThis } from "./static-this.js";
+import { jsBindingHasOpenWrites } from "./lower-stmts.js";
+import { paramShapes, generatorMeta, funcTypeFromParamShapes, } from "./call-signatures.js";
+import { fenceGenericSignatureResult, blockBodyOf, resolveInferredReturn, appendImplicitUndefinedReturn, hasExplicitJsDocReturn, promiseCarriesDyn, } from "./function-returns.js";
+import { bindingNeverReassigned, stripValueWrappers } from "./binding-analysis.js";
+/** Instantiation cap per generic function: same-key recursion (`len<T>`
+ * calling itself) converges, but POLYMORPHIC recursion (`f<T>` calling
+ * `f<T[]>`) would request new instances forever — the cap turns that into a
+ * diagnostic instead of a hang. */
+export const MAX_GENERIC_INSTANCES = 100;
+/** Defaults bind during inference; collection only resolves symbols in
+ * declaration order and preserves each declaration form's diagnostic. */
+function declaredTypeParameterSymbols(lowerer, parameters, blame, detail) {
+    return parameters.map((parameter) => {
+        const symbol = lowerer.checker.getSymbolAtLocation(parameter.name);
+        if (!symbol)
+            lowerer.unsupported("SC1090", blame, detail);
+        return symbol;
+    });
+}
+/** Pattern parameters are admitted by declarations and value bindings;
+ * object-literal generic methods retain their identifier-only boundary. */
+function checkGenericParameterNames(lowerer, parameters, allowPatterns) {
+    for (const parameter of parameters) {
+        if (!ts.isIdentifier(parameter.name) &&
+            !(allowPatterns &&
+                (ts.isObjectBindingPattern(parameter.name) || ts.isArrayBindingPattern(parameter.name)))) {
+            lowerer.unsupported("SC1031", parameter);
+        }
+    }
+}
+/** Static generic values must keep their initializer for their lifetime.
+ * Merged var declarations count as writes even when the assignment scan
+ * cannot see them; const bindings need no whole-file write scan. */
+function requireStableGenericBinding(lowerer, decl, symbol, name) {
+    const isConst = (ts.getCombinedNodeFlags(decl) & ts.NodeFlags.Const) !== 0;
+    const redeclared = lowerer.checker
+        .declarationsOf(symbol)
+        .some((d) => d !== decl && ts.isVariableDeclaration(d) && d.initializer !== undefined);
+    if (!isConst && (redeclared || !bindingNeverReassigned(lowerer, symbol, decl))) {
+        lowerer.unsupported("SC1090", decl.name, `generic function values in reassigned bindings (calls of '${name}' resolve statically against this initializer, so the binding must provably hold it — a const, or a let/var nothing in its declaring file writes)`);
+    }
+}
+/** Registers a top-level generic function. Only the SYNTAX is checked
+ * here — parameter/return types mention the type parameters and cannot
+ * map yet; the body is lowered per instantiation, on demand (an unused
+ * generic function requires no body lowering). Called inside
+ * collectSignature's poison catch. */
+export function collectGenericSignature(lowerer, decl) {
+    const typeParams = declaredTypeParameterSymbols(lowerer, decl.typeParameters, decl, "this function form");
+    checkGenericParameterNames(lowerer, decl.parameters, true);
+    const nameText = decl.name?.text ?? "%default"; // nameless = the default export (checked by collectSignatureInner)
+    const symbol = declSymbolOf(lowerer, decl);
+    if (!symbol)
+        lowerer.unsupported("SC1090", decl, "this function form");
+    lowerer.genericFnsBySymbol.set(symbol, {
+        decl,
+        baseName: nameText,
+        qualifiedName: lowerer.qualify(decl.getSourceFile(), nsPathPrefix(decl) + nameText),
+        typeParams,
+        instances: new Map(),
+    });
+}
+export function genericFnOf(lowerer, ident) {
+    const symbol = lowerer.resolveValueSymbol(ident);
+    return symbol ? (lowerer.genericFnsBySymbol.get(symbol) ?? null) : null;
+}
+/** Call of a generic top-level function. The checker already inferred (or
+ * was told, via explicit type arguments) the concrete signature —
+ * getResolvedSignature returns it with type arguments substituted. The
+ * mapped param+return IR types form the INSTANTIATION KEY; the first call
+ * with a new key queues the body for monomorphic lowering as
+ * `<qualifiedName>%<n>`, and every call lowers to a direct `call` of that
+ * instance. */
+export function lowerGenericCall(lowerer, expr, info) {
+    const loc = locOf(expr);
+    const instance = info.implicitParams
+        ? implicitCallInstance(lowerer, expr, info)
+        : genericCallInstance(lowerer, expr, info);
+    const args = lowerer.completeArgs(expr.arguments, instance.params, loc, expr);
+    return { kind: "call", callee: instance.name, args, type: instance.returnType, loc };
+}
+/** The instance a CALL of a generic function-like names: resolved
+ * signature → mapped param shapes/return → interned instance. Shared by
+ * top-level generic calls, class generic-method calls (the caller
+ * prepends the receiver), and object-literal generic-method calls. */
+export function genericCallInstance(lowerer, expr, info) {
+    const rsig = lowerer.checker.getResolvedSignature(expr);
+    // A GENERIC function with overload signatures: the call resolved to a
+    // signature that is not the implementation's, so the per-instantiation
+    // body lowering would type the body against parameter/return types it
+    // was never checked under. Named fence until generic overloads get an
+    // honest story (monomorphize per implementation signature with the
+    // reconcile bridge, like the non-generic path).
+    {
+        const rdecl = rsig ? lowerer.checker.signatureDeclaration(rsig) : undefined;
+        if (rdecl &&
+            (ts.isFunctionDeclaration(rdecl) || ts.isMethodDeclaration(rdecl)) &&
+            !rdecl.body) {
+            lowerer.unsupported("SC1090", expr, `calls selecting an overload signature of a generic ${ts.isMethodDeclaration(rdecl) ? "method" : "function"} (only the implementation signature monomorphizes)`);
+        }
+    }
+    if (!rsig || rsig.getParameters().length !== info.decl.parameters.length) {
+        lowerer.unsupported("SC1090", expr, "this call form");
+    }
+    // Per-param shapes from the RESOLVED signature (types substituted) plus
+    // the declaration's modes: rest stays the resolved array, a default's
+    // ABI union is synthesized over the resolved body type — exactly the
+    // paramShape rules, applied to post-substitution types.
+    const params = paramShapes(lowerer, info.decl.parameters, rsig, (_param, i) => expr.arguments[i] ?? expr);
+    const retTs = lowerer.checker.getReturnTypeOfSignature(rsig);
+    const returnType = lowerer.mapTypeOf(retTs);
+    if (!returnType) {
+        fenceGenericSignatureResult(lowerer, expr, retTs);
+        lowerer.badType(expr, retTs);
+    }
+    // keyof-constrained type parameters (`K extends keyof T`): the bound
+    // LITERAL is semantic — the instance body reads the named field — so
+    // the bindings compute EAGERLY (the key needs them) and each literal
+    // keys its own instance (`pick(o, "a")` and `pick(o, "b")` map to the
+    // same IR signature when the fields agree, but their bodies read
+    // different fields). Non-literal bindings (a key union, plain string)
+    // share one runtime-keyed instance per IR signature, exactly the
+    // widened discipline.
+    const keyofTps = keyofConstrainedTypeParams(info);
+    if (keyofTps.size > 0) {
+        const tsBindings = new Map();
+        const bindings = lowerer.inferTypeParamBindings(expr, info, rsig, tsBindings);
+        const litKey = info.typeParams
+            .filter((tp) => keyofTps.has(tp))
+            .map((tp) => {
+            const bound = tsBindings.get(tp);
+            return bound?.isStringLiteralType()
+                ? JSON.stringify(bound.value)
+                : bound?.isNumberLiteralType()
+                    ? String(bound.value)
+                    : "*";
+        })
+            .join(",");
+        return internGenericInstance(lowerer, expr, info, params, returnType, () => bindings, {
+            extraKey: `@${litKey}`,
+            tsBindings,
+        });
+    }
+    return internGenericInstance(lowerer, expr, info, params, returnType, (tsBindings) => lowerer.inferTypeParamBindings(expr, info, rsig, tsBindings));
+}
+/** The one instance table both instantiation routes share: key identity IS
+ * signature identity, so a call (`identity(1)`) and a pinned VALUE
+ * (`const f: (x: number) => number = identity`) reuse one compiled
+ * instance. `makeBindings` runs only for a NEW key (binding inference
+ * costs checker walks). */
+function internGenericInstance(lowerer, blame, info, params, returnType, makeBindings, opts) {
+    // keyof-constrained instantiations append their literal keys
+    // (extraKey): the IR signature alone under-discriminates there — two
+    // literals can map to one IR signature while their bodies read
+    // different fields.
+    const key = `${params.map((s) => typeKey(s.type)).join(",")}=>${typeKey(returnType)}${opts?.extraKey ?? ""}`;
+    let inst = info.instances.get(key);
+    if (!inst) {
+        if (info.instances.size >= MAX_GENERIC_INSTANCES) {
+            lowerer.unsupported("SC1090", blame, `unbounded generic instantiation ('${info.baseName}' exceeded ` +
+                `${MAX_GENERIC_INSTANCES} instances — polymorphic recursion?)`);
+        }
+        const tsBindings = opts?.tsBindings ?? new Map();
+        const bindings = makeBindings(tsBindings);
+        const rendered = info.typeParams
+            .map((tp) => {
+            // A literal-bound keyof parameter renders its literal — the
+            // instance is per-literal, and '<…, string>' would misname it.
+            const tsBound = tsBindings.get(tp);
+            if (info.keyofTps?.has(tp) && tsBound?.isStringLiteralType()) {
+                return JSON.stringify(tsBound.value);
+            }
+            const bound = bindings.get(tp);
+            return bound ? lowerer.fmt(bound) : tp.name;
+        })
+            .join(", ");
+        // Deep polymorphic recursion renders unbounded types — keep messages sane.
+        const typeArgsText = `<${rendered.length > 80 ? rendered.slice(0, 77) + "..." : rendered}>`;
+        inst = {
+            name: `${info.qualifiedName}%${info.instances.size}`,
+            ordinal: info.instances.size,
+            params,
+            returnType,
+            bindings,
+            tsBindings,
+            typeArgsText,
+        };
+        info.instances.set(key, inst);
+        lowerer.instantiationQueue.push({ info, inst });
+    }
+    lowerer.noteGenericInstanceDemand(inst);
+    return inst;
+}
+/** The type parameters of `info` declared with a `keyof` CONSTRAINT
+ * (`K extends keyof T`) — the parameters whose bound literal is semantic
+ * (the body's `o[k]` reads the named field), computed once per info from
+ * the declaration's syntax. */
+function keyofConstrainedTypeParams(info) {
+    if (info.keyofTps)
+        return info.keyofTps;
+    const out = new Set();
+    info.decl.typeParameters?.forEach((tpDecl, i) => {
+        const sym = info.typeParams[i];
+        if (!sym || tpDecl.constraint === undefined)
+            return;
+        if (ts.isTypeOperatorNode(tpDecl.constraint) &&
+            tpDecl.constraint.operator === ts.SyntaxKind.KeyOfKeyword) {
+            out.add(sym);
+        }
+    });
+    info.keyofTps = out;
+    return out;
+}
+/** Type-parameter symbol → concrete IR type for one instantiation.
+ * Explicit type arguments bind directly; the rest come from structurally
+ * matching each DECLARED param/return type (which mentions the type
+ * parameters) against the checker's INSTANTIATED one — the latter is the
+ * former with the substitution applied, so the shapes are parallel by
+ * construction. A type parameter left unbound only matters if the body
+ * mentions it, where mapType fails and badType names the shape
+ * (carrying the instantiation context). */
+export function inferTypeParamBindings(lowerer, expr, info, rsig, tsBindings) {
+    const bindings = new Map();
+    expr.typeArguments?.forEach((ta, i) => {
+        const tp = info.typeParams[i];
+        if (!tp)
+            return;
+        const taT = lowerer.checker.getTypeFromTypeNode(ta);
+        const mapped = lowerer.mapTypeOf(taT);
+        if (mapped) {
+            bindings.set(tp, mapped);
+            tsBindings?.set(tp, taT);
+        }
+    });
+    unifySignatureBindings(lowerer, info, rsig, bindings, tsBindings);
+    bindDefaultTypeParams(lowerer, info.typeParams, info.decl.typeParameters, bindings, tsBindings);
+    return bindings;
+}
+/** Type parameters still unbound after unification take their declared
+ * DEFAULT (`<T = number>`), mapped — the checker already substituted the
+ * default into every resolved signature, so this only fills the bindings
+ * an instance body's mapType consults. */
+function bindDefaultTypeParams(lowerer, typeParams, typeParamDecls, bindings, tsBindings) {
+    typeParamDecls?.forEach((tpDecl, i) => {
+        const tp = typeParams[i];
+        if (!tp || bindings.has(tp) || !tpDecl.defaultType)
+            return;
+        const defT = lowerer.checker.getTypeFromTypeNode(tpDecl.defaultType);
+        const mapped = lowerer.mapTypeOf(defT);
+        if (mapped) {
+            bindings.set(tp, mapped);
+            tsBindings?.set(tp, defT);
+        }
+    });
+}
+/** The structural half of binding inference: unify the DECLARED signature
+ * (whose types mention the type parameters) against a TARGET signature
+ * with the substitution applied — a call's resolved signature, or the
+ * completed signature a VALUE reference is pinned to (the contextual
+ * type's one call signature). Mutates `bindings`; already-bound
+ * parameters (explicit type arguments) win. */
+function unifySignatureBindings(lowerer, info, rsig, bindings, tsBindings) {
+    const tpSet = new Set(info.typeParams);
+    const seen = new Set(); // recursive declared types must not loop
+    // The identity-keyed set cannot catch LAZILY INFINITE anonymous types
+    // (`function rec<T>(x: T) { return { deeper: <U>(y: U) => rec<[T, U]>(...) }; }`
+    // — every property/signature walk instantiates FRESH type objects, and
+    // no Reference target exists to shortcut on), so a depth cap bounds the
+    // walk. Stopping only stops INFERENCE: a type parameter left unbound
+    // surfaces as an ordinary mapping diagnostic later, never a wrong
+    // binding — and every practical signature binds its parameters within
+    // a few levels.
+    const MAX_UNIFY_DEPTH = 24;
+    const unify = (declared, inst, depth = 0) => {
+        if (depth > MAX_UNIFY_DEPTH)
+            return;
+        if (declared.flags & ts.TypeFlags.TypeParameter) {
+            const sym = declared.getSymbol();
+            if (sym && tpSet.has(sym)) {
+                // The checker type records even when an explicit type argument
+                // already bound the IrType: the raw type is the SAME binding
+                // pre-widening, and first-hit-wins keeps the two maps parallel.
+                // A generic body FORWARDING its own parameter (`pluck`'s
+                // `pick(it, key)` binds pick's K to pluck's K) resolves through
+                // the enclosing instantiation's ts bindings first — the literal
+                // carries through the chain.
+                if (tsBindings && !tsBindings.has(sym)) {
+                    tsBindings.set(sym, lowerer.typeParamTsResolver(inst) ?? inst);
+                }
+                if (!bindings.has(sym)) {
+                    const mapped = lowerer.mapTypeOf(inst);
+                    // A visitor's inferred T can be void. It still binds the
+                    // return convention of `(node) => T`; discarding it leaves
+                    // the callback's return type spuriously uninstantiated.
+                    if (mapped)
+                        bindings.set(sym, mapped);
+                }
+            }
+            return;
+        }
+        if (seen.has(declared))
+            return;
+        seen.add(declared);
+        // Optional-flavored unions (`x?: T` declares `T | undefined`): strip
+        // the unit parts from both sides and unify the lone remaining pair.
+        // Multi-part unions have no positional correspondence — skipped (an
+        // unbound type parameter surfaces as a mapping diagnostic later).
+        if (declared.isUnionType()) {
+            const unitFlags = ts.TypeFlags.Undefined | ts.TypeFlags.Null;
+            const declaredParts = ts.constituentTypes(declared);
+            const declaredUnits = declaredParts.reduce((flags, t) => flags | (t.flags & unitFlags), 0);
+            const dParts = declaredParts.filter((t) => !(t.flags & unitFlags));
+            const iParts = inst.isUnionType()
+                ? ts.constituentTypes(inst).filter((t) => !(t.flags & declaredUnits))
+                : [inst];
+            if (dParts.length === 1 && iParts.length === 1)
+                unify(dParts[0], iParts[0], depth + 1);
+            else if (dParts.length === 1 &&
+                iParts.length > 1 &&
+                iParts.every((t) => (t.flags & unitFlags) === 0)) {
+                // T | undefined can receive boolean | undefined: boolean itself
+                // has two literal arms. There is still one declared data slot,
+                // so match it against the whole remaining union. Removing null
+                // too is safe only when no undeclared null arm remains.
+                unify(dParts[0], lowerer.checker.getNonNullableType(inst), depth + 1);
+            }
+            return;
+        }
+        // Instantiations of the SAME generic ALIAS (Partial<T> vs
+        // Partial<Config>) unify by alias arguments: instantiation preserves
+        // aliasSymbol/aliasTypeArguments, and the two argument lists are
+        // parallel by construction. Without this, a mapped-type parameter
+        // leaves T unbound — the declared `Partial<T>` has no resolvable
+        // members for the property walk below (keyof T is unknown).
+        const dAlias = declared.getAliasSymbol();
+        const dAliasArgs = declared.getAliasTypeArguments();
+        const iAliasArgs = inst.getAliasTypeArguments();
+        if (dAlias &&
+            dAlias === inst.getAliasSymbol() &&
+            dAliasArgs.length &&
+            iAliasArgs.length === dAliasArgs.length) {
+            dAliasArgs.forEach((da, i) => {
+                const ia = iAliasArgs[i];
+                if (ia)
+                    unify(da, ia, depth + 1);
+            });
+            return;
+        }
+        // References to the SAME generic (Promise<T> vs Promise<string>, or
+        // any interface reference) unify by type ARGUMENTS only. Walking
+        // members instead diverges: a self-referential member like Promise's
+        // `then<U>(...): Promise<U>` instantiates a FRESH type object on
+        // every property read, so an identity-keyed visited set never trips.
+        const dRef = declared;
+        const iRef = inst;
+        if (declared.flags & ts.TypeFlags.Object &&
+            inst.flags & ts.TypeFlags.Object &&
+            declared.objectFlags & ts.ObjectFlags.Reference &&
+            inst.objectFlags & ts.ObjectFlags.Reference &&
+            dRef.getTarget() === iRef.getTarget()) {
+            const dArgs = lowerer.checker.getTypeArguments(dRef);
+            const iArgs = lowerer.checker.getTypeArguments(iRef);
+            dArgs.forEach((da, i) => {
+                const ia = iArgs[i];
+                if (ia)
+                    unify(da, ia, depth + 1);
+            });
+            return;
+        }
+        if (lowerer.checker.isArrayType(declared) && lowerer.checker.isArrayType(inst)) {
+            const dElem = lowerer.checker.getTypeArguments(declared)[0];
+            const iElem = lowerer.checker.getTypeArguments(inst)[0];
+            if (dElem && iElem)
+                unify(dElem, iElem, depth + 1);
+            return;
+        }
+        const dSigs = lowerer.checker.getCallSignatures(declared);
+        const iSigs = lowerer.checker.getCallSignatures(inst);
+        if (dSigs.length === 1 && iSigs.length === 1) {
+            const ds = dSigs[0];
+            const is = iSigs[0];
+            const instanceParams = is.getParameters();
+            ds.getParameters().forEach((dp, i) => {
+                const ip = instanceParams[i];
+                if (ip)
+                    unify(lowerer.checker.getTypeOfSymbol(dp), lowerer.checker.getTypeOfSymbol(ip), depth + 1);
+            });
+            unify(lowerer.checker.getReturnTypeOfSignature(ds), lowerer.checker.getReturnTypeOfSignature(is), depth + 1);
+            return;
+        }
+        if (declared.flags & ts.TypeFlags.Object) {
+            for (const dp of lowerer.checker.getPropertiesOfType(declared)) {
+                const ip = lowerer.checker.getPropertyOfType(inst, dp.name);
+                if (ip)
+                    unify(lowerer.checker.getTypeOfSymbol(dp), lowerer.checker.getTypeOfSymbol(ip), depth + 1);
+            }
+        }
+    };
+    const declSig = lowerer.checker.getSignatureFromDeclaration(info.decl);
+    if (declSig) {
+        const instanceParams = rsig.getParameters();
+        declSig.getParameters().forEach((dp, i) => {
+            const ip = instanceParams[i];
+            if (ip)
+                unify(lowerer.checker.getTypeOfSymbol(dp), lowerer.checker.getTypeOfSymbol(ip));
+        });
+        unify(lowerer.checker.getReturnTypeOfSignature(declSig), lowerer.checker.getReturnTypeOfSignature(rsig));
+    }
+}
+/** Lowers ONE monomorphic instance of a generic function: the same body
+ * AST, re-lowered with the type parameters bound (threaded into every
+ * mapType call via typeParamResolver — the checker keeps reporting the
+ * unsubstituted `T`s inside the body). Coverage stats count a base
+ * function's statements once: only the FIRST instance contributes. */
+export function lowerGenericInstance(lowerer, info, inst) {
+    const decl = info.decl;
+    const cls = info.member?.cls ?? null;
+    const prevBindings = lowerer.typeParamBindings;
+    const prevContext = lowerer.instantiationContext;
+    const prevSuppress = lowerer.suppressStats;
+    const prevClass = lowerer.currentClass;
+    const prevImplicit = lowerer.implicitParamTypes;
+    // A generic METHOD of a generic-class INSTANTIATION lowers under BOTH
+    // binding sets: the receiver instantiation's class type parameters
+    // underneath, the method instantiation's own on top (disjoint symbol
+    // sets — tsc rejects shadowing a class type parameter in a method).
+    const clsBindings = cls?.genericInstance?.bindings;
+    lowerer.typeParamBindings = clsBindings
+        ? new Map([...clsBindings, ...inst.bindings])
+        : inst.bindings;
+    // The ts-level bindings ride along: `T[K]` and literal-keyed `o[k]`
+    // reads inside the body resolve through the bound CHECKER types
+    // (typeParamTsResolver). Generic-class instantiations carry no
+    // ts-level bindings (their type arguments widened at the reference),
+    // so only the method instantiation's own map installs.
+    const prevTsBindings = lowerer.typeParamTsBindings;
+    lowerer.typeParamTsBindings = inst.tsBindings ?? null;
+    // Implicit-any instances thread their param bindings through typeOf
+    // (the checker reports `any` inside the body — there is no T for
+    // mapType to substitute); see the implicit-monomorphization section.
+    lowerer.implicitParamTypes =
+        info.implicitParams !== undefined ? (inst.implicitArgTypes ?? new Map()) : null;
+    lowerer.instantiationContext = `instantiating '${info.baseName}' with ${inst.typeArgsText}`;
+    // Coverage counts a generic source body once: re-instantiations of the
+    // method AND re-instantiations of the declaring generic class re-visit
+    // the same source lines.
+    lowerer.suppressStats = inst.ordinal > 0 || (cls?.genericInstance?.ordinal ?? 0) > 0;
+    // A generic ASYNC instance is an async IrFunction like any other: the
+    // body returns the resolved promise's INNER type, calls enter through
+    // the instance's own spawn wrapper (the emitter routes by fn.async),
+    // and awaits park this instance's fibers.
+    const isAsync = decl.modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) === true;
+    const nameBlame = (ts.isArrowFunction(decl) ? undefined : decl.name) ?? decl;
+    const isGenerator = decl.asteriskToken !== undefined;
+    if (isAsync && !isGenerator && inst.returnType.kind !== "promise") {
+        lowerer.badType(nameBlame, lowerer.checker.getTypeAtLocation(nameBlame));
+    }
+    // A generic GENERATOR instance mirrors async: the body returns the
+    // resolved TReturn channel, calls enter through the instance's own
+    // gen-spawn wrapper (the emitter routes by fn.generator).
+    if (isGenerator &&
+        (inst.returnType.kind !== "generator" || (inst.returnType.async === true) !== isAsync)) {
+        lowerer.badType(nameBlame, lowerer.checker.getTypeAtLocation(nameBlame));
+    }
+    let bodyReturn = isGenerator
+        ? lowerer.genBodyReturnType(inst.returnType)
+        : lowerer.bodyReturnType(isAsync, inst.returnType);
+    const fnCtx = newFnCtx(false, null, null, bodyReturn);
+    fnCtx.isAsync = isAsync;
+    // Implicit-any instances whose declared return did not map lower in
+    // return-INFERENCE mode: `return` statements record here bare, and the
+    // post-pass (resolveInferredReturn) settles the type and wraps them.
+    if (inst.implicitInferReturn)
+        fnCtx.inferReturn = { entries: [] };
+    if (cls && info.member.kind === "method")
+        lowerer.currentClass = cls;
+    if (isGenerator && inst.returnType.kind === "generator") {
+        fnCtx.generator = generatorMeta(lowerer, inst.returnType);
+    }
+    lowerer.fnStack.push(fnCtx);
+    lowerer.localClassInstantiations.push({ owner: decl, name: inst.name });
+    try {
+        // Static specializations bind lexical this only when the caller
+        // proved its exact receiver. Other instances retain the fence;
+        // super remains unsupported. Arrows inherit the lexical receiver.
+        if (info.member?.kind === "static" && decl.body) {
+            rejectStaticThis(lowerer, decl.body, (keyword) => `'${keyword}' in static methods (it names the RECEIVER class — a dynamic value; reference the class by name instead)`, false, info.staticReceiver !== undefined);
+        }
+        const params = [];
+        const receiverInit = [];
+        if (info.staticReceiver) {
+            const value = lowerer.classValueRef(info.staticReceiver, decl);
+            const local = lowerer.declareThis(value.type);
+            receiverInit.push({ kind: "varDecl", localId: local.id, init: value, loc: locOf(decl) });
+        }
+        if (cls && info.member.kind === "method") {
+            // Instance methods take `this` as param 0, exactly like plain
+            // `%C.method` functions (lowerClassMethodMemberInner).
+            const thisType = { kind: "object", className: cls.def.name };
+            const thisLocal = lowerer.declareThis(thisType);
+            params.push({ localId: thisLocal.id, name: "this", type: thisType });
+        }
+        // Default-param initializers lower per instance, with the bindings
+        // threaded — a default mentioning T resolves like any body expression.
+        const declared = lowerer.declareParams(decl.parameters, inst.params);
+        params.push(...declared.params);
+        const body = [...receiverInit, ...declared.prologue];
+        const bodyBlock = blockBodyOf(decl);
+        if (bodyBlock) {
+            body.push(...lowerer.lowerStmts(bodyBlock.statements));
+            if (fnCtx.inferReturn) {
+                bodyReturn = resolveInferredReturn(lowerer, inst, fnCtx.inferReturn, body, decl);
+                inst.returnType = bodyReturn;
+            }
+            appendImplicitUndefinedReturn(lowerer, body, bodyReturn, locOf(decl));
+        }
+        else if (ts.isArrowFunction(decl) && decl.body !== undefined && !ts.isBlock(decl.body)) {
+            // A concise arrow body: the expression IS the return value —
+            // generic properties (`id: <T>(x: T) => x`), and implicit-any
+            // local arrows (`(cmd) => [cmd.name()].concat(cmd.aliases())`),
+            // whose inferred return is simply the expression's own type.
+            if (fnCtx.inferReturn) {
+                const value = lowerer.lowerExpr(decl.body);
+                if (value.type.kind === "void") {
+                    body.push({ kind: "exprStmt", expr: value, loc: locOf(decl.body) });
+                    bodyReturn = resolveInferredReturn(lowerer, inst, fnCtx.inferReturn, body, decl);
+                    inst.returnType = bodyReturn;
+                    appendImplicitUndefinedReturn(lowerer, body, bodyReturn, locOf(decl));
+                }
+                else {
+                    const stmt = { kind: "return", value, loc: locOf(decl.body) };
+                    fnCtx.inferReturn.entries.push({ stmt, node: decl.body });
+                    body.push(stmt);
+                    bodyReturn = resolveInferredReturn(lowerer, inst, fnCtx.inferReturn, body, decl);
+                    inst.returnType = bodyReturn;
+                }
+            }
+            else {
+                const value = lowerer.lowerExprExpecting(decl.body, bodyReturn);
+                if (bodyReturn.kind === "void") {
+                    body.push({ kind: "exprStmt", expr: value, loc: locOf(decl.body) });
+                }
+                else {
+                    body.push({ kind: "return", value, loc: locOf(decl.body) });
+                }
+            }
+        }
+        else {
+            lowerer.unsupported("SC1090", decl, "function declarations whose block body the frontend cannot locate");
+        }
+        const fn = {
+            name: inst.name,
+            sourceName: info.baseName,
+            ...(!isAsync &&
+                !decl.asteriskToken &&
+                (ts.isFunctionDeclaration(decl) || ts.isFunctionExpression(decl))
+                ? { ownsPrototype: true }
+                : {}),
+            params,
+            returnType: bodyReturn,
+            locals: lowerer.ctx.locals,
+            body,
+            loc: locOf(decl),
+        };
+        if (isAsync)
+            fn.async = true;
+        if (fnCtx.generator)
+            fn.generator = fnCtx.generator;
+        return fn;
+    }
+    finally {
+        lowerer.fnStack.pop();
+        lowerer.currentClass = prevClass;
+        lowerer.typeParamBindings = prevBindings;
+        lowerer.typeParamTsBindings = prevTsBindings;
+        lowerer.implicitParamTypes = prevImplicit;
+        lowerer.instantiationContext = prevContext;
+        lowerer.localClassInstantiations.pop();
+        lowerer.suppressStats = prevSuppress;
+    }
+}
+/** A generic function taken as a VALUE, monomorphized by flow. A function
+ * value needs ONE concrete signature; tsc pins one at exactly two
+ * reference shapes — an instantiation EXPRESSION (`identity<number>`,
+ * whose own checker type is the substituted signature) and a reference
+ * whose CONTEXTUAL type completes the signature (`const f: (x: number) =>
+ * number = identity`, `take(identity)`). The declared signature unifies
+ * against the pinned one to recover the bindings; the instance then
+ * registers in the SAME table call sites use (one compiled copy per
+ * signature however it is reached), and the value is the instance's
+ * zero-capture closure — `f === f` holds within an instantiation, the
+ * declared-function identity rule. References with no pinning context
+ * (the slot keeps `<T>(x: T) => T`) fence by name. */
+export function lowerGenericFnValue(lowerer, ref, info) {
+    const loc = locOf(ref);
+    // An IMPLICIT-ANY function taken as a VALUE: indirect calls carry no
+    // per-site types to bind, so the value is the all-dyn DEFAULT
+    // instance's closure — today's compiled body exactly (one interned
+    // closure per function, so `f === f` holds like any declaration).
+    if (info.implicitParams) {
+        const inst = implicitDefaultInstance(lowerer, ref, info);
+        const funcType = funcTypeFromParamShapes(inst.params, inst.returnType);
+        lowerer.requireExactArityValue(ref, ref, inst.params, funcType);
+        lowerer.noteEdge(inst.name);
+        return { kind: "closure", fnName: inst.name, captures: [], type: funcType, loc };
+    }
+    const fenceUnpinned = () => lowerer.unsupported("SC1090", ref, `generic functions as values without a pinned concrete signature (annotate the destination — e.g. 'const f: (x: number) => number = ${info.baseName}' — instantiate explicitly ('${info.baseName}<number>'), or call '${info.baseName}' directly)`);
+    // The PINNING type: an instantiation expression's own checker type
+    // (explicit type arguments applied), else the reference's contextual
+    // type — the slot or argument the value flows into. Namespace/CJS
+    // member paths delegate the member NAME here (`lib.tag` hands over
+    // `tag`), and the checker hangs the contextual type on the whole
+    // property access — hop to it.
+    const ctxNode = ref.parent !== undefined && ts.isPropertyAccessExpression(ref.parent) && ref.parent.name === ref
+        ? ref.parent
+        : ref;
+    const pinT = ts.isExpressionWithTypeArguments(ref)
+        ? lowerer.typeOf(ref)
+        : lowerer.checker.getContextualType(ctxNode);
+    let target = null;
+    if (pinT) {
+        const sigs = lowerer.checker.getCallSignatures(pinT);
+        if (sigs.length === 1)
+            target = sigs[0];
+        else if (sigs.length === 0 && pinT.isUnionType()) {
+            // A `Fn | undefined`-flavored slot: the value can only inhabit the
+            // one callable arm — judge by it (the requireExactArityValue union
+            // rule).
+            const callable = ts
+                .constituentTypes(pinT)
+                .map((t) => lowerer.checker.getCallSignatures(t))
+                .filter((s) => s.length === 1);
+            if (callable.length === 1)
+                target = callable[0][0];
+        }
+    }
+    if (!target)
+        fenceUnpinned();
+    const bindings = new Map();
+    unifySignatureBindings(lowerer, info, target, bindings);
+    const hofBinding = runtimeOptionalHofGenericBinding(lowerer, ref, info);
+    if (hofBinding)
+        bindings.set(hofBinding.typeParam, hofBinding.type);
+    bindDefaultTypeParams(lowerer, info.typeParams, info.decl.typeParameters, bindings);
+    // A pinning signature that itself keeps type parameters (`let g: <T>(x:
+    // T) => T = identity` — storing the generic signature as such) binds
+    // nothing: mapType answers null for an unsubstituted parameter.
+    if (info.typeParams.some((tp) => !bindings.get(tp)))
+        fenceUnpinned();
+    const inst = genericValueInstance(lowerer, ref, info, bindings);
+    // The value's type is the completed ABI signature. Typed rest keeps its
+    // packed-array slot; dynRest stays hidden behind the rest marker.
+    const funcType = funcTypeFromParamShapes(inst.params, inst.returnType);
+    lowerer.requireExactArityValue(ref, ref, inst.params, funcType);
+    lowerer.noteEdge(inst.name);
+    return { kind: "closure", fnName: inst.name, captures: [], type: funcType, loc };
+}
+function runtimeOptionalHofGenericBinding(lowerer, ref, info) {
+    let argument = ref;
+    while (argument.parent && ts.isParenthesizedExpression(argument.parent))
+        argument = argument.parent;
+    const call = argument.parent;
+    if (!ts.isCallExpression(call) || call.arguments[0] !== argument)
+        return null;
+    if (!ts.isPropertyAccessExpression(call.expression) || call.expression.name.text !== "map")
+        return null;
+    if (!lowerer.isStdlibMember(call.expression))
+        return null;
+    const receiver = lowerer.mapTypeOf(lowerer.typeOf(call.expression.expression));
+    if (receiver?.kind !== "array")
+        return null;
+    const parameter = info.decl.parameters[0];
+    if (!parameter || !ts.isIdentifier(parameter.name))
+        return null;
+    const parameterType = lowerer.typeOf(parameter.name);
+    if ((parameterType.flags & ts.TypeFlags.TypeParameter) === 0)
+        return null;
+    const typeParam = parameterType.getSymbol();
+    if (!typeParam || !info.typeParams.includes(typeParam))
+        return null;
+    return { typeParam, type: lowerer.runtimeOptionalType(receiver.elem) };
+}
+/** The instance a pinned VALUE reference names: the declaration's modes
+ * over the DECLARED types mapped under the bindings (mapType's resolver
+ * substitutes — the instance-body trick), which is the same result the
+ * call path computes from the resolved signature, so both routes land on
+ * one instance per key. */
+function genericValueInstance(lowerer, ref, info, bindings) {
+    const prevBindings = lowerer.typeParamBindings;
+    const prevContext = lowerer.instantiationContext;
+    const rendered = info.typeParams
+        .map((tp) => {
+        const bound = bindings.get(tp);
+        return bound ? lowerer.fmt(bound) : tp.name;
+    })
+        .join(", ");
+    lowerer.typeParamBindings = bindings;
+    lowerer.instantiationContext = `instantiating '${info.baseName}' with <${rendered.length > 80 ? rendered.slice(0, 77) + "..." : rendered}>`;
+    try {
+        const declSig = lowerer.checker.getSignatureFromDeclaration(info.decl);
+        if (!declSig)
+            lowerer.unsupported("SC1090", ref, "this function form");
+        const params = paramShapes(lowerer, info.decl.parameters, declSig);
+        const retTs = lowerer.checker.getReturnTypeOfSignature(declSig);
+        const returnType = lowerer.mapTypeOf(retTs);
+        if (!returnType) {
+            fenceGenericSignatureResult(lowerer, ref, retTs);
+            lowerer.badType(ref, retTs);
+        }
+        return internGenericInstance(lowerer, ref, info, params, returnType, () => bindings);
+    }
+    finally {
+        lowerer.typeParamBindings = prevBindings;
+        lowerer.instantiationContext = prevContext;
+    }
+}
+/* ── implicit-any monomorphization (npm-static JS) ─────────────────────
+ *
+ * A JS function whose signature carries UNTYPED parameters is, morally, a
+ * generic function: the author wrote it for whatever the call sites pass.
+ * Inside an opted-in npm-static package the frontend treats each bindable
+ * implicit-any parameter as an implicit TYPE parameter and instantiates
+ * the body per call site over the WIDENED checker types of the arguments —
+ * the generic-binding machinery verbatim, with two twists:
+ *
+ *   1. The checker reports `any` INSIDE the body (there is no `T` for
+ *      mapType to substitute), so the binding threads through the
+ *      Lowerer's typeOf instead: an identifier reference to a bound param
+ *      whose checker answer is still `any` answers the bound ts.Type, and
+ *      every receiver-typed lowering downstream (field targets, method
+ *      dispatch, narrowing) sees the concrete type. Where tsc's own
+ *      flow analysis DID narrow the `any` (typeof/instanceof guards), a
+ *      narrow CONSISTENT with the binding wins (it is the binding, or an
+ *      arm of it); a contradicting narrow — the statically-dead branch of
+ *      a typeof dispatch this instantiation cannot take — answers the
+ *      bound type, so dead branches fence honestly instead of lowering
+ *      the live value under a lying type.
+ *   2. The instance's RETURN type cannot come from the checker when the
+ *      params poisoned it to `any`: instances lower EAGERLY at first
+ *      demand (nested body lowering, the lambda discipline) and infer the
+ *      return from the lowered return statements; same-key recursion
+ *      observes the checker-fallback type ("pinned") and the post-pass
+ *      coerces every return to the settled type — per-return fences where
+ *      a value cannot ride it. Bounded: MAX_GENERIC_INSTANCES per
+ *      function, the polymorphic-recursion cap.
+ *
+ * Bindings are SOUND by construction: the bound type is the argument's own
+ * checker type at the call site (never a guess), a param the body ever
+ * WRITES is not bindable (it stays checked-dynamic — `options = options
+ * || {}` keeps today's story), and an argument whose type does not map
+ * statically binds the checked-dynamic DYN — the all-dyn instance IS
+ * today's compiled body, so nothing regresses where nothing binds. */
+/** The npm-static gate: implicit-any monomorphization applies to functions
+ * DECLARED in an opted-in package's JS files (user JS keeps today's
+ * checked-dynamic story until the corpus is re-baselined). */
+export function implicitMonoFile(sf) {
+    return isJsSourceFile(sf) && npmStaticPackageOfPath(sf.fileName) !== null;
+}
+/** True when the body (or a nested function capturing it) ever WRITES the
+ * parameter symbol — assignment, compound assignment, ++/--, a
+ * destructuring-assignment target, or a for-in/of cursor. A written
+ * param's binding could lie after the write, so it stays dyn. */
+function paramWrittenInBody(lowerer, body, sym, name) {
+    let written = false;
+    const targetsSym = (e) => {
+        let n = e;
+        while (ts.isParenthesizedExpression(n))
+            n = n.expression;
+        if (ts.isIdentifier(n) && n.text === name) {
+            return lowerer.checker.getSymbolAtLocation(n) === sym;
+        }
+        // Destructuring-assignment patterns ([a] = xs, {a} = o): any
+        // identifier inside the target literal counts (conservative — a
+        // nested `a.b` member write through the pattern is a write THROUGH,
+        // not a rebind, but patterns are rare enough to over-approximate).
+        if (ts.isArrayLiteralExpression(n) || ts.isObjectLiteralExpression(n)) {
+            let hit = false;
+            const scan = (m) => {
+                if (hit)
+                    return;
+                if (ts.isIdentifier(m) &&
+                    m.text === name &&
+                    lowerer.checker.getSymbolAtLocation(m) === sym) {
+                    hit = true;
+                    return;
+                }
+                m.forEachChild(scan);
+            };
+            scan(n);
+            return hit;
+        }
+        return false;
+    };
+    const walk = (n) => {
+        if (written)
+            return;
+        if (ts.isBinaryExpression(n)) {
+            const k = n.operatorToken.kind;
+            const isAssign = k >= ts.SyntaxKind.FirstAssignment && k <= ts.SyntaxKind.LastAssignment;
+            if (isAssign && targetsSym(n.left)) {
+                written = true;
+                return;
+            }
+        }
+        if ((ts.isPrefixUnaryExpression(n) || ts.isPostfixUnaryExpression(n)) &&
+            (n.operator === ts.SyntaxKind.PlusPlusToken ||
+                n.operator === ts.SyntaxKind.MinusMinusToken) &&
+            targetsSym(n.operand)) {
+            written = true;
+            return;
+        }
+        if ((ts.isForInStatement(n) || ts.isForOfStatement(n)) &&
+            !ts.isVariableDeclarationList(n.initializer) &&
+            ts.isExpression(n.initializer) &&
+            targetsSym(n.initializer)) {
+            written = true;
+            return;
+        }
+        n.forEachChild(walk);
+    };
+    walk(body);
+    return written;
+}
+function broadPromiseParam(lowerer, type) {
+    const mapped = lowerer.mapTypeOf(type);
+    const arms = mapped?.kind === "union"
+        ? lowerer.unions.get(mapped.unionId)?.arms
+        : mapped === null
+            ? undefined
+            : [mapped];
+    return (!!arms &&
+        arms.some((arm) => arm.kind === "promise" && arm.inner.kind === "dyn") &&
+        arms.every((arm) => isUnitType(arm) || (arm.kind === "promise" && arm.inner.kind === "dyn")));
+}
+/** The implicit-type-parameter slots of a JS function-like: parallel to
+ * decl.parameters, the param SYMBOL where the slot is a bindable
+ * implicit param (identifier-named, broad inferred/JSDoc type, not
+ * rest/optional/defaulted, never written), null elsewhere. Package JS
+ * methods may also specialize class parameters: JSDoc names a nominal
+ * class even when the body accepts other objects with the same members.
+ * Null overall when nothing qualifies — the declaration keeps its ABI. */
+export function implicitAnyParamSymbolsOf(lowerer, decl, classParams = false) {
+    if (!decl.body)
+        return null;
+    if (decl.asteriskToken)
+        return null;
+    if (decl.modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword))
+        return null;
+    if (decl.typeParameters !== undefined)
+        return null; // real generics own the machinery
+    if (decl.parameters.length === 0)
+        return null;
+    // The variadic-`arguments` form keeps its dynRest story whole.
+    if (bodyReadsArguments(decl))
+        return null;
+    let hasImplicitParams = false;
+    const out = decl.parameters.map((param) => {
+        if (!ts.isIdentifier(param.name))
+            return null;
+        if (param.dotDotDotToken || param.questionToken || param.initializer)
+            return null;
+        if (param.name.text === "this")
+            return null;
+        const t = lowerer.typeOf(param.name);
+        const broadFunction = lowerer.checker.typeToString(t) === "Function";
+        const broadArray = lowerer.checkerAnyArrayType(t);
+        const broadPromise = broadPromiseParam(lowerer, t);
+        const declaredKind = classParams ? lowerer.mapTypeOf(t)?.kind : undefined;
+        const classParam = classParams && (declaredKind === "object" || declaredKind === "array");
+        if ((t.flags & ts.TypeFlags.Any) === 0 &&
+            !broadFunction &&
+            !broadArray &&
+            !broadPromise &&
+            !classParam)
+            return null;
+        const sym = lowerer.checker.getSymbolAtLocation(param.name);
+        if (!sym)
+            return null;
+        if (paramWrittenInBody(lowerer, decl.body, sym, param.name.text))
+            return null;
+        hasImplicitParams = true;
+        return sym;
+    });
+    return hasImplicitParams ? out : null;
+}
+/** The checker-fallback return type an implicit instance PROMISES before
+ * its body lowers: the declared/inferred return when it maps statically
+ * (JSDoc @returns, `void`, concrete inference the any-params didn't
+ * poison) — used as the expected return, no inference — or null, which
+ * selects return INFERENCE with DYN as the recursion pin. */
+function implicitDeclaredReturn(lowerer, info) {
+    try {
+        // Static JS helpers can accept a structurally compatible class despite
+        // narrower JSDoc (for example a Vector2 target documented as Vector3).
+        // Infer their result from the specialized body as well.
+        if (info.member?.kind === "static" &&
+            info.decl.parameters.some((param, index) => info.implicitParams?.[index] &&
+                lowerer.mapTypeOf(lowerer.typeOf(param.name))?.kind === "object"))
+            return null;
+        const broadCallbackSymbols = new Set(info.decl.parameters.flatMap((param, index) => {
+            const symbol = info.implicitParams?.[index];
+            return symbol !== null &&
+                symbol !== undefined &&
+                lowerer.checker.typeToString(lowerer.typeOf(param.name)) === "Function"
+                ? [symbol]
+                : [];
+        }));
+        let returnsBroadCallback = false;
+        if (broadCallbackSymbols.size > 0 && info.decl.body !== undefined) {
+            ts.walkPreorder(info.decl.body, (node) => {
+                if (node !== info.decl.body && ts.isFunctionLike(node))
+                    return "skip";
+                if (!ts.isReturnStatement(node) || node.expression === undefined)
+                    return undefined;
+                let expression = node.expression;
+                while (ts.isParenthesizedExpression(expression))
+                    expression = expression.expression;
+                if (ts.isCallExpression(expression) &&
+                    ts.isIdentifier(expression.expression) &&
+                    (() => {
+                        const symbol = lowerer.checker.getSymbolAtLocation(expression.expression);
+                        return symbol !== undefined && broadCallbackSymbols.has(symbol);
+                    })()) {
+                    returnsBroadCallback = true;
+                    return "stop";
+                }
+                return undefined;
+            });
+        }
+        if (returnsBroadCallback)
+            return null;
+        const declSig = lowerer.checker.getSignatureFromDeclaration(info.decl);
+        if (!declSig)
+            return null;
+        const retTs = lowerer.checker.getReturnTypeOfSignature(declSig);
+        if (retTs.flags & ts.TypeFlags.Any)
+            return null;
+        if (retTs.flags & (ts.TypeFlags.Null | ts.TypeFlags.Undefined))
+            return DYN;
+        if (lowerer.checker.isArrayType(retTs)) {
+            // Inferred JavaScript arrays can hold values selected through a
+            // mutable constructor registry. The checker may retain only one
+            // constructor's element type; settle the result from the lowered
+            // container instead of checking every element against that guess.
+            if (!hasExplicitJsDocReturn(info.decl))
+                return null;
+            if (info.decl.parameters.some((param, index) => info.implicitParams?.[index] &&
+                lowerer.mapTypeOf(lowerer.typeOf(param.name))?.kind === "array"))
+                return null;
+            const elem = lowerer.checker.getTypeArguments(retTs)[0];
+            // An implicit-any parameter poisons an inferred array result to
+            // any[] even when this instance's body produces one concrete
+            // element type (`knownBy(cmd)` in commander). Let the existing
+            // lowered-return unifier recover that type. Explicit unknown[]
+            // remains a declared checked-dynamic contract and stays pinned.
+            if (elem && (elem.flags & ts.TypeFlags.Any) !== 0)
+                return null;
+        }
+        const mapped = lowerer.mapTypeOf(retTs);
+        // Mixed inferred results can select a closure or a class instance.
+        // Their callable ABI is settled by the lowered body, including native
+        // classes whose reflected calls return checked values.
+        if (mapped?.kind === "union" &&
+            !hasExplicitJsDocReturn(info.decl) &&
+            lowerer.unions.get(mapped.unionId)?.arms.some((arm) => arm.kind === "func"))
+            return null;
+        if (mapped?.kind === "symbol" && !hasExplicitJsDocReturn(info.decl))
+            return null;
+        if (mapped?.kind === "date" && !hasExplicitJsDocReturn(info.decl))
+            return DYN;
+        if (!hasExplicitJsDocReturn(info.decl) && info.decl.body) {
+            let openReturn = false;
+            ts.walkPreorder(info.decl.body, (node) => {
+                if (node !== info.decl.body && ts.isFunctionLike(node))
+                    return "skip";
+                if (!ts.isReturnStatement(node) || !node.expression || !ts.isIdentifier(node.expression))
+                    return undefined;
+                const symbol = lowerer.resolveValueSymbol(node.expression);
+                if (symbol &&
+                    lowerer.checker
+                        .declarationsOf(symbol)
+                        .some((decl) => ts.isVariableDeclaration(decl) && jsBindingHasOpenWrites(lowerer, decl)))
+                    openReturn = true;
+                return undefined;
+            });
+            if (openReturn)
+                return null;
+        }
+        // A JavaScript result inferred from an initial record can later
+        // carry additional fields. Settle its representation from the
+        // lowered returns instead of copying it back into that initial shape.
+        const resultArms = mapped?.kind === "union" ? lowerer.unions.get(mapped.unionId)?.arms : mapped ? [mapped] : [];
+        if (resultArms?.some((arm) => arm.kind === "record" || arm.kind === "object" || arm.kind === "classval") &&
+            resultArms.every((arm) => isUnitType(arm) ||
+                arm.kind === "record" ||
+                arm.kind === "object" ||
+                arm.kind === "classval") &&
+            !hasExplicitJsDocReturn(info.decl))
+            return null;
+        // Inferred variadic results carry runtime argument packs. Their
+        // factory must retain the lowered callable rather than extracting a
+        // fixed native signature from a checked value.
+        if (mapped?.kind === "func" &&
+            mapped.rest === true &&
+            mapped.restAbi === undefined &&
+            !hasExplicitJsDocReturn(info.decl))
+            return null;
+        if (mapped !== null && promiseCarriesDyn(lowerer, mapped) && !hasExplicitJsDocReturn(info.decl))
+            return null;
+        return mapped;
+    }
+    catch (e) {
+        if (!(e instanceof PoisonError))
+            throw e;
+        return null;
+    }
+}
+/** True when a `this.method(...)` call targets an implicit npm-static
+ * method whose result is settled from its lowered body rather than the
+ * checker declaration. Uninitialized-local inference uses this to avoid
+ * freezing an evolving `any` slot to stale JSDoc. */
+export function implicitMethodCallInfersReturn(lowerer, call) {
+    if (!ts.isPropertyAccessExpression(call.expression) ||
+        call.expression.expression.kind !== ts.SyntaxKind.ThisKeyword ||
+        lowerer.currentClass === null) {
+        return false;
+    }
+    const found = findGenericMethodOn(lowerer, lowerer.currentClass, call.expression.name.text);
+    return (found?.info.implicitParams !== undefined && implicitDeclaredReturn(lowerer, found.info) === null);
+}
+/** True when an IR type may BIND an implicit param (a concrete static
+ * type — the checked-dynamic kinds keep the dyn slot, units have no
+ * standalone representation). */
+function bindableImplicitIr(t) {
+    return (t !== null &&
+        t.kind !== "void" &&
+        t.kind !== "dyn" &&
+        t.kind !== "jsval" &&
+        t.kind !== "caught" &&
+        t.kind !== "undefinedT" &&
+        t.kind !== "nullT");
+}
+/** A represented binding or direct callable result can be wider than the
+ * checker's inferred shape. Preserve that boundary when specializing JS. */
+function storedImplicitArgumentType(lowerer, arg) {
+    while (ts.isParenthesizedExpression(arg))
+        arg = arg.expression;
+    if (isJsSourceFile(arg.getSourceFile()) &&
+        (ts.isArrowFunction(arg) || ts.isFunctionExpression(arg))) {
+        const saved = lowerer.diagSink;
+        const diagnostics = [];
+        lowerer.diagSink = diagnostics;
+        let value;
+        try {
+            value = tryLowerExpression(lowerer, arg);
+        }
+        finally {
+            lowerer.diagSink = saved;
+        }
+        // Direct inferred helpers can receive native callbacks even when their
+        // result is an opaque handle that cannot cross checked storage.
+        if (diagnostics.length === 0 && value?.type.kind === "func")
+            return value.type;
+    }
+    if (arg.kind === ts.SyntaxKind.ThisKeyword)
+        return lowerer.resolveThis()?.type ?? null;
+    if (ts.isAwaitExpression(arg)) {
+        const awaited = storedImplicitArgumentType(lowerer, arg.expression);
+        return awaited?.kind === "promise" ? awaited.inner : awaited;
+    }
+    if (ts.isObjectLiteralExpression(arg) &&
+        isJsSourceFile(arg.getSourceFile()) &&
+        (arg.properties.length === 0 ||
+            arg.properties.some((property) => ts.isMethodDeclaration(property) ||
+                ts.isAccessor(property) ||
+                (!ts.isSpreadAssignment(property) &&
+                    property.name !== undefined &&
+                    ts.isComputedPropertyName(property.name)))))
+        return DYN;
+    if (ts.isIdentifier(arg))
+        return lowerer.peekLocal(arg)?.type ?? lowerer.globalOf(arg)?.type ?? null;
+    if (isJsSourceFile(arg.getSourceFile()) &&
+        (ts.isPropertyAccessExpression(arg) || ts.isElementAccessExpression(arg))) {
+        // Mutable JS members can retain an initializer-only checker type (for
+        // example a linked-list slot initially null). Specialize to the value
+        // we actually represent, rather than checking it back into that type.
+        const represented = tryLowerExpression(lowerer, arg);
+        if (represented)
+            return represented.type;
+    }
+    if (isJsSourceFile(arg.getSourceFile()) &&
+        (ts.isCallExpression(arg) ||
+            ts.isConditionalExpression(arg) ||
+            (ts.isBinaryExpression(arg) &&
+                (arg.operatorToken.kind === ts.SyntaxKind.BarBarToken ||
+                    arg.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken ||
+                    arg.operatorToken.kind === ts.SyntaxKind.QuestionQuestionToken)))) {
+        // Calls and fallback expressions can retain checked storage wider than
+        // the checker's inference (for example Object.assign on a JS instance).
+        const represented = tryLowerExpression(lowerer, arg);
+        if (represented?.type.kind === "dyn" || represented?.type.kind === "func")
+            return represented.type;
+    }
+    if (ts.isCallExpression(arg) && ts.isIdentifier(arg.expression)) {
+        const callee = storedImplicitArgumentType(lowerer, arg.expression);
+        if (callee?.kind === "dyn")
+            return DYN;
+        if (callee?.kind === "func")
+            return callee.ret;
+        return lowerer.fnSigOf(arg.expression)?.returnType ?? null;
+    }
+    return null;
+}
+/** The instance a CALL of an implicit-any function-like names: each
+ * bindable implicit param takes the call's WIDENED argument checker type
+ * when it maps statically (DYN otherwise — today's slot), typed params
+ * keep their declared shapes, and the param-type tuple is the
+ * instantiation key. New keys lower EAGERLY (return inference — see the
+ * section comment); a same-key re-demand mid-lowering pins the fallback
+ * return type. */
+export function implicitCallInstance(lowerer, call, info) {
+    const shapes = [];
+    const argTypes = new Map();
+    info.decl.parameters.forEach((param, i) => {
+        const sym = info.implicitParams[i];
+        if (!sym) {
+            shapes.push(lowerer.paramShape(param));
+            return;
+        }
+        let bound = DYN;
+        const declared = lowerer.paramShape(param);
+        if ((lowerer.typeOf(param.name).flags & ts.TypeFlags.Any) === 0)
+            bound = declared.type;
+        const arg = call.arguments[i];
+        if (arg && !ts.isSpreadElement(arg)) {
+            const stored = storedImplicitArgumentType(lowerer, arg);
+            if (stored?.kind === "dyn") {
+                bound = DYN;
+                argTypes.set(sym, lowerer.checker.getUnknownType());
+                shapes.push({ type: bound, mode: "required" });
+                return;
+            }
+            // A represented native array must keep its storage when a direct
+            // inferred helper receives it. Re-boxing a checker-any array would
+            // copy it, losing writes (and attempting to read unfilled slots).
+            if (stored?.kind === "array") {
+                argTypes.set(sym, lowerer.typeOf(arg));
+                shapes.push({ type: stored, mode: "required" });
+                return;
+            }
+            if (stored?.kind === "func") {
+                // The lowered closure may have an inferred JS destructuring
+                // parameter widened from the checker's exact tuple to dyn.
+                // Preserve that signature throughout the specialization.
+                const checkerType = lowerer.mapTypeOf(lowerer.typeOf(arg));
+                argTypes.set(sym, checkerType && typeEquals(checkerType, stored)
+                    ? lowerer.typeOf(arg)
+                    : lowerer.checker.getUnknownType());
+                shapes.push({ type: stored, mode: "required" });
+                return;
+            }
+            // The argument's own checker type, literal-widened ('add' binds
+            // string) — typeOf consults the ACTIVE instance's bindings, so a
+            // bound param forwarded into another implicit call transitively
+            // instantiates it (this._initCommandGroup(command)).
+            const t = lowerer.checker.getBaseTypeOfLiteralType(lowerer.typeOf(arg));
+            const mapped = (neverTaintedJsType(lowerer, arg, t) ? null : lowerer.mapTypeOf(t)) ??
+                dynFallbackType(lowerer, arg, t);
+            if (isJsSourceFile(arg.getSourceFile()) &&
+                ts.isArrayLiteralExpression(arg) &&
+                mapped?.kind === "array" &&
+                (mapped.elem.kind === "classval" ||
+                    (mapped.elem.kind === "union" &&
+                        lowerer.unions.get(mapped.elem.unionId)?.arms.every((arm) => arm.kind === "classval")))) {
+                argTypes.set(sym, lowerer.checker.getUnknownType());
+                shapes.push({ type: DYN, mode: "required" });
+                return;
+            }
+            // JavaScript arguments-based callables travel as checked functions.
+            // Specializing a parameter to the inferred rest signature would
+            // require extracting a native variadic ABI that the value does not
+            // expose. Its checked invocation preserves the complete argument pack.
+            if (mapped?.kind === "func" && mapped.rest === true && mapped.restAbi === undefined) {
+                argTypes.set(sym, lowerer.checker.getUnknownType());
+                shapes.push({ type: DYN, mode: "required" });
+                return;
+            }
+            // JS inference can absorb heterogeneous loop values into `{}`.
+            // That checker supertype is not an empty-record runtime layout:
+            // preserve represented arms through the checked boundary instead
+            // of specializing a call to a union that would discard them.
+            if (isJsSourceFile(arg.getSourceFile()) &&
+                mapped?.kind === "func" &&
+                !lowerer.dynConvertible(mapped)) {
+                argTypes.set(sym, lowerer.checker.getUnknownType());
+                shapes.push({ type: DYN, mode: "required" });
+                return;
+            }
+            const mappedArms = mapped?.kind === "union"
+                ? (lowerer.unions.get(mapped.unionId)?.arms ?? [])
+                : mapped
+                    ? [mapped]
+                    : [];
+            const hasTopObject = mappedArms.some((arm) => {
+                const shape = arm.kind === "record" ? lowerer.shapes.get(arm.shapeId) : undefined;
+                return shape && !shape.tuple && !shape.indexValue && shape.fields.length === 0;
+            });
+            if (stored?.kind === "union" &&
+                hasTopObject &&
+                lowerer.dynConvertible(stored) &&
+                lowerer.unions
+                    .get(stored.unionId)
+                    ?.arms.some((arm) => !isUnitType(arm) &&
+                    !mappedArms.some((target) => lowerer.widthLiftPlan(arm, target) !== null))) {
+                argTypes.set(sym, lowerer.checker.getUnknownType());
+                shapes.push({ type: DYN, mode: "required" });
+                return;
+            }
+            if (ts.isArrowFunction(arg) &&
+                arg.type === undefined &&
+                mapped?.kind === "func" &&
+                promiseCarriesDyn(lowerer, mapped.ret)) {
+                bound = { ...mapped, ret: DYN };
+                lowerer.runtimeOptionalFunctionReturns.set(arg, DYN);
+                argTypes.set(sym, t);
+            }
+            else if (mapped?.kind === "dyn") {
+                bound = DYN;
+                argTypes.set(sym, t);
+            }
+            else if (bindableImplicitIr(mapped)) {
+                bound = mapped;
+                argTypes.set(sym, t);
+            }
+        }
+        shapes.push({ type: bound, mode: "required" });
+    });
+    return internImplicitInstance(lowerer, call, info, shapes, argTypes);
+}
+/** The all-dyn DEFAULT instance — today's compiled body exactly: what a
+ * VALUE reference of an implicit-any function names (indirect calls
+ * carry no per-site types to bind). */
+export function implicitDefaultInstance(lowerer, blame, info) {
+    const shapes = info.decl.parameters.map((param, i) => info.implicitParams[i] ? { type: DYN, mode: "required" } : lowerer.paramShape(param));
+    const argTypes = new Map();
+    // Newly bindable nominal class parameters must not retain their JSDoc
+    // receiver type in the checked fallback. Keep existing broad JS inference.
+    for (let i = 0; i < info.decl.parameters.length; i++) {
+        const symbol = info.implicitParams?.[i];
+        const kind = lowerer.mapTypeOf(lowerer.typeOf(info.decl.parameters[i].name))?.kind;
+        if (symbol && (kind === "object" || kind === "array")) {
+            argTypes.set(symbol, lowerer.checker.getUnknownType());
+        }
+    }
+    return internImplicitInstance(lowerer, blame, info, shapes, argTypes);
+}
+function internImplicitInstance(lowerer, blame, info, shapes, argTypes) {
+    const key = shapes.map((s) => typeKey(s.type)).join(",");
+    let inst = info.instances.get(key);
+    if (inst?.implicitState === "failed")
+        lowerer.unsupported("SC1090", blame, `the failed specialization of '${info.baseName}'`);
+    if (inst) {
+        // A recursive caller has observed this ABI before inference settles.
+        // Keep the promised return slot and coerce the completed body's returns.
+        if (inst.implicitState === "lowering")
+            inst.returnPinned = true;
+        return inst;
+    }
+    if (info.instances.size >= MAX_GENERIC_INSTANCES) {
+        lowerer.unsupported("SC1090", blame, `unbounded implicit-any instantiation ('${info.baseName}' exceeded ` +
+            `${MAX_GENERIC_INSTANCES} instances — polymorphic recursion?)`);
+    }
+    const rendered = shapes.map((s) => lowerer.fmt(s.type)).join(", ");
+    const dynamicBroadPromise = info.decl.parameters.some((param, index) => info.implicitParams?.[index] !== null &&
+        info.implicitParams?.[index] !== undefined &&
+        shapes[index]?.type.kind === "dyn" &&
+        broadPromiseParam(lowerer, lowerer.typeOf(param.name)));
+    const declared = dynamicBroadPromise ? null : implicitDeclaredReturn(lowerer, info);
+    inst = {
+        name: `${info.qualifiedName}%${info.instances.size}`,
+        ordinal: info.instances.size,
+        params: shapes,
+        // The promise callers rely on before the body settles it: the
+        // declared truth when it maps, else DYN (the recursion pin — and
+        // exactly today's checked-dynamic result slot).
+        returnType: declared ?? DYN,
+        bindings: new Map(),
+        typeArgsText: `(${rendered.length > 80 ? rendered.slice(0, 77) + "..." : rendered})`,
+        implicitArgTypes: argTypes,
+        implicitState: "lowering",
+        ...(declared === null ? { implicitInferReturn: true } : {}),
+    };
+    info.instances.set(key, inst);
+    // Eager lowering settles the return ABI before callers use it. A failed
+    // JS body must still have a throwing implementation: later references
+    // (including recursive ones) can already hold its cached signature.
+    const diagsBefore = lowerer.diags.length;
+    // The instance is cached even when a receiver probe requested it.
+    // Its body must retain statement fences instead of dropping failures
+    // into that probe's temporary diagnostic sink and caching empty code.
+    const previousSink = lowerer.diagSink;
+    lowerer.diagSink = null;
+    try {
+        // Implicit-any instances lower EAGERLY at the call site so their
+        // inferred return type is available immediately. They therefore do
+        // not pass through emitReachable's queued generic-instance wave,
+        // which normally batches checker work before lowering a body. Prime
+        // this exact committed instance body here; repeated instantiations of
+        // the same declaration find the facade memos warm.
+        lowerer.checker.prefetchRoots([
+            ...info.decl.parameters.flatMap((param) => (param.initializer ? [param.initializer] : [])),
+            ...(info.decl.body ? [info.decl.body] : []),
+        ]);
+        const fn = lowerer.lowerGenericInstance(info, inst);
+        lowerer.implicitFns.push(fn);
+    }
+    catch (e) {
+        if (!(e instanceof PoisonError))
+            throw e;
+        inst.implicitState = "failed";
+        const types = shapes.map((shape) => shape.type);
+        if (info.member?.kind === "method")
+            types.unshift({ kind: "object", className: info.member.cls.def.name });
+        const fn = lowerer.deferToRuntimeFence(diagsBefore, info.decl, {
+            kind: "function",
+            name: inst.name,
+            returnType: inst.returnType,
+            params: types.map((type, index) => ({ localId: `p.${index}`, name: `p${index}`, type })),
+        });
+        if (!fn)
+            throw e;
+        lowerer.implicitFns.push(fn);
+    }
+    finally {
+        lowerer.diagSink = previousSink;
+    }
+    inst.implicitState = "done";
+    return inst;
+}
+/** The implicit-any twin of bindingGenericFnNodeOf, for LOCAL and module
+ * bindings alike (`const knownBy = (cmd) => [cmd.name()].concat(...)`
+ * inside a method body — commander's _registerCommand shape): the
+ * initializer function-like when the WHOLE declaration qualifies for
+ * implicit monomorphization, else null — non-qualifying shapes keep
+ * today's closure story silently (never a fence: the flag must not make
+ * working code worse). Qualification: an npm-static JS file, a const (or
+ * never-reassigned, never-redeclared) identifier binding, an
+ * arrow/function-expression initializer with bindable implicit-any
+ * params, and a body with NO captures — no `this`/`super`, and no
+ * reference to a function-scoped declaration outside itself (compiled
+ * instances are module functions; module-scope references are fine).
+ * Cached per declaration on lowerer.implicitLocalFns. */
+export function implicitLocalFnNodeOf(lowerer, decl) {
+    const cached = lowerer.implicitLocalFns.get(decl);
+    if (cached !== undefined)
+        return cached ? cached.decl : null;
+    const probe = () => {
+        if (!implicitMonoFile(decl.getSourceFile()))
+            return null;
+        if (!ts.isIdentifier(decl.name) || decl.initializer === undefined)
+            return null;
+        let init = decl.initializer;
+        while (ts.isParenthesizedExpression(init))
+            init = init.expression;
+        if (!ts.isArrowFunction(init) && !ts.isFunctionExpression(init))
+            return null;
+        if (init.typeParameters !== undefined || init.body === undefined)
+            return null;
+        if (!implicitAnyParamSymbolsOf(lowerer, init))
+            return null;
+        const sym = lowerer.checker.getSymbolAtLocation(decl.name);
+        if (!sym)
+            return null;
+        const isConst = (ts.getCombinedNodeFlags(decl) & ts.NodeFlags.Const) !== 0;
+        const redeclared = lowerer.checker
+            .declarationsOf(sym)
+            .some((d) => d !== decl && ts.isVariableDeclaration(d) && d.initializer !== undefined);
+        if (redeclared)
+            return null;
+        if (!isConst && !bindingNeverReassigned(lowerer, sym, decl))
+            return null;
+        // The capture scan: instances are module functions with no frame.
+        let captures = false;
+        const scan = (n) => {
+            if (captures)
+                return;
+            if (n.kind === ts.SyntaxKind.ThisKeyword || n.kind === ts.SyntaxKind.SuperKeyword) {
+                // Arrow bodies see the ENCLOSING this; function expressions
+                // rebind their own — but a bare `this` there is untyped JS
+                // dynamism either way. Reject both, cheaply and soundly.
+                captures = true;
+                return;
+            }
+            if (ts.isIdentifier(n)) {
+                const s = lowerer.checker.getSymbolAtLocation(n);
+                const d = s ? lowerer.checker.valueDeclarationOf(s) : undefined;
+                if (d &&
+                    d.getSourceFile() === decl.getSourceFile() &&
+                    !(d.pos >= init.pos && d.end <= init.end)) {
+                    // Declared outside the initializer, in this file: a capture
+                    // exactly when some enclosing FUNCTION scope declares it —
+                    // module-scope declarations are reachable from any module
+                    // function.
+                    for (let p = d.parent; p !== undefined && !ts.isSourceFile(p); p = p.parent) {
+                        if (ts.isFunctionLike(p)) {
+                            captures = true;
+                            return;
+                        }
+                    }
+                }
+            }
+            n.forEachChild(scan);
+        };
+        scan(init.body);
+        return captures ? null : init;
+    };
+    const node = probe();
+    if (node === null) {
+        lowerer.implicitLocalFns.set(decl, null);
+        return null;
+    }
+    return node;
+}
+/** Registers (or returns) the GenericFnInfo of a qualifying implicit-any
+ * function-value binding — implicitLocalFnNodeOf's companion, the
+ * bindingGenericFnInfoOf shape: the info enters genericFnsBySymbol under
+ * the binding's symbol (and a named function expression's inner name),
+ * so calls and value references resolve through genericFnOf; the
+ * declaration statement emits nothing and the binding has no runtime
+ * value. The declaration's source position joins the qualified name —
+ * two same-named locals in one file stay distinct. */
+export function implicitLocalFnInfoOf(lowerer, decl, fnNode) {
+    const existing = lowerer.implicitLocalFns.get(decl);
+    if (existing)
+        return existing;
+    const name = decl.name.text;
+    const sym = lowerer.checker.getSymbolAtLocation(decl.name);
+    if (!sym)
+        lowerer.unsupported("SC1090", decl.name, "this binding form");
+    const implicit = implicitAnyParamSymbolsOf(lowerer, fnNode);
+    if (!implicit)
+        lowerer.unsupported("SC1090", fnNode, "this function form"); // defensive: the probe proved it
+    const stmt = decl.parent?.parent;
+    const info = {
+        decl: fnNode,
+        baseName: name,
+        qualifiedName: lowerer.qualify(decl.getSourceFile(), nsPathPrefix(stmt ?? decl, decl) + `${name}%l${decl.getStart()}`),
+        typeParams: [],
+        instances: new Map(),
+        implicitParams: implicit,
+    };
+    lowerer.implicitLocalFns.set(decl, info);
+    lowerer.genericFnsBySymbol.set(sym, info);
+    if (ts.isFunctionExpression(fnNode) && fnNode.name !== undefined) {
+        const inner = lowerer.checker.getSymbolAtLocation(fnNode.name);
+        if (inner)
+            lowerer.genericFnsBySymbol.set(inner, info);
+    }
+    return info;
+}
+/** The function-like node behind an object-literal generic-method member:
+ * the MethodDeclaration itself (`{ m<T>(x: T) {...} }`) or a generic
+ * arrow/function-expression property's initializer (`{ m: <T>(x: T) =>
+ * ... }`). Null when the property's declaration isn't that shape. */
+export function objLitGenericFnNodeOf(lowerer, propSym) {
+    const decl = lowerer.checker.valueDeclarationOf(propSym);
+    if (!decl)
+        return null;
+    if (ts.isMethodDeclaration(decl) && ts.isObjectLiteralExpression(decl.parent)) {
+        return decl.typeParameters !== undefined && decl.body !== undefined
+            ? { fnNode: decl, literal: decl.parent }
+            : null;
+    }
+    if (ts.isPropertyAssignment(decl) && ts.isObjectLiteralExpression(decl.parent)) {
+        let init = decl.initializer;
+        while (ts.isParenthesizedExpression(init))
+            init = init.expression;
+        if ((ts.isArrowFunction(init) || ts.isFunctionExpression(init)) &&
+            init.typeParameters !== undefined &&
+            init.body !== undefined) {
+            return { fnNode: init, literal: decl.parent };
+        }
+    }
+    return null;
+}
+/** The interned GenericFnInfo for one object-literal generic method, with
+ * the supportability fences applied ONCE per declaration: the defining
+ * literal must sit at module scope (the compiled instance is a plain
+ * module function — an enclosing frame would need captures), and
+ * async/generator forms keep the method fences. The name is source-
+ * position-derived (`%ol<start>.<name>`, qualified per file) —
+ * deterministic across the discovery and emit passes. */
+export function objLitGenericFnInfoOf(lowerer, blame, name, found) {
+    const { fnNode, literal } = found;
+    const existing = lowerer.objLitGenericFns.get(fnNode);
+    if (existing)
+        return existing;
+    if (fnNode.asteriskToken)
+        lowerer.unsupported("SC1071", blame);
+    if (fnNode.modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword)) {
+        lowerer.unsupported("SC1090", blame, "async object-literal generic methods");
+    }
+    // `this` is the receiver object — records don't model it (the
+    // lowerObjectLiteral fence, applied at registration because
+    // arrow/function-expression properties skip that walk and the compiled
+    // instances are plain module functions).
+    if (fnNode.body)
+        lowerer.rejectThisInObjectMethod(fnNode.body);
+    for (let n = literal.parent; n && !ts.isSourceFile(n); n = n.parent) {
+        if (ts.isFunctionLike(n)) {
+            lowerer.unsupported("SC1090", blame, `object-literal generic methods declared inside functions (the compiled instantiations of '${name}' are module functions and cannot capture the enclosing frame — declare the object at module scope)`);
+        }
+    }
+    const typeParams = declaredTypeParameterSymbols(lowerer, fnNode.typeParameters, blame, "this method form");
+    checkGenericParameterNames(lowerer, fnNode.parameters, false);
+    const info = {
+        decl: fnNode,
+        baseName: name,
+        qualifiedName: lowerer.qualify(fnNode.getSourceFile(), `%ol${fnNode.getStart()}.${name}`),
+        typeParams,
+        instances: new Map(),
+        objectLiteral: true,
+    };
+    lowerer.objLitGenericFns.set(fnNode, info);
+    return info;
+}
+/** The generic function-like INITIALIZER behind a binding declaration —
+ * `const f = <T>(x: T) => x` or `const f = function g<T>(x: T) {...}`
+ * (parens stripped). Null when the declaration isn't that shape; the
+ * SHAPE only — whether the binding qualifies (module scope, never
+ * reassigned) is bindingGenericFnInfoOf's business. */
+export function bindingGenericFnNodeOf(decl) {
+    if (!ts.isIdentifier(decl.name) || decl.initializer === undefined)
+        return null;
+    // Assertion wrappers strip like parens: `const r = (<T>(x: T) => x) as
+    // Mapper` evaluates the arrow — the cast only renames its type.
+    const init = stripValueWrappers(decl.initializer);
+    if ((ts.isArrowFunction(init) || ts.isFunctionExpression(init)) &&
+        init.typeParameters !== undefined &&
+        init.body !== undefined) {
+        return init;
+    }
+    return null;
+}
+/** The CONTEXTUAL twin of bindingGenericFnNodeOf: `const g: Mapper = (x)
+ * => x` where `type Mapper = <T>(x: T) => T` — the initializer declares
+ * no type parameters of its own, but the ANNOTATION's one call signature
+ * does, and the checker types the arrow's parameters by those (`x: T`).
+ * Such a binding monomorphizes exactly like `const g = <T>(x: T) => x`;
+ * bindingGenericFnInfoOf reads the type parameters off the annotation's
+ * signature. Null when the shape doesn't match (a concrete annotation, a
+ * generic arrow — the syntactic probe's case, an overloaded alias). */
+export function bindingContextualGenericFnNodeOf(lowerer, decl) {
+    if (!ts.isIdentifier(decl.name) || decl.initializer === undefined)
+        return null;
+    // The generic signature can arrive as an ANNOTATION or as a type
+    // ASSERTION on the initializer (`var r = < <T>(x: T) => T >((x) => x)`
+    // — the checker contextually types the operand's parameters by the
+    // asserted signature exactly like an annotation would).
+    const asserted = ts.isAsExpression(decl.initializer) || ts.isTypeAssertion(decl.initializer);
+    if (decl.type === undefined && !asserted)
+        return null;
+    const init = stripValueWrappers(decl.initializer);
+    if (!(ts.isArrowFunction(init) || ts.isFunctionExpression(init)) ||
+        init.typeParameters !== undefined ||
+        init.body === undefined) {
+        return null;
+    }
+    const sigs = lowerer.checker.getCallSignatures(lowerer.typeOf(decl.name));
+    if (sigs.length !== 1 || sigs[0].getTypeParameters().length === 0)
+        return null;
+    return init;
+}
+/** The interned GenericFnInfo for one generic arrow/function-expression
+ * binding initializer, with the supportability fences applied ONCE per
+ * declaration: the binding must sit at module scope (the compiled
+ * instances are plain module functions — an enclosing frame would need
+ * captures) and must provably HOLD the initializer once initialized — a
+ * const, or a let/var nothing in its declaring file ever writes (ESM
+ * import bindings are read-only, so the file scan is the whole story;
+ * observing the UNINITIALIZED state needs a hoisted early call, the
+ * same temporal hole const TDZ leaves — the object-literal generic-
+ * method receiver stance). Successful registration enters the info
+ * in genericFnsBySymbol under the binding's symbol — and under a named
+ * function expression's own inner name (it binds itself inside the
+ * body, the class-expression rule) — so every genericFnOf consumer
+ * (calls, pinned values, instantiation expressions, namespace and CJS
+ * member paths) resolves it like a top-level generic declaration. */
+export function bindingGenericFnInfoOf(lowerer, decl, fnNode) {
+    const existing = lowerer.bindingGenericFns.get(fnNode);
+    if (existing)
+        return existing;
+    const name = decl.name.text;
+    if (fnNode.asteriskToken)
+        lowerer.unsupported("SC1071", fnNode);
+    for (let n = decl.parent; n !== undefined && !ts.isSourceFile(n); n = n.parent) {
+        if (ts.isFunctionLike(n)) {
+            lowerer.unsupported("SC1090", fnNode, `generic arrow/function-expression bindings declared inside functions (the compiled instantiations of '${name}' are module functions and cannot capture the enclosing frame — declare the binding at module scope)`);
+        }
+    }
+    const sym = lowerer.checker.getSymbolAtLocation(decl.name);
+    if (!sym)
+        lowerer.unsupported("SC1090", decl.name, "this binding form");
+    requireStableGenericBinding(lowerer, decl, sym, name);
+    const typeParams = [];
+    if (fnNode.typeParameters !== undefined) {
+        typeParams.push(...declaredTypeParameterSymbols(lowerer, fnNode.typeParameters, fnNode, "this function form"));
+    }
+    else {
+        // The CONTEXTUAL shape (bindingContextualGenericFnNodeOf): the type
+        // parameters live on the annotation's one call signature, and the
+        // checker types the initializer's parameters by them — the same
+        // symbols the instance bodies resolve through.
+        const sigs = lowerer.checker.getCallSignatures(lowerer.typeOf(decl.name));
+        const tps = sigs.length === 1 ? sigs[0].getTypeParameters() : [];
+        if (tps.length === 0)
+            lowerer.unsupported("SC1090", fnNode, "this function form");
+        for (const tp of tps) {
+            const tpSym = tp.getSymbol();
+            if (!tpSym)
+                lowerer.unsupported("SC1090", fnNode, "this function form");
+            typeParams.push(tpSym);
+        }
+    }
+    checkGenericParameterNames(lowerer, fnNode.parameters, true);
+    const stmt = decl.parent?.parent; // declarator → list → statement (nsPathPrefix wants the statement)
+    const info = {
+        decl: fnNode,
+        baseName: name,
+        qualifiedName: lowerer.qualify(decl.getSourceFile(), nsPathPrefix(stmt ?? decl, decl) + name),
+        typeParams,
+        instances: new Map(),
+    };
+    lowerer.bindingGenericFns.set(fnNode, info);
+    lowerer.genericFnsBySymbol.set(sym, info);
+    if (ts.isFunctionExpression(fnNode) && fnNode.name !== undefined) {
+        const inner = lowerer.checker.getSymbolAtLocation(fnNode.name);
+        if (inner)
+            lowerer.genericFnsBySymbol.set(inner, info);
+    }
+    return info;
+}
+/** `const h = id` — a binding ALIASING a generic function (a top-level
+ * declaration, a registered generic binding, or another alias — resolved
+ * left to right in declaration order). The alias registers the SAME info
+ * under its own symbol, so calls (`h(3)`) and pinned values (`take(h)`)
+ * resolve exactly like the target's own name, and the binding itself has
+ * no runtime value (a generic function value cannot materialize). Claims
+ * only bindings whose OWN type still keeps type parameters — a
+ * concrete-annotated alias (`const h: (x: number) => number = id`) is a
+ * pinned VALUE, the existing lowerGenericFnValue story. Null when the
+ * shape doesn't match or the target isn't a registered generic; fences
+ * (reassignment, var redeclaration) report by name inside. */
+export function bindingGenericFnAliasInfoOf(lowerer, decl) {
+    if (!ts.isIdentifier(decl.name) || decl.initializer === undefined)
+        return null;
+    let init = decl.initializer;
+    while (ts.isParenthesizedExpression(init))
+        init = init.expression;
+    if (!ts.isIdentifier(init))
+        return null;
+    const target = genericFnOf(lowerer, init);
+    if (!target)
+        return null;
+    // A concrete annotation pins one signature — that value story
+    // (lowerGenericFnValue at the reference) stays untouched.
+    const ownSigs = lowerer.checker.getCallSignatures(lowerer.typeOf(decl.name));
+    if (ownSigs.length === 0 || !ownSigs.every((s) => s.getTypeParameters().length > 0))
+        return null;
+    const sym = lowerer.checker.getSymbolAtLocation(decl.name);
+    if (!sym)
+        return null;
+    const existing = lowerer.genericFnsBySymbol.get(sym);
+    if (existing)
+        return existing;
+    const name = decl.name.text;
+    requireStableGenericBinding(lowerer, decl, sym, name);
+    lowerer.genericFnsBySymbol.set(sym, target);
+    return target;
+}
+/** Static resolution stands in for the receiver's runtime value, so an
+ * object-literal generic-method receiver must provably HOLD the defining
+ * literal: a direct read of a binding whose initializer IS that literal
+ * and that nothing ever reassigns — a const, or a let with no write in
+ * its declaring file (ESM import bindings are read-only, so the file
+ * scan is the whole story). The read is pure — call and value sites skip
+ * evaluating it entirely. A reassignable binding could hold a
+ * structurally identical literal with a DIFFERENT body, which static
+ * resolution would silently miss. */
+export function requireObjLitGenericReceiver(lowerer, blame, recvExpr, literal, name) {
+    let recv = recvExpr;
+    while (ts.isParenthesizedExpression(recv))
+        recv = recv.expression;
+    const fenceReceiver = () => lowerer.unsupported("SC1090", blame, `reaching the object-literal generic method '${name}' through this receiver (resolution is static, so the receiver must be a never-reassigned binding initialized with the defining literal)`);
+    if (!ts.isIdentifier(recv))
+        fenceReceiver();
+    const recvSym = lowerer.resolveValueSymbol(recv);
+    const recvDecl = recvSym ? lowerer.checker.valueDeclarationOf(recvSym) : undefined;
+    if (!recvDecl ||
+        !ts.isVariableDeclaration(recvDecl) ||
+        !ts.isVariableDeclarationList(recvDecl.parent) ||
+        recvDecl.initializer === undefined) {
+        fenceReceiver();
+    }
+    if ((recvDecl.parent.flags & ts.NodeFlags.Const) === 0 &&
+        !bindingNeverReassigned(lowerer, recvSym, recvDecl)) {
+        fenceReceiver();
+    }
+    let init = recvDecl.initializer;
+    while (ts.isParenthesizedExpression(init))
+        init = init.expression;
+    if (init !== literal)
+        fenceReceiver();
+}
+//# sourceMappingURL=generic-functions.js.map