@hyperframes/core 0.8.159 → 0.8.161

package/dist/index.d.ts

@@ -1,49 +1,49 @@
 export type { RuntimeTimelineClipIdentity } from "./runtime/types.js";
-export type { ExecutionMode, Orientation, Asset, TimelineElement, TimelineElementBase, TimelineMediaElement, TimelineTextElement, TimelineCompositionElement, TimelineElementType, MediaElementType, CanvasResolution, Fps, FpsInput, FpsParseResult, MediaFile, CompositionAPI, PlayerAPI, AddElementData, ValidationResult, CompositionAsset, Keyframe, KeyframeProperties, ElementKeyframes, StageZoom, StageZoomKeyframe, CompositionVariableType, CompositionVariableBase, StringVariable, NumberVariable, ColorVariable, BooleanVariable, EnumVariable, CompositionVariable, CompositionSpec, WaveformData, OutputResolutionCompatibility, OutputResolutionIssueKind, } from "./core.types";
+export type { ExecutionMode, Orientation, Asset, TimelineElement, TimelineElementBase, TimelineMediaElement, TimelineTextElement, TimelineCompositionElement, TimelineElementType, MediaElementType, CanvasResolution, Fps, FpsInput, FpsParseResult, MediaFile, CompositionAPI, PlayerAPI, AddElementData, ValidationResult, CompositionAsset, Keyframe, KeyframeProperties, ElementKeyframes, StageZoom, StageZoomKeyframe, CompositionVariableType, CompositionVariableBase, StringVariable, NumberVariable, ColorVariable, BooleanVariable, EnumVariable, CompositionVariable, CompositionSpec, WaveformData, OutputResolutionCompatibility, OutputResolutionIssueKind, } from "./core.types.js";
 export type { SlideshowManifest, SlideRef, SlideHotspot, SlideSequence, ResolvedSlide, ResolvedSlideSequence, ResolvedSlideshow, } from "./slideshow/index.js";
 export { parseSlideshowManifest, resolveSlideshow } from "./slideshow/index.js";
 export type { AuthoredTimingValue, RawAuthoredTiming, AuthoredTimingWindow, } from "./runtime/authoredTiming.js";
 export { resolveAuthoredTimingWindow } from "./runtime/authoredTiming.js";
-export { CANVAS_DIMENSIONS, VALID_CANVAS_RESOLUTIONS, normalizeResolutionFlag, isAspectAgnosticResolutionAlias, resolveResolutionFlagPair, checkOutputResolutionCompatibility, suggestMatchingPreset, parseFps, parseFpsWithDefault, toFps, fpsToNumber, fpsToFfmpegArg, TIMELINE_COLORS, DEFAULT_DURATIONS, COMPOSITION_VARIABLE_TYPES, isTextElement, isMediaElement, isCompositionElement, getDefaultStageZoom, } from "./core.types";
-export { generateBaseHtml, getStageStyles } from "./templates/base";
-export { GSAP_CDN, BASE_STYLES, ELEMENT_BASE_STYLES, MEDIA_STYLES, TEXT_STYLES, ZOOM_CONTAINER_STYLES, } from "./templates/constants";
+export { CANVAS_DIMENSIONS, VALID_CANVAS_RESOLUTIONS, normalizeResolutionFlag, isAspectAgnosticResolutionAlias, resolveResolutionFlagPair, checkOutputResolutionCompatibility, suggestMatchingPreset, parseFps, parseFpsWithDefault, toFps, fpsToNumber, fpsToFfmpegArg, TIMELINE_COLORS, DEFAULT_DURATIONS, COMPOSITION_VARIABLE_TYPES, isTextElement, isMediaElement, isCompositionElement, getDefaultStageZoom, } from "./core.types.js";
+export { generateBaseHtml, getStageStyles } from "./templates/base.js";
+export { GSAP_CDN, BASE_STYLES, ELEMENT_BASE_STYLES, MEDIA_STYLES, TEXT_STYLES, ZOOM_CONTAINER_STYLES, } from "./templates/constants.js";
 export type { GsapAnimation, GsapMethod, ParsedGsap } from "@hyperframes/parsers";
 export { serializeGsapAnimations, getAnimationsForElementId, validateCompositionGsap, keyframesToGsapAnimations, gsapAnimationsToKeyframes, } from "@hyperframes/parsers";
 export type { ParsedHtml, CompositionMetadata } from "@hyperframes/parsers";
 export { parseHtml, updateElementInHtml, addElementToHtml, removeElementFromHtml, validateCompositionHtml, extractCompositionMetadata, } from "@hyperframes/parsers";
