@apollion-dsi/core 5.2.0 → 5.4.0

package/lib/containers/Scroll/Scroll.interface.d.ts

@@ -1,20 +1,16 @@
 import { BaseContainerProps } from '../Base';
 /**
- * Props do componente {@link CustomScroll}.
+ * Props of the {@link CustomScroll} component.
  *
- * Une {@link BaseContainerProps} (factory props — altura, largura,
- * espaçamento, borda, etc.) com as props nativas de `<div>` para
- * permitir `onScroll`, `style`, `ref`, etc. `height` é a prop mais
- * relevante: define o tamanho da área visível com scroll.
+ * Combines {@link BaseContainerProps} (factory props — height, width,
+ * spacing, border, etc.) with the native `<div>` props to allow
+ * `onScroll`, `style`, `ref`, etc. `height` is the most relevant prop:
+ * it defines the size of the visible scrollable area.
  */
 export type ScrollProps = BaseContainerProps & React.ComponentPropsWithRef<'div'> & {
     /**
-     * Ref para o elemento interno que de fato rola (`Inner`), em adição ao
-     * `ref` normal — que aponta para o `Container` externo (`overflow: hidden`).
-     *
-     * Necessário para integrações que precisam observar o scroll real, como
-     * virtualizadores (`@tanstack/react-virtual`), cujo `getScrollElement` deve
-     * apontar para o nó com `overflow: scroll`, e não para o container externo.
+     * Ref to the inner node that actually scrolls — what virtualizers need
+     * as their scroll element (the outer `ref` is the clipped container).
      */
     scrollableRef?: React.Ref<HTMLDivElement>;
 };

package/lib/containers/Scroll/Scroll.style.d.ts

@@ -1,7 +1,7 @@
 /**
- * Wrapper de "máscara" do scroll: esconde a scrollbar nativa do
- * {@link Inner} usando `overflow: hidden` e `margin-right: -SCROLLBAR_WIDTH`
- * aplicado inline pelo {@link CustomScroll}.
+ * Scroll "mask" wrapper: hides the native scrollbar of {@link Inner}
+ * using `overflow: hidden` and `margin-right: -SCROLLBAR_WIDTH`
+ * applied inline by {@link CustomScroll}.
  */
 export declare const Wrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
     as?: import("styled-components").WebTarget;
@@ -11,9 +11,9 @@ export declare const Wrapper: import("styled-components/dist/types").IStyledComp
     forwardedAs?: import("styled-components").WebTarget;
 }, never>>> & string;
 /**
- * Container que efetivamente rola. Recebe `width: 100% + OS_SCROLLBAR_WIDTH`
- * inline para empurrar a scrollbar nativa para fora da área do
- * {@link Wrapper}.
+ * Container that actually scrolls. Receives `width: 100% + OS_SCROLLBAR_WIDTH`
+ * inline to push the native scrollbar outside the {@link Wrapper}
+ * area.
  */
 export declare const Inner: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
     as?: import("styled-components").WebTarget;
@@ -23,10 +23,10 @@ export declare const Inner: import("styled-components/dist/types").IStyledCompon
     forwardedAs?: import("styled-components").WebTarget;
 }, never>>> & string;
 /**
- * Indicador visual da posição do scroll. Posicionado absolutamente sobre
- * o {@link Container}; sua altura é proporcional a `clientHeight/scrollHeight`
- * e a posição vertical é controlada via `transform: translateY` aplicado
- * inline pelo {@link CustomScroll}.
+ * Visual indicator of the scroll position. Absolutely positioned over
+ * the {@link Container}; its height is proportional to `clientHeight/scrollHeight`
+ * and its vertical position is controlled via `transform: translateY` applied
+ * inline by {@link CustomScroll}.
  */
 export declare const Track: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
     as?: import("styled-components").WebTarget;
