@arkyn/components 3.0.1-beta.142 → 3.0.1-beta.144

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

@@ -1,58 +1,50 @@
 import { AudioHTMLAttributes, JSX } from "react";
 import "./styles.css";
-/**
- * @typedef {Object} AudioInformationProps
- * @property {number} currentTime - Current playback time in seconds
- * @property {number} totalTime - Total duration of the audio in seconds
- * @property {string} formattedCurrentTime - Formatted current time as MM:SS
- * @property {string} formattedTotalTime - Formatted total time as MM:SS
- */
+/** Audio state snapshot passed to play/pause callbacks. */
 type AudioInformationProps = {
+    /** Current playback position in seconds. */
     currentTime: number;
+    /** Total audio duration in seconds. */
     totalTime: number;
+    /** Current position formatted as `MM:SS`. */
     formattedCurrentTime: string;
+    /** Total duration formatted as `MM:SS`. */
     formattedTotalTime: string;
 };
-/**
- * @typedef {Object} AudioPlayerProps
- * @property {string} src - Audio source URL (required)
- * @property {boolean} [disabled] - Whether the audio player controls are disabled
- * @property {function(AudioInformationProps): void} [onPlayAudio] - Callback fired when audio starts playing
- * @property {function(AudioInformationProps): void} [onPauseAudio] - Callback fired when audio is paused
- */
 type AudioPlayerProps = Omit<AudioHTMLAttributes<HTMLAudioElement>, "onEnded" | "src"> & {
+    /** Audio file URL. Required. */
     src: string;
+    /** Disables the play/pause button and the progress slider. @default false */
     disabled?: boolean;
+    /** Callback fired when playback starts. Receives the current audio state. */
     onPlayAudio?: (props: AudioInformationProps) => void;
+    /** Callback fired when playback is paused. Receives the current audio state. */
     onPauseAudio?: (props: AudioInformationProps) => void;
 };
 /**
- * AudioPlayer component
+ * AudioPlayer — play/pause controls, a scrubable progress bar, and elapsed/total time display.
  *
- * A customizable audio player with play/pause controls, progress slider, and time display.
- * Provides callbacks for play and pause events with detailed audio information.
+ * @param props.src - Audio file URL. Required.
+ * @param props.disabled - Disables controls. Default: false
+ * @param props.onPlayAudio - Callback fired when playback starts.
+ * @param props.onPauseAudio - Callback fired when playback is paused.
  *
- * @component
+ * **...Other valid HTML properties for `<audio>` (except `onEnded` and `src`)**
  *
- * @param {AudioPlayerProps} props - The component props
- *
- * @returns {JSX.Element} The rendered audio player component
- *
- * @requires lucide-react - For Play and Pause icons
- * @requires useSlider - For slider state management
- * @requires slider - For the progress slider component
+ * @returns AudioPlayer JSX element.
  *
  * @example
- * // Basic usage
- * <AudioPlayer src="https://example.com/audio.mp3" />
+ * ```tsx
+ * // Basic
+ * <AudioPlayer src="/audio/episode.mp3" />
  *
- * @example
- * // With callbacks
+ * // With play/pause callbacks
  * <AudioPlayer
- *   src="https://example.com/audio.mp3"
- *   onPlayAudio={(info) => console.log('Playing:', info.formattedCurrentTime)}
- *   onPauseAudio={(info) => console.log('Paused at:', info.formattedCurrentTime)}
+ *   src="/audio/episode.mp3"
+ *   onPlayAudio={(info) => console.log("Playing at", info.formattedCurrentTime)}
+ *   onPauseAudio={(info) => console.log("Paused at", info.formattedCurrentTime)}
  * />
+ * ```
  */
 declare function AudioPlayer(props: AudioPlayerProps): JSX.Element;
 export { AudioPlayer };

package/dist/components/audioPlayer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/audioPlayer/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAA+B,MAAM,OAAO,CAAC;AAI9E,OAAO,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,KAAK,qBAAqB,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,KAAK,gBAAgB,GAAG,IAAI,CAC1B,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,SAAS,GAAG,KAAK,CAClB,GAAG;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAoHzD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/audioPlayer/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAA+B,MAAM,OAAO,CAAC;AAI9E,OAAO,cAAc,CAAC;AAEtB,2DAA2D;AAC3D,KAAK,qBAAqB,GAAG;IAC3B,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG,IAAI,CAC1B,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,SAAS,GAAG,KAAK,CAClB,GAAG;IACF,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAoHzD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/audioPlayer/index.js

