@bendyline/docblocks-react 2.6.1 → 2.7.0

package/dist/chunk-RP3DVNTI.js

@@ -0,0 +1,62 @@
+// src/Export/video-export-doc.ts
+import { parseMarkdown } from "@bendyline/squisq/markdown";
+var DATA_PREVIEW_ROWS = 50;
+var TRANSFORM_KEY = "squisq-transform";
+var LEGACY_TRANSFORM_KEY = "transform-style";
+function persistedTransformStyle(frontmatter, knownIds) {
+  if (!frontmatter) return null;
+  const value = Object.prototype.hasOwnProperty.call(frontmatter, TRANSFORM_KEY) ? frontmatter[TRANSFORM_KEY] : frontmatter[LEGACY_TRANSFORM_KEY];
+  if (typeof value !== "string") return null;
+  const normalized = value.trim().toLowerCase().replace(/\s+/g, "-");
+  const id = normalized === "datadriven" ? "data-driven" : normalized;
+  return knownIds.has(id) ? id : null;
+}
+async function withDataPreviews(doc, container, resolveDataReferences) {
+  try {
+    const { defaultDataReaders } = await import("@bendyline/squisq-formats/data");
+    const resolved = await resolveDataReferences(doc, container, {
+      readers: defaultDataReaders(),
+      maxPreviewRows: DATA_PREVIEW_ROWS
+    });
+    return resolved.doc;
+  } catch {
+    return doc;
+  }
+}
+async function buildVideoExportDoc(markdownSource, options = {}) {
+  const [
+    {
+      buildPreviewDoc,
+      documentTitleFromFileName,
+      markdownToDoc,
+      resolveAudioMapping,
+      resolveDataReferences
+    },
+    { applyTransform, getTransformStyleSummaries }
+  ] = await Promise.all([import("@bendyline/squisq/doc"), import("@bendyline/squisq/transform")]);
+  let doc = markdownToDoc(parseMarkdown(markdownSource));
+  const container = options.workspaceContainer;
+  if (container) {
+    doc = await resolveAudioMapping(doc, container).catch(() => doc);
+    doc = await withDataPreviews(doc, container, resolveDataReferences);
+  }
+  const knownIds = new Set(getTransformStyleSummaries().map((summary) => summary.id));
+  const transformStyle = persistedTransformStyle(doc.frontmatter, knownIds);
+  const contentDoc = transformStyle ? applyTransform(doc, transformStyle).doc : doc;
+  const narrationOwnsTimeline = (contentDoc.documentMedia ?? []).some(
+    (clip) => clip.anchor === "document"
+  );
+  const projected = buildPreviewDoc(contentDoc, {
+    documentTitle: documentTitleFromFileName(options.fileName ?? void 0),
+    interleaveImages: !narrationOwnsTimeline
+  });
+  const invalidPresentation = projected.diagnostics?.find(
+    (diagnostic) => diagnostic.code === "presentation-invalid"
+  );
+  if (invalidPresentation) throw new Error(invalidPresentation.message);
+  return { ...projected, audio: contentDoc.audio };
+}
+
+export {
+  buildVideoExportDoc
+};

package/dist/{chunk-FMDLZ4ZG.js → chunk-SGQKTKDX.js}

@@ -4,10 +4,10 @@ import {
 import {
   FORMAT_LABELS,
   saveExportOptions
-} from "./chunk-EBWYGTN7.js";
+} from "./chunk-X437UAF7.js";
 import {
   Dialog
-} from "./chunk-LG6HAWCK.js";
+} from "./chunk-56KO2LYN.js";
 
 // src/Export/ExportDialog.tsx
 import { useState, useCallback, useEffect, useMemo } from "react";

package/dist/chunk-TBLZBNQF.js

@@ -0,0 +1,25 @@
+// src/components/HighlightedText.tsx
+import { Fragment } from "react";
+import { Fragment as Fragment2, jsx } from "react/jsx-runtime";
+function HighlightedText({ text, ranges }) {
+  const parts = [];
+  let cursor = 0;
+  for (const [rawStart, rawEnd] of ranges) {
+    const start = Math.max(cursor, Math.min(rawStart, text.length));
+    const end = Math.min(rawEnd, text.length);
+    if (end <= start) continue;
+    if (start > cursor)
+      parts.push(/* @__PURE__ */ jsx(Fragment, { children: text.slice(cursor, start) }, `t${cursor}`));
+    parts.push(
+      /* @__PURE__ */ jsx("mark", { className: "db-search-match", children: text.slice(start, end) }, `m${start}`)
+    );
+    cursor = end;
+  }
+  if (cursor < text.length)
+    parts.push(/* @__PURE__ */ jsx(Fragment, { children: text.slice(cursor) }, `t${cursor}`));
+  return /* @__PURE__ */ jsx(Fragment2, { children: parts });
+}
+
+export {
+  HighlightedText
+};

