@adgytec/adgytec-web-ui-components 2.2.0 → 2.3.1

package/dist/components/Input/TimeField/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Input/TimeField/TimeField.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport {\n    TimeField as AriaTimeField,\n    DateInput,\n    DateSegment,\n    type TimeValue,\n} from \"react-aria-components\";\nimport { typography } from \"@/utils\";\nimport {\n    Colors,\n    DateInputStyles,\n    DateSegmentStyles,\n    EditorInputStyles,\n    EditorStyles,\n    InputGroupStyles,\n    SupportingTextStyles,\n    UnsetStyles,\n} from \"../core\";\nimport { Description } from \"../Description\";\nimport { FieldError } from \"../FieldError\";\nimport { Label } from \"../Label\";\nimport type { TimeFieldProps } from \"./types\";\n\nexport const TimeField = <T extends TimeValue>({\n    label,\n    description,\n    errorMessage,\n    showDescriptionOnInvalid = false,\n    className,\n    ref,\n    ...props\n}: TimeFieldProps<T>) => {\n    return (\n        <AriaTimeField\n            className={(renderProps) =>\n                clsx(\n                    Colors,\n                    InputGroupStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n        >\n            {({ isInvalid }) => {\n                const showDescription =\n                    description &&\n                    (!isInvalid || (isInvalid && showDescriptionOnInvalid));\n\n                return (\n                    <>\n                        {label && <Label>{label}</Label>}\n\n                        <DateInput\n                            ref={ref}\n                            className={clsx(\n                                UnsetStyles,\n                                EditorStyles,\n                                EditorInputStyles,\n                                typography.bodyLarge,\n                                DateInputStyles\n                            )}\n                            data-date-input={true}\n                        >\n                            {(segment) => {\n                                return (\n                                    <DateSegment\n                                        className={clsx(\n                                            DateSegmentStyles,\n                                            typography.bodyLarge\n                                        )}\n                                        segment={segment}\n                                    />\n                                );\n                            }}\n                        </DateInput>\n\n                        {showDescription && (\n                            <Description className={clsx(SupportingTextStyles)}>\n                                {description}\n                            </Description>\n                        )}\n                        <FieldError className={clsx(SupportingTextStyles)}>\n                            {errorMessage}\n                        </FieldError>\n                    </>\n                );\n            }}\n        </AriaTimeField>\n    );\n};\n"],"mappings":";;;;;;;;;AAuBA,IAAa,KAAkC,EAC3C,UACA,gBACA,iBACA,8BAA2B,IAC3B,cACA,QACA,GAAG,QAGC,kBAAC,GAAD;CACI,YAAY,MACR,EACI,GACA,GACA,OAAO,KAAc,aACf,EAAU,CAAW,IACrB,CACV;CAEJ,GAAI;YAEF,EAAE,mBAAgB;EAChB,IAAM,IACF,MACC,CAAC,KAAc,KAAa;EAEjC,OACI,kBAAA,GAAA,EAAA,UAAA;GACK,KAAS,kBAAC,GAAD,EAAA,UAAQ,EAAa,CAAA;GAE/B,kBAAC,GAAD;IACS;IACL,WAAW,EACP,GACA,GACA,GACA,EAAW,WACX,CACJ;IACA,mBAAiB;eAEf,MAEM,kBAAC,GAAD;KACI,WAAW,EACP,GACA,EAAW,SACf;KACS;IAAQ,CAAA;GAItB,CAAA;GAEV,KACG,kBAAC,GAAD;IAAa,WAAW,EAAK,CAAoB;cAC5C;GACQ,CAAA;GAEjB,kBAAC,GAAD;IAAY,WAAW,EAAK,CAAoB;cAC3C;GACO,CAAA;EAChB,EAAA,CAAA;CAER;AACW,CAAA"}
+{"version":3,"file":"index.js","names":["AriaTimeField","clsx","_Fragment","Label","FieldError","typography","FieldError$1","Label$1","InputGroupStyles","UnsetStyles","DateSegmentStyles","SupportingTextStyles","Colors","EditorInputStyles","DateInputStyles","EditorStyles","clsx$1","TimeField$1","TimeField","props","className","renderProps","showDescription","description","isInvalid","showDescriptionOnInvalid","Fragment","label","DateInput","DateSegment","Description","errorMessage"],"sources":["../../../../src/components/Input/TimeField/TimeField.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport {\n    TimeField as AriaTimeField,\n    DateInput,\n    DateSegment,\n    type TimeValue,\n} from \"react-aria-components\";\nimport { typography } from \"@/utils\";\nimport {\n    Colors,\n    DateInputStyles,\n    DateSegmentStyles,\n    EditorInputStyles,\n    EditorStyles,\n    InputGroupStyles,\n    SupportingTextStyles,\n    UnsetStyles,\n} from \"../core\";\nimport { Description } from \"../Description\";\nimport { FieldError } from \"../FieldError\";\nimport { Label } from \"../Label\";\nimport type { TimeFieldProps } from \"./types\";\n\n/**\n * An accessible segmented time input field allowing users to enter time values by editing hour, minute, and AM/PM segments.\n *\n * Automatically formats time per locale and handles keyboard arrow adjustments,\n * helper descriptions, and validation errors.\n *\n * @example\n * ```tsx\n * import { TimeField } from '@adgytec/web-ui-components';\n *\n * <TimeField\n *     label=\"Meeting Time\"\n *     description=\"Select an hour and minute.\"\n * />\n * ```\n */\nexport const TimeField = <T extends TimeValue>({\n    label,\n    description,\n    errorMessage,\n    showDescriptionOnInvalid = false,\n    className,\n    ref,\n    ...props\n}: TimeFieldProps<T>) => {\n    return (\n        <AriaTimeField\n            className={(renderProps) =>\n                clsx(\n                    Colors,\n                    InputGroupStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n        >\n            {({ isInvalid }) => {\n                const showDescription =\n                    description &&\n                    (!isInvalid || (isInvalid && showDescriptionOnInvalid));\n\n                return (\n                    <>\n                        {label && <Label>{label}</Label>}\n\n                        <DateInput\n                            ref={ref}\n                            className={clsx(\n                                UnsetStyles,\n                                EditorStyles,\n                                EditorInputStyles,\n                                typography.bodyLarge,\n                                DateInputStyles\n                            )}\n                            data-date-input={true}\n                        >\n                            {(segment) => {\n                                return (\n                                    <DateSegment\n                                        className={clsx(\n                                            DateSegmentStyles,\n                                            typography.bodyLarge\n                                        )}\n                                        segment={segment}\n                                    />\n                                );\n                            }}\n                        </DateInput>\n\n                        {showDescription && (\n                            <Description className={clsx(SupportingTextStyles)}>\n                                {description}\n                            </Description>\n                        )}\n                        <FieldError className={clsx(SupportingTextStyles)}>\n                            {errorMessage}\n                        </FieldError>\n                    </>\n                );\n            }}\n        </AriaTimeField>\n    );\n};\n"],"mappings":";;;;;;;;;AAuCA,IAAakB,KAAkC,EAC3C,UACA,gBACA,iBACA,8BAA2B,IAC3B,cACA,QACA,GAAGC,QAGC,kBAACnB,GAAD;CACI,YAAY,MACRC,EACIW,GACAJ,GACA,OAAOY,KAAc,aACfA,EAAUC,CAAW,IACrBD,CACV;CAEJ,GAAID;CAEF,WAAA,EAAE,mBAAgB;EAChB,IAAMG,IACFC,MACC,CAACC,KAAcA,KAAaC;EAEjC,OACI,kBAAAvB,GAAA,EAAA,UAAA;GACKyB,KAAS,kBAACxB,GAAD,EAAA,UAAQwB,EAAa,CAAA;GAE/B,kBAACC,GAAD;IACS;IACL,WAAW3B,EACPQ,GACAM,GACAF,GACAR,EAAW,WACXS,CACJ;IACA,mBAAiB;IAEf,WAAA,MAEM,kBAACe,GAAD;KACI,WAAW5B,EACPS,GACAL,EAAW,SACf;KACS;IAAQ,CAAA;GAItB,CAAA;GAEViB,KACG,kBAACQ,GAAD;IAAa,WAAW7B,EAAKU,CAAoB;IAC5C,UAAAY;GACQ,CAAA;GAEjB,kBAACnB,GAAD;IAAY,WAAWH,EAAKU,CAAoB;IAC3C,UAAAoB;GACO,CAAA;EAChB,EAAA,CAAA;CAER;AACW,CAAA"}

