@bendyline/docblocks-react 1.1.2 → 2.0.0

package/src/index.ts

@@ -4,7 +4,11 @@
 
 // FileExplorer
 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';
@@ -19,13 +23,39 @@ export type { DocBlocksShellProps } from './DocBlocksShell/index.js';
 
 // AppMenu
 export { AppMenu } from './AppMenu/index.js';
-export type { AppMenuProps, ThemePreference } from './AppMenu/index.js';
+export type { AccentColor, AppMenuProps, ThemePreference } from './AppMenu/index.js';
+
+// Settings
+export { AccentColorSettings, SettingsDialog, ThemeSettings } from './Settings/public-api.js';
+export type {
+  AccentColorSettingsProps,
+  SettingsDialogProps,
+  ThemeSettingsProps,
+} from './Settings/public-api.js';
 
 // Export
-export { ExportToolbarControls } from './Export/index.js';
-export type { ExportToolbarControlsProps, ExportFormat, ExportOptions } from './Export/index.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';
 
 // Hooks
-export { useAutoSave } from './hooks/index.js';
+export { useDocumentSession } from './hooks/index.js';
+export type { UseDocumentSessionResult } from './hooks/index.js';

package/src/preferences/theme.ts

@@ -0,0 +1,67 @@
+/** Appearance preferences shared by the shell and settings UI. */
+
+export type ThemePreference = 'auto' | 'light' | 'dark';
+
+export const ACCENT_COLORS = [
+  'brown',
+  'green',
+  'blue',
+  'purple',
+  'maroon',
+  'orange',
+  'gray',
+] as const;
+
+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 const DB_CHROME_COLORS: Record<'light' | 'dark', string> = {
+  light: '#f3eede',
+  dark: '#262219',
+};
+
+const THEME_STORAGE_KEY = 'docblocks:themePreference';
+const ACCENT_STORAGE_KEY = 'docblocks:accentColor';
+
+export function loadThemePreference(): ThemePreference {
+  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: ThemePreference): void {
+  try {
+    localStorage.setItem(THEME_STORAGE_KEY, value);
+  } catch {
+    // ignore quota errors
+  }
+}
+
+export function loadAccentColor(): AccentColor {
+  try {
+    const raw = localStorage.getItem(ACCENT_STORAGE_KEY);
+    if (ACCENT_COLORS.some((color) => color === raw)) return raw as AccentColor;
+  } catch {
+    // ignore unavailable storage
+  }
+  return 'brown';
+}
+
+export function saveAccentColor(value: AccentColor): void {
+  try {
+    localStorage.setItem(ACCENT_STORAGE_KEY, value);
+  } catch {
+    // ignore quota errors
+  }
+}

package/src/provider-lease.ts

@@ -0,0 +1,52 @@
+import type { FileSystemProviderV2 } from '@bendyline/docblocks/filesystem';
+
+interface ProviderLeaseRecord {
+  holders: number;
+  generation: number;
+  disposePromise: Promise<void> | null;
+}
+
+const leases = new WeakMap<FileSystemProviderV2, ProviderLeaseRecord>();
+
+/**
+ * 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: FileSystemProviderV2): () => void {
+  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);
+    });
+  };
+}