@formicoidea/labre-framework-ddd-context-map 0.39.3 → 0.41.0

package/dist/background.js

@@ -1,4 +1,5 @@
 import { CLOUD, CM_BUBBLE, FONT_FAMILY } from '@formicoidea/labre-ddd-shared';
+import { NOTATION_NEUTRALS } from '@formicoidea/labre-core/shared/consts';
 import { CONTEXT_MAP_ROLE } from './roles.js';
 /**
  * The Context Map board, DECLARED (the `FrameworkBackgroundDef` primitive).
@@ -34,8 +35,9 @@ export const CONTEXT_MAP_BACKGROUND = {
     chrome: {
         fontFamily: FONT_FAMILY,
         palette: {
-            card: '#ffffff',
-            cardBorder: '#d5d9e0',
+            /** The card: the shared notation scale's, painted at render time. */
+            card: NOTATION_NEUTRALS.cardFill,
+            cardBorder: NOTATION_NEUTRALS.cardBorder,
             /** The bounded-context pill: the map's own blue. */
             context: CM_BUBBLE.fill,
             contextBorder: CM_BUBBLE.stroke,

package/dist/commands.d.ts

@@ -1,4 +1,17 @@
+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;
 export declare const contextMapCommands: CommandDescriptor[];
 export declare const contextMapCommandIcons: Record<string, TemplateResult>;

package/dist/commands.js

@@ -1,8 +1,28 @@
-import { addBubble, addCloud, CM_RELATIONSHIPS, placeDddElement, } from '@formicoidea/labre-ddd-shared';
+import { addBubble, addCloud, CLOUD, CM_RELATIONSHIPS, placeDddElement, } from '@formicoidea/labre-ddd-shared';
+import { NOTATION_NEUTRALS } from '@formicoidea/labre-core/shared/consts';
+import { translateKey, } from '@formicoidea/labre-core/shared/services';
 import { GfxControllerIdentifier } from '@formicoidea/labre-core/std/gfx';
 import { svg } from 'lit';
 import { activateContextMapRelationship, createContextMapBoard, } from './actions.js';
 import { 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',
+];
 /**
  * The Context Map palette as commands: the board, the bounded-context bubble,
  * the cloud and the nine relationship patterns (`docs/adr/0008`).
@@ -17,9 +37,9 @@ import { CONTEXT_MAP_ROLE } from './roles.js';
  * Chart makes. A palette that could also drop a second, static legend was two
  * answers to one question.
  */
-const boardSwatch = svg `<svg viewBox="0 0 24 24" fill="none"><rect x="2.5" y="4.5" width="19" height="15" rx="2" fill="#ffffff" stroke="currentColor" stroke-width="1.6"/><rect x="5.5" y="8" width="6" height="3.5" rx="1.75" fill="#e6f0fa" stroke="#2f6fb0" stroke-width="1.1"/><rect x="13" y="13" width="6" height="3.5" rx="1.75" fill="#e6f0fa" stroke="#2f6fb0" stroke-width="1.1"/><path d="M11.5 10.5 L13.5 13.8" stroke="currentColor" stroke-width="1.2"/></svg>`;
+const boardSwatch = svg `<svg viewBox="0 0 24 24" fill="none"><rect x="2.5" y="4.5" width="19" height="15" rx="2" fill="${NOTATION_NEUTRALS.cardFill}" stroke="currentColor" stroke-width="1.6"/><rect x="5.5" y="8" width="6" height="3.5" rx="1.75" fill="#e6f0fa" stroke="#2f6fb0" stroke-width="1.1"/><rect x="13" y="13" width="6" height="3.5" rx="1.75" fill="#e6f0fa" stroke="#2f6fb0" stroke-width="1.1"/><path d="M11.5 10.5 L13.5 13.8" stroke="currentColor" stroke-width="1.2"/></svg>`;
 const bubbleSwatch = svg `<svg viewBox="0 0 24 24" fill="none"><rect x="2" y="7" width="20" height="10" rx="5" fill="#e6f0fa" stroke="#2f6fb0" stroke-width="1.6"/></svg>`;
