@teaflask/assistant 0.0.0 → 0.3.0

package/dist/components/primitives/floating-panel.js

@@ -0,0 +1,183 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, } from "react";
+import { useLatestRef } from "../use-latest-ref.js";
+import { focusAutofocusTarget } from "./autofocus.js";
+import { cx } from "./cx.js";
+import { useDockReflow } from "./use-dock-reflow.js";
+import { useSwipeDismiss } from "./use-swipe-dismiss.js";
+/** Where focus actually is, from the panel's own tree: getRootNode(),
+ * never the document, which retargets activeElement to the shadow HOST
+ * inside the script-tag distribution — the contains() guard would always
+ * fail and the captured opener would be the host. */
+function _activeElementNear(panel) {
+    const root = panel.getRootNode();
+    return root instanceof Document || root instanceof ShadowRoot
+        ? root.activeElement
+        : null;
+}
+/** Restores focus to the remembered opener, but only when the close is
+ * taking focus away from the user — i.e. focus still lives inside the
+ * panel. A user who opened the panel and moved on keeps their place. */
+function _returnFocusToOpener(panel, opener) {
+    if (!panel.contains(_activeElementNear(panel))) {
+        return;
+    }
+    if (opener instanceof HTMLElement && opener.isConnected) {
+        opener.focus();
+    }
+}
+export function TfFloatingPanel({ open, onOpenChange, corner = "bottom-right", dock = "floating", focusOnOpen, className, children, ...props }) {
+    const panelRef = useRef(null);
+    const parkOnForcedHide = usePopoverPresence(panelRef, open, focusOnOpen);
+    // Esc closes the surface it is pressed in, and nothing else: scoped to
+    // keydowns that reach the panel, stopped so one keystroke does one thing.
+    const closeFromEscape = useCallback((event) => {
+        if (event.key !== "Escape" || event.defaultPrevented) {
+            return;
+        }
+        event.stopPropagation();
+        onOpenChange(false);
+    }, [onOpenChange]);
+    const dismiss = useCallback(() => {
+        onOpenChange(false);
+    }, [onOpenChange]);
+    // Downward swipe on the grab region dismisses — confined to the handle
+    // because the content scrolls the same axis. Docked, the gesture is
+    // off: a full-height pane reads as page furniture, and furniture that
+    // flies away under a drag reads as breakage.
+    const swipe = useSwipeDismiss({
+        axis: "y",
+        direction: 1,
+        open,
+        enabled: dock === "floating",
+        onDismiss: dismiss,
+        handleSelector: "[data-tf-swipe-handle]",
+    });
+    useDockReflow(panelRef, dock);
+    return (
+    // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- the keydown is the panel's own Esc-to-close; the pointer handlers are the handle's swipe. Keyboard users close via Esc.
+    _jsx("div", { ref: panelRef, popover: "manual", role: "dialog", "data-tf-assistant": "", "data-tf-floating-panel": corner, "data-tf-panel-dock": dock, "data-tf-glass": dock === "floating" ? "" : undefined, onToggle: parkOnForcedHide, onKeyDown: closeFromEscape, onPointerDown: swipe.onPointerDown, onPointerMove: swipe.onPointerMove, onPointerUp: swipe.onPointerUp, onPointerCancel: swipe.onPointerCancel, onClickCapture: swipe.onClickCapture, className: cx(
+        // `hidden` restates the UA's closed-popover display and is the
+        // whole display without popover support; the important marker is
+        // ordering insurance between tf:hidden and tf:open:flex.
+        "tf:m-0 tf:hidden tf:p-0 tf:open:flex!", "tf:flex-col tf:overflow-hidden tf:text-tf-foreground", dock === "sidebar"
+            ? // Flush full-height, edge to edge, never an inset column: the
+                // Portal Lift rule inverted — no shadow, square corners, a
+                // hairline left border (in styles.css, not a border-l utility:
+                // border utilities ride an @property registration Chromium honours
+                // only in document sheets; this must paint everywhere). A fixed 26rem
+                // on ultrawide too — a pane, not a proportion; max-w guards an
+                // inflated host rem. left-auto is load-bearing: the UA popover
+                // style is inset:0, and left+right 0 resolves to the LEFT edge in LTR.
+                "tf:inset-y-0 tf:right-0 tf:left-auto tf:h-dvh tf:w-104 tf:max-w-[calc(100vw-2rem)] tf:rounded-none tf:bg-tf-background tf:shadow-none"
+            : cx(
+            // A floating corner card, never flush: the viewport-edge margins
+            // signal "the page is still there". Compose-window proportions
+            // (~44vw): the 24rem floor is the phone card, 46rem caps the
+            // ultrawide so the panel stays a card, never a pane.
+            "tf:inset-auto tf:bottom-4 tf:w-[clamp(24rem,44vw,46rem)] tf:max-w-[calc(100vw-2rem)]", 
+            // Fixed height under viewport-relative caps so the panel never
+            // jumps between empty and busy: ~68dvh is the compose-window
+            // register, 52rem stops tall monitors growing a tower, and the
+            // 6rem headroom term keeps the software-keyboard behavior.
+            "tf:h-[min(68dvh,52rem,calc(100dvh-6rem))]", 
+            // The floating-surface chrome comes from the liquid-glass
+            // material (data-tf-glass, styles.css). The 24px corner is the
+            // panel step of the radius ladder (the composer slab wears the
+            // same literal), not derived from --tf-radius so a host's
+            // control-radius theme can't unround the surface.
+            "tf:rounded-3xl tf:border", corner === "bottom-left" ? "tf:left-4" : "tf:right-4"), className), ...props, children: children }));
+}
+/**
+ * The popover discipline: `open` shows and hides the top-layer panel
+ * (focus captured on a gesture's open, returned on close), a hide the
+ * panel did not initiate parks it, and the way-is-clear watcher restores
+ * it. Returns the toggle handler that detects the forced hide.
+ */
+function usePopoverPresence(panelRef, open, focusOnOpen) {
+    const openerRef = useRef(null);
+    const focusOnOpenRef = useLatestRef(focusOnOpen);
+    // Parked by a modal (or a meddling host script): hidden while `open`
+    // still says true, waiting for the way to clear. A ref, not state:
+    // nothing rendered depends on it and the watcher reads it live.
+    const yieldedRef = useRef(false);
+    // The `open` prop stays authoritative: external hides are parked or
+    // reported, never applied locally, and this effect is the only writer.
+    // Inert is written here for the whole not-open stretch, not rendered:
+    // inert={!open} would commit before this effect and blur the focused
+    // descendant, so the focus return's "still inside" check could never
+    // pass. On open it lifts BEFORE showPopover(); on close it lands after.
+    useEffect(() => {
+        const panel = panelRef.current;
+        if (panel === null) {
+            return;
+        }
+        if (open) {
+            panel.removeAttribute("inert");
+        }
+        if (typeof panel.showPopover === "function") {
+            const showing = panel.matches(":popover-open");
+            if (open && !showing && !yieldedRef.current) {
+                openerRef.current = _activeElementNear(panel);
+                panel.showPopover();
+                if (focusOnOpenRef.current) {
+                    focusAutofocusTarget(panel, () => panel.matches(":popover-open"));
+                }
+            }
+            else if (!open) {
+                if (showing) {
+                    // Before hidePopover(), while "focus is still inside" is still
+                    // observable.
+                    _returnFocusToOpener(panel, openerRef.current);
+                    panel.hidePopover();
+                }
+                yieldedRef.current = false;
+            }
+        }
+        if (!open) {
+            panel.setAttribute("inert", "");
+        }
+    }, [panelRef, open, focusOnOpenRef]);
+    // The yield detector. Our own hide only ever runs with `open` already
+    // false, so a closed-toggle arriving while `open` is true was forced
+    // from outside — a modal's hide-all-popovers, or a host script.
+    const parkOnForcedHide = useCallback((event) => {
+        if (event.newState === "closed" && open) {
+            yieldedRef.current = true;
+        }
+    }, [open]);
+    // The way-is-clear watcher, listening for the whole open stretch and
+    // acting only while parked. `close` doesn't bubble, so the document
+    // hears it in the capture phase; fullscreen exits hide popovers through
+    // the same spec step. Restoration never touches focus.
+    useEffect(() => {
+        const panel = panelRef.current;
+        if (!open || panel === null || typeof panel.showPopover !== "function") {
+            return;
+        }
+        const doc = panel.ownerDocument;
+        const restoreWhenClear = () => {
+            // fullscreenchange fires on the way IN too, and entering fullscreen
+            // is itself a popover-hiding step — without the fullscreenElement
+            // check this would pop the panel over the fullscreen element.
+            if (!yieldedRef.current ||
+                doc.querySelector("dialog:modal") !== null ||
+                doc.fullscreenElement !== null) {
+                return;
+            }
+            if (!panel.matches(":popover-open")) {
+                panel.showPopover();
+            }
+            yieldedRef.current = false;
+        };
+        doc.addEventListener("close", restoreWhenClear, true);
+        doc.addEventListener("fullscreenchange", restoreWhenClear);
+        return () => {
+            doc.removeEventListener("close", restoreWhenClear, true);
+            doc.removeEventListener("fullscreenchange", restoreWhenClear);
+        };
+    }, [panelRef, open]);
+    return parkOnForcedHide;
+}
+//# sourceMappingURL=floating-panel.js.map

