@bendyline/docblocks-react 1.1.2 → 2.0.0

package/dist/export/index.js

@@ -0,0 +1,26 @@
+import {
+  ExportDialog
+} from "../chunk-AOVTHZU7.js";
+import {
+  buildExportFilename,
+  runExport
+} from "../chunk-ZI56BNB7.js";
+import "../chunk-4XXSWN3T.js";
+import {
+  DEFAULT_OPTIONS,
+  FORMAT_EXTENSIONS,
+  FORMAT_LABELS,
+  loadLastExportOptions,
+  saveExportOptions
+} from "../chunk-DD4VFJQI.js";
+export {
+  DEFAULT_OPTIONS,
+  ExportDialog,
+  FORMAT_EXTENSIONS,
+  FORMAT_LABELS,
+  buildExportFilename,
+  loadLastExportOptions,
+  runExport,
+  saveExportOptions
+};
+//# sourceMappingURL=index.js.map

package/dist/export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hooks/index.d.ts

@@ -1,2 +1,3 @@
-export { useAutoSave } from './useAutoSave.js';
+export { useDocumentSession } from './useDocumentSession.js';
+export type { UseDocumentSessionResult } from './useDocumentSession.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/hooks/index.js

@@ -1,2 +1,2 @@
-export { useAutoSave } from './useAutoSave.js';
+export { useDocumentSession } from './useDocumentSession.js';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/hooks/useDocumentSession.d.ts

@@ -0,0 +1,16 @@
+import { DocumentSession, type DocumentSessionSnapshot } from '@bendyline/docblocks/document';
+export interface UseDocumentSessionResult {
+    /** Stable controller for the lifetime of the mounted shell/panel. */
+    session: DocumentSession;
+    /** React snapshot of dirty/saving/saved/error/conflict state. */
+    snapshot: DocumentSessionSnapshot;
+}
+/**
+ * React binding for the framework-neutral DocumentSession engine.
+ *
+ * The hook deliberately does not infer target transitions from props.
+ * Callers must use transitionTo(), retarget(), or delete() before changing
+ * their view state so persistence ordering remains explicit.
+ */
+export declare function useDocumentSession(autoSaveDelayMs?: number): UseDocumentSessionResult;
+//# sourceMappingURL=useDocumentSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentSession.d.ts","sourceRoot":"","sources":["../../src/hooks/useDocumentSession.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,eAAe,EAEf,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,OAAO,EAAE,eAAe,CAAC;IACzB,iEAAiE;IACjE,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,SAAM,GAAG,wBAAwB,CAclF"}

package/dist/hooks/useDocumentSession.js

@@ -0,0 +1,18 @@
+import { useState, useSyncExternalStore } from 'react';
+import { DocumentRecoveryJournal, DocumentSession, getDefaultDocumentRecoveryStorage, } from '@bendyline/docblocks/document';
+/**
+ * React binding for the framework-neutral DocumentSession engine.
+ *
+ * The hook deliberately does not infer target transitions from props.
+ * Callers must use transitionTo(), retarget(), or delete() before changing
+ * their view state so persistence ordering remains explicit.
+ */
+export function useDocumentSession(autoSaveDelayMs = 500) {
+    const [session] = useState(() => new DocumentSession({
+        autoSaveDelayMs,
+        recoveryJournal: new DocumentRecoveryJournal(getDefaultDocumentRecoveryStorage()),
+    }));
+    const snapshot = useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot);
+    return { session, snapshot };
+}
+//# sourceMappingURL=useDocumentSession.js.map

package/dist/hooks/useDocumentSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentSession.js","sourceRoot":"","sources":["../../src/hooks/useDocumentSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,iCAAiC,GAElC,MAAM,+BAA+B,CAAC;AASvC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,eAAe,GAAG,GAAG;IACtD,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CACxB,GAAG,EAAE,CACH,IAAI,eAAe,CAAC;QAClB,eAAe;QACf,eAAe,EAAE,IAAI,uBAAuB,CAAC,iCAAiC,EAAE,CAAC;KAClF,CAAC,CACL,CAAC;IACF,MAAM,QAAQ,GAAG,oBAAoB,CACnC,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,WAAW,CACpB,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/icons.d.ts

