@zephyr3d/scene 0.7.0 → 0.8.0

package/dist/material/sprite3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite3d.js","sources":["../../src/material/sprite3d.ts"],"sourcesContent":["import { MeshMaterial } from './meshmaterial';\r\nimport type { BindGroup, PBFunctionScope, PBInsideFunctionScope } from '@zephyr3d/device';\r\nimport { ShaderHelper } from './shader/helper';\r\nimport { MaterialVaryingFlags } from '../values';\r\nimport type { Clonable, Immutable, Vector2 } from '@zephyr3d/base';\r\nimport { Vector4 } from '@zephyr3d/base';\r\nimport type { DrawContext } from '../render';\r\n\r\n/**\r\n * Sprite3D material base class.\r\n *\r\n * @remarks\r\n * This material renders a camera-facing quad (billboard) in 3D space,\r\n * using UV information and an anchor point to control how the sprite\r\n * is positioned and textured.\r\n *\r\n * Derived classes can override {@link internalSetupUniforms},\r\n * {@link internalApplyUniforms} and\r\n * {@link calcFragmentColor} to provide custom\r\n * uniforms and shading logic (e.g. sampling a texture).\r\n *\r\n * @public\r\n */\r\nexport class Sprite3DMaterial extends MeshMaterial implements Clonable<Sprite3DMaterial> {\r\n  static UVINFO = this.defineInstanceUniform('uvinfo', 'vec4');\r\n  static ANCHOR_ROTATION = this.defineInstanceUniform('anchorRotation', 'vec4');\r\n  private _uvinfo: Vector4;\r\n  private _anchorRotation: Vector4;\r\n  /**\r\n   * Creates a new {@link Sprite3DMaterial} instance.\r\n   *\r\n   * @remarks\r\n   * - Default UV rectangle is the full texture [0, 0, 1, 1].\r\n   * - Default anchor is the center [0.5, 0.5].\r\n   * - Face culling is disabled (`cullMode = 'none'`) so the sprite\r\n   *   is visible from both sides.\r\n   */\r\n  constructor() {\r\n    super();\r\n    this._uvinfo = new Vector4(0, 0, 1, 1);\r\n    this._anchorRotation = new Vector4(0.5, 0.5, 0, 0);\r\n    this.cullMode = 'none';\r\n  }\r\n  /**\r\n   * Gets the UV rectangle of the sprite in the texture.\r\n   *\r\n   * @returns A Vector4 storing \\([u0, v0, u1, v1]\\).\r\n   */\r\n  get uvinfo(): Immutable<Vector4> {\r\n    return this._uvinfo;\r\n  }\r\n  set uvinfo(value: Immutable<Vector4>) {\r\n    if (!value.equalsTo(this.uvinfo)) {\r\n      this._uvinfo.set(value);\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Convenience method to set the UV rectangle via individual components.\r\n   *\r\n   * @param uvx0 - Left (U) coordinate.\r\n   * @param uvy0 - Bottom (V) coordinate.\r\n   * @param uvx1 - Right (U) coordinate.\r\n   * @param uvy1 - Top (V) coordinate.\r\n   */\r\n  setUVInfo(uvx0: number, uvy0: number, uvx1: number, uvy1: number) {\r\n    this.uvinfo = new Vector4(uvx0, uvy0, uvx1, uvy1);\r\n  }\r\n  /**\r\n   * Gets the sprite anchor-rotation.\r\n   *\r\n   * @returns The current anchor-rotation.\r\n   */\r\n  get anchorRotation(): Immutable<Vector4> {\r\n    return this._anchorRotation;\r\n  }\r\n  set anchorRotation(value: Immutable<Vector4>) {\r\n    if (!value.equalsTo(this._anchorRotation)) {\r\n      this._anchorRotation.set(value);\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Gets the sprite anchor point in normalized quad space.\r\n   *\r\n   * @returns The current anchor as a Vector2.\r\n   */\r\n  get anchor(): Immutable<Vector2> {\r\n    return this._anchorRotation.xy();\r\n  }\r\n  set anchor(value: Immutable<Vector2>) {\r\n    if (value.x !== this._anchorRotation.x || value.y !== this._anchorRotation.y) {\r\n      this.anchorRotation = new Vector4(value.x, value.y, this._anchorRotation.z, this._anchorRotation.w);\r\n    }\r\n  }\r\n  /**\r\n   * Gets the sprite rotation around the Z axis.\r\n   *\r\n   * @returns The sprite rotation.\r\n   */\r\n  get rotation() {\r\n    return this._anchorRotation.z;\r\n  }\r\n  set rotation(value) {\r\n    if (value !== this._anchorRotation.z) {\r\n      this.anchorRotation = new Vector4(\r\n        this._anchorRotation.x,\r\n        this._anchorRotation.y,\r\n        value,\r\n        this._anchorRotation.w\r\n      );\r\n    }\r\n  }\r\n  /**\r\n   * Gets the X component of the sprite anchor.\r\n   */\r\n  get anchorX() {\r\n    return this._anchorRotation.x;\r\n  }\r\n  set anchorX(value) {\r\n    if (this._anchorRotation.x !== value) {\r\n      this.anchorRotation = new Vector4(\r\n        value,\r\n        this._anchorRotation.y,\r\n        this._anchorRotation.z,\r\n        this._anchorRotation.w\r\n      );\r\n    }\r\n  }\r\n  /**\r\n   * Gets the Y component of the sprite anchor.\r\n   */\r\n  get anchorY() {\r\n    return this._anchorRotation.y;\r\n  }\r\n  set anchorY(value) {\r\n    if (this._anchorRotation.y !== value) {\r\n      this.anchorRotation = new Vector4(\r\n        this._anchorRotation.x,\r\n        value,\r\n        this._anchorRotation.z,\r\n        this._anchorRotation.w\r\n      );\r\n    }\r\n  }\r\n  /**\r\n   * Convenience method to set both anchor components at once.\r\n   *\r\n   * @param anchorX - X coordinate of the anchor.\r\n   * @param anchorY - Y coordinate of the anchor.\r\n   */\r\n  setAnchor(anchorX: number, anchorY: number) {\r\n    if (this._anchorRotation.x !== anchorX || this._anchorRotation.y !== anchorY) {\r\n      this.anchorRotation = new Vector4(anchorX, anchorY, this._anchorRotation.z, this._anchorRotation.w);\r\n    }\r\n  }\r\n  /**\r\n   * Creates a deep copy of this material.\r\n   *\r\n   * @returns A new {@link Sprite3DMaterial} instance with the same properties.\r\n   */\r\n  clone() {\r\n    const other = new Sprite3DMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copies all relevant state from another {@link Sprite3DMaterial}.\r\n   *\r\n   * @param other - The source material to copy from.\r\n   */\r\n  copyFrom(other: this) {\r\n    super.copyFrom(other);\r\n    this.uvinfo = other.uvinfo;\r\n    this.anchorRotation = other.anchorRotation;\r\n  }\r\n  /**\r\n   * Builds the vertex shader for this material.\r\n   *\r\n   * @remarks\r\n   * This method:\r\n   * - Calls the base implementation.\r\n   * - Computes per-vertex positions for a camera-facing quad (billboard)\r\n   *   based on the sprite's world transform, size, and anchor.\r\n   * - Selects the correct UV coordinates for each quad corner using\r\n   *   the `vertexId` attribute.\r\n   * - Outputs world-space position (`zWorldPos`) and UVs (`zVertexUV`)\r\n   *   for use in the fragment shader.\r\n   *\r\n   * @param scope - The current programmable builder function scope.\r\n   */\r\n  vertexShader(scope: PBFunctionScope) {\r\n    super.vertexShader(scope);\r\n    const pb = scope.$builder;\r\n    scope.$inputs.vertexId = pb.float().attrib('position');\r\n    if (this.drawContext.materialFlags & MaterialVaryingFlags.INSTANCING) {\r\n      scope.$l.uvinfo = this.getInstancedUniform(scope, Sprite3DMaterial.UVINFO);\r\n      scope.$l.anchorRotation = this.getInstancedUniform(scope, Sprite3DMaterial.ANCHOR_ROTATION);\r\n    } else {\r\n      scope.uvinfo = pb.vec4().uniform(2);\r\n      scope.anchorRotation = pb.vec4().uniform(2);\r\n    }\r\n    this.internalSetupUniforms(scope);\r\n    scope.$l.worldPos = ShaderHelper.getWorldMatrix(scope)[3].xyz;\r\n    scope.$l.width = pb.sqrt(\r\n      pb.dot(ShaderHelper.getWorldMatrix(scope)[0].xyz, ShaderHelper.getWorldMatrix(scope)[0].xyz)\r\n    );\r\n    scope.$l.height = pb.sqrt(\r\n      pb.dot(ShaderHelper.getWorldMatrix(scope)[1].xyz, ShaderHelper.getWorldMatrix(scope)[1].xyz)\r\n    );\r\n    const viewMatrix = ShaderHelper.getViewMatrix(scope);\r\n    scope.$l.forward = pb.vec3(viewMatrix[0].z, viewMatrix[1].z, viewMatrix[2].z);\r\n    scope.$l.axis = scope.$choice(\r\n      pb.lessThan(pb.abs(scope.forward.y), 0.999),\r\n      pb.vec3(0, 1, 0),\r\n      pb.vec3(1, 0, 0)\r\n    );\r\n    scope.$l.right = pb.normalize(pb.cross(scope.axis, scope.forward));\r\n    scope.$l.up = pb.normalize(pb.cross(scope.forward, scope.right));\r\n    scope.$l.rotateAngle = scope.anchorRotation.z;\r\n    scope.$l.c = pb.cos(scope.rotateAngle);\r\n    scope.$l.s = pb.sin(scope.rotateAngle);\r\n    scope.$l.rightRot = pb.add(pb.mul(scope.up, scope.s), pb.mul(scope.right, scope.c));\r\n    scope.$l.upRot = pb.sub(pb.mul(scope.up, scope.c), pb.mul(scope.right, scope.s));\r\n    scope.$l.v = pb.vec2();\r\n    scope.$l.uv = pb.vec2();\r\n    scope.$l.anchor = scope.anchorRotation.xy;\r\n    scope\r\n      .$if(pb.equal(scope.$inputs.vertexId, 0), function () {\r\n        scope.v = pb.neg(scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.y));\r\n      })\r\n      .$elseif(pb.equal(scope.$inputs.vertexId, 1), function () {\r\n        scope.v = pb.sub(pb.vec2(1, 0), scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.y));\r\n      })\r\n      .$elseif(pb.equal(scope.$inputs.vertexId, 2), function () {\r\n        scope.v = pb.sub(pb.vec2(0, 1), scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.w));\r\n      })\r\n      .$else(function () {\r\n        scope.v = pb.sub(pb.vec2(1), scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.w));\r\n      });\r\n    scope.v = pb.mul(scope.v, pb.vec2(scope.width, scope.height));\r\n    scope.$outputs.zWorldPos = pb.add(\r\n      scope.worldPos,\r\n      pb.mul(scope.rightRot, scope.v.x),\r\n      pb.mul(scope.upRot, scope.v.y)\r\n    );\r\n    scope.$outputs.zVertexUV = scope.uv;\r\n    ShaderHelper.setClipSpacePosition(\r\n      scope,\r\n      pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.$outputs.zWorldPos, 1))\r\n    );\r\n  }\r\n  /**\r\n   * Builds the fragment shader for this material.\r\n   *\r\n   * @remarks\r\n   * This method:\r\n   * - Calls the base implementation.\r\n   * - Invokes {@link Sprite3DMaterial.internalSetupUniforms} for\r\n   *   fragment-stage specific uniform declarations.\r\n   * - Computes fragment color by calling {@link Sprite3DMaterial.calcFragmentColor}\r\n   *   if fragment color is needed.\r\n   * - Outputs the final fragment color via {@link MeshMaterial.outputFragmentColor}.\r\n   *\r\n   * @param scope - The current programmable builder function scope.\r\n   */\r\n  fragmentShader(scope: PBFunctionScope) {\r\n    super.fragmentShader(scope);\r\n    this.internalSetupUniforms(scope);\r\n    if (this.needFragmentColor()) {\r\n      scope.$l.color = this.calcFragmentColor(scope);\r\n      this.outputFragmentColor(scope, scope.$inputs.zWorldPos, scope.color);\r\n    } else {\r\n      this.outputFragmentColor(scope, scope.$inputs.zWorldPos, null);\r\n    }\r\n  }\r\n  /**\r\n   * Applies runtime uniform values to the given bind group before drawing.\r\n   *\r\n   * @remarks\r\n   * This binds:\r\n   * - UV information (`uvinfo`)\r\n   * - Anchor (`anchor`)\r\n   *\r\n   * for non-instanced rendering. For instanced rendering, these values\r\n   * are expected to be provided as per-instance uniforms instead.\r\n   *\r\n   * It also calls {@link Sprite3DMaterial.internalApplyUniforms} to allow\r\n   * derived classes to bind additional resources (e.g. textures).\r\n   *\r\n   * @param bindGroup - The bind group to which uniforms and resources are bound.\r\n   * @param ctx - The current draw context providing rendering state.\r\n   * @param pass - Index of the active render pass.\r\n   */\r\n  applyUniformValues(bindGroup: BindGroup, ctx: DrawContext, pass: number) {\r\n    super.applyUniformValues(bindGroup, ctx, pass);\r\n    if (!(ctx.materialFlags & MaterialVaryingFlags.INSTANCING)) {\r\n      bindGroup.setValue('uvinfo', this._uvinfo);\r\n      bindGroup.setValue('anchorRotation', this._anchorRotation);\r\n    }\r\n    this.internalApplyUniforms(bindGroup, ctx, pass);\r\n  }\r\n  /**\r\n   * Hook for derived classes to declare additional uniforms.\r\n   *\r\n   * @remarks\r\n   * This is invoked in both the vertex and fragment shader construction\r\n   * phases, allowing subclasses to register extra uniforms or resources\r\n   * needed by their custom shading logic.\r\n   *\r\n   * The base implementation does nothing.\r\n   *\r\n   * @param _scope - The current shader function scope.\r\n   */\r\n  protected internalSetupUniforms(_scope: PBInsideFunctionScope) {}\r\n  /**\r\n   * Hook for derived classes to bind additional uniform values or resources.\r\n   *\r\n   * @remarks\r\n   * This is called from {@link Sprite3DMaterial.applyUniformValues} and is\r\n   * intended for subclasses to bind their own textures, samplers, or\r\n   * other GPU resources.\r\n   *\r\n   * The base implementation does nothing.\r\n   *\r\n   * @param _bindGroup - The bind group used for binding uniforms and resources.\r\n   * @param _ctx - The current draw context.\r\n   * @param _pass - Index of the active render pass.\r\n   */\r\n  protected internalApplyUniforms(_bindGroup: BindGroup, _ctx: DrawContext, _pass: number) {}\r\n  /**\r\n   * Computes the fragment color expression for this material.\r\n   *\r\n   * @remarks\r\n   * The default implementation simply outputs the interpolated UV\r\n   * coordinates as color \\([u, v, 0, 1]\\), which is mainly useful\r\n   * for debugging.\r\n   *\r\n   * Derived classes are expected to override this method to implement\r\n   * actual shading, such as sampling a texture.\r\n   *\r\n   * @param scope - The current shader function scope.\r\n   * @returns A shader expression representing the fragment color.\r\n\r\n   */\r\n  protected calcFragmentColor(scope: PBInsideFunctionScope) {\r\n    return scope.$builder.vec4(scope.$inputs.zVertexUV, 0, 1);\r\n  }\r\n}\r\n"],"names":["Sprite3DMaterial","MeshMaterial","UVINFO","defineInstanceUniform","ANCHOR_ROTATION","_uvinfo","_anchorRotation","Vector4","cullMode","uvinfo","value","equalsTo","set","uniformChanged","setUVInfo","uvx0","uvy0","uvx1","uvy1","anchorRotation","anchor","xy","x","y","z","w","rotation","anchorX","anchorY","setAnchor","clone","other","copyFrom","vertexShader","scope","pb","$builder","$inputs","vertexId","float","attrib","drawContext","materialFlags","MaterialVaryingFlags","INSTANCING","$l","getInstancedUniform","vec4","uniform","internalSetupUniforms","worldPos","ShaderHelper","getWorldMatrix","xyz","width","sqrt","dot","height","viewMatrix","getViewMatrix","forward","vec3","axis","$choice","lessThan","abs","right","normalize","cross","up","rotateAngle","c","cos","s","sin","rightRot","add","mul","upRot","sub","v","vec2","uv","$if","equal","neg","$elseif","$else","$outputs","zWorldPos","zVertexUV","setClipSpacePosition","getViewProjectionMatrix","fragmentShader","needFragmentColor","color","calcFragmentColor","outputFragmentColor","applyUniformValues","bindGroup","ctx","pass","setValue","internalApplyUniforms","_scope","_bindGroup","_ctx","_pass"],"mappings":"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"}

