Skip to content

AI-native design editor. Open-source Figma alternative.

13.3 KB
Raw Blame
import { describe, expect, test } from 'bun:test'

import { SceneGraph } from '@open-pencil/scene-graph'

import { expectDefined, getNodeOrThrow } from '#tests/helpers/assert'
import { SOLID_FILL } from '#tests/helpers/scene'

function pageId(graph: SceneGraph) {
  return graph.getPages()[0].id
}

describe('hitTest — group behavior', () => {
  function setup() {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const group = graph.createNode('GROUP', page, {
      name: 'Group',
      x: 100,
      y: 100,
      width: 200,
      height: 200
    })
    const child = graph.createNode('RECTANGLE', group.id, {
      fills: [SOLID_FILL],
      name: 'Rect',
      x: 10,
      y: 10,
      width: 50,
      height: 50
    })
    return { graph, page, group, child }
  }

  test('single click on child returns GROUP (not child)', () => {
    const { graph, page } = setup()
    const hit = graph.hitTest(110, 110, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').type).toBe('GROUP')
  })

  test('hitTestDeep on child returns child directly', () => {
    const { graph, page, child } = setup()
    const hit = graph.hitTestDeep(110, 110, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').id).toBe(child.id)
  })

  test('hitTest with scope=group returns child', () => {
    const { graph, group } = setup()
    const hit = graph.hitTest(110, 110, group.id)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('Rect')
  })

  test('hitTest miss inside group returns null', () => {
    const { graph, group } = setup()
    const hit = graph.hitTest(180, 180, group.id)
    expect(hit).toBeNull()
  })

  test('click outside group returns null', () => {
    const { graph, page } = setup()
    const hit = graph.hitTest(50, 50, page)
    expect(hit).toBeNull()
  })
})

describe('hitTest — nested groups', () => {
  function setup() {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const groupA = graph.createNode('GROUP', page, {
      name: 'GroupA',
      x: 100,
      y: 100,
      width: 300,
      height: 300
    })
    const groupB = graph.createNode('GROUP', groupA.id, {
      name: 'GroupB',
      x: 50,
      y: 50,
      width: 100,
      height: 100
    })
    const rect = graph.createNode('RECTANGLE', groupB.id, {
      fills: [SOLID_FILL],
      name: 'DeepRect',
      x: 10,
      y: 10,
      width: 30,
      height: 30
    })
    return { graph, page, groupA, groupB, rect }
  }

  test('click from page scope returns GroupA', () => {
    const { graph, page } = setup()
    // On the rectangle: a group has no area of its own, so its empty corner takes no click.
    const hit = graph.hitTest(175, 175, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('GroupA')
    expect(graph.hitTest(100, 100, page)).toBeNull()
  })

  test('click with scope=GroupA returns GroupB', () => {
    const { graph, groupA } = setup()
    const hit = graph.hitTest(175, 175, groupA.id)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('GroupB')
    expect(graph.hitTest(150, 150, groupA.id)).toBeNull()
  })

  test('click with scope=GroupB returns DeepRect', () => {
    const { graph, groupB } = setup()
    const hit = graph.hitTest(160, 160, groupB.id)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('DeepRect')
  })

  test('hitTestDeep from page returns deepest child', () => {
    const { graph, page, rect } = setup()
    const hit = graph.hitTestDeep(160, 160, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').id).toBe(rect.id)
  })
})

describe('hitTest — locked nodes', () => {
  test('locked container blocks enter (returns container, not child)', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const frame = graph.createNode('FRAME', page, {
      name: 'LockedFrame',
      x: 0,
      y: 0,
      width: 200,
      height: 200,
      locked: true
    })
    graph.createNode('RECTANGLE', frame.id, {
      fills: [SOLID_FILL],
      name: 'Child',
      x: 10,
      y: 10,
      width: 50,
      height: 50
    })

    const hit = graph.hitTestDeep(10, 10, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('LockedFrame')
  })

  test('locked leaf node is still clickable', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    graph.createNode('RECTANGLE', page, {
      fills: [SOLID_FILL],
      name: 'LockedRect',
      x: 0,
      y: 0,
      width: 50,
      height: 50,
      locked: true
    })

    const hit = graph.hitTest(25, 25, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('LockedRect')
  })
})

describe('hitTest — visibility', () => {
  test('invisible node is not hit', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    graph.createNode('RECTANGLE', page, {
      fills: [SOLID_FILL],
      name: 'Hidden',
      x: 0,
      y: 0,
      width: 50,
      height: 50,
      visible: false
    })

    const hit = graph.hitTest(25, 25, page)
    expect(hit).toBeNull()
  })
})

describe('scene graph — locked node operations', () => {
  test('locked node cannot be deleted via filter', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const rect = graph.createNode('RECTANGLE', page, {
      fills: [SOLID_FILL],
      name: 'LockedRect',
      x: 0,
      y: 0,
      width: 50,
      height: 50,
      locked: true
    })

    const node = graph.getNode(rect.id)
    expect(node).not.toBeNull()
    expect(expectDefined(node, 'node').locked).toBe(true)
  })

  test('lock can be toggled', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const rect = graph.createNode('RECTANGLE', page, {
      fills: [SOLID_FILL],
      name: 'Rect',
      x: 0,
      y: 0,
      width: 50,
      height: 50
    })

    expect(getNodeOrThrow(graph, rect.id).locked).toBe(false)
    graph.updateNode(rect.id, { locked: true })
    expect(getNodeOrThrow(graph, rect.id).locked).toBe(true)
    graph.updateNode(rect.id, { locked: false })
    expect(getNodeOrThrow(graph, rect.id).locked).toBe(false)
  })

  test('visibility can be toggled', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const rect = graph.createNode('RECTANGLE', page, {
      fills: [SOLID_FILL],
      name: 'Rect',
      x: 0,
      y: 0,
      width: 50,
      height: 50
    })

    expect(getNodeOrThrow(graph, rect.id).visible).toBe(true)
    graph.updateNode(rect.id, { visible: false })
    expect(getNodeOrThrow(graph, rect.id).visible).toBe(false)
    graph.updateNode(rect.id, { visible: true })
    expect(getNodeOrThrow(graph, rect.id).visible).toBe(true)
  })
})

