pixi-effects 0.42.0 → 0.44.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkWVZLAIKK_cjs = require('./chunk-WVZLAIKK.cjs');
+var chunkMAAM45ZX_cjs = require('./chunk-MAAM45ZX.cjs');
 require('./chunk-3HZV3UHU.cjs');
 var chunkX62H3RBG_cjs = require('./chunk-X62H3RBG.cjs');
 var chunkLQDDDIC4_cjs = require('./chunk-LQDDDIC4.cjs');
@@ -12,99 +12,99 @@ var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 
 Object.defineProperty(exports, "Movie", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.Movie; }
+  get: function () { return chunkMAAM45ZX_cjs.Movie; }
 });
 Object.defineProperty(exports, "animateText", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.animateText; }
+  get: function () { return chunkMAAM45ZX_cjs.animateText; }
 });
 Object.defineProperty(exports, "audioEnvelope", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.audioEnvelope; }
+  get: function () { return chunkMAAM45ZX_cjs.audioEnvelope; }
 });
 Object.defineProperty(exports, "bpmEnvelope", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.bpmEnvelope; }
+  get: function () { return chunkMAAM45ZX_cjs.bpmEnvelope; }
 });
 Object.defineProperty(exports, "cameraPath", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.cameraPath; }
+  get: function () { return chunkMAAM45ZX_cjs.cameraPath; }
 });
 Object.defineProperty(exports, "computeEnvelope", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.computeEnvelope; }
+  get: function () { return chunkMAAM45ZX_cjs.computeEnvelope; }
 });
 Object.defineProperty(exports, "dismissLoader", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.dismissLoader; }
+  get: function () { return chunkMAAM45ZX_cjs.dismissLoader; }
 });
 Object.defineProperty(exports, "ease", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.parseEase; }
+  get: function () { return chunkMAAM45ZX_cjs.parseEase; }
 });
 Object.defineProperty(exports, "failLoader", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.failLoader; }
+  get: function () { return chunkMAAM45ZX_cjs.failLoader; }
 });
 Object.defineProperty(exports, "followPath", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.followPath; }
+  get: function () { return chunkMAAM45ZX_cjs.followPath; }
 });
 Object.defineProperty(exports, "kenBurns", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.kenBurns; }
+  get: function () { return chunkMAAM45ZX_cjs.kenBurns; }
 });
 Object.defineProperty(exports, "measureText", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.measureText; }
+  get: function () { return chunkMAAM45ZX_cjs.measureText; }
 });
 Object.defineProperty(exports, "musicBuffer", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.musicBuffer; }
+  get: function () { return chunkMAAM45ZX_cjs.musicBuffer; }
 });
 Object.defineProperty(exports, "musicEnvelope", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.musicEnvelope; }
+  get: function () { return chunkMAAM45ZX_cjs.musicEnvelope; }
 });
 Object.defineProperty(exports, "musicEvents", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.musicEvents; }
+  get: function () { return chunkMAAM45ZX_cjs.musicEvents; }
 });
 Object.defineProperty(exports, "orbit", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.orbit; }
+  get: function () { return chunkMAAM45ZX_cjs.orbit; }
 });
 Object.defineProperty(exports, "particles", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.particles; }
+  get: function () { return chunkMAAM45ZX_cjs.particles; }
 });
 Object.defineProperty(exports, "react", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.react; }
+  get: function () { return chunkMAAM45ZX_cjs.react; }
 });
 Object.defineProperty(exports, "resolveLoader", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.resolveLoader; }
+  get: function () { return chunkMAAM45ZX_cjs.resolveLoader; }
 });
 Object.defineProperty(exports, "samplePath", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.samplePath; }
+  get: function () { return chunkMAAM45ZX_cjs.samplePath; }
 });
 Object.defineProperty(exports, "splitText", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.splitText; }
+  get: function () { return chunkMAAM45ZX_cjs.splitText; }
 });
 Object.defineProperty(exports, "stagger", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.stagger; }
+  get: function () { return chunkMAAM45ZX_cjs.stagger; }
 });
 Object.defineProperty(exports, "wiggle", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.wiggle; }