@@ -1,7 +1,12 @@
-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;
+/**
+ * DocBlocks shell icons use the Font Awesome Free webfont bundled by
+ * `@bendyline/squisq-editor-react/styles`. Controls provide the accessible
+ * name, so the glyphs themselves stay decorative.
+ */
+export declare function NewFileIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function NewFolderIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function FolderIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function MoreIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function WorkspaceIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function SplitViewIcon(): 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,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,2CAQtD;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;;;;GAIG;AAMH,wBAAgB,WAAW,4CAE1B;AAED,wBAAgB,aAAa,4CAE5B;AAED,wBAAgB,UAAU,4CAEzB;AAED,wBAAgB,QAAQ,4CAEvB;AAED,wBAAgB,aAAa,4CAE5B;AAED,wBAAgB,aAAa,4CAiB5B"}

package/dist/icons.js

@@ -1,27 +1,28 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-const defaults = {
-    width: 16,
-    height: 16,
-    viewBox: '0 0 16 16',
-    fill: 'none',
-    stroke: 'currentColor',
-    strokeWidth: 1.5,
-    strokeLinecap: 'round',
-    strokeLinejoin: 'round',
-};
-export function NewFileIcon(props) {
-    return (_jsxs("svg", { ...defaults, ...props, children: [_jsx("path", { d: "M9.5 1.5H4a1 1 0 0 0-1 1v11a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1V5l-3.5-3.5Z" }), _jsx("path", { d: "M9.5 1.5V5H13" }), _jsx("line", { x1: "6.5", y1: "10", x2: "9.5", y2: "10" }), _jsx("line", { x1: "8", y1: "8.5", x2: "8", y2: "11.5" })] }));
+/**
+ * DocBlocks shell icons use the Font Awesome Free webfont bundled by
+ * `@bendyline/squisq-editor-react/styles`. Controls provide the accessible
+ * name, so the glyphs themselves stay decorative.
+ */
+function FontAwesomeIcon({ icon }) {
+    return _jsx("i", { className: icon, "aria-hidden": "true" });
 }
-export function NewFolderIcon(props) {
-    return (_jsxs("svg", { ...defaults, ...props, children: [_jsx("path", { d: "M2 3.5a1 1 0 0 1 1-1h3l1.5 1.5H13a1 1 0 0 1 1 1v7a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5Z" }), _jsx("line", { x1: "6", y1: "8.5", x2: "10", y2: "8.5" }), _jsx("line", { x1: "8", y1: "6.5", x2: "8", y2: "10.5" })] }));
+export function NewFileIcon() {
+    return _jsx(FontAwesomeIcon, { icon: "fa-solid fa-file-circle-plus" });
 }
-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 NewFolderIcon() {
+    return _jsx(FontAwesomeIcon, { icon: "fa-solid fa-folder-plus" });
 }
-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 FolderIcon() {
+    return _jsx(FontAwesomeIcon, { icon: "fa-solid fa-folder" });
 }
-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" })] }));
+export function MoreIcon() {
+    return _jsx(FontAwesomeIcon, { icon: "fa-solid fa-ellipsis" });
+}
+export function WorkspaceIcon() {
+    return _jsx(FontAwesomeIcon, { icon: "fa-solid fa-gear" });
+}
+export function SplitViewIcon() {
+    return (_jsxs("svg", { width: "16", height: "16", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", 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" })] }));
 }
 //# sourceMappingURL=icons.js.map

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,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"}
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,SAAS,eAAe,CAAC,EAAE,IAAI,EAAoB;IACjD,OAAO,YAAG,SAAS,EAAE,IAAI,iBAAc,MAAM,GAAG,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,KAAC,eAAe,IAAC,IAAI,EAAC,8BAA8B,GAAG,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAC,eAAe,IAAC,IAAI,EAAC,yBAAyB,GAAG,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,KAAC,eAAe,IAAC,IAAI,EAAC,oBAAoB,GAAG,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,KAAC,eAAe,IAAC,IAAI,EAAC,sBAAsB,GAAG,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAC,eAAe,IAAC,IAAI,EAAC,kBAAkB,GAAG,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CACL,eACE,KAAK,EAAC,IAAI,EACV,MAAM,EAAC,IAAI,EACX,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACV,MAAM,aAElB,eAAM,CAAC,EAAC,KAAK,EAAC,CAAC,EAAC,KAAK,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,EAAE,EAAC,GAAG,GAAG,EACtD,eAAM,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,KAAK,EAAC,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,MAAM,GAAG,IACrC,CACP,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * @bendyline/docblocks-react — React components for DocBlocks
  */
 export { FileExplorer } from './FileExplorer/index.js';
