@artooi/agents-web-components 0.0.0-stage → 0.1.0

package/dist/ui/interrupts/approval_card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval_card.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/approval_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtE,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAYD,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CA4DlB"}

package/dist/ui/interrupts/approval_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const APPROVAL_STYLES: string;
+//# sourceMappingURL=approval_styles.d.ts.map

package/dist/ui/interrupts/approval_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/approval_styles.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,EAAE,MAkD7B,CAAC"}

package/dist/ui/interrupts/confirmation_card.d.ts

@@ -0,0 +1,51 @@
+import { type UiStrings } from "../ui_strings.js";
+/** What the inline confirmation card displays. */
+export interface ConfirmationRequest {
+    toolName: string;
+    args: Record<string, unknown>;
+    /**
+     * Human-readable prompt (from the tool's `x-confirm` metadata), e.g.
+     * "Activate this project?". Falls back to the generic `confirmRun` template.
+     */
+    message?: string;
+}
+/** Options for {@link requestConfirmation}. */
+export interface ConfirmationOptions {
+    /**
+     * Aborting this signal resolves the card as declined, with buttons disabled
+     * and `data-resolved="declined"` — how a Stop control dismisses a pending
+     * confirmation.
+     */
+    signal?: AbortSignal;
+    /** Localized strings; defaults to the English {@link DEFAULT_UI_STRINGS}. */
+    strings?: UiStrings;
+    /**
+     * Offer a third button — "always allow, this session" — and call this when
+     * the user picks it. The card still resolves `true`: the extra decision is
+     * *in addition to* approving this call, not instead of it.
+     *
+     * Absent means no button, which is deliberate: presence of the handler is
+     * what enables it, so the affordance can never be rendered with nothing
+     * listening. A caller that cannot honour the waiver simply does not pass one.
+     */
+    onAlwaysAllow?: () => void;
+}
+/**
+ * Append an inline confirmation card to `host` (the chat message list) and
+ * resolve `true` on confirm, `false` on cancel.
+ *
+ * The card lives in the transcript rather than in a modal overlay, so it reads
+ * after the assistant's explanation and never steals focus from the page.
+ *
+ * Answering it removes it: the record of the decision belongs to the tool card
+ * this gates, which settles to `done` or `declined` and carries it. A spent
+ * form left in place reads as still outstanding.
+ *
+ * With `onAlwaysAllow` set the card offers a third button. A prompt that is
+ * approved nearly every time is not a decision, it is a speed bump — and the
+ * reflex it trains is what makes the rare refusal easy to miss. Letting the
+ * user say "not this one again, this session" is the affordance that keeps the
+ * remaining prompts meaningful.
+ */
+export declare function requestConfirmation(host: Node & ParentNode, request: ConfirmationRequest, options?: ConfirmationOptions): Promise<boolean>;
+//# sourceMappingURL=confirmation_card.d.ts.map

package/dist/ui/interrupts/confirmation_card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation_card.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/confirmation_card.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtE,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,CAsElB"}

package/dist/ui/interrupts/confirmation_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const CONFIRMATION_STYLES: string;
+//# sourceMappingURL=confirmation_styles.d.ts.map

package/dist/ui/interrupts/confirmation_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/confirmation_styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,EAAE,MA+GjC,CAAC"}

package/dist/ui/interrupts/pending_decision.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The decision a run is suspended on, and the one way to abandon it.
+ *
+ * A run pauses on a person in three places -- a client-side confirmation, a
+ * batch of server interrupts, and the `ask_user` question -- and a Stop has to
+ * reach whichever of them is open. Holding the abort controller here gives
+ * it one owner: a wait opens, the Stop aborts what is open, and the wait closes
+ * when it is answered.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class PendingDecision {
+    #private;
+    /** Start waiting on a person; aborting the returned signal abandons the wait. */
+    open(): AbortSignal;
+    /** The wait was answered; a later Stop has nothing of this wait's to abandon. */
+    close(): void;
+    /** Abandon whatever wait is open, resolving it as declined. A no-op when none is. */
+    abort(): void;
+}
+//# sourceMappingURL=pending_decision.d.ts.map

package/dist/ui/interrupts/pending_decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending_decision.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/pending_decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;;IAK1B,iFAAiF;IACjF,IAAI,IAAI,WAAW,CAGlB;IAED,iFAAiF;IACjF,KAAK,IAAI,IAAI,CAEZ;IAED,qFAAqF;IACrF,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/ui/interrupts/question_card.d.ts

