@tai42/studio-sdk 13.3.0 → 15.0.0

package/dist/state-binding/UpdateRow.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge } from '../components/badge';
+import { Button } from '../components/primitives';
+import { Field } from '../components/field';
+import { Select } from '../components/select';
+import { TemplatedTextField } from '../components/templated-text-field';
+import { CloseIcon } from '../components/icons';
+import { AdapterMapping } from './AdapterMapping';
+import { BindingTemplatedJqField } from './BindingTemplatedJqField';
+import { findByRef } from './catalog';
+const CUSTOM = '__custom__';
+function optionLabel(entry) {
+    return entry.description !== undefined && entry.description !== ''
+        ? `${entry.ref} — ${entry.description}`
+        : entry.ref;
+}
+function writesLabel(entry) {
+    if (entry?.writes === undefined || entry.writes.length === 0)
+        return null;
+    return entry.writes.map((path) => path.join('.')).join(', ');
+}
+function UpdateRowEditor({ update, index, updateJq, sources, suggestions, templates, onChange, onRemove, }) {
+    const isCustom = update.jq !== null;
+    const selectValue = isCustom ? CUSTOM : (update.template_jq ?? '');
+    const resolved = update.template_jq !== null ? findByRef(update.template_jq, updateJq) : undefined;
+    const writes = writesLabel(resolved);
+    return (_jsxs("div", { "data-testid": `update-row-${String(index)}`, style: {
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 'var(--tai-space-2)',
+            padding: 'var(--tai-space-2)',
+            border: '1px solid var(--tai-color-border)',
+            borderRadius: 'var(--tai-radius-md)',
+        }, children: [_jsxs("div", { style: {
+                    display: 'flex',
+                    gap: 'var(--tai-space-2)',
+                    alignItems: 'center',
+                    flexWrap: 'wrap',
+                }, children: [_jsx(Field, { label: `Update source ${String(index + 1)}`, hideLabel: true, children: _jsx(Select, { placeholder: "Choose a template jq", value: selectValue, onValueChange: (next) => {
+                                if (next === CUSTOM)
+                                    onChange({
+                                        template_jq: null,
+                                        jq: { content: '' },
+                                        adapter: null,
+                                        op_id: update.op_id,
+                                    });
+                                else
+                                    onChange({ template_jq: next, jq: null, adapter: null, op_id: update.op_id });
+                            }, groups: [
+                                {
+                                    label: 'Template jq',
+                                    options: updateJq.map((entry) => ({ value: entry.ref, label: optionLabel(entry) })),
+                                },
+                                { label: 'Custom', options: [{ value: CUSTOM, label: 'Custom jq' }] },
+                            ] }) }), writes !== null ? _jsx(Badge, { variant: "neutral", children: `writes: ${writes}` }) : null, _jsx(Button, { type: "button", variant: "ghost", "aria-label": `Remove update ${String(index + 1)}`, onClick: onRemove, children: _jsx(CloseIcon, { "aria-hidden": "true" }) })] }), isCustom ? (_jsx(BindingTemplatedJqField, { label: `Custom update jq ${String(index + 1)}`, required: true, description: "A jq over `{ record, output, input }` returning a template-relative op batch.", value: update.jq, onChange: (next) => {
+                    onChange({
+                        template_jq: null,
+                        jq: next ?? { content: '' },
+                        adapter: null,
+                        op_id: update.op_id,
+                    });
+                }, suggestions: suggestions, templates: templates })) : (_jsx(TemplatedTextField
+            // Remount on a template change so the mapping rebuilds from the newly
+            // declared input (and re-seeds its shown default) instead of stale rows.
+            , { label: "Adapter", value: update.adapter, templates: templates?.templates, templatesLoading: templates?.loading, templatesError: templates?.error, onTemplatesRetry: templates?.onRetry, storageAbsent: templates?.storageAbsent, storagePresenceLoading: templates?.storagePresenceLoading, onChange: (next) => {
+                    onChange({ ...update, adapter: next });
+                }, renderInline: ({ value: inlineValue, onChange: onInline }) => (_jsx(AdapterMapping, { declaredInput: resolved?.params ?? [], value: inlineValue, sources: sources, suggestions: suggestions, onChange: (adapterJq) => {
+                        onInline(adapterJq ?? '');
+                    } })) }, resolved?.ref ?? '__none__')), _jsx(BindingTemplatedJqField, { label: "Op id", description: "Optional \u2014 an idempotency-key expression.", value: update.op_id, onChange: (next) => {
+                    onChange({ ...update, op_id: next });
+                }, suggestions: suggestions, templates: templates })] }));
+}
+export function UpdateList({ updates, onChange, updateJq, sources, suggestions, templates, }) {
+    const add = () => {
+        const first = updateJq[0];
+        const next = first !== undefined
+            ? { template_jq: first.ref, jq: null, adapter: null, op_id: null }
+            : { template_jq: null, jq: { content: '' }, adapter: null, op_id: null };
+        onChange([...updates, next]);
+    };
+    return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--tai-space-2)' }, children: [updates.map((update, index) => (_jsx(UpdateRowEditor
+            // Rows are positional; the index is their stable identity within a save.
+            , { update: update, index: index, updateJq: updateJq, sources: sources, suggestions: suggestions, templates: templates, onChange: (next) => {
+                    onChange(updates.map((current, position) => (position === index ? next : current)));
+                }, onRemove: () => {
+                    onChange(updates.filter((_, position) => position !== index));
+                } }, index))), _jsx("div", { children: _jsx(Button, { type: "button", variant: "ghost", onClick: add, children: "Add update" }) })] }));
+}
+//# sourceMappingURL=UpdateRow.js.map

