@scriptc/compiler 0.0.29 → 0.0.31

package/dist/frontend/lowering/lower-exprs.d.ts

@@ -186,6 +186,8 @@ export declare function finishOptionalChain(L: Lowerer, expr: ts.Expression, id:
    * short-circuiting, and mixed operand kinds that have no VALUE
    * representation (`u && flag` — a union and a bool) test fine here. */
 export declare function lowerCondition(L: Lowerer, expr: ts.Expression): IrExpr;
+export declare function runtimeOptionalTrueIds(L: Lowerer, node: ts.Expression): IrLocal[];
+export declare function withRuntimeOptionalNarrowed<T>(L: Lowerer, locals: readonly IrLocal[], fn: () => T): T;
 /** JS ToBoolean: bool passes through; f64/string get a `toBool` wrapper
    * (falsy: 0, -0, NaN, ""); unions get the same wrapper answered by a
    * per-union interned helper (unit arms falsy; scalar/string arms by
@@ -288,7 +290,15 @@ export declare function lowerElementAccess(L: Lowerer, expr: ts.ElementAccessExp
    * fields outside that stay fenced. Declared-only shapes support reads
    * whose key type proves membership (tsc's keyof check): all fields must
    * share the result type, and a smuggled miss traps. */
-export declare function lowerRecordKeyRead(L: Lowerer, expr: ts.ElementAccessExpression, shapeId: string, shape: IrRecordShape): IrExpr;
+export declare function lowerRecordKeyRead(L: Lowerer, expr: ts.ElementAccessExpression, shapeId: string, shape: IrRecordShape, includeUndefined?: boolean): IrExpr;
+/** A keyed read used only to observe absence (`if (map[k])`, or the left
+ * side of `||`/`??`). JavaScript answers undefined for missing record keys
+ * and array indices even when noUncheckedIndexedAccess is disabled. Keep
+ * that value in an explicit union until the surrounding guard/default has
+ * consumed it; ordinary unchecked reads retain the typed trap. Assertions
+ * around the read are erased here because this context handles the missing
+ * arm instead of consuming it as the asserted type. */
+export declare function lowerAbsenceProbe(L: Lowerer, node: ts.Expression): IrExpr | null;
 /** The compile-time string spelling of a record key literal: a string
  * literal's text, or a NON-NEGATIVE numeric literal's canonical JS
  * spelling (`1` → "1", `1e21` → "1e+21" — String(Number(text)), which is

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

@@ -12,7 +12,7 @@ import { cjsClassExprWholeExportOf, cjsExportAssignmentOf, cjsExportDiscardReaso
 import { ARRAY_METHODS, builtinConstLit, builtinFenceHintOf, builtinModuleConstOf, builtinModulesArrayLit, builtinModuleFnOf, ISLAND_SURFACE, isChildSurfaceMember, MAP_METHODS, NARROW_FIRST, SET_METHODS, STR_METHODS, UNSUPPORTED_EXPR, sideEffectFreeOptionValue, stdlibGlobalNameOf } from "./surfaces.js";
 import { blockedBindingUseDiag, recordShapeMismatchDiag, requiresDynamicPackageDiag, unsupportedDiag } from "../../diagnostics/diagnostic.js";
 import { PoisonError, dynUndefinedExpr, jsFuncNameOf, neverTaintedJsType, nodeThrowExpr, own } from "./lowerer.js";
-import { lowerIndexMergeHelper, lowerNpmStaticSafeIndexRead, strCharsCall } from "./lower-containers.js";
+import { lowerIndexMergeHelper, lowerNpmStaticSafeIndexRead, lowerSafeIndexRead, strCharsCall } from "./lower-containers.js";
 import { npmStaticPackageOfPath } from "../npm-static.js";
 import { unsupportedModuleFeatureOf } from "../shared.js";
 import { fenceEnumObjectValue, lowerEnumAccess } from "./lower-enums.js";
@@ -204,6 +204,9 @@ function lowerExprInner(L, expr) {
     if (ts.isNonNullExpression(expr)) {
         const inner = L.lowerExpr(expr.expression);
         if (inner.type.kind === "union") {
+            const use = runtimeOptionalUseOf(expr);
+            if (runtimeOptionalAssertionErases(L, expr, inner, use))
+                return inner;
             const target = L.mapTypeOf(L.typeOf(expr));
             if (target && target.kind !== "union" && !typeEquals(target, inner.type)) {
                 const helper = L.narrowedArmHelper(inner.type.unionId, target, loc);
@@ -650,6 +653,37 @@ function lowerExprInner(L, expr) {
         if (local) {
             if (local.type.kind === "caught")
                 return L.caughtRead(expr, local, loc);
+            const symbol = L.resolveValueSymbol(expr);
+            const runtimeOptionalRoot = L.runtimeOptionalRootOf(local);
+            const active = L.runtimeOptionalLocals.has(runtimeOptionalRoot);
+            const captured = !!symbol &&
+                L.runtimeOptionalStorageLocals.has(runtimeOptionalRoot) &&
+                L.ctx.captureBySymbol.get(symbol) === local;
+            if (active || captured) {
+                const use = runtimeOptionalUseOf(expr);
+                if (use?.complex) {
+                    L.unsupported("SC1090", expr, "a logical or conditional receiver containing a runtime-optional capture");
+                }
+                if (use?.optional)
+                    return { kind: "varRef", localId: local.id, type: local.type, loc };
+                if (use?.kind === "property")
+                    return runtimeOptionalReceiverRead(L, expr, local, use.access.name.text, loc);
+                if (use?.kind === "element") {
+                    const key = runtimeOptionalElementKey(use.access.argumentExpression);
+                    if (key === null) {
+                        L.unsupported("SC1090", use.access, "a computed read from a runtime-optional capture (use a literal key)");
+                    }
+                    return runtimeOptionalReceiverRead(L, expr, local, key, loc);
+                }
+                if (use?.kind === "call") {
+                    if (use.comma && !use.optional) {
+                        L.unsupported("SC1090", use.access, "a direct call through a comma-wrapped runtime-optional capture");
+                    }
+                    return runtimeOptionalReceiverRead(L, expr, local, null, loc);
+                }
+                if (active || captured)
+                    return { kind: "varRef", localId: local.id, type: local.type, loc };
+            }
             return L.maybeNarrow({ kind: "varRef", localId: local.id, type: local.type, loc }, expr);
         }
         // `import x = N.y` aliases resolve transparently through globalOf/
@@ -877,11 +911,8 @@ function lowerExprInner(L, expr) {
                 L.noLowering(expr.text, expr, globalHints[expr.text], sym ?? undefined);
             }
         }
-        // `declare const __VERSION__: string` — an ambient global NOTHING
-        // defines (a bundler define in the real pipeline; scriptc has no
-        // define mechanism, and neither does Node running the source —
-        // the oracle). The read compiles to exactly what Node does at the
-        // access: the catchable ReferenceError "<name> is not defined".
+        // An ambient global nothing defines compiles to exactly what Node does
+        // at the access: the catchable ReferenceError "<name> is not defined".
         // Stdlib/@types/node ambients never reach here (their chokepoint
         // is above); only user-file declares do.
         {
@@ -1795,9 +1826,7 @@ export function lowerTernary(L, expr, expected) {
             const constituents = t.isUnionType() ? t.getTypes() : [];
             const nonArray = constituents.filter((a) => !L.checker.isArrayType(a) && !L.checker.isTupleType(a));
             const mapped = L.mapTypeOf(t);
-            const armCount = mapped?.kind === "union"
-                ? (L.unions.get(mapped.unionId)?.arms.filter((a) => a.kind === "array").length ?? 0)
-                : 0;
+            const armCount = mapped?.kind === "union" ? L.arrayValueTags(mapped.unionId).length : 0;
             if (sym && nonArray.length === 1 && armCount === 1) {
                 falseArmNarrowType = nonArray[0];
                 const collect = (n) => {
@@ -1913,12 +1942,14 @@ export function lowerTernary(L, expr, expected) {
         })();
         let thenRaw;
         let elseRaw;
+        const runtimeTrueIds = runtimeOptionalTrueIds(L, expr.condition);
+        const lowerTrueArm = () => withRuntimeOptionalNarrowed(L, runtimeTrueIds, () => lowerArm(expr.whenTrue, ownArrayJoin ?? undefined));
         if (!ctxArray && emptyUntypedArrayArm(expr.whenTrue) && !emptyUntypedArrayArm(expr.whenFalse)) {
             elseRaw = L.lowerExpr(expr.whenFalse);
-            thenRaw = lowerArm(expr.whenTrue, elseRaw.type);
+            thenRaw = withRuntimeOptionalNarrowed(L, runtimeTrueIds, () => lowerArm(expr.whenTrue, elseRaw.type));
         }
         else {
-            thenRaw = lowerArm(expr.whenTrue, ownArrayJoin ?? undefined);
+            thenRaw = lowerTrueArm();
             elseRaw = lowerArm(expr.whenFalse, thenRaw.type);
         }
         // The ternary's IR type is normally the checker's own: it collapses
@@ -2069,25 +2100,20 @@ export function maybeNarrow(L, expr, node) {
     }
     if (expr.type.kind !== "union")
         return expr;
-    const narrowed = L.mapTypeOf(L.typeOf(node));
-    // `Array.isArray(u)` on a `string | readonly string[]` union: the lib
-    // predicate narrows the READONLY arm to `any[]` (tsc's readonly-array
-    // quirk), which maps to the island's array-of-handles (or nothing) —
-    // but the tag test proved the union's one array arm, so the bridge is
-    // the same trusted unionNarrow the mapped case below builds (the
-    // certs configuredTlds shape).
-    if (!narrowed || (narrowed.kind === "array" && narrowed.elem.kind === "jsval")) {
-        const t = L.typeOf(node);
-        const anyElem = L.checker.isArrayType(t) &&
-            ((L.checker.getTypeArguments(t)[0]?.flags ?? 0) &
-                (ts.TypeFlags.Any | ts.TypeFlags.Unknown)) !== 0;
-        if (anyElem) {
-            const def = L.unions.get(expr.type.unionId);
-            const arrayTags = def ? def.arms.flatMap((a, i) => (a.kind === "array" ? [i] : [])) : [];
-            if (arrayTags.length === 1) {
-                const arm = def.arms[arrayTags[0]];
-                return { kind: "unionNarrow", unionId: expr.type.unionId, tag: arrayTags[0], value: expr, type: arm, loc: expr.loc };
-            }
+    const narrowedTs = L.typeOf(node);
+    const narrowed = L.mapTypeOf(narrowedTs);
+    // `Array.isArray(u)` on a union with one readonly array/tuple arm: the
+    // lib predicate narrows to `any[]`, either directly or intersected
+    // with the original union. That checker type can map to the island's
+    // array-of-handles, nothing, or a synthetic intersection record — but
+    // the tag test proved the union's one array-valued arm, so bridge to it
+    // with the same trusted unionNarrow the mapped case below builds.
+    if (L.checkerAnyArrayType(narrowedTs)) {
+        const def = L.unions.get(expr.type.unionId);
+        const arrayTags = L.arrayValueTags(expr.type.unionId);
+        if (arrayTags.length === 1) {
+            const arm = def.arms[arrayTags[0]];
+            return { kind: "unionNarrow", unionId: expr.type.unionId, tag: arrayTags[0], value: expr, type: arm, loc: expr.loc };
         }
     }
     // A checker type narrowed to a UNIT arm (the `=== undefined` branch)
@@ -2110,6 +2136,109 @@ export function maybeNarrow(L, expr, node) {
         loc: expr.loc,
     };
 }
+/** A runtime-optional slot can be assigned while a truthy guard is in
+ * force. TypeScript then types a direct member receiver as the plain arm,
+ * even though an OOB-safe assignment may have restored undefined. Check
+ * that hidden arm and throw the member-read TypeError Node would produce. */
+function runtimeOptionalReceiverRead(L, expr, local, property, loc) {
+    if (local.type.kind !== "union")
+        throw new Error("runtime-optional local is not union-typed");
+    const narrowed = L.mapTypeOf(L.typeOf(expr));
+    if (!narrowed || narrowed.kind === "union" || isUnitType(narrowed)) {
+        L.unsupported("SC1090", expr, "a runtime-optional capture whose narrowed value type is not representable");
+    }
+    const valueTag = L.armTag(local.type.unionId, narrowed);
+    const undefTag = L.armTag(local.type.unionId, UNDEFINED_T);
+    if (valueTag < 0 || undefTag < 0)
+        throw new Error("runtime-optional local is missing its value or undefined arm");
+    const def = L.unions.get(local.type.unionId);
+    if (!def || def.arms.length !== 2) {
+        L.unsupported("SC1090", expr, "a direct read from a runtime-optional capture with multiple value arms");
+    }
+    const ref = () => ({ kind: "varRef", localId: local.id, type: local.type, loc });
+    const message = property === null
+        ? `${expr.text} is not a function`
+        : `Cannot read properties of undefined (reading '${property}')`;
+    return {
+        kind: "ternary",
+        cond: {
+            kind: "unionIsTag",
+            unionId: local.type.unionId,
+            tag: undefTag,
+            negated: false,
+            value: ref(),
+            type: BOOL,
+            loc,
+        },
+        then: nodeThrowExpr(1, "", message, narrowed, loc),
+        else_: {
+            kind: "unionNarrow",
+            unionId: local.type.unionId,
+            tag: valueTag,
+            value: ref(),
+            type: narrowed,
+            loc,
+        },
+        type: narrowed,
+        loc,
+    };
+}
+function runtimeOptionalUseOf(expr) {
+    let receiver = expr;
+    let complex = false;
+    let comma = false;
+    for (;;) {
+        const parent = receiver.parent;
+        if ((ts.isParenthesizedExpression(parent) || ts.isAssertionExpression(parent) ||
+            ts.isSatisfiesExpression(parent) ||
+            ts.isNonNullExpression(parent)) &&
+            parent.expression === receiver) {
+            receiver = parent;
+            continue;
+        }
+        if (ts.isBinaryExpression(parent) && parent.operatorToken.kind === ts.SyntaxKind.CommaToken && parent.right === receiver) {
+            comma = true;
+            receiver = parent;
+            continue;
+        }
+        if ((ts.isBinaryExpression(parent) &&
+            (parent.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken ||
+                parent.operatorToken.kind === ts.SyntaxKind.BarBarToken ||
+                parent.operatorToken.kind === ts.SyntaxKind.QuestionQuestionToken) &&
+            (parent.left === receiver || parent.right === receiver)) ||
+            (ts.isConditionalExpression(parent) &&
+                (parent.condition === receiver || parent.whenTrue === receiver || parent.whenFalse === receiver))) {
+            complex = true;
+            receiver = parent;
+            continue;
+        }
+        break;
+    }
+    const access = receiver.parent;
+    if (ts.isPropertyAccessExpression(access) && access.expression === receiver) {
+        return { kind: "property", access, optional: access.questionDotToken !== undefined, complex, comma };
+    }
+    if (ts.isElementAccessExpression(access) && access.expression === receiver) {
+        return { kind: "element", access, optional: access.questionDotToken !== undefined, complex, comma };
+    }
+    if (ts.isCallExpression(access) && access.expression === receiver) {
+        return { kind: "call", access, optional: access.questionDotToken !== undefined, complex, comma };
+    }
+    return null;
+}
+function runtimeOptionalElementKey(expr) {
+    if (ts.isStringLiteral(expr) || ts.isNumericLiteral(expr))
+        return expr.text;
+    if (ts.isNoSubstitutionTemplateLiteral(expr))
+        return expr.text;
+    return null;
+}
+function runtimeOptionalAssertionErases(L, expr, inner, use) {
+    if (inner.type.kind !== "union" || !use?.optional || use.complex || L.armTag(inner.type.unionId, UNDEFINED_T) < 0)
+        return false;
+    const target = L.mapTypeOf(L.typeOf(expr));
+    return !!target && target.kind !== "union" && typeEquals(L.stripUndefinedArm(inner.type), target);
+}
 /** `v === undefined` / `v !== null` — the narrowing tests for unit-armed
    * unions. A union operand compared with a unit literal lowers to a
    * runtime TAG test (unionIsTag); afterwards tsc's control-flow narrowing
@@ -2374,7 +2503,7 @@ function pureCondExpr(e) {
    * results (several non-unit arms) and defaults that change the result
    * type are fenced with narrow-first hints. */
 export function lowerNullishCoalesce(L, expr, loc) {
-    const left = L.lowerExpr(expr.left);
+    const left = lowerAbsenceProbe(L, expr.left) ?? L.lowerExpr(expr.left);
     if (left.type.kind === "dyn") {
         // `a ?? b` on a CHECKED-DYNAMIC left: the deciding test is the
         // runtime kind (scr_dyn_is_nullish — UNDEF/NULL take the default;
@@ -2850,7 +2979,14 @@ export function finishOptionalChain(L, expr, id, receiver, body, loc) {
     if (body.type.kind === "dyn") {
         return { kind: "optChain", id, receiver, body, type: DYN, loc };
     }
-    const type = L.irTypeOf(expr);
+    let type = L.irTypeOf(expr);
+    const hiddenOptionalResult = (type.kind !== "union" || L.armTag(type.unionId, UNDEFINED_T) < 0) &&
+        receiver.type.kind === "union" && L.armTag(receiver.type.unionId, UNDEFINED_T) >= 0 &&
+        body.type.kind !== "generator" && body.type.kind !== "jsval"
+        ? L.withUndefinedArmOf(body.type)
+        : null;
+    if (hiddenOptionalResult)
+        type = hiddenOptionalResult;
     if (type.kind !== "union" || L.armTag(type.unionId, UNDEFINED_T) < 0) {
         L.unsupported("SC1090", expr, `'?.' where the result '${L.fmt(type)}' has no undefined arm (narrow the receiver with 'if (x !== undefined)' instead)`);
     }
@@ -2877,7 +3013,18 @@ export function lowerCondition(L, expr) {
             // (true for &&, false for ||) — aliased-typeof narrows the left
             // PROVES under that polarity hold while it lowers (`type ===
             // 'string' && val.length > 0`, the ms entry shape).
-            const right = L.narrowingAliases(aliasTypeofNarrows(L, e.left, isAnd), () => L.lowerCondition(e.right));
+            const runtimeOptionalLocal = isAnd ? runtimeOptionalLocalOf(L, e.left) : null;
+            const right = L.narrowingAliases(aliasTypeofNarrows(L, e.left, isAnd), () => {
+                if (runtimeOptionalLocal === null)
+                    return L.lowerCondition(e.right);
+                L.runtimeOptionalLocals.delete(L.runtimeOptionalRootOf(runtimeOptionalLocal));
+                try {
+                    return L.lowerCondition(e.right);
+                }
+                finally {
+                    L.runtimeOptionalLocals.add(L.runtimeOptionalRootOf(runtimeOptionalLocal));
+                }
+            });
             return {
                 kind: "logical",
                 op: isAnd ? "&&" : "||",
@@ -2888,7 +3035,40 @@ export function lowerCondition(L, expr) {
             };
         }
     }
-    return L.ensureBool(L.lowerExpr(expr), expr);
+    return L.ensureBool(lowerAbsenceProbe(L, expr) ?? L.lowerExpr(expr), expr);
+}
+function runtimeOptionalLocalOf(L, node) {
+    let expr = node;
+    while (ts.isParenthesizedExpression(expr))
+        expr = expr.expression;
+    if (!ts.isIdentifier(expr))
+        return null;
+    const local = L.resolveLocal(expr);
+    return local && L.runtimeOptionalLocals.has(L.runtimeOptionalRootOf(local)) ? local : null;
+}
+export function runtimeOptionalTrueIds(L, node) {
+    let expr = node;
+    while (ts.isParenthesizedExpression(expr))
+        expr = expr.expression;
+    if (ts.isBinaryExpression(expr) &&
+        expr.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken) {
+        return [...runtimeOptionalTrueIds(L, expr.left), ...runtimeOptionalTrueIds(L, expr.right)];
+    }
+    const local = runtimeOptionalLocalOf(L, expr);
+    return local === null ? [] : [local];
+}
+export function withRuntimeOptionalNarrowed(L, locals, fn) {
+    if (locals.length === 0)
+        return fn();
+    for (const local of locals)
+        L.runtimeOptionalLocals.delete(L.runtimeOptionalRootOf(local));
+    try {
+        return fn();
+    }
+    finally {
+        for (const local of locals)
+            L.runtimeOptionalLocals.add(L.runtimeOptionalRootOf(local));
+    }
 }
 /** JS ToBoolean: bool passes through; f64/string get a `toBool` wrapper
    * (falsy: 0, -0, NaN, ""); unions get the same wrapper answered by a
@@ -5378,9 +5558,17 @@ export function lowerElementAccess(L, expr) {
     // `const cmd = ['pwd', []]`, whose binding lowered checked-dynamic)
     // dispatches as unmapped so the dyn-receiver branch below reads
     // through the checked-dynamic tree instead of dynChecking into never's f64 residue.
-    const receiverIr = neverTaintedJsType(L, expr.expression, L.typeOf(expr.expression))
+    let receiverIr = neverTaintedJsType(L, expr.expression, L.typeOf(expr.expression))
         ? null
         : L.mapTypeOf(L.typeOf(expr.expression));
+    // A readonly tuple union under Array.isArray is checker-typed as an
+    // intersection with any[], whose structural mapping is not the tuple
+    // shape. maybeNarrow on the receiver uses the runtime tag proof to
+    // extract the one array-valued arm; dispatch element access from that
+    // lowered representation, like the existing any[] array-method path.
+    const checkerArray = L.checkerArrayValue(expr.expression);
+    if (checkerArray)
+        receiverIr = checkerArray.type;
     if (receiverIr?.kind === "jsval") {
         // Dispatch follows the RUNTIME world (383(d)): a checker-'any'
         // receiver whose value LOWERED checked-dynamic (`bag.list[0]` where
@@ -5595,13 +5783,18 @@ export function lowerElementAccess(L, expr) {
     // signature where the .d.ts says Function[], which would flatten the
     // element to a zero-parameter closure).
     const elemT = arr.type.kind === "array" ? arr.type.elem : receiverIr.elem;
-    // --npm-static package files: the OOB-SAFE read (elem | undefined)
-    // for the LAST-ELEMENT idiom — indexing a fresh slice() result
-    // (commander's `registeredArguments.slice(-1)[0]` probe), where the
-    // trap divergence would fire on working Node code and the fresh
-    // array's read can only be a probe. General indexed reads keep the
-    // documented trap (their results feed writes and member reads whose
-    // lowerings need the plain element).
+    // OOB-SAFE reads over fresh/probe array results. These expressions are
+    // commonly used to ask for a first/last match (`filter(...).sort(...)[0]`,
+    // `slice(-1)[0]`); an empty result is ordinary undefined, not a bounds
+    // failure. Downstream lowering keeps the explicit optional union, so an
+    // unchecked consumer still cannot place it into a plain element slot.
+    if (arr.type.kind === "array" && isFreshArrayProbe(expr.expression)) {
+        const safe = lowerSafeIndexRead(L, arr, index, locOf(expr));
+        if (safe)
+            return safe;
+    }
+    // --npm-static package files retain the original slice-specific route
+    // for compatibility with package-source inference.
     if (arr.type.kind === "array" &&
         arr.kind === "arrIntrinsic" &&
         arr.method === "slice" &&
@@ -5615,6 +5808,16 @@ export function lowerElementAccess(L, expr) {
     // narrows literal-index element accesses).
     return L.maybeNarrow({ kind: "arrayGet", arr, index, type: elemT, loc: locOf(expr) }, expr);
 }
+function isFreshArrayProbe(node) {
+    let current = node;
+    while (ts.isParenthesizedExpression(current))
+        current = current.expression;
+    return (ts.isCallExpression(current) &&
+        ts.isPropertyAccessExpression(current.expression) &&
+        (current.expression.name.text === "filter" ||
+            current.expression.name.text === "slice" ||
+            current.expression.name.text === "sort"));
+}
 /** `o[k]` where the RECEIVER is an island value — a jsval-mapped checker
    * type, or an array/tuple-typed .d.ts surface whose lowered value is a
    * handle. The key marshals in (any JS key kind — the engine does its
@@ -5654,7 +5857,7 @@ function islandElementRead(L, expr, obj) {
    * fields outside that stay fenced. Declared-only shapes support reads
    * whose key type proves membership (tsc's keyof check): all fields must
    * share the result type, and a smuggled miss traps. */
-export function lowerRecordKeyRead(L, expr, shapeId, shape) {
+export function lowerRecordKeyRead(L, expr, shapeId, shape, includeUndefined = false) {
     const loc = locOf(expr);
     const keyNode = expr.argumentExpression;
     // Literal declared keys are plain field reads (narrowing included).
@@ -5721,7 +5924,7 @@ export function lowerRecordKeyRead(L, expr, shapeId, shape) {
     let declared = null;
     if (shape.indexValue) {
         declared = shape.indexValue;
-        if (L.program.getCompilerOptions().noUncheckedIndexedAccess) {
+        if (includeUndefined || L.program.getCompilerOptions().noUncheckedIndexedAccess) {
             declared = L.withUndefinedArmOf(declared);
             if (!declared)
                 L.badType(expr, L.typeOf(expr));
@@ -5740,7 +5943,72 @@ export function lowerRecordKeyRead(L, expr, shapeId, shape) {
     if (!recordKeyResultOk(L, overflowOnly ? { ...shape, fields: [] } : shape, declared)) {
         L.unsupported("SC1090", expr, `dynamic keyed reads of '${L.fmt({ kind: "record", shapeId })}' as '${L.fmt(declared)}' (every declared field must be readable at that type)`);
     }
-    return L.maybeNarrow({ kind: "recordKeyGet", obj, shapeId, key, ...(overflowOnly ? { overflowOnly: true } : {}), type: declared, loc }, expr);
+    const read = {
+        kind: "recordKeyGet",
+        obj,
+        shapeId,
+        key,
+        ...(overflowOnly ? { overflowOnly: true } : {}),
+        type: declared,
+        loc,
+    };
+    return includeUndefined ? read : L.maybeNarrow(read, expr);
+}
+/** A keyed read used only to observe absence (`if (map[k])`, or the left
+ * side of `||`/`??`). JavaScript answers undefined for missing record keys
+ * and array indices even when noUncheckedIndexedAccess is disabled. Keep
+ * that value in an explicit union until the surrounding guard/default has
+ * consumed it; ordinary unchecked reads retain the typed trap. Assertions
+ * around the read are erased here because this context handles the missing
+ * arm instead of consuming it as the asserted type. */
+export function lowerAbsenceProbe(L, node) {
+    let expr = node;
+    while (ts.isParenthesizedExpression(expr) || ts.isAsExpression(expr) || ts.isTypeAssertion(expr)) {
+        expr = expr.expression;
+    }
+    if (ts.isPropertyAccessExpression(expr)) {
+        const target = L.fieldTarget(expr);
+        if (target?.container !== "recordOvf")
+            return null;
+        if (target.fieldType.kind === "union" &&
+            L.armTag(target.fieldType.unionId, UNDEFINED_T) >= 0) {
+            return null;
+        }
+        const type = L.withUndefinedArmOf(target.fieldType);
+        if (!type)
+            return null;
+        return {
+            kind: "recordKeyGet",
+            obj: target.obj,
+            shapeId: target.shapeId,
+            key: { kind: "strLit", value: target.field, type: STRING, loc: locOf(expr) },
+            overflowOnly: true,
+            type,
+            loc: locOf(expr),
+        };
+    }
+    if (!ts.isElementAccessExpression(expr))
+        return null;
+    const header = L.lowerHttpHeadersElement(expr);
+    if (header)
+        return header;
+    const receiverT = L.mapTypeOf(L.typeOf(expr.expression));
+    if (receiverT?.kind === "record") {
+        const shape = L.shapes.get(receiverT.shapeId);
+        if (shape && !shape.tuple && shape.indexValue && shape.indexValue.kind !== "dyn") {
+            return L.lowerRecordKeyRead(expr, receiverT.shapeId, shape, true);
+        }
+        return null;
+    }
+    if (receiverT?.kind !== "array")
+        return null;
+    const arr = L.lowerExpr(expr.expression);
+    if (arr.type.kind !== "array")
+        return null;
+    const index = L.lowerExpr(expr.argumentExpression);
+    if (index.type.kind !== "f64")
+        return null;
+    return lowerSafeIndexRead(L, arr, index, locOf(expr));
 }
 /** The compile-time string spelling of a record key literal: a string
  * literal's text, or a NON-NEGATIVE numeric literal's canonical JS
@@ -6320,6 +6588,9 @@ export function lowerAsExpression(L, expr) {
             L.unsupported("SC1063", expr);
     }
     const inner = L.lowerExpr(expr.expression);
+    const use = runtimeOptionalUseOf(expr);
+    if (inner.type.kind === "union" && runtimeOptionalAssertionErases(L, expr, inner, use))
+        return inner;
     if (inner.type.kind !== "dyn" && inner.type.kind !== "jsval") {
         // A STATIC value cast `as any` is the explicit island entrance.
         const targetTs0 = L.checker.getTypeFromTypeNode(expr.type);
@@ -6560,6 +6831,9 @@ export function lowerBinary(L, expr) {
                 L.rejectUnresolved(expr.left, `assignment to '${expr.left.text}' (not a writable local or module global)`);
             }
             const value = L.lowerExprExpecting(expr.right, target.type);
+            const runtimeOptionalRoot = L.runtimeOptionalRootOf(target);
+            if (L.runtimeOptionalStorageLocals.has(runtimeOptionalRoot))
+                L.runtimeOptionalLocals.add(runtimeOptionalRoot);
             return { kind: "assignExpr", localId: target.id, value, type: target.type, loc };
         }
         // `events.defaultMaxListeners = v` — the module-property write
@@ -6719,11 +6993,16 @@ export function lowerBinary(L, expr) {
         L.unsupported("SC1040", expr);
     }
     if (op === ts.SyntaxKind.AmpersandAmpersandToken || op === ts.SyntaxKind.BarBarToken) {
+        if (op === ts.SyntaxKind.BarBarToken) {
+            const fallback = lowerAbsenceAwareOrChain(L, expr);
+            if (fallback)
+                return fallback;
+        }
         // JS value semantics: `a && b` is `toBool(a) ? b : a` — the result is
         // an operand value, so both operands must share one IR kind (which is
         // also what tsc's type says, modulo literal-union collapsing that
         // mapType already handles). Mixed kinds (`n && s`) stay rejected.
-        const left = L.lowerExpr(expr.left);
+        const left = lowerAbsenceProbe(L, expr.left) ?? L.lowerExpr(expr.left);
         const right = L.lowerExpr(expr.right);
         // A LITERAL-unit left operand (a compile-time undefined/null — the
         // capability-probe members: `process.features.inspector ||
@@ -6894,8 +7173,10 @@ export function lowerBinary(L, expr) {
         if (test)
             return test;
     }
-    const left = L.lowerExpr(expr.left);
-    const right = L.lowerExpr(expr.right);
+    const strictEquality = op === ts.SyntaxKind.EqualsEqualsEqualsToken ||
+        op === ts.SyntaxKind.ExclamationEqualsEqualsToken;
+    const left = strictEquality ? lowerAbsenceProbe(L, expr.left) ?? L.lowerExpr(expr.left) : L.lowerExpr(expr.left);
+    const right = strictEquality ? lowerAbsenceProbe(L, expr.right) ?? L.lowerExpr(expr.right) : L.lowerExpr(expr.right);
     if (left.type.kind === "dyn" || right.type.kind === "dyn") {
         // The narrowing unit comparisons ARE answerable on unknown: `v ===
         // undefined` / `v !== null` test the dyn node's kind directly, and
@@ -7106,6 +7387,29 @@ export function lowerBinary(L, expr) {
                 const ut = left.type.kind === "union" ? left.type : right.type;
                 const bothUnion = left.type.kind === "union" && right.type.kind === "union";
                 const sameUnion = bothUnion && typeEquals(left.type, right.type);
+                const plainFunc = left.type.kind === "func" ? left : right.type.kind === "func" ? right : null;
+                const unionArms = L.unions.get(ut.unionId)?.arms ?? [];
+                const funcArm = unionArms.find((arm) => arm.kind === "func");
+                // `listeners()` reports original prefix callbacks, but the
+                // checker views an indexed result as function | undefined. For
+                // identity comparison, retain the original closure pointer rather
+                // than adapting it to the tuple signature.
+                if (!bothUnion &&
+                    plainFunc !== null &&
+                    funcArm?.kind === "func" &&
+                    unionArms.filter((arm) => arm.kind === "func").length === 1 &&
+                    unionArms.some(isUnitType)) {
+                    return {
+                        kind: "unionFuncEq",
+                        unionId: ut.unionId,
+                        tag: L.armTag(ut.unionId, funcArm),
+                        union: left.type.kind === "union" ? left : right,
+                        func: plainFunc,
+                        negated,
+                        type: BOOL,
+                        loc,
+                    };
+                }
                 if ((sameUnion || !bothUnion) && L.eqComparableUnion(ut.unionId)) {
                     return {
                         kind: "unionEq",
@@ -7193,6 +7497,44 @@ export function lowerBinary(L, expr) {
     }
     L.unsupported("SC1090", expr, `operator '${ts.tokenToString(op) ?? ts.SyntaxKind[op]}'`);
 }
+function lowerAbsenceAwareOrChain(L, expr) {
+    const nodes = [];
+    const collect = (node) => {
+        if (ts.isBinaryExpression(node) &&
+            node.operatorToken.kind === ts.SyntaxKind.BarBarToken) {
+            collect(node.left);
+            collect(node.right);
+        }
+        else {
+            nodes.push(node);
+        }
+    };
+    collect(expr);
+    if (nodes.length < 3)
+        return null;
+    const lowered = nodes.map((node) => lowerAbsenceProbe(L, node) ?? L.lowerExpr(node));
+    if (!lowered.some((value) => value.type.kind === "union" && L.armTag(value.type.unionId, UNDEFINED_T) >= 0)) {
+        return null;
+    }
+    let result = lowered[lowered.length - 1];
+    for (let i = lowered.length - 2; i >= 0; i--) {
+        const left = lowered[i];
+        const loc = locOf(nodes[i]);
+        if (left.type.kind === "union") {
+            const def = L.unions.get(left.type.unionId);
+            const nonUnit = def?.arms.filter((arm) => !isUnitType(arm)) ?? [];
+            if (nonUnit.length !== 1 || !typeEquals(nonUnit[0], result.type))
+                return null;
+            L.requireTruthyUnion(left.type.unionId, expr);
+            result = { kind: "orDefault", left, right: result, type: result.type, loc };
+            continue;
+        }
+        if (!typeEquals(left.type, result.type))
+            return null;
+        result = { kind: "logical", op: "||", left, right: result, type: result.type, loc };
+    }
+    return result;
+}
 /** `typeof e === "lit"` / `typeof e !== "lit"` where e is a catch
    * binding: the runtime kind test over the snapshot's tag. Only the
    * primitive literals narrow ("string"/"number"/"boolean" — exactly what
@@ -9009,7 +9351,14 @@ export function lowerFieldRead(L, expr) {
         return L.fieldGetExpr(target, locOf(expr), expr);
     if (expr.questionDotToken)
         return null;
-    const receiverIr = L.mapTypeOf(L.typeOf(expr.expression));
+    let receiverIr = L.mapTypeOf(L.typeOf(expr.expression));
+    // The readonly-tuple Array.isArray narrow has no directly mappable
+    // checker type (`Result & any[]`), but maybeNarrow extracted the tuple
+    // record behind it. Route tuple properties such as `.length` from that
+    // lowered value, the element-access bridge's twin.
+    const checkerArray = L.checkerArrayValue(expr.expression);
+    if (checkerArray?.type.kind === "record")
+        receiverIr = checkerArray.type;
     if (receiverIr?.kind === "object" &&
         (L.findMethodOn(L.classes.get(receiverIr.className) ?? null, expr.name.text) ||
             findGenericMethodOn(L, L.classes.get(receiverIr.className) ?? null, expr.name.text))) {