@@ -0,0 +1,49 @@
+import { type UiStrings } from "../ui_strings.js";
+/** What the inline question card asks (the `ask_user` frontend tool's args). */
+export interface QuestionRequest {
+    /** The question shown to the user. */
+    question: string;
+    /**
+     * Preset choices rendered as radios. When empty/omitted the card is a plain
+     * free-text prompt.
+     */
+    options?: readonly string[];
+    /**
+     * Whether the user may type a custom answer. With `options`, adds an "other"
+     * radio revealing a text field; without options the card is free-text anyway.
+     */
+    allowCustom?: boolean;
+}
+/** Options for {@link requestQuestion}. */
+export interface QuestionOptions {
+    /**
+     * Aborting this signal resolves the card with an empty answer and disabled
+     * fields — how a Stop control dismisses an open question.
+     */
+    signal?: AbortSignal;
+    /** Localized strings; defaults to the English {@link DEFAULT_UI_STRINGS}. */
+    strings?: UiStrings;
+}
+/**
+ * A fully custom renderer for the `ask_user` question, set via
+ * `AgUiChat.askUserRenderer`. Receives the parsed {@link QuestionRequest} and an
+ * `AbortSignal` that fires when the run is stopped, and resolves with the user's
+ * answer; an empty string means no answer. Replaces the built-in
+ * {@link requestQuestion} card entirely — see {@link ApprovalRenderer} for the
+ * same seam on approvals.
+ */
+export type QuestionRenderer = (request: QuestionRequest, options: {
+    signal: AbortSignal;
+}) => Promise<string>;
+/**
+ * Append an inline question card to `host` and resolve with the user's answer —
+ * the browser half of the built-in `ask_user` frontend tool.
+ *
+ * Collects a typed answer rather than the yes/no the confirmation and approval
+ * cards return: a radio pick from `options`, or free text when `allowCustom` is
+ * set or no `options` are given. Stays in the transcript as a resolved record,
+ * controls disabled and `data-resolved` set; a Stop while it is open resolves
+ * it with an empty string.
+ */
+export declare function requestQuestion(host: Node & ParentNode, request: QuestionRequest, options?: QuestionOptions): Promise<string>;
+//# sourceMappingURL=question_card.d.ts.map

package/dist/ui/interrupts/question_card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question_card.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/question_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtE,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;AAYrB;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAkJjB"}

package/dist/ui/interrupts/question_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const QUESTION_STYLES: string;
+//# sourceMappingURL=question_styles.d.ts.map

package/dist/ui/interrupts/question_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/question_styles.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,EAAE,MAuE7B,CAAC"}

package/dist/ui/place/place.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Where in the host application the user is: the page, tab or record on
+ * screen. The chip in the composer draws it and the next round sends it as one
+ * context entry, both from the same read, so the place the user sees is the
+ * place the agent is told.
+ */
+export interface Place {
+    /** Short name of the place, e.g. "Order #4821" or "Billing settings". */
+    readonly label: string;
+    /** A quieter second part, e.g. the section or the tab. */
+    readonly detail?: string;
+    /** An image URL for the chip's mark; a pin when absent. Never sent. */
+    readonly icon?: string;
+    /** Where the place lives. Sent to the agent, and what identifies the place. */
+    readonly href?: string;
+}
+//# sourceMappingURL=place.d.ts.map

package/dist/ui/place/place.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place.d.ts","sourceRoot":"","sources":["../../../src/ui/place/place.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/ui/place/place_chip.d.ts

@@ -0,0 +1,26 @@
+import type { Context } from "@ag-ui/core";
+import { type UiStrings } from "../ui_strings.js";
+import type { Place } from "./place.js";
+/**
+ * The "you are here" chip in the composer's tool row, and the context entry it stands for.
+ *
+ * The exclusion is keyed on the place: it holds across turns on the same place and lapses
+ * when a different one is read. A read of no place keeps it, so a page naming nothing
+ * mid-navigation does not undo it. Nothing persists, and nothing the host sets can lift it.
+ */
+export declare class PlaceChip {
+    #private;
+    readonly element: HTMLElement;
+    /** The same place for the collapsed bar, drawn by the same render. */
+    readonly barElement: HTMLElement;
+    constructor();
+    /** Wire the toggle for one connection, with the strings it resolved. */
+    mount(signal: AbortSignal, strings: UiStrings): void;
+    /** Show a fresh read; null hides the chip and sends nothing. */
+    update(place: Place | null): void;
+    /** Whether there is a place and the user withheld it, which withholds the page too. */
+    get withheld(): boolean;
+    /** The round's context entry: the place as shown, without its icon, or nothing. */
+    context(): Context[];
+}
+//# sourceMappingURL=place_chip.d.ts.map

