@arkyn/components 3.0.1-beta.95 → 3.0.2

package/dist/components/drawer/drawerContainer/index.d.ts

@@ -1,71 +1,37 @@
-import { HTMLAttributes } from "react";
+import { type HTMLAttributes } from "react";
 import "./styles.css";
 type DrawerContainerProps = HTMLAttributes<HTMLElement> & {
+    /** Controls whether the drawer is visible. */
     isVisible: boolean;
+    /** Callback invoked when the overlay is clicked to close the drawer. */
     makeInvisible: () => void;
+    /** Side from which the drawer slides in. @default "left" */
     orientation?: "left" | "right";
 };
-/**O
- * DrawerContainer component - animated slide-out panel for navigation or content
+/**
+ * DrawerContainer — animated slide-in panel rendered over an overlay backdrop.
  *
- * @param props - DrawerContainer component properties
- * @param props.isVisible - Controls drawer visibility state
- * @param props.makeInvisible - Callback function to hide the drawer
- * @param props.orientation - Side from which drawer slides (left, right). Default: "left"
+ * Locks body scroll while open. Closes when the overlay is clicked.
+ * Provides context consumed by `DrawerHeader` (close button).
  *
- * **...Other valid HTML properties for aside element**
+ * @param props.isVisible - Whether the drawer is open. Required.
+ * @param props.makeInvisible - Called when the overlay or close button is clicked. Required.
+ * @param props.orientation - Slide direction. Default: `"left"`
  *
- * @returns DrawerContainer JSX element
+ * **...Other valid HTML `<aside>` properties**
+ *
+ * @returns DrawerContainer JSX element.
  *
  * @example
  * ```tsx
- * // Basic drawer from left
  * const [isOpen, setIsOpen] = useState(false);
- * <DrawerContainer
- *   isVisible={isOpen}
- *   makeInvisible={setIsOpen}
- * >
- *   <p>Drawer content</p>
- * </DrawerContainer>
  *
- * // Right-side drawer
- * <DrawerContainer
- *   isVisible={isOpen}
- *   makeInvisible={setIsOpen}
- *   orientation="right"
- * >
- *   <nav>Navigation items</nav>
+ * <DrawerContainer isVisible={isOpen} makeInvisible={() => setIsOpen(false)} orientation="right">
+ *   <DrawerHeader><h2>Navigation</h2></DrawerHeader>
+ *   <nav>...</nav>
  * </DrawerContainer>
- *
- * // Complete drawer example
- * function DrawerExample() {
- *   const [isDrawerOpen, setIsDrawerOpen] = useState(false);
- *
- *   return (
- *     <>
- *       <button onClick={() => setIsDrawerOpen(true)}>
- *         Open Menu
- *       </button>
- *
- *       <DrawerContainer
- *         isVisible={isDrawerOpen}
- *         makeInvisible={setIsDrawerOpen}
- *         orientation="right"
- *       >
- *         <div className="drawer-content">
- *           <h2>Menu</h2>
- *           <ul>
- *             <li>Home</li>
- *             <li>About</li>
- *             <li>Contact</li>
- *           </ul>
- *         </div>
- *       </DrawerContainer>
- *     </>
- *   );
- * }
  * ```
  */
-declare function DrawerContainer(props: DrawerContainerProps): import("react/jsx-runtime").JSX.Element;
+declare function DrawerContainer(props: DrawerContainerProps): import("react").JSX.Element | null;
 export { DrawerContainer };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/drawer/drawerContainer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/drawerContainer/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,cAAc,CAAC;AAEtB,KAAK,oBAAoB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CA6CnD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/drawerContainer/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,cAAc,EAGnB,MAAM,OAAO,CAAC;AAIf,OAAO,cAAc,CAAC;AAEtB,KAAK,oBAAoB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACzD,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,sCAuDnD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/drawer/drawerContext.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from "react";
+import { type ReactNode } from "react";
 type DrawerContextProps = {
     makeInvisible: () => void;
 };
@@ -6,7 +6,7 @@ type DrawerProviderProps = {
     children: ReactNode;
     makeInvisible: () => void;
 };
