@flanksource/clicky-ui 0.2.2 → 0.2.3

package/dist/overlay/DropdownMenu.js

@@ -0,0 +1,98 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useState, useRef, useEffect } from "react";
+import { cn } from "../lib/utils.js";
+import { Button } from "../components/button.js";
+import { Icon } from "../data/Icon.js";
+import { UiChevronDown } from "../icons/components/UiChevronDown.js";
+function DropdownMenu({
+  label,
+  icon,
+  hideChevron = false,
+  variant = "outline",
+  size = "sm",
+  trigger,
+  items,
+  children,
+  align = "right",
+  title,
+  className,
+  menuClassName
+}) {
+  const [open, setOpen] = useState(false);
+  const wrapperRef = useRef(null);
+  useEffect(() => {
+    if (!open) return;
+    const onMouseDown = (e) => {
+      var _a;
+      if (!((_a = wrapperRef.current) == null ? void 0 : _a.contains(e.target))) setOpen(false);
+    };
+    const onKeyDown = (e) => {
+      if (e.key === "Escape") setOpen(false);
+    };
+    document.addEventListener("mousedown", onMouseDown);
+    document.addEventListener("keydown", onKeyDown);
+    return () => {
+      document.removeEventListener("mousedown", onMouseDown);
+      document.removeEventListener("keydown", onKeyDown);
+    };
+  }, [open]);
+  const closeMenu = () => setOpen(false);
+  const toggle = () => setOpen((v) => !v);
+  return /* @__PURE__ */ jsxs("div", { className: cn("relative inline-block", className), ref: wrapperRef, children: [
+    trigger ? /* @__PURE__ */ jsx("span", { onClick: toggle, "aria-haspopup": "menu", "aria-expanded": open, children: trigger }) : /* @__PURE__ */ jsxs(
+      Button,
+      {
+        variant,
+        size,
+        onClick: toggle,
+        title,
+        "aria-haspopup": "menu",
+        "aria-expanded": open,
+        children: [
+          icon && /* @__PURE__ */ jsx(Icon, { ...typeof icon === "string" ? { name: icon } : { icon } }),
+          label,
+          !hideChevron && /* @__PURE__ */ jsx(Icon, { icon: UiChevronDown })
+        ]
+      }
+    ),
+    open && /* @__PURE__ */ jsx(
+      "div",
+      {
+        role: "menu",
+        className: cn(
+          "absolute z-20 mt-1 min-w-[8rem] rounded-md border border-border bg-popover py-1 shadow-md",
+          align === "right" ? "right-0" : "left-0",
+          menuClassName
+        ),
+        children: children ? children(closeMenu) : items == null ? void 0 : items.map((item, i) => /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            role: "menuitem",
+            disabled: item.disabled,
+            title: item.title,
+            onClick: () => {
+              item.onSelect();
+              closeMenu();
+            },
+            className: "flex w-full items-center gap-2 px-3 py-1.5 text-left text-xs text-popover-foreground hover:bg-accent hover:text-accent-foreground disabled:pointer-events-none disabled:opacity-50",
+            children: [
+              item.icon && /* @__PURE__ */ jsx(
+                Icon,
+                {
+                  ...typeof item.icon === "string" ? { name: item.icon } : { icon: item.icon }
+                }
+              ),
+              item.label
+            ]
+          },
+          i
+        ))
+      }
+    )
+  ] });
+}
+export {
+  DropdownMenu
+};
+//# sourceMappingURL=DropdownMenu.js.map