@@ -36,9 +36,9 @@ export declare const Track: import("styled-components/dist/types").IStyledCompon
     forwardedAs?: import("styled-components").WebTarget;
 }, never>>> & string;
 /**
- * Container raiz do {@link CustomScroll}. Aparece como `display: flex`
- * para deixar o {@link Wrapper} ocupar todo o espaço disponível. O
- * {@link Track} só fica visível em hover.
+ * Root container of {@link CustomScroll}. Rendered as `display: flex`
+ * so the {@link Wrapper} can take up all available space. The
+ * {@link Track} is only visible on hover.
  */
 export declare const Container: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../../factory").ApollionProps & {
     as?: import("styled-components").WebTarget;

package/lib/containers/Scroll/index.d.ts

@@ -1,11 +1,11 @@
 /**
- * Barrel público do componente `CustomScroll`.
+ * Public barrel of the `CustomScroll` component.
  *
- * Reexporta o componente principal (`CustomScroll`) e a interface de
- * props (`ScrollProps`).
+ * Re-exports the main component (`CustomScroll`) and the props interface
+ * (`ScrollProps`).
  *
- * Qualquer outro arquivo do projeto deve importar do barrel, nunca de
- * paths internos como `./Scroll` ou `./Scroll.interface`.
+ * Any other file in the project must import from the barrel, never from
+ * internal paths like `./Scroll` or `./Scroll.interface`.
  */
 export * from './Scroll';
 export * from './Scroll.interface';

package/lib/containers/Scroll/index.esm.js

@@ -1 +1 @@
-import{a}from"../../chunks/chunk-43YDIYCC.esm.js";import"../../chunks/chunk-VOJB2X7S.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-CJYWOEIJ.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-DQRYJ5SE.esm.js";import"../../chunks/chunk-NI6YLGUA.esm.js";import"../../chunks/chunk-R3TDH6EA.esm.js";import"../../chunks/chunk-WTQ4273O.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-TIIRB72W.esm.js";import"../../chunks/chunk-ZFEKT65Q.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{a as CustomScroll};
+import{a}from"../../chunks/chunk-EJ3VKFOX.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{a as CustomScroll};

package/lib/containers/index.esm.js

