@apollion-dsi/core 3.0.0

package/lib/form/index.d.ts

@@ -0,0 +1,13 @@
+export * from './Checkbox';
+export * from './Field';
+export * from './FieldGroup';
+export * from './Form';
+export * from './Input';
+export * from './InputMask';
+export * from './InputDate';
+export * from './InputRange';
+export * from './InputSelect';
+export * from './InputCurrency';
+export * from './Radio';
+export * from './TextArea';
+export * from './UploadCard';

package/lib/form/index.esm.js

@@ -0,0 +1 @@
+import"../chunks/chunk-L4PVKG62.esm.js";import{a as Q,b as R,c as S}from"../chunks/chunk-D43MLNCQ.esm.js";import{a as T,b as U,c as V,d as W,e as X,f as Y,g as Z,h as _,i as $,j as aa,k as ba,l as ca}from"../chunks/chunk-NGODVNJB.esm.js";import{a as j}from"../chunks/chunk-TR4PVAXI.esm.js";import{a as f,b as g,c as h,d as i}from"../chunks/chunk-XNCMA56H.esm.js";import{a as k,b as l,c as m,d as n,e as o,f as p,g as q}from"../chunks/chunk-LXG3BZB5.esm.js";import{a as M,b as N,c as O,d as P}from"../chunks/chunk-4PCG2KFF.esm.js";import{a as z}from"../chunks/chunk-KEQXETSP.esm.js";import{a as y}from"../chunks/chunk-CH7BVIBG.esm.js";import{a as A,b as B,c as C,d as D,e as E,f as F,g as G,h as H,i as I,j as J}from"../chunks/chunk-6H6SEPAI.esm.js";import{a as e}from"../chunks/chunk-XW52MLHU.esm.js";import{a as r,b as s,c as t,d as u,e as v,f as w,g as x}from"../chunks/chunk-L6UB7RUM.esm.js";import{a as K,b as L}from"../chunks/chunk-2B3RKGV2.esm.js";import{a,b,c,d}from"../chunks/chunk-DAFBKFTS.esm.js";import"../chunks/chunk-GXCDUA3V.esm.js";import"../chunks/chunk-EWFUWYNO.esm.js";import"../chunks/chunk-BKF5RIHP.esm.js";import"../chunks/chunk-7PD7R2RB.esm.js";import"../chunks/chunk-CSVGEHXH.esm.js";import"../chunks/chunk-OMBZMCKV.esm.js";import"../chunks/chunk-7VYSPE3B.esm.js";import"../chunks/chunk-JIDBKHKA.esm.js";import"../chunks/chunk-LKD55J4V.esm.js";import"../chunks/chunk-HK3DHNXU.esm.js";import"../chunks/chunk-SKV75I6W.esm.js";import"../chunks/chunk-DEAAQK5J.esm.js";import"../chunks/chunk-LZTZMWTK.esm.js";import"../chunks/chunk-G3IXCOJI.esm.js";import"../chunks/chunk-Q3FXXXUX.esm.js";import"../chunks/chunk-Z5OQHLDW.esm.js";import"../chunks/chunk-SHDMTEPB.esm.js";import"../chunks/chunk-DP6AXK72.esm.js";import"../chunks/chunk-NQBO2D7L.esm.js";import"../chunks/chunk-3DUB5C4Z.esm.js";import"../chunks/chunk-KT6QQ3UJ.esm.js";import"../chunks/chunk-FPQPDMPB.esm.js";import"../chunks/chunk-WZALORLW.esm.js";import"../chunks/chunk-KDYOOGW7.esm.js";import"../chunks/chunk-6KYLIXBS.esm.js";import"../chunks/chunk-FVRWVTQD.esm.js";import"../chunks/chunk-5XXISYUW.esm.js";import"../chunks/chunk-2ROOI4B2.esm.js";import"../chunks/chunk-KQQ7V7VG.esm.js";import"../chunks/chunk-3V3ZEGHO.esm.js";import"../chunks/chunk-A3OJEVGQ.esm.js";import"../chunks/chunk-KFFUMDHD.esm.js";import"../chunks/chunk-2FQC32AA.esm.js";import"../chunks/chunk-V77X6UJ2.esm.js";import"../chunks/chunk-GWCDFVWM.esm.js";import"../chunks/chunk-SPHHNZVP.esm.js";import"../chunks/chunk-I2E5B4NH.esm.js";import"../chunks/chunk-3QSPHURU.esm.js";import"../chunks/chunk-EKTJ3A6R.esm.js";import"../chunks/chunk-KR2X2UQG.esm.js";import"../chunks/chunk-BE2JDTVA.esm.js";import"../chunks/chunk-XNBK5E7D.esm.js";import"../chunks/chunk-3HHYBI4E.esm.js";import"../chunks/chunk-3XS7RVYS.esm.js";import"../chunks/chunk-QZYXRYI7.esm.js";import"../chunks/chunk-JTQYUIZP.esm.js";import"../chunks/chunk-VTRVGJA6.esm.js";import"../chunks/chunk-TAVNLEMI.esm.js";import"../chunks/chunk-WTWPQ4EL.esm.js";import"../chunks/chunk-5OKRFXLL.esm.js";import"../chunks/chunk-ELYUJKST.esm.js";import"../chunks/chunk-TGTH3E4X.esm.js";import"../chunks/chunk-752Z7BQF.esm.js";import"../chunks/chunk-BNB3KNKE.esm.js";import"../chunks/chunk-W663AGNE.esm.js";import"../chunks/chunk-A6Z2M2XU.esm.js";import"../chunks/chunk-U27SLYIV.esm.js";import"../chunks/chunk-JB7G6UGV.esm.js";import"../chunks/chunk-GP7NECT4.esm.js";import"../chunks/chunk-WAHR5LIT.esm.js";import"../chunks/chunk-QUHHEZMP.esm.js";import"../chunks/chunk-44EW3LMK.esm.js";import"../chunks/chunk-OEH5ARPF.esm.js";import"../chunks/chunk-V5AWVNU6.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{d as Checkbox,c as CheckboxContainerStyle,a as CheckboxInputStyle,b as CheckboxStyle,$ as CompactContainer,aa as CompactFileItemContainer,e as Field,j as FieldGroup,W as FileItemContainer,Y as FileItemName,_ as FileItemPreviewContainer,Z as FileItemProgress,q as Form,k as FormFlexStyle,l as FormGridStyle,x as Input,P as InputCurrency,z as InputDate,y as InputMask,J as InputRange,L as InputSelect,v as InputStyle,V as Overlay,U as OverlayContainer,i as Radio,h as RadioContainerStyle,f as RadioInputStyle,g as RadioStyle,A as SliderContainer,E as SliderGradient,F as SliderLabel,H as SliderMark,I as SliderMarkLabel,B as SliderRail,G as SliderThumb,C as SliderTrack,D as SliderTrackGradient,S as TextArea,R as TextAreaCounterStyle,Q as TextAreaStyle,ba as UploadCard,T as UploadCardContainer,X as UploadCardFiles,w as WrapperInputStyle,K as createComponentStyle,N as currencyToNumber,M as formatCurrency,O as getInitialCurrencyValue,o as getValidationSchema,t as inputDisabledStyle,s as inputPlaceholderStyle,r as inputVariantStyle,u as invertIconPosition,p as newField,m as normalizeValues,n as prepareSubmit,ca as useFileControl};

