asheeui 0.5.0

package/dist/components/select/Select.js

@@ -0,0 +1,216 @@
+"use client";
+import { jsx as f, jsxs as z } from "react/jsx-runtime";
+import { cn as F } from "@asheeui/utils";
+import { useFloating as Le, autoUpdate as Ee, offset as Ie, flip as we, shift as _e, useClick as ze, useDismiss as Fe, useRole as Me, useInteractions as ke } from "@floating-ui/react";
+import { forwardRef as Ke, useId as Ne, useState as M, useMemo as y, useCallback as Oe } from "react";
+import { ChevronDownIcon as Te } from "../../icons/ChevronDownIcon.js";
+import { useAsheeConfig as De } from "../../libs/context.js";
+import { RADIUS_CLASS as je } from "../../shared/radius.js";
+import { resolveVariantClass as Ue } from "../../shared/variant.js";
+import { resolveCascade as r, resolveRadiusKey as k, resolveClassKey as ge } from "../../utils/resolve-token.js";
+import { FieldShell as Be } from "../field/FieldShell.js";
+import { SelectMenu as Pe } from "../select-menu/SelectMenu.js";
+import { FALLBACK_SELECT_CONFIG as t } from "./select-config.js";
+import { SELECT_SIZE_CLASS as Qe, SELECT_STATUS_BORDER_CLASS as Ge } from "./select-styles.js";
+const Ze = Ke(
+  ({
+    options: p = [],
+    value: o,
+    onChange: v,
+    onValueChange: a,
+    size: K,
+    radius: N,
+    variant: O,
+    color: T,
+    status: D,
+    label: j,
+    labelAlign: U,
+    description: g,
+    message: B,
+    required: P,
+    isLoading: Q,
+    disabled: S,
+    isSearch: G = !1,
+    searchPlaceholder: Z = "Search options...",
+    searchInputName: $ = "select-search",
+    initialValue: n,
+    belowList: q,
+    placeholder: x = "Select...",
+    buttonColor: R,
+    className: H,
+    dropdownClassName: J,
+    id: W,
+    name: h,
+    menuVariant: X,
+    menuColor: Y,
+    menuRadius: C,
+    menuSize: V,
+    style: ee
+  }, i) => {
+    var _;
+    const d = De(), e = (_ = d.components) == null ? void 0 : _.select, se = Ne(), te = W ?? se, [c, A] = M(!1), [re, L] = M(""), { refs: E, floatingStyles: oe, context: u } = Le({
+      open: c,
+      onOpenChange: (s) => !S && A(s),
+      placement: "bottom-start",
+      whileElementsMounted: Ee,
+      middleware: [Ie(4), we(), _e({ padding: 8 })]
+    }), le = ze(u, { enabled: !S }), ae = Fe(u), ne = Me(u, { role: "listbox" }), { getReferenceProps: ie, getFloatingProps: de } = ke([
+      le,
+      ae,
+      ne
+    ]), ce = r(
+      K,
+      e == null ? void 0 : e.size,
+      void 0,
+      t.size
+    ), b = r(
+      O,
+      e == null ? void 0 : e.variant,
+      d.defaultVariant,
+      t.variant
+    ), I = r(
+      T,
+      e == null ? void 0 : e.color,
+      d.defaultColor,
+      t.color
+    ), w = k(
+      N,
+      e == null ? void 0 : e.radius,
+      d.defaultRadius,
+      t.radius
+    ), m = D ?? t.status, ue = r(
+      U,
+      e == null ? void 0 : e.labelAlign,
+      void 0,
+      t.labelAlign
+    ), me = r(
+      X,
+      e == null ? void 0 : e.menuVariant,
+      void 0,
+      b
+    ), fe = r(
+      Y,
+      e == null ? void 0 : e.menuColor,
+      void 0,
+      I
+    ), pe = k(
+      C,
+      e == null ? void 0 : e.menuRadius,
+      w,
+      t.radius
+    ), ve = r(
+      V,
+      e == null ? void 0 : e.menuSize,
+      void 0,
+      t.menuSize
+    ), Se = Ue(b, I), be = m !== "default" ? Ge[m] : "", ye = b === "underlined" ? "rounded-none" : ge(
+      w,
+      je,
+      t.radius
+    ), l = y(
+      () => p.find((s) => s.value === o),
+      [p, o]
+    ), xe = Oe(
+      (s) => {
+        if (a == null || a(s.value), v) {
+          const Ae = {
+            target: { value: s.value, name: h ?? "" }
+          };
+          v(Ae);
+        }
+        A(!1), L("");
+      },
+      [h, v, a]
+    ), Re = y(() => l != null && l.label ? l.label : n !== void 0 ? String(n) : x, [l, n, x]), he = y(
+      () => o != null ? [o] : [],
+      [o]
+    );
+    return /* @__PURE__ */ f(
+      Be,
+      {
+        id: te,
+        label: j,
+        labelAlign: ue,
+        description: g,
+        message: B,
+        status: m,
+        required: P,
+        isLoading: Q,
+        children: /* @__PURE__ */ z("div", { className: "w-full relative inline-block", children: [
+          /* @__PURE__ */ z(
+            "button",
+            {
+              ref: (s) => {
+                E.setReference(s), typeof i == "function" ? i(s) : i && (i.current = s);
+              },
+              type: "button",
+              disabled: S,
+              "aria-expanded": c,
+              "aria-haspopup": "listbox",
+              "aria-invalid": m === "error",
+              className: F(
+                "w-full flex items-center justify-between font-normal text-left text-foreground transition-colors outline-none select-none cursor-pointer shrink-0",
+                "focus-visible:ring-2 focus-visible:ring-offset-2",
+                "disabled:pointer-events-none disabled:opacity-50 disabled:cursor-not-allowed",
+                Qe[ce],
+                Se,
+                be,
+                ye,
+                R && `bg-[${R}]`,
+                H
+              ),
+              style: ee,
+              ...ie(),
+              children: [
+                /* @__PURE__ */ f(
+                  "span",
+                  {
+                    className: l || n ? "text-foreground" : "text-foreground/70",
+                    children: Re
+                  }
+                ),
+                /* @__PURE__ */ f(
+                  Te,
+                  {
+                    className: F(
+                      "ml-2 shrink-0 text-foreground/70 transition-transform duration-200",
+                      c && "rotate-180"
+                    )
+                  }
+                )
+              ]
+            }
+          ),
+          /* @__PURE__ */ f(
+            Pe,
+            {
+              isOpen: c,
+              context: u,
+              floatingStyles: oe,
+              getFloatingProps: de,
+              setFloatingRef: E.setFloating,
+              options: p,
+              selectedValues: he,
+              onSelectOption: xe,
+              isSearch: G,
+              searchPlaceholder: Z,
+              searchInputName: $,
+              searchQuery: re,
+              onSearchChange: L,
+              belowList: q,
+              dropdownClassName: J,
+              variant: me,
+              color: fe,
+              radius: pe,
+              size: ve
+            }
+          )
+        ] })
+      }
+    );
+  }
+);
+Ze.displayName = "Select";
+export {
+  Ze as Select
+};

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