-const cloudSwatch = svg `<svg viewBox="0 0 24 24" fill="none"><path d="M6 17 C3 17 2 14 4.5 12.5 C4 9 8 8 9.5 10 C11 6.5 16 7.5 16 11 C19 10.5 20.5 14 18 16 C18 17 16.5 17 15 17 Z" fill="#f0eef6" stroke="#6d6e71" stroke-width="1.4"/></svg>`;
+const cloudSwatch = svg `<svg viewBox="0 0 24 24" fill="none"><path d="M6 17 C3 17 2 14 4.5 12.5 C4 9 8 8 9.5 10 C11 6.5 16 7.5 16 11 C19 10.5 20.5 14 18 16 C18 17 16.5 17 15 17 Z" fill="${CLOUD.fill}" stroke="${CLOUD.stroke}" stroke-width="1.4"/></svg>`;
 const relationSwatch = (dashed, arrow) => svg `<svg viewBox="0 0 24 24" fill="none"><path d="M3 12 H${arrow ? 17 : 21}" stroke="currentColor" stroke-width="2" stroke-dasharray="${dashed ? '3 3' : '0'}"/>${arrow ? svg `<path d="M15 8 L21 12 L15 16" stroke="currentColor" stroke-width="2" fill="none"/>` : ''}</svg>`;
 const SPECS = [
     {
@@ -40,10 +60,12 @@ const SPECS = [
         element: 'bounded-context',
         icon: bubbleSwatch,
         run: std => placeDddElement(std, (surface, cx, cy) => 
-        // The role is what makes a bubble a bounded CONTEXT rather than a blue
-        // pill: every rule in `rules.ts` reads it, and a pill drawn before WS2
-        // carries none and is never evaluated (promesse #71).
-        addBubble(surface, cx, cy, 'Bounded Context', CONTEXT_MAP_ROLE.context)),
+        // Translated HERE and once: the caption is document content the
+        // moment it lands (ADR 0016). The role is what makes a bubble a
+        // bounded CONTEXT rather than a blue pill: every rule in `rules.ts`
+        // reads it, and a pill drawn before WS2 carries none and is never
+        // evaluated (promesse #71).
+        addBubble(surface, cx, cy, translateKey(std, ...CONTEXT_MAP_SEED_BOUNDED_CONTEXT), CONTEXT_MAP_ROLE.context)),
     },
     {
         id: 'addCloud',
@@ -51,7 +73,9 @@ const SPECS = [
         iconKey: 'ddd-context-map.cloud',
         element: 'cloud',
         icon: cloudSwatch,
-        run: std => placeDddElement(std, (surface, cx, cy) => addCloud(surface, std, cx, cy, 'System')),
+        run: std => placeDddElement(std, (surface, cx, cy) => 
+        // Translated HERE and once, like the bubble above (ADR 0016).
+        addCloud(surface, std, cx, cy, translateKey(std, ...CONTEXT_MAP_SEED_CLOUD))),
     },
     ...CM_RELATIONSHIPS.map((preset) => ({
         id: `add${preset.kind[0].toUpperCase()}${preset.kind.slice(1)}`,

package/dist/legend.js

@@ -1,5 +1,7 @@
 import { CM_BUBBLE, CM_RELATIONSHIPS, LABEL_COLOR, roleLabel, } from '@formicoidea/labre-ddd-shared';
+import { BOARD_LEGEND_TITLE } from '@formicoidea/labre-core/shared/services';
 import { CM_PATTERN_ROLE, CONTEXT_MAP_ROLE, CONTEXT_MAP_ROLES } from './roles.js';
+import { CONTEXT_MAP_SEED_LEGEND_BOUNDARIES, CONTEXT_MAP_SEED_LEGEND_RELATIONSHIPS, } from './translations.js';
 /**
  * What the Context Map board's automatic legend can say — a TABLE, and nothing
  * else: the scan, the placement and the box are `createAutoLegend`'s job.
@@ -19,12 +21,14 @@ import { CM_PATTERN_ROLE, CONTEXT_MAP_ROLE, CONTEXT_MAP_ROLES } from './roles.js
  * the day the cloud earns a role its row lands here in one line.
  */
 export const CONTEXT_MAP_AUTO_LEGEND = {
-    title: 'Legend',
+    title: BOARD_LEGEND_TITLE[1],
+    titleKey: BOARD_LEGEND_TITLE[0],
     width: 290,
     roles: CONTEXT_MAP_ROLES,
     sections: [
         {
-            title: 'Boundaries',
+            title: CONTEXT_MAP_SEED_LEGEND_BOUNDARIES[1],
+            titleKey: CONTEXT_MAP_SEED_LEGEND_BOUNDARIES[0],
             entries: [
                 {
                     role: CONTEXT_MAP_ROLE.context,
@@ -37,18 +41,24 @@ export const CONTEXT_MAP_AUTO_LEGEND = {
             ],
         },
         {
-            title: 'Relationships',
+            title: CONTEXT_MAP_SEED_LEGEND_RELATIONSHIPS[1],
+            titleKey: CONTEXT_MAP_SEED_LEGEND_RELATIONSHIPS[0],
             // One entry per PATTERN, not one for `context-map:relationship`: a legend
             // that said "Relationship" would document nothing a reader could use. The
             // dashed sample marks the two "no real integration" patterns, exactly as
             // the board draws them.
             entries: CM_RELATIONSHIPS.map(preset => ({
                 role: CM_PATTERN_ROLE[preset.kind],
+                labelPrefix: preset.abbrev,
                 row: {
                     swatch: 'line',
                     color: LABEL_COLOR,
                     dashed: preset.dashed,
-                    label: `${preset.abbrev} — ${preset.label}`,
+                    // Overwritten by `resolveRowLabel` (labelPrefix + the role's own
+                    // translated `labelKey`, which every one of the nine patterns
+                    // carries) the moment the legend is actually built — this is the
+                    // pre-translation placeholder only.
+                    label: preset.label,
                 },
             })),
         },

package/dist/templates.js

@@ -1,5 +1,6 @@
 import { CLOUD, CM_BUBBLE } from '@formicoidea/labre-ddd-shared';
 import { templateFromCommand, } from '@formicoidea/labre-core/gfx/template';
+import { NOTATION_NEUTRALS } from '@formicoidea/labre-core/shared/consts';
 import { contextMapCommands } from './commands.js';
 /**
  * The Context Map palette — DERIVED from the toolbox, one template per
@@ -24,13 +25,18 @@ function byLabel(label) {
 }
 const ATTRS = 'width="100%" height="100%" viewBox="0 0 135 80" xmlns="http://www.w3.org/2000/svg"';
 /** The map, in miniature: a white card, two contexts and the line between them. */
-const BOARD_PREVIEW = `<svg ${ATTRS} fill="none"><rect x="4" y="6" width="127" height="68" rx="6" fill="#ffffff" stroke="#d5d9e0" stroke-width="1.5"/><rect x="18" y="20" width="44" height="18" rx="9" fill="${CM_BUBBLE.fill}" stroke="${CM_BUBBLE.stroke}" stroke-width="1.5"/><rect x="74" y="44" width="44" height="18" rx="9" fill="${CM_BUBBLE.fill}" stroke="${CM_BUBBLE.stroke}" stroke-width="1.5"/><path d="M62 33 L76 48" stroke="#1f2328" stroke-width="1.5"/></svg>`;
+const BOARD_PREVIEW = `<svg ${ATTRS} fill="none"><rect x="4" y="6" width="127" height="68" rx="6" fill="${NOTATION_NEUTRALS.cardFill}" stroke="${NOTATION_NEUTRALS.cardBorder}" stroke-width="1.5"/><rect x="18" y="20" width="44" height="18" rx="9" fill="${CM_BUBBLE.fill}" stroke="${CM_BUBBLE.stroke}" stroke-width="1.5"/><rect x="74" y="44" width="44" height="18" rx="9" fill="${CM_BUBBLE.fill}" stroke="${CM_BUBBLE.stroke}" stroke-width="1.5"/><path d="M62 33 L76 48" stroke="${NOTATION_NEUTRALS.ink}" stroke-width="1.5"/></svg>`;
 const BUBBLE_PREVIEW = `<svg ${ATTRS} fill="none"><rect x="20" y="25" width="95" height="30" rx="15" fill="${CM_BUBBLE.fill}" stroke="${CM_BUBBLE.stroke}" stroke-width="1.6"/></svg>`;
 const CLOUD_PREVIEW = `<svg ${ATTRS} fill="none"><path d="M30 52 C18 52 16 40 26 37 C24 25 42 24 46 32 C50 22 70 24 70 35 C84 32 90 46 78 50 Z" fill="${CLOUD.fill}" stroke="${CLOUD.stroke}" stroke-width="1.4"/></svg>`;
 export const contextMapTemplateCategory = {
     name: 'Context Map',
+    // Reuses the senior button's own key — see `TemplateCategory.nameKey`.
+    nameKey: 'com.labre.framework.ddd-context-map',
     templates: [
-        templateFromCommand(byLabel('Context Map board'), BOARD_PREVIEW, 'Context Map board'),
+        // No name override: it would only restate `addBoard`'s own
+        // `labelFallback` as a second literal the panel could not translate — see
+        // `resolveTemplateName`, which reads the command's `labelKey` instead.
+        templateFromCommand(byLabel('Context Map board'), BOARD_PREVIEW),
         templateFromCommand(byLabel('Bounded Context'), BUBBLE_PREVIEW, 'Context Map — Bounded Context'),
         templateFromCommand(byLabel('Cloud / System (Big Ball of Mud)'), CLOUD_PREVIEW, 'Context Map — Cloud / System'),
     ],

package/dist/translations.d.ts

@@ -1,4 +1,14 @@
+import type { ChromeWording } from '@formicoidea/labre-core/shared/services';
 import { type TranslationKeyManifestEntry } from '@formicoidea/labre-core/std';
+/**
+ * The automatic legend's own section titles (`legend.ts`) — text stamped onto
+ * the board the moment the legend is built (`createAutoLegend`), like any
+ * other seed. The box title itself is NOT here: it says the shared word
+ * "Legend", so it reuses `BOARD_LEGEND_TITLE`
+ * (`@labre/affine-shared/services`) instead of a key of its own.
+ */
+export declare const CONTEXT_MAP_SEED_LEGEND_BOUNDARIES: ChromeWording;
+export declare const CONTEXT_MAP_SEED_LEGEND_RELATIONSHIPS: ChromeWording;
 /**
  * THIS framework's contribution to the translation-key manifest — every
  * `com.labre.*` key Context Mapping can hand to `TranslationProvider.t`,

package/dist/translations.js

@@ -1,11 +1,26 @@
 import { collectTranslationKeys, commandCategoryTranslationEntries, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
 import { CONTEXT_MAP_BACKGROUND } from './background.js';
-import { contextMapCommands } from './commands.js';
+import { CONTEXT_MAP_SEED_BOUNDED_CONTEXT, CONTEXT_MAP_SEED_CLOUD, contextMapCommands, } from './commands.js';
 import { CONTEXT_MAP_NUDGES } from './nudges.js';
 import { CONTEXT_MAP_PROFILES } from './profiles.js';
 import { CONTEXT_MAP_READING } from './reading.js';
 import { CONTEXT_MAP_ROLES } from './roles.js';
 import { CONTEXT_MAP_RULES } from './rules.js';
+/**
+ * The automatic legend's own section titles (`legend.ts`) — text stamped onto
+ * the board the moment the legend is built (`createAutoLegend`), like any
+ * other seed. The box title itself is NOT here: it says the shared word
+ * "Legend", so it reuses `BOARD_LEGEND_TITLE`
+ * (`@labre/affine-shared/services`) instead of a key of its own.
+ */
+export const CONTEXT_MAP_SEED_LEGEND_BOUNDARIES = [
+    'com.labre.ddd-context-map.seed.legend-boundaries',
+    'Boundaries',
+];
+export const CONTEXT_MAP_SEED_LEGEND_RELATIONSHIPS = [
+    'com.labre.ddd-context-map.seed.legend-relationships',
+    'Relationships',
+];
 /**
  * THIS framework's contribution to the translation-key manifest — every
  * `com.labre.*` key Context Mapping can hand to `TranslationProvider.t`,
@@ -29,4 +44,9 @@ commandCategoryTranslationEntries(contextMapCommands), collectTranslationKeys('r
 // framework's own `roles`, so walking it reaches every role key the `role`
 // line above already named. `mergeTranslationEntries` keeps the FIRST
 // occurrence, which is what makes each key report the source it comes from.
-collectTranslationKeys('reading', CONTEXT_MAP_READING));
+collectTranslationKeys('reading', CONTEXT_MAP_READING), [
+    CONTEXT_MAP_SEED_BOUNDED_CONTEXT,
+    CONTEXT_MAP_SEED_CLOUD,
+    CONTEXT_MAP_SEED_LEGEND_BOUNDARIES,
+    CONTEXT_MAP_SEED_LEGEND_RELATIONSHIPS,
+].map(([key, fallback]) => ({ key, fallback, source: 'seed' })));

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.39.3",
+  "version": "0.41.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -31,8 +31,8 @@
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.39.3",
-    "@formicoidea/labre-ddd-shared": "0.39.3",
+    "@formicoidea/labre-core": "0.41.0",
+    "@formicoidea/labre-ddd-shared": "0.41.0",
     "lit": "^3.2.0"
   }
 }