-declare function DrawerProvider(props: DrawerProviderProps): import("react/jsx-runtime").JSX.Element;
+declare function DrawerProvider(props: DrawerProviderProps): import("react").JSX.Element;
 declare function useDrawer(): DrawerContextProps;
 export { DrawerProvider, useDrawer };
 //# sourceMappingURL=drawerContext.d.ts.map

package/dist/components/drawer/drawerContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drawerContext.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/drawerContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,SAAS,EAAc,MAAM,OAAO,CAAC;AAE7D,KAAK,kBAAkB,GAAG;IACxB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAIF,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,2CAMjD;AAED,iBAAS,SAAS,uBAEjB;AAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"drawerContext.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/drawerContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAE3E,KAAK,kBAAkB,GAAG;IACzB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAIF,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,+BAWjD;AAED,iBAAS,SAAS,uBAEjB;AAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC"}

package/dist/components/drawer/drawerHeader/index.d.ts

@@ -1,55 +1,31 @@
-import { HTMLAttributes } from "react";
+import type { HTMLAttributes } from "react";
 import "./styles.css";
 type DrawerHeaderProps = HTMLAttributes<HTMLElement> & {
+    /** Whether to render the X close button. @default true */
     showCloseButton?: boolean;
 };
 /**
- * DrawerHeader component - header section for drawer with optional close button
+ * DrawerHeader — header section for a `DrawerContainer`, with an optional close button.
  *
- * @param props - DrawerHeader component properties
- * @param props.showCloseButton - Shows close button in header. Default: true
+ * The close button calls `makeInvisible` from the nearest `DrawerContainer` context.
+ * Must be rendered inside a `DrawerContainer`.
  *
- * **...Other valid HTML properties for header element**
+ * @param props.showCloseButton - Renders the X close button. Default: true
  *
- * @returns DrawerHeader JSX element
+ * **...Other valid HTML `<header>` properties**
+ *
+ * @returns DrawerHeader JSX element.
  *
  * @example
  * ```tsx
- * // Basic drawer header with close button
- * <DrawerHeader>
- *   <h2>Menu</h2>
- * </DrawerHeader>
- *
- * // Header without close button
- * <DrawerHeader showCloseButton={false}>
- *   <h2>Settings</h2>
- * </DrawerHeader>
- *
- * // Complete drawer example
  * <DrawerContainer isVisible={isOpen} makeInvisible={() => setIsOpen(false)}>
  *   <DrawerHeader>
  *     <h2>Navigation</h2>
- *     <p>Welcome to our app</p>
  *   </DrawerHeader>
- *
- *   <div className="drawer-content">
- *     <nav>
- *       <a href="/home">Home</a>
- *       <a href="/about">About</a>
- *       <a href="/contact">Contact</a>
- *     </nav>
- *   </div>
+ *   <nav>...</nav>
  * </DrawerContainer>
- *
- * // Custom styled header
- * <DrawerHeader className="custom-header">
- *   <div className="header-content">
- *     <img src="/logo.png" alt="Logo" />
- *     <h1>My App</h1>
- *   </div>
- * </DrawerHeader>
  * ```
  */
-declare function DrawerHeader(props: DrawerHeaderProps): import("react/jsx-runtime").JSX.Element;
+declare function DrawerHeader(props: DrawerHeaderProps): import("react").JSX.Element;
 export { DrawerHeader };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/drawer/drawerHeader/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/drawerHeader/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,cAAc,CAAC;AAEtB,KAAK,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CA2B7C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/drawer/drawerHeader/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,cAAc,CAAC;AAEtB,KAAK,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACtD,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BA2B7C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/components/facebookPixel/facebookPixel.client.d.ts

@@ -0,0 +1,4 @@
+import type { FacebookPixelProps } from ".";
+declare function FacebookPixelClient(props: FacebookPixelProps): null;
+export { FacebookPixelClient };
+//# sourceMappingURL=facebookPixel.client.d.ts.map

package/dist/components/facebookPixel/facebookPixel.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facebookPixel.client.d.ts","sourceRoot":"","sources":["../../../src/components/facebookPixel/facebookPixel.client.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,GAAG,CAAC;AAG5C,iBAAS,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,QA2BrD;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

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

