@hyperframes/core 0.8.160 → 0.8.162

package/dist/beats/beatDetection.js

@@ -1,28 +1,5 @@
-let bpmDetectivePromise = null;
-const defaultBpmDetectiveImport = () => 
-// @ts-ignore -- no type declarations for bpm-detective
-import("bpm-detective");
-export function loadBpmDetective(importFn = defaultBpmDetectiveImport) {
-    const useCache = importFn === defaultBpmDetectiveImport;
-    if (useCache && bpmDetectivePromise) {
-        return bpmDetectivePromise;
-    }
-    const promise = importFn()
-        .then((m) => (m.default ?? m) || null)
-        .catch(() => {
-        // Reset the cached promise so a transient import failure can be retried
-        // on the next call instead of being cached as null for the session.
-        if (useCache)
-            bpmDetectivePromise = null;
-        return null;
-    });
-    if (useCache) {
-        bpmDetectivePromise = promise;
-    }
-    return promise;
-}
-const WINDOW_SIZE = 1024;
-const HOP_SIZE = 512;
+import { energyMix } from "../audioAnalysis.js";
+import { bandFramesOf, rhythm, tempoOf } from "../audioRhythm.js";
 const STRENGTH_WINDOW_S = 0.05; // ±50ms RMS window
 /** Local RMS amplitude at a given audio-file time. */
 export function computeRmsAt(channelData, sampleRate, time) {
@@ -43,208 +20,39 @@ export function strengthAtTime(analysis, time) {
         return 0.5;
     return Math.min(1, computeRmsAt(analysis.channelData, analysis.sampleRate, time) / analysis.peak);
 }
-// fallow-ignore-next-line complexity
-export async function detectBeats(audioBuffer) {
-    const channelData = audioBuffer.getChannelData(0);
-    const sampleRate = audioBuffer.sampleRate;
-    const energies = [];
-    for (let i = 0; i < channelData.length - WINDOW_SIZE; i += HOP_SIZE) {
-        let sum = 0;
-        for (let j = 0; j < WINDOW_SIZE; j++) {
-            const sample = channelData[i + j];
-            sum += sample * sample;
-        }
-        energies.push(sum / WINDOW_SIZE);
-    }
-    const beats = [];
-    const localWindowSize = 20;
-    for (let i = localWindowSize; i < energies.length - localWindowSize; i++) {
-        let localMean = 0;
-        for (let j = i - localWindowSize; j < i + localWindowSize; j++) {
-            localMean += energies[j];
-        }
-        localMean /= localWindowSize * 2;
-        const threshold = localMean * 1.5;
-        const current = energies[i];
-        if (current > threshold &&
-            current > (energies[i - 1] ?? 0) &&
-            current > (energies[i + 1] ?? 0)) {
-            const timeInSeconds = (i * HOP_SIZE) / sampleRate;
-            if (beats.length === 0 || timeInSeconds - beats[beats.length - 1] > 0.1) {
-                beats.push(Math.round(timeInSeconds * 1000) / 1000);
-            }
-        }
-    }
-    return beats;
-}
-function computeBpmFromBeats(beatTimes) {
-    if (beatTimes.length < 4)
-        return null;
-    const iois = [];
-    for (let i = 1; i < beatTimes.length; i++) {
-        iois.push(beatTimes[i] - beatTimes[i - 1]);
-    }
-    const sorted = [...iois].sort((a, b) => a - b);
-    const mid = Math.floor(sorted.length / 2);
-    const medianIoi = sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
-    if (medianIoi <= 0)
-        return null;
-    return Math.round((60 / medianIoi) * 10) / 10;
-}
-// Fold into 60–120 for octave-safe BPM comparison
-function canonicalizeBpm(bpm) {
-    let b = bpm;
-    while (b > 120)
-        b /= 2;
-    while (b < 60)
-        b *= 2;
-    return b;
-}
-// Pick the *2/÷2 octave of `bpm` whose beat interval is closest to the onset
-// pulse, so a half-time detective reading (e.g. 174 for an 87bpm song) doesn't
-// produce a double-density grid.
-function octaveAlignBpm(bpm, reference) {
-    const candidates = [bpm / 2, bpm, bpm * 2];
-    let best = bpm;
-    let bestDist = Number.POSITIVE_INFINITY;
-    for (const c of candidates) {
-        if (c <= 0)
-            continue;
-        const dist = Math.abs(c - reference);
-        if (dist < bestDist) {
-            bestDist = dist;
-            best = c;
-        }
-    }
-    return best;
-}
-// fallow-ignore-next-line complexity
-function regularizeBeats(rawBeats, bpm, duration) {
-    if (rawBeats.length === 0 || bpm <= 0 || duration <= 0)
-        return rawBeats;
-    const beatInterval = 60 / bpm;
-    // Guard against a pathological (octave-misread) tempo producing a millisecond
-    // interval → tens of thousands of grid beats that freeze the timeline. 480 BPM
-    // (0.125s) is well above any real music tempo; bail to the raw onsets instead.
-    if (beatInterval < 0.125)
-        return rawBeats;
-    const threshold = beatInterval * 0.25;
-    // Find phase offset that maximally aligns with raw onsets
-    let bestOffset = 0;
-    let bestScore = -1;
-    for (const anchor of rawBeats.slice(0, 10)) {
-        const offset = ((anchor % beatInterval) + beatInterval) % beatInterval;
-        let score = 0;
-        for (const rb of rawBeats) {
-            const phase = ((rb % beatInterval) + beatInterval) % beatInterval;
-            const dist = Math.min(Math.abs(phase - offset), beatInterval - Math.abs(phase - offset));
-            if (dist < threshold)
-                score++;
-        }
-        if (score > bestScore) {
-            bestScore = score;
-            bestOffset = offset;
-        }
-    }
-    const beats = [];
-    for (let t = bestOffset; t <= duration + 0.001; t += beatInterval) {
-        beats.push(Math.round(t * 1000) / 1000);
-    }
-    return beats;
-}
-// Drop beats that fall in silent/near-silent regions (e.g. intro/outro) and
-// score each surviving beat's loudness (local RMS / peak) for brightness.
-function gateBeatsBySilence(beats, channelData, sampleRate) {
-    if (beats.length === 0)
-        return { times: beats, strengths: [], peak: 1e-6 };
-    const energies = beats.map((t) => computeRmsAt(channelData, sampleRate, t));
+/** At or above this the tempo is reported as "high" confidence. */
+const HIGH_CONFIDENCE = 0.35;
+/** Each beat's local RMS against the loudest beat's, and that loudest RMS. */
+function beatStrengths(beats, levels, sampleRate) {
+    const energies = beats.map((t) => computeRmsAt(levels, sampleRate, t));
     const peak = Math.max(...energies, 1e-6);
-    const threshold = peak * 0.12;
-    const times = [];
-    const strengths = [];
-    for (let i = 0; i < beats.length; i++) {
-        if (energies[i] >= threshold) {
-            times.push(beats[i]);
-            strengths.push(Math.min(1, energies[i] / peak));
-        }
-    }
-    return { times, strengths, peak };
+    return { strengths: energies.map((e) => Math.min(1, e / peak)), peak };
 }
-// fallow-ignore-next-line complexity
-export async function analyzeMusicFromBuffer(audioBuffer, { pause } = {}) {
-    const channelData = audioBuffer.getChannelData(0);
-    const sampleRate = audioBuffer.sampleRate;
-    const duration = audioBuffer.duration;
+/** Beats, tempo and per-beat strength of decoded audio; no beats and a null bpm when it has no steady beat. */
+export async function analyzeMusicFromSignal(signal, { pause } = {}) {
     await pause?.();
-    const rawBeats = await detectBeats(audioBuffer);
-    const onsetBpm = computeBpmFromBeats(rawBeats);
-    let detectiveBpm = null;
-    const detect = await loadBpmDetective();
+    bandFramesOf(signal);
     await pause?.();
-    try {
-        if (detect)
-            detectiveBpm = detect(audioBuffer);
-    }
-    catch {
-        // Not enough peaks or browser context unavailable
-    }
-    let bpm = onsetBpm;
-    let confidence = "uncertain";
-    let regularizeBpm = null;
-    if (onsetBpm !== null && detectiveBpm !== null) {
-        const pctDiff = Math.abs(canonicalizeBpm(onsetBpm) - canonicalizeBpm(detectiveBpm)) /
-            canonicalizeBpm(detectiveBpm);
-        if (pctDiff < 0.05) {
-            // Detective folds tempo into 90–180; re-pick the octave nearest the onset
-            // pulse so a half-time track isn't gridded at double density.
-            bpm = octaveAlignBpm(detectiveBpm, onsetBpm);
-            confidence = "high";
-            regularizeBpm = bpm;
-        }
-        else if (pctDiff < 0.1) {
-            bpm = Math.round((onsetBpm + detectiveBpm) / 2);
-            confidence = "low";
-            regularizeBpm = bpm;
-        }
-        else {
-            bpm = onsetBpm;
-            confidence = "uncertain";
-        }
-    }
-    else if (onsetBpm !== null) {
-        bpm = onsetBpm;
-        confidence = "low";
-        regularizeBpm = onsetBpm;
-    }
-    else if (detectiveBpm !== null) {
-        bpm = detectiveBpm;
-        confidence = "low";
-        regularizeBpm = detectiveBpm;
-    }
+    const { beats } = rhythm(signal);
     await pause?.();
-    const gridBeats = regularizeBpm !== null ? regularizeBeats(rawBeats, regularizeBpm, duration) : rawBeats;
-    const gated = gateBeatsBySilence(gridBeats, channelData, sampleRate);
+    const channelData = energyMix(signal);
+    const confidence = beats.confidence ?? 0;
+    const times = beats.times;
+    const { strengths, peak } = beatStrengths(times, channelData, signal.sampleRate);
+    const bpm = tempoOf(times).value;
     return {
-        beatTimes: gated.times,
-        beatStrengths: gated.strengths,
+        beatTimes: times,
+        beatStrengths: strengths,
         bpm,
-        bpmConfidence: confidence,
+        bpmConfidence: bpm === null ? "uncertain" : confidence >= HIGH_CONFIDENCE ? "high" : "low",
         channelData,
-        sampleRate,
-        peak: gated.peak,
+        sampleRate: signal.sampleRate,
+        peak,
     };
 }
-export async function detectBeatsFromUrl(url) {
-    const audioContext = new AudioContext();
-    try {
-        const response = await fetch(url);
-        const arrayBuffer = await response.arrayBuffer();
-        const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
-        return detectBeats(audioBuffer);
-    }
-    finally {
-        await audioContext.close();
-    }
+export function analyzeMusicFromBuffer(audioBuffer, options = {}) {
+    const channels = Array.from({ length: audioBuffer.numberOfChannels }, (_, c) => audioBuffer.getChannelData(c));
+    return analyzeMusicFromSignal({ sampleRate: audioBuffer.sampleRate, channels }, options);
 }
 export async function analyzeMusicFromUrl(url, options = {}) {
     const audioContext = new AudioContext();

package/dist/colorGrading.d.ts

@@ -1,7 +1,7 @@
-import type { HfColorCurvePoint, HfHueCurvePoint } from "./colorGradingCurves";
+import type { HfColorCurvePoint, HfHueCurvePoint } from "./colorGradingCurves.js";
 import { COLOR_GRADING_ADJUST_KEYS, COLOR_GRADING_CURVE_KEYS, COLOR_GRADING_DETAIL_KEYS, COLOR_GRADING_EFFECT_KEYS, COLOR_GRADING_HUE_CURVE_KEYS, COLOR_GRADING_WHEEL_KEYS } from "@hyperframes/parsers/color-grading-contract";
-export type { HfColorCurvePoint, HfHueCurvePoint } from "./colorGradingCurves";
-export { compileHfColorCurve, compileHfHueCurve, HF_COLOR_CURVE_MAX_POINTS, } from "./colorGradingCurves";
+export type { HfColorCurvePoint, HfHueCurvePoint } from "./colorGradingCurves.js";
+export { compileHfColorCurve, compileHfHueCurve, HF_COLOR_CURVE_MAX_POINTS, } from "./colorGradingCurves.js";
 export declare const HF_COLOR_GRADING_ATTR = "data-color-grading";
 /** Set on a graded source while its pixels render on the grading canvas. */
 export declare const COLOR_GRADING_SOURCE_HIDDEN_ATTR = "data-hf-color-grading-source-hidden";

package/dist/compiler/htmlBundler.d.ts

@@ -1,5 +1,5 @@
-export { FLATTENED_INNER_ROOT_STRIP_ATTRS } from "../runtime/flattenedRoot";
-import { type MediaDurationProber } from "./htmlCompiler";
+export { FLATTENED_INNER_ROOT_STRIP_ATTRS } from "../runtime/flattenedRoot.js";
+import { type MediaDurationProber } from "./htmlCompiler.js";
 export type BundledHostCompositionIdentity = {
     authoredCompositionId: string | null;
     runtimeCompositionId: string | null;

package/dist/compiler/index.d.ts

@@ -1,19 +1,19 @@
-export { resolveTimings, type WordTiming, type ElementAnchor, type AuthoredTiming, type ResolvedTiming, type ResolveTimingsInput, type ResolveTimingsResult, } from "./timingResolver";
-export { compileTimingAttrs, injectDurations, extractResolvedMedia, clampDurations, shouldClampMediaDuration, shouldClampResolvedMediaDuration, type UnresolvedElement, type ResolvedDuration, type ResolvedMediaElement, type CompilationResult, } from "./timingCompiler";
-export { compileHtml, type MediaDurationProber } from "./htmlCompiler";
-export { assignBundledRuntimeCompositionIds, type BundledHostCompositionIdentity, bundleToSingleHtml, type BundleOptions, type BundleScriptProvenance, prepareFlattenedInnerRoot, FLATTENED_INNER_ROOT_STRIP_ATTRS, emitRootCompositionVariableStyles, parsesAsScript, } from "./htmlBundler";
-export { readDeclaredDefaults, parseHostVariableValues } from "../runtime/getVariables";
-export { extractCompiledHtmlParityContract, type CompiledHtmlParityContract, type HtmlParityComposition, type HtmlParityResource, type HtmlParityTimedElement, } from "./htmlParityContract";
-export { RUNTIME_BOOTSTRAP_ATTR, injectScriptsAtHeadStart, injectTagsAtHeadStart, injectScriptsIntoHtml, insertBeforeCloseTag, insertRuntimeTag, isRuntimeFileUrl, parseHTMLContent, stripEmbeddedRuntimeScripts, } from "./htmlDocument";
-export { addScenePartsManifest } from "./scenePartsManifest";
-export { AFTER_FONTS_SCRIPT_TYPE, compositionStyle, cssStyleMergeKey, deferScriptsUntilFonts, headStyleRuns, inlineScriptRuns, styleElementsFor, type CompositionStyle, type InlineScriptRun, } from "./scriptRuns";
-export { isJavaScriptType } from "./compositionAssembly";
-export { validateHyperframeHtmlContract, type HyperframeStaticFailureReason, type HyperframeStaticGuardResult, } from "./staticGuard";
-export { buildVariablesByCompScript, scopeCssToComposition, wrapScopedCompositionScript, } from "./compositionScoping";
-export { ensureExternalLinkTag, inlineSubCompositions, type InlineSubCompositionsOptions, type InlineSubCompositionsResult, } from "./inlineSubCompositions";
-export { extractStandaloneEntryFromIndex, isTemplateEntry } from "./standaloneEntry";
-export { checkSubCompositionUsability, type ParsableDocumentLike, type SubCompositionValidity, type SubCompositionValidityReason, } from "./subCompositionValidity";
-export { CSS_URL_RE, PATH_ATTRS, isNonRelativeUrl, isPathInside } from "./assetPaths";
-export { AUDIO_GROUP_RENDER_ID_ATTR, MEDIA_RENDER_ID_ATTR, assignMediaRenderIds, } from "./mediaRenderIds";
-export { ensureExternalScriptTag } from "./externalScripts";
-export { emitMountedModuleScripts } from "./importMaps";
+export { resolveTimings, type WordTiming, type ElementAnchor, type AuthoredTiming, type ResolvedTiming, type ResolveTimingsInput, type ResolveTimingsResult, } from "./timingResolver.js";
+export { compileTimingAttrs, injectDurations, extractResolvedMedia, clampDurations, shouldClampMediaDuration, shouldClampResolvedMediaDuration, type UnresolvedElement, type ResolvedDuration, type ResolvedMediaElement, type CompilationResult, } from "./timingCompiler.js";
+export { compileHtml, type MediaDurationProber } from "./htmlCompiler.js";
+export { assignBundledRuntimeCompositionIds, type BundledHostCompositionIdentity, bundleToSingleHtml, type BundleOptions, type BundleScriptProvenance, prepareFlattenedInnerRoot, FLATTENED_INNER_ROOT_STRIP_ATTRS, emitRootCompositionVariableStyles, parsesAsScript, } from "./htmlBundler.js";
+export { readDeclaredDefaults, parseHostVariableValues } from "../runtime/getVariables.js";
+export { extractCompiledHtmlParityContract, type CompiledHtmlParityContract, type HtmlParityComposition, type HtmlParityResource, type HtmlParityTimedElement, } from "./htmlParityContract.js";
+export { RUNTIME_BOOTSTRAP_ATTR, injectScriptsAtHeadStart, injectTagsAtHeadStart, injectScriptsIntoHtml, insertBeforeCloseTag, insertRuntimeTag, isRuntimeFileUrl, parseHTMLContent, stripEmbeddedRuntimeScripts, } from "./htmlDocument.js";
+export { addScenePartsManifest } from "./scenePartsManifest.js";
+export { AFTER_FONTS_SCRIPT_TYPE, compositionStyle, cssStyleMergeKey, deferScriptsUntilFonts, headStyleRuns, inlineScriptRuns, styleElementsFor, type CompositionStyle, type InlineScriptRun, } from "./scriptRuns.js";
+export { isJavaScriptType } from "./compositionAssembly.js";
+export { validateHyperframeHtmlContract, type HyperframeStaticFailureReason, type HyperframeStaticGuardResult, } from "./staticGuard.js";
+export { buildVariablesByCompScript, scopeCssToComposition, wrapScopedCompositionScript, } from "./compositionScoping.js";
+export { ensureExternalLinkTag, inlineSubCompositions, type InlineSubCompositionsOptions, type InlineSubCompositionsResult, } from "./inlineSubCompositions.js";
+export { extractStandaloneEntryFromIndex, isTemplateEntry } from "./standaloneEntry.js";
+export { checkSubCompositionUsability, type ParsableDocumentLike, type SubCompositionValidity, type SubCompositionValidityReason, } from "./subCompositionValidity.js";
+export { CSS_URL_RE, PATH_ATTRS, isNonRelativeUrl, isPathInside } from "./assetPaths.js";
+export { AUDIO_GROUP_RENDER_ID_ATTR, MEDIA_RENDER_ID_ATTR, assignMediaRenderIds, } from "./mediaRenderIds.js";
+export { ensureExternalScriptTag } from "./externalScripts.js";
+export { emitMountedModuleScripts } from "./importMaps.js";

package/dist/compiler/inlineSubCompositions.d.ts

@@ -1,6 +1,6 @@
-import { type ExternalScriptAttributes } from "./externalScripts";
-import { type ImportMap } from "./importMaps";
-import { type CompositionStyle } from "./scriptRuns";
+import { type ExternalScriptAttributes } from "./externalScripts.js";
+import { type ImportMap } from "./importMaps.js";
+import { type CompositionStyle } from "./scriptRuns.js";
 /**
  * Shared sub-composition inlining logic.
  *
@@ -10,7 +10,7 @@ import { type CompositionStyle } from "./scriptRuns";
  * divergence that previously caused bugs (e.g. producer not setting
  * `data-composition-file`).
  */
-import { type AssetExists } from "./rewriteSubCompPaths";
+import { type AssetExists } from "./rewriteSubCompPaths.js";
 /** Marks each scene whose nodes a script outside it names by selector, id or class: a swap would strand it. */
 export declare function refuseSwapsReachedByRootScripts(document: Document, rootScripts: string[]): void;
 export interface InlineSubCompositionsOptions {

package/dist/compiler/svgIdNamespacing.d.ts

@@ -5,7 +5,7 @@
  * keeps the authored id (otherwise the first element does). Renamed elements retain
  * data-hf-authored-id for script lookup compatibility.
  */
-import { type SvgReferenceAlias } from "./svgSelectorAliases";
+import { type SvgReferenceAlias } from "./svgSelectorAliases.js";
 /** Reused from `compositionScoping.ts`'s `AUTHORED_ROOT_ID_ATTR` in spirit —
  *  same purpose (let a renamed id still resolve by its authored name), now
  *  generalized from "the composition root" to any renamed descendant. */

package/dist/figma/assetSnippet.d.ts

@@ -1,2 +1,2 @@
-import type { AssetSnippet, FigmaManifestRecord } from "./types";
+import type { AssetSnippet, FigmaManifestRecord } from "./types.js";
 export declare function buildAssetSnippet(record: FigmaManifestRecord): AssetSnippet;

package/dist/figma/client.d.ts

@@ -1,4 +1,4 @@
-import type { FigmaAssetFormat, FigmaRef } from "./types";
+import type { FigmaAssetFormat, FigmaRef } from "./types.js";
 /** Typed capability/transport failures per design spec §4.4. */
 export type FigmaClientErrorCode = "NO_TOKEN" | "BAD_TOKEN" | "FORBIDDEN" | "REQUIRES_ENTERPRISE" | "RATE_LIMITED" | "RENDER_FAILED" | "NODE_NOT_FOUND" | "HTTP_ERROR";
 export declare class FigmaClientError extends Error {

package/dist/figma/emitTimelineScript.d.ts

@@ -1,2 +1,2 @@
-import type { TimelineSpec } from "./types";
+import type { TimelineSpec } from "./types.js";
 export declare function emitTimelineScript(spec: TimelineSpec): string;

package/dist/figma/index.d.ts

@@ -1,22 +1,22 @@
-export type * from "./types";
-export { createFigmaClient, FigmaClientError } from "./client";
-export type { FigmaClient, FigmaClientErrorCode, FigmaClientOptions, FigmaFetch, FigmaFileVersion, FigmaNodeDocument, FigmaStyleMeta, FigmaVariablePayload, FigmaVariablesResult, RenderedNode, RenderNodeOptions, } from "./client";
-export { parseFigmaRef } from "./parseFigmaRef";
-export { MAX_FREEZE_BYTES, exceedsFreezeCap, freezeBytes, freezeUrl, freezeLocalFile, } from "./freeze";
-export { mediaDir, manifestPath, typeDirPath, updateRecord, isFigmaManifestRecord, readManifest, appendRecord, findAllByFigmaNode, findByFigmaNode, nextId, } from "./manifest";
-export { regenerateIndex } from "./mediaIndex";
-export { buildAssetSnippet } from "./assetSnippet";
-export { sanitizeSvg } from "./sanitizeSvg";
-export { appendBinding, upsertBindings, findBindingByFigmaId, readBindings, readLibraryMap, recordLibraryFile, } from "./bindings";
-export type { FigmaBindingRecord } from "./bindings";
-export { figmaColorToCss } from "./color";
-export { resolveBindings } from "./resolveBindings";
-export type { BindingSite, ResolvedBindingSite, ResolveBindingsResult } from "./resolveBindings";
-export { nodeToHtml, slugify } from "./nodeToHtml";
-export type { NodeToHtmlResult, RasterizeRequest } from "./nodeToHtml";
-export { tokensToVariables } from "./tokensToVariables";
-export type { CompositionVariableEntry, FigmaTokenSidecarEntry, FigmaTokensSidecar, TokenSource, TokensToVariablesResult, } from "./tokensToVariables";
-export { mapEase } from "./motionEase";
-export { motionContextToDocs, type MotionContextResponse, type MotionContextNode, type MotionContextToDocsOptions, } from "./motionContextToDocs";
-export { motionToGsap } from "./motionToGsap";
-export { emitTimelineScript } from "./emitTimelineScript";
+export type * from "./types.js";
+export { createFigmaClient, FigmaClientError } from "./client.js";
+export type { FigmaClient, FigmaClientErrorCode, FigmaClientOptions, FigmaFetch, FigmaFileVersion, FigmaNodeDocument, FigmaStyleMeta, FigmaVariablePayload, FigmaVariablesResult, RenderedNode, RenderNodeOptions, } from "./client.js";
+export { parseFigmaRef } from "./parseFigmaRef.js";
+export { MAX_FREEZE_BYTES, exceedsFreezeCap, freezeBytes, freezeUrl, freezeLocalFile, } from "./freeze.js";
+export { mediaDir, manifestPath, typeDirPath, updateRecord, isFigmaManifestRecord, readManifest, appendRecord, findAllByFigmaNode, findByFigmaNode, nextId, } from "./manifest.js";
+export { regenerateIndex } from "./mediaIndex.js";
+export { buildAssetSnippet } from "./assetSnippet.js";
+export { sanitizeSvg } from "./sanitizeSvg.js";
+export { appendBinding, upsertBindings, findBindingByFigmaId, readBindings, readLibraryMap, recordLibraryFile, } from "./bindings.js";
+export type { FigmaBindingRecord } from "./bindings.js";
+export { figmaColorToCss } from "./color.js";
+export { resolveBindings } from "./resolveBindings.js";
+export type { BindingSite, ResolvedBindingSite, ResolveBindingsResult } from "./resolveBindings.js";
+export { nodeToHtml, slugify } from "./nodeToHtml.js";
+export type { NodeToHtmlResult, RasterizeRequest } from "./nodeToHtml.js";
+export { tokensToVariables } from "./tokensToVariables.js";
+export type { CompositionVariableEntry, FigmaTokenSidecarEntry, FigmaTokensSidecar, TokenSource, TokensToVariablesResult, } from "./tokensToVariables.js";
+export { mapEase } from "./motionEase.js";
+export { motionContextToDocs, type MotionContextResponse, type MotionContextNode, type MotionContextToDocsOptions, } from "./motionContextToDocs.js";
+export { motionToGsap } from "./motionToGsap.js";
+export { emitTimelineScript } from "./emitTimelineScript.js";

package/dist/figma/manifest.d.ts

@@ -1,4 +1,4 @@
-import type { FigmaManifestRecord } from "./types";
+import type { FigmaManifestRecord } from "./types.js";
 export declare function mediaDir(projectDir: string): string;
 export declare function manifestPath(projectDir: string): string;
 export declare function typeDirPath(projectDir: string, type: FigmaManifestRecord["type"]): string;

package/dist/figma/motionContextToDocs.d.ts

@@ -20,7 +20,7 @@
  * Verification is still mandatory: render and compare against
  * `export_video` ground truth with skills/figma/scripts/verify-motion.mjs.
  */
-import type { MotionDoc } from "./types";
+import type { MotionDoc } from "./types.js";
 export interface MotionContextNode {
     nodeId: string;
     nodeName: string;

package/dist/figma/motionEase.d.ts

@@ -1,2 +1,2 @@
-import type { MappedEase, MotionEase } from "./types";
+import type { MappedEase, MotionEase } from "./types.js";
 export declare function mapEase(ease: MotionEase): MappedEase;

package/dist/figma/motionToGsap.d.ts

@@ -1,2 +1,2 @@
-import type { MotionDoc, TimelineSpec } from "./types";
+import type { MotionDoc, TimelineSpec } from "./types.js";
 export declare function motionToGsap(doc: MotionDoc): TimelineSpec;

package/dist/figma/nodeDocument.d.ts

@@ -1,3 +1,3 @@
-import type { FigmaNodeDocument } from "./client";
+import type { FigmaNodeDocument } from "./client.js";
 /** Typed children of a node document (unknown-shaped entries skipped). */
 export declare function childDocuments(node: FigmaNodeDocument): FigmaNodeDocument[];

package/dist/figma/nodeToHtml.d.ts

@@ -18,8 +18,8 @@
  * - visible:false nodes and fills are skipped — figma's own renderer
  *   semantics, not ours.
  */
-import type { FigmaNodeDocument } from "./client";
-import type { ResolveBindingsResult } from "./resolveBindings";
+import type { FigmaNodeDocument } from "./client.js";
+import type { ResolveBindingsResult } from "./resolveBindings.js";
 export interface RasterizeRequest {
     nodeId: string;
     name: string;
@@ -29,7 +29,7 @@ export interface NodeToHtmlResult {
     html: string;
     rasterize: RasterizeRequest[];
 }
-export { slugify } from "../tokenSlug";
+export { slugify } from "../tokenSlug.js";
 export interface NodeToHtmlOptions {
     /** override for the ROOT element's slug/id — variant frames are often all
      * named "Platform=Desktop", so the caller's --name must reach the DOM id,

package/dist/figma/parseFigmaRef.d.ts

@@ -1,2 +1,2 @@
-import type { FigmaRef } from "./types";
+import type { FigmaRef } from "./types.js";
 export declare function parseFigmaRef(input: string): FigmaRef;

package/dist/figma/resolveBindings.d.ts

@@ -12,8 +12,8 @@
  * and arrays of alias objects both count; unknown shapes are ignored rather
  * than guessed at.
  */
-import type { FigmaBindingRecord } from "./bindings";
-import type { FigmaNodeDocument } from "./client";
+import type { FigmaBindingRecord } from "./bindings.js";
+import type { FigmaNodeDocument } from "./client.js";
 export interface BindingSite {
     nodeId: string;
     /** boundVariables property ("fills") or style slot prefixed "style:" ("style:text") */

package/dist/figma/tokensToVariables.d.ts

@@ -6,8 +6,8 @@
  * value (cycle-safe) but the binding records the semantic id the designer
  * bound, so a swapped primitive doesn't orphan the link.
  */
-import type { FigmaVariablesResult } from "./client";
-import type { FigmaBindingRecord } from "./bindings";
+import type { FigmaVariablesResult } from "./client.js";
+import type { FigmaBindingRecord } from "./bindings.js";
 /** data-composition-variables entry (runtime getVariables contract). */
 export interface CompositionVariableEntry {
     id: string;

package/dist/generators/hyperframes.d.ts

@@ -1,4 +1,4 @@
-import type { TimelineElement, CanvasResolution, Keyframe, StageZoomKeyframe } from "../core.types";
+import type { TimelineElement, CanvasResolution, Keyframe, StageZoomKeyframe } from "../core.types.js";
 import type { GsapAnimation } from "@hyperframes/parsers";
 export interface SerializeOptions {
     /** Trusted animations: __raw: values are emitted as executable JavaScript. */

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";