@tai42/studio-sdk 0.2.0

package/dist/components/confirm-dialog.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `ConfirmDialog` — a modal that asks the operator to confirm an action and then
+ * runs it. It owns the scaffolding every confirm shares: a Cancel button, the
+ * confirm button (showing a pending Spinner while the action runs and disabled
+ * meanwhile), and a loud `ErrorState` when the action fails. The caller supplies
+ * the prompt as `children` and drives the action through `onConfirm` /
+ * `isPending` / `error`.
+ *
+ * Mount it only while the confirmation is active; any close gesture — Cancel,
+ * Escape, the overlay — calls `onClose`. The confirm button is destructive
+ * (`danger`) by default; pass `confirmVariant` for a non-destructive confirm.
+ *
+ * The footer is the design system's `tai-dialog-actions` row, so every confirm
+ * across Studio lands its buttons in the same place.
+ */
+import type { ReactNode } from 'react';
+export interface ConfirmDialogProps {
+    readonly title: string;
+    /** The confirm button's resting label (e.g. `Delete scope`). */
+    readonly confirmLabel: string;
+    /** The Spinner's accessible label while the action runs (e.g. `Deleting`). */
+    readonly pendingLabel: string;
+    readonly onConfirm: () => void;
+    readonly onClose: () => void;
+    readonly isPending: boolean;
+    /**
+     * The failed action's error, rendered loudly; omit/`null` while there is none.
+     *
+     * A thrown `Error` or the message on its own — `Field`'s `error` is a plain
+     * string, and the two props sit side by side on a form, so this one accepts
+     * that spelling too rather than making one surface's `error` unassignable to
+     * the other's.
+     */
+    readonly error?: Error | string | null;
+    readonly confirmVariant?: 'primary' | 'danger';
+    /** The prompt body — what the operator is confirming. */
+    readonly children: ReactNode;
+}
+export declare function ConfirmDialog({ title, confirmLabel, pendingLabel, onConfirm, onClose, isPending, error, confirmVariant, children, }: ConfirmDialogProps): ReactNode;
+//# sourceMappingURL=confirm-dialog.d.ts.map

package/dist/components/confirm-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-dialog.d.ts","sourceRoot":"","sources":["../../src/components/confirm-dialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/C,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,OAAO,EACP,SAAS,EACT,KAAK,EACL,cAAyB,EACzB,QAAQ,GACT,EAAE,kBAAkB,GAAG,SAAS,CAsBhC"}

package/dist/components/confirm-dialog.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Dialog } from './dialog';
+import { Button, ErrorState, Spinner } from './primitives';
+import { errorMessage } from '../errors';
+export function ConfirmDialog({ title, confirmLabel, pendingLabel, onConfirm, onClose, isPending, error, confirmVariant = 'danger', children, }) {
+    return (_jsxs(Dialog, { title: title, open: true, onOpenChange: (next) => {
+            if (!next)
+                onClose();
+        }, children: [children, error != null ? _jsx(ErrorState, { message: errorMessage(error) }) : null, _jsxs("div", { className: "tai-dialog-actions", children: [_jsx(Button, { type: "button", onClick: onClose, children: "Cancel" }), _jsxs(Button, { type: "button", variant: confirmVariant, disabled: isPending, onClick: onConfirm, children: [isPending ? _jsx(Spinner, { label: pendingLabel }) : null, confirmLabel] })] })] }));
+}
+//# sourceMappingURL=confirm-dialog.js.map

package/dist/components/confirm-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-dialog.js","sourceRoot":"","sources":["../../src/components/confirm-dialog.tsx"],"names":[],"mappings":";AAiBA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAyBzC,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,OAAO,EACP,SAAS,EACT,KAAK,EACL,cAAc,GAAG,QAAQ,EACzB,QAAQ,GACW;IACnB,OAAO,CACL,MAAC,MAAM,IACL,KAAK,EAAE,KAAK,EACZ,IAAI,QACJ,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,CAAC;QACvB,CAAC,aAEA,QAAQ,EACR,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAC,UAAU,IAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAAI,CAAC,CAAC,CAAC,IAAI,EACpE,eAAK,SAAS,EAAC,oBAAoB,aACjC,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,OAAO,uBAE7B,EACT,MAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,aACnF,SAAS,CAAC,CAAC,CAAC,KAAC,OAAO,IAAC,KAAK,EAAE,YAAY,GAAI,CAAC,CAAC,CAAC,IAAI,EACnD,YAAY,IACN,IACL,IACC,CACV,CAAC;AACJ,CAAC"}