package/dist/overlay/DropdownMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownMenu.js","sources":["../../src/overlay/DropdownMenu.tsx"],"sourcesContent":["import { useEffect, useRef, useState, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Button, type ButtonProps } from \"../components/button\";\nimport { Icon, type StaticIconComponent } from \"../data/Icon\";\nimport { UiChevronDown } from \"../icons\";\n\nexport type DropdownMenuItem = {\n  /** Visible label. */\n  label: ReactNode;\n  /** Called when the item is chosen. */\n  onSelect: () => void;\n  /** Iconify name or imported icon component rendered before the label. */\n  icon?: string | StaticIconComponent;\n  /** Browser tooltip for the item. */\n  title?: string;\n  /** Disable selection. */\n  disabled?: boolean;\n};\n\nexport type DropdownMenuProps = {\n  /** Trigger label. Ignored when `trigger` is provided. */\n  label?: ReactNode;\n  /** Icon shown before the trigger label. Ignored when `trigger` is provided. */\n  icon?: string | StaticIconComponent;\n  /** Hide the trailing chevron on the default trigger. */\n  hideChevron?: boolean;\n  /** Variant forwarded to the default Button trigger. */\n  variant?: ButtonProps[\"variant\"];\n  /** Size forwarded to the default Button trigger. */\n  size?: ButtonProps[\"size\"];\n  /** Fully custom trigger. Receives no props; the menu wraps it with open state. */\n  trigger?: ReactNode;\n  /** Declarative menu items. Provide this or `children`, not both. */\n  items?: DropdownMenuItem[];\n  /** Custom menu content. Use `closeMenu` to dismiss after a selection. */\n  children?: (closeMenu: () => void) => ReactNode;\n  /** Horizontal alignment of the menu relative to the trigger. */\n  align?: \"left\" | \"right\";\n  /** Browser tooltip / accessible label for the default trigger. */\n  title?: string;\n  /** Classes applied to the wrapper. */\n  className?: string;\n  /** Classes applied to the floating menu. */\n  menuClassName?: string;\n};\n\nexport function DropdownMenu({\n  label,\n  icon,\n  hideChevron = false,\n  variant = \"outline\",\n  size = \"sm\",\n  trigger,\n  items,\n  children,\n  align = \"right\",\n  title,\n  className,\n  menuClassName,\n}: DropdownMenuProps) {\n  const [open, setOpen] = useState(false);\n  const wrapperRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!open) return;\n    const onMouseDown = (e: MouseEvent) => {\n      if (!wrapperRef.current?.contains(e.target as Node)) setOpen(false);\n    };\n    const onKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") setOpen(false);\n    };\n    document.addEventListener(\"mousedown\", onMouseDown);\n    document.addEventListener(\"keydown\", onKeyDown);\n    return () => {\n      document.removeEventListener(\"mousedown\", onMouseDown);\n      document.removeEventListener(\"keydown\", onKeyDown);\n    };\n  }, [open]);\n\n  const closeMenu = () => setOpen(false);\n  const toggle = () => setOpen((v) => !v);\n\n  return (\n    <div className={cn(\"relative inline-block\", className)} ref={wrapperRef}>\n      {trigger ? (\n        <span onClick={toggle} aria-haspopup=\"menu\" aria-expanded={open}>\n          {trigger}\n        </span>\n      ) : (\n        <Button\n          variant={variant}\n          size={size}\n          onClick={toggle}\n          title={title}\n          aria-haspopup=\"menu\"\n          aria-expanded={open}\n        >\n          {icon && <Icon {...(typeof icon === \"string\" ? { name: icon } : { icon })} />}\n          {label}\n          {!hideChevron && <Icon icon={UiChevronDown} />}\n        </Button>\n      )}\n      {open && (\n        <div\n          role=\"menu\"\n          className={cn(\n            \"absolute z-20 mt-1 min-w-[8rem] rounded-md border border-border bg-popover py-1 shadow-md\",\n            align === \"right\" ? \"right-0\" : \"left-0\",\n            menuClassName,\n          )}\n        >\n          {children\n            ? children(closeMenu)\n            : items?.map((item, i) => (\n                <button\n                  key={i}\n                  type=\"button\"\n                  role=\"menuitem\"\n                  disabled={item.disabled}\n                  title={item.title}\n                  onClick={() => {\n                    item.onSelect();\n                    closeMenu();\n                  }}\n                  className=\"flex w-full items-center gap-2 px-3 py-1.5 text-left text-xs text-popover-foreground hover:bg-accent hover:text-accent-foreground disabled:pointer-events-none disabled:opacity-50\"\n                >\n                  {item.icon && (\n                    <Icon\n                      {...(typeof item.icon === \"string\"\n                        ? { name: item.icon }\n                        : { icon: item.icon })}\n                    />\n                  )}\n                  {item.label}\n                </button>\n              ))}\n        </div>\n      )}\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;;;;AA8CO,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,UAAU;AAAA,EACV,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AACF,GAAsB;AACpB,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AACtC,QAAM,aAAa,OAAuB,IAAI;AAE9C,YAAU,MAAM;AACd,QAAI,CAAC,KAAM;AACX,UAAM,cAAc,CAAC,MAAkB;;AACrC,UAAI,GAAC,gBAAW,YAAX,mBAAoB,SAAS,EAAE,kBAAyB,KAAK;AAAA,IACpE;AACA,UAAM,YAAY,CAAC,MAAqB;AACtC,UAAI,EAAE,QAAQ,SAAU,SAAQ,KAAK;AAAA,IACvC;AACA,aAAS,iBAAiB,aAAa,WAAW;AAClD,aAAS,iBAAiB,WAAW,SAAS;AAC9C,WAAO,MAAM;AACX,eAAS,oBAAoB,aAAa,WAAW;AACrD,eAAS,oBAAoB,WAAW,SAAS;AAAA,IACnD;AAAA,EACF,GAAG,CAAC,IAAI,CAAC;AAET,QAAM,YAAY,MAAM,QAAQ,KAAK;AACrC,QAAM,SAAS,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;AAEtC,SACE,qBAAC,SAAI,WAAW,GAAG,yBAAyB,SAAS,GAAG,KAAK,YAC1D,UAAA;AAAA,IAAA,UACC,oBAAC,UAAK,SAAS,QAAQ,iBAAc,QAAO,iBAAe,MACxD,UAAA,QAAA,CACH,IAEA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA,iBAAc;AAAA,QACd,iBAAe;AAAA,QAEd,UAAA;AAAA,UAAA,QAAQ,oBAAC,MAAA,EAAM,GAAI,OAAO,SAAS,WAAW,EAAE,MAAM,KAAA,IAAS,EAAE,KAAA,EAAK,CAAI;AAAA,UAC1E;AAAA,UACA,CAAC,eAAe,oBAAC,MAAA,EAAK,MAAM,cAAA,CAAe;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,IAG/C,QACC;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,WAAW;AAAA,UACT;AAAA,UACA,UAAU,UAAU,YAAY;AAAA,UAChC;AAAA,QAAA;AAAA,QAGD,UAAA,WACG,SAAS,SAAS,IAClB,+BAAO,IAAI,CAAC,MAAM,MAChB;AAAA,UAAC;AAAA,UAAA;AAAA,YAEC,MAAK;AAAA,YACL,MAAK;AAAA,YACL,UAAU,KAAK;AAAA,YACf,OAAO,KAAK;AAAA,YACZ,SAAS,MAAM;AACb,mBAAK,SAAA;AACL,wBAAA;AAAA,YACF;AAAA,YACA,WAAU;AAAA,YAET,UAAA;AAAA,cAAA,KAAK,QACJ;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACE,GAAI,OAAO,KAAK,SAAS,WACtB,EAAE,MAAM,KAAK,KAAA,IACb,EAAE,MAAM,KAAK,KAAA;AAAA,gBAAK;AAAA,cAAA;AAAA,cAGzB,KAAK;AAAA,YAAA;AAAA,UAAA;AAAA,UAlBD;AAAA,QAAA;AAAA,MAoBR;AAAA,IAAA;AAAA,EACP,GAEJ;AAEJ;"}

