@stackables/bridge-compiler 1.0.0 → 1.0.2

package/build/bridge-core/src/execute-bridge.d.ts

@@ -0,0 +1,69 @@
+import type { Logger, ToolTrace, TraceLevel } from "./ExecutionTree.ts";
+import type { BridgeDocument, ToolMap } from "./types.ts";
+export type ExecuteBridgeOptions = {
+    /** Parsed bridge document (from `parseBridge` or `parseBridgeDiagnostics`). */
+    document: BridgeDocument;
+    /**
+     * Which bridge to execute, as `"Type.field"`.
+     * Mirrors the `bridge Type.field { ... }` declaration.
+     * Example: `"Query.searchTrains"` or `"Mutation.sendEmail"`.
+     */
+    operation: string;
+    /** Input arguments — equivalent to GraphQL field arguments. */
+    input?: Record<string, unknown>;
+    /**
+     * Tool functions available to the engine.
+     *
+     * Supports namespaced nesting: `{ myNamespace: { myTool } }`.
+     * The built-in `std` namespace is always included; user tools are
+     * merged on top (shallow).
+     *
+     * To provide a specific version of std (e.g. when the bridge file
+     * targets an older major), use a versioned namespace key:
+     * ```ts
+     * tools: { "std@1.5": oldStdNamespace }
+     * ```
+     */
+    tools?: ToolMap;
+    /** Context available via `with context as ctx` inside the bridge. */
+    context?: Record<string, unknown>;
+    /**
+     * Enable tool-call tracing.
+     * - `"off"` (default) — no collection, zero overhead
+     * - `"basic"` — tool, fn, timing, errors; no input/output
+     * - `"full"` — everything including input and output
+     */
+    trace?: TraceLevel;
+    /** Structured logger for engine events. */
+    logger?: Logger;
+    /** External abort signal — cancels execution when triggered. */
+    signal?: AbortSignal;
+};
+export type ExecuteBridgeResult<T = unknown> = {
+    data: T;
+    traces: ToolTrace[];
+};
+/**
+ * Execute a bridge operation without GraphQL.
+ *
+ * Runs a bridge file's data-wiring logic standalone — no schema, no server,
+ * no HTTP layer required. Useful for CLI tools, background jobs, tests, and
+ * any context where you want Bridge's declarative data-fetching outside of
+ * a GraphQL server.
+ *
+ * @example
+ * ```ts
+ * import { parseBridge, executeBridge } from "@stackables/bridge";
+ * import { readFileSync } from "node:fs";
+ *
+ * const document = parseBridge(readFileSync("my.bridge", "utf8"));
+ * const { data } = await executeBridge({
+ *   document,
+ *   operation: "Query.myField",
+ *   input: { city: "Berlin" },
+ * });
+ * console.log(data);
+ * ```
+ */
+export declare function executeBridge<T = unknown>(options: ExecuteBridgeOptions): Promise<ExecuteBridgeResult<T>>;
+//# sourceMappingURL=execute-bridge.d.ts.map

package/build/bridge-core/src/execute-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-bridge.d.ts","sourceRoot":"","sources":["../../../../bridge-core/src/execute-bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ1D,MAAM,MAAM,oBAAoB,GAAG;IACjC,+EAA+E;IAC/E,QAAQ,EAAE,cAAc,CAAC;IACzB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC7C,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAyCjC"}

package/build/bridge-core/src/execute-bridge.js

