@miragon/event-storming-transforms 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# @miragon/event-storming-transforms
+
+[![npm](https://img.shields.io/npm/v/@miragon/event-storming-transforms)](https://www.npmjs.com/package/@miragon/event-storming-transforms)
+[![License: MIT](https://img.shields.io/github/license/Miragon/event-storming-modeler)](https://github.com/Miragon/event-storming-modeler/blob/main/LICENSE)
+
+DOM-free, pure `EventStormingBoard → EventStormingBoard` transforms — move, kind, color, arrange.
+No undo stack: every transform returns a new board and leaves the input untouched.
+
+## Install
+
+```bash
+npm install @miragon/event-storming-transforms
+```
+
+## Usage
+
+```ts
+import { parseDSL } from '@miragon/event-storming-dsl';
+import { moveElement, setStickyKind } from '@miragon/event-storming-transforms';
+
+const board = parseDSL('event Order Placed [620, 300]');
+const [orderPlaced] = board.elements;
+
+const moved = moveElement(board, orderPlaced.id, { x: 800, y: 300 }); // returns a new board
+const retyped = setStickyKind(moved, orderPlaced.id, 'policy');
+```
+
+Also included: `moveBy` (delta translation), `setColor`/`clearColor` (sticky color override),
+`alignToRows` (snap stickies into per-kind swimlanes) and `spreadTimeline` (spread stickies
+evenly along the timeline).
+
+Part of the [Event Storming Modeler](https://github.com/Miragon/event-storming-modeler) monorepo.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,139 @@
+'use strict';
+
+var eventStormingSchemaModel = require('@miragon/event-storming-schema-model');
+
+// src/util.ts
+function updateElement(board, id, updater) {
+  let found = false;
+  const elements = board.elements.map((el) => {
+    if (el.id !== id) return el;
+    found = true;
+    return updater(el);
+  });
+  if (!found) throw new Error(`Element "${id}" not found.`);
+  return { ...board, elements };
+}
+function findElement(board, id) {
+  return board.elements.find((el) => el.id === id);
+}
+function compact(obj) {
+  const out = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
+
+// src/move.ts
+function moveElement(board, elementId, position) {
+  const current = findElement(board, elementId);
+  if (!current) throw new Error(`Element "${elementId}" not found.`);
+  return moveBy(board, elementId, {
+    dx: position.x - current.position.x,
+    dy: position.y - current.position.y
+  });
+}
+function moveBy(board, elementId, { dx, dy }) {
+  return updateElement(board, elementId, (el) => {
+    const position = { x: el.position.x + dx, y: el.position.y + dy };
+    if (el.elementType === "drawing") {
+      return {
+        ...el,
+        position,
+        points: el.points.map((point) => ({ x: point.x + dx, y: point.y + dy }))
+      };
+    }
+    return { ...el, position };
+  });
+}
+
+// src/kind.ts
+var STICKY_ELEMENT_TYPES = [
+  "event",
+  "command",
+  "actor",
+  "aggregate",
+  "policy",
+  "readmodel",
+  "external",
+  "hotspot"
+];
+function isStickyElementType(elementType) {
+  return STICKY_ELEMENT_TYPES.includes(elementType);
+}
+function setStickyKind(board, elementId, elementType) {
+  if (!isStickyElementType(elementType)) {
+    throw new Error(
+      `setStickyKind cannot retype to "${elementType}"; not a sticky kind.`
+    );
+  }
+  return updateElement(board, elementId, (el) => {
+    if (!isStickyElementType(el.elementType)) {
+      throw new Error(
+        `setStickyKind only applies to stickies; "${elementId}" is ${el.elementType}.`
+      );
+    }
+    return compact({
+      id: el.id,
+      elementType,
+      label: el.label,
+      position: el.position,
+      color: el.color
+    });
+  });
+}
+
+// src/color.ts
+function setColor(board, elementId, color) {
+  return updateElement(board, elementId, (el) => ({ ...el, color }));
+}
+function clearColor(board, elementId) {
+  return updateElement(
+    board,
+    elementId,
+    (el) => compact({ ...el, color: void 0 })
+  );
+}
+var LANE_Y = {
+  readmodel: 120,
+  actor: 220,
+  command: 320,
+  aggregate: 320,
+  event: 420,
+  policy: 520,
+  external: 620,
+  hotspot: 720
+};
+function alignToRows(board) {
+  const elements = board.elements.map(
+    (el) => isStickyElementType(el.elementType) ? { ...el, position: { x: el.position.x, y: LANE_Y[el.elementType] } } : el
+  );
+  return { ...board, elements };
+}
+function spreadTimeline(board, { gap = 180 } = {}) {
+  const stickies = eventStormingSchemaModel.sortByTimeline(board).filter((el) => isStickyElementType(el.elementType));
+  if (stickies.length === 0) return board;
+  const startX = Math.min(...stickies.map((el) => el.position.x));
+  const targetX = /* @__PURE__ */ new Map();
+  stickies.forEach((el, index) => targetX.set(el.id, startX + index * gap));
+  const elements = board.elements.map((el) => {
+    const x = targetX.get(el.id);
+    return x === void 0 ? el : { ...el, position: { x, y: el.position.y } };
+  });
+  return { ...board, elements };
+}
+
+exports.STICKY_ELEMENT_TYPES = STICKY_ELEMENT_TYPES;
+exports.alignToRows = alignToRows;
+exports.clearColor = clearColor;
+exports.compact = compact;
+exports.findElement = findElement;
+exports.isStickyElementType = isStickyElementType;
+exports.moveBy = moveBy;
+exports.moveElement = moveElement;
+exports.setColor = setColor;
+exports.setStickyKind = setStickyKind;
+exports.spreadTimeline = spreadTimeline;
+exports.updateElement = updateElement;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util.ts","../src/move.ts","../src/kind.ts","../src/color.ts","../src/arrange.ts"],"names":["sortByTimeline"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { BoardElement, EventStormingBoard } from '@miragon/event-storming-schema-model';\n\nexport function updateElement(\n  board: EventStormingBoard,\n  id: string,\n  updater: (el: BoardElement) => BoardElement,\n): EventStormingBoard {\n  let found = false;\n  const elements = board.elements.map((el) => {\n    if (el.id !== id) return el;\n    found = true;\n    return updater(el);\n  });\n  if (!found) throw new Error(`Element \"${id}\" not found.`);\n  return { ...board, elements };\n}\n\nexport function findElement(board: EventStormingBoard, id: string): BoardElement | undefined {\n  return board.elements.find((el) => el.id === id);\n}\n\n/** Removes `undefined` values so exactOptionalPropertyTypes is not violated. */\nexport function compact<T extends Record<string, unknown>>(obj: T): T {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (v !== undefined) out[k] = v;\n  }\n  return out as T;\n}\n","import type { Coordinate, EventStormingBoard } from '@miragon/event-storming-schema-model';\nimport { updateElement, findElement } from './util.js';\n\nexport interface MoveDelta {\n  readonly dx: number;\n  readonly dy: number;\n}\n\n/** Pure function — no undo stack: returns a new board with the element centered at `position`. */\nexport function moveElement(\n  board: EventStormingBoard,\n  elementId: string,\n  position: Coordinate,\n): EventStormingBoard {\n  const current = findElement(board, elementId);\n  if (!current) throw new Error(`Element \"${elementId}\" not found.`);\n  return moveBy(board, elementId, {\n    dx: position.x - current.position.x,\n    dy: position.y - current.position.y,\n  });\n}\n\n/** Translates an element by a pixel delta. The canvas is free — any finite target is valid. */\nexport function moveBy(\n  board: EventStormingBoard,\n  elementId: string,\n  { dx, dy }: MoveDelta,\n): EventStormingBoard {\n  return updateElement(board, elementId, (el) => {\n    const position = { x: el.position.x + dx, y: el.position.y + dy };\n    if (el.elementType === 'drawing') {\n      // Drawing points are absolute board pixels and `position` mirrors the first point,\n      // so the polyline must translate together with the position.\n      return {\n        ...el,\n        position,\n        points: el.points.map((point) => ({ x: point.x + dx, y: point.y + dy })),\n      };\n    }\n    return { ...el, position };\n  });\n}\n","import type {\n  BoardElement,\n  ElementType,\n  EventStormingBoard,\n} from '@miragon/event-storming-schema-model';\nimport { updateElement, compact } from './util.js';\n\n/** The eight retypeable sticky kinds — every element kind except notes and drawings. */\nexport const STICKY_ELEMENT_TYPES = [\n  'event',\n  'command',\n  'actor',\n  'aggregate',\n  'policy',\n  'readmodel',\n  'external',\n  'hotspot',\n] as const;\n\nexport type StickyElementType = (typeof STICKY_ELEMENT_TYPES)[number];\n\nexport function isStickyElementType(elementType: ElementType): elementType is StickyElementType {\n  return (STICKY_ELEMENT_TYPES as readonly ElementType[]).includes(elementType);\n}\n\n/**\n * Retypes a sticky (e.g. command → event), preserving id, label, position and color.\n * Notes and drawings are not stickies and cannot take part in retyping.\n */\nexport function setStickyKind(\n  board: EventStormingBoard,\n  elementId: string,\n  elementType: StickyElementType,\n): EventStormingBoard {\n  if (!isStickyElementType(elementType)) {\n    throw new Error(\n      `setStickyKind cannot retype to \"${elementType as string}\"; not a sticky kind.`,\n    );\n  }\n  return updateElement(board, elementId, (el) => {\n    if (!isStickyElementType(el.elementType)) {\n      throw new Error(\n        `setStickyKind only applies to stickies; \"${elementId}\" is ${el.elementType}.`,\n      );\n    }\n    // Rebuild from the shared base fields so nothing kind-specific ever leaks across a retype.\n    return compact({\n      id: el.id,\n      elementType,\n      label: el.label,\n      position: el.position,\n      color: el.color,\n    }) as BoardElement;\n  });\n}\n","import type { BoardElement, EventStormingBoard } from '@miragon/event-storming-schema-model';\nimport { updateElement, compact } from './util.js';\n\n/** Sets the element's color override (CSS color, typically a hex sticky fill). */\nexport function setColor(\n  board: EventStormingBoard,\n  elementId: string,\n  color: string,\n): EventStormingBoard {\n  return updateElement(board, elementId, (el) => ({ ...el, color }));\n}\n\n/** Removes the color override so the element falls back to its per-kind default fill. */\nexport function clearColor(board: EventStormingBoard, elementId: string): EventStormingBoard {\n  // compact drops the undefined value, so the `color` key is deleted rather than kept as undefined.\n  return updateElement(\n    board,\n    elementId,\n    (el) => compact({ ...el, color: undefined }) as unknown as BoardElement,\n  );\n}\n","import { sortByTimeline, type EventStormingBoard } from '@miragon/event-storming-schema-model';\nimport { isStickyElementType, type StickyElementType } from './kind.js';\n\n/**\n * Per-kind lane centers (board pixels, top → bottom) for the classic picture-that-explains-\n * everything row layout. Command and aggregate share the middle lane.\n */\nconst LANE_Y: Readonly<Record<StickyElementType, number>> = {\n  readmodel: 120,\n  actor: 220,\n  command: 320,\n  aggregate: 320,\n  event: 420,\n  policy: 520,\n  external: 620,\n  hotspot: 720,\n};\n\n/**\n * Snaps every sticky's y to its per-kind lane, preserving x.\n * Notes and drawings are free annotations and stay untouched.\n */\nexport function alignToRows(board: EventStormingBoard): EventStormingBoard {\n  const elements = board.elements.map((el) =>\n    isStickyElementType(el.elementType)\n      ? { ...el, position: { x: el.position.x, y: LANE_Y[el.elementType] } }\n      : el,\n  );\n  return { ...board, elements };\n}\n\nexport interface SpreadTimelineOptions {\n  /** Horizontal distance between neighboring stickies in board pixels. */\n  readonly gap?: number;\n}\n\n/**\n * Redistributes the stickies' x evenly in timeline order (see `sortByTimeline`), starting at\n * the current leftmost sticky, preserving each y. Notes and drawings stay untouched.\n */\nexport function spreadTimeline(\n  board: EventStormingBoard,\n  { gap = 180 }: SpreadTimelineOptions = {},\n): EventStormingBoard {\n  const stickies = sortByTimeline(board).filter((el) => isStickyElementType(el.elementType));\n  if (stickies.length === 0) return board;\n  const startX = Math.min(...stickies.map((el) => el.position.x));\n  const targetX = new Map<string, number>();\n  stickies.forEach((el, index) => targetX.set(el.id, startX + index * gap));\n  const elements = board.elements.map((el) => {\n    const x = targetX.get(el.id);\n    return x === undefined ? el : { ...el, position: { x, y: el.position.y } };\n  });\n  return { ...board, elements };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,47 @@
+import { EventStormingBoard, BoardElement, Coordinate, ElementType } from '@miragon/event-storming-schema-model';
+
+declare function updateElement(board: EventStormingBoard, id: string, updater: (el: BoardElement) => BoardElement): EventStormingBoard;
+declare function findElement(board: EventStormingBoard, id: string): BoardElement | undefined;
+/** Removes `undefined` values so exactOptionalPropertyTypes is not violated. */
+declare function compact<T extends Record<string, unknown>>(obj: T): T;
+
+interface MoveDelta {
+    readonly dx: number;
+    readonly dy: number;
+}
+/** Pure function — no undo stack: returns a new board with the element centered at `position`. */
+declare function moveElement(board: EventStormingBoard, elementId: string, position: Coordinate): EventStormingBoard;
+/** Translates an element by a pixel delta. The canvas is free — any finite target is valid. */
+declare function moveBy(board: EventStormingBoard, elementId: string, { dx, dy }: MoveDelta): EventStormingBoard;
+
+/** The eight retypeable sticky kinds — every element kind except notes and drawings. */
+declare const STICKY_ELEMENT_TYPES: readonly ["event", "command", "actor", "aggregate", "policy", "readmodel", "external", "hotspot"];
+type StickyElementType = (typeof STICKY_ELEMENT_TYPES)[number];
+declare function isStickyElementType(elementType: ElementType): elementType is StickyElementType;
+/**
+ * Retypes a sticky (e.g. command → event), preserving id, label, position and color.
+ * Notes and drawings are not stickies and cannot take part in retyping.
+ */
+declare function setStickyKind(board: EventStormingBoard, elementId: string, elementType: StickyElementType): EventStormingBoard;
+
+/** Sets the element's color override (CSS color, typically a hex sticky fill). */
+declare function setColor(board: EventStormingBoard, elementId: string, color: string): EventStormingBoard;
+/** Removes the color override so the element falls back to its per-kind default fill. */
+declare function clearColor(board: EventStormingBoard, elementId: string): EventStormingBoard;
+
+/**
+ * Snaps every sticky's y to its per-kind lane, preserving x.
+ * Notes and drawings are free annotations and stay untouched.
+ */
+declare function alignToRows(board: EventStormingBoard): EventStormingBoard;
+interface SpreadTimelineOptions {
+    /** Horizontal distance between neighboring stickies in board pixels. */
+    readonly gap?: number;
+}
+/**
+ * Redistributes the stickies' x evenly in timeline order (see `sortByTimeline`), starting at
+ * the current leftmost sticky, preserving each y. Notes and drawings stay untouched.
+ */
+declare function spreadTimeline(board: EventStormingBoard, { gap }?: SpreadTimelineOptions): EventStormingBoard;
+
+export { type MoveDelta, STICKY_ELEMENT_TYPES, type SpreadTimelineOptions, type StickyElementType, alignToRows, clearColor, compact, findElement, isStickyElementType, moveBy, moveElement, setColor, setStickyKind, spreadTimeline, updateElement };

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { EventStormingBoard, BoardElement, Coordinate, ElementType } from '@miragon/event-storming-schema-model';
+
+declare function updateElement(board: EventStormingBoard, id: string, updater: (el: BoardElement) => BoardElement): EventStormingBoard;
+declare function findElement(board: EventStormingBoard, id: string): BoardElement | undefined;
+/** Removes `undefined` values so exactOptionalPropertyTypes is not violated. */
+declare function compact<T extends Record<string, unknown>>(obj: T): T;
+
+interface MoveDelta {
+    readonly dx: number;
+    readonly dy: number;
+}
+/** Pure function — no undo stack: returns a new board with the element centered at `position`. */
+declare function moveElement(board: EventStormingBoard, elementId: string, position: Coordinate): EventStormingBoard;
+/** Translates an element by a pixel delta. The canvas is free — any finite target is valid. */
+declare function moveBy(board: EventStormingBoard, elementId: string, { dx, dy }: MoveDelta): EventStormingBoard;
+
+/** The eight retypeable sticky kinds — every element kind except notes and drawings. */
+declare const STICKY_ELEMENT_TYPES: readonly ["event", "command", "actor", "aggregate", "policy", "readmodel", "external", "hotspot"];
+type StickyElementType = (typeof STICKY_ELEMENT_TYPES)[number];
+declare function isStickyElementType(elementType: ElementType): elementType is StickyElementType;
+/**
+ * Retypes a sticky (e.g. command → event), preserving id, label, position and color.
+ * Notes and drawings are not stickies and cannot take part in retyping.
+ */
+declare function setStickyKind(board: EventStormingBoard, elementId: string, elementType: StickyElementType): EventStormingBoard;
+
+/** Sets the element's color override (CSS color, typically a hex sticky fill). */
+declare function setColor(board: EventStormingBoard, elementId: string, color: string): EventStormingBoard;
+/** Removes the color override so the element falls back to its per-kind default fill. */
+declare function clearColor(board: EventStormingBoard, elementId: string): EventStormingBoard;
+
+/**
+ * Snaps every sticky's y to its per-kind lane, preserving x.
+ * Notes and drawings are free annotations and stay untouched.
+ */
+declare function alignToRows(board: EventStormingBoard): EventStormingBoard;
+interface SpreadTimelineOptions {
+    /** Horizontal distance between neighboring stickies in board pixels. */
+    readonly gap?: number;
+}
+/**
+ * Redistributes the stickies' x evenly in timeline order (see `sortByTimeline`), starting at
+ * the current leftmost sticky, preserving each y. Notes and drawings stay untouched.
+ */
+declare function spreadTimeline(board: EventStormingBoard, { gap }?: SpreadTimelineOptions): EventStormingBoard;
+
+export { type MoveDelta, STICKY_ELEMENT_TYPES, type SpreadTimelineOptions, type StickyElementType, alignToRows, clearColor, compact, findElement, isStickyElementType, moveBy, moveElement, setColor, setStickyKind, spreadTimeline, updateElement };

package/dist/index.js

@@ -0,0 +1,126 @@
+import { sortByTimeline } from '@miragon/event-storming-schema-model';
+
+// src/util.ts
+function updateElement(board, id, updater) {
+  let found = false;
+  const elements = board.elements.map((el) => {
+    if (el.id !== id) return el;
+    found = true;
+    return updater(el);
+  });
+  if (!found) throw new Error(`Element "${id}" not found.`);
+  return { ...board, elements };
+}
+function findElement(board, id) {
+  return board.elements.find((el) => el.id === id);
+}
+function compact(obj) {
+  const out = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
+
+// src/move.ts
+function moveElement(board, elementId, position) {
+  const current = findElement(board, elementId);
+  if (!current) throw new Error(`Element "${elementId}" not found.`);
+  return moveBy(board, elementId, {
+    dx: position.x - current.position.x,
+    dy: position.y - current.position.y
+  });
+}
+function moveBy(board, elementId, { dx, dy }) {
+  return updateElement(board, elementId, (el) => {
+    const position = { x: el.position.x + dx, y: el.position.y + dy };
+    if (el.elementType === "drawing") {
+      return {
+        ...el,
+        position,
+        points: el.points.map((point) => ({ x: point.x + dx, y: point.y + dy }))
+      };
+    }
+    return { ...el, position };
+  });
+}
+
+// src/kind.ts
+var STICKY_ELEMENT_TYPES = [
+  "event",
+  "command",
+  "actor",
+  "aggregate",
+  "policy",
+  "readmodel",
+  "external",
+  "hotspot"
+];
+function isStickyElementType(elementType) {
+  return STICKY_ELEMENT_TYPES.includes(elementType);
+}
+function setStickyKind(board, elementId, elementType) {
+  if (!isStickyElementType(elementType)) {
+    throw new Error(
+      `setStickyKind cannot retype to "${elementType}"; not a sticky kind.`
+    );
+  }
+  return updateElement(board, elementId, (el) => {
+    if (!isStickyElementType(el.elementType)) {
+      throw new Error(
+        `setStickyKind only applies to stickies; "${elementId}" is ${el.elementType}.`
+      );
+    }
+    return compact({
+      id: el.id,
+      elementType,
+      label: el.label,
+      position: el.position,
+      color: el.color
+    });
+  });
+}
+
+// src/color.ts
+function setColor(board, elementId, color) {
+  return updateElement(board, elementId, (el) => ({ ...el, color }));
+}
+function clearColor(board, elementId) {
+  return updateElement(
+    board,
+    elementId,
+    (el) => compact({ ...el, color: void 0 })
+  );
+}
+var LANE_Y = {
+  readmodel: 120,
+  actor: 220,
+  command: 320,
+  aggregate: 320,
+  event: 420,
+  policy: 520,
+  external: 620,
+  hotspot: 720
+};
+function alignToRows(board) {
+  const elements = board.elements.map(
+    (el) => isStickyElementType(el.elementType) ? { ...el, position: { x: el.position.x, y: LANE_Y[el.elementType] } } : el
+  );
+  return { ...board, elements };
+}
+function spreadTimeline(board, { gap = 180 } = {}) {
+  const stickies = sortByTimeline(board).filter((el) => isStickyElementType(el.elementType));
+  if (stickies.length === 0) return board;
+  const startX = Math.min(...stickies.map((el) => el.position.x));
+  const targetX = /* @__PURE__ */ new Map();
+  stickies.forEach((el, index) => targetX.set(el.id, startX + index * gap));
+  const elements = board.elements.map((el) => {
+    const x = targetX.get(el.id);
+    return x === void 0 ? el : { ...el, position: { x, y: el.position.y } };
+  });
+  return { ...board, elements };
+}
+
+export { STICKY_ELEMENT_TYPES, alignToRows, clearColor, compact, findElement, isStickyElementType, moveBy, moveElement, setColor, setStickyKind, spreadTimeline, updateElement };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util.ts","../src/move.ts","../src/kind.ts","../src/color.ts","../src/arrange.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { BoardElement, EventStormingBoard } from '@miragon/event-storming-schema-model';\n\nexport function updateElement(\n  board: EventStormingBoard,\n  id: string,\n  updater: (el: BoardElement) => BoardElement,\n): EventStormingBoard {\n  let found = false;\n  const elements = board.elements.map((el) => {\n    if (el.id !== id) return el;\n    found = true;\n    return updater(el);\n  });\n  if (!found) throw new Error(`Element \"${id}\" not found.`);\n  return { ...board, elements };\n}\n\nexport function findElement(board: EventStormingBoard, id: string): BoardElement | undefined {\n  return board.elements.find((el) => el.id === id);\n}\n\n/** Removes `undefined` values so exactOptionalPropertyTypes is not violated. */\nexport function compact<T extends Record<string, unknown>>(obj: T): T {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (v !== undefined) out[k] = v;\n  }\n  return out as T;\n}\n","import type { Coordinate, EventStormingBoard } from '@miragon/event-storming-schema-model';\nimport { updateElement, findElement } from './util.js';\n\nexport interface MoveDelta {\n  readonly dx: number;\n  readonly dy: number;\n}\n\n/** Pure function — no undo stack: returns a new board with the element centered at `position`. */\nexport function moveElement(\n  board: EventStormingBoard,\n  elementId: string,\n  position: Coordinate,\n): EventStormingBoard {\n  const current = findElement(board, elementId);\n  if (!current) throw new Error(`Element \"${elementId}\" not found.`);\n  return moveBy(board, elementId, {\n    dx: position.x - current.position.x,\n    dy: position.y - current.position.y,\n  });\n}\n\n/** Translates an element by a pixel delta. The canvas is free — any finite target is valid. */\nexport function moveBy(\n  board: EventStormingBoard,\n  elementId: string,\n  { dx, dy }: MoveDelta,\n): EventStormingBoard {\n  return updateElement(board, elementId, (el) => {\n    const position = { x: el.position.x + dx, y: el.position.y + dy };\n    if (el.elementType === 'drawing') {\n      // Drawing points are absolute board pixels and `position` mirrors the first point,\n      // so the polyline must translate together with the position.\n      return {\n        ...el,\n        position,\n        points: el.points.map((point) => ({ x: point.x + dx, y: point.y + dy })),\n      };\n    }\n    return { ...el, position };\n  });\n}\n","import type {\n  BoardElement,\n  ElementType,\n  EventStormingBoard,\n} from '@miragon/event-storming-schema-model';\nimport { updateElement, compact } from './util.js';\n\n/** The eight retypeable sticky kinds — every element kind except notes and drawings. */\nexport const STICKY_ELEMENT_TYPES = [\n  'event',\n  'command',\n  'actor',\n  'aggregate',\n  'policy',\n  'readmodel',\n  'external',\n  'hotspot',\n] as const;\n\nexport type StickyElementType = (typeof STICKY_ELEMENT_TYPES)[number];\n\nexport function isStickyElementType(elementType: ElementType): elementType is StickyElementType {\n  return (STICKY_ELEMENT_TYPES as readonly ElementType[]).includes(elementType);\n}\n\n/**\n * Retypes a sticky (e.g. command → event), preserving id, label, position and color.\n * Notes and drawings are not stickies and cannot take part in retyping.\n */\nexport function setStickyKind(\n  board: EventStormingBoard,\n  elementId: string,\n  elementType: StickyElementType,\n): EventStormingBoard {\n  if (!isStickyElementType(elementType)) {\n    throw new Error(\n      `setStickyKind cannot retype to \"${elementType as string}\"; not a sticky kind.`,\n    );\n  }\n  return updateElement(board, elementId, (el) => {\n    if (!isStickyElementType(el.elementType)) {\n      throw new Error(\n        `setStickyKind only applies to stickies; \"${elementId}\" is ${el.elementType}.`,\n      );\n    }\n    // Rebuild from the shared base fields so nothing kind-specific ever leaks across a retype.\n    return compact({\n      id: el.id,\n      elementType,\n      label: el.label,\n      position: el.position,\n      color: el.color,\n    }) as BoardElement;\n  });\n}\n","import type { BoardElement, EventStormingBoard } from '@miragon/event-storming-schema-model';\nimport { updateElement, compact } from './util.js';\n\n/** Sets the element's color override (CSS color, typically a hex sticky fill). */\nexport function setColor(\n  board: EventStormingBoard,\n  elementId: string,\n  color: string,\n): EventStormingBoard {\n  return updateElement(board, elementId, (el) => ({ ...el, color }));\n}\n\n/** Removes the color override so the element falls back to its per-kind default fill. */\nexport function clearColor(board: EventStormingBoard, elementId: string): EventStormingBoard {\n  // compact drops the undefined value, so the `color` key is deleted rather than kept as undefined.\n  return updateElement(\n    board,\n    elementId,\n    (el) => compact({ ...el, color: undefined }) as unknown as BoardElement,\n  );\n}\n","import { sortByTimeline, type EventStormingBoard } from '@miragon/event-storming-schema-model';\nimport { isStickyElementType, type StickyElementType } from './kind.js';\n\n/**\n * Per-kind lane centers (board pixels, top → bottom) for the classic picture-that-explains-\n * everything row layout. Command and aggregate share the middle lane.\n */\nconst LANE_Y: Readonly<Record<StickyElementType, number>> = {\n  readmodel: 120,\n  actor: 220,\n  command: 320,\n  aggregate: 320,\n  event: 420,\n  policy: 520,\n  external: 620,\n  hotspot: 720,\n};\n\n/**\n * Snaps every sticky's y to its per-kind lane, preserving x.\n * Notes and drawings are free annotations and stay untouched.\n */\nexport function alignToRows(board: EventStormingBoard): EventStormingBoard {\n  const elements = board.elements.map((el) =>\n    isStickyElementType(el.elementType)\n      ? { ...el, position: { x: el.position.x, y: LANE_Y[el.elementType] } }\n      : el,\n  );\n  return { ...board, elements };\n}\n\nexport interface SpreadTimelineOptions {\n  /** Horizontal distance between neighboring stickies in board pixels. */\n  readonly gap?: number;\n}\n\n/**\n * Redistributes the stickies' x evenly in timeline order (see `sortByTimeline`), starting at\n * the current leftmost sticky, preserving each y. Notes and drawings stay untouched.\n */\nexport function spreadTimeline(\n  board: EventStormingBoard,\n  { gap = 180 }: SpreadTimelineOptions = {},\n): EventStormingBoard {\n  const stickies = sortByTimeline(board).filter((el) => isStickyElementType(el.elementType));\n  if (stickies.length === 0) return board;\n  const startX = Math.min(...stickies.map((el) => el.position.x));\n  const targetX = new Map<string, number>();\n  stickies.forEach((el, index) => targetX.set(el.id, startX + index * gap));\n  const elements = board.elements.map((el) => {\n    const x = targetX.get(el.id);\n    return x === undefined ? el : { ...el, position: { x, y: el.position.y } };\n  });\n  return { ...board, elements };\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@miragon/event-storming-transforms",
+  "version": "0.1.0",
+  "description": "Pure functions that turn an Event Storming board into a new one, such as move, kind, color and arrange.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Miragon/event-storming-modeler.git",
+    "directory": "packages/transforms"
+  },
+  "homepage": "https://github.com/Miragon/event-storming-modeler/tree/main/packages/transforms#readme",
+  "bugs": "https://github.com/Miragon/event-storming-modeler/issues",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@miragon/event-storming-schema-model": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "8.5.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.11"
+  }
+}