@formicoidea/labre-core 0.59.0 → 0.60.0

package/architecture/likec4.config.json

@@ -1,3 +1,3 @@
-{
-  "name": "blocksuite"
-}
+{
+  "name": "blocksuite"
+}

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/reading-toolbar.js

@@ -58,18 +58,18 @@ const READ_LABEL_FALLBACK = 'Read this component';
  * Drawn inline like its neighbours: this package does not depend on
  * `@blocksuite/icons` and one glyph is not worth a new dependency.
  */
-const ReadIcon = html `<svg
-  width="20"
-  height="20"
-  viewBox="0 0 24 24"
-  fill="none"
-  stroke="currentColor"
-  stroke-width="2"
-  stroke-linecap="round"
-  stroke-linejoin="round"
->
-  <path d="M2 12s3.5-6 10-6 10 6 10 6-3.5 6-10 6-10-6-10-6z" />
-  <circle cx="12" cy="12" r="3" />
+const ReadIcon = html `<svg
+  width="20"
+  height="20"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M2 12s3.5-6 10-6 10 6 10 6-3.5 6-10 6-10-6-10-6z" />
+  <circle cx="12" cy="12" r="3" />
 </svg>`;
 /** The command this module drives. Spelled once. */
 const ELEMENT_READ_ID = 'element.read';

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/highlight-dropdown-menu/highlight-duotone-icon.js

@@ -1,14 +1,14 @@
 import { HighLightDuotoneIcon } from '@blocksuite/icons/lit';
 import { css, LitElement } from 'lit';
 export class HighlightDuotoneIcon extends LitElement {
-    static { this.styles = css `
-    svg {
-      display: flex;
-      font-size: 20px;
-    }
-    svg > path:nth-child(1) {
-      fill: var(--color, unset);
-    }
+    static { this.styles = css `
+    svg {
+      display: flex;
+      font-size: 20px;
+    }
+    svg > path:nth-child(1) {
+      fill: var(--color, unset);
+    }
   `; }
     render() {
         return HighLightDuotoneIcon();

package/dist/_pkgs/affine-components/highlight-dropdown-menu/text-duotone-icon.js

@@ -1,17 +1,17 @@
 import { TextBackgroundDuotoneIcon } from '@blocksuite/icons/lit';
 import { css, LitElement } from 'lit';
 export class TextDuotoneIcon extends LitElement {
-    static { this.styles = css `
-    svg {
-      display: flex;
-      font-size: 20px;
-    }
-    svg > path:nth-child(1) {
-      fill: var(--background, unset);
-    }
-    svg > path:nth-child(3) {
-      fill: var(--color, unset);
-    }
+    static { this.styles = css `
+    svg {
+      display: flex;
+      font-size: 20px;
+    }
+    svg > path:nth-child(1) {
+      fill: var(--background, unset);
+    }
+    svg > path:nth-child(3) {
+      fill: var(--color, unset);
+    }
   `; }
     render() {
         return TextBackgroundDuotoneIcon();

package/dist/_pkgs/affine-model/elements/c4/board.d.ts

@@ -2,28 +2,6 @@ import type { SerializedXYWH } from '../../../global/gfx/index.js';
 import type { PointTestOptions } from '../../../std/gfx/index.js';
 import type { FrameworkBackgroundProps } from '../framework-background/index.js';
 import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
-/**
- * Height of the board's title band — the header strip across the top of the
- * sheet the diagram title is written in, in model units.
- *
- * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
- * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
- * board's own hit test needs it (a board is clickable by its title band as well
- * as its border), and `affine-model` cannot reach into `affine-block-surface`
- * where the declaration is resolved. One number, owned by the layer that both
- * the declaration and the hit test can read.
- *
- * It is the board's TOP MARGIN, and it always was — the deep inset the plot
- * gives up so the title has somewhere to be written. Naming it says out loud
- * what was already true, so the strip that is painted, the strip that is picked
- * and the strip that opens the rename are one number rather than three.
- *
- * 56 is what the title has been written in since the pack shipped: a 20-unit
- * title, sitting on a baseline a third of the band up from its foot, with the
- * rest as breathing room above and below. Changing it moves the title, so it is
- * a visual decision and not a hit-test one.
- */
-export declare const C4_BOARD_TITLE_BAND_HEIGHT = 56;
 /**
  * Which of C4's levels this board draws — the DECLARED fact, as opposed to the
  * title, which is free text and says whatever its author wants it to.

package/dist/_pkgs/affine-model/elements/c4/board.js

@@ -35,28 +35,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 import { rotatePoint } from '../../../global/gfx/index.js';
 import { field } from '../../../std/gfx/index.js';
 import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
-/**
- * Height of the board's title band — the header strip across the top of the
- * sheet the diagram title is written in, in model units.
- *
- * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
- * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
- * board's own hit test needs it (a board is clickable by its title band as well
- * as its border), and `affine-model` cannot reach into `affine-block-surface`
- * where the declaration is resolved. One number, owned by the layer that both
- * the declaration and the hit test can read.
- *
- * It is the board's TOP MARGIN, and it always was — the deep inset the plot
- * gives up so the title has somewhere to be written. Naming it says out loud
- * what was already true, so the strip that is painted, the strip that is picked
- * and the strip that opens the rename are one number rather than three.
- *
- * 56 is what the title has been written in since the pack shipped: a 20-unit
- * title, sitting on a baseline a third of the band up from its foot, with the
- * rest as breathing room above and below. Changing it moves the title, so it is
- * a visual decision and not a hit-test one.
- */
-export const C4_BOARD_TITLE_BAND_HEIGHT = 56;
+import { C4_BOARD_TITLE_BAND_HEIGHT } from './consts.js';
 /**
  * The C4 board: the sheet one diagram of the model is drawn on — a context
  * diagram, a container diagram, a component diagram. A framework background like

package/dist/_pkgs/affine-model/elements/c4/consts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Constants moved out of the element-class files of this folder, unchanged, so
+ * the model's headless entry (`@labre/affine-model/headless`) exports them
+ * without `@labre/std/gfx` behind them (ADR 0012, P3 as amended 2026-10-14;
+ * the C4 toolbox of `docs/adr/0045` reads the board's metrics from there).
+ * The folder index re-exports this file.
+ */
+/**
+ * Height of the board's title band — the header strip across the top of the
+ * sheet the diagram title is written in, in model units.
+ *
+ * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
+ * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
+ * board's own hit test needs it (a board is clickable by its title band as well
+ * as its border), and `affine-model` cannot reach into `affine-block-surface`
+ * where the declaration is resolved. One number, owned by the layer that both
+ * the declaration and the hit test can read.
+ *
+ * It is the board's TOP MARGIN, and it always was — the deep inset the plot
+ * gives up so the title has somewhere to be written. Naming it says out loud
+ * what was already true, so the strip that is painted, the strip that is picked
+ * and the strip that opens the rename are one number rather than three.
+ *
+ * 56 is what the title has been written in since the pack shipped: a 20-unit
+ * title, sitting on a baseline a third of the band up from its foot, with the
+ * rest as breathing room above and below. Changing it moves the title, so it is
+ * a visual decision and not a hit-test one.
+ */
+export declare const C4_BOARD_TITLE_BAND_HEIGHT = 56;

package/dist/_pkgs/affine-model/elements/c4/consts.js

@@ -0,0 +1,29 @@
+/**
+ * Constants moved out of the element-class files of this folder, unchanged, so
+ * the model's headless entry (`@labre/affine-model/headless`) exports them
+ * without `@labre/std/gfx` behind them (ADR 0012, P3 as amended 2026-10-14;
+ * the C4 toolbox of `docs/adr/0045` reads the board's metrics from there).
+ * The folder index re-exports this file.
+ */
+/**
+ * Height of the board's title band — the header strip across the top of the
+ * sheet the diagram title is written in, in model units.
+ *
+ * Declared HERE, in the model, and re-exported by `@labre/affine-gfx-c4` rather
+ * than the other way round, for the reason `POOL_BAND_WIDTH` is: the
+ * board's own hit test needs it (a board is clickable by its title band as well
+ * as its border), and `affine-model` cannot reach into `affine-block-surface`
+ * where the declaration is resolved. One number, owned by the layer that both
+ * the declaration and the hit test can read.
+ *
+ * It is the board's TOP MARGIN, and it always was — the deep inset the plot
+ * gives up so the title has somewhere to be written. Naming it says out loud
+ * what was already true, so the strip that is painted, the strip that is picked
+ * and the strip that opens the rename are one number rather than three.
+ *
+ * 56 is what the title has been written in since the pack shipped: a 20-unit
+ * title, sitting on a baseline a third of the band up from its foot, with the
+ * rest as breathing room above and below. Changing it moves the title, so it is
+ * a visual decision and not a hit-test one.
+ */
+export const C4_BOARD_TITLE_BAND_HEIGHT = 56;

package/dist/_pkgs/affine-model/elements/c4/index.d.ts

@@ -1,3 +1,4 @@
 export * from './board.js';
 export * from './boundary.js';
+export * from './consts.js';
 export * from './node.js';

package/dist/_pkgs/affine-model/elements/c4/index.js

@@ -1,3 +1,4 @@
 export * from './board.js';
 export * from './boundary.js';
+export * from './consts.js';
 export * from './node.js';

package/dist/_pkgs/affine-model/headless.d.ts

@@ -13,6 +13,7 @@
  */
 export * from './consts/index.js';
 export * from './elements/bpmn/consts.js';
+export * from './elements/c4/consts.js';
 export * from './elements/connector/end-label.js';
 export { DEFAULT_POLYGON_VERTICES } from './elements/shape/api/polygon.js';
 export * from './elements/uml/consts.js';

package/dist/_pkgs/affine-model/headless.js

@@ -13,6 +13,7 @@
  */
 export * from './consts/index.js';
 export * from './elements/bpmn/consts.js';
+export * from './elements/c4/consts.js';
 export * from './elements/connector/end-label.js';
 export { DEFAULT_POLYGON_VERTICES } from './elements/shape/api/polygon.js';
 export * from './elements/uml/consts.js';

package/dist/_pkgs/affine-widget-edgeless-zoom-toolbar/index.js

@@ -52,29 +52,29 @@ let AffineEdgelessZoomToolbarWidget = (() => {
             __esDecorate(this, null, __hide_decorators, { kind: "accessor", name: "_hide", static: false, private: false, access: { has: obj => "_hide" in obj, get: obj => obj._hide, set: (obj, value) => { obj._hide = value; } }, metadata: _metadata }, __hide_initializers, __hide_extraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
-        static { this.styles = css `
-    :host {
-      position: absolute;
-      bottom: 20px;
-      left: 12px;
-      z-index: var(--affine-z-index-popover);
-      display: flex;
-      justify-content: center;
-      -webkit-user-select: none;
-      user-select: none;
-    }
-
-    @container viewport (width <= 1200px) {
-      edgeless-zoom-toolbar {
-        display: none;
-      }
-    }
-
-    @container viewport (width > 1200px) {
-      zoom-bar-toggle-button {
-        display: none;
-      }
-    }
+        static { this.styles = css `
+    :host {
+      position: absolute;
+      bottom: 20px;
+      left: 12px;
+      z-index: var(--affine-z-index-popover);
+      display: flex;
+      justify-content: center;
+      -webkit-user-select: none;
+      user-select: none;
+    }
+
+    @container viewport (width <= 1200px) {
+      edgeless-zoom-toolbar {
+        display: none;
+      }
+    }
+
+    @container viewport (width > 1200px) {
+      zoom-bar-toggle-button {
+        display: none;
+      }
+    }
   `; }
         get edgeless() {
             return this.block;
@@ -105,9 +105,9 @@ let AffineEdgelessZoomToolbarWidget = (() => {
             if (this._hide || !this.edgeless) {
                 return nothing;
             }
-            return html `
-      <edgeless-zoom-toolbar .std=${this.std}></edgeless-zoom-toolbar>
-      <zoom-bar-toggle-button .std=${this.std}></zoom-bar-toggle-button>
+            return html `
+      <edgeless-zoom-toolbar .std=${this.std}></edgeless-zoom-toolbar>
+      <zoom-bar-toggle-button .std=${this.std}></zoom-bar-toggle-button>
     `;
         }
         #_hide_accessor_storage = __runInitializers(this, __hide_initializers, false);