@bycrux/editor 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/README.md +165 -0
  2. package/package.json +46 -0
  3. package/src/__tests__/adapter-contract.test.ts +123 -0
  4. package/src/__tests__/adapter.test.ts +185 -0
  5. package/src/__tests__/schema.test.ts +104 -0
  6. package/src/__tests__/video-adapter-contract.test.ts +89 -0
  7. package/src/carousel/AddElementMenu.tsx +211 -0
  8. package/src/carousel/CarouselEditor.tsx +545 -0
  9. package/src/carousel/CarouselRenderModal.tsx +243 -0
  10. package/src/carousel/OverlayErrorBoundary.tsx +99 -0
  11. package/src/carousel/OverlayPicker.tsx +145 -0
  12. package/src/carousel/ReadOnlySlide.tsx +90 -0
  13. package/src/carousel/SlideCanvas.tsx +637 -0
  14. package/src/carousel/SlidePropertyPanel.tsx +387 -0
  15. package/src/carousel/__tests__/CarouselEditor.test.tsx +291 -0
  16. package/src/carousel/__tests__/ReadOnlySlide.test.tsx +139 -0
  17. package/src/carousel/__tests__/SlideCanvasCrop.test.tsx +95 -0
  18. package/src/carousel/__tests__/SlideCanvasFonts.test.tsx +82 -0
  19. package/src/crop/CanvasCropOverlay.tsx +193 -0
  20. package/src/crop/__tests__/crop-math.test.ts +174 -0
  21. package/src/crop/crop-math.ts +125 -0
  22. package/src/gestures/helpers/__tests__/element-transform.test.ts +30 -0
  23. package/src/gestures/helpers/drag.ts +24 -0
  24. package/src/gestures/helpers/element-transform.ts +15 -0
  25. package/src/gestures/helpers/resize.ts +60 -0
  26. package/src/gestures/helpers/rotate.ts +44 -0
  27. package/src/gestures/helpers/snap.ts +64 -0
  28. package/src/gestures/hooks/useOverlayDrag.ts +106 -0
  29. package/src/gestures/hooks/useOverlayResize.ts +67 -0
  30. package/src/gestures/hooks/useOverlayRotate.ts +64 -0
  31. package/src/gestures/index.ts +16 -0
  32. package/src/index.ts +136 -0
  33. package/src/lib/google-fonts.ts +28 -0
  34. package/src/overlays/contract.ts +41 -0
  35. package/src/preview/OverlayPreview.tsx +196 -0
  36. package/src/preview/__tests__/OverlayPreview.test.tsx +169 -0
  37. package/src/schema.ts +201 -0
  38. package/src/state/__tests__/project-reducer.test.ts +957 -0
  39. package/src/state/__tests__/use-project-state.test.tsx +258 -0
  40. package/src/state/mutation-queue.ts +62 -0
  41. package/src/state/project-reducer.ts +328 -0
  42. package/src/state/use-project-state.ts +442 -0
  43. package/src/test-setup.ts +1 -0
  44. package/src/text/FontPicker.tsx +218 -0
  45. package/src/text/InlineTextEditor.tsx +92 -0
  46. package/src/text/TextFormattingToolbar.tsx +248 -0
  47. package/src/text/__tests__/InlineTextEditor.test.tsx +139 -0
  48. package/src/text/__tests__/TextFormattingToolbar.test.tsx +416 -0
  49. package/src/theme.ts +93 -0
  50. package/src/types.ts +486 -0
  51. package/src/ui/__tests__/button.test.tsx +17 -0
  52. package/src/ui/badge.tsx +32 -0
  53. package/src/ui/button.tsx +32 -0
  54. package/src/ui/index.ts +16 -0
  55. package/src/ui/input.tsx +15 -0
  56. package/src/ui/label.tsx +10 -0
  57. package/src/ui/select.tsx +23 -0
  58. package/src/ui/switch.tsx +31 -0
  59. package/src/ui/textarea.tsx +15 -0
  60. package/src/ui/utils.ts +7 -0
  61. package/src/video/RenderModal.tsx +252 -0
  62. package/src/video/VersionPanel.tsx +83 -0
  63. package/src/video/VideoEditor.tsx +508 -0
  64. package/src/video/__tests__/VideoEditor.test.tsx +213 -0
  65. package/src/video/__tests__/captionRepair.test.ts +134 -0
  66. package/src/video/__tests__/cuts.test.ts +198 -0
  67. package/src/video/captionRepair.ts +41 -0
  68. package/src/video/cuts.ts +369 -0
  69. package/src/video/design-canvas.ts +11 -0
  70. package/src/video/preview/CaptionPreview.tsx +83 -0
  71. package/src/video/preview/CarouselPreview.tsx +35 -0
  72. package/src/video/preview/OverlayItemsLayer.tsx +584 -0
  73. package/src/video/preview/PreviewPlayer.tsx +178 -0
  74. package/src/video/preview/useDragOverlay.ts +167 -0
  75. package/src/video/preview/useVideoPlayback.ts +761 -0
  76. package/src/video/timeline/AudioTrackRow.tsx +406 -0
  77. package/src/video/timeline/AudioWaveformLayer.tsx +117 -0
  78. package/src/video/timeline/EditableSegment.tsx +30 -0
  79. package/src/video/timeline/Scrubber.tsx +184 -0
  80. package/src/video/timeline/Timeline.tsx +375 -0
  81. package/src/video/timeline/TimelineContext.ts +25 -0
  82. package/src/video/timeline/TranscriptModal.tsx +63 -0
  83. package/src/video/timeline/TranscriptPanel.tsx +86 -0
  84. package/src/video/timeline/VisualTrackRow.tsx +293 -0
  85. package/src/video/timeline/makeCaptionEdit.ts +32 -0
  86. package/src/video/timeline/multiSelectOps.ts +157 -0
  87. package/src/video/timeline/useItemDragDrop.ts +190 -0
  88. package/src/video/timeline/useTimelineZoom.ts +48 -0
  89. package/src/video/timeline/utils.ts +17 -0
