reframe-video 0.6.1 → 0.6.2

package/dist/bin.js

@@ -377,6 +377,8 @@ function validateScene(ir) {
       const props = node.props;
       checkPaint(`node "${node.id}" fill`, props.fill);
       checkPaint(`node "${node.id}" stroke`, props.stroke);
+      if (typeof props.blur === "number" && props.blur < 0) problems.push(`node "${node.id}": blur must be >= 0`);
+      if (typeof props.shadowBlur === "number" && props.shadowBlur < 0) problems.push(`node "${node.id}": shadowBlur must be >= 0`);
       if (node.type === "group") {
         const clip = node.props.clip;
         if (clip) {
@@ -591,16 +593,17 @@ function validateComposition(comp) {
   }
   if (problems.length > 0) throw new SceneValidationError(problems);
 }
-var COMMON_PROPS, CAMERA_PROPS, PROPS_BY_TYPE, SceneValidationError, TRANSITIONS;
+var FX_PROPS, COMMON_PROPS, CAMERA_PROPS, PROPS_BY_TYPE, SceneValidationError, TRANSITIONS;
 var init_validate = __esm({
   "../core/src/validate.ts"() {
     "use strict";
-    COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed"];
+    FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY"];
+    COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed", ...FX_PROPS];
     CAMERA_PROPS = ["x", "y", "zoom", "rotation"];
     PROPS_BY_TYPE = {
       rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
       ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
-      line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress"],
+      line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
       text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
       image: [...COMMON_PROPS, "src", "width", "height"],
       path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
@@ -928,6 +931,13 @@ var init_gradient = __esm({
   }
 });
 
+// ../core/src/effects.ts
+var init_effects = __esm({
+  "../core/src/effects.ts"() {
+    "use strict";
+  }
+});
+
 // ../core/src/presets.ts
 function makeRng(seed) {
   let a = seed >>> 0 || 2654435769;
@@ -1385,6 +1395,7 @@ var init_src = __esm({
     init_path();
     init_camera();
     init_gradient();
+    init_effects();
     init_presets();
     init_devicePreset();
     init_cursor();

package/dist/browserEntry.js

@@ -334,11 +334,12 @@
   }
 
   // ../core/src/validate.ts
-  var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed"];
+  var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY"];
+  var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed", ...FX_PROPS];
   var PROPS_BY_TYPE = {
     rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
     ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
-    line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress"],
+    line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
     text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
     image: [...COMMON_PROPS, "src", "width", "height"],
     path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
@@ -679,9 +680,21 @@
       const v = valueAt(target, prop, base ?? "");
       return v === "" && base === void 0 ? void 0 : String(v);
     };
+    const effectFx = (id, p) => {
+      const fx = {};
+      if (p.blur !== void 0) fx.blur = num(id, "blur", p.blur);
+      if (p.shadowColor !== void 0) {
+        fx.shadowColor = str(id, "shadowColor", p.shadowColor);
+        fx.shadowBlur = num(id, "shadowBlur", p.shadowBlur ?? 0);
+        fx.shadowX = num(id, "shadowX", p.shadowX ?? 0);
+        fx.shadowY = num(id, "shadowY", p.shadowY ?? 0);
+      }
+      return fx;
+    };
     const walk = (node, parent, parentOpacity, clips) => {
       const id = node.id;
       const clipSpread = clips.length > 0 ? { clips } : void 0;
+      const fx = effectFx(id, node.props);
       if (node.type === "line") {
         const opacity2 = parentOpacity * num(id, "opacity", node.props.opacity ?? 1);
         if (opacity2 <= 0) return;
@@ -699,6 +712,7 @@
           y2: y1 + (num(id, "y2", node.props.y2) - y1) * progress,
           stroke: str(id, "stroke", node.props.stroke),
           strokeWidth: num(id, "strokeWidth", node.props.strokeWidth ?? 1),
+          ...fx,
           ...clipSpread
         });
         return;
@@ -746,6 +760,7 @@
             ...fill !== void 0 && { fill },
             ...stroke !== void 0 && { stroke, strokeWidth },
             ...node.type === "rect" && { radius: num(id, "radius", node.props.radius ?? 0) },
+            ...fx,
             ...clipSpread
           });
           return;
@@ -764,6 +779,7 @@
             height,
             offsetX: -width * ax,
             offsetY: -height * ay,
+            ...fx,
             ...clipSpread
           });
           return;
@@ -787,6 +803,7 @@
             ...fill !== void 0 && { fill },
             ...stroke !== void 0 && { stroke, strokeWidth: num(id, "strokeWidth", node.props.strokeWidth ?? 1) },
             ...needsBox && { bbox: pathBBox(dStr) },
+            ...fx,
             ...clipSpread
           });
           return;
@@ -811,6 +828,7 @@
             letterSpacing: num(id, "letterSpacing", node.props.letterSpacing ?? 0),
             align: TEXT_ALIGN[ax] ?? "left",
             baseline: TEXT_BASELINE[ay] ?? "top",
+            ...fx,
             ...clipSpread
           });
           return;
