@hyperframes/studio 0.8.106 → 0.8.108

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 (184) hide show
  1. package/dist/assets/{hyperframes-player-dl6K6ABp.js → hyperframes-player-BakGew45.js} +1 -1
  2. package/dist/assets/{index-ooaZZhKf.js → index-C5dyUHwk.js} +1 -1
  3. package/dist/assets/{index-CMiYVGv5.js → index-C842tcVa.js} +203 -208
  4. package/dist/assets/{index-DKT5NF1Y.js → index-CPe7d_wO.js} +1 -1
  5. package/dist/assets/{index-lrT-gfHa.css → index-ncVJ5IVu.css} +1 -1
  6. package/dist/chunk-6LUNLTHR.js +611 -0
  7. package/dist/chunk-6LUNLTHR.js.map +1 -0
  8. package/dist/{chunk-ICTZJPQQ.js → chunk-AOWVEVEU.js} +3 -494
  9. package/dist/chunk-AOWVEVEU.js.map +1 -0
  10. package/dist/{chunk-46XP7J3B.js → chunk-PQFEBX32.js} +5 -3
  11. package/dist/chunk-PQFEBX32.js.map +1 -0
  12. package/dist/{domEditingLayers-AQBDFNUC.js → domEditingLayers-JQPQGGT7.js} +3 -3
  13. package/dist/index.d.ts +377 -12
  14. package/dist/index.html +2 -2
  15. package/dist/index.js +13445 -11874
  16. package/dist/index.js.map +1 -1
  17. package/dist/player.js +2 -2
  18. package/dist/styles.css +1 -1
  19. package/package.json +8 -8
  20. package/src/App.tsx +6 -3
  21. package/src/agentToolsExport.test.ts +8 -0
  22. package/src/captions/keyboard.test.ts +6 -0
  23. package/src/components/EditorShell.tsx +2 -0
  24. package/src/components/StudioRightPanels.tsx +2 -0
  25. package/src/components/TimelineToolbar.test.tsx +27 -0
  26. package/src/components/TimelineToolbar.tsx +2 -5
  27. package/src/components/editor/CropPresetBar.tsx +69 -0
  28. package/src/components/editor/DomEditCropHandles.test.tsx +44 -0
  29. package/src/components/editor/DomEditCropHandles.tsx +123 -95
  30. package/src/components/editor/DomEditOverlay.tsx +12 -18
  31. package/src/components/editor/PropertyPanel.tsx +1 -14
  32. package/src/components/editor/PropertyPanelFlat.tsx +3 -6
  33. package/src/components/editor/SnapToolbar.test.tsx +32 -1
  34. package/src/components/editor/SnapToolbar.tsx +3 -4
  35. package/src/components/editor/carveOutput.ts +54 -0
  36. package/src/components/editor/cropPresetStore.ts +33 -0
  37. package/src/components/editor/cropPresets.test.ts +41 -0
  38. package/src/components/editor/cropPresets.ts +24 -0
  39. package/src/components/editor/domEditOverlayStartGesture.ts +5 -2
  40. package/src/components/editor/domEditingLayers.test.ts +21 -0
  41. package/src/components/editor/domEditingLayers.ts +2 -0
  42. package/src/components/editor/dragUndoPaint.test.ts +71 -0
  43. package/src/components/editor/fontAssets.test.ts +12 -22
  44. package/src/components/editor/gestureHoldsPreviewReload.test.tsx +96 -33
  45. package/src/components/editor/gsapAnimatesProperty.ts +3 -0
  46. package/src/components/editor/manualEdits.test.ts +4 -3
  47. package/src/components/editor/manualEditsDom.ts +28 -5
  48. package/src/components/editor/manualEditsDomPatches.ts +5 -1
  49. package/src/components/editor/manualOffsetDrag.ts +15 -1
  50. package/src/components/editor/mediaAudioEdits.test.ts +271 -0
  51. package/src/components/editor/mediaAudioEdits.ts +282 -0
  52. package/src/components/editor/propertyPanelAudioFxGroup.test.tsx +32 -4
  53. package/src/components/editor/propertyPanelAudioFxGroup.tsx +3 -1
  54. package/src/components/editor/propertyPanelFlatMediaSection.test.tsx +290 -87
  55. package/src/components/editor/propertyPanelFlatMediaSection.tsx +17 -20
  56. package/src/components/editor/propertyPanelFlatProps.ts +1 -0
  57. package/src/components/editor/propertyPanelMediaSection.tsx +17 -27
  58. package/src/components/editor/propertyPanelTypes.ts +2 -0
  59. package/src/components/editor/useDomEditNudge.test.tsx +134 -2
  60. package/src/components/editor/useDomEditNudge.ts +46 -23
  61. package/src/components/editor/useDomEditOverlayGestures.ts +17 -6
  62. package/src/components/editor/useFxCarve.ts +3 -61
  63. package/src/components/editor/useFxCarveGrouping.test.ts +13 -0
  64. package/src/components/editor/useFxCarveGrouping.ts +8 -3
  65. package/src/components/nle/AudioMeterStrip.test.tsx +53 -0
  66. package/src/components/nle/AudioMeterStrip.tsx +60 -2
  67. package/src/components/nle/useTimelineEditCallbacks.ts +4 -0
  68. package/src/components/panels/SlideshowPanel.test.ts +27 -0
  69. package/src/components/panels/SlideshowPanel.tsx +12 -7
  70. package/src/contexts/DomEditContext.test.tsx +62 -0
  71. package/src/contexts/DomEditContext.tsx +94 -77
  72. package/src/contexts/TimelineEditContext.tsx +1 -0
  73. package/src/hooks/canvasQuickSaves.test.tsx +72 -7
  74. package/src/hooks/domEditCommitTypes.ts +10 -0
  75. package/src/hooks/domEditPersistFailure.ts +12 -1
  76. package/src/hooks/domStyleCommit.fonts.test.ts +5 -4
  77. package/src/hooks/domStyleCommit.ts +2 -8
  78. package/src/hooks/gsapDragCommit.ts +3 -8
  79. package/src/hooks/gsapDragPositionCommit.ts +6 -1
  80. package/src/hooks/gsapEditOutcome.ts +2 -1
  81. package/src/hooks/gsapResizeElementSize.test.tsx +136 -0
  82. package/src/hooks/gsapResizeGeometrySweep.test.ts +3 -1
  83. package/src/hooks/gsapResizeIntercept.test.ts +3 -11
  84. package/src/hooks/gsapResizeIntercept.ts +6 -2
  85. package/src/hooks/gsapResizeMixedTween.test.ts +1 -2
  86. package/src/hooks/gsapRuntimeBridge.test.ts +55 -0
  87. package/src/hooks/gsapRuntimeBridge.ts +5 -3
  88. package/src/hooks/gsapRuntimeKeyframes.ts +1 -3
  89. package/src/hooks/inspectorSaveReload.test.tsx +107 -0
  90. package/src/hooks/useAppHotkeys.previewForwarding.test.tsx +16 -1
  91. package/src/hooks/useAppHotkeys.test.ts +17 -0
  92. package/src/hooks/useAppHotkeys.textEditing.test.tsx +1 -1
  93. package/src/hooks/useAppHotkeys.ts +3 -3
  94. package/src/hooks/useAutomationSelectionKeyboard.test.tsx +17 -0
  95. package/src/hooks/useAutomationSelectionKeyboard.ts +3 -9
  96. package/src/hooks/useDomEditAttributeCommits.ts +71 -29
  97. package/src/hooks/useDomEditCommits.test.tsx +172 -92
  98. package/src/hooks/useDomEditCommits.ts +2 -0
  99. package/src/hooks/useDomEditCommitsHelpers.ts +4 -6
  100. package/src/hooks/useDomEditPersist.ts +28 -13
  101. package/src/hooks/useDomEditPositionPatchCommit.ts +2 -0
  102. package/src/hooks/useDomEditSession.ts +2 -3
  103. package/src/hooks/useDomEditTextCommits.ts +4 -8
  104. package/src/hooks/useDomGeometryCommits.ts +11 -2
  105. package/src/hooks/useEditHistoryActions.paint.test.tsx +163 -3
  106. package/src/hooks/useEditHistoryActions.ts +13 -4
  107. package/src/hooks/useElementPicker.test.ts +62 -13
  108. package/src/hooks/useElementPicker.ts +10 -2
  109. package/src/hooks/useFreezeFrame.test.ts +56 -0
  110. package/src/hooks/useFreezeFrame.ts +121 -0
  111. package/src/hooks/useGsapAwareEditing.ts +6 -6
  112. package/src/hooks/useGsapScriptCommits.test.tsx +19 -0
  113. package/src/hooks/useGsapScriptCommits.ts +5 -4
  114. package/src/hooks/useInlineTextEdit.test.tsx +27 -0
  115. package/src/hooks/useInlineTextEdit.ts +9 -7
  116. package/src/hooks/useKeyframeKeyboard.test.tsx +15 -0
  117. package/src/hooks/useKeyframeKeyboard.ts +2 -8
  118. package/src/hooks/usePersistentEditHistory.test.ts +9 -6
  119. package/src/hooks/usePersistentEditHistory.ts +1 -1
  120. package/src/hooks/usePreviewPersistence.ts +6 -0
  121. package/src/hooks/useRazorSplit.ts +14 -1
  122. package/src/hooks/useRenderClipContent.test.ts +102 -0
  123. package/src/hooks/useRenderClipContent.ts +30 -23
  124. package/src/hooks/useTimelineEditing.ts +2 -2
  125. package/src/hooks/useTrackPendingTimelineEdit.ts +2 -6
  126. package/src/index.ts +8 -0
  127. package/src/player/components/AudibleVideoClipContent.tsx +29 -0
  128. package/src/player/components/ClipBadges.test.tsx +82 -0
  129. package/src/player/components/ClipBadges.tsx +67 -0
  130. package/src/player/components/ClipContextMenu.tsx +22 -0
  131. package/src/player/components/ClipPeakMarks.test.tsx +41 -0
  132. package/src/player/components/ClipPeakMarks.tsx +71 -0
  133. package/src/player/components/Timeline.test.ts +0 -21
  134. package/src/player/components/Timeline.tsx +0 -1
  135. package/src/player/components/TimelineClip.tsx +2 -0
  136. package/src/player/components/TimelineFxButton.test.tsx +2 -2
  137. package/src/player/components/TimelineTrackHeader.test.tsx +37 -0
  138. package/src/player/components/TimelineTrackHeader.tsx +12 -25
  139. package/src/player/components/clipMenuAudioItems.test.tsx +125 -0
  140. package/src/player/components/clipMenuAudioItems.tsx +108 -0
  141. package/src/player/components/clipMenuDuck.test.ts +117 -0
  142. package/src/player/components/clipMenuDuck.ts +142 -0
  143. package/src/player/components/clipMenuNormalize.test.ts +95 -0
  144. package/src/player/components/clipMenuNormalize.ts +96 -0
  145. package/src/player/components/clipMenuToolItems.test.tsx +139 -0
  146. package/src/player/components/clipMenuToolItems.tsx +235 -0
  147. package/src/player/components/clipPeakRuns.test.ts +38 -0
  148. package/src/player/components/clipPeakRuns.ts +59 -0
  149. package/src/player/components/clipToolAttrs.test.ts +161 -0
  150. package/src/player/components/clipToolAttrs.ts +187 -0
  151. package/src/player/components/timelineCallbacks.ts +1 -0
  152. package/src/player/components/timelineLayout.ts +0 -28
  153. package/src/player/components/useClipToolState.ts +92 -0
  154. package/src/player/hooks/usePlaybackKeyboard.test.ts +43 -0
  155. package/src/player/lib/playbackShortcuts.ts +3 -7
  156. package/src/player/lib/timelineElementHelpers.test.ts +16 -0
  157. package/src/player/lib/timelineElementHelpers.ts +25 -2
  158. package/src/player/lib/timelineViewportBudgets.test.ts +2 -0
  159. package/src/player/lib/timelineViewportBudgets.ts +4 -0
  160. package/src/timelineChromeExports.test.tsx +7 -0
  161. package/src/utils/audioMeterMath.test.ts +37 -0
  162. package/src/utils/audioMeterMath.ts +9 -3
  163. package/src/utils/exportPeakCeiling.ts +1 -0
  164. package/src/utils/gsapSoftReload.ts +3 -2
  165. package/src/utils/gsapUndoRestore.browser.test.ts +94 -0
  166. package/src/utils/gsapUndoRestore.test.ts +145 -1
  167. package/src/utils/gsapUndoRestore.ts +70 -21
  168. package/src/utils/previewRelativePath.ts +19 -0
  169. package/src/utils/sourcePatcher.ts +2 -2
  170. package/src/utils/studioFontHelpers.ts +2 -23
  171. package/src/utils/studioHelpers.test.ts +30 -0
  172. package/src/utils/studioHelpers.ts +18 -4
  173. package/src/utils/studioPendingEdits.test.ts +129 -0
  174. package/src/utils/studioPendingEdits.ts +61 -18
  175. package/src/utils/timelineInspector.test.ts +33 -2
  176. package/src/utils/timelineInspector.ts +16 -4
  177. package/src/utils/typingTarget.test.ts +13 -0
  178. package/src/utils/typingTarget.ts +5 -2
  179. package/src/webmcp/useStudioAgentTools.ts +3 -1
  180. package/dist/chunk-46XP7J3B.js.map +0 -1
  181. package/dist/chunk-DI4LCJHL.js +0 -102
  182. package/dist/chunk-DI4LCJHL.js.map +0 -1
  183. package/dist/chunk-ICTZJPQQ.js.map +0 -1
  184. /package/dist/{domEditingLayers-AQBDFNUC.js.map → domEditingLayers-JQPQGGT7.js.map} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/utils/sourceScopedSelectorIndex.ts","../src/player/lib/playbackAdapter.ts","../src/player/lib/timelineElementHelpers.ts","../src/utils/projectRouting.ts"],"sourcesContent":["/**\n * Occurrence index for a selector within its source document.\n *\n * The preview flattens multiple composition files into one DOM, so a raw\n * `querySelectorAll` index is not a stable source-file identity. Callers supply\n * their existing source resolver; this helper alone owns occurrence scoping.\n */\n\n/** Every element matching one selector, mapped to the source file it belongs to\n * and its occurrence index within that file. One document query fills it. */\ntype SelectorOccurrences = Map<Element, { scope: string; index: number }>;\n\ninterface SelectorIndexPass {\n doc: Document;\n bySelector: Map<string, SelectorOccurrences>;\n}\n\nlet activePass: SelectorIndexPass | null = null;\n\n/**\n * Share one occurrence index per selector across every\n * `getSourceScopedSelectorIndex` call made synchronously inside `run`.\n *\n * Unshared, each call runs its own whole-document `querySelectorAll(selector)`\n * and resolves the source file of every match. A rebuild that walks n elements\n * sharing a selector therefore does n whole-document queries and n² resolver\n * calls — a composition of repeated cards or tiles is exactly that shape. One\n * index per selector makes the same pass linear.\n *\n * Correctness rests on the pass being ONE synchronous walk of a document that\n * does not change under it: nothing invalidates the index, so `run` must not\n * mutate `doc`, and every call inside it must resolve source files the same way\n * (the resolver may be a fresh closure per call, as long as it answers the\n * same). Outside a pass the index is per-call, exactly as before.\n */\nexport function withSelectorIndexPass<T>(doc: Document, run: () => T): T {\n const previous = activePass;\n activePass = { doc, bySelector: new Map() };\n try {\n return run();\n } finally {\n activePass = previous;\n }\n}\n\nfunction buildOccurrences(\n doc: Document,\n selector: string,\n resolveSourceFile: (candidate: Element) => string | undefined,\n): SelectorOccurrences {\n const occurrences: SelectorOccurrences = new Map();\n const counts = new Map<string, number>();\n for (const candidate of doc.querySelectorAll(selector)) {\n const scope = resolveSourceFile(candidate) ?? \"index.html\";\n const index = counts.get(scope) ?? 0;\n counts.set(scope, index + 1);\n occurrences.set(candidate, { scope, index });\n }\n return occurrences;\n}\n\nexport function getSourceScopedSelectorIndex(\n doc: Document,\n el: Element,\n selector: string | undefined,\n sourceFile: string | undefined,\n resolveSourceFile: (candidate: Element) => string | undefined,\n): number | undefined {\n if (!selector || selector.startsWith(\"#\") || selector.startsWith(\"[data-composition-id=\")) {\n return undefined;\n }\n\n try {\n const pass = activePass?.doc === doc ? activePass : null;\n let occurrences = pass?.bySelector.get(selector);\n if (!occurrences) {\n occurrences = buildOccurrences(doc, selector, resolveSourceFile);\n pass?.bySelector.set(selector, occurrences);\n }\n // An element outside the requested scope is not in that scope's occurrence\n // run at all, which is the `indexOf` miss the filtered form returned before.\n const hit = occurrences.get(el);\n return hit && hit.scope === (sourceFile ?? \"index.html\") ? hit.index : undefined;\n } catch {\n return undefined;\n }\n}\n","/**\n * Playback adapter utilities: factory for the static-seek adapter used when a\n * composition exposes only a `renderSeek` / `seek` API (no native play/pause\n * support), plus a thin wrapper that normalises GSAP-style `TimelineLike`\n * objects to the `PlaybackAdapter` interface.\n */\n\nimport type {\n PlaybackAdapter,\n RuntimePlaybackAdapter,\n StaticSeekPlaybackClock,\n TimelineLike,\n} from \"./playbackTypes\";\n\n// ---------------------------------------------------------------------------\n// Pure numeric helpers\n// ---------------------------------------------------------------------------\n\nexport function isFinitePositive(value: number): boolean {\n return Number.isFinite(value) && value > 0;\n}\n\nfunction clampTime(time: number, duration: number): number {\n const safeDuration = Math.max(0, Number.isFinite(duration) ? duration : 0);\n const safeTime = Math.max(0, Number.isFinite(time) ? time : 0);\n return safeDuration > 0 ? Math.min(safeTime, safeDuration) : safeTime;\n}\n\nexport function getAdapterDuration(adapter: PlaybackAdapter | null | undefined): number {\n if (!adapter) return 0;\n try {\n const duration = Number(adapter.getDuration());\n return isFinitePositive(duration) ? duration : 0;\n } catch {\n return 0;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Clock factory\n// ---------------------------------------------------------------------------\n\nexport function getDefaultStaticSeekPlaybackClock(win: Window): StaticSeekPlaybackClock {\n return {\n now: () => win.performance.now(),\n requestAnimationFrame: (callback) => win.requestAnimationFrame(callback),\n cancelAnimationFrame: (handle) => win.cancelAnimationFrame(handle),\n };\n}\n\n// ---------------------------------------------------------------------------\n// Static-seek adapter\n// ---------------------------------------------------------------------------\n\n/**\n * Wraps a render-only player (exposes `renderSeek`/`seek` but no native\n * play/pause) and drives playback via `requestAnimationFrame`.\n */\nexport function createStaticSeekPlaybackAdapter(\n player: Pick<RuntimePlaybackAdapter, \"getTime\"> &\n Partial<Pick<RuntimePlaybackAdapter, \"renderSeek\" | \"seek\">>,\n duration: number,\n clock: StaticSeekPlaybackClock,\n getPlaybackRate: () => number = () => 1,\n): PlaybackAdapter {\n const safeDuration = Math.max(0, Number.isFinite(duration) ? duration : 0);\n let currentTime = clampTime(Number(player.getTime?.() ?? 0), safeDuration);\n let playing = false;\n let rafId = 0;\n let playStartTime = currentTime;\n let playStartNow = clock.now();\n\n const renderSeek = (time: number) => {\n currentTime = clampTime(time, safeDuration);\n if (typeof player.renderSeek === \"function\") {\n player.renderSeek(currentTime);\n return;\n }\n player.seek?.(currentTime);\n };\n\n const stopTicker = () => {\n if (rafId) {\n clock.cancelAnimationFrame(rafId);\n rafId = 0;\n }\n };\n\n const tick: FrameRequestCallback = (now) => {\n if (!playing) return;\n const playbackRate = Math.max(0.1, Number(getPlaybackRate()) || 1);\n const elapsed = ((now - playStartNow) / 1000) * playbackRate;\n renderSeek(playStartTime + elapsed);\n if (currentTime >= safeDuration) {\n playing = false;\n rafId = 0;\n return;\n }\n rafId = clock.requestAnimationFrame(tick);\n };\n\n return {\n play: () => {\n if (playing || safeDuration <= 0) return;\n if (currentTime >= safeDuration) renderSeek(0);\n playing = true;\n playStartTime = currentTime;\n playStartNow = clock.now();\n stopTicker();\n rafId = clock.requestAnimationFrame(tick);\n },\n pause: () => {\n playing = false;\n stopTicker();\n },\n seek: (time, options) => {\n renderSeek(time);\n if (options?.keepPlaying) {\n if (playing) {\n playStartTime = currentTime;\n playStartNow = clock.now();\n }\n return;\n }\n // Default seek aligns with wrapTimeline: stop the RAF ticker so the\n // adapter's `playing` flag matches the public seek contract instead of\n // silently driving renderSeek in the background.\n playing = false;\n stopTicker();\n },\n getTime: () => currentTime,\n getDuration: () => safeDuration,\n isPlaying: () => playing,\n };\n}\n\n// ---------------------------------------------------------------------------\n// Static-seek fallback cache\n// ---------------------------------------------------------------------------\n\nexport type StaticSeekCacheEntry = {\n player: RuntimePlaybackAdapter | PlaybackAdapter;\n duration: number;\n adapter: PlaybackAdapter;\n};\n\ntype StaticSeekCacheRef = { current: StaticSeekCacheEntry | null };\ntype WarnedRef = { current: boolean };\n\n/**\n * Pause and drop the cached static-seek adapter. Must be called whenever\n * adapter selection switches to a native adapter — a cached static-seek\n * adapter that was mid-play keeps its private rAF loop seeking the player\n * forever otherwise, fighting the native transport. Also re-arms the\n * downgrade warning so a later re-downgrade is surfaced again.\n */\nexport function releaseStaticSeekCache(cache: StaticSeekCacheRef, warned: WarnedRef): void {\n cache.current?.adapter.pause();\n cache.current = null;\n warned.current = false;\n}\n\n/**\n * Resolve (with caching) the seek-driven fallback adapter. Warns once per\n * downgrade streak: seek-driven playback never starts media elements or\n * WebAudio, so without the warning the downgrade silently loses audio.\n */\nexport function resolveStaticSeekFallback(opts: {\n cache: StaticSeekCacheRef;\n warned: WarnedRef;\n bestAdapter: RuntimePlaybackAdapter | PlaybackAdapter;\n effectiveDuration: number;\n docDuration: number;\n clock: StaticSeekPlaybackClock;\n getPlaybackRate: () => number;\n}): PlaybackAdapter {\n const { cache, warned, bestAdapter, effectiveDuration, docDuration } = opts;\n const cached = cache.current;\n if (cached?.player === bestAdapter && cached.duration === effectiveDuration) {\n return cached.adapter;\n }\n cached?.adapter.pause();\n if (!warned.current) {\n warned.current = true;\n console.warn(\n `[useTimelinePlayer] Selected adapter duration (${getAdapterDuration(bestAdapter)}s) does not cover the document duration (${docDuration}s); falling back to seek-driven playback, which never starts media elements or WebAudio. Audio will not play in preview — extend the GSAP timeline to cover the declared data-duration.`,\n );\n }\n const adapter = createStaticSeekPlaybackAdapter(\n bestAdapter,\n effectiveDuration,\n opts.clock,\n opts.getPlaybackRate,\n );\n cache.current = { player: bestAdapter, duration: effectiveDuration, adapter };\n return adapter;\n}\n\n// ---------------------------------------------------------------------------\n// GSAP timeline wrapper\n// ---------------------------------------------------------------------------\n\nexport function wrapTimeline(tl: TimelineLike): PlaybackAdapter {\n return {\n play: () => tl.play(),\n pause: () => tl.pause(),\n seek: (t, options) => {\n const shouldPause = !options?.keepPlaying;\n if (shouldPause) tl.pause();\n tl.seek(t);\n if (shouldPause) tl.pause();\n },\n getTime: () => tl.time(),\n getDuration: () => tl.duration(),\n isPlaying: () => tl.isActive(),\n };\n}\n","/**\n * Low-level helpers for building and identifying TimelineElement objects.\n *\n * Covers: duration reading, media-element metadata extraction, selector/key/\n * identity builders, and DOM node lookup. These are\n * intentionally dependency-free (no store, no hooks) so they can be used in\n * both the React hook and test environments.\n */\n\nimport type { TimelineElement } from \"../store/playerStore\";\nimport type { ClipManifestClip } from \"./playbackTypes\";\nimport { isFinitePositive } from \"./playbackAdapter\";\nimport { getSourceScopedSelectorIndex } from \"../../utils/sourceScopedSelectorIndex\";\nimport { HF_AUDIO_GROUP_TAG } from \"@hyperframes/core/audio-groups\";\nimport { readElementFades } from \"@hyperframes/core/audio-fade\";\nimport {\n type AttrReader,\n clampPlaybackRate,\n readMediaOffsetSeconds,\n} from \"@hyperframes/parsers/media-duration\";\n\n// ---------------------------------------------------------------------------\n// Layer-reveal lift transparency\n// ---------------------------------------------------------------------------\n\n/**\n * Attributes carrying the pre-lift state of a Layers-panel selection reveal\n * (useLayerRevealOverride): while a layer is selected it PAINTS on top via a\n * temporary inline z-index, but the lift is a purely visual, ephemeral studio\n * affordance — every z reader must keep reporting the element's TRUE z\n * (stored here) so menus, badges, the lane mirror, and the panel sort never\n * reason on the lifted value. A z-reorder commit removes the attributes (the\n * commit is the new truth).\n */\nexport const LAYER_REVEAL_PRIOR_Z_ATTR = \"data-hf-reveal-prior-z\";\nexport const LAYER_REVEAL_PRIOR_POSITION_ATTR = \"data-hf-reveal-prior-pos\";\n\n/** The lifted element's true (pre-lift) z, or null when no lift is active. */\nexport function readLayerRevealPriorZ(el: Element): number | null {\n const raw = el.getAttribute(LAYER_REVEAL_PRIOR_Z_ATTR);\n if (raw == null) return null;\n const n = Number.parseInt(raw, 10);\n return Number.isFinite(n) ? n : null;\n}\n\n// ---------------------------------------------------------------------------\n// Duration attribute helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Read a host element's effective CSS stacking order for the timeline's reverse\n * z→lane mapping. Prefers the inline `style.zIndex` (what the canvas context\n * menu and LayersPanel z-edits write via handleDomZIndexReorderCommit), falls\n * back to computed style; \"auto\" / empty / unparseable ⇒ 0. Works with a\n * detached parse Document (no defaultView) as well as a live iframe. Mirrors\n * canvasContextMenuZOrder.parseZIndex semantics so the two directions agree.\n * Reveal-lift transparent: an active lift reports the stored TRUE z.\n */\nexport function readTimelineElementZIndex(el: Element): number {\n const prior = readLayerRevealPriorZ(el);\n if (prior != null) return prior;\n const html = el as HTMLElement;\n const parseZ = (value: string | null | undefined): number | null => {\n if (value == null || value === \"\" || value === \"auto\") return null;\n const n = Number.parseInt(value, 10);\n return Number.isFinite(n) ? n : null;\n };\n const fromInline = parseZ(html.style?.zIndex);\n if (fromInline != null) return fromInline;\n const view = el.ownerDocument?.defaultView;\n if (view?.getComputedStyle) {\n const fromComputed = parseZ(view.getComputedStyle(html).zIndex);\n if (fromComputed != null) return fromComputed;\n }\n return 0;\n}\n\nfunction readDurationAttribute(el: Element | null | undefined): number {\n if (!el) return 0;\n const duration =\n Number.parseFloat(el.getAttribute(\"data-duration\") ?? \"\") ||\n Number.parseFloat(el.getAttribute(\"data-hf-authored-duration\") ?? \"\");\n return isFinitePositive(duration) ? duration : 0;\n}\n\nexport function isTimelineIgnoredElement(el: Element): boolean {\n // An `<hf-audio-group>` is a mixer bus with no timing of its own, drawn as a group row, never a clip.\n if (el.tagName.toLowerCase() === HF_AUDIO_GROUP_TAG) return true;\n return Boolean(\n el.closest(\n [\n \"[data-hyperframes-ignore]\",\n \"[data-hyperframes-picker-ignore]\",\n \"[data-hf-ignore]\",\n \"[data-hf-color-grading-canvas]\",\n ].join(\",\"),\n ),\n );\n}\n\n/**\n * Furthest clip end (start + RAW `data-duration`) over every non-root clip in the\n * document. Reads the authored attribute, NOT any runtime-computed value — so it\n * is immune to the runtime's clamp that truncates a clip's live duration to the\n * composition length. This is the source of truth for content-driven duration:\n * computing it from the store instead would feed the truncated value back in and\n * make the composition length ratchet down (research HANDOFF-3 §6.1 feedback loop).\n */\nexport function furthestClipEndFromDocument(doc: Document | null | undefined): number {\n if (!doc) return 0;\n const root = doc.querySelector(\"[data-composition-id]\");\n let maxEnd = 0;\n for (const node of Array.from(doc.querySelectorAll(\"[data-start]\"))) {\n if (node === root || isTimelineIgnoredElement(node)) continue;\n const start = Number.parseFloat(node.getAttribute(\"data-start\") ?? \"\");\n const duration = readDurationAttribute(node);\n if (!Number.isFinite(start) || start < 0 || duration <= 0) continue;\n maxEnd = Math.max(maxEnd, start + duration);\n }\n return maxEnd;\n}\n\nexport function readTimelineDurationFromDocument(doc: Document | null | undefined): number {\n if (!doc) return 0;\n const rootDuration = readDurationAttribute(doc.querySelector(\"[data-composition-id]\"));\n if (rootDuration > 0) return rootDuration;\n return furthestClipEndFromDocument(doc);\n}\n\n/**\n * Furthest clip end parsed straight from a composition SOURCE STRING (the HTML\n * being saved). Uses raw `data-duration`, so it is the correct input for syncing\n * the root duration after an edit — reading the store instead would use the\n * runtime-truncated durations and shrink the composition (the feedback loop).\n */\nexport function furthestClipEndFromSource(source: string): number {\n if (!source) return 0;\n return furthestClipEndFromDocument(new DOMParser().parseFromString(source, \"text/html\"));\n}\n\n// ---------------------------------------------------------------------------\n// DOM element type guards\n// ---------------------------------------------------------------------------\n\nfunction isHtmlElement(el: Element): el is HTMLElement {\n const HtmlElementCtor = el.ownerDocument.defaultView?.HTMLElement ?? globalThis.HTMLElement;\n return typeof HtmlElementCtor !== \"undefined\" && el instanceof HtmlElementCtor;\n}\n\nfunction isCompositionHost(el: Element): boolean {\n return (\n el.hasAttribute(\"data-composition-id\") ||\n el.hasAttribute(\"data-composition-src\") ||\n el.hasAttribute(\"data-composition-file\")\n );\n}\n\nexport function resolveMediaElement(el: Element): HTMLMediaElement | HTMLImageElement | null {\n const win = el.ownerDocument.defaultView ?? window;\n const MediaElementCtor = win.HTMLMediaElement ?? globalThis.HTMLMediaElement;\n const ImageElementCtor = win.HTMLImageElement ?? globalThis.HTMLImageElement;\n if (el instanceof MediaElementCtor || el instanceof ImageElementCtor) return el;\n // A composition's media belongs to its own timeline, not the clip's: its length would cap a trim.\n if (isCompositionHost(el)) return null;\n const candidate = el.querySelector(\"video, audio, img\");\n return candidate instanceof MediaElementCtor || candidate instanceof ImageElementCtor\n ? candidate\n : null;\n}\n\n/** The in-point as playback reads it, and the attribute holding it; empty when neither is authored. */\nexport function readPlaybackStartAttributes(\n getAttr: AttrReader,\n): Pick<TimelineElement, \"playbackStart\" | \"playbackStartAttr\"> {\n const playbackStartAttr =\n getAttr(\"data-playback-start\") != null\n ? \"playback-start\"\n : getAttr(\"data-media-start\") != null\n ? \"media-start\"\n : undefined;\n return playbackStartAttr\n ? { playbackStart: readMediaOffsetSeconds(getAttr), playbackStartAttr }\n : {};\n}\n\nexport function playbackStartAttributeForElement(\n element: Pick<TimelineElement, \"kind\" | \"playbackStartAttr\">,\n): \"data-media-start\" | \"data-playback-start\" {\n return element.playbackStartAttr === \"playback-start\" || element.kind === \"composition\"\n ? \"data-playback-start\"\n : \"data-media-start\";\n}\n\nfunction applyPlaybackMetadataFromElement(entry: TimelineElement, el: Element): void {\n Object.assign(\n entry,\n readPlaybackStartAttributes((n) => el.getAttribute(n)),\n );\n\n const authoredPlaybackRate = Number.parseFloat(el.getAttribute(\"data-playback-rate\") ?? \"\");\n if (Number.isFinite(authoredPlaybackRate) && authoredPlaybackRate > 0) {\n entry.playbackRate = clampPlaybackRate(authoredPlaybackRate);\n }\n}\n\n/** Sets or clears an optional field, so a re-parse after the attribute is removed drops it. */\nfunction setOptional<K extends keyof TimelineElement>(\n entry: TimelineElement,\n key: K,\n value: TimelineElement[K] | undefined,\n): void {\n if (value === undefined) delete entry[key];\n else entry[key] = value;\n}\n\nfunction readVolume(el: Element, media: Element): number | undefined {\n const volume = Number.parseFloat(\n el.getAttribute(\"data-volume\") ?? media.getAttribute(\"data-volume\") ?? \"\",\n );\n return Number.isFinite(volume) ? volume : undefined;\n}\n\n/** The compiler's rule (timingCompiler): explicit data-has-audio wins; otherwise an unmuted <video> is audible. */\nexport function isVideoAudible(opts: {\n tag: string;\n hasAudioAttr: string | null | undefined;\n muted: boolean;\n}): boolean {\n if (opts.hasAudioAttr === \"true\") return true;\n if (opts.hasAudioAttr === \"false\" || opts.hasAudioAttr === \"\") return false;\n return opts.tag.toLowerCase() === \"video\" && !opts.muted;\n}\n\nexport function isAudibleVideoNode(el: Element): boolean {\n if (el.tagName.toLowerCase() !== \"video\" || el.hasAttribute(\"muted\")) return false;\n return isVideoAudible({\n tag: \"video\",\n hasAudioAttr: el.getAttribute(\"data-has-audio\"),\n muted: false,\n });\n}\n\n/** What the mixer gets: the compiler's `data-has-audio` rule, muted and volume. */\nfunction applyAudioMetadataFromElement(entry: TimelineElement, el: Element): void {\n const media = resolveMediaElement(el) ?? el;\n const muted = el.hasAttribute(\"muted\") || media.hasAttribute(\"muted\");\n const sound = isVideoAudible({\n tag: el.tagName,\n hasAudioAttr: el.getAttribute(\"data-has-audio\"),\n muted,\n });\n setOptional(entry, \"hasAudio\", sound ? true : undefined);\n setOptional(entry, \"muted\", muted ? true : undefined);\n setOptional(entry, \"volume\", readVolume(el, media));\n}\n\nfunction applyFadeMetadataFromElement(entry: TimelineElement, el: Element): void {\n const fades = readElementFades(el);\n setOptional(entry, \"fadeIn\", fades.fadeIn > 0 ? fades.fadeIn : undefined);\n setOptional(entry, \"fadeOut\", fades.fadeOut > 0 ? fades.fadeOut : undefined);\n}\n\nexport function applyMediaMetadataFromElement(entry: TimelineElement, el: Element): void {\n applyPlaybackMetadataFromElement(entry, el);\n applyAudioMetadataFromElement(entry, el);\n applyFadeMetadataFromElement(entry, el);\n\n const mediaEl = resolveMediaElement(el);\n if (!mediaEl) return;\n\n entry.tag = mediaEl.tagName.toLowerCase();\n const src = mediaEl.getAttribute(\"src\");\n if (src) entry.src = src;\n\n const win = mediaEl.ownerDocument.defaultView ?? window;\n const MediaElementCtor = win.HTMLMediaElement ?? globalThis.HTMLMediaElement;\n if (typeof MediaElementCtor === \"undefined\" || !(mediaEl instanceof MediaElementCtor)) return;\n\n const sourceDurationAttr =\n el.getAttribute(\"data-source-duration\") ?? mediaEl.getAttribute(\"data-source-duration\");\n const sourceDuration = sourceDurationAttr ? parseFloat(sourceDurationAttr) : mediaEl.duration;\n if (Number.isFinite(sourceDuration) && sourceDuration > 0) {\n entry.sourceDuration = sourceDuration;\n }\n\n const playbackRate = mediaEl.defaultPlaybackRate;\n if (entry.playbackRate == null && Number.isFinite(playbackRate) && playbackRate > 0) {\n entry.playbackRate = clampPlaybackRate(playbackRate);\n }\n}\n\n// ---------------------------------------------------------------------------\n// Label helpers\n// ---------------------------------------------------------------------------\n\nexport function getTimelineElementDisplayLabel(input: {\n id?: string | null;\n label?: string | null;\n tag?: string | null;\n}): string {\n const label = input.label?.trim();\n if (label) return label;\n const id = input.id?.trim();\n if (id) return id;\n const tag = input.tag?.trim().toLowerCase();\n return tag ? `${tag} clip` : \"Timeline clip\";\n}\n\n// ---------------------------------------------------------------------------\n// Selector / identity / key builders\n// ---------------------------------------------------------------------------\n\nexport function getTimelineElementSelector(el: Element): string | undefined {\n if (isHtmlElement(el) && el.id) return `#${CSS.escape(el.id)}`;\n const compId = el.getAttribute(\"data-composition-id\");\n if (compId) return `[data-composition-id=\"${CSS.escape(compId)}\"]`;\n if (isHtmlElement(el)) {\n const classes = el.className.split(/\\s+/).filter(Boolean);\n const firstClass = classes.find((className) => className !== \"clip\") ?? classes[0];\n if (firstClass) return `.${CSS.escape(firstClass)}`;\n }\n return undefined;\n}\n\nexport function getTimelineElementSourceFile(el: Element): string | undefined {\n const ownerRoot = el.parentElement?.closest(\"[data-composition-id]\");\n return (\n ownerRoot?.getAttribute(\"data-composition-file\") ??\n ownerRoot?.getAttribute(\"data-composition-src\") ??\n undefined\n );\n}\n\nexport function getTimelineElementSelectorIndex(\n doc: Document,\n el: Element,\n selector: string | undefined,\n): number | undefined {\n return getSourceScopedSelectorIndex(\n doc,\n el,\n selector,\n getTimelineElementSourceFile(el),\n getTimelineElementSourceFile,\n );\n}\n\nexport function buildTimelineElementKey(params: {\n id: string;\n fallbackIndex: number;\n domId?: string;\n selector?: string;\n selectorIndex?: number;\n sourceFile?: string;\n}): string {\n const scope = params.sourceFile ?? \"index.html\";\n if (params.domId) return `${scope}#${params.domId}`;\n if (params.selector) return `${scope}:${params.selector}:${params.selectorIndex ?? 0}`;\n return `${scope}:${params.id}:${params.fallbackIndex}`;\n}\n\n/**\n * Inverse of {@link buildTimelineElementKey} for the `sourceFile#domId` form.\n * A key with no `#` is a bare dom id and carries no source file of its own, so\n * the caller supplies the scope it wants to look that id up in.\n */\nexport function splitTimelineElementKey(key: string): {\n sourceFile: string | null;\n domId: string;\n} {\n const hashIndex = key.lastIndexOf(\"#\");\n if (hashIndex < 0) return { sourceFile: null, domId: key };\n return { sourceFile: key.slice(0, hashIndex), domId: key.slice(hashIndex + 1) };\n}\n\nexport function buildTimelineElementIdentity(params: {\n preferredId?: string | null;\n label: string;\n fallbackIndex: number;\n domId?: string;\n selector?: string;\n selectorIndex?: number;\n sourceFile?: string;\n}): { id: string; key: string } {\n const id =\n params.preferredId?.trim() ||\n buildTimelineElementKey({\n id: params.label,\n fallbackIndex: params.fallbackIndex,\n domId: params.domId,\n selector: params.selector,\n selectorIndex: params.selectorIndex,\n sourceFile: params.sourceFile,\n });\n const key = buildTimelineElementKey({\n id,\n fallbackIndex: params.fallbackIndex,\n domId: params.domId,\n selector: params.selector,\n selectorIndex: params.selectorIndex,\n sourceFile: params.sourceFile,\n });\n return { id, key };\n}\n\nexport function getTimelineElementIdentity(element: { key?: string | null; id: string }): string {\n return element.key ?? element.id;\n}\n\n/**\n * The id space the RUNTIME matches on — a bare DOM id, never a store key.\n *\n * Studio addresses rows by `buildTimelineElementKey`'s composite\n * `<sourceFile>#<domId>`, but everything audio in `@hyperframes/core` keys off\n * the live document: `resolveAudioGroups` collects `member.id`,\n * `resolveCarveSourceIds` goes through `getElementById`. Anything crossing into\n * that space — a group membership list, a carve source — has to be\n * converted here first; a composite key silently matches nothing.\n *\n * `null` for a row with no DOM id at all (selector-addressed elements): such an\n * element cannot be grouped, because `resolveAudioGroups` skips\n * members without an `id` and would build a group that is half there.\n */\nexport function runtimeAudioId(element: { domId?: string | null }): string | null {\n return element.domId || null;\n}\n\n/**\n * Timeline store key for a z-reorder entry built OUTSIDE the timeline\n * expansion (canvas context menu / LayersPanel), so the reorder commit can\n * update the store's zIndex synchronously. Matches buildTimelineElementKey's\n * stable branches (`sourceFile#domId`, else the selector-based key). Undefined\n * when the element has neither a DOM id nor a selector — the timeline's\n * fallback branch needs its own fallbackIndex, which these callers don't have,\n * so such an entry simply skips the synchronous store update.\n */\nexport function deriveTimelineStoreKey(params: {\n domId?: string;\n selector?: string;\n selectorIndex?: number;\n sourceFile?: string;\n}): string | undefined {\n if (!params.domId && !params.selector) return undefined;\n return buildTimelineElementKey({ id: \"\", fallbackIndex: 0, ...params });\n}\n\n/**\n * {@link deriveTimelineStoreKey} for a caller that already has a DOM id in\n * hand (e.g. one it just minted), so the undefined branch never applies.\n */\nexport function deriveTimelineStoreKeyForDomId(domId: string, sourceFile?: string): string {\n return deriveTimelineStoreKey({ domId, sourceFile })!;\n}\n\n// ---------------------------------------------------------------------------\n// DOM node querying\n// ---------------------------------------------------------------------------\n\nfunction getTimelineDomNodes(doc: Document): Element[] {\n const rootComp = doc.querySelector(\"[data-composition-id]\");\n return Array.from(doc.querySelectorAll(\"[data-start]\")).filter(\n (node) => node !== rootComp && !isTimelineIgnoredElement(node),\n );\n}\n\nfunction numbersNearlyEqual(a: number, b: number): boolean {\n return Math.abs(a - b) < 0.001;\n}\n\nconst MANIFEST_CLIP_ATTRS: ReadonlyArray<[string, (clip: ClipManifestClip) => number]> = [\n [\"data-start\", (clip) => clip.start],\n [\"data-duration\", (clip) => clip.duration],\n [\"data-track-index\", (clip) => clip.track],\n];\n\nfunction nodeMatchesClipTag(node: Element, clip: ClipManifestClip): boolean {\n return !clip.tagName || node.tagName.toLowerCase() === clip.tagName.toLowerCase();\n}\n\nfunction nodeMatchesManifestClip(node: Element, clip: ClipManifestClip): boolean {\n if (!nodeMatchesClipTag(node, clip)) return false;\n // An attribute only constrains the match when it parses to a finite number:\n // missing or garbled reads as \"unknown\", not \"mismatch\".\n return MANIFEST_CLIP_ATTRS.every(([attr, expected]) => {\n const actual = Number.parseFloat(node.getAttribute(attr) ?? \"\");\n return !Number.isFinite(actual) || numbersNearlyEqual(actual, expected(clip));\n });\n}\n\n/** Whether `node` sits in the composition the clip was read from, the chain the runtime records outermost first\n * (`resolveNearestCompositionContext` in core's runtime/timeline.ts). A clip without that scope accepts any node. */\nfunction nodeInClipScope(node: Element, clip: ClipManifestClip): boolean {\n const scope = clip.compositionAncestors;\n if (!scope) return true;\n const ids: string[] = [];\n for (let cursor = node.parentElement; cursor; cursor = cursor.parentElement) {\n const id = cursor.getAttribute(\"data-composition-id\");\n if (id) ids.unshift(id);\n }\n return ids.length === scope.length && ids.every((id, index) => id === scope[index]);\n}\n\n/** The first match in the clip's composition across `selectors`; a lone match stands only when none is in scope, as a\n * healed host can stale the clip's chain for a pass. An id can repeat in a sub-composition earlier in the document. */\nfunction findInClipScope(\n doc: Document,\n clip: ClipManifestClip,\n selectors: string[],\n): Element | null {\n let lone: Element | null = null;\n for (const selector of selectors) {\n const nodes = Array.from(doc.querySelectorAll(selector));\n const scoped = nodes.find((node) => nodeInClipScope(node, clip));\n if (scoped) return scoped;\n if (nodes.length === 1) lone ??= nodes[0];\n }\n return lone;\n}\n\nexport type PreviewTarget = Pick<TimelineElement, \"hfId\" | \"domId\" | \"id\" | \"sourceFile\">;\n\n/** Finds a row's preview element by `data-hf-id`, then id, preferring one in the row's own file: both repeat across\n * files. Indexes the document once, so a pass over every row costs one scan. */\nexport function previewElementFinder(\n doc: Document,\n selector = \"[data-hf-id], [id]\",\n): (target: PreviewTarget) => Element | null {\n const byKey = new Map<string, Element[]>();\n const add = (key: string, node: Element) => {\n const nodes = byKey.get(key);\n if (nodes) nodes.push(node);\n else byKey.set(key, [node]);\n };\n for (const node of doc.querySelectorAll(selector)) {\n const hfId = node.getAttribute(\"data-hf-id\");\n const id = node.getAttribute(\"id\");\n if (hfId) add(`hf:${hfId}`, node);\n if (id) add(`id:${id}`, node);\n }\n return (target) => {\n const matches = [\n ...((target.hfId && byKey.get(`hf:${target.hfId}`)) || []),\n ...(byKey.get(`id:${target.domId ?? target.id}`) ?? []),\n ];\n return (\n matches.find((node) => getTimelineElementSourceFile(node) === target.sourceFile) ??\n matches[0] ??\n null\n );\n };\n}\n\nexport function findClipElementById(doc: Document, clip: ClipManifestClip): Element | null {\n if (!clip.id) return null;\n const first = doc.getElementById(clip.id);\n if (!first || nodeInClipScope(first, clip)) return first;\n return findInClipScope(doc, clip, [`[id=\"${CSS.escape(clip.id)}\"]`]);\n}\n\nfunction findTimelineDomNode(doc: Document, clip: ClipManifestClip): Element | null {\n if (!clip.id) return null;\n const first = doc.getElementById(clip.id);\n if (first && nodeInClipScope(first, clip)) return first;\n const id = CSS.escape(clip.id);\n const byOtherKeys = [`[data-hf-id=\"${id}\"]`, `[data-composition-id=\"${id}\"]`, `.${id}`];\n return findInClipScope(doc, clip, first ? [`[id=\"${id}\"]`, ...byOtherKeys] : byOtherKeys);\n}\n\nexport function findTimelineDomNodeForClip(\n doc: Document,\n clip: ClipManifestClip,\n fallbackIndex: number,\n usedNodes = new Set<Element>(),\n getCandidates = () => getTimelineDomNodes(doc),\n): Element | null {\n const byIdentity = findTimelineDomNode(doc, clip);\n if (byIdentity && !usedNodes.has(byIdentity) && nodeMatchesClipTag(byIdentity, clip))\n return byIdentity;\n\n const candidates = getCandidates().filter((node) => !usedNodes.has(node));\n const exact = candidates.find((node) => nodeMatchesManifestClip(node, clip));\n if (exact) return exact;\n\n const positional = candidates[fallbackIndex];\n return positional && nodeMatchesClipTag(positional, clip) ? positional : null;\n}\n\n/** One synchronous hydration pass: snapshot only on a miss, never across reloads. */\nexport function createTimelineDomNodeResolver(doc: Document) {\n let candidates: Element[] | undefined;\n const usedNodes = new Set<Element>();\n const getCandidates = () => (candidates ??= getTimelineDomNodes(doc));\n return (clip: ClipManifestClip, index: number): Element | null => {\n const node = findTimelineDomNodeForClip(doc, clip, index, usedNodes, getCandidates);\n if (node) usedNodes.add(node);\n return node;\n };\n}\n","const PROJECT_HASH_PREFIX = \"#project/\";\n\nexport interface ProjectHashRoute {\n projectId: string;\n params: URLSearchParams;\n}\n\nconst WINDOWS_DRIVE_PREFIX = /^[a-z]:/i;\n\n/** Project names are single path segments, including when received from a hash or server. */\nexport function isValidProjectId(value: string): boolean {\n return (\n value.length > 0 &&\n value !== \".\" &&\n value !== \"..\" &&\n !WINDOWS_DRIVE_PREFIX.test(value) &&\n !value.includes(\"/\") &&\n !value.includes(\"\\\\\") &&\n !Array.from(value).some((char) => char.charCodeAt(0) < 32)\n );\n}\n\nfunction decodeHashProjectId(value: string): string {\n try {\n return decodeURIComponent(value);\n } catch {\n return value;\n }\n}\n\nfunction normalizeHashParams(\n params?: URLSearchParams | Record<string, string | null | undefined>,\n): URLSearchParams {\n if (!params) return new URLSearchParams();\n if (params instanceof URLSearchParams) return params;\n\n const next = new URLSearchParams();\n for (const [key, value] of Object.entries(params)) {\n if (!key || value == null || value === \"\") continue;\n next.set(key, value);\n }\n return next;\n}\n\nexport function encodeProjectId(projectId: string): string {\n if (!isValidProjectId(projectId)) throw new Error(\"Invalid project ID\");\n return encodeURIComponent(projectId);\n}\n\nexport function buildProjectHash(\n projectId: string,\n params?: URLSearchParams | Record<string, string | null | undefined>,\n): string {\n const search = normalizeHashParams(params).toString();\n return `${PROJECT_HASH_PREFIX}${encodeProjectId(projectId)}${search ? `?${search}` : \"\"}`;\n}\n\nexport function parseProjectHashRoute(hash: string): ProjectHashRoute | null {\n if (!hash.startsWith(PROJECT_HASH_PREFIX)) return null;\n\n const route = hash.slice(PROJECT_HASH_PREFIX.length);\n const queryIndex = route.indexOf(\"?\");\n const encodedProjectId = queryIndex >= 0 ? route.slice(0, queryIndex) : route;\n if (!encodedProjectId || encodedProjectId.includes(\"/\")) return null;\n\n const projectId = decodeHashProjectId(encodedProjectId);\n if (!isValidProjectId(projectId)) return null;\n\n const rawParams = queryIndex >= 0 ? route.slice(queryIndex + 1) : \"\";\n return {\n projectId,\n params: new URLSearchParams(rawParams),\n };\n}\n\nexport function parseProjectIdFromHash(hash: string): string | null {\n return parseProjectHashRoute(hash)?.projectId ?? null;\n}\n\nexport function buildProjectApiPath(projectId: string, suffix = \"\"): string {\n const normalizedSuffix = suffix && !suffix.startsWith(\"/\") ? `/${suffix}` : suffix;\n return `/api/projects/${encodeProjectId(projectId)}${normalizedSuffix}`;\n}\n"],"mappings":"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","names":[]}