package/dist/overlay/HoverCard.cjs

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const reactDom = require("react-dom");
+const utils = require("../lib/utils.cjs");
+const GAP_PX = 6;
+const HOVER_CLOSE_DELAY_MS = 120;
+function HoverCard({
+  trigger,
+  children,
+  placement = "top",
+  delay = 0,
+  arrow = true,
+  className,
+  cardClassName
+}) {
+  const [open, setOpen] = react.useState(false);
+  const [position, setPosition] = react.useState(null);
+  const triggerRef = react.useRef(null);
+  const cardRef = react.useRef(null);
+  const openTimerRef = react.useRef(null);
+  const closeTimerRef = react.useRef(null);
+  const cancelClose = () => {
+    if (closeTimerRef.current !== null) {
+      window.clearTimeout(closeTimerRef.current);
+      closeTimerRef.current = null;
+    }
+  };
+  function onEnter() {
+    cancelClose();
+    if (delay > 0) {
+      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);
+      openTimerRef.current = window.setTimeout(() => setOpen(true), delay);
+    } else {
+      setOpen(true);
+    }
+  }
+  function onLeave() {
+    if (openTimerRef.current !== null) {
+      window.clearTimeout(openTimerRef.current);
+      openTimerRef.current = null;
+    }
+    cancelClose();
+    closeTimerRef.current = window.setTimeout(() => setOpen(false), HOVER_CLOSE_DELAY_MS);
+  }
+  react.useLayoutEffect(() => {
+    if (!open) return;
+    const update = () => {
+      const trigger2 = triggerRef.current;
+      const card2 = cardRef.current;
+      if (!trigger2 || !card2) return;
+      const t = trigger2.getBoundingClientRect();
+      const c = card2.getBoundingClientRect();
+      let top = 0;
+      let left = 0;
+      switch (placement) {
+        case "top":
+          top = t.top - c.height - GAP_PX;
+          left = t.left + t.width / 2 - c.width / 2;
+          break;
+        case "bottom":
+          top = t.bottom + GAP_PX;
+          left = t.left + t.width / 2 - c.width / 2;
+          break;
+        case "left":
+          top = t.top + t.height / 2 - c.height / 2;
+          left = t.left - c.width - GAP_PX;
+          break;
+        case "right":
+          top = t.top + t.height / 2 - c.height / 2;
+          left = t.right + GAP_PX;
+          break;
+      }
+      const margin = 4;
+      left = Math.min(Math.max(margin, left), window.innerWidth - c.width - margin);
+      top = Math.min(Math.max(margin, top), window.innerHeight - c.height - margin);
+      setPosition({ top, left });
+    };
+    update();
+    window.addEventListener("scroll", update, true);
+    window.addEventListener("resize", update);
+    return () => {
+      window.removeEventListener("scroll", update, true);
+      window.removeEventListener("resize", update);
+    };
+  }, [open, placement, children]);
+  react.useEffect(() => {
+    return () => {
+      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);
+      if (closeTimerRef.current !== null) window.clearTimeout(closeTimerRef.current);
+    };
+  }, []);
+  const card = open && typeof document !== "undefined" ? reactDom.createPortal(
+    /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        ref: cardRef,
+        role: "tooltip",
+        onMouseEnter: cancelClose,
+        onMouseLeave: onLeave,
+        style: position ? { position: "fixed", top: position.top, left: position.left } : { position: "fixed", top: -9999, left: -9999, visibility: "hidden" },
+        className: utils.cn(
+          "z-[9999] rounded-md border border-border bg-background px-2.5 py-1.5 text-[11px] shadow-lg",
+          "whitespace-nowrap",
+          cardClassName
+        ),
+        children: [
+          children,
+          arrow && position && /* @__PURE__ */ jsxRuntime.jsx(Arrow, { placement })
+        ]
+      }
+    ),
+    document.body
+  ) : null;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "span",
+    {
+      ref: triggerRef,
+      className: utils.cn("relative inline-flex items-center", className),
+      onMouseEnter: onEnter,
+      onMouseLeave: onLeave,
+      onFocus: onEnter,
+      onBlur: onLeave,
+      children: [
+        trigger,
+        card
+      ]
+    }
+  );
+}
+function Arrow({ placement }) {
+  const base = "absolute h-1.5 w-1.5 rotate-45 border bg-background border-border";
+  switch (placement) {
+    case "top":
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "span",
+        {
+          "aria-hidden": true,
+          className: utils.cn(base, "left-1/2 -translate-x-1/2 -bottom-0.5 border-l-0 border-t-0")
+        }
+      );
+    case "bottom":
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "span",
+        {
+          "aria-hidden": true,
+          className: utils.cn(base, "left-1/2 -translate-x-1/2 -top-0.5 border-r-0 border-b-0")
+        }
+      );
+    case "left":
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "span",
+        {
+          "aria-hidden": true,
+          className: utils.cn(base, "top-1/2 -translate-y-1/2 -right-0.5 border-l-0 border-b-0")
+        }
+      );
+    case "right":
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "span",
+        {
+          "aria-hidden": true,
+          className: utils.cn(base, "top-1/2 -translate-y-1/2 -left-0.5 border-r-0 border-t-0")
+        }
+      );
+  }
+}
+exports.HoverCard = HoverCard;
+//# sourceMappingURL=HoverCard.cjs.map

