@formicoidea/labre-framework-wardley 0.23.2 → 0.23.3

package/src/legend.ts

@@ -1,438 +0,0 @@
-import { createGroupCommand } from '@formicoidea/labre-core/gfx/group';
-import {
-  ConnectorElementModel,
-  ConnectorMode,
-  FontFamily,
-  PointStyle,
-  ShapeElementModel,
-  ShapeStyle,
-  StrokeStyle,
-  type WardleyBackgroundElementModel,
-  WardleyNodeElementModel,
-} from '@formicoidea/labre-core/model';
-import { Bound } from '@formicoidea/labre-core/global/gfx';
-import type { BlockStdScope } from '@formicoidea/labre-core/std';
-import { GfxControllerIdentifier } from '@formicoidea/labre-core/std/gfx';
-
-import { GRADIENT_GREEN, GRADIENT_RED } from './gradient';
-import {
-  INERTIA_COLOR,
-  LINK_GREY,
-  LINK_STROKE_WIDTH,
-  MARKET_DOT_STROKE_WIDTH,
-  MARKET_LINK_COLOR,
-  MARKET_LINK_WIDTH,
-  METHOD_FILL,
-  NODE_FILL,
-  NODE_STROKE,
-  NODE_STROKE_WIDTH,
-  PIPELINE_FILL,
-  WARDLEY_RED,
-} from './node/consts';
-
-/** Component kinds the legend can describe, in display order. */
-type LegendType =
-  | 'component'
-  | 'anchor'
-  | 'market'
-  | 'ecosystem'
-  | 'method'
-  | 'pipeline'
-  | 'link'
-  | 'arrow'
-  | 'inertia';
-
-const LEGEND_ORDER: LegendType[] = [
-  'component',
-  'anchor',
-  'market',
-  'ecosystem',
-  'method',
-  'pipeline',
-  'link',
-  'arrow',
-  'inertia',
-];
-
-/** Default (editable) descriptions for each legend row. */
-const LEGEND_DESC: Record<LegendType, string> = {
-  component: 'Need / capability (activity, practice, data…)',
-  anchor: 'Stakeholder (customer, user…)',
-  market: 'Market (set of actors)',
-  ecosystem: 'Ecosystem',
-  method: 'Component + method (color = phase)',
-  pipeline: 'Pipeline (possible choices for a capability)',
-  link: 'Need relation (parent → child)',
-  arrow: 'Evolution / movement (red = future)',
-  inertia: 'Inertia to change',
-};
-
-type GradientVariant = Exclude<WardleyBackgroundElementModel['variant'], 'classic'>;
-
-/** Gradient-meaning block, keyed by variant (caption + 2-colour swatch). */
-const LEGEND_GRADIENT: Record<
-  GradientVariant,
-  { caption: string; swatch: [string, string] }
-> = {
-  opportunity: {
-    caption:
-      'Opportunity gradient: differential value (green) vs operational value (red).',
-    swatch: [GRADIENT_GREEN, GRADIENT_RED],
-  },
-  benefit: {
-    caption: 'Gradient: investment (red) then benefit (green).',
-    swatch: [GRADIENT_RED, GRADIENT_GREEN],
-  },
-  'evolution-gradient': {
-    caption:
-      "Gradient representing the growth of Wardley's evolution function.",
-    swatch: ['#9aa0a6', '#cfd2d6'],
-  },
-};
-
-/**
- * Build a "Legend" group from real, editable elements (white rect frame +
- * "Legend" text + one row of [real component glyph + description text] per
- * Wardley component TYPE present inside the background's perimeter + a
- * gradient-meaning block when the background is a gradient variant). A snapshot
- * is created on each call; everything is grouped so it can be moved / resized /
- * edited and is dropped bottom-left of the background.
- */
-export function createWardleyLegend(
-  std: BlockStdScope,
-  bg: WardleyBackgroundElementModel
-) {
-  const gfx = std.get(GfxControllerIdentifier);
-  const surface = gfx.surface;
-  if (!surface) return;
-
-  const [bx, by, , bh] = bg.deserializedXYWH;
-
-  // 1. Detect which component types are present inside the perimeter.
-  const present = new Set<LegendType>();
-  for (const el of gfx.getElementsByBound(Bound.deserialize(bg.xywh), {
-    type: 'canvas',
-  })) {
-    // Note: WardleyNodeElementModel extends ShapeElementModel, so the order of
-    // these instanceof checks matters.
-    if (el instanceof WardleyNodeElementModel) {
-      if (el.kind !== 'handle') present.add(el.kind);
-    } else if (el instanceof ConnectorElementModel) {
-      if (el.strokeStyle === StrokeStyle.Dash || el.stroke === WARDLEY_RED) {
-        present.add('arrow');
-      } else if (el.stroke === LINK_GREY) {
-        present.add('link');
-      }
-      // market triangle connectors (NODE_STROKE) are ignored.
-    } else if (el instanceof ShapeElementModel) {
-      if (el.fillColor === INERTIA_COLOR) present.add('inertia');
-    }
-  }
-  const rows = LEGEND_ORDER.filter(t => present.has(t));
-
-  // 2. Layout (model units). The text column is wide enough for one-line
-  // descriptions; the gradient row is taller as its caption may wrap.
-  const PAD = 16;
-  const TITLE_H = 28;
-  const ROW_H = 30;
-  const GLYPH_W = 46;
-  const GAP = 12;
-  const TEXT_FS = 15;
-  const TITLE_FS = 18;
-  const TEXT_W = 360;
-  const GRAD_ROW_H = 40;
-  const W = PAD * 2 + GLYPH_W + GAP + TEXT_W;
-
-  const variant = bg.variant;
-  const grad = variant !== 'classic' ? LEGEND_GRADIENT[variant] : null;
-  const gradH = grad ? 12 + GRAD_ROW_H : 0;
-  const H = PAD * 2 + TITLE_H + rows.length * ROW_H + gradH;
-
-  const x0 = bx + 50;
-  const y0 = by + bh - 56 - H;
-
-  const text = (
-    t: string,
-    x: number,
-    y: number,
-    w: number,
-    h: number,
-    fontSize: number,
-    align: 'left' | 'center' = 'left'
-  ) =>
-    surface.addElement({
-      type: 'text',
-      text: t,
-      fontFamily: FontFamily.Inter,
-      fontSize,
-      color: NODE_STROKE,
-      textAlign: align,
-      xywh: new Bound(x, y, w, h).serialize(),
-    });
-
-  // ── glyph builders (real, editable elements), centred on (cx, cy) ─────
-  const ellipse = (
-    kind: 'component' | 'anchor' | 'ecosystem' | 'method',
-    d: number,
-    fill: string,
-    sw: number,
-    cx: number,
-    cy: number
-  ) =>
-    surface.addElement({
-      type: 'wardleyNode',
-      kind,
-      shapeType: 'ellipse',
-      filled: true,
-      fillColor: fill,
-      strokeColor: NODE_STROKE,
-      strokeWidth: sw,
-      shapeStyle: ShapeStyle.General,
-      roughness: 0,
-      xywh: new Bound(cx - d / 2, cy - d / 2, d, d).serialize(),
-    });
-
-  const glyph = (type: LegendType, cx: number, cy: number): string[] => {
-    switch (type) {
-      case 'component':
-        return [ellipse('component', 16, NODE_FILL, NODE_STROKE_WIDTH, cx, cy)];
-      case 'anchor':
-        return [ellipse('anchor', 16, NODE_FILL, NODE_STROKE_WIDTH, cx, cy)];
-      case 'ecosystem':
-        return [ellipse('ecosystem', 20, NODE_FILL, NODE_STROKE_WIDTH, cx, cy)];
-      case 'method':
-        return [ellipse('method', 18, METHOD_FILL, NODE_STROKE_WIDTH, cx, cy)];
-      case 'inertia':
-        return [
-          surface.addElement({
-            type: 'shape',
-            shapeType: 'rect',
-            filled: true,
-            fillColor: INERTIA_COLOR,
-            strokeColor: INERTIA_COLOR,
-            strokeWidth: 0,
-            shapeStyle: ShapeStyle.General,
-            roughness: 0,
-            radius: 0,
-            xywh: new Bound(cx - 2.5, cy - 11, 5, 22).serialize(),
-          }),
-        ];
-      case 'pipeline': {
-        const bw2 = 34;
-        const bh2 = 12;
-        const hd = 10;
-        const top = cy - bh2 / 2;
-        return [
-          surface.addElement({
-            type: 'wardleyNode',
-            kind: 'pipeline',
-            shapeType: 'rect',
-            filled: true,
-            fillColor: PIPELINE_FILL,
-            strokeColor: NODE_STROKE,
-            strokeWidth: NODE_STROKE_WIDTH,
-            shapeStyle: ShapeStyle.General,
-            roughness: 0,
-            radius: 0,
-            xywh: new Bound(cx - bw2 / 2, top, bw2, bh2).serialize(),
-          }),
-          surface.addElement({
-            type: 'wardleyNode',
-            kind: 'handle',
-            shapeType: 'rect',
-            filled: true,
-            fillColor: NODE_FILL,
-            strokeColor: NODE_STROKE,
-            strokeWidth: NODE_STROKE_WIDTH,
-            shapeStyle: ShapeStyle.General,
-            roughness: 0,
-            radius: 0,
-            xywh: new Bound(cx - hd / 2, top - hd / 2, hd, hd).serialize(),
-          }),
-        ];
-      }
-      case 'market': {
-        const R = 11;
-        const dr = 3;
-        const rho = 6;
-        const sin60 = Math.sqrt(3) / 2;
-        const circle = surface.addElement({
-          type: 'wardleyNode',
-          kind: 'market',
-          shapeType: 'ellipse',
-          filled: true,
-          fillColor: NODE_FILL,
-          strokeColor: NODE_STROKE,
-          strokeWidth: NODE_STROKE_WIDTH,
-          shapeStyle: ShapeStyle.General,
-          roughness: 0,
-          xywh: new Bound(cx - R, cy - R, R * 2, R * 2).serialize(),
-        });
-        const verts = [
-          [0, -rho],
-          [rho * sin60, rho / 2],
-          [-rho * sin60, rho / 2],
-        ];
-        const dots = verts.map(([vx, vy]) =>
-          surface.addElement({
-            type: 'wardleyNode',
-            kind: 'component',
-            shapeType: 'ellipse',
-            filled: true,
-            fillColor: NODE_FILL,
-            strokeColor: NODE_STROKE,
-            strokeWidth: MARKET_DOT_STROKE_WIDTH,
-            shapeStyle: ShapeStyle.General,
-            roughness: 0,
-            xywh: new Bound(cx + vx - dr, cy + vy - dr, dr * 2, dr * 2).serialize(),
-          })
-        );
-        const conns = [
-          [dots[0], dots[1]],
-          [dots[1], dots[2]],
-          [dots[2], dots[0]],
-        ].map(([a, b]) =>
-          surface.addElement({
-            type: 'connector',
-            mode: ConnectorMode.Straight,
-            source: { id: a },
-            target: { id: b },
-            stroke: MARKET_LINK_COLOR,
-            strokeStyle: StrokeStyle.Solid,
-            strokeWidth: MARKET_LINK_WIDTH,
-            frontEndpointStyle: PointStyle.None,
-            rearEndpointStyle: PointStyle.None,
-          })
-        );
-        return [circle, ...dots, ...conns];
-      }
-      case 'link':
-        return [
-          surface.addElement({
-            type: 'connector',
-            mode: ConnectorMode.Straight,
-            source: { position: [cx - 18, cy + 6] },
-            target: { position: [cx + 18, cy - 6] },
-            stroke: LINK_GREY,
-            strokeStyle: StrokeStyle.Solid,
-            strokeWidth: LINK_STROKE_WIDTH,
-            frontEndpointStyle: PointStyle.None,
-            rearEndpointStyle: PointStyle.None,
-          }),
-        ];
-      case 'arrow':
-        return [
-          surface.addElement({
-            type: 'connector',
-            mode: ConnectorMode.Straight,
-            source: { position: [cx - 18, cy] },
-            target: { position: [cx + 16, cy] },
-            stroke: WARDLEY_RED,
-            strokeStyle: StrokeStyle.Dash,
-            strokeWidth: LINK_STROKE_WIDTH,
-            frontEndpointStyle: PointStyle.None,
-            rearEndpointStyle: PointStyle.Triangle,
-          }),
-        ];
-    }
-  };
-
-  // 3. Create the elements.
-  std.store.captureSync();
-  const ids: string[] = [];
-
-  // White frame.
-  ids.push(
-    surface.addElement({
-      type: 'shape',
-      shapeType: 'rect',
-      filled: true,
-      fillColor: '#ffffff',
-      strokeColor: '#cfd2d6',
-      strokeWidth: 1,
-      shapeStyle: ShapeStyle.General,
-      roughness: 0,
-      radius: 6,
-      xywh: new Bound(x0, y0, W, H).serialize(),
-    })
-  );
-
-  // Title.
-  ids.push(
-    text('Legend', x0 + PAD, y0 + PAD, W - PAD * 2, TITLE_FS + 6, TITLE_FS)
-  );
-
-  // Rows.
-  let ry = y0 + PAD + TITLE_H;
-  for (const t of rows) {
-    const cyRow = ry + ROW_H / 2;
-    ids.push(...glyph(t, x0 + PAD + GLYPH_W / 2, cyRow));
-    ids.push(
-      text(
-        LEGEND_DESC[t],
-        x0 + PAD + GLYPH_W + GAP,
-        cyRow - (TEXT_FS + 8) / 2,
-        TEXT_W,
-        TEXT_FS + 8,
-        TEXT_FS
-      )
-    );
-    ry += ROW_H;
-  }
-
-  // Gradient meaning block: a separator, then [2-colour swatch | caption].
-  if (grad) {
-    const sepY = ry + 4;
-    ids.push(
-      surface.addElement({
-        type: 'shape',
-        shapeType: 'rect',
-        filled: true,
-        fillColor: '#cfd2d6',
-        strokeColor: '#cfd2d6',
-        strokeWidth: 0,
-        shapeStyle: ShapeStyle.General,
-        roughness: 0,
-        radius: 0,
-        xywh: new Bound(x0 + PAD, sepY, W - PAD * 2, 1).serialize(),
-      })
-    );
-    const cyRow = sepY + 8 + GRAD_ROW_H / 2;
-    const sw = 14;
-    const sgap = 2;
-    const sx = x0 + PAD + GLYPH_W / 2 - (sw * 2 + sgap) / 2;
-    grad.swatch.forEach((col, i) => {
-      ids.push(
-        surface.addElement({
-          type: 'shape',
-          shapeType: 'rect',
-          filled: true,
-          fillColor: col,
-          strokeColor: '#cfd2d6',
-          strokeWidth: 0.5,
-          shapeStyle: ShapeStyle.General,
-          roughness: 0,
-          radius: 1,
-          xywh: new Bound(sx + i * (sw + sgap), cyRow - sw / 2, sw, sw).serialize(),
-        })
-      );
-    });
-    ids.push(
-      text(
-        grad.caption,
-        x0 + PAD + GLYPH_W + GAP,
-        cyRow - GRAD_ROW_H / 2,
-        TEXT_W,
-        GRAD_ROW_H,
-        TEXT_FS
-      )
-    );
-  }
-
-  // 4. Group everything and select it.
-  const [, result] = std.command.exec(createGroupCommand, { elements: ids });
-  gfx.selection.set({
-    elements: [result.groupId || ids[0]],
-    editing: false,
-  });
-}