@@ -0,0 +1,65 @@
+type FacebookPixelProps = {
+    /** Facebook Pixel ID from your Ads Manager account. Required. */
+    pixelId: string;
+    /** When true, renders the pixel in development mode (bypasses the production check). @default false */
+    showInDevMode?: boolean;
+    /** Pixel initialization options. */
+    options?: {
+        /** Enables automatic configuration. @default true */
+        autoConfig?: boolean;
+        /** Enables debug logging in the browser console. @default false */
+        debug?: boolean;
+    };
+    /** When true, fires a standard `PageView` event on mount. */
+    pageView?: boolean;
+    /** When true, grants cookie/tracking consent via `fbq("consent", "grant")`. */
+    grantConsent?: boolean;
+    /** When true, revokes cookie/tracking consent via `fbq("consent", "revoke")`. */
+    revokeConsent?: boolean;
+    /** Standard event to track: `[eventName, eventData?]`. */
+    track?: [string, any?];
+    /** Custom event to track: `[eventName, eventData?]`. */
+    trackCustom?: [string, any?];
+    /** Single-pixel standard event: `[eventName, eventData?]`. */
+    trackSingle?: [string, any?];
+    /** Single-pixel custom event: `[eventName, eventData?]`. */
+    trackSingleCustom?: [string, any?];
+};
+/**
+ * FacebookPixel — injects the Facebook Pixel tracking script client-side.
+ *
+ * Renders nothing in development mode unless `showInDevMode` is `true`.
+ * Wrapped in `ClientOnly` to avoid SSR errors.
+ *
+ * @param props.pixelId - Facebook Pixel ID. Required.
+ * @param props.showInDevMode - Renders in development mode. Default: false
+ * @param props.pageView - Fires a `PageView` event on mount.
+ * @param props.grantConsent - Grants tracking consent.
+ * @param props.revokeConsent - Revokes tracking consent.
+ * @param props.track - Standard event to fire: `[eventName, params?]`.
+ * @param props.trackCustom - Custom event to fire: `[eventName, params?]`.
+ *
+ * @returns Empty fragment in dev mode; otherwise the pixel script component.
+ *
+ * @example
+ * ```tsx
+ * // Basic page view tracking in root layout
+ * <FacebookPixel pixelId="123456789012345" pageView />
+ *
+ * // With LGPD consent handling
+ * <FacebookPixel
+ *   pixelId="123456789012345"
+ *   pageView
+ *   grantConsent={userAcceptedCookies}
+ * />
+ *
+ * // Track a purchase event
+ * <FacebookPixel
+ *   pixelId="123456789012345"
+ *   track={["Purchase", { value: 99.90, currency: "BRL" }]}
+ * />
+ * ```
+ */
+declare function FacebookPixel(props: FacebookPixelProps): import("react").JSX.Element | null;
+export { FacebookPixel, type FacebookPixelProps };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/facebookPixel/index.tsx"],"names":[],"mappings":"AAGA,KAAK,kBAAkB,GAAG;IACzB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE;QACT,qDAAqD;QACrD,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,mEAAmE;QACnE,KAAK,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAE1D,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACvB,wDAAwD;IAExD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7B,8DAA8D;IAE9D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7B,4DAA4D;IAE5D,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,sCAM/C;AAED,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,CAAC"}

package/dist/components/facebookPixel/pixel.d.ts

@@ -0,0 +1,21 @@
+type Options = {
+    autoConfig?: boolean;
+    debug?: boolean;
+};
+declare class FacebookPixel {
+    pixelId: string;
+    autoConfig: boolean;
+    initialized: boolean;
+    constructor(pixelId: string, options?: Options);
+    private loadFacebookPixel;
+    init(advancedMatching?: object): void;
+    pageView(): void;
+    track(title: string, data?: object): void;
+    trackSingle(pixel: string, title: string, data?: object): void;
+    trackCustom(event: string, data?: object): void;
+    trackSingleCustom(pixel: string, event: string, data?: object): void;
+    grantConsent(): void;
+    revokeConsent(): void;
+}
+export { FacebookPixel };
+//# sourceMappingURL=pixel.d.ts.map

