@apollion-dsi/core 5.2.0 → 5.4.0

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

@@ -2,46 +2,46 @@ import { BorderThemeType } from '../../themes/Border';
 import { BgColorsTypes } from '../../themes/Colors';
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Conjunto de "atalhos" semânticos para `border-radius` reconhecidos pelo
+ * Set of semantic "shortcuts" for `border-radius` recognized by
  * `BorderFactory`.
  *
- * Cada chave descreve um padrão de arredondamento aplicado a cantos
- * específicos. `round` aplica o raio em todos os cantos; as variantes
- * `roundX` / `sharpX` permitem controle granular sem precisar montar o
- * shorthand de `border-radius` manualmente.
+ * Each key describes a rounding pattern applied to specific corners.
+ * `round` applies the radius to all corners; the `roundX` / `sharpX`
+ * variants allow granular control without having to assemble the
+ * `border-radius` shorthand manually.
  */
 export type BorderRoundPropsType = 'round' | 'roundBottom' | 'roundTop' | 'roundRight' | 'roundLeft' | 'roundTopLeft' | 'roundTopRight' | 'roundBottomLeft' | 'roundBottomRight' | 'roundTangentRight' | 'roundTangentLeft' | 'sharpTopLeft' | 'sharpTopRight' | 'sharpBottomRight' | 'sharpBottomLeft';
 /**
- * Mapa parcial de `BorderRoundPropsType` para o valor de raio aplicado.
+ * Partial map from `BorderRoundPropsType` to the applied radius value.
  *
- * O valor pode ser um token do tema (`theme.border.borderRadius`) ou um
- * número — nesse caso é interpretado como índice da escala de spacing
- * (`theme.spacing(n)`).
+ * The value can be a theme token (`theme.border.borderRadius`) or a
+ * number — in which case it's interpreted as an index into the spacing
+ * scale (`theme.spacing(n)`).
  */
 export type BorderRoundProps = Partial<Record<BorderRoundPropsType, BorderThemeType['borderRadius'] | number>>;
 /**
- * Props consumidas pelo `BorderFactory`.
+ * Props consumed by `BorderFactory`.
  *
- * Combina três grupos: bordas convencionais (cor/largura/estilo via
- * `BorderThemeType`), atalhos semânticos de raio (`BorderRoundProps`) e
- * controles auxiliares como `borderPosition` e `square`.
+ * Combines three groups: conventional borders (color/width/style via
+ * `BorderThemeType`), semantic radius shortcuts (`BorderRoundProps`), and
+ * auxiliary controls like `borderPosition` and `square`.
  *
- * `square` tem precedência sobre qualquer raio configurado.
+ * `square` takes precedence over any configured radius.
  */
 export type BorderFactoryProps = {
-    /** Token de cor (`theme.colors`) aplicado a `border-color`. */
+    /** Color token (`theme.colors`) applied to `border-color`. */
     borderColor?: BgColorsTypes;
     /**
-     * Restringe a borda a um lado específico (ou par de lados).
+     * Restricts the border to a specific side (or pair of sides).
      *
-     * `vertical` aplica em `top` + `bottom`; `horizontal` em `left` + `right`.
+     * `vertical` applies to `top` + `bottom`; `horizontal` to `left` + `right`.
      */
     borderPosition?: 'right' | 'left' | 'top' | 'bottom' | 'vertical' | 'horizontal';
-    /** Quando `true`, força `border-radius: undefined` (zera qualquer raio). */
+    /** When `true`, forces `border-radius: undefined` (clears any radius). */
     square?: boolean;
 } & BorderThemeType & BorderRoundProps;
 /**
- * Variante de `BorderFactoryProps` enriquecida com o `theme` injetado pelo
- * `ThemeProvider`. Use em assinaturas que precisam acessar o tema corrente.
+ * Variant of `BorderFactoryProps` enriched with the `theme` injected by
+ * `ThemeProvider`. Use in signatures that need to access the current theme.
  */
 export type BorderThemePropsType = WithTheme<BorderFactoryProps>;

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