@@ -1 +1 @@
-import{a as i}from"../chunks/chunk-43YDIYCC.esm.js";import{a as e}from"../chunks/chunk-HQNUD24O.esm.js";import{a as m,b as p}from"../chunks/chunk-WGWNGDWB.esm.js";import"../chunks/chunk-DG6QINOD.esm.js";import{a,b,c,d,e as g}from"../chunks/chunk-WBQROY3S.esm.js";import"../chunks/chunk-LX37YG2D.esm.js";import"../chunks/chunk-FJYFRGGS.esm.js";import"../chunks/chunk-I4DTAH2F.esm.js";import"../chunks/chunk-H2KVPACE.esm.js";import"../chunks/chunk-KJYK6XCD.esm.js";import"../chunks/chunk-AIRJ6MU5.esm.js";import"../chunks/chunk-QHP63QIN.esm.js";import"../chunks/chunk-7K2OTPM3.esm.js";import"../chunks/chunk-HLQPDBH3.esm.js";import"../chunks/chunk-QF2YUOVX.esm.js";import"../chunks/chunk-T6ZB656A.esm.js";import"../chunks/chunk-VLV6QRHD.esm.js";import{b as t,c as x}from"../chunks/chunk-GK2ACFLW.esm.js";import"../chunks/chunk-RU6QRCR7.esm.js";import"../chunks/chunk-CWRWYU7D.esm.js";import"../chunks/chunk-2IJOUM4J.esm.js";import"../chunks/chunk-TG5BCBO4.esm.js";import"../chunks/chunk-UXIUHBTM.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-OVCASTEE.esm.js";import"../chunks/chunk-6X6WKZ3Y.esm.js";import"../chunks/chunk-JOKVE3IX.esm.js";import"../chunks/chunk-2ROOI4B2.esm.js";import"../chunks/chunk-2FQC32AA.esm.js";import"../chunks/chunk-UNM6DHPD.esm.js";import"../chunks/chunk-SPHHNZVP.esm.js";import"../chunks/chunk-4UWZA5FD.esm.js";import"../chunks/chunk-KQQ7V7VG.esm.js";import"../chunks/chunk-3QSPHURU.esm.js";import"../chunks/chunk-NDIYF5SX.esm.js";import"../chunks/chunk-A3OJEVGQ.esm.js";import"../chunks/chunk-KR2X2UQG.esm.js";import"../chunks/chunk-BE2JDTVA.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-HHUS4ZRO.esm.js";import{a as f}from"../chunks/chunk-OYSYDN5D.esm.js";import"../chunks/chunk-5S3TUYUP.esm.js";import"../chunks/chunk-6N52NFPT.esm.js";import"../chunks/chunk-SHKSIXNT.esm.js";import{a as h}from"../chunks/chunk-B2P5HATF.esm.js";import{a as r}from"../chunks/chunk-XD5JATJP.esm.js";import{a as o}from"../chunks/chunk-VOJB2X7S.esm.js";import"../chunks/chunk-5OKRFXLL.esm.js";import"../chunks/chunk-CJYWOEIJ.esm.js";import"../chunks/chunk-VMIXRIQ2.esm.js";import"../chunks/chunk-DQRYJ5SE.esm.js";import"../chunks/chunk-NI6YLGUA.esm.js";import"../chunks/chunk-R3TDH6EA.esm.js";import"../chunks/chunk-WTQ4273O.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-TIIRB72W.esm.js";import"../chunks/chunk-ZFEKT65Q.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{o as BaseContainer,e as Card,f as Content,i as CustomScroll,p as DefaultGridStyle,r as Flex,p as Grid,g as Notification,d as NotificationIconStyle,a as NotificationProgress,t as NotificationsProvider,h as Paper,b as ProgressContainer,c as WrapperNotificationStyle,m as setGridBreakpoints,x as useNotification};
+import{a as i}from"../chunks/chunk-EJ3VKFOX.esm.js";import{a as e}from"../chunks/chunk-7YLTH6LY.esm.js";import{a as m,b as p}from"../chunks/chunk-73MPQ5OY.esm.js";import"../chunks/chunk-DG6QINOD.esm.js";import{a,b,c,d,e as g}from"../chunks/chunk-7Y6YHVIS.esm.js";import"../chunks/chunk-IQ6MEZCJ.esm.js";import"../chunks/chunk-FUSBM77F.esm.js";import"../chunks/chunk-PR2T746R.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{b as t,c as x}from"../chunks/chunk-QXQC37K5.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-2ROOI4B2.esm.js";import"../chunks/chunk-2FQC32AA.esm.js";import"../chunks/chunk-UNM6DHPD.esm.js";import"../chunks/chunk-SPHHNZVP.esm.js";import"../chunks/chunk-4UWZA5FD.esm.js";import"../chunks/chunk-KQQ7V7VG.esm.js";import"../chunks/chunk-3QSPHURU.esm.js";import"../chunks/chunk-NDIYF5SX.esm.js";import"../chunks/chunk-A3OJEVGQ.esm.js";import"../chunks/chunk-KR2X2UQG.esm.js";import"../chunks/chunk-BE2JDTVA.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-FXR7WKA7.esm.js";import{a as f}from"../chunks/chunk-BMGVQBTB.esm.js";import"../chunks/chunk-BC24WDTC.esm.js";import"../chunks/chunk-6N52NFPT.esm.js";import"../chunks/chunk-6OXVRDS2.esm.js";import{a as h}from"../chunks/chunk-4V7LOS5Z.esm.js";import{a as r}from"../chunks/chunk-CLDPV7NK.esm.js";import{a as o}from"../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{o as BaseContainer,e as Card,f as Content,i as CustomScroll,p as DefaultGridStyle,r as Flex,p as Grid,g as Notification,d as NotificationIconStyle,a as NotificationProgress,t as NotificationsProvider,h as Paper,b as ProgressContainer,c as WrapperNotificationStyle,m as setGridBreakpoints,x as useNotification};

