@arkyn/components 3.0.1-beta.95 → 3.0.2

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

@@ -1,44 +1,48 @@
-import { HTMLAttributes } from "react";
+import { type HTMLAttributes, type JSX } from "react";
 import "./styles.css";
 type AlertContainerProps = {
-    schema: "success" | "danger" | "warning" | "info";
+    /**
+     * Visual style and semantic meaning.
+     * - `success`: green — operation completed.
+     * - `danger`: red — error or destructive action.
+     * - `warning`: yellow — caution required.
+     * - `info`: blue — informational message.
+     */
+    scheme: "success" | "danger" | "warning" | "info";
 } & HTMLAttributes<HTMLDivElement>;
+/** @internal Accesses the schema and HTML props of the enclosing `AlertContainer`. */
 declare function useAlertContainer(): AlertContainerProps;
 /**
- * AlertContainer component - used to display alert messages with different schemas
+ * AlertContainer — root wrapper for the Alert component set. Provides schema context to child components.
  *
- * @param props - AlertContainer component properties
- * @param props.schema - Alert color scheme and semantic meaning: "success" | "danger" | "warning" | "info"
+ * Automatically detects whether an `AlertTitle` is present among children and adjusts layout:
+ * centered when no title, left-aligned when a title is present.
  *
- * **...Other valid HTML properties for div**
+ * @param props.scheme - Visual style variant. Required.
+ * @param props.children - Alert sub-components: `AlertIcon`, `AlertContent`, `AlertTitle`, `AlertDescription`.
  *
- * @returns AlertContainer JSX element with context provider
+ * **...Other valid HTML properties for `<div>`**
+ *
+ * @returns AlertContainer JSX element.
  *
  * @example
  * ```tsx
- * // Basic alert
- * <AlertContainer schema="info">
- *   Alert message content
- * </AlertContainer>
- *
- * // Success alert
- * <AlertContainer schema="success">
- *   Operation completed successfully!
- * </AlertContainer>
- *
- * // Alert with title
- * <AlertContainer schema="warning">
- *   <AlertTitle>Warning</AlertTitle>
- *   Please check your input data.
+ * // Inline alert — no title, centered layout
+ * <AlertContainer scheme="success">
+ *   <AlertIcon />
+ *   <AlertContent>Your subscription has been activated.</AlertContent>
  * </AlertContainer>
  *
- * // Danger alert
- * <AlertContainer schema="danger">
- *   <AlertTitle>Error</AlertTitle>
- *   Something went wrong. Please try again.
+ * // Full alert with title and description — left-aligned layout
+ * <AlertContainer scheme="danger">
+ *   <AlertIcon />
+ *   <AlertContent>
+ *     <AlertTitle>Payment failed</AlertTitle>
+ *     <AlertDescription>Please check your card details and try again.</AlertDescription>
+ *   </AlertContent>
  * </AlertContainer>
  * ```
  */
-declare function AlertContainer(props: AlertContainerProps): import("react/jsx-runtime").JSX.Element;
+declare function AlertContainer(props: AlertContainerProps): JSX.Element;
 export { AlertContainer, useAlertContainer };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAAyB,MAAM,OAAO,CAAC;AAE7E,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CACnD,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAInC,iBAAS,iBAAiB,wBAEzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,2CAuCjD;AAED,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,cAAc,EACnB,KAAK,GAAG,EAIR,MAAM,OAAO,CAAC;AAEf,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG;IAC1B;;;;;;OAMG;IACH,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CAClD,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAInC,sFAAsF;AACtF,iBAAS,iBAAiB,IAAI,mBAAmB,CAEhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CA0C/D;AAED,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -1,45 +1,24 @@
-import { HTMLAttributes } from "react";
+import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
 type AlertContentProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertContent component - used to wrap and style the main content area of alerts
+ * AlertContent — text/content area inside an `AlertContainer`. Wraps `AlertTitle` and `AlertDescription`.
  *
- * @param props - AlertContent component properties
+ * Accepts all standard `<div>` HTML attributes.
  *
- * **...Other valid HTML properties for div**
- *
- * @returns AlertContent JSX element
+ * @returns AlertContent JSX element.
  *
  * @example
  * ```tsx
- * // Basic alert content
- * <AlertContainer schema="info">
- *   <AlertContent>
- *     This is the main alert message content.
- *   </AlertContent>
- * </AlertContainer>
- *
- * // Alert with title and content
- * <AlertContainer schema="success">
- *   <AlertContent>
- *     <AlertTitle>Success</AlertTitle>
- *     Your operation has been completed successfully.
- *   </AlertContent>
- * </AlertContainer>
- *
- * // Multiple content sections
- * <AlertContainer schema="warning">
+ * <AlertContainer scheme="warning">
+ *   <AlertIcon />
  *   <AlertContent>
- *     <AlertTitle>Warning</AlertTitle>
- *     <p>Please review the following items:</p>
- *     <ul>
- *       <li>Check your input data</li>
- *       <li>Verify permissions</li>
- *     </ul>
+ *     <AlertTitle>Session expiring</AlertTitle>
+ *     <AlertDescription>You will be logged out in 5 minutes.</AlertDescription>
  *   </AlertContent>
  * </AlertContainer>
  * ```
  */
