@hyperframes/core 0.8.30 → 0.8.32

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

@@ -1,5 +1,7 @@
 export declare const MEDIA_VISUAL_STYLE_PROPERTIES: readonly ["width", "height", "top", "left", "right", "bottom", "inset", "object-fit", "object-position", "z-index", "opacity", "visibility", "filter", "mix-blend-mode", "backdrop-filter", "border-radius", "overflow", "clip-path", "mask", "mask-image", "mask-size", "mask-position", "mask-repeat", "transform", "transform-origin", "translate", "rotate", "scale", "box-sizing"];
 export type MediaVisualStyleProperty = (typeof MEDIA_VISUAL_STYLE_PROPERTIES)[number];
 export declare function quantizeTimeToFrame(timeSeconds: number, fps: number): number;
+/** Snap decimal noise near a frame boundary without moving genuinely fractional timing. */
+export declare function snapTimeToFrameBoundary(timeSeconds: number, fps: number): number;
 export declare function copyMediaVisualStyles(targetStyle: CSSStyleDeclaration, sourceStyle: CSSStyleDeclaration, properties?: readonly string[]): void;
 //# sourceMappingURL=parityContract.d.ts.map

package/dist/inline-scripts/parityContract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parityContract.d.ts","sourceRoot":"","sources":["../../src/inline-scripts/parityContract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,yXA8BhC,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,mBAAmB,EAChC,WAAW,EAAE,mBAAmB,EAChC,UAAU,GAAE,SAAS,MAAM,EAAkC,GAC5D,IAAI,CAON"}
+{"version":3,"file":"parityContract.d.ts","sourceRoot":"","sources":["../../src/inline-scripts/parityContract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,yXA8BhC,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAItF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQhF;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,mBAAmB,EAChC,WAAW,EAAE,mBAAmB,EAChC,UAAU,GAAE,SAAS,MAAM,EAAkC,GAC5D,IAAI,CAON"}

package/dist/inline-scripts/parityContract.js

@@ -29,12 +29,23 @@ export const MEDIA_VISUAL_STYLE_PROPERTIES = [
     "scale",
     "box-sizing",
 ];
+const FRAME_BOUNDARY_EPSILON = 1e-3;
 export function quantizeTimeToFrame(timeSeconds, fps) {
     const safeFps = Number.isFinite(fps) && fps > 0 ? fps : 30;
     const safeTime = Number.isFinite(timeSeconds) && timeSeconds > 0 ? timeSeconds : 0;
     const frameIndex = Math.floor(safeTime * safeFps + 1e-9);
     return frameIndex / safeFps;
 }
+/** Snap decimal noise near a frame boundary without moving genuinely fractional timing. */
+export function snapTimeToFrameBoundary(timeSeconds, fps) {
+    const safeFps = Number.isFinite(fps) && fps > 0 ? fps : 30;
+    const safeTime = Number.isFinite(timeSeconds) && timeSeconds > 0 ? timeSeconds : 0;
+    const framePosition = safeTime * safeFps;
+    const nearestFrame = Math.round(framePosition);
+    return Math.abs(framePosition - nearestFrame) <= FRAME_BOUNDARY_EPSILON
+        ? nearestFrame / safeFps
+        : safeTime;
+}
 export function copyMediaVisualStyles(targetStyle, sourceStyle, properties = MEDIA_VISUAL_STYLE_PROPERTIES) {
     for (const property of properties) {
         const value = sourceStyle.getPropertyValue(property);

package/dist/inline-scripts/parityContract.js.map

@@ -1 +1 @@
-{"version":3,"file":"parityContract.js","sourceRoot":"","sources":["../../src/inline-scripts/parityContract.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,OAAO;IACP,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,iBAAiB;IACjB,SAAS;IACT,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,UAAU;IACV,WAAW;IACX,MAAM;IACN,YAAY;IACZ,WAAW;IACX,eAAe;IACf,aAAa;IACb,WAAW;IACX,kBAAkB;IAClB,WAAW;IACX,QAAQ;IACR,OAAO;IACP,YAAY;CACJ,CAAC;AAIX,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,GAAW;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACzD,OAAO,UAAU,GAAG,OAAO,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAAgC,EAChC,WAAgC,EAChC,aAAgC,6BAA6B;IAE7D,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,WAAW,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"parityContract.js","sourceRoot":"","sources":["../../src/inline-scripts/parityContract.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,OAAO;IACP,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,iBAAiB;IACjB,SAAS;IACT,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,UAAU;IACV,WAAW;IACX,MAAM;IACN,YAAY;IACZ,WAAW;IACX,eAAe;IACf,aAAa;IACb,WAAW;IACX,kBAAkB;IAClB,WAAW;IACX,QAAQ;IACR,OAAO;IACP,YAAY;CACJ,CAAC;AAIX,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,GAAW;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACzD,OAAO,UAAU,GAAG,OAAO,CAAC;AAC9B,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,GAAW;IACtE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,YAAY,CAAC,IAAI,sBAAsB;QACrE,CAAC,CAAC,YAAY,GAAG,OAAO;QACxB,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAAgC,EAChC,WAAgC,EAChC,aAAgC,6BAA6B;IAE7D,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,WAAW,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/mediaTiming.d.ts

@@ -0,0 +1,12 @@
+export declare const MEDIA_START_BASIS_ATTR = "data-hf-media-start-basis";
+export type MediaStartBasis = "local" | "global";
+export declare function readMediaStartBasis(value: string | null | undefined): MediaStartBasis;
+/** Resolve authored media time onto the root timeline. Nested media is local
+ * by default; only an explicit compatibility marker preserves a legacy
+ * root-global value. */
+export declare function resolveAbsoluteMediaStartSeconds(input: {
+    authoredStart: number;
+    hostStart: number;
+    basis?: string | null;
+}): number;
+//# sourceMappingURL=mediaTiming.d.ts.map

package/dist/mediaTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaTiming.d.ts","sourceRoot":"","sources":["../src/mediaTiming.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,CAErF;AAED;;wBAEwB;AACxB,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,MAAM,CAIT"}

package/dist/mediaTiming.js

@@ -0,0 +1,13 @@
+export const MEDIA_START_BASIS_ATTR = "data-hf-media-start-basis";
+export function readMediaStartBasis(value) {
+    return value?.trim().toLowerCase() === "global" ? "global" : "local";
+}
+/** Resolve authored media time onto the root timeline. Nested media is local
+ * by default; only an explicit compatibility marker preserves a legacy
+ * root-global value. */
+export function resolveAbsoluteMediaStartSeconds(input) {
+    return readMediaStartBasis(input.basis) === "global"
+        ? input.authoredStart
+        : input.hostStart + input.authoredStart;
+}
+//# sourceMappingURL=mediaTiming.js.map

package/dist/mediaTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaTiming.js","sourceRoot":"","sources":["../src/mediaTiming.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAIlE,MAAM,UAAU,mBAAmB,CAAC,KAAgC;IAClE,OAAO,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AACvE,CAAC;AAED;;wBAEwB;AACxB,MAAM,UAAU,gCAAgC,CAAC,KAIhD;IACC,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ;QAClD,CAAC,CAAC,KAAK,CAAC,aAAa;QACrB,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.30",
+  "version": "0.8.32",
   "description": "",
   "repository": {
     "type": "git",
@@ -50,6 +50,10 @@
       "import": "./dist/compositionContract.js",
       "types": "./dist/compositionContract.d.ts"
     },
+    "./media-timing": {
+      "import": "./dist/mediaTiming.js",
+      "types": "./dist/mediaTiming.d.ts"
+    },
     "./editing": {
       "import": "./dist/editing/affordances.js",
       "types": "./dist/editing/affordances.d.ts"
@@ -278,9 +282,9 @@
     "bpm-detective": "^2.0.5",
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
-    "@hyperframes/lint": "0.8.30",
-    "@hyperframes/studio-server": "0.8.30",
-    "@hyperframes/parsers": "0.8.30"
+    "@hyperframes/studio-server": "0.8.32",
+    "@hyperframes/lint": "0.8.32",
+    "@hyperframes/parsers": "0.8.32"
   },
   "devDependencies": {
     "@types/jsdom": "^28.0.0",