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

package/dist/components/Input/Slider/CenteredSlider/index.js

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

package/dist/components/Input/Slider/CenteredSlider/types.d.ts

@@ -1,5 +1,11 @@
 import { Slider } from 'react-aria-components';
 import { BaseSliderProps } from '../core';
+/**
+ * Props for the [`CenteredSlider`](src/components/Input/Slider/CenteredSlider/CenteredSlider.tsx) component.
+ */
 export interface CenteredSliderProps<T extends number> extends Omit<React.ComponentPropsWithRef<typeof Slider<T>>, "children">, BaseSliderProps {
+    /**
+     * Accessible label (`aria-label`) for the slider thumb.
+     */
     thumbLabel?: string;
 }

package/dist/components/Input/Slider/RangeSlider/RangeSlider.d.ts

@@ -1,2 +1,25 @@
 import { RangeSliderProps, RangeSliderType } from './types';
-export declare const RangeSlider: <T extends RangeSliderType>({ label, thumbLabels, size, minValue, maxValue, step, defaultValue, showInBetweenSteps, maxStops, outputRenderer, className, ...props }: RangeSliderProps<T>) => import("react").JSX.Element;
+/**
+ * Material Design 3 dual-thumb range slider component.
+ *
+ * Allows users to choose a numeric range `[start, end]` using two independently draggable
+ * thumbs. Displays an active filled track between the thumbs, supports step indicators
+ * via [`SliderStops`](src/components/Input/Slider/SliderStops/SliderStops.tsx),
+ * and handles thumb overlap transitions.
+ *
+ * @example
+ * ```tsx
+ * import { RangeSlider } from "@adgytec/web-ui-components";
+ *
+ * <RangeSlider
+ *     label="Price Range"
+ *     minValue={0}
+ *     maxValue={1000}
+ *     defaultValue={[100, 500]}
+ *     step={25}
+ *     showInBetweenSteps
+ *     thumbLabels={["Minimum Price", "Maximum Price"]}
+ * />
+ * ```
+ */
+export declare const RangeSlider: <T extends RangeSliderType>({ label, thumbLabels, size, minValue, maxValue, step, defaultValue, showInBetweenSteps, maxStops, outputRenderer, className, ...props }: RangeSliderProps<T>) => import('react').JSX.Element;

package/dist/components/Input/Slider/RangeSlider/index.js

@@ -5,7 +5,7 @@ import { t as u } from "../../../../chunks/SliderThumb";
 import d from "clsx";
 import { Fragment as f, jsx as p, jsxs as m } from "react/jsx-runtime";
 import { Slider as h, SliderTrack as g } from "react-aria-components";
-//#region src/components/Input/Slider/RangeSlider/RangeSlider.tsx
+// src/components/Input/Slider/RangeSlider/RangeSlider.tsx
 var _ = ({ label: _, thumbLabels: v, size: y = "small", minValue: b = 0, maxValue: x = 100, step: S = 1, defaultValue: C = [b, b], showInBetweenSteps: w, maxStops: T, outputRenderer: E, className: D, ...O }) => /* @__PURE__ */ p(h, {
 	minValue: b,
 	maxValue: x,
@@ -71,7 +71,6 @@ var _ = ({ label: _, thumbLabels: v, size: y = "small", minValue: b = 0, maxValu
 		})] });
 	}
 });