@@ -0,0 +1,3 @@
+export * from './Select';
+export * from './select-config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/select/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/components/select/index.js

@@ -0,0 +1,3 @@
+export * from "./Select.js";
+export * from "./select-config.js";
+export * from "./select-styles.js";

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

@@ -0,0 +1,27 @@
+import { Radius } from '../../shared/radius';
+import { Size } from '../../shared/size';
+import { Color, Variant } from '../../shared/variant';
+import { FieldConfig, FieldSizeKey } from '../field/field-config';
+export type SelectSizeKey = FieldSizeKey;
+export interface SelectOption {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+export interface SelectConfig extends Omit<FieldConfig, "size"> {
+    size?: SelectSizeKey;
+    radius?: Radius;
+    menuVariant?: Variant;
+    menuColor?: Color;
+    menuRadius?: Radius;
+    menuSize?: Size;
+}
+export declare const defaultSelectConfig: SelectConfig;
+export declare const FALLBACK_SELECT_CONFIG: Required<SelectConfig>;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        select: SelectConfig;
+    }
+}
+//# sourceMappingURL=select-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select-config.d.ts","sourceRoot":"","sources":["../../../src/components/select/select-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAEzC,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,YAAa,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7D,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,YAAY,CAYzD,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF"}

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

@@ -0,0 +1,25 @@
+"use client";
+import { registerComponentDefaults as e } from "../../libs/registry.js";
+import { FALLBACK_FIELD_CONFIG as t } from "../field/field-config.js";
+const l = {
+  size: "md",
+  labelAlign: "left",
+  variant: "bordered"
+}, o = {
+  ...t,
+  size: "md",
+  radius: "md",
+  variant: "bordered",
+  color: "primary",
+  status: "default",
+  labelAlign: "left",
+  menuVariant: "solid",
+  menuColor: "default",
+  menuRadius: "md",
+  menuSize: "lg"
+};
+e("select", l);
+export {
+  o as FALLBACK_SELECT_CONFIG,
+  l as defaultSelectConfig
+};