package/lib/hooks/index.d.ts

@@ -0,0 +1,12 @@
+export * from './useClickOutside';
+export * from './useClipboard';
+export * from './useDrag';
+export * from './useEventCallback';
+export * from './useFileDialog';
+export * from './useIntersect';
+export * from './useLazyEffect';
+export * from './useMediaQuery';
+export * from './useProgress';
+export * from './useScript';
+export * from './useToggle';
+export * from './useUnload';

package/lib/hooks/index.esm.js

@@ -0,0 +1 @@
+import"../chunks/chunk-2ROOI4B2.esm.js";import{a as r}from"../chunks/chunk-KQQ7V7VG.esm.js";import{a as g,b as h}from"../chunks/chunk-3V3ZEGHO.esm.js";import{a as i}from"../chunks/chunk-A3OJEVGQ.esm.js";import{a}from"../chunks/chunk-KFFUMDHD.esm.js";import{a as j}from"../chunks/chunk-2FQC32AA.esm.js";import{a as k,b as l,c as m,d as n,e as o}from"../chunks/chunk-V77X6UJ2.esm.js";import"../chunks/chunk-GWCDFVWM.esm.js";import{a as p}from"../chunks/chunk-SPHHNZVP.esm.js";import{a as q}from"../chunks/chunk-I2E5B4NH.esm.js";import{a as b}from"../chunks/chunk-3QSPHURU.esm.js";import{a as d}from"../chunks/chunk-EKTJ3A6R.esm.js";import{a as e,b as f}from"../chunks/chunk-KR2X2UQG.esm.js";import{a as c}from"../chunks/chunk-BE2JDTVA.esm.js";import"../chunks/chunk-V5AWVNU6.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{e as acceptableFile,n as checkIsLaptop,l as checkIsMobile,m as checkIsTablet,k as getBoundaries,b as useClickOutside,d as useClipboard,f as useDrag,h as useEventCallback,i as useFileDialog,a as useIntersect,g as useIsomorphicEffect,j as useLazyEffect,o as useMediaQuery,p as useProgress,q as useScript,c as useToggle,r as useUnload};