-//#endregion
 export { _ as RangeSlider };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Input/Slider/RangeSlider/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/components/Input/Slider/RangeSlider/RangeSlider.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Slider as AriaSlider, SliderTrack } from \"react-aria-components\";\nimport { Label } from \"../../Label\";\nimport {\n    ActiveTrackStyles,\n    InactiveTrackStyles,\n    SliderColors,\n    SliderSizeStyles,\n    SliderStyles,\n    TrackContainerStyles,\n    TrackStyles,\n    VisualTrackStyles,\n} from \"../core\";\nimport { SliderStops } from \"../SliderStops\";\nimport { SliderThumb } from \"../SliderThumb\";\nimport type { RangeSliderProps, RangeSliderType } from \"./types\";\n\nexport const RangeSlider = <T extends RangeSliderType>({\n    label,\n    thumbLabels,\n    size = \"small\",\n    minValue = 0,\n    maxValue = 100,\n    step = 1,\n    defaultValue = [minValue, minValue] as T,\n    showInBetweenSteps,\n    maxStops,\n    outputRenderer,\n    className,\n    ...props\n}: RangeSliderProps<T>) => {\n    return (\n        <AriaSlider\n            minValue={minValue}\n            maxValue={maxValue}\n            step={step}\n            defaultValue={defaultValue}\n            className={(renderProps) =>\n                clsx(\n                    SliderStyles,\n                    SliderColors,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n        >\n            {({ orientation, state }) => {\n                const startThumbValue = state.getThumbPercent(0);\n                const endThumbValue = state.getThumbPercent(1);\n\n                const start = startThumbValue * 100;\n                const mid = (endThumbValue - startThumbValue) * 100;\n                const end = (1 - endThumbValue) * 100;\n\n                const sizeKey =\n                    orientation === \"horizontal\" ? \"inlineSize\" : \"blockSize\";\n\n                return (\n                    <>\n                        {label && <Label>{label}</Label>}\n\n                        <div\n                            className={clsx(TrackContainerStyles)}\n                            data-orientation={orientation}\n                        >\n                            <SliderTrack\n                                className={clsx(\n                                    TrackStyles,\n                                    SliderSizeStyles(size)\n                                )}\n                            >\n                                <div\n                                    className={clsx(VisualTrackStyles)}\n                                    data-orientation={orientation}\n                                >\n                                    <div\n                                        className={clsx(InactiveTrackStyles)}\n                                        data-orientation={orientation}\n                                        data-track=\"start\"\n                                        style={{\n                                            [sizeKey]: `${start}%`,\n                                        }}\n                                    />\n\n                                    <div\n                                        className={clsx(ActiveTrackStyles)}\n                                        data-orientation={orientation}\n                                        data-track=\"mid\"\n                                        style={{\n                                            [sizeKey]: `${mid}%`,\n                                        }}\n                                    >\n                                        <div />\n                                    </div>\n\n                                    <div\n                                        className={clsx(InactiveTrackStyles)}\n                                        data-orientation={orientation}\n                                        data-track=\"end\"\n                                        style={{\n                                            [sizeKey]: `${end}%`,\n                                        }}\n                                    />\n                                </div>\n\n                                <SliderStops\n                                    minValue={minValue}\n                                    maxValue={maxValue}\n                                    step={step}\n                                    orientation={orientation}\n                                    slider=\"range\"\n                                    showInBetweenSteps={showInBetweenSteps}\n                                    maxStops={maxStops}\n                                />\n\n                                {state.values.map((_, i) => {\n                                    const increaseZindex =\n                                        i === 0 &&\n                                        state.getThumbValue(i) === maxValue;\n                                    return (\n                                        <SliderThumb\n                                            // biome-ignore lint: index is stable here\n                                            key={i}\n                                            index={i}\n                                            size={size}\n                                            orientation={orientation}\n                                            aria-label={thumbLabels?.[i]}\n                                            data-z-index-increase={\n                                                increaseZindex || undefined\n                                            }\n                                            outputRenderer={outputRenderer}\n                                        />\n                                    );\n                                })}\n                            </SliderTrack>\n                        </div>\n                    </>\n                );\n            }}\n        </AriaSlider>\n    );\n};\n"],"mappings":";;;;;;;;AAiBA,IAAa,KAA0C,EACnD,UACA,gBACA,UAAO,SACP,cAAW,GACX,cAAW,KACX,UAAO,GACP,kBAAe,CAAC,GAAU,CAAQ,GAClC,uBACA,aACA,mBACA,cACA,GAAG,QAGC,kBAAC,GAAD;CACc;CACA;CACJ;CACQ;CACd,YAAY,MACR,EACI,GACA,GACA,OAAO,KAAc,aACf,EAAU,CAAW,IACrB,CACV;CAEJ,GAAI;YAEF,EAAE,gBAAa,eAAY;EACzB,IAAM,IAAkB,EAAM,gBAAgB,CAAC,GACzC,IAAgB,EAAM,gBAAgB,CAAC,GAEvC,IAAQ,IAAkB,KAC1B,KAAO,IAAgB,KAAmB,KAC1C,KAAO,IAAI,KAAiB,KAE5B,IACF,MAAgB,eAAe,eAAe;EAElD,OACI,kBAAA,GAAA,EAAA,UAAA,CACK,KAAS,kBAAC,GAAD,EAAA,UAAQ,EAAa,CAAA,GAE/B,kBAAC,OAAD;GACI,WAAW,EAAK,CAAoB;GACpC,oBAAkB;aAElB,kBAAC,GAAD;IACI,WAAW,EACP,GACA,EAAiB,CAAI,CACzB;cAJJ;KAMI,kBAAC,OAAD;MACI,WAAW,EAAK,CAAiB;MACjC,oBAAkB;gBAFtB;OAII,kBAAC,OAAD;QACI,WAAW,EAAK,CAAmB;QACnC,oBAAkB;QAClB,cAAW;QACX,OAAO,GACF,IAAU,GAAG,EAAK,GACvB;OAAE,CAAA;OAGN,kBAAC,OAAD;QACI,WAAW,EAAK,CAAiB;QACjC,oBAAkB;QAClB,cAAW;QACX,OAAO,GACF,IAAU,GAAG,EAAG,GACrB;kBAEA,kBAAC,OAAD,CAAI,CAAA;OACH,CAAA;OAEL,kBAAC,OAAD;QACI,WAAW,EAAK,CAAmB;QACnC,oBAAkB;QAClB,cAAW;QACX,OAAO,GACF,IAAU,GAAG,EAAG,GACrB;OAAE,CAAA;MAEL;;KAEL,kBAAC,GAAD;MACc;MACA;MACJ;MACO;MACb,QAAO;MACa;MACV;KAAS,CAAA;KAGtB,EAAM,OAAO,KAAK,GAAG,MAAM;MACxB,IAAM,IACF,MAAM,KACN,EAAM,cAAc,CAAC,MAAM;MAC/B,OACI,kBAAC,GAAD;OAGI,OAAO;OACD;OACO;OACb,cAAY,IAAc;OAC1B,yBACI,KAAkB,KAAA;OAEN;MAAe,GAR1B,CAQ0B;KAG3C,CAAC;IACQ;;EACZ,CAAA,CACT,EAAA,CAAA;CAER;AACQ,CAAA"}
