asheeui 0.6.1 → 0.6.3

package/dist/AsheeUIProvider.d.ts

@@ -1,5 +1,8 @@
 import { ReactNode } from 'react';
 import { ExternalConfig } from './config/config';
+/**
+ * Props for the AsheeUIProvider component.
+ */
 export interface AsheeUIProviderProps {
     /**
      * Optional partial runtime config merged over the library defaults.
@@ -9,6 +12,9 @@ export interface AsheeUIProviderProps {
      * defaults and per-component options at runtime.
      */
     config?: ExternalConfig;
+    /**
+     * The child components to render within the provider context.
+     */
     children: ReactNode;
 }
 /**
@@ -19,6 +25,15 @@ export interface AsheeUIProviderProps {
  * (consumed via `useAsheeConfig` / `useAshee`). Theme controller
  * setup and the pre-paint theme script are wired automatically.
  *
+ * This component must wrap the root of your application to enable
+ * all AsheeUI features. It sets up the theme system, config context,
+ * and ensures the theme is applied before the initial paint.
+ *
+ * @param props - The component props.
+ * @param props.config - Optional custom configuration.
+ * @param props.children - The child elements.
+ * @returns The provider component with theme and configuration context.
+ *
  * @example
  * ```tsx
  * import { AsheeUIProvider } from "asheeui";
@@ -28,6 +43,25 @@ export interface AsheeUIProviderProps {
  *   return <AsheeUIProvider config={config}>{children}</AsheeUIProvider>;
  * }
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Inline configuration
+ * <AsheeUIProvider
+ *   config={{
+ *     defaultTheme: 'dark',
+ *     defaultVariant: 'ghost',
+ *     components: {
+ *       Button: { radius: 'lg' }
+ *     }
+ *   }}
+ * >
+ *   <App />
+ * </AsheeUIProvider>
+ * ```
+ *
+ * @see useAsheeConfig - Hook for accessing the resolved configuration.
+ * @see AsheeThemeScript - Component that applies theme class before paint.
  */
 export declare function AsheeUIProvider({ config, children, }: AsheeUIProviderProps): import("react").JSX.Element;
 //# sourceMappingURL=AsheeUIProvider.d.ts.map

