@coffer-org/sdk 1.1.0

package/dist/fields.d.ts

@@ -0,0 +1,817 @@
+/**
+ * Система типів полів — серце платформи. Чистий, ізоморфний модуль.
+ * Один опис поля → три споживачі:
+ *   1. `zod`    — валідація (однакова на сервері й клієнті)
+ *   2. `column` — тип колонки в БД
+ *   3. `prim`/`kind` — ключі для резолву рендера (див. web/render/registry)
+ */
+import { z } from 'zod';
+/**
+ * Базові примітиви-рендери (storage-родина). Кожна фабрика ставить один `prim` —
+ * гарантований fallback-рендер. Семантичні обгортки задають свій `kind` (рядок),
+ * який має пріоритет; якщо для `kind` рендера немає — тихий відкат на `prim`.
+ *
+ * `(string & {})` лишає автодоповнення CorePrim-літералів, але дозволяє плагінам
+ * оголошувати власні prim (напр. 'service-links') — типи полів виносяться у плагіни.
+ */
+export type CorePrim = 'text' | 'number' | 'date' | 'time' | 'datetime' | 'checkbox' | 'select' | 'json' | 'checklist' | 'measured' | 'relation' | 'file' | 'per-weekday' | 'key-value' | 'lookup';
+export type Prim = CorePrim | (string & {});
+export type ColumnType = 'text' | 'integer' | 'real' | 'boolean' | 'date' | 'time' | 'datetime';
+/**
+ * Іконка опції — візуальний лідер у списку. Дискримінований за kind:
+ *   swatch — кольоровий кружок ('#rrggbb')
+ *   icon   — <Icon> ('flag:ua' | lucide-ім'я | emoji)
+ *   image  — аватар-картинка (url)
+ */
+export type OptionIcon = {
+    kind: 'swatch';
+    value: string;
+} | {
+    kind: 'icon';
+    value: string;
+} | {
+    kind: 'image';
+    value: string;
+};
+/**
+ * Опція вибору. `value` — storage-ключ (обов'язковий). Трійка відображення:
+ *   icon     — візуальний лідер (опц.)
+ *   title    — основна мітка (i18n-ключ або текст)
+ *   subtitle — технічне значення праворуч (опц.; ISO-код, hex, …)
+ */
+export interface OptionItem {
+    value: string;
+    title: string;
+    icon?: OptionIcon;
+    subtitle?: string;
+}
+/**
+ * Phantom-бренд: лише фабрики `field.*({ key })` повертають FieldItem.
+ * Не існує в runtime — суто типовий маркер, щоб TS відхиляв ручні `{ key, type }`
+ * літерали у `fields`. Будуй елементи через `field.*({ key, … })`.
+ */
+declare const __fieldItemBrand: unique symbol;
+/** Поле: key = ім'я колонки БД, type = FieldMeta. Будується через field.*({key:'x',...}). */
+export interface FieldItem {
+    key: string;
+    type: FieldMeta;
+    readonly [__fieldItemBrand]: typeof __fieldItemBrand;
+}
+/** Статичне поле: тільки display-режим. value — вже розпарсений об'єкт. */
+export interface StaticEl {
+    el: 'static';
+    type: FieldMeta;
+    value: unknown;
+}
+/** Псевдо-елементи: не зберігаються, не валідуються. */
+export interface DividerEl {
+    el: 'divider';
+}
+export interface InfoEl {
+    el: 'info';
+    text: string;
+}
+export interface ButtonEl {
+    el: 'button';
+    label: string;
+    value: string;
+    icon?: string;
+    variant?: 'default' | 'outline' | 'destructive';
+}
+export interface GroupEl {
+    el: 'group';
+    /** Storage-режим: ім'я колонки (embedded) / child-таблиці (collection). Без key → layout. */
+    key?: string;
+    /** collection (масив рядків → child-таблиця). Лише зі storage key. */
+    multiple?: boolean;
+    /** Storage: чи обов'язковий (collection → ≥1 рядок; embedded → непорожній). */
+    required?: boolean;
+    /** collection: sub-ключі з UNIQUE(parent_id, …) на child-таблиці. */
+    unique?: string[];
+    label?: string;
+    icon?: string;
+    fields: (FieldItem | StaticEl | PseudoEl)[];
+}
+export type PseudoEl = DividerEl | InfoEl | ButtonEl;
+export type LayoutEl = FieldItem | StaticEl | GroupEl | PseudoEl;
+export declare const isField: (x: LayoutEl) => x is FieldItem;
+export declare const isStatic: (x: LayoutEl) => x is StaticEl;
+export declare const isGroup: (x: LayoutEl) => x is GroupEl;
+export declare const isDivider: (x: LayoutEl) => x is DividerEl;
+export declare const isInfo: (x: LayoutEl) => x is InfoEl;
+export declare const isButton: (x: LayoutEl) => x is ButtonEl;
+/** Серіалізовна частина поля (безпечно віддавати клієнту). */
+export interface FieldClient {
+    /** Семантичний рендер-ключ (пріоритет). За замовчуванням === prim. */
+    kind: string;
+    label: string;
+    required: boolean;
+    /** Базовий примітив-рендер (storage-родина) — гарантований fallback. */
+    prim: Prim;
+    hints: Record<string, unknown>;
+    options?: OptionItem[];
+    relation?: {
+        vault: string;
+        type: string;
+    };
+    /** Якщо true — поле не зберігається в БД і не включається у zod-схему. */
+    virtual?: boolean;
+    /** Опційна підказка ширини в 12-кол гріді (1–12). Рендер — фінальна інстанція, може ігнорувати. */
+    span?: number;
+}
+/**
+ * Візуальна або storage-група полів (один рівень вкладеності — груп усередині груп нема).
+ * Без `key` → layout-група (не зберігається). З `key` → storage:
+ *   - embedded (key, без multiple): зберігається як колонка або вкладений об'єкт.
+ *   - collection (key + multiple): child-таблиця (масив рядків).
+ * Storage-група вимагає `label` і лише `FieldItem`-нащадків (зі storage key).
+ */
+export declare function group(o: {
+    key?: string;
+    multiple?: boolean;
+    required?: boolean;
+    unique?: string[];
+    label?: string;
+    icon?: string;
+    fields: (FieldItem | StaticEl | PseudoEl)[];
+}): GroupEl;
+export declare const isStorageGroup: (g: GroupEl) => boolean;
+export declare const isCollectionGroup: (g: GroupEl) => boolean;
+export declare const isEmbeddedGroup: (g: GroupEl) => boolean;
+/** Горизонтальний розділювач. */
+export declare function divider(): DividerEl;
+/** Довідковий markdown-блок за i18n-ключем. */
+export declare function info(textKey: string): InfoEl;
+/** Кнопка-дія: викликає обробник, зареєстрований у actionRegistry під ключем `value`. */
+export declare function button(o: {
+    label: string;
+    value: string;
+    icon?: string;
+    variant?: ButtonEl['variant'];
+}): ButtonEl;
+/** Валідація/поведінка поля (не перемикає віджет). */
+export interface FieldConfig {
+    min?: number;
+    max?: number;
+    step?: number;
+    pattern?: string;
+    messageKey?: string;
+    granularity?: 'minute' | 'hour' | 'day' | 'month' | 'year' | 'second';
+    language?: string;
+}
+/** Джерело варіантів/одиниць: іменоване (string) або inline (array). */
+export type FieldOptions = string | unknown[];
+/** Спільні opts для всіх фабрик. key → FieldItem, value → StaticEl, обидва відсутні → FieldMeta. */
+export interface FieldCoreOpts {
+    /** Ім'я колонки БД. Якщо вказано — фабрика повертає FieldItem. */
+    key?: string;
+    /** Статичне значення (вже розпарсений об'єкт). Якщо вказано — повертає StaticEl. */
+    value?: unknown;
+    /** Валідація/поведінка поля (не перемикає віджет). */
+    config?: FieldConfig;
+    /** Підказка ширини поля в 12-кол гріді (1–12). Рендер може відкинути. */
+    span?: number;
+    /** Прибрати per-field кнопки edit/save/cancel; редагування — лише через editAll/group. */
+    noEditControl?: boolean;
+}
+/** Обгортає FieldMeta у FieldItem/StaticEl залежно від opts.key/opts.value. */
+export declare function wrapKey(opts: {
+    key?: string;
+    value?: unknown;
+    span?: number;
+    noEditControl?: boolean;
+}, meta: FieldMeta): FieldItem | StaticEl | FieldMeta;
+export interface FieldMeta extends FieldClient {
+    column: ColumnType;
+    zod: z.ZodTypeAny;
+}
+/** Усі мови ISO 639-1 (native-назви як label). Джерело — пакет `iso-639-1`. */
+export declare const LANGUAGES: {
+    code: string;
+    name: string;
+}[];
+/** Стать — спільний optionList 'sex' (реєструє plugin-core). i18n: core.sex.*. */
+export declare const SEX_OPTIONS: [{
+    readonly value: "M";
+    readonly title: "core.sex.M";
+}, {
+    readonly value: "F";
+    readonly title: "core.sex.F";
+}, {
+    readonly value: "other";
+    readonly title: "core.sex.other";
+}];
+/** Структуроване повідомлення для zod: JSON {code, params}. Декодує mutate.ts. */
+export declare function vmsg(code: string, params?: Record<string, unknown>): string;
+/** Контекст zod v4 error-map (звужений до потрібних полів). */
+type ZErrCtx = {
+    input?: unknown;
+    code?: string;
+};
+/** v4 error-map: повідомлення для відсутнього значення (колишній required_error). */
+export declare function reqErr(code?: string): {
+    error: (iss: ZErrCtx) => string | undefined;
+};
+/** v4 error-map: повідомлення для невалідного типу (колишній invalid_type_error). */
+export declare function typeErr(code?: string): {
+    error: (iss: ZErrCtx) => string | undefined;
+};
+/** v4 error-map: required + invalid_type разом (колишні required_error + invalid_type_error). */
+export declare function reqTypeErr(): {
+    error: (iss: ZErrCtx) => string | undefined;
+};
+/**
+ * Спільна фабрика для полів, що зберігають JSON-рядок і валідуються вкладеною
+ * zod-схемою: parse → inner.safeParse → при невдачі issue з кодом `code`,
+ * при невалідному JSON — код 'json'. Уникає дублювання try/parse/superRefine.
+ */
+export declare function jsonRefined(inner: z.ZodTypeAny, code: string): z.ZodTypeAny;
+export declare function optionalize(schema: z.ZodTypeAny, required: boolean): z.ZodTypeAny;
+export declare function applyMultiple(base: FieldMeta, multiple: boolean): FieldMeta;
+export interface StringOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+/** Однорядковий текст. Довільний pattern/messageKey — через `config`. Багаторядковий — `text()`. */
+export declare function string(o: StringOpts & {
+    key: string;
+}): FieldItem;
+export declare function string(o: StringOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function string(o: StringOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+/** Багаторядковий текст (kind 'textarea'). Однорядковий — `string()`. Без `multiple`. */
+export interface TextOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    /** @deprecated use config.min */
+    min?: number;
+    /** @deprecated use config.max */
+    max?: number;
+}
+export declare function text(o: TextOpts & {
+    key: string;
+}): FieldItem;
+export declare function text(o: TextOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function text(o: TextOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface RealOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+/** Дійсне число (column 'real'). min/max/step — через `config`. */
+export declare function real(o: RealOpts & {
+    key: string;
+}): FieldItem;
+export declare function real(o: RealOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function real(o: RealOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface IntOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+/** Ціле число (column 'integer'). min/max/step — через `config`. */
+export declare function int(o: IntOpts & {
+    key: string;
+}): FieldItem;
+export declare function int(o: IntOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function int(o: IntOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface DateOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    min?: string;
+    max?: string;
+    multiple?: boolean;
+}
+export declare function date(o: DateOpts & {
+    key: string;
+}): FieldItem;
+export declare function date(o: DateOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function date(o: DateOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface TimeOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+export declare function time(o: TimeOpts & {
+    key: string;
+}): FieldItem;
+export declare function time(o: TimeOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function time(o: TimeOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface DateTimeOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+export declare function datetime(o: DateTimeOpts & {
+    key: string;
+}): FieldItem;
+export declare function datetime(o: DateTimeOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function datetime(o: DateTimeOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface BooleanOpts extends FieldCoreOpts {
+    label?: string;
+}
+export declare function boolean(o: BooleanOpts & {
+    key: string;
+}): FieldItem;
+export declare function boolean(o: BooleanOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function boolean(o: BooleanOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface TriStateOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+}
+export declare function triState(o: TriStateOpts & {
+    key: string;
+}): FieldItem;
+export declare function triState(o: TriStateOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function triState(o: TriStateOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface SelectOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    /**
+     * Джерело варіантів: рядок (іменований список з PluginManifest.optionLists)
+     * або inline-масив OptionItem (для невеликих статичних списків).
+     * Рядок → hints.source (UI отримує з реєстру); масив → inline enum.
+     * Для прив'язки до записів модуля використовуй `relation({ vault, module })`.
+     */
+    options?: FieldOptions;
+    multiple?: boolean;
+}
+export declare function select(o: SelectOpts & {
+    key: string;
+}): FieldItem;
+export declare function select(o: SelectOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function select(o: SelectOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface RelationOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    /** Цільовий модуль записів. */
+    vault: string;
+    module: string;
+    /** `true` → кілька id (JSON-масив); інакше один uuid. */
+    multiple?: boolean;
+    /** Поле-мітка цілі (fallback, коли немає views.inline). За замовч. `name`. */
+    displayKey?: string;
+}
+/**
+ * Прив'язка до записів іншого модуля (`{vault, module}`). Зберігає uuid (single)
+ * або JSON-масив uuid (multiple). Рендериться як RecordInline + пікер записів.
+ * Раніше це була record-гілка `select()`; винесено в окремий примітив, щоб select
+ * лишився суто enum/source-списком.
+ */
+export declare function relation(o: RelationOpts & {
+    key: string;
+}): FieldItem;
+export declare function relation(o: RelationOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function relation(o: RelationOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+/**
+ * Compose-time: підв'язати enum-валідацію source-селекту до значень списку.
+ * Factory не знає вмісту optionList (списки збираються лише в composeRegistry),
+ * тому zod source-полів спочатку z.string(); реєстр викликає це для кожного
+ * такого поля, щоб сервер відхиляв значення поза списком.
+ * Відтворює повний ланцюг модифікаторів: enum → multiple.
+ */
+export declare function bindSelectSourceZod(field: FieldMeta, values: string[]): void;
+export interface JsonOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+}
+export declare function json(o: JsonOpts & {
+    key: string;
+}): FieldItem;
+export declare function json(o: JsonOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function json(o: JsonOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+/**
+ * Чекліст — масив пунктів `[{ done: boolean, text: string }]`.
+ * Для списків справ/покупок/зборів: галочка + текст у кожному рядку.
+ * multiple: кілька чеклістів в одному полі (масив JSON-рядків, як applyMultiple).
+ */
+export interface ChecklistOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+export declare function checklist(o: ChecklistOpts & {
+    key: string;
+}): FieldItem;
+export declare function checklist(o: ChecklistOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function checklist(o: ChecklistOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface MeasuredOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    /**
+     * Набір одиниць: рядок (іменований пресет з UnitsPreset, напр. 'currency') або
+     * inline-масив UnitOption. min/max/step/int — через `config`.
+     */
+    options: FieldOptions;
+    multiple?: boolean;
+}
+export declare function measured(o: MeasuredOpts & {
+    key: string;
+}): FieldItem;
+export declare function measured(o: MeasuredOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function measured(o: MeasuredOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface MoneyOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+    config?: FieldConfig & {
+        defaultCurrency?: string;
+        min?: number;
+        max?: number;
+    };
+}
+export declare function money(o: MoneyOpts & {
+    key: string;
+}): FieldItem;
+export declare function money(o: MoneyOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function money(o: MoneyOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface CodeFieldOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    config?: FieldConfig & {
+        defaultLang?: string;
+    };
+}
+export declare function code(o: CodeFieldOpts & {
+    key: string;
+}): FieldItem;
+export declare function code(o: CodeFieldOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function code(o: CodeFieldOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface GeoOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+}
+export declare function geo(o: GeoOpts & {
+    key: string;
+}): FieldItem;
+export declare function geo(o: GeoOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function geo(o: GeoOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface PerWeekdayOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+}
+export declare function perWeekday(o: PerWeekdayOpts & {
+    key: string;
+}): FieldItem;
+export declare function perWeekday(o: PerWeekdayOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function perWeekday(o: PerWeekdayOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+/** Серіалізований сабфілд для клієнта (period/group): key + повний FieldClient. */
+export type RowSubField = FieldClient & {
+    key: string;
+};
+/**
+ * Віртуальний індикатор у композитних полях (group/period): показує поля related-запису
+ * сусіднього relation-сабфілда (`from`) і, опційно, порівнює measured-значення.
+ * Не зберігається, не валідується, у формі не редагується.
+ */
+export interface LookupOpts extends FieldCoreOpts {
+    label?: string;
+    /** Ключ сусіднього relation-сабфілда в рядку. */
+    from: string;
+    /** Поля related-запису для відображення. */
+    pick: string[];
+    /** Сусідній measured-ключ → бейдж ✓/✗/частково (порівняння з pick[0]). */
+    compareWith?: string;
+}
+export declare function lookup(o: LookupOpts & {
+    key: string;
+}): FieldItem;
+export declare function lookup(o: LookupOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function lookup(o: LookupOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+/**
+ * Відновлює FieldMeta з клієнтського FieldClient (для рекурсивного рендеру
+ * сабфілдів групових полів через FieldInput/FieldValue). zod тут не потрібен —
+ * валідація відбувається на рівні схеми батьківського поля.
+ */
+export declare function clientToMeta(fc: FieldClient): FieldMeta;
+/**
+ * Період дат {from, until}. multiple → масив періодів.
+ * Самодостатній JSON-композит (раніше будувався на field.row, тепер незалежний).
+ * Storage: `[{from,until}]`.
+ */
+type PeriodOpts = {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+    granularity?: 'month' | 'day' | 'datetime';
+} & FieldCoreOpts;
+export declare function period(o: PeriodOpts & {
+    key: string;
+}): FieldItem;
+export declare function period(o: PeriodOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function period(o: PeriodOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+/** Файл/медіа — спільний інтерфейс для всієї file-родини. */
+export interface FileOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    multiple?: boolean;
+}
+/** @deprecated Use FileOpts */
+export type ImageOpts = FileOpts;
+export declare function file(o: FileOpts & {
+    key: string;
+}): FieldItem;
+export declare function file(o: FileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function file(o: FileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function document(o: FileOpts & {
+    key: string;
+}): FieldItem;
+export declare function document(o: FileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function document(o: FileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function audio(o: FileOpts & {
+    key: string;
+}): FieldItem;
+export declare function audio(o: FileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function audio(o: FileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function video(o: FileOpts & {
+    key: string;
+}): FieldItem;
+export declare function video(o: FileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function video(o: FileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function image(o: FileOpts & {
+    key: string;
+}): FieldItem;
+export declare function image(o: FileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function image(o: FileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function media(o: FileOpts & {
+    key: string;
+}): FieldItem;
+export declare function media(o: FileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function media(o: FileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+/**
+ * Загальний тип «ключ/значення».
+ * Зберігає JSON-масив `[{ key, value }]`.
+ *   - multiple=false → UI обмежує до однієї пари (масив усе одно).
+ *   - option         → вкладене поле-визначення для типу VALUE (FieldMeta).
+ *                      Default: plain string. Задає віджет/маскування значення.
+ *                      Приклад: field.keyValue({ option: field.password() }) — маскування.
+ *
+ * Приклад: secrets: field.keyValue({ label: 'Секрети', multiple: true, option: field.password() })
+ */
+export interface KeyValueOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    /** Дозволити більше однієї пари (default: true). */
+    multiple?: boolean;
+    /** Тип value-комірки (будь-який FieldMeta). Default: string. */
+    option?: FieldMeta;
+    /** Підписи колонок у формі. */
+    keyLabel?: string;
+    valueLabel?: string;
+}
+export declare function keyValue(o: KeyValueOpts & {
+    key: string;
+}): FieldItem;
+export declare function keyValue(o: KeyValueOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function keyValue(o: KeyValueOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export interface RangeOpts extends FieldCoreOpts {
+    label?: string;
+    required?: boolean;
+    config?: FieldConfig & {
+        min?: number;
+        max?: number;
+        step?: number;
+    };
+}
+export declare function numberRange(o: RangeOpts & {
+    key: string;
+}): FieldItem;
+export declare function numberRange(o: RangeOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function numberRange(o: RangeOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function realRange(o: RangeOpts & {
+    key: string;
+}): FieldItem;
+export declare function realRange(o: RangeOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function realRange(o: RangeOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare const field: {
+    string: typeof string;
+    text: typeof text;
+    real: typeof real;
+    int: typeof int;
+    date: typeof date;
+    time: typeof time;
+    datetime: typeof datetime;
+    boolean: typeof boolean;
+    triState: typeof triState;
+    select: typeof select;
+    relation: typeof relation;
+    json: typeof json;
+    checklist: typeof checklist;
+    measured: typeof measured;
+    money: typeof money;
+    code: typeof code;
+    geo: typeof geo;
+    lookup: typeof lookup;
+    perWeekday: typeof perWeekday;
+    period: typeof period;
+    file: typeof file;
+    document: typeof document;
+    audio: typeof audio;
+    video: typeof video;
+    image: typeof image;
+    media: typeof media;
+    keyValue: typeof keyValue;
+    numberRange: typeof numberRange;
+    realRange: typeof realRange;
+    group: typeof group;
+    divider: typeof divider;
+    info: typeof info;
+    button: typeof button;
+} & {
+    email: typeof import("./field-presets.js").email;
+    url: typeof import("./field-presets.js").url;
+    tel: typeof import("./field-presets.js").tel;
+    slug: typeof import("./field-presets.js").slug;
+    color: typeof import("./field-presets.js").color;
+    colorname: typeof import("./field-presets.js").colorname;
+    title: typeof import("./field-presets.js").title;
+    password: typeof import("./field-presets.js").password;
+    tags: typeof import("./field-presets.js").tags;
+    imei: typeof import("./field-presets.js").imei;
+    mac: typeof import("./field-presets.js").mac;
+    iban: typeof import("./field-presets.js").iban;
+    markdown: typeof import("./field-presets.js").markdown;
+    snippet: typeof import("./field-presets.js").snippet;
+    rating: typeof import("./field-presets.js").rating;
+    duration: typeof import("./field-presets.js").duration;
+    percent: typeof import("./field-presets.js").percent;
+    year: typeof import("./field-presets.js").year;
+    country: typeof import("./field-presets.js").country;
+};
+export declare function toClient(field: FieldMeta): FieldClient;
+export {};
+//# sourceMappingURL=fields.d.ts.map