date

Author: linev

build/jsroot.js

@@ -1,4 +1,4 @@
-// https://root.cern/js/ v6.99.99
+// https://root.cern/js/ v7.0.0
 (function (global, factory) {
 typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
 typeof define === 'function' && define.amd ? define(['exports'], factory) :
@@ -7,11 +7,11 @@ typeof define === 'function' && define.amd ? define(['exports'], factory) :
 
 /** @summary version id
   * @desc For the JSROOT release the string in format "major.minor.patch" like "6.3.0" */
-let version_id = "modules";
+let version_id = "7.0.x";
 
 /** @summary version date
   * @desc Release date in format day/month/year like "19/11/2021" */
-let version_date = "12/04/2022";
+let version_date = "19/04/2022";
 
 /** @summary version id and date
   * @desc Produced by concatenation of {@link version_id} and {@link version_date}
@@ -89,13 +89,11 @@ function isArrayProto(proto) {
     return proto.length == 14 ? 1 : 2;
 }
 
-/** @summary Specialized JSROOT constants, used in {@link settings}
-  * @namespace
-  * @private */
+/** @desc Specialized JSROOT constants, used in {@link settings}
+  * @namespace */
 let constants$1 = {
    /** @summary Kind of 3D rendering, used for {@link settings.Render3D}
-     * @namespace
-     * @private */
+     * @namespace */
    Render3D: {
       /** @summary Default 3D rendering, normally WebGL, if not supported - SVG */
       Default: 0,
@@ -113,29 +111,27 @@ let constants$1 = {
       }
    },
    /** @summary Way to embed 3D into SVG, used for {@link settings.Embed3D}
-     * @namespace
-     * @private */
+     * @namespace */
    Embed3D: {
       /** @summary Do not embed 3D drawing, use complete space */
       NoEmbed: -1,
-      /** @summary Default embeding mode, on Firefox is really ```Embed```, on all other ```Overlay``` */
+      /** @summary Default embeding mode - on Firefox and latest Chrome is real ```Embed```, on all other ```Overlay``` */
       Default: 0,
-      /** @summary WebGL canvas not inserted into SVG, but just overlayed The only way how Chrome browser can be used */
+      /** @summary WebGL canvas not inserted into SVG, but just overlayed The only way how earlier Chrome browser can be used */
       Overlay: 1,
-      /** @summary Really embed WebGL Canvas into SVG, only works with Firefox */
+      /** @summary Really embed WebGL Canvas into SVG */
       Embed: 2,
-      /** @summary Embeding, but when SVG rendering or SVG image converion is used
-        * @private */
+      /** @summary Embeding, but when SVG rendering or SVG image converion is used */
       EmbedSVG: 3,
+      /** @summary Convert string values into number  */
       fromString: function(s) {
          if (s === "embed") return this.Embed;
          if (s === "overlay") return this.Overlay;
          return this.Default;
       }
    },
    /** @summary How to use latex in text drawing, used for {@link settings.Latex}
-     * @namespace
-     * @private */
+     * @namespace */
    Latex: {
       /** @summary do not use Latex at all for text drawing */
       Off: 0,
@@ -147,6 +143,7 @@ let constants$1 = {
       MathJax: 3,
       /** @summary always use MathJax for text rendering */
       AlwaysMathJax: 4,
+      /** @summary Convert string values into number */
       fromString: function(s) {
          if (!s || (typeof s !== 'string'))
             return this.Normal;
@@ -170,12 +167,12 @@ let constants$1 = {
    }
 };
 
-/** @summary Central JSROOT settings, independent from {@link gStyle}
+/** @desc Global JSROOT settings
   * @namespace */
 let settings = {
    /** @summary Render of 3D drawing methods, see {@link constants.Render3D} for possible values */
    Render3D: constants$1.Render3D.Default,
-   /** @summary Render of 3D drawing methods in batch mode, see {@link constants.Render3D} for possible values */
+   /** @summary 3D drawing methods in batch mode, see {@link constants.Render3D} for possible values */
    Render3DBatch: constants$1.Render3D.Default,
    /** @summary Way to embed 3D drawing in SVG, see {@link constants.Embed3D} for possible values */
    Embed3D: constants$1.Embed3D.Default,
@@ -246,11 +243,6 @@ let settings = {
      * @desc Can be disabled to prevent keys heandling in complex HTML layouts
      * @default true */
    HandleKeys: true,
-  /** @summary Let tweak browser caching
-    * @desc When specified, extra URL parameter like ```?stamp=unique_value``` append to each JSROOT script loaded
-    * In such case browser will be forced to load JSROOT functionality disregards of server cache settings
-    * @default false */
-   NoCache: false,
    /** @summary Skip streamer infos from the GUI */
    SkipStreamerInfos: false,
    /** @summary Interactive dragging of TGraph points */
@@ -1629,19 +1621,6 @@ function _ensureJSROOT() {
    }).then(() => globalThis.JSROOT);
 }
 
-/** @summary Initialize JSROOT
-  * @desc Called when main JSRoot.core.js script is loaded.
-  * @private */
-if (source_fullpath) {
-
-   let d = decodeUrl(source_fullpath);
-
-   if (d.has('nocache')) settings.NoCache = (new Date).getTime(); // use timestamp to overcome cache limitation
-   if (d.has('wrong_http_response') || decodeUrl().has('wrong_http_response'))
-      settings.HandleWrongHttpResponse = true; // server may send wrong content length by partial requests, use other method to control this
-   if (d.has('nosap')) internals.sap = undefined; // let ignore sap loader even with openui5 loaded
-}
-
 var core = /*#__PURE__*/Object.freeze({
 __proto__: null,
 version_id: version_id,
@@ -10545,8 +10524,8 @@ class ObjectPainter extends BasePainter {
      * @param {object} obj - new version of object, values will be updated in original object
      * @param {string} [opt] - when specified, new draw options
      * @returns {boolean|Promise} for object redraw
-     * @desc Two actions typically done by redraw - update object content via {@link ObjectPainter.updateObject} and
-      * then redraw correspondent pad via {@link ObjectPainter.redrawPad}. If possible one should redefine
+     * @desc Two actions typically done by redraw - update object content via {@link ObjectPainter#updateObject} and
+      * then redraw correspondent pad via {@link ObjectPainter#redrawPad}. If possible one should redefine
       * only updateObject function and keep this function unchanged. But for some special painters this function is the
       * only way to control how object can be update while requested from the server
       * @protected */
@@ -10632,7 +10611,7 @@ class ObjectPainter extends BasePainter {
    }
 
    /** @summary Checks if draw elements were resized and drawing should be updated.
-     * @desc Redirects to {@link TPadPainter.checkCanvasResize}
+     * @desc Redirects to {@link TPadPainter#checkCanvasResize}
      * @private */
    checkResize(arg) {
       let p = this.getCanvPainter();
@@ -10654,7 +10633,7 @@ class ObjectPainter extends BasePainter {
    }
 
    /** @summary Returns created <g> element used for object drawing
-     * @desc Element should be created by {@link ObjectPainter.createG}
+     * @desc Element should be created by {@link ObjectPainter#createG}
      * @protected */
    getG() { return this.draw_g; }
 
@@ -10847,7 +10826,7 @@ class ObjectPainter extends BasePainter {
    }
 
    /** @summary Converts pad SVG x or y coordinates into axis values.
-     * @desc Reverse transformation for {@link ObjectPainter.axisToSvg}
+     * @desc Reverse transformation for {@link ObjectPainter#axisToSvg}
      * @param {string} axis - name like "x" or "y"
      * @param {number} coord - graphics coordiante.
      * @param {boolean} ndc - kind of return value
@@ -11972,7 +11951,7 @@ function resize(dom, arg) {
 
 /** @summary Safely remove all drawings from specified element
   * @param {string|object} dom - id or DOM element
-  * @requires painter
+  * @public
   * @example
   * cleanup("drawing");
   * cleanup(document.querySelector("#drawing")); */
@@ -55919,7 +55898,7 @@ class MDIDisplay extends BasePainter {
 /**
  * @summary Custom MDI display
  *
- * @desc All HTML frames should be created before and add via {@link CustomDisplay.addFrame} calls
+ * @desc All HTML frames should be created before and add via {@link CustomDisplay#addFrame} calls
  * @private
  */
 
@@ -68945,7 +68924,7 @@ function setDefaultDrawOpt(classname, opt) {
   * @param {object} obj - object to draw, object type should be registered before with {@link addDrawFunc}
   * @param {string} opt - draw options separated by space, comma or semicolon
   * @returns {Promise} with painter object
-  * @requires painter
+  * @public
   * @desc An extensive list of support draw options can be found on [examples page]{@link https://root.cern/js/latest/examples.htm}
   * @example
   * let file = await openFile("https://root.cern/js/files/hsimple.root");
@@ -69064,9 +69043,9 @@ function draw(dom, obj, opt) {
   * @param {object} obj - object to draw, object type should be registered before with {@link addDrawFunc}
   * @param {string} opt - draw options
   * @returns {Promise} with painter object
-  * @requires painter
   * @desc If drawing was not done before, it will be performed with {@link draw}.
-  * Otherwise drawing content will be updated */
+  * Otherwise drawing content will be updated
+  * @public */
 function redraw(dom, obj, opt) {
 
    if (!obj || (typeof obj !== 'object'))
@@ -71943,12 +71922,11 @@ class TDirectory {
       });
    }
 
-} // TDirectory
+} // class TDirectory
 
 /**
   * @summary Interface to read objects from ROOT files
   *
-  * @hideconstructor
   * @desc Use {@link openFile} to create instance of the class
   */
 
@@ -72002,7 +71980,7 @@ class TFile {
    }
 
    /** @summary Assign BufferArray with file contentOpen file
-    * @private */
+     * @private */
    assignFileContent(bufArray) {
       this.fFileContent = new TBuffer(new DataView(bufArray));
       this.fAcceptRanges = false;
@@ -72011,8 +71989,8 @@ class TFile {
    }
 
    /** @summary Open file
-    * @returns {Promise} after file keys are read
-    * @private */
+     * @returns {Promise} after file keys are read
+     * @private */
    _open() {
       if (!this.fAcceptRanges || this.fSkipHeadRequest)
          return this.readKeys();
@@ -72563,7 +72541,7 @@ class TFile {
 
    /** @summary Read the directory content from  a root file
      * @desc If directory was already read - return previously read object
-     * Same functionality as {@link TFile.readObject}
+     * Same functionality as {@link TFile#readObject}
      * @param {string} dir_name - directory name
      * @param {number} [cycle] - directory cycle
      * @returns {Promise} - promise with read directory */
@@ -76701,6 +76679,9 @@ function readStyleFromURL(url) {
       }
    }
 
+   if (d.has('wrong_http_response'))
+      settings.HandleWrongHttpResponse = true;
+
    let inter = d.get("interactive");
    if (inter === "nomenu")
       settings.ContextMenu = false;
@@ -76785,8 +76766,14 @@ function readStyleFromURL(url) {
 
 
 /** @summary Build main GUI
-  * @returns {Promise} when completed  */
-function buildGUI(gui_element, gui_kind) {
+  * @desc Used in many HTML files to create JSROOT GUI elements
+  * @param {String} gui_element - id of the `<div>` element
+  * @param {String} gui_kind - either "online", "nobrowser", "draw"
+  * @returns {Promise} with {@link HierarchyPainter} instance
+  * @example
+  * import { buildGUI } from '/path_to_jsroot/modules/gui.mjs';
+  * buildGUI("guiDiv"); */
+function buildGUI(gui_element, gui_kind = "") {
    let myDiv = (typeof gui_element == 'string') ? select('#' + gui_element) : select(gui_element);
    if (myDiv.empty())
       return Promise.reject(Error('no div for gui found'));
@@ -94581,7 +94568,7 @@ function treeProcess(tree, selector, args) {
 
 }
 
-/** @summary  implementation of TTree::Draw
+/** @summary implementation of TTree::Draw
   * @param {object|string} args - different setting or simply draw expression
   * @param {string} args.expr - draw expression
   * @param {string} [args.cut=undefined]   - cut expression (also can be part of 'expr' after '::')

modules/core.mjs

@@ -1,11 +1,11 @@
 
 /** @summary version id
   * @desc For the JSROOT release the string in format "major.minor.patch" like "6.3.0" */
-let version_id = "7.0.0";
+let version_id = "7.0.x";
 
 /** @summary version date
   * @desc Release date in format day/month/year like "19/11/2021" */
-let version_date = "14/04/2022";
+let version_date = "19/04/2022";
 
 /** @summary version id and date
   * @desc Produced by concatenation of {@link version_id} and {@link version_date}