package/dist/components/Input/TimeField/types.d.ts

@@ -1,5 +1,9 @@
 import { TimeFieldProps as AriaTimeFieldProps, DateInput, TimeValue } from 'react-aria-components';
 import { RefProp } from '../../../utils';
 import { CoreInputProps } from '../core';
+/**
+ * Props for the {@link TimeField} component.
+ * Extends React Aria's {@link AriaTimeFieldProps}, {@link CoreInputProps}, and native time input ref.
+ */
 export interface TimeFieldProps<T extends TimeValue> extends Omit<AriaTimeFieldProps<T>, "children">, CoreInputProps, RefProp<typeof DateInput> {
 }

package/dist/components/Input/core/input.d.ts

@@ -1,8 +1,23 @@
 import { ReactNode } from 'react';
 import { ValidationResult } from 'react-aria-components';
+/**
+ * Shared input wrapper props providing accessible labeling, descriptions, and error feedback.
+ */
 export interface CoreInputProps {
+    /** The accessible label displayed above or alongside the input control. */
     label?: ReactNode;
+    /** Informative supporting text displayed below the input. */
     description?: ReactNode;
+    /**
+     * Error message content displayed when the input fails validation.
+     * Can be static content or a render function receiving the current {@link ValidationResult}.
+     */
     errorMessage?: ReactNode | ((validation: ValidationResult) => ReactNode);
+    /**
+     * Whether to continue displaying the {@link description} supporting text even when
+     * the input is invalid and rendering an error message.
+     *
+     * @default false
+     */
     showDescriptionOnInvalid?: boolean;
 }

