@nice2dev/ui-forms 1.0.21 → 1.0.23

package/dist/index.d.ts

@@ -1,5 +1,22 @@
 import { default as default_2 } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceComponentTutorial } from '@nice2dev/ui';
+import { NiceComponentTutorial as NiceComponentTutorial_2 } from '@nice2dev/ui-core';
+import { NiceConsoleTab } from '@nice2dev/ui';
+import { NiceDataSourceDef } from '@nice2dev/ui';
+import { NiceFormItem } from '@nice2dev/ui';
+import { NiceHookBinding } from '@nice2dev/ui';
+import { NiceLifecycleHandlerOption } from '@nice2dev/ui';
+import { NiceLifecycleTrigger } from '@nice2dev/ui';
+import { NiceLogEntry } from '@nice2dev/ui';
+import { NiceRbacModel } from '@nice2dev/ui';
+import { NiceRevision } from '@nice2dev/ui';
+import { NiceScriptRunnerProps } from '@nice2dev/ui';
 import { NiceStandardProps } from '@nice2dev/ui';
+import { NiceViewDefinition } from '@nice2dev/ui';
+import { NiceWorkflowDefinition } from '@nice2dev/ui';
+import { RefAttributes } from 'react';
 
 declare interface AIGeneratedField {
     label: string;
@@ -11,186 +28,24 @@ declare interface AIGeneratedField {
     helpText?: string;
 }
 
-declare interface BarcodeConfig {
-    formats: ('ean13' | 'ean8' | 'code128' | 'code39' | 'qr' | 'datamatrix' | 'pdf417')[];
-    autoFill?: {
-        field: string;
-        property: string;
-    }[];
-    enableCamera?: boolean;
-    enableManualEntry?: boolean;
-}
-
-declare interface CalculationConfig {
-    expression: string;
-    dependencies: string[];
-    format?: 'number' | 'currency' | 'percentage' | 'date';
-    precision?: number;
-    currencyCode?: string;
-}
-
-declare interface DataBindingConfig {
-    entityType: string;
-    fieldPath: string;
-    direction: 'read' | 'write' | 'both';
-    transform?: string;
-    defaultFromEntity?: boolean;
-}
-
-declare interface FieldI18n {
-    label?: Record<string, string>;
-    placeholder?: Record<string, string>;
-    helpText?: Record<string, string>;
-    options?: Record<string, {
-        value: string;
-        label: string;
-    }[]>;
-}
-
-declare interface FormDesignerContextValue {
-    schema: FormDesignerSchema;
-    selectedFieldId: string | null;
-    selectedTabId: string | null;
-    locale: string;
-    setSchema: (schema: FormDesignerSchema) => void;
-    selectField: (fieldId: string | null) => void;
-    selectTab: (tabId: string | null) => void;
-    addField: (containerId: string, field: FormDesignerField, index?: number) => void;
-    updateField: (fieldId: string, updates: Partial<FormDesignerField>) => void;
-    removeField: (fieldId: string) => void;
-    moveField: (fieldId: string, toContainerId: string, toIndex: number) => void;
-    duplicateField: (fieldId: string) => void;
-    addTab: (tab: FormDesignerTab, index?: number) => void;
-    updateTab: (tabId: string, updates: Partial<FormDesignerTab>) => void;
-    removeTab: (tabId: string) => void;
-    setLocale: (locale: string) => void;
-    loadTemplate: (template: FormTemplate) => void;
-    saveAsTemplate: (name: string, category: string) => FormTemplate;
-}
-
-declare interface FormDesignerField {
-    id: string;
-    type: FormDesignerFieldType;
-    name: string;
-    label?: string;
-    placeholder?: string;
-    helpText?: string;
-    defaultValue?: unknown;
-    options?: FormFieldOption_2[];
-    validations?: FormFieldValidation_2[];
-    conditions?: FormFieldCondition_2[];
-    colSpan?: number;
-    rowSpan?: number;
-    className?: string;
-    style?: default_2.CSSProperties;
-    disabled?: boolean;
-    readonly?: boolean;
-    hidden?: boolean;
-    lookup?: LookupConfig;
-    calculation?: CalculationConfig;
-    barcode?: BarcodeConfig;
-    dataBinding?: DataBindingConfig;
-    i18n?: FieldI18n;
-    children?: FormDesignerField[];
-    props?: Record<string, unknown>;
-}
-
-declare type FormDesignerFieldType = 'text' | 'textarea' | 'number' | 'email' | 'password' | 'phone' | 'url' | 'date' | 'datetime' | 'time' | 'dateRange' | 'select' | 'multiselect' | 'checkbox' | 'toggle' | 'radio' | 'slider' | 'rating' | 'richtext' | 'markdown' | 'code' | 'file' | 'image' | 'signature' | 'lookup' | 'calculated' | 'barcode' | 'qrcode' | 'currency' | 'percentage' | 'section' | 'tab' | 'divider' | 'spacer' | 'heading' | 'paragraph' | 'repeater' | 'table' | 'address' | 'geolocation';
-
-declare interface FormDesignerSchema {
-    version: string;
-    id: string;
-    title?: string;
-    description?: string;
-    entityType?: string;
-    layout: {
-        type: 'flat' | 'tabs' | 'wizard' | 'accordion';
-        columns: 1 | 2 | 3 | 4;
-        labelPosition: 'top' | 'left' | 'floating';
-        size: 'sm' | 'md' | 'lg';
-        gap: 'sm' | 'md' | 'lg';
-    };
-    sections?: FormDesignerSection[];
-    tabs?: FormDesignerTab[];
-    submit?: {
-        label: string;
-        labelKey?: string;
-        style?: 'primary' | 'secondary' | 'success';
-        position?: 'left' | 'center' | 'right';
-        showCancel?: boolean;
-        cancelLabel?: string;
-        cancelLabelKey?: string;
-    };
-    computedFields?: {
-        name: string;
-        expression: string;
-        dependencies: string[];
-    }[];
-    validations?: {
-        type: 'crossField';
-        expression: string;
-        message: string;
-        messageKey?: string;
-    }[];
-    defaultLocale?: string;
-    supportedLocales?: string[];
-    i18n?: {
-        title?: Record<string, string>;
-        description?: Record<string, string>;
-    };
-    meta?: {
-        createdAt?: string;
-        updatedAt?: string;
-        author?: string;
-        tags?: string[];
-    };
-}
-
-declare interface FormDesignerSection {
-    id: string;
-    title?: string;
-    description?: string;
-    collapsible?: boolean;
-    defaultCollapsed?: boolean;
-    columns?: 1 | 2 | 3 | 4;
-    fields: FormDesignerField[];
-    i18n?: {
-        title?: Record<string, string>;
-        description?: Record<string, string>;
-    };
-}
-
-declare interface FormDesignerTab {
-    id: string;
-    title: string;
-    icon?: string;
-    disabled?: boolean;
-    badge?: string | number;
-    fields: FormDesignerField[];
-    i18n?: {
-        title?: Record<string, string>;
-    };
-}
-
 /**
- * Conditional visibility rule
+ * Identity helper that infers the precise `schema` type from a section literal,
+ * so consumers can write a plain JSON-Schema object without `as JsonSchema`
+ * assertions. `const general = defineManifestSection({ id, title, schema: {…} });`
  */
-declare interface FormFieldCondition {
+export declare function defineManifestSection<TSchema extends JsonSchema>(section: NiceManifestSection<TSchema>): NiceManifestSection<TSchema>;
+
+/** Convert a FormSchema into NiceForm items (for `NiceForm`). */
+export declare function formBuilderSchemaToNiceFormItems(schema: FormSchema): NiceFormItem[];
+
+/** Conditional visibility rule. */
+export declare interface FormFieldCondition {
     field: string;
     operator: 'equals' | 'notEquals' | 'contains' | 'greaterThan' | 'lessThan' | 'isEmpty' | 'isNotEmpty';
     value?: any;
 }
 
-declare interface FormFieldCondition_2 {
-    field: string;
-    operator: 'equals' | 'notEquals' | 'contains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'lessThan' | 'isEmpty' | 'isNotEmpty' | 'in' | 'notIn';
-    value?: unknown;
-    logicalOperator?: 'and' | 'or';
-}
-
-/**
- * Form field definition
- */
+/** Form field definition. */
 export declare interface FormFieldDefinition {
     /** Unique field ID */
     id: string;
@@ -230,10 +85,8 @@ export declare interface FormFieldDefinition {
     children?: FormFieldDefinition[];
 }
 
-/**
- * Option for select/radio fields
- */
-declare interface FormFieldOption {
+/** Option for select/radio fields. */
+export declare interface FormFieldOption {
     value: string | number;
     label: string;
     disabled?: boolean;
@@ -241,37 +94,23 @@ declare interface FormFieldOption {
     id?: string;
 }
 
-declare interface FormFieldOption_2 {
-    value: string | number;
-    label: string;
-    disabled?: boolean;
-    icon?: string;
-}
-
 /**
- * Available field types
+ * Convert the repo's own {@link FormFieldDefinition}[] model into NiceForm items.
+ * Layout-only field types (heading/paragraph/divider/spacer/section/image) are skipped.
  */
+export declare function formFieldsToFormItems(fields: FormFieldDefinition[], options?: JsonSchemaToFormItemsOptions): NiceFormItem[];
+
+/** Available field types. */
 export declare type FormFieldType = 'text' | 'textarea' | 'number' | 'email' | 'password' | 'phone' | 'url' | 'date' | 'datetime' | 'time' | 'select' | 'multiselect' | 'checkbox' | 'toggle' | 'radio' | 'slider' | 'rating' | 'color' | 'file' | 'signature' | 'richtext' | 'markdown' | 'code' | 'heading' | 'paragraph' | 'divider' | 'spacer' | 'image' | 'section';
 
-/**
- * Validation rule
- */
-declare interface FormFieldValidation {
+/** Validation rule. */
+export declare interface FormFieldValidation {
     type: 'required' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'email' | 'url' | 'custom';
     value?: string | number | boolean;
     message?: string;
 }
 
-declare interface FormFieldValidation_2 {
-    type: 'required' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'email' | 'url' | 'custom' | 'unique';
-    value?: string | number | boolean;
-    message?: string;
-    errorMessageKey?: string;
-}
-
-/**
- * Complete form schema
- */
+/** Complete form schema. */
 export declare interface FormSchema {
     /** Schema version */
     version: string;
@@ -310,9 +149,7 @@ export declare interface FormSchema {
  */
 export declare function formSchemaToJsonSchema(form: FormSchema): JsonSchema;
 
-/**
- * Form section definition
- */
+/** Form section definition. */
 export declare interface FormSectionDefinition {
     id: string;
     title?: string;
@@ -323,17 +160,6 @@ export declare interface FormSectionDefinition {
     fields: FormFieldDefinition[];
 }
 
-declare interface FormTemplate {
-    id: string;
-    name: string;
-    description?: string;
-    category: string;
-    schema: FormDesignerSchema;
-    thumbnail?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-
 export declare interface JsonSchema {
     $schema?: string;
     $id?: string;
@@ -354,28 +180,73 @@ export declare interface JsonSchema {
     additionalProperties?: boolean;
 }
 
-declare interface LookupConfig {
-    entityType: string;
-    displayField: string;
-    valueField: string;
-    searchFields?: string[];
-    filterExpression?: string;
-    sortField?: string;
-    sortDirection?: 'asc' | 'desc';
-    pageSize?: number;
-    fetchUrl?: string;
-    dependsOn?: string[];
-    cascadeFields?: {
-        source: string;
-        target: string;
-    }[];
+/**
+ * Convert a Draft-07 JSON Schema (object schema) into NiceForm items.
+ * Only top-level `properties` become fields; complex props use a JSON sub-editor.
+ */
+export declare function jsonSchemaToFormItems(schema: JsonSchema, options?: JsonSchemaToFormItemsOptions): NiceFormItem[];
+
+export declare interface JsonSchemaToFormItemsOptions {
+    /** Per-field overrides merged onto the generated item (label, type, colSpan, render, …). */
+    uiSchema?: Record<string, Partial<NiceFormItem>>;
+    /**
+     * Renderer for `array`-of-`object` properties. Injected (rather than imported)
+     * to avoid an import cycle with `NiceArrayField`. When omitted, such props fall
+     * back to a raw-JSON sub-editor.
+     */
+    renderArrayField?: (value: Array<Record<string, unknown>>, onChange: (rows: Array<Record<string, unknown>>) => void, itemSchema: JsonSchema, label?: string) => default_2.ReactNode;
+    /** Optional renderer for nested `object` properties (defaults to a JSON sub-editor). */
+    renderObjectField?: (value: Record<string, unknown>, onChange: (v: Record<string, unknown>) => void, schema: JsonSchema, label?: string) => default_2.ReactNode;
 }
 
-export declare function NiceFormBuilder({ initialSchema, fields, onChange, onExport, onPreview, className, style, }: NiceFormBuilderProps): JSX.Element;
+export declare const NiceArrayField: ForwardRefExoticComponent<NiceArrayFieldProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceArrayFieldProps {
+    /** The array being edited (controlled). */
+    value: Array<Record<string, unknown>>;
+    /** Change callback with the full updated array. */
+    onChange: (rows: Array<Record<string, unknown>>) => void;
+    /** JSON Schema of a single item (object schema with `properties`). */
+    itemSchema: JsonSchema;
+    /** Label shown in the add/edit dialog title. */
+    title?: string;
+    /** Render read-only (no add / edit / delete). */
+    readOnly?: boolean;
+    /** Columns to surface in the grid (field names). Defaults to all item properties. */
+    columns?: string[];
+    className?: string;
+    style?: React.CSSProperties;
+    'data-testid'?: string;
+}
+
+export declare type NiceEntity = Record<string, unknown>;
+
+export declare const NiceEntityEditor: ForwardRefExoticComponent<NiceEntityEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceEntityEditorProps extends NiceStandardProps {
+    /** Entities being edited (controlled). */
+    value: NiceEntity[];
+    /** Change callback with the full updated array. */
+    onChange: (entities: NiceEntity[]) => void;
+    /** JSON Schema for entity metadata (name, table, flags …). Defaults to the OmniVerk shape. */
+    entityMetaSchema?: JsonSchema;
+    /** JSON Schema for a single field. Defaults to the OmniVerk ModuleEntityField shape. */
+    fieldSchema?: JsonSchema;
+    /** Property holding the entity's fields. Default `'fields'`. */
+    fieldsKey?: string;
+    /** Property used as the entity label in the list. Default `'name'`. */
+    nameKey?: string;
+    /** Optional ER preview slot (e.g. NiceDatabaseSchemaViewer from @nice2dev/ui-diagrams). */
+    renderErPreview?: (entities: NiceEntity[]) => React.ReactNode;
+    /** Render read-only. */
+    readOnly?: boolean;
+    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
+    tutorial?: NiceComponentTutorial;
+}
 
 export declare const NiceFormBuilderAI: default_2.ForwardRefExoticComponent<NiceFormBuilderAIProps & default_2.RefAttributes<NiceFormBuilderAIRef>>;
 
-export declare interface NiceFormBuilderAIProps extends Omit<NiceFormBuilderProps, 'ref' | 'onChange' | 'initialSchema'> {
+export declare interface NiceFormBuilderAIProps {
     /** Enable AI features (requires NiceAIProvider) */
     enableAI?: boolean;
     /** AI model to use */
@@ -412,80 +283,213 @@ declare interface NiceFormBuilderAIRef {
     clearFields: () => void;
 }
 
-export declare interface NiceFormBuilderProps {
-    /** Initial form schema */
-    initialSchema?: FormSchema;
-    /** Convenience flat list of fields — wrapped into a default schema if `initialSchema` is omitted. */
-    fields?: Array<Partial<FormFieldDefinition> & {
+export declare const NiceI18nEditor: ForwardRefExoticComponent<NiceI18nEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceI18nEditorProps extends NiceBaseProps {
+    /** `{ [locale]: { [key]: value } }` (controlled). */
+    value: NiceI18nValue;
+    /** Change callback with the full updated map. */
+    onChange: (value: NiceI18nValue) => void;
+    /** Locale columns to show. Defaults to the locales present in `value`. */
+    locales?: string[];
+    /** Allow adding/removing locales. Default `true`. */
+    allowEditLocales?: boolean;
+    /** Allow adding/removing/renaming keys. Default `true`. */
+    allowEditKeys?: boolean;
+    /** Highlight empty cells as missing translations. Default `true`. */
+    highlightMissing?: boolean;
+    /** Render read-only. */
+    readOnly?: boolean;
+    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
+    tutorial?: NiceComponentTutorial_2;
+}
+
+export declare type NiceI18nValue = Record<string, Record<string, string>>;
+
+export declare const NiceManifestEditor: ForwardRefExoticComponent<NiceManifestEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceManifestEditorProps extends NiceStandardProps {
+    /** The manifest object being edited (controlled). */
+    value: Record<string, unknown>;
+    /** Section descriptors — each renders a NiceSchemaForm over the manifest. */
+    sections: NiceManifestSection[];
+    /** Change callback with the full updated manifest. */
+    onChange: (manifest: Record<string, unknown>) => void;
+    /** Offer a Form ⇄ JSON toggle in each section. Default `true`. */
+    jsonView?: boolean;
+    /** When provided, adds a "Scripts" tab hosting a NiceScriptRunner. */
+    scriptRunner?: NiceScriptRunnerProps;
+    /** Lifecycle triggers — when provided, adds a "Lifecycle" tab. */
+    triggers?: NiceLifecycleTrigger[];
+    /** Current hook bindings. */
+    bindings?: NiceHookBinding[];
+    /** Handlers offered in the lifecycle binding picker. */
+    handlers?: NiceLifecycleHandlerOption[];
+    /** Bindings change callback. */
+    onBindingsChange?: (bindings: NiceHookBinding[]) => void;
+    /** Revisions — when provided, adds a "History" tab. */
+    revisions?: NiceRevision[];
+    /** Rollback callback for the history tab. */
+    onRollback?: (id: string) => void;
+    /** Lazy content resolver for the history diff. */
+    loadContent?: (id: string) => Promise<string>;
+    /** Logs for the bottom dock — when provided, a NiceLogConsole is shown. */
+    logs?: NiceLogEntry[];
+    /** Clear-logs callback. */
+    onClearLogs?: () => void;
+    /** Extra tabs appended after the built-in ones (e.g. payment / webhook panels). */
+    extraTabs?: NiceConsoleTab[];
+    /** Manifest-level validation surfaced in the status bar. */
+    validate?: (manifest: Record<string, unknown>) => NiceSchemaFormError[];
+    /** Console theme. Default `'light'`. */
+    theme?: 'dark' | 'light';
+    /** Editor height. Default `560`. */
+    height?: number | string;
+    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
+    tutorial?: NiceComponentTutorial;
+}
+
+/**
+ * One editable manifest section, described by a JSON Schema or field model.
+ *
+ * Generic over `TSchema` so a literal JSON-Schema object keeps its precise type
+ * (use {@link defineManifestSection} for inference) — no `as JsonSchema` casts on
+ * nested `properties`. Defaults to `JsonSchema`, so `NiceManifestSection` and
+ * `NiceManifestSection[]` keep working unchanged.
+ */
+export declare interface NiceManifestSection<TSchema extends JsonSchema = JsonSchema> {
+    id: string;
+    title: string;
+    icon?: React.ReactNode;
+    /** JSON Schema describing this section's fields (subset of the manifest). */
+    schema?: TSchema;
+    /** Or the repo's field-descriptor model. */
+    fields?: FormFieldDefinition[];
+    /** Per-field UI overrides forwarded to NiceSchemaForm. */
+    uiSchema?: Record<string, Partial<NiceFormItem>>;
+}
+
+/** Pluggable persistence — implement over a filesystem, API, or in-memory store. */
+export declare interface NiceModuleDataProvider {
+    listModules(): Promise<NiceModuleSummary[]>;
+    loadModule(id: string): Promise<NiceModuleFiles>;
+    saveModule(id: string, files: NiceModuleFiles): Promise<void>;
+    createModule?(input: {
         id: string;
-        type: string;
-        label?: string;
-    }>;
-    /** Called when schema changes */
-    onChange?: (schema: FormSchema) => void;
-    /** Called when export is requested */
-    onExport?: (schema: FormSchema) => void;
-    /** Called when preview is requested */
-    onPreview?: (schema: FormSchema) => void;
-    /** Custom class */
-    className?: string;
-    /** Style */
-    style?: default_2.CSSProperties;
+        name?: string;
+    }): Promise<NiceModuleSummary>;
+}
+
+export declare const NiceModuleEditor: ForwardRefExoticComponent<NiceModuleEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceModuleEditorProps extends NiceStandardProps {
+    /** Persistence adapter. */
+    dataProvider: NiceModuleDataProvider;
+    /** Manifest sections (schema-driven). Provide the real target schema (e.g. OmniVerk). */
+    manifestSections: NiceManifestSection[];
+    /** Entity-editor configuration (schemas, ER preview slot). */
+    entityConfig?: NiceModuleEntityConfig;
+    /** Locales offered in the i18n editor. */
+    locales?: string[];
+    /** Extra module-level validation, merged with manifest-section schema validation. */
+    validate?: (files: NiceModuleFiles) => NiceSchemaFormError[];
+    /** Wires a Scripts tab (NiceScriptRunner). */
+    scriptRunner?: NiceScriptRunnerProps;
+    /** Wires a Lifecycle tab. */
+    triggers?: NiceLifecycleTrigger[];
+    bindings?: NiceHookBinding[];
+    handlers?: NiceLifecycleHandlerOption[];
+    onBindingsChange?: (bindings: NiceHookBinding[]) => void;
+    /** Wires a History tab. */
+    revisions?: NiceRevision[];
+    onRollback?: (id: string) => void;
+    loadContent?: (id: string) => Promise<string>;
+    /** Console theme. Default `'light'`. */
+    theme?: 'dark' | 'light';
+    /** Editor height. Default `640`. */
+    height?: number | string;
+    /** Optional guided tour. `true` = built-in tour; array/object = custom steps. Shows a "?" button. */
+    tutorial?: NiceComponentTutorial;
+}
+
+export declare interface NiceModuleEntityConfig {
+    entityMetaSchema?: JsonSchema;
+    fieldSchema?: JsonSchema;
+    fieldsKey?: string;
+    nameKey?: string;
+    renderErPreview?: (entities: NiceEntity[]) => React.ReactNode;
 }
 
-export declare const NiceFormDesigner: default_2.FC<NiceFormDesignerProps>;
+/** The editable files of one module. */
+export declare interface NiceModuleFiles {
+    manifest: Record<string, unknown>;
+    entities?: NiceEntity[];
+    i18n?: NiceI18nValue;
+    /** The module's views (`*.view.json`) — unified `NiceViewDefinition` standard. */
+    views?: NiceViewDefinition[];
+    /** The module's workflows (`*.workflow.json`). */
+    workflows?: NiceWorkflowDefinition[];
+    /** The module's data sources (no-SQL query definitions). */
+    dataSources?: NiceDataSourceDef[];
+    /** The module's RBAC model (roles + per-resource access). */
+    rbac?: NiceRbacModel;
+    /** Any extra parts the adapter wants to round-trip untouched. */
+    extra?: Record<string, unknown>;
+}
+
+/** A module entry shown in the browser. */
+export declare interface NiceModuleSummary {
+    id: string;
+    name?: string;
+    category?: string;
+    description?: string;
+}
+
+export declare const NiceSchemaForm: ForwardRefExoticComponent<NiceSchemaFormProps & RefAttributes<HTMLDivElement>>;
+
+/** A single validation problem produced by {@link validateAgainstJsonSchema}. */
+export declare interface NiceSchemaFormError {
+    field: string;
+    message: string;
+}
 
-export declare interface NiceFormDesignerProps extends NiceStandardProps {
-    /** Initial form schema */
-    schema?: FormDesignerSchema;
-    /** Called when schema changes */
-    onChange?: (schema: FormDesignerSchema) => void;
-    /** Read-only mode */
+export declare interface NiceSchemaFormProps extends NiceStandardProps {
+    /** Draft-07 JSON Schema (object schema). Provide this OR `fields`. */
+    schema?: JsonSchema;
+    /** The repo's own field-descriptor model. Provide this OR `schema`. */
+    fields?: FormFieldDefinition[];
+    /** Per-field UI overrides merged onto generated items (label, type, colSpan, render, …). */
+    uiSchema?: Record<string, Partial<NiceFormItem>>;
+    /** The value being edited (controlled). */
+    value: Record<string, unknown>;
+    /** Change callback with the full updated value. */
+    onChange: (value: Record<string, unknown>) => void;
+    /** Called whenever validation runs, with the current errors. */
+    onValidate?: (errors: NiceSchemaFormError[]) => void;
+    /** Offer a Form ⇄ JSON view toggle. Default `false`. */
+    showJsonView?: boolean;
+    /** Number of layout columns. Default `1`. */
+    columns?: number;
+    /** Label placement. Default `'top'`. */
+    labelPosition?: 'top' | 'left';
+    /** Render read-only. */
     readOnly?: boolean;
-    /** Current locale for preview */
-    locale?: string;
-    /** Available locales */
-    locales?: {
-        code: string;
-        name: string;
-    }[];
-    /** Show palette */
-    showPalette?: boolean;
-    /** Show properties panel */
-    showProperties?: boolean;
-    /** Show preview toggle */
-    showPreview?: boolean;
-    /** Show toolbar */
-    showToolbar?: boolean;
-    /** Available entity types for data binding */
-    entityTypes?: {
-        name: string;
-        fields: {
-            name: string;
-            type: string;
-            label: string;
-        }[];
-    }[];
-    /** Form templates */
-    templates?: FormTemplate[];
-    /** Called to save as template */
-    onSaveTemplate?: (template: FormTemplate) => void;
-    /** Called to load template */
-    onLoadTemplate?: (templateId: string) => FormTemplate | null;
-    /** Enable validation */
-    enableValidation?: boolean;
+    /** Validate on every change and show inline errors. Default `true`. */
+    liveValidation?: boolean;
+    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
+    tutorial?: NiceComponentTutorial;
 }
 
-/**
- * Convert form schema to NiceForm items
- */
+/** Convert a FormSchema into DevExtreme-style form items. */
 export declare function schemaToFormItems(schema: FormSchema): any[];
 
-export declare function useFormDesigner(): FormDesignerContextValue;
-
 /**
- * Validate form schema
+ * Validate a value object against a (subset of) Draft-07 JSON Schema.
+ * Covers required, type, enum, minLength/maxLength, minimum/maximum and pattern.
  */
+export declare function validateAgainstJsonSchema(value: Record<string, unknown>, schema: JsonSchema): NiceSchemaFormError[];
+
+/** Validate a FormSchema; returns `{ valid, errors }`. */
 export declare function validateFormSchema(schema: FormSchema): {
     valid: boolean;
     errors: string[];