@bendyline/docblocks-react 1.0.0 → 1.1.1

package/dist/DocBlocksShell/DocBlocksShell.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * DocBlocksShell — top-level layout component.
  *
@@ -9,15 +9,18 @@ import { useState, useCallback, useEffect, useRef } from 'react';
 import { EditorShell } from '@bendyline/squisq-editor-react';
 import '@bendyline/squisq-editor-react/styles';
 import { MediaContext } from '@bendyline/squisq-react';
-import { createMediaProviderFromContainer } from '@bendyline/squisq/storage';
-import { IndexedDBFileSystemProvider, IndexedDBContentContainer, openNativeFolder, restoreNativeFolder, removeDirectoryHandle, } from '@bendyline/docblocks/filesystem';
+import { DocumentVersionManager, } from '@bendyline/squisq/versions';
+import { IndexedDBFileSystemProvider, ElectronFileSystemProvider, FileSystemContentContainer, createFileMediaProvider, openNativeFolder, restoreNativeFolder, removeDirectoryHandle, } from '@bendyline/docblocks/filesystem';
+import { isElectronHost, getDocBlocksHost } from '@bendyline/docblocks/host';
 import { ensureDefaultWorkspace, getWorkspace, listWorkspaces, removeWorkspace, saveWorkspace, touchWorkspace, } from '@bendyline/docblocks/workspace';
 import { AppMenu } from '../AppMenu/AppMenu.js';
 import { FileExplorer } from '../FileExplorer/FileExplorer.js';
 import { WorkspacePicker } from '../WorkspacePicker/WorkspacePicker.js';
 import { WorkspaceSettingsButton } from '../WorkspacePicker/WorkspaceSettingsButton.js';
+import { WorkspaceSettingsDialog, } from '../WorkspacePicker/WorkspaceSettingsDialog.js';
 import { useAutoSave } from '../hooks/useAutoSave.js';
 import { ExportToolbarControls } from '../Export/ExportToolbarControls.js';
