@lifi/composer-sdk 0.7.1 → 0.9.0

package/dist/authoring/raw.js

@@ -1,22 +1,86 @@
-const ref = (path) => (
-  // The brand is phantom, so the runtime value is the bare wire ref. This is
-  // the only place a `TypedRef` is minted; the cast is what the brand buys.
-  { $ref: path }
-);
-const literal = (kind, value) => ({ kind, value });
+//#region src/authoring/raw.ts
+/**
+* Creates a typed `$ref` pointer for use in bind slots.
+*
+* This is an **escape hatch** for referencing values that the typed builder
+* API doesn't cover — for example, outputs of an `untypedOp` node or custom
+* context paths. The caller is responsible for choosing the correct type
+* parameter; no runtime validation occurs.
+*
+* Prefer typed handles (`OutputHandle`, `InputHandle`) and `builder.context`
+* whenever possible. Use `ref` only when you need to construct a `$ref` path
+* manually and want it accepted by a `Bindable<T>` slot.
+*
+* @typeParam T - The output kind this ref represents (e.g. `'address'`, `'uint256'`, `'resource'`).
+* @param path - The `$ref` path (e.g. `"context.sender"`, `"myNode.result"`).
+* @returns A {@link TypedRef} accepted by `Bindable<T>` slots matching `T`.
+*
+* @example
+* ```ts
+* import { raw } from '@lifi/composer-sdk';
+*
+* // Reference an untypedOp output in a typed operation:
+* builder.untypedOp('custom', 'some.op', {
+*   bind: { x: { $ref: 'input.token' } },
+*   config: {},
+* });
+* builder.core.add('sum', {
+*   bind: {
+*     a: raw.ref<'uint256'>('custom.result'),
+*     b: someTypedHandle,
+*   },
+* });
+* ```
+*/
+const ref = (path) => ({ $ref: path });
+/**
+* Creates a typed literal for use in bind slots: a constant baked into the
+* flow document rather than supplied at run time.
+*
+* Prefer a declared flow input and `builder.inputs.<name>` — a value the
+* caller supplies per run stays out of the document. Use a literal when the
+* flow has no run of its own to take the value from: the `continuationFlow`
+* of a `continuation.settle` node is stored by the settlement backend and
+* re-run later against the deferred proceeds, so its delivery address has to
+* be part of the committed document.
+*
+* @typeParam T - The Solidity type of the literal (e.g. `'address'`).
+* @param kind - The literal's Solidity type.
+* @param value - The literal value, as the wire format carries it: a string.
+* @returns A {@link TypedLiteral} accepted by `Bindable<T>` slots matching `T`.
+*
+* @example
+* ```ts
+* import { raw } from '@lifi/composer-sdk';
+*
+* builder.core.transfer('deliver', {
+*   bind: {
+*     amount: zap.amountOut,
+*     recipient: raw.literal('address', '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'),
+*   },
+*   config: {},
+* });
+* ```
+*/
+const literal = (kind, value) => ({
+	kind,
+	value
+});
+/**
+* Creates a raw guard object for use in the `guards` array of an operation call.
+*
+* @param kind - The guard type (e.g. `"slippage"`).
+* @param config - Guard-specific configuration (e.g. `{ toleranceBps: 300 }`).
+* @returns An {@link AppliedGuard} object.
+*/
 const rawGuard = (kind, config = {}) => {
-  if ("kind" in config) {
-    throw new Error(
-      `rawGuard: 'kind' must not appear in config (got "${String(
-        config.kind
-      )}"). Pass it as the first argument instead.`
-    );
-  }
-  return { ...config, kind };
-};
-export {
-  literal,
-  rawGuard,
-  ref
+	if ("kind" in config) throw new Error(`rawGuard: 'kind' must not appear in config (got "${String(config.kind)}"). Pass it as the first argument instead.`);
+	return {
+		...config,
+		kind
+	};
 };
+//#endregion
+export { literal, rawGuard, ref };
+
 //# sourceMappingURL=raw.js.map