package/dist/components/primitives/floating-panel.js.map

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

package/dist/components/primitives/kbd.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentPropsWithoutRef } from "react";
+export declare function Kbd({ className, ...props }: ComponentPropsWithoutRef<"kbd">): import("react").JSX.Element;
+//# sourceMappingURL=kbd.d.ts.map

package/dist/components/primitives/kbd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kbd.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/kbd.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AAkBtD,wBAAgB,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,CAAC,KAAK,CAAC,+BAY3E"}

package/dist/components/primitives/kbd.js

@@ -0,0 +1,20 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cx } from "./cx.js";
+// A key cap: the question panel's ↑ ↓ ↵ hints at the right edge of the
+// active answer row. Hairline on a transparent ground (so it sits on the
+// emphasis wash in light and dark alike), the badge step, the control
+// radius — an instrument marking, never a decoration — and always
+// aria-hidden at the call site: the hint duplicates what the radiogroup's
+// description already tells assistive tech, so it must not be read twice.
+// Never wraps: a two-token cap ("Ctrl ↵") must stay one line inside its
+// 20px height. Geist Sans, not mono: the visual spec keeps the mono face
+// for code alone; the glyphs themselves are icons at the call site,
+// because a host font cannot be trusted to carry U+21B5.
+// WithoutRef on purpose: a plain function component cannot forward a ref
+// under React 18.3, so admitting one in the props type would type-check a
+// silent no-op (tests/ref-prop-surface.test.ts holds the line).
+export function Kbd({ className, ...props }) {
+    return (_jsx("kbd", { className: cx("tf:inline-flex tf:h-5 tf:min-w-5 tf:items-center tf:justify-center tf:gap-0.5 tf:rounded-tf", "tf:border tf:border-tf-input tf:bg-tf-transparent tf:px-1 tf:font-tf-sans tf:text-xs", "tf:leading-none tf:whitespace-nowrap tf:text-tf-muted-foreground", className), ...props }));
+}
+//# sourceMappingURL=kbd.js.map