@@ -0,0 +1,52 @@
+import { ExecutionTree, TraceCollector } from "./ExecutionTree.js";
+import { SELF_MODULE } from "./types.js";
+import { std as bundledStd, STD_VERSION as BUNDLED_STD_VERSION, } from "@stackables/bridge-stdlib";
+import { resolveStd, checkHandleVersions } from "./version-check.js";
+/**
+ * Execute a bridge operation without GraphQL.
+ *
+ * Runs a bridge file's data-wiring logic standalone — no schema, no server,
+ * no HTTP layer required. Useful for CLI tools, background jobs, tests, and
+ * any context where you want Bridge's declarative data-fetching outside of
+ * a GraphQL server.
+ *
+ * @example
+ * ```ts
+ * import { parseBridge, executeBridge } from "@stackables/bridge";
+ * import { readFileSync } from "node:fs";
+ *
+ * const document = parseBridge(readFileSync("my.bridge", "utf8"));
+ * const { data } = await executeBridge({
+ *   document,
+ *   operation: "Query.myField",
+ *   input: { city: "Berlin" },
+ * });
+ * console.log(data);
+ * ```
+ */
+export async function executeBridge(options) {
+    const { document: doc, operation, input = {}, context = {} } = options;
+    const parts = operation.split(".");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new Error(`Invalid operation "${operation}" — expected "Type.field" (e.g. "Query.myField")`);
+    }
+    const [type, field] = parts;
+    const trunk = { module: SELF_MODULE, type, field };
+    const userTools = options.tools ?? {};
+    // Resolve which std to use: bundled, or a versioned namespace from tools
+    const { namespace: activeStd, version: activeStdVersion } = resolveStd(doc.version, bundledStd, BUNDLED_STD_VERSION, userTools);
+    const allTools = { std: activeStd, ...userTools };
+    // Verify all @version-tagged handles can be satisfied
+    checkHandleVersions(doc.instructions, allTools, activeStdVersion);
+    const tree = new ExecutionTree(trunk, doc, allTools, context);
+    if (options.logger)
+        tree.logger = options.logger;
+    if (options.signal)
+        tree.signal = options.signal;
+    const traceLevel = options.trace ?? "off";
+    if (traceLevel !== "off") {
+        tree.tracer = new TraceCollector(traceLevel);
+    }
+    const data = await tree.run(input);
+    return { data: data, traces: tree.getTraces() };
+}

package/build/bridge-core/src/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @stackables/bridge-core — The Bridge runtime engine.
+ *
+ * Contains the execution engine, type system, internal tools (math, logic,
+ * string concat), and utilities.  Given pre-parsed `Instruction[]` (JSON AST),
+ * you can execute a bridge without pulling in the parser (Chevrotain) or
+ * GraphQL dependencies.
+ */
+export { executeBridge } from "./execute-bridge.ts";
+export type { ExecuteBridgeOptions, ExecuteBridgeResult, } from "./execute-bridge.ts";
+export { checkStdVersion, checkHandleVersions, collectVersionedHandles, getBridgeVersion, hasVersionedToolFn, resolveStd, } from "./version-check.ts";
+export { mergeBridgeDocuments } from "./merge-documents.ts";
+export { ExecutionTree, TraceCollector, BridgeAbortError, BridgePanicError, MAX_EXECUTION_DEPTH, } from "./ExecutionTree.ts";
+export type { Logger, ToolTrace, TraceLevel } from "./ExecutionTree.ts";
+export { SELF_MODULE } from "./types.ts";
+export type { Bridge, BridgeDocument, CacheStore, ConstDef, ControlFlowInstruction, DefineDef, HandleBinding, Instruction, NodeRef, ToolCallFn, ToolContext, ToolDef, ToolDep, ToolMap, ToolWire, VersionDecl, Wire, } from "./types.ts";
+export { parsePath } from "./utils.ts";
+//# sourceMappingURL=index.d.ts.map

package/build/bridge-core/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../bridge-core/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIxE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EACV,MAAM,EACN,cAAc,EACd,UAAU,EACV,QAAQ,EACR,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,WAAW,EACX,OAAO,EACP,UAAU,EACV,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACP,QAAQ,EACR,WAAW,EACX,IAAI,GACL,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/build/bridge-core/src/index.js

