@formicoidea/labre-framework-edgy 0.31.0 → 0.33.0

package/dist/toolbar/config.d.ts

@@ -13,7 +13,40 @@ export declare const edgyToolbarConfig: {
         icon: TemplateResult;
         active(ctx: ToolbarContext): boolean;
         run(ctx: ToolbarContext): void;
+    }, {
+        id: string;
+        tooltip: string;
+        icon: TemplateResult;
+        active(ctx: ToolbarContext): boolean;
+        run(ctx: ToolbarContext): void;
+    }, {
+        id: string;
+        tooltip: string;
+        icon: TemplateResult<1>;
+        run(ctx: ToolbarContext): void;
     }];
     readonly when: (ctx: ToolbarContext) => boolean;
 };
 export declare const edgyToolbarExtension: import("@formicoidea/labre-core/store").ExtensionType;
+export declare const edgyBoardToolbarConfig: {
+    readonly actions: [{
+        id: string;
+        tooltip: string;
+        icon: TemplateResult;
+        active(ctx: ToolbarContext): boolean;
+        run(ctx: ToolbarContext): void;
+    }, {
+        id: string;
+        tooltip: string;
+        icon: TemplateResult;
+        active(ctx: ToolbarContext): boolean;
+        run(ctx: ToolbarContext): void;
+    }, {
+        id: string;
+        tooltip: string;
+        icon: TemplateResult<1>;
+        run(ctx: ToolbarContext): void;
+    }];
+    readonly when: (ctx: ToolbarContext) => boolean;
+};
+export declare const edgyBoardToolbarExtension: import("@formicoidea/labre-core/store").ExtensionType;

package/dist/toolbar/config.js

@@ -1,8 +1,10 @@
 import { EdgelessCRUDIdentifier } from '@formicoidea/labre-core/blocks/surface';
-import { EdgyFacetsElementModel } from '@formicoidea/labre-core/model';
-import { ToolbarModuleExtension, } from '@formicoidea/labre-core/shared/services';
+import { createAutoLegend, dddLegendIcon } from '@formicoidea/labre-ddd-shared';
+import { EdgyBoardElementModel, EdgyFacetsElementModel, } from '@formicoidea/labre-core/model';
+import { TelemetryProvider, ToolbarModuleExtension, } from '@formicoidea/labre-core/shared/services';
 import { BlockFlavourIdentifier } from '@formicoidea/labre-core/std';
 import { html } from 'lit';