-export type { SerializeOptions } from "./generators/hyperframes";
-export { generateHyperframesHtml, generateGsapTimelineScript, generateHyperframesStyles, } from "./generators/hyperframes";
-export type { UnresolvedElement, ResolvedDuration, ResolvedMediaElement, CompilationResult, } from "./compiler/timingCompiler";
-export type { WordTiming, ElementAnchor, AuthoredTiming, ResolvedTiming, ResolveTimingsInput, ResolveTimingsResult, } from "./compiler/timingResolver";
-export { resolveTimings } from "./compiler/timingResolver";
-export { compileTimingAttrs, injectDurations, extractResolvedMedia, clampDurations, shouldClampMediaDuration, shouldClampResolvedMediaDuration, MEDIA_DURATION_CLAMP_EPSILON_SECONDS, } from "./compiler/timingCompiler";
-export { AUDIO_GROUP_RENDER_ID_ATTR, MEDIA_RENDER_ID_ATTR, assignMediaRenderIds, } from "./compiler/mediaRenderIds";
-export { RENDER_FRAME_ID_PREFIX, RENDER_FRAME_ID_SUFFIX, renderFrameIdForRenderId, } from "./runtime/renderFrameSibling";
-export { rewriteAssetPaths, rewriteAssetPath, rewriteCssAssetUrls, rewriteInlineStyleAssetUrls, } from "./compiler/rewriteSubCompPaths";
-export { CSS_URL_RE, isNonRelativeUrl, isPathInside } from "./compiler/assetPaths";
-export { checkSubCompositionUsability, type ParsableDocumentLike, type SubCompositionValidity, type SubCompositionValidityReason, } from "./compiler/subCompositionValidity";
-export { RUNTIME_BOOTSTRAP_ATTR, stripEmbeddedRuntimeScripts } from "./compiler/htmlDocument";
-export { COMPOSITION_SOURCE_URL } from "./compiler/scriptRuns";
-export { queryByAttr } from "./utils/cssSelector";
-export { AUDIBLE_MEDIA_SELECTOR, audibleVideoNeedsWebAudio, isAudibleVideoElement, } from "./audibleVideo";
-export { decodeUrlPathVariants } from "./utils/urlPath";
-export { clearGifFramesBeforeNext, gifClearsAfterLeavingFrameInPlace, parseAnimatedGifMetadata, type AnimatedGifMetadata, } from "./media/gif";
-export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS, HF_COLOR_GRADING_ANIMATABLE_PROPERTIES, HF_COLOR_GRADING_CANVAS_ID_PREFIX, HF_COLOR_GRADING_COLOR_SPACE, HF_COLOR_GRADING_CURVE_KEYS, HF_COLOR_GRADING_DETAIL_KEYS, HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS, HF_COLOR_GRADING_EFFECT_KEYS, HF_COLOR_GRADING_EFFECT_PRESETS, HF_COLOR_GRADING_GRADE_PRESETS, HF_COLOR_GRADING_HUE_CURVE_KEYS, HF_COLOR_GRADING_LUT_KEYS, HF_COLOR_GRADING_PALETTES, HF_COLOR_GRADING_PRESETS, HF_COLOR_GRADING_TOP_LEVEL_KEYS, HF_COLOR_GRADING_WHEEL_KEYS, getHfColorGradingCapabilities, hasHfColorGradingAuthoredValues, isHfColorGradingActive, normalizeHfColorGrading, normalizeHfColorGradingWithVariables, resolveHfColorGradingVariables, serializeHfColorGrading, type HfColorGrading, type HfColorGradingAdjust, type HfColorGradingAdjustKey, type HfColorGradingAnimatablePath, type HfColorGradingActiveEffectKey, type HfColorGradingDetailKey, type HfColorGradingDetails, type HfColorGradingEffectKey, type HfColorGradingEffects, type HfColorGradingLutRef, type HfColorGradingPreset, type HfColorGradingPresetId, type HfColorGradingTarget, type HfColorGradingVariableMap, type HfColorGradingCapabilities, type HfColorGradingCurveKey, type HfColorGradingCurves, type HfColorGradingHueCurveKey, type HfColorGradingHueCurves, type HfColorGradingHueRange, type HfColorGradingSecondary, type HfColorGradingSecondaryCorrection, type HfColorGradingSoftRange, type HfColorGradingTonalWheel, type HfColorGradingWheelKey, type HfColorGradingWheels, type HfColorCurvePoint, type HfHueCurvePoint, type NormalizedHfColorGrading, type NormalizedHfColorGradingCurves, type NormalizedHfColorGradingHueCurves, type NormalizedHfColorGradingSecondary, type NormalizedHfColorGradingWheels, type ResolvedHfColorGrading, } from "./colorGrading";
-export { parseCubeLut, CubeLutParseError, type ParseCubeLutOptions } from "./colorLuts";
-export { firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, type ToneMapSourceColour, } from "./hdrToneMap";
-export { PREVIEW_PROXY_BOX_PARAM, formatPreviewProxyBox, parsePreviewProxyBox, type PreviewProxyBox, } from "./previewProxyBox";
-export { HYPERFRAME_RUNTIME_ARTIFACTS, HYPERFRAME_RUNTIME_CONTRACT, loadHyperframeRuntimeSource, type HyperframeRuntimeContract, } from "./inline-scripts/hyperframe";
-export { HYPERFRAME_RUNTIME_GLOBALS, HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_CONTROL_ACTIONS, type HyperframeControlAction, } from "./inline-scripts/runtimeContract";
-export { getHyperframeRuntimeScript } from "./generated/runtime-inline";
-export { buildHyperframesRuntimeScript, type HyperframesRuntimeBuildOptions, } from "./inline-scripts/hyperframesRuntime.engine";
-export { MEDIA_VISUAL_STYLE_PROPERTIES, copyMediaVisualStyles, exportClipWindow, quantizeSeekTime, quantizeTimeToFrame, type MediaVisualStyleProperty, } from "./inline-scripts/parityContract";
-export { redactKnownPaths, redactTelemetryString } from "./telemetryRedaction";
-export { folderGone, isProjectRootMissing, isSafePath, mkdirWithinProject, ProjectRootMissingError, realpath, realProjectRoot, resolveWithinProject, } from "./safePath";
-export { isHyperframesProject, PROJECT_MARKER_FILES } from "./projectRule";
-export type { HyperframePickerApi, HyperframePickerBoundingBox, HyperframePickerElementInfo, } from "./inline-scripts/pickerApi";
-export type { FrameAdapter, FrameAdapterContext } from "./adapters/types";
-export type { GSAPTimelineLike, CreateGSAPFrameAdapterOptions } from "./adapters/gsap";
-export { createGSAPFrameAdapter } from "./adapters/gsap";
+export type { SerializeOptions } from "./generators/hyperframes.js";
+export { generateHyperframesHtml, generateGsapTimelineScript, generateHyperframesStyles, } from "./generators/hyperframes.js";
+export type { UnresolvedElement, ResolvedDuration, ResolvedMediaElement, CompilationResult, } from "./compiler/timingCompiler.js";
+export type { WordTiming, ElementAnchor, AuthoredTiming, ResolvedTiming, ResolveTimingsInput, ResolveTimingsResult, } from "./compiler/timingResolver.js";
+export { resolveTimings } from "./compiler/timingResolver.js";
+export { compileTimingAttrs, injectDurations, extractResolvedMedia, clampDurations, shouldClampMediaDuration, shouldClampResolvedMediaDuration, MEDIA_DURATION_CLAMP_EPSILON_SECONDS, } from "./compiler/timingCompiler.js";
+export { AUDIO_GROUP_RENDER_ID_ATTR, MEDIA_RENDER_ID_ATTR, assignMediaRenderIds, } from "./compiler/mediaRenderIds.js";
+export { RENDER_FRAME_ID_PREFIX, RENDER_FRAME_ID_SUFFIX, renderFrameIdForRenderId, } from "./runtime/renderFrameSibling.js";
+export { rewriteAssetPaths, rewriteAssetPath, rewriteCssAssetUrls, rewriteInlineStyleAssetUrls, } from "./compiler/rewriteSubCompPaths.js";
+export { CSS_URL_RE, isNonRelativeUrl, isPathInside } from "./compiler/assetPaths.js";
+export { checkSubCompositionUsability, type ParsableDocumentLike, type SubCompositionValidity, type SubCompositionValidityReason, } from "./compiler/subCompositionValidity.js";
+export { RUNTIME_BOOTSTRAP_ATTR, stripEmbeddedRuntimeScripts } from "./compiler/htmlDocument.js";
+export { COMPOSITION_SOURCE_URL } from "./compiler/scriptRuns.js";
+export { queryByAttr } from "./utils/cssSelector.js";
+export { AUDIBLE_MEDIA_SELECTOR, audibleVideoNeedsWebAudio, isAudibleVideoElement, } from "./audibleVideo.js";
+export { decodeUrlPathVariants } from "./utils/urlPath.js";
+export { clearGifFramesBeforeNext, gifClearsAfterLeavingFrameInPlace, parseAnimatedGifMetadata, type AnimatedGifMetadata, } from "./media/gif.js";
+export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS, HF_COLOR_GRADING_ANIMATABLE_PROPERTIES, HF_COLOR_GRADING_CANVAS_ID_PREFIX, HF_COLOR_GRADING_COLOR_SPACE, HF_COLOR_GRADING_CURVE_KEYS, HF_COLOR_GRADING_DETAIL_KEYS, HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS, HF_COLOR_GRADING_EFFECT_KEYS, HF_COLOR_GRADING_EFFECT_PRESETS, HF_COLOR_GRADING_GRADE_PRESETS, HF_COLOR_GRADING_HUE_CURVE_KEYS, HF_COLOR_GRADING_LUT_KEYS, HF_COLOR_GRADING_PALETTES, HF_COLOR_GRADING_PRESETS, HF_COLOR_GRADING_TOP_LEVEL_KEYS, HF_COLOR_GRADING_WHEEL_KEYS, getHfColorGradingCapabilities, hasHfColorGradingAuthoredValues, isHfColorGradingActive, normalizeHfColorGrading, normalizeHfColorGradingWithVariables, resolveHfColorGradingVariables, serializeHfColorGrading, type HfColorGrading, type HfColorGradingAdjust, type HfColorGradingAdjustKey, type HfColorGradingAnimatablePath, type HfColorGradingActiveEffectKey, type HfColorGradingDetailKey, type HfColorGradingDetails, type HfColorGradingEffectKey, type HfColorGradingEffects, type HfColorGradingLutRef, type HfColorGradingPreset, type HfColorGradingPresetId, type HfColorGradingTarget, type HfColorGradingVariableMap, type HfColorGradingCapabilities, type HfColorGradingCurveKey, type HfColorGradingCurves, type HfColorGradingHueCurveKey, type HfColorGradingHueCurves, type HfColorGradingHueRange, type HfColorGradingSecondary, type HfColorGradingSecondaryCorrection, type HfColorGradingSoftRange, type HfColorGradingTonalWheel, type HfColorGradingWheelKey, type HfColorGradingWheels, type HfColorCurvePoint, type HfHueCurvePoint, type NormalizedHfColorGrading, type NormalizedHfColorGradingCurves, type NormalizedHfColorGradingHueCurves, type NormalizedHfColorGradingSecondary, type NormalizedHfColorGradingWheels, type ResolvedHfColorGrading, } from "./colorGrading.js";
+export { parseCubeLut, CubeLutParseError, type ParseCubeLutOptions } from "./colorLuts.js";
+export { firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, type ToneMapSourceColour, } from "./hdrToneMap.js";
+export { PREVIEW_PROXY_BOX_PARAM, formatPreviewProxyBox, parsePreviewProxyBox, type PreviewProxyBox, } from "./previewProxyBox.js";
+export { HYPERFRAME_RUNTIME_ARTIFACTS, HYPERFRAME_RUNTIME_CONTRACT, loadHyperframeRuntimeSource, type HyperframeRuntimeContract, } from "./inline-scripts/hyperframe.js";
+export { HYPERFRAME_RUNTIME_GLOBALS, HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_CONTROL_ACTIONS, type HyperframeControlAction, } from "./inline-scripts/runtimeContract.js";
+export { getHyperframeRuntimeScript } from "./generated/runtime-inline.js";
+export { buildHyperframesRuntimeScript, type HyperframesRuntimeBuildOptions, } from "./inline-scripts/hyperframesRuntime.engine.js";
+export { MEDIA_VISUAL_STYLE_PROPERTIES, copyMediaVisualStyles, exportClipWindow, quantizeSeekTime, quantizeTimeToFrame, type MediaVisualStyleProperty, } from "./inline-scripts/parityContract.js";
+export { redactKnownPaths, redactTelemetryString } from "./telemetryRedaction.js";
+export { folderGone, isProjectRootMissing, isSafePath, mkdirWithinProject, ProjectRootMissingError, realpath, realProjectRoot, resolveWithinProject, } from "./safePath.js";
+export { isHyperframesProject, PROJECT_MARKER_FILES } from "./projectRule.js";
+export type { HyperframePickerApi, HyperframePickerBoundingBox, HyperframePickerElementInfo, } from "./inline-scripts/pickerApi.js";
+export type { FrameAdapter, FrameAdapterContext } from "./adapters/types.js";
+export type { GSAPTimelineLike, CreateGSAPFrameAdapterOptions } from "./adapters/gsap.js";
+export { createGSAPFrameAdapter } from "./adapters/gsap.js";
 export { fitTextFontSize } from "./text/index.js";
 export type { FitTextOptions, FitTextResult } from "./text/index.js";
 export { formatRenderOutputTimestamp } from "./utils/renderOutputTimestamp.js";

