@adgytec/adgytec-web-ui-components 2.3.0 → 2.4.0

package/dist/components/Dialog/ActionDialog/types.d.ts

@@ -1,10 +1,36 @@
 import { LucideIcon } from 'lucide-react';
-import { ReactElement } from 'react';
+import { ReactNode } from 'react';
 import { Dialog, DialogRenderProps } from 'react-aria-components';
+/**
+ * Visual divider placement options for {@link ActionDialog}.
+ *
+ * - `"none"`: No dividing borders (default).
+ * - `"all"`: Dividing borders both below the heading and above the action buttons.
+ * - `"after-heading"`: Border directly below the heading.
+ * - `"before-actions"`: Border directly above the action buttons.
+ */
 export type ActionDialogDividerPlacement = "none" | "all" | "after-heading" | "before-actions";
+/**
+ * Props for the {@link ActionDialog} component.
+ * Extends React Aria's `Dialog` props (excluding `className`).
+ */
 export interface ActionDialogProps extends Omit<React.ComponentPropsWithRef<typeof Dialog>, "className"> {
+    /** The title text displayed in the dialog header. */
     heading?: string;
+    /**
+     * An optional icon displayed within the dialog header.
+     * When present, header content is centered per Material Design 3 guidelines.
+     */
     icon?: LucideIcon;
-    actions?: ReactElement[] | ((renderProps: DialogRenderProps) => ReactElement[]);
+    /**
+     * Action elements (typically `Button` components) rendered at the bottom of the dialog.
+     * Can be an array of nodes or a render function receiving {@link DialogRenderProps}.
+     */
+    actions?: ReactNode[] | ((renderProps: DialogRenderProps) => ReactNode[]);
+    /**
+     * Placement of dividing borders between header, scrollable body, and action footer.
+     *
+     * @default "none"
+     */
     divider?: ActionDialogDividerPlacement;
 }

package/dist/components/Dialog/Dialog/Dialog.d.ts

@@ -1,2 +1,33 @@
 import { Dialog as AriaDialog } from 'react-aria-components';
-export declare const Dialog: React.FC<React.ComponentPropsWithRef<typeof AriaDialog>>;
+/**
+ * Props for the {@link Dialog} component.
+ * Extends React Aria's {@link AriaDialog} props.
+ */
+export interface DialogProps extends React.ComponentPropsWithRef<typeof AriaDialog> {
+}
+/**
+ * A dialog container component implementing Material Design 3 Dialog specifications.
+ *
+ * Appears in front of application content to present critical alerts, information, or request
+ * user confirmation. Provides context to nested elements via {@link DialogContext} and manages
+ * focus trapping, accessible labeling (`slot="title"`), and keyboard escape behavior.
+ *
+ * @example
+ * ```tsx
+ * import { Dialog, Modal, ModalOverlay, Button } from '@adgytec/web-ui-components';
+ * import { DialogTrigger, Heading } from 'react-aria-components';
+ *
+ * <DialogTrigger>
+ *     <Button>Open Dialog</Button>
+ *     <ModalOverlay>
+ *         <Modal>
+ *             <Dialog>
+ *                 <Heading slot="title">Discard draft?</Heading>
+ *                 <p>Draft will be permanently removed.</p>
+ *             </Dialog>
+ *         </Modal>
+ *     </ModalOverlay>
+ * </DialogTrigger>
+ * ```
+ */
+export declare const Dialog: React.FC<DialogProps>;

package/dist/components/Dialog/Dialog/index.js

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

package/dist/components/Dialog/Modal/Modal.d.ts

@@ -1,2 +1,25 @@
 import { Modal as AriaModal } from 'react-aria-components';
-export declare const Modal: React.FC<React.ComponentPropsWithRef<typeof AriaModal>>;
+/**
+ * Props for the {@link Modal} component.
+ * Extends React Aria's {@link AriaModal} props.
+ */
+export interface ModalProps extends React.ComponentPropsWithRef<typeof AriaModal> {
+}
+/**
+ * A modal positioning and transition wrapper for dialogs.
+ *
+ * Controls entrance and exit animations (such as zoom-in scaling) and centers
+ * the enclosed dialog within the viewport or containing overlay.
+ *
+ * @example
+ * ```tsx
+ * import { Modal, ModalOverlay, Dialog } from '@adgytec/web-ui-components';
+ *
+ * <ModalOverlay isDismissable>
+ *     <Modal>
+ *         <Dialog>Modal content goes here</Dialog>
+ *     </Modal>
+ * </ModalOverlay>
+ * ```
+ */
+export declare const Modal: React.FC<ModalProps>;