package/dist/components/Input/core/textField.d.ts

@@ -1,11 +1,24 @@
+/**
+ * Standard icon size (in pixels) for leading and trailing icons in text fields.
+ */
 export declare const TextFieldIconSize = 24;
+/** CSS class resetting browser-default text field container styles. */
 export declare const UnsetStyles: string;
+/** CSS class providing color tokens for text fields. */
 export declare const Colors: string;
+/** CSS class for the composite input group container. */
 export declare const InputGroupStyles: string;
+/** CSS class for the editable input container. */
 export declare const EditorStyles: string;
+/** CSS class for the input element wrapper group. */
 export declare const EditorInputGroupStyles: string;
+/** CSS class for native `<input>` and `<textarea>` elements. */
 export declare const EditorInputStyles: string;
+/** CSS class for supporting text below text fields. */
 export declare const SupportingTextStyles: string;
+/** CSS class for the character count display. */
 export declare const CharacterCountStyles: string;
+/** CSS class for date field composite inputs. */
 export declare const DateInputStyles: string;
+/** CSS class for individual date segments within a date field. */
 export declare const DateSegmentStyles: string;

package/dist/components/Input/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Input/hooks/useControllableState.ts"],"sourcesContent":["import { useState } from \"react\";\n\nexport function useControllableState({\n    value,\n    defaultValue,\n    onChange,\n}: {\n    value?: string;\n    defaultValue?: string;\n    onChange?: (value: string) => void;\n}) {\n    const isControlled = value !== undefined;\n\n    const [internalValue, setInternalValue] = useState(\n        () => defaultValue ?? \"\"\n    );\n\n    const currentValue = isControlled ? value : internalValue;\n\n    const setValue = (val: string) => {\n        onChange?.(val);\n\n        if (!isControlled) {\n            setInternalValue(val);\n        }\n    };\n\n    return {\n        currentValue,\n        setValue,\n    };\n}\n"],"mappings":";;;;AAEA,SAAO,EAAA,GAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAA8B,EAAA,UAAA,iBAAA,gBAAA,GASjC,IAAqB,MAAU,KAAA,GAAU;CAAA,AAAA,EAAA,OAAA,IAGb,IAAA,EAAA,MAAxB,UAAM,KAAA,IAAkB,EAAA,KAAA,GAAA,EAAA,KAAA;CAD5B,IAAA,CAAA,GAAA,KAA0C,EACtC,CACJ,GAEA,IAAqB,IAAA,IAAA,GAAqC;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAEzC,KAAA,MAAA;EAGb,AAFA,IAAW,CAAG,GAET,KACD,EAAiB,CAAG;CACvB,GACJ,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA;CAND,IAAA,IAAiB,GAMf;CAKD,OALC,EAAA,OAAA,KAAA,EAAA,OAAA,KAEK,IAAA;EAAA;EAAA;CAGP,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IAHM;AAGN"}
+{"version":3,"file":"index.js","names":["_c","require_compiler_runtime","import_compiler_runtime","useControllableState","$","t0","isControlled","value","t1","defaultValue","internalValue","setInternalValue","useState","currentValue","t2","onChange","val","setValue","t3"],"sources":["../../../../src/components/Input/hooks/useControllableState.ts"],"sourcesContent":["import { useState } from \"react\";\n\n/**\n * Options for the {@link useControllableState} hook.\n */\nexport interface UseControllableStateProps {\n    /** Controlled value from props. */\n    value?: string;\n    /** Uncontrolled default value fallback. */\n    defaultValue?: string;\n    /** Change callback invoked when value updates. */\n    onChange?: (value: string) => void;\n}\n\n/**\n * Custom hook to manage state that can operate in either controlled or uncontrolled mode.\n *\n * If `value` is passed, the hook operates in controlled mode; otherwise, it manages internal state.\n *\n * @param options - Controlled state options including `value`, `defaultValue`, and `onChange`.\n * @returns An object containing `currentValue` and `setValue`.\n */\nexport function useControllableState({\n    value,\n    defaultValue,\n    onChange,\n}: UseControllableStateProps) {\n    const isControlled = value !== undefined;\n\n    const [internalValue, setInternalValue] = useState(\n        () => defaultValue ?? \"\"\n    );\n\n    const currentValue = isControlled ? value : internalValue;\n\n    const setValue = (val: string) => {\n        onChange?.(val);\n\n        if (!isControlled) {\n            setInternalValue(val);\n        }\n    };\n\n    return {\n        currentValue,\n        setValue,\n    };\n}\n"],"mappings":";;;;AAsBA,SAAOG,EAAA,GAAA;CAAA,IAAAC,KAAA,GAAAJ,EAAAA,EAAAA,CAAA,CAAA,GAA8B,EAAA,UAAA,iBAAA,gBAAAK,GAKjCC,IAAqBC,MAAU,KAAA,GAAUC;CAAA,AAAAJ,EAAA,OAAAK,IAGb,IAAAL,EAAA,MAAxB,UAAMK,KAAA,IAAkB,EAAA,KAAAA,GAAA,EAAA,KAAAD;CAD5B,IAAA,CAAAE,GAAAC,KAA0CC,EACtCJ,CACJ,GAEAK,IAAqBP,IAAAC,IAAAG,GAAqCI;CAAA,AAAAV,EAAA,OAAAE,KAAAF,EAAA,OAAAW,KAEzC,KAAA,MAAA;EAGb,AAFAA,IAAWC,CAAG,GAETV,KACDK,EAAiBK,CAAG;CACvB,GACJ,EAAA,KAAAV,GAAA,EAAA,KAAAS,GAAA,EAAA,KAAAD,KAAA,IAAAV,EAAA;CAND,IAAAa,IAAiBH,GAMfI;CAKD,OALCd,EAAA,OAAAS,KAAAT,EAAA,OAAAa,KAEK,IAAA;EAAA;EAAA;CAGP,GAAC,EAAA,KAAAJ,GAAA,EAAA,KAAAI,GAAA,EAAA,KAAAC,KAAA,IAAAd,EAAA,IAHMc;AAGN"}

