storefront-layouts 1.0.0

package/dist/editor/payaza-form/data-transformer.d.ts

@@ -0,0 +1,28 @@
+import { OverlayLayoutJSON } from './engine';
+import { StoreConfig } from '../../lib/store-types';
+/**
+ * Transform overlay JSON to StoreConfig format for preview
+ * Merges page data into existing StoreConfig to preserve all properties
+ */
+export declare function transformToStoreConfig(layoutJson: OverlayLayoutJSON, pageId: string, baseStoreConfig?: StoreConfig): StoreConfig;
+/**
+ * Update overlay JSON data from editor changes
+ */
+export declare function updateOverlayData(layoutJson: OverlayLayoutJSON, pageId: string, sectionKey: string, fieldPath: string[], value: any): OverlayLayoutJSON;
+/** Read nested value following string keys / array indices (mirrors navigation in `updateOverlayData`, read-only). */
+export declare function readDataAtPath(root: unknown, fieldPath: string[]): unknown;
+/** Read a field inside `pages[pageId].data[sectionKey]` for inspector / granular editing. */
+export declare function readOverlayFieldValue(layoutJson: OverlayLayoutJSON, pageId: string, sectionKey: string, fieldPath: string[]): unknown;
+/**
+ * Update array item in overlay data
+ */
+export declare function updateArrayItem(layoutJson: OverlayLayoutJSON, pageId: string, sectionKey: string, arrayPath: string[], index: number, itemValue: any): OverlayLayoutJSON;
+/**
+ * Add array item to overlay data
+ */
+export declare function addArrayItem(layoutJson: OverlayLayoutJSON, pageId: string, sectionKey: string, arrayPath: string[], newItem: any): OverlayLayoutJSON;
+/**
+ * Remove array item from overlay data
+ */
+export declare function removeArrayItem(layoutJson: OverlayLayoutJSON, pageId: string, sectionKey: string, arrayPath: string[], index: number): OverlayLayoutJSON;
+//# sourceMappingURL=data-transformer.d.ts.map

package/dist/editor/payaza-form/data-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-transformer.d.ts","sourceRoot":"","sources":["../../../src/editor/payaza-form/data-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgC,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAmB,MAAM,uBAAuB,CAAC;AA6CrE;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,WAAW,GAC5B,WAAW,CA4Gb;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,GAAG,GACT,iBAAiB,CA+DnB;AAED,sHAAsH;AACtH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAS1E;AAED,6FAA6F;AAC7F,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,GACb,iBAAiB,CA8BnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,GAAG,GACX,iBAAiB,CA8BnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,GACZ,iBAAiB,CA8BnB"}

package/dist/editor/payaza-form/data-transformer.js

