@stackables/bridge-compiler 1.0.2 → 1.0.3

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

@@ -1,349 +0,0 @@
-/**
- * Structured node reference — identifies a specific data point in the execution graph.
- *
- * Every wire has a "from" and "to", each described by a NodeRef.
- * The trunk (module + type + field + instance) identifies the node,
- * while path drills into its data.
- */
-export type NodeRef = {
-    /** Module identifier: "hereapi", "sendgrid", "zillow", or SELF_MODULE */
-    module: string;
-    /** GraphQL type ("Query" | "Mutation") or "Tools" for tool functions */
-    type: string;
-    /** Field or function name: "geocode", "search", "centsToUsd" */
-    field: string;
-    /** Instance number for tool calls (1, 2, ...) */
-    instance?: number;
-    /** References the current array element in a shadow tree (for per-element mapping) */
-    element?: boolean;
-    /** Path into the data: ["items", "0", "position", "lat"] */
-    path: string[];
-    /** True when the first `?.` is right after the root (e.g., `api?.data`) */
-    rootSafe?: boolean;
-    /** Per-segment safety flags (same length as `path`); true = `?.` before that segment */
-    pathSafe?: boolean[];
-};
-/**
- * A wire connects a data source (from) to a data sink (to).
- * Execution is pull-based: when "to" is demanded, "from" is resolved.
- *
- * Constant wires (`=`) set a fixed value on the target.
- * Pull wires (`<-`) resolve the source at runtime.
- * Pipe wires (`pipe: true`) are generated by the `<- h1:h2:source` shorthand
- * and route data through declared tool handles; the serializer collapses them
- * back to pipe notation.
- */
-export type Wire = {
-    from: NodeRef;
-    to: NodeRef;
-    pipe?: true;
-    safe?: true;
-    falsyFallbackRefs?: NodeRef[];
-    falsyFallback?: string;
-    falsyControl?: ControlFlowInstruction;
-    nullishFallback?: string;
-    nullishFallbackRef?: NodeRef;
-    nullishControl?: ControlFlowInstruction;
-    catchFallback?: string;
-    catchFallbackRef?: NodeRef;
-    catchControl?: ControlFlowInstruction;
-} | {
-    value: string;
-    to: NodeRef;
-} | {
-    cond: NodeRef;
-    thenRef?: NodeRef;
-    thenValue?: string;
-    elseRef?: NodeRef;
-    elseValue?: string;
-    to: NodeRef;
-    falsyFallbackRefs?: NodeRef[];
-    falsyFallback?: string;
-    falsyControl?: ControlFlowInstruction;
-    nullishFallback?: string;
-    nullishFallbackRef?: NodeRef;
-    nullishControl?: ControlFlowInstruction;
-    catchFallback?: string;
-    catchFallbackRef?: NodeRef;
-    catchControl?: ControlFlowInstruction;
-} | {
-    /** Short-circuit logical AND: evaluate left first, only evaluate right if left is truthy */
-    condAnd: {
-        leftRef: NodeRef;
-        rightRef?: NodeRef;
-        rightValue?: string;
-        safe?: true;
-        rightSafe?: true;
-    };
-    to: NodeRef;
-    falsyFallbackRefs?: NodeRef[];
-    falsyFallback?: string;
-    falsyControl?: ControlFlowInstruction;
-    nullishFallback?: string;
-    nullishFallbackRef?: NodeRef;
-    nullishControl?: ControlFlowInstruction;
-    catchFallback?: string;
-    catchFallbackRef?: NodeRef;
-    catchControl?: ControlFlowInstruction;
-} | {
-    /** Short-circuit logical OR: evaluate left first, only evaluate right if left is falsy */
-    condOr: {
-        leftRef: NodeRef;
-        rightRef?: NodeRef;
-        rightValue?: string;
-        safe?: true;
-        rightSafe?: true;
-    };
-    to: NodeRef;
-    falsyFallbackRefs?: NodeRef[];
-    falsyFallback?: string;
-    falsyControl?: ControlFlowInstruction;
-    nullishFallback?: string;
-    nullishFallbackRef?: NodeRef;
-    nullishControl?: ControlFlowInstruction;
-    catchFallback?: string;
-    catchFallbackRef?: NodeRef;
-    catchControl?: ControlFlowInstruction;
-};
-/**
- * Bridge definition — wires one GraphQL field to its data sources.
- */
-export type Bridge = {
-    kind: "bridge";
-    /** GraphQL type: "Query" | "Mutation" */
-    type: string;
-    /** GraphQL field name */
-    field: string;
-    /** Declared data sources and their wire handles */
-    handles: HandleBinding[];
-    /** Connection wires */
-    wires: Wire[];
-    /**
-     * When set, this bridge was declared with the passthrough shorthand:
-     * `bridge Type.field with <name>`. The value is the define/tool name.
-     */
-    passthrough?: string;
-    /** Handles to eagerly evaluate (e.g. side-effect tools).
-     *  Critical by default — a forced handle that throws aborts the bridge.
-     *  Add `catchError: true` (written as `force <handle> ?? null`) to
-     *  swallow the error for fire-and-forget side-effects. */
-    forces?: Array<{
-        handle: string;
-        module: string;
-        type: string;
-        field: string;
-        instance?: number;
-        /** When true, errors from this forced handle are silently caught (`?? null`). */
-        catchError?: true;
-    }>;
-    arrayIterators?: Record<string, string>;
-    pipeHandles?: Array<{
-        key: string;
-        handle: string;
-        baseTrunk: {
-            module: string;
-            type: string;
-            field: string;
-            instance?: number;
-        };
-    }>;
-};
-/**
- * A handle binding — declares a named data source available in a bridge.
- *
- * Every wire reference in the bridge body must trace back to one of these.
- */
-export type HandleBinding = {
-    handle: string;
-    kind: "tool";
-    name: string;
-    version?: string;
-} | {
-    handle: string;
-    kind: "input";
-} | {
-    handle: string;
-    kind: "output";
-} | {
-    handle: string;
-    kind: "context";
-} | {
-    handle: string;
-    kind: "const";
-} | {
-    handle: string;
-    kind: "define";
-    name: string;
-};
-/** Internal module identifier for the bridge's own trunk (input args + output fields) */
-export declare const SELF_MODULE = "_";
-/**
- * Tool definition — a declared tool with wires, dependencies, and optional inheritance.
- *
- * Tool blocks define reusable, composable API call configurations:
- *   tool hereapi httpCall        — root tool with function name
- *   tool hereapi.geocode extends hereapi  — child inherits parent wires
- *
- * The engine resolves extends chains, merges wires, and calls the
- * registered tool function with the fully-built input object.
- */
-export type ToolDef = {
-    kind: "tool";
-    /** Tool name: "hereapi", "sendgrid.send", "authService" */
-    name: string;
-    /** Function name — looked up in the tools map. Omitted when extends is used. */
-    fn?: string;
-    /** Parent tool name — inherits fn, deps, and wires */
-    extends?: string;
-    /** Dependencies declared via `with` inside the tool block */
-    deps: ToolDep[];
-    /** Wires: constants (`=`) and pulls (`<-`) defining the tool's input */
-    wires: ToolWire[];
-};
-/**
- * A dependency declared inside a tool block.
- *
- *   with context                 — brings the full GraphQL context into scope
- *   with authService as auth     — brings another tool's output into scope
- */
-export type ToolDep = {
-    kind: "context";
-    handle: string;
-} | {
-    kind: "tool";
-    handle: string;
-    tool: string;
-    version?: string;
-} | {
-    kind: "const";
-    handle: string;
-};
-/**
- * A wire in a tool block — either a constant value, a pull from a dependency,
- * or an error fallback.
- *
- * Examples:
- *   baseUrl = "https://api.sendgrid.com/v3"         → constant
- *   method = POST                                     → constant (unquoted)
- *   headers.Authorization <- ctx.sendgrid.token      → pull from context
- *   headers.Authorization <- auth.access_token       → pull from tool dep
- *   on error = { "lat": 0, "lon": 0 }               → constant fallback
- *   on error <- ctx.fallbacks.geo                     → pull fallback from context
- */
-export type ToolWire = {
-    target: string;
-    kind: "constant";
-    value: string;
-} | {
-    target: string;
-    kind: "pull";
-    source: string;
-} | {
-    kind: "onError";
-    value: string;
-} | {
-    kind: "onError";
-    source: string;
-};
-/**
- * Context passed to every tool function as the second argument.
- *
- * Provides access to engine services (logger, etc.) without polluting the
- * input object.  Tools that don't need it simply ignore the second arg.
- */
-export type { ToolContext, ToolCallFn, ToolMap, CacheStore, } from "@stackables/bridge-types";
-/**
- * Explicit control flow instruction — used on the right side of fallback
- * gates (`||`, `??`, `catch`) to influence execution.
- *
- *   - `throw`    — raises a standard Error with the given message
- *   - `panic`    — raises a BridgePanicError that bypasses all error boundaries
- *   - `continue` — skips the current array element (sentinel value)
- *   - `break`    — halts array iteration (sentinel value)
- */
-export type ControlFlowInstruction = {
-    kind: "throw";
-    message: string;
-} | {
-    kind: "panic";
-    message: string;
-} | {
-    kind: "continue";
-} | {
-    kind: "break";
-};
-/**
- * Named constant definition — a reusable value defined in the bridge file.
- *
- * Constants are available in bridge blocks via `with const as c` and in tool
- * blocks via `with const`. The engine collects all ConstDef instructions into
- * a single namespace object keyed by name.
- *
- * Examples:
- *   const fallbackGeo = { "lat": 0, "lon": 0 }
- *   const defaultCurrency = "EUR"
- */
-export type ConstDef = {
-    kind: "const";
-    /** Constant name — used as the key in the const namespace */
-    name: string;
-    /** Raw JSON string — parsed at runtime when accessed */
-    value: string;
-};
-/**
- * Version declaration — records the bridge file's declared language version.
- *
- * Emitted by the parser as the first instruction. Used at runtime to verify
- * that the standard library satisfies the bridge's minimum version requirement.
- *
- * Example:  `version 1.5`  →  `{ kind: "version", version: "1.5" }`
- */
-export type VersionDecl = {
-    kind: "version";
-    /** Declared version string, e.g. "1.5" */
-    version: string;
-};
-/** Union of all instruction types (excludes VersionDecl — version lives on BridgeDocument) */
-export type Instruction = Bridge | ToolDef | ConstDef | DefineDef;
-/**
- * Parsed bridge document — the structured output of the compiler.
- *
- * Wraps the instruction array with document-level metadata (version) and
- * provides a natural home for future pre-computed optimisations.
- */
-export interface BridgeDocument {
-    /** Declared language version (from `version X.Y` header). */
-    version?: string;
-    /** All instructions: bridge, tool, const, and define blocks. */
-    instructions: Instruction[];
-}
-/**
- * Define block — a reusable named subgraph (pipeline / macro).
- *
- * At parse time a define is stored as a template.  When a bridge declares
- * `with <define> as <handle>`, the define's handles and wires are inlined
- * into the bridge with namespaced identifiers for isolation.
- *
- * Example:
- *   define secureProfile {
- *     with userApi as api
- *     with input as i
- *     with output as o
- *     api.id <- i.userId
- *     o.name <- api.login
- *   }
- */
-export type DefineDef = {
-    kind: "define";
-    /** Define name — referenced in bridge `with` declarations */
-    name: string;
-    /** Declared handles (tools, input, output, etc.) */
-    handles: HandleBinding[];
-    /** Connection wires (same format as Bridge wires) */
-    wires: Wire[];
-    /** Array iterators (same as Bridge) */
-    arrayIterators?: Record<string, string>;
-    /** Pipe fork registry (same as Bridge) */
-    pipeHandles?: Bridge["pipeHandles"];
-};
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../bridge-core/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,IAAI,GACZ;IACE,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC,GACD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GAC9B;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC,GACD;IACE,4FAA4F;IAC5F,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IACF,EAAE,EAAE,OAAO,CAAC;IACZ,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC,GACD;IACE,0FAA0F;IAC1F,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,CAAC;IACF,EAAE,EAAE,OAAO,CAAC;IACZ,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,uBAAuB;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;8DAG0D;IAC1D,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iFAAiF;QACjF,UAAU,CAAC,EAAE,IAAI,CAAC;KACnB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE;YACT,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC,CAAC;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,yFAAyF;AACzF,eAAO,MAAM,WAAW,MAAM,CAAC;AAI/B;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,wEAAwE;IACxE,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC;;;;;GAKG;AAGH,YAAY,EACV,WAAW,EACX,UAAU,EACV,OAAO,EACP,UAAU,GACX,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,8FAA8F;AAC9F,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,qDAAqD;IACrD,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;CACrC,CAAC"}

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

