@apollion-dsi/core 5.3.0 → 5.4.0

package/lib/factory/FlexFactory/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * Barrel público do módulo `FlexFactory`.
+ * Public barrel for the `FlexFactory` module.
  *
- * Reexporta a fábrica (`FlexFactory`), `flexKeys` e os tipos de props
- * principais. Demais tokens auxiliares (ex.: `FlexDirection`) ficam internos
- * — exporte aqui caso passem a ser usados fora.
+ * Re-exports the factory (`FlexFactory`), `flexKeys`, and the main prop
+ * types. Other auxiliary tokens (e.g. `FlexDirection`) remain internal —
+ * export them here if they start being used elsewhere.
  */
 export * from './FlexFactory';
 export type { FlexThemeProps, FlexFactoryProps } from './FlexFactory.interface';

package/lib/factory/FontFactory/FontFactory.d.ts

@@ -1,17 +1,17 @@
 import { FontFactoryProps, FontThemePropsType } from './FontFactory.interface';
 import { CSSObject } from '../../vendors/StyledComponents';
 /**
- * Chaves de prop controladas pelo `FontFactory`.
+ * Prop keys controlled by `FontFactory`.
  *
- * Consumida pelo `System` para impedir vazamento dessas props para o DOM.
+ * Consumed by the `System` to prevent these props from leaking to the DOM.
  */
 export declare const fontKeys: Array<keyof FontFactoryProps>;
 /**
- * Fábrica de estilos tipográficos.
+ * Typographic style factory.
  *
- * Resolve cada token através do slice `theme.font.*` correspondente — isso
- * permite que componentes referenciem "tamanhos semânticos" (ex.: `sm`,
- * `md`, `xl`) em vez de valores literais em px/rem.
+ * Resolves each token through the corresponding `theme.font.*` slice — this
+ * lets components reference "semantic sizes" (e.g. `sm`, `md`, `xl`) instead
+ * of literal px/rem values.
  *
  * @example
  * ```ts

package/lib/factory/FontFactory/FontFactory.interface.d.ts

@@ -1,31 +1,31 @@
 import { FontThemeInterface } from '../../themes/Font';
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Estratégias de quebra de palavra.
+ * Word-breaking strategies.
  *
- * - `normal`: comportamento padrão do navegador.
- * - `words`: quebra entre palavras (overflow-wrap: break-word).
- * - `all`: quebra dentro de palavras se necessário (word-break: break-all).
+ * - `normal`: the browser's default behavior.
+ * - `words`: breaks between words (overflow-wrap: break-word).
+ * - `all`: breaks inside words if necessary (word-break: break-all).
  */
 export type WordBreakType = 'normal' | 'words' | 'all';
 /**
- * Presets de legibilidade sobre fundos não-sólidos.
+ * Legibility presets over non-solid backgrounds.
  *
- * - `on-photo`: sombra de leitura para texto sobre fundo fotográfico ou
- *   ilustrado (nome sobre gramado, legenda sobre imagem). Preset fechado —
- *   não é um `textShadow` livre — para manter o conjunto sob controle visual
- *   (mesma filosofia do `opacity` semântico do ColorFactory).
+ * - `on-photo`: reading shadow for text over a photographic or illustrated
+ *   background (a name over grass, a caption over an image). Closed preset —
+ *   not a free-form `textShadow` — to keep the set under visual control
+ *   (same philosophy as ColorFactory's semantic `opacity`).
  */
 export type LegibilityType = 'on-photo';
 /**
- * Props consumidas pelo `FontFactory`.
+ * Props consumed by `FontFactory`.
  *
- * As chaves tokenizadas (fontSize, fontWeight, fontFamily, letterSpacing,
- * lineHeight, fontStyle, textTransform) referenciam o slice `theme.font` —
- * ou seja, são chaves de cada sub-objeto do tema (não valores CSS livres).
+ * The tokenized keys (fontSize, fontWeight, fontFamily, letterSpacing,
+ * lineHeight, fontStyle, textTransform) reference the `theme.font` slice —
+ * i.e. they are keys of each theme sub-object (not free-form CSS values).
  *
- * As demais chaves (`textAlign`, `textDecoration`, `whiteSpace`, `wordBreak`)
- * são CSS direto, mantendo o nível baixo onde tokenização não traz ganho.
+ * The remaining keys (`textAlign`, `textDecoration`, `whiteSpace`,
+ * `wordBreak`) are direct CSS, staying low-level where tokenization brings no gain.
  */
 export type FontFactoryProps = Partial<{
     [K in keyof Omit<FontThemeInterface, 'fontSizePx'>]: keyof FontThemeInterface[K];
@@ -35,10 +35,10 @@ export type FontFactoryProps = Partial<{
     whiteSpace: 'normal' | 'pre' | 'nowrap' | 'pre-wrap' | 'pre-line' | 'break-spaces';
     wordBreak: WordBreakType;
     /**
-     * Preset de sombra de leitura para texto sobre fundo fotográfico
-     * (`on-photo`). Substitui o `style={{ textShadow }}` inline no consumidor
-     * (radar brasil_2030, gap A3). Emissão em tokens fica adiada até um 2º
-     * consumidor pedir a var crua (ver backlog).
+     * Reading-shadow preset for text over a photographic background
+     * (`on-photo`). Replaces the inline `style={{ textShadow }}` in the
+     * consumer (brasil_2030 radar, gap A3). Token emission is deferred until a
+     * 2nd consumer asks for the raw var (see backlog).
      */
     legibility: LegibilityType;
 }>;

package/lib/factory/FontFactory/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel público do módulo `FontFactory`.
+ * Public barrel for the `FontFactory` module.
  *
- * Reexporta a fábrica (`FontFactory`), `fontKeys` e os tipos auxiliares
- * (`FontFactoryProps`, `WordBreakType`).
+ * Re-exports the factory (`FontFactory`), `fontKeys`, and the auxiliary
+ * types (`FontFactoryProps`, `WordBreakType`).
  */
 export * from './FontFactory';
 export * from './FontFactory.interface';

package/lib/factory/ResponsiveFactory/ResponsiveFactory.d.ts

@@ -2,20 +2,20 @@ import { ResponsiveProps } from './ResponsiveFactory.interface';
 import { WithTheme } from '../../themes/ThemeProvider';
 import { CSSObject } from '../../vendors/StyledComponents';
 /**
- * Fábrica que materializa props prefixadas por breakpoint (`sm_*`, `md_*`,
- * `lg_*`, `xl_*`) em media queries `@media (min-width: ...)`.
+ * Factory that materializes breakpoint-prefixed props (`sm_*`, `md_*`,
+ * `lg_*`, `xl_*`) into `@media (min-width: ...)` media queries.
  *
- * Algoritmo:
- * 1. Sai cedo se `ignoreResponsive` estiver ligado.
- * 2. Particiona as props em `mediaProps[breakpoint]` agrupando por prefixo.
- * 3. Se `enableBreakpoint` for informado, mescla aquele grupo no estilo base.
- * 4. Para cada breakpoint, gera uma media query com `theme.breakpoints.up(bp)`
- *    e aplica o conjunto de fábricas via `getStyles`.
+ * Algorithm:
+ * 1. Bails early when `ignoreResponsive` is on.
+ * 2. Partitions the props into `mediaProps[breakpoint]`, grouping by prefix.
+ * 3. When `enableBreakpoint` is provided, merges that group into the base style.
+ * 4. For each breakpoint, generates a media query with `theme.breakpoints.up(bp)`
+ *    and applies the factory set via `getStyles`.
  *
  * @example
  * ```tsx
  * <Box padding="sm" sm_padding="md" lg_padding="xl">
- *   Padding cresce com o tamanho da viewport.
+ *   Padding grows with the viewport size.
  * </Box>
  * ```
  */

package/lib/factory/ResponsiveFactory/ResponsiveFactory.interface.d.ts

@@ -9,34 +9,34 @@ import { FontFactoryProps } from '../FontFactory';
 import { SizeFactoryProps } from '../SizeFactory';
 import { SpacingFactoryProps } from '../SpacingFactory';
 /**
- * Utilitário que produz a versão "responsiva" de qualquer conjunto de props.
+ * Utility that produces the "responsive" version of any prop set.
  *
- * Para cada chave `K` do tipo `T`, emite quatro novas chaves prefixadas com
- * o breakpoint: `sm_K`, `md_K`, `lg_K`, `xl_K`. Isso permite escrever, por
- * exemplo, `sm_padding="md"` num componente para aplicar `padding` somente em
- * telas a partir do breakpoint `sm`.
+ * For each key `K` of type `T`, it emits four new keys prefixed with the
+ * breakpoint: `sm_K`, `md_K`, `lg_K`, `xl_K`. This allows writing, for
+ * example, `sm_padding="md"` on a component to apply `padding` only on
+ * screens from the `sm` breakpoint up.
  */
 export type Responsive<T = Record<string, any>> = {
     [K in keyof T as `sm_${string & K}` | `md_${string & K}` | `lg_${string & K}` | `xl_${string & K}`]: T[K];
 };
 /**
- * Conjunto agregado das props responsivas suportadas pela Apollion.
+ * Aggregated set of the responsive props supported by Apollion.
  *
- * Combina as variantes `sm_/md_/lg_/xl_` de todas as fábricas (Flex, Border,
- * Background, Color, Container, Deep, Font, Size, Spacing). É a forma de
- * estender qualquer componente styled para suportar breakpoints sem precisar
- * declarar cada combinação manualmente.
+ * Combines the `sm_/md_/lg_/xl_` variants of every factory (Flex, Border,
+ * Background, Color, Container, Deep, Font, Size, Spacing). It is the way to
+ * extend any styled component with breakpoint support without declaring each
+ * combination manually.
  */
 export interface ResponsiveProps extends Responsive<FlexFactoryProps>, Responsive<BorderFactoryProps>, Responsive<BackgroundFactoryProps>, Responsive<ColorFactoryProps>, Responsive<ContainerFactoryProps>, Responsive<DeepFactoryProps>, Responsive<FontFactoryProps>, Responsive<SizeFactoryProps>, Responsive<SpacingFactoryProps> {
     /**
-     * Quando `true`, desliga completamente a fábrica responsiva (útil em testes
-     * ou em componentes que querem mostrar um único snapshot fixo).
+     * When `true`, fully disables the responsive factory (useful in tests or
+     * in components that want to show a single fixed snapshot).
      */
     ignoreResponsive?: boolean;
     /**
-     * Força a aplicação de um conjunto de props como se o breakpoint indicado
-     * estivesse ativo, independentemente do tamanho real da viewport. Útil para
-     * stories/storyshots ou para previews controlados.
+     * Forces a prop set to apply as if the given breakpoint were active,
+     * regardless of the actual viewport size. Useful for stories/storyshots or
+     * controlled previews.
      */
     enableBreakpoint?: BreakpointTypes;
 }

package/lib/factory/ResponsiveFactory/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel público do módulo `ResponsiveFactory`.
+ * Public barrel for the `ResponsiveFactory` module.
  *
- * Reexporta a fábrica (`ResponsiveFactory`) e os tipos `ResponsiveProps` /
- * `Responsive<T>`. Importações externas devem entrar por aqui.
+ * Re-exports the factory (`ResponsiveFactory`) and the `ResponsiveProps` /
+ * `Responsive<T>` types. External imports should enter through here.
  */
 export * from './ResponsiveFactory';
 export * from './ResponsiveFactory.interface';

package/lib/factory/ResponsiveFactory/index.esm.js

@@ -1 +1 @@
-import{a}from"../../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-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-GZONWSRB.esm.js";export{a as ResponsiveFactory};
+import{a}from"../../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-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-GZONWSRB.esm.js";export{a as ResponsiveFactory};

package/lib/factory/SizeFactory/SizeFactory.d.ts

@@ -1,19 +1,19 @@
 import { SizeFactoryProps } from './SizeFactory.interface';
 import { CSSObject } from '../../vendors/StyledComponents';
 /**
- * Chaves de prop controladas pelo `SizeFactory`.
+ * Prop keys controlled by the `SizeFactory`.
  *
- * Consumida pelo `System` para impedir vazamento dessas props para o DOM.
+ * Consumed by the `System` to prevent these props from leaking to the DOM.
  *
- * Embora `SizeThemeProps` exista, este factory não acessa o tema — por isso
- * o callback aceita um objeto vazio como padrão.
+ * Although `SizeThemeProps` exists, this factory does not access the theme —
+ * which is why the callback accepts an empty object as default.
  */
 export declare const sizeKeys: Array<keyof SizeFactoryProps>;
 /**
- * Fábrica de estilos de dimensão (`width`/`height` + min/max).
+ * Dimension style factory (`width`/`height` + min/max).
  *
- * Apenas mescla `customProps` com `contextProps` e retorna como CSSObject —
- * sem tokenização. É o factory mais simples do conjunto.
+ * Simply merges `customProps` with `contextProps` and returns them as a
+ * CSSObject — no tokenization. It is the simplest factory of the set.
  *
  * @example
  * ```ts

package/lib/factory/SizeFactory/SizeFactory.interface.d.ts

@@ -1,13 +1,13 @@
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Props consumidas pelo `SizeFactory`.
+ * Props consumed by the `SizeFactory`.
  *
- * Lida apenas com dimensões "puras" (não tokenizadas) — qualquer string CSS
- * válida (`'100%'`, `'24rem'`, `'fit-content'`) ou número (interpretado como
- * pixels pelo styled-components).
+ * Deals only with "pure" (non-tokenized) dimensions — any valid CSS string
+ * (`'100%'`, `'24rem'`, `'fit-content'`) or number (interpreted as pixels by
+ * styled-components).
  *
- * Tokenização (ex.: `xl`, `xxl`) é responsabilidade do `SpacingFactory` para
- * margens/paddings, não desta fábrica.
+ * Tokenization (e.g. `xl`, `xxl`) is the `SpacingFactory`'s responsibility
+ * for margins/paddings, not this factory's.
  */
 export interface SizeFactoryProps {
     width?: string | number;
@@ -18,9 +18,9 @@ export interface SizeFactoryProps {
     minHeight?: string | number;
 }
 /**
- * Variante de `SizeFactoryProps` com `theme` injetado pelo `ThemeProvider`.
+ * Variant of `SizeFactoryProps` with `theme` injected by the `ThemeProvider`.
  *
- * Apesar de o `SizeFactory` não usar o tema diretamente, este alias é mantido
- * por consistência com as demais fábricas.
+ * Although the `SizeFactory` does not use the theme directly, this alias is
+ * kept for consistency with the other factories.
  */
 export type SizeThemeProps = WithTheme<SizeFactoryProps>;

package/lib/factory/SizeFactory/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * Barrel público do módulo `SizeFactory`.
+ * Public barrel for the `SizeFactory` module.
  *
- * Reexporta a fábrica (`SizeFactory`), `sizeKeys` e o tipo `SizeFactoryProps`.
+ * Re-exports the factory (`SizeFactory`), `sizeKeys`, and the `SizeFactoryProps` type.
  */
 export * from './SizeFactory';
 export * from './SizeFactory.interface';

package/lib/factory/SpacingFactory/SpacingFactory.d.ts

@@ -1,17 +1,18 @@
 import { SpacingFactoryProps, SpacingKeysTypes, SpacingThemeProps } from './SpacingFactory.interface';
 import { CSSObject } from '../../vendors/StyledComponents';
 /**
- * Chaves de prop controladas pelo `SpacingFactory`.
+ * Prop keys controlled by the `SpacingFactory`.
  *
- * Consumida pelo `System` para impedir vazamento dessas props para o DOM.
+ * Consumed by the `System` to prevent these props from leaking to the DOM.
  */
 export declare const spacingKeys: SpacingKeysTypes[];
 /**
- * Fábrica de margens e paddings tokenizadas.
+ * Factory for tokenized margins and paddings.
  *
- * Itera sobre as props recebidas, valida que pertencem a `spacingKeys`,
- * resolve o valor pelo `theme.spacing()` e materializa em uma ou duas
- * propriedades CSS (uma para chaves direcionais, duas para `x`/`y`).
+ * Iterates over the received props, validates that they belong to
+ * `spacingKeys`, resolves the value through `theme.spacing()` and
+ * materializes it into one or two CSS properties (one for directional keys,
+ * two for `x`/`y`).
  *
  * @example
  * ```tsx

package/lib/factory/SpacingFactory/SpacingFactory.interface.d.ts

@@ -1,25 +1,25 @@
 import { SpacingInterface } from '../../themes/Spacing';
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Conjunto canônico de atalhos de spacing aceitos pela Apollion.
+ * Canonical set of spacing shorthands accepted by Apollion.
  *
- * Inspirado em frameworks utilitários: a primeira letra indica o tipo
- * (`m` margin / `p` padding) e a segunda indica o lado:
- * - sem letra → todos os lados.
+ * Inspired by utility-first frameworks: the first letter indicates the type
+ * (`m` margin / `p` padding) and the second indicates the side:
+ * - no letter → all sides.
  * - `t/r/b/l` → top/right/bottom/left.
  * - `x` → left + right.
  * - `y` → top + bottom.
  */
 export type SpacingKeysTypes = 'm' | 'mt' | 'mr' | 'mb' | 'ml' | 'mx' | 'my' | 'p' | 'pt' | 'pr' | 'pb' | 'pl' | 'px' | 'py';
 /**
- * Props consumidas pelo `SpacingFactory`.
+ * Props consumed by `SpacingFactory`.
  *
- * Cada chave aceita um token da escala `SpacingInterface` definida pelo tema
- * (`xs`, `sm`, `md`, ...). Manter tokens (em vez de números/strings livres)
- * garante ritmo visual consistente entre componentes.
+ * Each key accepts a token from the `SpacingInterface` scale defined by the
+ * theme (`xs`, `sm`, `md`, ...). Keeping tokens (rather than free
+ * numbers/strings) ensures consistent visual rhythm across components.
  */
 export type SpacingFactoryProps = Partial<Record<SpacingKeysTypes, SpacingInterface>>;
 /**
- * Variante de `SpacingFactoryProps` com `theme` injetado pelo `ThemeProvider`.
+ * Variant of `SpacingFactoryProps` with `theme` injected by `ThemeProvider`.
  */
 export type SpacingThemeProps = WithTheme<SpacingFactoryProps>;

package/lib/factory/SpacingFactory/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel público do módulo `SpacingFactory`.
+ * Public barrel for the `SpacingFactory` module.
  *
- * Reexporta a fábrica (`SpacingFactory`), `spacingKeys` e os tipos
- * `SpacingFactoryProps` / `SpacingKeysTypes`.
+ * Re-exports the factory (`SpacingFactory`), `spacingKeys`, and the
+ * `SpacingFactoryProps` / `SpacingKeysTypes` types.
  */
 export * from './SpacingFactory';
 export * from './SpacingFactory.interface';

package/lib/factory/System/System.d.ts

@@ -1,30 +1,40 @@
 import { Apollion, Styled } from './System.interface';
 /**
- * Predicado usado por `withConfig({ shouldForwardProp })`.
+ * Predicate used by `withConfig({ shouldForwardProp })`.
  *
- * Bloqueia tanto props customizadas da Apollion quanto qualquer prop que não
- * seja um atributo HTML conhecido (`isPropValid` cobre o catálogo do React).
- * Isso evita warnings tipo "unknown prop on DOM element" em desenvolvimento.
+ * Blocks both Apollion custom props and any prop that is not a known HTML
+ * attribute (`isPropValid` covers React's catalog). This avoids "unknown
+ * prop on DOM element"-style warnings in development.
  *
- * Exportado como base do `shouldForwardDimensionAttrs`, usado por elementos que
- * precisam reintroduzir `width`/`height` no DOM.
+ * Exported as the base for `shouldForwardDimensionAttrs`, used by elements
+ * that need to reintroduce `width`/`height` into the DOM.
  */
 export declare const shouldForwardProp: (prop: string) => boolean;
 export declare const shouldForwardDimensionAttrs: (prop: string) => boolean;
 /**
- * Wrapper sobre `styled-components` pré-configurado com `shouldForwardProp`.
+ * Wrapper over `styled-components` pre-configured with `shouldForwardProp`.
  *
- * Use este `styled` em vez do importado diretamente de `styled-components`
- * em qualquer componente da Apollion — assim props customizadas (variantes,
- * fábricas) ficam isoladas do DOM sem precisar configurar nada por componente.
+ * Use this `styled` instead of the one imported directly from
+ * `styled-components` in any Apollion component — custom props (variants,
+ * factories) stay isolated from the DOM without per-component configuration.
+ *
+ * SSR note: components built through this wrapper must pin an explicit
+ * `componentId` (`.withConfig({ componentId: 'apollion-<name>' })`).
+ * `babel-plugin-styled-components` (run at build time, see
+ * `esbuild-styled-components.js`, ADR-017) does not reliably bake an id for this
+ * factory binding — it is aliased/mixed with the vendor `styled` across files —
+ * so without an explicit id styled-components falls back to its process-global
+ * counter, which diverges between a consumer's SSR and client bundles and breaks
+ * hydration. Direct `vendors/StyledComponents` imports are baked by the plugin
+ * and need no manual id.
  */
 export declare const styled: Styled;
 /**
- * Objeto de atalhos pré-styled — equivalente a `styled.div`, `styled.a`, ...
- * porém já com todas as fábricas da Apollion aplicadas.
+ * Pre-styled shortcut object — equivalent to `styled.div`, `styled.a`, ...
+ * but with all Apollion factories already applied.
  *
- * Adicionar ou remover fábricas em `buildElement` muda o conjunto de props
- * disponível em todos os elementos `apollion.*`.
+ * Adding or removing factories in `buildElement` changes the prop set
+ * available on every `apollion.*` element.
  *
  * @example
  * ```tsx

package/lib/factory/System/System.interface.d.ts

@@ -11,38 +11,38 @@ import { ResponsiveProps } from '../ResponsiveFactory';
 import { SizeFactoryProps } from '../SizeFactory';
 import { SpacingFactoryProps } from '../SpacingFactory';
 /**
- * Elemento base aceito por `styled(...)`.
+ * Base element accepted by `styled(...)`.
  *
- * Pode ser uma tag HTML intrínseca (string-key de `JSX.IntrinsicElements`) ou
- * um componente React qualquer — permite encadear `styled(Component)` para
- * extensões.
+ * Can be an intrinsic HTML tag (string-key of `JSX.IntrinsicElements`) or
+ * any React component — enables chaining `styled(Component)` for
+ * extensions.
  */
 export type StyledComponent = React.JSX.IntrinsicElements | React.ComponentType<any>;
 export type { Styled };
 /**
- * Tipo agregado de TODAS as props aceitas por elementos `apollion.*`.
+ * Aggregate type of ALL props accepted by `apollion.*` elements.
  *
- * É a "linha base" usada por componentes que se apoiam no sistema styled da
- * Apollion (`apollion.div`, `Base`, `Text`, etc.) — eles herdam este tipo
- * para expor o conjunto completo de tokens visuais e variantes responsivas
- * sem precisar redeclarar cada chave.
+ * This is the "baseline" used by components that rely on Apollion's styled
+ * system (`apollion.div`, `Base`, `Text`, etc.) — they extend this type
+ * to expose the full set of visual tokens and responsive variants without
+ * having to redeclare each key.
  */
 export interface ApollionProps extends SpacingFactoryProps, SizeFactoryProps, ContainerFactoryProps, FontFactoryProps, ColorFactoryProps, BorderFactoryProps, DeepFactoryProps, BackgroundFactoryProps, FlexFactoryProps, ResponsiveProps {
 }
 /**
- * Conjunto de tags HTML expostas como atalhos pelo objeto `apollion`.
+ * Set of HTML tags exposed as shortcuts by the `apollion` object.
  *
- * Lista intencionalmente curta — privilegia os elementos com semântica mais
- * usada no design system. Outros elementos podem ser obtidos via
- * `styled('tagname')` diretamente.
+ * Intentionally short list — favors the elements with the most-used
+ * semantics in the design system. Other elements can be obtained via
+ * `styled('tagname')` directly.
  */
 export type ApollionElements = 'a' | 'div' | 'input' | 'span' | 'button';
 /**
- * Shape do objeto `apollion` exportado por este módulo.
+ * Shape of the `apollion` object exported by this module.
  *
- * Cada chave (`a`, `div`, ...) é um componente styled-components tipado para
- * aceitar tanto os atributos HTML nativos do elemento quanto o conjunto
- * agregado `ApollionProps`.
+ * Each key (`a`, `div`, ...) is a styled-components component typed to
+ * accept both the element's native HTML attributes and the aggregate
+ * `ApollionProps` set.
  */
 export type Apollion = {
     [E in ApollionElements]: IStyledComponent<'web', React.JSX.IntrinsicElements[E] & ApollionProps>;

package/lib/factory/System/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel público do módulo `System`.
+ * Public barrel for the `System` module.
  *
- * Reexporta o objeto `apollion`, o `styled` pré-configurado e os tipos
- * agregados (`ApollionProps`, `ApollionElements`, `Apollion`,
+ * Re-exports the `apollion` object, the pre-configured `styled`, and the
+ * aggregate types (`ApollionProps`, `ApollionElements`, `Apollion`,
  * `StyledComponent`).
  */
 export * from './System';

package/lib/factory/System/index.esm.js

@@ -1 +1 @@
-import{a,b,c,d}from"../../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{d as apollion,b as shouldForwardDimensionAttrs,a as shouldForwardProp,c as styled};
+import{a,b,c,d}from"../../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{d as apollion,b as shouldForwardDimensionAttrs,a as shouldForwardProp,c as styled};

package/lib/factory/index.d.ts

@@ -1,13 +1,14 @@
 /**
- * Barrel público do conjunto de fábricas (Style Factories) da Apollion.
+ * Public barrel for Apollion's set of Style Factories.
  *
- * Reúne todas as fábricas que transformam props customizadas em CSS — uma
- * por dimensão visual (Background, Border, Color, Container, Deep, Flex,
- * Font, Size, Spacing) + a fábrica de breakpoints (`ResponsiveFactory`) e o
- * `System`, que monta o objeto `apollion.*` e o `styled` pré-configurado.
+ * Gathers all the factories that transform custom props into CSS — one per
+ * visual dimension (Background, Border, Color, Container, Deep, Flex,
+ * Font, Size, Spacing) + the breakpoints factory (`ResponsiveFactory`) and
+ * the `System`, which assembles the `apollion.*` object and the
+ * pre-configured `styled`.
  *
- * Importações externas devem entrar por este barrel — nunca por paths
- * internos (`./BackgroundFactory/BackgroundFactory`).
+ * External imports must come through this barrel — never through internal
+ * paths (`./BackgroundFactory/BackgroundFactory`).
  */
 export * from './BackgroundFactory';
 export * from './BorderFactory';

package/lib/factory/index.esm.js

@@ -1 +1 @@
-import"../chunks/chunk-5OKRFXLL.esm.js";import{a as v,b as w,c as x,d as y}from"../chunks/chunk-JYROOJRO.esm.js";import"../chunks/chunk-VMIXRIQ2.esm.js";import{a as u}from"../chunks/chunk-MBYC37CX.esm.js";import{a as i,b as j}from"../chunks/chunk-NI6YLGUA.esm.js";import{a as k,b as l}from"../chunks/chunk-OZIEVLUR.esm.js";import"../chunks/chunk-FJUISCKG.esm.js";import{a as o,b as p}from"../chunks/chunk-RZDVS7AY.esm.js";import{a as m,b as n}from"../chunks/chunk-IK5Z5C2R.esm.js";import{a as q,b as r}from"../chunks/chunk-BNB3KNKE.esm.js";import{a as s,b as t}from"../chunks/chunk-OXQA5WD3.esm.js";import{a,b}from"../chunks/chunk-A6Z2M2XU.esm.js";import{a as c,b as d,c as e,d as f}from"../chunks/chunk-RWLJNXLX.esm.js";import{a as g,b as h}from"../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{b as BackgroundFactory,f as BorderFactory,d as BorderRoundSemantic,e as BorderSemantic,h as ColorFactory,j as ContainerFactory,l as DeepFactory,p as FlexFactory,n as FontFactory,u as ResponsiveFactory,r as SizeFactory,t as SpacingFactory,y as apollion,a as backgroundKeys,c as borderKeys,g as colorKeys,i as containerKeys,k as deepKeys,o as flexKeys,m as fontKeys,w as shouldForwardDimensionAttrs,v as shouldForwardProp,q as sizeKeys,s as spacingKeys,x as styled};
+import"../chunks/chunk-5OKRFXLL.esm.js";import{a as v,b as w,c as x,d as y}from"../chunks/chunk-LATE6DIA.esm.js";import"../chunks/chunk-VMIXRIQ2.esm.js";import{a as u}from"../chunks/chunk-MBYC37CX.esm.js";import{a as i,b as j}from"../chunks/chunk-NI6YLGUA.esm.js";import{a as k,b as l}from"../chunks/chunk-OZIEVLUR.esm.js";import"../chunks/chunk-3RNWYCCU.esm.js";import{a as o,b as p}from"../chunks/chunk-RZDVS7AY.esm.js";import{a as m,b as n}from"../chunks/chunk-IK5Z5C2R.esm.js";import{a as q,b as r}from"../chunks/chunk-BNB3KNKE.esm.js";import{a as s,b as t}from"../chunks/chunk-OXQA5WD3.esm.js";import{a,b}from"../chunks/chunk-A6Z2M2XU.esm.js";import{a as c,b as d,c as e,d as f}from"../chunks/chunk-RWLJNXLX.esm.js";import{a as g,b as h}from"../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{b as BackgroundFactory,f as BorderFactory,d as BorderRoundSemantic,e as BorderSemantic,h as ColorFactory,j as ContainerFactory,l as DeepFactory,p as FlexFactory,n as FontFactory,u as ResponsiveFactory,r as SizeFactory,t as SpacingFactory,y as apollion,a as backgroundKeys,c as borderKeys,g as colorKeys,i as containerKeys,k as deepKeys,o as flexKeys,m as fontKeys,w as shouldForwardDimensionAttrs,v as shouldForwardProp,q as sizeKeys,s as spacingKeys,x as styled};

package/lib/form/Checkbox/Checkbox.d.ts

@@ -1,14 +1,14 @@
 import React from 'react';
 import { CheckboxInterface } from './Checkbox.interface';
 /**
- * Caixa de seleção (checkbox) do Apollion.
+ * Apollion's selection box (checkbox).
  *
- * Renderiza um `<input type="checkbox">` nativo (invisível) sobre um quadrado
- * estilizado com ícone de check. O `<label>` envolvente garante que clicar
- * no texto também alterne o estado.
+ * Renders a native (invisible) `<input type="checkbox">` over a styled
+ * square with a check icon. The wrapping `<label>` guarantees that clicking
+ * the text also toggles the state.
  *
- * Use em formulários onde o usuário pode selecionar múltiplos valores de
- * forma independente (ao contrário de `Radio`, que é exclusivo).
+ * Use in forms where the user can select multiple values independently
+ * (unlike `Radio`, which is exclusive).
  *
  * @example
  * ```tsx
@@ -17,7 +17,7 @@ import { CheckboxInterface } from './Checkbox.interface';
  * <Checkbox name="locked" label="Bloqueado" disabled />
  * ```
  *
- * @see {@link CheckboxInterface} para o detalhamento das props.
+ * @see {@link CheckboxInterface} for the detailed props.
  */
 export declare const CheckboxComponent: {
     ({ label, labelProps, variant, ...rest }: CheckboxInterface): React.JSX.Element;