+{"version":3,"file":"index.js","names":["AriaSlider","clsx","_Fragment","Label","SliderThumb","Label$1","SliderStyles","SliderColors","SliderSizeStyles","InactiveTrackStyles","TrackContainerStyles","VisualTrackStyles","ActiveTrackStyles","SliderStops","SliderThumb$1","clsx$1","RangeSlider","minValue","props","Slider","className","renderProps","startThumbValue","state","endThumbValue","start","mid","end","sizeKey","orientation","Fragment","label","SliderTrack","TrackStyles","size","increaseZindex","i","maxValue","thumbLabels"],"sources":["../../../../../src/components/Input/Slider/RangeSlider/RangeSlider.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Slider as AriaSlider, SliderTrack } from \"react-aria-components\";\nimport { Label } from \"../../Label\";\nimport {\n    ActiveTrackStyles,\n    InactiveTrackStyles,\n    SliderColors,\n    SliderSizeStyles,\n    SliderStyles,\n    TrackContainerStyles,\n    TrackStyles,\n    VisualTrackStyles,\n} from \"../core\";\nimport { SliderStops } from \"../SliderStops\";\nimport { SliderThumb } from \"../SliderThumb\";\nimport type { RangeSliderProps, RangeSliderType } from \"./types\";\n\n/**\n * Material Design 3 dual-thumb range slider component.\n *\n * Allows users to choose a numeric range `[start, end]` using two independently draggable\n * thumbs. Displays an active filled track between the thumbs, supports step indicators\n * via [`SliderStops`](src/components/Input/Slider/SliderStops/SliderStops.tsx),\n * and handles thumb overlap transitions.\n *\n * @example\n * ```tsx\n * import { RangeSlider } from \"@adgytec/web-ui-components\";\n *\n * <RangeSlider\n *     label=\"Price Range\"\n *     minValue={0}\n *     maxValue={1000}\n *     defaultValue={[100, 500]}\n *     step={25}\n *     showInBetweenSteps\n *     thumbLabels={[\"Minimum Price\", \"Maximum Price\"]}\n * />\n * ```\n */\nexport const RangeSlider = <T extends RangeSliderType>({\n    label,\n    thumbLabels,\n    size = \"small\",\n    minValue = 0,\n    maxValue = 100,\n    step = 1,\n    defaultValue = [minValue, minValue] as T,\n    showInBetweenSteps,\n    maxStops,\n    outputRenderer,\n    className,\n    ...props\n}: RangeSliderProps<T>) => {\n    return (\n        <AriaSlider\n            minValue={minValue}\n            maxValue={maxValue}\n            step={step}\n            defaultValue={defaultValue}\n            className={(renderProps) =>\n                clsx(\n                    SliderStyles,\n                    SliderColors,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n        >\n            {({ orientation, state }) => {\n                const startThumbValue = state.getThumbPercent(0);\n                const endThumbValue = state.getThumbPercent(1);\n\n                const start = startThumbValue * 100;\n                const mid = (endThumbValue - startThumbValue) * 100;\n                const end = (1 - endThumbValue) * 100;\n\n                const sizeKey =\n                    orientation === \"horizontal\" ? \"inlineSize\" : \"blockSize\";\n\n                return (\n                    <>\n                        {label && <Label>{label}</Label>}\n\n                        <div\n                            className={clsx(TrackContainerStyles)}\n                            data-orientation={orientation}\n                        >\n                            <SliderTrack\n                                className={clsx(\n                                    TrackStyles,\n                                    SliderSizeStyles(size)\n                                )}\n                            >\n                                <div\n                                    className={clsx(VisualTrackStyles)}\n                                    data-orientation={orientation}\n                                >\n                                    <div\n                                        className={clsx(InactiveTrackStyles)}\n                                        data-orientation={orientation}\n                                        data-track=\"start\"\n                                        style={{\n                                            [sizeKey]: `${start}%`,\n                                        }}\n                                    />\n\n                                    <div\n                                        className={clsx(ActiveTrackStyles)}\n                                        data-orientation={orientation}\n                                        data-track=\"mid\"\n                                        style={{\n                                            [sizeKey]: `${mid}%`,\n                                        }}\n                                    >\n                                        <div />\n                                    </div>\n\n                                    <div\n                                        className={clsx(InactiveTrackStyles)}\n                                        data-orientation={orientation}\n                                        data-track=\"end\"\n                                        style={{\n                                            [sizeKey]: `${end}%`,\n                                        }}\n                                    />\n                                </div>\n\n                                <SliderStops\n                                    minValue={minValue}\n                                    maxValue={maxValue}\n                                    step={step}\n                                    orientation={orientation}\n                                    slider=\"range\"\n                                    showInBetweenSteps={showInBetweenSteps}\n                                    maxStops={maxStops}\n                                />\n\n                                {state.values.map((_, i) => {\n                                    const increaseZindex =\n                                        i === 0 &&\n                                        state.getThumbValue(i) === maxValue;\n                                    return (\n                                        <SliderThumb\n                                            // biome-ignore lint: index is stable here\n                                            key={i}\n                                            index={i}\n                                            size={size}\n                                            orientation={orientation}\n                                            aria-label={thumbLabels?.[i]}\n                                            data-z-index-increase={\n                                                increaseZindex || undefined\n                                            }\n                                            outputRenderer={outputRenderer}\n                                        />\n                                    );\n                                })}\n                            </SliderTrack>\n                        </div>\n                    </>\n                );\n            }}\n        </AriaSlider>\n    );\n};\n"],"mappings":";;;;;;;;AAwCA,IAAagB,KAA0C,EACnD,UACA,gBACA,UAAO,SACP,cAAW,GACX,cAAW,KACX,UAAO,GACP,kBAAe,CAACC,GAAUA,CAAQ,GAClC,uBACA,aACA,mBACA,cACA,GAAGC,QAGC,kBAAClB,GAAD;CACc;CACA;CACJ;CACQ;CACd,YAAY,MACRC,EACIK,GACAC,GACA,OAAOa,KAAc,aACfA,EAAUC,CAAW,IACrBD,CACV;CAEJ,GAAIF;CAEF,WAAA,EAAE,gBAAa,eAAY;EACzB,IAAMI,IAAkBC,EAAM,gBAAgB,CAAC,GACzCC,IAAgBD,EAAM,gBAAgB,CAAC,GAEvCE,IAAQH,IAAkB,KAC1BI,KAAOF,IAAgBF,KAAmB,KAC1CK,KAAO,IAAIH,KAAiB,KAE5BI,IACFC,MAAgB,eAAe,eAAe;EAElD,OACI,kBAAA3B,GAAA,EAAA,UAAA,CACK6B,KAAS,kBAAC5B,GAAD,EAAA,UAAQ4B,EAAa,CAAA,GAE/B,kBAAC,OAAD;GACI,WAAW9B,EAAKS,CAAoB;GACpC,oBAAkBmB;GAElB,UAAA,kBAACG,GAAD;IACI,WAAW/B,EACPgC,GACAzB,EAAiB0B,CAAI,CACzB;IAJJ,UAAA;KAMI,kBAAC,OAAD;MACI,WAAWjC,EAAKU,CAAiB;MACjC,oBAAkBkB;MAFtB,UAAA;OAII,kBAAC,OAAD;QACI,WAAW5B,EAAKQ,CAAmB;QACnC,oBAAkBoB;QAClB,cAAW;QACX,OAAO,GACFD,IAAU,GAAGH,EAAK,GACvB;OAAE,CAAA;OAGN,kBAAC,OAAD;QACI,WAAWxB,EAAKW,CAAiB;QACjC,oBAAkBiB;QAClB,cAAW;QACX,OAAO,GACFD,IAAU,GAAGF,EAAG,GACrB;QAEA,UAAA,kBAAC,OAAD,CAAI,CAAA;OACH,CAAA;OAEL,kBAAC,OAAD;QACI,WAAWzB,EAAKQ,CAAmB;QACnC,oBAAkBoB;QAClB,cAAW;QACX,OAAO,GACFD,IAAU,GAAGD,EAAG,GACrB;OAAE,CAAA;MAEL;;KAEL,kBAACd,GAAD;MACc;MACA;MACJ;MACO;MACb,QAAO;MACa;MACV;KAAS,CAAA;KAGtBU,EAAM,OAAO,KAAK,GAAG,MAAM;MACxB,IAAMY,IACFC,MAAM,KACNb,EAAM,cAAca,CAAC,MAAMC;MAC/B,OACI,kBAACjC,GAAD;OAGI,OAAOgC;OACD;OACO;OACb,cAAYE,IAAcF;OAC1B,yBACID,KAAkB,KAAA;OAEN;MAAe,GAR1BC,CAQ0B;KAG3C,CAAC;IACQ;;EACZ,CAAA,CACT,EAAA,CAAA;CAER;AACQ,CAAA"}