@@ -1,3 +0,0 @@
-/** Internal module identifier for the bridge's own trunk (input args + output fields) */
-export const SELF_MODULE = "_";
-/* c8 ignore stop */

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

@@ -1,9 +0,0 @@
-/**
- * Shared utilities for the Bridge runtime.
- */
-/**
- * Split a dotted path string into path segments, expanding array indices.
- * e.g. "items[0].name" → ["items", "0", "name"]
- */
-export declare function parsePath(text: string): string[];
-//# sourceMappingURL=utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../bridge-core/src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAchD"}

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

@@ -1,23 +0,0 @@
-/**
- * Shared utilities for the Bridge runtime.
- */
-/**
- * Split a dotted path string into path segments, expanding array indices.
- * e.g. "items[0].name" → ["items", "0", "name"]
- */
-export function parsePath(text) {
-    const parts = [];
-    for (const segment of text.split(".")) {
-        const match = segment.match(/^([^[]+)(?:\[(\d*)\])?$/);
-        if (match) {
-            parts.push(match[1]);
-            if (match[2] !== undefined && match[2] !== "") {
-                parts.push(match[2]);
-            }
-        }
-        else {
-            parts.push(segment);
-        }
-    }
-    return parts;
-}

package/build/bridge-core/src/version-check.d.ts

@@ -1,64 +0,0 @@
-import type { BridgeDocument, Instruction, ToolMap } from "./types.ts";
-/**
- * Extract the declared bridge version from a document.
- * Returns `undefined` if no version was declared.
- */
-export declare function getBridgeVersion(doc: BridgeDocument): string | undefined;
-/**
- * Verify that the standard library satisfies the bridge file's declared version.
- *
- * The bridge `version X.Y` header acts as a minimum-version constraint:
- *  - Same major  → compatible (only major bumps introduce breaking changes)
- *  - Bridge minor ≤ std minor → OK (std is same or newer)
- *  - Bridge minor > std minor → ERROR (bridge needs features not in this std)
- *  - Different major → ERROR (user must provide a compatible std explicitly)
- *
- * @throws Error with an actionable message when the std is incompatible.
- */
-export declare function checkStdVersion(version: string | undefined, stdVersion: string): void;
-/**
- * Resolve the standard library namespace and version to use.
- *
- * Checks the bundled std first.  When the bridge file targets a different
- * major version (e.g. `version 1.5` vs bundled `2.0.0`), scans the
- * user-provided tools map for a versioned namespace key like `"std@1.5"`.
- *
- * @returns The resolved std namespace and its version string.
- * @throws Error with an actionable message when no compatible std is found.
- */
-export declare function resolveStd(version: string | undefined, bundledStd: ToolMap, bundledStdVersion: string, userTools?: ToolMap): {
-    namespace: ToolMap;
-    version: string;
-};
-/**
- * Collect every tool reference that carries an `@version` tag from handles
- * (bridge/define blocks) and deps (tool blocks).
- */
-export declare function collectVersionedHandles(instructions: Instruction[]): Array<{
-    name: string;
-    version: string;
-}>;
-/**
- * Check whether a versioned dotted tool name can be resolved.
- *
- * In addition to the standard checks (namespace traversal, flat key),
- * this also checks **versioned namespace keys** in the tool map:
- *   - `"std.str.toLowerCase@999.1"` as a flat key
- *   - `"std.str@999.1"` as a namespace key containing `toLowerCase`
- *   - `"std@999.1"` as a namespace key, traversing to `str.toLowerCase`
- */
-export declare function hasVersionedToolFn(toolFns: ToolMap, name: string, version: string): boolean;
-/**
- * Validate that all versioned tool handles can be satisfied at runtime.
- *
- * For each handle with `@version`:
- * 1. A versioned key or versioned namespace in the tool map → satisfied
- * 2. A `std.*` tool whose STD_VERSION ≥ the requested version → satisfied
- * 3. Otherwise → throws with an actionable error message
- *
- * Call this **before** constructing the ExecutionTree to fail early.
- *
- * @throws Error when a versioned tool cannot be satisfied.
- */
-export declare function checkHandleVersions(instructions: Instruction[], toolFns: ToolMap, stdVersion: string): void;
-//# sourceMappingURL=version-check.d.ts.map

package/build/bridge-core/src/version-check.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../../../bridge-core/src/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EAEd,WAAW,EAEX,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,GACjB,IAAI,CAuBN;AAID;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,OAAO,EACnB,iBAAiB,EAAE,MAAM,EACzB,SAAS,GAAE,OAAY,GACtB;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA4CzC;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,WAAW,EAAE,GAC1B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB1C;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CA8BT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,IAAI,CA6BN"}

package/build/bridge-core/src/version-check.js

@@ -1,205 +0,0 @@
-/**
- * Extract the declared bridge version from a document.
- * Returns `undefined` if no version was declared.
- */
-export function getBridgeVersion(doc) {
-    return doc.version;
-}
-/**
- * Verify that the standard library satisfies the bridge file's declared version.
- *
- * The bridge `version X.Y` header acts as a minimum-version constraint:
- *  - Same major  → compatible (only major bumps introduce breaking changes)
- *  - Bridge minor ≤ std minor → OK (std is same or newer)
- *  - Bridge minor > std minor → ERROR (bridge needs features not in this std)
- *  - Different major → ERROR (user must provide a compatible std explicitly)
- *
- * @throws Error with an actionable message when the std is incompatible.
- */
-export function checkStdVersion(version, stdVersion) {
-    if (!version)
-        return; // no version declared — nothing to check
-    const bParts = version.split(".").map(Number);
-    const sParts = stdVersion.split(".").map(Number);
-    const [bMajor = 0, bMinor = 0] = bParts;
-    const [sMajor = 0, sMinor = 0] = sParts;
-    if (bMajor !== sMajor) {
-        throw new Error(`Bridge version ${version} requires a ${bMajor}.x standard library, ` +
-            `but the provided std is ${stdVersion} (major version ${sMajor}). ` +
-            `Provide a compatible std as "std@${version}" in the tools map.`);
-    }
-    if (bMinor > sMinor) {
-        throw new Error(`Bridge version ${version} requires standard library ≥ ${bMajor}.${bMinor}, ` +
-            `but the installed @stackables/bridge-stdlib is ${stdVersion}. ` +
-            `Update @stackables/bridge-stdlib to ${bMajor}.${bMinor}.0 or later.`);
-    }
-}
-// ── Std resolution from tools map ───────────────────────────────────────────
-/**
- * Resolve the standard library namespace and version to use.
- *
- * Checks the bundled std first.  When the bridge file targets a different
- * major version (e.g. `version 1.5` vs bundled `2.0.0`), scans the
- * user-provided tools map for a versioned namespace key like `"std@1.5"`.
- *
- * @returns The resolved std namespace and its version string.
- * @throws Error with an actionable message when no compatible std is found.
- */
-export function resolveStd(version, bundledStd, bundledStdVersion, userTools = {}) {
-    if (!version) {
-        return { namespace: bundledStd, version: bundledStdVersion };
-    }
-    const [bMajor = 0, bMinor = 0] = version.split(".").map(Number);
-    const [sMajor = 0, sMinor = 0] = bundledStdVersion.split(".").map(Number);
-    // Bundled std satisfies the bridge version
-    if (bMajor === sMajor && sMinor >= bMinor) {
-        return { namespace: bundledStd, version: bundledStdVersion };
-    }
-    // Scan tools for a versioned std namespace key (e.g. "std@1.5")
-    for (const key of Object.keys(userTools)) {
-        const match = key.match(/^std@(.+)$/);
-        if (match) {
-            const ver = match[1];
-            const parts = ver.split(".").map(Number);
-            const [vMajor = 0, vMinor = 0] = parts;
-            if (vMajor === bMajor && vMinor >= bMinor) {
-                const ns = userTools[key];
-                if (ns != null && typeof ns === "object" && !Array.isArray(ns)) {
-                    const fullVersion = parts.length <= 2 ? `${ver}.0` : ver;
-                    return { namespace: ns, version: fullVersion };
-                }
-            }
-        }
-    }
-    // No compatible std found — produce actionable error
-    if (bMajor !== sMajor) {
-        throw new Error(`Bridge version ${version} requires a ${bMajor}.x standard library, ` +
-            `but the bundled std is ${bundledStdVersion} (major version ${sMajor}). ` +
-            `Provide a compatible std as "std@${version}" in the tools map.`);
-    }
-    throw new Error(`Bridge version ${version} requires standard library ≥ ${bMajor}.${bMinor}, ` +
-        `but the installed @stackables/bridge-stdlib is ${bundledStdVersion}. ` +
-        `Update @stackables/bridge-stdlib to ${bMajor}.${bMinor}.0 or later.`);
-}
-// ── Versioned handle validation ─────────────────────────────────────────────
-/**
- * Collect every tool reference that carries an `@version` tag from handles
- * (bridge/define blocks) and deps (tool blocks).
- */
-export function collectVersionedHandles(instructions) {
-    const result = [];
-    for (const inst of instructions) {
-        if (inst.kind === "bridge" || inst.kind === "define") {
-            for (const h of inst.handles) {
-                if (h.kind === "tool" && h.version) {
-                    result.push({ name: h.name, version: h.version });
-                }
-            }
-        }
-        if (inst.kind === "tool") {
-            for (const dep of inst.deps) {
-                if (dep.kind === "tool" && dep.version) {
-                    result.push({ name: dep.tool, version: dep.version });
-                }
-            }
-        }
-    }
-    return result;
-}
-/**
- * Check whether a dotted tool name resolves to a function in the tool map.
- * Supports both namespace traversal (std.str.toUpperCase) and flat keys.
- */
-function hasToolFn(toolFns, name) {
-    if (name.includes(".")) {
-        const parts = name.split(".");
-        let current = toolFns;
-        for (const part of parts) {
-            if (current == null || typeof current !== "object") {
-                current = undefined;
-                break;
-            }
-            current = current[part];
-        }
-        if (typeof current === "function")
-            return true;
-        // flat key fallback
-        return typeof toolFns[name] === "function";
-    }
-    return typeof toolFns[name] === "function";
-}
-/**
- * Check whether a versioned dotted tool name can be resolved.
- *
- * In addition to the standard checks (namespace traversal, flat key),
- * this also checks **versioned namespace keys** in the tool map:
- *   - `"std.str.toLowerCase@999.1"` as a flat key
- *   - `"std.str@999.1"` as a namespace key containing `toLowerCase`
- *   - `"std@999.1"` as a namespace key, traversing to `str.toLowerCase`
- */
-export function hasVersionedToolFn(toolFns, name, version) {
-    const versionedKey = `${name}@${version}`;
-    // 1. Flat key or direct namespace traversal
-    if (hasToolFn(toolFns, versionedKey))
-        return true;
-    // 2. Versioned namespace key lookup
-    //    For "std.str.toLowerCase" @ "999.1", try:
-    //      toolFns["std.str@999.1"]?.toLowerCase
-    //      toolFns["std@999.1"]?.str?.toLowerCase
-    if (name.includes(".")) {
-        const parts = name.split(".");
-        for (let i = parts.length - 1; i >= 1; i--) {
-            const nsKey = parts.slice(0, i).join(".") + "@" + version;
-            const remainder = parts.slice(i);
-            let ns = toolFns[nsKey];
-            if (ns != null && typeof ns === "object") {
-                for (const part of remainder) {
-                    if (ns == null || typeof ns !== "object") {
-                        ns = undefined;
-                        break;
-                    }
-                    ns = ns[part];
-                }
-                if (typeof ns === "function")
-                    return true;
-            }
-        }
-    }
-    return false;
-}
-/**
- * Validate that all versioned tool handles can be satisfied at runtime.
- *
- * For each handle with `@version`:
- * 1. A versioned key or versioned namespace in the tool map → satisfied
- * 2. A `std.*` tool whose STD_VERSION ≥ the requested version → satisfied
- * 3. Otherwise → throws with an actionable error message
- *
- * Call this **before** constructing the ExecutionTree to fail early.
- *
- * @throws Error when a versioned tool cannot be satisfied.
- */
-export function checkHandleVersions(instructions, toolFns, stdVersion) {
-    const versioned = collectVersionedHandles(instructions);
-    for (const { name, version } of versioned) {
-        // 1. Flat key, namespace traversal, or versioned namespace key
-        if (hasVersionedToolFn(toolFns, name, version))
-            continue;
-        // 2. For std.* tools, check if the active std satisfies the version
-        if (name.startsWith("std.")) {
-            const sParts = stdVersion.split(".").map(Number);
-            const vParts = version.split(".").map(Number);
-            const [sMajor = 0, sMinor = 0] = sParts;
-            const [vMajor = 0, vMinor = 0] = vParts;
-            if (sMajor === vMajor && sMinor >= vMinor)
-                continue;
-            throw new Error(`Tool "${name}@${version}" requires standard library ≥ ${vMajor}.${vMinor}, ` +
-                `but the installed @stackables/bridge-stdlib is ${stdVersion}. ` +
-                `Either update the stdlib or provide the tool as ` +
-                `"${name}@${version}" in the tools map.`);
-        }
-        // 3. Non-std tool — must be provided with a versioned key or namespace
-        throw new Error(`Tool "${name}@${version}" is not available. ` +
-            `Provide it as "${name}@${version}" in the tools map.`);
-    }
-}