+  get: function () { return chunkMAAM45ZX_cjs.wiggle; }
 });
 Object.defineProperty(exports, "withFade", {
   enumerable: true,
-  get: function () { return chunkWVZLAIKK_cjs.withFade; }
+  get: function () { return chunkMAAM45ZX_cjs.withFade; }
 });
 Object.defineProperty(exports, "Sequence", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,9 +1,8 @@
-export { C as ContactSheetOptions, F as FontReport, b as FrameEvent, H as HoverOptions, I as InspectOptions, c as InspectReport, d as IssueGroup, L as LayerInfo, e as LoadProgressState, f as LoadStage, g as LoaderOption, h as LoopEvent, i as MotionBlurOptions, a as MotionBlurSpec, M as Movie, j as MovieErrorEvent, k as MovieOptions, O as OnionSkinOptions, P as PickHit, l as PickOptions, m as ProgressEvent, R as RebuildOptions, n as RebuildReason, o as RebuildReport, p as RenderOptions, q as ReviewOptions, r as ReviewReport, S as SnapshotOptions, T as ThumbnailOptions, s as TimelineData, t as TimelineHtmlOptions, u as TimelineRow, v as TimelineSvgOptions, w as TimelineTransition, V as VolumeEvent, x as dismissLoader, y as failLoader, z as resolveLoader } from './Movie-BHGhg-fJ.cjs';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, f as CameraSequenceSpec, K as Keyframe, g as TextSequenceSpec, M as MusicOptions, d as SequenceCommon } from './types-DIh93lFb.cjs';
-export { h as ArcShapeSpec, A as AssetSpec, i as AudioAssetSpec, j as AudioMusicSpec, k as AudioSequenceSpec, l as AudioSfxSpec, B as BlendModeName, m as CanvasInfo, n as CanvasSequenceSpec, o as ChromaKeyFilterSpec, p as CircleShapeSpec, q as CompositionSequenceSpec, a as CompositionSpec, r as CrossfadeTransition, s as CustomFilterSpec, D as DipTransition, t as DissolveTransition, E as EllipseShapeSpec, u as Expr, F as FilterSpec, G as GradientSpec, v as IrisTransition, L as LightSequenceSpec, w as LineShapeSpec, x as LumaTransition, y as MaskRefSpec, z as MatteRefSpec, H as MusicDrum, J as MusicDrums, N as MusicInstrument, O as MusicLevel, Q as MusicTrack, R as NullSequenceSpec, U as PathShapeSpec, V as PolygonShapeSpec, e as PropValue, P as Props, W as RectShapeSpec, X as SfxKnobs, Y as SfxOptions, Z as SfxPreset, _ as SfxVoice, $ as ShaderSequenceSpec, a0 as ShapeSequenceSpec, a1 as SlideTransition, c as SpaceNow, b as Stop, a2 as StopSpec, a3 as TextSpan, a4 as TransitionCommon, T as TransitionSpec, a5 as VideoSequenceSpec, a6 as WipeTransition, a7 as ZoomTransition } from './types-DIh93lFb.cjs';
+export { C as ContactSheetOptions, F as FontReport, b as FrameEvent, H as HoverOptions, I as InspectOptions, c as InspectReport, d as IssueGroup, L as LayerInfo, e as LoadProgressState, f as LoadStage, g as LoaderOption, h as LoopEvent, i as MotionBlurOptions, a as MotionBlurSpec, M as Movie, j as MovieErrorEvent, k as MovieOptions, O as OnionSkinOptions, P as PickHit, l as PickOptions, m as ProgressEvent, R as RebuildOptions, n as RebuildReason, o as RebuildReport, p as RenderOptions, q as ReviewOptions, r as ReviewReport, S as SnapshotOptions, T as ThumbnailOptions, s as TimelineData, t as TimelineHtmlOptions, u as TimelineRow, v as TimelineSvgOptions, w as TimelineTransition, V as VolumeEvent, x as dismissLoader, y as failLoader, z as resolveLoader } from './Movie-B3VOAgwc.cjs';
+import { S as SequenceSpec, g as CompositionShape, e as Sequence, I as ImageSequenceSpec, h as CameraSequenceSpec, K as Keyframe, i as TextSequenceSpec, M as MusicOptions, c as SequenceCommon } from './types-C5xo0fzb.cjs';
+export { j as ArcShapeSpec, A as AssetSpec, k as AudioAssetSpec, l as AudioMusicSpec, m as AudioSequenceSpec, n as AudioSfxSpec, B as BlendModeName, o as CanvasInfo, p as CanvasSequenceSpec, q as ChromaKeyFilterSpec, r as CircleShapeSpec, s as CompositionSequenceSpec, C as CompositionSpec, t as CrossfadeTransition, u as CustomFilterSpec, D as DipTransition, v as DissolveTransition, E as EllipseShapeSpec, w as Expr, F as FilterSpec, G as GradientSpec, x as IrisTransition, L as LightSequenceSpec, y as LineShapeSpec, z as LumaTransition, H as MaskRefSpec, J as MatteRefSpec, N as MusicDrum, O as MusicDrums, Q as MusicInstrument, R as MusicLevel, U as MusicTrack, V as NullSequenceSpec, W as PathShapeSpec, X as PolygonShapeSpec, d as PropValue, P as Props, Y as RectShapeSpec, Z as SfxKnobs, _ as SfxOptions, $ as SfxPreset, a0 as SfxVoice, a1 as ShaderSequenceSpec, a2 as ShapeSequenceSpec, a3 as SlideTransition, b as SpaceNow, a as Stop, a4 as StopSpec, a5 as TextSpan, a6 as TransitionCommon, T as TransitionSpec, a7 as VideoSequenceSpec, a8 as WipeTransition, a9 as ZoomTransition } from './types-C5xo0fzb.cjs';
 import { M as MusicEvents } from './soundEntry-DT13DNt8.cjs';
 export { a as AudioInspectOptions, A as AudioReport, b as AudioSourceReport, c as MusicDrumEvents, d as MusicDrumHit, e as MusicNote, f as MusicSummary, g as MusicTrackEvents, S as SoundMeasure, h as SoundReport, i as inspectSound } from './soundEntry-DT13DNt8.cjs';