package/lib/hooks/useClickOutside/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useClickOutside`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useClickOutside`.
+ */
+export * from './useClickOutside';

package/lib/hooks/useClickOutside/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-3QSPHURU.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useClickOutside};

package/lib/hooks/useClickOutside/useClickOutside.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Detecta cliques fora de um elemento e dispara um callback.
+ *
+ * Retorna uma `ref` que deve ser anexada ao elemento que se quer "proteger".
+ * Sempre que o usuário pressionar o mouse fora dele (evento `mousedown` na
+ * fase de captura), o `callback` é chamado.
+ *
+ * Útil para fechar menus, dropdowns, modais e popovers ao clicar fora.
+ *
+ * @param callback - Função executada quando o clique ocorre fora do elemento referenciado.
+ * @returns Uma `ref` tipada para o elemento alvo.
+ *
+ * @example
+ * ```tsx
+ * function Dropdown({ onClose }: { onClose: () => void }) {
+ *   const ref = useClickOutside<HTMLDivElement>(onClose);
+ *   return <div ref={ref}>conteúdo</div>;
+ * }
+ * ```
+ */
+export declare const useClickOutside: <T extends HTMLElement>(callback: () => void) => import("react").RefObject<T>;

package/lib/hooks/useClipboard/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useClipboard`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useClipboard`.
+ */
+export * from './useClipboard';

package/lib/hooks/useClipboard/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-EKTJ3A6R.esm.js";import"../../chunks/chunk-BE2JDTVA.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useClipboard};

package/lib/hooks/useClipboard/useClipboard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copia conteúdo textual para a área de transferência e expõe um sinal de
+ * sucesso temporário.
+ *
+ * Internamente tenta primeiro a Clipboard API assíncrona e, em fallback,
+ * usa `document.execCommand('copy')`. O sinal `hasCopied` fica `true` por
+ * `timeout` milissegundos após uma cópia bem-sucedida — útil para trocar o
+ * label do botão para "Copiado" temporariamente.
+ *
+ * @param text - Texto que será copiado para a área de transferência ao chamar `onCopy`.
+ * @param timeout - Quantos milissegundos `hasCopied` permanece `true` após copiar. Padrão `2000`.
+ * @returns Um objeto com `onCopy` (dispara a cópia) e `hasCopied` (boolean transitório).
+ *
+ * @example
+ * ```tsx
+ * function CopyButton({ value }: { value: string }) {
+ *   const { onCopy, hasCopied } = useClipboard(value);
+ *   return <button onClick={onCopy}>{hasCopied ? 'Copiado' : 'Copiar'}</button>;
+ * }
+ * ```
+ */
+export declare function useClipboard(text: string, timeout?: number): {
+    onCopy: () => void;
+    hasCopied: boolean;
+};

