npm - @bendyline/docblocks-react - Versions diffs - 1.0.0 → 1.1.1 - Mend

@bendyline/docblocks-react 1.0.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (133) hide show

package/dist/AppMenu/AppMenu.d.ts +16 -1
package/dist/AppMenu/AppMenu.d.ts.map +1 -1
package/dist/AppMenu/AppMenu.js +3 -2
package/dist/AppMenu/AppMenu.js.map +1 -1
package/dist/AppMenu/index.d.ts +1 -1
package/dist/AppMenu/index.d.ts.map +1 -1
package/dist/DocBlocksShell/DocBlocksShell.d.ts +21 -1
package/dist/DocBlocksShell/DocBlocksShell.d.ts.map +1 -1
package/dist/DocBlocksShell/DocBlocksShell.js +930 -98
package/dist/DocBlocksShell/DocBlocksShell.js.map +1 -1
package/dist/Export/ExportDialog.d.ts.map +1 -1
package/dist/Export/ExportDialog.js +104 -5
package/dist/Export/ExportDialog.js.map +1 -1
package/dist/Export/ExportToolbarControls.d.ts.map +1 -1
package/dist/Export/ExportToolbarControls.js +44 -3
package/dist/Export/ExportToolbarControls.js.map +1 -1
package/dist/Export/export-options.d.ts +35 -0
package/dist/Export/export-options.d.ts.map +1 -1
package/dist/Export/export-options.js +6 -1
package/dist/Export/export-options.js.map +1 -1
package/dist/Export/run-export.d.ts.map +1 -1
package/dist/Export/run-export.js +163 -91
package/dist/Export/run-export.js.map +1 -1
package/dist/FileExplorer/FileExplorer.d.ts.map +1 -1
package/dist/FileExplorer/FileExplorer.js +17 -2
package/dist/FileExplorer/FileExplorer.js.map +1 -1
package/dist/FileExplorer/FileTreeNode.d.ts.map +1 -1
package/dist/FileExplorer/FileTreeNode.js +34 -8
package/dist/FileExplorer/FileTreeNode.js.map +1 -1
package/dist/WorkspacePicker/WorkspacePicker.d.ts.map +1 -1
package/dist/WorkspacePicker/WorkspacePicker.js +9 -3
package/dist/WorkspacePicker/WorkspacePicker.js.map +1 -1
package/dist/WorkspacePicker/WorkspaceSettingsButton.d.ts +2 -1
package/dist/WorkspacePicker/WorkspaceSettingsButton.d.ts.map +1 -1
package/dist/WorkspacePicker/WorkspaceSettingsButton.js +2 -2
package/dist/WorkspacePicker/WorkspaceSettingsButton.js.map +1 -1
package/dist/WorkspacePicker/WorkspaceSettingsDialog.d.ts +20 -0
package/dist/WorkspacePicker/WorkspaceSettingsDialog.d.ts.map +1 -0
package/dist/WorkspacePicker/WorkspaceSettingsDialog.js +36 -0
package/dist/WorkspacePicker/WorkspaceSettingsDialog.js.map +1 -0
package/dist/hooks/useAutoSave.d.ts +8 -2
package/dist/hooks/useAutoSave.d.ts.map +1 -1
package/dist/hooks/useAutoSave.js +65 -30
package/dist/hooks/useAutoSave.js.map +1 -1
package/dist/icons.d.ts +1 -0
package/dist/icons.d.ts.map +1 -1
package/dist/icons.js +3 -0
package/dist/icons.js.map +1 -1
package/dist/index.d.ts +1 -1
package/dist/index.d.ts.map +1 -1
package/dist/preferences/versioning.d.ts +27 -0
package/dist/preferences/versioning.d.ts.map +1 -0
package/dist/preferences/versioning.js +62 -0
package/dist/preferences/versioning.js.map +1 -0
package/package.json +10 -8
package/src/AppMenu/AppMenu.tsx +142 -2
package/src/AppMenu/index.ts +1 -1
package/src/DocBlocksShell/DocBlocksShell.tsx +1194 -125
package/src/Export/ExportDialog.tsx +208 -19
package/src/Export/ExportToolbarControls.tsx +45 -3
package/src/Export/export-options.ts +43 -1
package/src/Export/run-export.ts +190 -91
package/src/FileExplorer/FileExplorer.tsx +31 -9
package/src/FileExplorer/FileTreeNode.tsx +68 -26
package/src/WorkspacePicker/WorkspacePicker.tsx +18 -7
package/src/WorkspacePicker/WorkspaceSettingsButton.tsx +9 -0
package/src/WorkspacePicker/WorkspaceSettingsDialog.tsx +121 -0
package/src/fonts/fonts.css +362 -0
package/src/fonts/licenses/LICENSE-cormorant-garamond.txt +93 -0
package/src/fonts/licenses/LICENSE-crimson-text.txt +93 -0
package/src/fonts/licenses/LICENSE-dm-sans.txt +93 -0
package/src/fonts/licenses/LICENSE-dm-serif-display.txt +93 -0
package/src/fonts/licenses/LICENSE-hanken-grotesk.txt +94 -0
package/src/fonts/licenses/LICENSE-ibm-plex-sans.txt +93 -0
package/src/fonts/licenses/LICENSE-inter.txt +93 -0
package/src/fonts/licenses/LICENSE-jetbrains-mono.txt +93 -0
package/src/fonts/licenses/LICENSE-lora.txt +93 -0
package/src/fonts/licenses/LICENSE-merriweather.txt +93 -0
package/src/fonts/licenses/LICENSE-oswald.txt +93 -0
package/src/fonts/licenses/LICENSE-playfair-display.txt +93 -0
package/src/fonts/licenses/LICENSE-pt-serif.txt +93 -0
package/src/fonts/licenses/LICENSE-roboto.txt +93 -0
package/src/fonts/licenses/LICENSE-source-serif-4.txt +93 -0
package/src/fonts/woff2/cormorant-garamond-400.woff2 +0 -0
package/src/fonts/woff2/cormorant-garamond-700.woff2 +0 -0
package/src/fonts/woff2/crimson-text-400.woff2 +0 -0
package/src/fonts/woff2/crimson-text-400i.woff2 +0 -0
package/src/fonts/woff2/crimson-text-700.woff2 +0 -0
package/src/fonts/woff2/dm-sans-400.woff2 +0 -0
package/src/fonts/woff2/dm-sans-400i.woff2 +0 -0
package/src/fonts/woff2/dm-sans-500.woff2 +0 -0
package/src/fonts/woff2/dm-sans-700.woff2 +0 -0
package/src/fonts/woff2/dm-serif-display-400.woff2 +0 -0
package/src/fonts/woff2/hanken-grotesk-400.woff2 +0 -0
package/src/fonts/woff2/hanken-grotesk-400i.woff2 +0 -0
package/src/fonts/woff2/hanken-grotesk-500.woff2 +0 -0
package/src/fonts/woff2/hanken-grotesk-600.woff2 +0 -0
package/src/fonts/woff2/hanken-grotesk-700.woff2 +0 -0
package/src/fonts/woff2/ibm-plex-sans-400.woff2 +0 -0
package/src/fonts/woff2/ibm-plex-sans-400i.woff2 +0 -0
package/src/fonts/woff2/ibm-plex-sans-500.woff2 +0 -0
package/src/fonts/woff2/ibm-plex-sans-600.woff2 +0 -0
package/src/fonts/woff2/ibm-plex-sans-700.woff2 +0 -0
package/src/fonts/woff2/inter-400.woff2 +0 -0
package/src/fonts/woff2/inter-400i.woff2 +0 -0
package/src/fonts/woff2/inter-500.woff2 +0 -0
package/src/fonts/woff2/inter-600.woff2 +0 -0
package/src/fonts/woff2/inter-700.woff2 +0 -0
package/src/fonts/woff2/jetbrains-mono-400.woff2 +0 -0
package/src/fonts/woff2/jetbrains-mono-400i.woff2 +0 -0
package/src/fonts/woff2/jetbrains-mono-700.woff2 +0 -0
package/src/fonts/woff2/lora-400.woff2 +0 -0
package/src/fonts/woff2/lora-400i.woff2 +0 -0
package/src/fonts/woff2/lora-700.woff2 +0 -0
package/src/fonts/woff2/merriweather-400.woff2 +0 -0
package/src/fonts/woff2/merriweather-700.woff2 +0 -0
package/src/fonts/woff2/oswald-400.woff2 +0 -0
package/src/fonts/woff2/oswald-700.woff2 +0 -0
package/src/fonts/woff2/playfair-display-400.woff2 +0 -0
package/src/fonts/woff2/playfair-display-700.woff2 +0 -0
package/src/fonts/woff2/pt-serif-400.woff2 +0 -0
package/src/fonts/woff2/pt-serif-700.woff2 +0 -0
package/src/fonts/woff2/roboto-400.woff2 +0 -0
package/src/fonts/woff2/roboto-400i.woff2 +0 -0
package/src/fonts/woff2/roboto-700.woff2 +0 -0
package/src/fonts/woff2/source-serif-4-400.woff2 +0 -0
package/src/fonts/woff2/source-serif-4-400i.woff2 +0 -0
package/src/fonts/woff2/source-serif-4-700.woff2 +0 -0
package/src/hooks/useAutoSave.ts +87 -29
package/src/icons.tsx +10 -0
package/src/index.ts +1 -1
package/src/preferences/versioning.ts +69 -0
package/src/styles/docblocks.css +1037 -55

