@apollion-dsi/core 3.0.0

package/lib/form/Field/Field.style.d.ts

@@ -0,0 +1,83 @@
+import { FieldStyleProps } from './Field.interface';
+export declare const FieldContainerStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof FieldStyleProps> & FieldStyleProps, never> & Partial<Pick<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof FieldStyleProps> & FieldStyleProps, never>>> & string;
+export declare const LabelStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>>> & string;
+export declare const OptionalTextStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>>> & string;
+/**
+ * Texto de hint exibido abaixo do input.
+ *
+ * O seletor `&:empty` reserva uma altura mínima (`small`) mesmo sem texto
+ * — evita "saltos" no layout quando uma mensagem aparece/desaparece.
+ */
+export declare const HintTextStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>>> & string;

package/lib/form/Field/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Barrel público do componente `Field`.
+ *
+ * Reexporta a implementação e as interfaces (`FieldInterface`, `FieldVariants`,
+ * `FieldStyleProps`). Os styled-components (`LabelStyle`, `HintTextStyle`,
+ * `OptionalTextStyle`, `FieldContainerStyle`) NÃO são reexportados porque
+ * são usados apenas internamente pelo `Field.tsx` — exportá-los criaria
+ * conflito de nome com `LabelStyle` de `elements/Label`.
+ */
+export * from './Field.interface';
+export { FieldComponent as Field } from './Field';

package/lib/form/Field/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-XW52MLHU.esm.js";import"../../chunks/chunk-LKD55J4V.esm.js";import"../../chunks/chunk-SKV75I6W.esm.js";import"../../chunks/chunk-DEAAQK5J.esm.js";import"../../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-JTQYUIZP.esm.js";import"../../chunks/chunk-VTRVGJA6.esm.js";import"../../chunks/chunk-TAVNLEMI.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{a as Field};

package/lib/form/FieldGroup/FieldGroup.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import { FieldGroupInterface } from './FieldGroup.interface';
+/**
+ * Agrupador de `Checkbox` ou `Radio` em layout de grade.
+ *
+ * Recebe `type="checkbox"` ou `type="radio"` e duas formas de declarar os
+ * itens (mutuamente exclusivas):
+ * - `inputs` — array de objetos `{ label, value, name, ... }` (mais comum).
+ * - `children` — elementos JSX customizados (para casos onde precisa de
+ *   labels ricos ou outros wrappers).
+ *
+ * `value` é o estado controlado: string para `radio` ou array para
+ * `checkbox`. O `onChange` recebe o novo valor inteiro (não o evento).
+ *
+ * @example
+ * ```tsx
+ * <FieldGroup
+ *   type="checkbox"
+ *   name="prefs"
+ *   value={['email']}
+ *   onChange={setValue}
+ *   columns={2}
+ *   inputs={[
+ *     { value: 'email', label: 'E-mail' },
+ *     { value: 'sms', label: 'SMS' },
+ *   ]}
+ * />
+ * ```
+ *
+ * @see {@link FieldGroupInterface} para o detalhamento das props.
+ */
+export declare const FieldGroupComponent: {
+    (props: FieldGroupInterface): React.JSX.Element;
+    displayName: string;
+};

package/lib/form/FieldGroup/FieldGroup.helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Helpers do `FieldGroup` — utilitários puros para converter `columns` e
+ * `gap` no formato esperado por `grid-template-columns`/`gridRowGap`/etc.
+ */
+/**
+ * Converte `columns` em uma string `grid-template-columns`.
+ *
+ * `columns=3` → `'min-content min-content min-content'` (cada coluna se
+ * ajusta ao conteúdo). Quando `columns` é falsy, retorna `'1fr'` — coluna
+ * única que ocupa o espaço disponível.
+ */
+export declare function getGridColumns(columns: number): string;
+/**
+ * Desempacota `gap` em `[rowGap, columnGap]`.
+ *
+ * Aceita um valor simples (aplica nos dois eixos) ou um objeto com
+ * `row`/`column` para controle independente.
+ */
+export declare function getGridGap(gap: any): any[];

package/lib/form/FieldGroup/FieldGroup.interface.d.ts

