@formicoidea/labre-framework-ddd-context-map 0.31.0 → 0.33.0

package/dist/toolbar/context-map-menu.js

@@ -1,107 +1,23 @@
-import { addBubble, addCloud, addLegend, addRelationship, CLOUD, CM_BUBBLE, CM_RELATIONSHIPS, DddMenuBase, } from '@formicoidea/labre-ddd-shared';
-import { html, svg } from 'lit';
-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 legendSwatch = svg `<svg viewBox="0 0 24 24" fill="none"><rect x="3" y="4" width="18" height="16" rx="2" stroke="currentColor" stroke-width="1.6"/><circle cx="7" cy="9" r="1.6" fill="currentColor"/><circle cx="7" cy="14" r="1.6" fill="currentColor"/><path d="M11 9 H18 M11 14 H18" stroke="currentColor" 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>`;
-/** Context Map palette: bounded-context bubble, the cloud, the nine relationship patterns. */
-export class EdgelessDddContextMapMenu extends DddMenuBase {
+import { EmptyTool } from '@formicoidea/labre-core/gfx/pointer';
+import { EdgelessCommandMenu } from '@formicoidea/labre-core/widgets/edgeless-toolbar';
+import { css } from 'lit';
+/**
+ * Context Map palette, rendered from `contextMapCommands` for the
+ * `senior-menu` surface (`docs/adr/0008`). Keeps the DDD palettes' tighter gap
+ * — it is the widest one, at 13 buttons.
+ */
+export class EdgelessDddContextMapMenu extends EdgelessCommandMenu {
     constructor() {
         super(...arguments);
-        this.framework = 'context-map';
-    }
-    _createBubble() {
-        const surface = this.surface;
-        if (!surface)
-            return;
-        const { cx, cy } = this.center;
-        const id = addBubble(surface, cx, cy, 'Bounded Context');
-        this.track('FrameworkElementAdded', 'bounded-context');
-        this.finish(id);
-    }
-    _createCloud() {
-        const surface = this.surface;
-        if (!surface)
-            return;
-        const { cx, cy } = this.center;
-        const id = addCloud(surface, this.edgeless.std, cx, cy, 'System');
-        this.track('FrameworkElementAdded', 'cloud');
-        this.finish(id);
-    }
-    _createRelationship(preset) {
-        const surface = this.surface;
-        if (!surface)
-            return;
-        const { cx, cy } = this.center;
-        const id = addRelationship(surface, this.edgeless.std, cx, cy, preset);
-        this.track('FrameworkElementAdded', `relationship:${preset.kind}`);
-        this.finish(id);
-    }
-    _createLegend() {
-        const surface = this.surface;
-        if (!surface)
-            return;
-        const { cx, cy } = this.center;
-        const patRows = (kinds) => CM_RELATIONSHIPS.filter(r => kinds.includes(r.kind)).map((r) => ({
-            swatch: 'line',
-            color: '#1f2328',
-            label: `${r.abbrev} — ${r.label}`,
-        }));
-        const sections = [
-            {
-                title: 'Boundaries',
-                rows: [
-                    { swatch: 'square', color: CM_BUBBLE.fill, label: 'Bounded Context' },
-                    { swatch: 'square', color: CLOUD.fill, label: 'System / Big Ball of Mud' },
-                ],
-            },
-            { title: 'Mutually dependent', rows: patRows(['partnership', 'sharedKernel']) },
-            {
-                title: 'Upstream → Downstream (U/D)',
-                rows: patRows(['customerSupplier', 'conformist', 'acl', 'ohs', 'publishedLanguage']),
-            },
-            { title: 'Separate / no integration', rows: patRows(['separateWays', 'bbom']) },
-        ];
-        const id = addLegend(surface, this.edgeless.std, cx - 140, cy - 210, {
-            title: 'Légende',
-            sections,
-            width: 290,
-        });
-        this.track('FrameworkElementAdded', 'legend');
-        this.finish(id);
-    }
-    render() {
-        return html `
-      <edgeless-slide-menu>
-        <div class="menu-content">
-          <div class="button-group-container">
-            <edgeless-tool-icon-button
-              .tooltip=${'Bounded Context'}
-              @click=${() => this._createBubble()}
-            >
-              ${bubbleSwatch}
-            </edgeless-tool-icon-button>
-            <edgeless-tool-icon-button
-              .tooltip=${'Cloud / System (Big Ball of Mud)'}
-              @click=${() => this._createCloud()}
-            >
-              ${cloudSwatch}
-            </edgeless-tool-icon-button>
-            ${CM_RELATIONSHIPS.map(preset => html `<edgeless-tool-icon-button
-                .tooltip=${preset.label}
-                @click=${() => this._createRelationship(preset)}
-              >
-                ${relationSwatch(preset.dashed, preset.upDown)}
-              </edgeless-tool-icon-button>`)}
-            <edgeless-tool-icon-button
-              .tooltip=${'Legend'}
-              @click=${() => this._createLegend()}
-            >
-              ${legendSwatch}
-            </edgeless-tool-icon-button>
-          </div>
-        </div>
-      </edgeless-slide-menu>
-    `;
+        this.owner = 'ddd-context-map';
+        this.type = EmptyTool;
     }
+    static { this.styles = [
+        EdgelessCommandMenu.styles,
+        css `
+      :host {
+        --labre-command-menu-gap: 10px;
+      }
+    `,
+    ]; }
 }

package/dist/toolbar/senior-button.d.ts

@@ -2,5 +2,6 @@ import { DddSeniorButtonBase } from '@formicoidea/labre-ddd-shared';
 export declare class EdgelessDddContextMapSeniorButton extends DddSeniorButtonBase {
     protected menuTag: "edgeless-ddd-context-map-menu";
     protected label: string;
+    protected labelKey: string;
     protected icon: import("lit-html").TemplateResult<2>;
 }

package/dist/toolbar/senior-button.js

@@ -4,6 +4,7 @@ export class EdgelessDddContextMapSeniorButton extends DddSeniorButtonBase {
         super(...arguments);
         this.menuTag = 'edgeless-ddd-context-map-menu';
         this.label = 'Context Map';
+        this.labelKey = 'com.labre.framework.ddd-context-map';
         this.icon = contextMapToolbarIcon;
     }
 }

