@formicoidea/labre-framework-cynefin 0.23.1 → 0.23.2

package/src/estuarine/element-renderer.ts

@@ -0,0 +1,122 @@
+import {
+  type ElementRenderer,
+  ElementRendererExtension,
+} from '@formicoidea/labre-core/blocks/surface';
+import type { EstuarineElementModel } from '@formicoidea/labre-core/model';
+
+import { FONT_FAMILY, refScale } from '../utils';
+import {
+  ARROWHEADS,
+  AXIS_LABELS,
+  AXIS_WIDTH,
+  COLORS,
+  COUNTERFACTUAL_PATH,
+  COUNTERFACTUAL_WIDTH,
+  E_AXIS,
+  LABEL_LETTER_SPACING,
+  LABELS,
+  LIMINAL_PATH,
+  LIMINAL_WIDTH,
+  REF_H,
+  REF_W,
+  T_AXIS,
+  VOLATILE_PATH,
+  VOLATILE_WIDTH,
+} from './consts';
+
+/**
+ * Canvas renderer for the Estuarine framework map — reproduces the official SVG:
+ * the e (vertical, double-headed) / t (horizontal, single-headed) axes and the
+ * three reference curves (Liminal / Volatile / Counter-factual), each with its
+ * legend and individually hideable. Drawn in the fixed reference space and
+ * scaled uniformly to the element bounds.
+ */
+export const estuarine: ElementRenderer<EstuarineElementModel> = (
+  model,
+  ctx,
+  matrix
+) => {
+  const [, , w, h] = model.deserializedXYWH;
+  const cx = w / 2;
+  const cy = h / 2;
+  ctx.setTransform(
+    matrix.translateSelf(cx, cy).rotateSelf(model.rotate).translateSelf(-cx, -cy)
+  );
+
+  const { s, ox, oy } = refScale(w, h, REF_W, REF_H);
+  ctx.translate(ox, oy);
+  ctx.scale(s, s);
+
+  ctx.lineCap = 'round';
+  ctx.lineJoin = 'round';
+
+  // ── Axes ────────────────────────────────────────────────────────────
+  ctx.strokeStyle = COLORS.axis;
+  ctx.fillStyle = COLORS.axis;
+  ctx.lineWidth = AXIS_WIDTH;
+  ctx.beginPath();
+  ctx.moveTo(E_AXIS.x, E_AXIS.y1);
+  ctx.lineTo(E_AXIS.x, E_AXIS.y2);
+  ctx.moveTo(T_AXIS.x1, T_AXIS.y);
+  ctx.lineTo(T_AXIS.x2, T_AXIS.y);
+  ctx.stroke();
+  for (const [[tx, ty], [ax, ay], [bx, by]] of ARROWHEADS) {
+    ctx.beginPath();
+    ctx.moveTo(tx, ty);
+    ctx.lineTo(ax, ay);
+    ctx.lineTo(bx, by);
+    ctx.closePath();
+    ctx.fill();
+  }
+
+  // Uppercase legend (centre-anchored, alphabetic baseline, letter-spaced).
+  const hasSpacing = 'letterSpacing' in ctx;
+  const legend = (l: { text: string; x: number; y: number; size: number; color: string }) => {
+    ctx.fillStyle = l.color;
+    ctx.font = `600 ${l.size}px ${FONT_FAMILY}`;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'alphabetic';
+    if (hasSpacing) ctx.letterSpacing = `${LABEL_LETTER_SPACING}px`;
+    ctx.fillText(l.text, l.x, l.y);
+    if (hasSpacing) ctx.letterSpacing = '0px';
+  };
+
+  // ── Liminal (green) ─────────────────────────────────────────────────
+  if (model.showLiminal) {
+    ctx.strokeStyle = COLORS.liminal;
+    ctx.lineWidth = LIMINAL_WIDTH;
+    ctx.stroke(new Path2D(LIMINAL_PATH));
+    legend(LABELS.liminal);
+  }
+
+  // ── Volatile (red) ──────────────────────────────────────────────────
+  if (model.showVolatile) {
+    ctx.strokeStyle = COLORS.volatile;
+    ctx.lineWidth = VOLATILE_WIDTH;
+    ctx.stroke(new Path2D(VOLATILE_PATH));
+    legend(LABELS.volatile);
+  }
+
+  // ── Counter-factual (dark) ──────────────────────────────────────────
+  if (model.showCounterfactual) {
+    ctx.strokeStyle = COLORS.counterfactual;
+    ctx.lineWidth = COUNTERFACTUAL_WIDTH;
+    ctx.stroke(new Path2D(COUNTERFACTUAL_PATH));
+    legend(LABELS.counterfactual);
+  }
+
+  // ── Italic e / t axis letters ───────────────────────────────────────
+  if (model.showAxisLabels) {
+    ctx.fillStyle = COLORS.axisLabel;
+    ctx.font = `italic 700 ${AXIS_LABELS.size}px Georgia, serif`;
+    ctx.textAlign = 'left';
+    ctx.textBaseline = 'alphabetic';
+    ctx.fillText(AXIS_LABELS.e.text, AXIS_LABELS.e.x, AXIS_LABELS.e.y);
+    ctx.fillText(AXIS_LABELS.t.text, AXIS_LABELS.t.x, AXIS_LABELS.t.y);
+  }
+};
+
+export const EstuarineRendererExtension = ElementRendererExtension(
+  'estuarine',
+  estuarine
+);

