@caretcms/core 0.2.0 → 0.4.0

package/static/cms/editor/text-link-interactions.js

@@ -1,12 +1,26 @@
 import { escapeHtml } from './linkify.js';
 
+/** @typedef {HTMLElement & { _caretSkipSave?: boolean }} EditableElement */
+/** @typedef {{ dirtyEls: Set<Element>, linkPopupEl: HTMLElement | null }} TextEditorState */
+/** @typedef {(message: string, kind: 'success' | 'error') => unknown} ShowToast */
+/** @typedef {(url: string | null) => void} LinkApplyCallback */
+
+/**
+ * @param {object} options
+ * @param {TextEditorState} options.state
+ * @param {(text: string) => string} options.clientLinkify
+ * @param {ShowToast} options.showToast
+ * @param {WeakMap<HTMLElement, string>} options.snapshots
+ */
 export function createTextLinkInteractions({
   state,
   clientLinkify,
   showToast,
   snapshots,
 }) {
+  /** @type {HTMLDivElement | null} */
   let activePopover = null;
+  /** @type {HTMLDivElement | null} */
   let activeLinkHint = null;
 
   function removeLinkHint() {
@@ -24,6 +38,11 @@ export function createTextLinkInteractions({
     state.linkPopupEl = null;
   }
 
+  /**
+   * @param {DOMRect | DOMRectReadOnly} rect
+   * @param {string} initialUrl
+   * @param {LinkApplyCallback} onApply
+   */
   function showLinkPopup(rect, initialUrl, onApply) {
     dismissLinkPopup();
 
@@ -59,9 +78,15 @@ export function createTextLinkInteractions({
     popover.style.left = `${left}px`;
     popover.style.top = `${top}px`;
 
-    const input = popover.querySelector('.cms-link-popover-input');
-    const applyBtn = popover.querySelector('.cms-link-popover-apply');
-    const cancelBtn = popover.querySelector('.cms-link-popover-cancel');
+    const input = /** @type {HTMLInputElement} */ (
+      popover.querySelector('.cms-link-popover-input')
+    );
+    const applyBtn = /** @type {HTMLButtonElement} */ (
+      popover.querySelector('.cms-link-popover-apply')
+    );
+    const cancelBtn = /** @type {HTMLButtonElement} */ (
+      popover.querySelector('.cms-link-popover-cancel')
+    );
 
     requestAnimationFrame(() => input.focus());
     if (initialUrl) input.select();
@@ -80,7 +105,7 @@ export function createTextLinkInteractions({
     applyBtn.addEventListener('click', apply);
     cancelBtn.addEventListener('click', cancel);
 
-    input.addEventListener('keydown', (e) => {
+    input.addEventListener('keydown', (/** @type {KeyboardEvent} */ e) => {
       if (e.key === 'Enter') {
         e.preventDefault();
         apply();
@@ -92,8 +117,9 @@ export function createTextLinkInteractions({
     });
 
     setTimeout(() => {
+      /** @param {MouseEvent} e */
       function onDocClick(e) {
-        if (!popover.contains(e.target)) {
+        if (!(e.target instanceof Node) || !popover.contains(e.target)) {
           document.removeEventListener('click', onDocClick, true);
           cancel();
         }
@@ -102,6 +128,7 @@ export function createTextLinkInteractions({
     }, 0);
   }
 
+  /** @param {HTMLElement} el */
   function showLinkHint(el) {
     removeLinkHint();
     const hint = document.createElement('div');
@@ -115,8 +142,23 @@ export function createTextLinkInteractions({
     hint.style.left = `${rect.right - hint.offsetWidth}px`;
   }
 
+  /**
+   * @param {Range} range
+   * @returns {boolean}
+   */
+  function restoreSelection(range) {
+    const selection = window.getSelection();
+    if (!selection) return false;
+    selection.removeAllRanges();
+    selection.addRange(range);
+    return true;
+  }
+
+  /** @param {KeyboardEvent} e */
   function onKeydown(e) {
-    const focused = document.activeElement;
+    const focused = document.activeElement instanceof HTMLElement
+      ? /** @type {EditableElement} */ (document.activeElement)
+      : null;
 
     // Ctrl+S / Cmd+S — save focused element by triggering blur save
     if ((e.ctrlKey || e.metaKey) && e.key === 's') {
@@ -148,15 +190,14 @@ export function createTextLinkInteractions({
           : anchorNode instanceof Element ? anchorNode.closest('a') : null;
         const initialUrl = existingLink?.getAttribute('href') || '';
 
-        state.linkPopupEl = focused;
-
         showLinkPopup(selRect, initialUrl, (url) => {
           focused.focus();
 
           if (url) {
-            const newSel = window.getSelection();
-            newSel.removeAllRanges();
-            newSel.addRange(range);
+            if (!restoreSelection(range)) {
+              state.linkPopupEl = null;
+              return;
+            }
 
             if (existingLink) {
               existingLink.setAttribute('href', url);
@@ -179,12 +220,13 @@ export function createTextLinkInteractions({
 
             state.dirtyEls.add(focused);
           } else if (url === '' && existingLink) {
-            document.execCommand('unlink', false, null);
+            document.execCommand('unlink');
             state.dirtyEls.add(focused);
           }
 
           state.linkPopupEl = null;
         });
+        state.linkPopupEl = focused;
         return;
       }
 
@@ -198,21 +240,21 @@ export function createTextLinkInteractions({
 
         const range = sel.getRangeAt(0).cloneRange();
         const selRect = range.getBoundingClientRect();
-        state.linkPopupEl = focused;
-
         showLinkPopup(selRect, '', (url) => {
           focused.focus();
 
           if (url) {
-            const newSel = window.getSelection();
-            newSel.removeAllRanges();
-            newSel.addRange(range);
+            if (!restoreSelection(range)) {
+              state.linkPopupEl = null;
+              return;
+            }
             document.execCommand('insertText', false, `[${selectedText}](${url})`);
             state.dirtyEls.add(focused);
           }
 
           state.linkPopupEl = null;
         });
+        state.linkPopupEl = focused;
       }
       return;
     }

package/static/cms/editor/toast.js

@@ -5,6 +5,13 @@ const ERROR_SVG =
 const WARNING_SVG =
   '<svg class="cms-toast-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>';
 
+/** @typedef {'success' | 'error' | 'warning'} ToastType */
+/** @typedef {{ label: string, primary?: boolean, onClick: () => void | Promise<void> }} ToastAction */
+/** @typedef {{ message: string, sticky?: boolean, actions?: ToastAction[], role?: string }} ToastOptions */
+/** @typedef {{ message: string, onKeepMine: () => void | Promise<void>, onLoadLatest: () => void | Promise<void>, keepLabel?: string, latestLabel?: string }} ConflictOptions */
+/** @typedef {((message: string, type?: 'success' | 'error') => HTMLDivElement) & { conflict: (options: ConflictOptions) => HTMLDivElement }} ToastController */
+
+/** @param {ToastType} type @returns {string} */
 function iconFor(type) {
   if (type === 'success') return SUCCESS_SVG;
   if (type === 'warning') return WARNING_SVG;
@@ -24,9 +31,13 @@ function iconFor(type) {
  *    server-provided error string can't inject markup into the editor chrome.
  *  - The container is an aria-live region; errors/conflicts are role="alert".
  */
+/** @returns {ToastController} */
 export function createToast() {
+  /** @type {HTMLDivElement | null} */
   let container = null;
+  const dismissed = new WeakSet();
 
+  /** @returns {HTMLDivElement} */
   function ensureContainer() {
     if (container && document.body.contains(container)) return container;
     container = document.createElement('div');
@@ -36,13 +47,15 @@ export function createToast() {
     return container;
   }
 
+  /** @param {HTMLDivElement} toast */
   function dismiss(toast) {
-    if (toast._caretDismissed) return;
-    toast._caretDismissed = true;
+    if (dismissed.has(toast)) return;
+    dismissed.add(toast);
     toast.classList.add('cms-toast-out');
     setTimeout(() => toast.remove(), 300);
   }
 
+  /** @param {ToastType} type @param {ToastOptions} options @returns {HTMLDivElement} */
   function render(type, { message, sticky, actions, role }) {
     const stack = ensureContainer();
 
@@ -72,11 +85,11 @@ export function createToast() {
         btn.textContent = action.label;
         btn.addEventListener('click', () => {
           dismiss(toast);
-          try {
-            action.onClick();
-          } catch (e) {
-            /* action errors shouldn't break the toast */
-          }
+          Promise.resolve()
+            .then(() => action.onClick())
+            .catch(() => {
+              /* action errors shouldn't break the toast */
+            });
         });
         group.appendChild(btn);
       }
@@ -96,14 +109,15 @@ export function createToast() {
     return toast;
   }
 
-  function showToast(message, type) {
+  /** @type {ToastController} */
+  const showToast = (message, type) => {
     const t = type === 'error' ? 'error' : type || 'success';
     return render(t, {
       message,
       sticky: t === 'error',
       role: t === 'error' ? 'alert' : undefined,
     });
-  }
+  };
 
   // Two-choice save-conflict prompt. Sticky so the user's edit is never silently
   // discarded — they explicitly choose to keep theirs or load the latest.

package/static/cms/editor/tokens-and-text.css

@@ -72,6 +72,15 @@
   box-shadow: 0 0 0 4px var(--cms-blue-dim);
 }
 
+/* Briefly confirms that the paired Studio field was located. Save feedback is
+   green, so linked selection keeps the editor's blue navigation language. */
+.cms-linked-selection {
+  outline: 2px solid var(--cms-blue) !important;
+  outline-offset: 4px;
+  box-shadow: 0 0 0 4px var(--cms-blue-dim);
+  transition: outline-color 0.35s ease, box-shadow 0.35s ease;
+}
+
 /* ---------------------------------------------------------------------------
    Unpublished body draft
    The server rewrite tags blocks whose prose comes from an unpublished draft

package/static/cms/editor/toolbar.css

@@ -357,3 +357,8 @@ body:has(.cms-toolbar) #back-to-top {
     transform: translateY(0);
   }
 }
+
+/* Leave the Astro development dock usable when it opens or receives focus. */
+body:has(astro-dev-toolbar) .cms-toolbar {
+  bottom: 72px;
+}

package/static/cms/editor/toolbar.js

@@ -1,39 +1,34 @@
+import { isPolicyDraftMode } from './config.js';
 import { toggleHighlight } from './highlight.js';
 import { buildCmsUrl, isStaticDelivery } from './config.js';
+import { createDeploymentStatusPoller } from './deployment-status.js';
+import { presentPublishResult } from './publish-result.js';
+import { createDraftClient } from './draft-client.js';
+import { createPreviewModeController } from './preview-mode.js';
 
-const PREVIEW_COOKIE = 'caret_preview';
-
-function previewActive() {
-  return document.cookie.split('; ').some((c) => c === `${PREVIEW_COOKIE}=1`);
-}
-
-function setPreviewCookie(on) {
-  document.cookie = on
-    ? `${PREVIEW_COOKIE}=1; path=/; SameSite=Lax`
-    : `${PREVIEW_COOKIE}=; path=/; Max-Age=0; SameSite=Lax`;
-}
+const previewMode = createPreviewModeController({
+  isStaticDelivery,
+  isPolicyDraftMode,
+  documentRef: document,
+  reload: () => window.location.reload(),
+});
 
 /** Static delivery always drafts — turn preview on once so saves stay unpublished. */
 export function ensureStaticPreviewMode() {
-  if (!isStaticDelivery()) return false;
-  if (previewActive()) return false;
-  setPreviewCookie(true);
-  window.location.reload();
-  return true;
+  return previewMode.ensureStaticPreviewMode();
 }
 
 /** Align preview cookie with delivery mode (static on, server off). */
 export function normalizePreviewForDelivery() {
-  if (isStaticDelivery()) return ensureStaticPreviewMode();
-  if (previewActive()) {
-    setPreviewCookie(false);
-    window.location.reload();
-    return true;
-  }
-  return false;
+  return previewMode.normalizePreviewForDelivery();
 }
 
+/** @typedef {{ href: string, label: string, isActive: boolean }} ToolbarNavLink */
+/** @typedef {'saving' | 'idle' | 'error'} ToolbarStatusState */
+
+/** @param {string} pagePath @returns {ToolbarNavLink[]} */
 function getToolbarNavLinks(pagePath) {
+  /** @type {ToolbarNavLink[]} */
   const links = [];
   const headerNav = document.querySelector('#main-header nav');
   if (!headerNav) return links;
@@ -49,13 +44,14 @@ function getToolbarNavLinks(pagePath) {
   return links;
 }
 
+/** @param {boolean} staticDelivery */
 function renderDraftControls(staticDelivery) {
   // Static delivery is always drafting, so the controls stay visible. Server
   // delivery saves field edits straight to the site, but inline body-block
   // edits are ALWAYS drafts (they splice into source files only at publish), so
   // the controls render here too — hidden until at least one draft is pending
   // (toggled by refreshDraftControls) so the toolbar stays quiet otherwise.
-  const publishTitle = staticDelivery
+  const publishTitle = isPolicyDraftMode() ? 'Publish private drafts to shared content' : staticDelivery
     ? 'Publish drafts; static visitors update after rebuild and deploy'
     : 'Publish your body-block drafts into the source files';
   return `
@@ -72,6 +68,7 @@ function renderDraftControls(staticDelivery) {
         </span>`;
 }
 
+/** @param {ToolbarNavLink[]} navLinks @param {boolean} staticDelivery */
 function renderToolbar(navLinks, staticDelivery) {
   const navLinksHtml = navLinks
     .map(
@@ -80,8 +77,8 @@ function renderToolbar(navLinks, staticDelivery) {
     )
     .join('');
 
-  const badgeLabel = staticDelivery ? 'Draft' : 'Live';
-  const badgeHint = staticDelivery
+  const badgeLabel = staticDelivery || isPolicyDraftMode() ? 'Draft' : 'Live';
+  const badgeHint = isPolicyDraftMode() ? 'Changes save to your private draft; publishing requires permission' : staticDelivery
     ? 'Draft preview; visitors update after publish, rebuild, and deploy'
     : 'Changes save directly to your site';
 
@@ -104,6 +101,7 @@ function renderToolbar(navLinks, staticDelivery) {
       ${navLinksHtml ? `<div class="cms-toolbar-nav">${navLinksHtml}</div>` : ''}
       <div class="cms-toolbar-right">
         ${renderDraftControls(staticDelivery)}
+        <button type="button" class="cms-retry-rebuild-btn" hidden>Retry deploy</button>
         <button type="button" class="cms-studio-btn" title="Toggle Content Studio panel">
           <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><line x1="9" y1="3" x2="9" y2="21"/><line x1="9" y1="9" x2="21" y2="9"/></svg>
           Studio
@@ -130,6 +128,13 @@ function renderToolbar(navLinks, staticDelivery) {
   return toolbar;
 }
 
+/**
+ * @param {{
+ *   showToast: (message: string, type: 'success' | 'error') => void,
+ *   clearDirty: () => void,
+ *   onLogout: () => void | Promise<void>,
+ * }} options
+ */
 export function mountToolbar({ showToast, clearDirty, onLogout }) {
   const staticDelivery = isStaticDelivery();
   const navLinks = getToolbarNavLinks(window.location.pathname);
@@ -138,6 +143,7 @@ export function mountToolbar({ showToast, clearDirty, onLogout }) {
   const statusDot = toolbar.querySelector('.cms-status-dot');
   const statusText = toolbar.querySelector('.cms-status-text');
 
+  /** @param {ToolbarStatusState} state @param {string} text */
   function setStatus(state, text) {
     if (statusDot) {
       statusDot.className = `cms-status-dot cms-status-${state}`;
@@ -147,29 +153,36 @@ export function mountToolbar({ showToast, clearDirty, onLogout }) {
     }
   }
 
-  const highlightBtn = toolbar.querySelector('.cms-highlight-btn');
+  const deploymentStatus = createDeploymentStatusPoller({
+    fetchStatus: () => fetch(buildCmsUrl('/deployment'), {
+        credentials: 'same-origin',
+        headers: { 'x-caret-request': '1' },
+      }),
+    setStatus,
+    setBuildId(buildId) {
+      const statusGroup = /** @type {HTMLElement | null} */ (toolbar.querySelector('.cms-status-group'));
+      if (statusGroup) {
+        statusGroup.title = buildId ? `Build ${buildId}` : '';
+      }
+    },
+  });
+  const draftClient = createDraftClient({ buildUrl: path => buildCmsUrl(path) });
+
+  const highlightBtn = /** @type {HTMLButtonElement | null} */ (toolbar.querySelector('.cms-highlight-btn'));
   highlightBtn?.addEventListener('click', () =>
     toggleHighlight(highlightBtn, showToast),
   );
 
-  async function draftRequest(method, path) {
-    return fetch(buildCmsUrl(path), {
-      method,
-      headers: { 'Content-Type': 'application/json', 'x-caret-request': '1' },
-      credentials: 'same-origin',
-      body: method === 'POST' ? '{}' : undefined,
-    });
-  }
-
+  let canPublishDrafts = true;
+  const retryRebuildButton = /** @type {HTMLButtonElement | null} */ (toolbar.querySelector('.cms-retry-rebuild-btn'));
   async function fetchDraftCount() {
     try {
-      const res = await fetch(buildCmsUrl('/draft'), {
-        credentials: 'same-origin',
-        headers: { 'x-caret-request': '1' },
-      });
-      if (!res.ok) return 0;
-      const data = await res.json();
-      return typeof data.count === 'number' ? data.count : 0;
+      const data = await draftClient.getState();
+      canPublishDrafts = data.canPublish;
+      const publishButton = /** @type {HTMLButtonElement | null} */ (toolbar.querySelector('.cms-publish-btn'));
+      if (publishButton) publishButton.hidden = !data.canPublish;
+      if (retryRebuildButton) retryRebuildButton.hidden = !data.retryRebuild || !data.canPublish;
+      return data.count;
     } catch {
       return 0;
     }
@@ -178,60 +191,25 @@ export function mountToolbar({ showToast, clearDirty, onLogout }) {
   async function publishDrafts() {
     setStatus('saving', 'Publishing…');
     try {
-      const res = await draftRequest('POST', '/publish');
-      if (!res.ok) throw new Error('publish failed');
-      const data = await res.json();
-      const n = Array.isArray(data.published) ? data.published.length : 0;
-      const conflicts = Array.isArray(data.conflicts) ? data.conflicts.length : 0;
-      if (conflicts > 0) {
-        // Stale body drafts: preserved server-side, NOT published. Reload so
-        // fresh stamps arrive and the editor can re-apply them.
-        setStatus('error', 'Some drafts conflicted');
-        showToast(
-          n > 0
-            ? `Published ${n} change(s); ${conflicts} draft(s) conflicted with newer content — reloading so you can re-apply.`
-            : `${conflicts} draft(s) conflicted with newer content — reloading so you can re-apply.`,
-          'error',
-        );
-        window.location.reload();
-        return n > 0;
-      }
-      if (data.rebuild?.triggered && data.rebuild.ok === false) {
-        setStatus('error', 'Published, deploy failed');
-        showToast(
-          'Changes are published, but the deploy webhook failed. Check your CI settings.',
-          'error',
-        );
-        return false;
-      }
-      if (data.rebuild?.triggered) {
-        showToast(
-          n > 0
-            ? `Published ${n} change(s) — rebuild started`
-            : 'Your site is rebuilding',
-          'success',
-        );
-      } else {
-        showToast(
-          n > 0
-            ? `Published ${n} change(s) — rebuild and deploy to update visitors`
-            : 'Already up to date',
-          'success',
-        );
+      const presentation = presentPublishResult(await draftClient.publish());
+      if (retryRebuildButton) retryRebuildButton.hidden = !presentation.retryAvailable;
+      if (presentation.status) {
+        setStatus(presentation.status.state, presentation.status.text);
       }
-      window.location.reload();
-      return true;
+      showToast(presentation.toast.message, presentation.toast.kind);
+      if (presentation.reload) window.location.reload();
+      return presentation.completed;
     } catch {
       setStatus('error', 'Publish failed');
-      showToast('Publish failed', 'error');
+      showToast('Publication could not finish. Some content may already be published. Retry Publish to recover.', 'error');
       return false;
     }
   }
 
   toolbar.querySelector('.cms-exit-btn')?.addEventListener('click', async () => {
-    if (staticDelivery) {
+    if (staticDelivery || isPolicyDraftMode()) {
       const count = await fetchDraftCount();
-      if (count > 0) {
+      if (count > 0 && canPublishDrafts) {
         const goLive = window.confirm(
           `You have ${count} unpublished change${count === 1 ? '' : 's'}. Publish before signing out?`,
         );
@@ -244,10 +222,9 @@ export function mountToolbar({ showToast, clearDirty, onLogout }) {
         );
         if (!discard) return;
         try {
-          const res = await draftRequest('DELETE', '/draft');
-          if (!res.ok) throw new Error('discard failed');
+          await draftClient.discard();
         } catch {
-          showToast('Could not discard drafts', 'error');
+          showToast('Some drafts need publish recovery. Retry Publish before discarding.', 'error');
           return;
         }
       }
@@ -257,7 +234,7 @@ export function mountToolbar({ showToast, clearDirty, onLogout }) {
     await onLogout();
   });
 
-  const publishBtn = toolbar.querySelector('.cms-publish-btn');
+  const publishBtn = /** @type {HTMLButtonElement | null} */ (toolbar.querySelector('.cms-publish-btn'));
   publishBtn?.addEventListener('click', async () => {
     if (
       !window.confirm(
@@ -274,8 +251,7 @@ export function mountToolbar({ showToast, clearDirty, onLogout }) {
   toolbar.querySelector('.cms-discard-btn')?.addEventListener('click', async () => {
     if (!window.confirm('Discard all your draft changes? This cannot be undone.')) return;
     try {
-      const res = await draftRequest('DELETE', '/draft');
-      if (!res.ok) throw new Error('discard failed');
+      await draftClient.discard();
       showToast('Draft discarded', 'success');
       window.location.reload();
     } catch {
@@ -287,15 +263,29 @@ export function mountToolbar({ showToast, clearDirty, onLogout }) {
   // edits save directly (no draft), so the count reflects pending body blocks.
   // Refresh on mount and whenever a body block is drafted; publish/discard
   // reload the page, so mount re-evaluates from scratch.
-  const draftControls = toolbar.querySelector('.cms-draft-controls');
+  const draftControls = /** @type {HTMLElement | null} */ (toolbar.querySelector('.cms-draft-controls'));
   async function refreshDraftControls() {
-    if (staticDelivery || !draftControls) return;
-    draftControls.hidden = (await fetchDraftCount()) === 0;
-  }
-  if (!staticDelivery) {
-    refreshDraftControls();
-    window.addEventListener('cms:draftSaved', refreshDraftControls);
+    const count = await fetchDraftCount();
+    if (draftControls) draftControls.hidden = !staticDelivery && !isPolicyDraftMode() && count === 0;
   }
+  refreshDraftControls();
+  window.addEventListener('cms:draftSaved', refreshDraftControls);
+  retryRebuildButton?.addEventListener('click', async () => {
+    retryRebuildButton.disabled = true;
+    setStatus('saving', 'Retrying deploy…');
+    try {
+      const data = await draftClient.retryDeployment();
+      retryRebuildButton.hidden = true;
+      setStatus(data.deploymentTracked ? 'saving' : 'idle', data.deploymentTracked ? 'Deploying…' : 'Deploy requested');
+      showToast('Deploy requested. Your published content is unchanged.', 'success');
+      if (data.deploymentTracked) deploymentStatus.schedule();
+    } catch {
+      setStatus('error', 'Published, deploy failed');
+      showToast('The deploy hook failed. Check its configuration and retry.', 'error');
+    } finally { retryRebuildButton.disabled = false; }
+  });
+
+  void deploymentStatus.refresh();
 
   const studioButton = toolbar.querySelector('.cms-studio-btn');
   const mapButton = toolbar.querySelector('.cms-map-btn');

package/static/cms/editor.css

@@ -1,7 +1,7 @@
 /* ========================================================================
    CMS Editor Styles — only loaded when isEditor = true
    ======================================================================== */
-@import "./editor/tokens-and-text.css";
+@import "./editor/tokens-and-text.css?v=studio-upstream-20260819";
 @import "./editor/image.css";
 @import "./editor/section-controls.css";
 @import "./editor/toolbar.css";

package/static/cms/editor.js

@@ -36,6 +36,7 @@ function redirectToEditorLogin() {
 function boot() {
   if (normalizePreviewForDelivery()) return;
 
+  /** @type {{ dirtyEls: Set<Element>, linkPopupEl: HTMLElement | null }} */
   const state = {
     // Every element with unsaved edits. A Set (not a single element) so a save
     // completing on field A can't clear the dirty flag for field B the user has