@glissade/scene 0.55.0-pre.0 → 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.0";
+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

@@ -1,4 +1,4 @@
-import { r as DisplayListBuilder } from "./displayList.js";
+import { C as Mat2x3, r as DisplayListBuilder } from "./displayList.js";
 import { B as Node, H as NodeProps, R as EvalContext, U as PropInit, a as Group, l as Path } from "./nodes.js";
 import { BindableSignal, PathValue, Vec2, Vec2Signal } from "@glissade/core";
 
@@ -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
@@ -182,7 +185,10 @@ interface CameraProps extends NodeProps {
  * the PAN by the layer's depth (far layers, depth<1, pan less). `centerRel` is the
  * RELATIVE focal point ([0.5,0.5]=screen center); `roll` is degrees.
  */
-
+declare function cameraLayerMatrix(size: {
+  w: number;
+  h: number;
+}, centerRel: Vec2, zoom: number, roll: number, depth: number): Mat2x3;
 declare class Camera extends Group {
   #private;
   get describeType(): string;
@@ -194,6 +200,9 @@ declare class Camera extends Group {
   readonly roll: BindableSignal<number>;
   /** Resolved layers (content + depth), parallel to `children`. */
   readonly layers: readonly Required<CameraLayer>[];
+  /** The whole-frame shake spec, if any — read by exporters (render-only, so it is
+   *  warned + not baked into Lottie keyframes). */
+  get shakeSpec(): ShakeSpec | undefined;
   constructor(layers: CameraLayer[], props?: CameraProps);
   protected draw(out: DisplayListBuilder, ctx: EvalContext): void;
 }
@@ -207,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, 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);
@@ -196,6 +210,11 @@ var Camera = class extends Group {
 	/** Resolved layers (content + depth), parallel to `children`. */
 	layers;
 	#shake;
+	/** The whole-frame shake spec, if any — read by exporters (render-only, so it is
+	*  warned + not baked into Lottie keyframes). */
+	get shakeSpec() {
+		return this.#shake;
+	}
 	constructor(layers, props = {}) {
 		if (!Array.isArray(layers) || layers.length === 0) throw new CameraError("camera(layers, props?): needs at least one layer — pass [{ content }] (a node per depth plane).");
 		const resolved = layers.map((l, i) => {
@@ -265,4 +284,4 @@ function camera(layers, props = {}) {
 	return new Camera(layers, props);
 }
 //#endregion
-export { Camera, CameraError, FollowPath, LookAt, OrientToPath, camera, 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.0",
+  "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.0"
+    "@glissade/core": "0.55.0-pre.2"
   },
   "repository": {
     "type": "git",