neo.mjs 10.0.0-alpha.5 → 10.0.0-beta.2

package/src/table/plugin/CellEditing.mjs

@@ -69,7 +69,7 @@ class CellEditing extends Plugin {
             me.onSelectionModelChange({value: selectionModel})
         }
 
-        owner.view.keys.add({
+        owner.body.keys.add({
             Enter: 'onTableKeyDown',
             Space: 'onTableKeyDown',
             scope: me
@@ -109,9 +109,9 @@ class CellEditing extends Plugin {
 
         let me                  = this,
             {appName, windowId} = me,
-            {view}              = me.owner,
-            cellId              = view.getCellId(record, dataField),
-            cellNode            = VdomUtil.find(view.vdom, cellId).vdom,
+            {body}              = me.owner,
+            cellId              = body.getCellId(record, dataField),
+            cellNode            = VdomUtil.find(body.vdom, cellId).vdom,
             column              = me.owner.headerToolbar.getColumn(dataField),
             editor              = me.editors[dataField],
             value               = record[dataField],
@@ -133,7 +133,7 @@ class CellEditing extends Plugin {
                 cls      : me.editorCls,
                 dataField,
                 hideLabel: true,
-                parentId : view.id,
+                parentId : body.id,
                 record,
                 value,
                 windowId,
@@ -163,9 +163,9 @@ class CellEditing extends Plugin {
         cellNode.cn = [editor.createVdomReference()];
         delete cellNode.html;
 
-        view.updateDepth = -1;
+        body.updateDepth = -1;
 
-        await view.promiseUpdate();
+        await body.promiseUpdate();
 
         await me.timeout(30);
 
@@ -175,13 +175,13 @@ class CellEditing extends Plugin {
     /**
      *
      * @param {Object} data
-     * @param {Object} data.data
-     * @param {String} data.dataField
-     * @param {Object} data.record
-     * @param {Neo.table.View} data.view
+     * @param {Neo.table.Body} data.body
+     * @param {Object}         data.data
+     * @param {String}         data.dataField
+     * @param {Object}         data.record
      * @returns {Promise<void>}
      */
-    async onCellDoubleClick({data, dataField, record, view}) {
+    async onCellDoubleClick({body, data, dataField, record}) {
         await this.mountEditor(record, dataField)
     }
 
@@ -262,12 +262,12 @@ class CellEditing extends Plugin {
     async onTableKeyDown(data) {
         let me       = this,
             {target} = data,
-            {view}   = me.owner,
+            {body}   = me.owner,
             dataField, record;
 
         if (!me.mountedEditor && target.cls?.includes('neo-selected')) {
-            dataField = view.getCellDataField(target.id);
-            record    = view.getRecord(target.id);
+            dataField = body.getCellDataField(target.id);
+            record    = body.getRecord(target.id);
 
             await me.mountEditor(record, dataField)
         }
@@ -328,13 +328,13 @@ class CellEditing extends Plugin {
 
         let me       = this,
             record   = me.mountedEditor.record,
-            {view}   = me.owner,
-            rowIndex = view.store.indexOf(record);
+            {body}   = me.owner,
+            rowIndex = body.store.indexOf(record);
 
         me.mountedEditor = null;
 
-        view.getVdomRoot().cn[rowIndex] = view.createRow({record, rowIndex});
-        await view.promiseUpdate()
+        body.getVdomRoot().cn[rowIndex] = body.createRow({record, rowIndex});
+        await body.promiseUpdate()
     }
 }
 

package/src/tooltip/Base.mjs

@@ -76,12 +76,7 @@ class Tooltip extends Container {
          * True prevents the tooltip from hiding while the mouse cursor is above it
          * @member {Boolean|null} stayOnHover_=true
          */
-        stayOnHover_: true,
-        /**
-         * Shortcut to add a label item
-         * @member {String} text_=null
-         */
-        text_: null
+        stayOnHover_: true
     }
 
     /**

package/src/tree/Accordion.mjs

@@ -277,13 +277,13 @@ class AccordionTree extends TreeList {
                             tag : 'span',
                             cls : [itemCls + '-content-header'],
                             id  : id + '__item-content-header',
-                            html: item[me.fields.header]
+                            text: item[me.fields.header]
                         }, {
                             flag: 'content',
                             tag : 'span',
                             cls : [itemCls + '-content-text'],
                             id  : id + '__item-content-text',
-                            html: item[me.fields.text]
+                            text: item[me.fields.text]
                         }]
                     }],
                     style: {
@@ -428,7 +428,7 @@ class AccordionTree extends TreeList {
                     NeoArray.add(cls, clsItems);
                     itemVdom.cls = cls
                 } else {
-                    itemVdom.html = field.value
+                    itemVdom.text = field.value
                 }
             }
         });

package/src/vdom/Helper.mjs

@@ -37,26 +37,6 @@ class Helper extends Base {
         singleton: true
     }
 
-    /**
-     * @param {Object} config
-     */
-    construct(config) {
-        super.construct(config);
-
-        let me = this;
-
-        // Ensure Neo.currentWorker is defined before attaching listeners
-        Promise.resolve().then(async () => {
-            // Subscribe to global Neo.config changes for dynamic renderer switching.
-            Neo.currentWorker.on({
-                neoConfigChange: me.onNeoConfigChange,
-                scope          : me
-            });
-
-            await me.importUtil()
-        })
-    }
-
     /**
      * @param {Object}         config
      * @param {Object}         config.deltas
@@ -520,6 +500,23 @@ class Helper extends Base {
         }
     }
 
+    /**
+     * @returns {Promise<void>}
+     */
+    async initAsync() {
+        super.initAsync();
+
+        let me = this;
+
+        // Subscribe to global Neo.config changes for dynamic renderer switching.
+        Neo.currentWorker.on({
+            neoConfigChange: me.onNeoConfigChange,
+            scope          : me
+        });
+
+        await me.importUtil()
+    }
+
     /**
      * @param {Object}         config
      * @param {Object}         config.deltas
@@ -632,12 +629,12 @@ class Helper extends Base {
 
     /**
      * Handler for global Neo.config changes.
-     * If 'useDomApiRenderer' property changes, this method dynamically loads/clears the renderer utilities.
+     * If the `Neo.config.useDomApiRenderer` value changes, this method dynamically loads the renderer utilities.
      * @param {Object} config
      * @return {Promise<void>}
      */
     async onNeoConfigChange(config) {
-        if(Object.hasOwn(config, 'useDomApiRenderer')) {
+        if (Object.hasOwn(config, 'useDomApiRenderer')) {
             await this.importUtil()
         }
     }

package/src/worker/App.mjs

@@ -1,8 +1,7 @@
 import Neo             from '../Neo.mjs';
 import Base            from './Base.mjs';
-import * as core       from '../core/_export.mjs';
 import Application     from '../controller/Application.mjs';
-import Instance        from '../manager/Instance.mjs';
+import InstanceManager from '../manager/Instance.mjs';
 import DomEventManager from '../manager/DomEvent.mjs';
 import HashHistory     from '../util/HashHistory.mjs';
 

package/src/worker/Base.mjs

@@ -1,10 +1,12 @@
-import Base               from '../core/Base.mjs';
-import Observable         from '../core/Observable.mjs';
-import Message            from './Message.mjs';
-import RemoteMethodAccess from './mixin/RemoteMethodAccess.mjs';
+import Base                  from '../core/Base.mjs';
+import * as core             from '../core/_export.mjs';
+import Observable            from '../core/Observable.mjs';
+import ClassHierarchyManager from '../manager/ClassHierarchy.mjs';
+import Message               from './Message.mjs';
+import RemoteMethodAccess    from './mixin/RemoteMethodAccess.mjs';
 
 /**
- * The abstract base class for the App, Data & VDom worker
+ * The abstract base class for e.g. the App, Data & VDom worker
  * @class Neo.worker.Base
  * @extends Neo.core.Base
  * @abstract

package/src/worker/Canvas.mjs

@@ -1,6 +1,5 @@
-import Neo       from '../Neo.mjs';
-import Base      from './Base.mjs';
-import * as core from '../core/_export.mjs';
+import Neo  from '../Neo.mjs';
+import Base from './Base.mjs';
 
 /**
  * The Canvas worker is responsible for dynamically manipulating offscreen canvas.

package/src/worker/Data.mjs

@@ -1,12 +1,10 @@
-import Neo     from '../Neo.mjs';
-import Base    from './Base.mjs';
-import Compare from '../core/Compare.mjs';
-import Fetch   from '../Fetch.mjs';
-import Util    from '../core/Util.mjs';
-import Xhr     from '../Xhr.mjs';
+import Neo   from '../Neo.mjs';
+import Base  from './Base.mjs';
+import Fetch from '../Fetch.mjs';
+import Xhr   from '../Xhr.mjs';
 
 /**
- * The Data worker is responsible to handle all of the communication to the backend (e.g. Ajax-calls).
+ * The Data worker is responsible to handle all the communication to the backend (e.g. Ajax-calls).
  * See the tutorials for further infos.
  * @class Neo.worker.Data
  * @extends Neo.worker.Base

package/src/worker/Task.mjs

@@ -1,6 +1,5 @@
-import Neo       from '../Neo.mjs';
-import Base      from './Base.mjs';
-import * as core from '../core/_export.mjs';
+import Neo  from '../Neo.mjs';
+import Base from './Base.mjs';
 
 /**
  * The Task worker can get filled with custom remote methods as needed.

package/src/worker/VDom.mjs

@@ -1,7 +1,6 @@
-import Neo       from '../Neo.mjs';
-import Base      from './Base.mjs';
-import * as core from '../core/_export.mjs';
-import Helper    from '../vdom/Helper.mjs';
+import Neo    from '../Neo.mjs';
+import Base   from './Base.mjs';
+import Helper from '../vdom/Helper.mjs';
 
 /**
  * The Vdom worker converts vdom templates into vnodes, as well as creating delta-updates.

package/src/worker/mixin/RemoteMethodAccess.mjs

@@ -90,13 +90,16 @@ class RemoteMethodAccess extends Base {
             throw new Error('Invalid remote method name "' + msg.remoteMethod + '"')
         }
 
-        if (Array.isArray(msg.data)) {
+        // Check for interception
+        if (!pkg.isReady && pkg.interceptRemotes?.includes(msg.remoteMethod)) {
+            out = pkg.onInterceptRemotes(msg);
+        } else if (Array.isArray(msg.data)) {
             out = method.call(pkg, ...msg.data)
         } else {
             out = method.call(pkg, msg.data)
         }
 
-        if (out instanceof Promise) {
+        if (Neo.isPromise(out)) {
             out
                 /*
                  * Intended logic:

package/learn/guides/MainThreadAddonExample.md

@@ -1,15 +0,0 @@
-Let's go through the steps of creating a main thread addon.
-
-Let's say we needed to show a code editor. There are a lot of libraries
-for this, such as Ace (<a href="https://ace.c9.io/" target="_blank">ace.c9.io</a>).
-From a coding perspective, these editors have a simple API: a setter
-to specify the string being edited, a getter to read the string, and
-a change event fired as the user types.
-
-Here's what we need to do:
-- Define a main thread addon and its API
-- Define a component wrapper
-
-### Define the Main Thread Addon
-
-### Define the component wrapper

package/learn/guides/MainThreadAddonIntro.md

@@ -1,44 +0,0 @@
-Neo.mjs is multi-threaded. There are worker threads
-that handle data access, application logic,
-and keeping track of DOM updates. Practically all your
-application logic is run in parallel in these threads.
-However, anything that needs to actually reference or update
-the DOM (`window.document`), or just use the `window` object, must be done in the main 
-application thread. 
-
-That's the purpose of main thread addons. These are classes whose
-methods can be accessed from other web workers, but are
-actually executed in the main thread.
-
-For example, what if you needed to read the browser's
-URL? That information is in `window.location`.
-But `window` is a main thread variable! To access that
-from a web-worker our code has to say "hey main thread, 
-please return a specified `window` property." Neo.mjs
-lets you do that via `Neo.Main.getByPath()`. For
-example, the following statement logs the URL query string.
-
-<pre data-code-readonly>
-const search = await Neo.Main.getByPath({path: 'window.location.search'});
-console.log(search); // Logs the search string
-</pre>
-
-`Neo.Main` & `Neo.main.DomAccess` provide some basic methods for accessing the 
-main thread, but in case you want to use a third party library which relies on directly
-working with the DOM, you'd use a _main thread addon_. 
-
-Google Maps is a good example of this. In Neo.mjs, most
-views are responsible for updating their own vdom, but
-the responsibility for rendering maps and markers is handled
-by Google Maps itself &mdash; we _ask_ Google Maps to do
-certain things via the Google Maps API. Therefore, in Neo.mjs,
-Google Maps is implemented as a main thread addon which
-loads the libraries and exposes whatever methods we'll need
-to run from the other Neo.mjs threads. In addition, in a
-Neo.mjs application we want to use Google Maps like any other
-component, so Neo.mjs also provides a component wrapper. In
-summary: 
-- The main-thread addon contains the code run in the main thread,
-and exposes what methods can be run by other web-workers (remote method access)
-- The component wrapper lets you use it like any other component,
-internally calling the main thread methods as needed.