package/dist/components/primitives/kbd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kbd.js","sourceRoot":"","sources":["../../../src/components/primitives/kbd.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAIb,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,uEAAuE;AACvE,yEAAyE;AACzE,sEAAsE;AACtE,kEAAkE;AAClE,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;AACxE,yEAAyE;AACzE,oEAAoE;AACpE,yDAAyD;AAEzD,yEAAyE;AACzE,0EAA0E;AAC1E,gEAAgE;AAChE,MAAM,UAAU,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAmC;IAC1E,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CACX,6FAA6F,EAC7F,sFAAsF,EACtF,kEAAkE,EAClE,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAC;AACJ,CAAC"}

package/dist/components/primitives/sheet.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from "react";
+interface TfSheetProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** The drawer's edge. Also the direction a dismissing swipe travels. */
+    side: "left" | "right";
+    "aria-label": string;
+    className?: string;
+    children: ReactNode;
+}
+export declare function TfSheet({ open, onOpenChange, side, className, children, ...props }: TfSheetProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=sheet.d.ts.map

package/dist/components/primitives/sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/sheet.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAoBpD,UAAU,YAAY;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,wEAAwE;IACxE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,YAAY,+BAyCd"}

package/dist/components/primitives/sheet.js

@@ -0,0 +1,28 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback } from "react";
+import { cx } from "./cx.js";
+import { TfDialog } from "./dialog.js";
+import { useSwipeDismiss } from "./use-swipe-dismiss.js";
+export function TfSheet({ open, onOpenChange, side, className, children, ...props }) {
+    const dismiss = useCallback(() => {
+        onOpenChange(false);
+    }, [onOpenChange]);
+    // The handlers ride the <dialog> element itself, so currentTarget is
+    // always the panel — no ref to forward, and pointer capture retargets
+    // the rest of the gesture here regardless of what it started over.
+    const swipe = useSwipeDismiss({
+        axis: "x",
+        direction: side === "left" ? -1 : 1,
+        open,
+        onDismiss: dismiss,
+    });
+    return (_jsx(TfDialog, { open: open, onOpenChange: onOpenChange, "data-tf-sheet": side, "data-tf-glass": "", onPointerDown: swipe.onPointerDown, onPointerMove: swipe.onPointerMove, onPointerUp: swipe.onPointerUp, onPointerCancel: swipe.onPointerCancel, onClickCapture: swipe.onClickCapture, className: cx(
+        // Flush to three edges at full height. Square corners are the
+        // point: a full-height panel with rounded outer corners reads as
+        // a modal, not as an edge. The peek left over beside it (the
+        // max-width) is both the "there is a page behind this" signal and
+        // a thumb-sized dismiss target.
+        "tf:m-0 tf:h-dvh tf:max-h-dvh tf:w-80 tf:max-w-[calc(100vw-3rem)] tf:flex-col", "tf:overflow-hidden tf:text-tf-foreground", side === "left" ? "tf:mr-auto" : "tf:ml-auto", className), ...props, children: children }));
+}
+//# sourceMappingURL=sheet.js.map

