neon 2.47.0 → 3.1.0

package/dist/psql/command/cmd_cond.js

@@ -1,437 +1,262 @@
-/**
- * psql conditional backslash commands: `\if`, `\elif`, `\else`, `\endif`.
- *
- * TypeScript port of `exec_command_if`/`exec_command_elif`/`exec_command_else`/
- * `exec_command_endif` in `src/bin/psql/command.c`, plus the `ConditionalStack`
- * machinery from `src/fe_utils/conditional.c`.
- *
- * Semantics (mirroring upstream exactly):
- *
- *  - `\if <expr>`
- *      • If outer branch is active, push a new frame whose state is `TRUE` or
- *        `FALSE` depending on the parsed expression value.
- *      • Otherwise push `IGNORED`: every nested branch is suppressed regardless
- *        of expression. This is how upstream achieves transitive suppression
- *        without `conditional_active()` itself being transitive.
- *  - `\elif <expr>`
- *      • Top is `TRUE`         → branch already taken; skip rest until `\endif`
- *        (poke to `IGNORED`).
- *      • Top is `FALSE`        → first true branch wins; evaluate expression.
- *      • Top is `IGNORED`      → leave untouched, ignore expression.
- *      • Top is `ELSE_*`       → error: `\elif: cannot occur after \else`.
- *      • Top is `NONE` (empty) → error: `\elif: no matching \if`.
- *  - `\else`
- *      • Top is `TRUE`         → poke `ELSE_FALSE`.
- *      • Top is `FALSE`        → poke `ELSE_TRUE`.
- *      • Top is `IGNORED`      → poke `ELSE_FALSE` (still suppressed).
- *      • Top is `ELSE_*`       → error: `\else: cannot occur after \else`.
- *      • Top is `NONE`         → error: `\else: no matching \if`.
- *  - `\endif`
- *      • Pop the top frame.
- *      • Top was `NONE`        → error: `\endif: no matching \if`.
- *
- * Expression evaluation: upstream `read_boolean_expression` reads tokens
- * with `OT_NORMAL` (which expands `:vars` and backticks) and concatenates
- * them with single spaces; the assembled string is passed through
- * `ParseVariableBool`. We mirror that pipeline in {@link collectExpr} +
- * {@link parseBool}: collect every `nextArg('normal')` token, join with
- * spaces, parse. Unrecognised tokens emit the upstream
- * `unrecognized value "<tok>" for "\<cmd> expression": Boolean expected`
- * diagnostic and evaluate to false.
- *
- * Inactive branches: when the surrounding scope is suppressed, upstream
- * `ignore_boolean_expression` drops the argument tokens WITHOUT running
- * `:var` / backtick expansion (regress psql.sql ~line 1028 covers this).
- * We achieve the same by NOT calling `nextArg` at all — the
- * BackslashContext factory only invokes the slash scanner lazily on the
- * first `nextArg` request, so leaving the args queue untouched is
- * equivalent to upstream's "discard without expansion".
- *
- * Diagnostic format: cond commands emit their errors BARE (no
- * `psql: ERROR:` prefix). This mirrors `expected/psql.out` (e.g.
- * `\endif: no matching \if` on a single line). We use `writeErr` directly
- * and return `errorWritten: true` so the mainloop's `psql: ERROR:` fallback
- * is suppressed.
- *
- * Note on the "transitive suppression" requirement: upstream's
- * `conditional_active()` only inspects the top frame, but the resulting state
- * machine *is* transitive because `\if` inside an inactive outer always pushes
- * `IGNORED`, and `IGNORED` never transitions to `TRUE`. So `isActive()`
- * inspecting just the top frame produces the right answer.
- */
 import { writeErr } from "./shared.js";
