@formicoidea/labre-framework-cynefin 0.32.0 → 0.34.1

package/dist/estuarine/nudges.d.ts

@@ -0,0 +1,41 @@
+import type { QualityNudge } from '@formicoidea/labre-core/blocks/surface';
+/**
+ * Estuarine **map quality** — the checklist, and this framework's ENTIRE
+ * contribution to validation (WS4).
+ *
+ * ## No rules, and therefore no profiles (PO arbitration, 26/08/2026)
+ *
+ * The 26/08 study looked for deterministic rules on an Estuarine map and found
+ * none worth shipping. Everything an Estuarine session decides — where the
+ * counter-factual line falls, which constraints are volatile, whether a
+ * constraint is a constructor or an actor — is a judgement the group makes out
+ * loud; an algorithm that claimed to check any of it would be lying about the
+ * one thing the method exists to produce.
+ *
+ * A severity profile is a dial over rules. With no rule to dial, a profile
+ * picker is a control that decides nothing: three entries, no observable
+ * effect, and a user reasonably concluding that the tool checks something it
+ * does not. So this framework ships **no `profiles.ts`** — deliberately, not
+ * by omission. The profiles will be born WITH the first rule, if one is ever
+ * born; until then the file's absence is the honest statement.
+ *
+ * What does reach the user is this checklist, offered on the map because
+ * `ValidationFrameworkExtension` declares `estuarine:map` a root instance
+ * (WS0.3) — the gate no longer needs a rule to exist.
+ *
+ * Registered from the flag-gated `CynefinEstuarineViewExtension`, beside the
+ * framework declaration: a checklist is tooling. Switching the flag off takes
+ * it away and leaves the ticks written on the map, unread, until it comes back.
+ */
+/**
+ * **Q1–Q4** — the four things an Estuarine map needs in order to do its job,
+ * and that no algorithm can check.
+ *
+ * Q1 and Q2 are about the two lines that make the map a map: a counter-factual
+ * line nobody argued over is a curve, not a boundary, and an undelimited
+ * volatile zone leaves every constraint equally urgent. Q3 is the method's own
+ * discipline — above the counter-factual line you do not act, you Monitor,
+ * Research or Request. Q4 is the typing the hexagons carry in the group's head
+ * and nowhere in the document.
+ */
+export declare const ESTUARINE_NUDGES: readonly QualityNudge[];

package/dist/estuarine/nudges.js

@@ -0,0 +1,69 @@
+/**
+ * Estuarine **map quality** — the checklist, and this framework's ENTIRE
+ * contribution to validation (WS4).
+ *
+ * ## No rules, and therefore no profiles (PO arbitration, 26/08/2026)
+ *
+ * The 26/08 study looked for deterministic rules on an Estuarine map and found
+ * none worth shipping. Everything an Estuarine session decides — where the
+ * counter-factual line falls, which constraints are volatile, whether a
+ * constraint is a constructor or an actor — is a judgement the group makes out
+ * loud; an algorithm that claimed to check any of it would be lying about the
+ * one thing the method exists to produce.
+ *
+ * A severity profile is a dial over rules. With no rule to dial, a profile
+ * picker is a control that decides nothing: three entries, no observable
+ * effect, and a user reasonably concluding that the tool checks something it
+ * does not. So this framework ships **no `profiles.ts`** — deliberately, not
+ * by omission. The profiles will be born WITH the first rule, if one is ever
+ * born; until then the file's absence is the honest statement.
+ *
+ * What does reach the user is this checklist, offered on the map because
+ * `ValidationFrameworkExtension` declares `estuarine:map` a root instance
+ * (WS0.3) — the gate no longer needs a rule to exist.
+ *
+ * Registered from the flag-gated `CynefinEstuarineViewExtension`, beside the
+ * framework declaration: a checklist is tooling. Switching the flag off takes
+ * it away and leaves the ticks written on the map, unread, until it comes back.
+ */
+/**
+ * **Q1–Q4** — the four things an Estuarine map needs in order to do its job,
+ * and that no algorithm can check.
+ *
+ * Q1 and Q2 are about the two lines that make the map a map: a counter-factual
+ * line nobody argued over is a curve, not a boundary, and an undelimited
+ * volatile zone leaves every constraint equally urgent. Q3 is the method's own
+ * discipline — above the counter-factual line you do not act, you Monitor,
+ * Research or Request. Q4 is the typing the hexagons carry in the group's head
+ * and nowhere in the document.
+ */
+export const ESTUARINE_NUDGES = [
+    {
+        id: 'estuarine.q1-counterfactual',
+        framework: 'estuarine',
+        labelKey: 'com.labre.estuarine.quality.counterfactual',
+        fallback: 'The counter-factual line has been negotiated and drawn by the group',
+        order: 1,
+    },
+    {
+        id: 'estuarine.q2-volatile-zone',
+        framework: 'estuarine',
+        labelKey: 'com.labre.estuarine.quality.volatile-zone',
+        fallback: 'The volatile zone has been delimited',
+        order: 2,
+    },
+    {
+        id: 'estuarine.q3-strategies',
+        framework: 'estuarine',
+        labelKey: 'com.labre.estuarine.quality.strategies',
+        fallback: 'Every element above the counter-factual line has a Monitor, Research or Request strategy',
+        order: 3,
+    },
+    {
+        id: 'estuarine.q4-hexagon-types',
+        framework: 'estuarine',
+        labelKey: 'com.labre.estuarine.quality.hexagon-types',
+        fallback: 'Every hexagon is typed: constraint, constructor or actor',
+        order: 4,
+    },
+];