package/dist/state-binding/UpdateRow.js.map

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

package/dist/state-binding/adapter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The adapter compiler — a PURE function set, no React, no jq engine.
+ *
+ * A named template `update` jq declares an input object (its `params` / declared
+ * input keys). A binding must map the run's OUTPUT (and the run's INPUT) into that
+ * object; that mapping is the `adapter` — a single jq program over `{ output, input }`
+ * that CONSTRUCTS the update jq's declared input (which the update jq then reads as
+ * `.input` alongside the record).
+ *
+ * The editor authors the adapter as a ROW form: one row per declared input key,
+ * each row picking one of three value sources — a picked field (from the run's
+ * output / input schema), a hardcoded literal, or a raw jq expression. The whole
+ * form compiles here into ONE adapter jq; each row's own jq fragment is shown on demand.
+ *
+ * Compilation never throws: an invalid literal or an empty field surfaces as a
+ * loud, human error the editor renders in a `role="alert"`, never a silent empty
+ * object.
+ */
+/** Which root of `{ output, input }` a picked field reads. */
+export type FieldRoot = 'output' | 'input';
+/** A picked field: a path into `output` or `input`. */
+export interface FieldSource {
+    readonly kind: 'field';
+    readonly root: FieldRoot;
+    readonly path: readonly string[];
+}
+/** A hardcoded literal, authored as JSON text (`"a"`, `42`, `true`, `{…}`). */
+export interface LiteralSource {
+    readonly kind: 'literal';
+    readonly json: string;
+}
+/** A raw jq expression over `{ output, input }`. */
+export interface JqSource {
+    readonly kind: 'jq';
+    readonly expr: string;
+}
+/** The three value sources one mapping row may carry — exactly one at a time. */
+export type MappingSource = FieldSource | LiteralSource | JqSource;
+/** One mapping row: a target key of the update jq's declared input + its value source. */
+export interface MappingRow {
+    readonly target: string;
+    readonly source: MappingSource;
+}
+/** A compile outcome: the jq program, or a human error to surface loudly. */
+export type AdapterCompileResult = {
+    readonly ok: true;
+    readonly jq: string;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+/** An object key rendered for jq: a bare identifier, or a quoted string otherwise. */
+export declare function jqKey(key: string): string;
+/** A picked field rendered as a jq path, e.g. `.output.user.name` / `.input["odd key"]`. */
+export declare function fieldPathToJq(root: FieldRoot, path: readonly string[]): string;
+/** The jq fragment ONE row's value compiles to — the row's "show jq". */
+export declare function rowValueJq(source: MappingSource): AdapterCompileResult;
+/**
+ * Compile a mapping form into ONE adapter jq that constructs the update jq's
+ * declared input over `{ output, input }`. An empty form compiles to the
+ * empty object `{}`; a blank target, a duplicate target, or an invalid source is a
+ * loud error.
+ */
+export declare function compileAdapter(rows: readonly MappingRow[]): AdapterCompileResult;
+/** One row per declared input key, each defaulting to a picked `output` field. */
+export declare function defaultRowsForInput(params: readonly string[]): MappingRow[];
+/** Recover a field source from a pure path expression, or `null` if it is not one. */
+export declare function parseFieldPath(value: string): FieldSource | null;
+/** Recover the mapping rows from a stored adapter jq, or `null` if it is not the generated shape. */
+export declare function parseAdapter(jq: string): MappingRow[] | null;
+/**
+ * Encode a template-name slug for a jq identifier: each `-` becomes `_`. Under the slug
+ * invariant (no consecutive or trailing hyphens) the result carries no `__` and no
+ * trailing `_`, which is what makes the first `__` in a call name the template boundary.
+ */
+export declare function encodeTemplateSegment(template: string): string;
+/**
+ * The single-expression form of a named template update built from a mapping form:
+ * `tjq_<enc(template)>__<name>({…})` for a qualified ref, `tjq_<name>({…})` for a bare
+ * one (see the module note on the `__` boundary invariant).
+ */
+export declare function generateTemplateCall(ref: string, rows: readonly MappingRow[]): string;
+/**
+ * Recover `{ callName, adapter }` from a `tjq_<callName>(<adapter>)` call, or `null`
+ * otherwise. `callName` is the RAW jq identifier — NEVER split here (a jq name may carry
+ * its own `__` past the template boundary); resolve it to a catalog ref with
+ * `resolveCallName`.
+ */
+export declare function parseTemplateCall(expr: string): {
+    callName: string;
+    adapter: string;
+} | null;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/state-binding/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/state-binding/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3C,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEnE,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,MAAM,oBAAoB,GAC9B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9F,sFAAsF;AACtF,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAM9E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,oBAAoB,CAsBtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,oBAAoB,CAchF;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,EAAE,CAK3E;AAgBD,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuBhE;AAmCD,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,IAAI,CAqB5D;AAmBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAGrF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI5F"}

package/dist/state-binding/adapter.js

@@ -0,0 +1,251 @@
+/**
+ * The adapter compiler — a PURE function set, no React, no jq engine.
+ *
+ * A named template `update` jq declares an input object (its `params` / declared
+ * input keys). A binding must map the run's OUTPUT (and the run's INPUT) into that
+ * object; that mapping is the `adapter` — a single jq program over `{ output, input }`
+ * that CONSTRUCTS the update jq's declared input (which the update jq then reads as
+ * `.input` alongside the record).
+ *
+ * The editor authors the adapter as a ROW form: one row per declared input key,
+ * each row picking one of three value sources — a picked field (from the run's
+ * output / input schema), a hardcoded literal, or a raw jq expression. The whole
+ * form compiles here into ONE adapter jq; each row's own jq fragment is shown on demand.
+ *
+ * Compilation never throws: an invalid literal or an empty field surfaces as a
+ * loud, human error the editor renders in a `role="alert"`, never a silent empty
+ * object.
+ */
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** An object key rendered for jq: a bare identifier, or a quoted string otherwise. */
+export function jqKey(key) {
+    return IDENTIFIER.test(key) ? key : JSON.stringify(key);
+}
+/** A picked field rendered as a jq path, e.g. `.output.user.name` / `.input["odd key"]`. */
+export function fieldPathToJq(root, path) {
+    let out = `.${root}`;
+    for (const segment of path) {
+        out += IDENTIFIER.test(segment) ? `.${segment}` : `[${JSON.stringify(segment)}]`;
+    }
+    return out;
+}
+/** The jq fragment ONE row's value compiles to — the row's "show jq". */
+export function rowValueJq(source) {
+    switch (source.kind) {
+        case 'field':
+            return { ok: true, jq: fieldPathToJq(source.root, source.path) };
+        case 'literal': {
+            const text = source.json.trim();
+            if (text === '')
+                return { ok: false, error: 'Enter a value.' };
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                return { ok: false, error: 'This is not valid JSON.' };
+            }
+            // A parsed JSON value is a valid jq literal verbatim.
+            return { ok: true, jq: JSON.stringify(parsed) };
+        }
+        case 'jq': {
+            const expr = source.expr.trim();
+            if (expr === '')
+                return { ok: false, error: 'Enter a jq expression.' };
+            return { ok: true, jq: expr };
+        }
+    }
+}
+/**
+ * Compile a mapping form into ONE adapter jq that constructs the update jq's
+ * declared input over `{ output, input }`. An empty form compiles to the
+ * empty object `{}`; a blank target, a duplicate target, or an invalid source is a
+ * loud error.
+ */
+export function compileAdapter(rows) {
+    if (rows.length === 0)
+        return { ok: true, jq: '{}' };
+    const seen = new Set();
+    const parts = [];
+    for (const row of rows) {
+        const target = row.target.trim();
+        if (target === '')
+            return { ok: false, error: 'Every mapping row needs a target field.' };
+        if (seen.has(target))
+            return { ok: false, error: `The field '${target}' is mapped twice.` };
+        seen.add(target);
+        const value = rowValueJq(row.source);
+        if (!value.ok)
+            return { ok: false, error: `${target}: ${value.error}` };
+        parts.push(`${jqKey(target)}: (${value.jq})`);
+    }
+    return { ok: true, jq: `{ ${parts.join(', ')} }` };
+}
+/** One row per declared input key, each defaulting to a picked `output` field. */
+export function defaultRowsForInput(params) {
+    return params.map((target) => ({
+        target,
+        source: { kind: 'field', root: 'output', path: [] },
+    }));
+}
+// -- The round-trip: recover a mapping form from a STORED adapter jq --------------
+//
+// `compileAdapter` emits a canonical, PARSEABLE shape so a stored adapter reopens as
+// the form it was authored in (never UI-only state): the object
+// `{ <key>: (<value>), … }` where `<key>` is a bare identifier or a JSON string and
+// `<value>` is one of — a field path `.output…` / `.input…`, a JSON literal, or a raw
+// jq expression. `parseAdapter` inverts it; `parse(compileAdapter(rows).jq) === rows`
+// for every row kind whose literal is already canonical JSON. A shape it does not
+// recognise returns `null` — the editor falls back to the raw-jq escape hatch.
+const IDENTIFIER_HEAD = /^([A-Za-z_][A-Za-z0-9_]*)/;
+const BRACKET_SEGMENT = /^\[("(?:[^"\\]|\\.)*")\]/;
+const ADAPTER_KEY = /^("(?:[^"\\]|\\.)*"|[A-Za-z_][A-Za-z0-9_]*)\s*:\s*\(/;
+/** Recover a field source from a pure path expression, or `null` if it is not one. */
+export function parseFieldPath(value) {
+    const head = /^\.(output|input)/.exec(value);
+    if (head === null)
+        return null;
+    const root = head[1];
+    let rest = value.slice(head[0].length);
+    const path = [];
+    while (rest.length > 0) {
+        if (rest.startsWith('.')) {
+            const segment = IDENTIFIER_HEAD.exec(rest.slice(1));
+            if (segment?.[1] === undefined)
+                return null;
+            path.push(segment[1]);
+            rest = rest.slice(1 + segment[0].length);
+        }
+        else if (rest.startsWith('[')) {
+            const bracket = BRACKET_SEGMENT.exec(rest);
+            if (bracket?.[1] === undefined)
+                return null;
+            path.push(JSON.parse(bracket[1]));
+            rest = rest.slice(bracket[0].length);
+        }
+        else {
+            // Trailing content (e.g. ` + 1`) means this is a jq expression, not a path.
+            return null;
+        }
+    }
+    return { kind: 'field', root, path };
+}
+/** Classify one recovered value into its source (field, else JSON literal, else jq). */
+function parseValue(value) {
+    const field = parseFieldPath(value);
+    if (field !== null)
+        return field;
+    try {
+        const parsed = JSON.parse(value);
+        return { kind: 'literal', json: JSON.stringify(parsed) };
+    }
+    catch {
+        return { kind: 'jq', expr: value };
+    }
+}
+/** Find the index of the paren that closes the `(` at `open`, respecting jq strings. */
+function matchingParen(text, open) {
+    let depth = 0;
+    let inString = false;
+    for (let i = open; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString) {
+            if (ch === '\\')
+                i += 1;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === '(')
+            depth += 1;
+        else if (ch === ')') {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/** Recover the mapping rows from a stored adapter jq, or `null` if it is not the generated shape. */
+export function parseAdapter(jq) {
+    const trimmed = jq.trim();
+    if (trimmed === '{}')
+        return [];
+    if (!trimmed.startsWith('{') || !trimmed.endsWith('}'))
+        return null;
+    let inner = trimmed.slice(1, -1).trim();
+    const rows = [];
+    while (inner.length > 0) {
+        const keyMatch = ADAPTER_KEY.exec(inner);
+        if (keyMatch?.[1] === undefined)
+            return null;
+        const rawKey = keyMatch[1];
+        const target = rawKey.startsWith('"') ? JSON.parse(rawKey) : rawKey;
+        const open = keyMatch[0].length - 1;
+        const close = matchingParen(inner, open);
+        if (close === -1)
+            return null;
+        const value = inner.slice(open + 1, close).trim();
+        rows.push({ target, source: parseValue(value) });
+        inner = inner.slice(close + 1).trim();
+        if (inner.startsWith(','))
+            inner = inner.slice(1).trim();
+        else if (inner.length > 0)
+            return null;
+    }
+    return rows;
+}
+// -- The canonical single-expression form: `tjq_<callName>(<adapter object>)` --------
+//
+// When a template update rides inside ONE jq field (rather than the structured
+// `template_jq` + `adapter` pair), it is written as the call `tjq_<callName>({ … })`.
+// A jq name is `[a-z][a-z0-9_]*` (double underscores legal); a tai42 template name is a
+// SLUG (`[a-z][a-z0-9-]*` with no leading, trailing, or consecutive hyphens). So the
+// qualified call name is `enc(template) + "__" + name`, where `enc` maps each `-` to
+// `_`. BECAUSE the slug has no consecutive or trailing hyphens, `enc(template)` never
+// contains `__` and never ends in `_` — so the FIRST `__` in the call name is the
+// unambiguous template/name boundary. Resolution back to a catalog ref is therefore
+// injective, but done catalog-driven (`resolveCallName`, `catalog.ts`) rather than by
+// string splitting, since a jq name may itself contain `__` after that boundary. A jq
+// field whose expression is EXACTLY this generated call reopens as the mapping form;
+// any other expression reopens as raw jq.
+const TEMPLATE_CALL = /^tjq_([a-z][a-z0-9_]*)\(([\s\S]*)\)$/;
+/**
+ * Encode a template-name slug for a jq identifier: each `-` becomes `_`. Under the slug
+ * invariant (no consecutive or trailing hyphens) the result carries no `__` and no
+ * trailing `_`, which is what makes the first `__` in a call name the template boundary.
+ */
+export function encodeTemplateSegment(template) {
+    return template.replace(/-/g, '_');
+}
+/** The jq call-name of a catalog ref: `template.name` → `enc(template)__name`; a bare `name` unchanged. */
+function refToCallName(ref) {
+    const dot = ref.indexOf('.');
+    if (dot === -1)
+        return ref;
+    return `${encodeTemplateSegment(ref.slice(0, dot))}__${ref.slice(dot + 1)}`;
+}
+/**
+ * The single-expression form of a named template update built from a mapping form:
+ * `tjq_<enc(template)>__<name>({…})` for a qualified ref, `tjq_<name>({…})` for a bare
+ * one (see the module note on the `__` boundary invariant).
+ */
+export function generateTemplateCall(ref, rows) {
+    const compiled = compileAdapter(rows);
+    return `tjq_${refToCallName(ref)}(${compiled.ok ? compiled.jq : '{}'})`;
+}
+/**
+ * Recover `{ callName, adapter }` from a `tjq_<callName>(<adapter>)` call, or `null`
+ * otherwise. `callName` is the RAW jq identifier — NEVER split here (a jq name may carry
+ * its own `__` past the template boundary); resolve it to a catalog ref with
+ * `resolveCallName`.
+ */
+export function parseTemplateCall(expr) {
+    const match = TEMPLATE_CALL.exec(expr.trim());
+    if (match?.[1] === undefined || match[2] === undefined)
+        return null;
+    return { callName: match[1], adapter: match[2].trim() };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/state-binding/adapter.js.map

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

package/dist/state-binding/build-catalog.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Map the api-client's list shapes into the editor's catalogs, so every door screen
+ * feeds `StateBindingEditor` the same way. Pure data transforms; the api-client types
+ * are imported type-only (this package keeps no runtime edge to the client).
+ */
+import type { StateListItem, StateTemplateListItem } from '@tai42/api-client';
+import type { BindingStateOption, BindingTemplateOption, SchemaFieldPath } from './types';
+/** The template catalog (with each template's template jq) from `listStateTemplates()`. */
+export declare function templatesCatalogFromList(items: readonly StateTemplateListItem[]): BindingTemplateOption[];
+/** The states catalog from `listStates()`; per-state attachments are resolved lazily elsewhere. */
+export declare function statesCatalogFromList(states: readonly StateListItem[]): BindingStateOption[];
+/**
+ * Flatten a JSON schema's `properties` into selectable field paths (top-level and
+ * every nested object level), each labelled with its dotted path — the picker source
+ * for the adapter's `output`/`input` roots. A non-object or property-less schema
+ * yields no fields (the field control then falls back to a free path input).
+ */
+export declare function fieldPathsFromSchema(schema: unknown): SchemaFieldPath[];
+//# sourceMappingURL=build-catalog.d.ts.map

package/dist/state-binding/build-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog.d.ts","sourceRoot":"","sources":["../../src/state-binding/build-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EACV,kBAAkB,EAElB,qBAAqB,EACrB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,2FAA2F;AAC3F,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,qBAAqB,EAAE,GACtC,qBAAqB,EAAE,CAczB;AAED,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,kBAAkB,EAAE,CAE5F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,EAAE,CAcvE"}

package/dist/state-binding/build-catalog.js

@@ -0,0 +1,43 @@
+/** The template catalog (with each template's template jq) from `listStateTemplates()`. */
+export function templatesCatalogFromList(items) {
+    return items.map((item) => {
+        const templateJq = item.template_jq === null
+            ? []
+            : Object.entries(item.template_jq).map(([name, jq]) => ({
+                name,
+                purpose: jq.purpose,
+                description: jq.description,
+                params: jq.params,
+                writes: jq.writes,
+            }));
+        return { name: item.name, description: item.description, templateJq };
+    });
+}
+/** The states catalog from `listStates()`; per-state attachments are resolved lazily elsewhere. */
+export function statesCatalogFromList(states) {
+    return states.map((state) => ({ name: state.name }));
+}
+/**
+ * Flatten a JSON schema's `properties` into selectable field paths (top-level and
+ * every nested object level), each labelled with its dotted path — the picker source
+ * for the adapter's `output`/`input` roots. A non-object or property-less schema
+ * yields no fields (the field control then falls back to a free path input).
+ */
+export function fieldPathsFromSchema(schema) {
+    const out = [];
+    const walk = (node, prefix) => {
+        if (typeof node !== 'object' || node === null)
+            return;
+        const props = node.properties;
+        if (typeof props !== 'object' || props === null)
+            return;
+        for (const [key, child] of Object.entries(props)) {
+            const path = [...prefix, key];
+            out.push({ path, label: path.join('.') });
+            walk(child, path);
+        }
+    };
+    walk(schema, []);
+    return out;
+}
+//# sourceMappingURL=build-catalog.js.map

package/dist/state-binding/build-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog.js","sourceRoot":"","sources":["../../src/state-binding/build-catalog.ts"],"names":[],"mappings":"AAcA,2FAA2F;AAC3F,MAAM,UAAU,wBAAwB,CACtC,KAAuC;IAEvC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,UAAU,GACd,IAAI,CAAC,WAAW,KAAK,IAAI;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,IAAI;gBACJ,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,MAAM,EAAE,EAAE,CAAC,MAAM;aAClB,CAAC,CAAC,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,qBAAqB,CAAC,MAAgC;IACpE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,MAAyB,EAAQ,EAAE;QAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QACtD,MAAM,KAAK,GAAI,IAAiC,CAAC,UAAU,CAAC;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QACxD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/state-binding/catalog.d.ts

@@ -0,0 +1,26 @@
+import type { BindingTemplateJqOption, BindingTemplateOption } from './types';
+/** One template jq of an attached template, resolved to the reference a binding stores. */
+export interface ResolvedTemplateJq extends BindingTemplateJqOption {
+    /** The owning template. */
+    readonly template: string;
+    /** The reference a binding writes: `name`, or `template.name` when ambiguous. */
+    readonly ref: string;
+}
+/**
+ * Every template jq the given attached templates offer for a purpose (or all
+ * purposes when `purpose` is omitted), each carrying the reference a binding stores.
+ */
+export declare function resolveTemplateJq(templateNames: readonly string[], catalog: readonly BindingTemplateOption[], purpose?: 'input' | 'update'): ResolvedTemplateJq[];
+/** Find one resolved template jq by the reference a binding stores. */
+export declare function findByRef(ref: string, resolved: readonly ResolvedTemplateJq[]): ResolvedTemplateJq | undefined;
+/**
+ * Resolve a jq call name (`enc(template)__name`, or a bare `name`) back to the catalog
+ * ref, driven by the catalog — never by string splitting, since a jq name may carry its
+ * own `__` past the template boundary and `enc` maps `-`→`_`. Under the template-slug
+ * invariant (no consecutive/trailing hyphens ⇒ `enc(template)` has no `__` and no
+ * trailing `_`) the FIRST `__` is the one true boundary, so the longest encoded-template
+ * prefix whose remainder is a jq the template declares is the unique qualified match;
+ * failing that, a bare name a single template declares. `null` when nothing claims it.
+ */
+export declare function resolveCallName(callName: string, catalog: readonly BindingTemplateOption[]): string | null;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/state-binding/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/state-binding/catalog.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE9E,2FAA2F;AAC3F,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAC3B,kBAAkB,EAAE,CAsBtB;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GACtC,kBAAkB,GAAG,SAAS,CAEhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,GAAG,IAAI,CAiBf"}

package/dist/state-binding/catalog.js

@@ -0,0 +1,71 @@
+/**
+ * Pure catalog helpers — resolve the template jq an attached state offers, with the
+ * name-collision rule shared by every layer: an unqualified name that TWO attached
+ * templates declare is ambiguous, so both are offered attachment-qualified as
+ * `template.name`; a name only one template declares stays bare.
+ */
+import { encodeTemplateSegment } from './adapter';
+/**
+ * Every template jq the given attached templates offer for a purpose (or all
+ * purposes when `purpose` is omitted), each carrying the reference a binding stores.
+ */
+export function resolveTemplateJq(templateNames, catalog, purpose) {
+    const chosen = catalog.filter((template) => templateNames.includes(template.name));
+    const counts = new Map();
+    for (const template of chosen) {
+        for (const jq of template.templateJq) {
+            if (purpose !== undefined && jq.purpose !== purpose)
+                continue;
+            counts.set(jq.name, (counts.get(jq.name) ?? 0) + 1);
+        }
+    }
+    const resolved = [];
+    for (const template of chosen) {
+        for (const jq of template.templateJq) {
+            if (purpose !== undefined && jq.purpose !== purpose)
+                continue;
+            const ambiguous = (counts.get(jq.name) ?? 0) > 1;
+            resolved.push({
+                ...jq,
+                template: template.name,
+                ref: ambiguous ? `${template.name}.${jq.name}` : jq.name,
+            });
+        }
+    }
+    return resolved;
+}
+/** Find one resolved template jq by the reference a binding stores. */
+export function findByRef(ref, resolved) {
+    return resolved.find((entry) => entry.ref === ref);
+}
+/**
+ * Resolve a jq call name (`enc(template)__name`, or a bare `name`) back to the catalog
+ * ref, driven by the catalog — never by string splitting, since a jq name may carry its
+ * own `__` past the template boundary and `enc` maps `-`→`_`. Under the template-slug
+ * invariant (no consecutive/trailing hyphens ⇒ `enc(template)` has no `__` and no
+ * trailing `_`) the FIRST `__` is the one true boundary, so the longest encoded-template
+ * prefix whose remainder is a jq the template declares is the unique qualified match;
+ * failing that, a bare name a single template declares. `null` when nothing claims it.
+ */
+export function resolveCallName(callName, catalog) {
+    let bestRef = null;
+    let bestPrefixLength = -1;
+    for (const template of catalog) {
+        const prefix = `${encodeTemplateSegment(template.name)}__`;
+        if (!callName.startsWith(prefix))
+            continue;
+        const jqName = callName.slice(prefix.length);
+        if (template.templateJq.some((jq) => jq.name === jqName) && prefix.length > bestPrefixLength) {
+            bestRef = `${template.name}.${jqName}`;
+            bestPrefixLength = prefix.length;
+        }
+    }
+    if (bestRef !== null)
+        return bestRef;
+    for (const template of catalog) {
+        if (template.templateJq.some((jq) => jq.name === callName))
+            return callName;
+    }
+    return null;
+}
+//# sourceMappingURL=catalog.js.map