@formicoidea/labre-core 0.50.0 → 0.52.0

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).
@@ -68,6 +70,17 @@ export { frameCommands, reorderFramesParams, } from './_pkgs/affine-block-frame/
  * value.
  */
 export { formatPropertyValue, isPropertyValueEmpty, } from './_pkgs/affine-fragment-doc-title/index.js';
+/*
+ * The "has a thread" seam (ADR 0038). The editor marks what the host says
+ * has a discussion and asks the host to open one, with an excerpt it
+ * computes; the host registers `ThreadMarksExtension({ marks$, openThread })`
+ * among its editor extensions. Gathered here with its types so a host's
+ * discussion module imports one entry; `threadExcerpt` is the excerpt the
+ * editor hands `openThread`, for a host that starts a discussion from its
+ * own UI.
+ */
+export { ThreadMarksExtension } from './_pkgs/affine-shared/services/index.js';
+export { threadExcerpt, } from './_pkgs/affine-widget-thread-marks/index.js';
 /**
  * The document's frames in presentation order, first slide first — the order
  * `canvas.frame.reorder` writes and the presentation walks. Works in page mode
@@ -129,10 +142,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 +185,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 +225,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';

package/dist/translations.js

@@ -5,7 +5,7 @@ import { EMBED_WORDINGS } from './_pkgs/affine-block-embed/translations.js';
 import { EMBED_DOC_WORDINGS } from './_pkgs/affine-block-embed-doc/translations.js';
 import { FRAME_CHROME_WORDINGS, FRAME_WORDINGS, } from './_pkgs/affine-block-frame/translations.js';
 import { IMAGE_WORDINGS } from './_pkgs/affine-block-image/translations.js';
-import { EXEMPTION_FALLBACK, EXPORT_SVG_WORDINGS, PROVENANCE_FALLBACK, READING_FRAME_WORDINGS, SEVERITY_FALLBACK, SVG_SKETCH_WORDINGS, USER_LAYER_SEED_WORDINGS, } from './_pkgs/affine-block-surface/index.js';
+import { EXEMPTION_FALLBACK, EXPORT_SVG_WORDINGS, INTERCHANGE_EXPORT_WORDINGS, PROVENANCE_FALLBACK, READING_FRAME_WORDINGS, SEVERITY_FALLBACK, SVG_SKETCH_WORDINGS, USER_LAYER_SEED_WORDINGS, } from './_pkgs/affine-block-surface/index.js';
 import { SURFACE_REF_CHROME_WORDINGS, SURFACE_REF_WORDINGS, } from './_pkgs/affine-block-surface-ref/translations.js';
 import { ADAPTER_PANEL_WORDINGS } from './_pkgs/affine-fragment-adapter-panel/translations.js';
 import { DOC_TITLE_WORDINGS } from './_pkgs/affine-fragment-doc-title/translations.js';
@@ -41,6 +41,7 @@ import { EDGELESS_TOOLBAR_WORDINGS } from './_pkgs/affine-widget-edgeless-toolba
 import { ZOOM_TOOLBAR_WORDINGS } from './_pkgs/affine-widget-edgeless-zoom-toolbar/translations.js';
 import { LINKED_DOC_WORDINGS } from './_pkgs/affine-widget-linked-doc/translations.js';
 import { REMOTE_SELECTION_WORDINGS } from './_pkgs/affine-widget-remote-selection/translations.js';
+import { THREAD_MARKS_WORDINGS } from './_pkgs/affine-widget-thread-marks/translations.js';
 import { SLASH_MENU_WORDINGS } from './_pkgs/affine-widget-slash-menu/translations.js';
 import { TOOLBAR_WIDGET_WORDINGS } from './_pkgs/affine-widget-toolbar/translations.js';
 import { collectTranslationKeys, commandCategoryTranslationEntries, commandTranslationEntries, mergeTranslationEntries, } from './_pkgs/std/index.js';
@@ -243,6 +244,12 @@ const CHROME_KEYS = [
         'com.labre.interchange.import.readonly',
         'This page became read-only while the file was being read, so nothing was imported.',
     ],
+    // The host's upload ceiling (`FileSizeLimitProvider`) applied to an import,
+    // before the file is read. `{{size}}` is the formatted ceiling.
+    [
+        'com.labre.interchange.import.too-large',
+        'This file is larger than {{size}}, the most this editor imports.',
+    ],
     [
         'com.labre.interchange.import.remarks',
         'What the import could not keep as it was',
@@ -303,6 +310,7 @@ const PACKAGE_WORDINGS = [
     ZOOM_TOOLBAR_WORDINGS,
     LINKED_DOC_WORDINGS,
     REMOTE_SELECTION_WORDINGS,
+    THREAD_MARKS_WORDINGS,
     TOOLBAR_WIDGET_WORDINGS,
     COMPONENTS_WORDINGS,
     INLINE_LATEX_WORDINGS,
@@ -317,6 +325,7 @@ const PACKAGE_WORDINGS = [
     ROOT_CHROME_WORDINGS,
     SVG_SKETCH_WORDINGS,
     EXPORT_SVG_WORDINGS,
+    INTERCHANGE_EXPORT_WORDINGS,
     READING_FRAME_WORDINGS,
     STD_WORDINGS,
     ATTACHMENT_WORDINGS,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-core",
   "description": "Labre editor — the full BlockSuite-derived editor as one package.",
-  "version": "0.50.0",
+  "version": "0.52.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -18,6 +18,10 @@
       "types": "./dist/effects.d.ts",
       "import": "./dist/effects.js"
     },
+    "./interchange": {
+      "types": "./dist/interchange.d.ts",
+      "import": "./dist/interchange.js"
+    },
     "./ext-loader": {
       "types": "./dist/ext-loader/index.d.ts",
       "import": "./dist/ext-loader/index.js"
@@ -778,6 +782,10 @@
       "types": "./dist/shared/consts.d.ts",
       "import": "./dist/shared/consts.js"
     },
+    "./shared/headless": {
+      "types": "./dist/shared/headless.d.ts",
+      "import": "./dist/shared/headless.js"
+    },
     "./shared/selection": {
       "types": "./dist/shared/selection.d.ts",
       "import": "./dist/shared/selection.js"
@@ -834,6 +842,10 @@
       "types": "./dist/model/index.d.ts",
       "import": "./dist/model/index.js"
     },
+    "./model/headless": {
+      "types": "./dist/model/headless.d.ts",
+      "import": "./dist/model/headless.js"
+    },
     "./sync": {
       "types": "./dist/sync/index.d.ts",
       "import": "./dist/sync/index.js"