@haiyue/extensions 0.1.0 → 0.2.0

package/dist/internal/2d-ui-shader-artifact.js

@@ -1,5 +1,6 @@
-import { A as Animation2dWgsl } from '../chunks/2d-ui-animation-2d.generated-D4aHzFU2.js';
+import { A as Animation2dWgsl } from '../chunks/2d-ui-animation-2d.generated-FpziAeGJ.js';
 import { C as CanvasText2dWgsl } from '../chunks/2d-ui-canvas-text-2d.generated-C0Eaej2m.js';
+import { I as IndexedSpriteWgsl } from '../chunks/2d-ui-indexed-sprite.generated-DmKR0CC3.js';
 import { s as spine2dWgsl } from '../chunks/2d-ui-spine2d.generated-CUUi8xjl.js';
 import { t as tilemap2dWgsl } from '../chunks/2d-ui-tilemap2d.generated-gebw4mX7.js';
 
@@ -11,10 +12,10 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
     "source": {
         "kind": "module-family",
         "path": "shader-language/builtin-components-2d-ui-family.json",
-        "sha256": "a6366ad77efa2b76deca07eb87f6a62ed8f22407c5554fc709694d166964499c"
+        "sha256": "20df3f065b0d6ad0e8a78c10f8fd3bd1d3e572c33735b7b797d8d2277ca501f4"
     },
-    "canonicalHash": "8cb7801fc75830a8764f127db5d9d94faf2cf92b697afdb4e2d32fb0c9b33abf",
-    "typedModuleHash": "4b50cf5eacdf4f9d1806d18b0378811f662db650b620d7d62c405b34444a8799",
+    "canonicalHash": "635ff69d88d078463d3cd36ae8f2074a711d610b85a51091a584ba250e029ab6",
+    "typedModuleHash": "977a9330584c5a96854e3c21a2b0315e5fe8e641cdec43e6e240b3e046a1f888",
     "passes": {
         "animation-2d": {
             "id": "animation-2d",
@@ -34,7 +35,8 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
                             "id": "frame.camera",
                             "binding": 0,
                             "visibility": [
-                                "vertex"
+                                "vertex",
+                                "fragment"
                             ],
                             "layout": {
                                 "kind": "buffer",
@@ -62,7 +64,7 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
                                 "kind": "buffer",
                                 "bufferType": "uniform",
                                 "hasDynamicOffset": false,
-                                "minBindingSize": 1264
+                                "minBindingSize": 1296
                             }
                         }
                     ]
@@ -241,7 +243,7 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
                 {
                     "id": "object.animation2d",
                     "alignment": 16,
-                    "byteSize": 1264,
+                    "byteSize": 1296,
                     "fields": [
                         {
                             "name": "model",
@@ -257,81 +259,93 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
                             "size": 16
                         },
                         {
-                            "name": "params",
+                            "name": "multiplyColor",
                             "type": "vec4<f32>",
                             "offset": 80,
                             "size": 16
                         },
                         {
-                            "name": "uvRect",
+                            "name": "screenColor",
                             "type": "vec4<f32>",
                             "offset": 96,
                             "size": 16
                         },
+                        {
+                            "name": "params",
+                            "type": "vec4<f32>",
+                            "offset": 112,
+                            "size": 16
+                        },
+                        {
+                            "name": "uvRect",
+                            "type": "vec4<f32>",
+                            "offset": 128,
+                            "size": 16
+                        },
                         {
                             "name": "compositeParams",
                             "type": "array<vec4<f32>, 8>",
-                            "offset": 112,
+                            "offset": 144,
                             "size": 128
                         },
                         {
                             "name": "compositeExpansion0",
                             "type": "vec4<f32>",
-                            "offset": 240,
+                            "offset": 272,
                             "size": 16
                         },
                         {
                             "name": "compositeExpansion1",
                             "type": "vec4<f32>",
-                            "offset": 256,
+                            "offset": 288,
                             "size": 16
                         },
                         {
                             "name": "gradientParams",
                             "type": "vec4<f32>",
-                            "offset": 272,
+                            "offset": 304,
                             "size": 16
                         },
                         {
                             "name": "gradientGeometry",
                             "type": "vec4<f32>",
-                            "offset": 288,
+                            "offset": 320,
                             "size": 16
                         },
                         {
                             "name": "gradientColors",
                             "type": "array<vec4<f32>, 8>",
-                            "offset": 304,
+                            "offset": 336,
                             "size": 128
                         },
                         {
                             "name": "gradientOffsets0",
                             "type": "vec4<f32>",
-                            "offset": 432,
+                            "offset": 464,
                             "size": 16
                         },
                         {
                             "name": "gradientOffsets1",
                             "type": "vec4<f32>",
-                            "offset": 448,
+                            "offset": 480,
                             "size": 16
                         },
                         {
                             "name": "effectKinds0",
                             "type": "vec4<f32>",
-                            "offset": 464,
+                            "offset": 496,
                             "size": 16
                         },
                         {
                             "name": "effectKinds1",
                             "type": "vec4<f32>",
-                            "offset": 480,
+                            "offset": 512,
                             "size": 16
                         },
                         {
                             "name": "effectData",
                             "type": "array<EffectData, 8>",
-                            "offset": 496,
+                            "offset": 528,
                             "size": 768
                         }
                     ]
@@ -390,10 +404,10 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
                     "sourceId": "builtin.animation-2d",
                     "sourceName": "shader-language/builtin-components-2d-ui-family.json",
                     "generatedStartLine": 1,
-                    "generatedEndLine": 243
+                    "generatedEndLine": 322
                 }
             ],
