@designcrowd/library.brand-page 5.19.1-id-based-items-2 → 5.19.2

package/src/metadata-builder/parsers/section-tool-arguments.ts

@@ -142,15 +142,10 @@ export interface ProfileSectionArguments {
 }
 
 export interface TextSectionItem {
-  /** Stable id of the existing item to update or move. Omit to ADD a new item. */
-  item_id?: string;
-  /**
-   * Id of an existing item to position this item before (insert for new items,
-   * move for existing ones). Use "__end__" for the end of the list. Omit to
-   * leave an existing item in place / append a new item. Mirrors the
-   * section-level move_before_content_id.
-   */
-  move_before_item_id?: string;
+  /** 0-based index of existing item to update in-place */
+  item_index?: number;
+  /** 0-based position to insert a new item at */
+  insert_at?: number;
   text?: RichTextField;
   text_style?: TextStyleArguments;
 }
@@ -164,8 +159,10 @@ export interface TextSectionArguments {
   /** Multiple text items (BrandSite) */
   items?: TextSectionItem[];
   _replace_items?: boolean;
-  /** Stable ids of items to remove. Order-independent (no index shifting). */
-  _remove_item_ids?: string[];
+  /** 0-based indices of items to remove */
+  _remove_item_indices?: number[];
+  /** New order as array of current 0-based indices */
+  _reorder_items?: number[];
   background_color?: string | null;
 }
 
@@ -175,15 +172,10 @@ export interface ImageSectionArguments {
 }
 
 export interface ImageGalleryItem {
-  /** Stable id of the existing item to update or move. Omit to ADD a new item. */
-  item_id?: string;
-  /**
-   * Id of an existing item to position this item before (insert for new items,
-   * move for existing ones). Use "__end__" for the end of the list. Omit to
-   * leave an existing item in place / append a new item. Mirrors the
-   * section-level move_before_content_id.
-   */
-  move_before_item_id?: string;
+  /** 0-based index of existing item to update in-place */
+  item_index?: number;
+  /** 0-based position to insert a new item at */
+  insert_at?: number;
   image_url?: string;
   caption?: string;
 }