@@ -0,0 +1,20 @@
+/**
+ * @stackables/bridge-core — The Bridge runtime engine.
+ *
+ * Contains the execution engine, type system, internal tools (math, logic,
+ * string concat), and utilities.  Given pre-parsed `Instruction[]` (JSON AST),
+ * you can execute a bridge without pulling in the parser (Chevrotain) or
+ * GraphQL dependencies.
+ */
+// ── Runtime engine ──────────────────────────────────────────────────────────
+export { executeBridge } from "./execute-bridge.js";
+// ── Version check ───────────────────────────────────────────────────────────
+export { checkStdVersion, checkHandleVersions, collectVersionedHandles, getBridgeVersion, hasVersionedToolFn, resolveStd, } from "./version-check.js";
+// ── Document utilities ──────────────────────────────────────────────────────
+export { mergeBridgeDocuments } from "./merge-documents.js";
+// ── Execution tree (advanced) ───────────────────────────────────────────────
+export { ExecutionTree, TraceCollector, BridgeAbortError, BridgePanicError, MAX_EXECUTION_DEPTH, } from "./ExecutionTree.js";
+// ── Types ───────────────────────────────────────────────────────────────────
+export { SELF_MODULE } from "./types.js";
+// ── Utilities ───────────────────────────────────────────────────────────────
+export { parsePath } from "./utils.js";

package/build/bridge-core/src/merge-documents.d.ts

@@ -0,0 +1,25 @@
+import type { BridgeDocument } from "./types.ts";
+/**
+ * Merge multiple `BridgeDocument`s into one.
+ *
+ * Instructions are concatenated in order. For the version field, the
+ * **highest** declared version wins — this preserves the strictest
+ * compatibility requirement across all source documents. Documents
+ * without a version are silently skipped during version resolution.
+ *
+ * Top-level names (bridges, tools, constants, defines) must be globally
+ * unique across all merged documents. Duplicates cause an immediate error
+ * rather than silently shadowing one another.
+ *
+ * @throws Error when documents declare different **major** versions
+ *         (e.g. merging a `1.x` and `2.x` document is not allowed).
+ * @throws Error when documents define duplicate top-level names.
+ *
+ * @example
+ * ```ts
+ * const merged = mergeBridgeDocuments(weatherDoc, quotesDoc, authDoc);
+ * const schema = bridgeTransform(baseSchema, merged, { tools });
+ * ```
+ */
+export declare function mergeBridgeDocuments(...docs: BridgeDocument[]): BridgeDocument;
+//# sourceMappingURL=merge-documents.d.ts.map

package/build/bridge-core/src/merge-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-documents.d.ts","sourceRoot":"","sources":["../../../../bridge-core/src/merge-documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,IAAI,EAAE,cAAc,EAAE,GACxB,cAAc,CA8BhB"}

package/build/bridge-core/src/merge-documents.js