package/lib/dataDisplay/DataTable/DataTable.d.ts

@@ -1,18 +1,17 @@
 import React from 'react';
 import { DataTableProps } from './DataTable.interface';
 /**
- * Tabela virtualizada de alta performance para grandes volumes de dados
- * tabulares.
+ * High-performance virtualized table for large volumes of tabular data.
  *
- * Construída sobre `@tanstack/react-table` e `@tanstack/react-virtual`, suporta ordenação,
- * busca, redimensionamento, seleção de linhas, paginação visual e renderização
- * customizada de células. Use quando precisar exibir centenas/milhares de
- * registros em um único componente; para tabelas pequenas e estáticas prefira
+ * Built on `@tanstack/react-table` and `@tanstack/react-virtual`, it
+ * supports sorting, search, resizing, row selection, visual pagination, and
+ * custom cell rendering. Use it when you need to display hundreds/thousands
+ * of records in a single component; for small, static tables prefer
  * {@link Table}.
  *
- * As props `data` e `columns` devem ser memoizadas (`React.useMemo`) para que
- * a virtualização não recrie estruturas internas em cada render.
+ * The `data` and `columns` props must be memoized (`React.useMemo`) so the
+ * virtualization does not recreate internal structures on every render.
  *
- * @see {@link DataTableProps} para o detalhamento das props.
+ * @see {@link DataTableProps} for the detailed props.
  */
 export declare function DataTable<T extends Record<string, unknown>>(props: DataTableProps<T>): React.JSX.Element;

package/lib/dataDisplay/DataTable/DataTable.filters.d.ts

@@ -1,10 +1,10 @@
 /**
- * Filter UIs dos `Column.filterVariant` do `DataTable`.
+ * Filter UIs for the `DataTable`'s `Column.filterVariant`.
  *
- * Cada variant renderiza um sub-componente anchored em um `<Dropdown>`
- * popover ligado ao ícone de filter do header. Live apply — `setFilterValue`
- * dispara imediato em select (checkbox toggle), e com 200ms debounce em
- * range/text (mirror do GlobalFilter pattern).
+ * Each variant renders a sub-component anchored in a `<Dropdown>` popover
+ * tied to the header's filter icon. Live apply — `setFilterValue` fires
+ * immediately on select (checkbox toggle), and with a 200ms debounce on
+ * range/text (mirror of the GlobalFilter pattern).
  *
  * Mapping `filterVariant → builtin filterFn id` (tanstack v8.21.3):
  *
@@ -12,8 +12,8 @@
  * - `'range'`  → `'inNumberRange'`   (filterValue: `[min, max]`).
  * - `'text'`   → `'includesString'`  (filterValue: `string`, case-insensitive).
  *
- * Consumer pode override o filterFn via `Column.filterFn` (function ou
- * outro builtin string id) mantendo a UI da variant.
+ * The consumer may override the filterFn via `Column.filterFn` (function or
+ * another builtin string id) while keeping the variant's UI.
  *
  * @see ./DataTable.interface.ts (Column.filterVariant, Column.filterFn)
  * @see ../../vendors/TanstackReactTable (getFacetedRowModel + helpers)
@@ -21,8 +21,9 @@
 import React from 'react';
 import type { Column as TanstackColumn } from '../../vendors/TanstackReactTable';
 /**
- * Resolve filterFn por variant (builtin string id). Consumer pode override via
- * `Column.filterFn` no callsite — esse mapping é o fallback.
+ * Resolves the filterFn per variant (builtin string id). The consumer may
+ * override via `Column.filterFn` at the callsite — this mapping is the
+ * fallback.
  */
 export declare const VARIANT_FILTER_FN: Record<'select' | 'range' | 'text', string>;
 type FilterColumn = TanstackColumn<any, any>;
