storefront-layouts-staging 1.0.0-staging.0

package/dist/editor/blocks/migrate-clothing-minimal.js

@@ -0,0 +1,140 @@
+import { deepClone } from '../../lib/utils/index.js';
+import { hasClothingMinimalMerchantSectionSignal } from '../../lib/layout-field-normalize.js';
+import { defaultClothingMinimalAboutBlocks, defaultClothingMinimalCategoriesBlocks, defaultClothingMinimalFeaturedProductsBlocks, defaultClothingMinimalFeaturesBlocks, defaultClothingMinimalHeroBlocks, defaultClothingMinimalPromoBlocks, getDefaultBlocksForClothingMinimalHomeSection, } from './defaults/clothing-minimal-home.js';
+function richOrString(v) {
+    if (v == null)
+        return '';
+    if (typeof v === 'string')
+        return v;
+    if (typeof v === 'object' && 'sanitizedHtml' in v) {
+        return String(v.sanitizedHtml ?? '');
+    }
+    return String(v);
+}
+/** When section has legacy flat keys but no `blocks`, build a block tree and merge. */
+export function migrateClothingMinimalHomeSectionToBlocks(sectionKey, section) {
+    if (!section || typeof section !== 'object') {
+        return getDefaultBlocksForClothingMinimalHomeSection(sectionKey) ?? [];
+    }
+    if (Array.isArray(section.blocks) && section.blocks.length > 0) {
+        return deepClone(section.blocks);
+    }
+    // Preserve in-progress edits: empty blocks array with flat merchant fields must not reset to template defaults.
+    if (Array.isArray(section.blocks) &&
+        section.blocks.length === 0 &&
+        hasClothingMinimalMerchantSectionSignal(sectionKey, section)) {
+        return migrateClothingMinimalHomeSectionToBlocks(sectionKey, {
+            ...section,
+            blocks: undefined,
+        });
+    }
+    if (!hasClothingMinimalMerchantSectionSignal(sectionKey, section)) {
+        return getDefaultBlocksForClothingMinimalHomeSection(sectionKey) ?? [];
+    }
+    switch (sectionKey) {
+        case 'hero': {
+            const badge = richOrString(section.badge);
+            const title = richOrString(section.title);
+            const subtitle = richOrString(section.subtitle);
+            const cta = richOrString(section.primaryCTA);
+            const imageUrl = typeof section.image === 'string'
+                ? section.image
+                : typeof section.hero_main === 'string'
+                    ? section.hero_main
+                    : '';
+            const base = defaultClothingMinimalHeroBlocks();
+            const left = base[0];
+            const right = base[1];
+            if (left?.innerBlocks?.[0]) {
+                left.innerBlocks[0].attributes.text = badge || 'New Collection 2024';
+            }
+            if (left?.innerBlocks?.[1]) {
+                left.innerBlocks[1].attributes.content =
+                    title || 'Simplicity is the ultimate sophistication.';
+            }
+            if (left?.innerBlocks?.[2]) {
+                left.innerBlocks[2].attributes.content = subtitle;
+            }
+            if (left?.innerBlocks?.[3]) {
+                left.innerBlocks[3].attributes.text = cta || 'Shop Collection';
+            }
+            const heroImg = right?.innerBlocks?.[0];
+            if (heroImg && imageUrl) {
+                heroImg.attributes.url = imageUrl;
+            }
+            return base;
+        }
+        case 'features': {
+            const items = section.items;
+            if (Array.isArray(items) && items.length > 0) {
+                return items.map((it) => ({
+                    name: 'payaza/feature-item',
+                    attributes: {
+                        icon: it.icon || 'Circle',
+                        title: richOrString(it.title),
+                        description: richOrString(it.description),
+                    },
+                }));
+            }
+            return defaultClothingMinimalFeaturesBlocks();
+        }
+        case 'categories': {
+            const base = defaultClothingMinimalCategoriesBlocks();
+            const h = base[0];
+            const b = base[1];
+            if (h)
+                h.attributes.content = richOrString(section.title) || 'Categories';
+            if (b)
+                b.attributes.text = richOrString(section.viewAllLabel) || 'View All';
+            return base;
+        }
+        case 'featuredProducts': {
+            const base = defaultClothingMinimalFeaturedProductsBlocks();
+            if (base[0]) {
+                base[0].attributes.content =
+                    richOrString(section.title) || 'The Essentials';
+            }
+            if (base[1]) {
+                base[1].attributes.content = richOrString(section.subtitle);
+            }
+            return base;
+        }
+        case 'about': {
+            const base = defaultClothingMinimalAboutBlocks();
+            const copy = base[1];
+            const h = copy?.innerBlocks?.[0];
+            const p = copy?.innerBlocks?.[1];
+            if (h)
+                h.attributes.content = richOrString(section.title);
+            if (p)
+                p.attributes.content = richOrString(section.description);
+            return base;
+        }
+        case 'promoBanner': {
+            const base = defaultClothingMinimalPromoBlocks();
+            if (base[0]) {
+                base[0].attributes.content =
+                    richOrString(section.text) || '<p>Free shipping on orders over $200</p>';
+            }
+            const link = typeof section.link === 'string' ? section.link : '/products';
+            if (base[1])
+                base[1].attributes.url = link;
+            return base;
+        }
+        default:
+            return getDefaultBlocksForClothingMinimalHomeSection(sectionKey) ?? [];
+    }
+}
+export function ensureClothingMinimalHomeBlocksInPageData(layoutId, pageId, pageData) {
+    if (layoutId !== 'clothing-minimal' || pageId !== 'home')
+        return pageData;
+    const blockSections = ['hero', 'features', 'categories', 'featuredProducts', 'about', 'promoBanner'];
+    const next = { ...pageData };
+    for (const key of blockSections) {
+        const raw = next[key];
+        const section = (raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {});
+        const blocks = migrateClothingMinimalHomeSectionToBlocks(key, section);
+        next[key] = { ...section, blocks };
+    }
+    return next;
+}