@@ -5,32 +5,29 @@ import { useSlider } from "../../hooks/useSlider";
 import { Slider } from "../slider";
 import "./styles.css";
 /**
- * AudioPlayer component
+ * AudioPlayer — play/pause controls, a scrubable progress bar, and elapsed/total time display.
  *
- * A customizable audio player with play/pause controls, progress slider, and time display.
- * Provides callbacks for play and pause events with detailed audio information.
+ * @param props.src - Audio file URL. Required.
+ * @param props.disabled - Disables controls. Default: false
+ * @param props.onPlayAudio - Callback fired when playback starts.
+ * @param props.onPauseAudio - Callback fired when playback is paused.
  *
- * @component
+ * **...Other valid HTML properties for `<audio>` (except `onEnded` and `src`)**
  *
- * @param {AudioPlayerProps} props - The component props
- *
- * @returns {JSX.Element} The rendered audio player component
- *
- * @requires lucide-react - For Play and Pause icons
- * @requires useSlider - For slider state management
- * @requires slider - For the progress slider component
+ * @returns AudioPlayer JSX element.
  *
  * @example
- * // Basic usage
- * <AudioPlayer src="https://example.com/audio.mp3" />
+ * ```tsx
+ * // Basic
+ * <AudioPlayer src="/audio/episode.mp3" />
  *
- * @example
- * // With callbacks
+ * // With play/pause callbacks
  * <AudioPlayer
- *   src="https://example.com/audio.mp3"
- *   onPlayAudio={(info) => console.log('Playing:', info.formattedCurrentTime)}
- *   onPauseAudio={(info) => console.log('Paused at:', info.formattedCurrentTime)}
+ *   src="/audio/episode.mp3"
+ *   onPlayAudio={(info) => console.log("Playing at", info.formattedCurrentTime)}
+ *   onPauseAudio={(info) => console.log("Paused at", info.formattedCurrentTime)}
  * />
+ * ```
  */
 function AudioPlayer(props) {
     const { onPlayAudio, onPauseAudio, disabled, style, ...rest } = props;

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

@@ -1,79 +1,68 @@
 import "./styles.css";
 type AudioUploadProps = {
+    /** Field name for form submission (stores the uploaded audio URL). Required. */
     name: string;
+    /** Server endpoint URL that receives the `multipart/form-data` upload request. Required. */
     action: string;
+    /** Form-data field name used for the file. @default "file" */
     fileName?: string;
+    /** HTTP method for the upload request. @default "POST" */
     method?: string;
+    /** Accepted audio MIME types or extensions (e.g. `"audio/mp3,audio/wav"`). @default "audio/*" */
     acceptAudio?: string;
+    /** Text displayed in the drag-and-drop zone. @default "Ou arraste e solte um arquivo de áudio aqui" */
     dropAudioText?: string;
+    /** Label for the file-picker button before a file is selected. @default "Selecionar arquivo de áudio" */
     selectAudioButtonText?: string;
+    /** Label for the file-picker button after a file is selected. @default "Trocar arquivo de áudio" */
     changeAudioButtonText?: string;
+    /** Callback fired after a successful upload. Receives the URL returned by the server. */
     onChange?: (url?: string) => void;
+    /** Property name in the server response that contains the file URL. @default "url" */
     fileResponseName?: string;
+    /** Optional label text displayed above the upload area. */
     label?: string;
+    /** Displays an asterisk on the label to signal a required field. @default false */
     showAsterisk?: boolean;
+    /** Disables file selection and upload. @default false */
     disabled?: boolean;
+    /** Pre-populated audio URL (e.g. an existing recording). @default "" */
     defaultValue?: string;
 };
 /**
- * AudioUpload component - handles audio file upload with drag & drop functionality and server upload
+ * AudioUpload — drag-and-drop audio file uploader with server upload and playback preview.
  *
- * @param props - AudioUpload component properties
- * @param props.name - Required field name for form handling
- * @param props.action - Required server endpoint URL for file upload
- * @param props.fileName - Name of the file field in FormData. Default: "file"
- * @param props.method - HTTP method for upload request. Default: "POST"
- * @param props.acceptAudio - Audio file types to accept. Default: "audio/*"
- * @param props.dropAudioText - Text displayed in drop zone. Default: "Ou arraste e solte um arquivo de áudio aqui"
- * @param props.selectAudioButtonText - Text for file selection button. Default: "Selecionar arquivo de áudio"
- * @param props.changeAudioButtonText - Text for change file button. Default: "Trocar arquivo de áudio"
- * @param props.onChange - Callback function called after successful upload with the file URL
- * @param props.fileResponseName - Name of the URL field in server response. Default: "url"
- * @param props.label - Optional label text to display above the upload area
- * @param props.showAsterisk - Whether to show asterisk on label for required fields. Default: false
- * @param props.disabled - Whether the upload is disabled. Default: false
- * @param props.defaultValue - Default audio URL value
+ * Sends the file via `fetch` as `multipart/form-data` and stores the returned URL
+ * in a hidden `<input>` for form submission.
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * @returns AudioUpload JSX element with drag & drop zone or audio preview
+ * @param props.name - Field name for form submission. Required.
+ * @param props.action - Upload endpoint URL. Required.
+ * @param props.fileName - Form-data field name for the file. Default: "file"
+ * @param props.method - HTTP method. Default: "POST"
+ * @param props.acceptAudio - Accepted MIME types / extensions. Default: "audio/*"
+ * @param props.onChange - Callback fired after a successful upload — receives the audio URL.
+ * @param props.fileResponseName - Server response property containing the URL. Default: "url"
+ * @param props.label - Label text displayed above the upload area.
+ * @param props.showAsterisk - Appends `*` to the label. Default: false
+ * @param props.disabled - Disables file selection and upload. Default: false
+ * @param props.defaultValue - Pre-populated audio URL.
+ *
+ * @returns AudioUpload JSX element wrapped in `FieldWrapper`.
  *
  * @example
  * ```tsx
- * // Basic audio upload
- * <AudioUpload
- *   name="audio"
- *   action="/api/upload"
- * />
+ * // Basic
+ * <AudioUpload name="audio" action="/api/upload" />
  *
- * // Audio upload with label and custom texts
+ * // With label and custom texts
  * <AudioUpload
  *   name="podcast"
  *   action="/api/upload/podcast"
- *   label="Upload Podcast"
+ *   label="Podcast Episode"
  *   showAsterisk
- *   selectAudioButtonText="Choose Audio File"
- *   dropAudioText="Drop your audio file here"
- *   changeAudioButtonText="Change Audio"
- * />
- *
- * // Audio upload with callback and custom settings
- * <AudioUpload
- *   name="recording"
- *   action="/api/upload"
- *   label="Voice Recording"
- *   acceptAudio="audio/mp3,audio/wav"
- *   onChange={(url) => console.log('Uploaded:', url)}
- *   fileResponseName="audioUrl"
- *   fileName="recording"
- *   method="PUT"
- * />
- *
- * // Disabled audio upload with default value
- * <AudioUpload
- *   name="preview"
- *   action="/api/upload"
- *   disabled
- *   defaultValue="/path/to/audio.mp3"
- *   label="Audio Preview"
+ *   selectAudioButtonText="Choose audio file"
+ *   onChange={(url) => setPodcastUrl(url)}
  * />
  * ```
  */

package/dist/components/audioUpload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/audioUpload/index.tsx"],"names":[],"mappings":"AASA,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAyG3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/audioUpload/index.tsx"],"names":[],"mappings":"AASA,OAAO,cAAc,CAAC;AAEtB,KAAK,gBAAgB,GAAG;IACtB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yGAAyG;IACzG,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oGAAoG;IACpG,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAyG3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/audioUpload/index.js

@@ -8,64 +8,39 @@ import { HasFileContent } from "./hasFileContent";
 import { NoFileContent } from "./noFileContent";
 import "./styles.css";
 /**
- * AudioUpload component - handles audio file upload with drag & drop functionality and server upload
+ * AudioUpload — drag-and-drop audio file uploader with server upload and playback preview.
  *
- * @param props - AudioUpload component properties
- * @param props.name - Required field name for form handling
- * @param props.action - Required server endpoint URL for file upload
- * @param props.fileName - Name of the file field in FormData. Default: "file"
- * @param props.method - HTTP method for upload request. Default: "POST"
- * @param props.acceptAudio - Audio file types to accept. Default: "audio/*"
- * @param props.dropAudioText - Text displayed in drop zone. Default: "Ou arraste e solte um arquivo de áudio aqui"
- * @param props.selectAudioButtonText - Text for file selection button. Default: "Selecionar arquivo de áudio"
- * @param props.changeAudioButtonText - Text for change file button. Default: "Trocar arquivo de áudio"
- * @param props.onChange - Callback function called after successful upload with the file URL
- * @param props.fileResponseName - Name of the URL field in server response. Default: "url"
- * @param props.label - Optional label text to display above the upload area
- * @param props.showAsterisk - Whether to show asterisk on label for required fields. Default: false
- * @param props.disabled - Whether the upload is disabled. Default: false
- * @param props.defaultValue - Default audio URL value
+ * Sends the file via `fetch` as `multipart/form-data` and stores the returned URL
+ * in a hidden `<input>` for form submission.
+ * Integrates with `useForm` to display validation errors by field name.
  *
- * @returns AudioUpload JSX element with drag & drop zone or audio preview
+ * @param props.name - Field name for form submission. Required.
+ * @param props.action - Upload endpoint URL. Required.
+ * @param props.fileName - Form-data field name for the file. Default: "file"
+ * @param props.method - HTTP method. Default: "POST"
+ * @param props.acceptAudio - Accepted MIME types / extensions. Default: "audio/*"
+ * @param props.onChange - Callback fired after a successful upload — receives the audio URL.
+ * @param props.fileResponseName - Server response property containing the URL. Default: "url"
+ * @param props.label - Label text displayed above the upload area.
+ * @param props.showAsterisk - Appends `*` to the label. Default: false
+ * @param props.disabled - Disables file selection and upload. Default: false
+ * @param props.defaultValue - Pre-populated audio URL.
+ *
+ * @returns AudioUpload JSX element wrapped in `FieldWrapper`.
  *
  * @example
  * ```tsx
- * // Basic audio upload
- * <AudioUpload
- *   name="audio"
- *   action="/api/upload"
- * />
+ * // Basic
+ * <AudioUpload name="audio" action="/api/upload" />
  *
- * // Audio upload with label and custom texts
+ * // With label and custom texts
  * <AudioUpload
  *   name="podcast"
  *   action="/api/upload/podcast"
- *   label="Upload Podcast"
+ *   label="Podcast Episode"
  *   showAsterisk
- *   selectAudioButtonText="Choose Audio File"
- *   dropAudioText="Drop your audio file here"
- *   changeAudioButtonText="Change Audio"
- * />
- *
- * // Audio upload with callback and custom settings
- * <AudioUpload
- *   name="recording"
- *   action="/api/upload"
- *   label="Voice Recording"
- *   acceptAudio="audio/mp3,audio/wav"
- *   onChange={(url) => console.log('Uploaded:', url)}
- *   fileResponseName="audioUrl"
- *   fileName="recording"
- *   method="PUT"
- * />
- *
- * // Disabled audio upload with default value
- * <AudioUpload
- *   name="preview"
- *   action="/api/upload"
- *   disabled
- *   defaultValue="/path/to/audio.mp3"
- *   label="Audio Preview"
+ *   selectAudioButtonText="Choose audio file"
+ *   onChange={(url) => setPodcastUrl(url)}
  * />
  * ```
  */

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

@@ -2,47 +2,56 @@ import { LucideIcon } from "lucide-react";
 import { HTMLAttributes } from "react";
 import "./styles.css";
 type BadgeProps = HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Badge size.
+     * @default "lg"
+     */
     size?: "md" | "lg";
+    /**
+     * Visual style variant.
+     * - `solid`: filled background.
+     * - `outline`: bordered, transparent background.
+     * - `ghost`: no border, subtle background on hover.
+     * @default "ghost"
+     */
     variant?: "solid" | "outline" | "ghost";
+    /**
+     * Color scheme applied to the badge.
+     * @default "primary"
+     */
     scheme?: "primary" | "secondary" | "success" | "warning" | "danger" | "info";
+    /** Lucide icon rendered to the left of the label. */
     leftIcon?: LucideIcon;
+    /** Lucide icon rendered to the right of the label. */
     rightIcon?: LucideIcon;
 };
 /**
- * Badge component - used to display labels, statuses, and categorizations
+ * Badge — displays labels, statuses, and categorization tags.
  *
- * @param props - Badge component properties
- * @param props.size - Badge size. Default: "lg"
- * @param props.variant - Visual variant of the badge. Default: "ghost"
- * @param props.scheme - Badge color scheme. Default: "primary"
- * @param props.leftIcon - Optional icon to display on the left
- * @param props.rightIcon - Optional icon to display on the right
+ * @param props.size - Badge size (`md` | `lg`). Default: "lg"
+ * @param props.variant - Visual style variant. Default: "ghost"
+ * @param props.scheme - Color scheme. Default: "primary"
+ * @param props.leftIcon - Lucide icon rendered to the left of the label.
+ * @param props.rightIcon - Lucide icon rendered to the right of the label.
  *
- * **...Other valid HTML properties for div**
+ * **...Other valid HTML properties for `<div>`**
  *
- * @returns Badge JSX element
+ * @returns Badge JSX element.
  *
  * @example
  * ```tsx
  * // Basic badge
  * <Badge>New</Badge>
  *
- * // Badge with color scheme
+ * // With color scheme
  * <Badge scheme="success">Approved</Badge>
  *
- * // Badge with icons
- * <Badge leftIcon={CheckIcon} scheme="success">
- *  Completed
- * </Badge>
+ * // With icon
+ * <Badge leftIcon={CheckIcon} scheme="success">Completed</Badge>
  *
- * // Custom badge
- * <Badge
- *  size="lg"
- *  variant="solid"
- *  scheme="warning"
- *  rightIcon={AlertIcon}
- * >
- *  Warning
+ * // Custom size, variant and scheme
+ * <Badge size="lg" variant="solid" scheme="warning" rightIcon={AlertIcon}>
+ *   Warning
  * </Badge>
  * ```
  */

