@apollion-dsi/core 5.3.0 → 5.4.0

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

@@ -1,13 +1,13 @@
 /**
- * Re-export tipado dos types upstream que o DS expõe.
+ * Typed re-export of the upstream types the DS exposes.
  *
- * - `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 shape (`code`, `formatLong`, `match`, etc.).
+ *   Used as a prop type in `elements/Calendar.interface` (via
+ *   `react-day-picker`) and in `form/InputDate.interface` to type
  *   `locale?: Locale`.
  *
- * Sem types DS-owned. Convenção ADR-004 §3.1 mantém o arquivo para
- * uniformidade entre vendors.
+ * No DS-owned types. The ADR-004 §3.1 convention keeps the file for
+ * uniformity across vendors.
  *
  * @see ./component.ts
  */

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

@@ -1,7 +1,7 @@
 /**
- * Re-export tipado da surface absorvida de `deepmerge`.
+ * Typed re-export of the absorbed surface of `deepmerge`.
  *
- * Surface absorvida: default export (`deepmerge(a, b)`).
+ * Absorbed surface: default export (`deepmerge(a, b)`).
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,9 +1,9 @@
 /**
- * Contrato ideal do DS sobre merge profundo de objetos.
+ * The DS's ideal contract for deep object merging.
  *
- * 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).
+ * There are no types of its own — `deepmerge` is generic and the consumer
+ * passes the types of the input/output objects. We keep the file for
+ * uniformity of the 4-files-per-vendor convention (ADR-004 §3.1).
  *
  * @see ./component.ts
  */

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

@@ -1,8 +1,8 @@
 /**
- * Re-export tipado da surface absorvida de `@emotion/is-prop-valid`.
+ * Typed re-export of the absorbed surface of `@emotion/is-prop-valid`.
  *
- * Surface absorvida: default export — predicate que classifica nome de prop
- * como HTML-valid (usado pelo `shouldForwardProp` de styled-components).
+ * Absorbed surface: default export — predicate that classifies a prop name
+ * as HTML-valid (used by styled-components' `shouldForwardProp`).
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,8 +1,8 @@
 /**
- * Contrato ideal do DS sobre validação de nomes de prop HTML.
+ * The DS's ideal contract for HTML prop name validation.
  *
- * `@emotion/is-prop-valid` é `(name: string) => boolean`. Sem tipos próprios
- * — arquivo mantido para uniformidade da convenção (ADR-004 §3.1).
+ * `@emotion/is-prop-valid` is `(name: string) => boolean`. No types of its own
+ * — file kept for uniformity of the convention (ADR-004 §3.1).
  *
  * @see ./component.ts
  */

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

@@ -1,7 +1,7 @@
 /**
- * Re-export tipado da surface absorvida de `fast-deep-equal`.
+ * Typed re-export of the absorbed surface of `fast-deep-equal`.
  *
- * Surface absorvida: default export (`deepEqual(a, b): boolean`).
+ * Absorbed surface: default export (`deepEqual(a, b): boolean`).
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,8 +1,8 @@
 /**
- * Contrato ideal do DS sobre comparação profunda de valores.
+ * The DS's ideal contract for deep value comparison.
  *
- * `fast-deep-equal` é apenas `(a, b) => boolean`. Sem tipos próprios.
- * Arquivo mantido para uniformidade da convenção (ADR-004 §3.1).
+ * `fast-deep-equal` is just `(a, b) => boolean`. No types of its own.
+ * File kept for uniformity of the convention (ADR-004 §3.1).
  *
  * @see ./component.ts
  */

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