describe('hitTest — frame with children', () => {
  test('frame scope hit test finds children', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const frame = graph.createNode('FRAME', page, {
      name: 'Frame',
      x: 50,
      y: 50,
      width: 200,
      height: 200
    })
    const child = graph.createNode('RECTANGLE', frame.id, {
      fills: [SOLID_FILL],
      name: 'InnerRect',
      x: 20,
      y: 20,
      width: 40,
      height: 40
    })

    const hit = graph.hitTest(70, 70, frame.id)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').id).toBe(child.id)
  })

  test('rotated frame scope hit test finds children using rotated local bounds', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const frame = graph.createNode('FRAME', page, {
      name: 'RotatedFrame',
      x: 100,
      y: 100,
      width: 200,
      height: 120,
      rotation: 45
    })
    const child = graph.createNode('RECTANGLE', frame.id, {
      fills: [SOLID_FILL],
      name: 'InnerRect',
      x: 60,
      y: 30,
      width: 80,
      height: 40
    })

    // point that is inside rotated frame bounds and child bounds
    const hitInside = graph.hitTest(193, 111, frame.id)
    expect(hitInside).not.toBeNull()
    expect(expectDefined(hitInside, 'inside hit node').id).toBe(child.id)

    // point that would be inside if frame were not rotated
    const hitOutside = graph.hitTest(160, 130, frame.id)
    expect(hitOutside).toBeNull()
  })

  test('cached absolute positions refresh after preview flips and reparenting', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const left = graph.createNode('FRAME', page, { x: 100, y: 100, width: 200, height: 100 })
    const right = graph.createNode('FRAME', page, { x: 400, y: 100, width: 200, height: 100 })
    const child = graph.createNode('RECTANGLE', left.id, {
      fills: [SOLID_FILL],
      x: 20,
      y: 20,
      width: 40,
      height: 40
    })

    expect(graph.hitTest(130, 130, left.id)?.id).toBe(child.id)
    graph.updateNodePreview(left.id, { flipX: true })
    expect(graph.hitTest(270, 130, left.id)?.id).toBe(child.id)
    expect(graph.hitTest(130, 130, left.id)).toBeNull()

    graph.updateNode(left.id, { flipX: false })
    expect(graph.getAbsolutePosition(child.id)).toEqual({ x: 120, y: 120 })
    graph.insertChildAt(child.id, right.id, 0)
    expect(graph.getAbsolutePosition(child.id)).toEqual({ x: 420, y: 120 })
    expect(graph.hitTest(430, 130, right.id)?.id).toBe(child.id)

    graph.insertChildAt(right.id, child.id, 0)
    expect(right.parentId).toBe(page)
    expect(child.parentId).toBe(right.id)
  })

  test('unrotated child inside a flipped ancestor uses transformed hit testing', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const frame = graph.createNode('FRAME', page, {
      x: 100,
      y: 100,
      width: 200,
      height: 100,
      flipX: true
    })
    const child = graph.createNode('RECTANGLE', frame.id, {
      fills: [SOLID_FILL],
      x: 20,
      y: 20,
      width: 40,
      height: 40
    })

    expect(graph.hitTest(250, 140, frame.id)?.id).toBe(child.id)
    expect(graph.hitTest(130, 140, frame.id)).toBeNull()
  })
})

