@prenta/admin 0.92.0 → 0.93.0

package/dist/hooks/useReflowGuard.js

@@ -0,0 +1,52 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { probeFieldReflow, reflowSeverity, worstBreakpoint, } from '../lib/reflow-probe.js';
+const EMPTY = { rows: [], grown: [], worst: null, delta: 0 };
+/**
+ * Measures how one field wraps at every breakpoint, and how that compares to
+ * what is published.
+ *
+ * ── Why it runs on a delay ────────────────────────────────────────────────
+ *
+ * A pass clones the canvas and lays it out twelve times (six widths, current
+ * and published). That is far too much to do per keystroke, and it is also
+ * pointless — mid-word text tells an editor nothing. So it settles first.
+ *
+ * `null` from the probe means the field is not measurable: the section may be
+ * rendered by a consumer's own component that carries no `data-cms-field`
+ * markers. The guard then reports nothing rather than a number read off the
+ * wrong element — an editor treats a line count as a fact, and a confident
+ * wrong one is worse than a blank.
+ */
+export function useReflowGuard(options) {
+    const { canvas, sectionId, fieldPath, value, baseline, enabled = true, delayMs = 200 } = options;
+    const [result, setResult] = useState(EMPTY);
+    useEffect(() => {
+        if (!enabled || !canvas) {
+            setResult(EMPTY);
+            return;
+        }
+        const timer = setTimeout(() => {
+            const probed = probeFieldReflow({ canvas, sectionId, fieldPath, baselineText: baseline });
+            if (!probed) {
+                setResult(EMPTY);
+                return;
+            }
+            const rows = probed.current.map((row) => {
+                const was = probed.baseline.find((b) => b.id === row.id)?.lines ?? row.lines;
+                return { ...row, was, diff: row.lines - was, state: reflowSeverity(row.lines, was) };
+            });
+            setResult({
+                rows,
+                grown: rows.filter((r) => r.diff > 0),
+                worst: worstBreakpoint(probed.current, probed.baseline),
+                delta: baseline === undefined ? 0 : value.length - baseline.length,
+            });
+        }, delayMs);
+        return () => clearTimeout(timer);
+        // `value` is a dependency because the canvas re-renders as it changes —
+        // the probe reads the resulting DOM rather than the string itself.
+    }, [canvas, sectionId, fieldPath, value, baseline, enabled, delayMs]);
+    return result;
+}
+//# sourceMappingURL=useReflowGuard.js.map