-// ---------------------------------------------------------------------------
-// Conditional stack
-// ---------------------------------------------------------------------------
-const INACTIVE_STATES = ["false", "else-false", "ignored"];
+//#region src/psql/command/cmd_cond.ts
+const INACTIVE_STATES = [
+	"false",
+	"else-false",
+	"ignored"
+];
 /**
- * Build an empty {@link CondStack}.
- *
- * Frames are stored in an array; `top()` is the last element. `branchTaken`
- * records whether a `TRUE`/`ELSE_TRUE` branch has been seen at this level —
- * mainloop and the elif/else commands use it implicitly via the state-machine
- * transitions described above (we don't expose it through the public API, but
- * it's part of the frame shape declared in `types/repl.ts`).
- */
-export const createCondStack = () => {
-    const frames = [];
-    const branchTakenForInitial = (state) => state === "true" || state === "else-true";
-    return {
-        push(state, savedQueryBufLen = 0) {
-            frames.push({
-                state,
-                branchTaken: branchTakenForInitial(state),
-                savedQueryBufLen,
-            });
-        },
-        pop() {
-            return frames.pop();
-        },
-        top() {
-            return frames.length === 0 ? undefined : frames[frames.length - 1];
-        },
-        isActive() {
-            // Upstream `conditional_active()`: top is NONE/TRUE/ELSE_TRUE → active.
-            // The transitive suppression is encoded by `\if` pushing `IGNORED` when
-            // its surrounding context is inactive — see cmdIf below.
-            if (frames.length === 0)
-                return true;
-            return !INACTIVE_STATES.includes(frames[frames.length - 1].state);
-        },
-        setState(state) {
-            if (frames.length === 0)
-                return;
-            const top = frames[frames.length - 1];
-            top.state = state;
-            if (state === "true" || state === "else-true")
-                top.branchTaken = true;
-        },
-        setSavedQueryBufLen(len) {
-            if (frames.length === 0)
-                return;
-            frames[frames.length - 1].savedQueryBufLen = len;
-        },
-        depth() {
-            return frames.length;
-        },
-    };
+* Build an empty {@link CondStack}.
+*
+* Frames are stored in an array; `top()` is the last element. `branchTaken`
+* records whether a `TRUE`/`ELSE_TRUE` branch has been seen at this level —
+* mainloop and the elif/else commands use it implicitly via the state-machine
+* transitions described above (we don't expose it through the public API, but
+* it's part of the frame shape declared in `types/repl.ts`).
+*/
+const createCondStack = () => {
+	const frames = [];
+	const branchTakenForInitial = (state) => state === "true" || state === "else-true";
+	return {
+		push(state, savedQueryBufLen = 0) {
+			frames.push({
+				state,
+				branchTaken: branchTakenForInitial(state),
+				savedQueryBufLen
+			});
+		},
+		pop() {
+			return frames.pop();
+		},
+		top() {
+			return frames.length === 0 ? void 0 : frames[frames.length - 1];
+		},
+		isActive() {
+			if (frames.length === 0) return true;
+			return !INACTIVE_STATES.includes(frames[frames.length - 1].state);
+		},
+		setState(state) {
+			if (frames.length === 0) return;
+			const top = frames[frames.length - 1];
+			top.state = state;
+			if (state === "true" || state === "else-true") top.branchTaken = true;
+		},
+		setSavedQueryBufLen(len) {
+			if (frames.length === 0) return;
+			frames[frames.length - 1].savedQueryBufLen = len;
+		},
+		depth() {
+			return frames.length;
+		}
+	};
 };
-// ---------------------------------------------------------------------------
-// ParseVariableBool — mirrors variables.c::ParseVariableBool.
-//
-// We re-implement it here (rather than importing from core/variables.ts) so
-// the slash-cmd modules stay decoupled from the var-store implementation;
-// they just need a value-parser. Recognised forms are case-insensitive with
-// unique-prefix matching for word forms:
-//
-//   true / false / yes / no   (unique-prefix accepted)
-//   on / off                  (need at least 2 chars; bare 'o' ambiguous)
-//   1 / 0                     (literal)
-//
-// Anything else is an error (upstream prints a warning and returns false). We
-// follow upstream by treating unrecognised tokens as `false` while pushing
-// the frame.
-// ---------------------------------------------------------------------------
-const isPrefixOf = (value, prefix) => value.length > 0 &&
-    value.length <= prefix.length &&
-    prefix.slice(0, value.length).toLowerCase() === value.toLowerCase();
+const isPrefixOf = (value, prefix) => value.length > 0 && value.length <= prefix.length && prefix.slice(0, value.length).toLowerCase() === value.toLowerCase();
 /** Returns the parsed boolean, or `null` if the string was not recognised. */
-export const parseBool = (value) => {
-    if (value.length === 0)
-        return null;
-    if (isPrefixOf(value, "true"))
-        return true;
-    if (isPrefixOf(value, "false"))
-        return false;
-    if (isPrefixOf(value, "yes"))
-        return true;
-    if (isPrefixOf(value, "no"))
-        return false;
-    if (value.length >= 2) {
-        const lower = value.toLowerCase();
-        if ("on".startsWith(lower))
-            return true;
-        if ("off".startsWith(lower))
-            return false;
-    }
-    if (value === "1")
-        return true;
-    if (value === "0")
-        return false;
-    return null;
+const parseBool = (value) => {
+	if (value.length === 0) return null;
+	if (isPrefixOf(value, "true")) return true;
+	if (isPrefixOf(value, "false")) return false;
+	if (isPrefixOf(value, "yes")) return true;
+	if (isPrefixOf(value, "no")) return false;
+	if (value.length >= 2) {
+		const lower = value.toLowerCase();
+		if ("on".startsWith(lower)) return true;
+		if ("off".startsWith(lower)) return false;
+	}
+	if (value === "1") return true;
+	if (value === "0") return false;
+	return null;
 };
-// ---------------------------------------------------------------------------
-// Backslash command implementations
-// ---------------------------------------------------------------------------
 /**
- * Read every remaining `'normal'`-mode argument off the BackslashContext and
- * concatenate them with single spaces. Mirrors upstream
- * `read_boolean_expression`, which calls `psql_scan_slash_option(OT_NORMAL)`
- * in a loop and joins tokens with `" "`. Returns the empty string when no
- * args follow the command name — upstream's "missing expression" path
- * surfaces the same `unrecognized value ""...` diagnostic as any other
- * unparseable token, then evaluates to false.
- *
- * After joining, we resolve the `:{?varname}` "defined-variable" substitution
- * form. Upstream's slash lexer recognises `:{?name}` directly and emits
- * `TRUE` / `FALSE` depending on whether the named variable is currently
- * set; we re-create that pass here because the underlying scanner only
- * handles the plain `:name`, `:'name'`, `:"name"` forms (the `:{?name}`
- * form lives in a separate `xslashdefined` flex rule upstream). Doing it
- * after the join keeps the rule local to the conditional-expression
- * pipeline — every other call site of the slash scanner has its own
- * variable-expansion needs that we don't want to disturb.
- */
+* Read every remaining `'normal'`-mode argument off the BackslashContext and
+* concatenate them with single spaces. Mirrors upstream
+* `read_boolean_expression`, which calls `psql_scan_slash_option(OT_NORMAL)`
+* in a loop and joins tokens with `" "`. Returns the empty string when no
+* args follow the command name — upstream's "missing expression" path
+* surfaces the same `unrecognized value ""...` diagnostic as any other
+* unparseable token, then evaluates to false.
+*
+* After joining, we resolve the `:{?varname}` "defined-variable" substitution
+* form. Upstream's slash lexer recognises `:{?name}` directly and emits
+* `TRUE` / `FALSE` depending on whether the named variable is currently
+* set; we re-create that pass here because the underlying scanner only
+* handles the plain `:name`, `:'name'`, `:"name"` forms (the `:{?name}`
+* form lives in a separate `xslashdefined` flex rule upstream). Doing it
+* after the join keeps the rule local to the conditional-expression
+* pipeline — every other call site of the slash scanner has its own
+* variable-expansion needs that we don't want to disturb.
+*/
 const DEFINED_VAR_RE = /:\{\?([A-Za-z_][A-Za-z0-9_]*)\}/g;
 const expandDefinedVar = (text, isDefined) => text.replace(DEFINED_VAR_RE, (_match, name) => isDefined(name) ? "TRUE" : "FALSE");
 const collectExpr = (ctx) => {
-    const parts = [];
-    for (;;) {
-        const arg = ctx.nextArg("normal");
-        if (arg === null)
-            break;
-        parts.push(arg);
-    }
-    return expandDefinedVar(parts.join(" "), (name) => ctx.settings.vars.has(name));
-};
-/**
- * Marker call indicating "discard the expression without evaluating it".
- * Mirrors upstream `ignore_boolean_expression` — when we're already inside
- * an inactive branch, `\if` / `\elif` arguments are dropped without
- * expanding `:vars` or running backticks. We achieve this by simply NOT
- * calling `nextArg`: the BackslashContext factory in `mainloop.ts` only
- * invokes the slash scanner lazily on the first arg request, so leaving
- * the queue untouched skips all expansion. The unconsumed `rawArgs` are
- * dropped after the cmd returns.
- *
- * Kept as a named no-op so call sites read intent-fully ("dropExpr") and
- * future refactors can replace the body without touching every caller.
- */
-const dropExpr = () => {
-    // Intentionally empty — see the doc comment.
+	const parts = [];
+	for (;;) {
+		const arg = ctx.nextArg("normal");
+		if (arg === null) break;
+		parts.push(arg);
+	}
+	return expandDefinedVar(parts.join(" "), (name) => ctx.settings.vars.has(name));
 };
 /**
- * Evaluate the joined expression against {@link parseBool}. Unrecognised
- * tokens surface `unrecognized value "<tok>" for "\<cmd> expression":
- * Boolean expected` to stderr (bare, no `psql: ERROR:` prefix — upstream
- * `psql_error` shape) and evaluate to false. The caller is responsible for
- * setting the stack state to `'false'` on this path. `cmdName` is the
- * caller's command identifier (`'if'` / `'elif'`) so the diagnostic matches
- * upstream verbatim.
- */
+* Evaluate the joined expression against {@link parseBool}. Unrecognised
+* tokens surface `unrecognized value "<tok>" for "\<cmd> expression":
+* Boolean expected` to stderr (bare, no `psql: ERROR:` prefix — upstream
+* `psql_error` shape) and evaluate to false. The caller is responsible for
+* setting the stack state to `'false'` on this path. `cmdName` is the
+* caller's command identifier (`'if'` / `'elif'`) so the diagnostic matches
+* upstream verbatim.
+*/
 const evalExpr = (ctx, cmdName) => {
-    const raw = collectExpr(ctx);
-    const parsed = parseBool(raw);
-    if (parsed === null) {
-        const message = `unrecognized value "${raw}" for "\\${cmdName} expression": Boolean expected`;
-        ctx.settings.lastErrorResult = { message };
-        writeErr(`${message}\n`);
-        return false;
-    }
-    return parsed;
+	const raw = collectExpr(ctx);
+	const parsed = parseBool(raw);
+	if (parsed === null) {
+		const message = `unrecognized value "${raw}" for "\\${cmdName} expression": Boolean expected`;
+		ctx.settings.lastErrorResult = { message };
+		writeErr(`${message}\n`);
+		return false;
+	}
+	return parsed;
 };
 /**
- * Marker symbol on BackslashContext.cmdName so the mainloop can recognise the
- * cond commands without an interface-pollution argument. We instead attach the
- * CondStack via a well-known field on the `settings` object — see {@link
- * attachCondStack} / {@link getCondStack}.
- *
- * The mainloop is the sole owner of the CondStack, and it threads it onto the
- * BackslashContext via this helper pair so command modules don't have to know
- * about REPLContext.
- */
+* Marker symbol on BackslashContext.cmdName so the mainloop can recognise the
+* cond commands without an interface-pollution argument. We instead attach the
+* CondStack via a well-known field on the `settings` object — see {@link
+* attachCondStack} / {@link getCondStack}.
+*
+* The mainloop is the sole owner of the CondStack, and it threads it onto the
+* BackslashContext via this helper pair so command modules don't have to know
+* about REPLContext.
+*/
 const COND_STACK_KEY = Symbol.for("neonctl.psql.condStack");
-export const attachCondStack = (ctx, cond) => {
-    const settings = ctx.settings;
-    settings[COND_STACK_KEY] = cond;
+const attachCondStack = (ctx, cond) => {
+	const settings = ctx.settings;
+	settings[COND_STACK_KEY] = cond;
 };
-export const getCondStack = (ctx) => {
-    const settings = ctx.settings;
-    const stack = settings[COND_STACK_KEY];
-    if (stack === undefined) {
-        throw new Error("cond stack not attached; cmd_cond commands must be dispatched via runMainLoop");
-    }
-    return stack;
+const getCondStack = (ctx) => {
+	const stack = ctx.settings[COND_STACK_KEY];
+	if (stack === void 0) throw new Error("cond stack not attached; cmd_cond commands must be dispatched via runMainLoop");
+	return stack;
 };
 const errResult = (ctx, message) => {
-    ctx.settings.lastErrorResult = { message };
-    // Upstream emits cond diagnostics bare via `psql_error("%s\n", ...)`: no
-    // `psql: ERROR:` prefix, no `\<cmd>:` prefix on top of the message (the
-    // message already includes it). We mirror that exactly so the regress
-    // expected output (`\elif: cannot occur after \else`) matches verbatim.
-    // The `errorWritten` flag tells the mainloop not to add its own
-    // `psql: ERROR:  <msg>` fallback line.
-    writeErr(`${message}\n`);
-    return { status: "error", errorWritten: true };
+	ctx.settings.lastErrorResult = { message };
+	writeErr(`${message}\n`);
+	return {
+		status: "error",
+		errorWritten: true
+	};
 };
 const okResult = () => ({ status: "ok" });
 /**
- * Build an `{ status: 'ok' }` result that also asks the mainloop to truncate
- * `queryBuf` back to `len`. Mirrors upstream `discard_query_text` — called
- * by `\elif` / `\else` / `\endif` when the just-completed branch was
- * INACTIVE, so the SQL text the skipped branch accumulated doesn't bleed
- * into the surrounding statement.
- */
+* Build an `{ status: 'ok' }` result that also asks the mainloop to truncate
+* `queryBuf` back to `len`. Mirrors upstream `discard_query_text` — called
+* by `\elif` / `\else` / `\endif` when the just-completed branch was
+* INACTIVE, so the SQL text the skipped branch accumulated doesn't bleed
+* into the surrounding statement.
+*/
 const truncResult = (len) => ({
-    status: "ok",
-    truncateBufTo: len,
+	status: "ok",
+	truncateBufTo: len
 });
 /**
- * `true` when {@link IfState} corresponds to a branch that was skipping
- * statements. Upstream `conditional_active` returns false for these. Used
- * by the elif/else/endif commands to decide whether the
- * `discard_query_text` step should fire on transition out of the branch.
- */
+* `true` when {@link IfState} corresponds to a branch that was skipping
+* statements. Upstream `conditional_active` returns false for these. Used
+* by the elif/else/endif commands to decide whether the
+* `discard_query_text` step should fire on transition out of the branch.
+*/
 const isInactiveState = (state) => state === "false" || state === "else-false" || state === "ignored";
-export const cmdIf = {
-    name: "if",
-    argMode: "lex",
-    async run(ctx) {
-        const cond = getCondStack(ctx);
-        // Save the queryBuf state at the point the `\if` was encountered. The
-        // mainloop dispatches the cond command AFTER folding any preceding
-        // text into `queryBuf` (e.g. the "select" in `select \if true 42 ...`),
-        // so `ctx.queryBuf.length` is exactly upstream `save_query_text_state`'s
-        // snapshot. Inactive branches will accumulate scan-time SQL we'll later
-        // roll back via `discard_query_text` (the truncate-to-saved step in the
-        // matching `\elif`/`\else`/`\endif`).
-        const savedLen = ctx.queryBuf.length;
-        if (!cond.isActive()) {
-            // Suppressed by outer: push IGNORED and drop the expression WITHOUT
-            // expanding it. Upstream `ignore_boolean_expression` calls the lexer
-            // with backticks/vars disabled (psql.sql:1028 covers this with
-            // `\if false { \if \`nosuchcommand\` ... }`).
-            dropExpr();
-            cond.push("ignored", savedLen);
-            return Promise.resolve(okResult());
-        }
-        const truthy = evalExpr(ctx, "if");
-        cond.push(truthy ? "true" : "false", savedLen);
-        return Promise.resolve(okResult());
-    },
+const cmdIf = {
+	name: "if",
+	argMode: "lex",
+	async run(ctx) {
+		const cond = getCondStack(ctx);
+		const savedLen = ctx.queryBuf.length;
+		if (!cond.isActive()) {
+			cond.push("ignored", savedLen);
+			return Promise.resolve(okResult());
+		}
+		const truthy = evalExpr(ctx, "if");
+		cond.push(truthy ? "true" : "false", savedLen);
+		return Promise.resolve(okResult());
+	}
 };
-export const cmdElif = {
-    name: "elif",
-    argMode: "lex",
-    async run(ctx) {
-        const cond = getCondStack(ctx);
-        const top = cond.top();
-        if (top === undefined) {
-            dropExpr();
-            return Promise.resolve(errResult(ctx, "\\elif: no matching \\if"));
-        }
-        // If the branch we're leaving was INACTIVE, anything its body added to
-        // `queryBuf` is scan-time accumulation we don't want — discard back to
-        // the snapshot captured at the matching `\if`/`\elif`. The truncate is
-        // applied by the mainloop; we just report the target length.
-        const wasInactive = isInactiveState(top.state);
-        const savedLen = top.savedQueryBufLen;
-        switch (top.state) {
-            case "true": {
-                // Branch already taken — flip to IGNORED. Drop the expression
-                // without expansion (regress suite: `\if true \elif \`bad\` ...`).
-                dropExpr();
-                cond.setState("ignored");
-                // Active branch — keep buffer text. Re-anchor savedQueryBufLen
-                // to the start of the new (ignored) branch so a later `\else`/
-                // `\endif` discards just this branch's additions.
-                cond.setSavedQueryBufLen(ctx.queryBuf.length);
-                return Promise.resolve(okResult());
-            }
-            case "false": {
-                // Have not yet found a true branch — evaluate this one.
-                // evalExpr emits its own `unrecognized value` diagnostic on failure
-                // and falls through to false, mirroring upstream.
-                const truthy = evalExpr(ctx, "elif");
-                cond.setState(truthy ? "true" : "false");
-                // Apply the discard (was INACTIVE) and re-anchor at the rolled-back
-                // length so the new branch's bookkeeping starts fresh.
-                cond.setSavedQueryBufLen(savedLen);
-                return wasInactive
-                    ? Promise.resolve(truncResult(savedLen))
-                    : Promise.resolve(okResult());
-            }
-            case "ignored": {
-                // Outer is suppressed — stay ignored, drop args without expanding.
-                // Still discard accumulated buffer text and re-anchor.
-                dropExpr();
-                cond.setSavedQueryBufLen(savedLen);
-                return wasInactive
-                    ? Promise.resolve(truncResult(savedLen))
-                    : Promise.resolve(okResult());
-            }
-            case "else-true":
-            case "else-false":
-                dropExpr();
-                return Promise.resolve(errResult(ctx, "\\elif: cannot occur after \\else"));
-            case "none":
-                dropExpr();
-                return Promise.resolve(errResult(ctx, "\\elif: no matching \\if"));
-        }
-    },
+const cmdElif = {
+	name: "elif",
+	argMode: "lex",
+	async run(ctx) {
+		const cond = getCondStack(ctx);
+		const top = cond.top();
+		if (top === void 0) return Promise.resolve(errResult(ctx, "\\elif: no matching \\if"));
+		const wasInactive = isInactiveState(top.state);
+		const savedLen = top.savedQueryBufLen;
+		switch (top.state) {
+			case "true":
+				cond.setState("ignored");
+				cond.setSavedQueryBufLen(ctx.queryBuf.length);
+				return Promise.resolve(okResult());
+			case "false": {
+				const truthy = evalExpr(ctx, "elif");
+				cond.setState(truthy ? "true" : "false");
+				cond.setSavedQueryBufLen(savedLen);
+				return wasInactive ? Promise.resolve(truncResult(savedLen)) : Promise.resolve(okResult());
+			}
+			case "ignored":
+				cond.setSavedQueryBufLen(savedLen);
+				return wasInactive ? Promise.resolve(truncResult(savedLen)) : Promise.resolve(okResult());
+			case "else-true":
+			case "else-false": return Promise.resolve(errResult(ctx, "\\elif: cannot occur after \\else"));
+			case "none": return Promise.resolve(errResult(ctx, "\\elif: no matching \\if"));
+		}
+	}
 };
-export const cmdElse = {
-    name: "else",
-    argMode: "lex",
-    async run(ctx) {
-        const cond = getCondStack(ctx);
-        const top = cond.top();
-        if (top === undefined) {
-            return Promise.resolve(errResult(ctx, "\\else: no matching \\if"));
-        }
-        const wasInactive = isInactiveState(top.state);
-        const savedLen = top.savedQueryBufLen;
-        switch (top.state) {
-            case "true":
-                cond.setState("else-false");
-                // Was ACTIVE — keep buffer text. Re-anchor at the current length so
-                // the upcoming else-false branch's additions can be discarded by
-                // the matching `\endif`.
-                cond.setSavedQueryBufLen(ctx.queryBuf.length);
-                return Promise.resolve(okResult());
-            case "false":
-                cond.setState("else-true");
-                cond.setSavedQueryBufLen(savedLen);
-                return wasInactive
-                    ? Promise.resolve(truncResult(savedLen))
-                    : Promise.resolve(okResult());
-            case "ignored":
-                cond.setState("else-false");
-                cond.setSavedQueryBufLen(savedLen);
-                return wasInactive
-                    ? Promise.resolve(truncResult(savedLen))
-                    : Promise.resolve(okResult());
-            case "else-true":
-            case "else-false":
-                return Promise.resolve(errResult(ctx, "\\else: cannot occur after \\else"));
-            case "none":
-                return Promise.resolve(errResult(ctx, "\\else: no matching \\if"));
-        }
-    },
+const cmdElse = {
+	name: "else",
+	argMode: "lex",
+	async run(ctx) {
+		const cond = getCondStack(ctx);
+		const top = cond.top();
+		if (top === void 0) return Promise.resolve(errResult(ctx, "\\else: no matching \\if"));
+		const wasInactive = isInactiveState(top.state);
+		const savedLen = top.savedQueryBufLen;
+		switch (top.state) {
+			case "true":
+				cond.setState("else-false");
+				cond.setSavedQueryBufLen(ctx.queryBuf.length);
+				return Promise.resolve(okResult());
+			case "false":
+				cond.setState("else-true");
+				cond.setSavedQueryBufLen(savedLen);
+				return wasInactive ? Promise.resolve(truncResult(savedLen)) : Promise.resolve(okResult());
+			case "ignored":
+				cond.setState("else-false");
+				cond.setSavedQueryBufLen(savedLen);
+				return wasInactive ? Promise.resolve(truncResult(savedLen)) : Promise.resolve(okResult());
+			case "else-true":
+			case "else-false": return Promise.resolve(errResult(ctx, "\\else: cannot occur after \\else"));
+			case "none": return Promise.resolve(errResult(ctx, "\\else: no matching \\if"));
+		}
+	}
 };
-export const cmdEndif = {
-    name: "endif",
-    argMode: "lex",
-    async run(ctx) {
-        const cond = getCondStack(ctx);
-        const top = cond.top();
-        if (top === undefined) {
-            return Promise.resolve(errResult(ctx, "\\endif: no matching \\if"));
-        }
-        const wasInactive = isInactiveState(top.state);
-        const savedLen = top.savedQueryBufLen;
-        cond.pop();
-        return wasInactive
-            ? Promise.resolve(truncResult(savedLen))
-            : Promise.resolve(okResult());
-    },
+const cmdEndif = {
+	name: "endif",
+	argMode: "lex",
+	async run(ctx) {
+		const cond = getCondStack(ctx);
+		const top = cond.top();
+		if (top === void 0) return Promise.resolve(errResult(ctx, "\\endif: no matching \\if"));
+		const wasInactive = isInactiveState(top.state);
+		const savedLen = top.savedQueryBufLen;
+		cond.pop();
+		return wasInactive ? Promise.resolve(truncResult(savedLen)) : Promise.resolve(okResult());
+	}
 };
 /** Names of the conditional commands — the mainloop dispatches these
- * unconditionally (i.e. ignoring `cond.isActive()`) so an `\if false` block
- * can still be closed by `\endif`. */
-export const COND_COMMAND_NAMES = new Set([
-    "if",
-    "elif",
-    "else",
-    "endif",
+* unconditionally (i.e. ignoring `cond.isActive()`) so an `\if false` block
+* can still be closed by `\endif`. */
+const COND_COMMAND_NAMES = /* @__PURE__ */ new Set([
+	"if",
+	"elif",
+	"else",
+	"endif"
 ]);
+//#endregion
+export { COND_COMMAND_NAMES, attachCondStack, cmdElif, cmdElse, cmdEndif, cmdIf, createCondStack, getCondStack, parseBool };