-export type { FileExplorerProps } from './FileExplorer/index.js';
+export type { FileExplorerProps, FileTreeChange, FileTreeMutationHandler, } from './FileExplorer/index.js';
 export { FileTreeNode } from './FileExplorer/index.js';
 export type { FileTreeNodeProps } from './FileExplorer/index.js';
 export { useFileTree } from './FileExplorer/index.js';
@@ -11,10 +11,13 @@ 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, ThemePreference } from './AppMenu/index.js';
-export { ExportToolbarControls } from './Export/index.js';
-export type { ExportToolbarControlsProps, ExportFormat, ExportOptions } from './Export/index.js';
+export type { AccentColor, AppMenuProps, ThemePreference } from './AppMenu/index.js';
+export { AccentColorSettings, SettingsDialog, ThemeSettings } from './Settings/public-api.js';
+export type { AccentColorSettingsProps, SettingsDialogProps, ThemeSettingsProps, } from './Settings/public-api.js';
+export { buildExportFilename, DEFAULT_OPTIONS, loadLastExportOptions, runExport, updateExportTargetExtension, ExportToolbarControls, } from './Export/index.js';
+export type { ExportDestinationControl, ExportDestinationAdapter, ExportDestinationTarget, ExportToolbarControlsProps, ExportFormat, HtmlBundle, HtmlStyle, ExportOptions, ExportBlobSaver, } from './Export/index.js';
 export { ExportDialog } from './Export/index.js';
 export type { ExportDialogProps } from './Export/index.js';
-export { useAutoSave } from './hooks/index.js';
+export { useDocumentSession } from './hooks/index.js';
+export type { UseDocumentSessionResult } from './hooks/index.js';
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"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,EACV,iBAAiB,EACjB,cAAc,EACd,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,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,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,EACZ,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -11,9 +11,11 @@ export { WorkspacePicker } from './WorkspacePicker/index.js';
 export { DocBlocksShell } from './DocBlocksShell/index.js';
 // AppMenu
 export { AppMenu } from './AppMenu/index.js';
+// Settings
+export { AccentColorSettings, SettingsDialog, ThemeSettings } from './Settings/public-api.js';
 // Export
-export { ExportToolbarControls } from './Export/index.js';
+export { buildExportFilename, DEFAULT_OPTIONS, loadLastExportOptions, runExport, updateExportTargetExtension, ExportToolbarControls, } from './Export/index.js';
 export { ExportDialog } from './Export/index.js';
 // Hooks
-export { useAutoSave } from './hooks/index.js';
+export { useDocumentSession } from './hooks/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,SAAS;AACT,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,WAAW;AACX,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAO9F,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAY3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/preferences/theme.d.ts

@@ -0,0 +1,18 @@
+/** Appearance preferences shared by the shell and settings UI. */
+export type ThemePreference = 'auto' | 'light' | 'dark';
+export declare const ACCENT_COLORS: readonly ["brown", "green", "blue", "purple", "maroon", "orange", "gray"];
+export type AccentColor = (typeof ACCENT_COLORS)[number];
+/**
+ * Chrome (titlebar) background per resolved theme. Keep in sync with
+ * `--db-bg-subtle` for the default accent in styles/docblocks.css and with
+ * the static `<meta name="theme-color">` values in the site's index.html.
+ * The shell writes these into the theme-color metas so the installed web
+ * app's titlebar (Window Controls Overlay caption area, Android status bar)
+ * follows the resolved theme.
+ */
+export declare const DB_CHROME_COLORS: Record<'light' | 'dark', string>;
+export declare function loadThemePreference(): ThemePreference;
+export declare function saveThemePreference(value: ThemePreference): void;
+export declare function loadAccentColor(): AccentColor;
+export declare function saveAccentColor(value: AccentColor): void;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/preferences/theme.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,eAAO,MAAM,aAAa,2EAQhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,MAAM,CAG7D,CAAC;AAKF,wBAAgB,mBAAmB,IAAI,eAAe,CAQrD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAMhE;AAED,wBAAgB,eAAe,IAAI,WAAW,CAQ7C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAMxD"}

package/dist/preferences/theme.js