@@ -0,0 +1,91 @@
+/**
+ * Merge multiple `BridgeDocument`s into one.
+ *
+ * Instructions are concatenated in order. For the version field, the
+ * **highest** declared version wins — this preserves the strictest
+ * compatibility requirement across all source documents. Documents
+ * without a version are silently skipped during version resolution.
+ *
+ * Top-level names (bridges, tools, constants, defines) must be globally
+ * unique across all merged documents. Duplicates cause an immediate error
+ * rather than silently shadowing one another.
+ *
+ * @throws Error when documents declare different **major** versions
+ *         (e.g. merging a `1.x` and `2.x` document is not allowed).
+ * @throws Error when documents define duplicate top-level names.
+ *
+ * @example
+ * ```ts
+ * const merged = mergeBridgeDocuments(weatherDoc, quotesDoc, authDoc);
+ * const schema = bridgeTransform(baseSchema, merged, { tools });
+ * ```
+ */
+export function mergeBridgeDocuments(...docs) {
+    if (docs.length === 0) {
+        return { instructions: [] };
+    }
+    if (docs.length === 1) {
+        return docs[0];
+    }
+    const version = resolveVersion(docs);
+    const instructions = [];
+    // Track global namespaces to prevent collisions across merged files
+    const seenDefs = new Set();
+    for (const doc of docs) {
+        for (const inst of doc.instructions) {
+            const key = instructionKey(inst);
+            if (key) {
+                if (seenDefs.has(key)) {
+                    throw new Error(`Merge conflict: duplicate ${key.replace(":", " '")}' across bridge documents.`);
+                }
+                seenDefs.add(key);
+            }
+            instructions.push(inst);
+        }
+    }
+    return { version, instructions };
+}
+// ── Internal ────────────────────────────────────────────────────────────────
+/** Unique key for a top-level instruction, used for collision detection. */
+function instructionKey(inst) {
+    switch (inst.kind) {
+        case "const":
+            return `const:${inst.name}`;
+        case "tool":
+            return `tool:${inst.name}`;
+        case "define":
+            return `define:${inst.name}`;
+        case "bridge":
+            return `bridge:${inst.type}.${inst.field}`;
+    }
+}
+/**
+ * Pick the highest declared version, ensuring all documents share the same
+ * major.  Returns `undefined` when no document declares a version.
+ */
+function resolveVersion(docs) {
+    let best;
+    let bestMajor = -1;
+    let bestMinor = -1;
+    let bestPatch = -1;
+    for (const doc of docs) {
+        if (!doc.version)
+            continue;
+        const parts = doc.version.split(".").map(Number);
+        const [major = 0, minor = 0, patch = 0] = parts;
+        if (best !== undefined && major !== bestMajor) {
+            throw new Error(`Cannot merge bridge documents with different major versions: ` +
+                `${best} vs ${doc.version}. ` +
+                `Split them into separate bridgeTransform calls instead.`);
+        }
+        if (major > bestMajor ||
+            (major === bestMajor && minor > bestMinor) ||
+            (major === bestMajor && minor === bestMinor && patch > bestPatch)) {
+            best = doc.version;
+            bestMajor = major;
+            bestMinor = minor;
+            bestPatch = patch;
+        }
+    }
+    return best;
+}

package/build/bridge-core/src/tools/index.d.ts

@@ -0,0 +1,2 @@
+export * as internal from "./internal.ts";
+//# sourceMappingURL=index.d.ts.map

package/build/bridge-core/src/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../bridge-core/src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC"}

package/build/bridge-core/src/tools/index.js

@@ -0,0 +1 @@
+export * as internal from "./internal.js";

package/build/bridge-core/src/tools/internal.d.ts

@@ -0,0 +1,71 @@
+/** Add two numbers. Returns `a + b`. */
+export declare function add(opts: {
+    a: number;
+    b: number;
+}): number;
+/** Subtract two numbers. Returns `a - b`. */
+export declare function subtract(opts: {
+    a: number;
+    b: number;
+}): number;
+/** Multiply two numbers. Returns `a * b`. */
+export declare function multiply(opts: {
+    a: number;
+    b: number;
+}): number;
+/** Divide two numbers. Returns `a / b`. */
+export declare function divide(opts: {
+    a: number;
+    b: number;
+}): number;
+/** Strict equality. Returns `true` if `a === b`, `false` otherwise. */
+export declare function eq(opts: {
+    a: any;
+    b: any;
+}): boolean;
+/** Strict inequality. Returns `true` if `a !== b`, `false` otherwise. */
+export declare function neq(opts: {
+    a: any;
+    b: any;
+}): boolean;
+/** Greater than. Returns `true` if `a > b`, `false` otherwise. */
+export declare function gt(opts: {
+    a: number;
+    b: number;
+}): boolean;
+/** Greater than or equal. Returns `true` if `a >= b`, `false` otherwise. */
+export declare function gte(opts: {
+    a: number;
+    b: number;
+}): boolean;
+/** Less than. Returns `true` if `a < b`, `false` otherwise. */
+export declare function lt(opts: {
+    a: number;
+    b: number;
+}): boolean;
+/** Less than or equal. Returns `true` if `a <= b`, `false` otherwise. */
+export declare function lte(opts: {
+    a: number;
+    b: number;
+}): boolean;
+/** Logical NOT. Returns `true` if `a` is falsy. */
+export declare function not(opts: {
+    a: any;
+}): boolean;
+/** Logical AND. Returns `true` if both `a` and `b` are truthy. */
+export declare function and(opts: {
+    a: any;
+    b: any;
+}): boolean;
+/** Logical OR. Returns `true` if either `a` or `b` is truthy. */
+export declare function or(opts: {
+    a: any;
+    b: any;
+}): boolean;
+/** String concatenation. Joins all parts into a single string. */
+export declare function concat(opts: {
+    parts: unknown[];
+}): {
+    value: string;
+};
+//# sourceMappingURL=internal.d.ts.map

