@formicoidea/labre-core 0.50.0 → 0.52.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';
@@ -36,6 +38,7 @@ export * from './quick-search-service.js';
 export * from './selection-pane-service.js';
 export * from './telemetry-service/index.js';
 export * from './theme-service.js';
+export * from './thread-marks-service.js';
 export * from './title-band-service.js';
 export * from './toolbar-service/index.js';
 export * from './translation-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';
@@ -36,6 +38,7 @@ export * from './quick-search-service.js';
 export * from './selection-pane-service.js';
 export * from './telemetry-service/index.js';
 export * from './theme-service.js';
+export * from './thread-marks-service.js';
 export * from './title-band-service.js';
 export * from './toolbar-service/index.js';
 export * from './translation-service/index.js';

package/dist/_pkgs/affine-shared/services/thread-marks-service.d.ts

@@ -0,0 +1,69 @@
+import type { ExtensionType } from '../../store/index.js';
+import type { ReadonlySignal } from '@preact/signals-core';
+/**
+ * What a mark sits on (ADR 0038): a block, in either view, or a canvas element
+ * no block backs (a shape, a connector, a group, a framework board). The id is
+ * the one the library already gives it: a block id, an element id.
+ */
+export type ThreadMarkTargetType = 'block' | 'element';
+/**
+ * One marked target of the mounted document, as the host computes it. Ids and
+ * counters only: the library never learns what the host attaches to a target,
+ * who wrote it or what it says.
+ *
+ * `count` is how many the host has on that target (a mark at `0` or below is
+ * not drawn); `unread` turns the mark to the accent colour.
+ */
+export interface ThreadMark {
+    targetType: ThreadMarkTargetType;
+    targetId: string;
+    count: number;
+    unread: boolean;
+}
+/**
+ * What the library hands the host when someone clicks a mark or "Discuss"
+ * (`com.labre.thread.discuss`) in a block or element toolbar.
+ *
+ * `excerpt` is computed here because the library knows the content: the
+ * block's text (its descendants' for a container such as a note), a canvas
+ * element's label as the selection pane reads it, else the kind of target.
+ * Whitespace is collapsed and it is cut to at most 280 characters, an
+ * ellipsis included (`THREAD_EXCERPT_MAX`). It is a snapshot for the host to
+ * store beside its anchor; the library keeps no copy.
+ */
+export interface ThreadOpenRequest {
+    docId: string;
+    targetType: ThreadMarkTargetType;
+    targetId: string;
+    excerpt: string;
+}
+/** The longest excerpt `openThread` is ever handed, in code points. */
+export declare const THREAD_EXCERPT_MAX = 280;
+/**
+ * The "has a thread" seam (ADR 0038): the host owns the discussions, the
+ * library marks what the host says is marked and asks the host to open one.
+ *
+ * Nothing is written to the document, ever: no prop, no id in the content, no
+ * write on load. That is why it is not `CommentProvider`, which writes
+ * `block.props.comments` and ignores canvas elements.
+ *
+ * Absent or `null`: no mark is drawn and no toolbar offers "Discuss".
+ */
+export interface ThreadMarksService {
+    /**
+     * The marks of the mounted document. Read reactively: a new array
+     * repaints the marks. An id the editor cannot find (a deleted block, an
+     * element of the other view) is ignored, never an error.
+     */
+    marks$: ReadonlySignal<readonly ThreadMark[]>;
+    /** Open (or start) the discussion on a target. Writes nothing here. */
+    openThread(request: ThreadOpenRequest): void;
+}
+export declare const ThreadMarksProvider: import("../../global/di/types.js").ServiceIdentifier<ThreadMarksService> & (<U extends ThreadMarksService = ThreadMarksService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host seam: the host's thread marks, or `null` to say there are none.
+ *
+ * `di.override`, like every panel seam, so a later registration wins and
+ * registering twice never throws at boot.
+ */
+export declare function ThreadMarksExtension(service: ThreadMarksService | null): ExtensionType;

package/dist/_pkgs/affine-shared/services/thread-marks-service.js

@@ -0,0 +1,20 @@
+import { createIdentifier } from '../../global/di/index.js';
+/** The longest excerpt `openThread` is ever handed, in code points. */
+export const THREAD_EXCERPT_MAX = 280;
+export const ThreadMarksProvider = createIdentifier('LabreThreadMarks');
+/**
+ * Host seam: the host's thread marks, or `null` to say there are none.
+ *
+ * `di.override`, like every panel seam, so a later registration wins and
+ * registering twice never throws at boot.
+ */
+export function ThreadMarksExtension(service) {
+    return {
+        setup: di => {
+            // `null` rides through the factory on purpose: `getOptional` then
+            // reports the seam as absent, which is the whole "no mark, no button"
+            // story.
+            di.override(ThreadMarksProvider, () => service);
+        },
+    };
+}

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/_pkgs/affine-widget-thread-marks/effects.d.ts

@@ -0,0 +1 @@
+export declare function effects(): void;

package/dist/_pkgs/affine-widget-thread-marks/effects.js

@@ -0,0 +1,4 @@
+import { AFFINE_THREAD_MARKS_WIDGET, ThreadMarksWidget } from './widget.js';
+export function effects() {
+    customElements.define(AFFINE_THREAD_MARKS_WIDGET, ThreadMarksWidget);
+}

package/dist/_pkgs/affine-widget-thread-marks/excerpt.d.ts

@@ -0,0 +1,19 @@
+import { type ThreadMarkTargetType } from '../affine-shared/services/index.js';
+import type { BlockStdScope } from '../std/index.js';
+/** A block or a canvas element, by the id the library gave it. */
+export interface ThreadTarget {
+    targetType: ThreadMarkTargetType;
+    targetId: string;
+}
+/**
+ * Collapse whitespace and cut to {@link THREAD_EXCERPT_MAX} code points, the
+ * ellipsis included. Code points, not UTF-16 units, so an emoji is never cut
+ * in half and a host counting characters (Postgres `char_length`) agrees.
+ */
+export declare function truncateThreadExcerpt(raw: string): string;
+/**
+ * The excerpt handed to `openThread` (ADR 0038): what the target says, as a
+ * reader would recognise it, at most {@link THREAD_EXCERPT_MAX} characters.
+ * Read only: nothing is written, nothing is cached.
+ */
+export declare function threadExcerpt(std: BlockStdScope, target: ThreadTarget): string;

package/dist/_pkgs/affine-widget-thread-marks/excerpt.js

@@ -0,0 +1,68 @@
+import { getSurfaceBlock } from '../affine-block-surface/index.js';
+import { THREAD_EXCERPT_MAX, } from '../affine-shared/services/index.js';
+import { selectionPaneRowLabel, selectionPaneTypeLabel, } from '../affine-widget-edgeless-toolbar/index.js';
+import { GfxBlockElementModel } from '../std/gfx/index.js';
+const ELLIPSIS = '…';
+/**
+ * Collapse whitespace and cut to {@link THREAD_EXCERPT_MAX} code points, the
+ * ellipsis included. Code points, not UTF-16 units, so an emoji is never cut
+ * in half and a host counting characters (Postgres `char_length`) agrees.
+ */
+export function truncateThreadExcerpt(raw) {
+    const text = raw.replace(/\s+/g, ' ').trim();
+    const chars = Array.from(text);
+    if (chars.length <= THREAD_EXCERPT_MAX)
+        return text;
+    return (chars
+        .slice(0, THREAD_EXCERPT_MAX - 1)
+        .join('')
+        .trimEnd() + ELLIPSIS);
+}
+/**
+ * A block's own text, then its descendants' in document order (a note, a
+ * callout, a list item with children), until there is more than an excerpt
+ * can hold.
+ */
+function blockText(model) {
+    const parts = [];
+    let length = 0;
+    const visit = (block) => {
+        if (length > THREAD_EXCERPT_MAX)
+            return;
+        const own = block.text?.toString() ?? '';
+        if (own.trim()) {
+            parts.push(own);
+            length += own.length + 1;
+        }
+        for (const child of block.children)
+            visit(child);
+    };
+    visit(model);
+    return parts.join(' ');
+}
+function rawExcerpt(std, target) {
+    if (target.targetType === 'block') {
+        const model = std.store.getModelById(target.targetId);
+        if (!model)
+            return '';
+        const text = blockText(model);
+        if (text.trim())
+            return text;
+        // A canvas block with no text reads as the selection pane names it: a
+        // frame by its title, an image or a note by its kind.
+        if (model instanceof GfxBlockElementModel) {
+            return selectionPaneRowLabel(std, model);
+        }
+        return selectionPaneTypeLabel(std, model.flavour);
+    }
+    const element = getSurfaceBlock(std.store)?.getElementById(target.targetId);
+    return element ? selectionPaneRowLabel(std, element) : '';
+}
+/**
+ * The excerpt handed to `openThread` (ADR 0038): what the target says, as a
+ * reader would recognise it, at most {@link THREAD_EXCERPT_MAX} characters.
+ * Read only: nothing is written, nothing is cached.
+ */
+export function threadExcerpt(std, target) {
+    return truncateThreadExcerpt(rawExcerpt(std, target));
+}

package/dist/_pkgs/affine-widget-thread-marks/index.d.ts

@@ -0,0 +1,5 @@
+export * from './excerpt.js';
+export * from './toolbar.js';
+export * from './translations.js';
+export * from './widget.js';
+export declare const threadMarksWidget: import("../store/index.js").ExtensionType;