@designcrowd/library.brand-page 6.0.25-json-prereq-2 → 6.0.25

package/lib/src/brand-page-maker/composables/rich-text-editor/getRteExtensions.js

@@ -1,90 +0,0 @@
-import StarterKit from '@tiptap/starter-kit';
-import Underline from '@tiptap/extension-underline';
-import { TextStyle, FontSize, LineHeight } from '@tiptap/extension-text-style';
-import TextAlign from '@tiptap/extension-text-align';
-import ColorExtension from '@tiptap/extension-color';
-import Highlight from '@tiptap/extension-highlight';
-import Placeholder from '@tiptap/extension-placeholder';
-import Link from '@tiptap/extension-link';
-import { FontFamily } from './extensions/FontFamily';
-import { LetterSpacing } from './extensions/LetterSpacing';
-import { MaxLength } from './extensions/MaxLength';
-import { AutoLink } from './extensions/AutoLink';
-import { isHrefPageId } from './hyperlink';
-export const getRteExtensions = (options = {}) => {
-    const { restrictStarterKit = false, includeLinkRel = false, editing, } = options;
-    const extensions = [
-        // v3 StarterKit bundles Link + Underline; we register both separately (with
-        // custom Link config), so disable the bundled copies to avoid duplicate
-        // extension errors.
-        // trailingNode: false — v3 StarterKit adds a TrailingNode plugin (not in v2)
-        // that appends an empty paragraph after any non-paragraph trailing block.
-        // Disabled to keep editor/stored-content behaviour identical to v2 (BP-5787
-        // is backward-compat-first); revisit as a standalone UX change if wanted.
-        restrictStarterKit
-            ? StarterKit.configure({
-                link: false,
-                underline: false,
-                trailingNode: false,
-                bulletList: false,
-                orderedList: false,
-                listItem: false,
-                horizontalRule: false,
-                codeBlock: false,
-                code: false,
-            })
-            : StarterKit.configure({
-                link: false,
-                underline: false,
-                trailingNode: false,
-            }),
-        Underline,
-        // priority: 99 — render the textStyle <span> (which carries font-size) as the
-        // OUTERMOST inline mark, so decoration marks (<u>/<s>) nest INSIDE it and
-        // inherit the applied font-size. v3's extension-text-style defaults to
-        // priority 101, which flips this: <u>/<s> end up outside the font-size span
-        // and inherit only the base paragraph size. Since text-decoration thickness
-        // AND vertical position are computed from the decorating element's own font,
-        // that produced thin, mis-centred underline/strike on large text — a
-        // regression vs v2's serializer, which emitted the font-size span outermost
-        // (BP-5787, backward-compat-first).
-        TextStyle.extend({ priority: 99 }).configure({
-            mergeNestedSpanStyles: true,
-        }),
-        TextAlign.configure({
-            types: ['heading', 'paragraph'],
-        }),
-        FontFamily.configure({
-            types: ['textStyle'],
-        }),
-        // FontSize + LineHeight are now shipped natively by @tiptap/extension-text-style.
-        FontSize.configure({ types: ['textStyle'] }),
-        LetterSpacing,
-        LineHeight.configure({ types: ['textStyle'] }),
-        ColorExtension.configure({
-            types: ['textStyle'],
-        }),
-        Highlight.configure({
-            multicolor: true,
-        }),
-    ];
-    // Live-editing-only plugins sit between Highlight and Link (original order).
-    if (editing) {
-        extensions.push(Placeholder.configure({ placeholder: editing.placeholder }), MaxLength.configure({ maxLength: editing.maxLength }));
-    }
-    extensions.push(Link.configure({
-        openOnClick: false,
-        defaultProtocol: 'https',
-        autolink: true,
-        HTMLAttributes: (attrs) => {
-            const href = attrs.href;
-            const isExternal = href && (href.startsWith('http://') || href.startsWith('https://'));
-            return {
-                ...(includeLinkRel && { rel: 'noopener noreferrer' }),
-                target: isExternal ? '_blank' : null,
-            };
-        },
-        isAllowedUri: (url, ctx) => ctx.defaultValidate(url) || isHrefPageId(url),
-    }), AutoLink);
-    return extensions;
-};