@@ -1,32 +1,33 @@
 /**
- * Re-export tipado da surface absorvida de `@floating-ui/react`.
+ * Typed re-export of the absorbed surface of `@floating-ui/react`.
  *
- * Surface absorvida pelo DS (`elements/Tooltip`, `elements/Dropdown`):
+ * Surface absorbed by the 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`).
+ * - `useFloating`      — main positioning hook.
+ * - `useInteractions`  — event handler composition (hover/click/focus/dismiss/role).
+ * - `useClick`         — opens on reference click.
+ * - `useHover`         — opens on hover (with configurable delay/restMs).
+ * - `useFocus`         — opens on reference focus (a11y AAA).
+ * - `useDismiss`       — closes on outsidePress + escapeKey.
+ * - `useRole`          — injects the correct ARIA role (`tooltip`/`menu`/`dialog`).
  *
  * Portal + focus:
  * - `FloatingPortal`        — body portal.
- * - `FloatingFocusManager`  — focus trap para Popover/Dropdown.
+ * - `FloatingFocusManager`  — focus trap for Popover/Dropdown.
  *
  * Middleware:
- * - `arrow`     — posiciona a seta via `middlewareData.arrow.{x,y}`.
- * - `offset`    — gap entre reference e floating.
+ * - `arrow`     — positions the arrow via `middlewareData.arrow.{x,y}`.
+ * - `offset`    — gap between reference and floating.
  * - `flip`      — auto-flip on overflow.
  * - `shift`     — auto-shift on overflow.
- * - `autoUpdate` — passado para `whileElementsMounted`.
+ * - `autoUpdate` — passed to `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.
+ * Floating-ui family — replaces `vendors/TippyHeadless` (deprecated in
+ * S4 of this cycle). `tippy.js` has had no release for ≥ 18 months;
+ * `floating-ui` is the de facto successor (maintained by the same author
+ * as Popper, which tippy.js used internally). Hook-based, modern types,
+ * explicit ARIA.
  *
  * @see ./README.md
  * @see ADR-004 §3.1 (vendor isolation convention)

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

@@ -1,17 +1,17 @@
 /**
- * Re-export tipado dos types upstream que o DS expõe.
+ * Typed re-export of the upstream types the DS exposes.
  *
- * - `Placement`        — uma de 12 strings literais (`'top'`, `'top-start'`,
- *   `'top-end'`, `'right'`, …, `'left-end'`). Usado por Tooltip/Dropdown
- *   para tipar a prop `position`.
+ * - `Placement`        — one of 12 literal strings (`'top'`, `'top-start'`,
+ *   `'top-end'`, `'right'`, …, `'left-end'`). Used by Tooltip/Dropdown
+ *   to type the `position` prop.
  * - `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.).
+ * - `MiddlewareData`   — returned by `useFloating()` in
+ *   `middlewareData.arrow.{x,y}` to position inline arrows.
+ * - `OpenChangeReason` — passed to `onOpenChange` callbacks indicating
+ *   what triggered the close (`outside-press`, `escape-key`, etc.).
  *
- * Sem types DS-owned. Convenção ADR-004 §3.1 mantém o arquivo para
- * uniformidade entre vendors.
+ * No DS-owned types. The ADR-004 §3.1 convention keeps the file for
+ * uniformity across vendors.
  *
  * @see ./component.ts
  */

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