package/dist/toolbar/senior-tool.js

@@ -3,6 +3,7 @@ import { html } from 'lit';
 /** Independent senior tool — Context Map. */
 export const contextMapSeniorTool = SeniorToolExtension('ddd-context-map', ({ block }) => ({
     name: 'Context Map',
+    labelKey: 'com.labre.framework.ddd-context-map',
     content: html `<edgeless-ddd-context-map-senior-button
       .edgeless=${block}
     ></edgeless-ddd-context-map-senior-button>`,

package/dist/translations.d.ts

@@ -0,0 +1,14 @@
+import { type TranslationKeyManifestEntry } from '@formicoidea/labre-core/std';
+/**
+ * THIS framework's contribution to the translation-key manifest — every
+ * `com.labre.*` key Context Mapping can hand to `TranslationProvider.t`,
+ * derived from the very declarations the editor registers (never restated).
+ *
+ * It lives HERE, not in `@labre/affine/translations`, because the bundled
+ * distribution splits the library along exactly this line:
+ * `@formicoidea/labre-core` is the editor MINUS the frameworks, and a host that
+ * installs `@formicoidea/labre-framework-ddd-context-map` composes this export
+ * into the catalogue it builds — the same sentence that already holds for
+ * `contextMapCommands`. See `packages/affine/all/src/translations.ts`.
+ */
+export declare const contextMapTranslationEntries: TranslationKeyManifestEntry[];

package/dist/translations.js

@@ -0,0 +1,20 @@
+import { collectTranslationKeys, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
+import { CONTEXT_MAP_BACKGROUND } from './background.js';
+import { contextMapCommands } from './commands.js';
+import { CONTEXT_MAP_NUDGES } from './nudges.js';
+import { CONTEXT_MAP_PROFILES } from './profiles.js';
+import { CONTEXT_MAP_ROLES } from './roles.js';
+import { CONTEXT_MAP_RULES } from './rules.js';
+/**
+ * THIS framework's contribution to the translation-key manifest — every
+ * `com.labre.*` key Context Mapping can hand to `TranslationProvider.t`,
+ * derived from the very declarations the editor registers (never restated).
+ *
+ * It lives HERE, not in `@labre/affine/translations`, because the bundled
+ * distribution splits the library along exactly this line:
+ * `@formicoidea/labre-core` is the editor MINUS the frameworks, and a host that
+ * installs `@formicoidea/labre-framework-ddd-context-map` composes this export
+ * into the catalogue it builds — the same sentence that already holds for
+ * `contextMapCommands`. See `packages/affine/all/src/translations.ts`.
+ */
+export const contextMapTranslationEntries = mergeTranslationEntries(commandTranslationEntries(contextMapCommands), collectTranslationKeys('role', CONTEXT_MAP_ROLES), collectTranslationKeys('background', CONTEXT_MAP_BACKGROUND), collectTranslationKeys('rule', CONTEXT_MAP_RULES), collectTranslationKeys('nudge', CONTEXT_MAP_NUDGES), collectTranslationKeys('profile', CONTEXT_MAP_PROFILES));

package/dist/view.d.ts

@@ -1,6 +1,22 @@
 import { type ViewExtensionContext, ViewExtensionProvider } from '@formicoidea/labre-core/ext-loader';
 /**
- * Context Map — independently flag-gated (`ddd-context-map`).
+ * Context Map rendering — ALWAYS registered, independent of any flag.
+ * Disabling `ddd-context-map` hides only the creation tooling (see
+ * {@link DddContextMapViewExtension}); boards already drawn must still paint,
+ * stay selectable, stay movable and keep their contextual toolbar. See
+ * `docs/adr/0009`.
+ */
+export declare class DddContextMapRenderViewExtension extends ViewExtensionProvider {
+    name: string;
+    setup(context: ViewExtensionContext): void;
+}
+/**
+ * Context Map creation tooling — independently flag-gated
+ * (`ddd-context-map`): the senior toolbar button, its palette and the
+ * validation rules, profiles and quality nudges. Both halves are tooling: a map
+ * drawn while the flag was on keeps rendering when it goes off, it just stops
+ * being checked — and the profile it was put on stays written, unread, until the
+ * flag comes back.
  *
  * Note: its Templates-panel category is registered by the aggregate package's
  * {@link DddTemplatesViewExtension} (gated by `ddd-templates`), so templates

package/dist/view.js

@@ -1,8 +1,54 @@
+import { QualityNudgeExtension, validationToolbarConfig, ValidationProfileExtension, ValidationRuleExtension, } from '@formicoidea/labre-core/blocks/surface';
 import { ViewExtensionProvider, } from '@formicoidea/labre-core/ext-loader';
+import { ToolbarModuleExtension } from '@formicoidea/labre-core/shared/services';
+import { BlockFlavourIdentifier, CommandExtension } from '@formicoidea/labre-core/std';
+import { RoleVocabularyExtension } from '@formicoidea/labre-core/std/gfx';
+import { contextMapCommandIcons, contextMapCommands } from './commands.js';
 import { contextMapEffects } from './effects.js';
+import { ContextMapRendererExtension } from './element-renderer.js';
+import { ContextMapInteraction, ContextMapView } from './element-view.js';
+import { CONTEXT_MAP_NUDGES } from './nudges.js';
+import { CONTEXT_MAP_PROFILES } from './profiles.js';
+import { CONTEXT_MAP_ROLES } from './roles.js';
+import { CONTEXT_MAP_RULES } from './rules.js';
+import { contextMapBoardToolbarExtension } from './toolbar/board-config.js';
 import { contextMapSeniorTool } from './toolbar/senior-tool.js';
 /**
- * Context Map — independently flag-gated (`ddd-context-map`).
+ * Context Map rendering — ALWAYS registered, independent of any flag.
+ * Disabling `ddd-context-map` hides only the creation tooling (see
+ * {@link DddContextMapViewExtension}); boards already drawn must still paint,
+ * stay selectable, stay movable and keep their contextual toolbar. See
+ * `docs/adr/0009`.
+ */
+export class DddContextMapRenderViewExtension extends ViewExtensionProvider {
+    constructor() {
+        super(...arguments);
+        this.name = 'affine-ddd-context-map-render-gfx';
+    }
+    setup(context) {
+        super.setup(context);
+        context.register(ContextMapView);
+        context.register(ContextMapRendererExtension);
+        // The role VOCABULARY, always on. A role is written in the DOCUMENT, not in
+        // the tooling: the direction reveal of a typed relationship, the inversion
+        // command and the toolbar entry that must not lie about one all read this,
+        // and they have to keep working on a map drawn while the flag was on and
+        // opened while it is off (`docs/adr/0009`, `docs/adr/0010`). The rules that
+        // JUDGE those roles stay in the flag-gated extension below.
+        context.register(RoleVocabularyExtension(CONTEXT_MAP_ROLES));
+        if (this.isEdgeless(context.scope)) {
+            context.register(ContextMapInteraction);
+            context.register(contextMapBoardToolbarExtension);
+        }
+    }
+}
+/**
+ * Context Map creation tooling — independently flag-gated
+ * (`ddd-context-map`): the senior toolbar button, its palette and the
+ * validation rules, profiles and quality nudges. Both halves are tooling: a map
+ * drawn while the flag was on keeps rendering when it goes off, it just stops
+ * being checked — and the profile it was put on stays written, unread, until the
+ * flag comes back.
  *
  * Note: its Templates-panel category is registered by the aggregate package's
  * {@link DddTemplatesViewExtension} (gated by `ddd-templates`), so templates
@@ -20,7 +66,22 @@ export class DddContextMapViewExtension extends ViewExtensionProvider {
     setup(context) {
         super.setup(context);
         if (this.isEdgeless(context.scope)) {
+            context.register(ValidationRuleExtension(CONTEXT_MAP_RULES));
+            context.register(ValidationProfileExtension(CONTEXT_MAP_PROFILES));
+            context.register(QualityNudgeExtension(CONTEXT_MAP_NUDGES));
+            // The Validation dropdown on a selected board's contextual toolbar. A
+            // SECOND module on the same element, through the `custom:` flavour slot:
+            // `contextMapBoardToolbarExtension` is registered always-on because a
+            // stored board must keep its resize toggle, while choosing how hard to
+            // check it is tooling and belongs here. The config names no framework —
+            // it reads roles and profiles — so it is the very same object Wardley
+            // registers on its own flavour.
+            context.register(ToolbarModuleExtension({
+                id: BlockFlavourIdentifier('custom:affine:surface:contextMap'),
+                config: validationToolbarConfig,
+            }));
             context.register(contextMapSeniorTool);
+            context.register(CommandExtension(contextMapCommands, contextMapCommandIcons));
         }
     }
 }

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