-            "canonicalHash": "1225970fdaa5c141d69d1ada2cce5c10f040a74e80874808108d169387ef089e"
+            "canonicalHash": "352f83931c94e068cd3062ff27498a6d342d27947758c7bb6a578ae43e828fc3"
         },
         "canvas-text-2d": {
             "id": "canvas-text-2d",
@@ -558,6 +572,201 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
             ],
             "canonicalHash": "23dac7ae1d4e1bd8b695cb8261402b4b634d1315bf6a42e1ca04367f5e1cc598"
         },
+        "indexed-sprite": {
+            "id": "indexed-sprite",
+            "code": IndexedSpriteWgsl,
+            "entryPoints": {
+                "vertex": "vs_main",
+                "fragment": "fs_main"
+            },
+            "bindGroups": [
+                {
+                    "logicalSpace": "frame",
+                    "logicalGroup": 0,
+                    "physicalGroup": 0,
+                    "owner": "renderer",
+                    "bindings": [
+                        {
+                            "id": "frame.viewport",
+                            "binding": 0,
+                            "visibility": [
+                                "vertex"
+                            ],
+                            "layout": {
+                                "kind": "buffer",
+                                "bufferType": "uniform",
+                                "hasDynamicOffset": false,
+                                "minBindingSize": 16
+                            }
+                        },
+                        {
+                            "id": "frame.instances",
+                            "binding": 1,
+                            "visibility": [
+                                "vertex"
+                            ],
+                            "layout": {
+                                "kind": "buffer",
+                                "bufferType": "read-only-storage",
+                                "hasDynamicOffset": false,
+                                "minBindingSize": 0
+                            }
+                        }
+                    ]
+                },
+                {
+                    "logicalSpace": "material",
+                    "logicalGroup": 2,
+                    "physicalGroup": 1,
+                    "owner": "renderer",
+                    "bindings": [
+                        {
+                            "id": "material.indexAtlas",
+                            "binding": 0,
+                            "visibility": [
+                                "fragment"
+                            ],
+                            "layout": {
+                                "kind": "texture",
+                                "sampleType": "uint",
+                                "viewDimension": "2d",
+                                "multisampled": false
+                            }
+                        },
+                        {
+                            "id": "material.colorAtlas",
+                            "binding": 1,
+                            "visibility": [
+                                "fragment"
+                            ],
+                            "layout": {
+                                "kind": "texture",
+                                "sampleType": "float",
+                                "viewDimension": "2d",
+                                "multisampled": false
+                            }
+                        },
+                        {
+                            "id": "material.paletteBank",
+                            "binding": 2,
+                            "visibility": [
+                                "fragment"
+                            ],
+                            "layout": {
+                                "kind": "texture",
+                                "sampleType": "float",
+                                "viewDimension": "2d",
+                                "multisampled": false
+                            }
+                        },
+                        {
+                            "id": "material.colorSampler",
+                            "binding": 3,
+                            "visibility": [
+                                "fragment"
+                            ],
+                            "layout": {
+                                "kind": "sampler",
+                                "samplerType": "filtering"
+                            }
+                        }
+                    ]
+                }
+            ],
+            "uniformBlocks": [
+                {
+                    "id": "frame.viewport",
+                    "alignment": 16,
+                    "byteSize": 16,
+                    "fields": [
+                        {
+                            "name": "size",
+                            "type": "vec2<f32>",
+                            "offset": 0,
+                            "size": 8
+                        },
+                        {
+                            "name": "_pad",
+                            "type": "vec2<f32>",
+                            "offset": 8,
+                            "size": 8
+                        }
+                    ]
+                }
+            ],
+            "vertexBuffers": [],
+            "varyings": [
+                {
+                    "semantic": "TEXCOORD_0",
+                    "location": 0,
+                    "type": "vec2<f32>",
+                    "interpolation": "perspective"
+                },
+                {
+                    "semantic": "UV_RECT",
+                    "location": 1,
+                    "type": "vec4<f32>",
+                    "interpolation": "flat"
+                },
+                {
+                    "semantic": "SPRITE_META",
+                    "location": 2,
+                    "type": "vec4<u32>",
+                    "interpolation": "flat"
+                },
+                {
+                    "semantic": "COLOR_0",
+                    "location": 3,
+                    "type": "vec4<f32>",
+                    "interpolation": "flat"
+                },
+                {
+                    "semantic": "COLOR_MATRIX_0",
+                    "location": 4,
+                    "type": "vec4<f32>",
+                    "interpolation": "flat"
+                },
+                {
+                    "semantic": "COLOR_MATRIX_1",
+                    "location": 5,
+                    "type": "vec4<f32>",
+                    "interpolation": "flat"
+                },
+                {
+                    "semantic": "COLOR_MATRIX_2",
+                    "location": 6,
+                    "type": "vec4<f32>",
+                    "interpolation": "flat"
+                }
+            ],
+            "renderTargets": [
+                {
+                    "location": 0,
+                    "formatClass": "color"
+                }
+            ],
+            "capabilities": [
+                "storage-buffer",
+                "texture-load",
+                "texture-sample",
+                "instancing"
+            ],
+            "passRequirements": [
+                "indexed-palette-bank",
+                "truecolor-atlas",
+                "alpha-blend",
+                "rgb-affine-color-matrix"
+            ],
+            "sourceMap": [
+                {
+                    "sourceId": "builtin.indexed-sprite",
+                    "sourceName": "shader-language/builtin-components-2d-ui-family.json",
+                    "generatedStartLine": 1,
+                    "generatedEndLine": 129
+                }
+            ],
+            "canonicalHash": "922becd3e6153801d9de6a87d94d4d8bdde460dfaa73c1327c651942768f35d1"
+        },
         "spine2d": {
             "id": "spine2d",
             "code": spine2dWgsl,
@@ -863,7 +1072,7 @@ const BUILTIN_RENDER_SHADER_ARTIFACT = {
             "canonicalHash": "4d1ef60104af17bdb6c837bbdb67640c96abf7533f156510de4da5240c8c388e"
         }
     },
