prime-ui-kit 0.9.0 → 0.9.2

package/dist/components/tooltip/Tooltip.d.ts

@@ -1,11 +1,16 @@
 import * as React from "react";
+import { type PositionAlign, type PositionSide } from "@/hooks/usePosition";
 import type { ControlSize } from "@/internal/states";
-export type TooltipSide = "top" | "bottom" | "left" | "right";
+export type TooltipSide = PositionSide;
+export type TooltipAlign = PositionAlign;
 export type TooltipProviderProps = {
+    /** Show delay in ms for every Tooltip.Root inside. */
     delayDuration?: number;
+    /** Window in ms after a tooltip closes during which the next one opens instantly. */
+    skipDelayDuration?: number;
     children: React.ReactNode;
 };
-declare function TooltipProvider({ delayDuration, children }: TooltipProviderProps): import("react/jsx-runtime").JSX.Element;
+declare function TooltipProvider({ delayDuration, skipDelayDuration, children, }: TooltipProviderProps): import("react/jsx-runtime").JSX.Element;
 declare namespace TooltipProvider {
     var displayName: string;
 }
@@ -14,7 +19,7 @@ export type TooltipRootProps = {
     open?: boolean;
     defaultOpen?: boolean;
     onOpenChange?: (open: boolean) => void;
-    /** Задержка показа (мс) для этого тултипа; по умолчанию — из `Tooltip.Provider` (400). */
+    /** Show delay in ms for this tooltip; defaults to the Provider's (400). */
     delayDuration?: number;
 };
 declare function TooltipRoot({ children, open, defaultOpen, onOpenChange, delayDuration: delayProp, }: TooltipRootProps): import("react/jsx-runtime").JSX.Element;
@@ -22,27 +27,27 @@ declare namespace TooltipRoot {
     var displayName: string;
 }
 export type TooltipTriggerProps = {
+    /** One focusable element: a Button, or a `tabIndex={0}` wrapper around a disabled control. */
     children: React.ReactElement;
-    className?: string;
-};
-declare function TooltipTrigger({ children, className }: TooltipTriggerProps): React.ReactElement<React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>, string | React.JSXElementConstructor<any>>;
+    ref?: React.Ref<HTMLElement>;
+} & Omit<React.HTMLAttributes<HTMLElement>, "children">;
+/**
+ * The tooltip id joins the child's own `aria-describedby`; the child's handlers run first. Other
+ * props (handlers, ARIA, `ref`) are forwarded to the child.
+ */
+declare function TooltipTrigger({ children, ...forwarded }: TooltipTriggerProps): import("react/jsx-runtime").JSX.Element;
 declare namespace TooltipTrigger {
     var displayName: string;
 }
