@hyperframes/studio-server 0.8.107 → 0.8.109

package/dist/helpers/loudness.d.ts

@@ -0,0 +1,87 @@
+interface AttributeSpan {
+    value: string;
+    valueStart: number;
+    valueEnd: number;
+}
+type MediaTagName = "audio" | "video";
+interface AudioTag {
+    tag: MediaTagName;
+    id: string;
+    src: string;
+    volume: number;
+    mediaStart: number;
+    duration: number | null;
+    playbackRate: number;
+    start: number;
+    end: number;
+    volumeAttribute: AttributeSpan | null;
+}
+interface LoudnessMeasurement {
+    integratedLufs: number;
+    truePeakDbfs: number;
+}
+interface NormalizationTrack extends LoudnessMeasurement {
+    id: string;
+    volume: number;
+}
+interface AudioNormalizationPlan {
+    referenceId: string;
+    targetId: string;
+    referenceLufs: number;
+    targetLufs: number;
+    previousVolume: number;
+    volume: number;
+    gainDb: number;
+    changeDb: number;
+    projectedLufs: number;
+    projectedTruePeakDbfs: number;
+}
+/** Read the authored clips with sound — `<audio>` and audible `<video>` — without reserializing. */
+declare function audioTags(html: string): AudioTag[];
+/** Resolve only a file contained by the project. Remote and traversal sources are not measured. */
+declare function resolveLocalAudioPath(projectDir: string, src: string): string;
+/** Parse FFmpeg's final EBU R128 summary, not its per-window log lines. */
+declare function parseEbur128Summary(stderr: string): LoudnessMeasurement;
+declare function gainDb(volume: number): number;
+/** Calculate the target's absolute authored gain while keeping the reference unchanged. */
+declare function audioNormalizationPlan(referenceTrack: NormalizationTrack, targetTrack: NormalizationTrack): AudioNormalizationPlan;
+/** Patch one authored attribute in place so scripts/styles/comments remain byte-stable. */
+declare function updateAudioVolume(html: string, id: string, volume: number): string;
+/**
+ * FFmpeg arguments that measure exactly the window the composition plays.
+ *
+ * `-ss` / `-t` go BEFORE `-i`, as INPUT options. After `-i` they bound the
+ * output, and with `-f null` there is no real output to bound: ffmpeg keeps
+ * feeding the filter graph past the limit, so ebur128 integrates audio the clip
+ * never plays. Measured on a 12 s file whose first 4 s — the played window — is
+ * -61.8 LUFS: output-side `-t 4` reported -33.8 LUFS, input-side reports -61.8,
+ * the same as physically cutting the file first.
+ */
+declare function loudnessMeasureArgs(file: string, tag: MeasuredWindow): string[];
+type MeasuredWindow = Pick<AudioTag, "mediaStart" | "duration"> & Partial<Pick<AudioTag, "playbackRate">>;
+declare function measureAudio(ffmpegPath: string, file: string, tag: MeasuredWindow): Promise<LoudnessMeasurement>;
+declare function requiredFfmpeg(): string;
+declare const DEFAULT_TARGET_LUFS = -16;
+declare const NORMALIZE_TRUE_PEAK_CEILING_DBFS = -1.5;
+type LoudnessLimit = "gain-ceiling" | "true-peak";
+interface AbsoluteLoudnessPlan {
+    targetId: string;
+    targetLufs: number;
+    sourceLufs: number;
+    previousVolume: number;
+    volume: number;
+    gainDb: number;
+    changeDb: number;
+    projectedLufs: number;
+    projectedTruePeakDbfs: number;
+    limitedBy: LoudnessLimit | null;
+}
+/**
+ * The authored gain that brings one clip's played window to an absolute
+ * loudness. Unlike reference matching it never refuses: past the +12 dB
+ * authoring ceiling or the true-peak ceiling it applies the most that fits and
+ * names which limit stopped it.
+ */
+declare function absoluteLoudnessPlan(track: NormalizationTrack, targetLufs?: number): AbsoluteLoudnessPlan;
+
+export { type AbsoluteLoudnessPlan, type AudioNormalizationPlan, type AudioTag, DEFAULT_TARGET_LUFS, type LoudnessLimit, type LoudnessMeasurement, type MeasuredWindow, NORMALIZE_TRUE_PEAK_CEILING_DBFS, type NormalizationTrack, absoluteLoudnessPlan, audioNormalizationPlan, audioTags, gainDb, loudnessMeasureArgs, measureAudio, parseEbur128Summary, requiredFfmpeg, resolveLocalAudioPath, updateAudioVolume };