package/dist/overlay/HoverCard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HoverCard.cjs","sources":["../../src/overlay/HoverCard.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState, type ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn } from \"../lib/utils\";\n\nexport type HoverCardPlacement = \"top\" | \"bottom\" | \"left\" | \"right\";\n\nexport type HoverCardProps = {\n  /** Trigger content that opens the card on hover/focus. */\n  trigger: ReactNode;\n  /** Floating card content. */\n  children: ReactNode;\n  /** Preferred placement around the trigger. */\n  placement?: HoverCardPlacement;\n  /** Open delay in milliseconds. */\n  delay?: number;\n  /** Show the directional arrow. */\n  arrow?: boolean;\n  /** Classes applied to the trigger wrapper. */\n  className?: string;\n  /** Classes applied to the floating card. */\n  cardClassName?: string;\n};\n\nconst GAP_PX = 6;\n\ntype Position = { top: number; left: number };\n\n// Grace period that lets the cursor cross the gap from the trigger to the\n// portaled card without the card disappearing.\nconst HOVER_CLOSE_DELAY_MS = 120;\n\nexport function HoverCard({\n  trigger,\n  children,\n  placement = \"top\",\n  delay = 0,\n  arrow = true,\n  className,\n  cardClassName,\n}: HoverCardProps) {\n  const [open, setOpen] = useState(false);\n  const [position, setPosition] = useState<Position | null>(null);\n  const triggerRef = useRef<HTMLSpanElement | null>(null);\n  const cardRef = useRef<HTMLDivElement | null>(null);\n  const openTimerRef = useRef<number | null>(null);\n  const closeTimerRef = useRef<number | null>(null);\n\n  const cancelClose = () => {\n    if (closeTimerRef.current !== null) {\n      window.clearTimeout(closeTimerRef.current);\n      closeTimerRef.current = null;\n    }\n  };\n\n  function onEnter() {\n    cancelClose();\n    if (delay > 0) {\n      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);\n      openTimerRef.current = window.setTimeout(() => setOpen(true), delay);\n    } else {\n      setOpen(true);\n    }\n  }\n  function onLeave() {\n    if (openTimerRef.current !== null) {\n      window.clearTimeout(openTimerRef.current);\n      openTimerRef.current = null;\n    }\n    cancelClose();\n    closeTimerRef.current = window.setTimeout(() => setOpen(false), HOVER_CLOSE_DELAY_MS);\n  }\n\n  // Recompute position whenever the card opens or the viewport scrolls/resizes\n  // while it's open. We position via fixed coordinates so the card escapes\n  // every overflow-hidden / transform ancestor — important when the trigger\n  // sits inside a table row, dropdown, or modal that would otherwise clip it.\n  useLayoutEffect(() => {\n    if (!open) return;\n    const update = () => {\n      const trigger = triggerRef.current;\n      const card = cardRef.current;\n      if (!trigger || !card) return;\n      const t = trigger.getBoundingClientRect();\n      const c = card.getBoundingClientRect();\n      let top = 0;\n      let left = 0;\n      switch (placement) {\n        case \"top\":\n          top = t.top - c.height - GAP_PX;\n          left = t.left + t.width / 2 - c.width / 2;\n          break;\n        case \"bottom\":\n          top = t.bottom + GAP_PX;\n          left = t.left + t.width / 2 - c.width / 2;\n          break;\n        case \"left\":\n          top = t.top + t.height / 2 - c.height / 2;\n          left = t.left - c.width - GAP_PX;\n          break;\n        case \"right\":\n          top = t.top + t.height / 2 - c.height / 2;\n          left = t.right + GAP_PX;\n          break;\n      }\n      // Clamp to viewport so cards near the edge don't overflow off-screen.\n      const margin = 4;\n      left = Math.min(Math.max(margin, left), window.innerWidth - c.width - margin);\n      top = Math.min(Math.max(margin, top), window.innerHeight - c.height - margin);\n      setPosition({ top, left });\n    };\n    update();\n    window.addEventListener(\"scroll\", update, true);\n    window.addEventListener(\"resize\", update);\n    return () => {\n      window.removeEventListener(\"scroll\", update, true);\n      window.removeEventListener(\"resize\", update);\n    };\n  }, [open, placement, children]);\n\n  useEffect(() => {\n    return () => {\n      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);\n      if (closeTimerRef.current !== null) window.clearTimeout(closeTimerRef.current);\n    };\n  }, []);\n\n  const card =\n    open && typeof document !== \"undefined\"\n      ? createPortal(\n          <div\n            ref={cardRef}\n            role=\"tooltip\"\n            onMouseEnter={cancelClose}\n            onMouseLeave={onLeave}\n            style={\n              position\n                ? { position: \"fixed\", top: position.top, left: position.left }\n                : { position: \"fixed\", top: -9999, left: -9999, visibility: \"hidden\" }\n            }\n            className={cn(\n              \"z-[9999] rounded-md border border-border bg-background px-2.5 py-1.5 text-[11px] shadow-lg\",\n              \"whitespace-nowrap\",\n              cardClassName,\n            )}\n          >\n            {children}\n            {arrow && position && <Arrow placement={placement} />}\n          </div>,\n          document.body,\n        )\n      : null;\n\n  return (\n    <span\n      ref={triggerRef}\n      className={cn(\"relative inline-flex items-center\", className)}\n      onMouseEnter={onEnter}\n      onMouseLeave={onLeave}\n      onFocus={onEnter}\n      onBlur={onLeave}\n    >\n      {trigger}\n      {card}\n    </span>\n  );\n}\n\nfunction Arrow({ placement }: { placement: HoverCardPlacement }) {\n  // The arrow is a small rotated square clipped to look like a notch on the\n  // card edge that points back at the trigger. Drawn relative to the card.\n  const base = \"absolute h-1.5 w-1.5 rotate-45 border bg-background border-border\";\n  switch (placement) {\n    case \"top\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"left-1/2 -translate-x-1/2 -bottom-0.5 border-l-0 border-t-0\")}\n        />\n      );\n    case \"bottom\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"left-1/2 -translate-x-1/2 -top-0.5 border-r-0 border-b-0\")}\n        />\n      );\n    case \"left\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"top-1/2 -translate-y-1/2 -right-0.5 border-l-0 border-b-0\")}\n        />\n      );\n    case \"right\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"top-1/2 -translate-y-1/2 -left-0.5 border-r-0 border-t-0\")}\n        />\n      );\n  }\n}\n"],"names":["useState","useRef","useLayoutEffect","trigger","card","useEffect","createPortal","jsxs","cn","jsx"],"mappings":"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"}

package/dist/overlay/HoverCard.d.ts