package/dist/editor/blocks/nav-outline-utils.d.ts

@@ -0,0 +1,47 @@
+import type { PayazaSerializedBlock } from './types';
+/** One node in nested blocks JSON under a section `blocks[]` tree */
+export type OutlineBlockTreeNode = {
+    id: string;
+    /** Path from section payload root to this block object (excluding `attributes` leaves). */
+    blockPathInSection: string[];
+    label: string;
+    typeId: string;
+    children: OutlineBlockTreeNode[];
+    /** Whether the block is visible (attributes.show !== false). */
+    visible: boolean;
+};
+/**
+ * Recursive outline tree preserving innerBlocks nesting.
+ * `blocksArrayPathFromSection` defaults to ['blocks'] (top-level serialized roots).
+ */
+export declare function buildPayazaBlocksOutlineTree(sectionKey: string, blocks: PayazaSerializedBlock[] | undefined | null, blocksArrayPathFromSection?: string[]): OutlineBlockTreeNode[];
+/** Outlines serialized blocks for a section if `payload.blocks[]` exists. */
+export declare function outlineTreeForSectionPayload(sectionKey: string, sectionPayload: Record<string, unknown> | undefined | null): OutlineBlockTreeNode[] | undefined;
+/**
+ * Generates synthetic outline nodes for top-level array fields in a section payload.
+ * Used when the section does not contain serialized Payaza blocks but has named arrays
+ * (e.g. `sliders`, `items`, `steps`). Each array item becomes a navigable outline row.
+ */
+export declare function outlineTreeForArrayPayload(sectionKey: string, sectionPayload: Record<string, unknown> | undefined | null): OutlineBlockTreeNode[] | undefined;
+/**
+ * True when the granular inspector path targets this block or one of its attribute fields,
+ * matching how canvas bindings use `…|attributes|<key>` paths (not deeper innerBlocks sibling paths).
+ */
+export declare function isGranularPathUnderBlock(granularPath: string[], blockPathInSection: string[]): boolean;
+/**
+ * First editable scalar on a section array item (e.g. hero.sliders[1]).
+ */
+export declare function granularPathForArrayItem(sectionPayload: Record<string, unknown> | undefined | null, blockPathInSection: string[]): {
+    path: string[];
+    elementKind: 'plainText' | 'richHtml' | 'image';
+} | null;
+export declare function granularPathForBlockFirstAttr(sectionPayload: Record<string, unknown> | undefined | null, blockPathInSection: string[]): {
+    path: string[];
+    elementKind: 'plainText' | 'richHtml' | 'image';
+} | null;
+/** @deprecated Use `buildPayazaBlocksOutlineTree` + `BlockOutlineTree` for hierarchical UI */
+export declare function flattenSerializedBlocksOutline(blocks: PayazaSerializedBlock[] | undefined, prefix: string): {
+    id: string;
+    label: string;
+}[];
+//# sourceMappingURL=nav-outline-utils.d.ts.map