@@ -0,0 +1,75 @@
+import { XOR } from '../../utils';
+import { CheckboxInterface } from '../Checkbox';
+/**
+ * Tamanho do gap (em pixels ou string CSS). Aceita objeto `{ row, column }`
+ * para definir cada eixo separadamente.
+ */
+type Gap = number | string;
+/**
+ * Props compartilhadas independente da forma de declaração (`inputs` ou
+ * `children`).
+ */
+interface CheckboxGroupCommonInterface extends Omit<CheckboxInterface, 'value'> {
+    /**
+     * Valor selecionado.
+     * - Para `type="checkbox"`: array de strings.
+     * - Para `type="radio"`: string única.
+     */
+    value: string | string[];
+    /** Tipo dos itens. */
+    type: 'radio' | 'checkbox';
+    /**
+     * Espaçamento da grade. Quando objeto, define `row` e `column` separados.
+     *
+     * @example
+     * ```tsx
+     * <FieldGroup gap={10} ... />
+     * <FieldGroup gap={{ row: 8, column: 24 }} ... />
+     * ```
+     */
+    gap?: Gap | {
+        row?: Gap;
+        column?: Gap;
+    };
+    /**
+     * Número de colunas da grade (`grid-template-columns: min-content × N`).
+     * Quando ausente, usa `1fr` (coluna única).
+     */
+    columns?: number;
+}
+/**
+ * Forma 1: declarar itens via `inputs` (array de objetos).
+ *
+ * Cada item passa props nativas de `<input>` (`name`, `value`, `disabled`,
+ * etc.) mais `label`.
+ */
+interface GroupInputs {
+    inputs: Array<{
+        label: string;
+    } & React.ComponentPropsWithoutRef<'input'>>;
+}
+/**
+ * Props do componente `FieldGroup`.
+ *
+ * Use `inputs` para casos simples (array de `{ label, value }`) e
+ * `children` para casos onde precisa renderizar checkboxes/radios com
+ * conteúdo customizado. As duas formas são mutuamente exclusivas (XOR).
+ *
+ * @example
+ * ```tsx
+ * <FieldGroup
+ *   type="radio"
+ *   name="plan"
+ *   value="pro"
+ *   onChange={setPlan}
+ *   inputs={[
+ *     { value: 'basic', label: 'Básico' },
+ *     { value: 'pro', label: 'Pro' },
+ *   ]}
+ * />
+ * ```
+ */
+export type FieldGroupInterface = CheckboxGroupCommonInterface & XOR<GroupInputs, {
+    children: React.ReactNode;
+}>;
+export {};

package/lib/form/FieldGroup/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Barrel público do componente `FieldGroup`.
+ *
+ * Reexporta a implementação e a interface. `FieldGroup` é um agrupador
+ * de `Checkbox`/`Radio` — depende de ambos via barrel.
+ */
+export * from './FieldGroup.interface';
+export { FieldGroupComponent as FieldGroup } from './FieldGroup';

package/lib/form/FieldGroup/index.esm.js

@@ -0,0 +1 @@
+import{a}from"../../chunks/chunk-TR4PVAXI.esm.js";import"../../chunks/chunk-XNCMA56H.esm.js";import"../../chunks/chunk-DAFBKFTS.esm.js";import"../../chunks/chunk-GXCDUA3V.esm.js";import"../../chunks/chunk-EWFUWYNO.esm.js";import"../../chunks/chunk-BKF5RIHP.esm.js";import"../../chunks/chunk-7PD7R2RB.esm.js";import"../../chunks/chunk-CSVGEHXH.esm.js";import"../../chunks/chunk-OMBZMCKV.esm.js";import"../../chunks/chunk-7VYSPE3B.esm.js";import"../../chunks/chunk-JIDBKHKA.esm.js";import"../../chunks/chunk-LKD55J4V.esm.js";import"../../chunks/chunk-HK3DHNXU.esm.js";import"../../chunks/chunk-SKV75I6W.esm.js";import"../../chunks/chunk-DEAAQK5J.esm.js";import"../../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-JTQYUIZP.esm.js";import"../../chunks/chunk-VTRVGJA6.esm.js";import"../../chunks/chunk-TAVNLEMI.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{a as FieldGroup};

package/lib/form/Form/Form.d.ts

@@ -0,0 +1,5 @@
+import React, { Ref } from 'react';
+import { FormFieldsType, FormInterface, FormRef } from './Form.interface';
+export declare const FormComponent: <Fields extends FormFieldsType>(props: FormInterface<Fields> & {
+    ref?: Ref<FormRef>;
+}) => React.ReactElement;

package/lib/form/Form/Form.helpers.d.ts

