@bendyline/docblocks-react 1.0.0 → 1.1.1

package/dist/WorkspacePicker/WorkspaceSettingsButton.d.ts

@@ -2,9 +2,10 @@
  * WorkspaceSettingsButton — gear icon dropdown for workspace actions.
  */
 export interface WorkspaceSettingsButtonProps {
+    onSettings: () => void;
     onRename: () => void;
     onDownload: () => void;
     onRemove: () => void;
 }
-export declare function WorkspaceSettingsButton({ onRename, onDownload, onRemove, }: WorkspaceSettingsButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function WorkspaceSettingsButton({ onSettings, onRename, onDownload, onRemove, }: WorkspaceSettingsButtonProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=WorkspaceSettingsButton.d.ts.map

package/dist/WorkspacePicker/WorkspaceSettingsButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceSettingsButton.d.ts","sourceRoot":"","sources":["../../src/WorkspacePicker/WorkspaceSettingsButton.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE,4BAA4B,2CA6D9B"}
+{"version":3,"file":"WorkspaceSettingsButton.d.ts","sourceRoot":"","sources":["../../src/WorkspacePicker/WorkspaceSettingsButton.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CAAC,EACtC,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE,4BAA4B,2CAoE9B"}

package/dist/WorkspacePicker/WorkspaceSettingsButton.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { useState, useCallback, useRef, useEffect } from 'react';
 import { WorkspaceIcon } from '../icons.js';
-export function WorkspaceSettingsButton({ onRename, onDownload, onRemove, }) {
+export function WorkspaceSettingsButton({ onSettings, onRename, onDownload, onRemove, }) {
     const [isOpen, setIsOpen] = useState(false);
     const ref = useRef(null);
     useEffect(() => {
@@ -22,6 +22,6 @@ export function WorkspaceSettingsButton({ onRename, onDownload, onRemove, }) {
         setIsOpen(false);
         action();
     }, []);
-    return (_jsxs("div", { ref: ref, className: "db-ws-settings", children: [_jsx("button", { className: "db-ws-settings-btn", onClick: () => setIsOpen(!isOpen), "aria-expanded": isOpen, "aria-haspopup": "true", "aria-label": "Workspace settings", title: "Workspace settings", children: _jsx(WorkspaceIcon, {}) }), isOpen && (_jsxs("div", { className: "db-ws-settings-dropdown", role: "menu", children: [_jsx("button", { className: "db-ws-settings-item", role: "menuitem", onClick: () => handleAction(onRename), children: "Rename workspace" }), _jsx("button", { className: "db-ws-settings-item", role: "menuitem", onClick: () => handleAction(onDownload), children: "Download workspace" }), _jsx("div", { className: "db-ws-settings-divider" }), _jsx("button", { className: "db-ws-settings-item db-ws-settings-item--danger", role: "menuitem", onClick: () => handleAction(onRemove), children: "Remove workspace" })] }))] }));
+    return (_jsxs("div", { ref: ref, className: "db-ws-settings", children: [_jsx("button", { className: "db-ws-settings-btn", onClick: () => setIsOpen(!isOpen), "aria-expanded": isOpen, "aria-haspopup": "true", "aria-label": "Workspace settings", title: "Workspace settings", children: _jsx(WorkspaceIcon, {}) }), isOpen && (_jsxs("div", { className: "db-ws-settings-dropdown", role: "menu", children: [_jsx("button", { className: "db-ws-settings-item", role: "menuitem", onClick: () => handleAction(onSettings), children: "Workspace settings\u2026" }), _jsx("button", { className: "db-ws-settings-item", role: "menuitem", onClick: () => handleAction(onRename), children: "Rename workspace" }), _jsx("button", { className: "db-ws-settings-item", role: "menuitem", onClick: () => handleAction(onDownload), children: "Download workspace" }), _jsx("div", { className: "db-ws-settings-divider" }), _jsx("button", { className: "db-ws-settings-item db-ws-settings-item--danger", role: "menuitem", onClick: () => handleAction(onRemove), children: "Remove workspace" })] }))] }));
 }
 //# sourceMappingURL=WorkspaceSettingsButton.js.map

package/dist/WorkspacePicker/WorkspaceSettingsButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceSettingsButton.js","sourceRoot":"","sources":["../../src/WorkspacePicker/WorkspaceSettingsButton.tsx"],"names":[],"mappings":";AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,EACR,UAAU,EACV,QAAQ,GACqB;IAC7B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,SAAS,kBAAkB,CAAC,CAAa;YACvC,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAc,CAAC,EAAE,CAAC;gBAC3D,SAAS,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QAC3D,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC7E,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,MAAkB,EAAE,EAAE;QACtD,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,EAAE,CAAC;IACX,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,eAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAC,gBAAgB,aACvC,iBACE,SAAS,EAAC,oBAAoB,EAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,mBAClB,MAAM,mBACP,MAAM,gBACT,oBAAoB,EAC/B,KAAK,EAAC,oBAAoB,YAE1B,KAAC,aAAa,KAAG,GACV,EAER,MAAM,IAAI,CACT,eAAK,SAAS,EAAC,yBAAyB,EAAC,IAAI,EAAC,MAAM,aAClD,iBACE,SAAS,EAAC,qBAAqB,EAC/B,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,iCAG9B,EACT,iBACE,SAAS,EAAC,qBAAqB,EAC/B,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,mCAGhC,EACT,cAAK,SAAS,EAAC,wBAAwB,GAAG,EAC1C,iBACE,SAAS,EAAC,iDAAiD,EAC3D,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,iCAG9B,IACL,CACP,IACG,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"WorkspaceSettingsButton.js","sourceRoot":"","sources":["../../src/WorkspacePicker/WorkspaceSettingsButton.tsx"],"names":[],"mappings":";AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5C,MAAM,UAAU,uBAAuB,CAAC,EACtC,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,GACqB;IAC7B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,SAAS,kBAAkB,CAAC,CAAa;YACvC,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAc,CAAC,EAAE,CAAC;gBAC3D,SAAS,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QAC3D,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC7E,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,MAAkB,EAAE,EAAE;QACtD,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,EAAE,CAAC;IACX,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,eAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAC,gBAAgB,aACvC,iBACE,SAAS,EAAC,oBAAoB,EAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,mBAClB,MAAM,mBACP,MAAM,gBACT,oBAAoB,EAC/B,KAAK,EAAC,oBAAoB,YAE1B,KAAC,aAAa,KAAG,GACV,EAER,MAAM,IAAI,CACT,eAAK,SAAS,EAAC,yBAAyB,EAAC,IAAI,EAAC,MAAM,aAClD,iBACE,SAAS,EAAC,qBAAqB,EAC/B,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,yCAGhC,EACT,iBACE,SAAS,EAAC,qBAAqB,EAC/B,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,iCAG9B,EACT,iBACE,SAAS,EAAC,qBAAqB,EAC/B,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,mCAGhC,EACT,cAAK,SAAS,EAAC,wBAAwB,GAAG,EAC1C,iBACE,SAAS,EAAC,iDAAiD,EAC3D,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,iCAG9B,IACL,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/WorkspacePicker/WorkspaceSettingsDialog.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WorkspaceSettingsDialog — per-workspace settings modal.
+ *
+ * Lets the user override the global versioning preference for a single
+ * workspace (or fall back to inheriting it). The override is stored on
+ * the WorkspaceDescriptor and persisted via `saveWorkspace`.
+ */
+import type { WorkspaceDescriptor } from '@bendyline/docblocks/workspace';
+import { type VersioningPreference } from '../preferences/versioning.js';
+export type WorkspaceVersioningOverride = NonNullable<WorkspaceDescriptor['versioningOverride']>;
+export interface WorkspaceSettingsDialogProps {
+    workspace: WorkspaceDescriptor;
+    /** Current global versioning preference — used to label "Inherit". */
+    globalVersioningPreference: VersioningPreference;
+    /** Apply a new override and close the dialog. */
+    onChange: (override: WorkspaceVersioningOverride) => void;
+    onClose: () => void;
+}
+export declare function WorkspaceSettingsDialog({ workspace, globalVersioningPreference, onChange, onClose, }: WorkspaceSettingsDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkspaceSettingsDialog.d.ts.map

package/dist/WorkspacePicker/WorkspaceSettingsDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceSettingsDialog.d.ts","sourceRoot":"","sources":["../../src/WorkspacePicker/WorkspaceSettingsDialog.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAEjG,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,mBAAmB,CAAC;IAC/B,sEAAsE;IACtE,0BAA0B,EAAE,oBAAoB,CAAC;IACjD,iDAAiD;IACjD,QAAQ,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,CAAC;IAC1D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAQD,wBAAgB,uBAAuB,CAAC,EACtC,SAAS,EACT,0BAA0B,EAC1B,QAAQ,EACR,OAAO,GACR,EAAE,4BAA4B,2CAkF9B"}

package/dist/WorkspacePicker/WorkspaceSettingsDialog.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * WorkspaceSettingsDialog — per-workspace settings modal.
+ *
+ * Lets the user override the global versioning preference for a single
+ * workspace (or fall back to inheriting it). The override is stored on
+ * the WorkspaceDescriptor and persisted via `saveWorkspace`.
+ */
+import { useCallback, useEffect } from 'react';
+import { isLocalWorkspaceType, resolveVersioningEnabled, } from '../preferences/versioning.js';
+const VERSIONING_LABELS = {
+    on: 'on',
+    'browser-only': 'on for browser workspaces, off for local folders',
+    off: 'off',
+};
+export function WorkspaceSettingsDialog({ workspace, globalVersioningPreference, onChange, onClose, }) {
+    // Treat absent/undefined as 'inherit' for the radio state.
+    const current = workspace.versioningOverride ?? 'inherit';
+    useEffect(() => {
+        const onKey = (e) => {
+            if (e.key === 'Escape')
+                onClose();
+        };
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+    }, [onClose]);
+    const handleBackdropClick = useCallback((e) => {
+        if (e.target === e.currentTarget)
+            onClose();
+    }, [onClose]);
+    const isLocal = isLocalWorkspaceType(workspace.type);
+    const inheritedEnabled = resolveVersioningEnabled({ ...workspace, versioningOverride: 'inherit' }, globalVersioningPreference);
+    const inheritLabel = `Inherit default — currently ${VERSIONING_LABELS[globalVersioningPreference]} (${inheritedEnabled ? 'on' : 'off'} for this workspace)`;
+    return (_jsx("div", { className: "db-dialog-overlay", onClick: handleBackdropClick, children: _jsxs("div", { className: "db-dialog", role: "dialog", "aria-label": "Workspace settings", children: [_jsxs("div", { className: "db-dialog-header", children: [_jsx("h2", { className: "db-dialog-title", children: "Workspace settings" }), _jsx("button", { type: "button", className: "db-dialog-close", onClick: onClose, "aria-label": "Close", children: "\u00D7" })] }), _jsxs("div", { className: "db-dialog-body", children: [_jsxs("p", { className: "db-settings-hint", children: [_jsx("strong", { children: workspace.name }), " \u00B7", ' ', isLocal ? 'Local folder workspace' : 'Browser workspace'] }), _jsxs("fieldset", { className: "db-settings-fieldset", children: [_jsx("legend", { className: "db-settings-legend", children: "Version history" }), _jsxs("p", { className: "db-settings-hint", children: ["Controls whether DocBlocks keeps prior revisions in", ' ', _jsx("code", { children: "<name>_files/.versions/" }), " for documents in this workspace."] }), _jsxs("label", { className: "db-settings-radio", children: [_jsx("input", { type: "radio", name: "ws-versioning", value: "inherit", checked: current === 'inherit', onChange: () => onChange('inherit') }), inheritLabel] }), _jsxs("label", { className: "db-settings-radio", children: [_jsx("input", { type: "radio", name: "ws-versioning", value: "on", checked: current === 'on', onChange: () => onChange('on') }), "On for this workspace"] }), _jsxs("label", { className: "db-settings-radio", children: [_jsx("input", { type: "radio", name: "ws-versioning", value: "off", checked: current === 'off', onChange: () => onChange('off') }), "Off for this workspace"] })] })] })] }) }));
+}
+//# sourceMappingURL=WorkspaceSettingsDialog.js.map

package/dist/WorkspacePicker/WorkspaceSettingsDialog.js.map

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

package/dist/hooks/useAutoSave.d.ts

@@ -2,8 +2,14 @@
  * 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 type { FileSystemProvider } from '@bendyline/docblocks/filesystem';
-export declare function useAutoSave(provider: FileSystemProvider | null, filePath: string | null, content: string, delayMs?: number): void;
+export interface UseAutoSaveResult {
+    /** Cancel any pending debounce and write the current content immediately. */
+    flush: () => Promise<void>;
+}
+export declare function useAutoSave(provider: FileSystemProvider | null, filePath: string | null, content: string, delayMs?: number, onSaved?: (filePath: string, content: string) => void): UseAutoSaveResult;
 //# sourceMappingURL=useAutoSave.d.ts.map

package/dist/hooks/useAutoSave.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAutoSave.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutoSave.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,wBAAgB,WAAW,CACzB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,SAAM,GACZ,IAAI,CA0CN"}
+{"version":3,"file":"useAutoSave.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutoSave.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,SAAM,EACb,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACpD,iBAAiB,CA4FnB"}

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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAQvD,MAAM,UAAU,WAAW,CACzB,QAAmC,EACnC,QAAuB,EACvB,OAAe,EACf,OAAO,GAAG,GAAG,EACb,OAAqD;IAErD,MAAM,QAAQ,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,CAId,IAAI,CAAC,CAAC;IAEhB,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAClC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EACH,MAIC,EACD,WAAmB,EACnB,EAAE;QACF,IAAI,WAAW,KAAK,MAAM,CAAC,SAAS;YAAE,OAAO;QAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,MAAM,CAAC,SAAS,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC9D,UAAU,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC;YAC5B,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,EACD,EAAE,CACH,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAC/B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAC/B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,EAAE,CAAC;QACb,SAAS,CAAC,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7F,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,UAAU,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;YACjC,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACtE,CAAC;YACD,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;QACF,yEAAyE;QACzE,2DAA2D;QAC3D,uDAAuD;IACzD,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,UAAU,EAAE,CAAC;QAEb,IAAI,OAAO,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACjC,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC;gBACxC,IAAI,CAAC,aAAa;oBAAE,OAAO;gBAC3B,KAAK,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC7E,CAAC,EAAE,OAAO,CAAC,CAAC;QACd,CAAC;QAED,OAAO,GAAG,EAAE;YACV,UAAU,EAAE,CAAC;QACf,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAEhD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACnC,UAAU,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9B,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/icons.d.ts

@@ -2,5 +2,6 @@ import type { SVGProps } from 'react';
 export declare function NewFileIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 export declare function NewFolderIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 export declare function RefreshIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+export declare function MoreIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 export declare function WorkspaceIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=icons.d.ts.map

package/dist/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAatC,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAYzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAU3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAOzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAW3D"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAatC,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAYzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAU3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAOzD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAQtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAW3D"}

package/dist/icons.js

@@ -18,6 +18,9 @@ export function NewFolderIcon(props) {
 export function RefreshIcon(props) {
     return (_jsxs("svg", { ...defaults, ...props, children: [_jsx("path", { d: "M13.5 8A5.5 5.5 0 1 1 8 2.5" }), _jsx("polyline", { points: "13.5 3 13.5 6.5 10 6.5" })] }));
 }
+export function MoreIcon(props) {
+    return (_jsxs("svg", { ...defaults, ...props, children: [_jsx("circle", { cx: "3.5", cy: "8", r: "1", fill: "currentColor", stroke: "none" }), _jsx("circle", { cx: "8", cy: "8", r: "1", fill: "currentColor", stroke: "none" }), _jsx("circle", { cx: "12.5", cy: "8", r: "1", fill: "currentColor", stroke: "none" })] }));
+}
 export function WorkspaceIcon(props) {
     return (_jsxs("svg", { ...defaults, ...props, children: [_jsx("rect", { x: "1.5", y: "2.5", width: "13", height: "11", rx: "1" }), _jsx("rect", { x: "4", y: "4.5", width: "8", height: "7", rx: "0.5" }), _jsx("line", { x1: "6.5", y1: "5.5", x2: "6.5", y2: "10.5", strokeWidth: "1" }), _jsx("line", { x1: "9.5", y1: "5.5", x2: "9.5", y2: "10.5", strokeWidth: "1" })] }));
 }

package/dist/icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.tsx"],"names":[],"mappings":";AAEA,MAAM,QAAQ,GAA4B;IACxC,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,cAAc;IACtB,WAAW,EAAE,GAAG;IAChB,aAAa,EAAE,OAAgB;IAC/B,cAAc,EAAE,OAAgB;CACjC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAE1B,eAAM,CAAC,EAAC,uEAAuE,GAAG,EAElF,eAAM,CAAC,EAAC,eAAe,GAAG,EAE1B,eAAM,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,IAAI,GAAG,EAC1C,eAAM,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,MAAM,GAAG,IACrC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAE1B,eAAM,CAAC,EAAC,sFAAsF,GAAG,EAEjG,eAAM,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,KAAK,GAAG,EACzC,eAAM,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,MAAM,GAAG,IACrC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAC1B,eAAM,CAAC,EAAC,6BAA6B,GAAG,EACxC,mBAAU,MAAM,EAAC,wBAAwB,GAAG,IACxC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAE1B,eAAM,CAAC,EAAC,KAAK,EAAC,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,EAAE,EAAC,GAAG,GAAG,EAEtD,eAAM,CAAC,EAAC,GAAG,EAAC,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,GAAG,EAAC,MAAM,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,GAAG,EACpD,eAAM,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,MAAM,EAAC,WAAW,EAAC,GAAG,GAAG,EAC7D,eAAM,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,MAAM,EAAC,WAAW,EAAC,GAAG,GAAG,IACzD,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.tsx"],"names":[],"mappings":";AAEA,MAAM,QAAQ,GAA4B;IACxC,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,cAAc;IACtB,WAAW,EAAE,GAAG;IAChB,aAAa,EAAE,OAAgB;IAC/B,cAAc,EAAE,OAAgB;CACjC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAE1B,eAAM,CAAC,EAAC,uEAAuE,GAAG,EAElF,eAAM,CAAC,EAAC,eAAe,GAAG,EAE1B,eAAM,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,IAAI,GAAG,EAC1C,eAAM,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,MAAM,GAAG,IACrC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAE1B,eAAM,CAAC,EAAC,sFAAsF,GAAG,EAEjG,eAAM,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,KAAK,GAAG,EACzC,eAAM,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,MAAM,GAAG,IACrC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAC1B,eAAM,CAAC,EAAC,6BAA6B,GAAG,EACxC,mBAAU,MAAM,EAAC,wBAAwB,GAAG,IACxC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAA8B;IACrD,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAC1B,iBAAQ,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,GAAG,EAAC,CAAC,EAAC,GAAG,EAAC,IAAI,EAAC,cAAc,EAAC,MAAM,EAAC,MAAM,GAAG,EAClE,iBAAQ,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,GAAG,EAAC,CAAC,EAAC,GAAG,EAAC,IAAI,EAAC,cAAc,EAAC,MAAM,EAAC,MAAM,GAAG,EAChE,iBAAQ,EAAE,EAAC,MAAM,EAAC,EAAE,EAAC,GAAG,EAAC,CAAC,EAAC,GAAG,EAAC,IAAI,EAAC,cAAc,EAAC,MAAM,EAAC,MAAM,GAAG,IAC/D,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,OAAO,CACL,kBAAS,QAAQ,KAAM,KAAK,aAE1B,eAAM,CAAC,EAAC,KAAK,EAAC,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,EAAE,EAAC,GAAG,GAAG,EAEtD,eAAM,CAAC,EAAC,GAAG,EAAC,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,GAAG,EAAC,MAAM,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,GAAG,EACpD,eAAM,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,MAAM,EAAC,WAAW,EAAC,GAAG,GAAG,EAC7D,eAAM,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,MAAM,EAAC,WAAW,EAAC,GAAG,GAAG,IACzD,CACP,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export type { WorkspacePickerProps } from './WorkspacePicker/index.js';
 export { DocBlocksShell } from './DocBlocksShell/index.js';
 export type { DocBlocksShellProps } from './DocBlocksShell/index.js';
 export { AppMenu } from './AppMenu/index.js';
-export type { AppMenuProps } from './AppMenu/index.js';
+export type { AppMenuProps, ThemePreference } from './AppMenu/index.js';
 export { ExportToolbarControls } from './Export/index.js';
 export type { ExportToolbarControlsProps, ExportFormat, ExportOptions } from './Export/index.js';
 export { ExportDialog } from './Export/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,0BAA0B,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,0BAA0B,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

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.0.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.0.0",
-    "@bendyline/squisq": "1.2.1",
-    "@bendyline/squisq-editor-react": "1.2.1",
-    "@bendyline/squisq-formats": "1.2.1",
-    "@bendyline/squisq-react": "1.1.1",
-    "@bendyline/squisq-video": "1.0.3",
-    "@bendyline/squisq-video-react": "1.0.3",
+    "@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",