@arkyn/components 3.0.1-beta.143 → 3.0.1-beta.145

package/dist/components/fieldWrapper/index.js

@@ -1,36 +1,21 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import "./styles.css";
 /**
- * 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>
  * ```
  */

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

@@ -1,91 +1,66 @@
 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)}
  * />
  * ```
  */

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;IACrB,+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;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CAgGzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/components/fileUpload/index.js

@@ -8,77 +8,39 @@ import { HasFileContent } from "./hasFileContent";
 import { NoFileContent } from "./noFileContent";
 import "./styles.css";
 /**
- * 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)}
  * />
  * ```
  */

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

@@ -1,23 +1,27 @@
 import { JSX } from "react";
 type GoogleAnalyticsProps = {
+    /** Google Analytics 4 Measurement ID (e.g. `"G-XXXXXXXXXX"`). Required. */
     measurementId: string;
+    /** When true, renders the GA4 snippet in development mode (bypasses the production check). @default false */
     showInDevMode?: boolean;
 };
 /**
- * GoogleAnalytics component - injects Google Analytics 4 snippets into the page
+ * GoogleAnalytics — injects the Google Analytics 4 script into the page client-side.
  *
- * @param props - GoogleAnalytics component properties
- * @param {string} props.measurementId - Google Analytics 4 Measurement ID (for example: "G-XXXXXXXXXX")
- * @param {boolean} [props.showInDevMode] - If true, renders in development mode. Default: false
+ * Renders nothing in development mode unless `showInDevMode` is `true`.
+ * Wrapped in `ClientOnly` to avoid SSR errors.
  *
- * @returns {JSX.Element} GoogleAnalytics JSX element
+ * @param props.measurementId - GA4 Measurement ID (e.g. `"G-XXXXXXXXXX"`). Required.
+ * @param props.showInDevMode - Renders in development mode. Default: false
+ *
+ * @returns GoogleAnalytics JSX element, or an empty fragment in dev mode.
  *
  * @example
  * ```tsx
- * // Basic GA4 setup
+ * // In your root layout
  * <GoogleAnalytics measurementId="G-XXXXXXXXXX" />
  *
- * // GA4 in development mode
+ * // Enable in development for testing
  * <GoogleAnalytics measurementId="G-XXXXXXXXXX" showInDevMode />
  * ```
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/googleAnalytics/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAI5B,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AAEH,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,GAAG,CAAC,OAAO,CAYjE;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/googleAnalytics/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAI5B,KAAK,oBAAoB,GAAG;IAC1B,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,6GAA6G;IAC7G,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iBAAS,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,GAAG,CAAC,OAAO,CAYjE;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/googleAnalytics/index.js

@@ -2,20 +2,22 @@ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { ClientOnly } from "../clientOnly";
 import { GoogleAnalyticsClient } from "./googleAnalytics.client";
 /**
- * GoogleAnalytics component - injects Google Analytics 4 snippets into the page
+ * GoogleAnalytics — injects the Google Analytics 4 script into the page client-side.
  *
- * @param props - GoogleAnalytics component properties
- * @param {string} props.measurementId - Google Analytics 4 Measurement ID (for example: "G-XXXXXXXXXX")
- * @param {boolean} [props.showInDevMode] - If true, renders in development mode. Default: false
+ * Renders nothing in development mode unless `showInDevMode` is `true`.
+ * Wrapped in `ClientOnly` to avoid SSR errors.
  *
- * @returns {JSX.Element} GoogleAnalytics JSX element
+ * @param props.measurementId - GA4 Measurement ID (e.g. `"G-XXXXXXXXXX"`). Required.
+ * @param props.showInDevMode - Renders in development mode. Default: false
+ *
+ * @returns GoogleAnalytics JSX element, or an empty fragment in dev mode.
  *
  * @example
  * ```tsx
- * // Basic GA4 setup
+ * // In your root layout
  * <GoogleAnalytics measurementId="G-XXXXXXXXXX" />
  *
- * // GA4 in development mode
+ * // Enable in development for testing
  * <GoogleAnalytics measurementId="G-XXXXXXXXXX" showInDevMode />
  * ```
  */

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