package/dist/authoring/raw.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/authoring/raw.ts"],"sourcesContent":["import type { AppliedGuard, SolType } from '@lifi/compose-spec';\n\nimport type { OutputKind, TypedLiteral, TypedRef } from '../types.js';\n\n/**\n * Creates a typed `$ref` pointer for use in bind slots.\n *\n * This is an **escape hatch** for referencing values that the typed builder\n * API doesn't cover — for example, outputs of an `untypedOp` node or custom\n * context paths. The caller is responsible for choosing the correct type\n * parameter; no runtime validation occurs.\n *\n * Prefer typed handles (`OutputHandle`, `InputHandle`) and `builder.context`\n * whenever possible. Use `ref` only when you need to construct a `$ref` path\n * manually and want it accepted by a `Bindable<T>` slot.\n *\n * @typeParam T - The output kind this ref represents (e.g. `'address'`, `'uint256'`, `'resource'`).\n * @param path - The `$ref` path (e.g. `\"context.sender\"`, `\"myNode.result\"`).\n * @returns A {@link TypedRef} accepted by `Bindable<T>` slots matching `T`.\n *\n * @example\n * ```ts\n * import { raw } from '@lifi/composer-sdk';\n *\n * // Reference an untypedOp output in a typed operation:\n * builder.untypedOp('custom', 'some.op', {\n *   bind: { x: { $ref: 'input.token' } },\n *   config: {},\n * });\n * builder.core.add('sum', {\n *   bind: {\n *     a: raw.ref<'uint256'>('custom.result'),\n *     b: someTypedHandle,\n *   },\n * });\n * ```\n */\nexport const ref = <T extends OutputKind>(path: string): TypedRef<T> =>\n  // The brand is phantom, so the runtime value is the bare wire ref. This is\n  // the only place a `TypedRef` is minted; the cast is what the brand buys.\n  ({ $ref: path }) as TypedRef<T>;\n\n/**\n * Creates a typed literal for use in bind slots: a constant baked into the\n * flow document rather than supplied at run time.\n *\n * Prefer a declared flow input and `builder.inputs.<name>` — a value the\n * caller supplies per run stays out of the document. Use a literal when the\n * flow has no run of its own to take the value from: the `continuationFlow`\n * of a `continuation.settle` node is stored by the settlement backend and\n * re-run later against the deferred proceeds, so its delivery address has to\n * be part of the committed document.\n *\n * @typeParam T - The Solidity type of the literal (e.g. `'address'`).\n * @param kind - The literal's Solidity type.\n * @param value - The literal value, as the wire format carries it: a string.\n * @returns A {@link TypedLiteral} accepted by `Bindable<T>` slots matching `T`.\n *\n * @example\n * ```ts\n * import { raw } from '@lifi/composer-sdk';\n *\n * builder.core.transfer('deliver', {\n *   bind: {\n *     amount: zap.amountOut,\n *     recipient: raw.literal('address', '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'),\n *   },\n *   config: {},\n * });\n * ```\n */\nexport const literal = <T extends SolType>(\n  kind: T,\n  value: string,\n): TypedLiteral<T> => ({ kind, value });\n\n/**\n * Creates a raw guard object for use in the `guards` array of an operation call.\n *\n * @param kind - The guard type (e.g. `\"slippage\"`).\n * @param config - Guard-specific configuration (e.g. `{ toleranceBps: 300 }`).\n * @returns An {@link AppliedGuard} object.\n */\nexport const rawGuard = (\n  kind: string,\n  config: Record<string, unknown> = {},\n): AppliedGuard => {\n  if ('kind' in config) {\n    throw new Error(\n      `rawGuard: 'kind' must not appear in config (got \"${String(\n        config.kind,\n      )}\"). Pass it as the first argument instead.`,\n    );\n  }\n  return { ...config, kind };\n};\n"],"mappings":"AAqCO,MAAM,MAAM,CAAuB;AAAA;AAAA;AAAA,EAGvC,EAAE,MAAM,KAAK;AAAA;AA+BT,MAAM,UAAU,CACrB,MACA,WACqB,EAAE,MAAM,MAAM;AAS9B,MAAM,WAAW,CACtB,MACA,SAAkC,CAAC,MAClB;AACjB,MAAI,UAAU,QAAQ;AACpB,UAAM,IAAI;AAAA,MACR,oDAAoD;AAAA,QAClD,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO,EAAE,GAAG,QAAQ,KAAK;AAC3B;","names":[]}
+{"version":3,"file":"raw.js","names":[],"sources":["../../src/authoring/raw.ts"],"sourcesContent":["import type { AppliedGuard, SolType } from '@lifi/compose-spec';\n\nimport type { OutputKind, TypedLiteral, TypedRef } from '../types.js';\n\n/**\n * Creates a typed `$ref` pointer for use in bind slots.\n *\n * This is an **escape hatch** for referencing values that the typed builder\n * API doesn't cover — for example, outputs of an `untypedOp` node or custom\n * context paths. The caller is responsible for choosing the correct type\n * parameter; no runtime validation occurs.\n *\n * Prefer typed handles (`OutputHandle`, `InputHandle`) and `builder.context`\n * whenever possible. Use `ref` only when you need to construct a `$ref` path\n * manually and want it accepted by a `Bindable<T>` slot.\n *\n * @typeParam T - The output kind this ref represents (e.g. `'address'`, `'uint256'`, `'resource'`).\n * @param path - The `$ref` path (e.g. `\"context.sender\"`, `\"myNode.result\"`).\n * @returns A {@link TypedRef} accepted by `Bindable<T>` slots matching `T`.\n *\n * @example\n * ```ts\n * import { raw } from '@lifi/composer-sdk';\n *\n * // Reference an untypedOp output in a typed operation:\n * builder.untypedOp('custom', 'some.op', {\n *   bind: { x: { $ref: 'input.token' } },\n *   config: {},\n * });\n * builder.core.add('sum', {\n *   bind: {\n *     a: raw.ref<'uint256'>('custom.result'),\n *     b: someTypedHandle,\n *   },\n * });\n * ```\n */\nexport const ref = <T extends OutputKind>(path: string): TypedRef<T> =>\n  // The brand is phantom, so the runtime value is the bare wire ref. This is\n  // the only place a `TypedRef` is minted; the cast is what the brand buys.\n  ({ $ref: path }) as TypedRef<T>;\n\n/**\n * Creates a typed literal for use in bind slots: a constant baked into the\n * flow document rather than supplied at run time.\n *\n * Prefer a declared flow input and `builder.inputs.<name>` — a value the\n * caller supplies per run stays out of the document. Use a literal when the\n * flow has no run of its own to take the value from: the `continuationFlow`\n * of a `continuation.settle` node is stored by the settlement backend and\n * re-run later against the deferred proceeds, so its delivery address has to\n * be part of the committed document.\n *\n * @typeParam T - The Solidity type of the literal (e.g. `'address'`).\n * @param kind - The literal's Solidity type.\n * @param value - The literal value, as the wire format carries it: a string.\n * @returns A {@link TypedLiteral} accepted by `Bindable<T>` slots matching `T`.\n *\n * @example\n * ```ts\n * import { raw } from '@lifi/composer-sdk';\n *\n * builder.core.transfer('deliver', {\n *   bind: {\n *     amount: zap.amountOut,\n *     recipient: raw.literal('address', '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'),\n *   },\n *   config: {},\n * });\n * ```\n */\nexport const literal = <T extends SolType>(\n  kind: T,\n  value: string,\n): TypedLiteral<T> => ({ kind, value });\n\n/**\n * Creates a raw guard object for use in the `guards` array of an operation call.\n *\n * @param kind - The guard type (e.g. `\"slippage\"`).\n * @param config - Guard-specific configuration (e.g. `{ toleranceBps: 300 }`).\n * @returns An {@link AppliedGuard} object.\n */\nexport const rawGuard = (\n  kind: string,\n  config: Record<string, unknown> = {},\n): AppliedGuard => {\n  if ('kind' in config) {\n    throw new Error(\n      `rawGuard: 'kind' must not appear in config (got \"${String(\n        config.kind,\n      )}\"). Pass it as the first argument instead.`,\n    );\n  }\n  return { ...config, kind };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,OAA6B,UAGvC,EAAE,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BhB,MAAa,WACX,MACA,WACqB;CAAE;CAAM;AAAM;;;;;;;;AASrC,MAAa,YACX,MACA,SAAkC,CAAC,MAClB;CACjB,IAAI,UAAU,QACZ,MAAM,IAAI,MACR,oDAAoD,OAClD,OAAO,IACT,EAAE,2CACJ;CAEF,OAAO;EAAE,GAAG;EAAQ;CAAK;AAC3B"}

package/dist/authoring/signatureArgs.cjs

@@ -1,114 +1,92 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var signatureArgs_exports = {};
-__export(signatureArgs_exports, {
-  buildCallWireFormat: () => buildCallWireFormat,
-  buildStaticCallWireFormat: () => buildStaticCallWireFormat,
-  parseFunctionParams: () => parseFunctionParams,
-  toBindRef: () => toBindRef
-});
-module.exports = __toCommonJS(signatureArgs_exports);
-var import_abitype = require("abitype");
-var import_handles = require("./handles.js");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_authoring_handles = require("./handles.cjs");
+let abitype = require("abitype");
+//#region src/authoring/signatureArgs.ts
+/**
+* Parses a Solidity function signature and returns parameter names in order.
+* Delegates to abitype's runtime `parseAbiItem` — the same parser that powers
+* the compile-time `ParseAbiItem<TSig>` type — so runtime and type-level
+* parsing can never diverge.
+*
+* @throws if the signature is not a valid function signature or a parameter is unnamed
+*/
 const parseFunctionParams = (functionSignature) => {
-  const parsed = (0, import_abitype.parseAbiItem)(functionSignature);
-  if (parsed.type !== "function") {
-    throw new Error(
-      `core.call: expected a function signature, got "${parsed.type}": "${functionSignature}"`
-    );
-  }
-  return parsed.inputs.map((input, index) => {
-    if (!input.name) {
-      throw new Error(
-        `core.call: parameter at index ${index} in signature has no name. All parameters must be named for named binds to work.`
-      );
-    }
-    return input.name;
-  });
+	const parsed = (0, abitype.parseAbiItem)(functionSignature);
+	if (parsed.type !== "function") throw new Error(`core.call: expected a function signature, got "${parsed.type}": "${functionSignature}"`);
+	return parsed.inputs.map((input, index) => {
+		if (!input.name) throw new Error(`core.call: parameter at index ${index} in signature has no name. All parameters must be named for named binds to work.`);
+		return input.name;
+	});
 };
+/**
+* Converts a ref-resolving bindable to a `Ref` (`{ $ref: string }`).
+* Handles carry a `_tag` property and are converted via `handleToRef`;
+* `Ref` objects pass through as-is.
+*/
 const toBindRef = (bindable) => {
-  if ("_tag" in bindable) return (0, import_handles.handleToRef)(bindable);
-  return bindable;
+	if ("_tag" in bindable) return require_authoring_handles.handleToRef(bindable);
+	return bindable;
 };
+/**
+* Parses a function signature from `config`, validates bind keys against it,
+* and converts named binds to positional `$ref` args.
+*/
 const resolvePositionalArgs = (label, bind, config) => {
-  const functionSignature = config.functionSignature;
-  if (typeof functionSignature !== "string") {
-    throw new Error(
-      `${label}: config.functionSignature is required and must be a string`
-    );
-  }
-  const paramNames = parseFunctionParams(functionSignature);
-  const paramSet = new Set(paramNames);
-  const bindKeys = Object.keys(bind);
-  const bindSet = new Set(bindKeys);
-  const missing = paramNames.filter((n) => !bindSet.has(n));
-  const extra = bindKeys.filter((k) => !paramSet.has(k));
-  if (missing.length > 0 || extra.length > 0) {
-    throw new Error(
-      `${label}: bind keys [${bindKeys.join(
-        ", "
-      )}] do not match signature parameters [${paramNames.join(
-        ", "
-      )}]. Missing: ${missing.join(", ") || "(none)"}. Extra: ${extra.join(", ") || "(none)"}.`
-    );
-  }
-  return paramNames.map((name) => {
-    const bindable = bind[name];
-    if (bindable === void 0) {
-      throw new Error(
-        `${label}: bind value for parameter "${name}" is undefined`
-      );
-    }
-    return toBindRef(bindable);
-  });
+	const functionSignature = config.functionSignature;
+	if (typeof functionSignature !== "string") throw new Error(`${label}: config.functionSignature is required and must be a string`);
+	const paramNames = parseFunctionParams(functionSignature);
+	const paramSet = new Set(paramNames);
+	const bindKeys = Object.keys(bind);
+	const bindSet = new Set(bindKeys);
+	const missing = paramNames.filter((n) => !bindSet.has(n));
+	const extra = bindKeys.filter((k) => !paramSet.has(k));
+	if (missing.length > 0 || extra.length > 0) throw new Error(`${label}: bind keys [${bindKeys.join(", ")}] do not match signature parameters [${paramNames.join(", ")}]. Missing: ${missing.join(", ") || "(none)"}. Extra: ${extra.join(", ") || "(none)"}.`);
+	return paramNames.map((name) => {
+		const bindable = bind[name];
+		if (bindable === void 0) throw new Error(`${label}: bind value for parameter "${name}" is undefined`);
+		return toBindRef(bindable);
+	});
 };
+/**
+* Transforms the user-facing `resource` + named `bind` API into the wire
+* format that the backend expects:
+* - With resource: `core.call` with `bind: { input: <resourceRef> }`
+* - Without resource: `core.invoke` with `bind: {}`
+* - `config: { ...userConfig, args: [positional refs...] }`
+*/
 const buildCallWireFormat = (args) => {
-  const positionalArgs = resolvePositionalArgs(
-    "core.call",
-    args.bind,
-    args.config
-  );
-  const hasResource = args.resource !== void 0;
-  return {
-    op: hasResource ? "core.call" : "core.invoke",
-    bind: hasResource ? { input: toBindRef(args.resource) } : {},
-    config: { ...args.config, args: positionalArgs },
-    ...args.guards && args.guards.length > 0 && { guards: args.guards }
-  };
+	const positionalArgs = resolvePositionalArgs("core.call", args.bind, args.config);
+	const hasResource = args.resource !== void 0;
+	return {
+		op: hasResource ? "core.call" : "core.invoke",
+		bind: hasResource ? { input: toBindRef(args.resource) } : {},
+		config: {
+			...args.config,
+			args: positionalArgs
+		},
+		...args.guards && args.guards.length > 0 && { guards: args.guards }
+	};
 };
+/**
+* Transforms the user-facing named `bind` API into the wire format that the
+* backend expects for `core.staticCall`. Same as `buildCallWireFormat` but
+* with no `resource` field — staticCall has no resource inputs.
+*/
 const buildStaticCallWireFormat = (args) => {
-  const positionalArgs = resolvePositionalArgs(
-    "core.staticCall",
-    args.bind,
-    args.config
-  );
-  return {
-    bind: {},
-    config: { ...args.config, args: positionalArgs },
-    ...args.guards && args.guards.length > 0 && { guards: args.guards }
-  };
+	const positionalArgs = resolvePositionalArgs("core.staticCall", args.bind, args.config);
+	return {
+		bind: {},
+		config: {
+			...args.config,
+			args: positionalArgs
+		},
+		...args.guards && args.guards.length > 0 && { guards: args.guards }
+	};
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildCallWireFormat,
-  buildStaticCallWireFormat,
-  parseFunctionParams,
-  toBindRef
-});
+//#endregion
+exports.buildCallWireFormat = buildCallWireFormat;
+exports.buildStaticCallWireFormat = buildStaticCallWireFormat;
+exports.parseFunctionParams = parseFunctionParams;
+exports.toBindRef = toBindRef;
+
 //# sourceMappingURL=signatureArgs.cjs.map