package/lib/src/brand-page-maker/utils/rte-render.util.d.ts

@@ -1,41 +0,0 @@
-import type { JSONContent } from '@tiptap/vue-3';
-import { isTiptapDocument, getRteJsonPlainText } from './rich-text-editor.util';
-export { isTiptapDocument, getRteJsonPlainText };
-/**
- * BP-5787 — the boundary plumbing for storing RTE as Tiptap JSON.
- *
- * An RTE field is either a legacy inline-HTML string (pre-migration, or a
- * not-yet-migrated published site) or a Tiptap JSON document (post-migration).
- * These helpers let every consumer treat the two uniformly:
- *
- *   - isTiptapDocument — the canonical discriminator (object with type 'doc').
- *   - renderRteToHtml  — render either form to final HTML for display.
- *   - toRteJson        — normalise either form to JSON for storage.
- *
- * Both directions delegate to Tiptap's own schema-driven converters, fed by the
- * single-source-of-truth extension set (getRteExtensions) — so the mapping lives
- * in the extensions' `renderHTML`, not a hand-maintained copy that drifts when
- * Tiptap changes:
- *
- *   - renderRteToHtml uses @tiptap/static-renderer (renderToHTMLString). It is
- *     DOM-less, so it runs on the server (SSR/publish/preview), not just the
- *     browser, and needs no Editor instance.
- *   - toRteJson uses generateJSON, which PARSES HTML and so needs a DOM
- *     (window.DOMParser). In the browser and in jsdom tests that global exists;
- *     on the server the only caller is migration-20, which installs a jsdom
- *     window around its conversion pass (see migration/migration-20.ts).
- */
-export type RichTextValue = string | JSONContent;
-/**
- * Render an RTE value to final HTML. Legacy HTML strings pass through untouched
- * (they are already HTML); Tiptap JSON is serialised by @tiptap/static-renderer
- * from the extension schema — no editor, no DOM — so it works on the server
- * (SSR/publish), not just the browser.
- */
-export declare const renderRteToHtml: (value: RichTextValue | null | undefined) => string;
-/**
- * Normalise an RTE value to a Tiptap JSON document. HTML strings are parsed via
- * generateJSON (needs a DOM — browser/jsdom); documents pass through unchanged.
- * Returns undefined for empty/blank input so callers can omit empty fields.
- */
-export declare const toRteJson: (value: RichTextValue | null | undefined) => JSONContent | undefined;

package/lib/src/brand-page-maker/utils/rte-render.util.js

@@ -1,33 +0,0 @@
-import { generateJSON } from '@tiptap/core';
-import { renderToHTMLString } from '@tiptap/static-renderer/pm/html-string';
-import { getRteExtensions } from '../composables/rich-text-editor/getRteExtensions';
-import { isTiptapDocument, getRteJsonPlainText } from './rich-text-editor.util';
-export { isTiptapDocument, getRteJsonPlainText };
-// One extension set shared by both directions (render + parse). Schema knowledge
-// lives here, once — Tiptap/extension upgrades propagate to both automatically.
-const RTE_EXTENSIONS = getRteExtensions({ includeLinkRel: true });
-/**
- * Render an RTE value to final HTML. Legacy HTML strings pass through untouched
- * (they are already HTML); Tiptap JSON is serialised by @tiptap/static-renderer
- * from the extension schema — no editor, no DOM — so it works on the server
- * (SSR/publish), not just the browser.
- */
-export const renderRteToHtml = (value) => {
-    if (value == null || value === '')
-        return '';
-    if (typeof value === 'string')
-        return value;
-    return renderToHTMLString({ content: value, extensions: RTE_EXTENSIONS });
-};
-/**
- * Normalise an RTE value to a Tiptap JSON document. HTML strings are parsed via
- * generateJSON (needs a DOM — browser/jsdom); documents pass through unchanged.
- * Returns undefined for empty/blank input so callers can omit empty fields.
- */
-export const toRteJson = (value) => {
-    if (value == null || value === '')
-        return undefined;
-    if (isTiptapDocument(value))
-        return value;
-    return generateJSON(value, RTE_EXTENSIONS);
-};

