@formicoidea/labre-core 0.49.0 → 0.51.0

package/dist/_pkgs/affine-model/headless.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@labre/affine-model/headless` — the model's data with no element class
+ * behind it: the enums and constants every surface element is written with,
+ * and the pure geometry an interchange reader computes with (ADR 0012, P3 as
+ * amended 2026-10-14).
+ *
+ * The package index re-exports every one of these unchanged; this entry
+ * exists for a caller that must not load `@labre/std/gfx` (and with it Lit and
+ * the drag-and-drop adapter): the headless `./interchange` entries of the
+ * framework bundles. Held by `interchange-headless.unit.spec.ts` in
+ * `packages/affine/all`. Add only from files that import nothing but
+ * `@labre/global` and types.
+ */
+export * from './consts/index.js';
+export * from './elements/bpmn/consts.js';
+export * from './elements/connector/end-label.js';
+export { DEFAULT_POLYGON_VERTICES } from './elements/shape/api/polygon.js';
+export * from './elements/uml/consts.js';
+export * from './elements/uml/lifeline.js';

package/dist/_pkgs/affine-model/headless.js

@@ -0,0 +1,19 @@
+/**
+ * `@labre/affine-model/headless` — the model's data with no element class
+ * behind it: the enums and constants every surface element is written with,
+ * and the pure geometry an interchange reader computes with (ADR 0012, P3 as
+ * amended 2026-10-14).
+ *
+ * The package index re-exports every one of these unchanged; this entry
+ * exists for a caller that must not load `@labre/std/gfx` (and with it Lit and
+ * the drag-and-drop adapter): the headless `./interchange` entries of the
+ * framework bundles. Held by `interchange-headless.unit.spec.ts` in
+ * `packages/affine/all`. Add only from files that import nothing but
+ * `@labre/global` and types.
+ */
+export * from './consts/index.js';
+export * from './elements/bpmn/consts.js';
+export * from './elements/connector/end-label.js';
+export { DEFAULT_POLYGON_VERTICES } from './elements/shape/api/polygon.js';
+export * from './elements/uml/consts.js';
+export * from './elements/uml/lifeline.js';

package/dist/_pkgs/affine-shared/headless.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@labre/affine-shared/headless` — the few shared helpers an interchange
+ * reader or writer calls, with no editor behind them (ADR 0012, P3 as amended
+ * 2026-10-14). The barrels (`./consts`, `./services`, `./utils`) re-export the
+ * same bindings; this entry exists for the headless `./interchange` graphs,
+ * held by `interchange-headless.unit.spec.ts` in `packages/affine/all`.
+ */
+export { NOTATION_NEUTRALS } from './consts/notation.js';
+export { fillPlaceholders, type TranslationParams, } from './services/translation-service/index.js';
+export { safeFilename } from './utils/file/filesys.js';

package/dist/_pkgs/affine-shared/headless.js

@@ -0,0 +1,10 @@
+/**
+ * `@labre/affine-shared/headless` — the few shared helpers an interchange
+ * reader or writer calls, with no editor behind them (ADR 0012, P3 as amended
+ * 2026-10-14). The barrels (`./consts`, `./services`, `./utils`) re-export the
+ * same bindings; this entry exists for the headless `./interchange` graphs,
+ * held by `interchange-headless.unit.spec.ts` in `packages/affine/all`.
+ */
+export { NOTATION_NEUTRALS } from './consts/notation.js';
+export { fillPlaceholders, } from './services/translation-service/index.js';
+export { safeFilename } from './utils/file/filesys.js';

package/dist/_pkgs/affine-shared/services/asset-picker-service.d.ts