package/dist/components/control-styles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The design-system class each form control wears. The 36 px geometry, the
+ * boundary, the placeholder, and the hover/disabled/invalid states all live in
+ * `components.css` under these names — this module is the single place a
+ * control names the class, so no control re-derives that geometry inline.
+ */
+export declare const INPUT_CLASS = "tai-input";
+export declare const TEXTAREA_CLASS = "tai-textarea";
+export declare const SELECT_TRIGGER_CLASS = "tai-select-trigger";
+/** A control's class plus the caller's, which sorts last so it can override. */
+export declare function controlClassName(base: string, className: string | undefined): string;
+//# sourceMappingURL=control-styles.d.ts.map

package/dist/components/control-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-styles.d.ts","sourceRoot":"","sources":["../../src/components/control-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEpF"}

package/dist/components/control-styles.js

@@ -0,0 +1,14 @@
+/**
+ * The design-system class each form control wears. The 36 px geometry, the
+ * boundary, the placeholder, and the hover/disabled/invalid states all live in
+ * `components.css` under these names — this module is the single place a
+ * control names the class, so no control re-derives that geometry inline.
+ */
+export const INPUT_CLASS = 'tai-input';
+export const TEXTAREA_CLASS = 'tai-textarea';
+export const SELECT_TRIGGER_CLASS = 'tai-select-trigger';
+/** A control's class plus the caller's, which sorts last so it can override. */
+export function controlClassName(base, className) {
+    return className === undefined ? base : `${base} ${className}`;
+}
+//# sourceMappingURL=control-styles.js.map

package/dist/components/control-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-styles.js","sourceRoot":"","sources":["../../src/components/control-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAEzD,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAA6B;IAC1E,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC;AACjE,CAAC"}

package/dist/components/copy-field.d.ts

@@ -0,0 +1,8 @@
+export interface CopyFieldProps {
+    readonly value: string;
+    readonly caption?: string;
+    readonly idPrefix?: string;
+    readonly label?: string;
+}
+export declare function CopyField({ value, caption, idPrefix, label }: CopyFieldProps): import("react").JSX.Element;
+//# sourceMappingURL=copy-field.d.ts.map

package/dist/components/copy-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-field.d.ts","sourceRoot":"","sources":["../../src/components/copy-field.tsx"],"names":[],"mappings":"AA8BA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAyDD,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAuB,EAAE,KAAK,EAAE,EAAE,cAAc,+BAqF3F"}