-import { S as Sequence } from './Base-DQWIJ6bJ.cjs';
 import 'pixi.js';
 
 /** A text style as written in a `text` layer's `style` (numbers, not expressions, for the fields that size the text). */

package/dist/index.d.ts

@@ -1,9 +1,8 @@
-export { C as ContactSheetOptions, F as FontReport, b as FrameEvent, H as HoverOptions, I as InspectOptions, c as InspectReport, d as IssueGroup, L as LayerInfo, e as LoadProgressState, f as LoadStage, g as LoaderOption, h as LoopEvent, i as MotionBlurOptions, a as MotionBlurSpec, M as Movie, j as MovieErrorEvent, k as MovieOptions, O as OnionSkinOptions, P as PickHit, l as PickOptions, m as ProgressEvent, R as RebuildOptions, n as RebuildReason, o as RebuildReport, p as RenderOptions, q as ReviewOptions, r as ReviewReport, S as SnapshotOptions, T as ThumbnailOptions, s as TimelineData, t as TimelineHtmlOptions, u as TimelineRow, v as TimelineSvgOptions, w as TimelineTransition, V as VolumeEvent, x as dismissLoader, y as failLoader, z as resolveLoader } from './Movie-CBVFZ1kg.js';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, f as CameraSequenceSpec, K as Keyframe, g as TextSequenceSpec, M as MusicOptions, d as SequenceCommon } from './types-DIh93lFb.js';
-export { h as ArcShapeSpec, A as AssetSpec, i as AudioAssetSpec, j as AudioMusicSpec, k as AudioSequenceSpec, l as AudioSfxSpec, B as BlendModeName, m as CanvasInfo, n as CanvasSequenceSpec, o as ChromaKeyFilterSpec, p as CircleShapeSpec, q as CompositionSequenceSpec, a as CompositionSpec, r as CrossfadeTransition, s as CustomFilterSpec, D as DipTransition, t as DissolveTransition, E as EllipseShapeSpec, u as Expr, F as FilterSpec, G as GradientSpec, v as IrisTransition, L as LightSequenceSpec, w as LineShapeSpec, x as LumaTransition, y as MaskRefSpec, z as MatteRefSpec, H as MusicDrum, J as MusicDrums, N as MusicInstrument, O as MusicLevel, Q as MusicTrack, R as NullSequenceSpec, U as PathShapeSpec, V as PolygonShapeSpec, e as PropValue, P as Props, W as RectShapeSpec, X as SfxKnobs, Y as SfxOptions, Z as SfxPreset, _ as SfxVoice, $ as ShaderSequenceSpec, a0 as ShapeSequenceSpec, a1 as SlideTransition, c as SpaceNow, b as Stop, a2 as StopSpec, a3 as TextSpan, a4 as TransitionCommon, T as TransitionSpec, a5 as VideoSequenceSpec, a6 as WipeTransition, a7 as ZoomTransition } from './types-DIh93lFb.js';
+export { C as ContactSheetOptions, F as FontReport, b as FrameEvent, H as HoverOptions, I as InspectOptions, c as InspectReport, d as IssueGroup, L as LayerInfo, e as LoadProgressState, f as LoadStage, g as LoaderOption, h as LoopEvent, i as MotionBlurOptions, a as MotionBlurSpec, M as Movie, j as MovieErrorEvent, k as MovieOptions, O as OnionSkinOptions, P as PickHit, l as PickOptions, m as ProgressEvent, R as RebuildOptions, n as RebuildReason, o as RebuildReport, p as RenderOptions, q as ReviewOptions, r as ReviewReport, S as SnapshotOptions, T as ThumbnailOptions, s as TimelineData, t as TimelineHtmlOptions, u as TimelineRow, v as TimelineSvgOptions, w as TimelineTransition, V as VolumeEvent, x as dismissLoader, y as failLoader, z as resolveLoader } from './Movie-CQCVUqRs.js';
+import { S as SequenceSpec, g as CompositionShape, e as Sequence, I as ImageSequenceSpec, h as CameraSequenceSpec, K as Keyframe, i as TextSequenceSpec, M as MusicOptions, c as SequenceCommon } from './types-C5xo0fzb.js';
+export { j as ArcShapeSpec, A as AssetSpec, k as AudioAssetSpec, l as AudioMusicSpec, m as AudioSequenceSpec, n as AudioSfxSpec, B as BlendModeName, o as CanvasInfo, p as CanvasSequenceSpec, q as ChromaKeyFilterSpec, r as CircleShapeSpec, s as CompositionSequenceSpec, C as CompositionSpec, t as CrossfadeTransition, u as CustomFilterSpec, D as DipTransition, v as DissolveTransition, E as EllipseShapeSpec, w as Expr, F as FilterSpec, G as GradientSpec, x as IrisTransition, L as LightSequenceSpec, y as LineShapeSpec, z as LumaTransition, H as MaskRefSpec, J as MatteRefSpec, N as MusicDrum, O as MusicDrums, Q as MusicInstrument, R as MusicLevel, U as MusicTrack, V as NullSequenceSpec, W as PathShapeSpec, X as PolygonShapeSpec, d as PropValue, P as Props, Y as RectShapeSpec, Z as SfxKnobs, _ as SfxOptions, $ as SfxPreset, a0 as SfxVoice, a1 as ShaderSequenceSpec, a2 as ShapeSequenceSpec, a3 as SlideTransition, b as SpaceNow, a as Stop, a4 as StopSpec, a5 as TextSpan, a6 as TransitionCommon, T as TransitionSpec, a7 as VideoSequenceSpec, a8 as WipeTransition, a9 as ZoomTransition } from './types-C5xo0fzb.js';
 import { M as MusicEvents } from './soundEntry-DT13DNt8.js';
 export { a as AudioInspectOptions, A as AudioReport, b as AudioSourceReport, c as MusicDrumEvents, d as MusicDrumHit, e as MusicNote, f as MusicSummary, g as MusicTrackEvents, S as SoundMeasure, h as SoundReport, i as inspectSound } from './soundEntry-DT13DNt8.js';