@@ -0,0 +1,45 @@
+import { FormikHelpers } from 'formik';
+import { FormFieldsType, FormInterface, NewFieldType, ValidationSchemaType, Values } from './Form.interface';
+/**
+ * Extrai o valor primitivo de uma `OptionType` (`{ value, label }`) — ou
+ * devolve o valor original quando não é objeto.
+ *
+ * Necessário porque `InputSelect` armazena o objeto completo no Formik
+ * (precisa do `label` para renderizar) mas o backend quase sempre quer só
+ * o `.value`.
+ */
+export declare function normalizeValues(v: any): any;
+/**
+ * Normaliza todos os valores antes de chamar `handleSubmit`.
+ *
+ * Aplica {@link normalizeValues} em cada campo — converte `OptionType` para
+ * primitivos para que o `handleSubmit` receba um objeto plano `{ key: value }`
+ * pronto para serialização.
+ */
+export declare function prepareSubmit<Fields extends FormFieldsType>(values: Values<Fields>, formikHelpers: FormikHelpers<Values<Fields>>, callback: FormInterface<Fields>['handleSubmit']): void;
+/**
+ * Constrói o `validationSchema` aceito pelo Formik a partir do mapa `fields`.
+ *
+ * Campos sem `validation` recebem `Yup.string()` (opcional, sem regra) —
+ * mantém a tipagem consistente sem forçar regras desnecessárias.
+ */
+export declare function getValidationSchema(fields: FormFieldsType): ValidationSchemaType;
+/**
+ * Helper de identidade para declarar fields com tipagem estrita.
+ *
+ * Sem ele, TypeScript não consegue inferir os tipos de `inputProps`
+ * baseado no `component` declarado — `newField({ component: Input, ... })`
+ * faz o `inputProps` ser tipado como `ComponentProps<typeof Input>`.
+ *
+ * @example
+ * ```tsx
+ * const fields = {
+ *   email: newField({
+ *     component: Input,
+ *     label: 'E-mail',
+ *     inputProps: { type: 'email' }, // ← tipado
+ *   }),
+ * };
+ * ```
+ */
+export declare const newField: NewFieldType;

package/lib/form/Form/Form.interface.d.ts