package/dist/components/badge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/badge/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,cAAc,CAAC;AAEtB,KAAK,UAAU,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IACjD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7E,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,iBAAS,KAAK,CAAC,KAAK,EAAE,UAAU,2CAwB/B;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/badge/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,cAAc,CAAC;AAEtB,KAAK,UAAU,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IACjD;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7E,qDAAqD;IACrD,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,iBAAS,KAAK,CAAC,KAAK,EAAE,UAAU,2CAwB/B;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/components/badge/index.js

@@ -2,40 +2,32 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { IconRenderer } from "../../services/iconRenderer";
 import "./styles.css";
 /**
- * Badge component - used to display labels, statuses, and categorizations
+ * Badge — displays labels, statuses, and categorization tags.
  *
- * @param props - Badge component properties
- * @param props.size - Badge size. Default: "lg"
- * @param props.variant - Visual variant of the badge. Default: "ghost"
- * @param props.scheme - Badge color scheme. Default: "primary"
- * @param props.leftIcon - Optional icon to display on the left
- * @param props.rightIcon - Optional icon to display on the right
+ * @param props.size - Badge size (`md` | `lg`). Default: "lg"
+ * @param props.variant - Visual style variant. Default: "ghost"
+ * @param props.scheme - Color scheme. Default: "primary"
+ * @param props.leftIcon - Lucide icon rendered to the left of the label.
+ * @param props.rightIcon - Lucide icon rendered to the right of the label.
  *
- * **...Other valid HTML properties for div**
+ * **...Other valid HTML properties for `<div>`**
  *
- * @returns Badge JSX element
+ * @returns Badge JSX element.
  *
  * @example
  * ```tsx
  * // Basic badge
  * <Badge>New</Badge>
  *
- * // Badge with color scheme
+ * // With color scheme
  * <Badge scheme="success">Approved</Badge>
  *
- * // Badge with icons
- * <Badge leftIcon={CheckIcon} scheme="success">
- *  Completed
- * </Badge>
+ * // With icon
+ * <Badge leftIcon={CheckIcon} scheme="success">Completed</Badge>
  *
- * // Custom badge
- * <Badge
- *  size="lg"
- *  variant="solid"
- *  scheme="warning"
- *  rightIcon={AlertIcon}
- * >
- *  Warning
+ * // Custom size, variant and scheme
+ * <Badge size="lg" variant="solid" scheme="warning" rightIcon={AlertIcon}>
+ *   Warning
  * </Badge>
  * ```
  */

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