@@ -1,12 +1,19 @@
 import { ReactNode } from 'react';
 export type HoverCardPlacement = "top" | "bottom" | "left" | "right";
 export type HoverCardProps = {
+    /** Trigger content that opens the card on hover/focus. */
     trigger: ReactNode;
+    /** Floating card content. */
     children: ReactNode;
+    /** Preferred placement around the trigger. */
     placement?: HoverCardPlacement;
+    /** Open delay in milliseconds. */
     delay?: number;
+    /** Show the directional arrow. */
     arrow?: boolean;
+    /** Classes applied to the trigger wrapper. */
     className?: string;
+    /** Classes applied to the floating card. */
     cardClassName?: string;
 };
 export declare function HoverCard({ trigger, children, placement, delay, arrow, className, cardClassName, }: HoverCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/overlay/HoverCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HoverCard.d.ts","sourceRoot":"","sources":["../../src/overlay/HoverCard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrF,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAUF,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,QAAQ,EACR,SAAiB,EACjB,KAAS,EACT,KAAY,EACZ,SAAS,EACT,aAAa,GACd,EAAE,cAAc,2CA8HhB"}
+{"version":3,"file":"HoverCard.d.ts","sourceRoot":"","sources":["../../src/overlay/HoverCard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrF,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,SAAS,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAUF,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,QAAQ,EACR,SAAiB,EACjB,KAAS,EACT,KAAY,EACZ,SAAS,EACT,aAAa,GACd,EAAE,cAAc,2CA8HhB"}

package/dist/overlay/HoverCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"HoverCard.js","sources":["../../src/overlay/HoverCard.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState, type ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn } from \"../lib/utils\";\n\nexport type HoverCardPlacement = \"top\" | \"bottom\" | \"left\" | \"right\";\n\nexport type HoverCardProps = {\n  trigger: ReactNode;\n  children: ReactNode;\n  placement?: HoverCardPlacement;\n  delay?: number;\n  arrow?: boolean;\n  className?: string;\n  cardClassName?: string;\n};\n\nconst GAP_PX = 6;\n\ntype Position = { top: number; left: number };\n\n// Grace period that lets the cursor cross the gap from the trigger to the\n// portaled card without the card disappearing.\nconst HOVER_CLOSE_DELAY_MS = 120;\n\nexport function HoverCard({\n  trigger,\n  children,\n  placement = \"top\",\n  delay = 0,\n  arrow = true,\n  className,\n  cardClassName,\n}: HoverCardProps) {\n  const [open, setOpen] = useState(false);\n  const [position, setPosition] = useState<Position | null>(null);\n  const triggerRef = useRef<HTMLSpanElement | null>(null);\n  const cardRef = useRef<HTMLDivElement | null>(null);\n  const openTimerRef = useRef<number | null>(null);\n  const closeTimerRef = useRef<number | null>(null);\n\n  const cancelClose = () => {\n    if (closeTimerRef.current !== null) {\n      window.clearTimeout(closeTimerRef.current);\n      closeTimerRef.current = null;\n    }\n  };\n\n  function onEnter() {\n    cancelClose();\n    if (delay > 0) {\n      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);\n      openTimerRef.current = window.setTimeout(() => setOpen(true), delay);\n    } else {\n      setOpen(true);\n    }\n  }\n  function onLeave() {\n    if (openTimerRef.current !== null) {\n      window.clearTimeout(openTimerRef.current);\n      openTimerRef.current = null;\n    }\n    cancelClose();\n    closeTimerRef.current = window.setTimeout(() => setOpen(false), HOVER_CLOSE_DELAY_MS);\n  }\n\n  // Recompute position whenever the card opens or the viewport scrolls/resizes\n  // while it's open. We position via fixed coordinates so the card escapes\n  // every overflow-hidden / transform ancestor — important when the trigger\n  // sits inside a table row, dropdown, or modal that would otherwise clip it.\n  useLayoutEffect(() => {\n    if (!open) return;\n    const update = () => {\n      const trigger = triggerRef.current;\n      const card = cardRef.current;\n      if (!trigger || !card) return;\n      const t = trigger.getBoundingClientRect();\n      const c = card.getBoundingClientRect();\n      let top = 0;\n      let left = 0;\n      switch (placement) {\n        case \"top\":\n          top = t.top - c.height - GAP_PX;\n          left = t.left + t.width / 2 - c.width / 2;\n          break;\n        case \"bottom\":\n          top = t.bottom + GAP_PX;\n          left = t.left + t.width / 2 - c.width / 2;\n          break;\n        case \"left\":\n          top = t.top + t.height / 2 - c.height / 2;\n          left = t.left - c.width - GAP_PX;\n          break;\n        case \"right\":\n          top = t.top + t.height / 2 - c.height / 2;\n          left = t.right + GAP_PX;\n          break;\n      }\n      // Clamp to viewport so cards near the edge don't overflow off-screen.\n      const margin = 4;\n      left = Math.min(Math.max(margin, left), window.innerWidth - c.width - margin);\n      top = Math.min(Math.max(margin, top), window.innerHeight - c.height - margin);\n      setPosition({ top, left });\n    };\n    update();\n    window.addEventListener(\"scroll\", update, true);\n    window.addEventListener(\"resize\", update);\n    return () => {\n      window.removeEventListener(\"scroll\", update, true);\n      window.removeEventListener(\"resize\", update);\n    };\n  }, [open, placement, children]);\n\n  useEffect(() => {\n    return () => {\n      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);\n      if (closeTimerRef.current !== null) window.clearTimeout(closeTimerRef.current);\n    };\n  }, []);\n\n  const card =\n    open && typeof document !== \"undefined\"\n      ? createPortal(\n          <div\n            ref={cardRef}\n            role=\"tooltip\"\n            onMouseEnter={cancelClose}\n            onMouseLeave={onLeave}\n            style={\n              position\n                ? { position: \"fixed\", top: position.top, left: position.left }\n                : { position: \"fixed\", top: -9999, left: -9999, visibility: \"hidden\" }\n            }\n            className={cn(\n              \"z-[9999] rounded-md border border-border bg-background px-2.5 py-1.5 text-[11px] shadow-lg\",\n              \"whitespace-nowrap\",\n              cardClassName,\n            )}\n          >\n            {children}\n            {arrow && position && <Arrow placement={placement} />}\n          </div>,\n          document.body,\n        )\n      : null;\n\n  return (\n    <span\n      ref={triggerRef}\n      className={cn(\"relative inline-flex items-center\", className)}\n      onMouseEnter={onEnter}\n      onMouseLeave={onLeave}\n      onFocus={onEnter}\n      onBlur={onLeave}\n    >\n      {trigger}\n      {card}\n    </span>\n  );\n}\n\nfunction Arrow({ placement }: { placement: HoverCardPlacement }) {\n  // The arrow is a small rotated square clipped to look like a notch on the\n  // card edge that points back at the trigger. Drawn relative to the card.\n  const base = \"absolute h-1.5 w-1.5 rotate-45 border bg-background border-border\";\n  switch (placement) {\n    case \"top\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"left-1/2 -translate-x-1/2 -bottom-0.5 border-l-0 border-t-0\")}\n        />\n      );\n    case \"bottom\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"left-1/2 -translate-x-1/2 -top-0.5 border-r-0 border-b-0\")}\n        />\n      );\n    case \"left\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"top-1/2 -translate-y-1/2 -right-0.5 border-l-0 border-b-0\")}\n        />\n      );\n    case \"right\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"top-1/2 -translate-y-1/2 -left-0.5 border-r-0 border-t-0\")}\n        />\n      );\n  }\n}\n"],"names":["trigger","card"],"mappings":"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"}
+{"version":3,"file":"HoverCard.js","sources":["../../src/overlay/HoverCard.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState, type ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn } from \"../lib/utils\";\n\nexport type HoverCardPlacement = \"top\" | \"bottom\" | \"left\" | \"right\";\n\nexport type HoverCardProps = {\n  /** Trigger content that opens the card on hover/focus. */\n  trigger: ReactNode;\n  /** Floating card content. */\n  children: ReactNode;\n  /** Preferred placement around the trigger. */\n  placement?: HoverCardPlacement;\n  /** Open delay in milliseconds. */\n  delay?: number;\n  /** Show the directional arrow. */\n  arrow?: boolean;\n  /** Classes applied to the trigger wrapper. */\n  className?: string;\n  /** Classes applied to the floating card. */\n  cardClassName?: string;\n};\n\nconst GAP_PX = 6;\n\ntype Position = { top: number; left: number };\n\n// Grace period that lets the cursor cross the gap from the trigger to the\n// portaled card without the card disappearing.\nconst HOVER_CLOSE_DELAY_MS = 120;\n\nexport function HoverCard({\n  trigger,\n  children,\n  placement = \"top\",\n  delay = 0,\n  arrow = true,\n  className,\n  cardClassName,\n}: HoverCardProps) {\n  const [open, setOpen] = useState(false);\n  const [position, setPosition] = useState<Position | null>(null);\n  const triggerRef = useRef<HTMLSpanElement | null>(null);\n  const cardRef = useRef<HTMLDivElement | null>(null);\n  const openTimerRef = useRef<number | null>(null);\n  const closeTimerRef = useRef<number | null>(null);\n\n  const cancelClose = () => {\n    if (closeTimerRef.current !== null) {\n      window.clearTimeout(closeTimerRef.current);\n      closeTimerRef.current = null;\n    }\n  };\n\n  function onEnter() {\n    cancelClose();\n    if (delay > 0) {\n      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);\n      openTimerRef.current = window.setTimeout(() => setOpen(true), delay);\n    } else {\n      setOpen(true);\n    }\n  }\n  function onLeave() {\n    if (openTimerRef.current !== null) {\n      window.clearTimeout(openTimerRef.current);\n      openTimerRef.current = null;\n    }\n    cancelClose();\n    closeTimerRef.current = window.setTimeout(() => setOpen(false), HOVER_CLOSE_DELAY_MS);\n  }\n\n  // Recompute position whenever the card opens or the viewport scrolls/resizes\n  // while it's open. We position via fixed coordinates so the card escapes\n  // every overflow-hidden / transform ancestor — important when the trigger\n  // sits inside a table row, dropdown, or modal that would otherwise clip it.\n  useLayoutEffect(() => {\n    if (!open) return;\n    const update = () => {\n      const trigger = triggerRef.current;\n      const card = cardRef.current;\n      if (!trigger || !card) return;\n      const t = trigger.getBoundingClientRect();\n      const c = card.getBoundingClientRect();\n      let top = 0;\n      let left = 0;\n      switch (placement) {\n        case \"top\":\n          top = t.top - c.height - GAP_PX;\n          left = t.left + t.width / 2 - c.width / 2;\n          break;\n        case \"bottom\":\n          top = t.bottom + GAP_PX;\n          left = t.left + t.width / 2 - c.width / 2;\n          break;\n        case \"left\":\n          top = t.top + t.height / 2 - c.height / 2;\n          left = t.left - c.width - GAP_PX;\n          break;\n        case \"right\":\n          top = t.top + t.height / 2 - c.height / 2;\n          left = t.right + GAP_PX;\n          break;\n      }\n      // Clamp to viewport so cards near the edge don't overflow off-screen.\n      const margin = 4;\n      left = Math.min(Math.max(margin, left), window.innerWidth - c.width - margin);\n      top = Math.min(Math.max(margin, top), window.innerHeight - c.height - margin);\n      setPosition({ top, left });\n    };\n    update();\n    window.addEventListener(\"scroll\", update, true);\n    window.addEventListener(\"resize\", update);\n    return () => {\n      window.removeEventListener(\"scroll\", update, true);\n      window.removeEventListener(\"resize\", update);\n    };\n  }, [open, placement, children]);\n\n  useEffect(() => {\n    return () => {\n      if (openTimerRef.current !== null) window.clearTimeout(openTimerRef.current);\n      if (closeTimerRef.current !== null) window.clearTimeout(closeTimerRef.current);\n    };\n  }, []);\n\n  const card =\n    open && typeof document !== \"undefined\"\n      ? createPortal(\n          <div\n            ref={cardRef}\n            role=\"tooltip\"\n            onMouseEnter={cancelClose}\n            onMouseLeave={onLeave}\n            style={\n              position\n                ? { position: \"fixed\", top: position.top, left: position.left }\n                : { position: \"fixed\", top: -9999, left: -9999, visibility: \"hidden\" }\n            }\n            className={cn(\n              \"z-[9999] rounded-md border border-border bg-background px-2.5 py-1.5 text-[11px] shadow-lg\",\n              \"whitespace-nowrap\",\n              cardClassName,\n            )}\n          >\n            {children}\n            {arrow && position && <Arrow placement={placement} />}\n          </div>,\n          document.body,\n        )\n      : null;\n\n  return (\n    <span\n      ref={triggerRef}\n      className={cn(\"relative inline-flex items-center\", className)}\n      onMouseEnter={onEnter}\n      onMouseLeave={onLeave}\n      onFocus={onEnter}\n      onBlur={onLeave}\n    >\n      {trigger}\n      {card}\n    </span>\n  );\n}\n\nfunction Arrow({ placement }: { placement: HoverCardPlacement }) {\n  // The arrow is a small rotated square clipped to look like a notch on the\n  // card edge that points back at the trigger. Drawn relative to the card.\n  const base = \"absolute h-1.5 w-1.5 rotate-45 border bg-background border-border\";\n  switch (placement) {\n    case \"top\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"left-1/2 -translate-x-1/2 -bottom-0.5 border-l-0 border-t-0\")}\n        />\n      );\n    case \"bottom\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"left-1/2 -translate-x-1/2 -top-0.5 border-r-0 border-b-0\")}\n        />\n      );\n    case \"left\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"top-1/2 -translate-y-1/2 -right-0.5 border-l-0 border-b-0\")}\n        />\n      );\n    case \"right\":\n      return (\n        <span\n          aria-hidden\n          className={cn(base, \"top-1/2 -translate-y-1/2 -left-0.5 border-r-0 border-t-0\")}\n        />\n      );\n  }\n}\n"],"names":["trigger","card"],"mappings":"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"}

package/dist/overlay/Modal.cjs

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const utils = require("../lib/utils.cjs");
+const Icon = require("../data/Icon.cjs");
+const UiFullscreen = require("../icons/components/UiFullscreen.cjs");
+const UiClose = require("../icons/components/UiClose.cjs");
+const sizeClass = {
+  sm: "max-w-sm max-h-[90vh]",
+  md: "max-w-md max-h-[90vh]",
+  lg: "max-w-2xl max-h-[90vh]",
+  xl: "max-w-4xl max-h-[90vh]",
+  full: "max-w-[95vw] max-h-[95vh]"
+};
+function Modal({
+  open,
+  onClose,
+  title,
+  size = "md",
+  closeOnBackdrop = true,
+  closeOnEsc = true,
+  hideClose = false,
+  expandable = true,
+  className,
+  headerSlot,
+  footer,
+  children
+}) {
+  const dialogRef = react.useRef(null);
+  const [expanded, setExpanded] = react.useState(false);
+  react.useEffect(() => {
+    if (!open) setExpanded(false);
+  }, [open]);
+  react.useEffect(() => {
+    if (!open || !closeOnEsc) return;
+    const onKey = (e) => {
+      if (e.key === "Escape") onClose();
+    };
+    document.addEventListener("keydown", onKey);
+    return () => document.removeEventListener("keydown", onKey);
+  }, [open, closeOnEsc, onClose]);
+  react.useEffect(() => {
+    var _a;
+    if (!open) return;
+    const prev = document.activeElement;
+    (_a = dialogRef.current) == null ? void 0 : _a.focus();
+    return () => {
+      var _a2;
+      return (_a2 = prev == null ? void 0 : prev.focus) == null ? void 0 : _a2.call(prev);
+    };
+  }, [open]);
+  if (!open) return null;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      className: "fixed inset-0 z-50 flex items-center justify-center bg-black/40",
+      onClick: closeOnBackdrop ? onClose : void 0,
+      role: "presentation",
+      children: /* @__PURE__ */ jsxRuntime.jsxs(
+        "div",
+        {
+          ref: dialogRef,
+          tabIndex: -1,
+          role: "dialog",
+          "aria-modal": "true",
+          "aria-label": typeof title === "string" ? title : void 0,
+          className: utils.cn(
+            "relative bg-background border border-border rounded-lg shadow-xl w-full flex flex-col",
+            expanded ? sizeClass.full : sizeClass[size],
+            className
+          ),
+          onClick: (e) => e.stopPropagation(),
+          children: [
+            (title || headerSlot || expandable || !hideClose) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-density-2 px-density-4 py-density-3 border-b border-border", children: [
+              title ? /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-sm font-semibold flex-1", children: title }) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-1" }),
+              headerSlot,
+              expandable && /* @__PURE__ */ jsxRuntime.jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => setExpanded((v) => !v),
+                  "aria-label": expanded ? "Restore size" : "Expand to fullscreen",
+                  className: "text-muted-foreground hover:text-foreground",
+                  children: /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: expanded ? UiFullscreen.UiFullscreenFilled : UiFullscreen.UiFullscreen })
+                }
+              ),
+              !hideClose && /* @__PURE__ */ jsxRuntime.jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: onClose,
+                  "aria-label": "Close",
+                  className: "text-muted-foreground hover:text-foreground",
+                  children: /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiClose.UiClose })
+                }
+              )
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex-1 overflow-auto px-density-4 py-density-3", children }),
+            footer && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-density-4 py-density-3 border-t border-border", children: footer })
+          ]
+        }
+      )
+    }
+  );
+}
+exports.Modal = Modal;
+//# sourceMappingURL=Modal.cjs.map

