@shoppexio/builder-contracts 0.1.0 → 0.1.2

package/dist/builder-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-settings.d.ts","sourceRoot":"","sources":["../src/builder-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,YAAY,aAAoD,CAAC;AAC9E,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,qBAAqB,aAAoB,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe,aAAoD,CAAC;AACjF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBASrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIlB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAelB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,WAAW;;;;;mBAQV,CAAC;AACf,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAEpE"}
+{"version":3,"file":"builder-settings.d.ts","sourceRoot":"","sources":["../src/builder-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,YAAY,aAAoD,CAAC;AAC9E,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,qBAAqB,aAAoB,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe,aAAoD,CAAC;AACjF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,mBAAmB;;;;;;;kBASrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;kBAIlB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB,aAAmD,CAAC;AACrF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;kBAelB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,WAAW;;;;;mBAQV,CAAC;AACf,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAEpE"}

package/dist/builder-settings.js

@@ -19,11 +19,12 @@ export const PageLayoutSchema = z
     blocks: z.array(BlockInstanceSchema).default([]),
 })
     .strict();
+export const CustomPageSlugSchema = z.string().min(1).regex(/^[a-z0-9][a-z0-9-_]*$/);
 export const CustomPageSchema = z
     .object({
     id: PageIdSchema,
     title: z.string().min(1),
-    slug: z.string().min(1).regex(/^[a-z0-9][a-z0-9-_/]*$/),
+    slug: CustomPageSlugSchema,
     visible: z.boolean().default(true),
     layout: PageLayoutSchema.default({ blocks: [] }),
     seo: z

package/dist/canonical-settings.d.ts

@@ -0,0 +1,18 @@
+import type { BuilderSettings } from './builder-settings.ts';
+import type { ThemeManifest } from './theme-manifest.ts';
+export type BuilderSettingsCanonicalizationConflict = {
+    pageId: string;
+    blockId: string;
+    blockType: string;
+    alias: string;
+    canonicalPath: string;
+};
+export type BuilderSettingsCanonicalizationResult = {
+    settings: BuilderSettings;
+    migratedAliases: number;
+    removedAliases: number;
+    conflicts: BuilderSettingsCanonicalizationConflict[];
+};
+export declare function canonicalizeBuilderSettingsForManifest(settings: BuilderSettings, manifest: ThemeManifest): BuilderSettings;
+export declare function canonicalizeBuilderSettingsForManifestWithReport(settings: BuilderSettings, manifest: ThemeManifest): BuilderSettingsCanonicalizationResult;
+//# sourceMappingURL=canonical-settings.d.ts.map

package/dist/canonical-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-settings.d.ts","sourceRoot":"","sources":["../src/canonical-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,uCAAuC,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,uCAAuC,EAAE,CAAC;CACtD,CAAC;AAEF,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,eAAe,CAEjB;AAED,wBAAgB,gDAAgD,CAC9D,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,qCAAqC,CAwBvC"}

package/dist/canonical-settings.js

@@ -0,0 +1,106 @@
+import { sanitizeBuilderSettingsState } from "./persistence.js";
+export function canonicalizeBuilderSettingsForManifest(settings, manifest) {
+    return canonicalizeBuilderSettingsForManifestWithReport(settings, manifest).settings;
+}
+export function canonicalizeBuilderSettingsForManifestWithReport(settings, manifest) {
+    const next = sanitizeBuilderSettingsState(cloneBuilderSettings(settings));
+    const conflicts = [];
+    let migratedAliases = 0;
+    let removedAliases = 0;
+    for (const [pageId, layout] of Object.entries(next.theme.layout)) {
+        for (const block of layout.blocks) {
+            const blockDefinition = manifest.blocks[block.type];
+            if (!blockDefinition)
+                continue;
+            const result = canonicalizeBlockSettings(pageId, block, Object.keys(blockDefinition.settings));
+            migratedAliases += result.migratedAliases;
+            removedAliases += result.removedAliases;
+            conflicts.push(...result.conflicts);
+        }
+    }
+    return {
+        settings: next,
+        migratedAliases,
+        removedAliases,
+        conflicts,
+    };
+}
+function canonicalizeBlockSettings(pageId, block, settingPaths) {
+    const aliases = buildAliasMap(block.type, settingPaths);
+    const conflicts = [];
+    let migratedAliases = 0;
+    let removedAliases = 0;
+    for (const [alias, canonicalPaths] of aliases.entries()) {
+        if (!Object.prototype.hasOwnProperty.call(block.settings, alias)) {
+            continue;
+        }
+        const aliasValue = block.settings[alias];
+        if (canonicalPaths.length === 1) {
+            const canonicalPath = canonicalPaths[0];
+            if (!Object.prototype.hasOwnProperty.call(block.settings, canonicalPath)) {
+                block.settings[canonicalPath] = aliasValue;
+                migratedAliases += 1;
+            }
+            else if (!isJsonEqual(block.settings[canonicalPath], aliasValue)) {
+                conflicts.push({
+                    pageId,
+                    blockId: block.id,
+                    blockType: block.type,
+                    alias,
+                    canonicalPath,
+                });
+            }
+            delete block.settings[alias];
+            removedAliases += 1;
+            continue;
+        }
+        const everyCanonicalExists = canonicalPaths.every((canonicalPath) => Object.prototype.hasOwnProperty.call(block.settings, canonicalPath));
+        if (everyCanonicalExists) {
+            delete block.settings[alias];
+            removedAliases += 1;
+        }
+    }
+    return {
+        migratedAliases,
+        removedAliases,
+        conflicts,
+    };
+}
+function buildAliasMap(blockType, settingPaths) {
+    const aliases = new Map();
+    const canonicalPaths = new Set(settingPaths);
+    for (const canonicalPath of settingPaths) {
+        for (const alias of getLegacyAliases(blockType, canonicalPath)) {
+            if (alias === canonicalPath || canonicalPaths.has(alias))
+                continue;
+            const canonicalAliases = aliases.get(alias) ?? new Set();
+            canonicalAliases.add(canonicalPath);
+            aliases.set(alias, canonicalAliases);
+        }
+    }
+    return new Map(Array.from(aliases.entries()).map(([alias, paths]) => [alias, Array.from(paths).sort()]));
+}
+function getLegacyAliases(blockType, canonicalPath) {
+    const aliases = new Set();
+    const shortKey = getShortSettingKey(canonicalPath);
+    if (shortKey && shortKey !== canonicalPath) {
+        aliases.add(shortKey);
+    }
+    if (!canonicalPath.includes('.')) {
+        aliases.add(`${blockType}.${canonicalPath}`);
+    }
+    return Array.from(aliases);
+}
+function getShortSettingKey(path) {
+    const parts = path.split('.').filter(Boolean);
+    return parts.at(-1) ?? path;
+}
+function cloneBuilderSettings(settings) {
+    if (typeof structuredClone === 'function') {
+        return structuredClone(settings);
+    }
+    return JSON.parse(JSON.stringify(settings));
+}
+function isJsonEqual(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}

package/dist/custom-pages.d.ts

@@ -0,0 +1,15 @@
+import type { BuilderSettings } from './builder-settings.ts';
+import type { ManifestPage, ThemeManifest } from './theme-manifest.ts';
+/**
+ * Allowed embed/content blocks on merchant custom pages (`theme.pages[]`).
+ * Keep aligned with `customPageAllowedBlocks` in
+ * `config/builder-shared-manifest-blocks.json`.
+ */
+export declare const MERCHANT_CUSTOM_PAGE_ALLOWED_BLOCKS: readonly ["custom-html", "youtube-embed", "text-block"];
+export type MerchantCustomPageAllowedBlock = (typeof MERCHANT_CUSTOM_PAGE_ALLOWED_BLOCKS)[number];
+export declare function resolveMerchantCustomPageAllowedBlocks(manifest: ThemeManifest): string[];
+export declare function buildMerchantCustomPageManifestEntry(customPage: BuilderSettings['theme']['pages'][number], manifest: ThemeManifest): ManifestPage;
+export declare function mergeCustomPagesIntoManifest(manifest: ThemeManifest, settings: BuilderSettings): ThemeManifest;
+export declare function findCustomPageBySlug(settings: BuilderSettings, slug: string): BuilderSettings['theme']['pages'][number] | undefined;
+export declare function findCustomPageById(settings: BuilderSettings, pageId: string): BuilderSettings['theme']['pages'][number] | undefined;
+//# sourceMappingURL=custom-pages.d.ts.map

package/dist/custom-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-pages.d.ts","sourceRoot":"","sources":["../src/custom-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,yDAItC,CAAC;AAEX,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,aAAa,GACtB,MAAM,EAAE,CAIV;AAED,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EACrD,QAAQ,EAAE,aAAa,GACtB,YAAY,CAOd;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,eAAe,GACxB,aAAa,CAef;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,MAAM,GACX,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAEvD;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,GACb,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAEvD"}

package/dist/custom-pages.js

@@ -0,0 +1,40 @@
+/**
+ * Allowed embed/content blocks on merchant custom pages (`theme.pages[]`).
+ * Keep aligned with `customPageAllowedBlocks` in
+ * `config/builder-shared-manifest-blocks.json`.
+ */
+export const MERCHANT_CUSTOM_PAGE_ALLOWED_BLOCKS = [
+    'custom-html',
+    'youtube-embed',
+    'text-block',
+];
+export function resolveMerchantCustomPageAllowedBlocks(manifest) {
+    return MERCHANT_CUSTOM_PAGE_ALLOWED_BLOCKS.filter((blockType) => blockType in manifest.blocks);
+}
+export function buildMerchantCustomPageManifestEntry(customPage, manifest) {
+    return {
+        label: customPage.title,
+        previewPath: `/page/${customPage.slug}`,
+        allowedBlocks: resolveMerchantCustomPageAllowedBlocks(manifest),
+        defaultBlocks: [],
+    };
+}
+export function mergeCustomPagesIntoManifest(manifest, settings) {
+    if (settings.theme.pages.length === 0) {
+        return manifest;
+    }
+    const pages = { ...manifest.pages };
+    for (const customPage of settings.theme.pages) {
+        if (pages[customPage.id]) {
+            continue;
+        }
+        pages[customPage.id] = buildMerchantCustomPageManifestEntry(customPage, manifest);
+    }
+    return { ...manifest, pages };
+}
+export function findCustomPageBySlug(settings, slug) {
+    return settings.theme.pages.find((page) => page.slug === slug);
+}
+export function findCustomPageById(settings, pageId) {
+    return settings.theme.pages.find((page) => page.id === pageId);
+}

package/dist/dedicated-pages.d.ts

@@ -0,0 +1,15 @@
+export declare const BUILDER_LAYOUT_PAGE_IDS: readonly ["home", "navigation", "product", "footer", "terms"];
+export type BuilderLayoutPageId = (typeof BUILDER_LAYOUT_PAGE_IDS)[number];
+export declare const BUILDER_DEDICATED_PAGE_IDS: readonly ["contact-page", "faq-page", "reviews-page", "feedback-page", "guide-page", "status-page", "checkout-page", "tool-page"];
+export type BuilderDedicatedPageId = (typeof BUILDER_DEDICATED_PAGE_IDS)[number];
+/** @deprecated Legacy manifest page ids migrated on settings load. */
+export declare const DEDICATED_PAGE_ID_ALIASES: Readonly<Record<string, BuilderDedicatedPageId>>;
+export declare function normalizeDedicatedPageId(pageId: string): string;
+export declare function isDedicatedPageId(pageId: string): pageId is BuilderDedicatedPageId;
+export declare function dedicatedPagePreviewPath(pageId: string): string | null;
+export declare function dedicatedPageContentKey(pageId: string, field: string): string;
+export declare function normalizeDedicatedPageBlockType(pageId: string): string;
+export declare function createDedicatedPageBlockType(pageId: string): string;
+export declare function migrateDedicatedPageLayout(layout: Record<string, unknown>): Record<string, unknown>;
+export declare function migrateDedicatedPageContent(content: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=dedicated-pages.d.ts.map

package/dist/dedicated-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedicated-pages.d.ts","sourceRoot":"","sources":["../src/dedicated-pages.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,+DAM1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,eAAO,MAAM,0BAA0B,mIAS7B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,sEAAsE;AACtE,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAGtF,CAAC;AAaF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,sBAAsB,CAElF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMtE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnE;AAkBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDnG;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BrG"}

package/dist/dedicated-pages.js

@@ -0,0 +1,142 @@
+export const BUILDER_LAYOUT_PAGE_IDS = [
+    'home',
+    'navigation',
+    'product',
+    'footer',
+    'terms',
+];
+export const BUILDER_DEDICATED_PAGE_IDS = [
+    'contact-page',
+    'faq-page',
+    'reviews-page',
+    'feedback-page',
+    'guide-page',
+    'status-page',
+    'checkout-page',
+    'tool-page',
+];
+/** @deprecated Legacy manifest page ids migrated on settings load. */
+export const DEDICATED_PAGE_ID_ALIASES = {
+    reviews: 'reviews-page',
+    tool: 'tool-page',
+};
+const DEDICATED_PAGE_PREVIEW_PATHS = {
+    'contact-page': '/contact',
+    'faq-page': '/faq',
+    'reviews-page': '/reviews',
+    'feedback-page': '/feedback',
+    'guide-page': '/guide',
+    'status-page': '/status',
+    'checkout-page': '/checkout',
+    'tool-page': '/tool',
+};
+export function normalizeDedicatedPageId(pageId) {
+    return DEDICATED_PAGE_ID_ALIASES[pageId] ?? pageId;
+}
+export function isDedicatedPageId(pageId) {
+    return BUILDER_DEDICATED_PAGE_IDS.includes(pageId);
+}
+export function dedicatedPagePreviewPath(pageId) {
+    const normalized = normalizeDedicatedPageId(pageId);
+    if (!isDedicatedPageId(normalized)) {
+        return null;
+    }
+    return DEDICATED_PAGE_PREVIEW_PATHS[normalized];
+}
+export function dedicatedPageContentKey(pageId, field) {
+    return `pages.${normalizeDedicatedPageId(pageId)}.${field}`;
+}
+export function normalizeDedicatedPageBlockType(pageId) {
+    return createDedicatedPageBlockType(normalizeDedicatedPageId(pageId));
+}
+export function createDedicatedPageBlockType(pageId) {
+    const normalizedPageId = pageId
+        .toLowerCase()
+        .replace(/[^a-z0-9\-_.]+/g, '-')
+        .replace(/^[-_.]+/, '');
+    return `page-${normalizedPageId || 'custom'}`;
+}
+function migrateDedicatedPageBlockSettings(settings) {
+    if (typeof settings !== 'object' || settings === null || Array.isArray(settings)) {
+        return {};
+    }
+    const next = {};
+    for (const [key, value] of Object.entries(settings)) {
+        if (key.startsWith('tool.')) {
+            next[`pages.tool-page.${key.slice('tool.'.length)}`] = value;
+            continue;
+        }
+        next[key] = value;
+    }
+    return next;
+}
+export function migrateDedicatedPageLayout(layout) {
+    const next = { ...layout };
+    for (const [legacyId, canonicalId] of Object.entries(DEDICATED_PAGE_ID_ALIASES)) {
+        if (!Object.prototype.hasOwnProperty.call(next, legacyId)) {
+            continue;
+        }
+        const legacyLayout = next[legacyId];
+        delete next[legacyId];
+        if (Object.prototype.hasOwnProperty.call(next, canonicalId)) {
+            continue;
+        }
+        if (typeof legacyLayout !== 'object' || legacyLayout === null || Array.isArray(legacyLayout)) {
+            continue;
+        }
+        const blocks = legacyLayout.blocks;
+        if (!Array.isArray(blocks)) {
+            next[canonicalId] = legacyLayout;
+            continue;
+        }
+        const legacyBlockType = createDedicatedPageBlockType(legacyId);
+        const canonicalBlockType = createDedicatedPageBlockType(canonicalId);
+        next[canonicalId] = {
+            ...legacyLayout,
+            blocks: blocks.map((block) => {
+                if (typeof block !== 'object' || block === null || Array.isArray(block)) {
+                    return block;
+                }
+                const typed = block;
+                const isLegacyBlockType = typed.type === legacyBlockType
+                    || (legacyId === 'tool' && typed.type === 'tool');
+                if (!isLegacyBlockType) {
+                    return block;
+                }
+                return {
+                    ...typed,
+                    type: canonicalBlockType,
+                    settings: migrateDedicatedPageBlockSettings(typed.settings),
+                };
+            }),
+        };
+    }
+    return next;
+}
+export function migrateDedicatedPageContent(content) {
+    const next = { ...content };
+    for (const [key, value] of Object.entries(next)) {
+        if (key.startsWith('tool.') && !key.startsWith('tool-page.')) {
+            const canonicalKey = `pages.tool-page.${key.slice('tool.'.length)}`;
+            if (!Object.prototype.hasOwnProperty.call(next, canonicalKey)) {
+                next[canonicalKey] = value;
+            }
+            delete next[key];
+        }
+    }
+    for (const [legacyId, canonicalId] of Object.entries(DEDICATED_PAGE_ID_ALIASES)) {
+        const legacyPrefix = `pages.${legacyId}.`;
+        const canonicalPrefix = `pages.${canonicalId}.`;
+        for (const [key, value] of Object.entries(next)) {
+            if (!key.startsWith(legacyPrefix)) {
+                continue;
+            }
+            const canonicalKey = `${canonicalPrefix}${key.slice(legacyPrefix.length)}`;
+            if (!Object.prototype.hasOwnProperty.call(next, canonicalKey)) {
+                next[canonicalKey] = value;
+            }
+            delete next[key];
+        }
+    }
+    return next;
+}