@designcrowd/library.brand-page 5.17.28 → 5.18.0

package/src/metadata-builder/builders/update-content-text-style-builder.ts

@@ -218,7 +218,7 @@ export class UpdateContentTextStyleBuilder extends BaseMetadataBuilder<UpdateTex
     const { newStyles } = this.request.payload!;
     const errors: string[] = [];
 
-    // Validate lineHeight: must be between 0 and 2.5 inclusive
+    // Validate lineHeight: must be between 0 and 2.5 inclusive, snap to 0.1 step
     if (newStyles.lineHeight !== undefined && newStyles.lineHeight !== null) {
       const lineHeightValue = parseFloat(String(newStyles.lineHeight));
 
@@ -228,6 +228,9 @@ export class UpdateContentTextStyleBuilder extends BaseMetadataBuilder<UpdateTex
         lineHeightValue > 2.5
       ) {
         errors.push('Line height must be a value between 0 and 2.5 inclusive.');
+      } else {
+        // Snap to 0.1 increments to match the UI slider step
+        newStyles.lineHeight = String(Math.floor(lineHeightValue * 10) / 10);
       }
     }
 

package/src/metadata-builder/helpers/rte.helpers.ts

@@ -1,9 +1,13 @@
 import type { TextStyleDeclaration } from '../../brand-page';
-import { getRTEColor, hasRTEContent } from '../../brand-page-maker/utils';
+import { getRTEColor } from '../../brand-page-maker/utils';
 import { useExternalRichTextEditor } from '../../brand-page-maker/composables/rich-text-editor/useRichTextEditor';
 import { getRenderText } from '../../brand-page/utils';
 import { ESCAPED_NEWLINE_CHARACTER } from '../../constants/ui';
 import type { Editor } from '@tiptap/vue-3';