package/lib/hooks/useClipboard/useClipboard.helpers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Opções aceitas pela função {@link copy}.
+ *
+ * - `format`: força um MIME type específico ao escrever na área de transferência.
+ * - `debug`: imprime erros no console quando a cópia falha.
+ * - `onCopy`/`onFailed`: callbacks de resultado.
+ */
+type copyOptions = {
+    format?: string;
+    debug?: boolean;
+    onCopy?: () => void;
+    onFailed?: () => void;
+};
+/**
+ * Copia `text` para a área de transferência usando a melhor estratégia
+ * disponível.
+ *
+ * Tenta primeiro a Clipboard API (assíncrona). Em fallback, recorre a
+ * `document.execCommand('copy')`. Dispara `onCopy` ou `onFailed` conforme o
+ * resultado.
+ */
+export declare function copy(text: string, { onCopy, onFailed, ...options }?: copyOptions): Promise<void>;
+export {};

package/lib/hooks/useDrag/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Barrel público do hook `useDrag`.
+ *
+ * Reexporta a implementação, a interface e os tipos auxiliares
+ * (`DragEvents`, `useDragHookInterface`) e o helper `acceptableFile`.
+ * Qualquer outro arquivo do projeto deve importar do barrel, nunca de paths
+ * internos como `./useDrag` ou `./useDrag.helpers`.
+ */
+export * from './useDrag';
+export * from './useDrag.interface';
+export * from './useDrag.helpers';

package/lib/hooks/useDrag/index.esm.js

@@ -0,0 +1 @@
+import{a,b}from"../../chunks/chunk-KR2X2UQG.esm.js";import"../../chunks/chunk-BE2JDTVA.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as acceptableFile,b as useDrag};

package/lib/hooks/useDrag/useDrag.d.ts

@@ -0,0 +1,26 @@
+import { useDragHookInterface } from './useDrag.interface';
+/**
+ * Hook que orquestra eventos de drag-and-drop de arquivos em um container.
+ *
+ * Retorna o estado `isDragging` (ativo enquanto o usuário arrasta sobre o
+ * alvo) e um conjunto de handlers (`events`) prontos para serem espalhados
+ * em um `<div>`. Filtra os arquivos soltos pelos tipos aceitos em `accept`
+ * e, opcionalmente, limita a um único arquivo via `single`.
+ *
+ * @example
+ * ```tsx
+ * function Dropzone({ onDrop }: { onDrop: (files: File[]) => void }) {
+ *   const { isDragging, events } = useDrag({
+ *     accept: ['image/*'],
+ *     onDrop,
+ *   });
+ *
+ *   return (
+ *     <div {...events} style={{ borderColor: isDragging ? 'blue' : 'gray' }}>
+ *       Solte imagens aqui
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useDrag: useDragHookInterface;

package/lib/hooks/useDrag/useDrag.helpers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Verifica se um arquivo bate com a lista de tipos aceitos.
+ *
+ * Aceita três formatos de entrada em `accept`, no mesmo estilo do atributo
+ * HTML `accept` de `<input type="file">`:
+ *
+ * - Extensão (`.png`, `.pdf`): compara pelo final do nome do arquivo.
+ * - MIME com curinga (`image/*`): compara apenas a parte base do MIME.
+ * - MIME completo (`application/pdf`): compara exatamente.
+ *
+ * @param file - Arquivo (ou um `Partial<File>` com `name`/`type`) a validar.
+ * @param accept - Lista de tipos aceitos, ou uma string única.
+ * @returns `true` se o arquivo casar com ao menos um dos tipos.
+ */
+export declare function acceptableFile(file: Partial<File>, accept: string | string[]): boolean;

