@formicoidea/labre-framework-cynefin 0.31.0 → 0.33.0

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.js

@@ -3,13 +3,67 @@ import { EstuarineElementModel } from '@formicoidea/labre-core/model';
 import { 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,

package/dist/index.d.ts

@@ -1 +1,2 @@
-export {};
+export { cynefinEstuarineCommandIcons, cynefinEstuarineCommands, } from './commands.js';
+export { cynefinEstuarineTranslationEntries } from './translations.js';

package/dist/index.js

@@ -1 +1,2 @@
-export {};
+export { cynefinEstuarineCommandIcons, cynefinEstuarineCommands, } from './commands.js';
+export { cynefinEstuarineTranslationEntries } from './translations.js';

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

@@ -1,17 +1,11 @@
 import { EmptyTool } from '@formicoidea/labre-core/gfx/pointer';
-import { LitElement } from 'lit';
-declare const EdgelessCynefinEstuarineMenu_base: typeof LitElement & import("@formicoidea/labre-core/_pkgs/global/utils").Constructor<import("@formicoidea/labre-core/_pkgs/affine-widget-edgeless-toolbar").EdgelessToolbarToolClass>;
+import { EdgelessCommandMenu } from '@formicoidea/labre-core/widgets/edgeless-toolbar';
 /**
- * The popover above the toolbar hosting both frameworks: create the Cynefin
- * diagram, the Estuarine map, or a hexagon constraint node.
+ * The popover above the toolbar hosting both frameworks. Since PF3 it declares
+ * nothing: {@link EdgelessCommandMenu} renders `cynefinEstuarineCommands` for
+ * the `senior-menu` surface (`docs/adr/0008`).
  */
-export declare class EdgelessCynefinEstuarineMenu extends EdgelessCynefinEstuarineMenu_base {
-    static styles: import("lit").CSSResult;
+export declare class EdgelessCynefinEstuarineMenu extends EdgelessCommandMenu {
+    protected owner: "cynefin-estuarine";
     type: typeof EmptyTool;
-    private _finish;
-    private _createCynefin;
-    private _createMap;
-    private _createHexagon;
-    render(): import("lit-html").TemplateResult<1>;
 }
-export {};

package/dist/toolbar/menu.js

@@ -1,122 +1,14 @@
-import { DefaultTool } from '@formicoidea/labre-core/blocks/surface';
 import { EmptyTool } from '@formicoidea/labre-core/gfx/pointer';
-import { ShapeStyle, TextFitMode } from '@formicoidea/labre-core/model';
-import { EdgelessToolbarToolMixin } from '@formicoidea/labre-core/widgets/edgeless-toolbar';
-import { Bound } from '@formicoidea/labre-core/global/gfx';
-import { css, html, LitElement } from 'lit';
-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 { cynefinMenuIcon, estuarineMenuIcon, hexagonMenuIcon, } from './icons.js';
-/** Estuarine map default size (REF aspect, scaled up so it reads on canvas). */
-const MAP_SCALE = 1.2;
+import { EdgelessCommandMenu } from '@formicoidea/labre-core/widgets/edgeless-toolbar';
 /**
- * The popover above the toolbar hosting both frameworks: create the Cynefin
- * diagram, the Estuarine map, or a hexagon constraint node.
+ * The popover above the toolbar hosting both frameworks. Since PF3 it declares
+ * nothing: {@link EdgelessCommandMenu} renders `cynefinEstuarineCommands` for
+ * the `senior-menu` surface (`docs/adr/0008`).
  */
-export class EdgelessCynefinEstuarineMenu extends EdgelessToolbarToolMixin(LitElement) {
+export class EdgelessCynefinEstuarineMenu extends EdgelessCommandMenu {
     constructor() {
         super(...arguments);
+        this.owner = 'cynefin-estuarine';
         this.type = EmptyTool;
     }
-    static { this.styles = css `
-    :host {
-      display: flex;
-      z-index: -1;
-      justify-content: center;
-    }
-    .menu-content {
-      display: flex;
-      align-items: center;
-      justify-content: center;
-    }
-    .button-group-container {
-      display: flex;
-      align-items: center;
-      gap: 14px;
-      fill: var(--affine-icon-color);
-    }
-    .button-group-container svg {
-      width: 24px;
-      height: 24px;
-    }
-  `; }
-    _finish(id) {
-        const { gfx } = this;
-        gfx.doc.captureSync();
-        gfx.tool.setTool(DefaultTool);
-        gfx.selection.set({ elements: [id], editing: false });
-    }
-    _createCynefin() {
-        const { gfx } = this;
-        if (!gfx.surface)
-            return;
-        const { centerX, centerY } = gfx.viewport;
-        const id = gfx.surface.addElement({
-            type: 'cynefin',
-            xywh: new Bound(centerX - CYN_W / 2, centerY - CYN_H / 2, CYN_W, CYN_H).serialize(),
-        });
-        this._finish(id);
-    }
-    _createMap() {
-        const { gfx } = this;
-        if (!gfx.surface)
-            return;
-        const width = EST_W * MAP_SCALE;
-        const height = EST_H * MAP_SCALE;
-        const { centerX, centerY } = gfx.viewport;
-        const id = gfx.surface.addElement({
-            type: 'estuarine',
-            xywh: new Bound(centerX - width / 2, centerY - height / 2, width, height).serialize(),
-        });
-        this._finish(id);
-    }
-    _createHexagon() {
-        const { gfx } = this;
-        if (!gfx.surface)
-            return;
-        const { centerX: cx, centerY: cy } = gfx.viewport;
-        const id = gfx.surface.addElement({
-            type: 'shape',
-            shapeType: 'polygon',
-            vertices: HEX_VERTICES,
-            filled: true,
-            fillColor: HEX_FILL,
-            strokeColor: HEX_STROKE,
-            strokeWidth: 2,
-            shapeStyle: ShapeStyle.General,
-            roughness: 0,
-            // hexi constraints behave like post-its: fixed hex, text shrinks
-            textFitMode: TextFitMode.Contained,
-            xywh: new Bound(cx - HEX_SIZE / 2, cy - HEX_SIZE / 2, HEX_SIZE, HEX_SIZE).serialize(),
-        });
-        this._finish(id);
-    }
-    render() {
-        return html `
-      <edgeless-slide-menu>
-        <div class="menu-content">
-          <div class="button-group-container">
-            <edgeless-tool-icon-button
-              .tooltip=${'Cynefin framework'}
-              @click=${this._createCynefin}
-            >
-              ${cynefinMenuIcon}
-            </edgeless-tool-icon-button>
-            <edgeless-tool-icon-button
-              .tooltip=${'Estuarine map'}
-              @click=${this._createMap}
-            >
-              ${estuarineMenuIcon}
-            </edgeless-tool-icon-button>
-            <edgeless-tool-icon-button
-              .tooltip=${'Hexagon node'}
-              @click=${this._createHexagon}
-            >
-              ${hexagonMenuIcon}
-            </edgeless-tool-icon-button>
-          </div>
-        </div>
-      </edgeless-slide-menu>
-    `;
-    }
 }

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

@@ -0,0 +1,19 @@
+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
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-cynefin` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `cynefinEstuarineCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export declare const cynefinEstuarineTranslationEntries: TranslationKeyManifestEntry[];

package/dist/translations.js

@@ -0,0 +1,22 @@
+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
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-cynefin` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `cynefinEstuarineCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export const cynefinEstuarineTranslationEntries = mergeTranslationEntries(commandTranslationEntries(cynefinEstuarineCommands), collectTranslationKeys('role', ESTUARINE_ROLES), collectTranslationKeys('nudge', ESTUARINE_NUDGES));

package/dist/view.d.ts

@@ -1,4 +1,19 @@
 import { type ViewExtensionContext, ViewExtensionProvider } from '@formicoidea/labre-core/ext-loader';
+/**
+ * Cynefin / Estuarine rendering — ALWAYS registered, independent of any flag.
+ * Disabling `cynefin-estuarine` hides only the creation tooling (see
+ * {@link CynefinEstuarineViewExtension}); frames already drawn must still
+ * paint, stay selectable, stay editable and keep their contextual toolbar. See
+ * `docs/adr/0009`.
+ */
+export declare class CynefinEstuarineRenderViewExtension extends ViewExtensionProvider {
+    name: string;
+    setup(context: ViewExtensionContext): void;
+}
+/**
+ * Cynefin / Estuarine creation tooling — flag-gated (`cynefin-estuarine`): the
+ * senior toolbar button and both templates categories.
+ */
 export declare class CynefinEstuarineViewExtension extends ViewExtensionProvider {
     name: string;
     effect(): void;