@hyperframes/studio 0.9.21 → 0.9.22

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 (39) hide show
  1. package/dist/assets/codec-DLDwVbqW.js +314 -0
  2. package/dist/assets/{hyperframes-player-DqxUNa9H.js → hyperframes-player-C5DA6O5u.js} +1 -1
  3. package/dist/assets/index-B6RxZt-8.js +150 -0
  4. package/dist/assets/{index-Cq43Ovkf.js → index-Buvugo_O.js} +120 -119
  5. package/dist/assets/pausedVideoDecoder-BGKlQc66.js +1 -0
  6. package/dist/{chunk-3EAFE522.js → chunk-45KKBU63.js} +1 -1
  7. package/dist/chunk-4SPHDECE.js +165 -0
  8. package/dist/{chunk-OGIOFEC7.js → chunk-63DH4LRB.js} +13 -2
  9. package/dist/{chunk-NUS5R2HO.js → chunk-AX6G6YL5.js} +1 -1
  10. package/dist/{domEditingLayers-7Z6J4UOK.js → domEditingLayers-7Q56QAU5.js} +2 -2
  11. package/dist/index.d.ts +5 -1
  12. package/dist/index.html +1 -1
  13. package/dist/index.js +104 -195
  14. package/dist/pausedVideoDecoder-KBQXSWFQ.js +393 -0
  15. package/dist/player.js +2 -2
  16. package/package.json +9 -9
  17. package/src/components/editor/domEditingDom.preview.test.ts +75 -0
  18. package/src/components/editor/domEditingDom.ts +19 -2
  19. package/src/components/nle/NLEContext.tsx +4 -1
  20. package/src/hooks/useElementPicker.test.ts +13 -0
  21. package/src/hooks/useElementPicker.ts +3 -2
  22. package/src/player/components/PlayerControls.test.tsx +1 -1
  23. package/src/player/components/PlayerControls.tsx +1 -1
  24. package/src/player/components/PreviewSeekBar.test.tsx +42 -0
  25. package/src/player/components/PreviewSeekBar.tsx +20 -3
  26. package/src/player/hooks/usePlaybackKeyboard.test.ts +1 -1
  27. package/src/player/hooks/usePlaybackKeyboard.ts +2 -1
  28. package/src/player/hooks/useTimelinePlayer.ts +3 -1
  29. package/src/player/lib/mediaFetch.test.ts +3 -4
  30. package/src/player/lib/pausedVideoDecoder.test.ts +644 -0
  31. package/src/player/lib/pausedVideoDecoder.ts +428 -0
  32. package/src/player/lib/pausedVideoProvider.test.ts +53 -0
  33. package/src/player/lib/pausedVideoProvider.ts +54 -0
  34. package/src/player/lib/playbackTypes.ts +8 -2
  35. package/src/player/lib/previewVideoTime.test.ts +38 -0
  36. package/src/player/lib/previewVideoTime.ts +39 -0
  37. package/src/utils/authoredSource.test.ts +11 -0
  38. package/src/utils/authoredSource.ts +2 -0
  39. package/dist/assets/index-CFUJyYA1.js +0 -531
