@formicoidea/labre-framework-ddd-event-storming 0.36.0 → 0.38.1

package/dist/index.d.ts

@@ -10,3 +10,4 @@ export { eventStormingTemplateCategory } from './templates.js';
 export { eventStormingSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddEventStormingSeniorButton } from './toolbar/senior-button.js';
 export { DddEventStormingRenderViewExtension, DddEventStormingViewExtension, } from './view.js';
+export { EVENT_STORMING_READING } from './reading.js';

package/dist/index.js

@@ -13,3 +13,4 @@ export { eventStormingTemplateCategory } from './templates.js';
 export { eventStormingSeniorTool } from './toolbar/senior-tool.js';
 export { EdgelessDddEventStormingSeniorButton } from './toolbar/senior-button.js';
 export { DddEventStormingRenderViewExtension, DddEventStormingViewExtension, } from './view.js';
+export { EVENT_STORMING_READING } from './reading.js';

package/dist/reading.d.ts

@@ -0,0 +1,33 @@
+import type { ReadingProfile } from '@formicoidea/labre-core/blocks/surface';
+/**
+ * What an Event Storming board lets the tool read of a sticky (MF3, the
+ * reversed reading).
+ *
+ * DATA, like the rules and the profiles beside it: the engine
+ * (`@labre/affine-block-surface`) knows how to read a role and a typed edge — it
+ * knows nothing about Event Storming. Everything below is already stated in
+ * `roles.ts` and is merely POINTED AT here.
+ *
+ * Registered from the FLAG-GATED view extension: reading a board is tooling, so
+ * a roll whose flag is off keeps every sticky it has and simply stops being read
+ * (ADR 0009).
+ *
+ * ## One subject, nine kinds
+ *
+ * `es:sticky` is the parent of all nine, so one profile reads them all and the
+ * panel's type line says which ("Domain event › Sticky"). The board is the
+ * FRAME and specialises nothing, exactly so that what is written about the
+ * stickies never falls on the roll they are stuck to.
+ *
+ * The two kinds outside the grammar — the hotspot and the constraint — are read
+ * like the other seven, and deliberately: being outside `es.forbidden-arc`'s
+ * alphabet means no rule judges them, not that nobody may ask what they are.
+ *
+ * ## No nature, no phase
+ *
+ * The framework ships no type-3 tag pack: the nine kinds ARE the roles. And the
+ * roll's timeline is a direction the FLOW states, not a set of declared zones a
+ * position could be read against — `es.against-timeline` reads the edge, and so
+ * does the section below.
+ */
+export declare const EVENT_STORMING_READING: ReadingProfile;

package/dist/reading.js

@@ -0,0 +1,54 @@
+import { ES_ROLE, EVENT_STORMING_ROLES } from './roles.js';
+/**
+ * What an Event Storming board lets the tool read of a sticky (MF3, the
+ * reversed reading).
+ *
+ * DATA, like the rules and the profiles beside it: the engine
+ * (`@labre/affine-block-surface`) knows how to read a role and a typed edge — it
+ * knows nothing about Event Storming. Everything below is already stated in
+ * `roles.ts` and is merely POINTED AT here.
+ *
+ * Registered from the FLAG-GATED view extension: reading a board is tooling, so
+ * a roll whose flag is off keeps every sticky it has and simply stops being read
+ * (ADR 0009).
+ *
+ * ## One subject, nine kinds
+ *
+ * `es:sticky` is the parent of all nine, so one profile reads them all and the
+ * panel's type line says which ("Domain event › Sticky"). The board is the
+ * FRAME and specialises nothing, exactly so that what is written about the
+ * stickies never falls on the roll they are stuck to.
+ *
+ * The two kinds outside the grammar — the hotspot and the constraint — are read
+ * like the other seven, and deliberately: being outside `es.forbidden-arc`'s
+ * alphabet means no rule judges them, not that nobody may ask what they are.
+ *
+ * ## No nature, no phase
+ *
+ * The framework ships no type-3 tag pack: the nine kinds ARE the roles. And the
+ * roll's timeline is a direction the FLOW states, not a set of declared zones a
+ * position could be read against — `es.against-timeline` reads the edge, and so
+ * does the section below.
+ */
+export const EVENT_STORMING_READING = {
+    id: 'event-storming',
+    framework: 'ddd-event-storming',
+    roles: EVENT_STORMING_ROLES,
+    appliesTo: ES_ROLE.sticky,
+    relation: {
+        edgeRole: ES_ROLE.flow,
+        // ADR 0010 tier 2 on this role: the verb is "leads to", so the SOURCE is
+        // what happens FIRST. An edge leaving the subject names what follows it,
+        // one arriving names what it follows.
+        sides: {
+            consumer: {
+                labelKey: 'com.labre.event-storming.reading.relations.consumer',
+                labelFallback: 'Follows',
+            },
+            supplier: {
+                labelKey: 'com.labre.event-storming.reading.relations.supplier',
+                labelFallback: 'Leads to',
+            },
+        },
+    },
+};

