@formicoidea/labre-core 0.49.0 → 0.51.0

package/dist/_pkgs/data-view/widget-presets/tools/presets/view-options/view-options.js

@@ -34,7 +34,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 };
 import { menu, popMenu, popupTargetFromElement, } from '../../../../../affine-components/context-menu/index.js';
 import { unsafeCSSVarV2 } from '../../../../../affine-shared/theme/index.js';
-import { ArrowRightSmallIcon, DeleteIcon, DuplicateIcon, FilterIcon, GroupingIcon, InfoIcon, LayoutIcon, MoreHorizontalIcon, OpenInNewIcon, SortIcon, } from '@blocksuite/icons/lit';
+import { ArrowRightSmallIcon, DeleteIcon, DuplicateIcon, FilterIcon, GroupingIcon, InfoIcon, LayoutIcon, MoreHorizontalIcon, OpenInNewIcon, PaletteIcon, SortIcon, } from '@blocksuite/icons/lit';
 import { stdContext } from '../../../../../std/index.js';
 import { consume } from '@lit/context';
 import { css, html } from 'lit';
@@ -48,7 +48,8 @@ import { englishWording, wordingOf, } from '../../../../core/utils/wording.js';
 import { WidgetBase } from '../../../../core/widget/widget-base.js';
 import { popFilterRoot } from '../../../quick-setting-bar/filter/root-panel-view.js';
 import { popSortRoot } from '../../../quick-setting-bar/sort/root-panel.js';
-import { DATA_VIEW_OPEN_IN } from '../../../../translations.js';
+import { DATA_VIEW_COLOR_RULES, DATA_VIEW_OPEN_IN, } from '../../../../translations.js';
+import { viewColorRules } from '../../../../core/view/color-rules.js';
 import { openInCurrent, openInOptions, openViewSetting, popViewSetting, viewSettingAvailable, } from './view-settings.js';
 const styles = css `
   .affine-database-toolbar-item.more-action {
@@ -254,6 +255,19 @@ const createSettingMenus = (target, dataViewLogic, reopen, wording) => {
             },
         }));
     }
+    if (viewSettingAvailable(dataViewLogic, 'color-rules')) {
+        const ruleCount = viewColorRules(view.manager.dataSource.viewDataGet(view.id)).length;
+        settingItems.push(menu.action({
+            name: wording(DATA_VIEW_COLOR_RULES),
+            prefix: PaletteIcon(),
+            postfix: html ` <div style="font-size: 14px;">${ruleCount || ''}</div>
+          ${ArrowRightSmallIcon()}`,
+            testId: 'dv-view-setting-color-rules',
+            select: () => {
+                openViewSetting(target, dataViewLogic, 'color-rules', reopen, wording);
+            },
+        }));
+    }
     const openIn = openInMenu(dataViewLogic, reopen, wording);
     if (openIn)
         settingItems.push(openIn);

package/dist/_pkgs/data-view/widget-presets/tools/presets/view-options/view-settings.d.ts

@@ -12,10 +12,12 @@ import type { Wording } from '../../../../core/utils/wording.js';
  * library's own menu are one code path: same menus, same writes, same
  * "back" to the view settings. Open: a later minor may add a key.
  */
-export type ViewSettingKey = 'layout' | 'properties' | 'group' | 'open-in';
+export type ViewSettingKey = 'layout' | 'properties' | 'group' | 'open-in' | 'color-rules';
 /**
  * Whether the current view offers `key`: grouping needs the group trait,
- * "Open pages in" a source whose rows are pages (B8). A read-only or
+ * "Open pages in" a source whose rows are pages (B8), conditional colours
+ * the filter trait, whose conditions a rule is made of (ADR 0036; the
+ * calendar has none, and paints no rule). A read-only or
  * fallback view offers nothing: its settings menu is not drawn either.
  */
 export declare function viewSettingAvailable(dataViewLogic: DataViewUILogicBase, key: ViewSettingKey): boolean;

package/dist/_pkgs/data-view/widget-presets/tools/presets/view-options/view-settings.js

@@ -3,12 +3,14 @@ import { CenterPeekIcon, ExpandFullIcon, RightSidebarIcon, } from '@blocksuite/i
 import { html } from 'lit';
 import { styleMap } from 'lit/directives/style-map.js';
 import { popPropertiesSetting } from '../../../../core/common/properties.js';
+import { filterTraitKey } from '../../../../core/filter/trait.js';
 import { popGroupSetting, popSelectGroupByProperty, } from '../../../../core/group-by/setting.js';
 import { groupTraitKey } from '../../../../core/group-by/trait.js';
 import { renderUniLit, } from '../../../../core/index.js';
 import { rowsArePages, viewOpenIn, viewOpenInSet, } from '../../../../core/view/open-in.js';
 import { PropertiesPanelOpenerKey } from '../../../../core/view-manager/properties-panel-opener.js';
 import { DATA_VIEW_OPEN_IN, DATA_VIEW_OPEN_IN_CENTER, DATA_VIEW_OPEN_IN_FULL, DATA_VIEW_OPEN_IN_SIDE, } from '../../../../translations.js';
+import { popColorRules } from './color-rules-menu.js';
 /** The three places a row's page opens, in the stored order (ADR 0035 §8). */
 const OPEN_IN_CHOICES = [
     { mode: 'side', wording: DATA_VIEW_OPEN_IN_SIDE, icon: RightSidebarIcon },
@@ -17,7 +19,9 @@ const OPEN_IN_CHOICES = [
 ];
 /**
  * Whether the current view offers `key`: grouping needs the group trait,
- * "Open pages in" a source whose rows are pages (B8). A read-only or
+ * "Open pages in" a source whose rows are pages (B8), conditional colours
+ * the filter trait, whose conditions a rule is made of (ADR 0036; the
+ * calendar has none, and paints no rule). A read-only or
  * fallback view offers nothing: its settings menu is not drawn either.
  */
 export function viewSettingAvailable(dataViewLogic, key) {
@@ -29,6 +33,8 @@ export function viewSettingAvailable(dataViewLogic, key) {
             return !!view.traitGet(groupTraitKey);
         case 'open-in':
             return rowsArePages(view.manager.dataSource);
+        case 'color-rules':
+            return !!view.traitGet(filterTraitKey);
         case 'layout':
         case 'properties':
             return true;
@@ -160,7 +166,7 @@ export function openViewSetting(target, dataViewLogic, key, reopen, wording) {
                 openPanel(view.id);
                 return;
             }
-            popPropertiesSetting(target, { view, onBack: reopen });
+            popPropertiesSetting(target, { view, onBack: reopen, wording });
             return;
         }
         case 'group': {
@@ -183,5 +189,8 @@ export function openViewSetting(target, dataViewLogic, key, reopen, wording) {
                 options: openInOptions(dataViewLogic, reopen, wording),
             });
             return;
+        case 'color-rules':
+            popColorRules(target, dataViewLogic, reopen, wording);
+            return;
     }
 }

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';

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';
@@ -243,6 +243,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',
@@ -317,6 +323,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.49.0",
+  "version": "0.51.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"