package/dist/components/facebookPixel/pixel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel.d.ts","sourceRoot":"","sources":["../../../src/components/facebookPixel/pixel.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,cAAM,aAAa;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;gBAET,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAM9C,OAAO,CAAC,iBAAiB;IAuCzB,IAAI,CAAC,gBAAgB,GAAE,MAAW;IAuBlC,QAAQ;IAOR,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAOlC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAOvD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAOxC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAO7D,YAAY;IAOZ,aAAa;CAMb;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

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

@@ -1,29 +1,22 @@
-import { HTMLAttributes } from "react";
+import type { HTMLAttributes } from "react";
 import "./styles.css";
 type FieldErrorProps = HTMLAttributes<HTMLElement>;
 /**
- * FieldError component - used to display error messages for form fields
+ * FieldError — displays a validation error message below a form field.
  *
- * @param props - FieldError component properties
+ * Renders nothing when `children` is empty or falsy.
  *
- * **...Other valid HTML properties for strong element**
+ * **...Other valid HTML properties for `<strong>`**
  *
- * @returns FieldError JSX element or empty fragment if no children
+ * @returns FieldError `<strong>` element, or an empty fragment when there is no message.
  *
  * @example
  * ```tsx
- * // Basic field error
  * <FieldError>This field is required</FieldError>
  *
- * // Field error with custom styling
- * <FieldError className="custom-error">
- *  Invalid email format
- * </FieldError>
- *
- * // Conditional field error
  * {error && <FieldError>{error}</FieldError>}
  * ```
  */
-declare function FieldError(props: FieldErrorProps): import("react/jsx-runtime").JSX.Element;
+declare function FieldError(props: FieldErrorProps): import("react").JSX.Element | null;
 export { FieldError };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fieldError/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CAWzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fieldError/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,sCAWzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,38 +1,23 @@
-import { LabelHTMLAttributes } from "react";
+import type { LabelHTMLAttributes } from "react";
 import "./styles.css";
 type FieldLabelProps = LabelHTMLAttributes<HTMLLabelElement> & {
+    /** When true, appends an asterisk (*) to signal a required field. @default false */
     showAsterisk?: boolean;
 };
 /**
- * FieldLabel component - used to display labels for form fields with optional required indicator
+ * FieldLabel — label for form fields, with an optional required-field asterisk.
  *
- * @param props - FieldLabel component properties
- * @param props.showAsterisk - Whether to display an asterisk (*) to indicate required field. Default: false
+ * @param props.showAsterisk - Appends `*` to the label. Default: false
  *
- * **...Other valid HTML properties for label element**
+ * **...Other valid HTML properties for `<label>`**
  *
- * @returns FieldLabel JSX element
+ * @returns FieldLabel JSX element.
  *
  * @example
  * ```tsx
- * // Basic field label
- * <FieldLabel htmlFor="username">Username</FieldLabel>
- *
- * // Required field label with asterisk
- * <FieldLabel htmlFor="email" showAsterisk>
- *   Email Address
- * </FieldLabel>
- *
- * // Label with custom styling
- * <FieldLabel
- *   htmlFor="password"
- *   className="custom-label"
- *   showAsterisk
- * >
- *   Password
- * </FieldLabel>
+ * <FieldLabel htmlFor="email" showAsterisk>Email Address</FieldLabel>
  * ```
  */
-declare function FieldLabel(props: FieldLabelProps): import("react/jsx-runtime").JSX.Element;
+declare function FieldLabel(props: FieldLabelProps): import("react").JSX.Element;
 export { FieldLabel };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fieldLabel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CAWzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fieldLabel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;IAC9D,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,+BAYzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,43 +1,33 @@