package/dist/estuarine/roles.d.ts

@@ -0,0 +1,48 @@
+import type { RoleDefs } from '@formicoidea/labre-core/std/gfx';
+/**
+ * Estuarine role vocabulary (WS4).
+ *
+ * Two roles, and deliberately only two: the MAP — the axes and the three
+ * reference curves an Estuarine session is read against — and the CONSTRAINT
+ * hexagon the group drops onto it. Everything else on such a board (the
+ * captions, the stickies, a free arrow drawn to link two hexagons) is a plain
+ * drawing and stays neutral, because nothing in this framework has anything to
+ * say about it.
+ *
+ * ## Cynefin declares NO role, and never will
+ *
+ * The two frameworks share this package and share nothing else here. The PO's
+ * arbitration of 26/08/2026 is that Cynefin is out of the validation perimeter
+ * for good: its four domains are a sense-making device, not a notation with
+ * rules, so giving its background a role would advertise tooling — a profile
+ * picker, a quality checklist — over a framework that has nothing to check.
+ * A role with no consumer is a promise the product does not keep.
+ *
+ * ## What a role buys Estuarine, which ships no rule either
+ *
+ * The map role is what makes the map a ROOT INSTANCE: it is handed to
+ * `ValidationFrameworkExtension` so the engine can answer "is this element
+ * somebody's frame?" and offer the Map quality checklist on it. That gate used
+ * to be derived from the registered rules alone, which is exactly why WS0.3
+ * gave it a second, explicit source — see `ValidationFrameworkDef`.
+ *
+ * The constraint role earns its keep on its own: a hexagon is a plain polygon
+ * shape on the canvas, so nothing about its geometry says what it means, and
+ * the first rule this framework ever writes will be written against this role
+ * rather than against `shapeType === 'polygon'`.
+ *
+ * ## Compatibility
+ *
+ * No backfill (promise #71): maps and hexagons drawn before today carry no
+ * role, are nobody's frame, and go on painting exactly as they did. They simply
+ * offer no checklist until they are redrawn.
+ */
+/** Every role this framework declares. */
+export type EstuarineRole = 'map' | 'constraint';
+export type EstuarineRoleId = `estuarine:${EstuarineRole}`;
+/** Role ids, keyed by the name used at the creation sites. */
+export declare const ESTUARINE_ROLE: {
+    readonly map: "estuarine:map";
+    readonly constraint: "estuarine:constraint";
+};
+export declare const ESTUARINE_ROLES: RoleDefs;

package/dist/estuarine/roles.js

@@ -0,0 +1,28 @@
+/** Role ids, keyed by the name used at the creation sites. */
+export const ESTUARINE_ROLE = {
+    map: 'estuarine:map',
+    constraint: 'estuarine:constraint',
+};
+const DEFS = [
+    // The map itself: the e / t axes and the three curves everything else is
+    // positioned against. A frame, so it specialises nothing — a rule written on
+    // `estuarine:constraint` must never match the map it is measured against.
+    {
+        id: ESTUARINE_ROLE.map,
+        kind: 'node',
+        labelKey: 'com.labre.estuarine.role.map',
+        labelFallback: 'Estuarine map',
+    },
+    // The hexi constraint. A `node`: it is measured by its bounds, which is
+    // exactly what an Estuarine reading is about — where on the energy/time
+    // plane the group placed this constraint.
+    {
+        id: ESTUARINE_ROLE.constraint,
+        kind: 'node',
+        labelKey: 'com.labre.estuarine.role.constraint',
+        labelFallback: 'Constraint',
+    },
+];
+// Null prototype: a lookup table keyed by ids that may one day come from
+// host-supplied packs, so `defs['toString']` must not resolve.
+export const ESTUARINE_ROLES = Object.assign(Object.create(null), Object.fromEntries(DEFS.map(def => [def.id, def])));

package/dist/estuarine/toolbar/config.d.ts

