Skip to content

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

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

import { exportFigFile } from '@open-pencil/core/io/formats/fig'
import { parseFigBuffer, materializeDocument } from '@open-pencil/fig'
import { initCodec } from '@open-pencil/kiwi/fig/codec'
import { SceneGraph } from '@open-pencil/scene-graph'

import { uint8ArrayToArrayBuffer } from '#tests/helpers/fig/fixtures'

describe('Figma component property roundtrip', () => {
  beforeAll(async () => {
    await initCodec()
  })

  test('retains OpenPencil library bindings and materialized identity', async () => {
    const graph = new SceneGraph()
    const page = graph.getPages()[0]
    graph.enabledLibraries.set('design-system', {
      libraryId: 'design-system',
      revisionId: 'revision-1',
      enabled: true
    })
    const component = graph.createNode('COMPONENT', page.id, {
      name: 'Remote button',
      componentKey: 'button',
      librarySource: {
        identity: {
          libraryId: 'design-system',
          assetKey: 'button',
          revisionId: 'revision-1'
        },
        sourceNodeId: 'source-button',
        readOnly: true
      }
    })
    component.source.id = '50:1'

    const bytes = await exportFigFile(graph)
    const parsed = parseFigBuffer(uint8ArrayToArrayBuffer(bytes))
    const imported = materializeDocument(parsed.nodeChanges, parsed.blobs).graph
    expect(imported.enabledLibraries.get('design-system')).toEqual({
      libraryId: 'design-system',
      revisionId: 'revision-1',
      enabled: true
    })
    expect(
      [...imported.getAllNodes()].find((node) => node.name === 'Remote button')?.librarySource
    ).toEqual(component.librarySource)
  })

  test('retains authored multidimensional variant definitions and combinations', async () => {
    const graph = new SceneGraph()
    const page = graph.getPages()[0]
    const componentSet = graph.createNode('COMPONENT_SET', page.id, {
      name: 'Button',
      componentPropertyDefinitions: [
        {
          id: '40:1',
          name: 'Type',
          type: 'VARIANT',
          defaultValue: 'Primary',
          variantOptions: ['Primary', 'Secondary']
        },
        {
          id: '40:2',
          name: 'Size',
          type: 'VARIANT',
          defaultValue: 'Small',
          variantOptions: ['Small', 'Large']
        },
        {
          id: '40:3',
          name: 'State',
          type: 'VARIANT',
          defaultValue: 'Enabled',
          variantOptions: ['Enabled', 'Disabled']
        }
      ]
    })
    componentSet.source.id = '40:0'
    const combinations = [
      { Type: 'Primary', Size: 'Small', State: 'Enabled' },
      { Type: 'Primary', Size: 'Large', State: 'Enabled' },
      { Type: 'Secondary', Size: 'Small', State: 'Disabled' }
    ]
    for (const [index, values] of combinations.entries()) {
      const variant = graph.createNode('COMPONENT', componentSet.id, {
        name: Object.entries(values)
          .map(([name, value]) => `${name}=${value}`)
          .join(', '),
        componentPropertyValues: values
      })
      variant.source.id = `40:${index + 10}`
    }

    const bytes = await exportFigFile(graph)
    const parsed = parseFigBuffer(uint8ArrayToArrayBuffer(bytes))
    const imported = materializeDocument(parsed.nodeChanges, parsed.blobs).graph
    const importedSet = [...imported.getAllNodes()].find(
      (node) => node.type === 'COMPONENT_SET' && node.name === 'Button'
    )
    if (!importedSet) throw new Error('Expected imported component set')

    expect(importedSet.componentPropertyDefinitions).toEqual(
      componentSet.componentPropertyDefinitions
    )
    expect(importedSet.childIds.map((id) => imported.getNode(id)?.componentPropertyValues)).toEqual(
      combinations
    )
  })

  test('retains typed definitions, refs, and assignments', async () => {
    const graph = new SceneGraph()
    const page = graph.getPages()[0]
    const component = graph.createNode('COMPONENT', page.id, {
      name: 'Card',
      componentPropertyDefinitions: [
        { id: '30:1', name: 'Label', type: 'TEXT', defaultValue: 'Default' },
        { id: '30:2', name: 'Visible', type: 'BOOLEAN', defaultValue: 'true' }
      ]
    })
    component.source.id = '10:1'
    const label = graph.createNode('TEXT', component.id, {
      name: 'Label',
      text: 'Default',
      componentPropertyReferences: [
        { propertyId: '30:1', field: 'TEXT' },
        { propertyId: '30:2', field: 'VISIBLE' }
      ]
    })
    label.source.id = '10:2'
    const instance = graph.createInstance(component.id, page.id, {
      name: 'Card instance',
      componentPropertyAssignments: { '30:1': 'Custom', '30:2': 'false' }
    })
    if (!instance) throw new Error('Expected instance')
    instance.source.id = '20:1'

    const bytes = await exportFigFile(graph)
    const parsed = parseFigBuffer(uint8ArrayToArrayBuffer(bytes))
    const imported = materializeDocument(parsed.nodeChanges, parsed.blobs).graph
    const importedComponent = [...imported.getAllNodes()].find((node) => node.name === 'Card')
    const importedInstance = [...imported.getAllNodes()].find(
      (node) => node.name === 'Card instance'
    )
    const importedLabel = [...imported.getAllNodes()].find(
      (node) => node.name === 'Label' && node.parentId === importedComponent?.id
    )

    expect(importedComponent?.componentPropertyDefinitions).toEqual([
      { id: '30:1', name: 'Label', type: 'TEXT', defaultValue: 'Default' },
      { id: '30:2', name: 'Visible', type: 'BOOLEAN', defaultValue: 'true' }
    ])
    expect(importedLabel?.componentPropertyReferences).toEqual([
      { propertyId: '30:1', field: 'TEXT' },
      { propertyId: '30:2', field: 'VISIBLE' }
    ])
    expect(importedInstance?.componentPropertyAssignments).toEqual({
      '30:1': 'Custom',
      '30:2': 'false'
    })
  })

  test('exports edited imported assignments instead of stale raw values', async () => {
    const graph = new SceneGraph()
    const page = graph.getPages()[0]
    const component = graph.createNode('COMPONENT', page.id, {
      name: 'Card',
      componentPropertyDefinitions: [
        { id: '30:1', name: 'Label', type: 'TEXT', defaultValue: 'Default' }
      ]
    })
    component.source.id = '10:1'
    const instance = graph.createInstance(component.id, page.id, {
      name: 'Card instance',
      componentPropertyAssignments: { '30:1': 'Original' }
    })
    if (!instance) throw new Error('Expected instance')
    instance.source.id = '20:1'

    const imported = materializeDocument(
      parseFigBuffer((await exportFigFile(graph)).buffer as ArrayBuffer).nodeChanges,
      []
    ).graph
    const importedInstance = [...imported.getAllNodes()].find(
      (node) => node.name === 'Card instance'
    )
    if (!importedInstance) throw new Error('Expected imported instance')
    imported.updateNode(importedInstance.id, {
      componentPropertyAssignments: { '30:1': 'Edited' }
    })

    const reloaded = materializeDocument(
      parseFigBuffer((await exportFigFile(imported)).buffer as ArrayBuffer).nodeChanges,
      []
    ).graph
    const reloadedInstance = [...reloaded.getAllNodes()].find(
      (node) => node.name === 'Card instance'
    )
    expect(reloadedInstance?.componentPropertyAssignments).toEqual({ '30:1': 'Edited' })
  })

  test('saves an exposed nested instance as Figma does and reopens it', async () => {
    const graph = new SceneGraph()
    const page = graph.getPages()[0]
    const button = graph.createNode('COMPONENT', page.id, {
      name: 'Button',
      componentPropertyDefinitions: [
        { id: '10:1', name: 'Label', type: 'TEXT', defaultValue: 'Button' }
      ]
    })
    graph.createNode('TEXT', button.id, {
      name: 'Label',
      text: 'Button',
      componentPropertyReferences: [{ propertyId: '10:1', field: 'TEXT' }]
    })
    const card = graph.createNode('COMPONENT', page.id, { name: 'Card' })
    const action = graph.createInstance(button.id, card.id, { name: 'Action' })
    const plain = graph.createInstance(button.id, card.id, { name: 'Plain' })
    if (!action || !plain) throw new Error('nested instances were not created')
    graph.updateNode(action.id, { isExposedInstance: true })

    const bytes = await exportFigFile(graph)
    const parsed = parseFigBuffer(uint8ArrayToArrayBuffer(bytes))
    const saved = (name: string) => parsed.nodeChanges.find((change) => change.name === name)
    expect(saved('Action')?.propsAreBubbled).toBe(true)
    expect(saved('Plain')?.propsAreBubbled).toBeUndefined()

    const imported = materializeDocument(parsed.nodeChanges, parsed.blobs).graph
    const reopened = (name: string) =>
      [...imported.getAllNodes()].find((node) => node.name === name && node.type === 'INSTANCE')
    expect(reopened('Action')?.isExposedInstance).toBe(true)
    expect(reopened('Plain')?.isExposedInstance).toBe(false)
  })
})