package/dist/components/Input/hooks/useControllableState.d.ts

@@ -1,8 +1,23 @@
-export declare function useControllableState({ value, defaultValue, onChange, }: {
+/**
+ * Options for the {@link useControllableState} hook.
+ */
+export interface UseControllableStateProps {
+    /** Controlled value from props. */
     value?: string;
+    /** Uncontrolled default value fallback. */
     defaultValue?: string;
+    /** Change callback invoked when value updates. */
     onChange?: (value: string) => void;
-}): {
+}
+/**
+ * Custom hook to manage state that can operate in either controlled or uncontrolled mode.
+ *
+ * If `value` is passed, the hook operates in controlled mode; otherwise, it manages internal state.
+ *
+ * @param options - Controlled state options including `value`, `defaultValue`, and `onChange`.
+ * @returns An object containing `currentValue` and `setValue`.
+ */
+export declare function useControllableState({ value, defaultValue, onChange, }: UseControllableStateProps): {
     currentValue: string;
     setValue: (val: string) => void;
 };

package/dist/components/List/ListAction/ListAction.d.ts

@@ -0,0 +1,24 @@
+import { IconButtonProps } from '../../Button';
+/**
+ * Props for the [`ListAction`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListAction/ListAction.tsx) component.
+ */
+export interface ListActionProps extends Omit<IconButtonProps, "size"> {
+}
+/**
+ * Pre-configured trailing action icon button for a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Hardcodes `size="small"` while ensuring a full 48px touch target area for accessibility,
+ * defaulting to the `"standard"` icon button color style.
+ *
+ * @example
+ * ```tsx
+ * import { MoreVertical } from "lucide-react";
+ *
+ * <ListAction
+ *     icon={MoreVertical}
+ *     aria-label="More options"
+ *     onPress={() => handleOpenMenu()}
+ * />
+ * ```
+ */
+export declare const ListAction: React.FC<ListActionProps>;

package/dist/components/List/ListAction/index.d.ts

@@ -0,0 +1 @@
+export * from './ListAction';

package/dist/components/List/ListAction/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListAction";
+export { e as ListAction };

package/dist/components/List/ListAvatar/ListAvatar.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Props for the [`ListAvatar`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListAvatar/ListAvatar.tsx) component.
+ */
+export interface ListAvatarProps extends React.ComponentPropsWithRef<"div"> {
+}
+/**
+ * Circular 40px avatar container for user initials or profile images inside a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Automatically styles text content with Material Design 3 `titleMedium` typography,
+ * and scales nested `<img>` elements with `object-fit: cover`.
+ *
+ * @example
+ * ```tsx
+ * // Initials avatar
+ * <ListAvatar>JD</ListAvatar>
+ *
+ * // Image avatar
+ * <ListAvatar>
+ *     <img src="/avatars/user.jpg" alt="Jane Doe" />
+ * </ListAvatar>
+ * ```
+ */
+export declare const ListAvatar: React.FC<ListAvatarProps>;

package/dist/components/List/ListAvatar/index.d.ts

@@ -0,0 +1 @@
+export * from './ListAvatar';

package/dist/components/List/ListAvatar/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListAvatar";
+export { e as ListAvatar };

package/dist/components/List/ListBox/ListBox.d.ts

@@ -0,0 +1,29 @@
+import { ListBoxProps } from './types';
+/**
+ * Material Design 3 List container component.
+ *
+ * Coordinates vertical indexing of items, keyboard navigation, single/multiple selection,
+ * and unified vertical alignment of leading media, text content, and trailing actions.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     ListBox,
+ *     ListItem,
+ *     ListIcon,
+ *     ListLabelText,
+ *     ListSupportingText,
+ * } from "@adgytec/web-ui-components";
+ * import { Mail } from "lucide-react";
+ *
+ * <ListBox selectionMode="single">
+ *     <ListItem
+ *         id="inbox"
+ *         leading={<ListIcon icon={Mail} />}
+ *         label={<ListLabelText>Inbox</ListLabelText>}
+ *         supporting={<ListSupportingText>2 unread messages</ListSupportingText>}
+ *     />
+ * </ListBox>
+ * ```
+ */
+export declare const ListBox: <T extends object>({ alignY, className, ...props }: ListBoxProps<T>) => import('react').JSX.Element;

package/dist/components/List/ListBox/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ListBox';
+export * from './types';

package/dist/components/List/ListBox/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListBox";
+export { e as ListBox };

package/dist/components/List/ListBox/types.d.ts

@@ -0,0 +1,20 @@
+import { ListBox } from 'react-aria-components';
+/**
+ * Vertical alignment options for elements (leading media, text content, and trailing actions)
+ * across list items in a [`ListBox`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListBox/ListBox.tsx).
+ */
+export type ListAlignY = "start" | "center" | "end";
+/**
+ * Props for the [`ListBox`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListBox/ListBox.tsx) container component.
+ *
+ * Extends all properties from React Aria's `ListBox`, including selection modes, keyboard navigation,
+ * and collection props.
+ */
+export interface ListBoxProps<T extends object> extends React.ComponentPropsWithRef<typeof ListBox<T>> {
+    /**
+     * Vertical alignment of leading, text, and trailing elements across list items.
+     *
+     * @default "center"
+     */
+    alignY?: ListAlignY;
+}

package/dist/components/List/ListIcon/ListIcon.d.ts

@@ -0,0 +1,20 @@
+import { Icon } from '../../Icon';
+/**
+ * Props for the [`ListIcon`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListIcon/ListIcon.tsx) component.
+ */
+export interface ListIconProps extends Omit<React.ComponentPropsWithRef<typeof Icon>, "size" | "withText"> {
+}
+/**
+ * Standardized leading icon component for a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Hardcodes a standard 20px dimension while dynamically inheriting the list item's
+ * text and interaction state colors.
+ *
+ * @example
+ * ```tsx
+ * import { Mail } from "lucide-react";
+ *
+ * <ListIcon icon={Mail} />
+ * ```
+ */
+export declare const ListIcon: React.FC<ListIconProps>;

package/dist/components/List/ListIcon/index.d.ts

@@ -0,0 +1 @@
+export * from './ListIcon';

package/dist/components/List/ListIcon/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListIcon";
+export { e as ListIcon };

package/dist/components/List/ListItem/ListItem.d.ts

@@ -0,0 +1,36 @@
+import { ListItemProps } from './types';
+/**
+ * Material Design 3 interactive list item component.
+ *
+ * Supports structured slot composition (`leading`, `overline`, `label`, `supporting`, `trailing`),
+ * dynamic corner radius morphing on hover/focus/selection, touch ripple splash feedback,
+ * and automatic synchronization with nested selection controls (`Checkbox` or `Switch` with `slot="selection"`).
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     ListItem,
+ *     ListIcon,
+ *     ListLabelText,
+ *     ListSupportingText,
+ *     ListAction,
+ * } from "@adgytec/web-ui-components";
+ * import { Star, Trash2 } from "lucide-react";
+ *
+ * <ListItem
+ *     id="starred-email"
+ *     leading={<ListIcon icon={Star} />}
+ *     label={<ListLabelText>Project Roadmap</ListLabelText>}
+ *     supporting={<ListSupportingText>Updated yesterday by Alex</ListSupportingText>}
+ *     trailing={[
+ *         <ListAction
+ *             key="delete"
+ *             icon={Trash2}
+ *             aria-label="Delete item"
+ *             onPress={() => handleDelete()}
+ *         />,
+ *     ]}
+ * />
+ * ```
+ */
+export declare const ListItem: React.FC<ListItemProps>;

package/dist/components/List/ListItem/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ListItem';
+export * from './types';

package/dist/components/List/ListItem/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListItem";
+export { e as ListItem };

package/dist/components/List/ListItem/types.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode } from 'react';
+import { ListBoxItem } from 'react-aria-components';
+/**
+ * Props for the [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx) component.
+ *
+ * Utilizes a structured slot-based API (`leading`, `overline`, `label`, `supporting`, `trailing`)
+ * to lay out content following Material Design 3 List specifications.
+ */
+export interface ListItemProps extends Omit<React.ComponentPropsWithRef<typeof ListBoxItem>, "children"> {
+    /**
+     * Element rendered at the start of the list item (e.g. icon, avatar, thumbnail media, or selection checkbox).
+     */
+    leading?: ReactNode;
+    /**
+     * Eyebrow or overline text rendered above the primary label, typically [`ListOverlineText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListOverlineText/ListOverlineText.tsx).
+     */
+    overline?: ReactNode;
+    /**
+     * The primary label element of the list item, typically [`ListLabelText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListLabelText/ListLabelText.tsx).
+     */
+    label: ReactNode;
+    /**
+     * Secondary descriptive text rendered beneath the label, typically [`ListSupportingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListSupportingText/ListSupportingText.tsx).
+     */
+    supporting?: ReactNode;
+    /**
+     * Array of elements rendered at the end of the list item (e.g. trailing metadata text, action buttons, or selection switches).
+     */
+    trailing?: ReactNode[];
+}