package/lib/hooks/useDrag/useDrag.interface.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Argumentos aceitos por {@link useDrag}.
+ *
+ * - `accept`: lista de tipos no formato do atributo HTML `accept`
+ *   (`image/*`, `.pdf`, `application/json`).
+ * - `single`: quando `true`, apenas o primeiro arquivo válido é entregue.
+ * - `onDragOver`/`onDragLeave`: callbacks de entrada/saída do alvo.
+ * - `onDrop`: recebe os arquivos válidos após o drop.
+ */
+type useDragHookArg = {
+    accept?: string[];
+    single?: boolean;
+    onDragOver?: () => void;
+    onDragLeave?: () => void;
+    onDrop?: (files: File[]) => void;
+};
+/**
+ * Conjunto de handlers de drag-and-drop devolvidos por {@link useDrag},
+ * pronto para ser espalhado em um `<div>` (ou elemento equivalente).
+ */
+export type DragEvents = {
+    onDragOver: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragLeave: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDrop: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragEnd: (e: React.DragEvent<HTMLDivElement>) => void;
+};
+/**
+ * Assinatura do hook {@link useDrag}. Recebe opções e devolve estado
+ * (`isDragging`) e o pacote de `events` para anexar ao container.
+ */
+export type useDragHookInterface = (opt: useDragHookArg) => {
+    isDragging: boolean;
+    events: DragEvents;
+};
+export {};

package/lib/hooks/useEventCallback/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Barrel público do hook `useEventCallback`.
+ *
+ * Reexporta a implementação e o utilitário `useIsomorphicEffect` — qualquer
+ * outro arquivo do projeto deve importar do barrel, nunca de paths internos
+ * como `./useEventCallback`.
+ */
+export * from './useEventCallback';

package/lib/hooks/useEventCallback/index.esm.js

@@ -0,0 +1 @@
+import{a,b}from"../../chunks/chunk-3V3ZEGHO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{b as useEventCallback,a as useIsomorphicEffect};

package/lib/hooks/useEventCallback/useEventCallback.d.ts

@@ -0,0 +1,34 @@
+import { useEffect } from 'react';
+/**
+ * Versão isomórfica de `useLayoutEffect`.
+ *
+ * No browser (quando `window` existe), usa `useLayoutEffect` para sincronizar
+ * antes de o navegador pintar. Em SSR (sem `window`), cai em `useEffect` para
+ * evitar warnings do React durante a renderização no servidor.
+ */
+export declare const useIsomorphicEffect: typeof useEffect;
+/**
+ * Cria um callback estável que sempre delega para a versão mais recente de
+ * `fn`.
+ *
+ * O retorno tem identidade constante entre renders (não rompe `memo`/deps de
+ * outros hooks), mas internamente sempre executa a versão mais atual da
+ * função recebida. Útil para registrar handlers em listeners externos sem
+ * sofrer com closures velhas.
+ *
+ * @param fn - Função alvo. Pode mudar entre renders sem impacto na identidade do retorno.
+ * @returns Callback estável que delega para `fn` atual.
+ *
+ * @example
+ * ```tsx
+ * function Component({ onChange }: { onChange: (v: string) => void }) {
+ *   const stable = useEventCallback(onChange);
+ *
+ *   useEffect(() => {
+ *     window.addEventListener('custom', stable);
+ *     return () => window.removeEventListener('custom', stable);
+ *   }, [stable]); // identidade nunca muda
+ * }
+ * ```
+ */
+export declare function useEventCallback(fn: (...args: any[]) => void): any;

package/lib/hooks/useFileDialog/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useFileDialog`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useFileDialog`.
+ */
+export * from './useFileDialog';

package/lib/hooks/useFileDialog/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-A3OJEVGQ.esm.js";import"../../chunks/chunk-KR2X2UQG.esm.js";import"../../chunks/chunk-BE2JDTVA.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useFileDialog};