-declare function AlertContent(props: AlertContentProps): import("react/jsx-runtime").JSX.Element;
+declare function AlertContent(props: AlertContentProps): JSX.Element;
 export { AlertContent };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertContent/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,iBAAiB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAK7C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/alert/alertContent/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,cAAc,CAAC;AAEtB,KAAK,iBAAiB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAK3D;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -1,49 +1,23 @@
-import { HTMLAttributes } from "react";
+import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
 type AlertDescriptionProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertDescription component - used to display additional descriptive text in alerts
+ * AlertDescription — body text for an alert. Place inside `AlertContent`.
  *
- * @param props - AlertDescription component properties
+ * Accepts all standard `<div>` HTML attributes.
  *
- * **...Other valid HTML properties for div**
- *
- * @returns AlertDescription JSX element
+ * @returns AlertDescription JSX element.
  *
  * @example
  * ```tsx
- * // Basic alert with description
- * <AlertContainer schema="info">
- *   <AlertContent>
- *     <AlertTitle>Information</AlertTitle>
- *     <AlertDescription>
- *       This is additional information to help you understand the context.
- *     </AlertDescription>
- *   </AlertContent>
- * </AlertContainer>
- *
- * // Success alert with description
- * <AlertContainer schema="success">
- *   <AlertContent>
- *     <AlertTitle>Upload Complete</AlertTitle>
- *     <AlertDescription>
- *       Your file has been successfully uploaded and processed.
- *     </AlertDescription>
- *   </AlertContent>
- * </AlertContainer>
- *
- * // Warning with detailed description
- * <AlertContainer schema="warning">
+ * <AlertContainer scheme="info">
  *   <AlertContent>
- *     <AlertTitle>Storage Limit</AlertTitle>
- *     <AlertDescription>
- *       You have used 90% of your storage quota. Consider upgrading your plan
- *       or removing unused files.
- *     </AlertDescription>
+ *     <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): import("react/jsx-runtime").JSX.Element;
+declare function AlertDescription(props: AlertDescriptionProps): JSX.Element;
 export { AlertDescription };
 //# sourceMappingURL=index.d.ts.map

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,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,qBAAqB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CAKrD;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,52 +1,30 @@
-import { LucideProps } from "lucide-react";
+import { type LucideProps } from "lucide-react";
+import type { JSX } from "react";
 import "./styles.css";
 type AlertIconProps = LucideProps;
 /**
- * AlertIcon component - automatically displays the appropriate icon based on the alert schema
+ * AlertIcon — renders a scheme-appropriate icon from `AlertContainer` context.
  *
- * @param props - AlertIcon component properties
+ * - `success` → `CheckCircle2`
+ * - `danger` → `XCircle`
+ * - `warning` → `AlertTriangle`
+ * - `info` → `Info`
  *
- * **...Other valid Lucide icon properties**
+ * Must be placed inside an `AlertContainer`. Accepts all Lucide icon props.
  *
- * @returns AlertIcon JSX element with schema-specific icon
- *
- * @description
- * This component automatically selects and renders the appropriate icon based on the
- * AlertContainer's schema context:
- * - success: CheckCircle2 icon
- * - danger: XCircle icon
- * - warning: AlertTriangle icon
- * - info: Info icon
+ * @returns The scheme-matched Lucide icon element.
  *
  * @example
  * ```tsx
- * // Basic usage - icon automatically matches container schema
- * <AlertContainer schema="success">
- *   <AlertIcon />
- *   <AlertContent>
- *     <AlertTitle>Success</AlertTitle>
- *     <AlertDescription>Operation completed successfully.</AlertDescription>
- *   </AlertContent>
- * </AlertContainer>
- *
- * // Warning alert with icon
- * <AlertContainer schema="warning">
+ * <AlertContainer scheme="danger">
  *   <AlertIcon />
  *   <AlertContent>
