@bendyline/docblocks-react 2.7.5 → 2.7.7

package/dist/{chunk-FBPCURCS.js → chunk-7HBKKXRV.js}

@@ -1,18 +1,44 @@
+import {
+  HighlightedText
+} from "./chunk-TBLZBNQF.js";
 import {
   Dialog
 } from "./chunk-VJPGZCFS.js";
 
 // src/Settings/AiSettings.tsx
-import { useCallback, useEffect as useEffect2, useId, useRef as useRef2, useState as useState2 } from "react";
+import { useCallback, useEffect as useEffect2, useId as useId2, useRef as useRef2, useState as useState2 } from "react";
 
 // src/Settings/AiKnowledgeSettings.tsx
-import { useEffect, useRef, useState } from "react";
+import { useEffect, useId, useRef, useState } from "react";
+import { createPortal } from "react-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function sizedArticle(bytes) {
   const megabytes = String(Math.max(1, Math.round(bytes / 1024 ** 2)));
   const an = megabytes.startsWith("8") || megabytes.length % 3 === 2 && (megabytes.startsWith("11") || megabytes.startsWith("18"));
   return `${an ? "an" : "a"} ${megabytes} MB`;
 }
+function catalogFacts(catalog, version) {
+  return [
+    `Version ${version}`,
+    catalog.documents === null ? null : `${catalog.documents.toLocaleString()} documents`,
+    catalog.downloadBytes === null ? null : `${(catalog.downloadBytes / 1024 ** 2).toFixed(1)} MB`
+  ].filter((part) => part !== null).join(" \xB7 ");
+}
+function catalogSummary(catalog) {
+  if (catalog.state === "downloading")
+    return catalog.percent === null ? "Downloading\u2026" : `Downloading ${Math.round(catalog.percent)}%`;
+  if (catalog.state === "error") return "Needs attention";
+  const use = catalog.enabled ? "In use" : "Not in use";
+  return catalog.updateAvailable ? `${use} \xB7 Update available` : use;
+}
+function matchRanges(text, query) {
+  if (!query) return [];
+  const haystack = text.toLowerCase();
+  const ranges = [];
+  for (let at = haystack.indexOf(query); at >= 0; at = haystack.indexOf(query, at + query.length))
+    ranges.push([at, at + query.length]);
+  return ranges;
+}
 function AiKnowledgeSettings({ knowledge }) {
   const [state, setState] = useState(null);
   const [error, setError] = useState(null);
@@ -20,9 +46,10 @@ function AiKnowledgeSettings({ knowledge }) {
   const [unsupported, setUnsupported] = useState(null);
   const [busy, setBusy] = useState(false);
   const [revision, setRevision] = useState(0);
-  const [browse, setBrowse] = useState(false);
-  const [query, setQuery] = useState("");
+  const [adding, setAdding] = useState(false);
+  const [expanded, setExpanded] = useState(() => /* @__PURE__ */ new Set());
   const [removing, setRemoving] = useState(null);
+  const binHeadingId = useId();
   const generation = useRef(0);
   useEffect(
     () => () => {
@@ -33,7 +60,7 @@ function AiKnowledgeSettings({ knowledge }) {
   useEffect(() => {
     let live = true;
     let timer;
-    const refresh = async () => {
+    const refresh2 = async () => {
       try {
         const result = await knowledge.state();
         if (!live) return;
@@ -46,13 +73,13 @@ function AiKnowledgeSettings({ knowledge }) {
         setLoadError(null);
         setUnsupported(null);
         if (result.value.improvement?.downloading || result.value.catalogs.some((catalog) => catalog.state === "downloading")) {
-          timer = setTimeout(() => void refresh(), 1500);
+          timer = setTimeout(() => void refresh2(), 1500);
         }
       } catch {
         if (live) setLoadError("Could not refresh knowledge catalogs. Try again.");
       }
     };
-    void refresh();
+    void refresh2();
     return () => {
       live = false;
       if (timer) clearTimeout(timer);
@@ -76,9 +103,21 @@ function AiKnowledgeSettings({ knowledge }) {
       if (current === generation.current) setBusy(false);
     }
   };
-  const visible = state?.catalogs.filter(
-    (catalog) => (browse || catalog.installedVersion !== null || catalog.state === "downloading") && `${catalog.name} ${catalog.description}`.toLowerCase().includes(query.toLowerCase())
+  const refresh = () => setRevision((value) => value + 1);
+  const showAdd = (open) => {
+    setError(null);
+    setAdding(open);
+    if (open) refresh();
+  };
+  const toggle = (catalogId) => setExpanded((current) => {
+    const next = new Set(current);
+    if (!next.delete(catalogId)) next.add(catalogId);
+    return next;
+  });
+  const downloaded = state?.catalogs.filter(
+    (catalog) => catalog.installedVersion !== null || catalog.state === "downloading"
   ) ?? [];
+  const problem = error ?? loadError;
   if (unsupported)
     return /* @__PURE__ */ jsxs("section", { className: "db-settings-ai-knowledge", "aria-label": "Knowledge catalogs", children: [
       /* @__PURE__ */ jsx("h3", { className: "db-settings-select-header", children: "Knowledge catalogs" }),
@@ -87,8 +126,17 @@ function AiKnowledgeSettings({ knowledge }) {
   return /* @__PURE__ */ jsxs("section", { className: "db-settings-ai-knowledge", "aria-label": "Knowledge catalogs", children: [
     /* @__PURE__ */ jsx("h3", { className: "db-settings-select-header", children: "Knowledge catalogs" }),
     /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: "Add reference material for AI writing, review, and chat. Relevant passages from enabled catalogs are included in each request." }),
-    (error ?? loadError) && /* @__PURE__ */ jsx("p", { className: "db-settings-hint db-settings-ai-error", role: "alert", children: error ?? loadError }),
+    problem && !adding && /* @__PURE__ */ jsx("p", { className: "db-settings-hint db-settings-ai-error", role: "alert", children: problem }),
     !state && !loadError && /* @__PURE__ */ jsx("p", { className: "db-settings-hint", role: "status", children: "Loading knowledge catalogs\u2026" }),
+    !state && loadError && /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        className: "db-settings-action db-settings-action--secondary",
+        onClick: refresh,
+        children: "Try again"
+      }
+    ),
     state?.improvement && !state.improvement.downloading && /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: /* @__PURE__ */ jsxs(
       "button",
       {
@@ -103,52 +151,90 @@ function AiKnowledgeSettings({ knowledge }) {
         ]
       }
     ) }),
-    /* @__PURE__ */ jsxs("div", { className: "db-settings-ai-knowledge-actions", children: [
-      /* @__PURE__ */ jsx(
-        "button",
-        {
-          type: "button",
-          className: "db-settings-action db-settings-action--secondary",
-          disabled: busy,
-          onClick: () => setBrowse(!browse),
-          children: browse ? "Show downloaded catalogs" : "Browse additional catalogs"
-        }
-      ),
-      /* @__PURE__ */ jsx(
-        "button",
-        {
-          type: "button",
-          className: "db-settings-action db-settings-action--secondary",
-          disabled: busy,
-          onClick: () => setRevision((value) => value + 1),
-          children: "Refresh catalogs"
-        }
-      )
-    ] }),
-    state && /* @__PURE__ */ jsxs("label", { className: "db-settings-select", children: [
-      /* @__PURE__ */ jsx("span", { className: "db-settings-select-header", children: "Find a catalog" }),
-      /* @__PURE__ */ jsx(
-        "input",
+    state && /* @__PURE__ */ jsxs("div", { className: "db-knowledge-bin", children: [
+      /* @__PURE__ */ jsxs("div", { className: "db-knowledge-bin-header", children: [
+        /* @__PURE__ */ jsx("h4", { id: binHeadingId, className: "db-knowledge-bin-title", children: "Downloaded catalogs" }),
+        /* @__PURE__ */ jsx("span", { className: "db-knowledge-bin-count", "aria-hidden": "true", children: downloaded.length }),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "db-settings-action db-settings-action--secondary",
+            onClick: () => showAdd(true),
+            children: "Add catalog\u2026"
+          }
+        )
+      ] }),
+      downloaded.length === 0 ? /* @__PURE__ */ jsx("p", { className: "db-settings-hint db-knowledge-bin-empty", children: "No catalogs downloaded yet. Add a catalog to give AI writing, review, and chat reference material." }) : /* @__PURE__ */ jsx("ul", { className: "db-knowledge-bin-list", "aria-labelledby": binHeadingId, children: downloaded.map((catalog) => /* @__PURE__ */ jsx(
+        DownloadedCatalog,
         {
-          className: "db-settings-select-input",
-          type: "search",
-          value: query,
-          onChange: (event) => setQuery(event.currentTarget.value)
-        }
-      )
+          catalog,
+          expanded: expanded.has(catalog.id),
+          removing: removing === catalog.id,
+          busy,
+          onToggle: () => toggle(catalog.id),
+          onRemoving: (confirming) => setRemoving(confirming ? catalog.id : null),
+          onAction: (action) => void update(action)
+        },
+        catalog.id
+      )) })
     ] }),
-    state && visible.length === 0 && /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: browse ? "No matching catalogs are available." : "No downloaded catalogs match. Browse additional catalogs to add reference material." }),
-    /* @__PURE__ */ jsx("ul", { className: "db-settings-ai-knowledge-list", children: visible.map((catalog) => /* @__PURE__ */ jsxs("li", { children: [
-      /* @__PURE__ */ jsx("strong", { children: catalog.name }),
+    adding && state && /* @__PURE__ */ jsx(
+      AddCatalogDialog,
+      {
+        catalogs: state.catalogs,
+        busy,
+        problem,
+        onAction: (action) => void update(action),
+        onRefresh: refresh,
+        onClose: () => showAdd(false)
+      }
+    )
+  ] });
+}
+function DownloadedCatalog({
+  catalog,
+  expanded,
+  removing,
+  busy,
+  onToggle,
+  onRemoving,
+  onAction
+}) {
+  const bodyId = useId();
+  return /* @__PURE__ */ jsxs("li", { className: "db-knowledge-item", children: [
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        className: "db-knowledge-item-toggle",
+        "aria-expanded": expanded,
+        "aria-controls": expanded ? bodyId : void 0,
+        onClick: onToggle,
+        children: [
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: `db-knowledge-item-caret${expanded ? " db-knowledge-item-caret--open" : ""}`,
+              "aria-hidden": "true"
+            }
+          ),
+          /* @__PURE__ */ jsx("span", { className: "db-knowledge-item-name", children: catalog.name }),
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: `db-knowledge-item-summary${catalog.state === "error" ? " db-knowledge-item-summary--error" : ""}`,
+              children: catalogSummary(catalog)
+            }
+          )
+        ]
+      }
+    ),
+    expanded && /* @__PURE__ */ jsxs("div", { id: bodyId, className: "db-knowledge-item-body", children: [
       /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: catalog.description }),
-      /* @__PURE__ */ jsxs("p", { className: "db-settings-hint", children: [
-        "Version ",
-        catalog.installedVersion ?? catalog.version,
-        catalog.documents === null ? "" : ` \xB7 ${catalog.documents.toLocaleString()} documents`,
-        catalog.downloadBytes === null ? "" : ` \xB7 ${(catalog.downloadBytes / 1024 ** 2).toFixed(1)} MB download`
-      ] }),
+      /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: catalogFacts(catalog, catalog.installedVersion ?? catalog.version) }),
       catalog.message && /* @__PURE__ */ jsx("p", { className: "db-settings-hint", role: catalog.state === "error" ? "alert" : "status", children: catalog.message }),
-      catalog.state === "downloading" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      catalog.state === "downloading" ? /* @__PURE__ */ jsxs("div", { className: "db-settings-ai-knowledge-actions", children: [
         /* @__PURE__ */ jsx(
           "progress",
           {
@@ -163,19 +249,19 @@ function AiKnowledgeSettings({ knowledge }) {
             type: "button",
             className: "db-settings-action db-settings-action--secondary",
             disabled: busy,
-            onClick: () => void update({ action: "cancel", catalogId: catalog.id }),
+            onClick: () => onAction({ action: "cancel", catalogId: catalog.id }),
             children: "Cancel download"
           }
         )
       ] }) : /* @__PURE__ */ jsxs("div", { className: "db-settings-ai-knowledge-actions", children: [
-        catalog.installedVersion !== null && /* @__PURE__ */ jsxs("label", { className: "db-settings-checkbox", children: [
+        /* @__PURE__ */ jsxs("label", { className: "db-settings-checkbox", children: [
           /* @__PURE__ */ jsx(
             "input",
             {
               type: "checkbox",
               checked: catalog.enabled,
               disabled: busy,
-              onChange: (event) => void update({
+              onChange: (event) => onAction({
                 action: event.currentTarget.checked ? "enable" : "disable",
                 catalogId: catalog.id
               })
@@ -184,23 +270,26 @@ function AiKnowledgeSettings({ knowledge }) {
           "Use ",
           catalog.name
         ] }),
-        (catalog.installedVersion === null || catalog.updateAvailable) && /* @__PURE__ */ jsx(
+        catalog.updateAvailable && /* @__PURE__ */ jsxs(
           "button",
           {
             type: "button",
             className: "db-settings-action",
             disabled: busy,
-            onClick: () => void update({ action: "install", catalogId: catalog.id }),
-            children: catalog.updateAvailable ? `Update to ${catalog.version}` : "Download catalog"
+            onClick: () => onAction({ action: "install", catalogId: catalog.id }),
+            children: [
+              "Update to ",
+              catalog.version
+            ]
           }
         ),
-        catalog.installedVersion !== null && /* @__PURE__ */ jsxs(
+        /* @__PURE__ */ jsxs(
           "button",
           {
             type: "button",
             className: "db-settings-action db-settings-action--secondary",
             disabled: busy,
-            onClick: () => setRemoving(catalog.id),
+            onClick: () => onRemoving(true),
             children: [
               "Remove ",
               catalog.name,
@@ -209,34 +298,154 @@ function AiKnowledgeSettings({ knowledge }) {
           }
         )
       ] }),
-      removing === catalog.id && /* @__PURE__ */ jsxs("div", { role: "group", "aria-label": `Confirm removal of ${catalog.name}`, children: [
+      removing && /* @__PURE__ */ jsxs("div", { role: "group", "aria-label": `Confirm removal of ${catalog.name}`, children: [
         /* @__PURE__ */ jsxs("p", { className: "db-settings-hint", children: [
           "Remove ",
           catalog.name,
           " from the connected AI service? Other apps using that service will also lose access to this catalog."
         ] }),
+        /* @__PURE__ */ jsxs("div", { className: "db-settings-ai-knowledge-actions", children: [
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "db-settings-action",
+              disabled: busy,
+              onClick: () => onAction({ action: "remove", catalogId: catalog.id }),
+              children: "Confirm removal"
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "db-settings-action db-settings-action--secondary",
+              onClick: () => onRemoving(false),
+              children: "Keep catalog"
+            }
+          )
+        ] })
+      ] })
+    ] })
+  ] });
+}
+function AddCatalogDialog({
+  catalogs,
+  busy,
+  problem,
+  onAction,
+  onRefresh,
+  onClose
+}) {
+  const [query, setQuery] = useState("");
+  const searchRef = useRef(null);
+  const [order] = useState(
+    () => [...catalogs].sort((a, b) => Number(a.installedVersion !== null) - Number(b.installedVersion !== null)).map((catalog) => catalog.id)
+  );
+  const rank = (catalog) => {
+    const index = order.indexOf(catalog.id);
+    return index < 0 ? order.length : index;
+  };
+  const needle = query.trim().toLowerCase();
+  const matches = catalogs.filter((catalog) => `${catalog.name} ${catalog.description}`.toLowerCase().includes(needle)).sort((a, b) => rank(a) - rank(b));
+  const dialog = /* @__PURE__ */ jsxs(
+    Dialog,
+    {
+      title: "Add knowledge catalog",
+      size: "wide",
+      onClose,
+      initialFocusRef: searchRef,
+      className: "db-knowledge-add-dialog",
+      bodyClassName: "db-knowledge-add-body",
+      footer: /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsx(
           "button",
           {
             type: "button",
-            className: "db-settings-action",
+            className: "db-settings-action db-settings-action--secondary",
             disabled: busy,
-            onClick: () => void update({ action: "remove", catalogId: catalog.id }),
-            children: "Confirm removal"
+            onClick: onRefresh,
+            children: "Refresh catalogs"
           }
         ),
-        /* @__PURE__ */ jsx(
-          "button",
-          {
-            type: "button",
-            className: "db-settings-action db-settings-action--secondary",
-            onClick: () => setRemoving(null),
-            children: "Keep catalog"
-          }
-        )
-      ] })
-    ] }, catalog.id)) })
-  ] });
+        /* @__PURE__ */ jsx("button", { type: "button", className: "db-settings-action", onClick: onClose, children: "Done" })
+      ] }),
+      children: [
+        /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: "Catalogs come from the connected AI service. Once one is downloaded, relevant passages from it are included in AI writing, review, and chat." }),
+        problem && /* @__PURE__ */ jsx("p", { className: "db-settings-hint db-settings-ai-error", role: "alert", children: problem }),
+        /* @__PURE__ */ jsxs("label", { className: "db-settings-text db-knowledge-search", children: [
+          "Search catalogs",
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              ref: searchRef,
+              className: "db-settings-text-input",
+              type: "search",
+              value: query,
+              onChange: (event) => setQuery(event.currentTarget.value)
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx("p", { className: "db-settings-hint", role: "status", children: matches.length > 0 ? "" : catalogs.length === 0 ? "The connected AI service doesn\u2019t offer any catalogs right now." : `No catalogs match \u201C${query.trim()}\u201D.` }),
+        matches.length > 0 && /* @__PURE__ */ jsx("ul", { className: "db-knowledge-catalog-list", "aria-label": "Catalogs", children: matches.map((catalog) => /* @__PURE__ */ jsxs("li", { className: "db-knowledge-catalog", children: [
+          /* @__PURE__ */ jsxs("div", { className: "db-knowledge-catalog-text", children: [
+            /* @__PURE__ */ jsx("strong", { className: "db-knowledge-catalog-name", children: /* @__PURE__ */ jsx(HighlightedText, { text: catalog.name, ranges: matchRanges(catalog.name, needle) }) }),
+            /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: /* @__PURE__ */ jsx(
+              HighlightedText,
+              {
+                text: catalog.description,
+                ranges: matchRanges(catalog.description, needle)
+              }
+            ) }),
+            /* @__PURE__ */ jsx("p", { className: "db-settings-hint", children: catalogFacts(catalog, catalog.version) }),
+            catalog.message && /* @__PURE__ */ jsx(
+              "p",
+              {
+                className: "db-settings-hint",
+                role: catalog.state === "error" ? "alert" : "status",
+                children: catalog.message
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsx("div", { className: "db-knowledge-catalog-action", children: catalog.state === "downloading" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx(
+              "progress",
+              {
+                max: 100,
+                value: catalog.percent ?? void 0,
+                "aria-label": `${catalog.name} download progress`
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                className: "db-settings-action db-settings-action--secondary",
+                disabled: busy,
+                "aria-label": `Cancel ${catalog.name} download`,
+                onClick: () => onAction({ action: "cancel", catalogId: catalog.id }),
+                children: "Cancel"
+              }
+            )
+          ] }) : catalog.installedVersion !== null ? /* @__PURE__ */ jsxs("span", { className: "db-knowledge-catalog-added", children: [
+            /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\u2713 " }),
+            "Downloaded"
+          ] }) : /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "db-settings-action",
+              disabled: busy,
+              "aria-label": `Download ${catalog.name}`,
+              onClick: () => onAction({ action: "install", catalogId: catalog.id }),
+              children: "Download"
+            }
+          ) })
+        ] }, catalog.id)) })
+      ]
+    }
+  );
+  return typeof document === "undefined" ? dialog : createPortal(dialog, document.body);
 }
 
 // src/Settings/AiSettings.tsx
