@designcrowd/library.brand-page 6.2.11 → 6.2.12

package/lib/src/brand-page-maker/stores/brandpage-maker/brandpage-maker-store.d.ts

@@ -28,6 +28,8 @@ export interface InitialisePayload {
     logoVariationImageUrls: string[];
     shopConfigData: string | ShopConfigData;
     isServerRenderOverride?: boolean;
+    /** The maker had no saved data and built the site with `createInitialBrandPage`. */
+    isBlankSite?: boolean;
 }
 export interface SetIsSavingPayload {
     isSaving: boolean;
@@ -139,6 +141,9 @@ export declare const useBrandPageMakerStore: import("pinia").StoreDefinition<"br
     setHideBranding(payload: {
         hideBranding: boolean;
     }): void;
+    setSaveContactButtonTextStyle(payload: {
+        buttonTextStyle: SaveContactOptions["buttonTextStyle"];
+    }): void;
     setSensitiveContent(payload: {
         sensitiveContent: string;
     }): void;
@@ -241,7 +246,7 @@ export declare const useBrandPageMakerStore: import("pinia").StoreDefinition<"br
         brandPageType: BrandPageType;
     }): void;
     initialiseStoresByBrandPageModelAsync(brandPageModel: BrandPageModel): Promise<void>;
-    initialise({ brandPage, brandPageType, logoDraftDesignAttributes, unsplashApplicationName, templateCategories, personalisationData, isPersonalisationEnabled, userPromptContentKey, showAiTemplatesTab, businessName, industry, layout, logoVariationImageUrls, shopConfigData: _shopConfigData, isServerRenderOverride, }: InitialisePayload): Promise<void>;
+    initialise({ brandPage, brandPageType, logoDraftDesignAttributes, unsplashApplicationName, templateCategories, personalisationData, isPersonalisationEnabled, userPromptContentKey, showAiTemplatesTab, businessName, industry, layout, logoVariationImageUrls, shopConfigData: _shopConfigData, isServerRenderOverride, isBlankSite, }: InitialisePayload): Promise<void>;
     initialisePages({ pages, sections, }: {
         pages: PageModel[];
         sections: PageSettingsStateSections;

package/lib/src/brand-page-maker/stores/brandpage-maker/brandpage-maker-store.js

@@ -1,4 +1,4 @@
-import { EMPTY_LOGO_IMAGE_MODEL, SENSITIVE_CONTENT_TYPES, TEXT_STYLE_TYPES, VIEWPORTS, } from '@brand-page';
+import { EMPTY_LOGO_IMAGE_MODEL, SENSITIVE_CONTENT_TYPES, VIEWPORTS, } from '@brand-page';
 import { BackgroundStyles, BRAND_PAGE_TYPES, BrandPageModel, CONTENT_TYPES, NavigationDesktop, NavigationMobile, } from '@brand-page';
 import { useBrandPageMakerUserStore } from '../user';
 import { useAiWebsiteBuilderThreadStore } from '../ai-thread/ai-website-builder-thread-store';
@@ -22,10 +22,10 @@ import { useUiContentSettingsStore } from '@shared/content-settings/store';
 import { setContentSettingsAddContentOptions } from './brandpage-maker-store-utils';
 import { useAdminLogoSettingsStore } from '../admin-logo-settings';
 import { useUiPageSettingsStore } from '@shared/page-settings/store';
-import { mapBrandPageContentToContentSettingsItem, removeContentFieldValues, removeLogoTemplateModel, transformToRTE, } from '@brand-page-maker/utils';
-import { useExternalRichTextEditor } from '@brand-page-maker/composables/rich-text-editor/useRichTextEditor';
+import { mapBrandPageContentToContentSettingsItem, removeContentFieldValues, removeLogoTemplateModel, } from '@brand-page-maker/utils';
 import { UI_DEVICE_MODES, UI_SCREENSIZE_MODES, } from '@shared/models';
 import { PAGE_SECTIONS } from '@shared/page-settings/models';
+import { applyBlankSiteTextRoles } from '@brand-page-maker/models/content-settings';
 import { toPageModels } from '@shared/page-settings/utils';
 import { useUiTemplateSettingsStore } from '@shared/template-settings/store';
 import { useBrandPageContainerStore } from '../brandpage-container';
@@ -119,6 +119,11 @@ export const useBrandPageMakerStore = defineStore('brandPageMaker', {
         setHideBranding(payload) {
             this.saveContactSettings.hideBranding = payload.hideBranding;
         },
+        // No maker control writes it, so a load is its only way in. Set even when absent, so the
+        // previous site's value is never saved into this one.
+        setSaveContactButtonTextStyle(payload) {
+            this.saveContactSettings.buttonTextStyle = payload.buttonTextStyle;
+        },
         setSensitiveContent(payload) {
             this.sensitiveContent = payload.sensitiveContent;
         },
@@ -882,6 +887,9 @@ export const useBrandPageMakerStore = defineStore('brandPageMaker', {
             // dangling `var(--…)` refs. No `ensurePaletteRoles` — an applied model is
             // already migrated; role top-up belongs on the initial load path only.
             useUiColorPaletteStore().setColors(brandPageModel.styles?.colors ?? []);
+            this.setSaveContactButtonTextStyle({
+                buttonTextStyle: brandPageModel.saveContactSettings?.buttonTextStyle,
+            });
             // Apply button style config CSS (border-radius, box-shadow) to match
             // the selectedButtonStyleId. setState sets the raw model values but
             // doesn't derive the config-specific CSS that setSelectedButtonStyle does.
@@ -890,13 +898,8 @@ export const useBrandPageMakerStore = defineStore('brandPageMaker', {
                     id: buttonStyles.selectedButtonStyleId,
                 });
             }
-            const { externalEditor } = useExternalRichTextEditor();
-            transformToRTE(pageSettingsStore, externalEditor, undefined, undefined, TEXT_STYLE_TYPES.titles, textStyles.textStyleOptions.titles.style);
-            transformToRTE(pageSettingsStore, externalEditor, undefined, undefined, TEXT_STYLE_TYPES.headings, textStyles.textStyleOptions.headings.style);
-            transformToRTE(pageSettingsStore, externalEditor, undefined, undefined, TEXT_STYLE_TYPES.paragraphs, textStyles.textStyleOptions.paragraphs.style);
-            externalEditor.destroy();
         },
-        async initialise({ brandPage, brandPageType, logoDraftDesignAttributes, unsplashApplicationName, templateCategories, personalisationData, isPersonalisationEnabled, userPromptContentKey, showAiTemplatesTab = false, businessName, industry, layout, logoVariationImageUrls, shopConfigData: _shopConfigData, isServerRenderOverride = false, }) {
+        async initialise({ brandPage, brandPageType, logoDraftDesignAttributes, unsplashApplicationName, templateCategories, personalisationData, isPersonalisationEnabled, userPromptContentKey, showAiTemplatesTab = false, businessName, industry, layout, logoVariationImageUrls, shopConfigData: _shopConfigData, isServerRenderOverride = false, isBlankSite = false, }) {
             const brandPageContainerStore = useBrandPageContainerStore();
             const userStore = useBrandPageMakerUserStore();
             const uiStore = useUiStore();
@@ -932,6 +935,8 @@ export const useBrandPageMakerStore = defineStore('brandPageMaker', {
                     isUserDraft: this.isUserDraft,
                     isServerRender: isServerRenderOverride,
                 });
+                if (isBlankSite)
+                    applyBlankSiteTextRoles(brandPageModel);
                 const userPersonalisation = personalisationData && personalisationData.length > 0
                     ? personalisationData[await getAiContentIndexByTemplateTokenAndNumberOfVariations(this.selectedTemplateId, personalisationData.length)].userPersonalisation
                     : undefined;
@@ -1141,6 +1146,9 @@ export const useBrandPageMakerStore = defineStore('brandPageMaker', {
                 this.setHideBranding({
                     hideBranding: brandPageModel.saveContactSettings?.hideBranding ?? false,
                 });
+                this.setSaveContactButtonTextStyle({
+                    buttonTextStyle: brandPageModel.saveContactSettings?.buttonTextStyle,
+                });
                 this.businessName = businessName;
                 this.industry = industry;
             }

package/lib/src/brand-page-maker/stores/history/history-store.d.ts

@@ -29,6 +29,15 @@ export declare const useHistoryStore: import("pinia").StoreDefinition<"history",
     isApplyingSnapshot: import("vue").Ref<boolean, boolean>;
     snapshotAppliedToken: import("vue").Ref<number, number>;
     rteResyncToken: import("vue").Ref<number, number>;
+    rteResyncExcept: import("vue").Ref<{
+        id: string;
+        name: string;
+        from: number;
+    } | undefined, {
+        id: string;
+        name: string;
+        from: number;
+    } | undefined>;
     baselineCaptured: import("vue").Ref<boolean, boolean>;
     canUndo: import("vue").ComputedRef<boolean>;
     canRedo: import("vue").ComputedRef<boolean>;
@@ -41,18 +50,36 @@ export declare const useHistoryStore: import("pinia").StoreDefinition<"history",
     captureTemplateSwitch: (label?: string) => "committed" | "oversized" | "noop" | "skipped";
     captureAiChangeset: (label?: string) => "committed" | "oversized" | "noop" | "skipped";
     mergeNextMutation: () => void;
-    markRteResync: () => void;
+    markRteResync: (options?: {
+        except?: {
+            id: string;
+            name: string;
+        };
+    }) => void;
+    isRteResyncExcepted: (field: {
+        id: string;
+        name: string;
+    }, sinceToken: number) => boolean;
     undo: () => Promise<void>;
     redo: () => Promise<void>;
     reset: () => void;
     getCurrentSizeBytes: () => number;
     getCurrentEntryCount: () => number;
-}, "entries" | "currentIndex" | "isApplyingSnapshot" | "snapshotAppliedToken" | "rteResyncToken" | "baselineCaptured">, Pick<{
+}, "entries" | "currentIndex" | "isApplyingSnapshot" | "snapshotAppliedToken" | "rteResyncToken" | "rteResyncExcept" | "baselineCaptured">, Pick<{
     entries: import("vue").ShallowRef<HistoryEntry[], HistoryEntry[]>;
     currentIndex: import("vue").Ref<number, number>;
     isApplyingSnapshot: import("vue").Ref<boolean, boolean>;
     snapshotAppliedToken: import("vue").Ref<number, number>;
     rteResyncToken: import("vue").Ref<number, number>;
+    rteResyncExcept: import("vue").Ref<{
+        id: string;
+        name: string;
+        from: number;
+    } | undefined, {
+        id: string;
+        name: string;
+        from: number;
+    } | undefined>;
     baselineCaptured: import("vue").Ref<boolean, boolean>;
     canUndo: import("vue").ComputedRef<boolean>;
     canRedo: import("vue").ComputedRef<boolean>;
@@ -65,7 +92,16 @@ export declare const useHistoryStore: import("pinia").StoreDefinition<"history",
     captureTemplateSwitch: (label?: string) => "committed" | "oversized" | "noop" | "skipped";
     captureAiChangeset: (label?: string) => "committed" | "oversized" | "noop" | "skipped";
     mergeNextMutation: () => void;
-    markRteResync: () => void;
+    markRteResync: (options?: {
+        except?: {
+            id: string;
+            name: string;
+        };
+    }) => void;
+    isRteResyncExcepted: (field: {
+        id: string;
+        name: string;
+    }, sinceToken: number) => boolean;
     undo: () => Promise<void>;
     redo: () => Promise<void>;
     reset: () => void;
@@ -77,6 +113,15 @@ export declare const useHistoryStore: import("pinia").StoreDefinition<"history",
     isApplyingSnapshot: import("vue").Ref<boolean, boolean>;
     snapshotAppliedToken: import("vue").Ref<number, number>;
     rteResyncToken: import("vue").Ref<number, number>;
+    rteResyncExcept: import("vue").Ref<{
+        id: string;
+        name: string;
+        from: number;
+    } | undefined, {
+        id: string;
+        name: string;
+        from: number;
+    } | undefined>;
     baselineCaptured: import("vue").Ref<boolean, boolean>;
     canUndo: import("vue").ComputedRef<boolean>;
     canRedo: import("vue").ComputedRef<boolean>;
@@ -89,10 +134,19 @@ export declare const useHistoryStore: import("pinia").StoreDefinition<"history",
     captureTemplateSwitch: (label?: string) => "committed" | "oversized" | "noop" | "skipped";
     captureAiChangeset: (label?: string) => "committed" | "oversized" | "noop" | "skipped";
     mergeNextMutation: () => void;
-    markRteResync: () => void;
+    markRteResync: (options?: {
+        except?: {
+            id: string;
+            name: string;
+        };
+    }) => void;
+    isRteResyncExcepted: (field: {
+        id: string;
+        name: string;
+    }, sinceToken: number) => boolean;
     undo: () => Promise<void>;
     redo: () => Promise<void>;
     reset: () => void;
     getCurrentSizeBytes: () => number;
     getCurrentEntryCount: () => number;
-}, "reset" | "captureBaseline" | "capture" | "captureTemplateSwitch" | "captureAiChangeset" | "mergeNextMutation" | "markRteResync" | "undo" | "redo" | "getCurrentSizeBytes" | "getCurrentEntryCount">>;
+}, "reset" | "undo" | "redo" | "captureBaseline" | "capture" | "captureTemplateSwitch" | "captureAiChangeset" | "mergeNextMutation" | "markRteResync" | "isRteResyncExcepted" | "getCurrentSizeBytes" | "getCurrentEntryCount">>;

package/lib/src/brand-page-maker/stores/history/history-store.js

@@ -45,6 +45,9 @@ export const useHistoryStore = defineStore('history', () => {
     // (ephemeral, never part of a snapshot) so undo/redo can't restore a stale
     // value and trigger a spurious re-seed.
     const rteResyncToken = ref(0);
+    // The field (content id + field name) a resync leaves mounted: its own editor wrote the doc.
+    // `from` is the first token of the unbroken run of resyncs that each excepted it.
+    const rteResyncExcept = ref();
     const baselineCaptured = ref(false);
     const watcherInstalled = ref(false);
     let baselineCapturedAt = 0;
@@ -503,8 +506,23 @@ export const useHistoryStore = defineStore('history', () => {
     }
     // Signal mounted RTE editors to re-seed from the store after an external
     // (non-history) replacement of their content — see rteResyncToken.
-    function markRteResync() {
-        rteResyncToken.value += 1;
+    function markRteResync(options) {
+        const except = options?.except;
+        const current = rteResyncExcept.value;
+        const token = rteResyncToken.value + 1;
+        const continues = !!except && current?.id === except.id && current.name === except.name;
+        rteResyncExcept.value = except
+            ? { ...except, from: continues ? current.from : token }
+            : undefined;
+        rteResyncToken.value = token;
+    }
+    // Watchers batch, so one reaction can cover several resyncs: a field stays mounted only if every
+    // resync after `sinceToken` excepted it.
+    function isRteResyncExcepted(field, sinceToken) {
+        const except = rteResyncExcept.value;
+        return (except?.id === field.id &&
+            except.name === field.name &&
+            except.from <= sinceToken + 1);
     }
     return {
         // State
@@ -513,6 +531,7 @@ export const useHistoryStore = defineStore('history', () => {
         isApplyingSnapshot,
         snapshotAppliedToken,
         rteResyncToken,
+        rteResyncExcept,
         baselineCaptured,
         // Getters
         canUndo,
@@ -524,6 +543,7 @@ export const useHistoryStore = defineStore('history', () => {
         captureAiChangeset,
         mergeNextMutation,
         markRteResync,
+        isRteResyncExcepted,
         undo,
         redo,
         reset,

package/lib/src/brand-page-maker/utils/apply-color-strategy.js

@@ -1,8 +1,9 @@
 import { BRAND_PAGE_TYPES } from '@brand-page';
-import { FIELD_SLOT_MAP, raisedLayerFor, strategyRoleRefForField, } from '@shared/color-strategies/color-strategies';
+import { FIELD_SLOT_MAP, raisedLayerFor, STYLE_FIELDS_OUTSIDE_CONFIG, strategyRoleRefForField, } from '@shared/color-strategies/color-strategies';
 import { isTransparentDisabled, } from '@shared/content-settings/disable-transparent.util';
 import { setRteTextColor } from '@shared/color-strategies/rte-color';
 import { pairedRteTextField } from '@shared/color-strategies/rte-field-pairs';
+import { isCanonicalTextStyleType } from '@brand-page/models/styles.model';
 /**
  * Field types a strategy can assign. `color` fields hold nothing but a colour and are
  * REPLACED via their `valueConvertor`; `text-style` fields hold typography *and* a
@@ -14,11 +15,27 @@ const ASSIGNABLE_FIELD_TYPES = new Set(['color', 'text-style']);
  * mapped to a slot, AND currently visible (the same `visibilityAssessor` the settings
  * panel uses). Shared by the picker's visibility gate and the applier, so the picker is
  * only shown when applying would actually change something.
+ *
+ * Plus any `STYLE_FIELDS_OUTSIDE_CONFIG` whose followed field made the list.
  */
-const assignableColorFields = (config, content, context) => Object.entries(config.fields).filter(([name, field]) => !!field?.type &&
-    ASSIGNABLE_FIELD_TYPES.has(field.type) &&
-    !!FIELD_SLOT_MAP[name] &&
-    (!field.visibilityAssessor || field.visibilityAssessor(content, context)));
+const assignableColorFields = (config, content, context) => {
+    const assignable = Object.entries(config.fields).filter(([name, field]) => !!field?.type &&
+        ASSIGNABLE_FIELD_TYPES.has(field.type) &&
+        !!FIELD_SLOT_MAP[name] &&
+        (!field.visibilityAssessor || field.visibilityAssessor(content, context)));
+    // One with no canonical role yet is skipped: a colour written alone would link no role.
+    const outsideConfig = Object.entries(STYLE_FIELDS_OUTSIDE_CONFIG[config.type] ?? {})
+        .filter(([name, { follows }]) => {
+        const style = content?.[name];
+        return (isCanonicalTextStyleType(style?.textStyleType) &&
+            assignable.some(([assigned]) => assigned === follows));
+    })
+        .map(([name, { textField }]) => [
+        name,
+        { type: 'text-style', textField },
+    ]);
+    return [...assignable, ...outsideConfig];
+};
 /**
  * Whether a strategy would actually assign at least one colour on THIS section as
  * it stands (mapped + visible). Used to hide the picker where applying would be a
@@ -111,9 +128,10 @@ export const buildColorStrategyValues = (config, content, strategyId, context, a
             // `setRteTextColor` returns undefined for a plain string or legacy HTML RTE, so
             // that doubles as the "nothing to do" test — no separate type guard here.
             const sectionType = contentRecord.type;
-            const textField = typeof sectionType === 'string'
-                ? pairedRteTextField(sectionType, name)
-                : undefined;
+            const textField = field.textField ??
+                (typeof sectionType === 'string'
+                    ? pairedRteTextField(sectionType, name)
+                    : undefined);
             if (textField) {
                 const nextDoc = setRteTextColor(contentRecord[textField], ref);
                 if (nextDoc) {

package/lib/src/brand-page-maker/utils/index.d.ts

@@ -5,5 +5,6 @@ export * from './url.util';
 export * from './slug.util';
 export * from './text.util';
 export * from './rich-text-editor.util';
-export * from './rte-render.util';
+export * from '@shared/rte-render.util';
 export * from './rte-sanitize.util';
+export * from './rte-authoring.util';

package/lib/src/brand-page-maker/utils/index.js

@@ -5,5 +5,6 @@ export * from './url.util';
 export * from './slug.util';
 export * from './text.util';
 export * from './rich-text-editor.util';
-export * from './rte-render.util';
+export * from '@shared/rte-render.util';
 export * from './rte-sanitize.util';
+export * from './rte-authoring.util';

package/lib/src/brand-page-maker/utils/rich-text-editor.util.d.ts

@@ -1,21 +1,114 @@
 import type { ChainedCommands, Editor, JSONContent } from '@tiptap/vue-3';
 import type { EditorState, Transaction, Selection } from 'prosemirror-state';
-import { type Content, type TextStyleDeclaration, type TextStyleType, type RichTextValue } from '@brand-page';
-import type { PageSettingsState } from '@shared/page-settings/store';
-import type { StyleSettingsState } from '@shared/style-settings/store';
-import type { Mark } from 'prosemirror-model';
+import { type TextStyleDeclaration, type RichTextValue } from '@brand-page';
+import type { Mark, Node as ProseMirrorNode } from 'prosemirror-model';
 import { type DOMPurify } from 'dompurify';
-import { isTiptapDocument, isRteHtmlString } from './rte-shape';
-export { isTiptapDocument, isRteHtmlString };
+export { getRteJsonPlainText, isRteHtmlString, isTiptapDocument, } from '@shared/rte-shape.util';
+/**
+ * BP-5969 (ADR-0019, Option B): a block linked to a CANONICAL role gets its typography
+ * from the page-scoped CSS class (`text-role-css.util`), so authoring must NOT bake
+ * family/size/spacing/line-height/weight/style/decoration into the marks — a value baked
+ * post-migration would pin the block forever (migration-22 never re-runs to strip it).
+ * Colour is exempt (it isn't in the class). Legacy/unlinked types have no class, so they
+ * still bake inline. Mirrors `TextWrapper`'s canonical-only `roleClass`.
+ */
+export declare const isCanonicalLinked: (style: {
+    textStyleType?: string | undefined;
+} | undefined) => boolean;
+/** True when a mark value is a role reference (`var(--role-…)`) rather than a literal. */
+export declare const isRoleVarRef: (value: unknown) => value is string;
+/**
+ * Normalise a typography value for a role-equality compare: quote-strip + trim for fontFamily,
+ * trim otherwise, then fold a prop's default keyword (`normal`/`none`) to '' so it matches a role
+ * that leaves the prop unset (`'normal'`/`'none'`/absent are the same override-wise).
+ */
+export declare const normTypographyValue: (key: string, value?: string) => string;
+/**
+ * BP-5969 — the RTE mark value to write for a typography attr change: the role var (so the run
+ * stays linked and follows role edits) when the picked value equals the linked role, else the
+ * literal raw override. `roleStyle` undefined (legacy/unlinked block, no role class to resolve a
+ * var) → always the literal. The equality test runs at the mutation point, per ADR-0019.
+ */
+export declare const roleVarOrLiteral: (markAttr: string, picked: string, roleStyle: TextStyleDeclaration | undefined) => string;
+declare const BLOCK_TYPOGRAPHY_ATTRS: readonly ["fontFamily", "fontSize", "lineHeight", "letterSpacing", "fontWeight", "fontStyle", "textDecoration"];
+type BlockTypographyAttr = (typeof BLOCK_TYPOGRAPHY_ATTRS)[number];
+export declare const LEGACY_TYPOGRAPHY_MARKS: Partial<Record<BlockTypographyAttr, string[]>>;
+/**
+ * A run's marks without the legacy semantic marks (`<strong>`/`<em>`/`<u>`/`<s>`) that compete with
+ * `attrs`. A link keeps its underline, as Reset does (`restoreLinkUnderlines`).
+ */
+export declare const withoutTypographyMarks: <M extends {
+    type: string;
+}>(marks: readonly M[], attrs: readonly BlockTypographyAttr[], isLink: boolean) => M[];
+/**
+ * One text run's typography: its `textStyle` attrs, falling back to a legacy semantic mark
+ * (`<strong>`/`<em>`/`<u>`/`<s>`) for un-migrated / pasted runs (mirrors `formatting.ts` `effective`).
+ * An absent attr is undefined — the run inherits the role class.
+ */
+export declare const runTypography: (node: ProseMirrorNode) => Record<BlockTypographyAttr, string | undefined>;
+/**
+ * True when any run's typography differs from `role` — the role dropdown's asterisk. Unlike
+ * `readBlockTypography`, one bold word counts. Absent attrs and role refs follow the role.
+ */
+export declare const hasRunTypographyOverride: (editor: Editor, role: Record<string, unknown>) => boolean;
+/**
+ * "Apply changes to all", on the live editor: every run value now equal to `role` becomes its
+ * `var(--role-*)` ref (or is unset when the role leaves the attr undefined), and the legacy mark it
+ * came from is dropped. A value that still differs — a word-level override — stays. Colour and the
+ * selection are untouched. The editor twin of `relinkRoleEqualMarks`; the caller runs the chain.
+ */
+export declare const relinkRoleEqualRunsChain: (editor: Editor, role: Record<string, unknown>, previousRole?: Record<string, unknown>) => ChainedCommands;
+/**
+ * The block's whole-box typography — what "Apply changes to all" can promote into the role. A prop
+ * is included only when UNIFORM across every text run: one bold word has no single value to promote
+ * (`hasRunTypographyOverride` still flags it). A role-var ref rides through as the block value; the
+ * caller (`getTypographyOverride`) treats it as "linked", not an override.
+ */
+export declare const readBlockTypography: (editor: Editor) => Record<string, string>;
+/**
+ * BP-5969 — build the "reset to role" chain for the whole selection: re-link every typography attr
+ * the role DEFINES to its `var(--role-*)` token (self-describing, follows future role edits), unset
+ * the attrs the role leaves undefined, and clear the legacy semantic marks (bold/italic/underline/
+ * strike) that the attr resets don't touch. Returns the un-run chain so the caller can wrap it in
+ * `skipStyleDetection` (keeping the role link) before running. Colour marks are left alone.
+ */
+export declare const relinkTypographyChain: (editor: Editor, role: Record<string, unknown> | undefined) => ChainedCommands;
+/**
+ * A chain step that puts the underline back on link text that had one before the chain cleared
+ * every underline: a link's underline is its own look, not a typography choice (`typographyAttrsOf`).
+ * Captures the link ranges now, so build it before the chain changes the doc; mark steps keep
+ * positions, so the ranges still hold when it runs.
+ */
+export declare const restoreLinkUnderlines: (editor: Editor) => ((props: {
+    tr: Transaction;
+}) => boolean);
+/**
+ * The document-level twin of `relinkTypographyChain`, for a block that isn't being edited: each run's
+ * typography literal that equals any of `roles` (a literal the asterisk never counted as an override)
+ * becomes the `var(--role-*)` ref when `roles[0]` — the role the block links now — defines the attr,
+ * else it's unset. Literals that differ from every role, role refs, colour and link marks are left
+ * alone. Returns the same doc when nothing changes.
+ */
+export declare const relinkRoleEqualMarks: (doc: JSONContent, roles: readonly (Record<string, unknown> | undefined)[]) => JSONContent;
+/**
+ * BP-5969 (R19) — the stored-document twin of `relinkTypographyChain`'s reset-to-role chain, for a
+ * doc that isn't mounted in an editor (the AI boundary's role switch). Unlike `relinkRoleEqualMarks`
+ * (which only relinks a literal that already equals a role), every run's typography is reset to
+ * `role` — a deliberate accent override included — mirroring the maker's Reset: a `var(--role-*)`
+ * ref where `role` defines the attr, else unset. The legacy semantic marks (bold/italic/underline/
+ * strike) that the attr resets don't touch are dropped too. Colour and link marks are left alone.
+ *
+ * `styleOverrides` is the call's own surviving style-object override — e.g. a switch call that
+ * also sends `fontFamily: 'Playfair Display'`. Those attrs are nulled, not ref'd: the render fill
+ * (`fillRteRunTypography`) treats a non-null mark value as final, so baking the ref here would bury
+ * the override under it; nulling leaves the render fill free to resolve the literal from the style
+ * object, same as any other block-level override.
+ */
+export declare const relinkDocToRole: (doc: JSONContent, role: Record<string, unknown> | undefined, styleOverrides?: Record<string, unknown>) => JSONContent;
 export declare const RTE_ALLOWED_SECTION_TYPES: string[];
 export declare const isRTEManagedStyleField: (sectionType: string, fieldName: string) => boolean;
 export declare const isStyleChanged: (tr: Transaction) => boolean;
 export declare const skipStyleDetection: (chain: ChainedCommands, marks?: Mark[]) => ChainedCommands;
-/**
- * Extract visible plain text from a Tiptap JSON document (concatenated text
- * nodes). Dependency-free — no editor instantiation.
- */
-export declare const getRteJsonPlainText: (doc: JSONContent) => string;
 export declare const hasRTEContent: (content: unknown) => boolean;
 export declare const getPlainTextFromRTE: (content: unknown) => string;
 /**
@@ -36,10 +129,19 @@ export declare const getPlainTextFromRTE: (content: unknown) => string;
  */
 export declare const getRteTextLength: (value: RichTextValue | null | undefined) => number;
 export declare const replaceTextInRTE: (existingHtml: string, newText: string) => string;
-export declare const transformToRTE: (uiPageSettingStore: PageSettingsState, externalEditor: Editor, uiStyleSettingsStore?: StyleSettingsState, newContent?: Content, type?: TextStyleType, newStyle?: TextStyleDeclaration) => void;
-export declare const switchAllContentToRTE: (uiPageSettingStore: PageSettingsState, externalEditor: Editor, uiStyleSettingsStore?: StyleSettingsState) => void;
-export declare const getUpdatedHTMLFromEditor: (externalEditor: Editor, contentText: RichTextValue, newContentStyle: TextStyleDeclaration) => string | import("@tiptap/core").DocumentType<Record<string, any> | undefined, import("@tiptap/core").NodeType<string, Record<string, any> | undefined, any, (import("@tiptap/core").NodeType<any, any, any, any> | import("@tiptap/core").TextType<import("@tiptap/core").MarkType<any, any>>)[]>[]>;
-export declare const buildInitialMarks: (state: EditorState, style: TextStyleDeclaration) => any[];
+/**
+ * Helper to build stored marks from a style declaration. BP-5969: when `bakeTypography`
+ * is false (a canonical-role block — the class supplies typography), only colour and
+ * highlight are baked; family/size/spacing/line-height/weight/style/decoration are left
+ * to the role class so freshly-typed text follows the role and repaints on a role edit.
+ */
+export declare const buildInitialMarks: (state: EditorState, style: TextStyleDeclaration, bakeTypography?: boolean) => any[];
+/**
+ * The first-type seed for an empty field, with what the customer picked before typing laid over it:
+ * a picked mark wins per attribute (its unset attrs keep the seed's), and a picked mark the seed
+ * lacks is added. With nothing picked, the seed as is.
+ */
+export declare const mergePickedMarks: (seed: readonly Mark[], picked: readonly Mark[] | null | undefined) => Mark[];
 export declare const retainStyleOnEmptyLine: (editor: Editor, selection: Selection) => void;
 export interface SanitizationResult {
     sanitizedHtml: string;