@@ -0,0 +1,387 @@
1
+ import { useEffect, useState } from 'react'
2
+ import { Crop, Eye, EyeOff } from 'lucide-react'
3
+ import type {
4
+ Project,
5
+ Slide,
6
+ CarouselElement,
7
+ OverlayElement,
8
+ GlobalOverlay,
9
+ GlobalOverlayProp,
10
+ EditorAdapter,
11
+ } from '../types'
12
+ import { Button } from '../ui'
13
+ import { TextFormattingToolbar } from '../text/TextFormattingToolbar'
14
+
15
+ function parseNumber(v: string): number | null {
16
+ const n = Number(v)
17
+ return Number.isFinite(n) ? n : null
18
+ }
19
+
20
+ interface Props {
21
+ project: Project
22
+ slide?: Slide
23
+ element?: CarouselElement
24
+ onSlideChange: (patch: Partial<Slide>) => void
25
+ onElementChange: (patch: Partial<CarouselElement>) => void
26
+ onDeleteSlide: (id: string) => void
27
+ onDuplicateSlide: (id: string) => void
28
+ onDeleteElement: (slideId: string, elementId: string) => void
29
+ onDuplicateElement: (slideId: string, elementId: string) => void
30
+ onReorderElement: (slideId: string, elementId: string, direction: 'forward' | 'backward') => void
31
+ // Crop entry: enabled only for unrotated image elements.
32
+ onEnterCrop?: (slideId: string, elementId: string) => void
33
+ // editor-core text mutator for the formatting toolbar.
34
+ updateOverlayProp?: (slideId: string, elementId: string, key: string, value: string) => Promise<void>
35
+ // Adapter supplies overlay-schema listing (global + profile-scoped).
36
+ adapter: EditorAdapter<Project>
37
+ // Editor-only element visibility (host-owned, non-persisted). When
38
+ // `onToggleElementVisibility` is supplied, an eye toggle is shown for the
39
+ // selected element; `hiddenElementIds` reflects the current hidden set.
40
+ hiddenElementIds?: string[]
41
+ onToggleElementVisibility?: (elementId: string) => void
42
+ }
43
+
44
+ // Small eye toggle to hide/show the selected element in the editor preview only
45
+ // (never persisted). Absent host callback → not rendered.
46
+ function HideToggle({
47
+ elementId,
48
+ isHidden,
49
+ onToggle,
50
+ }: {
51
+ elementId: string
52
+ isHidden: boolean
53
+ onToggle?: (elementId: string) => void
54
+ }) {
55
+ if (!onToggle) return null
56
+ return (
57
+ <button
58
+ type="button"
59
+ onClick={e => { e.stopPropagation(); onToggle(elementId) }}
60
+ title={isHidden ? 'Show in editor' : 'Hide from editor'}
61
+ aria-label={isHidden ? 'Show in editor' : 'Hide from editor'}
62
+ aria-pressed={isHidden}
63
+ className="text-gray-500 hover:text-white px-1"
64
+ >
65
+ {isHidden ? <EyeOff className="h-3.5 w-3.5" /> : <Eye className="h-3.5 w-3.5" />}
66
+ </button>
67
+ )
68
+ }
69
+
70
+ function numInput(
71
+ label: string,
72
+ value: number,
73
+ onChange: (v: number) => void,
74
+ opts?: { min?: number; max?: number; step?: number }
75
+ ) {
76
+ return (
77
+ <label className="flex flex-col gap-0.5">
78
+ <span className="text-xs text-gray-500">{label}</span>
79
+ <input
80
+ type="number"
81
+ value={value}
82
+ min={opts?.min}
83
+ max={opts?.max}
84
+ step={opts?.step ?? 1}
85
+ onChange={e => {
86
+ const parsed = parseNumber(e.target.value)
87
+ if (parsed !== null) onChange(parsed)
88
+ }}
89
+ className="bg-gray-800 border border-gray-700 rounded px-2 py-1 text-xs text-white focus:outline-none focus:border-gray-500 w-full"
90
+ />
91
+ </label>
92
+ )
93
+ }
94
+
95
+ function PropEditor({
96
+ prop,
97
+ value,
98
+ onChange,
99
+ }: {
100
+ prop: GlobalOverlayProp
101
+ value: unknown
102
+ onChange: (v: unknown) => void
103
+ }) {
104
+ const { name, type, description } = prop
105
+
106
+ if (type === 'bool') {
107
+ return (
108
+ <label className="flex items-center gap-2 cursor-pointer" title={description}>
109
+ <input
110
+ type="checkbox"
111
+ checked={Boolean(value)}
112
+ onChange={e => onChange(e.target.checked)}
113
+ className="accent-blue-500"
114
+ />
115
+ <span className="text-xs text-gray-300">{name}</span>
116
+ </label>
117
+ )
118
+ }
119
+
120
+ if (type === 'color') {
121
+ return (
122
+ <label className="flex flex-col gap-0.5" title={description}>
123
+ <span className="text-xs text-gray-500">{name}</span>
124
+ <input
125
+ type="color"
126
+ value={String(value ?? '#000000')}
127
+ onChange={e => onChange(e.target.value)}
128
+ className="w-full h-7 bg-gray-800 border border-gray-700 rounded cursor-pointer"
129
+ />
130
+ </label>
131
+ )
132
+ }
133
+
134
+ if (type === 'int' || type === 'float') {
135
+ return (
136
+ <label className="flex flex-col gap-0.5" title={description}>
137
+ <span className="text-xs text-gray-500">{name}</span>
138
+ <input
139
+ type="number"
140
+ value={Number(value ?? 0)}
141
+ step={type === 'float' ? 0.1 : 1}
142
+ onChange={e => {
143
+ const parsed = parseNumber(e.target.value)
144
+ if (parsed !== null) onChange(parsed)
145
+ }}
146
+ className="bg-gray-800 border border-gray-700 rounded px-2 py-1 text-xs text-white focus:outline-none focus:border-gray-500 w-full"
147
+ />
148
+ </label>
149
+ )
150
+ }
151
+
152
+ // string fallback
153
+ return (
154
+ <label className="flex flex-col gap-0.5" title={description}>
155
+ <span className="text-xs text-gray-500">{name}</span>
156
+ <input
157
+ type="text"
158
+ value={String(value ?? '')}
159
+ onChange={e => onChange(e.target.value)}
160
+ className="bg-gray-800 border border-gray-700 rounded px-2 py-1 text-xs text-white focus:outline-none focus:border-gray-500 w-full"
161
+ />
162
+ </label>
163
+ )
164
+ }
165
+
166
+ export default function SlidePropertyPanel({
167
+ project,
168
+ slide,
169
+ element,
170
+ onSlideChange,
171
+ onElementChange,
172
+ onDeleteSlide,
173
+ onDuplicateSlide,
174
+ onDeleteElement,
175
+ onDuplicateElement,
176
+ onReorderElement,
177
+ onEnterCrop,
178
+ updateOverlayProp,
179
+ adapter,
180
+ hiddenElementIds,
181
+ onToggleElementVisibility,
182
+ }: Props) {
183
+ // Map of jsxPath → GlobalOverlay for overlay prop schemas
184
+ const [overlaySchemas, setOverlaySchemas] = useState<Map<string, GlobalOverlay>>(new Map())
185
+ const [schemasLoading, setSchemasLoading] = useState(false)
186
+
187
+ useEffect(() => {
188
+ setSchemasLoading(true)
189
+ const promises: Promise<GlobalOverlay[]>[] = [adapter.listGlobalOverlays()]
190
+ if (project.profile) {
191
+ promises.push(adapter.listProfileOverlays?.(project.profile) ?? Promise.resolve([]))
192
+ }
193
+ Promise.all(promises)
194
+ .then(results => {
195
+ const map = new Map<string, GlobalOverlay>()
196
+ for (const list of results) {
197
+ for (const o of list) {
198
+ map.set(o.jsxPath, o)
199
+ }
200
+ }
201
+ setOverlaySchemas(map)
202
+ })
203
+ .catch(() => {})
204
+ .finally(() => setSchemasLoading(false))
205
+ }, [project.profile])
206
+
207
+ if (!slide) {
208
+ return (
209
+ <div className="w-80 flex-shrink-0 flex items-center justify-center text-gray-600 text-xs p-4">
210
+ Select a slide
211
+ </div>
212
+ )
213
+ }
214
+
215
+ const overlayEl = element?.type === 'overlay' ? (element as OverlayElement) : null
216
+ const overlaySchema = overlayEl ? overlaySchemas.get(overlayEl.overlay.template) : null
217
+
218
+ return (
219
+ <div className="w-80 flex-shrink-0 border-l border-gray-800 flex flex-col overflow-y-auto bg-gray-950">
220
+ {/* Slide header */}
221
+ <div className="px-4 py-3 border-b border-gray-800">
222
+ <div className="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Slide</div>
223
+ <div className="flex flex-col gap-2">
224
+ <label className="flex flex-col gap-0.5">
225
+ <span className="text-xs text-gray-500">Background color</span>
226
+ <input
227
+ type="color"
228
+ value={slide.base_color || '#ffffff'}
229
+ onChange={e => onSlideChange({ base_color: e.target.value })}
230
+ className="w-full h-7 bg-gray-800 border border-gray-700 rounded cursor-pointer"
231
+ />
232
+ </label>
233
+ <div className="flex gap-2">
234
+ <Button
235
+ size="sm"
236
+ variant="outline"
237
+ className="flex-1 text-xs"
238
+ onClick={() => onDuplicateSlide(slide.id)}
239
+ >
240
+ Duplicate
241
+ </Button>
242
+ <Button
243
+ size="sm"
244
+ variant="outline"
245
+ className="flex-1 text-xs text-red-400 hover:text-red-300"
246
+ onClick={() => onDeleteSlide(slide.id)}
247
+ >
248
+ Delete
249
+ </Button>
250
+ </div>
251
+ </div>
252
+ </div>
253
+
254
+ {/* Element section */}
255
+ {element && (
256
+ <div className="px-4 py-3 flex flex-col gap-3">
257
+ <div className="flex items-center justify-between">
258
+ <span className="text-xs font-semibold text-gray-400 uppercase tracking-wider">
259
+ {element.type === 'image' ? 'Image' : 'Overlay'}
260
+ </span>
261
+ <div className="flex items-center gap-1">
262
+ <HideToggle
263
+ elementId={element.id}
264
+ isHidden={hiddenElementIds?.includes(element.id) ?? false}
265
+ onToggle={onToggleElementVisibility}
266
+ />
267
+ <button
268
+ onClick={() => onReorderElement(slide.id, element.id, 'forward')}
269
+ className="text-xs text-gray-500 hover:text-white px-1"
270
+ title="Bring forward"
271
+ >
272
+
273
+ </button>
274
+ <button
275
+ onClick={() => onReorderElement(slide.id, element.id, 'backward')}
276
+ className="text-xs text-gray-500 hover:text-white px-1"
277
+ title="Send backward"
278
+ >
279
+
280
+ </button>
281
+ </div>
282
+ </div>
283
+
284
+ {/* Transform */}
285
+ <div className="grid grid-cols-2 gap-2">
286
+ {numInput('X', element.x, v => onElementChange({ x: v }))}
287
+ {numInput('Y', element.y, v => onElementChange({ y: v }))}
288
+ {numInput('W', element.w, v => onElementChange({ w: v }), { min: 1 })}
289
+ {numInput('H', element.h, v => onElementChange({ h: v }), { min: 1 })}
290
+ {numInput('Rotation', element.rotation ?? 0, v => onElementChange({ rotation: v }), { min: -360, max: 360 })}
291
+ </div>
292
+
293
+ {/* Image-specific */}
294
+ {element.type === 'image' && (
295
+ <div className="flex flex-col gap-1.5">
296
+ <div className="flex flex-col gap-0.5">
297
+ <span className="text-xs text-gray-500">Source</span>
298
+ <span className="text-xs text-gray-300 truncate" title={element.src}>
299
+ {element.src.split('/').pop() || element.src}
300
+ </span>
301
+ </div>
302
+ <Button
303
+ size="sm"
304
+ variant="outline"
305
+ className="text-xs flex items-center gap-1.5"
306
+ disabled={(element.rotation ?? 0) !== 0 || !onEnterCrop}
307
+ title={
308
+ (element.rotation ?? 0) !== 0
309
+ ? 'Reset rotation to 0 before cropping'
310
+ : 'Crop image'
311
+ }
312
+ onClick={() => onEnterCrop?.(slide.id, element.id)}
313
+ >
314
+ <Crop className="h-3.5 w-3.5" />
315
+ Crop
316
+ </Button>
317
+ </div>
318
+ )}
319
+
320
+ {/* Overlay-specific */}
321
+ {overlayEl && (
322
+ <div className="flex flex-col gap-2">
323
+ {/* Rich-text formatting (bold/italic/case/color/align + font family
324
+ & size pickers) for overlays exposing the standard text contract. */}
325
+ {updateOverlayProp && (
326
+ <TextFormattingToolbar
327
+ slideId={slide.id}
328
+ element={overlayEl}
329
+ updateOverlayProp={updateOverlayProp}
330
+ />
331
+ )}
332
+
333
+ <div className="grid grid-cols-2 gap-2">
334
+ {numInput('Frame', overlayEl.frame, v => onElementChange({ frame: v }), { min: 0 })}
335
+ </div>
336
+
337
+ {schemasLoading && (
338
+ <div className="text-xs text-gray-500">Loading overlay props…</div>
339
+ )}
340
+
341
+ {!schemasLoading && overlaySchema && overlaySchema.props.length > 0 && (
342
+ <div className="flex flex-col gap-2">
343
+ <span className="text-xs text-gray-500 font-medium">Props</span>
344
+ {overlaySchema.props.map(prop => (
345
+ <PropEditor
346
+ key={prop.name}
347
+ prop={prop}
348
+ value={overlayEl.overlay.props[prop.name]}
349
+ onChange={v => {
350
+ onElementChange({
351
+ overlay: {
352
+ ...overlayEl.overlay,
353
+ props: { ...overlayEl.overlay.props, [prop.name]: v },
354
+ },
355
+ } as Partial<CarouselElement>)
356
+ }}
357
+ />
358
+ ))}
359
+ </div>
360
+ )}
361
+ </div>
362
+ )}
363
+
364
+ {/* Element actions */}
365
+ <div className="flex gap-2 pt-1">
366
+ <Button
367
+ size="sm"
368
+ variant="outline"
369
+ className="flex-1 text-xs"
370
+ onClick={() => onDuplicateElement(slide.id, element.id)}
371
+ >
372
+ Duplicate
373
+ </Button>
374
+ <Button
375
+ size="sm"
376
+ variant="outline"
377
+ className="flex-1 text-xs text-red-400 hover:text-red-300"
378
+ onClick={() => onDeleteElement(slide.id, element.id)}
379
+ >
380
+ Delete
381
+ </Button>
382
+ </div>
383
+ </div>
384
+ )}
385
+ </div>
386
+ )
387
+ }
@@ -0,0 +1,291 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
2
+ import { render, act, waitFor, fireEvent } from '@testing-library/react'
3
+ import type { EditorAdapter, ImageElement, Project, RenderEvent } from '../../types'
4
+ import CarouselEditor from '../CarouselEditor'
5
+
6
+ // ── Fake adapter (mirrors editor-core's use-project-state test pattern) ───────
7
+ // The package owns the assembled editor now: no host (`@/`) modules are mocked.
8
+ // A full fake `EditorAdapter` drives load/save/render and the overlay-list /
9
+ // upload / fileUrl primitives the assembled editor consumes.
10
+
11
+ function makeProject(overrides: Partial<Project> = {}): Project {
12
+ return {
13
+ version: '1',
14
+ id: 'proj-1',
15
+ name: 'Test',
16
+ workflow: 'carousel',
17
+ status: 'draft',
18
+ editingPrompt: '',
19
+ projectType: 'carousel',
20
+ settings: { resolution: [1080, 1080] },
21
+ assets: [],
22
+ slides: [
23
+ {
24
+ id: 'slide-0',
25
+ base_color: '#ffffff',
26
+ elements: [
27
+ {
28
+ id: 'el-img',
29
+ type: 'image',
30
+ src: 'a.png',
31
+ x: 100,
32
+ y: 100,
33
+ w: 200,
34
+ h: 200,
35
+ rotation: 0,
36
+ },
37
+ ],
38
+ },
39
+ ],
40
+ ...overrides,
41
+ } as Project
42
+ }
43
+
44
+ interface FakeAdapter extends EditorAdapter<Project> {
45
+ saveCalls: Array<{ id: string; project: Project }>
46
+ }
47
+
48
+ function makeFakeAdapter(): FakeAdapter {
49
+ const saveCalls: Array<{ id: string; project: Project }> = []
50
+ return {
51
+ loadProject: vi.fn(async () => makeProject()),
52
+ saveProject: vi.fn(async (id: string, project: Project) => { saveCalls.push({ id, project }) }),
53
+ subscribe: () => () => {},
54
+ render: async function* (): AsyncIterable<RenderEvent> {
55
+ yield { type: 'done', outputPath: '/out.png' }
56
+ },
57
+ resolveImageSrc: (el: ImageElement) => el.src,
58
+ compileOverlay: vi.fn(async () => () => null),
59
+ listGlobalOverlays: vi.fn(async () => []),
60
+ listSystemOverlays: vi.fn(async () => []),
61
+ uploadFile: vi.fn(async () => '/path'),
62
+ fileUrl: (path: string) => path,
63
+ saveCalls,
64
+ }
65
+ }
66
+
67
+ beforeEach(() => {
68
+ vi.spyOn(console, 'warn').mockImplementation(() => {})
69
+ // ResizeObserver isn't in jsdom.
70
+ ;(globalThis as unknown as { ResizeObserver: unknown }).ResizeObserver = class {
71
+ observe() {}
72
+ unobserve() {}
73
+ disconnect() {}
74
+ }
75
+ })
76
+ afterEach(() => vi.restoreAllMocks())
77
+
78
+ // The element id appears twice in the DOM: once in the left-rail thumbnail
79
+ // (non-interactive SlideCanvas) and once in the main interactive canvas. The
80
+ // interactive canvas renders last, so take the final match.
81
+ function findInteractiveWrapper(elementId: string): HTMLElement {
82
+ const els = document.querySelectorAll(`[data-element-id="${elementId}"]`)
83
+ if (els.length === 0) throw new Error(`element wrapper ${elementId} not found`)
84
+ return els[els.length - 1] as HTMLElement
85
+ }
86
+
87
+ describe('CarouselEditor — editor-core integration', () => {
88
+ it('renders the host-supplied assetsPanel slot', async () => {
89
+ const adapter = makeFakeAdapter()
90
+ const initial = makeProject()
91
+ const { getByTestId } = render(
92
+ <CarouselEditor
93
+ project={initial}
94
+ adapter={adapter}
95
+ onProjectChange={vi.fn()}
96
+ slots={{ assetsPanel: <div data-testid="assets" /> }}
97
+ />,
98
+ )
99
+ await waitFor(() => getByTestId('assets'))
100
+ // Regression: the assets slot must be width-bounded to the sidebar (w-80) so a
101
+ // wide host panel can't blow out the right column and crush the flex-1 canvas.
102
+ const wrapper = getByTestId('assets').parentElement
103
+ expect(wrapper?.className).toContain('w-80')
104
+ })
105
+
106
+ // Regression: SlideGrid thumbnails must receive `compileOverlay` so overlay
107
+ // elements render in the left rail. Before the fix the thumbnail used a
108
+ // noopCompiler that always rejected → a red "overlay error" badge on every
109
+ // overlay; adapter.compileOverlay was called ONCE (main canvas only). With the
110
+ // fix the thumbnail (non-interactive SlideCanvas) routes through
111
+ // adapter.compileOverlay too, so the SAME overlay is compiled twice
112
+ // (thumbnail + main). We assert the compiler is threaded to the thumbnail
113
+ // (call count ≥ 2) — the precise fix. (We don't assert the rendered overlay
114
+ // output: the fake factory can't render in jsdom, which is orthogonal to this
115
+ // bug; the real render is verified in the browser.)
116
+ it('threads compileOverlay into slide thumbnails (compiles overlay for thumbnail + main)', async () => {
117
+ const adapter = makeFakeAdapter()
118
+ const initial = makeProject({
119
+ slides: [
120
+ {
121
+ id: 'slide-ov',
122
+ base_color: '#ffffff',
123
+ elements: [
124
+ {
125
+ id: 'el-ov',
126
+ type: 'overlay',
127
+ overlay: { template: '/overlays/lp-text.jsx', props: { text: 'Puerta' } },
128
+ frame: 0,
129
+ x: 100, y: 800, w: 880, h: 160, rotation: 0,
130
+ },
131
+ ],
132
+ },
133
+ ],
134
+ })
135
+ render(<CarouselEditor project={initial} adapter={adapter} onProjectChange={vi.fn()} />)
136
+ // ≥2 calls proves the thumbnail uses adapter.compileOverlay (not noopCompiler).
137
+ // Under the bug this is exactly 1 (main canvas only) and this times out.
138
+ await waitFor(() =>
139
+ expect((adapter.compileOverlay as ReturnType<typeof vi.fn>).mock.calls.length).toBeGreaterThanOrEqual(2),
140
+ )
141
+ })
142
+
143
+ it('renders the host-supplied pendingStatus slot in the pending view', async () => {
144
+ const adapter = makeFakeAdapter()
145
+ const initial = makeProject({ status: 'pending', slides: [] })
146
+ const { getByTestId, queryByText } = render(
147
+ <CarouselEditor
148
+ project={initial}
149
+ adapter={adapter}
150
+ onProjectChange={vi.fn()}
151
+ slots={{ pendingStatus: <div data-testid="pending-status">Agent is working: → step 2</div> }}
152
+ />,
153
+ )
154
+ await waitFor(() => getByTestId('pending-status'))
155
+ // The slot replaces the default empty-state copy.
156
+ expect(queryByText('Message your agent to start')).toBeNull()
157
+ })
158
+
159
+ it('shows the default empty-state copy when pendingStatus slot is absent', async () => {
160
+ const adapter = makeFakeAdapter()
161
+ const initial = makeProject({ status: 'pending', slides: [] })
162
+ const { getByText } = render(
163
+ <CarouselEditor project={initial} adapter={adapter} onProjectChange={vi.fn()} />,
164
+ )
165
+ await waitFor(() => getByText('Message your agent to start'))
166
+ })
167
+
168
+ it('selecting an element, moving it, then undo reverts the position', async () => {
169
+ const adapter = makeFakeAdapter()
170
+ const initial = makeProject()
171
+
172
+ render(
173
+ <CarouselEditor
174
+ project={initial}
175
+ adapter={adapter}
176
+ onProjectChange={vi.fn()}
177
+ slots={{ assetsPanel: <div data-testid="assets" /> }}
178
+ />,
179
+ )
180
+
181
+ // The interactive slide canvas renders the image element wrapper.
182
+ const wrapper = await waitFor(() => findInteractiveWrapper('el-img'))
183
+
184
+ // Select the element (click).
185
+ await act(async () => { fireEvent.click(wrapper) })
186
+
187
+ // Perform a drag: pointer-down on the wrapper, move on window, up on window.
188
+ await act(async () => {
189
+ fireEvent.pointerDown(wrapper, { clientX: 150, clientY: 150 })
190
+ fireEvent.pointerMove(window, { clientX: 250, clientY: 250 })
191
+ fireEvent.pointerUp(window)
192
+ })
193
+
194
+ // The move + commit persisted a new position via the adapter.
195
+ await waitFor(() => {
196
+ expect(adapter.saveCalls.length).toBeGreaterThan(0)
197
+ })
198
+ const movedSave = adapter.saveCalls[adapter.saveCalls.length - 1].project
199
+ const movedEl = movedSave.slides![0].elements[0]
200
+ expect(movedEl.x).not.toBe(100)
201
+
202
+ const savesBeforeUndo = adapter.saveCalls.length
203
+
204
+ // Undo via keyboard shortcut (Cmd/Ctrl+Z). Guarded paths require the target
205
+ // not be a text input — fire on document.body.
206
+ await act(async () => {
207
+ fireEvent.keyDown(window, { key: 'z', ctrlKey: true })
208
+ })
209
+
210
+ // Undo enqueues a save that restores the original position.
211
+ await waitFor(() => {
212
+ expect(adapter.saveCalls.length).toBeGreaterThan(savesBeforeUndo)
213
+ })
214
+ const undoneSave = adapter.saveCalls[adapter.saveCalls.length - 1].project
215
+ const undoneEl = undoneSave.slides![0].elements[0]
216
+ expect(undoneEl.x).toBe(100)
217
+ expect(undoneEl.y).toBe(100)
218
+ })
219
+
220
+ it('does not fire undo while typing in an input', async () => {
221
+ const adapter = makeFakeAdapter()
222
+ const initial = makeProject()
223
+ render(<CarouselEditor project={initial} adapter={adapter} onProjectChange={vi.fn()} />)
224
+
225
+ await waitFor(() => findInteractiveWrapper('el-img'))
226
+
227
+ const input = document.createElement('input')
228
+ document.body.appendChild(input)
229
+ input.focus()
230
+
231
+ const before = adapter.saveCalls.length
232
+ await act(async () => {
233
+ fireEvent.keyDown(input, { key: 'z', ctrlKey: true })
234
+ })
235
+ // No undo save should have been enqueued.
236
+ expect(adapter.saveCalls.length).toBe(before)
237
+ document.body.removeChild(input)
238
+ })
239
+
240
+ // Visibility toggle: ids in `hiddenElementIds` are omitted from the interactive
241
+ // canvas (editor-only; the thumbnail and `saveProject` are untouched).
242
+ it('omits hidden elements from the interactive canvas', async () => {
243
+ const adapter = makeFakeAdapter()
244
+ const initial = makeProject({
245
+ slides: [
246
+ {
247
+ id: 'slide-0',
248
+ base_color: '#ffffff',
249
+ elements: [
250
+ { id: 'el-a', type: 'image', src: 'a.png', x: 0, y: 0, w: 100, h: 100, rotation: 0 },
251
+ { id: 'el-b', type: 'image', src: 'b.png', x: 10, y: 10, w: 100, h: 100, rotation: 0 },
252
+ ],
253
+ },
254
+ ],
255
+ })
256
+ const { container } = render(
257
+ <CarouselEditor project={initial} adapter={adapter} onProjectChange={vi.fn()} hiddenElementIds={['el-b']} />,
258
+ )
259
+ // Visible element renders in the interactive canvas; hidden one does not.
260
+ await waitFor(() => expect(container.querySelector('[data-interactive] [data-element-id="el-a"]')).not.toBeNull())
261
+ expect(container.querySelector('[data-interactive] [data-element-id="el-b"]')).toBeNull()
262
+ })
263
+
264
+ // onSelectionChange fires with the selected element, and with null on deselect.
265
+ it('fires onSelectionChange on select and deselect', async () => {
266
+ const adapter = makeFakeAdapter()
267
+ const initial = makeProject()
268
+ const onSelectionChange = vi.fn()
269
+ const { container } = render(
270
+ <CarouselEditor project={initial} adapter={adapter} onProjectChange={vi.fn()} onSelectionChange={onSelectionChange} />,
271
+ )
272
+
273
+ const lastSelection = () => {
274
+ const calls = onSelectionChange.mock.calls
275
+ return calls[calls.length - 1]?.[0]
276
+ }
277
+
278
+ const wrapper = await waitFor(() => findInteractiveWrapper('el-img'))
279
+ await act(async () => { fireEvent.click(wrapper) })
280
+ await waitFor(() => {
281
+ expect(lastSelection()?.id).toBe('el-img')
282
+ })
283
+
284
+ // Click the interactive canvas background to clear selection.
285
+ const root = container.querySelector('[data-interactive]') as HTMLElement
286
+ await act(async () => { fireEvent.click(root) })
287
+ await waitFor(() => {
288
+ expect(lastSelection()).toBeNull()
289
+ })
290
+ })
291
+ })