@bendyline/docblocks-react 2.3.0 → 2.3.2

package/THIRD_PARTY_NOTICES.txt

@@ -15,12 +15,12 @@ This notice is included in the published npm tarball. Transitive packages instal
 | Package | Version | License | Source |
 | --- | --- | --- | --- |
 | @antfu/install-pkg | 1.1.0 | MIT | https://github.com/antfu/install-pkg |
-| @bendyline/squisq | 2.4.3 | MIT | https://github.com/bendyline/squisq |
-| @bendyline/squisq-editor-react | 2.4.5 | MIT | https://github.com/bendyline/squisq |
-| @bendyline/squisq-formats | 2.3.7 | MIT | https://github.com/bendyline/squisq |
-| @bendyline/squisq-react | 2.4.5 | MIT | https://github.com/bendyline/squisq |
-| @bendyline/squisq-video | 2.2.7 | MIT | https://github.com/bendyline/squisq |
-| @bendyline/squisq-video-react | 2.2.9 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.4.4 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq-editor-react | 2.4.7 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq-formats | 2.3.9 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq-react | 2.4.7 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq-video | 2.2.8 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq-video-react | 2.2.11 | MIT | https://github.com/bendyline/squisq |
 | @braintree/sanitize-url | 7.1.2 | MIT | https://github.com/braintree/sanitize-url |
 | @chevrotain/types | 11.1.2 | Apache-2.0 | https://github.com/Chevrotain/chevrotain |
 | @ffmpeg/core | 0.12.9 | GPL-2.0-or-later | https://github.com/ffmpegwasm/ffmpeg.wasm |
@@ -398,7 +398,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq-editor-react@2.4.5, @bendyline/squisq-formats@2.3.7, @bendyline/squisq-react@2.4.5, @bendyline/squisq-video-react@2.2.9, @bendyline/squisq-video@2.2.7, @bendyline/squisq@2.4.3
+Components: @bendyline/squisq-editor-react@2.4.7, @bendyline/squisq-formats@2.3.9, @bendyline/squisq-react@2.4.7, @bendyline/squisq-video-react@2.2.11, @bendyline/squisq-video@2.2.8, @bendyline/squisq@2.4.4
 Source files: node_modules/@bendyline/squisq-editor-react/LICENSE, node_modules/@bendyline/squisq-formats/LICENSE, node_modules/@bendyline/squisq-react/LICENSE, node_modules/@bendyline/squisq-video-react/LICENSE, node_modules/@bendyline/squisq-video/LICENSE, node_modules/@bendyline/squisq/LICENSE
 ==============================================================================
 MIT License
@@ -564,7 +564,7 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq-editor-react@2.4.5
+Components: @bendyline/squisq-editor-react@2.4.7
 Source files: node_modules/@bendyline/squisq-editor-react/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq-editor-react
@@ -611,7 +611,7 @@ Exact third-party license texts for the bundled adapter, loader, state helper,
 and Font Awesome assets are shipped in THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq-editor-react@2.4.5, @tiptap/core@2.27.2, @tiptap/extension-blockquote@2.27.2, @tiptap/extension-bold@2.27.2, @tiptap/extension-bubble-menu@2.27.2, @tiptap/extension-bullet-list@2.27.2, @tiptap/extension-code-block@2.27.2, @tiptap/extension-code@2.27.2, @tiptap/extension-document@2.27.2, @tiptap/extension-dropcursor@2.27.2, @tiptap/extension-floating-menu@2.27.2, @tiptap/extension-gapcursor@2.27.2, @tiptap/extension-hard-break@2.27.2, @tiptap/extension-heading@2.27.2, @tiptap/extension-history@2.27.2, @tiptap/extension-horizontal-rule@2.27.2, @tiptap/extension-image@2.27.2, @tiptap/extension-italic@2.27.2, @tiptap/extension-link@2.27.2, @tiptap/extension-list-item@2.27.2, @tiptap/extension-mention@2.27.2, @tiptap/extension-ordered-list@2.27.2, @tiptap/extension-paragraph@2.27.2, @tiptap/extension-placeholder@2.27.2, @tiptap/extension-strike@2.27.2, @tiptap/extension-table-cell@2.27.2, @tiptap/extension-table-header@2.27.2, @tiptap/extension-table-row@2.27.2, @tiptap/extension-table@2.27.2, @tiptap/extension-task-item@2.27.2, @tiptap/extension-task-list@2.27.2, @tiptap/extension-text-style@2.27.2, @tiptap/extension-text@2.27.2, @tiptap/pm@2.27.2, @tiptap/react@2.27.2, @tiptap/starter-kit@2.27.2, @tiptap/suggestion@2.27.2
