ionbase-ui 0.22.0 → 0.25.0

package/dist/components/AgentActivity.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+export type AgentActivityStatus = 'pending' | 'active' | 'done' | 'failed' | 'skipped';
+export interface AgentActivityProps extends React.HTMLAttributes<HTMLOListElement> {
+    children?: React.ReactNode;
+    /**
+     * Announce the step that just became active, once, in a polite live region.
+     *
+     * On by default because the whole point of an activity log is knowing what
+     * the agent is doing without watching it. Turn it off when several logs are
+     * on screen at once, or they narrate over each other.
+     */
+    announceActive?: boolean;
+}
+export interface AgentActivityStepProps extends React.LiHTMLAttributes<HTMLLIElement> {
+    /** What the agent did, in the user's language. Not a function name. */
+    children?: React.ReactNode;
+    status?: AgentActivityStatus;
+    /** The result, a tool name, a count — whatever makes the step checkable. */
+    detail?: React.ReactNode;
+}
+/**
+ * AgentActivity — what the agent is doing, in plain language.
+ *
+ * An ordered list, because the steps happened in an order and a screen reader
+ * should say "3 of 7". Not a log viewer: this is the account a person reads to
+ * decide whether to let the run continue, so the text belongs in their
+ * language — "Searched the invoice archive", not `searchIndex(q, {limit:50})`.
+ *
+ * STATUS IS NEVER CARRIED BY THE ICON ALONE. Every step renders its status as
+ * text as well as a glyph. The glyphs differ in shape rather than only in
+ * colour, so the list survives greyscale, colour blindness and forced-colours
+ * mode — WCAG 1.4.1, which a row of coloured dots fails outright.
+ *
+ * ONE POLITE ANNOUNCEMENT PER STEP, not one per render. The active step's text
+ * is announced when it changes, so a user who is not watching still knows where
+ * the run has got to. Watching the DOM instead would re-announce on every
+ * unrelated update, which is the failure mode that makes people turn logs off.
+ */
+export declare const AgentActivity: React.ForwardRefExoticComponent<AgentActivityProps & React.RefAttributes<HTMLOListElement>>;
+export declare const AgentActivityStep: React.ForwardRefExoticComponent<AgentActivityStepProps & React.RefAttributes<HTMLLIElement>>;
+//# sourceMappingURL=AgentActivity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentActivity.d.ts","sourceRoot":"","sources":["../../src/components/AgentActivity.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkD,MAAM,OAAO,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAC7B,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,kBAAmB,SAAQ,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC;IAChF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAuB,SAAQ,KAAK,CAAC,gBAAgB,CAAC,aAAa,CAAC;IACnF,uEAAuE;IACvE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAsED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,6FAyDzB,CAAC;AAIF,eAAO,MAAM,iBAAiB,8FA6B5B,CAAC"}

package/dist/components/AgentActivity.js