-import { S as Sequence } from './Base-Jgkud1Aw.js';
 import 'pixi.js';
 
 /** A text style as written in a `text` layer's `style` (numbers, not expressions, for the fields that size the text). */

package/dist/index.js

@@ -1,4 +1,4 @@
-export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, parseEase as ease, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, particles, react, resolveLoader, samplePath, splitText, stagger, wiggle, withFade } from './chunk-NFJKBWYO.js';
+export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, parseEase as ease, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, particles, react, resolveLoader, samplePath, splitText, stagger, wiggle, withFade } from './chunk-4MBTYREC.js';
 import './chunk-ICI6ACHY.js';
 export { Sequence, noise, noise2, rand, random, registerSequenceType } from './chunk-4QVQ5UJJ.js';
 export { inspectSound } from './chunk-UHNSL2KJ.js';

package/dist/loader.css

@@ -1,7 +1,7 @@
 /*
  * pixi-effects loader: one line of HTML on the page, a few lines of CSS, no JavaScript of your own.
  *
- *   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.42.0/dist/loader.css">
+ *   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.44.0/dist/loader.css">
  *   <div class="stage" style="position: relative">                      <!-- any box the canvas sits in, with position: relative -->
  *     <canvas id="stage" width="1280" height="720"></canvas>
  *     <div class="pe-loader" data-label="LOADING"></div>                <!-- or class="pe-loader pe-loader--bar" -->

package/dist/present.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-require('./chunk-WVZLAIKK.cjs');
+require('./chunk-MAAM45ZX.cjs');
 require('./chunk-3HZV3UHU.cjs');
 require('./chunk-X62H3RBG.cjs');
 require('./chunk-LQDDDIC4.cjs');

package/dist/present.d.cts

@@ -1,5 +1,5 @@
-import { M as Movie, a as MotionBlurSpec } from './Movie-BHGhg-fJ.cjs';
-import { S as SequenceSpec, P as Props, K as Keyframe, T as TransitionSpec, a as CompositionSpec, b as Stop } from './types-DIh93lFb.cjs';
+import { M as Movie, a as MotionBlurSpec } from './Movie-B3VOAgwc.cjs';
+import { S as SequenceSpec, P as Props, K as Keyframe, T as TransitionSpec, C as CompositionSpec, a as Stop } from './types-C5xo0fzb.cjs';
 import 'pixi.js';
 import './soundEntry-DT13DNt8.cjs';
 

package/dist/present.d.ts

@@ -1,5 +1,5 @@
-import { M as Movie, a as MotionBlurSpec } from './Movie-CBVFZ1kg.js';
-import { S as SequenceSpec, P as Props, K as Keyframe, T as TransitionSpec, a as CompositionSpec, b as Stop } from './types-DIh93lFb.js';
+import { M as Movie, a as MotionBlurSpec } from './Movie-CQCVUqRs.js';
+import { S as SequenceSpec, P as Props, K as Keyframe, T as TransitionSpec, C as CompositionSpec, a as Stop } from './types-C5xo0fzb.js';
 import 'pixi.js';
 import './soundEntry-DT13DNt8.js';
 

package/dist/present.js

@@ -1,4 +1,4 @@
-import './chunk-NFJKBWYO.js';
+import './chunk-4MBTYREC.js';
 import './chunk-ICI6ACHY.js';
 import './chunk-4QVQ5UJJ.js';
 import './chunk-UHNSL2KJ.js';

package/dist/three.cjs

@@ -161,7 +161,7 @@ function trackThree(kind) {
   live[kind]++;
   if (live[kind] > WARN_ABOVE[kind] && !warned.has(kind)) {
     warned.add(kind);
-    console.warn(`pixi-effects: ${live[kind]} three layers are alive with renderer: '${kind}', and a browser keeps ${LIMIT[kind]} for the whole page; layers beyond that draw nothing, without an error. Put several objects in one three layer, destroy layers that are over, ` + (kind === "webgl" ? `or use renderer: 'webgpu' for some (its limit is about 32)` : `or use renderer: 'webgl' for some of them (a different pool of contexts)`));
+    console.warn(`pixi-effects: ${live[kind]} three layers are alive with renderer: '${kind}', and a browser keeps ${LIMIT[kind]} for the whole page; layers beyond that draw nothing, without an error. Put several objects in one three layer, destroy layers that are over, ` + (kind === "webgl" ? `or use renderer: 'webgpu' for some (in a movie PixiJS draws on WebGPU they share its GPU device and have no limit; otherwise it is about 32)` : `or use renderer: 'webgl' for some of them (a different pool of contexts), or leave shareGpu on in a movie PixiJS draws on WebGPU (the layers then share its device)`));
   }
 }
 function releaseThree(kind) {
@@ -178,6 +178,19 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
   backend = null;
   _gpu = false;
   // renderer: 'webgpu': async init and async render
+  /** True when the layer draws on PixiJS's own GPU device into a texture PixiJS samples directly (no canvas of its own, no copy, no share of the page's context cap). */
+  sharedGpu = false;
+  _rt = null;
+  // the texture a shared layer draws into
+  _sharedTexture = null;
+  _texture = null;
+  // what the layer's sprite shows (the canvas's, or the shared render target's)
+  /** What a rebuilt layer is compared with to take this one's place (core/reuse.ts); null: this layer is never kept (`reuse: false`, no `name`). */
+  _key = null;
+  /** The layer of the tree being replaced whose state this one is using until the new tree is on stage (`commitReuse`): not this layer's to let go. */
+  _borrowed = null;
+  /** True once another layer owns this layer's state: destroying this one must not let it go. */
+  _donated = false;
   _scene = null;
   _camera = null;
   _ctx = null;