+Components: @bendyline/squisq-editor-react@2.4.7, @tiptap/core@2.27.2, @tiptap/extension-blockquote@2.27.2, @tiptap/extension-bold@2.27.2, @tiptap/extension-bubble-menu@2.27.2, @tiptap/extension-bullet-list@2.27.2, @tiptap/extension-code-block@2.27.2, @tiptap/extension-code@2.27.2, @tiptap/extension-document@2.27.2, @tiptap/extension-dropcursor@2.27.2, @tiptap/extension-floating-menu@2.27.2, @tiptap/extension-gapcursor@2.27.2, @tiptap/extension-hard-break@2.27.2, @tiptap/extension-heading@2.27.2, @tiptap/extension-history@2.27.2, @tiptap/extension-horizontal-rule@2.27.2, @tiptap/extension-image@2.27.2, @tiptap/extension-italic@2.27.2, @tiptap/extension-link@2.27.2, @tiptap/extension-list-item@2.27.2, @tiptap/extension-mention@2.27.2, @tiptap/extension-ordered-list@2.27.2, @tiptap/extension-paragraph@2.27.2, @tiptap/extension-placeholder@2.27.2, @tiptap/extension-strike@2.27.2, @tiptap/extension-table-cell@2.27.2, @tiptap/extension-table-header@2.27.2, @tiptap/extension-table-row@2.27.2, @tiptap/extension-table@2.27.2, @tiptap/extension-task-item@2.27.2, @tiptap/extension-task-list@2.27.2, @tiptap/extension-text-style@2.27.2, @tiptap/extension-text@2.27.2, @tiptap/pm@2.27.2, @tiptap/react@2.27.2, @tiptap/starter-kit@2.27.2, @tiptap/suggestion@2.27.2
 Source files: node_modules/@bendyline/squisq-editor-react/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq-editor-react
@@ -884,7 +884,7 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq-formats@2.3.7
+Components: @bendyline/squisq-formats@2.3.9
 Source files: node_modules/@bendyline/squisq-formats/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq-formats
@@ -909,7 +909,7 @@ texts for these dependencies are included in their respective npm
 distributions and source repositories.
 
 ==============================================================================
-Components: @bendyline/squisq-formats@2.3.7
+Components: @bendyline/squisq-formats@2.3.9
 Source files: node_modules/@bendyline/squisq-formats/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq-formats
@@ -1091,7 +1091,7 @@ Awesome, nor vice versa. **Please do not use brand logos for any purpose except
 to represent the company, product, or service to which they refer.**
 
 ==============================================================================
-Components: @bendyline/squisq-react@2.4.5
+Components: @bendyline/squisq-react@2.4.7
 Source files: node_modules/@bendyline/squisq-react/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq-react
@@ -1102,12 +1102,13 @@ Third-party components remain under their respective license terms.
 
 ## Runtime, peer, and bundled dependencies
 
-| Package            | Version              | License | Repository                            |
-| ------------------ | -------------------- | ------- | ------------------------------------- |
-| mermaid            | 11.16.0              | MIT     | https://github.com/mermaid-js/mermaid |
-| preact _(bundled)_ | 10.29.0              | MIT     | https://github.com/preactjs/preact    |
-| react _(peer)_     | ^18.0.0 \|\| ^19.0.0 | MIT     | https://github.com/facebook/react     |
-| react-dom _(peer)_ | ^18.0.0 \|\| ^19.0.0 | MIT     | https://github.com/facebook/react     |
+| Package                       | Version              | License                       | Repository                                  |
+| ----------------------------- | -------------------- | ----------------------------- | ------------------------------------------- |
+| @fortawesome/fontawesome-free | 7.2.0                | CC-BY-4.0 AND OFL-1.1 AND MIT | https://github.com/FortAwesome/Font-Awesome |
+| mermaid                       | 11.16.0              | MIT                           | https://github.com/mermaid-js/mermaid       |
+| preact _(bundled)_            | 10.29.0              | MIT                           | https://github.com/preactjs/preact          |
+| react _(peer)_                | ^18.0.0 \|\| ^19.0.0 | MIT                           | https://github.com/facebook/react           |
+| react-dom _(peer)_            | ^18.0.0 \|\| ^19.0.0 | MIT                           | https://github.com/facebook/react           |
 
 Mermaid is Copyright (c) 2014-2022 Knut Sveidqvist and is distributed under
 the MIT License. Preact is used by the standalone browser bundles. Exact
@@ -1115,7 +1116,7 @@ third-party license texts for the complete standalone bundle graph are shipped
 in THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq-react@2.4.5
+Components: @bendyline/squisq-react@2.4.7
 Source files: node_modules/@bendyline/squisq-react/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq-react
@@ -5588,7 +5589,7 @@ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq-video-react@2.2.9, @ffmpeg/core@0.12.9
+Components: @bendyline/squisq-video-react@2.2.11, @ffmpeg/core@0.12.9
 Source files: node_modules/@bendyline/squisq-video-react/COPYING.GPL-2.0.txt
 ==============================================================================
                     GNU GENERAL PUBLIC LICENSE
@@ -5931,7 +5932,7 @@ library.  If this is what you want to do, use the GNU Lesser General
 Public License instead of this License.
 
 ==============================================================================
-Components: @bendyline/squisq-video-react@2.2.9, @ffmpeg/core@0.12.9
+Components: @bendyline/squisq-video-react@2.2.11, @ffmpeg/core@0.12.9
 Source files: node_modules/@bendyline/squisq-video-react/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq-video-react