package/dist/authoring/signatureArgs.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/authoring/signatureArgs.ts"],"sourcesContent":["import type { Ref } from '@lifi/compose-spec';\nimport { type ParseAbiItem, parseAbiItem } from 'abitype';\n\nimport type { AbiTypeToOutputKind, TypedGuard } from '../types.js';\n\nimport type { CallArgs } from './FlowBuilderCore.js';\nimport type { AnyRefBindable, OutputHandle, RefBindable } from './handles.js';\nimport { handleToRef } from './handles.js';\n\n/**\n * Type-level extraction of named bind keys from a function signature string.\n * When `TSig` is a string literal matching a Solidity function signature,\n * resolves to a record whose keys are the parameter names and values are\n * `RefBindable<kind>` where the kind is derived from each parameter's Solidity\n * type via `AbiTypeToOutputKind`. For recognised `SolType` parameters\n * (e.g. `uint256`, `address`, `uint128`) the bind slot is precisely typed;\n * for other Solidity types (e.g. tuples) the slot accepts any scalar handle.\n * Falls back to `Record<string, AnyRefBindable>` for non-literal strings.\n *\n * These slots are lowered into `config.args`, which is positional calldata\n * rather than a node `bind` record, so a literal is not accepted here: only\n * values that resolve to a `$ref`.\n */\nexport type SignatureBind<TSig extends string> = string extends TSig\n  ? Record<string, AnyRefBindable>\n  : ParseAbiItem<TSig> extends {\n        type: 'function';\n        inputs: infer I extends readonly { name: string; type: string }[];\n      }\n    ? {\n        readonly [P in I[number] as P['name']]: RefBindable<\n          AbiTypeToOutputKind<P['type']>\n        >;\n      }\n    : Record<string, AnyRefBindable>;\n\n// ---------------------------------------------------------------------------\n// Return-type inference from function signatures\n// ---------------------------------------------------------------------------\n\n/**\n * Describes the output type(s) of a parsed function signature as a\n * human-readable string for inclusion in type-level error messages.\n */\ntype DescribeOutputs<O extends readonly { type: string }[]> =\n  O extends readonly [{ type: infer T extends string }] ? T : 'multiple values';\n\n/**\n * A string-literal type that surfaces a clear error when the user provides a\n * function signature whose return type is not supported by core.call.\n * The message is visible in IDE tooltips and compiler diagnostics.\n */\ntype UnsupportedReturnTypeError<TLabel extends string, TSig extends string> =\n  ParseAbiItem<TSig> extends {\n    type: 'function';\n    outputs: infer O extends readonly { type: string }[];\n  }\n    ? `[TypeError] ${TLabel}: return type '${DescribeOutputs<O>}' is not supported — only 'uint256' or void signatures are allowed`\n    : `[TypeError] ${TLabel}: unable to parse return type from signature`;\n\n/**\n * Conditional output type for `core.call` based on the function signature's\n * return type:\n *\n * - `returns (uint256)` → `{ result: OutputHandle }`\n * - No returns clause   → `{ result: undefined }`\n * - Anything else        → `{ result: \"[TypeError] ...\" }` (compile-time error)\n *\n * When `TSig` is a non-literal `string` (e.g. a variable, not a string\n * constant), the type falls back to `{ result: OutputHandle | undefined }`\n * so that both void and uint256 call sites remain assignable.\n */\nexport type CoreCallResult<TSig extends string> = string extends TSig\n  ? { readonly result: OutputHandle<'uint256'> | undefined }\n  : ParseAbiItem<TSig> extends { type: 'function'; outputs: readonly [] }\n    ? { readonly result: undefined }\n    : ParseAbiItem<TSig> extends {\n          type: 'function';\n          outputs: readonly [{ type: 'uint256' }];\n        }\n      ? { readonly result: OutputHandle<'uint256'> }\n      : { readonly result: UnsupportedReturnTypeError<'core.call', TSig> };\n\n/**\n * Conditional output type for `core.staticCall`. staticCall always reads a\n * value, so void signatures are also rejected:\n *\n * - `returns (uint256)` → `{ result: OutputHandle }`\n * - No returns / other  → `{ result: \"[TypeError] ...\" }` (compile-time error)\n */\nexport type StaticCallResult<TSig extends string> = string extends TSig\n  ? { readonly result: OutputHandle<'uint256'> }\n  : ParseAbiItem<TSig> extends {\n        type: 'function';\n        outputs: readonly [{ type: 'uint256' }];\n      }\n    ? { readonly result: OutputHandle<'uint256'> }\n    : ParseAbiItem<TSig> extends { type: 'function'; outputs: readonly [] }\n      ? {\n          readonly result: `[TypeError] core.staticCall: function has no return value — staticCall requires a 'returns (uint256)' signature`;\n        }\n      : {\n          readonly result: UnsupportedReturnTypeError<'core.staticCall', TSig>;\n        };\n\n/**\n * Parses a Solidity function signature and returns parameter names in order.\n * Delegates to abitype's runtime `parseAbiItem` — the same parser that powers\n * the compile-time `ParseAbiItem<TSig>` type — so runtime and type-level\n * parsing can never diverge.\n *\n * @throws if the signature is not a valid function signature or a parameter is unnamed\n */\nexport const parseFunctionParams = (functionSignature: string): string[] => {\n  const parsed = parseAbiItem(functionSignature);\n  if (parsed.type !== 'function') {\n    throw new Error(\n      `core.call: expected a function signature, got \"${parsed.type}\": \"${functionSignature}\"`,\n    );\n  }\n\n  return parsed.inputs.map((input, index) => {\n    if (!input.name) {\n      throw new Error(\n        `core.call: parameter at index ${index} in signature has no name. All parameters must be named for named binds to work.`,\n      );\n    }\n    return input.name;\n  });\n};\n\n/**\n * Converts a ref-resolving bindable to a `Ref` (`{ $ref: string }`).\n * Handles carry a `_tag` property and are converted via `handleToRef`;\n * `Ref` objects pass through as-is.\n */\nexport const toBindRef = (bindable: AnyRefBindable): Ref => {\n  if ('_tag' in bindable) return handleToRef(bindable);\n  return bindable;\n};\n\nexport interface BuildCallWireFormatInput {\n  readonly resource?: AnyRefBindable;\n  readonly bind: Record<string, AnyRefBindable>;\n  readonly config: Record<string, unknown>;\n  readonly guards?: readonly TypedGuard[];\n}\n\nexport interface CallWireResult {\n  readonly op: 'core.call' | 'core.invoke';\n  readonly bind: Record<string, Ref>;\n  readonly config: Record<string, unknown>;\n  readonly guards?: readonly TypedGuard[];\n}\n\n/**\n * Parses a function signature from `config`, validates bind keys against it,\n * and converts named binds to positional `$ref` args.\n */\nconst resolvePositionalArgs = (\n  label: string,\n  bind: Record<string, AnyRefBindable>,\n  config: Record<string, unknown>,\n): Ref[] => {\n  const functionSignature = config.functionSignature;\n  if (typeof functionSignature !== 'string') {\n    throw new Error(\n      `${label}: config.functionSignature is required and must be a string`,\n    );\n  }\n\n  const paramNames = parseFunctionParams(functionSignature);\n  const paramSet = new Set(paramNames);\n  const bindKeys = Object.keys(bind);\n  const bindSet = new Set(bindKeys);\n\n  const missing = paramNames.filter((n) => !bindSet.has(n));\n  const extra = bindKeys.filter((k) => !paramSet.has(k));\n\n  if (missing.length > 0 || extra.length > 0) {\n    throw new Error(\n      `${label}: bind keys [${bindKeys.join(\n        ', ',\n      )}] do not match signature parameters [${paramNames.join(\n        ', ',\n      )}]. Missing: ${missing.join(', ') || '(none)'}. Extra: ${\n        extra.join(', ') || '(none)'\n      }.`,\n    );\n  }\n\n  return paramNames.map((name) => {\n    const bindable = bind[name];\n    if (bindable === undefined) {\n      throw new Error(\n        `${label}: bind value for parameter \"${name}\" is undefined`,\n      );\n    }\n    return toBindRef(bindable);\n  });\n};\n\n/**\n * Transforms the user-facing `resource` + named `bind` API into the wire\n * format that the backend expects:\n * - With resource: `core.call` with `bind: { input: <resourceRef> }`\n * - Without resource: `core.invoke` with `bind: {}`\n * - `config: { ...userConfig, args: [positional refs...] }`\n */\nexport const buildCallWireFormat = (\n  args: BuildCallWireFormatInput,\n): CallWireResult => {\n  const positionalArgs = resolvePositionalArgs(\n    'core.call',\n    args.bind,\n    args.config,\n  );\n  const hasResource = args.resource !== undefined;\n\n  return {\n    op: hasResource ? 'core.call' : 'core.invoke',\n    bind: hasResource ? { input: toBindRef(args.resource) } : {},\n    config: { ...args.config, args: positionalArgs },\n    ...(args.guards && args.guards.length > 0 && { guards: args.guards }),\n  };\n};\n\nexport interface BuildStaticCallWireFormatInput {\n  readonly bind: Record<string, AnyRefBindable>;\n  readonly config: Record<string, unknown>;\n  readonly guards?: readonly TypedGuard[];\n}\n\n/**\n * Transforms the user-facing named `bind` API into the wire format that the\n * backend expects for `core.staticCall`. Same as `buildCallWireFormat` but\n * with no `resource` field — staticCall has no resource inputs.\n */\nexport const buildStaticCallWireFormat = (\n  args: BuildStaticCallWireFormatInput,\n): CallArgs => {\n  const positionalArgs = resolvePositionalArgs(\n    'core.staticCall',\n    args.bind,\n    args.config,\n  );\n\n  return {\n    bind: {},\n    config: { ...args.config, args: positionalArgs },\n    ...(args.guards && args.guards.length > 0 && { guards: args.guards }),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,qBAAgD;AAMhD,qBAA4B;AA0GrB,MAAM,sBAAsB,CAAC,sBAAwC;AAC1E,QAAM,aAAS,6BAAa,iBAAiB;AAC7C,MAAI,OAAO,SAAS,YAAY;AAC9B,UAAM,IAAI;AAAA,MACR,kDAAkD,OAAO,IAAI,OAAO,iBAAiB;AAAA,IACvF;AAAA,EACF;AAEA,SAAO,OAAO,OAAO,IAAI,CAAC,OAAO,UAAU;AACzC,QAAI,CAAC,MAAM,MAAM;AACf,YAAM,IAAI;AAAA,QACR,iCAAiC,KAAK;AAAA,MACxC;AAAA,IACF;AACA,WAAO,MAAM;AAAA,EACf,CAAC;AACH;AAOO,MAAM,YAAY,CAAC,aAAkC;AAC1D,MAAI,UAAU,SAAU,YAAO,4BAAY,QAAQ;AACnD,SAAO;AACT;AAoBA,MAAM,wBAAwB,CAC5B,OACA,MACA,WACU;AACV,QAAM,oBAAoB,OAAO;AACjC,MAAI,OAAO,sBAAsB,UAAU;AACzC,UAAM,IAAI;AAAA,MACR,GAAG,KAAK;AAAA,IACV;AAAA,EACF;AAEA,QAAM,aAAa,oBAAoB,iBAAiB;AACxD,QAAM,WAAW,IAAI,IAAI,UAAU;AACnC,QAAM,WAAW,OAAO,KAAK,IAAI;AACjC,QAAM,UAAU,IAAI,IAAI,QAAQ;AAEhC,QAAM,UAAU,WAAW,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;AACxD,QAAM,QAAQ,SAAS,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;AAErD,MAAI,QAAQ,SAAS,KAAK,MAAM,SAAS,GAAG;AAC1C,UAAM,IAAI;AAAA,MACR,GAAG,KAAK,gBAAgB,SAAS;AAAA,QAC/B;AAAA,MACF,CAAC,wCAAwC,WAAW;AAAA,QAClD;AAAA,MACF,CAAC,eAAe,QAAQ,KAAK,IAAI,KAAK,QAAQ,YAC5C,MAAM,KAAK,IAAI,KAAK,QACtB;AAAA,IACF;AAAA,EACF;AAEA,SAAO,WAAW,IAAI,CAAC,SAAS;AAC9B,UAAM,WAAW,KAAK,IAAI;AAC1B,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI;AAAA,QACR,GAAG,KAAK,+BAA+B,IAAI;AAAA,MAC7C;AAAA,IACF;AACA,WAAO,UAAU,QAAQ;AAAA,EAC3B,CAAC;AACH;AASO,MAAM,sBAAsB,CACjC,SACmB;AACnB,QAAM,iBAAiB;AAAA,IACrB;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AAAA,EACP;AACA,QAAM,cAAc,KAAK,aAAa;AAEtC,SAAO;AAAA,IACL,IAAI,cAAc,cAAc;AAAA,IAChC,MAAM,cAAc,EAAE,OAAO,UAAU,KAAK,QAAQ,EAAE,IAAI,CAAC;AAAA,IAC3D,QAAQ,EAAE,GAAG,KAAK,QAAQ,MAAM,eAAe;AAAA,IAC/C,GAAI,KAAK,UAAU,KAAK,OAAO,SAAS,KAAK,EAAE,QAAQ,KAAK,OAAO;AAAA,EACrE;AACF;AAaO,MAAM,4BAA4B,CACvC,SACa;AACb,QAAM,iBAAiB;AAAA,IACrB;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AAAA,EACP;AAEA,SAAO;AAAA,IACL,MAAM,CAAC;AAAA,IACP,QAAQ,EAAE,GAAG,KAAK,QAAQ,MAAM,eAAe;AAAA,IAC/C,GAAI,KAAK,UAAU,KAAK,OAAO,SAAS,KAAK,EAAE,QAAQ,KAAK,OAAO;AAAA,EACrE;AACF;","names":[]}
+{"version":3,"file":"signatureArgs.cjs","names":["parseAbiItem","handleToRef"],"sources":["../../src/authoring/signatureArgs.ts"],"sourcesContent":["import type { Ref } from '@lifi/compose-spec';\nimport { type ParseAbiItem, parseAbiItem } from 'abitype';\n\nimport type { AbiTypeToOutputKind, TypedGuard } from '../types.js';\n\nimport type { CallArgs } from './FlowBuilderCore.js';\nimport type { AnyRefBindable, OutputHandle, RefBindable } from './handles.js';\nimport { handleToRef } from './handles.js';\n\n/**\n * Type-level extraction of named bind keys from a function signature string.\n * When `TSig` is a string literal matching a Solidity function signature,\n * resolves to a record whose keys are the parameter names and values are\n * `RefBindable<kind>` where the kind is derived from each parameter's Solidity\n * type via `AbiTypeToOutputKind`. For recognised `SolType` parameters\n * (e.g. `uint256`, `address`, `uint128`) the bind slot is precisely typed;\n * for other Solidity types (e.g. tuples) the slot accepts any scalar handle.\n * Falls back to `Record<string, AnyRefBindable>` for non-literal strings.\n *\n * These slots are lowered into `config.args`, which is positional calldata\n * rather than a node `bind` record, so a literal is not accepted here: only\n * values that resolve to a `$ref`.\n */\nexport type SignatureBind<TSig extends string> = string extends TSig\n  ? Record<string, AnyRefBindable>\n  : ParseAbiItem<TSig> extends {\n        type: 'function';\n        inputs: infer I extends readonly { name: string; type: string }[];\n      }\n    ? {\n        readonly [P in I[number] as P['name']]: RefBindable<\n          AbiTypeToOutputKind<P['type']>\n        >;\n      }\n    : Record<string, AnyRefBindable>;\n\n// ---------------------------------------------------------------------------\n// Return-type inference from function signatures\n// ---------------------------------------------------------------------------\n\n/**\n * Describes the output type(s) of a parsed function signature as a\n * human-readable string for inclusion in type-level error messages.\n */\ntype DescribeOutputs<O extends readonly { type: string }[]> =\n  O extends readonly [{ type: infer T extends string }] ? T : 'multiple values';\n\n/**\n * A string-literal type that surfaces a clear error when the user provides a\n * function signature whose return type is not supported by core.call.\n * The message is visible in IDE tooltips and compiler diagnostics.\n */\ntype UnsupportedReturnTypeError<TLabel extends string, TSig extends string> =\n  ParseAbiItem<TSig> extends {\n    type: 'function';\n    outputs: infer O extends readonly { type: string }[];\n  }\n    ? `[TypeError] ${TLabel}: return type '${DescribeOutputs<O>}' is not supported — only 'uint256' or void signatures are allowed`\n    : `[TypeError] ${TLabel}: unable to parse return type from signature`;\n\n/**\n * Conditional output type for `core.call` based on the function signature's\n * return type:\n *\n * - `returns (uint256)` → `{ result: OutputHandle }`\n * - No returns clause   → `{ result: undefined }`\n * - Anything else        → `{ result: \"[TypeError] ...\" }` (compile-time error)\n *\n * When `TSig` is a non-literal `string` (e.g. a variable, not a string\n * constant), the type falls back to `{ result: OutputHandle | undefined }`\n * so that both void and uint256 call sites remain assignable.\n */\nexport type CoreCallResult<TSig extends string> = string extends TSig\n  ? { readonly result: OutputHandle<'uint256'> | undefined }\n  : ParseAbiItem<TSig> extends { type: 'function'; outputs: readonly [] }\n    ? { readonly result: undefined }\n    : ParseAbiItem<TSig> extends {\n          type: 'function';\n          outputs: readonly [{ type: 'uint256' }];\n        }\n      ? { readonly result: OutputHandle<'uint256'> }\n      : { readonly result: UnsupportedReturnTypeError<'core.call', TSig> };\n\n/**\n * Conditional output type for `core.staticCall`. staticCall always reads a\n * value, so void signatures are also rejected:\n *\n * - `returns (uint256)` → `{ result: OutputHandle }`\n * - No returns / other  → `{ result: \"[TypeError] ...\" }` (compile-time error)\n */\nexport type StaticCallResult<TSig extends string> = string extends TSig\n  ? { readonly result: OutputHandle<'uint256'> }\n  : ParseAbiItem<TSig> extends {\n        type: 'function';\n        outputs: readonly [{ type: 'uint256' }];\n      }\n    ? { readonly result: OutputHandle<'uint256'> }\n    : ParseAbiItem<TSig> extends { type: 'function'; outputs: readonly [] }\n      ? {\n          readonly result: `[TypeError] core.staticCall: function has no return value — staticCall requires a 'returns (uint256)' signature`;\n        }\n      : {\n          readonly result: UnsupportedReturnTypeError<'core.staticCall', TSig>;\n        };\n\n/**\n * Parses a Solidity function signature and returns parameter names in order.\n * Delegates to abitype's runtime `parseAbiItem` — the same parser that powers\n * the compile-time `ParseAbiItem<TSig>` type — so runtime and type-level\n * parsing can never diverge.\n *\n * @throws if the signature is not a valid function signature or a parameter is unnamed\n */\nexport const parseFunctionParams = (functionSignature: string): string[] => {\n  const parsed = parseAbiItem(functionSignature);\n  if (parsed.type !== 'function') {\n    throw new Error(\n      `core.call: expected a function signature, got \"${parsed.type}\": \"${functionSignature}\"`,\n    );\n  }\n\n  return parsed.inputs.map((input, index) => {\n    if (!input.name) {\n      throw new Error(\n        `core.call: parameter at index ${index} in signature has no name. All parameters must be named for named binds to work.`,\n      );\n    }\n    return input.name;\n  });\n};\n\n/**\n * Converts a ref-resolving bindable to a `Ref` (`{ $ref: string }`).\n * Handles carry a `_tag` property and are converted via `handleToRef`;\n * `Ref` objects pass through as-is.\n */\nexport const toBindRef = (bindable: AnyRefBindable): Ref => {\n  if ('_tag' in bindable) return handleToRef(bindable);\n  return bindable;\n};\n\nexport interface BuildCallWireFormatInput {\n  readonly resource?: AnyRefBindable;\n  readonly bind: Record<string, AnyRefBindable>;\n  readonly config: Record<string, unknown>;\n  readonly guards?: readonly TypedGuard[];\n}\n\nexport interface CallWireResult {\n  readonly op: 'core.call' | 'core.invoke';\n  readonly bind: Record<string, Ref>;\n  readonly config: Record<string, unknown>;\n  readonly guards?: readonly TypedGuard[];\n}\n\n/**\n * Parses a function signature from `config`, validates bind keys against it,\n * and converts named binds to positional `$ref` args.\n */\nconst resolvePositionalArgs = (\n  label: string,\n  bind: Record<string, AnyRefBindable>,\n  config: Record<string, unknown>,\n): Ref[] => {\n  const functionSignature = config.functionSignature;\n  if (typeof functionSignature !== 'string') {\n    throw new Error(\n      `${label}: config.functionSignature is required and must be a string`,\n    );\n  }\n\n  const paramNames = parseFunctionParams(functionSignature);\n  const paramSet = new Set(paramNames);\n  const bindKeys = Object.keys(bind);\n  const bindSet = new Set(bindKeys);\n\n  const missing = paramNames.filter((n) => !bindSet.has(n));\n  const extra = bindKeys.filter((k) => !paramSet.has(k));\n\n  if (missing.length > 0 || extra.length > 0) {\n    throw new Error(\n      `${label}: bind keys [${bindKeys.join(\n        ', ',\n      )}] do not match signature parameters [${paramNames.join(\n        ', ',\n      )}]. Missing: ${missing.join(', ') || '(none)'}. Extra: ${\n        extra.join(', ') || '(none)'\n      }.`,\n    );\n  }\n\n  return paramNames.map((name) => {\n    const bindable = bind[name];\n    if (bindable === undefined) {\n      throw new Error(\n        `${label}: bind value for parameter \"${name}\" is undefined`,\n      );\n    }\n    return toBindRef(bindable);\n  });\n};\n\n/**\n * Transforms the user-facing `resource` + named `bind` API into the wire\n * format that the backend expects:\n * - With resource: `core.call` with `bind: { input: <resourceRef> }`\n * - Without resource: `core.invoke` with `bind: {}`\n * - `config: { ...userConfig, args: [positional refs...] }`\n */\nexport const buildCallWireFormat = (\n  args: BuildCallWireFormatInput,\n): CallWireResult => {\n  const positionalArgs = resolvePositionalArgs(\n    'core.call',\n    args.bind,\n    args.config,\n  );\n  const hasResource = args.resource !== undefined;\n\n  return {\n    op: hasResource ? 'core.call' : 'core.invoke',\n    bind: hasResource ? { input: toBindRef(args.resource) } : {},\n    config: { ...args.config, args: positionalArgs },\n    ...(args.guards && args.guards.length > 0 && { guards: args.guards }),\n  };\n};\n\nexport interface BuildStaticCallWireFormatInput {\n  readonly bind: Record<string, AnyRefBindable>;\n  readonly config: Record<string, unknown>;\n  readonly guards?: readonly TypedGuard[];\n}\n\n/**\n * Transforms the user-facing named `bind` API into the wire format that the\n * backend expects for `core.staticCall`. Same as `buildCallWireFormat` but\n * with no `resource` field — staticCall has no resource inputs.\n */\nexport const buildStaticCallWireFormat = (\n  args: BuildStaticCallWireFormatInput,\n): CallArgs => {\n  const positionalArgs = resolvePositionalArgs(\n    'core.staticCall',\n    args.bind,\n    args.config,\n  );\n\n  return {\n    bind: {},\n    config: { ...args.config, args: positionalArgs },\n    ...(args.guards && args.guards.length > 0 && { guards: args.guards }),\n  };\n};\n"],"mappings":";;;;;;;;;;;;AAiHA,MAAa,uBAAuB,sBAAwC;CAC1E,MAAM,UAAA,GAASA,QAAAA,aAAAA,CAAa,iBAAiB;CAC7C,IAAI,OAAO,SAAS,YAClB,MAAM,IAAI,MACR,kDAAkD,OAAO,KAAK,MAAM,kBAAkB,EACxF;CAGF,OAAO,OAAO,OAAO,KAAK,OAAO,UAAU;EACzC,IAAI,CAAC,MAAM,MACT,MAAM,IAAI,MACR,iCAAiC,MAAM,iFACzC;EAEF,OAAO,MAAM;CACf,CAAC;AACH;;;;;;AAOA,MAAa,aAAa,aAAkC;CAC1D,IAAI,UAAU,UAAU,OAAOC,0BAAAA,YAAY,QAAQ;CACnD,OAAO;AACT;;;;;AAoBA,MAAM,yBACJ,OACA,MACA,WACU;CACV,MAAM,oBAAoB,OAAO;CACjC,IAAI,OAAO,sBAAsB,UAC/B,MAAM,IAAI,MACR,GAAG,MAAM,4DACX;CAGF,MAAM,aAAa,oBAAoB,iBAAiB;CACxD,MAAM,WAAW,IAAI,IAAI,UAAU;CACnC,MAAM,WAAW,OAAO,KAAK,IAAI;CACjC,MAAM,UAAU,IAAI,IAAI,QAAQ;CAEhC,MAAM,UAAU,WAAW,QAAQ,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;CACxD,MAAM,QAAQ,SAAS,QAAQ,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;CAErD,IAAI,QAAQ,SAAS,KAAK,MAAM,SAAS,GACvC,MAAM,IAAI,MACR,GAAG,MAAM,eAAe,SAAS,KAC/B,IACF,EAAE,uCAAuC,WAAW,KAClD,IACF,EAAE,cAAc,QAAQ,KAAK,IAAI,KAAK,SAAS,WAC7C,MAAM,KAAK,IAAI,KAAK,SACrB,EACH;CAGF,OAAO,WAAW,KAAK,SAAS;EAC9B,MAAM,WAAW,KAAK;EACtB,IAAI,aAAa,KAAA,GACf,MAAM,IAAI,MACR,GAAG,MAAM,8BAA8B,KAAK,eAC9C;EAEF,OAAO,UAAU,QAAQ;CAC3B,CAAC;AACH;;;;;;;;AASA,MAAa,uBACX,SACmB;CACnB,MAAM,iBAAiB,sBACrB,aACA,KAAK,MACL,KAAK,MACP;CACA,MAAM,cAAc,KAAK,aAAa,KAAA;CAEtC,OAAO;EACL,IAAI,cAAc,cAAc;EAChC,MAAM,cAAc,EAAE,OAAO,UAAU,KAAK,QAAQ,EAAE,IAAI,CAAC;EAC3D,QAAQ;GAAE,GAAG,KAAK;GAAQ,MAAM;EAAe;EAC/C,GAAI,KAAK,UAAU,KAAK,OAAO,SAAS,KAAK,EAAE,QAAQ,KAAK,OAAO;CACrE;AACF;;;;;;AAaA,MAAa,6BACX,SACa;CACb,MAAM,iBAAiB,sBACrB,mBACA,KAAK,MACL,KAAK,MACP;CAEA,OAAO;EACL,MAAM,CAAC;EACP,QAAQ;GAAE,GAAG,KAAK;GAAQ,MAAM;EAAe;EAC/C,GAAI,KAAK,UAAU,KAAK,OAAO,SAAS,KAAK,EAAE,QAAQ,KAAK,OAAO;CACrE;AACF"}