package/dist/components/List/ListLabelText/ListLabelText.d.ts

@@ -0,0 +1,17 @@
+import { Text } from 'react-aria-components';
+/**
+ * Props for the [`ListLabelText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListLabelText/ListLabelText.tsx) component.
+ */
+export interface ListLabelTextProps extends Omit<React.ComponentPropsWithRef<typeof Text>, "slot"> {
+}
+/**
+ * Primary headline/label text component for a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Automatically binds to `slot="label"` with Material Design 3 `bodyLarge` typography.
+ *
+ * @example
+ * ```tsx
+ * <ListLabelText>Notification Settings</ListLabelText>
+ * ```
+ */
+export declare const ListLabelText: React.FC<ListLabelTextProps>;

package/dist/components/List/ListLabelText/index.d.ts

@@ -0,0 +1 @@
+export * from './ListLabelText';

package/dist/components/List/ListLabelText/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListLabelText";
+export { e as ListLabelText };

package/dist/components/List/ListMedia/ListMedia.d.ts

@@ -0,0 +1,22 @@
+import { ListMediaProps } from './types';
+/**
+ * Styled media container for thumbnail images and video previews within a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Automatically applies rounded corners and `object-fit: cover` to nested `<img>` or `<video>` elements.
+ * Supports dimension presets: `"image"` (56×56), `"video"` (100×56), and `"large-video"` (114×64).
+ *
+ * @example
+ * ```tsx
+ * import { ListMedia, ListMediaImageWidth, ListMediaImageHeight } from "@adgytec/web-ui-components";
+ *
+ * <ListMedia variant="image">
+ *     <img
+ *         src="https://picsum.photos/56/56"
+ *         alt="Thumbnail"
+ *         width={ListMediaImageWidth}
+ *         height={ListMediaImageHeight}
+ *     />
+ * </ListMedia>
+ * ```
+ */
+export declare const ListMedia: React.FC<ListMediaProps>;