package/dist/ui/place/place_chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place_chip.d.ts","sourceRoot":"","sources":["../../../src/ui/place/place_chip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQ3C,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAaxC;;;;;;GAMG;AACH,qBAAa,SAAS;;IACpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAiC;IAC9D,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAkC;IAWlE,cAyBC;IAED,wEAAwE;IACxE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAInD;IAED,gEAAgE;IAChE,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAMhC;IAED,uFAAuF;IACvF,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,mFAAmF;IACnF,OAAO,IAAI,OAAO,EAAE,CAWnB;CA0CF"}

package/dist/ui/place/place_from_route.d.ts

@@ -0,0 +1,9 @@
+import type { RouteMap } from "../../tools/route_map.js";
+import type { Place } from "./place.js";
+/**
+ * The place a route map implies: the first route whose path template matches
+ * `pathname`, its title (else its id) as the label, its group as the detail,
+ * and the path as the href. Null when no route matches.
+ */
+export declare function placeFromRoute(routes: RouteMap, pathname: string): Place | null;
+//# sourceMappingURL=place_from_route.d.ts.map

package/dist/ui/place/place_from_route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place_from_route.d.ts","sourceRoot":"","sources":["../../../src/ui/place/place_from_route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAUxC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAU/E"}

package/dist/ui/place/place_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const PLACE_STYLES: string;
+//# sourceMappingURL=place_styles.d.ts.map

package/dist/ui/place/place_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/place/place_styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,EAAE,MAyG1B,CAAC"}

package/dist/ui/placement/clamp_launcher.d.ts

@@ -0,0 +1,20 @@
+import type { LauncherBox, ViewportBox } from "./launcher_placement.js";
+/**
+ * Keep a launcher fully on screen, and a little clear of the edge.
+ *
+ * Applied to a dragged position and again to a restored one, because the
+ * viewport that stored it may since have shrunk. A launcher parked past the
+ * edge is unreachable, and it is the only way back to a collapsed
+ * conversation.
+ *
+ * Not the panel's 24px gutter, which was rejected here on purpose: a launcher
+ * held that far in refuses the corners people actually drag it to. But not
+ * zero either -- the bubble is a circle with a drop shadow, and one flush
+ * against the boundary has its shadow cut and its curve running into the edge,
+ * which reads as clipped whether or not a pixel is actually missing.
+ */
+export declare function clampLauncher(launcher: LauncherBox, viewport: ViewportBox, margin?: number): {
+    readonly left: number;
+    readonly top: number;
+};
+//# sourceMappingURL=clamp_launcher.d.ts.map

package/dist/ui/placement/clamp_launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp_launcher.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/clamp_launcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAExE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,WAAW,EACrB,MAAM,GAAE,MAA2B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAgBjD"}

package/dist/ui/placement/clamp_panel.d.ts

@@ -0,0 +1,13 @@
+import type { ViewportBox } from "./launcher_placement.js";
+import type { PanelRect } from "./resize_handle.js";
+/**
+ * Hold a panel inside the viewport, keeping its size.
+ *
+ * The near edge is clamped and the far edge follows, so a panel too large for
+ * the viewport is held against the near margin and left to the max-width and
+ * max-height rules rather than centred by force. The lower bound wins a
+ * contradiction for the same reason: `Math.min` first would put an oversized
+ * panel off the left edge instead of against the margin it can still honour.
+ */
+export declare function clampPanel(host: PanelRect, viewport: ViewportBox, margin?: number): PanelRect;
+//# sourceMappingURL=clamp_panel.d.ts.map

package/dist/ui/placement/clamp_panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp_panel.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/clamp_panel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,WAAW,EACrB,MAAM,GAAE,MAAoB,GAC3B,SAAS,CAYX"}

package/dist/ui/placement/collapse_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const COLLAPSE_STYLES: string;
+//# sourceMappingURL=collapse_styles.d.ts.map

package/dist/ui/placement/collapse_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapse_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/collapse_styles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,EAAE,MAmd7B,CAAC"}

package/dist/ui/placement/dock_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const DOCK_STYLES: string;
+//# sourceMappingURL=dock_styles.d.ts.map

package/dist/ui/placement/dock_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dock_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/dock_styles.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,EAAE,MA+GzB,CAAC"}