@@ -0,0 +1,304 @@
+import { deepClone } from '../../lib/utils/index.js';
+import { normalizeLayoutConfigFieldShapes } from '../../lib/layout-field-normalize.js';
+import { sanitizeBookingTestimonialItemsForSave } from '../../layouts/booking/components/booking-testimonial-defaults.js';
+/**
+ * Helper to set value at deep path in object
+ */
+function setValueByPath(obj, path, value) {
+    if (!path)
+        return obj;
+    const parts = path.split('.');
+    const result = { ...obj };
+    let current = result;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!current[part] || typeof current[part] !== 'object') {
+            current[part] = {};
+        }
+        current[part] = { ...current[part] };
+        current = current[part];
+    }
+    // If the value is an object, merge it with existing data at that path
+    // This prevents sibling sections from overwriting each other
+    const existingValue = current[parts[parts.length - 1]];
+    if (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        typeof existingValue === 'object' &&
+        existingValue !== null &&
+        !Array.isArray(existingValue)) {
+        current[parts[parts.length - 1]] = {
+            ...existingValue,
+            ...value
+        };
+    }
+    else {
+        current[parts[parts.length - 1]] = value;
+    }
+    return result;
+}
+/**
+ * Transform overlay JSON to StoreConfig format for preview
+ * Merges page data into existing StoreConfig to preserve all properties
+ */
+export function transformToStoreConfig(layoutJson, pageId, baseStoreConfig) {
+    const page = layoutJson.pages.find(p => p.id === pageId);
+    if (!page) {
+        throw new Error(`Page ${pageId} not found in layout JSON`);
+    }
+    // If no baseStoreConfig, create a minimal one
+    let storeConfig = baseStoreConfig
+        ? { ...baseStoreConfig, layout: layoutJson.layoutId }
+        : { layout: layoutJson.layoutId, layoutConfig: { sections: {} } };
+    // Use schema to project data back to StoreConfig structure
+    const sections = page._schema;
+    const pageData = page.data;
+    // Initialize layoutConfig structure
+    if (!storeConfig.layoutConfig)
+        storeConfig.layoutConfig = { sections: {} };
+    if (!storeConfig.layoutConfig.sections)
+        storeConfig.layoutConfig.sections = {};
+    // For non-home pages, initialize pages structure
+    if (pageId !== 'home') {
+        if (!storeConfig.layoutConfig.pages)
+            storeConfig.layoutConfig.pages = {};
+        if (!storeConfig.layoutConfig.pages[pageId])
+            storeConfig.layoutConfig.pages[pageId] = {};
+    }
+    for (const sectionKey in sections) {
+        const sectionSchema = sections[sectionKey];
+        const sectionData = pageData[sectionKey];
+        if (sectionData === undefined)
+            continue;
+        if (sectionSchema._sourcePath) {
+            // Use explicit source path to project data back
+            // This ensures data is saved to the exact same location it was loaded from
+            const clonedData = deepClone(sectionData);
+            if (layoutJson.layoutId === 'booking' &&
+                pageId === 'home' &&
+                sectionKey === 'testimonials' &&
+                Array.isArray(clonedData.items)) {
+                clonedData.items = sanitizeBookingTestimonialItemsForSave(clonedData.items);
+            }
+            storeConfig = setValueByPath(storeConfig, sectionSchema._sourcePath, clonedData);
+            // Keep legacy assignedAssets in sync for booking image fields
+            if (layoutJson.layoutId === 'booking' && pageId === 'home') {
+                if (!storeConfig.layoutConfig.assignedAssets) {
+                    storeConfig.layoutConfig.assignedAssets = {};
+                }
+                const assets = storeConfig.layoutConfig.assignedAssets;
+                if (sectionKey === 'hero' && typeof clonedData.hero_bg === 'string' && clonedData.hero_bg.trim()) {
+                    assets.hero_bg = clonedData.hero_bg.trim();
+                }
+                if (sectionKey === 'team' &&
+                    typeof clonedData.specialist_image === 'string' &&
+                    clonedData.specialist_image.trim()) {
+                    assets.specialist_image = clonedData.specialist_image.trim();
+                }
+                if (sectionKey === 'promoBanner' && typeof clonedData.image === 'string' && clonedData.image.trim()) {
+                    assets.promo_banner = clonedData.image.trim();
+                }
+            }
+        }
+        else {
+            // Fallback: Save to appropriate location based on pageId
+            if (pageId === 'home') {
+                // Home page: save to sections[sectionKey]
+                storeConfig.layoutConfig.sections[sectionKey] = deepClone(sectionData);
+            }
+            else {
+                // Non-home pages: save to pages[pageId][sectionKey]
+                storeConfig.layoutConfig.pages[pageId][sectionKey] = deepClone(sectionData);
+                // Also save to sections for backward compatibility
+                storeConfig.layoutConfig.sections[sectionKey] = deepClone(sectionData);
+            }
+        }
+    }
+    if (storeConfig.layoutConfig) {
+        const normalized = normalizeLayoutConfigFieldShapes(storeConfig.layoutConfig);
+        if (normalized) {
+            storeConfig.layoutConfig = normalized;
+        }
+    }
+    // Sync booking hero text into assignedText for legacy storefront readers
+    if (layoutJson.layoutId === 'booking' && storeConfig.layoutConfig?.sections?.hero) {
+        const hero = storeConfig.layoutConfig.sections.hero;
+        if (!storeConfig.layoutConfig.assignedText) {
+            storeConfig.layoutConfig.assignedText = {};
+        }
+        const assignedText = storeConfig.layoutConfig.assignedText;
+        if (typeof hero.hero_badge === 'string' && hero.hero_badge.trim()) {
+            assignedText.hero_badge = hero.hero_badge.trim();
+        }
+        const title = typeof hero.title === 'string' ? hero.title : typeof hero.headline === 'string' ? hero.headline : '';
+        if (title.trim())
+            assignedText.hero_title = title.trim();
+        const subtitle = typeof hero.subtitle === 'string' ? hero.subtitle : typeof hero.tagline === 'string' ? hero.tagline : '';
+        if (subtitle.trim())
+            assignedText.hero_subtitle = subtitle.trim();
+    }
+    return storeConfig;
+}
+/**
+ * Update overlay JSON data from editor changes
+ */
+export function updateOverlayData(layoutJson, pageId, sectionKey, fieldPath, value) {
+    const updatedJson = { ...layoutJson };
+    const pageIndex = updatedJson.pages.findIndex(p => p.id === pageId);
+    if (pageIndex === -1) {
+        throw new Error(`Page ${pageId} not found`);
+    }
+    const page = { ...updatedJson.pages[pageIndex] };
+    const updatedData = { ...page.data };
+    // Navigate to the section
+    if (!updatedData[sectionKey]) {
+        updatedData[sectionKey] = {};
+    }
+    // When committing to `items.{index}.*` or `sliders.{index}.*`, pad the array so
+    // sibling slots are not dropped when editing nested hero slide fields.
+    if (fieldPath.length >= 3 &&
+        /^\d+$/.test(String(fieldPath[1])) &&
+        (fieldPath[0] === 'items' || fieldPath[0] === 'sliders')) {
+        const arrayKey = fieldPath[0];
+        const targetIndex = parseInt(String(fieldPath[1]), 10);
+        const sectionRoot = { ...updatedData[sectionKey] };
+        const existingItems = Array.isArray(sectionRoot[arrayKey]) ? [...sectionRoot[arrayKey]] : [];
+        while (existingItems.length <= targetIndex) {
+            existingItems.push({});
+        }
+        sectionRoot[arrayKey] = existingItems;
+        updatedData[sectionKey] = sectionRoot;
+    }
+    // Preserve Arrays (section.blocks, innerBlocks chains) — never spread an array into `{}`.
+    let current = updatedData[sectionKey];
+    for (let i = 0; i < fieldPath.length - 1; i++) {
+        const segment = fieldPath[i];
+        let child = current?.[segment];
+        if (child == null || typeof child !== 'object') {
+            const nextSeg = fieldPath[i + 1];
+            const nextIsIndex = nextSeg !== undefined && /^\d+$/.test(String(nextSeg));
+            child = nextIsIndex ? [] : {};
+            current[segment] = child;
+        }
+        else if (Array.isArray(child)) {
+            current[segment] = [...child];
+            child = current[segment];
+        }
+        else {
+            current[segment] = { ...child };
+            child = current[segment];
+        }
+        current = child;
+    }
+    const leafKey = fieldPath[fieldPath.length - 1];
+    current[leafKey] = value;
+    page.data = updatedData;
+    updatedJson.pages[pageIndex] = page;
+    return updatedJson;
+}
+/** Read nested value following string keys / array indices (mirrors navigation in `updateOverlayData`, read-only). */
+export function readDataAtPath(root, fieldPath) {
+    if (root == null)
+        return undefined;
+    if (fieldPath.length === 0)
+        return root;
+    let current = root;
+    for (const segment of fieldPath) {
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+/** Read a field inside `pages[pageId].data[sectionKey]` for inspector / granular editing. */
+export function readOverlayFieldValue(layoutJson, pageId, sectionKey, fieldPath) {
+    const page = layoutJson.pages.find((p) => p.id === pageId);
+    if (!page)
+        return undefined;
+    const sectionRoot = page.data[sectionKey];
+    return readDataAtPath(sectionRoot, fieldPath);
+}
+/**
+ * Update array item in overlay data
+ */
+export function updateArrayItem(layoutJson, pageId, sectionKey, arrayPath, index, itemValue) {
+    const updatedJson = { ...layoutJson };
+    const pageIndex = updatedJson.pages.findIndex(p => p.id === pageId);
+    if (pageIndex === -1) {
+        throw new Error(`Page ${pageId} not found`);
+    }
+    const page = { ...updatedJson.pages[pageIndex] };
+    const updatedData = { ...page.data };
+    // Navigate to the array
+    let current = updatedData[sectionKey];
+    for (const key of arrayPath) {
+        if (!current[key]) {
+            current[key] = [];
+        }
+        current[key] = [...current[key]];
+        current = current[key];
+    }
+    // Update the item at index
+    if (Array.isArray(current)) {
+        current[index] = itemValue;
+    }
+    page.data = updatedData;
+    updatedJson.pages[pageIndex] = page;
+    return updatedJson;
+}
+/**
+ * Add array item to overlay data
+ */
+export function addArrayItem(layoutJson, pageId, sectionKey, arrayPath, newItem) {
+    const updatedJson = { ...layoutJson };
+    const pageIndex = updatedJson.pages.findIndex(p => p.id === pageId);
+    if (pageIndex === -1) {
+        throw new Error(`Page ${pageId} not found`);
+    }
+    const page = { ...updatedJson.pages[pageIndex] };
+    const updatedData = { ...page.data };
+    // Navigate to the array
+    let current = updatedData[sectionKey];
+    for (const key of arrayPath) {
+        if (!current[key]) {
+            current[key] = [];
+        }
+        current[key] = [...current[key]];
+        current = current[key];
+    }
+    // Add the new item
+    if (Array.isArray(current)) {
+        current.push(newItem);
+    }
+    page.data = updatedData;
+    updatedJson.pages[pageIndex] = page;
+    return updatedJson;
+}
+/**
+ * Remove array item from overlay data
+ */
+export function removeArrayItem(layoutJson, pageId, sectionKey, arrayPath, index) {
+    const updatedJson = { ...layoutJson };
+    const pageIndex = updatedJson.pages.findIndex(p => p.id === pageId);
+    if (pageIndex === -1) {
+        throw new Error(`Page ${pageId} not found`);
+    }
+    const page = { ...updatedJson.pages[pageIndex] };
+    const updatedData = { ...page.data };
+    // Navigate to the array
+    let current = updatedData[sectionKey];
+    for (const key of arrayPath) {
+        if (!current[key]) {
+            return updatedJson; // Array doesn't exist
+        }
+        current[key] = [...current[key]];
+        current = current[key];
+    }
+    // Remove the item at index
+    if (Array.isArray(current)) {
+        current.splice(index, 1);
+    }
+    page.data = updatedData;
+    updatedJson.pages[pageIndex] = page;
+    return updatedJson;
+}

package/dist/editor/payaza-form/engine.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Payaza Form Engine
+ * Parses overlay pattern JSON (data + _schema) and generates form configurations
+ */
+import { SchemaNode } from '../alignment-schemas/types';
+export interface OverlayLayoutJSON {
+    layoutId: string;
+    layoutName: string;
+    pages: Array<{
+        id: string;
+        label: string;
+        path: string;
+        data: Record<string, any>;
+        _schema: Record<string, any> | Record<string, SchemaNode>;
+        /**
+         * Optional explicit order of section keys for outline / block tree (WordPress-style).
+         * Keys must exist in `_schema`. Unknown keys are ignored; missing keys append in schema order.
+         */
+        sectionOrder?: string[];
+        /** Set when page data was loaded from persisted merchant config (not raw schema defaults). */
+        _hydrated?: boolean;
+    }>;
+}
+export interface SchemaField extends Partial<SchemaNode> {
+    _editor?: string;
+    _label?: string;
+    _description?: string;
+    _itemEditor?: string;
+    _itemSchema?: Record<string, SchemaField>;
+    [key: string]: any;
+}
+export interface FieldConfig {
+    editor: string;
+    label: string;
+    description?: string;
+    value: any;
+    path: string[];
+    itemSchema?: Record<string, any>;
+    itemEditor?: string;
+}
+/**
+ * Parse overlay pattern JSON structure
+ */
+export declare function parseLayoutJSON(json: OverlayLayoutJSON): OverlayLayoutJSON;
+/**
+ * Get schema for a specific page
+ */
+export declare function getPageSchema(pageId: string, layoutJson: OverlayLayoutJSON): {
+    data: Record<string, any>;
+    schema: Record<string, any>;
+} | null;
+/**
+ * Generate field configuration from schema field (supports both legacy and new formats)
+ */
+export declare function getFieldConfig(schemaField: any, dataValue: any, path?: string[]): FieldConfig;
+/**
+ * Resolve data path from schema structure
+ */
+export declare function resolveDataPath(schemaPath: string[], schema: Record<string, any>, data: Record<string, any>): any;
+/**
+ * Set data value at path
+ */
+export declare function setDataPath(data: Record<string, any>, path: string[], value: any): Record<string, any>;
+/**
+ * Generate default value from schema field (supports both legacy and new formats)
+ */
+export declare function generateDefaultValue(schemaField: any): any;
+/**
+ * Generate default array item from itemSchema
+ */
+export declare function generateArrayItem(itemSchema: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/editor/payaza-form/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/editor/payaza-form/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAmB,MAAM,4BAA4B,CAAC;AAGzE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC1D;;;WAGG;QACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,8FAA8F;QAC9F,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC,CAAC;CACJ;AAGD,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,UAAU,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAc1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,iBAAiB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,IAAI,CAQnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,GAAG,EAChB,SAAS,EAAE,GAAG,EACd,IAAI,GAAE,MAAM,EAAO,GAClB,WAAW,CAgBb;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,GAAG,CAcL;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,GAAG,GACT,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAoBrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,GAAG,GAAG,GAAG,CAmC1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAYtF"}

package/dist/editor/payaza-form/engine.js

@@ -0,0 +1,140 @@
+import { deepClone } from '../../lib/utils/index.js';
+/**
+ * Parse overlay pattern JSON structure
+ */
+export function parseLayoutJSON(json) {
+    // Validate structure
+    if (!json.layoutId || !json.pages || !Array.isArray(json.pages)) {
+        throw new Error('Invalid overlay layout JSON structure');
+    }
+    // Validate each page has data and _schema
+    json.pages.forEach(page => {
+        if (!page.data || !page._schema) {
+            throw new Error(`Page ${page.id} missing data or _schema`);
+        }
+    });
+    return json;
+}
+/**
+ * Get schema for a specific page
+ */
+export function getPageSchema(pageId, layoutJson) {
+    const page = layoutJson.pages.find(p => p.id === pageId);
+    if (!page)
+        return null;
+    return {
+        data: page.data,
+        schema: page._schema,
+    };
+}
+/**
+ * Generate field configuration from schema field (supports both legacy and new formats)
+ */
+export function getFieldConfig(schemaField, dataValue, path = []) {
+    const editor = schemaField.type || schemaField._editor || 'text';
+    const label = schemaField.label || schemaField._label || '';
+    const description = schemaField.description || schemaField._description;
+    const itemSchema = schemaField.itemSchema || schemaField._itemSchema;
+    const itemEditor = schemaField.itemEditor || schemaField._itemEditor;
+    return {
+        editor,
+        label,
+        description,
+        value: dataValue,
+        path,
+        itemSchema,
+        itemEditor,
+    };
+}
+/**
+ * Resolve data path from schema structure
+ */
+export function resolveDataPath(schemaPath, schema, data) {
+    let currentSchema = schema;
+    let currentData = data;
+    for (const key of schemaPath) {
+        if (currentSchema[key] && currentData[key] !== undefined) {
+            currentSchema = currentSchema[key];
+            currentData = currentData[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return currentData;
+}
+/**
+ * Set data value at path
+ */
+export function setDataPath(data, path, value) {
+    const result = { ...data };
+    let current = result;
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        if (!current[key] || typeof current[key] !== 'object') {
+            current[key] = typeof path[i + 1] === 'number' ? [] : {};
+        }
+        if (Array.isArray(current[key])) {
+            current[key] = [...current[key]];
+        }
+        else {
+            current[key] = { ...current[key] };
+        }
+        current = current[key];
+    }
+    current[path[path.length - 1]] = value;
+    return result;
+}
+/**
+ * Generate default value from schema field (supports both legacy and new formats)
+ */
+export function generateDefaultValue(schemaField) {
+    // Respect explicit defaultValue if provided in schema
+    if (schemaField.defaultValue !== undefined)
+        return deepClone(schemaField.defaultValue);
+    if (schemaField._defaultValue !== undefined)
+        return deepClone(schemaField._defaultValue);
+    const type = schemaField.type || schemaField._editor;
+    switch (type) {
+        case 'toggle':
+            return false;
+        case 'number':
+            return 0;
+        case 'rating':
+            return typeof schemaField.defaultValue === 'number' ? schemaField.defaultValue : 5;
+        case 'text':
+        case 'multiline_text':
+        case 'image':
+        case 'icon':
+        case 'color':
+            return '';
+        case 'array':
+            return [];
+        case 'section':
+        case 'object':
+        case 'button':
+            const fields = schemaField.fields || schemaField._itemSchema || schemaField;
+            const defaults = {};
+            Object.entries(fields).forEach(([key, field]) => {
+                if (key.startsWith('_'))
+                    return;
+                defaults[key] = generateDefaultValue(field);
+            });
+            return defaults;
+        default:
+            return null;
+    }
+}
+/**
+ * Generate default array item from itemSchema
+ */
+export function generateArrayItem(itemSchema) {
+    const item = {};
+    Object.entries(itemSchema).forEach(([key, field]) => {
+        item[key] = generateDefaultValue(field);
+    });
+    if (item.id === undefined || item.id === '') {
+        item.id = `item-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    }
+    return item;
+}

package/dist/editor/payaza-form/examples/custom-widgets.example.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Example: Custom Widget Registration for Payaza Form Editor
+ *
+ * This file demonstrates how to register custom React components
+ * as widgets for the Payaza Form Editor, similar to Puck's component registry.
+ */
+export declare const EditorWithCustomWidgets: () => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=custom-widgets.example.d.ts.map

package/dist/editor/payaza-form/examples/custom-widgets.example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-widgets.example.d.ts","sourceRoot":"","sources":["../../../../src/editor/payaza-form/examples/custom-widgets.example.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqLH,eAAO,MAAM,uBAAuB,+CAenC,CAAC"}

package/dist/editor/payaza-form/examples/custom-widgets.example.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { registerWidget, registerWidgets, PayazaFormEditorFullPage } from '../index.js';
+// Example 1: Custom Text Field Widget
+const CustomTextField = ({ label, value, onChange }) => {
+    return (_jsxs("div", { className: "custom-text-field", children: [_jsx("label", { className: "text-sm font-semibold text-gray-700 mb-1 block", children: label }), _jsx("input", { type: "text", value: value || '', onChange: (e) => onChange(e.target.value), className: "w-full px-4 py-2 border-2 border-blue-300 rounded-lg focus:border-blue-500 focus:outline-none", placeholder: `Enter ${label.toLowerCase()}...` })] }));
+};
+// Example 2: Custom Color Picker Widget
+const CustomColorPicker = ({ label, value, onChange }) => {
+    return (_jsxs("div", { className: "custom-color-picker", children: [_jsx("label", { className: "text-sm font-semibold text-gray-700 mb-2 block", children: label }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsx("input", { type: "color", value: value || '#000000', onChange: (e) => onChange(e.target.value), className: "w-16 h-16 rounded border-2 border-gray-300 cursor-pointer" }), _jsx("input", { type: "text", value: value || '', onChange: (e) => onChange(e.target.value), className: "flex-1 px-3 py-2 border border-gray-300 rounded focus:border-blue-500 focus:outline-none uppercase font-mono text-sm", placeholder: "#000000", pattern: "^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$" })] })] }));
+};
+// Example 3: Custom Rich Text Editor Widget
+const CustomRichTextEditor = ({ label, value, onChange }) => {
+    return (_jsxs("div", { className: "custom-rich-text-editor", children: [_jsx("label", { className: "text-sm font-semibold text-gray-700 mb-2 block", children: label }), _jsxs("div", { className: "border border-gray-300 rounded-lg overflow-hidden", children: [_jsxs("div", { className: "bg-gray-100 px-3 py-2 border-b border-gray-300 flex gap-2", children: [_jsx("button", { type: "button", className: "px-2 py-1 text-sm hover:bg-gray-200 rounded", title: "Bold", children: _jsx("strong", { children: "B" }) }), _jsx("button", { type: "button", className: "px-2 py-1 text-sm hover:bg-gray-200 rounded", title: "Italic", children: _jsx("em", { children: "I" }) }), _jsx("button", { type: "button", className: "px-2 py-1 text-sm hover:bg-gray-200 rounded", title: "Underline", children: _jsx("u", { children: "U" }) })] }), _jsx("textarea", { value: value || '', onChange: (e) => onChange(e.target.value), className: "w-full px-4 py-3 min-h-[200px] focus:outline-none resize-y", placeholder: `Enter ${label.toLowerCase()}...` })] })] }));
+};
+// Example 4: Custom Image Upload Widget
+const CustomImageUpload = ({ label, value, onChange }) => {
+    const handleFileChange = (e) => {
+        const file = e.target.files?.[0];
+        if (file) {
+            // In a real implementation, you would upload the file and get a URL
+            // For this example, we'll use a FileReader to create a data URL
+            const reader = new FileReader();
+            reader.onloadend = () => {
+                onChange(reader.result);
+            };
+            reader.readAsDataURL(file);
+        }
+    };
+    return (_jsxs("div", { className: "custom-image-upload", children: [_jsx("label", { className: "text-sm font-semibold text-gray-700 mb-2 block", children: label }), _jsxs("div", { className: "space-y-3", children: [value && (_jsxs("div", { className: "relative", children: [_jsx("img", { src: value, alt: label, className: "w-full h-48 object-cover rounded-lg border-2 border-gray-300" }), _jsx("button", { type: "button", onClick: () => onChange(''), className: "absolute top-2 right-2 bg-red-500 text-white rounded-full w-6 h-6 flex items-center justify-center hover:bg-red-600", children: "\u00D7" })] })), _jsxs("div", { className: "border-2 border-dashed border-gray-300 rounded-lg p-6 text-center", children: [_jsx("input", { type: "file", accept: "image/*", onChange: handleFileChange, className: "hidden", id: `image-upload-${label}` }), _jsx("label", { htmlFor: `image-upload-${label}`, className: "cursor-pointer text-gray-600 hover:text-blue-600", children: value ? 'Change Image' : 'Click to upload or drag and drop' })] }), value && (_jsx("input", { type: "text", value: value, onChange: (e) => onChange(e.target.value), className: "w-full px-3 py-2 border border-gray-300 rounded focus:border-blue-500 focus:outline-none text-sm", placeholder: "Or enter image URL" }))] })] }));
+};
+// Register widgets individually
+registerWidget('custom-text', CustomTextField);
+registerWidget('color', CustomColorPicker);
+registerWidget('rich_text', CustomRichTextEditor);
+registerWidget('image-upload', CustomImageUpload);
+// Or register multiple widgets at once
+registerWidgets({
+    'custom-text': CustomTextField,
+    'color': CustomColorPicker,
+    'rich_text': CustomRichTextEditor,
+    'image-upload': CustomImageUpload,
+});
+// Example: Using custom widgets in the editor
+export const EditorWithCustomWidgets = () => {
+    return (_jsx(PayazaFormEditorFullPage, { layoutId: "fashion-hub", initialData: {}, customWidgets: {
+            'custom-text': CustomTextField,
+            'color': CustomColorPicker,
+            'rich_text': CustomRichTextEditor,
+            'image-upload': CustomImageUpload,
+        }, onChange: (data) => console.log('Data changed:', data), onSave: (data) => console.log('Save:', data) }));
+};

package/dist/editor/payaza-form/field-renderer-ref.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentType } from 'react';
+export declare function registerFieldRenderer(component: ComponentType<any>): void;
+export declare function getFieldRenderer(): ComponentType<any>;
+//# sourceMappingURL=field-renderer-ref.d.ts.map

package/dist/editor/payaza-form/field-renderer-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-renderer-ref.d.ts","sourceRoot":"","sources":["../../../src/editor/payaza-form/field-renderer-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAY3C,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAEzE;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAAC,GAAG,CAAC,CAGrD"}

package/dist/editor/payaza-form/field-renderer-ref.js

@@ -0,0 +1,16 @@
+// Breaks the circular import cycle:
+//   FieldRenderer → ArrayField → ArrayItemManager → FieldRenderer
+//   FieldRenderer → ArrayField → ArrayItemManager → SliderArrayEditor → FieldRenderer
+//
+// ArrayItemManager and SliderArrayEditor import from HERE instead of from FieldRenderer.
+// FieldRenderer registers itself after definition. Both consumers call getFieldRenderer()
+// only at render time (inside function bodies), which is always after all modules initialize.
+let _ref = null;
+export function registerFieldRenderer(component) {
+    _ref = component;
+}
+export function getFieldRenderer() {
+    if (!_ref)
+        throw new Error('[PayazaForm] FieldRenderer not yet registered');
+    return _ref;
+}

package/dist/editor/payaza-form/index.d.ts

@@ -0,0 +1,11 @@
+export { PayazaFormEditor } from './PayazaFormEditor';
+export type { PayazaFormEditorProps } from './PayazaFormEditor';
+export { PayazaFormEditorFullPage } from './PayazaFormEditorFullPage';
+export type { PayazaFormEditorFullPageProps } from './PayazaFormEditorFullPage';
+export { getGlobalAssetSelectionHandler, setGlobalAssetSelectionHandler } from './AssetSelectionContext';
+export * from './engine';
+export * from './data-transformer';
+export * from './layout-loader';
+export * from './widget-registry';
+export * from '../document';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/payaza-form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/payaza-form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzG,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}