package/lib/hooks/useFileDialog/useFileDialog.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Opções aceitas por {@link useFileDialog}.
+ *
+ * - `accept`: lista de tipos no formato do atributo HTML `accept`
+ *   (`image/*`, `.pdf`, `application/json`). Usada para validar a seleção.
+ * - `single`: reservado para limitar a um único arquivo (atualmente apenas
+ *   `onFilesSelect` é invocado com a lista completa válida).
+ * - `onFilesSelect`: chamado com os arquivos selecionados aceitos.
+ * - `onUnsupportedFile`: chamado quando algum arquivo escolhido não casa
+ *   com `accept`.
+ */
+interface OptionsInterface {
+    accept?: string[];
+    single?: boolean;
+    onFilesSelect: (f: File[]) => void;
+    onUnsupportedFile?: (f: File) => void;
+}
+/**
+ * Hook para tratar a seleção de arquivos via `<input type="file">`.
+ *
+ * Devolve um handler `getFiles` que deve ser usado no `onChange` de um
+ * `<input>`. O handler valida cada arquivo escolhido contra `accept`:
+ * se algum for inválido, dispara `onUnsupportedFile`; caso contrário,
+ * entrega a lista completa em `onFilesSelect`. Sempre reseta `e.target.value`
+ * ao final, permitindo selecionar o mesmo arquivo novamente em seguida.
+ *
+ * @example
+ * ```tsx
+ * function FilePicker() {
+ *   const { getFiles } = useFileDialog({
+ *     accept: ['image/*'],
+ *     onFilesSelect: (files) => console.log(files),
+ *     onUnsupportedFile: (file) => alert(`Tipo inválido: ${file.name}`),
+ *   });
+ *
+ *   return <input type="file" multiple onChange={getFiles} />;
+ * }
+ * ```
+ */
+export declare function useFileDialog(opts?: OptionsInterface): {
+    getFiles: (e: React.ChangeEvent<HTMLInputElement>) => void;
+};
+export {};

package/lib/hooks/useIntersect/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useIntersect`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useIntersect`.
+ */
+export * from './useIntersect';

package/lib/hooks/useIntersect/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-KFFUMDHD.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useIntersect};

package/lib/hooks/useIntersect/useIntersect.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Executa um callback quando um nó do DOM entra na viewport.
+ *
+ * Internamente usa a [Intersection Observer
+ * API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
+ * Quando a API não está disponível no `window`, dispara `onIntersect` uma vez
+ * (fallback gracioso, assumindo "visível").
+ *
+ * Retorna uma tupla com um único setter `[setNode]`: você deve passá-lo como
+ * `ref` para o elemento a observar. Sempre que o nó muda, o observer é
+ * reconfigurado.
+ *
+ * @param options - Opções padrão do `IntersectionObserver` (`root`, `rootMargin`, `threshold`).
+ * @param onIntersect - Callback disparado quando o nó está visível.
+ * @returns Tupla `[setNode]` para anexar como `ref` ao elemento observado.
+ *
+ * @example
+ * ```tsx
+ * function LoadMore({ onVisible }: { onVisible: () => void }) {
+ *   const [setNode] = useIntersect({ threshold: 1 }, onVisible);
+ *   return <div ref={setNode}>Carregar mais…</div>;
+ * }
+ * ```
+ */
+export declare function useIntersect({ root, threshold, rootMargin }: IntersectionObserverInit, onIntersect?: () => void): import("react").Dispatch<any>[];

package/lib/hooks/useLazyEffect/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useLazyEffect`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useLazyEffect`.
+ */
+export * from './useLazyEffect';

package/lib/hooks/useLazyEffect/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-2FQC32AA.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useLazyEffect};