@@ -0,0 +1,63 @@
+/** Appearance preferences shared by the shell and settings UI. */
+export const ACCENT_COLORS = [
+    'brown',
+    'green',
+    'blue',
+    'purple',
+    'maroon',
+    'orange',
+    'gray',
+];
+/**
+ * Chrome (titlebar) background per resolved theme. Keep in sync with
+ * `--db-bg-subtle` for the default accent in styles/docblocks.css and with
+ * the static `<meta name="theme-color">` values in the site's index.html.
+ * The shell writes these into the theme-color metas so the installed web
+ * app's titlebar (Window Controls Overlay caption area, Android status bar)
+ * follows the resolved theme.
+ */
+export const DB_CHROME_COLORS = {
+    light: '#f3eede',
+    dark: '#262219',
+};
+const THEME_STORAGE_KEY = 'docblocks:themePreference';
+const ACCENT_STORAGE_KEY = 'docblocks:accentColor';
+export function loadThemePreference() {
+    try {
+        const raw = localStorage.getItem(THEME_STORAGE_KEY);
+        if (raw === 'light' || raw === 'dark' || raw === 'auto')
+            return raw;
+    }
+    catch {
+        // ignore unavailable storage
+    }
+    return 'auto';
+}
+export function saveThemePreference(value) {
+    try {
+        localStorage.setItem(THEME_STORAGE_KEY, value);
+    }
+    catch {
+        // ignore quota errors
+    }
+}
+export function loadAccentColor() {
+    try {
+        const raw = localStorage.getItem(ACCENT_STORAGE_KEY);
+        if (ACCENT_COLORS.some((color) => color === raw))
+            return raw;
+    }
+    catch {
+        // ignore unavailable storage
+    }
+    return 'brown';
+}
+export function saveAccentColor(value) {
+    try {
+        localStorage.setItem(ACCENT_STORAGE_KEY, value);
+    }
+    catch {
+        // ignore quota errors
+    }
+}
+//# sourceMappingURL=theme.js.map

package/dist/preferences/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/preferences/theme.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAIlE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,MAAM;CACE,CAAC;AAIX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AACtD,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAEnD,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACpD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,GAAG,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACrD,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC;YAAE,OAAO,GAAkB,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC"}

package/dist/provider-lease.d.ts

@@ -0,0 +1,10 @@
+import type { FileSystemProviderV2 } from '@bendyline/docblocks/filesystem';
+/**
+ * Retain one UI ownership lease for a provider.
+ *
+ * Final release is deferred by one microtask. React Strict Mode intentionally
+ * performs setup → cleanup → setup, so an immediate cleanup disposer would
+ * permanently close the provider that the second setup still owns.
+ */
+export declare function retainFileSystemProvider(provider: FileSystemProviderV2): () => void;
+//# sourceMappingURL=provider-lease.d.ts.map

package/dist/provider-lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-lease.d.ts","sourceRoot":"","sources":["../src/provider-lease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAU5E;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAkCnF"}

package/dist/provider-lease.js

@@ -0,0 +1,42 @@
+const leases = new WeakMap();
+/**
+ * Retain one UI ownership lease for a provider.
+ *
+ * Final release is deferred by one microtask. React Strict Mode intentionally
+ * performs setup → cleanup → setup, so an immediate cleanup disposer would
+ * permanently close the provider that the second setup still owns.
+ */
+export function retainFileSystemProvider(provider) {
+    let record = leases.get(provider);
+    if (!record) {
+        record = { holders: 0, generation: 0, disposePromise: null };
+        leases.set(provider, record);
+    }
+    if (record.disposePromise) {
+        throw new Error('Cannot retain a filesystem provider after disposal has started.');
+    }
+    record.holders += 1;
+    record.generation += 1;
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        record.holders -= 1;
+        record.generation += 1;
+        const releaseGeneration = record.generation;
+        queueMicrotask(() => {
+            if (record.holders !== 0 ||
+                record.generation !== releaseGeneration ||
+                record.disposePromise) {
+                return;
+            }
+            record.disposePromise = provider.dispose();
+            // React cleanup cannot await or render a disposal failure. Joiners still
+            // receive the original promise from the provider; this observer prevents
+            // an unhandled rejection during unmount.
+            void record.disposePromise.catch(() => undefined);
+        });
+    };
+}
+//# sourceMappingURL=provider-lease.js.map

