@bian-womp/spark-graph 0.3.88 → 0.3.90

package/lib/src/builder/Registry.js

@@ -0,0 +1,390 @@
+export class CategoryRegistry {
+    constructor() {
+        this.categories = new Map();
+    }
+    register(cat) {
+        this.categories.set(cat.id, cat);
+        return this;
+    }
+    get(id) {
+        return this.categories.get(id);
+    }
+    has(id) {
+        return this.categories.has(id);
+    }
+}
+export class Registry {
+    constructor(id) {
+        this.types = new Map();
+        this.nodes = new Map();
+        this.enums = new Map();
+        this.categories = new CategoryRegistry();
+        this.serializers = new Map();
+        this.coercions = new Map();
+        this.asyncCoercions = new Map();
+        this.resolvedCache = new Map();
+        this.id = id ?? `r${Registry.idCounter++}`;
+    }
+    registerType(desc, opts) {
+        this.types.set(desc.id, desc);
+        // Any structural change invalidates resolution cache
+        this.resolvedCache.clear();
+        if (!this.serializers.has(desc.id)) {
+            this.registerSerializer(desc.id, {
+                serialize: (v) => v,
+                deserialize: (d) => d,
+            });
+        }
+        if (opts?.withArray) {
+            const arrayId = opts.arrayId ?? `${desc.id}[]`;
+            if (!this.types.has(arrayId)) {
+                const arrayDesc = {
+                    id: arrayId,
+                    validate: (v) => Array.isArray(v) &&
+                        v.every((x) => {
+                            try {
+                                return desc.validate(x);
+                            }
+                            catch {
+                                return false;
+                            }
+                        }),
+                };
+                this.types.set(arrayId, arrayDesc);
+            }
+            this.registerCoercion(desc.id, arrayId, (value) => (Array.isArray(value) ? value : [value]));
+            this.registerCoercion(arrayId, desc.id, (value) => {
+                if (!Array.isArray(value))
+                    return value;
+                if (opts.arrayPickFirstDefined) {
+                    for (const x of value)
+                        if (x !== undefined)
+                            return x;
+                    return undefined;
+                }
+                return value[0];
+            });
+        }
+        return this;
+    }
+    registerNode(desc) {
+        this.nodes.set(desc.id, desc);
+        return this;
+    }
+    registerSerializer(typeId, s) {
+        this.serializers.set(typeId, s);
+        // If an array variant of this type exists and doesn't have a serializer,
+        // auto-register an array serializer that maps each element using the base serializer.
+        const arrayId = `${typeId}[]`;
+        if (this.types.has(arrayId) && !this.serializers.has(arrayId)) {
+            this.serializers.set(arrayId, {
+                serialize: (value) => (Array.isArray(value) ? value.map((el) => s.serialize(el)) : value),
+                deserialize: (data) => (Array.isArray(data) ? data.map((el) => s.deserialize(el)) : data),
+            });
+        }
+        return this;
+    }
+    // Register a type coercion from one type id to another
+    registerCoercion(fromTypeId, toTypeId, convert, opts) {
+        this.coercions.set(`${fromTypeId}->${toTypeId}`, {
+            convert,
+            nonTransitive: !!opts?.nonTransitive,
+        });
+        // If both source and target have array variants, add derived array->array coercion
+        const fromArr = fromTypeId === "base.object" ? fromTypeId : `${fromTypeId}[]`;
+        const toArr = toTypeId === "base.object" ? toTypeId : `${toTypeId}[]`;
+        const arrKey = `${fromArr}->${toArr}`;
+        if (this.types.has(fromArr) && this.types.has(toArr)) {
+            if (!this.coercions.has(arrKey) && !this.asyncCoercions.has(arrKey)) {
+                this.coercions.set(arrKey, {
+                    convert: (value) => {
+                        if (Array.isArray(value))
+                            return value.map((v) => convert(v));
+                        // Best-effort: coerce single to array-of-single
+                        return [convert(value)];
+                    },
+                    nonTransitive: !!opts?.nonTransitive,
+                });
+            }
+        }
+        this.resolvedCache.clear();
+        return this;
+    }
+    // Register an async type coercion from one type id to another
+    registerAsyncCoercion(fromTypeId, toTypeId, convertAsync, opts) {
+        this.asyncCoercions.set(`${fromTypeId}->${toTypeId}`, {
+            convertAsync,
+            nonTransitive: !!opts?.nonTransitive,
+        });
+        // If both source and target have array variants, add derived array->array async coercion
+        const fromArr = fromTypeId === "base.object" ? fromTypeId : `${fromTypeId}[]`;
+        const toArr = toTypeId === "base.object" ? toTypeId : `${toTypeId}[]`;
+        const arrKey = `${fromArr}->${toArr}`;
+        if (this.types.has(fromArr) && this.types.has(toArr)) {
+            if (!this.coercions.has(arrKey) && !this.asyncCoercions.has(arrKey)) {
+                this.asyncCoercions.set(arrKey, {
+                    convertAsync: async (value, signal) => {
+                        if (Array.isArray(value)) {
+                            const out = [];
+                            for (let i = 0; i < value.length; i++) {
+                                if (signal?.aborted)
+                                    throw signal.reason ?? new Error("aborted");
+                                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                                out.push(await convertAsync(value[i], signal));
+                            }
+                            return out;
+                        }
+                        return [await convertAsync(value, signal)];
+                    },
+                    nonTransitive: !!opts?.nonTransitive,
+                });
+            }
+        }
+        this.resolvedCache.clear();
+        return this;
+    }
+    canCoerce(fromTypeId, toTypeId) {
+        if (!fromTypeId || !toTypeId)
+            return false;
+        return !!this.resolveCoercion(fromTypeId, toTypeId);
+    }
+    getCoercion(fromTypeId, toTypeId) {
+        const resolved = this.resolveCoercion(fromTypeId, toTypeId);
+        if (!resolved)
+            return undefined;
+        if (resolved.kind === "sync")
+            return resolved.convert;
+        return undefined;
+    }
+    getAsyncCoercion(fromTypeId, toTypeId) {
+        const resolved = this.resolveCoercion(fromTypeId, toTypeId);
+        if (!resolved)
+            return undefined;
+        if (resolved.kind === "async")
+            return resolved.convertAsync;
+        return undefined;
+    }
+    // Introspection for dynamic discovery
+    listCoercions() {
+        const out = [];
+        for (const [key, rec] of this.coercions.entries()) {
+            const [from, to] = key.split("->");
+            out.push({
+                from,
+                to,
+                async: false,
+                nonTransitive: rec.nonTransitive,
+            });
+        }
+        for (const [key, rec] of this.asyncCoercions.entries()) {
+            const [from, to] = key.split("->");
+            out.push({ from, to, async: true, nonTransitive: rec.nonTransitive });
+        }
+        return out;
+    }
+    resolveCoercion(fromTypeId, toTypeId) {
+        const cacheKey = `${fromTypeId}->${toTypeId}`;
+        const cached = this.resolvedCache.get(cacheKey);
+        if (cached)
+            return cached;
+        if (fromTypeId === toTypeId) {
+            const res = {
+                kind: "sync",
+                convert: (v) => v,
+                cost: { edges: 0, async: 0 },
+            };
+            this.resolvedCache.set(cacheKey, res);
+            return res;
+        }
+        // Direct edges (regardless of nonTransitive)
+        const directSync = this.coercions.get(cacheKey);
+        if (directSync) {
+            const res = {
+                kind: "sync",
+                convert: directSync.convert,
+                cost: { edges: 1, async: 0 },
+            };
+            this.resolvedCache.set(cacheKey, res);
+            return res;
+        }
+        const directAsync = this.asyncCoercions.get(cacheKey);
+        if (directAsync) {
+            const res = {
+                kind: "async",
+                convertAsync: directAsync.convertAsync,
+                cost: { edges: 1, async: 1 },
+            };
+            this.resolvedCache.set(cacheKey, res);
+            return res;
+        }
+        // Build adjacency from transitive-allowed edges only
+        const getNeighbors = (from) => {
+            const out = [];
+            for (const [key, rec] of this.coercions.entries()) {
+                if (rec.nonTransitive)
+                    continue;
+                const [src, dst] = key.split("->");
+                if (src === from)
+                    out.push({ from: src, to: dst, kind: "sync", convert: rec.convert });
+            }
+            for (const [key, rec] of this.asyncCoercions.entries()) {
+                if (rec.nonTransitive)
+                    continue;
+                const [src, dst] = key.split("->");
+                if (src === from)
+                    out.push({
+                        from: src,
+                        to: dst,
+                        kind: "async",
+                        convertAsync: rec.convertAsync,
+                    });
+            }
+            return out;
+        };
+        const betterOf = (a, b) => {
+            if (!a)
+                return true;
+            if (b.edges !== a.edges)
+                return b.edges < a.edges;
+            return b.async < a.async;
+        };
+        const best = new Map();
+        const queue = [];
+        const push = (e) => {
+            // simple insertion to keep queue roughly ordered by cost
+            let i = 0;
+            while (i < queue.length) {
+                const q = queue[i];
+                if (e.cost.edges < q.cost.edges || (e.cost.edges === q.cost.edges && e.cost.async < q.cost.async)) {
+                    break;
+                }
+                i++;
+            }
+            queue.splice(i, 0, e);
+        };
+        push({ node: fromTypeId, cost: { edges: 0, async: 0 }, path: [] });
+        best.set(fromTypeId, { edges: 0, async: 0 });
+        while (queue.length > 0) {
+            const cur = queue.shift();
+            if (cur.node === toTypeId) {
+                // Compose
+                const cost = {
+                    edges: cur.cost.edges,
+                    async: cur.cost.async,
+                };
+                const hasAsync = cur.path.some((s) => s.kind === "async");
+                if (!hasAsync) {
+                    const convert = (value) => {
+                        let acc = value;
+                        for (const step of cur.path) {
+                            // all sync by construction
+                            acc = step.convert(acc);
+                        }
+                        return acc;
+                    };
+                    const res = {
+                        kind: "sync",
+                        convert,
+                        cost,
+                    };
+                    this.resolvedCache.set(cacheKey, res);
+                    return res;
+                }
+                else {
+                    const convertAsync = async (value, signal) => {
+                        let acc = value;
+                        for (const step of cur.path) {
+                            if (step.kind === "sync") {
+                                acc = step.convert(acc);
+                            }
+                            else {
+                                acc = await step.convertAsync(acc, signal);
+                            }
+                        }
+                        return acc;
+                    };
+                    const res = {
+                        kind: "async",
+                        convertAsync,
+                        cost,
+                    };
+                    this.resolvedCache.set(cacheKey, res);
+                    return res;
+                }
+            }
+            // expand neighbors
+            for (const step of getNeighbors(cur.node)) {
+                const nextCost = {
+                    edges: cur.cost.edges + 1,
+                    async: cur.cost.async + (step.kind === "async" ? 1 : 0),
+                };
+                const prev = best.get(step.to);
+                if (betterOf(prev, nextCost)) {
+                    best.set(step.to, nextCost);
+                    push({ node: step.to, cost: nextCost, path: [...cur.path, step] });
+                }
+            }
+        }
+        return undefined;
+    }
+    // Enum support
+    registerEnum(desc) {
+        const { id, displayName, options, opts, bakeTarget } = desc;
+        const labelType = opts?.labelType ?? "base.string";
+        const valueType = opts?.valueType ?? "base.float";
+        const valueToLabel = new Map();
+        const labelToValue = new Map();
+        for (const { value, label } of options) {
+            valueToLabel.set(value, label);
+            labelToValue.set(label.toLowerCase(), value);
+        }
+        this.enums.set(id, {
+            options,
+            valueToLabel,
+            labelToValue,
+        });
+        // Register type descriptor and serializer for enum (stored as number)
+        this.registerType({
+            id,
+            displayName,
+            validate: (v) => typeof v === "number" && valueToLabel.has(Number(v)),
+            bakeTarget,
+        }, opts);
+        this.registerSerializer(id, {
+            serialize: (v) => v,
+            deserialize: (d) => Number(d),
+        });
+        // Coercions: string -> enum (by label), float -> enum (by numeric value), enum -> string (label)
+        this.registerCoercion(labelType, id, (value) => {
+            const s = String(value ?? "")
+                .trim()
+                .toLowerCase();
+            const rec = this.enums.get(id);
+            if (!rec)
+                return value;
+            if (rec.labelToValue.has(s))
+                return rec.labelToValue.get(s);
+            const asNum = Number(s);
+            if (Number.isFinite(asNum) && rec.valueToLabel.has(asNum))
+                return asNum;
+            return Array.from(rec.valueToLabel.keys())[0] ?? 0;
+        });
+        this.registerCoercion(valueType, id, (value) => {
+            const n = Number(value);
+            const rec = this.enums.get(id);
+            if (!rec)
+                return value;
+            return rec.valueToLabel.has(n) ? n : (Array.from(rec.valueToLabel.keys())[0] ?? 0);
+        });
+        this.registerCoercion(id, labelType, (value) => {
+            const n = Number(value);
+            const rec = this.enums.get(id);
+            if (!rec)
+                return String(value);
+            return rec.valueToLabel.get(n) ?? String(n);
+        });
+        return this;
+    }
+}
+Registry.idCounter = 0;
+//# sourceMappingURL=Registry.js.map

