@mks2508/mks-ui 0.1.4 → 0.2.1

package/dist/react-ui/primitives/Highlight/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react-ui/primitives/Highlight/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EAGpB,MAAM,mBAAmB,CAAC;AAc3B;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,CAAC,SAAS,MAAM,KAAK,oBAAoB,CAAC,CAAC,CAAC,CAMjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,SAAS,CAAC,CAAC,SAAS,KAAK,CAAC,WAAW,GAAG,KAAK,EAAE,EACtD,GAAG,EACH,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,CAAC,CAAC,2CAwNpB;AAiBD;;;;;;;;;;;;;;GAcG;AACH,iBAAS,aAAa,CAAC,CAAC,SAAS,KAAK,CAAC,WAAW,EAAE,EAClD,GAAG,EACH,EAAE,EACF,QAAQ,EACR,EAAE,EACF,KAAK,EACL,SAAS,EACT,KAAK,EACL,UAAU,EACV,QAAgB,EAChB,eAAe,EACf,SAAS,EACT,OAAe,EACf,iBAAiB,EACjB,GAAG,KAAK,EACT,EAAE,mBAAmB,CAAC,CAAC,CAAC,OA2OxB;AAED,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,GACb,CAAC;AAGF,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,MAAM,EACN,aAAa,EACb,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/{components/animate-ui/primitives/effects/highlight.js → react-ui/primitives/Highlight/index.js}

@@ -1,11 +1,11 @@
 'use client';
 
-import { cn } from "../../../../lib/utils.js";
+import { cn } from "../../lib/utils.js";
 import * as React from "react";
 import { AnimatePresence, motion } from "motion/react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 
