@bendyline/docblocks-react 1.1.1 → 2.0.0

package/src/Export/run-export.ts

@@ -8,27 +8,13 @@ import type {
   MarkdownInlineNode,
 } 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';
 
+export type ExportBlobSaver = (blob: Blob, filename: string) => Promise<void> | void;
+
 const MIME_TYPES: Record<ExportFormat, string> = {
   docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
   pdf: 'application/pdf',
@@ -47,52 +33,81 @@ function downloadBlob(blob: Blob, filename: string): void {
   URL.revokeObjectURL(url);
 }
 
+async function saveExportBlob(
+  blob: Blob,
+  filename: string,
+  saveBlob?: ExportBlobSaver,
+): Promise<void> {
+  if (saveBlob) {
+    await saveBlob(blob, filename);
+    return;
+  }
+  downloadBlob(blob, filename);
+}
+
 /** Derive a filename from the selected file path and export format. */
 function buildFilename(selectedFile: string | null, format: ExportFormat): string {
   const base = selectedFile ? selectedFile.replace(/^\//, '').replace(/\.[^.]+$/, '') : 'document';
   return base + FORMAT_EXTENSIONS[format];
 }
 
+export function buildExportFilename(selectedFile: string | null, options: ExportOptions): string {
+  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];
+}
+
 /** Run the export and trigger a download. */
 export async function runExport(
   markdown: string,
   selectedFile: string | null,
   options: ExportOptions,
   mediaContainer?: ContentContainer | null,
+  saveBlob?: ExportBlobSaver,
 ): Promise<void> {
   const filename = buildFilename(selectedFile, options.format);
   const themeId = options.themeId !== 'standard' ? options.themeId : undefined;
 
   if (options.format === 'md') {
-    downloadBlob(new Blob([markdown], { type: MIME_TYPES.md }), filename);
+    await saveExportBlob(new Blob([markdown], { type: MIME_TYPES.md }), filename, saveBlob);
     return;
   }
 
   if (options.format === 'html') {
-    await runHtmlExport(markdown, filename, options, mediaContainer, selectedFile);
+    await runHtmlExport(markdown, filename, options, mediaContainer, selectedFile, saveBlob);
     return;
   }
 
   const doc = parseMarkdown(markdown);
 
   if (options.format === 'docx') {
+    const { markdownDocToDocx } = await import('@bendyline/squisq-formats/docx');
     const images = mediaContainer ? await resolveImages(doc, mediaContainer) : undefined;
     const buf = await markdownDocToDocx(doc, { themeId, images });
-    downloadBlob(new Blob([buf], { type: MIME_TYPES.docx }), filename);
+    await saveExportBlob(new Blob([buf], { type: MIME_TYPES.docx }), filename, saveBlob);
     return;
   }
 
   if (options.format === 'pdf') {
+    const { markdownDocToPdf } = await import('@bendyline/squisq-formats/pdf');
     const buf = await markdownDocToPdf(doc, {
       themeId,
       pageSize: options.pageSize,
     });
-    downloadBlob(new Blob([buf], { type: MIME_TYPES.pdf }), filename);
+    await saveExportBlob(new Blob([buf], { type: MIME_TYPES.pdf }), filename, saveBlob);
     return;
   }
 
   if (options.format === 'pptx') {
-    // Use the full transform pipeline: markdown → Doc → transform → PPTX
+    const [{ markdownToDoc }, { applyTransform }, { docToPptx }] = await Promise.all([
+      import('@bendyline/squisq/doc'),
+      import('@bendyline/squisq/transform'),
+      import('@bendyline/squisq-formats/pptx'),
+    ]);
+    // Use the full transform pipeline: markdown -> Doc -> transform -> PPTX
     const baseDoc = markdownToDoc(doc);
     const transformed = applyTransform(baseDoc, options.transformStyle);
     const enrichedDoc = transformed.doc;
@@ -100,7 +115,7 @@ export async function runExport(
       enrichedDoc.themeId = themeId;
     }
     const buf = await docToPptx(enrichedDoc, { themeId });
-    downloadBlob(new Blob([buf], { type: MIME_TYPES.pptx }), filename);
+    await saveExportBlob(new Blob([buf], { type: MIME_TYPES.pptx }), filename, saveBlob);
     return;
   }
 }
@@ -112,6 +127,7 @@ async function runHtmlExport(
   options: ExportOptions,
   mediaContainer?: ContentContainer | null,
   selectedFile?: string | null,
+  saveBlob?: ExportBlobSaver,
 ): Promise<void> {
   const baseName = htmlFilename.replace(/\.html$/, '');
   const zipName = `${baseName}.zip`;
@@ -136,6 +152,10 @@ async function runHtmlExport(
   if (options.includeLinkedDocs && mediaContainer && selectedFile) {
     const entryPath = basenameForBundle(selectedFile);
     if (options.htmlStyle === 'rendered') {
+      const [{ markdownDocsToHtmlBundle }, { PLAYER_BUNDLE }] = await Promise.all([
+        import('@bendyline/squisq-formats/html'),
+        import('@bendyline/squisq-react/standalone-source'),
+      ]);
       const blob = await markdownDocsToHtmlBundle({
         entryPath,
         readDocument: (path) => readDocumentFromContainer(mediaContainer, path),
@@ -146,9 +166,10 @@ async function runHtmlExport(
         mode: 'static',
         entryAsIndex: options.entryAsIndex,
       });
-      downloadBlob(blob, zipName);
+      await saveExportBlob(blob, zipName, saveBlob);
       return;
     }
+    const { markdownDocsToPlainHtmlBundle } = await import('@bendyline/squisq-formats/html');
     const blob = await markdownDocsToPlainHtmlBundle({
       entryPath,
       readDocument: (path) => readDocumentFromContainer(mediaContainer, path),
@@ -157,16 +178,24 @@ async function runHtmlExport(
       themeId,
       entryAsIndex: options.entryAsIndex,
     });
-    downloadBlob(blob, zipName);
+    await saveExportBlob(blob, zipName, saveBlob);
     return;
   }
 
   if (options.htmlStyle === 'rendered') {
+    const [{ markdownToDoc }, { docToHtml, docToHtmlZip, collectImagePaths }, { PLAYER_BUNDLE }] =
+      await Promise.all([
+        import('@bendyline/squisq/doc'),
+        import('@bendyline/squisq-formats/html'),
+        import('@bendyline/squisq-react/standalone-source'),
+      ]);
     const mdDoc = parseMarkdown(markdown);
     const baseDoc = markdownToDoc(mdDoc);
     if (themeId) baseDoc.themeId = themeId;
 
-    const images = mediaContainer ? await resolveDocImages(baseDoc, mediaContainer) : undefined;
+    const images = mediaContainer
+      ? await resolveDocImages(baseDoc, mediaContainer, collectImagePaths)
+      : undefined;
 
     if (options.htmlBundle === 'zip') {
       const blob = await docToHtmlZip(baseDoc, {
@@ -175,7 +204,7 @@ async function runHtmlExport(
         mode: 'static',
         title: baseName,
       });
-      downloadBlob(blob, zipName);
+      await saveExportBlob(blob, zipName, saveBlob);
       return;
     }
 
@@ -185,7 +214,7 @@ async function runHtmlExport(
       mode: 'static',
       title: baseName,
     });
-    downloadBlob(new Blob([html], { type: MIME_TYPES.html }), singleHtmlFilename);
+    await saveExportBlob(new Blob([html], { type: MIME_TYPES.html }), singleHtmlFilename, saveBlob);
     return;
   }
 
@@ -195,6 +224,12 @@ async function runHtmlExport(
   const localImages = referencedImages.filter((u) => !isExternalUrl(u));
 
   if (options.htmlBundle === 'zip' && mediaContainer && localImages.length > 0) {
+    const [{ markdownDocToPlainHtml }, { MemoryContentContainer }, { containerToZip }] =
+      await Promise.all([
+        import('@bendyline/squisq-formats/html'),
+        import('@bendyline/squisq/storage'),
+        import('@bendyline/squisq-formats/container'),
+      ]);
     // 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();
@@ -206,10 +241,11 @@ async function runHtmlExport(
       await container.writeFile(cleanPath, new Uint8Array(data));
     }
     const blob = await containerToZip(container);
-    downloadBlob(blob, zipName);
+    await saveExportBlob(blob, zipName, saveBlob);
     return;
   }
 
+  const { markdownDocToPlainHtml } = await import('@bendyline/squisq-formats/html');
   // Single-file plain HTML — embed local images as base64 data URIs.
   const inlineMap = new Map<string, string>();
   if (mediaContainer) {
@@ -224,7 +260,7 @@ async function runHtmlExport(
     images: inlineMap.size > 0 ? inlineMap : undefined,
     themeId,
   });
-  downloadBlob(new Blob([html], { type: MIME_TYPES.html }), singleHtmlFilename);
+  await saveExportBlob(new Blob([html], { type: MIME_TYPES.html }), singleHtmlFilename, saveBlob);
 }
 
 const IMAGE_MIME: Record<string, string> = {
@@ -325,6 +361,7 @@ async function readDocumentFromContainer(
 async function resolveDocImages(
   doc: Doc,
   container: ContentContainer,
+  collectImagePaths: (doc: Doc) => Iterable<string>,
 ): Promise<Map<string, ArrayBuffer>> {
   const paths = collectImagePaths(doc);
   const map = new Map<string, ArrayBuffer>();

package/src/Export/transform-summaries.ts

@@ -0,0 +1,14 @@
+export interface ExportSummaryOption {
+  id: string;
+  name: string;
+  description?: string;
+}
+
+let transformStyleSummariesPromise: Promise<ExportSummaryOption[]> | null = null;
+
+export function loadTransformStyleSummaries(): Promise<ExportSummaryOption[]> {
+  transformStyleSummariesPromise ??= import('@bendyline/squisq/transform').then(
+    ({ getTransformStyleSummaries }) => getTransformStyleSummaries(),
+  );
+  return transformStyleSummariesPromise;
+}