package/lib/src/builder/Registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.js","sourceRoot":"","sources":["../../../src/builder/Registry.ts"],"names":[],"mappings":"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"}

package/lib/src/core/categories.d.ts

@@ -0,0 +1,22 @@
+import type { NodeCategoryId, ExecutionPolicy } from "@bian-womp/spark-protocol";
+import type { ExecutionContext } from "./types";
+export interface CategoryRuntime<State = unknown> {
+    onInputsChanged?: (inputs: Record<string, unknown>, ctx: ExecutionContext<State>) => void | Promise<void>;
+    onActivated?: () => void | Promise<void>;
+    onDeactivated?: () => void | Promise<void>;
+    onExternalEvent?: (event: unknown, state: State) => void | Promise<void>;
+    onTick?: () => void;
+    dispose?: () => void;
+}
+export interface NodeCategoryDescriptor<Impl = unknown, State = unknown> {
+    id: NodeCategoryId;
+    displayName?: string;
+    validateImpl?: (impl: Impl) => void;
+    createRuntime: (options: {
+        nodeId: string;
+        impl: Impl;
+        initialState?: Partial<State>;
+    }) => CategoryRuntime<State>;
+    policy?: Partial<ExecutionPolicy>;
+}
+//# sourceMappingURL=categories.d.ts.map

