@bendyline/docblocks-react 1.1.0 → 1.1.1

package/dist/hooks/useAutoSave.js

@@ -2,47 +2,82 @@
  * useAutoSave — debounced auto-save hook.
  *
  * Writes content to the FileSystemProvider after a delay
- * whenever the content changes.
+ * whenever the content changes. Returns a `flush` function so callers
+ * (e.g. an explicit Ctrl/Cmd+S handler) can force an immediate write
+ * and await its completion.
  */
 import { useEffect, useRef, useCallback } from 'react';
-export function useAutoSave(provider, filePath, content, delayMs = 500) {
+export function useAutoSave(provider, filePath, content, delayMs = 500, onSaved) {
     const timerRef = useRef(null);
-    const lastSavedRef = useRef(content);
-    const save = useCallback(async () => {
-        if (!provider || !filePath)
-            return;
-        if (content === lastSavedRef.current)
-            return;
-        lastSavedRef.current = content;
-        await provider.writeFile(filePath, content);
-    }, [provider, filePath, content]);
-    useEffect(() => {
-        if (!provider || !filePath)
-            return;
+    const contentRef = useRef(content);
+    const onSavedRef = useRef(onSaved);
+    const targetRef = useRef(null);
+    const clearTimer = useCallback(() => {
         if (timerRef.current) {
             clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+    }, []);
+    const flushTarget = useCallback(async (target, nextContent) => {
+        if (nextContent === target.lastSaved)
+            return;
+        const previous = target.lastSaved;
+        target.lastSaved = nextContent;
+        try {
+            await target.provider.writeFile(target.filePath, nextContent);
+            onSavedRef.current?.(target.filePath, nextContent);
+        }
+        catch (err) {
+            target.lastSaved = previous;
+            throw err;
         }
-        timerRef.current = setTimeout(() => {
-            save();
-        }, delayMs);
+    }, []);
+    useEffect(() => {
+        onSavedRef.current = onSaved;
+    }, [onSaved]);
+    useEffect(() => {
+        contentRef.current = content;
+    }, [content]);
+    useEffect(() => {
+        clearTimer();
+        targetRef.current = provider && filePath ? { provider, filePath, lastSaved: content } : null;
+        contentRef.current = content;
         return () => {
-            if (timerRef.current) {
-                clearTimeout(timerRef.current);
+            clearTimer();
+            const target = targetRef.current;
+            if (target) {
+                void flushTarget(target, contentRef.current).catch(() => undefined);
             }
+            targetRef.current = null;
         };
-    }, [content, delayMs, save, provider, filePath]);
-    // Flush on unmount
+        // `content` is intentionally captured only when the save target changes.
+        // Content edits are handled by the debounced effect below.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [provider, filePath, clearTimer, flushTarget]);
     useEffect(() => {
+        const target = targetRef.current;
+        if (!target)
+            return;
+        clearTimer();
+        if (content !== target.lastSaved) {
+            timerRef.current = setTimeout(() => {
+                const currentTarget = targetRef.current;
+                if (!currentTarget)
+                    return;
+                void flushTarget(currentTarget, contentRef.current).catch(() => undefined);
+            }, delayMs);
+        }
         return () => {
-            if (timerRef.current) {
-                clearTimeout(timerRef.current);
-            }
-            // Sync save on unmount is best-effort
-            if (provider && filePath && content !== lastSavedRef.current) {
-                provider.writeFile(filePath, content);
-            }
+            clearTimer();
         };
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
+    }, [content, delayMs, clearTimer, flushTarget]);
+    const flush = useCallback(async () => {
+        clearTimer();
+        const target = targetRef.current;
+        if (!target)
+            return;
+        await flushTarget(target, contentRef.current);
+    }, [clearTimer, flushTarget]);
+    return { flush };
 }
 //# sourceMappingURL=useAutoSave.js.map

package/dist/hooks/useAutoSave.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAutoSave.js","sourceRoot":"","sources":["../../src/hooks/useAutoSave.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGvD,MAAM,UAAU,WAAW,CACzB,QAAmC,EACnC,QAAuB,EACvB,OAAe,EACf,OAAO,GAAG,GAAG;IAEb,MAAM,QAAQ,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,MAAM,CAAS,OAAO,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;YAAE,OAAO;QACnC,IAAI,OAAO,KAAK,YAAY,CAAC,OAAO;YAAE,OAAO;QAC7C,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAElC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEnC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,IAAI,EAAE,CAAC;QACT,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjD,mBAAmB;IACnB,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;YACD,sCAAsC;YACtC,IAAI,QAAQ,IAAI,QAAQ,IAAI,OAAO,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC7D,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}
+{"version":3,"file":"useAutoSave.js","sourceRoot":"","sources":["../../src/hooks/useAutoSave.ts"],"names":[],"mappings":"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"}

package/dist/preferences/versioning.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Versioning preferences — global default + per-workspace resolution.
+ *
+ * The global preference controls whether DocBlocks writes version
+ * snapshots (under `<basename>_files/.versions/`) when editing. The
+ * default is `'browser-only'` so local-folder workspaces stay clean by
+ * default and only IndexedDB workspaces accumulate version history.
+ *
+ * Each workspace can override the global default with its own setting
+ * stored on the WorkspaceDescriptor. `'inherit'` (or absent) defers to
+ * the global preference; `'on'` / `'off'` force the behavior regardless.
+ */
+import type { WorkspaceDescriptor } from '@bendyline/docblocks/workspace';
+export type VersioningPreference = 'on' | 'browser-only' | 'off';
+export declare function loadVersioningPreference(): VersioningPreference;
+export declare function saveVersioningPreference(value: VersioningPreference): void;
+/** Whether a workspace type is "local" (writes to a real folder on disk). */
+export declare function isLocalWorkspaceType(type: WorkspaceDescriptor['type']): boolean;
+/**
+ * Compute the effective versioning state for a workspace, honoring the
+ * per-workspace override first and falling back to the global preference.
+ *
+ * Returns `false` whenever no workspace is provided so callers can use
+ * this directly during initial render before a workspace loads.
+ */
+export declare function resolveVersioningEnabled(workspace: WorkspaceDescriptor | null, globalPref: VersioningPreference): boolean;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/preferences/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/preferences/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,cAAc,GAAG,KAAK,CAAC;AAKjE,wBAAgB,wBAAwB,IAAI,oBAAoB,CAQ/D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAM1E;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,mBAAmB,GAAG,IAAI,EACrC,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAeT"}

package/dist/preferences/versioning.js

@@ -0,0 +1,62 @@
+/**
+ * Versioning preferences — global default + per-workspace resolution.
+ *
+ * The global preference controls whether DocBlocks writes version
+ * snapshots (under `<basename>_files/.versions/`) when editing. The
+ * default is `'browser-only'` so local-folder workspaces stay clean by
+ * default and only IndexedDB workspaces accumulate version history.
+ *
+ * Each workspace can override the global default with its own setting
+ * stored on the WorkspaceDescriptor. `'inherit'` (or absent) defers to
+ * the global preference; `'on'` / `'off'` force the behavior regardless.
+ */
+const STORAGE_KEY = 'docblocks:versioningPreference';
+const DEFAULT_PREFERENCE = 'browser-only';
+export function loadVersioningPreference() {
+    try {
+        const raw = localStorage.getItem(STORAGE_KEY);
+        if (raw === 'on' || raw === 'browser-only' || raw === 'off')
+            return raw;
+    }
+    catch {
+        // ignore
+    }
+    return DEFAULT_PREFERENCE;
+}
+export function saveVersioningPreference(value) {
+    try {
+        localStorage.setItem(STORAGE_KEY, value);
+    }
+    catch {
+        // ignore quota errors
+    }
+}
+/** Whether a workspace type is "local" (writes to a real folder on disk). */
+export function isLocalWorkspaceType(type) {
+    return type === 'native' || type === 'electron-native';
+}
+/**
+ * Compute the effective versioning state for a workspace, honoring the
+ * per-workspace override first and falling back to the global preference.
+ *
+ * Returns `false` whenever no workspace is provided so callers can use
+ * this directly during initial render before a workspace loads.
+ */
+export function resolveVersioningEnabled(workspace, globalPref) {
+    if (!workspace)
+        return false;
+    const override = workspace.versioningOverride;
+    if (override === 'on')
+        return true;
+    if (override === 'off')
+        return false;
+    switch (globalPref) {
+        case 'on':
+            return true;
+        case 'off':
+            return false;
+        case 'browser-only':
+            return !isLocalWorkspaceType(workspace.type);
+    }
+}
+//# sourceMappingURL=versioning.js.map

package/dist/preferences/versioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../../src/preferences/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,GAAG,gCAAgC,CAAC;AACrD,MAAM,kBAAkB,GAAyB,cAAc,CAAC;AAEhE,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,KAAK;YAAE,OAAO,GAAG,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAA2B;IAClE,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,IAAiC;IACpE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,iBAAiB,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAqC,EACrC,UAAgC;IAEhC,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAE7B,MAAM,QAAQ,GAAG,SAAS,CAAC,kBAAkB,CAAC;IAC9C,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAErC,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,cAAc;YACjB,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks-react",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "React components for DocBlocks — file explorer, workspace picker, and editor shell",
   "license": "MIT",
   "author": "Bendyline",
@@ -45,18 +45,20 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@bendyline/docblocks": "1.1.0",
-    "@bendyline/squisq": "1.3.0",
-    "@bendyline/squisq-editor-react": "1.4.0",
-    "@bendyline/squisq-formats": "1.2.3",
-    "@bendyline/squisq-react": "1.2.0",
-    "@bendyline/squisq-video": "1.0.5",
-    "@bendyline/squisq-video-react": "1.0.5",
+    "@bendyline/docblocks": "1.1.1",
+    "@bendyline/squisq": "1.4.1",
+    "@bendyline/squisq-editor-react": "1.5.3",
+    "@bendyline/squisq-formats": "1.3.1",
+    "@bendyline/squisq-react": "1.3.2",
+    "@bendyline/squisq-video": "1.1.2",
+    "@bendyline/squisq-video-react": "1.1.2",
     "monaco-editor": "0.55.1"
   },
   "devDependencies": {
+    "@happy-dom/global-registrator": "20.9.0",
     "@types/react": "18.3.28",
     "@types/react-dom": "18.3.7",
+    "happy-dom": "20.9.0",
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "tsup": "8.5.1",

package/src/AppMenu/AppMenu.tsx

@@ -3,6 +3,7 @@
  */
 
 import { useState, useCallback, useRef, useEffect } from 'react';
+import type { VersioningPreference } from '../preferences/versioning.js';
 
 export type ThemePreference = 'auto' | 'light' | 'dark';
 
@@ -15,6 +16,15 @@ export interface AppMenuProps {
   themePreference?: ThemePreference;
   /** Called when the user changes the theme preference. */
   onThemeChange?: (theme: ThemePreference) => void;
+  /** Current global versioning preference. */
+  versioningPreference?: VersioningPreference;
+  /** Called when the user changes the global versioning preference. */
+  onVersioningPreferenceChange?: (pref: VersioningPreference) => void;
+  /**
+   * Called when the user clicks "Download all workspaces". When omitted,
+   * the menu item is hidden.
+   */
+  onDownloadAllWorkspaces?: () => void | Promise<void>;
 }
 
 export function AppMenu({
@@ -22,6 +32,9 @@ export function AppMenu({
   logoUrl,
   themePreference = 'auto',
   onThemeChange,
+  versioningPreference = 'browser-only',
+  onVersioningPreferenceChange,
+  onDownloadAllWorkspaces,
 }: AppMenuProps) {
   const [isOpen, setIsOpen] = useState(false);
   const [showAbout, setShowAbout] = useState(false);
@@ -72,6 +85,15 @@ export function AppMenu({
             >
               Settings
             </button>
+            {onDownloadAllWorkspaces && (
+              <button
+                className="db-app-menu-item"
+                role="menuitem"
+                onClick={() => handleAction(() => void onDownloadAllWorkspaces())}
+              >
+                Download all workspaces
+              </button>
+            )}
             <div className="db-app-menu-divider" />
             <button
               className="db-app-menu-item"
@@ -136,6 +158,47 @@ export function AppMenu({
                   Dark
                 </label>
               </fieldset>
+
+              {onVersioningPreferenceChange && (
+                <fieldset className="db-settings-fieldset">
+                  <legend className="db-settings-legend">Version history</legend>
+                  <p className="db-settings-hint">
+                    When on, DocBlocks keeps prior revisions of each document inside a sibling{' '}
+                    <code>&lt;name&gt;_files/.versions/</code> folder. Individual workspaces can
+                    override this default in their own settings.
+                  </p>
+                  <label className="db-settings-radio">
+                    <input
+                      type="radio"
+                      name="versioning"
+                      value="on"
+                      checked={versioningPreference === 'on'}
+                      onChange={() => onVersioningPreferenceChange('on')}
+                    />
+                    On for all workspaces
+                  </label>
+                  <label className="db-settings-radio">
+                    <input
+                      type="radio"
+                      name="versioning"
+                      value="browser-only"
+                      checked={versioningPreference === 'browser-only'}
+                      onChange={() => onVersioningPreferenceChange('browser-only')}
+                    />
+                    On in browser workspaces, off for local folders
+                  </label>
+                  <label className="db-settings-radio">
+                    <input
+                      type="radio"
+                      name="versioning"
+                      value="off"
+                      checked={versioningPreference === 'off'}
+                      onChange={() => onVersioningPreferenceChange('off')}
+                    />
+                    Off for all workspaces
+                  </label>
+                </fieldset>
+              )}
             </div>
           </div>
         </div>
@@ -167,7 +230,7 @@ export function AppMenu({
               <p>
                 Built on{' '}
                 <a
-                  href="https://github.com/nicoth-in/squisq"
+                  href="https://github.com/bendyline/squisq"
                   target="_blank"
                   rel="noopener noreferrer"
                 >