@@ -209,12 +222,18 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
     const width = resolveDim(spec.width, scope) ?? this.parent?.width ?? this.root.width;
     const height = resolveDim(spec.height, scope) ?? this.parent?.height ?? this.root.height;
     const resolution = spec.resolution ?? 1;
-    const canvas = document.createElement("canvas");
     const antialias = spec.antialias ?? true;
     const kind = spec.renderer ?? getPageRenderer();
     checkRendererKind(kind, "a three layer's renderer");
     this._gpu = kind === "webgpu";
     this.renderer = kind;
+    this._key = spec.reuse === false || !spec.name ? null : JSON.stringify([spec.name, idOf(spec.setup), width, height, resolution, antialias, kind, spec.shareGpu !== false && !!this.root.gpu, !!spec.followCamera, !!spec.followLights, !!spec.followFog]);
+    const donor = this._key !== null ? this.root.reuse?.claim(this._key) : null;
+    if (donor && donor._lendable()) {
+      this._borrow(donor, width, height, spec.name);
+      return;
+    }
+    const canvas = document.createElement("canvas");
     let renderer;
     if (this._gpu) {
       let mod;
@@ -223,24 +242,36 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
       } catch (err) {
         throw new Error(`pixi-effects: renderer: 'webgpu' needs three 0.17x or later with "three/webgpu" in the import map (${err instanceof Error ? err.message : err})`);
       }