package/dist/overlay/Modal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modal.cjs","sources":["../../src/overlay/Modal.tsx"],"sourcesContent":["import { useEffect, useRef, useState, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { Icon } from \"../data/Icon\";\nimport { UiClose, UiFullscreen, UiFullscreenFilled } from \"../icons\";\n\nexport type ModalSize = \"sm\" | \"md\" | \"lg\" | \"xl\" | \"full\";\n\nexport type ModalProps = {\n  /** Controls whether the modal is mounted. */\n  open: boolean;\n  /** Called when the modal requests to close. */\n  onClose: () => void;\n  /** Header title and accessible dialog label when it is a string. */\n  title?: ReactNode;\n  /** Width/height preset for the dialog. */\n  size?: ModalSize;\n  /** Close when the backdrop is clicked. */\n  closeOnBackdrop?: boolean;\n  /** Close when Escape is pressed. */\n  closeOnEsc?: boolean;\n  /** Hide the close button. */\n  hideClose?: boolean;\n  /** Show an expand/restore button. */\n  expandable?: boolean;\n  /** Classes applied to the dialog panel. */\n  className?: string;\n  /** Extra header content rendered before the expand/close buttons. */\n  headerSlot?: ReactNode;\n  /** Footer content pinned below the scrollable body. */\n  footer?: ReactNode;\n  /** Modal body content. */\n  children: ReactNode;\n};\n\nconst sizeClass: Record<ModalSize, string> = {\n  sm: \"max-w-sm max-h-[90vh]\",\n  md: \"max-w-md max-h-[90vh]\",\n  lg: \"max-w-2xl max-h-[90vh]\",\n  xl: \"max-w-4xl max-h-[90vh]\",\n  full: \"max-w-[95vw] max-h-[95vh]\",\n};\n\nexport function Modal({\n  open,\n  onClose,\n  title,\n  size = \"md\",\n  closeOnBackdrop = true,\n  closeOnEsc = true,\n  hideClose = false,\n  expandable = true,\n  className,\n  headerSlot,\n  footer,\n  children,\n}: ModalProps) {\n  const dialogRef = useRef<HTMLDivElement>(null);\n  const [expanded, setExpanded] = useState(false);\n\n  useEffect(() => {\n    if (!open) setExpanded(false);\n  }, [open]);\n\n  useEffect(() => {\n    if (!open || !closeOnEsc) return;\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") onClose();\n    };\n    document.addEventListener(\"keydown\", onKey);\n    return () => document.removeEventListener(\"keydown\", onKey);\n  }, [open, closeOnEsc, onClose]);\n\n  useEffect(() => {\n    if (!open) return;\n    const prev = document.activeElement as HTMLElement | null;\n    dialogRef.current?.focus();\n    return () => prev?.focus?.();\n  }, [open]);\n\n  if (!open) return null;\n\n  return (\n    <div\n      className=\"fixed inset-0 z-50 flex items-center justify-center bg-black/40\"\n      onClick={closeOnBackdrop ? onClose : undefined}\n      role=\"presentation\"\n    >\n      <div\n        ref={dialogRef}\n        tabIndex={-1}\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label={typeof title === \"string\" ? title : undefined}\n        className={cn(\n          \"relative bg-background border border-border rounded-lg shadow-xl w-full flex flex-col\",\n          expanded ? sizeClass.full : sizeClass[size],\n          className,\n        )}\n        onClick={(e) => e.stopPropagation()}\n      >\n        {(title || headerSlot || expandable || !hideClose) && (\n          <div className=\"flex items-center gap-density-2 px-density-4 py-density-3 border-b border-border\">\n            {title ? (\n              <h2 className=\"text-sm font-semibold flex-1\">{title}</h2>\n            ) : (\n              <span className=\"flex-1\" />\n            )}\n            {headerSlot}\n            {expandable && (\n              <button\n                type=\"button\"\n                onClick={() => setExpanded((v) => !v)}\n                aria-label={expanded ? \"Restore size\" : \"Expand to fullscreen\"}\n                className=\"text-muted-foreground hover:text-foreground\"\n              >\n                <Icon icon={expanded ? UiFullscreenFilled : UiFullscreen} />\n              </button>\n            )}\n            {!hideClose && (\n              <button\n                type=\"button\"\n                onClick={onClose}\n                aria-label=\"Close\"\n                className=\"text-muted-foreground hover:text-foreground\"\n              >\n                <Icon icon={UiClose} />\n              </button>\n            )}\n          </div>\n        )}\n        <div className=\"flex-1 overflow-auto px-density-4 py-density-3\">{children}</div>\n        {footer && <div className=\"px-density-4 py-density-3 border-t border-border\">{footer}</div>}\n      </div>\n    </div>\n  );\n}\n"],"names":["useRef","useState","useEffect","_a","jsx","jsxs","cn","Icon","UiFullscreenFilled","UiFullscreen","UiClose"],"mappings":"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"}