package/dist/components/copy-field.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `CopyField` — a show-once box for a freshly-minted secret (an API key or a
+ * minted backup key). It renders the value in a monospace, break-all,
+ * select-all box beside a copy button that writes the value to the clipboard and
+ * shows a transient "Copied" affordance. It is PRESENTATIONAL: the caller owns
+ * the value; this component fetches nothing and never re-reads the secret.
+ *
+ * The button holds BOTH states stacked in one grid cell, so the widest of them
+ * sets the width once and the flip never reflows the row. Only the active state
+ * is exposed to assistive tech, and that state's own words are the button's
+ * accessible name: a constant `aria-label` would leave a button reading "Copied"
+ * named "Copy", which fails WCAG 2.5.3 (Label in Name) and leaves a voice-control
+ * user naming a control they cannot see. The polite live region beside the button
+ * is what actually announces the flip.
+ *
+ * A clipboard write can FAIL — a permissions policy blocks it, or the page is
+ * not in a secure context, where `navigator.clipboard` does not exist at all.
+ * Either way the value is a secret shown once, so the failure is rendered as a
+ * visible `role="alert"` telling the reader to copy it by hand: throwing it at
+ * the console would leave the button looking inert and the secret unrecoverable.
+ *
+ * SAFETY: the value and caption render as TEXT (React escapes them) — never an
+ * HTML sink. The value is never logged, and neither is a failure — the alert
+ * names the reason, never the value. Pinned by a test.
+ */
+import { useEffect, useRef, useState } from 'react';
+import { CheckIcon, CopyIcon, XCircleIcon } from './icons';
+const COPIED_RESET_MS = 2000;
+/** The button's two faces. Whichever is exposed is also its accessible name. */
+const COPY_LABEL = 'Copy';
+const COPIED_LABEL = 'Copied';
+/** Announced once, and worded so it is never mistaken for the visible label. */
+const COPIED_ANNOUNCEMENT = 'Copied to clipboard';
+/** The clipboard this browser actually offers, or `undefined` when it offers none. */
+function clipboardOf(host) {
+    return host.clipboard;
+}
+/** Shown when the browser offers no clipboard at all (any non-secure context). */
+const NO_CLIPBOARD = 'This browser will not write to the clipboard here. Select the value above and copy it.';
+/** Shown when the write is offered and refused. */
+function writeFailed(reason) {
+    const detail = reason instanceof Error ? reason.message : String(reason);
+    return `Copy failed: ${detail}. Select the value above and copy it.`;
+}
+const valueStyle = {
+    flex: 1,
+    padding: 'var(--tai-space-2) var(--tai-space-3)',
+    wordBreak: 'break-all',
+    userSelect: 'all',
+};
+/** Both states share one grid cell, so the button is as wide as the wider one. */
+const statesStyle = {
+    display: 'grid',
+    alignItems: 'center',
+    justifyItems: 'center',
+};
+const stateStyle = {
+    gridArea: '1 / 1',
+    display: 'inline-flex',
+    alignItems: 'center',
+    gap: 'var(--tai-space-2)',
+};
+export function CopyField({ value, caption, idPrefix = 'copy-field', label }) {
+    const [copied, setCopied] = useState(false);
+    const [copyError, setCopyError] = useState(undefined);
+    const resetTimer = useRef(null);
+    // The clipboard write is async, so a copy can still be in flight when the
+    // component goes away — the caller's dialog closes on the same click. Clearing
+    // the timer alone would not cover that: at unmount there is no timer yet, and
+    // the resolution that follows would start one nothing is left to clear. This
+    // flag is what the resolution checks before it touches state at all.
+    const mounted = useRef(true);
+    useEffect(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+            if (resetTimer.current !== null)
+                clearTimeout(resetTimer.current);
+        };
+    }, []);
+    const handleCopy = () => {
+        const clipboard = clipboardOf(navigator);
+        if (clipboard === undefined) {
+            setCopyError(NO_CLIPBOARD);
+            return;
+        }
+        setCopyError(undefined);
+        void clipboard.writeText(value).then(() => {
+            if (!mounted.current)
+                return;
+            setCopied(true);
+            if (resetTimer.current !== null)
+                clearTimeout(resetTimer.current);
+            resetTimer.current = setTimeout(() => {
+                setCopied(false);
+            }, COPIED_RESET_MS);
+        }, (error) => {
+            if (!mounted.current)
+                return;
+            setCopyError(writeFailed(error));
+        });
+    };
+    return (_jsxs("div", { "data-testid": idPrefix, className: "tai-stack tai-stack-2", children: [label !== undefined ? _jsx("span", { className: "tai-field-label", children: label }) : null, _jsxs("div", { className: "tai-row", children: [_jsx("code", { className: "tai-code", style: valueStyle, children: value }), _jsx("button", { type: "button", className: "tai-btn tai-btn-secondary", "data-testid": `${idPrefix}-copy`, onClick: handleCopy, children: _jsxs("span", { style: statesStyle, children: [_jsxs("span", { "aria-hidden": copied, style: { ...stateStyle, visibility: copied ? 'hidden' : 'visible' }, children: [_jsx(CopyIcon, {}), COPY_LABEL] }), _jsxs("span", { "aria-hidden": !copied, style: { ...stateStyle, visibility: copied ? 'visible' : 'hidden' }, children: [_jsx(CheckIcon, {}), COPIED_LABEL] })] }) }), _jsx("span", { "aria-live": "polite", className: "tai-visually-hidden", children: copied ? COPIED_ANNOUNCEMENT : '' })] }), copyError !== undefined ? (_jsxs("span", { role: "alert", className: "tai-field-error", children: [_jsx(XCircleIcon, {}), copyError] })) : null, caption !== undefined ? _jsx("span", { className: "tai-field-hint", children: caption }) : null] }));
+}
+//# sourceMappingURL=copy-field.js.map