package/dist/inline-scripts/hyperframe.d.ts

@@ -1,4 +1,4 @@
-import { HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_RUNTIME_GLOBALS } from "./runtimeContract";
+import { HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_RUNTIME_GLOBALS } from "./runtimeContract.js";
 export declare const HYPERFRAME_RUNTIME_ARTIFACTS: {
     readonly iife: "hyperframe.runtime.iife.js";
     readonly esm: "hyperframe.runtime.mjs";

package/dist/projects.d.ts

@@ -1,4 +1,4 @@
-import { isHyperframesProject, PROJECT_MARKER_FILES } from "./projectRule";
+import { isHyperframesProject, PROJECT_MARKER_FILES } from "./projectRule.js";
 export { isHyperframesProject, PROJECT_MARKER_FILES };
 export interface FoundProject {
     path: string;

package/dist/runtime/bridge.d.ts

@@ -1,5 +1,5 @@
-import type { HfColorGradingTarget } from "../colorGrading";
-import type { RuntimeOutboundMessage } from "./types";
+import type { HfColorGradingTarget } from "../colorGrading.js";
+import type { RuntimeOutboundMessage } from "./types.js";
 type BridgeDeps = {
     onPlay: () => void;
     onPause: () => void;

package/dist/runtime/clipTree.d.ts

@@ -9,7 +9,7 @@
  * (id/parentId/children) plus the backing element. Add fields (label, kind,
  * absolute start) when a caller needs them.
  */
-import type { RuntimeTimelineLike } from "./types";
+import type { RuntimeTimelineLike } from "./types.js";
 export interface ClipNode {
     readonly id: string;
     readonly element: Element;

package/dist/runtime/compositionLength.d.ts

@@ -1,6 +1,6 @@
 import { type CompositionDurationResult } from "@hyperframes/parsers/composition-duration";
-import { findRootCompositionElement } from "./compositionDimension";
-import { createRuntimeStartTimeResolver } from "./startResolver";
+import { findRootCompositionElement } from "./compositionDimension.js";
+import { createRuntimeStartTimeResolver } from "./startResolver.js";
 export { findRootCompositionElement };
 export declare const LOOP_INFLATED_TIMELINE_SECONDS = 7200;
 /** One frame at 60 fps: a timeline, floor or fallback this short or shorter is no length at all. */

package/dist/runtime/media.d.ts

@@ -80,6 +80,7 @@ export declare function evictMediaSyncState(el: HTMLMediaElement): void;
 /** Test-only seam: whether any per-source sync state is still tracked for `el`. */
 export declare function hasMediaSyncStateForTest(el: HTMLMediaElement): boolean;
 export declare const MEDIA_HARD_SYNC_SECONDS = 0.5;
+export declare const VIDEO_PRESEEK_SECONDS = 1.5;
 /** Drift a playing audio element may carry before sync pulls it back onto the playhead. */
 export declare const MEDIA_SYNC_TOLERANCE_SECONDS = 0.04;
 export declare function syncRuntimeMedia(params: {

package/dist/runtime/media.js

@@ -191,6 +191,40 @@ export function hasMediaSyncStateForTest(el) {
         videoSteering.has(el));
 }
 export const MEDIA_HARD_SYNC_SECONDS = 0.5;
+export const VIDEO_PRESEEK_SECONDS = 1.5;
+function prepareUpcomingVideo(clip, time, playing, rate) {
+    const { el } = clip;
+    const dueIn = clip.start - time;
+    if (!playing ||
+        el.tagName !== "VIDEO" ||
+        dueIn <= 0 ||
+        dueIn > VIDEO_PRESEEK_SECONDS * rate ||
+        !el.paused ||
+        el.seeking ||
+        el.readyState < el.HAVE_METADATA ||
+        findInjectedRenderFrame(el) ||
+        ("__HF_EXPORT_RENDER_SEEK_CONFIG" in window && window.__HF_EXPORT_RENDER_SEEK_CONFIG))
+        return;
+    let target = clip.mediaStart +
+        sourceTimeAt(clip.rate ?? clip.playbackRate, clip.start - (clip.origin ?? clip.start));
+    if (clip.sourceDuration != null) {
+        const loopLength = clip.sourceDuration - clip.mediaStart;
+        if (clip.loop && loopLength > 0 && target >= clip.sourceDuration)
+            target = clip.mediaStart + ((target - clip.mediaStart) % loopLength);
+        else if (!clip.loop)
+            target = Math.min(target, clip.sourceDuration);
+    }
+    if (!Number.isFinite(target) || target < 0 || Math.abs(el.currentTime - target) <= 0.001)
+        return;
+    try {
+        // A trimmed video exposed during its in-point seek has no current frame at the cut.
+        // Hidden preparation must not hold the visible-frame seek barrier.
+        el.currentTime = target;
+    }
+    catch (err) {
+        swallow("runtime.media.preseek", err);
+    }
+}
 /** Drift a playing audio element may carry before sync pulls it back onto the playhead. */
 export const MEDIA_SYNC_TOLERANCE_SECONDS = 0.04;
 // Chromium refuses a slower playbackRate (NotSupportedError).
@@ -535,5 +569,6 @@ export function syncRuntimeMedia(params) {
             lastRelativeTime.set(el, relTime);
         if (!el.paused)
             el.pause();
+        prepareUpcomingVideo(clip, params.timeSeconds, params.playing, params.playbackRate);
     }
 }

package/dist/runtime/mediaVolumeEnvelope.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeTimelineLike } from "./types";
+import type { RuntimeTimelineLike } from "./types.js";
 /**
  * Shared volume-automation utilities used by both the renderer (offline PCM
  * baking in audioVolumeEnvelope.ts) and the preview runtime (per-tick gain

package/dist/runtime/playbackRate.d.ts

@@ -1,5 +1,5 @@
 import { clampPlaybackRate } from "@hyperframes/parsers/media-duration";
-import { type RateSpec } from "../speedRamp";
+import { type RateSpec } from "../speedRamp.js";
 export declare const normalizePlaybackRate: typeof clampPlaybackRate;
 /** Parse a literal numeric timing attribute without accepting trailing units or garbage. */
 export declare function parseStrictFiniteTimingNumber(raw: string | null | undefined): number | null;

package/dist/runtime/startResolver.d.ts

@@ -1,5 +1,5 @@
-import type { RuntimeTimelineLike } from "./types";
-import { type HostSlot } from "../mediaTiming";
+import type { RuntimeTimelineLike } from "./types.js";
+import { type HostSlot } from "../mediaTiming.js";
 export declare function createRuntimeStartTimeResolver(params: {
     timelineRegistry?: Record<string, Pick<RuntimeTimelineLike, "duration"> | undefined>;
     includeAuthoredTimingAttrs?: boolean;
@@ -18,4 +18,4 @@ export declare function createRuntimeStartTimeResolver(params: {
     resolveHostSlotsForElement: (element: Element) => HostSlot[];
     isRootGlobalMediaStartForElement: (element: Element) => boolean;
 };
-export type { RuntimeTimelineLike } from "./types";
+export type { RuntimeTimelineLike } from "./types.js";

package/dist/runtime/state.d.ts

@@ -1,6 +1,6 @@
-import type { RuntimeDeterministicAdapter, RuntimeTimelineLike } from "./types";
-import type { RuntimeMediaClip } from "./media";
-import type { TransportClock } from "./clock";
+import type { RuntimeDeterministicAdapter, RuntimeTimelineLike } from "./types.js";
+import type { RuntimeMediaClip } from "./media.js";
+import type { TransportClock } from "./clock.js";
 export type RuntimeState = {
     capturedTimeline: RuntimeTimelineLike | null;
     isPlaying: boolean;

package/dist/runtime/timeline.d.ts

@@ -1,5 +1,5 @@
-import type { RuntimeTimelineMessage, RuntimeTimelineLike } from "./types";
-import { createRuntimeStartTimeResolver } from "./startResolver";
+import type { RuntimeTimelineMessage, RuntimeTimelineLike } from "./types.js";
+import { createRuntimeStartTimeResolver } from "./startResolver.js";
 export declare function isRuntimeElementVisibleAt(rawNode: HTMLElement, options: {
     currentTime: number;
     compositionDuration: number;

package/dist/runtime/timelineDuration.d.ts

@@ -1,3 +1,3 @@
-import type { RuntimeTimelineLike } from "./types";
+import type { RuntimeTimelineLike } from "./types.js";
 /** A registered timeline's finite duration(); a partial, throwing or non-numeric entry reads as null. */
 export declare function readTimelineDurationSeconds(timeline: Pick<RuntimeTimelineLike, "duration"> | null | undefined): number | null;

package/dist/runtime/types.d.ts

@@ -1,5 +1,5 @@
-import type { HfColorGradingTarget } from "../colorGrading";
-import type { RuntimeAnalyticsEvent } from "./analytics";
+import type { HfColorGradingTarget } from "../colorGrading.js";
+import type { RuntimeAnalyticsEvent } from "./analytics.js";
 export type RuntimeJson = string | number | boolean | null | RuntimeJson[] | {
     [key: string]: RuntimeJson;
 };

package/dist/runtime/validateVariables.d.ts

@@ -1,4 +1,4 @@
-import type { CompositionVariable } from "../core.types";
+import type { CompositionVariable } from "../core.types.js";
 export type VariableValidationIssue = {
     kind: "undeclared";
     variableId: string;

package/dist/templates/base.d.ts

@@ -1,3 +1,3 @@
-import { type CanvasResolution } from "../core.types";
+import { type CanvasResolution } from "../core.types.js";
 export declare function generateBaseHtml(resolution?: CanvasResolution): string;
 export declare function getStageStyles(resolution?: CanvasResolution): string;

package/dist/vfx/refs/displacementMap.d.ts

@@ -10,7 +10,7 @@
  * rather than being implied. Its values are **premultiplied**, matching the
  * capture texture the runtime uploads.
  */
-import { type HfVfxParamValues } from "../../vfx";
+import { type HfVfxParamValues } from "../../vfx.js";
 export interface MapTexel {
     r: number;
     g: number;

package/dist/vfx/refs/fractalNoise.d.ts

@@ -10,7 +10,7 @@
  * shader samples fragment centres, so a caller comparing against pixel
  * `(i, j)` should pass `(i + 0.5, j + 0.5)`.
  */
-import { type HfVfxParamValues } from "../../vfx";
+import { type HfVfxParamValues } from "../../vfx.js";
 /**
  * The shader's `hfHashUnit`. `Math.imul` + `>>> 0` reproduce GLSL's 32-bit
  * `uint` wrap-around exactly; without them JS would carry the products into

package/dist/vfx/refs/lumaMatte.d.ts

@@ -6,7 +6,7 @@
  *
  * Both texels are **premultiplied**, matching the textures the runtime uploads.
  */
-import { type HfVfxParamValues } from "../../vfx";
+import { type HfVfxParamValues } from "../../vfx.js";
 export interface Rgba {
     r: number;
     g: number;

package/dist/vfx/refs/noise.d.ts

@@ -8,7 +8,7 @@
  * the entirety of what the kernel computes, and the add-and-clip around it is
  * two lines a caller can apply itself.
  */
-import { type HfVfxParamValues } from "../../vfx";
+import { type HfVfxParamValues } from "../../vfx.js";
 /** The hash's 15-bit output byte for one channel index `a`. */
 export declare function noiseByteRef(a: number, y: number, seed: number): number;
 /**

package/dist/vfx/refs/waveWarp.d.ts

@@ -7,7 +7,7 @@
  * Coordinates are device pixels with y measured from the bottom — the shader's
  * `v_uv * u_size`, and the order `gl.readPixels` returns rows in.
  */
-import { type HfVfxParamValues } from "../../vfx";
+import { type HfVfxParamValues } from "../../vfx.js";
 /** Where the kernel reads from to paint `(x, y)`, in the same pixel space. */
 export declare function waveWarpSampleRef(p: {
     x: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.159",
+  "version": "0.8.161",
   "description": "",
   "repository": {
     "type": "git",
@@ -184,6 +184,10 @@
       "import": "./dist/audibleVideo.js",
       "types": "./dist/audibleVideo.d.ts"
     },
+    "./audio-analysis": {
+      "import": "./dist/audioAnalysis.js",
+      "types": "./dist/audioAnalysis.d.ts"
+    },
     "./audio-gain": {
       "import": "./dist/audioGain.js",
       "types": "./dist/audioGain.d.ts"
@@ -370,13 +374,12 @@
   "dependencies": {
     "@chenglou/pretext": "^0.0.5",
     "acorn": "^8.17.0",
-    "bpm-detective": "^2.0.5",
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.8.159",
-    "@hyperframes/studio-server": "0.8.159",
-    "@hyperframes/parsers": "0.8.159"
+    "@hyperframes/lint": "0.8.161",
+    "@hyperframes/studio-server": "0.8.161",
+    "@hyperframes/parsers": "0.8.161"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",
@@ -410,7 +413,7 @@
     "esbuild": "^0.25.12"
   },
   "scripts": {
-    "build": "bun run build:fonts && bun run build:svg-selector-aliases && bun run build:hyperframes-runtime && bun run build:position-edits-render && bun run build:audio-fx-runtime && tsc && tsx scripts/rewrite-esm-extensions.ts",
+    "build": "bun run build:fonts && bun run build:svg-selector-aliases && bun run build:hyperframes-runtime && bun run build:position-edits-render && bun run build:audio-fx-runtime && tsc && node ../../scripts/rewrite-relative-import-extensions.mjs dist",
     "build:fonts": "node scripts/build-fonts.mjs",
     "test": "bun run check:position-edits-render && bun run check:svg-selector-aliases && bun run build:audio-fx-runtime && vitest run",
     "test:watch": "vitest",