@@ -0,0 +1,84 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import React, { forwardRef, useEffect, useRef, useState } from 'react';
+const STATUS_TEXT = {
+    pending: 'Not started',
+    active: 'In progress',
+    done: 'Done',
+    failed: 'Failed',
+    skipped: 'Skipped',
+};
+const Glyphs = {
+    pending: () => (_jsx("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", focusable: "false", children: _jsx("circle", { cx: "12", cy: "12", r: "9", stroke: "currentColor", strokeWidth: "2" }) })),
+    active: () => (_jsxs("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", focusable: "false", children: [_jsx("circle", { cx: "12", cy: "12", r: "9", stroke: "currentColor", strokeWidth: "2", opacity: "0.3" }), _jsx("path", { d: "M21 12a9 9 0 0 0-9-9", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" })] })),
+    done: () => (_jsxs("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", focusable: "false", children: [_jsx("circle", { cx: "12", cy: "12", r: "9", stroke: "currentColor", strokeWidth: "2" }), _jsx("path", { d: "m8.5 12 2.5 2.5 4.5-5", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round" })] })),
+    failed: () => (_jsxs("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", focusable: "false", children: [_jsx("circle", { cx: "12", cy: "12", r: "9", stroke: "currentColor", strokeWidth: "2" }), _jsx("path", { d: "m9 9 6 6M15 9l-6 6", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" })] })),
+    skipped: () => (_jsxs("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", focusable: "false", children: [_jsx("circle", { cx: "12", cy: "12", r: "9", stroke: "currentColor", strokeWidth: "2" }), _jsx("path", { d: "M8.5 12h7", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" })] })),
+};
+/**
+ * AgentActivity — what the agent is doing, in plain language.
+ *
+ * An ordered list, because the steps happened in an order and a screen reader
+ * should say "3 of 7". Not a log viewer: this is the account a person reads to
+ * decide whether to let the run continue, so the text belongs in their
+ * language — "Searched the invoice archive", not `searchIndex(q, {limit:50})`.
+ *
+ * STATUS IS NEVER CARRIED BY THE ICON ALONE. Every step renders its status as
+ * text as well as a glyph. The glyphs differ in shape rather than only in
+ * colour, so the list survives greyscale, colour blindness and forced-colours
+ * mode — WCAG 1.4.1, which a row of coloured dots fails outright.
+ *
+ * ONE POLITE ANNOUNCEMENT PER STEP, not one per render. The active step's text
+ * is announced when it changes, so a user who is not watching still knows where
+ * the run has got to. Watching the DOM instead would re-announce on every
+ * unrelated update, which is the failure mode that makes people turn logs off.
+ */
+export const AgentActivity = forwardRef(({ children, announceActive = true, className, ...rest }, ref) => {
+    /*
+     * Read the active step out of the children rather than asking the caller to
+     * repeat it in a prop. Two sources for one fact is how they disagree.
+     */
+    const activeLabel = React.Children.toArray(children).reduce((found, child) => {
+        if (found)
+            return found;
+        if (!React.isValidElement(child))
+            return found;
+        if (child.props.status !== 'active')
+            return found;
+        return typeof child.props.children === 'string'
+            ? child.props.children
+            : 'In progress';
+    }, '');
+    const [announcement, setAnnouncement] = useState('');
+    /*
+     * Seeded with '' rather than the current label, so the FIRST active step is
+     * announced too. Seeding it with `activeLabel` reads as "only announce
+     * changes" and silently swallows the one announcement that matters most —
+     * the log usually mounts at the moment the run starts, and that first step
+     * is exactly what a user who is not watching needs to hear.
+     */
+    const previous = useRef('');
+    useEffect(() => {
+        if (!announceActive)
+            return;
+        if (activeLabel && activeLabel !== previous.current)
+            setAnnouncement(activeLabel);
+        previous.current = activeLabel;
+    }, [activeLabel, announceActive]);
+    return (_jsxs(_Fragment, { children: [_jsx("ol", { ...rest, ref: ref, className: ['ion-agent-activity', className]
+                    .filter(Boolean)
+                    .join(' '), children: children }), announceActive && (_jsx("span", { className: "ion-visually-hidden", role: "status", "aria-live": "polite", children: announcement }))] }));
+});
+AgentActivity.displayName = 'AgentActivity';
+export const AgentActivityStep = forwardRef(({ children, status = 'pending', detail, className, ...rest }, ref) => {
+    const Glyph = Glyphs[status];
+    return (_jsxs("li", { ...rest, ref: ref, "data-status": status, className: [
+            'ion-agent-activity__step',
+            `ion-agent-activity__step--${status}`,
+            className || '',
+        ]
+            .filter(Boolean)
+            .join(' '), children: [_jsx("span", { className: "ion-agent-activity__glyph", "aria-hidden": "true", children: _jsx(Glyph, {}) }), _jsxs("span", { className: "ion-agent-activity__body", children: [_jsx("span", { className: "ion-agent-activity__label", children: children }), detail && _jsx("span", { className: "ion-agent-activity__detail", children: detail })] }), _jsx("span", { className: "ion-visually-hidden", children: STATUS_TEXT[status] })] }));
+});
+AgentActivityStep.displayName = 'AgentActivityStep';
+//# sourceMappingURL=AgentActivity.js.map

package/dist/components/AgentActivity.js.map

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

package/dist/components/AgentStop.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+export type AgentStopSize = 'sm' | 'md' | 'lg';
+export interface AgentStopProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'type' | 'children'> {
+    /** Called when the user asks the run to stop. */
+    onStop: () => void;
+    /**
+     * The request is in flight. The control stays visible and keeps its place;
+     * it does not disappear while the thing it cancels is still running.
+     */
+    isStopping?: boolean;
+    /** Visible label. */
+    label?: string;
+    /** Visible label once `isStopping` is set. */
+    stoppingLabel?: string;
+    size?: AgentStopSize;
+    /**
+     * Bind Escape, at the document, to stop the run.
+     *
+     * Off by default and deliberately so: Escape already means "dismiss the
+     * thing in front of me" to every modal, popover and menu in this system, and
+     * a document-level handler would cancel a background run when the user meant
+     * to close a dialog. Turn it on only where the run IS the foreground task.
+     */
+    stopOnEscape?: boolean;
+}
+/**
+ * AgentStop — the always-visible way to end a run.
+ *
+ * NOT OPTIONAL, AND NOT BEHIND A MENU. A user who cannot stop an agent is
+ * watching it, not supervising it. Human oversight of an automated process is
+ * a compliance surface in regulated contexts, not a UX preference, and the
+ * control that provides it has to be present and reachable at the moment it is
+ * wanted — not two clicks into an overflow menu.
+ *
+ * WHY IT IS NOT JUST `<Button variant="destructive">`
+ *
+ * Three things it owns that a Button does not:
+ *
+ *   It keeps its place while stopping. A control that vanishes the instant it
+ *   is pressed leaves the user unsure whether the press registered, and the
+ *   run is usually still going. It stays, relabels, and disables — the layout
+ *   does not move.
+ *
+ *   It announces. The label change is only announced to a screen reader if the
+ *   button happens to hold focus, which it usually does not when a run was
+ *   started elsewhere. A polite live region says "Stopping" once.
+ *
+ *   It is not destructive-red. Stopping is a normal, expected, reversible-in-
+ *   spirit action — you can run it again. Colouring it like `delete` teaches
+ *   hesitation about the one control that must never be hesitated over.
+ *
+ * WHAT IT DOES NOT DO. It does not stop anything. It reports intent; the
+ * caller aborts the request, closes the stream and settles the state. A stop
+ * button that resolves optimistically while tokens keep arriving is worse than
+ * none, because it lies about a guarantee the user is relying on.
+ */
+export declare const AgentStop: React.ForwardRefExoticComponent<AgentStopProps & React.RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=AgentStop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStop.d.ts","sourceRoot":"","sources":["../../src/components/AgentStop.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkD,MAAM,OAAO,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C,MAAM,WAAW,cAAe,SAAQ,IAAI,CAC1C,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,MAAM,GAAG,UAAU,CACpB;IACC,iDAAiD;IACjD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,SAAS,0FAiFrB,CAAC"}

package/dist/components/AgentStop.js

@@ -0,0 +1,82 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { forwardRef, useEffect, useRef, useState } from 'react';
+/** A square, not a glyph with meaning to learn. Universal stop. */
+const StopGlyph = () => (_jsx("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", focusable: "false", children: _jsx("rect", { x: "6", y: "6", width: "12", height: "12", rx: "1.5", fill: "currentColor", stroke: "none" }) }));
+/**
+ * AgentStop — the always-visible way to end a run.
+ *
+ * NOT OPTIONAL, AND NOT BEHIND A MENU. A user who cannot stop an agent is
+ * watching it, not supervising it. Human oversight of an automated process is
+ * a compliance surface in regulated contexts, not a UX preference, and the
+ * control that provides it has to be present and reachable at the moment it is
+ * wanted — not two clicks into an overflow menu.
+ *
+ * WHY IT IS NOT JUST `<Button variant="destructive">`
+ *
+ * Three things it owns that a Button does not:
+ *
+ *   It keeps its place while stopping. A control that vanishes the instant it
+ *   is pressed leaves the user unsure whether the press registered, and the
+ *   run is usually still going. It stays, relabels, and disables — the layout
+ *   does not move.
+ *
+ *   It announces. The label change is only announced to a screen reader if the
+ *   button happens to hold focus, which it usually does not when a run was
+ *   started elsewhere. A polite live region says "Stopping" once.
+ *
+ *   It is not destructive-red. Stopping is a normal, expected, reversible-in-
+ *   spirit action — you can run it again. Colouring it like `delete` teaches
+ *   hesitation about the one control that must never be hesitated over.
+ *
+ * WHAT IT DOES NOT DO. It does not stop anything. It reports intent; the
+ * caller aborts the request, closes the stream and settles the state. A stop
+ * button that resolves optimistically while tokens keep arriving is worse than
+ * none, because it lies about a guarantee the user is relying on.
+ */
+export const AgentStop = forwardRef(({ onStop, isStopping = false, label = 'Stop', stoppingLabel = 'Stopping…', size = 'md', stopOnEscape = false, className, ...rest }, ref) => {
+    /*
+     * Announce the transition, not the state. A live region that always holds
+     * "Stopping…" is re-read on unrelated updates in some screen readers;
+     * writing it once on the edge, and clearing it after, says it exactly once.
+     */
+    const [announcement, setAnnouncement] = useState('');
+    const wasStopping = useRef(isStopping);
+    useEffect(() => {
+        if (isStopping && !wasStopping.current)
+            setAnnouncement(stoppingLabel);
+        if (!isStopping && wasStopping.current)
+            setAnnouncement('');
+        wasStopping.current = isStopping;
+    }, [isStopping, stoppingLabel]);
+    const stopRef = useRef(onStop);
+    stopRef.current = onStop;
+    useEffect(() => {
+        if (!stopOnEscape || isStopping)
+            return;
+        const onKeyDown = (event) => {
+            if (event.key !== 'Escape')
+                return;
+            // An overlay that is open owns Escape. Do not cancel a run because the
+            // user tried to close a dialog on top of it.
+            if (event.target?.closest?.('[role="dialog"]'))
+                return;
+            stopRef.current();
+        };
+        document.addEventListener('keydown', onKeyDown);
+        return () => document.removeEventListener('keydown', onKeyDown);
+    }, [stopOnEscape, isStopping]);
+    return (_jsxs(_Fragment, { children: [_jsxs("button", { ...rest, ref: ref, type: "button", disabled: isStopping, "data-stopping": isStopping || undefined, onClick: (event) => {
+                    rest.onClick?.(event);
+                    if (!event.defaultPrevented)
+                        onStop();
+                }, className: [
+                    'ion-agent-stop',
+                    size !== 'md' ? `ion-agent-stop--${size}` : '',
+                    className || '',
+                ]
+                    .filter(Boolean)
+                    .join(' '), children: [_jsx("span", { className: "ion-agent-stop__glyph", children: _jsx(StopGlyph, {}) }), _jsx("span", { className: "ion-agent-stop__label", children: isStopping ? stoppingLabel : label })] }), _jsx("span", { className: "ion-agent-stop__status ion-visually-hidden", role: "status", "aria-live": "polite", children: announcement })] }));
+});
+AgentStop.displayName = 'AgentStop';
+//# sourceMappingURL=AgentStop.js.map

package/dist/components/AgentStop.js.map

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

package/dist/components/ApprovalGate.d.ts

@@ -0,0 +1,72 @@
+import React from 'react';
+export type ApprovalGateRisk = 'low' | 'medium' | 'high';
+export type ApprovalGateStatus = 'pending' | 'approved' | 'rejected' | 'expired';
+export interface ApprovalGateProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title' | 'onChange'> {
+    /**
+     * What is being approved, stated as the action and its object — "Delete 14
+     * projects", not "Confirm action". Required: it is the region's accessible
+     * name, and a decision the user cannot name is not a decision.
+     */
+    title: React.ReactNode;
+    /** Why it stopped here, and what happens on approval. */
+    children?: React.ReactNode;
+    /**
+     * How much is at stake. Drives emphasis only — it does NOT change what the
+     * component enforces, because the component enforces nothing.
+     */
+    risk?: ApprovalGateRisk;
+    /** Where the decision has got to. `pending` is the only state with buttons. */
+    status?: ApprovalGateStatus;
+    onApprove?: () => void;
+    onReject?: () => void;
+    /**
+     * Offer "edit" as a third way out. Omit it when the proposal cannot be
+     * amended — an approve/reject pair the user cannot influence is honest;
+     * an edit button that discards their edit is not.
+     */
+    onEdit?: () => void;
+    approveLabel?: string;
+    rejectLabel?: string;
+    editLabel?: string;
+    /** A decision is in flight. Both actions disable; neither disappears. */
+    isSubmitting?: boolean;
+    /** Shown in place of the actions once the decision is made. */
+    resolution?: React.ReactNode;
+}
+/**
+ * ApprovalGate — a proposed action, held until a person decides.
+ *
+ * The human-in-the-loop control. An agent proposes; this is where a person
+ * approves, rejects, or amends before anything happens. In regulated contexts
+ * demonstrable human oversight is a compliance surface rather than a nicety,
+ * which is why this is a first-class component and not a Modal with two
+ * buttons in it.
+ *
+ * IT ENFORCES NOTHING, AND SAYING SO IS THE POINT
+ *
+ * This renders a decision. It does not gate execution — the caller does, by not
+ * acting until `onApprove` fires. A component that *looked* like it enforced a
+ * policy would be the worst possible thing to ship here: teams would rely on a
+ * guarantee that lives entirely in their own call site. `risk` changes emphasis
+ * and nothing else, for the same reason.
+ *
+ * NOT A MODAL, DELIBERATELY
+ *
+ * A modal steals focus and hides the page. But the page is the evidence: the
+ * user needs the plan, the diff, the tool call and the context in front of them
+ * while deciding. This sits inline, keeps everything visible, and never
+ * traps focus — an approval a user was rushed through is not oversight.
+ *
+ * NEITHER BUTTON IS FOCUSED ON MOUNT. Autofocusing approve turns a decision
+ * into an Enter keypress on a page the user has not read. Focus is moved to the
+ * region's heading instead, so a screen-reader user lands on what is being
+ * asked rather than on the answer.
+ *
+ * THE RESOLVED STATES ARE NOT DECORATION. `approved`, `rejected` and `expired`
+ * replace the actions with what happened, so the record of the decision stays
+ * on the page. `expired` exists because an approval request that nobody answers
+ * is the common real outcome, and a gate that sits pending for ever is
+ * indistinguishable from one that is broken.
+ */
+export declare const ApprovalGate: React.ForwardRefExoticComponent<ApprovalGateProps & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=ApprovalGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovalGate.d.ts","sourceRoot":"","sources":["../../src/components/ApprovalGate.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyD,MAAM,OAAO,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACzD,MAAM,MAAM,kBAAkB,GAC5B,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EACjC,OAAO,GAAG,UAAU,CACrB;IACC;;;;OAIG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,YAAY,uFA4HxB,CAAC"}

package/dist/components/ApprovalGate.js

@@ -0,0 +1,68 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useEffect, useId, useRef, useState } from 'react';
+const ShieldQuestion = () => (_jsxs("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", focusable: "false", children: [_jsx("path", { d: "M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10Z", stroke: "currentColor", strokeWidth: "2", strokeLinejoin: "round" }), _jsx("path", { d: "M9.5 9a2.5 2.5 0 1 1 3.5 2.3c-.6.3-1 .9-1 1.7M12 16h.01", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" })] }));
+const STATUS_TEXT = {
+    approved: 'Approved',
+    rejected: 'Rejected',
+    expired: 'Expired without a decision',
+};
+/**
+ * ApprovalGate — a proposed action, held until a person decides.
+ *
+ * The human-in-the-loop control. An agent proposes; this is where a person
+ * approves, rejects, or amends before anything happens. In regulated contexts
+ * demonstrable human oversight is a compliance surface rather than a nicety,
+ * which is why this is a first-class component and not a Modal with two
+ * buttons in it.
+ *
+ * IT ENFORCES NOTHING, AND SAYING SO IS THE POINT
+ *
+ * This renders a decision. It does not gate execution — the caller does, by not
+ * acting until `onApprove` fires. A component that *looked* like it enforced a
+ * policy would be the worst possible thing to ship here: teams would rely on a
+ * guarantee that lives entirely in their own call site. `risk` changes emphasis
+ * and nothing else, for the same reason.
+ *
+ * NOT A MODAL, DELIBERATELY
+ *
+ * A modal steals focus and hides the page. But the page is the evidence: the
+ * user needs the plan, the diff, the tool call and the context in front of them
+ * while deciding. This sits inline, keeps everything visible, and never
+ * traps focus — an approval a user was rushed through is not oversight.
+ *
+ * NEITHER BUTTON IS FOCUSED ON MOUNT. Autofocusing approve turns a decision
+ * into an Enter keypress on a page the user has not read. Focus is moved to the
+ * region's heading instead, so a screen-reader user lands on what is being
+ * asked rather than on the answer.
+ *
+ * THE RESOLVED STATES ARE NOT DECORATION. `approved`, `rejected` and `expired`
+ * replace the actions with what happened, so the record of the decision stays
+ * on the page. `expired` exists because an approval request that nobody answers
+ * is the common real outcome, and a gate that sits pending for ever is
+ * indistinguishable from one that is broken.
+ */
+export const ApprovalGate = forwardRef(({ title, children, risk = 'medium', status = 'pending', onApprove, onReject, onEdit, approveLabel = 'Approve', rejectLabel = 'Reject', editLabel = 'Edit', isSubmitting = false, resolution, className, ...rest }, ref) => {
+    const headingRef = useRef(null);
+    // A <section> is only a landmark once it has a name, and the name a
+    // reviewer needs is the decision itself.
+    const titleId = useId();
+    const [announcement, setAnnouncement] = useState('');
+    const previous = useRef(status);
+    useEffect(() => {
+        if (status !== previous.current && status !== 'pending')
+            setAnnouncement(STATUS_TEXT[status]);
+        previous.current = status;
+    }, [status]);
+    const pending = status === 'pending';
+    return (_jsxs("section", { ...rest, ref: ref, "aria-labelledby": titleId, "data-risk": risk, "data-status": status, className: [
+            'ion-approval-gate',
+            `ion-approval-gate--${risk}`,
+            !pending ? `ion-approval-gate--${status}` : '',
+            className || '',
+        ]
+            .filter(Boolean)
+            .join(' '), children: [_jsx("span", { className: "ion-approval-gate__icon", "aria-hidden": "true", children: _jsx(ShieldQuestion, {}) }), _jsxs("div", { className: "ion-approval-gate__body", children: [_jsx("p", { ref: headingRef, id: titleId, tabIndex: -1, className: "ion-approval-gate__title", children: title }), children && (_jsx("div", { className: "ion-approval-gate__detail", children: children })), pending ? (_jsxs("div", { className: "ion-approval-gate__actions", children: [_jsx("button", { type: "button", className: "ion-approval-gate__action ion-approval-gate__action--reject", disabled: isSubmitting || !onReject, onClick: onReject, children: rejectLabel }), onEdit && (_jsx("button", { type: "button", className: "ion-approval-gate__action ion-approval-gate__action--edit", disabled: isSubmitting, onClick: onEdit, children: editLabel })), _jsx("button", { type: "button", className: "ion-approval-gate__action ion-approval-gate__action--approve", disabled: isSubmitting || !onApprove, onClick: onApprove, children: approveLabel })] })) : (_jsx("p", { className: "ion-approval-gate__resolution", children: resolution ?? STATUS_TEXT[status] }))] }), _jsx("span", { className: "ion-approval-gate__status ion-visually-hidden", role: "status", "aria-live": "polite", children: announcement })] }));
+});
+ApprovalGate.displayName = 'ApprovalGate';
+//# sourceMappingURL=ApprovalGate.js.map

package/dist/components/ApprovalGate.js.map

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

package/dist/components/Citation.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+export interface CitationProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> {
+    /** The marker shown inline — usually a number matching the footer list. */
+    index: number | string;
+    /**
+     * What is being cited. Required: it is the link's accessible name, and a
+     * citation a reader cannot identify without following it is not attribution.
+     */
+    source: string;
+    /** Where it goes. Omit for a source with no address — a document, a call. */
+    href?: string;
+}
+export interface CitationListProps extends React.OlHTMLAttributes<HTMLOListElement> {
+    children?: React.ReactNode;
+    /** Heading above the list. Rendered as plain text, not a heading element. */
+    label?: React.ReactNode;
+}
+export interface CitationListItemProps extends React.LiHTMLAttributes<HTMLLIElement> {
+    index: number | string;
+    source: string;
+    href?: string;
+    /** The quoted or summarised passage this citation supports. */
+    children?: React.ReactNode;
+}
+/**
+ * Citation — the inline marker.
+ *
+ * THE MARKER IS NOT THE NAME. Rendered naively, a superscript "1" announces as
+ * "link, 1", which tells a screen-reader user nothing about whether to follow
+ * it. The visible marker stays a number; the accessible name is
+ * "Source 1: <source>". The number is for the sighted reader's eye and the
+ * sentence is for everyone.
+ *
+ * NOT A TOOLTIP. A tooltip cannot be reached on touch and closes on the way to
+ * it; attribution has to survive both. It is a real link, or a real
+ * non-interactive marker when there is nowhere to go.
+ *
+ * WITHOUT `href` IT IS NOT A LINK. A citation to a phone call or an internal
+ * document has no address, and rendering a dead anchor for it puts an
+ * unfollowable link in the page's link list. It becomes a plain marked-up
+ * reference instead.
+ */
+export declare const Citation: React.ForwardRefExoticComponent<CitationProps & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * The footer list. An `<ol>` so the numbering is structural rather than typed
+ * into each row, and so a screen reader can say how many sources there are
+ * before the reader commits to hearing them.
+ */
+export declare const CitationList: React.ForwardRefExoticComponent<CitationListProps & React.RefAttributes<HTMLOListElement>>;
+export declare const CitationListItem: React.ForwardRefExoticComponent<CitationListItemProps & React.RefAttributes<HTMLLIElement>>;
+//# sourceMappingURL=Citation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Citation.d.ts","sourceRoot":"","sources":["../../src/components/Citation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,MAAM,WAAW,aAAc,SAAQ,IAAI,CACzC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,UAAU,CACX;IACC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,KAAK,CAAC,gBAAgB,CAAC,gBAAgB,CAAC;IACjF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,gBAAgB,CAAC,aAAa,CAAC;IAClF,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,QAAQ,yFAmBpB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,YAAY,4FAexB,CAAC;AAIF,eAAO,MAAM,gBAAgB,6FAyB3B,CAAC"}

package/dist/components/Citation.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+/**
+ * Citation — the inline marker.
+ *
+ * THE MARKER IS NOT THE NAME. Rendered naively, a superscript "1" announces as
+ * "link, 1", which tells a screen-reader user nothing about whether to follow
+ * it. The visible marker stays a number; the accessible name is
+ * "Source 1: <source>". The number is for the sighted reader's eye and the
+ * sentence is for everyone.
+ *
+ * NOT A TOOLTIP. A tooltip cannot be reached on touch and closes on the way to
+ * it; attribution has to survive both. It is a real link, or a real
+ * non-interactive marker when there is nowhere to go.
+ *
+ * WITHOUT `href` IT IS NOT A LINK. A citation to a phone call or an internal
+ * document has no address, and rendering a dead anchor for it puts an
+ * unfollowable link in the page's link list. It becomes a plain marked-up
+ * reference instead.
+ */
+export const Citation = forwardRef(({ index, source, href, className, ...rest }, ref) => {
+    const name = `Source ${index}: ${source}`;
+    const classes = ['ion-citation', className].filter(Boolean).join(' ');
+    if (!href) {
+        return (_jsx("span", { className: classes, role: "note", "aria-label": name, children: _jsx("span", { "aria-hidden": "true", children: index }) }));
+    }
+    return (_jsx("a", { ...rest, ref: ref, href: href, className: classes, "aria-label": name, children: _jsx("span", { "aria-hidden": "true", children: index }) }));
+});
+Citation.displayName = 'Citation';
+/**
+ * The footer list. An `<ol>` so the numbering is structural rather than typed
+ * into each row, and so a screen reader can say how many sources there are
+ * before the reader commits to hearing them.
+ */
+export const CitationList = forwardRef(({ children, label = 'Sources', className, ...rest }, ref) => (_jsxs("div", { className: "ion-citation-list", children: [label && _jsx("p", { className: "ion-citation-list__label", children: label }), _jsx("ol", { ...rest, ref: ref, className: ['ion-citation-list__items', className]
+                .filter(Boolean)
+                .join(' '), children: children })] })));
+CitationList.displayName = 'CitationList';
+export const CitationListItem = forwardRef(({ index, source, href, children, className, ...rest }, ref) => (_jsxs("li", { ...rest, ref: ref, className: ['ion-citation-list__item', className].filter(Boolean).join(' '), children: [_jsx("span", { className: "ion-citation-list__marker", "aria-hidden": "true", children: index }), _jsxs("span", { className: "ion-citation-list__body", children: [href ? (_jsx("a", { className: "ion-citation-list__source", href: href, children: source })) : (_jsx("span", { className: "ion-citation-list__source", children: source })), children && (_jsx("span", { className: "ion-citation-list__passage", children: children }))] })] })));
+CitationListItem.displayName = 'CitationListItem';
+//# sourceMappingURL=Citation.js.map

package/dist/components/Citation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Citation.js","sourceRoot":"","sources":["../../src/components/Citation.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA+B1C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAChC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE;IACnD,MAAM,IAAI,GAAG,UAAU,KAAK,KAAK,MAAM,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEtE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CACL,eAAM,SAAS,EAAE,OAAO,EAAE,IAAI,EAAC,MAAM,gBAAa,IAAI,YACpD,8BAAkB,MAAM,YAAE,KAAK,GAAQ,GAClC,CACR,CAAC;IACJ,CAAC;IAED,OAAO,CACL,eAAO,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,gBAAc,IAAI,YACrE,8BAAkB,MAAM,YAAE,KAAK,GAAQ,GACrC,CACL,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,QAAQ,CAAC,WAAW,GAAG,UAAU,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CACpC,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAC5D,eAAK,SAAS,EAAC,mBAAmB,aAC/B,KAAK,IAAI,YAAG,SAAS,EAAC,0BAA0B,YAAE,KAAK,GAAK,EAC7D,gBACM,IAAI,EACR,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,CAAC,0BAA0B,EAAE,SAAS,CAAC;iBAC/C,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC,YAEX,QAAQ,GACN,IACD,CACP,CACF,CAAC;AAEF,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAGxC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAChE,iBACM,IAAI,EACR,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,aAE3E,eAAM,SAAS,EAAC,2BAA2B,iBAAa,MAAM,YAC3D,KAAK,GACD,EACP,gBAAM,SAAS,EAAC,yBAAyB,aACtC,IAAI,CAAC,CAAC,CAAC,CACN,YAAG,SAAS,EAAC,2BAA2B,EAAC,IAAI,EAAE,IAAI,YAChD,MAAM,GACL,CACL,CAAC,CAAC,CAAC,CACF,eAAM,SAAS,EAAC,2BAA2B,YAAE,MAAM,GAAQ,CAC5D,EACA,QAAQ,IAAI,CACX,eAAM,SAAS,EAAC,4BAA4B,YAAE,QAAQ,GAAQ,CAC/D,IACI,IACJ,CACN,CAAC,CAAC;AAEH,gBAAgB,CAAC,WAAW,GAAG,kBAAkB,CAAC"}

package/dist/components/ConfidenceIndicator.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+export type ConfidenceLevel = 'low' | 'medium' | 'high';
+export interface ConfidenceIndicatorProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'> {
+    level: ConfidenceLevel;
+    /**
+     * What the level is based on. REQUIRED, and the reason this component exists
+     * rather than a coloured dot: a confidence with no stated basis is a number
+     * the reader has no way to weigh. "3 of 4 sources agree", "no matching
+     * records found", "single unverified source".
+     */
+    basis: string;
+    /** Override the level's word. Keep it a word, not a percentage. */
+    label?: string;
+}
+/**
+ * ConfidenceIndicator — how much to trust the thing next to it.
+ *
+ * THERE IS NO PERCENTAGE PROP, AND THERE WILL NOT BE ONE
+ *
+ * "87% confident" reads as a measurement. Almost nowhere is it one: it is
+ * usually a softmax score, a heuristic, or a number a model produced about
+ * itself — none of which are calibrated probabilities, and all of which invite
+ * a reader to treat two digits of precision as real. Three levels cannot
+ * overclaim in that way.
+ *
+ * `basis` IS REQUIRED FOR THE SAME REASON. A level with nothing behind it is
+ * decoration that changes behaviour: people act on "high confidence" whether or
+ * not anything justifies it. Making the justification a required prop is the
+ * only enforcement available here, and it is a type error rather than a policy
+ * — which is the strongest kind this system can offer.
+ *
+ * It renders as text plus a three-bar meter, never the meter alone. The bars
+ * differ in filled COUNT, not only in colour, so the reading survives greyscale
+ * and forced-colours mode.
+ */
+export declare const ConfidenceIndicator: React.ForwardRefExoticComponent<ConfidenceIndicatorProps & React.RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=ConfidenceIndicator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfidenceIndicator.d.ts","sourceRoot":"","sources":["../../src/components/ConfidenceIndicator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAE1C,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CACpD,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EACrC,UAAU,CACX;IACC,KAAK,EAAE,eAAe,CAAC;IACvB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,mBAAmB,kGAiC9B,CAAC"}