-type TooltipCoords = {
-    top: number;
-    left: number;
-    side: TooltipSide;
-};
-/** Позиция по стороне; если не влезает — противоположная сторона; затем сдвиг в пределах вьюпорта. */
-export declare function computeTooltipPosition(ar: Pick<DOMRectReadOnly, "top" | "left" | "right" | "bottom" | "width" | "height">, cw: number, ch: number, vw: number, vh: number, side: TooltipSide, offset: number, pad: number): TooltipCoords;
-export type TooltipContentProps = {
+export type TooltipContentProps = Omit<React.HTMLAttributes<HTMLDivElement>, "id" | "role" | "onPointerEnter" | "onPointerLeave"> & {
     children: React.ReactNode;
+    /** Text and padding tier; also the size context of controls inside (a Kbd). */
     size?: ControlSize;
     side?: TooltipSide;
-    className?: string;
+    align?: TooltipAlign;
+    ref?: React.Ref<HTMLDivElement>;
 };
-declare function TooltipContent({ children, size, side, className }: TooltipContentProps): import("react/jsx-runtime").JSX.Element | null;
+declare function TooltipContent({ children, size, side, align, className, ...rest }: TooltipContentProps): import("react/jsx-runtime").JSX.Element;
 declare namespace TooltipContent {
     var displayName: string;
 }
@@ -53,4 +58,3 @@ export declare const Tooltip: {
     Content: typeof TooltipContent;
 };
 export {};
-//# sourceMappingURL=Tooltip.d.ts.map

package/dist/components/typography/Typography.d.ts

@@ -1,11 +1,11 @@
-import * as React from "react";
+import type * as React from "react";
 import type { TextTone } from "@/internal/states";
 /** Text roles from the foundation (`--prime-text-<role>-*`). */
 export type TypographyRole = "caption" | "body-s" | "body-m" | "body-l" | "title-s" | "title-m" | "title-l" | "heading-s" | "heading-m" | "heading-l" | "display-s" | "display-m" | "display-l" | "code";
 export type TypographyWeight = "regular" | "medium" | "semibold";
 export type TypographyTracking = "normal" | "tight" | "tighter" | "wide";
 export type TypographyAs = "p" | "span" | "div" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "small" | "blockquote" | "article" | "section" | "header" | "footer" | "aside" | "nav" | "main";
-export type TypographyRootProps = {
+export type TypographyProps = {
     as?: TypographyAs;
     /** Text role (`--prime-text-<role>-*`). */
     variant: TypographyRole;
@@ -20,23 +20,7 @@ export type TypographyRootProps = {
     tone?: TextTone;
     children?: React.ReactNode;
     className?: string;
+    ref?: React.Ref<HTMLElement>;
 } & React.HTMLAttributes<HTMLElement>;
-export declare const Typography: {
-    Root: React.ForwardRefExoticComponent<{
-        as?: TypographyAs;
-        /** Text role (`--prime-text-<role>-*`). */
-        variant: TypographyRole;
-        /** Overrides the role's weight. Omit to use the role's own weight. */
-        weight?: TypographyWeight;
-        /** Overrides the role's tracking. Omit to use the role's own tracking. */
-        tracking?: TypographyTracking;
-        /** Clamp to one line with an ellipsis (set `title` when the full text matters). */
-        truncate?: boolean;
-        italic?: boolean;
-        /** Text color. Default `default` (primary text). */
-        tone?: TextTone;
-        children?: React.ReactNode;
-        className?: string;
-    } & React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>>;
-};
-//# sourceMappingURL=Typography.d.ts.map
+/** Any text element styled by one text role; state goes to `data-*`. */
+export declare function Typography({ as: Tag, variant, weight, tracking, truncate, italic, tone, className, children, ref, ...rest }: TypographyProps): import("react/jsx-runtime").JSX.Element;

package/dist/hooks/useControllableState.d.ts

@@ -5,4 +5,3 @@ type UseControllableStateParams<T> = {
 };
 export declare function useControllableState<T>({ value, defaultValue, onChange, }: UseControllableStateParams<T>): readonly [T, (nextValue: T | ((prev: T) => T)) => void];
 export {};
-//# sourceMappingURL=useControllableState.d.ts.map

package/dist/hooks/useEdgeOverflow.d.ts

@@ -0,0 +1,12 @@
+import * as React from "react";
+export type EdgeOverflow = {
+    start: boolean;
+    end: boolean;
+};
+/**
+ * Tracks whether a scroll region hides content before / after its visible part along one axis
+ * (`ScrollContainer` `fade`, the DataTable edge cue). Measured at most once per frame on scroll,
+ * on resize of the region or any child, and when children are added. RTL-aware: the start is the
+ * inline start of the region.
+ */
+export declare function useEdgeOverflow(ref: React.RefObject<HTMLElement | null>, enabled: boolean, horizontal: boolean): EdgeOverflow;

package/dist/hooks/useEnterConfirm.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+export type UseEnterConfirmOptions = {
+    enabled: boolean;
+    containerRef: React.RefObject<HTMLElement | null>;
+    /** Replaces the default (a `click()` on `confirmRef`). */
+    onEnterConfirm?: (event: KeyboardEvent) => void;
+    /** The confirm target (the primary button wrapped in `Modal.Confirm`). */
+    confirmRef: React.RefObject<HTMLElement | null>;
+};
+/**
+ * Enter inside a dialog clicks its confirm action — from a text field or the dialog itself. Enter on
+ * a button, link or `role="button"` activates that element instead (Enter on Cancel cancels), and
+ * the header (close button) is left alone.
+ */
+export declare function useEnterConfirm({ enabled, containerRef, onEnterConfirm, confirmRef, }: UseEnterConfirmOptions): void;

package/dist/hooks/useImageStatus.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+/** Load status of an image part as its root sees it; `idle` = no image part mounted. */
+export type ImageStatus = "idle" | "loading" | "loaded" | "error";
+type ImageHandlers = {
+    onLoad?: React.ReactEventHandler<HTMLImageElement>;
+    onError?: React.ReactEventHandler<HTMLImageElement>;
+};
+/**
+ * Image side of an image-with-fallback component (Avatar, Thumbnail): tracks the `<img>` load and
+ * reports it to the root through `report`, so the root's Fallback shows while loading and after an
+ * error. Key the image element by `src`: a new source remounts it and starts again at `loading`.
+ * Unmounting the image reports `idle`.
+ */
+export declare function useImageStatus(report: (status: ImageStatus) => void, { onLoad, onError }?: ImageHandlers): {
+    status: "loading" | "error" | "loaded";
+    onLoad: (event: React.SyntheticEvent<HTMLImageElement>) => void;
+    onError: (event: React.SyntheticEvent<HTMLImageElement>) => void;
+};
+export {};

package/dist/hooks/useInertSiblings.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+/** Body children that stay usable under a modal layer: live regions (the toast viewport). */
+export declare const LIVE_REGION_ATTR = "data-prime-live-region";
+/**
+ * While `enabled`, makes every `<body>` child inert except the one that holds `ref` (its portal)
+ * and live regions, then restores the previous values. `inert` already removes the content from
+ * the accessibility tree, so no `aria-hidden` is added. Part of `useModalLayer`.
+ */
+export declare function useInertSiblings(enabled: boolean, ref: React.RefObject<HTMLElement | null>): void;

package/dist/hooks/useMediaQuery.d.ts

@@ -0,0 +1,7 @@
+/** Viewport below the first breakpoint (foundation §9): overlays become bottom sheets. */
+export declare const COMPACT_QUERY = "(max-width: 639px)";
+/**
+ * Whether a media query matches, kept in sync with the viewport. `false` on the server, while
+ * `enabled` is off, and where `matchMedia` is missing.
+ */
+export declare function useMediaQuery(query: string, enabled?: boolean): boolean;

package/dist/hooks/useMergedRefs.d.ts

@@ -1,3 +1,7 @@
 import * as React from "react";
-export declare function useMergedRefs<T>(...refs: Array<React.Ref<T> | undefined>): (value: T) => void;
-//# sourceMappingURL=useMergedRefs.d.ts.map
+/**
+ * One stable callback ref that writes to every given ref (callback or object). The identity changes
+ * only when one of the refs does, so the node is not detached and reattached on every render. The
+ * single way to merge refs in components; the number of refs at a call site must not change.
+ */
+export declare function useMergedRefs<T>(...refs: Array<React.Ref<T> | undefined>): React.RefCallback<T>;

package/dist/hooks/useModalLayer.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+import { type DismissReason, type LayerEntry } from "@/internal/overlay/layerStack";
+export type UseModalLayerOptions = {
+    open: boolean;
+    /** Escape (`escape`) or a click on the scrim (`scrim`); the owner applies its `closeOn*` props. */
+    onDismiss: (reason: DismissReason) => void;
+};
+export type ModalLayer<T extends HTMLElement> = {
+    /** Attach to the panel (`role="dialog"`): the trap container and the inside of the layer. */
+    ref: React.RefObject<T | null>;
+    /** Pass to `<LayerProvider value={layer}>` around the content: nested layers stack above. */
+    layer: LayerEntry;
+};
+/**
+ * The mechanics of a modal layer — Modal, Drawer, CommandMenu, the off-canvas Sidebar — in one
+ * fixed order: the rest of the page becomes inert, focus moves in and Tab is trapped, document
+ * scroll locks, and the layer joins the stack with scrim (`click`) dismissal. On close the page is
+ * restored first, then focus returns to the opener, captured at the open transition. Focus always
+ * returns, also after a scrim click: the page behind was inert, so the opener is the only place to
+ * continue from (foundation §8).
+ */
+export declare function useModalLayer<T extends HTMLElement = HTMLElement>({ open, onDismiss, }: UseModalLayerOptions): ModalLayer<T>;

package/dist/hooks/usePosition.d.ts

@@ -1,62 +1,68 @@
 import * as React from "react";
-export type PositionSide = "bottom" | "top";
+export type PositionSide = "top" | "right" | "bottom" | "left";
 export type PositionAlign = "start" | "center" | "end";
-type UsePositionOptions = {
-    side?: PositionSide;
-    align?: PositionAlign;
-    offset?: number;
-    /** Отступ контента от краёв вьюпорта при расчёте flip/позиции (px). */
-    viewportPad?: number;
-    flip?: boolean;
-    matchTriggerMinWidth?: boolean;
-};
-/**
- * Private custom properties written by `usePosition` on the floating element. Panels combine them
- * with tokens, e.g. `max-height: min(var(--prime-panel-max-height), var(--float-max-h))`, so the
- * design limit and the room next to the anchor both apply.
- */
-export declare const FLOAT_MAX_HEIGHT_VAR = "--float-max-h";
-/** Trigger width (px) when the panel should be at least as wide as its anchor. */
-export declare const FLOAT_MIN_WIDTH_VAR = "--float-min-w";
-/** Viewport width minus gutters (px): a panel is never wider than the screen. */
-export declare const FLOAT_MAX_WIDTH_VAR = "--float-max-w";
-export type PositionUpdateMeta = {
-    resolvedSide: PositionSide;
-};
 /**
  * Computed length of a CSS custom property on `:root` in px (rem/px values).
  * Falls back when there is no DOM / stylesheet (SSR, jsdom).
  */
 export declare function readCssLengthPx(name: string, fallbackPx: number): number;
-/** Gap between anchor and floating panel: `--prime-panel-offset`. */
-export declare function getPanelOffsetPx(): number;
 /** Minimum distance from a floating panel to the viewport edge: `--prime-space-2`. */
 export declare function getViewportPadPx(): number;
 export type ComputeFloatingOptions = {
-    preferredSide: PositionSide;
+    side: PositionSide;
     align: PositionAlign;
+    /** Gap between the anchor and the layer (px). */
     offset: number;
-    /** Отступ от краёв вьюпорта (px); по умолчанию 8. */
+    /** Minimum distance from the viewport edge (px); 8 by default. */
     viewportPad?: number;
+    /** Flip to the opposite side (and edge) when the layer does not fit. */
     flip: boolean;
-    matchTriggerMinWidth: boolean;
+    matchAnchorWidth: boolean;
+    /** Closest the arrow centre may come to a layer corner; computes `arrow` when set. */
+    arrowInset?: number;
 };
 export type ComputedFloatPosition = {
     top: number;
     left: number;
-    resolvedSide: PositionSide;
+    /** The side after flipping. */
+    side: PositionSide;
     minWidth?: number;
-    /** Ширина вьюпорта минус поля с обеих сторон — панель никогда не шире экрана. */
+    /** Room across: the viewport minus gutters (top / bottom) or the room on the side (left / right). */
     maxWidth: number;
-    /** Доступная высота под контент (px), со стороны открытия. */
-    maxHeight?: number;
+    /** Room along the side the layer opened on (px). */
+    maxHeight: number;
+    /** Arrow centre along the edge facing the anchor (px from the layer's start). */
+    arrow?: number;
 };
-/** Якорь + размеры слоя + вьюпорт; при flip — сторона с большим запасом / куда влезает контент. */
-export declare function computeFloatingPosition(anchorRect: DOMRectReadOnly, contentW: number, contentH: number, vw: number, vh: number, opts: ComputeFloatingOptions): ComputedFloatPosition;
-type UsePositionResult = {
-    resolvedSide: PositionSide;
-    update: () => PositionUpdateMeta | undefined;
+/**
+ * Places a layer on `side` of the anchor: flips to the opposite side when it does not fit there
+ * and does on the other (or has more room), aligns it along the cross axis (flipping the edge when
+ * it overflows), keeps it inside the viewport and, with `arrowInset`, points an arrow at the
+ * anchor's centre without leaving the layer's straight edge.
+ */
+export declare function computeFloatingPosition(anchor: Pick<DOMRectReadOnly, "top" | "left" | "right" | "bottom" | "width" | "height">, contentW: number, contentH: number, vw: number, vh: number, opts: ComputeFloatingOptions): ComputedFloatPosition;
+export type PositionOptions = {
+    side?: PositionSide;
+    align?: PositionAlign;
+    /** Write the anchor width to `--float-min-w` (the panel CSS decides min or exact width). */
+    matchAnchorWidth?: boolean;
+    /** Token of the gap between anchor and layer. Default `--prime-panel-offset`. */
+    offsetToken?: string;
+    /** Closest the arrow may come to a layer corner, read from the layer; writes `--float-arrow`. */
+    arrowInset?: (layer: HTMLElement) => number;
 };
-export declare function usePosition(anchorRef: React.RefObject<HTMLElement | null>, contentRef: React.RefObject<HTMLElement | null>, options?: UsePositionOptions): UsePositionResult;
-export {};
-//# sourceMappingURL=usePosition.d.ts.map
+export type Position = {
+    /** The side the layer opened on (after flipping). */
+    side: PositionSide;
+    /** Attach to the layer element (merge with other refs): positioning starts once it is in the DOM. */
+    attachLayer: (node: HTMLElement | null) => void;
+};
+/**
+ * Places a floating layer (`position: fixed`) next to its anchor and follows the anchor while
+ * `enabled`: before paint, again on the next frame (fonts), and on window resize, scroll of any
+ * scrolling ancestor of the anchor, visual-viewport changes and size changes of the layer or the
+ * anchor. Shared by every anchored layer (Popover, Dropdown, Select, TagSelect, Tooltip). A
+ * portaled layer reaches the DOM one commit after its owner, so the subscription waits for
+ * `attachLayer` instead of reading the ref too early.
+ */
+export declare function usePosition(enabled: boolean, anchorRef: React.RefObject<HTMLElement | null>, layerRef: React.RefObject<HTMLElement | null>, { side: preferredSide, align, matchAnchorWidth, offsetToken, arrowInset, }?: PositionOptions): Position;

package/dist/hooks/usePresence.d.ts

@@ -28,4 +28,3 @@ export type Presence = {
  * `prefers-reduced-motion: reduce`. Shared by every floating layer (foundation §7 "Overlay contract").
  */
 export declare function usePresence(open: boolean, options?: UsePresenceOptions): Presence;
-//# sourceMappingURL=usePresence.d.ts.map

package/dist/hooks/useScrollLock.d.ts

@@ -1,8 +1,6 @@
 /**
- * Locks body scroll when enabled. Supports multiple concurrent callers via
- * a reference-counted lock — the last caller to unmount restores scroll.
- * Compensates for scrollbar width to prevent layout shift.
- * Shared by modal/drawer overlays.
+ * Locks document scroll while enabled. Reference-counted: nested modal layers share one lock and
+ * the last one restores it. The scrollbar width is added to the body's right padding, so the page
+ * does not shift. Part of `useModalLayer`.
  */
 export declare function useScrollLock(enabled: boolean): void;
-//# sourceMappingURL=useScrollLock.d.ts.map

package/dist/hooks/useStateSwap.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+/**
+ * Region state transitions (loading → data → empty → error, foundation §7 rule 8): `true` once
+ * `state` has differed from its first value. The content of every later state plays the swap-in
+ * fade (`src/internal/swapMotion.module.css`); the first render stays still. Shared by Crossfade
+ * and DataTable's body.
+ */
+export declare function useStateSwap(state: React.Key): boolean;

package/dist/hooks/useSwipeDismiss.d.ts

@@ -0,0 +1,34 @@
+import * as React from "react";
+/** The direction a panel leaves in: toward the screen edge it came from. */
+export type SwipeDirection = "down" | "left" | "right";
+export type UseSwipeDismissOptions = {
+    enabled: boolean;
+    direction: SwipeDirection;
+    onDismiss: () => void;
+    /** Selector of the zones a drag starts from by any pointer: the grab handle, the header. */
+    handle: string;
+    /**
+     * A touch drag may also start anywhere else in the panel (side drawers, whose content scrolls
+     * across the swipe axis). Mouse and pen drags start from `handle` only, so text stays selectable.
+     */
+    touchAnywhere?: boolean;
+    /**
+     * How far out the panel is, 0 (at rest) … 1 (off its edge), on every move and on release (0 back,
+     * 1 out) — for parts that follow the drag, such as the scrim's opacity.
+     */
+    onProgress?: (progress: number) => void;
+};
+/** The custom property the panel CSS maps onto its own axis (`transform`). */
+export declare const SWIPE_OFFSET_VAR = "--swipe-offset";
+/**
+ * Swipe-to-close for a panel at a screen edge (Drawer, a bottom sheet). Attach `onPointerDown` to
+ * the panel: a drag from `handle` (or, with `touchAnywhere`, any touch) along the closing axis 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 size 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 drag across the axis is left to scrolling. The gesture is an extra
+ * way out: the panel keeps its close button and Escape (WCAG 2.5.7).
+ */
+export declare function useSwipeDismiss({ enabled, direction, onDismiss, handle, touchAnywhere, onProgress, }: UseSwipeDismissOptions): {
+    onPointerDown: (event: React.PointerEvent<HTMLElement>) => void;
+};

package/dist/icons/Icon.d.ts

@@ -1,13 +1,30 @@
 import type { LucideProps } from "lucide-react";
-import * as React from "react";
+import type * as React from "react";
 import type { ControlSize, TextTone } from "@/internal/states";
-type BaseIconProps = Omit<LucideProps, "size" | "color"> & {
+import { type IconName } from "./registry";
+type Glyph = React.ComponentType<LucideProps>;
+/** Props of an icon made by `createIcon`: everything `<Icon>` takes except `name`. */
+export type DomainIconProps = Omit<LucideProps, "size" | "color" | "ref"> & {
+    /**
+     * Explicit size on the icon scale (xs 14 · s 16 · m 20 · l 24 · xl 32). Without it the icon
+     * follows its host: the host's `--prime-icon-size`, else the nearest control tier, else 16.
+     */
     size?: ControlSize;
     /** Icon color; `default` inherits `currentColor`. */
     tone?: TextTone;
+    ref?: React.Ref<SVGSVGElement>;
 };
-type IconComponent = React.ComponentType<LucideProps>;
-declare function createIcon(IconGlyph: IconComponent): React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export type { BaseIconProps };
-export { createIcon };
-//# sourceMappingURL=Icon.d.ts.map
+export type IconProps = DomainIconProps & {
+    name: IconName;
+};
+/** A kit glyph by name: decorative (`aria-hidden`), sized and toned like every kit icon. */
+export declare function Icon({ name, ...rest }: IconProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Turns a domain glyph the kit lacks (any lucide-react icon) into a kit icon with the same
+ * `size`, `tone` and host sizing as `<Icon>`. Call it once at module level.
+ */
+export declare function createIcon(glyph: Glyph): {
+    (props: DomainIconProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/icons/index.d.ts

@@ -1,44 +1,2 @@
-import * as React from "react";
-import type { BaseIconProps } from "./Icon";
-export declare const IconCheck: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconChevronRight: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconCircleDot: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconNavItemDot: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconClose: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconCloudUpload: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconCopy: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconDownload: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconMail: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconEye: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconEyeOff: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconHouse: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconLayoutGrid: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconLock: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconMoon: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconPipette: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconSearch: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const IconSun: React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export declare const iconRegistry: {
-    readonly "nav.chevronRight": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "nav.home": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "nav.itemDot": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "nav.layoutGrid": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "action.close": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "action.copy": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "action.eyedropper": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "action.search": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "action.upload": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "field.email": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "field.password.show": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "field.password.hide": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "status.locked": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "theme.dark": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-    readonly "theme.light": React.ForwardRefExoticComponent<Omit<BaseIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-};
-export type IconName = keyof typeof iconRegistry;
-export type NamedIconProps = BaseIconProps & {
-    name: IconName;
-};
-export declare const Icon: React.ForwardRefExoticComponent<Omit<NamedIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
-export type { BaseIconProps } from "./Icon";
-//# sourceMappingURL=index.d.ts.map
+export { createIcon, type DomainIconProps, Icon, type IconProps } from "./Icon";
+export type { IconName } from "./registry";

package/dist/icons/registry.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Named kit glyphs: `<Icon name="…" />` renders one of these. Components and examples take glyphs
+ * from here instead of importing `lucide-react` or drawing their own `<svg>`; a domain glyph the
+ * kit lacks goes through `createIcon`.
+ */
+export declare const iconRegistry: {
+    readonly "nav.chevronDown": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.chevronLeft": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.chevronRight": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.chevronUp": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.chevronsLeft": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.chevronsUpDown": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.dashboard": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.home": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.itemDot": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.layoutGrid": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.menu": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.sidebarCollapse": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "nav.sidebarExpand": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.add": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.check": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.close": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.copy": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.delete": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.download": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.drag": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.externalLink": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.eyedropper": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.filter": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.login": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.logout": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.more": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.refresh": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.remove": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.search": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.send": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.settings": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "action.upload": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "field.calendar": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "field.email": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "field.password.show": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "field.password.hide": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "format.bold": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "format.italic": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "format.link": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "format.list": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "format.underline": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.activity": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.bell": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.book": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.cart": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.chart": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.document": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.image": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.inbox": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.key": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.message": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.package": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.receipt": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.rocket": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.storage": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.tasks": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.truck": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.user": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.users": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "object.wallet": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "sort.ascending": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "sort.descending": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "sort.none": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "status.danger": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "status.emailSent": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "status.info": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "status.locked": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "status.offline": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "status.success": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "status.warning": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "theme.dark": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "theme.light": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "view.code": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "view.preview": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "viewport.desktop": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "viewport.mobile": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    readonly "viewport.tablet": import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+};
+export type IconName = keyof typeof iconRegistry;