@@ -1,9 +1,9 @@
 /**
- * Barrel público do módulo `BorderFactory`.
+ * Public barrel for the `BorderFactory` module.
  *
- * Reexporta a fábrica (`BorderFactory`), os helpers semânticos
- * (`BorderSemantic`, `BorderRoundSemantic`), a lista `borderKeys` e os tipos
- * de props. Importações de fora desta pasta devem usar este barrel.
+ * Re-exports the factory (`BorderFactory`), the semantic helpers
+ * (`BorderSemantic`, `BorderRoundSemantic`), the `borderKeys` list, and the
+ * prop types. Imports from outside this folder should use this barrel.
  */
 export * from './BorderFactory';
 export * from './BorderFactory.interface';

package/lib/factory/ColorFactory/ColorFactory.d.ts

@@ -1,31 +1,31 @@
 import { ColorFactoryProps } from './ColorFactory.interface';
 import { FactoryInterpolation } from '../../themes/ThemeProvider';
 /**
- * Chaves de prop controladas pelo `ColorFactory`.
+ * Prop keys controlled by the `ColorFactory`.
  *
- * Apenas `color`, `contrast` e `readable` aparecem aqui — `opacity`
- * propositalmente fica de fora pois é um modificador genérico que pode ser
- * repassado para o DOM (não causa conflito).
+ * Only `color`, `contrast` and `readable` appear here — `opacity` is
+ * intentionally left out because it is a generic modifier that can be
+ * forwarded to the DOM (it causes no conflict).
  */
 export declare const colorKeys: Array<keyof ColorFactoryProps>;
 /**
- * Fábrica de estilos de cor de texto.
+ * Text-color style factory.
  *
- * Resolução em três passos:
- * 1. `contrast` (se presente) vence: calcula a cor de melhor contraste sobre
- *    aquele fundo.
- * 2. `color` (caso contrário): resolve direto pelo token de tema; com
- *    `readable`, a cor resolvida ainda passa por `readableColor` contra a
- *    superfície da página (`theme.colors.baseLight`, mode-aware) — a
- *    intenção **texto** do plano de contraste (G3), generalizando o padrão
- *    que o `Link` já aplicava localmente.
- * 3. `opacity`: se informado, mapeia o token semântico para um valor numérico.
+ * Resolution in three steps:
+ * 1. `contrast` (when present) wins: computes the best-contrast color over
+ *    that background.
+ * 2. `color` (otherwise): resolves directly through the theme token; with
+ *    `readable`, the resolved color still goes through `readableColor`
+ *    against the page surface (`theme.colors.baseLight`, mode-aware) — the
+ *    **text** intent of the contrast plan (G3), generalizing the pattern
+ *    `Link` already applied locally.
+ * 3. `opacity`: when provided, maps the semantic token to a numeric value.
  *
  * @example
  * ```ts
  * const Title = styled.h1(ColorFactory({ color: 'primary' }));
- * const Badge = styled.span(ColorFactory({ contrast: 'primary' })); // texto sobre fundo primary
- * const Note = styled.p(ColorFactory({ color: 'secondary', readable: true })); // ink AA por tema
+ * const Badge = styled.span(ColorFactory({ contrast: 'primary' })); // text over a primary background
+ * const Note = styled.p(ColorFactory({ color: 'secondary', readable: true })); // AA ink per theme
  * ```
  */
 export declare const ColorFactory: (customProps: ColorFactoryProps) => FactoryInterpolation<ColorFactoryProps>;

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