package/dist/AsheeUIProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsheeUIProvider.d.ts","sourceRoot":"","sources":["../src/AsheeUIProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOtD,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAW,EACX,QAAQ,GACT,EAAE,oBAAoB,+BAgBtB"}
+{"version":3,"file":"AsheeUIProvider.d.ts","sourceRoot":"","sources":["../src/AsheeUIProvider.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAW,EACX,QAAQ,GACT,EAAE,oBAAoB,+BAgBtB"}

package/dist/components/accordion/Accordion.d.ts

@@ -1,64 +1,52 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { AccordionItem, AccordionSizeKey, AccordionVariant } from './accordion-config';
+import { AccordionConfig, AccordionItem } from './accordion-config';
+type BaseAccordionProps = AccordionConfig & Omit<React.HTMLAttributes<HTMLDivElement>, "value" | "defaultValue" | "onChange">;
 /**
  * Configuration options for the Accordion component.
  */
-export interface AccordionProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "value" | "defaultValue" | "onChange"> {
-    /** The accordion items to render.
+export interface AccordionProps extends BaseAccordionProps {
+    /**
+     * The accordion items to render.
+     * Each item must have a title and content, with optional id, subtitle,
+     * icon, and disabled state.
      *
      * @default []
      */
     items: AccordionItem[];
-    /** Visual style variant.
-     *
-     * @default "separated"
-     */
-    variant?: AccordionVariant;
-    /** Padding and spacing scale.
-     *
-     * @default "md"
-     */
-    size?: AccordionSizeKey;
-    /** Corner rounding applied to separated and ghost item containers.
-     *
-     * @default "md"
-     */
-    radius?: Radius;
-    /** Allows more than one item to remain open at the same time.
-     *
-     * @default false
-     */
-    allowMultiple?: boolean;
-    /** Initial open item keys for the uncontrolled mode.
-     *
-     * Pass a `string` for single-open mode or `string[]` when
-     * `allowMultiple` is enabled.
+    /**
+     * Default open item keys for uncontrolled usage.
+     * Can be a single key or array of keys when allowMultiple is true.
      */
     defaultValue?: string | string[];
-    /** Controlled open item keys.
+    /**
+     * Controlled open item keys.
      *
      * When provided, the component becomes controlled and updates are
      * reported through `onValueChange`.
      */
     value?: string | string[];
-    /** Callback fired with the current open item keys. */
+    /**
+     * Callback fired with the current open item keys.
+     * Called whenever the open state changes.
+     */
     onValueChange?: (value: string[]) => void;
-    /** Custom node rendered as the expand indicator.
+    /**
+     * Custom node rendered as the expand indicator.
      *
      * Defaults to a rotating chevron-down icon.
      */
     expandIcon?: ReactNode;
-    /** Disables all expand/collapse animations.
-     *
-     * @default false
+    /**
+     * Extra classes applied to each item container.
      */
-    disableAnimation?: boolean;
-    /** Extra classes applied to each item container. */
     itemClassName?: string;
-    /** Extra classes applied to each header trigger button. */
+    /**
+     * Extra classes applied to each header trigger button.
+     */
     headerClassName?: string;
-    /** Extra classes applied to each content panel. */
+    /**
+     * Extra classes applied to each content panel.
+     */
     contentClassName?: string;
 }
 /**
@@ -71,23 +59,28 @@ export interface AccordionProps extends Omit<React.HTMLAttributes<HTMLDivElement
  * through the standard AsheeUI cascade: prop, component config, global
  * theme defaults, and finally the built-in fallback.
  *
- * @param props - Accordion configuration options and HTML div element
- *   props.
+ * The component automatically handles accessibility attributes including
+ * aria-expanded, aria-controls, and proper keyboard interaction. Each
+ * item's header acts as a button that toggles the visibility of its
+ * corresponding content panel.
+ *
+ * @param props - Accordion configuration options and HTML div element props.
  * @param props.items - Accordion items to render.
  * @param props.variant - Visual style variant. Defaults to "separated".
  * @param props.size - Density scale. Defaults to "md".
  * @param props.radius - Corner rounding. Defaults to "md".
- * @param props.allowMultiple - Allow multiple open items. Defaults to
- *   false.
+ * @param props.allowMultiple - Allow multiple open items. Defaults to false.
  * @param props.defaultValue - Uncontrolled initial open keys.
  * @param props.value - Controlled open keys.
  * @param props.onValueChange - Change callback with open keys.
  * @param props.expandIcon - Custom expand indicator node.
- * @param props.disableAnimation - Disable animations. Defaults to
- *   false.
+ * @param props.disableAnimation - Disable animations. Defaults to false.
  * @param props.itemClassName - Extra classes for each item.
  * @param props.headerClassName - Extra classes for each header.
  * @param props.contentClassName - Extra classes for each content panel.
+ * @param props.className - Extra classes for the container.
+ * @param props.style - Inline styles for the container.
+ * @param props.id - Optional ID for the container element.
  *
  * @example
  * ```tsx
@@ -105,6 +98,24 @@ export interface AccordionProps extends Omit<React.HTMLAttributes<HTMLDivElement
  *   );
  * }
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Controlled accordion with multiple open items
+ * const [openItems, setOpenItems] = useState(['item-1']);
+ *
+ * <Accordion
+ *   value={openItems}
+ *   onValueChange={setOpenItems}
+ *   allowMultiple
+ *   items={items}
+ * />
+ * ```
+ *
+ * @see AccordionConfig - The configuration type for component defaults.
+ * @see AccordionItem - The structure of a single accordion item.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
  */
 export declare const Accordion: import('react').ForwardRefExoticComponent<AccordionProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
 //# sourceMappingURL=Accordion.d.ts.map

package/dist/components/accordion/Accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/Accordion.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAGf,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAOhE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAEtB,MAAM,oBAAoB,CAAC;AAU5B;;GAEG;AACH,MAAM,WAAW,cACf,SAAQ,IAAI,CACV,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EACpC,OAAO,GAAG,cAAc,GAAG,UAAU,CACtC;IACD;;;OAGG;IACH,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,sDAAsD;IACtD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,SAAS,2GAqOrB,CAAC"}
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/Accordion.tsx"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAUf,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAInB,MAAM,oBAAoB,CAAC;AAU5B,KAAK,kBAAkB,GAAG,eAAe,GACvC,IAAI,CACF,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EACpC,OAAO,GAAG,cAAc,GAAG,UAAU,CACtC,CAAC;AAEJ;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD;;;;;;OAMG;IACH,KAAK,EAAE,aAAa,EAAE,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEjC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAE1C;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,eAAO,MAAM,SAAS,2GAmOrB,CAAC"}

