x_ite 8.6.17 → 8.6.19

package/docs/_config.yml

@@ -20,7 +20,7 @@ timezone:
 # ↓ --------------------------
 
 title: X_ITE X3D Browser               # the main title
-version: 8.6.17                         # x_ite latest version
+version: 8.6.19                         # x_ite latest version
 size: 290                              # size in kb
 x3d_latest_version: 4.0                # x3d latest version
 

package/docs/_posts/getting-started.md

@@ -544,7 +544,7 @@ There is a ZIP archive available to locally install X_ITE on your server. Compre
 
 ### You can also get it on NPM
 
-```sh
+```console
 $ npm install x_ite
 ```
 

package/docs/_posts/reference/prototype-services.md

@@ -87,9 +87,9 @@ The value is one of the *_STATE* properties defined in the X3DConstants object.
 
 Creates a new default instance of the extern prototype.
 
-#### void **loadNow** ()
+#### Promise\<void\> **loadNow** ()
 
-Triggers the load of the extern prototype. If the extern prototype is already loaded or the load is already in progress, this request is silently ignored.
+Triggers the loading of the extern prototype. It returns a Promise that is resolved when the extern prototype is completely loaded and all instances are updated.
 
 #### String **toVRMLString** (\[options\])
 

package/docs/_posts/setup-a-localhost-server.md

@@ -29,14 +29,14 @@ If you have [Python](https://www.python.org){:target="_blank"} installed, then i
 
 Just open a Terminal and go to the directory you want to make available.
 
-```sh
+```console
 # Let's make the Desktop directory available.
 $ cd Desktop
 ```
 
 Type in the following command to start the server.
 
-```sh
+```console
 $ python3 -m http.server
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "x_ite",
-	"version": "8.6.17",
+	"version": "8.6.19",
 	"description": "X_ITE X3D Browser, view and manipulate X3D and VRML scenes in HTML.",
 	"homepage": "https://create3000.github.io/x_ite/",
 	"author": "Holger Seelig <holger.seelig@gmail.com>",
@@ -71,13 +71,13 @@
 		"opentype.js": "^1.3.4",
 		"pako": "^2.1.0",
 		"string-replace-webpack-plugin": "^0.1.3",
-		"webpack": "^5.78.0",
-		"webpack-cli": "^5.0.1",
+		"webpack": "^5.80.0",
+		"webpack-cli": "^5.0.2",
 		"webpack-shell-plugin-next": "^2.3.1"
 	},
 	"scripts": {
 		"test": "cd ../x_ite-tests && npm test",
-		"lint": "jshint **",
+		"lint": "eslint src",
 		"build": "make",
 		"-prebuild:js": "npm run lint"
 	}

package/src/example.html

@@ -16,6 +16,6 @@ x3d-canvas {
     <x3d-canvas src="https://create3000.github.io/media/x_ite/info/info.x3d">
       <p>Your browser may not support all features required by X_ITE!</p>
     </x3d-canvas>
-    <p>If local files are not loaded <a href="https://create3000.github.io/x_ite/#using-firefox-chrome-and-opera-with-local-files">consider setup a localhost server</a>.</p>
+    <a>If local files are not loaded <a href="https://create3000.github.io/x_ite/setup-a-localhost-server">consider setup a localhost server</a> or use <a href="https://create3000.github.io/x_ite/dom-integration">DOM Integration methods</a>.</p>
   </body>
 </html>

package/src/standard/Math/Algorithm.js

@@ -231,4 +231,4 @@ export default class Algorithm
 
       return first;
    }
-};
+}

package/src/standard/Math/Algorithms/MergeSort.js

@@ -76,26 +76,28 @@ MergeSort .prototype =
    },
    merge: function (lo, m, hi)
    {
+      const { array, auxiliary, compare } = this;
+
       let i, j, k;
 
       i = 0, j = lo;
       // Copy first half of array a to auxiliary array b.
       while (j <= m)
-         this .auxiliary [i++] = this .array [j++];
+         auxiliary [i++] = array [j++];
 
       i = 0; k = lo;
       // Copy back next-greatest element at each time.
       while (k < j && j <= hi)
       {
-         if (this .compare (this .array [j], this .auxiliary [i]))
-            this .array [k++] = this .array [j++];
+         if (compare (array [j], auxiliary [i]))
+            array [k++] = array [j++];
          else
-            this .array [k++] = this .auxiliary [i++];
+            array [k++] = auxiliary [i++];
       }
 
       // Copy back remaining elements of first half (if any).
       while (k < j)
-         this .array [k++] = this .auxiliary [i++];
+         array [k++] = auxiliary [i++];
    }
 };
 