@@ -889,6 +907,13 @@
       }
       ctx2.setTransform(...op.transform);
       ctx2.globalAlpha = Math.max(0, Math.min(1, op.opacity));
+      if (op.blur) ctx2.filter = `blur(${op.blur}px)`;
+      if (op.shadowColor) {
+        ctx2.shadowColor = op.shadowColor;
+        ctx2.shadowBlur = op.shadowBlur ?? 0;
+        ctx2.shadowOffsetX = op.shadowX ?? 0;
+        ctx2.shadowOffsetY = op.shadowY ?? 0;
+      }
       switch (op.type) {
         case "rect": {
           const box = { x: op.offsetX, y: op.offsetY, w: op.width, h: op.height };

package/dist/cli.js

@@ -324,12 +324,13 @@ function compileScene(ir) {
 }
 
 // ../core/src/validate.ts
-var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed"];
+var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY"];
+var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed", ...FX_PROPS];
 var CAMERA_PROPS = ["x", "y", "zoom", "rotation"];
 var PROPS_BY_TYPE = {
   rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
   ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
-  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress"],
+  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
   text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
   image: [...COMMON_PROPS, "src", "width", "height"],
   path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
@@ -375,6 +376,8 @@ function validateScene(ir) {
       const props = node.props;
       checkPaint(`node "${node.id}" fill`, props.fill);
       checkPaint(`node "${node.id}" stroke`, props.stroke);
+      if (typeof props.blur === "number" && props.blur < 0) problems.push(`node "${node.id}": blur must be >= 0`);
+      if (typeof props.shadowBlur === "number" && props.shadowBlur < 0) problems.push(`node "${node.id}": shadowBlur must be >= 0`);
       if (node.type === "group") {
         const clip = node.props.clip;
         if (clip) {

package/dist/index.js

@@ -334,12 +334,13 @@ function compileScene(ir) {
 }
 
 // ../core/src/validate.ts
-var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed"];
+var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY"];
+var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed", ...FX_PROPS];
 var CAMERA_PROPS = ["x", "y", "zoom", "rotation"];
 var PROPS_BY_TYPE = {
   rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
   ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
-  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress"],
+  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
   text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
   image: [...COMMON_PROPS, "src", "width", "height"],
   path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
@@ -385,6 +386,8 @@ function validateScene(ir) {
       const props = node.props;
       checkPaint(`node "${node.id}" fill`, props.fill);
       checkPaint(`node "${node.id}" stroke`, props.stroke);
+      if (typeof props.blur === "number" && props.blur < 0) problems.push(`node "${node.id}": blur must be >= 0`);
+      if (typeof props.shadowBlur === "number" && props.shadowBlur < 0) problems.push(`node "${node.id}": shadowBlur must be >= 0`);
       if (node.type === "group") {
         const clip = node.props.clip;
         if (clip) {
@@ -987,6 +990,14 @@ function conicGradient(stops, opts = {}) {
   };
 }
 
+// ../core/src/effects.ts
+function glow(color, blur = 24) {
+  return { shadowColor: color, shadowBlur: blur, shadowX: 0, shadowY: 0 };
+}
+function dropShadow(color, blur = 24, x = 0, y = 12) {
+  return { shadowColor: color, shadowBlur: blur, shadowX: x, shadowY: y };
+}
+
 // ../core/src/presets.ts
 var PRESET_NAMES = [
   "draw-bloom",
@@ -1526,11 +1537,11 @@ function ikReach(upper, lower, dx, dy, flip = false) {
 function humanoid(opts = {}) {
   const line2 = opts.color ?? DEFAULT_LINE;
   const fill = opts.fill ?? DEFAULT_FILL;
-  const glow = opts.glow;
+  const glow2 = opts.glow;
   const blob = (jid, a, b, cy) => {
     const d = ovalPath(a, b, 0, cy);
     const nodes = [];
-    if (glow) nodes.push(path({ id: `${jid}-glow`, d, x: 0, y: 0, fill: "none", stroke: glow, strokeWidth: GLOW_W, opacity: 0.18 }));
+    if (glow2) nodes.push(path({ id: `${jid}-glow`, d, x: 0, y: 0, fill: "none", stroke: glow2, strokeWidth: GLOW_W, opacity: 0.18 }));
     nodes.push(path({ id: `${jid}-shape`, d, x: 0, y: 0, fill, stroke: line2, strokeWidth: LINE_W }));
     return nodes;
   };
@@ -2938,9 +2949,21 @@ function evaluate(compiled, t) {
     const v = valueAt(target, prop, base ?? "");
     return v === "" && base === void 0 ? void 0 : String(v);
   };
+  const effectFx = (id, p) => {
+    const fx = {};
+    if (p.blur !== void 0) fx.blur = num(id, "blur", p.blur);
+    if (p.shadowColor !== void 0) {
+      fx.shadowColor = str(id, "shadowColor", p.shadowColor);
+      fx.shadowBlur = num(id, "shadowBlur", p.shadowBlur ?? 0);
+      fx.shadowX = num(id, "shadowX", p.shadowX ?? 0);
+      fx.shadowY = num(id, "shadowY", p.shadowY ?? 0);
+    }
+    return fx;
+  };
   const walk = (node, parent, parentOpacity, clips) => {
     const id = node.id;
     const clipSpread = clips.length > 0 ? { clips } : void 0;
+    const fx = effectFx(id, node.props);
     if (node.type === "line") {
       const opacity2 = parentOpacity * num(id, "opacity", node.props.opacity ?? 1);
       if (opacity2 <= 0) return;
@@ -2958,6 +2981,7 @@ function evaluate(compiled, t) {
         y2: y1 + (num(id, "y2", node.props.y2) - y1) * progress,
         stroke: str(id, "stroke", node.props.stroke),
         strokeWidth: num(id, "strokeWidth", node.props.strokeWidth ?? 1),
+        ...fx,
         ...clipSpread
       });
       return;
@@ -3005,6 +3029,7 @@ function evaluate(compiled, t) {
           ...fill !== void 0 && { fill },
           ...stroke !== void 0 && { stroke, strokeWidth },
           ...node.type === "rect" && { radius: num(id, "radius", node.props.radius ?? 0) },
+          ...fx,
           ...clipSpread
         });
         return;
@@ -3023,6 +3048,7 @@ function evaluate(compiled, t) {
           height,
           offsetX: -width * ax,
           offsetY: -height * ay,
+          ...fx,
           ...clipSpread
         });
         return;
@@ -3046,6 +3072,7 @@ function evaluate(compiled, t) {
           ...fill !== void 0 && { fill },
           ...stroke !== void 0 && { stroke, strokeWidth: num(id, "strokeWidth", node.props.strokeWidth ?? 1) },
           ...needsBox && { bbox: pathBBox(dStr) },
+          ...fx,
           ...clipSpread
         });
         return;
@@ -3070,6 +3097,7 @@ function evaluate(compiled, t) {
           letterSpacing: num(id, "letterSpacing", node.props.letterSpacing ?? 0),
           align: TEXT_ALIGN[ax] ?? "left",
           baseline: TEXT_BASELINE[ay] ?? "top",
+          ...fx,
           ...clipSpread
         });
         return;
@@ -3204,10 +3232,12 @@ export {
   deviceScreen,
   deviceScreenCenter,
   deviceScreenPoint,
+  dropShadow,
   ellipse,
   evaluate,
   figure,
   formatComposeReport,
+  glow,
   group,
   humanoid,
   ikReach,

package/dist/labels.js

@@ -318,12 +318,13 @@ function compileScene(ir) {
 }
 
 // ../core/src/validate.ts
-var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed"];
+var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY"];
+var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed", ...FX_PROPS];
 var CAMERA_PROPS = ["x", "y", "zoom", "rotation"];
 var PROPS_BY_TYPE = {
   rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
   ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
-  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress"],
+  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
   text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
   image: [...COMMON_PROPS, "src", "width", "height"],
   path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
@@ -369,6 +370,8 @@ function validateScene(ir) {
       const props = node.props;
       checkPaint(`node "${node.id}" fill`, props.fill);
       checkPaint(`node "${node.id}" stroke`, props.stroke);
+      if (typeof props.blur === "number" && props.blur < 0) problems.push(`node "${node.id}": blur must be >= 0`);
+      if (typeof props.shadowBlur === "number" && props.shadowBlur < 0) problems.push(`node "${node.id}": shadowBlur must be >= 0`);
       if (node.type === "group") {
         const clip = node.props.clip;
         if (clip) {

package/dist/renderer-canvas.js

@@ -55,6 +55,13 @@ function drawDisplayList(ctx, ops, images) {
     }
     ctx.setTransform(...op.transform);
     ctx.globalAlpha = Math.max(0, Math.min(1, op.opacity));
+    if (op.blur) ctx.filter = `blur(${op.blur}px)`;
+    if (op.shadowColor) {
+      ctx.shadowColor = op.shadowColor;
+      ctx.shadowBlur = op.shadowBlur ?? 0;
+      ctx.shadowOffsetX = op.shadowX ?? 0;
+      ctx.shadowOffsetY = op.shadowY ?? 0;
+    }
     switch (op.type) {
       case "rect": {
         const box = { x: op.offsetX, y: op.offsetY, w: op.width, h: op.height };

package/dist/trace-cli.js

@@ -6,11 +6,12 @@ import { resolve as resolve2 } from "node:path";
 import { pathToFileURL } from "node:url";
 
 // ../core/src/validate.ts
-var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed"];
+var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY"];
+var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed", ...FX_PROPS];
 var PROPS_BY_TYPE = {
   rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
   ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
-  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress"],
+  line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
   text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
   image: [...COMMON_PROPS, "src", "width", "height"],
   path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],

package/dist/types/effects.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Drop-shadow / outer-glow sugar. These return a partial-props object you spread
+ * into a shape node; the underlying `shadow*` props stay animatable (e.g. pulse a
+ * glow with `oscillate(id, "shadowBlur", …)`). Units are screen pixels.
+ */
+import type { BaseProps } from "./ir.js";
+type ShadowProps = Pick<BaseProps, "shadowColor" | "shadowBlur" | "shadowX" | "shadowY">;
+/** An outer glow — a shadow with no offset. `rect({ …, ...glow("#FFD24B", 28) })`. */
+export declare function glow(color: string, blur?: number): ShadowProps;
+/** A drop shadow (offset downward by default). `rect({ …, ...dropShadow("#0008", 40, 0, 16) })`. */
+export declare function dropShadow(color: string, blur?: number, x?: number, y?: number): ShadowProps;
+export {};

package/dist/types/evaluate.d.ts

@@ -24,6 +24,12 @@ interface OpBase {
     opacity: number;
     /** Clip regions from ancestor groups (intersected by the renderer). */
     clips?: ClipRegion[];
+    /** Paint effects (screen-pixel space). Present only when authored. */
+    blur?: number;
+    shadowColor?: string;
+    shadowBlur?: number;
+    shadowX?: number;
+    shadowY?: number;
 }
 export type DisplayOp = (OpBase & {
     type: "rect";

package/dist/types/index.d.ts

@@ -7,6 +7,7 @@ export { compileScene, type CompiledScene, type PropertySegment, type LabelSpan,
 export { pathPoint, pathTangentAngle, type Pt } from "./path.js";
 export { cameraTo, cameraMatrix, CAMERA_ID, CAMERA_PROPS } from "./camera.js";
 export { linearGradient, radialGradient, conicGradient, isGradient } from "./gradient.js";
+export { glow, dropShadow } from "./effects.js";
 export { motionPreset, PRESET_NAMES, type PresetName, type PresetRig, type PresetOpts } from "./presets.js";
 export { devicePreset, deviceScreen, deviceScreenCenter, deviceBounds, deviceScreenPoint, DEVICE_PRESET_NAMES, type DevicePresetName, type DevicePresetOpts } from "./devicePreset.js";
 export { cursor, cursorTo, cursorPath, cursorClick, cursorDouble, type CursorStyle, type CursorOpts, type CursorToOpts, type CursorPathOpts, type CursorClickOpts } from "./cursor.js";

package/dist/types/ir.d.ts

@@ -36,6 +36,17 @@ export interface BaseProps {
      * for HUD / titles / watermark layers. No-op when the scene has no camera.
      */
     fixed?: boolean;
+    /**
+     * Paint effects (animatable scalars, in screen pixels — not transformed by the
+     * node's rotation/scale or the camera, so a shadow keeps a consistent light
+     * direction). `shadowColor` enables a drop shadow / outer glow (`glow`/`dropShadow`
+     * helpers). No-op on a `group` (use a child; group/composite blur is a later add).
+     */
+    blur?: number;
+    shadowColor?: string;
+    shadowBlur?: number;
+    shadowX?: number;
+    shadowY?: number;
 }
 /**
  * A paint is a solid color string OR a gradient. Coordinates are normalized to the
@@ -93,6 +104,12 @@ export interface LineProps {
     progress?: number;
     /** Pin to the screen so the scene `camera` does not move it (top-level only). */
     fixed?: boolean;
+    /** Paint effects (px, screen-space) — see BaseProps. */
+    blur?: number;
+    shadowColor?: string;
+    shadowBlur?: number;
+    shadowX?: number;
+    shadowY?: number;
 }
 export interface TextProps extends BaseProps {
     /** Numbers interpolate (count-up) and render via toFixed(contentDecimals). */

package/guides/edsl-guide.md

@@ -172,6 +172,28 @@ ellipse({ id: "ring", /* … */ fill: "none", stroke: linearGradient(["#3AA0FF",
   gradient sweeps/stretches with it. Color-string fills still tween as today.
 - text fill and line stroke are color-only for now. See `examples/scenes/gradient-demo.ts`.
 
+## Shadow, glow & blur
+
+Drawable nodes (rect / ellipse / path / text / image / line) take animatable paint
+effects, in **screen pixels** (not transformed by the node or camera, so a shadow
+keeps a consistent light direction):
+
+```ts
+rect({ id: "card", /* … */, ...dropShadow("#000000", 64, 0, 34) })   // drop shadow
+ellipse({ id: "orb", /* … */, fill: radialGradient([...]), shadowColor: "#FFC24B", shadowBlur: 22 })
+oscillate("orb", "shadowBlur", { amplitude: 16, frequency: 0.9 })    // PULSING glow
+rect({ id: "card", /* … */, blur: 18 }); tween("card", { blur: 0 }, { duration: 1 }) // focus pull
+```
+
+- Props: `blur` (gaussian blur of the shape), `shadowColor` (turns the shadow/glow
+  on), `shadowBlur`, `shadowX`, `shadowY`. All **animatable** — `tween`/`oscillate`
+  them for pulsing glows, focus pulls, etc. (set a base value first so there's
+  something to animate from).
+- Sugar: `glow(color, blur)` (offset 0) and `dropShadow(color, blur, x, y)` return
+  a partial you spread into props (`...glow("#FFD24B", 28)`); still animatable.
+- No-op on a `group` (apply to a child; group/composite blur is a later add). See
+  `examples/scenes/shadow-demo.ts`.
+
 ## Character rig (skeleton, poses, IK)
 
 A first-class, declarative character rig that **compiles to plain IR** (nested

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reframe-video",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Declarative motion graphics that AI can write and humans can tweak — human edits survive AI regeneration. Deterministic mp4 renders from a plain-data scene format.",
   "keywords": [
     "motion-graphics",