pixi-effects 0.18.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +6 -6
  3. package/ai/CHAT.md +1 -1
  4. package/ai/SKILL.md +1 -1
  5. package/ai/chat-template.html +4 -4
  6. package/ai/reference/cheatsheet.md +5 -5
  7. package/ai/reference/pitfalls.md +5 -1
  8. package/ai/reference/recipes.md +65 -0
  9. package/ai/template.html +5 -5
  10. package/ai/tools/check.mjs +14 -3
  11. package/dist/{Base-BQUodYZK.d.ts → Base-B4WbUJO2.d.ts} +1 -1
  12. package/dist/{Base-OHqp8qvX.d.cts → Base-i88XXaiP.d.cts} +1 -1
  13. package/dist/Composition-KYNPRWK3.cjs +14 -0
  14. package/dist/{Composition-6JMXWNVV.cjs.map → Composition-KYNPRWK3.cjs.map} +1 -1
  15. package/dist/Composition-QBKEEJBV.js +5 -0
  16. package/dist/{Composition-MLBHYYFF.js.map → Composition-QBKEEJBV.js.map} +1 -1
  17. package/dist/Controller.d.cts +2 -2
  18. package/dist/Controller.d.ts +2 -2
  19. package/dist/{Movie-DlHQ9C02.d.ts → Movie-8IrqL3kO.d.ts} +6 -1
  20. package/dist/{Movie-K2YuVAdg.d.cts → Movie-CpmdNadg.d.cts} +6 -1
  21. package/dist/Presenter.d.cts +2 -2
  22. package/dist/Presenter.d.ts +2 -2
  23. package/dist/{chunk-UXDR3ZDU.js → chunk-B3YB2TNY.js} +4 -3
  24. package/dist/chunk-B3YB2TNY.js.map +1 -0
  25. package/dist/{chunk-JW67MDHQ.cjs → chunk-CTZRFSVU.cjs} +27 -26
  26. package/dist/chunk-CTZRFSVU.cjs.map +1 -0
  27. package/dist/{chunk-ANO5R2E6.cjs → chunk-VTBT6NNE.cjs} +755 -48
  28. package/dist/chunk-VTBT6NNE.cjs.map +1 -0
  29. package/dist/{chunk-SG3Y66FN.js → chunk-YRXTKOV5.js} +757 -51
  30. package/dist/chunk-YRXTKOV5.js.map +1 -0
  31. package/dist/index.cjs +73 -36
  32. package/dist/index.cjs.map +1 -1
  33. package/dist/index.d.cts +5 -5
  34. package/dist/index.d.ts +5 -5
  35. package/dist/index.js +50 -13
  36. package/dist/index.js.map +1 -1
  37. package/dist/loader.css +1 -1
  38. package/dist/three.cjs +5 -5
  39. package/dist/three.d.cts +2 -2
  40. package/dist/three.d.ts +2 -2
  41. package/dist/three.js +1 -1
  42. package/dist/{types-SS51lP6O.d.cts → types-bzLJ7aUx.d.cts} +16 -6
  43. package/dist/{types-SS51lP6O.d.ts → types-bzLJ7aUx.d.ts} +16 -6
  44. package/docs/dsl.md +36 -5
  45. package/llms-full.txt +112 -11
  46. package/package.json +1 -1
  47. package/dist/Composition-6JMXWNVV.cjs +0 -14
  48. package/dist/Composition-MLBHYYFF.js +0 -5
  49. package/dist/chunk-ANO5R2E6.cjs.map +0 -1
  50. package/dist/chunk-JW67MDHQ.cjs.map +0 -1
  51. package/dist/chunk-SG3Y66FN.js.map +0 -1
  52. package/dist/chunk-UXDR3ZDU.js.map +0 -1
package/dist/loader.css CHANGED
@@ -1,7 +1,7 @@
1
1
  /*
2
2
  * pixi-effects loader: one line of HTML on the page, a few lines of CSS, no JavaScript of your own.
3
3
  *
4
- * <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.18.0/dist/loader.css">
4
+ * <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.19.0/dist/loader.css">
5
5
  * <div class="stage" style="position: relative"> <!-- any box the canvas sits in, with position: relative -->
6
6
  * <canvas id="stage" width="1280" height="720"></canvas>
7
7
  * <div class="pe-loader" data-label="LOADING"></div> <!-- or class="pe-loader pe-loader--bar" -->
package/dist/three.cjs CHANGED
@@ -1,11 +1,11 @@
1
1
  'use strict';
2
2
 
3
- var chunkANO5R2E6_cjs = require('./chunk-ANO5R2E6.cjs');
3
+ var chunkVTBT6NNE_cjs = require('./chunk-VTBT6NNE.cjs');
4
4
  require('./chunk-UQBGW5DO.cjs');
5
5
  var pixi_js = require('pixi.js');
6
6
  var three$1 = require('three');
7
7
 
8
- var ThreeSequence = class extends chunkANO5R2E6_cjs.Sequence {
8
+ var ThreeSequence = class extends chunkVTBT6NNE_cjs.Sequence {
9
9
  _renderer = null;
10
10
  _scene = null;
11
11
  _camera = null;
@@ -24,7 +24,7 @@ var ThreeSequence = class extends chunkANO5R2E6_cjs.Sequence {
24
24
  if (this.duration === void 0) {
25
25
  this.duration = this.parent?.duration ?? this.root.duration;
26
26
  }
27
- const scope = chunkANO5R2E6_cjs.buildScope(this, this.parent, this.root);
27
+ const scope = chunkVTBT6NNE_cjs.buildScope(this, this.parent, this.root);
28
28
  const width = resolveDim(spec.width, scope) ?? this.parent?.width ?? this.root.width;
29
29
  const height = resolveDim(spec.height, scope) ?? this.parent?.height ?? this.root.height;
30
30
  const resolution = spec.resolution ?? 1;
@@ -144,12 +144,12 @@ var ThreeSequence = class extends chunkANO5R2E6_cjs.Sequence {
144
144
  function resolveDim(v, scope) {
145
145
  if (v === void 0) return void 0;
146
146
  if (typeof v === "number") return v;
147
- return chunkANO5R2E6_cjs.evaluateExpr(v, scope);
147
+ return chunkVTBT6NNE_cjs.evaluateExpr(v, scope);
148
148
  }
149
149
 
150
150
  // src/three/index.ts
151
151
  function registerThree() {
152
- chunkANO5R2E6_cjs.registerSequenceType("three", ThreeSequence);
152
+ chunkVTBT6NNE_cjs.registerSequenceType("three", ThreeSequence);
153
153
  }
154
154
  function three(spec) {
155
155
  return spec;
package/dist/three.d.cts CHANGED
@@ -1,6 +1,6 @@
1
- import { d as SequenceCommon, y as PropValue, S as SequenceSpec } from './types-SS51lP6O.cjs';
1
+ import { d as SequenceCommon, y as PropValue, S as SequenceSpec } from './types-bzLJ7aUx.cjs';
2
2
  import { Scene, Camera, WebGLRenderer } from 'three';
3
- import { S as Sequence, P as PathRouters } from './Base-OHqp8qvX.cjs';
3
+ import { S as Sequence, P as PathRouters } from './Base-i88XXaiP.cjs';
4
4
  import 'pixi.js';
5
5
  import 'gsap';
6
6
 
package/dist/three.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { d as SequenceCommon, y as PropValue, S as SequenceSpec } from './types-SS51lP6O.js';
1
+ import { d as SequenceCommon, y as PropValue, S as SequenceSpec } from './types-bzLJ7aUx.js';
2
2
  import { Scene, Camera, WebGLRenderer } from 'three';
3
- import { S as Sequence, P as PathRouters } from './Base-BQUodYZK.js';
3
+ import { S as Sequence, P as PathRouters } from './Base-B4WbUJO2.js';
4
4
  import 'pixi.js';
5
5
  import 'gsap';
6
6
 
package/dist/three.js CHANGED
@@ -1,4 +1,4 @@
1
- import { Sequence, buildScope, evaluateExpr, registerSequenceType } from './chunk-SG3Y66FN.js';
1
+ import { Sequence, buildScope, evaluateExpr, registerSequenceType } from './chunk-YRXTKOV5.js';
2
2
  import './chunk-DKGG7WD4.js';
3
3
  import { Texture, Sprite } from 'pixi.js';
4
4
  import { WebGLRenderer, Scene, PerspectiveCamera } from 'three';
@@ -60,6 +60,10 @@ type Expr = string;
60
60
  type PropValue = number | string;
61
61
  /** Generic prop bag (key → value). */
62
62
  type Props = Record<string, PropValue>;
63
+ /** What a keyframe's `set` / `to` / `from` may hold: the usual numbers and strings, and for a layer with a `fillGradient` a partial gradient (`{ angle, center, innerRadius, radius, stops }`; the same number of stops). */
64
+ type KeyframeProps = Props & {
65
+ fillGradient?: Partial<GradientSpec>;
66
+ };
63
67
  /** A single keyframe entry. Either `set`, `to`, `from`, or `from`+`to` is meaningful per kind. */