package/dist/components/primitives/sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.js","sourceRoot":"","sources":["../../../src/components/primitives/sheet.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,EAAkB,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA0BzD,MAAM,UAAU,OAAO,CAAC,EACtB,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACK;IACb,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACnB,qEAAqE;IACrE,sEAAsE;IACtE,mEAAmE;IACnE,MAAM,KAAK,GAAG,eAAe,CAAC;QAC5B,IAAI,EAAE,GAAG;QACT,SAAS,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI;QACJ,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,OAAO,CACL,KAAC,QAAQ,IACP,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,mBACX,IAAI,mBACL,EAAE,EAChB,aAAa,EAAE,KAAK,CAAC,aAAa,EAClC,aAAa,EAAE,KAAK,CAAC,aAAa,EAClC,WAAW,EAAE,KAAK,CAAC,WAAW,EAC9B,eAAe,EAAE,KAAK,CAAC,eAAe,EACtC,cAAc,EAAE,KAAK,CAAC,cAAc,EACpC,SAAS,EAAE,EAAE;QACX,8DAA8D;QAC9D,iEAAiE;QACjE,6DAA6D;QAC7D,kEAAkE;QAClE,gCAAgC;QAChC,8EAA8E,EAC9E,0CAA0C,EAC1C,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,EAC7C,SAAS,CACV,KACG,KAAK,YAER,QAAQ,GACA,CACZ,CAAC;AACJ,CAAC"}

package/dist/components/primitives/textarea.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentPropsWithoutRef } from "react";
+type TfTextareaVariant = "framed" | "bare";
+interface TfTextareaProps extends ComponentPropsWithoutRef<"textarea"> {
+    variant?: TfTextareaVariant;
+}
+export declare const TfTextarea: import("react").ForwardRefExoticComponent<TfTextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export {};
+//# sourceMappingURL=textarea.d.ts.map

package/dist/components/primitives/textarea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/textarea.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AAQtD,KAAK,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3C,UAAU,eAAgB,SAAQ,wBAAwB,CAAC,UAAU,CAAC;IACpE,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAaD,eAAO,MAAM,UAAU,iHAgBtB,CAAC"}

package/dist/components/primitives/textarea.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { cx } from "./cx.js";
+const VARIANT_CLASSES = {
+    framed: "tf:rounded-tf tf:border tf:border-tf-input tf:bg-tf-background tf:px-3 tf:py-2 " +
+        "tf:text-tf-label " +
+        "tf:focus-visible:outline-2 tf:focus-visible:outline-offset-1 tf:focus-visible:outline-tf-ring",
+    bare: "tf:border-0 tf:bg-transparent tf:px-2 tf:py-1.5 tf:text-tf-body tf:focus-visible:outline-none",
+};
+// forwardRef rather than ref-as-prop: the peer range admits React 18.3,
+// where a function component receives no ref through props — and the
+// composer's caret machinery anchors to this element.
+export const TfTextarea = forwardRef(function TfTextarea({ variant = "framed", className, ...props }, ref) {
+    return (_jsx("textarea", { ref: ref, className: cx("tf:w-full tf:resize-none tf:text-tf-foreground", "tf:placeholder:text-tf-muted-foreground", "tf:disabled:cursor-not-allowed tf:disabled:opacity-50", VARIANT_CLASSES[variant], className), ...props }));
+});
+//# sourceMappingURL=textarea.js.map

