@formicoidea/labre-framework-cynefin 0.32.0 → 0.33.0

package/dist/templates/index.js

@@ -2,6 +2,7 @@ import { makeTemplateSnapshot, surfaceText, } from '@formicoidea/labre-core/gfx/
 import { FontFamily, ShapeStyle, TextAlign } from '@formicoidea/labre-core/model';
 import { REF_H as CYN_H, REF_W as CYN_W } from '../cynefin/consts.js';
 import { HEX_FILL, HEX_SIZE, HEX_STROKE, HEX_VERTICES, REF_H as EST_H, REF_W as EST_W, } from '../estuarine/consts.js';
+import { ESTUARINE_ROLE } from '../estuarine/roles.js';
 function sticky(x, y, text) {
     return {
         type: 'shape',
@@ -24,6 +25,9 @@ function sticky(x, y, text) {
 function hexagon(x, y) {
     return {
         type: 'shape',
+        // Same role the toolbox stamps (`actions.ts`): a template must produce the
+        // map a user would have drawn by hand, roles included.
+        role: ESTUARINE_ROLE.constraint,
         shapeType: 'polygon',
         vertices: HEX_VERTICES,
         filled: true,
@@ -47,11 +51,23 @@ function caption(x, y, str) {
     };
 }
 function tpl(name, preview, elements) {
-    return { name, type: 'template', preview, content: makeTemplateSnapshot(elements, name) };
+    return {
+        name,
+        type: 'template',
+        preview,
+        content: makeTemplateSnapshot(elements, name),
+    };
 }
 const ATTRS = 'width="100%" height="100%" viewBox="0 0 135 80" xmlns="http://www.w3.org/2000/svg"';
+// Cynefin's background carries NO role, deliberately and for good: the
+// framework is out of the validation perimeter (PO, 26/08/2026). See
+// `estuarine/roles.ts`.
 const cynefinBg = (xywh) => ({ type: 'cynefin', xywh });
-const estuarineBg = (xywh) => ({ type: 'estuarine', xywh });
+const estuarineBg = (xywh) => ({
+    type: 'estuarine',
+    role: ESTUARINE_ROLE.map,
+    xywh,
+});
 export const cynefinTemplateCategory = {
     name: 'Cynefin',
     templates: [

package/dist/toolbar/senior-button.js

@@ -1,5 +1,6 @@
 import { DefaultTool } from '@formicoidea/labre-core/blocks/surface';
 import { EmptyTool } from '@formicoidea/labre-core/gfx/pointer';
+import { translateKey } from '@formicoidea/labre-core/shared/services';
 import { EdgelessToolbarToolMixin } from '@formicoidea/labre-core/widgets/edgeless-toolbar';
 import { SignalWatcher } from '@formicoidea/labre-core/global/lit';
 import { css, html, LitElement } from 'lit';
@@ -64,7 +65,9 @@ export class EdgelessCynefinEstuarineSeniorButton extends EdgelessToolbarToolMix
     render() {
         return html `<edgeless-toolbar-button
       class="ce-button"
-      .tooltip=${this.popper ? '' : 'Cynefin / Estuarine'}
+      .tooltip=${this.popper
+            ? ''
+            : translateKey(this.edgeless.std, 'com.labre.framework.cynefin-estuarine', 'Cynefin / Estuarine')}
       .tooltipOffset=${4}
       .active=${!!this.popper}
       @click=${this._toggleMenu}

package/dist/toolbar/senior-tool.js

@@ -4,6 +4,7 @@ import { html } from 'lit';
 export const cynefinEstuarineSeniorTool = SeniorToolExtension('cynefin-estuarine', ({ block }) => {
     return {
         name: 'Cynefin / Estuarine',
+        labelKey: 'com.labre.framework.cynefin-estuarine',
         content: html `<edgeless-cynefin-estuarine-senior-button
         .edgeless=${block}
       ></edgeless-cynefin-estuarine-senior-button>`,

package/dist/translations.d.ts

@@ -2,6 +2,11 @@ import { type TranslationKeyManifestEntry } from '@formicoidea/labre-core/std';
 /**
  * THIS framework's contribution to the translation-key manifest.
  *
+ * Since WS4 it also carries the Estuarine ROLE labels and the four Map quality
+ * NUDGES — the framework's entire validation vocabulary, since it declares no
+ * rule and no profile (`estuarine/nudges.ts`). Cynefin contributes neither,
+ * having no role of its own.
+ *
  * 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

package/dist/translations.js

@@ -1,8 +1,15 @@
-import { commandTranslationEntries, } from '@formicoidea/labre-core/std';
+import { collectTranslationKeys, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
 import { cynefinEstuarineCommands } from './commands.js';
+import { ESTUARINE_NUDGES } from './estuarine/nudges.js';
+import { ESTUARINE_ROLES } from './estuarine/roles.js';
 /**
  * THIS framework's contribution to the translation-key manifest.
  *
+ * Since WS4 it also carries the Estuarine ROLE labels and the four Map quality
+ * NUDGES — the framework's entire validation vocabulary, since it declares no
+ * rule and no profile (`estuarine/nudges.ts`). Cynefin contributes neither,
+ * having no role of its own.
+ *
  * 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
@@ -12,4 +19,4 @@ import { cynefinEstuarineCommands } from './commands.js';
  * `cynefinEstuarineCommands` into the command registry. See
  * `packages/affine/all/src/translations.ts`.
  */
-export const cynefinEstuarineTranslationEntries = commandTranslationEntries(cynefinEstuarineCommands);
+export const cynefinEstuarineTranslationEntries = mergeTranslationEntries(commandTranslationEntries(cynefinEstuarineCommands), collectTranslationKeys('role', ESTUARINE_ROLES), collectTranslationKeys('nudge', ESTUARINE_NUDGES));

package/dist/view.js

@@ -1,6 +1,9 @@
+import { QualityNudgeExtension, ValidationFrameworkExtension, validationToolbarConfig, } from '@formicoidea/labre-core/blocks/surface';
 import { ViewExtensionProvider, } from '@formicoidea/labre-core/ext-loader';
 import { extendTemplateCategory } from '@formicoidea/labre-core/gfx/template';
-import { CommandExtension } from '@formicoidea/labre-core/std';
+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 { cynefinEstuarineCommandIcons, cynefinEstuarineCommands, } from './commands.js';
 import { CynefinRendererExtension } from './cynefin/element-renderer.js';
 import { CynefinInteraction, CynefinView } from './cynefin/element-view.js';
@@ -8,6 +11,9 @@ import { cynefinToolbarExtension } from './cynefin/toolbar/config.js';
 import { effects } from './effects.js';
 import { EstuarineRendererExtension } from './estuarine/element-renderer.js';
 import { EstuarineInteraction, EstuarineView } from './estuarine/element-view.js';
+import { EstuarineGhostManager, EstuarineGhostOverlay, } from './estuarine/ghost-overlay.js';
+import { ESTUARINE_NUDGES } from './estuarine/nudges.js';
+import { ESTUARINE_ROLE, ESTUARINE_ROLES } from './estuarine/roles.js';
 import { estuarineToolbarExtension } from './estuarine/toolbar/config.js';
 import { cynefinTemplateCategory, estuarineTemplateCategory, } from './templates/index.js';
 import { cynefinEstuarineSeniorTool } from './toolbar/senior-tool.js';
@@ -29,11 +35,26 @@ export class CynefinEstuarineRenderViewExtension extends ViewExtensionProvider {
         context.register(CynefinRendererExtension);
         context.register(EstuarineView);
         context.register(EstuarineRendererExtension);
+        // The role VOCABULARY, always on. A role is written in the document, not in
+        // the tooling: a map drawn while the flag was on and opened while it is off
+        // still carries `estuarine:map`, and anything that READS a role — the
+        // qualification toolbar, a host panel — has to keep working
+        // (`docs/adr/0009`). What JUDGES those roles stays flag-gated below.
+        // Cynefin contributes nothing here and never will (`estuarine/roles.ts`).
+        context.register(RoleVocabularyExtension(ESTUARINE_ROLES));
         if (this.isEdgeless(context.scope)) {
             context.register(CynefinInteraction);
             context.register(EstuarineInteraction);
             context.register(cynefinToolbarExtension);
             context.register(estuarineToolbarExtension);
+            // The reveal animation of a curve toggle. ALWAYS on, with the renderer
+            // it animates: the permanent ghost is how a shown curve looks now, so
+            // the ~600 ms that makes its arrival visible is part of painting the
+            // element, not part of the creation tooling. It writes nothing, and it
+            // costs one media query plus one map lookup on a board with no
+            // Estuarine map at all.
+            context.register(EstuarineGhostOverlay);
+            context.register(EstuarineGhostManager);
         }
     }
 }
@@ -56,6 +77,33 @@ export class CynefinEstuarineViewExtension extends ViewExtensionProvider {
     setup(context) {
         super.setup(context);
         if (this.isEdgeless(context.scope)) {
+            // Estuarine's ROOT INSTANCE declaration (WS0.3). Every other framework
+            // derives "this element is my frame" from a rule naming the role as its
+            // background; Estuarine ships no rule at all — by arbitration, not by
+            // omission (see `estuarine/nudges.ts`) — so it says so explicitly rather
+            // than inventing a rule that fires on nothing just to open a gate.
+            context.register(ValidationFrameworkExtension([
+                {
+                    framework: 'estuarine',
+                    backgroundRole: ESTUARINE_ROLE.map,
+                    roles: ESTUARINE_ROLES,
+                },
+            ]));
+            // Map quality: the four expectations no algorithm can check. This is the
+            // whole of what validation offers on an Estuarine map — no rules, and
+            // therefore NO profiles: a severity dial over an empty rule set is a
+            // control that decides nothing.
+            context.register(QualityNudgeExtension(ESTUARINE_NUDGES));
+            // The Validation dropdown on a selected map's contextual toolbar — a
+            // SECOND module on the same element, through the free `custom:` flavour
+            // slot (`estuarineToolbarExtension` owns the plain one and is always-on,
+            // because a stored map must keep its curve toggles). The config names no
+            // framework: it reads roles, profiles and nudges, so here it renders the
+            // checklist entry and no profile picker.
+            context.register(ToolbarModuleExtension({
+                id: BlockFlavourIdentifier('custom:affine:surface:estuarine'),
+                config: validationToolbarConfig,
+            }));
             context.register(cynefinEstuarineSeniorTool);
             context.register(CommandExtension(cynefinEstuarineCommands, cynefinEstuarineCommandIcons));
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-cynefin",
   "description": "Labre cynefin-estuarine framework for @formicoidea/labre-core.",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -27,7 +27,8 @@
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.32.0",
+    "@formicoidea/labre-core": "0.33.0",
+    "@preact/signals-core": "^1.8.0",
     "lit": "^3.2.0"
   }
 }