@hyperframes/core 0.8.172 → 0.8.174

package/dist/clipFacts.d.ts

@@ -28,11 +28,5 @@ export interface ClipFact {
     role: string | null;
 }
 export declare const byStart: (a: ClipFact, b: ClipFact) => number;
-export declare const instantTolerance: (time: number) => number;
-/** Float sums like 19.8 + 6.4 miss 26.2 by a rounding step; a few steps, scaled to the time, are one instant. */
-export declare function sameInstant(a: number, b: number): boolean;
-/** For timeline lanes: a zero-length clip inside another still counts, so it gets a lane of its own. */
-export declare function spansOverlap(aStart: number, aEnd: number, bStart: number, bEnd: number): boolean;
-export declare function spansShareTime(aStart: number, aEnd: number, bStart: number, bEnd: number): boolean;
-export declare const isInsideSpan: (time: number, start: number, end: number) => boolean;
+export { instantTolerance, isInsideSpan, sameInstant, spansOverlap, spansShareTime, } from "@hyperframes/parsers/time-spans";
 export declare function formatClipLine(clip: ClipFact): string;

package/dist/clipFacts.js

@@ -2,22 +2,7 @@
 export const byStart = (a, b) => a.start - b.start || a.trackIndex - b.trackIndex;
 const roundTo3 = (n) => Math.round(n * 1000) / 1000;
 const num = (n) => String(roundTo3(n));
