storefront-layouts-staging 1.0.0-staging.0

package/dist/editor/document/types.d.ts

@@ -0,0 +1,91 @@
+import type { StoreLayoutType } from '../../lib/store-types';
+export type TemplateKind = 'home' | 'header' | 'footer' | 'product' | 'category' | 'checkout' | 'custom';
+export type ContentEntrySource = 'merchant' | 'system-default' | 'migration';
+export interface VisibilityRule {
+    id: string;
+    when: Record<string, unknown>;
+}
+/**
+ * Maps a block back to storefront overlay / StoreConfig (WordPress “synced” pattern).
+ */
+export type BlockBinding = {
+    kind: 'overlay-section';
+    pageId: string;
+    sectionKey: string;
+    /** When alignment schema sets `_sourcePath`, edits compile here. */
+    sourcePath?: string;
+    /** False when section payload is raw schema defaults (non-hydrated overlay page). */
+    hydrated?: boolean;
+} | {
+    kind: 'custom';
+    /** Arbitrary persistence key for future block types */
+    key: string;
+};
+/**
+ * WordPress-like block: stable `id` (clientId), registered `type` / `name`, `attributes`, `innerBlocks`.
+ */
+export interface BlockNode {
+    /** Stable editor id (equivalent to Gutenberg clientId). */
+    id: string;
+    /**
+     * Registered block name, e.g. `shopaza/section`.
+     * Prefer this in new code; `type` is kept for serialized parity.
+     */
+    type: string;
+    /** Optional explicit `name` when it differs from legacy `type` storage; usually omitted. */
+    name?: string;
+    attributes: Record<string, unknown>;
+    innerBlocks: string[];
+    bind?: BlockBinding;
+    visibilityRules?: VisibilityRule[];
+}
+export interface SlotDefinition {
+    slotId: string;
+    label: string;
+    allowedBlockTypes: string[];
+    maxChildren?: number;
+}
+export interface TemplateDocument {
+    rootBlockId: string;
+    blocks: Record<string, BlockNode>;
+    slots: Record<string, SlotDefinition>;
+}
+export interface ContentEntry {
+    key: string;
+    value: unknown;
+    source: ContentEntrySource;
+    updatedAt: string;
+}
+export interface ContentDocument {
+    entries: Record<string, ContentEntry>;
+}
+export interface StyleDocument {
+    /** Keys should follow `--layout-{layoutType}-{token}` when persisted. */
+    globalTokens: Record<string, string>;
+    blockStyleOverrides: Record<string, Record<string, string | number>>;
+    themePresetRef?: string;
+}
+export interface EditorDocumentEnvelope {
+    documentId: string;
+    storeId: string;
+    layoutType: StoreLayoutType;
+    layoutVersion: number;
+    templateType: TemplateKind;
+    templateId: string;
+    editorDocVersion: number;
+    updatedAt: string;
+    template: TemplateDocument;
+    content: ContentDocument;
+    styles: StyleDocument;
+}
+export type InteractionMode = 'edit' | 'preview';
+export interface ValidationDiagnostic {
+    gate: 'envelope' | 'schema' | 'style' | 'contamination' | 'compatibility';
+    message: string;
+    path?: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    diagnostics: ValidationDiagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/editor/document/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/editor/document/types.ts"],"names":[],"mappings":"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"}

package/dist/editor/document/types.js

@@ -0,0 +1 @@
+export {};

package/dist/editor/document/validate.d.ts

@@ -0,0 +1,11 @@
+import type { StoreLayoutType } from '../../lib/store-types';
+import type { EditorDocumentEnvelope, StyleDocument, ValidationDiagnostic, ValidationResult } from './types';
+/**
+ * Validate envelope + style namespace + basic contamination (foreign layout token prefixes).
+ */
+export declare function validateEditorEnvelope(env: EditorDocumentEnvelope, options?: {
+    allowEditorDocVersions?: number[];
+}): ValidationResult;
+export declare function validateStyles(layoutType: StoreLayoutType, styles: StyleDocument, diagnostics: ValidationDiagnostic[]): void;
+export declare function documentScopeKey(env: Pick<EditorDocumentEnvelope, 'storeId' | 'layoutType' | 'templateType' | 'templateId'>): string;
+//# sourceMappingURL=validate.d.ts.map

package/dist/editor/document/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/editor/document/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAY7G;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,sBAAsB,EAC3B,OAAO,CAAC,EAAE;IAAE,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9C,gBAAgB,CAuClB;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAuCrH;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,CAAC,UAE3H"}

package/dist/editor/document/validate.js

@@ -0,0 +1,92 @@
+import { EDITOR_DOC_VERSION, SUPPORTED_LAYOUT_TYPES, SNAPSHOT_CONTENT_KEY } from './constants.js';
+function push(diagnostics, d) {
+    diagnostics.push(d);
+}
+function isSupportedLayout(layoutType) {
+    return SUPPORTED_LAYOUT_TYPES.includes(layoutType);
+}
+const STYLE_TOKEN_PREFIX_RE = /^--layout-([a-z0-9-]+)-/i;
+/**
+ * Validate envelope + style namespace + basic contamination (foreign layout token prefixes).
+ */
+export function validateEditorEnvelope(env, options) {
+    const diagnostics = [];
+    const allowedVersions = options?.allowEditorDocVersions ?? [EDITOR_DOC_VERSION];
+    if (!env.storeId?.trim()) {
+        push(diagnostics, { gate: 'envelope', message: 'storeId is required' });
+    }
+    if (!isSupportedLayout(env.layoutType)) {
+        push(diagnostics, {
+            gate: 'envelope',
+            message: `layoutType "${env.layoutType}" is not supported`,
+            path: 'layoutType',
+        });
+    }
+    if (!allowedVersions.includes(env.editorDocVersion)) {
+        push(diagnostics, {
+            gate: 'envelope',
+            message: `editorDocVersion ${env.editorDocVersion} is not supported (allowed: ${allowedVersions.join(', ')})`,
+            path: 'editorDocVersion',
+        });
+    }
+    if (!env.templateId?.trim()) {
+        push(diagnostics, { gate: 'envelope', message: 'templateId is required', path: 'templateId' });
+    }
+    if (isSupportedLayout(env.layoutType)) {
+        validateStyles(env.layoutType, env.styles, diagnostics);
+    }
+    const snap = env.content.entries[SNAPSHOT_CONTENT_KEY];
+    if (!snap || snap.value == null) {
+        push(diagnostics, {
+            gate: 'compatibility',
+            message: `Missing content.entries["${SNAPSHOT_CONTENT_KEY}"] for legacy compile path`,
+            path: `content.entries.${SNAPSHOT_CONTENT_KEY}`,
+        });
+    }
+    return { ok: diagnostics.length === 0, diagnostics };
+}
+export function validateStyles(layoutType, styles, diagnostics) {
+    for (const key of Object.keys(styles.globalTokens)) {
+        if (!key.startsWith('--layout-')) {
+            push(diagnostics, {
+                gate: 'style',
+                message: `Token "${key}" must start with --layout-`,
+                path: `styles.globalTokens.${key}`,
+            });
+            continue;
+        }
+        const m = key.match(STYLE_TOKEN_PREFIX_RE);
+        if (m && m[1] !== layoutType) {
+            push(diagnostics, {
+                gate: 'contamination',
+                message: `Token "${key}" is namespaced for layout "${m[1]}" but envelope layoutType is "${layoutType}"`,
+                path: `styles.globalTokens.${key}`,
+            });
+        }
+    }
+    for (const blockId of Object.keys(styles.blockStyleOverrides)) {
+        const o = styles.blockStyleOverrides[blockId];
+        if (!o || typeof o !== 'object')
+            continue;
+        for (const [prop, val] of Object.entries(o)) {
+            if (typeof val !== 'string')
+                continue;
+            const v = val.trim();
+            if (!v.startsWith('var(--layout-'))
+                continue;
+            const inner = v.replace(/^var\(/, '').replace(/\)\s*$/, '');
+            const token = inner.split(',')[0]?.trim() ?? '';
+            const m = token.match(STYLE_TOKEN_PREFIX_RE);
+            if (m && m[1] !== layoutType) {
+                push(diagnostics, {
+                    gate: 'contamination',
+                    message: `Block "${blockId}" style "${prop}" references foreign token "${token}" (layout "${m[1]}" vs "${layoutType}")`,
+                    path: `styles.blockStyleOverrides.${blockId}.${prop}`,
+                });
+            }
+        }
+    }
+}
+export function documentScopeKey(env) {
+    return `${env.storeId}:${env.layoutType}:${env.templateType}:${env.templateId}`;
+}

package/dist/editor/feature-flags.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Phased rollout for WordPress-style editor / split document persistence.
+ * Set `NEXT_PUBLIC_LAYOUT_EDITOR_V2_ROLLOUT` to a comma list of layout ids, or `*` for all.
+ * When unset, all layouts are treated as enabled (no behavior change for existing deploys).
+ */
+export declare function parseLayoutEditorV2Rollout(raw: string | undefined | null): {
+    all: boolean;
+    layouts: Set<string>;
+};
+export declare function isLayoutEditorV2EnabledForLayout(layoutType: string, envValue?: string | null): boolean;
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/editor/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../src/editor/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAKjH;AAED,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAMtG"}

package/dist/editor/feature-flags.js

@@ -0,0 +1,19 @@
+/**
+ * Phased rollout for WordPress-style editor / split document persistence.
+ * Set `NEXT_PUBLIC_LAYOUT_EDITOR_V2_ROLLOUT` to a comma list of layout ids, or `*` for all.
+ * When unset, all layouts are treated as enabled (no behavior change for existing deploys).
+ */
+export function parseLayoutEditorV2Rollout(raw) {
+    const s = raw?.trim();
+    if (!s)
+        return { all: true, layouts: new Set() };
+    if (s === '*')
+        return { all: true, layouts: new Set() };
+    return { all: false, layouts: new Set(s.split(',').map((x) => x.trim()).filter(Boolean)) };
+}
+export function isLayoutEditorV2EnabledForLayout(layoutType, envValue) {
+    const src = envValue ??
+        (typeof process !== 'undefined' ? process.env?.NEXT_PUBLIC_LAYOUT_EDITOR_V2_ROLLOUT : undefined);
+    const { all, layouts } = parseLayoutEditorV2Rollout(src);
+    return all || layouts.has(layoutType);
+}

package/dist/editor/index.d.ts

@@ -0,0 +1,28 @@
+import { LayoutInventory } from './types';
+export * from './types';
+export * from './document';
+export * from './shared';
+export * from './feature-flags';
+export * as PayazaForm from './payaza-form';
+export { PayazaFormEditorFullPage, PayazaFormEditor } from './payaza-form';
+export { getGlobalAssetSelectionHandler } from './payaza-form/AssetSelectionContext';
+export { loadLayoutContentForEditor, hasRenderableLayoutContent, } from './layout-content-loader';
+export { extractPublishedLayoutConfig } from '../lib/layout-config-hydration';
+export { normalizeLayoutConfigFieldShapes, prepareLayoutPayloadForPublish, denormalizeClothingMinimalBlocksToSectionFields, } from '../lib/layout-field-normalize';
+export { mergeAllPagesWithActualData } from './payaza-form/data-merger';
+export { loadLayoutJSONSync } from './payaza-form/layout-loader';
+/**
+ * Helper to get the full inventory of all layouts
+ * Now uses alignment-schemas instead of requirements JSON
+ */
+export declare const getFullInventory: () => LayoutInventory;
+/**
+ * Returns true when saving `incoming` would regress (remove significant
+ * merchant-customised content from) the `publishedBaseline`.
+ *
+ * A regression is detected when:
+ *  - The published baseline has custom sections but the incoming payload has none, OR
+ *  - The incoming section count is less than half of the published section count.
+ */
+export declare function isLayoutContentRegression(publishedBaseline: Record<string, unknown>, incoming: Record<string, unknown>): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAGhC,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EACL,gCAAgC,EAChC,8BAA8B,EAC9B,+CAA+C,GAChD,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,eAKnC,CAAC;AA4BF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAaT"}

package/dist/editor/index.js

@@ -0,0 +1,72 @@
+export * from './types.js';
+export * from './document/index.js';
+export * from './shared/index.js';
+export * from './feature-flags.js';
+// Export PayazaForm editor (namespace for consumers that destructure PayazaForm)
+export * as PayazaForm from './payaza-form/index.js';
+// Top-level named exports so consumers can also import directly:
+//   import { PayazaFormEditorFullPage, getFullInventory } from 'payaza-storefront-layouts/editor'
+export { PayazaFormEditorFullPage, PayazaFormEditor } from './payaza-form/index.js';
+// Also export asset selection handler directly for easier access
+export { getGlobalAssetSelectionHandler } from './payaza-form/AssetSelectionContext.js';
+export { loadLayoutContentForEditor, hasRenderableLayoutContent, } from './layout-content-loader.js';
+export { extractPublishedLayoutConfig } from '../lib/layout-config-hydration.js';
+export { normalizeLayoutConfigFieldShapes, prepareLayoutPayloadForPublish, denormalizeClothingMinimalBlocksToSectionFields, } from '../lib/layout-field-normalize.js';
+export { mergeAllPagesWithActualData } from './payaza-form/data-merger.js';
+export { loadLayoutJSONSync } from './payaza-form/layout-loader.js';
+/**
+ * Helper to get the full inventory of all layouts
+ * Now uses alignment-schemas instead of requirements JSON
+ */
+export const getFullInventory = () => {
+    return {
+        data: {},
+        requirements: {},
+    };
+};
+/**
+ * Counts the total number of sections in a layout payload.
+ * Handles both flat (sections[]) and page-keyed (pages[].sections) formats.
+ */
+function countLayoutSections(payload) {
+    if (Array.isArray(payload.sections))
+        return payload.sections.length;
+    if (payload.pages) {
+        const pages = Array.isArray(payload.pages)
+            ? payload.pages
+            : Object.values(payload.pages);
+        return pages.reduce((acc, page) => {
+            const p = page;
+            if (p && Array.isArray(p.sections))
+                return acc + p.sections.length;
+            return acc;
+        }, 0);
+    }
+    if (payload.home && typeof payload.home === 'object') {
+        const home = payload.home;
+        if (Array.isArray(home.sections))
+            return home.sections.length;
+    }
+    return 0;
+}
+/**
+ * Returns true when saving `incoming` would regress (remove significant
+ * merchant-customised content from) the `publishedBaseline`.
+ *
+ * A regression is detected when:
+ *  - The published baseline has custom sections but the incoming payload has none, OR
+ *  - The incoming section count is less than half of the published section count.
+ */
+export function isLayoutContentRegression(publishedBaseline, incoming) {
+    if (!publishedBaseline || !incoming)
+        return false;
+    const publishedCount = countLayoutSections(publishedBaseline);
+    const incomingCount = countLayoutSections(incoming);
+    // Baseline has substantial sections but incoming is empty — clear regression.
+    if (publishedCount > 3 && incomingCount === 0)
+        return true;
+    // Incoming has less than half the published sections — likely a regression.
+    if (publishedCount > 2 && incomingCount < publishedCount / 2)
+        return true;
+    return false;
+}

package/dist/editor/layout-content-loader.d.ts

@@ -0,0 +1,13 @@
+import { extractPublishedLayoutConfig, hydratePublishedLayoutPayload } from '../lib/layout-config-hydration';
+export { extractPublishedLayoutConfig, hydratePublishedLayoutPayload };
+/** True when config contains at least one renderable layout section/block. */
+export declare function hasRenderableLayoutContent(config: Record<string, unknown> | null | undefined): boolean;
+/**
+ * Hydrate persisted layout JSON for editor/storefront consumption.
+ * Prefers envelope round-trip when it yields renderable sections; otherwise falls back to compiledLegacyConfigJson.
+ */
+export declare function loadLayoutContentForEditor(content: unknown): {
+    config: Record<string, unknown> | null;
+    editorDocument: unknown;
+};
+//# sourceMappingURL=layout-content-loader.d.ts.map

package/dist/editor/layout-content-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-content-loader.d.ts","sourceRoot":"","sources":["../../src/editor/layout-content-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAE9B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,CAAC;AA8GvE,8EAA8E;AAC9E,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEtG;AAgBD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,cAAc,EAAE,OAAO,CAAC;CACzB,CAmHA"}

package/dist/editor/layout-content-loader.js

@@ -0,0 +1,222 @@
+import { envelopeToStoreConfig } from './document/adapter.js';
+import { validateEditorEnvelope } from './document/validate.js';
+import { extractPublishedLayoutConfig, hydratePublishedLayoutPayload, hasRenderableLayoutContent as hasRenderableLayoutContentFromHydration, } from '../lib/layout-config-hydration.js';
+export { extractPublishedLayoutConfig, hydratePublishedLayoutPayload };
+function isUnsplashDefaultUrl(url) {
+    return /images\.unsplash\.com|unsplash\.com/i.test(url);
+}
+function hasNonUnsplashImageUrls(value) {
+    let found = false;
+    const visit = (node, key) => {
+        if (found)
+            return;
+        if (typeof node === 'string') {
+            const k = (key ?? '').toLowerCase();
+            if (!k.includes('image'))
+                return;
+            if (!node)
+                return;
+            if (!node.startsWith('http'))
+                return;
+            if (isUnsplashDefaultUrl(node))
+                return;
+            found = true;
+            return;
+        }
+        if (Array.isArray(node)) {
+            for (const item of node)
+                visit(item, key);
+            return;
+        }
+        if (node && typeof node === 'object') {
+            for (const [k, v] of Object.entries(node)) {
+                visit(v, k);
+                if (found)
+                    return;
+            }
+        }
+    };
+    visit(value, undefined);
+    return found;
+}
+function extractLayoutConfigFromCompiledLegacy(compiledLegacy) {
+    if (!compiledLegacy || typeof compiledLegacy !== 'object')
+        return undefined;
+    if (compiledLegacy.layoutConfig && typeof compiledLegacy.layoutConfig === 'object') {
+        return compiledLegacy.layoutConfig;
+    }
+    // Some callers persist layoutConfig-like shapes directly.
+    if (compiledLegacy.sections ||
+        compiledLegacy.pages ||
+        compiledLegacy.home ||
+        compiledLegacy.assignedAssets ||
+        compiledLegacy.assignedText) {
+        return compiledLegacy;
+    }
+    return undefined;
+}
+function payloadHasRenderableBlocks(payload) {
+    const sections = payload.sections;
+    if (sections && typeof sections === 'object' && Object.keys(sections).length > 0) {
+        return true;
+    }
+    const pages = payload.pages;
+    if (pages && typeof pages === 'object' && Object.keys(pages).length > 0) {
+        return true;
+    }
+    const home = payload.home;
+    if (home && typeof home === 'object' && Object.keys(home).length > 0) {
+        return true;
+    }
+    const assignedAssets = payload.assignedAssets;
+    if (assignedAssets && typeof assignedAssets === 'object' && Object.keys(assignedAssets).length > 0) {
+        return true;
+    }
+    const assignedText = payload.assignedText;
+    if (assignedText && typeof assignedText === 'object' && Object.keys(assignedText).length > 0) {
+        return true;
+    }
+    return false;
+}
+function extractLayoutConfigPayload(config) {
+    if (!config || typeof config !== 'object')
+        return null;
+    const compiled = config._editor?.compiledLegacyConfigJson;
+    if (compiled && typeof compiled === 'object') {
+        const compiledRecord = compiled;
+        if (compiledRecord.layoutConfig && typeof compiledRecord.layoutConfig === 'object') {
+            return compiledRecord.layoutConfig;
+        }
+        if (compiledRecord.sections || compiledRecord.pages || compiledRecord.home) {
+            return compiledRecord;
+        }
+    }
+    if (config.layoutConfig && typeof config.layoutConfig === 'object') {
+        const lc = config.layoutConfig;
+        if (lc.sections || lc.pages || lc.home || lc.assignedAssets || lc.assignedText) {
+            return lc;
+        }
+    }
+    if (config.sections || config.pages || config.home || config.assignedAssets || config.assignedText) {
+        return config;
+    }
+    return null;
+}
+/** True when config contains at least one renderable layout section/block. */
+export function hasRenderableLayoutContent(config) {
+    return hasRenderableLayoutContentFromHydration(config);
+}
+function tryConfigFromEditorDocument(editorDocument) {
+    if (!editorDocument || typeof editorDocument !== 'object')
+        return null;
+    const validation = validateEditorEnvelope(editorDocument);
+    if (!validation.ok)
+        return null;
+    try {
+        return envelopeToStoreConfig(editorDocument);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Hydrate persisted layout JSON for editor/storefront consumption.
+ * Prefers envelope round-trip when it yields renderable sections; otherwise falls back to compiledLegacyConfigJson.
+ */
+export function loadLayoutContentForEditor(content) {
+    if (!content || typeof content !== 'object') {
+        return { config: null, editorDocument: null };
+    }
+    const record = content;
+    const editorMeta = record._editor;
+    const editorDocument = editorMeta?.editorDocument ?? null;
+    const fromEnvelope = editorDocument ? tryConfigFromEditorDocument(editorDocument) : null;
+    const hydratedLayoutConfig = hydratePublishedLayoutPayload(record);
+    if (hydratedLayoutConfig && payloadHasRenderableBlocks(hydratedLayoutConfig)) {
+        const identityBase = fromEnvelope ??
+            editorMeta?.compiledLegacyConfigJson ??
+            record;
+        return {
+            config: {
+                ...identityBase,
+                layoutConfig: hydratedLayoutConfig,
+                _editor: record._editor,
+            },
+            editorDocument,
+        };
+    }
+    // compiledLegacyConfigJson is the canonical merchant content — it was compiled
+    // directly from the editor's data state at save time and is always authoritative.
+    // Prefer it over the envelope round-trip for layoutConfig content, because the
+    // slim envelope can produce renderable-but-default sections (same section keys as
+    // the merchant's data, but with template-default values) that would silently
+    // override the merchant's real customizations.
+    //
+    // This mirrors the priority used by hydratePublishedLayoutPayload on the server:
+    //   compiledLegacyConfigJson (base) → envelope as overlay (regression-guarded).
+    // Identity/structural fields (id, slug, layout, type, name) are kept from
+    // fromEnvelope when available, since __store_snapshot__ is slimmed on save.
+    const compiledLegacy = editorMeta?.compiledLegacyConfigJson && typeof editorMeta.compiledLegacyConfigJson === 'object'
+        ? editorMeta.compiledLegacyConfigJson
+        : null;
+    if (compiledLegacy && hasRenderableLayoutContent(compiledLegacy)) {
+        const compiledLayoutConfig = extractLayoutConfigFromCompiledLegacy(compiledLegacy);
+        const base = fromEnvelope
+            ? { ...fromEnvelope }
+            : { ...compiledLegacy };
+        const merged = {
+            ...base,
+            _editor: record._editor,
+        };
+        if (compiledLayoutConfig) {
+            merged.layoutConfig = compiledLayoutConfig;
+        }
+        return { config: merged, editorDocument };
+    }
+    if (fromEnvelope && hasRenderableLayoutContent(fromEnvelope)) {
+        return {
+            config: {
+                ...fromEnvelope,
+                _editor: record._editor,
+            },
+            editorDocument,
+        };
+    }
+    const topLevelLayoutConfig = record.layoutConfig;
+    const topLevelHasSections = topLevelLayoutConfig &&
+        payloadHasRenderableBlocks(topLevelLayoutConfig);
+    if (editorMeta?.compiledLegacyConfigJson &&
+        typeof editorMeta.compiledLegacyConfigJson === 'object') {
+        const compiled = editorMeta.compiledLegacyConfigJson;
+        const compiledHasSections = hasRenderableLayoutContent(compiled);
+        if (compiledHasSections && (!fromEnvelope || !hasRenderableLayoutContent(fromEnvelope))) {
+            if (process.env.NODE_ENV !== 'production') {
+                console.info('[loadLayoutContentForEditor] Using compiledLegacyConfigJson — envelope round-trip lacked renderable sections.');
+            }
+            const merged = {
+                ...compiled,
+                _editor: record._editor,
+            };
+            if (topLevelHasSections && topLevelLayoutConfig) {
+                merged.layoutConfig = {
+                    ...(compiled.layoutConfig ?? {}),
+                    ...topLevelLayoutConfig,
+                };
+            }
+            return { config: merged, editorDocument };
+        }
+    }
+    if (fromEnvelope) {
+        return {
+            config: {
+                ...fromEnvelope,
+                _editor: record._editor,
+            },
+            editorDocument,
+        };
+    }
+    if (topLevelHasSections) {
+        return { config: record, editorDocument };
+    }
+    return { config: record, editorDocument };
+}

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

@@ -0,0 +1,20 @@
+import React from 'react';
+export type ActiveArrayFocus = {
+    sectionKey: string;
+    fieldKey: string;
+    index: number;
+} | null;
+export interface ActiveArrayFocusProviderProps {
+    sectionKey: string | null;
+    focus: ActiveArrayFocus;
+    onFocusChange: (next: ActiveArrayFocus) => void;
+    onBeforeIndexChange?: () => void;
+    children: React.ReactNode;
+}
+export declare function ActiveArrayFocusProvider({ sectionKey, focus, onFocusChange, onBeforeIndexChange, children, }: ActiveArrayFocusProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useActiveArrayFocus(sectionKey: string, fieldKey: string): {
+    activeIndex: number;
+    setActiveIndex: (index: number) => void;
+};
+export declare function useActiveArrayFocusState(): ActiveArrayFocus;
+//# sourceMappingURL=ActiveArrayFocusContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveArrayFocusContext.d.ts","sourceRoot":"","sources":["../../../src/editor/payaza-form/ActiveArrayFocusContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA0D,MAAM,OAAO,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAAC;AAYT,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,gBAAgB,CAAC;IACxB,aAAa,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChD,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,EACvC,UAAU,EACV,KAAK,EACL,aAAa,EACb,mBAAmB,EACnB,QAAQ,GACT,EAAE,6BAA6B,2CA6B/B;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CAUA;AAED,wBAAgB,wBAAwB,IAAI,gBAAgB,CAE3D"}

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

@@ -0,0 +1,31 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo } from 'react';
+const ActiveArrayFocusContext = createContext(null);
+export function ActiveArrayFocusProvider({ sectionKey, focus, onFocusChange, onBeforeIndexChange, children, }) {
+    const setActiveIndex = useCallback((sk, fieldKey, index) => {
+        onBeforeIndexChange?.();
+        onFocusChange({ sectionKey: sk, fieldKey, index: Math.max(0, index) });
+    }, [onFocusChange, onBeforeIndexChange]);
+    const clearFocus = useCallback(() => {
+        onFocusChange(null);
+    }, [onFocusChange]);
+    const getActiveIndex = useCallback((sk, fieldKey) => {
+        if (focus?.sectionKey === sk && focus.fieldKey === fieldKey)
+            return focus.index;
+        return 0;
+    }, [focus]);
+    const value = useMemo(() => ({ focus, setActiveIndex, clearFocus, getActiveIndex }), [focus, setActiveIndex, clearFocus, getActiveIndex]);
+    return (_jsx(ActiveArrayFocusContext.Provider, { value: value, children: children }));
+}
+export function useActiveArrayFocus(sectionKey, fieldKey) {
+    const ctx = useContext(ActiveArrayFocusContext);
+    const activeIndex = ctx?.getActiveIndex(sectionKey, fieldKey) ?? 0;
+    const setActiveIndex = useCallback((index) => {
+        ctx?.setActiveIndex(sectionKey, fieldKey, index);
+    }, [ctx, sectionKey, fieldKey]);
+    return { activeIndex, setActiveIndex };
+}
+export function useActiveArrayFocusState() {
+    return useContext(ActiveArrayFocusContext)?.focus ?? null;
+}