@taole/giftstage 0.3.3 → 0.3.4

package/dist/gpu/webgl2-backend.d.ts

@@ -144,6 +144,7 @@ export declare class WebGL2Backend implements GPUBackend {
     private recordSubmittedDraw;
     private rejectSVGAFastPathDraw;
     private initPrograms;
+    prepareParticleSpritePipelines(): void;
     private ensureParticleSpriteProgram;
     private makeProgramEntry;
     /**

package/dist/gpu/webgpu-backend.d.ts

@@ -57,6 +57,8 @@ export declare class WebGPUBackend implements GPUBackend {
     private buffers;
     private textures;
     private pipelines;
+    private particleSpritePreparations;
+    private particleSpritePreparationEpoch;
     private sampler;
     private uniformBuffer;
     private texturedBindGroupLayout;
@@ -214,7 +216,9 @@ export declare class WebGPUBackend implements GPUBackend {
     private ensureSVGAFrameTableMeshPipeline;
     private ensureMotionSvgaPipeline;
     private ensureParticlePipeline;
+    prepareParticleSpritePipelines(): Promise<void>;
     private ensureParticleSpritePipeline;
+    private particleSpritePipelineDescriptor;
     private createInstancedSvgaPipeline;
     private createInstancedClipMaskPipeline;
     private createVapInstancedPipeline;

package/dist/types/index.d.ts

@@ -314,6 +314,8 @@ export interface GPUBackend {
     createSVGAFrameTable?(packedData: Float32Array, options: SVGAFrameTableCreateOptions): SVGAFrameTableBinding;
     /** Releases a frame table returned by `createSVGAFrameTable`. */
     deleteSVGAFrameTable?(binding: SVGAFrameTableBinding): void;
+    /** Prepares sprite-v2 shaders before playback, without drawing or advancing a clock. */
+    prepareParticleSpritePipelines?(): void | Promise<void>;
     createTexture(source: TexImageSource | ArrayBuffer, opts: TextureOpts): GPUTextureHandle;
     /** Uninitialized RGBA texture (e.g. WebCodecs atlas backing store). */
     createEmptyTexture(width: number, height: number, opts?: TextureOpts): GPUTextureHandle;

package/dist/utils/clip-mesh.d.ts

@@ -1,3 +1,4 @@
+import { parseSvgPath } from './svg-path-parser.js';
 export interface ClipMeshData {
     vertices: Float32Array;
     indices: Uint32Array;
@@ -16,4 +17,8 @@ export type ClipPathGeometryKind = 'empty' | 'fillable' | 'invalid';
  * validation remains authoritative for those genuinely malformed contours.
  */
 export declare function classifyClipPathGeometry(clipPath: string): ClipPathGeometryKind;
+/** Reuses flattened geometry when callers also inspect the path's bounds. */
+export declare function classifyParsedClipPathGeometry(subPaths: ReturnType<typeof parseSvgPath>): ClipPathGeometryKind;
+/** Checkpoints also bound work for a single large, collinear contour. */
+export declare function classifyParsedClipPathGeometrySteps(subPaths: ReturnType<typeof parseSvgPath>): Generator<void, ClipPathGeometryKind>;
 export declare function buildClipMeshFromPath(clipPath: string, triangulator?: ClipMeshTriangulator): ClipMeshData | null;

package/dist/utils/svg-path-parser.d.ts

@@ -8,4 +8,6 @@ interface Point {
     y: number;
 }
 export declare function parseSvgPath(d: string): Point[][];
+/** Incremental curve flattening for frame-budgeted clip analysis. */
+export declare function parseSvgPathSteps(d: string): Generator<void, Point[][]>;
 export {};

package/dist/utils/svga-hybrid-command-table.d.ts

@@ -4,9 +4,13 @@ export declare const SVGA_HYBRID_OP_SHAPE = 1;
 export declare const SVGA_HYBRID_OP_CLIP_WRITE = 2;
 export declare const SVGA_HYBRID_OP_CLIP_TEST = 3;
 export declare const SVGA_HYBRID_OP_CLIP_CLEAR = 4;
-/**
- * Compiles the SVGA paint graph once per resource. Runtime Hybrid rendering
- * indexes one immutable frame slice and never scans all sprite rows or resolves
- * image/shape/clip keys on the hot path.
- */
+export interface SVGAHybridCommandTableBuildOptions {
+    /** Shares the same main-thread budget as SVGA parsing, atlas and slot work. */
+    frameBudgetMs?: number;
+    /** Throw when the owning resource has been released or its backend is lost. */
+    checkActive?: () => void;
+}
+/** Compatibility entry point for offline/synchronous callers. Playback uses the cooperative builder. */
 export declare function buildSVGAHybridCommandTable(entity: VideoEntity): SVGAHybridCommandTable;
+/** Only returns a complete immutable table; partially built state never reaches the renderer. */
+export declare function buildSVGAHybridCommandTableCooperative(entity: VideoEntity, options?: SVGAHybridCommandTableBuildOptions): Promise<SVGAHybridCommandTable>;

package/package.json

@@ -1,82 +1,82 @@
-{
-  "name": "@taole/giftstage",
-  "version": "0.3.3",
-  "description": "High-performance WebGPU/WebGL gift animation player unifying SVGA, VAP, AlphaVideo, and images",
-  "type": "module",
-  "main": "dist/gift-stage.cjs",
-  "module": "dist/gift-stage.es.js",
-  "types": "dist/public.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/public.d.ts",
-      "import": "./dist/gift-stage.es.js",
-      "require": "./dist/gift-stage.cjs"
-    }
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "dist",
-    "!dist/**/*.map",
-    "!dist/bundle-report.*.html",
-    "!dist/fixtures/**"
-  ],
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc --noEmit && vite build && tsc -p tsconfig.build.json && node scripts/write-public-types.mjs",
-    "build:analyze": "tsc --noEmit && vite build --mode analyze-es && vite build --mode analyze-cjs && tsc -p tsconfig.build.json && node scripts/write-public-types.mjs",
-    "build:demo": "tsc --noEmit && vite build --config vite.demo.config.ts && node -e \"const fs=require('fs'); fs.mkdirSync('dist-demo/static',{recursive:true}); fs.copyFileSync('static/vap.min.js','dist-demo/static/vap.min.js');\"",
-    "build:wasm": "echo \"Requires: cargo install wasm-pack\" && cd wasm && wasm-pack build --target web --out-dir pkg",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:browser": "vitest run --browser.enabled --browser.name=chromium",
-    "test:e2e": "playwright test",
-    "test:perf": "node scripts/run-performance.mjs",
-    "test:real-assets": "node scripts/verify-real-svga-manifest.mjs",
-    "test:package": "npm run build && node scripts/check-package-contract.mjs",
-    "perf:record": "node scripts/run-performance.mjs --record",
-    "lint": "eslint src/ tests/",
-    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "typecheck": "tsc --noEmit",
-    "dp": "node publish/deploy.mjs"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.50.0",
-    "@types/dom-webcodecs": "^0.1.11",
-    "@types/earcut": "^3.0.0",
-    "@types/node": "^25.6.0",
-    "@types/pngjs": "^6.0.5",
-    "@vitest/browser": "^3.0.0",
-    "eslint": "^9.0.0",
-    "fake-indexeddb": "^6.2.5",
-    "jsdom": "^24.1.3",
-    "playwright": "^1.50.0",
-    "pngjs": "^7.0.0",
-    "prettier": "^3.4.0",
-    "rollup-plugin-visualizer": "^7.0.1",
-    "typescript": "^5.7.0",
-    "typescript-eslint": "^8.68.0",
-    "vite": "^6.0.0",
-    "vite-plugin-wasm": "^3.4.0",
-    "vitest": "^3.0.0"
-  },
-  "keywords": [
-    "svga",
-    "vap",
-    "alpha-video",
-    "image",
-    "webgl",
-    "webgpu",
-    "animation",
-    "gift",
-    "transparent-video"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@webgpu/types": "^0.1.69",
-    "earcut": "^3.0.2",
-    "mp4box": "^2.3.0"
-  }
-}
+{
+  "name": "@taole/giftstage",
+  "version": "0.3.4",
+  "description": "High-performance WebGPU/WebGL gift animation player unifying SVGA, VAP, AlphaVideo, and images",
+  "type": "module",
+  "main": "dist/gift-stage.cjs",
+  "module": "dist/gift-stage.es.js",
+  "types": "dist/public.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/public.d.ts",
+      "import": "./dist/gift-stage.es.js",
+      "require": "./dist/gift-stage.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/bundle-report.*.html",
+    "!dist/fixtures/**"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build && tsc -p tsconfig.build.json && node scripts/write-public-types.mjs",
+    "build:analyze": "tsc --noEmit && vite build --mode analyze-es && vite build --mode analyze-cjs && tsc -p tsconfig.build.json && node scripts/write-public-types.mjs",
+    "build:demo": "tsc --noEmit && vite build --config vite.demo.config.ts && node -e \"const fs=require('fs'); fs.mkdirSync('dist-demo/static',{recursive:true}); fs.copyFileSync('static/vap.min.js','dist-demo/static/vap.min.js');\"",
+    "build:wasm": "echo \"Requires: cargo install wasm-pack\" && cd wasm && wasm-pack build --target web --out-dir pkg",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:browser": "vitest run --browser.enabled --browser.name=chromium",
+    "test:e2e": "playwright test",
+    "test:perf": "node scripts/run-performance.mjs",
+    "test:real-assets": "node scripts/verify-real-svga-manifest.mjs",
+    "test:package": "npm run build && node scripts/check-package-contract.mjs",
+    "perf:record": "node scripts/run-performance.mjs --record",
+    "lint": "eslint src/ tests/",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "dp": "node publish/deploy.mjs"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.50.0",
+    "@types/dom-webcodecs": "^0.1.11",
+    "@types/earcut": "^3.0.0",
+    "@types/node": "^25.6.0",
+    "@types/pngjs": "^6.0.5",
+    "@vitest/browser": "^3.0.0",
+    "eslint": "^9.0.0",
+    "fake-indexeddb": "^6.2.5",
+    "jsdom": "^24.1.3",
+    "playwright": "^1.50.0",
+    "pngjs": "^7.0.0",
+    "prettier": "^3.4.0",
+    "rollup-plugin-visualizer": "^7.0.1",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.68.0",
+    "vite": "^6.0.0",
+    "vite-plugin-wasm": "^3.4.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "svga",
+    "vap",
+    "alpha-video",
+    "image",
+    "webgl",
+    "webgpu",
+    "animation",
+    "gift",
+    "transparent-video"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@webgpu/types": "^0.1.69",
+    "earcut": "^3.0.2",
+    "mp4box": "^2.3.0"
+  }
+}