x_ite 8.7.2 → 8.7.4

package/docs/_config.yml

@@ -20,8 +20,8 @@ timezone:
 # ↓ --------------------------
 
 title: X_ITE X3D Browser               # the main title
-version: 8.7.2                         # x_ite latest version
-size: 291                              # size in kb
+version: 8.7.4                         # x_ite latest version
+size: 290                              # size in kb
 x3d_latest_version: 4.0                # x3d latest version
 
 tagline: Step Into The Future          # it will display as the sub-title

package/docs/_posts/getting-started.md

@@ -717,6 +717,8 @@ Type: script code. This event is sent to an \<x3d-canvas\> element when an error
 
 Type: script code. This event handler will be called on the \<x3d-canvas\> element when a scene has finished loading. This applies whether the scene is applied via the *src* attribute or when a scene is loaded or replaced by another world. If you change the scene, the event will fire again when the new scene loads. This event will not bubble up the element tree.
 
+The onload event handler will also be called at the very beginning when the initial empty scene is loaded.
+
 ### onshutdown
 
 Type: script code. This event handler will be called on the \<x3d-canvas\> element when a scene is unloaded or replaced by another world.

package/docs/_posts/reference/field-services-and-objects.md

@@ -814,7 +814,7 @@ Returns true if the passed MF* *array* of the same type is equals to this object
 
 #### Other Array functions
 
-Common Array functions like `at`, `concat`, `entries`, `every`, `fill`, `filter`, `find`, `findIndex`, `findLast`, `findLastIndex`, `flat`, `flatMap`, `forEach`, `includes`, `indexOf`, `join`, `keys`, `lastIndexOf`, `map`, `pop`, `push`, `reduce`, `reduceRight`, `reverse`, `shift`, `slice`, `some`, `sort`, `splice`, `unshift`, `values` are also available.
+Common Array functions like `at`, `entries`, `every`, `fill`, `filter`, `find`, `findIndex`, `findLast`, `findLastIndex`, `forEach`, `includes`, `indexOf`, `join`, `keys`, `lastIndexOf`, `map`, `pop`, `push`, `reduce`, `reduceRight`, `reverse`, `shift`, `slice`, `some`, `sort`, `splice`, `toReversed`, `toSorted`, `toSpliced`, `unshift`, `values`, `with` are also available.
 
 ## MFBool Object
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "x_ite",
-	"version": "8.7.2",
+	"version": "8.7.4",
 	"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>",
@@ -59,8 +59,8 @@
 		"css-element-queries": "^1.2.3",
 		"dicom-parser": "^1.8.21",
 		"jpeg-js": "^0.4.4",
-		"jpeg-lossless-decoder-js": "2.0.4",
-		"jquery": "^3.6.4",
+		"jpeg-lossless-decoder-js": "^2.0.7",
+		"jquery": "^3.7.0",
 		"jquery-fullscreen-plugin": "^1.1.5",
 		"jquery-mousewheel": "^3.1.13",
 		"libgif": "^0.0.3",

package/src/bookmarks.js

@@ -87,8 +87,9 @@ const Bookmarks = (function ()
                   if (! path .match (/\.(?:x3d|x3dz|x3dv|x3dvz|x3dj|x3djz|wrl|wrz)$/))
                      continue;
 
-                  const basename = path .match (/([^\/]+)\.\w+$/);
-                  const name     = basename [1] .replace (/([A-Z]+)/g, ' $1');
+                  const
+                     basename = path .match (/([^\/]+)\.\w+$/),
+                     name     = basename [1] .replace (/([A-Z]+)/g, ' $1');
 
                   var element = $('<span/>')
                      .addClass ('example-box')

package/src/standard/Math/Algorithm.js

@@ -169,6 +169,24 @@ export default class Algorithm
       return lhs > rhs ? 1 : lhs < rhs ? -1 : 0;
    }
 
