@hyperframes/parsers 0.8.172 → 0.8.174

package/dist/colorGradingContract.d.ts

@@ -2,6 +2,7 @@ declare const COLOR_GRADING_CONTRACT_VERSION = 2;
 declare const COLOR_GRADING_COLOR_SPACE = "rec709";
 declare const COLOR_GRADING_MAX_CURVE_POINTS = 16;
 declare const COLOR_GRADING_MAX_SECONDARIES = 4;
+declare const COLOR_GRADING_SOURCE_TAGS: readonly ["video", "img", "canvas"];
 declare const COLOR_GRADING_ADVANCED_LIMITS: {
     readonly hueDegrees: {
         readonly min: 0;
@@ -54,6 +55,16 @@ declare const COLOR_GRADING_ADVANCED_LIMITS: {
 };
 declare const COLOR_GRADING_TOP_LEVEL_KEYS: readonly ["enabled", "preset", "intensity", "adjust", "wheels", "curves", "hueCurves", "secondaries", "details", "effects", "palette", "lut", "colorSpace"];
 declare const COLOR_GRADING_ADJUST_KEYS: readonly ["exposure", "contrast", "highlights", "shadows", "whites", "blacks", "temperature", "tint", "vibrance", "saturation"];
+declare const COLOR_GRADING_EXAMPLE: {
+    readonly adjust: {
+        readonly exposure: 0.1;
+        readonly contrast: 0.05;
+        readonly temperature: 0.08;
+    };
+    readonly details: {
+        readonly vignette: 0.15;
+    };
+};
 declare const COLOR_GRADING_WHEEL_KEYS: readonly ["shadows", "midtones", "highlights"];
 declare const COLOR_GRADING_CURVE_KEYS: readonly ["master", "red", "green", "blue"];
 declare const COLOR_GRADING_HUE_CURVE_KEYS: readonly ["hueVsHue", "hueVsSaturation", "hueVsLuma"];
@@ -69,4 +80,4 @@ declare function isColorGradingVariableRef(value: unknown): value is string;
 /** Browser-safe structural validation shared by Lint, CLI, and Core consumers. */
 declare function validateColorGradingContract(value: unknown): ColorGradingContractIssue[];
 
-export { 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, type ColorGradingContractIssue, isColorGradingVariableRef, validateColorGradingContract };
+export { 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_EXAMPLE, 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, type ColorGradingContractIssue, isColorGradingVariableRef, validateColorGradingContract };

package/dist/colorGradingContract.js

@@ -3,6 +3,7 @@ var COLOR_GRADING_CONTRACT_VERSION = 2;
 var COLOR_GRADING_COLOR_SPACE = "rec709";
 var COLOR_GRADING_MAX_CURVE_POINTS = 16;
 var COLOR_GRADING_MAX_SECONDARIES = 4;
+var COLOR_GRADING_SOURCE_TAGS = ["video", "img", "canvas"];
 var COLOR_GRADING_ADVANCED_LIMITS = {
   hueDegrees: { min: 0, max: 360, inclusiveMax: false },
   unit: { min: 0, max: 1 },
@@ -46,6 +47,10 @@ var COLOR_GRADING_ADJUST_KEYS = [
   "vibrance",
   "saturation"
 ];
+var COLOR_GRADING_EXAMPLE = {
+  adjust: { exposure: 0.1, contrast: 0.05, temperature: 0.08 },
+  details: { vignette: 0.15 }
+};
 var COLOR_GRADING_WHEEL_KEYS = ["shadows", "midtones", "highlights"];
 var COLOR_GRADING_CURVE_KEYS = ["master", "red", "green", "blue"];
 var COLOR_GRADING_HUE_CURVE_KEYS = ["hueVsHue", "hueVsSaturation", "hueVsLuma"];
@@ -163,7 +168,7 @@ function unknownKeysHint(path, unknown) {
       )
     )
   );
-  return sections.size === 1 ? `Move those controls under "${[...sections][0]}".` : "Use only the documented media-treatment keys at the top level.";
+  return sections.size === 1 ? `Move those controls under "${[...sections][0]}".` : `Top-level keys are ${COLOR_GRADING_TOP_LEVEL_KEYS.map((key) => `"${key}"`).join(", ")}.`;
 }
 function validateObject(value, path, keys, issues) {
   if (isColorGradingVariableRef(value)) return null;
@@ -492,10 +497,12 @@ export {
   COLOR_GRADING_CURVE_KEYS,
   COLOR_GRADING_DETAIL_KEYS,
   COLOR_GRADING_EFFECT_KEYS,
+  COLOR_GRADING_EXAMPLE,
   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,
   isColorGradingVariableRef,

package/dist/timeSpans.d.ts

@@ -0,0 +1,9 @@
+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. */
+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. */
+declare function spansOverlap(aStart: number, aEnd: number, bStart: number, bEnd: number): boolean;
+declare function spansShareTime(aStart: number, aEnd: number, bStart: number, bEnd: number): boolean;
+declare const isInsideSpan: (time: number, start: number, end: number) => boolean;
+
+export { instantTolerance, isInsideSpan, sameInstant, spansOverlap, spansShareTime };

package/dist/timeSpans.js

@@ -0,0 +1,21 @@
+// src/timeSpans.ts
+var instantTolerance = (time) => 4 * Number.EPSILON * Math.max(1, Math.abs(time));
+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)));
+}
+var isBefore = (a, b) => a < b && !sameInstant(a, b);
+function spansOverlap(aStart, aEnd, bStart, bEnd) {
+  return isBefore(aStart, bEnd) && isBefore(bStart, aEnd);
+}
+function spansShareTime(aStart, aEnd, bStart, bEnd) {
+  return isBefore(Math.max(aStart, bStart), Math.min(aEnd, bEnd));
+}
+var isInsideSpan = (time, start, end) => isBefore(start, time) && isBefore(time, end);
+export {
+  instantTolerance,
+  isInsideSpan,
+  sameInstant,
+  spansOverlap,
+  spansShareTime
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.8.172",
+  "version": "0.8.174",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -96,6 +96,10 @@
       "import": "./dist/htmlAttributeSpans.js",
       "types": "./dist/htmlAttributeSpans.d.ts"
     },
+    "./time-spans": {
+      "import": "./dist/timeSpans.js",
+      "types": "./dist/timeSpans.d.ts"
+    },
     "./composition-duration": {
       "import": "./dist/compositionDuration.js",
       "types": "./dist/compositionDuration.d.ts"
@@ -119,7 +123,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.11",
-    "@hyperframes/core": "0.8.172"
+    "@hyperframes/core": "0.8.174"
   },
   "scripts": {
     "build": "tsup",