package/dist/ui/placement/embedded_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const EMBEDDED_STYLES: string;
+//# sourceMappingURL=embedded_styles.d.ts.map

package/dist/ui/placement/embedded_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/embedded_styles.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,EAAE,MAY7B,CAAC"}

package/dist/ui/placement/launcher_drag.d.ts

@@ -0,0 +1,49 @@
+import type { LauncherBox, ViewportBox } from "./launcher_placement.js";
+/** What the drag needs from its host to do its job. */
+export interface LauncherDragOptions {
+    /**
+     * Whether the current placement lets the launcher move, read per interaction
+     * because `placement` is a live attribute. A docked rail and a full-bleed
+     * layout have nowhere to move it to.
+     */
+    readonly enabled: () => boolean;
+    /** The launcher's current box, in viewport coordinates. */
+    readonly rect: () => LauncherBox;
+    /** The viewport the launcher has to stay inside. */
+    readonly viewport: () => ViewportBox;
+    /** Put the launcher's top-left at this point. Called per pointer move. */
+    readonly apply: (left: number, top: number) => void;
+    /**
+     * Called once per completed move, for persistence: on `pointerup` for a
+     * drag, and when the key comes up (or focus leaves) for a key press. Never
+     * per pointer move, and never per key repeat.
+     */
+    readonly commit: (left: number, top: number) => void;
+    /**
+     * Ends the launcher's own listeners when aborted. The launcher outlives the
+     * element's connection to the document and this is called on every connect,
+     * so without it a re-inserted element moved one arrow press two steps.
+     */
+    readonly signal: AbortSignal;
+}
+/**
+ * Let the user drag the collapsed launcher anywhere on screen.
+ *
+ * The launcher is a button before it is a handle, and that ordering is the
+ * whole difficulty: every drag ends in a `click` the browser synthesises, which
+ * would expand the panel the user was only repositioning. So a completed drag
+ * arms a one-shot capture listener that eats exactly one click.
+ *
+ * Two things stop that from eating a click it should not have. A drag ending
+ * off the launcher never produces the click it armed, so the arming is cleared
+ * on the next `pointerdown` -- a pointer click is always preceded by a press,
+ * which puts the clearing ahead of any click it could reach.
+ *
+ * That leaves the clicks with no press in front of them at all: `Enter` and
+ * `Space` on the focused button, assistive technology activating it, and a host
+ * calling `click()` itself. None of those is the tail of a drag, and all of them
+ * are the only way in for someone not using a pointer, so the suppression is
+ * narrowed to clicks carrying a click count -- which is the pointer's own.
+ */
+export declare function enableLauncherDrag(launcher: HTMLElement, options: LauncherDragOptions): void;
+//# sourceMappingURL=launcher_drag.d.ts.map

package/dist/ui/placement/launcher_drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher_drag.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/launcher_drag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAExE,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,WAAW,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,WAAW,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAgJ5F"}

package/dist/ui/placement/launcher_placement.d.ts

