pngine 1.0.5 → 1.0.7

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 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,4 @@
1
+ function Y(f,n,t,e){switch(f){case 1:return e.createBuffer(n.getUint16(t,!0),n.getUint32(t+2,!0),n.getUint8(t+6)),t+7;case 2:return e.createTexture(n.getUint16(t,!0),n.getUint32(t+2,!0),n.getUint32(t+6,!0)),t+10;case 3:return e.createSampler(n.getUint16(t,!0),n.getUint32(t+2,!0),n.getUint32(t+6,!0)),t+10;case 4:return e.createShader(n.getUint16(t,!0),n.getUint32(t+2,!0),n.getUint32(t+6,!0)),t+10;case 5:return e.createRenderPipeline(n.getUint16(t,!0),n.getUint32(t+2,!0),n.getUint32(t+6,!0)),t+10;case 6:return e.createComputePipeline(n.getUint16(t,!0),n.getUint32(t+2,!0),n.getUint32(t+6,!0)),t+10;case 7:return e.createBindGroup(n.getUint16(t,!0),n.getUint16(t+2,!0),n.getUint32(t+4,!0),n.getUint32(t+8,!0)),t+12;case 8:{let m=n.getUint16(t,!0),c=n.getUint16(t+2,!0);return!e.txv[m]&&e.tex[c]&&(e.txv[m]=e.tex[c].createView()),t+12}case 9:return t+10;case 10:{let m=n.getUint16(t,!0),c=n.getUint32(t+2,!0),U=n.getUint32(t+6,!0);return e.bgl[m]||(e.bgl[m]=e.device.createBindGroupLayout(JSON.parse(e.rs(c,U)))),t+10}case 11:{let m=n.getUint16(t,!0),c=n.getUint32(t+2,!0),U=n.getUint32(t+6,!0);if(U===0)return t+10;let A=new Blob([new Uint8Array(e.mem.buffer,c,U)]);return createImageBitmap(A).then(l=>(e.bmp[m]=l,t+10))}case 12:{let m=n.getUint16(t,!0),c=n.getUint32(t+2,!0),U=n.getUint32(t+6,!0),A=JSON.parse(e.rs(c,U));return e.ppl[m]=e.device.createPipelineLayout({bindGroupLayouts:A.bindGroupLayouts.map(l=>e.bgl[l])}),t+10}case 13:return t+10;case 16:return e.beginRenderPass(n.getUint16(t,!0),n.getUint8(t+2),n.getUint8(t+3),n.getUint16(t+4,!0)),t+6;case 17:return e.beginComputePass(),t;case 18:{let m=n.getUint16(t,!0);return e.log(`[GPU] setPipeline(${m})`),e.getPass()?.setPipeline(e.pip[m]),t+2}case 19:{let m=n.getUint8(t),c=n.getUint16(t+1,!0);return e.log(`[GPU] setBindGroup(${m}, ${c}) pass=${e.getPass()?"valid":"NULL"} bg[${c}]=${e.bg[c]?"exists":"MISSING"}`),e.getPass()?.setBindGroup(m,e.bg[c]),t+3}case 20:return e.getPass()?.setVertexBuffer(n.getUint8(t),e.buf[n.getUint16(t+1,!0)]),t+3;case 21:{let m=n.getUint32(t,!0),c=n.getUint32(t+4,!0);return e.log(`[GPU] draw(${m}, ${c}) pass=${e.getPass()?"valid":"NULL"}`),e.getPass()?.draw(m,c,n.getUint32(t+8,!0),n.getUint32(t+12,!0)),t+16}case 22:return e.getPass()?.drawIndexed(n.getUint32(t,!0),n.getUint32(t+4,!0),n.getUint32(t+8,!0),n.getInt32(t+12,!0),n.getUint32(t+16,!0)),t+20;case 23:return e.log("[GPU] endPass"),e.getPass()?.end(),e.setPass(null),t;case 24:return e.getPass()?.dispatchWorkgroups(n.getUint32(t,!0),n.getUint32(t+4,!0),n.getUint32(t+8,!0)),t+12;case 25:return e.getPass()?.setIndexBuffer(e.buf[n.getUint16(t,!0)],n.getUint8(t+2)===1?"uint32":"uint16"),t+3;case 26:{let m=n.getUint8(t);return t+1+m*2}default:return null}}var x=!0,bt={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"},xt=f=>bt[f]??navigator.gpu.getPreferredCanvasFormat(),q=["nearest","linear"],Z=f=>q[f]??"linear",p=["clamp-to-edge","repeat","mirror-repeat"],K=f=>p[f]??"clamp-to-edge",ht=0,$t=1,Pt=2,yt=3,Gt=4,Tt=5,At=6,Ct=7,_t=8,St=9,Mt=10,Et=11,Lt=12,Ft=13;var Bt=1111969360;function Dt(f){let n=new DataView(f.buffer,f.byteOffset,f.byteLength);if(n.getUint32(0,!0)!==Bt)return{uniforms:new Map,strings:[]};let t=n.getUint32(20,!0),e=n.getUint32(32,!0),m=Vt(f,t),c=new Map;if(e===0||e>=f.length)return{uniforms:c,strings:m};let U=e,A=n.getUint16(U,!0);U+=2;for(let l=0;l<A&&U+8<=f.length;l++){let P=n.getUint16(U,!0);U+=2,U+=4;let G=n.getUint16(U,!0);U+=2;for(let E=0;E<G&&U+10<=f.length;E++){U+=2;let _=n.getUint16(U,!0);U+=2;let S=n.getUint16(U,!0);U+=2;let M=n.getUint16(U,!0);U+=2;let B=n.getUint8(U);U+=2;let D=m[_]||`field_${_}`;c.set(D,{bufferId:P,offset:S,size:M,type:B})}}return{uniforms:c,strings:m}}function Vt(f,n){if(n===0||n>=f.length-2)return[];let t=new DataView(f.buffer,f.byteOffset,f.byteLength),e=new TextDecoder,m=[],c=t.getUint16(n,!0);if(c===0)return m;let U=n+2,A=U+c*2,l=A+c*2;if(l>f.length)return m;for(let P=0;P<c;P++){let G=t.getUint16(U+P*2,!0),E=t.getUint16(A+P*2,!0),_=l+G;_+E<=f.length?m.push(e.decode(f.subarray(_,_+E))):m.push(`string_${P}`)}return m}function Q(f,n){let t=null,e=0,m=0,c=0,U=null,A=null,l=!1,P=[],G=[],E=[],_=[],S=[],M=[],B=[],D=[],W=[],O=[],I=[],R=[],j=[],J=[];function N(a,s){return s===0?"":new TextDecoder().decode(new Uint8Array(t.buffer,a,s))}let v=xt;function tt(a,s,r){P[a]||(x&&l&&console.log(`[GPU] createBuffer(${a}, ${s}, 0x${r.toString(16)})`),P[a]=f.createBuffer({size:s,usage:r||GPUBufferUsage.COPY_DST}))}function et(a,s,r){if(S[a])return;if(x&&l&&console.log(`[GPU] createShader(${a}, ${r}b)`),r===0){x&&l&&console.warn(`[GPU] createShader(${a}) skipped: len=0`);return}let g=N(s,r);x&&l&&console.log(`[GPU] code:
2
+ ${g}`);let i=f.createShaderModule({code:g});i.getCompilationInfo().then(o=>{for(let u of o.messages)u.type==="error"&&(console.error(`[GPU] Shader ${a} error at line ${u.lineNum}:${u.linePos}: ${u.message}`),console.error(`[GPU] Context: ${g.split(`
3
+ `).slice(Math.max(0,u.lineNum-3),u.lineNum+2).join(`
4
+ `)}`))}),S[a]=i}function rt(a,s,r){if(M[a])return;if(r===0){x&&l&&console.warn(`[GPU] createRenderPipeline(${a}) skipped: len=0`);return}let g=JSON.parse(N(s,r)),i=navigator.gpu.getPreferredCanvasFormat();x&&l&&console.log(`[GPU] createRenderPipeline(${a}) desc=`,JSON.stringify(g));let o=g.fragment?.targetFormat;(!o||o==="preferredCanvasFormat")&&(o=i),x&&l&&console.log(`[GPU] targetFormat: ${o}`);let u=[{format:o}],d=f.createRenderPipeline({layout:"auto",vertex:{module:S[g.vertex?.shader??0],entryPoint:g.vertex?.entryPoint??"vs_main",buffers:g.vertex?.buffers??[]},fragment:{module:S[g.fragment?.shader??g.vertex?.shader??0],entryPoint:g.fragment?.entryPoint??"fs_main",targets:u},primitive:g.primitive??{topology:"triangle-list"},depthStencil:g.depthStencil});M[a]=d,D[a]=d.getBindGroupLayout(0)}function nt(a,s,r){if(M[a])return;if(r<4){x&&l&&console.warn(`[GPU] createComputePipeline(${a}) skipped: len=${r}`);return}let g=new Uint8Array(t.buffer,s,r),o=new DataView(g.buffer,g.byteOffset,g.byteLength).getUint16(1,!0),u=g[3],d=u>0?new TextDecoder().decode(g.slice(4,4+u)):"main";x&&l&&console.log(`[GPU] createComputePipeline(${a}) shader=${o} entry=${d}`);let b=f.createComputePipeline({layout:"auto",compute:{module:S[o]??S[0],entryPoint:d}});M[a]=b,D[a]=b.getBindGroupLayout(0)}function at(a,s,r){if(G[a])return;if(r===0){x&&l&&console.warn(`[GPU] createTexture(${a}) skipped: len=0`);return}let g=new Uint8Array(t.buffer,s,r),i=new DataView(g.buffer,g.byteOffset,g.byteLength),o=2,u={size:[m||512,c||512],format:navigator.gpu.getPreferredCanvasFormat(),usage:GPUTextureUsage.RENDER_ATTACHMENT,sampleCount:1},d=g[1];for(let b=0;b<d;b++){let h=g[o++],y=g[o++];if(y===0){let C=i.getUint32(o,!0);o+=4,h===1?u.size[0]=C:h===2?u.size[1]=C:h===5&&(u.sampleCount=C)}else if(y===7){let C=g[o++];h===7?u.format=v(C):h===8&&(u.usage=C||GPUTextureUsage.RENDER_ATTACHMENT)}}J[a]={format:u.format,usage:u.usage},x&&l&&console.log(`[GPU] createTexture(${a}) ${u.size[0]}x${u.size[1]} ${u.format} usage=0x${u.usage.toString(16)}`),G[a]=f.createTexture(u)}function st(a,s,r){if(_[a])return;if(r===0){x&&l&&console.warn(`[GPU] createSampler(${a}) skipped: len=0`);return}let g=new Uint8Array(t.buffer,s,r),i=2,o={magFilter:q[1],minFilter:q[1],addressModeU:p[0],addressModeV:p[0]},u=g[1];for(let d=0;d<u;d++){let b=g[i++];if(g[i++]===7){let y=g[i++];b===4?o.magFilter=Z(y):b===5?o.minFilter=Z(y):b===1?o.addressModeU=K(y):b===2&&(o.addressModeV=K(y))}}x&&l&&console.log(`[GPU] createSampler(${a}) ${o.magFilter}/${o.minFilter}`),_[a]=f.createSampler(o)}function ut(a,s,r,g){if(B[a])return;if(g===0){x&&l&&console.warn(`[GPU] createBindGroup(${a}) skipped: len=0`);return}let i=new Uint8Array(t.buffer,r,g),o=new DataView(i.buffer,i.byteOffset,i.byteLength),u=2,d=0,b=[],h=i[1];for(let $=0;$<h;$++){let T=i[u++],V=i[u++];if(T===1&&V===7)d=i[u++];else if(T===2&&V===3){let F=i[u++];for(let L=0;L<F;L++){let w=i[u++],X=i[u++],dt=o.getUint16(u,!0);u+=2;let k={binding:w,rt:X,rid:dt};X===0&&(k.offset=o.getUint32(u,!0),u+=4,k.size=o.getUint32(u,!0),u+=4),b.push(k)}}}j[a]={layoutId:s,gi:d,entries:b},x&&l&&console.log(`[GPU] createBindGroup(${a}) layoutId=${s} entries=[${b.map($=>`{b=${$.binding} rt=${$.rt} rid=${$.rid}}`).join(",")}]`);let y=M[s];if(!y)return;let C=b.map($=>{let T={binding:$.binding};return $.rt===0?(T.resource={buffer:P[$.rid]},$.offset&&(T.resource.offset=$.offset),$.size&&(T.resource.size=$.size)):$.rt===1?(T.resource=G[$.rid]?.createView(),x&&l&&console.log(`[GPU] bindGroup entry b=${$.binding}: tex[${$.rid}]=${G[$.rid]?"exists":"MISSING"} view=${T.resource?"valid":"NULL"}`)):$.rt===2&&(T.resource=_[$.rid]),T});B[a]=f.createBindGroup({layout:y.getBindGroupLayout(d),entries:C})}function it(a,s,r,g){U||(U=f.createCommandEncoder());let i=65534,o;if(a===i){let d=n.getCurrentTexture();x&&l&&console.log(`[GPU] canvasTex: ${d?.width}x${d?.height} ${d?.format}`),o=d.createView()}else o=G[a]?.createView();x&&l&&console.log(`[GPU] beginRenderPass colorId=${a===i?"CANVAS":a} loadOp=${s} storeOp=${r} depthId=${g}`),x&&l&&console.log(`[GPU] tex[${a}]=${G[a]?"exists":"MISSING"} view=${o?"valid":"NULL"}`);let u={colorAttachments:[{view:o,loadOp:s===1?"clear":"load",storeOp:r===0?"store":"discard",clearValue:{r:0,g:0,b:0,a:0}}]};g!==65535&&G[g]&&(u.depthStencilAttachment={view:G[g].createView(),depthLoadOp:"clear",depthStoreOp:"store",depthClearValue:1}),A=U.beginRenderPass(u)}function ot(){U||(U=f.createCommandEncoder()),A=U.beginComputePass()}let ct={createBuffer:tt,createTexture:at,createSampler:st,createShader:et,createRenderPipeline:rt,createComputePipeline:nt,createBindGroup:ut,txv:E,tex:G,bgl:D,device:f,rs:N,get mem(){return t},bmp:O,ppl:W,beginRenderPass:it,beginComputePass:ot,getPass:()=>A,setPass:a=>{A=a},pip:M,bg:B,buf:P,log:a=>{x&&l&&console.log(a)}};function ft(a,s,r){let g=Y(a,s,r,ct);if(g!==null)return g;switch(a){case 32:{let i=s.getUint16(r,!0),o=s.getUint32(r+2,!0),u=s.getUint32(r+6,!0),d=s.getUint32(r+10,!0);return x&&l&&console.log(`[GPU] write_buffer: id=${i}, offset=${o}, dataPtr=${u}, dataLen=${d}`),P[i]&&d>0&&f.queue.writeBuffer(P[i],o,new Uint8Array(t.buffer,u,d)),r+14}case 33:{let i=s.getUint16(r,!0),o=s.getUint32(r+2,!0),u=s.getUint16(r+6,!0);if(x&&l&&console.log(`[GPU] writeTimeUniform buf[${i}] time=${e} cw=${m} ch=${c}`),P[i]){let d=new Float32Array([e,m,c,m/(c||1)]);f.queue.writeBuffer(P[i],o,new Uint8Array(d.buffer,0,Math.min(u,16)))}return r+8}case 34:{let i=s.getUint16(r,!0),o=s.getUint32(r+2,!0),u=s.getUint16(r+6,!0),d=s.getUint32(r+8,!0),b=s.getUint32(r+12,!0);return U||(U=f.createCommandEncoder()),U.copyBufferToBuffer(P[i],o,P[u],d,b),r+16}case 35:{let i=s.getUint16(r,!0),o=s.getUint16(r+2,!0),u=s.getUint16(r+4,!0),d=s.getUint16(r+6,!0);return U||(U=f.createCommandEncoder()),U.copyTextureToTexture({texture:G[i]},{texture:G[o]},[u,d]),r+8}case 36:{let i=s.getUint16(r,!0),o=s.getUint32(r+2,!0),u=s.getUint32(r+6,!0),d=s.getUint32(r+10,!0),b=R[u];if(x&&l&&console.log(`[GPU] write_buffer_from_wasm: bid=${i}, off=${o}, callId=${u}, sz=${d}, cr=`,b),P[i]&&b&&d>0){let h=I[b.mid],y=h?.inst?.exports?.memory?.buffer||h?.importedMem?.buffer;x&&l&&console.log(`[GPU] write_buffer_from_wasm: mod=${!!h}, wasmMem=${!!y}, result=${b.result}, memSize=${y?.byteLength}`),y&&b.result!=null&&b.result+d<=y.byteLength?f.queue.writeBuffer(P[i],o,new Uint8Array(y,b.result,d)):x&&l&&console.warn(`[GPU] write_buffer_from_wasm: invalid params - result=${b.result}, sz=${d}, memSize=${y?.byteLength}`)}return r+14}case 37:{let i=s.getUint16(r,!0),o=s.getUint16(r+2,!0),u=s.getUint8(r+4),d=s.getUint16(r+5,!0),b=s.getUint16(r+7,!0),h=O[i];return h&&G[o]&&f.queue.copyExternalImageToTexture({source:h},{texture:G[o],mipLevel:u,origin:[d,b]},[h.width,h.height]),r+9}case 48:{let i=s.getUint16(r,!0),o=s.getUint32(r+2,!0),u=s.getUint32(r+6,!0);if(x&&l&&console.log(`[GPU] init_wasm_module: id=${i}, ptr=${o}, len=${u}`),u===0)return r+10;let d=new Uint8Array(t.buffer,o,u).slice(),b=new WebAssembly.Memory({initial:1}),h={env:{abort:()=>{throw new Error("WASM abort")},memory:b}};return WebAssembly.compile(d).then(y=>WebAssembly.instantiate(y,h).then(C=>(I[i]={inst:C,importedMem:b},x&&l&&console.log(`[GPU] init_wasm_module done: id=${i}, exports=`,Object.keys(C.exports)),r+10)))}case 49:{let i=s.getUint16(r,!0),o=s.getUint16(r+2,!0),u=s.getUint32(r+4,!0),d=s.getUint32(r+8,!0),b=s.getUint8(r+12),h=new Uint8Array(t.buffer,r+13,b).slice(),y=N(u,d);x&&l&&console.log(`[GPU] call_wasm_func: cid=${i}, mid=${o}, name="${y}", ac=${b}`);let{inst:C}=I[o]||{},$=C?.exports[y],T=[],V=new DataView(h.buffer,h.byteOffset,h.byteLength);for(let F=0,L=0;F<b/5|0;F++){let w=h[L++];w===0?T.push(V.getFloat32(L,!0)):w===1?T.push(V.getInt32(L,!0)):w===2&&T.push(V.getUint32(L,!0)),L+=4}if($){let F=$(...T);R[i]={mid:o,result:F},x&&l&&console.log(`[GPU] call_wasm_func result: cid=${i}, result=${F}`)}else x&&l&&console.log(`[GPU] call_wasm_func: fn not found! mid=${o}, name="${y}"`);return r+13+b}case 240:return x&&l&&console.log(`[GPU] submit enc=${!!U}`),U&&(f.queue.submit([U.finish()]),U=null),r;case 255:return r;default:return x&&console.warn(`Unknown cmd: 0x${a.toString(16)}`),r}}async function gt(a){let s=new DataView(t.buffer),r=s.getUint32(a,!0),g=s.getUint16(a+4,!0);x&&l&&console.log(`[GPU] Execute: ${g} cmds, ${r}b`);let i=a+8,o=a+r;for(let u=0;u<g&&i<o;u++){let d=s.getUint8(i++),b=ft(d,s,i);b instanceof Promise?(i=await b,s=new DataView(t.buffer)):i=b}}function lt(){P.forEach(a=>a?.destroy?.()),G.forEach(a=>a?.destroy?.()),P.length=G.length=E.length=_.length=S.length=M.length=0,B.length=D.length=W.length=O.length=I.length=0,R.length=j.length=J.length=0}let z=null;function Ut(a){z=a,x&&l&&console.log(`[GPU] setUniformTable: ${a.size} uniforms`)}function H(a,s){if(!z)return!1;let r=z.get(a);if(!r)return x&&l&&console.warn(`[GPU] setUniform: unknown uniform '${a}'`),!1;let g=P[r.bufferId];if(!g)return x&&l&&console.warn(`[GPU] setUniform: buffer ${r.bufferId} not found`),!1;let i=wt(s,r.type,r.size);return i?(f.queue.writeBuffer(g,r.offset,i),x&&l&&console.log(`[GPU] setUniform: ${a} = ${Array.isArray(s)?`[${s.join(",")}]`:s} @ buffer[${r.bufferId}]+${r.offset}`),!0):(x&&l&&console.warn(`[GPU] setUniform: failed to convert value for '${a}'`),!1)}function mt(a){let s=0;for(let[r,g]of Object.entries(a))H(r,g)&&s++;return s}return{setDebug(a){l=a},setMemory(a){t=a},setTime(a){e=a},setCanvasSize(a,s){m=a,c=s},setUniformTable:Ut,setUniform:H,setUniforms:mt,execute:gt,destroy:lt}}function wt(f,n,t){let e=Array.isArray(f)?f:[f];switch(n){case ht:case yt:case Gt:case Tt:{let c=new Float32Array(e);return new Uint8Array(c.buffer,0,Math.min(c.byteLength,t))}case $t:case _t:case St:case Mt:{let c=new Int32Array(e);return new Uint8Array(c.buffer,0,Math.min(c.byteLength,t))}case Pt:case Et:case Lt:case Ft:{let c=new Uint32Array(e);return new Uint8Array(c.buffer,0,Math.min(c.byteLength,t))}case At:{let c=new Float32Array(12);return e.length>=9&&(c[0]=e[0],c[1]=e[3],c[2]=e[6],c[3]=0,c[4]=e[1],c[5]=e[4],c[6]=e[7],c[7]=0,c[8]=e[2],c[9]=e[5],c[10]=e[8],c[11]=0),new Uint8Array(c.buffer,0,Math.min(48,t))}case Ct:{let c=new Float32Array(e.length>=16?e:[...e,...Array(16-e.length).fill(0)]);return new Uint8Array(c.buffer,0,Math.min(64,t))}default:let m=new Float32Array(e);return new Uint8Array(m.buffer,0,Math.min(m.byteLength,t))}}function zt(f,n){let t=Q(f,n);return{setMemory(e){t.setMemory(e)},execute(e){t.execute(e)},setUniform(e,m){return t.setUniform(e,m)},setUniforms(e){return t.setUniforms(e)},setUniformTable(e){t.setUniformTable(e)},destroy(){t.destroy()},setDebug(e){t.setDebug(e)},setTime(e){t.setTime(e)},setCanvasSize(e,m){t.setCanvasSize(e,m)},_dispatcher:t}}async function kt(f){if(!navigator.gpu)throw new Error("WebGPU not supported");let n=f||await navigator.gpu.requestAdapter();if(!n)throw new Error("No GPU adapter found");return n.requestDevice()}function qt(f,n){let t=f.getContext("webgpu");if(!t)throw new Error("Failed to get WebGPU context");return t.configure({device:n,format:navigator.gpu.getPreferredCanvasFormat(),alphaMode:"premultiplied"}),t}export{qt as configureCanvas,Q as createCommandDispatcher,zt as createCoreDispatcher,kt as getDevice,Dt as parseUniformTable};
package/dist/dev.d.ts ADDED
@@ -0,0 +1,101 @@
1
+
2
+ export interface DevOptions {
3
+ canvas?: HTMLCanvasElement;
4
+ debug?: boolean;
5
+ wasmUrl?: string | URL;
6
+ onError?: (error: Error) => void;
7
+ }
8
+
9
+ export function pngine(
10
+ source: ArrayBuffer | Uint8Array | Blob | string | HTMLImageElement,
11
+ options?: DevOptions
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
+
48
+
49
+ export interface PayloadInfo {
50
+ version: number;
51
+ hasEmbeddedExecutor: boolean;
52
+ hasAnimationTable: boolean;
53
+ plugins: {
54
+ core: boolean;
55
+ render: boolean;
56
+ compute: boolean;
57
+ wasm: boolean;
58
+ animation: boolean;
59
+ texture: boolean;
60
+ };
61
+ executor: Uint8Array | null;
62
+ bytecode: Uint8Array;
63
+ payload: Uint8Array;
64
+ offsets: {
65
+ executor: number;
66
+ executorLength: number;
67
+ bytecode: number;
68
+ bytecodeLength: number;
69
+ stringTable: number;
70
+ data: number;
71
+ wgsl: number;
72
+ uniform: number;
73
+ animation: number;
74
+ };
75
+ }
76
+
77
+ export interface ExecutorInstance {
78
+ instance: WebAssembly.Instance;
79
+ memory: WebAssembly.Memory;
80
+ exports: WebAssembly.Exports;
81
+ getBytecodePtr(): number;
82
+ setBytecodeLen(len: number): void;
83
+ getDataPtr(): number;
84
+ setDataLen(len: number): void;
85
+ init(): void;
86
+ frame(time: number, width: number, height: number): void;
87
+ getCommandPtr(): number;
88
+ getCommandLen(): number;
89
+ }
90
+
91
+ export interface ExecutorCallbacks {
92
+ log?: (ptr: number, len: number) => void;
93
+ wasmInstantiate?: (id: number, ptr: number, len: number) => void;
94
+ wasmCall?: (callId: number, modId: number, namePtr: number, nameLen: number, argsPtr: number, argsLen: number) => void;
95
+ wasmGetResult?: (callId: number, outPtr: number, outLen: number) => number;
96
+ }
97
+
98
+ export function parsePayload(pngb: Uint8Array): PayloadInfo;
99
+ export function createExecutor(wasmBytes: Uint8Array, imports?: WebAssembly.Imports): Promise<ExecutorInstance>;
100
+ export function getExecutorImports(callbacks?: ExecutorCallbacks): WebAssembly.Imports;
101
+ export function getExecutorVariantName(plugins: PayloadInfo['plugins']): string;
package/dist/dev.mjs ADDED
@@ -0,0 +1 @@
1
+ var S='function ce(t,r,e,n){switch(t){case 1:return n.createBuffer(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint8(e+6)),e+7;case 2:return n.createTexture(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 3:return n.createSampler(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 4:return n.createShader(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 5:return n.createRenderPipeline(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 6:return n.createComputePipeline(r.getUint16(e,!0),r.getUint32(e+2,!0),r.getUint32(e+6,!0)),e+10;case 7:return n.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 f=r.getUint16(e,!0),a=r.getUint16(e+2,!0);return!n.txv[f]&&n.tex[a]&&(n.txv[f]=n.tex[a].createView()),e+12}case 9:return e+10;case 10:{let f=r.getUint16(e,!0),a=r.getUint32(e+2,!0),g=r.getUint32(e+6,!0);return n.bgl[f]||(n.bgl[f]=n.device.createBindGroupLayout(JSON.parse(n.rs(a,g)))),e+10}case 11:{let f=r.getUint16(e,!0),a=r.getUint32(e+2,!0),g=r.getUint32(e+6,!0);if(g===0)return e+10;let G=new Blob([new Uint8Array(n.mem.buffer,a,g)]);return createImageBitmap(G).then(m=>(n.bmp[f]=m,e+10))}case 12:{let f=r.getUint16(e,!0),a=r.getUint32(e+2,!0),g=r.getUint32(e+6,!0),G=JSON.parse(n.rs(a,g));return n.ppl[f]=n.device.createPipelineLayout({bindGroupLayouts:G.bindGroupLayouts.map(m=>n.bgl[m])}),e+10}case 13:return e+10;case 16:return n.beginRenderPass(r.getUint16(e,!0),r.getUint8(e+2),r.getUint8(e+3),r.getUint16(e+4,!0)),e+6;case 17:return n.beginComputePass(),e;case 18:{let f=r.getUint16(e,!0);return n.log(`[GPU] setPipeline(${f})`),n.getPass()?.setPipeline(n.pip[f]),e+2}case 19:{let f=r.getUint8(e),a=r.getUint16(e+1,!0);return n.log(`[GPU] setBindGroup(${f}, ${a}) pass=${n.getPass()?"valid":"NULL"} bg[${a}]=${n.bg[a]?"exists":"MISSING"}`),n.getPass()?.setBindGroup(f,n.bg[a]),e+3}case 20:return n.getPass()?.setVertexBuffer(r.getUint8(e),n.buf[r.getUint16(e+1,!0)]),e+3;case 21:{let f=r.getUint32(e,!0),a=r.getUint32(e+4,!0);return n.log(`[GPU] draw(${f}, ${a}) pass=${n.getPass()?"valid":"NULL"}`),n.getPass()?.draw(f,a,r.getUint32(e+8,!0),r.getUint32(e+12,!0)),e+16}case 22:return n.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 n.log("[GPU] endPass"),n.getPass()?.end(),n.setPass(null),e;case 24:return n.getPass()?.dispatchWorkgroups(r.getUint32(e,!0),r.getUint32(e+4,!0),r.getUint32(e+8,!0)),e+12;case 25:return n.getPass()?.setIndexBuffer(n.buf[r.getUint16(e,!0)],r.getUint8(e+2)===1?"uint32":"uint16"),e+3;case 26:{let f=r.getUint8(e);return e+1+f*2}default:return null}}var b=!0,Oe={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"},Re=t=>Oe[t]??navigator.gpu.getPreferredCanvasFormat(),v=["nearest","linear"],fe=t=>v[t]??"linear",ee=["clamp-to-edge","repeat","mirror-repeat"],le=t=>ee[t]??"clamp-to-edge",pe=0,Be=1,Fe=2,Ve=3,ze=4,ke=5,We=6,je=7,qe=8,He=9,Ye=10,Xe=11,Je=12,Ze=13;var Ke=1111969360;function ge(t){let r=new DataView(t.buffer,t.byteOffset,t.byteLength);if(r.getUint32(0,!0)!==Ke)return{uniforms:new Map,strings:[]};let e=r.getUint32(20,!0),n=r.getUint32(32,!0),f=Qe(t,e),a=new Map;if(n===0||n>=t.length)return{uniforms:a,strings:f};let g=n,G=r.getUint16(g,!0);g+=2;for(let m=0;m<G&&g+8<=t.length;m++){let h=r.getUint16(g,!0);g+=2,g+=4;let E=r.getUint16(g,!0);g+=2;for(let _=0;_<E&&g+10<=t.length;_++){g+=2;let C=r.getUint16(g,!0);g+=2;let T=r.getUint16(g,!0);g+=2;let S=r.getUint16(g,!0);g+=2;let F=r.getUint8(g);g+=2;let V=f[C]||`field_${C}`;a.set(V,{bufferId:h,offset:T,size:S,type:F})}}return{uniforms:a,strings:f}}function Qe(t,r){if(r===0||r>=t.length-2)return[];let e=new DataView(t.buffer,t.byteOffset,t.byteLength),n=new TextDecoder,f=[],a=e.getUint16(r,!0);if(a===0)return f;let g=r+2,G=g+a*2,m=G+a*2;if(m>t.length)return f;for(let h=0;h<a;h++){let E=e.getUint16(g+h*2,!0),_=e.getUint16(G+h*2,!0),C=m+E;C+_<=t.length?f.push(n.decode(t.subarray(C,C+_))):f.push(`string_${h}`)}return f}function te(t,r){let e=null,n=0,f=0,a=0,g=null,G=null,m=!1,h=[],E=[],_=[],C=[],T=[],S=[],F=[],V=[],oe=[],J=[],H=[],Z=[],se=[],ae=[];function Y(s,i){return i===0?"":new TextDecoder().decode(new Uint8Array(e.buffer,s,i))}let he=Re;function ye(s,i,o){h[s]||(b&&m&&console.log(`[GPU] createBuffer(${s}, ${i}, 0x${o.toString(16)})`),h[s]=t.createBuffer({size:i,usage:o||GPUBufferUsage.COPY_DST}))}function Pe(s,i,o){if(T[s])return;if(b&&m&&console.log(`[GPU] createShader(${s}, ${o}b)`),o===0){b&&m&&console.warn(`[GPU] createShader(${s}) skipped: len=0`);return}let d=Y(i,o);b&&m&&console.log(`[GPU] code:\n${d}`);let c=t.createShaderModule({code:d});c.getCompilationInfo().then(l=>{for(let u of l.messages)u.type==="error"&&(console.error(`[GPU] Shader ${s} error at line ${u.lineNum}:${u.linePos}: ${u.message}`),console.error(`[GPU] Context: ${d.split(`\n`).slice(Math.max(0,u.lineNum-3),u.lineNum+2).join(`\n`)}`))}),T[s]=c}function $e(s,i,o){if(S[s])return;if(o===0){b&&m&&console.warn(`[GPU] createRenderPipeline(${s}) skipped: len=0`);return}let d=JSON.parse(Y(i,o)),c=navigator.gpu.getPreferredCanvasFormat();b&&m&&console.log(`[GPU] createRenderPipeline(${s}) desc=`,JSON.stringify(d));let l=d.fragment?.targetFormat;(!l||l==="preferredCanvasFormat")&&(l=c),b&&m&&console.log(`[GPU] targetFormat: ${l}`);let u=[{format:l}],U=t.createRenderPipeline({layout:"auto",vertex:{module:T[d.vertex?.shader??0],entryPoint:d.vertex?.entryPoint??"vs_main",buffers:d.vertex?.buffers??[]},fragment:{module:T[d.fragment?.shader??d.vertex?.shader??0],entryPoint:d.fragment?.entryPoint??"fs_main",targets:u},primitive:d.primitive??{topology:"triangle-list"},depthStencil:d.depthStencil});S[s]=U,V[s]=U.getBindGroupLayout(0)}function Ee(s,i,o){if(S[s])return;if(o<4){b&&m&&console.warn(`[GPU] createComputePipeline(${s}) skipped: len=${o}`);return}let d=new Uint8Array(e.buffer,i,o),l=new DataView(d.buffer,d.byteOffset,d.byteLength).getUint16(1,!0),u=d[3],U=u>0?new TextDecoder().decode(d.slice(4,4+u)):"main";b&&m&&console.log(`[GPU] createComputePipeline(${s}) shader=${l} entry=${U}`);let x=t.createComputePipeline({layout:"auto",compute:{module:T[l]??T[0],entryPoint:U}});S[s]=x,V[s]=x.getBindGroupLayout(0)}function Ae(s,i,o){if(E[s])return;if(o===0){b&&m&&console.warn(`[GPU] createTexture(${s}) skipped: len=0`);return}let d=new Uint8Array(e.buffer,i,o),c=new DataView(d.buffer,d.byteOffset,d.byteLength),l=2,u={size:[f||512,a||512],format:navigator.gpu.getPreferredCanvasFormat(),usage:GPUTextureUsage.RENDER_ATTACHMENT,sampleCount:1},U=d[1];for(let x=0;x<U;x++){let y=d[l++],$=d[l++];if($===0){let L=c.getUint32(l,!0);l+=4,y===1?u.size[0]=L:y===2?u.size[1]=L:y===5&&(u.sampleCount=L)}else if($===7){let L=d[l++];y===7?u.format=he(L):y===8&&(u.usage=L||GPUTextureUsage.RENDER_ATTACHMENT)}}ae[s]={format:u.format,usage:u.usage},b&&m&&console.log(`[GPU] createTexture(${s}) ${u.size[0]}x${u.size[1]} ${u.format} usage=0x${u.usage.toString(16)}`),E[s]=t.createTexture(u)}function Ge(s,i,o){if(C[s])return;if(o===0){b&&m&&console.warn(`[GPU] createSampler(${s}) skipped: len=0`);return}let d=new Uint8Array(e.buffer,i,o),c=2,l={magFilter:v[1],minFilter:v[1],addressModeU:ee[0],addressModeV:ee[0]},u=d[1];for(let U=0;U<u;U++){let x=d[c++];if(d[c++]===7){let $=d[c++];x===4?l.magFilter=fe($):x===5?l.minFilter=fe($):x===1?l.addressModeU=le($):x===2&&(l.addressModeV=le($))}}b&&m&&console.log(`[GPU] createSampler(${s}) ${l.magFilter}/${l.minFilter}`),C[s]=t.createSampler(l)}function we(s,i,o,d){if(F[s])return;if(d===0){b&&m&&console.warn(`[GPU] createBindGroup(${s}) skipped: len=0`);return}let c=new Uint8Array(e.buffer,o,d),l=new DataView(c.buffer,c.byteOffset,c.byteLength),u=2,U=0,x=[],y=c[1];for(let P=0;P<y;P++){let w=c[u++],z=c[u++];if(w===1&&z===7)U=c[u++];else if(w===2&&z===3){let p=c[u++];for(let N=0;N<p;N++){let j=c[u++],ue=c[u++],Ne=l.getUint16(u,!0);u+=2;let Q={binding:j,rt:ue,rid:Ne};ue===0&&(Q.offset=l.getUint32(u,!0),u+=4,Q.size=l.getUint32(u,!0),u+=4),x.push(Q)}}}se[s]={layoutId:i,gi:U,entries:x},b&&m&&console.log(`[GPU] createBindGroup(${s}) layoutId=${i} entries=[${x.map(P=>`{b=${P.binding} rt=${P.rt} rid=${P.rid}}`).join(",")}]`);let $=S[i];if(!$)return;let L=x.map(P=>{let w={binding:P.binding};return P.rt===0?(w.resource={buffer:h[P.rid]},P.offset&&(w.resource.offset=P.offset),P.size&&(w.resource.size=P.size)):P.rt===1?(w.resource=E[P.rid]?.createView(),b&&m&&console.log(`[GPU] bindGroup entry b=${P.binding}: tex[${P.rid}]=${E[P.rid]?"exists":"MISSING"} view=${w.resource?"valid":"NULL"}`)):P.rt===2&&(w.resource=C[P.rid]),w});F[s]=t.createBindGroup({layout:$.getBindGroupLayout(U),entries:L})}function Te(s,i,o,d){g||(g=t.createCommandEncoder());let c=65534,l;if(s===c){let U=r.getCurrentTexture();b&&m&&console.log(`[GPU] canvasTex: ${U?.width}x${U?.height} ${U?.format}`),l=U.createView()}else l=E[s]?.createView();b&&m&&console.log(`[GPU] beginRenderPass colorId=${s===c?"CANVAS":s} loadOp=${i} storeOp=${o} depthId=${d}`),b&&m&&console.log(`[GPU] tex[${s}]=${E[s]?"exists":"MISSING"} view=${l?"valid":"NULL"}`);let u={colorAttachments:[{view:l,loadOp:i===1?"clear":"load",storeOp:o===0?"store":"discard",clearValue:{r:0,g:0,b:0,a:0}}]};d!==65535&&E[d]&&(u.depthStencilAttachment={view:E[d].createView(),depthLoadOp:"clear",depthStoreOp:"store",depthClearValue:1}),G=g.beginRenderPass(u)}function _e(){g||(g=t.createCommandEncoder()),G=g.beginComputePass()}let Ce={createBuffer:ye,createTexture:Ae,createSampler:Ge,createShader:Pe,createRenderPipeline:$e,createComputePipeline:Ee,createBindGroup:we,txv:_,tex:E,bgl:V,device:t,rs:Y,get mem(){return e},bmp:J,ppl:oe,beginRenderPass:Te,beginComputePass:_e,getPass:()=>G,setPass:s=>{G=s},pip:S,bg:F,buf:h,log:s=>{b&&m&&console.log(s)}};function Le(s,i,o){let d=ce(s,i,o,Ce);if(d!==null)return d;switch(s){case 32:{let c=i.getUint16(o,!0),l=i.getUint32(o+2,!0),u=i.getUint32(o+6,!0),U=i.getUint32(o+10,!0);return b&&m&&console.log(`[GPU] write_buffer: id=${c}, offset=${l}, dataPtr=${u}, dataLen=${U}`),h[c]&&U>0&&t.queue.writeBuffer(h[c],l,new Uint8Array(e.buffer,u,U)),o+14}case 33:{let c=i.getUint16(o,!0),l=i.getUint32(o+2,!0),u=i.getUint16(o+6,!0);if(b&&m&&console.log(`[GPU] writeTimeUniform buf[${c}] time=${n} cw=${f} ch=${a}`),h[c]){let U=new Float32Array([n,f,a,f/(a||1)]);t.queue.writeBuffer(h[c],l,new Uint8Array(U.buffer,0,Math.min(u,16)))}return o+8}case 34:{let c=i.getUint16(o,!0),l=i.getUint32(o+2,!0),u=i.getUint16(o+6,!0),U=i.getUint32(o+8,!0),x=i.getUint32(o+12,!0);return g||(g=t.createCommandEncoder()),g.copyBufferToBuffer(h[c],l,h[u],U,x),o+16}case 35:{let c=i.getUint16(o,!0),l=i.getUint16(o+2,!0),u=i.getUint16(o+4,!0),U=i.getUint16(o+6,!0);return g||(g=t.createCommandEncoder()),g.copyTextureToTexture({texture:E[c]},{texture:E[l]},[u,U]),o+8}case 36:{let c=i.getUint16(o,!0),l=i.getUint32(o+2,!0),u=i.getUint32(o+6,!0),U=i.getUint32(o+10,!0),x=Z[u];if(b&&m&&console.log(`[GPU] write_buffer_from_wasm: bid=${c}, off=${l}, callId=${u}, sz=${U}, cr=`,x),h[c]&&x&&U>0){let y=H[x.mid],$=y?.inst?.exports?.memory?.buffer||y?.importedMem?.buffer;b&&m&&console.log(`[GPU] write_buffer_from_wasm: mod=${!!y}, wasmMem=${!!$}, result=${x.result}, memSize=${$?.byteLength}`),$&&x.result!=null&&x.result+U<=$.byteLength?t.queue.writeBuffer(h[c],l,new Uint8Array($,x.result,U)):b&&m&&console.warn(`[GPU] write_buffer_from_wasm: invalid params - result=${x.result}, sz=${U}, memSize=${$?.byteLength}`)}return o+14}case 37:{let c=i.getUint16(o,!0),l=i.getUint16(o+2,!0),u=i.getUint8(o+4),U=i.getUint16(o+5,!0),x=i.getUint16(o+7,!0),y=J[c];return y&&E[l]&&t.queue.copyExternalImageToTexture({source:y},{texture:E[l],mipLevel:u,origin:[U,x]},[y.width,y.height]),o+9}case 48:{let c=i.getUint16(o,!0),l=i.getUint32(o+2,!0),u=i.getUint32(o+6,!0);if(b&&m&&console.log(`[GPU] init_wasm_module: id=${c}, ptr=${l}, len=${u}`),u===0)return o+10;let U=new Uint8Array(e.buffer,l,u).slice(),x=new WebAssembly.Memory({initial:1}),y={env:{abort:()=>{throw new Error("WASM abort")},memory:x}};return WebAssembly.compile(U).then($=>WebAssembly.instantiate($,y).then(L=>(H[c]={inst:L,importedMem:x},b&&m&&console.log(`[GPU] init_wasm_module done: id=${c}, exports=`,Object.keys(L.exports)),o+10)))}case 49:{let c=i.getUint16(o,!0),l=i.getUint16(o+2,!0),u=i.getUint32(o+4,!0),U=i.getUint32(o+8,!0),x=i.getUint8(o+12),y=new Uint8Array(e.buffer,o+13,x).slice(),$=Y(u,U);b&&m&&console.log(`[GPU] call_wasm_func: cid=${c}, mid=${l}, name="${$}", ac=${x}`);let{inst:L}=H[l]||{},P=L?.exports[$],w=[],z=new DataView(y.buffer,y.byteOffset,y.byteLength);for(let p=0,N=0;p<x/5|0;p++){let j=y[N++];j===0?w.push(z.getFloat32(N,!0)):j===1?w.push(z.getInt32(N,!0)):j===2&&w.push(z.getUint32(N,!0)),N+=4}if(P){let p=P(...w);Z[c]={mid:l,result:p},b&&m&&console.log(`[GPU] call_wasm_func result: cid=${c}, result=${p}`)}else b&&m&&console.log(`[GPU] call_wasm_func: fn not found! mid=${l}, name="${$}"`);return o+13+x}case 240:return b&&m&&console.log(`[GPU] submit enc=${!!g}`),g&&(t.queue.submit([g.finish()]),g=null),o;case 255:return o;default:return b&&console.warn(`Unknown cmd: 0x${s.toString(16)}`),o}}async function Se(s){let i=new DataView(e.buffer),o=i.getUint32(s,!0),d=i.getUint16(s+4,!0);b&&m&&console.log(`[GPU] Execute: ${d} cmds, ${o}b`);let c=s+8,l=s+o;for(let u=0;u<d&&c<l;u++){let U=i.getUint8(c++),x=Le(U,i,c);x instanceof Promise?(c=await x,i=new DataView(e.buffer)):c=x}}function Ie(){h.forEach(s=>s?.destroy?.()),E.forEach(s=>s?.destroy?.()),h.length=E.length=_.length=C.length=T.length=S.length=0,F.length=V.length=oe.length=J.length=H.length=0,Z.length=se.length=ae.length=0}let K=null;function Me(s){K=s,b&&m&&console.log(`[GPU] setUniformTable: ${s.size} uniforms`)}function ie(s,i){if(!K)return!1;let o=K.get(s);if(!o)return b&&m&&console.warn(`[GPU] setUniform: unknown uniform \'${s}\'`),!1;let d=h[o.bufferId];if(!d)return b&&m&&console.warn(`[GPU] setUniform: buffer ${o.bufferId} not found`),!1;let c=ve(i,o.type,o.size);return c?(t.queue.writeBuffer(d,o.offset,c),b&&m&&console.log(`[GPU] setUniform: ${s} = ${Array.isArray(i)?`[${i.join(",")}]`:i} @ buffer[${o.bufferId}]+${o.offset}`),!0):(b&&m&&console.warn(`[GPU] setUniform: failed to convert value for \'${s}\'`),!1)}function De(s){let i=0;for(let[o,d]of Object.entries(s))ie(o,d)&&i++;return i}return{setDebug(s){m=s},setMemory(s){e=s},setTime(s){n=s},setCanvasSize(s,i){f=s,a=i},setUniformTable:Me,setUniform:ie,setUniforms:De,execute:Se,destroy:Ie}}function ve(t,r,e){let n=Array.isArray(t)?t:[t];switch(r){case pe:case Ve:case ze:case ke:{let a=new Float32Array(n);return new Uint8Array(a.buffer,0,Math.min(a.byteLength,e))}case Be:case qe:case He:case Ye:{let a=new Int32Array(n);return new Uint8Array(a.buffer,0,Math.min(a.byteLength,e))}case Fe:case Xe:case Je:case Ze:{let a=new Uint32Array(n);return new Uint8Array(a.buffer,0,Math.min(a.byteLength,e))}case We:{let a=new Float32Array(12);return n.length>=9&&(a[0]=n[0],a[1]=n[3],a[2]=n[6],a[3]=0,a[4]=n[1],a[5]=n[4],a[6]=n[7],a[7]=0,a[8]=n[2],a[9]=n[5],a[10]=n[8],a[11]=0),new Uint8Array(a.buffer,0,Math.min(48,e))}case je:{let a=new Float32Array(n.length>=16?n:[...n,...Array(16-n.length).fill(0)]);return new Uint8Array(a.buffer,0,Math.min(64,e))}default:let f=new Float32Array(n);return new Uint8Array(f.buffer,0,Math.min(f.byteLength,e))}}var et=[80,78,71,66],me=0,de=40,tt=1,rt=2,nt=1,ot=2,st=4,at=8,it=16,ut=32;function Ue(t){if(t.length<de)throw new Error("Invalid PNGB: too short");if(!et.every((n,f)=>t[f]===n))throw new Error("Invalid PNGB: bad magic");let r=new DataView(t.buffer,t.byteOffset,t.byteLength),e=r.getUint16(4,!0);if(e!==me)throw new Error(`Unsupported PNGB version: ${e}`);return ct(t,r)}function ct(t,r){let e=r.getUint16(6,!0),n=t[8],f=r.getUint32(12,!0),a=r.getUint32(16,!0),g=r.getUint32(20,!0),G=r.getUint32(24,!0),m=r.getUint32(28,!0),h=r.getUint32(32,!0),E=r.getUint32(36,!0),_=(e&tt)!==0,C=(e&rt)!==0,T=_?f+a:de,S=g-T;return{version:me,hasEmbeddedExecutor:_,hasAnimationTable:C,plugins:ft(n),executor:_?t.subarray(f,f+a):null,bytecode:t.subarray(T,T+S),payload:t,offsets:{executor:_?f:0,executorLength:a,bytecode:T,bytecodeLength:S,stringTable:g,data:G,wgsl:m,uniform:h,animation:E}}}function ft(t){return{core:(t&nt)!==0,render:(t&ot)!==0,compute:(t&st)!==0,wasm:(t&at)!==0,animation:(t&it)!==0,texture:(t&ut)!==0}}function xe(t={}){return{env:{log:t.log||((r,e)=>{}),wasmInstantiate:t.wasmInstantiate||((r,e,n)=>{}),wasmCall:t.wasmCall||((r,e,n,f,a,g)=>{}),wasmGetResult:t.wasmGetResult||((r,e,n)=>0)}}}var I,R,X,A,M,O,B=!1,k=!1,ne=0,q=!1,W=null,D={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:r,...e}=t.data;try{switch(r){case D.INIT:await lt(e);break;case D.DRAW:mt(e);break;case D.LOAD:await gt(e);break;case D.DESTROY:dt();break;case D.SET_UNIFORM:Ut(e);break;case D.GET_UNIFORMS:xt();break;default:throw new Error(`Unknown message: ${r}`)}}catch(n){postMessage({type:D.ERROR,message:n.message})}};async function lt(t){if(B)throw new Error("Already initialized");I=t.canvas,q=t.debug;let r=await navigator.gpu?.requestAdapter();if(!r)throw new Error("WebGPU not supported");R=await r.requestDevice(),R.onuncapturederror=a=>{console.error("[Worker] WebGPU uncaptured error:",a.error.message)},X=I.getContext("webgpu");let e=navigator.gpu.getPreferredCanvasFormat();X.configure({device:R,format:e,alphaMode:"premultiplied"}),A=te(R,X),A.setDebug(q),A.setCanvasSize(I.width,I.height);let n=!1,f=null;if(t.bytecode)try{let a=new Uint8Array(t.bytecode);f=Ue(a),n=f.hasEmbeddedExecutor}catch(a){t.debug&&console.log("[Worker] Bytecode parse failed, using shared executor:",a.message)}if(n&&f.executor){t.debug&&console.log("[Worker] Using embedded executor from payload");let a=xe({log:(G,m)=>{if(t.debug){let h=new TextDecoder().decode(new Uint8Array(O.buffer,G,m));console.log("[Executor]",h)}}}),{instance:g}=await WebAssembly.instantiate(f.executor,a);M=g.exports,O=M.memory,A.setMemory(O),B=!0,await re(f.payload)}else{if(!t.wasmUrl)throw new Error("wasmUrl required (no embedded executor)");let a=await fetch(t.wasmUrl);if(!a.ok)throw new Error(`Failed to fetch WASM: ${a.status}`);let{instance:g}=await WebAssembly.instantiateStreaming(a,bt());M=g.exports,O=M.memory,A.setMemory(O),B=!0,t.bytecode&&await re(t.bytecode)}postMessage({type:D.READY,width:I.width,height:I.height,frameCount:ne})}async function gt(t){if(!B)throw new Error("Not initialized");await re(t.bytecode),postMessage({type:D.READY,frameCount:ne})}async function re(t){k&&(A.destroy(),A=te(R,X),A.setDebug(q),A.setMemory(O),A.setCanvasSize(I.width,I.height),k=!1,W=null);let r=M.getBytecodePtr(),e=t instanceof Uint8Array?t:new Uint8Array(t);new Uint8Array(O.buffer,r,e.length).set(e),M.setBytecodeLen(e.length);let{uniforms:n}=ge(e);W=n,q&&n.size>0&&console.log(`[Worker] Parsed ${n.size} uniform fields:`,[...n.keys()]);let f=M.init();if(f!==0)throw new Error(`Init failed: ${f}`);let a=M.getCommandPtr(),g=M.getCommandLen();a&&g>0&&await A.execute(a),A.setUniformTable(W),k=!0,ne=1,be(0,I.width,I.height)}function be(t,r,e){A.setTime(t);let n=M.frame(t,r,e);if(n!==0){console.warn("[Worker] frame() returned non-zero:",n);return}let f=M.getCommandPtr(),a=M.getCommandLen();!f||a===0||A.execute(f)}function mt(t){if(!(!B||!k)){if(t.uniforms&&typeof t.uniforms=="object"){let r=A.setUniforms(t.uniforms);q&&r>0&&console.log(`[Worker] Set ${r} uniforms`)}be(t.time??0,I.width,I.height)}}function dt(){k=!1,W=null,A?.destroy(),R&&(R.destroy(),R=null),B=!1}function Ut(t){!B||!k||(t.uniforms&&typeof t.uniforms=="object"?A.setUniforms(t.uniforms):t.name!==void 0&&t.value!==void 0&&A.setUniform(t.name,t.value))}function xt(){if(!W){postMessage({type:D.UNIFORMS,uniforms:{}});return}let t={};for(let[r,e]of W)t[r]={type:e.type,size:e.size,bufferId:e.bufferId,offset:e.offset};postMessage({type:D.UNIFORMS,uniforms:t})}function bt(){return{env:{log:(t,r)=>{let e=new TextDecoder().decode(new Uint8Array(O.buffer,t,r));console.log("[Executor]",e)}}}}\n';function T(){let e=new Blob([S],{type:"application/javascript"});return URL.createObjectURL(e)}var C=[137,80,78,71,13,10,26,10],b=[112,78,71,98],G=e=>e.length>=8&&C.every((t,r)=>e[r]===t),_=e=>e.length>=4&&e[0]===80&&e[1]===75&&(e[2]===3||e[2]===5),M=e=>e.length>=4&&e[0]===80&&e[1]===78&&e[2]===71&&e[3]===66;function N(e){return _(e)?"zip":G(e)?"png":M(e)?"pngb":null}async function $(e){let t=e instanceof Uint8Array?e:new Uint8Array(e),r=N(t);if(r==="pngb")return t;if(r==="png")return O(t);if(r==="zip")return R(t);throw new Error("Unknown format")}async function O(e){if(!G(e))throw new Error("Invalid PNG");let t=8;for(;t+12<=e.length;){let r=D(e,t),n=e.subarray(t+4,t+8);if(n[0]===b[0]&&n[1]===b[1]&&n[2]===b[2]&&n[3]===b[3]){let o=e.subarray(t+8,t+8+r);return B(o)}t+=12+r}throw new Error("No pNGb chunk found")}async function B(e){if(e.length<2)throw new Error("Invalid pNGb chunk");let t=e[0],r=e[1],n=e.subarray(2);if(t!==1)throw new Error(`Unsupported pNGb version: ${t}`);return r&1?A(n):new Uint8Array(n)}async function R(e){let t=-1;for(let a=22;a<=Math.min(e.length,65557);a++){let s=e.length-a;if(g(e,s)===101010256){t=s;break}}if(t===-1)throw new Error("Invalid ZIP");let r=f(e,t+10),n=g(e,t+16),o=null,i=null;for(let a=0;a<r&&g(e,n)===33639248;a++){let s=f(e,n+10),u=g(e,n+20),c=g(e,n+24),m=f(e,n+28),l=f(e,n+30),h=f(e,n+32),d=g(e,n+42),U=new TextDecoder().decode(e.subarray(n+46,n+46+m)),y=f(e,d+28),x=d+30+m+y,p={name:U,compression:s,compSize:u,uncompSize:c,dataOff:x};U==="manifest.json"?o=p:U.endsWith(".pngb")&&!i&&(i=p),n+=46+m+l+h}if(o){let a=JSON.parse(new TextDecoder().decode(await P(e,o)));if(a.entry){n=g(e,t+16);for(let s=0;s<r&&g(e,n)===33639248;s++){let u=f(e,n+28);if(new TextDecoder().decode(e.subarray(n+46,n+46+u))===a.entry){let m=f(e,n+10),l=g(e,n+20),h=g(e,n+24),d=f(e,n+30),U=f(e,n+32),y=g(e,n+42),x=f(e,y+28),p=y+30+u+x;return P(e,{compression:m,compSize:l,uncompSize:h,dataOff:p})}n+=46+u+f(e,n+30)+f(e,n+32)}}}if(i)return P(e,i);throw new Error("No bytecode found in ZIP")}async function P(e,t){let r=e.subarray(t.dataOff,t.dataOff+t.compSize);if(t.compression===0)return new Uint8Array(r);if(t.compression===8)return A(r);throw new Error(`Unsupported compression: ${t.compression}`)}async function A(e){let t=new DecompressionStream("deflate-raw"),r=t.writable.getWriter(),n=t.readable.getReader();r.write(e),r.close();let o=[],i=0;for(;;){let{done:u,value:c}=await n.read();if(u)break;o.push(c),i+=c.length}let a=new Uint8Array(i),s=0;for(let u of o)a.set(u,s),s+=u.length;return a}var f=(e,t)=>e[t]|e[t+1]<<8,g=(e,t)=>(e[t]|e[t+1]<<8|e[t+2]<<16|e[t+3]<<24)>>>0,D=(e,t)=>(e[t]<<24|e[t+1]<<16|e[t+2]<<8|e[t+3])>>>0,k=[80,78,71,66],L=0,I=40,F=1,z=2,W=1,V=2,q=4,j=8,H=16,Y=32;function Q(e){if(e.length<I)throw new Error("Invalid PNGB: too short");if(!k.every((n,o)=>e[o]===n))throw new Error("Invalid PNGB: bad magic");let t=new DataView(e.buffer,e.byteOffset,e.byteLength),r=t.getUint16(4,!0);if(r!==L)throw new Error(`Unsupported PNGB version: ${r}`);return J(e,t)}function J(e,t){let r=t.getUint16(6,!0),n=e[8],o=t.getUint32(12,!0),i=t.getUint32(16,!0),a=t.getUint32(20,!0),s=t.getUint32(24,!0),u=t.getUint32(28,!0),c=t.getUint32(32,!0),m=t.getUint32(36,!0),l=(r&F)!==0,h=(r&z)!==0,d=l?o+i:I,U=a-d;return{version:L,hasEmbeddedExecutor:l,hasAnimationTable:h,plugins:Z(n),executor:l?e.subarray(o,o+i):null,bytecode:e.subarray(d,d+U),payload:e,offsets:{executor:l?o:0,executorLength:i,bytecode:d,bytecodeLength:U,stringTable:a,data:s,wgsl:u,uniform:c,animation:m}}}function Z(e){return{core:(e&W)!==0,render:(e&V)!==0,compute:(e&q)!==0,wasm:(e&j)!==0,animation:(e&H)!==0,texture:(e&Y)!==0}}function ee(e={}){return{env:{log:e.log||((t,r)=>{}),wasmInstantiate:e.wasmInstantiate||((t,r,n)=>{}),wasmCall:e.wasmCall||((t,r,n,o,i,a)=>{}),wasmGetResult:e.wasmGetResult||((t,r,n)=>0)}}}async function te(e,t={}){let{instance:r}=await WebAssembly.instantiate(e,t),n=r.exports,o=n.memory;return{instance:r,memory:o,exports:n,getBytecodePtr(){return n.getBytecodePtr?.()||0},setBytecodeLen(i){n.setBytecodeLen?.(i)},getDataPtr(){return n.getDataPtr?.()||0},setDataLen(i){n.setDataLen?.(i)},init(){n.init?.()},frame(i,a,s){n.frame?.(i,a,s)},getCommandPtr(){return n.getCommandPtr?.()||0},getCommandLen(){return n.getCommandLen?.()||0}}}function re(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 v(e,t){if(!e||e.length===0)return null;for(let r of e)if(t>=r.startMs&&t<r.endMs)return r;return e[e.length-1]}function w(e,t={}){let r=e._;if(!r)throw new Error("Pngine destroyed");if(!r.ready)throw new Error("Not initialized");let n=t.time??r.time,o=t.frame??null;if(o===null&&r.animation&&r.animation.scenes.length>0){let i=v(r.animation.scenes,n*1e3);i&&(o=i.frame,i!==r.currentScene&&(r.currentScene=i,r.currentFrame=i.frame))}r.worker.postMessage({type:"draw",time:n,frame:o,uniforms:t.uniforms??null}),t.time!==void 0&&(r.time=t.time)}function ne(e){let t=e._;if(!t||t.playing)return e;t.playing=!0,t.startTime=performance.now()-t.time*1e3;let r=()=>{if(!t.playing)return;let n=performance.now(),o=(n-t.startTime)/1e3;if(t.animation){let i=t.animation.duration/1e3;if(o>=i)switch(t.animation.endBehavior){case"loop":case"restart":t.startTime=n,o=0;break;case"stop":t.playing=!1,t.time=i,w(e,{time:i});return;case"hold":default:o=i;break}let a=v(t.animation.scenes,o*1e3);a&&a!==t.currentScene&&(t.currentScene=a,t.currentFrame=a.frame)}t.time=o,w(e,{time:t.time,frame:t.currentFrame}),t.animationId=requestAnimationFrame(r)};return t.animationId=requestAnimationFrame(r),e}function X(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 oe(e){X(e);let t=e._;return t&&(t.time=0,t.startTime=performance.now(),w(e,{time:0})),e}function ie(e,t){let r=e._;return r&&(r.time=t,r.playing&&(r.startTime=performance.now()-t*1e3),w(e,{time:t})),e}function ae(e,t){let r=e._;return r&&(r.currentFrame=t,w(e,{time:r.time,frame:t})),e}function se(e,t,r,n=!0){let o=e._;return o&&(o.uniforms||(o.uniforms={}),o.uniforms[t]=r,n&&w(e,{time:o.time,uniforms:{[t]:r}})),e}function ue(e,t,r=!0){let n=e._;return n&&(n.uniforms||(n.uniforms={}),Object.assign(n.uniforms,t),r&&w(e,{time:n.time,uniforms:t})),e}function le(e){let t=e._;return!t||!t.ready?Promise.resolve({}):new Promise(r=>{let n=o=>{o.data.type==="uniforms"&&(t.worker.removeEventListener("message",n),r(o.data.uniforms||{}))};t.worker.addEventListener("message",n),t.worker.postMessage({type:"getUniforms"})})}async function fe(e,t={}){let r,n;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:r,bytecode:n}=await E(u,t));else throw u instanceof HTMLCanvasElement?(r=u,new Error("Canvas source requires URL or data")):new Error("Invalid element type")}else{if(r=t.canvas,!r)throw new Error("Canvas required for URL source");let u=await fetch(e);if(!u.ok)throw new Error(`Fetch failed: ${u.status}`);n=await $(await u.arrayBuffer())}else if(e instanceof HTMLImageElement)({canvas:r,bytecode:n}=await E(e,t));else if(e instanceof ArrayBuffer||e instanceof Uint8Array||e instanceof Blob){if(r=t.canvas,!r)throw new Error("Canvas required for data source");let s=e instanceof Blob?await e.arrayBuffer():e;n=await $(s)}else throw new Error("Invalid source type");let o=r.transferControlToOffscreen(),i=new Worker(T()),a=await new Promise((s,u)=>{let c=setTimeout(()=>u(new Error("Worker init timeout")),15e3);i.onmessage=l=>{l.data.type==="ready"?(clearTimeout(c),s(l.data)):l.data.type==="error"&&(clearTimeout(c),u(new Error(l.data.message)))},i.onerror=l=>{clearTimeout(c),u(new Error(l.message||"Worker error"))};let m=t.wasmUrl?new URL(t.wasmUrl,window.location.href).href:new URL("pngine.wasm",import.meta.url).href;i.postMessage({type:"init",canvas:o,bytecode:n,wasmUrl:m,debug:t.debug||!1},[o,n.buffer])});return i.onmessage=s=>{s.data.type==="error"&&t.onError&&t.onError(new Error(s.data.message))},K({canvas:r,worker:i,width:a.width,height:a.height,frameCount:a.frameCount,animation:a.animation||null,currentScene:null,currentFrame:null,ready:!0,playing:!1,time:0,startTime:0,animationId:null})}async function E(e,t){e.complete||await new Promise((s,u)=>{e.onload=s,e.onerror=u});let{naturalWidth:r,naturalHeight:n}=e;if(r===0||n===0)throw new Error("Image has no dimensions");let o=t.canvas||document.createElement("canvas");if(o.width=r,o.height=n,!t.canvas){let s=e.parentElement;s&&getComputedStyle(s).position==="static"&&(s.style.position="relative"),Object.assign(o.style,{position:"absolute",top:e.offsetTop+"px",left:e.offsetLeft+"px",width:e.offsetWidth+"px",height:e.offsetHeight+"px",pointerEvents:"none"}),s&&s.appendChild(o)}let i=await fetch(e.src);if(!i.ok)throw new Error(`Failed to fetch image: ${i.status}`);let a=await $(await i.arrayBuffer());return{canvas:o,bytecode:a}}function K(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 ce(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,ce as destroy,N as detectFormat,w as draw,$ as extractBytecode,ee as getExecutorImports,re as getExecutorVariantName,le as getUniforms,G as isPng,M as isPngb,_ as isZip,Q as parsePayload,X as pause,ne as play,fe as pngine,ie as seek,ae as setFrame,se as setUniform,ue as setUniforms,oe 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};
@@ -0,0 +1,46 @@
1
+
2
+ export interface ViewerOptions {
3
+ canvas: HTMLCanvasElement;
4
+ debug?: boolean;
5
+ onError?: (error: Error) => void;
6
+ }
7
+
8
+ export function pngine(
9
+ source: ArrayBuffer | Uint8Array | Blob | string,
10
+ options: ViewerOptions
11
+ ): Promise<PngineInstance>;
12
+
13
+ /** Uniform value: number (f32), array (vecNf), or nested array (matNxMf) */
14
+ export type UniformValue = number | number[] | number[][];
15
+
16
+ export interface DrawOptions {
17
+ time?: number;
18
+ frame?: string;
19
+ uniforms?: Record<string, UniformValue>;
20
+ }
21
+
22
+ export interface PngineInstance {
23
+ readonly width: number;
24
+ readonly height: number;
25
+ readonly frameCount: number;
26
+ readonly isPlaying: boolean;
27
+ readonly time: number;
28
+ }
29
+
30
+ export function destroy(instance: PngineInstance): void;
31
+ export function draw(instance: PngineInstance, options?: DrawOptions): void;
32
+ export function play(instance: PngineInstance): PngineInstance;
33
+ export function pause(instance: PngineInstance): PngineInstance;
34
+ export function stop(instance: PngineInstance): PngineInstance;
35
+ export function seek(instance: PngineInstance, time: number): PngineInstance;
36
+ export function setFrame(instance: PngineInstance, frame: string | null): PngineInstance;
37
+ export function setUniform(instance: PngineInstance, name: string, value: UniformValue, redraw?: boolean): PngineInstance;
38
+ export function setUniforms(instance: PngineInstance, uniforms: Record<string, UniformValue>, redraw?: boolean): PngineInstance;
39
+ export function getUniforms(instance: PngineInstance): Promise<Record<string, { type: number; size: number; bufferId: number; offset: number }>>;
40
+
41
+ export function extractBytecode(data: ArrayBuffer | Uint8Array): Promise<Uint8Array>;
42
+ export function detectFormat(data: ArrayBuffer | Uint8Array): 'png' | 'zip' | 'pngb' | null;
43
+ export function isPng(data: ArrayBuffer | Uint8Array): boolean;
44
+ export function isZip(data: ArrayBuffer | Uint8Array): boolean;
45
+ export function isPngb(data: ArrayBuffer | Uint8Array): boolean;
46
+
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;