asheeui 0.6.3 → 0.6.6

package/dist/components/select/select-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select-config.d.ts","sourceRoot":"","sources":["../../../src/components/select/select-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAAiC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,uBAAwB,CAAC;AAE5D,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF"}
+{"version":3,"file":"select-config.d.ts","sourceRoot":"","sources":["../../../src/components/select/select-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;CAIzB,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF"}

package/dist/components/select/select-config.js

@@ -1,9 +1,17 @@
 "use client";
-import { registerComponentDefaults as e } from "../../libs/registry.js";
-import { FALLBACK_FIELD_CONFIG as t, defaultFieldConfig as o } from "../field/field-config.js";
-const C = o, l = t;
-e("select", C);
+import { registerComponentDefaults as t } from "../../libs/registry.js";
+import { FALLBACK_FIELD_CONFIG as e, defaultFieldConfig as l } from "../field/field-config.js";
+const o = {
+  ...l,
+  portal: !0,
+  portalTarget: null
+}, n = {
+  ...e,
+  portal: !0,
+  portalTarget: null
+};
+t("select", o);
 export {
-  l as FALLBACK_SELECT_CONFIG,
-  C as defaultSelectConfig
+  n as FALLBACK_SELECT_CONFIG,
+  o as defaultSelectConfig
 };

package/dist/components/select-menu/SelectMenu.d.ts

@@ -102,6 +102,20 @@ export interface SelectMenuProps {
      * @default false
      */
     returnFocus?: boolean;
+    /**
+     * Whether to render the menu in a React portal.
+     * When true, the menu is rendered at the document body level.
+     * Defaults to true. This is typically controlled by the parent
+     * component (Select, MultiSelect, Autocomplete) via their own
+     * config or props.
+     */
+    portal?: boolean;
+    /**
+     * Custom portal target element for the menu.
+     * When portal is enabled, the menu is rendered into this element.
+     * Defaults to document.body.
+     */
+    portalTarget?: HTMLElement | null;
 }
 /**
  * A reusable dropdown menu for selecting options from a list.
@@ -114,6 +128,12 @@ export interface SelectMenuProps {
  * supports custom option rendering, search filtering, and configurable
  * item styles through the cascade resolution system.
  *
+ * By default, the menu uses React's createPortal to render at the document
+ * body level. This ensures the menu escapes CSS containment, overflow
+ * clipping, and stacking context issues. The portal can be disabled via
+ * the `portal` prop if the menu needs to stay within a specific parent
+ * container. This is typically controlled by the parent component.
+ *
  * @param props - SelectMenu configuration options.
  * @param props.isOpen - Whether the menu is open.
  * @param props.context - Floating UI context.
@@ -130,6 +150,8 @@ export interface SelectMenuProps {
  * @param props.menuConfig - Configuration for menu items.
  * @param props.menuProps - Props override for menu configuration.
  * @param props.renderOption - Custom render function for options.
+ * @param props.portal - Whether to render the menu in a portal. Defaults to true.
+ * @param props.portalTarget - Custom portal target element. Defaults to document.body.
  *
  * @example
  * ```tsx
@@ -151,7 +173,7 @@ export interface SelectMenuProps {
  * @see Button - The button component used for menu items.
  */
 export declare const SelectMenu: {
-    ({ isOpen, context, floatingStyles, getFloatingProps, setFloatingRef, options, selectedValues, onSelectOption, isSearch, searchPlaceholder, searchInputName, searchQuery, onSearchChange, belowList, dropdownClassName, menuConfig, menuProps, renderOption, initialFocus, returnFocus, }: SelectMenuProps): import("react").JSX.Element | null;
+    ({ isOpen, context, floatingStyles, getFloatingProps, setFloatingRef, options, selectedValues, onSelectOption, isSearch, searchPlaceholder, searchInputName, searchQuery, onSearchChange, belowList, dropdownClassName, menuConfig, menuProps, renderOption, initialFocus, returnFocus, portal, portalTarget, }: SelectMenuProps): import("react").JSX.Element | null;
     displayName: string;
 };
 //# sourceMappingURL=SelectMenu.d.ts.map

package/dist/components/select-menu/SelectMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectMenu.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/SelectMenu.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAoB,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAS5E,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IAEzB;;OAEG;IACH,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC;IAEpC;;OAEG;IACH,gBAAgB,EAAE,CAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7B;;OAEG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAEnD;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAErC;;;OAGG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,KAAK,SAAS,CAAC;IAExE;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAErD;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,UAAU;+RAqBpB,eAAe;;CAsJjB,CAAC"}
+{"version":3,"file":"SelectMenu.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/SelectMenu.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAoB,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAU5E,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IAEzB;;OAEG;IACH,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC;IAEpC;;OAEG;IACH,gBAAgB,EAAE,CAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7B;;OAEG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAEnD;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAErC;;;OAGG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,KAAK,SAAS,CAAC;IAExE;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAErD;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,UAAU;qTAuBpB,eAAe;;CAiKjB,CAAC"}

package/dist/components/select-menu/SelectMenu.js

@@ -1,62 +1,65 @@
 "use client";
-import { jsx as a, jsxs as w } from "react/jsx-runtime";
-import { FloatingFocusManager as G } from "@floating-ui/react";
-import { useState as T, useMemo as U } from "react";
-import { CheckIcon as q } from "../../icons/CheckIcon.js";
-import { SearchIcon as H } from "../../icons/SearchIcon.js";
-import { useAsheeConfig as J } from "../../libs/context.js";
-import { resolveCascade as c, resolveRadiusKey as W } from "../../utils/resolve-token.js";
-import { Button as X } from "../button/Button.js";
-import { Input as Y } from "../input/Input.js";
+import { jsx as a, jsxs as z } from "react/jsx-runtime";
+import { FloatingFocusManager as H } from "@floating-ui/react";
+import { useState as J, useMemo as W } from "react";
+import { createPortal as X } from "react-dom";
+import { CheckIcon as Y } from "../../icons/CheckIcon.js";
+import { SearchIcon as Z } from "../../icons/SearchIcon.js";
+import { useAsheeConfig as $ } from "../../libs/context.js";
+import { resolveCascade as c, resolveRadiusKey as p } from "../../utils/resolve-token.js";
+import { Button as C } from "../button/Button.js";
+import { Input as g } from "../input/Input.js";
 import { FALLBACK_SELECT_MENU_CONFIG as l } from "./select-menu-config.js";
-import { cn as Z } from "../../utils/cn.js";
-const $ = ({
-  isOpen: z,
-  context: V,
-  floatingStyles: S,
-  getFloatingProps: k,
-  setFloatingRef: A,
-  options: o = [],
-  selectedValues: F = [],
-  onSelectOption: M,
+import { cn as P } from "../../utils/cn.js";
+const tt = ({
+  isOpen: V,
+  context: m,
+  floatingStyles: u,
+  getFloatingProps: S,
+  setFloatingRef: k,
+  options: s = [],
+  selectedValues: A = [],
+  onSelectOption: F,
   isSearch: v = !0,
-  searchPlaceholder: L = "Search...",
-  searchInputName: Q = "select-menu-search",
-  searchQuery: j,
+  searchPlaceholder: M = "Search...",
+  searchInputName: L = "select-menu-search",
+  searchQuery: Q,
   onSearchChange: b,
   belowList: h,
-  dropdownClassName: E,
+  dropdownClassName: j,
   menuConfig: t,
   menuProps: e,
   renderOption: x,
-  initialFocus: K,
-  returnFocus: R
+  initialFocus: E,
+  returnFocus: K,
+  portal: R = !0,
+  portalTarget: _
 }) => {
-  const d = J(), [_, m] = T(""), i = j ?? _, B = (r) => {
-    b ? b(r) : m(r);
-  }, y = U(() => !v || !i.trim() ? o : o.filter(
-    (r) => r.label.toLowerCase().includes(i.toLowerCase())
-  ), [o, v, i]), O = (r) => F.includes(r), n = c(
+  const d = $(), [B, O] = J(""), o = Q ?? B, T = (r) => {
+    b ? b(r) : O(r);
+  }, f = W(() => !v || !o.trim() ? s : s.filter(
+    (r) => r.label.toLowerCase().includes(o.toLowerCase())
+  ), [s, v, o]), D = (r) => A.includes(r), G = c(
     e == null ? void 0 : e.itemVariant,
     t == null ? void 0 : t.itemVariant,
     void 0,
     l.itemVariant
-  ), I = c(
+  ), y = c(
     e == null ? void 0 : e.itemColor,
     t == null ? void 0 : t.itemColor,
     d.defaultColor,
     l.itemColor
-  ), u = c(
+  ), U = c(
     e == null ? void 0 : e.activeItemVariant,
     t == null ? void 0 : t.activeItemVariant,
     d.defaultVariant,
     l.activeItemVariant
-  ), D = c(
+  ), q = c(
     e == null ? void 0 : e.activeItemColor,
     t == null ? void 0 : t.activeItemColor,
     d.defaultColor,
     l.activeItemColor
-  ), f = W(
+  ), I = p(
     e == null ? void 0 : e.radius,
     t == null ? void 0 : t.radius,
     d.defaultRadius,
@@ -66,62 +69,63 @@ const $ = ({
     t == null ? void 0 : t.size,
     void 0,
     l.size
-  );
-  return z ? /* @__PURE__ */ a(
-    G,
+  ), n = _ ?? (typeof document < "u" ? document.body : null);
+  if (!V) return null;
+  const w = /* @__PURE__ */ a(
+    H,
     {
-      context: V,
+      context: m,
       modal: !1,
-      initialFocus: K,
-      returnFocus: R,
+      initialFocus: E,
+      returnFocus: K,
       children: /* @__PURE__ */ a(
         "div",
         {
-          ref: A,
-          style: { ...S, zIndex: 9999 },
+          ref: k,
+          style: { ...u, zIndex: 999999 },
           className: "w-full outline-none",
-          ...k(),
-          children: /* @__PURE__ */ w(
+          ...S(),
+          children: /* @__PURE__ */ z(
             "div",
             {
-              className: Z(
-                "w-full max-h-60 shadow-xl bg-background border border-border p-1 flex flex-col gap-0.5 overflow-y-auto scrollbar-hide",
+              className: P(
+                "max-h-60 shadow-xl bg-background border border-border p-1 flex flex-col gap-0.5 overflow-y-auto scrollbar-hide",
                 "animate-in fade-in-0 zoom-in-95 slide-in-from-top-1 duration-150 ease-out",
-                E
+                j
               ),
               children: [
                 v && /* @__PURE__ */ a("div", { className: "w-full p-1 mb-1 sticky top-0 z-10 border-b border-border", children: /* @__PURE__ */ a(
-                  Y,
+                  g,
                   {
-                    name: Q,
+                    name: L,
                     type: "text",
                     variant: "bordered",
-                    radius: f,
-                    color: I,
+                    radius: I,
+                    color: y,
                     size: N,
-                    value: i,
-                    onChange: (r) => B(r.target.value),
-                    startContent: /* @__PURE__ */ a(H, { className: "w-3.5 h-3.5 text-foreground/70" }),
-                    placeholder: L,
+                    value: o,
+                    onChange: (r) => T(r.target.value),
+                    startContent: /* @__PURE__ */ a(Z, { className: "w-3.5 h-3.5 text-foreground/70" }),
+                    placeholder: M,
                     autoFocus: !0,
                     className: "w-full pl-8 h-8 text-xs bg-secondary/30 border-none focus-visible:ring-0"
                   }
                 ) }),
-                y.length === 0 ? /* @__PURE__ */ a("div", { className: "px-3 py-4 text-xs text-foreground/70 text-center", children: "No options found" }) : y.map((r) => {
-                  const s = O(r.value);
-                  return x ? x(r, s) : /* @__PURE__ */ w(
-                    X,
+                f.length === 0 ? /* @__PURE__ */ a("div", { className: "px-3 py-4 text-xs text-foreground/70 text-center", children: "No options found" }) : f.map((r) => {
+                  const i = D(r.value);
+                  return x ? x(r, i) : /* @__PURE__ */ z(
+                    C,
                     {
-                      variant: s ? u : n,
-                      color: s ? D : I,
-                      radius: f,
+                      variant: i ? U : G,
+                      color: i ? q : y,
+                      radius: I,
                       size: N,
                       isDisabled: r.disabled,
-                      onClick: () => M(r),
+                      onClick: () => F(r),
                       className: "w-full justify-between font-normal text-left transition-colors truncate",
                       children: [
                         /* @__PURE__ */ a("span", { children: r.label }),
-                        s && /* @__PURE__ */ a(q, { className: "w-3.5 h-3.5 shrink-0 ml-2" })
+                        i && /* @__PURE__ */ a(Y, { className: "w-3.5 h-3.5 shrink-0 ml-2" })
                       ]
                     },
                     String(r.value)
@@ -134,9 +138,10 @@ const $ = ({
         }
       )
     }
-  ) : null;
+  );
+  return R && n ? X(w, n) : w;
 };
-$.displayName = "SelectMenu";
+tt.displayName = "SelectMenu";
 export {
-  $ as SelectMenu
+  tt as SelectMenu
 };

package/dist/components/select-menu/index.d.ts

@@ -1,3 +1,4 @@
 export * from './SelectMenu';
 export * from './select-menu-config';
+export * from './use-select-floating';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/select-menu/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/components/select-menu/index.js

@@ -1,2 +1,3 @@
 export * from "./SelectMenu.js";
 export * from "./select-menu-config.js";
+export * from "./use-select-floating.js";

package/dist/components/select-menu/select-menu-config.d.ts

@@ -62,7 +62,7 @@ export interface SelectMenuConfig {
      * Variant for the selected option.
      * Controls the visual style of the currently selected item.
      *
-     * @default "solid"
+     * @default "faded"
      */
     activeItemVariant?: Variant;
     /**

package/dist/components/select-menu/select-menu-config.js

@@ -1,12 +1,12 @@
 "use client";
-const i = {
+const t = {
   radius: "md",
   size: "md",
   itemVariant: "ghost",
   itemColor: "primary",
-  activeItemVariant: "solid",
+  activeItemVariant: "faded",
   activeItemColor: "primary"
 };
 export {
-  i as FALLBACK_SELECT_MENU_CONFIG
+  t as FALLBACK_SELECT_MENU_CONFIG
 };

package/dist/components/select-menu/use-select-floating.d.ts

@@ -0,0 +1,95 @@
+import { Placement, UseFloatingReturn } from '@floating-ui/react';
+/**
+ * Configuration options for the useSelectFloating hook.
+ * Controls the floating element's behavior, positioning, and size.
+ */
+export interface UseSelectFloatingProps {
+    /**
+     * Whether the floating element is open.
+     * Controls visibility and triggers positioning calculations.
+     */
+    isOpen: boolean;
+    /**
+     * Callback fired when the open state changes.
+     * Receives the new open state.
+     */
+    onOpenChange: (open: boolean) => void;
+    /**
+     * Whether the floating element is disabled.
+     * When true, the floating element does not open.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Preferred placement of the floating element relative to the reference.
+     * Floating UI will flip this automatically if there is insufficient space.
+     *
+     * @default "bottom-start"
+     */
+    placement?: Placement;
+    /**
+     * Distance in pixels between the reference and floating elements.
+     *
+     * @default 4
+     */
+    offsetDistance?: number;
+    /**
+     * Padding in pixels applied to the shift middleware.
+     * Prevents the floating element from touching the viewport edges.
+     *
+     * @default 8
+     */
+    padding?: number;
+    /**
+     * Whether the floating element should match the width of the reference element.
+     * When true, the floating element's width is set to the reference's width.
+     *
+     * @default true
+     */
+    matchReferenceWidth?: boolean;
+}
+/**
+ * Shared Floating UI positioning hook for dropdowns and menus.
+ * Generic `T` allows passing `HTMLButtonElement`, `HTMLInputElement`, etc.
+ *
+ * This hook configures Floating UI with sensible defaults for dropdown
+ * components. It handles automatic position updates, viewport edge detection
+ * via flip and shift middleware, and optional width matching of the
+ * reference element.
+ *
+ * @param props - Configuration options for the floating element.
+ * @param props.isOpen - Whether the floating element is open.
+ * @param props.onOpenChange - Callback fired when open state changes.
+ * @param props.disabled - Whether the floating element is disabled. Defaults to false.
+ * @param props.placement - Preferred placement. Defaults to "bottom-start".
+ * @param props.offsetDistance - Distance from reference in pixels. Defaults to 4.
+ * @param props.padding - Viewport padding for shift middleware. Defaults to 8.
+ * @param props.matchReferenceWidth - Whether to match reference width. Defaults to true.
+ * @returns The Floating UI context including refs, styles, and middleware.
+ *
+ * @example
+ * ```tsx
+ * const { refs, floatingStyles, context } = useSelectFloating({
+ *   isOpen,
+ *   onOpenChange: setIsOpen,
+ *   disabled: props.disabled,
+ * });
+ *
+ * return (
+ *   <>
+ *     <button ref={refs.setReference}>Toggle</button>
+ *     {isOpen && (
+ *       <div ref={refs.setFloating} style={floatingStyles}>
+ *         Content
+ *       </div>
+ *     )}
+ *   </>
+ * );
+ * ```
+ *
+ * @see useFloating - The underlying Floating UI hook.
+ * @see Select - The select component that uses this hook.
+ */
+export declare function useSelectFloating<T extends HTMLElement = HTMLElement>({ isOpen, onOpenChange, disabled, placement, offsetDistance, padding, matchReferenceWidth, }: UseSelectFloatingProps): UseFloatingReturn<T>;
+//# sourceMappingURL=use-select-floating.d.ts.map

package/dist/components/select-menu/use-select-floating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-select-floating.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/use-select-floating.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAKL,KAAK,SAAS,EAEd,KAAK,iBAAiB,EAEvB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACrE,MAAM,EACN,YAAY,EACZ,QAAgB,EAChB,SAA0B,EAC1B,cAAkB,EAClB,OAAW,EACX,mBAA0B,GAC3B,EAAE,sBAAsB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAsB/C"}

package/dist/components/select-menu/use-select-floating.js

@@ -0,0 +1,36 @@
+"use client";
+import { useFloating as r, autoUpdate as f, offset as u, flip as g, shift as d, size as c } from "@floating-ui/react";
+function m({
+  isOpen: i,
+  onOpenChange: n,
+  disabled: o = !1,
+  placement: a = "bottom-start",
+  offsetDistance: l = 4,
+  padding: s = 8,
+  matchReferenceWidth: p = !0
+}) {
+  return r({
+    open: i,
+    onOpenChange: (e) => !o && n(e),
+    placement: a,
+    whileElementsMounted: f,
+    middleware: [
+      u(l),
+      g(),
+      d({ padding: s }),
+      c({
+        apply({ availableHeight: e, elements: t }) {
+          Object.assign(t.floating.style, {
+            maxHeight: `${e}px`,
+            ...p && {
+              width: `${t.reference.getBoundingClientRect().width}px`
+            }
+          });
+        }
+      })
+    ]
+  });
+}
+export {
+  m as useSelectFloating
+};

package/dist/components/toast/toast-config.d.ts

@@ -113,6 +113,16 @@ export interface ToastConfig {
      * @default 5
      */
     maxToasts?: number;
+    /**
+     * Whether to render toasts in a React portal.
+     * When true, toasts are rendered at the document body level,
+     * escaping any parent DOM hierarchy. This prevents CSS containment
+     * and stacking context issues. Defaults to true because toasts
+     * should always appear above other content.
+     *
+     * @default true
+     */
+    portal?: boolean;
 }
 /**
  * Default config values registered for the Toast component.
@@ -131,6 +141,7 @@ export declare const FALLBACK_TOAST_CONFIG: {
     readonly animated: true;
     readonly defaultTimeout: 3500;
     readonly maxToasts: 5;
+    readonly portal: true;
 };
 declare module "../../libs/registry" {
     interface ComponentTypeConfigRegistry {

package/dist/components/toast/toast-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-config.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;mBAClB,IAAI;wBACQ,cAAc;sBACpB,OAAO;qBACX,MAAM;;;;CAId,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}
+{"version":3,"file":"toast-config.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAShC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;mBAClB,IAAI;wBACQ,cAAc;sBACpB,OAAO;qBACX,MAAM;;;;;CAKd,CAAC;AAEX,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,KAAK,EAAE,WAAW,CAAC;KACpB;CACF"}

package/dist/components/toast/toast-config.js

@@ -7,7 +7,8 @@ const e = {
   radius: "md",
   animated: !0,
   defaultTimeout: 3500,
-  maxToasts: 5
+  maxToasts: 5,
+  portal: !0
 }, o = {
   size: "md",
   placement: "top-right",
@@ -15,7 +16,8 @@ const e = {
   radius: "md",
   animated: !0,
   defaultTimeout: 3500,
-  maxToasts: 5
+  maxToasts: 5,
+  portal: !0
 };
 t("toast", e);
 export {

package/dist/components/toast/toast-context.d.ts

@@ -53,6 +53,12 @@ export interface ToastContextType {
      * Clear all active toasts.
      */
     clearToasts: () => void;
+    /**
+     * The portal target element for toast rendering.
+     * When portal is enabled, toasts are rendered into this element.
+     * Defaults to document.body.
+     */
+    portalTarget?: HTMLElement | null;
 }
 /**
  * Props for the ToastProvider component.
@@ -67,6 +73,12 @@ export interface ToastProviderProps extends ToastConfig {
      * Extra classes for the toast container.
      */
     className?: string;
+    /**
+     * Custom portal target element.
+     * When portal is enabled, toasts are rendered into this element.
+     * Defaults to document.body.
+     */
+    portalTarget?: HTMLElement | null;
 }
 /**
  * Provider component for the toast notification system.
@@ -76,6 +88,12 @@ export interface ToastProviderProps extends ToastConfig {
  * rendering, and dismissal logic, and automatically positions toasts
  * based on the configured placement.
  *
+ * The provider uses React's createPortal to render toasts at the document
+ * body level by default. This ensures toasts escape CSS containment,
+ * stacking context, and overflow issues. Portaling can be disabled via
+ * the `portal` config option if the toasts need to stay within a specific
+ * parent container.
+ *
  * @param props - ToastProvider configuration options.
  * @param props.children - Child components.
  * @param props.size - Size scale of toasts. Defaults to "md".
@@ -85,6 +103,8 @@ export interface ToastProviderProps extends ToastConfig {
  * @param props.defaultTimeout - Default timeout in ms. Defaults to 3500.
  * @param props.maxToasts - Maximum number of toasts. Defaults to 5.
  * @param props.animated - Whether toasts have animations. Defaults to true.
+ * @param props.portal - Whether to render toasts in a portal. Defaults to true.
+ * @param props.portalTarget - Custom portal target element. Defaults to document.body.
  * @param props.className - Extra classes for the toast container.
  *
  * @example
@@ -113,7 +133,7 @@ export interface ToastProviderProps extends ToastConfig {
  * @see useToast - Hook for showing toast notifications.
  * @see ToastConfig - The configuration type for the toast system.
  */
-export declare function ToastProvider({ children, size, placement, variant, radius, defaultTimeout, maxToasts, animated, className, }: ToastProviderProps): import("react").JSX.Element;
+export declare function ToastProvider({ children, size, placement, variant, radius, defaultTimeout, maxToasts, animated, portal: portalProp, portalTarget: portalTargetProp, className, }: ToastProviderProps): import("react").JSX.Element;
 /**
  * Hook for accessing the toast system.
  *

package/dist/components/toast/toast-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-context.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-context.tsx"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAMf,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AAIxB;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;IACjE;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,KAAK,MAAM,CAAC;IAEtD;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE7E;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE3E;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE1E;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE7E;;OAEG;IACH,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC;;OAEG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,GACV,EAAE,kBAAkB,+BA4KpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,qBAevB"}
+{"version":3,"file":"toast-context.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast-context.tsx"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAOf,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AAIxB;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;IACjE;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,KAAK,MAAM,CAAC;IAEtD;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE7E;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE3E;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE1E;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC;IAE7E;;OAEG;IACH,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC;;OAEG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,cAAc,EACd,SAAS,EACT,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,gBAAgB,EAC9B,SAAS,GACV,EAAE,kBAAkB,+BAyMpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,qBAgBvB"}