@coffer-org/sdk 1.1.0 → 1.2.2

package/dist/fields.d.ts

@@ -1,28 +1,13 @@
-/**
- * Система типів полів — серце платформи. Чистий, ізоморфний модуль.
- * Один опис поля → три споживачі:
- *   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 { vmsg, reqErr, typeErr, reqTypeErr, jsonRefined, optionalize, jsonValue, decodeVmsg, validateField } from './fields/validation.ts';
+import type { Condition } from './condition.ts';
+export type { Rules, View, FieldConfig } from './fields/normalize.ts';
+export { normalizeOpts } from './fields/normalize.ts';
+import { type Rules, type View } from './fields/normalize.ts';
+import { presets } from './field-presets.ts';
+export type CorePrim = 'text' | 'number' | 'date' | 'time' | 'datetime' | 'checkbox' | 'select' | 'json' | 'check' | 'measured' | 'relation' | 'file' | 'per-weekday' | '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;
@@ -33,37 +18,33 @@ export type OptionIcon = {
     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 ComputeCtx {
+    record: Record<string, unknown>;
+    settings: Record<string, unknown>;
+    global: Record<string, unknown>;
+    meta: {
+        vault: string;
+        module: string;
+    };
+}
+export type ComputeFn = (ctx: ComputeCtx) => unknown;
 export interface DividerEl {
     el: 'divider';
 }
@@ -76,23 +57,26 @@ export interface ButtonEl {
     label: string;
     value: string;
     icon?: string;
-    variant?: 'default' | 'outline' | 'destructive';
+    variant?: 'default' | 'outline' | 'destructive' | 'secondary' | 'ghost' | 'link';
 }
+export interface BreakEl {
+    el: 'break';
+}
+export type GroupDisplay = 'wrap' | 'scroll' | 'table' | 'sheet';
 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)[];
+    display?: GroupDisplay;
+    kind?: string;
+    fixed?: boolean;
+    fields: LayoutEl[];
 }
-export type PseudoEl = DividerEl | InfoEl | ButtonEl;
+export type PseudoEl = DividerEl | InfoEl | ButtonEl | BreakEl;
 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;
@@ -100,13 +84,11 @@ 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 declare const isBreak: (x: LayoutEl) => x is BreakEl;
 export interface FieldClient {
-    /** Семантичний рендер-ключ (пріоритет). За замовчуванням === prim. */
     kind: string;
     label: string;
-    required: boolean;
-    /** Базовий примітив-рендер (storage-родина) — гарантований fallback. */
+    required: boolean | Condition;
     prim: Prim;
     hints: Record<string, unknown>;
     options?: OptionItem[];
@@ -114,126 +96,113 @@ export interface FieldClient {
         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).
- */
+    default?: string | number | boolean | null;
+    json?: true;
+    columns?: Record<string, ColumnType>;
+    hidden?: boolean | Condition;
+}
 export declare function group(o: {
     key?: string;
+    label?: string;
+    fields: LayoutEl[];
     multiple?: boolean;
     required?: boolean;
-    unique?: string[];
+    rules?: {
+        unique?: string[];
+        fixed?: boolean;
+    };
+    view?: {
+        display?: GroupDisplay;
+        kind?: string;
+        icon?: string;
+    };
+}): GroupEl;
+export declare function row(o: {
     label?: string;
-    icon?: string;
-    fields: (FieldItem | StaticEl | PseudoEl)[];
+    fields: LayoutEl[];
+    view?: {
+        icon?: string;
+    };
+}): GroupEl;
+export declare function table(o: {
+    key: string;
+    label: string;
+    fields: LayoutEl[];
+    rules?: {
+        unique?: string[];
+    };
+    required?: boolean;
+    view?: {
+        icon?: string;
+    };
+}): GroupEl;
+export declare function sheet(o: {
+    label?: string;
+    fields: LayoutEl[][];
+    view?: {
+        icon?: string;
+    };
+}): GroupEl;
+export declare function url(o: {
+    key: string;
+    label?: string;
+    required?: boolean;
+}): GroupEl;
+type ContainerFactory = typeof row | typeof group | typeof table;
+export declare function keyed(o: {
+    key: string;
+    label: string;
+    container?: ContainerFactory;
+    by: FieldItem;
+    fields: LayoutEl[];
+    fixed?: boolean;
+    unique?: string[];
+    required?: boolean;
+    view?: {
+        icon?: string;
+    };
 }): 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 brk(): BreakEl;
 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;