@@ -31,23 +32,23 @@ type FilterUIProps = {
     onClose: () => void;
 };
 /**
- * Multi-select via checkbox + count. Faceted unique values vêm de
- * `column.getFacetedUniqueValues()` (per-column drill-down — reflete filters
- * de outras colunas).
+ * Multi-select via checkbox + count. Faceted unique values come from
+ * `column.getFacetedUniqueValues()` (per-column drill-down — reflects the
+ * filters of other columns).
  */
 export declare const SelectFilter: ({ column }: FilterUIProps) => React.JSX.Element;
 /**
- * Range numérico. Bounds default vêm de `column.getFacetedMinMaxValues()`.
+ * Numeric range. Default bounds come from `column.getFacetedMinMaxValues()`.
  * Apply debounced 200ms.
  */
 export declare const RangeFilter: ({ column }: FilterUIProps) => React.JSX.Element;
 /**
- * Text contains (case-insensitive). Apply debounced 200ms — mirror do
+ * Text contains (case-insensitive). Apply debounced 200ms — mirror of the
  * `GlobalFilter` pattern.
  */
 export declare const TextFilter: ({ column }: FilterUIProps) => React.JSX.Element;
 /**
- * Resolve qual sub-componente renderizar pra cada variant.
+ * Resolves which sub-component to render for each variant.
  */
 export declare const filterUIForVariant: (variant: "select" | "range" | "text", column: FilterColumn, onClose: () => void) => React.ReactElement;
 export {};

package/lib/dataDisplay/DataTable/DataTable.helpers.d.ts