@@ -0,0 +1,63 @@
+import type { ExtensionType } from '../../store/index.js';
+/**
+ * A blob the host ALREADY stores, as the editor references it: the block it
+ * lands in stores `sourceId` and nothing else of the bytes. The library never
+ * sends the bytes again (`BlobSource.set` is not called); it may read them
+ * once through the store's blob sources to measure an image when `width` or
+ * `height` is missing.
+ */
+export interface AssetRef {
+    /** The blob's key in the store's blob sources (the Labre app: its sha256). */
+    sourceId: string;
+    /** The file name, kept by an attachment card. */
+    name: string;
+    /** The MIME type. An image request ignores a ref that is not `image/*`. */
+    type: string;
+    /** In bytes. */
+    size: number;
+    /** An image's natural size; measured from the blob when either is absent. */
+    width?: number;
+    height?: number;
+}
+/**
+ * What the editor asks for.
+ *
+ * - `kind`: `image` for an image block, `file` for an attachment card.
+ * - `mode`: `insert` adds new blocks; `replace` swaps the picture of one
+ *   existing image (one ref is used, the first).
+ * - `multiple`: whether more than one ref is welcome (the image insertions).
+ * - `docId`: the document the result lands in, so the host can attach the
+ *   asset to that page (a guest of the page must be able to read it).
+ */
+export interface AssetPickerRequest {
+    kind: 'image' | 'file';
+    mode: 'insert' | 'replace';
+    multiple?: boolean;
+    docId: string;
+}
+/**
+ * Pick an asset from the host's own library (labre P4: the asset dialog of
+ * the shell), instead of the system file chooser.
+ *
+ * `pick` resolves with the refs to use, or `null` when the viewer cancelled:
+ * then nothing is written. An empty array is a cancellation too. A rejection
+ * is logged and nothing is written: show your own error before rejecting.
+ * Upload a new file into your library inside the dialog, then resolve with
+ * its ref: the editor never receives a `File` through this seam.
+ */
+export interface AssetPickerService {
+    pick(request: AssetPickerRequest): Promise<AssetRef[] | null>;
+}
+export declare const AssetPickerProvider: import("../../global/di/types.js").ServiceIdentifier<AssetPickerService> & (<U extends AssetPickerService = AssetPickerService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host seam: the asset dialog. Present, the slash menu's Image, Attachment
+ * and PDF, the mobile keyboard toolbar's Image and Attachment, and the
+ * canvas's image and file buttons open it, and the image toolbar gains
+ * "Replace". Absent, every one of those opens the system file chooser as
+ * before, and there is no "Replace". Pasting and dropping files never go
+ * through it.
+ *
+ * `di.override`, like `FrameTemplateExtension`, so a later registration
+ * always wins and registering twice never throws at boot.
+ */
+export declare function AssetPickerExtension(service: AssetPickerService): ExtensionType;

package/dist/_pkgs/affine-shared/services/asset-picker-service.js

@@ -0,0 +1,20 @@
+import { createIdentifier } from '../../global/di/index.js';
+export const AssetPickerProvider = createIdentifier('AffineAssetPicker');
+/**
+ * Host seam: the asset dialog. Present, the slash menu's Image, Attachment
+ * and PDF, the mobile keyboard toolbar's Image and Attachment, and the
+ * canvas's image and file buttons open it, and the image toolbar gains
+ * "Replace". Absent, every one of those opens the system file chooser as
+ * before, and there is no "Replace". Pasting and dropping files never go
+ * through it.
+ *
+ * `di.override`, like `FrameTemplateExtension`, so a later registration
+ * always wins and registering twice never throws at boot.
+ */
+export function AssetPickerExtension(service) {
+    return {
+        setup: di => {
+            di.override(AssetPickerProvider, () => service);
+        },
+    };
+}

package/dist/_pkgs/affine-shared/services/data-source-picker-service.d.ts

@@ -46,7 +46,9 @@ export interface DataSourcePickerImportedView {
     /**
      * Source property id → property of this database, or `null` to ignore
      * it. An id left out is ignored. A filter or a sort on an ignored property
-     * is removed, a column of it is dropped, a grouping by it is undone.
+     * is removed, a column of it is dropped, a grouping by it is undone, a
+     * colour rule reading it is removed whole (ADR 0036). `remapView` of the
+     * database editor counts each, for a dialog to say what is lost.
      */
     mapping: Readonly<Record<string, string | null>>;
 }
@@ -69,8 +71,9 @@ export interface DataSourcePickerImportRequest {
 }
 /**
  * The current view as a template (labre PRD REQ-DB-4): its layout, where its
- * pages open, its properties shown and their order, its grouping. Never its
- * filters, its sorts or a manual order: those belong to one view.
+ * pages open, its properties shown and their order, its grouping, its
+ * conditional colours (`colorRules`, ADR 0036). Never its filters, its
+ * sorts or a manual order: those belong to one view.
  */
 export interface DataSourcePickerViewTemplate {
     databaseId: string;

package/dist/_pkgs/affine-shared/services/frame-template-service.d.ts

@@ -0,0 +1,83 @@
+import type { DocSnapshot, ExtensionType } from '../../store/index.js';
+/**
+ * What "Save as template" on a frame's toolbar hands the host: the frame and
+ * everything it holds, serialized once, at the moment of the gesture.
+ *
+ * `snapshot` is a `DocSnapshot` the canvas's own template job inserts as is
+ * (`createTemplateJob(std, 'template').insertTemplate(snapshot)`, which mints
+ * fresh ids and lands every model in the viewer's active layer): keep it
+ * verbatim and give it back through {@link FrameTemplateService.list}. It is
+ * plain JSON. It names images and attachments by their blob id (`sourceId`)
+ * and never carries the bytes: the copy references them.
+ */
+export interface FrameTemplateDraft {
+    /** The document the frame was saved from. */
+    docId: string;
+    /** The frame's block id in that document. */
+    frameId: string;
+    /** The frame's title when it was saved (may be empty). */
+    title: string;
+    snapshot: DocSnapshot;
+}
+/** One saved frame, as the canvas's Templates panel lists it. */
+export interface SavedFrameTemplate {
+    /** Your own id for it; the panel uses it as the tile's identity. */
+    id: string;
+    title: string;
+    /** The `snapshot` of the {@link FrameTemplateDraft} you were given. */
+    snapshot: unknown;
+    /** An inline `<svg…` or an image URL; the panel's generic tile otherwise. */
+    preview?: string;
+}
+/** A saved frame inserted into a document, by your id for the template. */
+export interface FrameTemplateInsertion {
+    docId: string;
+    templateId: string;
+}
+/** Ids of a frame whose life the host may follow. */
+export interface FrameTemplateFrameRef {
+    docId: string;
+    frameId: string;
+}
+/**
+ * Frames saved as templates (labre P4): the host keeps them, the library
+ * serializes, lists and inserts them.
+ *
+ * - `save` is called by the frame toolbar's "Save as template"
+ *   (`blocks/frame/src/frame-toolbar.ts`). The library tells the viewer how it
+ *   went (a success or an error notification): do not notify yourself.
+ * - `list` feeds one category of the canvas's Templates panel
+ *   (`gfx/template`, `templateManagerFor`). It is called each time the panel
+ *   shows that category or searches across categories, never before.
+ * - `frameDeleted` is called when THIS viewer deletes a frame on a writable
+ *   document, never for a deletion that arrives from another peer (that peer
+ *   reported its own), so a deletion is reported once per author. It is called
+ *   for every frame, saved or not: ignore the ids you do not know.
+ * - `frameRestored` is called when this viewer brings back a frame it had
+ *   deleted in this session (undo). Whatever `frameDeleted` did must be
+ *   undoable by it: move a template to the trash, never destroy it.
+ * - `frameInserted` is called once a saved frame from that category is on the
+ *   canvas (the template job succeeded), with the document it landed in and
+ *   your id for the template: link what the copy references (its images) to
+ *   that document. Not called when the insertion failed.
+ *
+ * Both notifications may come twice for one gesture (two editors mounted on
+ * one document): make them idempotent.
+ */
+export interface FrameTemplateService {
+    save(draft: FrameTemplateDraft): Promise<void>;
+    list(): Promise<SavedFrameTemplate[]>;
+    frameDeleted?(frame: FrameTemplateFrameRef): void;
+    frameRestored?(frame: FrameTemplateFrameRef): void;
+    frameInserted?(insertion: FrameTemplateInsertion): void;
+}
+export declare const FrameTemplateProvider: import("../../global/di/types.js").ServiceIdentifier<FrameTemplateService> & (<U extends FrameTemplateService = FrameTemplateService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host seam: keep frames saved as templates. Absent, the toolbar has no
+ * "Save as template", the Templates panel has no "Saved frames" category and
+ * nothing is reported when a frame is deleted.
+ *
+ * `di.override`, like `OutlinePanelExtension`, so a later registration always
+ * wins and registering twice never throws at boot.
+ */
+export declare function FrameTemplateExtension(service: FrameTemplateService): ExtensionType;

package/dist/_pkgs/affine-shared/services/frame-template-service.js

@@ -0,0 +1,17 @@
+import { createIdentifier } from '../../global/di/index.js';
+export const FrameTemplateProvider = createIdentifier('AffineFrameTemplate');
+/**
+ * Host seam: keep frames saved as templates. Absent, the toolbar has no
+ * "Save as template", the Templates panel has no "Saved frames" category and
+ * nothing is reported when a frame is deleted.
+ *
+ * `di.override`, like `OutlinePanelExtension`, so a later registration always
+ * wins and registering twice never throws at boot.
+ */
+export function FrameTemplateExtension(service) {
+    return {
+        setup: di => {
+            di.override(FrameTemplateProvider, () => service);
+        },
+    };
+}

package/dist/_pkgs/affine-shared/services/index.d.ts

@@ -1,4 +1,5 @@
 export * from './artefact-catalogue-service.js';
+export * from './asset-picker-service.js';
 export * from './audit-service.js';
 export * from './auto-clear-selection-service.js';
 export * from './block-meta-service.js';
@@ -18,6 +19,7 @@ export * from './embed-option-service.js';
 export * from './feature-flag-service.js';
 export * from './file-size-limit-service.js';
 export * from './font-loader/index.js';
+export * from './frame-template-service.js';
 export * from './generate-url-service.js';
 export * from './keymap-override-service.js';
 export * from './link-preview-service/index.js';

package/dist/_pkgs/affine-shared/services/index.js

@@ -1,4 +1,5 @@
 export * from './artefact-catalogue-service.js';
+export * from './asset-picker-service.js';
 export * from './audit-service.js';
 export * from './auto-clear-selection-service.js';
 export * from './block-meta-service.js';
@@ -18,6 +19,7 @@ export * from './embed-option-service.js';
 export * from './feature-flag-service.js';
 export * from './file-size-limit-service.js';
 export * from './font-loader/index.js';
+export * from './frame-template-service.js';
 export * from './generate-url-service.js';
 export * from './keymap-override-service.js';
 export * from './link-preview-service/index.js';

package/dist/_pkgs/affine-shared/services/translation-service/chrome.d.ts

@@ -509,6 +509,12 @@ export declare const TOOLBAR_INSERT_INTO_PAGE: ChromeWording;
  * frame's. Was `GROUP_TOOLBAR_UNGROUP` (`gfx/group`).
  */
 export declare const TOOLBAR_UNGROUP: ChromeWording;
+/**
+ * "Save as template" — a database view's own menu entry, said identically by
+ * a frame's toolbar (`FrameTemplateProvider`). Was `VIEW_MENU_SAVE_TEMPLATE`
+ * (`database-editor`), whose key it keeps.
+ */
+export declare const SAVE_AS_TEMPLATE: ChromeWording;
 /**
  * "Mind Map" as chrome — the mindmap tool's own name (template-panel tab,
  * senior/quick tool tooltips), said identically by the surface-ref slash

package/dist/_pkgs/affine-shared/services/translation-service/chrome.js

@@ -1100,6 +1100,15 @@ export const TOOLBAR_UNGROUP = [
     'com.labre.group.toolbar.ungroup',
     'Ungroup',
 ];
+/**
+ * "Save as template" — a database view's own menu entry, said identically by
+ * a frame's toolbar (`FrameTemplateProvider`). Was `VIEW_MENU_SAVE_TEMPLATE`
+ * (`database-editor`), whose key it keeps.
+ */
+export const SAVE_AS_TEMPLATE = [
+    'com.labre.database.view-menu.save-template',
+    'Save as template',
+];
 /**
  * "Mind Map" as chrome — the mindmap tool's own name (template-panel tab,
  * senior/quick tool tooltips), said identically by the surface-ref slash
@@ -1308,6 +1317,7 @@ export const CHROME_WORDINGS = [
     IMAGE_LABEL,
     TOOLBAR_INSERT_INTO_PAGE,
     TOOLBAR_UNGROUP,
+    SAVE_AS_TEMPLATE,
     MINDMAP_NAME,
     NEW_DOC_LABEL,
     CATALOGUE_OTHER,

package/dist/_pkgs/affine-widget-drag-handle/watchers/drag-event-watcher.js

@@ -1,7 +1,7 @@
 import { EMBED_IFRAME_DEFAULT_HEIGHT_IN_SURFACE, EMBED_IFRAME_DEFAULT_WIDTH_IN_SURFACE, } from '../../affine-block-embed/index.js';
 import { ParagraphBlockComponent } from '../../affine-block-paragraph/index.js';
 import { DropIndicator } from '../../affine-components/drop-indicator/index.js';
-import { AttachmentBlockModel, BookmarkBlockModel, DatabaseBlockModel, DEFAULT_NOTE_HEIGHT, DEFAULT_NOTE_WIDTH, ListBlockModel, NoteBlockModel, RootBlockModel, } from '../../affine-model/index.js';
+import { AttachmentBlockModel, BookmarkBlockModel, DatabaseBlockModel, DEFAULT_NOTE_HEIGHT, DEFAULT_NOTE_WIDTH, ListBlockModel, NoteBlockModel, readImageCrop, RootBlockModel, } from '../../affine-model/index.js';
 import { surfaceRefToEmbed } from '../../affine-shared/adapters/index.js';
 import { BLOCK_CHILDREN_CONTAINER_PADDING_LEFT, EMBED_CARD_HEIGHT, EMBED_CARD_WIDTH, } from '../../affine-shared/consts/index.js';
 import { DndApiExtensionIdentifier, DocModeProvider, EmbedIframeService, TelemetryProvider, } from '../../affine-shared/services/index.js';
@@ -721,8 +721,13 @@ export class DragEventWatcher {
                     }
                     if (block.flavour === 'affine:image') {
                         assertType(block.props);
-                        blockBound.w = blockBound.w || block.props.width || 100;
-                        blockBound.h = blockBound.h || block.props.height || 100;
+                        // A page image's `width`/`height` are the WHOLE picture; on the
+                        // canvas the box is the cropped window (ADR 0037).
+                        const crop = readImageCrop(block.props.crop);
+                        blockBound.w =
+                            blockBound.w || block.props.width * (crop?.w ?? 1) || 100;
+                        blockBound.h =
+                            blockBound.h || block.props.height * (crop?.h ?? 1) || 100;
                     }
                     if (ignoreOriginalPos) {
                         blockBound.x = modelX;

package/dist/_pkgs/affine-widget-keyboard-toolbar/config.js

@@ -1,4 +1,4 @@
-import { addSiblingAttachmentBlocks } from '../affine-block-attachment/index.js';
+import { pickAndAddSiblingAttachmentBlocks } from '../affine-block-attachment/index.js';
 import { insertDatabaseBlockCommand } from '../affine-block-database/index.js';
 import { insertEmptyEmbedIframeCommand } from '../affine-block-embed/index.js';
 import { insertImagesCommand } from '../affine-block-image/index.js';
@@ -16,7 +16,7 @@ import { formatBlockCommand, formatNativeCommand, formatTextCommand, getTextAttr
 import { insertContent } from '../affine-rich-text/index.js';
 import { copySelectedModelsCommand, deleteSelectedModelsCommand, draftSelectedModelsCommand, duplicateSelectedModelsCommand, getBlockSelectionsCommand, getSelectedModelsCommand, getTextSelectionCommand, } from '../affine-shared/commands/index.js';
 import { REFERENCE_NODE } from '../affine-shared/consts/index.js';
-import { createDefaultDoc, openSingleFileWith, } from '../affine-shared/utils/index.js';
+import { createDefaultDoc } from '../affine-shared/utils/index.js';
 import { viewPresets } from '../data-view/view-presets/index.js';
 import { assertType } from '../global/utils/index.js';
 import { AttachmentIcon, BoldIcon, BulletedListIcon, CheckBoxCheckLinearIcon, CloseIcon, CodeBlockIcon, CodeIcon, CollapseTabIcon, CopyIcon, DatabaseKanbanViewIcon, DatabaseTableViewIcon, DeleteIcon, DividerIcon, DuplicateIcon, EmbedIcon, FontIcon, FrameIcon, GithubIcon, GroupIcon, ImageIcon, ItalicIcon, LinkedPageIcon, LinkIcon, LoomLogoIcon, NewPageIcon, NowIcon, NumberedListIcon, PlusIcon, QuoteIcon, RedoIcon, RightTabIcon, StrikeThroughIcon, TeXIcon, TextIcon, TodayIcon, TomorrowIcon, UnderLineIcon, UndoIcon, YesterdayIcon, YoutubeDuotoneIcon, } from '@blocksuite/icons/lit';
@@ -233,13 +233,7 @@ const contentMediaToolGroup = {
                 const model = selectedModels?.[0];
                 if (!model)
                     return;
-                const file = await openSingleFileWith();
-                if (!file)
-                    return;
-                await addSiblingAttachmentBlocks(std, [file], model);
-                if (model.text?.length === 0) {
-                    std.store.deleteBlock(model);
-                }
+                await pickAndAddSiblingAttachmentBlocks(std, model);
             },
         },
         {
@@ -778,13 +772,7 @@ export const defaultKeyboardToolbarConfig = {
                 const model = selectedModels?.[0];
                 if (!model)
                     return;
-                const file = await openSingleFileWith();
-                if (!file)
-                    return;
-                await addSiblingAttachmentBlocks(std, [file], model);
-                if (model.text?.length === 0) {
-                    std.store.deleteBlock(model);
-                }
+                await pickAndAddSiblingAttachmentBlocks(std, model);
             },
         },
         {

package/dist/_pkgs/affine-widget-linked-doc/transformers/html.d.ts

@@ -1,4 +1,5 @@
 import type { ExtensionType, Schema, Store, Workspace } from '../../store/index.js';
+import { type DocExportFile } from './utils.js';
 type ImportHTMLToDocOptions = {
     collection: Workspace;
     schema: Schema;
@@ -12,6 +13,11 @@ type ImportHTMLZipOptions = {
     imported: Blob;
     extensions: ExtensionType[];
 };
+/**
+ * A doc as an HTML file, or as a zip of the HTML and its assets when it holds
+ * any — without downloading it. `null` when the doc has no snapshot.
+ */
+declare function docFile(doc: Store): Promise<DocExportFile | null>;
 /**
  * Exports a doc to HTML format.
  *
@@ -41,6 +47,7 @@ declare function importHTMLToDoc({ collection, schema, html, fileName, extension
  */
 declare function importHTMLZip({ collection, schema, imported, extensions, }: ImportHTMLZipOptions): Promise<string[]>;
 export declare const HtmlTransformer: {
+    docFile: typeof docFile;
     exportDoc: typeof exportDoc;
     importHTMLToDoc: typeof importHTMLToDoc;
     importHTMLZip: typeof importHTMLZip;

package/dist/_pkgs/affine-widget-linked-doc/transformers/html.js

@@ -1,9 +1,10 @@
 import { defaultImageProxyMiddleware, docLinkBaseURLMiddleware, fileNameMiddleware, filePathMiddleware, HtmlAdapter, resolveWording, titleMiddleware, } from '../../affine-shared/adapters/index.js';
 import { CHROME_UNTITLED } from '../../affine-shared/services/index.js';
+import { safeFilename } from '../../affine-shared/utils/index.js';
 import { Container } from '../../global/di/index.js';
 import { sha } from '../../global/utils/index.js';
 import { extMimeMap, Transformer } from '../../store/index.js';
-import { createAssetsArchive, download, Unzip } from './utils.js';
+import { download, packDocExport, Unzip } from './utils.js';
 function getProvider(extensions) {
     const container = new Container();
     extensions.forEach(ext => {
@@ -12,41 +13,40 @@ function getProvider(extensions) {
     return container.provider();
 }
 /**
- * Exports a doc to HTML format.
- *
- * @param doc - The doc to be exported.
- * @returns A Promise that resolves when the export is complete.
+ * A doc as an HTML file, or as a zip of the HTML and its assets when it holds
+ * any — without downloading it. `null` when the doc has no snapshot.
  */
-async function exportDoc(doc) {
+async function docFile(doc) {
     const provider = doc.provider;
     const job = doc.getTransformer([
         docLinkBaseURLMiddleware(doc.workspace.id),
         titleMiddleware(doc.workspace.meta.docMetas),
     ]);
     const snapshot = job.docToSnapshot(doc);
+    if (!snapshot)
+        return null;
     const adapter = new HtmlAdapter(job, provider);
-    if (!snapshot) {
-        return;
-    }
     const htmlResult = await adapter.fromDocSnapshot({
         snapshot,
         assets: job.assetsManager,
     });
-    let downloadBlob;
-    const docTitle = doc.meta?.title || resolveWording(provider, CHROME_UNTITLED);
-    let name;
-    const contentBlob = new Blob([htmlResult.file], { type: 'plain/text' });
-    if (htmlResult.assetsIds.length > 0) {
-        const zip = await createAssetsArchive(job.assets, htmlResult.assetsIds);
-        await zip.file('index.html', contentBlob);
-        downloadBlob = await zip.generate();
-        name = `${docTitle}.zip`;
-    }
-    else {
-        downloadBlob = contentBlob;
-        name = `${docTitle}.html`;
-    }
-    download(downloadBlob, name);
+    const untitled = resolveWording(provider, CHROME_UNTITLED);
+    return packDocExport(htmlResult, job.assets, {
+        name: safeFilename(doc.meta?.title, untitled),
+        extension: '.html',
+        mime: 'text/html;charset=utf-8',
+    });
+}
+/**
+ * Exports a doc to HTML format.
+ *
+ * @param doc - The doc to be exported.
+ * @returns A Promise that resolves when the export is complete.
+ */
+async function exportDoc(doc) {
+    const file = await docFile(doc);
+    if (file)
+        download(file.blob, file.filename);
 }
 /**
  * Imports HTML content into a new doc within a collection.
@@ -160,6 +160,7 @@ async function importHTMLZip({ collection, schema, imported, extensions, }) {
     return docIds;
 }
 export const HtmlTransformer = {
+    docFile,
     exportDoc,
     importHTMLToDoc,
     importHTMLZip,

package/dist/_pkgs/affine-widget-linked-doc/transformers/index.d.ts

@@ -1,5 +1,5 @@
 export { HtmlTransformer } from './html.js';
 export { MarkdownTransformer } from './markdown.js';
 export { NotionHtmlTransformer } from './notion-html.js';
-export { createAssetsArchive, download } from './utils.js';
+export { createAssetsArchive, type DocExportFile, download } from './utils.js';
 export { ZipTransformer } from './zip.js';

package/dist/_pkgs/affine-widget-linked-doc/transformers/markdown.d.ts

@@ -1,4 +1,5 @@
 import type { DocMeta, ExtensionType, Schema, Store, Workspace } from '../../store/index.js';
+import { type DocExportFile } from './utils.js';
 type ParsedFrontmatterMeta = Partial<Pick<DocMeta, 'title' | 'createDate' | 'updatedDate' | 'tags' | 'favorite'>>;
 /**
  * Read the frontmatter off a markdown file and hand back the content without
@@ -27,6 +28,11 @@ type ImportMarkdownZipOptions = {
     imported: Blob;
     extensions: ExtensionType[];
 };
+/**
+ * A doc as a Markdown file, or as a zip of the Markdown and its assets when it
+ * holds any — without downloading it. `null` when the doc has no snapshot.
+ */
+declare function docFile(doc: Store): Promise<DocExportFile | null>;
 /**
  * Exports a doc to a Markdown file or a zip archive containing Markdown and assets.
  * @param doc The doc to export
@@ -62,6 +68,7 @@ declare function importMarkdownToDoc({ collection, schema, markdown, fileName, e
  */
 declare function importMarkdownZip({ collection, schema, imported, extensions, }: ImportMarkdownZipOptions): Promise<string[]>;
 export declare const MarkdownTransformer: {
+    docFile: typeof docFile;
     exportDoc: typeof exportDoc;
     importMarkdownToBlock: typeof importMarkdownToBlock;
     importMarkdownToDoc: typeof importMarkdownToDoc;

package/dist/_pkgs/affine-widget-linked-doc/transformers/markdown.js

@@ -1,10 +1,11 @@
 import { defaultImageProxyMiddleware, docLinkBaseURLMiddleware, fileNameMiddleware, filePathMiddleware, MarkdownAdapter, resolveWording, titleMiddleware, } from '../../affine-shared/adapters/index.js';
 import { CHROME_UNTITLED } from '../../affine-shared/services/index.js';
+import { safeFilename } from '../../affine-shared/utils/index.js';
 import { Container } from '../../global/di/index.js';
 import { BlockSuiteError, ErrorCode } from '../../global/exceptions/index.js';
 import { sha } from '../../global/utils/index.js';
 import { extMimeMap, Transformer } from '../../store/index.js';
-import { createAssetsArchive, download, parseMatter, Unzip, } from './utils.js';
+import { download, packDocExport, parseMatter, Unzip, } from './utils.js';
 /**
  * The spellings the tools people export markdown from actually use. Anything
  * else in the frontmatter is metadata we have no field for, and is dropped.
@@ -137,43 +138,42 @@ function getProvider(extensions) {
     return container.provider();
 }
 /**
- * Exports a doc to a Markdown file or a zip archive containing Markdown and assets.
- * @param doc The doc to export
- * @returns A Promise that resolves when the export is complete
+ * A doc as a Markdown file, or as a zip of the Markdown and its assets when it
+ * holds any — without downloading it. `null` when the doc has no snapshot.
  */
-async function exportDoc(doc) {
+async function docFile(doc) {
     const provider = doc.provider;
     const job = doc.getTransformer([
         docLinkBaseURLMiddleware(doc.workspace.id),
         titleMiddleware(doc.workspace.meta.docMetas),
     ]);
     const snapshot = job.docToSnapshot(doc);
+    if (!snapshot)
+        return null;
     const adapter = new MarkdownAdapter(job, provider);
-    if (!snapshot) {
-        return;
-    }
     const markdownResult = await adapter.fromDocSnapshot({
         snapshot,
         assets: job.assetsManager,
     });
-    let downloadBlob;
-    const docTitle = doc.meta?.title || resolveWording(provider, CHROME_UNTITLED);
-    let name;
-    const contentBlob = new Blob([markdownResult.file], { type: 'plain/text' });
-    if (markdownResult.assetsIds.length > 0) {
-        if (!job.assets) {
-            throw new BlockSuiteError(ErrorCode.ValueNotExists, 'No assets found');
-        }
-        const zip = await createAssetsArchive(job.assets, markdownResult.assetsIds);
-        await zip.file('index.md', contentBlob);
-        downloadBlob = await zip.generate();
-        name = `${docTitle}.zip`;
-    }
-    else {
-        downloadBlob = contentBlob;
-        name = `${docTitle}.md`;
+    if (markdownResult.assetsIds.length > 0 && !job.assets) {
+        throw new BlockSuiteError(ErrorCode.ValueNotExists, 'No assets found');
     }
-    download(downloadBlob, name);
+    const untitled = resolveWording(provider, CHROME_UNTITLED);
+    return packDocExport(markdownResult, job.assets, {
+        name: safeFilename(doc.meta?.title, untitled),
+        extension: '.md',
+        mime: 'text/markdown;charset=utf-8',
+    });
+}
+/**
+ * Exports a doc to a Markdown file or a zip archive containing Markdown and assets.
+ * @param doc The doc to export
+ * @returns A Promise that resolves when the export is complete
+ */
+async function exportDoc(doc) {
+    const file = await docFile(doc);
+    if (file)
+        download(file.blob, file.filename);
 }
 /**
  * Imports Markdown content into a specific block within a doc.
@@ -328,6 +328,7 @@ async function importMarkdownZip({ collection, schema, imported, extensions, })
     return docIds;
 }
 export const MarkdownTransformer = {
+    docFile,
     exportDoc,
     importMarkdownToBlock,
     importMarkdownToDoc,