-import { HTMLAttributes, ReactNode } from "react";
+import type { HTMLAttributes, ReactNode } from "react";
 import "./styles.css";
 type FieldWrapperProps = HTMLAttributes<HTMLElement> & {
+    /** Field elements to render inside the wrapper (label, input, error, etc.). Required. */
     children: ReactNode;
+    /**
+     * Layout orientation of the wrapper.
+     * @default "vertical"
+     */
     orientation?: "vertical" | "horizontal" | "horizontalReverse";
 };
 /**
- * FieldWrapper component - used as a container wrapper for a single form field and its related elements
+ * FieldWrapper — `<section>` container that groups a form field with its label and error message.
  *
- * @param props - FieldWrapper component properties
- * @param props.children - React elements that compose a single field (label, input, error message, etc.)
- * @param props.orientation - Orientation of the field wrapper. Default: "vertical"
+ * @param props.children - Field elements (label, input, error, etc.).
+ * @param props.orientation - Layout direction. Default: "vertical"
  *
- * **...Other valid HTML properties for section element**
+ * **...Other valid HTML properties for `<section>`**
  *
- * @returns FieldWrapper JSX element
+ * @returns FieldWrapper JSX element.
  *
  * @example
  * ```tsx
- * // Basic field container
  * <FieldWrapper>
- *   <FieldLabel>Username</FieldLabel>
- *   <Input name="username" />
- *   <FieldError>This field is required</FieldError>
- * </FieldWrapper>
- *
- * // Field container with custom styling
- * <FieldWrapper className="custom-spacing">
- *   <FieldLabel>Email</FieldLabel>
+ *   <FieldLabel showAsterisk>Email</FieldLabel>
  *   <Input name="email" type="email" />
- * </FieldWrapper>
- *
- * // Complete field with all elements
- * <FieldWrapper>
- *   <FieldLabel showAsterisk>Password</FieldLabel>
- *   <Input name="password" type="password" />
- *   <FieldError>Password must be at least 8 characters</FieldError>
+ *   <FieldError>Invalid email address</FieldError>
  * </FieldWrapper>
  * ```
  */
-declare function FieldWrapper(props: FieldWrapperProps): import("react/jsx-runtime").JSX.Element;
+declare function FieldWrapper(props: FieldWrapperProps): import("react").JSX.Element;
 export { FieldWrapper };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fieldWrapper/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,cAAc,CAAC;AAEtB,KAAK,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACrD,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,mBAAmB,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAe7C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fieldWrapper/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,cAAc,CAAC;AAEtB,KAAK,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACtD,yFAAyF;IACzF,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,mBAAmB,CAAC;CAC9D,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iBAAS,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BAe7C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -8,6 +8,6 @@ type HasFileContentProps = {
     reSendFile?: () => void;
     handleSelectFile: (file: File) => void;
 };
-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/fileUpload/hasFileContent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/fileUpload/hasFileContent/index.tsx"],"names":[],"mappings":"AAaA,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,2CAyEjD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/fileUpload/hasFileContent/index.tsx"],"names":[],"mappings":"AAaA,OAAO,cAAc,CAAC;AAEtB,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,iBAAS,cAAc,CAAC,KAAK,EAAE,mBAAmB,+BAyEjD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

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

