@formicoidea/labre-core 0.50.0 → 0.51.0

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,

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

@@ -32,3 +32,26 @@ export declare const parseMatter: (contents: string) => {
     metadata: Record<string, FrontmatterValue>;
 } | null;
 export declare function download(blob: Blob, name: string): void;
+/**
+ * A page exported to a file, before anything is done with it: the bytes and
+ * the name a download would give them. What `exportDoc` downloads, and what
+ * the `page.export.*` view actions hand to the host instead.
+ */
+export interface DocExportFile {
+    blob: Blob;
+    /** Sanitised, extension included: `Order to cash.md` or `Order to cash.zip`. */
+    filename: string;
+}
+/**
+ * Pack an adapter's output: the document alone when it references no asset,
+ * else a zip holding it as `index.<ext>` beside an `assets/` folder — the
+ * relative paths the Markdown and HTML adapters write for images point there.
+ */
+export declare function packDocExport(result: {
+    file: string;
+    assetsIds: string[];
+}, assets: Map<string, Blob>, { name, extension, mime }: {
+    name: string;
+    extension: string;
+    mime: string;
+}): Promise<DocExportFile>;

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

@@ -214,3 +214,17 @@ export function download(blob, name) {
     element.remove();
     URL.revokeObjectURL(fileURL);
 }
+/**
+ * Pack an adapter's output: the document alone when it references no asset,
+ * else a zip holding it as `index.<ext>` beside an `assets/` folder — the
+ * relative paths the Markdown and HTML adapters write for images point there.
+ */
+export async function packDocExport(result, assets, { name, extension, mime }) {
+    const content = new Blob([result.file], { type: mime });
+    if (result.assetsIds.length === 0) {
+        return { blob: content, filename: `${name}${extension}` };
+    }
+    const zip = await createAssetsArchive(assets, result.assetsIds);
+    await zip.file(`index${extension}`, content);
+    return { blob: await zip.generate(), filename: `${name}.zip` };
+}

package/dist/commands.js

@@ -1,6 +1,6 @@
 import { frameCommands } from './_pkgs/affine-block-frame/index.js';
-import { copyLinkCommands, coreCommands, pivotCommands, readingCommands, tagCommands, } from './_pkgs/affine-block-root/index.js';
-import { auditCommands, canvasExportCommands, canvasGridCommands, exportSvgCommands, mapQualityCommands, selectionPaneCommands, userLayerCommands, } from './_pkgs/affine-block-surface/index.js';
+import { copyLinkCommands, coreCommands, pageExportCommands, pivotCommands, readingCommands, tagCommands, } from './_pkgs/affine-block-root/index.js';
+import { auditCommands, canvasDrawioExportCommands, canvasExportCommands, canvasGridCommands, canvasSvgExportCommands, exportSvgCommands, mapQualityCommands, selectionPaneCommands, userLayerCommands, } from './_pkgs/affine-block-surface/index.js';
 import { edgeDirectionCommands } from './_pkgs/affine-gfx-connector/index.js';
 import { shapeCommands } from './_pkgs/affine-gfx-shape/index.js';
 import { toCommandManifestEntry, } from './_pkgs/std/index.js';