-//#region src/components/animate-ui/primitives/effects/highlight.tsx
+//#region src/react-ui/primitives/Highlight/index.tsx
 const DEFAULT_BOUNDS_OFFSET = {
 	top: 0,
 	left: 0,
@@ -13,11 +13,36 @@ const DEFAULT_BOUNDS_OFFSET = {
 	height: 0
 };
 const HighlightContext = React.createContext(void 0);
+/**
+* Hook to access the Highlight context.
+* Must be used within a Highlight provider.
+*
+* @returns The current highlight context
+*/
 function useHighlight() {
 	const context = React.useContext(HighlightContext);
 	if (!context) throw new Error("useHighlight must be used within a HighlightProvider");
 	return context;
 }
+/**
+* Highlight primitive — animated background indicator that follows the active item.
+* Supports two modes: "children" (layoutId-based per item) and "parent" (absolute positioned).
+*
+* This is an internal primitive used by Tabs, Menu, and similar components.
+*
+* @param mode - Tracking mode: 'children' or 'parent'
+* @param hover - Activate on hover instead of click
+* @param click - Activate on click (default: true)
+* @param transition - Motion transition config
+*
+* @example
+* ```tsx
+* <Highlight hover>
+*   <HighlightItem><button>Tab 1</button></HighlightItem>
+*   <HighlightItem><button>Tab 2</button></HighlightItem>
+* </Highlight>
+* ```
+*/
 function Highlight({ ref, ...props }) {
 	const { as: Component = "div", children, value, defaultValue, onValueChange, className, style, transition = {
 		type: "spring",
@@ -182,6 +207,21 @@ function getNonOverridingDataAttributes(element, dataAttributes) {
 		return acc;
 	}, {});
 }
+/**
+* HighlightItem — a single item within a Highlight container.
+* Tracks its own position and renders the animated highlight indicator.
+*
+* @param value - Unique identifier for this item
+* @param activeClassName - Additional class when this item is active
+* @param asChild - Use the child element directly instead of wrapping
+*
+* @example
+* ```tsx
+* <HighlightItem value="tab-1">
+*   <button>Tab 1</button>
+* </HighlightItem>
+* ```
+*/
 function HighlightItem({ ref, as, children, id, value, className, style, transition, disabled = false, activeClassName, exitDelay, asChild = false, forceUpdateBounds, ...props }) {
 	const itemId = React.useId();
 	const { activeValue, setActiveValue, mode, setBounds, clearBounds, hover, click, enabled, className: contextClassName, style: contextStyle, transition: contextTransition, id: contextId, disabled: contextDisabled, exitDelay: contextExitDelay, forceUpdateBounds: contextForceUpdateBounds, setActiveClassName } = useHighlight();

package/dist/react-ui/primitives/Slot/index.d.ts

@@ -0,0 +1,53 @@
+import * as React from 'react';
+import { type HTMLMotionProps } from 'motion/react';
+type AnyProps = Record<string, unknown>;
+type DOMMotionProps<T extends HTMLElement = HTMLElement> = Omit<HTMLMotionProps<keyof HTMLElementTagNameMap>, 'ref'> & {
+    ref?: React.Ref<T>;
+};
+type WithAsChild<Base extends object> = (Base & {
+    asChild: true;
+    children: React.ReactElement;
+}) | (Base & {
+    asChild?: false | undefined;
+});
+/**
+ * Props for the Slot component.
+ *
+ * @example
+ * ```tsx
+ * <Slot asChild>
+ *   <button>Click me</button>
+ * </Slot>
+ * ```
+ */
+export interface ISlotProps<T extends HTMLElement = HTMLElement> extends DOMMotionProps<T> {
+    /** Child element to render with motion enhancements. */
+    children?: any;
+}
+type SlotProps<T extends HTMLElement = HTMLElement> = ISlotProps<T>;
+/**
+ * Slot component - Motion-enhanced composition primitive.
+ *
+ * Wraps a child element with motion capabilities using the asChild pattern.
+ * When the child is already a motion component, it's used directly.
+ * Otherwise, a motion wrapper is created with the child's element type.
+ *
+ * @param children - Child element to render with motion enhancements
+ * @param ref - Ref to the merged element
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <Slot asChild>
+ *   <button>Click me</button>
+ * </Slot>
+ *
+ * // With motion props
+ * <Slot asChild>
+ *   <button onClick={handleClick}>Hover me</button>
+ * </Slot>
+ * ```
+ */
+export declare function Slot<T extends HTMLElement = HTMLElement>({ children, ref, ...props }: SlotProps<T>): import("react/jsx-runtime").JSX.Element | null;
+export type { WithAsChild, DOMMotionProps, AnyProps };
+//# sourceMappingURL=index.d.ts.map

package/dist/react-ui/primitives/Slot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react-ui/primitives/Slot/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/E,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExC,KAAK,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,IAAI,CAC7D,eAAe,CAAC,MAAM,qBAAqB,CAAC,EAC5C,KAAK,CACN,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAE3B,KAAK,WAAW,CAAC,IAAI,SAAS,MAAM,IAChC,CAAC,IAAI,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAA;CAAE,CAAC,GACxD,CAAC,IAAI,GAAG;IAAE,OAAO,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,CAAC,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CAC7D,SAAQ,cAAc,CAAC,CAAC,CAAC;IACzB,wDAAwD;IAExD,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,KAAK,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAwCpE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACxD,QAAQ,EACR,GAAG,EACH,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,CAAC,CAAC,kDAuBd;AAED,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC"}

package/dist/{components/animate-ui/primitives/animate/slot.js → react-ui/primitives/Slot/index.js}

@@ -1,11 +1,11 @@
 'use client';
 
-import { cn } from "../../../../lib/utils.js";
+import { cn } from "../../lib/utils.js";
 import * as React from "react";
 import { isMotionComponent, motion } from "motion/react";
 import { jsx } from "react/jsx-runtime";
 
-//#region src/components/animate-ui/primitives/animate/slot.tsx
+//#region src/react-ui/primitives/Slot/index.tsx
 function mergeRefs(...refs) {
 	return (node) => {
 		refs.forEach((ref) => {
@@ -27,6 +27,29 @@ function mergeProps(childProps, slotProps) {
 	};
 	return merged;
 }
+/**
+* Slot component - Motion-enhanced composition primitive.
+*
+* Wraps a child element with motion capabilities using the asChild pattern.
+* When the child is already a motion component, it's used directly.
+* Otherwise, a motion wrapper is created with the child's element type.
+*
+* @param children - Child element to render with motion enhancements
+* @param ref - Ref to the merged element
+*
+* @example
+* ```tsx
+* // Basic usage
+* <Slot asChild>
+*   <button>Click me</button>
+* </Slot>
+*
+* // With motion props
+* <Slot asChild>
+*   <button onClick={handleClick}>Hover me</button>
+* </Slot>
+* ```
+*/
 function Slot({ children, ref, ...props }) {
 	const isAlreadyMotion = typeof children.type === "object" && children.type !== null && isMotionComponent(children.type);
 	const Base = React.useMemo(() => isAlreadyMotion ? children.type : motion.create(children.type), [isAlreadyMotion, children.type]);

package/dist/react-ui/primitives/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Primitives barrel export.
+ *
+ * Building blocks for components. Not meant to be used directly by consumers.
+ *
+ * @module @mks2508/mks-ui/react/primitives
+ */
+export * from './Slot';
+export * from './Highlight';
+export * from './AutoHeight';
+export * from './CountingNumber';
+//# sourceMappingURL=index.d.ts.map

package/dist/react-ui/primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react-ui/primitives/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/react-ui/primitives/index.js

@@ -0,0 +1,4 @@
+import { Slot } from "./Slot/index.js";
+import { Highlight, HighlightItem, useHighlight } from "./Highlight/index.js";
+import { AutoHeight } from "./AutoHeight/index.js";
+import { CountingNumber } from "./CountingNumber/index.js";

package/dist/react-ui/ui/Accordion/Accordion.styles.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Style slots and CVA variants for the Accordion component.
+ *
+ * Defines the visual regions (slots) and variant-based styling
+ * using Class Variance Authority (CVA).
+ *
+ * @module @mks2508/mks-ui/react/ui/Accordion/Accordion.styles
+ */
+import { type VariantProps } from 'class-variance-authority';
+import type { StyleSlots } from '../../../core/types';
+import type { AccordionSlot } from './Accordion.types';
+/**
+ * Default Tailwind classes for each visual region of the Accordion.
+ *
+ * @example
+ * ```typescript
+ * import { AccordionStyles } from '@mks2508/mks-ui';
+ *
+ * // Access individual slot defaults
+ * console.log(AccordionStyles.root);   // base root classes
+ * console.log(AccordionStyles.trigger); // base trigger classes
+ * ```
+ */
+export declare const AccordionStyles: StyleSlots<AccordionSlot>;
+/**
+ * CVA variants for the Accordion root element.
+ *
+ * Provides `default` and `bordered` visual variants that control
+ * the overall appearance of the accordion container.
+ *
+ * @example
+ * ```typescript
+ * import { accordionVariants } from '@mks2508/mks-ui';
+ *
+ * // Get class string for bordered variant
+ * const classes = accordionVariants({ variant: 'bordered' });
+ * ```
+ */
+export declare const accordionVariants: (props?: ({
+    variant?: "default" | "bordered" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Variant props extracted from {@link accordionVariants}.
+ * Use this to type-check the `variant` prop on the Accordion root.
+ */
+export type AccordionVariantProps = VariantProps<typeof accordionVariants>;
+//# sourceMappingURL=Accordion.styles.d.ts.map

package/dist/react-ui/ui/Accordion/Accordion.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Accordion.styles.d.ts","sourceRoot":"","sources":["../../../../src/react-ui/ui/Accordion/Accordion.styles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,aAAa,CAOrD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB;;8EAgB5B,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/react-ui/ui/Accordion/Accordion.styles.js

@@ -0,0 +1,54 @@
+import { cva } from "class-variance-authority";
+
+//#region src/react-ui/ui/Accordion/Accordion.styles.ts
+/**
+* Style slots and CVA variants for the Accordion component.
+*
+* Defines the visual regions (slots) and variant-based styling
+* using Class Variance Authority (CVA).
+*
+* @module @mks2508/mks-ui/react/ui/Accordion/Accordion.styles
+*/
+/**
+* Default Tailwind classes for each visual region of the Accordion.
+*
+* @example
+* ```typescript
+* import { AccordionStyles } from '@mks2508/mks-ui';
+*
+* // Access individual slot defaults
+* console.log(AccordionStyles.root);   // base root classes
+* console.log(AccordionStyles.trigger); // base trigger classes
+* ```
+*/
+const AccordionStyles = {
+	root: "flex flex-col",
+	item: "border-b border-border",
+	header: "flex",
+	trigger: "flex flex-1 items-center justify-between py-4 text-sm font-medium transition-all hover:underline [&[data-panel-open]>svg]:rotate-180",
+	panel: "overflow-hidden text-sm"
+};
+/**
+* CVA variants for the Accordion root element.
+*
+* Provides `default` and `bordered` visual variants that control
+* the overall appearance of the accordion container.
+*
+* @example
+* ```typescript
+* import { accordionVariants } from '@mks2508/mks-ui';
+*
+* // Get class string for bordered variant
+* const classes = accordionVariants({ variant: 'bordered' });
+* ```
+*/
+const accordionVariants = cva(AccordionStyles.root, {
+	variants: { variant: {
+		default: "",
+		bordered: "rounded-lg border border-border"
+	} },
+	defaultVariants: { variant: "default" }
+});
+
+//#endregion
+export { AccordionStyles, accordionVariants };

package/dist/react-ui/ui/Accordion/Accordion.types.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Type definitions for the Accordion component.
+ *
+ * All interfaces follow the IPrefix convention. Type aliases do not.
+ * Slot types define the visual regions available for style overrides.
+ *
+ * @module @mks2508/mks-ui/react/ui/Accordion/Accordion.types
+ */
+import type { Accordion as AccordionPrimitive } from '@base-ui/react/accordion';
+import type { HTMLMotionProps } from 'motion/react';
+import type { IBaseConfig, SlotOverrides } from '../../../core/types';
+import type { AccordionVariantProps } from './Accordion.styles';
+/**
+ * Named visual regions of the Accordion that can be styled via the `slots` prop.
+ *
+ * | Slot        | Element                                     |
+ * |-------------|---------------------------------------------|
+ * | `root`      | Outer accordion container                   |
+ * | `item`      | Individual collapsible section               |
+ * | `header`    | Header wrapper around the trigger            |
+ * | `trigger`   | Clickable element that toggles the panel     |
+ * | `panel`     | Collapsible content area with animation      |
+ *
+ * @example
+ * ```tsx
+ * <Accordion slots={{ trigger: 'text-cyan-400', panel: 'bg-zinc-900/50' }} />
+ * ```
+ */
+export type AccordionSlot = 'root' | 'item' | 'header' | 'trigger' | 'panel';
+/**
+ * Internal context for the Accordion root, tracks the current value.
+ */
+export type AccordionContextType = {
+    /** Currently expanded item value(s). */
+    value: string | string[] | undefined;
+    /** Setter to update the expanded item value(s). */
+    setValue: (value: string | string[] | undefined) => void;
+};
+/**
+ * Internal context for an individual AccordionItem, tracks open state.
+ */
+export type AccordionItemContextType = {
+    /** Whether this item's panel is currently expanded. */
+    isOpen: boolean;
+    /** Setter to toggle this item's open state. */
+    setIsOpen: (open: boolean) => void;
+};
+/**
+ * Behavioral configuration for the Accordion component.
+ * Extends {@link IBaseConfig} with accordion-specific options.
+ *
+ * @example
+ * ```tsx
+ * <Accordion config={{ keepRendered: true, animation: { duration: 0.4 } }} />
+ * ```
+ */
+export interface IAccordionConfig extends IBaseConfig {
+    /**
+     * When `true`, accordion panels remain in the DOM when collapsed
+     * (hidden visually but not unmounted). Useful for preserving
+     * form state or avoiding expensive re-renders.
+     *
+     * @default false
+     */
+    keepRendered?: boolean;
+}
+/**
+ * Props for the root Accordion component.
+ *
+ * @example
+ * ```tsx
+ * <Accordion
+ *   variant="bordered"
+ *   defaultValue={['item-1']}
+ *   slots={{ root: 'bg-muted/30', trigger: 'font-semibold' }}
+ * >
+ *   <AccordionItem value="item-1">...</AccordionItem>
+ * </Accordion>
+ * ```
+ */
+export interface IAccordionProps extends Omit<React.ComponentProps<typeof AccordionPrimitive.Root>, 'className'>, AccordionVariantProps {
+    /** Additional CSS class applied to the root element. */
+    className?: string;
+    /** Style overrides for individual visual regions. */
+    slots?: SlotOverrides<AccordionSlot>;
+    /** Behavioral configuration. */
+    config?: IAccordionConfig;
+}
+/**
+ * Props for an individual AccordionItem.
+ *
+ * @example
+ * ```tsx
+ * <AccordionItem value="item-1" className="border-none">
+ *   <AccordionHeader>...</AccordionHeader>
+ *   <AccordionPanel>Content</AccordionPanel>
+ * </AccordionItem>
+ * ```
+ */
+export interface IAccordionItemProps extends React.ComponentProps<typeof AccordionPrimitive.Item> {
+    /** Style overrides for individual visual regions. */
+    slots?: SlotOverrides<AccordionSlot>;
+}
+/**
+ * Props for the AccordionHeader wrapper.
+ *
+ * @example
+ * ```tsx
+ * <AccordionHeader className="bg-muted/20">
+ *   <AccordionTrigger>Section Title</AccordionTrigger>
+ * </AccordionHeader>
+ * ```
+ */
+export interface IAccordionHeaderProps extends React.ComponentProps<typeof AccordionPrimitive.Header> {
+    /** Style overrides for individual visual regions. */
+    slots?: SlotOverrides<AccordionSlot>;
+}
+/**
+ * Props for the AccordionTrigger button.
+ *
+ * @example
+ * ```tsx
+ * <AccordionTrigger className="text-foreground hover:text-primary">
+ *   Click to expand
+ * </AccordionTrigger>
+ * ```
+ */
+export interface IAccordionTriggerProps extends React.ComponentProps<typeof AccordionPrimitive.Trigger> {
+    /** Style overrides for individual visual regions. */
+    slots?: SlotOverrides<AccordionSlot>;
+}
+/**
+ * Props for the AccordionPanel collapsible content area.
+ *
+ * Extends Motion's HTMLMotionProps for full animation control.
+ * The `keepMounted` and `render` props from the base primitive are
+ * omitted because they are managed internally by the animation logic.
+ *
+ * @example
+ * ```tsx
+ * <AccordionPanel
+ *   keepRendered
+ *   transition={{ duration: 0.5, ease: 'easeOut' }}
+ * >
+ *   <p>Collapsible content here.</p>
+ * </AccordionPanel>
+ * ```
+ */
+export interface IAccordionPanelProps extends Omit<Omit<React.ComponentProps<typeof AccordionPrimitive.Panel>, 'keepMounted' | 'render'>, keyof HTMLMotionProps<'div'>>, HTMLMotionProps<'div'> {
+    /**
+     * When `true`, the panel stays mounted in the DOM even when collapsed.
+     * Useful for preserving internal state (e.g. form inputs).
+     *
+     * @default false
+     */
+    keepRendered?: boolean;
+    /** Style overrides for individual visual regions. */
+    slots?: SlotOverrides<AccordionSlot>;
+}
+//# sourceMappingURL=Accordion.types.d.ts.map

package/dist/react-ui/ui/Accordion/Accordion.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Accordion.types.d.ts","sourceRoot":"","sources":["../../../../src/react-ui/ui/Accordion/Accordion.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAMhE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAM7E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,wCAAwC;IACxC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,mDAAmD;IACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AAMF;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eACf,SAAQ,IAAI,CACR,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC,EACpD,WAAW,CACZ,EACD,qBAAqB;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACrC,gCAAgC;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,IAAI,CAAC;IAC5D,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,MAAM,CAAC;IAC9D,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC;IAC/D,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBACf,SAAQ,IAAI,CACR,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC,EACrF,MAAM,eAAe,CAAC,KAAK,CAAC,CAC7B,EACD,eAAe,CAAC,KAAK,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACtC"}

package/dist/react-ui/ui/Accordion/index.d.ts

@@ -0,0 +1,105 @@
+import type { AccordionItemContextType, IAccordionProps, IAccordionItemProps, IAccordionHeaderProps, IAccordionTriggerProps, IAccordionPanelProps } from './Accordion.types';
+declare const useAccordionItem: () => AccordionItemContextType;
+/**
+ * Root Accordion container. Manages which items are expanded and
+ * provides context to child components.
+ *
+ * Supports both controlled (`value` + `onValueChange`) and uncontrolled
+ * (`defaultValue`) usage patterns.
+ *
+ * @param props - {@link IAccordionProps}
+ * @returns The rendered accordion container
+ *
+ * @example
+ * ```tsx
+ * // Uncontrolled with default expansion
+ * <Accordion defaultValue={['item-1']}>
+ *   <AccordionItem value="item-1">...</AccordionItem>
+ *   <AccordionItem value="item-2">...</AccordionItem>
+ * </Accordion>
+ *
+ * // Controlled
+ * const [value, setValue] = useState<string[]>(['item-1']);
+ * <Accordion value={value} onValueChange={setValue} variant="bordered">
+ *   ...
+ * </Accordion>
+ * ```
+ */
+declare function Accordion({ variant, className, slots, config: _config, ...props }: IAccordionProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Individual collapsible section within an Accordion.
+ * Tracks its own open/closed state derived from the parent context.
+ *
+ * @param props - {@link IAccordionItemProps}
+ * @returns The rendered accordion item
+ *
+ * @example
+ * ```tsx
+ * <AccordionItem value="section-1" className="border-primary/20">
+ *   <AccordionHeader>
+ *     <AccordionTrigger>Section Title</AccordionTrigger>
+ *   </AccordionHeader>
+ *   <AccordionPanel>Section content</AccordionPanel>
+ * </AccordionItem>
+ * ```
+ */
+declare function AccordionItem({ slots, className, ...props }: IAccordionItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Header wrapper for an accordion trigger. Provides semantic structure
+ * and consistent spacing around the trigger element.
+ *
+ * @param props - {@link IAccordionHeaderProps}
+ * @returns The rendered accordion header
+ *
+ * @example
+ * ```tsx
+ * <AccordionHeader className="bg-muted/10">
+ *   <AccordionTrigger>Section Title</AccordionTrigger>
+ * </AccordionHeader>
+ * ```
+ */
+declare function AccordionHeader({ slots, className, ...props }: IAccordionHeaderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Clickable trigger that toggles the associated AccordionPanel.
+ * Rendered as a button for accessibility.
+ *
+ * @param props - {@link IAccordionTriggerProps}
+ * @returns The rendered accordion trigger
+ *
+ * @example
+ * ```tsx
+ * <AccordionTrigger className="text-foreground hover:text-primary">
+ *   Click to expand
+ * </AccordionTrigger>
+ * ```
+ */
+declare function AccordionTrigger({ slots, className, ...props }: IAccordionTriggerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Animated collapsible panel that shows/hides content with a smooth
+ * height transition powered by Motion (Framer Motion).
+ *
+ * Uses a mask-image technique for a polished reveal/hide effect.
+ * When `keepRendered` is `true`, the panel stays in the DOM even when
+ * collapsed (useful for preserving form state).
+ *
+ * @param props - {@link IAccordionPanelProps}
+ * @returns The rendered animated accordion panel
+ *
+ * @example
+ * ```tsx
+ * // Standard panel (unmounts on collapse)
+ * <AccordionPanel>
+ *   <p>Content revealed on expand</p>
+ * </AccordionPanel>
+ *
+ * // Persistent panel (stays mounted)
+ * <AccordionPanel keepRendered transition={{ duration: 0.5 }}>
+ *   <form>...</form>
+ * </AccordionPanel>
+ * ```
+ */
+declare function AccordionPanel({ transition, hiddenUntilFound, keepRendered, slots, className, ...props }: IAccordionPanelProps): import("react/jsx-runtime").JSX.Element;
+export { Accordion, AccordionItem, AccordionHeader, AccordionTrigger, AccordionPanel, useAccordionItem, };
+export type { IAccordionProps, IAccordionItemProps, IAccordionHeaderProps, IAccordionTriggerProps, IAccordionPanelProps, IAccordionConfig, AccordionSlot, AccordionContextType, AccordionItemContextType, } from './Accordion.types';
+export { AccordionStyles, accordionVariants, type AccordionVariantProps, } from './Accordion.styles';
+//# sourceMappingURL=index.d.ts.map

package/dist/react-ui/ui/Accordion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react-ui/ui/Accordion/index.tsx"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAEV,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAS3B,QAAA,MAA8B,gBAAgB,gCACsB,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,SAAS,CAAC,EACjB,OAAO,EACP,SAAS,EACT,KAAK,EACL,MAAM,EAAE,OAAO,EACf,GAAG,KAAK,EACT,EAAE,eAAe,2CAmBjB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,aAAa,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,2CAmBzE;AAMD;;;;;;;;;;;;;GAaG;AACH,iBAAS,eAAe,CAAC,EACvB,KAAK,EACL,SAAS,EACT,GAAG,KAAK,EACT,EAAE,qBAAqB,2CAQvB;AAMD;;;;;;;;;;;;;GAaG;AACH,iBAAS,gBAAgB,CAAC,EACxB,KAAK,EACL,SAAS,EACT,GAAG,KAAK,EACT,EAAE,sBAAsB,2CAQxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,cAAc,CAAC,EACtB,UAAkD,EAClD,gBAAgB,EAChB,YAAoB,EACpB,KAAK,EACL,SAAS,EACT,GAAG,KAAK,EACT,EAAE,oBAAoB,2CAgEtB;AAMD,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,CAAC;AAGF,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC"}