pngine 1.0.6 → 1.0.9
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 +133 -0
- package/bin/pngine +89 -0
- package/dist/core.d.ts +31 -0
- package/dist/core.mjs +3 -0
- package/dist/dev.d.ts +102 -0
- package/dist/dev.mjs +1 -0
- package/dist/executor.d.ts +54 -0
- package/dist/executor.mjs +1 -0
- package/dist/index.d.ts +47 -0
- package/dist/index.js +45 -0
- package/dist/index.mjs +33 -0
- package/dist/viewer.d.ts +45 -60
- package/dist/viewer.mjs +1 -0
- package/package.json +78 -64
- package/wasm/pngine.wasm +0 -0
- package/LICENSE +0 -121
- package/dist/cli.js +0 -6797
- package/dist/viewer.js +0 -314
package/README.md
ADDED
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# PNGine NPM Package
|
|
2
|
+
|
|
3
|
+
WebGPU bytecode engine for PNG payloads.
|
|
4
|
+
|
|
5
|
+
## Runtime Profiles
|
|
6
|
+
|
|
7
|
+
PNGine now ships four browser-facing profiles:
|
|
8
|
+
|
|
9
|
+
| Profile | Import | Purpose |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| Viewer (default) | `pngine` or `pngine/viewer` | Lean production player for PNG payloads with embedded executor |
|
|
12
|
+
| Dev | `pngine/dev` | Full feature surface for iteration and debugging |
|
|
13
|
+
| Core | `pngine/core` | Low-level runtime API (dispatcher-centric) |
|
|
14
|
+
| Executor | `pngine/executor` | Advanced payload/executor helper API |
|
|
15
|
+
|
|
16
|
+
## Viewer API (Default)
|
|
17
|
+
|
|
18
|
+
### Usage scenario
|
|
19
|
+
|
|
20
|
+
Use viewer for normal playback of PNG payloads generated with the default embedded executor.
|
|
21
|
+
|
|
22
|
+
### Input contract
|
|
23
|
+
|
|
24
|
+
```ts
|
|
25
|
+
pngine(
|
|
26
|
+
source: string | Uint8Array | ArrayBuffer | Blob,
|
|
27
|
+
options: {
|
|
28
|
+
canvas: HTMLCanvasElement;
|
|
29
|
+
debug?: boolean;
|
|
30
|
+
onError?: (err: Error) => void;
|
|
31
|
+
}
|
|
32
|
+
)
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Notes:
|
|
36
|
+
- `canvas` is required.
|
|
37
|
+
- `source` can be URL or byte data.
|
|
38
|
+
- `wasmUrl`, selector strings, and `HTMLImageElement` sources are dev-only features.
|
|
39
|
+
- Viewer keeps wasm-in-wasm runtime support enabled by default.
|
|
40
|
+
- Viewer supports runtime interactivity via `draw(...uniforms)`, `setUniform`, `setUniforms`, and `getUniforms`.
|
|
41
|
+
|
|
42
|
+
### Example
|
|
43
|
+
|
|
44
|
+
```js
|
|
45
|
+
import { pngine, play } from 'pngine';
|
|
46
|
+
|
|
47
|
+
const canvas = document.getElementById('canvas');
|
|
48
|
+
const p = await pngine('/assets/triangle.png', { canvas });
|
|
49
|
+
play(p);
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Dev API
|
|
53
|
+
|
|
54
|
+
Dev profile keeps the full feature set:
|
|
55
|
+
- Selector and image-element initialization paths.
|
|
56
|
+
- Shared executor fallback (`wasmUrl`) for payloads without embedded executor.
|
|
57
|
+
- Executor helper exports on the same entrypoint.
|
|
58
|
+
|
|
59
|
+
```js
|
|
60
|
+
import { pngine, parsePayload } from 'pngine/dev';
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Core API
|
|
64
|
+
|
|
65
|
+
Core profile is for integrators who already manage device/context/lifecycle.
|
|
66
|
+
|
|
67
|
+
```js
|
|
68
|
+
import { createCoreDispatcher, configureCanvas, getDevice } from 'pngine/core';
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Executor API
|
|
72
|
+
|
|
73
|
+
Advanced helpers for payload parsing and manual executor loading.
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
import { parsePayload, createExecutor, getExecutorImports } from 'pngine/executor';
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## Bundle Sizes (Current)
|
|
80
|
+
|
|
81
|
+
Generated by `npm run build` on `2026-02-08`:
|
|
82
|
+
|
|
83
|
+
| File | Raw | Gzip |
|
|
84
|
+
| --- | --- | --- |
|
|
85
|
+
| `viewer.mjs` | 27.1 KB | 9.4 KB |
|
|
86
|
+
| `dev.mjs` | 29.5 KB | 10.2 KB |
|
|
87
|
+
| `core.mjs` | 15.9 KB | 5.4 KB |
|
|
88
|
+
| `executor.mjs` | 1.8 KB | 0.9 KB |
|
|
89
|
+
| `index.js` (Node stub) | 1.1 KB | - |
|
|
90
|
+
|
|
91
|
+
## Build Commands
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
# Production bundles
|
|
95
|
+
npm run build
|
|
96
|
+
|
|
97
|
+
# Debug bundles (source maps, DEBUG=true)
|
|
98
|
+
npm run build:debug
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## Dist Files
|
|
102
|
+
|
|
103
|
+
```text
|
|
104
|
+
dist/
|
|
105
|
+
├── viewer.mjs
|
|
106
|
+
├── dev.mjs
|
|
107
|
+
├── core.mjs
|
|
108
|
+
├── executor.mjs
|
|
109
|
+
├── index.js # Node CJS stubs
|
|
110
|
+
├── index.mjs # Node ESM stubs
|
|
111
|
+
├── index.d.ts # default (viewer) types
|
|
112
|
+
├── viewer.d.ts
|
|
113
|
+
├── dev.d.ts
|
|
114
|
+
├── core.d.ts
|
|
115
|
+
└── executor.d.ts
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## CLI and Native Binaries
|
|
119
|
+
|
|
120
|
+
The package also ships the `pngine` CLI via optional native binaries:
|
|
121
|
+
|
|
122
|
+
| Package | Platform |
|
|
123
|
+
| --- | --- |
|
|
124
|
+
| `@pngine/darwin-arm64` | macOS Apple Silicon |
|
|
125
|
+
| `@pngine/darwin-x64` | macOS Intel |
|
|
126
|
+
| `@pngine/linux-x64` | Linux x64 |
|
|
127
|
+
| `@pngine/linux-arm64` | Linux ARM64 |
|
|
128
|
+
| `@pngine/win32-x64` | Windows x64 |
|
|
129
|
+
| `@pngine/win32-arm64` | Windows ARM64 |
|
|
130
|
+
|
|
131
|
+
## License
|
|
132
|
+
|
|
133
|
+
MIT
|
package/bin/pngine
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* PNGine CLI Wrapper
|
|
5
|
+
*
|
|
6
|
+
* Finds and executes the platform-specific native binary.
|
|
7
|
+
* Native binaries are distributed in separate optional packages.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
const { spawn } = require('child_process');
|
|
11
|
+
const path = require('path');
|
|
12
|
+
|
|
13
|
+
// Platform to package mapping
|
|
14
|
+
const PLATFORMS = {
|
|
15
|
+
'darwin-arm64': '@pngine/darwin-arm64',
|
|
16
|
+
'darwin-x64': '@pngine/darwin-x64',
|
|
17
|
+
'linux-x64': '@pngine/linux-x64',
|
|
18
|
+
'linux-arm64': '@pngine/linux-arm64',
|
|
19
|
+
'win32-x64': '@pngine/win32-x64',
|
|
20
|
+
'win32-arm64': '@pngine/win32-arm64',
|
|
21
|
+
};
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Get the path to the native binary for the current platform.
|
|
25
|
+
* @returns {string} Path to the binary
|
|
26
|
+
*/
|
|
27
|
+
function getBinaryPath() {
|
|
28
|
+
const platform = `${process.platform}-${process.arch}`;
|
|
29
|
+
const pkg = PLATFORMS[platform];
|
|
30
|
+
|
|
31
|
+
if (!pkg) {
|
|
32
|
+
console.error(`Error: Unsupported platform: ${platform}`);
|
|
33
|
+
console.error('');
|
|
34
|
+
console.error('Supported platforms:');
|
|
35
|
+
console.error(' - macOS ARM64 (Apple Silicon)');
|
|
36
|
+
console.error(' - macOS x64 (Intel)');
|
|
37
|
+
console.error(' - Linux x64');
|
|
38
|
+
console.error(' - Linux ARM64');
|
|
39
|
+
console.error(' - Windows x64');
|
|
40
|
+
console.error(' - Windows ARM64');
|
|
41
|
+
process.exit(1);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
try {
|
|
45
|
+
// Find the platform package
|
|
46
|
+
const pkgPath = require.resolve(`${pkg}/package.json`);
|
|
47
|
+
const binName = process.platform === 'win32' ? 'pngine.exe' : 'pngine';
|
|
48
|
+
return path.join(path.dirname(pkgPath), 'bin', binName);
|
|
49
|
+
} catch (err) {
|
|
50
|
+
console.error(`Error: Platform package ${pkg} is not installed.`);
|
|
51
|
+
console.error('');
|
|
52
|
+
console.error('This usually means npm failed to install the optional dependency.');
|
|
53
|
+
console.error('Try reinstalling:');
|
|
54
|
+
console.error('');
|
|
55
|
+
console.error(' npm install pngine');
|
|
56
|
+
console.error('');
|
|
57
|
+
console.error('Or install the platform package directly:');
|
|
58
|
+
console.error('');
|
|
59
|
+
console.error(` npm install ${pkg}`);
|
|
60
|
+
process.exit(1);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// Get the binary path
|
|
65
|
+
const binaryPath = getBinaryPath();
|
|
66
|
+
|
|
67
|
+
// Spawn the native binary with all arguments
|
|
68
|
+
const child = spawn(binaryPath, process.argv.slice(2), {
|
|
69
|
+
stdio: 'inherit',
|
|
70
|
+
windowsHide: true,
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
// Forward signals
|
|
74
|
+
process.on('SIGINT', () => child.kill('SIGINT'));
|
|
75
|
+
process.on('SIGTERM', () => child.kill('SIGTERM'));
|
|
76
|
+
|
|
77
|
+
// Exit with the same code as the child process
|
|
78
|
+
child.on('exit', (code, signal) => {
|
|
79
|
+
if (signal) {
|
|
80
|
+
process.kill(process.pid, signal);
|
|
81
|
+
} else {
|
|
82
|
+
process.exit(code ?? 0);
|
|
83
|
+
}
|
|
84
|
+
});
|
|
85
|
+
|
|
86
|
+
child.on('error', (err) => {
|
|
87
|
+
console.error(`Error executing pngine: ${err.message}`);
|
|
88
|
+
process.exit(1);
|
|
89
|
+
});
|
package/dist/core.d.ts
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
|
|
2
|
+
export interface UniformInfo {
|
|
3
|
+
bufferId: number;
|
|
4
|
+
offset: number;
|
|
5
|
+
size: number;
|
|
6
|
+
type: number;
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
export interface UniformTableResult {
|
|
10
|
+
uniforms: Map<string, UniformInfo>;
|
|
11
|
+
strings: string[];
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface CoreDispatcher {
|
|
15
|
+
setMemory(memory: WebAssembly.Memory): void;
|
|
16
|
+
execute(ptr: number): Promise<void> | void;
|
|
17
|
+
setUniform(name: string, value: number | number[]): boolean;
|
|
18
|
+
setUniforms(uniforms: Record<string, number | number[]>): number;
|
|
19
|
+
setUniformTable(table: Map<string, UniformInfo>): void;
|
|
20
|
+
destroy(): void;
|
|
21
|
+
setDebug(v: boolean): void;
|
|
22
|
+
setTime(t: number): void;
|
|
23
|
+
setCanvasSize(w: number, h: number): void;
|
|
24
|
+
_dispatcher: unknown;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export function createCommandDispatcher(device: GPUDevice, ctx: GPUCanvasContext): unknown;
|
|
28
|
+
export function parseUniformTable(bytecode: Uint8Array): UniformTableResult;
|
|
29
|
+
export function createCoreDispatcher(device: GPUDevice, ctx: GPUCanvasContext): CoreDispatcher;
|
|
30
|
+
export function getDevice(adapter?: GPUAdapter): Promise<GPUDevice>;
|
|
31
|
+
export function configureCanvas(canvas: HTMLCanvasElement, device: GPUDevice): GPUCanvasContext;
|
package/dist/core.mjs
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
function X(c,r,e,t){switch(c){case 1:return t.createBuffer(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint8(e+6)),e+7;case 2:return t.createTexture(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 3:return t.createSampler(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 4:return t.createShader(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 5:return t.createRenderPipeline(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 6:return t.createComputePipeline(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 7:return t.createBindGroup(r.getUint16(e,!0),r.getUint16(e+2,!0),r.getUint32(e+4,!0),r.getUint32(e+8,!0)),e+12;case 8:{let d=r.getUint16(e,!0),u=r.getUint16(e+2,!0);return!t.txv[d]&&t.tex[u]&&(t.txv[d]=t.tex[u].createView()),e+12}case 9:return e+10;case 10:{let d=r.getUint16(e,!0),u=r.getUint32(e+2,!0),l=r.getUint32(e+6,!0);return t.bgl[d]||(t.bgl[d]=t.device.createBindGroupLayout(JSON.parse(t.rs(u,l)))),e+10}case 11:{let d=r.getUint16(e,!0),u=r.getUint32(e+2,!0),l=r.getUint32(e+6,!0);if(l===0)return e+10;let y=new Blob([new Uint8Array(t.mem.buffer,u,l)]);return createImageBitmap(y).then(B=>(t.bmp[d]=B,e+10))}case 12:{let d=r.getUint16(e,!0),u=r.getUint32(e+2,!0),l=r.getUint32(e+6,!0),y=JSON.parse(t.rs(u,l));return t.ppl[d]=t.device.createPipelineLayout({bindGroupLayouts:y.bindGroupLayouts.map(B=>t.bgl[B])}),e+10}case 13:return e+10;case 16:return t.beginRenderPass(r.getUint16(e,!0),r.getUint8(e+2),r.getUint8(e+3),r.getUint16(e+4,!0)),e+6;case 17:return t.beginComputePass(),e;case 18:{let d=r.getUint16(e,!0);return t.log(`[GPU] setPipeline(${d})`),t.getPass()?.setPipeline(t.pip[d]),e+2}case 19:{let d=r.getUint8(e),u=r.getUint16(e+1,!0);return t.log(`[GPU] setBindGroup(${d}, ${u}) pass=${t.getPass()?"valid":"NULL"} bg[${u}]=${t.bg[u]?"exists":"MISSING"}`),t.getPass()?.setBindGroup(d,t.bg[u]),e+3}case 20:return t.getPass()?.setVertexBuffer(r.getUint8(e),t.buf[r.getUint16(e+1,!0)]),e+3;case 21:{let d=r.getUint32(e,!0),u=r.getUint32(e+4,!0);return t.log(`[GPU] draw(${d}, ${u}) pass=${t.getPass()?"valid":"NULL"}`),t.getPass()?.draw(d,u,r.getUint32(e+8,!0),r.getUint32(e+12,!0)),e+16}case 22:return t.getPass()?.drawIndexed(r.getUint32(e,!0),r.getUint32(e+4,!0),r.getUint32(e+8,!0),r.getInt32(e+12,!0),r.getUint32(e+16,!0)),e+20;case 23:return t.log("[GPU] endPass"),t.getPass()?.end(),t.setPass(null),e;case 24:return t.getPass()?.dispatchWorkgroups(r.getUint32(e,!0),r.getUint32(e+4,!0),r.getUint32(e+8,!0)),e+12;case 25:return t.getPass()?.setIndexBuffer(t.buf[r.getUint16(e,!0)],r.getUint8(e+2)===1?"uint32":"uint16"),e+3;case 26:{let d=r.getUint8(e);return e+1+d*2}default:return null}}var me={0:"rgba8unorm",1:"rgba8snorm",2:"rgba8uint",3:"rgba8sint",4:"bgra8unorm",5:"rgba16float",6:"rgba32float",16:"depth24plus",17:"depth24plus-stencil8",18:"depth32float",32:"r32float",33:"rg32float"},be=c=>me[c]??navigator.gpu.getPreferredCanvasFormat(),p=["nearest","linear"],Y=c=>p[c]??"linear",k=["clamp-to-edge","repeat","mirror-repeat"],Z=c=>k[c]??"clamp-to-edge",xe=0,he=1,Ge=2,$e=3,Pe=4,ye=5,Ee=6,Be=7,De=8,Te=9,Ae=10,Ce=11,_e=12,Se=13;var Me=1111969360;function Ie(c){let r=new DataView(c.buffer,c.byteOffset,c.byteLength);if(r.getUint32(0,!0)!==Me)return{uniforms:new Map,strings:[]};let e=r.getUint32(20,!0),t=r.getUint32(32,!0),d=Le(c,e),u=new Map;if(t===0||t>=c.length)return{uniforms:u,strings:d};let l=t,y=r.getUint16(l,!0);l+=2;for(let B=0;B<y&&l+8<=c.length;B++){let b=r.getUint16(l,!0);l+=2,l+=4;let $=r.getUint16(l,!0);l+=2;for(let C=0;C<$&&l+10<=c.length;C++){l+=2;let D=r.getUint16(l,!0);l+=2;let T=r.getUint16(l,!0);l+=2;let A=r.getUint16(l,!0);l+=2;let S=r.getUint8(l);l+=2;let M=d[D]||`field_${D}`;u.set(M,{bufferId:b,offset:T,size:A,type:S})}}return{uniforms:u,strings:d}}function Le(c,r){if(r===0||r>=c.length-2)return[];let e=new DataView(c.buffer,c.byteOffset,c.byteLength),t=new TextDecoder,d=[],u=e.getUint16(r,!0);if(u===0)return d;let l=r+2,y=l+u*2,B=y+u*2;if(B>c.length)return d;for(let b=0;b<u;b++){let $=e.getUint16(l+b*2,!0),C=e.getUint16(y+b*2,!0),D=B+$;D+C<=c.length?d.push(t.decode(c.subarray(D,D+C))):d.push(`string_${b}`)}return d}function K(c,r){let e=null,t=0,d=0,u=0,l=null,y=null,B=!1,b=[],$=[],C=[],D=[],T=[],A=[],S=[],M=[],q=[],O=[],w=[],N=[],W=[],j=[];function V(i,a){return a===0?"":new TextDecoder().decode(new Uint8Array(e.buffer,i,a))}let Q=be;function v(i,a,n){b[i]||(b[i]=c.createBuffer({size:a,usage:n||GPUBufferUsage.COPY_DST}))}function ee(i,a,n){if(T[i]||n===0)return;let f=V(a,n),o=c.createShaderModule({code:f});o.getCompilationInfo().then(g=>{for(let s of g.messages)s.type==="error"&&(console.error(`[GPU] Shader ${i} error at line ${s.lineNum}:${s.linePos}: ${s.message}`),console.error(`[GPU] Context: ${f.split(`
|
|
2
|
+
`).slice(Math.max(0,s.lineNum-3),s.lineNum+2).join(`
|
|
3
|
+
`)}`))}),T[i]=o}function te(i,a,n){if(A[i]||n===0)return;let f=JSON.parse(V(a,n)),o=navigator.gpu.getPreferredCanvasFormat(),g=f.fragment?.targetFormat;(!g||g==="preferredCanvasFormat")&&(g=o);let s=[{format:g}],U=c.createRenderPipeline({layout:"auto",vertex:{module:T[f.vertex?.shader??0],entryPoint:f.vertex?.entryPoint??"vs_main",buffers:f.vertex?.buffers??[]},fragment:{module:T[f.fragment?.shader??f.vertex?.shader??0],entryPoint:f.fragment?.entryPoint??"fs_main",targets:s},primitive:f.primitive??{topology:"triangle-list"},depthStencil:f.depthStencil});A[i]=U,M[i]=U.getBindGroupLayout(0)}function re(i,a,n){if(A[i]||n<4)return;let f=new Uint8Array(e.buffer,a,n),g=new DataView(f.buffer,f.byteOffset,f.byteLength).getUint16(1,!0),s=f[3],U=s>0?new TextDecoder().decode(f.slice(4,4+s)):"main",m=c.createComputePipeline({layout:"auto",compute:{module:T[g]??T[0],entryPoint:U}});A[i]=m,M[i]=m.getBindGroupLayout(0)}function ne(i,a,n){if($[i]||n===0)return;let f=new Uint8Array(e.buffer,a,n),o=new DataView(f.buffer,f.byteOffset,f.byteLength),g=2,s={size:[d||512,u||512],format:navigator.gpu.getPreferredCanvasFormat(),usage:GPUTextureUsage.RENDER_ATTACHMENT,sampleCount:1},U=f[1];for(let m=0;m<U;m++){let x=f[g++],h=f[g++];if(h===0){let E=o.getUint32(g,!0);g+=4,x===1?s.size[0]=E:x===2?s.size[1]=E:x===5&&(s.sampleCount=E)}else if(h===7){let E=f[g++];x===7?s.format=Q(E):x===8&&(s.usage=E||GPUTextureUsage.RENDER_ATTACHMENT)}}j[i]={format:s.format,usage:s.usage},$[i]=c.createTexture(s)}function ae(i,a,n){if(D[i]||n===0)return;let f=new Uint8Array(e.buffer,a,n),o=2,g={magFilter:p[1],minFilter:p[1],addressModeU:k[0],addressModeV:k[0]},s=f[1];for(let U=0;U<s;U++){let m=f[o++];if(f[o++]===7){let h=f[o++];m===4?g.magFilter=Y(h):m===5?g.minFilter=Y(h):m===1?g.addressModeU=Z(h):m===2&&(g.addressModeV=Z(h))}}D[i]=c.createSampler(g)}function ie(i,a,n,f){if(S[i]||f===0)return;let o=new Uint8Array(e.buffer,n,f),g=new DataView(o.buffer,o.byteOffset,o.byteLength),s=2,U=0,m=[],x=o[1];for(let G=0;G<x;G++){let P=o[s++],I=o[s++];if(P===1&&I===7)U=o[s++];else if(P===2&&I===3){let L=o[s++];for(let _=0;_<L;_++){let F=o[s++],H=o[s++],Ue=g.getUint16(s,!0);s+=2;let z={binding:F,rt:H,rid:Ue};H===0&&(z.offset=g.getUint32(s,!0),s+=4,z.size=g.getUint32(s,!0),s+=4),m.push(z)}}}W[i]={layoutId:a,gi:U,entries:m};let h=A[a];if(!h)return;let E=m.map(G=>{let P={binding:G.binding};return G.rt===0?(P.resource={buffer:b[G.rid]},G.offset&&(P.resource.offset=G.offset),G.size&&(P.resource.size=G.size)):G.rt===1?P.resource=$[G.rid]?.createView():G.rt===2&&(P.resource=D[G.rid]),P});S[i]=c.createBindGroup({layout:h.getBindGroupLayout(U),entries:E})}function se(i,a,n,f){l||(l=c.createCommandEncoder());let o=65534,g;i===o?g=r.getCurrentTexture().createView():g=$[i]?.createView();let s={colorAttachments:[{view:g,loadOp:a===1?"clear":"load",storeOp:n===0?"store":"discard",clearValue:{r:0,g:0,b:0,a:0}}]};f!==65535&&$[f]&&(s.depthStencilAttachment={view:$[f].createView(),depthLoadOp:"clear",depthStoreOp:"store",depthClearValue:1}),y=l.beginRenderPass(s)}function ue(){l||(l=c.createCommandEncoder()),y=l.beginComputePass()}let ce={createBuffer:v,createTexture:ne,createSampler:ae,createShader:ee,createRenderPipeline:te,createComputePipeline:re,createBindGroup:ie,txv:C,tex:$,bgl:M,device:c,rs:V,get mem(){return e},bmp:O,ppl:q,beginRenderPass:se,beginComputePass:ue,getPass:()=>y,setPass:i=>{y=i},pip:A,bg:S,buf:b,log:i=>{}};function oe(i,a,n){let f=X(i,a,n,ce);if(f!==null)return f;switch(i){case 32:{let o=a.getUint16(n,!0),g=a.getUint32(n+2,!0),s=a.getUint32(n+6,!0),U=a.getUint32(n+10,!0);return b[o]&&U>0&&c.queue.writeBuffer(b[o],g,new Uint8Array(e.buffer,s,U)),n+14}case 33:{let o=a.getUint16(n,!0),g=a.getUint32(n+2,!0),s=a.getUint16(n+6,!0);if(b[o]){let U=new Float32Array([t,d,u,d/(u||1)]);c.queue.writeBuffer(b[o],g,new Uint8Array(U.buffer,0,Math.min(s,16)))}return n+8}case 34:{let o=a.getUint16(n,!0),g=a.getUint32(n+2,!0),s=a.getUint16(n+6,!0),U=a.getUint32(n+8,!0),m=a.getUint32(n+12,!0);return l||(l=c.createCommandEncoder()),l.copyBufferToBuffer(b[o],g,b[s],U,m),n+16}case 35:{let o=a.getUint16(n,!0),g=a.getUint16(n+2,!0),s=a.getUint16(n+4,!0),U=a.getUint16(n+6,!0);return l||(l=c.createCommandEncoder()),l.copyTextureToTexture({texture:$[o]},{texture:$[g]},[s,U]),n+8}case 36:{let o=a.getUint16(n,!0),g=a.getUint32(n+2,!0),s=a.getUint32(n+6,!0),U=a.getUint32(n+10,!0),m=N[s];if(b[o]&&m&&U>0){let x=w[m.mid],h=x?.inst?.exports?.memory?.buffer||x?.importedMem?.buffer;h&&m.result!=null&&m.result+U<=h.byteLength&&c.queue.writeBuffer(b[o],g,new Uint8Array(h,m.result,U))}return n+14}case 37:{let o=a.getUint16(n,!0),g=a.getUint16(n+2,!0),s=a.getUint8(n+4),U=a.getUint16(n+5,!0),m=a.getUint16(n+7,!0),x=O[o];return x&&$[g]&&c.queue.copyExternalImageToTexture({source:x},{texture:$[g],mipLevel:s,origin:[U,m]},[x.width,x.height]),n+9}case 48:{let o=a.getUint16(n,!0),g=a.getUint32(n+2,!0),s=a.getUint32(n+6,!0);if(s===0)return n+10;let U=new Uint8Array(e.buffer,g,s).slice(),m=new WebAssembly.Memory({initial:1}),x={env:{abort:()=>{throw new Error("WASM abort")},memory:m}};return WebAssembly.compile(U).then(h=>WebAssembly.instantiate(h,x).then(E=>(w[o]={inst:E,importedMem:m},n+10)))}case 49:{let o=a.getUint16(n,!0),g=a.getUint16(n+2,!0),s=a.getUint32(n+4,!0),U=a.getUint32(n+8,!0),m=a.getUint8(n+12),x=new Uint8Array(e.buffer,n+13,m).slice(),h=V(s,U),{inst:E}=w[g]||{},G=E?.exports[h],P=[],I=new DataView(x.buffer,x.byteOffset,x.byteLength);for(let L=0,_=0;L<m/5|0;L++){let F=x[_++];F===0?P.push(I.getFloat32(_,!0)):F===1?P.push(I.getInt32(_,!0)):F===2&&P.push(I.getUint32(_,!0)),_+=4}if(G){let L=G(...P);N[o]={mid:g,result:L}}return n+13+m}case 240:return l&&(c.queue.submit([l.finish()]),l=null),n;case 255:return n;default:return n}}async function fe(i){let a=new DataView(e.buffer),n=a.getUint32(i,!0),f=a.getUint16(i+4,!0),o=i+8,g=i+n;for(let s=0;s<f&&o<g;s++){let U=a.getUint8(o++),m=oe(U,a,o);m instanceof Promise?(o=await m,a=new DataView(e.buffer)):o=m}}function ge(){b.forEach(i=>i?.destroy?.()),$.forEach(i=>i?.destroy?.()),b.length=$.length=C.length=D.length=T.length=A.length=0,S.length=M.length=q.length=O.length=w.length=0,N.length=W.length=j.length=0}let R=null;function le(i){R=i}function J(i,a){if(!R)return!1;let n=R.get(i);if(!n)return!1;let f=b[n.bufferId];if(!f)return!1;let o=Fe(a,n.type,n.size);return o?(c.queue.writeBuffer(f,n.offset,o),!0):!1}function de(i){let a=0;for(let[n,f]of Object.entries(i))J(n,f)&&a++;return a}return{setDebug(i){B=i},setMemory(i){e=i},setTime(i){t=i},setCanvasSize(i,a){d=i,u=a},setUniformTable:le,setUniform:J,setUniforms:de,execute:fe,destroy:ge}}function Fe(c,r,e){let t=Array.isArray(c)?c:[c];switch(r){case xe:case $e:case Pe:case ye:{let u=new Float32Array(t);return new Uint8Array(u.buffer,0,Math.min(u.byteLength,e))}case he:case De:case Te:case Ae:{let u=new Int32Array(t);return new Uint8Array(u.buffer,0,Math.min(u.byteLength,e))}case Ge:case Ce:case _e:case Se:{let u=new Uint32Array(t);return new Uint8Array(u.buffer,0,Math.min(u.byteLength,e))}case Ee:{let u=new Float32Array(12);return t.length>=9&&(u[0]=t[0],u[1]=t[3],u[2]=t[6],u[3]=0,u[4]=t[1],u[5]=t[4],u[6]=t[7],u[7]=0,u[8]=t[2],u[9]=t[5],u[10]=t[8],u[11]=0),new Uint8Array(u.buffer,0,Math.min(48,e))}case Be:{let u=new Float32Array(t.length>=16?t:[...t,...Array(16-t.length).fill(0)]);return new Uint8Array(u.buffer,0,Math.min(64,e))}default:let d=new Float32Array(t);return new Uint8Array(d.buffer,0,Math.min(d.byteLength,e))}}function Re(c,r){let e=K(c,r);return{setMemory(t){e.setMemory(t)},execute(t){e.execute(t)},setUniform(t,d){return e.setUniform(t,d)},setUniforms(t){return e.setUniforms(t)},setUniformTable(t){e.setUniformTable(t)},destroy(){e.destroy()},setDebug(t){e.setDebug(t)},setTime(t){e.setTime(t)},setCanvasSize(t,d){e.setCanvasSize(t,d)},_dispatcher:e}}async function ze(c){if(!navigator.gpu)throw new Error("WebGPU not supported");let r=c||await navigator.gpu.requestAdapter();if(!r)throw new Error("No GPU adapter found");return r.requestDevice()}function pe(c,r){let e=c.getContext("webgpu");if(!e)throw new Error("Failed to get WebGPU context");return e.configure({device:r,format:navigator.gpu.getPreferredCanvasFormat(),alphaMode:"premultiplied"}),e}export{pe as configureCanvas,K as createCommandDispatcher,Re as createCoreDispatcher,ze as getDevice,Ie as parseUniformTable};
|
package/dist/dev.d.ts
ADDED
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
|
|
2
|
+
export interface DevOptions {
|
|
3
|
+
canvas?: HTMLCanvasElement;
|
|
4
|
+
debug?: boolean;
|
|
5
|
+
dpr?: number;
|
|
6
|
+
wasmUrl?: string | URL;
|
|
7
|
+
onError?: (error: Error) => void;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
export function pngine(
|
|
11
|
+
source: ArrayBuffer | Uint8Array | Blob | string | HTMLImageElement,
|
|
12
|
+
options?: DevOptions
|
|
13
|
+
): Promise<PngineInstance>;
|
|
14
|
+
|
|
15
|
+
/** Uniform value: number (f32), array (vecNf), or nested array (matNxMf) */
|
|
16
|
+
export type UniformValue = number | number[] | number[][];
|
|
17
|
+
|
|
18
|
+
export interface DrawOptions {
|
|
19
|
+
time?: number;
|
|
20
|
+
frame?: string;
|
|
21
|
+
uniforms?: Record<string, UniformValue>;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export interface PngineInstance {
|
|
25
|
+
readonly width: number;
|
|
26
|
+
readonly height: number;
|
|
27
|
+
readonly frameCount: number;
|
|
28
|
+
readonly isPlaying: boolean;
|
|
29
|
+
readonly time: number;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function destroy(instance: PngineInstance): void;
|
|
33
|
+
export function draw(instance: PngineInstance, options?: DrawOptions): void;
|
|
34
|
+
export function play(instance: PngineInstance): PngineInstance;
|
|
35
|
+
export function pause(instance: PngineInstance): PngineInstance;
|
|
36
|
+
export function stop(instance: PngineInstance): PngineInstance;
|
|
37
|
+
export function seek(instance: PngineInstance, time: number): PngineInstance;
|
|
38
|
+
export function setFrame(instance: PngineInstance, frame: string | null): PngineInstance;
|
|
39
|
+
export function setUniform(instance: PngineInstance, name: string, value: UniformValue, redraw?: boolean): PngineInstance;
|
|
40
|
+
export function setUniforms(instance: PngineInstance, uniforms: Record<string, UniformValue>, redraw?: boolean): PngineInstance;
|
|
41
|
+
export function getUniforms(instance: PngineInstance): Promise<Record<string, { type: number; size: number; bufferId: number; offset: number }>>;
|
|
42
|
+
|
|
43
|
+
export function extractBytecode(data: ArrayBuffer | Uint8Array): Promise<Uint8Array>;
|
|
44
|
+
export function detectFormat(data: ArrayBuffer | Uint8Array): 'png' | 'zip' | 'pngb' | null;
|
|
45
|
+
export function isPng(data: ArrayBuffer | Uint8Array): boolean;
|
|
46
|
+
export function isZip(data: ArrayBuffer | Uint8Array): boolean;
|
|
47
|
+
export function isPngb(data: ArrayBuffer | Uint8Array): boolean;
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
export interface PayloadInfo {
|
|
51
|
+
version: number;
|
|
52
|
+
hasEmbeddedExecutor: boolean;
|
|
53
|
+
hasAnimationTable: boolean;
|
|
54
|
+
plugins: {
|
|
55
|
+
core: boolean;
|
|
56
|
+
render: boolean;
|
|
57
|
+
compute: boolean;
|
|
58
|
+
wasm: boolean;
|
|
59
|
+
animation: boolean;
|
|
60
|
+
texture: boolean;
|
|
61
|
+
};
|
|
62
|
+
executor: Uint8Array | null;
|
|
63
|
+
bytecode: Uint8Array;
|
|
64
|
+
payload: Uint8Array;
|
|
65
|
+
offsets: {
|
|
66
|
+
executor: number;
|
|
67
|
+
executorLength: number;
|
|
68
|
+
bytecode: number;
|
|
69
|
+
bytecodeLength: number;
|
|
70
|
+
stringTable: number;
|
|
71
|
+
data: number;
|
|
72
|
+
wgsl: number;
|
|
73
|
+
uniform: number;
|
|
74
|
+
animation: number;
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
export interface ExecutorInstance {
|
|
79
|
+
instance: WebAssembly.Instance;
|
|
80
|
+
memory: WebAssembly.Memory;
|
|
81
|
+
exports: WebAssembly.Exports;
|
|
82
|
+
getBytecodePtr(): number;
|
|
83
|
+
setBytecodeLen(len: number): void;
|
|
84
|
+
getDataPtr(): number;
|
|
85
|
+
setDataLen(len: number): void;
|
|
86
|
+
init(): void;
|
|
87
|
+
frame(time: number, width: number, height: number): void;
|
|
88
|
+
getCommandPtr(): number;
|
|
89
|
+
getCommandLen(): number;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export interface ExecutorCallbacks {
|
|
93
|
+
log?: (ptr: number, len: number) => void;
|
|
94
|
+
wasmInstantiate?: (id: number, ptr: number, len: number) => void;
|
|
95
|
+
wasmCall?: (callId: number, modId: number, namePtr: number, nameLen: number, argsPtr: number, argsLen: number) => void;
|
|
96
|
+
wasmGetResult?: (callId: number, outPtr: number, outLen: number) => number;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export function parsePayload(pngb: Uint8Array): PayloadInfo;
|
|
100
|
+
export function createExecutor(wasmBytes: Uint8Array, imports?: WebAssembly.Imports): Promise<ExecutorInstance>;
|
|
101
|
+
export function getExecutorImports(callbacks?: ExecutorCallbacks): WebAssembly.Imports;
|
|
102
|
+
export function getExecutorVariantName(plugins: PayloadInfo['plugins']): string;
|
package/dist/dev.mjs
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
var G='function ce(t,n,e,r){switch(t){case 1:return r.createBuffer(n.getUint16(e,!0),n.getUint32(e+2,!0),n.getUint8(e+6)),e+7;case 2:return r.createTexture(n.getUint16(e,!0),n.getUint32(e+2,!0),n.getUint32(e+6,!0)),e+10;case 3:return r.createSampler(n.getUint16(e,!0),n.getUint32(e+2,!0),n.getUint32(e+6,!0)),e+10;case 4:return r.createShader(n.getUint16(e,!0),n.getUint32(e+2,!0),n.getUint32(e+6,!0)),e+10;case 5:return r.createRenderPipeline(n.getUint16(e,!0),n.getUint32(e+2,!0),n.getUint32(e+6,!0)),e+10;case 6:return r.createComputePipeline(n.getUint16(e,!0),n.getUint32(e+2,!0),n.getUint32(e+6,!0)),e+10;case 7:return r.createBindGroup(n.getUint16(e,!0),n.getUint16(e+2,!0),n.getUint32(e+4,!0),n.getUint32(e+8,!0)),e+12;case 8:{let c=n.getUint16(e,!0),s=n.getUint16(e+2,!0);return!r.txv[c]&&r.tex[s]&&(r.txv[c]=r.tex[s].createView()),e+12}case 9:return e+10;case 10:{let c=n.getUint16(e,!0),s=n.getUint32(e+2,!0),f=n.getUint32(e+6,!0);return r.bgl[c]||(r.bgl[c]=r.device.createBindGroupLayout(JSON.parse(r.rs(s,f)))),e+10}case 11:{let c=n.getUint16(e,!0),s=n.getUint32(e+2,!0),f=n.getUint32(e+6,!0);if(f===0)return e+10;let G=new Blob([new Uint8Array(r.mem.buffer,s,f)]);return createImageBitmap(G).then($=>(r.bmp[c]=$,e+10))}case 12:{let c=n.getUint16(e,!0),s=n.getUint32(e+2,!0),f=n.getUint32(e+6,!0),G=JSON.parse(r.rs(s,f));return r.ppl[c]=r.device.createPipelineLayout({bindGroupLayouts:G.bindGroupLayouts.map($=>r.bgl[$])}),e+10}case 13:return e+10;case 16:return r.beginRenderPass(n.getUint16(e,!0),n.getUint8(e+2),n.getUint8(e+3),n.getUint16(e+4,!0)),e+6;case 17:return r.beginComputePass(),e;case 18:{let c=n.getUint16(e,!0);return r.log(`[GPU] setPipeline(${c})`),r.getPass()?.setPipeline(r.pip[c]),e+2}case 19:{let c=n.getUint8(e),s=n.getUint16(e+1,!0);return r.log(`[GPU] setBindGroup(${c}, ${s}) pass=${r.getPass()?"valid":"NULL"} bg[${s}]=${r.bg[s]?"exists":"MISSING"}`),r.getPass()?.setBindGroup(c,r.bg[s]),e+3}case 20:return r.getPass()?.setVertexBuffer(n.getUint8(e),r.buf[n.getUint16(e+1,!0)]),e+3;case 21:{let c=n.getUint32(e,!0),s=n.getUint32(e+4,!0);return r.log(`[GPU] draw(${c}, ${s}) pass=${r.getPass()?"valid":"NULL"}`),r.getPass()?.draw(c,s,n.getUint32(e+8,!0),n.getUint32(e+12,!0)),e+16}case 22:return r.getPass()?.drawIndexed(n.getUint32(e,!0),n.getUint32(e+4,!0),n.getUint32(e+8,!0),n.getInt32(e+12,!0),n.getUint32(e+16,!0)),e+20;case 23:return r.log("[GPU] endPass"),r.getPass()?.end(),r.setPass(null),e;case 24:return r.getPass()?.dispatchWorkgroups(n.getUint32(e,!0),n.getUint32(e+4,!0),n.getUint32(e+8,!0)),e+12;case 25:return r.getPass()?.setIndexBuffer(r.buf[n.getUint16(e,!0)],n.getUint8(e+2)===1?"uint32":"uint16"),e+3;case 26:{let c=n.getUint8(e);return e+1+c*2}default:return null}}var Se={0:"rgba8unorm",1:"rgba8snorm",2:"rgba8uint",3:"rgba8sint",4:"bgra8unorm",5:"rgba16float",6:"rgba32float",16:"depth24plus",17:"depth24plus-stencil8",18:"depth32float",32:"r32float",33:"rg32float"},pe=t=>Se[t]??navigator.gpu.getPreferredCanvasFormat(),Q=["nearest","linear"],ue=t=>Q[t]??"linear",v=["clamp-to-edge","repeat","mirror-repeat"],fe=t=>v[t]??"clamp-to-edge",Oe=0,Ne=1,Re=2,Fe=3,Ve=4,ze=5,ke=6,We=7,je=8,qe=9,He=10,Ye=11,Xe=12,Je=13;var Ze=1111969360;function le(t){let n=new DataView(t.buffer,t.byteOffset,t.byteLength);if(n.getUint32(0,!0)!==Ze)return{uniforms:new Map,strings:[]};let e=n.getUint32(20,!0),r=n.getUint32(32,!0),c=Ke(t,e),s=new Map;if(r===0||r>=t.length)return{uniforms:s,strings:c};let f=r,G=n.getUint16(f,!0);f+=2;for(let $=0;$<G&&f+8<=t.length;$++){let b=n.getUint16(f,!0);f+=2,f+=4;let h=n.getUint16(f,!0);f+=2;for(let w=0;w<h&&f+10<=t.length;w++){f+=2;let T=n.getUint16(f,!0);f+=2;let D=n.getUint16(f,!0);f+=2;let B=n.getUint16(f,!0);f+=2;let N=n.getUint8(f);f+=2;let R=c[T]||`field_${T}`;s.set(R,{bufferId:b,offset:D,size:B,type:N})}}return{uniforms:s,strings:c}}function Ke(t,n){if(n===0||n>=t.length-2)return[];let e=new DataView(t.buffer,t.byteOffset,t.byteLength),r=new TextDecoder,c=[],s=e.getUint16(n,!0);if(s===0)return c;let f=n+2,G=f+s*2,$=G+s*2;if($>t.length)return c;for(let b=0;b<s;b++){let h=e.getUint16(f+b*2,!0),w=e.getUint16(G+b*2,!0),T=$+h;T+w<=t.length?c.push(r.decode(t.subarray(T,T+w))):c.push(`string_${b}`)}return c}function ee(t,n){let e=null,r=0,c=0,s=0,f=null,G=null,$=!1,b=[],h=[],w=[],T=[],D=[],B=[],N=[],R=[],re=[],X=[],q=[],J=[],oe=[],se=[];function H(i,a){return a===0?"":new TextDecoder().decode(new Uint8Array(e.buffer,i,a))}let xe=pe;function he(i,a,o){b[i]||(b[i]=t.createBuffer({size:a,usage:o||GPUBufferUsage.COPY_DST}))}function ye(i,a,o){if(D[i]||o===0)return;let g=H(a,o),l=t.createShaderModule({code:g});l.getCompilationInfo().then(d=>{for(let u of d.messages)u.type==="error"&&(console.error(`[GPU] Shader ${i} error at line ${u.lineNum}:${u.linePos}: ${u.message}`),console.error(`[GPU] Context: ${g.split(`\n`).slice(Math.max(0,u.lineNum-3),u.lineNum+2).join(`\n`)}`))}),D[i]=l}function Pe(i,a,o){if(B[i]||o===0)return;let g=JSON.parse(H(a,o)),l=navigator.gpu.getPreferredCanvasFormat(),d=g.fragment?.targetFormat;(!d||d==="preferredCanvasFormat")&&(d=l);let u=[{format:d}],m=t.createRenderPipeline({layout:"auto",vertex:{module:D[g.vertex?.shader??0],entryPoint:g.vertex?.entryPoint??"vs_main",buffers:g.vertex?.buffers??[]},fragment:{module:D[g.fragment?.shader??g.vertex?.shader??0],entryPoint:g.fragment?.entryPoint??"fs_main",targets:u},primitive:g.primitive??{topology:"triangle-list"},depthStencil:g.depthStencil});B[i]=m,R[i]=m.getBindGroupLayout(0)}function Ee(i,a,o){if(B[i]||o<4)return;let g=new Uint8Array(e.buffer,a,o),d=new DataView(g.buffer,g.byteOffset,g.byteLength).getUint16(1,!0),u=g[3],m=u>0?new TextDecoder().decode(g.slice(4,4+u)):"main",U=t.createComputePipeline({layout:"auto",compute:{module:D[d]??D[0],entryPoint:m}});B[i]=U,R[i]=U.getBindGroupLayout(0)}function Ge(i,a,o){if(h[i]||o===0)return;let g=new Uint8Array(e.buffer,a,o),l=new DataView(g.buffer,g.byteOffset,g.byteLength),d=2,u={size:[c||512,s||512],format:navigator.gpu.getPreferredCanvasFormat(),usage:GPUTextureUsage.RENDER_ATTACHMENT,sampleCount:1},m=g[1];for(let U=0;U<m;U++){let x=g[d++],y=g[d++];if(y===0){let I=l.getUint32(d,!0);d+=4,x===1?u.size[0]=I:x===2?u.size[1]=I:x===5&&(u.sampleCount=I)}else if(y===7){let I=g[d++];x===7?u.format=xe(I):x===8&&(u.usage=I||GPUTextureUsage.RENDER_ATTACHMENT)}}se[i]={format:u.format,usage:u.usage},h[i]=t.createTexture(u)}function $e(i,a,o){if(T[i]||o===0)return;let g=new Uint8Array(e.buffer,a,o),l=2,d={magFilter:Q[1],minFilter:Q[1],addressModeU:v[0],addressModeV:v[0]},u=g[1];for(let m=0;m<u;m++){let U=g[l++];if(g[l++]===7){let y=g[l++];U===4?d.magFilter=ue(y):U===5?d.minFilter=ue(y):U===1?d.addressModeU=fe(y):U===2&&(d.addressModeV=fe(y))}}T[i]=t.createSampler(d)}function De(i,a,o,g){if(N[i]||g===0)return;let l=new Uint8Array(e.buffer,o,g),d=new DataView(l.buffer,l.byteOffset,l.byteLength),u=2,m=0,U=[],x=l[1];for(let P=0;P<x;P++){let A=l[u++],F=l[u++];if(A===1&&F===7)m=l[u++];else if(A===2&&F===3){let V=l[u++];for(let M=0;M<V;M++){let W=l[u++],ie=l[u++],Me=d.getUint16(u,!0);u+=2;let K={binding:W,rt:ie,rid:Me};ie===0&&(K.offset=d.getUint32(u,!0),u+=4,K.size=d.getUint32(u,!0),u+=4),U.push(K)}}}oe[i]={layoutId:a,gi:m,entries:U};let y=B[a];if(!y)return;let I=U.map(P=>{let A={binding:P.binding};return P.rt===0?(A.resource={buffer:b[P.rid]},P.offset&&(A.resource.offset=P.offset),P.size&&(A.resource.size=P.size)):P.rt===1?A.resource=h[P.rid]?.createView():P.rt===2&&(A.resource=T[P.rid]),A});N[i]=t.createBindGroup({layout:y.getBindGroupLayout(m),entries:I})}function Ae(i,a,o,g){f||(f=t.createCommandEncoder());let l=65534,d;i===l?d=n.getCurrentTexture().createView():d=h[i]?.createView();let u={colorAttachments:[{view:d,loadOp:a===1?"clear":"load",storeOp:o===0?"store":"discard",clearValue:{r:0,g:0,b:0,a:0}}]};g!==65535&&h[g]&&(u.depthStencilAttachment={view:h[g].createView(),depthLoadOp:"clear",depthStoreOp:"store",depthClearValue:1}),G=f.beginRenderPass(u)}function we(){f||(f=t.createCommandEncoder()),G=f.beginComputePass()}let Te={createBuffer:he,createTexture:Ge,createSampler:$e,createShader:ye,createRenderPipeline:Pe,createComputePipeline:Ee,createBindGroup:De,txv:w,tex:h,bgl:R,device:t,rs:H,get mem(){return e},bmp:X,ppl:re,beginRenderPass:Ae,beginComputePass:we,getPass:()=>G,setPass:i=>{G=i},pip:B,bg:N,buf:b,log:i=>{}};function Be(i,a,o){let g=ce(i,a,o,Te);if(g!==null)return g;switch(i){case 32:{let l=a.getUint16(o,!0),d=a.getUint32(o+2,!0),u=a.getUint32(o+6,!0),m=a.getUint32(o+10,!0);return b[l]&&m>0&&t.queue.writeBuffer(b[l],d,new Uint8Array(e.buffer,u,m)),o+14}case 33:{let l=a.getUint16(o,!0),d=a.getUint32(o+2,!0),u=a.getUint16(o+6,!0);if(b[l]){let m=new Float32Array([r,c,s,c/(s||1)]);t.queue.writeBuffer(b[l],d,new Uint8Array(m.buffer,0,Math.min(u,16)))}return o+8}case 34:{let l=a.getUint16(o,!0),d=a.getUint32(o+2,!0),u=a.getUint16(o+6,!0),m=a.getUint32(o+8,!0),U=a.getUint32(o+12,!0);return f||(f=t.createCommandEncoder()),f.copyBufferToBuffer(b[l],d,b[u],m,U),o+16}case 35:{let l=a.getUint16(o,!0),d=a.getUint16(o+2,!0),u=a.getUint16(o+4,!0),m=a.getUint16(o+6,!0);return f||(f=t.createCommandEncoder()),f.copyTextureToTexture({texture:h[l]},{texture:h[d]},[u,m]),o+8}case 36:{let l=a.getUint16(o,!0),d=a.getUint32(o+2,!0),u=a.getUint32(o+6,!0),m=a.getUint32(o+10,!0),U=J[u];if(b[l]&&U&&m>0){let x=q[U.mid],y=x?.inst?.exports?.memory?.buffer||x?.importedMem?.buffer;y&&U.result!=null&&U.result+m<=y.byteLength&&t.queue.writeBuffer(b[l],d,new Uint8Array(y,U.result,m))}return o+14}case 37:{let l=a.getUint16(o,!0),d=a.getUint16(o+2,!0),u=a.getUint8(o+4),m=a.getUint16(o+5,!0),U=a.getUint16(o+7,!0),x=X[l];return x&&h[d]&&t.queue.copyExternalImageToTexture({source:x},{texture:h[d],mipLevel:u,origin:[m,U]},[x.width,x.height]),o+9}case 48:{let l=a.getUint16(o,!0),d=a.getUint32(o+2,!0),u=a.getUint32(o+6,!0);if(u===0)return o+10;let m=new Uint8Array(e.buffer,d,u).slice(),U=new WebAssembly.Memory({initial:1}),x={env:{abort:()=>{throw new Error("WASM abort")},memory:U}};return WebAssembly.compile(m).then(y=>WebAssembly.instantiate(y,x).then(I=>(q[l]={inst:I,importedMem:U},o+10)))}case 49:{let l=a.getUint16(o,!0),d=a.getUint16(o+2,!0),u=a.getUint32(o+4,!0),m=a.getUint32(o+8,!0),U=a.getUint8(o+12),x=new Uint8Array(e.buffer,o+13,U).slice(),y=H(u,m),{inst:I}=q[d]||{},P=I?.exports[y],A=[],F=new DataView(x.buffer,x.byteOffset,x.byteLength);for(let V=0,M=0;V<U/5|0;V++){let W=x[M++];W===0?A.push(F.getFloat32(M,!0)):W===1?A.push(F.getInt32(M,!0)):W===2&&A.push(F.getUint32(M,!0)),M+=4}if(P){let V=P(...A);J[l]={mid:d,result:V}}return o+13+U}case 240:return f&&(t.queue.submit([f.finish()]),f=null),o;case 255:return o;default:return o}}async function Ie(i){let a=new DataView(e.buffer),o=a.getUint32(i,!0),g=a.getUint16(i+4,!0),l=i+8,d=i+o;for(let u=0;u<g&&l<d;u++){let m=a.getUint8(l++),U=Be(m,a,l);U instanceof Promise?(l=await U,a=new DataView(e.buffer)):l=U}}function Ce(){b.forEach(i=>i?.destroy?.()),h.forEach(i=>i?.destroy?.()),b.length=h.length=w.length=T.length=D.length=B.length=0,N.length=R.length=re.length=X.length=q.length=0,J.length=oe.length=se.length=0}let Z=null;function Le(i){Z=i}function ae(i,a){if(!Z)return!1;let o=Z.get(i);if(!o)return!1;let g=b[o.bufferId];if(!g)return!1;let l=Qe(a,o.type,o.size);return l?(t.queue.writeBuffer(g,o.offset,l),!0):!1}function _e(i){let a=0;for(let[o,g]of Object.entries(i))ae(o,g)&&a++;return a}return{setDebug(i){$=i},setMemory(i){e=i},setTime(i){r=i},setCanvasSize(i,a){c=i,s=a},setUniformTable:Le,setUniform:ae,setUniforms:_e,execute:Ie,destroy:Ce}}function Qe(t,n,e){let r=Array.isArray(t)?t:[t];switch(n){case Oe:case Fe:case Ve:case ze:{let s=new Float32Array(r);return new Uint8Array(s.buffer,0,Math.min(s.byteLength,e))}case Ne:case je:case qe:case He:{let s=new Int32Array(r);return new Uint8Array(s.buffer,0,Math.min(s.byteLength,e))}case Re:case Ye:case Xe:case Je:{let s=new Uint32Array(r);return new Uint8Array(s.buffer,0,Math.min(s.byteLength,e))}case ke:{let s=new Float32Array(12);return r.length>=9&&(s[0]=r[0],s[1]=r[3],s[2]=r[6],s[3]=0,s[4]=r[1],s[5]=r[4],s[6]=r[7],s[7]=0,s[8]=r[2],s[9]=r[5],s[10]=r[8],s[11]=0),new Uint8Array(s.buffer,0,Math.min(48,e))}case We:{let s=new Float32Array(r.length>=16?r:[...r,...Array(16-r.length).fill(0)]);return new Uint8Array(s.buffer,0,Math.min(64,e))}default:let c=new Float32Array(r);return new Uint8Array(c.buffer,0,Math.min(c.byteLength,e))}}var ve=[80,78,71,66],ge=0,de=40,et=1,tt=2,nt=1,rt=2,ot=4,st=8,at=16,it=32;function me(t){if(t.length<de)throw new Error("Invalid PNGB: too short");if(!ve.every((r,c)=>t[c]===r))throw new Error("Invalid PNGB: bad magic");let n=new DataView(t.buffer,t.byteOffset,t.byteLength),e=n.getUint16(4,!0);if(e!==ge)throw new Error(`Unsupported PNGB version: ${e}`);return ct(t,n)}function ct(t,n){let e=n.getUint16(6,!0),r=t[8],c=n.getUint32(12,!0),s=n.getUint32(16,!0),f=n.getUint32(20,!0),G=n.getUint32(24,!0),$=n.getUint32(28,!0),b=n.getUint32(32,!0),h=n.getUint32(36,!0),w=(e&et)!==0,T=(e&tt)!==0,D=w?c+s:de,B=f-D;return{version:ge,hasEmbeddedExecutor:w,hasAnimationTable:T,plugins:ut(r),executor:w?t.subarray(c,c+s):null,bytecode:t.subarray(D,D+B),payload:t,offsets:{executor:w?c:0,executorLength:s,bytecode:D,bytecodeLength:B,stringTable:f,data:G,wgsl:$,uniform:b,animation:h}}}function ut(t){return{core:(t&nt)!==0,render:(t&rt)!==0,compute:(t&ot)!==0,wasm:(t&st)!==0,animation:(t&at)!==0,texture:(t&it)!==0}}function Ue(t={}){return{env:{log:t.log||((n,e)=>{}),wasmInstantiate:t.wasmInstantiate||((n,e,r)=>{}),wasmCall:t.wasmCall||((n,e,r,c,s,f)=>{}),wasmGetResult:t.wasmGetResult||((n,e,r)=>0)}}}var C,p,Y,E,L,S,O=!1,z=!1,ne=0,j=!1,k=null,_={INIT:"init",DRAW:"draw",LOAD:"load",DESTROY:"destroy",SET_UNIFORM:"setUniform",GET_UNIFORMS:"getUniforms",READY:"ready",ERROR:"error",UNIFORMS:"uniforms"};onmessage=async t=>{let{type:n,...e}=t.data;try{switch(n){case _.INIT:await ft(e);break;case _.DRAW:gt(e);break;case _.LOAD:await lt(e);break;case _.DESTROY:dt();break;case _.SET_UNIFORM:mt(e);break;case _.GET_UNIFORMS:Ut();break;default:throw new Error(`Unknown message: ${n}`)}}catch(r){postMessage({type:_.ERROR,message:r.message})}};async function ft(t){if(O)throw new Error("Already initialized");C=t.canvas,j=t.debug;let n=await navigator.gpu?.requestAdapter();if(!n)throw new Error("WebGPU not supported");p=await n.requestDevice(),p.onuncapturederror=s=>{console.error("[Worker] WebGPU uncaptured error:",s.error.message)},Y=C.getContext("webgpu");let e=navigator.gpu.getPreferredCanvasFormat();Y.configure({device:p,format:e,alphaMode:"premultiplied"}),E=ee(p,Y),E.setDebug(j),E.setCanvasSize(C.width,C.height);let r=!1,c=null;if(t.bytecode)try{let s=new Uint8Array(t.bytecode);c=me(s),r=c.hasEmbeddedExecutor}catch(s){t.debug&&console.log("[Worker] Bytecode parse failed, using shared executor:",s.message)}if(r&&c.executor){t.debug&&console.log("[Worker] Using embedded executor from payload");let s=Ue({log:(G,$)=>{if(t.debug){let b=new TextDecoder().decode(new Uint8Array(S.buffer,G,$));console.log("[Executor]",b)}}}),{instance:f}=await WebAssembly.instantiate(c.executor,s);L=f.exports,S=L.memory,E.setMemory(S),O=!0,await te(c.payload)}else{if(!t.wasmUrl)throw new Error("wasmUrl required (no embedded executor)");let s=await fetch(t.wasmUrl);if(!s.ok)throw new Error(`Failed to fetch WASM: ${s.status}`);let{instance:f}=await WebAssembly.instantiateStreaming(s,bt());L=f.exports,S=L.memory,E.setMemory(S),O=!0,t.bytecode&&await te(t.bytecode)}postMessage({type:_.READY,width:C.width,height:C.height,frameCount:ne})}async function lt(t){if(!O)throw new Error("Not initialized");await te(t.bytecode),postMessage({type:_.READY,frameCount:ne})}async function te(t){z&&(E.destroy(),E=ee(p,Y),E.setDebug(j),E.setMemory(S),E.setCanvasSize(C.width,C.height),z=!1,k=null);let n=L.getBytecodePtr(),e=t instanceof Uint8Array?t:new Uint8Array(t);new Uint8Array(S.buffer,n,e.length).set(e),L.setBytecodeLen(e.length);let{uniforms:r}=le(e);k=r,j&&r.size>0&&console.log(`[Worker] Parsed ${r.size} uniform fields:`,[...r.keys()]);let c=L.init();if(c!==0)throw new Error(`Init failed: ${c}`);let s=L.getCommandPtr(),f=L.getCommandLen();s&&f>0&&await E.execute(s),E.setUniformTable(k),z=!0,ne=1,be(0,C.width,C.height)}function be(t,n,e){E.setTime(t);let r=L.frame(t,n,e);if(r!==0){console.warn("[Worker] frame() returned non-zero:",r);return}let c=L.getCommandPtr(),s=L.getCommandLen();!c||s===0||E.execute(c)}function gt(t){if(!(!O||!z)){if(t.uniforms&&typeof t.uniforms=="object"){let n=E.setUniforms(t.uniforms);j&&n>0&&console.log(`[Worker] Set ${n} uniforms`)}be(t.time??0,C.width,C.height)}}function dt(){z=!1,k=null,E?.destroy(),p&&(p.destroy(),p=null),O=!1}function mt(t){!O||!z||(t.uniforms&&typeof t.uniforms=="object"?E.setUniforms(t.uniforms):t.name!==void 0&&t.value!==void 0&&E.setUniform(t.name,t.value))}function Ut(){if(!k){postMessage({type:_.UNIFORMS,uniforms:{}});return}let t={};for(let[n,e]of k)t[n]={type:e.type,size:e.size,bufferId:e.bufferId,offset:e.offset};postMessage({type:_.UNIFORMS,uniforms:t})}function bt(){return{env:{log:(t,n)=>{let e=new TextDecoder().decode(new Uint8Array(S.buffer,t,n));console.log("[Executor]",e)}}}}\n';function S(){let e=new Blob([G],{type:"application/javascript"});return URL.createObjectURL(e)}var M=[137,80,78,71,13,10,26,10],b=[112,78,71,98],L=e=>e.length>=8&&M.every((t,n)=>e[n]===t),O=e=>e.length>=4&&e[0]===80&&e[1]===75&&(e[2]===3||e[2]===5),B=e=>e.length>=4&&e[0]===80&&e[1]===78&&e[2]===71&&e[3]===66;function D(e){return O(e)?"zip":L(e)?"png":B(e)?"pngb":null}async function P(e){let t=e instanceof Uint8Array?e:new Uint8Array(e),n=D(t);if(n==="pngb")return t;if(n==="png")return N(t);if(n==="zip")return _(t);throw new Error("Unknown format")}async function N(e){if(!L(e))throw new Error("Invalid PNG");let t=8;for(;t+12<=e.length;){let n=F(e,t),r=e.subarray(t+4,t+8);if(r[0]===b[0]&&r[1]===b[1]&&r[2]===b[2]&&r[3]===b[3]){let i=e.subarray(t+8,t+8+n);return R(i)}t+=12+n}throw new Error("No pNGb chunk found")}async function R(e){if(e.length<2)throw new Error("Invalid pNGb chunk");let t=e[0],n=e[1],r=e.subarray(2);if(t!==1)throw new Error(`Unsupported pNGb version: ${t}`);return n&1?v(r):new Uint8Array(r)}async function _(e){let t=-1;for(let o=22;o<=Math.min(e.length,65557);o++){let s=e.length-o;if(m(e,s)===101010256){t=s;break}}if(t===-1)throw new Error("Invalid ZIP");let n=g(e,t+10),r=m(e,t+16),i=null,a=null;for(let o=0;o<n&&m(e,r)===33639248;o++){let s=g(e,r+10),f=m(e,r+20),d=m(e,r+24),c=g(e,r+28),u=g(e,r+30),w=g(e,r+32),U=m(e,r+42),l=new TextDecoder().decode(e.subarray(r+46,r+46+c)),y=g(e,U+28),x=U+30+c+y,p={name:l,compression:s,compSize:f,uncompSize:d,dataOff:x};l==="manifest.json"?i=p:l.endsWith(".pngb")&&!a&&(a=p),r+=46+c+u+w}if(i){let o=JSON.parse(new TextDecoder().decode(await E(e,i)));if(o.entry){r=m(e,t+16);for(let s=0;s<n&&m(e,r)===33639248;s++){let f=g(e,r+28);if(new TextDecoder().decode(e.subarray(r+46,r+46+f))===o.entry){let c=g(e,r+10),u=m(e,r+20),w=m(e,r+24),U=g(e,r+30),l=g(e,r+32),y=m(e,r+42),x=g(e,y+28),p=y+30+f+x;return E(e,{compression:c,compSize:u,uncompSize:w,dataOff:p})}r+=46+f+g(e,r+30)+g(e,r+32)}}}if(a)return E(e,a);throw new Error("No bytecode found in ZIP")}async function E(e,t){let n=e.subarray(t.dataOff,t.dataOff+t.compSize);if(t.compression===0)return new Uint8Array(n);if(t.compression===8)return v(n);throw new Error(`Unsupported compression: ${t.compression}`)}async function v(e){let t=new DecompressionStream("deflate-raw"),n=t.writable.getWriter(),r=t.readable.getReader();n.write(e),n.close();let i=[],a=0;for(;;){let{done:f,value:d}=await r.read();if(f)break;i.push(d),a+=d.length}let o=new Uint8Array(a),s=0;for(let f of i)o.set(f,s),s+=f.length;return o}var g=(e,t)=>e[t]|e[t+1]<<8,m=(e,t)=>(e[t]|e[t+1]<<8|e[t+2]<<16|e[t+3]<<24)>>>0,F=(e,t)=>(e[t]<<24|e[t+1]<<16|e[t+2]<<8|e[t+3])>>>0,k=[80,78,71,66],I=0,T=40,$=1,W=2,z=1,V=2,q=4,H=8,j=16,Y=32;function Q(e){if(e.length<T)throw new Error("Invalid PNGB: too short");if(!k.every((r,i)=>e[i]===r))throw new Error("Invalid PNGB: bad magic");let t=new DataView(e.buffer,e.byteOffset,e.byteLength),n=t.getUint16(4,!0);if(n!==I)throw new Error(`Unsupported PNGB version: ${n}`);return Z(e,t)}function Z(e,t){let n=t.getUint16(6,!0),r=e[8],i=t.getUint32(12,!0),a=t.getUint32(16,!0),o=t.getUint32(20,!0),s=t.getUint32(24,!0),f=t.getUint32(28,!0),d=t.getUint32(32,!0),c=t.getUint32(36,!0),u=(n&$)!==0,w=(n&W)!==0,U=u?i+a:T,l=o-U;return{version:I,hasEmbeddedExecutor:u,hasAnimationTable:w,plugins:J(r),executor:u?e.subarray(i,i+a):null,bytecode:e.subarray(U,U+l),payload:e,offsets:{executor:u?i:0,executorLength:a,bytecode:U,bytecodeLength:l,stringTable:o,data:s,wgsl:f,uniform:d,animation:c}}}function J(e){return{core:(e&z)!==0,render:(e&V)!==0,compute:(e&q)!==0,wasm:(e&H)!==0,animation:(e&j)!==0,texture:(e&Y)!==0}}function ee(e={}){return{env:{log:e.log||((t,n)=>{}),wasmInstantiate:e.wasmInstantiate||((t,n,r)=>{}),wasmCall:e.wasmCall||((t,n,r,i,a,o)=>{}),wasmGetResult:e.wasmGetResult||((t,n,r)=>0)}}}async function te(e,t={}){let{instance:n}=await WebAssembly.instantiate(e,t),r=n.exports,i=r.memory;return{instance:n,memory:i,exports:r,getBytecodePtr(){return r.getBytecodePtr?.()||0},setBytecodeLen(a){r.setBytecodeLen?.(a)},getDataPtr(){return r.getDataPtr?.()||0},setDataLen(a){r.setDataLen?.(a)},init(){r.init?.()},frame(a,o,s){r.frame?.(a,o,s)},getCommandPtr(){return r.getCommandPtr?.()||0},getCommandLen(){return r.getCommandLen?.()||0}}}function ne(e){let t=["core"];return e.render&&t.push("render"),e.compute&&t.push("compute"),e.wasm&&t.push("wasm"),e.animation&&t.push("anim"),e.texture&&t.push("texture"),t.join("-")}function C(e,t){if(!e||e.length===0)return null;for(let n of e)if(t>=n.startMs&&t<n.endMs)return n;return e[e.length-1]}function h(e,t={}){let n=e._;if(!n)throw new Error("Pngine destroyed");if(!n.ready)throw new Error("Not initialized");let r=t.time??n.time,i=t.frame??null;if(i===null&&n.animation&&n.animation.scenes.length>0){let a=C(n.animation.scenes,r*1e3);a&&(i=a.frame,a!==n.currentScene&&(n.currentScene=a,n.currentFrame=a.frame))}n.worker.postMessage({type:"draw",time:r,frame:i,uniforms:t.uniforms??null}),t.time!==void 0&&(n.time=t.time)}function re(e){let t=e._;if(!t||t.playing)return e;t.playing=!0,t.startTime=performance.now()-t.time*1e3;let n=()=>{if(!t.playing)return;let r=performance.now(),i=(r-t.startTime)/1e3;if(t.animation){let a=t.animation.duration/1e3;if(i>=a)switch(t.animation.endBehavior){case"loop":case"restart":t.startTime=r,i=0;break;case"stop":t.playing=!1,t.time=a,h(e,{time:a});return;case"hold":default:i=a;break}let o=C(t.animation.scenes,i*1e3);o&&o!==t.currentScene&&(t.currentScene=o,t.currentFrame=o.frame)}t.time=i,h(e,{time:t.time,frame:t.currentFrame}),t.animationId=requestAnimationFrame(n)};return t.animationId=requestAnimationFrame(n),e}function K(e){let t=e._;return!t||!t.playing||(t.playing=!1,t.time=(performance.now()-t.startTime)/1e3,t.animationId&&(cancelAnimationFrame(t.animationId),t.animationId=null)),e}function ie(e){K(e);let t=e._;return t&&(t.time=0,t.startTime=performance.now(),h(e,{time:0})),e}function ae(e,t){let n=e._;return n&&(n.time=t,n.playing&&(n.startTime=performance.now()-t*1e3),h(e,{time:t})),e}function oe(e,t){let n=e._;return n&&(n.currentFrame=t,h(e,{time:n.time,frame:t})),e}function se(e,t,n,r=!0){let i=e._;return i&&(i.uniforms||(i.uniforms={}),i.uniforms[t]=n,r&&h(e,{time:i.time,uniforms:{[t]:n}})),e}function ue(e,t,n=!0){let r=e._;return r&&(r.uniforms||(r.uniforms={}),Object.assign(r.uniforms,t),n&&h(e,{time:r.time,uniforms:t})),e}function fe(e){let t=e._;return!t||!t.ready?Promise.resolve({}):new Promise(n=>{let r=i=>{i.data.type==="uniforms"&&(t.worker.removeEventListener("message",r),n(i.data.uniforms||{}))};t.worker.addEventListener("message",r),t.worker.postMessage({type:"getUniforms"})})}async function ce(e,t={}){let n,r;if(typeof e=="string")if(e.startsWith("#")||e.startsWith(".")&&!e.startsWith("./")&&!e.startsWith("..")){let u=document.querySelector(e);if(!u)throw new Error(`Element not found: ${e}`);if(u instanceof HTMLImageElement)({canvas:n,bytecode:r}=await A(u,t));else throw u instanceof HTMLCanvasElement?(n=u,new Error("Canvas source requires URL or data")):new Error("Invalid element type")}else{if(n=t.canvas,!n)throw new Error("Canvas required for URL source");let u=await fetch(e);if(!u.ok)throw new Error(`Fetch failed: ${u.status}`);r=await P(await u.arrayBuffer())}else if(e instanceof HTMLImageElement)({canvas:n,bytecode:r}=await A(e,t));else if(e instanceof ArrayBuffer||e instanceof Uint8Array||e instanceof Blob){if(n=t.canvas,!n)throw new Error("Canvas required for data source");let c=e instanceof Blob?await e.arrayBuffer():e;r=await P(c)}else throw new Error("Invalid source type");let i=t.dpr??globalThis.devicePixelRatio??1,a=n.width,o=n.height;n.width=Math.round(a*i),n.height=Math.round(o*i);let s=n.transferControlToOffscreen(),f=new Worker(S()),d=await new Promise((c,u)=>{let w=setTimeout(()=>u(new Error("Worker init timeout")),15e3);f.onmessage=l=>{l.data.type==="ready"?(clearTimeout(w),c(l.data)):l.data.type==="error"&&(clearTimeout(w),u(new Error(l.data.message)))},f.onerror=l=>{clearTimeout(w),u(new Error(l.message||"Worker error"))};let U=t.wasmUrl?new URL(t.wasmUrl,window.location.href).href:new URL("pngine.wasm",import.meta.url).href;f.postMessage({type:"init",canvas:s,bytecode:r,wasmUrl:U,debug:t.debug||!1},[s,r.buffer])});return f.onmessage=c=>{c.data.type==="error"&&t.onError&&t.onError(new Error(c.data.message))},X({canvas:n,worker:f,width:a,height:o,frameCount:d.frameCount,animation:d.animation||null,currentScene:null,currentFrame:null,ready:!0,playing:!1,time:0,startTime:0,animationId:null})}async function A(e,t){e.complete||await new Promise((s,f)=>{e.onload=s,e.onerror=f});let{naturalWidth:n,naturalHeight:r}=e;if(n===0||r===0)throw new Error("Image has no dimensions");let i=t.canvas||document.createElement("canvas");if(i.width=n,i.height=r,!t.canvas){let s=e.parentElement;s&&getComputedStyle(s).position==="static"&&(s.style.position="relative"),Object.assign(i.style,{position:"absolute",top:e.offsetTop+"px",left:e.offsetLeft+"px",width:e.offsetWidth+"px",height:e.offsetHeight+"px",pointerEvents:"none"}),s&&s.appendChild(i)}let a=await fetch(e.src);if(!a.ok)throw new Error(`Failed to fetch image: ${a.status}`);let o=await P(await a.arrayBuffer());return{canvas:i,bytecode:o}}function X(e){return{get width(){return e.width},get height(){return e.height},get isPlaying(){return e.playing},get time(){return e.time},get frameCount(){return e.frameCount},get animation(){return e.animation},get currentScene(){return e.currentScene},get currentFrame(){return e.currentFrame},get duration(){return e.animation?e.animation.duration/1e3:0},_:e}}function le(e){let t=e._;return t&&(t.animationId&&cancelAnimationFrame(t.animationId),t.worker.postMessage({type:"destroy"}),t.worker.terminate(),e._=null),e}export{te as createExecutor,le as destroy,D as detectFormat,h as draw,P as extractBytecode,ee as getExecutorImports,ne as getExecutorVariantName,fe as getUniforms,L as isPng,B as isPngb,O as isZip,Q as parsePayload,K as pause,re as play,ce as pngine,ae as seek,oe as setFrame,se as setUniform,ue as setUniforms,ie as stop};
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
|
|
2
|
+
export interface PayloadInfo {
|
|
3
|
+
version: number;
|
|
4
|
+
hasEmbeddedExecutor: boolean;
|
|
5
|
+
hasAnimationTable: boolean;
|
|
6
|
+
plugins: {
|
|
7
|
+
core: boolean;
|
|
8
|
+
render: boolean;
|
|
9
|
+
compute: boolean;
|
|
10
|
+
wasm: boolean;
|
|
11
|
+
animation: boolean;
|
|
12
|
+
texture: boolean;
|
|
13
|
+
};
|
|
14
|
+
executor: Uint8Array | null;
|
|
15
|
+
bytecode: Uint8Array;
|
|
16
|
+
payload: Uint8Array;
|
|
17
|
+
offsets: {
|
|
18
|
+
executor: number;
|
|
19
|
+
executorLength: number;
|
|
20
|
+
bytecode: number;
|
|
21
|
+
bytecodeLength: number;
|
|
22
|
+
stringTable: number;
|
|
23
|
+
data: number;
|
|
24
|
+
wgsl: number;
|
|
25
|
+
uniform: number;
|
|
26
|
+
animation: number;
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export interface ExecutorInstance {
|
|
31
|
+
instance: WebAssembly.Instance;
|
|
32
|
+
memory: WebAssembly.Memory;
|
|
33
|
+
exports: WebAssembly.Exports;
|
|
34
|
+
getBytecodePtr(): number;
|
|
35
|
+
setBytecodeLen(len: number): void;
|
|
36
|
+
getDataPtr(): number;
|
|
37
|
+
setDataLen(len: number): void;
|
|
38
|
+
init(): void;
|
|
39
|
+
frame(time: number, width: number, height: number): void;
|
|
40
|
+
getCommandPtr(): number;
|
|
41
|
+
getCommandLen(): number;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export interface ExecutorCallbacks {
|
|
45
|
+
log?: (ptr: number, len: number) => void;
|
|
46
|
+
wasmInstantiate?: (id: number, ptr: number, len: number) => void;
|
|
47
|
+
wasmCall?: (callId: number, modId: number, namePtr: number, nameLen: number, argsPtr: number, argsLen: number) => void;
|
|
48
|
+
wasmGetResult?: (callId: number, outPtr: number, outLen: number) => number;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export function parsePayload(pngb: Uint8Array): PayloadInfo;
|
|
52
|
+
export function createExecutor(wasmBytes: Uint8Array, imports?: WebAssembly.Imports): Promise<ExecutorInstance>;
|
|
53
|
+
export function getExecutorImports(callbacks?: ExecutorCallbacks): WebAssembly.Imports;
|
|
54
|
+
export function getExecutorVariantName(plugins: PayloadInfo['plugins']): string;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
var P=[80,78,71,66],f=0,d=40,I=1,L=2,N=1,U=2,p=4,_=8,h=16,w=32;function y(t){if(t.length<d)throw new Error("Invalid PNGB: too short");if(!P.every((n,a)=>t[a]===n))throw new Error("Invalid PNGB: bad magic");let e=new DataView(t.buffer,t.byteOffset,t.byteLength),r=e.getUint16(4,!0);if(r!==f)throw new Error(`Unsupported PNGB version: ${r}`);return G(t,e)}function G(t,e){let r=e.getUint16(6,!0),n=t[8],a=e.getUint32(12,!0),o=e.getUint32(16,!0),s=e.getUint32(20,!0),i=e.getUint32(24,!0),x=e.getUint32(28,!0),E=e.getUint32(32,!0),g=e.getUint32(36,!0),c=(r&I)!==0,l=(r&L)!==0,u=c?a+o:d,m=s-u;return{version:f,hasEmbeddedExecutor:c,hasAnimationTable:l,plugins:O(n),executor:c?t.subarray(a,a+o):null,bytecode:t.subarray(u,u+m),payload:t,offsets:{executor:c?a:0,executorLength:o,bytecode:u,bytecodeLength:m,stringTable:s,data:i,wgsl:x,uniform:E,animation:g}}}function O(t){return{core:(t&N)!==0,render:(t&U)!==0,compute:(t&p)!==0,wasm:(t&_)!==0,animation:(t&h)!==0,texture:(t&w)!==0}}function A(t={}){return{env:{log:t.log||((e,r)=>{}),wasmInstantiate:t.wasmInstantiate||((e,r,n)=>{}),wasmCall:t.wasmCall||((e,r,n,a,o,s)=>{}),wasmGetResult:t.wasmGetResult||((e,r,n)=>0)}}}async function D(t,e={}){let{instance:r}=await WebAssembly.instantiate(t,e),n=r.exports,a=n.memory;return{instance:r,memory:a,exports:n,getBytecodePtr(){return n.getBytecodePtr?.()||0},setBytecodeLen(o){n.setBytecodeLen?.(o)},getDataPtr(){return n.getDataPtr?.()||0},setDataLen(o){n.setDataLen?.(o)},init(){n.init?.()},frame(o,s,i){n.frame?.(o,s,i)},getCommandPtr(){return n.getCommandPtr?.()||0},getCommandLen(){return n.getCommandLen?.()||0}}}function B(t){let e=["core"];return t.render&&e.push("render"),t.compute&&e.push("compute"),t.wasm&&e.push("wasm"),t.animation&&e.push("anim"),t.texture&&e.push("texture"),e.join("-")}export{D as createExecutor,A as getExecutorImports,B as getExecutorVariantName,y as parsePayload};
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
|
|
2
|
+
export interface ViewerOptions {
|
|
3
|
+
canvas: HTMLCanvasElement;
|
|
4
|
+
debug?: boolean;
|
|
5
|
+
dpr?: number;
|
|
6
|
+
onError?: (error: Error) => void;
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
export function pngine(
|
|
10
|
+
source: ArrayBuffer | Uint8Array | Blob | string,
|
|
11
|
+
options: ViewerOptions
|
|
12
|
+
): Promise<PngineInstance>;
|
|
13
|
+
|
|
14
|
+
/** Uniform value: number (f32), array (vecNf), or nested array (matNxMf) */
|
|
15
|
+
export type UniformValue = number | number[] | number[][];
|
|
16
|
+
|
|
17
|
+
export interface DrawOptions {
|
|
18
|
+
time?: number;
|
|
19
|
+
frame?: string;
|
|
20
|
+
uniforms?: Record<string, UniformValue>;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export interface PngineInstance {
|
|
24
|
+
readonly width: number;
|
|
25
|
+
readonly height: number;
|
|
26
|
+
readonly frameCount: number;
|
|
27
|
+
readonly isPlaying: boolean;
|
|
28
|
+
readonly time: number;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function destroy(instance: PngineInstance): void;
|
|
32
|
+
export function draw(instance: PngineInstance, options?: DrawOptions): void;
|
|
33
|
+
export function play(instance: PngineInstance): PngineInstance;
|
|
34
|
+
export function pause(instance: PngineInstance): PngineInstance;
|
|
35
|
+
export function stop(instance: PngineInstance): PngineInstance;
|
|
36
|
+
export function seek(instance: PngineInstance, time: number): PngineInstance;
|
|
37
|
+
export function setFrame(instance: PngineInstance, frame: string | null): PngineInstance;
|
|
38
|
+
export function setUniform(instance: PngineInstance, name: string, value: UniformValue, redraw?: boolean): PngineInstance;
|
|
39
|
+
export function setUniforms(instance: PngineInstance, uniforms: Record<string, UniformValue>, redraw?: boolean): PngineInstance;
|
|
40
|
+
export function getUniforms(instance: PngineInstance): Promise<Record<string, { type: number; size: number; bufferId: number; offset: number }>>;
|
|
41
|
+
|
|
42
|
+
export function extractBytecode(data: ArrayBuffer | Uint8Array): Promise<Uint8Array>;
|
|
43
|
+
export function detectFormat(data: ArrayBuffer | Uint8Array): 'png' | 'zip' | 'pngb' | null;
|
|
44
|
+
export function isPng(data: ArrayBuffer | Uint8Array): boolean;
|
|
45
|
+
export function isZip(data: ArrayBuffer | Uint8Array): boolean;
|
|
46
|
+
export function isPngb(data: ArrayBuffer | Uint8Array): boolean;
|
|
47
|
+
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
|
|
2
|
+
const PNG_SIG = [0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A];
|
|
3
|
+
|
|
4
|
+
function isPng(d) {
|
|
5
|
+
const b = d instanceof Uint8Array ? d : new Uint8Array(d);
|
|
6
|
+
return b.length >= 8 && PNG_SIG.every((v, i) => b[i] === v);
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
function isZip(d) {
|
|
10
|
+
const b = d instanceof Uint8Array ? d : new Uint8Array(d);
|
|
11
|
+
return b.length >= 4 && b[0] === 0x50 && b[1] === 0x4B;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
function isPngb(d) {
|
|
15
|
+
const b = d instanceof Uint8Array ? d : new Uint8Array(d);
|
|
16
|
+
return b.length >= 4 && b[0] === 0x50 && b[1] === 0x4E && b[2] === 0x47 && b[3] === 0x42;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
function detectFormat(d) {
|
|
20
|
+
if (isZip(d)) return 'zip';
|
|
21
|
+
if (isPng(d)) return 'png';
|
|
22
|
+
if (isPngb(d)) return 'pngb';
|
|
23
|
+
return null;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
const browserOnly = () => { throw new Error('PNGine requires browser with WebGPU'); };
|
|
27
|
+
|
|
28
|
+
module.exports = {
|
|
29
|
+
pngine: browserOnly,
|
|
30
|
+
destroy: browserOnly,
|
|
31
|
+
draw: browserOnly,
|
|
32
|
+
play: browserOnly,
|
|
33
|
+
pause: browserOnly,
|
|
34
|
+
stop: browserOnly,
|
|
35
|
+
seek: browserOnly,
|
|
36
|
+
setFrame: browserOnly,
|
|
37
|
+
setUniform: browserOnly,
|
|
38
|
+
setUniforms: browserOnly,
|
|
39
|
+
getUniforms: browserOnly,
|
|
40
|
+
extractBytecode: browserOnly,
|
|
41
|
+
isPng,
|
|
42
|
+
isZip,
|
|
43
|
+
isPngb,
|
|
44
|
+
detectFormat,
|
|
45
|
+
};
|
package/dist/index.mjs
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
|
|
2
|
+
export function isPng(d) {
|
|
3
|
+
const b = d instanceof Uint8Array ? d : new Uint8Array(d);
|
|
4
|
+
const s = [0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A];
|
|
5
|
+
return b.length >= 8 && s.every((v, i) => b[i] === v);
|
|
6
|
+
}
|
|
7
|
+
export function isZip(d) {
|
|
8
|
+
const b = d instanceof Uint8Array ? d : new Uint8Array(d);
|
|
9
|
+
return b.length >= 4 && b[0] === 0x50 && b[1] === 0x4B;
|
|
10
|
+
}
|
|
11
|
+
export function isPngb(d) {
|
|
12
|
+
const b = d instanceof Uint8Array ? d : new Uint8Array(d);
|
|
13
|
+
return b.length >= 4 && b[0] === 0x50 && b[1] === 0x4E && b[2] === 0x47 && b[3] === 0x42;
|
|
14
|
+
}
|
|
15
|
+
export function detectFormat(d) {
|
|
16
|
+
if (isZip(d)) return 'zip';
|
|
17
|
+
if (isPng(d)) return 'png';
|
|
18
|
+
if (isPngb(d)) return 'pngb';
|
|
19
|
+
return null;
|
|
20
|
+
}
|
|
21
|
+
const browserOnly = () => { throw new Error('PNGine requires browser with WebGPU'); };
|
|
22
|
+
export const pngine = browserOnly;
|
|
23
|
+
export const destroy = browserOnly;
|
|
24
|
+
export const draw = browserOnly;
|
|
25
|
+
export const play = browserOnly;
|
|
26
|
+
export const pause = browserOnly;
|
|
27
|
+
export const stop = browserOnly;
|
|
28
|
+
export const seek = browserOnly;
|
|
29
|
+
export const setFrame = browserOnly;
|
|
30
|
+
export const setUniform = browserOnly;
|
|
31
|
+
export const setUniforms = browserOnly;
|
|
32
|
+
export const getUniforms = browserOnly;
|
|
33
|
+
export const extractBytecode = browserOnly;
|