describe('hitTest — opaque containers (COMPONENT/INSTANCE)', () => {
  test('hitTest on COMPONENT returns component itself (not child)', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const comp = graph.createNode('COMPONENT', page, {
      name: 'MyComp',
      x: 0,
      y: 0,
      width: 100,
      height: 100
    })
    graph.createNode('RECTANGLE', comp.id, {
      fills: [SOLID_FILL],
      name: 'CompChild',
      x: 10,
      y: 10,
      width: 30,
      height: 30
    })

    const hit = graph.hitTest(10, 10, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('MyComp')
  })

  test('hitTestDeep inside COMPONENT scope finds child', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const comp = graph.createNode('COMPONENT', page, {
      name: 'MyComp',
      x: 0,
      y: 0,
      width: 100,
      height: 100
    })
    const child = graph.createNode('RECTANGLE', comp.id, {
      fills: [SOLID_FILL],
      name: 'CompChild',
      x: 10,
      y: 10,
      width: 30,
      height: 30
    })

    const hit = graph.hitTestDeep(10, 10, comp.id)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').id).toBe(child.id)
  })

  test('hitTest on INSTANCE returns instance itself', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const inst = graph.createNode('INSTANCE', page, {
      name: 'MyInstance',
      x: 50,
      y: 50,
      width: 80,
      height: 80
    })
    graph.createNode('RECTANGLE', inst.id, {
      fills: [SOLID_FILL],
      name: 'InstChild',
      x: 5,
      y: 5,
      width: 20,
      height: 20
    })

    const hit = graph.hitTest(55, 55, page)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').name).toBe('MyInstance')
  })

  test('hitTestDeep inside INSTANCE scope finds child', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const inst = graph.createNode('INSTANCE', page, {
      name: 'MyInstance',
      x: 50,
      y: 50,
      width: 80,
      height: 80
    })
    const child = graph.createNode('RECTANGLE', inst.id, {
      fills: [SOLID_FILL],
      name: 'InstChild',
      x: 5,
      y: 5,
      width: 20,
      height: 20
    })

    const hit = graph.hitTestDeep(55, 55, inst.id)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').id).toBe(child.id)
  })
})

describe('hitTest — absolute position and scope offset', () => {
  test('scoped hitTest accounts for parent offset', () => {
    const graph = new SceneGraph()
    const page = pageId(graph)
    const frame = graph.createNode('FRAME', page, {
      name: 'Frame',
      x: 200,
      y: 300,
      width: 400,
      height: 400
    })
    const child = graph.createNode('RECTANGLE', frame.id, {
      fills: [SOLID_FILL],
      name: 'Child',
      x: 50,
      y: 60,
      width: 100,
      height: 100
    })

    const abs = graph.getAbsolutePosition(frame.id)
    expect(abs.x).toBe(200)
    expect(abs.y).toBe(300)
    const abs2 = graph.getAbsolutePosition(child.id)
    expect(abs2.x).toBe(250)
    expect(abs2.y).toBe(360)

    const hit = graph.hitTest(250, 360, frame.id)
    expect(hit).not.toBeNull()
    expect(expectDefined(hit, 'hit node').id).toBe(child.id)

    const missHit = graph.hitTest(50, 60, frame.id)
    expect(missHit).toBeNull()
  })
})