package/dist/provider-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-lease.js","sourceRoot":"","sources":["../src/provider-lease.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,GAAG,IAAI,OAAO,EAA6C,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA8B;IACrE,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;IACpB,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IACvB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QACrB,MAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QACxB,MAAM,iBAAiB,GAAG,MAAO,CAAC,UAAU,CAAC;QAC7C,cAAc,CAAC,GAAG,EAAE;YAClB,IACE,MAAO,CAAC,OAAO,KAAK,CAAC;gBACrB,MAAO,CAAC,UAAU,KAAK,iBAAiB;gBACxC,MAAO,CAAC,cAAc,EACtB,CAAC;gBACD,OAAO;YACT,CAAC;YACD,MAAO,CAAC,cAAc,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC5C,yEAAyE;YACzE,yEAAyE;YACzE,yCAAyC;YACzC,KAAK,MAAO,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/run-export-ICTZITXC.js

@@ -0,0 +1,10 @@
+import {
+  buildExportFilename,
+  runExport
+} from "./chunk-ZI56BNB7.js";
+import "./chunk-DD4VFJQI.js";
+export {
+  buildExportFilename,
+  runExport
+};
+//# sourceMappingURL=run-export-ICTZITXC.js.map

package/dist/run-export-ICTZITXC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/settings/index.d.ts

@@ -0,0 +1,28 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/** Appearance preferences shared by the shell and settings UI. */
+type ThemePreference = 'auto' | 'light' | 'dark';
+declare const ACCENT_COLORS: readonly ["brown", "green", "blue", "purple", "maroon", "orange", "gray"];
+type AccentColor = (typeof ACCENT_COLORS)[number];
+
+interface SettingsDialogProps {
+    title?: string;
+    onClose: () => void;
+    children: ReactNode;
+}
+declare function SettingsDialog({ title, onClose, children }: SettingsDialogProps): react_jsx_runtime.JSX.Element;
+interface ThemeSettingsProps {
+    value: ThemePreference;
+    onChange: (theme: ThemePreference) => void;
+    name?: string;
+}
+declare function ThemeSettings({ value, onChange, name }: ThemeSettingsProps): react_jsx_runtime.JSX.Element;
+interface AccentColorSettingsProps {
+    value: AccentColor;
+    onChange: (color: AccentColor) => void;
+    name?: string;
+}
+declare function AccentColorSettings({ value, onChange, name, }: AccentColorSettingsProps): react_jsx_runtime.JSX.Element;
+
+export { type AccentColor, AccentColorSettings, type AccentColorSettingsProps, SettingsDialog, type SettingsDialogProps, type ThemePreference, ThemeSettings, type ThemeSettingsProps };

package/dist/settings/index.js

@@ -0,0 +1,12 @@
+import {
+  AccentColorSettings,
+  SettingsDialog,
+  ThemeSettings
+} from "../chunk-3SAXDU2U.js";
+import "../chunk-GSNZSCIK.js";
+export {
+  AccentColorSettings,
+  SettingsDialog,
+  ThemeSettings
+};
+//# sourceMappingURL=index.js.map

package/dist/settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks-react",
-  "version": "1.1.2",
+  "version": "2.0.0",
   "description": "React components for DocBlocks — file explorer, workspace picker, and editor shell",
   "license": "MIT",
   "author": "Bendyline",
@@ -34,6 +34,21 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./export": {
+      "types": "./dist/export/index.d.ts",
+      "import": "./dist/export/index.js",
+      "default": "./dist/export/index.js"
+    },
+    "./settings": {
+      "types": "./dist/settings/index.d.ts",
+      "import": "./dist/settings/index.js",
+      "default": "./dist/settings/index.js"
+    },
+    "./editor": {
+      "types": "./dist/editor.d.ts",
+      "import": "./dist/editor.js",
+      "default": "./dist/editor.js"
+    },
     "./styles": "./src/styles/docblocks.css"
   },
   "scripts": {
@@ -45,14 +60,14 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@bendyline/docblocks": "1.1.2",
-    "@bendyline/squisq": "1.5.1",
-    "@bendyline/squisq-editor-react": "1.6.1",
-    "@bendyline/squisq-formats": "1.4.1",
-    "@bendyline/squisq-react": "1.4.1",
-    "@bendyline/squisq-video": "1.2.1",
-    "@bendyline/squisq-video-react": "1.2.1",
-    "monaco-editor": "0.53.0"
+    "@bendyline/docblocks": "2.0.0",
+    "@bendyline/squisq": "2.0.1",
+    "@bendyline/squisq-editor-react": "2.0.1",
+    "@bendyline/squisq-formats": "2.0.1",
+    "@bendyline/squisq-react": "2.0.1",
+    "@bendyline/squisq-video": "2.0.1",
+    "@bendyline/squisq-video-react": "2.0.1",
+    "monaco-editor": "0.50.0"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "20.9.0",