@designcrowd/library.brand-page 5.17.28 → 5.18.0

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

@@ -18,12 +18,20 @@ const bannerFields = defineFieldMap({
     button_text: 'buttonText',
     button_url: 'url',
     background_image_url: 'imageUrl',
+    background_shape_url: 'imageUrl',
     display_style: 'displayStyle',
 });
+const bookingFields = defineFieldMap({
+    title: 'title',
+    description: 'description',
+    button_text: 'buttonText',
+    button_url: 'url',
+});
 const aboutFields = defineFieldMap({
     title: 'title',
     paragraph: 'paragraph',
     about_image_url: 'imageUrl',
+    about_shape_url: 'imageUrl',
     display_style: 'displayStyle',
 });
 const testimonialFields = defineFieldMap({
@@ -67,8 +75,8 @@ const contactFormFields = defineFieldMap({
     layout_style: 'layoutStyle',
 });
 const mailingListFields = defineFieldMap({
-    title: 'title',
     button_text: 'buttonText',
+    accepted_fields: 'acceptedFields',
 });
 const socialLinksFields = defineFieldMap({
     title: 'title',
@@ -77,13 +85,15 @@ const socialLinksFields = defineFieldMap({
 });
 const dividerFields = defineFieldMap({
     divider_style: 'dividerStyle',
+    padding: 'paddingStyle',
 });
 const imageFields = defineFieldMap({
     image_url: 'imageUrl',
     image_title: 'imageTitle',
 });
 const imageGalleryFields = defineFieldMap({
-// images handled separately
+    is_full_width: 'isFullWidth',
+    // images handled separately
 });
 const buttonWithIconFields = defineFieldMap({
     title: 'title',
@@ -106,6 +116,7 @@ const socialButtonFields = defineFieldMap({
 });
 export const SECTION_FIELD_MAPS = {
     'banner-section': bannerFields,
+    'booking-section': bookingFields,
     'about-section': aboutFields,
     'testimonial-section': testimonialFields,
     'images-section': imagesSectionFields,
@@ -163,6 +174,7 @@ const imagesSectionStyleFields = defineFieldMap({
     description_style: 'descriptionStyle',
     heading_style: 'headingStyle',
     paragraph_style: 'paragraphStyle',
+    button_text_style: 'buttonTextStyle',
 });
 const shapesSectionStyleFields = defineFieldMap({
     title_style: 'titleStyle',
@@ -170,13 +182,29 @@ const shapesSectionStyleFields = defineFieldMap({
     heading_style: 'headingStyle',
     paragraph_style: 'paragraphStyle',
 });
+const bookingStyleFields = defineFieldMap({
+    title_style: 'titleStyle',
+    description_style: 'descriptionStyle',
+    button_text_style: 'buttonTextStyle',
+});
+const mailingListStyleFields = defineFieldMap({
+    title_style: 'titleStyle',
+    button_text_style: 'buttonTextStyle',
+});
+const socialLinksStyleFields = defineFieldMap({
+    icon_fill_style: 'iconFillStyles',
+    icon_background_style: 'iconBackgroundStyles',
+});
 export const STYLE_FIELD_MAPS = {
     'banner-section': bannerStyleFields,
+    'booking-section': bookingStyleFields,
     'about-section': aboutStyleFields,
     text: textStyleFields,
     'testimonial-section': testimonialStyleFields,
     'contact-form': contactFormStyleFields,
     'images-section': imagesSectionStyleFields,
     'shapes-section': shapesSectionStyleFields,
+    'mailing-list': mailingListStyleFields,
+    'social-links': socialLinksStyleFields,
 };
 export const getStyleFieldMap = (sectionType) => STYLE_FIELD_MAPS[sectionType];

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

@@ -1,11 +1,50 @@
 import type { Content } from '../../brand-page/models';
-import type { SectionToolArguments } from '../parsers/section-tool-arguments';
+import type { ButtonLinkType } from '../../brand-page/models';
+import type { TextStyleOptions } from '../../brand-page/models/styles.model';
+import { type SectionToolArguments } from '../parsers/section-tool-arguments';
+export declare const isValidUrl: (value: unknown) => boolean;
+interface ButtonLinkContent {
+    url: string;
+    email?: string;
+    tel?: string;
+    buttonPageId: string;
+    buttonLinkType: ButtonLinkType;
+}
+interface ButtonLinkArgs {
+    button_link_type?: 'url' | 'page' | 'mailTo' | 'tel';
+    button_url?: string;
+}
+/**
+ * Sets buttonLinkType and the corresponding link value field (url/email/tel/buttonPageId)
+ * on any section content that supports multiple button link types.
+ * Must be called after applyScalarFields() since that sets content.url as a baseline.
+ */
+export declare const applyButtonLink: (content: ButtonLinkContent, args: ButtonLinkArgs) => void;
 export declare const applyScalarFields: (content: Content, args: SectionToolArguments, sectionType: string) => void;
-export declare const applyStyleFields: (content: Content, args: SectionToolArguments, sectionType: string) => void;
 /**
- * Re-applies merged styles to RTE content fields after applyStyleFields has
- * updated the style objects. Only runs for section types that support RTE
- * (defined by RTE_ALLOWED_SECTION_TYPES) and only touches fields in the
- * RTE_ALLOWED_FIELDS list.
+ * When an executor is about to mark a content-level text style "custom" by
+ * clearing `textStyleType`, the resolved preset values (font, size, spacing,
+ * etc.) must first be copied onto the style — otherwise the renderer falls
+ * back to browser defaults because `textStyleType` no longer points at a
+ * preset.
+ *
+ * The category is read from the existing `style.textStyleType`, which is the
+ * authoritative per-section + per-field reference set by the content factory.
+ * Existing style values win over preset defaults (the content may already
+ * carry user overrides on top of the preset).
+ */
+export declare const resolveGlobalPresetIntoStyle: (style: object | undefined, textStyleOptions: TextStyleOptions | undefined) => Record<string, unknown>;
+/**
+ * Applies per-element style overrides while detaching the element from any
+ * global text-style preset. When a style is bound to a `textStyleType` preset,
+ * the renderer (`getCopyrightTextStyle` / `getTextStyleByContentTextStyle`)
+ * replaces the whole style with that preset and discards per-element values such
+ * as `fontFamily`. Resolving the preset in and clearing `textStyleType` makes the
+ * override stick — the same disconnect rule section content follows.
+ *
+ * Idempotent: once `textStyleType` is cleared, subsequent calls just merge the
+ * updates without re-resolving a preset.
  */
-export declare const applyRTEStyles: (content: Content, args: SectionToolArguments, sectionType: string) => void;
+export declare const applyDetachedStyleOverride: <T extends object>(current: T | undefined, updates: Partial<T>, textStyleOptions: TextStyleOptions | undefined) => T;
+export declare const applyStyleFields: (content: Content, args: SectionToolArguments, sectionType: string, textStyleOptions?: TextStyleOptions) => void;
+export {};

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

@@ -1,8 +1,8 @@
-import { RTE_ALLOWED_SECTION_TYPES } from '../../brand-page-maker/utils';
-import { updateRTEText } from '../helpers/rte.helpers';
+import { BUTTON_LINK_TYPE } from '../../brand-page/models';
+import { isTiptapDocument, } from '../parsers/section-tool-arguments';
 import { getSectionFieldMap, getStyleFieldMap } from './section-field-maps';
 const isUrlField = (aiKey) => aiKey.endsWith('_url');
-const isValidUrl = (value) => {
+export const isValidUrl = (value) => {
     if (typeof value !== 'string' || !value)
         return false;
     try {
@@ -13,6 +13,27 @@ const isValidUrl = (value) => {
         return false;
     }
 };
+/**
+ * Sets buttonLinkType and the corresponding link value field (url/email/tel/buttonPageId)
+ * on any section content that supports multiple button link types.
+ * Must be called after applyScalarFields() since that sets content.url as a baseline.
+ */
+export const applyButtonLink = (content, args) => {
+    const { button_link_type: linkType, button_url: buttonUrl } = args;
+    if (!linkType || !buttonUrl)
+        return;
+    content.buttonLinkType = linkType;
+    switch (linkType) {
+        case BUTTON_LINK_TYPE.url:
+        case BUTTON_LINK_TYPE.mailTo:
+        case BUTTON_LINK_TYPE.tel:
+            content.url = buttonUrl;
+            break;
+        case BUTTON_LINK_TYPE.page:
+            content.buttonPageId = buttonUrl.replace('pageid:', '');
+            break;
+    }
+};
 export const applyScalarFields = (content, args, sectionType) => {
     const fieldMap = getSectionFieldMap(sectionType);
     if (!fieldMap)
@@ -20,10 +41,14 @@ export const applyScalarFields = (content, args, sectionType) => {
     const record = content;
     for (const [aiKey, modelKey] of Object.entries(fieldMap)) {
         if (aiKey in args) {
+            const value = args[aiKey];
             // Skip invalid URLs — don't overwrite model with malformed values
-            if (isUrlField(aiKey) && !isValidUrl(args[aiKey]))
+            if (isUrlField(aiKey) && !isValidUrl(value))
+                continue;
+            // Skip Tiptap JSON documents — each builder handles its own RTE fields
+            if (isTiptapDocument(value))
                 continue;
-            record[modelKey] = args[aiKey];
+            record[modelKey] = value;
         }
     }
 };
@@ -41,74 +66,73 @@ const normalizeStyleValue = (key, value) => {
     if (key === 'letterSpacing' && typeof value === 'number') {
         return `${value / 100}em`;
     }
-    if (key === 'lineHeight' && typeof value === 'number') {
-        return String(value);
+    if (key === 'lineHeight') {
+        // Snap to 0.1 increments to match the UI slider step
+        const num = typeof value === 'number' ? value : parseFloat(String(value));
+        if (!isNaN(num))
+            return String(Math.floor(num * 10) / 10);
     }
     return value;
 };
-export const applyStyleFields = (content, args, sectionType) => {
-    const styleMap = getStyleFieldMap(sectionType);
-    if (!styleMap)
-        return;
-    const record = content;
-    for (const [aiKey, modelKey] of Object.entries(styleMap)) {
-        if (aiKey in args && args[aiKey] && typeof args[aiKey] === 'object') {
-            const existing = content[modelKey] || {};
-            const aiStyle = args[aiKey];
-            const filtered = {};
-            for (const [k, v] of Object.entries(aiStyle)) {
-                const normalized = normalizeStyleValue(k, v);
-                if (normalized !== undefined)
-                    filtered[k] = normalized;
-            }
-            record[modelKey] = {
-                ...existing,
-                ...filtered,
-                textStyleType: undefined,
-            };
-        }
-    }
-};
 /**
- * RTE field → style field pairs for fields that support rich text editing.
- * Matches the RTE_ALLOWED_FIELDS constant from rich-text-editor.util.ts:
- * ['title', 'description', 'text', 'textItems']
+ * When an executor is about to mark a content-level text style "custom" by
+ * clearing `textStyleType`, the resolved preset values (font, size, spacing,
+ * etc.) must first be copied onto the style — otherwise the renderer falls
+ * back to browser defaults because `textStyleType` no longer points at a
+ * preset.
  *
- * textItems is excluded here because it requires per-item handling
- * (each TextItem has its own textStyle) — handled by TextSectionBuilder.
+ * The category is read from the existing `style.textStyleType`, which is the
+ * authoritative per-section + per-field reference set by the content factory.
+ * Existing style values win over preset defaults (the content may already
+ * carry user overrides on top of the preset).
  */
-const RTE_FIELD_STYLE_PAIRS = [
-    { textField: 'title', styleField: 'titleStyle', argKey: 'title_style' },
-    {
-        textField: 'description',
-        styleField: 'descriptionStyle',
-        argKey: 'description_style',
-    },
-    { textField: 'text', styleField: 'textStyle', argKey: 'text_style' },
-    {
-        textField: 'paragraph',
-        styleField: 'paragraphStyle',
-        argKey: 'paragraph_style',
-    },
-];
+export const resolveGlobalPresetIntoStyle = (style, textStyleOptions) => {
+    const base = { ...(style ?? {}) };
+    const currentTextStyleType = base.textStyleType;
+    if (!currentTextStyleType || !textStyleOptions?.[currentTextStyleType]) {
+        base.textStyleType = undefined;
+        return base;
+    }
+    const presetStyle = textStyleOptions[currentTextStyleType].style;
+    const presetDefaults = {};
+    for (const [k, v] of Object.entries(presetStyle)) {
+        if (k === 'textStyleType' || v === undefined)
+            continue;
+        presetDefaults[k] = v;
+    }
+    return { ...presetDefaults, ...base, textStyleType: undefined };
+};
 /**
- * Re-applies merged styles to RTE content fields after applyStyleFields has
- * updated the style objects. Only runs for section types that support RTE
- * (defined by RTE_ALLOWED_SECTION_TYPES) and only touches fields in the
- * RTE_ALLOWED_FIELDS list.
+ * Applies per-element style overrides while detaching the element from any
+ * global text-style preset. When a style is bound to a `textStyleType` preset,
+ * the renderer (`getCopyrightTextStyle` / `getTextStyleByContentTextStyle`)
+ * replaces the whole style with that preset and discards per-element values such
+ * as `fontFamily`. Resolving the preset in and clearing `textStyleType` makes the
+ * override stick — the same disconnect rule section content follows.
+ *
+ * Idempotent: once `textStyleType` is cleared, subsequent calls just merge the
+ * updates without re-resolving a preset.
  */
-export const applyRTEStyles = (content, args, sectionType) => {
-    if (!RTE_ALLOWED_SECTION_TYPES.includes(sectionType))
+export const applyDetachedStyleOverride = (current, updates, textStyleOptions) => ({
+    ...resolveGlobalPresetIntoStyle(current, textStyleOptions),
+    ...updates,
+});
+export const applyStyleFields = (content, args, sectionType, textStyleOptions) => {
+    const styleMap = getStyleFieldMap(sectionType);
+    if (!styleMap)
         return;
     const record = content;
-    const argsRecord = args;
-    for (const { textField, styleField, argKey } of RTE_FIELD_STYLE_PAIRS) {
-        if (!argsRecord[argKey])
+    for (const [aiKey, modelKey] of Object.entries(styleMap)) {
+        if (!(aiKey in args) || !args[aiKey] || typeof args[aiKey] !== 'object')
             continue;
-        const text = record[textField];
-        const style = record[styleField];
-        if (typeof text === 'string' && style) {
-            record[textField] = updateRTEText(text, style);
+        const aiStyle = args[aiKey];
+        const filtered = {};
+        for (const [k, v] of Object.entries(aiStyle)) {
+            const normalized = normalizeStyleValue(k, v);
+            if (normalized !== undefined)
+                filtered[k] = normalized;
         }
+        const resolved = resolveGlobalPresetIntoStyle(content[modelKey], textStyleOptions);
+        record[modelKey] = { ...resolved, ...filtered, textStyleType: undefined };
     }
 };

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

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateAboutSection(args: Record<string, unknown>, ctx: ValidationContext): string[];

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

@@ -0,0 +1,20 @@
+import { MAX_TITLE_LENGTH, MAX_DESCRIPTION_LENGTH, } from '../../../brand-page/constants/font.constants';
+import { enumCheck, runChecks, styleCheck, } from '../../sanitizers/section-args-validator';
+import { textAndRteChecks } from '../../sanitizers/rte-schema-check';
+const CHECKS = [
+    ...textAndRteChecks('title', MAX_TITLE_LENGTH),
+    ...textAndRteChecks('paragraph', MAX_DESCRIPTION_LENGTH),
+    styleCheck('title_style'),
+    styleCheck('paragraph_style'),
+    enumCheck('display_style', [
+        'left-aligned',
+        'right-aligned',
+        'centered',
+        'text-only',
+        'left-aligned-full-image',
+        'right-aligned-full-image',
+    ], 'about-section'),
+];
+export function validateAboutSection(args, ctx) {
+    return runChecks(CHECKS, args, ctx);
+}

package/lib/src/metadata-builder/builders/section-rules/add-page.rules.d.ts

@@ -0,0 +1,7 @@
+export interface AddPagePayload {
+    pageId: string;
+    pageName: string;
+}
+type PageCheck = (payload: AddPagePayload | undefined) => string | null;
+export declare const ADD_PAGE_CHECKS: PageCheck[];
+export {};

package/lib/src/metadata-builder/builders/section-rules/add-page.rules.js

@@ -0,0 +1,8 @@
+import { PAGE_RULES } from '../../sanitizers/sanitizer-rules';
+export const ADD_PAGE_CHECKS = [
+    (p) => (!p?.pageId ? 'page_id is required for add_page' : null),
+    (p) => (!p?.pageName ? 'page_name is required for add_page' : null),
+    (p) => p?.pageName && p.pageName.length > PAGE_RULES.pageName
+        ? `page_name exceeds the maximum length of ${PAGE_RULES.pageName} characters (got ${p.pageName.length})`
+        : null,
+];

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

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateBannerSection(args: Record<string, unknown>, ctx: ValidationContext): string[];

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

@@ -0,0 +1,27 @@
+import { MAX_TITLE_LENGTH, MAX_DESCRIPTION_LENGTH, } from '../../../brand-page/constants/font.constants';
+import { BUTTON_LINK_TYPE } from '../../../brand-page/models';
+import { enumCheck, runChecks, styleCheck, } from '../../sanitizers/section-args-validator';
+import { textAndRteChecks } from '../../sanitizers/rte-schema-check';
+const CHECKS = [
+    ...textAndRteChecks('title', MAX_TITLE_LENGTH),
+    ...textAndRteChecks('description', MAX_DESCRIPTION_LENGTH),
+    ...textAndRteChecks('button_text', MAX_TITLE_LENGTH),
+    styleCheck('title_style'),
+    styleCheck('description_style'),
+    styleCheck('button_text_style'),
+    enumCheck('display_style', [
+        'left-aligned',
+        'right-aligned',
+        'centered',
+        'big-image',
+        'left-aligned-big-image',
+        'right-aligned-full-image',
+        'left-aligned-full-image',
+        'center-card-aligned-image',
+        'left-card-aligned-image',
+    ], 'banner-section'),
+    enumCheck('button_link_type', Object.keys(BUTTON_LINK_TYPE), 'banner-section'),
+];
+export function validateBannerSection(args, ctx) {
+    return runChecks(CHECKS, args, ctx);
+}

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

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateBookingSection(args: Record<string, unknown>, ctx: ValidationContext): string[];

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

@@ -0,0 +1,16 @@
+import { MAX_TITLE_LENGTH, MAX_DESCRIPTION_LENGTH, } from '../../../brand-page/constants/font.constants';
+import { BUTTON_LINK_TYPE } from '../../../brand-page/models';
+import { enumCheck, runChecks, styleCheck, } from '../../sanitizers/section-args-validator';
+import { textAndRteChecks } from '../../sanitizers/rte-schema-check';
+const CHECKS = [
+    ...textAndRteChecks('title', MAX_TITLE_LENGTH),
+    ...textAndRteChecks('description', MAX_DESCRIPTION_LENGTH),
+    ...textAndRteChecks('button_text', MAX_TITLE_LENGTH),
+    styleCheck('title_style'),
+    styleCheck('description_style'),
+    styleCheck('button_text_style'),
+    enumCheck('button_link_type', Object.keys(BUTTON_LINK_TYPE), 'booking-section'),
+];
+export function validateBookingSection(args, ctx) {
+    return runChecks(CHECKS, args, ctx);
+}

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

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateButtonSection(args: Record<string, unknown>, ctx: ValidationContext): string[];

package/lib/src/metadata-builder/builders/section-rules/button-section.rules.js

@@ -0,0 +1,13 @@
+import { MAX_TITLE_LENGTH } from '../../../brand-page/constants/font.constants';
+import { runChecks, } from '../../sanitizers/section-args-validator';
+import { textAndRteChecks } from '../../sanitizers/rte-schema-check';
+/**
+ * Shared validation for all link/button section types:
+ * website, email, phone, general-link, facebook, x, instagram,
+ * youtube, linkedin, pinterest, twitch, tiktok.
+ * All use ButtonSectionBuilder and share the same title constraint.
+ */
+const CHECKS = [...textAndRteChecks('title', MAX_TITLE_LENGTH)];
+export function validateButtonSection(args, ctx) {
+    return runChecks(CHECKS, args, ctx);
+}

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

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateContactForm(args: Record<string, unknown>, ctx: ValidationContext): string[];

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

@@ -0,0 +1,16 @@
+import { MAX_TITLE_LENGTH, MAX_DESCRIPTION_LENGTH, } from '../../../brand-page/constants/font.constants';
+import { enumCheck, runChecks, styleCheck, } from '../../sanitizers/section-args-validator';
+import { textAndRteChecks } from '../../sanitizers/rte-schema-check';
+const CHECKS = [
+    ...textAndRteChecks('title', MAX_TITLE_LENGTH),
+    ...textAndRteChecks('description', MAX_DESCRIPTION_LENGTH),
+    ...textAndRteChecks('button_text', MAX_TITLE_LENGTH),
+    ...textAndRteChecks('success_message', MAX_TITLE_LENGTH),
+    styleCheck('title_style'),
+    styleCheck('description_style'),
+    styleCheck('button_text_style'),
+    enumCheck('display_style', ['preview', 'collapsed'], 'contact-form'),
+];
+export function validateContactForm(args, ctx) {
+    return runChecks(CHECKS, args, ctx);
+}

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

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateDividerSection(args: Record<string, unknown>, ctx: ValidationContext): string[];

package/lib/src/metadata-builder/builders/section-rules/divider-section.rules.js

@@ -0,0 +1,7 @@
+import { enumCheck, runChecks, } from '../../sanitizers/section-args-validator';
+const CHECKS = [
+    enumCheck('divider_style', ['none', 'thin', 'thick'], 'divider-section'),
+];
+export function validateDividerSection(args, ctx) {
+    return runChecks(CHECKS, args, ctx);
+}

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

@@ -0,0 +1,4 @@
+import type { UpdateFooterArguments } from '../../parsers/ai-toolcall-parser';
+type FooterCheck = (args: UpdateFooterArguments) => string | null;
+export declare const FOOTER_CHECKS: FooterCheck[];
+export {};

package/lib/src/metadata-builder/builders/section-rules/footer.rules.js

@@ -0,0 +1,5 @@
+import { validateLogoSize } from '../../sanitizers/section-args-validator';
+export const FOOTER_CHECKS = ['desktop', 'mobile'].flatMap((viewport) => [
+    (args) => validateLogoSize(`${viewport}.logo_image_height`, args[viewport]?.logo_image_height, viewport),
+    (args) => validateLogoSize(`${viewport}.logo_image_width`, args[viewport]?.logo_image_width, viewport),
+]);

package/lib/src/metadata-builder/builders/section-rules/global-styles.rules.d.ts

@@ -0,0 +1,6 @@
+import type { UpdateGlobalStylesArguments } from '../../parsers/ai-toolcall-parser';
+import type { TextStyleType } from '../../../brand-page/models/styles.model';
+export declare const TEXT_STYLE_OPTION_KEYS: TextStyleType[];
+type GlobalStyleCheck = (args: UpdateGlobalStylesArguments) => string | null;
+export declare const GLOBAL_STYLE_CHECKS: GlobalStyleCheck[];
+export {};

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

@@ -0,0 +1,26 @@
+import { STYLE_RULES } from '../../sanitizers/sanitizer-rules';
+import { validateStringStyleAttrs } from '../../sanitizers/section-args-validator';
+export const TEXT_STYLE_OPTION_KEYS = [
+    'titles',
+    'headings',
+    'paragraphs',
+    'buttons',
+];
+export const GLOBAL_STYLE_CHECKS = [
+    // textFontFamily: must be a recognized camelCase font key (e.g. 'playfairDisplay')
+    (args) => {
+        const font = args.textStyles?.textFontFamily;
+        if (font == null)
+            return null;
+        return !STYLE_RULES.fontFamilyKeys.has(font)
+            ? `"textFontFamily" "${font}" is not a recognized font family key`
+            : null;
+    },
+    // textStyleOptions[category].style — fontSize, fontFamily, lineHeight, letterSpacing
+    ...TEXT_STYLE_OPTION_KEYS.map((category) => (args) => {
+        const style = args.textStyles?.textStyleOptions?.[category]?.style;
+        if (!style)
+            return null;
+        return validateStringStyleAttrs(`textStyleOptions.${category}.style`, style);
+    }),
+];

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

@@ -0,0 +1,4 @@
+import type { UpdateHeaderArguments } from '../../parsers/ai-toolcall-parser';
+type HeaderCheck = (args: UpdateHeaderArguments) => string | null;
+export declare const HEADER_CHECKS: HeaderCheck[];
+export {};

package/lib/src/metadata-builder/builders/section-rules/header.rules.js

@@ -0,0 +1,41 @@
+import { HEADER_DISPLAY_STYLE_CONFIGS } from '../../../brand-page/constants/sections/header-display.constants';
+import { validateLogoSize } from '../../sanitizers/section-args-validator';
+import { PAGE_RULES, STYLE_RULES } from '../../sanitizers/sanitizer-rules';
+export const HEADER_CHECKS = [
+    // Display style + nav type compatibility per viewport
+    ...['desktop', 'mobile'].map((viewport) => (args) => {
+        const overrides = args[viewport];
+        if (!overrides?.nav_display_type || !overrides?.display_style)
+            return null;
+        const compatible = HEADER_DISPLAY_STYLE_CONFIGS.some((c) => c.option.value === overrides.display_style &&
+            c.supportedNavTypes.includes(overrides.nav_display_type));
+        return compatible
+            ? null
+            : `Incompatible ${viewport} combination: display_style "${overrides.display_style}" is not compatible with nav_display_type "${overrides.nav_display_type}".`;
+    }),
+    // Nav link font per viewport
+    ...['desktop', 'mobile'].map((viewport) => (args) => {
+        const font = args[viewport]?.link_text_font;
+        if (font == null)
+            return null;
+        return !STYLE_RULES.fontFamilyNames.has(font)
+            ? `"${viewport}.link_text_font" "${font}" is not a recognized font family`
+            : null;
+    }),
+    // Logo sizes per viewport
+    ...['desktop', 'mobile'].flatMap((viewport) => [
+        (args) => validateLogoSize(`${viewport}.logo_image_height`, args[viewport]?.logo_image_height, viewport),
+        (args) => validateLogoSize(`${viewport}.logo_image_width`, args[viewport]?.logo_image_width, viewport),
+    ]),
+    // Nav route display name length (returns first violation — retry loop handles the rest)
+    (args) => {
+        for (let i = 0; i < (args.nav_routes ?? []).length; i++) {
+            const displayName = args.nav_routes[i].display_name;
+            if (displayName != null &&
+                displayName.length > PAGE_RULES.navDisplayName) {
+                return `nav_routes[${i}].display_name exceeds the maximum length of ${PAGE_RULES.navDisplayName} characters (got ${displayName.length})`;
+            }
+        }
+        return null;
+    },
+];

package/lib/src/metadata-builder/builders/section-rules/image-gallery.rules.d.ts

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateImageGallery(args: Record<string, unknown>, ctx: ValidationContext): string[];

package/lib/src/metadata-builder/builders/section-rules/image-gallery.rules.js

@@ -0,0 +1,10 @@
+import { MAX_TITLE_LENGTH } from '../../../brand-page/constants/font.constants';
+import { enumCheck, itemRteStyleCheck, itemTextCheck, runChecks, } from '../../sanitizers/section-args-validator';
+const CHECKS = [
+    itemTextCheck('images', 'caption', MAX_TITLE_LENGTH),
+    itemRteStyleCheck('images', 'caption'),
+    enumCheck('gallery_type', ['grid', 'carousel', 'masonry'], 'image-gallery'),
+];
+export function validateImageGallery(args, ctx) {
+    return runChecks(CHECKS, args, ctx);
+}

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

@@ -0,0 +1,2 @@
+import { type ValidationContext } from '../../sanitizers/section-args-validator';
+export declare function validateImagesSection(args: Record<string, unknown>, ctx: ValidationContext): string[];