package/dist/hooks/useReflowGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReflowGuard.js","sourceRoot":"","sources":["../../src/hooks/useReflowGuard.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,GAGhB,MAAM,wBAAwB,CAAA;AAoB/B,MAAM,KAAK,GAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,OAW9B;IACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAA;IAChG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAoB,KAAK,CAAC,CAAA;IAE9D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,SAAS,CAAC,KAAK,CAAC,CAAA;YAChB,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAA;YACzF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,SAAS,CAAC,KAAK,CAAC,CAAA;gBAChB,OAAM;YACR,CAAC;YAED,MAAM,IAAI,GAAgB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC,KAAK,CAAA;gBAC5E,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAA;YACtF,CAAC,CAAC,CAAA;YAEF,SAAS,CAAC;gBACR,IAAI;gBACJ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBACrC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;gBACvD,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;aACnE,CAAC,CAAA;QACJ,CAAC,EAAE,OAAO,CAAC,CAAA;QAEX,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAChC,wEAAwE;QACxE,mEAAmE;IACrE,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IAErE,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/lib/breakpoints.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Breakpoint presets for the editor canvas — shared by the page editor, the
+ * post editor, and the site-preview frame.
+ *
+ * Each entry's `width` is the **real CSS width** the canvas renders at. The
+ * canvas is then scaled down with a transform to fit the available column, so
+ * the page reflows against its own width via container queries rather than
+ * being squeezed by a max-width clamp. A clamp does not reflow: it produces a
+ * narrow desktop layout, not the mobile layout.
+ *
+ * `4k` is 2560, not 3840. 2560 is the CSS width a 4K/Retina display reports
+ * once device-pixel-ratio is applied; 3840 is the physical pixel count and no
+ * stylesheet ever sees it. It is also the only preset above the canvas's
+ * `min-width: 2000px` container step, so it is the only one that exercises
+ * that branch.
+ */
+export type BreakpointId = '4k' | 'wide' | 'laptop' | 'tabletL' | 'tabletP' | 'mobile';
+export type BreakpointGroup = 'DESKTOP' | 'TABLET' | 'MOBILE';
+export interface Breakpoint {
+    id: BreakpointId;
+    /** Full name, shown in the picker menu. */
+    name: string;
+    /** Two-letter form for the collapsed trigger. */
+    abbr: string;
+    /** lucide-react icon name */
+    icon: string;
+    /** Real CSS width of the preview surface, in px. */
+    width: number;
+    group: BreakpointGroup;
+}
+export declare const BREAKPOINTS: readonly Breakpoint[];
+/** Menu order. Groups render as labelled sections in the breakpoint picker. */
+export declare const BREAKPOINT_GROUPS: readonly BreakpointGroup[];
+export declare const DEFAULT_BREAKPOINT: BreakpointId;
+export declare function getBreakpoint(id: BreakpointId): Breakpoint;
+export declare function breakpointsInGroup(group: BreakpointGroup): Breakpoint[];
+export declare function coerceBreakpointId(value: unknown): BreakpointId;
+export type Zoom = 'fit' | 1;
+/**
+ * Scale factor for the canvas transform.
+ *
+ * `available` must come from a zero-height sentinel measured inside the canvas
+ * panel — NOT from `panel.clientWidth - padding`. The two disagree whenever the
+ * host scales the preview or a scrollbar appears, and the padding arithmetic is
+ * the kind that silently rots when the gutter changes.
+ *
+ * Never scales above 1: a 390px mobile canvas blown up to fill a 1200px column
+ * would show text at 3× the size the visitor sees.
+ */
+export declare function fitScale(available: number, width: number, zoom?: Zoom): number;
+//# sourceMappingURL=breakpoints.d.ts.map

package/dist/lib/breakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.d.ts","sourceRoot":"","sources":["../../src/lib/breakpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEtF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,YAAY,CAAA;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EAqB5C,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAAoC,CAAA;AAE5F,eAAO,MAAM,kBAAkB,EAAE,YAAqB,CAAA;AAItD,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,UAAU,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,EAAE,CAEvE;AAaD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAI/D;AAED,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;AAE5B;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAY,GAAG,MAAM,CAIrF"}

package/dist/lib/breakpoints.js