@@ -329,7 +538,7 @@ function AiSettingsControls({ ai }) {
   const [failure, setFailure] = useState2(null);
   const mounted = useRef2(true);
   const installHandle = useRef2(null);
-  const modelSelectId = useId();
+  const modelSelectId = useId2();
   useEffect2(() => {
     mounted.current = true;
     setProviderInstalled(false);
@@ -637,7 +846,7 @@ function AiSettingsControls({ ai }) {
 }
 
 // src/Settings/WorkspaceSettingsControls.tsx
-import { useEffect as useEffect3, useId as useId2, useState as useState3 } from "react";
+import { useEffect as useEffect3, useId as useId3, useState as useState3 } from "react";
 import {
   DEFAULT_CATALOG_HTML_PATH,
   DEFAULT_CATALOG_JSON_PATH,
@@ -690,7 +899,7 @@ function WorkspaceSettingsControls({
   onRegenerate,
   regenerating = false
 }) {
-  const id = useId2();
+  const id = useId3();
   const htmlEnabled = value.catalog?.html?.enabled === true;
   const jsonEnabled = value.catalog?.json?.enabled === true;
   const catalogEnabled = htmlEnabled || jsonEnabled;
@@ -992,7 +1201,7 @@ function WorkspaceSettingsControls({
 import {
   useCallback as useCallback2,
   useEffect as useEffect4,
-  useId as useId3,
+  useId as useId4,
   useLayoutEffect,
   useRef as useRef3,
   useState as useState4
@@ -1430,8 +1639,8 @@ function FontSchemePicker({ value, onChange }) {
   const triggerRef = useRef3(null);
   const listboxRef = useRef3(null);
   const optionRefs = useRef3([]);
-  const labelId = useId3();
-  const listboxId = useId3();
+  const labelId = useId4();
+  const listboxId = useId4();
   const close = useCallback2((returnFocus) => {
     setIsOpen(false);
     setMenuPosition(null);

package/dist/{chunk-KBDZDFPU.js → chunk-BNKIPCXO.js}

@@ -22,6 +22,9 @@ function abortable(promise, signal) {
     );
   });
 }
+function stripPauseEllipses(transcript) {
+  return transcript.replace(/(?:\.{3,}|…)+/gu, " ").replace(/\s+([,;:!?]|\.(?=\s|$))/gu, "$1").replace(/\s+/gu, " ").trim();
+}
 function createSpeechInputProvider(speech, options) {
   const transcribe = speech.transcribe;
   return {
@@ -51,7 +54,7 @@ function createSpeechInputProvider(speech, options) {
         signal
       );
       if (!result.ok) throw new Error(result.error.message);
-      return { text: result.value.text };
+      return { text: stripPauseEllipses(result.value.text) };
     }
   };
 }

package/dist/{chunk-2IYBBFQX.js → chunk-BZRYQENB.js}

@@ -57,6 +57,7 @@ var ProgressivePlayer = class _ProgressivePlayer {
       this.playbackOffset = 0;
     }
     await this.context.resume();
+    if (this.playing || this.disposed) return this.playing;
     this.stopSources();
     this.playing = true;
     this.playbackStartedAt = this.context.currentTime + 0.025;
@@ -82,6 +83,19 @@ var ProgressivePlayer = class _ProgressivePlayer {
     if (wasPlaying) void this.play();
     else this.emit();
   }
+  /** Drop the whole timeline but keep the audio context, to start again from a new place. */
+  reset() {
+    if (this.disposed) return;
+    this.playing = false;
+    this.stopSources();
+    this.clearEndTimer();
+    this.chunks.length = 0;
+    this.pending.clear();
+    this.bufferedDuration = 0;
+    this.playbackOffset = 0;
+    this.complete = false;
+    this.emit();
+  }
   /** No more chunks will arrive. */
   finish() {
     this.complete = true;
@@ -173,25 +187,54 @@ var ProgressivePlayer = class _ProgressivePlayer {
     if (!this.disposed) this.onChange(this.snapshot());
   }
 };
+var MIN_AHEAD_SECONDS = 3;
+var LOOKAHEAD_SECONDS = 60;
 var AutoPlayGate = class {
   constructor() {
-    this.firstAt = null;
-    this.firstDuration = 0;
-    this.firstCharacters = 0;
-  }
-  /** Call after each appended chunk; true when it is safe to start playing. */
-  ready(snapshot, progress, nowMs) {
-    if (this.firstAt === null) {
-      this.firstAt = nowMs;
-      this.firstDuration = snapshot.bufferedDuration;
-      this.firstCharacters = progress?.completedCharacters ?? 0;
+    this.spokenCharacters = 0;
+    this.spokenSeconds = 0;
+    this.timedCharacters = 0;
+    this.busySeconds = 0;
+    this.lastAt = null;
+  }
+  /**
+   * Record a synthesized chunk. The first chunk after `restart()` only marks
+   * the clock, so model loading and skips are not counted against synthesis.
+   */
+  record(characters, audioSeconds, nowMs) {
+    this.spokenCharacters += characters;
+    this.spokenSeconds += audioSeconds;
+    if (this.lastAt !== null) {
+      this.timedCharacters += characters;
+      this.busySeconds += (nowMs - this.lastAt) / 1e3;
+    }
+    this.lastAt = nowMs;
+  }
+  /** Synthesis stopped and starts again; the next gap is not a rate sample. */
+  restart() {
+    this.lastAt = null;
+  }
+  /**
+   * True when `ahead` seconds of buffered audio should carry playback through
+   * the sentences still to be synthesized, given as character counts in order.
+   * The first of them has been synthesizing since the last recorded chunk.
+   */
+  ready(ahead, upcoming, nowMs) {
+    if (this.busySeconds <= 0.25 || this.timedCharacters <= 0 || this.spokenCharacters <= 0) {
+      return false;
+    }
+    const charactersPerSecond = this.timedCharacters / this.busySeconds;
+    const secondsPerCharacter = this.spokenSeconds / this.spokenCharacters;
+    let arrives = this.lastAt === null ? 0 : -(nowMs - this.lastAt) / 1e3;
+    let startsAfter = 0;
+    let stall = 0;
+    for (const characters of upcoming) {
+      arrives = Math.max(0, arrives + characters / charactersPerSecond);
+      stall = Math.max(stall, arrives - startsAfter);
+      startsAfter += characters * secondsPerCharacter;
+      if (startsAfter >= LOOKAHEAD_SECONDS) break;
     }
-    const elapsed = (nowMs - this.firstAt) / 1e3;
-    const audioRate = elapsed > 0.25 ? (snapshot.bufferedDuration - this.firstDuration) / elapsed : 0;
-    const characterRate = elapsed > 0.25 ? ((progress?.completedCharacters ?? 0) - this.firstCharacters) / elapsed : 0;
-    const remaining = progress && characterRate > 0 ? (progress.totalCharacters - progress.completedCharacters) / characterRate : Number.POSITIVE_INFINITY;
-    const ahead = snapshot.bufferedDuration - snapshot.currentTime;
-    return ahead >= 4 && (audioRate >= 1.15 || ahead >= remaining + 3);
+    return ahead >= Math.max(MIN_AHEAD_SECONDS, stall);
   }
 };
 

package/dist/{chunk-GFK4TCKN.js → chunk-G63YXKBC.js}

@@ -343,11 +343,14 @@ function ExportDialog({
             }
           )
         ] }),
-        /* @__PURE__ */ jsxs("p", { className: "db-export-more-formats", children: [
-          "Need spreadsheets, animated media, portable bundles, or automation?",
-          " ",
-          /* @__PURE__ */ jsx("a", { href: "https://docblocks.com/cli/", target: "_blank", rel: "noopener noreferrer", children: "More formats with the DocBlocks CLI" }),
-          "."
+        /* @__PURE__ */ jsxs("details", { className: "db-export-more-formats", children: [
+          /* @__PURE__ */ jsx("summary", { children: "More formats and automation" }),
+          /* @__PURE__ */ jsxs("p", { children: [
+            "Need spreadsheets, portable bundles, or batch exports?",
+            " ",
+            /* @__PURE__ */ jsx("a", { href: "https://docblocks.com/cli/", target: "_blank", rel: "noopener noreferrer", children: "Explore the DocBlocks CLI" }),
+            "."
+          ] })
         ] }),
         error && /* @__PURE__ */ jsx("p", { className: "db-export-error", role: "alert", children: error })
       ]