@@ -1,46 +1,52 @@
 type GoogleTagManagerProps = {
+    /** Google Tag Manager container ID (e.g. `"GTM-XXXXXXX"`). Required. */
     gtmId: string;
+    /** Additional key-value pairs pushed to the dataLayer on initialization. */
     events?: Record<string, string>;
+    /** Initial key-value pairs added to the dataLayer before GTM loads. */
     dataLayer?: Record<string, string>;
+    /** Global variable name for the dataLayer array. @default "dataLayer" */
     dataLayerName?: string;
+    /** GTM environment auth token (for staging/testing environments). */
     auth?: string;
+    /** GTM environment preview token (e.g. `"env-3"`). */
     preview?: string;
+    /** When true, renders the GTM snippet in development mode (bypasses the production check). @default false */
     showInDevMode?: boolean;
 };
 /**
- * GoogleTagManager component - injects Google Tag Manager snippets into the page
+ * GoogleTagManager — injects the GTM `<script>` and `<noscript>` snippets into the page client-side.
  *
- * @param props - GoogleTagManager component properties
- * @param props.gtmId - Google Tag Manager container id (for example: "GTM-XXXXXXX")
- * @param props.events - Additional GTM events payload
- * @param props.dataLayer - Initial data to populate the dataLayer
+ * Renders nothing in development mode unless `showInDevMode` is `true`.
+ * Wrapped in `ClientOnly` to avoid SSR errors.
+ *
+ * @param props.gtmId - GTM container ID (e.g. `"GTM-XXXXXXX"`). Required.
+ * @param props.dataLayer - Initial key-value pairs for the dataLayer.
  * @param props.dataLayerName - Global dataLayer variable name. Default: "dataLayer"
- * @param props.auth - GTM environment auth token
- * @param props.preview - GTM environment preview token
- * @param props.showInDevMode - If true, renders in development mode. Default: false
+ * @param props.events - Additional key-value pairs pushed on initialization.
+ * @param props.auth - GTM environment auth token.
+ * @param props.preview - GTM environment preview token (e.g. `"env-3"`).
+ * @param props.showInDevMode - Renders in development mode. Default: false
  *
- * @returns GoogleTagManager JSX element
+ * @returns GoogleTagManager JSX element, or an empty fragment in dev mode.
  *
  * @example
  * ```tsx
- * // Basic GTM setup
+ * // Basic setup in your root layout
  * <GoogleTagManager gtmId="GTM-XXXXXXX" />
  *
- * // GTM with initial dataLayer values
+ * // With initial dataLayer values
  * <GoogleTagManager
- *  gtmId="GTM-XXXXXXX"
- *  dataLayer={{
- *    pageType: "home",
- *    userType: "anonymous",
- *  }}
+ *   gtmId="GTM-XXXXXXX"
+ *   dataLayer={{ pageType: "home", userType: "anonymous" }}
  * />
  *
- * // GTM environment (staging)
+ * // Staging/preview environment
  * <GoogleTagManager
- *  gtmId="GTM-XXXXXXX"
- *  auth="your-auth-token"
- *  preview="env-3"
- *  showInDevMode
+ *   gtmId="GTM-XXXXXXX"
+ *   auth="your-auth-token"
+ *   preview="env-3"
+ *   showInDevMode
  * />
  * ```
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/googleTagManager/index.tsx"],"names":[],"mappings":"AAGA,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CA6BrD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/googleTagManager/index.tsx"],"names":[],"mappings":"AAGA,KAAK,qBAAqB,GAAG;IAC3B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6GAA6G;IAC7G,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CA6BrD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/googleTagManager/index.js

@@ -2,39 +2,38 @@ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { ClientOnly } from "../clientOnly";
 import { GoogleTagManagerClient } from "./googleTagManager.client";
 /**
- * GoogleTagManager component - injects Google Tag Manager snippets into the page
+ * GoogleTagManager — injects the GTM `<script>` and `<noscript>` snippets into the page client-side.
  *
- * @param props - GoogleTagManager component properties
- * @param props.gtmId - Google Tag Manager container id (for example: "GTM-XXXXXXX")
- * @param props.events - Additional GTM events payload
- * @param props.dataLayer - Initial data to populate the dataLayer
+ * Renders nothing in development mode unless `showInDevMode` is `true`.
+ * Wrapped in `ClientOnly` to avoid SSR errors.
+ *
+ * @param props.gtmId - GTM container ID (e.g. `"GTM-XXXXXXX"`). Required.
+ * @param props.dataLayer - Initial key-value pairs for the dataLayer.
  * @param props.dataLayerName - Global dataLayer variable name. Default: "dataLayer"
- * @param props.auth - GTM environment auth token
- * @param props.preview - GTM environment preview token
- * @param props.showInDevMode - If true, renders in development mode. Default: false
+ * @param props.events - Additional key-value pairs pushed on initialization.
+ * @param props.auth - GTM environment auth token.
+ * @param props.preview - GTM environment preview token (e.g. `"env-3"`).
+ * @param props.showInDevMode - Renders in development mode. Default: false
  *
- * @returns GoogleTagManager JSX element
+ * @returns GoogleTagManager JSX element, or an empty fragment in dev mode.
  *
  * @example
  * ```tsx
- * // Basic GTM setup
+ * // Basic setup in your root layout
  * <GoogleTagManager gtmId="GTM-XXXXXXX" />
  *
- * // GTM with initial dataLayer values
+ * // With initial dataLayer values
  * <GoogleTagManager
- *  gtmId="GTM-XXXXXXX"
- *  dataLayer={{
- *    pageType: "home",
- *    userType: "anonymous",
- *  }}
+ *   gtmId="GTM-XXXXXXX"
+ *   dataLayer={{ pageType: "home", userType: "anonymous" }}
  * />
  *
- * // GTM environment (staging)
+ * // Staging/preview environment
  * <GoogleTagManager
- *  gtmId="GTM-XXXXXXX"
- *  auth="your-auth-token"
- *  preview="env-3"
- *  showInDevMode
+ *   gtmId="GTM-XXXXXXX"
+ *   auth="your-auth-token"
+ *   preview="env-3"
+ *   showInDevMode
  * />
  * ```
  */

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