package/src/Export/run-export.ts CHANGED Viewed

@@ -9,10 +9,22 @@ import type {
 } from '@bendyline/squisq/markdown';
 import { parseMarkdown } from '@bendyline/squisq/markdown';
 import { markdownToDoc } from '@bendyline/squisq/doc';
+import type { Doc } from '@bendyline/squisq/schemas';
 import { applyTransform } from '@bendyline/squisq/transform';
 import { markdownDocToDocx } from '@bendyline/squisq-formats/docx';
 import { markdownDocToPdf } from '@bendyline/squisq-formats/pdf';
 import { docToPptx } from '@bendyline/squisq-formats/pptx';
+import {
+  docToHtml,
+  docToHtmlZip,
+  collectImagePaths,
+  markdownDocsToPlainHtmlBundle,
+  markdownDocsToHtmlBundle,
+  markdownDocToPlainHtml,
+} from '@bendyline/squisq-formats/html';
+import { containerToZip } from '@bendyline/squisq-formats/container';
+import { MemoryContentContainer } from '@bendyline/squisq/storage';
+import { PLAYER_BUNDLE } from '@bendyline/squisq-react/standalone-source';
 import type { ContentContainer } from '@bendyline/squisq/storage';
 import type { ExportOptions, ExportFormat } from './export-options.js';
 import { FORMAT_EXTENSIONS } from './export-options.js';