@@ -2,56 +2,66 @@ import { LucideIcon } from "lucide-react";
 import { ButtonHTMLAttributes } from "react";
 import "./styles.css";
 type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    /** Shows a spinner and disables the button during async operations. @default false */
     isLoading?: boolean;
+    /** Text displayed beside the spinner when `isLoading` is true. */
     loadingText?: string;
+    /**
+     * Button size.
+     * @default "md"
+     */
     size?: "xs" | "sm" | "md" | "lg";
+    /**
+     * Visual style variant.
+     * - `solid`: filled background.
+     * - `outline`: bordered, transparent background.
+     * - `ghost`: no border, subtle hover.
+     * - `invisible`: no visual styling.
+     * @default "solid"
+     */
     variant?: "solid" | "outline" | "ghost" | "invisible";
+    /**
+     * Color scheme applied to the button.
+     * @default "primary"
+     */
     scheme?: "primary" | "success" | "warning" | "danger" | "info";
+    /** Lucide icon rendered to the left of the label. */
     leftIcon?: LucideIcon;
+    /** Lucide icon rendered to the right of the label. */
     rightIcon?: LucideIcon;
 };
 /**
- * Button component - used for user interactions and form submissions
+ * Button — used for user interactions and form submissions.
  *
- * @param props - Button component properties
- * @param props.isLoading - Controls loading state with spinner. Default: false
- * @param props.loadingText - Text to display during loading state
- * @param props.size - Button size. Default: "md"
- * @param props.variant - Visual variant of the button. Default: "solid"
- * @param props.scheme - Button color scheme. Default: "primary"
- * @param props.leftIcon - Optional icon to display on the left
- * @param props.rightIcon - Optional icon to display on the right
+ * @param props.isLoading - Shows a spinner and disables the button. Default: false
+ * @param props.loadingText - Text displayed beside the spinner when loading.
+ * @param props.size - Button size (`xs` | `sm` | `md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.scheme - Color scheme. Default: "primary"
+ * @param props.leftIcon - Lucide icon rendered to the left of the label.
+ * @param props.rightIcon - Lucide icon rendered to the right of the label.
  *
- * **...Other valid HTML properties for button**
+ * **...Other valid HTML properties for `<button>`**
  *
- * @returns Button JSX element
+ * @returns Button JSX element.
  *
  * @example
  * ```tsx
  * // Basic button
  * <Button>Click me</Button>
  *
- * // Button with color scheme
+ * // With color scheme
  * <Button scheme="success">Save</Button>
  *
- * // Button with loading state
- * <Button isLoading loadingText="Saving...">
- *  Save
- * </Button>
+ * // With loading state
+ * <Button isLoading loadingText="Saving...">Save</Button>
  *
- * // Button with icons
- * <Button leftIcon={SaveIcon} scheme="success">
- *  Save
- * </Button>
+ * // With icons
+ * <Button leftIcon={SaveIcon} scheme="success">Save</Button>
  *
- * // Custom button
- * <Button
- *  size="lg"
- *  variant="outline"
- *  scheme="danger"
- *  rightIcon={TrashIcon}
- * >
- *  Delete
+ * // Custom size, variant and scheme
+ * <Button size="lg" variant="outline" scheme="danger" rightIcon={TrashIcon}>
+ *   Delete
  * </Button>
  * ```
  */

package/dist/components/button/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/button/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,cAAc,CAAC;AAEtB,KAAK,WAAW,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GAAG;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACtD,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,iBAAS,MAAM,CAAC,KAAK,EAAE,WAAW,2CAuCjC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/button/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,cAAc,CAAC;AAEtB,KAAK,WAAW,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,GAAG;IAC3D,sFAAsF;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACtD;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/D,qDAAqD;IACrD,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,iBAAS,MAAM,CAAC,KAAK,EAAE,WAAW,2CAuCjC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}