package/src/estuarine/element-view.ts

@@ -0,0 +1,32 @@
+import type { EstuarineElementModel } from '@formicoidea/labre-core/model';
+import {
+  GfxElementModelView,
+  GfxViewInteractionExtension,
+} from '@formicoidea/labre-core/std/gfx';
+
+/**
+ * View for the Estuarine background. Registering it ensures `gfx.view.get(model)`
+ * returns a view (required so move / select interactions work).
+ */
+export class EstuarineView extends GfxElementModelView<EstuarineElementModel> {
+  static override type: string = 'estuarine';
+}
+
+/**
+ * Resize gating: the resize handles are hidden unless `model.resizeEnabled` is
+ * true (toggled from the toolbar). Moving / selecting stays available.
+ */
+export const EstuarineInteraction = GfxViewInteractionExtension<EstuarineView>(
+  EstuarineView.type,
+  {
+    handleResize({ model }) {
+      return {
+        beforeResize({ set }) {
+          if (!model.resizeEnabled) {
+            set({ allowedHandlers: [] });
+          }
+        },
+      };
+    },
+  }
+);

package/src/estuarine/toolbar/config.ts

@@ -0,0 +1,65 @@
+import { EdgelessCRUDIdentifier } from '@formicoidea/labre-core/blocks/surface';
+import { EstuarineElementModel } from '@formicoidea/labre-core/model';
+import {
+  type ToolbarContext,
+  type ToolbarModuleConfig,
+  ToolbarModuleExtension,
+} from '@formicoidea/labre-core/shared/services';
+import { BlockFlavourIdentifier } from '@formicoidea/labre-core/std';
+import { html, type TemplateResult } 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>`;
+// 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>`;
+
+type EstuarineToggleProp =
+  | 'resizeEnabled'
+  | 'showLiminal'
+  | 'showVolatile'
+  | 'showCounterfactual'
+  | 'showAxisLabels';
+
+function booleanToggle(
+  id: string,
+  tooltip: string,
+  icon: TemplateResult,
+  prop: EstuarineToggleProp
+) {
+  return {
+    id,
+    tooltip,
+    icon,
+    active(ctx: ToolbarContext) {
+      const models = ctx.getSurfaceModelsByType(EstuarineElementModel);
+      return models.length > 0 && models.every(model => model[prop]);
+    },
+    run(ctx: ToolbarContext) {
+      const models = ctx.getSurfaceModelsByType(EstuarineElementModel);
+      if (!models.length) return;
+      const enable = !models.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 });
+    },
+  };
+}
+
+export const estuarineToolbarConfig = {
+  actions: [
+    booleanToggle('a.toggle-resize', 'Enable / lock resizing', 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'),
+    booleanToggle('e.toggle-axis-labels', 'Show / hide axis labels (e / t)', AxisIcon, 'showAxisLabels'),
+  ],
+  when: ctx => ctx.getSurfaceModelsByType(EstuarineElementModel).length > 0,
+} as const satisfies ToolbarModuleConfig;
+
+export const estuarineToolbarExtension = ToolbarModuleExtension({
+  id: BlockFlavourIdentifier('affine:surface:estuarine'),
+  config: estuarineToolbarConfig,
+});

package/src/index.ts

@@ -0,0 +1 @@
+export {};

package/src/templates/index.ts

@@ -0,0 +1,130 @@
+import {
+  makeTemplateSnapshot,
+  type SurfaceElementsJSON,
+  surfaceText,
+  type Template,
+  type TemplateCategory,
+} from '@formicoidea/labre-core/gfx/template';
+import { FontFamily, ShapeStyle, TextAlign } from '@formicoidea/labre-core/model';
+
+import { REF_H as CYN_H, REF_W as CYN_W } from '../cynefin/consts';
+import { REF_H as EST_H, REF_W as EST_W } from '../estuarine/consts';
+
+const HEX_SIZE = 60;
+const HEX_FILL = '#34c724';
+const HEX_STROKE = '#1f1f1f';
+const HEX_VERTICES = [
+  [1, 0.5],
+  [0.75, 0.933],
+  [0.25, 0.933],
+  [0, 0.5],
+  [0.25, 0.067],
+  [0.75, 0.067],
+];
+
+function sticky(x: number, y: number, text: string) {
+  return {
+    type: 'shape',
+    shapeType: 'rect',
+    filled: true,
+    fillColor: '#fff3b0',
+    strokeColor: '#d9b740',
+    strokeWidth: 1.5,
+    shapeStyle: ShapeStyle.General,
+    roughness: 0,
+    radius: 8,
+    text: surfaceText(text),
+    color: '#1a1a1a',
+    fontFamily: FontFamily.Inter,
+    fontSize: 18,
+    textAlign: TextAlign.Center,
+    xywh: `[${x},${y},200,70]`,
+  };
+}
+
+function hexagon(x: number, y: number) {
+  return {
+    type: 'shape',
+    shapeType: 'polygon',
+    vertices: HEX_VERTICES,
+    filled: true,
+    fillColor: HEX_FILL,
+    strokeColor: HEX_STROKE,
+    strokeWidth: 2,
+    shapeStyle: ShapeStyle.General,
+    roughness: 0,
+    xywh: `[${x},${y},${HEX_SIZE},${HEX_SIZE}]`,
+  };
+}
+
+function caption(x: number, y: number, str: string) {
+  return {
+    type: 'text',
+    text: surfaceText(str),
+    color: '#1a1a1a',
+    fontFamily: FontFamily.Inter,
+    fontSize: 16,
+    textAlign: TextAlign.Center,
+    xywh: `[${x},${y},120,24]`,
+  };
+}
+
+function tpl(name: string, preview: string, elements: SurfaceElementsJSON): Template {
+  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"';
+
+const cynefinBg = (xywh: string) => ({ type: 'cynefin', xywh });
+const estuarineBg = (xywh: string) => ({ type: 'estuarine', xywh });
+
+export const cynefinTemplateCategory: TemplateCategory = {
+  name: 'Cynefin',
+  templates: [
+    tpl(
+      'Decision sorting',
+      `<svg ${ATTRS} fill="none"><rect x="8" y="10" width="119" height="60" rx="4" stroke="#2a9d99" stroke-width="1.5"/><path d="M67 10 V70 M8 40 H127" stroke="#9aa0a6"/><rect x="18" y="18" width="34" height="14" rx="2" fill="#fff3b0"/><rect x="83" y="18" width="34" height="14" rx="2" fill="#fff3b0"/><rect x="18" y="48" width="34" height="14" rx="2" fill="#fff3b0"/><rect x="83" y="48" width="34" height="14" rx="2" fill="#fff3b0"/></svg>`,
+      {
+        bg: cynefinBg(`[0,0,${CYN_W},${CYN_H}]`),
+        s1: sticky(190, 175, 'Probe & learn'),
+        s2: sticky(690, 175, 'Expert analysis'),
+        s3: sticky(190, 505, 'Act now'),
+        s4: sticky(690, 505, 'Known issue'),
+      }
+    ),
+    tpl(
+      'Cynefin framework',
+      `<svg ${ATTRS} fill="none"><rect x="14" y="12" width="107" height="56" rx="4" stroke="#2a9d99" stroke-width="1.6"/><path d="M67 12 V68 M14 40 H121" stroke="#9aa0a6"/></svg>`,
+      { bg: cynefinBg(`[0,0,${CYN_W},${CYN_H}]`) }
+    ),
+  ],
+};
+
+export const estuarineTemplateCategory: TemplateCategory = {
+  name: 'Estuarine',
+  templates: [
+    tpl(
+      'Constraint map',
+      `<svg ${ATTRS} fill="none"><path d="M20 12 V70 M20 70 H120" stroke="#941253" stroke-width="2"/><g fill="#34c724" stroke="#1f1f1f"><path d="M44 28 l6 4 l0 8 l-6 4 l-6 -4 l0 -8 z"/><path d="M74 40 l6 4 l0 8 l-6 4 l-6 -4 l0 -8 z"/><path d="M56 52 l6 4 l0 8 l-6 4 l-6 -4 l0 -8 z"/></g></svg>`,
+      {
+        bg: estuarineBg(`[0,0,${EST_W},${EST_H}]`),
+        h1: hexagon(150, 220),
+        c1: caption(120, 284, 'Policy'),
+        h2: hexagon(330, 360),
+        c2: caption(300, 424, 'Habit'),
+        h3: hexagon(230, 520),
+        c3: caption(200, 584, 'Budget'),
+      }
+    ),
+    tpl(
+      'Estuarine map',
+      `<svg ${ATTRS} fill="none"><path d="M24 10 V70 M24 70 H120" stroke="#941253" stroke-width="2.4"/><path d="M30 52 q40 -30 84 -34" stroke="#5ecc44" stroke-width="2" fill="none"/></svg>`,
+      { bg: estuarineBg(`[0,0,${EST_W},${EST_H}]`) }
+    ),
+    tpl(
+      'Hexagon constraint',
+      `<svg ${ATTRS} fill="none"><path d="M67 24 l18 11 l0 22 l-18 11 l-18 -11 l0 -22 z" fill="#34c724" stroke="#1f1f1f" stroke-width="2"/></svg>`,
+      { hex: hexagon(0, 0) }
+    ),
+  ],
+};

package/{dist/toolbar/icons.js → src/toolbar/icons.ts}

@@ -1,27 +1,30 @@
-import { svg } from 'lit';
-/** Colored Cynefin glyph for the main toolbar button. */
-export const cynefinToolbarIcon = svg `<svg width="100%" height="100%" viewBox="0 0 56 56" fill="none" xmlns="http://www.w3.org/2000/svg">
+import { svg } from 'lit';
+
+/** Colored Cynefin glyph for the main toolbar button. */
+export const cynefinToolbarIcon = svg`<svg width="100%" height="100%" viewBox="0 0 56 56" fill="none" xmlns="http://www.w3.org/2000/svg">
   <g stroke="#3f444a" stroke-width="3" stroke-linecap="round">
     <path d="M30 8 C28 18 33 24 26 30 C20 35 14 33 9 33"/>
     <path d="M26 30 C28 40 28 46 28 50"/>
     <path d="M34 22 C40 23 46 24 50 25" stroke-dasharray="3 3"/>
   </g>
   <g stroke="#3f444a" stroke-width="1.4"><path d="M22 33 l-2 4M24 38 l-2 5M26 43 l-2 5"/></g>
-</svg>`;
-/** Menu icon — create the Cynefin diagram. */
-export const cynefinMenuIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+</svg>`;
+
+/** Menu icon — create the Cynefin diagram. */
+export const cynefinMenuIcon = svg`<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <path d="M13 3 C12 8 14 11 11 13 C8 15 5 14 3 14" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
   <path d="M11 13 C12 18 12 20 12 22" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
   <path d="M15 10 C18 10.5 20 11 22 11.5" stroke="currentColor" stroke-width="1.6" stroke-dasharray="2.5 2.5" stroke-linecap="round"/>
-</svg>`;
-/** Menu icon — create the Estuarine map. */
-export const estuarineMenuIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+</svg>`;
+
+/** Menu icon — create the Estuarine map. */
+export const estuarineMenuIcon = svg`<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <path d="M5 3 V20 M5 17 H21" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
   <path d="M3 6 l2-2 2 2 M3 17 l2 2 2 -2 M18 15 l3 2 -3 2" stroke="currentColor" stroke-width="1.4" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
   <path d="M6 10 C11 6 14 13 21 9" stroke="currentColor" stroke-width="1.4" fill="none" stroke-linecap="round"/>
-</svg>`;
-/** Menu icon — hexagon constraint node. */
-export const hexagonMenuIcon = svg `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+</svg>`;
+
+/** Menu icon — hexagon constraint node. */
+export const hexagonMenuIcon = svg`<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
   <polygon points="21,12 16.5,19.8 7.5,19.8 3,12 7.5,4.2 16.5,4.2" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/>
-</svg>`;
-//# sourceMappingURL=icons.js.map
+</svg>`;