@@ -0,0 +1,84 @@
+/**
+ * Breakpoint presets for the editor canvas — shared by the page editor, the
+ * post editor, and the site-preview frame.
+ *
+ * Each entry's `width` is the **real CSS width** the canvas renders at. The
+ * canvas is then scaled down with a transform to fit the available column, so
+ * the page reflows against its own width via container queries rather than
+ * being squeezed by a max-width clamp. A clamp does not reflow: it produces a
+ * narrow desktop layout, not the mobile layout.
+ *
+ * `4k` is 2560, not 3840. 2560 is the CSS width a 4K/Retina display reports
+ * once device-pixel-ratio is applied; 3840 is the physical pixel count and no
+ * stylesheet ever sees it. It is also the only preset above the canvas's
+ * `min-width: 2000px` container step, so it is the only one that exercises
+ * that branch.
+ */
+export const BREAKPOINTS = [
+    { id: '4k', name: '4K / Retina', abbr: '4K', icon: 'monitor', width: 2560, group: 'DESKTOP' },
+    { id: 'wide', name: 'Wide Screen', abbr: 'WS', icon: 'monitor', width: 1920, group: 'DESKTOP' },
+    { id: 'laptop', name: 'Laptop', abbr: 'LT', icon: 'laptop', width: 1440, group: 'DESKTOP' },
+    {
+        id: 'tabletL',
+        name: 'Tablet Landscape',
+        abbr: 'TL',
+        icon: 'tablet',
+        width: 1024,
+        group: 'TABLET',
+    },
+    {
+        id: 'tabletP',
+        name: 'Tablet Portrait',
+        abbr: 'TP',
+        icon: 'tablet',
+        width: 768,
+        group: 'TABLET',
+    },
+    { id: 'mobile', name: 'Mobile', abbr: 'M', icon: 'smartphone', width: 390, group: 'MOBILE' },
+];
+/** Menu order. Groups render as labelled sections in the breakpoint picker. */
+export const BREAKPOINT_GROUPS = ['DESKTOP', 'TABLET', 'MOBILE'];
+export const DEFAULT_BREAKPOINT = 'wide';
+const BY_ID = new Map(BREAKPOINTS.map((b) => [b.id, b]));
+export function getBreakpoint(id) {
+    return BY_ID.get(id) ?? BY_ID.get(DEFAULT_BREAKPOINT);
+}
+export function breakpointsInGroup(group) {
+    return BREAKPOINTS.filter((b) => b.group === group);
+}
+/**
+ * Narrows arbitrary input (persisted state, a URL param, a stale prop) to a
+ * known id. The v0.92 preset ids — `1080p` and `tablet` — map onto their
+ * closest current equivalents so an editor open across the upgrade doesn't
+ * land on the default.
+ */
+const LEGACY_IDS = {
+    '1080p': 'laptop', // was 1440 — same width, renamed
+    tablet: 'tabletP', // was 768 — same width, split into landscape/portrait
+};
+export function coerceBreakpointId(value) {
+    if (typeof value !== 'string')
+        return DEFAULT_BREAKPOINT;
+    if (BY_ID.has(value))
+        return value;
+    return LEGACY_IDS[value] ?? DEFAULT_BREAKPOINT;
+}
+/**
+ * Scale factor for the canvas transform.
+ *
+ * `available` must come from a zero-height sentinel measured inside the canvas
+ * panel — NOT from `panel.clientWidth - padding`. The two disagree whenever the
+ * host scales the preview or a scrollbar appears, and the padding arithmetic is
+ * the kind that silently rots when the gutter changes.
+ *
+ * Never scales above 1: a 390px mobile canvas blown up to fill a 1200px column
+ * would show text at 3× the size the visitor sees.
+ */
+export function fitScale(available, width, zoom = 'fit') {
+    if (zoom !== 'fit')
+        return 1;
+    if (!Number.isFinite(available) || available <= 0 || width <= 0)
+        return 1;
+    return Math.min(1, available / width);
+}
+//# sourceMappingURL=breakpoints.js.map

package/dist/lib/breakpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.js","sourceRoot":"","sources":["../../src/lib/breakpoints.ts"],"names":[],"mappings":"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"}

package/dist/lib/canvas-edit-chrome.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared edit affordances for the page/post canvas and Site preview iframe.
+ *
+ * Structure canvas: section hover is styled in `theme.css` under `.prenta-canvas`.
+ * Site preview: the same field chrome is injected into the iframe document when
+ * same-origin (CMS-host preview) so consumers get hover borders without shipping CSS.
+ */
+/** localStorage key for the dismissible canvas tip. */
+export declare const CANVAS_EDIT_TIP_STORAGE_KEY = "prenta.canvasEditTip.dismissed";
+/**
+ * CSS injected into the Site preview iframe while editing is enabled.
+ * Uses system colors so it works without admin theme tokens in the iframe.
+ */
+export declare const PREVIEW_EDITABLE_FIELD_CHROME_CSS: string;
+/**
+ * Inject (or refresh) editable-field hover chrome into a same-origin preview
+ * iframe. No-ops on cross-origin frames (browser blocks contentDocument).
+ */
+export declare function injectPreviewEditChrome(iframe: HTMLIFrameElement | null): boolean;
+export declare function isCanvasEditTipDismissed(): boolean;
+export declare function dismissCanvasEditTip(): void;
+//# sourceMappingURL=canvas-edit-chrome.d.ts.map

package/dist/lib/canvas-edit-chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-edit-chrome.d.ts","sourceRoot":"","sources":["../../src/lib/canvas-edit-chrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,eAAO,MAAM,2BAA2B,mCAAmC,CAAA;AAE3E;;;GAGG;AACH,eAAO,MAAM,iCAAiC,QA0BtC,CAAA;AAIR;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAgBjF;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAMlD;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C"}

