@apollion-dsi/core 3.0.0 → 4.1.0

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

@@ -4,14 +4,27 @@ import { BreakpointInput, BreakpointsInterface } from '../Breakpoints';
 import { ColorsInput, ColorsThemeInterface } from '../Colors';
 import { DeepThemeInterface } from '../Deep';
 import { DepthThemeInterface } from '../Depth';
+import type { Dimension } from '../Dimension';
 import { FontInput, FontThemeInterface } from '../Font';
+import { FoundationLayer } from '../Foundation';
+import { SemanticLayer } from '../Semantic';
 import { SpacingInput, SpacingThemeInterface } from '../Spacing';
+import type { SurfaceMode } from '../Surface';
 export interface ThemeInputsInterface {
     breakpoints?: BreakpointInput;
     spacing?: SpacingInput;
     colors?: ColorsInput;
     font?: FontInput;
     border?: BorderInput;
+    /**
+     * Density axis introduced in `@apollion-dsi/core` v4 (ADR-006 E2).
+     * Overrides `spacing.multiplier` when provided. Default: `'normal'`
+     * (preserves v3.x behavior).
+     *
+     * @see ../Dimension/Dimension.interface.ts (naming disambiguation)
+     * @see ../Dimension/Dimension.props.ts (DIMENSION_MULTIPLIERS calibration)
+     */
+    dimension?: Dimension;
 }
 export type Theme = {
     border: BorderInput;
@@ -22,6 +35,29 @@ export type Theme = {
     depth: DepthThemeInterface;
     deep: DeepThemeInterface;
     animation: AnimationThemeInterface;
+    /**
+     * Camada Semantic — tokens nomeados por intenção, derivada uma única vez
+     * em `createTheme()` a partir dos tokens estruturais. Adicionada em
+     * `@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).
+     *
+     * @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
+     * `@apollion-dsi/core` 3.2.0 (ADR-002 Slice 3).
+     *
+     * @see ../Foundation/Foundation.interface.ts
+     * @see ../Foundation/README.md (cheatsheet)
+     * @see ../../docs/adr/ADR-002-layered-theme-aliases-and-surface.md
+     */
+    foundation: FoundationLayer;
 };
 export type ThemeMode = 'light' | 'dark';
 export interface ApollionProviderInterface {
@@ -29,6 +65,39 @@ export interface ApollionProviderInterface {
     lightTheme?: Theme;
     darkTheme?: Theme;
     useSystemPreference?: boolean;
+    /**
+     * Surface mode aplicado ao theme inteiro a partir deste provider.
+     *
+     * - `'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.
+     *
+     * 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.
+     *
+     * Adicionado em `@apollion-dsi/core` 3.3.0 (ADR-002 Slice 4).
+     *
+     * @default 'positive'
+     * @see ../Surface/Surface.tsx (SurfaceProvider — nested usage)
+     * @see ../Surface/Surface.helpers.ts (invertForSurface)
+     * @see ../../docs/adr/ADR-002-layered-theme-aliases-and-surface.md §3.2
+     */
+    surface?: SurfaceMode;
+    /**
+     * Density axis (ADR-006 E2). Convenience prop equivalent to passing
+     * `theme={createTheme({ dimension })}`. When set, builds a new theme
+     * on the fly with the chosen density multiplier.
+     *
+     * **Prop-only API** (Q-G3 decision): no `theme.dimension()` getter and
+     * no `useDimension()` hook are exposed. Consumer expresses density
+     * declaratively at the provider boundary.
+     *
+     * @default 'normal' (preserves v3.x spacing)
+     * @see ../Dimension/Dimension.interface.ts
+     */
+    dimension?: Dimension;
     children?: React.ReactNode;
 }
 export interface ApollionThemeContext {

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

@@ -1 +1 @@
-import{c as a,d as b}from"../../chunks/chunk-LZTZMWTK.esm.js";import"../../chunks/chunk-G3IXCOJI.esm.js";import"../../chunks/chunk-Q3FXXXUX.esm.js";import"../../chunks/chunk-Z5OQHLDW.esm.js";import"../../chunks/chunk-SHDMTEPB.esm.js";import"../../chunks/chunk-DP6AXK72.esm.js";import"../../chunks/chunk-NQBO2D7L.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-FPQPDMPB.esm.js";import"../../chunks/chunk-WZALORLW.esm.js";import"../../chunks/chunk-KDYOOGW7.esm.js";import"../../chunks/chunk-6KYLIXBS.esm.js";import"../../chunks/chunk-FVRWVTQD.esm.js";import"../../chunks/chunk-5XXISYUW.esm.js";import"../../chunks/chunk-2ROOI4B2.esm.js";import"../../chunks/chunk-KQQ7V7VG.esm.js";import"../../chunks/chunk-3V3ZEGHO.esm.js";import"../../chunks/chunk-A3OJEVGQ.esm.js";import"../../chunks/chunk-KFFUMDHD.esm.js";import"../../chunks/chunk-2FQC32AA.esm.js";import"../../chunks/chunk-V77X6UJ2.esm.js";import"../../chunks/chunk-GWCDFVWM.esm.js";import"../../chunks/chunk-SPHHNZVP.esm.js";import"../../chunks/chunk-I2E5B4NH.esm.js";import"../../chunks/chunk-3QSPHURU.esm.js";import"../../chunks/chunk-EKTJ3A6R.esm.js";import"../../chunks/chunk-KR2X2UQG.esm.js";import"../../chunks/chunk-BE2JDTVA.esm.js";import"../../chunks/chunk-XNBK5E7D.esm.js";import"../../chunks/chunk-3HHYBI4E.esm.js";import"../../chunks/chunk-3XS7RVYS.esm.js";import"../../chunks/chunk-QZYXRYI7.esm.js";import"../../chunks/chunk-VTRVGJA6.esm.js";import"../../chunks/chunk-WTWPQ4EL.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-ELYUJKST.esm.js";import"../../chunks/chunk-TGTH3E4X.esm.js";import"../../chunks/chunk-752Z7BQF.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-W663AGNE.esm.js";import"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-U27SLYIV.esm.js";import"../../chunks/chunk-JB7G6UGV.esm.js";import"../../chunks/chunk-GP7NECT4.esm.js";import"../../chunks/chunk-WAHR5LIT.esm.js";import"../../chunks/chunk-QUHHEZMP.esm.js";import"../../chunks/chunk-44EW3LMK.esm.js";import"../../chunks/chunk-OEH5ARPF.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{b as ApollionProvider,a as createTheme};
+import{c as a,d as b}from"../../chunks/chunk-4WWVMB7R.esm.js";import"../../chunks/chunk-EEBGH4FW.esm.js";import"../../chunks/chunk-V5ZKDMDH.esm.js";import"../../chunks/chunk-TG5BCBO4.esm.js";import"../../chunks/chunk-76C7AHBV.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-A4BXGJYW.esm.js";import"../../chunks/chunk-IT4J7I6H.esm.js";import"../../chunks/chunk-JOKVE3IX.esm.js";import"../../chunks/chunk-Z5OQHLDW.esm.js";import"../../chunks/chunk-CWRWYU7D.esm.js";import"../../chunks/chunk-TVJISBND.esm.js";import"../../chunks/chunk-NQBO2D7L.esm.js";import"../../chunks/chunk-FPQPDMPB.esm.js";import"../../chunks/chunk-TDVKGVGD.esm.js";import"../../chunks/chunk-BFZUNHO5.esm.js";import"../../chunks/chunk-Q44UHGO6.esm.js";import"../../chunks/chunk-53R7OVXP.esm.js";import"../../chunks/chunk-BYRL7X5M.esm.js";import"../../chunks/chunk-2ROOI4B2.esm.js";import"../../chunks/chunk-NSZRKCOX.esm.js";import"../../chunks/chunk-KQQ7V7VG.esm.js";import"../../chunks/chunk-EKTJ3A6R.esm.js";import"../../chunks/chunk-3V3ZEGHO.esm.js";import"../../chunks/chunk-A3OJEVGQ.esm.js";import"../../chunks/chunk-KR2X2UQG.esm.js";import"../../chunks/chunk-BE2JDTVA.esm.js";import"../../chunks/chunk-KFFUMDHD.esm.js";import"../../chunks/chunk-2FQC32AA.esm.js";import"../../chunks/chunk-H6RGCTRX.esm.js";import"../../chunks/chunk-FPQOBUTR.esm.js";import"../../chunks/chunk-SPHHNZVP.esm.js";import"../../chunks/chunk-3QSPHURU.esm.js";import"../../chunks/chunk-IWMEDT6U.esm.js";import"../../chunks/chunk-J73BJCFK.esm.js";import"../../chunks/chunk-ZRIEVBTB.esm.js";import"../../chunks/chunk-5NIX5AK7.esm.js";import"../../chunks/chunk-34F43UAI.esm.js";import"../../chunks/chunk-THOEVSMN.esm.js";import"../../chunks/chunk-U4ODIBWG.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-TOYBV66A.esm.js";import"../../chunks/chunk-H4CYNDAM.esm.js";import"../../chunks/chunk-VVZ6FCG7.esm.js";import"../../chunks/chunk-4RPR6CZT.esm.js";import"../../chunks/chunk-7WVLGVVA.esm.js";import"../../chunks/chunk-OEH5ARPF.esm.js";import"../../chunks/chunk-752Z7BQF.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-W663AGNE.esm.js";import"../../chunks/chunk-44EW3LMK.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-U27SLYIV.esm.js";import"../../chunks/chunk-JB7G6UGV.esm.js";import"../../chunks/chunk-GP7NECT4.esm.js";import"../../chunks/chunk-APD22JEO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{b as ApollionProvider,a as createTheme};

package/lib/themes/index.d.ts

@@ -4,7 +4,11 @@ export * from './Breakpoints';
 export * from './Colors';
 export * from './Deep';
 export * from './Depth';
+export * from './Dimension';
 export * from './Font';
+export * from './Foundation';
 export * from './GlobalStyle';
+export * from './Semantic';
 export * from './Spacing';
+export * from './Surface';
 export * from './ThemeProvider';

package/lib/themes/index.esm.js

@@ -1 +1 @@
-import{c as y,d as z}from"../chunks/chunk-LZTZMWTK.esm.js";import{a as r}from"../chunks/chunk-G3IXCOJI.esm.js";import{a as s,b as t}from"../chunks/chunk-Q3FXXXUX.esm.js";import{a as u}from"../chunks/chunk-Z5OQHLDW.esm.js";import{a as v}from"../chunks/chunk-SHDMTEPB.esm.js";import{a as w,b as x}from"../chunks/chunk-DP6AXK72.esm.js";import{a as m}from"../chunks/chunk-NQBO2D7L.esm.js";import{a as n}from"../chunks/chunk-3DUB5C4Z.esm.js";import{a as o,b as p,c as q}from"../chunks/chunk-KT6QQ3UJ.esm.js";import"../chunks/chunk-FPQPDMPB.esm.js";import"../chunks/chunk-WZALORLW.esm.js";import"../chunks/chunk-KDYOOGW7.esm.js";import"../chunks/chunk-6KYLIXBS.esm.js";import"../chunks/chunk-FVRWVTQD.esm.js";import"../chunks/chunk-5XXISYUW.esm.js";import"../chunks/chunk-2ROOI4B2.esm.js";import"../chunks/chunk-KQQ7V7VG.esm.js";import"../chunks/chunk-3V3ZEGHO.esm.js";import"../chunks/chunk-A3OJEVGQ.esm.js";import"../chunks/chunk-KFFUMDHD.esm.js";import"../chunks/chunk-2FQC32AA.esm.js";import"../chunks/chunk-V77X6UJ2.esm.js";import"../chunks/chunk-GWCDFVWM.esm.js";import"../chunks/chunk-SPHHNZVP.esm.js";import"../chunks/chunk-I2E5B4NH.esm.js";import"../chunks/chunk-3QSPHURU.esm.js";import"../chunks/chunk-EKTJ3A6R.esm.js";import"../chunks/chunk-KR2X2UQG.esm.js";import"../chunks/chunk-BE2JDTVA.esm.js";import"../chunks/chunk-XNBK5E7D.esm.js";import"../chunks/chunk-3HHYBI4E.esm.js";import"../chunks/chunk-3XS7RVYS.esm.js";import"../chunks/chunk-QZYXRYI7.esm.js";import"../chunks/chunk-VTRVGJA6.esm.js";import"../chunks/chunk-WTWPQ4EL.esm.js";import"../chunks/chunk-5OKRFXLL.esm.js";import"../chunks/chunk-ELYUJKST.esm.js";import"../chunks/chunk-TGTH3E4X.esm.js";import"../chunks/chunk-752Z7BQF.esm.js";import"../chunks/chunk-BNB3KNKE.esm.js";import"../chunks/chunk-W663AGNE.esm.js";import"../chunks/chunk-A6Z2M2XU.esm.js";import"../chunks/chunk-U27SLYIV.esm.js";import"../chunks/chunk-JB7G6UGV.esm.js";import"../chunks/chunk-GP7NECT4.esm.js";import"../chunks/chunk-WAHR5LIT.esm.js";import{a,b,c,d,e,f,g,h,i,j,k,l}from"../chunks/chunk-QUHHEZMP.esm.js";import"../chunks/chunk-44EW3LMK.esm.js";import"../chunks/chunk-OEH5ARPF.esm.js";import"../chunks/chunk-V5AWVNU6.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{z as ApollionProvider,v as GlobalStyle,a as HextoRgb,m as animation,o as breakpointsValues,q as createBreakpoints,l as createColors,r as createDeepTheme,t as createDeth,x as createSpacing,y as createTheme,n as defaultInputBorder,p as defaultInputBreakpoints,k as defaultInputColors,u as defaultInputFont,w as defaultInputSpacing,c as getColor,d as getContrastColor,b as getOppositeColor,s as levelValues,i as mountActionColors,h as mountBaseColors,f as mountGreyscaleColors,j as mountMainColors,g as mountNeutralColors,e as mountSingleColor};
+import{c as F,d as G}from"../chunks/chunk-4WWVMB7R.esm.js";import{a as z}from"../chunks/chunk-EEBGH4FW.esm.js";import{a as A}from"../chunks/chunk-V5ZKDMDH.esm.js";import{a as B,b as C}from"../chunks/chunk-TG5BCBO4.esm.js";import{a as D,b as E}from"../chunks/chunk-76C7AHBV.esm.js";import{a as n}from"../chunks/chunk-3DUB5C4Z.esm.js";import{a as o,b as p,c as q}from"../chunks/chunk-KT6QQ3UJ.esm.js";import{a as r}from"../chunks/chunk-A4BXGJYW.esm.js";import{a as s,b as t}from"../chunks/chunk-IT4J7I6H.esm.js";import{a as u,b as v,c as w}from"../chunks/chunk-JOKVE3IX.esm.js";import{a as x}from"../chunks/chunk-Z5OQHLDW.esm.js";import"../chunks/chunk-CWRWYU7D.esm.js";import{a as y}from"../chunks/chunk-TVJISBND.esm.js";import{a as m}from"../chunks/chunk-NQBO2D7L.esm.js";import"../chunks/chunk-FPQPDMPB.esm.js";import"../chunks/chunk-TDVKGVGD.esm.js";import"../chunks/chunk-BFZUNHO5.esm.js";import"../chunks/chunk-Q44UHGO6.esm.js";import"../chunks/chunk-53R7OVXP.esm.js";import"../chunks/chunk-BYRL7X5M.esm.js";import"../chunks/chunk-2ROOI4B2.esm.js";import"../chunks/chunk-NSZRKCOX.esm.js";import"../chunks/chunk-KQQ7V7VG.esm.js";import"../chunks/chunk-EKTJ3A6R.esm.js";import"../chunks/chunk-3V3ZEGHO.esm.js";import"../chunks/chunk-A3OJEVGQ.esm.js";import"../chunks/chunk-KR2X2UQG.esm.js";import"../chunks/chunk-BE2JDTVA.esm.js";import"../chunks/chunk-KFFUMDHD.esm.js";import"../chunks/chunk-2FQC32AA.esm.js";import"../chunks/chunk-H6RGCTRX.esm.js";import"../chunks/chunk-FPQOBUTR.esm.js";import"../chunks/chunk-SPHHNZVP.esm.js";import"../chunks/chunk-3QSPHURU.esm.js";import"../chunks/chunk-IWMEDT6U.esm.js";import"../chunks/chunk-J73BJCFK.esm.js";import"../chunks/chunk-ZRIEVBTB.esm.js";import"../chunks/chunk-5NIX5AK7.esm.js";import"../chunks/chunk-34F43UAI.esm.js";import"../chunks/chunk-THOEVSMN.esm.js";import"../chunks/chunk-U4ODIBWG.esm.js";import"../chunks/chunk-5OKRFXLL.esm.js";import"../chunks/chunk-TOYBV66A.esm.js";import"../chunks/chunk-H4CYNDAM.esm.js";import"../chunks/chunk-VVZ6FCG7.esm.js";import{a,b,c,d,e,f,g,h,i,j,k,l}from"../chunks/chunk-4RPR6CZT.esm.js";import"../chunks/chunk-7WVLGVVA.esm.js";import"../chunks/chunk-OEH5ARPF.esm.js";import"../chunks/chunk-752Z7BQF.esm.js";import"../chunks/chunk-BNB3KNKE.esm.js";import"../chunks/chunk-W663AGNE.esm.js";import"../chunks/chunk-44EW3LMK.esm.js";import"../chunks/chunk-V5AWVNU6.esm.js";import"../chunks/chunk-A6Z2M2XU.esm.js";import"../chunks/chunk-U27SLYIV.esm.js";import"../chunks/chunk-JB7G6UGV.esm.js";import"../chunks/chunk-GP7NECT4.esm.js";import"../chunks/chunk-APD22JEO.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{G as ApollionProvider,v as DEFAULT_DIMENSION,u as DIMENSION_MULTIPLIERS,z as GlobalStyle,a as HextoRgb,E as SurfaceProvider,m as animation,o as breakpointsValues,q as createBreakpoints,l as createColors,r as createDeepTheme,t as createDeth,y as createFoundation,A as createSemantic,C as createSpacing,F as createTheme,n as defaultInputBorder,p as defaultInputBreakpoints,k as defaultInputColors,x as defaultInputFont,B as defaultInputSpacing,c as getColor,d as getContrastColor,w as getMultiplierForDimension,b as getOppositeColor,D as invertForSurface,s as levelValues,i as mountActionColors,h as mountBaseColors,f as mountGreyscaleColors,j as mountMainColors,g as mountNeutralColors,e as mountSingleColor};

package/lib/utils/components/Breakpoints/index.esm.js

@@ -1 +1 @@
-import{a,b}from"../../../chunks/chunk-GWCDFVWM.esm.js";import"../../../chunks/chunk-V5AWVNU6.esm.js";import"../../../chunks/chunk-GZONWSRB.esm.js";export{a as BreakpointsContext,b as BreakpointsProvider};
+import{a,b}from"../../../chunks/chunk-FPQOBUTR.esm.js";import"../../../chunks/chunk-V5AWVNU6.esm.js";import"../../../chunks/chunk-APD22JEO.esm.js";import"../../../chunks/chunk-GZONWSRB.esm.js";export{a as BreakpointsContext,b as BreakpointsProvider};

package/lib/utils/components/index.esm.js

@@ -1 +1 @@
-import"../../chunks/chunk-RMTAUQ4Q.esm.js";import{a,b}from"../../chunks/chunk-GWCDFVWM.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as BreakpointsContext,b as BreakpointsProvider};
+import{a as o,b as r}from"../../chunks/chunk-FPQOBUTR.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-APD22JEO.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{o as BreakpointsContext,r as BreakpointsProvider};

package/lib/vendors/Culori/component.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Re-export tipado da surface absorvida de `culori`.
+ *
+ * Surface absorvida (ADR-006 v4 epic E1 + E6):
+ * - `parse(input)` — parse hex/CSS color string → color object
+ * - `formatHex(color)` — color object → 6-digit hex string (with fallback)
+ * - `interpolate(colors, mode, options?)` — perceptual lerp interpolator factory.
+ *   Used em mode `'oklch'` para palette generation (mountSingleColor,
+ *   mountGreyscaleColors, mountNeutralColors). Hue fixup default
+ *   (`fixupHueShorter`) é correto para palette derivation.
+ * - `wcagContrast(a, b)` — WCAG 2.x contrast ratio (replace
+ *   `Color(a).contrast(Color(b))` em S6).
+ * - `wcagLuminance(c)` — WCAG 2.x relative luminance (replace
+ *   `Color(c).luminosity()` em S6).
+ * - `converter(mode)` — color space converter factory (uso interno).
+ *
+ * Surface NÃO absorvida (gap intencional — ver README.md):
+ * `blend`, `average`, `differenceCiede2000`, color spaces avançados (lab,
+ * lch, cubehelix, hwb, etc).
+ *
+ * @see ./README.md
+ * @see ../../../docs/adr/ADR-006-v4-oklch-dimension-token-split.md §3.10 §6 S2
+ * @see ../../../docs/prd/PRD-002-v4-epic-execution.md §S2
+ */
+import { converter, formatHex, interpolate, parse, wcagContrast, wcagLuminance } from 'culori';
+export { parse, formatHex, interpolate, wcagContrast, wcagLuminance, converter };

package/lib/vendors/Culori/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './interface';
+export { parse, formatHex, interpolate, wcagContrast, wcagLuminance, converter } from './component';

package/lib/vendors/Culori/interface.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Contrato ideal do DS sobre manipulação perceptual de cor.
+ *
+ * `culori` opera em color objects (não instances como `color@5`). Tipos
+ * re-exportados para casos onde helpers internos precisam tipar:
+ * - `Color` — generic color object union (RGB/HSL/OKLch/etc).
+ * - `Oklch` — specific OKLch color shape (`{ mode: 'oklch', l, c, h }`).
+ *
+ * @see ./component.ts
+ * @see ../../../docs/adr/ADR-006-v4-oklch-dimension-token-split.md §3.10
+ */
+export type { Color, Oklch } from 'culori';
+/**
+ * DS-owned helper signature: OKLch perceptual lerp wrapper.
+ *
+ * Migra de `Color(a).mix(b, t).hex()` (RGB lerp, color@5) para
+ * `interpolate([a, b], 'oklch')(t)` + `formatHex` (OKLch lerp, culori).
+ *
+ * Spike validation: branch `spike/culori-oklch-lerp-parity` confirmou
+ * 0 unexpected regressions em 68 deltas. Greyscale ramp 19× mais uniforme
+ * em OKLAB L space.
+ *
+ * @param a - hex string (e.g. `'#003750'`)
+ * @param b - hex string
+ * @param t - interpolation factor (0..1)
+ * @returns 6-digit hex string. Fallback to `a` on parse failure.
+ */
+export type MixOklch = (a: string, b: string, t: number) => string;

package/lib/vendors/DateFns/component.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Re-export tipado da surface absorvida de `date-fns` v4.
+ *
+ * Surface absorvida pelo DS:
+ *
+ * Format/parse:
+ * - `format`     — `Date → string` com pattern + locale. Usado em
+ *   `form/InputDate` para `displayFormat`.
+ * - `parse`      — `string → Date` com pattern + locale. Disponível para
+ *   consumers que ingerem datas em formato não-ISO (ex.: vindo de API
+ *   legado). Consumers importam direto do vendor; não há re-export DS-owned.
+ * - `parseISO`   — `string → Date` apenas para ISO `yyyy-MM-dd[Thh:mm:ss]`.
+ *   Faster path do `form/InputDate` (value interno é sempre ISO).
+ * - `isValid`    — `Date → boolean`. Guarda runtime contra `Invalid Date`
+ *   antes de formatar.
+ *
+ * Locales:
+ * - `ptBR` — `elements/Calendar` (default), `form/InputDate` (default).
+ * - `enUS` — Storybook locale demos + tests determinísticos
+ *   (`aria-label` ICU-version-agnostic).
+ *
+ * `date-fns@4.x` é o sucessor de `date-fns@3` — tree-shakeable, ESM-first,
+ * sem mutação de Date. DS importa apenas o necessário para o
+ * Calendar/InputDate; bundle real ~3 KB gzip.
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1 (vendor isolation convention)
+ */
+export { format, isValid, parse, parseISO } from 'date-fns';
+export { enUS, ptBR } from 'date-fns/locale';

package/lib/vendors/DateFns/index.d.ts

@@ -0,0 +1,2 @@
+export * from './component';
+export * from './interface';

package/lib/vendors/DateFns/interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Re-export tipado dos types upstream que o DS expõe.
+ *
+ * - `Locale`  — shape de locale (`code`, `formatLong`, `match`, etc.).
+ *   Usado como prop type em `elements/Calendar.interface` (via
+ *   `react-day-picker`) e em `form/InputDate.interface` para tipar
+ *   `locale?: Locale`.
+ *
+ * Sem types DS-owned. Convenção ADR-004 §3.1 mantém o arquivo para
+ * uniformidade entre vendors.
+ *
+ * @see ./component.ts
+ */
+export type { Locale } from 'date-fns';

package/lib/vendors/Deepmerge/component.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Re-export tipado da surface absorvida de `deepmerge`.
+ *
+ * Surface absorvida: default export (`deepmerge(a, b)`).
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+import deepmerge from 'deepmerge';
+export { deepmerge };
+export default deepmerge;

package/lib/vendors/Deepmerge/index.d.ts

@@ -0,0 +1 @@
+export { default, deepmerge } from './component';

package/lib/vendors/Deepmerge/interface.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Contrato ideal do DS sobre merge profundo de objetos.
+ *
+ * Não há tipos próprios — `deepmerge` é genérico e o consumidor passa os tipos
+ * dos objetos de entrada/saída. Mantemos arquivo para uniformidade da
+ * convenção de 4 arquivos por vendor (ADR-004 §3.1).
+ *
+ * @see ./component.ts
+ */
+export type {};

package/lib/vendors/EmotionIsPropValid/component.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Re-export tipado da surface absorvida de `@emotion/is-prop-valid`.
+ *
+ * Surface absorvida: default export — predicate que classifica nome de prop
+ * como HTML-valid (usado pelo `shouldForwardProp` de styled-components).
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+import isPropValid from '@emotion/is-prop-valid';
+export { isPropValid };
+export default isPropValid;

package/lib/vendors/EmotionIsPropValid/index.d.ts

@@ -0,0 +1 @@
+export { default, isPropValid } from './component';

package/lib/vendors/EmotionIsPropValid/interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Contrato ideal do DS sobre validação de nomes de prop HTML.
+ *
+ * `@emotion/is-prop-valid` é `(name: string) => boolean`. Sem tipos próprios
+ * — arquivo mantido para uniformidade da convenção (ADR-004 §3.1).
+ *
+ * @see ./component.ts
+ */
+export type {};

package/lib/vendors/FastDeepEqual/component.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Re-export tipado da surface absorvida de `fast-deep-equal`.
+ *
+ * Surface absorvida: default export (`deepEqual(a, b): boolean`).
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+import deepEqual from 'fast-deep-equal';
+export { deepEqual };
+export default deepEqual;

package/lib/vendors/FastDeepEqual/index.d.ts

@@ -0,0 +1 @@
+export { default, deepEqual } from './component';

package/lib/vendors/FastDeepEqual/interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Contrato ideal do DS sobre comparação profunda de valores.
+ *
+ * `fast-deep-equal` é apenas `(a, b) => boolean`. Sem tipos próprios.
+ * Arquivo mantido para uniformidade da convenção (ADR-004 §3.1).
+ *
+ * @see ./component.ts
+ */
+export type {};

package/lib/vendors/FloatingUI/component.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Re-export tipado da surface absorvida de `@floating-ui/react`.
+ *
+ * Surface absorvida pelo DS (`elements/Tooltip`, `elements/Dropdown`):
+ *
+ * Hooks:
+ * - `useFloating`      — hook principal de positioning.
+ * - `useInteractions`  — composição de event handlers (hover/click/focus/dismiss/role).
+ * - `useClick`         — abre no clique do reference.
+ * - `useHover`         — abre no hover (com delay/restMs configuráveis).
+ * - `useFocus`         — abre no focus do reference (a11y AAA).
+ * - `useDismiss`       — fecha em outsidePress + escapeKey.
+ * - `useRole`          — injeta ARIA role correto (`tooltip`/`menu`/`dialog`).
+ *
+ * Portal + focus:
+ * - `FloatingPortal`        — body portal.
+ * - `FloatingFocusManager`  — focus trap para Popover/Dropdown.
+ *
+ * Middleware:
+ * - `arrow`     — posiciona a seta via `middlewareData.arrow.{x,y}`.
+ * - `offset`    — gap entre reference e floating.
+ * - `flip`      — auto-flip on overflow.
+ * - `shift`     — auto-shift on overflow.
+ * - `autoUpdate` — passado para `whileElementsMounted`.
+ *
+ * Família floating-ui — substitui `vendors/TippyHeadless` (deprecated em
+ * S4 deste ciclo). `tippy.js` sem release ≥ 18 meses; `floating-ui` é o
+ * sucessor de fato (mantido pelo mesmo autor do Popper, que tippy.js
+ * usava internamente). Hook-based, tipos modernos, ARIA explícita.
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1 (vendor isolation convention)
+ */
+export { arrow, autoUpdate, flip, FloatingFocusManager, FloatingPortal, offset, safePolygon, shift, useClick, useDismiss, useFloating, useFocus, useHover, useInteractions, useRole, } from '@floating-ui/react';

package/lib/vendors/FloatingUI/index.d.ts

@@ -0,0 +1,2 @@
+export * from './component';
+export * from './interface';

package/lib/vendors/FloatingUI/interface.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Re-export tipado dos types upstream que o DS expõe.
+ *
+ * - `Placement`        — uma de 12 strings literais (`'top'`, `'top-start'`,
+ *   `'top-end'`, `'right'`, …, `'left-end'`). Usado por Tooltip/Dropdown
+ *   para tipar a prop `position`.
+ * - `Strategy`         — `'absolute' | 'fixed'`.
+ * - `MiddlewareData`   — retornado por `useFloating()` em
+ *   `middlewareData.arrow.{x,y}` para posicionar setas inline.
+ * - `OpenChangeReason` — passado para callbacks `onOpenChange` indicando
+ *   o que disparou o close (`outside-press`, `escape-key`, etc.).
+ *
+ * Sem types DS-owned. Convenção ADR-004 §3.1 mantém o arquivo para
+ * uniformidade entre vendors.
+ *
+ * @see ./component.ts
+ */
+export type { MiddlewareData, OpenChangeReason, Placement, Strategy } from '@floating-ui/react';

package/lib/vendors/FramerMotion/component.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Re-export tipado da surface absorvida de `framer-motion`.
+ *
+ * Surface absorvida pelo DS:
+ * - `motion`           — proxy de elementos HTML/SVG animáveis (usado em
+ *                        `containers/Flex/Flex.style.ts`, `containers/Base/Base.style.ts`).
+ * - `AnimatePresence`  — wrapper para animar mount/unmount (usado em Modal,
+ *                        Notification).
+ * - `MotionConfig`     — root de configuração de motion (usado em
+ *                        decorators de teste / Storybook).
+ * - `useReducedMotion` — hook que respeita `prefers-reduced-motion`.
+ *
+ * Gap intencional (ver README): variants/orchestration avançada (`useAnimate`,
+ * `useScroll`, `useMotionTemplate`, layoutGroup, drag, gestures, exit
+ * orchestration) — não absorvidos no core hoje.
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+export { AnimatePresence, motion, MotionConfig, useReducedMotion } from 'framer-motion';

package/lib/vendors/FramerMotion/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './interface';
+export * from './component';

package/lib/vendors/FramerMotion/interface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Contrato ideal do DS sobre animação declarativa.
+ *
+ * Apenas `MotionProps` é re-exportado — props que componentes podem aceitar
+ * para customizar transições no nível da raiz do componente (e.g.
+ * Notification.interface.ts compõe `MotionProps`).
+ *
+ * `Variants`, `Transition`, `Target` e demais tipos do framer-motion ficam
+ * **fora do contrato** — DS escolhe restringir a superfície de configuração
+ * por intent (não expor toda a expressividade da lib via tipos públicos).
+ *
+ * @see ./component.ts
+ * @see ADR-004 §3.1
+ */
+export type { MotionProps } from 'framer-motion';

package/lib/vendors/LodashDebounce/component.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Re-export tipado da surface absorvida de `lodash.debounce`.
+ *
+ * Surface absorvida: o default export (função `debounce`).
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+import debounce from 'lodash.debounce';
+export { debounce };
+export default debounce;

package/lib/vendors/LodashDebounce/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './interface';
+export { default, debounce } from './component';

package/lib/vendors/LodashDebounce/interface.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Contrato ideal do DS sobre debounce de funções.
+ *
+ * @see ./component.ts
+ * @see ADR-004 §3.1
+ */
+/** Função que executa após período de inatividade da última chamada. */
+export type DebouncedFunction<T extends (...args: never[]) => unknown> = T & {
+    cancel: () => void;
+    flush: () => ReturnType<T> | undefined;
+};

package/lib/vendors/Nanoid/component.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Re-export tipado da surface absorvida de `nanoid`.
+ *
+ * Surface absorvida pelo DS:
+ * - `nanoid` (default generator) — id curto + URL-safe para keys React, refs internos.
+ *
+ * Gap intencional (ver README): geração customizada (`customAlphabet`,
+ * `urlAlphabet`), `nanoid/async`, `nanoid/non-secure` — não usados no core.
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+export { nanoid } from 'nanoid';

package/lib/vendors/Nanoid/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './interface';
+export * from './component';

package/lib/vendors/Nanoid/interface.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Contrato ideal do DS sobre geração de IDs únicos.
+ *
+ * Apenas o tipo do generator `nanoid` é absorvido — string opaca,
+ * length default 21 chars, URL-safe.
+ *
+ * @see ./component.ts
+ * @see ADR-004 §3.1
+ */
+/** ID opaco gerado pelo nanoid (URL-safe, default length 21). */
+export type NanoId = string;

package/lib/vendors/ObjectHash/component.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Re-export tipado da surface absorvida de `object-hash`.
+ *
+ * Surface absorvida: `sha1` (hash determinístico de objeto JS).
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+export { sha1 } from 'object-hash';

package/lib/vendors/ObjectHash/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './interface';
+export * from './component';

package/lib/vendors/ObjectHash/interface.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Contrato ideal do DS sobre hashing determinístico de objetos JS.
+ *
+ * @see ./component.ts
+ * @see ADR-004 §3.1
+ */
+/** Hash determinístico (hex string) de qualquer objeto serializável. */
+export type ObjectSha1 = string;

package/lib/vendors/ReactContentLoader/component.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Re-export tipado da surface absorvida de `react-content-loader`.
+ *
+ * Surface absorvida:
+ * - `ContentLoader` (default) — wrapper SVG-based para skeleton loaders.
+ * - Presets: `BulletList`, `Code`, `Facebook`, `List`.
+ *
+ * Usado em `skeleton/ComposedSkeleton`.
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1
+ */
+import ContentLoader, { BulletList, Code, Facebook, List } from 'react-content-loader';
+export { BulletList, Code, ContentLoader, Facebook, List };
+export default ContentLoader;

package/lib/vendors/ReactContentLoader/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './interface';
+export { BulletList, Code, ContentLoader, default, Facebook, List } from './component';

package/lib/vendors/ReactContentLoader/interface.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Contrato ideal do DS sobre skeleton loaders.
+ *
+ * `IContentLoaderProps` re-exportado para `ComposedSkeleton.interface.ts`
+ * tipar props que estendem o contrato do loader.
+ *
+ * @see ./component.ts
+ * @see ADR-004 §3.1
+ */
+export type { IContentLoaderProps } from 'react-content-loader';

package/lib/vendors/ReactDayPicker/component.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Re-export tipado da surface absorvida de `react-day-picker` v9.
+ *
+ * Surface absorvida pelo DS:
+ *
+ * Runtime:
+ * - `DayPicker` — componente headless de grid (single/multiple/range). Núcleo
+ *   do `elements/Calendar` e, por composição, de `form/InputDate`.
+ *
+ * `react-day-picker@9.x` é o sucessor de `react-day-picker@8` — API hook-based,
+ * tipos discriminados por `mode`, sem CSS embutido (DS aplica visual via
+ * `Calendar.style.ts` → tokens do tema).
+ *
+ * @see ./README.md
+ * @see ADR-004 §3.1 (vendor isolation convention)
+ */
+export { DayPicker } from 'react-day-picker';

package/lib/vendors/ReactDayPicker/index.d.ts

@@ -0,0 +1,2 @@
+export * from './component';
+export * from './interface';

package/lib/vendors/ReactDayPicker/interface.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Re-export tipado dos types upstream que o DS expõe.
+ *
+ * - `DayPickerProps`        — union completa (single/multiple/range). Usada
+ *   como `type CalendarProps = DayPickerProps` no `elements/Calendar`.
+ * - `Mode`                  — `'single' | 'multiple' | 'range'`. Discrimina
+ *   `PropsSingle`/`PropsMultiple`/`PropsRange`.
+ * - `DateRange`             — `{ from: Date; to?: Date }` para `mode="range"`.
+ * - `Matcher`               — predicado de data (Date, range, function, etc.)
+ *   usado nas props `disabled`/`hidden`. Combinável em array.
+ * - `PropsSingle` / `PropsSingleRequired`   — modo single (selected: Date | undefined).
+ * - `PropsRange` / `PropsRangeRequired`     — modo range  (selected: DateRange | undefined).
+ *
+ * Sem types DS-owned. Convenção ADR-004 §3.1 mantém o arquivo para
+ * uniformidade entre vendors.
+ *
+ * @see ./component.ts
+ */
+export type { DateRange, DayPickerProps, Matcher, Mode, PropsRange, PropsRangeRequired, PropsSingle, PropsSingleRequired, } from 'react-day-picker';