@@ -3,8 +3,8 @@ import {
3
3
  } from "./chunk-NCUBAVGK.js";
4
4
  import {
5
5
  buildProjectApiPath,
6
- getSourceScopedSelectorIndex
7
- } from "./chunk-DI4LCJHL.js";
6
+ splitTimelineElementKey
7
+ } from "./chunk-6LUNLTHR.js";
8
8
 
9
9
  // src/player/lib/time.ts
10
10
  var STUDIO_PREVIEW_FPS = 30;
@@ -72,466 +72,6 @@ function attachPlayerStoreDevHandle(store) {
72
72
  window.__playerStore = store;
73
73
  }
74
74
 
75
- // src/player/lib/playbackAdapter.ts
76
- function isFinitePositive(value) {
77
- return Number.isFinite(value) && value > 0;
78
- }
79
- function clampTime(time, duration) {
80
- const safeDuration = Math.max(0, Number.isFinite(duration) ? duration : 0);
81
- const safeTime = Math.max(0, Number.isFinite(time) ? time : 0);
82
- return safeDuration > 0 ? Math.min(safeTime, safeDuration) : safeTime;
83
- }
84
- function getAdapterDuration(adapter) {
85
- if (!adapter) return 0;
86
- try {
87
- const duration = Number(adapter.getDuration());
88
- return isFinitePositive(duration) ? duration : 0;
89
- } catch {
90
- return 0;
91
- }
92
- }
93
- function getDefaultStaticSeekPlaybackClock(win) {
94
- return {
95
- now: () => win.performance.now(),
96
- requestAnimationFrame: (callback) => win.requestAnimationFrame(callback),
97
- cancelAnimationFrame: (handle) => win.cancelAnimationFrame(handle)
98
- };
99
- }
100
- function createStaticSeekPlaybackAdapter(player, duration, clock, getPlaybackRate = () => 1) {
101
- const safeDuration = Math.max(0, Number.isFinite(duration) ? duration : 0);
102
- let currentTime = clampTime(Number(player.getTime?.() ?? 0), safeDuration);
103
- let playing = false;
104
- let rafId = 0;
105
- let playStartTime = currentTime;
106
- let playStartNow = clock.now();
107
- const renderSeek = (time) => {
108
- currentTime = clampTime(time, safeDuration);
109
- if (typeof player.renderSeek === "function") {
110
- player.renderSeek(currentTime);
111
- return;
112
- }
113
- player.seek?.(currentTime);
114
- };
115
- const stopTicker = () => {
116
- if (rafId) {
117
- clock.cancelAnimationFrame(rafId);
118
- rafId = 0;
119
- }
120
- };
121
- const tick = (now) => {
122
- if (!playing) return;
123
- const playbackRate = Math.max(0.1, Number(getPlaybackRate()) || 1);
124
- const elapsed = (now - playStartNow) / 1e3 * playbackRate;
125
- renderSeek(playStartTime + elapsed);
126
- if (currentTime >= safeDuration) {
127
- playing = false;
128
- rafId = 0;
129
- return;
130
- }
131
- rafId = clock.requestAnimationFrame(tick);
132
- };
133
- return {
134
- play: () => {
135
- if (playing || safeDuration <= 0) return;
136
- if (currentTime >= safeDuration) renderSeek(0);
137
- playing = true;
138
- playStartTime = currentTime;
139
- playStartNow = clock.now();
140
- stopTicker();
141
- rafId = clock.requestAnimationFrame(tick);
142
- },
143
- pause: () => {
144
- playing = false;
145
- stopTicker();
146
- },
147
- seek: (time, options) => {
148
- renderSeek(time);
149
- if (options?.keepPlaying) {
150
- if (playing) {
151
- playStartTime = currentTime;
152
- playStartNow = clock.now();
153
- }
154
- return;
155
- }
156
- playing = false;
157
- stopTicker();
158
- },
159
- getTime: () => currentTime,
160
- getDuration: () => safeDuration,
161
- isPlaying: () => playing
162
- };
163
- }
164
- function releaseStaticSeekCache(cache, warned) {
165
- cache.current?.adapter.pause();
166
- cache.current = null;
167
- warned.current = false;
168
- }
169
- function resolveStaticSeekFallback(opts) {
170
- const { cache, warned, bestAdapter, effectiveDuration, docDuration } = opts;
171
- const cached = cache.current;
172
- if (cached?.player === bestAdapter && cached.duration === effectiveDuration) {
173
- return cached.adapter;
174
- }
175
- cached?.adapter.pause();
176
- if (!warned.current) {
177
- warned.current = true;
178
- console.warn(
179
- `[useTimelinePlayer] Selected adapter duration (${getAdapterDuration(bestAdapter)}s) does not cover the document duration (${docDuration}s); falling back to seek-driven playback, which never starts media elements or WebAudio. Audio will not play in preview \u2014 extend the GSAP timeline to cover the declared data-duration.`
180
- );
181
- }
182
- const adapter = createStaticSeekPlaybackAdapter(
183
- bestAdapter,
184
- effectiveDuration,
185
- opts.clock,
186
- opts.getPlaybackRate
187
- );
188
- cache.current = { player: bestAdapter, duration: effectiveDuration, adapter };
189
- return adapter;
190
- }
191
- function wrapTimeline(tl) {
192
- return {
193
- play: () => tl.play(),
194
- pause: () => tl.pause(),
195
- seek: (t, options) => {
196
- const shouldPause = !options?.keepPlaying;
197
- if (shouldPause) tl.pause();
198
- tl.seek(t);
199
- if (shouldPause) tl.pause();
200
- },
201
- getTime: () => tl.time(),
202
- getDuration: () => tl.duration(),
203
- isPlaying: () => tl.isActive()
204
- };
205
- }
206
-
207
- // src/player/lib/timelineElementHelpers.ts
208
- import { HF_AUDIO_GROUP_TAG } from "@hyperframes/core/audio-groups";
209
- import { readElementFades } from "@hyperframes/core/audio-fade";
210
- import {
211
- clampPlaybackRate,
212
- readMediaOffsetSeconds
213
- } from "@hyperframes/parsers/media-duration";
214
- var LAYER_REVEAL_PRIOR_Z_ATTR = "data-hf-reveal-prior-z";
215
- var LAYER_REVEAL_PRIOR_POSITION_ATTR = "data-hf-reveal-prior-pos";
216
- function readLayerRevealPriorZ(el) {
217
- const raw = el.getAttribute(LAYER_REVEAL_PRIOR_Z_ATTR);
218
- if (raw == null) return null;
219
- const n = Number.parseInt(raw, 10);
220
- return Number.isFinite(n) ? n : null;
221
- }
222
- function readTimelineElementZIndex(el) {
223
- const prior = readLayerRevealPriorZ(el);
224
- if (prior != null) return prior;
225
- const html = el;
226
- const parseZ = (value) => {
227
- if (value == null || value === "" || value === "auto") return null;
228
- const n = Number.parseInt(value, 10);
229
- return Number.isFinite(n) ? n : null;
230
- };
231
- const fromInline = parseZ(html.style?.zIndex);
232
- if (fromInline != null) return fromInline;
233
- const view = el.ownerDocument?.defaultView;
234
- if (view?.getComputedStyle) {
235
- const fromComputed = parseZ(view.getComputedStyle(html).zIndex);
236
- if (fromComputed != null) return fromComputed;
237
- }
238
- return 0;
239
- }
240
- function readDurationAttribute(el) {
241
- if (!el) return 0;
242
- const duration = Number.parseFloat(el.getAttribute("data-duration") ?? "") || Number.parseFloat(el.getAttribute("data-hf-authored-duration") ?? "");
243
- return isFinitePositive(duration) ? duration : 0;
244
- }
245
- function isTimelineIgnoredElement(el) {
246
- if (el.tagName.toLowerCase() === HF_AUDIO_GROUP_TAG) return true;
247
- return Boolean(
248
- el.closest(
249
- [
250
- "[data-hyperframes-ignore]",
251
- "[data-hyperframes-picker-ignore]",
252
- "[data-hf-ignore]",
253
- "[data-hf-color-grading-canvas]"
254
- ].join(",")
255
- )
256
- );
257
- }
258
- function furthestClipEndFromDocument(doc) {
259
- if (!doc) return 0;
260
- const root = doc.querySelector("[data-composition-id]");
261
- let maxEnd = 0;
262
- for (const node of Array.from(doc.querySelectorAll("[data-start]"))) {
263
- if (node === root || isTimelineIgnoredElement(node)) continue;
264
- const start = Number.parseFloat(node.getAttribute("data-start") ?? "");
265
- const duration = readDurationAttribute(node);
266
- if (!Number.isFinite(start) || start < 0 || duration <= 0) continue;
267
- maxEnd = Math.max(maxEnd, start + duration);
268
- }
269
- return maxEnd;
270
- }
271
- function readTimelineDurationFromDocument(doc) {
272
- if (!doc) return 0;
273
- const rootDuration = readDurationAttribute(doc.querySelector("[data-composition-id]"));
274
- if (rootDuration > 0) return rootDuration;
275
- return furthestClipEndFromDocument(doc);
276
- }
277
- function furthestClipEndFromSource(source) {
278
- if (!source) return 0;
279
- return furthestClipEndFromDocument(new DOMParser().parseFromString(source, "text/html"));
280
- }
281
- function isHtmlElement(el) {
282
- const HtmlElementCtor = el.ownerDocument.defaultView?.HTMLElement ?? globalThis.HTMLElement;
283
- return typeof HtmlElementCtor !== "undefined" && el instanceof HtmlElementCtor;
284
- }
285
- function isCompositionHost(el) {
286
- return el.hasAttribute("data-composition-id") || el.hasAttribute("data-composition-src") || el.hasAttribute("data-composition-file");
287
- }
288
- function resolveMediaElement(el) {
289
- const win = el.ownerDocument.defaultView ?? window;
290
- const MediaElementCtor = win.HTMLMediaElement ?? globalThis.HTMLMediaElement;
291
- const ImageElementCtor = win.HTMLImageElement ?? globalThis.HTMLImageElement;
292
- if (el instanceof MediaElementCtor || el instanceof ImageElementCtor) return el;
293
- if (isCompositionHost(el)) return null;
294
- const candidate = el.querySelector("video, audio, img");
295
- return candidate instanceof MediaElementCtor || candidate instanceof ImageElementCtor ? candidate : null;
296
- }
297
- function readPlaybackStartAttributes(getAttr) {
298
- const playbackStartAttr = getAttr("data-playback-start") != null ? "playback-start" : getAttr("data-media-start") != null ? "media-start" : void 0;
299
- return playbackStartAttr ? { playbackStart: readMediaOffsetSeconds(getAttr), playbackStartAttr } : {};
300
- }
301
- function playbackStartAttributeForElement(element) {
302
- return element.playbackStartAttr === "playback-start" || element.kind === "composition" ? "data-playback-start" : "data-media-start";
303
- }
304
- function applyPlaybackMetadataFromElement(entry, el) {
305
- Object.assign(
306
- entry,
307
- readPlaybackStartAttributes((n) => el.getAttribute(n))
308
- );
309
- const authoredPlaybackRate = Number.parseFloat(el.getAttribute("data-playback-rate") ?? "");
310
- if (Number.isFinite(authoredPlaybackRate) && authoredPlaybackRate > 0) {
311
- entry.playbackRate = clampPlaybackRate(authoredPlaybackRate);
312
- }
313
- }
314
- function setOptional(entry, key, value) {
315
- if (value === void 0) delete entry[key];
316
- else entry[key] = value;
317
- }
318
- function readVolume(el, media) {
319
- const volume = Number.parseFloat(
320
- el.getAttribute("data-volume") ?? media.getAttribute("data-volume") ?? ""
321
- );
322
- return Number.isFinite(volume) ? volume : void 0;
323
- }
324
- function applyAudioMetadataFromElement(entry, el) {
325
- const media = resolveMediaElement(el) ?? el;
326
- const muted = el.hasAttribute("muted") || media.hasAttribute("muted");
327
- const hasAudio = el.getAttribute("data-has-audio");
328
- const sound = hasAudio === null ? el.tagName === "VIDEO" && !muted : hasAudio === "true";
329
- setOptional(entry, "hasAudio", sound ? true : void 0);
330
- setOptional(entry, "muted", muted ? true : void 0);
331
- setOptional(entry, "volume", readVolume(el, media));
332
- }
333
- function applyFadeMetadataFromElement(entry, el) {
334
- const fades = readElementFades(el);
335
- setOptional(entry, "fadeIn", fades.fadeIn > 0 ? fades.fadeIn : void 0);
336
- setOptional(entry, "fadeOut", fades.fadeOut > 0 ? fades.fadeOut : void 0);
337
- }
338
- function applyMediaMetadataFromElement(entry, el) {
339
- applyPlaybackMetadataFromElement(entry, el);
340
- applyAudioMetadataFromElement(entry, el);
341
- applyFadeMetadataFromElement(entry, el);
342
- const mediaEl = resolveMediaElement(el);
343
- if (!mediaEl) return;
344
- entry.tag = mediaEl.tagName.toLowerCase();
345
- const src = mediaEl.getAttribute("src");
346
- if (src) entry.src = src;
347
- const win = mediaEl.ownerDocument.defaultView ?? window;
348
- const MediaElementCtor = win.HTMLMediaElement ?? globalThis.HTMLMediaElement;
349
- if (typeof MediaElementCtor === "undefined" || !(mediaEl instanceof MediaElementCtor)) return;
350
- const sourceDurationAttr = el.getAttribute("data-source-duration") ?? mediaEl.getAttribute("data-source-duration");
351
- const sourceDuration = sourceDurationAttr ? parseFloat(sourceDurationAttr) : mediaEl.duration;
352
- if (Number.isFinite(sourceDuration) && sourceDuration > 0) {
353
- entry.sourceDuration = sourceDuration;
354
- }
355
- const playbackRate = mediaEl.defaultPlaybackRate;
356
- if (entry.playbackRate == null && Number.isFinite(playbackRate) && playbackRate > 0) {
357
- entry.playbackRate = clampPlaybackRate(playbackRate);
358
- }
359
- }
360
- function getTimelineElementDisplayLabel(input) {
361
- const label = input.label?.trim();
362
- if (label) return label;
363
- const id = input.id?.trim();
364
- if (id) return id;
365
- const tag = input.tag?.trim().toLowerCase();
366
- return tag ? `${tag} clip` : "Timeline clip";
367
- }
368
- function getTimelineElementSelector(el) {
369
- if (isHtmlElement(el) && el.id) return `#${CSS.escape(el.id)}`;
370
- const compId = el.getAttribute("data-composition-id");
371
- if (compId) return `[data-composition-id="${CSS.escape(compId)}"]`;
372
- if (isHtmlElement(el)) {
373
- const classes = el.className.split(/\s+/).filter(Boolean);
374
- const firstClass = classes.find((className) => className !== "clip") ?? classes[0];
375
- if (firstClass) return `.${CSS.escape(firstClass)}`;
376
- }
377
- return void 0;
378
- }
379
- function getTimelineElementSourceFile(el) {
380
- const ownerRoot = el.parentElement?.closest("[data-composition-id]");
381
- return ownerRoot?.getAttribute("data-composition-file") ?? ownerRoot?.getAttribute("data-composition-src") ?? void 0;
382
- }
383
- function getTimelineElementSelectorIndex(doc, el, selector) {
384
- return getSourceScopedSelectorIndex(
385
- doc,
386
- el,
387
- selector,
388
- getTimelineElementSourceFile(el),
389
- getTimelineElementSourceFile
390
- );
391
- }
392
- function buildTimelineElementKey(params) {
393
- const scope = params.sourceFile ?? "index.html";
394
- if (params.domId) return `${scope}#${params.domId}`;
395
- if (params.selector) return `${scope}:${params.selector}:${params.selectorIndex ?? 0}`;
396
- return `${scope}:${params.id}:${params.fallbackIndex}`;
397
- }
398
- function splitTimelineElementKey(key) {
399
- const hashIndex = key.lastIndexOf("#");
400
- if (hashIndex < 0) return { sourceFile: null, domId: key };
401
- return { sourceFile: key.slice(0, hashIndex), domId: key.slice(hashIndex + 1) };
402
- }
403
- function buildTimelineElementIdentity(params) {
404
- const id = params.preferredId?.trim() || buildTimelineElementKey({
405
- id: params.label,
406
- fallbackIndex: params.fallbackIndex,
407
- domId: params.domId,
408
- selector: params.selector,
409
- selectorIndex: params.selectorIndex,
410
- sourceFile: params.sourceFile
411
- });
412
- const key = buildTimelineElementKey({
413
- id,
414
- fallbackIndex: params.fallbackIndex,
415
- domId: params.domId,
416
- selector: params.selector,
417
- selectorIndex: params.selectorIndex,
418
- sourceFile: params.sourceFile
419
- });
420
- return { id, key };
421
- }
422
- function getTimelineElementIdentity(element) {
423
- return element.key ?? element.id;
424
- }
425
- function runtimeAudioId(element) {
426
- return element.domId || null;
427
- }
428
- function deriveTimelineStoreKey(params) {
429
- if (!params.domId && !params.selector) return void 0;
430
- return buildTimelineElementKey({ id: "", fallbackIndex: 0, ...params });
431
- }
432
- function deriveTimelineStoreKeyForDomId(domId, sourceFile) {
433
- return deriveTimelineStoreKey({ domId, sourceFile });
434
- }
435
- function getTimelineDomNodes(doc) {
436
- const rootComp = doc.querySelector("[data-composition-id]");
437
- return Array.from(doc.querySelectorAll("[data-start]")).filter(
438
- (node) => node !== rootComp && !isTimelineIgnoredElement(node)
439
- );
440
- }
441
- function numbersNearlyEqual(a, b) {
442
- return Math.abs(a - b) < 1e-3;
443
- }
444
- var MANIFEST_CLIP_ATTRS = [
445
- ["data-start", (clip) => clip.start],
446
- ["data-duration", (clip) => clip.duration],
447
- ["data-track-index", (clip) => clip.track]
448
- ];
449
- function nodeMatchesClipTag(node, clip) {
450
- return !clip.tagName || node.tagName.toLowerCase() === clip.tagName.toLowerCase();
451
- }
452
- function nodeMatchesManifestClip(node, clip) {
453
- if (!nodeMatchesClipTag(node, clip)) return false;
454
- return MANIFEST_CLIP_ATTRS.every(([attr, expected]) => {
455
- const actual = Number.parseFloat(node.getAttribute(attr) ?? "");
456
- return !Number.isFinite(actual) || numbersNearlyEqual(actual, expected(clip));
457
- });
458
- }
459
- function nodeInClipScope(node, clip) {
460
- const scope = clip.compositionAncestors;
461
- if (!scope) return true;
462
- const ids = [];
463
- for (let cursor = node.parentElement; cursor; cursor = cursor.parentElement) {
464
- const id = cursor.getAttribute("data-composition-id");
465
- if (id) ids.unshift(id);
466
- }
467
- return ids.length === scope.length && ids.every((id, index) => id === scope[index]);
468
- }
469
- function findInClipScope(doc, clip, selectors) {
470
- let lone = null;
471
- for (const selector of selectors) {
472
- const nodes = Array.from(doc.querySelectorAll(selector));
473
- const scoped = nodes.find((node) => nodeInClipScope(node, clip));
474
- if (scoped) return scoped;
475
- if (nodes.length === 1) lone ??= nodes[0];
476
- }
477
- return lone;
478
- }
479
- function previewElementFinder(doc, selector = "[data-hf-id], [id]") {
480
- const byKey = /* @__PURE__ */ new Map();
481
- const add = (key, node) => {
482
- const nodes = byKey.get(key);
483
- if (nodes) nodes.push(node);
484
- else byKey.set(key, [node]);
485
- };
486
- for (const node of doc.querySelectorAll(selector)) {
487
- const hfId = node.getAttribute("data-hf-id");
488
- const id = node.getAttribute("id");
489
- if (hfId) add(`hf:${hfId}`, node);
490
- if (id) add(`id:${id}`, node);
491
- }
492
- return (target) => {
493
- const matches = [
494
- ...target.hfId && byKey.get(`hf:${target.hfId}`) || [],
495
- ...byKey.get(`id:${target.domId ?? target.id}`) ?? []
496
- ];
497
- return matches.find((node) => getTimelineElementSourceFile(node) === target.sourceFile) ?? matches[0] ?? null;
498
- };
499
- }
500
- function findClipElementById(doc, clip) {
501
- if (!clip.id) return null;
502
- const first = doc.getElementById(clip.id);
503
- if (!first || nodeInClipScope(first, clip)) return first;
504
- return findInClipScope(doc, clip, [`[id="${CSS.escape(clip.id)}"]`]);
505
- }
506
- function findTimelineDomNode(doc, clip) {
507
- if (!clip.id) return null;
508
- const first = doc.getElementById(clip.id);
509
- if (first && nodeInClipScope(first, clip)) return first;
510
- const id = CSS.escape(clip.id);
511
- const byOtherKeys = [`[data-hf-id="${id}"]`, `[data-composition-id="${id}"]`, `.${id}`];
512
- return findInClipScope(doc, clip, first ? [`[id="${id}"]`, ...byOtherKeys] : byOtherKeys);
513
- }
514
- function findTimelineDomNodeForClip(doc, clip, fallbackIndex, usedNodes = /* @__PURE__ */ new Set(), getCandidates = () => getTimelineDomNodes(doc)) {
515
- const byIdentity = findTimelineDomNode(doc, clip);
516
- if (byIdentity && !usedNodes.has(byIdentity) && nodeMatchesClipTag(byIdentity, clip))
517
- return byIdentity;
518
- const candidates = getCandidates().filter((node) => !usedNodes.has(node));
519
- const exact = candidates.find((node) => nodeMatchesManifestClip(node, clip));
520
- if (exact) return exact;
521
- const positional = candidates[fallbackIndex];
522
- return positional && nodeMatchesClipTag(positional, clip) ? positional : null;
523
- }
524
- function createTimelineDomNodeResolver(doc) {
525
- let candidates;
526
- const usedNodes = /* @__PURE__ */ new Set();
527
- const getCandidates = () => candidates ??= getTimelineDomNodes(doc);
528
- return (clip, index) => {
529
- const node = findTimelineDomNodeForClip(doc, clip, index, usedNodes, getCandidates);
530
- if (node) usedNodes.add(node);
531
- return node;
532
- };
533
- }
534
-
535
75
  // src/player/store/playerStoreSelection.ts
