@apollion-dsi/core 5.3.0 → 5.5.0

package/lib/form/Switch/Switch.style.d.ts

@@ -1,46 +1,33 @@
 import { SwitchSize } from './Switch.interface';
 import { Theme } from '../../themes/ThemeProvider';
-/**
- * Dimensões intrínsecas (px) do controle por tamanho.
- *
- * Seguindo o precedente do `Checkbox` (quadrado fixo de 20px), as medidas do
- * trilho/bolinha são px fixos — o espaçamento ao redor continua vindo do tema.
- * `pad` é a folga entre a bolinha e a borda do trilho.
- */
-export declare const switchSizeTokens: Record<SwitchSize, {
-    trackW: number;
-    trackH: number;
-    thumb: number;
-    pad: number;
-}>;
 type SwitchVisualProps = {
     $size?: SwitchSize;
     theme: Theme;
 };
 /**
- * `<input type="checkbox" role="switch">` nativo posicionado sobre o controle
- * visual.
+ * Native `<input type="checkbox" role="switch">` positioned over the visual
+ * control.
  *
- * Fica `opacity: 0` (em vez de `display: none`/`hidden`) para preservar foco
- * do teclado e alternância por `Space` — diferente do `Checkbox`, o `Switch`
- * é tipicamente operado direto pelo teclado.
+ * It stays at `opacity: 0` (instead of `display: none`/`hidden`) to preserve
+ * keyboard focus and toggling via `Space` — unlike the `Checkbox`, the
+ * `Switch` is typically operated directly from the keyboard.
  */
 export declare const SwitchInputStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").ClassAttributes<HTMLInputElement> & import("react").InputHTMLAttributes<HTMLInputElement>, never> & Partial<Pick<import("react").ClassAttributes<HTMLInputElement> & import("react").InputHTMLAttributes<HTMLInputElement>, never>>> & string;
 /**
- * Bolinha (thumb) — disco que desliza dentro do trilho. Expõe a distância de
- * deslocamento via `--travel` para a regra de estado ligado no container.
+ * Thumb — disc that slides inside the track. Exposes the travel distance
+ * via `--travel` for the on-state rule on the container.
  */
 export declare const SwitchThumbStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement>, keyof SwitchVisualProps> & SwitchVisualProps, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement>, keyof SwitchVisualProps> & SwitchVisualProps, never>>> & string;
 /**
- * Trilho (track) — fundo arredondado (pill) que contém a bolinha.
+ * Track — rounded (pill) background that contains the thumb.
  */
 export declare const SwitchTrackStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement>, keyof SwitchVisualProps> & SwitchVisualProps, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement>, keyof SwitchVisualProps> & SwitchVisualProps, never>>> & string;
 /**
- * Container externo do switch (`<label>`).
+ * Outer container of the switch (`<label>`).
  *
- * Usamos `_styled('label')` para que clicar no texto também alterne o input
- * envolvido (associação implícita de label), mantendo um respiro pequeno
- * (`xs`) sem ditar o layout do consumer — mesmo padrão do `Checkbox`/`Radio`.
+ * We use `_styled('label')` so clicking the text also toggles the wrapped
+ * input (implicit label association), keeping a small breathing room
+ * (`xs`) without dictating the consumer's layout — same pattern as `Checkbox`/`Radio`.
  */
 export declare const SwitchContainerStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLLabelElement> & import("react").LabelHTMLAttributes<HTMLLabelElement>, "theme" | keyof import("./Switch.interface").SwitchInterface> & {
     theme: Theme;

package/lib/form/Switch/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * Barrel público do componente `Switch`.
+ * Public barrel for the `Switch` component.
  *
- * Reexporta a implementação, as interfaces e os styled-components.
+ * Re-exports the implementation, the interfaces and the styled-components.
  */
 export * from './Switch.interface';
 export * from './Switch.style';

package/lib/form/Switch/index.esm.js

@@ -1 +1 @@
-import{a,b,c,d,e,f}from"../../chunks/chunk-OPAH7JBD.esm.js";import"../../chunks/chunk-B64YEI67.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-JYROOJRO.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-MBYC37CX.esm.js";import"../../chunks/chunk-NI6YLGUA.esm.js";import"../../chunks/chunk-OZIEVLUR.esm.js";import"../../chunks/chunk-FJUISCKG.esm.js";import"../../chunks/chunk-RZDVS7AY.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-TLBV5OUM.esm.js";import"../../chunks/chunk-E3MSXQXV.esm.js";import"../../chunks/chunk-TQJTHPA3.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-APD22JEO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{f as Switch,e as SwitchContainerStyle,b as SwitchInputStyle,c as SwitchThumbStyle,d as SwitchTrackStyle,a as switchSizeTokens};
+import{a,b,c,d,e}from"../../chunks/chunk-2WED4EVR.esm.js";import"../../chunks/chunk-KASRN4X5.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-LATE6DIA.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-MBYC37CX.esm.js";import"../../chunks/chunk-NI6YLGUA.esm.js";import"../../chunks/chunk-OZIEVLUR.esm.js";import"../../chunks/chunk-3RNWYCCU.esm.js";import"../../chunks/chunk-RZDVS7AY.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-TLBV5OUM.esm.js";import"../../chunks/chunk-E3MSXQXV.esm.js";import"../../chunks/chunk-TQJTHPA3.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-APD22JEO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{e as Switch,d as SwitchContainerStyle,a as SwitchInputStyle,b as SwitchThumbStyle,c as SwitchTrackStyle};

package/lib/form/TextArea/TextArea.d.ts

@@ -1,22 +1,22 @@
 import React from 'react';
 import { TextAreaInterface } from './TextArea.interface';
 /**
- * Campo de texto multi-linha (`<textarea>`).
+ * Multi-line text field (`<textarea>`).
  *
- * Útil para coletar comentários, descrições e qualquer entrada de texto
- * livre que possa ultrapassar uma linha. Quando `maxLength` é definido,
- * exibe um contador no canto inferior com quantos caracteres restam.
+ * Useful for collecting comments, descriptions and any free-form text
+ * input that may exceed one line. When `maxLength` is defined, it shows a
+ * counter in the bottom corner with how many characters remain.
  *
- * Funciona tanto em modo **controlado** (com `value` + `onChange`) quanto
- * **não controlado** (apenas `defaultValue`); em ambos os casos o contador
- * de caracteres é atualizado em tempo real.
+ * Works both in **controlled** mode (with `value` + `onChange`) and
+ * **uncontrolled** mode (just `defaultValue`); in both cases the character
+ * counter updates in real time.
  *
  * @example
  * ```tsx
- * <TextArea placeholder="Deixe um comentário" maxLength={140} />
+ * <TextArea placeholder="Leave a comment" maxLength={140} />
  * <TextArea size="expansive" resize variant="success" />
  * ```
  *
- * @see {@link TextAreaInterface} para o detalhamento das props.
+ * @see {@link TextAreaInterface} for the detailed props.
  */
 export declare const TextAreaComponent: React.FC<TextAreaInterface>;

package/lib/form/TextArea/TextArea.interface.d.ts

@@ -1,48 +1,48 @@
 import { FieldVariants } from '../Field';
 import { InputSize, InputTokenProps } from '../Input';
 /**
- * Props do componente `TextArea`.
+ * Props of the `TextArea` component.
  *
- * Estende as props nativas de `<textarea>` e aplica os tokens visuais do
- * design system (tamanho, variante de cor). Suporta `maxLength` com
- * contador de caracteres restantes (`maxLengthHint` define o sufixo).
+ * Extends the native `<textarea>` props and applies the design system's
+ * visual tokens (size, color variant). Supports `maxLength` with a
+ * remaining-characters counter (`maxLengthHint` sets the suffix).
  *
  * @example
  * ```tsx
- * <TextArea placeholder="Deixe um comentário" maxLength={140} />
+ * <TextArea placeholder="Leave a comment" maxLength={140} />
  * <TextArea size="expansive" resize variant="success" />
  * ```
  *
- * @see {@link InputSize} para os tokens de tamanho disponíveis.
+ * @see {@link InputSize} for the available size tokens.
  */
 export interface TextAreaInterface extends React.ComponentPropsWithoutRef<'textarea'> {
     /**
-     * Token de tamanho do textarea.
+     * Textarea size token.
      *
      * @default 'medium'
      */
     size?: InputSize;
     value?: string;
     /**
-     * Quando `true`, libera o `<textarea>` para o usuário redimensionar
-     * (`resize: both`); quando `false`, fixa o tamanho.
+     * When `true`, allows the user to resize the `<textarea>`
+     * (`resize: both`); when `false`, fixes the size.
      *
      * @default false
      */
     resize?: boolean;
     /**
-     * Limita o número de caracteres e exibe um contador no canto inferior
-     * direito com o número restante.
+     * Limits the number of characters and displays a counter in the bottom
+     * right corner with the remaining number.
      */
     maxLength?: number;
     /**
-     * Sufixo do contador exibido após o número de caracteres restantes.
+     * Counter suffix displayed after the number of remaining characters.
      *
      * @default 'characters left'
      */
     maxLengthHint?: string;
     /**
-     * Variante visual do textarea.
+     * Textarea visual variant.
      *
      * @default 'default'
      */
@@ -50,7 +50,7 @@ export interface TextAreaInterface extends React.ComponentPropsWithoutRef<'texta
     onChange?: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
 }
 /**
- * Props recebidas pelo styled-component do `TextArea`, incluindo os tokens
- * de tamanho resolvidos.
+ * Props received by the `TextArea`'s styled-component, including the
+ * resolved size tokens.
  */
 export type TextAreaStyleProps = TextAreaInterface & InputTokenProps;

package/lib/form/TextArea/TextArea.style.d.ts

@@ -1,9 +1,9 @@
 /**
- * Styled-component do `<textarea>`.
+ * Styled-component of the `<textarea>`.
  *
- * Reaproveita os mixins do `Input` (`inputVariantStyle`, `inputDisabledStyle`,
- * `inputPlaceholderStyle`) para manter coerência visual exata entre os dois
- * — assim, mudanças no `Input` se propagam automaticamente.
+ * Reuses the `Input` mixins (`inputVariantStyle`, `inputDisabledStyle`,
+ * `inputPlaceholderStyle`) to keep exact visual coherence between the two
+ * — this way, changes to the `Input` propagate automatically.
  */
 export declare const TextAreaStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLTextAreaElement> & import("react").TextareaHTMLAttributes<HTMLTextAreaElement>, keyof import("../../themes").BorderInput | "fontSize" | import("../../factory").BorderRoundPropsType | "borderColor" | "borderPosition" | "square" | "textAlign" | "whiteSpace" | "wordBreak" | "textDecoration" | keyof {
     fontFamily: {
@@ -59,7 +59,7 @@ export declare const TextAreaStyle: import("styled-components/dist/types").IStyl
     square?: boolean;
 } & Partial<{
     borderRadius: "xs" | "sm" | "md" | "micro" | "large" | "straight" | "circular";
-    borderWidth: "bold" | "none" | "thin" | "regular" | "great";
+    borderWidth: "bold" | "none" | "regular" | "thin" | "great";
     borderStyle: "solid" | "dotted" | "dashed";
 }> & Partial<Record<import("../../factory").BorderRoundPropsType, number | "xs" | "sm" | "md" | "micro" | "large" | "straight" | "circular">> & import("../../factory").SizeFactoryProps, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLTextAreaElement> & import("react").TextareaHTMLAttributes<HTMLTextAreaElement>, keyof import("../../themes").BorderInput | "fontSize" | import("../../factory").BorderRoundPropsType | "borderColor" | "borderPosition" | "square" | "textAlign" | "whiteSpace" | "wordBreak" | "textDecoration" | keyof {
     fontFamily: {
@@ -115,13 +115,13 @@ export declare const TextAreaStyle: import("styled-components/dist/types").IStyl
     square?: boolean;
 } & Partial<{
     borderRadius: "xs" | "sm" | "md" | "micro" | "large" | "straight" | "circular";
-    borderWidth: "bold" | "none" | "thin" | "regular" | "great";
+    borderWidth: "bold" | "none" | "regular" | "thin" | "great";
     borderStyle: "solid" | "dotted" | "dashed";
 }> & Partial<Record<import("../../factory").BorderRoundPropsType, number | "xs" | "sm" | "md" | "micro" | "large" | "straight" | "circular">> & import("../../factory").SizeFactoryProps, never>>> & string;
 /**
- * Contador de caracteres restantes — posicionado absolutamente abaixo do
- * textarea (`transform: translateY(100%)`) para não disputar espaço com o
- * conteúdo digitado.
+ * Remaining-characters counter — absolutely positioned below the
+ * textarea (`transform: translateY(100%)`) so it does not compete for space
+ * with the typed content.
  */
 export declare const TextAreaCounterStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
     as?: import("styled-components").WebTarget;

package/lib/form/TextArea/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel público do componente `TextArea`.
+ * Public barrel for the `TextArea` component.
  *
- * Reexporta a implementação, as interfaces e os styled-components — outros
- * componentes devem importar daqui (`../TextArea`), nunca de
+ * Re-exports the implementation, the interfaces and the styled-components —
+ * other components must import from here (`../TextArea`), never from
  * `./TextArea.interface`.
  */
 export * from './TextArea.style';

package/lib/form/TextArea/index.esm.js

@@ -1 +1 @@
-import{a,b,c}from"../../chunks/chunk-5VB6YPWU.esm.js";import"../../chunks/chunk-2JE2KM3Y.esm.js";import"../../chunks/chunk-MGLZFOSB.esm.js";import"../../chunks/chunk-FGI2BYTC.esm.js";import"../../chunks/chunk-H2KVPACE.esm.js";import"../../chunks/chunk-JN5ZNWJR.esm.js";import"../../chunks/chunk-PAITPPEW.esm.js";import"../../chunks/chunk-KDIEROKH.esm.js";import"../../chunks/chunk-TUALAE4W.esm.js";import"../../chunks/chunk-ZLFQHCLE.esm.js";import"../../chunks/chunk-QF2YUOVX.esm.js";import"../../chunks/chunk-T6ZB656A.esm.js";import"../../chunks/chunk-7AFAO7ZS.esm.js";import"../../chunks/chunk-NO4SD45Y.esm.js";import"../../chunks/chunk-RU6QRCR7.esm.js";import"../../chunks/chunk-CWRWYU7D.esm.js";import"../../chunks/chunk-2R6XFFSQ.esm.js";import"../../chunks/chunk-TG5BCBO4.esm.js";import"../../chunks/chunk-BRXIFPWB.esm.js";import"../../chunks/chunk-3EOSES4S.esm.js";import"../../chunks/chunk-NQBO2D7L.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-OWMRURZT.esm.js";import"../../chunks/chunk-6X6WKZ3Y.esm.js";import"../../chunks/chunk-JOKVE3IX.esm.js";import"../../chunks/chunk-5Q265MC7.esm.js";import"../../chunks/chunk-3V3ZEGHO.esm.js";import"../../chunks/chunk-WGTBX72G.esm.js";import"../../chunks/chunk-IWMEDT6U.esm.js";import"../../chunks/chunk-B64YEI67.esm.js";import"../../chunks/chunk-2IZ35FTI.esm.js";import"../../chunks/chunk-YJ4ZRQMI.esm.js";import"../../chunks/chunk-6N52NFPT.esm.js";import"../../chunks/chunk-QTWYG4PZ.esm.js";import"../../chunks/chunk-Q6EGG64M.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-JYROOJRO.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-MBYC37CX.esm.js";import"../../chunks/chunk-NI6YLGUA.esm.js";import"../../chunks/chunk-OZIEVLUR.esm.js";import"../../chunks/chunk-FJUISCKG.esm.js";import"../../chunks/chunk-RZDVS7AY.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-TLBV5OUM.esm.js";import"../../chunks/chunk-E3MSXQXV.esm.js";import"../../chunks/chunk-TQJTHPA3.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-APD22JEO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{c as TextArea,b as TextAreaCounterStyle,a as TextAreaStyle};
+import{a,b,c}from"../../chunks/chunk-FPUV6SIF.esm.js";import"../../chunks/chunk-NYDXZB2D.esm.js";import"../../chunks/chunk-KHEBUAB4.esm.js";import"../../chunks/chunk-CZAUFZ45.esm.js";import"../../chunks/chunk-H2KVPACE.esm.js";import"../../chunks/chunk-5SQH2W2J.esm.js";import"../../chunks/chunk-TD4RVB2L.esm.js";import"../../chunks/chunk-BVKAXW2H.esm.js";import"../../chunks/chunk-TUALAE4W.esm.js";import"../../chunks/chunk-ZLFQHCLE.esm.js";import"../../chunks/chunk-KL3ATH64.esm.js";import"../../chunks/chunk-T6ZB656A.esm.js";import"../../chunks/chunk-7AFAO7ZS.esm.js";import"../../chunks/chunk-PXCCSJNT.esm.js";import"../../chunks/chunk-RU6QRCR7.esm.js";import"../../chunks/chunk-CWRWYU7D.esm.js";import"../../chunks/chunk-2R6XFFSQ.esm.js";import"../../chunks/chunk-TG5BCBO4.esm.js";import"../../chunks/chunk-JOKVE3IX.esm.js";import"../../chunks/chunk-BRXIFPWB.esm.js";import"../../chunks/chunk-3EOSES4S.esm.js";import"../../chunks/chunk-NQBO2D7L.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-7EGX7BMB.esm.js";import"../../chunks/chunk-OWMRURZT.esm.js";import"../../chunks/chunk-6X6WKZ3Y.esm.js";import"../../chunks/chunk-5Q265MC7.esm.js";import"../../chunks/chunk-3V3ZEGHO.esm.js";import"../../chunks/chunk-WGTBX72G.esm.js";import"../../chunks/chunk-IWMEDT6U.esm.js";import"../../chunks/chunk-KASRN4X5.esm.js";import"../../chunks/chunk-BMGVQBTB.esm.js";import"../../chunks/chunk-BC24WDTC.esm.js";import"../../chunks/chunk-6N52NFPT.esm.js";import"../../chunks/chunk-CLDPV7NK.esm.js";import"../../chunks/chunk-YRBM4WYM.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-LATE6DIA.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-MBYC37CX.esm.js";import"../../chunks/chunk-NI6YLGUA.esm.js";import"../../chunks/chunk-OZIEVLUR.esm.js";import"../../chunks/chunk-3RNWYCCU.esm.js";import"../../chunks/chunk-RZDVS7AY.esm.js";import"../../chunks/chunk-IK5Z5C2R.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-OXQA5WD3.esm.js";import"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-RWLJNXLX.esm.js";import"../../chunks/chunk-TLBV5OUM.esm.js";import"../../chunks/chunk-E3MSXQXV.esm.js";import"../../chunks/chunk-TQJTHPA3.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-APD22JEO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{c as TextArea,b as TextAreaCounterStyle,a as TextAreaStyle};

package/lib/form/UploadCard/UploadCard.d.ts

@@ -1,19 +1,19 @@
 import React from 'react';
 import { UploadCardProps, UploadCardRef } from './UploadCard.interface';
 /**
- * Card de upload de arquivos com suporte a drag-and-drop, múltiplos
- * arquivos e progresso de envio.
+ * File upload card with support for drag-and-drop, multiple files, and
+ * upload progress.
  *
- * Suporta duas variantes visuais via prop `compact`:
- * - **regular** (padrão): card grande com área de drop, ícone, e lista de
- *   arquivos abaixo.
- * - **compact**: linha única com botão + arquivos em grade — útil dentro
- *   de formulários com pouco espaço.
+ * Supports two visual variants via the `compact` prop:
+ * - **regular** (default): large card with a drop area, icon, and file list
+ *   below.
+ * - **compact**: single row with a button + files in a grid — useful inside
+ *   forms with little space.
  *
- * O upload em si é opcional — o componente pode ser usado puramente para
- * coletar arquivos (`onChange`) e fazer o envio em outro lugar. Quando
- * `uploadConfig.endpoint` está definido e a ref `submit()` é chamada, o
- * componente faz POST via XHR com progresso em tempo real.
+ * The upload itself is optional — the component can be used purely to
+ * collect files (`onChange`) and do the sending elsewhere. When
+ * `uploadConfig.endpoint` is defined and the `submit()` ref is called, the
+ * component POSTs via XHR with real-time progress.
  *
  * @example
  * ```tsx
@@ -25,13 +25,13 @@ import { UploadCardProps, UploadCardRef } from './UploadCard.interface';
  *   acceptLabel="PNG, JPEG, PDF"
  *   maxSize={10 * 1024 * 1024}
  *   onChange={(value) => console.log(value)}
- *   onUnsupportedFile={(f) => showNotification('Arquivo não suportado')}
+ *   onUnsupportedFile={(f) => showNotification('Unsupported file')}
  * />
  *
- * // Envio:
+ * // Submit:
  * await uploadRef.current?.submit({ endpoint: '/api/upload' });
  * ```
  *
- * @see {@link UploadCardProps} para o detalhamento das props.
+ * @see {@link UploadCardProps} for the detailed props.
  */
 export declare const UploadCard: React.ForwardRefExoticComponent<UploadCardProps & React.RefAttributes<UploadCardRef>>;

package/lib/form/UploadCard/UploadCard.helpers.d.ts

@@ -1,32 +1,32 @@
 import { FileItem, UploadParameters } from './UploadCard.interface';
 /**
- * Formata bytes em uma string legível (`'1.50 MB'`, `'24.30 kB'`, ...).
+ * Formats bytes into a readable string (`'1.50 MB'`, `'24.30 kB'`, ...).
  *
- * Usa potências de 1000 (não 1024) — é o padrão dos sistemas operacionais
- * modernos para arquivos (SI, não JEDEC).
+ * Uses powers of 1000 (not 1024) — the standard modern operating systems
+ * use for files (SI, not JEDEC).
  */
 export declare function fileSize(size: number): string;
 /**
- * Filtra arquivos maiores que `maxSize` (em bytes).
+ * Filters out files larger than `maxSize` (in bytes).
  *
- * Default conservador: 15 MB. Arquivos rejeitados não disparam erro — o
- * consumidor deve usar `onUnsupportedFile` (no `useFileDialog`/`useDrag`)
- * para feedback ao usuário.
+ * Conservative default: 15 MB. Rejected files trigger no error — the
+ * consumer must use `onUnsupportedFile` (in `useFileDialog`/`useDrag`) for
+ * user feedback.
  */
 export declare function filterFiles(fileInput: File | File[], maxSize: number): File[];
 /**
- * Converte `File`s nativos em `FileItem`s do design system — adiciona um
- * `id` único (via nanoid) para rastreamento na UI sem depender do nome.
+ * Converts native `File`s into design system `FileItem`s — adds a unique
+ * `id` (via nanoid) for UI tracking without relying on the name.
  */
 export declare function convertFileToFileItem(fileList: File[]): Partial<FileItem[]>;
 /**
- * Faz upload de um único `File` via `XMLHttpRequest`.
+ * Uploads a single `File` via `XMLHttpRequest`.
  *
- * Usamos XHR (não `fetch`) porque precisamos do evento `upload.progress`
- * — `fetch` ainda não suporta progresso de upload em todos os navegadores.
+ * We use XHR (not `fetch`) because we need the `upload.progress` event —
+ * `fetch` still does not support upload progress in every browser.
  *
- * Aceita autenticação básica (`auth.username`/`auth.password` → header
- * `Authorization`), parâmetros de query (`params`), parâmetros extras do
- * FormData (`formDataParams`), e callbacks de progresso (`onProgress`).
+ * Accepts basic authentication (`auth.username`/`auth.password` →
+ * `Authorization` header), query parameters (`params`), extra FormData
+ * parameters (`formDataParams`), and progress callbacks (`onProgress`).
  */
 export declare function uploadFile(parameters: UploadParameters): Promise<unknown>;

package/lib/form/UploadCard/UploadCard.interface.d.ts

@@ -1,8 +1,8 @@
 import { DragEvents } from '../../hooks/useDrag';
 /**
- * Configuração da requisição de upload feita pelo `UploadCard.submit()`.
+ * Configuration of the upload request performed by `UploadCard.submit()`.
  *
- * Não é necessária para uso puro como coletor de arquivos (sem submit).
+ * Not required for pure use as a file collector (without submit).
  *
  * @example
  * ```tsx
@@ -26,23 +26,23 @@ export interface UploadFileRequestConfig {
     params?: {
         [key: string]: any;
     };
-    /** Nome do field do FormData (default `'file'`). */
+    /** Name of the FormData field (default `'file'`). */
     formDataFileKey?: string;
-    /** Campos extras anexados ao FormData (ex.: token, metadata). */
+    /** Extra fields appended to the FormData (e.g. token, metadata). */
     formDataParams?: {
         key: string;
         value: string | Blob;
         fileName?: string;
     }[];
-    /** Autenticação básica — gera o header `Authorization` automaticamente. */
+    /** Basic authentication — generates the `Authorization` header automatically. */
     auth?: {
         username: string;
         password: string;
     };
 }
 /**
- * Argumentos da função utilitária `uploadFile` (uso direto, fora do
- * `UploadCard`). Geralmente você não precisa interagir com isso.
+ * Arguments of the `uploadFile` utility function (direct use, outside the
+ * `UploadCard`). You usually do not need to interact with this.
  */
 export interface UploadParameters {
     file: File;
@@ -52,19 +52,19 @@ export interface UploadParameters {
     onFail?: () => void;
 }
 /**
- * Item de arquivo gerenciado pelo `UploadCard`.
+ * File item managed by the `UploadCard`.
  *
- * `id` é gerado via `nanoid` para rastreamento estável na UI. Os campos
- * `upload*` ficam preenchidos durante e depois do upload.
+ * `id` is generated via `nanoid` for stable tracking in the UI. The
+ * `upload*` fields are filled during and after the upload.
  */
 export type FileItem = {
     file: File;
     fileName: string;
     fileSize: string;
     id: string;
-    /** Bytes carregados (formatados, ex.: `'1.20 MB'`). */
+    /** Bytes uploaded (formatted, e.g. `'1.20 MB'`). */
     uploadLoaded?: string;
-    /** Percentual carregado, ex.: `'45%'`. */
+    /** Percentage uploaded, e.g. `'45%'`. */
     uploadPercentage?: string;
     uploadCompleted?: boolean;
     uploadError?: boolean;
@@ -76,13 +76,13 @@ export type FileItemProps = {
     readOnly?: boolean;
 } & FileItem;
 /**
- * Ref imperativa exposta pelo `UploadCard`.
+ * Imperative ref exposed by the `UploadCard`.
  *
- * Use para disparar o upload, manipular a lista de arquivos e ler o estado
- * atual sem depender de re-renders do componente pai.
+ * Use it to trigger the upload, manipulate the file list, and read the
+ * current state without depending on parent component re-renders.
  */
 export type UploadCardRef = {
-    /** Faz upload de todos os arquivos atuais. Devolve as respostas em paralelo. */
+    /** Uploads all current files. Returns the responses in parallel. */
     submit(config?: UploadFileRequestConfig): Promise<any>;
     removeFile(id: string): void;
     removeAll(): void;
@@ -96,13 +96,13 @@ type CustomButtonProps = {
     isSubmitting?: boolean;
 };
 /**
- * Tipos de ação reportados pelo `onChange` do `UploadCard`. Útil para
- * reagir a apenas certas operações (ex.: persistir só em `REMOVE`).
+ * Action types reported by the `UploadCard`'s `onChange`. Useful to react
+ * to only certain operations (e.g. persist only on `REMOVE`).
  */
 export type FileActionType = 'ADD_INITIAL_FILES' | 'ADD' | 'REMOVE' | 'REPLACE' | 'UPDATE' | 'RESET';
 /**
- * Payload entregue ao `onChange`. `payload` é o item afetado pela ação
- * (ou array, no caso de `ADD_INITIAL_FILES`).
+ * Payload delivered to `onChange`. `payload` is the item affected by the
+ * action (or an array, in the `ADD_INITIAL_FILES` case).
  */
 export type UploadCardOnChangeValue = {
     files: FileItem[];
@@ -110,7 +110,7 @@ export type UploadCardOnChangeValue = {
     payload?: FileItem | FileItem[];
 };
 /**
- * Props do componente `UploadCard`.
+ * Props of the `UploadCard` component.
  *
  * @example
  * ```tsx
@@ -125,23 +125,23 @@ export type UploadCardOnChangeValue = {
  * ```
  */
 export type UploadCardProps = {
-    /** Nome do `<input type="file">` (necessário em formulários nativos). */
+    /** Name of the `<input type="file">` (required in native forms). */
     name?: string;
     /**
-     * Variante visual compacta — linha única em vez do card grande.
+     * Compact visual variant — single row instead of the large card.
      *
      * @default false
      */
     compact?: boolean;
     /**
-     * Tipos de arquivo aceitos. Aceita extensões (`'.png'`) ou MIME-types
-     * (`'image/*'`). Itens recusados disparam `onUnsupportedFile`.
+     * Accepted file types. Accepts extensions (`'.png'`) or MIME types
+     * (`'image/*'`). Rejected items trigger `onUnsupportedFile`.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept
      */
     accept: string[];
     /**
-     * Tamanho máximo por arquivo, em bytes.
+     * Maximum size per file, in bytes.
      *
      * @default 15728640 // 15 MB
      */
@@ -149,38 +149,39 @@ export type UploadCardProps = {
     disabled?: boolean;
     readOnly?: boolean;
     /**
-     * Restringe a um único arquivo (drag/drop e dialog).
+     * Restricts to a single file (drag/drop and dialog).
      *
      * @default false
      */
     singleFile?: boolean;
-    /** Label do tipo aceito (ex.: `"PNG, JPEG, PDF"`) exibido no card. */
+    /** Label for the accepted types (e.g. `"PNG, JPEG, PDF"`) shown on the card. */
     acceptLabel?: string;
     /**
-     * Texto do botão de seleção.
+     * Text of the selection button.
      *
      * @default 'Enviar arquivos'
      */
     buttonText?: string;
-    /** Arquivos a popular no mount (útil em edição de formulários). */
+    /** Files to populate on mount (useful when editing forms). */
     initialFiles?: File | File[];
-    /** Configuração do upload — necessária para usar `ref.submit()`. */
+    /** Upload configuration — required to use `ref.submit()`. */
     uploadConfig?: UploadFileRequestConfig;
-    /** Callback disparado a cada mudança (ADD, REMOVE, UPDATE, ...). */
+    /** Callback fired on every change (ADD, REMOVE, UPDATE, ...). */
     onChange?: (value: UploadCardOnChangeValue) => void;
-    /** Callback para arquivos rejeitados por `accept` (não pelo `maxSize`). */
+    /** Callback for files rejected by `accept` (not by `maxSize`). */
     onUnsupportedFile?: (f: File) => void;
     /**
-     * Substitui o botão padrão por um customizado. Recebe utilitários para
-     * abrir o dialog, ler arquivos atuais e estado de submit.
+     * Replaces the default button with a custom one. Receives utilities to
+     * open the dialog, read the current files, and the submit state.
      */
     customButton?: (p: CustomButtonProps) => React.ReactNode;
     className?: string;
     style?: React.CSSProperties;
 };
 /**
- * Props internas passadas para os componentes de variante
- * (`UploadCardRegular`/`UploadCardCompact`). Não exposto no barrel público.
+ * Internal props passed to the variant components
+ * (`UploadCardRegular`/`UploadCardCompact`). Not exposed in the public
+ * barrel.
  */
 export type VariantProps = {
     removeFile: (id: string) => void;
@@ -188,13 +189,13 @@ export type VariantProps = {
     events?: DragEvents;
     inputFile: React.ReactNode;
 } & UploadCardProps & CustomButtonProps;
-/** Props recebidas pelos styled-components (foco em estado visual). */
+/** Props received by the styled-components (visual state focused). */
 export type VariantPropsStyle = {
     active?: boolean;
     disabled?: boolean;
     readOnly?: boolean;
 };
-/** Opções aceitas pelo hook interno `useFileState`. */
+/** Options accepted by the internal `useFileState` hook. */
 export interface useFileStateOptions {
     single?: UploadCardProps['singleFile'];
     maxSize?: UploadCardProps['maxSize'];