package/dist/components/Input/Slider/RangeSlider/types.d.ts

@@ -1,8 +1,17 @@
 import { Slider } from 'react-aria-components';
 import { BaseSliderProps } from '../core';
 type Tuple<T> = [T, T];
+/**
+ * Tuple representing the start and end values `[start, end]` of a range slider.
+ */
 export type RangeSliderType = Tuple<number>;
+/**
+ * Props for the dual-thumb [`RangeSlider`](src/components/Input/Slider/RangeSlider/RangeSlider.tsx) component.
+ */
 export interface RangeSliderProps<T extends RangeSliderType> extends Omit<React.ComponentPropsWithRef<typeof Slider<T>>, "children">, BaseSliderProps {
+    /**
+     * Accessible labels (`[startThumbLabel, endThumbLabel]`) for the start and end thumbs.
+     */
     thumbLabels?: Tuple<string>;
 }
 export {};

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

@@ -1,2 +1,25 @@
 import { SliderProps } from './types';
-export declare const Slider: <T extends number>({ label, thumbLabel, size, step, minValue, maxValue, showInBetweenSteps, insetIcon, minInsetIcon, maxStops, outputRenderer, className, ...props }: SliderProps<T>) => import("react").JSX.Element;
+/**
+ * Material Design 3 single-value slider component.
+ *
+ * Allows users to choose a specific numeric value along a track using a draggable thumb.
+ * Supports configurable sizes, step indicators via [`SliderStops`](src/components/Input/Slider/SliderStops/SliderStops.tsx),
+ * inset icons with automatic minimum-value swapping, and custom output formatting.
+ *
+ * @example
+ * ```tsx
+ * import { Slider } from "@adgytec/web-ui-components";
+ * import { Volume2, VolumeX } from "lucide-react";
+ *
+ * <Slider
+ *     label="Volume"
+ *     minValue={0}
+ *     maxValue={100}
+ *     defaultValue={50}
+ *     size="medium"
+ *     insetIcon={Volume2}
+ *     minInsetIcon={VolumeX}
+ * />
+ * ```
+ */
+export declare const Slider: <T extends number>({ label, thumbLabel, size, step, minValue, maxValue, showInBetweenSteps, insetIcon, minInsetIcon, maxStops, outputRenderer, className, ...props }: SliderProps<T>) => import('react').JSX.Element;

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

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

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

