@designcrowd/library.brand-page 6.2.11 → 6.2.12

package/src/metadata-builder/builders/section-builders/booking-section-builder.ts

@@ -12,7 +12,7 @@ import {
   applyButtonLink,
   applyScalarFields,
   applyStyleFields,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
 } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateBookingSection } from '../section-rules/booking-section.rules';
@@ -51,8 +51,9 @@ export class BookingSectionBuilder extends BaseSectionBuilder<BookingSectionCont
     if (bookingArgs.title !== undefined) {
       if (isTiptapDocument(bookingArgs.title)) {
         resolved.content.title = bookingArgs.title;
-        resolved.content.titleStyle = resolveGlobalPresetIntoStyle(
+        resolved.content.titleStyle = applyAiStyle(
           resolved.content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {
@@ -63,8 +64,9 @@ export class BookingSectionBuilder extends BaseSectionBuilder<BookingSectionCont
     if (bookingArgs.description !== undefined) {
       if (isTiptapDocument(bookingArgs.description)) {
         resolved.content.description = bookingArgs.description;
-        resolved.content.descriptionStyle = resolveGlobalPresetIntoStyle(
+        resolved.content.descriptionStyle = applyAiStyle(
           resolved.content.descriptionStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/contact-form-builder.ts

@@ -11,7 +11,7 @@ import type { BuilderResult } from '../../models';
 import {
   applyScalarFields,
   applyStyleFields,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
 } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateContactForm } from '../section-rules/contact-form.rules';
@@ -50,8 +50,9 @@ export class ContactFormBuilder extends BaseSectionBuilder<ContactFormContent> {
     if (args.title !== undefined) {
       if (isTiptapDocument(args.title)) {
         content.title = args.title;
-        content.titleStyle = resolveGlobalPresetIntoStyle(
+        content.titleStyle = applyAiStyle(
           content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {
@@ -62,8 +63,9 @@ export class ContactFormBuilder extends BaseSectionBuilder<ContactFormContent> {
     if (args.description !== undefined) {
       if (isTiptapDocument(args.description)) {
         content.description = args.description;
-        content.descriptionStyle = resolveGlobalPresetIntoStyle(
+        content.descriptionStyle = applyAiStyle(
           content.descriptionStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {
@@ -74,8 +76,9 @@ export class ContactFormBuilder extends BaseSectionBuilder<ContactFormContent> {
     if (args.success_message !== undefined) {
       if (isTiptapDocument(args.success_message)) {
         content.successMessage = args.success_message;
-        content.successMessageStyle = resolveGlobalPresetIntoStyle(
+        content.successMessageStyle = applyAiStyle(
           content.successMessageStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/images-section-builder.ts

@@ -13,7 +13,7 @@ import {
   applyScalarFields,
   applyStyleFields,
   isValidUrl,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
 } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateImagesSection } from '../section-rules/images-section.rules';
@@ -142,8 +142,9 @@ export class ImagesSectionBuilder extends BaseSectionBuilder<ImagesSectionConten
     if (args.title !== undefined) {
       if (isTiptapDocument(args.title)) {
         content.title = args.title;
-        content.titleStyle = resolveGlobalPresetIntoStyle(
+        content.titleStyle = applyAiStyle(
           content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {
@@ -154,8 +155,9 @@ export class ImagesSectionBuilder extends BaseSectionBuilder<ImagesSectionConten
     if (args.description !== undefined) {
       if (isTiptapDocument(args.description)) {
         content.description = args.description;
-        content.descriptionStyle = resolveGlobalPresetIntoStyle(
+        content.descriptionStyle = applyAiStyle(
           content.descriptionStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/mailing-list-builder.ts

@@ -11,7 +11,7 @@ import {
 import {
   applyScalarFields,
   applyStyleFields,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
 } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateMailingList } from '../section-rules/mailing-list.rules';
@@ -50,8 +50,9 @@ export class MailingListBuilder extends BaseSectionBuilder<MailingListContent> {
     if (mailingListArgs.title !== undefined) {
       if (isTiptapDocument(mailingListArgs.title)) {
         content.title = mailingListArgs.title;
-        content.titleStyle = resolveGlobalPresetIntoStyle(
+        content.titleStyle = applyAiStyle(
           content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/mailing-list-section-builder.ts

@@ -11,7 +11,7 @@ import {
 import {
   applyScalarFields,
   applyStyleFields,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
 } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateMailingList } from '../section-rules/mailing-list.rules';
@@ -48,8 +48,9 @@ export class MailingListSectionBuilder extends BaseSectionBuilder<MailingListCon
     if (mailingListArgs.title !== undefined) {
       if (isTiptapDocument(mailingListArgs.title)) {
         resolved.content.title = mailingListArgs.title;
-        resolved.content.titleStyle = resolveGlobalPresetIntoStyle(
+        resolved.content.titleStyle = applyAiStyle(
           resolved.content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/profile-section-builder.ts

@@ -8,10 +8,7 @@ import {
   isTiptapDocument,
   type ProfileSectionArguments,
 } from '../../parsers/section-tool-arguments';
-import {
-  applyScalarFields,
-  resolveGlobalPresetIntoStyle,
-} from '../section-field-utils';
+import { applyScalarFields, applyAiStyle } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateProfile } from '../section-rules/profile.rules';
 
@@ -41,8 +38,9 @@ export class ProfileSectionBuilder extends BaseSectionBuilder<ProfileContent> {
     if (profileArgs.name !== undefined) {
       if (isTiptapDocument(profileArgs.name)) {
         resolved.content.name = profileArgs.name;
-        resolved.content.nameStyle = resolveGlobalPresetIntoStyle(
+        resolved.content.nameStyle = applyAiStyle(
           resolved.content.nameStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {
@@ -53,8 +51,9 @@ export class ProfileSectionBuilder extends BaseSectionBuilder<ProfileContent> {
     if (profileArgs.title !== undefined) {
       if (isTiptapDocument(profileArgs.title)) {
         resolved.content.title = profileArgs.title;
-        resolved.content.titleStyle = resolveGlobalPresetIntoStyle(
+        resolved.content.titleStyle = applyAiStyle(
           resolved.content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {
@@ -65,8 +64,9 @@ export class ProfileSectionBuilder extends BaseSectionBuilder<ProfileContent> {
     if (profileArgs.description !== undefined) {
       if (isTiptapDocument(profileArgs.description)) {
         resolved.content.description = profileArgs.description;
-        resolved.content.descriptionStyle = resolveGlobalPresetIntoStyle(
+        resolved.content.descriptionStyle = applyAiStyle(
           resolved.content.descriptionStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/shapes-section-builder.ts

@@ -14,7 +14,7 @@ import {
 import {
   applyScalarFields,
   applyStyleFields,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
 } from '../section-field-utils';
 import {
   applyColorThemeToReplacements,
@@ -195,8 +195,9 @@ export class ShapesSectionBuilder extends BaseSectionBuilder<ShapesSectionConten
     if (args.title !== undefined) {
       if (isTiptapDocument(args.title)) {
         content.title = args.title;
-        content.titleStyle = resolveGlobalPresetIntoStyle(
+        content.titleStyle = applyAiStyle(
           content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {
@@ -207,8 +208,9 @@ export class ShapesSectionBuilder extends BaseSectionBuilder<ShapesSectionConten
     if (args.description !== undefined) {
       if (isTiptapDocument(args.description)) {
         content.description = args.description;
-        content.descriptionStyle = resolveGlobalPresetIntoStyle(
+        content.descriptionStyle = applyAiStyle(
           content.descriptionStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/social-links-builder.test.ts

@@ -46,10 +46,10 @@ describe('social-links style field map', () => {
     expect(map?.icon_background_style).toBe('iconBackgroundStyles');
   });
 
-  it('does NOT map a title_style entry (out of scope this turn)', () => {
+  it('maps title_style → titleStyle', () => {
     const map = getStyleFieldMap('social-links');
 
-    expect(map?.title_style).toBeUndefined();
+    expect(map?.title_style).toBe('titleStyle');
   });
 });
 

package/src/metadata-builder/builders/section-builders/social-links-builder.ts

@@ -2,12 +2,17 @@ import type {
   SocialLinksContent,
   BrandPageModel,
 } from '../../../brand-page/models';
-import type {
-  SocialLink,
-  SocialLinksSectionArguments,
+import {
+  isTiptapDocument,
+  type SocialLink,
+  type SocialLinksSectionArguments,
 } from '../../parsers/section-tool-arguments';
 import type { BuilderResult } from '../../models';
-import { applyScalarFields, applyStyleFields } from '../section-field-utils';
+import {
+  applyAiStyle,
+  applyScalarFields,
+  applyStyleFields,
+} from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateSocialLinks } from '../section-rules/social-links.rules';
 import {
@@ -105,16 +110,22 @@ export class SocialLinksBuilder extends BaseSectionBuilder<SocialLinksContent> {
 
     const content = resolved.content;
 
+    const textStyleOptions = this.getGlobalTextStyles(model);
+
     applyScalarFields(content, this.args, this.sectionType);
-    applyStyleFields(
-      content,
-      this.args,
-      this.sectionType,
-      this.getGlobalTextStyles(model),
-    );
+    applyStyleFields(content, this.args, this.sectionType, textStyleOptions);
 
     const args = this.args as SocialLinksSectionArguments;
 
+    if (isTiptapDocument(args.title)) {
+      content.title = args.title;
+      content.titleStyle = applyAiStyle(
+        content.titleStyle,
+        {},
+        textStyleOptions,
+      );
+    }
+
     if (args._replace_items && args.links && Array.isArray(args.links)) {
       // Full replacement: discard existing links and rebuild from the payload.
       applySocialLinks(content, args.links);

package/src/metadata-builder/builders/section-builders/support-me-builder.test.ts

@@ -68,6 +68,16 @@ describe('SupportMeBuilder — create', () => {
     expect(created.supportMeConfig.paymentOptions.length).toBeGreaterThan(0);
   });
 
+  it('starts the success message on Paragraph 2, its own role', async () => {
+    const { model: out } = await create({}, makeModel());
+
+    const created = out.pages[0].contents[0] as SupportMeContent;
+
+    expect(created.successMessageStyle).toEqual({
+      textStyleType: 'paragraph2',
+    });
+  });
+
   it('applies AI-provided scalar fields over the defaults', async () => {
     const model = makeModel();
 

package/src/metadata-builder/builders/section-builders/testimonial-section-builder.ts

@@ -13,7 +13,7 @@ import type { BuilderResult } from '../../models';
 import {
   applyScalarFields,
   applyStyleFields,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
 } from '../section-field-utils';
 import {
   applyColorThemeToReplacements,
@@ -173,8 +173,9 @@ export class TestimonialSectionBuilder extends BaseSectionBuilder<TestimonialSec
     if (args.title !== undefined) {
       if (isTiptapDocument(args.title)) {
         content.title = args.title;
-        content.titleStyle = resolveGlobalPresetIntoStyle(
+        content.titleStyle = applyAiStyle(
           content.titleStyle,
+          {},
           textStyleOptions,
         ) as TextStyleDeclaration;
       } else {

package/src/metadata-builder/builders/section-builders/text-section-builder.ts

@@ -15,7 +15,9 @@ import {
 import {
   applyScalarFields,
   applyStyleFields,
-  resolveGlobalPresetIntoStyle,
+  applyAiStyle,
+  applyStoredDocStyleConsequences,
+  normalizeStyleValue,
 } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateTextSection } from '../section-rules/text-section.rules';
@@ -40,37 +42,30 @@ const resolveText = (
   return { value: typeof value === 'string' ? value : '', wasTiptap: false };
 };
 
-const clearTextStyleTypeIfTiptap = (
-  style: TextStyleDeclaration,
-  wasTiptap: boolean,
-  textStyleOptions: TextStyleOptions | undefined,
-): TextStyleDeclaration =>
-  wasTiptap
-    ? (resolveGlobalPresetIntoStyle(
-        style,
-        textStyleOptions,
-      ) as TextStyleDeclaration)
-    : style;
-
 const createTextItem = (
   item: TextSectionItem,
   baseStyle: TextStyleDeclaration,
   textStyleOptions: TextStyleOptions | undefined,
 ): TextItem => {
-  const textStyle = (
-    item.text_style ? { ...baseStyle, ...item.text_style } : { ...baseStyle }
-  ) as TextStyleDeclaration;
-
   const { value, wasTiptap } = resolveText(item.text);
+  const incoming = normalizeIncomingStyle(
+    (item.text_style ?? {}) as Record<string, unknown>,
+  );
+
+  // RTE text: role-aware apply (keep a named role + sparse override, else resolve-and-detach).
+  // Plain text: the section-level style still drives it, so a straight merge.
+  const textStyle = wasTiptap
+    ? (applyAiStyle(
+        baseStyle,
+        incoming,
+        textStyleOptions,
+      ) as TextStyleDeclaration)
+    : ({ ...baseStyle, ...incoming } as TextStyleDeclaration);
 
   return {
     id: item.item_id || generateItemId(),
     text: value,
-    textStyle: clearTextStyleTypeIfTiptap(
-      textStyle,
-      wasTiptap,
-      textStyleOptions,
-    ),
+    textStyle,
   };
 };
 
@@ -88,6 +83,58 @@ const applyTextItems = (
   );
 };
 
+/**
+ * Run every item-level style value through `normalizeStyleValue` (letterSpacing 0-100 → em string,
+ * lineHeight → a plain numeric string, null → clear), same as the section-level `applyStyleFields`
+ * path does. Items are a separate hand-rolled path with three AI-facing entry points
+ * (`createTextItem`, the text+style update branch, the style-only patch); without this, a raw
+ * `item.text_style` merge would store e.g. `letterSpacing: 10` as the bare number 10.
+ */
+const normalizeIncomingStyle = (
+  style: Record<string, unknown>,
+): Record<string, unknown> => {
+  const normalized: Record<string, unknown> = {};
+
+  for (const [k, v] of Object.entries(style)) {
+    const value = normalizeStyleValue(k, v);
+
+    if (value !== undefined) normalized[k] = value;
+  }
+
+  return normalized;
+};
+
+/**
+ * A style-only patch (no new text in this call) on one stored item: role-aware apply (R19's
+ * reset-on-switch), then the same stored-doc consequences a section-level style field gets (R18's
+ * recolour, R19's relink) — items are a separate hand-rolled path, so they need the same field
+ * helper as `applyStyleFields`. Shared by the id-based merge and the single-field shorthand, so
+ * neither raw-merges `text_style` into item 0 on its own.
+ */
+const applyItemStyleOnlyPatch = (
+  item: TextItem,
+  textStyle: Record<string, unknown>,
+  textStyleOptions: TextStyleOptions | undefined,
+): void => {
+  const existingStyle = item.textStyle as Record<string, unknown> | undefined;
+  const existingRole = existingStyle?.textStyleType;
+  const incoming = normalizeIncomingStyle(textStyle);
+
+  item.textStyle = applyAiStyle(
+    existingStyle,
+    incoming,
+    textStyleOptions,
+  ) as TextStyleDeclaration;
+
+  item.text = applyStoredDocStyleConsequences(
+    item.text,
+    existingRole,
+    item.textStyle as unknown as Record<string, unknown>,
+    incoming,
+    textStyleOptions,
+  ) as RichTextValue;
+};
+
 /**
  * Id-based merge (BP-5603): mirrors the section-level id contract one level
  * deeper.
@@ -118,22 +165,29 @@ const mergeTextItems = (
 
       if (item.text !== undefined) {
         const { value, wasTiptap } = resolveText(item.text);
+        const incoming = normalizeIncomingStyle(
+          (item.text_style ?? {}) as Record<string, unknown>,
+        );
 
         existing.text = value;
-        existing.textStyle = clearTextStyleTypeIfTiptap(
-          existing.textStyle || {},
-          wasTiptap,
+        existing.textStyle = wasTiptap
+          ? (applyAiStyle(
+              existing.textStyle || {},
+              incoming,
+              textStyleOptions,
+            ) as TextStyleDeclaration)
+          : ({
+              ...(existing.textStyle || {}),
+              ...incoming,
+            } as TextStyleDeclaration);
+      } else if (item.text_style && typeof item.text_style === 'object') {
+        applyItemStyleOnlyPatch(
+          existing,
+          item.text_style as Record<string, unknown>,
           textStyleOptions,
         );
       }
 
-      if (item.text_style && typeof item.text_style === 'object') {
-        existing.textStyle = {
-          ...(existing.textStyle || {}),
-          ...item.text_style,
-        } as TextStyleDeclaration;
-      }
-
       repositionItemByAnchor(
         content.textItems!,
         existing,
@@ -165,32 +219,32 @@ const applySingleTextField = (
   args: TextSectionArguments,
   textStyleOptions: TextStyleOptions | undefined,
 ): void => {
+  const incoming = normalizeIncomingStyle(
+    (args.text_style ?? {}) as Record<string, unknown>,
+  );
+
   if (args.text !== undefined) {
     const { value, wasTiptap } = resolveText(args.text);
-
-    if (Array.isArray(content.textItems) && content.textItems.length > 0) {
-      content.textItems[0] = {
-        ...content.textItems[0],
+    const hasItem =
+      Array.isArray(content.textItems) && content.textItems.length > 0;
+    const base = hasItem
+      ? content.textItems![0].textStyle || {}
+      : { ...(content.textStyle || {}) };
+    const textStyle = wasTiptap
+      ? (applyAiStyle(base, incoming, textStyleOptions) as TextStyleDeclaration)
+      : ({ ...base, ...incoming } as TextStyleDeclaration);
+
+    if (hasItem) {
+      content.textItems![0] = {
+        ...content.textItems![0],
         text: value,
-        textStyle: clearTextStyleTypeIfTiptap(
-          content.textItems[0].textStyle || {},
-          wasTiptap,
-          textStyleOptions,
-        ),
+        textStyle,
       };
     } else {
-      content.textItems = [
-        {
-          id: generateItemId(),
-          text: value,
-          textStyle: clearTextStyleTypeIfTiptap(
-            { ...(content.textStyle || {}) },
-            wasTiptap,
-            textStyleOptions,
-          ),
-        },
-      ];
+      content.textItems = [{ id: generateItemId(), text: value, textStyle }];
     }
+
+    return;
   }
 
   if (
@@ -199,15 +253,11 @@ const applySingleTextField = (
     Array.isArray(content.textItems) &&
     content.textItems.length > 0
   ) {
-    const mergedStyle = {
-      ...(content.textItems[0].textStyle || {}),
-      ...args.text_style,
-    } as TextStyleDeclaration;
-
-    content.textItems[0] = {
-      ...content.textItems[0],
-      textStyle: mergedStyle,
-    };
+    applyItemStyleOnlyPatch(
+      content.textItems[0],
+      args.text_style as Record<string, unknown>,
+      textStyleOptions,
+    );
   }
 };
 

package/src/metadata-builder/builders/section-field-maps.ts

@@ -283,6 +283,7 @@ const supportMeStyleFields = defineFieldMap<SupportMeContent>({
 });
 
 const socialLinksStyleFields = defineFieldMap<SocialLinksContent>({
+  title_style: 'titleStyle',
   icon_fill_style: 'iconFillStyles',
   icon_background_style: 'iconBackgroundStyles',
 });