package/lib/src/core/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../src/core/categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,WAAW,eAAe,CAAC,KAAK,GAAG,OAAO;IAC9C,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1G,WAAW,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB,CAAC,IAAI,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACrE,EAAE,EAAE,cAAc,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACpC,aAAa,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;KAAE,KAAK,eAAe,CAAC,KAAK,CAAC,CAAC;IAClH,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACnC"}

package/lib/src/core/categories.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=categories.js.map

package/lib/src/core/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../../src/core/categories.ts"],"names":[],"mappings":""}

package/lib/src/core/order.d.ts

@@ -0,0 +1,7 @@
+import type { GraphDefinition } from "@bian-womp/spark-protocol";
+/**
+ * Computes the forward-reachable subgraph from a starting node.
+ * Returns nodes in topological order, starting from the given node.
+ */
+export declare function getForwardOrder(def: GraphDefinition, startId: string): string[];
+//# sourceMappingURL=order.d.ts.map

package/lib/src/core/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/core/order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiE/E"}

package/lib/src/core/order.js

@@ -0,0 +1,66 @@
+/**
+ * Computes the forward-reachable subgraph from a starting node.
+ * Returns nodes in topological order, starting from the given node.
+ */
+export function getForwardOrder(def, startId) {
+    // Build adjacency list (forward edges only)
+    const neighbors = {};
+    const indegree = {};
+    const reachable = new Set();
+    // Initialize all nodes
+    for (const n of def.nodes) {
+        neighbors[n.nodeId] = [];
+        indegree[n.nodeId] = 0;
+    }
+    // Build forward edges
+    for (const e of def.edges) {
+        neighbors[e.source.nodeId].push(e.target.nodeId);
+    }
+    // 1. BFS to collect all forward-reachable nodes from start
+    const queue = [startId];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        if (reachable.has(id))
+            continue;
+        reachable.add(id);
+        for (const nb of neighbors[id] || []) {
+            if (!reachable.has(nb)) {
+                queue.push(nb);
+            }
+        }
+    }
+    // 2. Compute indegree for reachable subgraph only
+    for (const e of def.edges) {
+        if (reachable.has(e.source.nodeId) && reachable.has(e.target.nodeId)) {
+            indegree[e.target.nodeId] = (indegree[e.target.nodeId] ?? 0) + 1;
+        }
+    }
+    // 3. Kahn's algorithm: topological sort of reachable subgraph
+    const q = [];
+    for (const id of reachable) {
+        if (indegree[id] === 0) {
+            q.push(id);
+        }
+    }
+    const order = [];
+    while (q.length > 0) {
+        const id = q.shift();
+        order.push(id);
+        for (const nb of neighbors[id] || []) {
+            if (!reachable.has(nb))
+                continue;
+            indegree[nb] = (indegree[nb] ?? 0) - 1;
+            if (indegree[nb] === 0) {
+                q.push(nb);
+            }
+        }
+    }
+    // 4. Return only nodes from startId forward (slice from startId's position)
+    const startIdx = order.indexOf(startId);
+    if (startIdx === -1) {
+        // Start node not in order (shouldn't happen, but be safe)
+        return [startId];
+    }
+    return order.slice(startIdx);
+}
+//# sourceMappingURL=order.js.map