@@ -1,8 +1,21 @@
 import { LucideIcon } from 'lucide-react';
 import { Slider } from 'react-aria-components';
 import { BaseSliderProps } from '../core';
+/**
+ * Props for the single-value [`Slider`](src/components/Input/Slider/Slider/Slider.tsx) component.
+ */
 export interface SliderProps<T extends number> extends Omit<React.ComponentPropsWithRef<typeof Slider<T>>, "children">, BaseSliderProps {
+    /**
+     * An icon displayed within the track (rendered for `medium`, `large`, and `extra-large` sizes).
+     */
     insetIcon?: LucideIcon;
+    /**
+     * An alternate icon displayed within the track when the slider reaches its minimum value
+     * (e.g. a muted icon for a volume control).
+     */
     minInsetIcon?: LucideIcon;
+    /**
+     * Accessible label (`aria-label`) for the slider thumb.
+     */
     thumbLabel?: string;
 }

package/dist/components/Input/Slider/SliderOutput/SliderOutput.d.ts

@@ -1,2 +1,20 @@
 import { SliderOutput as AriaSliderOutput } from 'react-aria-components';
-export declare const SliderOutput: React.FC<React.ComponentPropsWithRef<typeof AriaSliderOutput>>;
+/**
+ * Props for the [`SliderOutput`](src/components/Input/Slider/SliderOutput/SliderOutput.tsx) component.
+ */
+export interface SliderOutputProps extends React.ComponentPropsWithRef<typeof AriaSliderOutput> {
+}
+/**
+ * Output tooltip / badge component displaying the current value of the slider thumb.
+ *
+ * Automatically connects to [`SliderThumbStateContext`](src/components/Input/Slider/SliderThumb/context.ts)
+ * to reflect hover, focus, and dragging states on data attributes.
+ *
+ * @example
+ * ```tsx
+ * <SliderOutput>
+ *     {({ state }) => `${state.getThumbValueLabel(0)}%`}
+ * </SliderOutput>
+ * ```
+ */
+export declare const SliderOutput: React.FC<SliderOutputProps>;

package/dist/components/Input/Slider/SliderOutput/index.js

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

package/dist/components/Input/Slider/SliderStops/SliderStops.d.ts

@@ -1,2 +1,20 @@
 import { SliderStopsProps } from './types';