package/dist/{chunk-M5Y5WO7Z.js → chunk-UG4G7PJ4.js}

@@ -1,6 +1,6 @@
 import {
   FORMAT_EXTENSIONS
-} from "./chunk-EBWYGTN7.js";
+} from "./chunk-X437UAF7.js";
 
 // src/Export/export-filename.ts
 function buildExportFilename(selectedFile, options) {

package/dist/chunk-UONFWKJ7.js

@@ -0,0 +1,22 @@
+// src/Export/host-error.ts
+function hostErrorDetail(caught) {
+  return caught instanceof Error ? caught.message.replace(/^Error invoking remote method '[^']+': Error:\s*/, "").trim() : "";
+}
+
+// src/Export/image-save.ts
+function createImageSaveOutput(adapter) {
+  return async (blob, filename) => {
+    try {
+      const target = await adapter.pickTarget(filename, null);
+      if (!target) return false;
+      return await adapter.saveBlob(blob, filename, target) !== null;
+    } catch (caught) {
+      throw new Error(hostErrorDetail(caught) || `Couldn't save "${filename}".`);
+    }
+  };
+}
+
+export {
+  hostErrorDetail,
+  createImageSaveOutput
+};

package/dist/chunk-VO2JYYQZ.js

@@ -0,0 +1,40 @@
+// src/Speech/useSpeechStatus.ts
+import { useEffect, useState } from "react";
+function useSpeechStatus(speech) {
+  const [status, setStatus] = useState(null);
+  useEffect(() => {
+    let live = true;
+    const unsubscribe = speech.onStatus((next) => {
+      if (live) setStatus(next);
+    });
+    void speech.status().then(
+      (initial) => {
+        if (live) setStatus((current) => current ?? initial);
+      },
+      () => {
+        if (live)
+          setStatus(
+            (current) => current ?? {
+              stt: {
+                state: "unavailable",
+                reason: "Speech status is unavailable. Try opening Settings."
+              },
+              tts: {
+                state: "unavailable",
+                reason: "Speech status is unavailable. Try opening Settings."
+              }
+            }
+          );
+      }
+    );
+    return () => {
+      live = false;
+      unsubscribe();
+    };
+  }, [speech]);
+  return status;
+}
+
+export {
+  useSpeechStatus
+};

package/dist/{chunk-EBWYGTN7.js → chunk-X437UAF7.js}

@@ -26,6 +26,11 @@ var DEFAULT_OPTIONS = {
   includeLinkedDocs: false,
   entryAsIndex: false
 };
+function resolveExportDialogInitial(lastOptions, docThemeId, workspaceThemeId) {
+  const base = lastOptions ?? DEFAULT_OPTIONS;
+  const themeId = docThemeId || workspaceThemeId;
+  return themeId ? { ...base, themeId } : base;
+}
 function loadLastExportOptions() {
   try {
     const raw = localStorage.getItem(STORAGE_KEY);
@@ -47,6 +52,7 @@ export {
   FORMAT_LABELS,
   FORMAT_EXTENSIONS,
   DEFAULT_OPTIONS,
+  resolveExportDialogInitial,
   loadLastExportOptions,
   saveExportOptions
 };

package/dist/chunk-YS4HVWIO.js

@@ -0,0 +1,63 @@
+// src/Export/shared-document.ts
+import {
+  SHARED_DOCUMENT_LIMITS,
+  createSharedDocumentUrl
+} from "@bendyline/docblocks/share";
+var PUBLIC_DOCBLOCKS_SHARE_URL = "https://docblocks.com/";
+function resolveSharedDocumentBaseUrl(currentUrl) {
+  try {
+    const current = new URL(currentUrl);
+    if (current.protocol === "http:" || current.protocol === "https:") {
+      current.hash = "";
+      current.searchParams.delete("action");
+      return current.toString();
+    }
+  } catch {
+  }
+  return PUBLIC_DOCBLOCKS_SHARE_URL;
+}
+function sharedDocumentFilename(selectedFile) {
+  const basename = selectedFile?.replace(/\\/gu, "/").split("/").pop() ?? "shared.md";
+  const stem = basename.replace(/\.md$/iu, "").replace(/[^A-Za-z0-9._-]+/gu, "-");
+  const bounded = stem.replace(/^-+|-+$/gu, "").slice(0, 80) || "shared";
+  return `${bounded}.md`;
+}
+async function createSharedDocumentArchive(markdown, selectedFile) {
+  const encoded = new TextEncoder().encode(markdown);
+  if (encoded.byteLength > SHARED_DOCUMENT_LIMITS.markdownBytes) {
+    throw new Error(
+      `This document is too large for a shared URL (maximum ${SHARED_DOCUMENT_LIMITS.markdownBytes.toLocaleString()} UTF-8 bytes).`
+    );
+  }
+  const [{ MemoryContentContainer }, { containerToZip }] = await Promise.all([
+    import("@bendyline/squisq/storage"),
+    import("@bendyline/squisq-formats/container")
+  ]);
+  const container = new MemoryContentContainer();
+  await container.writeFile(sharedDocumentFilename(selectedFile), encoded, "text/markdown");
+  const blob = await containerToZip(container, { compression: "DEFLATE", compressionLevel: 9 });
+  return new Uint8Array(await blob.arrayBuffer());
+}
+function buildSharedDocumentUrl(baseUrl, archive, mode) {
+  return createSharedDocumentUrl(resolveSharedDocumentBaseUrl(baseUrl), archive, mode);
+}
+function buildSharedDocumentQrUrl(archive, mode) {
+  const url = createSharedDocumentUrl(PUBLIC_DOCBLOCKS_SHARE_URL, archive, mode);
+  if (url.length > SHARED_DOCUMENT_LIMITS.qrUrlCharacters) {
+    throw new Error(
+      "This document is too large for a reliable QR code (maximum " + SHARED_DOCUMENT_LIMITS.qrUrlCharacters.toLocaleString() + " URL characters). Copy the share link instead."
+    );
+  }
+  return url;
+}
+function sharedDocumentQrFilename(selectedFile) {
+  return sharedDocumentFilename(selectedFile).replace(/\.md$/iu, "-qr.png");
+}
+
+export {
+  sharedDocumentFilename,
+  createSharedDocumentArchive,
+  buildSharedDocumentUrl,
+  buildSharedDocumentQrUrl,
+  sharedDocumentQrFilename
+};

package/dist/editor.d.ts

@@ -1,4 +1,39 @@
 import { ViewportPreset } from '@bendyline/squisq/schemas';
+import * as react from 'react';
+import { DocBlocksHostAiAPI } from '@bendyline/docblocks/host';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function PresentationMaker({ ai, onClose, }: {
+    ai?: DocBlocksHostAiAPI;
+    onClose: () => void;
+}): react.ReactPortal;
+
+interface FindButtonProps {
+    readonly active: boolean;
+    readonly onActiveChange: (active: boolean) => void;
+    /** Platform label for the shortcut (e.g. `Ctrl+F` or `⌘F`), shown in the tooltip. */
+    readonly shortcutLabel?: string;
+}
+/**
+ * Toolbar toggle for Squisq's Find mode. Squisq ships the find bar but no
+ * trigger, so every host that mounts `EditorShell` renders this in a toolbar
+ * slot and passes the state through `findMode` / `onFindModeChange`.
+ */
+declare function FindButton({ active, onActiveChange, shortcutLabel }: FindButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Re-focus an already-open find bar and select its query. Squisq focuses the
+ * input only when the bar mounts, so a repeated Ctrl/Cmd+F needs this.
+ */
+declare function focusFindInput(scope?: ParentNode): void;
+
+/**
+ * Cmd/Ctrl+F, for hosts that mount Squisq's `EditorShell` without the shell's
+ * listener (the VS Code webview) but still want one find UI everywhere.
+ */
+declare function isFindShortcut(event: KeyboardEvent): boolean;
+/** Tooltip label for the find shortcut on the current platform. */
+declare function findShortcutLabel(): string;
 
 declare const PORTRAIT_FORM_FACTOR_QUERY = "(orientation: portrait)";
 /** Map the host surface orientation to Squisq's matching preview canvas. */
@@ -19,4 +54,4 @@ type EmptyDocumentPrompt = (typeof EMPTY_DOCUMENT_PROMPTS)[number];
 /** Pick a prompt using the supplied random source, or `Math.random`. */
 declare function pickEmptyDocumentPrompt(random?: () => number): EmptyDocumentPrompt;
 
-export { EMPTY_DOCUMENT_PROMPTS, type EmptyDocumentPrompt, PORTRAIT_FORM_FACTOR_QUERY, pickEmptyDocumentPrompt, previewViewportPresetForOrientation, useResponsivePreviewViewportPreset };
+export { EMPTY_DOCUMENT_PROMPTS, type EmptyDocumentPrompt, FindButton, type FindButtonProps, PORTRAIT_FORM_FACTOR_QUERY, PresentationMaker, findShortcutLabel, focusFindInput, isFindShortcut, pickEmptyDocumentPrompt, previewViewportPresetForOrientation, useResponsivePreviewViewportPreset };

package/dist/editor.js

@@ -1,13 +1,28 @@
 import {
   EMPTY_DOCUMENT_PROMPTS,
+  FindButton,
   PORTRAIT_FORM_FACTOR_QUERY,
+  findShortcutLabel,
+  focusFindInput,
+  isFindShortcut,
   pickEmptyDocumentPrompt,
   previewViewportPresetForOrientation,
   useResponsivePreviewViewportPreset
-} from "./chunk-JDJVRDOP.js";
+} from "./chunk-G4MFB3IO.js";
+import {
+  PresentationMaker
+} from "./chunk-MMOTEQK6.js";
+import "./chunk-5OZBGIIT.js";
+import "./chunk-K4I3NJFL.js";
+import "./chunk-56KO2LYN.js";
 export {
   EMPTY_DOCUMENT_PROMPTS,
+  FindButton,
   PORTRAIT_FORM_FACTOR_QUERY,
+  PresentationMaker,
+  findShortcutLabel,
+  focusFindInput,
+  isFindShortcut,
   pickEmptyDocumentPrompt,
   previewViewportPresetForOrientation,
   useResponsivePreviewViewportPreset

package/dist/export/index.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _bendyline_squisq_formats_pptx from '@bendyline/squisq-formats/pptx';
 import { ContentContainer } from '@bendyline/squisq/storage';
+import { DiagramRasterizer } from '@bendyline/squisq-formats/diagrams';
 
 /**
  * Export option types and localStorage persistence for quick-export.
@@ -52,6 +53,14 @@ interface ExportOptions {
 declare const FORMAT_LABELS: Record<ExportFormat, string>;
 declare const FORMAT_EXTENSIONS: Record<ExportFormat, string>;
 declare const DEFAULT_OPTIONS: ExportOptions;
+/**
+ * Options that populate the export dialog. Layered: built-in defaults → the
+ * user's last-chosen options → the workspace default theme → the document's
+ * own theme (wins). "Set a theme, then export" therefore pre-selects that
+ * theme instead of whatever was picked for an unrelated previous document,
+ * and documents without a theme export in their folder's default.
+ */
+declare function resolveExportDialogInitial(lastOptions: ExportOptions | null, docThemeId: string | null | undefined, workspaceThemeId?: string | null): ExportOptions;
 declare function loadLastExportOptions(): ExportOptions | null;
 declare function saveExportOptions(options: ExportOptions): void;
 
@@ -61,6 +70,11 @@ type ExportBlobSaver = (blob: Blob, filename: string) => Promise<void> | void;
 /** Host-provided converters that must be loaded before an export begins. */
 interface ExportConverterOverrides {
     docToPptx?: (typeof _bendyline_squisq_formats_pptx)['docToPptx'];
+    /**
+     * Draws diagrams as pictures. Defaults to Squisq's browser renderer; tests
+     * pass a stand-in because drawing needs a real canvas.
+     */
+    diagramRenderer?: DiagramRasterizer;
 }
 /** Run the export and trigger a download. */
 declare function runExport(markdown: string, selectedFile: string | null, options: ExportOptions, mediaContainer?: ContentContainer | null, saveBlob?: ExportBlobSaver, converterOverrides?: ExportConverterOverrides): Promise<void>;
@@ -102,25 +116,27 @@ declare function ExportDialog({ initial, exporting, error, destination, onExport
 declare function updateExportTargetExtension(targetPath: string, suggestedFilename: string): string;
 
 /**
- * Host persistence for the editor's raster-image exporters.
+ * Host persistence for Squisq's rendered-output exporters.
  *
- * Squisq renders both the cover image and the Dashboard image in the
- * browser and hands the host a finished blob; DocBlocks owns where that
- * blob lands. The two exporters share one contract upstream
- * (`DashboardImageSaveOutput` is an alias of `CoverImageSaveOutput`), so
- * they share one adapter here rather than two identical copies.
+ * Squisq renders the cover image, the Dashboard image, and exported video in
+ * the browser and hands the host a finished blob; DocBlocks owns where that
+ * blob lands. The exporters share one save-output contract upstream
+ * (`DashboardImageSaveOutput` is an alias of `CoverImageSaveOutput`, and the
+ * video dialog's `saveOutput` has the same shape), so they share one adapter
+ * here rather than identical copies.
  */
-/** Host persistence shape required by the editor's image exporters. */
+/** Host persistence shape required by the editor's rendered-output exporters. */
 interface ImageSaveAdapter<TTarget> {
     pickTarget(filename: string, currentTarget?: TTarget | null): Promise<TTarget | null>;
     saveBlob(blob: Blob, filename: string, target?: TTarget | null): Promise<TTarget | null>;
 }
 type ImageSaveOutput = (blob: Blob, filename: string) => Promise<boolean | void>;
 /**
- * Adapt DocBlocks' two-step host destination flow to Squisq's rendered image
- * output callback. The picker stays host-owned, and cancellation is reported
- * as `false` so the export dialog remains open without showing an error.
+ * Adapt DocBlocks' two-step host destination flow to Squisq's rendered output
+ * callback. The picker stays host-owned, and cancellation is reported as
+ * `false` so the export dialog remains open without showing an error. Squisq
+ * shows a failure's message verbatim, so it arrives without IPC internals.
  */
 declare function createImageSaveOutput<TTarget>(adapter: ImageSaveAdapter<TTarget>): ImageSaveOutput;
 
-export { type ImageSaveAdapter as CoverImageSaveAdapter, type ImageSaveOutput as CoverImageSaveOutput, DEFAULT_OPTIONS, type ImageSaveAdapter as DashboardImageSaveAdapter, type ImageSaveOutput as DashboardImageSaveOutput, type ExportBlobSaver, type ExportConverterOverrides, type ExportDestinationControl, ExportDialog, type ExportDialogProps, type ExportFormat, type ExportOptions, FORMAT_EXTENSIONS, FORMAT_LABELS, type HtmlBundle, type HtmlStyle, type ImageSaveAdapter, type ImageSaveOutput, buildExportFilename, createImageSaveOutput as createCoverImageSaveOutput, createImageSaveOutput as createDashboardImageSaveOutput, createImageSaveOutput, loadLastExportOptions, runExport, saveExportOptions, updateExportTargetExtension };
+export { type ImageSaveAdapter as CoverImageSaveAdapter, type ImageSaveOutput as CoverImageSaveOutput, DEFAULT_OPTIONS, type ImageSaveAdapter as DashboardImageSaveAdapter, type ImageSaveOutput as DashboardImageSaveOutput, type ExportBlobSaver, type ExportConverterOverrides, type ExportDestinationControl, ExportDialog, type ExportDialogProps, type ExportFormat, type ExportOptions, FORMAT_EXTENSIONS, FORMAT_LABELS, type HtmlBundle, type HtmlStyle, type ImageSaveAdapter, type ImageSaveOutput, buildExportFilename, createImageSaveOutput as createCoverImageSaveOutput, createImageSaveOutput as createDashboardImageSaveOutput, createImageSaveOutput, loadLastExportOptions, resolveExportDialogInitial, runExport, saveExportOptions, updateExportTargetExtension };

package/dist/export/index.js

@@ -1,25 +1,28 @@
 import {
-  createImageSaveOutput,
   updateExportTargetExtension
-} from "../chunk-FNSRCCBC.js";
+} from "../chunk-KWG6UP5O.js";
 import {
   runExport
-} from "../chunk-ODYNOPC3.js";
+} from "../chunk-BCQZTWE5.js";
+import {
+  createImageSaveOutput
+} from "../chunk-UONFWKJ7.js";
 import {
   buildExportFilename
-} from "../chunk-M5Y5WO7Z.js";
+} from "../chunk-UG4G7PJ4.js";
 import {
   ExportDialog
-} from "../chunk-FMDLZ4ZG.js";
+} from "../chunk-SGQKTKDX.js";
 import "../chunk-YBEYTVU2.js";
 import {
   DEFAULT_OPTIONS,
   FORMAT_EXTENSIONS,
   FORMAT_LABELS,
   loadLastExportOptions,
+  resolveExportDialogInitial,
   saveExportOptions
-} from "../chunk-EBWYGTN7.js";
-import "../chunk-LG6HAWCK.js";
+} from "../chunk-X437UAF7.js";
+import "../chunk-56KO2LYN.js";
 export {
   DEFAULT_OPTIONS,
   ExportDialog,
@@ -30,6 +33,7 @@ export {
   createImageSaveOutput as createDashboardImageSaveOutput,
   createImageSaveOutput,
   loadLastExportOptions,
+  resolveExportDialogInitial,
   runExport,
   saveExportOptions,
   updateExportTargetExtension