@formicoidea/labre-framework-ddd-context-map 0.59.0 → 0.61.0

package/dist/actions.d.ts

@@ -1,5 +1,12 @@
 import type { GfxController } from '@formicoidea/labre-core/std/gfx';
 import { type ContextMapPatternKind } from './roles.js';
+/**
+ * Creation / activation actions for the Context Map toolbox — the BEHAVIOUR
+ * layer, depending on nothing but the {@link GfxController}.
+ *
+ * They emit no telemetry: since PF3 the single emission point is the command
+ * registry's `runCommand` (`docs/adr/0008`).
+ */
 /** Create the board at the viewport centre, select it, return to the default tool. */
 export declare function createContextMapBoard(gfx: GfxController): void;
 /**
@@ -32,7 +39,4 @@ export declare function createContextMapBoard(gfx: GfxController): void;
  * `ConnectorToolOptions.label`, which was cut from v1 — the pattern reads from
  * the hover reveal (M2) and the toolbar until it lands.
  */
-export declare function activateContextMapRelationship(gfx: GfxController, kind: ContextMapPatternKind, style: {
-    upDown: boolean;
-    dashed: boolean;
-}): void;
+export declare function activateContextMapRelationship(gfx: GfxController, kind: ContextMapPatternKind): void;

package/dist/actions.js

@@ -1,10 +1,9 @@
 import { backgroundSize, DefaultTool } from '@formicoidea/labre-core/blocks/surface';
 import { ConnectorTool } from '@formicoidea/labre-core/gfx/connector';
-import { LABEL_COLOR } from '@formicoidea/labre-ddd-shared';
-import { ConnectorMode, PointStyle, StrokeStyle } from '@formicoidea/labre-core/model';
-import { Bound } from '@formicoidea/labre-core/global/gfx';
+import { ConnectorMode } from '@formicoidea/labre-core/model';
 import { CONTEXT_MAP_BACKGROUND } from './background.js';
 import { CM_PATTERN_ROLE } from './roles.js';
+import { contextMapBoardElement, contextMapRelationshipStyle } from './toolbox.js';
 /**
  * Creation / activation actions for the Context Map toolbox — the BEHAVIOUR
  * layer, depending on nothing but the {@link GfxController}.
@@ -12,22 +11,19 @@ import { CM_PATTERN_ROLE } from './roles.js';
  * They emit no telemetry: since PF3 the single emission point is the command
  * registry's `runCommand` (`docs/adr/0008`).
  */
