@vielzeug/stage 26.11.23 → 26.11.25
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.
- package/README.md +1 -1
- package/dist/_validate.cjs +1 -1
- package/dist/_validate.cjs.map +1 -1
- package/dist/_validate.js +7 -1
- package/dist/_validate.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/stage.cjs +1 -1
- package/dist/stage.cjs.map +1 -1
- package/dist/stage.d.ts +24 -4
- package/dist/stage.d.ts.map +1 -1
- package/dist/stage.iife.js +1 -1
- package/dist/stage.iife.js.map +1 -1
- package/dist/stage.js +120 -82
- package/dist/stage.js.map +1 -1
- package/dist/worker/main.cjs +1 -1
- package/dist/worker/main.js +3 -3
- package/dist/worker/protocol.d.ts +3 -5
- package/dist/worker/protocol.d.ts.map +1 -1
- package/dist/worker/serve.cjs +1 -1
- package/dist/worker/serve.js +3 -3
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -38,7 +38,7 @@ stage.invalidate('tokens'); // only the tokens layer repaints
|
|
|
38
38
|
- **Dirty repaints**: invalidate one layer or all; frames coalesce via an injectable scheduler
|
|
39
39
|
- **DPR-aware transforms**: paint in world units, the stage scales by `dpr × matrix`
|
|
40
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
|
|
41
|
+
- **`toBlob()`**: PNG export that flushes pending frames, with optional world-space `region`/`scale` re-render and typed unsupported-capability errors
|
|
42
42
|
- **Injectable surfaces**: `createSurface` factory for tests and `OffscreenCanvas` workers
|
|
43
43
|
- **`@vielzeug/stage/worker`**: worker-rendered stages via a transferred `OffscreenCanvas` and a typed scene channel
|
|
44
44
|
|
package/dist/_validate.cjs
CHANGED
|
@@ -1,2 +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;
|
|
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 requireRect(t,n){if(!Number.isFinite(t.x)||!Number.isFinite(t.y)||!Number.isFinite(t.width)||t.width<=0||!Number.isFinite(t.height)||t.height<=0)throw new e.StageConfigError(`${n} region must have finite coordinates and positive finite size, got ${t.width}x${t.height} at ${t.x},${t.y}.`)}function requireScale(t,n){if(!Number.isFinite(t)||t<=0)throw new e.StageConfigError(`${n} scale 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.requireRect=requireRect,exports.requireScale=requireScale,exports.requireSize=requireSize;
|
|
2
2
|
//# sourceMappingURL=_validate.cjs.map
|
package/dist/_validate.cjs.map
CHANGED
|
@@ -1 +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,
|
|
1
|
+
{"version":3,"file":"_validate.cjs","names":["StageConfigError","require_errors","size","context","dpr","rect","scale","value","matrix"],"sources":["../src/_validate.ts"],"sourcesContent":["/** Shared input validation for the main-thread and worker stage halves. */\n\nimport type { Matrix, Rect, 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 requireRect(rect: Rect, context: string): void {\n if (\n !Number.isFinite(rect.x) ||\n !Number.isFinite(rect.y) ||\n !Number.isFinite(rect.width) ||\n rect.width <= 0 ||\n !Number.isFinite(rect.height) ||\n rect.height <= 0\n ) {\n throw new StageConfigError(\n `${context} region must have finite coordinates and positive finite size, got ${rect.width}x${rect.height} at ${rect.x},${rect.y}.`,\n );\n }\n}\n\n/** @internal */\nexport function requireScale(scale: number, context: string): void {\n if (!Number.isFinite(scale) || scale <= 0) {\n throw new StageConfigError(`${context} scale must be a positive finite number, got ${scale}.`);\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,YAAY,EAAY,EAAuB,CAC7D,GACE,CAAC,OAAO,SAASC,EAAK,CAAC,GACvB,CAAC,OAAO,SAASA,EAAK,CAAC,GACvB,CAAC,OAAO,SAASA,EAAK,KAAK,GAC3BA,EAAK,OAAS,GACd,CAAC,OAAO,SAASA,EAAK,MAAM,GAC5BA,EAAK,QAAU,EAEf,MAAM,IAAIL,EAAAA,iBACR,GAAGG,EAAQ,qEAAqEE,EAAK,MAAM,GAAGA,EAAK,OAAO,MAAMA,EAAK,EAAE,GAAGA,EAAK,EAAE,EACnI,CAEJ,CAGA,SAAgB,aAAa,EAAe,EAAuB,CACjE,GAAI,CAAC,OAAO,SAASC,CAAK,GAAKA,GAAS,EACtC,MAAM,IAAIN,EAAAA,iBAAiB,GAAGG,EAAQ,+CAA+CG,EAAM,EAAE,CAEjG,CAGA,SAAgB,oBAAoB,EAAsB,CACxD,IAAK,IAAMC,KAASC,EAClB,GAAI,CAAC,OAAO,SAASD,CAAK,EACxB,MAAM,IAAIP,EAAAA,iBAAiB,sDAAsDO,EAAM,EAAE,CAG/F,C"}
|
package/dist/_validate.js
CHANGED
|
@@ -6,9 +6,15 @@ function requireSize(t, n) {
|
|
|
6
6
|
function requireDpr(t, n) {
|
|
7
7
|
if (!Number.isFinite(t) || t <= 0) throw new e(`${n} dpr must be a positive finite number, got ${t}.`);
|
|
8
8
|
}
|
|
9
|
+
function requireRect(t, n) {
|
|
10
|
+
if (!Number.isFinite(t.x) || !Number.isFinite(t.y) || !Number.isFinite(t.width) || t.width <= 0 || !Number.isFinite(t.height) || t.height <= 0) throw new e(`${n} region must have finite coordinates and positive finite size, got ${t.width}x${t.height} at ${t.x},${t.y}.`);
|
|
11
|
+
}
|
|
12
|
+
function requireScale(t, n) {
|
|
13
|
+
if (!Number.isFinite(t) || t <= 0) throw new e(`${n} scale must be a positive finite number, got ${t}.`);
|
|
14
|
+
}
|
|
9
15
|
function requireFiniteMatrix(t) {
|
|
10
16
|
for (let n of t) if (!Number.isFinite(n)) throw new e(`Stage matrix must contain only finite numbers, got ${n}.`);
|
|
11
17
|
}
|
|
12
|
-
export { requireDpr, requireFiniteMatrix, requireSize };
|
|
18
|
+
export { requireDpr, requireFiniteMatrix, requireRect, requireScale, requireSize };
|
|
13
19
|
|
|
14
20
|
//# sourceMappingURL=_validate.js.map
|
package/dist/_validate.js.map
CHANGED
|
@@ -1 +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,
|
|
1
|
+
{"version":3,"file":"_validate.js","names":["size","StageConfigError","context","dpr","rect","scale","value","matrix"],"sources":["../src/_validate.ts"],"sourcesContent":["/** Shared input validation for the main-thread and worker stage halves. */\n\nimport type { Matrix, Rect, 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 requireRect(rect: Rect, context: string): void {\n if (\n !Number.isFinite(rect.x) ||\n !Number.isFinite(rect.y) ||\n !Number.isFinite(rect.width) ||\n rect.width <= 0 ||\n !Number.isFinite(rect.height) ||\n rect.height <= 0\n ) {\n throw new StageConfigError(\n `${context} region must have finite coordinates and positive finite size, got ${rect.width}x${rect.height} at ${rect.x},${rect.y}.`,\n );\n }\n}\n\n/** @internal */\nexport function requireScale(scale: number, context: string): void {\n if (!Number.isFinite(scale) || scale <= 0) {\n throw new StageConfigError(`${context} scale must be a positive finite number, got ${scale}.`);\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,YAAY,GAAY,GAAuB;CAC7D,IACE,CAAC,OAAO,SAASC,EAAK,CAAC,KACvB,CAAC,OAAO,SAASA,EAAK,CAAC,KACvB,CAAC,OAAO,SAASA,EAAK,KAAK,KAC3BA,EAAK,SAAS,KACd,CAAC,OAAO,SAASA,EAAK,MAAM,KAC5BA,EAAK,UAAU,GAEf,MAAM,IAAIH,EACR,GAAGC,EAAQ,qEAAqEE,EAAK,MAAM,GAAGA,EAAK,OAAO,MAAMA,EAAK,EAAE,GAAGA,EAAK,EAAE,EACnI;AAEJ;AAGA,SAAgB,aAAa,GAAe,GAAuB;CACjE,IAAI,CAAC,OAAO,SAASC,CAAK,KAAKA,KAAS,GACtC,MAAM,IAAIJ,EAAiB,GAAGC,EAAQ,+CAA+CG,EAAM,EAAE;AAEjG;AAGA,SAAgB,oBAAoB,GAAsB;CACxD,KAAK,IAAMC,KAASC,GAClB,IAAI,CAAC,OAAO,SAASD,CAAK,GACxB,MAAM,IAAIL,EAAiB,sDAAsDK,EAAM,EAAE;AAG/F"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
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';
|
|
2
|
+
export { type CreateSurface, createStage, type PaintContext, type Stage, type StageBlobOptions, type StageController, type StageFrameInfo, type StageLayerOptions, type StageOptions, type StageSurface, } from './stage.js';
|
|
3
3
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +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"}
|
|
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,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC"}
|
package/dist/stage.cjs
CHANGED
|
@@ -1,2 +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`;
|
|
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 requireRect(e,t){if(!Number.isFinite(e.x)||!Number.isFinite(e.y)||!Number.isFinite(e.width)||e.width<=0||!Number.isFinite(e.height)||e.height<=0)throw new StageConfigError(`${t} region must have finite coordinates and positive finite size, got ${e.width}x${e.height} at ${e.x},${e.y}.`)}function requireScale(e,t){if(!Number.isFinite(e)||e<=0)throw new StageConfigError(`${t} scale 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)},surfaceToBlob=async(e,t,n)=>{if(typeof OffscreenCanvas<`u`&&e instanceof OffscreenCanvas){let r=await e.convertToBlob({quality:n,type:t});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,t,n)});if(!i)throw new StageUnsupportedError(`Canvas blob export returned no data.`);return i},exportRegion=async(t,n)=>{let r=t.region??visibleRect();requireRect(r,`Export`);let i=t.scale??p*(0,e.scaleOf)(m);requireScale(i,`Export`);let a=Math.max(1,Math.round(r.width*i)),l=Math.max(1,Math.round(r.height*i)),u=(0,e.multiply)((0,e.scale)(i),(0,e.translate)(-r.x,-r.y)),d={dpr:1,matrix:u,time:o.now(),visibleRect:r},f=[];try{let e=s(a,l);f.push(e);let r=e.getContext(`2d`,{alpha:!0});if(r==null)throw new StageUnsupportedError(`Export surface has no 2D context.`);r.setTransform(1,0,0,1,0,0),r.clearRect(0,0,a,l),c!=null&&(r.fillStyle=c,r.fillRect(0,0,a,l));for(let e of _){let t=s(a,l);f.push(t);let n=t.getContext(`2d`,{alpha:!0});if(n==null)throw new StageUnsupportedError(`Layer surface for "${e.id}" has no 2D context.`);n.setTransform(1,0,0,1,0,0),n.clearRect(0,0,a,l);let[i,o,c,p,m,h]=u;n.setTransform(i,o,c,p,m,h),e.paint(n,d),r.drawImage(t,0,0,a,l)}return await surfaceToBlob(e,n,t.quality)}finally{for(let e of f)e.width=0,e.height=0}},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`;return e?.region!=null||e?.scale!=null?await exportRegion(e,t):await surfaceToBlob(n,t,e?.quality)},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
2
|
//# sourceMappingURL=stage.cjs.map
|
package/dist/stage.cjs.map
CHANGED
|
@@ -1 +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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"}
|
|
1
|
+
{"version":3,"file":"stage.cjs","names":["invert","apply","rectFromPoints","scaleOf","multiply","scaleMatrix","translate","_vielzeug_atlas","message","opts","size","context","dpr","rect","scale","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","surface","blob","htmlCanvas","resolve","type","quality","region","exportScale","exportMatrix","frame","scratch","output","outCtx","repainted","screen","canvas","cw","ch","time","stage","layerId","l","resolvedDpr","nextDpr","next","blobOptions"],"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, Rect, 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 requireRect(rect: Rect, context: string): void {\n if (\n !Number.isFinite(rect.x) ||\n !Number.isFinite(rect.y) ||\n !Number.isFinite(rect.width) ||\n rect.width <= 0 ||\n !Number.isFinite(rect.height) ||\n rect.height <= 0\n ) {\n throw new StageConfigError(\n `${context} region must have finite coordinates and positive finite size, got ${rect.width}x${rect.height} at ${rect.x},${rect.y}.`,\n );\n }\n}\n\n/** @internal */\nexport function requireScale(scale: number, context: string): void {\n if (!Number.isFinite(scale) || scale <= 0) {\n throw new StageConfigError(`${context} scale must be a positive finite number, got ${scale}.`);\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 multiply,\n type Point,\n type Rect,\n rectFromPoints,\n type Size,\n scale as scaleMatrix,\n scaleOf,\n translate,\n} from '@vielzeug/atlas';\nimport { requireDpr, requireFiniteMatrix, requireRect, requireScale, 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\n/** Options for `toBlob()`: blob encoding plus an optional world-space crop and pixel density. */\nexport type StageBlobOptions = Readonly<{\n /** Blob MIME type; defaults to `image/png`. */\n type?: string;\n /** Encoder quality for lossy types. */\n quality?: number;\n /**\n * World-space rect to export; defaults to the current visible rect. The\n * export re-paints every layer against the region transform, so cost is a\n * full repaint, not a blit of the cached composite.\n */\n region?: Rect;\n /**\n * Export pixels per world unit. Defaults to the current device pixels per\n * world unit (`dpr × matrix scale`), which matches the on-screen density.\n */\n scale?: number;\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 /**\n * Export the current frame as a blob. With `region`/`scale`, layers are\n * re-painted into scratch surfaces at the requested crop and density;\n * the live viewport is untouched.\n */\n toBlob: (options?: StageBlobOptions) => 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 /** Rasterize a surface (live canvas or scratch) into a blob; shared by both export paths. */\n const surfaceToBlob = async (surface: StageSurface, type: string, quality?: number): Promise<Blob> => {\n if (typeof OffscreenCanvas !== 'undefined' && surface instanceof OffscreenCanvas) {\n // OffscreenCanvas (worker-rendered stages): promise-based export.\n const blob = await surface.convertToBlob({ quality, type });\n if (!blob) throw new StageUnsupportedError('Canvas blob export returned no data.');\n return blob;\n }\n const htmlCanvas = surface as unknown 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, quality);\n });\n if (!blob) {\n throw new StageUnsupportedError('Canvas blob export returned no data.');\n }\n return blob;\n };\n\n /**\n * Region/scale export: layer caches are keyed to the live viewport\n * transform, so the requested crop cannot blit the cached composite. Every\n * layer is re-painted into scratch surfaces against the export transform\n * `translate(-region) × scale` (dpr 1; `scale` maps world units to export\n * pixels) and composited into a scratch output surface. The live frame,\n * caches, and dirty flags are untouched; the cost is a full repaint.\n */\n const exportRegion = async (options: StageBlobOptions, type: string): Promise<Blob> => {\n const region = options.region ?? visibleRect();\n requireRect(region, 'Export');\n // Default density matches the on-screen one: device pixels per world unit.\n const exportScale = options.scale ?? dpr * scaleOf(matrix);\n requireScale(exportScale, 'Export');\n const pw = Math.max(1, Math.round(region.width * exportScale));\n const ph = Math.max(1, Math.round(region.height * exportScale));\n const exportMatrix = multiply(scaleMatrix(exportScale), translate(-region.x, -region.y));\n const frame: PaintContext = { dpr: 1, matrix: exportMatrix, time: scheduler.now(), visibleRect: region };\n const scratch: StageSurface[] = [];\n try {\n const output = createSurface(pw, ph);\n scratch.push(output);\n const outCtx = output.getContext('2d', { alpha: true }) as CanvasRenderingContext2D | null;\n if (outCtx == null) {\n throw new StageUnsupportedError('Export surface has no 2D context.');\n }\n outCtx.setTransform(1, 0, 0, 1, 0, 0);\n outCtx.clearRect(0, 0, pw, ph);\n if (background != null) {\n outCtx.fillStyle = background;\n outCtx.fillRect(0, 0, pw, ph);\n }\n for (const layer of layers) {\n const surface = createSurface(pw, ph);\n scratch.push(surface);\n const ctx = surface.getContext('2d', { alpha: true }) as CanvasRenderingContext2D | null;\n if (ctx == null) {\n throw new StageUnsupportedError(`Layer surface for \"${layer.id}\" has no 2D context.`);\n }\n ctx.setTransform(1, 0, 0, 1, 0, 0);\n ctx.clearRect(0, 0, pw, ph);\n const [a, b, c, d, e, f] = exportMatrix;\n ctx.setTransform(a, b, c, d, e, f);\n layer.paint(ctx, frame);\n outCtx.drawImage(surface as unknown as CanvasImageSource, 0, 0, pw, ph);\n }\n return await surfaceToBlob(output, type, options.quality);\n } finally {\n for (const surface of scratch) {\n surface.width = 0;\n surface.height = 0;\n }\n }\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 (blobOptions?.region != null || blobOptions?.scale != null) {\n return await exportRegion(blobOptions, type);\n }\n return await surfaceToBlob(canvas, type, blobOptions?.quality);\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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"}
|
package/dist/stage.d.ts
CHANGED
|
@@ -31,6 +31,24 @@ export type StageOptions = Readonly<{
|
|
|
31
31
|
/** Background color cleared under the layers; defaults to transparent. */
|
|
32
32
|
background?: string | null;
|
|
33
33
|
}>;
|
|
34
|
+
/** Options for `toBlob()`: blob encoding plus an optional world-space crop and pixel density. */
|
|
35
|
+
export type StageBlobOptions = Readonly<{
|
|
36
|
+
/** Blob MIME type; defaults to `image/png`. */
|
|
37
|
+
type?: string;
|
|
38
|
+
/** Encoder quality for lossy types. */
|
|
39
|
+
quality?: number;
|
|
40
|
+
/**
|
|
41
|
+
* World-space rect to export; defaults to the current visible rect. The
|
|
42
|
+
* export re-paints every layer against the region transform, so cost is a
|
|
43
|
+
* full repaint, not a blit of the cached composite.
|
|
44
|
+
*/
|
|
45
|
+
region?: Rect;
|
|
46
|
+
/**
|
|
47
|
+
* Export pixels per world unit. Defaults to the current device pixels per
|
|
48
|
+
* world unit (`dpr × matrix scale`), which matches the on-screen density.
|
|
49
|
+
*/
|
|
50
|
+
scale?: number;
|
|
51
|
+
}>;
|
|
34
52
|
export type StageFrameInfo = Readonly<{
|
|
35
53
|
/** Layer ids that were repainted for this frame. */
|
|
36
54
|
repainted: readonly string[];
|
|
@@ -47,10 +65,12 @@ export type StageController = Readonly<{
|
|
|
47
65
|
setTransform: (matrix: Matrix) => void;
|
|
48
66
|
/** Mark one layer dirty (omit to mark all); schedules a frame. */
|
|
49
67
|
invalidate: (layerId?: string) => void;
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
68
|
+
/**
|
|
69
|
+
* Export the current frame as a blob. With `region`/`scale`, layers are
|
|
70
|
+
* re-painted into scratch surfaces at the requested crop and density;
|
|
71
|
+
* the live viewport is untouched.
|
|
72
|
+
*/
|
|
73
|
+
toBlob: (options?: StageBlobOptions) => Promise<Blob>;
|
|
54
74
|
dispose: () => void;
|
|
55
75
|
readonly disposed: boolean;
|
|
56
76
|
readonly disposalSignal: AbortSignal;
|
package/dist/stage.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../src/stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,MAAM,
|
|
1
|
+
{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../src/stage.ts"],"names":[],"mappings":"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"}
|
package/dist/stage.iife.js
CHANGED
|
@@ -1,2 +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`;
|
|
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 requireRect(e,t){if(!Number.isFinite(e.x)||!Number.isFinite(e.y)||!Number.isFinite(e.width)||e.width<=0||!Number.isFinite(e.height)||e.height<=0)throw new StageConfigError(`${t} region must have finite coordinates and positive finite size, got ${e.width}x${e.height} at ${e.x},${e.y}.`)}function requireScale(e,t){if(!Number.isFinite(e)||e<=0)throw new StageConfigError(`${t} scale 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)},surfaceToBlob=async(e,t,n)=>{if(typeof OffscreenCanvas<`u`&&e instanceof OffscreenCanvas){let r=await e.convertToBlob({quality:n,type:t});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,t,n)});if(!i)throw new StageUnsupportedError(`Canvas blob export returned no data.`);return i},exportRegion=async(e,n)=>{let r=e.region??visibleRect();requireRect(r,`Export`);let i=e.scale??p*(0,t.scaleOf)(m);requireScale(i,`Export`);let a=Math.max(1,Math.round(r.width*i)),l=Math.max(1,Math.round(r.height*i)),u=(0,t.multiply)((0,t.scale)(i),(0,t.translate)(-r.x,-r.y)),d={dpr:1,matrix:u,time:o.now(),visibleRect:r},f=[];try{let t=s(a,l);f.push(t);let r=t.getContext(`2d`,{alpha:!0});if(r==null)throw new StageUnsupportedError(`Export surface has no 2D context.`);r.setTransform(1,0,0,1,0,0),r.clearRect(0,0,a,l),c!=null&&(r.fillStyle=c,r.fillRect(0,0,a,l));for(let e of _){let t=s(a,l);f.push(t);let n=t.getContext(`2d`,{alpha:!0});if(n==null)throw new StageUnsupportedError(`Layer surface for "${e.id}" has no 2D context.`);n.setTransform(1,0,0,1,0,0),n.clearRect(0,0,a,l);let[i,o,c,p,m,h]=u;n.setTransform(i,o,c,p,m,h),e.paint(n,d),r.drawImage(t,0,0,a,l)}return await surfaceToBlob(t,n,e.quality)}finally{for(let e of f)e.width=0,e.height=0}},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`;return t?.region!=null||t?.scale!=null?await exportRegion(t,n):await surfaceToBlob(e,n,t?.quality)},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
2
|
//# sourceMappingURL=stage.iife.js.map
|
package/dist/stage.iife.js.map
CHANGED
|
@@ -1 +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":"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"}
|
|
1
|
+
{"version":3,"file":"stage.iife.js","names":["invert","apply","rectFromPoints","scaleOf","multiply","scaleMatrix","translate","exports","message","opts","size","context","dpr","rect","scale","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","surface","blob","htmlCanvas","resolve","type","quality","region","exportScale","exportMatrix","frame","scratch","output","outCtx","repainted","screen","canvas","cw","ch","time","stage","layerId","l","resolvedDpr","nextDpr","next","blobOptions"],"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, Rect, 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 requireRect(rect: Rect, context: string): void {\n if (\n !Number.isFinite(rect.x) ||\n !Number.isFinite(rect.y) ||\n !Number.isFinite(rect.width) ||\n rect.width <= 0 ||\n !Number.isFinite(rect.height) ||\n rect.height <= 0\n ) {\n throw new StageConfigError(\n `${context} region must have finite coordinates and positive finite size, got ${rect.width}x${rect.height} at ${rect.x},${rect.y}.`,\n );\n }\n}\n\n/** @internal */\nexport function requireScale(scale: number, context: string): void {\n if (!Number.isFinite(scale) || scale <= 0) {\n throw new StageConfigError(`${context} scale must be a positive finite number, got ${scale}.`);\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 multiply,\n type Point,\n type Rect,\n rectFromPoints,\n type Size,\n scale as scaleMatrix,\n scaleOf,\n translate,\n} from '@vielzeug/atlas';\nimport { requireDpr, requireFiniteMatrix, requireRect, requireScale, 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\n/** Options for `toBlob()`: blob encoding plus an optional world-space crop and pixel density. */\nexport type StageBlobOptions = Readonly<{\n /** Blob MIME type; defaults to `image/png`. */\n type?: string;\n /** Encoder quality for lossy types. */\n quality?: number;\n /**\n * World-space rect to export; defaults to the current visible rect. The\n * export re-paints every layer against the region transform, so cost is a\n * full repaint, not a blit of the cached composite.\n */\n region?: Rect;\n /**\n * Export pixels per world unit. Defaults to the current device pixels per\n * world unit (`dpr × matrix scale`), which matches the on-screen density.\n */\n scale?: number;\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 /**\n * Export the current frame as a blob. With `region`/`scale`, layers are\n * re-painted into scratch surfaces at the requested crop and density;\n * the live viewport is untouched.\n */\n toBlob: (options?: StageBlobOptions) => 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 /** Rasterize a surface (live canvas or scratch) into a blob; shared by both export paths. */\n const surfaceToBlob = async (surface: StageSurface, type: string, quality?: number): Promise<Blob> => {\n if (typeof OffscreenCanvas !== 'undefined' && surface instanceof OffscreenCanvas) {\n // OffscreenCanvas (worker-rendered stages): promise-based export.\n const blob = await surface.convertToBlob({ quality, type });\n if (!blob) throw new StageUnsupportedError('Canvas blob export returned no data.');\n return blob;\n }\n const htmlCanvas = surface as unknown 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, quality);\n });\n if (!blob) {\n throw new StageUnsupportedError('Canvas blob export returned no data.');\n }\n return blob;\n };\n\n /**\n * Region/scale export: layer caches are keyed to the live viewport\n * transform, so the requested crop cannot blit the cached composite. Every\n * layer is re-painted into scratch surfaces against the export transform\n * `translate(-region) × scale` (dpr 1; `scale` maps world units to export\n * pixels) and composited into a scratch output surface. The live frame,\n * caches, and dirty flags are untouched; the cost is a full repaint.\n */\n const exportRegion = async (options: StageBlobOptions, type: string): Promise<Blob> => {\n const region = options.region ?? visibleRect();\n requireRect(region, 'Export');\n // Default density matches the on-screen one: device pixels per world unit.\n const exportScale = options.scale ?? dpr * scaleOf(matrix);\n requireScale(exportScale, 'Export');\n const pw = Math.max(1, Math.round(region.width * exportScale));\n const ph = Math.max(1, Math.round(region.height * exportScale));\n const exportMatrix = multiply(scaleMatrix(exportScale), translate(-region.x, -region.y));\n const frame: PaintContext = { dpr: 1, matrix: exportMatrix, time: scheduler.now(), visibleRect: region };\n const scratch: StageSurface[] = [];\n try {\n const output = createSurface(pw, ph);\n scratch.push(output);\n const outCtx = output.getContext('2d', { alpha: true }) as CanvasRenderingContext2D | null;\n if (outCtx == null) {\n throw new StageUnsupportedError('Export surface has no 2D context.');\n }\n outCtx.setTransform(1, 0, 0, 1, 0, 0);\n outCtx.clearRect(0, 0, pw, ph);\n if (background != null) {\n outCtx.fillStyle = background;\n outCtx.fillRect(0, 0, pw, ph);\n }\n for (const layer of layers) {\n const surface = createSurface(pw, ph);\n scratch.push(surface);\n const ctx = surface.getContext('2d', { alpha: true }) as CanvasRenderingContext2D | null;\n if (ctx == null) {\n throw new StageUnsupportedError(`Layer surface for \"${layer.id}\" has no 2D context.`);\n }\n ctx.setTransform(1, 0, 0, 1, 0, 0);\n ctx.clearRect(0, 0, pw, ph);\n const [a, b, c, d, e, f] = exportMatrix;\n ctx.setTransform(a, b, c, d, e, f);\n layer.paint(ctx, frame);\n outCtx.drawImage(surface as unknown as CanvasImageSource, 0, 0, pw, ph);\n }\n return await surfaceToBlob(output, type, options.quality);\n } finally {\n for (const surface of scratch) {\n surface.width = 0;\n surface.height = 0;\n }\n }\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 (blobOptions?.region != null || blobOptions?.scale != null) {\n return await exportRegion(blobOptions, type);\n }\n return await surfaceToBlob(canvas, type, blobOptions?.quality);\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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"}
|
package/dist/stage.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { apply as e, invert as t,
|
|
1
|
+
import { apply as e, invert as t, multiply as n, rectFromPoints as r, scale as i, scaleOf as a, translate as o } from "@vielzeug/atlas";
|
|
2
2
|
// src/errors.ts
|
|
3
3
|
var StageError = class extends Error {
|
|
4
4
|
constructor(e, t) {
|
|
@@ -12,11 +12,17 @@ function requireSize(e, t) {
|
|
|
12
12
|
function requireDpr(e, t) {
|
|
13
13
|
if (!Number.isFinite(e) || e <= 0) throw new StageConfigError(`${t} dpr must be a positive finite number, got ${e}.`);
|
|
14
14
|
}
|
|
15
|
+
function requireRect(e, t) {
|
|
16
|
+
if (!Number.isFinite(e.x) || !Number.isFinite(e.y) || !Number.isFinite(e.width) || e.width <= 0 || !Number.isFinite(e.height) || e.height <= 0) throw new StageConfigError(`${t} region must have finite coordinates and positive finite size, got ${e.width}x${e.height} at ${e.x},${e.y}.`);
|
|
17
|
+
}
|
|
18
|
+
function requireScale(e, t) {
|
|
19
|
+
if (!Number.isFinite(e) || e <= 0) throw new StageConfigError(`${t} scale must be a positive finite number, got ${e}.`);
|
|
20
|
+
}
|
|
15
21
|
function requireFiniteMatrix(e) {
|
|
16
22
|
for (let t of e) if (!Number.isFinite(t)) throw new StageConfigError(`Stage matrix must contain only finite numbers, got ${t}.`);
|
|
17
23
|
}
|
|
18
24
|
// src/stage.ts
|
|
19
|
-
var
|
|
25
|
+
var s = {
|
|
20
26
|
cancelFrame: (e) => {
|
|
21
27
|
typeof cancelAnimationFrame == "function" ? cancelAnimationFrame(e) : clearTimeout(e);
|
|
22
28
|
},
|
|
@@ -31,23 +37,23 @@ function defaultCreateSurface(e, t) {
|
|
|
31
37
|
}
|
|
32
38
|
throw new StageUnsupportedError("No canvas surface factory is available in this environment.");
|
|
33
39
|
}
|
|
34
|
-
function createStage(
|
|
35
|
-
let { width:
|
|
40
|
+
function createStage(c, l) {
|
|
41
|
+
let { width: u, height: d } = l;
|
|
36
42
|
requireSize({
|
|
37
|
-
height:
|
|
38
|
-
width:
|
|
39
|
-
}, "Stage"), requireDpr(
|
|
40
|
-
let
|
|
43
|
+
height: d,
|
|
44
|
+
width: u
|
|
45
|
+
}, "Stage"), requireDpr(l.dpr ?? 1, "Stage");
|
|
46
|
+
let f = l.scheduler ?? s, p = l.createSurface ?? defaultCreateSurface, m = l.background ?? null, h = new AbortController(), g = !1, _ = u, v = d, y = l.dpr ?? 1, b = [
|
|
41
47
|
1,
|
|
42
48
|
0,
|
|
43
49
|
0,
|
|
44
50
|
1,
|
|
45
51
|
0,
|
|
46
52
|
0
|
|
47
|
-
],
|
|
48
|
-
for (let e of
|
|
49
|
-
if (
|
|
50
|
-
|
|
53
|
+
], x = null, S = !1, C = [];
|
|
54
|
+
for (let e of l.layers) {
|
|
55
|
+
if (C.some((t) => t.id === e.id)) throw new StageConfigError(`Stage layer id "${e.id}" is already registered.`);
|
|
56
|
+
C.push({
|
|
51
57
|
ctx: null,
|
|
52
58
|
dirty: !0,
|
|
53
59
|
id: e.id,
|
|
@@ -58,108 +64,154 @@ function createStage(i, a) {
|
|
|
58
64
|
let disposeSurface = (e) => {
|
|
59
65
|
e.surface && (e.surface.width = 0, e.surface.height = 0), e.surface = null, e.ctx = null;
|
|
60
66
|
}, ensureSurface = (e) => {
|
|
61
|
-
let t = Math.max(1, Math.round(
|
|
67
|
+
let t = Math.max(1, Math.round(_ * y)), n = Math.max(1, Math.round(v * y));
|
|
62
68
|
if (!e.surface || e.surface.width !== t || e.surface.height !== n) {
|
|
63
|
-
disposeSurface(e), e.surface =
|
|
69
|
+
disposeSurface(e), e.surface = p(t, n);
|
|
64
70
|
let r = e.surface.getContext("2d", { alpha: !0 });
|
|
65
71
|
if (r == null) throw new StageUnsupportedError(`Layer surface for "${e.id}" has no 2D context.`);
|
|
66
72
|
e.ctx = r, e.dirty = !0;
|
|
67
73
|
}
|
|
68
74
|
return e.ctx;
|
|
69
75
|
}, visibleRect = () => {
|
|
70
|
-
let
|
|
71
|
-
if (!
|
|
72
|
-
height:
|
|
73
|
-
width:
|
|
76
|
+
let n = t(b);
|
|
77
|
+
if (!n) return {
|
|
78
|
+
height: v,
|
|
79
|
+
width: _,
|
|
74
80
|
x: 0,
|
|
75
81
|
y: 0
|
|
76
82
|
};
|
|
77
83
|
let i = [
|
|
78
|
-
e(
|
|
84
|
+
e(n, {
|
|
79
85
|
x: 0,
|
|
80
86
|
y: 0
|
|
81
87
|
}),
|
|
82
|
-
e(
|
|
83
|
-
x:
|
|
88
|
+
e(n, {
|
|
89
|
+
x: _,
|
|
84
90
|
y: 0
|
|
85
91
|
}),
|
|
86
|
-
e(
|
|
92
|
+
e(n, {
|
|
87
93
|
x: 0,
|
|
88
|
-
y:
|
|
94
|
+
y: v
|
|
89
95
|
}),
|
|
90
|
-
e(
|
|
91
|
-
x:
|
|
92
|
-
y:
|
|
96
|
+
e(n, {
|
|
97
|
+
x: _,
|
|
98
|
+
y: v
|
|
93
99
|
})
|
|
94
100
|
];
|
|
95
|
-
return
|
|
101
|
+
return r(i);
|
|
96
102
|
}, applyWorldTransform = (e) => {
|
|
97
|
-
let [t, n, r, i, a, o] =
|
|
98
|
-
e.setTransform(
|
|
103
|
+
let [t, n, r, i, a, o] = b;
|
|
104
|
+
e.setTransform(y * t, y * n, y * r, y * i, y * a, y * o);
|
|
105
|
+
}, surfaceToBlob = async (e, t, n) => {
|
|
106
|
+
if (typeof OffscreenCanvas < "u" && e instanceof OffscreenCanvas) {
|
|
107
|
+
let r = await e.convertToBlob({
|
|
108
|
+
quality: n,
|
|
109
|
+
type: t
|
|
110
|
+
});
|
|
111
|
+
if (!r) throw new StageUnsupportedError("Canvas blob export returned no data.");
|
|
112
|
+
return r;
|
|
113
|
+
}
|
|
114
|
+
let r = e;
|
|
115
|
+
if (typeof r.toBlob != "function") throw new StageUnsupportedError("This canvas does not support blob export.");
|
|
116
|
+
let i = await new Promise((e) => {
|
|
117
|
+
r.toBlob(e, t, n);
|
|
118
|
+
});
|
|
119
|
+
if (!i) throw new StageUnsupportedError("Canvas blob export returned no data.");
|
|
120
|
+
return i;
|
|
121
|
+
}, exportRegion = async (e, t) => {
|
|
122
|
+
let r = e.region ?? visibleRect();
|
|
123
|
+
requireRect(r, "Export");
|
|
124
|
+
let s = e.scale ?? y * a(b);
|
|
125
|
+
requireScale(s, "Export");
|
|
126
|
+
let c = Math.max(1, Math.round(r.width * s)), l = Math.max(1, Math.round(r.height * s)), u = n(i(s), o(-r.x, -r.y)), d = {
|
|
127
|
+
dpr: 1,
|
|
128
|
+
matrix: u,
|
|
129
|
+
time: f.now(),
|
|
130
|
+
visibleRect: r
|
|
131
|
+
}, h = [];
|
|
132
|
+
try {
|
|
133
|
+
let n = p(c, l);
|
|
134
|
+
h.push(n);
|
|
135
|
+
let r = n.getContext("2d", { alpha: !0 });
|
|
136
|
+
if (r == null) throw new StageUnsupportedError("Export surface has no 2D context.");
|
|
137
|
+
r.setTransform(1, 0, 0, 1, 0, 0), r.clearRect(0, 0, c, l), m != null && (r.fillStyle = m, r.fillRect(0, 0, c, l));
|
|
138
|
+
for (let e of C) {
|
|
139
|
+
let t = p(c, l);
|
|
140
|
+
h.push(t);
|
|
141
|
+
let n = t.getContext("2d", { alpha: !0 });
|
|
142
|
+
if (n == null) throw new StageUnsupportedError(`Layer surface for "${e.id}" has no 2D context.`);
|
|
143
|
+
n.setTransform(1, 0, 0, 1, 0, 0), n.clearRect(0, 0, c, l);
|
|
144
|
+
let [i, a, o, s, f, m] = u;
|
|
145
|
+
n.setTransform(i, a, o, s, f, m), e.paint(n, d), r.drawImage(t, 0, 0, c, l);
|
|
146
|
+
}
|
|
147
|
+
return await surfaceToBlob(n, t, e.quality);
|
|
148
|
+
} finally {
|
|
149
|
+
for (let e of h) e.width = 0, e.height = 0;
|
|
150
|
+
}
|
|
99
151
|
}, renderFrame = (e) => {
|
|
100
|
-
if (
|
|
152
|
+
if (S = !1, x = null, g) return {
|
|
101
153
|
repainted: [],
|
|
102
154
|
time: e
|
|
103
155
|
};
|
|
104
156
|
let t = visibleRect(), n = {
|
|
105
|
-
dpr:
|
|
106
|
-
matrix:
|
|
157
|
+
dpr: y,
|
|
158
|
+
matrix: b,
|
|
107
159
|
time: e,
|
|
108
160
|
visibleRect: t
|
|
109
161
|
}, r = [];
|
|
110
|
-
for (let e of
|
|
162
|
+
for (let e of C) if (e.dirty) {
|
|
111
163
|
let t = ensureSurface(e);
|
|
112
164
|
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, n), e.dirty = !1, r.push(e.id);
|
|
113
165
|
}
|
|
114
|
-
let
|
|
115
|
-
if (
|
|
116
|
-
let e = Math.max(1, Math.round(
|
|
117
|
-
|
|
118
|
-
for (let n of
|
|
166
|
+
let i = c.getContext("2d");
|
|
167
|
+
if (i) {
|
|
168
|
+
let e = Math.max(1, Math.round(_ * y)), t = Math.max(1, Math.round(v * y)), n = Math.max(1, Math.round(c.width)), r = Math.max(1, Math.round(c.height));
|
|
169
|
+
i.setTransform(1, 0, 0, 1, 0, 0), i.clearRect(0, 0, n, r), m != null && (i.fillStyle = m, i.fillRect(0, 0, n, r));
|
|
170
|
+
for (let n of C) n.surface && i.drawImage(n.surface, 0, 0, e, t);
|
|
119
171
|
}
|
|
120
172
|
return {
|
|
121
173
|
repainted: r,
|
|
122
174
|
time: e
|
|
123
175
|
};
|
|
124
176
|
}, schedule = () => {
|
|
125
|
-
|
|
126
|
-
|
|
177
|
+
g || S || (S = !0, x = f.requestFrame((e) => {
|
|
178
|
+
S && renderFrame(e);
|
|
127
179
|
}));
|
|
128
180
|
}, invalidateAll = () => {
|
|
129
|
-
for (let e of
|
|
181
|
+
for (let e of C) e.dirty = !0;
|
|
130
182
|
}, cancelFrame = () => {
|
|
131
|
-
|
|
183
|
+
x != null && (f.cancelFrame(x), x = null), S = !1;
|
|
132
184
|
}, dispose = () => {
|
|
133
|
-
if (!
|
|
134
|
-
|
|
135
|
-
for (let e of
|
|
136
|
-
|
|
185
|
+
if (!g) {
|
|
186
|
+
g = !0, cancelFrame();
|
|
187
|
+
for (let e of C) disposeSurface(e);
|
|
188
|
+
C.length = 0, h.abort();
|
|
137
189
|
}
|
|
138
190
|
};
|
|
139
|
-
|
|
140
|
-
let
|
|
191
|
+
c.width = Math.max(1, Math.round(_ * y)), c.height = Math.max(1, Math.round(v * y));
|
|
192
|
+
let w = {
|
|
141
193
|
get canvas() {
|
|
142
|
-
return
|
|
194
|
+
return c;
|
|
143
195
|
},
|
|
144
196
|
get disposalSignal() {
|
|
145
|
-
return
|
|
197
|
+
return h.signal;
|
|
146
198
|
},
|
|
147
199
|
get disposed() {
|
|
148
|
-
return
|
|
200
|
+
return g;
|
|
149
201
|
},
|
|
150
202
|
[Symbol.dispose]: dispose,
|
|
151
203
|
dispose,
|
|
152
204
|
get dpr() {
|
|
153
|
-
return
|
|
205
|
+
return y;
|
|
154
206
|
},
|
|
155
207
|
get height() {
|
|
156
|
-
return
|
|
208
|
+
return v;
|
|
157
209
|
},
|
|
158
210
|
invalidate(e) {
|
|
159
|
-
if (!
|
|
211
|
+
if (!g) {
|
|
160
212
|
if (e == null) invalidateAll();
|
|
161
213
|
else {
|
|
162
|
-
let t =
|
|
214
|
+
let t = C.find((t) => t.id === e);
|
|
163
215
|
if (!t) throw new StageConfigError(`Unknown stage layer "${e}".`);
|
|
164
216
|
t.dirty = !0;
|
|
165
217
|
}
|
|
@@ -167,51 +219,37 @@ function createStage(i, a) {
|
|
|
167
219
|
}
|
|
168
220
|
},
|
|
169
221
|
get matrix() {
|
|
170
|
-
return
|
|
222
|
+
return b;
|
|
171
223
|
},
|
|
172
224
|
render(e) {
|
|
173
|
-
return
|
|
225
|
+
return g ? {
|
|
174
226
|
repainted: [],
|
|
175
|
-
time: e ??
|
|
176
|
-
} : (cancelFrame(), renderFrame(e ??
|
|
227
|
+
time: e ?? f.now()
|
|
228
|
+
} : (cancelFrame(), renderFrame(e ?? f.now()));
|
|
177
229
|
},
|
|
178
230
|
resize(e, t) {
|
|
179
|
-
if (
|
|
231
|
+
if (g) return;
|
|
180
232
|
requireSize(e, "Stage");
|
|
181
|
-
let n = t ??
|
|
182
|
-
requireDpr(n, "Stage"),
|
|
233
|
+
let n = t ?? y;
|
|
234
|
+
requireDpr(n, "Stage"), _ = e.width, v = e.height, y = n, c.width = Math.max(1, Math.round(_ * y)), c.height = Math.max(1, Math.round(v * y)), invalidateAll(), schedule();
|
|
183
235
|
},
|
|
184
236
|
setTransform(e) {
|
|
185
|
-
|
|
237
|
+
g || (requireFiniteMatrix(e), b = e, invalidateAll(), schedule());
|
|
186
238
|
},
|
|
187
239
|
async toBlob(e) {
|
|
188
|
-
if (
|
|
189
|
-
|
|
240
|
+
if (g) throw new StageDisposedError("Cannot export a disposed stage.");
|
|
241
|
+
S && w.render();
|
|
190
242
|
let t = e?.type ?? "image/png";
|
|
191
|
-
|
|
192
|
-
let n = await i.convertToBlob({
|
|
193
|
-
quality: e?.quality,
|
|
194
|
-
type: t
|
|
195
|
-
});
|
|
196
|
-
if (!n) throw new StageUnsupportedError("Canvas blob export returned no data.");
|
|
197
|
-
return n;
|
|
198
|
-
}
|
|
199
|
-
let n = i;
|
|
200
|
-
if (typeof n.toBlob != "function") throw new StageUnsupportedError("This canvas does not support blob export.");
|
|
201
|
-
let r = await new Promise((r) => {
|
|
202
|
-
n.toBlob(r, t, e?.quality);
|
|
203
|
-
});
|
|
204
|
-
if (!r) throw new StageUnsupportedError("Canvas blob export returned no data.");
|
|
205
|
-
return r;
|
|
243
|
+
return e?.region != null || e?.scale != null ? await exportRegion(e, t) : await surfaceToBlob(c, t, e?.quality);
|
|
206
244
|
},
|
|
207
245
|
get visibleRect() {
|
|
208
246
|
return visibleRect();
|
|
209
247
|
},
|
|
210
248
|
get width() {
|
|
211
|
-
return
|
|
249
|
+
return _;
|
|
212
250
|
}
|
|
213
251
|
};
|
|
214
|
-
return
|
|
252
|
+
return w;
|
|
215
253
|
}
|
|
216
254
|
export { StageConfigError, StageDisposedError, StageError, StageUnsupportedError, createStage };
|
|
217
255
|
|
package/dist/stage.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stage.js","names":["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","invert","corners","apply","rectFromPoints","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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"}
|
|
1
|
+
{"version":3,"file":"stage.js","names":["scaleMatrix","message","opts","size","context","dpr","rect","scale","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","invert","corners","apply","rectFromPoints","a","b","c","d","e","f","surface","blob","htmlCanvas","resolve","type","quality","region","exportScale","scaleOf","exportMatrix","multiply","translate","frame","scratch","output","outCtx","repainted","screen","canvas","cw","ch","time","stage","layerId","l","resolvedDpr","nextDpr","next","blobOptions"],"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, Rect, 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 requireRect(rect: Rect, context: string): void {\n if (\n !Number.isFinite(rect.x) ||\n !Number.isFinite(rect.y) ||\n !Number.isFinite(rect.width) ||\n rect.width <= 0 ||\n !Number.isFinite(rect.height) ||\n rect.height <= 0\n ) {\n throw new StageConfigError(\n `${context} region must have finite coordinates and positive finite size, got ${rect.width}x${rect.height} at ${rect.x},${rect.y}.`,\n );\n }\n}\n\n/** @internal */\nexport function requireScale(scale: number, context: string): void {\n if (!Number.isFinite(scale) || scale <= 0) {\n throw new StageConfigError(`${context} scale must be a positive finite number, got ${scale}.`);\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 multiply,\n type Point,\n type Rect,\n rectFromPoints,\n type Size,\n scale as scaleMatrix,\n scaleOf,\n translate,\n} from '@vielzeug/atlas';\nimport { requireDpr, requireFiniteMatrix, requireRect, requireScale, 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\n/** Options for `toBlob()`: blob encoding plus an optional world-space crop and pixel density. */\nexport type StageBlobOptions = Readonly<{\n /** Blob MIME type; defaults to `image/png`. */\n type?: string;\n /** Encoder quality for lossy types. */\n quality?: number;\n /**\n * World-space rect to export; defaults to the current visible rect. The\n * export re-paints every layer against the region transform, so cost is a\n * full repaint, not a blit of the cached composite.\n */\n region?: Rect;\n /**\n * Export pixels per world unit. Defaults to the current device pixels per\n * world unit (`dpr × matrix scale`), which matches the on-screen density.\n */\n scale?: number;\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 /**\n * Export the current frame as a blob. With `region`/`scale`, layers are\n * re-painted into scratch surfaces at the requested crop and density;\n * the live viewport is untouched.\n */\n toBlob: (options?: StageBlobOptions) => 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 /** Rasterize a surface (live canvas or scratch) into a blob; shared by both export paths. */\n const surfaceToBlob = async (surface: StageSurface, type: string, quality?: number): Promise<Blob> => {\n if (typeof OffscreenCanvas !== 'undefined' && surface instanceof OffscreenCanvas) {\n // OffscreenCanvas (worker-rendered stages): promise-based export.\n const blob = await surface.convertToBlob({ quality, type });\n if (!blob) throw new StageUnsupportedError('Canvas blob export returned no data.');\n return blob;\n }\n const htmlCanvas = surface as unknown 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, quality);\n });\n if (!blob) {\n throw new StageUnsupportedError('Canvas blob export returned no data.');\n }\n return blob;\n };\n\n /**\n * Region/scale export: layer caches are keyed to the live viewport\n * transform, so the requested crop cannot blit the cached composite. Every\n * layer is re-painted into scratch surfaces against the export transform\n * `translate(-region) × scale` (dpr 1; `scale` maps world units to export\n * pixels) and composited into a scratch output surface. The live frame,\n * caches, and dirty flags are untouched; the cost is a full repaint.\n */\n const exportRegion = async (options: StageBlobOptions, type: string): Promise<Blob> => {\n const region = options.region ?? visibleRect();\n requireRect(region, 'Export');\n // Default density matches the on-screen one: device pixels per world unit.\n const exportScale = options.scale ?? dpr * scaleOf(matrix);\n requireScale(exportScale, 'Export');\n const pw = Math.max(1, Math.round(region.width * exportScale));\n const ph = Math.max(1, Math.round(region.height * exportScale));\n const exportMatrix = multiply(scaleMatrix(exportScale), translate(-region.x, -region.y));\n const frame: PaintContext = { dpr: 1, matrix: exportMatrix, time: scheduler.now(), visibleRect: region };\n const scratch: StageSurface[] = [];\n try {\n const output = createSurface(pw, ph);\n scratch.push(output);\n const outCtx = output.getContext('2d', { alpha: true }) as CanvasRenderingContext2D | null;\n if (outCtx == null) {\n throw new StageUnsupportedError('Export surface has no 2D context.');\n }\n outCtx.setTransform(1, 0, 0, 1, 0, 0);\n outCtx.clearRect(0, 0, pw, ph);\n if (background != null) {\n outCtx.fillStyle = background;\n outCtx.fillRect(0, 0, pw, ph);\n }\n for (const layer of layers) {\n const surface = createSurface(pw, ph);\n scratch.push(surface);\n const ctx = surface.getContext('2d', { alpha: true }) as CanvasRenderingContext2D | null;\n if (ctx == null) {\n throw new StageUnsupportedError(`Layer surface for \"${layer.id}\" has no 2D context.`);\n }\n ctx.setTransform(1, 0, 0, 1, 0, 0);\n ctx.clearRect(0, 0, pw, ph);\n const [a, b, c, d, e, f] = exportMatrix;\n ctx.setTransform(a, b, c, d, e, f);\n layer.paint(ctx, frame);\n outCtx.drawImage(surface as unknown as CanvasImageSource, 0, 0, pw, ph);\n }\n return await surfaceToBlob(output, type, options.quality);\n } finally {\n for (const surface of scratch) {\n surface.width = 0;\n surface.height = 0;\n }\n }\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 (blobOptions?.region != null || blobOptions?.scale != null) {\n return await exportRegion(blobOptions, type);\n }\n return await surfaceToBlob(canvas, type, blobOptions?.quality);\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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"}
|
package/dist/worker/main.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
require("../_dev.cjs");const e=require("../_validate.cjs"),t=require("../errors.cjs");function reportWorkerError(e){let n=new t.StageError(`Worker stage error: ${e}`),r=globalThis.reportError;typeof r==`function`?r(n):queueMicrotask(()=>{throw n})}function createWorkerStage(n,r,i){let{width:a,height:o}=i;e.requireSize({height:o,width:a},`Worker stage`);let s=i.dpr??1;if(e.requireDpr(s,`Worker stage`),typeof n.transferControlToOffscreen!=`function`)throw new t.StageUnsupportedError(`This canvas cannot be transferred to a worker (transferControlToOffscreen).`);let c=new AbortController,l=new Map,u=1,d=!1,f=n.transferControlToOffscreen(),command=e=>{d||r.postMessage(e)},resolveReady=()=>{},rejectReady=()=>{},p=new Promise((e,t)=>{resolveReady=e,rejectReady=t});p.catch(()=>{});let onMessage=e=>{let n=e.data;if(n&&typeof n==`object`&&typeof n.type==`string`){if(n.type===`ready`){if(n.protocol!==
|
|
1
|
+
require("../_dev.cjs");const e=require("../_validate.cjs"),t=require("../errors.cjs");function reportWorkerError(e){let n=new t.StageError(`Worker stage error: ${e}`),r=globalThis.reportError;typeof r==`function`?r(n):queueMicrotask(()=>{throw n})}function createWorkerStage(n,r,i){let{width:a,height:o}=i;e.requireSize({height:o,width:a},`Worker stage`);let s=i.dpr??1;if(e.requireDpr(s,`Worker stage`),typeof n.transferControlToOffscreen!=`function`)throw new t.StageUnsupportedError(`This canvas cannot be transferred to a worker (transferControlToOffscreen).`);let c=new AbortController,l=new Map,u=1,d=!1,f=n.transferControlToOffscreen(),command=e=>{d||r.postMessage(e)},resolveReady=()=>{},rejectReady=()=>{},p=new Promise((e,t)=>{resolveReady=e,rejectReady=t});p.catch(()=>{});let onMessage=e=>{let n=e.data;if(n&&typeof n==`object`&&typeof n.type==`string`){if(n.type===`ready`){if(n.protocol!==2){let e=new t.StageError(`Worker stage protocol ${String(n.protocol)} does not match 2.`);rejectReady(e),dispose();return}resolveReady()}else if(n.type===`blob`){let e=l.get(n.id);if(!e){`${String(n.id)}`;return}l.delete(n.id),n.ok?e.resolve(n.blob):n.kind===`disposed`?e.reject(new t.StageDisposedError(`Worker blob export failed: ${n.error}`)):n.kind===`unsupported`?e.reject(new t.StageUnsupportedError(`Worker blob export failed: ${n.error}`)):e.reject(new t.StageError(`Worker blob export failed: ${n.error}`))}else n.type===`error`?reportWorkerError(n.error):`${String(n.type)}`}};r.addEventListener(`message`,onMessage),r.postMessage({background:i.background??null,canvas:f,dpr:s,height:o,protocol:2,type:`init`,width:a},[f]);let dispose=()=>{if(!d){d=!0,r.postMessage({type:`dispose`}),r.removeEventListener(`message`,onMessage);for(let e of l.values())e.reject(new t.StageDisposedError(`Stage disposed before blob export.`));l.clear(),rejectReady(new t.StageDisposedError(`Stage disposed before the worker became ready.`)),c.abort()}};return{disposalSignal:c.signal,dispose,get disposed(){return d},invalidate(e){command({layerId:e,type:`invalidate`})},ready:p,resize(t,n){e.requireSize(t,`Worker stage`);let r=n??s;e.requireDpr(r,`Worker stage`),command({dpr:r,type:`resize`,...t})},[Symbol.dispose]:dispose,sendScene(e){command({scene:e,type:`scene`})},setTransform(t){e.requireFiniteMatrix(t),command({matrix:t,type:`matrix`})},async toBlob(e){if(d)throw new t.StageDisposedError(`Cannot export a disposed stage.`);let n=u++;return await new Promise((t,r)=>{l.set(n,{reject:r,resolve:t}),command({id:n,options:e,type:`blob`})})}}}exports.createWorkerStage=createWorkerStage;
|
|
2
2
|
//# sourceMappingURL=main.cjs.map
|
package/dist/worker/main.js
CHANGED
|
@@ -26,8 +26,8 @@ function createWorkerStage(o, s, c) {
|
|
|
26
26
|
let t = e.data;
|
|
27
27
|
if (t && typeof t == "object" && typeof t.type == "string") {
|
|
28
28
|
if (t.type === "ready") {
|
|
29
|
-
if (t.protocol !==
|
|
30
|
-
let e = new i(`Worker stage protocol ${String(t.protocol)} does not match
|
|
29
|
+
if (t.protocol !== 2) {
|
|
30
|
+
let e = new i(`Worker stage protocol ${String(t.protocol)} does not match 2.`);
|
|
31
31
|
rejectReady(e), dispose();
|
|
32
32
|
return;
|
|
33
33
|
}
|
|
@@ -47,7 +47,7 @@ function createWorkerStage(o, s, c) {
|
|
|
47
47
|
canvas: g,
|
|
48
48
|
dpr: d,
|
|
49
49
|
height: u,
|
|
50
|
-
protocol:
|
|
50
|
+
protocol: 2,
|
|
51
51
|
type: "init",
|
|
52
52
|
width: l
|
|
53
53
|
}, [g]);
|
|
@@ -4,8 +4,9 @@
|
|
|
4
4
|
* carries the protocol version to catch a stale cached worker.
|
|
5
5
|
*/
|
|
6
6
|
import type { Matrix } from '@vielzeug/atlas';
|
|
7
|
+
import type { StageBlobOptions } from '../stage.js';
|
|
7
8
|
/** Version of the stage worker protocol. Bumped whenever the message shapes change. */
|
|
8
|
-
export declare const STAGE_WORKER_PROTOCOL =
|
|
9
|
+
export declare const STAGE_WORKER_PROTOCOL = 2;
|
|
9
10
|
/** Init message posted to the worker with the transferred canvas. */
|
|
10
11
|
export interface StageWorkerInit {
|
|
11
12
|
background: string | null;
|
|
@@ -31,10 +32,7 @@ export type StageWorkerCommand = {
|
|
|
31
32
|
} | {
|
|
32
33
|
type: 'blob';
|
|
33
34
|
id: number;
|
|
34
|
-
options?:
|
|
35
|
-
type?: string;
|
|
36
|
-
quality?: number;
|
|
37
|
-
};
|
|
35
|
+
options?: StageBlobOptions;
|
|
38
36
|
}
|
|
39
37
|
/** Application payload forwarded verbatim to the worker-side `onScene` handler. */
|
|
40
38
|
| {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/worker/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE
|
|
1
|
+
{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/worker/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE;AAC1D,mFAAmF;GACjF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,4FAA4F;AAC5F,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC"}
|
package/dist/worker/serve.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
require("../_dev.cjs");const e=require("../errors.cjs"),t=require("../stage.cjs");function serveStage(n,r){let i,a,o=!1,fail=e=>{n.postMessage({error:String(e),type:`error`})},handle=s=>{if(!o)switch(s.type){case`init`:if(i)return;if(s.protocol!==
|
|
1
|
+
require("../_dev.cjs");const e=require("../errors.cjs"),t=require("../stage.cjs");function serveStage(n,r){let i,a,o=!1,fail=e=>{n.postMessage({error:String(e),type:`error`})},handle=s=>{if(!o)switch(s.type){case`init`:if(i)return;if(s.protocol!==2){fail(new e.StageUnsupportedError(`Main thread protocol ${String(s.protocol)} does not match 2.`));return}a=r(s),i=t.createStage(s.canvas,{background:s.background,dpr:s.dpr,height:s.height,layers:a.layers,width:s.width}),n.postMessage({protocol:2,type:`ready`});return;case`resize`:i?.resize({height:s.height,width:s.width},s.dpr);return;case`matrix`:i?.setTransform(s.matrix);return;case`invalidate`:i?.invalidate(s.layerId);return;case`scene`:i&&a?.onScene?.(s.scene,i);return;case`blob`:if(!i){n.postMessage({error:`Stage is not initialized.`,id:s.id,kind:`failed`,ok:!1,type:`blob`});return}i.render(),i.toBlob(s.options).then(e=>{n.postMessage({blob:e,id:s.id,ok:!0,type:`blob`})}).catch(t=>{let r=t instanceof e.StageDisposedError?`disposed`:t instanceof e.StageUnsupportedError?`unsupported`:`failed`;n.postMessage({error:String(t),id:s.id,kind:r,ok:!1,type:`blob`})});return;case`dispose`:shutdown();return;default:`${String(s.type)}`}},onMessage=e=>{let t=e.data;if(t&&typeof t==`object`&&typeof t.type==`string`)try{handle(t)}catch(e){fail(e)}},shutdown=()=>{o||(o=!0,n.removeEventListener?.(`message`,onMessage),i?.dispose(),i=void 0,a?.onDispose?.(),a=void 0)};return n.addEventListener(`message`,onMessage),{dispose:shutdown,get stage(){return i},[Symbol.dispose]:shutdown}}exports.serveStage=serveStage;
|
|
2
2
|
//# sourceMappingURL=serve.cjs.map
|
package/dist/worker/serve.js
CHANGED
|
@@ -12,8 +12,8 @@ function serveStage(r, i) {
|
|
|
12
12
|
if (!s) switch (c.type) {
|
|
13
13
|
case "init":
|
|
14
14
|
if (a) return;
|
|
15
|
-
if (c.protocol !==
|
|
16
|
-
fail(new t(`Main thread protocol ${String(c.protocol)} does not match
|
|
15
|
+
if (c.protocol !== 2) {
|
|
16
|
+
fail(new t(`Main thread protocol ${String(c.protocol)} does not match 2.`));
|
|
17
17
|
return;
|
|
18
18
|
}
|
|
19
19
|
o = i(c), a = n(c.canvas, {
|
|
@@ -23,7 +23,7 @@ function serveStage(r, i) {
|
|
|
23
23
|
layers: o.layers,
|
|
24
24
|
width: c.width
|
|
25
25
|
}), r.postMessage({
|
|
26
|
-
protocol:
|
|
26
|
+
protocol: 2,
|
|
27
27
|
type: "ready"
|
|
28
28
|
});
|
|
29
29
|
return;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vielzeug/stage",
|
|
3
|
-
"version": "26.11.
|
|
3
|
+
"version": "26.11.25",
|
|
4
4
|
"description": "Retained-mode 2D canvas stage engine with DPR-aware layers, dirty repaints, and PNG export",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
"verify:exports": "bun verify-exports.mjs"
|
|
55
55
|
},
|
|
56
56
|
"dependencies": {
|
|
57
|
-
"@vielzeug/atlas": "26.11.
|
|
57
|
+
"@vielzeug/atlas": "26.11.25"
|
|
58
58
|
},
|
|
59
59
|
"devDependencies": {
|
|
60
60
|
"@types/node": "^26.6.6",
|