536
76
  function nextSelectionSet(current, id, preserveSet) {
537
77
  if (preserveSet) return id && current.has(id) ? new Set(current) : /* @__PURE__ */ new Set();
@@ -1828,37 +1368,6 @@ export {
1828
1368
  useMountEffect,
1829
1369
  usePreviewVariablesStore,
1830
1370
  applyPreviewVariablesToUrl,
1831
- getAdapterDuration,
1832
- getDefaultStaticSeekPlaybackClock,
1833
- releaseStaticSeekCache,
1834
- resolveStaticSeekFallback,
1835
- wrapTimeline,
1836
- LAYER_REVEAL_PRIOR_Z_ATTR,
1837
- LAYER_REVEAL_PRIOR_POSITION_ATTR,
1838
- readLayerRevealPriorZ,
1839
- readTimelineElementZIndex,
1840
- isTimelineIgnoredElement,
1841
- furthestClipEndFromDocument,
1842
- readTimelineDurationFromDocument,
1843
- furthestClipEndFromSource,
1844
- resolveMediaElement,
1845
- readPlaybackStartAttributes,
1846
- playbackStartAttributeForElement,
1847
- applyMediaMetadataFromElement,
1848
- getTimelineElementDisplayLabel,
1849
- getTimelineElementSelector,
1850
- getTimelineElementSourceFile,
1851
- getTimelineElementSelectorIndex,
1852
- buildTimelineElementKey,
1853
- splitTimelineElementKey,
1854
- buildTimelineElementIdentity,
1855
- getTimelineElementIdentity,
1856
- runtimeAudioId,
1857
- deriveTimelineStoreKey,
1858
- deriveTimelineStoreKeyForDomId,
1859
- previewElementFinder,
1860
- findClipElementById,
1861
- createTimelineDomNodeResolver,
1862
1371
  PANEL_IDS,
1863
1372
  PANEL_DEFINITIONS,
1864
1373
  isPanelId,
@@ -1891,4 +1400,4 @@ export {
1891
1400
  whenPreviewBooted,
1892
1401
  Player
1893
1402
  };
1894
- //# sourceMappingURL=chunk-ICTZJPQQ.js.map
1403
+ //# sourceMappingURL=chunk-AOWVEVEU.js.map