-    "artifactHash": "16ea1e154dc97e70d112d84e6b5bf5515f95ba9cc10c238efc22f8971239137e"
+    "artifactHash": "13fbee749aa5946580c6c90392b4e2cedc88b288a808a151c8e9bbe297ee9833"
 };
 
 export { BUILTIN_RENDER_SHADER_ARTIFACT };

package/dist/ray-tracing/acceleration/bvh.d.ts

@@ -0,0 +1,37 @@
+import type { RaySceneAnalyticSphere, RaySceneTriangleGeometry, RayVec3 } from '../reference/index.js';
+import type { RayAccelerationDiagnostic, RayAccelerationPhase, RayBlasBuildResult, RayBounds3, RayBvhNode } from './types.js';
+export declare const RAY_ACCELERATION_POLICY: Readonly<{
+    schemaVersion: 1;
+    hierarchy: "deterministic-balanced-binary";
+    split: "largest-centroid-extent-median, primitive/instance identity tie-break";
+    blasLeafCapacity: 4;
+    tlasLeafCapacity: 2;
+    boundsEncoding: "float32 outward rounded at serialization; float64 CPU build";
+    boundsQuantization: "none-v1";
+    traversalStackLimit: 64;
+    overflowBehavior: "abort ray and emit RAY_ACCEL_STACK_OVERFLOW";
+    rationale: readonly string[];
+}>;
+interface BuildItem {
+    readonly sourceIndex: number;
+    readonly stableId: string;
+    readonly bounds: RayBounds3;
+    readonly centroid: RayVec3;
+}
+export interface BuiltHierarchy {
+    readonly rootNode: number;
+    readonly bounds: RayBounds3 | null;
+    readonly nodes: readonly RayBvhNode[];
+    readonly order: readonly number[];
+    readonly maxDepth: number;
+    readonly leafCount: number;
+}
+export declare function buildBlas(geometry: RaySceneTriangleGeometry): RayBlasBuildResult;
+export declare function buildAnalyticSphereBlas(sphere: RaySceneAnalyticSphere): RayBlasBuildResult;
+export declare function buildHierarchy(items: readonly BuildItem[], leafCapacity: number): BuiltHierarchy;
+export declare function blasKey(geometryId: string, revision: number): string;
+export declare function analyticBlasKey(geometryId: string, revision: number, primitiveIndex: number): string;
+export declare function fingerprintTriangleGeometry(geometry: RaySceneTriangleGeometry): string;
+export declare function diagnoseDepth(maxDepth: number, phase: RayAccelerationPhase, diagnostics: RayAccelerationDiagnostic[], context: Record<string, string | number | boolean | null>): void;
+export declare function diagnostic(phase: RayAccelerationPhase, severity: RayAccelerationDiagnostic['severity'], code: string, message: string, context: Record<string, string | number | boolean | null>): RayAccelerationDiagnostic;
+export {};