@@ -2,40 +2,56 @@ import { LucideIcon } from "lucide-react";
 import { ButtonHTMLAttributes } from "react";
 import "./styles.css";
 type IconButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "aria-label"> & {
+    /** Lucide icon component rendered inside the button. Required. */
     icon: LucideIcon;
+    /** Accessible label for screen readers. Required. */
     "aria-label": string;
+    /** Shows a spinner and disables the button during async operations. @default false */
     isLoading?: boolean;
+    /**
+     * Button size.
+     * @default "md"
+     */
     size?: "xs" | "sm" | "md" | "lg";
+    /**
+     * Visual style variant.
+     * - `solid`: filled background.
+     * - `outline`: bordered, transparent background.
+     * - `ghost`: no border, subtle hover.
+     * - `invisible`: no visual styling.
+     * @default "solid"
+     */
     variant?: "solid" | "outline" | "ghost" | "invisible";
+    /**
+     * Color scheme applied to the button.
+     * @default "primary"
+     */
     scheme?: "primary" | "success" | "warning" | "danger" | "info";
 };
 /**
- * IconButton component - compact button that renders only an icon
+ * IconButton — compact button that renders a single icon without a text label.
  *
- * @param props - IconButton component properties
- * @param props.icon - Icon to render inside the button (LucideIcon). Required
- * @param props.aria-label - Accessible label for screen readers. Required
- * @param props.isLoading - Controls loading state with spinner. Default: false
- * @param props.size - Button size. Default: "md"
- * @param props.variant - Visual variant of the button. Default: "solid"
- * @param props.scheme - Button color scheme. Default: "primary"
+ * Always requires `aria-label` for accessibility.
  *
- * **...Other valid HTML properties for button element (children not supported)**
+ * @param props.icon - Lucide icon component to render. Required.
+ * @param props["aria-label"] - Accessible label for screen readers. Required.
+ * @param props.isLoading - Shows a spinner and disables the button. Default: false
+ * @param props.size - Button size (`xs` | `sm` | `md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.scheme - Color scheme. Default: "primary"
  *
- * @returns IconButton JSX element
+ * **...Other valid HTML properties for `<button>` (children not supported)**
+ *
+ * @returns IconButton JSX element.
  *
  * @example
  * ```tsx
- * // Basic icon button
- * <IconButton icon={Plus} aria-label="Add" />
+ * <IconButton icon={Plus} aria-label="Add item" />
  *
- * // Different color scheme and variant
  * <IconButton icon={Trash2} aria-label="Delete" scheme="danger" variant="outline" />
  *
- * // Loading state
  * <IconButton icon={Save} aria-label="Saving" isLoading />
  *
- * // Sizes
  * <IconButton icon={MoreVertical} aria-label="More options" size="sm" />
  * ```
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/iconButton/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,IAAI,CACzB,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,UAAU,GAAG,YAAY,CAC1B,GAAG;IACF,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACtD,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CA+BzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/iconButton/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,cAAc,CAAC;AAEtB,KAAK,eAAe,GAAG,IAAI,CACzB,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,UAAU,GAAG,YAAY,CAC1B,GAAG;IACF,kEAAkE;IAClE,IAAI,EAAE,UAAU,CAAC;IACjB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACtD;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,iBAAS,UAAU,CAAC,KAAK,EAAE,eAAe,2CA+BzC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/components/iconButton/index.js

@@ -2,32 +2,29 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Loader2 } from "lucide-react";
 import "./styles.css";
 /**
- * IconButton component - compact button that renders only an icon
+ * IconButton — compact button that renders a single icon without a text label.
  *
- * @param props - IconButton component properties
- * @param props.icon - Icon to render inside the button (LucideIcon). Required
- * @param props.aria-label - Accessible label for screen readers. Required
- * @param props.isLoading - Controls loading state with spinner. Default: false
- * @param props.size - Button size. Default: "md"
- * @param props.variant - Visual variant of the button. Default: "solid"
- * @param props.scheme - Button color scheme. Default: "primary"
+ * Always requires `aria-label` for accessibility.
  *
- * **...Other valid HTML properties for button element (children not supported)**
+ * @param props.icon - Lucide icon component to render. Required.
+ * @param props["aria-label"] - Accessible label for screen readers. Required.
+ * @param props.isLoading - Shows a spinner and disables the button. Default: false
+ * @param props.size - Button size (`xs` | `sm` | `md` | `lg`). Default: "md"
+ * @param props.variant - Visual style variant. Default: "solid"
+ * @param props.scheme - Color scheme. Default: "primary"
  *
- * @returns IconButton JSX element
+ * **...Other valid HTML properties for `<button>` (children not supported)**
+ *
+ * @returns IconButton JSX element.
  *
  * @example
  * ```tsx
- * // Basic icon button
- * <IconButton icon={Plus} aria-label="Add" />
+ * <IconButton icon={Plus} aria-label="Add item" />
  *
- * // Different color scheme and variant
  * <IconButton icon={Trash2} aria-label="Delete" scheme="danger" variant="outline" />
  *
- * // Loading state
  * <IconButton icon={Save} aria-label="Saving" isLoading />
  *
- * // Sizes
  * <IconButton icon={MoreVertical} aria-label="More options" size="sm" />
  * ```
  */