@syncfusion/ej2-react-form-builder 0.1.0-beta

package/Common/json-converter.js

@@ -0,0 +1,1184 @@
+/**
+ * @private
+ */
+export const generateId = (type) => {
+    const timestamp = Date.now();
+    const random = Math.floor(Math.random() * 1000);
+    return `${type}_${timestamp}_${random}`;
+};
+/**
+ * @private
+ */
+export const generateName = (type) => {
+    const random = Math.floor(Math.random() * 1000);
+    return `${type}_${random}`;
+};
+/**
+ * @private
+ */
+export function labelToFieldKey(label, fallbackId) {
+    if (!label || label.trim() === '') {
+        return fallbackId || 'field';
+    }
+    // Remove special characters, keep letters, numbers, and spaces
+    const cleaned = label
+        .replace(/[^\w\s]/g, '') // Remove special chars
+        .trim();
+    if (cleaned === '') {
+        return fallbackId || 'field';
+    }
+    // Split by spaces/underscores and convert to camelCase
+    const words = cleaned.split(/[\s_]+/);
+    if (words.length === 0) {
+        return fallbackId || 'field';
+    }
+    // First word lowercase, rest title case
+    const camelCase = words
+        .map((word, index) => {
+        if (index === 0) {
+            return word.toLowerCase();
+        }
+        return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    })
+        .join('');
+    return camelCase || fallbackId || 'field';
+}
+/**
+ * @private
+ */
+export function makeUniqueFieldKey(baseKey, existingKeys, originalId) {
+    if (!existingKeys.has(baseKey)) {
+        return baseKey;
+    }
+    // Try with original ID suffix first
+    if (originalId) {
+        const withId = `${baseKey}_${originalId.split('_').pop()}`;
+        if (!existingKeys.has(withId)) {
+            return withId;
+        }
+    }
+    // Fall back to numeric suffix
+    let counter = 2;
+    while (existingKeys.has(`${baseKey}${counter}`)) {
+        counter++;
+    }
+    return `${baseKey}${counter}`;
+}
+/**
+ * @private
+ */
+export const UI_TYPE_TO_SEMANTIC_TYPE = {
+    // String types
+    'textbox': { type: 'string' },
+    'textarea': { type: 'string' },
+    'email': { type: 'string', format: 'email' },
+    'url': { type: 'string', format: 'url' },
+    'phone': { type: 'string' },
+    'password': { type: 'string' },
+    'inputMask': { type: 'string' },
+    // Numeric types
+    'number': { type: 'number' },
+    'rangeSlider': { type: 'number' },
+    'rating': { type: 'number' },
+    // Boolean types
+    'checkbox': { type: 'boolean' },
+    'switch': { type: 'boolean' },
+    // Date/Time types
+    'date': { type: 'string', format: 'date' },
+    'dateTime': { type: 'string', format: 'date-time' },
+    'time': { type: 'string', format: 'time' },
+    'dateRange': { type: 'string', format: 'date' },
+    // Array types
+    'multiselect': { type: 'array' },
+    'checkboxGroup': { type: 'array' },
+    // Single-value selection (stored as string)
+    'dropdown': { type: 'string' },
+    'radio': { type: 'string' },
+    'splitButton': { type: 'string' },
+    // Special types (excluded from data schema)
+    'button': { type: 'button' },
+    'message': { type: 'message' },
+    'signature': { type: 'sign' },
+    'imageEditor': { type: 'image' },
+    'fileUpload': { type: 'file' },
+    'colorPicker': { type: 'color' },
+    'dataGrid': { type: 'grid' },
+    // Layout types (excluded from data schema)
+    'staticHtml': { type: 'string' },
+    'table': null,
+    'panel': null,
+    'tabs': null,
+    'card': null
+};
+/**
+ * @private
+ */
+function stripConfiguredFlag(properties) {
+    const out = {};
+    Object.entries(properties || {}).forEach(([key, val]) => {
+        const copy = { ...val };
+        if (copy && copy._configured !== undefined) {
+            delete copy._configured;
+        }
+        out[key] = copy;
+    });
+    return out;
+}
+/**
+ * @private
+ */
+function cleanConditionRules(condition, validFieldIds) {
+    if (!condition || !condition.rules || !Array.isArray(condition.rules)) {
+        return undefined;
+    }
+    const cleanedRules = condition.rules
+        .map((rule) => {
+        // If rule has nested rules (group), recursively clean
+        if (rule.rules && Array.isArray(rule.rules)) {
+            return cleanConditionRules(rule, validFieldIds);
+        }
+        // If rule references non-existent field, exclude it
+        if (rule.field && !validFieldIds.has(rule.field)) {
+            return null;
+        }
+        return rule;
+    })
+        .filter((rule) => rule !== null && rule !== undefined);
+    // If no rules remain, return undefined
+    if (cleanedRules.length === 0) {
+        return undefined;
+    }
+    return {
+        ...condition,
+        rules: cleanedRules
+    };
+}
+/**
+ * @private
+ */
+function getAllComponentIds(components) {
+    const ids = new Set();
+    const stack = [...components];
+    while (stack.length) {
+        const comp = stack.pop();
+        ids.add(comp.id);
+        if (comp.children)
+            stack.push(...comp.children);
+        if (comp.tabItems) {
+            comp.tabItems.forEach(tab => {
+                if (tab.content)
+                    stack.push(...tab.content);
+            });
+        }
+        if (comp.tableCells) {
+            comp.tableCells.forEach(row => {
+                row.forEach(cell => stack.push(...cell));
+            });
+        }
+    }
+    return ids;
+}
+/**
+ * @private
+ */
+export function splitSchema(heartSchema) {
+    const dataFields = {};
+    const uiFields = {};
+    const layout = [];
+    const usedFieldKeys = new Set(); // Track unique field keys
+    const seenComponentIds = new Set(); // Track component IDs to prevent duplicates
+    // ✅ Get all valid field IDs for condition validation
+    const validFieldIds = getAllComponentIds(heartSchema.components);
+    // Stack for iterative traversal (avoid recursion)
+    const stack = heartSchema.components.map(c => ({
+        component: c,
+        layoutParent: layout
+    }));
+    while (stack.length > 0) {
+        // Use shift() instead of pop() to maintain order (FIFO instead of LIFO)
+        const { component, layoutParent } = stack.shift();
+        // ✅ Clean conditions before processing
+        if (component.conditions) {
+            const cleanedConditions = {};
+            let hasValidConditions = false;
+            if (component.conditions.visibleWhen) {
+                const cleaned = cleanConditionRules(component.conditions.visibleWhen, validFieldIds);
+                if (cleaned) {
+                    cleanedConditions.visibleWhen = cleaned;
+                    hasValidConditions = true;
+                }
+            }
+            if (component.conditions.hideWhen) {
+                const cleaned = cleanConditionRules(component.conditions.hideWhen, validFieldIds);
+                if (cleaned) {
+                    cleanedConditions.hideWhen = cleaned;
+                    hasValidConditions = true;
+                }
+            }
+            if (component.conditions.readOnlyWhen) {
+                const cleaned = cleanConditionRules(component.conditions.readOnlyWhen, validFieldIds);
+                if (cleaned) {
+                    cleanedConditions.readOnlyWhen = cleaned;
+                    hasValidConditions = true;
+                }
+            }
+            if (component.conditions.disabledWhen) {
+                const cleaned = cleanConditionRules(component.conditions.disabledWhen, validFieldIds);
+                if (cleaned) {
+                    cleanedConditions.disabledWhen = cleaned;
+                    hasValidConditions = true;
+                }
+            }
+            if (component.conditions.requiredWhen) {
+                const cleaned = cleanConditionRules(component.conditions.requiredWhen, validFieldIds);
+                if (cleaned) {
+                    cleanedConditions.requiredWhen = cleaned;
+                    hasValidConditions = true;
+                }
+            }
+            if (component.conditions.setValueWhen) {
+                const cleaned = cleanConditionRules(component.conditions.setValueWhen.condition, validFieldIds);
+                if (cleaned && component.conditions.setValueWhen.value !== undefined && component.conditions.setValueWhen.value !== '') {
+                    cleanedConditions.setValueWhen = {
+                        condition: cleaned,
+                        value: component.conditions.setValueWhen.value
+                    };
+                    hasValidConditions = true;
+                }
+            }
+            if (component.conditions?.choiceBasedField) {
+                const rule = component.conditions.choiceBasedField;
+                // Validate that primary field exists
+                if (rule.primaryFieldId && validFieldIds.has(rule.primaryFieldId)) {
+                    cleanedConditions.choiceBasedField = rule;
+                    hasValidConditions = true;
+                }
+            }
+            if (component.conditions.conditionalData && Array.isArray(component.conditions.conditionalData)) {
+                const cleanedDataRules = component.conditions.conditionalData
+                    .map((rule) => {
+                    const cleaned = cleanConditionRules(rule.condition, validFieldIds);
+                    if (cleaned && rule.dataSource) {
+                        return {
+                            condition: cleaned,
+                            dataSource: rule.dataSource,
+                            columns: rule.columns,
+                            includeColumns: rule.includeColumns
+                        };
+                    }
+                    return null;
+                })
+                    .filter((rule) => rule !== null && rule !== undefined);
+                if (cleanedDataRules.length > 0) {
+                    cleanedConditions.conditionalData = cleanedDataRules;
+                    hasValidConditions = true;
+                }
+            }
+            // Update component conditions (or remove if empty)
+            component.conditions = hasValidConditions ? cleanedConditions : undefined;
+        }
+        // Get semantic type mapping (may be null for presentation-only widgets)
+        const semanticType = UI_TYPE_TO_SEMANTIC_TYPE[component.type];
+        // Handle layout containers
+        if (component.type === 'table') {
+            const tableNode = {
+                type: 'table',
+                id: component.id,
+                name: component.name,
+                label: component.label,
+                cssClass: component.cssClass,
+                hideBorders: component.hideBorders,
+                rows: component.tableCells?.length || 0,
+                cols: component.tableCells?.[0]?.length || 0,
+                cells: [],
+                columnWidths: component.columnWidths,
+                ...(component.conditions ? { conditions: component.conditions } : {})
+            };
+            // Process table cells
+            component.tableCells?.forEach((row, rowIndex) => {
+                const cellRow = [];
+                row.forEach((cellComponents, colIndex) => {
+                    const cellChildren = [];
+                    // Reverse children and use unshift() to maintain order with depth-first processing
+                    [...cellComponents].reverse().forEach((comp) => {
+                        stack.unshift({ component: comp, layoutParent: cellChildren });
+                    });
+                    cellRow.push({ row: rowIndex, col: colIndex, children: cellChildren });
+                });
+                tableNode.cells.push(cellRow);
+            });
+            layoutParent.push(tableNode);
+            continue;
+        }
+        if (component.type === 'panel') {
+            const panelNode = {
+                type: 'panel',
+                id: component.id,
+                name: component.name,
+                label: component.label,
+                cssClass: component.cssClass,
+                hideBorders: component.hideBorders,
+                hideLabel: component.hideLabel,
+                children: [],
+                ...(component.conditions ? { conditions: component.conditions } : {})
+            };
+            // Process panel children
+            // Reverse children and use unshift() to maintain order with depth-first processing
+            [...(component.children || [])].reverse().forEach((child) => {
+                stack.unshift({ component: child, layoutParent: panelNode.children });
+            });
+            layoutParent.push(panelNode);
+            continue;
+        }
+        if (component.type === 'tabs') {
+            const tabsNode = {
+                type: 'tabs',
+                name: component.name,
+                id: component.id,
+                label: component.label,
+                cssClass: component.cssClass,
+                tabOptions: component.tabOptions,
+                tabs: [],
+                ...(component.conditions ? { conditions: component.conditions } : {})
+            };
+            // Process tabs
+            component.tabItems?.forEach((tab) => {
+                const tabChildren = [];
+                // Reverse children and use unshift() to maintain order with depth-first processing
+                [...(tab.content || [])].reverse().forEach((comp) => {
+                    stack.unshift({ component: comp, layoutParent: tabChildren });
+                });
+                tabsNode.tabs.push({ header: tab.header, children: tabChildren });
+            });
+            layoutParent.push(tabsNode);
+            continue;
+        }
+        if (component.type === 'card') {
+            const cardNode = {
+                type: 'card',
+                id: component.id,
+                name: component.name,
+                label: component.label,
+                cssClass: component.cssClass,
+                hideLabel: component.hideLabel,
+                cardTitle: component.cardTitle,
+                cardSubtitle: component.cardSubtitle,
+                children: [],
+                ...(component.conditions ? { conditions: component.conditions } : {})
+            };
+            // Process card children
+            // Reverse children and use unshift() to maintain order with depth-first processing
+            [...(component.children || [])].reverse().forEach((child) => {
+                stack.unshift({ component: child, layoutParent: cardNode.children });
+            });
+            layoutParent.push(cardNode);
+            continue;
+        }
+        // ✅ DEDUPLICATION: Skip if we've already processed this component ID
+        if (seenComponentIds.has(component.id)) {
+            //console.log(`⚠️ [splitSchema] Skipping duplicate component: ${component.id} (${component.label})`);
+            continue;
+        }
+        seenComponentIds.add(component.id);
+        // Generate semantic field key from label
+        const baseFieldKey = labelToFieldKey(component.label || component.id, component.id);
+        const fieldKey = makeUniqueFieldKey(baseFieldKey, usedFieldKeys, component.id);
+        usedFieldKeys.add(fieldKey);
+        // Extract data field properties (all components, no skipping)
+        // If no semantic type mapping exists, use 'any' as the type
+        const dataField = extractDataField(component, semanticType || { type: 'any' });
+        dataFields[fieldKey] = dataField;
+        // Extract UI field properties (all components)
+        uiFields[fieldKey] = extractUIField(component);
+        // Add property reference to layout (use fieldKey instead of component ID)
+        layoutParent.push({ type: 'field', propertyId: fieldKey });
+    }
+    // ✅ Merge data and UI fields into unified properties
+    const unifiedProperties = {};
+    Object.keys(dataFields).forEach(fieldKey => {
+        const dataField = dataFields[fieldKey];
+        const uiField = uiFields[fieldKey];
+        unifiedProperties[fieldKey] = {
+            ...dataField,
+            ...uiField,
+            // Ensure widget is always set
+            widget: uiField?.widget || inferWidgetFromType(dataField.type, dataField.format, dataField.options !== undefined)
+        };
+    });
+    const settings = heartSchema.settings ? { ...heartSchema.settings } : {};
+    return {
+        version: heartSchema.version,
+        properties: stripConfiguredFlag(unifiedProperties),
+        layout,
+        ...(Object.keys(settings).length > 0 ? { settings } : {})
+    };
+}
+/**
+ * @private
+ */
+function extractDataField(component, semanticType) {
+    const dataField = {
+        id: component.id,
+        name: component.name,
+        type: semanticType.type,
+    };
+    // Add format if present
+    if (semanticType.format) {
+        dataField.format = semanticType.format;
+    }
+    // Extract allowed properties only
+    if (component.label !== undefined)
+        dataField.label = component.label;
+    if (component.defaultValue !== undefined)
+        dataField.defaultValue = component.defaultValue;
+    if (component.expressionValue !== undefined)
+        dataField.expressionValue = component.expressionValue;
+    if (component.content !== undefined)
+        dataField.content = component.content;
+    if (component.buttonType !== undefined)
+        dataField.buttonType = component.buttonType;
+    if (component.textboxType !== undefined)
+        dataField.textboxType = component.textboxType;
+    if (component.required !== undefined)
+        dataField.required = component.required;
+    // Extract options for selection fields (dropdown, radio, multiselect)
+    if (component.options !== undefined)
+        dataField.options = component.options;
+    if (component.minLength !== undefined)
+        dataField.minLength = component.minLength;
+    if (component.maxLength !== undefined)
+        dataField.maxLength = component.maxLength;
+    // Handle numeric validation (use canonical names)
+    if (component.minValue !== undefined)
+        dataField.minValue = component.minValue;
+    if (component.maxValue !== undefined)
+        dataField.maxValue = component.maxValue;
+    // Date/time validation
+    if (component.minDate !== undefined)
+        dataField.minDate = component.minDate;
+    if (component.maxDate !== undefined)
+        dataField.maxDate = component.maxDate;
+    if (component.minTime !== undefined)
+        dataField.minTime = component.minTime;
+    if (component.maxTime !== undefined)
+        dataField.maxTime = component.maxTime;
+    // Pattern validation (rename from regex, convert RegExp to string)
+    if (component.regex !== undefined) {
+        const regex = component.regex;
+        dataField.pattern = regex instanceof RegExp ? regex.source : regex;
+    }
+    if (component.pattern !== undefined) {
+        const pattern = component.pattern;
+        dataField.pattern = pattern instanceof RegExp ? pattern.source : pattern;
+    }
+    return dataField;
+}
+/**
+ * @private
+ */
+function extractUIField(component) {
+    const uiField = {
+        widget: component.type,
+    };
+    // Copy all properties EXCEPT those in data schema allowed list
+    const dataSchemaProps = new Set([
+        'id', 'type', 'label', 'format', 'defaultValue', 'required', 'options', 'name', 'expressionValue',
+        'minLength', 'maxLength', 'minimum', 'maximum', 'minValue', 'maxValue',
+        'minDate', 'maxDate', 'minTime', 'maxTime', 'regex', 'pattern', 'content', 'buttonType', 'textboxType'
+    ]);
+    Object.keys(component).forEach(key => {
+        if (!dataSchemaProps.has(key) && key !== 'id' && key !== 'type') {
+            uiField[key] = component[key];
+        }
+    });
+    // Special handling: Filter dataGrid columns to keep only required properties
+    if (component.type === 'dataGrid' && uiField.columns && Array.isArray(uiField.columns)) {
+        const requiredColumnProps = [
+            'field',
+            'headerText',
+            'type',
+            'width',
+            'format',
+            'editType',
+            'validationRules',
+            'allowEditing',
+            'expression',
+            'isPrimaryKey',
+            'customValidation'
+        ];
+        uiField.columns = uiField.columns.map((col) => {
+            const filteredCol = {};
+            requiredColumnProps.forEach(prop => {
+                if (col[prop] !== undefined) {
+                    filteredCol[prop] = col[prop];
+                }
+            });
+            return filteredCol;
+        });
+    }
+    return uiField;
+}
+/**
+ * @private
+ */
+export function mergeSchema(unified) {
+    // Create lookup map for O(1) access to unified properties
+    const propertyMap = new Map();
+    Object.entries(unified.properties).forEach(([id, field]) => {
+        propertyMap.set(id, field);
+    });
+    // Track processed field IDs to prevent duplicates
+    const processedFieldIds = new Set();
+    // Recursive function to process layout nodes
+    const processLayoutNodes = (layoutNodes) => {
+        const components = [];
+        for (const node of layoutNodes) {
+            if (node.type === 'field') {
+                const fieldNode = node;
+                // ✅ DEDUPLICATION: Skip if we've already processed this field
+                if (processedFieldIds.has(fieldNode.propertyId)) {
+                    continue;
+                }
+                processedFieldIds.add(fieldNode.propertyId);
+                const unifiedField = propertyMap.get(fieldNode.propertyId);
+                if (!unifiedField) {
+                    console.warn(`Field ${fieldNode.propertyId} in layout not found in unified schema`);
+                    // Generate fallback component
+                    const fallbackComponent = {
+                        id: fieldNode.propertyId,
+                        name: generateName(''),
+                        type: 'textbox',
+                        label: 'Unknown Field',
+                        _configured: true
+                    };
+                    components.push(fallbackComponent);
+                }
+                else {
+                    components.push(mergeUnifiedField(unifiedField));
+                }
+            }
+            else if (node.type === 'table') {
+                const tableNode = node;
+                const tableComponent = {
+                    id: tableNode.id,
+                    name: tableNode.name,
+                    type: 'table',
+                    label: tableNode.label || 'Table',
+                    cssClass: tableNode.cssClass,
+                    hideBorders: tableNode.hideBorders,
+                    rows: tableNode.rows,
+                    columns: tableNode.cols,
+                    columnWidths: tableNode.columnWidths,
+                    tableCells: [],
+                    _configured: true,
+                    ...(tableNode.conditions ? { conditions: tableNode.conditions } : {})
+                };
+                // Process table cells recursively
+                tableNode.cells.forEach((row) => {
+                    const cellRow = [];
+                    row.forEach((cell) => {
+                        const cellComponents = processLayoutNodes(cell.children);
+                        cellRow.push(cellComponents);
+                    });
+                    tableComponent.tableCells.push(cellRow);
+                });
+                components.push(tableComponent);
+            }
+            else if (node.type === 'panel') {
+                const panelNode = node;
+                const panelComponent = {
+                    id: panelNode.id,
+                    type: 'panel',
+                    name: panelNode.name,
+                    cssClass: panelNode.cssClass,
+                    hideBorders: panelNode.hideBorders,
+                    hideLabel: panelNode.hideLabel,
+                    label: panelNode.label || 'Panel',
+                    children: processLayoutNodes(panelNode.children),
+                    _configured: true,
+                    ...(panelNode.conditions ? { conditions: panelNode.conditions } : {})
+                };
+                components.push(panelComponent);
+            }
+            else if (node.type === 'tabs') {
+                const tabsNode = node;
+                const tabsComponent = {
+                    id: tabsNode.id,
+                    type: 'tabs',
+                    name: tabsNode.name,
+                    label: tabsNode.label || 'Tabs',
+                    cssClass: tabsNode.cssClass,
+                    tabOptions: tabsNode.tabOptions,
+                    tabItems: [],
+                    _configured: true,
+                    ...(tabsNode.conditions ? { conditions: tabsNode.conditions } : {})
+                };
+                // Process tabs recursively
+                tabsNode.tabs.forEach((tab) => {
+                    tabsComponent.tabItems.push({
+                        header: tab.header,
+                        content: processLayoutNodes(tab.children)
+                    });
+                });
+                components.push(tabsComponent);
+            }
+            else if (node.type === 'card') {
+                const cardNode = node;
+                const cardComponent = {
+                    id: cardNode.id,
+                    type: 'card',
+                    name: cardNode.name,
+                    label: cardNode.label || 'Card',
+                    cssClass: cardNode.cssClass,
+                    hideLabel: cardNode.hideLabel,
+                    children: processLayoutNodes(cardNode.children),
+                    _configured: true,
+                    ...(cardNode.conditions ? { conditions: cardNode.conditions } : {})
+                };
+                // Add card-specific properties
+                if (cardNode.cardTitle !== undefined)
+                    cardComponent.cardTitle = cardNode.cardTitle;
+                if (cardNode.cardSubtitle !== undefined)
+                    cardComponent.cardSubtitle = cardNode.cardSubtitle;
+                components.push(cardComponent);
+            }
+        }
+        return components;
+    };
+    // Process root layout nodes
+    let components;
+    if (!unified.layout || unified.layout.length === 0) {
+        // If layout is undefined or empty, generate a flat layout from properties
+        components = Object.entries(unified.properties).map(([, unifiedField]) => {
+            return mergeUnifiedField(unifiedField);
+        });
+    }
+    else {
+        components = processLayoutNodes(unified.layout);
+    }
+    return {
+        version: unified.version,
+        components,
+        ...(unified.settings ? { settings: unified.settings } : {})
+    };
+}
+/**
+ * @private
+ */
+function mergeUnifiedField(unifiedField) {
+    const hasOptions = unifiedField.options !== undefined && unifiedField.options.length > 0;
+    const component = {
+        id: unifiedField.id,
+        name: unifiedField.name,
+        type: (unifiedField.widget || inferWidgetFromType(unifiedField.type, unifiedField.format, hasOptions)),
+        label: unifiedField.label || unifiedField.id,
+    };
+    // Copy all data and UI properties from unified field
+    const dataSchemaProps = new Set([
+        'id', 'type', 'name', 'label', 'format', 'widget', 'defaultValue', 'required', 'options', 'expressionValue',
+        'minLength', 'maxLength', 'minimum', 'maximum', 'minValue', 'maxValue',
+        'minDate', 'maxDate', 'minTime', 'maxTime', 'regex', 'pattern', 'content', 'buttonType', 'textboxType'
+    ]);
+    Object.keys(unifiedField).forEach(key => {
+        if (!dataSchemaProps.has(key) && key !== 'id' && key !== 'name' && key !== 'type' && key !== 'label') {
+            component[key] = unifiedField[key];
+        }
+    });
+    // Copy specific data properties
+    if (unifiedField.defaultValue !== undefined)
+        component.defaultValue = unifiedField.defaultValue;
+    if (unifiedField.expressionValue !== undefined)
+        component.expressionValue = unifiedField.expressionValue;
+    if (unifiedField.required !== undefined)
+        component.required = unifiedField.required;
+    if (unifiedField.content !== undefined)
+        component.content = unifiedField.content;
+    if (unifiedField.buttonType !== undefined)
+        component.buttonType = unifiedField.buttonType;
+    if (unifiedField.textboxType !== undefined)
+        component.textboxType = unifiedField.textboxType;
+    if (unifiedField.options !== undefined)
+        component.options = unifiedField.options;
+    if (unifiedField.minLength !== undefined)
+        component.minLength = unifiedField.minLength;
+    if (unifiedField.maxLength !== undefined)
+        component.maxLength = unifiedField.maxLength;
+    if (unifiedField.minValue !== undefined)
+        component.minValue = unifiedField.minValue;
+    if (unifiedField.maxValue !== undefined)
+        component.maxValue = unifiedField.maxValue;
+    if (unifiedField.minDate !== undefined)
+        component.minDate = unifiedField.minDate;
+    if (unifiedField.maxDate !== undefined)
+        component.maxDate = unifiedField.maxDate;
+    if (unifiedField.minTime !== undefined)
+        component.minTime = unifiedField.minTime;
+    if (unifiedField.maxTime !== undefined)
+        component.maxTime = unifiedField.maxTime;
+    if (unifiedField.pattern !== undefined)
+        component.regex = unifiedField.pattern;
+    return component;
+}
+/**
+ * @private
+ */
+export function inferWidgetFromType(type, format, hasOptions) {
+    if (type === 'string') {
+        if (format === 'date')
+            return 'date';
+        if (format === 'date-time')
+            return 'dateTime';
+        if (format === 'time')
+            return 'time';
+        if (format === 'email')
+            return 'email';
+        if (format === 'url')
+            return 'url';
+        // If options are present, default to dropdown for string types
+        if (hasOptions)
+            return 'dropdown';
+        return 'textbox';
+    }
+    if (type === 'number')
+        return 'number';
+    if (type === 'boolean')
+        return 'checkbox';
+    if (type === 'array') {
+        // For array type with options, use multiselect
+        return 'multiselect';
+    }
+    if (type === 'button')
+        return 'button';
+    if (type === 'message')
+        return 'message';
+    if (type === 'sign')
+        return 'signature';
+    if (type === 'image')
+        return 'imageEditor';
+    if (type === 'file')
+        return 'fileUpload';
+    if (type === 'color')
+        return 'colorPicker';
+    if (type === 'grid')
+        return 'dataGrid';
+    if (type === 'any')
+        return 'textbox';
+    return 'textbox';
+}
+/**
+ * @private
+ */
+function levenshteinDistance(str1, str2) {
+    const len1 = str1.length;
+    const len2 = str2.length;
+    const matrix = [];
+    // Initialize matrix
+    for (let i = 0; i <= len1; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= len2; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill matrix
+    for (let i = 1; i <= len1; i++) {
+        for (let j = 1; j <= len2; j++) {
+            const cost = str1[i - 1] === str2[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+            matrix[i][j - 1] + 1, // insertion
+            matrix[i - 1][j - 1] + cost // substitution
+            );
+        }
+    }
+    return matrix[len1][len2];
+}
+/**
+ * @private
+ */
+function calculateSimilarity(str1, str2) {
+    const distance = levenshteinDistance(str1.toLowerCase(), str2.toLowerCase());
+    const maxLen = Math.max(str1.length, str2.length);
+    if (maxLen === 0)
+        return 100;
+    return Math.round(((maxLen - distance) / maxLen) * 100);
+}
+/**
+ * @private
+ */
+export function matchFieldWithIDPreservation(newDataField, existingUISchema) {
+    // 1. Try exact ID match first
+    if (existingUISchema.properties[newDataField.id]) {
+        return {
+            existingId: newDataField.id,
+            newDataId: newDataField.id,
+            confidence: 'exact',
+            method: 'id',
+            similarity: 100
+        };
+    }
+    // 2. Try fuzzy match by ID (check if existing ID starts with new ID or vice versa)
+    let bestIdMatch = null;
+    for (const [existingId, existingUIField] of Object.entries(existingUISchema.properties)) {
+        // Skip if this is a layout container
+        if (['table', 'panel', 'tabs'].includes(existingUIField.widget)) {
+            continue;
+        }
+        // Check if one ID is a prefix of the other (common case: radio_123 vs radio_123_456)
+        const newId = newDataField.id || '';
+        const isPrefix = existingId.startsWith(newId + '_') || newId.startsWith(existingId + '_');
+        if (isPrefix) {
+            const similarity = Math.round((Math.min(newId.length, existingId.length) / Math.max(newId.length, existingId.length)) * 100);
+            if (!bestIdMatch || (bestIdMatch.similarity && similarity > bestIdMatch.similarity)) {
+                bestIdMatch = {
+                    existingId: existingId, // PRESERVE EXISTING ID
+                    newDataId: newDataField.id,
+                    confidence: similarity >= 90 ? 'high' : similarity >= 70 ? 'medium' : 'low',
+                    method: 'id',
+                    similarity
+                };
+            }
+        }
+        else {
+            // Try Levenshtein distance for ID similarity
+            const idSimilarity = calculateSimilarity(existingId, newId);
+            // Only consider as potential match if very similar (≥85%)
+            if (idSimilarity >= 85) {
+                if (!bestIdMatch || (bestIdMatch.similarity && idSimilarity > bestIdMatch.similarity)) {
+                    bestIdMatch = {
+                        existingId: existingId,
+                        newDataId: newDataField.id,
+                        confidence: idSimilarity >= 90 ? 'high' : 'medium',
+                        method: 'id',
+                        similarity: idSimilarity
+                    };
+                }
+            }
+        }
+    }
+    // If we found a good ID match, use it
+    if (bestIdMatch && bestIdMatch.similarity && bestIdMatch.similarity >= 70) {
+        //console.log(`ID fuzzy match: "${newDataField.id}" → "${bestIdMatch.existingId}" (${bestIdMatch.similarity}% similar)`);
+        return bestIdMatch;
+    }
+    // 3. Try fuzzy match by label
+    let bestLabelMatch = null;
+    for (const [existingId, existingUIField] of Object.entries(existingUISchema.properties)) {
+        // Skip if this is a layout container
+        if (['table', 'panel', 'tabs'].includes(existingUIField.widget)) {
+            continue;
+        }
+        // Get label from UI field or try to extract from ID
+        const existingLabel = existingUIField.label || existingId;
+        const newLabel = newDataField.label || newDataField.id;
+        if (!existingLabel || !newLabel)
+            continue;
+        const similarity = calculateSimilarity(existingLabel, newLabel);
+        // Update best match if this is better
+        if (!bestLabelMatch || (bestLabelMatch.similarity && similarity > bestLabelMatch.similarity)) {
+            bestLabelMatch = {
+                existingId: existingId, // PRESERVE EXISTING ID
+                newDataId: newDataField.id,
+                confidence: similarity >= 90 ? 'high' : similarity >= 70 ? 'medium' : 'low',
+                method: similarity === 100 ? 'label-exact' : 'label-fuzzy',
+                similarity
+            };
+        }
+    }
+    // 4. Return best label match if similarity is good enough (≥70%)
+    if (bestLabelMatch && bestLabelMatch.similarity && bestLabelMatch.similarity >= 70) {
+        //console.log(`Label fuzzy match: "${newDataField.label}" → "${bestLabelMatch.existingId}" (${bestLabelMatch.similarity}% similar)`);
+        return bestLabelMatch;
+    }
+    // 5. No match found - use new ID
+    return {
+        existingId: newDataField.id,
+        newDataId: newDataField.id,
+        confidence: 'exact',
+        method: 'new',
+        similarity: 100
+    };
+}
+/**
+ * @private
+ */
+export function mergeWithIDRemapping(newDataSchema, existingUISchema) {
+    const idMap = new Map(); // newId → canonicalId
+    const matchResults = [];
+    // Build ID mapping table
+    Object.entries(newDataSchema.properties).forEach(([newId, dataField]) => {
+        const match = matchFieldWithIDPreservation(dataField, existingUISchema);
+        matchResults.push(match);
+        idMap.set(newId, match.existingId || generateId(labelToFieldKey(dataField.label || '')));
+        // Log remapping if IDs differ
+        if (match.newDataId !== match.existingId) {
+            //console.log(`ID remapped: ${match.newDataId} → ${match.existingId} (${match.method}, ${match.similarity}% similar)`);
+        }
+    });
+    // Remap all data field IDs to canonical IDs
+    const remappedDataFields = {};
+    Object.entries(newDataSchema.properties).forEach(([newId, dataField]) => {
+        const canonicalId = idMap.get(newId) || newId;
+        remappedDataFields[canonicalId] = {
+            ...dataField,
+            id: canonicalId // Use canonical ID
+        };
+    });
+    // Get existing field IDs from the layout
+    const existingFieldIds = extractFieldIdsFromLayout(existingUISchema.layout);
+    const newFieldIds = Object.keys(remappedDataFields).filter(id => !existingFieldIds.has(id));
+    //console.log(`📋 Existing fields in layout: ${existingFieldIds.size}, New fields: ${newFieldIds.length}`);
+    // ✅ CHECK IF SUBMIT BUTTON EXISTS: Prevent duplicate submit buttons
+    const hasExistingSubmitButton = Object.values(existingUISchema.properties).some((uiField) => uiField.widget === 'button');
+    // Filter out new submit buttons if one already exists
+    const filteredNewFieldIds = newFieldIds.filter(id => {
+        const dataField = remappedDataFields[id];
+        if ((dataField.type === 'button' && dataField.buttonType === 'submit') && hasExistingSubmitButton) {
+            //console.log(`⚠️ Skipping new button "${dataField.label}" - submit button already exists in layout`);
+            return false;
+        }
+        return true;
+    });
+    //console.log(`📋 New fields after filtering: ${filteredNewFieldIds.length}`);
+    // Update layout references to use canonical IDs
+    let remappedLayout = remapLayoutIds(existingUISchema.layout, idMap);
+    // Create UI properties for new fields that don't have them yet
+    // ✅ Ensure all existing UI properties have _configured flag (add if missing from imported JSON)
+    const enhancedUIProperties = {};
+    Object.entries(existingUISchema.properties).forEach(([key, uiField]) => {
+        enhancedUIProperties[key] = {
+            ...uiField,
+            _configured: uiField._configured !== undefined ? uiField._configured : true
+        };
+    });
+    if (filteredNewFieldIds.length > 0) {
+        //console.log(`➕ Adding ${filteredNewFieldIds.length} new fields to layout`);
+        // Check if submit button exists and is at the last position (not moved by user)
+        const lastNode = remappedLayout[remappedLayout.length - 1];
+        const isSubmitAtEnd = lastNode?.type === 'field' &&
+            enhancedUIProperties[lastNode.propertyId]?.widget === 'button';
+        const newFieldNodes = [];
+        // Generate default UI properties for new fields
+        filteredNewFieldIds.forEach(id => {
+            const dataField = remappedDataFields[id];
+            const hasOptions = dataField.options !== undefined && dataField.options.length > 0;
+            const widget = inferWidgetFromType(dataField.type, dataField.format, hasOptions);
+            // ✅ Add default button styling
+            const uiProperties = {
+                widget,
+                label: dataField.label,
+                _configured: true
+            };
+            // Add primary styling for buttons
+            if (widget === 'button') {
+                uiProperties.isPrimary = true;
+                uiProperties.name = 'defaultFormSubmit';
+                uiProperties.cssClass = 'e-primary';
+            }
+            enhancedUIProperties[id] = uiProperties;
+            newFieldNodes.push({
+                type: 'field',
+                propertyId: id
+            });
+        });
+        // Apply same logic as App.tsx: insert before submit if it's at the end
+        if (isSubmitAtEnd) {
+            // Insert new fields BEFORE the submit button
+            remappedLayout = [...remappedLayout.slice(0, -1), ...newFieldNodes, remappedLayout[remappedLayout.length - 1]];
+            //console.log(`📐 Layout rebuilt: new fields inserted before submit button at end`);
+        }
+        else {
+            // Submit moved or doesn't exist - add new fields at end
+            remappedLayout = [...remappedLayout, ...newFieldNodes];
+            //console.log(`📐 Layout rebuilt: new fields added at end`);
+        }
+    }
+    // Merge to FormSchema using unified schema
+    const unifiedProperties = {};
+    Object.keys(remappedDataFields).forEach(fieldKey => {
+        const dataField = remappedDataFields[fieldKey];
+        const uiField = enhancedUIProperties[fieldKey];
+        unifiedProperties[fieldKey] = {
+            ...dataField,
+            ...uiField,
+            widget: uiField?.widget || inferWidgetFromType(dataField.type, dataField.format, dataField.options !== undefined)
+        };
+    });
+    const mergedSchema = mergeSchema({
+        version: newDataSchema.version,
+        properties: unifiedProperties,
+        layout: remappedLayout,
+        ...(newDataSchema.settings ? { settings: newDataSchema.settings } : {})
+    });
+    return mergedSchema;
+}
+/**
+ * @private
+ */
+function remapLayoutIds(layout, idMap) {
+    return layout.map(node => {
+        if (node.type === 'field') {
+            const fieldNode = node;
+            const canonicalId = idMap.get(fieldNode.propertyId) || fieldNode.propertyId;
+            return {
+                ...fieldNode,
+                propertyId: canonicalId
+            };
+        }
+        else if (node.type === 'table') {
+            const tableNode = node;
+            return {
+                ...tableNode,
+                cells: tableNode.cells.map(row => row.map(cell => ({
+                    ...cell,
+                    children: remapLayoutIds(cell.children, idMap)
+                })))
+            };
+        }
+        else if (node.type === 'panel') {
+            const panelNode = node;
+            return {
+                ...panelNode,
+                children: remapLayoutIds(panelNode.children, idMap)
+            };
+        }
+        else if (node.type === 'tabs') {
+            const tabsNode = node;
+            return {
+                ...tabsNode,
+                tabs: tabsNode.tabs.map(tab => ({
+                    ...tab,
+                    children: remapLayoutIds(tab.children, idMap)
+                }))
+            };
+        }
+        else if (node.type === 'card') {
+            const cardNode = node;
+            return {
+                ...cardNode,
+                children: remapLayoutIds(cardNode.children, idMap)
+            };
+        }
+        return node;
+    });
+}
+/**
+ * @private
+ */
+export function extractFieldIdsFromLayout(layout) {
+    const fieldIds = new Set();
+    const stack = [...layout];
+    while (stack.length > 0) {
+        const node = stack.shift();
+        if (node.type === 'field') {
+            fieldIds.add(node.propertyId);
+        }
+        else if (node.type === 'table') {
+            node.cells.forEach(row => row.forEach(cell => stack.push(...cell.children)));
+        }
+        else if (node.type === 'panel') {
+            stack.push(...node.children);
+        }
+        else if (node.type === 'tabs') {
+            node.tabs.forEach(tab => stack.push(...tab.children));
+        }
+        else if (node.type === 'card') {
+            stack.push(...node.children);
+        }
+    }
+    return fieldIds;
+}
+/**
+ * @private
+ */
+export function convertComponentsToDataSchema(components) {
+    const properties = {};
+    const seenComponentIds = new Set(); // Track component IDs to prevent duplicates
+    // Flatten all components (including nested ones)
+    const stack = [...components];
+    while (stack.length > 0) {
+        const comp = stack.shift();
+        // Infer semantic type from component
+        const semanticType = UI_TYPE_TO_SEMANTIC_TYPE[comp.type];
+        // Skip presentation-only widgets (button, message, etc.) - they have null semantic type
+        if (semanticType === null) {
+            // Still process nested children for layout containers
+            if (comp.children?.length) {
+                stack.unshift(...comp.children);
+            }
+            if (comp.tabItems?.length) {
+                for (const tab of comp.tabItems) {
+                    if (tab.content?.length) {
+                        stack.unshift(...tab.content);
+                    }
+                }
+            }
+            if (comp.tableCells?.length) {
+                for (const row of comp.tableCells) {
+                    for (const cell of row) {
+                        if (cell.length) {
+                            stack.unshift(...cell);
+                        }
+                    }
+                }
+            }
+            continue; // Skip adding to data schema
+        }
+        // ✅ DEDUPLICATION: Skip if we've already processed this component ID
+        if (seenComponentIds.has(comp.id)) {
+            //console.log(`⚠️ Skipping duplicate component: ${comp.id} (${comp.label})`);
+            // Still process nested children
+            if (comp.children?.length) {
+                stack.unshift(...comp.children);
+            }
+            if (comp.tabItems?.length) {
+                for (const tab of comp.tabItems) {
+                    if (tab.content?.length) {
+                        stack.unshift(...tab.content);
+                    }
+                }
+            }
+            if (comp.tableCells?.length) {
+                for (const row of comp.tableCells) {
+                    for (const cell of row) {
+                        if (cell.length) {
+                            stack.unshift(...cell);
+                        }
+                    }
+                }
+            }
+            continue;
+        }
+        seenComponentIds.add(comp.id);
+        // Generate fieldKey from label or ID
+        const baseFieldKey = labelToFieldKey(comp.label || comp.id, comp.id);
+        const fieldKey = makeUniqueFieldKey(baseFieldKey, new Set(Object.keys(properties)), comp.id);
+        const dataField = extractDataField(comp, semanticType || { type: 'any' });
+        properties[fieldKey] = dataField;
+        // Process nested children
+        if (comp.children?.length) {
+            stack.unshift(...comp.children);
+        }
+        // Process tab items
+        if (comp.tabItems?.length) {
+            for (const tab of comp.tabItems) {
+                if (tab.content?.length) {
+                    stack.unshift(...tab.content);
+                }
+            }
+        }
+        // Process table cells
+        if (comp.tableCells?.length) {
+            for (const row of comp.tableCells) {
+                for (const cell of row) {
+                    // cell is FormComponent[], not an object with .components
+                    if (cell.length) {
+                        stack.unshift(...cell);
+                    }
+                }
+            }
+        }
+    }
+    return {
+        version: '1.0',
+        properties
+    };
+}