@@ -0,0 +1,393 @@
1
+ import {
2
+ mediaUrlSourceOptions
3
+ } from "./chunk-4SPHDECE.js";
4
+ import "./chunk-MLKGABMK.js";
5
+
6
+ // src/player/lib/pausedVideoDecoder.ts
7
+ import {
8
+ ALL_FORMATS,
9
+ Input,
10
+ UrlSource,
11
+ VideoSampleSink
12
+ } from "mediabunny";
13
+
14
+ // src/player/lib/previewVideoTime.ts
15
+ var LEAD = 1e-5;
16
+ var FRAME_EPSILON = 1e-9;
17
+ var constantRate = (timing) => !timing.variableFrameRate && (timing.frameRate ?? 0) > 0;
18
+ function previewDecodeTime(time, timing) {
19
+ const { sourceLead, inputLead, timeResolution, frameRate = 0 } = timing;
20
+ if (!constantRate(timing))
21
+ return Math.max(inputLead, time - sourceLead + inputLead) + FRAME_EPSILON;
22
+ const index = Math.max(0, Math.floor((time - sourceLead) * frameRate + FRAME_EPSILON));
23
+ const ideal = inputLead + index / frameRate;
24
+ return (timeResolution > 0 ? Math.round(ideal * timeResolution) / timeResolution : ideal) + LEAD;
25
+ }
26
+ function previewPresentationTime(timestamp, requested, timing) {
27
+ const { frameRate = 0, sourceLead, inputLead } = timing;
28
+ const logical = constantRate(timing) ? Math.round((timestamp - inputLead) * frameRate) / frameRate + sourceLead : timestamp - inputLead + sourceLead;
29
+ const start = Math.min(requested, logical);
30
+ return {
31
+ timestamp: start,
32
+ duration: Math.max(constantRate(timing) ? 1 / frameRate : 0, requested - start + LEAD)
33
+ };
34
+ }
35
+
36
+ // src/player/lib/pausedVideoDecoder.ts
37
+ var FRAME_BUDGET = 64 * 1024 * 1024;
38
+ var MAX_READERS = 4;
39
+ var NEARBY_FORWARD_SECONDS = 0.5;
40
+ async function readSingleSample(reader, query) {
41
+ if (!reader.transparent) return reader.sink.getSample(query);
42
+ let selected = null;
43
+ try {
44
+ for await (const next of reader.sink.samplesAtTimestamps([query])) {
45
+ selected?.close();
46
+ selected = next;
47
+ }
48
+ return selected;
49
+ } catch (error) {
50
+ selected?.close();
51
+ throw error;
52
+ }
53
+ }
54
+ function createPausedVideoDecoder(iframe) {
55
+ const readers = /* @__PURE__ */ new Map();
56
+ const opened = /* @__PURE__ */ new Map();
57
+ const opening = /* @__PURE__ */ new Map();
58
+ const failed = /* @__PURE__ */ new Map();
59
+ const cacheOrder = /* @__PURE__ */ new Map();
60
+ let bytes = 0;
61
+ let disposed = false;
62
+ const sourceFacts = (source) => {
63
+ let path = new URL(source, location.href).pathname;
64
+ try {
65
+ path = decodeURIComponent(path);
66
+ } catch {
67
+ }
68
+ return Object.entries(
69
+ iframe.contentWindow?.__HF_MEDIA_SOURCE_FACTS__ ?? {}
70
+ ).filter(([suffix]) => path.endsWith(suffix)).sort(([a], [b]) => b.length - a.length)[0]?.[1];
71
+ };
72
+ const trim = (budget = FRAME_BUDGET) => {
73
+ for (const [entry, reader] of cacheOrder) {
74
+ if (bytes <= budget) break;
75
+ if (entry.pins > 0) continue;
76
+ cacheOrder.delete(entry);
77
+ reader.cache.delete(entry.timestamp);
78
+ bytes -= entry.bytes;
79
+ entry.image.close();
80
+ }
81
+ };
82
+ const disposeReader = async (reader) => {
83
+ if (reader.disposed) return;
84
+ reader.disposed = true;
85
+ clearTimeout(reader.idleTimer);
86
+ if (opened.get(reader.key) === reader) opened.delete(reader.key);
87
+ if (reader.transparent) await reader.tail;
88
+ reader.cancelReads();
89
+ reader.input.dispose();
90
+ await closeIterator(reader).catch(() => {
91
+ });
92
+ for (const entry of reader.cache.values()) {
93
+ cacheOrder.delete(entry);
94
+ bytes -= entry.bytes;
95
+ entry.image.close();
96
+ }
97
+ reader.cache.clear();
98
+ reader.canvas.width = reader.canvas.height = 0;
99
+ };
100
+ const scheduleIdle = (reader) => {
101
+ clearTimeout(reader.idleTimer);
102
+ if (reader.disposed || reader.users > 0 || [...reader.cache.values()].some((entry) => entry.pins > 0))
103
+ return;
104
+ reader.idleTimer = setTimeout(() => {
105
+ if (reader.users > 0 || [...reader.cache.values()].some((entry) => entry.pins > 0)) return;
106
+ if (opened.get(reader.key) !== reader) return;
107
+ readers.delete(reader.key);
108
+ void disposeReader(reader);
109
+ }, 1e4);
110
+ };
111
+ const open = async (source) => {
112
+ const options = mediaUrlSourceOptions("thumbnail");
113
+ const input = new Input({ source: new UrlSource(source, options), formats: ALL_FORMATS });
114
+ opening.set(input, options.cancelReads);
115
+ try {
116
+ const track = await input.getPrimaryVideoTrack();
117
+ if (!track || disposed) throw new Error("Preview video unavailable");
118
+ const [width, height, lead, ticks, squareWidth, squareHeight, rotation, flip, transparent] = await Promise.all([
119
+ track.getDisplayWidth(),
120
+ track.getDisplayHeight(),
121
+ track.getFirstTimestamp(),
122
+ track.getTimeResolution(),
123
+ track.getSquarePixelWidth(),
124
+ track.getSquarePixelHeight(),
125
+ track.getRotation(),
126
+ track.getFlip(),
127
+ track.canBeTransparent()
128
+ ]);
129
+ const canvas = document.createElement("canvas");
130
+ canvas.width = Math.max(1, Math.ceil(width));
131
+ const aspect = rotation % 180 === 0 ? squareWidth / squareHeight : squareHeight / squareWidth;
132
+ canvas.height = Math.max(1, Math.round(canvas.width / aspect));
133
+ return {
134
+ key: source,
135
+ input,
136
+ cancelReads: options.cancelReads,
137
+ sink: new VideoSampleSink(track),
138
+ canvas,
139
+ rotation,
140
+ flip,
141
+ width,
142
+ height,
143
+ lead,
144
+ ticks,
145
+ transparent,
146
+ tail: Promise.resolve(),
147
+ iterator: null,
148
+ iteratorEnd: 0,
149
+ lastTime: -Infinity,
150
+ cache: /* @__PURE__ */ new Map(),
151
+ users: 0,
152
+ disposed: false
153
+ };
154
+ } catch (error) {
155
+ input.dispose();
156
+ options.cancelReads();
157
+ throw error;
158
+ } finally {
159
+ opening.delete(input);
160
+ }
161
+ };
162
+ const reserveReader = () => {
163
+ for (const [oldKey] of readers) {
164
+ if (readers.size < MAX_READERS) break;
165
+ const old = opened.get(oldKey);
166
+ if (old && old.users === 0 && ![...old.cache.values()].some((entry) => entry.pins > 0)) {
167
+ readers.delete(oldKey);
168
+ void disposeReader(old);
169
+ }
170
+ }
171
+ if (readers.size >= MAX_READERS) throw new Error("Preview decoder budget reached");
172
+ };
173
+ const readerFor = async (source) => {
174
+ const key = source;
175
+ if ((failed.get(key) ?? 0) > performance.now()) throw new Error("Preview decoder cooling down");
176
+ let promise = readers.get(key);
177
+ if (!promise) {
178
+ reserveReader();
179
+ promise = open(source);
180
+ readers.set(key, promise);
181
+ }
182
+ readers.delete(key);
183
+ readers.set(key, promise);
184
+ let reader;
185
+ try {
186
+ reader = await promise;
187
+ } catch (error) {
188
+ if (readers.get(key) === promise) {
189
+ readers.delete(key);
190
+ failed.set(key, performance.now() + 5e3);
191
+ }
192
+ throw error;
193
+ }
194
+ if (disposed || reader.disposed) throw new DOMException("Preview disposed", "AbortError");
195
+ opened.set(key, reader);
196
+ reader.users++;
197
+ clearTimeout(reader.idleTimer);
198
+ return reader;
199
+ };
200
+ const closeIterator = async (reader) => {
201
+ const iterator = reader.iterator;
202
+ reader.iterator = null;
203
+ await iterator?.return();
204
+ };
205
+ const checkActive = (reader, signal) => {
206
+ signal.throwIfAborted();
207
+ if (disposed || reader.disposed) throw new Error("Preview disposed");
208
+ };
209
+ const readForward = async (reader, query, signal) => {
210
+ if (!reader.iterator) {
211
+ reader.iteratorEnd = query + 8;
212
+ reader.iterator = reader.sink.samples(query, reader.iteratorEnd);
213
+ }
214
+ for (; ; ) {
215
+ checkActive(reader, signal);
216
+ const next = await reader.iterator.next();
217
+ if (next.done) return null;
218
+ const sample = next.value;
219
+ let selected = false;
220
+ try {
221
+ checkActive(reader, signal);
222
+ if (sample.timestamp > query + 1e-6) return null;
223
+ selected = sample.timestamp + sample.duration > query + 1e-6;
224
+ if (selected) return sample;
225
+ } finally {
226
+ if (!selected) sample.close();
227
+ }
228
+ }
229
+ };
230
+ const pin = (reader, entry) => {
231
+ entry.pins++;
232
+ cacheOrder.delete(entry);
233
+ cacheOrder.set(entry, reader);
234
+ return entry;
235
+ };
236
+ const cacheFrame = async (reader, sample, time, timing, signal) => {
237
+ const context = reader.canvas.getContext("2d", { alpha: true });
238
+ if (!context) throw new Error("Preview canvas unavailable");
239
+ context.clearRect(0, 0, reader.canvas.width, reader.canvas.height);
240
+ context.imageSmoothingQuality = "high";
241
+ sample.drawWithFit(context, { fit: "fill", rotation: reader.rotation, flip: reader.flip });
242
+ const image = await createImageBitmap(reader.canvas);
243
+ if (signal.aborted || disposed || reader.disposed) {
244
+ image.close();
245
+ signal.throwIfAborted();
246
+ throw new Error("Preview disposed");
247
+ }
248
+ const entry = {
249
+ image,
250
+ ...previewPresentationTime(sample.timestamp, time, timing),
251
+ bytes: image.width * image.height * 4,
252
+ pins: 1
253
+ };
254
+ const previous = reader.cache.get(entry.timestamp);
255
+ if (previous) {
256
+ previous.duration = Math.max(previous.duration, entry.duration);
257
+ image.close();
258
+ return pin(reader, previous);
259
+ }
260
+ trim(FRAME_BUDGET - entry.bytes);
261
+ if (bytes + entry.bytes > FRAME_BUDGET) {
262
+ image.close();
263
+ throw new Error("Preview frame budget reached");
264
+ }
265
+ reader.cache.set(entry.timestamp, entry);
266
+ cacheOrder.set(entry, reader);
267
+ bytes += entry.bytes;
268
+ return entry;
269
+ };
270
+ const nearbyForward = (reader, time, timing) => (
271
+ // Mediabunny 1.65.2 can orphan alpha samples when a range is cancelled.
272
+ // Finite timestamp iterators drain the merger before closing it.
273
+ !reader.transparent && !timing.variableFrameRate && (timing.frameRate ?? 0) > 0 && time > reader.lastTime + 1e-6 && time - reader.lastTime <= NEARBY_FORWARD_SECONDS
274
+ );
275
+ const readFrame = async (reader, time, timing, signal) => {
276
+ checkActive(reader, signal);
277
+ const cached = [...reader.cache.values()].find(
278
+ (entry) => time >= entry.timestamp - 1e-6 && time < entry.timestamp + entry.duration - 1e-6
279
+ );
280
+ if (cached) return pin(reader, cached);
281
+ const query = previewDecodeTime(time, timing), forward = nearbyForward(reader, time, timing);
282
+ let sample = null;
283
+ try {
284
+ if (!forward || query >= reader.iteratorEnd) await closeIterator(reader);
285
+ sample = forward ? await readForward(reader, query, signal) : null;
286
+ if (!sample) {
287
+ await closeIterator(reader);
288
+ sample = await readSingleSample(reader, query);
289
+ }
290
+ if (!sample) throw new Error("No preview frame at requested time");
291
+ checkActive(reader, signal);
292
+ reader.lastTime = time;
293
+ return await cacheFrame(reader, sample, time, timing, signal);
294
+ } finally {
295
+ sample?.close();
296
+ if (signal.aborted || disposed) await closeIterator(reader).catch(() => {
297
+ });
298
+ }
299
+ };
300
+ const sourceTiming = (request, reader) => {
301
+ const facts = sourceFacts(request.source);
302
+ return {
303
+ frameRate: facts?.frameRate,
304
+ variableFrameRate: facts?.variableFrameRate,
305
+ sourceLead: reader.lead,
306
+ inputLead: reader.lead,
307
+ timeResolution: reader.ticks
308
+ };
309
+ };
310
+ const decodeOne = async (request, signal) => {
311
+ signal.throwIfAborted();
312
+ const source = request.source;
313
+ if (!source) throw new Error("Preview source unavailable");
314
+ const reader = await readerFor(source);
315
+ try {
316
+ const timing = sourceTiming(request, reader);
317
+ const job = reader.tail.then(() => readFrame(reader, request.time, timing, signal));
318
+ reader.tail = job.then(
319
+ () => {
320
+ },
321
+ () => {
322
+ }
323
+ );
324
+ const entry = await job;
325
+ let released = false;
326
+ trim();
327
+ return {
328
+ source: entry.image,
329
+ timestamp: entry.timestamp,
330
+ duration: entry.duration,
331
+ width: reader.width,
332
+ height: reader.height,
333
+ release() {
334
+ if (released) return;
335
+ released = true;
336
+ entry.pins--;
337
+ trim();
338
+ scheduleIdle(reader);
339
+ }
340
+ };
341
+ } finally {
342
+ reader.users--;
343
+ scheduleIdle(reader);
344
+ }
345
+ };
346
+ return {
347
+ async decode(requests, signal) {
348
+ if (disposed) throw new DOMException("Preview disposed", "AbortError");
349
+ if (new Set(requests.map(({ source }) => source)).size > MAX_READERS)
350
+ throw new Error("Preview decoder budget reached");
351
+ const results = await Promise.allSettled(
352
+ requests.map((request) => decodeOne(request, signal))
353
+ );
354
+ const failure = results.find((result) => result.status === "rejected");
355
+ const frames = results.flatMap(
356
+ (result) => result.status === "fulfilled" ? [result.value] : []
357
+ );
358
+ if (failure || disposed || signal.aborted) {
359
+ for (const frame of frames) frame.release();
360
+ if (failure) throw failure.reason;
361
+ throw new DOMException("Preview cancelled", "AbortError");
362
+ }
363
+ return frames;
364
+ },
365
+ async suspend() {
366
+ const closing = [...readers.values()].map(
367
+ (promise) => promise.then(disposeReader).catch(() => {
368
+ })
369
+ );
370
+ readers.clear();
371
+ for (const [input, cancel] of opening) {
372
+ cancel();
373
+ input.dispose();
374
+ }
375
+ await Promise.all(closing);
376
+ },
377
+ dispose() {
378
+ if (disposed) return;
379
+ disposed = true;
380
+ for (const [input, cancel] of opening) {
381
+ cancel();
382
+ input.dispose();
383
+ }
384
+ for (const promise of readers.values()) void promise.then(disposeReader).catch(() => {
385
+ });
386
+ readers.clear();
387
+ failed.clear();
388
+ }
389
+ };
390
+ }
391
+ export {
392
+ createPausedVideoDecoder
393
+ };
package/dist/player.js CHANGED
@@ -1,8 +1,8 @@
1
1
  import {
2
2
  Player
3
- } from "./chunk-NUS5R2HO.js";
3
+ } from "./chunk-AX6G6YL5.js";
4
4
  import "./chunk-7HZGKFFU.js";