package/dist/components/Dialog/Modal/index.js

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

package/dist/components/Dialog/ModalOverlay/ModalOverlay.d.ts

@@ -1,2 +1,26 @@
 import { ModalOverlay as AriaModalOverlay } from 'react-aria-components';
-export declare const ModalOverlay: React.FC<React.ComponentPropsWithRef<typeof AriaModalOverlay>>;
+/**
+ * Props for the {@link ModalOverlay} component.
+ * Extends React Aria's {@link AriaModalOverlay} props.
+ */
+export interface ModalOverlayProps extends React.ComponentPropsWithRef<typeof AriaModalOverlay> {
+}
+/**
+ * A scrim backdrop overlay rendered behind modal dialogs.
+ *
+ * Applies the Material Design 3 backdrop scrim tint (`--md-dialog-overlay`),
+ * handles entry/exit fade animations, locks background body scrolling, and can dismiss
+ * the dialog on outside click when configured with `isDismissable`.
+ *
+ * @example
+ * ```tsx
+ * import { ModalOverlay, Modal, Dialog } from '@adgytec/web-ui-components';
+ *
+ * <ModalOverlay isDismissable>
+ *     <Modal>
+ *         <Dialog>Dialog Content</Dialog>
+ *     </Modal>
+ * </ModalOverlay>
+ * ```
+ */
+export declare const ModalOverlay: React.FC<ModalOverlayProps>;

package/dist/components/Dialog/ModalOverlay/index.js

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

package/dist/components/Dialog/core/context.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Context provided by the {@link Dialog} component to indicate whether children are rendered inside a dialog.
+ */
 export declare const DialogContext: import('react').Context<boolean | null>;
+/**
+ * Hook that returns whether the calling component is currently rendered within a {@link Dialog}.
+ *
+ * @returns `true` if within a Dialog context, otherwise `false`.
+ */
 export declare function useInDialog(): boolean;

package/dist/components/Dialog/core/index.js

@@ -1,14 +1,12 @@
 import { t as e } from "../../../chunks/base";
 import { createContext as t, useContext as n } from "react";
-//#region src/components/Dialog/core/context.ts
+// src/components/Dialog/core/context.ts
 var r = t(null);
 function i() {
 	return n(r) === !0;
 }
-//#endregion
-//#region src/components/Dialog/core/typography.ts
+// src/components/Dialog/core/typography.ts
 var a = 24, o = e.headlineSmall, s = e.bodyMedium;
-//#endregion
 export { s as DialogBodyTypography, r as DialogContext, o as DialogHeadlineTypography, a as DialogIconSize, i as useInDialog };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Dialog/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Dialog/core/context.ts","../../../../src/components/Dialog/core/typography.ts"],"sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport const DialogContext = createContext<boolean | null>(null);\n\nexport function useInDialog() {\n    return useContext(DialogContext) === true;\n}\n","import { typography } from \"@/utils/typography\";\n\nexport const DialogIconSize = 24;\nexport const DialogHeadlineTypography = typography.headlineSmall;\nexport const DialogBodyTypography = typography.bodyMedium;\n"],"mappings":";;;AAEA,IAAa,IAAgB,EAA8B,IAAI;AAE/D,SAAO,IAAA;CAAA,OACI,EAAW,CAAa,MAAM;AAAI;;;ACH7C,IAAa,IAAiB,IACjB,IAA2B,EAAW,eACtC,IAAuB,EAAW"}
+{"version":3,"file":"index.js","names":["typography","DialogContext","createContext","useInDialog","useContext","DialogIconSize","DialogHeadlineTypography","DialogBodyTypography"],"sources":["../../../../src/components/Dialog/core/context.ts","../../../../src/components/Dialog/core/typography.ts"],"sourcesContent":["import { createContext, useContext } from \"react\";\n\n/**\n * Context provided by the {@link Dialog} component to indicate whether children are rendered inside a dialog.\n */\nexport const DialogContext = createContext<boolean | null>(null);\n\n/**\n * Hook that returns whether the calling component is currently rendered within a {@link Dialog}.\n *\n * @returns `true` if within a Dialog context, otherwise `false`.\n */\nexport function useInDialog() {\n    return useContext(DialogContext) === true;\n}\n","import { typography } from \"@/utils/typography\";\n\n/**\n * Standard icon size (in pixels) for icons rendered in a dialog header.\n */\nexport const DialogIconSize = 24;\n\n/**\n * Material Design 3 headline typography class for dialog titles (`headlineSmall`).\n */\nexport const DialogHeadlineTypography = typography.headlineSmall;\n\n/**\n * Material Design 3 body typography class for dialog content (`bodyMedium`).\n */\nexport const DialogBodyTypography = typography.bodyMedium;\n"],"mappings":";;;AAKA,IAAaC,IAAgBC,EAA8B,IAAI;AAO/D,SAAOC,IAAA;CAAA,OACIC,EAAWH,CAAa,MAAM;AAAI;;ACR7C,IAAaI,IAAiB,IAKjBC,IAA2BN,EAAW,eAKtCO,IAAuBP,EAAW"}

