@grafloria/element 0.3.18 → 0.3.19

package/src/lib/diagram-kit/er.ts

@@ -0,0 +1,246 @@
+/**
+ * ER diagram kit — typed builders for database entity-relationship diagrams.
+ *
+ * The packaged form of what demos/diagrams/table-er.html and er-advanced.html
+ * hand-composed: HTML "table" cards (header, typed columns, PK/FK badges),
+ * crow's-foot cardinality edges, and field-level FK→PK connections via
+ * absolute-layout ports. An embedder writes data:
+ *
+ * ```ts
+ * const spec = erDiagram({
+ *   entities: [
+ *     { id: 'CUSTOMER', columns: [{ name: 'id', type: 'int', pk: true }, …] },
+ *     { id: 'ORDER',    columns: [{ name: 'customer_id', type: 'int', fk: true }, …] },
+ *   ],
+ *   relationships: [
+ *     { from: 'CUSTOMER', to: 'ORDER', label: 'places' },              // table-level
+ *     { from: 'ORDER.customer_id', to: 'CUSTOMER.id' },                // field-level
+ *   ],
+ * });
+ * render(spec, container);
+ * ```
+ */
+import { ensureDiagramKitStyles } from './styles';
+import { bindRowInteractions } from './rows';
+import { entityCardContent, entityAutoHeight, erRowCenterY, ER_ROW_H, ER_HEAD_H } from './card';
+import { bindCardEditing } from './editing';
+
+// Layout constants + the row-centre helper live in card.ts now (the ONE source
+// of truth shared with update.ts). Re-exported here so `import … from './er'`
+// keeps working.
+export { erRowCenterY, ER_ROW_H, ER_HEAD_H };
+
+const DEFAULT_WIDTH = 190;
+
+export interface ErColumn {
+  name: string;
+  type?: string;
+  pk?: boolean;
+  fk?: boolean;
+}
+
+export interface ErEntitySpec {
+  id: string;
+  /** Header text. Defaults to the id. */
+  name?: string;
+  columns: ErColumn[];
+  position?: { x: number; y: number };
+  width?: number;
+  /**
+   * Fixed card height. When smaller than the computed height the column list
+   * SCROLLS (the kit body is overflow-y:auto, and the canvas yields the wheel
+   * to it). Omit for auto-height from the column count.
+   */
+  height?: number;
+}
+
+export type ErCardinality =
+  | 'one-to-many'
+  | 'one-to-one'
+  | 'many-to-many'
+  | 'one-to-zero-or-many'
+  | 'one-to-one-or-many';
+
+export type ErSide = 'left' | 'right' | 'top' | 'bottom';
+
+export interface ErRelationshipSpec {
+  /** Entity id, or `ENTITY.column` to attach at that column's row. */
+  from: string;
+  to: string;
+  label?: string;
+  /** Named cardinality (default one-to-many) or explicit marker types. */
+  cardinality?: ErCardinality | { tail: string; head: string };
+  fromSide?: ErSide;
+  toSide?: ErSide;
+  color?: string;
+  id?: string;
+}
+
+export interface ErDiagramOptions {
+  entities: ErEntitySpec[];
+  relationships?: ErRelationshipSpec[];
+  /**
+   * Rows are selectable by default: click a column to select it (painted with
+   * .axk-row-selected; axk:row-click / axk:row-select CustomEvents fire on the
+   * container). Set false to opt out.
+   */
+  rowSelection?: boolean;
+  /**
+   * In-canvas editing (opt-in, default false — read-only diagrams are
+   * unchanged). When true the card grows editing chrome: double-click the
+   * header to rename the table, double-click a column name to rename it, an
+   * "add column" affordance and a per-row delete control. Every change routes
+   * through {@link updateEntity} as ONE undoable step.
+   */
+  editable?: boolean;
+}
+
+const CARDINALITY: Record<ErCardinality, { tail: string; head: string }> = {
+  'one-to-many': { tail: 'one', head: 'crow-foot' },
+  'one-to-one': { tail: 'one', head: 'one' },
+  'many-to-many': { tail: 'crow-foot', head: 'crow-foot' },
+  'one-to-zero-or-many': { tail: 'one', head: 'zero-or-many' },
+  'one-to-one-or-many': { tail: 'one', head: 'one-or-many' },
+};
+
+interface ParsedEnd {
+  entity: ErEntitySpec;
+  column?: string;
+  rowIndex?: number;
+}
+
+function parseEnd(ref: string, byId: Map<string, ErEntitySpec>): ParsedEnd {
+  const dot = ref.indexOf('.');
+  const entityId = dot === -1 ? ref : ref.slice(0, dot);
+  const entity = byId.get(entityId);
+  if (!entity) throw new Error(`erDiagram: unknown entity "${entityId}" in relationship end "${ref}"`);
+  if (dot === -1) return { entity };
+  const column = ref.slice(dot + 1);
+  const rowIndex = entity.columns.findIndex((c) => c.name === column);
+  if (rowIndex === -1) {
+    throw new Error(`erDiagram: entity "${entityId}" has no column "${column}" (relationship end "${ref}")`);
+  }
+  return { entity, column, rowIndex };
+}
+
+/**
+ * Build a render() spec for an ER diagram.
+ *
+ * Entities become HTML table cards; relationships become orthogonal edges with
+ * crow's-foot cardinality. A `TABLE.column` end pins the edge to that row via
+ * an absolute-layout port (the FK→PK look). Two edges landing on the same
+ * column are automatically spread apart.
+ */
+export function erDiagram(options: ErDiagramOptions): {
+  nodes: Array<Record<string, unknown>>;
+  edges: Array<Record<string, unknown>>;
+  finalize: (api: unknown) => void;
+} {
+  ensureDiagramKitStyles();
+
+  const byId = new Map(options.entities.map((e) => [e.id, e]));
+  // Field-level ports are accumulated per entity while walking relationships.
+  const portsByEntity = new Map<string, Array<Record<string, unknown>>>();
+  // How many edges already landed on a given entity row+side — drives the
+  // spread (dy) so shared columns (a PK referenced twice) don't stack.
+  const rowLandings = new Map<string, number>();
+
+  const width = (e: ErEntitySpec) => e.width ?? DEFAULT_WIDTH;
+
+  const fieldPort = (end: ParsedEnd, side: ErSide): string => {
+    const entity = end.entity;
+    const key = `${entity.id}#${end.rowIndex}#${side}`;
+    const landing = rowLandings.get(key) ?? 0;
+    rowLandings.set(key, landing + 1);
+    // Spread repeat landings ±5px around the row centre: 0, -5, +5, -10, …
+    const dy = landing === 0 ? 0 : (landing % 2 === 1 ? -1 : 1) * Math.ceil(landing / 2) * 5;
+    const id = `${entity.id}__${end.column}__${side}__${landing}`;
+    const w = width(entity);
+    const port = {
+      id,
+      side,
+      visible: false,
+      layout: {
+        strategy: 'absolute',
+        args: {
+          units: 'px',
+          x: side === 'right' ? w : side === 'left' ? 0 : w / 2,
+          y: erRowCenterY(end.rowIndex!),
+          dy,
+        },
+      },
+    };
+    const bucket = portsByEntity.get(entity.id) ?? [];
+    bucket.push(port);
+    portsByEntity.set(entity.id, bucket);
+    return id;
+  };
+
+  const edges = (options.relationships ?? []).map((rel, i) => {
+    const from = parseEnd(rel.from, byId);
+    const to = parseEnd(rel.to, byId);
+    const fromSide = rel.fromSide ?? 'right';
+    const toSide = rel.toSide ?? 'left';
+    const markers =
+      typeof rel.cardinality === 'object'
+        ? rel.cardinality
+        : CARDINALITY[rel.cardinality ?? 'one-to-many'];
+
+    return {
+      id: rel.id ?? `er-rel-${i + 1}`,
+      source: from.entity.id,
+      target: to.entity.id,
+      label: rel.label,
+      type: 'orthogonal',
+      sourceHandle: from.column !== undefined ? fieldPort(from, fromSide) : fromSide,
+      targetHandle: to.column !== undefined ? fieldPort(to, toSide) : toSide,
+      style: {
+        stroke: rel.color ?? '#64748b',
+        strokeWidth: 1.5,
+        arrowTail: { type: markers.tail, size: 8, filled: false },
+        arrowHead: { type: markers.head, size: 9, filled: false },
+      },
+    };
+  });
+
+  const editable = options.editable === true;
+  const nodes = options.entities.map((entity, i) => ({
+    id: entity.id,
+    position: entity.position ?? { x: 60 + (i % 3) * 340, y: 60 + Math.floor(i / 3) * 280 },
+    size: { width: width(entity), height: entityAutoHeight(entity, editable) },
+    // interactive: rows are real DOM targets (hover, row selection, inline
+    // editing) — node drag/select stay geometric in the binder.
+    metadata: {
+      html: { content: entityCardContent(entity, editable), interactive: true },
+      kitEntity: entity,
+      kitEditable: editable,
+      // Only the OPT-OUT is recorded. A loader has to know not to re-bind row
+      // selection, but stamping the default on every card would change the bytes
+      // of every existing document for a value that is already the default.
+      ...(options.rowSelection === false ? { kitRowSelection: false } : {}),
+    },
+    // The card draws its own border — the node's default rectangle is hidden
+    // (and re-suppressed on selection by the kit stylesheet).
+    shape: { type: 'rect', fill: 'none', stroke: 'none' },
+    style: { fill: 'transparent', stroke: 'transparent', strokeWidth: 0 },
+    ...(portsByEntity.has(entity.id) ? { ports: portsByEntity.get(entity.id) } : {}),
+  }));
+
+  return {
+    nodes,
+    edges,
+    finalize: (api: unknown) => {
+      const a = api as { container?: HTMLElement; getModel?: () => { getNode: (id: string) => { setBehavior?: (b: { resizable: boolean }) => void } | undefined } };
+      // The card draws its OWN selection ring — suppress the node resize handles
+      // on the live model (they'd frame the card in a SECOND rectangle). Set here
+      // because the render-input path does not honour a spec-level `behavior`.
+      const model = a?.getModel?.();
+      if (model) for (const e of options.entities) model.getNode?.(e.id)?.setBehavior?.({ resizable: false });
+      if (options.rowSelection !== false && a?.container) bindRowInteractions(a as never);
+      // Editing chrome (dbl-click rename, add/delete column) — opt-in, and safe
+      // to run alongside row selection (it claims control clicks in the capture
+      // phase before the selection handler sees them).
+      if (editable && a?.container) bindCardEditing(a as never);
+    },
+  };
+}