package/dist/material/sprite3d_std.js

@@ -0,0 +1,116 @@
+import { DRef } from '@zephyr3d/base';
+import { Sprite3DMaterial } from './sprite3d.js';
+import { fetchSampler } from '../utility/misc.js';
+
+/**
+ * Standard Sprite3D material
+ * @public
+ */ class StandardSprite3DMaterial extends Sprite3DMaterial {
+    static FEATURE_SPRITE_TEXTURE = this.defineFeature();
+    _texture;
+    /**
+   * Creates a new instance of {@link StandardSprite3DMaterial}.
+   *
+   * @remarks
+   * By default, no sprite texture is assigned and the material renders
+   * as solid white until a texture is set.
+   */ constructor(){
+        super();
+        this._texture = new DRef();
+    }
+    /**
+   * Gets the 2D texture used by this sprite material.
+   *
+   * @returns The current sprite texture, or `null` if no texture is assigned.
+   */ get spriteTexture() {
+        return this._texture.get();
+    }
+    set spriteTexture(tex) {
+        tex = tex ?? null;
+        if (tex !== this._texture.get()) {
+            this._texture.set(tex);
+            this.useFeature(StandardSprite3DMaterial.FEATURE_SPRITE_TEXTURE, !!tex);
+            this.uniformChanged();
+        }
+    }
+    /**
+   * Creates a deep copy of this material instance.
+   *
+   * @remarks
+   * The new instance will copy all relevant state from this material,
+   * including the assigned sprite texture reference.
+   *
+   * @returns A new {@link StandardSprite3DMaterial} instance with the same settings.
+   */ clone() {
+        const other = new StandardSprite3DMaterial();
+        other.copyFrom(this);
+        return other;
+    }
+    /**
+   * Copies the state from another {@link StandardSprite3DMaterial} into this instance.
+   *
+   * @param other - The source material to copy from.
+   */ copyFrom(other) {
+        super.copyFrom(other);
+        this.spriteTexture = other.spriteTexture;
+    }
+    /**
+   * Applies runtime uniform values to the given bind group before drawing.
+   *
+   * @remarks
+   * This method is called by the rendering pipeline to bind GPU resources
+   * (such as textures and samplers) associated with this material.
+   *
+   * @param bindGroup - The bind group to which uniforms and resources are bound.
+   * @param ctx - The current draw context providing rendering-state information.
+   *
+   */ internalApplyUniforms(bindGroup, ctx) {
+        if (this.spriteTexture && this.needFragmentColor(ctx)) {
+            bindGroup.setTexture('zSpriteTexture', this.spriteTexture, fetchSampler('clamp_linear'));
+        }
+    }
+    /**
+   * Declares and configures shader uniforms for this material in the current scope.
+   *
+   * @remarks
+   * This is executed during shader construction. If the active shader stage
+   * is a fragment shader, and the material requires fragment color and has
+   * a sprite texture assigned, a 2D texture uniform named `zSpriteTexture`
+   * is added to the program.
+   *
+   * @param scope - The current shader function scope used to build the program.
+   */ internalSetupUniforms(scope) {
+        const pb = scope.$builder;
+        if (pb.shaderKind === 'fragment' && this.spriteTexture && this.needFragmentColor()) {
+            scope.zSpriteTexture = pb.tex2D().uniform(2);
+        }
+    }
+    /**
+   * Computes the fragment color expression for this material within the shader.
+   *
+   * @remarks
+   * - If a sprite texture is assigned, this samples the texture using
+   *   the interpolated vertex UV coordinates (`zVertexUV`).
+   * - If no texture is assigned, this returns a solid white color.
+   *
+   * @param scope - The current shader function scope providing inputs and uniforms.
+   * @returns A shader expression representing the computed fragment color.
+   */ calcFragmentColor(scope) {
+        const pb = scope.$builder;
+        return this.spriteTexture ? pb.textureSample(scope.zSpriteTexture, scope.$inputs.zVertexUV) : pb.vec4(1);
+    }
+    /**
+   * Releases resources held by this material instance.
+   *
+   * @remarks
+   * This is called when the material is disposed. It forwards the dispose
+   * call to the internal texture reference so that the associated GPU
+   * resource can be released.
+   */ onDispose() {
+        super.onDispose();
+        this._texture.dispose();
+    }
+}
+
+export { StandardSprite3DMaterial };
+//# sourceMappingURL=sprite3d_std.js.map