@@ -193,8 +185,10 @@ export interface ImageGallerySectionArguments {
   gallery_type?: 'grid' | 'carousel' | 'masonry';
   is_full_width?: boolean;
   _replace_items?: boolean;
-  /** Stable ids of items to remove. Order-independent (no index shifting). */
-  _remove_item_ids?: string[];
+  /** 0-based indices of items to remove */
+  _remove_item_indices?: number[];
+  /** New order as array of current 0-based indices */
+  _reorder_items?: number[];
 }
 
 export interface GeneralLinkSectionArguments {
@@ -262,15 +256,10 @@ export interface TiktokSectionArguments {
 }
 
 export interface SocialLink {
-  /** Stable id of the existing item to update or move. Omit to ADD a new item. */
-  item_id?: string;
-  /**
-   * Id of an existing item to position this item before (insert for new items,
-   * move for existing ones). Use "__end__" for the end of the list. Omit to
-   * leave an existing item in place / append a new item. Mirrors the
-   * section-level move_before_content_id.
-   */
-  move_before_item_id?: string;
+  /** 0-based index of existing item to update in-place */
+  item_index?: number;
+  /** 0-based position to insert a new item at */
+  insert_at?: number;
   platform?:
     | 'facebook'
     | 'x'
@@ -291,8 +280,10 @@ export interface SocialLinksSectionArguments {
   /** Style for the icon container background (used when icon_style is 'square' or 'circle'). */
   icon_background_style?: TextStyleArguments;
   _replace_items?: boolean;
-  /** Stable ids of items to remove. Order-independent (no index shifting). */
-  _remove_item_ids?: string[];
+  /** 0-based indices of items to remove */
+  _remove_item_indices?: number[];
+  /** New order as array of current 0-based indices */
+  _reorder_items?: number[];
 }
 
 export interface MailingListSectionArguments {
@@ -380,15 +371,10 @@ export interface AboutSectionArguments {
 }
 
 export interface ImagesSectionItem {
-  /** Stable id of the existing item to update or move. Omit to ADD a new item. */
-  item_id?: string;
-  /**
-   * Id of an existing item to position this item before (insert for new items,
-   * move for existing ones). Use "__end__" for the end of the list. Omit to
-   * leave an existing item in place / append a new item. Mirrors the
-   * section-level move_before_content_id.
-   */
-  move_before_item_id?: string;
+  /** 0-based index of existing item to update in-place */
+  item_index?: number;
+  /** 0-based position to insert a new item at */
+  insert_at?: number;
   image_url?: string;
   heading?: string;
   text?: string;
@@ -407,8 +393,10 @@ export interface ImagesSectionArguments {
     | 'center-card-aligned-image'
     | 'alternate-image';
   _replace_items?: boolean;
-  /** Stable ids of items to remove. Order-independent (no index shifting). */
-  _remove_item_ids?: string[];
+  /** 0-based indices of items to remove */
+  _remove_item_indices?: number[];
+  /** New order as array of current 0-based indices */
+  _reorder_items?: number[];
   title_style?: TextStyleArguments;
   description_style?: TextStyleArguments;
   heading_style?: TextStyleArguments;
@@ -421,15 +409,10 @@ export interface ImagesSectionArguments {
 }
 
 export interface TestimonialItem {
-  /** Stable id of the existing item to update or move. Omit to ADD a new item. */
-  item_id?: string;
-  /**
-   * Id of an existing item to position this item before (insert for new items,
-   * move for existing ones). Use "__end__" for the end of the list. Omit to
-   * leave an existing item in place / append a new item. Mirrors the
-   * section-level move_before_content_id.
-   */
-  move_before_item_id?: string;
+  /** 0-based index of existing item to update in-place */
+  item_index?: number;
+  /** 0-based position to insert a new item at */
+  insert_at?: number;
   testimonial?: string;
   name?: string;
   position?: string;
@@ -443,8 +426,10 @@ export interface TestimonialSectionArguments {
   items?: TestimonialItem[];
   display_style?: 'centered' | 'big-image' | 'columns';
   _replace_items?: boolean;
-  /** Stable ids of items to remove. Order-independent (no index shifting). */
-  _remove_item_ids?: string[];
+  /** 0-based indices of items to remove */
+  _remove_item_indices?: number[];
+  /** New order as array of current 0-based indices */
+  _reorder_items?: number[];
   title_style?: TextStyleArguments;
   testimonial_style?: TextStyleArguments;
   name_style?: TextStyleArguments;
@@ -454,15 +439,10 @@ export interface TestimonialSectionArguments {
 }
 
 export interface ShapesSectionItem {
-  /** Stable id of the existing item to update or move. Omit to ADD a new item. */
-  item_id?: string;
-  /**
-   * Id of an existing item to position this item before (insert for new items,
-   * move for existing ones). Use "__end__" for the end of the list. Omit to
-   * leave an existing item in place / append a new item. Mirrors the
-   * section-level move_before_content_id.
-   */
-  move_before_item_id?: string;
+  /** 0-based index of existing item to update in-place */
+  item_index?: number;
+  /** 0-based position to insert a new item at */
+  insert_at?: number;
   icon_image_url?: string;
   shape_url?: string;
   color_theme?: string;
@@ -482,8 +462,10 @@ export interface ShapesSectionArguments {
     | 'center-card-aligned-image'
     | 'alternate-image';
   _replace_items?: boolean;
-  /** Stable ids of items to remove. Order-independent (no index shifting). */
-  _remove_item_ids?: string[];
+  /** 0-based indices of items to remove */
+  _remove_item_indices?: number[];
+  /** New order as array of current 0-based indices */
+  _reorder_items?: number[];
   title_style?: TextStyleArguments;
   description_style?: TextStyleArguments;
   heading_style?: TextStyleArguments;

package/src/shared/models.ts

@@ -19,6 +19,12 @@ export interface UIRootState {
   thirdPartySettings: UIRootStateThirdPartySettings;
   personalisationData: UserPersonalisationContent[] | undefined;
   isPersonalisationEnabled: boolean;
+  // Pre-purchase AI content key used to personalise AI template previews when
+  // there is no post-purchase personalisationData (bp-5742).
+  userPromptContentKey: string | undefined;
+  // Controls visibility of the dedicated AI templates tab. Decoupled from personalisationData
+  // so the slug flow can personalise previews/apply without surfacing the AI tab (bp-5742).
+  showAiTemplatesTab: boolean;
 }
 
 export interface Endpoints {

package/src/shared/template-settings/components/TemplatesSettings.mixin.ts

@@ -60,7 +60,7 @@ export default defineComponent({
       templateCategories: computed(
         () => templateSettingsStore.templateCategories,
       ),
-      personalisationData: computed(() => uiStore.personalisationData),
+      showAiTemplatesTab: computed(() => uiStore.showAiTemplatesTab),
       templateSettingsStore,
       uiStore,
       isDesignCom: computed(() => containerStore.isDesignCom),
@@ -155,7 +155,7 @@ export default defineComponent({
     },
 
     visibleTabs() {
-      return this.personalisationData
+      return this.showAiTemplatesTab
         ? this.tabs
         : [...this.tabs].splice(
             0,

package/src/shared/template-settings/models.ts

@@ -7,6 +7,7 @@ export interface TemplateSettingsTemplate {
   personalisationContentIndex?: number;
   brandPageModel: BrandPageModel;
   contentKey?: string;
+  usesUserPromptContentKey?: boolean;
   previewImageUrl?: string;
 }
 

package/src/shared/template-settings/store/template-settings-store.ts

@@ -14,6 +14,7 @@ import * as DesignTemplateClient from '../../../clients/design-template-client';
 import { type DesignTemplate } from '../../../clients/models';
 import {
   BP_DEFAULT_TEMPLATE_TYPE_NAME,
+  BP_BRAND_SITE_TEMPLATE_TYPE_NAME,
   SIDE_BAR_TAB_NAMES,
 } from '@brand-page-maker/constants';
 import { defineStore, storeToRefs } from 'pinia';
@@ -32,6 +33,7 @@ import {
   useUiEditableLogoStore,
   useUiLogoSettingsStore,
 } from '../../logo-settings/store';
+import { useEventTracker } from '@brand-page-maker/composables/useEventTracker';
 import {
   templateSettingsTr,
   getCurrentLocale,
@@ -39,6 +41,17 @@ import {
 import { watch } from 'vue';
 
 export const DEFAULT_PAGE_SIZE = 6;
+
+const POST_PURCHASE_PAGE_SECTION_BY_TAB: Record<string, string> = {
+  [TEMPLATE_TABS.all]: 'MakerPostPurchaseSidebarTemplatesAllTab',
+  [TEMPLATE_TABS.AI]: 'MakerPostPurchaseSidebarTemplatesAiTab',
+  [TEMPLATE_TABS.categories]: 'MakerPostPurchaseSidebarTemplatesCategoryTab',
+};
+
+const PRE_PURCHASE_PAGE_SECTION_BY_TAB: Record<string, string> = {
+  [TEMPLATE_TABS.all]: 'MakerPrePurchaseSidebarTemplatesAllTab',
+  [TEMPLATE_TABS.categories]: 'MakerPrePurchaseSidebarTemplatesCategoryTab',
+};
 const LOAD_PAGE_RETRY_DELAY = 250;
 
 type SelectedTabType = {
@@ -66,6 +79,7 @@ export interface TemplatesSettingState {
   tabsWithTranslations: SelectedTabType[];
   logoChangeWatcherInitialized: boolean;
   initialSearchTerm: string | undefined;
+  aiTemplateKeywords: string | undefined;
   onSearchTermChanged: OnSearchTermChangedCallback | undefined;
 }
 
@@ -103,6 +117,7 @@ export const useUiTemplateSettingsStore = defineStore('uiTemplateSettings', {
       cachedTemplates: {},
       logoChangeWatcherInitialized: false,
       initialSearchTerm: undefined,
+      aiTemplateKeywords: undefined,
       onSearchTermChanged: undefined,
     };
   },
@@ -302,22 +317,60 @@ export const useUiTemplateSettingsStore = defineStore('uiTemplateSettings', {
         const editableLogoVariation =
           editableLogoStore.editableLogoVariations[logoVariation];
 
+        const isPrePurchase = brandPageContainerStore.isPrePurchase;
+        const isBrandSite =
+          this.templateType === BP_BRAND_SITE_TEMPLATE_TYPE_NAME;
+
+        // Pre-purchase has no logo draft for logo-based recommendation, so fall back to the seeded
+        // search term (the keyword from the URL/cookie - never the business name) so the All tab
+        // stays relevant instead of generic (bp-5454).
+        const effectiveSearchTerm =
+          !this.searchTerm &&
+          !this.selectedCategory &&
+          isPrePurchase &&
+          isBrandSite &&
+          this.selectedTab.key === TEMPLATE_TABS.all
+            ? this.initialSearchTerm
+            : this.searchTerm;
+
+        const pageSection = isBrandSite
+          ? (isPrePurchase
+              ? PRE_PURCHASE_PAGE_SECTION_BY_TAB
+              : POST_PURCHASE_PAGE_SECTION_BY_TAB)[this.selectedTab.key]
+          : undefined;
+
+        const pageName = isBrandSite
+          ? isPrePurchase
+            ? 'maker-pre-purchase'
+            : 'maker'
+          : undefined;
+
+        const baseParams = {
+          page: pageNo,
+          categoryName: this.selectedCategory,
+          searchTerm: effectiveSearchTerm,
+          keywords: this.aiTemplateKeywords,
+          logoDraftToken: logoSettingsStore.selectedLogoImage.logoDraftToken,
+          logoVariation: logoSettingsStore.selectedLogoImage.logoVariation,
+          selectedTemplateToken: designTemplateToken,
+          locale: currentLocale,
+          logoS3Token: !isByo ? editableLogoVariation.s3Token : undefined,
+          logoTemplateToken: isByo ? logoTemplateToken : undefined,
+          useLogoForRecommendedTemplates:
+            isBrandSite && this.selectedTab.key === TEMPLATE_TABS.all,
+          pageSection,
+          pageName,
+        };
+
+        // AI templates are interleaved server-side for the Brand Site All tab
+        // (bp-5306); the frontend just renders the returned order.
         const result =
           await designTemplateClient.getTemplateItemsByTemplateType(
             this.templateType,
             {
-              page: pageNo,
+              ...baseParams,
               pageSize: DEFAULT_PAGE_SIZE,
-              categoryName: this.selectedCategory,
-              searchTerm: this.searchTerm,
-              logoDraftToken:
-                logoSettingsStore.selectedLogoImage.logoDraftToken,
-              logoVariation: logoSettingsStore.selectedLogoImage.logoVariation,
               personalisable: this.selectedTab.key === TEMPLATE_TABS.AI,
-              selectedTemplateToken: designTemplateToken,
-              locale: currentLocale,
-              logoS3Token: !isByo ? editableLogoVariation.s3Token : undefined,
-              logoTemplateToken: isByo ? logoTemplateToken : undefined,
             },
           );
 
@@ -327,11 +380,27 @@ export const useUiTemplateSettingsStore = defineStore('uiTemplateSettings', {
 
         this._setPageCount({ pageCount: result.pageCount });
 
+        if (
+          pageNo === 1 &&
+          result.abTestValuesToBePushed &&
+          Object.keys(result.abTestValuesToBePushed).length > 0
+        ) {
+          const eventTracker = useEventTracker();
+
+          for (const [experimentName, experimentValue] of Object.entries(
+            result.abTestValuesToBePushed,
+          )) {
+            eventTracker.sendExperimentStartedEvent(
+              experimentName,
+              experimentValue,
+            );
+          }
+        }
+
         const templates = await Promise.all(
           result.paginatedItems.map(async (item) => {
             try {
               if (brandPageMakerUserStore.isAdmin) {
-                // Pre-purchase: full template with brandPageModel for live rendering
                 const template =
                   await designTemplateClient.getTemplateByTemplateToken(
                     item.designTemplateToken,
@@ -349,17 +418,24 @@ export const useUiTemplateSettingsStore = defineStore('uiTemplateSettings', {
                       uiStore.personalisationData.length,
                     );
 
-                  // Get the contentKey from the selected personalisation variation
-                  // This is needed for the backend preview URL to show the correct variation
-                  const selectedPersonalisation =
-                    uiStore.personalisationData[personalisationContentIndex];
-
-                  contentKey = selectedPersonalisation.contentKey;
+                  contentKey =
+                    uiStore.personalisationData[personalisationContentIndex]
+                      .contentKey;
+                } else if (item.isPersonalisable) {
+                  // Pre-purchase has no personalisationData; personalise AI
+                  // template previews with the prompt content key (bp-5742).
+                  contentKey = uiStore.userPromptContentKey;
                 }
 
                 return {
                   id: item.designTemplateToken,
+                  isPersonalisable: item.isPersonalisable,
                   contentKey,
+                  // A userPromptContentKey signals this design's real AI images live
+                  // in the userPrompt bucket (post- or pre-purchase). The preview must
+                  // then resolve via userPromptContentKey, not the regular bucket which
+                  // holds placeholders post-purchase (bp-5454).
+                  usesUserPromptContentKey: !!uiStore.userPromptContentKey,
                   previewImageUrl: item.previewImageUrl,
                 } as TemplateSettingsTemplate;
               }
@@ -374,7 +450,15 @@ export const useUiTemplateSettingsStore = defineStore('uiTemplateSettings', {
           (t): t is TemplateSettingsTemplate => t !== null,
         );
 
-        this._addTemplates({ templates: validTemplates });
+        // The Categories tab must never surface AI templates or the AI badge
+        // (bp-5454 scenario 5). The badge is driven purely by isPersonalisable,
+        // so clear it for category results regardless of the template's catalog flag.
+        const displayTemplates =
+          this.selectedTab.key === TEMPLATE_TABS.categories
+            ? validTemplates.map((t) => ({ ...t, isPersonalisable: false }))
+            : validTemplates;
+
+        this._addTemplates({ templates: displayTemplates });
         this._setPageNoLoaded({ pageNoLoaded: pageNo });
       } finally {
         this._setIsBusy({ isBusy: false });
@@ -496,6 +580,9 @@ export const useUiTemplateSettingsStore = defineStore('uiTemplateSettings', {
       this.initialSearchTerm = payload.initialSearchTerm;
       this.onSearchTermChanged = payload.onSearchTermChanged;
     },
+    setAiTemplateKeywords(payload: { aiTemplateKeywords: string }) {
+      this.aiTemplateKeywords = payload.aiTemplateKeywords;
+    },
     notifySearchTermChanged(searchTerm: string | undefined) {
       this.onSearchTermChanged?.(searchTerm);
     },

package/src/utils/minify-brand-page-metadata.ts

@@ -15,12 +15,7 @@ import { useExternalRichTextEditor } from '../brand-page-maker/composables/rich-
 import type { Editor, JSONContent } from '@tiptap/vue-3';
 import { type AssetEntry, resolveLogoData } from './build-asset-manifest';
 
-type MinifiedFooterSocialLink = {
-  position: number;
-  id?: string;
-  imageUrl: string;
-  url: string;
-};
+type MinifiedFooterSocialLink = { imageUrl: string; url: string };
 
 type MinifiedFooter = {
   displayStyle?: string;
@@ -297,7 +292,6 @@ const minifyContent = (
         ...(Array.isArray(c.items) && {
           items: c.items.map((item: any, index: number) => ({
             position: index + 1,
-            ...(item.id && { id: item.id }),
             ...st('name', item.name, editor),
             ...st('jobTitle', item.position, editor),
             ...st('testimonials', item.testimonials, editor),
@@ -326,7 +320,6 @@ const minifyContent = (
         ...(Array.isArray(c.items) && {
           items: c.items.map((item: any, index: number) => ({
             position: index + 1,
-            ...(item.id && { id: item.id }),
             ...includeImageWithKey(item.imageUrl),
             ...st('title', item.title, editor),
             ...st('paragraph', item.paragraph, editor),
@@ -357,7 +350,6 @@ const minifyContent = (
         ...(Array.isArray(c.textItems) && {
           textItems: c.textItems.map((item: any, index: number) => ({
             position: index + 1,
-            ...(item.id && { id: item.id }),
             ...st('text', item.text, editor),
             ...(includeStyle(item.textStyle) && { textStyle: item.textStyle }),
           })),
@@ -447,7 +439,6 @@ const minifyContent = (
         ...(Array.isArray(c.links) && {
           links: c.links.map((link: any, index: number) => ({
             position: index + 1,
-            ...(link.id && { id: link.id }),
             ...(includeString(link.url) && { url: link.url }),
             ...includeImageWithKey(link.imageUrl),
           })),
@@ -491,7 +482,6 @@ const minifyContent = (
         ...(Array.isArray(c.images) && {
           images: c.images.map((img: any, index: number) => ({
             position: index + 1,
-            ...(img.id && { id: img.id }),
             ...includeImageWithKey(img.imageUrl),
             ...st('imageTitle', img.imageTitle, editor),
           })),
@@ -541,9 +531,7 @@ const minifyFooter = (
     logoImageWidth: footer.logoImageWidth || undefined,
     ...(logoAssetKey && { logoAssetKey }),
     socialLinks: footer.socialLinks?.length
-      ? footer.socialLinks.map((l, index) => ({
-          position: index + 1,
-          ...(l.id && { id: l.id }),
+      ? footer.socialLinks.map((l) => ({
           imageUrl: l.imageUrl || '',
           url: l.url || '',
         }))

package/lib/src/metadata-builder/builders/item-id-utils.d.ts

@@ -1,54 +0,0 @@
-import type { BrandPageModel } from '../../brand-page/models';
-/**
- * Sentinel anchor meaning "the end of the list", mirroring the section-level
- * `move_before_content_id: "__end__"` convention used in base-section-builder.
- */
-export declare const END_ITEM_ANCHOR = "__end__";
-/** Generate a stable item id. Mirrors section-level `uuid.v4()` id generation. */
-export declare const generateItemId: () => string;
-/**
- * Walk an entire BrandPageModel and backfill a stable uuid `id` onto every
- * nested array item that lacks one (gallery images, images/shapes/testimonial
- * items, text items, social links, and footer social links).
- *
- * BP-5603: this must run BEFORE the model is minified for the AI, so the same
- * id the AI is shown (and copies into `item_id`) is the one the executor later
- * matches. The maker holds a single live model instance for both the minify
- * and the apply step, so mutating it here makes the ids round-trip; they then
- * persist on the next save. Idempotent — existing ids are preserved.
- */
-export declare const ensureBrandPageItemIds: (model: BrandPageModel) => void;
-/**
- * Backfill ids onto any items missing one. Per BP-5603 this runs in the
- * metadata builder when a section is processed, so the persisted metadata
- * returned to the client gains stable ids that subsequent AI tool calls can
- * reference. Mutates in place.
- */
-export declare const ensureItemIds: <T extends {
-    id?: string | undefined;
-}>(items: T[] | undefined) => void;
-/**
- * Remove items whose id appears in `ids`. Order-independent (no descending
- * index sort needed) — the whole point of the id-based migration. Items
- * without an id are never removed by id.
- */
-export declare const removeItemsByIds: <T extends {
-    id?: string | undefined;
-}>(items: T[] | undefined, ids: string[] | undefined) => T[];
-/**
- * Position `item` within `items` relative to an anchor id — the item-level
- * mirror of base-section-builder's `moveContent`:
- *
- * - `moveBeforeItemId === undefined`  → leave an existing item where it is;
- *   append a new (not-yet-present) item to the end.
- * - `moveBeforeItemId === "__end__"`  → move/insert at the very end.
- * - anchor id found                   → insert immediately before it.
- * - anchor id not found               → fall through to the end (same
- *   forgiving behaviour as `moveContent`).
- *
- * Mutates `items` in place. `item` may be an existing element of `items`
- * (a move) or a brand-new object (an insert).
- */
-export declare const repositionItemByAnchor: <T extends {
-    id?: string | undefined;
-}>(items: T[], item: T, moveBeforeItemId: string | undefined) => void;

package/lib/src/metadata-builder/builders/item-id-utils.js

@@ -1,96 +0,0 @@
-import { v4 as uuidv4 } from 'uuid';
-/**
- * Sentinel anchor meaning "the end of the list", mirroring the section-level
- * `move_before_content_id: "__end__"` convention used in base-section-builder.
- */
-export const END_ITEM_ANCHOR = '__end__';
-/** Generate a stable item id. Mirrors section-level `uuid.v4()` id generation. */
-export const generateItemId = () => uuidv4();
-/**
- * Walk an entire BrandPageModel and backfill a stable uuid `id` onto every
- * nested array item that lacks one (gallery images, images/shapes/testimonial
- * items, text items, social links, and footer social links).
- *
- * BP-5603: this must run BEFORE the model is minified for the AI, so the same
- * id the AI is shown (and copies into `item_id`) is the one the executor later
- * matches. The maker holds a single live model instance for both the minify
- * and the apply step, so mutating it here makes the ids round-trip; they then
- * persist on the next save. Idempotent — existing ids are preserved.
- */
-export const ensureBrandPageItemIds = (model) => {
-    const ensureContentItemIds = (content) => {
-        // Every array field that the minifier surfaces as a list of items.
-        for (const field of ['images', 'items', 'textItems', 'links']) {
-            const arr = content[field];
-            if (Array.isArray(arr))
-                ensureItemIds(arr);
-        }
-    };
-    for (const page of model.pages ?? []) {
-        for (const content of page.contents ?? []) {
-            ensureContentItemIds(content);
-        }
-    }
-    ensureItemIds(model.pageFooterDesktop?.socialLinks);
-    ensureItemIds(model.pageFooterMobile?.socialLinks);
-};
-/**
- * Backfill ids onto any items missing one. Per BP-5603 this runs in the
- * metadata builder when a section is processed, so the persisted metadata
- * returned to the client gains stable ids that subsequent AI tool calls can
- * reference. Mutates in place.
- */
-export const ensureItemIds = (items) => {
-    if (!items)
-        return;
-    for (const item of items) {
-        if (!item.id)
-            item.id = generateItemId();
-    }
-};
-/**
- * Remove items whose id appears in `ids`. Order-independent (no descending
- * index sort needed) — the whole point of the id-based migration. Items
- * without an id are never removed by id.
- */
-export const removeItemsByIds = (items, ids) => {
-    if (!items?.length)
-        return items ?? [];
-    if (!ids?.length)
-        return items;
-    const toRemove = new Set(ids);
-    return items.filter((item) => !item.id || !toRemove.has(item.id));
-};
-/**
- * Position `item` within `items` relative to an anchor id — the item-level
- * mirror of base-section-builder's `moveContent`:
- *
- * - `moveBeforeItemId === undefined`  → leave an existing item where it is;
- *   append a new (not-yet-present) item to the end.
- * - `moveBeforeItemId === "__end__"`  → move/insert at the very end.
- * - anchor id found                   → insert immediately before it.
- * - anchor id not found               → fall through to the end (same
- *   forgiving behaviour as `moveContent`).
- *
- * Mutates `items` in place. `item` may be an existing element of `items`
- * (a move) or a brand-new object (an insert).
- */
-export const repositionItemByAnchor = (items, item, moveBeforeItemId) => {
-    const currentIndex = items.indexOf(item);
-    if (moveBeforeItemId === undefined) {
-        if (currentIndex === -1)
-            items.push(item);
-        return;
-    }
-    if (currentIndex !== -1)
-        items.splice(currentIndex, 1);
-    const anchorIndex = moveBeforeItemId === END_ITEM_ANCHOR
-        ? -1
-        : items.findIndex((i) => i.id === moveBeforeItemId);
-    if (anchorIndex !== -1) {
-        items.splice(anchorIndex, 0, item);
-    }
-    else {
-        items.push(item);
-    }
-};