package/lib/hooks/useLazyEffect/useLazyEffect.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Versão "preguiçosa" de `useEffect`: pula a execução no primeiro render e só
+ * executa o callback nas atualizações subsequentes das dependências.
+ *
+ * Equivale a um `componentDidUpdate` em hooks. Útil para reagir a mudanças de
+ * estado/props sem disparar lógica no mount.
+ *
+ * @param cb - Callback que será executado nas atualizações das `deps`.
+ * @param deps - Lista de dependências (mesma semântica de `useEffect`).
+ *
+ * @example
+ * ```tsx
+ * function Filter({ query }: { query: string }) {
+ *   useLazyEffect(() => {
+ *     // não dispara no mount; só quando `query` muda
+ *     fetchResults(query);
+ *   }, [query]);
+ * }
+ * ```
+ */
+export declare function useLazyEffect(cb: () => any, deps: any[]): void;

package/lib/hooks/useMediaQuery/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Barrel público do hook `useMediaQuery`.
+ *
+ * Reexporta o hook, as interfaces (`TargetEventInterface`,
+ * `DefaultViewportInterface`) e os helpers de checagem por breakpoint.
+ * Qualquer outro arquivo do projeto deve importar do barrel, nunca de paths
+ * internos como `./useMediaQuery` ou `./useMediaQuery.helpers`.
+ */
+export * from './useMediaQuery.interface';
+export * from './useMediaQuery.helpers';
+export * from './useMediaQuery';

package/lib/hooks/useMediaQuery/index.esm.js

@@ -0,0 +1 @@
+import{a,b,c,d,e}from"../../chunks/chunk-V77X6UJ2.esm.js";import"../../chunks/chunk-GWCDFVWM.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{d as checkIsLaptop,b as checkIsMobile,c as checkIsTablet,a as getBoundaries,e as useMediaQuery};

package/lib/hooks/useMediaQuery/useMediaQuery.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Hook de consulta de mídia CSS para os breakpoints definidos no tema.
+ *
+ * Devolve flags reativas (`isMobile`, `isTablet`, `isLaptop`, ...) calculadas
+ * a partir do `<BreakpointsProvider />` mais próximo da árvore. Os
+ * breakpoints (`md`, `lg`, `xl`) são lidos do tema do
+ * [`ApollionProvider`](../../themes/README.md) e podem ser customizados via
+ * `createTheme`.
+ *
+ * @throws Se for usado fora de `<BreakpointsProvider />`.
+ * @returns Objeto com as flags do viewport atual.
+ *
+ * @example
+ * ```tsx
+ * const { isMobile, isTablet, isLaptop } = useMediaQuery();
+ * return <Button fullWidth={isMobile}>OK</Button>;
+ * ```
+ */
+export declare function useMediaQuery(): import("../..").BreakpointsContextType;

package/lib/hooks/useMediaQuery/useMediaQuery.helpers.d.ts

@@ -0,0 +1,26 @@
+import { TargetEventInterface } from './useMediaQuery.interface';
+import { BreakpointValuesTypes } from '../../themes/Breakpoints';
+/**
+ * Extrai as dimensões do viewport a partir de um evento "alvo" (geralmente
+ * `window`). Devolve `{ width, height }` no formato esperado pelo
+ * `BreakpointsContext`.
+ */
+export declare function getBoundaries({ innerWidth: width, innerHeight: height }: TargetEventInterface): {
+    width: number;
+    height: number;
+};
+/**
+ * Indica se a largura atual cai abaixo (ou no limite) do breakpoint `md`,
+ * caracterizando ambiente mobile.
+ */
+export declare function checkIsMobile({ innerWidth: width }: TargetEventInterface, breakpoints: BreakpointValuesTypes): boolean;
+/**
+ * Indica se a largura atual está entre os breakpoints `md` e `lg`,
+ * caracterizando ambiente tablet.
+ */
+export declare function checkIsTablet({ innerWidth: width }: TargetEventInterface, breakpoints: BreakpointValuesTypes): boolean;
+/**
+ * Indica se a largura atual está entre os breakpoints `lg` e `xl`,
+ * caracterizando ambiente laptop.
+ */
+export declare function checkIsLaptop({ innerWidth: width }: TargetEventInterface, breakpoints: BreakpointValuesTypes): boolean;