-      renderer = new mod.WebGPURenderer({ canvas, alpha: true, antialias });
-      this._renderer = renderer;
-      this._track();
-      const warn = console.warn;
-      let noGpu = false;
-      console.warn = (...args) => {
-        if (/WebGPU is not available/.test(String(args[0]))) noGpu = true;
-        else warn.apply(console, args);
-      };
-      try {
-        await renderer.init();
-      } catch (err) {
-        this._disposeRenderer();
-        throw err;
-      } finally {
-        console.warn = warn;
+      let shared = spec.shareGpu === false ? void 0 : this.root.gpu;
+      for (; ; ) {
+        renderer = new mod.WebGPURenderer(shared ? { device: shared.device, alpha: true, antialias } : { canvas, alpha: true, antialias });
+        this._renderer = renderer;
+        if (!shared) this._track();
+        const warn = console.warn;
+        let noGpu = false;
+        console.warn = (...args) => {
+          if (/WebGPU is not available/.test(String(args[0]))) noGpu = true;
+          else warn.apply(console, args);
+        };
+        try {
+          await renderer.init();
+          if (shared) {
+            renderer.setSize(Math.round(width * resolution), Math.round(height * resolution), false);
+            renderer.setClearColor(0, 0);
+            this._prepareShared(renderer, shared, width, height, resolution, antialias);
+          }
+          this.backend = noGpu ? "webgl2" : "webgpu";
+          break;
+        } catch (err) {
+          this._disposeRenderer();
+          if (!shared) throw err;
+          console.warn(`pixi-effects: three layer${spec.name ? ` "${spec.name}"` : ""}: could not draw on PixiJS's GPU device (${err instanceof Error ? err.message : err}); it uses a canvas of its own (shareGpu: false does this on purpose)`);
+          shared = void 0;
+          this._closing = false;
+        } finally {
+          console.warn = warn;
+        }
       }
-      this.backend = noGpu ? "webgl2" : "webgpu";
     } else {
       renderer = new three$1.WebGLRenderer({ canvas, alpha: true, antialias });
       this._renderer = renderer;
@@ -274,20 +305,59 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
       if (!("camera" in this._objects)) this._objects.camera = this._camera;
       if (this._gpu) this._checkWebGpuMaterials(scene, spec.name);
       this._draw(0);
-      const texture = pixi_js.Texture.from(canvas);
-      const sprite = new pixi_js.Sprite({ texture, label: spec.name });
-      sprite.cullable = true;
-      sprite.width = width;
-      sprite.height = height;
-      this.target = sprite;
-      this.intrinsicWidth = width;
-      this.intrinsicHeight = height;
-      this.buildFilters();
+      this._texture = this._sharedTexture ?? pixi_js.Texture.from(canvas);
+      this._makeSprite(this._texture, width, height, spec.name);
     } catch (err) {
       this._disposeRenderer();
       throw err;
     }
   }
