@formicoidea/labre-core 0.59.0 → 0.61.0

package/architecture/domain.c4

@@ -708,7 +708,7 @@ model {
   extend features.blocks.surface {
     metadata {
       domain ['canvas', 'file', 'layer']
-      domain_canvas '0.74'
+      domain_canvas '0.75'
       domain_file '0.17'
       domain_layer '0.05'
     }
@@ -770,8 +770,8 @@ model {
   extend features.blocks.surface.extensions {
     metadata {
       domain ['canvas', 'file', 'layer']
-      domain_canvas '0.52'
-      domain_file '0.30'
+      domain_canvas '0.53'
+      domain_file '0.29'
       domain_layer '0.12'
     }
   }
@@ -2422,7 +2422,7 @@ model {
     metadata {
       domain ['document', 'canvas']
       domain_document '0.72'
-      domain_canvas '0.23'
+      domain_canvas '0.24'
     }
   }
   extend model_.model_.blocks {

package/dist/_pkgs/affine-block-attachment/asset-picker.d.ts

@@ -2,6 +2,7 @@ import { type AssetRef } from '../affine-shared/services/index.js';
 import type { IVec } from '../global/gfx/index.js';
 import type { BlockStdScope } from '../std/index.js';
 import type { BlockModel } from '../store/index.js';
+import { type AttachmentBlockSource } from './utils.js';
 /**
  * Adds one attachment card per ref next to `targetModel`, as one undo step.
  * Nothing is written on a read-only document.
@@ -22,3 +23,10 @@ export declare function addAttachmentsFromAssets(std: BlockStdScope, assets: rea
 export declare function pickAndAddSiblingAttachmentBlocks(std: BlockStdScope, targetModel: BlockModel): Promise<string[]>;
 /** The canvas's file button: the host's asset dialog, or the file chooser. */
 export declare function pickAndAddAttachments(std: BlockStdScope): Promise<string[]>;
+/**
+ * What the attachment toolbar's "Replace" puts in the card: the host's asset
+ * dialog when there is one (`kind: 'file'`, `mode: 'replace'`, first ref
+ * used, by reference), the system file chooser otherwise (the file goes up
+ * through the blob source, as before). `null` when cancelled.
+ */
+export declare function pickAttachmentSource(std: BlockStdScope): Promise<AttachmentBlockSource | null>;

package/dist/_pkgs/affine-block-attachment/asset-picker.js

@@ -1,6 +1,6 @@
 import { AssetPickerProvider, } from '../affine-shared/services/index.js';
 import { openSingleFileWith } from '../affine-shared/utils/index.js';
-import { addAttachments, addSiblingAttachmentBlocks, placeAttachmentsOnCanvas, } from './utils.js';
+import { addAttachments, addSiblingAttachmentBlocks, getFileType, placeAttachmentsOnCanvas, } from './utils.js';
 /**
  * Attachments from the host's asset library (`AssetPickerProvider`, labre
  * P4): the card references a blob the host already stores, by its
@@ -85,3 +85,27 @@ export async function pickAndAddAttachments(std) {
         return [];
     return addAttachments(std, [file]);
 }
+/**
+ * What the attachment toolbar's "Replace" puts in the card: the host's asset
+ * dialog when there is one (`kind: 'file'`, `mode: 'replace'`, first ref
+ * used, by reference), the system file chooser otherwise (the file goes up
+ * through the blob source, as before). `null` when cancelled.
+ */
+export async function pickAttachmentSource(std) {
+    const picker = std.getOptional(AssetPickerProvider);
+    if (picker) {
+        const [asset] = (await picker.pick({
+            kind: 'file',
+            mode: 'replace',
+            multiple: false,
+            docId: std.store.id,
+        })) ?? [];
+        return asset ? (attachmentPropsFrom([asset])[0] ?? null) : null;
+    }
+    const file = await openSingleFileWith();
+    if (!file)
+        return null;
+    const sourceId = await std.store.blobSync.set(file);
+    const type = await getFileType(file);
+    return { sourceId, name: file.name, type, size: file.size };
+}

package/dist/_pkgs/affine-block-attachment/attachment-block.js

@@ -39,7 +39,7 @@ import { ResourceController, } from '../affine-components/resource/index.js';
 import { toast } from '../affine-components/toast/index.js';
 import { AttachmentBlockStyles, } from '../affine-model/index.js';
 import { BlockCommentManager, CitationProvider, DocModeProvider, FileSizeLimitProvider, TelemetryProvider, TOAST_COPIED_TO_CLIPBOARD, translateKey, } from '../affine-shared/services/index.js';
-import { formatSize, openSingleFileWith } from '../affine-shared/utils/index.js';
+import { formatSize } from '../affine-shared/utils/index.js';
 import { AttachmentIcon, ResetIcon, UpgradeIcon, WarningIcon, } from '@blocksuite/icons/lit';
 import { BlockSelection } from '../std/index.js';
 import { nanoid, Slice } from '../store/index.js';
@@ -51,9 +51,10 @@ import { guard } from 'lit/directives/guard.js';
 import { styleMap } from 'lit/directives/style-map.js';
 import { when } from 'lit/directives/when.js';
 import { filter } from 'rxjs/operators';
+import { pickAttachmentSource } from './asset-picker.js';
 import { AttachmentEmbedProvider } from './embed.js';
 import { styles } from './styles.js';
-import { downloadAttachmentBlob, getFileType, refreshData } from './utils.js';
+import { downloadAttachmentBlob, refreshData } from './utils.js';
 import { ATTACHMENT_BUTTON_RELOAD, ATTACHMENT_BUTTON_RETRY, ATTACHMENT_BUTTON_UPGRADE, } from './translations.js';
 let AttachmentBlockComponent = (() => {
     let _classDecorators = [Peekable({
@@ -121,12 +122,13 @@ let AttachmentBlockComponent = (() => {
                 const state = this.resourceController.state$.peek();
                 if (state.uploading)
                     return;
-                const file = await openSingleFileWith();
-                if (!file)
+                const source = await pickAttachmentSource(this.std);
+                // The dialog is async: the card may be gone, or the page read-only, by now.
+                if (!source || this.std.store.readonly)
                     return;
-                const sourceId = await this.std.store.blobSync.set(file);
-                const type = await getFileType(file);
-                const { name, size } = file;
+                if (!this.std.store.getBlock(this.blockId))
+                    return;
+                const { name, size, type, sourceId } = source;
                 let embed = this.model.props.embed$.value ?? false;
                 this.std.store.captureSync();
                 this.std.store.transact(() => {

package/dist/_pkgs/affine-block-database/database-block.js

@@ -27,9 +27,9 @@ import { databaseBlockStyles, databaseContentStyles, databaseHeaderBarStyles, da
 import { BlockRenderer } from './detail-panel/block-renderer.js';
 import { NoteRenderer } from './detail-panel/note-renderer.js';
 import { DatabaseSelection } from './selection.js';
-import { databaseOpenRowRequest, DatabaseDataSourceProvider, DatabaseNewRowMenuProvider, DatabaseOpenRowProvider, openDatabasePropertiesPanel, rowOpenedParams, } from './service/index.js';
+import { databaseOpenRowRequest, DatabaseDataSourceProvider, DatabaseInitialViewProvider, DatabaseNewRowMenuProvider, DatabaseOpenRowProvider, openDatabasePropertiesPanel, rowOpenedParams, } from './service/index.js';
 import { DATABASE_NEW_RECORD_MORE, DATABASE_SOURCE_MISSING, DATABASE_SOURCE_MISSING_HINT, } from './translations.js';
-import { currentViewStorage } from './utils/current-view.js';
+import { currentViewStorage, initialViewId } from './utils/current-view.js';
 import { getSingleDocIdFromText } from './utils/title-doc.js';
 import { DatabaseViewCreationIdentifier } from './view-creation.js';
 export class DatabaseBlockComponent extends CaptionedBlockComponent {
@@ -311,10 +311,9 @@ export class DatabaseBlockComponent extends CaptionedBlockComponent {
         const dataSource = provider && this.model.props.externalSourceId
             ? provider.createDataSource(this.model, initFn)
             : new DatabaseBlockDataSource(this.model, initFn);
-        const id = currentViewStorage.getCurrentView(this.model.id);
-        if (id && dataSource.viewManager.viewGet(id)) {
+        const id = initialViewId(this.model.id, viewId => dataSource.viewManager.viewGet(viewId) != null, this.std.getOptional(DatabaseInitialViewProvider));
+        if (id)
             dataSource.viewManager.setCurrentView(id);
-        }
         return dataSource;
     }
     get dataSource() {

package/dist/_pkgs/affine-block-database/service/index.d.ts

@@ -14,6 +14,7 @@ export interface DatabaseDataSourceProvider {
     createDataSource(model: DatabaseBlockModel, init?: (ds: DataSourceBase) => void): DataSourceBase;
 }
 export declare const DatabaseDataSourceProvider: import("../../global/di/types.js").ServiceIdentifier<DatabaseDataSourceProvider> & (<U extends DatabaseDataSourceProvider = DatabaseDataSourceProvider>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+export * from './initial-view.js';
 export * from './open-row.js';
 export * from './properties-panel.js';
 export * from './new-row-menu.js';

package/dist/_pkgs/affine-block-database/service/index.js

@@ -1,6 +1,7 @@
 import { createIdentifier } from '../../global/di/index.js';
 export const DatabaseBlockConfigService = createIdentifier('AffineDatabaseBlockConfigService');
 export const DatabaseDataSourceProvider = createIdentifier('affine:database-data-source-provider');
+export * from './initial-view.js';
 export * from './open-row.js';
 export * from './properties-panel.js';
 export * from './new-row-menu.js';

package/dist/_pkgs/affine-block-database/service/initial-view.d.ts

@@ -0,0 +1,33 @@
+import type { ExtensionType } from '../../store/index.js';
+/**
+ * Which `affine:database` block asks for the view it opens on. Only widens:
+ * a new field is optional.
+ */
+export interface DatabaseInitialViewRequest {
+    blockId: string;
+}
+/**
+ * The view a database opens on, chosen by the host (labre: a base's page
+ * opened from one of its views in the sidebar, `/base/:id?view=…`). Asked
+ * once, when the block builds its data source. An id the block does not
+ * have, or `undefined`, falls back to the view this tab last showed for the
+ * block (`currentViewStorage`), then to the first view.
+ *
+ * Nothing is written: the current view is a local signal of the view
+ * manager, never a stored prop, so opening on a view leaves the document
+ * untouched.
+ */
+export interface DatabaseInitialViewService {
+    initialView(request: DatabaseInitialViewRequest): string | undefined;
+}
+export declare const DatabaseInitialViewProvider: import("../../global/di/types.js").ServiceIdentifier<DatabaseInitialViewService> & (<U extends DatabaseInitialViewService = DatabaseInitialViewService>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
+/**
+ * Host seam: the view a database opens on.
+ *
+ * Absent or `null`, a database opens on the view this tab last showed for
+ * it, else its first view, as in 0.59.
+ *
+ * `di.override`, so a later registration wins and registering twice never
+ * throws at boot.
+ */
+export declare function DatabaseInitialViewExtension(service: DatabaseInitialViewService | null): ExtensionType;

package/dist/_pkgs/affine-block-database/service/initial-view.js

@@ -0,0 +1,20 @@
+import { createIdentifier } from '../../global/di/index.js';
+export const DatabaseInitialViewProvider = createIdentifier('LabreDatabaseInitialView');
+/**
+ * Host seam: the view a database opens on.
+ *
+ * Absent or `null`, a database opens on the view this tab last showed for
+ * it, else its first view, as in 0.59.
+ *
+ * `di.override`, so a later registration wins and registering twice never
+ * throws at boot.
+ */
+export function DatabaseInitialViewExtension(service) {
+    return {
+        setup: di => {
+            // `null` rides through on purpose: `getOptional` then reports no host
+            // choice and the block keeps its own.
+            di.override(DatabaseInitialViewProvider, () => service);
+        },
+    };
+}

package/dist/_pkgs/affine-block-database/utils/current-view.d.ts

@@ -1,4 +1,11 @@
+import type { DatabaseInitialViewService } from '../service/initial-view.js';
 export declare const currentViewStorage: {
     getCurrentView: (blockId: string) => string | undefined;
     setCurrentView: (blockId: string, viewId: string) => void;
 };
+/**
+ * The view a database opens on: the host's choice when the block has it
+ * (`DatabaseInitialViewProvider`), else the one this tab last showed, else
+ * `undefined` (the view manager's first view). Reads only.
+ */
+export declare function initialViewId(blockId: string, exists: (viewId: string) => boolean, host?: DatabaseInitialViewService | null): string | undefined;

package/dist/_pkgs/affine-block-database/utils/current-view.js

@@ -45,3 +45,17 @@ const createCurrentViewStorage = () => {
     };
 };
 export const currentViewStorage = createCurrentViewStorage();
+/**
+ * The view a database opens on: the host's choice when the block has it
+ * (`DatabaseInitialViewProvider`), else the one this tab last showed, else
+ * `undefined` (the view manager's first view). Reads only.
+ */
+export function initialViewId(blockId, exists, host) {
+    const asked = host?.initialView({ blockId });
+    if (asked && exists(asked))
+        return asked;
+    const stored = currentViewStorage.getCurrentView(blockId);
+    if (stored && exists(stored))
+        return stored;
+    return undefined;
+}

package/dist/_pkgs/affine-block-embed/common/render-linked-doc.js

@@ -1,5 +1,6 @@
 import { getSurfaceBlock } from '../../affine-block-surface/index.js';
 import { ListBlockModel, NoteBlockModel, NoteDisplayMode, ParagraphBlockModel, } from '../../affine-model/index.js';
+import { LINKED_DOC_NOTE_STYLE } from '../../affine-shared/consts/index.js';
 import { CHROME_UNTITLED, NotificationProvider, TOAST_LINKED_DOC_CREATED, TOOLBAR_CREATE_LINKED_DOC, translateKey, } from '../../affine-shared/services/index.js';
 import { matchModels } from '../../affine-shared/utils/index.js';
 import { Slice, Text, } from '../../store/index.js';
@@ -125,6 +126,7 @@ export async function convertSelectedBlocksToLinkedDoc(std, doc, selectedModels,
         {
             flavour: 'affine:embed-linked-doc',
             pageId: linkedDoc.id,
+            style: LINKED_DOC_NOTE_STYLE,
         },
     ], 'before');
     // delete selected elements

package/dist/_pkgs/affine-block-embed-doc/common/child-card.d.ts

@@ -0,0 +1,25 @@
+import type { ReferenceParams } from '../../affine-model/index.js';
+import type { BlockStdScope } from '../../std/index.js';
+import type { TemplateResult } from 'lit';
+type CardStd = Pick<BlockStdScope, 'get' | 'getOptional'>;
+/**
+ * Whether a card of page `pageId` held by document `docId` is the child's own
+ * card rather than a reference (labre ADR-0045, amended 2026-10-27): the host
+ * lists the document's children through `TitleBandService.children$`. The
+ * library never computes a parent or a child. Read inside a `computed`, so a
+ * move in the host's tree redraws the card. Without the seam, or without
+ * `children$`, every card is a reference, as in 0.59.
+ */
+export declare function isChildCard(std: Pick<CardStd, 'getOptional'>, docId: string, pageId: string): boolean;
+/**
+ * The icon of a card (`embed-linked-doc`, `embed-synced-doc`): a child's own
+ * card shows the plain page or canvas icon; any other card, like an inline
+ * `@` reference, keeps the linked icon with its arrow (product owner,
+ * recette 3 P2-7c). An alias or a block link keeps its own icon.
+ */
+export declare function cardIcon(std: CardStd, docId: string, info: {
+    pageId: string;
+    params?: ReferenceParams;
+    title?: string;
+}): TemplateResult;
+export {};

package/dist/_pkgs/affine-block-embed-doc/common/child-card.js

@@ -0,0 +1,27 @@
+import { DocDisplayMetaProvider, TitleBandProvider, } from '../../affine-shared/services/index.js';
+/**
+ * Whether a card of page `pageId` held by document `docId` is the child's own
+ * card rather than a reference (labre ADR-0045, amended 2026-10-27): the host
+ * lists the document's children through `TitleBandService.children$`. The
+ * library never computes a parent or a child. Read inside a `computed`, so a
+ * move in the host's tree redraws the card. Without the seam, or without
+ * `children$`, every card is a reference, as in 0.59.
+ */
+export function isChildCard(std, docId, pageId) {
+    const children$ = std.getOptional(TitleBandProvider)?.children$?.(docId);
+    return children$?.value.includes(pageId) ?? false;
+}
+/**
+ * The icon of a card (`embed-linked-doc`, `embed-synced-doc`): a child's own
+ * card shows the plain page or canvas icon; any other card, like an inline
+ * `@` reference, keeps the linked icon with its arrow (product owner,
+ * recette 3 P2-7c). An alias or a block link keeps its own icon.
+ */
+export function cardIcon(std, docId, info) {
+    const { pageId, params, title } = info;
+    return std.get(DocDisplayMetaProvider).icon(pageId, {
+        params,
+        title,
+        referenced: !isChildCard(std, docId, pageId),
+    }).value;
+}

package/dist/_pkgs/affine-block-embed-doc/embed-linked-doc-block/commands/insert-embed-linked-doc.js

@@ -1,9 +1,14 @@
 import { insertEmbedCard } from '../../../affine-block-embed/index.js';
+import { LINKED_DOC_NOTE_STYLE } from '../../../affine-shared/consts/index.js';
 export const insertEmbedLinkedDocCommand = (ctx, next) => {
     const { docId, params, std } = ctx;
     const flavour = 'affine:embed-linked-doc';
     const targetStyle = 'vertical';
-    const props = { pageId: docId };
+    // In a note the card is a line; on the canvas `targetStyle` wins.
+    const props = {
+        pageId: docId,
+        style: LINKED_DOC_NOTE_STYLE,
+    };
     if (params)
         props.params = params;
     const blockId = insertEmbedCard(std, { flavour, targetStyle, props });

package/dist/_pkgs/affine-block-embed-doc/embed-linked-doc-block/configs/new-doc.js

@@ -1,5 +1,5 @@
 import { insertContent } from '../../../affine-rich-text/index.js';
-import { REFERENCE_NODE } from '../../../affine-shared/consts/index.js';
+import { LINKED_DOC_NOTE_STYLE, REFERENCE_NODE, } from '../../../affine-shared/consts/index.js';
 import { LinkedDocCreationProvider, TelemetryProvider, } from '../../../affine-shared/services/index.js';
 import { createDefaultDoc, writeDefaultDocBlocks, } from '../../../affine-shared/utils/index.js';
 const LINKED_DOC = 'affine:embed-linked-doc';
@@ -63,7 +63,7 @@ function insertCard(store, anchor, pageId) {
     if (!parent || !store.schema.isValid(LINKED_DOC, parent.flavour)) {
         return null;
     }
-    const cardId = store.addBlock(LINKED_DOC, { pageId }, parent, parent.children.indexOf(anchor) + 1);
+    const cardId = store.addBlock(LINKED_DOC, { pageId, style: LINKED_DOC_NOTE_STYLE }, parent, parent.children.indexOf(anchor) + 1);
     if (anchor.flavour === 'affine:paragraph' && anchor.text?.length === 0) {
         store.deleteBlock(anchor);
     }

package/dist/_pkgs/affine-block-embed-doc/embed-linked-doc-block/embed-linked-doc-block.js

@@ -54,6 +54,7 @@ import { when } from 'lit/directives/when.js';
 import throttle from 'lodash-es/throttle.js';
 import { filter } from 'rxjs/operators';
 import * as Y from 'yjs';
+import { cardIcon } from '../common/child-card.js';
 import { isDocTrashed } from '../common/doc-trashed.js';
 import { renderLinkedDocInCard } from '../common/render-linked-doc.js';
 import { SyncedDocErrorIcon } from '../embed-synced-doc-block/styles.js';
@@ -371,12 +372,7 @@ let EmbedLinkedDocBlockComponent = (() => {
                     description: description$.value,
                 });
             });
-            this.icon$ = computed(() => {
-                const { pageId, params, title } = this.referenceInfo$.value;
-                return this.std
-                    .get(DocDisplayMetaProvider)
-                    .icon(pageId, { params, title, referenced: true }).value;
-            });
+            this.icon$ = computed(() => cardIcon(this.std, this.store.id, this.referenceInfo$.value));
             this.open = ({ openMode, event, } = {}) => {
                 this.std.getOptional(RefNodeSlotsProvider)?.docLinkClicked.next({
                     ...this.referenceInfo$.peek(),

package/dist/_pkgs/affine-block-embed-doc/embed-synced-doc-block/embed-synced-doc-block.js

@@ -52,6 +52,7 @@ import { classMap } from 'lit/directives/class-map.js';
 import { guard } from 'lit/directives/guard.js';
 import { styleMap } from 'lit/directives/style-map.js';
 import * as Y from 'yjs';
+import { cardIcon } from '../common/child-card.js';
 import { isDocTrashed } from '../common/doc-trashed.js';
 import { EMBED_DOC_CARD_EMPTY_CONTENT } from '../translations.js';
 import { blockStyles } from './styles.js';
@@ -329,9 +330,7 @@ let EmbedSyncedDocBlockComponent = (() => {
             };
             this.icon$ = computed(() => {
                 const { pageId, params } = this.model.props;
-                return this.std
-                    .get(DocDisplayMetaProvider)
-                    .icon(pageId, { params, referenced: true }).value;
+                return cardIcon(this.std, this.store.id, { pageId, params });
             });
             this.open = (event) => {
                 const pageId = this.model.props.pageId;

package/dist/_pkgs/affine-block-embed-doc/page-drop/page-drop.js

@@ -1,5 +1,5 @@
 import { EdgelessCRUDIdentifier } from '../../affine-block-surface/index.js';
-import { EMBED_CARD_HEIGHT, EMBED_CARD_WIDTH, } from '../../affine-shared/consts/index.js';
+import { EMBED_CARD_HEIGHT, EMBED_CARD_WIDTH, LINKED_DOC_NOTE_STYLE, } from '../../affine-shared/consts/index.js';
 import { PageDropProvider, pageDropVerdict, TelemetryProvider, } from '../../affine-shared/services/index.js';
 import { calcDropTarget, getClosestBlockComponentByPoint, getLastNoteBlock, isInsideEdgelessEditor, matchModels, } from '../../affine-shared/utils/index.js';
 import { Bound, Point } from '../../global/gfx/index.js';
@@ -52,7 +52,7 @@ function insertBeside(store, pageId, line) {
         if (!parent)
             return null;
         if (store.schema.safeValidate(LINKED_DOC, parent.flavour)) {
-            return (store.addSiblingBlocks(model, [{ flavour: LINKED_DOC, pageId }], placement)[0] ?? null);
+            return (store.addSiblingBlocks(model, [{ flavour: LINKED_DOC, pageId, style: LINKED_DOC_NOTE_STYLE }], placement)[0] ?? null);
         }
         // Out of a list item or a callout: the card goes after the container.
         model = parent;
@@ -65,7 +65,7 @@ function insertAtEnd(store, pageId) {
     if (!root)
         return null;
     const noteId = getLastNoteBlock(store)?.id ?? store.addBlock('affine:note', {}, root.id);
-    return store.addBlock(LINKED_DOC, { pageId }, noteId);
+    return store.addBlock(LINKED_DOC, { pageId, style: LINKED_DOC_NOTE_STYLE }, noteId);
 }
 function insertOnCanvas(std, pageId, point) {
     const gfx = std.get(GfxControllerIdentifier);

package/dist/_pkgs/affine-block-surface/extensions/index.d.ts

@@ -10,6 +10,7 @@ export * from './element-renderer.js';
 export * from './export-manager/index.js';
 export * from './export-svg/index.js';
 export * from './interchange.js';
+export * from './toolbox.js';
 export * from './interchange-export.js';
 export * from './interchange-import.js';
 export * from './legacy-slot-extension.js';

package/dist/_pkgs/affine-block-surface/extensions/index.js

@@ -10,6 +10,7 @@ export * from './element-renderer.js';
 export * from './export-manager/index.js';
 export * from './export-svg/index.js';
 export * from './interchange.js';
+export * from './toolbox.js';
 export * from './interchange-export.js';
 export * from './interchange-import.js';
 export * from './legacy-slot-extension.js';

package/dist/_pkgs/affine-block-surface/extensions/legend-label.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The ink and the type a notation writes its labels in: the legend box's rows,
+ * and the words the DDD prefabs set beside a dot or a marker.
+ *
+ * Declared HERE and re-exported by `@labre/affine-gfx-ddd-shared`, rather than
+ * the other way round, because that bundle depends on this one and a legend
+ * must not depend on a DDD bundle to be drawn.
+ */
+export declare const LABEL_COLOR: string;
+export declare const LABEL_FONT = "blocksuite:surface:Inter";
+export declare const LABEL_FONT_SIZE = 14;

package/dist/_pkgs/affine-block-surface/extensions/legend-label.js

@@ -0,0 +1,16 @@
+import { NOTATION_NEUTRALS } from '../../affine-shared/headless.js';
+// Its own module so the headless interchange entry (`./interchange`) can read
+// it without the legend's editor graph: the DDD element builders of
+// `@labre/affine-gfx-ddd-shared/headless` write their captions in these three
+// values (`docs/adr/0045`). `legend.ts` re-exports them unchanged.
+/**
+ * The ink and the type a notation writes its labels in: the legend box's rows,
+ * and the words the DDD prefabs set beside a dot or a marker.
+ *
+ * Declared HERE and re-exported by `@labre/affine-gfx-ddd-shared`, rather than
+ * the other way round, because that bundle depends on this one and a legend
+ * must not depend on a DDD bundle to be drawn.
+ */
+export const LABEL_COLOR = NOTATION_NEUTRALS.ink;
+export const LABEL_FONT = 'blocksuite:surface:Inter';
+export const LABEL_FONT_SIZE = 14;

package/dist/_pkgs/affine-block-surface/extensions/legend.d.ts

@@ -46,17 +46,7 @@ export interface LegendLayout {
 }
 /** A block of the box that is not a row. See {@link CommandLegendBox.extras}. */
 export type LegendExtra = CommandLegendExtra;
-/**
- * The ink and the type a notation writes its labels in: this box's rows, and
- * the words the DDD prefabs set beside a dot or a marker.
- *
- * Declared HERE and re-exported by `@labre/affine-gfx-ddd-shared`, rather than
- * the other way round, because that bundle depends on this one and a legend
- * must not depend on a DDD bundle to be drawn.
- */
-export declare const LABEL_COLOR: string;
-export declare const LABEL_FONT = "blocksuite:surface:Inter";
-export declare const LABEL_FONT_SIZE = 14;
+export { LABEL_COLOR, LABEL_FONT, LABEL_FONT_SIZE } from './legend-label.js';
 export { LEGEND_ROLE };
 /**
  * How big the box {@link addLegend} would draw for these sections is — without

package/dist/_pkgs/affine-block-surface/extensions/legend.js

@@ -5,18 +5,9 @@ import { Bound } from '../../global/gfx/index.js';
 import { CATALOGUE_CATEGORY_KEY_PREFIX, getRegisteredCommands, humanizeCategory, } from '../../std/index.js';
 import { GfxControllerIdentifier, roleIsA, RoleVocabularyIdentifier, } from '../../std/gfx/index.js';
 import { EdgelessCRUDIdentifier } from './crud-extension.js';
+import { LABEL_COLOR, LABEL_FONT, LABEL_FONT_SIZE } from './legend-label.js';
 import { LEGEND_ROLE } from './legend-role.js';
-/**
- * The ink and the type a notation writes its labels in: this box's rows, and
- * the words the DDD prefabs set beside a dot or a marker.
- *
- * Declared HERE and re-exported by `@labre/affine-gfx-ddd-shared`, rather than
- * the other way round, because that bundle depends on this one and a legend
- * must not depend on a DDD bundle to be drawn.
- */
-export const LABEL_COLOR = NOTATION_NEUTRALS.ink;
-export const LABEL_FONT = 'blocksuite:surface:Inter';
-export const LABEL_FONT_SIZE = 14;
+export { LABEL_COLOR, LABEL_FONT, LABEL_FONT_SIZE } from './legend-label.js';
 const NO_STROKE = '#00000000';
 /**
  * The box's geometry, in one place because two callers need it: the one that

package/dist/_pkgs/affine-block-surface/extensions/toolbox.d.ts

@@ -0,0 +1,62 @@
+import type { SerializedElementProps } from './interchange.js';
+/**
+ * A framework's TOOLBOX, with no editor behind it (`docs/adr/0045`): every
+ * item of its toolbar as a pure builder, so a host with no editor — the Labre
+ * workspace connector, labre-mcp — places the very elements a user places
+ * from the toolbar, never shapes that imitate them.
+ *
+ * ## The same contract as a reader's result
+ *
+ * A builder returns what an import capability returns (ADR 0012 D3): element
+ * props in painting order, each composite's members before the group that
+ * holds them, and LOCAL `id`s the group's `children` and a link's ends name.
+ * `surface.addElement` mints the real ids and the materializer
+ * (`materializeInterchangeImport`) rewrites the references, so one writer
+ * serves a whole file read by a reader and one item built here.
+ *
+ * ## What a builder does not do
+ *
+ * It places ONE item at the point it is given: where things go on a board is
+ * the caller's. It writes the texts it is given, or the English seed: a seed
+ * in the host's language is resolved by the editor's creation site, which has
+ * the catalogue (ADR 0023). It persists nothing.
+ */
+/** Where an item lands: the top-left of its box, in canvas units. */
+export interface ToolboxPoint {
+    x: number;
+    y: number;
+}
+/** One toolbar item that places elements. */
+export interface ToolboxItem {
+    /** Stable within the framework, kebab-case: `container`, `system-boundary`. */
+    readonly id: string;
+    /** The toolbar command's own label, so a host names it as the toolbar does. */
+    readonly labelKey: string;
+    readonly labelFallback: string;
+    /** The text slots `build` fills, in reading order (`title`, `description`…). */
+    readonly texts: readonly string[];
+    /** The box the item is born with. */
+    readonly size: {
+        readonly w: number;
+        readonly h: number;
+    };
+    /**
+     * The elements, with local ids and the group last. `local` prefixes those
+     * ids, so two items built for one batch never share a name.
+     */
+    build(at: ToolboxPoint, texts?: Readonly<Record<string, string>>, local?: string): SerializedElementProps[];
+}
+/** One relation style of the framework: a connector between two elements. */
+export interface ToolboxLink {
+    readonly id: string;
+    readonly labelKey: string;
+    readonly labelFallback: string;
+    /** The connector props; `from` and `to` are element ids or local ids. */
+    build(from: string, to: string, label?: string): SerializedElementProps;
+}
+export interface FrameworkToolbox {
+    /** The framework's descriptor id (`c4`, `bpmn`…). */
+    readonly framework: string;
+    readonly items: readonly ToolboxItem[];
+    readonly links: readonly ToolboxLink[];
+}

package/dist/_pkgs/affine-block-surface/extensions/toolbox.js

@@ -0,0 +1 @@
+export {};

package/dist/_pkgs/affine-block-surface/interchange-headless.d.ts

@@ -18,6 +18,8 @@
  */
 export * from './extensions/export-svg/marker-version.js';
 export * from './extensions/interchange.js';
+export * from './extensions/toolbox.js';
+export * from './extensions/legend-label.js';
 export * from './extensions/legend-role.js';
 export * from './extensions/svg-sanitize.js';
 export * from './extensions/svg-sketch.js';

package/dist/_pkgs/affine-block-surface/interchange-headless.js

@@ -18,6 +18,8 @@
  */
 export * from './extensions/export-svg/marker-version.js';
 export * from './extensions/interchange.js';
+export * from './extensions/toolbox.js';
+export * from './extensions/legend-label.js';
 export * from './extensions/legend-role.js';
 export * from './extensions/svg-sanitize.js';
 export * from './extensions/svg-sketch.js';

package/dist/_pkgs/affine-components/icons/loading.d.ts

@@ -1,3 +1,9 @@
+/**
+ * The library's spinner. Rotated by SMIL, not by a `<style>` inside the
+ * SVG: that sheet was global in light DOM (any `.spinner` of the page
+ * spun), and a binding after it fails to render under happy-dom, so no
+ * unit spec could mount a view that draws it.
+ */
 export declare const LoadingIcon: ({ size, progress, ringColor, strokeColor, }?: {
     size?: string;
     progress?: number;