@@ -5976,7 +5977,7 @@ global WebCodecs declaration dependencies are not installed for consumers. Its
 exact license text is shipped in THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq-video-react@2.2.9, @ffmpeg/core@0.12.9, @ffmpeg/ffmpeg@0.12.15, @ffmpeg/types@0.12.4, @ffmpeg/util@0.12.2
+Components: @bendyline/squisq-video-react@2.2.11, @ffmpeg/core@0.12.9, @ffmpeg/ffmpeg@0.12.15, @ffmpeg/types@0.12.4, @ffmpeg/util@0.12.2
 Source files: node_modules/@bendyline/squisq-video-react/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq-video-react
@@ -6040,7 +6041,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq-video@2.2.7
+Components: @bendyline/squisq-video@2.2.8
 Source files: node_modules/@bendyline/squisq-video/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq-video
@@ -6065,7 +6066,7 @@ Copyright and complete license texts for the listed dependencies are included
 in their respective npm distributions and source repositories.
 
 ==============================================================================
-Components: @bendyline/squisq-video@2.2.7
+Components: @bendyline/squisq-video@2.2.8
 Source files: node_modules/@bendyline/squisq-video/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq-video
@@ -6077,7 +6078,7 @@ repository license, the pinned upstream copy is vendored and identified below.
 COMPONENTS
 
 ==============================================================================
-Components: @bendyline/squisq@2.4.3
+Components: @bendyline/squisq@2.4.4
 Source files: node_modules/@bendyline/squisq/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq
@@ -6108,7 +6109,7 @@ third-party license texts for bundled code and data are shipped in
 THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq@2.4.3
+Components: @bendyline/squisq@2.4.4
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{ExportDialog-HPFPXELL.js → ExportDialog-VBWHFJ2R.js}

@@ -1,6 +1,6 @@
 import {
   ExportDialog
-} from "./chunk-MHTQORMH.js";
+} from "./chunk-SIIEGOHY.js";
 import "./chunk-YBEYTVU2.js";
 import "./chunk-LG6HAWCK.js";
 import "./chunk-EBWYGTN7.js";

package/dist/{ExportToolbarControls-6MO4NX6H.js → ExportToolbarControls-5D4R6UXA.js}

@@ -1,3 +1,7 @@
+import {
+  browserSaveMode,
+  saveActionLabel
+} from "./chunk-UMEDHMT7.js";
 import {
   useMenuKeyboard
 } from "./chunk-MRUK56JS.js";
