@apollion-dsi/core 5.3.0 → 5.4.0

package/lib/themes/Semantic/index.d.ts

@@ -1,15 +1,15 @@
 /**
- * Camada Semantic — tokens nomeados por intenção, mirror de Aplica DS.
+ * Semantic layer — tokens named by intent, mirror of Aplica DS.
  *
- * Exposta em `theme.semantic` a partir de `@apollion-dsi/core` 3.1.0.
+ * Exposed at `theme.semantic` as of `@apollion-dsi/core` 3.1.0.
  *
- * Subpath import (preferido):
+ * Subpath import (preferred):
  * ```ts
  * import { createSemantic, type SemanticLayer } from '@apollion-dsi/core/themes/semantic';
  * ```
  *
- * Re-exportada também pelo barrel `themes` para compat com consumers
- * pre-subpath: `import { createSemantic } from '@apollion-dsi/core/themes';`.
+ * Also re-exported by the `themes` barrel for compat with pre-subpath
+ * consumers: `import { createSemantic } from '@apollion-dsi/core/themes';`.
  *
  * @see ../../../docs/adr/ADR-002-layered-theme-aliases-and-surface.md
  */

package/lib/themes/Spacing/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel público do módulo `Spacing`.
+ * Public barrel for the `Spacing` module.
  *
- * Qualquer outro arquivo do projeto deve importar do barrel, nunca de paths
- * internos como `./Spacing.interface` ou `./Spacing.props`.
+ * Any other file in the project should import from the barrel, never from
+ * internal paths like `./Spacing.interface` or `./Spacing.props`.
  */
 export * from './Spacing.interface';
 export * from './Spacing.props';

package/lib/themes/Surface/Surface.d.ts

