@designcrowd/library.brand-page 5.17.28 → 5.18.0

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

@@ -18,8 +18,7 @@ type UnsupportedContentType =
   | 'map'
   | 'request-payment'
   | 'support-me'
-  | 'shop-section'
-  | 'booking-section';
+  | 'shop-section';
 
 export type SectionType = Exclude<ContentType, UnsupportedContentType>;
 
@@ -27,6 +26,60 @@ export type SectionType = Exclude<ContentType, UnsupportedContentType>;
 // Shared style type (matches TEXT_STYLE_SCHEMA in section_schemas.py)
 // ---------------------------------------------------------------------------
 
+// ---------------------------------------------------------------------------
+// Tiptap JSON (ProseMirror document model) for rich text fields
+// ---------------------------------------------------------------------------
+
+export interface TiptapMark {
+  type:
+    | 'bold'
+    | 'italic'
+    | 'underline'
+    | 'strike'
+    | 'link'
+    | 'textStyle'
+    | 'highlight';
+  attrs?: {
+    href?: string;
+    color?: string;
+    fontSize?: string;
+    fontFamily?: string;
+    letterSpacing?: string;
+    lineHeight?: string;
+  };
+}
+
+export interface TiptapTextNode {
+  type: 'text';
+  text: string;
+  marks?: TiptapMark[];
+}
+
+export interface TiptapBlockNode {
+  type: 'paragraph' | 'heading' | 'blockquote';
+  attrs?: { level?: number };
+  content?: TiptapTextNode[];
+}
+
+export interface TiptapDocument {
+  type: 'doc';
+  content: TiptapBlockNode[];
+}
+
+/** A rich text field can be plain text (string) or Tiptap JSON. */
+export type RichTextField = string | TiptapDocument;
+
+/** Type guard: checks if a value is a TiptapDocument object. */
+export const isTiptapDocument = (value: unknown): value is TiptapDocument =>
+  typeof value === 'object' &&
+  value !== null &&
+  (value as TiptapDocument).type === 'doc' &&
+  Array.isArray((value as TiptapDocument).content);
+
+// ---------------------------------------------------------------------------
+// Shared style type (matches TEXT_STYLE_SCHEMA in section_schemas.py)
+// ---------------------------------------------------------------------------
+
 export interface TextStyleArguments {
   fontSize?: string | null;
   color?: string | null;
@@ -36,7 +89,33 @@ export interface TextStyleArguments {
   textDecoration?: string | null;
   backgroundColor?: string | null;
   letterSpacing?: number | null;
-  lineHeight?: number | null;
+  lineHeight?: string | null;
+  fontFamily?: string | null;
+}
+
+/**
+ * Style schema for button label text. Narrower than `TextStyleArguments`:
+ * `backgroundColor` is excluded because a button label has no meaningful
+ * background (the button fill behind the label is set at the site level).
+ *
+ * `color` IS included — the brand-page renderer reads
+ * `section.button_text_style.color` for label paint. The VALUE is the
+ * site-level DECISION (`site.button-text` in the AI's color_spec), but
+ * the APPLICATION is per-section: every section's tool call writes the
+ * same site-decided hex into this field.
+ *
+ * See `ai-pipelines/src/agents/website/tools/section_types_tool.py`
+ * (`_button_text_style_field`) for the AI-side mirror.
+ */
+export interface ButtonTextStyleArguments {
+  color?: string | null;
+  fontSize?: string | null;
+  fontWeight?: string | null;
+  fontStyle?: string | null;
+  textAlign?: string | null;
+  textDecoration?: string | null;
+  letterSpacing?: number | null;
+  lineHeight?: string | null;
   fontFamily?: string | null;
 }
 
@@ -55,9 +134,9 @@ export interface CardStyleArguments {
 // ---------------------------------------------------------------------------
 
 export interface ProfileSectionArguments {
-  name?: string;
-  title?: string;
-  description?: string;
+  name?: RichTextField;
+  title?: RichTextField;
+  description?: RichTextField;
   avatar_image_url?: string;
   background_color?: string | null;
 }
@@ -67,13 +146,13 @@ export interface TextSectionItem {
   item_index?: number;
   /** 0-based position to insert a new item at */
   insert_at?: number;
-  text?: string;
+  text?: RichTextField;
   text_style?: TextStyleArguments;
 }
 
 export interface TextSectionArguments {
   /** Single text field (BrandPage/BrandContact or shorthand for first item) */
-  text?: string;
+  text?: RichTextField;
   text_style?: TextStyleArguments;
   /** Number of columns ('1'–'4') for multi-block text layouts */
   column_style?: '1' | '2' | '3' | '4';
@@ -104,6 +183,7 @@ export interface ImageGalleryItem {
 export interface ImageGallerySectionArguments {
   images?: ImageGalleryItem[];
   gallery_type?: 'grid' | 'carousel' | 'masonry';
+  is_full_width?: boolean;
   _replace_items?: boolean;
   /** 0-based indices of items to remove */
   _remove_item_indices?: number[];
@@ -195,6 +275,10 @@ export interface SocialLink {
 export interface SocialLinksSectionArguments {
   links?: SocialLink[];
   icon_style?: 'none' | 'square' | 'circle';
+  /** Style for the social-icon SVG fill (filled from the palette by the slot router). */
+  icon_fill_style?: TextStyleArguments;
+  /** Style for the icon container background (used when icon_style is 'square' or 'circle'). */
+  icon_background_style?: TextStyleArguments;
   _replace_items?: boolean;
   /** 0-based indices of items to remove */
   _remove_item_indices?: number[];
@@ -203,8 +287,11 @@ export interface SocialLinksSectionArguments {
 }
 
 export interface MailingListSectionArguments {
-  title?: string;
+  title?: RichTextField;
   button_text?: string;
+  accepted_fields?: 'emailOnly' | 'nameAndEmail';
+  title_style?: TextStyleArguments;
+  button_text_style?: ButtonTextStyleArguments;
 }
 
 export interface ContactFormFieldToggle {
@@ -215,10 +302,10 @@ export interface ContactFormFieldToggle {
 }
 
 export interface ContactFormSectionArguments {
-  title?: string;
-  description?: string;
+  title?: RichTextField;
+  description?: RichTextField;
   button_text?: string;
-  success_message?: string;
+  success_message?: RichTextField;
   response_email?: string;
   header_image_url?: string;
   display_style?: 'preview' | 'collapsed';
@@ -231,18 +318,23 @@ export interface ContactFormSectionArguments {
     | 'right-aligned-full-image';
   title_style?: TextStyleArguments;
   description_style?: TextStyleArguments;
-  button_text_style?: TextStyleArguments;
+  success_message_style?: TextStyleArguments;
+  button_text_style?: ButtonTextStyleArguments;
   /** Toggle visibility of form fields */
   fields?: ContactFormFieldToggle[];
   background_color?: string | null;
+  card_style?: CardStyleArguments;
 }
 
 export interface BannerSectionArguments {
-  title?: string;
-  description?: string;
+  title?: RichTextField;
+  description?: RichTextField;
   button_text?: string;
+  button_link_type?: 'url' | 'page' | 'mailTo' | 'tel';
   button_url?: string;
   background_image_url?: string;
+  background_shape_url?: string;
+  color_theme?: string;
   display_style?:
     | 'left-aligned'
     | 'right-aligned'
@@ -255,14 +347,17 @@ export interface BannerSectionArguments {
     | 'left-card-aligned-image';
   title_style?: TextStyleArguments;
   description_style?: TextStyleArguments;
-  button_text_style?: TextStyleArguments;
+  button_text_style?: ButtonTextStyleArguments;
   background_color?: string | null;
+  card_style?: CardStyleArguments;
 }
 
 export interface AboutSectionArguments {
-  title?: string;
-  paragraph?: string;
+  title?: RichTextField;
+  paragraph?: RichTextField;
   about_image_url?: string;
+  about_shape_url?: string;
+  color_theme?: string;
   display_style?:
     | 'left-aligned'
     | 'right-aligned'
@@ -287,8 +382,8 @@ export interface ImagesSectionItem {
 }
 
 export interface ImagesSectionArguments {
-  title?: string;
-  description?: string;
+  title?: RichTextField;
+  description?: RichTextField;
   items?: ImagesSectionItem[];
   display_style?:
     | 'left-aligned'
@@ -306,6 +401,7 @@ export interface ImagesSectionArguments {
   description_style?: TextStyleArguments;
   heading_style?: TextStyleArguments;
   paragraph_style?: TextStyleArguments;
+  button_text_style?: ButtonTextStyleArguments;
   aspect_ratio?: string;
   are_images_full_width?: boolean;
   background_style?: BackgroundStyleArguments;
@@ -321,10 +417,12 @@ export interface TestimonialItem {
   name?: string;
   position?: string;
   avatar_image_url?: string;
+  avatar_shape_url?: string;
+  color_theme?: string;
 }
 
 export interface TestimonialSectionArguments {
-  title?: string;
+  title?: RichTextField;
   items?: TestimonialItem[];
   display_style?: 'centered' | 'big-image' | 'columns';
   _replace_items?: boolean;
@@ -347,14 +445,14 @@ export interface ShapesSectionItem {
   insert_at?: number;
   icon_image_url?: string;
   shape_url?: string;
-  keep_color?: boolean;
+  color_theme?: string;
   heading?: string;
   text?: string;
 }
 
 export interface ShapesSectionArguments {
-  title?: string;
-  description?: string;
+  title?: RichTextField;
+  description?: RichTextField;
   items?: ShapesSectionItem[];
   display_style?:
     | 'left-aligned'
@@ -377,9 +475,23 @@ export interface ShapesSectionArguments {
   card_style?: CardStyleArguments;
 }
 
+export interface BookingSectionArguments {
+  title?: RichTextField;
+  description?: RichTextField;
+  button_text?: string;
+  button_link_type?: 'url' | 'page' | 'mailTo' | 'tel';
+  button_url?: string;
+  title_style?: TextStyleArguments;
+  description_style?: TextStyleArguments;
+  button_text_style?: ButtonTextStyleArguments;
+  background_color?: string | null;
+}
+
 export interface DividerSectionArguments {
   divider_style?: 'none' | 'thin' | 'thick';
+  divider_color?: string | null;
   background_color?: string | null;
+  padding?: number;
 }
 
 // ---------------------------------------------------------------------------
@@ -411,6 +523,7 @@ export type SectionToolArguments =
   | ImagesSectionArguments
   | TestimonialSectionArguments
   | ShapesSectionArguments
+  | BookingSectionArguments
   | DividerSectionArguments;
 
 // ---------------------------------------------------------------------------
@@ -422,5 +535,6 @@ export interface SectionToolCallShape {
   type: string;
   content_id?: string;
   page_id?: string;
+  move_before_content_id?: string;
   arguments: SectionToolArguments;
 }