package/dist/components/accordion/Accordion.js

@@ -1,19 +1,19 @@
 "use client";
 import { jsx as t, jsxs as u } from "react/jsx-runtime";
-import { forwardRef as Y, useId as ee, useCallback as y, useState as se } from "react";
+import { forwardRef as Y, useId as ee, useCallback as O, useState as se } from "react";
 import { ChevronDownIcon as re } from "../../icons/ChevronDownIcon.js";
 import { useAsheeConfig as te } from "../../libs/context.js";
-import { RADIUS_CLASS as oe } from "../../shared/radius.js";
-import { resolveCascade as v, resolveRadiusKey as ie, resolveClassKey as A } from "../../utils/resolve-token.js";
+import { resolveCascade as v, resolveRadiusKey as oe, resolveClassKey as A } from "../../utils/resolve-token.js";
 import { FALLBACK_ACCORDION_CONFIG as o } from "./accordion-config.js";
-import { ACCORDION_HEADER_SIZE_CLASS as ne, ACCORDION_CONTENT_SIZE_CLASS as ae, ACCORDION_VARIANT_ITEM_CLASS as _, ACCORDION_VARIANT_CONTAINER_CLASS as R } from "./accordion-styles.js";
+import { ACCORDION_HEADER_SIZE_CLASS as ie, ACCORDION_CONTENT_SIZE_CLASS as ne, ACCORDION_VARIANT_ITEM_CLASS as _, ACCORDION_VARIANT_CONTAINER_CLASS as R } from "./accordion-styles.js";
+import { RADIUS_CLASS as ae } from "../../shared/radius.js";
 import { cn as n } from "../../utils/cn.js";
 const le = Y(
   ({
     items: g = [],
     variant: z,
-    size: D,
-    radius: K,
+    size: K,
+    radius: D,
     allowMultiple: E,
     defaultValue: L,
     value: b,
@@ -29,8 +29,8 @@ const le = Y(
     ...k
   }, B) => {
     var S;
-    const f = te(), s = (S = f.components) == null ? void 0 : S.accordion, G = ee(), m = Z ?? G, h = v(
-      D,
+    const f = te(), s = (S = f.components) == null ? void 0 : S.accordion, G = ee(), m = Z ?? G, w = v(
+      K,
       s == null ? void 0 : s.size,
       void 0,
       o.size
@@ -39,40 +39,40 @@ const le = Y(
       s == null ? void 0 : s.variant,
       f.defaultVariant,
       o.variant
-    ), w = v(
+    ), I = v(
       E,
       s == null ? void 0 : s.allowMultiple,
       void 0,
       o.allowMultiple
-    ), H = ie(
-      K,
+    ), H = oe(
+      D,
       s == null ? void 0 : s.radius,
       f.defaultRadius,
       o.radius
     ), U = R[i] ?? R.separated, q = _[i] ?? _.separated, J = A(
-      h,
-      ne,
+      w,
+      ie,
       o.size
     ), P = A(
-      h,
-      ae,
+      w,
+      ne,
       o.size
-    ), I = A(
+    ), h = A(
       H,
-      oe,
+      ae,
       o.radius
-    ), p = b !== void 0, C = y(
+    ), p = b !== void 0, C = O(
       (e) => e === void 0 ? [] : Array.isArray(e) ? e : [e],
       []
     ), [Q, W] = se(
       () => C(L)
-    ), a = p ? C(b) : Q, X = y(
+    ), a = p ? C(b) : Q, X = O(
       (e, N) => {
         if (N) return;
         let r;
-        a.includes(e) ? r = a.filter((c) => c !== e) : r = w ? [...a, e] : [e], p || W(r), d == null || d(r);
+        a.includes(e) ? r = a.filter((c) => c !== e) : r = I ? [...a, e] : [e], p || W(r), d == null || d(r);
       },
-      [a, p, d, w]
+      [a, p, d, I]
     );
     return /* @__PURE__ */ t(
       "div",
@@ -82,20 +82,20 @@ const le = Y(
         className: n(
           "w-full",
           U,
-          i !== "ghost" && i !== "flush" && I,
+          i !== "ghost" && i !== "flush" && h,
           V
         ),
         style: F,
         ...k,
         children: g.map((e, N) => {
-          const r = e.id || `item-${N}`, l = a.includes(r), c = `${m}-header-${r}`, O = `${m}-content-${r}`;
+          const r = e.id || `item-${N}`, l = a.includes(r), c = `${m}-header-${r}`, y = `${m}-content-${r}`;
           return /* @__PURE__ */ u(
             "div",
             {
               className: n(
                 "w-full transition-colors box-border",
                 q,
-                (i === "separated" || i === "ghost") && I,
+                (i === "separated" || i === "ghost") && h,
                 $
               ),
               children: [
@@ -105,7 +105,7 @@ const le = Y(
                     id: c,
                     type: "button",
                     "aria-expanded": l,
-                    "aria-controls": O,
+                    "aria-controls": y,
                     disabled: e.disabled,
                     onClick: () => X(r, e.disabled),
                     className: n(
@@ -138,7 +138,7 @@ const le = Y(
                 /* @__PURE__ */ t(
                   "section",
                   {
-                    id: O,
+                    id: y,
                     "aria-labelledby": c,
                     "data-state": l ? "open" : "closed",
                     className: n(
@@ -146,7 +146,7 @@ const le = Y(
                       x ? "transition-none" : "",
                       l ? "grid-rows-[1fr] opacity-100" : "grid-rows-[0fr] opacity-0 pointer-events-none"
                     ),
-                    children: /* @__PURE__ */ t("div", { className: "overflow-hidden w-full", children: /* @__PURE__ */ t(
+                    children: /* @__PURE__ */ t("div", { className: "overflow-clip w-full", children: /* @__PURE__ */ t(
                       "div",
                       {
                         className: n(

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

@@ -1,6 +1,5 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
+import { Radius, Size } from '../../shared';
 /**
  * Visual style of the accordion.
  *
@@ -10,7 +9,10 @@ import { Size } from '../../shared/size';
  * - `flush`: No container, borders, or dividers.
  */
 export type AccordionVariant = "bordered" | "separated" | "ghost" | "flush";
-/** Padding and spacing scale used by accordion headers and content. */
+/**
+ * Padding and spacing scale used by accordion headers and content.
+ * Maps to the standard Size type: "sm", "md", or "lg".
+ */
 export type AccordionSizeKey = Size;
 /**
  * A single accordion entry.
@@ -22,15 +24,25 @@ export interface AccordionItem {
      * When omitted, the item's `title` is used as the key.
      */
     id?: string;
-    /** Item header label. */
+    /**
+     * Item header label.
+     */
     title: ReactNode;
-    /** Expandable content rendered below the header. */
+    /**
+     * Expandable content rendered below the header.
+     */
     content: ReactNode;
-    /** Optional secondary text shown under the title. */
+    /**
+     * Optional secondary text shown under the title.
+     */
     subtitle?: ReactNode;
-    /** Optional leading icon rendered before the title. */
+    /**
+     * Optional leading icon rendered before the title.
+     */
     icon?: ReactNode;
-    /** Disables the item's trigger when `true`.
+    /**
+     * Disables the item's trigger when `true`.
+     * Disabled items cannot be opened or closed by the user.
      *
      * @default false
      */
@@ -43,26 +55,41 @@ export interface AccordionItem {
  * under `components.accordion` in the AsheeUI config.
  */
 export interface AccordionConfig {
-    /** Visual style variant.
+    /**
+     * Visual style variant.
+     * Controls the container and item appearance.
      *
      * @default "separated"
      */
     variant?: AccordionVariant;
-    /** Padding and spacing scale.
+    /**
+     * Padding and spacing scale.
+     * Controls the density of headers and content panels.
      *
      * @default "md"
      */
     size?: AccordionSizeKey;
-    /** Corner rounding.
+    /**
+     * Corner rounding.
+     * Controls the border-radius of the container or individual items.
      *
      * @default "md"
      */
     radius?: Radius;
-    /** Allows more than one item to stay open at a time.
+    /**
+     * Allows more than one item to stay open at a time.
+     * When false, opening one item closes all others.
      *
      * @default false
      */
     allowMultiple?: boolean;
+    /**
+     * Disables all expand/collapse animations.
+     * When true, items open and close instantly without transitions.
+     *
+     * @default false
+     */
+    disableAnimation?: boolean;
 }
 /**
  * Default config values registered for the Accordion component.
@@ -78,6 +105,8 @@ declare module "../../libs/registry" {
 }
 /**
  * Hard fallback values used when no config tier provides a value.
+ * These values are used when all other cascade tiers (instance prop,
+ * component config, and global default) are undefined.
  */
 export declare const FALLBACK_ACCORDION_CONFIG: {
     readonly size: "md";

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

@@ -1 +1 @@
-{"version":3,"file":"accordion-config.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/accordion-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,oDAAoD;IACpD,OAAO,EAAE,SAAS,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAGpC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,SAAS,EAAE,eAAe,CAAC;KAC5B;CACF;AAID;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;CAK5B,CAAC"}
+{"version":3,"file":"accordion-config.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/accordion-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAE3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAGpC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,SAAS,EAAE,eAAe,CAAC;KAC5B;CACF;AAID;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;CAK5B,CAAC"}

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

@@ -1,6 +1,26 @@
 import { AccordionSizeKey, AccordionVariant } from './accordion-config';
+/**
+ * CSS classes for accordion header padding and font size.
+ * Maps size keys to Tailwind classes that control the header's
+ * spacing and typography.
+ */
 export declare const ACCORDION_HEADER_SIZE_CLASS: Record<AccordionSizeKey, string>;
+/**
+ * CSS classes for accordion content padding and font size.
+ * Maps size keys to Tailwind classes that control the content panel's
+ * spacing and typography.
+ */
 export declare const ACCORDION_CONTENT_SIZE_CLASS: Record<AccordionSizeKey, string>;
+/**
+ * CSS classes for accordion container based on variant.
+ * These classes control the overall container appearance, including
+ * borders, dividers, and spacing between items.
+ */
 export declare const ACCORDION_VARIANT_CONTAINER_CLASS: Record<AccordionVariant, string>;
+/**
+ * CSS classes for individual accordion items based on variant.
+ * These classes control the appearance of each item, including
+ * backgrounds, borders, and hover states.
+ */
 export declare const ACCORDION_VARIANT_ITEM_CLASS: Record<AccordionVariant, string>;
 //# sourceMappingURL=accordion-styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"accordion-styles.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/accordion-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAIxE,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAIzE,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,MAAM,CACpD,gBAAgB,EAChB,MAAM,CAMP,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAMzE,CAAC"}
+{"version":3,"file":"accordion-styles.d.ts","sourceRoot":"","sources":["../../../src/components/accordion/accordion-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAIxE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAIzE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CACpD,gBAAgB,EAChB,MAAM,CAMP,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAMzE,CAAC"}

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

@@ -13,7 +13,7 @@ const r = {
   ghost: "divide-y divide-border border-y border-border",
   flush: "space-y-1"
 }, s = {
-  bordered: "bg-secondary transition-colors hover:bg-secondary/30",
+  bordered: "bg-secondary transition-colors hover:bg-foreground/10",
   separated: "border border-border bg-secondary transition-colors hover:bg-secondary/30 shadow-xs",
   ghost: "bg-transparent transition-colors hover:bg-secondary/20",
   flush: "bg-transparent hover:bg-secondary/50 transition-colors"

package/dist/components/autocomplete/Autocomplete.d.ts

@@ -1,55 +1,53 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
-import { Color, Variant } from '../../shared/variant';
 import { InputProps } from '../input/Input';
-import { AutocompleteOption } from './autocomplete-config';
+import { SelectMenuOption } from '../select-menu';
+import { AutocompleteConfig } from './autocomplete-config';
+type BaseAutocompleteProps = AutocompleteConfig & Omit<InputProps, "value" | "onChange">;
 /**
  * Configuration options for the Autocomplete component.
  */
-export interface AutocompleteProps extends Omit<InputProps, "value" | "onChange"> {
-    /** Suggestions shown while the user types.
+export interface AutocompleteProps extends BaseAutocompleteProps {
+    /**
+     * Suggestions shown while the user types.
+     * Each option must have a label and a unique value.
      *
      * @default []
      */
-    options: AutocompleteOption[];
-    /** Controlled selected value, shown as its option label. */
+    options: SelectMenuOption[];
+    /**
+     * Controlled selected value, shown as its option label.
+     * When allowCustomValue is true, this can be a free-form string.
+     */
     value?: string | number;
-    /** Callback fired with the selected value and option. */
-    onValueChange?: (value: string | number, option?: AutocompleteOption) => void;
-    /** Callback fired whenever the raw input text changes. */
+    /**
+     * Callback fired with the selected value and option.
+     * Called when a suggestion is selected from the dropdown.
+     */
+    onValueChange?: (value: string | number, option?: SelectMenuOption) => void;
+    /**
+     * Callback fired whenever the raw input text changes.
+     * Called on every keystroke, providing the current input value.
+     */
     onInputChange?: (inputValue: string) => void;
-    /** Allows free-form values that are not in the options list.
+    /**
+     * Allows free-form values that are not in the options list.
      *
      * When enabled, typing emits the raw text through `onValueChange`.
+     * The dropdown will still show filtered suggestions, but the user
+     * can enter any text.
      *
      * @default false
      */
     allowCustomValue?: boolean;
-    /** Content rendered below the options list. */
-    belowList?: ReactNode;
-    /** Extra classes applied to the floating dropdown. */
-    dropdownClassName?: string;
-    /** Visual style of the dropdown menu.
-     *
-     * @default "solid"
-     */
-    menuVariant?: Variant;
-    /** Theme accent color of the dropdown menu.
-     *
-     * @default "default"
-     */
-    menuColor?: Color;
-    /** Corner rounding of the dropdown menu.
-     *
-     * @default "md"
+    /**
+     * Content rendered below the options list.
+     * Useful for adding "Add new" buttons or status messages.
      */
-    menuRadius?: Radius;
-    /** Density scale of the dropdown menu.
-     *
-     * @default "sm"
+    belowList?: ReactNode;
+    /**
+     * Extra classes applied to the floating dropdown.
      */
-    menuSize?: Size;
+    dropdownClassName?: string;
 }
 /**
  * A text input with a filterable suggestion dropdown.
@@ -60,19 +58,25 @@ export interface AutocompleteProps extends Omit<InputProps, "value" | "onChange"
  * values are supported via `allowCustomValue`. Menu tokens resolve
  * through the standard AsheeUI cascade.
  *
+ * The component handles accessibility through Floating UI's interaction
+ * hooks, including focus management, dismissal on outside clicks,
+ * and proper ARIA roles for the combobox pattern.
+ *
  * @param props - Autocomplete configuration options and input props.
  * @param props.options - Suggestion list.
  * @param props.value - Controlled selected value.
  * @param props.onValueChange - Selection callback.
  * @param props.onInputChange - Raw input change callback.
- * @param props.allowCustomValue - Allow free-form values. Defaults to
- *   false.
+ * @param props.allowCustomValue - Allow free-form values. Defaults to false.
  * @param props.belowList - Content below the options list.
  * @param props.dropdownClassName - Extra dropdown classes.
  * @param props.menuVariant - Dropdown variant. Defaults to "solid".
- * @param props.menuColor - Dropdown color. Defaults to "default".
- * @param props.menuRadius - Dropdown radius. Defaults to "md".
- * @param props.menuSize - Dropdown density. Defaults to "sm".
+ * @param props.color - Dropdown color. Defaults to "default".
+ * @param props.radius - Dropdown radius. Defaults to "md".
+ * @param props.size - Dropdown density. Defaults to "sm".
+ * @param props.disabled - Whether the input is disabled.
+ * @param props.placeholder - Placeholder text for the input.
+ * @param props.className - Extra classes for the input.
  *
  * @example
  * ```tsx
@@ -91,6 +95,22 @@ export interface AutocompleteProps extends Omit<InputProps, "value" | "onChange"
  *   );
  * }
  * ```
+ *
+ * @example
+ * ```tsx
+ * // With free-form values
+ * <Autocomplete
+ *   allowCustomValue
+ *   options={fruits}
+ *   onValueChange={(value) => console.log('Selected:', value)}
+ *   placeholder="Type a fruit name..."
+ * />
+ * ```
+ *
+ * @see AutocompleteConfig - The configuration type for component defaults.
+ * @see SelectMenu - The dropdown component used for suggestions.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
  */
 export declare const Autocomplete: import('react').ForwardRefExoticComponent<AutocompleteProps & import('react').RefAttributes<HTMLInputElement>>;
+export {};
 //# sourceMappingURL=Autocomplete.d.ts.map