package/dist/components/select/select-styles.d.ts

@@ -0,0 +1,4 @@
+import { FieldSizeKey, FieldStatus } from '../field/field-config';
+export declare const SELECT_SIZE_CLASS: Record<FieldSizeKey, string>;
+export declare const SELECT_STATUS_BORDER_CLASS: Record<FieldStatus, string>;
+//# sourceMappingURL=select-styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select-styles.d.ts","sourceRoot":"","sources":["../../../src/components/select/select-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI1D,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQlE,CAAC"}

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

@@ -0,0 +1,15 @@
+"use client";
+const s = {
+  sm: "h-8 px-2.5 text-xs",
+  md: "h-10 px-3 text-sm",
+  lg: "h-12 px-4 text-base"
+}, e = {
+  default: "",
+  error: "border-danger focus-visible:border-danger focus-visible:ring-danger/20",
+  warning: "border-warning focus-visible:border-warning focus-visible:ring-warning/20",
+  success: "border-success focus-visible:border-success focus-visible:ring-success/20"
+};
+export {
+  s as SELECT_SIZE_CLASS,
+  e as SELECT_STATUS_BORDER_CLASS
+};

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

@@ -0,0 +1,40 @@
+import { FloatingContext } from '@floating-ui/react';
+import { ReactNode } from 'react';
+import { Radius } from '../../shared/radius';
+import { Size } from '../../shared/size';
+import { Color, Variant } from '../../shared/variant';
+export interface SelectOption {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+export interface SelectMenuProps {
+    isOpen: boolean;
+    context: FloatingContext;
+    floatingStyles: React.CSSProperties;
+    getFloatingProps: (userProps?: Record<string, unknown>) => Record<string, unknown>;
+    setFloatingRef: (node: HTMLElement | null) => void;
+    options: SelectOption[];
+    selectedValues?: (string | number)[];
+    onSelectOption: (option: SelectOption) => void;
+    isSearch?: boolean;
+    searchPlaceholder?: string;
+    searchInputName?: string;
+    searchQuery?: string;
+    onSearchChange?: (query: string) => void;
+    belowList?: ReactNode;
+    dropdownClassName?: string;
+    variant?: Variant;
+    color?: Color;
+    size?: Size;
+    radius?: Radius;
+    renderOption?: (option: SelectOption, isSelected: boolean) => ReactNode;
+    initialFocus?: number | React.RefObject<HTMLElement>;
+    returnFocus?: boolean;
+}
+export declare const SelectMenu: {
+    ({ isOpen, context, floatingStyles, getFloatingProps, setFloatingRef, options, selectedValues, onSelectOption, isSearch, searchPlaceholder, searchInputName, searchQuery, onSearchChange, belowList, dropdownClassName, variant, color, size, radius, renderOption, initialFocus, returnFocus, }: SelectMenuProps): import("react").JSX.Element | null;
+    displayName: string;
+};
+//# sourceMappingURL=SelectMenu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectMenu.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/SelectMenu.tsx"],"names":[],"mappings":"AAGA,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;AAK3D,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"}

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

@@ -0,0 +1,114 @@
+"use client";
+import { jsx as r, jsxs as d } from "react/jsx-runtime";
+import { cn as D } from "@asheeui/utils";
+import { FloatingFocusManager as L } from "@floating-ui/react";
+import { useState as R, useMemo as B } from "react";
+import { CheckIcon as K } from "../../icons/CheckIcon.js";
+import { SearchIcon as O } from "../../icons/SearchIcon.js";
+import { RADIUS_CLASS as U } from "../../shared/radius.js";
+import { resolveClassKey as _ } from "../../utils/resolve-token.js";
+import { Button as q } from "../button/Button.js";
+import { Input as E } from "../input/Input.js";
+const G = ({
+  isOpen: u,
+  context: f,
+  floatingStyles: p,
+  getFloatingProps: h,
+  setFloatingRef: b,
+  options: o = [],
+  selectedValues: x = [],
+  onSelectOption: g,
+  isSearch: n = !0,
+  searchPlaceholder: y = "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
+}) => {
+  const [Q, j] = R(""), t = w ?? Q, z = (e) => {
+    s ? s(e) : j(e);
+  }, m = B(() => !n || !t.trim() ? o : o.filter(
+    (e) => e.label.toLowerCase().includes(t.toLowerCase())
+  ), [o, n, t]), F = (e) => x.includes(e), A = _(
+    i === "full" ? "xl" : i ?? "md",
+    U,
+    "md"
+  );
+  return u ? /* @__PURE__ */ r(
+    L,
+    {
+      context: f,
+      modal: !1,
+      initialFocus: k,
+      returnFocus: M,
+      children: /* @__PURE__ */ r(
+        "div",
+        {
+          ref: b,
+          style: { ...p, zIndex: 99999 },
+          className: "w-full min-w-55 outline-none",
+          ...h(),
+          children: /* @__PURE__ */ d(
+            "div",
+            {
+              className: D(
+                "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",
+                "animate-in fade-in-0 zoom-in-95 slide-in-from-top-1 duration-150 ease-out",
+                A,
+                N
+              ),
+              children: [
+                n && /* @__PURE__ */ r("div", { className: "w-full p-1 mb-1 sticky top-0 z-10 border-b border-border", children: /* @__PURE__ */ r(
+                  E,
+                  {
+                    name: v,
+                    type: "text",
+                    value: t,
+                    onChange: (e) => z(e.target.value),
+                    startContent: /* @__PURE__ */ r(O, { className: "w-3.5 h-3.5  text-foreground/70" }),
+                    placeholder: y,
+                    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(
+                    q,
+                    {
+                      type: "button",
+                      variant: l ? C : "ghost",
+                      color: l ? S : "default",
+                      size: I,
+                      isDisabled: e.disabled,
+                      onClick: () => g(e),
+                      className: "w-full justify-between font-normal text-left transition-colors",
+                      children: [
+                        /* @__PURE__ */ r("span", { children: e.label }),
+                        l && /* @__PURE__ */ r(K, { className: "w-3.5 h-3.5 shrink-0 ml-2" })
+                      ]
+                    },
+                    String(e.value)
+                  );
+                }),
+                a && /* @__PURE__ */ r("div", { className: "border-t border-border pt-1 mt-1", children: a })
+              ]
+            }
+          )
+        }
+      )
+    }
+  ) : null;
+};
+G.displayName = "SelectMenu";
+export {
+  G as SelectMenu
+};

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

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/select-menu/index.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1 @@
+export * from "./SelectMenu.js";

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

@@ -0,0 +1,75 @@
+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. */
+    items?: SidebarItems<T>;
+    /** Key of currently active item. */
+    activeKey?: T;
+    /** Selection callback fired when an item is clicked. */
+    onSelect?: (item: SidebarItem<T>) => void;
+    /** Controlled collapsed drawer state. */
+    isCollapsed?: boolean;
+    /** Callback when collapse state changes. */
+    onCollapseChange?: (collapsed: boolean) => void;
+    /** Title displayed in the sidebar header when expanded. */
+    title?: ReactNode;
+    /** Header back button click handler. */
+    onBack?: () => void;
+    /** Custom back button icon element. */
+    backIcon?: ReactNode;
+    /** Optional user role string to filter item visibility against item.roles. */
+    userRole?: string;
+    /** Footer slot element. */
+    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. */
+    headerClassName?: string;
+    /** Navigation container class override. */
+    bodyClassName?: string;
+    /** Individual navigation item class override. */
+    itemClassName?: string;
+    /** Section label class override. */
+    sectionLabelClassName?: string;
+    /** Footer class override. */
+    footerClassName?: string;
+    /** 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). */
+    linkComponent?: ElementType;
+    /** Additional props to pass to the custom link component (e.g., { prefetch: true }). */
+    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;
+export declare namespace Sidebar {
+    var displayName: string;
+}
+//# sourceMappingURL=Sidebar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/components/sidebar/Sidebar.tsx"],"names":[],"mappings":"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"}