+  _makeSprite(texture, width, height, name) {
+    const sprite = new pixi_js.Sprite({ texture, label: name });
+    sprite.cullable = true;
+    sprite.width = width;
+    sprite.height = height;
+    this.target = sprite;
+    this.intrinsicWidth = width;
+    this.intrinsicHeight = height;
+    this.buildFilters();
+  }
+  /** Reuse (core/reuse.ts): the key this layer is matched by, while it can still lend its state. */
+  reuseKey() {
+    return this._renderer && !this._donated && !this._closing ? this._key : null;
+  }
+  _lendable() {
+    return this.reuseKey() !== null && !!this._scene && !!this._ctx && !!this._texture;
+  }
+  /** Take over a layer of the tree being replaced: its scene, renderer, texture and mirrors. Nothing is drawn until the new tree is on stage; the old layer goes on drawing meanwhile. */
+  _borrow(d, width, height, name) {
+    this.renderer = d.renderer;
+    this.backend = d.backend;
+    this._gpu = d._gpu;
+    this.sharedGpu = d.sharedGpu;
+    this._renderer = d._renderer;
+    this._scene = d._scene;
+    this._camera = d._camera;
+    this._ctx = d._ctx;
+    this._objects = d._objects;
+    this._rt = d._rt;
+    this._sharedTexture = d._sharedTexture;
+    this._texture = d._texture;
+    this._lightMirror = d._lightMirror;
+    this._fogMirror = d._fogMirror;
+    this._tracked = d._tracked;
+    this._borrowed = d;
+    if (this.spec && this._threeSpec.followCamera) this._checkFollowShape(width, height, name);
+    this._makeSprite(this._texture, width, height, name);
+  }
+  /** The new tree is on stage: the layer this one borrowed from has given its state away for good. */
+  commitReuse() {
+    const d = this._borrowed;
+    if (!d) return;
+    d._donated = true;
+    d._tracked = false;
+    this._borrowed = null;
+  }
   /**
    * Per-frame sync hook. Movie._awaitVideoFrames duck-types on this method
    * (same contract as VideoSequence) and awaits it inside gotoFrame — the
@@ -310,7 +380,7 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
       }
     }
     this._draw(t);
-    this.target?.texture.source.update();
+    if (!this.sharedGpu) this.target?.texture.source.update();
   }
   /**
    * `movie.pick`: a ray through the point (u, v) of the layer's picture (0..1, v down) from the layer's camera, and what it meets first: the object's name (its own, or its nearest
@@ -400,7 +470,7 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
       try {
         this._followSpace(t);
         this._threeSpec.update?.(t, ctx);
-        this._draw(t);
+        this._draw(t, true);
         g.clearRect(0, 0, w, h);
         g.drawImage(source, 0, 0);
       } catch {
@@ -503,10 +573,45 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
    * follow each other in one task (a seek, an export) would all show the lights of the last animation frame: a lamp keyframed with `three.lamp.intensity` would not move.
    * So before each render the layer advances the node frame itself, and gives `time` the layer's own time (not three's wall clock).
    */