package/src/standard/Math/Algorithms/PartialSort.js

@@ -68,6 +68,8 @@ PartialSort .prototype =
    },
    partialsort: function (lo, hi)
    {
+      const { array, compare } = this;
+
       let gap = this .last, i, last;
 
       if (gap > 1)
@@ -77,7 +79,7 @@ PartialSort .prototype =
       {
          const j = i + gap;
 
-         if (this .compare (this .array [j], this .array [i]))
+         if (compare (array [j], array [i]))
          {
             const t = array [i];
             array [i] = array [j];

package/src/standard/Math/Algorithms/QuickSort.js

@@ -70,9 +70,7 @@ QuickSort .prototype =
          i = lo,
          j = hi;
 
-      const
-         array   = this .array,
-         compare = this .compare;
+      const { array, compare } = this;
 
       // Vergleichs­element x
       const x = array [(lo + hi) >>> 1];

package/src/standard/Math/Geometry/Box2.js

@@ -48,7 +48,7 @@
 import Matrix3 from "../Numbers/Matrix3.js";
 import Vector2 from "../Numbers/Vector2.js";
 
-function Box2 (size, center)
+function Box2 (/* size, center */)
 {
    this .matrix = new Matrix3 ();
 

package/src/standard/Math/Geometry/Box3.js

@@ -50,7 +50,7 @@ import Matrix4   from "../Numbers/Matrix4.js";
 import Vector3   from "../Numbers/Vector3.js";
 import SAT       from "../Algorithms/SAT.js";
 
-function Box3 (size, center)
+function Box3 (/* size, center */)
 {
    this .matrix = new Matrix4 ();
 

package/src/standard/Math/Numbers/Quaternion.js

@@ -46,6 +46,7 @@
  ******************************************************************************/
 
 import Vector3   from "./Vector3.js";
+import Matrix3   from "./Matrix3.js";
 import Algorithm from "../Algorithm.js";
 
 function Quaternion (x, y, z, w)
@@ -137,7 +138,7 @@ Quaternion .prototype =
 
       return this;
    },
-   getMatrix: function (matrix)
+   getMatrix: function (matrix = new Matrix3 ())
    {
       const { x, y, z, w } = this;
 
@@ -168,11 +169,11 @@ Quaternion .prototype =
    },
    isReal: function ()
    {
-      return ! (this .x || this .y || this .z);
+      return !(this .x || this .y || this .z);
    },
    isImag: function ()
    {
-      return ! this .w;
+      return !this .w;
    },
    equals: function (quat)
    {

package/src/standard/Math/Numbers/Rotation4.js

@@ -48,6 +48,7 @@
 import Quaternion from "./Quaternion.js";
 import Vector3    from "./Vector3.js";
 import Vector4    from "./Vector4.js";
+import Matrix3    from "./Matrix3.js";
 import Algorithm  from "../Algorithm.js";
 
 const
@@ -280,7 +281,7 @@ Rotation4 .prototype =
    {
       this .set (vector .x, vector .y, vector .z, this [_angle]);
    },
-   getAxis: function (axis)
+   getAxis: function (axis = new Vector3 (0, 0, 0))
    {
       return axis .set (this [_x], this [_y], this [_z]);
    },
@@ -290,7 +291,7 @@ Rotation4 .prototype =
       this .update ();
       return this;
    },
-   getQuaternion: function (quaternion)
+   getQuaternion: function (quaternion = new Quaternion (0, 0, 0, 1))
    {
       return quaternion .assign (this [_quaternion]);
    },
@@ -300,7 +301,7 @@ Rotation4 .prototype =
       this .update ();
       return this;
    },
-   getMatrix: function (matrix)
+   getMatrix: function (matrix = new Matrix3 ())
    {
       return this [_quaternion] .getMatrix (matrix);
    },

package/src/x_ite/Base/X3DBaseNode.js

@@ -64,7 +64,7 @@ const
    _childObjects      = Symbol (),
    _initialized       = Symbol (),
    _live              = Symbol (),
-   _set_live__        = Symbol ("X3DBaseNode.set_live__"),
+   _set_live__        = Symbol (),
    _cloneCount        = Symbol ();
 
 function X3DBaseNode (executionContext)
@@ -245,22 +245,15 @@ X3DBaseNode .prototype = Object .assign (Object .create (X3DEventObject .prototy
    {
       return new (this .constructor) (executionContext || this [_executionContext]);
    },
-   setup: (function ()
+   setup: function ()
    {
-      const attributes = { value: Function .prototype, enumerable: false };
-
-      return function ()
-      {
-         Object .defineProperty (this, "setup", attributes);
-
-         for (const field of this [_fields])
-            field .setTainted (false);
+      for (const field of this [_fields])
+         field .setTainted (false);
 
-         this .initialize ();
+      this .initialize ();
 
-         this [_initialized] = true;
-      };
-   })(),
+      this [_initialized] = true;
+   },
    initialize: function ()
    { },
    isInitialized: function ()
@@ -313,10 +306,6 @@ X3DBaseNode .prototype = Object .assign (Object .create (X3DEventObject .prototy
    {
       return this [_fieldDefinitions];
    },
-   getFieldsAreEnumerable: function ()
-   {
-      return false;
-   },
    addField: function (fieldDefinition)
    {
       const
@@ -336,7 +325,7 @@ X3DBaseNode .prototype = Object .assign (Object .create (X3DEventObject .prototy
       {
          get: function () { return field; },
          set: function (value) { field .setValue (value); },
-         enumerable: this .getFieldsAreEnumerable (),
+         enumerable: false,
          configurable: true, // false : non deletable
       });
 
@@ -520,10 +509,6 @@ X3DBaseNode .prototype = Object .assign (Object .create (X3DEventObject .prototy
    {
       return this [_fields];
    },
-   getSourceText: function ()
-   {
-      return null;
-   },
    hasRoutes: function ()
    {
       ///  Returns true if there are any routes from or to fields of this node otherwise false.
@@ -605,7 +590,7 @@ X3DBaseNode .prototype = Object .assign (Object .create (X3DEventObject .prototy
       for (const field of this [_childObjects])
          field .dispose ();
 
-      for (const field of this .getFields ())
+      for (const field of this [_fields])
          field .dispose ();
 
       X3DEventObject .prototype .dispose .call (this);

package/src/x_ite/Base/X3DEventObject.js

@@ -48,7 +48,7 @@
 import X3DChildObject from "./X3DChildObject.js";
 import Events         from "./Events.js";
 
-const _browser = Symbol .for ("X3DEventObject.browser");
+const _browser = Symbol .for ("X_ITE.X3DEventObject.browser");
 
 function X3DEventObject (browser)
 {
@@ -66,6 +66,7 @@ X3DEventObject .prototype = Object .assign (Object .create (X3DChildObject .prot
    },
    getExtendedEventHandling: function ()
    {
+      // Whether initializeOnly field are treated like inputOnly and inputOutput fields.
       return true;
    },
    addEvent: function (field)
@@ -83,15 +84,15 @@ X3DEventObject .prototype = Object .assign (Object .create (X3DChildObject .prot
 
       // Register for processEvent
 
-      browser .addBrowserEvent ();
       browser .addTaintedField (field, event);
+      browser .addBrowserEvent ();
 
       // Register for eventsProcessed
 
       if (this .isTainted ())
          return;
 
-      if (field .isInput () || (this .getExtendedEventHandling () && ! field .isOutput ()))
+      if (field .isInput () || (this .getExtendedEventHandling () && field .isInitializable ()))
       {
          this .addNodeEvent ();
       }

package/src/x_ite/Base/X3DField.js

@@ -61,15 +61,13 @@ const
    _inputRoutes         = Symbol (),
    _outputRoutes        = Symbol (),
    _routeCallbacks      = Symbol (),
-   _uniformLocation     = Symbol .for ("X3DField.uniformLocation");
+   _uniformLocation     = Symbol .for ("X_ITE.X3DField.uniformLocation");
 
 function X3DField (value)
 {
    X3DChildObject .call (this);
 
    this [_value] = value;
-
-   return this;
 }
 
 X3DField .prototype = Object .assign (Object .create (X3DChildObject .prototype),
@@ -78,7 +76,6 @@ X3DField .prototype = Object .assign (Object .create (X3DChildObject .prototype)
    [_value]: null,
    [_accessType]: X3DConstants .initializeOnly,
    [_unit]: null,
-   [_uniformLocation]: null,
    [_references]: new Set (),
    [_referencesCallbacks]: new Map (),
    [_fieldInterests]: new Set (),
@@ -86,6 +83,7 @@ X3DField .prototype = Object .assign (Object .create (X3DChildObject .prototype)
    [_inputRoutes]: new Set (),
    [_outputRoutes]: new Set (),
    [_routeCallbacks]: new Map (),
+   [_uniformLocation]: null,
    create: function ()
    {
       return new (this .constructor) ();
@@ -367,32 +365,31 @@ X3DField .prototype = Object .assign (Object .create (X3DChildObject .prototype)
          if (field !== this)
             this .set (field .getValue (), field .length);
 
-         // Process interests
+         // Process interests.
 
          this .processInterests ();
 
-         // Process routes
+         // Process routes.
 
          let first = true;
 
-         if (this [_fieldInterests] .size)
+         for (const fieldInterest of this [_fieldInterests])
          {
-            for (const fieldInterest of this [_fieldInterests] .values ())
+            if (first)
+            {
+               first = false;
+               fieldInterest .addEventObject (this, event);
+            }
+            else
             {
-               if (first)
-               {
-                  first = false;
-                  fieldInterest .addEventObject (this, event);
-               }
-               else
-                  fieldInterest .addEventObject (this, Events .copy (event));
+               fieldInterest .addEventObject (this, Events .copy (event));
             }
          }
 
          if (first)
             Events .push (event);
 
-         // Process field callbacks
+         // Process field callbacks.
 
          if (this [_fieldCallbacks] .size)
          {
@@ -403,16 +400,18 @@ X3DField .prototype = Object .assign (Object .create (X3DChildObject .prototype)
    })(),
    addCloneCount: Function .prototype,
    removeCloneCount: Function .prototype,
-   valueOf: function ()
-   {
-      return this;
-   },
    fromString: function (string, scene)
    {
       // Function will be overridden in VRMLParser.
    },
    dispose: function ()
    {
+      this [_references]          .clear ();
+      this [_referencesCallbacks] .clear ();
+      this [_fieldInterests]      .clear ();
+      this [_fieldCallbacks]      .clear ();
+      this [_routeCallbacks]      .clear ();
+
       for (const route of new Set (this [_inputRoutes]))
          route .dispose ();
 

package/src/x_ite/Base/X3DObject.js

@@ -183,7 +183,11 @@ X3DObject .prototype =
    {
       generator .string = "[object " + this .getTypeName () + "]";
    },
-   dispose: function () { },
+   dispose: function ()
+   {
+      this [_interests] .clear ();
+      this [_userData]  .clear ();
+   },
 };
 
 for (const key of Reflect .ownKeys (X3DObject .prototype))

package/src/x_ite/Base/X3DObjectArrayField.js

@@ -188,7 +188,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
 
       for (let i = 0; i < length; ++ i)
       {
-         if (! a [i] .equals (b [i]))
+         if (!a [i] .equals (b [i]))
             return false;
       }
 
@@ -361,7 +361,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
             {
                const current = values [i];
 
-               if (! value (current .valueOf ()))
+               if (!value (current .valueOf ()))
                {
                   const tmp = values [first];
 
@@ -385,7 +385,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
          {
             const current = values [i];
 
-            if (! current .equals (value))
+            if (!current .equals (value))
             {
                const tmp = values [first];
 
@@ -413,25 +413,26 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
 
       return values .map (function (value) { return value .valueOf () });
    },
-   resize: function (size, value, silent)
+   resize: function (size, value, silently)
    {
       const
          target = this [_target],
-         array  = target .getValue ();
+         array  = target .getValue (),
+         length = array .length;
 
-      if (size < array .length)
+      if (size < length)
       {
-         for (let i = size, length = array .length; i < length; ++ i)
+         for (let i = size; i < length; ++ i)
             target .removeChildObject (array [i]);
 
          array .length = size;
 
-         if (! silent)
+         if (!silently)
             target .addEvent ();
       }
-      else if (size > array .length)
+      else if (size > length)
       {
-         for (let i = array .length; i < size; ++ i)
+         for (let i = length; i < size; ++ i)
          {
             const field = new (target .getSingleType ()) ();
 
@@ -442,7 +443,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
             array .push (field);
          }
 
-         if (! silent)
+         if (!silently)
             target .addEvent ();
       }
    },

package/src/x_ite/Base/X3DTypedArrayField.js

@@ -603,7 +603,7 @@ X3DTypedArrayField .prototype = Object .assign (Object .create (X3DArrayField .p
 
       return values .slice ();
    },
-   resize: function (newLength, value, silent)
+   resize: function (newLength, value, silently)
    {
       const
          target     = this [_target],
@@ -619,7 +619,7 @@ X3DTypedArrayField .prototype = Object .assign (Object .create (X3DArrayField .p
          if (components > 1)
             target [_cache] .length = newLength;
 
-         if (!silent)
+         if (!silently)
             target .addEvent ();
       }
       else if (newLength > length)
@@ -644,7 +644,7 @@ X3DTypedArrayField .prototype = Object .assign (Object .create (X3DArrayField .p
             }
          }
 
-         if (!silent)
+         if (!silently)
             target .addEvent ();
       }
 

package/src/x_ite/Browser/Core/Context.js

@@ -227,7 +227,7 @@ const Context =
                   }
                };
 
-               setTimeout (check, 0);
+               setTimeout (check);
             });
          },
          getBufferSubDataAsync: async function (target, buffer, srcByteOffset, dstBuffer, /* optional */ dstOffset, /* optional */ length)

package/src/x_ite/Browser/Navigation/ExamineViewer.js

@@ -449,7 +449,7 @@ ExamineViewer .prototype = Object .assign (Object .create (X3DViewer .prototype)
             {
                this .tapedTwice = true;
 
-               setTimeout (function () { this .tapedTwice = false; } .bind (this), 300);
+               setTimeout (() => this .tapedTwice = false, 300);
             }
 
             break;

package/src/x_ite/Browser/Networking/X3DNetworkingContext.js

@@ -102,7 +102,6 @@ X3DNetworkingContext .prototype =
 
       this [_defaultScene] .setPrivate (true);
       this [_defaultScene] .setLive (true);
-      this [_defaultScene] .setup ();
 
       this .getDefaultScene = function () { return this [_defaultScene]; };
 
@@ -110,15 +109,18 @@ X3DNetworkingContext .prototype =
 
       return this [_defaultScene];
    },
+   getBrowserLoading: function ()
+   {
+      return this [_loading];
+   },
    setBrowserLoading: function (value)
    {
       this [_loading] = value;
 
-      this .setLoadCount (0);
-
       if (value)
       {
-         this .resetLoadCount ();
+         if (!this [_loadingObjects] .has (this))
+            this .resetLoadCount ();
 
          this .getShadow () .find (".x_ite-private-world-info") .remove ();
 
@@ -138,9 +140,9 @@ X3DNetworkingContext .prototype =
          }
       }
    },
-   getLoading: function ()
+   getLoadingObjects: function ()
    {
-      return this [_loading];
+      return this [_loadingObjects];
    },
    addLoadingObject: function (object)
    {
@@ -162,6 +164,11 @@ X3DNetworkingContext .prototype =
       this [_loadingObjects] .delete (object);
 
       this .setLoadCount (this [_loadingObjects] .size);
+      this .setCursor (this .getCursor ());
+   },
+   getDisplayLoadCount: function ()
+   {
+      return [... this [_loadingObjects]] .reduce ((v, o) => v + !(o .isPrivate ?.() ?? true), 0);
    },
    setLoadCount: function (value)
    {
@@ -180,9 +187,7 @@ X3DNetworkingContext .prototype =
    },
    [_set_loadCount]: function ()
    {
-      const loadingDisplay = [... this [_loadingObjects]]
-         .filter (o => o .isPrivate)
-         .reduce ((v, o) => v + !o .isPrivate (), 0);
+      const loadingDisplay = this .getDisplayLoadCount ();
 
       if (this ._loadCount .getValue () || this [_loading])
       {

package/src/x_ite/Browser/PointingDeviceSensor/X3DPointingDeviceSensorContext.js

@@ -135,9 +135,9 @@ X3DPointingDeviceSensorContext .prototype =
             break;
          default:
          {
-            if (this ._loadCount .getValue ())
+            if (this .getDisplayLoadCount ())
                div .css ("cursor", "wait");
-            else if (this [_pointingDevice] && this [_pointingDevice] .isOver)
+            else if (this [_pointingDevice] ?.isOver)
                div .css ("cursor", "pointer");
             else
                div .css ("cursor", "default");

package/src/x_ite/Browser/VERSION.js

@@ -45,4 +45,4 @@
  *
  ******************************************************************************/
 
-export default "8.6.17";
+export default "8.6.19";