package/dist/components/primitives/textarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.js","sourceRoot":"","sources":["../../../src/components/primitives/textarea.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAY7B,MAAM,eAAe,GAAsC;IACzD,MAAM,EACJ,iFAAiF;QACjF,mBAAmB;QACnB,+FAA+F;IACjG,IAAI,EAAE,+FAA+F;CACtG,CAAC;AAEF,wEAAwE;AACxE,qEAAqE;AACrE,sDAAsD;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAClC,SAAS,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG;IAClE,OAAO,CACL,mBACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,EAAE,CACX,gDAAgD,EAChD,yCAAyC,EACzC,uDAAuD,EACvD,eAAe,CAAC,OAAO,CAAC,EACxB,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/components/primitives/use-dock-reflow.d.ts

@@ -0,0 +1,12 @@
+import { type RefObject } from "react";
+/** Keeps the host page pushed exactly while the docked panel is actually
+ * visible. Visibility, not the mode setting or the open prop: a host
+ * modal that force-hides (parks) the panel must un-push the page, and
+ * the way-is-clear restore must re-push it. The native `toggle` event is
+ * the one signal that fires on every show and hide regardless of who
+ * drove it — our own show/hide effect, the modal's spec-mandated
+ * hide-all-popovers, a meddling host script, the watcher's re-show — so
+ * it is the single source of truth here, and the React onToggle prop
+ * stays the park detector's alone. */
+export declare function useDockReflow(panelRef: RefObject<HTMLDivElement | null>, dock: "floating" | "sidebar"): void;
+//# sourceMappingURL=use-dock-reflow.d.ts.map

package/dist/components/primitives/use-dock-reflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dock-reflow.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/use-dock-reflow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMlD;;;;;;;;sCAQsC;AACtC,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,EAC1C,IAAI,EAAE,UAAU,GAAG,SAAS,GAC3B,IAAI,CAyCN"}

package/dist/components/primitives/use-dock-reflow.js

@@ -0,0 +1,52 @@
+"use client";
+import { useEffect } from "react";
+import { dockReflowFor } from "../../core/dock-reflow.js";
+const REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+/** Keeps the host page pushed exactly while the docked panel is actually
+ * visible. Visibility, not the mode setting or the open prop: a host
+ * modal that force-hides (parks) the panel must un-push the page, and
+ * the way-is-clear restore must re-push it. The native `toggle` event is
+ * the one signal that fires on every show and hide regardless of who
+ * drove it — our own show/hide effect, the modal's spec-mandated
+ * hide-all-popovers, a meddling host script, the watcher's re-show — so
+ * it is the single source of truth here, and the React onToggle prop
+ * stays the park detector's alone. */
+export function useDockReflow(panelRef, dock) {
+    useEffect(() => {
+        const panel = panelRef.current;
+        if (dock !== "sidebar" ||
+            panel === null ||
+            typeof panel.showPopover !== "function") {
+            return;
+        }
+        const controller = dockReflowFor(panel.ownerDocument.documentElement);
+        // Both switches the stylesheet answers, answered here too: the OS
+        // preference and the host's data-reduce-motion kill switch — an
+        // inline transition is invisible to those CSS selectors.
+        const reduceMotion = () => (panel.ownerDocument.defaultView ?? window).matchMedia(REDUCED_MOTION_QUERY).matches || panel.closest('[data-reduce-motion="true"]') !== null;
+        const syncPushToVisibility = () => {
+            if (panel.matches(":popover-open")) {
+                // The rendered width, not the nominal 26rem: offsetWidth is
+                // layout width (the sidebar pins scale to 1), and it already
+                // reflects a host root font-size inflating rem and the
+                // max-width clamp on narrow viewports.
+                controller.push(panel.offsetWidth, reduceMotion());
+            }
+            else {
+                controller.release();
+            }
+        };
+        panel.addEventListener("toggle", syncPushToVisibility);
+        // A dock-mode switch on an already-open panel changes no popover
+        // state and fires no toggle; this one call covers it.
+        syncPushToVisibility();
+        return () => {
+            panel.removeEventListener("toggle", syncPushToVisibility);
+            // Mode switch, close, or unmount: the un-push still animates —
+            // the controller lives on the documentElement's lifetime, which
+            // outlives this panel.
+            controller.release();
+        };
+    }, [panelRef, dock]);
+}
+//# sourceMappingURL=use-dock-reflow.js.map