+import { loadVersioningPreference, resolveVersioningEnabled, saveVersioningPreference, } from '../preferences/versioning.js';
 function useOsTheme() {
     const [dark, setDark] = useState(() => typeof window !== 'undefined' && window.matchMedia('(prefers-color-scheme: dark)').matches);
     useEffect(() => {
@@ -50,6 +53,204 @@ function parseHash() {
         filePath: '/' + decodeURIComponent(raw.slice(slashIdx + 1)),
     };
 }
+const LAST_STATE_KEY = 'docblocks:lastState';
+function saveLastState(state) {
+    try {
+        localStorage.setItem(LAST_STATE_KEY, JSON.stringify(state));
+    }
+    catch {
+        // ignore quota errors
+    }
+}
+function loadLastState() {
+    try {
+        const raw = localStorage.getItem(LAST_STATE_KEY);
+        if (!raw)
+            return null;
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+const THEME_PREF_KEY = 'docblocks:themePreference';
+function loadThemePreference() {
+    try {
+        const raw = localStorage.getItem(THEME_PREF_KEY);
+        if (raw === 'light' || raw === 'dark' || raw === 'auto')
+            return raw;
+    }
+    catch {
+        // ignore
+    }
+    return 'auto';
+}
+function saveThemePreference(pref) {
+    try {
+        localStorage.setItem(THEME_PREF_KEY, pref);
+    }
+    catch {
+        // ignore quota errors
+    }
+}
+const SIDEBAR_WIDTH_KEY = 'docblocks:sidebarWidth';
+const SIDEBAR_WIDTH_DEFAULT = 260;
+const SIDEBAR_WIDTH_MIN = 180;
+const SIDEBAR_WIDTH_MAX = 600;
+/** Drag below this many pixels and the sidebar collapses entirely —
+ *  the editor takes the full width and a back-arrow appears in the
+ *  toolbar so the user can pop the sidebar back open. Same UX as
+ *  the existing mobile narrow-viewport flow. */
+const SIDEBAR_COLLAPSE_THRESHOLD = 120;
+function loadSidebarWidth() {
+    try {
+        const raw = localStorage.getItem(SIDEBAR_WIDTH_KEY);
+        if (raw === null)
+            return SIDEBAR_WIDTH_DEFAULT;
+        const n = Number(raw);
+        if (!Number.isFinite(n))
+            return SIDEBAR_WIDTH_DEFAULT;
+        return Math.min(SIDEBAR_WIDTH_MAX, Math.max(SIDEBAR_WIDTH_MIN, n));
+    }
+    catch {
+        return SIDEBAR_WIDTH_DEFAULT;
+    }
+}
+function saveSidebarWidth(px) {
+    try {
+        localStorage.setItem(SIDEBAR_WIDTH_KEY, String(Math.round(px)));
+    }
+    catch {
+        // ignore quota errors
+    }
+}
+const VIEW_PREFS_KEY = 'docblocks:viewPreferences';
+const DEFAULT_VIEW_PREFS = {
+    outline: false,
+    inlinePreview: true,
+    showStatusBar: true,
+};
+function loadViewPreferences() {
+    try {
+        const raw = localStorage.getItem(VIEW_PREFS_KEY);
+        if (!raw)
+            return DEFAULT_VIEW_PREFS;
+        const parsed = JSON.parse(raw);
+        return {
+            outline: typeof parsed.outline === 'boolean' ? parsed.outline : DEFAULT_VIEW_PREFS.outline,
+            inlinePreview: typeof parsed.inlinePreview === 'boolean'
+                ? parsed.inlinePreview
+                : DEFAULT_VIEW_PREFS.inlinePreview,
+            showStatusBar: typeof parsed.showStatusBar === 'boolean'
+                ? parsed.showStatusBar
+                : DEFAULT_VIEW_PREFS.showStatusBar,
+        };
+    }
+    catch {
+        return DEFAULT_VIEW_PREFS;
+    }
+}
+function saveViewPreferences(prefs) {
+    try {
+        localStorage.setItem(VIEW_PREFS_KEY, JSON.stringify(prefs));
+    }
+    catch {
+        // ignore quota errors
+    }
+}
+function dirnameOf(p) {
+    const clean = p.replace(/^\/+/, '');
+    const idx = clean.lastIndexOf('/');
+    return idx === -1 ? '' : clean.slice(0, idx);
+}
+function basenameOf(p) {
+    const clean = p.replace(/^\/+/, '');
+    const idx = clean.lastIndexOf('/');
+    return idx === -1 ? clean : clean.slice(idx + 1);
+}
+/** Strip the extension from a filename (`notes.md` -> `notes`). Matches
+ *  squisq's `getDocBasename` convention so version snapshot filenames
+ *  stay readable (`<basename>.<timestamp>.md`). */
+function stripExtension(name) {
+    return name.replace(/\.[^.]+$/, '');
+}
+function normaliseProviderPath(p) {
+    return '/' + p.replace(/^\/+/, '');
+}
+function sameProviderPath(a, b) {
+    return normaliseProviderPath(a) === normaliseProviderPath(b);
+}
+/** Portable relative link from one workspace file to another. Walks up
+ *  from the source's directory and back down to the target so the link
+ *  survives folder reshuffles (`../sibling.md`, `subfolder/child.md`,
+ *  `resume.md` for siblings at the workspace root). */
+function relativeMarkdownLink(fromFile, toFile) {
+    const fromParts = fromFile.replace(/^\/+/, '').split('/').filter(Boolean);
+    const toParts = toFile.replace(/^\/+/, '').split('/').filter(Boolean);
+    const fromDir = fromParts.slice(0, -1);
+    const toDir = toParts.slice(0, -1);
+    const toBase = toParts[toParts.length - 1] ?? '';
+    let common = 0;
+    while (common < fromDir.length && common < toDir.length && fromDir[common] === toDir[common]) {
+        common++;
+    }
+    const ups = fromDir.length - common;
+    const downs = [...toDir.slice(common), toBase];
+    const parts = [...Array(ups).fill('..'), ...downs];
+    return parts.length === 0 ? toBase : parts.join('/');
+}
+/** Recursively collect all `.md` files reachable from `root`. Skips
+ *  Word-style `*_files/` asset companions, dotfiles, and `node_modules`
+ *  so the candidate list stays workspace-meaningful. */
+async function collectMarkdownFiles(fs, root) {
+    const out = [];
+    const visited = new Set();
+    async function walk(dir) {
+        if (visited.has(dir))
+            return;
+        visited.add(dir);
+        let entries;
+        try {
+            entries = await fs.readDirectory(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.kind === 'directory') {
+                const lower = entry.name.toLowerCase();
+                if (lower.startsWith('.'))
+                    continue;
+                if (lower === 'node_modules')
+                    continue;
+                if (lower.endsWith('_files'))
+                    continue;
+                await walk(entry.path);
+            }
+            else if (entry.kind === 'file') {
+                if (entry.name.toLowerCase().endsWith('.md'))
+                    out.push(entry);
+            }
+        }
+    }
+    await walk(root);
+    return out;
+}
+async function createElectronProviderFromWorkspace(ws) {
+    if (!ws.rootPath)
+        return null;
+    try {
+        await getDocBlocksHost().workspaces.register({
+            id: ws.id,
+            name: ws.name,
+            rootPath: ws.rootPath,
+        });
+    }
+    catch {
+        return null;
+    }
+    return new ElectronFileSystemProvider(ws.id, ws.name, ws.rootPath);
+}
 function useIsMobile(breakpoint = 768) {
     const [isMobile, setIsMobile] = useState(() => typeof window !== 'undefined' && window.matchMedia(`(max-width: ${breakpoint}px)`).matches);
     useEffect(() => {
@@ -60,13 +261,148 @@ function useIsMobile(breakpoint = 768) {
     }, [breakpoint]);
     return isMobile;
 }
-export function DocBlocksShell({ theme = 'auto', logoUrl }) {
+function FolderGlyph() {
+    return (_jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M3 7a1 1 0 0 1 1-1h5l2 2h9a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7z" }) }));
+}
+function FileGlyph() {
+    return (_jsxs("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M6 3h8l5 5v12a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z" }), _jsx("path", { d: "M14 3v5h5" })] }));
+}
+export function DocBlocksShell({ theme: _themeProp = 'auto', logoUrl, allowVersioning = true, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, versioningRef, }) {
     const osTheme = useOsTheme();
-    const resolvedTheme = theme === 'auto' ? osTheme : theme;
+    const [themePreference, setThemePreference] = useState(loadThemePreference);
+    // "System default" (auto) always follows the OS — the host's theme prop
+    // is kept only for API back-compat and does not override OS detection.
+    const resolvedTheme = themePreference === 'light' || themePreference === 'dark' ? themePreference : osTheme;
+    const handleThemeChange = useCallback((pref) => {
+        setThemePreference(pref);
+        saveThemePreference(pref);
+    }, []);
+    const [viewPreferences, setViewPreferences] = useState(loadViewPreferences);
+    const handleViewPreferencesChange = useCallback((prefs) => {
+        setViewPreferences(prefs);
+        saveViewPreferences(prefs);
+    }, []);
     const isMobile = useIsMobile();
     const [mobileShowEditor, setMobileShowEditor] = useState(false);
+    // Sidebar width — persisted across sessions, dragged via the resizer
+    // between sidebar and editor area. We track the "live" width during a
+    // drag in a ref so each mousemove doesn't trigger a state update; only
+    // setState on commit so React doesn't churn through every pixel.
+    const [sidebarWidth, setSidebarWidth] = useState(loadSidebarWidth);
+    // When the user drags the resizer below SIDEBAR_COLLAPSE_THRESHOLD,
+    // we switch the layout into single-pane "compact" mode — same UX as
+    // the mobile narrow-viewport flow, where only the sidebar OR the
+    // editor is visible at a time and a back-arrow in the toolbar pops
+    // between them. A "Restore split view" button on the editor toolbar
+    // exits compact mode; on real mobile that button is suppressed
+    // because there's not enough viewport for side-by-side. Not
+    // persisted across reloads. */
+    const [compactLayout, setCompactLayout] = useState(false);
+    const effectiveCompact = isMobile || compactLayout;
+    const sidebarRef = useRef(null);
+    const dragStateRef = useRef(null);
+    const handleResizerPointerDown = useCallback((e) => {
+        if (e.button !== 0)
+            return;
+        dragStateRef.current = { startX: e.clientX, startWidth: sidebarWidth };
+        e.preventDefault();
+        // Disable text selection + flip the body cursor for the duration
+        // of the drag so the col-resize cursor stays visible even when the
+        // pointer slips off the 7px hit area. The custom cursor lives in
+        // the CSS class so Windows' white-cursor preference doesn't make
+        // the dragging cursor invisible against the light chrome.
+        document.body.style.userSelect = 'none';
+        document.body.classList.add('db-resizing-sidebar');
+        let lastRaw = sidebarWidth;
+        const onMove = (ev) => {
+            const drag = dragStateRef.current;
+            if (!drag)
+                return;
+            lastRaw = drag.startWidth + (ev.clientX - drag.startX);
+            if (lastRaw < SIDEBAR_COLLAPSE_THRESHOLD && sidebarRef.current) {
+                // Below threshold — preview the collapse by snapping to the
+                // minimum width and fading the sidebar, so the user can see
+                // they've crossed into "release to collapse" territory.
+                sidebarRef.current.style.width = `${SIDEBAR_WIDTH_MIN}px`;
+                sidebarRef.current.style.opacity = '0.45';
+                return;
+            }
+            const clamped = Math.min(SIDEBAR_WIDTH_MAX, Math.max(SIDEBAR_WIDTH_MIN, lastRaw));
+            if (sidebarRef.current) {
+                // Update the DOM directly during the drag for jank-free
+                // dragging; React state syncs on release.
+                sidebarRef.current.style.width = `${clamped}px`;
+                sidebarRef.current.style.opacity = '';
+            }
+        };
+        const onUp = () => {
+            document.removeEventListener('pointermove', onMove);
+            document.removeEventListener('pointerup', onUp);
+            document.body.style.userSelect = '';
+            document.body.classList.remove('db-resizing-sidebar');
+            if (sidebarRef.current) {
+                sidebarRef.current.style.opacity = '';
+            }
+            if (lastRaw < SIDEBAR_COLLAPSE_THRESHOLD) {
+                // Released below threshold — switch to compact (single-pane)
+                // layout focused on the editor. Keep the persisted
+                // sidebarWidth so exiting compact mode restores it.
+                setCompactLayout(true);
+                setMobileShowEditor(true);
+            }
+            else {
+                const finalWidth = sidebarRef.current?.getBoundingClientRect().width;
+                if (finalWidth) {
+                    const clamped = Math.min(SIDEBAR_WIDTH_MAX, Math.max(SIDEBAR_WIDTH_MIN, Math.round(finalWidth)));
+                    setSidebarWidth(clamped);
+                    saveSidebarWidth(clamped);
+                }
+            }
+            dragStateRef.current = null;
+        };
+        document.addEventListener('pointermove', onMove);
+        document.addEventListener('pointerup', onUp);
+    }, [sidebarWidth]);
     const [provider, setProvider] = useState(null);
     const [activeWorkspaceId, setActiveWorkspaceId] = useState(null);
+    const [activeWorkspaceDescriptor, setActiveWorkspaceDescriptor] = useState(null);
+    // Re-fetch the descriptor whenever the active id (or its versioning
+    // override) changes. `descriptorRefreshKey` is bumped after writes so
+    // the resolver picks up the updated override without remounting.
+    const [descriptorRefreshKey, setDescriptorRefreshKey] = useState(0);
+    useEffect(() => {
+        let cancelled = false;
+        if (!activeWorkspaceId) {
+            setActiveWorkspaceDescriptor(null);
+            return;
+        }
+        void getWorkspace(activeWorkspaceId).then((ws) => {
+            if (!cancelled)
+                setActiveWorkspaceDescriptor(ws);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [activeWorkspaceId, descriptorRefreshKey]);
+    const [workspaceSettingsOpen, setWorkspaceSettingsOpen] = useState(false);
+    const [versioningPreference, setVersioningPreference] = useState(loadVersioningPreference);
+    const handleVersioningPreferenceChange = useCallback((pref) => {
+        setVersioningPreference(pref);
+        saveVersioningPreference(pref);
+    }, []);
+    const effectiveVersioning = allowVersioning && resolveVersioningEnabled(activeWorkspaceDescriptor, versioningPreference);
+    const handleOpenWorkspaceSettings = useCallback(() => {
+        if (!activeWorkspaceDescriptor)
+            return;
+        setWorkspaceSettingsOpen(true);
+    }, [activeWorkspaceDescriptor]);
+    const handleWorkspaceVersioningOverrideChange = useCallback(async (override) => {
+        if (!activeWorkspaceDescriptor)
+            return;
+        await saveWorkspace({ ...activeWorkspaceDescriptor, versioningOverride: override });
+        setDescriptorRefreshKey((k) => k + 1);
+        setWorkspaceSettingsOpen(false);
+    }, [activeWorkspaceDescriptor]);
     const [selectedFile, setSelectedFile] = useState(null);
     const [selectedFolder, setSelectedFolder] = useState(null);
     const [folderEntries, setFolderEntries] = useState([]);
@@ -76,15 +412,31 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
     const [initialView, setInitialView] = useState('wysiwyg');
     /** Suppress popstate handling during programmatic navigation. */
     const skipPopState = useRef(false);
-    /** Persistent media container backed by IndexedDB (survives page refresh). */
+    const lastLocalSaveRef = useRef(null);
+    /**
+     * Per-file media container: for `notes.md`, images live in
+     * `notes_files/` next to the markdown. Created lazily on first write,
+     * picked up automatically if it already exists. Set up by the effect
+     * below whenever the selected file (or backing provider) changes.
+     */
     const mediaContainerRef = useRef(null);
     const [mediaProvider, setMediaProvider] = useState(null);
-    /** Set up persistent media container for a workspace. */
-    const setupMediaContainer = useCallback((workspaceId) => {
-        const mc = new IndexedDBContentContainer(workspaceId);
-        mediaContainerRef.current = mc;
-        setMediaProvider(createMediaProviderFromContainer(mc));
-    }, []);
+    /**
+     * Per-document container scoped to `<basename>_files/`. This is what
+     * the editor uses for version history (`.versions/` lives here) and
+     * for audio mapping (MP3 / timing.json discovery). Distinct from
+     * `mediaContainerRef` which is scoped to the parent directory so the
+     * media provider can write `notes_files/image.png` paths that stay
+     * portable in the markdown.
+     */
+    const versionsContainerRef = useRef(null);
+    const [versionsContainer, setVersionsContainer] = useState(null);
+    /** Cache of .md files in the active workspace, used to power the
+     *  squisq link-dialog's document picker. Lazily populated on first
+     *  provider call; cleared whenever the backing filesystem changes so
+     *  workspace switches don't surface stale neighbours. A pending Promise
+     *  during in-flight walks lets concurrent calls share the same scan. */
+    const mdFileCacheRef = useRef(null);
     /** Push a new history entry with the given hash. */
     const pushHash = useCallback((wsId, filePath) => {
         const hash = buildHash(wsId, filePath);
@@ -93,17 +445,23 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
             window.history.pushState(null, '', hash);
         }
     }, []);
-    /** Open a workspace (and optionally a file) from identifiers. */
-    const openFromIds = useCallback(async (wsId, filePath, push) => {
+    /** Open a workspace (and optionally a file) from identifiers.
+     *  Returns the FileSystemProvider on success, or null on failure. */
+    const openFromIds = useCallback(async (wsId, filePath, push, view) => {
         const workspaces = await listWorkspaces();
         const ws = workspaces.find((w) => w.id === wsId);
         if (!ws)
-            return false;
+            return null;
         let fsProvider = null;
-        if (ws.type === 'native') {
+        if (ws.type === 'electron-native') {
+            fsProvider = await createElectronProviderFromWorkspace(ws);
+            if (!fsProvider)
+                return null;
+        }
+        else if (ws.type === 'native') {
             const restored = await restoreNativeFolder(ws.id);
             if (!restored)
-                return false;
+                return null;
             fsProvider = restored;
         }
         else {
@@ -112,7 +470,6 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
         await touchWorkspace(ws.id);
         setProvider(fsProvider);
         setActiveWorkspaceId(ws.id);
-        setupMediaContainer(ws.id);
         if (filePath) {
             const content = await fsProvider.readFile(filePath);
             if (content !== null) {
@@ -120,8 +477,10 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
                 setSelectedFolder(null);
                 setFolderEntries([]);
                 setEditorContent(content);
-                setInitialView('wysiwyg');
+                const effectiveView = view ?? 'wysiwyg';
+                setInitialView(effectiveView);
                 setEditorKey((k) => k + 1);
+                saveLastState({ workspaceId: wsId, filePath, view: effectiveView });
             }
             else {
                 setSelectedFile(null);
@@ -141,41 +500,45 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
         if (push) {
             pushHash(ws.id, filePath);
         }
-        return true;
-    }, [pushHash, setupMediaContainer]);
+        return fsProvider;
+    }, [pushHash]);
     const seedWelcomeFile = useCallback(async (fs) => {
         const entries = await fs.readDirectory('/');
-        // If the only file is the welcome doc, auto-select it
+        // If the only file is the welcome doc, auto-select it.
+        // Match either casing so workspaces seeded before the rename
+        // (aboutDocblocks.md) keep working alongside new ones (aboutDocBlocks.md).
         if (entries.length === 1 &&
             entries[0].kind === 'file' &&
-            entries[0].path === '/aboutDocblocks.md') {
-            const content = await fs.readFile('/aboutDocblocks.md');
+            entries[0].path.replace(/^\//, '').toLowerCase() === 'aboutdocblocks.md') {
+            const aboutPath = entries[0].path;
+            const content = await fs.readFile(aboutPath);
             if (content !== null) {
-                setSelectedFile('/aboutDocblocks.md');
+                setSelectedFile(aboutPath);
                 setEditorContent(content);
                 setInitialView('preview');
                 setEditorKey((k) => k + 1);
                 setExplorerKey((k) => k + 1);
-                pushHash(fs.id, '/aboutDocblocks.md');
+                pushHash(fs.id, aboutPath);
+                saveLastState({ workspaceId: fs.id, filePath: aboutPath, view: 'preview' });
             }
             return;
         }
         if (entries.length > 0)
             return;
-        const welcomePath = '/aboutDocblocks.md';
+        const welcomePath = '/aboutDocBlocks.md';
         const welcomeContent = [
             '# Welcome to DocBlocks',
             '',
-            'DocBlocks is a browser-based markdown document editor that lets you create, organize, and manage your documents right in the browser.',
+            'DocBlocks is a free browser-based markdown document editor that lets you create, organize, and manage your documents right in the browser. What you write here can become a Word or PDF doc, a slide deck, an e-book, or a video.',
+            '',
+            'Simple to write. Beautiful wherever it goes.',
             '',
             '## Features',
             '',
-            '- **Rich Markdown Editing** — Write in a visual editor or switch to raw markdown anytime',
-            '- **Workspaces** — Organize your documents into separate workspaces',
+            '- **Rich Markdown Editing** — Write in a visual editor or switch to raw markdown anytime. Use section annotations to change the visualization for blocks of content.',
+            '- **Workspaces** — Organize your documents into separate workspaces in the browser or on your device.',
+            '- **Useful Everywhere** — Your content is usable across multiple formats — Microsoft Word .docx, PowerPoint, PDF, HTML, EPUB e-books, and Markdown.',
             '- **Playback & Video** — Preview your documents as rich visual presentations and export them as MP4 video',
-            '- **Export Anywhere** — Export documents to PDF, Word, PowerPoint, HTML, or Markdown with theme options',
-            '- **Local Storage** — Your documents are stored in your browser using temporary browser storage (backup often!)',
-            '- **Device Folders** — Create workspaces based on folders on your computer',
             '- **No BS** — Free, no ads, no accounts, no tracking - everything runs locally in your browser',
             '',
             '## Getting Started',
@@ -184,7 +547,7 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
             '2. Start writing in markdown — the editor supports headings, lists, links, images, and more',
             '3. Your work is saved automatically',
             '',
-            'Built with [Squiggly Square](https://github.com/nicoth-in/squisq) by [Bendyline](https://bendyline.com).',
+            'Built with [Squiggly Square](https://github.com/bendyline/squisq) by [Bendyline](https://bendyline.com).',
         ].join('\n');
         await fs.writeFile(welcomePath, welcomeContent);
         setSelectedFile(welcomePath);
@@ -193,6 +556,7 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
         setEditorKey((k) => k + 1);
         setExplorerKey((k) => k + 1);
         pushHash(fs.id, welcomePath);
+        saveLastState({ workspaceId: fs.id, filePath: welcomePath, view: 'preview' });
     }, [pushHash]);
     // Initialise workspace on mount — restore from hash or last-used
     useEffect(() => {
@@ -200,23 +564,50 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
             // Try restoring from URL hash first
             const hashState = parseHash();
             if (hashState) {
-                const ok = await openFromIds(hashState.workspaceId, hashState.filePath, false);
-                if (ok)
+                const restoredProvider = await openFromIds(hashState.workspaceId, hashState.filePath, false);
+                if (restoredProvider) {
+                    // If the hash had no file, check whether we should auto-select the welcome doc
+                    if (!hashState.filePath) {
+                        await seedWelcomeFile(restoredProvider);
+                    }
+                    return;
+                }
+            }
+            // Try restoring last viewed document from localStorage
+            const lastState = loadLastState();
+            if (lastState) {
+                const restoredProvider = await openFromIds(lastState.workspaceId, lastState.filePath, true, lastState.view);
+                if (restoredProvider)
                     return;
             }
             let fsProvider = null;
+            const electron = isElectronHost();
             const workspaces = await listWorkspaces();
+            // On desktop, hide web-only workspaces (indexeddb/native) — only
+            // folder-based workspaces are valid.
+            const candidates = electron
+                ? workspaces.filter((w) => w.type === 'electron-native')
+                : workspaces.filter((w) => w.type !== 'electron-native');
             // Pick the most recently opened workspace
-            const sorted = [...workspaces].sort((a, b) => (b.lastOpened ?? '').localeCompare(a.lastOpened ?? ''));
+            const sorted = [...candidates].sort((a, b) => (b.lastOpened ?? '').localeCompare(a.lastOpened ?? ''));
             for (const ws of sorted) {
-                if (ws.type === 'native') {
+                if (ws.type === 'electron-native') {
+                    const p = await createElectronProviderFromWorkspace(ws);
+                    if (!p)
+                        continue;
+                    await touchWorkspace(ws.id);
+                    fsProvider = p;
+                    setProvider(p);
+                    setActiveWorkspaceId(ws.id);
+                    break;
+                }
+                else if (ws.type === 'native') {
                     const restored = await restoreNativeFolder(ws.id);
                     if (restored) {
                         await touchWorkspace(ws.id);
                         fsProvider = restored;
                         setProvider(restored);
                         setActiveWorkspaceId(ws.id);
-                        setupMediaContainer(ws.id);
                         break;
                     }
                 }
@@ -226,25 +617,42 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
                     fsProvider = p;
                     setProvider(p);
                     setActiveWorkspaceId(ws.id);
-                    setupMediaContainer(ws.id);
                     break;
                 }
             }
             if (!fsProvider) {
-                // No workspaces yet — create default
-                const defaultWs = await ensureDefaultWorkspace();
-                const p = new IndexedDBFileSystemProvider(defaultWs.id, defaultWs.name);
-                fsProvider = p;
-                setProvider(p);
-                setActiveWorkspaceId(defaultWs.id);
-                setupMediaContainer(defaultWs.id);
+                if (electron) {
+                    // Desktop: ask the host for the default folder workspace
+                    // (creates ~/Documents/DocBlocks on first launch).
+                    const info = await getDocBlocksHost().workspaces.getDefault();
+                    const descriptor = {
+                        id: info.id,
+                        name: info.name,
+                        type: 'electron-native',
+                        rootPath: info.rootPath,
+                        lastOpened: new Date().toISOString(),
+                    };
+                    await saveWorkspace(descriptor);
+                    const p = new ElectronFileSystemProvider(info.id, info.name, info.rootPath);
+                    fsProvider = p;
+                    setProvider(p);
+                    setActiveWorkspaceId(info.id);
+                }
+                else {
+                    // Web: create the IndexedDB default workspace
+                    const defaultWs = await ensureDefaultWorkspace();
+                    const p = new IndexedDBFileSystemProvider(defaultWs.id, defaultWs.name);
+                    fsProvider = p;
+                    setProvider(p);
+                    setActiveWorkspaceId(defaultWs.id);
+                }
             }
             // Set initial hash
             pushHash(fsProvider.id, null);
             // Seed welcome file if workspace is empty
             await seedWelcomeFile(fsProvider);
         })();
-    }, [openFromIds, pushHash, seedWelcomeFile, setupMediaContainer]);
+    }, [openFromIds, pushHash, seedWelcomeFile]);
     // Handle browser back/forward
     useEffect(() => {
         const onPopState = () => {
@@ -260,23 +668,191 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
         window.addEventListener('popstate', onPopState);
         return () => window.removeEventListener('popstate', onPopState);
     }, [openFromIds]);
-    // Auto-save current file
-    useAutoSave(provider, selectedFile, editorContent);
+    // Track view mode changes (Editor/Raw/Play tabs) and persist to localStorage
+    useEffect(() => {
+        const handler = (e) => {
+            const target = e.target.closest?.('[data-view]');
+            if (target) {
+                const view = target.getAttribute('data-view');
+                if (view && activeWorkspaceId && selectedFile) {
+                    saveLastState({ workspaceId: activeWorkspaceId, filePath: selectedFile, view });
+                }
+            }
+        };
+        window.addEventListener('click', handler, true);
+        return () => window.removeEventListener('click', handler, true);
+    }, [activeWorkspaceId, selectedFile]);
+    const handleAutoSaved = useCallback((filePath, savedContent) => {
+        lastLocalSaveRef.current = {
+            filePath: normaliseProviderPath(filePath),
+            content: savedContent,
+            savedAt: Date.now(),
+        };
+    }, []);
+    // Auto-save current file. The returned `flush` is called from the
+    // Ctrl/Cmd+S handler below so the user gets immediate confirmation.
+    const { flush: flushAutoSave } = useAutoSave(provider, selectedFile, editorContent, 500, handleAutoSaved);
+    // Comfort-blanket Ctrl/Cmd+S: flushes any pending autosave and pops a
+    // small "auto-save confirmed" toast. Files are already saved on every
+    // keystroke (debounced) — this is purely UX reassurance for users who
+    // muscle-memory hit Save.
+    const [saveToastVisible, setSaveToastVisible] = useState(false);
+    const saveToastTimerRef = useRef(null);
+    useEffect(() => {
+        const onKey = (e) => {
+            const sKey = e.key === 's' || e.key === 'S';
+            const accel = e.ctrlKey || e.metaKey;
+            if (!sKey || !accel || e.altKey)
+                return;
+            e.preventDefault();
+            e.stopPropagation();
+            void flushAutoSave().catch(() => undefined);
+            setSaveToastVisible(true);
+            if (saveToastTimerRef.current)
+                clearTimeout(saveToastTimerRef.current);
+            saveToastTimerRef.current = setTimeout(() => setSaveToastVisible(false), 1800);
+        };
+        window.addEventListener('keydown', onKey, true);
+        return () => window.removeEventListener('keydown', onKey, true);
+    }, [flushAutoSave]);
+    useEffect(() => {
+        return () => {
+            if (saveToastTimerRef.current)
+                clearTimeout(saveToastTimerRef.current);
+        };
+    }, []);
+    // Per-file media: for `notes.md` images live in `notes_files/` beside it.
+    // Rebuilds whenever the provider or selected file changes.
+    useEffect(() => {
+        if (!provider || !selectedFile) {
+            mediaContainerRef.current = null;
+            versionsContainerRef.current = null;
+            setMediaProvider(null);
+            setVersionsContainer(null);
+            return;
+        }
+        const parentDir = dirnameOf(selectedFile);
+        const base = basenameOf(selectedFile);
+        const baseNoExt = base.replace(/\.[^.]+$/, '');
+        const container = new FileSystemContentContainer(provider, parentDir);
+        const vPrefix = parentDir ? `${parentDir}/${baseNoExt}_files` : `${baseNoExt}_files`;
+        const vContainer = new FileSystemContentContainer(provider, vPrefix);
+        const mp = createFileMediaProvider(container, base);
+        mediaContainerRef.current = container;
+        versionsContainerRef.current = vContainer;
+        setMediaProvider(mp);
+        setVersionsContainer(vContainer);
+        return () => {
+            mp.dispose();
+        };
+    }, [provider, selectedFile]);
+    // Invalidate the document-link candidate cache when the backing
+    // workspace changes — otherwise the link dialog would surface
+    // neighbours from a previously-open workspace.
+    useEffect(() => {
+        mdFileCacheRef.current = null;
+    }, [provider]);
+    /** Powers the squisq link dialog's "Browse documents" picker. Returns
+     *  workspace `.md` neighbours filtered by `query`, with paths expressed
+     *  relative to the currently-open document so the link survives folder
+     *  moves. The first call seeds an in-memory cache; subsequent calls
+     *  filter against it. */
+    const documentLinkProvider = useCallback(async (query) => {
+        if (!provider || !selectedFile)
+            return [];
+        if (!mdFileCacheRef.current) {
+            mdFileCacheRef.current = collectMarkdownFiles(provider, '').catch(() => []);
+        }
+        const entries = await mdFileCacheRef.current;
+        const q = query.trim().toLowerCase();
+        const candidates = [];
+        for (const entry of entries) {
+            if (entry.kind !== 'file')
+                continue;
+            if (sameProviderPath(entry.path, selectedFile))
+                continue;
+            const label = entry.name.replace(/\.md$/i, '');
+            const path = relativeMarkdownLink(selectedFile, entry.path);
+            if (q && !label.toLowerCase().includes(q) && !path.toLowerCase().includes(q))
+                continue;
+            const dir = dirnameOf(entry.path);
+            candidates.push(dir ? { path, label, description: dir } : { path, label });
+        }
+        // Stable alphabetical order keeps the picker predictable across
+        // re-opens; the dialog can re-sort or rank on its own if needed.
+        candidates.sort((a, b) => a.label.localeCompare(b.label));
+        return candidates;
+    }, [provider, selectedFile]);
+    // Expose a DocumentVersionManager via versioningRef when requested.
+    useEffect(() => {
+        const ref = versioningRef;
+        if (!ref)
+            return;
+        const assign = (mgr) => {
+            if (typeof ref === 'function')
+                ref(mgr);
+            else
+                ref.current = mgr;
+        };
+        if (!effectiveVersioning || !versionsContainer || !selectedFile) {
+            assign(null);
+            return;
+        }
+        const base = stripExtension(basenameOf(selectedFile));
+        const mgr = new DocumentVersionManager(versionsContainer, {
+            basename: versionBasename ?? base,
+        });
+        assign(mgr);
+        return () => assign(null);
+    }, [versioningRef, effectiveVersioning, versionBasename, selectedFile, versionsContainer]);
+    // React to external file changes watched by the Electron host (chokidar).
+    useEffect(() => {
+        if (!isElectronHost())
+            return;
+        if (!provider || !(provider instanceof ElectronFileSystemProvider))
+            return;
+        const unwatch = provider.watch((changedPath) => {
+            setExplorerKey((k) => k + 1);
+            if (!selectedFile || !sameProviderPath(changedPath, selectedFile))
+                return;
+            // If the open file's contents changed on disk, reload it (best-effort).
+            (async () => {
+                const content = await provider.readFile(selectedFile);
+                if (content === null || content === editorContent)
+                    return;
+                const localSave = lastLocalSaveRef.current;
+                if (localSave &&
+                    sameProviderPath(localSave.filePath, selectedFile) &&
+                    localSave.content === content &&
+                    Date.now() - localSave.savedAt < 5000) {
+                    return;
+                }
+                setEditorContent(content);
+                setEditorKey((k) => k + 1);
+            })();
+        });
+        return unwatch;
+    }, [provider, selectedFile, editorContent]);
     const handleWorkspaceSelect = useCallback(async (ws) => {
         await touchWorkspace(ws.id);
-        if (ws.type === 'native') {
+        let nextProvider = null;
+        if (ws.type === 'electron-native') {
+            nextProvider = await createElectronProviderFromWorkspace(ws);
+            if (!nextProvider)
+                return;
+        }
+        else if (ws.type === 'native') {
             const restored = await restoreNativeFolder(ws.id);
-            if (restored) {
-                setProvider(restored);
-            }
-            else {
+            if (!restored) {
                 // Permission denied or handle lost — fall through without changing provider
                 return;
             }
+            nextProvider = restored;
         }
         else {
-            setProvider(new IndexedDBFileSystemProvider(ws.id, ws.name));
+            nextProvider = new IndexedDBFileSystemProvider(ws.id, ws.name);
         }
+        setProvider(nextProvider);
         setActiveWorkspaceId(ws.id);
         setSelectedFile(null);
         setSelectedFolder(null);
@@ -284,10 +860,32 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
         setEditorContent('');
         setEditorKey((k) => k + 1);
         pushHash(ws.id, null);
-        setupMediaContainer(ws.id);
-    }, [pushHash, setupMediaContainer]);
+    }, [pushHash]);
     const handleOpenFolder = useCallback(async () => {
         try {
+            if (isElectronHost()) {
+                const info = await getDocBlocksHost().workspaces.pickFolder();
+                if (!info)
+                    return; // user cancelled
+                const descriptor = {
+                    id: info.id,
+                    name: info.name,
+                    type: 'electron-native',
+                    rootPath: info.rootPath,
+                    lastOpened: new Date().toISOString(),
+                };
+                await saveWorkspace(descriptor);
+                const provider = new ElectronFileSystemProvider(info.id, info.name, info.rootPath);
+                setProvider(provider);
+                setActiveWorkspaceId(descriptor.id);
+                setSelectedFile(null);
+                setSelectedFolder(null);
+                setFolderEntries([]);
+                setEditorContent('');
+                setEditorKey((k) => k + 1);
+                pushHash(descriptor.id, null);
+                return;
+            }
             const nativeProvider = await openNativeFolder();
             const descriptor = {
                 id: nativeProvider.id,
@@ -304,12 +902,104 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
             setEditorContent('');
             setEditorKey((k) => k + 1);
             pushHash(descriptor.id, null);
-            setupMediaContainer(descriptor.id);
         }
         catch {
             // User cancelled or API not supported
         }
-    }, [pushHash, setupMediaContainer]);
+    }, [pushHash]);
+    const handleNewFile = useCallback(async () => {
+        if (!provider)
+            return;
+        const name = prompt('New document name:', 'Untitled.md');
+        if (!name)
+            return;
+        const filename = /\.[a-zA-Z0-9]+$/.test(name) ? name : `${name}.md`;
+        await provider.writeFile(filename, '# ' + filename.replace(/\.[^.]+$/, '') + '\n');
+        setSelectedFile('/' + filename);
+        setEditorContent('# ' + filename.replace(/\.[^.]+$/, '') + '\n');
+        setInitialView('wysiwyg');
+        setEditorKey((k) => k + 1);
+        setExplorerKey((k) => k + 1);
+        if (activeWorkspaceId) {
+            pushHash(activeWorkspaceId, '/' + filename);
+        }
+    }, [provider, activeWorkspaceId, pushHash]);
+    const handleRevealWorkspace = useCallback(async () => {
+        if (!isElectronHost() || !activeWorkspaceId)
+            return;
+        const ws = await getWorkspace(activeWorkspaceId);
+        if (ws?.type === 'electron-native' && ws.rootPath) {
+            await getDocBlocksHost().shell.revealInFolder(ws.rootPath);
+        }
+    }, [activeWorkspaceId]);
+    // Subscribe to native menu commands (Electron host).
+    useEffect(() => {
+        if (!isElectronHost())
+            return;
+        const host = getDocBlocksHost();
+        return host.onMenuCommand((cmd) => {
+            switch (cmd) {
+                case 'file:new':
+                    handleNewFile();
+                    break;
+                case 'file:openFolder':
+                    handleOpenFolder();
+                    break;
+                case 'file:revealWorkspace':
+                    handleRevealWorkspace();
+                    break;
+                case 'help:viewOnGitHub':
+                    host.shell.openExternal('https://github.com/bendyline/docblocks');
+                    break;
+                case 'help:checkForUpdates':
+                    host.updater.checkForUpdates().catch(() => {
+                        // errors surface via updater.onStatus
+                    });
+                    break;
+                case 'help:about':
+                    (async () => {
+                        const version = await host.updater.getVersion();
+                        alert(`DocBlocks ${version}`);
+                    })();
+                    break;
+                default:
+                    break;
+            }
+        });
+    }, [handleNewFile, handleOpenFolder, handleRevealWorkspace]);
+    // Subscribe to open-file / deep-link requests from the OS.
+    useEffect(() => {
+        if (!isElectronHost())
+            return;
+        const host = getDocBlocksHost();
+        return host.onOpenRequest(async (req) => {
+            if (req.filePath) {
+                const workspaces = (await listWorkspaces()).filter((w) => w.type === 'electron-native' && w.rootPath);
+                const match = workspaces.find((w) => req.filePath.startsWith((w.rootPath ?? '') + '/') || req.filePath === w.rootPath);
+                if (match && match.rootPath) {
+                    const rel = '/' + req.filePath.slice(match.rootPath.length).replace(/^\/+/, '');
+                    await openFromIds(match.id, rel, true);
+                }
+            }
+            else if (req.url) {
+                try {
+                    const u = new URL(req.url);
+                    const path = u.searchParams.get('path');
+                    if (path) {
+                        const workspaces = (await listWorkspaces()).filter((w) => w.type === 'electron-native' && w.rootPath);
+                        const match = workspaces.find((w) => path.startsWith((w.rootPath ?? '') + '/') || path === w.rootPath);
+                        if (match && match.rootPath) {
+                            const rel = '/' + path.slice(match.rootPath.length).replace(/^\/+/, '');
+                            await openFromIds(match.id, rel, true);
+                        }
+                    }
+                }
+                catch {
+                    // bad URL, ignore
+                }
+            }
+        });
+    }, [openFromIds]);
     const handleSelect = useCallback(async (path, kind) => {
         if (!provider || !activeWorkspaceId)
             return;
@@ -331,10 +1021,11 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
             setInitialView('wysiwyg');
             setEditorKey((k) => k + 1);
             pushHash(activeWorkspaceId, path);
-            if (isMobile)
+            saveLastState({ workspaceId: activeWorkspaceId, filePath: path, view: 'wysiwyg' });
+            if (effectiveCompact)
                 setMobileShowEditor(true);
         }
-    }, [provider, activeWorkspaceId, pushHash, isMobile]);
+    }, [provider, activeWorkspaceId, pushHash, effectiveCompact]);
     const handleTreeChange = useCallback(async () => {
         if (!provider)
             return;
@@ -354,19 +1045,24 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
             setFolderEntries(entries);
         }
     }, [provider, selectedFile, selectedFolder, activeWorkspaceId, pushHash]);
-    /** Copy non-markdown files from an imported container into persistent media storage. */
-    const persistContainerMedia = useCallback(async (source) => {
-        const mc = mediaContainerRef.current;
-        if (!mc)
-            return;
+    /**
+     * Copy non-markdown files from an imported container into the target
+     * markdown file's `_files/` sibling folder, preserving the source's
+     * relative structure.
+     */
+    const persistImportedMedia = useCallback(async (source, target, importedMarkdownPath) => {
+        const parentDir = dirnameOf(importedMarkdownPath);
+        const folder = basenameOf(importedMarkdownPath).replace(/\.[^.]+$/, '') + '_files';
+        const mediaRoot = parentDir ? `${parentDir}/${folder}` : folder;
         const entries = await source.listFiles();
         for (const entry of entries) {
             if (entry.path.endsWith('.md'))
                 continue;
             const data = await source.readFile(entry.path);
-            if (data) {
-                await mc.writeFile(entry.path, new Uint8Array(data), entry.mimeType);
-            }
+            if (!data)
+                continue;
+            const cleanPath = entry.path.replace(/^\/+/, '');
+            await target.writeBinary(`${mediaRoot}/${cleanPath}`, new Uint8Array(data));
         }
     }, []);
     const handleImportFiles = useCallback(async (files) => {
@@ -385,19 +1081,19 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
                     const { docxToContainer } = await import('@bendyline/squisq-formats/docx');
                     const container = await docxToContainer(await file.arrayBuffer());
                     markdown = (await container.readDocument()) ?? '';
-                    await persistContainerMedia(container);
+                    await persistImportedMedia(container, provider, destPath);
                 }
                 else if (ext === '.pdf') {
                     const { pdfToContainer } = await import('@bendyline/squisq-formats/pdf');
                     const container = await pdfToContainer(await file.arrayBuffer());
                     markdown = (await container.readDocument()) ?? '';
-                    await persistContainerMedia(container);
+                    await persistImportedMedia(container, provider, destPath);
                 }
                 else if (ext === '.dbk' || ext === '.zip') {
                     const { zipToContainer } = await import('@bendyline/squisq-formats/container');
                     const container = await zipToContainer(await file.arrayBuffer());
                     markdown = (await container.readDocument()) ?? '';
-                    await persistContainerMedia(container);
+                    await persistImportedMedia(container, provider, destPath);
                 }
                 else {
                     continue;
@@ -408,14 +1104,9 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
                 console.error(`Failed to import ${file.name}:`, err);
             }
         }
-        // Refresh media provider once after all imports (not per-file)
-        const mc = mediaContainerRef.current;
-        if (mc) {
-            setMediaProvider(createMediaProviderFromContainer(mc));
-        }
-        // Refresh file tree
+        // Refresh file tree so the new markdown files + _files folders show up.
         setExplorerKey((k) => k + 1);
-    }, [provider, persistContainerMedia]);
+    }, [provider, persistImportedMedia]);
     const handleEditorChange = useCallback((source) => {
         setEditorContent(source);
     }, []);
@@ -431,44 +1122,186 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
         await saveWorkspace({ ...ws, name: newName });
         // Bump key to trigger re-render — workspace name is read from the descriptor, not the provider
         setEditorKey((k) => k + 1);
-    }, [activeWorkspaceId, provider]);
+    }, [activeWorkspaceId]);
+    /**
+     * Walk a FileSystemProvider and copy every file into `container` under
+     * `pathPrefix` (no leading slash; empty string for the root). Used by
+     * both single- and all-workspace downloads.
+     */
+    const copyProviderToContainer = useCallback(async (src, container, pathPrefix) => {
+        const encoder = new TextEncoder();
+        const stack = ['/'];
+        while (stack.length > 0) {
+            const dir = stack.pop();
+            const entries = await src.readDirectory(dir);
+            for (const entry of entries) {
+                if (entry.kind === 'directory') {
+                    stack.push(entry.path);
+                    continue;
+                }
+                const rel = entry.path.replace(/^\/+/, '');
+                const zipPath = pathPrefix ? `${pathPrefix}/${rel}` : rel;
+                // Files may be stored as text (writeFile) or binary (writeBinary);
+                // try binary first, fall back to text and encode as UTF-8.
+                const binary = await src.readBinary(entry.path);
+                if (binary) {
+                    await container.writeFile(zipPath, binary);
+                    continue;
+                }
+                const text = await src.readFile(entry.path);
+                if (text !== null) {
+                    await container.writeFile(zipPath, encoder.encode(text));
+                }
+            }
+        }
+    }, []);
     const handleDownloadWorkspace = useCallback(async () => {
         if (!provider)
             return;
         try {
-            const entries = await provider.readDirectory('/');
-            const lines = [];
-            for (const entry of entries) {
-                if (entry.kind === 'file') {
-                    const content = await provider.readFile(entry.path);
-                    lines.push(`--- ${entry.path} ---\n${content ?? ''}\n`);
+            const [{ MemoryContentContainer }, { containerToZip }] = await Promise.all([
+                import('@bendyline/squisq/storage'),
+                import('@bendyline/squisq-formats/container'),
+            ]);
+            const container = new MemoryContentContainer();
+            await copyProviderToContainer(provider, container, '');
+            const blob = await containerToZip(container);
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = url;
+            const safeName = (provider.label || 'workspace').replace(/[^a-z0-9_\- ]/gi, '_').trim() || 'workspace';
+            a.download = `${safeName}.zip`;
+            a.click();
+            URL.revokeObjectURL(url);
+        }
+        catch (err) {
+            console.error('Failed to download workspace', err);
+            alert('Failed to download workspace. See console for details.');
+        }
+    }, [provider, copyProviderToContainer]);
+    /**
+     * Bundle every workspace the host can open without further prompting
+     * into a single zip, with each workspace nested under its own folder.
+     * Native (browser-picked) workspaces whose handle hasn't been re-granted
+     * for this session are skipped — restoring them would require a user
+     * gesture per workspace.
+     */
+    const handleDownloadAllWorkspaces = useCallback(async () => {
+        try {
+            const [{ MemoryContentContainer }, { containerToZip }] = await Promise.all([
+                import('@bendyline/squisq/storage'),
+                import('@bendyline/squisq-formats/container'),
+            ]);
+            const electron = isElectronHost();
+            const all = await listWorkspaces();
+            const candidates = all.filter((w) => electron ? w.type === 'electron-native' : w.type !== 'electron-native');
+            if (candidates.length === 0) {
+                alert('No workspaces to download.');
+                return;
+            }
+            const container = new MemoryContentContainer();
+            const usedFolders = new Set();
+            const skipped = [];
+            for (const ws of candidates) {
+                let p = null;
+                try {
+                    if (ws.type === 'electron-native') {
+                        p = await createElectronProviderFromWorkspace(ws);
+                    }
+                    else if (ws.type === 'native') {
+                        // Restore without prompting — only succeeds when the browser
+                        // still remembers the granted handle for this origin/session.
+                        p = await restoreNativeFolder(ws.id);
+                    }
+                    else {
+                        p = new IndexedDBFileSystemProvider(ws.id, ws.name);
+                    }
                 }
+                catch (err) {
+                    console.warn(`Skipping workspace ${ws.name}:`, err);
+                }
+                if (!p) {
+                    skipped.push(ws.name);
+                    continue;
+                }
+                // Pick a unique, filesystem-safe folder name per workspace.
+                const base = (ws.name || 'workspace').replace(/[^a-z0-9_\- ]/gi, '_').trim() || 'workspace';
+                let folder = base;
+                let suffix = 2;
+                while (usedFolders.has(folder)) {
+                    folder = `${base} (${suffix++})`;
+                }
+                usedFolders.add(folder);
+                await copyProviderToContainer(p, container, folder);
+            }
+            if (usedFolders.size === 0) {
+                alert('No workspaces could be opened for download.');
+                return;
             }
-            const blob = new Blob([lines.join('\n')], { type: 'text/plain' });
+            const blob = await containerToZip(container);
             const url = URL.createObjectURL(blob);
             const a = document.createElement('a');
             a.href = url;
-            a.download = 'workspace.txt';
+            const stamp = new Date().toISOString().slice(0, 10);
+            a.download = `docblocks-workspaces-${stamp}.zip`;
             a.click();
             URL.revokeObjectURL(url);
+            if (skipped.length > 0) {
+                alert(`Downloaded ${usedFolders.size} workspace(s). Skipped ${skipped.length} that require re-granting access: ${skipped.join(', ')}.`);
+            }
         }
-        catch {
-            // ignore
+        catch (err) {
+            console.error('Failed to download all workspaces', err);
+            alert('Failed to download all workspaces. See console for details.');
         }
-    }, [provider]);
+    }, [copyProviderToContainer]);
     const handleRemoveWorkspace = useCallback(async () => {
         if (!activeWorkspaceId)
             return;
-        if (!confirm('Remove this workspace? This cannot be undone.'))
+        const confirmMsg = isElectronHost()
+            ? 'Remove this workspace from DocBlocks? The files on disk will not be deleted.'
+            : 'Remove this workspace? This cannot be undone.';
+        if (!confirm(confirmMsg))
             return;
-        await removeDirectoryHandle(activeWorkspaceId);
+        const ws = await getWorkspace(activeWorkspaceId);
+        if (ws?.type === 'electron-native') {
+            try {
+                await getDocBlocksHost().workspaces.unregister(activeWorkspaceId);
+            }
+            catch {
+                // ignore — host cleanup is best-effort
+            }
+        }
+        else {
+            await removeDirectoryHandle(activeWorkspaceId);
+        }
         await removeWorkspace(activeWorkspaceId);
+        const electron = isElectronHost();
         // Switch to most recent remaining workspace or create default
-        const remaining = await listWorkspaces();
+        const remaining = (await listWorkspaces()).filter((w) => electron ? w.type === 'electron-native' : w.type !== 'electron-native');
         if (remaining.length > 0) {
             const next = remaining[0];
             await handleWorkspaceSelect(next);
         }
+        else if (electron) {
+            const info = await getDocBlocksHost().workspaces.getDefault();
+            const descriptor = {
+                id: info.id,
+                name: info.name,
+                type: 'electron-native',
+                rootPath: info.rootPath,
+                lastOpened: new Date().toISOString(),
+            };
+            await saveWorkspace(descriptor);
+            const p = new ElectronFileSystemProvider(info.id, info.name, info.rootPath);
+            setProvider(p);
+            setActiveWorkspaceId(info.id);
+            setSelectedFile(null);
+            setSelectedFolder(null);
+            setFolderEntries([]);
+            setEditorContent('');
+            setEditorKey((k) => k + 1);
+        }
         else {
             const defaultWs = await ensureDefaultWorkspace();
             const fsProvider = new IndexedDBFileSystemProvider(defaultWs.id, defaultWs.name);
@@ -479,9 +1312,8 @@ export function DocBlocksShell({ theme = 'auto', logoUrl }) {
             setFolderEntries([]);
             setEditorContent('');
             setEditorKey((k) => k + 1);
-            setupMediaContainer(defaultWs.id);
         }
-    }, [activeWorkspaceId, handleWorkspaceSelect, setupMediaContainer]);
-    return (_jsx("div", { className: `db-shell${isMobile ? ' db-shell--mobile' : ''}`, "data-theme": resolvedTheme, children: _jsxs("div", { style: { display: 'flex', flex: 1, overflow: 'hidden' }, children: [(!isMobile || !mobileShowEditor) && (_jsxs("div", { className: "db-shell-sidebar", children: [_jsxs("div", { className: "db-shell-sidebar-header", children: [_jsx(AppMenu, { logoUrl: logoUrl }), _jsx(WorkspacePicker, { activeWorkspaceId: activeWorkspaceId, onSelect: handleWorkspaceSelect, onOpenFolder: handleOpenFolder }), _jsx(WorkspaceSettingsButton, { onRename: handleRenameWorkspace, onDownload: handleDownloadWorkspace, onRemove: handleRemoveWorkspace })] }), _jsx(FileExplorer, { provider: provider, onSelect: handleSelect, onTreeChange: handleTreeChange, onImportFiles: handleImportFiles }, explorerKey), _jsx("div", { className: "db-shell-sidebar-footer", children: _jsx("a", { href: "https://github.com/bendyline/docblocks/blob/main/LICENSE", target: "_blank", rel: "noopener noreferrer", children: "Terms of Use" }) })] })), (!isMobile || mobileShowEditor) && (_jsx("div", { style: { flex: 1, overflow: 'hidden', display: 'flex', flexDirection: 'column' }, children: selectedFile && mediaProvider ? (_jsx(MediaContext.Provider, { value: mediaProvider, children: _jsx(EditorShell, { initialMarkdown: editorContent, initialView: initialView, articleId: selectedFile, onChange: handleEditorChange, theme: resolvedTheme, height: "100%", mediaProvider: mediaProvider, container: mediaContainerRef.current ?? undefined, toolbarSlotLeft: isMobile ? (_jsx("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: _jsx("span", { className: "db-mobile-back-arrow", children: "\u2190" }) })) : undefined, toolbarSlotRight: _jsx(ExportToolbarControls, { selectedFile: selectedFile, mediaContainer: mediaContainerRef.current }) }, `${selectedFile}-${editorKey}`) })) : selectedFolder ? (_jsxs("div", { className: "db-folder-view", children: [isMobile && (_jsxs("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [_jsx("span", { className: "db-mobile-back-arrow", children: "\u2190" }), "Back to files"] })), _jsxs("div", { className: "db-folder-view-header", children: [_jsx("span", { className: "db-folder-view-icon", children: "\uD83D\uDCC1" }), _jsx("span", { className: "db-folder-view-path", children: selectedFolder })] }), folderEntries.length === 0 ? (_jsx("p", { className: "db-folder-view-empty", children: "This folder is empty." })) : (_jsx("ul", { className: "db-folder-view-list", children: folderEntries.map((entry) => (_jsxs("li", { className: "db-folder-view-item", onClick: () => handleSelect(entry.path, entry.kind), children: [_jsx("span", { className: "db-folder-view-item-icon", children: entry.kind === 'directory' ? '📁' : '📄' }), entry.name] }, entry.path))) }))] })) : (_jsx("div", { className: "db-shell-empty", children: _jsx("p", { children: "Select a file to start editing, or create a new one." }) })) }))] }) }));
+    }, [activeWorkspaceId, handleWorkspaceSelect]);
+    return (_jsxs("div", { className: `db-shell${effectiveCompact ? ' db-shell--mobile' : ''}`, "data-theme": resolvedTheme, children: [saveToastVisible && (_jsx("div", { className: "db-save-toast", role: "status", "aria-live": "polite", children: "Autosaved. You're all set." })), workspaceSettingsOpen && activeWorkspaceDescriptor && (_jsx(WorkspaceSettingsDialog, { workspace: activeWorkspaceDescriptor, globalVersioningPreference: versioningPreference, onChange: handleWorkspaceVersioningOverrideChange, onClose: () => setWorkspaceSettingsOpen(false) })), _jsxs("div", { style: { display: 'flex', flex: 1, overflow: 'hidden' }, children: [(!effectiveCompact || !mobileShowEditor) && (_jsxs("div", { ref: sidebarRef, className: "db-shell-sidebar", style: effectiveCompact ? undefined : { width: `${sidebarWidth}px` }, children: [_jsxs("div", { className: "db-shell-sidebar-header", children: [_jsx(AppMenu, { logoUrl: logoUrl, themePreference: themePreference, onThemeChange: handleThemeChange, versioningPreference: versioningPreference, onVersioningPreferenceChange: handleVersioningPreferenceChange, onDownloadAllWorkspaces: handleDownloadAllWorkspaces }), _jsx(WorkspacePicker, { activeWorkspaceId: activeWorkspaceId, onSelect: handleWorkspaceSelect, onOpenFolder: handleOpenFolder }), _jsx(WorkspaceSettingsButton, { onSettings: handleOpenWorkspaceSettings, onRename: handleRenameWorkspace, onDownload: handleDownloadWorkspace, onRemove: handleRemoveWorkspace })] }), _jsx(FileExplorer, { provider: provider, onSelect: handleSelect, onTreeChange: handleTreeChange, onImportFiles: handleImportFiles }, explorerKey), _jsx("div", { className: "db-shell-sidebar-footer", children: _jsx("a", { href: "https://github.com/bendyline/docblocks/blob/main/LICENSE", target: "_blank", rel: "noopener noreferrer", children: "Terms of Use" }) })] })), !effectiveCompact && (_jsx("div", { className: "db-shell-sidebar-resizer", role: "separator", "aria-orientation": "vertical", "aria-label": "Resize sidebar", onPointerDown: handleResizerPointerDown })), (!effectiveCompact || mobileShowEditor) && (_jsx("div", { style: { flex: 1, overflow: 'hidden', display: 'flex', flexDirection: 'column' }, children: selectedFile && mediaProvider ? (_jsx(MediaContext.Provider, { value: mediaProvider, children: _jsx(EditorShell, { initialMarkdown: editorContent, initialView: initialView, articleId: selectedFile, fileName: selectedFile, onChange: handleEditorChange, theme: resolvedTheme, height: "100%", outlineWidth: 280, mediaProvider: mediaProvider, documentLinkProvider: documentLinkProvider, container: versionsContainer ?? undefined, allowVersioning: effectiveVersioning, viewPreferences: viewPreferences, onViewPreferencesChange: handleViewPreferencesChange, versionBasename: versionBasename ?? stripExtension(basenameOf(selectedFile)), versioningPrunePolicy: versioningPrunePolicy, versioningAutoSaveIdleMs: versioningAutoSaveIdleMs, onSaveVersion: onSaveVersion, toolbarSlotLeft: effectiveCompact ? (_jsx("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), "aria-label": "Show file list", children: _jsx("span", { className: "db-mobile-back-arrow", children: "\u2190" }) })) : undefined, toolbarSlotRight: _jsxs(_Fragment, { children: [compactLayout && !isMobile && (_jsx("button", { className: "db-restore-split", onClick: () => setCompactLayout(false), "aria-label": "Restore split view", title: "Restore split view", children: _jsxs("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("rect", { x: "1.5", y: "2.5", width: "13", height: "11", rx: "1" }), _jsx("line", { x1: "6", y1: "2.5", x2: "6", y2: "13.5" })] }) })), _jsx(ExportToolbarControls, { selectedFile: selectedFile, mediaContainer: mediaContainerRef.current })] }) }, `${selectedFile}-${editorKey}`) })) : selectedFolder ? (_jsxs("div", { className: "db-folder-view", children: [effectiveCompact && (_jsxs("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [_jsx("span", { className: "db-mobile-back-arrow", children: "\u2190" }), "Back to files"] })), _jsxs("div", { className: "db-folder-view-header", children: [_jsx("span", { className: "db-folder-view-icon", children: _jsx(FolderGlyph, {}) }), _jsx("span", { className: "db-folder-view-path", children: selectedFolder })] }), folderEntries.length === 0 ? (_jsx("p", { className: "db-folder-view-empty", children: "This folder is empty." })) : (_jsx("ul", { className: "db-folder-view-list", children: folderEntries.map((entry) => (_jsxs("li", { className: "db-folder-view-item", onClick: () => handleSelect(entry.path, entry.kind), children: [_jsx("span", { className: "db-folder-view-item-icon", children: entry.kind === 'directory' ? _jsx(FolderGlyph, {}) : _jsx(FileGlyph, {}) }), entry.name] }, entry.path))) }))] })) : (_jsxs("div", { className: "db-shell-empty", children: [effectiveCompact && (_jsxs("button", { className: "db-mobile-back", onClick: () => setMobileShowEditor(false), children: [_jsx("span", { className: "db-mobile-back-arrow", children: "\u2190" }), "Back to files"] })), _jsx("p", { children: "Select a file to start editing, or create a new one." })] })) }))] })] }));
 }
 //# sourceMappingURL=DocBlocksShell.js.map