package/dist/authoring/signatureArgs.d.cts

@@ -1,9 +1,9 @@
-import { Ref } from '@lifi/compose-spec';
-import { ParseAbiItem } from 'abitype';
-import { AbiTypeToOutputKind, TypedGuard } from '../types.cjs';
-import { CallArgs } from './FlowBuilderCore.cjs';
-import { AnyRefBindable, RefBindable, OutputHandle } from './handles.cjs';
-
+import { AbiTypeToOutputKind, TypedGuard } from "../types.cjs";
+import { AnyRefBindable, OutputHandle, RefBindable } from "./handles.cjs";
+import { CallArgs } from "./FlowBuilderCore.cjs";
+import { Ref } from "@lifi/compose-spec";
+import { ParseAbiItem } from "abitype";
+//#region src/authoring/signatureArgs.d.ts
 /**
  * Type-level extraction of named bind keys from a function signature string.
  * When `TSig` is a string literal matching a Solidity function signature,
@@ -18,34 +18,32 @@ import { AnyRefBindable, RefBindable, OutputHandle } from './handles.cjs';
  * rather than a node `bind` record, so a literal is not accepted here: only
  * values that resolve to a `$ref`.
  */
-type SignatureBind<TSig extends string> = string extends TSig ? Record<string, AnyRefBindable> : ParseAbiItem<TSig> extends {
-    type: 'function';
-    inputs: infer I extends readonly {
-        name: string;
-        type: string;
-    }[];
-} ? {
-    readonly [P in I[number] as P['name']]: RefBindable<AbiTypeToOutputKind<P['type']>>;
-} : Record<string, AnyRefBindable>;
+export type SignatureBind<TSig extends string> = string extends TSig ? Record<string, AnyRefBindable> : ParseAbiItem<TSig> extends {
+  type: "function";
+  inputs: infer I extends readonly {
+    name: string;
+    type: string;
+  }[];
+} ? { readonly [P in I[number] as P["name"]]: RefBindable<AbiTypeToOutputKind<P["type"]>>; } : Record<string, AnyRefBindable>;
 /**
  * Describes the output type(s) of a parsed function signature as a
  * human-readable string for inclusion in type-level error messages.
  */
 type DescribeOutputs<O extends readonly {
-    type: string;
+  type: string;
 }[]> = O extends readonly [{
-    type: infer T extends string;
-}] ? T : 'multiple values';
+  type: infer T extends string;
+}] ? T : "multiple values";
 /**
  * A string-literal type that surfaces a clear error when the user provides a
  * function signature whose return type is not supported by core.call.
  * The message is visible in IDE tooltips and compiler diagnostics.
  */
 type UnsupportedReturnTypeError<TLabel extends string, TSig extends string> = ParseAbiItem<TSig> extends {
-    type: 'function';
-    outputs: infer O extends readonly {
-        type: string;
-    }[];
+  type: "function";
+  outputs: infer O extends readonly {
+    type: string;
+  }[];
 } ? `[TypeError] ${TLabel}: return type '${DescribeOutputs<O>}' is not supported — only 'uint256' or void signatures are allowed` : `[TypeError] ${TLabel}: unable to parse return type from signature`;
 /**
  * Conditional output type for `core.call` based on the function signature's
@@ -59,22 +57,22 @@ type UnsupportedReturnTypeError<TLabel extends string, TSig extends string> = Pa
  * constant), the type falls back to `{ result: OutputHandle | undefined }`
  * so that both void and uint256 call sites remain assignable.
  */