@@ -1,18 +1,18 @@
 /**
- * Re-export tipado da surface absorvida de `framer-motion`.
+ * Typed re-export of the absorbed surface of `framer-motion`.
  *
- * Surface absorvida pelo DS:
- * - `motion`           — proxy de elementos HTML/SVG animáveis (usado em
+ * Surface absorbed by the DS:
+ * - `motion`           — proxy of animatable HTML/SVG elements (used in
  *                        `containers/Flex/Flex.style.ts`, `containers/Base/Base.style.ts`).
- * - `AnimatePresence`  — wrapper para animar mount/unmount (usado em Modal,
+ * - `AnimatePresence`  — wrapper to animate mount/unmount (used in Modal,
  *                        Notification).
- * - `MotionConfig`     — root de configuração de motion (usado em
- *                        decorators de teste / Storybook).
- * - `useReducedMotion` — hook que respeita `prefers-reduced-motion`.
+ * - `MotionConfig`     — motion configuration root (used in
+ *                        test / Storybook decorators).
+ * - `useReducedMotion` — hook that respects `prefers-reduced-motion`.
  *
- * Gap intencional (ver README): variants/orchestration avançada (`useAnimate`,
+ * Intentional gap (see README): advanced variants/orchestration (`useAnimate`,
  * `useScroll`, `useMotionTemplate`, layoutGroup, drag, gestures, exit
- * orchestration) — não absorvidos no core hoje.
+ * orchestration) — not absorbed in core today.
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,13 +1,14 @@
 /**
- * Contrato ideal do DS sobre animação declarativa.
+ * The DS's ideal contract for declarative animation.
  *
- * 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`).
+ * Only `MotionProps` is re-exported — props components may accept to
+ * customize transitions at the component root level (e.g.
+ * Notification.interface.ts composes `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).
+ * `Variants`, `Transition`, `Target` and the other framer-motion types stay
+ * **outside the contract** — the DS chooses to restrict the configuration
+ * surface by intent (not exposing the lib's full expressiveness via public
+ * types).
  *
  * @see ./component.ts
  * @see ADR-004 §3.1

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

@@ -1,7 +1,7 @@
 /**
- * Re-export tipado da surface absorvida de `lodash.debounce`.
+ * Typed re-export of the absorbed surface of `lodash.debounce`.
  *
- * Surface absorvida: o default export (função `debounce`).
+ * Absorbed surface: the default export (the `debounce` function).
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,10 +1,10 @@
 /**
- * Contrato ideal do DS sobre debounce de funções.
+ * The DS's ideal contract for function debouncing.
  *
  * @see ./component.ts
  * @see ADR-004 §3.1
  */