-export const instantTolerance = (time) => 4 * Number.EPSILON * Math.max(1, Math.abs(time));
-/** Float sums like 19.8 + 6.4 miss 26.2 by a rounding step; a few steps, scaled to the time, are one instant. */
-export function sameInstant(a, b) {
-    if (!Number.isFinite(a) || !Number.isFinite(b))
-        return a === b;
-    return Math.abs(a - b) <= instantTolerance(Math.max(Math.abs(a), Math.abs(b)));
-}
-const isBefore = (a, b) => a < b && !sameInstant(a, b);
-/** For timeline lanes: a zero-length clip inside another still counts, so it gets a lane of its own. */
-export function spansOverlap(aStart, aEnd, bStart, bEnd) {
-    return isBefore(aStart, bEnd) && isBefore(bStart, aEnd);
-}
-export function spansShareTime(aStart, aEnd, bStart, bEnd) {
-    return isBefore(Math.max(aStart, bStart), Math.min(aEnd, bEnd));
-}
-export const isInsideSpan = (time, start, end) => isBefore(start, time) && isBefore(time, end);
+export { instantTolerance, isInsideSpan, sameInstant, spansOverlap, spansShareTime, } from "@hyperframes/parsers/time-spans";
 export function formatClipLine(clip) {
     const parts = [
         `${clip.kind} "${clip.id}"`,

package/dist/colorGrading.d.ts

@@ -13,6 +13,7 @@ export declare const COLOR_GRADING_SOURCE_HIDDEN_ATTR = "data-hf-color-grading-s
 export declare const COLOR_GRADING_AUTHORED_OPACITY_ATTR = "data-hf-authored-opacity";
 export declare const HF_COLOR_GRADING_CANVAS_ID_PREFIX = "__hf_color_grading_";
 export declare const HF_COLOR_GRADING_COLOR_SPACE = "rec709";
+export declare const HF_COLOR_GRADING_SOURCE_TAGS: readonly ["video", "img", "canvas"];
 export type HfColorGradingPresetId = "neutral" | "warm-daylight" | "clean-studio" | "skin-soft" | "food-pop" | "night-lift" | "muted-editorial" | "vintage-wash" | "mono-clean" | "mono-fade" | "soft-boost" | "bright-pop" | "deep-contrast" | "creator-camcorder" | "vhs-playback" | "home-movie-8mm" | "editorial-halftone" | "two-ink-print";
 export type HfColorGradingAdjustKey = (typeof COLOR_GRADING_ADJUST_KEYS)[number];
 export type HfColorGradingAdjust = Partial<Record<HfColorGradingAdjustKey, number>>;
@@ -290,7 +291,17 @@ export declare function getHfColorGradingCapabilities(): {
         label: string;
         intensity: number;
     }[];
-    adjustments: {
+    example: {
+        readonly adjust: {
+            readonly exposure: 0.1;
+            readonly contrast: 0.05;
+            readonly temperature: 0.08;
+        };
+        readonly details: {
+            readonly vignette: 0.15;
+        };
+    };
+    adjust: {
         min: number;
         max: number;
         key: "exposure" | "contrast" | "highlights" | "shadows" | "whites" | "blacks" | "temperature" | "tint" | "vibrance" | "saturation";
@@ -442,7 +453,7 @@ export declare function getHfColorGradingCapabilities(): {
         readonly label: "Art";
         readonly description: "ASCII, engraved, crosshatched, and painterly rendering.";
     }];
-    finishing: {
+    details: {
         min: number;
         max: number;
         key: "vignette" | "vignetteMidpoint" | "vignetteRoundness" | "vignetteFeather" | "grain" | "grainSize" | "grainRoughness";

package/dist/colorGrading.js

@@ -1,5 +1,5 @@
 import { DEFAULT_MAX_CUBE_LUT_SIZE } from "./colorLuts.js";
-import { COLOR_GRADING_ADJUST_KEYS, COLOR_GRADING_ADVANCED_LIMITS, COLOR_GRADING_COLOR_SPACE, COLOR_GRADING_CONTRACT_VERSION, COLOR_GRADING_CURVE_KEYS, COLOR_GRADING_DETAIL_KEYS, COLOR_GRADING_EFFECT_KEYS, COLOR_GRADING_HUE_CURVE_KEYS, COLOR_GRADING_LUT_KEYS, COLOR_GRADING_MAX_CURVE_POINTS, COLOR_GRADING_MAX_SECONDARIES, COLOR_GRADING_TOP_LEVEL_KEYS, COLOR_GRADING_WHEEL_KEYS, } from "@hyperframes/parsers/color-grading-contract";
+import { COLOR_GRADING_ADJUST_KEYS, COLOR_GRADING_EXAMPLE, COLOR_GRADING_ADVANCED_LIMITS, COLOR_GRADING_COLOR_SPACE, COLOR_GRADING_CONTRACT_VERSION, COLOR_GRADING_CURVE_KEYS, COLOR_GRADING_DETAIL_KEYS, COLOR_GRADING_EFFECT_KEYS, COLOR_GRADING_HUE_CURVE_KEYS, COLOR_GRADING_LUT_KEYS, COLOR_GRADING_MAX_CURVE_POINTS, COLOR_GRADING_MAX_SECONDARIES, COLOR_GRADING_SOURCE_TAGS, COLOR_GRADING_TOP_LEVEL_KEYS, COLOR_GRADING_WHEEL_KEYS, } from "@hyperframes/parsers/color-grading-contract";
 export { compileHfColorCurve, compileHfHueCurve, HF_COLOR_CURVE_MAX_POINTS, } from "./colorGradingCurves.js";
 export const HF_COLOR_GRADING_ATTR = "data-color-grading";
 // Runtime <-> studio contract attributes. The runtime grading engine writes
@@ -15,6 +15,7 @@ export const COLOR_GRADING_SOURCE_HIDDEN_ATTR = "data-hf-color-grading-source-hi
 export const COLOR_GRADING_AUTHORED_OPACITY_ATTR = "data-hf-authored-opacity";
 export const HF_COLOR_GRADING_CANVAS_ID_PREFIX = "__hf_color_grading_";
 export const HF_COLOR_GRADING_COLOR_SPACE = COLOR_GRADING_COLOR_SPACE;
+export const HF_COLOR_GRADING_SOURCE_TAGS = COLOR_GRADING_SOURCE_TAGS;
 const ADJUST_ZERO = {
     exposure: 0,
     contrast: 0,
@@ -657,7 +658,8 @@ export function getHfColorGradingCapabilities() {
             label: preset.label,
             intensity: preset.intensity,
         })),
-        adjustments: HF_COLOR_GRADING_ADJUST_KEYS.map((key) => ({
+        example: COLOR_GRADING_EXAMPLE,
+        adjust: HF_COLOR_GRADING_ADJUST_KEYS.map((key) => ({
             key,
             identity: ADJUST_ZERO[key],
             ...ADJUST_LIMITS[key],
@@ -728,7 +730,7 @@ export function getHfColorGradingCapabilities() {
             },
         },
         effectFamilies: EFFECT_FAMILIES,
-        finishing: HF_COLOR_GRADING_DETAIL_KEYS.map((key) => ({
+        details: HF_COLOR_GRADING_DETAIL_KEYS.map((key) => ({
             key,
             identity: DETAIL_DEFAULTS[key],
             ...DETAIL_LIMITS[key],

package/dist/editing/affordances.js

@@ -1,4 +1,5 @@
 import { HF_AUDIO_GROUP_TAG } from "../audioGroups.js";
+import { HF_COLOR_GRADING_SOURCE_TAGS } from "../colorGrading.js";
 /**
  * kebab-case px parser. Single source of truth — studio's domEditingDom
  * re-exports this so the two paths can't drift.
@@ -140,7 +141,7 @@ export function resolveEditingSections(facts) {
         text: facts.hasEditableText && !facts.isCompositionHost && !facts.isInsideLockedComposition,
         media: facts.tag === "video" || facts.tag === "audio" || facts.tag === "img",
         audioFx: facts.tag === "audio" || isAudioBus || (facts.tag === "video" && facts.hasAudio === true),
-        colorGrading: facts.tag === "video" || facts.tag === "img",
+        colorGrading: HF_COLOR_GRADING_SOURCE_TAGS.includes(facts.tag),
         // A bus has no clip range at all — no `data-start`, no duration, and its
         // automation clock is composition time — so Start/Duration/End would be
         // editing nothing. Audio keeps its timing: an `<audio>` clip is placed on