+    label?: string;
+    rules?: Rules;
+    view?: View;
+    default?: string | number | boolean | null;
+    required?: boolean | Condition;
+    multiple?: boolean;
 }
-/** Обгортає FieldMeta у FieldItem/StaticEl залежно від opts.key/opts.value. */
 export declare function wrapKey(opts: {
     key?: string;
     value?: unknown;
-    span?: number;
     noEditControl?: boolean;
+    default?: string | number | boolean | null;
+    hidden?: boolean | Condition;
 }, 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 isJsonStored(field: FieldMeta | FieldClient): boolean;
+export { LANGUAGES, SEX_OPTIONS, WEEKDAY_OPTIONS } from './fields/constants.ts';
+export { parseUrl, buildUrl, hrefOf, type UrlValue } from './fields/url.ts';
 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;
@@ -245,14 +214,33 @@ export declare function string(o: StringOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-/** Багаторядковий текст (kind 'textarea'). Однорядковий — `string()`. Без `multiple`. */
+export interface LocalPathOpts extends FieldCoreOpts {
+}
+export interface LocalFileOpts extends LocalPathOpts {
+}
+export declare function localDir(o: LocalPathOpts & {
+    key: string;
+}): FieldItem;
+export declare function localDir(o: LocalPathOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function localDir(o: LocalPathOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function localFile(o: LocalFileOpts & {
+    key: string;
+}): FieldItem;
+export declare function localFile(o: LocalFileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function localFile(o: LocalFileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
 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;
@@ -265,12 +253,30 @@ export declare function text(o: TextOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
+export declare function i18n(o: TextOpts & {
+    key: string;
+}): FieldItem;
+export declare function i18n(o: TextOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function i18n(o: TextOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function smallText(o: TextOpts & {
+    key: string;
+}): FieldItem;
+export declare function smallText(o: TextOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function smallText(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;
@@ -283,11 +289,7 @@ export declare function real(o: RealOpts & {
     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;
@@ -300,11 +302,6 @@ export declare function int(o: IntOpts & {
     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;
@@ -318,9 +315,6 @@ export declare function date(o: DateOpts & {
     value?: undefined;
 }): FieldMeta;
 export interface TimeOpts extends FieldCoreOpts {
-    label?: string;
-    required?: boolean;
-    multiple?: boolean;
 }
 export declare function time(o: TimeOpts & {
     key: string;
@@ -334,9 +328,6 @@ export declare function time(o: TimeOpts & {
     value?: undefined;
 }): FieldMeta;
 export interface DateTimeOpts extends FieldCoreOpts {
-    label?: string;
-    required?: boolean;
-    multiple?: boolean;
 }
 export declare function datetime(o: DateTimeOpts & {
     key: string;
@@ -350,7 +341,6 @@ export declare function datetime(o: DateTimeOpts & {
     value?: undefined;
 }): FieldMeta;
 export interface BooleanOpts extends FieldCoreOpts {
-    label?: string;
 }
 export declare function boolean(o: BooleanOpts & {
     key: string;
@@ -364,8 +354,6 @@ export declare function boolean(o: BooleanOpts & {
     value?: undefined;
 }): FieldMeta;
 export interface TriStateOpts extends FieldCoreOpts {
-    label?: string;
-    required?: boolean;
 }
 export declare function triState(o: TriStateOpts & {
     key: string;
@@ -379,16 +367,7 @@ export declare function triState(o: TriStateOpts & {
     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;
@@ -402,22 +381,11 @@ export declare function select(o: SelectOpts & {
     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-списком.
- */
+    options: {
+        vault: string;
+        module: string;
+    };
+}
 export declare function relation(o: RelationOpts & {
     key: string;
 }): FieldItem;
@@ -429,17 +397,8 @@ 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;
@@ -452,36 +411,22 @@ 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 interface CheckOpts extends FieldCoreOpts {
+    slots?: string[];
 }
-export declare function checklist(o: ChecklistOpts & {
+export declare function check(o: CheckOpts & {
     key: string;
-}): FieldItem;
-export declare function checklist(o: ChecklistOpts & {
+}): FieldItem | GroupEl;
+export declare function check(o: CheckOpts & {
     value: unknown;
     key?: undefined;
 }): StaticEl;
-export declare function checklist(o: ChecklistOpts & {
+export declare function check(o: CheckOpts & {
     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;
@@ -495,14 +440,6 @@ export declare function measured(o: MeasuredOpts & {
     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;
@@ -516,11 +453,6 @@ export declare function money(o: MoneyOpts & {
     value?: undefined;
 }): FieldMeta;
 export interface CodeFieldOpts extends FieldCoreOpts {
-    label?: string;
-    required?: boolean;
-    config?: FieldConfig & {
-        defaultLang?: string;
-    };
 }
 export declare function code(o: CodeFieldOpts & {
     key: string;
@@ -534,8 +466,6 @@ export declare function code(o: CodeFieldOpts & {
     value?: undefined;
 }): FieldMeta;
 export interface GeoOpts extends FieldCoreOpts {
-    label?: string;
-    required?: boolean;
 }
 export declare function geo(o: GeoOpts & {
     key: string;
@@ -548,38 +478,21 @@ 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 & {
+export declare function perWeekday(o: {
     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. */
+    label: string;
+    rules?: {
+        min?: number;
+        max?: number;
+        step?: number;
+    };
+}): GroupEl;
 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;
@@ -592,26 +505,11 @@ 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;
+type PeriodOpts = FieldCoreOpts;
 export declare function period(o: PeriodOpts & {
     key: string;
-}): FieldItem;
+}): FieldItem | GroupEl;
 export declare function period(o: PeriodOpts & {
     value: unknown;
     key?: undefined;
@@ -620,13 +518,8 @@ 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;
@@ -694,46 +587,38 @@ 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 & {
+export declare function avatar(o: FileOpts & {
+    key: string;
+}): FieldItem;
+export declare function avatar(o: FileOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function avatar(o: FileOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+export declare function cover(o: FileOpts & {
     key: string;
 }): FieldItem;
-export declare function keyValue(o: KeyValueOpts & {
+export declare function cover(o: FileOpts & {
     value: unknown;
     key?: undefined;
 }): StaticEl;
-export declare function keyValue(o: KeyValueOpts & {
+export declare function cover(o: FileOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
+export interface KeyValueOpts extends FieldCoreOpts {
+    option?: FieldMeta;
+    keyLabel?: string;
+    valueLabel?: string;
+    container?: ContainerFactory;
+}
+export declare function keyValue(raw: KeyValueOpts & {
+    key: string;
+}): GroupEl;
 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;
@@ -757,9 +642,26 @@ export declare function realRange(o: RangeOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export declare const field: {
+export interface EmbedOpts extends FieldCoreOpts {
+}
+export declare function embed(o: EmbedOpts & {
+    key: string;
+}): FieldItem;
+export declare function embed(o: EmbedOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function embed(o: EmbedOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
+declare const PRIMITIVES: {
     string: typeof string;
     text: typeof text;
+    i18n: typeof i18n;
+    smallText: typeof smallText;
+    localDir: typeof localDir;
+    localFile: typeof localFile;
     real: typeof real;
     int: typeof int;
     date: typeof date;
@@ -770,7 +672,7 @@ export declare const field: {
     select: typeof select;
     relation: typeof relation;
     json: typeof json;
-    checklist: typeof checklist;
+    check: typeof check;
     measured: typeof measured;
     money: typeof money;
     code: typeof code;
@@ -784,34 +686,22 @@ export declare const field: {
     video: typeof video;
     image: typeof image;
     media: typeof media;
+    avatar: typeof avatar;
+    cover: typeof cover;
+    embed: typeof embed;
     keyValue: typeof keyValue;
     numberRange: typeof numberRange;
     realRange: typeof realRange;
     group: typeof group;
+    row: typeof row;
+    table: typeof table;
+    sheet: typeof sheet;
+    keyed: typeof keyed;
+    url: typeof url;
     divider: typeof divider;
+    break: typeof brk;
     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 const field: typeof PRIMITIVES & typeof presets;
 export declare function toClient(field: FieldMeta): FieldClient;
-export {};
-//# sourceMappingURL=fields.d.ts.map