package/dist/templates.d.ts

@@ -1,6 +1,2 @@
-/**
- * Event Storming Templates-panel category. The builder lives in the shared
- * package so the aggregate package can register all DDD categories under the
- * single `ddd-templates` flag; re-exported here for a stable per-package API.
- */
-export { eventStormingTemplateCategory } from '@formicoidea/labre-ddd-shared';
+import { type TemplateCategory } from '@formicoidea/labre-core/gfx/template';
+export declare const eventStormingTemplateCategory: TemplateCategory;

package/dist/templates.js

@@ -1,6 +1,38 @@
+import { ES_HOTSPOT, ES_STICKIES } from '@formicoidea/labre-ddd-shared';
+import { templateFromCommand, } from '@formicoidea/labre-core/gfx/template';
+import { eventStormingCommands } from './commands.js';
 /**
- * Event Storming Templates-panel category. The builder lives in the shared
- * package so the aggregate package can register all DDD categories under the
- * single `ddd-templates` flag; re-exported here for a stable per-package API.
+ * The Event Storming palette — DERIVED from the toolbox, one template per
+ * placement command.
+ *
+ * It used to be hand-written surface JSON in `ddd-shared`, untouched since
+ * 2026-06-21 while the toolbox kept moving: a sticky was one flat rect instead
+ * of the shadow + face the prefab groups, it carried neither
+ * `textFitMode: Contained` nor the `es:*` role every rule reads, and there was
+ * no board template at all. Derived, none of that can happen again — and
+ * `__tests__/templates-parity.unit.spec.ts` re-runs each command and compares.
+ *
+ * The Flow entry has no template on purpose: it arms the connector tool and
+ * draws nothing (`docs/adr/0010`) — the user draws the arc.
  */