package/dist/components/Dialog/core/typography.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Standard icon size (in pixels) for icons rendered in a dialog header.
+ */
 export declare const DialogIconSize = 24;
+/**
+ * Material Design 3 headline typography class for dialog titles (`headlineSmall`).
+ */
 export declare const DialogHeadlineTypography: "typography-headline-small";
+/**
+ * Material Design 3 body typography class for dialog content (`bodyMedium`).
+ */
 export declare const DialogBodyTypography: "typography-body-medium";

package/dist/components/Disclosure/Disclosure/Disclosure.d.ts

@@ -1,2 +1,26 @@
 import { Disclosure as AriaDisclosure } from 'react-aria-components';
-export declare const Disclosure: React.FC<React.ComponentPropsWithRef<typeof AriaDisclosure>>;
+/**
+ * Props for the {@link Disclosure} component.
+ * Extends React Aria's {@link AriaDisclosure} props.
+ */
+export interface DisclosureProps extends React.ComponentPropsWithRef<typeof AriaDisclosure> {
+}
+/**
+ * An expandable section component implementing Material Design 3 disclosure/accordion item behavior.
+ *
+ * Controls showing and hiding associated content based on user interaction with its {@link DisclosureHeader}.
+ * Manages open/collapsed state, accessible ARIA attributes (`aria-expanded`, `aria-controls`), and keyboard navigation.
+ *
+ * @example
+ * ```tsx
+ * import { Disclosure, DisclosureHeader, DisclosurePanel } from '@adgytec/web-ui-components';
+ *
+ * <Disclosure>
+ *     <DisclosureHeader>Collapsible Section</DisclosureHeader>
+ *     <DisclosurePanel>
+ *         Detailed information displayed when expanded.
+ *     </DisclosurePanel>
+ * </Disclosure>
+ * ```
+ */
+export declare const Disclosure: React.FC<DisclosureProps>;

package/dist/components/Disclosure/Disclosure/index.js

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

package/dist/components/Disclosure/DisclosureGroup/DisclosureGroup.d.ts

@@ -1,6 +1,54 @@
 import { DisclosureGroup as AriaDisclosureGroup } from 'react-aria-components';
 import { Typography } from '../../../utils';
-export declare const DisclosureGroup: React.FC<React.ComponentPropsWithRef<typeof AriaDisclosureGroup> & {
+/**
+ * Props for the {@link DisclosureGroup} component.
+ * Extends React Aria's {@link AriaDisclosureGroup} props.
+ */
+export interface DisclosureGroupProps extends React.ComponentPropsWithRef<typeof AriaDisclosureGroup> {
+    /**
+     * Default typography style applied to all {@link DisclosureHeader} labels within the group.
+     *
+     * @default typography.titleMediumEmphasized
+     */
     labelTypography?: Typography;
+    /**
+     * Default typography style applied to all {@link DisclosurePanel} bodies within the group.
+     *
+     * @default typography.bodyLarge
+     */
     panelTypography?: Typography;
-}>;
+}
+/**
+ * An accordion grouping container for managing multiple related {@link Disclosure} sections.
+ *
+ * Supports single or multi-expansion modes via React Aria props (`allowsMultipleExpanded`),
+ * coordinates keyboard navigation between items, and provides shared typography tokens
+ * to all descendant disclosure headers and panels.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     DisclosureGroup,
+ *     Disclosure,
+ *     DisclosureHeader,
+ *     DisclosurePanel,
+ *     typography
+ * } from '@adgytec/web-ui-components';
+ *
+ * <DisclosureGroup
+ *     allowsMultipleExpanded
+ *     labelTypography={typography.titleMedium}
+ *     panelTypography={typography.bodyMedium}
+ * >
+ *     <Disclosure id="step-1">
+ *         <DisclosureHeader>Step 1: Account Info</DisclosureHeader>
+ *         <DisclosurePanel>Enter your username and password.</DisclosurePanel>
+ *     </Disclosure>
+ *     <Disclosure id="step-2">
+ *         <DisclosureHeader>Step 2: Profile Details</DisclosureHeader>
+ *         <DisclosurePanel>Upload an avatar and bio.</DisclosurePanel>
+ *     </Disclosure>
+ * </DisclosureGroup>
+ * ```
+ */
+export declare const DisclosureGroup: React.FC<DisclosureGroupProps>;

