@grafloria/element 0.3.19 → 0.3.20

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

@@ -1,246 +0,0 @@
-/**
- * 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 +0,0 @@
-{"version":3,"file":"handles.js","sourceRoot":"","sources":["handles.ts"],"names":[],"mappings":"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"}

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

@@ -1,224 +0,0 @@
-/**
- * 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);
-  });
-});