@designcrowd/library.brand-page 6.0.26-json-prereq-2 → 6.0.27-websitev2-dev-1

package/lib/src/lib.js

@@ -30,8 +30,6 @@ export { minifyBrandPageMetadata, } from './utils/minify-brand-page-metadata';
 export * as brandPageUtils from './brand-page/utils';
 export { getOptimalLogoSize, calculateOptimizedLogoDimensions, applyLogoImageBase64UrlToBrandPageTemplateModel, recalculateLogoContentDimensions, recalculateHeaderLogoSizes, } from './brand-page/utils/logo.util';
 export { sanitizeRTEHtml } from './brand-page-maker/utils';
-// BP-5787: RTE JSON storage boundary helpers (render/normalise/sanitise/extract).
-export { renderRteToHtml, toRteJson, isTiptapDocument, sanitizeRteJson, getRteJsonPlainText, } from './brand-page-maker/utils';
 export { getPageSlugFromPageTitle } from './brand-page-maker/utils/slug.util';
 // AI-pipeline preview (longclaw per-turn snapshots): web-renderer's
 // /preview/ai-pipeline render page + manifest server route apply the agent's

package/lib/src/metadata-builder/ai-metadata-executor.d.ts

@@ -6,6 +6,7 @@ import { type MetadataExecutorResult } from './models';
 import { type ParsedToolCall } from './parsers/ai-toolcall-parser';
 export declare const executeToolCallsAsync: (metadata: BrandPageModel, toolcalls: ParsedToolCall[], options: {
     logger?: Logger;
+    maxCharacters?: number;
     /**
      * Callback invoked by the UndoBuilder at execution time to resolve the
      * pre-prompt snapshot to restore to. The library is agnostic about where

package/lib/src/metadata-builder/ai-metadata-executor.js

@@ -1,4 +1,6 @@
 import {} from '../brand-page/models';
+import { buildUpdateTextRequest } from './builders/update-content-text-builder';
+import { buildUpdateTextStyleRequest } from './builders/update-content-text-style-builder';
 import { MetadataExecutor } from './metadata-executor';
 import { BUILDER_TYPES, } from './models';
 import { AI_ASSISTANT_TOOL_NAMES, SECTION_TOOL_MAP,
@@ -9,6 +11,23 @@ export const executeToolCallsAsync = async (metadata, toolcalls, options) => {
     const requests = toolcalls
         .map((toolcall) => {
         switch (toolcall.function) {
+            case AI_ASSISTANT_TOOL_NAMES.UPDATE_TEXT: {
+                const arg = toolcall.arguments;
+                return buildUpdateTextRequest(toolcall.toolId, {
+                    contentId: arg.contentId,
+                    fieldName: arg.fieldName,
+                    newText: arg.metadata.text,
+                    maxCharacters: options.maxCharacters,
+                });
+            }
+            case AI_ASSISTANT_TOOL_NAMES.UPDATE_STYLE: {
+                const arg = toolcall.arguments;
+                return buildUpdateTextStyleRequest(toolcall.toolId, {
+                    contentId: arg.contentId,
+                    fieldName: arg.fieldName,
+                    newStyles: arg.metadata.style,
+                });
+            }
             case AI_ASSISTANT_TOOL_NAMES.DELETE_SECTION: {
                 const arg = toolcall.arguments;
                 return {

package/lib/src/metadata-builder/builders/global-font-propagation.d.ts

@@ -0,0 +1,28 @@
+import type { BrandPageModel } from '../../brand-page/models';
+import type { UpdateGlobalStylesArguments } from '../parsers/ai-toolcall-parser';
+/**
+ * Propagation of AI global font-family changes into existing section content.
+ *
+ * A `tool_update_global_styles` call merges new per-category font families into
+ * `styles.textStyles.textStyleOptions` — but only content whose style is still
+ * bound to a preset (`textStyleType`) follows that change. Template-authored
+ * content carries detached `*Style` objects AND inline `font-family` marks in
+ * its RTE HTML, both of which override the preset at render time, so a global
+ * font change was invisible on most templates (BP-5780 ISSUE-01).
+ *
+ * This module walks every page's contents and, for each text field whose
+ * resolved category received a new family, aligns the detached style object and
+ * rewrites the RTE HTML's inline font-family marks. Preset-bound styles are NOT
+ * detached — they already follow the preset; only their RTE inline marks are
+ * rewritten (the marks would otherwise still win over the preset).
+ */
+export type GlobalFontCategory = 'titles' | 'headings' | 'paragraphs' | 'buttons';
+/** Extract the per-category families this AI call actually changes. */
+export declare const collectChangedFontFamilies: (textStyles: UpdateGlobalStylesArguments["textStyles"]) => Partial<Record<GlobalFontCategory, string>>;
+export type ApplyFontToRTE = (text: string, fontFamily: string) => string;
+/**
+ * Walk every page's contents and propagate the changed families.
+ * `applyFont` is injectable for tests; the default rewrites inline marks via
+ * the external Tiptap editor.
+ */
+export declare const propagateFontFamiliesToContents: (model: BrandPageModel, changed: Partial<Record<GlobalFontCategory, string>>, applyFont?: ApplyFontToRTE) => void;

package/lib/src/metadata-builder/builders/global-font-propagation.js

@@ -0,0 +1,125 @@
+import { hasRTEContent } from '../../brand-page-maker/utils';
+import { useExternalRichTextEditor } from '../../brand-page-maker/composables/rich-text-editor/useRichTextEditor';
+import { applyStyleToRTEText } from '../helpers/rte.helpers';
+/**
+ * Default category per text field when its style is detached (no `textStyleType`).
+ * Mirrors the AI service's slot→category stamping (titles←h1, headings←h2-h4,
+ * paragraphs←body, buttons←button). `title` upgrades to `titles` on banner
+ * sections (the hero headline) via `resolveFieldCategory`.
+ */
+const FIELD_DEFAULT_CATEGORY = {
+    title: 'headings',
+    heading: 'headings',
+    name: 'headings',
+    description: 'paragraphs',
+    paragraph: 'paragraphs',
+    text: 'paragraphs',
+    testimonial: 'paragraphs',
+    position: 'paragraphs',
+    question: 'headings',
+    answer: 'paragraphs',
+    buttonText: 'buttons',
+    successMessage: 'paragraphs',
+};
+const CATEGORIES = [
+    'titles',
+    'headings',
+    'paragraphs',
+    'buttons',
+];
+const isPlainObject = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** Extract the per-category families this AI call actually changes. */
+export const collectChangedFontFamilies = (textStyles) => {
+    const changed = {};
+    if (!textStyles)
+        return changed;
+    for (const category of CATEGORIES) {
+        const family = textStyles.textStyleOptions?.[category]?.style?.fontFamily;
+        if (typeof family === 'string' && family.trim()) {
+            changed[category] = family;
+        }
+    }
+    // Base text family covers paragraphs when no explicit paragraphs entry came in.
+    if (!changed.paragraphs &&
+        typeof textStyles.textFontFamily === 'string' &&
+        textStyles.textFontFamily.trim()) {
+        changed.paragraphs = textStyles.textFontFamily;
+    }
+    return changed;
+};
+const resolveFieldCategory = (fieldName, style, content) => {
+    const preset = isPlainObject(style)
+        ? style.textStyleType
+        : undefined;
+    if (preset && CATEGORIES.includes(preset))
+        return preset;
+    if (fieldName === 'title' && content.type === 'banner-section') {
+        return 'titles';
+    }
+    return FIELD_DEFAULT_CATEGORY[fieldName];
+};
+/** `testimonialsStyle` → `testimonial`, `titleStyle` → `title`. */
+const styleKeyToFieldName = (styleKey) => {
+    const base = styleKey.slice(0, -'Style'.length);
+    return base.endsWith('s') && !(base in FIELD_DEFAULT_CATEGORY)
+        ? base.slice(0, -1)
+        : base;
+};
+const walkRecord = (record, content, changed, applyFont) => {
+    for (const [key, value] of Object.entries(record)) {
+        if (key.endsWith('Style') && isPlainObject(value)) {
+            // Detached style objects carry their own fontFamily override — align it.
+            // Preset-bound styles keep following the preset (never detach here).
+            const category = resolveFieldCategory(styleKeyToFieldName(key), value, content);
+            const family = category ? changed[category] : undefined;
+            if (family && !value.textStyleType) {
+                value.fontFamily =
+                    family;
+            }
+        }
+        else if (key in FIELD_DEFAULT_CATEGORY &&
+            typeof value === 'string' &&
+            hasRTEContent(value)) {
+            // Inline RTE marks override every style layer at render — rewrite them.
+            const category = resolveFieldCategory(key, record[`${key}Style`], content);
+            const family = category ? changed[category] : undefined;
+            if (family) {
+                record[key] = applyFont(value, family);
+            }
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value) {
+                if (isPlainObject(item)) {
+                    walkRecord(item, content, changed, applyFont);
+                }
+            }
+        }
+    }
+};
+/**
+ * Walk every page's contents and propagate the changed families.
+ * `applyFont` is injectable for tests; the default rewrites inline marks via
+ * the external Tiptap editor.
+ */
+export const propagateFontFamiliesToContents = (model, changed, applyFont) => {
+    if (!Object.keys(changed).length)
+        return;
+    let editor;
+    const apply = applyFont ??
+        ((text, fontFamily) => {
+            editor = editor ?? useExternalRichTextEditor().externalEditor;
+            return applyStyleToRTEText(editor, text, {
+                fontFamily,
+            });
+        });
+    try {
+        for (const page of model.pages) {
+            for (const content of page.contents) {
+                walkRecord(content, content, changed, apply);
+            }
+        }
+    }
+    finally {
+        editor?.destroy();
+    }
+};

package/lib/src/metadata-builder/builders/global-styles-builder.js

@@ -1,6 +1,7 @@
 import {} from '../../brand-page/models';
 import { BaseMetadataBuilder, } from '../models';
 import { GLOBAL_STYLE_CHECKS, TEXT_STYLE_OPTION_KEYS, } from './section-rules/global-styles.rules';
+import { collectChangedFontFamilies, propagateFontFamiliesToContents, } from './global-font-propagation';
 export class GlobalStylesBuilder extends BaseMetadataBuilder {
     constructor(request, logger) {
         super(request, logger);
@@ -30,6 +31,21 @@ export class GlobalStylesBuilder extends BaseMetadataBuilder {
         }
         if (args.textStyles) {
             this.applyTextStyles(model, args.textStyles);
+            // A category font change only reaches preset-bound content by itself;
+            // detached section styles and inline RTE font marks would still render
+            // the old family. Propagate so the change is actually visible (BP-5780).
+            const changedFamilies = collectChangedFontFamilies(args.textStyles);
+            if (Object.keys(changedFamilies).length) {
+                try {
+                    propagateFontFamiliesToContents(model, changedFamilies);
+                }
+                catch (error) {
+                    this.log({
+                        message: 'Global font propagation to existing contents failed — presets still updated',
+                        error,
+                    });
+                }
+            }
         }
         if (args.buttonStyles) {
             this.applyButtonStyles(model, args.buttonStyles);

package/lib/src/metadata-builder/builders/section-builders/about-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { applyColorThemeToReplacements, resolveShapeColorReplacementsAsync, } from '../shape-color-utils';
@@ -23,7 +24,7 @@ export class AboutSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (aboutArgs.title !== undefined) {
             if (isTiptapDocument(aboutArgs.title)) {
-                resolved.content.title = aboutArgs.title;
+                resolved.content.title = tiptapJsonToHtml(aboutArgs.title);
                 resolved.content.titleStyle = resolveGlobalPresetIntoStyle(resolved.content.titleStyle, textStyleOptions);
             }
             else {
@@ -32,7 +33,7 @@ export class AboutSectionBuilder extends BaseSectionBuilder {
         }
         if (aboutArgs.paragraph !== undefined) {
             if (isTiptapDocument(aboutArgs.paragraph)) {
-                resolved.content.paragraph = aboutArgs.paragraph;
+                resolved.content.paragraph = tiptapJsonToHtml(aboutArgs.paragraph);
                 resolved.content.paragraphStyle = resolveGlobalPresetIntoStyle(resolved.content.paragraphStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/banner-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyButtonLink, applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { applyColorThemeToReplacements, resolveShapeColorReplacementsAsync, } from '../shape-color-utils';
@@ -43,7 +44,7 @@ export class BannerSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (bannerArgs.title !== undefined) {
             if (isTiptapDocument(bannerArgs.title)) {
-                resolved.content.title = bannerArgs.title;
+                resolved.content.title = tiptapJsonToHtml(bannerArgs.title);
                 resolved.content.titleStyle = resolveGlobalPresetIntoStyle(resolved.content.titleStyle, textStyleOptions);
             }
             else {
@@ -52,7 +53,7 @@ export class BannerSectionBuilder extends BaseSectionBuilder {
         }
         if (bannerArgs.description !== undefined) {
             if (isTiptapDocument(bannerArgs.description)) {
-                resolved.content.description = bannerArgs.description;
+                resolved.content.description = tiptapJsonToHtml(bannerArgs.description);
                 resolved.content.descriptionStyle = resolveGlobalPresetIntoStyle(resolved.content.descriptionStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/booking-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyButtonLink, applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
@@ -22,7 +23,7 @@ export class BookingSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (bookingArgs.title !== undefined) {
             if (isTiptapDocument(bookingArgs.title)) {
-                resolved.content.title = bookingArgs.title;
+                resolved.content.title = tiptapJsonToHtml(bookingArgs.title);
                 resolved.content.titleStyle = resolveGlobalPresetIntoStyle(resolved.content.titleStyle, textStyleOptions);
             }
             else {
@@ -31,7 +32,7 @@ export class BookingSectionBuilder extends BaseSectionBuilder {
         }
         if (bookingArgs.description !== undefined) {
             if (isTiptapDocument(bookingArgs.description)) {
-                resolved.content.description = bookingArgs.description;
+                resolved.content.description = tiptapJsonToHtml(bookingArgs.description);
                 resolved.content.descriptionStyle = resolveGlobalPresetIntoStyle(resolved.content.descriptionStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/contact-form-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
@@ -22,7 +23,7 @@ export class ContactFormBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (args.title !== undefined) {
             if (isTiptapDocument(args.title)) {
-                content.title = args.title;
+                content.title = tiptapJsonToHtml(args.title);
                 content.titleStyle = resolveGlobalPresetIntoStyle(content.titleStyle, textStyleOptions);
             }
             else {
@@ -31,7 +32,7 @@ export class ContactFormBuilder extends BaseSectionBuilder {
         }
         if (args.description !== undefined) {
             if (isTiptapDocument(args.description)) {
-                content.description = args.description;
+                content.description = tiptapJsonToHtml(args.description);
                 content.descriptionStyle = resolveGlobalPresetIntoStyle(content.descriptionStyle, textStyleOptions);
             }
             else {
@@ -40,7 +41,7 @@ export class ContactFormBuilder extends BaseSectionBuilder {
         }
         if (args.success_message !== undefined) {
             if (isTiptapDocument(args.success_message)) {
-                content.successMessage = args.success_message;
+                content.successMessage = tiptapJsonToHtml(args.success_message);
                 content.successMessageStyle = resolveGlobalPresetIntoStyle(content.successMessageStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/images-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, isValidUrl, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
@@ -95,7 +96,7 @@ export class ImagesSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (args.title !== undefined) {
             if (isTiptapDocument(args.title)) {
-                content.title = args.title;
+                content.title = tiptapJsonToHtml(args.title);
                 content.titleStyle = resolveGlobalPresetIntoStyle(content.titleStyle, textStyleOptions);
             }
             else {
@@ -104,7 +105,7 @@ export class ImagesSectionBuilder extends BaseSectionBuilder {
         }
         if (args.description !== undefined) {
             if (isTiptapDocument(args.description)) {
-                content.description = args.description;
+                content.description = tiptapJsonToHtml(args.description);
                 content.descriptionStyle = resolveGlobalPresetIntoStyle(content.descriptionStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/index.d.ts

@@ -1,6 +1,7 @@
 export { BaseSectionBuilder, type SectionBuilderPayload, } from './base-section-builder';
 export { BannerSectionBuilder } from './banner-section-builder';
 export { BookingSectionBuilder } from './booking-section-builder';
+export { SupportMeBuilder } from './support-me-builder';
 export { AboutSectionBuilder } from './about-section-builder';
 export { ContactFormBuilder } from './contact-form-builder';
 export { DividerSectionBuilder } from './divider-section-builder';

package/lib/src/metadata-builder/builders/section-builders/index.js

@@ -1,6 +1,7 @@
 export { BaseSectionBuilder, } from './base-section-builder';
 export { BannerSectionBuilder } from './banner-section-builder';
 export { BookingSectionBuilder } from './booking-section-builder';
+export { SupportMeBuilder } from './support-me-builder';
 export { AboutSectionBuilder } from './about-section-builder';
 export { ContactFormBuilder } from './contact-form-builder';
 export { DividerSectionBuilder } from './divider-section-builder';

package/lib/src/metadata-builder/builders/section-builders/mailing-list-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
@@ -22,7 +23,7 @@ export class MailingListBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (mailingListArgs.title !== undefined) {
             if (isTiptapDocument(mailingListArgs.title)) {
-                content.title = mailingListArgs.title;
+                content.title = tiptapJsonToHtml(mailingListArgs.title);
                 content.titleStyle = resolveGlobalPresetIntoStyle(content.titleStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/mailing-list-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
@@ -21,7 +22,7 @@ export class MailingListSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (mailingListArgs.title !== undefined) {
             if (isTiptapDocument(mailingListArgs.title)) {
-                resolved.content.title = mailingListArgs.title;
+                resolved.content.title = tiptapJsonToHtml(mailingListArgs.title);
                 resolved.content.titleStyle = resolveGlobalPresetIntoStyle(resolved.content.titleStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/profile-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
@@ -20,7 +21,7 @@ export class ProfileSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (profileArgs.name !== undefined) {
             if (isTiptapDocument(profileArgs.name)) {
-                resolved.content.name = profileArgs.name;
+                resolved.content.name = tiptapJsonToHtml(profileArgs.name);
                 resolved.content.nameStyle = resolveGlobalPresetIntoStyle(resolved.content.nameStyle, textStyleOptions);
             }
             else {
@@ -29,7 +30,7 @@ export class ProfileSectionBuilder extends BaseSectionBuilder {
         }
         if (profileArgs.title !== undefined) {
             if (isTiptapDocument(profileArgs.title)) {
-                resolved.content.title = profileArgs.title;
+                resolved.content.title = tiptapJsonToHtml(profileArgs.title);
                 resolved.content.titleStyle = resolveGlobalPresetIntoStyle(resolved.content.titleStyle, textStyleOptions);
             }
             else {
@@ -38,7 +39,7 @@ export class ProfileSectionBuilder extends BaseSectionBuilder {
         }
         if (profileArgs.description !== undefined) {
             if (isTiptapDocument(profileArgs.description)) {
-                resolved.content.description = profileArgs.description;
+                resolved.content.description = tiptapJsonToHtml(profileArgs.description);
                 resolved.content.descriptionStyle = resolveGlobalPresetIntoStyle(resolved.content.descriptionStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/shapes-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { applyColorThemeToReplacements, resolveShapeColorReplacementsAsync, } from '../shape-color-utils';
@@ -116,7 +117,7 @@ export class ShapesSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (args.title !== undefined) {
             if (isTiptapDocument(args.title)) {
-                content.title = args.title;
+                content.title = tiptapJsonToHtml(args.title);
                 content.titleStyle = resolveGlobalPresetIntoStyle(content.titleStyle, textStyleOptions);
             }
             else {
@@ -125,7 +126,7 @@ export class ShapesSectionBuilder extends BaseSectionBuilder {
         }
         if (args.description !== undefined) {
             if (isTiptapDocument(args.description)) {
-                content.description = args.description;
+                content.description = tiptapJsonToHtml(args.description);
                 content.descriptionStyle = resolveGlobalPresetIntoStyle(content.descriptionStyle, textStyleOptions);
             }
             else {

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

@@ -0,0 +1,8 @@
+import type { BrandPageModel, SupportMeContent } from '../../../brand-page/models';
+import type { BuilderResult } from '../../models';
+import { BaseSectionBuilder } from './base-section-builder';
+import { validateSupportMe } from '../section-rules/support-me.rules';
+export declare class SupportMeBuilder extends BaseSectionBuilder<SupportMeContent> {
+    protected get sectionValidate(): typeof validateSupportMe;
+    buildAsync(model: BrandPageModel): Promise<BuilderResult>;
+}

package/lib/src/metadata-builder/builders/section-builders/support-me-builder.js

@@ -0,0 +1,25 @@
+import { applyScalarFields, applyStyleFields } from '../section-field-utils';
+import { BaseSectionBuilder } from './base-section-builder';
+import { validateSupportMe } from '../section-rules/support-me.rules';
+export class SupportMeBuilder extends BaseSectionBuilder {
+    get sectionValidate() {
+        return validateSupportMe;
+    }
+    async buildAsync(model) {
+        this.log('Build called');
+        const validation = await this.validateAsync();
+        if (validation.errors.length) {
+            return { request: this.request, model, errors: validation.errors };
+        }
+        const resolved = this.resolveAndRepositionContent(model);
+        if ('error' in resolved)
+            return resolved.error;
+        const content = resolved.content;
+        // title/description/success_message are plain-text fields (no RTE support),
+        // so scalar application covers all content fields. supportMeConfig (payment
+        // options) is intentionally not AI-editable — it comes from the factory.
+        applyScalarFields(content, this.args, this.sectionType);
+        applyStyleFields(content, this.args, this.sectionType, this.getGlobalTextStyles(model));
+        return { request: this.request, model };
+    }
+}

package/lib/src/metadata-builder/builders/section-builders/testimonial-section-builder.js

@@ -1,3 +1,4 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { applyColorThemeToReplacements, resolveShapeColorReplacementsAsync, } from '../shape-color-utils';
@@ -102,7 +103,7 @@ export class TestimonialSectionBuilder extends BaseSectionBuilder {
         const textStyleOptions = model.styles?.textStyles?.textStyleOptions;
         if (args.title !== undefined) {
             if (isTiptapDocument(args.title)) {
-                content.title = args.title;
+                content.title = tiptapJsonToHtml(args.title);
                 content.titleStyle = resolveGlobalPresetIntoStyle(content.titleStyle, textStyleOptions);
             }
             else {

package/lib/src/metadata-builder/builders/section-builders/text-section-builder.js

@@ -1,28 +1,24 @@
+import { tiptapJsonToHtml } from '../../helpers/rte.helpers';
 import { isTiptapDocument, } from '../../parsers/section-tool-arguments';
 import { applyScalarFields, applyStyleFields, resolveGlobalPresetIntoStyle, } from '../section-field-utils';
 import { BaseSectionBuilder } from './base-section-builder';
 import { validateTextSection } from '../section-rules/text-section.rules';
 import { ensureItemIds, generateItemId, removeItemsByIds, repositionItemByAnchor, } from '../item-id-utils';
-/**
- * Resolve a RichTextField to its stored RTE value. BP-5787: Tiptap JSON is
- * stored as-is (no JSON→HTML round-trip — migration-20 is now a one-time
- * legacy conversion), plain strings pass through. `wasTiptap` drives the
- * text-style preset resolution for rich content.
- */
+/** Resolve a RichTextField (string or TiptapDocument) to a plain HTML string. */
 const resolveText = (value) => {
     if (isTiptapDocument(value))
-        return { value, wasTiptap: true };
-    return { value: typeof value === 'string' ? value : '', wasTiptap: false };
+        return { html: tiptapJsonToHtml(value), wasTiptap: true };
+    return { html: typeof value === 'string' ? value : '', wasTiptap: false };
 };
 const clearTextStyleTypeIfTiptap = (style, wasTiptap, textStyleOptions) => wasTiptap
     ? resolveGlobalPresetIntoStyle(style, textStyleOptions)
     : style;
 const createTextItem = (item, baseStyle, textStyleOptions) => {
     const textStyle = (item.text_style ? { ...baseStyle, ...item.text_style } : { ...baseStyle });
-    const { value, wasTiptap } = resolveText(item.text);
+    const { html, wasTiptap } = resolveText(item.text);
     return {
         id: item.item_id || generateItemId(),
-        text: value,
+        text: html,
         textStyle: clearTextStyleTypeIfTiptap(textStyle, wasTiptap, textStyleOptions),
     };
 };
@@ -55,8 +51,8 @@ const mergeTextItems = (content, items, removeIds, textStyleOptions) => {
             if (!existing)
                 continue;
             if (item.text !== undefined) {
-                const { value, wasTiptap } = resolveText(item.text);
-                existing.text = value;
+                const { html, wasTiptap } = resolveText(item.text);
+                existing.text = html;
                 existing.textStyle = clearTextStyleTypeIfTiptap(existing.textStyle || {}, wasTiptap, textStyleOptions);
             }
             if (item.text_style && typeof item.text_style === 'object') {
@@ -80,11 +76,11 @@ const mergeTextItems = (content, items, removeIds, textStyleOptions) => {
  */
 const applySingleTextField = (content, args, textStyleOptions) => {
     if (args.text !== undefined) {
-        const { value, wasTiptap } = resolveText(args.text);
+        const { html, wasTiptap } = resolveText(args.text);
         if (Array.isArray(content.textItems) && content.textItems.length > 0) {
             content.textItems[0] = {
                 ...content.textItems[0],
-                text: value,
+                text: html,
                 textStyle: clearTextStyleTypeIfTiptap(content.textItems[0].textStyle || {}, wasTiptap, textStyleOptions),
             };
         }
@@ -92,7 +88,7 @@ const applySingleTextField = (content, args, textStyleOptions) => {
             content.textItems = [
                 {
                     id: generateItemId(),
-                    text: value,
+                    text: html,
                     textStyle: clearTextStyleTypeIfTiptap({ ...(content.textStyle || {}) }, wasTiptap, textStyleOptions),
                 },
             ];
@@ -135,14 +131,17 @@ export class TextSectionBuilder extends BaseSectionBuilder {
             applyTextItems(content, args.items, textStyleOptions);
         }
         else if (this.mode === 'create') {
-            if (args.items && Array.isArray(args.items)) {
+            // An EMPTY items array must not shadow the single text field — the AI emits
+            // `items: []` alongside `text` and the section rendered blank (QA 2026-07-05,
+            // T06: items=[] set textItems=[] and `text` was silently discarded).
+            if (args.items && Array.isArray(args.items) && args.items.length > 0) {
                 applyTextItems(content, args.items, textStyleOptions);
             }
             else {
                 applySingleTextField(content, args, textStyleOptions);
             }
         }
-        else if ((args.items && Array.isArray(args.items)) ||
+        else if ((args.items && Array.isArray(args.items) && args.items.length > 0) ||
             args._remove_item_ids?.length) {
             // Update: id-based add / edit / move / remove in a single pass.
             mergeTextItems(content, args.items ?? [], args._remove_item_ids, textStyleOptions);

package/lib/src/metadata-builder/builders/section-field-maps.js

@@ -131,9 +131,16 @@ const socialButtonFields = defineFieldMap({
     title: 'title',
     url: 'url',
 });
+const supportMeFields = defineFieldMap({
+    title: 'title',
+    description: 'description',
+    success_message: 'successMessage',
+    display_style: 'displayStyle',
+});
 export const SECTION_FIELD_MAPS = {
     'banner-section': bannerFields,
     'booking-section': bookingFields,
+    'support-me': supportMeFields,
     'about-section': aboutFields,
     'testimonial-section': testimonialFields,
     'images-section': imagesSectionFields,
@@ -208,6 +215,13 @@ const mailingListStyleFields = defineFieldMap({
     title_style: 'titleStyle',
     button_text_style: 'buttonTextStyle',
 });
+const supportMeStyleFields = defineFieldMap({
+    title_style: 'titleStyle',
+    heading_style: 'headingStyle',
+    description_style: 'descriptionStyle',
+    item_text_style: 'itemTextStyle',
+    button_text_style: 'buttonTextStyle',
+});
 const socialLinksStyleFields = defineFieldMap({
     icon_fill_style: 'iconFillStyles',
     icon_background_style: 'iconBackgroundStyles',
@@ -215,6 +229,7 @@ const socialLinksStyleFields = defineFieldMap({
 export const STYLE_FIELD_MAPS = {
     'banner-section': bannerStyleFields,
     'booking-section': bookingStyleFields,
+    'support-me': supportMeStyleFields,
     'about-section': aboutStyleFields,
     text: textStyleFields,
     'testimonial-section': testimonialStyleFields,