@formicoidea/labre-framework-ddd-context-map 0.30.1 → 0.32.0

package/dist/commands.d.ts

@@ -0,0 +1,4 @@
+import type { CommandDescriptor } from '@formicoidea/labre-core/std';
+import { type TemplateResult } from 'lit';
+export declare const contextMapCommands: CommandDescriptor[];
+export declare const contextMapCommandIcons: Record<string, TemplateResult>;

package/dist/commands.js

@@ -0,0 +1,108 @@
+import { addBubble, addCloud, addLegend, addRelationship, CLOUD, CM_BUBBLE, CM_RELATIONSHIPS, placeDddElement, } from '@formicoidea/labre-ddd-shared';
+import { svg } from 'lit';
+/**
+ * The Context Map palette as commands: the bounded-context bubble, the cloud,
+ * the nine relationship patterns and the notation legend (`docs/adr/0008`).
+ */
+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>`;
+/** The notation legend's sections, built from the same relationship presets. */
+function legendSections() {
+    const patRows = (kinds) => CM_RELATIONSHIPS.filter(r => kinds.includes(r.kind)).map((r) => ({
+        swatch: 'line',
+        color: '#1f2328',
+        label: `${r.abbrev} — ${r.label}`,
+    }));
+    return [
+        {
+            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 SPECS = [
+    {
+        id: 'addBoundedContext',
+        label: 'Bounded Context',
+        iconKey: 'ddd-context-map.bubble',
+        element: 'bounded-context',
+        icon: bubbleSwatch,
+        run: std => placeDddElement(std, (surface, cx, cy) => addBubble(surface, cx, cy, 'Bounded Context')),
+    },
+    {
+        id: 'addCloud',
+        label: 'Cloud / System (Big Ball of Mud)',
+        iconKey: 'ddd-context-map.cloud',
+        element: 'cloud',
+        icon: cloudSwatch,
+        run: std => placeDddElement(std, (surface, cx, cy) => addCloud(surface, std, cx, cy, 'System')),
+    },
+    ...CM_RELATIONSHIPS.map((preset) => ({
+        id: `add${preset.kind[0].toUpperCase()}${preset.kind.slice(1)}`,
+        label: preset.label,
+        iconKey: `ddd-context-map.relationship.${preset.kind}`,
+        element: `relationship:${preset.kind}`,
+        icon: relationSwatch(preset.dashed, preset.upDown),
+        run: std => placeDddElement(std, (surface, cx, cy) => addRelationship(surface, std, cx, cy, preset)),
+    })),
+    {
+        id: 'addLegend',
+        label: 'Legend',
+        iconKey: 'ddd-context-map.legend',
+        // Deliberately NOT `kind: 'legend'`: this palette entry has always emitted
+        // `FrameworkElementAdded` with element `'legend'`, and ADR 0008's
+        // no-analytics-breakage rule outranks the taxonomy tidy-up. Promoting it
+        // to `FrameworkLegendCreated` is a telemetry change, not a refactor.
+        element: 'legend',
+        icon: legendSwatch,
+        run: std => placeDddElement(std, (surface, cx, cy) => addLegend(surface, std, cx - 140, cy - 210, {
+            title: 'Légende',
+            sections: legendSections(),
+            width: 290,
+        })),
+    },
+];
+export const contextMapCommands = SPECS.map((spec, order) => ({
+    id: `ddd-context-map.${spec.id}`,
+    owner: 'ddd-context-map',
+    kind: 'artefact',
+    labelKey: `com.labre.commands.ddd-context-map.${spec.id}`,
+    labelFallback: spec.label,
+    category: 'map',
+    iconKey: spec.iconKey,
+    surfaces: ['senior-menu', 'catalogue', 'palette', 'agent'],
+    order,
+    scope: 'edgeless',
+    defaultKeys: { mac: [], other: [] },
+    availability: 'always',
+    run: spec.run,
+    telemetry: { framework: 'ddd-context-map', element: spec.element },
+}));
+export const contextMapCommandIcons = Object.fromEntries(SPECS.map(spec => [spec.iconKey, spec.icon]));

package/dist/descriptor.d.ts

@@ -2,6 +2,6 @@ import { DddContextMapViewExtension } from './view.js';
 /** Host wiring for the ddd-context-map framework. */
 export declare const dddContextMapFramework: {
     readonly flag: "ddd-context-map";
-    readonly telemetry: "ddd-context-map";
+    readonly telemetryKey: "context-map";
     readonly viewExtension: typeof DddContextMapViewExtension;
 };

package/dist/descriptor.js

@@ -2,6 +2,6 @@ import { DddContextMapViewExtension } from './view.js';
 /** Host wiring for the ddd-context-map framework. */
 export const dddContextMapFramework = {
     flag: 'ddd-context-map',
-    telemetry: 'ddd-context-map',
+    telemetryKey: 'context-map',
     viewExtension: DddContextMapViewExtension,
 };

package/dist/effects.d.ts

@@ -1,5 +1,5 @@
-import { EdgelessDddContextMapMenu } from './toolbar/context-map-menu';
-import { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button';
+import { EdgelessDddContextMapMenu } from './toolbar/context-map-menu.js';
+import { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button.js';
 export declare function contextMapEffects(): void;
 declare global {
     interface HTMLElementTagNameMap {

package/dist/effects.js

@@ -1,5 +1,5 @@
-import { EdgelessDddContextMapMenu } from './toolbar/context-map-menu';
-import { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button';
+import { EdgelessDddContextMapMenu } from './toolbar/context-map-menu.js';
+import { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button.js';
 /** Define a custom element once (each tool's effect may run more than once). */
 function define(tag, ctor) {
     if (!customElements.get(tag))

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { contextMapCommandIcons, contextMapCommands } from './commands.js';
+export { contextMapTranslationEntries } from './translations.js';
 export { contextMapTemplateCategory } from './templates.js';
 export { contextMapSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button.js';

package/dist/index.js

@@ -1,3 +1,5 @@
+export { contextMapCommandIcons, contextMapCommands } from './commands.js';
+export { contextMapTranslationEntries } from './translations.js';
 export { contextMapTemplateCategory } from './templates.js';
 export { contextMapSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddContextMapSeniorButton } from './toolbar/senior-button.js';

package/dist/toolbar/context-map-menu.d.ts

@@ -1,10 +1,12 @@
-import { DddMenuBase } from '@formicoidea/labre-ddd-shared';
-/** Context Map palette: bounded-context bubble, the cloud, the nine relationship patterns. */
-export declare class EdgelessDddContextMapMenu extends DddMenuBase {
-    protected framework: "context-map";
-    private _createBubble;
-    private _createCloud;
-    private _createRelationship;
-    private _createLegend;
-    render(): import("lit-html").TemplateResult<1>;
+import { EmptyTool } from '@formicoidea/labre-core/gfx/pointer';
+import { EdgelessCommandMenu } from '@formicoidea/labre-core/widgets/edgeless-toolbar';
+/**
+ * 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 12 buttons.
+ */
+export declare class EdgelessDddContextMapMenu extends EdgelessCommandMenu {
+    static styles: import("lit").CSSResultGroup[];
+    protected owner: "ddd-context-map";
+    type: typeof EmptyTool;
 }

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 12 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/translations.d.ts

@@ -0,0 +1,14 @@
+import { type TranslationKeyManifestEntry } from '@formicoidea/labre-core/std';
+/**
+ * THIS framework's contribution to the translation-key manifest.
+ *
+ * Its command labels and descriptions are built from a TEMPLATE, so the
+ * concrete keys exist nowhere but in the declarations themselves and the
+ * core manifest could not restate them even if it wanted to. The
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-ddd-context-map` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `contextMapCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export declare const contextMapTranslationEntries: TranslationKeyManifestEntry[];

package/dist/translations.js

@@ -0,0 +1,15 @@
+import { commandTranslationEntries, } from '@formicoidea/labre-core/std';
+import { contextMapCommands } from './commands.js';
+/**
+ * THIS framework's contribution to the translation-key manifest.
+ *
+ * Its command labels and descriptions are built from a TEMPLATE, so the
+ * concrete keys exist nowhere but in the declarations themselves and the
+ * core manifest could not restate them even if it wanted to. The
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-ddd-context-map` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `contextMapCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export const contextMapTranslationEntries = commandTranslationEntries(contextMapCommands);

package/dist/view.js

@@ -1,6 +1,8 @@
 import { ViewExtensionProvider, } from '@formicoidea/labre-core/ext-loader';
-import { contextMapEffects } from './effects';
-import { contextMapSeniorTool } from './toolbar/senior-tool';
+import { CommandExtension } from '@formicoidea/labre-core/std';
+import { contextMapCommandIcons, contextMapCommands } from './commands.js';
+import { contextMapEffects } from './effects.js';
+import { contextMapSeniorTool } from './toolbar/senior-tool.js';
 /**
  * Context Map — independently flag-gated (`ddd-context-map`).
  *
@@ -21,6 +23,7 @@ export class DddContextMapViewExtension extends ViewExtensionProvider {
         super.setup(context);
         if (this.isEdgeless(context.scope)) {
             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.30.1",
+  "version": "0.32.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -27,8 +27,8 @@
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.30.1",
-    "@formicoidea/labre-ddd-shared": "0.30.1",
+    "@formicoidea/labre-core": "0.32.0",
+    "@formicoidea/labre-ddd-shared": "0.32.0",
     "lit": "^3.2.0"
   }
 }