package/lib/src/core/order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../../src/core/order.ts"],"names":[],"mappings":"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"}

package/lib/src/core/type-utils.d.ts

@@ -0,0 +1,29 @@
+import type { DataTypeId, HandleId, InputHandleDescriptor, HandleMetadata } from "@bian-womp/spark-protocol";
+import type { TypedValue } from "./types";
+export declare function typed<T = unknown>(typeId: DataTypeId, value: T): TypedValue<T>;
+export declare function isTyped(v: unknown): v is TypedValue<unknown>;
+export declare function unwrapTypeId(v: unknown): DataTypeId | undefined;
+export declare function unwrapValue(v: unknown): unknown;
+/**
+ * Get the full declared type(s) for an input handle (supports union types)
+ * Returns the typeId as-is: string for single type, string[] for union types
+ */
+export declare function getInputDeclaredTypes(inputs: Record<string, InputHandleDescriptor> | undefined, handle: HandleId): DataTypeId | DataTypeId[] | undefined;
+/**
+ * Get the primary (first) type ID for an input handle.
+ * For union types, returns the first type in the array.
+ * This maintains backward compatibility for code that expects a single type.
+ */
+export declare function getInputTypeId(inputs: Record<string, InputHandleDescriptor> | undefined, handle: HandleId): DataTypeId | undefined;
+export declare function isInputPrivate(inputs: Record<string, InputHandleDescriptor> | undefined, handle: HandleId): boolean;
+/**
+ * Merge two InputHandleDescriptor values, with dynamic taking precedence.
+ * If both have metadata, merge the metadata objects (dynamic overrides static).
+ * Supports union types (arrays) in both static and dynamic descriptors.
+ */
+export declare function mergeInputHandleDescriptors(staticDesc: InputHandleDescriptor | undefined, dynamicDesc: InputHandleDescriptor | undefined): InputHandleDescriptor | undefined;
+/**
+ * Extract metadata from an InputHandleDescriptor
+ */
+export declare function getInputHandleMetadata(inputs: Record<string, InputHandleDescriptor> | undefined, handle: HandleId): HandleMetadata | undefined;
+//# sourceMappingURL=type-utils.d.ts.map

