@formicoidea/labre-framework-ddd-core-domain 0.59.0 → 0.61.0

package/dist/actions.js

@@ -1,13 +1,10 @@
 import { backgroundSize } from '@formicoidea/labre-core/blocks/surface';
 import { ConnectorTool } from '@formicoidea/labre-core/gfx/connector';
-import { MOVEMENT_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 { GfxControllerIdentifier } from '@formicoidea/labre-core/std/gfx';
 import { CORE_DOMAIN_BACKGROUND } from './core-domain/background.js';
 import { CORE_DOMAIN_ROLE } from './roles.js';
-/** The stroke width the movement arrow has always been drawn at. */
-const MOVEMENT_STROKE_WIDTH = 2;
+import { coreDomainChartElement, coreDomainMovementStyle } from './toolbox.js';
 /**
  * Post a Core Domain Chart background, centred on `(cx, cy)`.
  *
@@ -19,12 +16,13 @@ const MOVEMENT_STROKE_WIDTH = 2;
  */
 export function createCoreDomainChart(surface, cx, cy) {
     const { width, height } = backgroundSize(CORE_DOMAIN_BACKGROUND);
-    return surface.addElement({
-        type: CORE_DOMAIN_BACKGROUND.type,
-        role: CORE_DOMAIN_BACKGROUND.role,
-        resizeEnabled: CORE_DOMAIN_BACKGROUND.geometry.resizable,
-        xywh: new Bound(cx - width / 2, cy - height / 2, width, height).serialize(),
+    // The chart's props come from the toolbox (`docs/adr/0045`), the one
+    // assembly a host with no editor also calls; the centre is the caller's.
+    const { id: _local, ...props } = coreDomainChartElement({
+        x: cx - width / 2,
+        y: cy - height / 2,
     });
+    return surface.addElement(props);
 }
 /**
  * Activate the native connector tool, pre-styled for a movement over time
@@ -46,13 +44,9 @@ export function activateMovement(std) {
         mode: ConnectorMode.Straight,
         role: CORE_DOMAIN_ROLE.movement,
         // 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: MOVEMENT_COLOR,
-            strokeStyle: StrokeStyle.Dash,
-            strokeWidth: MOVEMENT_STROKE_WIDTH,
-            frontEndpointStyle: PointStyle.None,
-            rearEndpointStyle: PointStyle.Arrow,
-        },
+        // the plain connector tool must keep the user's own style (#144 M1). It is
+        // the toolbox's (`coreDomainMovementStyle`, `docs/adr/0045`), so a
+        // movement drawn here and one built by a host look the same.
+        style: coreDomainMovementStyle(),
     });
 }

package/dist/core-domain/background.js

@@ -1,5 +1,5 @@
-import { CD_SUBDOMAINS, FONT_FAMILY } from '@formicoidea/labre-ddd-shared';
-import { NOTATION_NEUTRALS } from '@formicoidea/labre-core/shared/consts';
+import { CD_SUBDOMAINS, FONT_FAMILY, } from '@formicoidea/labre-ddd-shared/headless';
+import { NOTATION_NEUTRALS } from '@formicoidea/labre-core/shared/headless';
 import { CORE_DOMAIN_ROLE } from '../roles.js';
 /**
  * The Core Domain Chart background, DECLARED.

package/dist/index.d.ts

@@ -13,3 +13,4 @@ export { coreDomainSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddCoreDomainSeniorButton } from './toolbar/senior-button.js';
 export { DddCoreDomainRenderViewExtension, DddCoreDomainViewExtension, } from './view.js';
 export { CORE_DOMAIN_MARKER_READING, CORE_DOMAIN_READING, CORE_DOMAIN_READINGS, } from './reading.js';
+export { CORE_DOMAIN_TOOLBOX, coreDomainChartElement, coreDomainMarkerElements, coreDomainMovementElement, coreDomainMovementStyle, coreDomainSubdomainElements, } from './toolbox.js';

package/dist/index.js

@@ -16,3 +16,5 @@ export { coreDomainSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddCoreDomainSeniorButton } from './toolbar/senior-button.js';
 export { DddCoreDomainRenderViewExtension, DddCoreDomainViewExtension, } from './view.js';
 export { CORE_DOMAIN_MARKER_READING, CORE_DOMAIN_READING, CORE_DOMAIN_READINGS, } from './reading.js';
+// The toolbar as pure builders (`docs/adr/0045`), also on `./interchange`.
+export { CORE_DOMAIN_TOOLBOX, coreDomainChartElement, coreDomainMarkerElements, coreDomainMovementElement, coreDomainMovementStyle, coreDomainSubdomainElements, } from './toolbox.js';

package/dist/interchange-headless.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `./interchange` — the Core Domain Chart 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 chart, sub-domain dots, Team Topologies markers and movements 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 { CORE_DOMAIN_TOOLBOX, coreDomainChartElement, coreDomainMarkerElements, coreDomainMovementElement, coreDomainMovementStyle, coreDomainSubdomainElements, } from './toolbox.js';

package/dist/interchange-headless.js

@@ -0,0 +1,10 @@
+/**
+ * `./interchange` — the Core Domain Chart 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 chart, sub-domain dots, Team Topologies markers and movements 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 { CORE_DOMAIN_TOOLBOX, coreDomainChartElement, coreDomainMarkerElements, coreDomainMovementElement, coreDomainMovementStyle, coreDomainSubdomainElements, } from './toolbox.js';

package/dist/roles.d.ts

@@ -1,4 +1,4 @@
-import { CD_SUBDOMAINS, TEAM_TOPOLOGIES } from '@formicoidea/labre-ddd-shared';
+import { CD_SUBDOMAINS, TEAM_TOPOLOGIES } from '@formicoidea/labre-ddd-shared/headless';
 import type { RoleDefs, RoleId } from '@formicoidea/labre-core/std/gfx';
 /**
  * The five dot presets' own `kind`, read off the shared table rather than

package/dist/roles.js

@@ -1,4 +1,4 @@
-import { CD_SUBDOMAINS, TEAM_TOPOLOGIES } from '@formicoidea/labre-ddd-shared';
+import { CD_SUBDOMAINS, TEAM_TOPOLOGIES, } from '@formicoidea/labre-ddd-shared/headless';
 /**
  * Role ids, keyed by the `kind` the creation sites use — camelCased, exactly
  * like `CD_SUBDOMAINS[].kind`, so `commands.ts` can hand a preset's own kind

package/dist/toolbox.d.ts

@@ -0,0 +1,36 @@
+import { type FrameworkToolbox, type SerializedElementProps, type ToolboxPoint } from '@formicoidea/labre-core/interchange';
+import { PointStyle, StrokeStyle } from '@formicoidea/labre-core/model/headless';
+import { type CdMarkerKind, type CdSubdomainKind } from './roles.js';
+/**
+ * How a movement is drawn: a red dashed line, the arrow at the far end. The
+ * look rides on the connector, the meaning is `core-domain:movement`.
+ */
+export declare function coreDomainMovementStyle(): {
+    stroke: string;
+    strokeStyle: StrokeStyle;
+    strokeWidth: number;
+    frontEndpointStyle: PointStyle;
+    rearEndpointStyle: PointStyle;
+};
+/** The chart a core domain map is drawn on, at `at`. */
+export declare function coreDomainChartElement(at: ToolboxPoint, local?: string): SerializedElementProps;
+/**
+ * A sub-domain dot of one preset whose ellipse is at `at`, captioned `name` or
+ * the toolbar's English seed: the ellipse carrying the preset's role, the
+ * caption to its right and their group.
+ */
+export declare function coreDomainSubdomainElements(kind: CdSubdomainKind, at: ToolboxPoint, name?: string, local?: string): SerializedElementProps[];
+/**
+ * A Team Topologies marker of one interaction mode whose square is at `at`,
+ * captioned `name` or the toolbar's English seed: the square carrying the
+ * mode's role, its letter, the caption and their group.
+ */
+export declare function coreDomainMarkerElements(kind: CdMarkerKind, at: ToolboxPoint, name?: string, local?: string): SerializedElementProps[];
+/**
+ * A movement over time between two elements: the connector the palette's
+ * entry arms the tool with. Its source is the current position, its target
+ * the future one, the pair `core-domain.malformed-movement` reads back.
+ */
+export declare function coreDomainMovementElement(from: string, to: string, label?: string): SerializedElementProps;
+/** Every item of the Core Domain Chart toolbar, in the toolbar's order. */
+export declare const CORE_DOMAIN_TOOLBOX: FrameworkToolbox;

package/dist/toolbox.js

@@ -0,0 +1,135 @@
+import { backgroundSize, } from '@formicoidea/labre-core/interchange';
+import { CD_SUBDOMAINS, DOT_SIZE, dotElements, MARKER_SIZE, markerElements, MOVEMENT_COLOR, TEAM_TOPOLOGIES, } 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 { coreDomainCommandsManifest } from './commands-manifest.js';
+import { CORE_DOMAIN_BACKGROUND } from './core-domain/background.js';
+import { CORE_DOMAIN_ROLE, markerRole, subdomainRole, } from './roles.js';
+/**
+ * The Core Domain Chart toolbar as pure builders (`docs/adr/0045`): the chart,
+ * the five sub-domain dots, the three Team Topologies markers and the movement
+ * over time, with no editor behind them. The dots and the markers are the very
+ * builders the palette's prefabs write (`@labre/affine-gfx-ddd-shared/headless`),
+ * and `createCoreDomainChart` and `activateMovement` read the chart and the
+ * movement style from here, so a dot drawn by a host and one placed from the
+ * toolbar are the same element.
+ */
+/** The stroke width the movement arrow has always been drawn at. */
+const MOVEMENT_STROKE_WIDTH = 2;
+/**
+ * How a movement is drawn: a red dashed line, the arrow at the far end. The
+ * look rides on the connector, the meaning is `core-domain:movement`.
+ */
+export function coreDomainMovementStyle() {
+    return {
+        stroke: MOVEMENT_COLOR,
+        strokeStyle: StrokeStyle.Dash,
+        strokeWidth: MOVEMENT_STROKE_WIDTH,
+        frontEndpointStyle: PointStyle.None,
+        rearEndpointStyle: PointStyle.Arrow,
+    };
+}
+/** The chart a core domain map is drawn on, at `at`. */
+export function coreDomainChartElement(at, local = 'chart') {
+    const { width, height } = backgroundSize(CORE_DOMAIN_BACKGROUND);
+    return {
+        type: CORE_DOMAIN_BACKGROUND.type,
+        id: local,
+        // The chart is a first-class role: rules position artefacts against
+        // `core-domain:chart`, never against the `coreDomain` element type.
+        role: CORE_DOMAIN_BACKGROUND.role,
+        resizeEnabled: CORE_DOMAIN_BACKGROUND.geometry.resizable,
+        xywh: new Bound(at.x, at.y, width, height).serialize(),
+    };
+}
+const kebab = (kind) => kind.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+/**
+ * A sub-domain dot of one preset whose ellipse is at `at`, captioned `name` or
+ * the toolbar's English seed: the ellipse carrying the preset's role, the
+ * caption to its right and their group.
+ */
+export function coreDomainSubdomainElements(kind, at, name, local = kebab(kind)) {
+    const preset = CD_SUBDOMAINS.find(p => p.kind === kind);
+    if (!preset)
+        return [];
+    return dotElements(at, preset.fill, name?.trim() || preset.label, subdomainRole(kind), local);
+}
+/**
+ * A Team Topologies marker of one interaction mode whose square is at `at`,
+ * captioned `name` or the toolbar's English seed: the square carrying the
+ * mode's role, its letter, the caption and their group.
+ */
+export function coreDomainMarkerElements(kind, at, name, local = kebab(kind)) {
+    const preset = TEAM_TOPOLOGIES.find(p => p.kind === kind);
+    if (!preset)
+        return [];
+    return markerElements(at, {
+        fill: preset.fill,
+        letter: preset.letter,
+        label: name?.trim() || preset.label,
+        role: markerRole(kind),
+    }, local);
+}
+/**
+ * A movement over time between two elements: the connector the palette's
+ * entry arms the tool with. Its source is the current position, its target
+ * the future one, the pair `core-domain.malformed-movement` reads back.
+ */
+export function coreDomainMovementElement(from, to, label) {
+    return {
+        type: 'connector',
+        role: CORE_DOMAIN_ROLE.movement,
+        mode: ConnectorMode.Straight,
+        ...coreDomainMovementStyle(),
+        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-core-domain.${command}`;
+    const row = coreDomainCommandsManifest.find(r => r.id === id);
+    return {
+        labelKey: row?.labelKey ?? id,
+        labelFallback: row?.labelFallback ?? id,
+    };
+}
+const command = (kind) => `add${kind[0]?.toUpperCase()}${kind.slice(1)}`;
+const subdomain = (kind) => ({
+    id: kebab(kind),
+    ...label(command(kind)),
+    texts: ['name'],
+    size: { w: DOT_SIZE, h: DOT_SIZE },
+    build: (at, texts, local) => coreDomainSubdomainElements(kind, at, texts?.name, local),
+});
+const marker = (kind) => ({
+    id: kebab(kind),
+    ...label(command(kind)),
+    texts: ['name'],
+    size: { w: MARKER_SIZE, h: MARKER_SIZE },
+    build: (at, texts, local) => coreDomainMarkerElements(kind, at, texts?.name, local),
+});
+const CHART_SIZE = backgroundSize(CORE_DOMAIN_BACKGROUND);
+/** Every item of the Core Domain Chart toolbar, in the toolbar's order. */
+export const CORE_DOMAIN_TOOLBOX = {
+    framework: 'ddd-core-domain',
+    items: [
+        {
+            id: 'chart',
+            ...label('addChart'),
+            texts: [],
+            size: { w: CHART_SIZE.width, h: CHART_SIZE.height },
+            build: (at, _texts, local) => [coreDomainChartElement(at, local)],
+        },
+        ...CD_SUBDOMAINS.map(preset => subdomain(preset.kind)),
+        ...TEAM_TOPOLOGIES.map(preset => marker(preset.kind)),
+    ],
+    links: [
+        {
+            id: 'movement',
+            ...label('addMovement'),
+            build: (from, to, text) => coreDomainMovementElement(from, to, text),
+        },
+    ],
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-ddd-core-domain",
   "description": "Labre ddd-core-domain 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"
   }
 }