package/dist/lib/canvas-edit-chrome.js

@@ -0,0 +1,81 @@
+/**
+ * Shared edit affordances for the page/post canvas and Site preview iframe.
+ *
+ * Structure canvas: section hover is styled in `theme.css` under `.prenta-canvas`.
+ * Site preview: the same field chrome is injected into the iframe document when
+ * same-origin (CMS-host preview) so consumers get hover borders without shipping CSS.
+ */
+/** localStorage key for the dismissible canvas tip. */
+export const CANVAS_EDIT_TIP_STORAGE_KEY = 'prenta.canvasEditTip.dismissed';
+/**
+ * CSS injected into the Site preview iframe while editing is enabled.
+ * Uses system colors so it works without admin theme tokens in the iframe.
+ */
+export const PREVIEW_EDITABLE_FIELD_CHROME_CSS = `
+/* Prenta Site preview — editable field hover chrome (injected by @prenta/admin) */
+[data-cms-field] {
+  outline: 1px solid transparent;
+  outline-offset: 2px;
+  border-radius: 2px;
+  transition: outline-color 120ms ease;
+  cursor: text;
+}
+[data-cms-field]:hover,
+[data-cms-field]:focus,
+[data-cms-field]:focus-within {
+  outline-color: color-mix(in oklab, CanvasText 24%, transparent);
+}
+[data-cms-field][data-cms-field-kind="media"] {
+  cursor: pointer;
+}
+[data-cms-field][data-cms-field-kind="media"]:hover,
+[data-cms-field][data-cms-field-kind="media"]:focus {
+  outline-color: color-mix(in oklab, CanvasText 32%, transparent);
+}
+@media (prefers-reduced-motion: reduce) {
+  [data-cms-field] {
+    transition: none;
+  }
+}
+`.trim();
+const STYLE_ATTR = 'data-prenta-edit-chrome';
+/**
+ * Inject (or refresh) editable-field hover chrome into a same-origin preview
+ * iframe. No-ops on cross-origin frames (browser blocks contentDocument).
+ */
+export function injectPreviewEditChrome(iframe) {
+    try {
+        const doc = iframe?.contentDocument;
+        if (!doc?.head)
+            return false;
+        let style = doc.head.querySelector(`style[${STYLE_ATTR}]`);
+        if (!style) {
+            style = doc.createElement('style');
+            style.setAttribute(STYLE_ATTR, '1');
+            doc.head.appendChild(style);
+        }
+        style.textContent = PREVIEW_EDITABLE_FIELD_CHROME_CSS;
+        doc.documentElement.setAttribute('data-prenta-preview-editing', 'true');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isCanvasEditTipDismissed() {
+    try {
+        return localStorage.getItem(CANVAS_EDIT_TIP_STORAGE_KEY) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+export function dismissCanvasEditTip() {
+    try {
+        localStorage.setItem(CANVAS_EDIT_TIP_STORAGE_KEY, '1');
+    }
+    catch {
+        /* private mode — tip will reappear next session */
+    }
+}
+//# sourceMappingURL=canvas-edit-chrome.js.map

package/dist/lib/canvas-edit-chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-edit-chrome.js","sourceRoot":"","sources":["../../src/lib/canvas-edit-chrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,gCAAgC,CAAA;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BhD,CAAC,IAAI,EAAE,CAAA;AAER,MAAM,UAAU,GAAG,yBAAyB,CAAA;AAE5C;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAgC;IACtE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,eAAe,CAAA;QACnC,IAAI,CAAC,GAAG,EAAE,IAAI;YAAE,OAAO,KAAK,CAAA;QAC5B,IAAI,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,CAAmB,SAAS,UAAU,GAAG,CAAC,CAAA;QAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;YAClC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;YACnC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;QACD,KAAK,CAAC,WAAW,GAAG,iCAAiC,CAAA;QACrD,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAA;QACvE,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,2BAA2B,CAAC,KAAK,GAAG,CAAA;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;AACH,CAAC"}

package/dist/lib/media-format.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Presentation helpers for the media block.
+ *
+ * Pure, because these are the parts with real logic — the rest of the block is
+ * layout. Ported from the design prototype so the labels an editor reads match
+ * the ones the design specifies.
+ */
+/** The crop the template renders an image at. Drives the frame's aspect ratio. */
+export type MediaCrop = 'section' | 'social';
+/**
+ * Aspect ratio per crop, as a CSS `aspect-ratio` value.
+ *
+ * The frame shows the crop the TEMPLATE renders, not the asset's own ratio.
+ * Showing the asset's ratio would tell an editor their portrait photo is fine
+ * and then crop its subject out on the page.
+ */
+export declare const CROP_RATIO: Record<MediaCrop, string>;
+/**
+ * Human ratio for an asset's intrinsic dimensions.
+ *
+ * Snaps to a named ratio when within 0.05, else reports the number. The
+ * tolerance matters: a 2400×1600 photo is 1.5 exactly, but a 2401×1600 scan is
+ * 1.5006 and an editor should still read "3:2" rather than "1.50:1".
+ *
+ * Returns null when dimensions are unknown — the library does not always have
+ * them, and inventing "1.00:1" would be worse than saying nothing.
+ */
+export declare function ratioLabel(width?: number, height?: number): string | null;
+/**
+ * Short format badge — the file extension, uppercased.
+ *
+ * Falls back to the MIME subtype so a URL with no extension (a signed CDN link,
+ * an upload route) still shows something meaningful rather than a blank chip.
+ */
+export declare function formatBadge(filenameOrUrl: string, mimeType?: string): string;
+/**
+ * Filename for display, from a filename or a URL.
+ *
+ * Query strings are dropped — a signed URL's token is noise in a 200px-wide
+ * toolbar, and it is never what an editor is trying to read.
+ */
+export declare function displayName(filenameOrUrl: string): string;
+/**
+ * A stable background tint for an asset.
+ *
+ * The design fills the frame with a wash derived from the asset's dominant
+ * colour. The media library stores no such value, so it is derived from the
+ * name instead: the same asset is always the same colour, which is the property
+ * that actually matters for recognising a thumbnail, and it costs no storage
+ * and no extra request.
+ *
+ * Returned as a 135° gradient to the design's `color-mix(tint 45%, #fff)`.
+ */
+export declare function assetWash(seed: string): string;
+//# sourceMappingURL=media-format.d.ts.map

package/dist/lib/media-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-format.d.ts","sourceRoot":"","sources":["../../src/lib/media-format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAGhD,CAAA;AAaD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/dist/lib/media-format.js

@@ -0,0 +1,93 @@
+/**
+ * Presentation helpers for the media block.
+ *
+ * Pure, because these are the parts with real logic — the rest of the block is
+ * layout. Ported from the design prototype so the labels an editor reads match
+ * the ones the design specifies.
+ */
+/**
+ * Aspect ratio per crop, as a CSS `aspect-ratio` value.
+ *
+ * The frame shows the crop the TEMPLATE renders, not the asset's own ratio.
+ * Showing the asset's ratio would tell an editor their portrait photo is fine
+ * and then crop its subject out on the page.
+ */
+export const CROP_RATIO = {
+    section: '16 / 10',
+    social: '1.91 / 1',
+};
+/** Named ratios an editor recognises, nearest-match within a tolerance. */
+const KNOWN_RATIOS = [
+    [1.91, '1.91:1'],
+    [16 / 9, '16:9'],
+    [1.5, '3:2'],
+    [4 / 3, '4:3'],
+    [1, '1:1'],
+    [0.8, '4:5'],
+    [9 / 16, '9:16'],
+];
+/**
+ * Human ratio for an asset's intrinsic dimensions.
+ *
+ * Snaps to a named ratio when within 0.05, else reports the number. The
+ * tolerance matters: a 2400×1600 photo is 1.5 exactly, but a 2401×1600 scan is
+ * 1.5006 and an editor should still read "3:2" rather than "1.50:1".
+ *
+ * Returns null when dimensions are unknown — the library does not always have
+ * them, and inventing "1.00:1" would be worse than saying nothing.
+ */
+export function ratioLabel(width, height) {
+    if (!width || !height || width <= 0 || height <= 0)
+        return null;
+    const r = width / height;
+    const best = KNOWN_RATIOS.reduce((a, b) => (Math.abs(b[0] - r) < Math.abs(a[0] - r) ? b : a));
+    return Math.abs(best[0] - r) < 0.05 ? best[1] : `${r.toFixed(2)}:1`;
+}
+/**
+ * Short format badge — the file extension, uppercased.
+ *
+ * Falls back to the MIME subtype so a URL with no extension (a signed CDN link,
+ * an upload route) still shows something meaningful rather than a blank chip.
+ */
+export function formatBadge(filenameOrUrl, mimeType) {
+    const path = filenameOrUrl.split(/[?#]/)[0] ?? '';
+    const segment = path.split('/').pop() ?? '';
+    // Only a segment that actually contains a dot has an extension. Comparing
+    // against the whole path instead of the segment let a dotless filename —
+    // which is what signed CDN links look like — read as its own extension.
+    const ext = segment.includes('.') ? (segment.split('.').pop() ?? '') : '';
+    if (ext && ext.length <= 5 && /^[a-z0-9]+$/i.test(ext)) {
+        return ext.toUpperCase();
+    }
+    const sub = mimeType?.split('/')[1];
+    return sub ? sub.split('+')[0].toUpperCase() : 'FILE';
+}
+/**
+ * Filename for display, from a filename or a URL.
+ *
+ * Query strings are dropped — a signed URL's token is noise in a 200px-wide
+ * toolbar, and it is never what an editor is trying to read.
+ */
+export function displayName(filenameOrUrl) {
+    const path = filenameOrUrl.split(/[?#]/)[0] ?? '';
+    return decodeURIComponent(path.split('/').pop() ?? '') || filenameOrUrl;
+}
+/**
+ * A stable background tint for an asset.
+ *
+ * The design fills the frame with a wash derived from the asset's dominant
+ * colour. The media library stores no such value, so it is derived from the
+ * name instead: the same asset is always the same colour, which is the property
+ * that actually matters for recognising a thumbnail, and it costs no storage
+ * and no extra request.
+ *
+ * Returned as a 135° gradient to the design's `color-mix(tint 45%, #fff)`.
+ */
+export function assetWash(seed) {
+    let hash = 0;
+    for (let i = 0; i < seed.length; i++)
+        hash = (hash * 31 + seed.charCodeAt(i)) % 360;
+    const tint = `oklch(0.88 0.06 ${hash})`;
+    return `linear-gradient(135deg, ${tint}, color-mix(in srgb, ${tint} 45%, #fff))`;
+}
+//# sourceMappingURL=media-format.js.map

package/dist/lib/media-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-format.js","sourceRoot":"","sources":["../../src/lib/media-format.ts"],"names":[],"mappings":"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"}

package/dist/lib/page-audit-input.d.ts

@@ -0,0 +1,45 @@
+import type { PageSection } from '@prenta/core/page-sections';
+import type { PageAuditInput } from '@prenta/core/seo/page-audit';
+import type { SeoContentRecord } from './seo-service.js';
+/**
+ * One place that turns editor state into `PageAuditInput`.
+ *
+ * Two callers build the audit and their numbers must agree:
+ *
+ *   - the page editor, from the SAVED record, so the header chip and rail dot
+ *     have a score from first paint rather than after someone opens a tab;
+ *   - the SEO pane, from LIVE form state, so the score moves as you type.
+ *
+ * They differ only in where the metadata comes from — saved versus unsaved —
+ * which is exactly the difference an editor expects to see. Everything else
+ * (which fields feed which check, how the title is rendered, what counts as
+ * unknown) is decided here once. Two hand-written copies of this mapping is how
+ * the editor ended up showing three different scores in the first place.
+ */
+export interface AuditMetaSource {
+    /** Page-level meta title, before the site title template is applied. */
+    metaTitle: string;
+    metaDescription: string;
+    focusKeyword: string;
+    structuredDataType: string;
+    noindex: boolean;
+    /** `nosnippet` — blocks AI Overview and chat citations outright. */
+    nosnippet: boolean;
+    /** `NEVER` excludes the page from llms.txt. */
+    llmsInclude: string;
+    /** True when an OG image is set — dimensions are not stored, see below. */
+    hasOgImage: boolean;
+}
+export interface BuildAuditInputArgs {
+    sections: PageSection[];
+    meta: AuditMetaSource;
+    slug: string;
+    /** Document title and site template, for the rendered `<title>`. */
+    record: Pick<SeoContentRecord, 'title' | 'siteName' | 'titleTemplate' | 'url'> | null;
+    /** Fallback title when there is no saved record yet. */
+    fallbackTitle?: string;
+}
+export declare function buildPageAuditInput({ sections, meta, slug, record, fallbackTitle, }: BuildAuditInputArgs): PageAuditInput;
+/** Meta source from a saved SEO record. */
+export declare function metaFromRecord(record: SeoContentRecord): AuditMetaSource;
+//# sourceMappingURL=page-audit-input.d.ts.map

package/dist/lib/page-audit-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-audit-input.d.ts","sourceRoot":"","sources":["../../src/lib/page-audit-input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAA;IAClB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC,GAAG,IAAI,CAAA;IACrF,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,aAAa,GACd,EAAE,mBAAmB,GAAG,cAAc,CAsCtC;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAWxE"}

package/dist/lib/page-audit-input.js

@@ -0,0 +1,53 @@
+import { resolveRenderedMetaTitle } from '@prenta/core/client';
+export function buildPageAuditInput({ sections, meta, slug, record, fallbackTitle, }) {
+    // Measure the title a searcher actually sees — the page meta title with the
+    // site's template applied — not the raw field. Checking the raw field would
+    // give length advice that contradicts the rendered result.
+    const renderedTitle = record
+        ? resolveRenderedMetaTitle({
+            metaTitlePage: meta.metaTitle,
+            documentTitle: record.title,
+            site: {
+                siteName: record.siteName ?? undefined,
+                titleTemplate: record.titleTemplate ?? undefined,
+            },
+        })
+        : meta.metaTitle.trim() || fallbackTitle || '';
+    return {
+        sections,
+        seo: {
+            title: renderedTitle,
+            description: meta.metaDescription,
+            slug: slug || record?.url?.split('/').filter(Boolean).pop() || '',
+            keyword: meta.focusKeyword,
+            schema: meta.structuredDataType,
+            // `undefined` (unknown) when an image is set: the record stores a URL
+            // with no dimensions, and the check needs width and ratio. `null` when
+            // none is set, which is a genuine absence and correctly fails.
+            ogImage: meta.hasOgImage ? undefined : null,
+            robots: {
+                index: !meta.noindex,
+                snippet: !meta.nosnippet,
+            },
+        },
+        llmsTxt: meta.llmsInclude !== 'NEVER',
+        // Not resolved in the editor yet; both report not-applicable rather than
+        // failing an editor for a gap in the plumbing.
+        brand: '',
+        author: undefined,
+    };
+}
+/** Meta source from a saved SEO record. */
+export function metaFromRecord(record) {
+    return {
+        metaTitle: record.metaTitlePage ?? '',
+        metaDescription: record.metaDescription ?? '',
+        focusKeyword: record.focusKeyword ?? '',
+        structuredDataType: record.structuredDataType ?? 'WebPage',
+        noindex: record.noindex,
+        nosnippet: record.nosnippet ?? false,
+        llmsInclude: record.llmsInclude ?? 'AUTO',
+        hasOgImage: Boolean(record.ogImage),
+    };
+}
+//# sourceMappingURL=page-audit-input.js.map

package/dist/lib/page-audit-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-audit-input.js","sourceRoot":"","sources":["../../src/lib/page-audit-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AA6C9D,MAAM,UAAU,mBAAmB,CAAC,EAClC,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,aAAa,GACO;IACpB,4EAA4E;IAC5E,4EAA4E;IAC5E,2DAA2D;IAC3D,MAAM,aAAa,GAAG,MAAM;QAC1B,CAAC,CAAC,wBAAwB,CAAC;YACvB,aAAa,EAAE,IAAI,CAAC,SAAS;YAC7B,aAAa,EAAE,MAAM,CAAC,KAAK;YAC3B,IAAI,EAAE;gBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;gBACtC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,SAAS;aACjD;SACF,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,aAAa,IAAI,EAAE,CAAA;IAEhD,OAAO;QACL,QAAQ;QACR,GAAG,EAAE;YACH,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,IAAI,CAAC,eAAe;YACjC,IAAI,EAAE,IAAI,IAAI,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE;YACjE,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,MAAM,EAAE,IAAI,CAAC,kBAAkB;YAC/B,sEAAsE;YACtE,uEAAuE;YACvE,+DAA+D;YAC/D,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YAC3C,MAAM,EAAE;gBACN,KAAK,EAAE,CAAC,IAAI,CAAC,OAAO;gBACpB,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS;aACzB;SACF;QACD,OAAO,EAAE,IAAI,CAAC,WAAW,KAAK,OAAO;QACrC,yEAAyE;QACzE,+CAA+C;QAC/C,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,SAAS;KAClB,CAAA;AACH,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;QACrC,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;QAC7C,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;QACvC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,SAAS;QAC1D,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;QACpC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM;QACzC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;KACpC,CAAA;AACH,CAAC"}

package/dist/lib/page-editor-service.d.ts

@@ -22,6 +22,18 @@ export interface EditorPage {
     updatedAt: string | null;
     scheduledAt: string | null;
     scheduledUnpublishAt: string | null;
+    /**
+     * Displayed byline. Read by `composePageMeta` into the page's structured
+     * data, so this is a real output and not decoration.
+     *
+     * Deliberately separate from the document's `createdById`, which the API
+     * never reassigns. That field records who created the record — provenance —
+     * and overwriting it to change a displayed name would trade an audit trail
+     * for a label.
+     */
+    authorName: string;
+    /** CMS user behind the byline, when it is one. Empty for generic/guest. */
+    authorId: string;
     /**
      * True when the document was authored in the visual Page Builder (it carries
      * a `_layout` tree). Such a page's `sections` are *compiled* from the layout

package/dist/lib/page-editor-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-editor-service.d.ts","sourceRoot":"","sources":["../../src/lib/page-editor-service.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAGjB,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAA;AAKnC,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAI7D,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,GAClB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAA;AAEzE,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC;;;;;OAKG;IACH,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,UAAQ,GAAG,gBAAgB,CAoCnF;AAoBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAE3D;AAmDD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAI5E;AAkCD,wDAAwD;AACxD,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAOtE;AAED,iDAAiD;AACjD,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAQzE;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAUvE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,YAAY,GAAE,MAAM,GAAG,IAAW,GAAG,UAAU,CAiBxE"}
+{"version":3,"file":"page-editor-service.d.ts","sourceRoot":"","sources":["../../src/lib/page-editor-service.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAGjB,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAA;AAKnC,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAI7D,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,GAClB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAA;AAEzE,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,UAAQ,GAAG,gBAAgB,CAoCnF;AAoBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAE3D;AAqDD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAI5E;AAoCD,wDAAwD;AACxD,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAOtE;AAED,iDAAiD;AACjD,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAQzE;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAUvE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,YAAY,GAAE,MAAM,GAAG,IAAW,GAAG,UAAU,CAmBxE"}

package/dist/lib/page-editor-service.js

@@ -118,6 +118,8 @@ function rowToEditorPage(doc) {
         updatedAt: doc.updatedAt ?? null,
         scheduledAt: doc.scheduledAt ?? null,
         scheduledUnpublishAt: doc.scheduledUnpublishAt ?? null,
+        authorName: typeof data.authorName === 'string' ? data.authorName : '',
+        authorId: typeof data.authorId === 'string' ? data.authorId : '',
         builderOwned,
     };
 }
@@ -145,6 +147,8 @@ function toWriteBody(page, extra) {
         sections: page.sections.map(({ unmanaged: _unmanaged, ...rest }) => rest),
         metaTitle: page.seoTitle,
         metaDescription: page.seoDescription,
+        authorName: page.authorName,
+        authorId: page.authorId,
         ...extra,
     };
     return JSON.stringify(payload);
@@ -203,6 +207,8 @@ export function emptyPage(parentPageId = null) {
         updatedAt: null,
         scheduledAt: null,
         scheduledUnpublishAt: null,
+        authorName: '',
+        authorId: '',
         builderOwned: false,
     };
 }