64
68
  interface Keyframe {
65
69
  /**
@@ -69,7 +73,8 @@ interface Keyframe {
69
73
  * (`-0.5` = 0.5 s before it ends).
70
74
  */
71
75
  at?: number;
72
- duration?: number;
76
+ /** Seconds, or 'auto' with a spring ease: the time the spring takes to settle (within 0.5 %). */
77
+ duration?: number | 'auto';
73
78
  ease?: string;
74
79
  /** Extra plays of this tween after the first (a finite count; infinite repeats are not allowed — the timeline needs a fixed length). Total time = duration × (repeat + 1) plus delays. */
75
80
  repeat?: number;
@@ -77,9 +82,9 @@ interface Keyframe {
77
82
  yoyo?: boolean;
78
83
  /** With `repeat`: seconds to wait between plays. */
79
84
  repeatDelay?: number;
80
- set?: Props;
81
- to?: Props;
82
- from?: Props;
85
+ set?: KeyframeProps;
86
+ to?: KeyframeProps;
87
+ from?: KeyframeProps;
83
88
  }
84
89
  interface AssetSpec {
85
90
  name: string;
@@ -130,7 +135,7 @@ interface NamedFilterSpec {
130
135
  name?: string;
131
136
  [option: string]: unknown;
132
137
  }
133
- type NamedFilterType = 'blur' | 'noise' | 'alpha' | 'colorMatrix' | 'adjustment' | 'advancedBloom' | 'ascii' | 'backdropBlur' | 'bevel' | 'bloom' | 'bulgePinch' | 'colorGradient' | 'colorMap' | 'colorOverlay' | 'colorReplace' | 'convolution' | 'crossHatch' | 'crt' | 'dot' | 'dropShadow' | 'emboss' | 'glitch' | 'glow' | 'godray' | 'grayscale' | 'hslAdjustment' | 'kawaseBlur' | 'motionBlur' | 'multiColorReplace' | 'oldFilm' | 'outline' | 'pixelate' | 'radialBlur' | 'reflection' | 'rgbSplit' | 'shockwave' | 'simpleLightmap' | 'simplexNoise' | 'tiltShift' | 'tiltShiftAxis' | 'twist' | 'zoomBlur';
138
+ type NamedFilterType = 'blur' | 'noise' | 'alpha' | 'colorMatrix' | 'grain' | 'adjustment' | 'advancedBloom' | 'ascii' | 'backdropBlur' | 'bevel' | 'bloom' | 'bulgePinch' | 'colorGradient' | 'colorMap' | 'colorOverlay' | 'colorReplace' | 'convolution' | 'crossHatch' | 'crt' | 'dot' | 'dropShadow' | 'emboss' | 'glitch' | 'glow' | 'godray' | 'grayscale' | 'hslAdjustment' | 'kawaseBlur' | 'motionBlur' | 'multiColorReplace' | 'oldFilm' | 'outline' | 'pixelate' | 'radialBlur' | 'reflection' | 'rgbSplit' | 'shockwave' | 'simpleLightmap' | 'simplexNoise' | 'tiltShift' | 'tiltShiftAxis' | 'twist' | 'zoomBlur';
134
139
  type FilterSpec = ChromaKeyFilterSpec | CustomFilterSpec | NamedFilterSpec;
135
140
  interface TransitionCommon {
136
141
  /** Sibling sequence's `name` — the outgoing scene. */
@@ -306,6 +311,11 @@ interface TextSequenceSpec extends SequenceCommon {
306
311
  * every frame the tween is active.
307
312
  */
308
313
  colorSpace?: 'rgb' | 'oklab' | 'oklch';
314
+ /**
315
+ * A gradient fill for the letters (like a shape's `fillGradient`; replaces `style.fill`). Animatable: a keyframe's
316
+ * `to: { fillGradient: { angle: 200, stops: [...] } }` (the same number of stops). The text is re-rasterised on every change.
317
+ */
318
+ fillGradient?: GradientSpec;
309
319
  }
310
320
  type SfxPreset = 'click' | 'pop' | 'swoosh' | 'swipe' | 'hit' | 'riser' | 'chime' | 'beep' | 'coin' | 'glitch' | 'typewriter';
311
321
  /** The intent-level knobs shared by presets and custom sounds. */
@@ -467,7 +477,7 @@ interface CameraSequenceSpec extends SequenceCommon {
467
477
  /**
468
478
  * A gradient fill for a shape (replaces `fillColor`). Positions are relative to the shape's own
469
479
  * bounds (0–1), so it follows the shape's size. Colours may have alpha (`'rgba(0,0,0,0.6)'`), so a
470
- * radial gradient from transparent to dark is a vignette. Not animatable.
480
+ * radial gradient from transparent to dark is a vignette. Animatable on shapes and text: a keyframe's `set` / `from` / `to` carries a partial `fillGradient` (see KeyframeProps).
471
481
  */
472
482
  interface GradientSpec {
473
483
  /** Default `'linear'`. */
@@ -60,6 +60,10 @@ type Expr = string;
60
60
  type PropValue = number | string;
61
61
  /** Generic prop bag (key → value). */
62
62
  type Props = Record<string, PropValue>;
63
+ /** What a keyframe's `set` / `to` / `from` may hold: the usual numbers and strings, and for a layer with a `fillGradient` a partial gradient (`{ angle, center, innerRadius, radius, stops }`; the same number of stops). */
64
+ type KeyframeProps = Props & {
65
+ fillGradient?: Partial<GradientSpec>;
66
+ };
63
67
  /** A single keyframe entry. Either `set`, `to`, `from`, or `from`+`to` is meaningful per kind. */
64
68
  interface Keyframe {
65
69
  /**
@@ -69,7 +73,8 @@ interface Keyframe {
69
73
  * (`-0.5` = 0.5 s before it ends).
70
74
  */
71
75
  at?: number;
72
- duration?: number;
76
+ /** Seconds, or 'auto' with a spring ease: the time the spring takes to settle (within 0.5 %). */
77
+ duration?: number | 'auto';
73
78
  ease?: string;
74
79
  /** Extra plays of this tween after the first (a finite count; infinite repeats are not allowed — the timeline needs a fixed length). Total time = duration × (repeat + 1) plus delays. */
75
80
  repeat?: number;
@@ -77,9 +82,9 @@ interface Keyframe {
77
82
  yoyo?: boolean;
78
83
  /** With `repeat`: seconds to wait between plays. */
79
84
  repeatDelay?: number;
80
- set?: Props;
81
- to?: Props;
82
- from?: Props;
85
+ set?: KeyframeProps;
86
+ to?: KeyframeProps;
87
+ from?: KeyframeProps;
83
88
  }
84
89
  interface AssetSpec {
85
90
  name: string;
@@ -130,7 +135,7 @@ interface NamedFilterSpec {
130
135
  name?: string;
131
136
  [option: string]: unknown;
132
137
  }
133
- type NamedFilterType = 'blur' | 'noise' | 'alpha' | 'colorMatrix' | 'adjustment' | 'advancedBloom' | 'ascii' | 'backdropBlur' | 'bevel' | 'bloom' | 'bulgePinch' | 'colorGradient' | 'colorMap' | 'colorOverlay' | 'colorReplace' | 'convolution' | 'crossHatch' | 'crt' | 'dot' | 'dropShadow' | 'emboss' | 'glitch' | 'glow' | 'godray' | 'grayscale' | 'hslAdjustment' | 'kawaseBlur' | 'motionBlur' | 'multiColorReplace' | 'oldFilm' | 'outline' | 'pixelate' | 'radialBlur' | 'reflection' | 'rgbSplit' | 'shockwave' | 'simpleLightmap' | 'simplexNoise' | 'tiltShift' | 'tiltShiftAxis' | 'twist' | 'zoomBlur';
138
+ type NamedFilterType = 'blur' | 'noise' | 'alpha' | 'colorMatrix' | 'grain' | 'adjustment' | 'advancedBloom' | 'ascii' | 'backdropBlur' | 'bevel' | 'bloom' | 'bulgePinch' | 'colorGradient' | 'colorMap' | 'colorOverlay' | 'colorReplace' | 'convolution' | 'crossHatch' | 'crt' | 'dot' | 'dropShadow' | 'emboss' | 'glitch' | 'glow' | 'godray' | 'grayscale' | 'hslAdjustment' | 'kawaseBlur' | 'motionBlur' | 'multiColorReplace' | 'oldFilm' | 'outline' | 'pixelate' | 'radialBlur' | 'reflection' | 'rgbSplit' | 'shockwave' | 'simpleLightmap' | 'simplexNoise' | 'tiltShift' | 'tiltShiftAxis' | 'twist' | 'zoomBlur';
134
139
  type FilterSpec = ChromaKeyFilterSpec | CustomFilterSpec | NamedFilterSpec;
135
140
  interface TransitionCommon {
136
141
  /** Sibling sequence's `name` — the outgoing scene. */
@@ -306,6 +311,11 @@ interface TextSequenceSpec extends SequenceCommon {
306
311
  * every frame the tween is active.
307
312
  */
308
313
  colorSpace?: 'rgb' | 'oklab' | 'oklch';
314
+ /**
315
+ * A gradient fill for the letters (like a shape's `fillGradient`; replaces `style.fill`). Animatable: a keyframe's
316
+ * `to: { fillGradient: { angle: 200, stops: [...] } }` (the same number of stops). The text is re-rasterised on every change.
317
+ */
318
+ fillGradient?: GradientSpec;
309
319
  }
310
320
  type SfxPreset = 'click' | 'pop' | 'swoosh' | 'swipe' | 'hit' | 'riser' | 'chime' | 'beep' | 'coin' | 'glitch' | 'typewriter';
311
321
  /** The intent-level knobs shared by presets and custom sounds. */
@@ -467,7 +477,7 @@ interface CameraSequenceSpec extends SequenceCommon {
467
477
  /**
468
478
  * A gradient fill for a shape (replaces `fillColor`). Positions are relative to the shape's own
469
479
  * bounds (0–1), so it follows the shape's size. Colours may have alpha (`'rgba(0,0,0,0.6)'`), so a
470
- * radial gradient from transparent to dark is a vignette. Not animatable.
480
+ * radial gradient from transparent to dark is a vignette. Animatable on shapes and text: a keyframe's `set` / `from` / `to` carries a partial `fillGradient` (see KeyframeProps).
471
481
  */
472
482
  interface GradientSpec {
473
483
  /** Default `'linear'`. */
package/docs/dsl.md CHANGED
@@ -367,7 +367,7 @@ Colour keys (`fillColor`, `strokeColor`) tween smoothly between hues — no snap
367
367
 
368
368
  #### `fillGradient`
369
369
 
370
- Fill a shape with a gradient instead of `fillColor` (top level or in `initial`). Positions are in 0–1 of the shape's own bounds, so the gradient follows the shape's size. Colours may carry alpha, so a radial gradient from transparent to dark is a vignette. Not animatable.
370
+ Fill a shape with a gradient instead of `fillColor` (top level or in `initial`). Positions are in 0–1 of the shape's own bounds, so the gradient follows the shape's size. Colours may carry alpha, so a radial gradient from transparent to dark is a vignette. Animatable (below), on shapes and on text.
371
371
 
372
372
  ```ts
373
373
  { type: 'shape', shape: 'rect', width: 'GW', height: 'GH', initial: { x: 'GW/2', y: 'GH/2' },
@@ -376,6 +376,17 @@ Fill a shape with a gradient instead of `fillColor` (top level or in `initial`).
376
376
  { ..., fillGradient: { type: 'radial', radius: 0.75, stops: [[0.45, 'rgba(0,0,0,0)'], [1, 'rgba(0,0,0,0.7)']] } } // vignette
377
377
  ```
378
378
 
379
+ **Animating a gradient.** A keyframe's `set` / `from` / `to` takes a **partial** `fillGradient` (`angle`, `center`, `innerRadius`, `radius`, `stops`); what you leave out stays as it is. Numbers move linearly; the stop colours move through the layer's `colorSpace` (`'oklch'` keeps a fade vivid: in `'rgb'`, green to magenta passes through grey). The layer needs a starting `fillGradient` (top level or in `initial`), `stops` must keep the same count, and `type` cannot change (linear ↔ radial). A mistake (a mistyped key, another number of stops, `'fillGradient.angle'` or `gradientAngle` instead of `fillGradient: { angle }`) is said once, when the layer is built. A text layer takes a `fillGradient` for its letters too, **linear only** (`angle` and `stops` apply; `type`, `center`, `innerRadius` and `radius` are ignored, with a warning: use a shape for a radial gradient); the letters are re-rasterised on every change. A keyframe with only `from` runs from that gradient to the layer's own.
380
+
381
+ ```ts
382
+ { type: 'shape', shape: 'rect', width: 560, height: 420, initial: { x: 520, y: 540 }, colorSpace: 'oklch',
383
+ fillGradient: { angle: 0, stops: [[0, '#ff2d55'], [1, '#0ea5e9']] },
384
+ keyframes: [{ at: 0, duration: 2, to: { fillGradient: { angle: 360, stops: [[0, '#00e5ff'], [1, '#ffd60a']] } } }] }
385
+ { type: 'text', text: 'GRADIENT', style: { fontSize: 200, fontWeight: '900' }, initial: { x: 640, y: 360, anchorX: 0.5, anchorY: 0.5 },
386
+ fillGradient: { angle: 0, stops: [[0, '#ff2d55'], [1, '#0ea5e9']] },
387
+ keyframes: [{ at: 0, duration: 2, to: { fillGradient: { angle: 180 } } }] }
388
+ ```
389
+
379
390
  | Field | Notes |
380
391
  |---|---|
381
392
  | `type` | `'linear'` (default) or `'radial'` |
@@ -713,8 +724,8 @@ Supported formats are whatever PixiJS Assets and the browser's audio/video decod
713
724
  ```ts
714
725
  interface Keyframe {
715
726
  at?: number; // start, in seconds from the start of THIS sequence; negative = back from the sequence's end (-0.5 = 0.5 s before it ends)
716
- duration?: number; // seconds (default 0 — instantaneous)
717
- ease?: string; // GSAP easing name (default 'none')
727
+ duration?: number | 'auto'; // seconds (default 0 — instantaneous); 'auto' = the time a spring ease takes to settle
728
+ ease?: string; // GSAP easing name (default 'none'), or a spring: 'spring(mass, stiffness, damping)', 'spring.gentle|snappy|bouncy|wobbly|slow'
718
729
  set?: Props; // jump to these values at `at`
719
730
  to?: Props; // animate from current to these values over `duration`
720
731
  from?: Props; // animate from these values to current
@@ -729,6 +740,25 @@ The four kinds are mutually exclusive per keyframe:
729
740
  - **`from`** — tween from the given values back to the current property, over `duration`.
730
741
  - **`from` + `to`** — full fromTo tween, with explicit start and end values.
731
742
 
743
+ ### Springs
744
+
745
+ The ease `'spring(mass, stiffness, damping)'` (defaults 1, 100, 10) or a preset (`spring.gentle`, `spring.snappy`, `spring.bouncy`, `spring.wobbly`, `spring.slow`) moves a value as a damped spring would: it overshoots its target and rings, then rests. `duration: 'auto'` gives the keyframe the time the spring needs to settle (within 0.5 %), so mass and stiffness are real physics; with a number, `duration` is that settle time and only the damping ratio `damping / (2 √(stiffness × mass))` shapes the motion (below 1 it overshoots, 1 or more it does not: `spring(1, 170, 26)` does not bounce, `spring(1, 170, 12)` does).
746
+
747
+ ```ts
748
+ { at: 0.2, from: { y: -200 }, to: { y: 0 }, duration: 'auto', ease: 'spring.bouncy' }
749
+ { at: 0, to: { scale: 1 }, duration: 0.8, ease: 'spring(1, 170, 12)' }
750
+ ```
751
+
752
+ | Preset | Settles in | Highest value (target = 1) |
753
+ |---|---|---|
754
+ | `spring.snappy` | 0.42 s | 1.01 |
755
+ | `spring.gentle` | 0.72 s | 1.02 |
756
+ | `spring.bouncy` | 1.08 s | 1.28 |
757
+ | `spring.slow` | 1.29 s | 1.00 (no overshoot) |
758
+ | `spring.wobbly` | 1.61 s | 1.40 |
759
+
760
+ A colour is clamped in its colour space when it overshoots, and `alpha` past 1 is not visible. `'auto'` is for keyframes: `animateText` / `orbit` tweens take a spring name but a number `duration`. A malformed spring (`spring(1, 170`, `spring.floppy`) is reported once, with what is wrong.
761
+
732
762
  ### Repeating
733
763
 
734
764
  `repeat` (extra plays, a finite whole number), `yoyo` (every other play runs backwards) and `repeatDelay` (seconds between plays) work on every kind of animation — position, alpha, colour, shape geometry, filters, text `fill`/`value`:
@@ -1028,12 +1058,13 @@ A filter by name, as plain data. `type` is the filter's class name without `Filt
1028
1058
  keyframes: [{ at: 0, to: { 'filters.halo.outerStrength': 6 }, duration: 1 }] } // animate any scalar option by name
1029
1059
  ```
1030
1060
 
1031
- Name a filter (`name: 'halo'`) to animate it with `'filters.halo.<option>'`. `blur`, `noise`, `alpha` and `colorMatrix` come from pixi.js. All the others come from the **`pixi-filters`** package, which is loaded the first time a layer uses one (add `"pixi-filters": "https://esm.sh/pixi-filters@6.1.5?external=pixi.js"` to the import map, or `npm i pixi-filters`; `ai/template.html` already has it). A misspelt type says what you probably meant. Rendering and exporting were verified in a real browser for 40 of them (`examples/_checks/named-filters.html` and `named-filters-2.html`); `colorMap` and `simpleLightmap` need a texture, which JSON cannot hold, so use `custom` for those two:
1061
+ Name a filter (`name: 'halo'`) to animate it with `'filters.halo.<option>'`. `blur`, `noise`, `alpha`, `colorMatrix` and `grain` need no extra package (`grain` is this library's own). All the others come from the **`pixi-filters`** package, which is loaded the first time a layer uses one (add `"pixi-filters": "https://esm.sh/pixi-filters@6.1.5?external=pixi.js"` to the import map, or `npm i pixi-filters`; `ai/template.html` already has it). A misspelt type says what you probably meant. Rendering and exporting were verified in a real browser for 40 of them (`examples/_checks/named-filters.html` and `named-filters-2.html`); `colorMap` and `simpleLightmap` need a texture, which JSON cannot hold, so use `custom` for those two:
1032
1062
 
1033
1063
  | `type` | Options (the useful ones) | What it does |
1034
1064
  |---|---|---|
1035
1065
  | `blur` | `strength`, `quality` | Gaussian blur (pixi.js) |
1036
- | `noise` | `noise` (0–1), `seed` | Film grain (pixi.js) |
1066
+ | `noise` | `noise` (0–1), `seed` | Uniform noise (pixi.js): one frozen pattern (the seed is random unless you give it), the same strength at every tone, it lifts blacks. For film grain use `grain` |
1067
+ | `grain` | `amount` (0.08: the standard deviation at mid-grey, of full scale), `size` (px, 1.5), `seed` (0), `fps` (24: new grain this many times a second, 0 = still), `color` (0 = luminance only, 1 = per channel) | Film grain: seeded, new every 1/`fps` s, weighted to the mid-tones (it fades out toward black and white: blacks are not lifted, the mean brightness does not move), an integer hash so every GPU draws the same grain pattern (the 8-bit values agree to within 1/255). The grain is anchored to the filter's own frame: on a layer it moves with the layer, on the root it is fixed to the picture. On a layer or on the root `composition.filters`. A static pattern is `fps: 0`. Keyframe it by name: `'filters.g.amount'`. Grain eats video bitrate (see the guide) |
1037
1068
  | `alpha` | `alpha` | Whole-layer opacity (pixi.js) |
1038
1069
  | `colorMatrix` | `preset`: `'sepia' 'grayscale' 'negative' 'polaroid' 'technicolor' 'vintage' 'kodachrome' 'browni'`, or `matrix` (20 numbers) | Colour grade (pixi.js) |
1039
1070
  | `adjustment` | `gamma contrast saturation brightness red green blue alpha` (1 = unchanged) | Colour grading |
package/llms-full.txt CHANGED
@@ -15,7 +15,7 @@ You describe a video as a tree of plain objects; the library plays it in a canva
15
15
  1. **Start from `template.html`** (copy it; it also has the shared loader (`<div class="pe-loader" data-label="LOADING">` + `pixi-effects/loader.css`: HTML and CSS only, animating just `transform` / `opacity`, so it keeps moving while the page builds the video; `movie.init()` fades it out). Keep it; a loader of your own is fine (`pe-loader--custom`) as long as it only animates `transform` / `opacity`, never with JavaScript or `requestAnimationFrame`; it loads the library from a CDN, collects every console warning into `window.__logs`, and exposes `window.movie`). One HTML file, plain JS. Default canvas 1280×720 @ 30 fps.
16
16
  2. **Give the movie a poster time.** In `movie.init` add `poster: <seconds>`: the most striking moment (a title fully on screen, not the first frame, which is often black). The canvas shows that picture before play (the playhead stays at 0 and play starts from 0), and the check writes it as `poster.jpg`.
17
17
  3. **Write the composition as data.** Anything repeated (letters, bars, particles, scenes) is a JS function or loop that returns specs — never copy-paste objects. Derive coordinates and times from constants/data, not magic numbers.
18
- 4. **Show the human:** `node ai/tools/view.mjs my-video.html` opens their browser on the page with a scrubbable, zoomable timeline under it (click / drag to seek, + / − or Ctrl/⌘ + wheel to zoom) (`npx pixi-effects-view …` in an installed package); it keeps running until Ctrl-C. **Deliver the file:** `node ai/tools/render.mjs my-video.html -o my-video.mp4` (`npx pixi-effects-render …` in an installed package) renders the page headless to mp4 / webm / mov / mkv and exits 0 only when the file is written; run it AFTER the check below passes. **Run the check — one command does steps 3, 4 and the export:** `node ai/tools/check.mjs my-video.html` (Node ≥ 22 and Chrome installed; no npm install; in an installed package it is `npx pixi-effects-check my-video.html`). It starts its own private Chrome (nothing is shared with other sessions), waits for `window.__ready`, and writes `timeline.html` (every layer as a bar on a time axis: ◆ keyframes, shaded transitions; hand it to the human to open) and prints: console warnings, `movie.inspect` over the WHOLE timeline (grouped), `movie.inspectAudio()`, then exports an mp4 and decodes it again (video size and length, audio length, loudness per second, silence). It writes `check-out/<name>/sheet.png` — **open that picture and look at it** — plus the mp4 and `report.json`. Exit 0 = nothing to fix; exit 1 = a list of problems; fix them and run it again. Text that overlaps text is listed under `review` (not a failure: ghost layers, glow copies and per-letter boxes are often intentional; look at the sheet; `--strict` makes them fail). The manual steps below are for looking at one frame closely. The same judgement is in the page: `await movie.review({ at: 'title@end' })` returns `{ frames, problems, review, fonts, audio, at }` (what `check` prints, as data) and `movie.resolveAt('3.5, title@end')` turns moments into frames.
18
+ 4. **Show the human:** `node ai/tools/view.mjs my-video.html` opens their browser on the page with a scrubbable, zoomable timeline under it (click / drag to seek, + / − or Ctrl/⌘ + wheel to zoom) (`npx pixi-effects-view …` in an installed package); it keeps running until Ctrl-C. **Deliver the file:** `node ai/tools/render.mjs my-video.html -o my-video.mp4` (`npx pixi-effects-render …` in an installed package) renders the page headless to mp4 / webm / mov / mkv and exits 0 only when the file is written; run it AFTER the check below passes. **Run the check — one command does steps 3, 4 and the export:** `node ai/tools/check.mjs my-video.html` (Node ≥ 22 and Chrome installed; no npm install; in an installed package it is `npx pixi-effects-check my-video.html`). It starts its own private Chrome (nothing is shared with other sessions), waits for `window.__ready`, and writes `timeline.html` (every layer as a bar on a time axis: ◆ keyframes, shaded transitions; hand it to the human to open) and prints: console warnings, `movie.inspect` over the WHOLE timeline (grouped), `movie.inspectAudio()`, then exports an mp4 and decodes it again (video size and length, audio length, loudness per second, silence). It writes `check-out/<name>/sheet.png` — **open that picture and look at it** — plus the mp4 and `report.json`. Exit 0 = nothing to fix; exit 1 = a list of problems; fix them and run it again. A key a layer does not have (a typo in a layer key, a keyframe property or a text style key; `anchorX` outside `initial`; `pitch` outside `sfx`) is a warning that names the key and what you probably meant: treat it like any other warning. Text that overlaps text is listed under `review` (not a failure: ghost layers, glow copies and per-letter boxes are often intentional; look at the sheet; `--strict` makes them fail). The manual steps below are for looking at one frame closely. The same judgement is in the page: `await movie.review({ at: 'title@end' })` returns `{ frames, problems, review, fonts, audio, at }` (what `check` prints, as data) and `movie.resolveAt('3.5, title@end')` turns moments into frames.
19
19
  **Or by hand: run it and read the logs first.** `window.__ready` must be `true` and `window.__logs` should be `[]`. A pixi-effects warning is an instruction: fix what it names.
20
20
  5. **Look at it** — you cannot judge motion from code. The library has the tools built in:
21
21
  - `await movie.contactSheet({ count: 6, as: 'dataURL' })` → ONE image of several labelled frames (pass `frames: [...]` / `times: [...]` to choose; include the middle of every transition and the last second). Save it and view it.
@@ -105,7 +105,7 @@ blendMode: 'normal' | 'add' | 'screen' | 'multiply' // add / screen brighten (
105
105
 
106
106
  Animatable props (`initial` / keyframes): `x y alpha rotation scale scaleX scaleY pivotX pivotY anchorX anchorY skewX skewY tint width height visible autoAlpha`, plus for shapes their style/geometry, for text `fill`, for audio `volume`, for 3D `z rotationX rotationY`, filter params as `'filters.<name>.<param>'`, three objects as `'three.<obj>.<path>'`.
107
107
 
108
- Keyframe kinds: `set` (jump at `at`; undone when you seek back), `to` (animate to), `from` (animate from), `from`+`to`. `from` / `from+to` show their start value from the layer's start, so a delayed fade-in needs no `initial.alpha`. `repeat` (finite extra plays), `yoyo`, `repeatDelay` loop any of them (endless repeats are not allowed). `ease` = any GSAP ease (`'none'`, `'power2.out'`, `'expo.out'`, `'back.out(1.7)'`, `'elastic.out(1,0.5)'`, `'sine.inOut'`, `'bounce.out'`…). Default ease is linear.
108
+ Keyframe kinds: `set` (jump at `at`; undone when you seek back), `to` (animate to), `from` (animate from), `from`+`to`. `from` / `from+to` show their start value from the layer's start, so a delayed fade-in needs no `initial.alpha`. `repeat` (finite extra plays), `yoyo`, `repeatDelay` loop any of them (endless repeats are not allowed). `ease` = any GSAP ease (`'none'`, `'power2.out'`, `'expo.out'`, `'back.out(1.7)'`, `'elastic.out(1,0.5)'`, `'sine.inOut'`, `'bounce.out'`… and springs: `'spring(mass, stiffness, damping)'` or `'spring.gentle' | 'snappy' | 'bouncy' | 'wobbly' | 'slow'`; **`duration: 'auto'` = the time the spring takes to settle** (presets, settle time / highest value reached as a multiple of the target: `snappy` 0.42 s / 1.01, `gentle` 0.72 s / 1.02, `bouncy` 1.08 s / 1.28, `slow` 1.29 s / 1.00, `wobbly` 1.61 s / 1.40: time the next beat from these) (real physics; with a number `duration` is the settle time and only the damping ratio shapes it; a damping ratio of 1 or more never overshoots, so `spring(1,170,26)` does not bounce: use damping below 20 at stiffness 170; `'auto'` works on keyframes only, not in `animateText` / `orbit` tweens; a `stagger` ease may be a spring, its delays are held inside the spread). Default ease is linear.
109
109
 
110
110
  ## Layer types
111
111
 
@@ -117,7 +117,7 @@ Keyframe kinds: `set` (jump at `at`; undone when you seek back), `to` (animate t
117
117
 
118
118
  **audio** — a file: `asset`, `loop`, `volume`; `volume` (top level, or in `initial` like every other layer's starting values); fade with volume keyframes (`{ at: -2, to: { volume: 0 }, duration: 2 }` fades the last 2 s). Omit `duration` for a one-shot clip: it lasts exactly as long as the clip. With `loop: true` and no `duration` it lasts until the composition ends. An explicit `duration` longer than the clip goes silent after the clip unless `loop: true`.
119
119
  **Or a sound effect with no file — `sfx`:** `{ type: 'audio', sfx: 'swoosh', at: 2 }` is the whole thing. Presets, default length in s: `click` 0.04 · `pop` 0.12 · `swoosh` 0.5 (loudest 0.16 s in, moves left → right) · `swipe` 0.22 · `hit` 0.7 · `riser` 1 (loudest at its END: `at = hit − duration`) · `chime` 1.4 · `beep` 0.16 · `coin` 0.4 · `glitch` 0.35 · `typewriter` 0.06. Knobs: `sfx: { preset, pitch /* semitones ±24 */, brightness /* −1 dark … 1 bright */, seed /* another take */ }`. **The layer's `duration` IS the sound's length** (omit it; set it to stretch, e.g. a riser); `volume` is its level (1 = the preset's standard level, peaking at −12 … −18 dBFS by preset). No `loop`: one layer per hit (a JS loop). Custom sound: `sfx: { voices: [{ wave: 'noise' | 'sine' | 'square' | 'saw' | 'triangle', freq: 440 | [from, to], filter: { type: 'lowpass' | 'highpass' | 'bandpass', freq: [from, to] }, envelope: 'fall' | 'bell' | 'swell' | 'hold', pan: [-1, 1] }] }`. The export (mp4 / webm / mov) encodes this same mix (lossy AAC / Opus), on time within a few ms.
120
- **Or music with no file — `music`:** `{ type: 'audio', music: { bpm: 96, tracks: [{ inst: 'keys', notes: 'Cmaj7:4 Am7:4 Dm7:4 G7:4' }, { inst: 'bass', notes: 'c2:2 g1:2 …' }], drums: { kick: 'x...x...', snare: '....x...', hat: 'x.x.x.x.' } } }` — a tune written as text (notes `c4:2` in beats, chords `Am7` `C@4` `Am7/e`, `[c4 e4 g4]`, rest `_`, hold `~`, `!` accent; `|` ignored). Instruments `keys pluck pad bass sub lead bell musicbox`; drums `kick snare hat openhat clap rim tom crash shaker sleigh` as 16th-note step strings (`x` hit, `o` soft, `.` none; a list of `{ from, to, … }` for sections). Score options `bpm` (or `[[beat, bpm], …]` for a ritardando) `swing reverb humanize drumVol grid transpose tail seed`; track options `vol` (or `[[beat, level], …]` for a fade) `pan step strum legato tone reverb attack release ring transpose`. Lasts its notes + tail, ends with the movie, `loop: true` repeats; peaks −6 dBFS at `volume: 1`. `await musicEnvelope(music, { frameRate })` → an envelope for `react()`; `await musicBuffer(music)` → a Web Audio `AudioBuffer` to play yourself.
120
+ **Or music with no file — `music`:** `{ type: 'audio', music: { bpm: 96, tracks: [{ inst: 'keys', notes: 'Cmaj7:4 Am7:4 Dm7:4 G7:4' }, { inst: 'bass', notes: 'c2:2 g1:2 …' }], drums: { kick: 'x...x...', snare: '....x...', hat: 'x.x.x.x.' } } }` — a tune written as text (notes `c4:2` in beats, chords `Am7` `C@4` `Am7/e`, `[c4 e4 g4]`, rest `_`, hold `~`, `!` accent; `|` ignored). Instruments `keys pluck pad bass sub lead bell musicbox`; drums `kick snare hat openhat clap rim tom crash shaker sleigh` as 16th-note step strings (`x` hit, `o` soft, `.` none; a list of `{ from, to, … }` for sections). Score options `bpm` (or `[[beat, bpm], …]` for a ritardando) `swing reverb (0–0.6) humanize drumVol grid transpose tail seed`; track options `vol` (or `[[beat, level], …]` for a fade) `pan step strum legato tone reverb attack release ring transpose`. Lasts its notes + tail, ends with the movie, `loop: true` repeats; peaks −6 dBFS at `volume: 1`. `await musicEnvelope(music, { frameRate })` → an envelope for `react()`; `await musicBuffer(music)` → a Web Audio `AudioBuffer` to play yourself.
121
121
 
122
122
  **shape** — `shape: 'rect' | 'circle' | 'ellipse' | 'arc' | 'line' | 'polygon' | 'path'`:
123
123
 
@@ -133,7 +133,7 @@ Keyframe kinds: `set` (jump at `at`; undone when you seek back), `to` (animate t
133
133
 
134
134
  **Draw-on:** every shape but `arc` has `trimStart` / `trimEnd` (0–1 of the outline, default 0 / 1, animatable): `trimEnd: 0` + keyframe `to: { trimEnd: 1 }` draws a line / border / path on; `trimStart` 0 → 1 after it wipes it off; both = a travelling dash. The fill is NOT trimmed. Rect outline starts top-left, circle / ellipse at 12 o'clock, both clockwise. A `path` with several sub-paths walks them in order as one length; `trimEach: true` trims each on its own (all draw on together). Use `strokeCap: 'round'`.
135
135
 
136
- Style (`initial` / keyframes): `fillColor fillAlpha strokeColor strokeAlpha strokeWidth`; `colorSpace: 'oklab'|'oklch'` for clean colour tweens. rect/circle/ellipse are **centred on `x,y` by default** (`anchorX/anchorY` default 0.5): for a bar growing from its base use `anchorY: 1` (or `anchorX: 0` for left-to-right). **`fillGradient`** (top level or `initial`; instead of `fillColor`): `{ type?: 'linear'|'radial', stops: [[0, '#000'], [1, 'rgba(0,0,0,.6)']], angle? /* linear, deg, 90 = top→bottom */, center?, innerRadius?, radius? /* radial, 0–1 of bounds */ }` — stops may have alpha, so a radial transparent→dark is a vignette. Stroke ends and corners: `strokeCap: 'butt'|'round'|'square'`, `strokeJoin: 'miter'|'round'|'bevel'` (top level or in `initial`; not animated — `round` keeps sharp corners like an M from poking out).
136
+ Style (`initial` / keyframes): `fillColor fillAlpha strokeColor strokeAlpha strokeWidth`; `colorSpace: 'oklab'|'oklch'` for clean colour tweens. rect/circle/ellipse are **centred on `x,y` by default** (`anchorX/anchorY` default 0.5): for a bar growing from its base use `anchorY: 1` (or `anchorX: 0` for left-to-right). **`fillGradient`** (top level or `initial`; instead of `fillColor`): `{ type?: 'linear'|'radial', stops: [[0, '#000'], [1, 'rgba(0,0,0,.6)']], angle? /* linear, deg, 90 = top→bottom */, center?, innerRadius?, radius? /* radial, 0–1 of the SHAPE's own bounds, not the canvas: a glow on a 1500 px circle is placed with fractions of that circle */ }` — stops may have alpha, so a radial transparent→dark is a vignette. **Animate it** with a partial gradient in a keyframe (`to: { fillGradient: { angle: 360, stops: [...] } }`: keys you leave out stay; the same number of stops; `type` cannot change; a start gradient is required; use `colorSpace: 'oklch'` for a vivid fade). A text layer takes `fillGradient` too (LINEAR only: angle and stops; type / center / radius are ignored with a warning; letters re-rasterised per change). `from` alone runs from that gradient to the layer's own. The names `'fillGradient.angle'` / `gradientAngle` are not properties: write `fillGradient: { angle }`. Stroke ends and corners: `strokeCap: 'butt'|'round'|'square'`, `strokeJoin: 'miter'|'round'|'bevel'` (top level or in `initial`; not animated — `round` keeps sharp corners like an M from poking out).
137
137
 
138
138
  **composition** — `width height duration sequences transitions`. With `threeD: true` it is a **card**: its children are drawn into one texture (content outside its `width × height` is clipped: size it for a soft shadow too; a plain 2D composition does not clip, but is skipped when its whole rectangle is off screen) and move / rotate in depth together. Children use the composition's local coordinates and times. Position/rotate/scale it as a unit; to rotate/scale about its centre set `pivotX/pivotY` to the centre and `x/y` to where that point should sit.
139
139
 
@@ -161,7 +161,7 @@ Add `threeD: true` to any visual layer, then use `z`, `rotationX`, `rotationY` (
161
161
 
162
162
  ## Filters by name (no import)
163
163
 
164
- `filters: [{ type: 'glow', name: 'halo', outerStrength: 3, color: '#ffd166' }]` — `type` = the pixi / pixi-filters class name without `Filter`, camelCase (`glow dropShadow outline blur noise alpha adjustment hslAdjustment grayscale pixelate crt rgbSplit oldFilm glitch bulgePinch twist zoomBlur kawaseBlur radialBlur motionBlur emboss ascii colorOverlay advancedBloom bevel dot crossHatch tiltShift …`), the other keys are its options. `colorMatrix` takes `preset: 'sepia'|'grayscale'|'negative'|'polaroid'|'technicolor'|'vintage'|'kodachrome'|'browni'`. Name it to animate: `'filters.halo.outerStrength'` (scalars only; `pixelate` via `sizeX`/`sizeY`). Options: `glow` distance outerStrength innerStrength color alpha · `dropShadow` offset{x,y} blur alpha color · `outline` thickness color · `blur` strength · `adjustment` gamma contrast saturation brightness · `hslAdjustment` hue lightness saturation · `pixelate` size · `crt` curvature lineWidth noise vignetting · `rgbSplit` red/green/blue {x,y} · `oldFilm` sepia noise scratch vignetting · `glitch` slices offset · `twist` radius angle offset · `bulgePinch` center radius strength · `zoomBlur` strength center innerRadius · `colorOverlay` color alpha · `colorGradient` gradientType('linear'|'radial'|'conic') stops[{offset,color,alpha}] angle · `colorReplace` originalColor targetColor tolerance · `convolution` matrix(9) · `shockwave` / `godray` are driven by `time` (animate it) · `colorMap` / `simpleLightmap` need a texture (use `custom`). **Centres/offsets are CANVAS pixels** (default top-left corner): put them on the layer. Glow / shadow / blur draw outside the layer: widen `filterArea` (not for `grayscale` / `oldFilm`, which fill the margin black). Full table: `docs/dsl.md` → Named filters.
164
+ `filters: [{ type: 'glow', name: 'halo', outerStrength: 3, color: '#ffd166' }]` — `type` = the pixi / pixi-filters class name without `Filter`, camelCase, or this library's own **`grain`** (film grain: `{ type: 'grain', amount: 0.08, size: 1.5, seed: 0, fps: 24, color: 0 }`, seeded, new every 1/fps s, mid-tone weighted, same grain pattern on every GPU (values within 1/255), anchored to the filter's frame (it moves with a layer), no pixi-filters needed; on a layer or on `composition.filters`; it costs video bitrate; `noise` is NOT film grain: it is frozen and lifts blacks) (`glow dropShadow outline blur noise alpha adjustment hslAdjustment grayscale pixelate crt rgbSplit oldFilm glitch bulgePinch twist zoomBlur kawaseBlur radialBlur motionBlur emboss ascii colorOverlay advancedBloom bevel dot crossHatch tiltShift …`), the other keys are its options. `colorMatrix` takes `preset: 'sepia'|'grayscale'|'negative'|'polaroid'|'technicolor'|'vintage'|'kodachrome'|'browni'`. Name it to animate: `'filters.halo.outerStrength'` (scalars only; `pixelate` via `sizeX`/`sizeY`). Options: `glow` distance outerStrength innerStrength color alpha · `dropShadow` offset{x,y} blur alpha color · `outline` thickness color · `blur` strength · `adjustment` gamma contrast saturation brightness · `hslAdjustment` hue lightness saturation · `pixelate` size · `crt` curvature lineWidth noise vignetting · `rgbSplit` red/green/blue {x,y} · `oldFilm` sepia noise scratch vignetting · `glitch` slices offset · `twist` radius angle offset · `bulgePinch` center radius strength · `zoomBlur` strength center innerRadius · `colorOverlay` color alpha · `colorGradient` gradientType('linear'|'radial'|'conic') stops[{offset,color,alpha}] angle · `colorReplace` originalColor targetColor tolerance · `convolution` matrix(9) · `shockwave` / `godray` are driven by `time` (animate it) · `colorMap` / `simpleLightmap` need a texture (use `custom`). **Centres/offsets are CANVAS pixels** (default top-left corner): put them on the layer. Glow / shadow / blur draw outside the layer: widen `filterArea` (not for `grayscale` / `oldFilm`, which fill the margin black). Full table: `docs/dsl.md` → Named filters.
165
165
 
166
166
  ## Transitions (on the parent composition)
167
167
 
@@ -211,7 +211,7 @@ measureText('Hello', style) // → { width, height,
211
211
  splitText('Hello world', style, { by: 'chars' | 'words' | 'lines', x, y, align: 'left' | 'center' | 'right' })
212
212
  // → [{ text, x, y, width, index, line }] — one text layer per piece, same style, anchor top-left
213
213
  ```
214
- Per-letter / per-word / per-line animation in one call: `...animateText(text, style, { x, y, align, by: 'chars'|'words'|'lines', at, duration /* required: until the last piece is gone */, in: 'rise'|'drop'|'fade'|'pop'|'zoom'|'slide'|'spin'|{ from, to, duration, ease }|false, out: <same, runs in the same wave>, stagger: { each, from, … }, idle: { y: 4, rotation: 1 }, styleFor: p => ({ fill }) })` → text layers `<name>-0…` (anchor centre; `x`/`y` in `from` are offsets) to spread into `sequences`. **`x` / `y` are pixel NUMBERS (an expression like `'GW/2'` throws: compute `W / 2`), and `y` is the TOP of the line box**: the visible text is centred `lineHeight / 2` below it, so an underline goes at `y + lineHeight`, not at `y` (recipe `animate-text`). By hand: `splitText(...)` + one layer per piece (recipe `split-text`). A web font must be loaded before measuring.
214
+ Per-letter / per-word / per-line animation in one call: `...animateText(text, style, { x, y, align, by: 'chars'|'words'|'lines', at, duration /* required: until the last piece is gone */, in: 'rise'|'drop'|'fade'|'pop'|'zoom'|'slide'|'spin'|{ from, to, duration, ease }|false, out: <same, runs in the same wave BACKWARDS FROM THE LAYER'S END (at + duration): it has no `at`; to be gone at time T set duration = T − at>, stagger: { each, from, … }, idle: { y: 4, rotation: 1 }, styleFor: p => ({ fill }) })` → text layers `<name>-0…` (anchor centre; `x`/`y` in `from` are offsets) to spread into `sequences`. **`x` / `y` are pixel NUMBERS (an expression like `'GW/2'` throws: compute `W / 2`), and `y` is the TOP of the line box**: the visible text is centred `lineHeight / 2` below it, so an underline goes at `y + lineHeight`, not at `y` (recipe `animate-text`). By hand: `splitText(...)` + one layer per piece (recipe `split-text`). A web font must be loaded before measuring.
215
215
 
216
216
  ## Assets
217
217
 
@@ -334,6 +334,11 @@ A good habit that catches most of these: after `init`, read `window.__logs` (see
334
334
  61. **Music is a bed: `volume` 0.5–0.8 under speech or sfx.** At `volume: 1` it peaks at −6 dBFS (an sfx peaks at −12). A layer shorter than the music cuts it with a fade; longer is silent after it unless `loop: true`. Do not also add an mp3 bed.
335
335
  62. **Chord names are voiced close around octave 3**: use `[c3 g3 e4]` for an exact voicing or `Am7/e` for a bass note; `swing` only moves notes that start on an off-beat eighth (`.5`) or sixteenth (`.75`); the bell and music box ring for `ring` seconds whatever the written length (shorten `ring` for fast bell lines); the synth is a handy bed, not an orchestra: keep tracks to 3–6, vary the bars, and end on the tonic.
336
336
  63. **`animateText()` / `splitText()`: `x` and `y` are pixel numbers, and `y` is the TOP of the line.** An expression such as `x: 'GW/2'` throws (the letters are measured once, at build time): write `x: W / 2`. The pieces are centred half a line below `y`, so a line drawn under the text goes at `y + lineHeight` (about 1.2 × `fontSize`), not at `y`; look at the contact sheet, the layout check cannot see an underline through a word. (`check` writes into `check-out/` of the current folder unless you pass `--out`.)
337
+ 64. **`animateText()`: `out` leaves from the END of the layer and has no `at`.** `out: { preset: 'fade', at: 7.6 }` does not make the text leave at 7.6 s: `at` is ignored (now with a warning) and the text stays until `at + duration`. To be gone at time T, set `duration: T − at` (title at 0.4 s that must be gone by 8.0 s: `duration: 7.6`). The same holds for a hand-written exit keyframe: a negative `at` counts back from the end of its own layer, a positive one from the start of its own layer, never from the movie.
338
+ 65. **A spring that does not spring, and `'auto'` that is not a spring.** `spring(1,170,26)` is critically damped (damping ratio 1): it never overshoots; at stiffness 170 use damping below 20 (`spring(1, 170, 12)`), or pick a preset (`spring.bouncy`, `spring.wobbly`). With a number `duration`, that number is the settle time (mass and stiffness only matter with `duration: 'auto'`). `duration: 'auto'` needs a spring ease (otherwise it warns and uses 0.5 s) and is for keyframes, not for `animateText` / `orbit` tweens. A colour that overshoots is clamped in its colour space; `alpha` past 1 shows nothing.
339
+ 66. **Animating a gradient: one `fillGradient` object, partial, in the keyframe.** `to: { fillGradient: { angle: 360, stops: [...] } }` (keys you leave out stay). Not `'fillGradient.angle'`, not `gradientAngle`, not `fillGradient: 'red'` (each warns once with what to write). The layer must start with a `fillGradient`; `stops` keep their count; `type` cannot change. A fade between two colours in the default `rgb` passes through grey (green → magenta): set `colorSpace: 'oklch'`. Under a mask the stops still span the whole shape (see 39).
340
+ 67. **A key the layer does not have is warned about now (it used to be ignored in silence).** `{ type: 'text', anchorX: 0.5 }` (anchors go in `initial`), `{ type: 'audio', sfx: 'click', pitch: 3 }` (the knob goes inside: `sfx: { preset: 'click', pitch: 3 }`), `{ type: 'shape', shape: 'rect', radius: 5 }` (that is a circle's key; a rect has `cornerRadius`), a mistyped property in a keyframe (`alhpa`), a mistyped text `style` key. The warning names the key, the kind of layer and what was probably meant; fix the key, do not silence the warning. Three gallery pieces had the `pitch` mistake for months: their sound effects were never pitched.
341
+ 68. **A pitched sfx keeps its own length; a radial gradient is placed in the shape's bounds.** `sfx: { preset: 'chime', pitch: -5 }` lasts as long as the sound does, so near the end of the movie give the layer a `duration` that ends with it (`inspectAudio()` reports a sound cut off by the end). A radial `fillGradient`'s `center` / `radius` are fractions of the SHAPE, not the canvas: for a glow on a big circle, convert canvas pixels to fractions of the circle. `music.reverb` is 0–0.6.
337
342
 
338
343
 
339
344
  <!-- ===== ai/reference/recipes.md ===== -->
@@ -407,6 +412,32 @@ return [
407
412
 
408
413
  ---
409
414
 
415
+ ## Pop in with a spring: a card that lands, a badge that bounces
416
+
417
+ A spring overshoots and settles: `duration: 'auto'` lets the physics set the length, a preset names the feel (`spring.gentle`, `snappy`, `bouncy`, `wobbly`, `slow`). Different presets on one layer's properties read as different materials.
418
+
419
+ ```js
420
+ // @recipe spring-pop
421
+ const card = { type: 'shape', shape: 'rect', name: 'card', width: 520, height: 300, cornerRadius: 28, at: 0.3, duration: 3.7,
422
+ initial: { x: 640, y: 360, fillColor: '#f4f1ea', scale: 0.4, alpha: 0 },
423
+ keyframes: [
424
+ { at: 0, to: { scale: 1 }, duration: 'auto', ease: 'spring.snappy' },
425
+ { at: 0, to: { alpha: 1 }, duration: 0.2 },
426
+ ] };
427
+ const badge = { type: 'shape', shape: 'circle', name: 'badge', radius: 46, at: 1.0, duration: 3,
428
+ initial: { x: 860, y: 230, fillColor: '#e63946', scale: 0 },
429
+ keyframes: [{ at: 0, to: { scale: 1 }, duration: 'auto', ease: 'spring.bouncy' }] };
430
+ const title = { type: 'text', text: 'Hello', name: 'title', at: 0.5, duration: 3.5, style: { fontSize: 88, fontWeight: 'bold', fill: '#1d3557' },
431
+ initial: { x: 640, y: 380, anchorX: 0.5, anchorY: 0.5 },
432
+ keyframes: [{ at: 0, from: { y: 440, alpha: 0 }, to: { y: 380, alpha: 1 }, duration: 'auto', ease: 'spring(1, 170, 12)' }] };
433
+ return [
434
+ { type: 'shape', shape: 'rect', width: 'GW', height: 'GH', initial: { x: 'GW/2', y: 'GH/2', fillColor: '#1d3557' } },
435
+ card, badge, title,
436
+ ];
437
+ ```
438
+
439
+ ---
440
+
410
441
  ## A ticker that scrolls out completely (`w` = the text's own width)
411
442
 
412
443
  `'-w'` is the exact x at which the text has left the screen on the left (`w` is measured after the style is applied).
@@ -1057,6 +1088,45 @@ return [
1057
1088
 
1058
1089
  ---
1059
1090
 
1091
+ ## A gradient that moves (a turning fade, a drifting glow, letters that change colour)
1092
+
1093
+ A keyframe's `fillGradient` is partial: write only what moves. `colorSpace: 'oklch'` keeps the fade vivid.
1094
+
1095
+ ```js
1096
+ // @recipe gradient-shift
1097
+ return [
1098
+ { type: 'shape', shape: 'rect', width: 'GW', height: 'GH', colorSpace: 'oklch', initial: { x: 'GW/2', y: 'GH/2' },
1099
+ fillGradient: { angle: 20, stops: [[0, '#1b2a6b'], [1, '#7b3fe4']] },
1100
+ keyframes: [{ at: 0, duration: 4, ease: 'sine.inOut', to: { fillGradient: { angle: 200, stops: [[0, '#7b3fe4'], [1, '#ff6a88']] } } }] },
1101
+ { type: 'shape', shape: 'circle', radius: 260, initial: { x: 'GW/2', y: 'GH/2' },
1102
+ fillGradient: { type: 'radial', center: [0.2, 0.2], radius: 0.3, stops: [[0, 'rgba(255,255,255,0.9)'], [1, 'rgba(255,255,255,0)']] },
1103
+ keyframes: [{ at: 0, duration: 4, ease: 'sine.inOut', to: { fillGradient: { center: [0.8, 0.8], radius: 0.6 } } }] },
1104
+ { type: 'text', text: 'SHIFT', name: 'title', style: { fontSize: 220, fontWeight: '900' }, colorSpace: 'oklch',
1105
+ initial: { x: 'GW/2', y: 'GH/2', anchorX: 0.5, anchorY: 0.5 },
1106
+ fillGradient: { angle: 0, stops: [[0, '#ffd60a'], [1, '#22c55e']] },
1107
+ keyframes: [{ at: 0, duration: 4, to: { fillGradient: { angle: 180, stops: [[0, '#00e5ff'], [1, '#ff2d55']] } } }] },
1108
+ ];
1109
+ ```
1110
+
1111
+ ---
1112
+
1113
+ ## Film grain over the whole picture
1114
+
1115
+ `grain` is seeded, new every 1/`fps` s (24 by default), mid-tone weighted and the same on every GPU. Put it on the root `filters` for the film look, or on one layer. (`noise` is not grain: it is frozen and lifts blacks.) It costs video bitrate.
1116
+
1117
+ ```js
1118
+ // @recipe film-grain
1119
+ // the scene is wrapped in a composition layer that carries the filter (on a whole movie, put the same filter in `composition: { filters: [...] }`)
1120
+ const scene = [
1121
+ { type: 'shape', shape: 'rect', width: 'GW', height: 'GH', initial: { x: 'GW/2', y: 'GH/2', fillColor: '#3a4a6b' } },
1122
+ { type: 'text', text: 'FILM', name: 'title', at: 0.3, duration: 3.7, style: { fontSize: 200, fontWeight: '900', fill: '#f4f1ea' },
1123
+ initial: { x: 'GW/2', y: 'GH/2', anchorX: 0.5, anchorY: 0.5, alpha: 0 }, keyframes: [{ at: 0, to: { alpha: 1 }, duration: 0.8 }] },
1124
+ ];
1125
+ return [{ type: 'composition', name: 'film', width: 'GW', height: 'GH', sequences: scene, filters: [{ type: 'grain', name: 'g', amount: 0.06, size: 2, color: 0.2 }] }];
1126
+ ```
1127
+
1128
+ ---
1129
+
1060
1130
  ## Generated placeholder images (no photos available)
1061
1131
 
1062
1132
  Draw on a canvas and register `canvas.toDataURL()` as an asset (`data:` URLs work). Make the image at least canvas-sized (1920×1080 for a 1280×720 movie) so `kenBurns` zooms stay sharp.
@@ -1540,7 +1610,7 @@ Colour keys (`fillColor`, `strokeColor`) tween smoothly between hues — no snap
1540
1610
 
1541
1611
  #### `fillGradient`
1542
1612
 
1543
- Fill a shape with a gradient instead of `fillColor` (top level or in `initial`). Positions are in 0–1 of the shape's own bounds, so the gradient follows the shape's size. Colours may carry alpha, so a radial gradient from transparent to dark is a vignette. Not animatable.
1613
+ Fill a shape with a gradient instead of `fillColor` (top level or in `initial`). Positions are in 0–1 of the shape's own bounds, so the gradient follows the shape's size. Colours may carry alpha, so a radial gradient from transparent to dark is a vignette. Animatable (below), on shapes and on text.
1544
1614
 
1545
1615
  ```ts
1546
1616
  { type: 'shape', shape: 'rect', width: 'GW', height: 'GH', initial: { x: 'GW/2', y: 'GH/2' },
@@ -1549,6 +1619,17 @@ Fill a shape with a gradient instead of `fillColor` (top level or in `initial`).
1549
1619
  { ..., fillGradient: { type: 'radial', radius: 0.75, stops: [[0.45, 'rgba(0,0,0,0)'], [1, 'rgba(0,0,0,0.7)']] } } // vignette
1550
1620
  ```
1551
1621
 
1622
+ **Animating a gradient.** A keyframe's `set` / `from` / `to` takes a **partial** `fillGradient` (`angle`, `center`, `innerRadius`, `radius`, `stops`); what you leave out stays as it is. Numbers move linearly; the stop colours move through the layer's `colorSpace` (`'oklch'` keeps a fade vivid: in `'rgb'`, green to magenta passes through grey). The layer needs a starting `fillGradient` (top level or in `initial`), `stops` must keep the same count, and `type` cannot change (linear ↔ radial). A mistake (a mistyped key, another number of stops, `'fillGradient.angle'` or `gradientAngle` instead of `fillGradient: { angle }`) is said once, when the layer is built. A text layer takes a `fillGradient` for its letters too, **linear only** (`angle` and `stops` apply; `type`, `center`, `innerRadius` and `radius` are ignored, with a warning: use a shape for a radial gradient); the letters are re-rasterised on every change. A keyframe with only `from` runs from that gradient to the layer's own.
1623
+
1624
+ ```ts
1625
+ { type: 'shape', shape: 'rect', width: 560, height: 420, initial: { x: 520, y: 540 }, colorSpace: 'oklch',
1626
+ fillGradient: { angle: 0, stops: [[0, '#ff2d55'], [1, '#0ea5e9']] },
1627
+ keyframes: [{ at: 0, duration: 2, to: { fillGradient: { angle: 360, stops: [[0, '#00e5ff'], [1, '#ffd60a']] } } }] }
1628
+ { type: 'text', text: 'GRADIENT', style: { fontSize: 200, fontWeight: '900' }, initial: { x: 640, y: 360, anchorX: 0.5, anchorY: 0.5 },
1629
+ fillGradient: { angle: 0, stops: [[0, '#ff2d55'], [1, '#0ea5e9']] },
1630
+ keyframes: [{ at: 0, duration: 2, to: { fillGradient: { angle: 180 } } }] }
1631
+ ```
1632
+
1552
1633
  | Field | Notes |
1553
1634
  |---|---|
1554
1635
  | `type` | `'linear'` (default) or `'radial'` |
@@ -1886,8 +1967,8 @@ Supported formats are whatever PixiJS Assets and the browser's audio/video decod
1886
1967
  ```ts
1887
1968
  interface Keyframe {
1888
1969
  at?: number; // start, in seconds from the start of THIS sequence; negative = back from the sequence's end (-0.5 = 0.5 s before it ends)
1889
- duration?: number; // seconds (default 0 — instantaneous)
1890
- ease?: string; // GSAP easing name (default 'none')
1970
+ duration?: number | 'auto'; // seconds (default 0 — instantaneous); 'auto' = the time a spring ease takes to settle
1971
+ ease?: string; // GSAP easing name (default 'none'), or a spring: 'spring(mass, stiffness, damping)', 'spring.gentle|snappy|bouncy|wobbly|slow'
1891
1972
  set?: Props; // jump to these values at `at`
1892
1973
  to?: Props; // animate from current to these values over `duration`
1893
1974
  from?: Props; // animate from these values to current
@@ -1902,6 +1983,25 @@ The four kinds are mutually exclusive per keyframe:
1902
1983
  - **`from`** — tween from the given values back to the current property, over `duration`.
1903
1984
  - **`from` + `to`** — full fromTo tween, with explicit start and end values.
1904
1985
 
1986
+ ### Springs
1987
+
1988
+ The ease `'spring(mass, stiffness, damping)'` (defaults 1, 100, 10) or a preset (`spring.gentle`, `spring.snappy`, `spring.bouncy`, `spring.wobbly`, `spring.slow`) moves a value as a damped spring would: it overshoots its target and rings, then rests. `duration: 'auto'` gives the keyframe the time the spring needs to settle (within 0.5 %), so mass and stiffness are real physics; with a number, `duration` is that settle time and only the damping ratio `damping / (2 √(stiffness × mass))` shapes the motion (below 1 it overshoots, 1 or more it does not: `spring(1, 170, 26)` does not bounce, `spring(1, 170, 12)` does).
1989
+
1990
+ ```ts
1991
+ { at: 0.2, from: { y: -200 }, to: { y: 0 }, duration: 'auto', ease: 'spring.bouncy' }
1992
+ { at: 0, to: { scale: 1 }, duration: 0.8, ease: 'spring(1, 170, 12)' }
1993
+ ```
1994
+
1995
+ | Preset | Settles in | Highest value (target = 1) |
1996
+ |---|---|---|
1997
+ | `spring.snappy` | 0.42 s | 1.01 |
1998
+ | `spring.gentle` | 0.72 s | 1.02 |
1999
+ | `spring.bouncy` | 1.08 s | 1.28 |
2000
+ | `spring.slow` | 1.29 s | 1.00 (no overshoot) |
2001
+ | `spring.wobbly` | 1.61 s | 1.40 |
2002
+
2003
+ A colour is clamped in its colour space when it overshoots, and `alpha` past 1 is not visible. `'auto'` is for keyframes: `animateText` / `orbit` tweens take a spring name but a number `duration`. A malformed spring (`spring(1, 170`, `spring.floppy`) is reported once, with what is wrong.
2004
+
1905
2005
  ### Repeating
1906
2006
 
1907
2007
  `repeat` (extra plays, a finite whole number), `yoyo` (every other play runs backwards) and `repeatDelay` (seconds between plays) work on every kind of animation — position, alpha, colour, shape geometry, filters, text `fill`/`value`:
@@ -2201,12 +2301,13 @@ A filter by name, as plain data. `type` is the filter's class name without `Filt
2201
2301
  keyframes: [{ at: 0, to: { 'filters.halo.outerStrength': 6 }, duration: 1 }] } // animate any scalar option by name
2202
2302
  ```
2203
2303
 
2204
- Name a filter (`name: 'halo'`) to animate it with `'filters.halo.<option>'`. `blur`, `noise`, `alpha` and `colorMatrix` come from pixi.js. All the others come from the **`pixi-filters`** package, which is loaded the first time a layer uses one (add `"pixi-filters": "https://esm.sh/pixi-filters@6.1.5?external=pixi.js"` to the import map, or `npm i pixi-filters`; `ai/template.html` already has it). A misspelt type says what you probably meant. Rendering and exporting were verified in a real browser for 40 of them (`examples/_checks/named-filters.html` and `named-filters-2.html`); `colorMap` and `simpleLightmap` need a texture, which JSON cannot hold, so use `custom` for those two:
2304
+ Name a filter (`name: 'halo'`) to animate it with `'filters.halo.<option>'`. `blur`, `noise`, `alpha`, `colorMatrix` and `grain` need no extra package (`grain` is this library's own). All the others come from the **`pixi-filters`** package, which is loaded the first time a layer uses one (add `"pixi-filters": "https://esm.sh/pixi-filters@6.1.5?external=pixi.js"` to the import map, or `npm i pixi-filters`; `ai/template.html` already has it). A misspelt type says what you probably meant. Rendering and exporting were verified in a real browser for 40 of them (`examples/_checks/named-filters.html` and `named-filters-2.html`); `colorMap` and `simpleLightmap` need a texture, which JSON cannot hold, so use `custom` for those two:
2205
2305
 
2206
2306
  | `type` | Options (the useful ones) | What it does |
2207
2307
  |---|---|---|
2208
2308
  | `blur` | `strength`, `quality` | Gaussian blur (pixi.js) |
2209
- | `noise` | `noise` (0–1), `seed` | Film grain (pixi.js) |
2309
+ | `noise` | `noise` (0–1), `seed` | Uniform noise (pixi.js): one frozen pattern (the seed is random unless you give it), the same strength at every tone, it lifts blacks. For film grain use `grain` |
2310
+ | `grain` | `amount` (0.08: the standard deviation at mid-grey, of full scale), `size` (px, 1.5), `seed` (0), `fps` (24: new grain this many times a second, 0 = still), `color` (0 = luminance only, 1 = per channel) | Film grain: seeded, new every 1/`fps` s, weighted to the mid-tones (it fades out toward black and white: blacks are not lifted, the mean brightness does not move), an integer hash so every GPU draws the same grain pattern (the 8-bit values agree to within 1/255). The grain is anchored to the filter's own frame: on a layer it moves with the layer, on the root it is fixed to the picture. On a layer or on the root `composition.filters`. A static pattern is `fps: 0`. Keyframe it by name: `'filters.g.amount'`. Grain eats video bitrate (see the guide) |
2210
2311
  | `alpha` | `alpha` | Whole-layer opacity (pixi.js) |
2211
2312
  | `colorMatrix` | `preset`: `'sepia' 'grayscale' 'negative' 'polaroid' 'technicolor' 'vintage' 'kodachrome' 'browni'`, or `matrix` (20 numbers) | Colour grade (pixi.js) |
2212
2313
  | `adjustment` | `gamma contrast saturation brightness red green blue alpha` (1 = unchanged) | Colour grading |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pixi-effects",
3
- "version": "0.18.0",
3
+ "version": "0.19.0",
4
4
  "description": "Declarative composition and video rendering for the web. Built on PixiJS v8.",
5
5
  "type": "module",
6
6
  "exports": {
@@ -1,14 +0,0 @@
1
- 'use strict';
2
-
3
- var chunkJW67MDHQ_cjs = require('./chunk-JW67MDHQ.cjs');
4
- require('./chunk-ANO5R2E6.cjs');
5
- require('./chunk-UQBGW5DO.cjs');
6
-
7
-
8
-
9
- Object.defineProperty(exports, "CompositionSequence", {
10
- enumerable: true,
11
- get: function () { return chunkJW67MDHQ_cjs.CompositionSequence; }
12
- });
13
- //# sourceMappingURL=Composition-6JMXWNVV.cjs.map
14
- //# sourceMappingURL=Composition-6JMXWNVV.cjs.map
@@ -1,5 +0,0 @@
1
- export { CompositionSequence } from './chunk-UXDR3ZDU.js';
2
- import './chunk-SG3Y66FN.js';
3
- import './chunk-DKGG7WD4.js';
4
- //# sourceMappingURL=Composition-MLBHYYFF.js.map
5
- //# sourceMappingURL=Composition-MLBHYYFF.js.map