package/dist/components/copy-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-field.js","sourceRoot":"","sources":["../../src/components/copy-field.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAS3D,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,gFAAgF;AAChF,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,MAAM,YAAY,GAAG,QAAQ,CAAC;AAE9B,gFAAgF;AAChF,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAYlD,sFAAsF;AACtF,SAAS,WAAW,CAAC,IAAoB;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAED,kFAAkF;AAClF,MAAM,YAAY,GAChB,wFAAwF,CAAC;AAE3F,mDAAmD;AACnD,SAAS,WAAW,CAAC,MAAe;IAClC,MAAM,MAAM,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,gBAAgB,MAAM,uCAAuC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,GAAkB;IAChC,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,uCAAuC;IAChD,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,GAAkB;IACjC,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE,QAAQ;CACvB,CAAC;AAEF,MAAM,UAAU,GAAkB;IAChC,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,QAAQ;IACpB,GAAG,EAAE,oBAAoB;CAC1B,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAG,YAAY,EAAE,KAAK,EAAkB;IAC1F,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACtE,0EAA0E;IAC1E,+EAA+E;IAC/E,8EAA8E;IAC9E,6EAA6E;IAC7E,qEAAqE;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;YACxB,IAAI,UAAU,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACpE,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,KAAK,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAClC,GAAG,EAAE;YACH,IAAI,CAAC,OAAO,CAAC,OAAO;gBAAE,OAAO;YAC7B,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,UAAU,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAClE,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACnC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC,EAAE,eAAe,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,CAAC,OAAO,CAAC,OAAO;gBAAE,OAAO;YAC7B,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CACL,8BAAkB,QAAQ,EAAE,SAAS,EAAC,uBAAuB,aAC1D,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,iBAAiB,YAAE,KAAK,GAAQ,CAAC,CAAC,CAAC,IAAI,EAC9E,eAAK,SAAS,EAAC,SAAS,aACtB,eAAM,SAAS,EAAC,UAAU,EAAC,KAAK,EAAE,UAAU,YACzC,KAAK,GACD,EACP,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,2BAA2B,iBACxB,GAAG,QAAQ,OAAO,EAC/B,OAAO,EAAE,UAAU,YAEnB,gBAAM,KAAK,EAAE,WAAW,aACtB,+BACe,MAAM,EACnB,KAAK,EAAE,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,aAEnE,KAAC,QAAQ,KAAG,EACX,UAAU,IACN,EACP,+BACe,CAAC,MAAM,EACpB,KAAK,EAAE,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,aAEnE,KAAC,SAAS,KAAG,EACZ,YAAY,IACR,IACF,GACA,EACT,4BAAgB,QAAQ,EAAC,SAAS,EAAC,qBAAqB,YACrD,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAC7B,IACH,EACL,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CACzB,gBAAM,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,iBAAiB,aAC5C,KAAC,WAAW,KAAG,EACd,SAAS,IACL,CACR,CAAC,CAAC,CAAC,IAAI,EACP,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,gBAAgB,YAAE,OAAO,GAAQ,CAAC,CAAC,CAAC,IAAI,IAC7E,CACP,CAAC;AACJ,CAAC"}

package/dist/components/dialog.d.ts

@@ -0,0 +1,21 @@
+import type { ReactElement, ReactNode } from 'react';
+export interface DialogProps {
+    readonly title: string;
+    readonly description?: string;
+    readonly children?: ReactNode;
+    /**
+     * A trigger element; when omitted, control the dialog via `open`/`onOpenChange`.
+     *
+     * It is a single ELEMENT, not any node: Radix clones its props onto it, so a
+     * string throws. The type admits a FRAGMENT — `<></>` is a `ReactElement` —
+     * which would render openers carrying neither the
+     * `aria-haspopup`/`aria-expanded`/`aria-controls` wiring nor a click handler,
+     * so {@link assertSlotElement} rejects that one at runtime.
+     */
+    readonly trigger?: ReactElement;
+    readonly open?: boolean;
+    readonly defaultOpen?: boolean;
+    readonly onOpenChange?: (open: boolean) => void;
+}
+export declare function Dialog({ title, description, children, trigger, open, defaultOpen, onOpenChange, }: DialogProps): import("react").JSX.Element;
+//# sourceMappingURL=dialog.d.ts.map

package/dist/components/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/components/dialog.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKrD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,WAAW,EACX,YAAY,GACb,EAAE,WAAW,+BA4Bb"}

