@unikia/upe-renderer 0.186.110 → 0.187.11

package/examples/jsm/inspector/tabs/Viewer.js

@@ -2,10 +2,10 @@ import { Tab } from '../ui/Tab.js';
 import { List } from '../ui/List.js';
 import { Item } from '../ui/Item.js';
 import { splitPath, splitCamelCase } from '../ui/utils.js';
-import { getItem, setItem } from '../Inspector.js';
+import { getItem, setItem } from '../Storage.js';
 
 import { RendererUtils, NoToneMapping, LinearSRGBColorSpace, QuadMesh, NodeMaterial, CanvasTarget, Vector2, Color } from 'three/webgpu';
-import { renderOutput, vec2, vec3, vec4, Fn, screenUV, step, OnMaterialUpdate, uniform, float } from 'three/tsl';
+import { renderOutput, rtt, vec2, vec3, vec4, Fn, screenUV, step, OnMaterialUpdate, uniform, float } from 'three/tsl';
 
 const _size = /*@__PURE__*/ new Vector2();
 
@@ -746,16 +746,14 @@ class Viewer extends Tab {
 		this.splitUniforms.viewportWidth.value = rect.width;
 
 		// Recreate or setup material for split screen comparison
-		const node = canvasData.node;
-		const target = node.context( { getUV: () => screenUV } );
+		const target = canvasData.inspectNode.context( { getUV: () => screenUV } );
 		const targetColor = renderOutput( vec4( vec3( target ), 1 ), NoToneMapping, renderer.outputColorSpace );
-		const targetColorCtx = targetColor.context( { inspector: true } );
 
 		let finalColor;
 
 		if ( this.splitFullscreen ) {
 
-			finalColor = targetColorCtx;
+			finalColor = targetColor;
 
 		} else {
 
@@ -763,7 +761,7 @@ class Viewer extends Tab {
 
 				screenUV.x.lessThan( this.splitUniforms.splitX ).discard();
 
-				return targetColorCtx;
+				return targetColor;
 
 			} )();
 
@@ -901,7 +899,21 @@ class Viewer extends Tab {
 			const canvasAspect = uniform( 1 );
 			const mask = float( 1 );
 
-			const target = node.context( { getUV: ( textureNode ) => {
+			let inspectNode = node.callback !== null ? node.callback( node.node ) : node.node;
+			let rttNode = null;
+
+			if ( inspectNode.isTextureNode !== true && inspectNode.isPassNode !== true ) {
+
+				// render other nodes in the resolution of the renderer, e.g. screen-space nodes
+
+				rttNode = rtt( inspectNode );
+				rttNode.uvNode = null; // use the aspect ratio corrected uv of the viewer
+
+				inspectNode = rttNode;
+
+			}
+
+			const target = inspectNode.context( { getUV: ( textureNode ) => {
 
 				const uvData = aspectRatioUV( screenUV, textureNode, canvasAspect );
 				const correctedUV = uvData.xy;
@@ -913,7 +925,6 @@ class Viewer extends Tab {
 
 			let output = vec4( vec3( target ), 1 ).mul( mask );
 			output = renderOutput( output, NoToneMapping, renderer.outputColorSpace );
-			output = output.context( { inspector: true } );
 
 			const material = new NodeMaterial();
 			material.outputNode = output;
@@ -926,6 +937,8 @@ class Viewer extends Tab {
 				name,
 				path,
 				node,
+				inspectNode,
+				rttNode,
 				quad,
 				canvasTarget,
 				material,
@@ -1240,7 +1253,7 @@ class Viewer extends Tab {
 
 			const mainSize = previousCanvasTarget.getDrawingBufferSize( _size );
 
-			canvasData.node.traverse( ( child ) => {
+			canvasData.inspectNode.traverse( ( child ) => {
 
 				if ( child.isRTTNode && child.autoResize === true ) {
 
@@ -1361,6 +1374,8 @@ class Viewer extends Tab {
 			canvasData.canvasTarget.dispose();
 			canvasData.material.dispose();
 
+			if ( canvasData.rttNode !== null ) canvasData.rttNode.dispose();
+
 		}
 
 		this.canvasNodes.clear();

package/examples/jsm/inspector/ui/Profiler.js

@@ -1,7 +1,7 @@
 import { EventDispatcher } from 'three';
 import { Style } from './Style.js';
 import { Graph } from './Graph.js';
-import { getItem, setItem } from '../Inspector.js';
+import { getItem, setItem } from '../Storage.js';
 
 export class Profiler extends EventDispatcher {
 

package/examples/jsm/inspector/ui/Style.js

@@ -357,11 +357,6 @@ export class Style {
 			min-width: 0 !important;
 		}
 
-		.mini-panel-content .list-container.parameters .list-item-row,
-		.mini-panel-content .list-container.parameters .list-header {
-			grid-template-columns: minmax(0, .5fr) minmax(0, 1fr) !important;
-		}
-
 	}
 
 	.mini-panel-content .list-container.parameters {
@@ -1614,33 +1609,26 @@ export class Style {
 		margin-left: 2px;
 	}
 
-	@media screen and (max-width: 340px) {
-
-		.mini-panel-content .list-item-cell:first-child {
-			display: flex;
-			align-items: center;
-			min-width: 0;
-			overflow: hidden;
-			width: 100%;
-		}
-
-		.mini-panel-content .list-item-cell:first-child .value {
-			overflow: hidden;
-			text-overflow: ellipsis;
-			white-space: nowrap;
-			flex: 1 1 0%;
-			min-width: 0;
-		}
+	.list-container.parameters .list-item-cell:first-child .value {
+		overflow: hidden;
+		text-overflow: ellipsis;
+		white-space: nowrap;
+	}
 
-		.mini-panel-content .list-item-cell:first-child .info-icon {
-			flex-shrink: 0;
-		}
+	.list-container.parameters .list-item-cell:first-child .value:has(> .info-icon) {
+		position: relative;
+		padding-right: 20px;
+	}
 
+	.list-container.parameters .list-item-cell:first-child .value > .info-icon {
+		position: absolute;
+		top: calc(50% - 8px);
+		right: 0;
 	}
 
 	.mini-panel-content .custom-checkbox .checkmark {
-		width: 12px;
-		height: 12px;
+		width: 11px;
+		height: 11px;
 		margin-bottom: 2px;
 		will-change: transform;
 	}
@@ -1649,6 +1637,10 @@ export class Style {
 		margin-bottom: 2px;
 	}
 
+	.mini-panel-content .list-container.parameters .list-item-wrapper:has(> .list-children-container.closed) + .list-item-wrapper {
+		margin-top: 2px;
+	}
+
 	.mini-panel-content .list-container.parameters .list-children-container > .list-item-wrapper:first-child:has(> .list-item-row:not(.collapsible)) {
 		margin-top: 2px;
 	}
@@ -2117,6 +2109,8 @@ export class Style {
 		width: 1px;
 		left: 50%;
 		background-color: transparent;
+		/*background-color: rgba(255, 255, 255, 0.25);
+		box-shadow: 0 0 0 1px rgba(0, 0, 0, 0.15);*/
 		cursor: ew-resize;
 		pointer-events: auto !important;
 		z-index: 10;
@@ -2141,32 +2135,6 @@ export class Style {
 		cursor: ew-resize;
 	}
 
-	.split-screen-line::after {
-		content: '';
-		position: absolute;
-		top: -1px;
-		bottom: -1px;
-		left: -5px;
-		width: 11px;
-		pointer-events: none;
-		background-image:
-			url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='11' height='7' viewBox='0 0 11 7'%3E%3Cpath d='M-0.5 -1 L5.5 7 L11.5 -1 Z' fill='rgba(30,30,36,0.85)' stroke='%234a4a5a' stroke-width='1' stroke-linejoin='round'/%3E%3C/svg%3E"),
-			url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='11' height='7' viewBox='0 0 11 7'%3E%3Cpath d='M-0.5 8 L5.5 0 L11.5 8 Z' fill='rgba(30,30,36,0.85)' stroke='%234a4a5a' stroke-width='1' stroke-linejoin='round'/%3E%3C/svg%3E");
-		background-position: top center, bottom center;
-		background-repeat: no-repeat;
-		opacity: 1;
-		transition: opacity 0.15s ease-out;
-	}
-
-	.split-screen-line:hover::after,
-	.split-screen-line:active::after,
-	.split-screen-line.active::after {
-		opacity: 1;
-		background-image:
-			url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='11' height='7' viewBox='0 0 11 7'%3E%3Cpath d='M-0.5 -1 L5.5 7 L11.5 -1 Z' fill='%2300aaff' stroke='%2300aaff' stroke-width='1' stroke-linejoin='round'/%3E%3C/svg%3E"),
-			url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='11' height='7' viewBox='0 0 11 7'%3E%3Cpath d='M-0.5 8 L5.5 0 L11.5 8 Z' fill='%2300aaff' stroke='%2300aaff' stroke-width='1' stroke-linejoin='round'/%3E%3C/svg%3E");
-	}
-
 	/* Grid Mode styles for List component */
 	.list-scroll-wrapper:has(> .list-container.grid-mode) {
 		width: 100% !important;

package/examples/jsm/inspector/ui/Values.js

@@ -127,22 +127,45 @@ class ValueNumber extends Value {
 
 	addDragHandler() {
 
+		const threshold = 2;
+
+		let isPressed = false;
 		let isDragging = false;
-		let startY, startValue;
+		let startX, startY, startValue;
 
 		this.input.style.touchAction = 'none';
 
 		this.input.addEventListener( 'pointerdown', ( e ) => {
 
-			isDragging = true;
+			isPressed = true;
+			startX = e.clientX;
 			startY = e.clientY;
 			startValue = parseFloat( this.input.value );
-			document.body.style.cursor = 'ns-resize';
 
 		} );
 
 		document.addEventListener( 'pointermove', ( e ) => {
 
+			if ( isPressed ) {
+
+				// start dragging only after a vertical movement, a horizontal one selects text
+
+				if ( Math.abs( e.clientY - startY ) > threshold ) {
+
+					isPressed = false;
+					isDragging = true;
+					startY = e.clientY;
+					this.input.blur();
+					document.body.style.cursor = 'ns-resize';
+
+				} else if ( Math.abs( e.clientX - startX ) > threshold ) {
+
+					isPressed = false;
+
+				}
+
+			}
+
 			if ( isDragging ) {
 
 				const deltaY = startY - e.clientY;
@@ -176,6 +199,8 @@ class ValueNumber extends Value {
 
 		document.addEventListener( 'pointerup', () => {
 
+			isPressed = false;
+
 			if ( isDragging ) {
 
 				isDragging = false;

package/examples/jsm/libs/fflate.module.js

@@ -2,7 +2,7 @@
 fflate - fast JavaScript compression/decompression
 <https://101arrowz.github.io/fflate>
 Licensed under MIT. https://github.com/101arrowz/fflate/blob/master/LICENSE
-version 0.8.2
+version 0.8.3
 */
 
 // DEFLATE is a complex format; to read this code, you should probably check the RFC first:
@@ -199,7 +199,7 @@ var ec = [
     'invalid distance',
     'stream finished',
     'no stream handler',
-    ,
+    , // determined by compression function
     'no callback',
     'invalid UTF-8 data',
     'extra field too long',
@@ -916,12 +916,12 @@ var cbify = function (dat, opts, fns, init, id, cb) {
 var astrm = function (strm) {
     strm.ondata = function (dat, final) { return postMessage([dat, final], [dat.buffer]); };
     return function (ev) {
-        if (ev.data.length) {
+        if (ev.data[0]) {
             strm.push(ev.data[0], ev.data[1]);
             postMessage([ev.data[0].length]);
         }
         else
-            strm.flush();
+            strm.flush(ev.data[1]);
     };
 };
 // async stream attach
@@ -951,17 +951,19 @@ var astrmify = function (fns, strm, opts, init, id, flush, ext) {
         if (t)
             strm.ondata(err(4, 0, 1), null, !!f);
         strm.queuedSize += d.length;
-        w.postMessage([d, t = f], [d.buffer]);
+        // can fail for cross-realm Uint8Array, but ok - only a small performance penalty
+        w.postMessage([d, t = f], d.buffer instanceof ArrayBuffer ? [d.buffer] : []);
     };
     strm.terminate = function () { w.terminate(); };
     if (flush) {
-        strm.flush = function () { w.postMessage([]); };
+        strm.flush = function (sync) { w.postMessage([0, sync]); };
     }
 };
 // read 2 bytes
 var b2 = function (d, b) { return d[b] | (d[b + 1] << 8); };
 // read 4 bytes
 var b4 = function (d, b) { return (d[b] | (d[b + 1] << 8) | (d[b + 2] << 16) | (d[b + 3] << 24)) >>> 0; };
+// read 8 bytes
 var b8 = function (d, b) { return b4(d, b) + (b4(d, b + 4) * 4294967296); };
 // write bytes
 var wbytes = function (d, b, v) {
@@ -1082,18 +1084,37 @@ var Deflate = /*#__PURE__*/ (function () {
             this.p(this.b, final || false);
             this.s.w = this.s.i, this.s.i -= 2;
         }
+        if (final) {
+            // cleanup unneeded buffers/state to reduce memory usage
+            this.s = this.o = {};
+            this.b = et;
+        }
     };
     /**
      * Flushes buffered uncompressed data. Useful to immediately retrieve the
      * deflated output for small inputs.
+     * @param sync Whether to flush to a byte boundary. A sync flush takes 4-5
+     *             extra bytes, but guarantees all pushed data is immediately
+     *             decompressible. A separate DEFLATE stream may be concatenated
+     *             with the current output after a sync flush.
      */
-    Deflate.prototype.flush = function () {
+    Deflate.prototype.flush = function (sync) {
         if (!this.ondata)
             err(5);
         if (this.s.l)
             err(4);
         this.p(this.b, false);
         this.s.w = this.s.i, this.s.i -= 2;
+        // could technically skip writing the type-0 block for (this.s.r & 7) == 0,
+        // but the deterministic trailer (00 00 FF FF) is useful in some situations
+        if (sync) {
+            var c = new u8(6);
+            c[0] = this.s.r >> 3;
+            // write empty, non-final type-0 block
+            var ep = wfblk(c, this.s.r, et);
+            this.s.r = 0;
+            this.ondata(c.subarray(0, ep >> 3), false);
+        }
     };
     return Deflate;
 }());
@@ -1204,12 +1225,6 @@ export function inflate(data, opts, cb) {
         bInflt
     ], function (ev) { return pbf(inflateSync(ev.data[0], gopt(ev.data[1]))); }, 1, cb);
 }
-/**
- * Expands DEFLATE data with no wrapper
- * @param data The data to decompress
- * @param opts The decompression options
- * @returns The decompressed version of the data
- */
 export function inflateSync(data, opts) {
     return inflt(data, { i: 2 }, opts && opts.out, opts && opts.dictionary);
 }
@@ -1245,9 +1260,12 @@ var Gzip = /*#__PURE__*/ (function () {
     /**
      * Flushes buffered uncompressed data. Useful to immediately retrieve the
      * GZIPped output for small inputs.
+     * @param sync Whether to flush to a byte boundary. A sync flush takes 4-5
+     *             extra bytes, but guarantees all pushed data is immediately
+     *             decompressible.
      */
-    Gzip.prototype.flush = function () {
-        Deflate.prototype.flush.call(this);
+    Gzip.prototype.flush = function (sync) {
+        Deflate.prototype.flush.call(this, sync);
     };
     return Gzip;
 }());
@@ -1325,14 +1343,17 @@ var Gunzip = /*#__PURE__*/ (function () {
         }
         // necessary to prevent TS from using the closure value
         // This allows for workerization to function correctly
-        Inflate.prototype.c.call(this, final);
+        Inflate.prototype.c.call(this, 0);
         // process concatenated GZIP
-        if (this.s.f && !this.s.l && !final) {
+        if (this.s.f && !this.s.l) {
             this.v = shft(this.s.p) + 9;
             this.s = { i: 0 };
             this.o = new u8(0);
             this.push(new u8(0), final);
         }
+        else if (final) {
+            Inflate.prototype.c.call(this, final);
+        }
     };
     return Gunzip;
 }());
@@ -1367,12 +1388,6 @@ export function gunzip(data, opts, cb) {
         function () { return [gunzipSync]; }
     ], function (ev) { return pbf(gunzipSync(ev.data[0], ev.data[1])); }, 3, cb);
 }
-/**
- * Expands GZIP data
- * @param data The data to decompress
- * @param opts The decompression options
- * @returns The decompressed version of the data
- */
 export function gunzipSync(data, opts) {
     var st = gzs(data);
     if (st + 8 > data.length)
@@ -1408,9 +1423,12 @@ var Zlib = /*#__PURE__*/ (function () {
     /**
      * Flushes buffered uncompressed data. Useful to immediately retrieve the
      * zlibbed output for small inputs.
+     * @param sync Whether to flush to a byte boundary. A sync flush takes 4-5
+     *             extra bytes, but guarantees all pushed data is immediately
+     *             decompressible.
      */
-    Zlib.prototype.flush = function () {
-        Deflate.prototype.flush.call(this);
+    Zlib.prototype.flush = function (sync) {
+        Deflate.prototype.flush.call(this, sync);
     };
     return Zlib;
 }());
@@ -1517,12 +1535,6 @@ export function unzlib(data, opts, cb) {
         function () { return [unzlibSync]; }
     ], function (ev) { return pbf(unzlibSync(ev.data[0], gopt(ev.data[1]))); }, 5, cb);
 }
-/**
- * Expands Zlib data
- * @param data The data to decompress
- * @param opts The decompression options
- * @returns The decompressed version of the data
- */
 export function unzlibSync(data, opts) {
     return inflt(data.subarray(zls(data, opts && opts.dictionary), -4), { i: 2 }, opts && opts.out, opts && opts.dictionary);
 }
@@ -1643,7 +1655,7 @@ var fltn = function (d, p, t, o) {
         var val = d[k], n = p + k, op = o;
         if (Array.isArray(val))
             op = mrg(o, val[1]), val = val[0];
-        if (val instanceof u8)
+        if (ArrayBuffer.isView(val))
             t[n] = [val, op];
         else {
             t[n += '/'] = [new u8(0), op];
@@ -1828,15 +1840,30 @@ var dbf = function (l) { return l == 1 ? 3 : l < 6 ? 2 : l == 9 ? 1 : 0; };
 var slzh = function (d, b) { return b + 30 + b2(d, b + 26) + b2(d, b + 28); };
 // read zip header
 var zh = function (d, b, z) {
-    var fnl = b2(d, b + 28), fn = strFromU8(d.subarray(b + 46, b + 46 + fnl), !(b2(d, b + 8) & 2048)), es = b + 46 + fnl, bs = b4(d, b + 20);
-    var _a = z && bs == 4294967295 ? z64e(d, es) : [bs, b4(d, b + 24), b4(d, b + 42)], sc = _a[0], su = _a[1], off = _a[2];
-    return [b2(d, b + 10), sc, su, fn, es + b2(d, b + 30) + b2(d, b + 32), off];
+    var fnl = b2(d, b + 28), efl = b2(d, b + 30), fn = strFromU8(d.subarray(b + 46, b + 46 + fnl), !(b2(d, b + 8) & 2048)), es = b + 46 + fnl;
+    var _a = z64hs(d, es, efl, z, b4(d, b + 20), b4(d, b + 24), b4(d, b + 42)), sc = _a[0], su = _a[1], off = _a[2];
+    return [b2(d, b + 10), sc, su, fn, es + efl + b2(d, b + 32), off];
 };
-// read zip64 extra field
-var z64e = function (d, b) {
-    for (; b2(d, b) != 1; b += 4 + b2(d, b + 2))
-        ;
-    return [b8(d, b + 12), b8(d, b + 4), b8(d, b + 20)];
+// read zip64 header sizes
+var z64hs = function (d, b, l, z, sc, su, off) {
+    var nsc = sc == 4294967295, nsu = su == 4294967295, noff = off == 4294967295, e = b + l;
+    var nf = nsc + nsu + noff;
+    if (z && nf) {
+        for (; b + 4 < e; b += 4 + b2(d, b + 2)) {
+            if (b2(d, b) == 1) {
+                return [
+                    nsc ? b8(d, b + 4 + 8 * nsu) : sc,
+                    nsu ? b8(d, b + 4) : su,
+                    noff ? b8(d, b + 4 + 8 * (nsu + nsc)) : off,
+                    1
+                ];
+            }
+        }
+        // z == 2 for unknown whether or not zip64
+        if (z < 2)
+            err(13);
+    }
+    return [sc, su, off, 0];
 };
 // extra field length
 var exfl = function (ex) {
@@ -1938,6 +1965,8 @@ var ZipPassThrough = /*#__PURE__*/ (function () {
         this.size += chunk.length;
         if (final)
             this.crc = this.c.d();
+        // we shouldn't really do this cast, but properly handling ArrayBufferLike
+        // makes the API unergonomic with Buffer
         this.process(chunk, final || false);
     };
     return ZipPassThrough;
@@ -2317,8 +2346,9 @@ export function zipSync(data, opts) {
 var UnzipPassThrough = /*#__PURE__*/ (function () {
     function UnzipPassThrough() {
     }
-    UnzipPassThrough.prototype.push = function (data, final) {
-        this.ondata(null, data, final);
+    UnzipPassThrough.prototype.push = function (chunk, final) {
+        // same as ZipPassThrough: cast to retain Buffer ergonomics
+        this.ondata(null, chunk, final);
     };
     UnzipPassThrough.compression = 0;
     return UnzipPassThrough;
@@ -2338,9 +2368,9 @@ var UnzipInflate = /*#__PURE__*/ (function () {
             _this.ondata(null, dat, final);
         });
     }
-    UnzipInflate.prototype.push = function (data, final) {
+    UnzipInflate.prototype.push = function (chunk, final) {
         try {
-            this.i.push(data, final);
+            this.i.push(chunk, final);
         }
         catch (e) {
             this.ondata(e, null, final);
@@ -2371,10 +2401,10 @@ var AsyncUnzipInflate = /*#__PURE__*/ (function () {
             this.terminate = this.i.terminate;
         }
     }
-    AsyncUnzipInflate.prototype.push = function (data, final) {
+    AsyncUnzipInflate.prototype.push = function (chunk, final) {
         if (this.i.terminate)
-            data = slc(data, 0);
-        this.i.push(data, final);
+            chunk = slc(chunk, 0);
+        this.i.push(chunk, final);
     };
     AsyncUnzipInflate.compression = 8;
     return AsyncUnzipInflate;
@@ -2431,7 +2461,6 @@ var Unzip = /*#__PURE__*/ (function () {
             }
             var l = buf.length, oc = this.c, add = oc && this.d;
             var _loop_2 = function () {
-                var _a;
                 var sig = b4(buf, i);
                 if (sig == 0x4034B50) {
                     f = 1, is = i;
@@ -2442,13 +2471,11 @@ var Unzip = /*#__PURE__*/ (function () {
                         var chks_3 = [];
                         this_1.k.unshift(chks_3);
                         f = 2;
-                        var sc_1 = b4(buf, i + 18), su_1 = b4(buf, i + 22);
+                        var lsc = b4(buf, i + 18), lsu = b4(buf, i + 22);
                         var fn_1 = strFromU8(buf.subarray(i + 30, i += 30 + fnl), !u);
-                        if (sc_1 == 4294967295) {
-                            _a = dd ? [-2] : z64e(buf, i), sc_1 = _a[0], su_1 = _a[1];
-                        }
-                        else if (dd)
-                            sc_1 = -1;
+                        var _a = z64hs(buf, i, es, 2, lsc, lsu, 0), sc_1 = _a[0], su_1 = _a[1], z64 = _a[3];
+                        if (dd)
+                            sc_1 = -1 - z64;
                         i += es;
                         this_1.c = sc_1;
                         var d_1;
@@ -2561,7 +2588,7 @@ export function unzip(data, opts, cb) {
     if (lft) {
         var c = lft;
         var o = b4(data, e + 16);
-        var z = o == 4294967295 || c == 65535;
+        var z = b4(data, e - 20) == 0x7064B50;
         if (z) {
             var ze = b4(data, e - 12);
             z = b4(data, ze) == 0x6064B50;
@@ -2641,7 +2668,7 @@ export function unzipSync(data, opts) {
     if (!c)
         return {};
     var o = b4(data, e + 16);
-    var z = o == 4294967295 || c == 65535;
+    var z = b4(data, e - 20) == 0x7064B50;
     if (z) {
         var ze = b4(data, e - 12);
         z = b4(data, ze) == 0x6064B50;

package/examples/jsm/libs/mikktspace.README.md

@@ -0,0 +1,27 @@
+# MikkTSpace
+
+JavaScript port of [Morten S. Mikkelsen's MikkTSpace reference](https://github.com/mmikk/MikkTSpace/blob/3e895b49d05ea07e4c2133156cfa94369e19e409/mikktspace.c), specialized for the triangle input and tangent output used by `BufferGeometryUtils.computeMikkTSpaceTangents()`.
+
+```js
+import * as MikkTSpace from 'three/addons/libs/mikktspace.module.js';
+
+const tangents = MikkTSpace.generateTangents( positions, normals, uvs );
+```
+
+The inputs are matching, non-indexed `Float32Array` attributes: three position and normal components, and two UV components per vertex. Input components should be finite and normals should be unit length. As in the reference, extreme magnitudes can overflow intermediate float32 arithmetic. The result contains four components per vertex: tangent XYZ and handedness W. `computeMikkTSpaceTangents()` handles indexed, normalized, and interleaved geometry attributes and negates W by default for conventions such as glTF.
+
+There is no initialization or WebAssembly dependency. The `isReady` and `ready` exports remain available for existing callers; `isReady` is always `true` and `ready` is an already resolved promise. `dispose()` is retained as a no-op because there are no persistent buffers to release.
+
+The port retains attribute welding, connected orientation groups, angular subgroups, corner-angle weighting, float32 arithmetic, and degenerate-triangle fallback. Typed hash tables replace sorting and linear lookups, and projected derivatives and corner angles are reused within each group. It supports the reference's default 180-degree threshold and basic tangent output. Quads, custom thresholds, and bitangent/magnitude output are not exposed by this API.
+
+## Compatibility
+
+This port intentionally corrects an edge-pairing defect in `BuildNeighborsFast()` in the upstream C revision linked above. Its two secondary sorting loops omit their final buckets. This can leave identical edges separated or use a different face order when pairing nonmanifold edges. The JavaScript implementation pairs all edges in face order.
+
+This correction is part of the JavaScript port and is absent from the linked upstream C revision. For comparison, a local copy of that C revision was patched to add both missing final bucket sorts. The JavaScript output matches that locally patched copy on the tested inputs.
+
+The bundled WASM implementation also contains this defect. Consequently, the new implementation can produce different tangents on affected meshes. For `ShaderBall.glb`, the preview mesh is identical; the calibration mesh changes at 129 corners, with a maximum angular difference of approximately 0.353 degrees and no handedness changes.
+
+Completely collapsed triangles with no usable neighbor return the default `(1, 0, 0, -1)` already provided by the unmodified C reference. The previous WASM implementation could throw on these inputs. Empty input returns an empty array.
+
+The original license is preserved in `mikktspace.module.js`, which is explicitly marked as an altered JavaScript port.