package/dist/ray-tracing/acceleration/index.d.ts

@@ -0,0 +1,6 @@
+export { RAY_ACCELERATION_POLICY, analyticBlasKey, blasKey, buildAnalyticSphereBlas, buildBlas } from './bvh.js';
+export { RAY_ACCELERATION_ABI_FINGERPRINT, RAY_ACCELERATION_ABI_V1, packAcceleration, validatePackedAcceleration } from './pack.js';
+export { queryRayAccelerationCandidates, validateAccelerationStructure } from './query.js';
+export { RayAccelerationBuilder, RayBlasCache } from './runtime.js';
+export { buildTlas, refitTlas } from './tlas.js';
+export type { RayAccelerationCandidateQuery, RayAccelerationDiagnostic, RayAccelerationPrimitive, RayAccelerationRuntimeStatistics, RayAccelerationSnapshot, RayAccelerationUpdate, RayAccelerationUpdateKind, RayBlas, RayBlasBuildResult, RayBlasStatistics, RayBounds3, RayBvhNode, RayDirtyUploadRange, RayPackedAcceleration, RayPackedAccelerationMemory, RayPackedBuffer, RayPackedBufferName, RayPackResult, RayTlas, RayTlasInstance, RayTlasStatistics, } from './types.js';

package/dist/ray-tracing/acceleration/pack.d.ts