package/dist/components/dialog.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `Dialog` — a design-system wrapper over Radix Dialog: an accessible modal (role
+ * `dialog`, focus trap, Escape to close) labelled by its title. Modality is
+ * enforced by the focus trap and by Radix marking the rest of the page inert, not
+ * by an `aria-modal` attribute — the panel ships none.
+ *
+ * Radix owns every modal behaviour — the focus trap, the background scroll lock,
+ * Escape, and focus return to the trigger — so this component adds no second
+ * mechanism. It contributes only the design-system surface: `tai-overlay` paints
+ * the scrim from `--tai-color-scrim`, and `tai-dialog` sizes the panel with a
+ * `min()` so it still fits a 320 px viewport. The one gap Radix leaves — focus
+ * return for a dialog that renders no trigger — is filled by
+ * `useModalFocusReturn`, which stands down whenever a trigger IS rendered.
+ */
+import * as RadixDialog from '@radix-ui/react-dialog';
+import { assertSlotElement } from '../element-slot';
+import { useModalFocusReturn } from './modal-focus';
+export function Dialog({ title, description, children, trigger, open, defaultOpen, onOpenChange, }) {
+    const focusReturn = useModalFocusReturn(trigger !== undefined);
+    if (trigger !== undefined)
+        assertSlotElement(trigger, 'Dialog `trigger`');
+    return (_jsxs(RadixDialog.Root, { open: open, defaultOpen: defaultOpen, onOpenChange: onOpenChange, children: [trigger !== undefined ? _jsx(RadixDialog.Trigger, { asChild: true, children: trigger }) : null, _jsxs(RadixDialog.Portal, { children: [_jsx(RadixDialog.Overlay, { className: "tai-overlay" }), _jsxs(RadixDialog.Content, { className: "tai-dialog", ...focusReturn, ...(description === undefined ? { 'aria-describedby': undefined } : {}), children: [_jsx(RadixDialog.Title, { className: "tai-dialog-title", children: title }), _jsxs("div", { className: "tai-stack", children: [description !== undefined ? (_jsx(RadixDialog.Description, { className: "tai-muted", children: description })) : null, children] })] })] })] }));
+}
+//# sourceMappingURL=dialog.js.map

package/dist/components/dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.js","sourceRoot":"","sources":["../../src/components/dialog.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAqBpD,MAAM,UAAU,MAAM,CAAC,EACrB,KAAK,EACL,WAAW,EACX,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,WAAW,EACX,YAAY,GACA;IACZ,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,SAAS;QAAE,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAC1E,OAAO,CACL,MAAC,WAAW,CAAC,IAAI,IAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,aAC/E,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAC,WAAW,CAAC,OAAO,IAAC,OAAO,kBAAE,OAAO,GAAuB,CAAC,CAAC,CAAC,IAAI,EAC5F,MAAC,WAAW,CAAC,MAAM,eACjB,KAAC,WAAW,CAAC,OAAO,IAAC,SAAS,EAAC,aAAa,GAAG,EAK/C,MAAC,WAAW,CAAC,OAAO,IAClB,SAAS,EAAC,YAAY,KAClB,WAAW,KACX,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAExE,KAAC,WAAW,CAAC,KAAK,IAAC,SAAS,EAAC,kBAAkB,YAAE,KAAK,GAAqB,EAC3E,eAAK,SAAS,EAAC,WAAW,aACvB,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAC3B,KAAC,WAAW,CAAC,WAAW,IAAC,SAAS,EAAC,WAAW,YAAE,WAAW,GAA2B,CACvF,CAAC,CAAC,CAAC,IAAI,EACP,QAAQ,IACL,IACc,IACH,IACJ,CACpB,CAAC;AACJ,CAAC"}

package/dist/components/drawer.d.ts

@@ -0,0 +1,22 @@
+import type { ReactElement, ReactNode } from 'react';
+export interface DrawerProps {
+    /** The dialog's accessible name. */
+    readonly title: string;
+    readonly children: ReactNode;
+    readonly side?: 'left' | 'right';
+    /**
+     * The opener. Radix labels it and returns focus to it when the drawer closes.
+     *
+     * It is a single ELEMENT, not any node: Radix clones its props onto it, so a
+     * string throws. The type admits a FRAGMENT — `<></>` is a `ReactElement` —
+     * which would render openers carrying neither the
+     * `aria-haspopup`/`aria-expanded`/`aria-controls` wiring nor a click handler,
+     * so {@link assertSlotElement} rejects that one at runtime.
+     */
+    readonly trigger?: ReactElement;
+    readonly open?: boolean;
+    readonly defaultOpen?: boolean;
+    readonly onOpenChange?: (open: boolean) => void;
+}
+export declare function Drawer({ title, children, side, trigger, open, defaultOpen, onOpenChange, }: DrawerProps): import("react").JSX.Element;
+//# sourceMappingURL=drawer.d.ts.map