+/**
+ * Component that renders step tick mark indicators along a slider track.
+ *
+ * Positions tick indicators using percentage offsets computed from `minValue`, `maxValue`,
+ * and `step`. Distinguishes between active and inactive track sections and hides stops
+ * directly beneath active thumbs.
+ *
+ * @example
+ * ```tsx
+ * <SliderStops
+ *     minValue={0}
+ *     maxValue={100}
+ *     step={10}
+ *     orientation="horizontal"
+ *     showInBetweenSteps
+ * />
+ * ```
+ */
 export declare const SliderStops: React.FC<SliderStopsProps>;

package/dist/components/Input/Slider/SliderStops/core.d.ts

@@ -1,24 +1,37 @@
 import { SliderVariant } from '../core';
 import { CalculateStops } from './types';
 /**
- * React Aria style clamp.
+ * Clamps a numeric value between minimum and maximum bounds.
+ *
+ * @param value - The input value to clamp.
+ * @param min - The lower bound. Defaults to `-Infinity`.
+ * @param max - The upper bound. Defaults to `Infinity`.
+ * @returns The clamped value within `[min, max]`.
  */
 export declare const clamp: (value: number, min?: number, max?: number) => number;
 /**
- * React Aria precision extraction.
+ * Calculates the decimal precision (number of decimal places) of a step value.
+ *
+ * Supports standard fractional numbers (e.g. `0.01` -> 2) and scientific notation (e.g. `1e-7` -> 7).
  *
- * Handles:
- * - 0.1
- * - 0.01
- * - 1e-7
+ * @param step - The step increment.
+ * @returns The number of decimal places represented by the step.
  */
 export declare const getStepPrecision: (step: number) => number;
 /**
- * React Aria style precision correction.
+ * Rounds a numeric value to the precision determined by the step value
+ * to eliminate floating-point calculation inaccuracies.
+ *
+ * @param value - The value to round.
+ * @param step - The step determining precision.
+ * @returns The rounded numeric value.
  */
 export declare const roundToStepPrecision: (value: number, step: number) => number;
 /**
- * React Aria snap implementation.
+ * Snaps a given number to the nearest valid step increment between min and max bounds.
+ *
+ * @param options - Configuration object containing value, minValue, maxValue, and step.
+ * @returns The snapped value aligned to the step grid.
  */
 export declare const snapValueToStep: ({ value, minValue, maxValue, step, }: {
     value: number;
@@ -27,10 +40,27 @@ export declare const snapValueToStep: ({ value, minValue, maxValue, step, }: {
     step: number;
 }) => number;
 /**
- * Generates all valid slider stops using
- * the same stepping logic as React Aria.
+ * Generates all valid slider tick stops along the track using stepping logic
+ * compatible with React Aria.
+ *
+ * If the number of generated stops exceeds `maxStops` or `showInBetweenSteps` is false,
+ * only the minimum and maximum boundaries are returned to prevent excessive DOM nodes.
+ *
+ * @param options - Stop calculation configuration.
+ * @returns Array of calculated {@link Stop} objects with `stopValue` and `percent`.
  */
 export declare const calcStops: CalculateStops;
+/**
+ * Determines whether a given tick stop falls within the active (highlighted) track range
+ * for the specified slider variant.
+ *
+ * - Standard slider: stops strictly below the thumb.
+ * - Range slider: stops strictly between the start and end thumbs.
+ * - Centered slider: stops between the mid-value and the thumb position.
+ *
+ * @param options - Configuration containing the slider variant, thumb values, mid-value, and stopValue.
+ * @returns `true` if the stop is within the active highlighted track segment.
+ */
 export declare const checkInActiveRange: ({ slider, midValue, firstThumbValue, secondThumbValue, stopValue, }: {
     slider: SliderVariant;
     midValue: number;
@@ -38,11 +68,25 @@ export declare const checkInActiveRange: ({ slider, midValue, firstThumbValue, s
     secondThumbValue: number;
     stopValue: number;
 }) => boolean;
+/**
+ * Checks whether a given stop coincides directly with any active thumb position.
+ *
+ * @param options - First and second thumb values, plus the candidate stopValue.
+ * @returns `true` if the stop is located directly underneath a thumb.
+ */
 export declare const checkIsBelowThumb: ({ firstThumbValue, secondThumbValue, stopValue, }: {
     firstThumbValue: number;
     secondThumbValue: number;
     stopValue: number;
 }) => boolean;
+/**
+ * Checks whether a stop indicator should be visually hidden.
+ *
+ * For centered sliders, the center anchor point is hidden to avoid overlapping track visuals.
+ *
+ * @param options - Slider variant, midValue, and stopValue.
+ * @returns `true` if the stop indicator should be hidden.
+ */
 export declare const shouldHide: ({ slider, midValue, stopValue, }: {
     slider: SliderVariant;
     midValue: number;

package/dist/components/Input/Slider/SliderStops/index.js

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

package/dist/components/Input/Slider/SliderStops/types.d.ts

@@ -1,16 +1,54 @@
 import { Orientation } from 'react-aria';
 import { SliderVariant } from '../core';
+/**
+ * Props for the [`SliderStops`](src/components/Input/Slider/SliderStops/SliderStops.tsx) component.
+ */
 export type SliderStopsProps = {
+    /**
+     * Minimum value of the slider range.
+     */
     minValue: number;
+    /**
+     * Maximum value of the slider range.
+     */
     maxValue: number;
+    /**
+     * Stepping increment between selectable slider values.
+     */
     step: number;
+    /**
+     * Whether to show intermediate tick marks between min and max bounds.
+     */
     showInBetweenSteps?: boolean;
+    /**
+     * Layout orientation of the slider track.
+     */
     orientation: Orientation;
+    /**
+     * Variant of the slider determining track filling behavior and active ranges.
+     *
+     * @default "standard"
+     */
     slider?: SliderVariant;
+    /**
+     * Maximum number of step ticks to render before reverting to min/max only.
+     */
     maxStops?: number;
 };
+/**
+ * Represents a single calculated step indicator mark along the slider track.
+ */
 export type Stop = {
+    /**
+     * The numeric value represented by this stop.
+     */
     stopValue: number;
+    /**
+     * The percentage offset (0 to 1) along the track where the stop is placed.
+     */
     percent: number;
 };
+/**
+ * Function signature for generating the list of tick stops along a slider track.
+ */
 export type CalculateStops = (values: Omit<SliderStopsProps, "orientation" | "thumbCount">) => Stop[];

package/dist/components/Input/Slider/SliderThumb/SliderThumb.d.ts

@@ -1,8 +1,38 @@
 import { Orientation } from 'react-aria';
 import { SliderThumb as AriaSliderThumb } from 'react-aria-components';
 import { OutputRenderer, SliderSize } from '../core';
-export declare const SliderThumb: React.FC<Omit<React.ComponentPropsWithRef<typeof AriaSliderThumb>, "children"> & {
+/**
+ * Props for the [`SliderThumb`](src/components/Input/Slider/SliderThumb/SliderThumb.tsx) component.
+ */
+export interface SliderThumbProps extends Omit<React.ComponentPropsWithRef<typeof AriaSliderThumb>, "children"> {
+    /**
+     * Layout orientation of the slider track.
+     */
     orientation: Orientation;
+    /**
+     * Size variant determining the dimensions of the thumb handle.
+     */
     size: SliderSize;
+    /**
+     * Custom renderer or static node for the thumb value tooltip output.
+     */
     outputRenderer?: OutputRenderer;
-}>;
+}
+/**
+ * Draggable handle component within a slider track.
+ *
+ * Wraps React Aria's `SliderThumb`, managing state transitions (drag, hover, focus)
+ * and hosting the [`SliderOutput`](src/components/Input/Slider/SliderOutput/SliderOutput.tsx)
+ * value bubble.
+ *
+ * @example
+ * ```tsx
+ * <SliderThumb
+ *     index={0}
+ *     size="medium"
+ *     orientation="horizontal"
+ *     aria-label="Volume level"
+ * />
+ * ```
+ */
+export declare const SliderThumb: React.FC<SliderThumbProps>;

package/dist/components/Input/Slider/SliderThumb/context.d.ts

@@ -1,7 +1,27 @@
+/**
+ * State values exposed by the parent [`SliderThumb`](src/components/Input/Slider/SliderThumb/SliderThumb.tsx)
+ * representing current user interactions.
+ */
 export type SliderThumbStateContextValue = {
+    /**
+     * Whether the slider thumb is currently being dragged.
+     */
     isDragging?: boolean;
+    /**
+     * Whether the slider thumb is currently hovered by a pointer.
+     */
     isHovered?: boolean;
+    /**
+     * Whether the slider thumb currently has input focus.
+     */
     isFocused?: boolean;
+    /**
+     * Whether the slider thumb has visible focus styling (e.g. via keyboard navigation).
+     */
     isFocusVisible?: boolean;
 };
+/**
+ * React context providing thumb interaction state to child components such as
+ * [`SliderOutput`](src/components/Input/Slider/SliderOutput/SliderOutput.tsx).
+ */
 export declare const SliderThumbStateContext: import('react').Context<SliderThumbStateContextValue>;

package/dist/components/Input/Slider/SliderThumb/index.js

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

package/dist/components/Input/Slider/core/color.d.ts

@@ -1 +1,2 @@
+/** CSS class providing theme color tokens for sliders. */
 export declare const SliderColors: string;

package/dist/components/Input/Slider/core/index.js

@@ -1,2 +1 @@
-import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "../../../../chunks/core7";
-export { s as ActiveTrackStyles, r as InactiveTrackStyles, t as SliderColors, n as SliderSizeStyles, e as SliderStyles, i as TrackContainerStyles, o as TrackStyles, a as VisualTrackStyles };
+export { t as ActiveTrackStyles, n as InactiveTrackStyles, c as SliderColors, i as SliderSizeStyles, a as SliderStyles, o as TrackContainerStyles, s as TrackStyles, r as VisualTrackStyles } from "../../../../chunks/core7";

package/dist/components/Input/Slider/core/size.d.ts

@@ -1,5 +1,17 @@
+/**
+ * Size presets for slider track height and thumb diameter.
+ */
 export type SliderSize = "extra-small" | "small" | "medium" | "large" | "extra-large";
+/** Base CSS class for the slider container. */
 export declare const SliderStyles: string;
+/** CSS class for the track wrapper container. */
 export declare const TrackContainerStyles: string;
+/** CSS class for the interactive slider track. */
 export declare const TrackStyles: string;
+/**
+ * Resolves the CSS module class for a given slider size preset.
+ *
+ * @param size - The desired slider size preset.
+ * @returns The corresponding CSS class name.
+ */
 export declare function SliderSizeStyles(size: SliderSize): string;

package/dist/components/Input/Slider/core/slider.d.ts

@@ -1,13 +1,57 @@
 import { ReactNode } from 'react';
 import { SliderThumbRenderProps } from 'react-aria-components';
 import { SliderSize } from './size';
+/**
+ * Custom renderer for formatting or replacing the slider thumb value display.
+ *
+ * Can be a static {@link ReactNode} or a render function receiving the current
+ * thumb state and index.
+ *
+ * @example
+ * ```tsx
+ * const formatPercent: OutputRenderer = ({ state, thumbIndex }) => (
+ *     <span>{state.values[thumbIndex]}%</span>
+ * );
+ * ```
+ */
 export type OutputRenderer = ReactNode | ((renderProps: SliderThumbRenderProps & {
     thumbIndex: number;
 }) => ReactNode);
+/**
+ * Common configuration properties shared across all slider variants.
+ *
+ * Extends base options for labels, sizing, step tick marks, and value outputs
+ * across [`Slider`](src/components/Input/Slider/Slider/Slider.tsx),
+ * [`RangeSlider`](src/components/Input/Slider/RangeSlider/RangeSlider.tsx),
+ * and [`CenteredSlider`](src/components/Input/Slider/CenteredSlider/CenteredSlider.tsx).
+ */
 export interface BaseSliderProps {
+    /**
+     * Label content displayed above the slider track.
+     */
     label?: ReactNode;
+    /**
+     * The thickness of the track and size of the slider thumb.
+     *
+     * @default "small"
+     */
     size?: SliderSize;
+    /**
+     * Maximum number of step indicator tick marks to render on the track.
+     * If the total number of steps exceeds this limit, intermediate tick marks are hidden
+     * to avoid overcrowding and DOM bloat.
+     *
+     * @default 20
+     */
     maxStops?: number;
+    /**
+     * Whether to display indicator ticks for each step along the slider track.
+     *
+     * @default true
+     */
     showInBetweenSteps?: boolean;
+    /**
+     * Custom renderer or node for the floating value bubble / output badge.
+     */
     outputRenderer?: OutputRenderer;
 }

package/dist/components/Input/Slider/core/variant.d.ts

@@ -1,4 +1,14 @@
+/**
+ * Functional slider track variants.
+ *
+ * - `"standard"`: Single thumb sliding from minimum to maximum.
+ * - `"centered"`: Single thumb sliding bidirectional deviations from center (zero/neutral point).
+ * - `"range"`: Two thumbs selecting a range interval between lower and upper bounds.
+ */
 export type SliderVariant = "standard" | "centered" | "range";
+/** CSS class for visual track background. */
 export declare const VisualTrackStyles: string;
+/** CSS class for the active/highlighted portion of the slider track. */
 export declare const ActiveTrackStyles: string;
+/** CSS class for the inactive/unselected portion of the slider track. */
 export declare const InactiveTrackStyles: string;

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

@@ -1,2 +1,34 @@
 import { SwitchProps } from './types';
+/**
+ * A toggle switch control implementing Material Design 3 Switch specifications.
+ *
+ * Toggles a binary on/off setting with an animated sliding thumb indicator, support for optional
+ * handle icons (such as checkmark and cross), and configurable label placement. Built on React Aria's
+ * `SwitchField` and `SwitchButton` components for robust accessibility, keyboard navigation, and form integration.
+ *
+ * @example
+ * ```tsx
+ * import { Switch } from "@adgytec/web-ui-components";
+ *
+ * <Switch isSelected={airplaneMode} onChange={setAirplaneMode}>
+ *     Airplane Mode
+ * </Switch>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom icons in both on/off states and label placed after switch
+ * import { Switch } from "@adgytec/web-ui-components";
+ * import { Wifi, WifiOff } from "lucide-react";
+ *
+ * <Switch
+ *     icon="both"
+ *     selectedIcon={Wifi}
+ *     unselectedIcon={WifiOff}
+ *     labelPlacement="end"
+ * >
+ *     Wi-Fi
+ * </Switch>
+ * ```
+ */
 export declare const Switch: React.FC<SwitchProps>;

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

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