package/dist/components/Disclosure/DisclosureGroup/index.js

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

package/dist/components/Disclosure/DisclosureHeader/DisclosureHeader.d.ts

@@ -1,5 +1,34 @@
 import { Heading } from 'react-aria-components';
 import { Typography } from '../../../utils';
-export declare const DisclosureHeader: React.FC<React.ComponentPropsWithRef<typeof Heading> & {
+/**
+ * Props for the {@link DisclosureHeader} component.
+ * Extends React Aria's {@link Heading} props.
+ */
+export interface DisclosureHeaderProps extends React.ComponentPropsWithRef<typeof Heading> {
+    /**
+     * Custom typography style for the disclosure header label.
+     * Overrides the default or group-level typography.
+     *
+     * @default typography.titleMediumEmphasized
+     */
     labelTypography?: Typography;
-}>;
+}
+/**
+ * The interactive header that toggles expansion of a {@link Disclosure} component.
+ *
+ * Renders a semantic heading enclosing an accessible button trigger equipped with an expanding
+ * chevron indicator icon and Material Design touch ripple feedback.
+ *
+ * @example
+ * ```tsx
+ * import { Disclosure, DisclosureHeader, DisclosurePanel, typography } from '@adgytec/web-ui-components';
+ *
+ * <Disclosure>
+ *     <DisclosureHeader labelTypography={typography.titleLarge}>
+ *         Section Title
+ *     </DisclosureHeader>
+ *     <DisclosurePanel>Section Content</DisclosurePanel>
+ * </Disclosure>
+ * ```
+ */
+export declare const DisclosureHeader: React.FC<DisclosureHeaderProps>;

package/dist/components/Disclosure/DisclosureHeader/index.js

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

package/dist/components/Disclosure/DisclosurePanel/DisclosurePanel.d.ts

@@ -1,5 +1,34 @@
 import { DisclosurePanel as AriaDisclosurePanel } from 'react-aria-components';
 import { Typography } from '../../../utils';
-export declare const DisclosurePanel: React.FC<React.ComponentPropsWithRef<typeof AriaDisclosurePanel> & {
+/**
+ * Props for the {@link DisclosurePanel} component.
+ * Extends React Aria's {@link AriaDisclosurePanel} props.
+ */
+export interface DisclosurePanelProps extends React.ComponentPropsWithRef<typeof AriaDisclosurePanel> {
+    /**
+     * Custom typography style for the disclosure panel content.
+     * Overrides the default or group-level typography.
+     *
+     * @default typography.bodyLarge
+     */
     panelTypography?: Typography;
-}>;
+}
+/**
+ * The collapsible content container displayed when a {@link Disclosure} is expanded.
+ *
+ * Automatically manages visibility, smooth collapse/expand layout transitions,
+ * and inherited or customized typography.
+ *
+ * @example
+ * ```tsx
+ * import { Disclosure, DisclosureHeader, DisclosurePanel, typography } from '@adgytec/web-ui-components';
+ *
+ * <Disclosure>
+ *     <DisclosureHeader>FAQ Question</DisclosureHeader>
+ *     <DisclosurePanel panelTypography={typography.bodyMedium}>
+ *         Answer text explaining details in depth.
+ *     </DisclosurePanel>
+ * </Disclosure>
+ * ```
+ */
+export declare const DisclosurePanel: React.FC<DisclosurePanelProps>;

package/dist/components/Disclosure/DisclosurePanel/index.js

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

package/dist/components/Disclosure/context/context.d.ts

@@ -1,6 +1,15 @@
 import { Typography } from '../../../utils';
