@nice2dev/ui-forms 1.0.22 → 1.0.24

package/dist/index.d.ts

@@ -4,15 +4,18 @@ 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 { NiceViewDefinitionV2 } from '@nice2dev/ui';
+import { NiceViewDefinition } from '@nice2dev/ui';
+import { NiceWorkflowDefinition } from '@nice2dev/ui';
 import { RefAttributes } from 'react';
 
 declare interface AIGeneratedField {
@@ -25,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;
@@ -244,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;
@@ -255,43 +94,23 @@ declare interface FormFieldOption {
     id?: string;
 }
 
-declare interface FormFieldOption_2 {
-    value: string | number;
-    label: string;
-    disabled?: boolean;
-    icon?: string;
-}
-
 /**
  * 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
- */
+/** 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;
@@ -330,19 +149,7 @@ export declare interface FormSchema {
  */
 export declare function formSchemaToJsonSchema(form: FormSchema): JsonSchema;
 
-/** Convert a {@link FormSchema} to a {@link NiceViewDefinitionV2} (form kind). */
-export declare function formSchemaToV2(schema: FormSchema, options?: FormSchemaToV2Options): NiceViewDefinitionV2;
-
-export declare interface FormSchemaToV2Options {
-    /** Data source key the fields bind to. Default `'record'`. */
-    source?: string;
-    /** V2 grid column count. Default `12`. */
-    columns?: number;
-}
-
-/**
- * Form section definition
- */
+/** Form section definition. */
 export declare interface FormSectionDefinition {
     id: string;
     title?: string;
@@ -353,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;
@@ -403,23 +199,6 @@ export declare interface JsonSchemaToFormItemsOptions {
     renderObjectField?: (value: Record<string, unknown>, onChange: (v: Record<string, unknown>) => void, schema: JsonSchema, label?: string) => default_2.ReactNode;
 }
 
-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;
-    }[];
-}
-
 export declare const NiceArrayField: ForwardRefExoticComponent<NiceArrayFieldProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceArrayFieldProps {
@@ -465,11 +244,9 @@ export declare interface NiceEntityEditorProps extends NiceStandardProps {
     tutorial?: NiceComponentTutorial;
 }
 
-export declare function NiceFormBuilder({ initialSchema, fields, onChange, onExport, onPreview, className, style, tutorial, }: NiceFormBuilderProps): JSX.Element;
-
 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 */
@@ -506,74 +283,6 @@ 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> & {
-        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;
-    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
-    tutorial?: NiceComponentTutorial;
-}
-
-export declare const NiceFormDesigner: default_2.FC<NiceFormDesignerProps>;
-
-export declare interface NiceFormDesignerProps extends NiceStandardProps {
-    /** Initial form schema */
-    schema?: FormDesignerSchema;
-    /** Called when schema changes */
-    onChange?: (schema: FormDesignerSchema) => void;
-    /** Read-only mode */
-    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;
-    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
-    tutorial?: NiceComponentTutorial;
-}
-
 export declare const NiceI18nEditor: ForwardRefExoticComponent<NiceI18nEditorProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface NiceI18nEditorProps extends NiceBaseProps {
@@ -640,13 +349,20 @@ export declare interface NiceManifestEditorProps extends NiceStandardProps {
     tutorial?: NiceComponentTutorial;
 }
 
-/** One editable manifest section, described by a JSON Schema or field model. */
-export declare interface NiceManifestSection {
+/**
+ * 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?: JsonSchema;
+    schema?: TSchema;
     /** Or the repo's field-descriptor model. */
     fields?: FormFieldDefinition[];
     /** Per-field UI overrides forwarded to NiceSchemaForm. */
@@ -709,8 +425,14 @@ export declare interface NiceModuleFiles {
     manifest: Record<string, unknown>;
     entities?: NiceEntity[];
     i18n?: NiceI18nValue;
-    /** The module's views (`*.view.json`) — unified `NiceViewDefinitionV2` standard. */
-    views?: NiceViewDefinitionV2[];
+    /** 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>;
 }
@@ -758,25 +480,16 @@ export declare interface NiceSchemaFormProps extends NiceStandardProps {
     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;
-
-/** Convert a {@link NiceViewDefinitionV2} back to a {@link FormSchema} (best-effort). */
-export declare function v2ToFormSchema(view: NiceViewDefinitionV2): FormSchema;
-
 /**
  * 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 form schema
- */
+/** Validate a FormSchema; returns `{ valid, errors }`. */
 export declare function validateFormSchema(schema: FormSchema): {
     valid: boolean;
     errors: string[];