prime-ui-kit 0.15.0 → 0.17.0

package/dist/hooks/useSwipeDismiss.d.ts

@@ -1,26 +1,47 @@
 import * as React from "react";
-export type UseSwipeDismissOptions = {
+/** What holds a panel that could otherwise swipe away (a dialog `Guard`). */
+type SwipeGuard = "busy" | "dirty" | null;
+type UseSwipeDismissOptions = {
+    /**
+     * The gesture exists: the panel draws a grab handle and a drag can dismiss it. Off where the
+     * panel takes no swipe at all (a wide viewport, `closeOnOutsideClick={false}`).
+     */
     enabled: boolean;
+    /**
+     * `busy` — no drag starts (the panel carries `data-swipe-disabled`: no grab cursor, the browser
+     * pans again); `dirty` — a drag past the threshold glides back and asks through `onDismiss` (the
+     * host opens its «discard changes?» confirm) instead of leaving.
+     */
+    guard?: SwipeGuard;
+    /** A drag released past the threshold, or a flick: the host's dismiss request. */
     onDismiss: () => void;
-    /** Selector of the zones a drag starts from: the grab handle, the header. */
-    handle: string;
     /**
-     * How far down the panel is, 0 (at rest) … 1 (off the bottom edge), on every move and on release
-     * (0 back, 1 out) — for parts that follow the drag, such as the scrim's opacity.
+     * The scrim under the panel: it follows the drag through `--swipe-progress` (0 at rest … 1 off
+     * the edge) and mirrors `data-swiping` / `data-swipe-dismissed`, so its CSS fades with the panel.
      */
-    onProgress?: (progress: number) => void;
+    scrimRef?: React.RefObject<HTMLElement | null>;
 };
-/** The custom property the panel CSS maps onto its own axis (`transform`). */
-export declare const SWIPE_OFFSET_VAR = "--swipe-offset";
+export type SwipeDismiss = {
+    /** The gesture exists: render the grab handle (`SheetHandle`). */
+    enabled: boolean;
+    /** Attach to the panel. */
+    onPointerDown: (event: React.PointerEvent<HTMLElement>) => void;
+    /** Spread on the panel: `data-swipe-disabled` while the guard is busy. */
+    panelProps: {
+        "data-swipe-disabled"?: "";
+    };
+};
+/** The attribute of the grab handle: a drag starts on it, or on the header right after it. */
+export declare const SWIPE_HANDLE_ATTRIBUTE = "data-swipe-handle";
 /**
  * Swipe-down-to-close for a panel at the bottom edge (Sheet, Modal and floating layers as phone
- * sheets). Attach `onPointerDown` to the panel: a drag down from `handle` moves the panel with the
- * pointer through `--swipe-offset` and `data-swiping`, which its CSS maps onto `transform`. On
- * release the panel closes past 30% of its height or on a flick — gliding the rest of the way out
- * from the release point (`data-swipe-dismissed`) — otherwise it glides back; `onProgress` follows
- * along. A sideways drag is left to scrolling. The gesture is an extra way out: the panel keeps
- * Escape and the scrim (WCAG 2.5.7).
+ * sheets). Attach `onPointerDown` to the panel: a drag down from the grab handle (or the header
+ * right under it) moves the panel with the pointer through `--swipe-offset` and `data-swiping`,
+ * which its CSS maps onto `transform`. On release the panel closes past 30% of its height or on a
+ * flick — gliding the rest of the way out from the release point (`data-swipe-dismissed`) —
+ * otherwise it glides back; the scrim follows along. A `dirty` panel glides back and asks instead.
+ * A sideways drag is left to scrolling. The gesture is an extra way out: the panel keeps Escape
+ * and the scrim (WCAG 2.5.7).
  */
-export declare function useSwipeDismiss({ enabled, onDismiss, handle, onProgress, }: UseSwipeDismissOptions): {
-    onPointerDown: (event: React.PointerEvent<HTMLElement>) => void;
-};
+export declare function useSwipeDismiss({ enabled, guard, onDismiss, scrimRef, }: UseSwipeDismissOptions): SwipeDismiss;
+export {};

package/dist/hooks/useVirtualRows.d.ts

@@ -1,11 +1,11 @@
 import * as React from "react";
 /** A row to render: its index, top offset and height in px. */
-export type VirtualRow = {
+type VirtualRow = {
     index: number;
     start: number;
     size: number;
 };
-export type UseVirtualRowsOptions = {
+type UseVirtualRowsOptions = {
     /** Number of rows. */
     count: number;
     /** The scroll container the rows scroll in (vertically). */
@@ -41,7 +41,7 @@ export type UseVirtualRowsOptions = {
      */
     sticky?: readonly number[];
 };
-export type VirtualRows = {
+type VirtualRows = {
     /** Rows to render, by index: the visible range, the overscan and the pinned rows. */
     rows: VirtualRow[];
     /** Height of all rows, px: the size of the scrolled content. */
@@ -50,6 +50,11 @@ export type VirtualRows = {
     startOf: (index: number) => number;
     /** Callback ref for the element of row `index`: measures it and follows its size. */
     measure: (index: number) => (node: HTMLElement | null) => void;
+    /**
+     * Every rendered row has its own measured size: the offsets of the window are exact, so a host
+     * may scroll to a row by its offset (a chat opening at its end).
+     */
+    measured: boolean;
 };
 /**
  * Vertical row virtualization inside a component's own scroller: renders the rows that intersect
@@ -72,3 +77,4 @@ export declare function rowGaps({ rows, totalSize }: Pick<VirtualRows, "rows" |
     })[];
     end: number;
 };
+export {};

package/dist/icon-set.js

@@ -410,7 +410,7 @@ import {
   Youtube,
   Zap,
   ZapOff
-} from "./chunks/chunk-6TI4DSM5.js";
+} from "./chunks/chunk-PRP4B6OG.js";
 import {
   Activity,
   ArrowDown,
@@ -527,7 +527,7 @@ import {
   X,
   ZoomIn,
   ZoomOut
-} from "./chunks/chunk-Q3BFRQHZ.js";
+} from "./chunks/chunk-2ODXLPW3.js";
 export {
   AArrowDown as AArrowDownIcon,
   AArrowUp as AArrowUpIcon,

package/dist/icons/Icon.d.ts

@@ -18,6 +18,6 @@ export declare function Icon({ name, ...rest }: IconProps): import("react/jsx-ru
  * whole drawing. Call it once at module level.
  */
 export declare function createIcon(glyph: SvgGlyph): {
-    ({ className, size, tone, color, label, animated, strokeWidth, ...rest }: DomainIconProps): import("react/jsx-runtime").JSX.Element;
+    ({ className, size, tone, color, label, animated, drawn, strokeWidth, ...rest }: DomainIconProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

package/dist/icons/glyph.d.ts

@@ -28,6 +28,12 @@ export type DomainIconProps = Omit<React.ComponentPropsWithoutRef<"svg">, "color
      * it still.
      */
     animated?: boolean;
+    /**
+     * A mark that follows a state instead of playing a gesture: `true` draws the glyph's stroke in
+     * (its `draw` parts), `false` draws it out, both ways eased — a check that appears when a row is
+     * ticked. Undefined: the usual one-shot gesture. A drawn icon plays no hover gesture.
+     */
+    drawn?: boolean;
     ref?: React.Ref<SVGSVGElement>;
 };
 /** A kit glyph component: an animated icon drawn on the 24-unit grid. */
@@ -36,17 +42,18 @@ export type Glyph = React.ComponentType<DomainIconProps> & {
     source: string;
 };
 /** Shared class names and attributes of every kit icon root. */
-export declare function useIconRoot({ className, size, tone, color, label, animated, motion, }: Pick<DomainIconProps, "className" | "size" | "tone" | "color" | "label" | "animated"> & {
+export declare function useIconRoot({ className, size, tone, color, label, animated, drawn, motion, }: Pick<DomainIconProps, "className" | "size" | "tone" | "color" | "label" | "animated" | "drawn"> & {
     /** `glyph` — parts carry their own `data-motion`; `generic` — the whole drawing pops. */
     motion: "glyph" | "generic";
 }): {
     readonly className: string;
-    readonly "data-tone": "accent" | "success" | "warning" | "danger" | "secondary" | "muted" | undefined;
+    readonly "data-tone": "accent" | "success" | "warning" | "danger" | "muted" | "secondary" | undefined;
     readonly "data-color": "gray" | "blue" | "green" | "orange" | "red" | "yellow" | "purple" | "sky" | "pink" | "teal" | undefined;
     readonly role: "img" | undefined;
     readonly "aria-label": string | undefined;
     readonly "aria-hidden": true | undefined;
     readonly "data-icon-motion": "glyph" | "generic" | undefined;
+    readonly "data-drawn": string | undefined;
 };
 /**
  * Defines a kit glyph from its SVG body (paths copied from Lucide, parts annotated with