@@ -0,0 +1,152 @@
+import type { RayAccelerationDiagnostic, RayBlas, RayPackedAcceleration, RayPackResult, RayTlas } from './types.js';
+export declare const RAY_ACCELERATION_ABI_V1: {
+    name: string;
+    version: number;
+    endianness: string;
+    indexWidthBits: number;
+    missingIndex: number;
+    maxAddressableIndex: number;
+    traversalStackLimit: 64;
+    stackOverflow: string;
+    buffers: {
+        blasNodes: {
+            stride: number;
+            alignment: number;
+            words: number;
+        };
+        blasTable: {
+            stride: number;
+            alignment: number;
+            words: number;
+        };
+        tlasNodes: {
+            stride: number;
+            alignment: number;
+            words: number;
+        };
+        primitives: {
+            stride: number;
+            alignment: number;
+            words: number;
+        };
+        instances: {
+            stride: number;
+            alignment: number;
+            words: number;
+        };
+        materials: {
+            stride: number;
+            alignment: number;
+            words: number;
+        };
+    };
+    node: {
+        min: {
+            offset: number;
+            format: string;
+        };
+        leftFirst: {
+            offset: number;
+            format: string;
+        };
+        max: {
+            offset: number;
+            format: string;
+        };
+        meta: {
+            offset: number;
+            format: string;
+            leafBit: number;
+        };
+    };
+    blasTable: {
+        rootNode: {
+            offset: number;
+            format: string;
+        };
+        nodeCount: {
+            offset: number;
+            format: string;
+        };
+        primitiveOffset: {
+            offset: number;
+            format: string;
+        };
+        primitiveCount: {
+            offset: number;
+            format: string;
+        };
+    };
+    primitive: {
+        data: {
+            offset: number;
+            format: string;
+        };
+        kind: {
+            offset: number;
+            format: string;
+            triangle: number;
+            sphere: number;
+        };
+        sourcePrimitiveIndex: {
+            offset: number;
+            format: string;
+        };
+        geometryIdentityIndex: {
+            offset: number;
+            format: string;
+        };
+        reserved: {
+            offset: number;
+            format: string;
+        };
+    };
+    instance: {
+        transform: {
+            offset: number;
+            format: string;
+        };
+        inverseTransform: {
+            offset: number;
+            format: string;
+        };
+        blasTableIndex: {
+            offset: number;
+            format: string;
+        };
+        materialIndex: {
+            offset: number;
+            format: string;
+        };
+        identityIndex: {
+            offset: number;
+            format: string;
+        };
+        flags: {
+            offset: number;
+            format: string;
+            analytic: number;
+        };
+    };
+    material: {
+        identityHashLow: {
+            offset: number;
+            format: string;
+        };
+        identityHashHigh: {
+            offset: number;
+            format: string;
+        };
+        revision: {
+            offset: number;
+            format: string;
+        };
+        typeHash: {
+            offset: number;
+            format: string;
+        };
+    };
+};
+export declare const RAY_ACCELERATION_ABI_FINGERPRINT: string;
+export declare function packAcceleration(blases: ReadonlyMap<string, RayBlas>, tlas: RayTlas, maxTotalBytes?: number): RayPackResult;
+export declare function validatePackedAcceleration(packed: RayPackedAcceleration): readonly RayAccelerationDiagnostic[];

package/dist/ray-tracing/acceleration/query.d.ts

@@ -0,0 +1,4 @@
+import type { RayInput } from '../reference/index.js';
+import type { RayAccelerationCandidateQuery, RayAccelerationDiagnostic, RayAccelerationSnapshot } from './types.js';
+export declare function queryRayAccelerationCandidates(acceleration: RayAccelerationSnapshot, input: RayInput): RayAccelerationCandidateQuery;
+export declare function validateAccelerationStructure(acceleration: RayAccelerationSnapshot): readonly RayAccelerationDiagnostic[];

package/dist/ray-tracing/acceleration/runtime.d.ts

@@ -0,0 +1,30 @@
+import type { RaySceneAnalyticSphere, RaySceneTriangleGeometry } from '../reference/index.js';
+import type { RaySceneSnapshot } from '../scene/index.js';
+import type { RayAccelerationRuntimeStatistics, RayAccelerationSnapshot, RayAccelerationUpdate, RayBlasBuildResult } from './types.js';
+export declare class RayBlasCache {
+    private readonly _entries;
+    private _cacheHitCount;
+    private _destroyed;
+    get cacheHitCount(): number;
+    get size(): number;
+    get destroyed(): boolean;
+    get estimatedBytes(): number;
+    getOrBuildGeometry(geometry: RaySceneTriangleGeometry): RayBlasBuildResult;
+    getOrBuildAnalytic(sphere: RaySceneAnalyticSphere): RayBlasBuildResult;
+    retain(keys: ReadonlySet<string>): void;
+    destroy(): void;
+}
+export declare class RayAccelerationBuilder {
+    private _cache;
+    private _current;
+    private _destroyed;
+    private _buildCount;
+    private _refitCount;
+    private _materialUpdateCount;
+    private _peakBytes;
+    get current(): RayAccelerationSnapshot | null;
+    get statistics(): RayAccelerationRuntimeStatistics;
+    update(source: RaySceneSnapshot): RayAccelerationUpdate;
+    rebuild(source: RaySceneSnapshot): RayAccelerationUpdate;
+    destroy(): void;
+}

package/dist/ray-tracing/acceleration/tlas.d.ts

@@ -0,0 +1,4 @@
+import type { RaySceneSnapshot } from '../scene/index.js';
+import type { RayBlas, RayTlas } from './types.js';
+export declare function buildTlas(snapshot: RaySceneSnapshot, blases: ReadonlyMap<string, RayBlas>): RayTlas;
+export declare function refitTlas(previous: RayTlas, snapshot: RaySceneSnapshot, blases: ReadonlyMap<string, RayBlas>): RayTlas | null;