package/dist/material/sprite3d_std.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite3d_std.js","sources":["../../src/material/sprite3d_std.ts"],"sourcesContent":["import type { BindGroup, PBInsideFunctionScope, Texture2D } from '@zephyr3d/device';\r\nimport type { Clonable } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport type { DrawContext } from '../render/drawable';\r\nimport { Sprite3DMaterial } from './sprite3d';\r\nimport { fetchSampler } from '../utility/misc';\r\n\r\n/**\r\n * Standard Sprite3D material\r\n * @public\r\n */\r\nexport class StandardSprite3DMaterial extends Sprite3DMaterial implements Clonable<StandardSprite3DMaterial> {\r\n  static FEATURE_SPRITE_TEXTURE = this.defineFeature();\r\n  protected _texture: DRef<Texture2D>;\r\n  /**\r\n   * Creates a new instance of {@link StandardSprite3DMaterial}.\r\n   *\r\n   * @remarks\r\n   * By default, no sprite texture is assigned and the material renders\r\n   * as solid white until a texture is set.\r\n   */\r\n  constructor() {\r\n    super();\r\n    this._texture = new DRef();\r\n  }\r\n  /**\r\n   * Gets the 2D texture used by this sprite material.\r\n   *\r\n   * @returns The current sprite texture, or `null` if no texture is assigned.\r\n   */\r\n  get spriteTexture() {\r\n    return this._texture.get();\r\n  }\r\n  set spriteTexture(tex) {\r\n    tex = tex ?? null;\r\n    if (tex !== this._texture.get()) {\r\n      this._texture.set(tex);\r\n      this.useFeature(StandardSprite3DMaterial.FEATURE_SPRITE_TEXTURE, !!tex);\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Creates a deep copy of this material instance.\r\n   *\r\n   * @remarks\r\n   * The new instance will copy all relevant state from this material,\r\n   * including the assigned sprite texture reference.\r\n   *\r\n   * @returns A new {@link StandardSprite3DMaterial} instance with the same settings.\r\n   */\r\n  clone() {\r\n    const other = new StandardSprite3DMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copies the state from another {@link StandardSprite3DMaterial} into this instance.\r\n   *\r\n   * @param other - The source material to copy from.\r\n   */\r\n  copyFrom(other: this) {\r\n    super.copyFrom(other);\r\n    this.spriteTexture = other.spriteTexture;\r\n  }\r\n  /**\r\n   * Applies runtime uniform values to the given bind group before drawing.\r\n   *\r\n   * @remarks\r\n   * This method is called by the rendering pipeline to bind GPU resources\r\n   * (such as textures and samplers) associated with this material.\r\n   *\r\n   * @param bindGroup - The bind group to which uniforms and resources are bound.\r\n   * @param ctx - The current draw context providing rendering-state information.\r\n   *\r\n   */\r\n  protected internalApplyUniforms(bindGroup: BindGroup, ctx: DrawContext) {\r\n    if (this.spriteTexture && this.needFragmentColor(ctx)) {\r\n      bindGroup.setTexture('zSpriteTexture', this.spriteTexture, fetchSampler('clamp_linear'));\r\n    }\r\n  }\r\n  /**\r\n   * Declares and configures shader uniforms for this material in the current scope.\r\n   *\r\n   * @remarks\r\n   * This is executed during shader construction. If the active shader stage\r\n   * is a fragment shader, and the material requires fragment color and has\r\n   * a sprite texture assigned, a 2D texture uniform named `zSpriteTexture`\r\n   * is added to the program.\r\n   *\r\n   * @param scope - The current shader function scope used to build the program.\r\n   */\r\n  protected internalSetupUniforms(scope: PBInsideFunctionScope) {\r\n    const pb = scope.$builder;\r\n    if (pb.shaderKind === 'fragment' && this.spriteTexture && this.needFragmentColor()) {\r\n      scope.zSpriteTexture = pb.tex2D().uniform(2);\r\n    }\r\n  }\r\n  /**\r\n   * Computes the fragment color expression for this material within the shader.\r\n   *\r\n   * @remarks\r\n   * - If a sprite texture is assigned, this samples the texture using\r\n   *   the interpolated vertex UV coordinates (`zVertexUV`).\r\n   * - If no texture is assigned, this returns a solid white color.\r\n   *\r\n   * @param scope - The current shader function scope providing inputs and uniforms.\r\n   * @returns A shader expression representing the computed fragment color.\r\n   */\r\n  protected calcFragmentColor(scope: PBInsideFunctionScope) {\r\n    const pb = scope.$builder;\r\n    return this.spriteTexture ? pb.textureSample(scope.zSpriteTexture, scope.$inputs.zVertexUV) : pb.vec4(1);\r\n  }\r\n  /**\r\n   * Releases resources held by this material instance.\r\n   *\r\n   * @remarks\r\n   * This is called when the material is disposed. It forwards the dispose\r\n   * call to the internal texture reference so that the associated GPU\r\n   * resource can be released.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._texture.dispose();\r\n  }\r\n}\r\n"],"names":["StandardSprite3DMaterial","Sprite3DMaterial","FEATURE_SPRITE_TEXTURE","defineFeature","_texture","DRef","spriteTexture","get","tex","set","useFeature","uniformChanged","clone","other","copyFrom","internalApplyUniforms","bindGroup","ctx","needFragmentColor","setTexture","fetchSampler","internalSetupUniforms","scope","pb","$builder","shaderKind","zSpriteTexture","tex2D","uniform","calcFragmentColor","textureSample","$inputs","zVertexUV","vec4","onDispose","dispose"],"mappings":";;;;AAOA;;;IAIO,MAAMA,wBAAiCC,SAAAA,gBAAAA,CAAAA;AAC5C,IAAA,OAAOC,sBAAyB,GAAA,IAAI,CAACC,aAAa,EAAG;IAC3CC,QAA0B;AACpC;;;;;;AAMC,MACD,WAAc,EAAA;QACZ,KAAK,EAAA;QACL,IAAI,CAACA,QAAQ,GAAG,IAAIC,IAAAA,EAAAA;AACtB;AACA;;;;AAIC,MACD,IAAIC,aAAgB,GAAA;AAClB,QAAA,OAAO,IAAI,CAACF,QAAQ,CAACG,GAAG,EAAA;AAC1B;IACA,IAAID,aAAAA,CAAcE,GAAG,EAAE;AACrBA,QAAAA,GAAAA,GAAMA,GAAO,IAAA,IAAA;AACb,QAAA,IAAIA,QAAQ,IAAI,CAACJ,QAAQ,CAACG,GAAG,EAAI,EAAA;AAC/B,YAAA,IAAI,CAACH,QAAQ,CAACK,GAAG,CAACD,GAAAA,CAAAA;AAClB,YAAA,IAAI,CAACE,UAAU,CAACV,yBAAyBE,sBAAsB,EAAE,CAAC,CAACM,GAAAA,CAAAA;AACnE,YAAA,IAAI,CAACG,cAAc,EAAA;AACrB;AACF;AACA;;;;;;;;AAQC,MACDC,KAAQ,GAAA;AACN,QAAA,MAAMC,QAAQ,IAAIb,wBAAAA,EAAAA;QAClBa,KAAMC,CAAAA,QAAQ,CAAC,IAAI,CAAA;QACnB,OAAOD,KAAAA;AACT;AACA;;;;MAKAC,QAAAA,CAASD,KAAW,EAAE;AACpB,QAAA,KAAK,CAACC,QAASD,CAAAA,KAAAA,CAAAA;AACf,QAAA,IAAI,CAACP,aAAa,GAAGO,KAAAA,CAAMP,aAAa;AAC1C;AACA;;;;;;;;;;AAUC,MACD,qBAAUS,CAAsBC,SAAoB,EAAEC,GAAgB,EAAE;QACtE,IAAI,IAAI,CAACX,aAAa,IAAI,IAAI,CAACY,iBAAiB,CAACD,GAAM,CAAA,EAAA;AACrDD,YAAAA,SAAAA,CAAUG,UAAU,CAAC,gBAAA,EAAkB,IAAI,CAACb,aAAa,EAAEc,YAAa,CAAA,cAAA,CAAA,CAAA;AAC1E;AACF;AACA;;;;;;;;;;MAWUC,qBAAsBC,CAAAA,KAA4B,EAAE;QAC5D,MAAMC,EAAAA,GAAKD,MAAME,QAAQ;QACzB,IAAID,EAAAA,CAAGE,UAAU,KAAK,UAAc,IAAA,IAAI,CAACnB,aAAa,IAAI,IAAI,CAACY,iBAAiB,EAAI,EAAA;AAClFI,YAAAA,KAAAA,CAAMI,cAAc,GAAGH,EAAAA,CAAGI,KAAK,EAAA,CAAGC,OAAO,CAAC,CAAA,CAAA;AAC5C;AACF;AACA;;;;;;;;;;MAWUC,iBAAkBP,CAAAA,KAA4B,EAAE;QACxD,MAAMC,EAAAA,GAAKD,MAAME,QAAQ;AACzB,QAAA,OAAO,IAAI,CAAClB,aAAa,GAAGiB,EAAAA,CAAGO,aAAa,CAACR,KAAAA,CAAMI,cAAc,EAAEJ,MAAMS,OAAO,CAACC,SAAS,CAAIT,GAAAA,EAAAA,CAAGU,IAAI,CAAC,CAAA,CAAA;AACxG;AACA;;;;;;;AAOC,MACD,SAAsB,GAAA;AACpB,QAAA,KAAK,CAACC,SAAAA,EAAAA;QACN,IAAI,CAAC9B,QAAQ,CAAC+B,OAAO,EAAA;AACvB;AACF;;;;"}

package/dist/material/sprite3dblueprint.js

@@ -0,0 +1,235 @@
+import { DRef, Vector4 } from '@zephyr3d/base';
+import { Sprite3DBlockNode } from '../utility/blueprint/material/pbr.js';
+import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
+import { Sprite3DMaterial } from './sprite3d.js';
+
+/**
+ * Sprite3D material driven by a blueprint graph.
+ *
+ * @remarks
+ * This material extends {@link Sprite3DMaterial} and uses a
+ * {@link MaterialBlueprintIR} fragment graph to compute the final
+ * sprite color. All fragment shading logic is defined in the
+ * blueprint instead of being hard-coded in the material.
+ *
+ * @public
+ */ class Sprite3DBlueprintMaterial extends Sprite3DMaterial {
+    /** @internal */ _irFrag;
+    /** @internal */ _uniformValues;
+    /** @internal */ _uniformTextures;
+    /**
+   * Creates a new {@link Sprite3DBlueprintMaterial} instance.
+   *
+   * @param irFrag - Optional fragment blueprint IR. If omitted, a default
+   *   IR containing a single {@link Sprite3DBlockNode} is created.
+   * @param uniformValues - Optional initial list of uniform value descriptors.
+   * @param uniformTextures - Optional initial list of texture uniform descriptors.
+   */ constructor(irFrag, uniformValues, uniformTextures){
+        super();
+        this._irFrag = irFrag ?? new MaterialBlueprintIR({
+            nodeMap: {
+                '1': new Sprite3DBlockNode()
+            },
+            roots: [
+                1
+            ],
+            order: [
+                1
+            ],
+            graph: {
+                incoming: {},
+                outgoing: {}
+            }
+        }, '', {
+            nodes: [
+                {
+                    id: 1,
+                    title: '',
+                    locked: true,
+                    node: {
+                        ClassName: 'Sprite3DBlockNode',
+                        Object: ''
+                    }
+                }
+            ],
+            links: []
+        });
+        this._uniformValues = uniformValues ?? [];
+        this._uniformTextures = uniformTextures ?? [];
+    }
+    /**
+   * Gets the fragment blueprint IR used to generate the fragment shader.
+   */ get fragmentIR() {
+        return this._irFrag;
+    }
+    set fragmentIR(ir) {
+        if (ir && ir !== this._irFrag) {
+            this._irFrag = ir;
+            this.clearCache();
+            this.optionChanged(true);
+        }
+    }
+    /**
+   * Gets the list of uniform value descriptors used by the blueprint.
+   */ get uniformValues() {
+        return this._uniformValues;
+    }
+    set uniformValues(val) {
+        this._uniformValues = (val ?? []).map((v)=>({
+                ...v
+            }));
+        this.uniformChanged();
+    }
+    /**
+   * Gets the list of texture uniform descriptors used by the blueprint.
+   */ get uniformTextures() {
+        return this._uniformTextures;
+    }
+    set uniformTextures(val) {
+        val = val ?? [];
+        if (val !== this._uniformTextures) {
+            const newUniforms = val.map((v)=>({
+                    finalTexture: new DRef(v.finalTexture.get()),
+                    finalSampler: v.finalSampler,
+                    name: v.name,
+                    params: v.params?.clone() ?? Vector4.zero(),
+                    texture: v.texture,
+                    type: v.type,
+                    sRGB: v.sRGB,
+                    wrapS: v.wrapS,
+                    wrapT: v.wrapT,
+                    inFragmentShader: v.inFragmentShader,
+                    inVertexShader: v.inVertexShader,
+                    minFilter: v.minFilter,
+                    magFilter: v.magFilter,
+                    mipFilter: v.mipFilter
+                }));
+            for (const u of this._uniformTextures){
+                u.finalTexture.dispose();
+            }
+            this._uniformTextures = newUniforms;
+            this.uniformChanged();
+        }
+    }
+    /**
+   * Creates a deep copy of this blueprint material.
+   *
+   * @remarks
+   * The clone shares the same fragment IR reference and copies the
+   * current uniform descriptors, then calls {@link Sprite3DMaterial.copyFrom}
+   * to copy base-class state.
+   *
+   * @returns A new {@link Sprite3DBlueprintMaterial} instance.
+   */ clone() {
+        const other = new Sprite3DBlueprintMaterial(this._irFrag, this._uniformValues, this._uniformTextures);
+        other.copyFrom(this);
+        return other;
+    }
+    /**
+   * Applies runtime uniform values and textures to the given bind group.
+   *
+   * @remarks
+   * - Calls the base implementation to bind sprite-related uniforms first.
+   * - If fragment color is needed for the current context, all blueprint
+   *   uniform values and textures are then bound by name:
+   *   - `uniformValues` via `bindGroup.setValue`.
+   *   - `uniformTextures` via `bindGroup.setTexture`.
+   *
+   * @param bindGroup - The bind group to bind material resources to.
+   * @param ctx - The current draw context.
+   * @param pass - Index of the active render pass.
+   */ applyUniformValues(bindGroup, ctx, pass) {
+        super.applyUniformValues(bindGroup, ctx, pass);
+        if (this.needFragmentColor(ctx)) {
+            for (const u of this._uniformValues){
+                bindGroup.setValue(u.name, u.finalValue);
+            }
+            for (const u of this._uniformTextures){
+                bindGroup.setTexture(u.name, u.finalTexture.get(), u.finalSampler);
+            }
+        }
+    }
+    /**
+   * Computes the fragment color by invoking the blueprint-generated function.
+   *
+   * @remarks
+   * - A helper function `zCalcSpriteColor(zWorldPos, zVertexUV)` is declared
+   *   on the shader builder using the current fragment IR.
+   * - The blueprint IR is asked to create its node network via
+   *   {@link MaterialBlueprintIR.create}, and the output named `"Color"`
+   *   is used as the return value.
+   * - The resulting function is invoked with the current world position and
+   *   UV coordinates for each fragment.
+   *
+   * @param scope - The current fragment shader function scope.
+   * @returns A shader expression representing the final fragment color.
+   */ calcFragmentColor(scope) {
+        const pb = scope.$builder;
+        const that = this;
+        pb.func('zCalcSpriteColor', [
+            pb.vec3('zWorldPos'),
+            pb.vec2('zVertexUV')
+        ], function() {
+            const outputs = that._irFrag.create(pb);
+            this.$return(that.getOutput(outputs, 'Color'));
+        });
+        return scope.zCalcSpriteColor(scope.$inputs.zWorldPos, scope.$inputs.zVertexUV);
+    }
+    /**
+   * Creates a unique hash string used for program caching.
+   *
+   * @remarks
+   * The hash includes the base {@link Sprite3DMaterial} hash and the
+   * fragment IR hash, so that different blueprints will produce
+   * different shader programs.
+   *
+   * @returns A hash string that identifies this material configuration.
+   */ _createHash() {
+        return `${super._createHash()}:${this._irFrag.hash}`;
+    }
+    /**
+   * Creates the GPU program for this material.
+   *
+   * @remarks
+   * This simply delegates to the base implementation and returns its result.
+   * Commented-out logging lines are available for debugging the generated
+   * vertex and fragment shader sources.
+   *
+   * @param ctx - The current draw context.
+   * @param pass - Index of the active material pass.
+   * @returns The created GPU program.
+   */ createProgram(ctx, pass) {
+        const program = super.createProgram(ctx, pass);
+        //console.log(program.getShaderSource('vertex'));
+        //console.log(program.getShaderSource('fragment'));
+        return program;
+    }
+    /**
+   * Disposes resources associated with this material.
+   *
+   * @remarks
+   * - Calls the base `onDispose` to clean up inherited resources.
+   * - Disposes all `finalTexture` references from the blueprint texture
+   *   uniform descriptors.
+   *
+   * This method is intended to be called by the engine's resource management
+   * system rather than directly from user code.
+   */ onDispose() {
+        super.onDispose();
+        for (const u of this._uniformTextures){
+            u.finalTexture.dispose();
+        }
+    }
+    /**
+   * Retrieves a named output expression from a blueprint output list.
+   *
+   * @param outputs - List of outputs generated by the blueprint graph.
+   * @param name - Name of the output to look for (e.g. `"Color"`).
+   * @returns The matching output expression, or `undefined` if not found.
+   */ getOutput(outputs, name) {
+        return outputs.find((output)=>output.name === name)?.exp;
+    }
+}
+
+export { Sprite3DBlueprintMaterial };
+//# sourceMappingURL=sprite3dblueprint.js.map

package/dist/material/sprite3dblueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite3dblueprint.js","sources":["../../src/material/sprite3dblueprint.ts"],"sourcesContent":["import { DRef, Vector4 } from '@zephyr3d/base';\r\nimport { type BluePrintUniformTexture, type BluePrintUniformValue } from '../utility/blueprint/material/ir';\r\nimport { Sprite3DBlockNode } from '../utility/blueprint/material/pbr';\r\nimport { MaterialBlueprintIR } from '../utility/blueprint/material/ir';\r\nimport { Sprite3DMaterial } from './sprite3d';\r\nimport type { BindGroup, PBInsideFunctionScope, PBShaderExp } from '@zephyr3d/device';\r\nimport type { DrawContext } from '../render';\r\n\r\n/**\r\n * Sprite3D material driven by a blueprint graph.\r\n *\r\n * @remarks\r\n * This material extends {@link Sprite3DMaterial} and uses a\r\n * {@link MaterialBlueprintIR} fragment graph to compute the final\r\n * sprite color. All fragment shading logic is defined in the\r\n * blueprint instead of being hard-coded in the material.\r\n *\r\n * @public\r\n */\r\nexport class Sprite3DBlueprintMaterial extends Sprite3DMaterial {\r\n  /** @internal */\r\n  private _irFrag: MaterialBlueprintIR;\r\n  /** @internal */\r\n  private _uniformValues: BluePrintUniformValue[];\r\n  /** @internal */\r\n  private _uniformTextures: BluePrintUniformTexture[];\r\n  /**\r\n   * Creates a new {@link Sprite3DBlueprintMaterial} instance.\r\n   *\r\n   * @param irFrag - Optional fragment blueprint IR. If omitted, a default\r\n   *   IR containing a single {@link Sprite3DBlockNode} is created.\r\n   * @param uniformValues - Optional initial list of uniform value descriptors.\r\n   * @param uniformTextures - Optional initial list of texture uniform descriptors.\r\n   */\r\n  constructor(\r\n    irFrag?: MaterialBlueprintIR,\r\n    uniformValues?: BluePrintUniformValue[],\r\n    uniformTextures?: BluePrintUniformTexture[]\r\n  ) {\r\n    super();\r\n    this._irFrag =\r\n      irFrag ??\r\n      new MaterialBlueprintIR(\r\n        {\r\n          nodeMap: { '1': new Sprite3DBlockNode() },\r\n          roots: [1],\r\n          order: [1],\r\n          graph: { incoming: {}, outgoing: {} }\r\n        },\r\n        '',\r\n        {\r\n          nodes: [{ id: 1, title: '', locked: true, node: { ClassName: 'Sprite3DBlockNode', Object: '' } }],\r\n          links: []\r\n        }\r\n      );\r\n    this._uniformValues = uniformValues ?? [];\r\n    this._uniformTextures = uniformTextures ?? [];\r\n  }\r\n  /**\r\n   * Gets the fragment blueprint IR used to generate the fragment shader.\r\n   */\r\n  get fragmentIR() {\r\n    return this._irFrag;\r\n  }\r\n  set fragmentIR(ir: MaterialBlueprintIR) {\r\n    if (ir && ir !== this._irFrag) {\r\n      this._irFrag = ir;\r\n      this.clearCache();\r\n      this.optionChanged(true);\r\n    }\r\n  }\r\n  /**\r\n   * Gets the list of uniform value descriptors used by the blueprint.\r\n   */\r\n  get uniformValues() {\r\n    return this._uniformValues;\r\n  }\r\n  set uniformValues(val: BluePrintUniformValue[]) {\r\n    this._uniformValues = (val ?? []).map((v) => ({ ...v }));\r\n    this.uniformChanged();\r\n  }\r\n  /**\r\n   * Gets the list of texture uniform descriptors used by the blueprint.\r\n   */\r\n  get uniformTextures() {\r\n    return this._uniformTextures;\r\n  }\r\n  set uniformTextures(val: BluePrintUniformTexture[]) {\r\n    val = val ?? [];\r\n    if (val !== this._uniformTextures) {\r\n      const newUniforms = val.map((v) => ({\r\n        finalTexture: new DRef(v.finalTexture!.get()),\r\n        finalSampler: v.finalSampler,\r\n        name: v.name,\r\n        params: v.params?.clone() ?? Vector4.zero(),\r\n        texture: v.texture,\r\n        type: v.type,\r\n        sRGB: v.sRGB,\r\n        wrapS: v.wrapS,\r\n        wrapT: v.wrapT,\r\n        inFragmentShader: v.inFragmentShader,\r\n        inVertexShader: v.inVertexShader,\r\n        minFilter: v.minFilter,\r\n        magFilter: v.magFilter,\r\n        mipFilter: v.mipFilter\r\n      }));\r\n      for (const u of this._uniformTextures) {\r\n        u.finalTexture!.dispose();\r\n      }\r\n      this._uniformTextures = newUniforms;\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Creates a deep copy of this blueprint material.\r\n   *\r\n   * @remarks\r\n   * The clone shares the same fragment IR reference and copies the\r\n   * current uniform descriptors, then calls {@link Sprite3DMaterial.copyFrom}\r\n   * to copy base-class state.\r\n   *\r\n   * @returns A new {@link Sprite3DBlueprintMaterial} instance.\r\n   */\r\n  clone() {\r\n    const other = new Sprite3DBlueprintMaterial(this._irFrag, this._uniformValues, this._uniformTextures);\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Applies runtime uniform values and textures to the given bind group.\r\n   *\r\n   * @remarks\r\n   * - Calls the base implementation to bind sprite-related uniforms first.\r\n   * - If fragment color is needed for the current context, all blueprint\r\n   *   uniform values and textures are then bound by name:\r\n   *   - `uniformValues` via `bindGroup.setValue`.\r\n   *   - `uniformTextures` via `bindGroup.setTexture`.\r\n   *\r\n   * @param bindGroup - The bind group to bind material resources to.\r\n   * @param ctx - The current draw context.\r\n   * @param pass - Index of the active render pass.\r\n   */\r\n  applyUniformValues(bindGroup: BindGroup, ctx: DrawContext, pass: number) {\r\n    super.applyUniformValues(bindGroup, ctx, pass);\r\n    if (this.needFragmentColor(ctx)) {\r\n      for (const u of this._uniformValues) {\r\n        bindGroup.setValue(u.name, u.finalValue!);\r\n      }\r\n      for (const u of this._uniformTextures) {\r\n        bindGroup.setTexture(u.name, u.finalTexture!.get()!, u.finalSampler);\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Computes the fragment color by invoking the blueprint-generated function.\r\n   *\r\n   * @remarks\r\n   * - A helper function `zCalcSpriteColor(zWorldPos, zVertexUV)` is declared\r\n   *   on the shader builder using the current fragment IR.\r\n   * - The blueprint IR is asked to create its node network via\r\n   *   {@link MaterialBlueprintIR.create}, and the output named `\"Color\"`\r\n   *   is used as the return value.\r\n   * - The resulting function is invoked with the current world position and\r\n   *   UV coordinates for each fragment.\r\n   *\r\n   * @param scope - The current fragment shader function scope.\r\n   * @returns A shader expression representing the final fragment color.\r\n   */\r\n  protected calcFragmentColor(scope: PBInsideFunctionScope) {\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    pb.func('zCalcSpriteColor', [pb.vec3('zWorldPos'), pb.vec2('zVertexUV')], function () {\r\n      const outputs = that._irFrag.create(pb)!;\r\n      this.$return(that.getOutput(outputs, 'Color') as PBShaderExp);\r\n    });\r\n    return scope.zCalcSpriteColor(scope.$inputs.zWorldPos, scope.$inputs.zVertexUV) as PBShaderExp;\r\n  }\r\n  /**\r\n   * Creates a unique hash string used for program caching.\r\n   *\r\n   * @remarks\r\n   * The hash includes the base {@link Sprite3DMaterial} hash and the\r\n   * fragment IR hash, so that different blueprints will produce\r\n   * different shader programs.\r\n   *\r\n   * @returns A hash string that identifies this material configuration.\r\n   */\r\n  protected _createHash() {\r\n    return `${super._createHash()}:${this._irFrag.hash}`;\r\n  }\r\n  /**\r\n   * Creates the GPU program for this material.\r\n   *\r\n   * @remarks\r\n   * This simply delegates to the base implementation and returns its result.\r\n   * Commented-out logging lines are available for debugging the generated\r\n   * vertex and fragment shader sources.\r\n   *\r\n   * @param ctx - The current draw context.\r\n   * @param pass - Index of the active material pass.\r\n   * @returns The created GPU program.\r\n   */\r\n  protected createProgram(ctx: DrawContext, pass: number) {\r\n    const program = super.createProgram(ctx, pass);\r\n    //console.log(program.getShaderSource('vertex'));\r\n    //console.log(program.getShaderSource('fragment'));\r\n    return program;\r\n  }\r\n  /**\r\n   * Disposes resources associated with this material.\r\n   *\r\n   * @remarks\r\n   * - Calls the base `onDispose` to clean up inherited resources.\r\n   * - Disposes all `finalTexture` references from the blueprint texture\r\n   *   uniform descriptors.\r\n   *\r\n   * This method is intended to be called by the engine's resource management\r\n   * system rather than directly from user code.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    for (const u of this._uniformTextures) {\r\n      u.finalTexture!.dispose();\r\n    }\r\n  }\r\n  /**\r\n   * Retrieves a named output expression from a blueprint output list.\r\n   *\r\n   * @param outputs - List of outputs generated by the blueprint graph.\r\n   * @param name - Name of the output to look for (e.g. `\"Color\"`).\r\n   * @returns The matching output expression, or `undefined` if not found.\r\n   */\r\n  private getOutput(\r\n    outputs: {\r\n      name: string;\r\n      exp: number | boolean | PBShaderExp;\r\n    }[],\r\n    name: string\r\n  ) {\r\n    return outputs.find((output) => output.name === name)?.exp;\r\n  }\r\n}\r\n"],"names":["Sprite3DBlueprintMaterial","Sprite3DMaterial","irFrag","uniformValues","uniformTextures","_irFrag","MaterialBlueprintIR","nodeMap","Sprite3DBlockNode","roots","order","graph","incoming","outgoing","nodes","id","title","locked","node","ClassName","Object","links","_uniformValues","_uniformTextures","fragmentIR","ir","clearCache","optionChanged","val","map","v","uniformChanged","newUniforms","finalTexture","DRef","get","finalSampler","name","params","clone","Vector4","zero","texture","type","sRGB","wrapS","wrapT","inFragmentShader","inVertexShader","minFilter","magFilter","mipFilter","u","dispose","other","copyFrom","applyUniformValues","bindGroup","ctx","pass","needFragmentColor","setValue","finalValue","setTexture","calcFragmentColor","scope","pb","$builder","that","func","vec3","vec2","outputs","create","$return","getOutput","zCalcSpriteColor","$inputs","zWorldPos","zVertexUV","_createHash","hash","createProgram","program","onDispose","find","output","exp"],"mappings":";;;;;AAQA;;;;;;;;;;IAWO,MAAMA,yBAAkCC,SAAAA,gBAAAA,CAAAA;qBAE7C,OAAqC;qBAErC,cAAgD;qBAEhD,gBAAoD;AACpD;;;;;;;AAOC,MACD,YACEC,MAA4B,EAC5BC,aAAuC,EACvCC,eAA2C,CAC3C;QACA,KAAK,EAAA;AACL,QAAA,IAAI,CAACC,OAAO,GACVH,MAAAA,IACA,IAAII,mBACF,CAAA;YACEC,OAAS,EAAA;AAAE,gBAAA,GAAA,EAAK,IAAIC,iBAAAA;AAAoB,aAAA;YACxCC,KAAO,EAAA;AAAC,gBAAA;AAAE,aAAA;YACVC,KAAO,EAAA;AAAC,gBAAA;AAAE,aAAA;YACVC,KAAO,EAAA;AAAEC,gBAAAA,QAAAA,EAAU,EAAC;AAAGC,gBAAAA,QAAAA,EAAU;AAAG;AACtC,SAAA,EACA,EACA,EAAA;YACEC,KAAO,EAAA;AAAC,gBAAA;oBAAEC,EAAI,EAAA,CAAA;oBAAGC,KAAO,EAAA,EAAA;oBAAIC,MAAQ,EAAA,IAAA;oBAAMC,IAAM,EAAA;wBAAEC,SAAW,EAAA,mBAAA;wBAAqBC,MAAQ,EAAA;AAAG;AAAE;AAAE,aAAA;AACjGC,YAAAA,KAAAA,EAAO;AACT,SAAA,CAAA;AAEJ,QAAA,IAAI,CAACC,cAAc,GAAGnB,aAAAA,IAAiB,EAAE;AACzC,QAAA,IAAI,CAACoB,gBAAgB,GAAGnB,eAAAA,IAAmB,EAAE;AAC/C;AACA;;AAEC,MACD,IAAIoB,UAAa,GAAA;QACf,OAAO,IAAI,CAACnB,OAAO;AACrB;IACA,IAAImB,UAAAA,CAAWC,EAAuB,EAAE;AACtC,QAAA,IAAIA,EAAMA,IAAAA,EAAAA,KAAO,IAAI,CAACpB,OAAO,EAAE;YAC7B,IAAI,CAACA,OAAO,GAAGoB,EAAAA;AACf,YAAA,IAAI,CAACC,UAAU,EAAA;YACf,IAAI,CAACC,aAAa,CAAC,IAAA,CAAA;AACrB;AACF;AACA;;AAEC,MACD,IAAIxB,aAAgB,GAAA;QAClB,OAAO,IAAI,CAACmB,cAAc;AAC5B;IACA,IAAInB,aAAAA,CAAcyB,GAA4B,EAAE;AAC9C,QAAA,IAAI,CAACN,cAAc,GAAIM,CAAAA,GAAAA,IAAO,EAAC,EAAGC,GAAG,CAAC,CAACC,KAAO;AAAE,gBAAA,GAAGA;aAAE,CAAA,CAAA;AACrD,QAAA,IAAI,CAACC,cAAc,EAAA;AACrB;AACA;;AAEC,MACD,IAAI3B,eAAkB,GAAA;QACpB,OAAO,IAAI,CAACmB,gBAAgB;AAC9B;IACA,IAAInB,eAAAA,CAAgBwB,GAA8B,EAAE;AAClDA,QAAAA,GAAAA,GAAMA,OAAO,EAAE;AACf,QAAA,IAAIA,GAAQ,KAAA,IAAI,CAACL,gBAAgB,EAAE;AACjC,YAAA,MAAMS,cAAcJ,GAAIC,CAAAA,GAAG,CAAC,CAACC,KAAO;AAClCG,oBAAAA,YAAAA,EAAc,IAAIC,IAAAA,CAAKJ,CAAEG,CAAAA,YAAY,CAAEE,GAAG,EAAA,CAAA;AAC1CC,oBAAAA,YAAAA,EAAcN,EAAEM,YAAY;AAC5BC,oBAAAA,IAAAA,EAAMP,EAAEO,IAAI;AACZC,oBAAAA,MAAAA,EAAQR,CAAEQ,CAAAA,MAAM,EAAEC,KAAAA,EAAAA,IAAWC,QAAQC,IAAI,EAAA;AACzCC,oBAAAA,OAAAA,EAASZ,EAAEY,OAAO;AAClBC,oBAAAA,IAAAA,EAAMb,EAAEa,IAAI;AACZC,oBAAAA,IAAAA,EAAMd,EAAEc,IAAI;AACZC,oBAAAA,KAAAA,EAAOf,EAAEe,KAAK;AACdC,oBAAAA,KAAAA,EAAOhB,EAAEgB,KAAK;AACdC,oBAAAA,gBAAAA,EAAkBjB,EAAEiB,gBAAgB;AACpCC,oBAAAA,cAAAA,EAAgBlB,EAAEkB,cAAc;AAChCC,oBAAAA,SAAAA,EAAWnB,EAAEmB,SAAS;AACtBC,oBAAAA,SAAAA,EAAWpB,EAAEoB,SAAS;AACtBC,oBAAAA,SAAAA,EAAWrB,EAAEqB;iBACf,CAAA,CAAA;AACA,YAAA,KAAK,MAAMC,CAAAA,IAAK,IAAI,CAAC7B,gBAAgB,CAAE;gBACrC6B,CAAEnB,CAAAA,YAAY,CAAEoB,OAAO,EAAA;AACzB;YACA,IAAI,CAAC9B,gBAAgB,GAAGS,WAAAA;AACxB,YAAA,IAAI,CAACD,cAAc,EAAA;AACrB;AACF;AACA;;;;;;;;;AASC,MACDQ,KAAQ,GAAA;AACN,QAAA,MAAMe,KAAQ,GAAA,IAAItD,yBAA0B,CAAA,IAAI,CAACK,OAAO,EAAE,IAAI,CAACiB,cAAc,EAAE,IAAI,CAACC,gBAAgB,CAAA;QACpG+B,KAAMC,CAAAA,QAAQ,CAAC,IAAI,CAAA;QACnB,OAAOD,KAAAA;AACT;AACA;;;;;;;;;;;;;AAaC,MACDE,mBAAmBC,SAAoB,EAAEC,GAAgB,EAAEC,IAAY,EAAE;QACvE,KAAK,CAACH,kBAAmBC,CAAAA,SAAAA,EAAWC,GAAKC,EAAAA,IAAAA,CAAAA;AACzC,QAAA,IAAI,IAAI,CAACC,iBAAiB,CAACF,GAAM,CAAA,EAAA;AAC/B,YAAA,KAAK,MAAMN,CAAAA,IAAK,IAAI,CAAC9B,cAAc,CAAE;AACnCmC,gBAAAA,SAAAA,CAAUI,QAAQ,CAACT,CAAAA,CAAEf,IAAI,EAAEe,EAAEU,UAAU,CAAA;AACzC;AACA,YAAA,KAAK,MAAMV,CAAAA,IAAK,IAAI,CAAC7B,gBAAgB,CAAE;gBACrCkC,SAAUM,CAAAA,UAAU,CAACX,CAAAA,CAAEf,IAAI,EAAEe,CAAEnB,CAAAA,YAAY,CAAEE,GAAG,EAAKiB,EAAAA,CAAAA,CAAEhB,YAAY,CAAA;AACrE;AACF;AACF;AACA;;;;;;;;;;;;;;MAeU4B,iBAAkBC,CAAAA,KAA4B,EAAE;QACxD,MAAMC,EAAAA,GAAKD,MAAME,QAAQ;AACzB,QAAA,MAAMC,OAAO,IAAI;QACjBF,EAAGG,CAAAA,IAAI,CAAC,kBAAoB,EAAA;AAACH,YAAAA,EAAAA,CAAGI,IAAI,CAAC,WAAA,CAAA;AAAcJ,YAAAA,EAAAA,CAAGK,IAAI,CAAC,WAAA;SAAa,EAAE,WAAA;AACxE,YAAA,MAAMC,OAAUJ,GAAAA,IAAAA,CAAK/D,OAAO,CAACoE,MAAM,CAACP,EAAAA,CAAAA;AACpC,YAAA,IAAI,CAACQ,OAAO,CAACN,IAAKO,CAAAA,SAAS,CAACH,OAAS,EAAA,OAAA,CAAA,CAAA;AACvC,SAAA,CAAA;QACA,OAAOP,KAAAA,CAAMW,gBAAgB,CAACX,KAAMY,CAAAA,OAAO,CAACC,SAAS,EAAEb,KAAAA,CAAMY,OAAO,CAACE,SAAS,CAAA;AAChF;AACA;;;;;;;;;AASC,MACD,WAAwB,GAAA;QACtB,OAAO,CAAA,EAAG,KAAK,CAACC,WAAc,EAAA,CAAA,CAAC,EAAE,IAAI,CAAC3E,OAAO,CAAC4E,IAAI,CAAE,CAAA;AACtD;AACA;;;;;;;;;;;AAWC,MACD,aAAUC,CAAcxB,GAAgB,EAAEC,IAAY,EAAE;AACtD,QAAA,MAAMwB,OAAU,GAAA,KAAK,CAACD,aAAAA,CAAcxB,GAAKC,EAAAA,IAAAA,CAAAA;;;QAGzC,OAAOwB,OAAAA;AACT;AACA;;;;;;;;;;AAUC,MACD,SAAsB,GAAA;AACpB,QAAA,KAAK,CAACC,SAAAA,EAAAA;AACN,QAAA,KAAK,MAAMhC,CAAAA,IAAK,IAAI,CAAC7B,gBAAgB,CAAE;YACrC6B,CAAEnB,CAAAA,YAAY,CAAEoB,OAAO,EAAA;AACzB;AACF;AACA;;;;;;AAMC,MACD,SAAQsB,CACNH,OAGG,EACHnC,IAAY,EACZ;QACA,OAAOmC,OAAAA,CAAQa,IAAI,CAAC,CAACC,SAAWA,MAAOjD,CAAAA,IAAI,KAAKA,IAAOkD,CAAAA,EAAAA,GAAAA;AACzD;AACF;;;;"}

package/dist/material/sprite_std.js

@@ -0,0 +1,116 @@
+import { DRef } from '@zephyr3d/base';
+import { SpriteMaterial } from './sprite.js';
+import { fetchSampler } from '../utility/misc.js';
+
+/**
+ * Standard Sprite material
+ * @public
+ */ class StandardSpriteMaterial extends SpriteMaterial {
+    static FEATURE_SPRITE_TEXTURE = this.defineFeature();
+    _texture;
+    /**
+   * Creates a new instance of {@link StandardSpriteMaterial}.
+   *
+   * @remarks
+   * By default, no sprite texture is assigned and the material renders
+   * as solid white until a texture is set.
+   */ constructor(){
+        super();
+        this._texture = new DRef();
+    }
+    /**
+   * Gets the 2D texture used by this sprite material.
+   *
+   * @returns The current sprite texture, or `null` if no texture is assigned.
+   */ get spriteTexture() {
+        return this._texture.get();
+    }
+    set spriteTexture(tex) {
+        tex = tex ?? null;
+        if (tex !== this._texture.get()) {
+            this._texture.set(tex);
+            this.useFeature(StandardSpriteMaterial.FEATURE_SPRITE_TEXTURE, !!tex);
+            this.uniformChanged();
+        }
+    }
+    /**
+   * Creates a deep copy of this material instance.
+   *
+   * @remarks
+   * The new instance will copy all relevant state from this material,
+   * including the assigned sprite texture reference.
+   *
+   * @returns A new {@link StandardSpriteMaterial} instance with the same settings.
+   */ clone() {
+        const other = new StandardSpriteMaterial();
+        other.copyFrom(this);
+        return other;
+    }
+    /**
+   * Copies the state from another {@link StandardSpriteMaterial} into this instance.
+   *
+   * @param other - The source material to copy from.
+   */ copyFrom(other) {
+        super.copyFrom(other);
+        this.spriteTexture = other.spriteTexture;
+    }
+    /**
+   * Applies runtime uniform values to the given bind group before drawing.
+   *
+   * @remarks
+   * This method is called by the rendering pipeline to bind GPU resources
+   * (such as textures and samplers) associated with this material.
+   *
+   * @param bindGroup - The bind group to which uniforms and resources are bound.
+   * @param ctx - The current draw context providing rendering-state information.
+   *
+   */ internalApplyUniforms(bindGroup, ctx) {
+        if (this.spriteTexture && this.needFragmentColor(ctx)) {
+            bindGroup.setTexture('zSpriteTexture', this.spriteTexture, fetchSampler('clamp_linear'));
+        }
+    }
+    /**
+   * Declares and configures shader uniforms for this material in the current scope.
+   *
+   * @remarks
+   * This is executed during shader construction. If the active shader stage
+   * is a fragment shader, and the material requires fragment color and has
+   * a sprite texture assigned, a 2D texture uniform named `zSpriteTexture`
+   * is added to the program.
+   *
+   * @param scope - The current shader function scope used to build the program.
+   */ internalSetupUniforms(scope) {
+        const pb = scope.$builder;
+        if (pb.shaderKind === 'fragment' && this.spriteTexture && this.needFragmentColor()) {
+            scope.zSpriteTexture = pb.tex2D().uniform(2);
+        }
+    }
+    /**
+   * Computes the fragment color expression for this material within the shader.
+   *
+   * @remarks
+   * - If a sprite texture is assigned, this samples the texture using
+   *   the interpolated vertex UV coordinates (`zVertexUV`).
+   * - If no texture is assigned, this returns a solid white color.
+   *
+   * @param scope - The current shader function scope providing inputs and uniforms.
+   * @returns A shader expression representing the computed fragment color.
+   */ calcFragmentColor(scope) {
+        const pb = scope.$builder;
+        return this.spriteTexture ? pb.textureSample(scope.zSpriteTexture, scope.$inputs.zVertexUV) : pb.vec4(1);
+    }
+    /**
+   * Releases resources held by this material instance.
+   *
+   * @remarks
+   * This is called when the material is disposed. It forwards the dispose
+   * call to the internal texture reference so that the associated GPU
+   * resource can be released.
+   */ onDispose() {
+        super.onDispose();
+        this._texture.dispose();
+    }
+}
+
+export { StandardSpriteMaterial };
+//# sourceMappingURL=sprite_std.js.map

package/dist/material/sprite_std.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite_std.js","sources":["../../src/material/sprite_std.ts"],"sourcesContent":["import type { BindGroup, PBInsideFunctionScope, Texture2D } from '@zephyr3d/device';\r\nimport type { Clonable } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport type { DrawContext } from '../render/drawable';\r\nimport { SpriteMaterial } from './sprite';\r\nimport { fetchSampler } from '../utility/misc';\r\n\r\n/**\r\n * Standard Sprite material\r\n * @public\r\n */\r\nexport class StandardSpriteMaterial extends SpriteMaterial implements Clonable<StandardSpriteMaterial> {\r\n  static FEATURE_SPRITE_TEXTURE = this.defineFeature();\r\n  protected _texture: DRef<Texture2D>;\r\n  /**\r\n   * Creates a new instance of {@link StandardSpriteMaterial}.\r\n   *\r\n   * @remarks\r\n   * By default, no sprite texture is assigned and the material renders\r\n   * as solid white until a texture is set.\r\n   */\r\n  constructor() {\r\n    super();\r\n    this._texture = new DRef();\r\n  }\r\n  /**\r\n   * Gets the 2D texture used by this sprite material.\r\n   *\r\n   * @returns The current sprite texture, or `null` if no texture is assigned.\r\n   */\r\n  get spriteTexture() {\r\n    return this._texture.get();\r\n  }\r\n  set spriteTexture(tex) {\r\n    tex = tex ?? null;\r\n    if (tex !== this._texture.get()) {\r\n      this._texture.set(tex);\r\n      this.useFeature(StandardSpriteMaterial.FEATURE_SPRITE_TEXTURE, !!tex);\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Creates a deep copy of this material instance.\r\n   *\r\n   * @remarks\r\n   * The new instance will copy all relevant state from this material,\r\n   * including the assigned sprite texture reference.\r\n   *\r\n   * @returns A new {@link StandardSpriteMaterial} instance with the same settings.\r\n   */\r\n  clone() {\r\n    const other = new StandardSpriteMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copies the state from another {@link StandardSpriteMaterial} into this instance.\r\n   *\r\n   * @param other - The source material to copy from.\r\n   */\r\n  copyFrom(other: this) {\r\n    super.copyFrom(other);\r\n    this.spriteTexture = other.spriteTexture;\r\n  }\r\n  /**\r\n   * Applies runtime uniform values to the given bind group before drawing.\r\n   *\r\n   * @remarks\r\n   * This method is called by the rendering pipeline to bind GPU resources\r\n   * (such as textures and samplers) associated with this material.\r\n   *\r\n   * @param bindGroup - The bind group to which uniforms and resources are bound.\r\n   * @param ctx - The current draw context providing rendering-state information.\r\n   *\r\n   */\r\n  protected internalApplyUniforms(bindGroup: BindGroup, ctx: DrawContext) {\r\n    if (this.spriteTexture && this.needFragmentColor(ctx)) {\r\n      bindGroup.setTexture('zSpriteTexture', this.spriteTexture, fetchSampler('clamp_linear'));\r\n    }\r\n  }\r\n  /**\r\n   * Declares and configures shader uniforms for this material in the current scope.\r\n   *\r\n   * @remarks\r\n   * This is executed during shader construction. If the active shader stage\r\n   * is a fragment shader, and the material requires fragment color and has\r\n   * a sprite texture assigned, a 2D texture uniform named `zSpriteTexture`\r\n   * is added to the program.\r\n   *\r\n   * @param scope - The current shader function scope used to build the program.\r\n   */\r\n  protected internalSetupUniforms(scope: PBInsideFunctionScope) {\r\n    const pb = scope.$builder;\r\n    if (pb.shaderKind === 'fragment' && this.spriteTexture && this.needFragmentColor()) {\r\n      scope.zSpriteTexture = pb.tex2D().uniform(2);\r\n    }\r\n  }\r\n  /**\r\n   * Computes the fragment color expression for this material within the shader.\r\n   *\r\n   * @remarks\r\n   * - If a sprite texture is assigned, this samples the texture using\r\n   *   the interpolated vertex UV coordinates (`zVertexUV`).\r\n   * - If no texture is assigned, this returns a solid white color.\r\n   *\r\n   * @param scope - The current shader function scope providing inputs and uniforms.\r\n   * @returns A shader expression representing the computed fragment color.\r\n   */\r\n  protected calcFragmentColor(scope: PBInsideFunctionScope) {\r\n    const pb = scope.$builder;\r\n    return this.spriteTexture ? pb.textureSample(scope.zSpriteTexture, scope.$inputs.zVertexUV) : pb.vec4(1);\r\n  }\r\n  /**\r\n   * Releases resources held by this material instance.\r\n   *\r\n   * @remarks\r\n   * This is called when the material is disposed. It forwards the dispose\r\n   * call to the internal texture reference so that the associated GPU\r\n   * resource can be released.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._texture.dispose();\r\n  }\r\n}\r\n"],"names":["StandardSpriteMaterial","SpriteMaterial","FEATURE_SPRITE_TEXTURE","defineFeature","_texture","DRef","spriteTexture","get","tex","set","useFeature","uniformChanged","clone","other","copyFrom","internalApplyUniforms","bindGroup","ctx","needFragmentColor","setTexture","fetchSampler","internalSetupUniforms","scope","pb","$builder","shaderKind","zSpriteTexture","tex2D","uniform","calcFragmentColor","textureSample","$inputs","zVertexUV","vec4","onDispose","dispose"],"mappings":";;;;AAOA;;;IAIO,MAAMA,sBAA+BC,SAAAA,cAAAA,CAAAA;AAC1C,IAAA,OAAOC,sBAAyB,GAAA,IAAI,CAACC,aAAa,EAAG;IAC3CC,QAA0B;AACpC;;;;;;AAMC,MACD,WAAc,EAAA;QACZ,KAAK,EAAA;QACL,IAAI,CAACA,QAAQ,GAAG,IAAIC,IAAAA,EAAAA;AACtB;AACA;;;;AAIC,MACD,IAAIC,aAAgB,GAAA;AAClB,QAAA,OAAO,IAAI,CAACF,QAAQ,CAACG,GAAG,EAAA;AAC1B;IACA,IAAID,aAAAA,CAAcE,GAAG,EAAE;AACrBA,QAAAA,GAAAA,GAAMA,GAAO,IAAA,IAAA;AACb,QAAA,IAAIA,QAAQ,IAAI,CAACJ,QAAQ,CAACG,GAAG,EAAI,EAAA;AAC/B,YAAA,IAAI,CAACH,QAAQ,CAACK,GAAG,CAACD,GAAAA,CAAAA;AAClB,YAAA,IAAI,CAACE,UAAU,CAACV,uBAAuBE,sBAAsB,EAAE,CAAC,CAACM,GAAAA,CAAAA;AACjE,YAAA,IAAI,CAACG,cAAc,EAAA;AACrB;AACF;AACA;;;;;;;;AAQC,MACDC,KAAQ,GAAA;AACN,QAAA,MAAMC,QAAQ,IAAIb,sBAAAA,EAAAA;QAClBa,KAAMC,CAAAA,QAAQ,CAAC,IAAI,CAAA;QACnB,OAAOD,KAAAA;AACT;AACA;;;;MAKAC,QAAAA,CAASD,KAAW,EAAE;AACpB,QAAA,KAAK,CAACC,QAASD,CAAAA,KAAAA,CAAAA;AACf,QAAA,IAAI,CAACP,aAAa,GAAGO,KAAAA,CAAMP,aAAa;AAC1C;AACA;;;;;;;;;;AAUC,MACD,qBAAUS,CAAsBC,SAAoB,EAAEC,GAAgB,EAAE;QACtE,IAAI,IAAI,CAACX,aAAa,IAAI,IAAI,CAACY,iBAAiB,CAACD,GAAM,CAAA,EAAA;AACrDD,YAAAA,SAAAA,CAAUG,UAAU,CAAC,gBAAA,EAAkB,IAAI,CAACb,aAAa,EAAEc,YAAa,CAAA,cAAA,CAAA,CAAA;AAC1E;AACF;AACA;;;;;;;;;;MAWUC,qBAAsBC,CAAAA,KAA4B,EAAE;QAC5D,MAAMC,EAAAA,GAAKD,MAAME,QAAQ;QACzB,IAAID,EAAAA,CAAGE,UAAU,KAAK,UAAc,IAAA,IAAI,CAACnB,aAAa,IAAI,IAAI,CAACY,iBAAiB,EAAI,EAAA;AAClFI,YAAAA,KAAAA,CAAMI,cAAc,GAAGH,EAAAA,CAAGI,KAAK,EAAA,CAAGC,OAAO,CAAC,CAAA,CAAA;AAC5C;AACF;AACA;;;;;;;;;;MAWUC,iBAAkBP,CAAAA,KAA4B,EAAE;QACxD,MAAMC,EAAAA,GAAKD,MAAME,QAAQ;AACzB,QAAA,OAAO,IAAI,CAAClB,aAAa,GAAGiB,EAAAA,CAAGO,aAAa,CAACR,KAAAA,CAAMI,cAAc,EAAEJ,MAAMS,OAAO,CAACC,SAAS,CAAIT,GAAAA,EAAAA,CAAGU,IAAI,CAAC,CAAA,CAAA;AACxG;AACA;;;;;;;AAOC,MACD,SAAsB,GAAA;AACpB,QAAA,KAAK,CAACC,SAAAA,EAAAA;QACN,IAAI,CAAC9B,QAAQ,CAAC+B,OAAO,EAAA;AACvB;AACF;;;;"}