@octaviaflow/core 3.0.18-beta.0 → 3.0.18

package/dist/components/ToolCard/ToolCard.d.ts

@@ -1,25 +1,27 @@
-import type { ReactNode } from "react";
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
 export type ToolCategory = "search" | "database" | "web" | "code" | "file" | "api" | "ai" | "custom";
-export interface ToolCardProps {
+type DivPropsBase = Omit<ComponentPropsWithoutRef<"div">, "onChange" | "onToggle" | "children" | "role" | "tabIndex">;
+export interface ToolCardProps extends DivPropsBase {
     name: ReactNode;
     description?: ReactNode;
     icon?: ReactNode;
     category?: ToolCategory;
-    /** When true, renders a switch on the right. */
+    /** When set, renders a switch on the right reflecting this value. */
     enabled?: boolean;
     onToggle?: (next: boolean) => void;
-    /** Hide the toggle entirely. */
+    /** Hide the toggle entirely (use for read-only registry views). */
     hideToggle?: boolean;
-    /** Show "new" badge. */
+    /** Show "NEW" badge next to the name. */
     isNew?: boolean;
-    /** Disabled state (e.g. waiting on auth). */
+    /** Disabled state (e.g. waiting on auth). Disables switch + click. */
     disabled?: boolean;
-    /** Required permissions / auth status. */
+    /** Right-aligned secondary text (e.g. "Connect Slack →"). */
     badge?: ReactNode;
-    /** Compact / dense variant. */
+    /** Compact / dense vertical padding. */
     compact?: boolean;
+    /** Whole-card click handler — makes the card a `role="button"`. */
     onClick?: () => void;
-    className?: string;
 }
-export declare function ToolCard({ name, description, icon, category, enabled, onToggle, hideToggle, isNew, disabled, badge, compact, onClick, className, }: ToolCardProps): import("react/jsx-runtime").JSX.Element;
+export declare const ToolCard: import("react").ForwardRefExoticComponent<ToolCardProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
 //# sourceMappingURL=ToolCard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ToolCard.d.ts","sourceRoot":"","sources":["../../../src/components/ToolCard/ToolCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,UAAU,GACV,KAAK,GACL,MAAM,GACN,MAAM,GACN,KAAK,GACL,IAAI,GACJ,QAAQ,CAAC;AAEb,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,gCAAgC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wBAAwB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6ED,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,WAAW,EACX,IAAI,EACJ,QAAmB,EACnB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,KAAK,EACL,QAAQ,EACR,KAAK,EACL,OAAO,EACP,OAAO,EACP,SAAS,GACV,EAAE,aAAa,2CA+Cf"}
+{"version":3,"file":"ToolCard.d.ts","sourceRoot":"","sources":["../../../src/components/ToolCard/ToolCard.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAaf,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,UAAU,GACV,KAAK,GACL,MAAM,GACN,MAAM,GACN,KAAK,GACL,IAAI,GACJ,QAAQ,CAAC;AAKb,KAAK,YAAY,GAAG,IAAI,CACtB,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAC3D,CAAC;AAEF,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAaD,eAAO,MAAM,QAAQ,0GA+HpB,CAAC"}

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

@@ -1,11 +1,22 @@
 import { type ReactElement, type ReactNode } from "react";
+export type TooltipPosition = "top" | "bottom" | "left" | "right";
 export interface TooltipProps {
     content: ReactNode;
-    position?: "top" | "bottom" | "left" | "right";
+    /** Preferred position. May flip to the opposite side if it would overflow. */
+    position?: TooltipPosition;
+    /** Open-delay in milliseconds (react-aria's warmup). Defaults to 200. */
     delay?: number;
+    /** Pixel gap between trigger and tooltip. Defaults to 8. */
     offset?: number;
+    /** Suppress the tooltip entirely without removing the trigger from the tree. */
+    disabled?: boolean;
+    /** Stable id for the tooltip DOM node — useful for aria-describedby tests. */
+    id?: string;
     children: ReactElement;
     className?: string;
 }
-export declare function Tooltip({ content, position, delay, offset, children, className, }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export declare function Tooltip({ content, position, delay, offset, disabled, id: providedId, children, className, }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Tooltip {
+    var displayName: string;
+}
 //# sourceMappingURL=Tooltip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/Tooltip/Tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAMf,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4HD,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,QAAgB,EAChB,KAAW,EACX,MAAU,EACV,QAAQ,EACR,SAAS,GACV,EAAE,YAAY,2CAqBd"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/Tooltip/Tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,SAAS,EASf,MAAM,OAAO,CAAC;AAMf,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+ND,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,QAAgB,EAChB,KAAW,EACX,MAAU,EACV,QAAgB,EAChB,EAAE,EAAE,UAAU,EACd,QAAQ,EACR,SAAS,GACV,EAAE,YAAY,2CAmEd;yBA5Ee,OAAO"}

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

@@ -1,2 +1,2 @@
-export { Tooltip, type TooltipProps } from "./Tooltip";
+export { Tooltip, type TooltipPosition, type TooltipProps, } from "./Tooltip";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Tooltip/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC"}

package/dist/components/TraceStep/TraceStep.d.ts

@@ -1,7 +1,13 @@
-import { type ReactNode } from "react";
-export type TraceStepKind = "thought" | "tool" | "input" | "output" | "error";
-export type TraceStepStatus = "running" | "success" | "failed" | "pending" | "idle";
-export interface TraceStepProps {
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+/** Built-in kinds. Widened with `(string & {})` so consumers can introduce
+ *  their own — supply a matching icon via `kindIcons` and target the
+ *  generated `ods-trace-step--{kind}` class in their own CSS. */
+export type TraceStepKind = "thought" | "tool" | "input" | "output" | "error" | (string & {});
+/** Built-in statuses. Also widened — custom statuses get
+ *  `ods-trace-step--status-{value}` for CSS targeting. */
+export type TraceStepStatus = "running" | "success" | "failed" | "pending" | "idle" | (string & {});
+type DivPropsBase = Omit<ComponentPropsWithoutRef<"div">, "onChange" | "children" | "title" | "defaultValue">;
+export interface TraceStepProps extends DivPropsBase {
     /** Numeric step index. */
     index?: number;
     /** Kind of step — drives the icon + color. */
@@ -16,15 +22,38 @@ export interface TraceStepProps {
     duration?: string;
     /** Token count or cost annotation. */
     tokens?: number;
-    /** Body content — collapsed by default. Usually a JsonViewer or CodeEditor or text. */
+    /** Body content — collapsed by default. */
     children?: ReactNode;
-    /** Open by default. */
+    /** Initial open state (uncontrolled). */
     defaultOpen?: boolean;
+    /** Controlled open state. When provided, `onOpenChange` must update it. */
+    open?: boolean;
+    /** Fires whenever the user toggles the head (open ↔ closed). */
+    onOpenChange?: (open: boolean) => void;
     /** Hide the connecting vertical rail at the left. */
     hideRail?: boolean;
     /** Last step in a chain (skips the trailing rail). */
     isLast?: boolean;
-    className?: string;
+    /**
+     * One-off icon override for THIS step. Wins over `kindIcons`. Useful
+     * when a single step needs a brand glyph (e.g. "Slack" instead of
+     * the generic tool icon).
+     */
+    icon?: ReactNode;
+    /**
+     * Per-kind icon overrides — including custom kinds. Built-ins not
+     * present in this map fall back to the default glyph.
+     *
+     *   <TraceStep kind="my-custom" kindIcons={{ "my-custom": <X /> }} ... />
+     */
+    kindIcons?: Partial<Record<string, ReactNode>>;
+    /**
+     * Disable the open/close height animation (useful for SSR snapshots,
+     * very long trace lists, or jurisdictions where reduced-motion is
+     * enforced upstream).
+     */
+    disableAnimation?: boolean;
 }
-export declare function TraceStep({ index, kind, status, title, tool, duration, tokens, children, defaultOpen, hideRail, isLast, className, }: TraceStepProps): import("react/jsx-runtime").JSX.Element;
+export declare const TraceStep: import("react").ForwardRefExoticComponent<TraceStepProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};
 //# sourceMappingURL=TraceStep.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TraceStep.d.ts","sourceRoot":"","sources":["../../../src/components/TraceStep/TraceStep.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAGjD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oDAAoD;IACpD,KAAK,EAAE,SAAS,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uBAAuB;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsDD,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,IAAgB,EAChB,MAAe,EACf,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,WAAmB,EACnB,QAAgB,EAChB,MAAc,EACd,SAAS,GACV,EAAE,cAAc,2CAkGhB"}
+{"version":3,"file":"TraceStep.d.ts","sourceRoot":"","sources":["../../../src/components/TraceStep/TraceStep.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAE7B,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAYf;;iEAEiE;AACjE,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GAEP,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;0DAC0D;AAC1D,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,MAAM,GAEN,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,KAAK,YAAY,GAAG,IAAI,CACtB,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CACnD,CAAC;AAEF,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oDAAoD;IACpD,KAAK,EAAE,SAAS,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAaD,eAAO,MAAM,SAAS,2GAmLrB,CAAC"}

package/dist/components/TreeView/TreeView.d.ts

@@ -0,0 +1,54 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export interface TreeNode {
+    /** Stable identifier (unique within the tree). */
+    id: string;
+    /** Display label. */
+    label: ReactNode;
+    /** Optional leading icon. Distinct icons for expanded / collapsed
+     * folders can be expressed via `iconExpanded`. */
+    icon?: ReactNode;
+    /** Override icon when expanded (e.g. open-folder glyph). */
+    iconExpanded?: ReactNode;
+    /** Optional trailing slot (badge, action, count). */
+    trailing?: ReactNode;
+    /** Children. Pass `undefined` for an unloaded branch (will trigger
+     * `onLoadChildren` on first expand) vs `[]` for a known-empty leaf. */
+    children?: TreeNode[];
+    /** Disable interaction for this node. */
+    disabled?: boolean;
+    /**
+     * Force-render as a non-leaf even when `children` is empty / undefined.
+     * Useful for branches whose children will be lazy-loaded.
+     */
+    isBranch?: boolean;
+}
+export interface TreeViewProps extends Omit<ComponentPropsWithoutRef<"ul">, "onSelect" | "children"> {
+    /** Tree data. */
+    nodes: TreeNode[];
+    /** Controlled selected node id. */
+    selectedId?: string;
+    /** Uncontrolled default selected node id. */
+    defaultSelectedId?: string;
+    /** Fires when the user selects a node. */
+    onSelect?: (node: TreeNode) => void;
+    /** Controlled set of expanded node ids. */
+    expandedIds?: Set<string>;
+    /** Uncontrolled initial expanded ids. */
+    defaultExpandedIds?: string[];
+    /** Fires when a node is expanded / collapsed. */
+    onExpandedChange?: (expandedIds: Set<string>) => void;
+    /**
+     * Lazy-loader fired once when a branch with `children === undefined`
+     * is expanded. Returns the children to render. While the promise
+     * resolves, a "Loading…" placeholder shows in place of the children.
+     */
+    onLoadChildren?: (node: TreeNode) => Promise<TreeNode[]>;
+    /** Visual size. Default `"md"`. */
+    size?: "sm" | "md" | "lg";
+    /** Show indent guide lines. Default `true`. */
+    showGuides?: boolean;
+    /** Disable the entire tree. */
+    disabled?: boolean;
+}
+export declare const TreeView: import("react").ForwardRefExoticComponent<TreeViewProps & import("react").RefAttributes<HTMLUListElement>>;
+//# sourceMappingURL=TreeView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../src/components/TreeView/TreeView.tsx"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,wBAAwB,EAI7B,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAwBf,MAAM,WAAW,QAAQ;IACvB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB;sDACkD;IAClD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;2EACuE;IACvE,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,IAAI,CAAC,EAC9B,UAAU,GAAG,UAAU,CACxB;IACD,iBAAiB;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACtD;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,mCAAmC;IACnC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+BD,eAAO,MAAM,QAAQ,4GAiWpB,CAAC"}

package/dist/components/TreeView/index.d.ts

@@ -0,0 +1,2 @@
+export { TreeView, type TreeNode, type TreeViewProps, } from "./TreeView";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/TreeView/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TreeView/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}

package/dist/components/UserCard/UserCard.d.ts

@@ -1,16 +1,49 @@
-import type { ReactNode } from "react";
+import { type ComponentPropsWithoutRef, type MouseEvent, type ReactNode } from "react";
+import { type AvatarProps, type AvatarStatus } from "../Avatar";
+import { type CardRadius } from "../Card";
 export interface UserCardStat {
     label: ReactNode;
     value: ReactNode;
 }
-export interface UserCardProps {
+export type UserCardOrientation = "vertical" | "horizontal";
+export interface UserCardProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "role" | "onChange" | "onClick" | "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart"> {
+    /** User name (display label). */
     name: ReactNode;
+    /** Heading level for the name. Default `"h3"`. */
+    nameAs?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    /** Job title / role / handle, rendered below the name. */
     role?: ReactNode;
-    avatar?: ReactNode;
+    /**
+     * Structured Avatar fields — forwarded to the polished Avatar
+     * primitive. Pass `{ src, initials, alt }`; if omitted, an initial
+     * is derived from `name` automatically.
+     */
+    avatar?: Pick<AvatarProps, "src" | "initials" | "alt">;
+    /**
+     * Legacy raw-node avatar (e.g. <img />). Renders into the legacy
+     * circle. Prefer `avatar` for new code.
+     */
+    avatarNode?: ReactNode;
+    /** Legacy explicit initial character. Prefer `avatar.initials`. */
     initial?: ReactNode;
+    /** Avatar status dot (online / offline / busy / away). */
+    status?: AvatarStatus;
+    /** Optional secondary line under role — email, handle, location. */
+    meta?: ReactNode;
+    /** Stat row below the name + role. */
     stats?: UserCardStat[];
+    /** Action slot at the bottom (Button, link, etc.). */
     action?: ReactNode;
-    className?: string;
+    /** Layout — vertical (centered, default) or horizontal (left-aligned row). */
+    orientation?: UserCardOrientation;
+    /** Whole-card click handler. */
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
+    /** Renders as <a> via Card.asChild when href is provided. */
+    href?: string;
+    /** Disable interaction. */
+    disabled?: boolean;
+    /** Card corner radius (passes through). */
+    radius?: CardRadius;
 }
-export declare function UserCard({ name, role, avatar, initial, stats, action, className }: UserCardProps): import("react/jsx-runtime").JSX.Element;
+export declare const UserCard: import("react").ForwardRefExoticComponent<UserCardProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=UserCard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"UserCard.d.ts","sourceRoot":"","sources":["../../../src/components/UserCard/UserCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,aAAa,2CAuBhG"}
+{"version":3,"file":"UserCard.d.ts","sourceRoot":"","sources":["../../../src/components/UserCard/UserCard.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAE7B,KAAK,UAAU,EACf,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAU,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAUhD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE5D,MAAM,WAAW,aACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,KAAK,CAAC,EAG7B,OAAO,GACP,MAAM,GACN,UAAU,GACV,SAAS,GACT,QAAQ,GACR,aAAa,GACb,WAAW,GACX,kBAAkB,CACrB;IACD,iCAAiC;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjD,0DAA0D;IAC1D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC;IACvD;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,sDAAsD;IACtD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAClD,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,eAAO,MAAM,QAAQ,0GAiJpB,CAAC"}

package/dist/components/XmlViewer/XmlViewer.d.ts

@@ -1,22 +1,27 @@
-import { type ReactNode } from "react";
-export interface XmlViewerProps {
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export interface XmlViewerProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "children"> {
     /** Raw XML string. */
     data: string;
-    /** Initially expand to N levels deep. Default 2. */
+    /** Initially expand to N levels deep. Default 2. Use `Infinity` to expand everything. */
     defaultExpandDepth?: number;
     /** Show attributes inline (vs. collapsed). Default true. */
     showAttributes?: boolean;
+    /** Show a copy button on hover for each element (copies the serialized subtree). */
+    copyable?: boolean;
     /** Optional title. */
     title?: ReactNode;
     /** Optional status pill next to title. */
     status?: ReactNode;
     /** Maximum length for text node display. */
     truncateAt?: number;
-    className?: string;
+    /** Fixed body height — number → pixels, string → any CSS length. */
+    height?: number | string;
+    /** Upper bound on body height; ignored when `height` is set. */
+    maxHeight?: number | string;
 }
 /**
  * Read-only XML viewer with collapsible elements, attribute chips, and
- * type-tinted text/CDATA/comment nodes.
+ * type-tinted text / CDATA / comment / processing-instruction nodes.
  */
-export declare function XmlViewer({ data, defaultExpandDepth, showAttributes, title, status, truncateAt, className, }: XmlViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare const XmlViewer: import("react").ForwardRefExoticComponent<XmlViewerProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=XmlViewer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"XmlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/XmlViewer/XmlViewer.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAG1D,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2DD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,kBAAsB,EACtB,cAAqB,EACrB,KAAK,EACL,MAAM,EACN,UAAgB,EAChB,SAAS,GACV,EAAE,cAAc,2CA+BhB"}
+{"version":3,"file":"XmlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/XmlViewer/XmlViewer.tsx"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAOf,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnE,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAgGD;;;GAGG;AACH,eAAO,MAAM,SAAS,2GA4ErB,CAAC"}

package/dist/components/YamlViewer/YamlViewer.d.ts

@@ -1,20 +1,27 @@
-import { type ReactNode } from "react";
-export interface YamlViewerProps {
-    /** Raw YAML string OR a parsed object/array (will be auto-stringified). */
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export interface YamlViewerProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "children"> {
+    /** Raw YAML string OR a parsed object/array (auto-stringified to YAML). */
     data: string | unknown;
-    /** Initially expand to N levels deep. Default 2. */
+    /** Initially expand to N levels deep. Default 99 (fully expanded). */
     defaultExpandDepth?: number;
     /** Show line numbers at the gutter. Default true. */
     showLineNumbers?: boolean;
+    /** Show a copy-document button in the header. */
+    copyable?: boolean;
+    /** Wrap long values instead of truncating off-screen. Default false. */
+    wrap?: boolean;
     /** Optional title. */
     title?: ReactNode;
     /** Optional status pill next to title. */
     status?: ReactNode;
-    className?: string;
+    /** Fixed body height — number → pixels, string → any CSS length. */
+    height?: number | string;
+    /** Upper bound on body height; ignored when `height` is set. */
+    maxHeight?: number | string;
 }
 /**
  * Read-only YAML viewer — keys highlighted, values type-tinted, comments
  * grayed, optional gutter line numbers, foldable blocks.
  */
-export declare function YamlViewer({ data, defaultExpandDepth, showLineNumbers, title, status, className, }: YamlViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare const YamlViewer: import("react").ForwardRefExoticComponent<YamlViewerProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=YamlViewer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"YamlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/YamlViewer/YamlViewer.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8JD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,kBAAuB,EACvB,eAAsB,EACtB,KAAK,EACL,MAAM,EACN,SAAS,GACV,EAAE,eAAe,2CA6JjB"}
+{"version":3,"file":"YamlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/YamlViewer/YamlViewer.tsx"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAOf,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnE,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AA4KD;;;GAGG;AACH,eAAO,MAAM,UAAU,4GA6OtB,CAAC"}

package/dist/hooks/useBanner.d.ts

@@ -0,0 +1,27 @@
+export interface UseBannerOptions {
+    /** Initial visibility. Defaults to `false`. */
+    defaultOpen?: boolean;
+    /** Auto-hide the banner this many milliseconds after `show()`.
+     * Set to `0` / undefined / `Infinity` to keep it open until `hide()`. */
+    autoDismissAfter?: number;
+    /** Fires whenever the banner transitions from open → closed (auto OR
+     * user-initiated). Use for analytics or downstream cleanup. */
+    onDismiss?: () => void;
+}
+export interface UseBannerReturn {
+    /** Current open state. */
+    open: boolean;
+    /** Open the banner. Resets any pending auto-dismiss timer. */
+    show: () => void;
+    /** Close the banner and fire `onDismiss`. */
+    hide: () => void;
+    /** Toggle open ⇄ closed. */
+    toggle: () => void;
+    /** Spread directly onto `<Banner>` — wires `open` + `onDismiss`. */
+    bannerProps: {
+        open: boolean;
+        onDismiss: () => void;
+    };
+}
+export declare function useBanner(options?: UseBannerOptions): UseBannerReturn;
+//# sourceMappingURL=useBanner.d.ts.map

package/dist/hooks/useBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBanner.d.ts","sourceRoot":"","sources":["../../src/hooks/useBanner.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;6EACyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;mEAC+D;IAC/D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,oEAAoE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,EAAE,MAAM,IAAI,CAAC;KACvB,CAAC;CACH;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA6DzE"}

package/dist/hooks/useBreakpoint.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Canonical v1 breakpoint names plus the "base" sentinel for viewports
+ * narrower than --ods-breakpoint-sm.
+ */
+export type BreakpointName = "base" | "sm" | "md" | "lg" | "xl" | "2xl";
+/**
+ * Return the largest currently-matching breakpoint name. SSR-safe: returns
+ * `"base"` on the server and during the first client render, then updates
+ * to the real match after hydration.
+ *
+ * The matching follows the standard mobile-first cascade: `useBreakpoint()`
+ * returns the LARGEST breakpoint whose min-width is satisfied. A viewport
+ * of 1100 px returns `"lg"` (1024 satisfied, 1280 not).
+ *
+ * @example
+ *   const bp = useBreakpoint();
+ *   if (bp === "base" || bp === "sm") return <MobileNav />;
+ *   return <DesktopNav />;
+ */
+export declare function useBreakpoint(): BreakpointName;
+/**
+ * Numeric min-width (in px) for a v1 breakpoint name. Useful when you need
+ * to compose your own media queries or compare widths imperatively.
+ *
+ * @example
+ *   const minPx = breakpointMinWidth("md"); // 768
+ */
+export declare function breakpointMinWidth(name: Exclude<BreakpointName, "base">): number;
+//# sourceMappingURL=useBreakpoint.d.ts.map

package/dist/hooks/useBreakpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBreakpoint.d.ts","sourceRoot":"","sources":["../../src/hooks/useBreakpoint.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAmBxE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,IAAI,cAAc,CAsB9C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,MAAM,CAEhF"}

package/dist/hooks/useCallout.d.ts

@@ -0,0 +1,32 @@
+export interface UseCalloutOptions {
+    /** Initial open state. Defaults to `true` — callouts start visible. */
+    defaultOpen?: boolean;
+    /** localStorage key (without prefix) used to persist the dismissed state.
+     * Omit for session-only behaviour. */
+    persistKey?: string;
+    /** Fires once when the callout transitions from open → dismissed. */
+    onDismiss?: () => void;
+}
+export interface UseCalloutReturn {
+    /** Current visibility — `false` after dismissal. */
+    open: boolean;
+    /** True when the callout has been dismissed (either this session or via
+     * persisted state). Convenient for `if (callout.dismissed) return null`. */
+    dismissed: boolean;
+    /** Programmatically open the callout (no-op if already open). */
+    show: () => void;
+    /** Dismiss the callout. Also writes to localStorage when `persistKey` is set. */
+    dismiss: () => void;
+    /** Toggle open ⇄ dismissed. */
+    toggle: () => void;
+    /** Clear the persisted dismissal (if any) AND re-open the callout. Use
+     * for "Show tip again" / settings reset surfaces. */
+    reset: () => void;
+    /** Spread directly onto `<Callout>` — wires `open` + `onDismiss`. */
+    calloutProps: {
+        open: boolean;
+        onDismiss: () => void;
+    };
+}
+export declare function useCallout(options?: UseCalloutOptions): UseCalloutReturn;
+//# sourceMappingURL=useCallout.d.ts.map

package/dist/hooks/useCallout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCallout.d.ts","sourceRoot":"","sources":["../../src/hooks/useCallout.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;0CACsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,IAAI,EAAE,OAAO,CAAC;IACd;gFAC4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,iFAAiF;IACjF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;yDACqD;IACrD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,qEAAqE;IACrE,YAAY,EAAE;QACZ,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,EAAE,MAAM,IAAI,CAAC;KACvB,CAAC;CACH;AAyBD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAuD5E"}

package/dist/hooks/useMediaQuery.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lower-level primitive — subscribe to a CSS media query and re-render when
+ * its match state changes. SSR-safe via useSyncExternalStore: the server
+ * snapshot is always `false`, the client snapshot reads window.matchMedia.
+ *
+ * Prefer the higher-level `useBreakpoint()` when you just need the current
+ * breakpoint name; reach for this when you need a custom query like
+ * "(prefers-color-scheme: dark)" or "(orientation: landscape)".
+ *
+ * @example
+ *   const isWide = useMediaQuery("(min-width: 1024px)");
+ *   const prefersDark = useMediaQuery("(prefers-color-scheme: dark)");
+ */
+export declare function useMediaQuery(query: string): boolean;
+//# sourceMappingURL=useMediaQuery.d.ts.map

package/dist/hooks/useMediaQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMpD"}

package/dist/hooks/usePasswordStrength.d.ts

@@ -0,0 +1,37 @@
+export interface PasswordRule {
+    /** Stable id — keyed in the result for React rendering and useful for
+     *  driving per-rule a11y associations. */
+    id: string;
+    /** Human-readable description ("At least 8 characters"). Surfaced in
+     *  the PasswordInput requirements checklist. */
+    label: string;
+    /** Regex (preferred) or predicate function. Regexes are tested with
+     *  `.test(value)`; predicates receive the raw value. */
+    test: RegExp | ((value: string) => boolean);
+}
+export interface PasswordRuleResult {
+    id: string;
+    label: string;
+    passed: boolean;
+}
+export type PasswordStrengthScore = 0 | 1 | 2 | 3 | 4;
+export interface PasswordStrengthResult {
+    /** 0–4, derived from `passed / total` (ratio-scaled). 0 = very weak,
+     *  4 = very strong. */
+    score: PasswordStrengthScore;
+    /** Per-rule pass/fail in the order rules were supplied. */
+    rules: PasswordRuleResult[];
+    /** Count of rules that passed. */
+    passed: number;
+    /** Total rules evaluated. */
+    total: number;
+    /** True iff every rule passed (or the rule set is empty — vacuously
+     *  satisfied; consumers should usually require a non-empty rule set). */
+    isValid: boolean;
+}
+/** Reasonable starter rule set — 8-char minimum + character-class diversity.
+ *  Consumers should override for any compliance regime (passphrases,
+ *  banking, etc.). */
+export declare const DEFAULT_PASSWORD_RULES: PasswordRule[];
+export declare function usePasswordStrength(value: string, rules?: PasswordRule[]): PasswordStrengthResult;
+//# sourceMappingURL=usePasswordStrength.d.ts.map

package/dist/hooks/usePasswordStrength.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePasswordStrength.d.ts","sourceRoot":"","sources":["../../src/hooks/usePasswordStrength.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,YAAY;IAC3B;8CAC0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX;oDACgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd;4DACwD;IACxD,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC;2BACuB;IACvB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,2DAA2D;IAC3D,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd;6EACyE;IACzE,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;sBAEsB;AACtB,eAAO,MAAM,sBAAsB,EAAE,YAAY,EAKhD,CAAC;AAMF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,YAAY,EAA2B,GAC7C,sBAAsB,CAkBxB"}

package/dist/hooks/useRating.d.ts

@@ -0,0 +1,51 @@
+export interface UseRatingOptions {
+    /** Controlled value — when set, the hook becomes a pass-through. */
+    value?: number;
+    /** Uncontrolled seed. Default 0. */
+    defaultValue?: number;
+    /** Upper bound. Default 5. */
+    max?: number;
+    /** Step size (1 = whole, 0.5 = half-stars). Default 1. */
+    step?: number;
+    /** Fires after each successful change. */
+    onChange?: (value: number) => void;
+}
+export interface UseRatingReturn {
+    value: number;
+    set: (value: number) => void;
+    increment: () => void;
+    decrement: () => void;
+    reset: () => void;
+    /** Ready-to-spread props for `<Rating>`. */
+    ratingProps: {
+        value: number;
+        onChange: (value: number) => void;
+    };
+}
+export declare function useRating({ value: controlled, defaultValue, max, step, onChange, }?: UseRatingOptions): UseRatingReturn;
+export type BinaryRatingValue = "up" | "down" | null;
+export interface UseBinaryRatingOptions {
+    value?: BinaryRatingValue;
+    defaultValue?: BinaryRatingValue;
+    onChange?: (value: BinaryRatingValue) => void;
+}
+export interface UseBinaryRatingReturn {
+    value: BinaryRatingValue;
+    set: (value: BinaryRatingValue) => void;
+    /** Set the rating to `"up"`. Idempotent. */
+    like: () => void;
+    /** Set the rating to `"down"`. Idempotent. */
+    dislike: () => void;
+    /** Clear the rating back to `null`. */
+    clear: () => void;
+    /** Click-on-selected-to-deselect behaviour: if `next` is already the
+     *  current value, clears; otherwise sets to `next`. */
+    toggle: (next: Exclude<BinaryRatingValue, null>) => void;
+    /** Ready-to-spread props for `<BinaryRating>`. */
+    binaryRatingProps: {
+        value: BinaryRatingValue;
+        onChange: (value: BinaryRatingValue) => void;
+    };
+}
+export declare function useBinaryRating({ value: controlled, defaultValue, onChange, }?: UseBinaryRatingOptions): UseBinaryRatingReturn;
+//# sourceMappingURL=useRating.d.ts.map

package/dist/hooks/useRating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRating.d.ts","sourceRoot":"","sources":["../../src/hooks/useRating.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4CAA4C;IAC5C,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACnE;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAK,EAAE,UAAU,EACjB,YAAgB,EAChB,GAAO,EACP,IAAQ,EACR,QAAQ,GACT,GAAE,gBAAqB,GAAG,eAAe,CA2BzC;AAcD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACxC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uCAAuC;IACvC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;2DACuD;IACvD,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;IACzD,kDAAkD;IAClD,iBAAiB,EAAE;QACjB,KAAK,EAAE,iBAAiB,CAAC;QACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;KAC9C,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EAAE,UAAU,EACjB,YAAmB,EACnB,QAAQ,GACT,GAAE,sBAA2B,GAAG,qBAAqB,CAsBrD"}