@@ -0,0 +1,122 @@
+import { FormikErrors, FormikHelpers, FormikProps, FormikSharedConfig } from 'formik';
+import { FlexPropsInterface, GridBreakpoints, GridPropsInterface } from '../../containers';
+import { XOR } from '../../utils';
+import { FieldInterface } from '../Field';
+import { OptionType } from '../InputSelect';
+/** Esquema de validação Yup (ou função que devolve um). */
+export type ValidationTypes = any | (() => any);
+/** Mapa de validações por nome de campo — feito de `Yup.string()`/`Yup.number()`/etc. */
+export type ValidationSchemaType = Record<string, ValidationTypes>;
+/**
+ * Tipos aceitos para `initialValues` — strings, números, booleanos, opções
+ * de select (`OptionType`) ou arrays para multi-select/checkbox group.
+ */
+export type InitialValuesTypesInterface = string | boolean | number | OptionType<any> | Array<any>;
+/**
+ * `FieldInterface` + `validation` opcional — usado nas chaves de `fields`
+ * para que cada campo declare sua regra Yup junto.
+ */
+export type FieldInterfaceWithValidationType<T extends React.ElementType<any> = any> = FieldInterface<T> & {
+    validation?: ValidationTypes;
+};
+/** Mapa nomeado de fields aceito pelo `Form`. */
+export type FormFieldsType = Record<string, FieldInterfaceWithValidationType>;
+/**
+ * Helper de tipagem usado em `newField(...)` — preserva o tipo `T` do
+ * `component` no campo declarado, permitindo type-check estrito de
+ * `inputProps`.
+ */
+export type NewFieldType = <T extends React.ElementType<any>>(field: FieldInterfaceWithValidationType<T>) => FieldInterface<T>;
+/** Mapa de valores derivado do mapa de fields (chaves opcionais). */
+export type Values<T> = {
+    [key in keyof T]?: InitialValuesTypesInterface;
+};
+type NativeFormProps = Omit<React.ComponentPropsWithoutRef<'form'>, 'onError' | 'children'>;
+/**
+ * Ref imperativa exposta pelo `Form` — é a API completa do Formik
+ * (`setFieldValue`, `submitForm`, `resetForm`, `validateForm`, ...).
+ */
+export type FormRef = FormikProps<any>;
+/**
+ * Props comuns do `Form` — independente da variante (Flex vs Grid).
+ */
+export interface FormCommonInterface<Fields extends FormFieldsType> extends NativeFormProps {
+    /** Mapa de fields. Cada chave vira nome do campo, área do Grid e id/htmlFor. */
+    fields: Fields;
+    /** Callback chamado com os valores normalizados após validação OK. */
+    handleSubmit: (values?: Values<Fields>, formikHelpers?: FormikHelpers<Values<Fields>>) => void;
+    initialValues?: Values<Fields>;
+    /**
+     * Conteúdo extra renderizado após os fields. Aceita JSX direto ou função
+     * `(values) => ReactNode` quando o botão depende dos valores atuais.
+     */
+    children?: React.ReactNode | ((values: Values<Fields>) => React.ReactNode);
+    /**
+     * Texto do botão de submit padrão (quando `children` não é informado).
+     *
+     * @default 'Enviar'
+     */
+    submitLabel?: string;
+    /**
+     * Validação a cada keystroke. Caro em formulários grandes — prefira
+     * `validateOnBlur` para feedback após o usuário sair do campo.
+     *
+     * @default false
+     */
+    validateOnChange?: FormikSharedConfig['validateOnChange'];
+    /**
+     * Validação ao perder foco.
+     *
+     * @default false
+     */
+    validateOnBlur?: FormikSharedConfig['validateOnBlur'];
+    /** Callback disparado quando o objeto de erros muda (debounced por `deepEqual`). */
+    onError?: (errors: FormikErrors<Values<Fields>>) => void;
+    /**
+     * Map de funções que determinam se cada campo deve renderizar conforme
+     * os valores atuais. Útil para formulários dinâmicos (mostrar/ocultar
+     * campos baseado em escolhas anteriores).
+     *
+     * @example
+     * ```tsx
+     * conditionalFields={{
+     *   spouse: (v) => v.maritalStatus === 'married',
+     * }}
+     * ```
+     */
+    conditionalFields?: {
+        [key in keyof Fields]?: (v: Partial<Values<Fields>>) => boolean;
+    };
+}
+/**
+ * Variante Grid — usa `medias` para definir breakpoints e áreas nomeadas.
+ */
+export interface FormGrid extends GridPropsInterface {
+    medias?: GridBreakpoints;
+}
+/**
+ * Variante Flex — coluna vertical simples (sem `medias`).
+ */
+export interface FormFlex extends FlexPropsInterface {
+    medias?: never;
+}
+/**
+ * Props do componente `Form`.
+ *
+ * Use `medias` para layout responsivo em grade; omita para coluna simples.
+ *
+ * @example
+ * ```tsx
+ * // Layout simples
+ * <Form handleSubmit={onSubmit} fields={{ ... }} />
+ *
+ * // Layout em grade responsiva
+ * <Form
+ *   handleSubmit={onSubmit}
+ *   fields={{ ... }}
+ *   medias={{ xs: { areas: '"name" "email"' }, sm: { areas: '"name email"' } }}
+ * />
+ * ```
+ */
+export type FormInterface<F extends FormFieldsType> = FormCommonInterface<F> & XOR<FormFlex, FormGrid>;
+export {};

package/lib/form/Form/Form.style.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Variante Flex do `<form>` — coluna vertical, ocupa 100% da largura
+ * disponível. Usada quando o consumidor não passa `medias`.
+ */
+export declare const FormFlexStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("react").ClassAttributes<HTMLFormElement> | keyof import("react").FormHTMLAttributes<HTMLFormElement>> & import("react").ClassAttributes<HTMLFormElement> & import("react").FormHTMLAttributes<HTMLFormElement>, "width" | "as"> & Partial<Pick<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("react").ClassAttributes<HTMLFormElement> | keyof import("react").FormHTMLAttributes<HTMLFormElement>> & import("react").ClassAttributes<HTMLFormElement> & import("react").FormHTMLAttributes<HTMLFormElement>, "width" | "as">>> & string;
+/**
+ * Variante Grid do `<form>` — usa `Grid` com `medias` para áreas
+ * responsivas. Cada chave de `fields` no `Form` vira uma `grid-area`.
+ */
+export declare const FormGridStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("../..").DefaultGridInterface> & import("../..").DefaultGridInterface, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("../..").DefaultGridInterface> & import("../..").DefaultGridInterface, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("react").ClassAttributes<HTMLFormElement> | keyof import("react").FormHTMLAttributes<HTMLFormElement>> & import("react").ClassAttributes<HTMLFormElement> & import("react").FormHTMLAttributes<HTMLFormElement>, "width" | "as"> & Partial<Pick<import("styled-components").FastOmit<import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("../..").DefaultGridInterface> & import("../..").DefaultGridInterface, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("../..").DefaultGridInterface> & import("../..").DefaultGridInterface, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, keyof import("react").ClassAttributes<HTMLFormElement> | keyof import("react").FormHTMLAttributes<HTMLFormElement>> & import("react").ClassAttributes<HTMLFormElement> & import("react").FormHTMLAttributes<HTMLFormElement>, "width" | "as">>> & string;

