@woosh/meep-engine 3.38.0 → 3.40.0

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh8_color_evaluate_vmf.js

@@ -0,0 +1,205 @@
+// GENERATED by tools/codegen/spherical_harmonics/generate_sh_chunks.mjs — do not edit by hand.
+// Regenerate from packages/meep-engine with: node tools/codegen/spherical_harmonics/generate_sh_chunks.mjs
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+
+/**
+ * A 8-band RGB spherical-harmonic function convolved with a von Mises-Fisher lobe of
+ * concentration `kappa`, evaluated at a unit `direction`:
+ * `sum over l, m of exp(-l(l+1) / (2 kappa)) * Y(l, m)(direction) * sh[l * (l + 1) + m]`.
+ *
+ * The band window is the large-kappa vMF form of Ref-NeRF's integrated directional encoding [VHM*22];
+ * with `kappa = 1 / alpha` it is how Silvennoinen, Sloan, Iwanicki and Nowrouzezahrai encode roughness in
+ * "Spherical Harmonic Exponentials for Efficient Glossy Reflections" (HPG 2025,
+ * https://doi.org/10.1111/cgf.70219, talk: https://www.youtube.com/watch?v=THVMMNZ68iA). Their P and Q
+ * terms are each `exp` of one of these; see `sh_exponential/` beside the environment light code.
+ *
+ * **Not clamped.** Unlike `sh3_color_evaluate`, this returns the signed value: the SH-exponential
+ * representation stores log radiance, where negative is ordinary.
+ *
+ * Coefficients are band-major in the engine's all-positive convention (`sh_index`); per band the
+ * weight is `sh_vmf_window(l, kappa)`, folded here as powers of one `exp`. `kappa` must be > 0;
+ * as it grows the result tends to plain evaluation of `sh`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sh8_color_evaluate_vmf = CodeChunk.from(
+    //language=WGSL
+    `
+fn sh8_color_evaluate_vmf(sh: array<vec3<f32>, 64>, direction: vec3<f32>, kappa: f32) -> vec3<f32> {
+    let x = direction.x;
+    let y = direction.y;
+    let z = direction.z;
+
+    // m = 0
+    let q0_0 = 0.28209479177387814;
+    let q1_0 = 0.48860251190291987 * z;
+    let q2_0 = 1.9364916731037085 * z * q1_0 - 1.118033988749895 * q0_0;
+    let q3_0 = 1.9720265943665387 * z * q2_0 - 1.018350154434631 * q1_0;
+    let q4_0 = 1.984313483298443 * z * q3_0 - 1.0062305898749055 * q2_0;
+    let q5_0 = 1.98997487421324 * z * q4_0 - 1.002853072844814 * q3_0;
+    let q6_0 = 1.9930434571835665 * z * q5_0 - 1.0015420209622192 * q4_0;
+    let q7_0 = 1.9948914348241344 * z * q6_0 - 1.0009272139219583 * q5_0;
+
+    // m = 1, (x + iy)^1
+    let c1 = x;
+    let s1 = y;
+    let q1_1 = 0.48860251190292;
+    let q2_1 = 1.0925484305920792 * z;
+    let q3_1 = 2.091650066335189 * z * q2_1 - 0.9354143466934853 * q1_1;
+    let q4_1 = 2.04939015319192 * z * q3_1 - 0.9797958971132713 * q2_1;
+    let q5_1 = 2.03100960115899 * z * q4_1 - 0.991031208965115 * q3_1;
+    let q6_1 = 2.0213149892370277 * z * q5_1 - 0.9952267030562386 * q4_1;
+    let q7_1 = 2.0155644370746373 * z * q6_1 - 0.9971550440218321 * q5_1;
+
+    // m = 2, (x + iy)^2
+    let c2 = x * c1 - y * s1;
+    let s2 = x * s1 + y * c1;
+    let q2_2 = 0.5462742152960396;
+    let q3_2 = 1.4453057213202773 * z;
+    let q4_2 = 2.29128784747792 * z * q3_2 - 0.8660254037844386 * q2_2;
+    let q5_2 = 2.1712405933672376 * z * q4_2 - 0.9476070829586856 * q3_2;
+    let q6_2 = 2.1139418156609704 * z * q5_2 - 0.9736101204623269 * q4_2;
+    let q7_2 = 2.0816659994661326 * z * q6_2 - 0.9847319278346618 * q5_2;
+
+    // m = 3, (x + iy)^3
+    let c3 = x * c2 - y * s2;
+    let s3 = x * s2 + y * c2;
+    let q3_3 = 0.5900435899266436;
+    let q4_3 = 1.770130769779931 * z;
+    let q5_3 = 2.48746859276655 * z * q4_3 - 0.82915619758885 * q3_3;
+    let q6_3 = 2.301368353023109 * z * q5_3 - 0.9251848886516146 * q4_3;
+    let q7_3 = 2.207940216581962 * z * q6_3 - 0.959403223600247 * q5_3;
+
+    // m = 4, (x + iy)^4
+    let c4 = x * c3 - y * s3;
+    let s4 = x * s3 + y * c3;
+    let q4_4 = 0.6258357354491763;
+    let q5_4 = 2.0756623148810416 * z;
+    let q6_4 = 2.6739483914241875 * z * q5_4 - 0.806225774829855 * q4_4;
+    let q7_4 = 2.4308621740219887 * z * q6_4 - 0.9090909090909092 * q5_4;
+
+    // m = 5, (x + iy)^5
+    let c5 = x * c4 - y * s4;
+    let s5 = x * s4 + y * c4;
+    let q5_5 = 0.6563820568401703;
+    let q6_5 = 2.3666191622317525 * z;
+    let q7_5 = 2.850438562747845 * z * q6_5 - 0.7905694150420949 * q5_5;
+
+    // m = 6, (x + iy)^6
+    let c6 = x * c5 - y * s5;
+    let s6 = x * s5 + y * c5;
+    let q6_6 = 0.6831841051919145;
+    let q7_6 = 2.645960661801901 * z;
+
+    // m = 7, (x + iy)^7
+    let c7 = x * c6 - y * s6;
+    let s7 = x * s6 + y * c6;
+    let q7_7 = 0.7071627325245964;
+
+    // band l is attenuated by exp(-l(l+1) / (2 kappa)) = t^(l(l+1)), t = exp(-1 / (2 kappa)),
+    // built up as w(l) = w(l-1) * t^(2l)
+    let t = exp(-0.5 / kappa);
+    let t2 = t * t;
+    let w1 = t2;
+    let t4 = t2 * t2;
+    let w2 = w1 * t4;
+    let t6 = t4 * t2;
+    let w3 = w2 * t6;
+    let t8 = t6 * t2;
+    let w4 = w3 * t8;
+    let t10 = t8 * t2;
+    let w5 = w4 * t10;
+    let t12 = t10 * t2;
+    let w6 = w5 * t12;
+    let t14 = t12 * t2;
+    let w7 = w6 * t14;
+
+    var result = sh[0] * q0_0;
+
+    result += w1 * (
+        sh[1] * (q1_1 * s1)
+        + sh[2] * (q1_0)
+        + sh[3] * (q1_1 * c1)
+    );
+
+    result += w2 * (
+        sh[4] * (q2_2 * s2)
+        + sh[5] * (q2_1 * s1)
+        + sh[6] * (q2_0)
+        + sh[7] * (q2_1 * c1)
+        + sh[8] * (q2_2 * c2)
+    );
+
+    result += w3 * (
+        sh[9] * (q3_3 * s3)
+        + sh[10] * (q3_2 * s2)
+        + sh[11] * (q3_1 * s1)
+        + sh[12] * (q3_0)
+        + sh[13] * (q3_1 * c1)
+        + sh[14] * (q3_2 * c2)
+        + sh[15] * (q3_3 * c3)
+    );
+
+    result += w4 * (
+        sh[16] * (q4_4 * s4)
+        + sh[17] * (q4_3 * s3)
+        + sh[18] * (q4_2 * s2)
+        + sh[19] * (q4_1 * s1)
+        + sh[20] * (q4_0)
+        + sh[21] * (q4_1 * c1)
+        + sh[22] * (q4_2 * c2)
+        + sh[23] * (q4_3 * c3)
+        + sh[24] * (q4_4 * c4)
+    );
+
+    result += w5 * (
+        sh[25] * (q5_5 * s5)
+        + sh[26] * (q5_4 * s4)
+        + sh[27] * (q5_3 * s3)
+        + sh[28] * (q5_2 * s2)
+        + sh[29] * (q5_1 * s1)
+        + sh[30] * (q5_0)
+        + sh[31] * (q5_1 * c1)
+        + sh[32] * (q5_2 * c2)
+        + sh[33] * (q5_3 * c3)
+        + sh[34] * (q5_4 * c4)
+        + sh[35] * (q5_5 * c5)
+    );
+
+    result += w6 * (
+        sh[36] * (q6_6 * s6)
+        + sh[37] * (q6_5 * s5)
+        + sh[38] * (q6_4 * s4)
+        + sh[39] * (q6_3 * s3)
+        + sh[40] * (q6_2 * s2)
+        + sh[41] * (q6_1 * s1)
+        + sh[42] * (q6_0)
+        + sh[43] * (q6_1 * c1)
+        + sh[44] * (q6_2 * c2)
+        + sh[45] * (q6_3 * c3)
+        + sh[46] * (q6_4 * c4)
+        + sh[47] * (q6_5 * c5)
+        + sh[48] * (q6_6 * c6)
+    );
+
+    result += w7 * (
+        sh[49] * (q7_7 * s7)
+        + sh[50] * (q7_6 * s6)
+        + sh[51] * (q7_5 * s5)
+        + sh[52] * (q7_4 * s4)
+        + sh[53] * (q7_3 * s3)
+        + sh[54] * (q7_2 * s2)
+        + sh[55] * (q7_1 * s1)
+        + sh[56] * (q7_0)
+        + sh[57] * (q7_1 * c1)
+        + sh[58] * (q7_2 * c2)
+        + sh[59] * (q7_3 * c3)
+        + sh[60] * (q7_4 * c4)
+        + sh[61] * (q7_5 * c5)
+        + sh[62] * (q7_6 * c6)
+        + sh[63] * (q7_7 * c7)
+    );
+
+    return result;
+}
+`);

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_basis_at.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The 9-band real spherical harmonic basis at a unit direction: 81 values, band-major, index
+ * `l * (l + 1) + m`, in the engine's all-positive convention (the first nine are `sh3_basis_at`).
+ *
+ * Unrolled from the normalized associated Legendre recurrence documented in
+ * `core/geom/3d/sphere/harmonics/sh_basis_at.js`, which is its CPU twin. For one coefficient of any
+ * band, `sh_basis_function`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sh9_basis_at: CodeChunk;
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_sh9_basis_at.d.ts.map

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_basis_at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_sh9_basis_at.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_basis_at.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,iCAFU,SAAS,CAsLhB;0BAhMuB,gCAAgC"}

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_basis_at.js

@@ -0,0 +1,195 @@
+// GENERATED by tools/codegen/spherical_harmonics/generate_sh_chunks.mjs — do not edit by hand.
+// Regenerate from packages/meep-engine with: node tools/codegen/spherical_harmonics/generate_sh_chunks.mjs
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+
+/**
+ * The 9-band real spherical harmonic basis at a unit direction: 81 values, band-major, index
+ * `l * (l + 1) + m`, in the engine's all-positive convention (the first nine are `sh3_basis_at`).
+ *
+ * Unrolled from the normalized associated Legendre recurrence documented in
+ * `core/geom/3d/sphere/harmonics/sh_basis_at.js`, which is its CPU twin. For one coefficient of any
+ * band, `sh_basis_function`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sh9_basis_at = CodeChunk.from(
+    //language=WGSL
+    `
+fn sh9_basis_at(direction: vec3<f32>) -> array<f32, 81> {
+    let x = direction.x;
+    let y = direction.y;
+    let z = direction.z;
+
+    // m = 0
+    let q0_0 = 0.28209479177387814;
+    let q1_0 = 0.48860251190291987 * z;
+    let q2_0 = 1.9364916731037085 * z * q1_0 - 1.118033988749895 * q0_0;
+    let q3_0 = 1.9720265943665387 * z * q2_0 - 1.018350154434631 * q1_0;
+    let q4_0 = 1.984313483298443 * z * q3_0 - 1.0062305898749055 * q2_0;
+    let q5_0 = 1.98997487421324 * z * q4_0 - 1.002853072844814 * q3_0;
+    let q6_0 = 1.9930434571835665 * z * q5_0 - 1.0015420209622192 * q4_0;
+    let q7_0 = 1.9948914348241344 * z * q6_0 - 1.0009272139219583 * q5_0;
+    let q8_0 = 1.996089927833914 * z * q7_0 - 1.0006007810695146 * q6_0;
+
+    // m = 1, (x + iy)^1
+    let c1 = x;
+    let s1 = y;
+    let q1_1 = 0.48860251190292;
+    let q2_1 = 1.0925484305920792 * z;
+    let q3_1 = 2.091650066335189 * z * q2_1 - 0.9354143466934853 * q1_1;
+    let q4_1 = 2.04939015319192 * z * q3_1 - 0.9797958971132713 * q2_1;
+    let q5_1 = 2.03100960115899 * z * q4_1 - 0.991031208965115 * q3_1;
+    let q6_1 = 2.0213149892370277 * z * q5_1 - 0.9952267030562386 * q4_1;
+    let q7_1 = 2.0155644370746373 * z * q6_1 - 0.9971550440218321 * q5_1;
+    let q8_1 = 2.011869540407391 * z * q7_1 - 0.9981668178901743 * q6_1;
+
+    // m = 2, (x + iy)^2
+    let c2 = x * c1 - y * s1;
+    let s2 = x * s1 + y * c1;
+    let q2_2 = 0.5462742152960396;
+    let q3_2 = 1.4453057213202773 * z;
+    let q4_2 = 2.29128784747792 * z * q3_2 - 0.8660254037844386 * q2_2;
+    let q5_2 = 2.1712405933672376 * z * q4_2 - 0.9476070829586856 * q3_2;
+    let q6_2 = 2.1139418156609704 * z * q5_2 - 0.9736101204623269 * q4_2;
+    let q7_2 = 2.0816659994661326 * z * q6_2 - 0.9847319278346618 * q5_2;
+    let q8_2 = 2.0615528128088303 * z * q7_2 - 0.9903379376602872 * q6_2;
+
+    // m = 3, (x + iy)^3
+    let c3 = x * c2 - y * s2;
+    let s3 = x * s2 + y * c2;
+    let q3_3 = 0.5900435899266436;
+    let q4_3 = 1.770130769779931 * z;
+    let q5_3 = 2.48746859276655 * z * q4_3 - 0.82915619758885 * q3_3;
+    let q6_3 = 2.301368353023109 * z * q5_3 - 0.9251848886516146 * q4_3;
+    let q7_3 = 2.207940216581962 * z * q6_3 - 0.959403223600247 * q5_3;
+    let q8_3 = 2.15322168769582 * z * q7_3 - 0.9752173865600177 * q6_3;
+
+    // m = 4, (x + iy)^4
+    let c4 = x * c3 - y * s3;
+    let s4 = x * s3 + y * c3;
+    let q4_4 = 0.6258357354491763;
+    let q5_4 = 2.0756623148810416 * z;
+    let q6_4 = 2.6739483914241875 * z * q5_4 - 0.806225774829855 * q4_4;
+    let q7_4 = 2.4308621740219887 * z * q6_4 - 0.9090909090909092 * q5_4;
+    let q8_4 = 2.3048861143232218 * z * q7_4 - 0.9481763873554654 * q6_4;
+
+    // m = 5, (x + iy)^5
+    let c5 = x * c4 - y * s4;
+    let s5 = x * s4 + y * c4;
+    let q5_5 = 0.6563820568401703;
+    let q6_5 = 2.3666191622317525 * z;
+    let q7_5 = 2.850438562747845 * z * q6_5 - 0.7905694150420949 * q5_5;
+    let q8_5 = 2.557041559783794 * z * q7_5 - 0.8970695222838923 * q6_5;
+
+    // m = 6, (x + iy)^6
+    let c6 = x * c5 - y * s5;
+    let s6 = x * s5 + y * c5;
+    let q6_6 = 0.6831841051919145;
+    let q7_6 = 2.645960661801901 * z;
+    let q8_6 = 3.017804310611087 * z * q7_6 - 0.7791937224739796 * q6_6;
+
+    // m = 7, (x + iy)^7
+    let c7 = x * c6 - y * s6;
+    let s7 = x * s6 + y * c6;
+    let q7_7 = 0.7071627325245964;
+    let q8_7 = 2.9157066406993204 * z;
+
+    // m = 8, (x + iy)^8
+    let c8 = x * c7 - y * s7;
+    let s8 = x * s7 + y * c7;
+    let q8_8 = 0.7289266601748301;
+
+    return array<f32, 81>(
+        // band 0
+        q0_0,
+        // band 1
+        q1_1 * s1,
+        q1_0,
+        q1_1 * c1,
+        // band 2
+        q2_2 * s2,
+        q2_1 * s1,
+        q2_0,
+        q2_1 * c1,
+        q2_2 * c2,
+        // band 3
+        q3_3 * s3,
+        q3_2 * s2,
+        q3_1 * s1,
+        q3_0,
+        q3_1 * c1,
+        q3_2 * c2,
+        q3_3 * c3,
+        // band 4
+        q4_4 * s4,
+        q4_3 * s3,
+        q4_2 * s2,
+        q4_1 * s1,
+        q4_0,
+        q4_1 * c1,
+        q4_2 * c2,
+        q4_3 * c3,
+        q4_4 * c4,
+        // band 5
+        q5_5 * s5,
+        q5_4 * s4,
+        q5_3 * s3,
+        q5_2 * s2,
+        q5_1 * s1,
+        q5_0,
+        q5_1 * c1,
+        q5_2 * c2,
+        q5_3 * c3,
+        q5_4 * c4,
+        q5_5 * c5,
+        // band 6
+        q6_6 * s6,
+        q6_5 * s5,
+        q6_4 * s4,
+        q6_3 * s3,
+        q6_2 * s2,
+        q6_1 * s1,
+        q6_0,
+        q6_1 * c1,
+        q6_2 * c2,
+        q6_3 * c3,
+        q6_4 * c4,
+        q6_5 * c5,
+        q6_6 * c6,
+        // band 7
+        q7_7 * s7,
+        q7_6 * s6,
+        q7_5 * s5,
+        q7_4 * s4,
+        q7_3 * s3,
+        q7_2 * s2,
+        q7_1 * s1,
+        q7_0,
+        q7_1 * c1,
+        q7_2 * c2,
+        q7_3 * c3,
+        q7_4 * c4,
+        q7_5 * c5,
+        q7_6 * c6,
+        q7_7 * c7,
+        // band 8
+        q8_8 * s8,
+        q8_7 * s7,
+        q8_6 * s6,
+        q8_5 * s5,
+        q8_4 * s4,
+        q8_3 * s3,
+        q8_2 * s2,
+        q8_1 * s1,
+        q8_0,
+        q8_1 * c1,
+        q8_2 * c2,
+        q8_3 * c3,
+        q8_4 * c4,
+        q8_5 * c5,
+        q8_6 * c6,
+        q8_7 * c7,
+        q8_8 * c8
+    );
+}
+`);

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_color_evaluate_vmf.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A 9-band RGB spherical-harmonic function convolved with a von Mises-Fisher lobe of
+ * concentration `kappa`, evaluated at a unit `direction`:
+ * `sum over l, m of exp(-l(l+1) / (2 kappa)) * Y(l, m)(direction) * sh[l * (l + 1) + m]`.
+ *
+ * The band window is the large-kappa vMF form of Ref-NeRF's integrated directional encoding [VHM*22];
+ * with `kappa = 1 / alpha` it is how Silvennoinen, Sloan, Iwanicki and Nowrouzezahrai encode roughness in
+ * "Spherical Harmonic Exponentials for Efficient Glossy Reflections" (HPG 2025,
+ * https://doi.org/10.1111/cgf.70219, talk: https://www.youtube.com/watch?v=THVMMNZ68iA). Their P and Q
+ * terms are each `exp` of one of these; see `sh_exponential/` beside the environment light code.
+ *
+ * **Not clamped.** Unlike `sh3_color_evaluate`, this returns the signed value: the SH-exponential
+ * representation stores log radiance, where negative is ordinary.
+ *
+ * Coefficients are band-major in the engine's all-positive convention (`sh_index`); per band the
+ * weight is `sh_vmf_window(l, kappa)`, folded here as powers of one `exp`. `kappa` must be > 0;
+ * as it grows the result tends to plain evaluation of `sh`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sh9_color_evaluate_vmf: CodeChunk;
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+//# sourceMappingURL=chunk_sh9_color_evaluate_vmf.d.ts.map

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_color_evaluate_vmf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk_sh9_color_evaluate_vmf.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_color_evaluate_vmf.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,2CAFU,SAAS,CAyNhB;0BA7OuB,gCAAgC"}

package/src/shade/renderer/shader/chunk/spherical_harmonics/generated/chunk_sh9_color_evaluate_vmf.js

@@ -0,0 +1,240 @@
+// GENERATED by tools/codegen/spherical_harmonics/generate_sh_chunks.mjs — do not edit by hand.
+// Regenerate from packages/meep-engine with: node tools/codegen/spherical_harmonics/generate_sh_chunks.mjs
+import { CodeChunk } from "../../../compiler/CodeChunk.js";
+
+/**
+ * A 9-band RGB spherical-harmonic function convolved with a von Mises-Fisher lobe of
+ * concentration `kappa`, evaluated at a unit `direction`:
+ * `sum over l, m of exp(-l(l+1) / (2 kappa)) * Y(l, m)(direction) * sh[l * (l + 1) + m]`.
+ *
+ * The band window is the large-kappa vMF form of Ref-NeRF's integrated directional encoding [VHM*22];
+ * with `kappa = 1 / alpha` it is how Silvennoinen, Sloan, Iwanicki and Nowrouzezahrai encode roughness in
+ * "Spherical Harmonic Exponentials for Efficient Glossy Reflections" (HPG 2025,
+ * https://doi.org/10.1111/cgf.70219, talk: https://www.youtube.com/watch?v=THVMMNZ68iA). Their P and Q
+ * terms are each `exp` of one of these; see `sh_exponential/` beside the environment light code.
+ *
+ * **Not clamped.** Unlike `sh3_color_evaluate`, this returns the signed value: the SH-exponential
+ * representation stores log radiance, where negative is ordinary.
+ *
+ * Coefficients are band-major in the engine's all-positive convention (`sh_index`); per band the
+ * weight is `sh_vmf_window(l, kappa)`, folded here as powers of one `exp`. `kappa` must be > 0;
+ * as it grows the result tends to plain evaluation of `sh`.
+ *
+ * @type {CodeChunk}
+ */
+export const chunk_sh9_color_evaluate_vmf = CodeChunk.from(
+    //language=WGSL
+    `
+fn sh9_color_evaluate_vmf(sh: array<vec3<f32>, 81>, direction: vec3<f32>, kappa: f32) -> vec3<f32> {
+    let x = direction.x;
+    let y = direction.y;
+    let z = direction.z;
+
+    // m = 0
+    let q0_0 = 0.28209479177387814;
+    let q1_0 = 0.48860251190291987 * z;
+    let q2_0 = 1.9364916731037085 * z * q1_0 - 1.118033988749895 * q0_0;
+    let q3_0 = 1.9720265943665387 * z * q2_0 - 1.018350154434631 * q1_0;
+    let q4_0 = 1.984313483298443 * z * q3_0 - 1.0062305898749055 * q2_0;
+    let q5_0 = 1.98997487421324 * z * q4_0 - 1.002853072844814 * q3_0;
+    let q6_0 = 1.9930434571835665 * z * q5_0 - 1.0015420209622192 * q4_0;
+    let q7_0 = 1.9948914348241344 * z * q6_0 - 1.0009272139219583 * q5_0;
+    let q8_0 = 1.996089927833914 * z * q7_0 - 1.0006007810695146 * q6_0;
+
+    // m = 1, (x + iy)^1
+    let c1 = x;
+    let s1 = y;
+    let q1_1 = 0.48860251190292;
+    let q2_1 = 1.0925484305920792 * z;
+    let q3_1 = 2.091650066335189 * z * q2_1 - 0.9354143466934853 * q1_1;
+    let q4_1 = 2.04939015319192 * z * q3_1 - 0.9797958971132713 * q2_1;
+    let q5_1 = 2.03100960115899 * z * q4_1 - 0.991031208965115 * q3_1;
+    let q6_1 = 2.0213149892370277 * z * q5_1 - 0.9952267030562386 * q4_1;
+    let q7_1 = 2.0155644370746373 * z * q6_1 - 0.9971550440218321 * q5_1;
+    let q8_1 = 2.011869540407391 * z * q7_1 - 0.9981668178901743 * q6_1;
+
+    // m = 2, (x + iy)^2
+    let c2 = x * c1 - y * s1;
+    let s2 = x * s1 + y * c1;
+    let q2_2 = 0.5462742152960396;
+    let q3_2 = 1.4453057213202773 * z;
+    let q4_2 = 2.29128784747792 * z * q3_2 - 0.8660254037844386 * q2_2;
+    let q5_2 = 2.1712405933672376 * z * q4_2 - 0.9476070829586856 * q3_2;
+    let q6_2 = 2.1139418156609704 * z * q5_2 - 0.9736101204623269 * q4_2;
+    let q7_2 = 2.0816659994661326 * z * q6_2 - 0.9847319278346618 * q5_2;
+    let q8_2 = 2.0615528128088303 * z * q7_2 - 0.9903379376602872 * q6_2;
+
+    // m = 3, (x + iy)^3
+    let c3 = x * c2 - y * s2;
+    let s3 = x * s2 + y * c2;
+    let q3_3 = 0.5900435899266436;
+    let q4_3 = 1.770130769779931 * z;
+    let q5_3 = 2.48746859276655 * z * q4_3 - 0.82915619758885 * q3_3;
+    let q6_3 = 2.301368353023109 * z * q5_3 - 0.9251848886516146 * q4_3;
+    let q7_3 = 2.207940216581962 * z * q6_3 - 0.959403223600247 * q5_3;
+    let q8_3 = 2.15322168769582 * z * q7_3 - 0.9752173865600177 * q6_3;
+
+    // m = 4, (x + iy)^4
+    let c4 = x * c3 - y * s3;
+    let s4 = x * s3 + y * c3;
+    let q4_4 = 0.6258357354491763;
+    let q5_4 = 2.0756623148810416 * z;
+    let q6_4 = 2.6739483914241875 * z * q5_4 - 0.806225774829855 * q4_4;
+    let q7_4 = 2.4308621740219887 * z * q6_4 - 0.9090909090909092 * q5_4;
+    let q8_4 = 2.3048861143232218 * z * q7_4 - 0.9481763873554654 * q6_4;
+
+    // m = 5, (x + iy)^5
+    let c5 = x * c4 - y * s4;
+    let s5 = x * s4 + y * c4;
+    let q5_5 = 0.6563820568401703;
+    let q6_5 = 2.3666191622317525 * z;
+    let q7_5 = 2.850438562747845 * z * q6_5 - 0.7905694150420949 * q5_5;
+    let q8_5 = 2.557041559783794 * z * q7_5 - 0.8970695222838923 * q6_5;
+
+    // m = 6, (x + iy)^6
+    let c6 = x * c5 - y * s5;
+    let s6 = x * s5 + y * c5;
+    let q6_6 = 0.6831841051919145;
+    let q7_6 = 2.645960661801901 * z;
+    let q8_6 = 3.017804310611087 * z * q7_6 - 0.7791937224739796 * q6_6;
+
+    // m = 7, (x + iy)^7
+    let c7 = x * c6 - y * s6;
+    let s7 = x * s6 + y * c6;
+    let q7_7 = 0.7071627325245964;
+    let q8_7 = 2.9157066406993204 * z;
+
+    // m = 8, (x + iy)^8
+    let c8 = x * c7 - y * s7;
+    let s8 = x * s7 + y * c7;
+    let q8_8 = 0.7289266601748301;
+
+    // band l is attenuated by exp(-l(l+1) / (2 kappa)) = t^(l(l+1)), t = exp(-1 / (2 kappa)),
+    // built up as w(l) = w(l-1) * t^(2l)
+    let t = exp(-0.5 / kappa);
+    let t2 = t * t;
+    let w1 = t2;
+    let t4 = t2 * t2;
+    let w2 = w1 * t4;
+    let t6 = t4 * t2;
+    let w3 = w2 * t6;
+    let t8 = t6 * t2;
+    let w4 = w3 * t8;
+    let t10 = t8 * t2;
+    let w5 = w4 * t10;
+    let t12 = t10 * t2;
+    let w6 = w5 * t12;
+    let t14 = t12 * t2;
+    let w7 = w6 * t14;
+    let t16 = t14 * t2;
+    let w8 = w7 * t16;
+
+    var result = sh[0] * q0_0;
+
+    result += w1 * (
+        sh[1] * (q1_1 * s1)
+        + sh[2] * (q1_0)
+        + sh[3] * (q1_1 * c1)
+    );
+
+    result += w2 * (
+        sh[4] * (q2_2 * s2)
+        + sh[5] * (q2_1 * s1)
+        + sh[6] * (q2_0)
+        + sh[7] * (q2_1 * c1)
+        + sh[8] * (q2_2 * c2)
+    );
+
+    result += w3 * (
+        sh[9] * (q3_3 * s3)
+        + sh[10] * (q3_2 * s2)
+        + sh[11] * (q3_1 * s1)
+        + sh[12] * (q3_0)
+        + sh[13] * (q3_1 * c1)
+        + sh[14] * (q3_2 * c2)
+        + sh[15] * (q3_3 * c3)
+    );
+
+    result += w4 * (
+        sh[16] * (q4_4 * s4)
+        + sh[17] * (q4_3 * s3)
+        + sh[18] * (q4_2 * s2)
+        + sh[19] * (q4_1 * s1)
+        + sh[20] * (q4_0)
+        + sh[21] * (q4_1 * c1)
+        + sh[22] * (q4_2 * c2)
+        + sh[23] * (q4_3 * c3)
+        + sh[24] * (q4_4 * c4)
+    );
+
+    result += w5 * (
+        sh[25] * (q5_5 * s5)
+        + sh[26] * (q5_4 * s4)
+        + sh[27] * (q5_3 * s3)
+        + sh[28] * (q5_2 * s2)
+        + sh[29] * (q5_1 * s1)
+        + sh[30] * (q5_0)
+        + sh[31] * (q5_1 * c1)
+        + sh[32] * (q5_2 * c2)
+        + sh[33] * (q5_3 * c3)
+        + sh[34] * (q5_4 * c4)
+        + sh[35] * (q5_5 * c5)
+    );
+
+    result += w6 * (
+        sh[36] * (q6_6 * s6)
+        + sh[37] * (q6_5 * s5)
+        + sh[38] * (q6_4 * s4)
+        + sh[39] * (q6_3 * s3)
+        + sh[40] * (q6_2 * s2)
+        + sh[41] * (q6_1 * s1)
+        + sh[42] * (q6_0)
+        + sh[43] * (q6_1 * c1)
+        + sh[44] * (q6_2 * c2)
+        + sh[45] * (q6_3 * c3)
+        + sh[46] * (q6_4 * c4)
+        + sh[47] * (q6_5 * c5)
+        + sh[48] * (q6_6 * c6)
+    );
+
+    result += w7 * (
+        sh[49] * (q7_7 * s7)
+        + sh[50] * (q7_6 * s6)
+        + sh[51] * (q7_5 * s5)
+        + sh[52] * (q7_4 * s4)
+        + sh[53] * (q7_3 * s3)
+        + sh[54] * (q7_2 * s2)
+        + sh[55] * (q7_1 * s1)
+        + sh[56] * (q7_0)
+        + sh[57] * (q7_1 * c1)
+        + sh[58] * (q7_2 * c2)
+        + sh[59] * (q7_3 * c3)
+        + sh[60] * (q7_4 * c4)
+        + sh[61] * (q7_5 * c5)
+        + sh[62] * (q7_6 * c6)
+        + sh[63] * (q7_7 * c7)
+    );
+
+    result += w8 * (
+        sh[64] * (q8_8 * s8)
+        + sh[65] * (q8_7 * s7)
+        + sh[66] * (q8_6 * s6)
+        + sh[67] * (q8_5 * s5)
+        + sh[68] * (q8_4 * s4)
+        + sh[69] * (q8_3 * s3)
+        + sh[70] * (q8_2 * s2)
+        + sh[71] * (q8_1 * s1)
+        + sh[72] * (q8_0)
+        + sh[73] * (q8_1 * c1)
+        + sh[74] * (q8_2 * c2)
+        + sh[75] * (q8_3 * c3)
+        + sh[76] * (q8_4 * c4)
+        + sh[77] * (q8_5 * c5)
+        + sh[78] * (q8_6 * c6)
+        + sh[79] * (q8_7 * c7)
+        + sh[80] * (q8_8 * c8)
+    );
+
+    return result;
+}
+`);

package/src/shade/renderer/shader/resource/ShaderResourceGroupDescriptor.d.ts

@@ -1,9 +1,3 @@
-/**
- * @typedef {import("../../../descriptor/texture/SamplerDescriptor.js").SamplerDescriptor} SamplerDescriptor
- * @typedef {import("../../../device/ShadeGPUCommandContext.js").ShadeGPUCommandContext} ShadeGPUCommandContext
- * @typedef {import("../../texture/ShadeTexture.js").ShadeTexture} ShadeTexture
- * @typedef {import("../type/WebGPUType.js").WebGPUType} WebGPUType
- */
 export class ShaderResourceGroupDescriptor {
     /**
      *