-export type DisclosureTypographyContextValue = {
+/**
+ * Context value providing inherited typography styles for disclosure components within a group.
+ */
+export interface DisclosureTypographyContextValue {
+    /** Typography applied to {@link DisclosureHeader} labels. */
     label?: Typography;
+    /** Typography applied to {@link DisclosurePanel} content. */
     panel?: Typography;
-};
+}
+/**
+ * React Context used by {@link DisclosureGroup} to pass typography settings down to nested
+ * {@link DisclosureHeader} and {@link DisclosurePanel} components.
+ */
 export declare const DisclosureTypographyContext: import('react').Context<DisclosureTypographyContextValue>;

package/dist/components/Disclosure/context/index.js

@@ -1,7 +1,7 @@
 import { t as e } from "../../../chunks/compiler-runtime";
 import { t } from "../../../chunks/base";
 import { createContext as n, useContext as r } from "react";
-//#region src/components/Disclosure/context/context.ts
+// src/components/Disclosure/context/context.ts
 var i = n({}), a = e();
 function o(e) {
 	let n = (0, a.c)(3), { label: o, panel: s } = e, { label: c, panel: l } = r(i), u = o ?? c ?? t.titleMediumEmphasized, d = s ?? l ?? t.bodyLarge, f;
@@ -10,7 +10,6 @@ function o(e) {
 		panel: d
 	}, n[0] = u, n[1] = d, n[2] = f) : f = n[2], f;
 }
-//#endregion
 export { i as DisclosureTypographyContext, o as useDisclosureTypographyContext };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Disclosure/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Disclosure/context/context.ts","../../../../src/components/Disclosure/context/useDisclosureTypographyContext.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { Typography } from \"@/utils\";\n\nexport type DisclosureTypographyContextValue = {\n    label?: Typography;\n    panel?: Typography;\n};\n\nexport const DisclosureTypographyContext =\n    createContext<DisclosureTypographyContextValue>({});\n","import { useContext } from \"react\";\nimport { type Typography, typography } from \"@/utils\";\nimport { DisclosureTypographyContext } from \"./context\";\n\nexport function useDisclosureTypographyContext({\n    label,\n    panel,\n}: {\n    label?: Typography;\n    panel?: Typography;\n}) {\n    const { label: groupLabel, panel: groupPanel } = useContext(\n        DisclosureTypographyContext\n    );\n\n    const labelTypography =\n        label ?? groupLabel ?? typography.titleMediumEmphasized;\n    const panelTypography = panel ?? groupPanel ?? typography.bodyLarge;\n\n    return { label: labelTypography, panel: panelTypography };\n}\n"],"mappings":";;;;AAQA,IAAa,IACT,EAAgD,CAAC,CAAC;ACLtD,SAAO,EAAA,GAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAwC,EAAA,UAAA,aAAA,GAO3C,EAAA,OAAA,GAAA,OAAA,MAAiD,EAC7C,CACJ,GAEA,IACI,KAAA,KAAuB,EAAU,uBACrC,IAAwB,KAAA,KAAuB,EAAU,WAAW;CAEX,OAFW,EAAA,OAAA,KAAA,EAAA,OAAA,KAE7D,IAAA;EAAA,OAAS;EAAe,OAAS;CAAgB,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IAAlD;AAAkD"}
