@elcrm/form 0.1.3 → 0.1.4

package/dist/Form.d.ts

@@ -1,9 +1,16 @@
 import { TModalOpenPayload } from './FormInitContext';
 export type { TModalOpenPayload };
+/**
+ * Пропы {@link Form}.Init — регистрация колбэков для всех полей приложения.
+ */
 export type FormInitProps = {
-    /** Уведомления (копирование в буфер и т.п.) */
+    /** Тост: копирование телефона и т.п. */
     onNotice?: (message: string) => void;
-    /** Модальные окна выбора для полей ModalField / OptionsField (`modal="module.name"`) */
+    /**
+     * Открыть модалку выбора.
+     * Payload: `module` + `modalName` из пропа `modal="module.name"`,
+     * `callback(value)` — вернуть выбор в поле.
+     */
     onModal?: (payload: TModalOpenPayload) => void;
 };
 /**
@@ -14,7 +21,18 @@ declare function Init({ onNotice, onModal }: FormInitProps): null;
 declare namespace Init {
     var displayName: string;
 }
-/** Пространство имён: `Form.Init` */
+/**
+ * Пространство имён формы приложения.
+ *
+ * **`Form.Init`** — зарегистрировать `onNotice` (тосты) и `onModal` (Options/Modal).
+ * Ничего не рисует (`null`). Монтировать один раз рядом с формой.
+ *
+ * @example
+ * <>
+ *   <Form.Init onNotice={toast} onModal={openModal} />
+ *   <PhoneField name="phone" form={form} />
+ * </>
+ */
 export declare const Form: {
     Init: typeof Init;
 };

package/dist/core/Field.d.ts

@@ -18,6 +18,12 @@ export type FieldControlProps = {
     className?: string[];
     props?: Record<string, unknown>;
 };
+/**
+ * Пропы внутреннего каркаса. Снаружи не импортируйте — берите `*Field`.
+ *
+ * `children` — контрол **внутри** капсулы. Слоты `before`/`after` здесь
+ * рисуются **снаружи** капсулы (отличие от публичных полей).
+ */
 interface Input {
     /**
      * Классы корневого блока.
@@ -45,5 +51,11 @@ interface Input {
     /** s | m | l — высота как у кнопки/поиска (`sm`/`md` — алиасы) */
     size?: "s" | "m" | "l" | "sm" | "md";
 }
+/**
+ * Каркас поля (внутренний). Снаружи используйте `*Field`.
+ *
+ * **Элементы:** `[data-field][data-size]` → `label.t` → капсула `.f` (`control` / `element_input`) → ошибка.
+ * Слоты `before`/`after` на **этом** компоненте — вне капсулы; у `*Field` слоты внутри капсулы.
+ */
 declare const Field: ({ element_blok, blok, element_input, control, type, label, id: idProp, error, before, after, children, size, }: Input) => import("react/jsx-runtime").JSX.Element;
 export default Field;

package/dist/fields/Card.d.ts

@@ -1,9 +1,23 @@
 import { default as React } from 'react';
 import { TInput } from './type';
+/**
+ * Номер банковской карты.
+ *
+ * **В форме:** `string` — только цифры (без пробелов).
+ *
+ * **Элементы:** слева бейдж бренда (`before`, если не задан свой), группы `0000 0000 …`.
+ * Иконка: Visa/Мир с 4 цифр; если unknown — ждём до 6 (Mastercard 2xxx). Луна на blur, если `validate`.
+ *
+ * @example
+ * <CardField name="card" form={form} label="Карта" />
+ */
 export type TCard = TInput & {
     /** Встроенная проверка Луна (по умолчанию true) */
     validate?: boolean;
 };