package/lib/hooks/useMediaQuery/useMediaQuery.interface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Estrutura "evento alvo" usada pelos helpers de media query. Modela o subset
+ * do `window` que importa para o cálculo dos breakpoints (`innerWidth` e
+ * opcionalmente `innerHeight`).
+ */
+export interface TargetEventInterface {
+    innerWidth: number;
+    innerHeight?: number;
+}
+/**
+ * Forma padrão do retorno de {@link useMediaQuery}.
+ *
+ * Inclui flags por faixa de viewport (`isMobile`, `isTablet`, `isLaptop`) e
+ * as dimensões atuais em `boundaries`.
+ */
+export interface DefaultViewportInterface {
+    isMobile?: boolean;
+    isTablet?: boolean;
+    isLaptop?: boolean;
+    boundaries: {
+        width?: number;
+        height?: number;
+    };
+}

package/lib/hooks/useProgress/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useProgress`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useProgress`.
+ */
+export * from './useProgress';

package/lib/hooks/useProgress/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-SPHHNZVP.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useProgress};

package/lib/hooks/useProgress/useProgress.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tamanhos discretos de incremento aceitos por {@link useProgress}.
+ *
+ * Restringe os passos válidos para garantir que `100` seja sempre alcançável
+ * sem resíduo (todos os valores são divisores de 100, exceto pelos casos
+ * onde o clamp final completa a barra).
+ */
+type incrementType = 1 | 5 | 10 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50;
+/**
+ * Hook de progresso animado que avança automaticamente até 100.
+ *
+ * Internamente usa um `setInterval` calculado para distribuir os incrementos
+ * ao longo de `time` milissegundos. Quando `time` é `null`/`0`, nenhum
+ * intervalo é criado — útil para "pausar" a animação. O hook clampa em 100
+ * automaticamente e limpa o intervalo no unmount.
+ *
+ * @param initialValue - Valor inicial do progresso (0–100). Padrão `0`.
+ * @param increment - Tamanho de cada passo. Padrão `1`.
+ * @param time - Duração total estimada em ms para chegar a 100. Padrão `3000`. Use `null` para desativar a animação.
+ * @returns Valor atual do progresso (número de 0 a 100).
+ *
+ * @example
+ * ```tsx
+ * function Loader() {
+ *   const value = useProgress(0, 5, 2000);
+ *   return <progress value={value} max={100} />;
+ * }
+ * ```
+ */
+export declare function useProgress(initialValue?: number, increment?: incrementType, time?: number | null): number;
+export {};

package/lib/hooks/useScript/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useScript`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useScript`.
+ */
+export * from './useScript';

package/lib/hooks/useScript/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-I2E5B4NH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useScript};

package/lib/hooks/useScript/useScript.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Carrega um script externo no `<body>` e expõe um sinal de loading.
+ *
+ * Gera um `id` determinístico a partir de `src` (hash SHA-1) e injeta o
+ * `<script async>` apenas se ainda não existir um com o mesmo id — isso
+ * evita injeções duplicadas quando o hook é montado várias vezes ou em
+ * componentes diferentes. O sinal `isLoadingScript` vira `false` no `onload`.
+ *
+ * @param config - Objeto com a URL do script em `src`.
+ * @returns `{ isLoadingScript }` — `true` até o script carregar.
+ *
+ * @example
+ * ```tsx
+ * function MapWidget() {
+ *   const { isLoadingScript } = useScript({ src: 'https://example.com/widget.js' });
+ *   if (isLoadingScript) return <Spinner />;
+ *   return <div id="widget" />;
+ * }
+ * ```
+ */
+export declare const useScript: ({ src }: {
+    src: string;
+}) => {
+    isLoadingScript: boolean;
+};

package/lib/hooks/useToggle/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel público do hook `useToggle`.
+ *
+ * Reexporta a implementação — qualquer outro arquivo do projeto deve importar
+ * do barrel, nunca de paths internos como `./useToggle`.
+ */
+export * from './useToggle';

package/lib/hooks/useToggle/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-BE2JDTVA.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as useToggle};