@@ -49,6 +49,7 @@ export function getCommands(flags) {
     return buildCommandRegistry([
         ...coreCommands,
         ...copyLinkCommands,
+        ...pageExportCommands,
         ...pivotCommands,
         ...tagCommands,
         ...readingCommands,
@@ -59,6 +60,8 @@ export function getCommands(flags) {
         ...frameCommands,
         ...canvasGridCommands,
         ...canvasExportCommands,
+        ...canvasDrawioExportCommands,
+        ...canvasSvgExportCommands,
         ...userLayerCommands,
         ...edgeDirectionCommands,
         ...(isCapabilityEnabled(flags, 'ai-audit') ? auditCommands : []),

package/dist/host-panels.d.ts

@@ -1,5 +1,6 @@
 import { type FramePreview } from './_pkgs/affine-fragment-frame-panel/index.js';
 import type { FrameBlockModel } from './_pkgs/affine-model/index.js';
+import { type TranslationParams } from './_pkgs/affine-shared/services/index.js';
 import { type BlockStdScope, type CommandFile } from './_pkgs/std/index.js';
 /**
  * `@labre/affine/host-panels` — the verbs a host's own panel calls (ADR 0034
@@ -121,6 +122,13 @@ export interface ViewAction {
     label: string;
     /** The `com.labre.*` key behind {@link label}, for a host that translates itself. */
     labelKey: string;
+    /**
+     * The `{{name}}` values {@link labelKey} is filled with, for a host that
+     * translates itself — present only on a label that has placeholders (the
+     * framework exports: `{ framework, extension }`, the framework's name
+     * already resolved). {@link label} has them filled in.
+     */
+    labelParams?: TranslationParams;
     /** Stable asset key; `getCommandIcon(std, iconKey)` is the library's icon. */
     iconKey?: string;
     /** Present only on a toggle: the state a check mark shows. */
@@ -143,7 +151,8 @@ export interface ViewActionResult {
 /**
  * The actions proper to the view the editor shows now, in their declared
  * order: the commands registered on the `'view-menu'` surface whose `scope`
- * is this mode (or `'global'`) and whose `when` holds.
+ * is this mode (or `'global'`) and whose `when` holds, and on the canvas
+ * one export per framework format the interchange registry can write.
  *
  * `mode` is the view the host shows; omitted, it is read from
  * `DocModeProvider`, and a provider that does not know (the library default
@@ -157,6 +166,17 @@ export interface ViewActionResult {
  * mode switch: the `std` is rebuilt.
  */
 export declare function getViewActions(std: BlockStdScope, mode?: 'page' | 'edgeless'): ViewAction[];
+/**
+ * The exports of the view the editor shows now — the `'export'` section of
+ * {@link getViewActions}, in the same order: what a host lists in ONE
+ * "Export…" menu. On the page: Markdown and HTML. On the canvas: PNG and PDF
+ * (with an `ExportManager`), draw.io, SVG (with a canvas renderer), one entry
+ * per framework format the registry writes (`canvas.export.<framework>.<format>`,
+ * listed while the board holds that framework's elements), then Markdown and
+ * HTML. Every one resolves {@link runViewAction} with `{ file }` and downloads
+ * nothing.
+ */
+export declare function getViewExports(std: BlockStdScope, mode?: 'page' | 'edgeless'): ViewAction[];
 /**
  * Run one entry of {@link getViewActions} by its id, through `runCommand`'s
  * bottleneck (usage and telemetry recorded once), and wait for it.

package/dist/host-panels.js

@@ -1,8 +1,10 @@
 import { EdgelessFrameManagerIdentifier } from './_pkgs/affine-block-frame/index.js';
 import { AFFINE_FRAME_PREVIEW, } from './_pkgs/affine-fragment-frame-panel/index.js';
-import { DocModeProvider, translateKey } from './_pkgs/affine-shared/services/index.js';
+import { interchangeExportActions } from './_pkgs/affine-block-surface/index.js';
+import { DocModeProvider, translateKey, } from './_pkgs/affine-shared/services/index.js';
 import { getRegisteredCommands, isCommandAvailable, runCommandAsync, } from './_pkgs/std/index.js';
 import { GfxControllerIdentifier } from './_pkgs/std/gfx/index.js';
+import { frameworkDescriptor } from './frameworks.js';
 /**
  * `@labre/affine/host-panels` — the verbs a host's own panel calls (ADR 0034
  * §4, docs/integrate/08-host-panels.md).
@@ -129,10 +131,35 @@ export function createFramePreview(std, frame, options = {}) {
         preview.fillScreen = options.fillScreen;
     return preview;
 }
+/**
+ * Everything on the `'view-menu'` surface: the registered commands, then
+ * one export per framework `*:export` capability in the interchange registry
+ * (`interchangeExportActions`, ADR 0034 amendment of 2026-10-14) — derived
+ * at read time, so what a flag removed from the registry is not listed.
+ */
+function viewMenuEntries(std) {
+    const registered = getRegisteredCommands(std)
+        .filter(command => command.surfaces.includes('view-menu'))
+        .map(command => ({ command }));
+    const derived = interchangeExportActions(std).map(({ command, capability }) => {
+        const framework = frameworkDescriptor(capability.framework);
+        return {
+            command,
+            labelParams: {
+                framework: framework
+                    ? translateKey(std, framework.labelKey, framework.labelFallback)
+                    : capability.framework,
+                extension: capability.format.extensions[0],
+            },
+        };
+    });
+    return [...registered, ...derived];
+}
 /**
  * The actions proper to the view the editor shows now, in their declared
  * order: the commands registered on the `'view-menu'` surface whose `scope`
- * is this mode (or `'global'`) and whose `when` holds.
+ * is this mode (or `'global'`) and whose `when` holds, and on the canvas
+ * one export per framework format the interchange registry can write.
  *
  * `mode` is the view the host shows; omitted, it is read from
  * `DocModeProvider`, and a provider that does not know (the library default
@@ -147,21 +174,34 @@ export function createFramePreview(std, frame, options = {}) {
  */
 export function getViewActions(std, mode) {
     const view = mode ?? std.getOptional(DocModeProvider)?.getEditorMode();
-    return getRegisteredCommands(std)
-        .filter(command => command.surfaces.includes('view-menu'))
-        .filter(command => command.scope === 'global' || !view || command.scope === view)
-        .filter(command => !command.when || command.when(std))
-        .sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
-        .map(command => ({
+    return viewMenuEntries(std)
+        .filter(({ command }) => command.scope === 'global' || !view || command.scope === view)
+        .filter(({ command }) => !command.when || command.when(std))
+        .sort((a, b) => (a.command.order ?? 0) - (b.command.order ?? 0))
+        .map(({ command, labelParams }) => ({
         id: command.id,
         section: command.category ?? 'display',
-        label: translateKey(std, command.labelKey, command.labelFallback),
+        label: translateKey(std, command.labelKey, command.labelFallback, labelParams),
         labelKey: command.labelKey,
+        ...(labelParams ? { labelParams } : {}),
         ...(command.iconKey ? { iconKey: command.iconKey } : {}),
         ...(command.checked ? { checked: command.checked(std) } : {}),
         disabled: !isCommandAvailable(std, command),
     }));
 }
+/**
+ * The exports of the view the editor shows now — the `'export'` section of
+ * {@link getViewActions}, in the same order: what a host lists in ONE
+ * "Export…" menu. On the page: Markdown and HTML. On the canvas: PNG and PDF
+ * (with an `ExportManager`), draw.io, SVG (with a canvas renderer), one entry
+ * per framework format the registry writes (`canvas.export.<framework>.<format>`,
+ * listed while the board holds that framework's elements), then Markdown and
+ * HTML. Every one resolves {@link runViewAction} with `{ file }` and downloads
+ * nothing.
+ */
+export function getViewExports(std, mode) {
+    return getViewActions(std, mode).filter(action => action.section === 'export');
+}
 /**
  * Run one entry of {@link getViewActions} by its id, through `runCommand`'s
  * bottleneck (usage and telemetry recorded once), and wait for it.
@@ -174,7 +214,7 @@ export function getViewActions(std, mode) {
  * with no file.
  */
 export async function runViewAction(std, id) {
-    const command = getRegisteredCommands(std).find(candidate => candidate.id === id && candidate.surfaces.includes('view-menu'));
+    const command = viewMenuEntries(std).find(entry => entry.command.id === id)?.command;
     if (!command)
         return {};
     if (command.when && !command.when(std))

package/dist/interchange.d.ts

@@ -0,0 +1 @@
+export * from './_pkgs/affine-block-surface/interchange-headless.js';

package/dist/interchange.js

@@ -0,0 +1 @@
+export * from './_pkgs/affine-block-surface/interchange-headless.js';

package/dist/model/headless.d.ts

@@ -0,0 +1 @@
+export * from '../_pkgs/affine-model/headless.js';

package/dist/model/headless.js

@@ -0,0 +1 @@
+export * from '../_pkgs/affine-model/headless.js';

package/dist/shared/headless.d.ts

@@ -0,0 +1 @@
+export * from '../_pkgs/affine-shared/headless.js';

package/dist/shared/headless.js

@@ -0,0 +1 @@
+export * from '../_pkgs/affine-shared/headless.js';