asheeui 0.6.2 → 0.6.3

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":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAoB,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAG5E,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAM3D,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,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC;IACpC,gBAAgB,EAAE,CAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAEnD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACrC,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,KAAK,SAAS,CAAC;IACxE,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,UAAU;sSAuBpB,eAAe;;CA2GjB,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;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"}

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

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

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

@@ -1 +1,3 @@
+export * from './SelectMenu';
+export * from './select-menu-config';
 //# 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":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

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

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

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

@@ -0,0 +1,82 @@
+import { Color, Radius, Size, Variant } from '../../shared';
+/**
+ * A single option in the select menu.
+ * Each option must have a label and a unique value.
+ */
+export interface SelectMenuOption {
+    /**
+     * Text displayed in the input and in the options list.
+     */
+    label: string;
+    /**
+     * Stable identifier returned via `onValueChange`.
+     */
+    value: string | number;
+    /**
+     * Disables the option when `true`.
+     * Disabled options cannot be selected.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Allows arbitrary option metadata (e.g. icons, descriptions).
+     * Additional properties are passed through and can be used in custom rendering.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Theme configuration options for the SelectMenu component.
+ * Controls the visual appearance of the dropdown menu and its items.
+ */
+export interface SelectMenuConfig {
+    /**
+     * Corner rounding of the dropdown menu.
+     * Controls the border-radius of the menu container.
+     *
+     * @default "md"
+     */
+    radius?: Radius;
+    /**
+     * Density scale of the dropdown menu.
+     * Controls the size of menu items.
+     *
+     * @default "md"
+     */
+    size?: Size;
+    /**
+     * Variant for inactive (non-selected) options.
+     * Controls the visual style of unselected items.
+     *
+     * @default "ghost"
+     */
+    itemVariant?: Variant;
+    /**
+     * Color for inactive options.
+     * Controls the accent color of unselected items.
+     *
+     * @default "primary"
+     */
+    itemColor?: Color;
+    /**
+     * Variant for the selected option.
+     * Controls the visual style of the currently selected item.
+     *
+     * @default "solid"
+     */
+    activeItemVariant?: Variant;
+    /**
+     * Color for the selected option.
+     * Controls the accent color of the selected item.
+     *
+     * @default "primary"
+     */
+    activeItemColor?: Color;
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ * These values are used when instance props, component config,
+ * and global defaults are all undefined.
+ */
+export declare const FALLBACK_SELECT_MENU_CONFIG: Required<SelectMenuConfig>;
+//# sourceMappingURL=select-menu-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select-menu-config.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/select-menu-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;IAElB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,gBAAgB,CAOlE,CAAC"}

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

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

package/dist/components/sidebar/Sidebar.d.ts

@@ -1,75 +1,175 @@
 import { ElementType, HTMLAttributes, ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Color, Variant } from '../../shared/variant';
-import { TooltipPlacement } from '../tooltip/tooltip-config';
-import { SidebarItem, SidebarItems, SidebarSizeKey, SidebarVariant } from './sidebar-config';
-export interface SidebarProps<T = string> extends Omit<HTMLAttributes<HTMLElement>, "onSelect" | "title"> {
-    /** List of navigation items or sections. */
+import { SidebarConfig, SidebarItem, SidebarItems } from './sidebar-config';
+type BaseSidebarProps = SidebarConfig & Omit<HTMLAttributes<HTMLElement>, "color" | "size" | "onSelect" | "title">;
+/**
+ * Configuration options for the Sidebar component.
+ */
+export interface SidebarProps<T = string> extends BaseSidebarProps {
+    /**
+     * List of navigation items or sections.
+     * Can be a flat array of items or an array of sections.
+     */
     items?: SidebarItems<T>;
-    /** Key of currently active item. */
+    /**
+     * Key of currently active item.
+     * Used to highlight the selected navigation item.
+     */
     activeKey?: T;
-    /** Selection callback fired when an item is clicked. */
+    /**
+     * Selection callback fired when an item is clicked.
+     * Receives the clicked item object.
+     */
     onSelect?: (item: SidebarItem<T>) => void;
-    /** Controlled collapsed drawer state. */
+    /**
+     * Controlled collapsed drawer state.
+     * When provided, the component becomes controlled.
+     */
     isCollapsed?: boolean;
-    /** Callback when collapse state changes. */
+    /**
+     * Callback when collapse state changes.
+     * Receives the new collapsed state.
+     */
     onCollapseChange?: (collapsed: boolean) => void;
-    /** Title displayed in the sidebar header when expanded. */
+    /**
+     * Title displayed in the sidebar header when expanded.
+     */
     title?: ReactNode;
-    /** Header back button click handler. */
+    /**
+     * Header back button click handler.
+     * When provided, a back button is shown in the header.
+     */
     onBack?: () => void;
-    /** Custom back button icon element. */
+    /**
+     * Custom back button icon element.
+     * Defaults to ArrowLeftIcon.
+     */
     backIcon?: ReactNode;
-    /** Optional user role string to filter item visibility against item.roles. */
+    /**
+     * Optional user role string to filter item visibility against item.roles.
+     * Items and sections with roles that don't match this role are hidden.
+     */
     userRole?: string;
-    /** Footer slot element. */
+    /**
+     * Footer slot element.
+     * Rendered at the bottom of the sidebar.
+     */
     footer?: ReactNode;
-    /** Visual variant style. */
-    variant?: SidebarVariant;
-    /** Size scale token key. */
-    size?: SidebarSizeKey;
-    /** Radius scale token for sidebar container. */
-    radius?: Radius;
-    /** Radius scale token for individual items. */
-    itemRadius?: Radius;
-    /** Active item variant. */
-    itemVariant?: Variant;
-    /** Active item color. */
-    activeItemColor?: Color;
-    /** Header back button variant. */
-    backButtonVariant?: Variant;
-    /** Header back button color. */
-    backButtonColor?: Color;
-    /** Collapse toggle button variant. */
-    collapseButtonVariant?: Variant;
-    /** Collapse toggle button color. */
-    collapseButtonColor?: Color;
-    showCollapseButton?: boolean;
-    collapsible?: boolean;
-    defaultCollapsed?: boolean;
-    /** Whether to show tooltips on hover when the sidebar is collapsed. */
-    showTooltips?: boolean;
-    /** Preferred tooltip placement when collapsed. */
-    tooltipPlacement?: TooltipPlacement;
-    /** Header section class override. */
+    /**
+     * Header section class override.
+     */
     headerClassName?: string;
-    /** Navigation container class override. */
+    /**
+     * Navigation container class override.
+     */
     bodyClassName?: string;
-    /** Individual navigation item class override. */
+    /**
+     * Individual navigation item class override.
+     */
     itemClassName?: string;
-    /** Section label class override. */
+    /**
+     * Section label class override.
+     */
     sectionLabelClassName?: string;
-    /** Footer class override. */
+    /**
+     * Footer class override.
+     */
     footerClassName?: string;
-    /** Anchor tag props passthrough (native <a> or custom link). */
+    /**
+     * Anchor tag props passthrough (native <a> or custom link).
+     */
     anchorProps?: Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href" | "children" | "onClick" | "className">;
-    /** Custom link component (e.g., Next.js Link, TanStack Router Link). */
+    /**
+     * Custom link component (e.g., Next.js Link, TanStack Router Link).
+     * When provided, this component is used instead of the native <a> tag.
+     */
     linkComponent?: ElementType;
-    /** Additional props to pass to the custom link component (e.g., { prefetch: true }). */
+    /**
+     * Additional props to pass to the custom link component (e.g., { prefetch: true }).
+     * These take precedence over the component's own props.
+     */
     linkProps?: Record<string, unknown>;
 }
-export declare function Sidebar<T = string>({ items: itemsProp, activeKey, onSelect, isCollapsed: isCollapsedProp, onCollapseChange, title, onBack, backIcon, userRole, footer, variant: variantProp, size, radius, itemRadius, itemVariant, activeItemColor, backButtonVariant, backButtonColor, collapseButtonVariant, collapseButtonColor, showCollapseButton: showCollapseButtonProp, collapsible: collapsibleProp, defaultCollapsed: defaultCollapsedProp, showTooltips, tooltipPlacement, headerClassName, bodyClassName, itemClassName, sectionLabelClassName, footerClassName, anchorProps, linkComponent, linkProps: linkPropsProp, className, style, ...props }: SidebarProps<T>): import("react").JSX.Element;
+/**
+ * A collapsible navigation sidebar with support for sections, items,
+ * icons, badges, tooltips, and custom link components.
+ *
+ * Sidebar renders a vertical navigation menu that can be collapsed to
+ * an icon-only state. It supports sections with labels, items with icons
+ * and badges, role-based visibility filtering, and tooltips for collapsed
+ * items. Visual tokens resolve through the standard AsheeUI cascade:
+ * prop, component config, global theme defaults, and the built-in fallback.
+ *
+ * The component automatically handles accessibility attributes including
+ * proper navigation landmarks, aria-label for tooltips, and focus
+ * management for interactive elements.
+ *
+ * @param props - Sidebar configuration options.
+ * @param props.items - List of navigation items or sections.
+ * @param props.activeKey - Key of currently active item.
+ * @param props.onSelect - Selection callback fired when an item is clicked.
+ * @param props.isCollapsed - Controlled collapsed state.
+ * @param props.onCollapseChange - Callback when collapse state changes.
+ * @param props.title - Title displayed in the header.
+ * @param props.onBack - Header back button click handler.
+ * @param props.userRole - Role for filtering items by visibility.
+ * @param props.footer - Footer slot element.
+ * @param props.size - Size scale. Defaults to "md".
+ * @param props.variant - Visual style variant. Defaults to "default".
+ * @param props.radius - Corner rounding of the sidebar.
+ * @param props.itemRadius - Corner rounding of navigation items.
+ * @param props.itemVariant - Visual variant for inactive items.
+ * @param props.activeItemVariant - Visual variant for active items.
+ * @param props.activeItemColor - Theme color for active items.
+ * @param props.showTooltips - Whether tooltips are shown. Defaults to true.
+ * @param props.tooltipPlacement - Placement of tooltips. Defaults to "right".
+ * @param props.showCollapseButton - Whether the collapse button is shown. Defaults to true.
+ * @param props.collapsible - Whether the sidebar can be collapsed. Defaults to true.
+ * @param props.linkComponent - Custom link component for routing.
+ * @param props.linkProps - Props for the custom link component.
+ *
+ * @example
+ * ```tsx
+ * import { Sidebar } from "asheeui";
+ * import { useState } from "react";
+ *
+ * export function Example() {
+ *   const [active, setActive] = useState("dashboard");
+ *
+ *   return (
+ *     <Sidebar
+ *       items={[
+ *         { id: "dashboard", label: "Dashboard", icon: <DashboardIcon /> },
+ *         { id: "settings", label: "Settings", icon: <SettingsIcon /> },
+ *       ]}
+ *       activeKey={active}
+ *       onSelect={(item) => setActive(item.id)}
+ *       title="My App"
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With sections and Next.js Link
+ * import NextLink from "next/link";
+ *
+ * <Sidebar
+ *   items={[
+ *     { id: "main", label: "Main", items: mainItems },
+ *     { id: "admin", label: "Admin", items: adminItems },
+ *   ]}
+ *   linkComponent={NextLink}
+ *   userRole="admin"
+ * />
+ * ```
+ *
+ * @see SidebarConfig - The configuration type for component defaults.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
+ */
+export declare function Sidebar<T = string>({ items: itemsProp, activeKey, onSelect, isCollapsed: isCollapsedProp, onCollapseChange, title, onBack, backIcon, userRole, footer, variant, size, radius, itemRadius, itemVariant, activeItemVariant, activeItemColor, showCollapseButton: showCollapseButtonProp, collapsible: collapsibleProp, defaultCollapsed: defaultCollapsedProp, showTooltips, tooltipPlacement, headerClassName, bodyClassName, itemClassName, sectionLabelClassName, footerClassName, anchorProps, linkComponent, linkProps: linkPropsProp, className, style, ...props }: SidebarProps<T>): import("react").JSX.Element;
 export declare namespace Sidebar {
     var displayName: string;
 }
+export {};
 //# sourceMappingURL=Sidebar.d.ts.map

package/dist/components/sidebar/Sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/Sidebar.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/Sidebar.tsx"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAqBf,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,YAAY,EAIb,MAAM,kBAAkB,CAAC;AAqB1B,KAAK,gBAAgB,GAAG,aAAa,GACnC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,gBAAgB;IAChE;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAE1C;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAEhD;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,CAChB,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAC9C,CAAC;IAEF;;;OAGG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,MAAM,EAAE,EAClC,KAAK,EAAE,SAAS,EAChB,SAAS,EACT,QAAQ,EACR,WAAW,EAAE,eAAe,EAC5B,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,OAAO,EACP,IAAI,EACJ,MAAM,EACN,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAAE,sBAAsB,EAC1C,WAAW,EAAE,eAAe,EAC5B,gBAAgB,EAAE,oBAAoB,EACtC,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,aAAa,EACb,SAAS,EAAE,aAAa,EACxB,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,YAAY,CAAC,CAAC,CAAC,+BAyYjB;yBA3ae,OAAO"}