@@ -3,45 +3,46 @@ import { DataTableProps, GlobalFilterProps } from './DataTable.interface';
 import type { IconData } from '../../icons/icon.interface';
 import type { OnChangeFn } from '../../vendors/TanstackReactTable';
 /**
- * Wrapper de scroll customizado usado como container do `useVirtualizer`.
- * Remove a largura inline para que o cabeçalho da tabela controle a largura
- * horizontal sem conflito.
+ * Custom scroll wrapper used as the `useVirtualizer` container. Removes the
+ * inline width so the table header controls the horizontal width without
+ * conflict.
  *
- * O `useVirtualizer` deve apontar seu `getScrollElement` para o nó que
- * realmente rola (o `Inner` do `CustomScroll`, `overflow: scroll`) — não para
- * o `Container` externo (`overflow: hidden`). Por isso o `scrollableRef` é
- * repassado ao `CustomScroll`, que o anexa ao `Inner`.
+ * The `useVirtualizer` must point its `getScrollElement` to the node that
+ * actually scrolls (the `CustomScroll`'s `Inner`, `overflow: scroll`) — not
+ * to the outer `Container` (`overflow: hidden`). That is why the
+ * `scrollableRef` is forwarded to the `CustomScroll`, which attaches it to
+ * the `Inner`.
  */
 export declare const VitualScrollbar: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
     scrollableRef?: React.Ref<HTMLDivElement>;
 } & React.RefAttributes<HTMLDivElement>>;
 /**
- * Handle de redimensionamento exibido na borda direita do cabeçalho de cada
- * coluna. Encapsulado para que o `DataTable` possa anexar handlers do
- * `react-table` sem mexer no estilo bruto.
+ * Resize handle shown on the right edge of each column header.
+ * Encapsulated so the `DataTable` can attach `react-table` handlers without
+ * touching the raw style.
  */
 export declare const ResizeHandle: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 /**
- * Resolve o nome do ícone de ordenação a exibir no cabeçalho.
+ * Resolves which sort icon to display in the header.
  *
- * `sortUp` para ascendente, `sortDown` para descendente, `sort` (neutro)
- * quando a coluna não está ordenada.
+ * `sortUp` for ascending, `sortDown` for descending, `sort` (neutral) when
+ * the column is not sorted.
  */
 export declare const getSortIcon: (sortState: "asc" | "desc" | false) => IconData;
 /**
- * Constrói a definição da coluna de toggle de expand (tree mode) para o
+ * Builds the expand-toggle column definition (tree mode) for
  * `@tanstack/react-table`.
  *
- * Mirror do `buildSelectableColumnDef` pattern. Cell renderiza chevron-down
- * quando expandida, chevron-right quando colapsada, ou `null` quando
- * `row.getCanExpand()` é falso (linha-folha, sem sub-rows).
+ * Mirror of the `buildSelectableColumnDef` pattern. The cell renders
+ * chevron-down when expanded, chevron-right when collapsed, or `null` when
+ * `row.getCanExpand()` is false (leaf row, no sub-rows).
  *
- * O `marginLeft: row.depth * 16` indenta o chevron conforme profundidade
- * — sub-rows ficam visualmente alinhadas ao parent sem mexer no alinhamento
- * das colunas de dados (que mantêm posição fixa).
+ * The `marginLeft: row.depth * 16` indents the chevron by depth — sub-rows
+ * stay visually aligned with the parent without disturbing the data
+ * columns' alignment (which keep a fixed position).
  *
- * Retorna `null` quando `enabled` é falso, permitindo spread condicional
- * no `tanstackColumns` memo do DataTable.
+ * Returns `null` when `enabled` is false, allowing conditional spread in
+ * the DataTable's `tanstackColumns` memo.
  */
 export declare function buildExpandColumnDef<T extends Record<string, unknown>>(enabled: boolean, width?: number): {
     id: string;
@@ -56,12 +57,12 @@ export declare function buildExpandColumnDef<T extends Record<string, unknown>>(
     };
 };
 /**
- * Constrói a definição de coluna do checkbox de seleção para o
+ * Builds the selection-checkbox column definition for
  * `@tanstack/react-table`.
  *
- * Retorna `null` quando a coluna não deve ser exibida — assim o
- * `DataTable` consegue spread `[selectableCol, ...cols]` de forma condicional
- * sem lógica extra no call-site.
+ * Returns `null` when the column must not be displayed — so the `DataTable`
+ * can spread `[selectableCol, ...cols]` conditionally with no extra
+ * call-site logic.
  */
 export declare function buildSelectableColumnDef<T extends Record<string, unknown>>(selectableColumnTitle?: string | boolean, width?: number): {
     id: string;
@@ -76,38 +77,42 @@ export declare function buildSelectableColumnDef<T extends Record<string, unknow
     };
 };
 /**
- * Input de busca global do `DataTable`.
+ * The `DataTable`'s global search input.
  *
- * Mantém estado local sincronizado com debounce de 200ms para evitar
- * recálculos do filtro a cada caractere digitado.
+ * Keeps local state synchronized with a 200ms debounce to avoid filter
+ * recomputation on every typed character.
  */
 export declare const GlobalFilter: ({ globalFilter, setGlobalFilter, placeholder }: GlobalFilterProps) => React.JSX.Element;
 /**
- * Estado vazio exibido quando `data` (após filtros) é vazio.
+ * Empty state displayed when `data` (after filters) is empty.
  *
- * Aceita ícone/título/descrição customizados via props do `DataTable`. Os
- * defaults atendem ao caso geral de "nada foi encontrado".
+ * Accepts a custom icon/title/description via `DataTable` props. The
+ * defaults cover the general "nothing found" case.
  */
 export declare const EmptyTable: ({ height, emptyIcon, emptyTitle, emptyDescription, }: Partial<DataTableProps<any>>) => React.JSX.Element;
 /**
- * Unifica controlled e uncontrolled state em uma única abstração — `[value,
- * setValue]` no callsite, sem branching.
+ * Unifies controlled and uncontrolled state in a single abstraction —
+ * `[value, setValue]` at the callsite, no branching.
  *
- * - **Controlled mode:** `controlled !== undefined`. `value` é `controlled`,
- *   updates disparam `onControlledChange` (não tocam o state interno).
- * - **Uncontrolled mode:** `controlled === undefined`. `value` vem do useState
- *   interno, updates chamam `setUncontrolled`. `onControlledChange` (se
- *   fornecido em modo uncontrolled) ainda é chamado para observação.
+ * - **Controlled mode:** `controlled !== undefined`. `value` is
+ *   `controlled`, updates fire `onControlledChange` (they do not touch the
+ *   internal state).
+ * - **Uncontrolled mode:** `controlled === undefined`. `value` comes from
+ *   the internal useState, updates call `setUncontrolled`.
+ *   `onControlledChange` (if provided in uncontrolled mode) is still called
+ *   for observation.
  *
- * Decisão controlled/uncontrolled é fixada na primeira render — alternar em
- * renders subsequentes é anti-pattern e o helper não cobre esse caso (mesma
- * restrição que React impõe sobre inputs controlados/não-controlados).
+ * The controlled/uncontrolled decision is fixed on the first render —
+ * switching on subsequent renders is an anti-pattern and the helper does not
+ * cover that case (same restriction React imposes on
+ * controlled/uncontrolled inputs).
  *
- * @param controlled         Estado controlado (ou `undefined` para uncontrolled).
- * @param onControlledChange Callback do estado controlado.
- * @param initial            Valor inicial ou factory.
- * @returns `[value, setValue]` análogo a `useState`, mas com setValue aceitando
- *          updater function (compat com tanstack `OnChangeFn`).
+ * @param controlled         Controlled state (or `undefined` for uncontrolled).
+ * @param onControlledChange Controlled-state callback.
+ * @param initial            Initial value or factory.
+ * @returns `[value, setValue]` analogous to `useState`, but with setValue
+ *          accepting an updater function (compatible with tanstack
+ *          `OnChangeFn`).
  */
 export declare function useHybridState<T>(controlled: T | undefined, onControlledChange: OnChangeFn<T> | undefined, initial: T | (() => T)): [T, (updater: T | ((prev: T) => T)) => void];
 type PaginationControlsProps = {
@@ -123,20 +128,20 @@ type PaginationControlsProps = {
     onPageSizeChange: (size: number) => void;
 };
 /**
- * Linha de navegação de paginação do `DataTable`.
+ * The `DataTable`'s pagination navigation row.
  *
- * Renderiza, da esquerda pra direita:
- * - Texto "Mostrando X-Y de Z" (range visível na página atual).
- * - Seletor de page size (`Dropdown`) — só aparece quando
+ * Renders, left to right:
+ * - "Mostrando X-Y de Z" text (visible range on the current page).
+ * - Page size selector (`Dropdown`) — only shows when
  *   `pageSizeOptions.length > 1`.
- * - Botão `Anterior` (linked) + indicador `pageIndex+1 / pageCount` + botão
- *   `Próximo` (linked).
+ * - `Anterior` button (linked) + `pageIndex+1 / pageCount` indicator +
+ *   `Próximo` button (linked).
  *
- * Estado é totalmente derivado das props — o componente é puro. O wiring
- * do tanstack-react-table vive em `DataTable.tsx`.
+ * State is fully derived from the props — the component is pure. The
+ * tanstack-react-table wiring lives in `DataTable.tsx`.
  *
- * Strings hardcoded em PT-BR — Apollion não tem i18n layer hoje (consistente
- * com `EmptyTable` que usa `"Nada foi encontrado"` default).
+ * Strings hardcoded in pt-BR — Apollion has no i18n layer today (consistent
+ * with `EmptyTable`, which uses the `"Nada foi encontrado"` default).
  */
 export declare const PaginationControls: ({ pageIndex, pageSize, pageCount, rowCount, canPreviousPage, canNextPage, pageSizeOptions, onPrevious, onNext, onPageSizeChange, }: PaginationControlsProps) => React.JSX.Element;
 export {};