package/lib/src/brand-page-maker/utils/rte-sanitize.util.d.ts

@@ -1,6 +0,0 @@
-import type { JSONContent } from '@tiptap/vue-3';
-/**
- * Sanitise a Tiptap JSON document (returns a new clean doc). Returns a minimal
- * empty doc if the input isn't a usable document.
- */
-export declare const sanitizeRteJson: (doc: unknown) => JSONContent;

package/lib/src/brand-page-maker/utils/rte-sanitize.util.js

@@ -1,158 +0,0 @@
-import { validateAndSanitizeHref } from './rich-text-editor.util';
-/**
- * BP-5787 — native JSON sanitiser for RTE content.
- *
- * Operates directly on the Tiptap document tree: no editor instantiation, no
- * HTML round-trip, no DOMPurify. This is the hot path (runs on every editor
- * update and on the server sanitise gate), so it is a single, allocation-light
- * recursive walk.
- *
- * Security model (mirrors the HTML allowlist it replaces):
- *  - only allow-listed node and mark types survive; everything else is dropped;
- *  - textStyle / highlight attrs are restricted to known keys whose values must
- *    be "safe CSS values" (no quotes/angle-brackets/extra declarations/url()/
- *    expression()), preventing CSS-injection when the value is later rendered
- *    into a `style="…"` attribute;
- *  - link hrefs go through the same validateAndSanitizeHref used by the HTML
- *    sanitiser; unsafe links lose their href (and the mark);
- *  - heading levels are clamped to 1–6.
- */
-// ProseMirror node types the editor schema can legitimately produce.
-const ALLOWED_NODE_TYPES = new Set([
-    'doc',
-    'paragraph',
-    'heading',
-    'text',
-    'hardBreak',
-    'bulletList',
-    'orderedList',
-    'listItem',
-    'blockquote',
-    'codeBlock',
-    'horizontalRule',
-]);
-// Inline mark types the editor produces (strong/em/u/s/code/span/mark/a).
-const ALLOWED_MARK_TYPES = new Set([
-    'bold',
-    'italic',
-    'underline',
-    'strike',
-    'code',
-    'textStyle',
-    'highlight',
-    'link',
-]);
-// textStyle attrs map to the allow-listed CSS properties (font-weight →
-// bold mark, text-decoration → underline/strike, text-align → node attr,
-// background-color → highlight, so they are intentionally not here).
-const ALLOWED_TEXT_STYLE_ATTRS = new Set([
-    'color',
-    'fontFamily',
-    'fontSize',
-    'letterSpacing',
-    'lineHeight',
-]);
-/**
- * A safe CSS value is a short string free of characters that could inject an
- * extra declaration or escape the attribute, and free of the url()/expression()
- * vectors. Legitimate values — `rgb(255, 0, 0)`, `#FF0000`,
- * `var(--logo-text-color)`, `Open Sans`, `1.5em` — all pass.
- */
-const isSafeCssValue = (value) => typeof value === 'string' &&
-    value.length > 0 &&
-    value.length <= 200 &&
-    !/[<>"';]/.test(value) &&
-    !/url\s*\(/i.test(value) &&
-    !/expression\s*\(/i.test(value);
-const sanitizeTextStyleAttrs = (attrs) => {
-    const clean = {};
-    for (const key of Object.keys(attrs)) {
-        if (!ALLOWED_TEXT_STYLE_ATTRS.has(key))
-            continue;
-        const value = attrs[key];
-        // Tiptap emits '' for unset textStyle slots — preserve them.
-        if (value === '' || value == null) {
-            clean[key] = '';
-        }
-        else if (isSafeCssValue(value)) {
-            clean[key] = value;
-        }
-        // else: drop the unsafe value
-    }
-    return Object.keys(clean).length ? clean : null;
-};
-const sanitizeMark = (mark) => {
-    const type = mark?.type;
-    if (!type || !ALLOWED_MARK_TYPES.has(type))
-        return null;
-    const attrs = mark.attrs;
-    if (type === 'link') {
-        const href = typeof attrs?.href === 'string'
-            ? validateAndSanitizeHref(attrs.href)
-            : null;
-        if (!href)
-            return null; // drop links with unsafe/empty href
-        const cleanAttrs = { href };
-        if (attrs?.target != null)
-            cleanAttrs.target = attrs.target;
-        if (attrs?.rel != null)
-            cleanAttrs.rel = attrs.rel;
-        return { type, attrs: cleanAttrs };
-    }
-    if (type === 'textStyle') {
-        const clean = attrs ? sanitizeTextStyleAttrs(attrs) : null;
-        return clean ? { type, attrs: clean } : null;
-    }
-    if (type === 'highlight') {
-        return isSafeCssValue(attrs?.color)
-            ? { type, attrs: { color: attrs.color } }
-            : { type };
-    }
-    // Plain marks (bold/italic/underline/strike/code) carry no attrs.
-    return { type };
-};
-const ALIGN_VALUES = new Set(['left', 'center', 'right', 'justify']);
-const sanitizeNode = (node) => {
-    const type = node?.type;
-    if (!type || !ALLOWED_NODE_TYPES.has(type))
-        return null;
-    const clean = { type };
-    const attrs = {};
-    if (type === 'heading') {
-        const level = Number(node.attrs?.level);
-        attrs.level = level >= 1 && level <= 6 ? level : 1;
-    }
-    if (type === 'heading' || type === 'paragraph') {
-        const align = node.attrs?.textAlign;
-        if (typeof align === 'string' && ALIGN_VALUES.has(align)) {
-            attrs.textAlign = align;
-        }
-    }
-    if (Object.keys(attrs).length)
-        clean.attrs = attrs;
-    if (typeof node.text === 'string')
-        clean.text = node.text;
-    if (Array.isArray(node.marks)) {
-        const marks = node.marks
-            .map((m) => sanitizeMark(m))
-            .filter(Boolean);
-        if (marks && marks.length)
-            clean.marks = marks;
-    }
-    if (Array.isArray(node.content)) {
-        const content = node.content
-            .map(sanitizeNode)
-            .filter(Boolean);
-        if (content.length)
-            clean.content = content;
-    }
-    return clean;
-};
-/**
- * Sanitise a Tiptap JSON document (returns a new clean doc). Returns a minimal
- * empty doc if the input isn't a usable document.
- */
-export const sanitizeRteJson = (doc) => {
-    const clean = doc && typeof doc === 'object' ? sanitizeNode(doc) : null;
-    return clean && clean.type === 'doc' ? clean : { type: 'doc', content: [] };
-};

package/src/brand-page/utils/migration/migration-20.server.test.ts

@@ -1,121 +0,0 @@
-/**
- * BP-5787 — migration-20 must convert HTML RTE → Tiptap JSON on the SERVER, not
- * just the browser. `generateJSON` (via toRteJson) needs `window.DOMParser`,
- * which pure-node SSR lacks; migration-20 provides a jsdom window for its pass.
- *
- * These tests run under the default jsdom environment but DELETE the global
- * `window`/`document` around each case, so `migration20` takes its DOM-less
- * server branch for real (dynamic jsdom import via a runtime-assembled specifier
- * + transient global install + restore). The sibling migration-20.test.ts
- * guards the browser path.
- *
- * (We simulate DOM-less rather than switch this file to a node environment,
- * because the shared test/vitest.setup.js assumes a jsdom `global.window`.)
- */
-import { describe, test, expect, beforeEach, afterEach } from 'vitest';
-import { migration20 } from './migration-20';
-import type { MigrationData } from '../migration.util';
-import { isTiptapDocument, getRteJsonPlainText } from '@brand-page-maker/utils';
-
-const createMigrationData = (brandPageData: any): MigrationData =>
-  ({ brandPageModel: brandPageData }) as MigrationData;
-
-const model = (contents: any[]) => ({
-  pages: [{ id: 'p1', title: 'Home', slug: 'home', contents }],
-});
-
-const g = globalThis as any;
-let savedWindow: unknown;
-let savedDocument: unknown;
-
-describe('migration20 (server / no DOM) — HTML RTE → Tiptap JSON', () => {
-  beforeEach(() => {
-    // Force migration-20's DOM-less server branch.
-    savedWindow = g.window;
-    savedDocument = g.document;
-    delete g.window;
-    delete g.document;
-
-    expect(typeof window).toBe('undefined');
-    expect(typeof document).toBe('undefined');
-  });
-
-  afterEach(() => {
-    g.window = savedWindow;
-    g.document = savedDocument;
-  });
-
-  test('converts a top-level HTML RTE field with no global window', async () => {
-    const data = model([
-      {
-        id: '1',
-        type: 'banner-section',
-        title:
-          '<p><span style="color: var(--logo-text-color)">Hello</span></p>',
-      },
-    ]);
-
-    const result = await migration20(createMigrationData(data));
-    const title = (result.brandPageModel.pages[0].contents[0] as any).title;
-
-    expect(isTiptapDocument(title)).toBe(true);
-    expect(getRteJsonPlainText(title)).toContain('Hello');
-    // theme token ref preserved through the server-side parse
-    expect(JSON.stringify(title)).toContain('var(--logo-text-color)');
-  });
-
-  test('converts RTE inside item arrays server-side (marks preserved)', async () => {
-    const data = model([
-      {
-        id: '2',
-        type: 'text',
-        textItems: [{ id: 'ti1', text: '<p><strong>bold</strong> item</p>' }],
-      },
-    ]);
-
-    const result = await migration20(createMigrationData(data));
-    const item = (result.brandPageModel.pages[0].contents[0] as any)
-      .textItems[0];
-
-    expect(isTiptapDocument(item.text)).toBe(true);
-    expect(getRteJsonPlainText(item.text)).toContain('bold');
-    // the <strong> mark survived the jsdom parse
-    expect(JSON.stringify(item.text)).toContain('bold');
-  });
-
-  test('leaves plain strings and already-JSON content untouched (idempotent)', async () => {
-    const jsonDoc = {
-      type: 'doc',
-      content: [{ type: 'paragraph', content: [{ type: 'text', text: 'X' }] }],
-    };
-    const data = model([
-      {
-        id: '3',
-        type: 'banner-section',
-        title: jsonDoc, // already JSON
-        url: 'https://example.com', // plain string, not RTE
-        titleStyle: { color: '#fff', fontSize: '1em' }, // style object, untouched
-      },
-    ]);
-
-    const result = await migration20(createMigrationData(data));
-    const c = result.brandPageModel.pages[0].contents[0] as any;
-
-    expect(c.title).toEqual(jsonDoc);
-    expect(c.url).toBe('https://example.com');
-    expect(c.titleStyle).toEqual({ color: '#fff', fontSize: '1em' });
-  });
-
-  test('does not leak the jsdom window into globalThis after the pass', async () => {
-    const data = model([
-      { id: '4', type: 'banner-section', title: '<p>Leak check</p>' },
-    ]);
-
-    await migration20(createMigrationData(data));
-
-    // The transient jsdom globals installed during the pass must be restored
-    // to their pre-pass state (deleted here), not leaked.
-    expect(typeof window).toBe('undefined');
-    expect(typeof document).toBe('undefined');
-  });
-});

package/src/brand-page/utils/migration/migration-20.test.ts

@@ -1,72 +0,0 @@
-import { describe, test, expect } from 'vitest';
-import { migration20 } from './migration-20';
-import type { MigrationData } from '../migration.util';
-import { isTiptapDocument, getRteJsonPlainText } from '@brand-page-maker/utils';
-
-const createMigrationData = (brandPageData: any): MigrationData =>
-  ({ brandPageModel: brandPageData }) as MigrationData;
-
-const model = (contents: any[]) => ({
-  pages: [{ id: 'p1', title: 'Home', slug: 'home', contents }],
-});
-
-describe('migration20 — HTML RTE → Tiptap JSON', () => {
-  test('converts a top-level HTML RTE field to a JSON document', async () => {
-    const data = model([
-      {
-        id: '1',
-        type: 'banner-section',
-        title:
-          '<p><span style="color: var(--logo-text-color)">Hello</span></p>',
-      },
-    ]);
-
-    const result = await migration20(createMigrationData(data));
-    const title = (result.brandPageModel.pages[0].contents[0] as any).title;
-
-    expect(isTiptapDocument(title)).toBe(true);
-    expect(getRteJsonPlainText(title)).toContain('Hello');
-    // theme token ref preserved through migration
-    expect(JSON.stringify(title)).toContain('var(--logo-text-color)');
-  });
-
-  test('converts RTE inside item arrays (text items / testimonials)', async () => {
-    const data = model([
-      {
-        id: '2',
-        type: 'text',
-        textItems: [{ id: 'ti1', text: '<p><strong>bold</strong> item</p>' }],
-      },
-    ]);
-
-    const result = await migration20(createMigrationData(data));
-    const item = (result.brandPageModel.pages[0].contents[0] as any)
-      .textItems[0];
-
-    expect(isTiptapDocument(item.text)).toBe(true);
-    expect(getRteJsonPlainText(item.text)).toContain('bold');
-  });
-
-  test('leaves plain strings and already-JSON content untouched (idempotent)', async () => {
-    const jsonDoc = {
-      type: 'doc',
-      content: [{ type: 'paragraph', content: [{ type: 'text', text: 'X' }] }],
-    };
-    const data = model([
-      {
-        id: '3',
-        type: 'banner-section',
-        title: jsonDoc, // already JSON
-        url: 'https://example.com', // plain string, not RTE
-        titleStyle: { color: '#fff', fontSize: '1em' }, // style object, untouched
-      },
-    ]);
-
-    const result = await migration20(createMigrationData(data));
-    const c = result.brandPageModel.pages[0].contents[0] as any;
-
-    expect(c.title).toEqual(jsonDoc);
-    expect(c.url).toBe('https://example.com');
-    expect(c.titleStyle).toEqual({ color: '#fff', fontSize: '1em' });
-  });
-});

package/src/brand-page/utils/migration/migration-20.ts

@@ -1,152 +0,0 @@
-import type { BrandPageModel } from '../../models';
-import type { MigrationData } from '../migration.util';
-import { hasRTEContent, toRteJson } from '../../../brand-page-maker/utils';
-
-/**
- * BP-5787 — migrate existing inline-HTML RTE content to Tiptap JSON.
- *
- * The editor emits, and the renderer reads, Tiptap JSON. Existing
- * published/saved sites still hold RTE fields as HTML strings. This converts
- * them on load, in EVERY environment:
- *   - maker (browser): the loaded model is JSON, so the next save persists JSON.
- *   - web-renderer (SSR / server API routes): converted on read using a jsdom
- *     window (see below), so old sites are normalised without a re-save and
- *     downstream code can treat RTE as JSON.
- *
- * This is a one-time, versioned migration (runAlways is NOT set): legacy sites
- * are at model version < 20 and convert on first load in any environment; once
- * `v` is stamped to 20 the conversion is skipped. This is only safe because the
- * AI section builders now emit Tiptap JSON directly (they no longer write HTML),
- * so there is no recurring post-load source of HTML to normalise.
- *
- * Scope: only HTML-RTE strings (hasRTEContent) are converted. Plain strings,
- * numbers, and already-JSON docs are left untouched, so the migration is
- * idempotent (re-running on JSON content is a no-op — non-string values are
- * skipped). Nested RTE inside item arrays (textItems, testimonials, images…)
- * is handled by recursing into arrays; style objects are intentionally not
- * descended into (they never hold RTE content).
- */
-const convertRteStringsToJson = (value: unknown): void => {
-  if (Array.isArray(value)) {
-    value.forEach((item) => convertRteStringsToJson(item));
-
-    return;
-  }
-
-  if (!value || typeof value !== 'object') return;
-
-  const record = value as Record<string, unknown>;
-
-  Object.keys(record).forEach((key) => {
-    const field = record[key];
-
-    if (typeof field === 'string' && hasRTEContent(field)) {
-      const json = toRteJson(field);
-
-      if (json) record[key] = json;
-    } else if (Array.isArray(field)) {
-      convertRteStringsToJson(field);
-    }
-  });
-};
-
-const convertModel = (brandPageModel: BrandPageModel): void => {
-  for (const page of brandPageModel.pages) {
-    for (const content of page.contents) {
-      convertRteStringsToJson(content);
-    }
-  }
-};
-
-/**
- * HTML→JSON parsing (Tiptap's generateJSON, via toRteJson) needs `window.DOMParser`.
- * In pure-node SSR there is no global DOM, so we provide a jsdom-backed window.
- *
- * Memoised: JSDOM construction is relatively expensive, so one window is created
- * per process and reused. The parser is stateless (each parseFromString builds a
- * fresh document), so sharing the window across requests is safe.
- *
- * `jsdom` is dynamically imported via a runtime-assembled specifier (see
- * getServerWindow), so no bundler can follow it into a browser bundle — this
- * branch only runs when there is no global `window`.
- */
-type ServerWindow = { DOMParser: unknown; document: unknown };
-
-// Minimal shape of the jsdom module, declared locally rather than via an
-// `import()` type, so the specifier "jsdom" never appears anywhere a bundler
-// could follow it (value or type position). Only the members used below.
-type JsdomModule = { JSDOM: new (html?: string) => { window: ServerWindow } };
-
-let serverWindowPromise: Promise<ServerWindow> | null = null;
-
-const getServerWindow = (): Promise<ServerWindow> => {
-  if (!serverWindowPromise) {
-    // The specifier is assembled at runtime rather than written as the string
-    // literal "jsdom", so no bundler (Rollup/Vite in the library build, and any
-    // downstream browser consumer — BrandCrowd.Nuxt, web-renderer, …) can
-    // statically follow it and try to bundle jsdom → cssstyle, whose generated
-    // code breaks Rollup's CommonJS parser. The library stays self-contained
-    // (it still loads its own jsdom at runtime on the server) while never
-    // leaking jsdom into a browser bundle. `@vite-ignore` silences the
-    // "cannot be analyzed" warning the non-literal specifier would otherwise
-    // trigger. At Node runtime this resolves the real jsdom from node_modules.
-    const jsdomModuleId = ['js', 'dom'].join('');
-
-    serverWindowPromise = (
-      import(/* @vite-ignore */ jsdomModuleId) as Promise<JsdomModule>
-    )
-      .then(({ JSDOM }) => new JSDOM('').window)
-      .catch((error) => {
-        // Don't cache the failure — let a later migration retry the import.
-        serverWindowPromise = null;
-
-        throw error;
-      });
-  }
-
-  return serverWindowPromise;
-};
-
-export const migration20 = async (
-  migrationResult: MigrationData,
-): Promise<MigrationData> => {
-  const { brandPageModel } = migrationResult;
-
-  // Browser / jsdom test: a DOM is already present — convert directly.
-  if (typeof window !== 'undefined' && typeof document !== 'undefined') {
-    convertModel(brandPageModel);
-
-    return migrationResult;
-  }
-
-  // Pure-node SSR: install a memoised jsdom window as the global for the duration
-  // of the conversion pass, then restore. The pass is fully synchronous (no await
-  // between install and restore), so in Node's single thread no concurrent request
-  // can observe the temporary globals.
-  const serverWindow = await getServerWindow();
-  const globals = globalThis as unknown as {
-    window?: unknown;
-    document?: unknown;
-  };
-  // Track whether the globals existed so we restore exactly — deleting keys we
-  // added rather than leaving `window: undefined` own-properties behind.
-  const hadWindow = 'window' in globals;
-  const hadDocument = 'document' in globals;
-  const prevWindow = globals.window;
-  const prevDocument = globals.document;
-
-  globals.window = serverWindow;
-  globals.document = serverWindow.document;
-
-  try {
-    convertModel(brandPageModel);
-  } finally {
-    if (hadWindow) globals.window = prevWindow;
-    else delete globals.window;
-
-    if (hadDocument) globals.document = prevDocument;
-    else delete globals.document;
-  }
-
-  return migrationResult;
-};