package/lib/form/Form/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Barrel público do componente `Form`.
+ *
+ * Reexporta a implementação, todas as interfaces (`FormInterface`,
+ * `FormFieldsType`, `FormRef`, etc.), helpers (`newField`, `prepareSubmit`,
+ * `getValidationSchema`) e os styled-components. `newField` é o helper
+ * usado para declarar fields com tipagem estrita.
+ */
+export * from './Form.interface';
+export * from './Form.style';
+export * from './Form.helpers';
+export { FormComponent as Form } from './Form';

package/lib/form/Form/index.esm.js

@@ -0,0 +1 @@
+import{a,b,c,d,e,f,g}from"../../chunks/chunk-LXG3BZB5.esm.js";import"../../chunks/chunk-XW52MLHU.esm.js";import"../../chunks/chunk-LKD55J4V.esm.js";import"../../chunks/chunk-SKV75I6W.esm.js";import"../../chunks/chunk-DEAAQK5J.esm.js";import"../../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-JTQYUIZP.esm.js";import"../../chunks/chunk-VTRVGJA6.esm.js";import"../../chunks/chunk-TAVNLEMI.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{g as Form,a as FormFlexStyle,b as FormGridStyle,e as getValidationSchema,f as newField,c as normalizeValues,d as prepareSubmit};

package/lib/form/Input/Input.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { InputInterface } from './Input.interface';
+/**
+ * Campo de entrada de texto base do Apollion.
+ *
+ * Serve como fundação para outros inputs do design system
+ * (`InputCurrency`, `InputDate`, `InputMask`, `Checkbox`, `Radio`, `TextArea`).
+ * Aceita todas as props nativas de `<input>` (exceto `size`, que aqui controla
+ * o token de altura/padding) e adiciona ícones, variantes de estado e a opção
+ * `clearable` para limpar o valor com um clique.
+ *
+ * @example
+ * ```tsx
+ * <Input size="medium" placeholder="Digite seu nome" />
+ * <Input variant="error" value={value} onChange={onChange} />
+ * <Input clearable reset={() => setValue('')} value={value} onChange={onChange} />
+ * <Input icon={<Icon name="search" />} iconPosition="left" />
+ * ```
+ *
+ * @see {@link InputInterface} para o detalhamento das props.
+ */
+export declare const InputComponent: React.ForwardRefExoticComponent<InputInterface & React.RefAttributes<HTMLInputElement>>;

package/lib/form/Input/Input.helpers.d.ts

@@ -0,0 +1,21 @@
+import { InputInterface, InputTokenProps } from './Input.interface';
+/**
+ * Tokens de estilo por tamanho do `Input`.
+ *
+ * Cada entrada define `py` (padding vertical), `fontSize`, `borderRadius` e
+ * `height` exatos para que o input mantenha proporções consistentes com o
+ * resto da escala de componentes (`Button`, `InputSelect`, etc.).
+ */
+export declare const inputTokens: Record<InputInterface['size'], Partial<InputTokenProps>>;
+/**
+ * Resolve qual ícone (se algum) deve ser renderizado no slot interno do input.
+ *
+ * Ordem de precedência:
+ * 1. Botão de limpar (quando `clearable && value && !readOnly`).
+ * 2. Ícone customizado (`icon`) passado pelo consumidor.
+ * 3. Ícone implícito de status (`✕` para erro, `✓` para sucesso).
+ *
+ * Função interna; outros inputs do design system consomem o slot via prop
+ * `icon` no `Input`, não diretamente.
+ */
+export declare function getIconComponent({ icon, variant, clearable, reset, value, readOnly }: InputInterface): any;