@@ -0,0 +1,77 @@
+/** A box in viewport coordinates. */
+export interface LauncherBox {
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * The part of the screen a widget may rest in: a width and height, and the
+ * corner they start from.
+ *
+ * The origin is not always zero. A host can reserve the edges its own chrome
+ * occupies, and a panel clamped against a viewport that starts at the top-left
+ * of the screen will happily park itself underneath a sticky header -- where it
+ * cannot be reached, and where collapsing it only hides it further.
+ */
+export interface ViewportBox extends Extent {
+    readonly left: number;
+    readonly top: number;
+}
+/** A width/height pair, in CSS pixels. */
+export interface Extent {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * The corner the panel is pinned by, and therefore grows away from: pinned
+ * `top-left` opens down and to the right. It is also the corner the resize grip
+ * must stay off, which is why the element stamps it rather than measuring it
+ * once the launcher has been moved.
+ */
+export interface ExpandCorner {
+    readonly x: "left" | "right";
+    readonly y: "top" | "bottom";
+}
+/** Where to put the host box, and where the launcher sits inside it. */
+export interface LauncherPlacement {
+    /** The corner the panel opens away from. */
+    readonly corner: ExpandCorner;
+    /** An `inset` shorthand for the host box. */
+    readonly hostInset: string;
+    /** An `inset` shorthand for the launcher, relative to the host box. */
+    readonly launcherInset: string;
+}
+/**
+ * Decide where a panel should open from a launcher the user has dragged.
+ *
+ * The launcher is the fixed point: wherever it was dropped is where it stays,
+ * collapsed and expanded alike. Everything here decides what happens *around*
+ * it.
+ *
+ * Two steps, and they are separate on purpose:
+ *
+ * 1. **Pick the corner with the most clear space.** For each axis, compare the
+ *    room a panel would have on either side of the launcher and pin the side
+ *    with more of it. Pinning `left` means the panel runs rightward from the
+ *    launcher's left edge, so the room that decides it is the distance from
+ *    that edge to the far side of the viewport -- not "which half of the screen
+ *    is the launcher in", which gives a different and worse answer for a
+ *    launcher near the middle.
+ *
+ * 2. **Clamp the panel into the viewport, then put the launcher back.** A
+ *    launcher near the centre of a short viewport has a panel taller than
+ *    either side, so the winning corner still overflows. Clamping moves the
+ *    host box -- and the launcher is positioned inside that box, so it would be
+ *    dragged along with it. The launcher's own inset therefore carries the
+ *    difference: zero in the ordinary case, and exactly the distance the clamp
+ *    moved the box in the case that needs it. That the launcher may end up
+ *    outside its own host box is fine; nothing clips it, and it keeps its own
+ *    pointer events.
+ *
+ * Both insets are expressed from the *same* corner, which is what stops a
+ * later panel resize from dragging the launcher: the pinned corner is the one
+ * edge a resize cannot move.
+ */
+export declare function launcherPlacement(launcher: LauncherBox, panel: Extent, viewport: ViewportBox, screen: Extent, margin?: number): LauncherPlacement;
+//# sourceMappingURL=launcher_placement.d.ts.map

package/dist/ui/placement/launcher_placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher_placement.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/launcher_placement.ts"],"names":[],"mappings":"AAIA,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAY,SAAQ,MAAM;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC9B;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAA2B,GAClC,iBAAiB,CA0CnB"}

package/dist/ui/placement/launcher_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const LAUNCHER_STYLES: string;
+//# sourceMappingURL=launcher_styles.d.ts.map

package/dist/ui/placement/launcher_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/launcher_styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,EAAE,MA0L7B,CAAC"}

package/dist/ui/placement/page_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const PAGE_STYLES: string;
+//# sourceMappingURL=page_styles.d.ts.map

package/dist/ui/placement/page_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/page_styles.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,EAAE,MA6CzB,CAAC"}

package/dist/ui/placement/panel_drag.d.ts

@@ -0,0 +1,40 @@
+import type { PanelRect } from "./resize_handle.js";
+/** What the drag needs from its host to do its job. */
+export interface PanelDragOptions {
+    /**
+     * Whether the panel can be moved right now, read per interaction because
+     * both halves of the answer are live: a docked or full-bleed placement has
+     * nowhere to move the panel to, and a collapsed one has no panel on screen.
+     */
+    readonly enabled: () => boolean;
+    /** The panel's current box, in viewport coordinates. */
+    readonly rect: () => PanelRect;
+    /**
+     * Put the panel at this box. Called per pointer move, with the box the press
+     * started on -- the whole gesture is one translation of that box, and a host
+     * with anything else to move alongside the panel needs the same distance
+     * rather than a distance measured from wherever the last move left things.
+     */
+    readonly apply: (box: PanelRect, from: PanelRect) => void;
+    /** Called once per completed move, for persistence. Never per pointer move. */
+    readonly commit: (box: PanelRect, from: PanelRect) => void;
+}
+/**
+ * Let the user move the whole widget by dragging the panel's header.
+ *
+ * The launcher can already be dragged, and this is the same gesture on the
+ * half of the widget that is on screen when it is open -- a chat panel is a
+ * window, and a window moves by its title bar. The two stay one position
+ * rather than two: the host answers a moved panel by moving the launcher with
+ * it, so collapsing after a drag leaves the launcher where the panel was.
+ *
+ * **No keyboard path here, deliberately.** Every other drag in this component
+ * has arrow keys on the handle, because the handle is a control and the
+ * capability is reachable nowhere else. A header is not a control: making it
+ * focusable would put a tab stop with no role in front of every keyboard user,
+ * ahead of the controls they actually came for. The capability is not lost --
+ * arrow keys on the collapsed launcher move the widget, and the panel follows
+ * it -- so what is missing is a shortcut, not the ability.
+ */
+export declare function enablePanelDrag(handle: HTMLElement, options: PanelDragOptions): void;
+//# sourceMappingURL=panel_drag.d.ts.map

package/dist/ui/placement/panel_drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel_drag.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/panel_drag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1D,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAC5D;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAkEpF"}