5
- import "./chunk-OGIOFEC7.js";
5
+ import "./chunk-63DH4LRB.js";
6
6
  import "./chunk-MLKGABMK.js";
7
7
  export {
8
8
  Player
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hyperframes/studio",
3
- "version": "0.9.21",
3
+ "version": "0.9.22",
4
4
  "description": "",
5
5
  "repository": {
6
6
  "type": "git",
@@ -59,13 +59,13 @@
59
59
  "cn": "0.2.4",
60
60
  "dockview-react": "8.3.1",
61
61
  "gsap": "^3.13.0",
62
- "mediabunny": "^1.45.3",
63
- "@hyperframes/core": "0.9.21",
64
- "@hyperframes/player": "0.9.21",
65
- "@hyperframes/sdk": "0.9.21",
66
- "@hyperframes/shader-transitions": "0.9.21",
67
- "@hyperframes/parsers": "0.9.21",
68
- "@hyperframes/studio-server": "0.9.21"
62
+ "mediabunny": "^1.65.2",
63
+ "@hyperframes/player": "0.9.22",
64
+ "@hyperframes/shader-transitions": "0.9.22",
65
+ "@hyperframes/studio-server": "0.9.22",
66
+ "@hyperframes/core": "0.9.22",
67
+ "@hyperframes/parsers": "0.9.22",
68
+ "@hyperframes/sdk": "0.9.22"
69
69
  },
70
70
  "devDependencies": {
71
71
  "@tailwindcss/vite": "^4.3.3",
@@ -82,7 +82,7 @@
82
82
  "vite": "^6.4.2",
83
83
  "vitest": "^4.1.11",
84
84
  "zustand": "^5.0.0",
85
- "@hyperframes/producer": "0.9.21"
85
+ "@hyperframes/producer": "0.9.22"
86
86
  },
87
87
  "peerDependencies": {
88
88
  "react": "19",
@@ -0,0 +1,75 @@
1
+ // @vitest-environment jsdom
2
+ import { afterEach, expect, it } from "vitest";
3
+ import {
4
+ PREVIEW_VIDEO_FRAME_ATTR,
5
+ PREVIEW_VIDEO_CANVAS_ATTR,
6
+ } from "@hyperframes/core/studio-preview-mark";
7
+ import { getCuratedComputedStyles, isElementVisibleThroughAncestors } from "./domEditingDom";
8
+ import {
9
+ collectDomEditLayerItems,
10
+ resolveDomEditSelection,
11
+ resolveVisualDomEditSelectionTarget,
12
+ } from "./domEditing";
13
+
14
+ const options = { activeCompositionPath: "index.html", isMasterView: true, skipSourceProbe: true };
15
+ afterEach(() => {
16
+ document.body.innerHTML = "";
17
+ document.head.innerHTML = "";
18
+ });
19
+
20
+ function preview(opacity: string) {
21
+ document.head.innerHTML = `<style>[${PREVIEW_VIDEO_FRAME_ATTR}] { opacity: 0 !important; }</style>`;
22
+ document.body.innerHTML = `<main data-composition-id="main"><canvas ${PREVIEW_VIDEO_CANVAS_ATTR} style="opacity:${opacity}" data-hf-ignore></canvas><video id="clip" ${PREVIEW_VIDEO_FRAME_ATTR} style="opacity:${opacity}" src="clip.mp4"></video></main>`;
23
+ const video = document.querySelector("video")!;
24
+ const canvas = document.querySelector("canvas")!;
25
+ const root = document.querySelector("main")!;
26
+ Object.defineProperty(video, "getBoundingClientRect", {
27
+ value: () => ({
28
+ x: 10,
29
+ y: 20,
30
+ left: 10,
31
+ top: 20,
32
+ right: 210,
33
+ bottom: 120,
34
+ width: 200,
35
+ height: 100,
36
+ }),
37
+ });
38
+ return { video, canvas, root };
39
+ }
40
+
41
+ it("keeps a provider-backed video selectable and listed with its logical opacity", async () => {
42
+ const { video, canvas, root } = preview("0.65");
43
+ expect(getComputedStyle(video).opacity).toBe("0");
44
+ expect(isElementVisibleThroughAncestors(video)).toBe(true);
45
+ expect(resolveVisualDomEditSelectionTarget([canvas, video], options)).toBe(video);
46
+ expect(collectDomEditLayerItems(root, options).map((item) => item.element)).toEqual([video]);
47
+ const selected = await resolveDomEditSelection(video, options);
48
+ expect(selected?.computedStyles.opacity).toBe("0.65");
49
+ expect(selected?.inlineStyles.opacity).toBe("0.65");
50
+ expect(getComputedStyle(video).opacity).toBe("0");
51
+ });
52
+
53
+ it("keeps authored zero opacity invisible and reports zero to the inspector", async () => {
54
+ const { video, canvas } = preview("0");
55
+ expect(isElementVisibleThroughAncestors(video)).toBe(false);
56
+ expect(resolveVisualDomEditSelectionTarget([canvas, video], options)).toBeNull();
57
+ expect(getCuratedComputedStyles(video).opacity).toBe("0");
58
+ const selected = await resolveDomEditSelection(video, options);
59
+ expect(selected?.computedStyles.opacity).toBe("0");
60
+ expect(video.style.opacity).toBe("0");
61
+ });
62
+
63
+ it("still respects a hidden ancestor when the preview frame itself is visible", () => {
64
+ const { video, root } = preview("0.65");
65
+ root.style.opacity = "0";
66
+ expect(isElementVisibleThroughAncestors(video)).toBe(false);
67
+ expect(resolveVisualDomEditSelectionTarget([video], options)).toBeNull();
68
+ });
69
+
70
+ it("does not treat an unrelated preceding canvas as the video's visible frame", () => {
71
+ const { video, canvas } = preview("0.65");
72
+ canvas.removeAttribute(PREVIEW_VIDEO_CANVAS_ATTR);
73
+ expect(isElementVisibleThroughAncestors(video)).toBe(false);
74
+ expect(getCuratedComputedStyles(video).opacity).toBe("0");
75
+ });
@@ -3,6 +3,10 @@
3
3
  * selector utilities, and composition source resolution.
4
4
  * No imports from other domEditing* modules — safe to import from anywhere.
5
5
  */
6
+ import {
7
+ PREVIEW_VIDEO_FRAME_ATTR,
8
+ PREVIEW_VIDEO_CANVAS_ATTR,
9
+ } from "@hyperframes/core/studio-preview-mark";
6
10
  import { COLOR_GRADING_SOURCE_HIDDEN_ATTR } from "@hyperframes/core/color-grading";
7
11
  import { getSourceScopedSelectorIndex } from "../../utils/sourceScopedSelectorIndex";
8
12
  import { CURATED_STYLE_PROPERTIES } from "./domEditingTypes";
@@ -34,12 +38,24 @@ export function isEditableTextLeaf(el: HTMLElement): boolean {
34
38
  return isTextBearingTag(el.tagName.toLowerCase()) && el.children.length === 0;
35
39
  }
36
40
 
41
+ /** The preview canvas keeps the source's authored opacity while its native pixels are hidden. */
42
+ export function getLogicalOpacity(el: Element, computed: CSSStyleDeclaration): string {
43
+ const overlay = el.previousElementSibling;
44
+ if (
45
+ el.hasAttribute(PREVIEW_VIDEO_FRAME_ATTR) &&
46
+ overlay?.localName === "canvas" &&
47
+ overlay.hasAttribute(PREVIEW_VIDEO_CANVAS_ATTR)
48
+ )
49
+ return el.ownerDocument.defaultView?.getComputedStyle(overlay).opacity ?? computed.opacity;
50
+ return computed.opacity;
51
+ }
52
+
37
53
  /** Does this node render AT ALL, ignoring what it inherits? Sole owner of the
38
54
  * rule; the walk below only decides which nodes to ask it about. */
39
55
  function elementRendersItself(win: Window, el: HTMLElement): boolean {
40
56
  const computed = win.getComputedStyle(el);
41
57
  if (computed.display === "none" || computed.visibility === "hidden") return false;
42
- const opacity = Number.parseFloat(computed.opacity);
58
+ const opacity = Number.parseFloat(getLogicalOpacity(el, computed));
43
59
  return !(
44
60
  Number.isFinite(opacity) &&
45
61
  opacity <= 0.01 &&
@@ -101,7 +117,8 @@ export function getCuratedComputedStyles(el: HTMLElement): Record<string, string
101
117
  if (!computed) return styles;
102
118
 
103
119
  for (const prop of CURATED_STYLE_PROPERTIES) {
104
- const value = computed.getPropertyValue(prop);
120
+ const value =
121
+ prop === "opacity" ? getLogicalOpacity(el, computed) : computed.getPropertyValue(prop);
105
122
  if (value) styles[prop] = value;
106
123
  }
107
124
 
@@ -23,7 +23,10 @@ export interface NLEContextValue {
23
23
  play: () => void;
24
24
  pause: () => void;
25
25
  togglePlay: () => void;
26
- seek: (time: number, options?: { keepPlaying?: boolean; follow?: boolean }) => boolean;
26
+ seek: (
27
+ time: number,
28
+ options?: { keepPlaying?: boolean; follow?: boolean; settled?: boolean },
29
+ ) => boolean;
27
30
  refreshPlayer: () => void;
28
31
  onIframeLoad: () => void;
29
32
  // The hidden reload iframe NLEPreview renders next to the live one during a full reload.
@@ -115,6 +115,19 @@ function mountPicker(
115
115
  };
116
116
  }
117
117
 
118
+ it.each(["0.65", "0"])(
119
+ "reads provider-backed video opacity %s in the picked-element inspector",
120
+ (opacity) => {
121
+ const mounted = `<style>[data-hf-preview-video-frame] { opacity: 0 !important; }</style><canvas data-hf-preview-video-canvas style="opacity:${opacity}"></canvas><video id="provider-video" data-hf-preview-video-frame style="opacity:${opacity}"></video>`;
122
+ const { iframe, picker } = mountPicker({ "index.html": SAVED }, "#provider-video", mounted);
123
+ expect(
124
+ iframe.contentWindow!.getComputedStyle(iframe.contentDocument!.querySelector("video")!)
125
+ .opacity,
126
+ ).toBe("0");
127
+ expect(picker().pickedElement?.computedStyles.opacity).toBe(opacity);
128
+ },
129
+ );
130
+
118
131
  describe("pick mode cancellation and hover feedback", () => {
119
132
  it("cancels pick mode when Escape is pressed with Studio focus", () => {
120
133
  const { picker } = mountPicker({ "index.html": SAVED });
@@ -12,7 +12,7 @@ import {
12
12
  postRuntimeControlMessage,
13
13
  } from "../player/lib/runtimeProtocol";
14
14
  import { compositionPathOfPreviewUrl } from "../player/components/CompositionThumbnail";
15
- import { getSourceFileForElement } from "../components/editor/domEditingDom";
15
+ import { getLogicalOpacity, getSourceFileForElement } from "../components/editor/domEditingDom";
16
16
  import {
17
17
  createElementPickerHoverLabel,
18
18
  type ElementPickerHoverInfo,
@@ -589,7 +589,8 @@ function readComputedStyles(iframe: HTMLIFrameElement, selector: string): Record
589
589
  ];
590
590
 
591
591
  for (const prop of props) {
592
- const val = computed.getPropertyValue(prop);
592
+ const val =
593
+ prop === "opacity" ? getLogicalOpacity(el, computed) : computed.getPropertyValue(prop);
593
594
  if (val) styles[prop] = val;
594
595
  }
595
596
  } catch {
@@ -57,7 +57,7 @@ describe("PlayerControls preview seeking", () => {
57
57
  setValue.call(input, String(time));
58
58
  input.dispatchEvent(new Event("input", { bubbles: true }));
59
59
  });
60
- expect(onSeek).toHaveBeenLastCalledWith(time);
60
+ expect(onSeek).toHaveBeenLastCalledWith(time, { settled: true });
61
61
  }
62
62
  expect(onSeek).toHaveBeenCalledTimes(4);
63
63
  });
@@ -161,7 +161,7 @@ const FullscreenButton = memo(function FullscreenButton({
161
161
 
162
162
  interface PlayerControlsProps {
163
163
  onTogglePlay: () => void;
164
- onSeek: (time: number) => void;
164
+ onSeek: (time: number, options?: { settled?: boolean }) => void;
165
165
  disabled?: boolean;
166
166
  isFullscreen?: boolean;
167
167
  onToggleFullscreen?: () => void;
@@ -0,0 +1,42 @@
1
+ // @vitest-environment happy-dom
2
+ import React, { act } from "react";
3
+ import { expect, it, vi } from "vitest";
4
+ import { PreviewSeekBar } from "./PreviewSeekBar";
5
+ import { createHappyDomRootHarness } from "./testRootHarness";
6
+
7
+ Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
8
+ const { mount } = createHappyDomRootHarness();
9
+
10
+ it("marks keyboard and released seeks as settled and pointer scrubbing as interactive", () => {
11
+ const host = document.createElement("div");
12
+ document.body.append(host);
13
+ const onSeek = vi.fn();
14
+ act(() => mount(host).render(<PreviewSeekBar duration={10} disabled={false} onSeek={onSeek} />));
15
+ const input = host.querySelector("input")!;
16
+ const change = (value: number) => {
17
+ Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")!.set!.call(
18
+ input,
19
+ String(value),
20
+ );
21
+ input.dispatchEvent(new Event("input", { bubbles: true }));
22
+ };
23
+ act(() => {
24
+ input.dispatchEvent(new KeyboardEvent("keydown", { key: "ArrowRight", bubbles: true }));
25
+ change(1);
26
+ });
27
+ expect(onSeek).toHaveBeenLastCalledWith(1, { settled: true });
28
+ act(() => {
29
+ input.dispatchEvent(new PointerEvent("pointerdown", { bubbles: true }));
30
+ change(2);
31
+ });
32
+ expect(onSeek).toHaveBeenLastCalledWith(2, { settled: false });
33
+ act(() => {
34
+ input.dispatchEvent(new PointerEvent("pointerup", { bubbles: true }));
35
+ });
36
+ expect(onSeek).toHaveBeenLastCalledWith(2, { settled: true });
37
+ act(() => {
38
+ input.dispatchEvent(new KeyboardEvent("keydown", { key: "ArrowRight", bubbles: true }));
39
+ change(3);
40
+ });
41
+ expect(onSeek).toHaveBeenLastCalledWith(3, { settled: true });
42
+ });