package/dist/components/List/ListMedia/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ListMedia';
+export * from './types';

package/dist/components/List/ListMedia/index.js

@@ -0,0 +1,2 @@
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../../../chunks/ListMedia";
+export { a as ListMedia, o as ListMediaImageHeight, n as ListMediaImageWidth, i as ListMediaLargeVideoHeight, t as ListMediaLargeVideoWidth, e as ListMediaVideoHeight, r as ListMediaVideoWidth };

package/dist/components/List/ListMedia/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Width in pixels for the `"image"` media variant (56px).
+ */
+export declare const ListMediaImageWidth = 56;
+/**
+ * Height in pixels for the `"image"` media variant (56px).
+ */
+export declare const ListMediaImageHeight = 56;
+/**
+ * Width in pixels for the standard `"video"` media variant (100px).
+ */
+export declare const ListMediaVideoWidth = 100;
+/**
+ * Height in pixels for the standard `"video"` media variant (56px).
+ */
+export declare const ListMediaVideoHeight = 56;
+/**
+ * Width in pixels for the `"large-video"` media variant (114px).
+ */
+export declare const ListMediaLargeVideoWidth = 114;
+/**
+ * Height in pixels for the `"large-video"` media variant (64px).
+ */
+export declare const ListMediaLargeVideoHeight = 64;
+/**
+ * Preset dimension variants for the [`ListMedia`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListMedia/ListMedia.tsx) container:
+ * - `"image"`: 56px × 56px square thumbnail.
+ * - `"video"`: 100px × 56px 16:9 aspect video preview.
+ * - `"large-video"`: 114px × 64px enlarged video preview.
+ */
+export type ListMediaVariant = "image" | "video" | "large-video";
+/**
+ * Props for the [`ListMedia`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListMedia/ListMedia.tsx) container component.
+ */
+export interface ListMediaProps extends React.ComponentPropsWithRef<"div"> {
+    /**
+     * Preset dimension variant for the media thumbnail container.
+     *
+     * @default "image"
+     */
+    variant?: ListMediaVariant;
+}

