@hyperframes/core 0.8.190 → 0.8.192

package/dist/motionBlurSettings.d.ts

@@ -0,0 +1,34 @@
+/** The attributes that configure motion blur on a composition root: names, ranges, defaults, parsing. */
+export declare const MOTION_BLUR_ATTR: {
+    readonly enable: "data-motion-blur";
+    readonly shutter: "data-motion-blur-shutter";
+    readonly samples: "data-motion-blur-samples";
+    readonly events: "data-motion-blur-events";
+    readonly tier: "data-motion-blur-tier";
+};
+export declare const MOTION_BLUR_LIMITS: {
+    readonly shutterDeg: {
+        readonly min: 0;
+        readonly max: 720;
+        readonly default: 240;
+    };
+    readonly samples: {
+        readonly min: 2;
+        readonly max: 64;
+    };
+};
+export type MotionBlurTier = "auto" | "capture" | "filter";
+export interface MotionBlurSettings {
+    enabled: boolean;
+    shutterDeg: number;
+    /** A fixed count per frame; null sizes it to each smear, never under 32. */
+    samples: number | null;
+    events: boolean;
+    tier: MotionBlurTier;
+}
+export declare function readMotionBlurSettings(attr: (name: string) => string | null): MotionBlurSettings;
+/**
+ * The attribute writes that make `settings` true on a root: a value to set, or null to remove.
+ * A setting at its default is removed, so a root carries only what the author changed.
+ */
+export declare function motionBlurAttributeEdits(settings: MotionBlurSettings): Record<string, string | null>;

package/dist/motionBlurSettings.js

@@ -0,0 +1,46 @@
+/** The attributes that configure motion blur on a composition root: names, ranges, defaults, parsing. */
+export const MOTION_BLUR_ATTR = {
+    enable: "data-motion-blur",
+    shutter: "data-motion-blur-shutter",
+    samples: "data-motion-blur-samples",
+    events: "data-motion-blur-events",
+    tier: "data-motion-blur-tier",
+};
+export const MOTION_BLUR_LIMITS = {
+    shutterDeg: { min: 0, max: 720, default: 240 },
+    samples: { min: 2, max: 64 },
+};
+const clamp = (x, lo, hi) => Math.min(hi, Math.max(lo, x));
+function number(value) {
+    if (value === null || value.trim() === "")
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+export function readMotionBlurSettings(attr) {
+    const shutter = number(attr(MOTION_BLUR_ATTR.shutter));
+    const samples = number(attr(MOTION_BLUR_ATTR.samples));
+    const tier = attr(MOTION_BLUR_ATTR.tier);
+    const { shutterDeg, samples: bounds } = MOTION_BLUR_LIMITS;
+    return {
+        enabled: attr(MOTION_BLUR_ATTR.enable) === "on",
+        shutterDeg: clamp(shutter ?? shutterDeg.default, shutterDeg.min, shutterDeg.max),
+        samples: samples === null ? null : Math.round(clamp(samples, bounds.min, bounds.max)),
+        events: attr(MOTION_BLUR_ATTR.events) === "on",
+        tier: tier === "capture" || tier === "filter" ? tier : "auto",
+    };
+}
+/**
+ * The attribute writes that make `settings` true on a root: a value to set, or null to remove.
+ * A setting at its default is removed, so a root carries only what the author changed.
+ */
+export function motionBlurAttributeEdits(settings) {
+    const { shutterDeg } = MOTION_BLUR_LIMITS;
+    return {
+        [MOTION_BLUR_ATTR.enable]: settings.enabled ? "on" : null,
+        [MOTION_BLUR_ATTR.shutter]: settings.shutterDeg === shutterDeg.default ? null : String(settings.shutterDeg),
+        [MOTION_BLUR_ATTR.samples]: settings.samples === null ? null : String(settings.samples),
+        [MOTION_BLUR_ATTR.events]: settings.events ? "on" : null,
+        [MOTION_BLUR_ATTR.tier]: settings.tier === "auto" ? null : settings.tier,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.190",
+  "version": "0.8.192",
   "description": "",
   "repository": {
     "type": "git",
@@ -88,6 +88,10 @@
       "import": "./dist/htmlInCanvas.js",
       "types": "./dist/htmlInCanvas.d.ts"
     },
+    "./motion-blur-settings": {
+      "import": "./dist/motionBlurSettings.js",
+      "types": "./dist/motionBlurSettings.d.ts"
+    },
     "./gsap-cdn": {
       "import": "./dist/gsapCdn.js",
       "types": "./dist/gsapCdn.d.ts"
@@ -385,9 +389,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.8.190",
-    "@hyperframes/parsers": "0.8.190",
-    "@hyperframes/studio-server": "0.8.190"
+    "@hyperframes/lint": "0.8.192",
+    "@hyperframes/studio-server": "0.8.192",
+    "@hyperframes/parsers": "0.8.192"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",