@vielzeug/stage 0.0.0-stage → 26.11.23

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 (51) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +53 -2
  3. package/dist/_dev.cjs +2 -0
  4. package/dist/_dev.cjs.map +1 -0
  5. package/dist/_dev.d.ts +2 -0
  6. package/dist/_dev.d.ts.map +1 -0
  7. package/dist/_dev.js +5 -0
  8. package/dist/_dev.js.map +1 -0
  9. package/dist/_validate.cjs +2 -0
  10. package/dist/_validate.cjs.map +1 -0
  11. package/dist/_validate.d.ts +3 -0
  12. package/dist/_validate.d.ts.map +1 -0
  13. package/dist/_validate.js +14 -0
  14. package/dist/_validate.js.map +1 -0
  15. package/dist/errors.cjs +2 -0
  16. package/dist/errors.cjs.map +1 -0
  17. package/dist/errors.d.ts +12 -0
  18. package/dist/errors.d.ts.map +1 -0
  19. package/dist/errors.js +9 -0
  20. package/dist/errors.js.map +1 -0
  21. package/dist/index.cjs +1 -0
  22. package/dist/index.d.ts +3 -0
  23. package/dist/index.d.ts.map +1 -0
  24. package/dist/index.js +3 -0
  25. package/dist/stage.cjs +2 -0
  26. package/dist/stage.cjs.map +1 -0
  27. package/dist/stage.d.ts +81 -0
  28. package/dist/stage.d.ts.map +1 -0
  29. package/dist/stage.iife.js +2 -0
  30. package/dist/stage.iife.js.map +1 -0
  31. package/dist/stage.js +218 -0
  32. package/dist/stage.js.map +1 -0
  33. package/dist/worker/index.cjs +1 -0
  34. package/dist/worker/index.d.ts +3 -0
  35. package/dist/worker/index.d.ts.map +1 -0
  36. package/dist/worker/index.js +3 -0
  37. package/dist/worker/main.cjs +2 -0
  38. package/dist/worker/main.cjs.map +1 -0
  39. package/dist/worker/main.d.ts +45 -0
  40. package/dist/worker/main.d.ts.map +1 -0
  41. package/dist/worker/main.js +114 -0
  42. package/dist/worker/main.js.map +1 -0
  43. package/dist/worker/protocol.d.ts +67 -0
  44. package/dist/worker/protocol.d.ts.map +1 -0
  45. package/dist/worker/serve.cjs +2 -0
  46. package/dist/worker/serve.cjs.map +1 -0
  47. package/dist/worker/serve.d.ts +38 -0
  48. package/dist/worker/serve.d.ts.map +1 -0
  49. package/dist/worker/serve.js +99 -0
  50. package/dist/worker/serve.js.map +1 -0
  51. package/package.json +63 -4
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Helmuth Saatkamp
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,54 @@
1
- # Temporary Holding Version
1
+ # @vielzeug/stage
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ > Retained-mode 2D canvas stage engine with DPR-aware layers, dirty repaints, and PNG export
4
+
5
+ Every layer owns a cached backing surface: only dirty layers repaint, and the composite is one `drawImage` per layer. Paint callbacks draw in world units while the stage applies `dpr × matrix`; surfaces and the frame scheduler are injectable, so the engine is unit-testable without a GPU. Geometry types (`Matrix`, `Rect`) and the `FrameScheduler` contract come from [`@vielzeug/atlas`](https://vielzeug.dev/atlas/api).
6
+
7
+ ## Installation
8
+
9
+ ```sh
10
+ pnpm add @vielzeug/stage
11
+ npm install @vielzeug/stage
12
+ yarn add @vielzeug/stage
13
+ ```
14
+
15
+ ## Quick Start
16
+
17
+ ```ts
18
+ import { createStage } from '@vielzeug/stage';
19
+
20
+ const stage = createStage(canvas, {
21
+ dpr: window.devicePixelRatio,
22
+ height: 600,
23
+ layers: [
24
+ { id: 'grid', paint: (ctx, { visibleRect }) => drawGrid(ctx, visibleRect) },
25
+ { id: 'tokens', paint: (ctx) => drawTokens(ctx) },
26
+ ],
27
+ width: 800,
28
+ });
29
+
30
+ stage.setTransform([2, 0, 0, 2, 40, 10]); // world→screen; DPR applied on top
31
+ token.x += 10;
32
+ stage.invalidate('tokens'); // only the tokens layer repaints
33
+ ```
34
+
35
+ ## Features
36
+
37
+ - **`createStage()`**: layered retained-mode renderer with cached per-layer surfaces
38
+ - **Dirty repaints**: invalidate one layer or all; frames coalesce via an injectable scheduler
39
+ - **DPR-aware transforms**: paint in world units, the stage scales by `dpr × matrix`
40
+ - **`StageController`**: one control type shared by main-thread and worker stages
41
+ - **`toBlob()`**: PNG export that flushes pending frames, with typed unsupported-capability errors
42
+ - **Injectable surfaces**: `createSurface` factory for tests and `OffscreenCanvas` workers
43
+ - **`@vielzeug/stage/worker`**: worker-rendered stages via a transferred `OffscreenCanvas` and a typed scene channel
44
+
45
+ ## Documentation
46
+
47
+ - [Overview](https://vielzeug.dev/stage/)
48
+ - [Usage Guide](https://vielzeug.dev/stage/usage)
49
+ - [API Reference](https://vielzeug.dev/stage/api)
50
+ - [Examples](https://vielzeug.dev/stage/examples)
51
+
52
+ ## License
53
+
54
+ MIT © [Helmuth Saatkamp](https://github.com/helmuthdu): part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.
package/dist/_dev.cjs ADDED
@@ -0,0 +1,2 @@
1
+ function warn(e){}exports.warn=warn;
2
+ //# sourceMappingURL=_dev.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __STAGE_PROD__?: boolean }).__STAGE_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/stage] ${msg}`);\n}\n"],"mappings":"AAGA,SAAgB,KAAK,EAAmB,CAExC,C"}
package/dist/_dev.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=_dev.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_dev.d.ts","sourceRoot":"","sources":["../src/_dev.ts"],"names":[],"mappings":""}
package/dist/_dev.js ADDED
@@ -0,0 +1,5 @@
1
+ // src/_dev.ts
2
+ function warn(e) {}
3
+ export { warn };
4
+
5
+ //# sourceMappingURL=_dev.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __STAGE_PROD__?: boolean }).__STAGE_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/stage] ${msg}`);\n}\n"],"mappings":";AAGA,SAAgB,KAAK,GAAmB,CAExC"}
@@ -0,0 +1,2 @@
1
+ const e=require("./errors.cjs");function requireSize(t,n){if(!Number.isFinite(t.width)||t.width<=0||!Number.isFinite(t.height)||t.height<=0)throw new e.StageConfigError(`${n} size must be positive finite numbers, got ${t.width}x${t.height}.`)}function requireDpr(t,n){if(!Number.isFinite(t)||t<=0)throw new e.StageConfigError(`${n} dpr must be a positive finite number, got ${t}.`)}function requireFiniteMatrix(t){for(let n of t)if(!Number.isFinite(n))throw new e.StageConfigError(`Stage matrix must contain only finite numbers, got ${n}.`)}exports.requireDpr=requireDpr,exports.requireFiniteMatrix=requireFiniteMatrix,exports.requireSize=requireSize;
2
+ //# sourceMappingURL=_validate.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_validate.cjs","names":["StageConfigError","require_errors","size","context","dpr","value","matrix"],"sources":["../src/_validate.ts"],"sourcesContent":["/** Shared input validation for the main-thread and worker stage halves. */\n\nimport type { Matrix, Size } from '@vielzeug/atlas';\nimport { StageConfigError } from './errors.js';\n\n/** @internal */\nexport function requireSize(size: Size, context: string): void {\n if (!Number.isFinite(size.width) || size.width <= 0 || !Number.isFinite(size.height) || size.height <= 0) {\n throw new StageConfigError(`${context} size must be positive finite numbers, got ${size.width}x${size.height}.`);\n }\n}\n\n/** @internal */\nexport function requireDpr(dpr: number, context: string): void {\n if (!Number.isFinite(dpr) || dpr <= 0) {\n throw new StageConfigError(`${context} dpr must be a positive finite number, got ${dpr}.`);\n }\n}\n\n/** @internal */\nexport function requireFiniteMatrix(matrix: Matrix): void {\n for (const value of matrix) {\n if (!Number.isFinite(value)) {\n throw new StageConfigError(`Stage matrix must contain only finite numbers, got ${value}.`);\n }\n }\n}\n"],"mappings":"A,gCAMA,SAAgB,YAAY,EAAY,EAAuB,CAC7D,GAAI,CAAC,OAAO,SAASE,EAAK,KAAK,GAAKA,EAAK,OAAS,GAAK,CAAC,OAAO,SAASA,EAAK,MAAM,GAAKA,EAAK,QAAU,EACrG,MAAM,IAAIF,EAAAA,iBAAiB,GAAGG,EAAQ,6CAA6CD,EAAK,MAAM,GAAGA,EAAK,OAAO,EAAE,CAEnH,CAGA,SAAgB,WAAW,EAAa,EAAuB,CAC7D,GAAI,CAAC,OAAO,SAASE,CAAG,GAAKA,GAAO,EAClC,MAAM,IAAIJ,EAAAA,iBAAiB,GAAGG,EAAQ,6CAA6CC,EAAI,EAAE,CAE7F,CAGA,SAAgB,oBAAoB,EAAsB,CACxD,IAAK,IAAMC,KAASC,EAClB,GAAI,CAAC,OAAO,SAASD,CAAK,EACxB,MAAM,IAAIL,EAAAA,iBAAiB,sDAAsDK,EAAM,EAAE,CAG/F,C"}
@@ -0,0 +1,3 @@
1
+ /** Shared input validation for the main-thread and worker stage halves. */
2
+ export {};
3
+ //# sourceMappingURL=_validate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_validate.d.ts","sourceRoot":"","sources":["../src/_validate.ts"],"names":[],"mappings":"AAAA,2EAA2E"}
@@ -0,0 +1,14 @@
1
+ import { StageConfigError as e } from "./errors.js";
2
+ // src/_validate.ts
3
+ function requireSize(t, n) {
4
+ if (!Number.isFinite(t.width) || t.width <= 0 || !Number.isFinite(t.height) || t.height <= 0) throw new e(`${n} size must be positive finite numbers, got ${t.width}x${t.height}.`);
5
+ }
6
+ function requireDpr(t, n) {
7
+ if (!Number.isFinite(t) || t <= 0) throw new e(`${n} dpr must be a positive finite number, got ${t}.`);
8
+ }
9
+ function requireFiniteMatrix(t) {
10
+ for (let n of t) if (!Number.isFinite(n)) throw new e(`Stage matrix must contain only finite numbers, got ${n}.`);
11
+ }
12
+ export { requireDpr, requireFiniteMatrix, requireSize };
13
+
14
+ //# sourceMappingURL=_validate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_validate.js","names":["size","StageConfigError","context","dpr","value","matrix"],"sources":["../src/_validate.ts"],"sourcesContent":["/** Shared input validation for the main-thread and worker stage halves. */\n\nimport type { Matrix, Size } from '@vielzeug/atlas';\nimport { StageConfigError } from './errors.js';\n\n/** @internal */\nexport function requireSize(size: Size, context: string): void {\n if (!Number.isFinite(size.width) || size.width <= 0 || !Number.isFinite(size.height) || size.height <= 0) {\n throw new StageConfigError(`${context} size must be positive finite numbers, got ${size.width}x${size.height}.`);\n }\n}\n\n/** @internal */\nexport function requireDpr(dpr: number, context: string): void {\n if (!Number.isFinite(dpr) || dpr <= 0) {\n throw new StageConfigError(`${context} dpr must be a positive finite number, got ${dpr}.`);\n }\n}\n\n/** @internal */\nexport function requireFiniteMatrix(matrix: Matrix): void {\n for (const value of matrix) {\n if (!Number.isFinite(value)) {\n throw new StageConfigError(`Stage matrix must contain only finite numbers, got ${value}.`);\n }\n }\n}\n"],"mappings":";;AAMA,SAAgB,YAAY,GAAY,GAAuB;CAC7D,IAAI,CAAC,OAAO,SAASA,EAAK,KAAK,KAAKA,EAAK,SAAS,KAAK,CAAC,OAAO,SAASA,EAAK,MAAM,KAAKA,EAAK,UAAU,GACrG,MAAM,IAAIC,EAAiB,GAAGC,EAAQ,6CAA6CF,EAAK,MAAM,GAAGA,EAAK,OAAO,EAAE;AAEnH;AAGA,SAAgB,WAAW,GAAa,GAAuB;CAC7D,IAAI,CAAC,OAAO,SAASG,CAAG,KAAKA,KAAO,GAClC,MAAM,IAAIF,EAAiB,GAAGC,EAAQ,6CAA6CC,EAAI,EAAE;AAE7F;AAGA,SAAgB,oBAAoB,GAAsB;CACxD,KAAK,IAAMC,KAASC,GAClB,IAAI,CAAC,OAAO,SAASD,CAAK,GACxB,MAAM,IAAIH,EAAiB,sDAAsDG,EAAM,EAAE;AAG/F"}
@@ -0,0 +1,2 @@
1
+ var StageError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},StageConfigError=class extends StageError{},StageUnsupportedError=class extends StageError{},StageDisposedError=class extends StageError{};exports.StageConfigError=StageConfigError,exports.StageDisposedError=StageDisposedError,exports.StageError=StageError,exports.StageUnsupportedError=StageUnsupportedError;
2
+ //# sourceMappingURL=errors.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.cjs","names":["message","opts"],"sources":["../src/errors.ts"],"sourcesContent":["export class StageError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\nexport class StageConfigError extends StageError {}\n\n/** A required browser capability (e.g. canvas blob export) is missing. */\nexport class StageUnsupportedError extends StageError {}\n\n/** The stage (or its worker) was disposed before a pending request settled. */\nexport class StageDisposedError extends StageError {}\n"],"mappings":"AAAA,IAAa,WAAb,cAAgC,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAMA,EAASC,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,iBAAb,cAAsC,UAAW,CAAC,EAGrC,sBAAb,cAA2C,UAAW,CAAC,EAG1C,mBAAb,cAAwC,UAAW,CAAC,E"}
@@ -0,0 +1,12 @@
1
+ export declare class StageError extends Error {
2
+ constructor(message: string, opts?: ErrorOptions);
3
+ }
4
+ export declare class StageConfigError extends StageError {
5
+ }
6
+ /** A required browser capability (e.g. canvas blob export) is missing. */
7
+ export declare class StageUnsupportedError extends StageError {
8
+ }
9
+ /** The stage (or its worker) was disposed before a pending request settled. */
10
+ export declare class StageDisposedError extends StageError {
11
+ }
12
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAKjD;AAED,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,0EAA0E;AAC1E,qBAAa,qBAAsB,SAAQ,UAAU;CAAG;AAExD,+EAA+E;AAC/E,qBAAa,kBAAmB,SAAQ,UAAU;CAAG"}
package/dist/errors.js ADDED
@@ -0,0 +1,9 @@
1
+ // src/errors.ts
2
+ var StageError = class extends Error {
3
+ constructor(e, t) {
4
+ super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
5
+ }
6
+ }, StageConfigError = class extends StageError {}, StageUnsupportedError = class extends StageError {}, StageDisposedError = class extends StageError {};
7
+ export { StageConfigError, StageDisposedError, StageError, StageUnsupportedError };
8
+
9
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","names":["message","opts"],"sources":["../src/errors.ts"],"sourcesContent":["export class StageError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\nexport class StageConfigError extends StageError {}\n\n/** A required browser capability (e.g. canvas blob export) is missing. */\nexport class StageUnsupportedError extends StageError {}\n\n/** The stage (or its worker) was disposed before a pending request settled. */\nexport class StageDisposedError extends StageError {}\n"],"mappings":";AAAA,IAAa,aAAb,cAAgC,MAAM;CACpC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAMA,GAASC,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAEa,mBAAb,cAAsC,WAAW,CAAC,GAGrC,wBAAb,cAA2C,WAAW,CAAC,GAG1C,qBAAb,cAAwC,WAAW,CAAC"}
package/dist/index.cjs ADDED
@@ -0,0 +1 @@
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./stage.cjs");exports.StageConfigError=e.StageConfigError,exports.StageDisposedError=e.StageDisposedError,exports.StageError=e.StageError,exports.StageUnsupportedError=e.StageUnsupportedError,exports.createStage=t.createStage;
@@ -0,0 +1,3 @@
1
+ export { StageConfigError, StageDisposedError, StageError, StageUnsupportedError } from './errors.js';
2
+ export { type CreateSurface, createStage, type PaintContext, type Stage, type StageController, type StageFrameInfo, type StageLayerOptions, type StageOptions, type StageSurface, } from './stage.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACtG,OAAO,EACL,KAAK,aAAa,EAClB,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,3 @@
1
+ import { StageConfigError as e, StageDisposedError as t, StageError as n, StageUnsupportedError as r } from "./errors.js";
2
+ import { createStage as i } from "./stage.js";
3
+ export { e as StageConfigError, t as StageDisposedError, n as StageError, r as StageUnsupportedError, i as createStage };
package/dist/stage.cjs ADDED
@@ -0,0 +1,2 @@
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/atlas");var StageError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},StageConfigError=class extends StageError{},StageUnsupportedError=class extends StageError{},StageDisposedError=class extends StageError{};function requireSize(e,t){if(!Number.isFinite(e.width)||e.width<=0||!Number.isFinite(e.height)||e.height<=0)throw new StageConfigError(`${t} size must be positive finite numbers, got ${e.width}x${e.height}.`)}function requireDpr(e,t){if(!Number.isFinite(e)||e<=0)throw new StageConfigError(`${t} dpr must be a positive finite number, got ${e}.`)}function requireFiniteMatrix(e){for(let t of e)if(!Number.isFinite(t))throw new StageConfigError(`Stage matrix must contain only finite numbers, got ${t}.`)}var t={cancelFrame:e=>{typeof cancelAnimationFrame==`function`?cancelAnimationFrame(e):clearTimeout(e)},now:()=>performance.now(),requestFrame:e=>typeof requestAnimationFrame==`function`?requestAnimationFrame(e):setTimeout(()=>e(performance.now()),16)};function defaultCreateSurface(e,t){if(typeof OffscreenCanvas<`u`)return new OffscreenCanvas(e,t);if(typeof document<`u`){let n=document.createElement(`canvas`);return n.width=e,n.height=t,n}throw new StageUnsupportedError(`No canvas surface factory is available in this environment.`)}function createStage(n,r){let{width:i,height:a}=r;requireSize({height:a,width:i},`Stage`),requireDpr(r.dpr??1,`Stage`);let o=r.scheduler??t,s=r.createSurface??defaultCreateSurface,c=r.background??null,l=new AbortController,u=!1,d=i,f=a,p=r.dpr??1,m=[1,0,0,1,0,0],h=null,g=!1,_=[];for(let e of r.layers){if(_.some(t=>t.id===e.id))throw new StageConfigError(`Stage layer id "${e.id}" is already registered.`);_.push({ctx:null,dirty:!0,id:e.id,paint:e.paint,surface:null})}let disposeSurface=e=>{e.surface&&(e.surface.width=0,e.surface.height=0),e.surface=null,e.ctx=null},ensureSurface=e=>{let t=Math.max(1,Math.round(d*p)),n=Math.max(1,Math.round(f*p));if(!e.surface||e.surface.width!==t||e.surface.height!==n){disposeSurface(e),e.surface=s(t,n);let r=e.surface.getContext(`2d`,{alpha:!0});if(r==null)throw new StageUnsupportedError(`Layer surface for "${e.id}" has no 2D context.`);e.ctx=r,e.dirty=!0}return e.ctx},visibleRect=()=>{let t=(0,e.invert)(m);if(!t)return{height:f,width:d,x:0,y:0};let n=[(0,e.apply)(t,{x:0,y:0}),(0,e.apply)(t,{x:d,y:0}),(0,e.apply)(t,{x:0,y:f}),(0,e.apply)(t,{x:d,y:f})];return(0,e.rectFromPoints)(n)},applyWorldTransform=e=>{let[t,n,r,i,a,o]=m;e.setTransform(p*t,p*n,p*r,p*i,p*a,p*o)},renderFrame=e=>{if(g=!1,h=null,u)return{repainted:[],time:e};let t=visibleRect(),r={dpr:p,matrix:m,time:e,visibleRect:t},i=[];for(let e of _)if(e.dirty){let t=ensureSurface(e);t.setTransform(1,0,0,1,0,0),t.clearRect(0,0,e.surface?.width??0,e.surface?.height??0),applyWorldTransform(t),e.paint(t,r),e.dirty=!1,i.push(e.id)}let a=n.getContext(`2d`);if(a){let e=Math.max(1,Math.round(d*p)),t=Math.max(1,Math.round(f*p)),r=Math.max(1,Math.round(n.width)),i=Math.max(1,Math.round(n.height));a.setTransform(1,0,0,1,0,0),a.clearRect(0,0,r,i),c!=null&&(a.fillStyle=c,a.fillRect(0,0,r,i));for(let n of _)n.surface&&a.drawImage(n.surface,0,0,e,t)}return{repainted:i,time:e}},schedule=()=>{u||g||(g=!0,h=o.requestFrame(e=>{g&&renderFrame(e)}))},invalidateAll=()=>{for(let e of _)e.dirty=!0},cancelFrame=()=>{h!=null&&(o.cancelFrame(h),h=null),g=!1},dispose=()=>{if(!u){u=!0,cancelFrame();for(let e of _)disposeSurface(e);_.length=0,l.abort()}};n.width=Math.max(1,Math.round(d*p)),n.height=Math.max(1,Math.round(f*p));let v={get canvas(){return n},get disposalSignal(){return l.signal},get disposed(){return u},[Symbol.dispose]:dispose,dispose,get dpr(){return p},get height(){return f},invalidate(e){if(!u){if(e==null)invalidateAll();else{let t=_.find(t=>t.id===e);if(!t)throw new StageConfigError(`Unknown stage layer "${e}".`);t.dirty=!0}schedule()}},get matrix(){return m},render(e){return u?{repainted:[],time:e??o.now()}:(cancelFrame(),renderFrame(e??o.now()))},resize(e,t){if(u)return;requireSize(e,`Stage`);let r=t??p;requireDpr(r,`Stage`),d=e.width,f=e.height,p=r,n.width=Math.max(1,Math.round(d*p)),n.height=Math.max(1,Math.round(f*p)),invalidateAll(),schedule()},setTransform(e){u||(requireFiniteMatrix(e),m=e,invalidateAll(),schedule())},async toBlob(e){if(u)throw new StageDisposedError(`Cannot export a disposed stage.`);g&&v.render();let t=e?.type??`image/png`;if(typeof OffscreenCanvas<`u`&&n instanceof OffscreenCanvas){let r=await n.convertToBlob({quality:e?.quality,type:t});if(!r)throw new StageUnsupportedError(`Canvas blob export returned no data.`);return r}let r=n;if(typeof r.toBlob!=`function`)throw new StageUnsupportedError(`This canvas does not support blob export.`);let i=await new Promise(n=>{r.toBlob(n,t,e?.quality)});if(!i)throw new StageUnsupportedError(`Canvas blob export returned no data.`);return i},get visibleRect(){return visibleRect()},get width(){return d}};return v}exports.StageConfigError=StageConfigError,exports.StageDisposedError=StageDisposedError,exports.StageError=StageError,exports.StageUnsupportedError=StageUnsupportedError,exports.createStage=createStage;
2
+ //# sourceMappingURL=stage.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stage.cjs","names":["invert","apply","rectFromPoints","_vielzeug_atlas","message","opts","size","context","dpr","value","matrix","DEFAULT_SCHEDULER","handle","callback","width","height","el","initialWidth","initialHeight","options","scheduler","createSurface","background","controller","disposed","frameHandle","pending","layers","layer","pw","ph","ctx","inv","corners","a","b","c","d","e","f","rect","frame","repainted","screen","canvas","cw","ch","time","stage","layerId","l","resolvedDpr","nextDpr","next","type","blobOptions","blob","htmlCanvas","resolve"],"sources":["../src/errors.ts","../src/_validate.ts","../src/stage.ts"],"sourcesContent":["export class StageError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\nexport class StageConfigError extends StageError {}\n\n/** A required browser capability (e.g. canvas blob export) is missing. */\nexport class StageUnsupportedError extends StageError {}\n\n/** The stage (or its worker) was disposed before a pending request settled. */\nexport class StageDisposedError extends StageError {}\n","/** Shared input validation for the main-thread and worker stage halves. */\n\nimport type { Matrix, Size } from '@vielzeug/atlas';\nimport { StageConfigError } from './errors.js';\n\n/** @internal */\nexport function requireSize(size: Size, context: string): void {\n if (!Number.isFinite(size.width) || size.width <= 0 || !Number.isFinite(size.height) || size.height <= 0) {\n throw new StageConfigError(`${context} size must be positive finite numbers, got ${size.width}x${size.height}.`);\n }\n}\n\n/** @internal */\nexport function requireDpr(dpr: number, context: string): void {\n if (!Number.isFinite(dpr) || dpr <= 0) {\n throw new StageConfigError(`${context} dpr must be a positive finite number, got ${dpr}.`);\n }\n}\n\n/** @internal */\nexport function requireFiniteMatrix(matrix: Matrix): void {\n for (const value of matrix) {\n if (!Number.isFinite(value)) {\n throw new StageConfigError(`Stage matrix must contain only finite numbers, got ${value}.`);\n }\n }\n}\n","import {\n apply,\n type FrameScheduler,\n invert,\n type Matrix,\n type Point,\n type Rect,\n rectFromPoints,\n type Size,\n} from '@vielzeug/atlas';\nimport { requireDpr, requireFiniteMatrix, requireSize } from './_validate.js';\nimport { StageConfigError, StageDisposedError, StageUnsupportedError } from './errors.js';\n\n/** A backing surface a layer paints into. `OffscreenCanvas` on workers. */\nexport type StageSurface = {\n width: number;\n height: number;\n getContext: (type: '2d', attributes?: CanvasRenderingContext2DSettings) => unknown;\n};\n\n/** Factory for layer backing surfaces; injectable for tests and workers. */\nexport type CreateSurface = (width: number, height: number) => StageSurface;\n\nexport type PaintContext = Readonly<{\n /** World→screen matrix (DPR already applied to the context transform). */\n matrix: Matrix;\n /** Visible world-space rect for culling. */\n visibleRect: Rect;\n /** Device pixel ratio in effect. */\n dpr: number;\n /** Frame timestamp from the scheduler. */\n time: number;\n}>;\n\nexport type StageLayerOptions = Readonly<{\n id: string;\n paint: (ctx: CanvasRenderingContext2D, frame: PaintContext) => void;\n}>;\n\nexport type StageOptions = Readonly<{\n dpr?: number;\n /** Layers are fixed at creation, bottom-first; hide one by returning early from its paint. */\n layers: readonly StageLayerOptions[];\n /** Reuses the atlas camera scheduler contract; defaults to `requestAnimationFrame`. */\n scheduler?: FrameScheduler;\n createSurface?: CreateSurface;\n /** Background color cleared under the layers; defaults to transparent. */\n background?: string | null;\n}>;\n\nexport type StageFrameInfo = Readonly<{\n /** Layer ids that were repainted for this frame. */\n repainted: readonly string[];\n time: number;\n}>;\n\n/**\n * The control surface both stage modes share: a main-thread `Stage` and a\n * `WorkerStage` client are interchangeable wherever only control is needed.\n */\nexport type StageController = Readonly<{\n /** Resize the CSS size and DPR; reallocates backing surfaces and invalidates all. */\n resize: (size: Size, dpr?: number) => void;\n /** Set the world→screen matrix; invalidates all layers. */\n setTransform: (matrix: Matrix) => void;\n /** Mark one layer dirty (omit to mark all); schedules a frame. */\n invalidate: (layerId?: string) => void;\n toBlob: (options?: { type?: string; quality?: number }) => Promise<Blob>;\n dispose: () => void;\n readonly disposed: boolean;\n readonly disposalSignal: AbortSignal;\n [Symbol.dispose]: () => void;\n}>;\n\nexport type Stage = StageController &\n Readonly<{\n readonly canvas: HTMLCanvasElement | OffscreenCanvas;\n readonly width: number;\n readonly height: number;\n readonly dpr: number;\n /** Current world→screen matrix (CSS pixels, without DPR). */\n readonly matrix: Matrix;\n readonly visibleRect: Rect;\n /** Run any pending repaint/composite synchronously; defaults `time` to the scheduler clock. */\n render: (time?: number) => StageFrameInfo;\n }>;\n\nconst DEFAULT_SCHEDULER: FrameScheduler = {\n // Workers may lack requestAnimationFrame; fall back to a timer there.\n cancelFrame: (handle) => {\n if (typeof cancelAnimationFrame === 'function') cancelAnimationFrame(handle);\n else clearTimeout(handle);\n },\n now: () => performance.now(),\n requestFrame: (callback) =>\n typeof requestAnimationFrame === 'function'\n ? requestAnimationFrame(callback)\n : (setTimeout(() => callback(performance.now()), 16) as unknown as number),\n};\n\nfunction defaultCreateSurface(width: number, height: number): StageSurface {\n if (typeof OffscreenCanvas !== 'undefined') {\n return new OffscreenCanvas(width, height) as unknown as StageSurface;\n }\n if (typeof document !== 'undefined') {\n const el = document.createElement('canvas');\n el.width = width;\n el.height = height;\n return el;\n }\n throw new StageUnsupportedError('No canvas surface factory is available in this environment.');\n}\n\ntype LayerRecord = {\n id: string;\n paint: (ctx: CanvasRenderingContext2D, frame: PaintContext) => void;\n surface: StageSurface | null;\n ctx: CanvasRenderingContext2D | null;\n dirty: boolean;\n};\n\n/**\n * Creates a retained-mode 2D stage: ordered layers, each with a cached\n * backing surface, repainted only when dirty and composited to the canvas\n * every scheduled frame. Paint callbacks draw in world units; the stage\n * applies the world→screen matrix and DPR to the context transform. The\n * caller owns the canvas CSS size; the stage only sizes the backing store.\n */\nexport function createStage(\n canvas: HTMLCanvasElement | OffscreenCanvas,\n options: StageOptions & Readonly<{ width: number; height: number }>,\n): Stage {\n const { width: initialWidth, height: initialHeight } = options;\n requireSize({ height: initialHeight, width: initialWidth }, 'Stage');\n requireDpr(options.dpr ?? 1, 'Stage');\n const scheduler = options.scheduler ?? DEFAULT_SCHEDULER;\n const createSurface = options.createSurface ?? defaultCreateSurface;\n const background = options.background ?? null;\n\n const controller = new AbortController();\n let disposed = false;\n let width = initialWidth;\n let height = initialHeight;\n let dpr = options.dpr ?? 1;\n let matrix: Matrix = [1, 0, 0, 1, 0, 0];\n let frameHandle: number | null = null;\n let pending = false;\n\n const layers: LayerRecord[] = [];\n for (const opts of options.layers) {\n if (layers.some((layer) => layer.id === opts.id)) {\n throw new StageConfigError(`Stage layer id \"${opts.id}\" is already registered.`);\n }\n layers.push({ ctx: null, dirty: true, id: opts.id, paint: opts.paint, surface: null });\n }\n\n const disposeSurface = (layer: LayerRecord): void => {\n if (layer.surface) {\n // Release backing-store memory for both canvas flavours.\n layer.surface.width = 0;\n layer.surface.height = 0;\n }\n layer.surface = null;\n layer.ctx = null;\n };\n\n const ensureSurface = (layer: LayerRecord): CanvasRenderingContext2D => {\n const pw = Math.max(1, Math.round(width * dpr));\n const ph = Math.max(1, Math.round(height * dpr));\n if (!layer.surface || layer.surface.width !== pw || layer.surface.height !== ph) {\n disposeSurface(layer);\n layer.surface = createSurface(pw, ph);\n const ctx = layer.surface.getContext('2d', { alpha: true });\n if (ctx == null) {\n throw new StageUnsupportedError(`Layer surface for \"${layer.id}\" has no 2D context.`);\n }\n layer.ctx = ctx as CanvasRenderingContext2D;\n layer.dirty = true;\n }\n return layer.ctx as CanvasRenderingContext2D;\n };\n\n const visibleRect = (): Rect => {\n const inv = invert(matrix);\n if (!inv) return { height, width, x: 0, y: 0 };\n const corners: [Point, Point, Point, Point] = [\n apply(inv, { x: 0, y: 0 }),\n apply(inv, { x: width, y: 0 }),\n apply(inv, { x: 0, y: height }),\n apply(inv, { x: width, y: height }),\n ];\n return rectFromPoints(corners);\n };\n\n const applyWorldTransform = (ctx: CanvasRenderingContext2D): void => {\n const [a, b, c, d, e, f] = matrix;\n ctx.setTransform(dpr * a, dpr * b, dpr * c, dpr * d, dpr * e, dpr * f);\n };\n\n const renderFrame = (time: number): StageFrameInfo => {\n pending = false;\n frameHandle = null;\n if (disposed) return { repainted: [], time };\n\n const rect = visibleRect();\n const frame: PaintContext = { dpr, matrix, time, visibleRect: rect };\n const repainted: string[] = [];\n\n for (const layer of layers) {\n if (layer.dirty) {\n const ctx = ensureSurface(layer);\n ctx.setTransform(1, 0, 0, 1, 0, 0);\n ctx.clearRect(0, 0, layer.surface?.width ?? 0, layer.surface?.height ?? 0);\n applyWorldTransform(ctx);\n layer.paint(ctx, frame);\n layer.dirty = false;\n repainted.push(layer.id);\n }\n }\n\n const screen = canvas.getContext('2d');\n if (screen) {\n const pw = Math.max(1, Math.round(width * dpr));\n const ph = Math.max(1, Math.round(height * dpr));\n const cw = Math.max(1, Math.round(canvas.width));\n const ch = Math.max(1, Math.round(canvas.height));\n screen.setTransform(1, 0, 0, 1, 0, 0);\n screen.clearRect(0, 0, cw, ch);\n if (background != null) {\n screen.fillStyle = background;\n screen.fillRect(0, 0, cw, ch);\n }\n for (const layer of layers) {\n if (layer.surface) {\n // Composite the cached layer at native pixels; canvas is sized pw x ph.\n screen.drawImage(layer.surface as unknown as CanvasImageSource, 0, 0, pw, ph);\n }\n }\n }\n return { repainted, time };\n };\n\n const schedule = (): void => {\n if (disposed || pending) return;\n pending = true;\n frameHandle = scheduler.requestFrame((time) => {\n if (pending) renderFrame(time);\n });\n };\n\n const invalidateAll = (): void => {\n for (const layer of layers) layer.dirty = true;\n };\n\n const cancelFrame = (): void => {\n if (frameHandle != null) {\n scheduler.cancelFrame(frameHandle);\n frameHandle = null;\n }\n pending = false;\n };\n\n const dispose = (): void => {\n if (disposed) return;\n disposed = true;\n cancelFrame();\n for (const layer of layers) disposeSurface(layer);\n layers.length = 0;\n controller.abort();\n };\n\n canvas.width = Math.max(1, Math.round(width * dpr));\n canvas.height = Math.max(1, Math.round(height * dpr));\n\n const stage: Stage = {\n get canvas() {\n return canvas;\n },\n get disposalSignal() {\n return controller.signal;\n },\n get disposed() {\n return disposed;\n },\n [Symbol.dispose]: dispose,\n dispose,\n get dpr() {\n return dpr;\n },\n get height() {\n return height;\n },\n invalidate(layerId) {\n if (disposed) return;\n if (layerId == null) {\n invalidateAll();\n } else {\n const layer = layers.find((l) => l.id === layerId);\n if (!layer) throw new StageConfigError(`Unknown stage layer \"${layerId}\".`);\n layer.dirty = true;\n }\n schedule();\n },\n get matrix() {\n return matrix;\n },\n render(time) {\n if (disposed) return { repainted: [], time: time ?? scheduler.now() };\n cancelFrame();\n return renderFrame(time ?? scheduler.now());\n },\n resize(size, nextDpr) {\n if (disposed) return;\n requireSize(size, 'Stage');\n const resolvedDpr = nextDpr ?? dpr;\n requireDpr(resolvedDpr, 'Stage');\n width = size.width;\n height = size.height;\n dpr = resolvedDpr;\n canvas.width = Math.max(1, Math.round(width * dpr));\n canvas.height = Math.max(1, Math.round(height * dpr));\n // Resizing clears the canvas backing store, so every layer repaints.\n invalidateAll();\n schedule();\n },\n setTransform(next) {\n if (disposed) return;\n requireFiniteMatrix(next);\n matrix = next;\n invalidateAll();\n schedule();\n },\n async toBlob(blobOptions) {\n if (disposed) throw new StageDisposedError('Cannot export a disposed stage.');\n // Export must capture the current frame, not the last painted one.\n if (pending) stage.render();\n const type = blobOptions?.type ?? 'image/png';\n if (typeof OffscreenCanvas !== 'undefined' && canvas instanceof OffscreenCanvas) {\n // OffscreenCanvas (worker-rendered stages): promise-based export.\n const blob = await canvas.convertToBlob({ quality: blobOptions?.quality, type });\n if (!blob) throw new StageUnsupportedError('Canvas blob export returned no data.');\n return blob;\n }\n const htmlCanvas = canvas as HTMLCanvasElement;\n if (typeof htmlCanvas.toBlob !== 'function') {\n throw new StageUnsupportedError('This canvas does not support blob export.');\n }\n const blob = await new Promise<Blob | null>((resolve) => {\n htmlCanvas.toBlob(resolve, type, blobOptions?.quality);\n });\n if (!blob) {\n throw new StageUnsupportedError('Canvas blob export returned no data.');\n }\n return blob;\n },\n get visibleRect() {\n return visibleRect();\n },\n get width() {\n return width;\n },\n };\n return stage;\n}\n"],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ import { type FrameScheduler, type Matrix, type Rect, type Size } from '@vielzeug/atlas';
2
+ /** A backing surface a layer paints into. `OffscreenCanvas` on workers. */
3
+ export type StageSurface = {
4
+ width: number;
5
+ height: number;
6
+ getContext: (type: '2d', attributes?: CanvasRenderingContext2DSettings) => unknown;
7
+ };
8
+ /** Factory for layer backing surfaces; injectable for tests and workers. */
9
+ export type CreateSurface = (width: number, height: number) => StageSurface;
10
+ export type PaintContext = Readonly<{
11
+ /** World→screen matrix (DPR already applied to the context transform). */
12
+ matrix: Matrix;
13
+ /** Visible world-space rect for culling. */
14
+ visibleRect: Rect;
15
+ /** Device pixel ratio in effect. */
16
+ dpr: number;
17
+ /** Frame timestamp from the scheduler. */
18
+ time: number;
19
+ }>;
20
+ export type StageLayerOptions = Readonly<{
21
+ id: string;
22
+ paint: (ctx: CanvasRenderingContext2D, frame: PaintContext) => void;
23
+ }>;
24
+ export type StageOptions = Readonly<{
25
+ dpr?: number;
26
+ /** Layers are fixed at creation, bottom-first; hide one by returning early from its paint. */
27
+ layers: readonly StageLayerOptions[];
28
+ /** Reuses the atlas camera scheduler contract; defaults to `requestAnimationFrame`. */
29
+ scheduler?: FrameScheduler;
30
+ createSurface?: CreateSurface;
31
+ /** Background color cleared under the layers; defaults to transparent. */
32
+ background?: string | null;
33
+ }>;
34
+ export type StageFrameInfo = Readonly<{
35
+ /** Layer ids that were repainted for this frame. */
36
+ repainted: readonly string[];
37
+ time: number;
38
+ }>;
39
+ /**
40
+ * The control surface both stage modes share: a main-thread `Stage` and a
41
+ * `WorkerStage` client are interchangeable wherever only control is needed.
42
+ */
43
+ export type StageController = Readonly<{
44
+ /** Resize the CSS size and DPR; reallocates backing surfaces and invalidates all. */
45
+ resize: (size: Size, dpr?: number) => void;
46
+ /** Set the world→screen matrix; invalidates all layers. */
47
+ setTransform: (matrix: Matrix) => void;
48
+ /** Mark one layer dirty (omit to mark all); schedules a frame. */
49
+ invalidate: (layerId?: string) => void;
50
+ toBlob: (options?: {
51
+ type?: string;
52
+ quality?: number;
53
+ }) => Promise<Blob>;
54
+ dispose: () => void;
55
+ readonly disposed: boolean;
56
+ readonly disposalSignal: AbortSignal;
57
+ [Symbol.dispose]: () => void;
58
+ }>;
59
+ export type Stage = StageController & Readonly<{
60
+ readonly canvas: HTMLCanvasElement | OffscreenCanvas;
61
+ readonly width: number;
62
+ readonly height: number;
63
+ readonly dpr: number;
64
+ /** Current world→screen matrix (CSS pixels, without DPR). */
65
+ readonly matrix: Matrix;
66
+ readonly visibleRect: Rect;
67
+ /** Run any pending repaint/composite synchronously; defaults `time` to the scheduler clock. */
68
+ render: (time?: number) => StageFrameInfo;
69
+ }>;
70
+ /**
71
+ * Creates a retained-mode 2D stage: ordered layers, each with a cached
72
+ * backing surface, repainted only when dirty and composited to the canvas
73
+ * every scheduled frame. Paint callbacks draw in world units; the stage
74
+ * applies the world→screen matrix and DPR to the context transform. The
75
+ * caller owns the canvas CSS size; the stage only sizes the backing store.
76
+ */
77
+ export declare function createStage(canvas: HTMLCanvasElement | OffscreenCanvas, options: StageOptions & Readonly<{
78
+ width: number;
79
+ height: number;
80
+ }>): Stage;
81
+ //# sourceMappingURL=stage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../src/stage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ var Stage=(function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var StageError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},StageConfigError=class extends StageError{},StageUnsupportedError=class extends StageError{},StageDisposedError=class extends StageError{};function requireSize(e,t){if(!Number.isFinite(e.width)||e.width<=0||!Number.isFinite(e.height)||e.height<=0)throw new StageConfigError(`${t} size must be positive finite numbers, got ${e.width}x${e.height}.`)}function requireDpr(e,t){if(!Number.isFinite(e)||e<=0)throw new StageConfigError(`${t} dpr must be a positive finite number, got ${e}.`)}function requireFiniteMatrix(e){for(let t of e)if(!Number.isFinite(t))throw new StageConfigError(`Stage matrix must contain only finite numbers, got ${t}.`)}var n={cancelFrame:e=>{typeof cancelAnimationFrame==`function`?cancelAnimationFrame(e):clearTimeout(e)},now:()=>performance.now(),requestFrame:e=>typeof requestAnimationFrame==`function`?requestAnimationFrame(e):setTimeout(()=>e(performance.now()),16)};function defaultCreateSurface(e,t){if(typeof OffscreenCanvas<`u`)return new OffscreenCanvas(e,t);if(typeof document<`u`){let n=document.createElement(`canvas`);return n.width=e,n.height=t,n}throw new StageUnsupportedError(`No canvas surface factory is available in this environment.`)}function createStage(e,r){let{width:i,height:a}=r;requireSize({height:a,width:i},`Stage`),requireDpr(r.dpr??1,`Stage`);let o=r.scheduler??n,s=r.createSurface??defaultCreateSurface,c=r.background??null,l=new AbortController,u=!1,d=i,f=a,p=r.dpr??1,m=[1,0,0,1,0,0],h=null,g=!1,_=[];for(let e of r.layers){if(_.some(t=>t.id===e.id))throw new StageConfigError(`Stage layer id "${e.id}" is already registered.`);_.push({ctx:null,dirty:!0,id:e.id,paint:e.paint,surface:null})}let disposeSurface=e=>{e.surface&&(e.surface.width=0,e.surface.height=0),e.surface=null,e.ctx=null},ensureSurface=e=>{let t=Math.max(1,Math.round(d*p)),n=Math.max(1,Math.round(f*p));if(!e.surface||e.surface.width!==t||e.surface.height!==n){disposeSurface(e),e.surface=s(t,n);let r=e.surface.getContext(`2d`,{alpha:!0});if(r==null)throw new StageUnsupportedError(`Layer surface for "${e.id}" has no 2D context.`);e.ctx=r,e.dirty=!0}return e.ctx},visibleRect=()=>{let e=(0,t.invert)(m);if(!e)return{height:f,width:d,x:0,y:0};let n=[(0,t.apply)(e,{x:0,y:0}),(0,t.apply)(e,{x:d,y:0}),(0,t.apply)(e,{x:0,y:f}),(0,t.apply)(e,{x:d,y:f})];return(0,t.rectFromPoints)(n)},applyWorldTransform=e=>{let[t,n,r,i,a,o]=m;e.setTransform(p*t,p*n,p*r,p*i,p*a,p*o)},renderFrame=t=>{if(g=!1,h=null,u)return{repainted:[],time:t};let n=visibleRect(),r={dpr:p,matrix:m,time:t,visibleRect:n},i=[];for(let e of _)if(e.dirty){let t=ensureSurface(e);t.setTransform(1,0,0,1,0,0),t.clearRect(0,0,e.surface?.width??0,e.surface?.height??0),applyWorldTransform(t),e.paint(t,r),e.dirty=!1,i.push(e.id)}let a=e.getContext(`2d`);if(a){let t=Math.max(1,Math.round(d*p)),n=Math.max(1,Math.round(f*p)),r=Math.max(1,Math.round(e.width)),i=Math.max(1,Math.round(e.height));a.setTransform(1,0,0,1,0,0),a.clearRect(0,0,r,i),c!=null&&(a.fillStyle=c,a.fillRect(0,0,r,i));for(let e of _)e.surface&&a.drawImage(e.surface,0,0,t,n)}return{repainted:i,time:t}},schedule=()=>{u||g||(g=!0,h=o.requestFrame(e=>{g&&renderFrame(e)}))},invalidateAll=()=>{for(let e of _)e.dirty=!0},cancelFrame=()=>{h!=null&&(o.cancelFrame(h),h=null),g=!1},dispose=()=>{if(!u){u=!0,cancelFrame();for(let e of _)disposeSurface(e);_.length=0,l.abort()}};e.width=Math.max(1,Math.round(d*p)),e.height=Math.max(1,Math.round(f*p));let v={get canvas(){return e},get disposalSignal(){return l.signal},get disposed(){return u},[Symbol.dispose]:dispose,dispose,get dpr(){return p},get height(){return f},invalidate(e){if(!u){if(e==null)invalidateAll();else{let t=_.find(t=>t.id===e);if(!t)throw new StageConfigError(`Unknown stage layer "${e}".`);t.dirty=!0}schedule()}},get matrix(){return m},render(e){return u?{repainted:[],time:e??o.now()}:(cancelFrame(),renderFrame(e??o.now()))},resize(t,n){if(u)return;requireSize(t,`Stage`);let r=n??p;requireDpr(r,`Stage`),d=t.width,f=t.height,p=r,e.width=Math.max(1,Math.round(d*p)),e.height=Math.max(1,Math.round(f*p)),invalidateAll(),schedule()},setTransform(e){u||(requireFiniteMatrix(e),m=e,invalidateAll(),schedule())},async toBlob(t){if(u)throw new StageDisposedError(`Cannot export a disposed stage.`);g&&v.render();let n=t?.type??`image/png`;if(typeof OffscreenCanvas<`u`&&e instanceof OffscreenCanvas){let r=await e.convertToBlob({quality:t?.quality,type:n});if(!r)throw new StageUnsupportedError(`Canvas blob export returned no data.`);return r}let r=e;if(typeof r.toBlob!=`function`)throw new StageUnsupportedError(`This canvas does not support blob export.`);let i=await new Promise(e=>{r.toBlob(e,n,t?.quality)});if(!i)throw new StageUnsupportedError(`Canvas blob export returned no data.`);return i},get visibleRect(){return visibleRect()},get width(){return d}};return v}return e.StageConfigError=StageConfigError,e.StageDisposedError=StageDisposedError,e.StageError=StageError,e.StageUnsupportedError=StageUnsupportedError,e.createStage=createStage,e})({},Atlas);
2
+ //# sourceMappingURL=stage.iife.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stage.iife.js","names":["invert","apply","rectFromPoints","exports","message","opts","size","context","dpr","value","matrix","DEFAULT_SCHEDULER","handle","callback","width","height","el","initialWidth","initialHeight","options","scheduler","createSurface","background","controller","disposed","frameHandle","pending","layers","layer","pw","ph","ctx","inv","_vielzeug_atlas","corners","a","b","c","d","e","f","rect","frame","repainted","screen","canvas","cw","ch","time","stage","layerId","l","resolvedDpr","nextDpr","next","type","blobOptions","blob","htmlCanvas","resolve"],"sources":["../src/errors.ts","../src/_validate.ts","../src/stage.ts"],"sourcesContent":["export class StageError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n}\n\nexport class StageConfigError extends StageError {}\n\n/** A required browser capability (e.g. canvas blob export) is missing. */\nexport class StageUnsupportedError extends StageError {}\n\n/** The stage (or its worker) was disposed before a pending request settled. */\nexport class StageDisposedError extends StageError {}\n","/** Shared input validation for the main-thread and worker stage halves. */\n\nimport type { Matrix, Size } from '@vielzeug/atlas';\nimport { StageConfigError } from './errors.js';\n\n/** @internal */\nexport function requireSize(size: Size, context: string): void {\n if (!Number.isFinite(size.width) || size.width <= 0 || !Number.isFinite(size.height) || size.height <= 0) {\n throw new StageConfigError(`${context} size must be positive finite numbers, got ${size.width}x${size.height}.`);\n }\n}\n\n/** @internal */\nexport function requireDpr(dpr: number, context: string): void {\n if (!Number.isFinite(dpr) || dpr <= 0) {\n throw new StageConfigError(`${context} dpr must be a positive finite number, got ${dpr}.`);\n }\n}\n\n/** @internal */\nexport function requireFiniteMatrix(matrix: Matrix): void {\n for (const value of matrix) {\n if (!Number.isFinite(value)) {\n throw new StageConfigError(`Stage matrix must contain only finite numbers, got ${value}.`);\n }\n }\n}\n","import {\n apply,\n type FrameScheduler,\n invert,\n type Matrix,\n type Point,\n type Rect,\n rectFromPoints,\n type Size,\n} from '@vielzeug/atlas';\nimport { requireDpr, requireFiniteMatrix, requireSize } from './_validate.js';\nimport { StageConfigError, StageDisposedError, StageUnsupportedError } from './errors.js';\n\n/** A backing surface a layer paints into. `OffscreenCanvas` on workers. */\nexport type StageSurface = {\n width: number;\n height: number;\n getContext: (type: '2d', attributes?: CanvasRenderingContext2DSettings) => unknown;\n};\n\n/** Factory for layer backing surfaces; injectable for tests and workers. */\nexport type CreateSurface = (width: number, height: number) => StageSurface;\n\nexport type PaintContext = Readonly<{\n /** World→screen matrix (DPR already applied to the context transform). */\n matrix: Matrix;\n /** Visible world-space rect for culling. */\n visibleRect: Rect;\n /** Device pixel ratio in effect. */\n dpr: number;\n /** Frame timestamp from the scheduler. */\n time: number;\n}>;\n\nexport type StageLayerOptions = Readonly<{\n id: string;\n paint: (ctx: CanvasRenderingContext2D, frame: PaintContext) => void;\n}>;\n\nexport type StageOptions = Readonly<{\n dpr?: number;\n /** Layers are fixed at creation, bottom-first; hide one by returning early from its paint. */\n layers: readonly StageLayerOptions[];\n /** Reuses the atlas camera scheduler contract; defaults to `requestAnimationFrame`. */\n scheduler?: FrameScheduler;\n createSurface?: CreateSurface;\n /** Background color cleared under the layers; defaults to transparent. */\n background?: string | null;\n}>;\n\nexport type StageFrameInfo = Readonly<{\n /** Layer ids that were repainted for this frame. */\n repainted: readonly string[];\n time: number;\n}>;\n\n/**\n * The control surface both stage modes share: a main-thread `Stage` and a\n * `WorkerStage` client are interchangeable wherever only control is needed.\n */\nexport type StageController = Readonly<{\n /** Resize the CSS size and DPR; reallocates backing surfaces and invalidates all. */\n resize: (size: Size, dpr?: number) => void;\n /** Set the world→screen matrix; invalidates all layers. */\n setTransform: (matrix: Matrix) => void;\n /** Mark one layer dirty (omit to mark all); schedules a frame. */\n invalidate: (layerId?: string) => void;\n toBlob: (options?: { type?: string; quality?: number }) => Promise<Blob>;\n dispose: () => void;\n readonly disposed: boolean;\n readonly disposalSignal: AbortSignal;\n [Symbol.dispose]: () => void;\n}>;\n\nexport type Stage = StageController &\n Readonly<{\n readonly canvas: HTMLCanvasElement | OffscreenCanvas;\n readonly width: number;\n readonly height: number;\n readonly dpr: number;\n /** Current world→screen matrix (CSS pixels, without DPR). */\n readonly matrix: Matrix;\n readonly visibleRect: Rect;\n /** Run any pending repaint/composite synchronously; defaults `time` to the scheduler clock. */\n render: (time?: number) => StageFrameInfo;\n }>;\n\nconst DEFAULT_SCHEDULER: FrameScheduler = {\n // Workers may lack requestAnimationFrame; fall back to a timer there.\n cancelFrame: (handle) => {\n if (typeof cancelAnimationFrame === 'function') cancelAnimationFrame(handle);\n else clearTimeout(handle);\n },\n now: () => performance.now(),\n requestFrame: (callback) =>\n typeof requestAnimationFrame === 'function'\n ? requestAnimationFrame(callback)\n : (setTimeout(() => callback(performance.now()), 16) as unknown as number),\n};\n\nfunction defaultCreateSurface(width: number, height: number): StageSurface {\n if (typeof OffscreenCanvas !== 'undefined') {\n return new OffscreenCanvas(width, height) as unknown as StageSurface;\n }\n if (typeof document !== 'undefined') {\n const el = document.createElement('canvas');\n el.width = width;\n el.height = height;\n return el;\n }\n throw new StageUnsupportedError('No canvas surface factory is available in this environment.');\n}\n\ntype LayerRecord = {\n id: string;\n paint: (ctx: CanvasRenderingContext2D, frame: PaintContext) => void;\n surface: StageSurface | null;\n ctx: CanvasRenderingContext2D | null;\n dirty: boolean;\n};\n\n/**\n * Creates a retained-mode 2D stage: ordered layers, each with a cached\n * backing surface, repainted only when dirty and composited to the canvas\n * every scheduled frame. Paint callbacks draw in world units; the stage\n * applies the world→screen matrix and DPR to the context transform. The\n * caller owns the canvas CSS size; the stage only sizes the backing store.\n */\nexport function createStage(\n canvas: HTMLCanvasElement | OffscreenCanvas,\n options: StageOptions & Readonly<{ width: number; height: number }>,\n): Stage {\n const { width: initialWidth, height: initialHeight } = options;\n requireSize({ height: initialHeight, width: initialWidth }, 'Stage');\n requireDpr(options.dpr ?? 1, 'Stage');\n const scheduler = options.scheduler ?? DEFAULT_SCHEDULER;\n const createSurface = options.createSurface ?? defaultCreateSurface;\n const background = options.background ?? null;\n\n const controller = new AbortController();\n let disposed = false;\n let width = initialWidth;\n let height = initialHeight;\n let dpr = options.dpr ?? 1;\n let matrix: Matrix = [1, 0, 0, 1, 0, 0];\n let frameHandle: number | null = null;\n let pending = false;\n\n const layers: LayerRecord[] = [];\n for (const opts of options.layers) {\n if (layers.some((layer) => layer.id === opts.id)) {\n throw new StageConfigError(`Stage layer id \"${opts.id}\" is already registered.`);\n }\n layers.push({ ctx: null, dirty: true, id: opts.id, paint: opts.paint, surface: null });\n }\n\n const disposeSurface = (layer: LayerRecord): void => {\n if (layer.surface) {\n // Release backing-store memory for both canvas flavours.\n layer.surface.width = 0;\n layer.surface.height = 0;\n }\n layer.surface = null;\n layer.ctx = null;\n };\n\n const ensureSurface = (layer: LayerRecord): CanvasRenderingContext2D => {\n const pw = Math.max(1, Math.round(width * dpr));\n const ph = Math.max(1, Math.round(height * dpr));\n if (!layer.surface || layer.surface.width !== pw || layer.surface.height !== ph) {\n disposeSurface(layer);\n layer.surface = createSurface(pw, ph);\n const ctx = layer.surface.getContext('2d', { alpha: true });\n if (ctx == null) {\n throw new StageUnsupportedError(`Layer surface for \"${layer.id}\" has no 2D context.`);\n }\n layer.ctx = ctx as CanvasRenderingContext2D;\n layer.dirty = true;\n }\n return layer.ctx as CanvasRenderingContext2D;\n };\n\n const visibleRect = (): Rect => {\n const inv = invert(matrix);\n if (!inv) return { height, width, x: 0, y: 0 };\n const corners: [Point, Point, Point, Point] = [\n apply(inv, { x: 0, y: 0 }),\n apply(inv, { x: width, y: 0 }),\n apply(inv, { x: 0, y: height }),\n apply(inv, { x: width, y: height }),\n ];\n return rectFromPoints(corners);\n };\n\n const applyWorldTransform = (ctx: CanvasRenderingContext2D): void => {\n const [a, b, c, d, e, f] = matrix;\n ctx.setTransform(dpr * a, dpr * b, dpr * c, dpr * d, dpr * e, dpr * f);\n };\n\n const renderFrame = (time: number): StageFrameInfo => {\n pending = false;\n frameHandle = null;\n if (disposed) return { repainted: [], time };\n\n const rect = visibleRect();\n const frame: PaintContext = { dpr, matrix, time, visibleRect: rect };\n const repainted: string[] = [];\n\n for (const layer of layers) {\n if (layer.dirty) {\n const ctx = ensureSurface(layer);\n ctx.setTransform(1, 0, 0, 1, 0, 0);\n ctx.clearRect(0, 0, layer.surface?.width ?? 0, layer.surface?.height ?? 0);\n applyWorldTransform(ctx);\n layer.paint(ctx, frame);\n layer.dirty = false;\n repainted.push(layer.id);\n }\n }\n\n const screen = canvas.getContext('2d');\n if (screen) {\n const pw = Math.max(1, Math.round(width * dpr));\n const ph = Math.max(1, Math.round(height * dpr));\n const cw = Math.max(1, Math.round(canvas.width));\n const ch = Math.max(1, Math.round(canvas.height));\n screen.setTransform(1, 0, 0, 1, 0, 0);\n screen.clearRect(0, 0, cw, ch);\n if (background != null) {\n screen.fillStyle = background;\n screen.fillRect(0, 0, cw, ch);\n }\n for (const layer of layers) {\n if (layer.surface) {\n // Composite the cached layer at native pixels; canvas is sized pw x ph.\n screen.drawImage(layer.surface as unknown as CanvasImageSource, 0, 0, pw, ph);\n }\n }\n }\n return { repainted, time };\n };\n\n const schedule = (): void => {\n if (disposed || pending) return;\n pending = true;\n frameHandle = scheduler.requestFrame((time) => {\n if (pending) renderFrame(time);\n });\n };\n\n const invalidateAll = (): void => {\n for (const layer of layers) layer.dirty = true;\n };\n\n const cancelFrame = (): void => {\n if (frameHandle != null) {\n scheduler.cancelFrame(frameHandle);\n frameHandle = null;\n }\n pending = false;\n };\n\n const dispose = (): void => {\n if (disposed) return;\n disposed = true;\n cancelFrame();\n for (const layer of layers) disposeSurface(layer);\n layers.length = 0;\n controller.abort();\n };\n\n canvas.width = Math.max(1, Math.round(width * dpr));\n canvas.height = Math.max(1, Math.round(height * dpr));\n\n const stage: Stage = {\n get canvas() {\n return canvas;\n },\n get disposalSignal() {\n return controller.signal;\n },\n get disposed() {\n return disposed;\n },\n [Symbol.dispose]: dispose,\n dispose,\n get dpr() {\n return dpr;\n },\n get height() {\n return height;\n },\n invalidate(layerId) {\n if (disposed) return;\n if (layerId == null) {\n invalidateAll();\n } else {\n const layer = layers.find((l) => l.id === layerId);\n if (!layer) throw new StageConfigError(`Unknown stage layer \"${layerId}\".`);\n layer.dirty = true;\n }\n schedule();\n },\n get matrix() {\n return matrix;\n },\n render(time) {\n if (disposed) return { repainted: [], time: time ?? scheduler.now() };\n cancelFrame();\n return renderFrame(time ?? scheduler.now());\n },\n resize(size, nextDpr) {\n if (disposed) return;\n requireSize(size, 'Stage');\n const resolvedDpr = nextDpr ?? dpr;\n requireDpr(resolvedDpr, 'Stage');\n width = size.width;\n height = size.height;\n dpr = resolvedDpr;\n canvas.width = Math.max(1, Math.round(width * dpr));\n canvas.height = Math.max(1, Math.round(height * dpr));\n // Resizing clears the canvas backing store, so every layer repaints.\n invalidateAll();\n schedule();\n },\n setTransform(next) {\n if (disposed) return;\n requireFiniteMatrix(next);\n matrix = next;\n invalidateAll();\n schedule();\n },\n async toBlob(blobOptions) {\n if (disposed) throw new StageDisposedError('Cannot export a disposed stage.');\n // Export must capture the current frame, not the last painted one.\n if (pending) stage.render();\n const type = blobOptions?.type ?? 'image/png';\n if (typeof OffscreenCanvas !== 'undefined' && canvas instanceof OffscreenCanvas) {\n // OffscreenCanvas (worker-rendered stages): promise-based export.\n const blob = await canvas.convertToBlob({ quality: blobOptions?.quality, type });\n if (!blob) throw new StageUnsupportedError('Canvas blob export returned no data.');\n return blob;\n }\n const htmlCanvas = canvas as HTMLCanvasElement;\n if (typeof htmlCanvas.toBlob !== 'function') {\n throw new StageUnsupportedError('This canvas does not support blob export.');\n }\n const blob = await new Promise<Blob | null>((resolve) => {\n htmlCanvas.toBlob(resolve, type, blobOptions?.quality);\n });\n if (!blob) {\n throw new StageUnsupportedError('Canvas blob export returned no data.');\n }\n return blob;\n },\n get visibleRect() {\n return visibleRect();\n },\n get width() {\n return width;\n },\n };\n return stage;\n}\n"],"mappings":"A,sFAAA,IAAa,WAAb,cAAgC,KAAM,CACpC,YAAY,EAAiB,EAAqB,CAChD,MAAMI,EAASC,CAAI,EACnB,KAAK,KAAO,WAAW,KACvB,OAAO,eAAe,KAAM,WAAW,SAAS,CAClD,CACF,EAEa,iBAAb,cAAsC,UAAW,CAAC,EAGrC,sBAAb,cAA2C,UAAW,CAAC,EAG1C,mBAAb,cAAwC,UAAW,CAAC,ECRpD,SAAgB,YAAY,EAAY,EAAuB,CAC7D,GAAI,CAAC,OAAO,SAASC,EAAK,KAAK,GAAKA,EAAK,OAAS,GAAK,CAAC,OAAO,SAASA,EAAK,MAAM,GAAKA,EAAK,QAAU,EACrG,MAAM,IAAI,iBAAiB,GAAGC,EAAQ,6CAA6CD,EAAK,MAAM,GAAGA,EAAK,OAAO,EAAE,CAEnH,CAGA,SAAgB,WAAW,EAAa,EAAuB,CAC7D,GAAI,CAAC,OAAO,SAASE,CAAG,GAAKA,GAAO,EAClC,MAAM,IAAI,iBAAiB,GAAGD,EAAQ,6CAA6CC,EAAI,EAAE,CAE7F,CAGA,SAAgB,oBAAoB,EAAsB,CACxD,IAAK,IAAMC,KAASC,EAClB,GAAI,CAAC,OAAO,SAASD,CAAK,EACxB,MAAM,IAAI,iBAAiB,sDAAsDA,EAAM,EAAE,CAG/F,CC6DA,IAAME,EAAoC,CAExC,YAAc,GAAW,CACnB,OAAO,sBAAyB,WAAY,qBAAqBC,CAAM,EACtE,aAAaA,CAAM,CAC1B,EACA,QAAW,YAAY,IAAI,EAC3B,aAAe,GACb,OAAO,uBAA0B,WAC7B,sBAAsBC,CAAQ,EAC7B,eAAiBA,EAAS,YAAY,IAAI,CAAC,EAAG,EAAE,CACzD,EAEA,SAAS,qBAAqB,EAAe,EAA8B,CACzE,GAAI,OAAO,gBAAoB,IAC7B,OAAO,IAAI,gBAAgBC,EAAOC,CAAM,EAE1C,GAAI,OAAO,SAAa,IAAa,CACnC,IAAMC,EAAK,SAAS,cAAc,QAAQ,EAG1C,MAFA,GAAG,MAAQF,EACX,EAAG,OAASC,EACLC,CACT,CACA,MAAM,IAAI,sBAAsB,6DAA6D,CAC/F,CAiBA,SAAgB,YACd,EACA,EACO,CACP,GAAM,CAAE,MAAOC,EAAc,OAAQC,GAAkBC,EACvD,YAAY,CAAE,OAAQD,EAAe,MAAOD,CAAa,EAAG,OAAO,EACnE,WAAWE,EAAQ,KAAO,EAAG,OAAO,EACpC,IAAMC,EAAYD,EAAQ,WAAaR,EACjCU,EAAgBF,EAAQ,eAAiB,qBACzCG,EAAaH,EAAQ,YAAc,KAEnCI,EAAa,IAAI,gBACnBC,EAAW,GACXV,EAAQG,EACRF,EAASG,EACTV,EAAMW,EAAQ,KAAO,EACrBT,EAAiB,CAAC,EAAG,EAAG,EAAG,EAAG,EAAG,CAAC,EAClCe,EAA6B,KAC7BC,EAAU,GAERC,EAAwB,CAAC,EAC/B,IAAK,IAAMtB,KAAQc,EAAQ,OAAQ,CACjC,GAAIQ,EAAO,KAAM,GAAUC,EAAM,KAAOvB,EAAK,EAAE,EAC7C,MAAM,IAAI,iBAAiB,mBAAmBA,EAAK,GAAG,yBAAyB,EAEjFsB,EAAO,KAAK,CAAE,IAAK,KAAM,MAAO,GAAM,GAAItB,EAAK,GAAI,MAAOA,EAAK,MAAO,QAAS,IAAK,CAAC,CACvF,CAEA,IAAM,eAAkB,GAA6B,CAC/CuB,EAAM,UAER,EAAM,QAAQ,MAAQ,EACtB,EAAM,QAAQ,OAAS,GAEzB,EAAM,QAAU,KAChB,EAAM,IAAM,IACd,EAEM,cAAiB,GAAiD,CACtE,IAAMC,EAAK,KAAK,IAAI,EAAG,KAAK,MAAMf,EAAQN,CAAG,CAAC,EACxCsB,EAAK,KAAK,IAAI,EAAG,KAAK,MAAMf,EAASP,CAAG,CAAC,EAC/C,GAAI,CAACoB,EAAM,SAAWA,EAAM,QAAQ,QAAUC,GAAMD,EAAM,QAAQ,SAAWE,EAAI,CAC/E,eAAeF,CAAK,EACpB,EAAM,QAAUP,EAAcQ,EAAIC,CAAE,EACpC,IAAMC,EAAMH,EAAM,QAAQ,WAAW,KAAM,CAAE,MAAO,EAAK,CAAC,EAC1D,GAAIG,GAAO,KACT,MAAM,IAAI,sBAAsB,sBAAsBH,EAAM,GAAG,qBAAqB,EAEtF,EAAM,IAAMG,EACZ,EAAM,MAAQ,EAChB,CACA,OAAOH,EAAM,GACf,EAEM,gBAA0B,CAC9B,IAAMI,GAAA,EAAMhC,EAAAA,OAAAA,CAAOU,CAAM,EACzB,GAAI,CAACsB,EAAK,MAAO,CAAE,SAAQ,QAAO,EAAG,EAAG,EAAG,CAAE,EAC7C,IAAME,EAAwC,EAC5CjC,EAAAA,EAAAA,MAAAA,CAAM+B,EAAK,CAAE,EAAG,EAAG,EAAG,CAAE,CAAC,GACzB/B,EAAAA,EAAAA,MAAAA,CAAM+B,EAAK,CAAE,EAAGlB,EAAO,EAAG,CAAE,CAAC,GAC7Bb,EAAAA,EAAAA,MAAAA,CAAM+B,EAAK,CAAE,EAAG,EAAG,EAAGjB,CAAO,CAAC,GAC9Bd,EAAAA,EAAAA,MAAAA,CAAM+B,EAAK,CAAE,EAAGlB,EAAO,EAAGC,CAAO,CAAC,CACpC,EACA,OAAA,EAAOb,EAAAA,eAAAA,CAAegC,CAAO,CAC/B,EAEM,oBAAuB,GAAwC,CACnE,GAAM,CAACC,EAAGC,EAAGC,EAAGC,EAAGC,EAAGC,GAAK9B,EAC3BqB,EAAI,aAAavB,EAAM2B,EAAG3B,EAAM4B,EAAG5B,EAAM6B,EAAG7B,EAAM8B,EAAG9B,EAAM+B,EAAG/B,EAAMgC,CAAC,CACvE,EAEM,YAAe,GAAiC,CAGpD,GAFA,EAAU,GACV,EAAc,KACVhB,EAAU,MAAO,CAAE,UAAW,CAAC,EAAG,MAAK,EAE3C,IAAMiB,EAAO,YAAY,EACnBC,EAAsB,CAAE,MAAK,SAAQ,OAAM,YAAaD,CAAK,EAC7DE,EAAsB,CAAC,EAE7B,IAAK,IAAMf,KAASD,EAClB,GAAIC,EAAM,MAAO,CACf,IAAMG,EAAM,cAAcH,CAAK,EAC/BG,EAAI,aAAa,EAAG,EAAG,EAAG,EAAG,EAAG,CAAC,EACjCA,EAAI,UAAU,EAAG,EAAGH,EAAM,SAAS,OAAS,EAAGA,EAAM,SAAS,QAAU,CAAC,EACzE,oBAAoBG,CAAG,EACvBH,EAAM,MAAMG,EAAKW,CAAK,EACtB,EAAM,MAAQ,GACdC,EAAU,KAAKf,EAAM,EAAE,CACzB,CAGF,IAAMgB,EAASC,EAAO,WAAW,IAAI,EACrC,GAAID,EAAQ,CACV,IAAMf,EAAK,KAAK,IAAI,EAAG,KAAK,MAAMf,EAAQN,CAAG,CAAC,EACxCsB,EAAK,KAAK,IAAI,EAAG,KAAK,MAAMf,EAASP,CAAG,CAAC,EACzCsC,EAAK,KAAK,IAAI,EAAG,KAAK,MAAMD,EAAO,KAAK,CAAC,EACzCE,EAAK,KAAK,IAAI,EAAG,KAAK,MAAMF,EAAO,MAAM,CAAC,EAChDD,EAAO,aAAa,EAAG,EAAG,EAAG,EAAG,EAAG,CAAC,EACpCA,EAAO,UAAU,EAAG,EAAGE,EAAIC,CAAE,EACzBzB,GAAc,OAChB,EAAO,UAAYA,EACnBsB,EAAO,SAAS,EAAG,EAAGE,EAAIC,CAAE,GAE9B,IAAK,IAAMnB,KAASD,EACdC,EAAM,SAERgB,EAAO,UAAUhB,EAAM,QAAyC,EAAG,EAAGC,EAAIC,CAAE,CAGlF,CACA,MAAO,CAAE,YAAW,MAAK,CAC3B,EAEM,aAAuB,CACvBN,GAAYE,IAChB,EAAU,GACV,EAAcN,EAAU,aAAc,GAAS,CACzCM,GAAS,YAAYsB,CAAI,CAC/B,CAAC,EACH,EAEM,kBAA4B,CAChC,IAAK,IAAMpB,KAASD,EAAQ,EAAM,MAAQ,EAC5C,EAEM,gBAA0B,CAC1BF,GAAe,OACjBL,EAAU,YAAYK,CAAW,EACjC,EAAc,MAEhB,EAAU,EACZ,EAEM,YAAsB,CAC1B,GAAI,GACJ,GAAW,GACX,YAAY,EACZ,IAAK,IAAMG,KAASD,EAAQ,eAAeC,CAAK,EAChD,EAAO,OAAS,EAChBL,EAAW,MAAM,CAJN,CAKb,EAEA,EAAO,MAAQ,KAAK,IAAI,EAAG,KAAK,MAAMT,EAAQN,CAAG,CAAC,EAClD,EAAO,OAAS,KAAK,IAAI,EAAG,KAAK,MAAMO,EAASP,CAAG,CAAC,EAEpD,IAAMyC,EAAe,CACnB,IAAI,QAAS,CACX,OAAOJ,CACT,EACA,IAAI,gBAAiB,CACnB,OAAOtB,EAAW,MACpB,EACA,IAAI,UAAW,CACb,OAAOC,CACT,GACC,OAAO,SAAU,QAClB,QACA,IAAI,KAAM,CACR,OAAOhB,CACT,EACA,IAAI,QAAS,CACX,OAAOO,CACT,EACA,WAAW,EAAS,CAClB,GAAI,GACJ,IAAImC,GAAW,KACb,cAAc,MACT,CACL,IAAMtB,EAAQD,EAAO,KAAM,GAAMwB,EAAE,KAAOD,CAAO,EACjD,GAAI,CAACtB,EAAO,MAAM,IAAI,iBAAiB,wBAAwBsB,EAAQ,GAAG,EAC1E,EAAM,MAAQ,EAChB,CACA,SAAS,CADT,CAEF,EACA,IAAI,QAAS,CACX,OAAOxC,CACT,EACA,OAAO,EAAM,CAGX,OAFIc,EAAiB,CAAE,UAAW,CAAC,EAAG,KAAMwB,GAAQ5B,EAAU,IAAI,CAAE,GACpE,YAAY,EACL,YAAY4B,GAAQ5B,EAAU,IAAI,CAAC,EAC5C,EACA,OAAO,EAAM,EAAS,CACpB,GAAII,EAAU,OACd,YAAYlB,EAAM,OAAO,EACzB,IAAM8C,EAAcC,GAAW7C,EAC/B,WAAW4C,EAAa,OAAO,EAC/B,EAAQ9C,EAAK,MACb,EAASA,EAAK,OACd,EAAM8C,EACN,EAAO,MAAQ,KAAK,IAAI,EAAG,KAAK,MAAMtC,EAAQN,CAAG,CAAC,EAClD,EAAO,OAAS,KAAK,IAAI,EAAG,KAAK,MAAMO,EAASP,CAAG,CAAC,EAEpD,cAAc,EACd,SAAS,CACX,EACA,aAAa,EAAM,CACbgB,IACJ,oBAAoB8B,CAAI,EACxB,EAASA,EACT,cAAc,EACd,SAAS,EACX,EACA,MAAM,OAAO,EAAa,CACxB,GAAI9B,EAAU,MAAM,IAAI,mBAAmB,iCAAiC,EAExEE,GAASuB,EAAM,OAAO,EAC1B,IAAMM,EAAOC,GAAa,MAAQ,YAClC,GAAI,OAAO,gBAAoB,KAAeX,aAAkB,gBAAiB,CAE/E,IAAMY,EAAO,MAAMZ,EAAO,cAAc,CAAE,QAASW,GAAa,QAAS,MAAK,CAAC,EAC/E,GAAI,CAACC,EAAM,MAAM,IAAI,sBAAsB,sCAAsC,EACjF,OAAOA,CACT,CACA,IAAMC,EAAab,EACnB,GAAI,OAAOa,EAAW,QAAW,WAC/B,MAAM,IAAI,sBAAsB,2CAA2C,EAE7E,IAAMD,EAAO,MAAM,IAAI,QAAsB,GAAY,CACvDC,EAAW,OAAOC,EAASJ,EAAMC,GAAa,OAAO,CACvD,CAAC,EACD,GAAI,CAACC,EACH,MAAM,IAAI,sBAAsB,sCAAsC,EAExE,OAAOA,CACT,EACA,IAAI,aAAc,CAChB,OAAO,YAAY,CACrB,EACA,IAAI,OAAQ,CACV,OAAO3C,CACT,CACF,EACA,OAAOmC,CACT,C"}