+{"version":3,"file":"index.js","names":["_c","require_compiler_runtime","DisclosureTypographyContext","createContext","import_compiler_runtime","useDisclosureTypographyContext","$","t0","groupLabel","groupPanel","useContext","labelTypography","label","typography","panelTypography","panel","t1"],"sources":["../../../../src/components/Disclosure/context/context.ts","../../../../src/components/Disclosure/context/useDisclosureTypographyContext.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { Typography } from \"@/utils\";\n\n/**\n * Context value providing inherited typography styles for disclosure components within a group.\n */\nexport interface DisclosureTypographyContextValue {\n    /** Typography applied to {@link DisclosureHeader} labels. */\n    label?: Typography;\n    /** Typography applied to {@link DisclosurePanel} content. */\n    panel?: Typography;\n}\n\n/**\n * React Context used by {@link DisclosureGroup} to pass typography settings down to nested\n * {@link DisclosureHeader} and {@link DisclosurePanel} components.\n */\nexport const DisclosureTypographyContext =\n    createContext<DisclosureTypographyContextValue>({});\n","import { useContext } from \"react\";\nimport { type Typography, typography } from \"@/utils\";\nimport { DisclosureTypographyContext } from \"./context\";\n\n/**\n * Parameters for the {@link useDisclosureTypographyContext} hook.\n */\nexport interface UseDisclosureTypographyContextProps {\n    /** Optional label typography override passed directly to the component. */\n    label?: Typography;\n    /** Optional panel typography override passed directly to the component. */\n    panel?: Typography;\n}\n\n/**\n * Resolves the active typography styles for disclosure headers and panels.\n *\n * Checks explicit component props first, then falls back to inherited values from\n * an enclosing {@link DisclosureGroup}, and finally defaults to Material 3 standard\n * typography (`typography.titleMediumEmphasized` for labels, `typography.bodyLarge` for panels).\n *\n * @param props - Explicit typography overrides from component props.\n * @returns An object containing resolved `label` and `panel` typography classes.\n */\nexport function useDisclosureTypographyContext({\n    label,\n    panel,\n}: UseDisclosureTypographyContextProps) {\n    const { label: groupLabel, panel: groupPanel } = useContext(\n        DisclosureTypographyContext\n    );\n\n    const labelTypography =\n        label ?? groupLabel ?? typography.titleMediumEmphasized;\n    const panelTypography = panel ?? groupPanel ?? typography.bodyLarge;\n\n    return { label: labelTypography, panel: panelTypography };\n}\n"],"mappings":";;;;AAiBA,IAAaE,IACTC,EAAgD,CAAC,CAAC,G;ACMtD,SAAOE,EAAA,GAAA;CAAA,IAAAC,KAAA,GAAAN,EAAAA,EAAAA,CAAA,CAAA,GAAwC,EAAA,UAAA,aAAAO,GAI3C,EAAA,OAAAC,GAAA,OAAAC,MAAiDC,EAC7CR,CACJ,GAEAS,IACIC,KAAAJ,KAAuBK,EAAU,uBACrCC,IAAwBC,KAAAN,KAAuBI,EAAU,WAAWG;CAEX,OAFWV,EAAA,OAAAK,KAAAL,EAAA,OAAAQ,KAE7D,IAAA;EAAA,OAASH;EAAe,OAASG;CAAgB,GAAC,EAAA,KAAAH,GAAA,EAAA,KAAAG,GAAA,EAAA,KAAAE,KAAA,IAAAV,EAAA,IAAlDU;AAAkD"}

package/dist/components/Disclosure/context/useDisclosureTypographyContext.d.ts

@@ -1,8 +1,24 @@
 import { Typography } from '../../../utils';