package/lib/src/core/type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../../../src/core/type-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC7G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,wBAAgB,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAE9E;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAE5D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAG/D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG/C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,EACzD,MAAM,EAAE,QAAQ,GACf,UAAU,GAAG,UAAU,EAAE,GAAG,SAAS,CAOvC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,EACzD,MAAM,EAAE,QAAQ,GACf,UAAU,GAAG,SAAS,CAIxB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAKnH;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,qBAAqB,GAAG,SAAS,EAC7C,WAAW,EAAE,qBAAqB,GAAG,SAAS,GAC7C,qBAAqB,GAAG,SAAS,CA2CnC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,EACzD,MAAM,EAAE,QAAQ,GACf,cAAc,GAAG,SAAS,CAI5B"}

package/lib/src/core/type-utils.js

@@ -0,0 +1,92 @@
+export function typed(typeId, value) {
+    return { __spark_type: typeId, __spark_value: value };
+}
+export function isTyped(v) {
+    return !!v && typeof v === "object" && Object.prototype.hasOwnProperty.call(v, "__spark_type");
+}
+export function unwrapTypeId(v) {
+    if (isTyped(v))
+        return String(v.__spark_type);
+    return undefined;
+}
+export function unwrapValue(v) {
+    if (isTyped(v))
+        return v.__spark_value;
+    return v;
+}
+/**
+ * Get the full declared type(s) for an input handle (supports union types)
+ * Returns the typeId as-is: string for single type, string[] for union types
+ */
+export function getInputDeclaredTypes(inputs, handle) {
+    const v = inputs ? inputs[handle] : undefined;
+    if (!v)
+        return undefined;
+    if (typeof v === "string")
+        return v;
+    if (Array.isArray(v))
+        return v;
+    return v.typeId;
+}
+/**
+ * Get the primary (first) type ID for an input handle.
+ * For union types, returns the first type in the array.
+ * This maintains backward compatibility for code that expects a single type.
+ */
+export function getInputTypeId(inputs, handle) {
+    const decl = getInputDeclaredTypes(inputs, handle);
+    if (!decl)
+        return undefined;
+    return Array.isArray(decl) ? decl[0] : decl;
+}
+export function isInputPrivate(inputs, handle) {
+    const v = inputs ? inputs[handle] : undefined;
+    if (!v || typeof v === "string" || Array.isArray(v))
+        return false;
+    // At this point, v must be an object with optional private/metadata fields
+    return !!(typeof v === "object" && v !== null && "private" in v && v.private);
+}
+/**
+ * Merge two InputHandleDescriptor values, with dynamic taking precedence.
+ * If both have metadata, merge the metadata objects (dynamic overrides static).
+ * Supports union types (arrays) in both static and dynamic descriptors.
+ */
+export function mergeInputHandleDescriptors(staticDesc, dynamicDesc) {
+    // If only one exists, return it
+    if (!staticDesc)
+        return dynamicDesc;
+    if (!dynamicDesc)
+        return staticDesc;
+    // If both are primitive (string or array), dynamic wins
+    if ((typeof staticDesc === "string" || Array.isArray(staticDesc)) &&
+        (typeof dynamicDesc === "string" || Array.isArray(dynamicDesc))) {
+        return dynamicDesc;
+    }
+    const staticObj = typeof staticDesc === "string" || Array.isArray(staticDesc) ? { typeId: staticDesc } : staticDesc;
+    const dynamicObj = typeof dynamicDesc === "string" || Array.isArray(dynamicDesc) ? { typeId: dynamicDesc } : dynamicDesc;
+    // Merge: dynamic takes precedence, but merge metadata objects
+    const merged = {
+        typeId: dynamicObj.typeId ?? staticObj.typeId,
+        private: dynamicObj.private ?? staticObj.private,
+        defaultPolicy: dynamicObj.defaultPolicy ?? staticObj.defaultPolicy,
+    };
+    // Merge metadata if either has it
+    if (staticObj.metadata || dynamicObj.metadata) {
+        merged.metadata = {
+            ...staticObj.metadata,
+            ...dynamicObj.metadata, // Dynamic metadata overrides static
+        };
+    }
+    // Return as InputHandleDescriptor (which accepts object form)
+    return merged;
+}
+/**
+ * Extract metadata from an InputHandleDescriptor
+ */
+export function getInputHandleMetadata(inputs, handle) {
+    const v = inputs ? inputs[handle] : undefined;
+    if (!v || typeof v === "string" || Array.isArray(v))
+        return undefined;
+    return v.metadata;
+}
+//# sourceMappingURL=type-utils.js.map