package/dist/components/primitives/use-dock-reflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dock-reflow.js","sourceRoot":"","sources":["../../../src/components/primitives/use-dock-reflow.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,oBAAoB,GAAG,kCAAkC,CAAC;AAEhE;;;;;;;;sCAQsC;AACtC,MAAM,UAAU,aAAa,CAC3B,QAA0C,EAC1C,IAA4B;IAE5B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC/B,IACE,IAAI,KAAK,SAAS;YAClB,KAAK,KAAK,IAAI;YACd,OAAO,KAAK,CAAC,WAAW,KAAK,UAAU,EACvC,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;QACtE,kEAAkE;QAClE,gEAAgE;QAChE,yDAAyD;QACzD,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC,UAAU,CACpD,oBAAoB,CACrB,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,6BAA6B,CAAC,KAAK,IAAI,CAAC;QACrE,MAAM,oBAAoB,GAAG,GAAG,EAAE;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnC,4DAA4D;gBAC5D,6DAA6D;gBAC7D,uDAAuD;gBACvD,uCAAuC;gBACvC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QACvD,iEAAiE;QACjE,sDAAsD;QACtD,oBAAoB,EAAE,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;YAC1D,+DAA+D;YAC/D,gEAAgE;YAChE,uBAAuB;YACvB,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/components/primitives/use-swipe-dismiss.d.ts

@@ -0,0 +1,35 @@
+import { type MouseEvent, type PointerEvent } from "react";
+export interface SwipeDismissOptions {
+    /** The axis the dismissing travel moves along. */
+    axis: "x" | "y";
+    /** The sign along that axis that travels toward dismissal: +1 for
+     * rightward/downward, -1 for leftward/upward. */
+    direction: 1 | -1;
+    /** The surface's open state. Every change of it ends whatever gesture
+     * was in flight (see the effect below for why). */
+    open: boolean;
+    /** Gates the whole machine — the docked panel keeps the handlers
+     * mounted (rules of hooks) but must never dismiss by touch. While
+     * false, new gestures are declined, and flipping it mid-gesture
+     * releases the drag with its decoration stripped. */
+    enabled?: boolean;
+    onDismiss: () => void;
+    /** When set, a drag may only begin on a press inside a matching
+     * descendant — the grab region of a surface whose content scrolls
+     * along the dismissal axis. Absent, the whole panel drags. */
+    handleSelector?: string;
+}
+/** The five handlers, all meant for the panel element itself so that
+ * currentTarget is always the panel — no ref to forward, and pointer
+ * capture retargets the rest of the gesture there. The stylesheet
+ * animates what the machine writes: the live offset on
+ * `--_tf-swipe-drag`, and `data-tf-swipe-dragging` while a finger owns it. */
+export interface SwipeDismissHandlers {
+    onPointerDown: (event: PointerEvent<HTMLElement>) => void;
+    onPointerMove: (event: PointerEvent<HTMLElement>) => void;
+    onPointerUp: (event: PointerEvent<HTMLElement>) => void;
+    onPointerCancel: (event: PointerEvent<HTMLElement>) => void;
+    onClickCapture: (event: MouseEvent<HTMLElement>) => void;
+}
+export declare function useSwipeDismiss({ axis, direction, open, enabled, onDismiss, handleSelector, }: SwipeDismissOptions): SwipeDismissHandlers;
+//# sourceMappingURL=use-swipe-dismiss.d.ts.map

package/dist/components/primitives/use-swipe-dismiss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-swipe-dismiss.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/use-swipe-dismiss.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,OAAO,CAAC;AA+Cf,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAChB;qDACiD;IACjD,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClB;uDACmD;IACnD,IAAI,EAAE,OAAO,CAAC;IACd;;;yDAGqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;kEAE8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;8EAI8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC1D,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC1D,WAAW,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACxD,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC5D,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,OAAc,EACd,SAAS,EACT,cAAc,GACf,EAAE,mBAAmB,GAAG,oBAAoB,CAoI5C"}