-export declare function useDisclosureTypographyContext({ label, panel, }: {
+/**
+ * Parameters for the {@link useDisclosureTypographyContext} hook.
+ */
+export interface UseDisclosureTypographyContextProps {
+    /** Optional label typography override passed directly to the component. */
     label?: Typography;
+    /** Optional panel typography override passed directly to the component. */
     panel?: Typography;
-}): {
+}
+/**
+ * Resolves the active typography styles for disclosure headers and panels.
+ *
+ * Checks explicit component props first, then falls back to inherited values from
+ * an enclosing {@link DisclosureGroup}, and finally defaults to Material 3 standard
+ * typography (`typography.titleMediumEmphasized` for labels, `typography.bodyLarge` for panels).
+ *
+ * @param props - Explicit typography overrides from component props.
+ * @returns An object containing resolved `label` and `panel` typography classes.
+ */
+export declare function useDisclosureTypographyContext({ label, panel, }: UseDisclosureTypographyContextProps): {
     label: Typography;
     panel: Typography;
 };

package/dist/components/Divider/Divider.d.ts

@@ -1,2 +1,31 @@
 import { Separator } from 'react-aria-components';
-export declare const Divider: React.FC<React.ComponentPropsWithRef<typeof Separator>>;
+/**
+ * Props for the {@link Divider} component.
+ * Extends React Aria's {@link Separator} props, supporting orientation (`"horizontal"` or `"vertical"`),
+ * element tag selection (`elementType`), and standard HTML attributes.
+ */
+export interface DividerProps extends React.ComponentPropsWithRef<typeof Separator> {
+}
+/**
+ * A thin horizontal or vertical line component implementing Material Design 3 Divider guidelines.
+ *
+ * Dividers separate, group, and structure content within lists and layouts. Built on top of
+ * React Aria's {@link Separator}, it ensures correct accessibility roles (`role="separator"`,
+ * `aria-orientation`) and adapts dynamically to configurable CSS tokens (`--md-divider-color`).
+ *
+ * @example
+ * ```tsx
+ * import { Divider } from '@adgytec/web-ui-components';
+ *
+ * // Standard horizontal divider
+ * <Divider />
+ *
+ * // Vertical separator between inline elements
+ * <div style={{ display: 'flex', height: '24px', alignItems: 'center' }}>
+ *     <span>Left Item</span>
+ *     <Divider orientation="vertical" />
+ *     <span>Right Item</span>
+ * </div>
+ * ```
+ */
+export declare const Divider: React.FC<DividerProps>;

package/dist/components/Divider/index.js

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

package/dist/components/Icon/Icon.d.ts

@@ -1,2 +1,31 @@
 import { IconProps } from './types';
+/**
+ * A standardized icon wrapper component implementing Material Design 3 icon sizing guidelines.
+ *
+ * Wraps `lucide-react` icons to enforce consistent sizing via predefined size tokens
+ * (`"dense"`, `"standard"`, `"medium"`, `"large"`, `"extra-large"`), custom numeric pixel values,
+ * or proportional `1em` inline text scaling via `withText`.
+ *
+ * @see https://m3.material.io/styles/icons/applying-icons
+ *
+ * @example
+ * ```tsx
+ * import { Icon } from '@adgytec/web-ui-components';
+ * import { Settings, AlertTriangle } from 'lucide-react';
+ *
+ * // Standard 24px icon (default)
+ * <Icon icon={Settings} />
+ *
+ * // Large preset icon
+ * <Icon icon={Settings} size="large" />
+ *
+ * // Explicit numeric pixel dimension
+ * <Icon icon={AlertTriangle} size={36} />
+ *
+ * // Inline with typography (scales to 1em)
+ * <h2>
+ *     <Icon icon={Settings} withText /> Account Settings
+ * </h2>
+ * ```
+ */
 export declare const Icon: React.FC<IconProps>;

package/dist/components/Icon/index.js

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

package/dist/components/Icon/types.d.ts

@@ -1,7 +1,35 @@
 import { LucideIcon } from 'lucide-react';
+/**
+ * Predefined icon size presets aligning with Material Design 3 icon specifications.
+ *
+ * - `"dense"`: Compact size (`--md-sys-icon-dense`, typically 18px).
+ * - `"standard"`: Default body icon size (`--md-sys-icon-standard`, typically 24px).
+ * - `"medium"`: Medium accent size (`--md-sys-icon-medium`, typically 32px).
+ * - `"large"`: Large hero or feature size (`--md-sys-icon-large`, typically 40px).
+ * - `"extra-large"`: Extra large display size (`--md-sys-icon-extra-large`, typically 48px).
+ */
 export type IconSize = "dense" | "standard" | "medium" | "large" | "extra-large";
+/**
+ * Props for the {@link Icon} component.
+ * Extends Lucide SVG props while overriding `size` to support design system presets or pixel values.
+ */
 export interface IconProps extends Omit<React.ComponentPropsWithRef<LucideIcon>, "size"> {
+    /**
+     * The Lucide icon component to render.
+     */
     icon: LucideIcon;
+    /**
+     * The size of the icon. Accepts a predefined design system preset or an exact numeric pixel value.
+     * Note: Ignored when {@link withText} is `true`.
+     *
+     * @default "standard"
+     */
     size?: IconSize | number;
+    /**
+     * When `true`, dimensions are set to `1em` by `1em`, allowing the icon to scale dynamically
+     * with the font size of the surrounding text or typography element.
+     *
+     * @default false
+     */
     withText?: boolean;
 }

package/dist/components/Input/CharacterCount/CharacterCount.d.ts

@@ -1,5 +1,14 @@
 import { RefProp } from '../../../utils';
-export declare const CharacterCount: React.FC<{
+/**
+ * Props for the {@link CharacterCount} component.
+ */
+export interface CharacterCountProps extends RefProp<"span"> {
+    /** Current character count. */
     count: number;
+    /** Optional maximum allowed character limit. */
     maxLength?: number;
-} & RefProp<"span">>;
+}
+/**
+ * Displays the current character count and optional maximum character limit below text inputs.
+ */
+export declare const CharacterCount: React.FC<CharacterCountProps>;

package/dist/components/Input/CharacterCount/index.js

@@ -3,7 +3,7 @@ import { t } from "../../../chunks/base";
 import { t as n } from "../../../chunks/core4";
 import r from "clsx";
 import { jsxs as i } from "react/jsx-runtime";
-//#region src/components/Input/CharacterCount/CharacterCount.tsx
+// src/components/Input/CharacterCount/CharacterCount.tsx
 var a = e(), o = (e) => {
 	let o = (0, a.c)(9), s, c, l;
 	o[0] === e ? (s = o[1], c = o[2], l = o[3]) : ({count: s, maxLength: c, ...l} = e, o[0] = e, o[1] = s, o[2] = c, o[3] = l);
@@ -16,7 +16,6 @@ var a = e(), o = (e) => {
 		children: [s, d]
 	}), o[5] = s, o[6] = l, o[7] = d, o[8] = f) : f = o[8], f;
 };