package/dist/overlay/Modal.d.ts

@@ -1,17 +1,30 @@
 import { ReactNode } from 'react';
 export type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
 export type ModalProps = {
+    /** Controls whether the modal is mounted. */
     open: boolean;
+    /** Called when the modal requests to close. */
     onClose: () => void;
+    /** Header title and accessible dialog label when it is a string. */
     title?: ReactNode;
+    /** Width/height preset for the dialog. */
     size?: ModalSize;
+    /** Close when the backdrop is clicked. */
     closeOnBackdrop?: boolean;
+    /** Close when Escape is pressed. */
     closeOnEsc?: boolean;
+    /** Hide the close button. */
     hideClose?: boolean;
+    /** Show an expand/restore button. */
+    expandable?: boolean;
+    /** Classes applied to the dialog panel. */
     className?: string;
+    /** Extra header content rendered before the expand/close buttons. */
     headerSlot?: ReactNode;
+    /** Footer content pinned below the scrollable body. */
     footer?: ReactNode;
+    /** Modal body content. */
     children: ReactNode;
 };
-export declare function Modal({ open, onClose, title, size, closeOnBackdrop, closeOnEsc, hideClose, className, headerSlot, footer, children, }: ModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Modal({ open, onClose, title, size, closeOnBackdrop, closeOnEsc, hideClose, expandable, className, headerSlot, footer, children, }: ModalProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=Modal.d.ts.map

package/dist/overlay/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/overlay/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI1D,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAUF,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAW,EACX,eAAsB,EACtB,UAAiB,EACjB,SAAiB,EACjB,SAAS,EACT,UAAU,EACV,MAAM,EACN,QAAQ,GACT,EAAE,UAAU,kDA6DZ"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/overlay/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKpE,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG;IACvB,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oCAAoC;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,uDAAuD;IACvD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAUF,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAW,EACX,eAAsB,EACtB,UAAiB,EACjB,SAAiB,EACjB,UAAiB,EACjB,SAAS,EACT,UAAU,EACV,MAAM,EACN,QAAQ,GACT,EAAE,UAAU,kDAgFZ"}

package/dist/overlay/Modal.js

@@ -1,7 +1,9 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useRef, useEffect } from "react";
+import { useRef, useState, useEffect } from "react";
 import { cn } from "../lib/utils.js";
 import { Icon } from "../data/Icon.js";
