@aelionsdk/render-ir 1.0.0-rc.1 → 1.2.0-rc.1

package/README.md

@@ -1,7 +1,30 @@
-# @aelionsdk/render-ir
+# `@aelionsdk/render-ir`
 
-Incremental render intermediate representation compiler for AelionSDK
+Incremental Project-to-Render-IR compilation and deterministic timeline
+evaluation for AelionSDK.
 
-Install with `npm install @aelionsdk/render-ir@next`.
+## Install
 
-Version 1.0.0-rc.1 is a prerelease and its API may change before the first stable release. This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK); see the repository README for supported browsers, examples and deployment requirements.
+```bash
+npm install @aelionsdk/render-ir@next
+```
+
+`next` currently resolves to `1.2.0-rc.1`. Product applications should use
+`@aelionsdk/sdk`; direct use is for custom renderers, exporters and engine
+instrumentation.
+
+## Public surface
+
+- cold and incremental Project compilation;
+- visual and audio timeline evaluation;
+- captions, text layout and time maps;
+- color and bit-depth contracts;
+- compile statistics and Render IR types.
+
+Preview and export should consume the same validated Render IR rather than
+maintaining separate timeline semantics. Unsupported color or time-map
+combinations fail closed.
+
+See the [render consistency guide](https://foyonaczy.github.io/AelionSDK/concepts/render-consistency/)
+and [API reference](https://foyonaczy.github.io/AelionSDK/api/aelionsdk/render-ir/overview/).
+Licensed under MIT.

package/dist/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAGjB,YAAY,EAOZ,kBAAkB,EAClB,yBAAyB,EACzB,QAAQ,EACT,MAAM,YAAY,CAAC;AAqGpB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,iBAAiB,EAAE,SAAS,EAC1C,cAAc,EAAE,MAAM,EACtB,YAAY,SAAI,uCA6CjB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,iBAAiB,EAAE,SAAS,GAAG,SAAS,EACtD,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,cAAc,EAAE,MAAM,EACtB,YAAY,SAAI,GACf,yBAAyB,CAY3B;AAsBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3F;AAqDD,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,gBAAgB,CA8DlB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CA0DnF"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAGjB,YAAY,EAOZ,kBAAkB,EAClB,yBAAyB,EACzB,QAAQ,EACT,MAAM,YAAY,CAAC;AA6KpB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,iBAAiB,EAAE,SAAS,EAC1C,cAAc,EAAE,MAAM,EACtB,YAAY,SAAI,uCAiDjB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,iBAAiB,EAAE,SAAS,GAAG,SAAS,EACtD,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,cAAc,EAAE,MAAM,EACtB,YAAY,SAAI,GACf,yBAAyB,CAY3B;AAsBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3F;AAqDD,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,gBAAgB,CA8DlB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CA0DnF"}

package/dist/evaluate.js

@@ -73,6 +73,57 @@ function easingProgress(progress, from) {
     }
     return from.interpolation === 'cubic-bezier' ? cubicBezierProgress(progress, easing) : progress;
 }
+function bezierComponent(progress, from, handleOut, handleIn, to) {
+    const inverse = 1 - progress;
+    return (inverse * inverse * inverse * from +
+        3 * inverse * inverse * progress * handleOut +
+        3 * inverse * progress * progress * handleIn +
+        progress * progress * progress * to);
+}
+/**
+ * Interpolate a value between two keyframes using explicit Bézier handles
+ * (`handleOut` on the from keyframe, `handleIn` on the to keyframe). Handles
+ * are value-space tangents: for a scalar value the tangent is the `y`
+ * component (added to the value), and for a `{x,y}` vector both components
+ * are added as the control point offset. Falls back to plain progress-based
+ * interpolation when no handle is present on the from keyframe.
+ */
+function interpolateWithHandles(fromValue, toValue, progress, fromKeyframe, toKeyframe) {
+    const handleOut = objectProperty(Reflect.get(fromKeyframe, 'handleOut'));
+    if (Object.keys(handleOut).length === 0)
+        return interpolateJson(fromValue, toValue, progress);
+    const handleIn = objectProperty(Reflect.get(toKeyframe, 'handleIn'));
+    if (typeof fromValue === 'number' && typeof toValue === 'number') {
+        const outTangent = numberProperty(handleOut.y, 0);
+        const inTangent = numberProperty(handleIn.y, 0);
+        return bezierComponent(progress, fromValue, fromValue + outTangent, toValue + inTangent, toValue);
+    }
+    if (fromValue !== null &&
+        toValue !== null &&
+        typeof fromValue === 'object' &&
+        typeof toValue === 'object' &&
+        !Array.isArray(fromValue) &&
+        !Array.isArray(toValue)) {
+        const outX = numberProperty(handleOut.x, 0);
+        const outY = numberProperty(handleOut.y, 0);
+        const inX = numberProperty(handleIn.x, outX);
+        const inY = numberProperty(handleIn.y, outY);
+        const scalar = (key) => {
+            const fromScalar = fromValue[key];
+            const toScalar = toValue[key];
+            if (typeof fromScalar !== 'number' || typeof toScalar !== 'number')
+                return undefined;
+            const out = key === 'x' ? outX : outY;
+            const inn = key === 'x' ? inX : inY;
+            return bezierComponent(progress, fromScalar, fromScalar + out, toScalar + inn, toScalar);
+        };
+        const x = scalar('x');
+        const y = scalar('y');
+        if (x !== undefined && y !== undefined)
+            return { x, y };
+    }
+    return interpolateJson(fromValue, toValue, progress);
+}
 export function evaluateAnimatedValue(value, sequenceTimeUs, ownerStartUs = 0) {
     if (!isAnimation(value))
         return value;
@@ -115,6 +166,10 @@ export function evaluateAnimatedValue(value, sequenceTimeUs, ownerStartUs = 0) {
         return from.value;
     }
     let progress = (timeUs - from.timeUs) / (to.timeUs - from.timeUs);
+    const hasHandleOut = Reflect.get(from, 'handleOut') !== undefined;
+    if (hasHandleOut) {
+        return interpolateWithHandles(from.value, to.value, progress, from, to);
+    }
     progress = easingProgress(progress, from);
     return interpolateJson(from.value, to.value, progress);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/render-ir",
-  "version": "1.0.0-rc.1",
+  "version": "1.2.0-rc.1",
   "description": "Incremental render intermediate representation compiler for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -27,16 +27,16 @@
     "!dist/.tsbuildinfo"
   ],
   "engines": {
-    "node": ">=20.19"
+    "node": ">=24 <25"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "1.0.0-rc.1",
-    "@aelionsdk/material-compiler": "1.0.0-rc.1",
-    "@aelionsdk/project-schema": "1.0.0-rc.1"
+    "@aelionsdk/core": "1.2.0-rc.1",
+    "@aelionsdk/material-compiler": "1.2.0-rc.1",
+    "@aelionsdk/project-schema": "1.2.0-rc.1"
   },
   "scripts": {
     "build": "tsc -b",