-//#endregion
 export { o as CharacterCount };
 
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["count"],"sources":["../../../../src/components/Input/CharacterCount/CharacterCount.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { type RefProp, typography } from \"@/utils\";\nimport { CharacterCountStyles } from \"../core\";\n\nexport const CharacterCount: React.FC<\n    {\n        count: number;\n        maxLength?: number;\n    } & RefProp<\"span\">\n> = ({ count, maxLength, ...props }) => {\n    return (\n        <span\n            className={clsx(CharacterCountStyles, typography.labelMedium)}\n            {...props}\n        >\n            {count}\n            {maxLength !== undefined && `/${maxLength}`}\n        </span>\n    );\n};\n"],"mappings":";;;;;;aAIa,KAKT,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAA+B,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OAA9B,4BAAA,KAAA,GAA8B,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KAGZ,IAAA,EAAK,GAAsB,EAAU,WAAY,GAAC,EAAA,KAAA,KAAA,IAAA,EAAA;CAI5D,IAAA,IAAA,MAAc,KAAA,KAAd,IAA+B,KAAW;CACxC,OADwC,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAL/C,IAAA,kBAAA,QAAA;EACe,WAAA;EAAkD,GACzD;YAFR,CAIK,GACA,CACE;KAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IANP;AAMO"}
+{"version":3,"file":"index.js","names":["count","_c","clsx","require_compiler_runtime","CharacterCountStyles","clsx$1","import_compiler_runtime","CharacterCount","$","count","maxLength","props","t0","t1","typography","t2","t3"],"sources":["../../../../src/components/Input/CharacterCount/CharacterCount.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { type RefProp, typography } from \"@/utils\";\nimport { CharacterCountStyles } from \"../core\";\n\n/**\n * Props for the {@link CharacterCount} component.\n */\nexport interface CharacterCountProps extends RefProp<\"span\"> {\n    /** Current character count. */\n    count: number;\n    /** Optional maximum allowed character limit. */\n    maxLength?: number;\n}\n\n/**\n * Displays the current character count and optional maximum character limit below text inputs.\n */\nexport const CharacterCount: React.FC<CharacterCountProps> = ({\n    count,\n    maxLength,\n    ...props\n}) => {\n    return (\n        <span\n            className={clsx(CharacterCountStyles, typography.labelMedium)}\n            {...props}\n        >\n            {count}\n            {maxLength !== undefined && `/${maxLength}`}\n        </span>\n    );\n};\n"],"mappings":";;;;;;A,aAiBaO,KAAgD,MAAA;CAAA,IAAAC,KAAA,GAAAP,EAAAA,EAAAA,CAAA,CAAA,GAAAQ,GAAAC,GAAAC;CAAA,AAAAH,EAAA,OAAAI,KAI5D,IAAAJ,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OAJ6D,yBAAA,GAAAG,KAAAC,GAI7D,EAAA,KAAAA,GAAA,EAAA,KAAAH,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAL,EAAA,OAAA,OAAA,IAAA,2BAAA,KAGsB,IAAAN,EAAKE,GAAsBU,EAAU,WAAY,GAAC,EAAA,KAAAD,KAAA,IAAAL,EAAA;CAI5D,IAAAO,IAAAL,MAAc,KAAA,KAAd,IAA+BA,KAAWM;CACxC,OADwCR,EAAA,OAAAC,KAAAD,EAAA,OAAAG,KAAAH,EAAA,OAAAO,KAL/C,IAAA,kBAAA,QAAA;EACe,WAAAF;EAAkD,GACzDF;EAFR,UAAA,CAIKF,GACAM,CACE;C,IAAA,EAAA,KAAAN,GAAA,EAAA,KAAAE,GAAA,EAAA,KAAAI,GAAA,EAAA,KAAAC,KAAA,IAAAR,EAAA,IANPQ;AAMO"}