package/dist/components/drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../src/components/drawer.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMrD,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,QAAQ,EACR,IAAa,EACb,OAAO,EACP,IAAI,EACJ,WAAW,EACX,YAAY,GACb,EAAE,WAAW,+BA2Bb"}

package/dist/components/drawer.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `Drawer` — a side-anchored, full-height modal panel, published for a screen
+ * that wants a modal it can anchor to an edge rather than centre. Nothing in
+ * Studio renders one today; it is SDK surface a plugin can reach for. It is the
+ * same Radix Dialog machinery `Dialog` uses, so
+ * the focus trap, the scroll lock, Escape and overlay dismissal, the inert
+ * background, and focus return to the opener all come from the primitive; only
+ * the anchoring differs, and that lives entirely in `.tai-drawer`.
+ *
+ * Pass the opener as `trigger` where there is one (as `Dialog` does): Radix's own
+ * trigger is what carries `aria-haspopup`/`aria-expanded`/`aria-controls` and
+ * what its close sequence hands focus back to. A drawer opened purely by flipping
+ * `open` renders no trigger, so `useModalFocusReturn` returns focus to the opener
+ * in that case alone — with a trigger present it stands down and Radix's own
+ * restore is the only mechanism.
+ *
+ * Open state takes either form, the same three props `Dialog` publishes:
+ * `open`/`onOpenChange` to drive it from the caller's state, `defaultOpen` (or
+ * nothing at all) to let Radix own it behind a `trigger`.
+ */
+import * as RadixDialog from '@radix-ui/react-dialog';
+import { assertSlotElement } from '../element-slot';
+import { CloseIcon } from './icons';
+import { useModalFocusReturn } from './modal-focus';
+export function Drawer({ title, children, side = 'left', trigger, open, defaultOpen, onOpenChange, }) {
+    const focusReturn = useModalFocusReturn(trigger !== undefined);
+    if (trigger !== undefined)
+        assertSlotElement(trigger, 'Drawer `trigger`');
+    return (_jsxs(RadixDialog.Root, { open: open, defaultOpen: defaultOpen, onOpenChange: onOpenChange, children: [trigger === undefined ? null : _jsx(RadixDialog.Trigger, { asChild: true, children: trigger }), _jsxs(RadixDialog.Portal, { children: [_jsx(RadixDialog.Overlay, { className: "tai-overlay" }), _jsxs(RadixDialog.Content, { className: "tai-drawer", "data-side": side, "aria-describedby": undefined, ...focusReturn, children: [_jsxs("div", { className: "tai-drawer-header", children: [_jsx(RadixDialog.Title, { className: "tai-section-title", children: title }), _jsx(RadixDialog.Close, { className: "tai-icon-btn", "aria-label": "Close", children: _jsx(CloseIcon, {}) })] }), children] })] })] }));
+}
+//# sourceMappingURL=drawer.js.map

package/dist/components/drawer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawer.js","sourceRoot":"","sources":["../../src/components/drawer.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAsBpD,MAAM,UAAU,MAAM,CAAC,EACrB,KAAK,EACL,QAAQ,EACR,IAAI,GAAG,MAAM,EACb,OAAO,EACP,IAAI,EACJ,WAAW,EACX,YAAY,GACA;IACZ,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,SAAS;QAAE,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAC1E,OAAO,CACL,MAAC,WAAW,CAAC,IAAI,IAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,aAC/E,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,WAAW,CAAC,OAAO,IAAC,OAAO,kBAAE,OAAO,GAAuB,EAC5F,MAAC,WAAW,CAAC,MAAM,eACjB,KAAC,WAAW,CAAC,OAAO,IAAC,SAAS,EAAC,aAAa,GAAG,EAG/C,MAAC,WAAW,CAAC,OAAO,IAClB,SAAS,EAAC,YAAY,eACX,IAAI,sBACG,SAAS,KACvB,WAAW,aAEf,eAAK,SAAS,EAAC,mBAAmB,aAChC,KAAC,WAAW,CAAC,KAAK,IAAC,SAAS,EAAC,mBAAmB,YAAE,KAAK,GAAqB,EAC5E,KAAC,WAAW,CAAC,KAAK,IAAC,SAAS,EAAC,cAAc,gBAAY,OAAO,YAC5D,KAAC,SAAS,KAAG,GACK,IAChB,EACL,QAAQ,IACW,IACH,IACJ,CACpB,CAAC;AACJ,CAAC"}

