openpencil/tests/engine/render.test.ts
Danila Poyarkov 5ae6234e40
Tailwind CSS v4 JSX export (#54)
* Add Tailwind CSS v4 JSX export format

- Add JSXFormat type ('openpencil' | 'tailwind') to sceneNodeToJSX/selectionToJSX
- Tailwind resolver (tailwind.ts): px→spacing (v4 multiplier), hex→color class,
  fontSize/fontWeight/borderRadius named lookups with arbitrary value fallback
- Export: FRAME→div, TEXT→p, SECTION→section, className with TW utility classes
- CLI: export --format jsx --style tailwind
- CodePanel: format toggle button (OpenPencil / Tailwind)
- Rename Jsx→JSX in all public APIs (sceneNodeToJSX, selectionToJSX, renderJSX, etc.)
- 29 new Tailwind export tests, all 43 export tests pass

* Extract escapeJSXText — replace nested ternary with entity map lookup

* Deduplicate export-jsx: extract shared padding, corner radius, and node context helpers

* Update changelog

* Tighten Tailwind JSX export fidelity
2026-03-06 18:04:11 +03:00

358 lines
10 KiB
TypeScript

import { describe, expect, it } from 'bun:test'
import {
SceneGraph,
renderTree,
renderJSX,
renderTreeNode,
Frame,
Text,
Rectangle,
Ellipse,
Line,
Star,
Group,
Section,
isTreeNode,
node
} from '@open-pencil/core'
function createGraph(): SceneGraph {
const g = new SceneGraph()
g.addPage('Test')
return g
}
describe('TreeNode builders', () => {
it('creates Frame tree node', () => {
const tree = Frame({ name: 'Card', w: 320, h: 200, bg: '#FFF' })
expect(isTreeNode(tree)).toBe(true)
expect(tree.type).toBe('frame')
expect(tree.props.name).toBe('Card')
expect(tree.props.w).toBe(320)
expect(tree.children).toEqual([])
})
it('creates Text tree node with string child', () => {
const tree = Text({ name: 'Title', size: 18, children: 'Hello World' })
expect(tree.type).toBe('text')
expect(tree.children).toEqual(['Hello World'])
})
it('creates nested tree', () => {
const tree = Frame({
name: 'Card',
children: [
Rectangle({ name: 'Bg', w: 100, h: 100, bg: '#E5E7EB' }),
Text({ name: 'Label', size: 14, children: 'Click me' })
]
})
expect(tree.children.length).toBe(2)
expect(isTreeNode(tree.children[0]!)).toBe(true)
const bg = tree.children[0] as ReturnType<typeof Rectangle>
expect(bg.type).toBe('rectangle')
expect(bg.props.name).toBe('Bg')
})
it('node() flattens nested arrays', () => {
const tree = node('frame', {
children: [[Text({ children: 'A' }), Text({ children: 'B' })], Text({ children: 'C' })]
})
expect(tree.children.length).toBe(3)
})
it('node() filters null/undefined children', () => {
const tree = node('frame', {
children: [null, Text({ children: 'A' }), undefined]
})
expect(tree.children.length).toBe(1)
})
})
describe('renderTree', () => {
it('renders a simple frame', () => {
const g = createGraph()
const tree = Frame({ name: 'MyFrame', w: 200, h: 100, bg: '#FF0000' })
const result = renderTree(g, tree)
expect(result.name).toBe('MyFrame')
expect(result.type).toBe('FRAME')
const node = g.nodes.get(result.id)!
expect(node.width).toBe(200)
expect(node.height).toBe(100)
expect(node.fills.length).toBe(1)
expect(node.fills[0]!.type).toBe('SOLID')
})
it('renders text node with content', () => {
const g = createGraph()
const tree = Text({ name: 'Heading', size: 24, weight: 'bold', color: '#111', children: 'Hello' })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.type).toBe('TEXT')
expect(node.text).toBe('Hello')
expect(node.fontSize).toBe(24)
expect(node.fontWeight).toBe(700)
expect(node.fills.length).toBe(1)
})
it('renders nested structure', () => {
const g = createGraph()
const tree = Frame({
name: 'Card',
w: 320,
flex: 'col',
gap: 16,
p: 24,
bg: '#FFF',
children: [
Rectangle({ name: 'Image', w: 272, h: 200, bg: '#E5E7EB' }),
Text({ name: 'Title', size: 18, weight: 'bold', color: '#111', children: 'Card Title' }),
Text({ name: 'Description', size: 14, color: '#6B7280', children: 'Lorem ipsum' })
]
})
const result = renderTree(g, tree)
const card = g.nodes.get(result.id)!
expect(card.layoutMode).toBe('VERTICAL')
expect(card.itemSpacing).toBe(16)
expect(card.paddingTop).toBe(24)
expect(card.paddingRight).toBe(24)
expect(card.childIds.length).toBe(3)
const title = g.nodes.get(card.childIds[1]!)!
expect(title.text).toBe('Card Title')
expect(title.fontWeight).toBe(700)
})
it('renders with position override', () => {
const g = createGraph()
const tree = Frame({ name: 'Positioned', w: 100, h: 100 })
const result = renderTree(g, tree, { x: 50, y: 75 })
const node = g.nodes.get(result.id)!
expect(node.x).toBe(50)
expect(node.y).toBe(75)
})
it('renders into a specific parent', () => {
const g = createGraph()
const page = g.getPages()[0]!
const container = g.createNode('FRAME', page.id, { name: 'Container' })
const tree = Frame({ name: 'Child', w: 50, h: 50 })
renderTree(g, tree, { parentId: container.id })
expect(container.childIds.length).toBe(1)
})
it('handles auto-layout properties', () => {
const g = createGraph()
const tree = Frame({
name: 'Flex',
flex: 'row',
gap: 8,
justify: 'between',
items: 'center',
wrap: true
})
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.layoutMode).toBe('HORIZONTAL')
expect(node.itemSpacing).toBe(8)
expect(node.primaryAxisAlign).toBe('SPACE_BETWEEN')
expect(node.counterAxisAlign).toBe('CENTER')
expect(node.layoutWrap).toBe('WRAP')
})
it('handles padding shorthands', () => {
const g = createGraph()
const tree = Frame({ name: 'Padded', px: 16, py: 8, pt: 4 })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.paddingLeft).toBe(16)
expect(node.paddingRight).toBe(16)
expect(node.paddingBottom).toBe(8)
expect(node.paddingTop).toBe(4) // pt overrides py
})
it('handles corner radius', () => {
const g = createGraph()
const tree = Frame({ name: 'Rounded', rounded: 12 })
const result = renderTree(g, tree)
expect(g.nodes.get(result.id)!.cornerRadius).toBe(12)
})
it('handles independent corners', () => {
const g = createGraph()
const tree = Frame({ name: 'Corners', roundedTL: 8, roundedBR: 16 })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.independentCorners).toBe(true)
expect(node.topLeftRadius).toBe(8)
expect(node.bottomRightRadius).toBe(16)
})
it('handles stroke', () => {
const g = createGraph()
const tree = Rectangle({ name: 'Bordered', stroke: '#000', strokeWidth: 2 })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.strokes.length).toBe(1)
expect(node.strokes[0]!.weight).toBe(2)
})
it('handles opacity and rotation', () => {
const g = createGraph()
const tree = Frame({ name: 'Transformed', opacity: 0.5, rotate: 45 })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.opacity).toBe(0.5)
expect(node.rotation).toBe(45)
})
it('handles overflow hidden (clip)', () => {
const g = createGraph()
const tree = Frame({ name: 'Clipped', overflow: 'hidden' })
const result = renderTree(g, tree)
expect(g.nodes.get(result.id)!.clipsContent).toBe(true)
})
it('handles hug sizing', () => {
const g = createGraph()
const tree = Frame({ name: 'Hug', w: 'hug', h: 'hug', flex: 'col' })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.primaryAxisSizing).toBe('HUG')
expect(node.counterAxisSizing).toBe('HUG')
})
it('handles fill sizing', () => {
const g = createGraph()
const tree = Frame({ name: 'Fill', w: 'fill' })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.layoutGrow).toBe(1)
})
it('handles shadow effect', () => {
const g = createGraph()
const tree = Frame({ name: 'Shadow', shadow: '0 4 12 rgba(0,0,0,0.1)' })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.effects.length).toBe(1)
expect(node.effects[0]!.type).toBe('DROP_SHADOW')
expect(node.effects[0]!.radius).toBe(12)
})
it('handles blur effect', () => {
const g = createGraph()
const tree = Frame({ name: 'Blurred', blur: 8 })
const result = renderTree(g, tree)
const node = g.nodes.get(result.id)!
expect(node.effects.length).toBe(1)
expect(node.effects[0]!.type).toBe('LAYER_BLUR')
expect(node.effects[0]!.radius).toBe(8)
})
it('renders all primitive types', () => {
const g = createGraph()
const types = [
{ fn: Rectangle, expected: 'RECTANGLE' },
{ fn: Ellipse, expected: 'ELLIPSE' },
{ fn: Line, expected: 'LINE' },
{ fn: Star, expected: 'STAR' },
{ fn: Group, expected: 'GROUP' },
{ fn: Section, expected: 'SECTION' }
] as const
for (const { fn, expected } of types) {
const tree = fn({ name: expected })
const result = renderTree(g, tree)
expect(g.nodes.get(result.id)!.type).toBe(expected)
}
})
it('throws on unknown element type', () => {
const g = createGraph()
const tree = { type: 'foobar', props: {}, children: [] }
expect(() => renderTree(g, tree)).toThrow('Unknown element: <foobar>')
})
})
describe('renderTreeNode', () => {
it('renders pre-built tree (browser path)', () => {
const g = createGraph()
const tree = Frame({
name: 'FromAI',
w: 200,
h: 100,
bg: '#3B82F6',
children: [Text({ name: 'Label', size: 16, color: '#FFF', children: 'Button' })]
})
const result = renderTreeNode(g, tree)
expect(result.name).toBe('FromAI')
const node = g.nodes.get(result.id)!
expect(node.childIds.length).toBe(1)
const label = g.nodes.get(node.childIds[0]!)!
expect(label.text).toBe('Button')
})
})
describe('renderJSX (string → scene graph)', () => {
it('renders JSX string', async () => {
const g = createGraph()
const jsx = `
<Frame name="Test" w={200} h={100} bg="#FF0000">
<Text name="Hello" size={16} color="#000">World</Text>
</Frame>
`
const result = await renderJSX(g, jsx)
expect(result.name).toBe('Test')
const node = g.nodes.get(result.id)!
expect(node.type).toBe('FRAME')
expect(node.childIds.length).toBe(1)
const text = g.nodes.get(node.childIds[0]!)!
expect(text.text).toBe('World')
})
it('renders nested JSX', async () => {
const g = createGraph()
const jsx = `
<Frame name="Card" w={320} flex="col" gap={16} p={24} bg="#FFF" rounded={16}>
<Rectangle name="Image" w={272} h={200} bg="#E5E7EB" rounded={12} />
<Text name="Title" size={18} weight="bold" color="#111">Card Title</Text>
<Text name="Description" size={14} color="#6B7280">Lorem ipsum</Text>
</Frame>
`
const result = await renderJSX(g, jsx)
const card = g.nodes.get(result.id)!
expect(card.layoutMode).toBe('VERTICAL')
expect(card.childIds.length).toBe(3)
})
it('renders with position', async () => {
const g = createGraph()
const result = await renderJSX(g, '<Frame name="At" w={50} h={50} />', { x: 100, y: 200 })
const node = g.nodes.get(result.id)!
expect(node.x).toBe(100)
expect(node.y).toBe(200)
})
})