+   // static lexicographicallyCompare (lhs, rhs)
+   // {
+   //    const
+   //       length1 = lhs .length,
+   //       length2 = rhs .length;
+
+   //    for (let i = 0; i < length1 && i < length2; ++ i)
+   //    {
+   //       if (lhs [i] < rhs [i])
+   //          return -1;
+
+   //       if (rhs [i] < lhs [i])
+   //          return 1;
+   //    }
+
+   //    return Algorithm .cmp (length1, length2);
+   // }
+
    static less (lhs, rhs)
    {
       return lhs < rhs;

package/src/x_ite/Base/FieldArray.js

@@ -46,10 +46,11 @@
  ******************************************************************************/
 
 import X3DInfoArray from "./X3DInfoArray.js";
+import X3DField     from "./X3DField.js";
 
-function FieldArray ()
+function FieldArray (values)
 {
-   return X3DInfoArray .call (this);
+   return X3DInfoArray .call (this, values, X3DField);
 }
 
 FieldArray .prototype = Object .assign (Object .create (X3DInfoArray .prototype),

package/src/x_ite/Base/FieldDefinitionArray.js

@@ -45,11 +45,12 @@
  *
  ******************************************************************************/
 
-import X3DInfoArray from "./X3DInfoArray.js";
+import X3DInfoArray       from "./X3DInfoArray.js";
+import X3DFieldDefinition from "./X3DFieldDefinition.js"
 
 function FieldDefinitionArray (values)
 {
-   return X3DInfoArray .call (this, values);
+   return X3DInfoArray .call (this, values, X3DFieldDefinition);
 }
 
 FieldDefinitionArray .prototype = Object .assign (Object .create (X3DInfoArray .prototype),

package/src/x_ite/Base/X3DArrayField.js

@@ -55,31 +55,67 @@ function X3DArrayField (value)
 X3DArrayField .prototype = Object .assign (Object .create (X3DField .prototype),
 {
    constructor: X3DArrayField,
+   // Implement all function also in TypedArray, if possible.
    at: Array .prototype .at,
-   concat: Array .prototype .concat,
-   //Array.prototype.copyWithin,
+   // concat: Array .prototype .concat,
+   // copyWithin: Array.prototype.copyWithin,
    entries: Array .prototype .entries,
    every: Array .prototype .every,
    fill: Array .prototype .fill,
-   filter: Array .prototype .filter,
+   filter: function (callbackFn, thisArg)
+   {
+      return new (this .constructor) (... Array .prototype .filter .call (this, callbackFn, thisArg));
+   },
    find: Array .prototype .find,
    findIndex: Array .prototype .findIndex,
    findLast: Array .prototype .findLast,
    findLastIndex: Array .prototype .findLastIndex,
-   flat: Array .prototype .flat,
-   flatMap: Array .prototype .flatMap,
+   // flat: Array .prototype .flat,
+   // flatMap: Array .prototype .flatMap,
    forEach: Array .prototype .forEach,
    includes: Array .prototype .includes,
    indexOf: Array .prototype .indexOf,
    join: Array .prototype .join,
    keys: Array .prototype .keys,
    lastIndexOf: Array .prototype .lastIndexOf,
-   map: Array .prototype .map,
+   map: function (callbackFn, thisArg)
+   {
+      return new (this .constructor) (... Array .prototype .map .call (this, callbackFn, thisArg));
+   },
    reduce: Array .prototype .reduce,
    reduceRight: Array .prototype .reduceRight,
-   slice: Array .prototype .slice,
+   reverse: Array .prototype .reverse,
+   slice: function (start, end)
+   {
+      return new (this .constructor) (... Array .prototype .slice .call (this, start, end));
+   },
    some: Array .prototype .some,
+   sort: Array .prototype .sort,
+   toReversed: function ()
+   {
+      return this .copy () .reverse ();
+   },
+   toSorted: function (compareFn)
+   {
+      return this .copy () .sort (compareFn);
+   },
+   toSpliced: function (start, deleteCount, ... insertValues)
+   {
+      const copy = this .copy ();
+
+      copy .splice (start, deleteCount, ... insertValues);
+
+      return copy;
+   },
    values: Array .prototype .values,
+   with: function (index, value)
+   {
+      const copy = this .copy ();
+
+      copy [index] = value;
+
+      return copy;
+   },
 });
 
 for (const key of Reflect .ownKeys (X3DArrayField .prototype))

package/src/x_ite/Base/X3DInfoArray.js

@@ -108,16 +108,20 @@ const handler =
    },
 };
 
-function X3DInfoArray (values)
+function X3DInfoArray (values, ValueType)
 {
-   this [_array]           = [ ];
-   this [_index]           = new Map ();
-   this [Symbol .iterator] = this [_array] [Symbol .iterator];
+   this [_array] = [ ];
+   this [_index] = new Map ();
 
    if (values)
    {
       for (const value of values)
+      {
+         if (!(value instanceof ValueType))
+            throw new TypeError (`Wrong type in construction of ${this .getTypeName ()}.`);
+
          this .add (value .name, value);
+      }
    }
 
    return new Proxy (this, handler);
@@ -125,11 +129,19 @@ function X3DInfoArray (values)
 
 X3DInfoArray .prototype = {
    constructor: X3DInfoArray,
+   [Symbol .iterator]: function* ()
+   {
+      yield* this [_array];
+   },
+   copy: function ()
+   {
+      return new (this .constructor) (this [_array]);
+   },
    equals: function (array)
    {
       const
          a      = this [_array],
-         b      = array [_array] || array,
+         b      = array [_array],
          length = a .length;
 
       if (a === b)
@@ -165,6 +177,8 @@ X3DInfoArray .prototype = {
    },
    update: function (oldKey, newKey, value)
    {
+      // TODO: update alias.
+
       const oldValue = this [_index] .get (oldKey);
 
       if (oldKey !== newKey)
@@ -187,6 +201,8 @@ X3DInfoArray .prototype = {
    },
    remove: function (key)
    {
+      // TODO: remove alias.
+
       const value = this [_index] .get (key);
 
       if (value === undefined)
@@ -200,29 +216,65 @@ X3DInfoArray .prototype = {
          this [_array] .splice (index, 1);
    },
    at: Array .prototype .at,
-   concat: Array .prototype .concat,
+   // concat: Array .prototype .concat,
+   // copyWithin: Array.prototype.copyWithin,
    entries: Array .prototype .entries,
    every: Array .prototype .every,
-   fill: Array .prototype .fill,
-   filter: Array .prototype .filter,
+   // fill: Array .prototype .fill,
+   filter: function (callbackFn, thisArg)
+   {
+      return new (this .constructor) (Array .prototype .filter .call (this, callbackFn, thisArg));
+   },
    find: Array .prototype .find,
    findIndex: Array .prototype .findIndex,
    findLast: Array .prototype .findLast,
    findLastIndex: Array .prototype .findLastIndex,
-   flat: Array .prototype .flat,
-   flatMap: Array .prototype .flatMap,
+   // flat: Array .prototype .flat,
+   // flatMap: Array .prototype .flatMap,
    forEach: Array .prototype .forEach,
    includes: Array .prototype .includes,
    indexOf: Array .prototype .indexOf,
    join: Array .prototype .join,
    keys: Array .prototype .keys,
    lastIndexOf: Array .prototype .lastIndexOf,
-   map: Array .prototype .map,
+   map: function (callbackFn, thisArg)
+   {
+      return new (this .constructor) (Array .prototype .map .call (this, callbackFn, thisArg));
+   },
    reduce: Array .prototype .reduce,
    reduceRight: Array .prototype .reduceRight,
-   slice: Array .prototype .slice,
+   // reverse: Array .prototype .reverse,
+   slice: function (start, end)
+   {
+      return new (this .constructor) (Array .prototype .slice .call (this, start, end));
+   },
    some: Array .prototype .some,
+   // sort: Array .prototype .sort,
+   toReversed: function ()
+   {
+      return new (this .constructor) ([... this] .reverse ());
+   },
+   toSorted: function (compareFn)
+   {
+      return new (this .constructor) ([... this] .sort (compareFn));
+   },
+   toSpliced: function (start, deleteCount, ... insertValues)
+   {
+      const array = [... this];
+
+      array .splice (start, deleteCount, ... insertValues)
+
+      return new (this .constructor) (array);
+   },
    values: Array .prototype .values,
+   with: function (index, value)
+   {
+      const array = [... this];
+
+      array [index] = value;
+
+      return new (this .constructor) (array);
+   },
    toString: function (options = Object .prototype)
    {
       const generator = new Generator (options);
@@ -309,4 +361,9 @@ Object .defineProperty (X3DInfoArray .prototype, "length",
    get: function () { return this [_array] .length; },
 });
 
+Object .defineProperty (X3DInfoArray .prototype, Symbol .toStringTag,
+{
+   get: function () { return this .getTypeName (); },
+});
+
 export default X3DInfoArray;

package/src/x_ite/Base/X3DObject.js

@@ -135,6 +135,10 @@ X3DObject .prototype =
 
       this [_userData] .set (key, value);
    },
+   removeUserData: function (key)
+   {
+      this [_userData] .delete (key);
+   },
    toString: function (options = Object .prototype)
    {
       const generator = new Generator (options);
@@ -193,6 +197,11 @@ X3DObject .prototype =
 for (const key of Reflect .ownKeys (X3DObject .prototype))
    Object .defineProperty (X3DObject .prototype, key, { enumerable: false });
 
+Object .defineProperty (X3DObject .prototype, Symbol .toStringTag,
+{
+   get: function () { return this .getTypeName (); },
+});
+
 Object .assign (X3DObject,
 {
    getId: (function ()
@@ -215,6 +224,7 @@ Object .assign (X3DObject,
    })(),
 });
 
+// In the future we can use getId, because WeakMap will accept Symbols as key.
 const SymbolId = (function ()
 {
    const map = new Map ();

package/src/x_ite/Base/X3DObjectArrayField.js

@@ -47,7 +47,6 @@
 
 import X3DField      from "./X3DField.js";
 import X3DArrayField from "./X3DArrayField.js";
-import Algorithm     from "../../standard/Math/Algorithm.js";
 
 const
    _target = Symbol (),
@@ -126,10 +125,10 @@ const handler =
 
 function X3DObjectArrayField (value)
 {
-   const proxy = new Proxy (this, handler);
-
    X3DArrayField .call (this, [ ]);
 
+   const proxy = new Proxy (this, handler);
+
    this [_target] = this;
    this [_proxy]  = proxy;
 
@@ -282,7 +281,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
          return field .valueOf ();
       }
    },
-   splice: function (index, deleteCount)
+   splice: function (index, deleteCount, ... insertValues)
    {
       const
          target = this [_target],
@@ -296,8 +295,8 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
 
       const result = target .erase (index, index + deleteCount);
 
-      if (arguments .length > 2)
-         target .insert (index, arguments, 2, arguments .length);
+      if (insertValues .length)
+         target .insert (index, insertValues, 0, insertValues .length);
 
       return result;
    },
@@ -305,7 +304,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
    {
       const
          target = this [_target],
-         args   = [index, 0];
+         args   = [ ];
 
       for (let i = first; i < last; ++ i)
       {
@@ -316,7 +315,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
          args .push (field);
       }
 
-      Array .prototype .splice .apply (target .getValue (), args);
+      Array .prototype .splice .call (target .getValue (), index, 0, ... args);
 
       target .addEvent ();
    },
@@ -411,7 +410,7 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
 
       target .addEvent ();
 
-      return values .map (function (value) { return value .valueOf () });
+      return new (target .constructor) (values);
    },
    resize: function (size, value, silently)
    {
@@ -447,6 +446,14 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
             target .addEvent ();
       }
    },
+   addChildObject: function (value)
+   {
+      value .addParent (this [_proxy]);
+   },
+   removeChildObject: function (value)
+   {
+      value .removeParent (this [_proxy]);
+   },
    reverse: function ()
    {
       const target = this [_target];
@@ -454,24 +461,16 @@ X3DObjectArrayField .prototype = Object .assign (Object .create (X3DArrayField .
       target .getValue () .reverse ();
       target .addEvent ();
 
-      return this;
+      return target [_proxy];
    },
-   sort: function ()
+   sort: function (compareFn)
    {
       const target = this [_target];
 
-      target .getValue () .sort ((a, b) => Algorithm .cmp (a .valueOf (), b .valueOf ()));
+      Array .prototype .sort .call (this, compareFn);
       target .addEvent ();
 
-      return this;
-   },
-   addChildObject: function (value)
-   {
-      value .addParent (this [_proxy]);
-   },
-   removeChildObject: function (value)
-   {
-      value .removeParent (this [_proxy]);
+      return target [_proxy];
    },
    toStream: function (generator)
    {