package/src/node/node-renderer.ts

@@ -1,142 +0,0 @@
-import {
-  type ElementRenderer,
-  ElementRendererExtension,
-} from '@formicoidea/labre-core/blocks/surface';
-import { shape as shapeRenderer } from '@formicoidea/labre-core/gfx/shape';
-import { type WardleyNodeElementModel, DefaultTheme } from '@formicoidea/labre-core/model';
-
-import { ANCHOR, ECOSYSTEM, METHOD, NODE_FILL } from './consts';
-
-/**
- * Renderer for a Wardley node. The circle is drawn by REUSING the native shape
- * renderer (so stroke width, colors and theme behave exactly like a native
- * ellipse). On top of it, a glyph is drawn for two kinds:
- *  - `anchor`    → an inscribed person (head + shoulders), clipped to the circle.
- *  - `ecosystem` → a double border at the rim + diagonal hatching confined to the
- *                  inner donut + a hollow central circle.
- * All glyph strokes use the model's (editable) stroke color; the white band and
- * the hollow center come from the base fill, so colors stay editable.
- */
-export const wardleyNode: ElementRenderer<WardleyNodeElementModel> = (
-  model,
-  ctx,
-  matrix,
-  renderer,
-  rc,
-  bound
-) => {
-  const [, , w, h] = model.deserializedXYWH;
-  const cx = w / 2;
-  const cy = h / 2;
-
-  // Capture the element-local transform BEFORE the shape renderer mutates the
-  // matrix, so the glyph can be drawn in the same space afterwards.
-  const glyphMatrix = DOMMatrix.fromMatrix(matrix)
-    .translateSelf(cx, cy)
-    .rotateSelf(model.rotate)
-    .translateSelf(-cx, -cy);
-
-  // Native ellipse (fill / stroke / theme handled natively).
-  shapeRenderer(model, ctx, matrix, renderer, rc, bound);
-
-  if (
-    model.kind !== 'anchor' &&
-    model.kind !== 'ecosystem' &&
-    model.kind !== 'method'
-  )
-    return;
-
-  const strokeWidth = model.strokeWidth || 1;
-  const R = Math.min(w, h) / 2 - strokeWidth / 2;
-  const color = renderer.getColorValue(
-    model.strokeColor,
-    DefaultTheme.shapeStrokeColor,
-    true
-  );
-
-  ctx.setTransform(glyphMatrix);
-
-  // ── Anchor: person glyph (clipped to the circle) ────────────────────
-  if (model.kind === 'anchor') {
-    ctx.save();
-    ctx.beginPath();
-    ctx.arc(cx, cy, R - strokeWidth / 2, 0, Math.PI * 2);
-    ctx.clip();
-
-    ctx.lineWidth = strokeWidth;
-    ctx.strokeStyle = color;
-    ctx.lineCap = 'round';
-    ctx.lineJoin = 'round';
-
-    // head
-    ctx.beginPath();
-    ctx.arc(cx, cy + ANCHOR.headCY * R, ANCHOR.headR * R, 0, Math.PI * 2);
-    ctx.stroke();
-
-    // rounded shoulders (extremities sit on the circle border)
-    const sx = ANCHOR.shoulderEndX * R;
-    const sy = ANCHOR.shoulderEndY * R;
-    const kx = ANCHOR.shoulderCtrlX * R;
-    const ky = ANCHOR.shoulderCtrlY * R;
-    ctx.beginPath();
-    ctx.moveTo(cx - sx, cy + sy);
-    ctx.bezierCurveTo(cx - kx, cy + ky, cx + kx, cy + ky, cx + sx, cy + sy);
-    ctx.stroke();
-
-    ctx.restore();
-    return;
-  }
-
-  // ── Method: a white component inscribed in the colored outer circle ──
-  if (model.kind === 'method') {
-    const rInner = R * METHOD.centerRatio;
-    ctx.fillStyle = NODE_FILL;
-    ctx.lineWidth = strokeWidth;
-    ctx.strokeStyle = color;
-    ctx.beginPath();
-    ctx.arc(cx, cy, rInner, 0, Math.PI * 2);
-    ctx.fill();
-    ctx.stroke();
-    return;
-  }
-
-  // ── Ecosystem: double border + hatched inner donut + hollow center ──
-  const rBorder2 = R * ECOSYSTEM.secondBorderRatio;
-  const rCenter = R * ECOSYSTEM.centerRatio;
-  const rHatch = R * ECOSYSTEM.hatchOuterRatio;
-
-  // Hatch confined to the donut [rCenter, rHatch] (even-odd clip = annulus).
-  ctx.save();
-  ctx.beginPath();
-  ctx.arc(cx, cy, rHatch, 0, Math.PI * 2);
-  ctx.moveTo(cx + rCenter, cy);
-  ctx.arc(cx, cy, rCenter, 0, Math.PI * 2);
-  ctx.clip('evenodd');
-
-  ctx.lineWidth = Math.max(0.5, strokeWidth * 0.6);
-  ctx.strokeStyle = color;
-  const step = R * ECOSYSTEM.hatchSpacingRatio;
-  for (let d = -2 * R; d <= 2 * R; d += step) {
-    ctx.beginPath();
-    ctx.moveTo(cx - R, cy - R + d);
-    ctx.lineTo(cx + R, cy + R + d);
-    ctx.stroke();
-  }
-  ctx.restore();
-
-  // Double border (2nd inscribed circle) + central hole border. No fill: the
-  // white band and hollow center come from the base ellipse fill.
-  ctx.lineWidth = strokeWidth;
-  ctx.strokeStyle = color;
-  ctx.beginPath();
-  ctx.arc(cx, cy, rBorder2, 0, Math.PI * 2);
-  ctx.stroke();
-  ctx.beginPath();
-  ctx.arc(cx, cy, rCenter, 0, Math.PI * 2);
-  ctx.stroke();
-};
-
-export const WardleyNodeRendererExtension = ElementRendererExtension(
-  'wardleyNode',
-  wardleyNode
-);