@glissade/scene 0.55.0-pre.1 → 0.55.0-pre.2

package/dist/describe.js

@@ -23,7 +23,7 @@ import { easings, listValueTypes } from "@glissade/core";
 * never pulled onto the base embed path — a scene that never calls `describe()`
 * pays zero bytes for it.
 */
-const RAW_VERSION = "0.55.0-pre.1";
+const RAW_VERSION = "0.55.0-pre.2";
 const PACKAGE_VERSION = RAW_VERSION.includes("GLISSADE_".concat("VERSION")) ? "0.0.0-dev" : RAW_VERSION;
 /**
 * Parse the documented positional-arg count from a helper `usage` string — the

package/dist/motion.d.ts

@@ -123,6 +123,9 @@ interface ShakeSpec {
   /** Noise cycles per second (higher = twitchier); default 8. */
   frequency?: number;
 }
+/** The shake spec applied to `node` via {@link shake}, or undefined — the seam an
+ *  exporter uses to emit an honest "shake is render-only" warn (never a silent drop). */
+declare function shakenSpec(node: Node): ShakeSpec | undefined;
 /**
  * The pure per-time shake offset for a spec: `{ dx, dy }` px + `dr` degrees, each
  * a deterministic function of `(seed, t)`. Both the {@link shake} node driver and
@@ -213,4 +216,4 @@ declare class Camera extends Group {
  */
 declare function camera(layers: CameraLayer[], props?: CameraProps): Camera;
 //#endregion
-export { Camera, CameraError, type CameraLayer, type CameraProps, FollowPath, type FollowPathProps, LookAt, type LookAtProps, OrientToPath, type OrientToPathProps, type PathSampler, type ShakeSpec, camera, cameraLayerMatrix, followPath, lookAt, motionPath, orientToPath, pathLength, pointAtLength, shake, shakeOffset };
+export { Camera, CameraError, type CameraLayer, type CameraProps, FollowPath, type FollowPathProps, LookAt, type LookAtProps, OrientToPath, type OrientToPathProps, type PathSampler, type ShakeSpec, camera, cameraLayerMatrix, followPath, lookAt, motionPath, orientToPath, pathLength, pointAtLength, shake, shakeOffset, shakenSpec };

package/dist/motion.js

@@ -29,6 +29,19 @@ function snoise(seed, t) {
 	return valueNoise(seed, t) * 2 - 1;
 }
 /**
+* Render-INVISIBLE marker: which nodes a {@link shake} driver is applied to, and
+* with what spec. The render path NEVER reads this (shake works purely by wrapping
+* `emit`), so it is byte-neutral for goldens — it exists ONLY so an EXPORTER
+* (which reads signals, not `emit`) can detect the render-only jitter and warn
+* honestly instead of silently dropping it. A WeakMap keeps it off the Node type.
+*/
+const SHAKEN = /* @__PURE__ */ new WeakMap();
+/** The shake spec applied to `node` via {@link shake}, or undefined — the seam an
+*  exporter uses to emit an honest "shake is render-only" warn (never a silent drop). */
+function shakenSpec(node) {
+	return SHAKEN.get(node);
+}
+/**
 * The pure per-time shake offset for a spec: `{ dx, dy }` px + `dr` degrees, each
 * a deterministic function of `(seed, t)`. Both the {@link shake} node driver and
 * the Camera whole-frame shake fold this in.
@@ -89,6 +102,7 @@ function shake(node, spec) {
 	const tr = spec.translate ?? 0;
 	const rot = spec.rotate ?? 0;
 	if (tr === 0 && rot === 0) throw new Error("shake(): pass a nonzero `translate` (px) or `rotate` (deg) amplitude — both are 0/omitted, so nothing would move.");
+	SHAKEN.set(node, spec);
 	const origEmit = node.emit.bind(node);
 	node.emit = (out, ctx) => {
 		const { dx, dy, dr } = shakeOffset(spec, ctx.time);
@@ -270,4 +284,4 @@ function camera(layers, props = {}) {
 	return new Camera(layers, props);
 }
 //#endregion
-export { Camera, CameraError, FollowPath, LookAt, OrientToPath, camera, cameraLayerMatrix, followPath, lookAt, motionPath, orientToPath, pathLength, pointAtLength, shake, shakeOffset };
+export { Camera, CameraError, FollowPath, LookAt, OrientToPath, camera, cameraLayerMatrix, followPath, lookAt, motionPath, orientToPath, pathLength, pointAtLength, shake, shakeOffset, shakenSpec };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.55.0-pre.1",
+  "version": "0.55.0-pre.2",
   "description": "glissade scene graph: nodes, transforms, DisplayList emission. Renderer-agnostic; zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {
@@ -77,7 +77,7 @@
   ],
   "dependencies": {
     "yoga-layout": "^3.2.1",
-    "@glissade/core": "0.55.0-pre.1"
+    "@glissade/core": "0.55.0-pre.2"
   },
   "repository": {
     "type": "git",