+import { EDGY_AUTO_LEGEND } from '../legend.js';
 const ResizeIcon = html `<svg
   width="24"
   height="24"
@@ -30,37 +32,90 @@ const LabelsIcon = html `<svg
   <path d="M3 8.5l6-4.5 12 0 0 16-12 0-6-4.5z" />
   <circle cx="8" cy="12" r="1.4" />
 </svg>`;
+/** Spot with rays — enable / disable the hover spotlight. */
+const SpotlightIcon = html `<svg
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="1.6"
+  stroke-linecap="round"
+>
+  <circle cx="12" cy="12" r="3.4" />
+  <path
+    d="M12 4v2.5M12 17.5V20M4 12h2.5M17.5 12H20M6.3 6.3l1.8 1.8M15.9 15.9l1.7 1.7M17.7 6.3l-1.8 1.8M8.1 15.9l-1.7 1.7"
+  />
+</svg>`;
 /**
- * Build a toolbar toggle that flips a boolean flag on every selected facets
- * diagram: `active` reflects the current state, `run` flips it (with an undo
- * checkpoint).
+ * Build a toolbar toggle that flips a boolean flag on every selected element
+ * of the given class: `active` reflects the current state, `run` flips it
+ * (with an undo checkpoint).
  */
-function booleanToggle(id, tooltip, icon, prop) {
+function booleanToggle(Model, id, tooltip, icon, prop) {
+    const models = (ctx) => ctx.getSurfaceModelsByType(Model);
     return {
         id,
         tooltip,
         icon,
         active(ctx) {
-            const models = ctx.getSurfaceModelsByType(EdgyFacetsElementModel);
-            return models.length > 0 && models.every(model => model[prop]);
+            const all = models(ctx);
+            return all.length > 0 && all.every(model => model[prop]);
         },
         run(ctx) {
-            const models = ctx.getSurfaceModelsByType(EdgyFacetsElementModel);
-            if (!models.length)
+            const all = models(ctx);
+            if (!all.length)
                 return;
-            const enable = !models.every(model => model[prop]);
+            const enable = !all.every(model => model[prop]);
             ctx.std.store.captureSync();
             const crud = ctx.std.get(EdgelessCRUDIdentifier);
-            for (const model of models) {
-                crud.updateElement(model.id, { [prop]: enable });
+            for (const model of all) {
+                crud.updateElement(model.id, {
+                    [prop]: enable,
+                });
             }
         },
     };
 }
+/**
+ * The legend action, shared by the two EDGY backgrounds: both frame the same
+ * notation, so both answer the same question — "what is actually drawn here" —
+ * with the same table ({@link EDGY_AUTO_LEGEND}) and the same box.
+ *
+ * Registered ALWAYS-ON (`EdgyRenderViewExtension`) with the toggles it sits
+ * next to: a legend is real, editable elements written into the document, so
+ * generating one is authoring, not tooling a flag may take away
+ * (`docs/adr/0009`).
+ */
+function legendAction(Model, id) {
+    return {
+        id,
+        tooltip: 'Generate the legend (notation present)',
+        icon: dddLegendIcon,
+        run(ctx) {
+            const background = ctx.getSurfaceModelsByType(Model)[0];
+            if (!background)
+                return;
+            createAutoLegend(ctx.std, background, EDGY_AUTO_LEGEND);
+            ctx.std.getOptional(TelemetryProvider)?.track('FrameworkLegendCreated', {
+                // The WIRE value from `frameworks.ts` (`telemetryKey`), which for EDGY
+                // happens to be the module id itself. Same field set as Wardley's and
+                // the three DDD legend buttons, so the four are comparable.
+                framework: 'edgy',
+                element: 'legend',
+                page: 'whiteboard editor',
+                segment: 'element toolbar',
+                module: 'edgy toolbar',
+            });
+        },
+    };
+}
 export const edgyToolbarConfig = {
     actions: [
-        booleanToggle('a.toggle-resize', 'Enable / lock resizing', ResizeIcon, 'resizeEnabled'),
-        booleanToggle('b.toggle-labels', 'Show / hide facet labels', LabelsIcon, 'showLabels'),
+        booleanToggle(EdgyFacetsElementModel, 'a.toggle-resize', 'Enable / lock resizing', ResizeIcon, 'resizeEnabled'),
+        booleanToggle(EdgyFacetsElementModel, 'b.toggle-labels', 'Show / hide facet labels', LabelsIcon, 'showLabels'),
+        booleanToggle(EdgyFacetsElementModel, 'c.toggle-spotlight', 'Enable / disable hover spotlight', SpotlightIcon, 'spotlightEnabled'),
+        legendAction(EdgyFacetsElementModel, 'd.legend'),
     ],
     when: ctx => ctx.getSurfaceModelsByType(EdgyFacetsElementModel).length > 0,
 };
@@ -68,3 +123,15 @@ export const edgyToolbarExtension = ToolbarModuleExtension({
     id: BlockFlavourIdentifier('affine:surface:edgy'),
     config: edgyToolbarConfig,
 });
+export const edgyBoardToolbarConfig = {
+    actions: [
+        booleanToggle(EdgyBoardElementModel, 'a.toggle-resize', 'Enable / lock resizing', ResizeIcon, 'resizeEnabled'),
+        booleanToggle(EdgyBoardElementModel, 'b.toggle-spotlight', 'Enable / disable hover spotlight', SpotlightIcon, 'spotlightEnabled'),
+        legendAction(EdgyBoardElementModel, 'c.legend'),
+    ],
+    when: ctx => ctx.getSurfaceModelsByType(EdgyBoardElementModel).length > 0,
+};
+export const edgyBoardToolbarExtension = ToolbarModuleExtension({
+    id: BlockFlavourIdentifier('affine:surface:edgyBoard'),
+    config: edgyBoardToolbarConfig,
+});

package/dist/toolbar/edgy-menu.d.ts

@@ -1,30 +1,12 @@
 import { EmptyTool } from '@formicoidea/labre-core/gfx/pointer';
-import { LitElement } from 'lit';
-declare const EdgelessEdgyMenu_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 for the EDGY toolbox. Items create the facets
- * diagram (the on-click Venn) and the four base-element prefab shapes — all
- * native shapes so they stay editable.
+ * The popover above the toolbar for the EDGY toolbox. Since PF3 it declares
+ * nothing: {@link EdgelessCommandMenu} renders `edgyCommands` for the
+ * `senior-menu` surface, and the same seven artefacts are now reachable from
+ * Settings › Shortcuts, which never saw them before (`docs/adr/0008`).
  */
-export declare class EdgelessEdgyMenu extends EdgelessEdgyMenu_base {
-    static styles: import("lit").CSSResult;
+export declare class EdgelessEdgyMenu extends EdgelessCommandMenu {
+    protected owner: "edgy";
     type: typeof EmptyTool;
-    /** Create the Enterprise Design Facets diagram centred on the viewport. */
-    private _createFacets;
-    /** Add a native free-text label (Inter), used for the People node. */
-    private _addLabel;
-    private _group;
-    /** Shared props for an EDGY node shape. */
-    private _baseShapeProps;
-    /** Create a box base element (outcome / object / activity) with inner text. */
-    private _createBox;
-    /**
-     * Create the People base element: an (invisible) ellipse decorated with the
-     * person glyph by the renderer, plus a native text label below, grouped.
-     */
-    private _createPeople;
-    private _finish;
-    private _track;
-    render(): import("lit-html").TemplateResult<1>;
 }
-export {};

package/dist/toolbar/edgy-menu.js

@@ -1,194 +1,15 @@
-import { DefaultTool } from '@formicoidea/labre-core/blocks/surface';
-import { createGroupCommand } from '@formicoidea/labre-core/gfx/group';
 import { EmptyTool } from '@formicoidea/labre-core/gfx/pointer';
-import { FontFamily, ShapeStyle } from '@formicoidea/labre-core/model';
-import { TelemetryProvider } from '@formicoidea/labre-core/shared/services';
-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, REF_W } from '../consts.js';
-import { ACTIVITY_VERTICES, INNER_FONT_SIZE, LABEL_FONT_SIZE, LABEL_GAP, NODE_FILL, NODE_LABEL, NODE_SIZE, NODE_STROKE, NODE_STROKE_WIDTH, OUTCOME_RADIUS, } from '../node/consts.js';
-import { edgyActivityIcon, edgyFacetsIcon, edgyObjectIcon, edgyOutcomeIcon, edgyPeopleIcon, } from './icons.js';
-/** Default facets-diagram size (REF aspect, scaled up so it reads on canvas). */
-const FACETS_SCALE = 1.5;
-/** Height of the native People free-text label. */
-const LABEL_H = LABEL_FONT_SIZE + 8;
+import { EdgelessCommandMenu } from '@formicoidea/labre-core/widgets/edgeless-toolbar';
 /**
- * The popover above the toolbar for the EDGY toolbox. Items create the facets
- * diagram (the on-click Venn) and the four base-element prefab shapes — all
- * native shapes so they stay editable.
+ * The popover above the toolbar for the EDGY toolbox. Since PF3 it declares
+ * nothing: {@link EdgelessCommandMenu} renders `edgyCommands` for the
+ * `senior-menu` surface, and the same seven artefacts are now reachable from
+ * Settings › Shortcuts, which never saw them before (`docs/adr/0008`).
  */
-export class EdgelessEdgyMenu extends EdgelessToolbarToolMixin(LitElement) {
+export class EdgelessEdgyMenu extends EdgelessCommandMenu {
     constructor() {
         super(...arguments);
+        this.owner = 'edgy';
         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;
-    }
-  `; }
-    /** Create the Enterprise Design Facets diagram centred on the viewport. */
-    _createFacets() {
-        const { gfx } = this;
-        if (!gfx.surface)
-            return;
-        const width = REF_W * FACETS_SCALE;
-        const height = REF_H * FACETS_SCALE;
-        const { centerX, centerY } = gfx.viewport;
-        const id = gfx.surface.addElement({
-            type: 'edgy',
-            xywh: new Bound(centerX - width / 2, centerY - height / 2, width, height).serialize(),
-        });
-        this._track('facets');
-        this._finish(id);
-    }
-    /** Add a native free-text label (Inter), used for the People node. */
-    _addLabel(surface, text, x, y) {
-        return surface.addElement({
-            type: 'text',
-            text,
-            fontFamily: FontFamily.Inter,
-            fontSize: LABEL_FONT_SIZE,
-            color: NODE_STROKE,
-            textAlign: 'center',
-            xywh: new Bound(x, y, 120, LABEL_H).serialize(),
-        });
-    }
-    _group(ids) {
-        const [, result] = this.edgeless.std.command.exec(createGroupCommand, {
-            elements: ids,
-        });
-        return result.groupId || ids[0];
-    }
-    /** Shared props for an EDGY node shape. */
-    _baseShapeProps(kind) {
-        return {
-            type: 'edgyNode',
-            kind,
-            filled: true,
-            fillColor: NODE_FILL,
-            strokeColor: NODE_STROKE,
-            shapeStyle: ShapeStyle.General,
-            roughness: 0,
-        };
-    }
-    /** Create a box base element (outcome / object / activity) with inner text. */
-    _createBox(kind) {
-        const surface = this.gfx.surface;
-        if (!surface)
-            return;
-        const { w, h } = NODE_SIZE[kind];
-        const { centerX: cx, centerY: cy } = this.gfx.viewport;
-        const shapeType = kind === 'activity' ? 'polygon' : 'rect';
-        const id = surface.addElement({
-            ...this._baseShapeProps(kind),
-            shapeType,
-            strokeWidth: NODE_STROKE_WIDTH,
-            radius: kind === 'outcome' ? OUTCOME_RADIUS : 0,
-            vertices: kind === 'activity' ? ACTIVITY_VERTICES : null,
-            text: NODE_LABEL[kind],
-            color: NODE_STROKE,
-            fontFamily: FontFamily.Inter,
-            fontSize: INNER_FONT_SIZE,
-            textAlign: 'center',
-            xywh: new Bound(cx - w / 2, cy - h / 2, w, h).serialize(),
-        });
-        this._track(`node:${kind}`);
-        this._finish(id);
-    }
-    /**
-     * Create the People base element: an (invisible) ellipse decorated with the
-     * person glyph by the renderer, plus a native text label below, grouped.
-     */
-    _createPeople() {
-        const surface = this.gfx.surface;
-        if (!surface)
-            return;
-        const { w, h } = NODE_SIZE.people;
-        const { centerX: cx, centerY: cy } = this.gfx.viewport;
-        const nodeId = surface.addElement({
-            ...this._baseShapeProps('people'),
-            shapeType: 'ellipse',
-            // No visible outline — People is just the glyph; the ellipse is the bound.
-            strokeWidth: 0,
-            xywh: new Bound(cx - w / 2, cy - h / 2, w, h).serialize(),
-        });
-        const labelId = this._addLabel(surface, NODE_LABEL.people, cx - 60, cy + h / 2 + LABEL_GAP);
-        this._track('node:people');
-        this._finish(this._group([nodeId, labelId]));
-    }
-    _finish(id) {
-        const { gfx } = this;
-        gfx.doc.captureSync();
-        gfx.tool.setTool(DefaultTool);
-        gfx.selection.set({ elements: [id], editing: false });
-        // Keep the palette open (native sub-menu behaviour).
-    }
-    _track(element) {
-        this.edgeless.std.getOptional(TelemetryProvider)?.track('FrameworkElementAdded', {
-            framework: 'edgy',
-            element,
-            page: 'whiteboard editor',
-            segment: 'edgy toolbox',
-            module: 'edgy menu',
-        });
-    }
-    render() {
-        return html `
-      <edgeless-slide-menu>
-        <div class="menu-content">
-          <div class="button-group-container">
-            <edgeless-tool-icon-button
-              .tooltip=${'Enterprise Design facets'}
-              @click=${this._createFacets}
-            >
-              ${edgyFacetsIcon}
-            </edgeless-tool-icon-button>
-            <edgeless-tool-icon-button
-              .tooltip=${'People'}
-              @click=${this._createPeople}
-            >
-              ${edgyPeopleIcon}
-            </edgeless-tool-icon-button>
-            <edgeless-tool-icon-button
-              .tooltip=${'Outcome'}
-              @click=${() => this._createBox('outcome')}
-            >
-              ${edgyOutcomeIcon}
-            </edgeless-tool-icon-button>
-            <edgeless-tool-icon-button
-              .tooltip=${'Object'}
-              @click=${() => this._createBox('object')}
-            >
-              ${edgyObjectIcon}
-            </edgeless-tool-icon-button>
-            <edgeless-tool-icon-button
-              .tooltip=${'Activity'}
-              @click=${() => this._createBox('activity')}
-            >
-              ${edgyActivityIcon}
-            </edgeless-tool-icon-button>
-          </div>
-        </div>
-      </edgeless-slide-menu>
-    `;
-    }
 }