-const RELATIONSHIP_STROKE_WIDTH = 2;
 /** Create the board at the viewport centre, select it, return to the default tool. */
 export function createContextMapBoard(gfx) {
     if (!gfx.surface)
         return;
     const { width, height } = backgroundSize(CONTEXT_MAP_BACKGROUND);
     const { centerX, centerY } = gfx.viewport;
-    const id = gfx.surface.addElement({
-        type: CONTEXT_MAP_BACKGROUND.type,
-        // The board is a first-class role: rules frame contexts against
-        // `context-map:board`, never against the `contextMap` element type. The
-        // declaration owns it, so a templated board and a hand-drawn one agree.
-        role: CONTEXT_MAP_BACKGROUND.role,
-        resizeEnabled: CONTEXT_MAP_BACKGROUND.geometry.resizable,
-        xywh: new Bound(centerX - width / 2, centerY - height / 2, width, height).serialize(),
+    // The board's props come from the toolbox (`docs/adr/0045`), the one
+    // assembly a host with no editor also calls; the viewport centre is ours.
+    const { id: _local, ...props } = contextMapBoardElement({
+        x: centerX - width / 2,
+        y: centerY - height / 2,
     });
+    const id = gfx.surface.addElement(props);
     gfx.doc.captureSync();
     gfx.tool.setTool(DefaultTool);
     gfx.selection.set({ elements: [id], editing: false });
@@ -62,22 +58,15 @@ export function createContextMapBoard(gfx) {
  * `ConnectorToolOptions.label`, which was cut from v1 — the pattern reads from
  * the hover reveal (M2) and the toolbar until it lands.
  */
-export function activateContextMapRelationship(gfx, kind, style) {
+export function activateContextMapRelationship(gfx, kind) {
     gfx.tool.setTool(ConnectorTool, {
         mode: ConnectorMode.Straight,
         role: CM_PATTERN_ROLE[kind],
         // The look rides on the activation, never through the last-props store:
-        // the plain connector tool must keep the user's own style (#144 M1).
-        style: {
-            stroke: LABEL_COLOR,
-            strokeStyle: style.dashed ? StrokeStyle.Dash : StrokeStyle.Solid,
-            strokeWidth: RELATIONSHIP_STROKE_WIDTH,
-            frontEndpointStyle: PointStyle.None,
-            // The arrow points at the DOWNSTREAM end, which is the target: the
-            // role's verb is "is upstream of", so the source is the upstream
-            // context.
-            rearEndpointStyle: style.upDown ? PointStyle.Arrow : PointStyle.None,
-        },
+        // the plain connector tool must keep the user's own style (#144 M1). It is
+        // the toolbox's (`contextMapRelationshipStyle`, `docs/adr/0045`), so a
+        // relationship drawn here and one built by a host look the same.
+        style: contextMapRelationshipStyle(kind),
     });
     // The Context Map palette stays open (native sub-menu behaviour): it only
     // closes on re-click of the senior button, another senior tool, or Escape.

package/dist/background.js

@@ -1,5 +1,5 @@
-import { CLOUD, CM_BUBBLE, FONT_FAMILY } from '@formicoidea/labre-ddd-shared';
-import { NOTATION_NEUTRALS } from '@formicoidea/labre-core/shared/consts';
+import { CLOUD, CM_BUBBLE, FONT_FAMILY, } from '@formicoidea/labre-ddd-shared/headless';
+import { NOTATION_NEUTRALS } from '@formicoidea/labre-core/shared/headless';
 import { CONTEXT_MAP_ROLE } from './roles.js';
 /**
  * The Context Map board, DECLARED (the `FrameworkBackgroundDef` primitive).

package/dist/commands.d.ts

@@ -1,18 +1,8 @@
 import { type ChromeWording } from '@formicoidea/labre-core/shared/services';
 import type { CommandDescriptor } from '@formicoidea/labre-core/std';
 import { type TemplateResult } from 'lit';
-/**
- * The seeds baked into a placed artefact: the bounded-context bubble's
- * default caption, and the general-purpose cloud's. The nine relationship
- * patterns carry no seed of their own — since WS2 the palette ARMS the
- * connector tool rather than dropping a labelled group, so no word is
- * written into the document for them any more
- * (`activateContextMapRelationship`). Declared here, beside the commands that
- * write them, and imported by `translations.ts` — never the other way, which
- * would cycle back into `contextMapCommands`.
- */
-export declare const CONTEXT_MAP_SEED_BOUNDED_CONTEXT: ChromeWording;
-export declare const CONTEXT_MAP_SEED_CLOUD: ChromeWording;
+import { CONTEXT_MAP_SEED_BOUNDED_CONTEXT, CONTEXT_MAP_SEED_CLOUD } from './seeds.js';
+export { CONTEXT_MAP_SEED_BOUNDED_CONTEXT, CONTEXT_MAP_SEED_CLOUD };
 /**
  * The automatic legend's own section titles — text stamped onto the board the
  * moment the legend is built, like any other seed, and declared HERE because

package/dist/commands.js

@@ -5,24 +5,10 @@ import { GfxControllerIdentifier } from '@formicoidea/labre-core/std/gfx';
 import { svg } from 'lit';
 import { activateContextMapRelationship, createContextMapBoard, } from './actions.js';
 import { CM_PATTERN_ROLE, CONTEXT_MAP_ROLE } from './roles.js';
-/**
- * The seeds baked into a placed artefact: the bounded-context bubble's
- * default caption, and the general-purpose cloud's. The nine relationship
- * patterns carry no seed of their own — since WS2 the palette ARMS the
- * connector tool rather than dropping a labelled group, so no word is
- * written into the document for them any more
- * (`activateContextMapRelationship`). Declared here, beside the commands that
- * write them, and imported by `translations.ts` — never the other way, which
- * would cycle back into `contextMapCommands`.
- */
-export const CONTEXT_MAP_SEED_BOUNDED_CONTEXT = [
-    'com.labre.ddd-context-map.seed.bounded-context',
-    'Bounded Context',
-];
-export const CONTEXT_MAP_SEED_CLOUD = [
-    'com.labre.ddd-context-map.seed.cloud',
-    'System',
-];
+import { CONTEXT_MAP_SEED_BOUNDED_CONTEXT, CONTEXT_MAP_SEED_CLOUD, } from './seeds.js';
+// Declared in `seeds.ts` (editor-free, for the toolbox) and re-exported here,
+// where `translations.ts` has always read them.
+export { CONTEXT_MAP_SEED_BOUNDED_CONTEXT, CONTEXT_MAP_SEED_CLOUD };
 /**
  * The automatic legend's own section titles — text stamped onto the board the
  * moment the legend is built, like any other seed, and declared HERE because
@@ -126,7 +112,7 @@ const SPECS = [
         // user DRAWS the relation between two contexts. See
         // `activateContextMapRelationship` for why the free-floating group had to
         // go. The telemetry `element` value is untouched.
-        run: std => activateContextMapRelationship(std.get(GfxControllerIdentifier), preset.kind, { upDown: preset.upDown, dashed: preset.dashed }),
+        run: std => activateContextMapRelationship(std.get(GfxControllerIdentifier), preset.kind),
         // One row per PATTERN, not one for `context-map:relationship`: a legend
         // that said "Relationship" would document nothing a reader could use. Both
         // the row and the command come out of the same preset, so the dashed

package/dist/index.d.ts

@@ -10,3 +10,4 @@ export { contextMapSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button.js';
 export { DddContextMapRenderViewExtension, DddContextMapViewExtension, } from './view.js';
 export { CONTEXT_MAP_READING } from './reading.js';
+export { CONTEXT_MAP_TOOLBOX, contextMapBoardElement, contextMapContextElement, contextMapRelationshipElement, contextMapRelationshipStyle, contextMapSystemElements, } from './toolbox.js';

package/dist/index.js

@@ -10,3 +10,5 @@ export { contextMapSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button.js';
 export { DddContextMapRenderViewExtension, DddContextMapViewExtension, } from './view.js';
 export { CONTEXT_MAP_READING } from './reading.js';
+// The toolbar as pure builders (`docs/adr/0045`), also on `./interchange`.
+export { CONTEXT_MAP_TOOLBOX, contextMapBoardElement, contextMapContextElement, contextMapRelationshipElement, contextMapRelationshipStyle, contextMapSystemElements, } from './toolbox.js';

package/dist/interchange-headless.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `./interchange` — the Context Map with no editor behind it (ADR 0012, P3 as
+ * amended 2026-10-14): its toolbar as pure builders (`docs/adr/0045`), so a
+ * host with no editor (the Labre workspace connector, labre-mcp) places the
+ * very board, bounded contexts, clouds and relationships a user places from
+ * the toolbar. Held by `interchange-headless.unit.spec.ts` in
+ * `packages/affine/all`, which bundles this entry and fails on any editor
+ * module in its graph.
+ */
+export { CONTEXT_MAP_TOOLBOX, contextMapBoardElement, contextMapContextElement, contextMapRelationshipElement, contextMapRelationshipStyle, contextMapSystemElements, } from './toolbox.js';

package/dist/interchange-headless.js

@@ -0,0 +1,10 @@
+/**
+ * `./interchange` — the Context Map with no editor behind it (ADR 0012, P3 as
+ * amended 2026-10-14): its toolbar as pure builders (`docs/adr/0045`), so a
+ * host with no editor (the Labre workspace connector, labre-mcp) places the
+ * very board, bounded contexts, clouds and relationships a user places from
+ * the toolbar. Held by `interchange-headless.unit.spec.ts` in
+ * `packages/affine/all`, which bundles this entry and fails on any editor
+ * module in its graph.
+ */
+export { CONTEXT_MAP_TOOLBOX, contextMapBoardElement, contextMapContextElement, contextMapRelationshipElement, contextMapRelationshipStyle, contextMapSystemElements, } from './toolbox.js';

package/dist/roles.d.ts

@@ -1,4 +1,4 @@
-import { CM_RELATIONSHIPS } from '@formicoidea/labre-ddd-shared';
+import { CM_RELATIONSHIPS } from '@formicoidea/labre-ddd-shared/headless';
 import type { RoleDefs } from '@formicoidea/labre-core/std/gfx';
 /**
  * Context Mapping role vocabulary (WS2).

package/dist/roles.js

@@ -1,4 +1,4 @@
-import { CM_RELATIONSHIPS } from '@formicoidea/labre-ddd-shared';
+import { CM_RELATIONSHIPS } from '@formicoidea/labre-ddd-shared/headless';
 /**
  * Role id per pattern kind, DERIVED from the shared preset table rather than
  * restated: the kinds are camelCase (`sharedKernel`) and the role ids are

package/dist/seeds.d.ts

@@ -0,0 +1,16 @@
+import type { ChromeWording } from '@formicoidea/labre-core/shared/services';
+/**
+ * The seeds baked into a placed artefact: the bounded-context bubble's
+ * default caption, and the general-purpose cloud's. The nine relationship
+ * patterns carry no seed of their own — since WS2 the palette ARMS the
+ * connector tool rather than dropping a labelled group, so no word is
+ * written into the document for them any more
+ * (`activateContextMapRelationship`).
+ *
+ * Their own module, editor-free, so the toolbox (`toolbox.ts`,
+ * `docs/adr/0045`) seeds a host's bubble and cloud with the same English
+ * words; `commands.ts` re-exports them unchanged and resolves them through the
+ * host's catalogue at placement (ADR 0023).
+ */
+export declare const CONTEXT_MAP_SEED_BOUNDED_CONTEXT: ChromeWording;
+export declare const CONTEXT_MAP_SEED_CLOUD: ChromeWording;

package/dist/seeds.js

@@ -0,0 +1,21 @@
+/**
+ * The seeds baked into a placed artefact: the bounded-context bubble's
+ * default caption, and the general-purpose cloud's. The nine relationship
+ * patterns carry no seed of their own — since WS2 the palette ARMS the
+ * connector tool rather than dropping a labelled group, so no word is
+ * written into the document for them any more
+ * (`activateContextMapRelationship`).
+ *
+ * Their own module, editor-free, so the toolbox (`toolbox.ts`,
+ * `docs/adr/0045`) seeds a host's bubble and cloud with the same English
+ * words; `commands.ts` re-exports them unchanged and resolves them through the
+ * host's catalogue at placement (ADR 0023).
+ */
+export const CONTEXT_MAP_SEED_BOUNDED_CONTEXT = [
+    'com.labre.ddd-context-map.seed.bounded-context',
+    'Bounded Context',
+];
+export const CONTEXT_MAP_SEED_CLOUD = [
+    'com.labre.ddd-context-map.seed.cloud',
+    'System',
+];

package/dist/toolbox.d.ts

@@ -0,0 +1,37 @@
+import { type FrameworkToolbox, type SerializedElementProps, type ToolboxPoint } from '@formicoidea/labre-core/interchange';
+import { PointStyle, StrokeStyle } from '@formicoidea/labre-core/model/headless';
+import { type ContextMapPatternKind } from './roles.js';
+/**
+ * How a pattern is drawn: presentation only, the meaning is the role. Dashed
+ * for the two "no real integration" patterns (Separate Ways, Big Ball of
+ * Mud), a rear arrowhead for the five upstream/downstream ones: the arrow
+ * points at the DOWNSTREAM end, which is the target, since the role's verb is
+ * "is upstream of".
+ */
+export declare function contextMapRelationshipStyle(kind: ContextMapPatternKind): {
+    stroke: string;
+    strokeStyle: StrokeStyle;
+    strokeWidth: number;
+    frontEndpointStyle: PointStyle;
+    rearEndpointStyle: PointStyle;
+};
+/** The board a context map is drawn on, at `at`. */
+export declare function contextMapBoardElement(at: ToolboxPoint, local?: string): SerializedElementProps;
+/**
+ * A bounded context at `at`, named `name` or the toolbar's English seed. The
+ * role is what makes the pill a bounded CONTEXT every rule reads.
+ */
+export declare function contextMapContextElement(at: ToolboxPoint, name?: string, local?: string): SerializedElementProps;
+/**
+ * A cloud (an outside system, a Big Ball of Mud) at `at`: the polygon carrying
+ * `context-map:system`, its name and their group.
+ */
+export declare function contextMapSystemElements(at: ToolboxPoint, name?: string, local?: string): SerializedElementProps[];
+/**
+ * A relationship of one pattern between two elements: the connector the
+ * pattern's palette entry arms the tool with. Its source is the upstream
+ * context for the five upstream/downstream patterns.
+ */
+export declare function contextMapRelationshipElement(kind: ContextMapPatternKind, from: string, to: string, label?: string): SerializedElementProps;
+/** Every item of the Context Map toolbar, in the toolbar's order. */
+export declare const CONTEXT_MAP_TOOLBOX: FrameworkToolbox;

package/dist/toolbox.js

@@ -0,0 +1,125 @@
+import { backgroundSize, } from '@formicoidea/labre-core/interchange';
+import { bubbleElement, CLOUD, CM_BUBBLE, CM_RELATIONSHIPS, cloudElements, LABEL_COLOR, } from '@formicoidea/labre-ddd-shared/headless';
+import { ConnectorMode, PointStyle, StrokeStyle, } from '@formicoidea/labre-core/model/headless';
+import { Bound } from '@formicoidea/labre-core/global/gfx';
+import { CONTEXT_MAP_BACKGROUND } from './background.js';
+import { contextMapCommandsManifest } from './commands-manifest.js';
+import { CM_PATTERN_ROLE, CONTEXT_MAP_ROLE, } from './roles.js';
+import { CONTEXT_MAP_SEED_BOUNDED_CONTEXT, CONTEXT_MAP_SEED_CLOUD, } from './seeds.js';
+/**
+ * The Context Map toolbar as pure builders (`docs/adr/0045`): the board, the
+ * bounded context, the cloud and the nine relationship patterns, with no
+ * editor behind them. The bubble and the cloud are the very builders the
+ * palette's prefabs write (`@labre/affine-gfx-ddd-shared/headless`), and
+ * `createContextMapBoard` and `activateContextMapRelationship` read the board
+ * and the pattern style from here, so a context drawn by a host and one
+ * placed from the toolbar are the same element.
+ */
+/** Every relationship is drawn this wide, whatever its pattern. */
+const RELATIONSHIP_STROKE_WIDTH = 2;
+/**
+ * How a pattern is drawn: presentation only, the meaning is the role. Dashed
+ * for the two "no real integration" patterns (Separate Ways, Big Ball of
+ * Mud), a rear arrowhead for the five upstream/downstream ones: the arrow
+ * points at the DOWNSTREAM end, which is the target, since the role's verb is
+ * "is upstream of".
+ */
+export function contextMapRelationshipStyle(kind) {
+    const preset = CM_RELATIONSHIPS.find(p => p.kind === kind);
+    return {
+        stroke: LABEL_COLOR,
+        strokeStyle: preset?.dashed ? StrokeStyle.Dash : StrokeStyle.Solid,
+        strokeWidth: RELATIONSHIP_STROKE_WIDTH,
+        frontEndpointStyle: PointStyle.None,
+        rearEndpointStyle: preset?.upDown ? PointStyle.Arrow : PointStyle.None,
+    };
+}
+/** The board a context map is drawn on, at `at`. */
+export function contextMapBoardElement(at, local = 'board') {
+    const { width, height } = backgroundSize(CONTEXT_MAP_BACKGROUND);
+    return {
+        type: CONTEXT_MAP_BACKGROUND.type,
+        id: local,
+        // The board is a first-class role: rules frame contexts against
+        // `context-map:board`, never against the `contextMap` element type.
+        role: CONTEXT_MAP_BACKGROUND.role,
+        resizeEnabled: CONTEXT_MAP_BACKGROUND.geometry.resizable,
+        xywh: new Bound(at.x, at.y, width, height).serialize(),
+    };
+}
+/**
+ * A bounded context at `at`, named `name` or the toolbar's English seed. The
+ * role is what makes the pill a bounded CONTEXT every rule reads.
+ */
+export function contextMapContextElement(at, name, local = 'bounded-context') {
+    return bubbleElement(at, name?.trim() || CONTEXT_MAP_SEED_BOUNDED_CONTEXT[1], CONTEXT_MAP_ROLE.context, local);
+}
+/**
+ * A cloud (an outside system, a Big Ball of Mud) at `at`: the polygon carrying
+ * `context-map:system`, its name and their group.
+ */
+export function contextMapSystemElements(at, name, local = 'system') {
+    return cloudElements(at, name?.trim() || CONTEXT_MAP_SEED_CLOUD[1], CONTEXT_MAP_ROLE.system, local);
+}
+/**
+ * A relationship of one pattern between two elements: the connector the
+ * pattern's palette entry arms the tool with. Its source is the upstream
+ * context for the five upstream/downstream patterns.
+ */
+export function contextMapRelationshipElement(kind, from, to, label) {
+    return {
+        type: 'connector',
+        role: CM_PATTERN_ROLE[kind],
+        mode: ConnectorMode.Straight,
+        ...contextMapRelationshipStyle(kind),
+        source: { id: from },
+        target: { id: to },
+        ...(label?.trim() ? { text: label.trim() } : {}),
+    };
+}
+/** The toolbar command's label, so a host names an item as the toolbar does. */
+function label(command) {
+    const id = `ddd-context-map.${command}`;
+    const row = contextMapCommandsManifest.find(r => r.id === id);
+    return {
+        labelKey: row?.labelKey ?? id,
+        labelFallback: row?.labelFallback ?? id,
+    };
+}
+const kebab = (kind) => kind.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+const relationship = (kind) => ({
+    id: kebab(kind),
+    ...label(`add${kind[0]?.toUpperCase()}${kind.slice(1)}`),
+    build: (from, to, text) => contextMapRelationshipElement(kind, from, to, text),
+});
+const BOARD_SIZE = backgroundSize(CONTEXT_MAP_BACKGROUND);
+/** Every item of the Context Map toolbar, in the toolbar's order. */
+export const CONTEXT_MAP_TOOLBOX = {
+    framework: 'ddd-context-map',
+    items: [
+        {
+            id: 'board',
+            ...label('addBoard'),
+            texts: [],
+            size: { w: BOARD_SIZE.width, h: BOARD_SIZE.height },
+            build: (at, _texts, local) => [contextMapBoardElement(at, local)],
+        },
+        {
+            id: 'bounded-context',
+            ...label('addBoundedContext'),
+            texts: ['name'],
+            size: { w: CM_BUBBLE.w, h: CM_BUBBLE.h },
+            build: (at, texts, local) => [
+                contextMapContextElement(at, texts?.name, local),
+            ],
+        },
+        {
+            id: 'system',
+            ...label('addCloud'),
+            texts: ['name'],
+            size: { w: CLOUD.w, h: CLOUD.h },
+            build: (at, texts, local) => contextMapSystemElements(at, texts?.name, local),
+        },
+    ],
+    links: CM_RELATIONSHIPS.map(preset => relationship(preset.kind)),
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-ddd-context-map",
   "description": "Labre ddd-context-map framework for @formicoidea/labre-core.",
-  "version": "0.59.0",
+  "version": "0.61.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -25,14 +25,18 @@
     "./commands-manifest": {
       "types": "./dist/commands-manifest.d.ts",
       "import": "./dist/commands-manifest.js"
+    },
+    "./interchange": {
+      "types": "./dist/interchange-headless.d.ts",
+      "import": "./dist/interchange-headless.js"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.59.0",
-    "@formicoidea/labre-ddd-shared": "0.59.0",
+    "@formicoidea/labre-core": "0.61.0",
+    "@formicoidea/labre-ddd-shared": "0.61.0",
     "lit": "^3.2.0"
   }
 }