-type CoreCallResult<TSig extends string> = string extends TSig ? {
-    readonly result: OutputHandle<'uint256'> | undefined;
+export type CoreCallResult<TSig extends string> = string extends TSig ? {
+  readonly result: OutputHandle<"uint256"> | undefined;
 } : ParseAbiItem<TSig> extends {
-    type: 'function';
-    outputs: readonly [];
+  type: "function";
+  outputs: readonly [];
 } ? {
-    readonly result: undefined;
+  readonly result: undefined;
 } : ParseAbiItem<TSig> extends {
-    type: 'function';
-    outputs: readonly [{
-        type: 'uint256';
-    }];
+  type: "function";
+  outputs: readonly [{
+    type: "uint256";
+  }];
 } ? {
-    readonly result: OutputHandle<'uint256'>;
+  readonly result: OutputHandle<"uint256">;
 } : {
-    readonly result: UnsupportedReturnTypeError<'core.call', TSig>;
+  readonly result: UnsupportedReturnTypeError<"core.call", TSig>;
 };
 /**
  * Conditional output type for `core.staticCall`. staticCall always reads a
@@ -83,22 +81,22 @@ type CoreCallResult<TSig extends string> = string extends TSig ? {
  * - `returns (uint256)` → `{ result: OutputHandle }`
  * - No returns / other  → `{ result: "[TypeError] ..." }` (compile-time error)
  */
-type StaticCallResult<TSig extends string> = string extends TSig ? {
-    readonly result: OutputHandle<'uint256'>;
+export type StaticCallResult<TSig extends string> = string extends TSig ? {
+  readonly result: OutputHandle<"uint256">;
 } : ParseAbiItem<TSig> extends {
-    type: 'function';
-    outputs: readonly [{
-        type: 'uint256';
-    }];
+  type: "function";
+  outputs: readonly [{
+    type: "uint256";
+  }];
 } ? {
-    readonly result: OutputHandle<'uint256'>;
+  readonly result: OutputHandle<"uint256">;
 } : ParseAbiItem<TSig> extends {
-    type: 'function';
-    outputs: readonly [];
+  type: "function";
+  outputs: readonly [];
 } ? {
-    readonly result: `[TypeError] core.staticCall: function has no return value — staticCall requires a 'returns (uint256)' signature`;
+  readonly result: `[TypeError] core.staticCall: function has no return value — staticCall requires a 'returns (uint256)' signature`;
 } : {
-    readonly result: UnsupportedReturnTypeError<'core.staticCall', TSig>;
+  readonly result: UnsupportedReturnTypeError<"core.staticCall", TSig>;
 };
 /**
  * Parses a Solidity function signature and returns parameter names in order.
@@ -108,24 +106,24 @@ type StaticCallResult<TSig extends string> = string extends TSig ? {
  *
  * @throws if the signature is not a valid function signature or a parameter is unnamed
  */
-declare const parseFunctionParams: (functionSignature: string) => string[];
+export declare const parseFunctionParams: (functionSignature: string) => string[];
 /**
  * Converts a ref-resolving bindable to a `Ref` (`{ $ref: string }`).
  * Handles carry a `_tag` property and are converted via `handleToRef`;
  * `Ref` objects pass through as-is.
  */
-declare const toBindRef: (bindable: AnyRefBindable) => Ref;
-interface BuildCallWireFormatInput {
-    readonly resource?: AnyRefBindable;
-    readonly bind: Record<string, AnyRefBindable>;
-    readonly config: Record<string, unknown>;
-    readonly guards?: readonly TypedGuard[];
+export declare const toBindRef: (bindable: AnyRefBindable) => Ref;
+export interface BuildCallWireFormatInput {
+  readonly resource?: AnyRefBindable;
+  readonly bind: Record<string, AnyRefBindable>;
+  readonly config: Record<string, unknown>;
+  readonly guards?: readonly TypedGuard[];
 }
-interface CallWireResult {
-    readonly op: 'core.call' | 'core.invoke';
-    readonly bind: Record<string, Ref>;
-    readonly config: Record<string, unknown>;
-    readonly guards?: readonly TypedGuard[];
+export interface CallWireResult {
+  readonly op: "core.call" | "core.invoke";
+  readonly bind: Record<string, Ref>;
+  readonly config: Record<string, unknown>;
+  readonly guards?: readonly TypedGuard[];
 }
 /**
  * Transforms the user-facing `resource` + named `bind` API into the wire
@@ -134,17 +132,18 @@ interface CallWireResult {
  * - Without resource: `core.invoke` with `bind: {}`
  * - `config: { ...userConfig, args: [positional refs...] }`
  */
-declare const buildCallWireFormat: (args: BuildCallWireFormatInput) => CallWireResult;
-interface BuildStaticCallWireFormatInput {
-    readonly bind: Record<string, AnyRefBindable>;
-    readonly config: Record<string, unknown>;
-    readonly guards?: readonly TypedGuard[];
+export declare const buildCallWireFormat: (args: BuildCallWireFormatInput) => CallWireResult;
+export interface BuildStaticCallWireFormatInput {
+  readonly bind: Record<string, AnyRefBindable>;
+  readonly config: Record<string, unknown>;
+  readonly guards?: readonly TypedGuard[];
 }
 /**
  * Transforms the user-facing named `bind` API into the wire format that the
  * backend expects for `core.staticCall`. Same as `buildCallWireFormat` but
  * with no `resource` field — staticCall has no resource inputs.
  */
-declare const buildStaticCallWireFormat: (args: BuildStaticCallWireFormatInput) => CallArgs;
-
-export { type BuildCallWireFormatInput, type BuildStaticCallWireFormatInput, type CallWireResult, type CoreCallResult, type SignatureBind, type StaticCallResult, buildCallWireFormat, buildStaticCallWireFormat, parseFunctionParams, toBindRef };
+export declare const buildStaticCallWireFormat: (args: BuildStaticCallWireFormatInput) => CallArgs;
+//#endregion
+export {};
+//# sourceMappingURL=signatureArgs.d.cts.map