@grafloria/element 0.3.19 → 0.3.21

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

@@ -1,219 +0,0 @@
-/**
- * Card building — the ONE source of truth for the ER/UML card HTML trees, the
- * layout constants and the size math.
- *
- * Both the builders (er.ts / uml.ts, which emit the initial render() spec) and
- * the live editor (update.ts, which regenerates a card after an edit) call
- * these. Keeping them here is what stops the two paths from drifting: an edited
- * card is byte-for-byte the card the builder would have produced for the same
- * data, so a re-rendered table looks identical to a freshly built one.
- *
- * `editable` threads through: when true the card grows the in-canvas editing
- * chrome (a per-row delete control and a trailing "add" affordance). That
- * chrome is DELIBERATELY not a `.axk-row`/`.axk-member` — the row-selection and
- * port-reconciliation code count those, and the affordance is neither a column
- * nor a member.
- */
-
-import type { ErColumn, ErEntitySpec } from './er';
-import type { UmlClassSpec } from './uml';
-
-/** Row height / header height of the entity card — sizing is derived from these. */
-export const ER_ROW_H = 25;
-export const ER_HEAD_H = 28;
-/**
- * Auto-height slack: the html wrapper's padding (8px) + the card's 1px
- * top/bottom borders + the head rendering slightly under ER_HEAD_H. Measured
- * live — with less, an auto-sized card overflows a few px, and the wheel
- * delegation would steal that much scroll on EVERY card.
- */
-export const ER_BORDER_SLACK = 9;
-/** The editable "add column" affordance row's height (excluded from row math). */
-export const ER_ADD_H = 26;
-
-/** UML compartment metrics (mirrors the pre-kit demos, measured live). */
-export const UML_LINE_H = 19;
-export const UML_NAME_H = 30;
-export const UML_STEREO_H = 14;
-export const UML_PAD = 8;
-
-/** Node-local y of a row's centre (the +1 offsets past the card's top border). */
-export function erRowCenterY(rowIndex: number): number {
-  return ER_HEAD_H + rowIndex * ER_ROW_H + ER_ROW_H / 2 + 1;
-}
-
-/** Inverse of {@link erRowCenterY}: which column row a pinned port sits on. */
-export function rowIndexFromY(y: number): number {
-  return Math.round((y - ER_HEAD_H - ER_ROW_H / 2 - 1) / ER_ROW_H);
-}
-
-/** A node's html-content tree node (the shape the renderer's html layer eats). */
-export interface HtmlNode {
-  tag: string;
-  className?: string;
-  text?: string;
-  children?: HtmlNode[];
-}
-
-/**
- * The `.axk-entity` content tree — the SAME tree er.ts ships and update.ts
- * regenerates. `editable` adds the delete control per row and the trailing add
- * affordance.
- */
-export function entityCardContent(entity: ErEntitySpec, editable = false): HtmlNode {
-  const rows: HtmlNode[] = entity.columns.map((c) => {
-    const children: HtmlNode[] = [
-      { tag: 'span', className: 'axk-key' + (c.fk ? ' axk-fk' : ''), text: c.pk ? 'PK' : c.fk ? 'FK' : '' },
-      { tag: 'span', className: 'axk-col', text: c.name },
-      { tag: 'span', className: 'axk-ty', text: c.type ?? '' },
-    ];
-    // The delete control is a real child so it survives re-renders (the card is
-    // regenerated wholesale on every edit) and hover-reveals via CSS only.
-    if (editable) children.push({ tag: 'span', className: 'axk-col-del', text: '×' });
-    return { tag: 'div', className: 'axk-row' + (c.pk ? ' axk-pk' : ''), children };
-  });
-
-  const body: HtmlNode = {
-    // Scroll is OPT-IN via an explicit height: an auto-sized card fits by
-    // construction and must never trap the wheel, not even by a pixel.
-    tag: 'div',
-    className: entity.height != null ? 'axk-entity-body axk-scroll' : 'axk-entity-body',
-    children: rows,
-  };
-
-  const children: HtmlNode[] = [
-    { tag: 'div', className: 'axk-entity-head', text: entity.name ?? entity.id },
-    body,
-  ];
-  // The affordance sits OUTSIDE the (scrollable) body so it is always reachable.
-  if (editable) children.push({ tag: 'div', className: 'axk-entity-add', text: '＋ add column' });
-
-  return { tag: 'div', className: 'axk-entity', children };
-}
-
-/** Card height for an entity — explicit height wins, else derived from columns. */
-export function entityAutoHeight(entity: ErEntitySpec, editable = false): number {
-  if (entity.height != null) return entity.height;
-  return ER_HEAD_H + entity.columns.length * ER_ROW_H + ER_BORDER_SLACK + (editable ? ER_ADD_H : 0);
-}
-
-/**
- * The `.axk-uml` content tree. `editable` adds a delete control per member and
- * a trailing add affordance in each compartment.
- */
-export function classCardContent(cls: UmlClassSpec, editable = false): HtmlNode {
-  const attrs = cls.attributes ?? [];
-  const methods = cls.methods ?? [];
-  const italic = cls.abstract || cls.stereotype === 'abstract' || cls.stereotype === 'interface';
-
-  // Non-editable output stays BYTE-IDENTICAL to the pre-editing builder (a
-  // member is a text div); editable additions are purely additive.
-  const member = (text: string): HtmlNode =>
-    editable
-      ? {
-          tag: 'div',
-          className: 'axk-member',
-          children: [
-            { tag: 'span', className: 'axk-mtext', text },
-            { tag: 'span', className: 'axk-col-del', text: '×' },
-          ],
-        }
-      : { tag: 'div', className: 'axk-member', text };
-
-  const compartment = (members: string[], section: 'attributes' | 'methods'): HtmlNode => {
-    const children: HtmlNode[] = members.map(member);
-    if (editable) {
-      children.push({
-        tag: 'div',
-        className: 'axk-uml-add',
-        text: section === 'attributes' ? '＋ attribute' : '＋ method',
-      });
-    }
-    return {
-      tag: 'div',
-      className: 'axk-uml-comp' + (members.length ? '' : ' axk-empty'),
-      children,
-    };
-  };
-
-  const name: HtmlNode = {
-    tag: 'div',
-    className: 'axk-uml-name' + (italic ? ' axk-abstract' : ''),
-    children: [
-      ...(cls.stereotype ? [{ tag: 'span', className: 'axk-uml-stereo', text: `«${cls.stereotype}»` } as HtmlNode] : []),
-      { tag: 'span', text: cls.name ?? cls.id },
-    ],
-  };
-
-  return {
-    tag: 'div',
-    className: 'axk-uml',
-    children: [
-      name,
-      {
-        tag: 'div',
-        className: cls.height != null ? 'axk-uml-body axk-scroll' : 'axk-uml-body',
-        children: [compartment(attrs, 'attributes'), compartment(methods, 'methods')],
-      },
-    ],
-  };
-}
-
-/** Card height for a class — explicit height wins, else derived from members. */
-export function classAutoHeight(cls: UmlClassSpec, editable = false): number {
-  if (cls.height != null) return cls.height;
-  const attrs = cls.attributes ?? [];
-  const methods = cls.methods ?? [];
-  const addRows = editable ? 2 : 0; // one "add" affordance per compartment
-  return (
-    UML_NAME_H +
-    (cls.stereotype ? UML_STEREO_H : 0) +
-    (attrs.length + methods.length + addRows) * UML_LINE_H +
-    UML_PAD * 2 +
-    12
-  );
-}
-
-/**
- * Match old columns to new columns for port reconciliation. Returns a map from
- * OLD index → NEW index; an old index absent from the map is a REMOVED column
- * (its pinned ports and their edges are dropped).
- *
- * Three passes, most-certain first, so a single edit is always read the way a
- * human means it:
- *   1. object identity — reorder / add / remove that preserved references;
- *   2. name — a retype (same name, new object) or a rebuilt array;
- *   3. positional remainder — the leftovers matched in order, which is exactly
- *      what a rename is (one old + one new in the same slot). Without pass 3 a
- *      rename reads as remove+add and the edge is severed.
- */
-export function matchColumns(oldCols: ErColumn[], newCols: ErColumn[]): Map<number, number> {
-  const out = new Map<number, number>();
-  const usedNew = new Set<number>();
-  const matchedOld = new Set<number>();
-
-  const claim = (oldIdx: number, newIdx: number) => {
-    out.set(oldIdx, newIdx);
-    usedNew.add(newIdx);
-    matchedOld.add(oldIdx);
-  };
-
-  // Pass 1: object identity.
-  oldCols.forEach((oc, oi) => {
-    const ni = newCols.indexOf(oc);
-    if (ni !== -1 && !usedNew.has(ni)) claim(oi, ni);
-  });
-  // Pass 2: by name, among the unmatched.
-  oldCols.forEach((oc, oi) => {
-    if (matchedOld.has(oi)) return;
-    const ni = newCols.findIndex((nc, i) => !usedNew.has(i) && nc.name === oc.name);
-    if (ni !== -1) claim(oi, ni);
-  });
-  // Pass 3: positional remainder (rename / retype-and-rename).
-  const remOld = oldCols.map((_, i) => i).filter((i) => !matchedOld.has(i));
-  const remNew = newCols.map((_, i) => i).filter((i) => !usedNew.has(i));
-  const n = Math.min(remOld.length, remNew.length);
-  for (let k = 0; k < n; k++) claim(remOld[k]!, remNew[k]!);
-
-  return out;
-}

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

