GrSchemaForm

const grSchemaFormConfig: import("@feugene/granum/contract").GranumComponentDescriptor<"GrSchemaForm">;

interface GrSchemaFormConfigurableProps {
    columns: GrUiColumns;
    labelPosition: 'top' | 'start';
    labelWidth: string | number;
    headingLevel: 2 | 3 | 4 | 5 | 6;
}

interface GrSchemaFormContext {
    root: ComputedRef<GrSchemaObjectNode | undefined>;
    model: ComputedRef<Record<string, unknown>>;
    ui: ComputedRef<GrUiSchema>;
    renderers: ComputedRef<GrSchemaRendererRegistry>;
    disabled: ComputedRef<boolean>;
    readonly: ComputedRef<boolean>;
    /** Серверные ошибки по инстанс-пути — сильнее ошибки формы. */
    serverErrorAt: (name: string) => string[] | undefined;

function useSchemaForm(): GrSchemaFormContext | null;

interface GrSchemaFormProps<T extends Record<string, unknown> = Record<string, unknown>> {
    /** Чужая схема: JSON Schema, zod-объект. Адаптер подбирается по `supports()`. */
    schema?: unknown;
    /** Готовая нейтральная модель — сильнее `schema`. */
    schemaModel?: GrSchemaModel;
    /** Явные адаптеры. Без них разбор возможен только из `schemaModel`. */
    adapters?: GrSchemaAdapter[];
    /**
     * Настройки разбора чужой схемы адаптером: глубина обхода, обязательность по умолчанию,
     * префикс аннотаций, полная проверка.
     */
    parseOptions?: GrSchemaParseOptions;
    /** Данные формы. Не заданы — собираются из умолчаний схемы. */
    modelValue?: T;
    /** Раскладка и вид поверх схемы: секции, колонки, порядок, скрытые поля, виджеты, подписи. */
    uiSchema?: GrUiSchema;
    /** Реестр или набор записей поверх дефолтного. */
    renderers?: GrSchemaRendererRegistry | readonly GrSchemaRenderer[];
    /** Правила поверх скомпилированных: ключ — инстанс-путь. */
    rules?: GrFormRules;
    /** Настройки компиляции правил из схемы: ярусы, свои форматы, когда идёт полная проверка. */
    validation?: GrSchemaRuleCompilerOptions;
    /** Ответ сервера: сырой, разобранный или карта `{ путь: сообщения }`. */
    serverErrors?: unknown;
    /** Проверять поле при потере фокуса. По умолчанию `true`. */
    validateOnBlur?: boolean;
    /** Проверять поле на каждом изменении значения. По умолчанию `false`. */
    validateOnChange?: boolean;
    /** Прокрутить к первому невалидному полю, когда проверка не прошла. По умолчанию `true`. */
    scrollToError?: boolean;
    /** Все поля формы недоступны. */
    disabled?: boolean;
    /** Все поля формы только для чтения: значения видны, но не правятся. */
    readonly?: boolean;
    /**
     * Колонки сетки полей: число или карта по брейкпоинтам. Не задан — из `uiSchema.layout.columns`,
     * затем из `GrConfigProvider`, иначе одна.
     */
    columns?: GrUiColumns;
    /**
     * Положение подписей полей: `top` — над полем, `start` — слева. Не задан — из `GrConfigProvider`,
     * иначе `top`.
     */
    labelPosition?: 'top' | 'start';
    /** Ширина колонки подписи при `labelPosition="start"`; число — пиксели. */
    labelWidth?: string | number;
    /**
     * Уровень заголовков секций и вложенных объектов — под место формы на странице. Не задан — из
     * `GrConfigProvider`, иначе `3`.
     */
    headingLevel?: 2 | 3 | 4 | 5 | 6;
    /**
     * Сводка ошибок формы и осиротевших серверных сообщений — над полями, тоном
     * `danger`: сохранение не прошло.
     */
    showFormErrors?: boolean;
}

interface GrSchemaFormEmits<T extends Record<string, unknown> = Record<string, unknown>> {
    /** Данные формы изменились (`v-model`): правка поля или строки массива. */
    (e: 'update:modelValue', model: T): void;
    /** Отправка прошла проверку полей и схемы — данные формы. */
    (e: 'submit', model: T): void;
    /** Отправка не прошла проверку: путь поля → первое сообщение об ошибке. */
    (e: 'invalid', errors: Record<string, string>): void;
    /** Схема разобрана; `warnings` — то, чего адаптер не понял. */
    (e: 'parsed', model: GrSchemaModel, warnings: GrSchemaWarning[]): void;
    /** Для узла схемы не нашлось рендерера: узел и инстанс-путь; поле остаётся без контрола. */
    (e: 'unresolved', node: GrSchemaNode, name: string): void;
    /**
     * Строка массива добавлена, удалена или перенесена: путь массива, действие и индекс строки
     * (у `move` — новый).
     */
    (e: 'rowChange', path: string, action: 'add' | 'remove' | 'move', index: number): void;
}

interface GrSchemaArrayFieldProps {
    /** Узел-массив. Не задан — берётся из контекста формы по `path`. */
    node?: GrSchemaArrayNode;
    path?: string;
    /** Инстанс-путь массива: `order.items`. */
    name?: string;
    indices?: number[];
    ui?: GrUiArrayOptions;
    columns?: GrUiColumns;
    min?: number;
    max?: number;
    sortable?: boolean;
    duplicable?: boolean;
    title?: string;
    description?: string;
    headingLevel?: 2 | 3 | 4 | 5 | 6;
    addLabel?: string;
    removeLabel?: string;
    emptyText?: string;
    itemLabel?: string | ((item: unknown, index: number) => string);

interface GrSchemaArrayFieldEmits {
    (e: 'add', item: unknown, index: number): void;
    (e: 'remove', item: unknown, index: number): void;
    (e: 'move', from: number, to: number): void;
}

interface GrSchemaFieldProps {
    /** Узел схемы. Не задан — берётся из контекста формы по `path`. */
    node?: GrSchemaNode;
    /** Шаблонный путь — ключ в `uiSchema` и реестре. */
    path?: string;
    /** Инстанс-путь. Не задан — равен `path`: вне массива они совпадают. */
    name?: string;
    /** Индексы массивов на пути — нужны условиям с относительными путями. */
    indices?: number[];
    /** Значение. Не задано — читается из модели формы по `name`. */
    modelValue?: unknown;
    ui?: GrUiFieldOptions;
    renderers?: GrSchemaRendererRegistry;
    disabled?: boolean;
    readonly?: boolean;
    /** Явные ошибки. Сильнее ошибки формы — правило `GrFormField`. */
    error?: string | string[];
    /** Не рисовать обвязку — только контрол. Для поля в ячейке таблицы. */
    bare?: boolean;
    /**
     * Доступное имя контрола там, где видимой подписи нет и быть не должно:
     * строка свободного ключа, ячейка таблицы. Слабее `ui.controlProps`, чтобы
     * потребитель мог назвать поле по-своему.
     */
    ariaLabel?: string;
    label?: string;
    hint?: string;
    labelPosition?: 'top' | 'start';
    labelWidth?: string | number;
    showMessage?: boolean;
}

interface GrSchemaFieldEmits {
    (e: 'update:modelValue', value: unknown): void;
    (e: 'change', value: unknown): void;
    (e: 'unresolved', node: GrSchemaNode, name: string): void;
}

const grSchemaFormSafelist: string[];