@@ -1,54 +1,47 @@
 import { BgColorsTypes } from '../../themes/Colors';
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Valor aceito pelas props de cor da fábrica: token tipado do tema (com
- * autocomplete) **ou** string CSS crua (hex/`var(--*)`) — o passthrough do
- * `theme.colors` para valores fora da paleta continua válido.
+ * Value accepted by the factory's color props: a typed theme token (with
+ * autocomplete) **or** a raw CSS string (hex/`var(--*)`) — the `theme.colors`
+ * passthrough for values outside the palette remains valid.
  */
 export type ColorFactoryValueType = BgColorsTypes | (string & {});
 /**
- * Props consumidas pelo `ColorFactory`.
+ * Props consumed by the `ColorFactory`.
  *
- * Controlam a cor de texto e a opacidade resultante. As três opções de
- * `opacity` são tokens semânticos — não valores arbitrários — para manter o
- * conjunto de variações sob controle visual.
+ * They control the text color and the resulting opacity. The three `opacity`
+ * options are semantic tokens — not arbitrary values — to keep the set of
+ * variations under visual control.
  */
 export type ColorFactoryProps = {
     /**
-     * Token do tema (`theme.colors`) usado como `color`. Tem precedência menor
-     * que `contrast`: se ambos forem informados, prevalece o cálculo de
-     * contraste.
+     * Theme token (`theme.colors`) used as `color`. Has lower precedence than
+     * `contrast`: when both are provided, the contrast calculation wins.
      *
-     * Permanece `string` (não o union tipado): `color` também é atributo HTML
-     * (`<li color>`, etc.) e as interfaces que estendem props nativas exigem
-     * tipos idênticos na colisão de nome.
+     * Stays `string` (not the typed union): `color` is also an HTML attribute
+     * (`<li color>`, etc.) and interfaces extending native props require
+     * identical types on the name collision.
      */
     color?: string;
     /**
-     * Token de cor de "fundo" hipotético — a fábrica calcula a melhor cor de
-     * texto (preto/branco) para garantir contraste WCAG sobre ele.
+     * Hypothetical "background" color token — the factory computes the best
+     * text color (black/white) to guarantee WCAG contrast over it.
      */
     contrast?: ColorFactoryValueType;
     /**
-     * Intenção **texto** (vs fill): garante que a cor resolvida por `color`
-     * seja legível contra a superfície da página do tema (`baseLight`,
-     * mode-aware) via `readableColor` — preservando hue/croma, só a luminância
-     * move. `true` usa o piso AA (4.5); um número define o piso (ex.: `7` para
-     * AAA, `5` para AA com margem — o que o `Link` usa).
-     *
-     * Sem `readable`, `color` segue cru — a intenção fill (fundos vibrantes)
-     * não muda. Ignorado quando `contrast` está presente (lá o ink já é
-     * derivado do fundo declarado). Ver plano contraste G3.
+     * Makes the `color` legible against the page surface: `true` = WCAG AA
+     * (4.5), a number sets a custom floor. Ignored with `contrast`.
+     * See the Layout Props concept page for the full semantics.
      */
     readable?: boolean | number;
     /**
-     * Opacidade semântica aplicada à cor: `low` ≈ 0.1, `md` ≈ 0.5, `high` ≈ 0.9.
-     * Manter tokens evita uma proliferação de valores arbitrários ao longo da
-     * UI.
+     * Semantic opacity applied to the color: `low` ≈ 0.1, `md` ≈ 0.5,
+     * `high` ≈ 0.9. Keeping tokens avoids a proliferation of arbitrary values
+     * across the UI.
      */
     opacity?: 'low' | 'md' | 'high';
 };
 /**
- * Variante de `ColorFactoryProps` com `theme` injetado pelo `ThemeProvider`.
+ * Variant of `ColorFactoryProps` with `theme` injected by the `ThemeProvider`.
  */
 export type ColorThemePropsType = WithTheme<ColorFactoryProps>;

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

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

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

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

package/lib/factory/ContainerFactory/ContainerFactory.d.ts