- *     Please review your input before proceeding.
- *   </AlertContent>
- * </AlertContainer>
- *
- * // Custom icon size
- * <AlertContainer schema="danger">
- *   <AlertIcon size={24} />
- *   <AlertContent>
- *     <AlertTitle>Error</AlertTitle>
- *     <AlertDescription>Something went wrong.</AlertDescription>
+ *     <AlertTitle>Payment failed</AlertTitle>
+ *     <AlertDescription>Please check your card details.</AlertDescription>
  *   </AlertContent>
  * </AlertContainer>
  * ```
  */
-declare function AlertIcon(props: AlertIconProps): import("react/jsx-runtime").JSX.Element;
+declare function AlertIcon(props: AlertIconProps): JSX.Element;
 export { AlertIcon };
 //# sourceMappingURL=index.d.ts.map

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;AAGtB,OAAO,cAAc,CAAC;AAEtB,KAAK,cAAc,GAAG,WAAW,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,iBAAS,SAAS,CAAC,KAAK,EAAE,cAAc,2CAgBvC;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,46 +1,25 @@
-import { HTMLAttributes } from "react";
+import type { HTMLAttributes, JSX } from "react";
 import "./styles.css";
 type AlertTitleProps = HTMLAttributes<HTMLDivElement>;
 /**
- * AlertTitle component - used to display the main title/heading of alerts
+ * AlertTitle — bold heading for an alert. Place inside `AlertContent`.
  *
- * @param props - AlertTitle component properties
+ * Its presence is detected by `AlertContainer` to switch the layout from centered to left-aligned.
+ * Accepts all standard `<div>` HTML attributes.
  *
- * **...Other valid HTML properties for div**
- *
- * @returns AlertTitle JSX element
- *
- * @description
- * This component affects the layout of the AlertContainer. When present, the container
- * content will be aligned differently compared to alerts without a title.
+ * @returns AlertTitle JSX element.
  *
  * @example
  * ```tsx
- * // Basic alert with title
- * <AlertContainer schema="info">
- *   <AlertTitle>Information</AlertTitle>
- *   <AlertDescription>This is important information.</AlertDescription>
- * </AlertContainer>
- *
- * // Success alert with title and icon
- * <AlertContainer schema="success">
- *   <AlertIcon />
- *   <AlertTitle>Success!</AlertTitle>
- *   <AlertDescription>Your operation was completed.</AlertDescription>
- * </AlertContainer>
- *
- * // Error alert with custom styling
- * <AlertContainer schema="danger">
+ * <AlertContainer scheme="danger">
  *   <AlertIcon />
- *   <AlertTitle className="custom-title">
- *     Critical Error
- *   </AlertTitle>
- *   <AlertDescription>
- *     Please contact support immediately.
- *   </AlertDescription>
+ *   <AlertContent>
+ *     <AlertTitle>Access denied</AlertTitle>
+ *     <AlertDescription>You don't have permission to view this page.</AlertDescription>
+ *   </AlertContent>
  * </AlertContainer>
  * ```
  */
-declare function AlertTitle(props: AlertTitleProps): import("react/jsx-runtime").JSX.Element;
+declare function AlertTitle(props: AlertTitleProps): JSX.Element;
 export { AlertTitle };
 //# sourceMappingURL=index.d.ts.map

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,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CAKzC;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,60 +1,51 @@
-import { AudioHTMLAttributes } from "react";
+import { type AudioHTMLAttributes, type JSX } from "react";
 import "./styles.css";
+/** 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;
 };
 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 - used to play audio files with playback controls
+ * AudioPlayer — play/pause controls, a scrubable progress bar, and elapsed/total time display.
  *
- * @param props - AudioPlayer component properties
- * @param props.src - Audio source URL (required)
- * @param props.disabled - Whether the audio player is disabled. Default: false
- * @param props.onPlayAudio - Callback function called when audio starts playing
- * @param props.onPauseAudio - Callback function called when audio is paused
+ * @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.
  *
- * **...Other valid HTML audio properties**
+ * **...Other valid HTML properties for `<audio>` (except `onEnded` and `src`)**
  *
- * @returns AudioPlayer JSX element
+ * @returns AudioPlayer JSX element.
  *
  * @example
  * ```tsx
- * // Basic audio player
- * <AudioPlayer src="/audio/sample.mp3" />
+ * // Basic
+ * <AudioPlayer src="/audio/episode.mp3" />
  *
- * // Audio player with callbacks
+ * // With play/pause callbacks
  * <AudioPlayer
- *   src="/audio/sample.mp3"
- *   onPlayAudio={(info) => console.log('Playing:', info)}
- *   onPauseAudio={(info) => console.log('Paused:', info)}
- * />
- *
- * // Disabled audio player
- * <AudioPlayer
- *   src="/audio/sample.mp3"
- *   disabled
- * />
- *
- * // Audio player with additional HTML audio attributes
- * <AudioPlayer
- *   src="/audio/sample.mp3"
- *   loop
- *   preload="metadata"
- *   onPlayAudio={(info) => {
- *     console.log(`Current: ${info.formattedCurrentTime}`);
- *     console.log(`Total: ${info.formattedTotalTime}`);
- *   }}
+ *   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): import("react/jsx-runtime").JSX.Element;
+declare function AudioPlayer(props: AudioPlayerProps): JSX.Element;
 export { AudioPlayer };
 //# sourceMappingURL=index.d.ts.map

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,EAA+B,MAAM,OAAO,CAAC;AAIzE,OAAO,cAAc,CAAC;AAEtB,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,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,iBAAS,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAoH3C;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"}