@@ -7,6 +11,9 @@ import {
 import {
   Dialog
 } from "./chunk-LG6HAWCK.js";
+import {
+  buildExportFilename
+} from "./chunk-M5Y5WO7Z.js";
 import {
   DEFAULT_OPTIONS,
   FORMAT_EXTENSIONS,
@@ -29,14 +36,14 @@ import { getThemeSummaries } from "@bendyline/squisq/schemas";
 import { parseMarkdown } from "@bendyline/squisq/markdown";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var ExportDialog = lazy(
-  () => import("./ExportDialog-HPFPXELL.js").then((module) => ({ default: module.ExportDialog }))
+  () => import("./ExportDialog-VBWHFJ2R.js").then((module) => ({ default: module.ExportDialog }))
 );
 var ShareDialog = lazy(
   () => import("./ShareDialog-PAMOQQFB.js").then((module) => ({ default: module.ShareDialog }))
 );
 var runExportModulePromise = null;
 function loadRunExportModule() {
-  runExportModulePromise ?? (runExportModulePromise = import("./run-export-Z5BVFLIR.js"));
+  runExportModulePromise ?? (runExportModulePromise = import("./run-export-UYR5USUJ.js"));
   return runExportModulePromise;
 }
 var ExportCancelledError = class extends Error {
@@ -69,6 +76,7 @@ function loadVideoExportModules() {
   ]).then(([docModule, videoModule, playerModule]) => ({
     Modal: videoModule.VideoExportModal,
     markdownToDoc: docModule.markdownToDoc,
+    resolveAudioMapping: docModule.resolveAudioMapping,
     playerScript: playerModule.PLAYER_BUNDLE
   })));
   return videoExportModulesPromise;
@@ -77,7 +85,7 @@ function exportErrorMessage(caught) {
   const detail = caught instanceof Error ? caught.message.replace(/^Error invoking remote method '[^']+': Error:\s*/, "").trim() : "";
   return detail ? `Export failed: ${detail}` : "Export failed. The document could not be exported.";
 }
-function quickLabel(opts, transformSummaries, destinationPath) {
+function quickLabel(opts, transformSummaries, saveMode, destinationPath) {
   const baseExt = FORMAT_EXTENSIONS[opts.format].toUpperCase().replace(".", "");
   const isRecursiveHtml = opts.format === "html" && opts.includeLinkedDocs;
   const ext = opts.format === "html" && (opts.htmlBundle === "zip" || isRecursiveHtml) ? "ZIP" : baseExt;
@@ -96,16 +104,19 @@ function quickLabel(opts, transformSummaries, destinationPath) {
     const transform = transformSummaries.find((t) => t.id === opts.transformStyle);
     if (transform) parts.push(transform.name);
   }
+  const prefix = `Save ${ext}`;
+  let label = prefix;
   if (parts.length > 0) {
-    const label2 = `Export ${ext} with ${parts.join(" + ")}`;
-    return destinationPath ? `${label2} to ${destinationPath}` : label2;
+    label = `${prefix} with ${parts.join(" + ")}`;
   }
-  const label = `Export ${ext}`;
+  if (saveMode === "save-as") return `${label} as...`;
+  if (saveMode === "downloads") return `${label} to Downloads`;
   return destinationPath ? `${label} to ${destinationPath}` : label;
 }
 function ExportToolbarControls({
   selectedFile,
   mediaContainer,
+  workspaceContainer,
   mediaProvider,
   saveBlob,
   destinationAdapter,
@@ -188,9 +199,7 @@ function ExportToolbarControls({
     let cancelled = false;
     setQuickDestination(null);
     setQuickDestinationPending(true);
-    void loadRunExportModule().then(
-      ({ buildExportFilename }) => destinationAdapter.resolveTarget(buildExportFilename(selectedFile, quickOptions))
-    ).then((target) => {
+    void destinationAdapter.resolveTarget(buildExportFilename(selectedFile, quickOptions)).then((target) => {
       if (!cancelled) setQuickDestination({ key: quickDestinationKey, target });
     }).catch(() => {
       if (!cancelled) setQuickDestination(null);
@@ -214,7 +223,6 @@ function ExportToolbarControls({
       const requestId = destinationRequestRef.current + 1;
       destinationRequestRef.current = requestId;
       try {
-        const { buildExportFilename } = await loadRunExportModule();
         const filename = buildExportFilename(selectedFile, options);
         const target = await destinationAdapter.resolveTarget(filename);
         if (destinationRequestRef.current === requestId) setDestinationTarget(target);
@@ -258,14 +266,16 @@ function ExportToolbarControls({
       try {
         const modules = videoModules ?? await loadVideoExportModules();
         setVideoModules(modules);
-        setVideoDoc(modules.markdownToDoc(parseMarkdown(markdownSource)));
+        const parsedDoc = modules.markdownToDoc(parseMarkdown(markdownSource));
+        const exportDoc = workspaceContainer ? await modules.resolveAudioMapping(parsedDoc, workspaceContainer) : parsedDoc;
+        setVideoDoc(exportDoc);
       } catch {
         setVideoLoadError("Video export could not be loaded.");
       } finally {
         setVideoLoading(false);
       }
     },
-    [markdownSource, videoModules]
+    [markdownSource, videoModules, workspaceContainer]
   );
   const handleCloseVideoModal = useCallback(() => {
     setVideoModalOpen(false);
@@ -282,7 +292,6 @@ function ExportToolbarControls({
     async (options) => {
       if (!destinationAdapter) return;
       try {
-        const { buildExportFilename } = await loadRunExportModule();
         const filename = buildExportFilename(selectedFile, options);
         const pickedTarget = await destinationAdapter.pickTarget(filename, destinationTarget);
         if (pickedTarget === null) return;
@@ -302,24 +311,25 @@ function ExportToolbarControls({
     },
     [destinationAdapter]
   );
-  const handleDestinationSaveBlob = useCallback(
-    async (blob, filename) => {
-      await saveToDestination(blob, filename, destinationTarget);
-    },
-    [destinationTarget, saveToDestination]
-  );
   const handleExport = useCallback(
     async (opts) => {
       setExporting(true);
       setExportError(null);
       try {
+        let exportTarget = destinationTarget;
+        if (destinationAdapter?.pickBeforeSave) {
+          const filename = buildExportFilename(selectedFile, opts);
+          exportTarget = await destinationAdapter.pickTarget(filename, destinationTarget);
+          if (!exportTarget) return;
+          setDestinationTarget(exportTarget);
+        }
         const { runExport } = await loadRunExportModule();
         await runExport(
           markdownSource,
           selectedFile,
           opts,
           mediaContainer,
-          destinationAdapter ? handleDestinationSaveBlob : saveBlob
+          destinationAdapter ? (blob, filename) => saveToDestination(blob, filename, exportTarget) : saveBlob
         );
         setDialogOpen(false);
       } catch (caught) {
@@ -333,7 +343,8 @@ function ExportToolbarControls({
       selectedFile,
       mediaContainer,
       destinationAdapter,
-      handleDestinationSaveBlob,
+      destinationTarget,
+      saveToDestination,
       saveBlob
     ]
   );
@@ -344,12 +355,18 @@ function ExportToolbarControls({
     setExportError(null);
     try {
       saveExportOptions(lastOptions);
-      const { runExport } = await loadRunExportModule();
       let quickTarget = null;
       if (destinationAdapter) {
-        if (!quickDestinationTarget) return;
-        quickTarget = quickDestinationTarget;
+        if (destinationAdapter.pickBeforeSave) {
+          const filename = buildExportFilename(selectedFile, lastOptions);
+          quickTarget = await destinationAdapter.pickTarget(filename, quickDestinationTarget);
+          if (!quickTarget) return;
+        } else {
+          if (!quickDestinationTarget) return;
+          quickTarget = quickDestinationTarget;
+        }
       }
+      const { runExport } = await loadRunExportModule();
       await runExport(
         markdownSource,
         selectedFile,
@@ -375,8 +392,18 @@ function ExportToolbarControls({
   const handleDismissExportError = useCallback(() => {
     setExportError(null);
   }, []);
+  const handleVideoSave = useCallback(
+    async (blob, filename) => {
+      if (!destinationAdapter) return false;
+      const target = await destinationAdapter.pickTarget(filename, null);
+      if (!target) return false;
+      return await destinationAdapter.saveBlob(blob, filename, target) !== null;
+    },
+    [destinationAdapter]
+  );
   const LoadedVideoExportModal = videoModules?.Modal;
   const showAnimatedGifExport = showVideoExport && typeof ffmpegWasm?.coreURL === "string" && ffmpegWasm.coreURL.length > 0;
+  const quickSaveMode = destinationAdapter ? destinationAdapter.pickBeforeSave ? "save-as" : "destination" : "downloads";
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     initialSharedMode && /* @__PURE__ */ jsx(SharedModeInitializer, { mode: initialSharedMode }),
     trigger === "button" ? /* @__PURE__ */ jsx(
@@ -429,13 +456,15 @@ function ExportToolbarControls({
                 title: quickDestinationTarget ? quickLabel(
                   lastOptions,
                   transformSummaries,
-                  quickDestinationTarget.displayPath
+                  quickSaveMode,
+                  destinationAdapter?.pickBeforeSave ? void 0 : quickDestinationTarget.displayPath
                 ) : void 0,
                 children: quickDestinationTarget ? quickLabel(
                   lastOptions,
                   transformSummaries,
-                  quickDestinationTarget.displayPath
-                ) : quickLabel(lastOptions, transformSummaries) + (destinationAdapter ? quickDestinationPending ? " (finding destination...)" : " (destination unavailable)" : "")
+                  quickSaveMode,
+                  destinationAdapter?.pickBeforeSave ? void 0 : quickDestinationTarget.displayPath
+                ) : quickLabel(lastOptions, transformSummaries, quickSaveMode) + (destinationAdapter ? quickDestinationPending ? " (finding destination...)" : " (destination unavailable)" : "")
               }
             ),
             /* @__PURE__ */ jsx(
@@ -446,7 +475,7 @@ function ExportToolbarControls({
                 tabIndex: -1,
                 className: "db-toolbar-menu-item",
                 onClick: handleOpenDialog,
-                children: "Export..."
+                children: "Export document..."
               }
             ),
             /* @__PURE__ */ jsx(
@@ -495,13 +524,23 @@ function ExportToolbarControls({
         initial: dialogInitial,
         exporting,
         error: exportError,
-        destination: destinationAdapter ? {
+        destination: destinationAdapter && destinationAdapter.showDestination !== false ? {
           value: destinationTarget?.displayPath ?? "",
           onPick: handlePickDestination,
           hint: destinationAdapter.hint
         } : void 0,
         onExport: handleExport,
         onOptionsChange: destinationAdapter ? handleOptionsChange : void 0,
+        actionLabel: (options) => {
+          const extension = options.format === "html" && (options.includeLinkedDocs || options.htmlBundle === "zip") ? "ZIP" : FORMAT_EXTENSIONS[options.format].slice(1);
+          if (destinationAdapter && !destinationAdapter.pickBeforeSave) {
+            return `Save ${extension.toUpperCase()}`;
+          }
+          return saveActionLabel(
+            extension,
+            destinationAdapter?.pickBeforeSave ? "save-as" : browserSaveMode()
+          );
+        },
         onClose: handleCloseDialog
       }
     ) }),
@@ -552,6 +591,10 @@ function ExportToolbarControls({
           ...ffmpegWasm ? { ffmpegWasm } : {},
           outputFormat: videoOutputFormat
         },
+        ...destinationAdapter ? {
+          saveOutput: handleVideoSave,
+          saveActionLabel: (format) => saveActionLabel(format, "save-as")
+        } : {},
         onClose: handleCloseVideoModal
       }
     )

package/dist/chunk-M5Y5WO7Z.js

@@ -0,0 +1,17 @@
+import {
+  FORMAT_EXTENSIONS
+} from "./chunk-EBWYGTN7.js";
+
+// src/Export/export-filename.ts
+function buildExportFilename(selectedFile, options) {
+  const base = selectedFile ? selectedFile.replace(/^\//, "").replace(/\.[^.]+$/, "") : "document";
+  if (options.format === "html") {
+    if (options.includeLinkedDocs || options.htmlBundle === "zip") return `${base}.zip`;
+    if (options.entryAsIndex) return "index.html";
+  }
+  return base + FORMAT_EXTENSIONS[options.format];
+}
+
+export {
+  buildExportFilename
+};

package/dist/{chunk-GHQ4X7KM.js → chunk-OSQUKIUN.js}

@@ -31,14 +31,6 @@ function buildFilename(selectedFile, format) {
   const base = selectedFile ? selectedFile.replace(/^\//, "").replace(/\.[^.]+$/, "") : "document";
   return base + FORMAT_EXTENSIONS[format];
 }
-function buildExportFilename(selectedFile, options) {
-  const base = selectedFile ? selectedFile.replace(/^\//, "").replace(/\.[^.]+$/, "") : "document";
-  if (options.format === "html") {
-    if (options.includeLinkedDocs || options.htmlBundle === "zip") return `${base}.zip`;
-    if (options.entryAsIndex) return "index.html";
-  }
-  return base + FORMAT_EXTENSIONS[options.format];
-}
 async function runExport(markdown, selectedFile, options, mediaContainer, saveBlob, converterOverrides = {}) {
   const filename = buildFilename(selectedFile, options.format);
   const themeId = options.themeId !== "standard" ? options.themeId : void 0;
@@ -285,6 +277,5 @@ async function resolveDocImages(doc, container, collectImagePaths) {
 }
 
 export {
-  buildExportFilename,
   runExport
 };

package/dist/{chunk-MHTQORMH.js → chunk-SIIEGOHY.js}

@@ -76,6 +76,7 @@ function ExportDialog({
   destination,
   onExport,
   onOptionsChange,
+  actionLabel,
   onClose
 }) {
   const [format, setFormat] = useState(initial.format);
@@ -163,7 +164,7 @@ function ExportDialog({
             className: "db-export-btn db-export-btn--primary",
             onClick: handleExport,
             disabled: exporting || Boolean(destination?.error),
-            children: exporting ? "Exporting..." : "Export"
+            children: exporting ? "Exporting..." : actionLabel?.(currentOptions) ?? "Export"
           }
         )
       ] }),

package/dist/chunk-UMEDHMT7.js

@@ -0,0 +1,84 @@
+// src/Export/browser-save.ts
+var INSTALLED_DISPLAY_QUERIES = [
+  "(display-mode: window-controls-overlay)",
+  "(display-mode: standalone)"
+];
+function isInstalledWebApp() {
+  return typeof globalThis.matchMedia === "function" && INSTALLED_DISPLAY_QUERIES.some((query) => globalThis.matchMedia(query).matches);
+}
+function browserSaveMode() {
+  return isInstalledWebApp() && typeof window !== "undefined" && typeof window.showSaveFilePicker === "function" ? "save-as" : "downloads";
+}
+function saveActionLabel(format, mode) {
+  return mode === "save-as" ? `Save ${format.toUpperCase()} as...` : `Save ${format.toUpperCase()} to Downloads`;
+}
+function isPickerCancellation(caught) {
+  return caught instanceof DOMException && caught.name === "AbortError";
+}
+function pickerOptions(blob, filename) {
+  const extensionMatch = filename.match(/(\.[^./\\]+)$/);
+  const extension = extensionMatch?.[1]?.toLowerCase();
+  if (!extension) return { suggestedName: filename };
+  const mimeType = blob?.type || "application/octet-stream";
+  return {
+    suggestedName: filename,
+    types: [
+      {
+        description: `${extension.slice(1).toUpperCase()} file`,
+        accept: { [mimeType]: [extension] }
+      }
+    ]
+  };
+}
+function savePickerFilename(filename) {
+  return filename.replace(/\\/g, "/").split("/").pop() || "document";
+}
+function createBrowserSaveAsAdapter() {
+  if (browserSaveMode() !== "save-as" || !window.showSaveFilePicker) return void 0;
+  const handles = /* @__PURE__ */ new Map();
+  let nextGrantId = 0;
+  return {
+    pickBeforeSave: true,
+    showDestination: false,
+    async resolveTarget(filename) {
+      return { grantId: null, displayPath: filename };
+    },
+    async pickTarget(filename) {
+      try {
+        const suggestedName = savePickerFilename(filename);
+        const handle = await window.showSaveFilePicker?.(pickerOptions(null, suggestedName));
+        if (!handle) return null;
+        const grantId = `browser-save-${nextGrantId}`;
+        nextGrantId += 1;
+        handles.set(grantId, handle);
+        return { grantId, displayPath: handle.name };
+      } catch (caught) {
+        if (isPickerCancellation(caught)) return null;
+        throw caught;
+      }
+    },
+    async saveBlob(blob, filename, target) {
+      if (!target?.grantId) throw new Error("Choose a file before saving the export.");
+      const handle = handles.get(target.grantId);
+      if (!handle) throw new Error("Choose a file before saving the export.");
+      const writable = await handle.createWritable();
+      try {
+        await writable.write(blob);
+        await writable.close();
+      } catch (caught) {
+        try {
+          await writable.abort();
+        } catch {
+        }
+        throw caught;
+      }
+      return target;
+    }
+  };
+}
+
+export {
+  browserSaveMode,
+  saveActionLabel,
+  createBrowserSaveAsAdapter
+};

package/dist/export/index.d.ts

@@ -55,12 +55,13 @@ declare const DEFAULT_OPTIONS: ExportOptions;
 declare function loadLastExportOptions(): ExportOptions | null;
 declare function saveExportOptions(options: ExportOptions): void;
 
+declare function buildExportFilename(selectedFile: string | null, options: ExportOptions): string;
+
 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'];
 }
-declare function buildExportFilename(selectedFile: string | null, options: ExportOptions): string;
 /** 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>;
 
@@ -81,6 +82,8 @@ interface ExportDialogProps {
     onExport: (options: ExportOptions) => void;
     /** Called whenever the currently selected options change. */
     onOptionsChange?: (options: ExportOptions) => void;
+    /** Host-aware label for the final save action. Defaults to "Export". */
+    actionLabel?: (options: ExportOptions) => string;
     /** Called when the dialog is dismissed. */
     onClose: () => void;
 }
@@ -93,7 +96,7 @@ interface ExportDestinationControl {
     /** A host-supplied validation error for the current destination value. */
     error?: string | null;
 }
-declare function ExportDialog({ initial, exporting, error, destination, onExport, onOptionsChange, onClose, }: ExportDialogProps): react_jsx_runtime.JSX.Element;
+declare function ExportDialog({ initial, exporting, error, destination, onExport, onOptionsChange, actionLabel, onClose, }: ExportDialogProps): react_jsx_runtime.JSX.Element;
 
 /** Keep a user-edited target name while switching the selected export format. */
 declare function updateExportTargetExtension(targetPath: string, suggestedFilename: string): string;

package/dist/export/index.js

@@ -3,13 +3,15 @@ import {
 } from "../chunk-BI7NVU6T.js";
 import {
   ExportDialog
-} from "../chunk-MHTQORMH.js";
+} from "../chunk-SIIEGOHY.js";
 import {
-  buildExportFilename,
   runExport
-} from "../chunk-GHQ4X7KM.js";
+} from "../chunk-OSQUKIUN.js";
 import "../chunk-YBEYTVU2.js";
 import "../chunk-LG6HAWCK.js";
+import {
+  buildExportFilename
+} from "../chunk-M5Y5WO7Z.js";
 import {
   DEFAULT_OPTIONS,
   FORMAT_EXTENSIONS,

package/dist/index.d.ts

@@ -367,6 +367,12 @@ interface ExportToolbarControlsProps {
     selectedFile: string | null;
     /** Media container for resolving images during export. */
     mediaContainer?: ContentContainer | null;
+    /**
+     * Document-scoped container used to resolve narration timing sidecars.
+     * Video preview and export must use the same audio-mapping projection so
+     * recorded narration, camera media, and block transitions share one clock.
+     */
+    workspaceContainer?: ContentContainer | null;
     /** Active document media provider used to preload audio and video export assets. */
     mediaProvider?: MediaProvider | null;
     /** Override the default browser download behavior for host-provided save flows. */
@@ -397,6 +403,10 @@ interface ExportDestinationAdapter {
     resolveTarget: (filename: string) => Promise<ExportDestinationTarget>;
     pickTarget: (filename: string, currentTarget?: ExportDestinationTarget | null) => Promise<ExportDestinationTarget | null>;
     saveBlob: (blob: Blob, filename: string, target?: ExportDestinationTarget | null) => Promise<ExportDestinationTarget | null>;
+    /** Open the picker from the initiating click before expensive conversion work. */
+    pickBeforeSave?: boolean;
+    /** Whether the export dialog should render the adapter's destination field. */
+    showDestination?: boolean;
     hint?: string;
 }
 

package/dist/index.js

@@ -33,11 +33,13 @@ import {
 } from "./chunk-JDJVRDOP.js";
 import {
   ExportDialog
-} from "./chunk-MHTQORMH.js";
+} from "./chunk-SIIEGOHY.js";
 import {
-  buildExportFilename,
   runExport
-} from "./chunk-GHQ4X7KM.js";
+} from "./chunk-OSQUKIUN.js";
+import {
+  createBrowserSaveAsAdapter
+} from "./chunk-UMEDHMT7.js";
 import {
   useMenuKeyboard
 } from "./chunk-MRUK56JS.js";
@@ -45,6 +47,9 @@ import "./chunk-YBEYTVU2.js";
 import {
   Dialog
 } from "./chunk-LG6HAWCK.js";
+import {
+  buildExportFilename
+} from "./chunk-M5Y5WO7Z.js";
 import {
   DEFAULT_OPTIONS,
   loadLastExportOptions
@@ -3149,7 +3154,7 @@ function useDocumentSession(autoSaveDelayMs = 500) {
 import { lazy, Suspense } from "react";
 import { jsx as jsx10 } from "react/jsx-runtime";
 var ExportToolbarControlsImplementation = lazy(
-  () => import("./ExportToolbarControls-6MO4NX6H.js").then((module) => ({
+  () => import("./ExportToolbarControls-5D4R6UXA.js").then((module) => ({
     default: module.ExportToolbarControls
   }))
 );
@@ -5242,14 +5247,17 @@ function DocBlocksShell({
   const [selectedFile, setSelectedFile] = useState15(null);
   useDocumentTitle(selectedFile, homeDocumentTitle, homeDocumentPath);
   const exportDestinationAdapter = useMemo3(() => {
-    if (!isElectronHost3() || !activeWorkspaceId || !selectedFile) return void 0;
-    const documentId = JSON.stringify([activeWorkspaceId, selectedFile]);
-    const host = getDocBlocksHost().exports;
-    return {
-      resolveTarget: (filename) => host.resolveTarget(documentId, filename),
-      pickTarget: (filename, currentTarget) => host.pickTarget(documentId, filename, currentTarget?.grantId ?? null),
-      saveBlob: async (blob, filename, target) => host.save(documentId, filename, target?.grantId ?? null, await blob.arrayBuffer())
-    };
+    if (!selectedFile) return void 0;
+    if (isElectronHost3() && activeWorkspaceId) {
+      const documentId = JSON.stringify([activeWorkspaceId, selectedFile]);
+      const host = getDocBlocksHost().exports;
+      return {
+        resolveTarget: (filename) => host.resolveTarget(documentId, filename),
+        pickTarget: (filename, currentTarget) => host.pickTarget(documentId, filename, currentTarget?.grantId ?? null),
+        saveBlob: async (blob, filename, target) => host.save(documentId, filename, target?.grantId ?? null, await blob.arrayBuffer())
+      };
+    }
+    return createBrowserSaveAsAdapter();
   }, [activeWorkspaceId, selectedFile]);
   const [selectedFolder, setSelectedFolder] = useState15(null);
   const [folderEntries, setFolderEntries] = useState15([]);
@@ -7940,6 +7948,7 @@ function DocBlocksShell({
                               {
                                 selectedFile,
                                 mediaContainer: mediaContainerRef.current,
+                                workspaceContainer: versionsContainer,
                                 mediaProvider,
                                 destinationAdapter: exportDestinationAdapter,
                                 colorScheme: resolvedTheme,

package/dist/{run-export-Z5BVFLIR.js → run-export-UYR5USUJ.js}

@@ -1,7 +1,9 @@
 import {
-  buildExportFilename,
   runExport
-} from "./chunk-GHQ4X7KM.js";
+} from "./chunk-OSQUKIUN.js";
+import {
+  buildExportFilename
+} from "./chunk-M5Y5WO7Z.js";
 import "./chunk-EBWYGTN7.js";
 export {
   buildExportFilename,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks-react",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "React components for DocBlocks — file explorer, workspace picker, and editor shell",
   "license": "MIT",
   "author": "Bendyline",
@@ -75,13 +75,13 @@
     }
   },
   "dependencies": {
-    "@bendyline/docblocks": "2.3.0",
-    "@bendyline/squisq": "2.4.3",
-    "@bendyline/squisq-editor-react": "2.4.5",
-    "@bendyline/squisq-formats": "2.3.7",
-    "@bendyline/squisq-react": "2.4.5",
-    "@bendyline/squisq-video": "2.2.7",
-    "@bendyline/squisq-video-react": "2.2.9"
+    "@bendyline/docblocks": "2.3.2",
+    "@bendyline/squisq": "2.5.0",
+    "@bendyline/squisq-editor-react": "2.5.0",
+    "@bendyline/squisq-formats": "2.3.10",
+    "@bendyline/squisq-react": "2.5.0",
+    "@bendyline/squisq-video": "2.2.9",
+    "@bendyline/squisq-video-react": "2.3.0"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "20.9.0",

package/src/styles/docblocks.css

@@ -2816,6 +2816,10 @@ body.db-resizing-sidebar * {
   --squisq-accent: var(--db-accent);
   --squisq-accent-hover: var(--db-accent-hover);
   --squisq-text-on-accent: var(--db-text-on-accent);
+  /* Hover/open surface for toolbar dropdown triggers (e.g. the cover-slide
+     control). Squisq leaves this token undefined and falls back to its own
+     palette; bind it so the open trigger keeps DocBlocks hover contrast. */
+  --squisq-hover-bg: var(--db-bg-hover);
   --squisq-editor-background: #ffffff;
   --squisq-editor-foreground: #1f2937;
 }
@@ -3725,6 +3729,26 @@ html:has(.db-shell) .squisq-use-mode-menu .squisq-use-mode-menu-check {
   color: var(--db-accent-hover);
 }
 
+/* The cover-slide settings menu is portaled to document.body, so the editor
+   shell's Squisq token bindings cannot reach it. It channels every surface
+   through its own `--cover-*` tokens; re-point those (plus the accent its
+   checkbox/radio/slider controls consume) at the palette hoisted to `html`
+   so the panel follows the active DocBlocks appearance and accent instead
+   of Squisq's standalone slate look. */
+html:has(.db-shell) .squisq-cover-slide-menu {
+  --cover-bg: var(--db-bg);
+  --cover-control: var(--db-bg-subtle);
+  --cover-border: var(--db-border);
+  --cover-text: var(--db-text);
+  --cover-muted: var(--db-text-muted);
+  --squisq-accent: var(--db-accent);
+  --squisq-accent-hover: var(--db-accent-hover);
+  --squisq-text-on-accent: var(--db-text-on-accent);
+  box-shadow:
+    0 12px 32px var(--db-shadow),
+    0 2px 6px var(--db-shadow);
+}
+
 /* Custom layout authoring is portaled to document.body. Bind its host-facing
    accent tokens at that portal boundary so selected layouts, palette states,
    primary actions, and focus rings follow the active DocBlocks accent instead