package/dist/helpers/loudness.js

@@ -0,0 +1,29 @@
+import {
+  DEFAULT_TARGET_LUFS,
+  NORMALIZE_TRUE_PEAK_CEILING_DBFS,
+  absoluteLoudnessPlan,
+  audioNormalizationPlan,
+  audioTags,
+  gainDb,
+  loudnessMeasureArgs,
+  measureAudio,
+  parseEbur128Summary,
+  requiredFfmpeg,
+  resolveLocalAudioPath,
+  updateAudioVolume
+} from "../chunk-TEYDBVSK.js";
+export {
+  DEFAULT_TARGET_LUFS,
+  NORMALIZE_TRUE_PEAK_CEILING_DBFS,
+  absoluteLoudnessPlan,
+  audioNormalizationPlan,
+  audioTags,
+  gainDb,
+  loudnessMeasureArgs,
+  measureAudio,
+  parseEbur128Summary,
+  requiredFfmpeg,
+  resolveLocalAudioPath,
+  updateAudioVolume
+};
+//# sourceMappingURL=loudness.js.map

package/dist/helpers/loudness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,4 +1,4 @@
-export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-rleU3r_Q.js';
+export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-CCxjB3rf.js';
 import './mediaCodecMap.js';
 import '@hyperframes/core';
 import '@hyperframes/parsers';

package/dist/helpers/sourceMutation.d.ts

@@ -84,5 +84,7 @@ interface UnwrapChildTrack {
     track?: number;
 }
 declare function unwrapElementsFromHtml(source: string, groupTarget: SourceMutationTarget, childTracks?: UnwrapChildTrack[]): UnwrapElementsResult;
+/** After a cut, give each linked group's right halves their own `data-link` and `data-sync-origin`. */
+declare function relinkSplitHalvesInHtml(source: string, rightHalfIds: readonly string[]): string;
 
-export { type ElementRebase, type PatchOperation, type SourceMutationTarget, type SplitElementResult, type UnwrapChildTrack, type UnwrapElementsResult, type WrapElementsResult, dedupeClonedCompositionId, findTargetElement, isHTMLElement, parseSourceDocument, patchElementInHtml, probeElementInSource, removeElementFromHtml, splitElementInHtml, unwrapElementsFromHtml, wrapElementsInHtml };
+export { type ElementRebase, type PatchOperation, type SourceMutationTarget, type SplitElementResult, type UnwrapChildTrack, type UnwrapElementsResult, type WrapElementsResult, dedupeClonedCompositionId, findTargetElement, isHTMLElement, parseSourceDocument, patchElementInHtml, probeElementInSource, relinkSplitHalvesInHtml, removeElementFromHtml, splitElementInHtml, unwrapElementsFromHtml, wrapElementsInHtml };

package/dist/helpers/sourceMutation.js

@@ -5,11 +5,12 @@ import {
   parseSourceDocument,
   patchElementInHtml,
   probeElementInSource,
+  relinkSplitHalvesInHtml,
   removeElementFromHtml,
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "../chunk-W6TFBTP2.js";
+} from "../chunk-Z4DIWF3Z.js";
 export {
   dedupeClonedCompositionId,
   findTargetElement,
@@ -17,6 +18,7 @@ export {
   parseSourceDocument,
   patchElementInHtml,
   probeElementInSource,
+  relinkSplitHalvesInHtml,
   removeElementFromHtml,
   splitElementInHtml,
   unwrapElementsFromHtml,

package/dist/history/index.js

@@ -10,7 +10,7 @@ import {
   listProjectHistories,
   openProjectHistory,
   pruneGoneProjectHistories
-} from "../chunk-KUEG5MYA.js";
+} from "../chunk-EPL4YKGI.js";
 import "../chunk-TTWLTYSQ.js";
 export {
   DEFAULT_HISTORY_ROOT,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-rleU3r_Q.js';
-export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-rleU3r_Q.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-CCxjB3rf.js';
+export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-CCxjB3rf.js';
 export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, S as HISTORY_START, H as HistoryClosedError, a as HistoryEntry, b as HistoryEntrySide, c as HistoryFileChange, d as HistoryListItem, e as HistoryResult, f as HistoryWho, g as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, h as ProjectHistoryOptions, U as UNDO_MODES, i as UndoMode, o as openProjectHistory } from './projectHistory-Cm8Mdmmv.js';
 export { HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, historyCache, listProjectHistories, pruneGoneProjectHistories } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';