@nowline/preview-shell 0.4.2 → 0.5.0

package/dist/mount.js

@@ -12,14 +12,23 @@ import { buildViewport } from './markup.js';
 import { PREVIEW_SHELL_CSS } from './styles.js';
 let stylesheetMounted = false;
 /**
- * Ensure the shared `<style>` block is in the document `<head>`. Safe
- * to call repeatedly — only the first call writes. The stylesheet
- * scopes every selector under `.nl-preview-root` so multiple shells
- * can coexist with workbench / app styles.
+ * Last chrome position saved after a drag, shared across all shells in
+ * this JS session. Persists for the lifetime of the page.
  */
+let savedChromePosition = null;
 function ensureStylesheet(doc) {
     if (stylesheetMounted)
         return;
+    // A CSP-restricted consumer (e.g. the VS Code webview, whose
+    // `style-src` is nonce-only with no `'unsafe-inline'`) pre-injects
+    // this stylesheet into the host HTML with a nonce, marked by the
+    // `data-nl-preview-shell` attribute. A second `<style>` created here
+    // would carry no nonce and be refused by the CSP, leaving the
+    // toolbar unstyled — so defer to the host-provided copy when present.
+    if (doc.querySelector('style[data-nl-preview-shell]')) {
+        stylesheetMounted = true;
+        return;
+    }
     const style = doc.createElement('style');
     style.setAttribute('data-nl-preview-shell', '');
     style.textContent = PREVIEW_SHELL_CSS;
@@ -38,9 +47,15 @@ export function mountPreview(rootEl, options = {}) {
         naturalHeight: 0,
         defaultFit: options.initialFit ?? 'fitPage',
         activeFit: options.initialFit === 'fitWidth' ? 'fitWidth' : 'fitPage',
+        isDirty: false,
+        lastViewportWidth: 0,
+        lastViewportHeight: 0,
         showMinimap: options.showMinimap !== false,
         minimapDismissedThisSession: false,
         firstRender: true,
+        mode: 'dark',
+        locale: options.locale ?? (typeof navigator !== 'undefined' ? navigator.language : 'en'),
+        export: { format: 'svg' },
         view: {
             theme: 'auto',
             now: 'today',
@@ -53,16 +68,166 @@ export function mountPreview(rootEl, options = {}) {
         target.addEventListener(type, handler, opts);
         cleanups.push(() => target.removeEventListener(type, handler, opts));
     }
-    // ===== Toolbar fade =====
+    // ===== Mode resolution =====
+    function resolveSystemMode() {
+        const body = doc.body;
+        if (body) {
+            if (body.classList.contains('vscode-dark') ||
+                body.classList.contains('vscode-high-contrast-dark'))
+                return 'dark';
+            if (body.classList.contains('vscode-light') ||
+                body.classList.contains('vscode-high-contrast-light') ||
+                body.classList.contains('vscode-high-contrast'))
+                return 'light';
+        }
+        if (typeof win.matchMedia === 'function') {
+            return win.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+        }
+        return 'dark';
+    }
+    function applyMode(resolved) {
+        state.mode = resolved;
+        rootEl.setAttribute('data-nl-mode', resolved);
+    }
+    const rawMode = options.mode ?? 'system';
+    applyMode(rawMode === 'system' ? resolveSystemMode() : rawMode);
+    if (rawMode === 'system') {
+        if (typeof MutationObserver !== 'undefined' && doc.body) {
+            const bodyObs = new MutationObserver(() => applyMode(resolveSystemMode()));
+            bodyObs.observe(doc.body, { attributes: true, attributeFilter: ['class'] });
+            cleanups.push(() => bodyObs.disconnect());
+        }
+        const mq = typeof win.matchMedia === 'function'
+            ? win.matchMedia('(prefers-color-scheme: dark)')
+            : null;
+        if (mq) {
+            const onMqChange = () => {
+                const body = doc.body;
+                const hasVsCode = body &&
+                    (body.classList.contains('vscode-dark') ||
+                        body.classList.contains('vscode-light') ||
+                        body.classList.contains('vscode-high-contrast') ||
+                        body.classList.contains('vscode-high-contrast-dark') ||
+                        body.classList.contains('vscode-high-contrast-light'));
+                if (!hasVsCode)
+                    applyMode(mq.matches ? 'dark' : 'light');
+            };
+            mq.addEventListener('change', onMqChange);
+            cleanups.push(() => mq.removeEventListener('change', onMqChange));
+        }
+    }
+    // ===== Floating UI fade =====
     let fadeTimer = null;
-    function showToolbar() {
+    function showFloatingUI() {
         els.chrome.classList.remove('faded');
+        els.minimap.classList.remove('faded');
         if (fadeTimer)
             clearTimeout(fadeTimer);
-        fadeTimer = setTimeout(() => els.chrome.classList.add('faded'), 2000);
+        fadeTimer = setTimeout(() => {
+            els.chrome.classList.add('faded');
+            els.minimap.classList.add('faded');
+        }, 2000);
+    }
+    on(doc, 'mousemove', showFloatingUI);
+    showFloatingUI();
+    // ===== Collapse / restore =====
+    // « collapses the toolbar to a translucent puck (just the drag grip
+    // + a » restore arrow); » expands it back to the full toolbar.
+    on(els.collapseBtn, 'click', (e) => {
+        e.stopPropagation();
+        closeAllMenus();
+        els.chrome.classList.add('collapsed');
+        repositionChrome();
+    });
+    on(els.restoreBtn, 'click', (e) => {
+        e.stopPropagation();
+        els.chrome.classList.remove('collapsed');
+        repositionChrome();
+    });
+    // ===== Toolbar positioning + drag =====
+    // The chrome defaults to the upper-right corner and tracks it on
+    // resize (`chromePinnedRight`). Once dragged it becomes free-floating
+    // and is merely clamped back into view. Either way the position is
+    // always expressed as explicit `left`/`top` so a narrowing viewport
+    // shifts the toolbar left instead of squishing the row.
+    let chromePinnedRight = savedChromePosition === null;
+    let chromeDragStart = null;
+    function getGutter() {
+        const val = getComputedStyle(rootEl).getPropertyValue('--nl-preview-gutter').trim();
+        return parseInt(val, 10) || 8;
+    }
+    function repositionChrome() {
+        const g = getGutter();
+        const cw = els.chrome.offsetWidth;
+        const ch = els.chrome.offsetHeight;
+        const maxLeft = Math.max(g, rootEl.clientWidth - cw - g);
+        const maxTop = Math.max(g, rootEl.clientHeight - ch - g);
+        let left;
+        let top;
+        if (chromePinnedRight) {
+            left = rootEl.clientWidth - cw - g;
+            top = g;
+        }
+        else {
+            left = parseInt(els.chrome.style.left, 10);
+            top = parseInt(els.chrome.style.top, 10);
+            if (Number.isNaN(left))
+                left = savedChromePosition?.left ?? g;
+            if (Number.isNaN(top))
+                top = savedChromePosition?.top ?? g;
+        }
+        els.chrome.style.right = 'auto';
+        els.chrome.style.left = `${Math.max(g, Math.min(left, maxLeft))}px`;
+        els.chrome.style.top = `${Math.max(g, Math.min(top, maxTop))}px`;
     }
-    on(doc, 'mousemove', showToolbar);
-    showToolbar();
+    function ensureChromeLeftTopAnchoring() {
+        if (els.chrome.style.left !== '')
+            return;
+        els.chrome.style.right = 'auto';
+        els.chrome.style.left = `${els.chrome.offsetLeft}px`;
+        els.chrome.style.top = `${els.chrome.offsetTop}px`;
+    }
+    on(els.toolbarHandle, 'pointerdown', (e) => {
+        e.preventDefault();
+        chromePinnedRight = false;
+        ensureChromeLeftTopAnchoring();
+        chromeDragStart = {
+            pointerX: e.clientX,
+            pointerY: e.clientY,
+            chromeLeft: parseInt(els.chrome.style.left, 10) || 0,
+            chromeTop: parseInt(els.chrome.style.top, 10) || 0,
+        };
+        els.chrome.classList.add('dragging');
+        els.toolbarHandle.setPointerCapture(e.pointerId);
+    });
+    on(els.toolbarHandle, 'pointermove', (e) => {
+        if (!chromeDragStart)
+            return;
+        const dx = e.clientX - chromeDragStart.pointerX;
+        const dy = e.clientY - chromeDragStart.pointerY;
+        const rawLeft = chromeDragStart.chromeLeft + dx;
+        const rawTop = chromeDragStart.chromeTop + dy;
+        const g = getGutter();
+        const maxLeft = Math.max(g, rootEl.clientWidth - els.chrome.offsetWidth - g);
+        const maxTop = Math.max(g, rootEl.clientHeight - els.chrome.offsetHeight - g);
+        els.chrome.style.left = `${Math.max(g, Math.min(rawLeft, maxLeft))}px`;
+        els.chrome.style.top = `${Math.max(g, Math.min(rawTop, maxTop))}px`;
+    });
+    function endChromeDrag() {
+        if (!chromeDragStart)
+            return;
+        chromeDragStart = null;
+        els.chrome.classList.remove('dragging');
+        savedChromePosition = {
+            left: parseInt(els.chrome.style.left, 10) || 0,
+            top: parseInt(els.chrome.style.top, 10) || 0,
+        };
+    }
+    on(els.toolbarHandle, 'pointerup', endChromeDrag);
+    on(els.toolbarHandle, 'pointercancel', () => {
+        chromeDragStart = null;
+        els.chrome.classList.remove('dragging');
+    });
     // ===== Transform =====
     function applyTransform() {
         const w = Math.max(1, Math.round(state.naturalWidth * state.scale));
@@ -99,6 +264,7 @@ export function mountPreview(rootEl, options = {}) {
         if (!state.naturalWidth || !state.naturalHeight)
             return;
         state.activeFit = 'fitPage';
+        state.isDirty = false;
         const sx = els.viewport.clientWidth / state.naturalWidth;
         const sy = els.viewport.clientHeight / state.naturalHeight;
         setScale(Math.min(sx, sy));
@@ -109,12 +275,14 @@ export function mountPreview(rootEl, options = {}) {
         if (!state.naturalWidth)
             return;
         state.activeFit = 'fitWidth';
+        state.isDirty = false;
         setScale(els.viewport.clientWidth / state.naturalWidth);
         els.viewport.scrollLeft = 0;
         els.viewport.scrollTop = 0;
     }
     function actualSize() {
         state.activeFit = 'manual';
+        state.isDirty = true;
         setScale(1);
     }
     function applyDefaultFit() {
@@ -126,10 +294,26 @@ export function mountPreview(rootEl, options = {}) {
             fitPage();
     }
     function reapplyActiveFit() {
-        if (state.activeFit === 'fitPage')
+        const newW = els.viewport.clientWidth;
+        const newH = els.viewport.clientHeight;
+        if (state.isDirty) {
+            const oldW = state.lastViewportWidth || newW;
+            const oldH = state.lastViewportHeight || newH;
+            if (state.scale > 0 && (oldW !== newW || oldH !== newH)) {
+                const cx = (els.viewport.scrollLeft + oldW / 2) / state.scale;
+                const cy = (els.viewport.scrollTop + oldH / 2) / state.scale;
+                els.viewport.scrollLeft = Math.max(0, cx * state.scale - newW / 2);
+                els.viewport.scrollTop = Math.max(0, cy * state.scale - newH / 2);
+            }
+        }
+        else if (state.activeFit === 'fitPage') {
             fitPage();
-        else if (state.activeFit === 'fitWidth')
+        }
+        else if (state.activeFit === 'fitWidth') {
             fitWidth();
+        }
+        state.lastViewportWidth = newW;
+        state.lastViewportHeight = newH;
     }
     // ===== Render handling =====
     function extractNaturalSize(svgEl) {
@@ -221,6 +405,8 @@ export function mountPreview(rootEl, options = {}) {
             els.diagSummary.classList.add('warn-only');
         if (!errors && !warnings)
             els.diagSummary.classList.add('clean');
+        // Hide Open Problems link when there are no issues
+        els.openProblems.hidden = errors + warnings === 0;
         const tbody = els.diagTbody;
         while (tbody.firstChild)
             tbody.removeChild(tbody.firstChild);
@@ -286,8 +472,8 @@ export function mountPreview(rootEl, options = {}) {
             }
             svgEl.setAttribute('preserveAspectRatio', 'xMidYMid meet');
         }
-        const maxW = 160;
-        const maxH = 120;
+        const maxW = 120;
+        const maxH = 90;
         if (state.naturalWidth && state.naturalHeight) {
             const ratio = state.naturalWidth / state.naturalHeight;
             let w = maxW;
@@ -361,17 +547,31 @@ export function mountPreview(rootEl, options = {}) {
         miniDragging = false;
     });
     on(els.viewport, 'scroll', updateMinimapRect);
-    on(win, 'resize', () => {
-        reapplyActiveFit();
-        updateMinimapRect();
-        updateMinimapVisibility();
-    });
+    let resizeTimer = null;
+    function handleResize() {
+        if (resizeTimer)
+            clearTimeout(resizeTimer);
+        resizeTimer = setTimeout(() => {
+            resizeTimer = null;
+            reapplyActiveFit();
+            updateMinimapRect();
+            updateMinimapVisibility();
+            repositionChrome();
+        }, 50);
+    }
+    on(win, 'resize', handleResize);
+    if (typeof ResizeObserver !== 'undefined') {
+        const ro = new ResizeObserver(handleResize);
+        ro.observe(els.viewport);
+        cleanups.push(() => ro.disconnect());
+    }
     // ===== Wheel zoom =====
     on(els.viewport, 'wheel', (e) => {
         if (!(e.ctrlKey || e.metaKey))
             return;
         e.preventDefault();
         state.activeFit = 'manual';
+        state.isDirty = true;
         const rect = els.viewport.getBoundingClientRect();
         const anchorX = e.clientX - rect.left;
         const anchorY = e.clientY - rect.top;
@@ -420,6 +620,7 @@ export function mountPreview(rootEl, options = {}) {
     on(els.viewport, 'mousedown', (e) => {
         if (!spaceDown)
             return;
+        state.isDirty = true;
         dragOrigin = {
             x: e.clientX,
             y: e.clientY,
@@ -444,96 +645,123 @@ export function mountPreview(rootEl, options = {}) {
     // ===== Toolbar buttons =====
     on(els.zoomOut, 'click', () => {
         state.activeFit = 'manual';
+        state.isDirty = true;
         setScale(state.scale / 1.1);
     });
     on(els.zoomIn, 'click', () => {
         state.activeFit = 'manual';
+        state.isDirty = true;
         setScale(state.scale * 1.1);
     });
     on(els.zoomReset, 'click', actualSize);
     on(els.fitWidth, 'click', fitWidth);
     on(els.fitPage, 'click', fitPage);
-    // ===== Dropdowns =====
-    function setupDropdown(toggle, menu) {
-        on(toggle, 'click', (e) => {
-            e.stopPropagation();
-            els.saveMenu.hidden = true;
-            els.copyMenu.hidden = true;
-            els.viewMenu.hidden = true;
-            menu.hidden = !menu.hidden;
-        });
+    // ===== Menu state helpers =====
+    function closeSubMenus() {
+        els.formatMenu.hidden = true;
+        els.themeMenu.hidden = true;
+        els.nowPicker.hidden = true;
+        els.linksMenu.hidden = true;
     }
-    setupDropdown(els.viewToggle, els.viewMenu);
-    setupDropdown(els.saveToggle, els.saveMenu);
-    setupDropdown(els.copyToggle, els.copyMenu);
-    on(doc, 'click', () => {
-        els.saveMenu.hidden = true;
-        els.copyMenu.hidden = true;
-        els.viewMenu.hidden = true;
-    });
-    for (const m of [els.saveMenu, els.copyMenu, els.viewMenu]) {
-        on(m, 'click', (e) => e.stopPropagation());
-    }
-    // ===== View options =====
-    function refreshViewMenu() {
-        const items = els.viewMenu.querySelectorAll('.view-opt');
-        for (const item of Array.from(items)) {
-            const opt = item.getAttribute('data-opt');
-            const value = item.getAttribute('data-value');
-            let active = false;
-            if (opt === 'theme')
-                active = state.view.theme === value;
-            else if (opt === 'now')
-                active = state.view.now === value;
-            else if (opt === 'showLinks')
-                active = state.view.showLinks;
-            item.setAttribute('data-active', active ? 'true' : 'false');
-        }
+    function closeAllMenus() {
+        els.moreMenu.hidden = true;
+        closeSubMenus();
     }
-    function postViewOverrides() {
-        const overrides = {};
-        if (state.view.overridden.theme)
-            overrides.theme = state.view.theme;
-        if (state.view.overridden.now)
-            overrides.now = state.view.now;
-        if (state.view.overridden.showLinks)
-            overrides.showLinks = state.view.showLinks;
-        options.onViewOptions?.(overrides);
-    }
-    on(els.viewMenu, 'click', (e) => {
-        const target = e.target;
-        const btn = target?.closest('.view-opt');
-        if (!btn)
+    /**
+     * Keep a just-opened flyout (more-menu, a sub-dropdown, or the
+     * calendar) inside the preview root + gutters. `defaultSide` is the
+     * edge the panel is anchored to in CSS; if opening that way would
+     * spill past the opposite gutter the panel is flipped, then any
+     * residual horizontal overflow is nudged back with a transform and
+     * excess height is capped with an internal scroll.
+     *
+     * `clampVertical` is off for the more-menu so capping its height
+     * never clips the calendar that pops out of it.
+     */
+    function placeFlyout(panel, defaultSide, clampVertical = true) {
+        panel.classList.remove('flip');
+        panel.style.maxHeight = '';
+        panel.style.overflowY = '';
+        panel.style.transform = '';
+        const root = rootEl.getBoundingClientRect();
+        // Skip when the host hasn't laid out yet (e.g. happy-dom tests).
+        if (root.width === 0 && root.height === 0)
             return;
-        const opt = btn.getAttribute('data-opt');
-        const value = btn.getAttribute('data-value');
-        if (opt === 'theme') {
-            state.view.theme = value;
-            state.view.overridden.theme = true;
+        const g = getGutter();
+        let box = panel.getBoundingClientRect();
+        const fitsWidth = box.width <= root.width - 2 * g;
+        if (fitsWidth && defaultSide === 'left' && box.right > root.right - g) {
+            panel.classList.add('flip');
         }
-        else if (opt === 'now') {
-            state.view.now = value;
-            state.view.overridden.now = true;
+        else if (fitsWidth && defaultSide === 'right' && box.left < root.left + g) {
+            panel.classList.add('flip');
         }
-        else if (opt === 'showLinks') {
-            state.view.showLinks = !state.view.showLinks;
-            state.view.overridden.showLinks = true;
+        box = panel.getBoundingClientRect();
+        let dx = 0;
+        if (box.right > root.right - g)
+            dx = root.right - g - box.right;
+        if (box.left + dx < root.left + g)
+            dx = root.left + g - box.left;
+        if (dx !== 0)
+            panel.style.transform = `translateX(${Math.round(dx)}px)`;
+        if (clampVertical) {
+            box = panel.getBoundingClientRect();
+            const avail = root.bottom - g - box.top;
+            if (box.height > avail && avail > 80) {
+                panel.style.maxHeight = `${Math.round(avail)}px`;
+                panel.style.overflowY = 'auto';
+            }
+        }
+    }
+    on(doc, 'click', closeAllMenus);
+    on(els.moreMenu, 'click', (e) => e.stopPropagation());
+    // ===== More-menu toggle =====
+    on(els.moreToggle, 'click', (e) => {
+        e.stopPropagation();
+        const opening = els.moreMenu.hidden;
+        closeAllMenus();
+        if (opening) {
+            els.moreMenu.hidden = false;
+            placeFlyout(els.moreMenu, 'right', /* clampVertical */ false);
         }
-        refreshViewMenu();
-        els.viewMenu.hidden = true;
-        postViewOverrides();
     });
-    // ===== Save / copy actions =====
-    const actionButtons = els.root.querySelectorAll('[data-action]');
-    for (const btn of Array.from(actionButtons)) {
-        on(btn, 'click', () => {
-            const action = btn.getAttribute('data-action');
-            els.saveMenu.hidden = true;
-            els.copyMenu.hidden = true;
-            if (action)
-                void handleExportAction(action);
-        });
+    // ===== Format dropdown =====
+    on(els.formatToggle, 'click', (e) => {
+        e.stopPropagation();
+        const opening = els.formatMenu.hidden;
+        closeSubMenus();
+        if (opening) {
+            els.formatMenu.hidden = false;
+            placeFlyout(els.formatMenu, 'left');
+        }
+    });
+    on(els.formatMenu, 'click', (e) => {
+        e.stopPropagation();
+        const btn = e.target.closest('.format-opt');
+        if (!btn)
+            return;
+        const value = btn.getAttribute('data-value');
+        if (!value)
+            return;
+        state.export.format = value;
+        refreshFormatToggle();
+        els.formatMenu.hidden = true;
+    });
+    function refreshFormatToggle() {
+        els.formatToggle.textContent = `${state.export.format.toUpperCase()} \u25be`;
+        for (const btn of Array.from(els.formatMenu.querySelectorAll('.format-opt'))) {
+            btn.setAttribute('data-active', (btn.getAttribute('data-value') === state.export.format).toString());
+        }
     }
+    // ===== Copy / export actions =====
+    on(els.copyAction, 'click', () => {
+        closeAllMenus();
+        void handleExportAction(`copy-${state.export.format}`);
+    });
+    on(els.exportAction, 'click', () => {
+        closeAllMenus();
+        void handleExportAction(`save-${state.export.format}`);
+    });
     async function handleExportAction(action) {
         if (!state.svgString)
             return;
@@ -619,15 +847,264 @@ export function mountPreview(rootEl, options = {}) {
             img.src = url;
         });
     }
-    // ===== Apply initial baselines =====
+    // ===== Theme dropdown =====
+    function buildThemeMenu(themes) {
+        els.themeMenu.innerHTML = '';
+        const autoLi = doc.createElement('li');
+        const autoBtn = doc.createElement('button');
+        autoBtn.className = 'btn theme-opt';
+        autoBtn.setAttribute('data-value', 'auto');
+        autoBtn.textContent = 'Auto';
+        autoLi.appendChild(autoBtn);
+        els.themeMenu.appendChild(autoLi);
+        for (const theme of themes) {
+            const li = doc.createElement('li');
+            const btn = doc.createElement('button');
+            btn.className = 'btn theme-opt';
+            btn.setAttribute('data-value', theme);
+            const chip = doc.createElement('code');
+            chip.className = 'code-chip';
+            chip.textContent = theme;
+            btn.appendChild(chip);
+            li.appendChild(btn);
+            els.themeMenu.appendChild(li);
+        }
+        refreshThemeToggle();
+    }
+    on(els.themeToggle, 'click', (e) => {
+        e.stopPropagation();
+        const opening = els.themeMenu.hidden;
+        closeSubMenus();
+        if (opening) {
+            els.themeMenu.hidden = false;
+            placeFlyout(els.themeMenu, 'left');
+        }
+    });
+    on(els.themeMenu, 'click', (e) => {
+        e.stopPropagation();
+        const btn = e.target.closest('.theme-opt');
+        if (!btn)
+            return;
+        const value = btn.getAttribute('data-value');
+        if (!value)
+            return;
+        state.view.theme = value;
+        state.view.overridden.theme = true;
+        refreshThemeToggle();
+        els.themeMenu.hidden = true;
+        postViewOverrides();
+    });
+    function refreshThemeToggle() {
+        if (state.view.theme === 'auto') {
+            els.themeToggle.textContent = `Auto \u25be`;
+        }
+        else {
+            els.themeToggle.innerHTML = '';
+            const chip = doc.createElement('code');
+            chip.className = 'code-chip';
+            chip.textContent = state.view.theme;
+            els.themeToggle.appendChild(chip);
+            els.themeToggle.appendChild(doc.createTextNode(` \u25be`));
+        }
+        for (const btn of Array.from(els.themeMenu.querySelectorAll('.theme-opt'))) {
+            btn.setAttribute('data-active', (btn.getAttribute('data-value') === state.view.theme).toString());
+        }
+    }
+    // ===== Now picker (calendar) =====
+    let calendarYear = new Date().getFullYear();
+    let calendarMonth = new Date().getMonth();
+    function buildCalendar() {
+        const picker = els.nowPicker;
+        picker.innerHTML = '';
+        const year = calendarYear;
+        const month = calendarMonth;
+        const nav = doc.createElement('div');
+        nav.className = 'cal-nav';
+        const prevBtn = doc.createElement('button');
+        prevBtn.className = 'btn cal-nav-btn';
+        prevBtn.textContent = '\u2039';
+        prevBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            calendarMonth--;
+            if (calendarMonth < 0) {
+                calendarMonth = 11;
+                calendarYear--;
+            }
+            buildCalendar();
+        });
+        const heading = doc.createElement('span');
+        heading.className = 'cal-heading';
+        heading.textContent = new Intl.DateTimeFormat(state.locale, {
+            month: 'long',
+            year: 'numeric',
+        }).format(new Date(year, month, 1));
+        const nextBtn = doc.createElement('button');
+        nextBtn.className = 'btn cal-nav-btn';
+        nextBtn.textContent = '\u203a';
+        nextBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            calendarMonth++;
+            if (calendarMonth > 11) {
+                calendarMonth = 0;
+                calendarYear++;
+            }
+            buildCalendar();
+        });
+        nav.appendChild(prevBtn);
+        nav.appendChild(heading);
+        nav.appendChild(nextBtn);
+        picker.appendChild(nav);
+        const grid = doc.createElement('div');
+        grid.className = 'cal-grid';
+        for (const d of ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa']) {
+            const cell = doc.createElement('span');
+            cell.className = 'cal-dow';
+            cell.textContent = d;
+            grid.appendChild(cell);
+        }
+        const firstDow = new Date(year, month, 1).getDay();
+        const daysInMonth = new Date(year, month + 1, 0).getDate();
+        for (let i = 0; i < firstDow; i++) {
+            const empty = doc.createElement('span');
+            empty.className = 'cal-empty';
+            grid.appendChild(empty);
+        }
+        const now = new Date();
+        const todayStr = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+        for (let d = 1; d <= daysInMonth; d++) {
+            const dateStr = `${year}-${String(month + 1).padStart(2, '0')}-${String(d).padStart(2, '0')}`;
+            const btn = doc.createElement('button');
+            btn.className = 'btn cal-day';
+            btn.textContent = String(d);
+            if (dateStr === todayStr)
+                btn.classList.add('is-today');
+            if (state.view.now === dateStr)
+                btn.classList.add('is-selected');
+            btn.addEventListener('click', (e) => {
+                e.stopPropagation();
+                applyNow(dateStr);
+            });
+            grid.appendChild(btn);
+        }
+        picker.appendChild(grid);
+        const footer = doc.createElement('div');
+        footer.className = 'cal-footer';
+        const todayBtnEl = doc.createElement('button');
+        todayBtnEl.className = 'btn cal-footer-btn';
+        todayBtnEl.textContent = 'Today';
+        todayBtnEl.addEventListener('click', (e) => {
+            e.stopPropagation();
+            applyNow('today');
+        });
+        const noneBtnEl = doc.createElement('button');
+        noneBtnEl.className = 'btn cal-footer-btn';
+        noneBtnEl.textContent = 'None';
+        noneBtnEl.addEventListener('click', (e) => {
+            e.stopPropagation();
+            applyNow('hide');
+        });
+        footer.appendChild(todayBtnEl);
+        footer.appendChild(noneBtnEl);
+        picker.appendChild(footer);
+    }
+    function applyNow(value) {
+        state.view.now = value;
+        state.view.overridden.now = true;
+        refreshNowToggle();
+        els.nowPicker.hidden = true;
+        postViewOverrides();
+    }
+    on(els.nowToggle, 'click', (e) => {
+        e.stopPropagation();
+        const opening = els.nowPicker.hidden;
+        closeSubMenus();
+        if (opening) {
+            buildCalendar();
+            els.nowPicker.hidden = false;
+            placeFlyout(els.nowPicker, 'left');
+        }
+    });
+    function refreshNowToggle() {
+        let label;
+        if (state.view.now === 'today') {
+            label = 'Today';
+        }
+        else if (state.view.now === 'hide') {
+            label = 'None';
+        }
+        else {
+            try {
+                label = new Intl.DateTimeFormat(state.locale, { dateStyle: 'medium' }).format(new Date(`${state.view.now}T00:00:00`));
+            }
+            catch {
+                label = state.view.now;
+            }
+        }
+        els.nowLabel.textContent = label;
+    }
+    // ===== Show-links dropdown =====
+    on(els.linksToggle, 'click', (e) => {
+        e.stopPropagation();
+        const opening = els.linksMenu.hidden;
+        closeSubMenus();
+        if (opening) {
+            els.linksMenu.hidden = false;
+            placeFlyout(els.linksMenu, 'left');
+        }
+    });
+    on(els.linksMenu, 'click', (e) => {
+        e.stopPropagation();
+        const btn = e.target.closest('.links-opt');
+        if (!btn)
+            return;
+        const value = btn.getAttribute('data-value');
+        if (value === null)
+            return;
+        state.view.showLinks = value === 'true';
+        state.view.overridden.showLinks = true;
+        refreshLinksToggle();
+        els.linksMenu.hidden = true;
+        postViewOverrides();
+    });
+    function refreshLinksToggle() {
+        els.linksToggle.textContent = `${state.view.showLinks ? 'Yes' : 'No'} \u25be`;
+        for (const btn of Array.from(els.linksMenu.querySelectorAll('.links-opt'))) {
+            btn.setAttribute('data-active', (btn.getAttribute('data-value') === (state.view.showLinks ? 'true' : 'false')).toString());
+        }
+    }
+    // ===== View-options helpers =====
+    function postViewOverrides() {
+        const overrides = {};
+        if (state.view.overridden.theme)
+            overrides.theme = state.view.theme;
+        if (state.view.overridden.now)
+            overrides.now = state.view.now;
+        if (state.view.overridden.showLinks)
+            overrides.showLinks = state.view.showLinks;
+        options.onViewOptions?.(overrides);
+    }
+    function refreshAll() {
+        refreshThemeToggle();
+        refreshNowToggle();
+        refreshLinksToggle();
+        refreshFormatToggle();
+    }
+    // ===== Theme control visibility =====
+    if (options.themeControl === 'hide') {
+        const themeRow = els.themeMenu.closest('.theme-control-row');
+        if (themeRow)
+            themeRow.style.display = 'none';
+    }
+    // ===== Apply initial theme menu + baselines =====
+    buildThemeMenu(options.availableThemes ?? ['light', 'dark', 'grayscale']);
     if (options.viewBaseline) {
         applyBaseline(state, options.viewBaseline, true);
-        refreshViewMenu();
-    }
-    else {
-        refreshViewMenu();
     }
+    refreshAll();
     updateMinimapVisibility();
+    // Anchor the toolbar explicitly (default: upper-right) so resize
+    // shifts it left rather than the CSS `right` anchor squishing it.
+    repositionChrome();
     // ===== Imperative API =====
     return {
         setSvg,
@@ -635,7 +1112,7 @@ export function mountPreview(rootEl, options = {}) {
         setFatal: showFatal,
         setViewBaseline(baseline, resetOverrides = false) {
             applyBaseline(state, baseline, resetOverrides);
-            refreshViewMenu();
+            refreshAll();
         },
         setDefaultFit(fit) {
             state.defaultFit = fit;
@@ -645,6 +1122,17 @@ export function mountPreview(rootEl, options = {}) {
             state.minimapDismissedThisSession = false;
             updateMinimapVisibility();
         },
+        setMode(mode) {
+            const resolved = mode === 'system' ? resolveSystemMode() : mode;
+            applyMode(resolved);
+        },
+        setAvailableThemes(themes) {
+            buildThemeMenu(themes);
+        },
+        setLocale(locale) {
+            state.locale = locale;
+            refreshNowToggle();
+        },
         fitPage,
         fitWidth,
         actualSize,
@@ -653,15 +1141,19 @@ export function mountPreview(rootEl, options = {}) {
         },
         setZoom(scale) {
             state.activeFit = 'manual';
+            state.isDirty = true;
             setScale(scale);
         },
         dispose() {
             if (fadeTimer)
                 clearTimeout(fadeTimer);
+            if (resizeTimer)
+                clearTimeout(resizeTimer);
             for (const c of cleanups)
                 c();
             cleanups.length = 0;
             rootEl.classList.remove('nl-preview-root');
+            rootEl.removeAttribute('data-nl-mode');
             rootEl.innerHTML = '';
         },
     };
@@ -671,10 +1163,15 @@ function applyBaseline(state, baseline, resetOverrides) {
         state.view.theme = baseline.theme;
     }
     if (baseline.now !== undefined && !state.view.overridden.now) {
-        // Setting is 'auto'/'none'/YYYY-MM-DD; the toolbar only exposes
-        // today/hide, so collapse anything that isn't 'none' to 'today'
-        // for the displayed checkmark.
-        state.view.now = baseline.now === 'none' ? 'hide' : 'today';
+        if (baseline.now === 'none' || baseline.now === 'hide') {
+            state.view.now = 'hide';
+        }
+        else if (typeof baseline.now === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(baseline.now)) {
+            state.view.now = baseline.now;
+        }
+        else {
+            state.view.now = 'today';
+        }
     }
     if (baseline.showLinks !== undefined && !state.view.overridden.showLinks) {
         state.view.showLinks = baseline.showLinks !== false;