package/build/bridge-core/src/tools/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../../../bridge-core/src/tools/internal.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,wBAAgB,GAAG,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE1D;AACD,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/D;AACD,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/D;AACD,2CAA2C;AAC3C,wBAAgB,MAAM,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE7D;AACD,uEAAuE;AACvE,wBAAgB,EAAE,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,GAAG,CAAC;IAAC,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,OAAO,CAEpD;AACD,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,GAAG,CAAC;IAAC,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,OAAO,CAErD;AACD,kEAAkE;AAClE,wBAAgB,EAAE,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE1D;AACD,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE3D;AACD,+DAA+D;AAC/D,wBAAgB,EAAE,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE1D;AACD,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE3D;AACD,mDAAmD;AACnD,wBAAgB,GAAG,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,OAAO,CAE7C;AACD,kEAAkE;AAClE,wBAAgB,GAAG,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,GAAG,CAAC;IAAC,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,OAAO,CAErD;AACD,iEAAiE;AACjE,wBAAgB,EAAE,CAAC,IAAI,EAAE;IAAE,CAAC,EAAE,GAAG,CAAC;IAAC,CAAC,EAAE,GAAG,CAAA;CAAE,GAAG,OAAO,CAEpD;AACD,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAKpE"}

package/build/bridge-core/src/tools/internal.js

@@ -0,0 +1,59 @@
+/** Add two numbers. Returns `a + b`. */
+export function add(opts) {
+    return Number(opts.a) + Number(opts.b);
+}
+/** Subtract two numbers. Returns `a - b`. */
+export function subtract(opts) {
+    return Number(opts.a) - Number(opts.b);
+}
+/** Multiply two numbers. Returns `a * b`. */
+export function multiply(opts) {
+    return Number(opts.a) * Number(opts.b);
+}
+/** Divide two numbers. Returns `a / b`. */
+export function divide(opts) {
+    return Number(opts.a) / Number(opts.b);
+}
+/** Strict equality. Returns `true` if `a === b`, `false` otherwise. */
+export function eq(opts) {
+    return opts.a === opts.b;
+}
+/** Strict inequality. Returns `true` if `a !== b`, `false` otherwise. */
+export function neq(opts) {
+    return opts.a !== opts.b;
+}
+/** Greater than. Returns `true` if `a > b`, `false` otherwise. */
+export function gt(opts) {
+    return Number(opts.a) > Number(opts.b);
+}
+/** Greater than or equal. Returns `true` if `a >= b`, `false` otherwise. */
+export function gte(opts) {
+    return Number(opts.a) >= Number(opts.b);
+}
+/** Less than. Returns `true` if `a < b`, `false` otherwise. */
+export function lt(opts) {
+    return Number(opts.a) < Number(opts.b);
+}
+/** Less than or equal. Returns `true` if `a <= b`, `false` otherwise. */
+export function lte(opts) {
+    return Number(opts.a) <= Number(opts.b);
+}
+/** Logical NOT. Returns `true` if `a` is falsy. */
+export function not(opts) {
+    return !opts.a;
+}
+/** Logical AND. Returns `true` if both `a` and `b` are truthy. */
+export function and(opts) {
+    return Boolean(opts.a) && Boolean(opts.b);
+}
+/** Logical OR. Returns `true` if either `a` or `b` is truthy. */
+export function or(opts) {
+    return Boolean(opts.a) || Boolean(opts.b);
+}
+/** String concatenation. Joins all parts into a single string. */
+export function concat(opts) {
+    const result = (opts.parts ?? [])
+        .map((v) => (v == null ? "" : String(v)))
+        .join("");
+    return { value: result };
+}