@@ -1,32 +1,32 @@
 import React from 'react';
 import type { SurfaceMode } from './Surface.interface';
 /**
- * Props do `SurfaceProvider`.
+ * Props for `SurfaceProvider`.
  */
 export interface SurfaceProviderProps {
     /**
-     * Surface mode aplicado ao subtree.
+     * Surface mode applied to the subtree.
      *
-     * - `'positive'` (default): no-op. Theme passa intacto.
-     * - `'negative'`: inverte Semantic + Foundation para "dark backdrop
-     *   treatment" (ver `invertForSurface` para semântica exata).
+     * - `'positive'` (default): no-op. Theme passes through untouched.
+     * - `'negative'`: inverts Semantic + Foundation into the "dark backdrop
+     *   treatment" (see `invertForSurface` for the exact semantics).
      */
     surface?: SurfaceMode;
     children?: React.ReactNode;
 }
 /**
- * Wrapper leve para inverter o `surface` de um subtree sem re-mount dos
- * providers do `ApollionProvider` (StyleSheetManager, BreakpointsProvider,
- * NotificationsProvider).
+ * Lightweight wrapper to invert the `surface` of a subtree without
+ * re-mounting the `ApollionProvider` providers (StyleSheetManager,
+ * BreakpointsProvider, NotificationsProvider).
  *
- * Implementação segue ADR-002 §9 (grill-with-docs §1): usa a forma
- * **função-theme** do styled-components ThemeProvider, que recebe o outer
- * theme da árvore pai. Sem dependência de "default merge semantics" (que
- * não está documentada).
+ * The implementation follows ADR-002 §9 (grill-with-docs §1): it uses the
+ * **theme-function** form of the styled-components ThemeProvider, which
+ * receives the outer theme from the parent tree. No dependency on "default
+ * merge semantics" (which is undocumented).
  *
- * Por que `useCallback`: garante referência estável da função `themeFn`
- * entre renders quando `surface` não muda — evita que styled-components
- * recompute o theme do subtree.
+ * Why `useCallback`: guarantees a stable reference for the `themeFn` function
+ * across renders when `surface` does not change — prevents styled-components
+ * from recomputing the subtree's theme.
  *
  * @example
  * ```tsx

package/lib/themes/Surface/Surface.helpers.d.ts

@@ -1,40 +1,41 @@
 import type { SurfaceMode } from './Surface.interface';
 import type { Theme } from '../ThemeProvider/ThemeProvider.interface';
 /**
- * Inverte um `Theme` para um surface mode específico, sem mutar a entrada
- * nem tocar a camada Structural.
+ * Inverts a `Theme` for a specific surface mode, without mutating the input
+ * or touching the Structural layer.
  *
- * **Pureza + idempotência (contrato ADR-002 §9):**
- * - Não lê nada externo (Date, Math.random, env, DOM).
- * - Não muta a entrada (`theme` permanece intacto após chamada).
- * - Mesma entrada → mesma saída (referencialmente nova, byte-equivalente).
+ * **Purity + idempotence (ADR-002 §9 contract):**
+ * - Reads nothing external (Date, Math.random, env, DOM).
+ * - Does not mutate the input (`theme` remains intact after the call).
+ * - Same input → same output (referentially new, byte-equivalent).
  * - `invertForSurface(invertForSurface(theme, 'negative'), 'negative')` !==
- *   `theme` (intencionalmente — segunda inversão NÃO retorna ao original;
- *   `negative` é um terminal state baseado no Structural, não bg↔txt swap).
+ *   `theme` (intentionally — a second inversion does NOT return to the
+ *   original; `negative` is a terminal state based on the Structural layer,
+ *   not a bg↔txt swap).
  *
- * Semântica de inversão (v1 — ADR-002 Slice 4):
- * - **Structural** (`theme.colors.*`, `theme.spacing(...)`): inalterado.
- * - **Semantic** + **Foundation** são reconstruídos a partir do Structural
- *   com regra "dark backdrop treatment":
- *   - `feedback.{state}.bg` ← `colors.{state}.dark` (mantém hue, escurece)
+ * Inversion semantics (v1 — ADR-002 Slice 4):
+ * - **Structural** (`theme.colors.*`, `theme.spacing(...)`): unchanged.
+ * - **Semantic** + **Foundation** are rebuilt from the Structural layer
+ *   with the "dark backdrop treatment" rule:
+ *   - `feedback.{state}.bg` ← `colors.{state}.dark` (keeps hue, darkens)
  *   - `feedback.{state}.txtOn` ← `colors.baseLight`
- *   - `feedback.{state}.border` ← `colors.{state}.base` (borda fica brilhante)
- *   - `interface.function.{role}.normal.bg` ← `colors.baseDark` (neutro escuro
- *     universal — cor de função perde saturação para virar "surface dark")
+ *   - `feedback.{state}.border` ← `colors.{state}.base` (border stays bright)
+ *   - `interface.function.{role}.normal.bg` ← `colors.baseDark` (universal
+ *     dark neutral — the function color loses saturation to become "surface dark")
  *   - `interface.function.{role}.normal.txtOn` ← `colors.baseLight`
  *   - `brand.{n}.default.surface` ← `colors.{main|opposite|complementary}.dark`
  *   - `brand.{n}.default.txtOn` ← `colors.baseLight`
- * - **Dimension** (spacing): inalterado.
+ * - **Dimension** (spacing): unchanged.
  *
- * Limitação documentada (v1): inversão é determinística e ignora `themeMode`
- * (Apollion v3.x não tem mode resolution algorítmico). Em ADR-003 (v4 epic
- * com Mode + Dimension axes) a semântica vira "negative dentro do mode
- * corrente" — ver Aplica DS docs.
+ * Documented limitation (v1): the inversion is deterministic and ignores
+ * `themeMode` (Apollion v3.x has no algorithmic mode resolution). In ADR-003
+ * (v4 epic with Mode + Dimension axes) the semantics become "negative within
+ * the current mode" — see the Aplica DS docs.
  *
- * @param theme - Theme base resolvido (vindo de `createTheme()` ou de outer
+ * @param theme - Resolved base Theme (from `createTheme()` or an outer
  *                ThemeProvider).
- * @param surface - `'positive'` (no-op, retorna `theme`) ou `'negative'`.
- * @returns Novo Theme. Para `positive` é a referência original (identity).
+ * @param surface - `'positive'` (no-op, returns `theme`) or `'negative'`.
+ * @returns New Theme. For `positive` it is the original reference (identity).
  *
  * @example
  * ```tsx
@@ -43,7 +44,7 @@ import type { Theme } from '../ThemeProvider/ThemeProvider.interface';
  * const negativeTheme = invertForSurface(theme, 'negative');
  * negativeTheme.foundation.bg.primary;  // → theme.colors.baseDark
  * negativeTheme.foundation.text.onPrimary; // → theme.colors.baseLight
- * theme.foundation.bg.primary; // unchanged (input não mutado)
+ * theme.foundation.bg.primary; // unchanged (input not mutated)
  * ```
  *
  * @see ../../docs/adr/ADR-002-layered-theme-aliases-and-surface.md §3, §9

package/lib/themes/Surface/Surface.interface.d.ts

@@ -1,16 +1,16 @@
 /**
- * Surface modes do theme. Conceito importado de Aplica DS (Poe).
+ * Theme surface modes. Concept imported from Aplica DS (Poe).
  *
- * - `positive`: surface "normal" da página — fundo principal. Default.
- * - `negative`: surface invertida/destacada (dark card numa página light,
- *   highlighted section, badge invertido). Texto sempre claro sobre bg
- *   escuro/saturado.
+ * - `positive`: the page's "normal" surface — main background. Default.
+ * - `negative`: inverted/highlighted surface (dark card on a light page,
+ *   highlighted section, inverted badge). Text is always light over a
+ *   dark/saturated bg.
  *
- * Surface é **ortogonal a themeMode** (light/dark): `negative` em light mode
- * = "dark surface numa página clara"; `negative` em dark mode = "lighter
- * surface numa página escura". Ver ADR-002 §9 + grill-with-docs §5.
+ * Surface is **orthogonal to themeMode** (light/dark): `negative` in light
+ * mode = "dark surface on a light page"; `negative` in dark mode =
+ * "lighter surface on a dark page". See ADR-002 §9 + grill-with-docs §5.
  *
- * Ortogonalidade verificada contra Aplica DS:
+ * Orthogonality verified against Aplica DS:
  * https://docs.aplica.me/en-US/design-tokens-fundamentals/token-architecture
  * "N_brands × 2 modes × 2 surfaces × 3 dimensions = N × 12 variants"
  *

package/lib/themes/Surface/index.d.ts

@@ -1,14 +1,14 @@
 /**
- * Camada Surface — wrapper de inversão contextual de Semantic + Foundation.
+ * Surface layer — contextual inversion wrapper for Semantic + Foundation.
  *
- * Adicionada em `@apollion-dsi/core` 3.3.0 (ADR-002 Slice 4).
+ * Added in `@apollion-dsi/core` 3.3.0 (ADR-002 Slice 4).
  *
- * Subpath import (preferido):
+ * Subpath import (preferred):
  * ```ts
  * import { SurfaceProvider, invertForSurface, type SurfaceMode } from '@apollion-dsi/core/themes/surface';
  * ```
  *
- * Re-exportada também pelo barrel `themes`.
+ * Also re-exported by the `themes` barrel.
  *
  * @see ../../../docs/adr/ADR-002-layered-theme-aliases-and-surface.md
  * @see ./README.md

package/lib/themes/ThemeProvider/ThemeProvider.d.ts

@@ -1,15 +1,15 @@
 import React from 'react';
 import { ApollionProviderInterface, ApollionThemeContext } from './ThemeProvider.interface';
 /**
- * Lê o theme ativo, o modo corrente (`light`/`dark`) e alterna o modo de
- * dentro de qualquer componente sob o `ApollionProvider`.
+ * Reads the active theme and the current mode (`light`/`dark`), and toggles
+ * the mode from within any component under the `ApollionProvider`.
  *
- * @throws quando usado fora de um `ApollionProvider`.
+ * @throws when used outside an `ApollionProvider`.
  *
  * @example
  * ```tsx
  * const { themeMode, toggleTheme } = useApollionTheme();
- * <Button text={`Modo: ${themeMode}`} onClick={() => toggleTheme()} />
+ * <Button text={`Mode: ${themeMode}`} onClick={() => toggleTheme()} />
  * ```
  */
 export declare function useApollionTheme(): ApollionThemeContext;

