@tai42/studio-sdk 13.3.0 → 15.0.0

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * The shared state-binding editor — the ONE binding shape every door and every flow
+ * node authors. Consumed by the platform door screens, the tai42 states surface, and
+ * (in the flow engine) the node State tab. Holds no edge to jq; paints from SDK
+ * tokens only.
+ */
+export { StateBindingEditor } from './StateBindingEditor';
+export type { StateBindingEditorProps } from './StateBindingEditor';
+export { StateBindingSection } from './StateBindingSection';
+export type { StateBindingSectionProps } from './StateBindingSection';
+export { StateAttachRow } from './StateAttachRow';
+export type { StateAttachRowProps, InheritedSubject } from './StateAttachRow';
+export { InjectionList } from './InputInjectionRow';
+export type { InjectionListProps } from './InputInjectionRow';
+export { UpdateList } from './UpdateRow';
+export type { UpdateListProps } from './UpdateRow';
+export { AdapterMapping } from './AdapterMapping';
+export type { AdapterMappingProps } from './AdapterMapping';
+export { SubjectScopeFields } from './SubjectScopeFields';
+export type { SubjectScopeFieldsProps } from './SubjectScopeFields';
+export { BindingJqField, appendTjq } from './BindingJqField';
+export type { BindingJqFieldProps, TemplateJqSuggestion } from './BindingJqField';
+export { BindingTemplatedJqField } from './BindingTemplatedJqField';
+export type { BindingTemplatedJqFieldProps } from './BindingTemplatedJqField';
+export { resolveTemplateJq, findByRef, resolveCallName } from './catalog';
+export type { ResolvedTemplateJq } from './catalog';
+export { templatedTextCatalog } from './templated-text-catalog';
+export type { StoragePresenceQueryLike, TemplateNamesQueryLike } from './templated-text-catalog';
+export { templatesCatalogFromList, statesCatalogFromList, fieldPathsFromSchema, } from './build-catalog';
+export { compileAdapter, rowValueJq, fieldPathToJq, jqKey, defaultRowsForInput, parseAdapter, parseFieldPath, generateTemplateCall, parseTemplateCall, encodeTemplateSegment, } from './adapter';
+export type { MappingRow, MappingSource, FieldSource, LiteralSource, JqSource, FieldRoot, AdapterCompileResult, } from './adapter';
+export type { BindingStateOption, BindingTemplateOption, BindingTemplateJqOption, BindingSourceSchemas, SchemaFieldPath, StateBinding, StateAttach, StateInjection, StateUpdate, TemplatedText, TemplatedTextCatalog, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state-binding/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,KAAK,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/state-binding/index.js

@@ -0,0 +1,20 @@
+/**
+ * The shared state-binding editor — the ONE binding shape every door and every flow
+ * node authors. Consumed by the platform door screens, the tai42 states surface, and
+ * (in the flow engine) the node State tab. Holds no edge to jq; paints from SDK
+ * tokens only.
+ */
+export { StateBindingEditor } from './StateBindingEditor';
+export { StateBindingSection } from './StateBindingSection';
+export { StateAttachRow } from './StateAttachRow';
+export { InjectionList } from './InputInjectionRow';
+export { UpdateList } from './UpdateRow';
+export { AdapterMapping } from './AdapterMapping';
+export { SubjectScopeFields } from './SubjectScopeFields';
+export { BindingJqField, appendTjq } from './BindingJqField';
+export { BindingTemplatedJqField } from './BindingTemplatedJqField';
+export { resolveTemplateJq, findByRef, resolveCallName } from './catalog';
+export { templatedTextCatalog } from './templated-text-catalog';
+export { templatesCatalogFromList, statesCatalogFromList, fieldPathsFromSchema, } from './build-catalog';
+export { compileAdapter, rowValueJq, fieldPathToJq, jqKey, defaultRowsForInput, parseAdapter, parseFieldPath, generateTemplateCall, parseTemplateCall, encodeTemplateSegment, } from './adapter';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state-binding/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,KAAK,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { TemplatedTextCatalog } from './types';
+/** The storage-presence query result (`GET /api/storage`) fields this helper reads. */
+export interface StoragePresenceQueryLike {
+    readonly data?: {
+        readonly present: boolean;
+    };
+    readonly isPending: boolean;
+    readonly isError: boolean;
+    readonly error: unknown;
+    readonly refetch: () => unknown;
+}
+/** The stored-template-names query result (`GET /api/templates`) fields this helper reads. */
+export interface TemplateNamesQueryLike {
+    readonly data?: readonly string[];
+    readonly isPending: boolean;
+    readonly isError: boolean;
+    readonly error: unknown;
+    readonly refetch: () => unknown;
+}
+export declare function templatedTextCatalog(storage: StoragePresenceQueryLike, templates: TemplateNamesQueryLike): TemplatedTextCatalog;
+//# sourceMappingURL=templated-text-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templated-text-catalog.d.ts","sourceRoot":"","sources":["../../src/state-binding/templated-text-catalog.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,uFAAuF;AACvF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;CACjC;AAED,8FAA8F;AAC9F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;CACjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,wBAAwB,EACjC,SAAS,EAAE,sBAAsB,GAChC,oBAAoB,CA0BtB"}

package/dist/state-binding/templated-text-catalog.js

@@ -0,0 +1,48 @@
+/**
+ * Builds the {@link TemplatedTextCatalog} a door form feeds its templated-text
+ * fields, from the two queries every such form already runs: the storage-presence
+ * signal (`GET /api/storage`) and the stored-template name list (`GET /api/templates`).
+ *
+ * Storage is dead by default — a deployment with no storage backend is supported —
+ * and the template list door cannot answer without one. So the CALLER gates its
+ * template-names query on presence (`enabled: storage.data?.present === true`), and
+ * this helper maps the two query states onto the catalog the field reads: when
+ * storage is absent it exposes no templates and marks the field absent (the field
+ * then offers no stored source); when present it exposes the fetched names. A
+ * presence-fetch failure surfaces ahead of a template-fetch failure, since presence
+ * is the prerequisite.
+ *
+ * It takes the query RESULTS structurally (the fields it reads), so this module adds
+ * no data-layer dependency to the SDK.
+ */
+import { errorMessage } from '../errors';
+export function templatedTextCatalog(storage, templates) {
+    const presenceKnown = storage.data !== undefined;
+    const present = storage.data?.present === true;
+    // A presence failure matters only until presence is first known: once it is in
+    // hand, a later background-refetch failure must not blow away a field already
+    // working from it. Presence is the prerequisite of the catalog, so its failure
+    // surfaces ahead of a catalog-fetch failure.
+    const presenceFailed = storage.isError && !presenceKnown;
+    return {
+        // Never expose template names while storage is absent or unknown — the caller's
+        // gate keeps the list query from firing there, and its pending/stale data must
+        // not leak into a picker the field will not show.
+        templates: present ? (templates.data ?? []).map((id) => ({ id })) : [],
+        loading: present && templates.isPending,
+        error: presenceFailed
+            ? errorMessage(storage.error)
+            : templates.isError
+                ? errorMessage(templates.error)
+                : undefined,
+        onRetry: () => {
+            if (presenceFailed)
+                void storage.refetch();
+            else
+                void templates.refetch();
+        },
+        storageAbsent: storage.data?.present === false,
+        storagePresenceLoading: !presenceKnown && storage.isPending,
+    };
+}
+//# sourceMappingURL=templated-text-catalog.js.map

package/dist/state-binding/templated-text-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templated-text-catalog.js","sourceRoot":"","sources":["../../src/state-binding/templated-text-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAsBzC,MAAM,UAAU,oBAAoB,CAClC,OAAiC,EACjC,SAAiC;IAEjC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,+EAA+E;IAC/E,8EAA8E;IAC9E,+EAA+E;IAC/E,6CAA6C;IAC7C,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC;IACzD,OAAO;QACL,gFAAgF;QAChF,+EAA+E;QAC/E,kDAAkD;QAClD,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;QACtE,OAAO,EAAE,OAAO,IAAI,SAAS,CAAC,SAAS;QACvC,KAAK,EAAE,cAAc;YACnB,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;YAC7B,CAAC,CAAC,SAAS,CAAC,OAAO;gBACjB,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC;gBAC/B,CAAC,CAAC,SAAS;QACf,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,cAAc;gBAAE,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;;gBACtC,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC;QACD,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,KAAK,KAAK;QAC9C,sBAAsB,EAAE,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS;KAC5D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,78 @@
+/**
+ * The catalog + value types the state-binding editor is fed and edits.
+ *
+ * The VALUE is the `StateBinding` document (mirrored in `@tai42/api-client`,
+ * imported type-only so this package keeps no runtime edge to the client). The
+ * CATALOGS are what the consumer resolves from the api-client and hands the editor:
+ * the states it may bind, the templates each may attach, and — when a schema is
+ * known — the fields a picker offers.
+ */
+import type { StateBinding, StateAttach, StateInjection, StateUpdate, TemplatedText } from '@tai42/api-client';
+import type { TemplatedTextTemplateOption } from '../components/templated-text-field';
+export type { StateBinding, StateAttach, StateInjection, StateUpdate, TemplatedText };
+/**
+ * The stored templates a {@link TemplatedText} field's id picker offers, with the
+ * fetch's loading/error state — resolved by the door screen and passed to the
+ * editor, which holds no data edge of its own. Absent leaves every templated-text
+ * field with the inline source only.
+ */
+export interface TemplatedTextCatalog {
+    readonly templates?: readonly TemplatedTextTemplateOption[];
+    readonly loading?: boolean;
+    readonly error?: string;
+    readonly onRetry?: () => void;
+    /**
+     * Storage is registered absent (`GET /api/storage` → `present: false`), so the
+     * catalog was not fetched and the stored source is not offered on the fields this
+     * catalog feeds; an already-stored id is shown read-only.
+     */
+    readonly storageAbsent?: boolean;
+    /** Storage presence is not yet known — the fields render a placeholder, not a toggle. */
+    readonly storagePresenceLoading?: boolean;
+}
+/** One selectable field of a schema: the record path + a human label. */
+export interface SchemaFieldPath {
+    readonly path: readonly string[];
+    readonly label: string;
+}
+/** One template jq of an attached template, as the pickers present it. */
+export interface BindingTemplateJqOption {
+    readonly name: string;
+    readonly purpose: 'input' | 'update';
+    readonly description?: string;
+    /** An `input` jq's declared params / an `update` jq's declared input keys. */
+    readonly params?: readonly string[];
+    /** An `update` jq's declared write paths, each a list of key segments. */
+    readonly writes?: readonly (readonly string[])[];
+}
+/** One template the editor may attach to a state (attach-on-use), with its template jq. */
+export interface BindingTemplateOption {
+    readonly name: string;
+    readonly description?: string;
+    /** Whether this template is already attached to the chosen state (else: attach on save). */
+    readonly attached?: boolean;
+    readonly templateJq: readonly BindingTemplateJqOption[];
+}
+/** One state the editor may bind, with the templates already attached to it and its fields. */
+export interface BindingStateOption {
+    readonly name: string;
+    /** Templates already attached to the state (the rest attach on save). */
+    readonly attachedTemplates?: readonly string[];
+    /** The state's own record fields, for the `state` source of a field picker. */
+    readonly fields?: readonly SchemaFieldPath[];
+}
+/**
+ * The schemas a field picker draws from when authoring an injection or an adapter:
+ * the run's `output` and `input` fields (the state's fields ride each
+ * {@link BindingStateOption}). Absent roots offer no picked field — the author uses
+ * a literal or a jq expression instead.
+ */
+export interface BindingSourceSchemas {
+    readonly output?: readonly SchemaFieldPath[];
+    readonly input?: readonly SchemaFieldPath[];
+    /** The tool-schema fetch that feeds the pickers is in flight. */
+    readonly loading?: boolean;
+    /** The tool-schema fetch failed — the field control shows a note but stays usable. */
+    readonly error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state-binding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAEtF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,yFAAyF;IACzF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAClD;AAED,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACzD;AAED,+FAA+F;AAC/F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/state-binding/types.js

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "13.3.0",
+  "version": "15.0.0",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -79,7 +79,7 @@
     "@testing-library/user-event": "^14.6.6",
     "@types/node": "^22.10.5",
     "@types/react": "^19.2.18",
-    "@types/react-dom": "^19.2.5",
+    "@types/react-dom": "^19.2.7",
     "@vitejs/plugin-react": "^4.7.0",
     "@vitest/coverage-v8": "^5.0.0",
     "jsdom": "^30.0.1",
@@ -90,13 +90,13 @@
   "dependencies": {
     "@fontsource-variable/geist-mono": "^5.2.7",
     "@fontsource-variable/inter": "^5.2.8",
-    "@radix-ui/react-checkbox": "^1.3.6",
+    "@radix-ui/react-checkbox": "^1.3.11",
     "@radix-ui/react-dialog": "^1.1.18",
     "@radix-ui/react-radio-group": "^1.4.2",
     "@radix-ui/react-select": "^2.3.2",
-    "@radix-ui/react-tabs": "^1.1.16",
+    "@radix-ui/react-tabs": "^1.1.21",
     "@radix-ui/react-tooltip": "^1.2.11",
-    "@tai42/api-client": "13.3.0"
+    "@tai42/api-client": "15.0.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",

package/src/components/components.css

@@ -1953,6 +1953,25 @@
     border: 0;
   }
 
+  /* A `TemplatedTextField` renders its label as a group header above the source
+     toggle, so an inline jq editor placed under that header (`@tai42/jq-studio`'s
+     `JqField`, the direct child of this wrapper) hides its OWN visible label — the
+     header is the single visible label. The label element stays in the DOM, so its
+     `<label for>` keeps naming the control and the visual-editor door keeps its
+     accessible name; only the paint is dropped. Scoped to a direct child so a
+     mapping editor's nested field labels are untouched. */
+  .tai-templated-inline--grouped > .jqs-field > .jqs-field__label {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    margin: -1px;
+    padding: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+    border: 0;
+  }
+
   /* -- Shell -----------------------------------------------------------------------
      The application frame: a fixed-width sidebar beside a scrolling main
      column at >=1024, a 72 px labelled icon rail from 640, and a sticky top bar

package/src/components/icons.tsx

@@ -360,6 +360,14 @@ export const MinusIcon: IconComponent = (props) => (
   </Icon>
 );
 
+/** Add / insert: the dash crossed by an upright, for an append or attach affordance. */
+export const PlusIcon: IconComponent = (props) => (
+  <Icon {...props}>
+    <path d="M5.5 12h13" />
+    <path d="M12 5.5v13" />
+  </Icon>
+);
+
 /** Edit: a pencil laid across the surface it writes on. */
 export const EditIcon: IconComponent = (props) => (
   <Icon {...props}>