package/dist/components/error-boundary.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A generic render-error boundary: it contains a throw from its subtree and shows
+ * a loud `role="alert"` panel in its place, so one failing region never blanks the
+ * page around it. `label` prefixes the caught message to name the contained region
+ * (e.g. the plugin whose content threw); `onError` observes the error for logging.
+ * There is no in-place retry — the boundary resets by remounting, so callers that
+ * want a reset give it a fresh `key`.
+ *
+ * The fallback is the design system's `ErrorState`, so a contained render error
+ * looks exactly like a failed fetch: one `role="alert"` surface headed by a mark
+ * and words, never color alone. It is rendered without a retry, since the
+ * boundary resets by remounting.
+ */
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+export interface ErrorBoundaryProps {
+    readonly children: ReactNode;
+    /** Prefixed to the caught error message, naming the contained region. */
+    readonly label?: string;
+    /** Called with the caught error and React's component stack, for logging. */
+    readonly onError?: (error: unknown, info: ErrorInfo) => void;
+}
+interface ErrorBoundaryState {
+    readonly hasError: boolean;
+    readonly error: unknown;
+}
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: unknown): ErrorBoundaryState;
+    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/components/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/components/error-boundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKlE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAC9D;AAMD,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACzE,KAAK,EAAE,kBAAkB,CAAoC;IAEtE,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB;IAI1D,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAIxD,MAAM,IAAI,SAAS;CAS7B"}