package/dist/components/List/ListOverlineText/ListOverlineText.d.ts

@@ -0,0 +1,17 @@
+import { Text } from 'react-aria-components';
+/**
+ * Props for the [`ListOverlineText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListOverlineText/ListOverlineText.tsx) component.
+ */
+export interface ListOverlineTextProps extends React.ComponentPropsWithRef<typeof Text> {
+}
+/**
+ * Eyebrow or overline category text component displayed above the label in a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Styled with Material Design 3 `labelSmall` typography.
+ *
+ * @example
+ * ```tsx
+ * <ListOverlineText>Work</ListOverlineText>
+ * ```
+ */
+export declare const ListOverlineText: React.FC<ListOverlineTextProps>;

package/dist/components/List/ListOverlineText/index.d.ts

@@ -0,0 +1 @@
+export * from './ListOverlineText';

package/dist/components/List/ListOverlineText/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListOverlineText";
+export { e as ListOverlineText };

package/dist/components/List/ListSupportingText/ListSupportingText.d.ts

@@ -0,0 +1,17 @@
+import { Text } from 'react-aria-components';
+/**
+ * Props for the [`ListSupportingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListSupportingText/ListSupportingText.tsx) component.
+ */
+export interface ListSupportingTextProps extends Omit<React.ComponentPropsWithRef<typeof Text>, "slot"> {
+}
+/**
+ * Secondary descriptive text component placed beneath the label in a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Automatically binds to `slot="description"` with Material Design 3 `bodyMedium` typography.
+ *
+ * @example
+ * ```tsx
+ * <ListSupportingText>Receive real-time alerts on your device.</ListSupportingText>
+ * ```
+ */
+export declare const ListSupportingText: React.FC<ListSupportingTextProps>;

package/dist/components/List/ListSupportingText/index.d.ts

@@ -0,0 +1 @@
+export * from './ListSupportingText';

package/dist/components/List/ListSupportingText/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListSupportingText";
+export { e as ListSupportingText };

package/dist/components/List/ListTrailingText/ListTrailingText.d.ts

@@ -0,0 +1,17 @@
+import { Text } from 'react-aria-components';
+/**
+ * Props for the [`ListTrailingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListTrailingText/ListTrailingText.tsx) component.
+ */
+export interface ListTrailingTextProps extends React.ComponentPropsWithRef<typeof Text> {
+}
+/**
+ * Trailing metadata or timestamp text component placed at the end of a [`ListItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/List/ListItem/ListItem.tsx).
+ *
+ * Styled with Material Design 3 `labelSmall` typography.
+ *
+ * @example
+ * ```tsx
+ * <ListTrailingText>10:45 AM</ListTrailingText>
+ * ```
+ */
+export declare const ListTrailingText: React.FC<ListTrailingTextProps>;