@@ -1,33 +1,38 @@
-import { type ToolbarContext } from '@formicoidea/labre-core/shared/services';
+import { type ChromeWording, type ToolbarContext } from '@formicoidea/labre-core/shared/services';
 import { type TemplateResult } from 'lit';
 export declare const estuarineToolbarConfig: {
     readonly actions: [{
         id: string;
         tooltip: string;
+        tooltipWording: ChromeWording | undefined;
         icon: TemplateResult;
         active(ctx: ToolbarContext): boolean;
         run(ctx: ToolbarContext): void;
     }, {
         id: string;
         tooltip: string;
+        tooltipWording: ChromeWording | undefined;
         icon: TemplateResult;
         active(ctx: ToolbarContext): boolean;
         run(ctx: ToolbarContext): void;
     }, {
         id: string;
         tooltip: string;
+        tooltipWording: ChromeWording | undefined;
         icon: TemplateResult;
         active(ctx: ToolbarContext): boolean;
         run(ctx: ToolbarContext): void;
     }, {
         id: string;
         tooltip: string;
+        tooltipWording: ChromeWording | undefined;
         icon: TemplateResult;
         active(ctx: ToolbarContext): boolean;
         run(ctx: ToolbarContext): void;
     }, {
         id: string;
         tooltip: string;
+        tooltipWording: ChromeWording | undefined;
         icon: TemplateResult;
         active(ctx: ToolbarContext): boolean;
         run(ctx: ToolbarContext): void;

package/dist/estuarine/toolbar/config.js

@@ -1,19 +1,78 @@
 import { EdgelessCRUDIdentifier } from '@formicoidea/labre-core/blocks/surface';
 import { EstuarineElementModel } from '@formicoidea/labre-core/model';
-import { ToolbarModuleExtension, } from '@formicoidea/labre-core/shared/services';
+import { BOARD_RESIZE_TOGGLE, ToolbarModuleExtension, } from '@formicoidea/labre-core/shared/services';
 import { BlockFlavourIdentifier } from '@formicoidea/labre-core/std';
 import { html } from 'lit';
-const ResizeIcon = html `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M9 5H5v4M15 19h4v-4" /><path d="M5 5l6 6M19 19l-6-6" /></svg>`;
+const ResizeIcon = html `<svg
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="1.6"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M9 5H5v4M15 19h4v-4" />
+  <path d="M5 5l6 6M19 19l-6-6" />
+</svg>`;
 // All curve icons use currentColor so the toolbar can grey them when inactive;
 // they are distinguished by shape (wave / arc / hooked curve).
-const LiminalIcon = html `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M3 13c3-6 6 4 9 0s6-6 9 0" /></svg>`;
-const VolatileIcon = html `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M7 4a9 9 0 0 1 0 18" /></svg>`;
-const CounterfactualIcon = html `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M4 7c7 0 11 4 12 14" /></svg>`;
-const AxisIcon = html `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"><path d="M6 3v18M6 12h15" /><path d="M3 6l3-3 3 3M18 9l3 3-3 3" /></svg>`;
+const LiminalIcon = html `<svg
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+>
+  <path d="M3 13c3-6 6 4 9 0s6-6 9 0" />
+</svg>`;
+const VolatileIcon = html `<svg
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+>
+  <path d="M7 4a9 9 0 0 1 0 18" />
+</svg>`;
+const CounterfactualIcon = html `<svg
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+>
+  <path d="M4 7c7 0 11 4 12 14" />
+</svg>`;
+const AxisIcon = html `<svg
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="1.6"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M6 3v18M6 12h15" />
+  <path d="M3 6l3-3 3 3M18 9l3 3-3 3" />
+</svg>`;
 function booleanToggle(id, tooltip, icon, prop) {
     return {
         id,
-        tooltip,
+        tooltip: typeof tooltip === 'string' ? tooltip : tooltip[1],
+        // The declared wording, when the caller gave one instead of a literal:
+        // `combine` resolves it against the host's catalogue and writes it over
+        // the English default above, so a playground with no catalogue reads
+        // exactly what it read before (#183).
+        tooltipWording: typeof tooltip === 'string' ? undefined : tooltip,
         icon,
         active(ctx) {
             const models = ctx.getSurfaceModelsByType(EstuarineElementModel);
@@ -33,7 +92,7 @@ function booleanToggle(id, tooltip, icon, prop) {
 }
 export const estuarineToolbarConfig = {
     actions: [
-        booleanToggle('a.toggle-resize', 'Enable / lock resizing', ResizeIcon, 'resizeEnabled'),
+        booleanToggle('a.toggle-resize', BOARD_RESIZE_TOGGLE, ResizeIcon, 'resizeEnabled'),
         booleanToggle('b.toggle-liminal', 'Show / hide the Liminal line', LiminalIcon, 'showLiminal'),
         booleanToggle('c.toggle-volatile', 'Show / hide the Volatile line', VolatileIcon, 'showVolatile'),
         booleanToggle('d.toggle-counterfactual', 'Show / hide the Counter-factual line', CounterfactualIcon, 'showCounterfactual'),

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, commandCategoryTranslationEntries, 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,10 @@ 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), 
+// The catalogue's own group headers, derived from the very categories
+// these commands declare. They ship WITH the framework because core's
+// 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(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.34.1",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -21,13 +21,18 @@
     "./descriptor": {
       "types": "./dist/descriptor.d.ts",
       "import": "./dist/descriptor.js"
+    },
+    "./commands-manifest": {
+      "types": "./dist/commands-manifest.d.ts",
+      "import": "./dist/commands-manifest.js"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.32.0",
+    "@formicoidea/labre-core": "0.34.1",
+    "@preact/signals-core": "^1.8.0",
     "lit": "^3.2.0"
   }
 }