-export { eventStormingTemplateCategory } from '@formicoidea/labre-ddd-shared';
+/** The command a derived template is the picture of. Throws rather than skips. */
+function byLabel(label) {
+    const command = eventStormingCommands.find(entry => entry.labelFallback === label);
+    if (!command) {
+        throw new Error(`[ddd-event-storming] templates: no command "${label}"`);
+    }
+    return command;
+}
+const ATTRS = 'width="100%" height="100%" viewBox="0 0 135 80" xmlns="http://www.w3.org/2000/svg"';
+const sq = (c) => `<svg ${ATTRS}><rect x="38" y="13" width="60" height="54" rx="5" fill="${c}"/></svg>`;
+const dia = (c) => `<svg ${ATTRS}><rect x="48" y="20" width="40" height="40" transform="rotate(45 68 40)" fill="${c}"/></svg>`;
+/** The roll, in miniature: a white card, a few stickies, and the one axis. */
+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="14" y="18" width="18" height="18" rx="3" fill="${ES_STICKIES[0].fill}"/><rect x="38" y="18" width="18" height="18" rx="3" fill="${ES_STICKIES[1].fill}"/><rect x="62" y="18" width="18" height="18" rx="3" fill="${ES_STICKIES[2].fill}"/><rect x="86" y="18" width="18" height="18" rx="3" fill="${ES_STICKIES[3].fill}"/><path d="M12 58 H114" stroke="#6d6e71" stroke-width="3"/><path d="M112 53 L122 58 L112 63 Z" fill="#6d6e71"/></svg>`;
+export const eventStormingTemplateCategory = {
+    name: 'Event Storming',
+    templates: [
+        templateFromCommand(byLabel('Event Storming board'), BOARD_PREVIEW, 'Event Storming board'),
+        ...ES_STICKIES.map(preset => templateFromCommand(byLabel(preset.label), sq(preset.fill), `Event Storming — ${preset.label}`)),
+        templateFromCommand(byLabel(ES_HOTSPOT.label), dia(ES_HOTSPOT.fill), `Event Storming — ${ES_HOTSPOT.label}`),
+    ],
+};

package/dist/translations.js

@@ -3,6 +3,7 @@ import { EVENT_STORMING_BACKGROUND } from './background.js';
 import { eventStormingCommands } from './commands.js';
 import { EVENT_STORMING_NUDGES } from './nudges.js';
 import { EVENT_STORMING_PROFILES } from './profiles.js';
+import { EVENT_STORMING_READING } from './reading.js';
 import { EVENT_STORMING_ROLES } from './roles.js';
 import { EVENT_STORMING_RULES } from './rules.js';
 /**
@@ -25,4 +26,9 @@ export const eventStormingTranslationEntries = mergeTranslationEntries(commandTr
 // registry names no framework category in the bundled distribution, so a
 // host that composed core's manifest alone drew translated entries under
 // English headers (#183).
-commandCategoryTranslationEntries(eventStormingCommands), collectTranslationKeys('role', EVENT_STORMING_ROLES), collectTranslationKeys('background', EVENT_STORMING_BACKGROUND), collectTranslationKeys('rule', EVENT_STORMING_RULES), collectTranslationKeys('nudge', EVENT_STORMING_NUDGES), collectTranslationKeys('profile', EVENT_STORMING_PROFILES));
+commandCategoryTranslationEntries(eventStormingCommands), collectTranslationKeys('role', EVENT_STORMING_ROLES), collectTranslationKeys('background', EVENT_STORMING_BACKGROUND), collectTranslationKeys('rule', EVENT_STORMING_RULES), collectTranslationKeys('nudge', EVENT_STORMING_NUDGES), collectTranslationKeys('profile', EVENT_STORMING_PROFILES), 
+// LAST, and the order is load-bearing: a reading profile carries the
+// 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', EVENT_STORMING_READING));

package/dist/view.d.ts

@@ -19,8 +19,7 @@ export declare class DddEventStormingRenderViewExtension extends ViewExtensionPr
  * 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
- * stay available even when this senior button is disabled.
+ * The Templates-panel category is registered here too (see `effect`).
  */
 export declare class DddEventStormingViewExtension extends ViewExtensionProvider {
     name: string;

package/dist/view.js

@@ -1,15 +1,18 @@
-import { morphToolbarConfig, QualityNudgeExtension, validationToolbarConfig, ValidationProfileExtension, ValidationRuleExtension, } from '@formicoidea/labre-core/blocks/surface';
+import { morphToolbarConfig, QualityNudgeExtension, ReadingProfileExtension, validationToolbarConfig, ValidationProfileExtension, ValidationRuleExtension, } from '@formicoidea/labre-core/blocks/surface';
 import { ViewExtensionProvider, } from '@formicoidea/labre-core/ext-loader';
 import { ToolbarModuleExtension, toolbarModuleKey, } from '@formicoidea/labre-core/shared/services';
+import { extendTemplateCategory } from '@formicoidea/labre-core/gfx/template';
 import { BlockFlavourIdentifier, CommandExtension } from '@formicoidea/labre-core/std';
 import { RoleVocabularyExtension } from '@formicoidea/labre-core/std/gfx';
 import { eventStormingCommandIcons, eventStormingCommands } from './commands.js';
+import { eventStormingTemplateCategory } from './templates.js';
 import { eventStormingEffects } from './effects.js';
 import { EventStormingRendererExtension } from './element-renderer.js';
 import { EventStormingInteraction, EventStormingView } from './element-view.js';
 import { EVENT_STORMING_MORPH_SPEC } from './morph.js';
 import { EVENT_STORMING_NUDGES } from './nudges.js';
 import { EVENT_STORMING_PROFILES } from './profiles.js';
+import { EVENT_STORMING_READING } from './reading.js';
 import { EVENT_STORMING_ROLES } from './roles.js';
 import { EVENT_STORMING_RULES } from './rules.js';
 import { eventStormingBoardToolbarExtension } from './toolbar/board-config.js';
@@ -52,8 +55,7 @@ export class DddEventStormingRenderViewExtension extends ViewExtensionProvider {
  * 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
- * stay available even when this senior button is disabled.
+ * The Templates-panel category is registered here too (see `effect`).
  */
 export class DddEventStormingViewExtension extends ViewExtensionProvider {
     constructor() {
@@ -63,6 +65,10 @@ export class DddEventStormingViewExtension extends ViewExtensionProvider {
     effect() {
         super.effect();
         eventStormingEffects();
+        // The Templates-panel category, gated by this framework's own flag like
+        // every other framework's: a template is tooling (`docs/adr/0009`), and it
+        // is DERIVED from this package's commands, so it registers where they do.
+        extendTemplateCategory(eventStormingTemplateCategory);
     }
     setup(context) {
         super.setup(context);
@@ -81,6 +87,12 @@ export class DddEventStormingViewExtension extends ViewExtensionProvider {
                 id: BlockFlavourIdentifier('custom:affine:surface:eventStorming'),
                 config: validationToolbarConfig,
             }));
+            // The reversed reading (MF3): what the board says about a sticky, on
+            // demand. One declaration — the roles and the flow edge, both already
+            // stated elsewhere in this framework. The CLICK that triggers it is
+            // registered once by the surface and gated by the presence of this
+            // profile, so it goes with the flag without either side naming the other.
+            context.register(ReadingProfileExtension(EVENT_STORMING_READING));
             context.register(eventStormingSeniorTool);
             context.register(CommandExtension(eventStormingCommands, eventStormingCommandIcons));
             // The "Change type" dropdown on a selected STICKY's contextual toolbar —

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-ddd-event-storming",
   "description": "Labre ddd-event-storming framework for @formicoidea/labre-core.",
-  "version": "0.36.0",
+  "version": "0.38.1",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -31,8 +31,8 @@
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.36.0",
-    "@formicoidea/labre-ddd-shared": "0.36.0",
+    "@formicoidea/labre-core": "0.38.1",
+    "@formicoidea/labre-ddd-shared": "0.38.1",
     "lit": "^3.2.0"
   }
 }