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

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

@@ -92,15 +92,10 @@ export interface ProfileSectionArguments {
     background_color?: string | null;
 }
 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;
 }
@@ -113,8 +108,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;
 }
 export interface ImageSectionArguments {
@@ -122,15 +119,10 @@ export interface ImageSectionArguments {
     image_title?: string;
 }
 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;
 }
@@ -139,8 +131,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 {
     title?: string;
@@ -195,15 +189,10 @@ export interface TiktokSectionArguments {
     url?: string;
 }
 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' | 'instagram' | 'youtube' | 'linkedin' | 'pinterest' | 'twitch' | 'tiktok';
     url?: string;
 }
@@ -215,8 +204,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 {
     title?: RichTextField;
@@ -277,15 +268,10 @@ export interface AboutSectionArguments {
     background_color?: string | null;
 }
 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;
@@ -297,8 +283,10 @@ export interface ImagesSectionArguments {
     items?: ImagesSectionItem[];
     display_style?: 'left-aligned' | 'right-aligned' | 'centered' | 'media-only' | '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;
@@ -310,15 +298,10 @@ export interface ImagesSectionArguments {
     card_style?: CardStyleArguments;
 }
 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;
@@ -331,8 +314,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;
@@ -341,15 +326,10 @@ export interface TestimonialSectionArguments {
     card_style?: CardStyleArguments;
 }
 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;
@@ -362,8 +342,10 @@ export interface ShapesSectionArguments {
     items?: ShapesSectionItem[];
     display_style?: 'left-aligned' | 'right-aligned' | 'centered' | 'media-only' | '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/lib/src/shared/page-settings/components/page-settings/PageSettings.mixin.d.ts

@@ -2866,7 +2866,6 @@ declare const _default: import("vue").DefineComponent<{}, {
                 logoImageBase64Url?: string | undefined;
                 socialLinks: {
                     url: string;
-                    id?: string | undefined;
                     imageUrl: string;
                     size?: string | undefined;
                     imageTitle: string;
@@ -3091,7 +3090,6 @@ declare const _default: import("vue").DefineComponent<{}, {
                 logoImageBase64Url?: string | undefined;
                 socialLinks: {
                     url: string;
-                    id?: string | undefined;
                     imageUrl: string;
                     size?: string | undefined;
                     imageTitle: string;

package/lib/src/shared/page-settings/components/page-settings-section-styles/PageSettingsSectionStyles.mixin.d.ts

@@ -2824,7 +2824,6 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
                 logoImageBase64Url?: string | undefined;
                 socialLinks: {
                     url: string;
-                    id?: string | undefined;
                     imageUrl: string;
                     size?: string | undefined;
                     imageTitle: string;
@@ -3049,7 +3048,6 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
                 logoImageBase64Url?: string | undefined;
                 socialLinks: {
                     url: string;
-                    id?: string | undefined;
                     imageUrl: string;
                     size?: string | undefined;
                     imageTitle: string;

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

@@ -2,8 +2,6 @@ import { type BrandPageModel, type BrandPageType, type NavModel, type PageStyles
 import type { ContentType } from '../brand-page/models/content.model';
 import { type AssetEntry } from './build-asset-manifest';
 type MinifiedFooterSocialLink = {
-    position: number;
-    id?: string;
     imageUrl: string;
     url: string;
 };

package/lib/src/utils/minify-brand-page-metadata.js

@@ -164,7 +164,6 @@ const minifyContent = (content, editor, assets) => {
                 ...(Array.isArray(c.items) && {
                     items: c.items.map((item, index) => ({
                         position: index + 1,
-                        ...(item.id && { id: item.id }),
                         ...st('name', item.name, editor),
                         ...st('jobTitle', item.position, editor),
                         ...st('testimonials', item.testimonials, editor),
@@ -192,7 +191,6 @@ const minifyContent = (content, editor, assets) => {
                 ...(Array.isArray(c.items) && {
                     items: c.items.map((item, index) => ({
                         position: index + 1,
-                        ...(item.id && { id: item.id }),
                         ...includeImageWithKey(item.imageUrl),
                         ...st('title', item.title, editor),
                         ...st('paragraph', item.paragraph, editor),
@@ -222,7 +220,6 @@ const minifyContent = (content, editor, assets) => {
                 ...(Array.isArray(c.textItems) && {
                     textItems: c.textItems.map((item, index) => ({
                         position: index + 1,
-                        ...(item.id && { id: item.id }),
                         ...st('text', item.text, editor),
                         ...(includeStyle(item.textStyle) && { textStyle: item.textStyle }),
                     })),
@@ -303,7 +300,6 @@ const minifyContent = (content, editor, assets) => {
                 ...(Array.isArray(c.links) && {
                     links: c.links.map((link, index) => ({
                         position: index + 1,
-                        ...(link.id && { id: link.id }),
                         ...(includeString(link.url) && { url: link.url }),
                         ...includeImageWithKey(link.imageUrl),
                     })),
@@ -343,7 +339,6 @@ const minifyContent = (content, editor, assets) => {
                 ...(Array.isArray(c.images) && {
                     images: c.images.map((img, index) => ({
                         position: index + 1,
-                        ...(img.id && { id: img.id }),
                         ...includeImageWithKey(img.imageUrl),
                         ...st('imageTitle', img.imageTitle, editor),
                     })),
@@ -384,9 +379,7 @@ const minifyFooter = (footer, logoAssetKey) => {
         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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@designcrowd/library.brand-page",
   "description": "A collection of Maker/Designer applications",
-  "version": "5.19.1-id-based-items-2",
+  "version": "5.19.1",
   "author": "Design.com Eng",
   "license": "UNLICENSED",
   "type": "module",

package/src/brand-page/components/image-gallery/masonry/MasonryGallery.mixin.ts

@@ -7,8 +7,7 @@ import type { ImageGalleryImageClickPayload } from '../models';
 import type { BrandPageContext, ImageGalleryItem } from '../../../models';
 import { getImageAltText } from '../../../utils';
 
-interface IndexedImageGalleryItem extends Omit<ImageGalleryItem, 'id'> {
-  // Local rendering index, distinct from the stable string `id` on ImageItem.
+interface IndexedImageGalleryItem extends ImageGalleryItem {
   id: number;
 }
 

package/src/brand-page/models/index.ts

@@ -234,13 +234,6 @@ export interface ImageContent extends Content {
 }
 
 export interface ImageItem {
-  /**
-   * Stable per-item identifier. Mirrors the section-level `Content.id` one
-   * level deeper so AI tool calls can reference items by id rather than by
-   * positional index. Optional for backward compatibility with persisted data
-   * that predates item ids — backfilled on load (see ensureItemIds).
-   */
-  id?: string;
   imageUrl: string;
   imageTitle: string;
   width: number;
@@ -473,8 +466,6 @@ export interface ShapeItem extends ImageItem {
 }
 
 export interface TestimonialItems {
-  /** Stable per-item identifier. See ImageItem.id. */
-  id?: string;
   imageUrl: string;
   name: string;
   position: string;
@@ -492,8 +483,6 @@ export interface TestimonialItems {
 }
 
 export interface TextItem {
-  /** Stable per-item identifier. See ImageItem.id. */
-  id?: string;
   text: string;
   textStyle: TextStyleDeclaration;
 
@@ -563,7 +552,6 @@ export interface AboutSectionContent extends Content {
 }
 
 export interface LinksItem {
-  id?: string;
   imageUrl: string;
   url: string;
   size?: string;

package/src/brand-page-maker/composables/ai-chat/useAiWebsiteBuilderChat.ts

@@ -18,7 +18,6 @@ import {
   type PlanItem,
 } from '../../../clients/websocket-gateway-client';
 import { minifyBrandPageMetadata } from '../../../utils/minify-brand-page-metadata';
-import { ensureBrandPageItemIds } from '../../../metadata-builder/builders/item-id-utils';
 import { buildAssetManifest } from '../../../utils/build-asset-manifest';
 import { usePageNavigationStore } from '../../../shared/page-navigation/store/page-navigation-store';
 import { navigateToPageByPageId } from '../../routing';
@@ -257,11 +256,6 @@ export function useAiWebsiteBuilderChat(): UseAiChatResult {
 
   const buildMessagePayload = async (userPrompt: string) => {
     const brandPageData = brandPageMakerStore.brandPageData;
-
-    // BP-5603: stamp stable uuid ids onto every nested item BEFORE minifying,
-    // so the id the AI is shown (and returns as `item_id`) is the exact id the
-    // executor matches when applying tool calls to this same live model.
-    ensureBrandPageItemIds(brandPageData);
     const headerLogoDraftToken =
       brandPageData.pageHeaderDesktop?.logoImage?.logoDraftToken ??
       uiStore.logoDraftToken;