+import {
+  isTiptapDocument,
+  type TiptapDocument,
+} from '../parsers/section-tool-arguments';
 
 export const applyStyleToRTEText = (
   externalEditor: Editor,
@@ -79,22 +83,32 @@ export const applyStyleToRTEText = (
 };
 
 /**
- * If `text` contains RTE markup, re-applies `style` to the RTE content
- * so inline formatting matches the updated TextStyleDeclaration.
- * Returns the original text unchanged when it has no RTE content.
+ * Converts a Tiptap JSON document (ProseMirror document model) to an HTML
+ * string using a headless Tiptap Editor instance.
+ *
+ * Returns the value unchanged if it is already a string.
+ * Returns an empty string for null/undefined.
+ *
+ * Note: Tiptap's `setContent` does NOT throw on malformed input — it
+ * silently drops content and returns `<p></p>`. To prevent saved copy
+ * being wiped (BP-5669), structural validity of any AI-emitted Tiptap
+ * doc is checked upstream by `rteSchemaCheck` in
+ * `section-args-validator.ts` using the editor's real ProseMirror
+ * schema. The validator surfaces a clear error into
+ * `BuilderResult.errors`, which the AI-chat retry loop reads via
+ * `tool_result.errorMessage` and uses to re-emit a corrected payload.
  */
-export const updateRTEText = (
-  text: string,
-  style: TextStyleDeclaration,
-): string => {
-  if (!text || typeof text !== 'string' || !hasRTEContent(text)) {
-    return text;
-  }
+export const tiptapJsonToHtml = (value: unknown): string => {
+  if (typeof value === 'string') return value;
+
+  if (!isTiptapDocument(value)) return '';
 
   const { externalEditor } = useExternalRichTextEditor();
-  const updatedText = applyStyleToRTEText(externalEditor, text, style);
+
+  externalEditor.commands.setContent(value as TiptapDocument);
+  const html = externalEditor.getHTML();
 
   externalEditor.destroy();
 
-  return updatedText;
+  return html;
 };

package/src/metadata-builder/metadata-executor.ts

@@ -12,6 +12,7 @@ import { UpdateContentTextBuilder } from './builders/update-content-text-builder
 import { UpdateContentTextStyleBuilder } from './builders/update-content-text-style-builder';
 import {
   BannerSectionBuilder,
+  BookingSectionBuilder,
   AboutSectionBuilder,
   ContactFormBuilder,
   DividerSectionBuilder,
@@ -29,11 +30,18 @@ import {
 } from './builders/section-builders';
 import { AddPageBuilder } from './builders/add-page-builder';
 import { RemovePageBuilder } from './builders/remove-page-builder';
+import { RenamePageBuilder } from './builders/rename-page-builder';
+import { FooterBuilder } from './builders/footer-builder';
+import { GlobalStylesBuilder } from './builders/global-styles-builder';
+import { HeaderBuilder } from './builders/header-builder';
+import { UndoBuilder } from './builders/undo-builder';
+import type { EventTracker } from '../brand-page-maker/composables/useEventTracker';
 import type { Logger } from './logger';
 
 type BuilderConstructor = new (
   request: MetadataBuilderRequest<any>,
   logger?: Logger,
+  eventTracker?: EventTracker,
 ) => BaseMetadataBuilder;
 
 // Lazy initialization to avoid circular dependency issues
@@ -43,6 +51,7 @@ const getBuilderRegistry = (): Record<BuilderType, BuilderConstructor> => ({
 
   // Section builders (create)
   [BUILDER_TYPES.CREATE_BANNER_SECTION]: BannerSectionBuilder,
+  [BUILDER_TYPES.CREATE_BOOKING_SECTION]: BookingSectionBuilder,
   [BUILDER_TYPES.CREATE_ABOUT_SECTION]: AboutSectionBuilder,
   [BUILDER_TYPES.CREATE_CONTACT_FORM]: ContactFormBuilder,
   [BUILDER_TYPES.CREATE_DIVIDER_SECTION]: DividerSectionBuilder,
@@ -69,6 +78,7 @@ const getBuilderRegistry = (): Record<BuilderType, BuilderConstructor> => ({
 
   // Section builders (update)
   [BUILDER_TYPES.UPDATE_BANNER_SECTION]: BannerSectionBuilder,
+  [BUILDER_TYPES.UPDATE_BOOKING_SECTION]: BookingSectionBuilder,
   [BUILDER_TYPES.UPDATE_ABOUT_SECTION]: AboutSectionBuilder,
   [BUILDER_TYPES.UPDATE_CONTACT_FORM]: ContactFormBuilder,
   [BUILDER_TYPES.UPDATE_DIVIDER_SECTION]: DividerSectionBuilder,
@@ -100,6 +110,19 @@ const getBuilderRegistry = (): Record<BuilderType, BuilderConstructor> => ({
   // Page-level operations
   [BUILDER_TYPES.ADD_PAGE]: AddPageBuilder,
   [BUILDER_TYPES.REMOVE_PAGE]: RemovePageBuilder,
+  [BUILDER_TYPES.RENAME_PAGE]: RenamePageBuilder,
+
+  // Footer operations
+  [BUILDER_TYPES.UPDATE_FOOTER]: FooterBuilder,
+
+  // Global styles operations
+  [BUILDER_TYPES.UPDATE_GLOBAL_STYLES]: GlobalStylesBuilder,
+
+  // Header operations
+  [BUILDER_TYPES.UPDATE_HEADER]: HeaderBuilder,
+
+  // Website-level operations
+  [BUILDER_TYPES.UNDO_WEBSITE]: UndoBuilder,
 });
 
 let builderRegistry: Record<BuilderType, BuilderConstructor> | null = null;
@@ -107,6 +130,7 @@ let builderRegistry: Record<BuilderType, BuilderConstructor> | null = null;
 const resolveBuilder = (
   request: MetadataBuilderRequest,
   logger?: Logger,
+  eventTracker?: EventTracker,
 ): BaseMetadataBuilder | null => {
   if (!builderRegistry) {
     builderRegistry = getBuilderRegistry();
@@ -120,7 +144,7 @@ const resolveBuilder = (
     return null;
   }
 
-  return new BuilderClass(request, logger);
+  return new BuilderClass(request, logger, eventTracker);
 };
 
 export class MetadataExecutor {
@@ -128,13 +152,14 @@ export class MetadataExecutor {
     metadata: BrandPageModel,
     requests: MetadataBuilderRequest[],
     logger?: Logger,
+    eventTracker?: EventTracker,
   ): Promise<MetadataExecutorResult> {
     let model = cloneDeep(metadata);
 
     const results: BuilderResult[] = [];
 
     for (const request of requests) {
-      const builder = resolveBuilder(request, logger);
+      const builder = resolveBuilder(request, logger, eventTracker);
 
       if (!builder) {
         results.push({
@@ -148,6 +173,21 @@ export class MetadataExecutor {
 
       const result = await builder.buildAsync(model);
 
+      // Surface the section's resolved content id on the result. The AI-chat
+      // retry path uses this to fill its vacant-slot tracker so a previously
+      // failed CREATE can re-enter its planned position on the page. Done at
+      // the executor level so individual builders don't have to remember to
+      // populate the field on every code path.
+      const resolveContentId = (
+        builder as { getResolvedContentId?: () => string | undefined }
+      ).getResolvedContentId?.bind(builder);
+
+      if (resolveContentId && !result.contentId) {
+        const cid = resolveContentId();
+
+        if (cid) result.contentId = cid;
+      }
+
       results.push(result);
 
       model = result.model;

package/src/metadata-builder/models.ts

@@ -1,4 +1,5 @@
 import { type BrandPageModel } from '../brand-page/models';
+import type { EventTracker } from '../brand-page-maker/composables/useEventTracker';
 import type { Logger } from './logger';
 
 export const BUILDER_TYPES = {
@@ -30,6 +31,7 @@ export const BUILDER_TYPES = {
   CREATE_PINTEREST: 'create-pinterest',
   CREATE_TWITCH: 'create-twitch',
   CREATE_TIKTOK: 'create-tiktok',
+  CREATE_BOOKING_SECTION: 'create-booking-section',
 
   // Per-section builder types (update)
   UPDATE_BANNER_SECTION: 'update-banner-section',
@@ -56,6 +58,7 @@ export const BUILDER_TYPES = {
   UPDATE_PINTEREST: 'update-pinterest',
   UPDATE_TWITCH: 'update-twitch',
   UPDATE_TIKTOK: 'update-tiktok',
+  UPDATE_BOOKING_SECTION: 'update-booking-section',
 
   // Section-level operations
   DELETE_SECTION: 'delete-section',
@@ -64,6 +67,19 @@ export const BUILDER_TYPES = {
   // Page-level operations
   ADD_PAGE: 'add-page',
   REMOVE_PAGE: 'remove-page',
+  RENAME_PAGE: 'rename-page',
+
+  // Footer operations
+  UPDATE_FOOTER: 'update-footer',
+
+  // Global styles operations
+  UPDATE_GLOBAL_STYLES: 'update-global-styles',
+
+  // Header operations
+  UPDATE_HEADER: 'update-header',
+
+  // Website-level operations
+  UNDO_WEBSITE: 'undo-website',
 } as const;
 
 export type BuilderType = (typeof BUILDER_TYPES)[keyof typeof BUILDER_TYPES];
@@ -88,15 +104,37 @@ export interface BuilderResult {
   request: MetadataBuilderRequest;
   model: BrandPageModel;
   errors?: string[];
+  /**
+   * Set by the UndoBuilder to signal that the caller should restore the
+   * website to the snapshot taken before the most recent change-producing
+   * prompt. The model returned alongside this flag is unchanged — the actual
+   * snapshot restore happens outside this library.
+   */
+  undoRequested?: boolean;
+  /**
+   * The frontend-assigned content ID of the section this builder created or
+   * updated. Populated for section CREATE flows so callers can anchor
+   * downstream operations (notably the AI retry path's vacant-slot tracking)
+   * to the resolved content. Undefined on failure, on non-section builders
+   * (page-level ops, undo), and on builders that don't touch a single
+   * content (e.g. global-styles).
+   */
+  contentId?: string;
 }
 
 export abstract class BaseMetadataBuilder<T = unknown> {
   protected request: MetadataBuilderRequest<T>;
   protected logger?: Logger;
+  protected eventTracker?: EventTracker;
 
-  constructor(request: MetadataBuilderRequest<T>, logger?: Logger) {
+  constructor(
+    request: MetadataBuilderRequest<T>,
+    logger?: Logger,
+    eventTracker?: EventTracker,
+  ) {
     this.request = request;
     this.logger = logger;
+    this.eventTracker = eventTracker;
   }
 
   abstract validateAsync(): Promise<{

package/src/metadata-builder/parsers/ai-toolcall-parser.ts

@@ -1,4 +1,9 @@
 import type { AiAssistantToolCall } from '../../clients/ai-assistant-client';
+import type {
+  FooterDisplayStyle,
+  HeaderDisplayStyle,
+  NavigationDisplayType,
+} from '../../brand-page/constants';
 import type { SectionType } from './section-tool-arguments';
 
 // Tool names — must match the function names generated by the AI pipeline.
@@ -37,6 +42,7 @@ export const AI_ASSISTANT_TOOL_NAMES = {
   BUILD_SHAPES_SECTION: 'build_shapes-section_section',
   BUILD_TESTIMONIAL_SECTION: 'build_testimonial-section_section',
   BUILD_DIVIDER_SECTION: 'build_divider-section_section',
+  BUILD_BOOKING_SECTION: 'build_booking-section_section',
 
   // Section-level operation tools
   DELETE_SECTION: 'delete_section',
@@ -45,6 +51,23 @@ export const AI_ASSISTANT_TOOL_NAMES = {
   // Page-level operation tools
   ADD_PAGE: 'add_page',
   REMOVE_PAGE: 'remove_page',
+  RENAME_PAGE: 'rename_page',
+
+  // Footer operation tools
+  UPDATE_FOOTER: 'update_footer',
+
+  // Global styles operation tools
+  UPDATE_GLOBAL_STYLES: 'tool_update_global_styles',
+
+  // Header operation tools
+  UPDATE_HEADER: 'update_header',
+
+  // Website-level operations
+  // `undo` restores the website to the snapshot taken before the most recent
+  // change-producing prompt. The actual snapshot restore is performed outside
+  // this library — the library only recognizes the tool call and signals the
+  // request via BuilderResult.undoRequested.
+  UNDO: 'undo',
 } as const;
 
 export type AiAssistantToolName =
@@ -135,6 +158,9 @@ export const SECTION_TOOL_MAP: Record<string, { sectionType: SectionType }> = {
   [AI_ASSISTANT_TOOL_NAMES.BUILD_DIVIDER_SECTION]: {
     sectionType: 'divider-section',
   },
+  [AI_ASSISTANT_TOOL_NAMES.BUILD_BOOKING_SECTION]: {
+    sectionType: 'booking-section',
+  },
 };
 
 export interface DeleteSectionArguments {
@@ -156,6 +182,132 @@ export interface RemovePageArguments {
   page_id: string;
 }
 
+export interface RenamePageArguments {
+  page_id: string;
+  page_name: string;
+}
+
+export interface ReorderPagesArguments {
+  page_order: string[];
+}
+
+/**
+ * Arguments for the `undo` tool call.
+ *
+ * Empty by design: the snapshot to restore is determined externally (it's the
+ * snapshot taken before the most recent change-producing prompt). The library
+ * does not own snapshot persistence.
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface UndoArguments {}
+
+export interface FooterSocialLinkItem {
+  item_index?: number;
+  insert_at?: number;
+  social_link_icon?: string;
+  url?: string;
+}
+
+/**
+ * Per-viewport field overrides for a single update_footer call with viewport='both'.
+ * Fields set here take precedence over the top-level value for that specific viewport.
+ */
+export interface ViewportFooterOverrides {
+  display_style?: FooterDisplayStyle;
+  background_color?: string | null;
+  copyright_text_color?: string;
+  icon_color?: string;
+  is_logo_visible?: boolean;
+  logo_image_height?: string;
+  logo_image_width?: string;
+}
+
+export interface UpdateFooterArguments {
+  copyright_text?: string;
+  copyright_text_font_family?: string;
+  social_links?: FooterSocialLinkItem[];
+  _replace_social_links?: boolean;
+  _remove_social_link_indices?: number[];
+  _reorder_social_links?: number[];
+  /** Desktop-only styling (display_style, background_color, icon_color, is_logo_visible, logo sizes). */
+  desktop?: ViewportFooterOverrides;
+  /** Mobile-only styling (display_style, background_color, icon_color, is_logo_visible, logo sizes). */
+  mobile?: ViewportFooterOverrides;
+}
+
+export interface TextStyleOptionStyle {
+  fontFamily?: string;
+  fontSize?: string;
+  letterSpacing?: string;
+  lineHeight?: string;
+  fontWeight?: string;
+  fontStyle?: string;
+  textDecoration?: string;
+  color?: string;
+}
+
+export interface UpdateGlobalStylesArguments {
+  backgroundStyles?: {
+    style?: { background?: string };
+    /** Site background color in hex → sets style.background */
+    backgroundColor?: string;
+    /** Background shape/accent color in hex → sets backgroundShapeStyle.background */
+    shapeColor?: string;
+    /** Background image URL ('' clears the image) → sets backgroundImageUrl */
+    backgroundImageUrl?: string;
+    /** Background shape SVG URL ('' clears shapes) → updates backgroundShapes[0].name. No-op if backgroundShapes is empty. */
+    backgroundShapeUrl?: string;
+  };
+  textStyles?: {
+    style?: { color?: string };
+    textFontFamily?: string;
+    textStyleOptions?: {
+      titles?: { style?: TextStyleOptionStyle; isModified?: boolean };
+      headings?: { style?: TextStyleOptionStyle; isModified?: boolean };
+      paragraphs?: { style?: TextStyleOptionStyle; isModified?: boolean };
+      buttons?: { style?: TextStyleOptionStyle; isModified?: boolean };
+    };
+  };
+  buttonStyles?: {
+    style?: { color?: string; borderColor?: string; backgroundColor?: string };
+    iconStyle?: { fill?: string };
+    selectedButtonStyleId?: string;
+  };
+}
+
+export interface UpdateHeaderNavRoute {
+  route_index?: number;
+  display_name?: string;
+}
+
+export interface ViewportHeaderOverrides {
+  display_style?: HeaderDisplayStyle;
+  background_color?: string | null;
+  is_logo_visible?: boolean;
+  logo_image_height?: string;
+  logo_image_width?: string;
+  nav_display_type?: NavigationDisplayType;
+  link_text_color?: string;
+  link_text_font?: string;
+  link_bg_color?: string | null;
+  link_default_border_color?: string | null;
+  link_selected_color?: string;
+  link_selected_bg_color?: string | null;
+  link_selected_border_color?: string;
+  hamburger_icon_color?: string;
+  hamburger_icon_bg_color?: string | null;
+  overlay_default_text_color?: string | null;
+  overlay_default_bg_color?: string | null;
+  overlay_selected_text_color?: string | null;
+  overlay_selected_bg_color?: string | null;
+}
+
+export interface UpdateHeaderArguments {
+  nav_routes?: UpdateHeaderNavRoute[];
+  desktop?: ViewportHeaderOverrides;
+  mobile?: ViewportHeaderOverrides;
+}
+
 export const parseToolCalls = (
   toolCalls: AiAssistantToolCall[],
 ): ParsedToolCall[] => {