@arkyn/components 3.0.1-beta.99 → 3.0.2

package/dist/components/alert/alertDescription/index.d.ts

@@ -1,50 +1,22 @@
-import { HTMLAttributes, JSX } from "react";
+import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
-/**
- * Props for the AlertDescription component.
- * @typedef {Object} AlertDescriptionProps
- * @extends {HTMLAttributes<HTMLDivElement>}
- */
 type AlertDescriptionProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertDescription component displays descriptive text content within an Alert component.
- *
- * This component provides a semantic wrapper for alert descriptions with appropriate styling
- * through the `arkynAlertDescription` CSS class. It extends all standard HTML div attributes,
- * making it flexible for various content and accessibility requirements.
- *
- * @component
- * @memberof Alert
+ * AlertDescription — body text for an alert. Place inside `AlertContent`.
  *
- * @param {AlertDescriptionProps} props - Component props extending HTML div attributes
- * @param {string} [props.className] - Additional CSS classes to apply to the description
- * @param {React.ReactNode} [props.children] - The description content to display
+ * Accepts all standard `<div>` HTML attributes.
  *
- * @returns {JSX.Element} A div element with alert description styling
- *
- * @requires react
- *
- * @example
- * // Basic usage
- * <AlertContainer schema="success">
- *  <AlertContent>
- *    <AlertDescription>
- *      Your are premium user now!
- *    </AlertDescription>
- *  </AlertContent>
- * </AlertContainer>
+ * @returns AlertDescription JSX element.
  *
  * @example
- * // Complete alert example
- * <AlertContainer schema="success">
- *  <AlertIcon />
- *  <AlertContent>
- *    <AlertTitle>Success!</AlertTitle>
- *    <AlertDescription>
- *      You are premium user now!
- *    </AlertDescription>
- *  </AlertContent>
+ * ```tsx
+ * <AlertContainer scheme="info">
+ *   <AlertContent>
+ *     <AlertTitle>Maintenance scheduled</AlertTitle>
+ *     <AlertDescription>The service will be unavailable on Sunday from 2–4 AM UTC.</AlertDescription>
+ *   </AlertContent>
  * </AlertContainer>
+ * ```
  */
 declare function AlertDescription(props: AlertDescriptionProps): JSX.Element;
 export { AlertDescription };

package/dist/components/alert/alertDescription/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertDescription/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,cAAc,CAAC;AAEtB;;;;GAIG;AACH,KAAK,qBAAqB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,GAAG,CAAC,OAAO,CAKnE;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertDescription/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,cAAc,CAAC;AAEtB,KAAK,qBAAqB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AAEH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,GAAG,CAAC,OAAO,CAKnE;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/alert/alertIcon/index.d.ts

@@ -1,53 +1,29 @@
-import { LucideProps } from "lucide-react";
-import { JSX } from "react";
+import { type LucideProps } from "lucide-react";
+import type { JSX } from "react";
 import "./styles.css";
-/**
- * Props for the AlertIcon component.
- * Extends all props from Lucide's icon components.
- *
- * @typedef {LucideProps} AlertIconProps
- */
 type AlertIconProps = LucideProps;
 /**
- * AlertIcon component that renders different icons based on the alert schema.
- *
- * @component
- * @memberof Alert
+ * AlertIcon — renders a scheme-appropriate icon from `AlertContainer` context.
  *
- * @description
- * This component automatically selects and renders the appropriate icon based on the
- * alert schema from the AlertContainer context. It supports four schemas:
- * - success: Renders a CheckCircle2 icon
- * - danger: Renders an XCircle icon
- * - warning: Renders an AlertTriangle icon
- * - info: Renders an Info icon
+ * - `success` → `CheckCircle2`
+ * - `danger` → `XCircle`
+ * - `warning` → `AlertTriangle`
+ * - `info` → `Info`
  *
- * @param {AlertIconProps} props - Component props extending LucideProps
- * @param {string} [props.className] - Additional CSS class names to apply to the icon
+ * Must be placed inside an `AlertContainer`. Accepts all Lucide icon props.
  *
- * @returns {JSX.Element} The rendered icon component based on the alert schema
- *
- * @requires lucide-react - For icon components (CheckCircle2, XCircle, AlertTriangle, Info)
- * @requires useAlertContainer - Hook to access the alert schema from context
+ * @returns The scheme-matched Lucide icon element.
  *
  * @example
- * // This component is used internally within an Alert component
- * // and should not be used standalone as it depends on AlertContainer context
- * <AlertContainer schema="success">
+ * ```tsx
+ * <AlertContainer scheme="danger">
  *   <AlertIcon />
+ *   <AlertContent>
+ *     <AlertTitle>Payment failed</AlertTitle>
+ *     <AlertDescription>Please check your card details.</AlertDescription>
+ *   </AlertContent>
  * </AlertContainer>
- *
- * @example
- * // Complete alert example
- * <AlertContainer schema="success">
- *  <AlertIcon />
- *  <AlertContent>
- *    <AlertTitle>Success!</AlertTitle>
- *    <AlertDescription>
- *      You are premium user now!
- *    </AlertDescription>
- *  </AlertContent>
- * </AlertContainer>
+ * ```
  */
 declare function AlertIcon(props: AlertIconProps): JSX.Element;
 export { AlertIcon };