+import { UiFullscreenFilled, UiFullscreen } from "../icons/components/UiFullscreen.js";
+import { UiClose } from "../icons/components/UiClose.js";
 const sizeClass = {
   sm: "max-w-sm max-h-[90vh]",
   md: "max-w-md max-h-[90vh]",
@@ -17,12 +19,17 @@ function Modal({
   closeOnBackdrop = true,
   closeOnEsc = true,
   hideClose = false,
+  expandable = true,
   className,
   headerSlot,
   footer,
   children
 }) {
   const dialogRef = useRef(null);
+  const [expanded, setExpanded] = useState(false);
+  useEffect(() => {
+    if (!open) setExpanded(false);
+  }, [open]);
   useEffect(() => {
     if (!open || !closeOnEsc) return;
     const onKey = (e) => {
@@ -58,14 +65,24 @@ function Modal({
           "aria-label": typeof title === "string" ? title : void 0,
           className: cn(
             "relative bg-background border border-border rounded-lg shadow-xl w-full flex flex-col",
-            sizeClass[size],
+            expanded ? sizeClass.full : sizeClass[size],
             className
           ),
           onClick: (e) => e.stopPropagation(),
           children: [
-            (title || headerSlot || !hideClose) && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-density-2 px-density-4 py-density-3 border-b border-border", children: [
-              title && /* @__PURE__ */ jsx("h2", { className: "text-sm font-semibold flex-1", children: title }),
+            (title || headerSlot || expandable || !hideClose) && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-density-2 px-density-4 py-density-3 border-b border-border", children: [
+              title ? /* @__PURE__ */ jsx("h2", { className: "text-sm font-semibold flex-1", children: title }) : /* @__PURE__ */ jsx("span", { className: "flex-1" }),
               headerSlot,
+              expandable && /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => setExpanded((v) => !v),
+                  "aria-label": expanded ? "Restore size" : "Expand to fullscreen",
+                  className: "text-muted-foreground hover:text-foreground",
+                  children: /* @__PURE__ */ jsx(Icon, { icon: expanded ? UiFullscreenFilled : UiFullscreen })
+                }
+              ),
               !hideClose && /* @__PURE__ */ jsx(
                 "button",
                 {
@@ -73,7 +90,7 @@ function Modal({
                   onClick: onClose,
                   "aria-label": "Close",
                   className: "text-muted-foreground hover:text-foreground",
-                  children: /* @__PURE__ */ jsx(Icon, { name: "codicon:close" })
+                  children: /* @__PURE__ */ jsx(Icon, { icon: UiClose })
                 }
               )
             ] }),