package/src/lib/diagram-kit/handles.js.map

@@ -1 +1 @@
-{"version":3,"file":"handles.js","sourceRoot":"","sources":["../../../../../../libs/element/src/lib/diagram-kit/handles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handles.js","sourceRoot":"","sources":["handles.ts"],"names":[],"mappings":"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"}

package/src/lib/diagram-kit/handles.spec.ts

@@ -0,0 +1,224 @@
+/**
+ * Option B — the typed façade handle layer (user decision, 2026-07-19).
+ *
+ * `CardHandle → ErTable / UmlClass` + `ErField`: the clean OO usage over the
+ * data-first kit. The DESIGN INVARIANT under test everywhere here: handles are
+ * STATELESS — (api, id) closures. They can never go stale, and every mutation
+ * funnels through updateEntity/updateClass, so one-step undo and field-port
+ * reconciliation come free. Tests run against a REAL DiagramModel + the REAL
+ * CommandManager, exactly like update.spec.ts.
+ */
+import { DiagramModel, NodeModel, PortModel, LinkModel, CommandManager } from '@grafloria/engine';
+import { erDiagram } from './er';
+import { umlDiagram } from './uml';
+import { updateEntity } from './update';
+import { erTable, umlClass, erTables, ErTable, ErField, UmlClass } from './handles';
+import { erRowCenterY, ER_ROW_H } from './card';
+
+interface AnySpec {
+  nodes: Array<Record<string, unknown>>;
+  edges: Array<Record<string, unknown>>;
+}
+
+function mount(spec: AnySpec, editable = true) {
+  const model = new DiagramModel();
+  for (const n of spec.nodes as any[]) {
+    const node = new NodeModel({ id: n.id, type: 'kit', position: n.position, size: n.size });
+    for (const p of node.getPorts()) node.removePort(p.id);
+    const meta = n.metadata ?? {};
+    node.setMetadata('html', meta.html);
+    if (meta.kitEntity) node.setMetadata('kitEntity', meta.kitEntity);
+    if (meta.kitClass) node.setMetadata('kitClass', meta.kitClass);
+    node.setMetadata('kitEditable', editable);
+    for (const p of (n.ports ?? []) as any[]) {
+      node.addPort(new PortModel({ id: p.id, type: 'bi', side: p.side, visible: p.visible, layout: p.layout }));
+    }
+    model.addNode(node);
+  }
+  for (const e of spec.edges as any[]) {
+    const link = new LinkModel(e.sourceHandle, e.targetHandle, 'orthogonal');
+    (link as any).id = e.id;
+    model.addLink(link);
+  }
+  const eventBus = { emit() {} };
+  const cm = new CommandManager({ diagram: model, eventBus } as any, eventBus as any);
+  const engine = { commandManager: cm, undo: () => cm.undo(), redo: () => cm.redo() };
+  const container = document.createElement('div');
+  document.body.appendChild(container);
+  const api = { container, getModel: () => model, getEngine: () => engine, renderNow: () => {} };
+  return { model, api, cm, container };
+}
+
+const SCHEMA = (): AnySpec =>
+  erDiagram({
+    editable: true,
+    entities: [
+      { id: 'TARGET', columns: [{ name: 'pk', type: 'int', pk: true }] },
+      {
+        id: 'FOO',
+        name: 'Foo',
+        columns: [
+          { name: 'a', type: 'int', pk: true },
+          { name: 'b', type: 'int', fk: true },
+          { name: 'c', type: 'varchar' },
+        ],
+      },
+    ],
+    relationships: [{ from: 'FOO.b', to: 'TARGET.pk' }],
+  });
+
+const UML = (): AnySpec =>
+  umlDiagram({
+    editable: true,
+    classes: [
+      { id: 'Shape', name: 'Shape', attributes: ['# x: float'], methods: ['+ area(): float'] },
+    ],
+    relationships: [],
+  } as never);
+
+describe('erTable factory', () => {
+  it('resolves a kit table; refuses unknown ids and non-kit nodes', () => {
+    const { api, model } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    expect(t).toBeInstanceOf(ErTable);
+    expect(t.exists).toBe(true);
+    expect(() => erTable(api as never, 'NOPE')).toThrow(/no node/i);
+    const plain = new NodeModel({ id: 'plain', type: 'basic', position: { x: 0, y: 0 }, size: { width: 10, height: 10 } });
+    model.addNode(plain);
+    expect(() => erTable(api as never, 'plain')).toThrow(/not an ER table/i);
+    expect(erTables(api as never).map((x) => x.id).sort()).toEqual(['FOO', 'TARGET']);
+  });
+});
+
+describe('CardHandle basics (name, size, undo sugar)', () => {
+  it('reads the stored spec and renames as ONE undoable step', async () => {
+    const { api, model, cm } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    expect(t.name).toBe('Foo');
+    await t.rename('Sales Foo');
+    expect(t.name).toBe('Sales Foo');
+    expect(JSON.stringify(model.getNode('FOO')!.getMetadata('html'))).toContain('Sales Foo');
+    expect((cm as any).getHistory().length).toBe(1);
+    await t.undo();
+    expect(t.name).toBe('Foo'); // the STATELESS read reflects the restored model
+  });
+
+  it('resizes through the same undoable path', async () => {
+    const { api, model } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    await t.resize({ width: 260 });
+    expect(model.getNode('FOO')!.size.width).toBe(260);
+  });
+});
+
+describe('ErTable.columns + ErField', () => {
+  it('lists, iterates and indexes typed fields', () => {
+    const t = erTable(mount(SCHEMA()).api as never, 'FOO');
+    expect(t.columns.length).toBe(3);
+    expect(t.columns.names()).toEqual(['a', 'b', 'c']);
+    const fields = [...t.columns];
+    expect(fields.every((f) => f instanceof ErField)).toBe(true);
+    expect(t.columns.get('b')!.fk).toBe(true);
+    expect(t.columns.at(0)!.pk).toBe(true);
+    expect(t.columns.get('zzz')).toBeUndefined();
+  });
+
+  it('add-at-index shifts the FK field port down by one row (port glue via the handle path)', async () => {
+    const { api, model } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    const foo = model.getNode('FOO')!;
+    const fkPort = foo.getPorts().find((p: any) => String(p.id).includes('__b__')) as any;
+    expect(fkPort.layout.args.y).toBe(erRowCenterY(1));
+    await t.columns.add({ name: 'inserted', type: 'int' }, { at: 0 });
+    expect(t.columns.names()).toEqual(['inserted', 'a', 'b', 'c']);
+    expect((foo.getPorts().find((p: any) => String(p.id).includes('__b__')) as any).layout.args.y).toBe(
+      erRowCenterY(2)
+    );
+    await t.undo();
+    expect(t.columns.names()).toEqual(['a', 'b', 'c']);
+  });
+
+  it('field rename/retype/remove flow through updateEntity', async () => {
+    const { api, model } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    await t.columns.get('c')!.rename('c2');
+    expect(t.columns.names()).toEqual(['a', 'b', 'c2']);
+    await t.columns.get('c2')!.setType('text');
+    expect(t.columns.get('c2')!.type).toBe('text');
+    await t.columns.get('c2')!.remove();
+    expect(t.columns.names()).toEqual(['a', 'b']);
+    expect(JSON.stringify(model.getNode('FOO')!.getMetadata('html'))).not.toContain('c2');
+  });
+
+  it('handles are stateless: an EXTERNAL updateEntity is visible through an old handle', async () => {
+    const { api } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    const before = t.columns.length;
+    await updateEntity(api as never, 'FOO', {
+      columns: [...(t.spec.columns), { name: 'ext', type: 'int' }],
+    });
+    expect(t.columns.length).toBe(before + 1); // same handle object, fresh truth
+  });
+
+  it('spec getter returns a COPY — mutating it never touches the model', () => {
+    const { api, model } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    t.spec.columns.push({ name: 'evil' } as never);
+    expect((model.getNode('FOO')!.getMetadata('kitEntity') as any).columns.length).toBe(3);
+  });
+});
+
+describe('UmlClass handle', () => {
+  it('attributes/methods collections + abstract flag, all undoable', async () => {
+    const { api, model, cm } = mount(UML());
+    const c = umlClass(api as never, 'Shape');
+    expect(c).toBeInstanceOf(UmlClass);
+    expect(c.attributes.list()).toEqual(['# x: float']);
+    await c.methods.add('+ perimeter(): float');
+    expect(c.methods.list()).toEqual(['+ area(): float', '+ perimeter(): float']);
+    await c.setAbstract(true);
+    expect(c.abstract).toBe(true);
+    expect(JSON.stringify(model.getNode('Shape')!.getMetadata('html'))).toContain('perimeter');
+    await c.undo(); // abstract off
+    await c.undo(); // method gone
+    expect(c.methods.list()).toEqual(['+ area(): float']);
+    expect(c.abstract).toBe(false);
+    await c.redo(); // method back — the handle's redo sugar round-trips
+    expect(c.methods.list()).toEqual(['+ area(): float', '+ perimeter(): float']);
+    expect((cm as any).getHistory().length).toBe(2); // executed commands stay on the stack
+  });
+
+  it('renameAt / removeAt on members', async () => {
+    const c = umlClass(mount(UML()).api as never, 'Shape');
+    await c.attributes.renameAt(0, '# x: double');
+    expect(c.attributes.list()).toEqual(['# x: double']);
+    await c.attributes.removeAt(0);
+    expect(c.attributes.list()).toEqual([]);
+  });
+});
+
+describe('onRowSelect', () => {
+  it('fires only for THIS card, with a typed field when resolvable, and unbinds', () => {
+    const { api, container } = mount(SCHEMA());
+    const t = erTable(api as never, 'FOO');
+    const seen: any[] = [];
+    const off = t.onRowSelect((sel) => seen.push(sel));
+    const fire = (nodeId: string | null, rowIndex = 1, name = 'b') =>
+      container.dispatchEvent(
+        new CustomEvent('axk:row-select', {
+          detail: { selected: nodeId ? { nodeId, rowIndex, name, kind: 'er' } : null },
+        })
+      );
+    fire('TARGET'); // other card — ignored
+    expect(seen).toHaveLength(0);
+    fire('FOO');
+    expect(seen).toHaveLength(1);
+    expect(seen[0].field).toBeInstanceOf(ErField);
+    expect(seen[0].field.name).toBe('b');
+    fire(null); // deselect → null
+    expect(seen[1]).toEqual({ field: null, selected: null });
+    off();
+    fire('FOO');
+    expect(seen).toHaveLength(2);
+  });
+});