package/dist/components/List/ListTrailingText/index.d.ts

@@ -0,0 +1 @@
+export * from './ListTrailingText';

package/dist/components/List/ListTrailingText/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../../../chunks/ListTrailingText";
+export { e as ListTrailingText };

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

@@ -0,0 +1,10 @@
+export * from './ListAction';
+export * from './ListAvatar';
+export * from './ListBox';
+export * from './ListIcon';
+export * from './ListItem';
+export * from './ListLabelText';
+export * from './ListMedia';
+export * from './ListOverlineText';
+export * from './ListSupportingText';
+export * from './ListTrailingText';

package/dist/components/List/index.js

@@ -0,0 +1,11 @@
+import { t as e } from "../../chunks/ListAction";
+import { t } from "../../chunks/ListAvatar";
+import { t as n } from "../../chunks/ListBox";
+import { t as r } from "../../chunks/ListIcon";
+import { t as i } from "../../chunks/ListItem";
+import { t as a } from "../../chunks/ListLabelText";
+import { a as o, i as s, n as c, o as l, r as u, s as d, t as f } from "../../chunks/ListMedia";
+import { t as p } from "../../chunks/ListOverlineText";
+import { t as m } from "../../chunks/ListSupportingText";
+import { t as h } from "../../chunks/ListTrailingText";
+export { e as ListAction, t as ListAvatar, n as ListBox, r as ListIcon, i as ListItem, a as ListLabelText, d as ListMedia, f as ListMediaImageHeight, c as ListMediaImageWidth, u as ListMediaLargeVideoHeight, s as ListMediaLargeVideoWidth, o as ListMediaVideoHeight, l as ListMediaVideoWidth, p as ListOverlineText, m as ListSupportingText, h as ListTrailingText };

package/dist/components/Loader/Loader.d.ts

@@ -1,2 +1,27 @@
 import { Icon } from '../Icon';
-export declare const Loader: React.FC<Omit<React.ComponentPropsWithRef<typeof Icon>, "icon" | "className">>;
+/**
+ * Props for the [`Loader`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Loader/Loader.tsx) component.
+ *
+ * Extends all properties from [`Icon`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Icon/Icon.tsx)
+ * while omitting `icon` (which is fixed to `LoaderCircle`) and internal `className`.
+ */
+export interface LoaderProps extends Omit<React.ComponentPropsWithRef<typeof Icon>, "icon" | "className"> {
+}
+/**
+ * Circular spinning progress and activity indicator component.
+ *
+ * Built using Lucide's `LoaderCircle` icon with continuous 360-degree rotation animation
+ * to signal ongoing processes or background loading operations.
+ *
+ * @example
+ * ```tsx
+ * import { Loader } from "@adgytec/web-ui-components";
+ *
+ * // Default loader
+ * <Loader />
+ *
+ * // Custom size and color
+ * <Loader size={32} color="var(--md-sys-color-primary)" />
+ * ```
+ */
+export declare const Loader: React.FC<LoaderProps>;

package/dist/components/Menu/Menu/Menu.d.ts

@@ -1,2 +1,32 @@
 import { MenuProps } from './types';
-export declare const Menu: <T extends object>({ color, layout, className, ...props }: MenuProps<T>) => import("react").JSX.Element;
+/**
+ * Material Design 3 Menu component.
+ *
+ * Displays a list of choices on a temporary surface when users interact with a button,
+ * action, or other control. Supports single/multiple selection, submenus, keyboard navigation,
+ * and customizable color schemes and layout densities.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     MenuTrigger,
+ *     MenuPopover,
+ *     Menu,
+ *     MenuItem,
+ *     Button,
+ * } from "@adgytec/web-ui-components";
+ * import { Settings, User, LogOut } from "lucide-react";
+ *
+ * <MenuTrigger>
+ *     <Button label="Actions" />
+ *     <MenuPopover>
+ *         <Menu onAction={(key) => console.log(key)}>
+ *             <MenuItem id="profile" label="Profile" leadingIcon={User} />
+ *             <MenuItem id="settings" label="Settings" leadingIcon={Settings} />
+ *             <MenuItem id="logout" label="Logout" leadingIcon={LogOut} />
+ *         </Menu>
+ *     </MenuPopover>
+ * </MenuTrigger>
+ * ```
+ */
+export declare const Menu: <T extends object>({ color, layout, className, ...props }: MenuProps<T>) => import('react').JSX.Element;