package/lib/themes/ThemeProvider/ThemeProvider.interface.d.ts

@@ -3,6 +3,7 @@ import { AnimationThemeInterface } from '../Animation';
 import { BorderInput } from '../Border';
 import { BreakpointInput, BreakpointsInterface } from '../Breakpoints';
 import { ColorsInput, ColorsThemeInterface } from '../Colors';
+import { ComponentTokensInput, ComponentTokensLayer } from '../Component';
 import { DeepThemeInterface } from '../Deep';
 import { DepthThemeInterface } from '../Depth';
 import type { Dimension } from '../Dimension';
@@ -26,6 +27,18 @@ export interface ThemeInputsInterface {
      * @see ../Dimension/Dimension.props.ts (DIMENSION_MULTIPLIERS calibration)
      */
     dimension?: Dimension;
+    /**
+     * Component token tier overrides (ADR-020). Deep-merged over the
+     * defaults — override a single size of a single component without
+     * restating the rest.
+     *
+     * @example
+     * ```ts
+     * createTheme({ component: { button: { size: { medium: { px: 'xl' } } } } });
+     * ```
+     * @see ../Component/Component.interface.ts
+     */
+    component?: ComponentTokensInput;
 }
 export type Theme = {
     border: BorderInput;
@@ -37,21 +50,21 @@ export type Theme = {
     deep: DeepThemeInterface;
     animation: AnimationThemeInterface;
     /**
-     * Camada Semantic — tokens nomeados por intenção, derivada uma única vez
-     * em `createTheme()` a partir dos tokens estruturais. Adicionada em
+     * Semantic layer — tokens named by intent, derived exactly once in
+     * `createTheme()` from the structural tokens. Added in
      * `@apollion-dsi/core` 3.1.0 (ADR-002 Slice 2).
      *
-     * Componentes do core devem preferir Semantic ao acessar cores com intent
-     * claro (feedback, interface function, brand). Produto deve consumir
-     * Foundation (camada acima).
+     * Core components should prefer Semantic when accessing colors with a clear
+     * intent (feedback, interface function, brand). Product code should consume
+     * Foundation (the layer above).
      *
      * @see ../Semantic/Semantic.interface.ts
      * @see ../../docs/adr/ADR-002-layered-theme-aliases-and-surface.md
      */
     semantic: SemanticLayer;
     /**
-     * Camada Foundation — aliases curtos e ergonômicos sobre Semantic. Camada
-     * default para código de produto (DEX/Jovian/Fanaticofc). Adicionada em
+     * Foundation layer — short, ergonomic aliases over Semantic. Default layer
+     * for product code (DEX/Jovian/Fanaticofc). Added in
      * `@apollion-dsi/core` 3.2.0 (ADR-002 Slice 3).
      *
      * @see ../Foundation/Foundation.interface.ts
@@ -59,24 +72,34 @@ export type Theme = {
      * @see ../../docs/adr/ADR-002-layered-theme-aliases-and-surface.md
      */
     foundation: FoundationLayer;
+    /**
+     * Component token tier — each component's themeable decisions, named and
+     * enumerable, resolved once in `createTheme()` (ADR-020). Replaces the
+     * five ad-hoc per-component token records that previously lived in
+     * `*.style.ts` / `*.helpers.tsx` files. Added in `@apollion-dsi/core` 5.4.0.
+     *
+     * @see ../Component/Component.interface.ts
+     * @see ../../docs/adr/ADR-020-component-token-tier.md
+     */
+    component: ComponentTokensLayer;
 };
 export type ThemeMode = 'light' | 'dark';
 export interface ApollionProviderInterface {
     /**
-     * Theme único (modo claro). Caminho legado e mais comum: quando não há
-     * `lightTheme`/`darkTheme`, este theme é usado em qualquer `themeMode`.
+     * Single theme (light mode). Legacy and most common path: when there is no
+     * `lightTheme`/`darkTheme`, this theme is used for any `themeMode`.
      *
      * @default createTheme()
      */
     theme?: Theme;
     /**
-     * Theme aplicado quando `themeMode === 'light'`. Forme o par com `darkTheme`
-     * para habilitar a troca de modo (toggle manual ou `useSystemPreference`).
+     * Theme applied when `themeMode === 'light'`. Pair it with `darkTheme` to
+     * enable mode switching (manual toggle or `useSystemPreference`).
      */
     lightTheme?: Theme;
     /**
-     * Theme aplicado quando `themeMode === 'dark'`. Geralmente é um `createTheme`
-     * com o contraste `baseDark`/`baseLight` (e `deepDark`/`deepLight`) invertido.
+     * Theme applied when `themeMode === 'dark'`. Usually a `createTheme` with
+     * the `baseDark`/`baseLight` (and `deepDark`/`deepLight`) contrast inverted.
      *
      * @example
      * ```tsx
@@ -87,38 +110,39 @@ export interface ApollionProviderInterface {
      */
     darkTheme?: Theme;
     /**
-     * Quando `true` (e o modo é não-controlado), observa `prefers-color-scheme`
-     * do sistema operacional para escolher o `themeMode` inicial e reagir a
-     * mudanças em runtime. SSR-safe (no-op quando não há `window`).
+     * When `true` (and the mode is uncontrolled), observes the operating
+     * system's `prefers-color-scheme` to pick the initial `themeMode` and react
+     * to runtime changes. SSR-safe (no-op when there is no `window`).
      *
      * @default false
      */
     useSystemPreference?: boolean;
     /**
-     * Modo controlado. Quando definido, o provider renderiza este modo e ignora
-     * o estado interno e `useSystemPreference` — a fonte da verdade passa a ser
-     * o pai (ex.: um toggle de navbar / `next-themes`). `toggleTheme` então
-     * apenas dispara `onThemeModeChange`, sem mutar estado local.
+     * Controlled mode. When set, the provider renders this mode and ignores the
+     * internal state and `useSystemPreference` — the source of truth becomes the
+     * parent (e.g. a navbar toggle / `next-themes`). `toggleTheme` then only
+     * fires `onThemeModeChange`, without mutating local state.
      */
     themeMode?: ThemeMode;
     /**
-     * Callback disparado por `toggleTheme`. Essencial no modo controlado (para o
-     * pai atualizar sua fonte da verdade) e opcional no modo não-controlado.
+     * Callback fired by `toggleTheme`. Essential in controlled mode (for the
+     * parent to update its source of truth) and optional in uncontrolled mode.
      */
     onThemeModeChange?: (mode: ThemeMode) => void;
     /**
-     * Surface mode aplicado ao theme inteiro a partir deste provider.
+     * Surface mode applied to the whole theme from this provider down.
      *
-     * - `'positive'` (default): theme passa intacto. Comportamento legado.
-     * - `'negative'`: aplica `invertForSurface` no theme antes de injetar no
-     *   styled-components ThemeProvider. Use quando o ApollionProvider é o
-     *   nível mais externo E você quer todo o app numa surface invertida.
+     * - `'positive'` (default): theme passes through untouched. Legacy behavior.
+     * - `'negative'`: applies `invertForSurface` to the theme before injecting
+     *   it into the styled-components ThemeProvider. Use when the
+     *   ApollionProvider is the outermost level AND you want the whole app on an
+     *   inverted surface.
      *
-     * Para inverter um SUBTREE (caso muito mais comum — "dark card on light
-     * page"), use `<SurfaceProvider surface="negative">` ao invés de
-     * remontar o ApollionProvider inteiro.
+     * To invert a SUBTREE (the far more common case — "dark card on light
+     * page"), use `<SurfaceProvider surface="negative">` instead of remounting
+     * the entire ApollionProvider.
      *
-     * Adicionado em `@apollion-dsi/core` 3.3.0 (ADR-002 Slice 4).
+     * Added in `@apollion-dsi/core` 3.3.0 (ADR-002 Slice 4).
      *
      * @default 'positive'
      * @see ../Surface/Surface.tsx (SurfaceProvider — nested usage)
@@ -150,18 +174,18 @@ export type WithTheme<P> = P & {
     theme: Theme;
 };
 /**
- * Assinatura de uma interpolação de fábrica dentro de um styled-component.
+ * Signature of a factory interpolation inside a styled-component.
  *
- * As fábricas (`ColorFactory`, `FontFactory`, …) devolvem
- * `(contextProps) => CSSObject`, e o styled-component chama essa função com
- * as SUAS props (`LinkInterface & { theme }`, por exemplo). Sem um tipo que
- * acomode isso, o parâmetro é contravariante e o TypeScript recusa — foi
- * exatamente essa fricção que espalhou 12 `as any` pelos `*.style.ts`
- * (`Link`, `Modal`, `Button`, `ProgressBar`, `Meter`).
+ * The factories (`ColorFactory`, `FontFactory`, …) return
+ * `(contextProps) => CSSObject`, and the styled-component calls that function
+ * with ITS OWN props (`LinkInterface & { theme }`, for example). Without a
+ * type that accommodates this, the parameter is contravariant and TypeScript
+ * refuses — exactly the friction that spread 12 `as any` across the
+ * `*.style.ts` files (`Link`, `Modal`, `Button`, `ProgressBar`, `Meter`).
  *
- * O genérico `C` deixa a interpolação aceitar as props de QUALQUER
- * styled-component; a fábrica lê só o que conhece, vindo de `customProps` ou
- * do contexto.
+ * The `C` generic lets the interpolation accept the props of ANY
+ * styled-component; the factory reads only what it knows, coming from
+ * `customProps` or from context.
  */
 export type FactoryInterpolation<P> = <C extends object>(contextProps: C & Partial<P> & {
     theme: Theme;

package/lib/themes/ThemeProvider/index.d.ts

@@ -1,14 +1,14 @@
 /**
- * Barrel público do módulo `ThemeProvider`.
+ * Public barrel for the `ThemeProvider` module.
  *
- * Reexporta o `ApollionProvider` (provider raiz que injeta `theme`,
- * breakpoints e notifications no app), o helper `createTheme` (constrói um
- * `Theme` a partir de inputs parciais) e as interfaces de tipo que outros
- * módulos do core consomem (`Theme`, `WithTheme`, `ThemeInputsInterface`,
+ * Re-exports `ApollionProvider` (root provider that injects `theme`,
+ * breakpoints, and notifications into the app), the `createTheme` helper
+ * (builds a `Theme` from partial inputs), and the type interfaces consumed
+ * by other core modules (`Theme`, `WithTheme`, `ThemeInputsInterface`,
  * `ApollionProviderInterface`).
  *
- * Qualquer outro arquivo do projeto deve importar do barrel, nunca de paths
- * internos como `./ThemeProvider.interface` ou `./ThemeProvider.props`.
+ * Any other file in the project should import from the barrel, never from
+ * internal paths like `./ThemeProvider.interface` or `./ThemeProvider.props`.
  */
 export { ApollionProvider, useApollionTheme } from './ThemeProvider';
 export { createTheme } from './ThemeProvider.props';

package/lib/themes/ThemeProvider/index.esm.js

@@ -1 +1 @@
-import{a,d as b,e as c}from"../../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-WGTBX72G.esm.js";import"../../chunks/chunk-IWMEDT6U.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-FJUISCKG.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 ApollionProvider,a as createTheme,b as useApollionTheme};
+import{a,d as b,e as c}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-WGTBX72G.esm.js";import"../../chunks/chunk-IWMEDT6U.esm.js";import"../../chunks/chunk-VMIXRIQ2.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-APD22JEO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{c as ApollionProvider,a as createTheme,b as useApollionTheme};

package/lib/themes/index.d.ts

@@ -2,6 +2,7 @@ export * from './Animation';
 export * from './Border';
 export * from './Breakpoints';
 export * from './Colors';
+export * from './Component';
 export * from './Deep';
 export * from './Depth';
 export * from './Dimension';

package/lib/themes/index.esm.js

@@ -1 +1 @@
-import"../chunks/chunk-QF2YUOVX.esm.js";import{a as Q}from"../chunks/chunk-T6ZB656A.esm.js";import{a as V}from"../chunks/chunk-7AFAO7ZS.esm.js";import{a as W,d as X,e as Y}from"../chunks/chunk-NO4SD45Y.esm.js";import{a as N,b as O}from"../chunks/chunk-RU6QRCR7.esm.js";import"../chunks/chunk-CWRWYU7D.esm.js";import{a as R}from"../chunks/chunk-2R6XFFSQ.esm.js";import{a as S,b as T}from"../chunks/chunk-TG5BCBO4.esm.js";import{a as U}from"../chunks/chunk-BRXIFPWB.esm.js";import{a as P}from"../chunks/chunk-3EOSES4S.esm.js";import{a as C}from"../chunks/chunk-NQBO2D7L.esm.js";import{a as D}from"../chunks/chunk-3DUB5C4Z.esm.js";import{a as E,b as F,c as G}from"../chunks/chunk-KT6QQ3UJ.esm.js";import{a as H}from"../chunks/chunk-OWMRURZT.esm.js";import{a as I,b as J}from"../chunks/chunk-6X6WKZ3Y.esm.js";import{a as K,b as L,c as M}from"../chunks/chunk-JOKVE3IX.esm.js";import"../chunks/chunk-WGTBX72G.esm.js";import"../chunks/chunk-IWMEDT6U.esm.js";import"../chunks/chunk-VMIXRIQ2.esm.js";import{a as v,b as w,c as x,d as y,e as z,f as A,g as B}from"../chunks/chunk-FJUISCKG.esm.js";import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u}from"../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{Y as ApollionProvider,L as DEFAULT_DIMENSION,K as DIMENSION_MULTIPLIERS,j as DISABLED_NEUTRAL_INDICES,Q as GlobalStyle,a as HextoRgb,c as MIN_CONTRAST_AA,n as MIN_STATE_CONTRAST,h as NEUTRAL_TEXT_INDICES,z as OKABE_ITO,g as READABLE_TEXT_PALETTES,o as STATE_DELTA_L_JND,k as STRUCTURAL_NEUTRAL_INDICES,V as SurfaceProvider,B as accessibilityPalettes,C as animation,E as breakpointsValues,A as colorblindPalette,G as createBreakpoints,w as createColors,H as createDeepTheme,J as createDeth,O as createFont,P as createFoundation,i as createReadableTextLayer,R as createSemantic,T as createSpacing,W as createTheme,D as defaultInputBorder,F as defaultInputBreakpoints,v as defaultInputColors,N as defaultInputFont,S as defaultInputSpacing,e as getColor,f as getContrastColor,M as getMultiplierForDimension,b as getOppositeColor,x as grayscalePalette,y as highContrastPalette,U as invertForSurface,I as levelValues,t as mountActionColors,s as mountBaseColors,q as mountGreyscaleColors,u as mountMainColors,r as mountNeutralColors,p as mountSingleColor,d as readableColor,l as resolveDisabledNeutral,m as resolveStructuralNeutrals,X as useApollionTheme};
+import"../chunks/chunk-KL3ATH64.esm.js";import{a as R}from"../chunks/chunk-T6ZB656A.esm.js";import{a as W}from"../chunks/chunk-7AFAO7ZS.esm.js";import{a as X,d as Y,e as Z}from"../chunks/chunk-QXQC37K5.esm.js";import{a as O,b as P}from"../chunks/chunk-RU6QRCR7.esm.js";import"../chunks/chunk-CWRWYU7D.esm.js";import{a as S}from"../chunks/chunk-2R6XFFSQ.esm.js";import{a as T,b as U}from"../chunks/chunk-TG5BCBO4.esm.js";import{a as L,b as M,c as N}from"../chunks/chunk-JOKVE3IX.esm.js";import{a as V}from"../chunks/chunk-BRXIFPWB.esm.js";import{a as Q}from"../chunks/chunk-3EOSES4S.esm.js";import{a as C}from"../chunks/chunk-NQBO2D7L.esm.js";import{a as D}from"../chunks/chunk-3DUB5C4Z.esm.js";import{a as E,b as F,c as G}from"../chunks/chunk-KT6QQ3UJ.esm.js";import{b as H}from"../chunks/chunk-7EGX7BMB.esm.js";import{a as I}from"../chunks/chunk-OWMRURZT.esm.js";import{a as J,b as K}from"../chunks/chunk-6X6WKZ3Y.esm.js";import"../chunks/chunk-WGTBX72G.esm.js";import"../chunks/chunk-IWMEDT6U.esm.js";import"../chunks/chunk-VMIXRIQ2.esm.js";import{a as v,b as w,c as x,d as y,e as z,f as A,g as B}from"../chunks/chunk-3RNWYCCU.esm.js";import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u}from"../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{Z as ApollionProvider,M as DEFAULT_DIMENSION,L as DIMENSION_MULTIPLIERS,j as DISABLED_NEUTRAL_INDICES,R as GlobalStyle,a as HextoRgb,c as MIN_CONTRAST_AA,n as MIN_STATE_CONTRAST,h as NEUTRAL_TEXT_INDICES,z as OKABE_ITO,g as READABLE_TEXT_PALETTES,o as STATE_DELTA_L_JND,k as STRUCTURAL_NEUTRAL_INDICES,W as SurfaceProvider,B as accessibilityPalettes,C as animation,E as breakpointsValues,A as colorblindPalette,G as createBreakpoints,w as createColors,H as createComponentTokens,I as createDeepTheme,K as createDeth,P as createFont,Q as createFoundation,i as createReadableTextLayer,S as createSemantic,U as createSpacing,X as createTheme,D as defaultInputBorder,F as defaultInputBreakpoints,v as defaultInputColors,O as defaultInputFont,T as defaultInputSpacing,e as getColor,f as getContrastColor,N as getMultiplierForDimension,b as getOppositeColor,x as grayscalePalette,y as highContrastPalette,V as invertForSurface,J as levelValues,t as mountActionColors,s as mountBaseColors,q as mountGreyscaleColors,u as mountMainColors,r as mountNeutralColors,p as mountSingleColor,d as readableColor,l as resolveDisabledNeutral,m as resolveStructuralNeutrals,Y as useApollionTheme};

package/lib/utils/components/Breakpoints/Breakpoints.d.ts

@@ -1,23 +1,23 @@
 import React from 'react';
 import { BreakpointsContextType } from './Breakpoints.interface';
 /**
- * Contexto React que expõe as flags de breakpoint ao restante da aplicação.
+ * React context exposing the breakpoint flags to the rest of the app.
  *
- * Consumidores usam `useContext(BreakpointsContext)` (ou um hook envoltório)
- * para reagir a mudanças de tamanho/orientação sem ouvir os eventos
- * manualmente.
+ * Consumers use `useContext(BreakpointsContext)` (or a wrapper hook) to
+ * react to size/orientation changes without listening to the events
+ * manually.
  */
 export declare const BreakpointsContext: React.Context<BreakpointsContextType>;
 /**
- * Provider que registra `matchMedia` para cada breakpoint do tema e propaga
- * o estado pelo `BreakpointsContext`.
+ * Provider that registers `matchMedia` for each theme breakpoint and
+ * propagates the state through the `BreakpointsContext`.
  *
- * Cuidados de runtime:
- * - Em SSR / ambientes sem `matchMedia` o effect retorna cedo e mantém o
- *   estado inicial (`false` para tudo).
- * - Usa `addEventListener('change', ...)` com fallback para `addListener`
- *   por compatibilidade com Safari antigo.
- * - Faz cleanup dos listeners no unmount.
+ * Runtime care:
+ * - In SSR / environments without `matchMedia` the effect returns early and
+ *   keeps the initial state (`false` for everything).
+ * - Uses `addEventListener('change', ...)` with an `addListener` fallback
+ *   for old Safari compatibility.
+ * - Cleans up the listeners on unmount.
  */
 export declare const BreakpointsProvider: React.FC<{
     children?: React.ReactNode;

package/lib/utils/components/Breakpoints/Breakpoints.interface.d.ts

@@ -1,15 +1,15 @@
 /**
- * Forma do contexto exposto por `BreakpointsProvider`.
+ * Shape of the context exposed by `BreakpointsProvider`.
  *
- * Cada flag representa um match ativo de `matchMedia` no momento atual. As
- * faixas seguem os tokens `theme.breakpoints.values`:
+ * Each flag represents an active `matchMedia` match at the current moment.
+ * The ranges follow the `theme.breakpoints.values` tokens:
  * - `isMobile`: viewport < `md`.
- * - `isTablet`: entre `md` e `lg`.
- * - `isLaptop`: entre `lg` e `xl`.
- * - `isPortrait`: orientação retrato (independente de tamanho).
+ * - `isTablet`: between `md` and `lg`.
+ * - `isLaptop`: between `lg` and `xl`.
+ * - `isPortrait`: portrait orientation (size-independent).
  *
- * Em SSR (ou navegadores sem `matchMedia`) todas as flags ficam `false` até
- * que o effect rode no client.
+ * In SSR (or browsers without `matchMedia`) all flags stay `false` until the
+ * effect runs on the client.
  */
 export type BreakpointsContextType = {
     isMobile: boolean;

package/lib/utils/components/Breakpoints/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel público do componente `Breakpoints`.
+ * Public barrel of the `Breakpoints` component.
  *
- * Reexporta o contexto/provider (`BreakpointsContext`, `BreakpointsProvider`)
- * e o tipo do estado exposto (`BreakpointsContextType`).
+ * Re-exports the context/provider (`BreakpointsContext`, `BreakpointsProvider`)
+ * and the exposed state type (`BreakpointsContextType`).
  */
 export * from './Breakpoints.interface';
 export * from './Breakpoints';

package/lib/utils/components/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Barrel dos componentes utilitários acoplados ao `utils`.
+ * Barrel of the utility components coupled to `utils`.
  *
- * Atualmente reexporta apenas o `BreakpointsProvider`/contexto — mantemos
- * este barrel para que novos utilitários componentizáveis caiam aqui sem
- * mexer no consumidor.
+ * Currently only re-exports the `BreakpointsProvider`/context — we keep
+ * this barrel so that new componentizable utilities can land here without
+ * touching the consumer.
  */
 export * from './Breakpoints';

package/lib/utils/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * Barrel público dos utilitários genéricos do `@apollion/core`.
+ * Public barrel of the generic utilities of `@apollion/core`.
  *
- * Agrupa funções pequenas e independentes (`object`, `utils`, `mask`,
- * `logger`) usadas por toda a biblioteca. Importações externas devem entrar
- * por este barrel — nunca por paths internos como `./object`.
+ * Groups small, independent functions (`object`, `utils`, `mask`,
+ * `logger`) used throughout the library. External imports must come
+ * through this barrel — never through internal paths like `./object`.
  */
 export * from './object';
 export * from './utils';

package/lib/utils/logger.d.ts

@@ -1,9 +1,9 @@
 /**
- * Instância padrão do logger da Apollion.
+ * Apollion's default logger instance.
  *
- * Use no lugar de chamadas diretas a `console.*` em qualquer código de
- * runtime — assim mensagens internas (avisos de depreciação, etc.) somem do
- * console em builds de produção.
+ * Use it instead of direct `console.*` calls in any runtime code — that way
+ * internal messages (deprecation warnings, etc.) disappear from the console
+ * in production builds.
  */
 export declare const LOGGER: {
     log: (message: string, ...args: any) => void;