@@ -1,94 +1,69 @@
 import "./styles.css";
 type FileUploadProps = {
+    /** Field name for form submission (stores the uploaded file URL). Required. */
     name: string;
+    /** Server endpoint URL that receives the `multipart/form-data` upload request. Required. */
     action: string;
+    /** Disables file selection and upload. @default false */
     disabled?: boolean;
+    /** 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;
+    /** Label for the file-picker button after a file is selected. @default "Alterar arquivo" */
     changeFileButtonText?: string;
+    /** Label for the file-picker button before a file is selected. @default "Selecionar arquivo" */
     selectFileButtonText?: string;
+    /** Text displayed in the drag-and-drop zone. @default "Ou arraste e solte o arquivo aqui" */
     dropFileText?: string;
+    /** HTTP method for the upload request. @default "POST" */
     method?: string;
+    /** Form-data field name used for the file. @default "file" */
     fileName?: string;
+    /** Property name in the server response that contains the file URL. @default "url" */
     fileResponseName?: string;
+    /** Accepted file MIME types or extensions (e.g. `".pdf"`, `"image/*"`). @default "*" */
     acceptFile?: string;
+    /** Callback fired after a successful upload. Receives the URL returned by the server. */
     onChange?: (url?: string) => void;
 };
 /**
- * FileUpload component - used for uploading files with drag and drop functionality
+ * FileUpload — drag-and-drop file uploader with server upload and file-name preview.
  *
- * @param props - FileUpload component properties
- * @param props.name - Required field name for form handling
- * @param props.action - Required endpoint URL where the file will be uploaded
- * @param props.disabled - Whether the file upload is disabled. Default: false
- * @param props.label - Optional label text to display above the file upload area
- * @param props.showAsterisk - Whether to show asterisk on label for required fields. Default: false
- * @param props.changeFileButtonText - Text for the button to change/replace an uploaded file. Default: "Alterar arquivo"
- * @param props.selectFileButtonText - Text for the button to select a file. Default: "Selecionar arquivo"
- * @param props.dropFileText - Text displayed in the drop zone area. Default: "Ou arraste e solte o arquivo aqui"
- * @param props.method - HTTP method for the upload request. Default: "POST"
- * @param props.fileName - Form data field name for the file. Default: "file"
- * @param props.fileResponseName - Property name in the response object containing the file URL. Default: "url"
- * @param props.acceptFile - File types accepted by the input (e.g., "image/*", ".pdf"). Default: "*"
- * @param props.onChange - Callback function called when file upload completes successfully, receives the file URL
+ * 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 FileUpload JSX element wrapped in FieldGroup with optional label and error handling
+ * @param props.name - Field name for form submission. Required.
+ * @param props.action - Upload endpoint URL. Required.
+ * @param props.disabled - Disables file selection and upload. Default: false
+ * @param props.label - Label text displayed above the upload area.
+ * @param props.showAsterisk - Appends `*` to the label. Default: false
+ * @param props.acceptFile - Accepted MIME types or extensions. Default: "*"
+ * @param props.method - HTTP method. Default: "POST"
+ * @param props.fileName - Form-data field name for the file. Default: "file"
+ * @param props.fileResponseName - Server response property containing the URL. Default: "url"
+ * @param props.onChange - Callback fired after a successful upload — receives the file URL.
+ *
+ * @returns FileUpload JSX element wrapped in `FieldWrapper`.
  *
  * @example
  * ```tsx
- * // Basic file upload
- * <FileUpload
- *   name="document"
- *   action="/api/upload"
- * />
+ * // Basic
+ * <FileUpload name="document" action="/api/upload" />
  *
- * // File upload with label and custom text
+ * // PDF only with label and callback
  * <FileUpload
- *   name="avatar"
- *   action="/api/upload/avatar"
- *   label="Profile Picture"
+ *   name="contract"
+ *   action="/api/upload/docs"
+ *   label="Contract (PDF)"
  *   showAsterisk
- *   selectFileButtonText="Choose Image"
- *   changeFileButtonText="Change Image"
- *   dropFileText="Drop your image here"
- * />
- *
- * // File upload with restrictions and callback
- * <FileUpload
- *   name="pdf"
- *   action="/api/upload/document"
- *   label="Upload PDF Document"
  *   acceptFile=".pdf"
- *   fileName="document"
  *   fileResponseName="documentUrl"
- *   onChange={(url) => console.log('File uploaded:', url)}
- * />
- *
- * // Disabled file upload
- * <FileUpload
- *   name="attachment"
- *   action="/api/upload"
- *   label="Attachment"
- *   disabled
- * />
- *
- * // File upload with custom HTTP method and response handling
- * <FileUpload
- *   name="file"
- *   action="/api/files"
- *   method="PUT"
- *   fileName="uploadedFile"
- *   fileResponseName="fileUrl"
- *   label="Custom Upload"
- *   onChange={(url) => {
- *     if (url) {
- *       setFileUrl(url);
- *       console.log('Upload successful:', url);
- *     }
- *   }}
+ *   onChange={(url) => setContractUrl(url)}
  * />
  * ```
  */
-declare function FileUpload(props: FileUploadProps): import("react/jsx-runtime").JSX.Element;
+declare function FileUpload(props: FileUploadProps): import("react").JSX.Element;
 export { FileUpload };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fileUpload/index.tsx"],"names":[],"mappings":"AASA,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CAgGzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/fileUpload/index.tsx"],"names":[],"mappings":"AASA,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG;IACtB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,+BAgGzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -7,6 +7,6 @@ type NoFileContentProps = {
     dropFileText: 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/fileUpload/noFileContent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/fileUpload/noFileContent/index.tsx"],"names":[],"mappings":"AAIA,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,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/fileUpload/noFileContent/index.tsx"],"names":[],"mappings":"AAGA,OAAO,cAAc,CAAC;AAEtB,KAAK,kBAAkB,GAAG;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,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"}