package/dist/components/alert/alertIcon/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertIcon/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,WAAW,EAEZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,KAAK,cAAc,GAAG,WAAW,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,GAAG,CAAC,OAAO,CAgBrD;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertIcon/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,WAAW,EAEhB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,cAAc,CAAC;AAEtB,KAAK,cAAc,GAAG,WAAW,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,GAAG,CAAC,OAAO,CAgBrD;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/components/alert/alertTitle/index.d.ts

@@ -1,47 +1,24 @@
-import { HTMLAttributes, JSX } from "react";
+import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
-/**
- * Props for the AlertTitle component.
- * Extends all standard HTML div element attributes.
- *
- * @typedef {Object} AlertTitleProps
- * @property {string} [className] - Additional CSS class names to apply to the alert title
- * @extends {HTMLAttributes<HTMLDivElement>}
- */
 type AlertTitleProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertTitle component - Displays the title section of an alert message.
- *
- * This component renders a styled title for alert components, providing semantic structure
- * and consistent styling across the application.
- *
- * @component
- * @memberof Alert
+ * AlertTitle — bold heading for an alert. Place inside `AlertContent`.
  *
- * @param {AlertTitleProps} props - Component props extending HTML div attributes
+ * Its presence is detected by `AlertContainer` to switch the layout from centered to left-aligned.
+ * Accepts all standard `<div>` HTML attributes.
  *
- * @returns {JSX.Element} A div element with alert title styling
- *
- * @requires react
- *
- * @example
- * // Basic usage
- * <AlertContainer schema="success">
- *   <AlertTitle>Success!</AlertTitle>
- *   <AlertDescription>Your changes have been saved.</AlertDescription>
- * </AlertContainer>
+ * @returns AlertTitle JSX element.
  *
  * @example
- * // Complete alert example
- * <AlertContainer schema="success">
- *  <AlertIcon />
- *  <AlertContent>
- *    <AlertTitle>Success!</AlertTitle>
- *    <AlertDescription>
- *      You are premium user now!
- *    </AlertDescription>
- *  </AlertContent>
+ * ```tsx
+ * <AlertContainer scheme="danger">
+ *   <AlertIcon />
+ *   <AlertContent>
+ *     <AlertTitle>Access denied</AlertTitle>
+ *     <AlertDescription>You don't have permission to view this page.</AlertDescription>
+ *   </AlertContent>
  * </AlertContainer>
+ * ```
  */
 declare function AlertTitle(props: AlertTitleProps): JSX.Element;
 export { AlertTitle };

package/dist/components/alert/alertTitle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertTitle/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,cAAc,CAAC;AAEtB;;;;;;;GAOG;AACH,KAAK,eAAe,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAKvD;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertTitle/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAKvD;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,58 +1,50 @@
-import { AudioHTMLAttributes, JSX } from "react";
+import { type AudioHTMLAttributes, type 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,EACN,KAAK,mBAAmB,EACxB,KAAK,GAAG,EAIR,MAAM,OAAO,CAAC;AAIf,OAAO,cAAc,CAAC;AAEtB,2DAA2D;AAC3D,KAAK,qBAAqB,GAAG;IAC5B,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;CAC3B,CAAC;AAEF,KAAK,gBAAgB,GAAG,IAAI,CAC3B,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,SAAS,GAAG,KAAK,CACjB,GAAG;IACH,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;CACtD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAoHzD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

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

@@ -8,6 +8,6 @@ type HasFileContentProps = {
     reSendAudio?: () => void;
     changeAudioButtonText: string;
 };
-declare function HasFileContent(props: HasFileContentProps): import("react/jsx-runtime").JSX.Element;
+declare function HasFileContent(props: HasFileContentProps): import("react").JSX.Element;
 export { HasFileContent };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/audioUpload/hasFileContent/index.tsx"],"names":[],"mappings":"AAQA,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,2CA8DjD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/audioUpload/hasFileContent/index.tsx"],"names":[],"mappings":"AAQA,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,+BA8DjD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

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

@@ -1,82 +1,71 @@
 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)}
  * />
  * ```
  */
-declare function AudioUpload(props: AudioUploadProps): import("react/jsx-runtime").JSX.Element;
+declare function AudioUpload(props: AudioUploadProps): import("react").JSX.Element;
 export { AudioUpload };
 //# sourceMappingURL=index.d.ts.map

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;IACvB,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;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BAyG3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

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

@@ -7,6 +7,6 @@ type NoFileContentProps = {
     dropAudioText: string;
     handleSelectFile: (file: File) => void;
 };
-declare function NoFileContent(props: NoFileContentProps): import("react/jsx-runtime").JSX.Element;
+declare function NoFileContent(props: NoFileContentProps): import("react").JSX.Element;
 export { NoFileContent };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/audioUpload/noFileContent/index.tsx"],"names":[],"mappings":"AAGA,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAkD/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/audioUpload/noFileContent/index.tsx"],"names":[],"mappings":"AAGA,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAkD/C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

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

@@ -1,51 +1,60 @@
-import { LucideIcon } from "lucide-react";
-import { HTMLAttributes } from "react";
+import type { LucideIcon } from "lucide-react";
+import type { 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>
  * ```
  */
-declare function Badge(props: BadgeProps): import("react/jsx-runtime").JSX.Element;
+declare function Badge(props: BadgeProps): import("react").JSX.Element;
 export { Badge };
 //# sourceMappingURL=index.d.ts.map

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,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,cAAc,CAAC;AAEtB,KAAK,UAAU,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IAClD;;;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;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,iBAAS,KAAK,CAAC,KAAK,EAAE,UAAU,+BAwB/B;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}