package/dist/components/error-boundary.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * A generic render-error boundary: it contains a throw from its subtree and shows
+ * a loud `role="alert"` panel in its place, so one failing region never blanks the
+ * page around it. `label` prefixes the caught message to name the contained region
+ * (e.g. the plugin whose content threw); `onError` observes the error for logging.
+ * There is no in-place retry — the boundary resets by remounting, so callers that
+ * want a reset give it a fresh `key`.
+ *
+ * The fallback is the design system's `ErrorState`, so a contained render error
+ * looks exactly like a failed fetch: one `role="alert"` surface headed by a mark
+ * and words, never color alone. It is rendered without a retry, since the
+ * boundary resets by remounting.
+ */
+import { Component } from 'react';
+import { errorMessage } from '../errors';
+import { ErrorState } from './primitives';
+export class ErrorBoundary extends Component {
+    state = { hasError: false, error: null };
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, info) {
+        this.props.onError?.(error, info);
+    }
+    render() {
+        if (this.state.hasError) {
+            const { label } = this.props;
+            const text = errorMessage(this.state.error);
+            const message = label !== undefined ? `${label}: ${text}` : text;
+            return _jsx(ErrorState, { message: message });
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=error-boundary.js.map

package/dist/components/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","sourceRoot":"","sources":["../../src/components/error-boundary.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB1C,MAAM,OAAO,aAAc,SAAQ,SAAiD;IACzE,KAAK,GAAuB,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAEtE,MAAM,CAAC,wBAAwB,CAAC,KAAc;QAC5C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAEQ,iBAAiB,CAAC,KAAc,EAAE,IAAe;QACxD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAEQ,MAAM;QACb,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxB,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACjE,OAAO,KAAC,UAAU,IAAC,OAAO,EAAE,OAAO,GAAI,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/components/extension-combo-builder.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `ExtensionComboBuilder` — a controlled editor for a preset/tool's LIST OF
+ * extension combos. A combo is an ordered list of extension ELEMENTS, each a bare
+ * extension NAME or a `{ name, config }` mapping carrying author config; the value
+ * is the list of combos (`PresetExtensionElement[][]`), the SAME shape the
+ * preset/tool extensions wire carries. It is PRESENTATIONAL: the caller fetches the
+ * extension catalog (`available`) and owns the `value`; this component fetches nothing.
+ *
+ * The surface has two parts:
+ *  - the current combos, each an ordered row of name `Badge`s with a per-combo Edit
+ *    (pull it back into the draft) and Remove;
+ *  - a combo UNDER CONSTRUCTION, authored with the shared `ExtensionPicker` (grouped
+ *    by kind, single-select for the non-stackable `backend` kind). When the draft
+ *    includes the `output_schema` extension, its config is authored inline with a
+ *    `SchemaEditor` (no title required); an "Add combo" / "Update combo" action
+ *    composes the elements — `output_schema` as `{ name, config: { schema } }`, every
+ *    other extension as a bare name — and writes it into the value.
+ *
+ * The builder only blocks the client-trivial invalids: an EMPTY combo (Add is
+ * disabled until the draft has ≥1 member), a DUPLICATE of a combo already in the
+ * value (by name sequence; flagged inline, Add blocked), an INVALID `output_schema`
+ * config (the `SchemaEditor` shows the parse/lint error and Add is blocked), and an
+ * UNKNOWN extension name in an existing combo (a name absent from `available`, which
+ * happens when a plugin is removed after a preset was authored) — flagged inline on
+ * that combo row and reported through `onValidityChange` so the caller can block
+ * submit. Every deeper rule — the registry's one-per-non-stackable-kind constraint,
+ * meta-schema validity, kind/ordering — is SERVER-AUTHORITATIVE: the write route
+ * validates each combo and its 400 message is surfaced verbatim by the caller.
+ *
+ * Loading is signaled by `availableReady`: while the catalog is still loading the
+ * builder reports VALID and suppresses the unknown-name notes (no danger-note flash
+ * while submit stays enabled — the server backstops), so a stale-seeded combo does
+ * not flicker invalid before the catalog resolves.
+ *
+ * SAFETY: an extension name is server-supplied, so every name renders as TEXT through
+ * the DS `Badge`/`Checkbox` (React escapes it) — never an HTML sink.
+ *
+ * Geometry and ink come from the design-system classes: each committed combo is a
+ * `tai-card` row, the invalid notes are `tai-field-error` (icon + message, never
+ * color alone), and Remove is a labelled `Button` carrying `CloseIcon` beside the
+ * word, under an accessible name that names the combo it removes.
+ */
+import { type ReactNode } from 'react';
+import type { Extension, PresetExtensionElement } from '@tai42/api-client';
+export interface ExtensionComboBuilderProps {
+    /** The extension catalog the combos are drawn from (caller-fetched). */
+    readonly available: readonly Extension[];
+    /** The current list of combos, each an ordered list of extension elements. */
+    readonly value: readonly PresetExtensionElement[][];
+    /** Fired with the next list of combos on every add/update/remove. */
+    readonly onChange: (next: PresetExtensionElement[][]) => void;
+    readonly disabled?: boolean;
+    readonly idPrefix?: string;
+    /**
+     * Fired (effect-driven) on mount and whenever `value`, `available`, or
+     * `availableReady` changes with whether every combo's names are known. A caller
+     * blocks submit while this is `false`. The `onChange` payload shape is unchanged;
+     * this is a SECOND callback so the prop surface stays backward-compatible.
+     */
+    readonly onValidityChange?: (valid: boolean) => void;
+    /**
+     * Whether the `available` catalog has finished loading. Default `true` (existing
+     * consumers keep today's behavior). While `false` the builder reports VALID and
+     * suppresses the unknown-name notes, so a stale-seeded combo does not flash invalid
+     * before the catalog resolves.
+     */
+    readonly availableReady?: boolean;
+}
+export declare function ExtensionComboBuilder({ available, value, onChange, disabled, idPrefix, onValidityChange, availableReady, }: ExtensionComboBuilderProps): ReactNode;
+//# sourceMappingURL=extension-combo-builder.d.ts.map

package/dist/components/extension-combo-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-combo-builder.d.ts","sourceRoot":"","sources":["../../src/components/extension-combo-builder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAY3E,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,EAAE,CAAC;IACpD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,sBAAsB,EAAE,EAAE,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AA8BD,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAoC,EACpC,gBAAgB,EAChB,cAAqB,GACtB,EAAE,0BAA0B,GAAG,SAAS,CA2LxC"}