@@ -57,8 +69,7 @@ export async function runExport(
   }
   if (options.format === 'html') {
-    const html = wrapMarkdownAsHtml(markdown);
-    downloadBlob(new Blob([html], { type: MIME_TYPES.html }), filename);
+    await runHtmlExport(markdown, filename, options, mediaContainer, selectedFile);
     return;
   }
@@ -94,94 +105,126 @@ export async function runExport(
   }
 }
-/** Wrap raw markdown in a basic styled HTML page. */
-function wrapMarkdownAsHtml(markdown: string): string {
-  // Convert markdown to simple HTML via the parser
-  const doc = parseMarkdown(markdown);
-  // Build a minimal representation from the parsed nodes
-  const lines: string[] = [];
-  for (const node of doc.children) {
-    lines.push(nodeToHtml(node));
-  }
-  const body = lines.join('\n');
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Document</title>
-<style>
-  body { font-family: system-ui, -apple-system, sans-serif; max-width: 800px; margin: 2em auto; padding: 0 1em; line-height: 1.6; color: #1f2937; }
-  h1, h2, h3, h4, h5, h6 { margin-top: 1.5em; margin-bottom: 0.5em; }
-  pre { background: #f3f4f6; padding: 1em; border-radius: 4px; overflow-x: auto; }
-  code { background: #f3f4f6; padding: 0.15em 0.3em; border-radius: 3px; font-size: 0.9em; }
-  pre code { background: none; padding: 0; }
-  blockquote { border-left: 3px solid #d1d5db; margin-left: 0; padding-left: 1em; color: #6b7280; }
-  img { max-width: 100%; }
-  a { color: #3b82f6; }
-</style>
-</head>
-<body>
-${body}
-</body>
-</html>`;
-}
+/** Run the HTML export branch — handles all four htmlStyle × htmlBundle combinations. */
+async function runHtmlExport(
+  markdown: string,
+  htmlFilename: string,
+  options: ExportOptions,
+  mediaContainer?: ContentContainer | null,
+  selectedFile?: string | null,
+): Promise<void> {
+  const baseName = htmlFilename.replace(/\.html$/, '');
+  const zipName = `${baseName}.zip`;
+  // When `entryAsIndex` is on, a single-doc HTML download lands on
+  // disk as `index.html` so it drops straight into a static host. The
+  // recursive ZIP path doesn't care — squisq's bundle helpers handle
+  // the inside-zip rename and the cross-doc link rewrite themselves.
+  const singleHtmlFilename = options.entryAsIndex ? 'index.html' : htmlFilename;
+  const themeId = options.themeId !== 'standard' ? options.themeId : undefined;
-/** Convert a markdown AST node to HTML (basic). */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function nodeToHtml(node: any): string {
-  if (!node) return '';
-  switch (node.type) {
-    case 'heading': {
-      const tag = `h${node.depth ?? 1}`;
-      return `<${tag}>${childrenToHtml(node)}</${tag}>`;
+  // Recursive HTML bundle: when the user opted in, ask squisq to walk
+  // this doc's relative .md links and emit a ZIP with every reachable
+  // page rendered + cross-doc hrefs rewritten. Two pipelines:
+  //   • Plain  → `markdownDocsToPlainHtmlBundle` (semantic HTML)
+  //   • Rendered → `markdownDocsToHtmlBundle` (SquisqPlayer-rendered,
+  //                shared `squisq-player.js`, Doc-tree link rewrites)
+  // Both consume the workspace container to resolve sibling files —
+  // `mediaContainer` is already scoped to the selected file's parent
+  // dir, which is exactly the bundle's scope root. Falls back to the
+  // single-doc path if either prerequisite is missing rather than
+  // silently skipping the recursion.
+  if (options.includeLinkedDocs && mediaContainer && selectedFile) {
+    const entryPath = basenameForBundle(selectedFile);
+    if (options.htmlStyle === 'rendered') {
+      const blob = await markdownDocsToHtmlBundle({
+        entryPath,
+        readDocument: (path) => readDocumentFromContainer(mediaContainer, path),
+        readBinary: (path) => mediaContainer.readFile(path),
+        playerScript: PLAYER_BUNDLE,
+        title: baseName,
+        themeId,
+        mode: 'static',
+        entryAsIndex: options.entryAsIndex,
+      });
+      downloadBlob(blob, zipName);
+      return;
     }
-    case 'paragraph':
-      return `<p>${childrenToHtml(node)}</p>`;
-    case 'text':
-      return escapeHtml(node.value ?? '');
-    case 'strong':
-      return `<strong>${childrenToHtml(node)}</strong>`;
-    case 'emphasis':
-      return `<em>${childrenToHtml(node)}</em>`;
-    case 'delete':
-      return `<del>${childrenToHtml(node)}</del>`;
-    case 'inlineCode':
-      return `<code>${escapeHtml(node.value ?? '')}</code>`;
-    case 'code':
-      return `<pre><code>${escapeHtml(node.value ?? '')}</code></pre>`;
-    case 'blockquote':
-      return `<blockquote>${childrenToHtml(node)}</blockquote>`;
-    case 'list': {
-      const tag = node.ordered ? 'ol' : 'ul';
-      return `<${tag}>${childrenToHtml(node)}</${tag}>`;
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath,
+      readDocument: (path) => readDocumentFromContainer(mediaContainer, path),
+      readBinary: (path) => mediaContainer.readFile(path),
+      title: baseName,
+      themeId,
+      entryAsIndex: options.entryAsIndex,
+    });
+    downloadBlob(blob, zipName);
+    return;
+  }
+  if (options.htmlStyle === 'rendered') {
+    const mdDoc = parseMarkdown(markdown);
+    const baseDoc = markdownToDoc(mdDoc);
+    if (themeId) baseDoc.themeId = themeId;
+    const images = mediaContainer ? await resolveDocImages(baseDoc, mediaContainer) : undefined;
+    if (options.htmlBundle === 'zip') {
+      const blob = await docToHtmlZip(baseDoc, {
+        playerScript: PLAYER_BUNDLE,
+        images,
+        mode: 'static',
+        title: baseName,
+      });
+      downloadBlob(blob, zipName);
+      return;
     }
-    case 'listItem':
-      return `<li>${childrenToHtml(node)}</li>`;
-    case 'link':
-      return `<a href="${escapeAttr(node.url ?? '')}">${childrenToHtml(node)}</a>`;
-    case 'image':
-      return `<img src="${escapeAttr(node.url ?? '')}" alt="${escapeAttr(node.alt ?? '')}" />`;
-    case 'thematicBreak':
-      return '<hr />';
-    default:
-      return node.children ? childrenToHtml(node) : escapeHtml(node.value ?? '');
+    const html = docToHtml(baseDoc, {
+      playerScript: PLAYER_BUNDLE,
+      images,
+      mode: 'static',
+      title: baseName,
+    });
+    downloadBlob(new Blob([html], { type: MIME_TYPES.html }), singleHtmlFilename);
+    return;
   }
-}
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function childrenToHtml(node: any): string {
-  if (!node.children) return node.value ? escapeHtml(node.value) : '';
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  return node.children.map((c: any) => nodeToHtml(c)).join('');
-}
+  // Plain semantic HTML
+  const mdDoc = parseMarkdown(markdown);
+  const referencedImages = collectMarkdownImageUrls(mdDoc);
+  const localImages = referencedImages.filter((u) => !isExternalUrl(u));
-function escapeHtml(s: string): string {
-  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-}
+  if (options.htmlBundle === 'zip' && mediaContainer && localImages.length > 0) {
+    // Mirror the markdown's relative paths inside the zip so <img src="..."> still resolves.
+    const html = markdownDocToPlainHtml(mdDoc, { title: baseName, themeId });
+    const container = new MemoryContentContainer();
+    await container.writeFile('index.html', new TextEncoder().encode(html));
+    for (const url of localImages) {
+      const data = await mediaContainer.readFile(url);
+      if (!data) continue;
+      const cleanPath = url.replace(/^\/+/, '');
+      await container.writeFile(cleanPath, new Uint8Array(data));
+    }
+    const blob = await containerToZip(container);
+    downloadBlob(blob, zipName);
+    return;
+  }
-function escapeAttr(s: string): string {
-  return escapeHtml(s).replace(/"/g, '&quot;');
+  // Single-file plain HTML — embed local images as base64 data URIs.
+  const inlineMap = new Map<string, string>();
+  if (mediaContainer) {
+    for (const url of localImages) {
+      const data = await mediaContainer.readFile(url);
+      if (!data) continue;
+      inlineMap.set(url, arrayBufferToDataUrl(data, url));
+    }
+  }
+  const html = markdownDocToPlainHtml(mdDoc, {
+    title: baseName,
+    images: inlineMap.size > 0 ? inlineMap : undefined,
+    themeId,
+  });
+  downloadBlob(new Blob([html], { type: MIME_TYPES.html }), singleHtmlFilename);
 }
 const IMAGE_MIME: Record<string, string> = {
@@ -191,15 +234,37 @@ const IMAGE_MIME: Record<string, string> = {
   gif: 'image/gif',
   webp: 'image/webp',
   bmp: 'image/bmp',
+  svg: 'image/svg+xml',
 };
+function isExternalUrl(url: string): boolean {
+  return (
+    url.startsWith('http://') ||
+    url.startsWith('https://') ||
+    url.startsWith('data:') ||
+    url.startsWith('blob:')
+  );
+}
+function arrayBufferToDataUrl(data: ArrayBuffer, url: string): string {
+  const ext = url.slice(url.lastIndexOf('.') + 1).toLowerCase();
+  const mime = IMAGE_MIME[ext] ?? 'application/octet-stream';
+  // btoa requires a binary string; chunk to avoid call-stack issues on large files.
+  const bytes = new Uint8Array(data);
+  let binary = '';
+  const CHUNK = 0x8000;
+  for (let i = 0; i < bytes.length; i += CHUNK) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK));
+  }
+  return `data:${mime};base64,${btoa(binary)}`;
+}
 /** Walk the markdown AST and collect all image URLs. */
-function collectImageUrls(doc: MarkdownDocument): string[] {
+function collectMarkdownImageUrls(doc: MarkdownDocument): string[] {
   const urls: string[] = [];
   function walkBlocks(nodes: MarkdownBlockNode[]): void {
     for (const node of nodes) {
       if ('children' in node && Array.isArray(node.children)) {
-        // Check if children are inline or block nodes
         for (const child of node.children as (MarkdownBlockNode | MarkdownInlineNode)[]) {
           if (child.type === 'image') {
             urls.push((child as { url: string }).url);
@@ -211,22 +276,20 @@ function collectImageUrls(doc: MarkdownDocument): string[] {
     }
   }
   walkBlocks(doc.children);
-  return urls;
+  return Array.from(new Set(urls));
 }
-/** Resolve image URLs to binary data from a ContentContainer. */
+/** Resolve image URLs (markdown → docx) to binary data from a ContentContainer. */
 async function resolveImages(
   doc: MarkdownDocument,
   container: ContentContainer,
 ): Promise<Map<string, { data: ArrayBuffer | Uint8Array; contentType: string }>> {
-  const urls = collectImageUrls(doc);
+  const urls = collectMarkdownImageUrls(doc);
   const map = new Map<string, { data: ArrayBuffer | Uint8Array; contentType: string }>();
   for (const url of urls) {
     if (map.has(url)) continue;
-    // Skip external URLs
-    if (url.startsWith('http://') || url.startsWith('https://') || url.startsWith('data:'))
-      continue;
+    if (isExternalUrl(url)) continue;
     const data = await container.readFile(url);
     if (!data) continue;
     const ext = url.slice(url.lastIndexOf('.') + 1).toLowerCase();
@@ -236,3 +299,39 @@ async function resolveImages(
   return map;
 }
+/** Container-relative path for the bundle's entry document. `mediaContainer`
+ *  is already scoped to the selected file's parent directory, so the bundle
+ *  needs the basename ("docs/home.md" → "home.md"). */
+function basenameForBundle(selectedFile: string): string {
+  const clean = selectedFile.replace(/^\/+/, '');
+  const idx = clean.lastIndexOf('/');
+  return idx === -1 ? clean : clean.slice(idx + 1);
+}
+/** Read a UTF-8 text document from a ContentContainer. Returns null when
+ *  the file is missing — preserves the bundle's "abort with error" contract
+ *  for unreachable .md links. */
+async function readDocumentFromContainer(
+  container: ContentContainer,
+  path: string,
+): Promise<string | null> {
+  const data = await container.readFile(path);
+  if (!data) return null;
+  return new TextDecoder('utf-8').decode(data);
+}
+/** Resolve image paths referenced by a squisq Doc to ArrayBuffers for HTML export. */
+async function resolveDocImages(
+  doc: Doc,
+  container: ContentContainer,
+): Promise<Map<string, ArrayBuffer>> {
+  const paths = collectImagePaths(doc);
+  const map = new Map<string, ArrayBuffer>();
+  for (const path of paths) {
+    const data = await container.readFile(path);
+    if (!data) continue;
+    map.set(path, data);
+  }
+  return map;
+}

package/src/FileExplorer/FileExplorer.tsx CHANGED Viewed

@@ -13,6 +13,22 @@ import { NewFileIcon, NewFolderIcon, RefreshIcon } from '../icons.js';
 const SUPPORTED_EXTENSIONS = new Set(['.txt', '.md', '.docx', '.pdf', '.dbk', '.zip']);
+/**
+ * Hide auto-generated `<basename>_files/` companion folders from the
+ * tree. They hold per-document images and version snapshots — useful
+ * to the editor, noisy in the user-facing file list. The folders still
+ * exist on disk; we just don't surface them in the explorer.
+ */
+function isHiddenEntry(entry: FileSystemEntry): boolean {
+  if (entry.kind !== 'directory') return false;
+  const name = entry.path.replace(/^\/+/, '').split('/').pop() ?? '';
+  return name.endsWith('_files');
+}
+function filterVisible(entries: FileSystemEntry[]): FileSystemEntry[] {
+  return entries.filter((e) => !isHiddenEntry(e));
+}
 export interface FileExplorerProps {
   /** The filesystem to display. */
   provider: FileSystemProvider | null;
@@ -154,7 +170,7 @@ export function FileExplorer({
   const renderEntries = useCallback(
     (entries: FileSystemEntry[], depth: number): React.ReactNode => {
-      return entries.map((entry) => (
+      return filterVisible(entries).map((entry) => (
         <FileTreeNode
           key={entry.path}
           entry={entry}
@@ -245,16 +261,22 @@ export function FileExplorer({
         </div>
       )}
-      {/* Tree */}
-      <div className="db-tree" role="tree">
-        {tree.loading ? (
+      {/* Tree — role="tree" only when there are real treeitem children; the
+          loading/empty states get a status role so axe doesn't flag the
+          tree as missing required children. */}
+      {tree.loading ? (
+        <div className="db-tree" role="status" aria-live="polite">
           <div className="db-tree-loading">Loading...</div>
-        ) : tree.entries.length === 0 ? (
+        </div>
+      ) : filterVisible(tree.entries).length === 0 ? (
+        <div className="db-tree">
           <div className="db-tree-empty">No files yet</div>
-        ) : (
-          renderEntries(tree.entries, 0)
-        )}
-      </div>
+        </div>
+      ) : (
+        <div className="db-tree" role="tree">
+          {renderEntries(tree.entries, 0)}
+        </div>
+      )}
     </div>
   );
 }

package/src/FileExplorer/FileTreeNode.tsx CHANGED Viewed

@@ -2,8 +2,10 @@
  * FileTreeNode — recursive tree node for the file explorer.
  */
-import { useCallback, useState, useRef, useEffect } from 'react';
+import { useCallback, useState, useRef, useEffect, useLayoutEffect } from 'react';
+import { createPortal } from 'react-dom';
 import type { FileSystemEntry } from '@bendyline/docblocks/filesystem';
+import { MoreIcon } from '../icons.js';
 export interface FileTreeNodeProps {
   entry: FileSystemEntry;
@@ -50,11 +52,15 @@ export function FileTreeNode({
   const handleContextMenu = useCallback((e: React.MouseEvent) => {
     e.preventDefault();
     e.stopPropagation();
-    const rect = nodeRef.current?.getBoundingClientRect();
-    setContextPos({
-      x: e.clientX - (rect?.left ?? 0),
-      y: e.clientY - (rect?.top ?? 0),
-    });
+    setContextPos({ x: e.clientX, y: e.clientY });
+    setShowContext(true);
+  }, []);
+  const handleMoreClick = useCallback((e: React.MouseEvent) => {
+    e.preventDefault();
+    e.stopPropagation();
+    const rect = (e.currentTarget as HTMLElement).getBoundingClientRect();
+    setContextPos({ x: rect.right, y: rect.bottom });
     setShowContext(true);
   }, []);
@@ -106,6 +112,26 @@ export function FileTreeNode({
     }
   }, [renaming]);
+  // Clamp menu inside viewport after it renders
+  useLayoutEffect(() => {
+    if (!showContext || !contextRef.current) return;
+    const menu = contextRef.current;
+    const rect = menu.getBoundingClientRect();
+    const margin = 4;
+    let left = contextPos.x;
+    let top = contextPos.y;
+    if (rect.right > window.innerWidth - margin) {
+      left = Math.max(margin, window.innerWidth - rect.width - margin);
+    }
+    if (rect.bottom > window.innerHeight - margin) {
+      top = Math.max(margin, window.innerHeight - rect.height - margin);
+    }
+    if (left !== contextPos.x || top !== contextPos.y) {
+      menu.style.left = `${left}px`;
+      menu.style.top = `${top}px`;
+    }
+  }, [showContext, contextPos]);
   return (
     <div className="db-tree-node" ref={nodeRef}>
       <div
@@ -136,30 +162,46 @@ export function FileTreeNode({
             onClick={(e) => e.stopPropagation()}
           />
         ) : (
-          <span className="db-tree-label">
-            {entry.name.endsWith('.md') ? entry.name.slice(0, -3) : entry.name}
-          </span>
+          <>
+            <span className="db-tree-label">
+              {entry.name.endsWith('.md') ? entry.name.slice(0, -3) : entry.name}
+            </span>
+            <button
+              type="button"
+              className={`db-tree-more${showContext ? ' db-tree-more--active' : ''}`}
+              onClick={handleMoreClick}
+              onContextMenu={handleMoreClick}
+              aria-label="More actions"
+              aria-haspopup="menu"
+              aria-expanded={showContext}
+              tabIndex={-1}
+            >
+              <MoreIcon width={14} height={14} />
+            </button>
+          </>
         )}
       </div>
-      {/* Context menu */}
-      {showContext && (
-        <div
-          ref={contextRef}
-          className="db-tree-context"
-          style={{ left: contextPos.x, top: contextPos.y }}
-        >
-          <button className="db-tree-context-item" onClick={handleRenameStart}>
-            Rename
-          </button>
-          <button
-            className="db-tree-context-item db-tree-context-item--danger"
-            onClick={handleDeleteClick}
+      {/* Context menu — portaled so ancestor overflow:hidden doesn't clip it */}
+      {showContext &&
+        createPortal(
+          <div
+            ref={contextRef}
+            className="db-tree-context"
+            style={{ left: contextPos.x, top: contextPos.y }}
           >
-            Delete
-          </button>
-        </div>
-      )}
+            <button className="db-tree-context-item" onClick={handleRenameStart}>
+              Rename
+            </button>
+            <button
+              className="db-tree-context-item db-tree-context-item--danger"
+              onClick={handleDeleteClick}
+            >
+              Delete
+            </button>
+          </div>,
+          document.body,
+        )}
       {/* Render children if directory is expanded */}
       {isDir && expanded && renderChildren && (

package/src/WorkspacePicker/WorkspacePicker.tsx CHANGED Viewed

@@ -7,6 +7,7 @@ import { useState, useEffect, useCallback, useRef } from 'react';
 import type { WorkspaceDescriptor } from '@bendyline/docblocks/workspace';
 import { listWorkspaces, saveWorkspace, touchWorkspace } from '@bendyline/docblocks/workspace';
 import { isNativeFileSystemSupported } from '@bendyline/docblocks/filesystem';
+import { isElectronHost } from '@bendyline/docblocks/host';
 export interface WorkspacePickerProps {
   /** Currently active workspace id. */
@@ -41,10 +42,16 @@ export function WorkspacePicker({
     return () => document.removeEventListener('mousedown', handleOutsideClick);
   }, [isOpen]);
+  const electron = isElectronHost();
   const refresh = useCallback(async () => {
     const list = await listWorkspaces();
-    setWorkspaces(list);
-  }, []);
+    // On desktop, hide web-only workspaces (indexeddb/native).
+    const filtered = electron
+      ? list.filter((w) => w.type === 'electron-native')
+      : list.filter((w) => w.type !== 'electron-native');
+    setWorkspaces(filtered);
+  }, [electron]);
   useEffect(() => {
     refresh();
@@ -98,17 +105,21 @@ export function WorkspacePicker({
               onClick={() => handleSelect(ws)}
             >
               {ws.name}
-              <span className="db-workspace-type">{ws.type === 'native' ? '(folder)' : ''}</span>
+              <span className="db-workspace-type">
+                {ws.type === 'native' || ws.type === 'electron-native' ? '(folder)' : ''}
+              </span>
             </button>
           ))}
           <div className="db-workspace-dropdown-divider" />
-          <button className="db-workspace-dropdown-item" onClick={handleCreateNew}>
-            + New Workspace
-          </button>
+          {!electron && (
+            <button className="db-workspace-dropdown-item" onClick={handleCreateNew}>
+              + New Workspace
+            </button>
+          )}
-          {isNativeFileSystemSupported() && (
+          {(electron || isNativeFileSystemSupported()) && (
             <button
               className="db-workspace-dropdown-item"
               onClick={() => {

package/src/WorkspacePicker/WorkspaceSettingsButton.tsx CHANGED Viewed

@@ -6,12 +6,14 @@ import { useState, useCallback, useRef, useEffect } from 'react';
 import { WorkspaceIcon } from '../icons.js';
 export interface WorkspaceSettingsButtonProps {
+  onSettings: () => void;
   onRename: () => void;
   onDownload: () => void;
   onRemove: () => void;
 }
 export function WorkspaceSettingsButton({
+  onSettings,
   onRename,
   onDownload,
   onRemove,
@@ -50,6 +52,13 @@ export function WorkspaceSettingsButton({
       {isOpen && (
         <div className="db-ws-settings-dropdown" role="menu">
+          <button
+            className="db-ws-settings-item"
+            role="menuitem"
+            onClick={() => handleAction(onSettings)}
+          >
+            Workspace settings…
+          </button>
           <button
             className="db-ws-settings-item"
             role="menuitem"