-  _draw(t) {
+  _draw(t, toCanvas = false) {
     if (!this._renderer || !this._scene || !this._camera) return;
     if (this._gpu) this._advanceNodeFrame(t);
-    this._renderer.render(this._scene, this._camera);
+    if (!this._rt || toCanvas) {
+      this._renderer.render(this._scene, this._camera);
+      return;
+    }
+    const r = this._renderer;
+    r.setOutputRenderTarget(this._rt);
+    try {
+      this._renderer.render(this._scene, this._camera);
+    } finally {
+      r.setOutputRenderTarget(null);
+      r.setRenderTarget(null);
+    }
+  }
+  /**
+   * A shared layer's texture: a render target of the layer's size, drawn into once (the GPU texture exists only after a draw) and adopted by a PixiJS texture source. Throws when something
+   * is not as this expects (the build then makes the layer again on a canvas of its own). Done before `setup`, so nothing the author made yet depends on the renderer.
+   */
+  _prepareShared(renderer, shared, width, height, resolution, antialias) {
+    const w = Math.round(width * resolution), h = Math.round(height * resolution);
+    const rt = new three$1.RenderTarget(w, h, { depthBuffer: true, samples: antialias ? 4 : 0 });
+    this._rt = rt;
+    const r = renderer;
+    if (typeof r.setOutputRenderTarget !== "function") throw new Error("this three has no setOutputRenderTarget");
+    r.setOutputRenderTarget(rt);
+    try {
+      renderer.render(new three$1.Scene(), new three$1.PerspectiveCamera());
+    } finally {
+      r.setOutputRenderTarget(null);
+      r.setRenderTarget(null);
+    }
+    const gpuTexture = r.backend?.get?.(rt.texture)?.texture;
+    if (!gpuTexture || typeof gpuTexture.createView !== "function") throw new Error("three keeps no GPU texture for a render target");
+    const source = new pixi_js.TextureSource({ width: w, height: h, format: gpuTexture.format, label: "three layer (shared GPU)" });
+    shared.adopt(source, gpuTexture);
+    this._sharedTexture = new pixi_js.Texture({ source });
+    this.sharedGpu = true;
   }
   /**
    * The author chose renderer: 'webgpu'. Three's WebGPU renderer turns materials into node materials: a ShaderMaterial / RawShaderMaterial cannot run there (three logs an error on
@@ -601,28 +706,40 @@ var ThreeSequence = class extends chunkX62H3RBG_cjs.Sequence {
       console.warn("pixi-effects: three renderer dispose threw \u2014", err);
     }
     this._renderer = null;
+    try {
+      this._rt?.dispose();
+    } catch {
+    }
+    this._rt = null;
   }
   destroy() {
     const spec = this._threeSpec;
-    if (this._ctx && spec.dispose) {
+    const kept = this._donated || this._borrowed !== null;
+    if (!kept && this._ctx && spec.dispose) {
       try {
         spec.dispose(this._ctx);
       } catch (err) {
         console.warn("pixi-effects: three dispose() threw \u2014", err);
       }
     }
-    const texture = this.target?.texture;
-    this._lightMirror?.dispose();
+    const texture = this._texture;
+    if (!kept) {
+      this._lightMirror?.dispose();
+      this._fogMirror?.dispose();
+      this._disposeRenderer();
+    }
     this._lightMirror = null;
-    this._fogMirror?.dispose();
     this._fogMirror = null;
-    this._disposeRenderer();
+    this._renderer = null;
+    this._rt = null;
     this._scene = null;
     this._camera = null;
     this._ctx = null;
     this._objects = {};
     super.destroy();
-    texture?.destroy(true);
+    if (!kept) texture?.destroy(true);
+    this._texture = null;
+    this._sharedTexture = null;
   }
 };
 function resolveDim(v, scope) {
@@ -630,6 +747,17 @@ function resolveDim(v, scope) {
   if (typeof v === "number") return v;
   return chunkX62H3RBG_cjs.evaluateExpr(v, scope);
 }
+var ids = /* @__PURE__ */ new WeakMap();
+var lastId = 0;
+function idOf(fn) {
+  if (typeof fn !== "function") return 0;
+  let id = ids.get(fn);
+  if (id === void 0) {
+    id = ++lastId;
+    ids.set(fn, id);
+  }
+  return id;
+}
 async function threeGltf(url, options = {}) {
   const label = "pixi-effects: threeGltf";
   if (typeof url !== "string" || !url) throw new Error(`${label}: the first argument is the URL of a .glb or .gltf file`);