package/dist/toolbar/edgy-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';
@@ -44,7 +45,10 @@ export class EdgelessEdgySeniorButton extends EdgelessToolbarToolMixin(SignalWat
       translate: var(--active-x, 0) var(--active-y, 0);
       rotate: var(--active-r, -2deg);
       scale: var(--active-s, 1);
-      transition: transform 0.3s ease, translate 0.3s ease, rotate 0.3s ease,
+      transition:
+        transform 0.3s ease,
+        translate 0.3s ease,
+        rotate 0.3s ease,
         scale 0.3s ease;
     }
     .edgy-card svg {
@@ -71,7 +75,9 @@ export class EdgelessEdgySeniorButton extends EdgelessToolbarToolMixin(SignalWat
     render() {
         return html `<edgeless-toolbar-button
       class="edgy-button"
-      .tooltip=${this.popper ? '' : 'EDGY'}
+      .tooltip=${this.popper
+            ? ''
+            : translateKey(this.edgeless.std, 'com.labre.framework.edgy', 'EDGY')}
       .tooltipOffset=${4}
       .active=${!!this.popper}
       @click=${this._toggleMenu}

package/dist/toolbar/icons.d.ts

@@ -2,11 +2,23 @@
 export declare const edgyToolbarIcon: import("lit-html").TemplateResult<2>;
 /** Menu icon — the facets diagram (colored mini Venn). */
 export declare const edgyFacetsIcon: import("lit-html").TemplateResult<2>;
+/** Menu icon — the dynamic diagram: mini Venn + three connected white shapes. */
+export declare const edgyDynamicIcon: import("lit-html").TemplateResult<2>;
+/** Menu icon — the blank board: rounded rect + connected facet-colored shapes. */
+export declare const edgyBoardIcon: import("lit-html").TemplateResult<2>;
 /** People — person glyph (official Icon-People), uses currentColor. */
 export declare const edgyPeopleIcon: import("lit-html").TemplateResult<2>;
 /** Outcome — lightly rounded rectangle. */
 export declare const edgyOutcomeIcon: import("lit-html").TemplateResult<2>;
 /** Object — plain rectangle. */
 export declare const edgyObjectIcon: import("lit-html").TemplateResult<2>;
+/**
+ * Relation — a bare line between two ends, with the label riding on it.
+ *
+ * No arrowhead, exactly like the 24 relations of the metamodel template: EDGY
+ * draws its links as plain lines and lets the verb say which way the sentence
+ * runs. The little box in the middle IS the verb the tool writes there.
+ */
+export declare const edgyRelationIcon: import("lit-html").TemplateResult<2>;
 /** Activity — right-pointing chevron. */
 export declare const edgyActivityIcon: import("lit-html").TemplateResult<2>;

package/dist/toolbar/icons.js

@@ -13,6 +13,24 @@ export const edgyFacetsIcon = svg `<svg width="24" height="24" viewBox="0 0 24 2
   <circle cx="14.5" cy="10" r="6" fill="#034cee" opacity="0.92"/>
   <circle cx="12" cy="14.5" r="6" fill="#ff0056" opacity="0.92"/>
 </svg>`;
+/** Menu icon — the dynamic diagram: mini Venn + three connected white shapes. */
+export const edgyDynamicIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="9.5" cy="10" r="6" fill="#00ea4e" opacity="0.92"/>
+  <circle cx="14.5" cy="10" r="6" fill="#034cee" opacity="0.92"/>
+  <circle cx="12" cy="14.5" r="6" fill="#ff0056" opacity="0.92"/>
+  <path d="M8.5 8.5 L15.5 8.5 M8.5 8.5 L12 16 M15.5 8.5 L12 16" stroke="#fff" stroke-width="1.3"/>
+  <rect x="6.9" y="6.9" width="3.2" height="3.2" fill="#fff"/>
+  <circle cx="15.5" cy="8.5" r="1.7" fill="#fff"/>
+  <path d="M10.4 14.9 H12.9 L14 16 L12.9 17.1 H10.4 Z" fill="#fff"/>
+</svg>`;
+/** Menu icon — the blank board: rounded rect + connected facet-colored shapes. */
+export const edgyBoardIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="3" y="4.5" width="18" height="15" rx="2.5" stroke="currentColor" stroke-width="1.4"/>
+  <path d="M8.3 9 L15.7 9 M8.3 9 L12 15.2 M15.7 9 L12 15.2" stroke="currentColor" stroke-width="1.1"/>
+  <rect x="6.8" y="7.5" width="3" height="3" fill="#00ea4e"/>
+  <circle cx="15.7" cy="9" r="1.7" fill="#034cee"/>
+  <path d="M10.5 14.1 H12.8 L13.9 15.2 L12.8 16.3 H10.5 Z" fill="#ff0056"/>
+</svg>`;
 /** People — person glyph (official Icon-People), uses currentColor. */
 export const edgyPeopleIcon = svg `<svg width="24" height="24" viewBox="0 0 32 32" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
   <path d="m16,19c-3.308,0-6-2.692-6-6v-4c0-3.308,2.692-6,6-6s6,2.692,6,6v4c0,3.308-2.692,6-6,6Zm0-14c-2.206,0-4,1.794-4,4v4c0,2.206,1.794,4,4,4s4-1.794,4-4v-4c0-2.206-1.794-4-4-4Z"/>
@@ -26,6 +44,19 @@ export const edgyOutcomeIcon = svg `<svg width="24" height="24" viewBox="0 0 24
 export const edgyObjectIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <rect x="3.5" y="6.5" width="17" height="11" stroke="currentColor" stroke-width="1.6"/>
 </svg>`;
+/**
+ * Relation — a bare line between two ends, with the label riding on it.
+ *
+ * No arrowhead, exactly like the 24 relations of the metamodel template: EDGY
+ * draws its links as plain lines and lets the verb say which way the sentence
+ * runs. The little box in the middle IS the verb the tool writes there.
+ */
+export const edgyRelationIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M3.5 12 H20.5" stroke="currentColor" stroke-width="1.6"/>
+  <circle cx="3.8" cy="12" r="1.6" fill="currentColor"/>
+  <circle cx="20.2" cy="12" r="1.6" fill="currentColor"/>
+  <rect x="8" y="8.6" width="8" height="6.8" rx="1.4" fill="var(--affine-background-primary-color, #fff)" stroke="currentColor" stroke-width="1.4"/>
+</svg>`;
 /** Activity — right-pointing chevron. */
 export const edgyActivityIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <path d="M3.5 6.5 H15 L20.5 12 L15 17.5 H3.5 Z" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>

package/dist/toolbar/senior-tool.js

@@ -3,6 +3,7 @@ import { html } from 'lit';
 export const edgySeniorTool = SeniorToolExtension('edgy', ({ block }) => {
     return {
         name: 'EDGY',
+        labelKey: 'com.labre.framework.edgy',
         content: html `<edgeless-edgy-senior-button
       .edgeless=${block}
     ></edgeless-edgy-senior-button>`,

package/dist/translations.d.ts

@@ -0,0 +1,24 @@
+import { type TranslationKeyManifestEntry } from '@formicoidea/labre-core/std';
+/**
+ * THIS framework's contribution to the translation-key manifest — every
+ * `com.labre.*` key EDGY can hand to `TranslationProvider.t`, derived from the
+ * very declarations the editor registers.
+ *
+ * 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 same now holds for
+ * the roles: one key per canonical verb, derived from the metamodel, so a
+ * relation added there contributes its keys without anybody editing this file.
+ *
+ * That derivation is why the hand-drawn relation tool needed no line here: its
+ * `com.labre.commands.edgy.addRelation` and the `.description` key that carries
+ * its gesture sentence — the first DESCRIPTION any EDGY command has declared —
+ * are collected off `edgyCommands` with their English fallbacks, like every
+ * label before them.
+ *
+ * The contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-edgy` carries it, and a host
+ * composes it into its catalogue exactly as it already composes `edgyCommands`
+ * into the command registry. See `packages/affine/all/src/translations.ts`.
+ */
+export declare const edgyTranslationEntries: TranslationKeyManifestEntry[];

package/dist/translations.js

@@ -0,0 +1,29 @@
+import { collectTranslationKeys, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
+import { edgyCommands } from './commands.js';
+import { EDGY_NUDGES } from './nudges.js';
+import { EDGY_PROFILES } from './profiles.js';
+import { EDGY_ROLES } from './roles.js';
+import { EDGY_RULES } from './rules.js';
+/**
+ * THIS framework's contribution to the translation-key manifest — every
+ * `com.labre.*` key EDGY can hand to `TranslationProvider.t`, derived from the
+ * very declarations the editor registers.
+ *
+ * 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 same now holds for
+ * the roles: one key per canonical verb, derived from the metamodel, so a
+ * relation added there contributes its keys without anybody editing this file.
+ *
+ * That derivation is why the hand-drawn relation tool needed no line here: its
+ * `com.labre.commands.edgy.addRelation` and the `.description` key that carries
+ * its gesture sentence — the first DESCRIPTION any EDGY command has declared —
+ * are collected off `edgyCommands` with their English fallbacks, like every
+ * label before them.
+ *
+ * The contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-edgy` carries it, and a host
+ * composes it into its catalogue exactly as it already composes `edgyCommands`
+ * into the command registry. See `packages/affine/all/src/translations.ts`.
+ */
+export const edgyTranslationEntries = mergeTranslationEntries(commandTranslationEntries(edgyCommands), collectTranslationKeys('role', EDGY_ROLES), collectTranslationKeys('rule', EDGY_RULES), collectTranslationKeys('nudge', EDGY_NUDGES), collectTranslationKeys('profile', EDGY_PROFILES));

package/dist/view.d.ts

@@ -1,4 +1,22 @@
 import { type ViewExtensionContext, ViewExtensionProvider } from '@formicoidea/labre-core/ext-loader';
+/**
+ * EDGY rendering — ALWAYS registered, independent of any flag. Disabling `edgy`
+ * hides only the creation tooling (see {@link EdgyViewExtension}); boards and
+ * facets already drawn must still paint, stay selectable, stay editable, keep
+ * their contextual toolbar and keep the dependency spotlight. See
+ * `docs/adr/0009`.
+ */
+export declare class EdgyRenderViewExtension extends ViewExtensionProvider {
+    name: string;
+    setup(context: ViewExtensionContext): void;
+}
+/**
+ * EDGY creation tooling — flag-gated (`edgy`): the senior toolbar button, its
+ * templates category, and the validation rules, profiles and quality checklist.
+ * All of it is tooling: a board drawn while the flag was on keeps rendering when
+ * it goes off, it just stops being checked — and the profile it was put on stays
+ * written, unread, until the flag comes back (`docs/adr/0009`).
+ */
 export declare class EdgyViewExtension extends ViewExtensionProvider {
     name: string;
     effect(): void;