@@ -1,465 +0,0 @@
-/**
- * Diagram kit — reusable ER / UML builders (the packaged form of what the
- * diagrams/* demos hand-composed).
- *
- * The demos proved the CAPABILITY (HTML table/class cards, crow's-foot and UML
- * markers, field-level ports, clean routing, card-ring selection) but every
- * page re-implemented it. This kit is the reusable feature: typed builders
- * that emit a ready render() spec + one injected stylesheet, so an embedder
- * writes data, not plumbing.
- */
-import { erDiagram, ER_ROW_H, ER_HEAD_H } from './er';
-import { umlDiagram } from './uml';
-import { DIAGRAM_KIT_STYLE_ID, ensureDiagramKitStyles } from './styles';
-
-const CUSTOMER = {
-  id: 'CUSTOMER',
-  name: 'Customer',
-  columns: [
-    { name: 'id', type: 'int', pk: true },
-    { name: 'name', type: 'varchar' },
-    { name: 'email', type: 'varchar' },
-  ],
-};
-const ORDER = {
-  id: 'ORDER',
-  name: 'Order',
-  columns: [
-    { name: 'id', type: 'int', pk: true },
-    { name: 'customer_id', type: 'int', fk: true },
-  ],
-};
-
-const findNode = (spec: { nodes: Array<{ id?: string }> }, id: string) =>
-  spec.nodes.find((n) => n.id === id)! as Record<string, unknown> & {
-    size: { width: number; height: number };
-    metadata: { html: { content: unknown } };
-    ports?: Array<Record<string, unknown>>;
-  };
-const treeText = (tree: unknown): string => JSON.stringify(tree);
-
-afterEach(() => {
-  document.getElementById(DIAGRAM_KIT_STYLE_ID)?.remove();
-});
-
-describe('erDiagram — entities', () => {
-  it('builds an HTML table card per entity: header + one row per column + PK/FK badges', () => {
-    const spec = erDiagram({ entities: [CUSTOMER, ORDER] });
-    expect(spec.nodes).toHaveLength(2);
-    const text = treeText(findNode(spec, 'CUSTOMER').metadata.html.content);
-    expect(text).toContain('Customer');
-    expect(text).toContain('email');
-    expect(text).toContain('varchar');
-    expect(text).toContain('PK');
-    expect(treeText(findNode(spec, 'ORDER').metadata.html.content)).toContain('FK');
-    // Kit-scoped class names, never the demo's.
-    expect(text).toContain('axk-entity');
-  });
-
-  it('sizes the card from its column count (slack covers wrapper padding + borders)', () => {
-    const spec = erDiagram({ entities: [CUSTOMER] });
-    expect(findNode(spec, 'CUSTOMER').size.height).toBe(ER_HEAD_H + 3 * ER_ROW_H + 9);
-  });
-
-  it("hides the node's own rectangle so the card's border is the only border", () => {
-    const node = findNode(erDiagram({ entities: [CUSTOMER] }), 'CUSTOMER');
-    expect((node['shape'] as { fill?: string }).fill).toBe('none');
-    expect((node['style'] as { stroke?: string }).stroke).toBe('transparent');
-  });
-
-  it('lays entities on a default grid when positions are omitted, and respects explicit ones', () => {
-    const spec = erDiagram({ entities: [CUSTOMER, { ...ORDER, position: { x: 900, y: 40 } }] });
-    const a = findNode(spec, 'CUSTOMER')['position'] as { x: number; y: number };
-    const b = findNode(spec, 'ORDER')['position'] as { x: number; y: number };
-    expect(typeof a.x).toBe('number');
-    expect(b).toEqual({ x: 900, y: 40 });
-    expect(a.x).not.toBe(b.x);
-  });
-});
-
-describe('scrollable cards (many fields + user resize)', () => {
-  it('wraps the entity rows in a body region; scroll is OPT-IN via explicit height', () => {
-    const auto = erDiagram({ entities: [CUSTOMER] });
-    const autoText = treeText(findNode(auto, 'CUSTOMER').metadata.html.content);
-    expect(autoText).toContain('axk-entity-body');
-    // An auto-sized card fits by construction — it must never trap the wheel.
-    expect(autoText).not.toContain('axk-scroll');
-    const fixed = erDiagram({ entities: [{ ...CUSTOMER, height: 160 }] });
-    expect(treeText(findNode(fixed, 'CUSTOMER').metadata.html.content)).toContain('axk-scroll');
-  });
-
-  it('an explicit entity height wins over the computed one (fixed height → the body scrolls)', () => {
-    const spec = erDiagram({ entities: [{ ...CUSTOMER, height: 160 }] });
-    expect(findNode(spec, 'CUSTOMER').size.height).toBe(160);
-  });
-
-  it('wraps the uml compartments in a body region, honours explicit height, and gates scroll on it', () => {
-    const fixed = umlDiagram({
-      classes: [{ id: 'Big', attributes: ['+ a: int'], methods: ['+ m(): void'], height: 140 }],
-      relationships: [],
-    });
-    const fixedText = treeText(findNode(fixed, 'Big').metadata.html.content);
-    expect(fixedText).toContain('axk-uml-body');
-    expect(fixedText).toContain('axk-scroll');
-    expect(findNode(fixed, 'Big').size.height).toBe(140);
-    const auto = umlDiagram({ classes: [{ id: 'Small', attributes: ['+ a: int'] }], relationships: [] });
-    expect(treeText(findNode(auto, 'Small').metadata.html.content)).not.toContain('axk-scroll');
-  });
-
-  it('the kit stylesheet scrolls ONLY the opted-in body regions', () => {
-    ensureDiagramKitStyles();
-    const css = document.getElementById(DIAGRAM_KIT_STYLE_ID)!.textContent || '';
-    expect(css).toMatch(/\.axk-entity-body\.axk-scroll[^}]*overflow-y:\s*auto/);
-    expect(css).toMatch(/\.axk-uml-body\.axk-scroll[^}]*overflow-y:\s*auto/);
-    // The un-opted body clips: auto-height cards never show a scrollbar.
-    expect(css).toMatch(/\.axk-entity-body\s*\{[^}]*overflow-y:\s*hidden/);
-    expect(css).toMatch(/\.axk-uml-body\s*\{[^}]*overflow-y:\s*hidden/);
-  });
-});
-
-describe('erDiagram — relationships', () => {
-  it('defaults to one-to-many: a "one" tail and a crow-foot head, orthogonal, side handles', () => {
-    const spec = erDiagram({
-      entities: [CUSTOMER, ORDER],
-      relationships: [{ from: 'CUSTOMER', to: 'ORDER', label: 'places' }],
-    });
-    expect(spec.edges).toHaveLength(1);
-    const e = spec.edges[0] as any;
-    expect(e.type).toBe('orthogonal');
-    expect(e.label).toBe('places');
-    expect(e.sourceHandle).toBe('right');
-    expect(e.targetHandle).toBe('left');
-    expect(e.style.arrowTail.type).toBe('one');
-    expect(e.style.arrowHead.type).toBe('crow-foot');
-  });
-
-  it.each([
-    ['one-to-one', 'one', 'one'],
-    ['many-to-many', 'crow-foot', 'crow-foot'],
-    ['one-to-zero-or-many', 'one', 'zero-or-many'],
-    ['one-to-one-or-many', 'one', 'one-or-many'],
-  ] as const)('cardinality %s → tail %s / head %s', (cardinality, tail, head) => {
-    const spec = erDiagram({
-      entities: [CUSTOMER, ORDER],
-      relationships: [{ from: 'CUSTOMER', to: 'ORDER', cardinality }],
-    });
-    const e = spec.edges[0] as any;
-    expect(e.style.arrowTail.type).toBe(tail);
-    expect(e.style.arrowHead.type).toBe(head);
-  });
-
-  it('FIELD-LEVEL: "TABLE.column" pins an absolute-layout port on that row and wires the handle to it', () => {
-    const spec = erDiagram({
-      entities: [CUSTOMER, ORDER],
-      relationships: [{ from: 'ORDER.customer_id', to: 'CUSTOMER.id' }],
-    });
-    const e = spec.edges[0] as any;
-    const order = findNode(spec, 'ORDER');
-    const customer = findNode(spec, 'CUSTOMER');
-    const orderPort = (order.ports ?? []).find((p) => p['id'] === e.sourceHandle) as any;
-    const customerPort = (customer.ports ?? []).find((p) => p['id'] === e.targetHandle) as any;
-    expect(orderPort).toBeTruthy();
-    expect(customerPort).toBeTruthy();
-    expect(orderPort.layout.strategy).toBe('absolute');
-    // customer_id is row index 1; id is row index 0 — pinned at each row's centre.
-    expect(orderPort.layout.args.y).toBe(ER_HEAD_H + 1 * ER_ROW_H + ER_ROW_H / 2 + 1);
-    expect(customerPort.layout.args.y).toBe(ER_HEAD_H + 0 * ER_ROW_H + ER_ROW_H / 2 + 1);
-    // exit directions follow the default sides
-    expect(orderPort.side).toBe('right');
-    expect(customerPort.side).toBe('left');
-  });
-
-  it('two relationships landing on the SAME column get spread apart, not stacked', () => {
-    const WAREHOUSE = { id: 'WAREHOUSE', columns: [{ name: 'id', type: 'int', pk: true }] };
-    const SHIPMENT = {
-      id: 'SHIPMENT',
-      columns: [
-        { name: 'from_warehouse_id', type: 'int', fk: true },
-        { name: 'to_warehouse_id', type: 'int', fk: true },
-      ],
-    };
-    const spec = erDiagram({
-      entities: [WAREHOUSE, SHIPMENT],
-      relationships: [
-        { from: 'SHIPMENT.from_warehouse_id', to: 'WAREHOUSE.id' },
-        { from: 'SHIPMENT.to_warehouse_id', to: 'WAREHOUSE.id' },
-      ],
-    });
-    const wh = findNode(spec, 'WAREHOUSE');
-    const pkPorts = (wh.ports ?? []).filter(
-      (p) => (p as any).layout?.strategy === 'absolute'
-    ) as any[];
-    expect(pkPorts).toHaveLength(2);
-    const dys = pkPorts.map((p) => p.layout.args.dy ?? 0);
-    expect(dys[0]).not.toBe(dys[1]);
-  });
-
-  it('throws on an unknown column so a typo cannot silently fall back to table-level', () => {
-    expect(() =>
-      erDiagram({
-        entities: [CUSTOMER, ORDER],
-        relationships: [{ from: 'ORDER.nope', to: 'CUSTOMER.id' }],
-      })
-    ).toThrow(/nope/);
-  });
-});
-
-describe('umlDiagram', () => {
-  const SHAPE = { id: 'Shape', abstract: true, attributes: ['# x: float'], methods: ['+ area(): float'] };
-  const CIRCLE = { id: 'Circle', attributes: ['+ r: float'], methods: [] };
-
-  it('builds three-compartment class cards, with stereotype and abstract styling', () => {
-    const spec = umlDiagram({
-      classes: [{ ...SHAPE, stereotype: 'abstract' }, CIRCLE],
-      relationships: [],
-    });
-    const text = treeText(findNode(spec, 'Shape').metadata.html.content);
-    expect(text).toContain('axk-uml');
-    expect(text).toContain('«abstract»');
-    expect(text).toContain('# x: float');
-    expect(text).toContain('+ area(): float');
-  });
-
-  it.each([
-    // kind, dashed?, head type, tail type, filled diamond?
-    ['inheritance', false, 'generalization', 'none', false],
-    ['realization', true, 'generalization', 'none', false],
-    ['association', false, 'none', 'none', false],
-    ['directed-association', false, 'open-arrow', 'none', false],
-    ['aggregation', false, 'none', 'hollow-diamond', false],
-    ['composition', false, 'none', 'filled-diamond', true],
-    ['dependency', true, 'open-arrow', 'none', false],
-  ] as const)('%s → dashed=%s head=%s tail=%s', (kind, dashed, head, tail, filled) => {
-    const spec = umlDiagram({
-      classes: [SHAPE, CIRCLE],
-      relationships: [{ from: 'Circle', to: 'Shape', kind }],
-    });
-    const e = spec.edges[0] as any;
-    expect(!!e.style.strokeDasharray).toBe(dashed);
-    expect((e.style.arrowHead?.type ?? 'none')).toBe(head);
-    expect((e.style.arrowTail?.type ?? 'none')).toBe(tail);
-    if (tail === 'filled-diamond') expect(e.style.arrowTail.filled).toBe(filled);
-    // The stray-default-arrowhead regression: a plain association must
-    // EXPLICITLY carry arrowHead none, or the renderer paints a default arrow.
-    if (kind === 'association') expect(e.style.arrowHead?.type).toBe('none');
-  });
-
-  it('multiplicity rides finalize(api): chips are added as positioned labels after render', () => {
-    const spec = umlDiagram({
-      classes: [SHAPE, CIRCLE],
-      relationships: [{ from: 'Circle', to: 'Shape', kind: 'association', multiplicity: ['0..*', '1'] }],
-    });
-    const added: Array<Record<string, unknown>> = [];
-    const fakeApi = {
-      getModel: () => ({
-        getLink: (id: string) =>
-          id === (spec.edges[0] as any).id
-            ? { addLabel: (l: Record<string, unknown>) => added.push(l) }
-            : null,
-      }),
-      renderNow: () => undefined,
-    };
-    spec.finalize(fakeApi as never);
-    expect(added).toHaveLength(2);
-    expect(treeText(added)).toContain('0..*');
-    expect(treeText(added)).toContain('1');
-  });
-});
-
-describe('kit stylesheet', () => {
-  it('is injected once, idempotently, with kit-scoped classes and the card-ring selection rules', () => {
-    ensureDiagramKitStyles();
-    ensureDiagramKitStyles();
-    const styles = document.querySelectorAll(`#${DIAGRAM_KIT_STYLE_ID}`);
-    expect(styles).toHaveLength(1);
-    const css = styles[0].textContent || '';
-    expect(css).toContain('.axk-entity');
-    expect(css).toContain('.axk-uml');
-    // Selection highlights the CARD, not a detached rectangle — scoped with
-    // :has() so it never affects non-kit nodes.
-    expect(css).toContain(':has(.axk-entity)');
-    expect(css).toContain('selection-highlight');
-    expect(css).toContain('data-selected');
-  });
-
-  it('building a diagram injects the stylesheet automatically', () => {
-    erDiagram({ entities: [CUSTOMER] });
-    expect(document.getElementById(DIAGRAM_KIT_STYLE_ID)).toBeTruthy();
-  });
-});
-
-describe('row selection (P1: select a column / field)', () => {
-  /** Build the DOM shape the renderer produces for a kit card, in jsdom. */
-  function mountCard(container: HTMLElement, nodeId: string, rows: string[][], kind: 'er' | 'uml' = 'er') {
-    const svg = container.querySelector('svg') ?? container.appendChild(document.createElementNS('http://www.w3.org/2000/svg', 'svg'));
-    const g = document.createElementNS('http://www.w3.org/2000/svg', 'g');
-    g.setAttribute('data-node-id', nodeId);
-    g.classList.add('node-group');
-    const fo = document.createElementNS('http://www.w3.org/2000/svg', 'foreignObject');
-    const wrapper = document.createElement('div');
-    const card = document.createElement('div');
-    card.className = kind === 'er' ? 'axk-entity' : 'axk-uml';
-    const body = document.createElement('div');
-    body.className = kind === 'er' ? 'axk-entity-body' : 'axk-uml-body';
-    for (const cells of rows) {
-      const row = document.createElement('div');
-      row.className = kind === 'er' ? 'axk-row' : 'axk-member';
-      for (const [cls, text] of cells.map((t, i) => [['axk-key', 'axk-col', 'axk-ty'][i] ?? 'axk-x', t] as const)) {
-        const span = document.createElement('span');
-        span.className = cls;
-        span.textContent = text;
-        row.appendChild(span);
-      }
-      body.appendChild(row);
-    }
-    card.appendChild(body);
-    wrapper.appendChild(card);
-    fo.appendChild(wrapper);
-    g.appendChild(fo);
-    svg.appendChild(g);
-    return { g, body };
-  }
-
-  const fakeApi = (container: HTMLElement, metaByNode: Record<string, Record<string, unknown>> = {}) => ({
-    container,
-    getModel: () => ({
-      getNode: (id: string) => (id in metaByNode ? { getMetadata: (k: string) => metaByNode[id][k] } : undefined),
-    }),
-  });
-
-  let container: HTMLElement;
-  beforeEach(() => {
-    container = document.createElement('div');
-    document.body.appendChild(container);
-  });
-
-  it('kit cards are interactive and carry their spec in metadata (rows can be real event targets)', () => {
-    const spec = erDiagram({ entities: [CUSTOMER] });
-    const node = findNode(spec, 'CUSTOMER') as any;
-    expect(node.metadata.html.interactive).toBe(true);
-    expect(node.metadata.kitEntity.columns.map((c: any) => c.name)).toEqual(['id', 'name', 'email']);
-    const uml = umlDiagram({ classes: [{ id: 'A', attributes: ['+ x: int'], methods: ['+ m(): void'] }], relationships: [] });
-    const cls = findNode(uml, 'A') as any;
-    expect(cls.metadata.html.interactive).toBe(true);
-    expect(cls.metadata.kitClass.attributes).toEqual(['+ x: int']);
-  });
-
-  it('clicking a row selects it: class applied, axk:row-select fired with node/row/name', async () => {
-    const { bindRowInteractions } = await import('./rows');
-    mountCard(container, 'ORDER', [['PK', 'id', 'int'], ['FK', 'customer_id', 'int']]);
-    const api = fakeApi(container, { ORDER: { kitEntity: { columns: [{ name: 'id' }, { name: 'customer_id' }] } } });
-    const events: any[] = [];
-    container.addEventListener('axk:row-select', (e: any) => events.push(e.detail));
-    const handle = bindRowInteractions(api as never);
-    const row1 = container.querySelectorAll('.axk-row')[1] as HTMLElement;
-    row1.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    expect(row1.classList.contains('axk-row-selected')).toBe(true);
-    expect(handle.getSelected()).toMatchObject({ nodeId: 'ORDER', rowIndex: 1, name: 'customer_id' });
-    expect(events.at(-1).selected).toMatchObject({ nodeId: 'ORDER', rowIndex: 1, name: 'customer_id' });
-    handle.dispose();
-  });
-
-  it('clicking the selected row again, or empty canvas, deselects', async () => {
-    const { bindRowInteractions } = await import('./rows');
-    mountCard(container, 'ORDER', [['PK', 'id', 'int']]);
-    const api = fakeApi(container);
-    const handle = bindRowInteractions(api as never);
-    const row = container.querySelector('.axk-row') as HTMLElement;
-    row.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    expect(handle.getSelected()).not.toBeNull();
-    row.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    expect(handle.getSelected()).toBeNull();
-    expect(row.classList.contains('axk-row-selected')).toBe(false);
-    row.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    container.dispatchEvent(new MouseEvent('click', { bubbles: true })); // empty canvas
-    expect(handle.getSelected()).toBeNull();
-    handle.dispose();
-  });
-
-  it('only one row is selected per diagram — selecting in another card moves the selection', async () => {
-    const { bindRowInteractions } = await import('./rows');
-    mountCard(container, 'A', [['PK', 'id', 'int']]);
-    mountCard(container, 'B', [['PK', 'id', 'int']]);
-    const handle = bindRowInteractions(fakeApi(container) as never);
-    const [rowA, rowB] = Array.from(container.querySelectorAll('.axk-row')) as HTMLElement[];
-    rowA.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    rowB.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    expect(rowA.classList.contains('axk-row-selected')).toBe(false);
-    expect(rowB.classList.contains('axk-row-selected')).toBe(true);
-    expect(handle.getSelected()?.nodeId).toBe('B');
-    handle.dispose();
-  });
-
-  it('uml members resolve with their section (attributes vs methods)', async () => {
-    const { bindRowInteractions } = await import('./rows');
-    // uml card: two compartments, members across both — rowIndex is global.
-    const svg = container.appendChild(document.createElementNS('http://www.w3.org/2000/svg', 'svg'));
-    const g = document.createElementNS('http://www.w3.org/2000/svg', 'g');
-    g.setAttribute('data-node-id', 'K');
-    const card = document.createElement('div');
-    card.className = 'axk-uml';
-    for (const members of [['+ a: int', '+ b: int'], ['+ m(): void']]) {
-      const comp = document.createElement('div');
-      comp.className = 'axk-uml-comp';
-      for (const text of members) {
-        const m = document.createElement('div');
-        m.className = 'axk-member';
-        m.textContent = text;
-        comp.appendChild(m);
-      }
-      card.appendChild(comp);
-    }
-    g.appendChild(card);
-    svg.appendChild(g);
-    const handle = bindRowInteractions(fakeApi(container, { K: { kitClass: { attributes: ['+ a: int', '+ b: int'], methods: ['+ m(): void'] } } }) as never);
-    const members = Array.from(container.querySelectorAll('.axk-member')) as HTMLElement[];
-    members[2].dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    expect(handle.getSelected()).toMatchObject({ nodeId: 'K', rowIndex: 2, section: 'methods', name: '+ m(): void' });
-    handle.dispose();
-  });
-
-  it('selection survives a card re-render (the foreignObject subtree is replaced)', async () => {
-    const { bindRowInteractions } = await import('./rows');
-    const { g } = mountCard(container, 'ORDER', [['PK', 'id', 'int'], ['FK', 'customer_id', 'int']]);
-    const handle = bindRowInteractions(fakeApi(container) as never);
-    const row1 = container.querySelectorAll('.axk-row')[1] as HTMLElement;
-    row1.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    // Simulate the renderer swapping the subtree (content-hash keyed re-render).
-    const fo = g.querySelector('foreignObject')!;
-    g.removeChild(fo);
-    mountCard(container, 'ORDER-tmp', [['x', 'x', 'x']]); // unrelated churn
-    g.appendChild(fo.cloneNode(true)); // fresh subtree, no classes... clone keeps class
-    (g.querySelectorAll('.axk-row')[1] as HTMLElement).classList.remove('axk-row-selected');
-    await new Promise((r) => setTimeout(r, 30)); // let the MutationObserver run
-    const fresh = g.querySelectorAll('.axk-row')[1] as HTMLElement;
-    expect(fresh.classList.contains('axk-row-selected')).toBe(true);
-    expect(handle.getSelected()).toMatchObject({ nodeId: 'ORDER', rowIndex: 1 });
-    handle.dispose();
-  });
-
-  it('the kit stylesheet ships row hover + selected styles and suppresses text selection', () => {
-    ensureDiagramKitStyles();
-    const css = document.getElementById(DIAGRAM_KIT_STYLE_ID)!.textContent || '';
-    expect(css).toMatch(/\.axk-row:hover/);
-    expect(css).toMatch(/\.axk-member:hover/);
-    expect(css).toMatch(/\.axk-row-selected/);
-    expect(css).toMatch(/user-select:\s*none/);
-  });
-
-  it('erDiagram finalize binds row interactions against a live-ish api (and rowSelection:false opts out)', async () => {
-    const spec = erDiagram({ entities: [CUSTOMER] });
-    mountCard(container, 'CUSTOMER', [['PK', 'id', 'int'], ['', 'name', 'varchar'], ['', 'email', 'varchar']]);
-    const api = { ...fakeApi(container, { CUSTOMER: { kitEntity: CUSTOMER } }), getModel: fakeApi(container, { CUSTOMER: { kitEntity: CUSTOMER } }).getModel };
-    spec.finalize(api as never);
-    const row = container.querySelectorAll('.axk-row')[2] as HTMLElement;
-    row.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    expect(row.classList.contains('axk-row-selected')).toBe(true);
-    const off = erDiagram({ entities: [CUSTOMER], rowSelection: false });
-    const container2 = document.body.appendChild(document.createElement('div'));
-    mountCard(container2, 'CUSTOMER', [['PK', 'id', 'int']]);
-    off.finalize(fakeApi(container2, {}) as never);
-    const row2 = container2.querySelector('.axk-row') as HTMLElement;
-    row2.dispatchEvent(new MouseEvent('click', { bubbles: true }));
-    expect(row2.classList.contains('axk-row-selected')).toBe(false);
-  });
-});