package/dist/editor/blocks/nav-outline-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-outline-utils.d.ts","sourceRoot":"","sources":["../../../src/editor/blocks/nav-outline-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAerD,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,2FAA2F;IAC3F,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,qBAAqB,EAAE,GAAG,SAAS,GAAG,IAAI,EAClD,0BAA0B,GAAE,MAAM,EAAe,GAChD,oBAAoB,EAAE,CAwBxB;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACzD,oBAAoB,EAAE,GAAG,SAAS,CASpC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACzD,oBAAoB,EAAE,GAAG,SAAS,CAiDpC;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EAAE,EACtB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,OAAO,CAiBT;AAcD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EAC1D,kBAAkB,EAAE,MAAM,EAAE,GAC3B;IACD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;CACjD,GAAG,IAAI,CAgBP;AAED,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EAC1D,kBAAkB,EAAE,MAAM,EAAE,GAC3B;IACD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;CACjD,GAAG,IAAI,CAkBP;AAED,8FAA8F;AAC9F,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,qBAAqB,EAAE,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,GACb;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAgBjC"}

package/dist/editor/blocks/nav-outline-utils.js

@@ -0,0 +1,201 @@
+import { getPayazaBlockDefinition } from './registry.js';
+import { readDataAtPath } from '../payaza-form/data-transformer.js';
+const ARRAY_FIELD_KEY_SET = new Set([
+    'sliders',
+    'items',
+    'steps',
+    'features',
+    'testimonials',
+    'cards',
+    'services',
+    'benefits',
+]);
+/**
+ * Recursive outline tree preserving innerBlocks nesting.
+ * `blocksArrayPathFromSection` defaults to ['blocks'] (top-level serialized roots).
+ */
+export function buildPayazaBlocksOutlineTree(sectionKey, blocks, blocksArrayPathFromSection = ['blocks']) {
+    if (!blocks?.length)
+        return [];
+    return blocks.map((b, idx) => {
+        const blockPathInSection = [...blocksArrayPathFromSection, String(idx)];
+        const def = getPayazaBlockDefinition(b.name);
+        const label = def?.label ?? String(b.name);
+        const id = `${sectionKey}::_blk::${blockPathInSection.join('-')}`;
+        const inner = b.innerBlocks?.length
+            ? buildPayazaBlocksOutlineTree(sectionKey, b.innerBlocks, [
+                ...blockPathInSection,
+                'innerBlocks',
+            ])
+            : [];
+        const attrs = b.attributes;
+        const visible = attrs?.show !== false;
+        return {
+            id,
+            blockPathInSection,
+            label,
+            typeId: String(b.name),
+            children: inner,
+            visible,
+        };
+    });
+}
+/** Outlines serialized blocks for a section if `payload.blocks[]` exists. */
+export function outlineTreeForSectionPayload(sectionKey, sectionPayload) {
+    const blocks = sectionPayload?.blocks;
+    if (!Array.isArray(blocks) || blocks.length === 0) {
+        // No Payaza blocks — emit synthetic nodes for top-level array fields (e.g. sliders[]
+        // in Fashion Hub / Food / Electronics). This gives the List View outline entries for
+        // non-block-first templates so merchants can navigate their hero slides, benefit items, etc.
+        return outlineTreeForArrayPayload(sectionKey, sectionPayload);
+    }
+    return buildPayazaBlocksOutlineTree(sectionKey, blocks);
+}
+/**
+ * Generates synthetic outline nodes for top-level array fields in a section payload.
+ * Used when the section does not contain serialized Payaza blocks but has named arrays
+ * (e.g. `sliders`, `items`, `steps`). Each array item becomes a navigable outline row.
+ */
+export function outlineTreeForArrayPayload(sectionKey, sectionPayload) {
+    if (!sectionPayload || typeof sectionPayload !== 'object')
+        return undefined;
+    // Well-known array field names that represent repeating items worth outlining.
+    const ARRAY_FIELD_KEYS = [
+        'sliders',
+        'items',
+        'steps',
+        'features',
+        'testimonials',
+        'cards',
+        'services',
+        'benefits',
+    ];
+    const nodes = [];
+    for (const fieldKey of ARRAY_FIELD_KEYS) {
+        const arr = sectionPayload[fieldKey];
+        if (!Array.isArray(arr) || arr.length === 0)
+            continue;
+        const children = arr.map((item, idx) => {
+            const itemLabel = item?.title ||
+                item?.badge ||
+                item?.name ||
+                item?.heading ||
+                `${capitalize(fieldKey).replace(/s$/, '')} ${idx + 1}`;
+            return {
+                id: `${sectionKey}::_arr::${fieldKey}-${idx}`,
+                blockPathInSection: [fieldKey, String(idx)],
+                label: String(itemLabel),
+                typeId: `array-item:${fieldKey}`,
+                children: [],
+                visible: item?.show !== false,
+            };
+        });
+        nodes.push({
+            id: `${sectionKey}::_arr::${fieldKey}`,
+            blockPathInSection: [fieldKey],
+            label: capitalize(fieldKey),
+            typeId: `array:${fieldKey}`,
+            children,
+            visible: true,
+        });
+    }
+    return nodes.length > 0 ? nodes : undefined;
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/**
+ * True when the granular inspector path targets this block or one of its attribute fields,
+ * matching how canvas bindings use `…|attributes|<key>` paths (not deeper innerBlocks sibling paths).
+ */
+export function isGranularPathUnderBlock(granularPath, blockPathInSection) {
+    if (!granularPath?.length || granularPath.length < blockPathInSection.length)
+        return false;
+    for (let i = 0; i < blockPathInSection.length; i++) {
+        if (granularPath[i] !== blockPathInSection[i])
+            return false;
+    }
+    const rest = granularPath.slice(blockPathInSection.length);
+    if (rest.length === 0)
+        return false;
+    if (rest.length >= 2 && rest[0] === 'attributes')
+        return true;
+    // Section array items: sliders → 0 → title
+    if (blockPathInSection.length >= 2 &&
+        ARRAY_FIELD_KEY_SET.has(blockPathInSection[0]) &&
+        /^\d+$/.test(blockPathInSection[1] ?? '')) {
+        return rest.length >= 1;
+    }
+    return false;
+}
+const ARRAY_ITEM_SCALAR_KEYS = [
+    'title',
+    'badge',
+    'description',
+    'highlight',
+    'name',
+    'heading',
+    'text',
+    'image',
+    'label',
+];
+/**
+ * First editable scalar on a section array item (e.g. hero.sliders[1]).
+ */
+export function granularPathForArrayItem(sectionPayload, blockPathInSection) {
+    if (blockPathInSection.length < 2)
+        return null;
+    const item = readDataAtPath(sectionPayload, blockPathInSection);
+    if (!item || typeof item !== 'object' || Array.isArray(item))
+        return null;
+    const record = item;
+    for (const key of ARRAY_ITEM_SCALAR_KEYS) {
+        if (!(key in record))
+            continue;
+        const elementKind = key === 'image' ? 'image' : 'plainText';
+        return {
+            path: [...blockPathInSection, key],
+            elementKind,
+        };
+    }
+    return null;
+}
+export function granularPathForBlockFirstAttr(sectionPayload, blockPathInSection) {
+    const block = readDataAtPath(sectionPayload, blockPathInSection);
+    if (!block || typeof block !== 'object')
+        return null;
+    const name = block.name;
+    if (typeof name !== 'string')
+        return null;
+    const def = getPayazaBlockDefinition(name);
+    const f = def?.attrFields?.[0];
+    if (!f)
+        return null;
+    const elementKind = f.editor === 'image'
+        ? 'image'
+        : (f.editor === 'text' || f.editor === 'multiline_text') && f._inlineRichText
+            ? 'richHtml'
+            : 'plainText';
+    return {
+        path: [...blockPathInSection, 'attributes', f.key],
+        elementKind,
+    };
+}
+/** @deprecated Use `buildPayazaBlocksOutlineTree` + `BlockOutlineTree` for hierarchical UI */
+export function flattenSerializedBlocksOutline(blocks, prefix) {
+    const rows = [];
+    if (!blocks?.length)
+        return rows;
+    const walk = (arr, path) => {
+        arr.forEach((b, i) => {
+            const p = [...path, i];
+            const id = `${prefix}::_blk::${p.join('-')}`;
+            const lbl = getPayazaBlockDefinition(b.name)?.label ?? String(b.name);
+            rows.push({ id, label: `· ${lbl}` });
+            if (b.innerBlocks?.length)
+                walk(b.innerBlocks, p);
+        });
+    };
+    walk(blocks, []);
+    return rows;
+}

package/dist/editor/blocks/registry.d.ts

@@ -0,0 +1,19 @@
+import type { PayazaBlockName, PayazaSerializedBlock } from './types';
+export type BlockAttrFieldMeta = {
+    key: string;
+    label: string;
+    editor: 'text' | 'multiline_text' | 'image' | 'number' | 'toggle' | 'icon';
+    _inlineRichText?: boolean;
+};
+export type PayazaBlockDefinition = {
+    name: PayazaBlockName;
+    label: string;
+    /** Attribute keys we edit in inspector (excluding innerBlocks composition for groups). */
+    attrFields?: BlockAttrFieldMeta[];
+    defaultAttributes: Record<string, unknown>;
+};
+export declare function getPayazaBlockDefinition(name: string): PayazaBlockDefinition | null;
+export declare function listPayazaBlockDefinitions(): PayazaBlockDefinition[];
+export declare function createPayazaEmptyBlock(name: PayazaBlockName): PayazaSerializedBlock;
+export declare function cloneBlockTree(block: PayazaSerializedBlock): PayazaSerializedBlock;
+//# sourceMappingURL=registry.d.ts.map

package/dist/editor/blocks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/editor/blocks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC;AA2FF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAEnF;AAED,wBAAgB,0BAA0B,IAAI,qBAAqB,EAAE,CAEpE;AAYD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,qBAAqB,CAQnF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB,CAElF"}

package/dist/editor/blocks/registry.js

@@ -0,0 +1,118 @@
+import { deepClone } from '../../lib/utils/index.js';
+const defs = {
+    'payaza/badge': {
+        name: 'payaza/badge',
+        label: 'Badge',
+        attrFields: [{ key: 'text', label: 'Text', editor: 'text', _inlineRichText: true }],
+        defaultAttributes: { text: 'New Collection' },
+    },
+    'payaza/heading': {
+        name: 'payaza/heading',
+        label: 'Heading',
+        attrFields: [
+            { key: 'content', label: 'Heading', editor: 'text', _inlineRichText: true },
+            { key: 'level', label: 'Level', editor: 'number' },
+        ],
+        defaultAttributes: { level: 1, content: 'Headline', align: 'left' },
+    },
+    'payaza/paragraph': {
+        name: 'payaza/paragraph',
+        label: 'Paragraph',
+        attrFields: [{ key: 'content', label: 'Text', editor: 'multiline_text', _inlineRichText: true }],
+        defaultAttributes: { content: '' },
+    },
+    'payaza/image': {
+        name: 'payaza/image',
+        label: 'Image',
+        attrFields: [
+            { key: 'url', label: 'Image URL', editor: 'image' },
+            { key: 'alt', label: 'Alt text', editor: 'text' },
+        ],
+        defaultAttributes: {
+            url: '',
+            alt: '',
+        },
+    },
+    'payaza/button': {
+        name: 'payaza/button',
+        label: 'Button',
+        attrFields: [
+            { key: 'text', label: 'Label', editor: 'text', _inlineRichText: true },
+            { key: 'url', label: 'URL', editor: 'text' },
+        ],
+        defaultAttributes: { text: 'Shop', url: '/products' },
+    },
+    'payaza/spacer': {
+        name: 'payaza/spacer',
+        label: 'Spacer',
+        attrFields: [{ key: 'height', label: 'Height (px)', editor: 'number' }],
+        defaultAttributes: { height: 16 },
+    },
+    'payaza/group': {
+        name: 'payaza/group',
+        label: 'Group',
+        attrFields: [{ key: 'variant', label: 'Layout variant', editor: 'text' }],
+        defaultAttributes: { variant: '' },
+    },
+    'payaza/feature-item': {
+        name: 'payaza/feature-item',
+        label: 'Feature',
+        attrFields: [
+            { key: 'icon', label: 'Icon', editor: 'icon' },
+            { key: 'title', label: 'Title', editor: 'text', _inlineRichText: true },
+            { key: 'description', label: 'Description', editor: 'text', _inlineRichText: true },
+        ],
+        defaultAttributes: {
+            icon: 'Truck',
+            title: 'Feature',
+            description: '',
+        },
+    },
+    'payaza/hotspot': {
+        name: 'payaza/hotspot',
+        label: 'Hotspot',
+        attrFields: [
+            { key: 'topPct', label: 'Top %', editor: 'number' },
+            { key: 'leftPct', label: 'Left %', editor: 'number' },
+            { key: 'productName', label: 'Label', editor: 'text', _inlineRichText: true },
+            { key: 'productPrice', label: 'Price', editor: 'text' },
+            { key: 'align', label: 'Tooltip align', editor: 'text' },
+        ],
+        defaultAttributes: {
+            topPct: 30,
+            leftPct: 45,
+            productName: 'Product',
+            productPrice: '$0',
+            align: 'left',
+        },
+    },
+};
+export function getPayazaBlockDefinition(name) {
+    return defs[name] || null;
+}
+export function listPayazaBlockDefinitions() {
+    return Object.values(defs).filter(Boolean);
+}
+function newClientId() {
+    try {
+        const c = globalThis;
+        if (c.crypto?.randomUUID)
+            return `payaza-${c.crypto.randomUUID()}`;
+    }
+    catch {
+        /* ignore */
+    }
+    return `payaza-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 9)}`;
+}
+export function createPayazaEmptyBlock(name) {
+    const def = defs[name];
+    return {
+        clientId: newClientId(),
+        name,
+        attributes: deepClone(def?.defaultAttributes ?? {}),
+        innerBlocks: name === 'payaza/group' ? [] : undefined,
+    };
+}
+export function cloneBlockTree(block) {
+    return deepClone(block);
+}

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

@@ -0,0 +1,14 @@
+/**
+ * Payaza content blocks — WordPress-inspired nested JSON stored under each section `blocks[]`.
+ */
+export type PayazaBlockName = 'payaza/badge' | 'payaza/heading' | 'payaza/paragraph' | 'payaza/image' | 'payaza/button' | 'payaza/spacer' | 'payaza/group' | 'payaza/feature-item' | 'payaza/hotspot';
+/** Nested block saved in layout JSON (Gutenberg-ish). */
+export interface PayazaSerializedBlock {
+    /** Optional stable client id */
+    clientId?: string;
+    name: PayazaBlockName | string;
+    attributes?: Record<string, unknown>;
+    innerBlocks?: PayazaSerializedBlock[];
+}
+export declare const PAYAZA_BLOCK_IDS: PayazaBlockName[];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/editor/blocks/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,eAAe,GACf,cAAc,GACd,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,yDAAyD;AACzD,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAU7C,CAAC"}

package/dist/editor/blocks/types.js

@@ -0,0 +1,14 @@
+/**
+ * Payaza content blocks — WordPress-inspired nested JSON stored under each section `blocks[]`.
+ */
+export const PAYAZA_BLOCK_IDS = [
+    'payaza/badge',
+    'payaza/heading',
+    'payaza/paragraph',
+    'payaza/image',
+    'payaza/button',
+    'payaza/spacer',
+    'payaza/group',
+    'payaza/feature-item',
+    'payaza/hotspot',
+];

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

@@ -0,0 +1,44 @@
+import type { StoreConfig } from '../../lib/store-types';
+import type { StoreLayoutType } from '../../lib/store-types';
+import type { OverlayLayoutJSON } from '../payaza-form/engine';
+import type { EditorDocumentEnvelope, ValidationDiagnostic } from './types';
+/**
+ * Round-trip bridge: current runtime is StoreConfig. Block tree is placeholder until full migration.
+ */
+export declare function storeConfigToEnvelope(config: StoreConfig, options: {
+    layoutType: StoreLayoutType;
+    templateType?: EditorDocumentEnvelope['templateType'];
+    templateId?: string;
+    layoutVersion?: number;
+}, overlayLayout?: OverlayLayoutJSON | null): EditorDocumentEnvelope;
+export declare function envelopeToStoreConfig(envelope: EditorDocumentEnvelope): StoreConfig;
+/**
+ * Deterministic JSON stringify for regression compares (sorted keys).
+ */
+export declare function stableStringify(value: unknown): string;
+export interface EditorPersistencePayload {
+    editorDocument: EditorDocumentEnvelope;
+    templateJson: EditorDocumentEnvelope['template'];
+    contentJson: EditorDocumentEnvelope['content'];
+    stylesJson: EditorDocumentEnvelope['styles'];
+    /** Runtime `StoreConfig` for storefront-app / LayoutPreview (legacy contract). */
+    compiledLegacyConfigJson: StoreConfig;
+}
+export interface CompileEditorDocumentResult {
+    ok: boolean;
+    diagnostics: ValidationDiagnostic[];
+    legacyConfig: StoreConfig | null;
+    persistence: EditorPersistencePayload | null;
+}
+/**
+ * Prefer the live editor StoreConfig for layoutConfig while keeping envelope-derived identity fields.
+ * Prevents stale section:* entries from resetting cross-page heroes during save/publish compile.
+ */
+export declare function mergeAuthoritativeStoreConfig(compiled: StoreConfig, authoritative: StoreConfig): StoreConfig;
+/**
+ * Validates the envelope, derives legacy runtime config, and builds split persistence blobs + compiled cache.
+ */
+export declare function compileEditorDocument(envelope: EditorDocumentEnvelope, options?: {
+    authoritativeStoreConfig?: StoreConfig;
+}): CompileEditorDocumentResult;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/editor/document/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,sBAAsB,EAAoB,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAgC9F;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE;IACP,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,EACD,aAAa,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACvC,sBAAsB,CA4CxB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,WAAW,CAgBnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAetD;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,sBAAsB,CAAC;IACvC,YAAY,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACjD,WAAW,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC/C,UAAU,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC7C,kFAAkF;IAClF,wBAAwB,EAAE,WAAW,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,WAAW,GACzB,WAAW,CAUb;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,sBAAsB,EAChC,OAAO,CAAC,EAAE;IAAE,wBAAwB,CAAC,EAAE,WAAW,CAAA;CAAE,GACnD,2BAA2B,CAoC7B"}