+/**
+ * Поле карты. Бейдж не пересчитывается после freeze BIN, пока не сменятся первые 4 цифры.
+ */
 declare function CardField({ value, form, onValue, onBlur: onBlurField, name, placeholder, label, error, hidden, disabled, className, after, before, maxLength, autoComplete, id, size, validate, }: TCard): import("react/jsx-runtime").JSX.Element | null;
 declare namespace CardField {
     var displayName: string;

package/dist/fields/Check.d.ts

@@ -3,6 +3,17 @@ export type TCheckSize = "s" | "m" | "l" | "sm" | "md";
 export type TCheckVariant = "field" | "plain";
 /** Выравнивание квадрата относительно текста (многострочный label) */
 export type TCheckAlign = "top" | "center" | "bottom";
+/**
+ * Чекбокс (кнопка `role="checkbox"` внутри капсулы).
+ *
+ * **В форме:** `boolean` (`true`/`false`; снаружи также понимает `1`/`"true"`).
+ *
+ * **Элементы:** квадрат + текст из `placeholder` (не `label`). `label` — подпись над капсулой.
+ * `variant="plain"` — без рамки (меню). `align` — квадрат относительно многострочного текста.
+ *
+ * @example
+ * <CheckField name="agree" form={form} label="Согласие" placeholder="Принимаю условия" />
+ */
 export type TCheck = TInput & {
     /**
      * Плотность: `md` — как поле формы (по умолчанию),
@@ -22,6 +33,9 @@ export type TCheck = TInput & {
     /** Квадрат: top | center | bottom относительно текста. По умолчанию center */
     align?: TCheckAlign;
 };
+/**
+ * Чекбокс. Клик по строке переключает значение.
+ */
 declare function CheckField({ value, form, onValue, onBlur: onBlurField, name, placeholder, label, error, hidden, disabled, className, after, before, size, variant, showFocusRing, align, }: TCheck): import("react/jsx-runtime").JSX.Element | null;
 declare namespace CheckField {
     var displayName: string;

package/dist/fields/Code.d.ts

@@ -1,5 +1,15 @@
 import { TInput } from './type';
-/** CodeField / OTP — ряд отдельных ячеек. Значение: строка. */
+/**
+ * OTP / код — ряд квадратных ячеек.
+ *
+ * **В форме:** `string` длины `length`.
+ *
+ * **Элементы:** капсула без внутреннего padding → ячейки. `group` — визуальный разделитель.
+ * `cellSize` бьёт `--field-code-size`.
+ *
+ * @example
+ * <CodeField name="otp" form={form} label="Код" length={6} group={3} />
+ */
 export type TCode = TInput & {
     length?: number;
     /** Только цифры (по умолчанию) */
@@ -16,6 +26,9 @@ export type TCode = TInput & {
      */
     cellSize?: number | string;
 };
+/**
+ * Поле кода. Вставка заполняет ячейки подряд.
+ */
 declare function CodeField({ value, form, onValue, onBlur: onBlurField, name, placeholder, label, error, hidden, disabled, className, after, before, size, length, numeric, group, cellSize, autoComplete, }: TCode): import("react/jsx-runtime").JSX.Element | null;
 declare namespace CodeField {
     var displayName: string;

package/dist/fields/Color.d.ts

@@ -1,6 +1,16 @@
 import { TInput } from './type';
 export { DEFAULT_COLOR_PALETTE, parseHexColor, formatHexColor } from './colorUtils';
 export type { Hsva } from './colorUtils';
+/**
+ * Цвет (hex). Попап: SV-плоскость, hue, опционально alpha, hex-инпут.
+ *
+ * **В форме:** `string` `#RRGGBB` или `#RRGGBBAA`.
+ *
+ * **Элементы:** капсула → превью-квадрат + текст hex. `inlinePalette` — пресеты **в поле**, не в попапе.
+ *
+ * @example
+ * <ColorField name="accent" form={form} label="Цвет" inlinePalette />
+ */
 export type TColor = TInput & {
     /** Свои пресеты; иначе встроенная палитра */
     colors?: string[];
@@ -12,6 +22,9 @@ export type TColor = TInput & {
      */
     inlinePalette?: boolean;
 };
+/**
+ * Пикер цвета. Триггер — combobox внутри капсулы.
+ */
 declare function ColorField({ value, form, onValue, onBlur: onBlurField, name, placeholder, label, error, hidden, disabled, className, after, before, colors, alpha, inlinePalette, }: TColor): import("react/jsx-runtime").JSX.Element | null;
 declare namespace ColorField {
     var displayName: string;

package/dist/fields/ColorPanel.d.ts

@@ -1,5 +1,9 @@
 import { default as React } from 'react';
 import { Hsva } from './colorUtils';
+/**
+ * Попап пикера {@link ColorField}: SV, hue, alpha, hex, опционально палитра.
+ * Не публичный API. Позиция — `parent` (rect триггера) + clamp во вьюпорт.
+ */
 export default function ColorPanel({ parent, hsva, setHsva, hexDraft, setHexDraft, alpha, palette, showPalette, onLive, onCommit, onClose, }: {
     parent?: DOMRect;
     hsva: Hsva;

package/dist/fields/Date.d.ts

@@ -1,13 +1,25 @@
 import { default as React } from 'react';
 import { TInput } from './type';
-/** DateField — дата с календарём. Значение в form: `YYYY-MM-DD` | `""`. */
+/**
+ * Дата с выпадающим календарём (портал).
+ *
+ * **В форме:** `string` `YYYY-MM-DD` или `""`.
+ *
+ * **Элементы:** капсула → кнопка-триггер с текстом `дд.мм.гггг`.
+ * `icon` — **полная замена** триггера (не слот `before`). `min`/`max` — `Date`.
+ *
+ * @example
+ * <DateField name="due" form={form} label="Срок" min={new Date()} />
+ */
 export type TDate = TInput & {
     max?: Date;
     min?: Date;
     /** Полная замена UI своим триггером (не аффикс) */
     icon?: () => React.JSX.Element;
 };
-/** DateField — дата с выпадающим календарём. */
+/**
+ * Поле даты. Календарь следует за полем при скролле страницы.
+ */
 declare function DateField({ label, error, hidden, className, placeholder, disabled, onValue, max, min, form, icon, name, value, after, before, }: TDate): import("react/jsx-runtime").JSX.Element;
 declare namespace DateField {
     var displayName: string;

package/dist/fields/DateCalendar.d.ts

@@ -1,14 +1,24 @@
 import { TDatePosition } from './dateUtils';
+/**
+ * Попап календаря {@link DateField} (портал в `document.body`, якорь при скролле).
+ * Не публичный API пакета.
+ */
 export type TDateCalendarProps = {
+    /** Текущая дата поля (пустое → сегодня в сетке, не в форме). */
     date: Date | string | number;
+    /** Коммит `YYYY-MM-DD`. */
     onValue: (value: string) => void;
+    /** Прямоугольник триггера для позиционирования. */
     position: TDatePosition;
     max?: Date;
     min?: Date;
     className?: string;
+    /** Закрытие попапа. */
     onOpen: (open: boolean) => void;
 };
-/** Попап календаря даты (портал). */
+/**
+ * Календарь: дни / месяцы / годы. z-index из общего стека оверлеев.
+ */
 declare function DateCalendar({ date, onValue, position, max, min, className, onOpen, }: TDateCalendarProps): import("react/jsx-runtime").JSX.Element;
 declare namespace DateCalendar {
     var displayName: string;

package/dist/fields/Display.d.ts

@@ -1,7 +1,11 @@
 import { TInput } from './type';
 /**
- * DisplayField (Readonly) — только показ значения.
- * Вид как у StringField / TextareaField (капсула + disabled).
+ * Только показ значения (капсула как у String / Textarea, всегда `data-disabled`).
+ *
+ * **В форме:** любое; на экран идёт `format(value)` или `emptyText`.
+ *
+ * @example
+ * <DisplayField name="id" form={form} label="ID" format={(v) => `#${v}`} />
  */
 export type TDisplay = TInput & {
     /** Форматтер отображаемого текста */
@@ -13,6 +17,9 @@ export type TDisplay = TInput & {
      */
     multiline?: boolean;
 };
+/**
+ * Readonly-поле. Не пишет в форму при клике.
+ */
 declare function DisplayField({ value, form, name, placeholder, label, error, hidden, disabled, className, after, before, format, emptyText, size, multiline, }: TDisplay): import("react/jsx-runtime").JSX.Element | null;
 declare namespace DisplayField {
     var displayName: string;

package/dist/fields/DragDrop.d.ts

@@ -1,7 +1,17 @@
 import { TInput } from './type';
 /** Раскладка зоны: default · fill (100% родителя) · overlay (прозрачная поверх превью) */
 export type TDragDropLayout = "default" | "fill" | "overlay";
-/** DragDropField — зона перетаскивания файлов (+ клик для выбора). */
+/**
+ * Зона drag-and-drop (+ клик = тот же выбор файла).
+ *
+ * **В форме:** как {@link FileField} (`keepFile` / мета).
+ *
+ * **Элементы:** пунктирная зона `.z` внутри прозрачной капсулы; список файлов под ней.
+ * `layout`: `default` | `fill` | `overlay`.
+ *
+ * @example
+ * <DragDropField name="files" form={form} multiple maxFiles={5} hint="Перетащите сюда" />
+ */
 export type TDragDrop = TInput & {
     accept?: string;
     multiple?: boolean;
@@ -29,6 +39,9 @@ export type TDragDrop = TInput & {
     /** Скрыть список файлов и «Очистить всё» (часто с overlay) */
     hideList?: boolean;
 };
+/**
+ * Drop-зона. Капсула без рамки (`padding: 0`), рамка у внутренней зоны.
+ */
 declare function DragDropField({ value, form, onValue, onBlur: onBlurField, name, placeholder, label, error, hidden, disabled, className, after, before, accept, multiple, maxSize, maxFiles, keepFile, hint, append, layout, aspectRatio, hideList, }: TDragDrop): import("react/jsx-runtime").JSX.Element | null;
 declare namespace DragDropField {
     var displayName: string;

package/dist/fields/Email.d.ts

@@ -1,10 +1,22 @@
 import { default as React } from 'react';
 import { TInput } from './type';
-/** EmailField — нативный input type=email + опциональная проверка формата. */
+/**
+ * Email. Нативный `<input type="email">`.
+ *
+ * **В форме:** `string`.
+ *
+ * @property validate — проверка формата на blur (по умолчанию `true`); ошибка «Некорректный email».
+ *
+ * @example
+ * <EmailField name="email" form={form} label="Почта" autoComplete="email" />
+ */
 export type TEmail = TInput & {
-    /** Проверка формата при blur (по умолчанию true) */
+    /** Проверка формата при blur (по умолчанию `true`) */
     validate?: boolean;
 };
+/**
+ * Поле email. Справа при ошибке валидации — бейдж, если не задан `after`.
+ */
 declare function EmailField({ validate, error, onBlur, onValue, after, ...rest }: TEmail): import("react/jsx-runtime").JSX.Element;
 declare namespace EmailField {
     var displayName: string;

package/dist/fields/FieldGroup.d.ts

@@ -13,14 +13,21 @@ type GroupOwned = "form" | "onValue" | "onBlur";
  * Редкие пропы можно передать через assertion или расширить тип.
  */
 type FieldGroupItemExtras = {
+    /** Select / Radio / Tabs / Options */
     options?: unknown;
+    /** Select: порядок id */
     order?: number[];
+    /** Mask: шаблон `_` */
     format?: string;
+    /** Code: число ячеек */
     length?: number;
+    /** Code: визуальные группы */
     group?: number;
     cellSize?: number | string;
     numeric?: boolean;
+    /** Card / Email: проверка на blur */
     validate?: boolean;
+    /** Money: множитель записи в форму */
     course?: number;
     isClear?: boolean;
     decimals?: number;
@@ -47,6 +54,7 @@ type FieldGroupItemExtras = {
     colors?: string[];
     alpha?: boolean;
     emptyText?: string;
+    /** Options / Modal: `"module.name"` */
     modal?: string;
     inlinePalette?: boolean;
     outFormat?: "array" | "string" | "object";
@@ -70,6 +78,20 @@ export type FieldGroupItem = {
     /** Имя в form / onValue */
     name: string;
 } & Partial<Omit<TInput, GroupOwned | "name">> & FieldGroupItemExtras;
+/**
+ * Несколько полей одним списком `items`.
+ *
+ * **Элементы:** `div[role=group]` → внутри обычные `*Field`.
+ * Общие `form` / `disabled` / `size` / `errors` на группе; у item — `field` + `name` + свои пропы.
+ *
+ * `field`: `string` → StringField, `select` → SelectField, `card` → CardField, …
+ *
+ * @example
+ * <FieldGroup form={form} items={[
+ *   { field: "string", name: "login", label: "Логин", native: true },
+ *   { field: "email", name: "email", label: "Почта" },
+ * ]} />
+ */
 export type FieldGroupProps = Omit<HTMLAttributes<HTMLDivElement>, "onChange"> & {
     items: FieldGroupItem[];
     /** Общая форма для всех items */
@@ -96,9 +118,7 @@ export type FieldGroupProps = Omit<HTMLAttributes<HTMLDivElement>, "onChange"> &
     gap?: number | string;
 };
 /**
- * Группа полей (items-API, как RadioGroup в @elcrm/components).
- * Родитель задаёт общие `form` / `onValue` / `onBlur` / `disabled` / `size`,
- * у каждого item — `field` + конкретные пропы (`name`, `label`, `options`, …).
+ * Группа полей. Не капсула — только раскладка и прокидывание `form`.
  */
 declare function FieldGroup({ items, form, onValue, onBlur, disabled, size, errors, values, gap, className, style, ...rest }: FieldGroupProps): import("react/jsx-runtime").JSX.Element;
 declare namespace FieldGroup {

package/dist/fields/File.d.ts

@@ -1,11 +1,21 @@
 import { TInput } from './type';
-/** Метаданные выбранного файла (File в форме сериализовать нельзя надёжно). */
+/** Метаданные файла в форме, если не храните сам `File` (`keepFile={false}`). */
 export type TFileMeta = {
     name: string;
     size: number;
     type: string;
     lastModified: number;
 };
+/**
+ * Выбор файла(ов) кнопкой в капсуле.
+ *
+ * **В форме:** `File` / `File[]` при `keepFile`, иначе {@link TFileMeta} / массив меты.
+ *
+ * **Элементы:** кнопка «Выбрать» + имя/размер + крестик очистки.
+ *
+ * @example
+ * <FileField name="doc" form={form} label="Файл" accept=".pdf" maxSize={5_000_000} />
+ */
 export type TFile = TInput & {
     accept?: string;
     multiple?: boolean;
@@ -17,6 +27,9 @@ export type TFile = TInput & {
      */
     keepFile?: boolean;
 };
+/**
+ * Поле файла. Для drag-and-drop зоны смотрите {@link DragDropField}.
+ */
 declare function FileField({ value, form, onValue, onBlur: onBlurField, name, placeholder, label, error, hidden, disabled, className, after, before, accept, multiple, maxSize, keepFile, }: TFile): import("react/jsx-runtime").JSX.Element | null;
 declare namespace FileField {
     var displayName: string;

package/dist/fields/Hidden.d.ts

@@ -1,9 +1,14 @@
 import { TInput } from './type';
 /**
- * HiddenField — значение в форме без UI.
- * Рендерит нативный `<input type="hidden">` для submit обычных форм.
+ * Значение в форме без видимого UI.
+ *
+ * **Элементы:** только `<input type="hidden">` (для нативного submit).
+ * Пропы: `value`, `form`, `onValue`, `name`, `id`, `hidden`.
  */
 export type THidden = Pick<TInput, "value" | "form" | "onValue" | "name" | "id" | "hidden">;
+/**
+ * Скрытое поле. `hidden` на этом компоненте полностью убирает input.
+ */
 declare function HiddenField({ value, form, onValue, name, id, hidden, }: THidden): import("react/jsx-runtime").JSX.Element | null;
 declare namespace HiddenField {
     var displayName: string;

package/dist/fields/Input.d.ts

@@ -1,13 +1,18 @@
 import { default as React } from 'react';
 import { TInput } from './type';
 /**
- * StringField — текстовое поле (по умолчанию contentEditable).
+ * Однострочный текст.
  *
- * **Автозаполнение (логин + пароль):** менеджеры паролей опираются на нативные `<input>`.
- * У `contentEditable` автозаполнение **не работает** как у поля логина.
- * Включите **`native`** и задайте **`autoComplete="username"`** (и оберните поля в `<form>`, при необходимости).
+ * **В форме:** `string`.
  *
- * @param hidden — при true скрывает поле, только если значение пустое
+ * **Элементы:** подпись `label` → капсула → слоты `before` / `after`.
+ * Ввод по умолчанию — `contentEditable`; `native` — настоящий `<input>`
+ * (нужен для автозаполнения: `autoComplete="username"` + обёртка `<form>`).
+ *
+ * Общие пропы — {@link TInput}.
+ *
+ * @example
+ * <StringField name="login" form={form} label="Логин" native autoComplete="username" />
  */
 declare function StringField({ value, form, onValue, name, placeholder, label, hidden, disabled, onBlur: onBlurField, className, after, before, error, inputmode, maxLength, spellCheck, native, autoComplete, inputType, id, size, }: TInput): import("react/jsx-runtime").JSX.Element | "";
 declare const _default: React.MemoExoticComponent<typeof StringField>;

package/dist/fields/Mask.d.ts

@@ -1,8 +1,20 @@
 import { TInput } from './type';
-/** MaskField — в form только цифры; UI по `format` (`_` = слот). */
+/**
+ * Маска ввода. **В форме — только цифры**; на экране шаблон `format`, `_` = слот цифры.
+ *
+ * @example
+ * <MaskField name="inn" form={form} label="ИНН" format="____________" />
+ */
 export type TMask = TInput & {
+    /**
+     * Шаблон, например `+_(___) ___-__-__` или `99.99.9999`.
+     * Цифры в шаблоне — фиксированные, `_` — ввод.
+     */
     format?: string;
 };
+/**
+ * Поле с маской. Не путать с PhoneField (маски стран).
+ */
 declare function MaskField({ value, form, onValue, onBlur: onBlurField, name, format, placeholder, label, error, hidden, disabled, className, after, before, inputmode, view, }: TMask): import("react/jsx-runtime").JSX.Element;
 declare namespace MaskField {
     var displayName: string;

package/dist/fields/Modal.d.ts

@@ -1,12 +1,24 @@
 import { ReactNode } from 'react';
 import { UseFormApi } from '../hooks/use';
 import { TValue } from './type';
-interface Input {
+/**
+ * Одно значение из модалки приложения (`Form.Init.onModal`).
+ *
+ * **В форме:** `string` или кортеж `[id, подпись]`.
+ *
+ * **Элементы:** капсула с текстом выбранного; клик → `modal` (`"module.name"`, обязателен).
+ *
+ * @example
+ * <ModalField name="city" form={form} label="Город" modal="geo.city" />
+ */
+export type TModal = {
+    /** Строка или `[id, подпись]` — в капсуле показывается подпись. */
     value?: string | [string | number, string];
     form?: UseFormApi;
     onValue?: (data: TValue) => void | Promise<void>;
     name: string;
     placeholder?: string;
+    /** Подпись над капсулой */
     label?: string;
     error?: string;
     hidden?: boolean;
@@ -15,10 +27,15 @@ interface Input {
     before?: ReactNode;
     view?: string;
     className?: string;
+    /** Обязательно: `"module.modalName"` → {@link Form.Init} `onModal`. */
     modal: string;
+    /** Доп. данные в payload модалки */
     options?: Record<string | number, unknown>;
-}
-declare function ModalField({ value, form, onValue, name, placeholder, label, error, hidden, disabled, after, before, view, modal, options, className, }: Input): import("react/jsx-runtime").JSX.Element;
+};
+/**
+ * Поле-триггер модалки. Без `Form.Init` колбэк — no-op.
+ */
+declare function ModalField({ value, form, onValue, name, placeholder, label, error, hidden, disabled, after, before, view, modal, options, className, }: TModal): import("react/jsx-runtime").JSX.Element;
 declare namespace ModalField {
     var displayName: string;
 }

package/dist/fields/Money.d.ts

@@ -1,5 +1,12 @@
 import { TInput } from './type';
-/** MoneyField — в form число × `course` (по умолчанию 100). */
+/**
+ * Деньги. В UI — сумма с разделителями; **в форме — целое × `course`** (копейки при `course={100}`).
+ *
+ * **Элементы:** contentEditable + опционально кнопка очистки (`isClear`) в капсуле.
+ *
+ * @example
+ * <MoneyField name="sum" form={form} label="Сумма" course={100} />
+ */
 export type TMoney = TInput & {
     /** Курс для отображения (множитель при записи в форму) */
     course?: number;
@@ -8,6 +15,9 @@ export type TMoney = TInput & {
     /** Режим фильтра символов при вводе */
     type?: string;
 };
+/**
+ * Поле суммы. Клавиатура `decimal`.
+ */
 declare function MoneyField({ value, form, onValue, name, placeholder, label, error, hidden, disabled, onBlur: onBlurField, className, after, before, inputmode, course, view, type, isClear, }: TMoney): import("react/jsx-runtime").JSX.Element | "";
 declare namespace MoneyField {
     var displayName: string;

package/dist/fields/NativeTextField.d.ts

@@ -1,15 +1,19 @@
 import { TInput } from './type';
+/**
+ * Внутренний каркас для {@link EmailField} / {@link UrlField}.
+ * Не экспортируется из пакета — снаружи используйте готовые поля.
+ */
 export type TNativeTextField = TInput & {
-    /** data-field / визуальный тип обёртки */
+    /** `data-field` на корне (email / url). */
     fieldType: string;
-    /** type у input */
+    /** HTML `type` у `<input>`. */
     inputType: "email" | "url" | "text" | "search" | "tel";
-    /** fallback для aria-label, если нет label/placeholder */
+    /** aria-label, если нет `label` и `placeholder`. */
     defaultAriaLabel: string;
 };
 /**
- * Общее нативное текстовое поле (Email / Url и т.п.).
- * Подпись и ошибка связываются через Field a11y (htmlFor / aria-describedby).
+ * Нативный `<input>` внутри той же капсулы, что у остальных полей.
+ * **Элементы:** `label` → капсула (`before` | input | `after`) → `error`.
  */
 declare function NativeTextField({ value, form, onValue, onBlur: onBlurField, name, placeholder, label, error, hidden, disabled, className, after, before, maxLength, autoComplete, inputmode, id, size, fieldType, inputType, defaultAriaLabel, }: TNativeTextField): import("react/jsx-runtime").JSX.Element | null;
 export default NativeTextField;

package/dist/fields/Numeric.d.ts

@@ -1,19 +1,20 @@
 import { TInput } from './type';
 /**
- * NumberField — целые цифры как **строка** в форме (`"123"`).
+ * Целые цифры как **строка** в форме (`"123"`), не `number`.
  *
- * **Не путать с PercentField:**
- * - сюда в форму пишется **строка цифр**, не `number`;
- * - проп **`max`** (и `maxLength`) — лимит **символов**, не верхняя граница числа;
- * - дробных нет (только `\d`).
+ * `max` / `maxLength` — лимит **символов**, не максимум числа.
+ * Для 0–100 / `number` используйте {@link PercentField}.
  *
- * Для процентов / clamp 0–100 / `number` используйте **`PercentField`**.
+ * @example
+ * <NumberField name="qty" form={form} label="Кол-во" max={6} />
  */
-/** NumberField — строка цифр в form. `max` = лимит символов. */
 export type TNumeric = TInput & {
-    /** Макс. число символов (если нет `maxLength`). Не числовой максимум значения. */
+    /** Макс. число символов (если нет `maxLength`). Не верхняя граница значения. */
     max?: number;
 };
+/**
+ * Поле целых цифр (строка в form).
+ */
 declare function NumberField({ value, form, onValue, name, placeholder, label, hidden, disabled, onBlur: onBlurField, className, after, before, error, size, inputmode, maxLength, max, view, }: TNumeric): import("react/jsx-runtime").JSX.Element | null;
 declare namespace NumberField {
     var displayName: string;