@@ -1,18 +1,18 @@
 import { ContainerFactoryProps, ContainerThemePropsType } from './ContainerFactory.interface';
 import { CSSObject } from '../../vendors/StyledComponents';
 /**
- * Chaves de prop controladas pelo `ContainerFactory`.
+ * Prop keys controlled by `ContainerFactory`.
  *
- * Consumida pelo `System` no `shouldForwardProp` para impedir que essas props
- * sejam emitidas como atributos HTML.
+ * Consumed by `System` in `shouldForwardProp` to prevent these props from
+ * being emitted as HTML attributes.
  */
 export declare const containerKeys: Array<keyof ContainerFactoryProps>;
 /**
- * Fábrica de estilos "estruturais" (display/position/overflow/padding/etc.).
+ * Factory for "structural" styles (display/position/overflow/padding/etc.).
  *
- * Resolve as flags semânticas (`truncate`, `container`, `absoluteFill`,
- * `isHidden`) em conjuntos de propriedades CSS — ver `ContainerFactoryProps`
- * para o significado de cada flag.
+ * Resolves the semantic flags (`truncate`, `container`, `absoluteFill`,
+ * `isHidden`) into sets of CSS properties — see `ContainerFactoryProps`
+ * for the meaning of each flag.
  *
  * @example
  * ```ts

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

@@ -1,53 +1,53 @@
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Valores aceitos pelas props `overflow`, `overflowX` e `overflowY`.
+ * Values accepted by the `overflow`, `overflowX` and `overflowY` props.
  *
- * Espelha o conjunto suportado pelo CSS sem `inherit`/`initial`, que raramente
- * fazem sentido no nível de componente.
+ * Mirrors the set supported by CSS without `inherit`/`initial`, which rarely
+ * make sense at the component level.
  */
 export type OverflowType = 'visible' | 'hidden' | 'scroll' | 'auto';
 /**
- * Valores aceitos por `cursor`.
+ * Values accepted by `cursor`.
  *
- * Lista exaustiva dos cursores nativos do CSS suportados pela Apollion. Limitar
- * o conjunto a um union evita strings inválidas e dá autocompletion.
+ * Exhaustive list of the native CSS cursors supported by Apollion. Limiting
+ * the set to a union avoids invalid strings and provides autocompletion.
  */
 export type CursorType = 'auto' | 'default' | 'none' | 'context-menu' | 'help' | 'pointer' | 'progress' | 'wait' | 'cell' | 'crosshair' | 'text' | 'vertical-text' | 'alias' | 'copy' | 'move' | 'no-drop' | 'not-allowed' | 'e-resize' | 'n-resize' | 'ne-resize' | 'nw-resize' | 's-resize' | 'se-resize' | 'sw-resize' | 'w-resize' | 'ew-resize' | 'ns-resize' | 'nesw-resize' | 'nwse-resize' | 'col-resize' | 'row-resize' | 'all-scroll' | 'zoom-in' | 'zoom-out' | 'grab' | 'grabbing';
 /**
- * Valores aceitos por `display`.
+ * Values accepted by `display`.
  *
- * Omite `table`, `list-item` e outros legados — a Apollion privilegia layout
- * via Flex/Grid.
+ * Omits `table`, `list-item` and other legacy values — Apollion favors
+ * layout via Flex/Grid.
  */
 export type DisplayType = 'none' | 'inline' | 'block' | 'flex' | 'grid' | 'inline-block' | 'inline-flex' | 'inline-grid';
 /**
- * Props consumidas pelo `ContainerFactory`.
+ * Props consumed by the `ContainerFactory`.
  *
- * Reúnem as propriedades "estruturais" de um elemento (posicionamento,
- * overflow, padding/margin, grid-area, etc.) sob um único objeto. Trabalham
- * em conjunto com `SizeFactory` (dimensões) e `SpacingFactory` (escala
- * tokenizada de espaçamento).
+ * They gather an element's "structural" properties (positioning, overflow,
+ * padding/margin, grid-area, etc.) under a single object. They work together
+ * with `SizeFactory` (dimensions) and `SpacingFactory` (tokenized spacing
+ * scale).
  *
- * Algumas flags são atalhos de alto nível:
- * - `truncate` adiciona `overflow:hidden + text-overflow:ellipsis + white-space:nowrap`.
- * - `container` centraliza com `margin: 0 auto` e `maxWidth: 1366`.
- * - `absoluteFill` faz `position:absolute + top/bottom/left/right: 0`.
+ * Some flags are high-level shortcuts:
+ * - `truncate` adds `overflow:hidden + text-overflow:ellipsis + white-space:nowrap`.
+ * - `container` centers with `margin: 0 auto` and `maxWidth: 1366`.
+ * - `absoluteFill` applies `position:absolute + top/bottom/left/right: 0`.
  */
 export type ContainerFactoryProps = Partial<{
-    /** Valor de `grid-area` quando o elemento está dentro de um grid nomeado. */
+    /** `grid-area` value when the element sits inside a named grid. */
     area: string;
     padding: string | number;
     margin: string | number;
-    /** Aplica `visibility: hidden` (mantém o espaço, ao contrário de `display:none`). */
+    /** Applies `visibility: hidden` (keeps the space, unlike `display:none`). */
     isHidden: boolean;
-    /** Atalho para conteúdo single-line com elipse. */
+    /** Shortcut for single-line content with ellipsis. */
     truncate: boolean;
-    /** Centraliza o elemento e limita a largura ao breakpoint de container (1366px). */
+    /** Centers the element and caps the width at the container breakpoint (1366px). */
     container: boolean;
     overflow: OverflowType;
     overflowX: OverflowType;
     overflowY: OverflowType;
-    /** Posiciona absolutamente e ocupa todo o pai (`top/bottom/left/right: 0`). */
+    /** Positions absolutely and fills the whole parent (`top/bottom/left/right: 0`). */
     absoluteFill: boolean;
     position: 'relative' | 'absolute' | 'fixed' | 'sticky';
     display: DisplayType;
@@ -58,17 +58,13 @@ export type ContainerFactoryProps = Partial<{
     right: string | number;
     zIndex: number;
     /**
-     * Valor CSS de `transform` (ex.: `translate(-50%, -33px)`).
-     *
-     * Caso de uso: ancorar um overlay absoluto centrado num ponto percentual —
-     * `left`/`top` posicionam o canto, o `translate` recentra o elemento.
-     * Filtrada pelo `shouldForwardProp`: nunca vaza como atributo HTML
-     * (`transform` é atributo válido de SVG e passaria no `isPropValid`).
+     * CSS `transform` value (e.g. `translate(-50%, -33px)`). Never leaks
+     * to the DOM as an attribute.
      */
     transform: string;
 }>;
 /**
- * Variante de `ContainerFactoryProps` com `theme` injetado pelo
- * `ThemeProvider`. Usada nas assinaturas internas das fábricas.
+ * Variant of `ContainerFactoryProps` with `theme` injected by the
+ * `ThemeProvider`. Used in the factories' internal signatures.
  */
 export type ContainerThemePropsType = WithTheme<ContainerFactoryProps>;

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

@@ -1,8 +1,8 @@
 /**
- * Barrel público do módulo `ContainerFactory`.
+ * Public barrel for the `ContainerFactory` module.
  *
- * Reexporta a fábrica (`ContainerFactory`), a lista `containerKeys` e os tipos
- * (`ContainerFactoryProps`, `OverflowType`, `CursorType`, `DisplayType`).
+ * Re-exports the factory (`ContainerFactory`), the `containerKeys` list, and
+ * the types (`ContainerFactoryProps`, `OverflowType`, `CursorType`, `DisplayType`).
  */
 export * from './ContainerFactory';
 export * from './ContainerFactory.interface';

package/lib/factory/DeepFactory/DeepFactory.d.ts

@@ -1,21 +1,21 @@
 import { DeepFactoryProps } from './DeepFactory.interface';
 import { FactoryInterpolation } from '../../themes/ThemeProvider';
 /**
- * Chaves de prop controladas pelo `DeepFactory`.
+ * Prop keys controlled by the `DeepFactory`.
  *
- * 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 deepKeys: Array<keyof DeepFactoryProps>;
 /**
- * Fábrica de elevação (`box-shadow`) baseada em níveis semânticos.
+ * Elevation factory (`box-shadow`) based on semantic levels.
  *
- * O nível `deep` indexa em uma escala (-1 → 6) onde cada degrau combina
- * distância/proximidade/intensidade do tema. `deepColor` permite trocar a cor
- * base por um token do tema (convertido para RGB).
+ * The `deep` level indexes into a scale (-1 → 6) where each step combines
+ * distance/proximity/intensity from the theme. `deepColor` allows swapping
+ * the base color for a theme token (converted to RGB).
  *
- * Casos especiais:
- * - `deep === undefined` ou `noShadow`: retorna `null` (sem sombra).
- * - `deep === -1`: sombra interna (`inset`).
+ * Special cases:
+ * - `deep === undefined` or `noShadow`: returns `null` (no shadow).
+ * - `deep === -1`: inner shadow (`inset`).
  *
  * @example
  * ```ts

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

@@ -1,41 +1,41 @@
 import { DeepThemeInterface } from '../../themes/Deep';
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Forma "resolvida" do slice `deep` do tema — cada chave é um único valor
- * final (string ou number).
+ * "Resolved" shape of the theme's `deep` slice — each key is a single final
+ * value (string or number).
  *
- * É usada internamente por `getBoxShadow` para montar o shorthand de
- * `box-shadow`. Os valores ainda vêm do tema; este tipo é só um alias de
- * conveniência.
+ * Used internally by `getBoxShadow` to assemble the `box-shadow` shorthand.
+ * The values still come from the theme; this type is just a convenience
+ * alias.
  */
 export type DeepThemeType = Record<keyof DeepThemeInterface, string | number>;
 /**
- * Níveis semânticos de profundidade aceitos pela prop `deep`.
+ * Semantic depth levels accepted by the `deep` prop.
  *
- * - `-1`: sombra interna (afundado).
- * - `0`: linha base (sem sombra visível).
- * - `1`–`6`: graduação de elevação crescente.
+ * - `-1`: inner shadow (sunken).
+ * - `0`: baseline (no visible shadow).
+ * - `1`–`6`: increasing elevation steps.
  *
- * Manter uma escala discreta evita um mar de `box-shadow` ad-hoc e dá
- * consistência cinética às camadas da UI.
+ * Keeping a discrete scale avoids a sea of ad-hoc `box-shadow` values and
+ * gives the UI layers kinetic consistency.
  */
 export type DeepStylesTypes = -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /**
- * Props consumidas pelo `DeepFactory`.
+ * Props consumed by the `DeepFactory`.
  *
- * `noShadow` é um override explícito quando o componente precisa anular a
- * sombra herdada de uma variante. `deepColor` muda a cor base da sombra (útil
- * para sombras coloridas em variantes "primary"/"danger").
+ * `noShadow` is an explicit override for when the component needs to cancel
+ * the shadow inherited from a variant. `deepColor` changes the shadow's base
+ * color (useful for colored shadows on "primary"/"danger" variants).
  */
 export type DeepFactoryProps = {
-    /** Nível de profundidade aplicado. Vide `DeepStylesTypes`. */
+    /** Applied depth level. See `DeepStylesTypes`. */
     deep?: DeepStylesTypes;
-    /** Token de cor (`theme.colors`) usado como cor base do `box-shadow`. */
+    /** Color token (`theme.colors`) used as the `box-shadow` base color. */
     deepColor?: string;
-    /** Quando `true`, suprime qualquer sombra mesmo que `deep` esteja definido. */
+    /** When `true`, suppresses any shadow even when `deep` is set. */
     noShadow?: boolean;
 };
 /**
- * Variante de `DeepFactoryProps` com `theme` injetado pelo `ThemeProvider`.
+ * Variant of `DeepFactoryProps` with `theme` injected by the `ThemeProvider`.
  */
 export type DeepThemePropsType = WithTheme<DeepFactoryProps>;

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

@@ -1,8 +1,8 @@
 /**
- * Barrel público do módulo `DeepFactory`.
+ * Public barrel of the `DeepFactory` module.
  *
- * Reexporta a fábrica de elevação (`DeepFactory`), a lista `deepKeys` e os
- * tipos auxiliares (`DeepStylesTypes`, `DeepFactoryProps`).
+ * Re-exports the elevation factory (`DeepFactory`), the `deepKeys` list and
+ * the helper types (`DeepStylesTypes`, `DeepFactoryProps`).
  */
 export * from './DeepFactory';
 export * from './DeepFactory.interface';

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

@@ -1 +1 @@
-import{a,b}from"../../chunks/chunk-R3TDH6EA.esm.js";import"../../chunks/chunk-WTQ4273O.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-GZONWSRB.esm.js";export{b as DeepFactory,a as deepKeys};
+import{a,b}from"../../chunks/chunk-OZIEVLUR.esm.js";import"../../chunks/chunk-3RNWYCCU.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{b as DeepFactory,a as deepKeys};

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

@@ -1,18 +1,18 @@
 import { FlexFactoryProps, FlexThemeProps } from './FlexFactory.interface';
 import { CSSObject } from '../../vendors/StyledComponents';
 /**
- * Chaves de prop controladas pelo `FlexFactory`.
+ * Prop keys controlled by the `FlexFactory`.
  *
- * 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 flexKeys: Array<keyof FlexFactoryProps>;
 /**
- * Fábrica de estilos de flexbox.
+ * Flexbox style factory.
  *
- * Combina os atalhos semânticos (`flex`, `justifyContent`, `alignItems`,
- * `wrap`, `alignSelf`, `order`, `grow`/`shrink`) com a resolução de `gap` via
- * `gapFn`. `flexDirection` cai em `column` por padrão (alinhado à preferência
- * da Apollion de stacking vertical implícito).
+ * Combines the semantic shortcuts (`flex`, `justifyContent`, `alignItems`,
+ * `wrap`, `alignSelf`, `order`, `grow`/`shrink`) with `gap` resolution via
+ * `gapFn`. `flexDirection` defaults to `column` (aligned with Apollion's
+ * preference for implicit vertical stacking).
  *
  * @example
  * ```ts

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

@@ -1,47 +1,47 @@
 import { SpacingInterface } from '../../themes/Spacing';
 import { WithTheme } from '../../themes/ThemeProvider';
 /**
- * Atalhos semânticos aceitos pela prop `flex`.
+ * Semantic shortcuts accepted by the `flex` prop.
  *
- * Cada chave mapeia para um shorthand de `flex`:
- * - `auto`: `1 1 auto` (cresce/encolhe baseado no conteúdo).
- * - `fluid`: `1 1 0%` (distribui espaço igualmente, ignora conteúdo).
- * - `initial`: `0 1 auto` (não cresce, encolhe se necessário).
- * - `none`: `none` (não cresce nem encolhe).
+ * Each key maps to a `flex` shorthand:
+ * - `auto`: `1 1 auto` (grows/shrinks based on content).
+ * - `fluid`: `1 1 0%` (distributes space equally, ignores content).
+ * - `initial`: `0 1 auto` (does not grow, shrinks if needed).
+ * - `none`: `none` (neither grows nor shrinks).
  */
 export type Flex = 'fluid' | 'initial' | 'auto' | 'none';
-/** Direção do eixo principal do flex container. */
+/** Direction of the flex container's main axis. */
 export type FlexDirection = 'row' | 'row-reverse' | 'column' | 'column-reverse';
 /**
- * Tokens semânticos para `justify-content`. Encurtam os valores nativos do CSS
+ * Semantic tokens for `justify-content`. They shorten the native CSS values
  * (`flex-start` → `start`, `space-between` → `between`, etc.).
  */
 export type FlexJustify = 'start' | 'end' | 'center' | 'between' | 'around' | 'evenly';
-/** Tokens semânticos para `align-items`. */
+/** Semantic tokens for `align-items`. */
 export type FlexAlignItems = 'start' | 'end' | 'center' | 'baseline' | 'stretch';
 /**
- * Tokens semânticos para `flex-wrap`. `reverse` aplica `wrap-reverse`.
+ * Semantic tokens for `flex-wrap`. `reverse` applies `wrap-reverse`.
  */
 export type FlexWrap = 'wrap' | 'reverse' | 'nowrap';
 /**
- * Valor de `order`. Aceita número direto ou tokens semânticos:
- * - `first`: `-999` (puxa o item para o começo).
- * - `last`: `999` (manda para o fim).
+ * `order` value. Accepts a direct number or semantic tokens:
+ * - `first`: `-999` (pulls the item to the start).
+ * - `last`: `999` (sends it to the end).
  */
 export type FlexOrder = number | 'first' | 'last';
-/** Tokens semânticos para `align-self`. */
+/** Semantic tokens for `align-self`. */
 export type AlignSelf = 'start' | 'end' | 'center' | 'auto' | 'stretch';
-/** Mesmo conjunto de tokens de `AlignSelf` — reaproveitado para `justify-self`. */
+/** Same token set as `AlignSelf` — reused for `justify-self`. */
 export type JustifySelf = AlignSelf;
 /**
- * Props consumidas pelo `FlexFactory`.
+ * Props consumed by the `FlexFactory`.
  *
- * Todas opcionais — quando ausentes, não emitem o atributo CSS correspondente
- * (exceto `flexDirection`, que tem fallback para `column` na fábrica).
+ * All optional — when absent, the corresponding CSS attribute is not emitted
+ * (except `flexDirection`, which falls back to `column` in the factory).
  *
- * `gap` recebe um token da escala de spacing (`SpacingInterface`); a fábrica
- * cuida da resolução pelo tema E aplica fallback de `margin` em navegadores
- * antigos sem suporte a `gap` em flexbox.
+ * `gap` takes a token from the spacing scale (`SpacingInterface`); the
+ * factory handles resolution through the theme AND applies a `margin`
+ * fallback in old browsers without flexbox `gap` support.
  */
 export type FlexFactoryProps = Partial<{
     flex: Flex;
@@ -58,6 +58,6 @@ export type FlexFactoryProps = Partial<{
     justifySelf: JustifySelf;
 }>;
 /**
- * Variante de `FlexFactoryProps` com `theme` injetado pelo `ThemeProvider`.
+ * Variant of `FlexFactoryProps` with `theme` injected by the `ThemeProvider`.
  */
 export type FlexThemeProps = WithTheme<FlexFactoryProps>;