-/** Função que executa após período de inatividade da última chamada. */
+/** Function that executes after a period of inactivity since the last call. */
 export type DebouncedFunction<T extends (...args: never[]) => unknown> = T & {
     cancel: () => void;
     flush: () => ReturnType<T> | undefined;

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

@@ -1,11 +1,11 @@
 /**
- * Re-export tipado da surface absorvida de `nanoid`.
+ * Typed re-export of the absorbed surface of `nanoid`.
  *
- * Surface absorvida pelo DS:
- * - `nanoid` (default generator) — id curto + URL-safe para keys React, refs internos.
+ * Surface absorbed by the DS:
+ * - `nanoid` (default generator) — short + URL-safe id for React keys, internal refs.
  *
- * Gap intencional (ver README): geração customizada (`customAlphabet`,
- * `urlAlphabet`), `nanoid/async`, `nanoid/non-secure` — não usados no core.
+ * Intentional gap (see README): custom generation (`customAlphabet`,
+ * `urlAlphabet`), `nanoid/async`, `nanoid/non-secure` — not used in core.
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,11 +1,11 @@
 /**
- * Contrato ideal do DS sobre geração de IDs únicos.
+ * The DS's ideal contract for unique ID generation.
  *
- * Apenas o tipo do generator `nanoid` é absorvido — string opaca,
- * length default 21 chars, URL-safe.
+ * Only the type of the `nanoid` generator is absorbed — opaque string,
+ * default length 21 chars, URL-safe.
  *
  * @see ./component.ts
  * @see ADR-004 §3.1
  */
-/** ID opaco gerado pelo nanoid (URL-safe, default length 21). */
+/** Opaque ID generated by nanoid (URL-safe, default length 21). */
 export type NanoId = string;

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

@@ -1,7 +1,7 @@
 /**
- * Re-export tipado da surface absorvida de `object-hash`.
+ * Typed re-export of the absorbed surface of `object-hash`.
  *
- * Surface absorvida: `sha1` (hash determinístico de objeto JS).
+ * Absorbed surface: `sha1` (deterministic hash of a JS object).
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,8 +1,8 @@
 /**
- * Contrato ideal do DS sobre hashing determinístico de objetos JS.
+ * The DS's ideal contract for deterministic JS object hashing.
  *
  * @see ./component.ts
  * @see ADR-004 §3.1
  */
-/** Hash determinístico (hex string) de qualquer objeto serializável. */
+/** Deterministic hash (hex string) of any serializable object. */
 export type ObjectSha1 = string;

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

@@ -1,11 +1,11 @@
 /**
- * Re-export tipado da surface absorvida de `react-content-loader`.
+ * Typed re-export of the absorbed surface of `react-content-loader`.
  *
- * Surface absorvida:
- * - `ContentLoader` (default) — wrapper SVG-based para skeleton loaders.
+ * Absorbed surface:
+ * - `ContentLoader` (default) — SVG-based wrapper for skeleton loaders.
  * - Presets: `BulletList`, `Code`, `Facebook`, `List`.
  *
- * Usado em `skeleton/ComposedSkeleton`.
+ * Used in `skeleton/ComposedSkeleton`.
  *
  * @see ./README.md
  * @see ADR-004 §3.1

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

@@ -1,8 +1,8 @@
 /**
- * Contrato ideal do DS sobre skeleton loaders.
+ * The DS's ideal contract for skeleton loaders.
  *
- * `IContentLoaderProps` re-exportado para `ComposedSkeleton.interface.ts`
- * tipar props que estendem o contrato do loader.
+ * `IContentLoaderProps` re-exported so `ComposedSkeleton.interface.ts`
+ * can type props extending the loader's contract.
  *
  * @see ./component.ts
  * @see ADR-004 §3.1

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

@@ -1,15 +1,15 @@
 /**
- * Re-export tipado da surface absorvida de `react-day-picker` v9.
+ * Typed re-export of the absorbed surface of `react-day-picker` v9.
  *
- * Surface absorvida pelo DS:
+ * Surface absorbed by the DS:
  *
  * Runtime:
- * - `DayPicker` — componente headless de grid (single/multiple/range). Núcleo
- *   do `elements/Calendar` e, por composição, de `form/InputDate`.
+ * - `DayPicker` — headless grid component (single/multiple/range). Core of
+ *   `elements/Calendar` and, by composition, of `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).
+ * `react-day-picker@9.x` is the successor of `react-day-picker@8` — hook-based
+ * API, types discriminated by `mode`, no embedded CSS (the DS applies the
+ * visuals via `Calendar.style.ts` → theme tokens).
  *
  * @see ./README.md
  * @see ADR-004 §3.1 (vendor isolation convention)

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

@@ -1,18 +1,18 @@
 /**
- * Re-export tipado dos types upstream que o DS expõe.
+ * Typed re-export of the upstream types the DS exposes.
  *
- * - `DayPickerProps`        — union completa (single/multiple/range). Usada
- *   como `type CalendarProps = DayPickerProps` no `elements/Calendar`.
- * - `Mode`                  — `'single' | 'multiple' | 'range'`. Discrimina
+ * - `DayPickerProps`        — complete union (single/multiple/range). Used
+ *   as `type CalendarProps = DayPickerProps` in `elements/Calendar`.
+ * - `Mode`                  — `'single' | 'multiple' | 'range'`. Discriminates
  *   `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).
+ * - `DateRange`             — `{ from: Date; to?: Date }` for `mode="range"`.
+ * - `Matcher`               — date predicate (Date, range, function, etc.)
+ *   used in the `disabled`/`hidden` props. Combinable in an array.
+ * - `PropsSingle` / `PropsSingleRequired`   — single mode (selected: Date | undefined).
+ * - `PropsRange` / `PropsRangeRequired`     — range mode  (selected: DateRange | undefined).
  *
- * Sem types DS-owned. Convenção ADR-004 §3.1 mantém o arquivo para
- * uniformidade entre vendors.
+ * No DS-owned types. The ADR-004 §3.1 convention keeps the file for
+ * uniformity across vendors.
  *
  * @see ./component.ts
  */

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

@@ -1,20 +1,20 @@
 /**
- * Re-export tipado da surface absorvida de `react-hook-form` + bridge
- * adapter `@hookform/resolvers/zod`.
+ * Typed re-export of the absorbed surface of `react-hook-form` + the
+ * `@hookform/resolvers/zod` bridge adapter.
  *
- * Surface absorvida (ADR-007 §3.1):
- * - `useForm` — hook primário; substitui `useFormik` em `form/Form/Form.tsx`.
- * - `Controller` — render-prop wrapper para primitives uncontrolled-resistant
- *   (InputSelect via react-select, InputDate, etc.). Q1 de ADR-007 valida
- *   no PoC se `Controller` vs `register` é usado por field.
- * - `useFormContext` — acesso a `methods` em descendentes (FieldGroup).
- * - `useFieldArray` — multi-value field arrays. Gap absorvido proativamente
- *   para alinhamento com ROADMAP §FormWizard absorption.
- * - `zodResolver` — adapter Zod schema ↔ RHF resolver. Importado de
- *   `@hookform/resolvers/zod`; re-export co-localizado para evitar dois
- *   call-sites distintos em consumers internos.
+ * Absorbed surface (ADR-007 §3.1):
+ * - `useForm` — primary hook; replaces `useFormik` in `form/Form/Form.tsx`.
+ * - `Controller` — render-prop wrapper for uncontrolled-resistant primitives
+ *   (InputSelect via react-select, InputDate, etc.). Q1 of ADR-007 validates
+ *   in the PoC whether `Controller` vs `register` is used per field.
+ * - `useFormContext` — access to `methods` in descendants (FieldGroup).
+ * - `useFieldArray` — multi-value field arrays. Gap absorbed proactively
+ *   for alignment with ROADMAP §FormWizard absorption.
+ * - `zodResolver` — Zod schema ↔ RHF resolver adapter. Imported from
+ *   `@hookform/resolvers/zod`; co-located re-export to avoid two
+ *   distinct call-sites in internal consumers.
  *
- * Surface NÃO absorvida (gap intencional — ver README.md):
+ * Surface NOT absorbed (intentional gap — see README.md):
  * `useWatch` (replaced by `methods.watch`), `useFormState` (replaced by
  * `methods.formState`), `FormProvider` (gap pending real consumer demand —
  * Q1 ADR-007), legacy `Field`-style components.

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

@@ -1,23 +1,23 @@
 /**
- * Contrato ideal do DS sobre `react-hook-form`.
+ * The DS's ideal contract for `react-hook-form`.
  *
- * Tipos re-exportados (ADR-007 §7 PoC + §3.1):
- * - `UseFormReturn` — shape do objeto retornado por `useForm`; substitui
- *   `FormikProps<any>` em `Form.interface.ts#FormRef`.
- * - `UseFormProps` — config aceita por `useForm` (modo de validação, etc.).
- * - `UseFormSetValue` — assinatura do `methods.setValue`; substitui
- *   `FormikHelpers<any>['setFieldValue']` em `Field.interface.ts`.
- * - `FieldErrors` — shape de `formState.errors`; substitui `FormikErrors<...>`
- *   em `onError` callback.
- * - `Control` — objeto opaco propagado para `<Controller>`.
+ * Re-exported types (ADR-007 §7 PoC + §3.1):
+ * - `UseFormReturn` — shape of the object returned by `useForm`; replaces
+ *   `FormikProps<any>` in `Form.interface.ts#FormRef`.
+ * - `UseFormProps` — config accepted by `useForm` (validation mode, etc.).
+ * - `UseFormSetValue` — signature of `methods.setValue`; replaces
+ *   `FormikHelpers<any>['setFieldValue']` in `Field.interface.ts`.
+ * - `FieldErrors` — shape of `formState.errors`; replaces `FormikErrors<...>`
+ *   in the `onError` callback.
+ * - `Control` — opaque object propagated to `<Controller>`.
  * - `FieldPath` — string-literal-typed field name.
- * - `FieldValues` — generic shape para schema values.
+ * - `FieldValues` — generic shape for schema values.
  * - `Mode` — enum union `'onSubmit' | 'onBlur' | 'onChange' | 'onTouched' | 'all'`;
- *   exposto em `Form.interface.ts#FormCommonInterface['mode']` (substitui o
- *   par booleano `validateOnChange?`/`validateOnBlur?` do Formik — decisão
- *   fixada via tech-radar 2026-05-27).
- * - `Resolver` — função resolver (output do `zodResolver(...)`).
- * - `SubmitHandler` — assinatura do callback de submit.
+ *   exposed in `Form.interface.ts#FormCommonInterface['mode']` (replaces
+ *   Formik's boolean pair `validateOnChange?`/`validateOnBlur?` — decision
+ *   fixed via tech-radar 2026-05-27).
+ * - `Resolver` — resolver function (output of `zodResolver(...)`).
+ * - `SubmitHandler` — signature of the submit callback.
  *
  * @see ./component.ts
  * @see ../../../docs/adr/ADR-007-form-stack-rhf-zod.md §7

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

@@ -1,12 +1,12 @@
 /**
- * Re-export tipado da surface absorvida de `react-select` e
+ * Typed re-export of the absorbed surface of `react-select` and
  * `react-select/async`.
  *
- * Surface absorvida:
- * - `DefaultSelect` (default export de `react-select`) — componente síncrono.
- * - `AsyncSelect`   (default export de `react-select/async`) — variante async.
- * - `components`    (named export de `react-select`) — slot overrides
- *                   (usado em `InputSelect/DropdownIndicator.tsx`).
+ * Absorbed surface:
+ * - `DefaultSelect` (default export of `react-select`) — synchronous component.
+ * - `AsyncSelect`   (default export of `react-select/async`) — async variant.
+ * - `components`    (named export of `react-select`) — slot overrides
+ *                   (used in `InputSelect/DropdownIndicator.tsx`).
  *
  * @see ./README.md
  * @see ADR-004 §3.1 · §6 S3

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

@@ -1,17 +1,32 @@
 /**
- * Contrato ideal do DS sobre combobox/select.
+ * The DS's ideal contract for combobox/select.
  *
- * Types absorvidos:
- * - `DropdownIndicatorProps` — para tipar slot custom em
+ * Absorbed types:
+ * - `DropdownIndicatorProps` — to type the custom slot in
  *   `InputSelect/DropdownIndicator.tsx`.
- * - `ReactSelectProps`       — re-export renomeado de `Props` (a fonte
- *   chama `Props`, que é nome genérico demais para vazar pro DS).
+ * - `ReactSelectProps`       — renamed re-export of `Props` (the source
+ *   calls it `Props`, too generic a name to leak into the DS).
  *
- * Gap intencional: tipos avançados como `MenuListProps`, `MultiValue`,
- * `GroupBase`, etc. — adicionar conscientemente se virarem necessários.
- * Creatable, sortable e formatGroupLabel **não** absorvidos.
+ * Intentional gap: advanced types such as `MenuListProps`, `MultiValue`,
+ * `GroupBase`, etc. — add deliberately if they become necessary.
+ * Creatable, sortable and formatGroupLabel **not** absorbed.
  *
  * @see ./component.ts
  * @see ADR-004 §3.1 · §6 S3
  */
-export type { DropdownIndicatorProps, Props as ReactSelectProps } from 'react-select';
+export type { DropdownIndicatorProps, Props as ReactSelectProps, StylesConfig } from 'react-select';
+/**
+ * Custom selectProps the DS threads through react-select (`size` token +
+ * `width`), read back inside `createComponentStyle` via
+ * `state.selectProps`. react-select's documented extension point (module
+ * augmentation of `'react-select/base'`) is unreachable under
+ * `moduleResolution: "bundler"` — the subpath carries no `types` condition
+ * in the package's exports map — so the DS types the extra props explicitly
+ * at the read site instead. The `size` union mirrors the `Input` scale;
+ * kept as a literal here so the vendor wrapper stays dependency-free
+ * (ADR-004).
+ */
+export type DsSelectExtraProps = {
+    size?: 'expansive' | 'medium' | 'compact' | 'micro';
+    width?: number | string;
+};

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

@@ -1,16 +1,16 @@
 /**
- * Re-export tipado da surface absorvida de `styled-components` (6.4.1).
+ * Typed re-export of the absorbed surface of `styled-components` (6.4.1).
  *
- * Surface absorvida (runtime):
- * - `styled`               — default factory de styled components
- * - `css`, `keyframes`     — template literals para CSS dinâmico / animation
- * - `ThemeProvider`        — wrapper de theme (usado por ApollionProvider)
- * - `StyleSheetManager`    — controle de injection (shouldForwardProp etc.)
- * - `createGlobalStyle`    — usado em themes/GlobalStyle
- * - `useTheme`             — hook para ler theme em componentes
+ * Absorbed surface (runtime):
+ * - `styled`               — default styled-components factory
+ * - `css`, `keyframes`     — template literals for dynamic CSS / animation
+ * - `ThemeProvider`        — theme wrapper (used by ApollionProvider)
+ * - `StyleSheetManager`    — injection control (shouldForwardProp etc.)
+ * - `createGlobalStyle`    — used in themes/GlobalStyle
+ * - `useTheme`             — hook to read the theme in components
  *
- * Gap intencional (ver README): `injectGlobal` (removido em v5+), `withTheme`
- * HOC (legacy, prefira useTheme), APIs `__PRIVATE__` (proibido).
+ * Intentional gap (see README): `injectGlobal` (removed in v5+), `withTheme`
+ * HOC (legacy, prefer useTheme), `__PRIVATE__` APIs (forbidden).
  *
  * @see ./interface.ts (types + DefaultTheme augmentation)
  * @see ./README.md

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

@@ -1,19 +1,19 @@
 /**
- * Contrato ideal do DS sobre `styled-components`.
+ * The DS's ideal contract for `styled-components`.
  *
- * Inclui a augmentation global de `DefaultTheme` — movida para cá de
- * `packages/core/src/typings/index.d.ts` durante S0 (ADR-005 §3.1).
+ * Includes the global `DefaultTheme` augmentation — moved here from
+ * `packages/core/src/typings/index.d.ts` during S0 (ADR-005 §3.1).
  *
- * TypeScript module augmentation é GLOBAL — funciona independente de path
- * de import; basta este arquivo ser parte da compilação. Durante S0 a
- * propagação é garantida por um forwarding `import` em
- * `src/typings/index.d.ts` (auto-carregado via `tsconfig#types`). Pós-S1
- * (codemod), o próprio grafo de imports cobre.
+ * TypeScript module augmentation is GLOBAL — it works regardless of import
+ * path; this file only needs to be part of the compilation. During S0,
+ * propagation is guaranteed by a forwarding `import` in
+ * `src/typings/index.d.ts` (auto-loaded via `tsconfig#types`). Post-S1
+ * (codemod), the import graph itself covers it.
  *
- * Types absorvidos (estritamente os usados no core hoje):
- * - `CSSObject`, `Interpolation`, `RuleSet`  — value types do CSS-in-JS DSL
- * - `DefaultTheme`                            — re-exportado para imports diretos
- * - `Styled`, `IStyledComponent`              — types do component factory
+ * Absorbed types (strictly the ones used in core today):
+ * - `CSSObject`, `Interpolation`, `RuleSet`  — value types of the CSS-in-JS DSL
+ * - `DefaultTheme`                            — re-exported for direct imports
+ * - `Styled`, `IStyledComponent`              — component factory types
  *
  * @see ./component.ts
  * @see ADR-005 §3.1 / §5 / §8.1