neo.mjs 10.0.0-alpha.3 → 10.0.0-alpha.5

package/src/worker/Manager.mjs

@@ -27,11 +27,6 @@ class Manager extends Base {
          * @protected
          */
         className: 'Neo.worker.Manager',
-        /**
-         * @member {Boolean} singleton=true
-         * @protected
-         */
-        singleton: true,
         /**
          * @member {Number} activeWorkers=0
          * @protected
@@ -51,12 +46,29 @@ class Manager extends Base {
          * @member {String[]|Neo.core.Base[]|null} mixins=[Observable, RemoteMethodAccess]
          */
         mixins: [Observable, RemoteMethodAccess],
+        /**
+         * Remote method access for other workers
+         * @member {Object} remote
+         * @protected
+         */
+        remote: {
+            app   : ['setNeoConfig'],
+            canvas: ['setNeoConfig'],
+            data  : ['setNeoConfig'],
+            task  : ['setNeoConfig'],
+            vdom  : ['setNeoConfig']
+        },
         /**
          * True in case the current browser supports window.SharedWorker.
          * @member {Boolean} sharedWorkersEnabled=false
          * @protected
          */
         sharedWorkersEnabled: false,
+        /**
+         * @member {Boolean} singleton=true
+         * @protected
+         */
+        singleton: true,
         /**
          * Internal flag to stop the worker communication in case their creation fails
          * @member {Boolean} stopCommunication=false
@@ -71,7 +83,7 @@ class Manager extends Base {
          */
         webWorkersEnabled: false,
         /**
-         * Using the current timestamp as an unique window identifier
+         * Using the current timestamp as a unique window identifier
          * @member {Number} windowId=new Date().getTime()
          * @protected
          */
@@ -121,7 +133,8 @@ class Manager extends Base {
 
         !Neo.insideWorker && me.createWorkers();
 
-        Neo.workerId = 'main';
+        Neo.setGlobalConfig = me.setGlobalConfig.bind(me);
+        Neo.workerId        = 'main';
 
         me.promises = {};
 
@@ -136,18 +149,18 @@ class Manager extends Base {
 
     /**
      * Sends a message to each worker defined inside the this.workers config.
-     * @param {Object} msg
+     * Only sends to workers that are currently active and available.
+     * @param {Object} msg             The message payload to broadcast.
+     * @param {Object} [excludeOrigin] Optionally pass the origin realm name to exclude from the broadcast.
      */
-    broadcast(msg) {
-        Object.keys(this.workers).forEach(name => {
-            if (!(
-                name === 'canvas' && !NeoConfig.useCanvasWorker ||
-                name === 'task'   && !NeoConfig.useTaskWorker   ||
-                name === 'vdom'   && !NeoConfig.useVdomWorker
-            )) {
-                this.sendMessage(name, msg)
+    broadcast(msg, excludeOrigin) {
+        let me = this;
+
+        Object.keys(me.workers).forEach(name => {
+            if (name !== excludeOrigin && me.getWorker(name)) {
+                me.sendMessage(name, msg)
             }
-        });
+        })
     }
 
     /**
@@ -257,14 +270,10 @@ class Manager extends Base {
     }
 
     /**
-     * @param {String} path
+     *
      */
-    loadApplication(path) {
-        this.sendMessage('app', {
-            action       : 'loadApplication',
-            path,
-            resourcesPath: NeoConfig.resourcesPath
-        })
+    loadApplication() {
+        this.sendMessage('app', {action: 'loadApplication' })
     }
 
     /**
@@ -278,7 +287,7 @@ class Manager extends Base {
         if (me.constructedThreads === me.activeWorkers) {
             // better safe than sorry => all remotes need to be registered
             NeoConfig.appPath && me.timeout(NeoConfig.loadApplicationDelay).then(() => {
-                me.loadApplication(NeoConfig.appPath)
+                me.loadApplication()
             })
         }
     }
@@ -325,8 +334,10 @@ class Manager extends Base {
                     data = data.data
                 }
 
-                promise[data.reject ? 'reject' : 'resolve'](data);
-                delete me.promises[replyId]
+                if (data) {
+                    promise[data.reject ? 'reject' : 'resolve'](data);
+                    delete me.promises[replyId]
+                }
             }
         }
 
@@ -385,7 +396,14 @@ class Manager extends Base {
 
         return new Promise((resolve, reject) => {
             let message = me.sendMessage(dest, opts, transfer),
-                msgId   = message.id;
+                msgId;
+
+            if (!message) {
+                reject(new Error(me.stopCommunication ? 'Communication is stopped.' : `Target worker '${dest}' does not exist.`));
+                return
+            }
+
+            msgId = message.id;
 
             me.promises[msgId] = {reject, resolve}
         })
@@ -412,7 +430,7 @@ class Manager extends Base {
      * @param {Array} [transfer] An optional array of Transferable objects to transfer ownership of.
      * If the ownership of an object is transferred, it becomes unusable (neutered) in the context it was sent from
      * and becomes available only to the worker it was sent to.
-     * @returns {Neo.worker.Message}
+     * @returns {Neo.worker.Message|null}
      * @protected
      */
     sendMessage(dest, opts, transfer) {
@@ -427,17 +445,53 @@ class Manager extends Base {
                 worker = me.getWorker(dest)
             }
 
-            if (!worker) {
-                throw new Error('Called sendMessage for a worker that does not exist: ' + dest)
+            if (worker) {
+                opts.destination = dest;
+
+                message = new Message(opts);
+
+                (worker.port ? worker.port : worker).postMessage(message, transfer);
+                return message
             }
+        }
 
-            opts.destination = dest;
+        return null
+    }
 
-            message = new Message(opts);
+    /**
+     * Initiates a global Neo.config change from the Main Thread.
+     *
+     * This method acts as a proxy, routing the config change request to the App Worker.
+     * This design centralizes the complex multi-threaded and multi-window synchronization
+     * logic within the App Worker's `setGlobalConfig` method.
+     *
+     * Developers should typically use `Neo.setGlobalConfig(config)` directly,
+     * which will correctly resolve to this proxy when called from the Main Thread.
+     *
+     * @param {Object} config The partial or full Neo.config object with changes to apply.
+     */
+    setGlobalConfig(config) {
+        // Remotely calls the App Worker's setGlobalConfig method.
+        // This ensures all global config changes are processed through the App Worker
+        // which contains the centralized multi-window synchronization logic.
+        Neo.worker.App.setGlobalConfig(config)
+    }
 
-            (worker.port ? worker.port : worker).postMessage(message, transfer);
-            return message
-        }
+    /**
+     * Change Neo.config globally from a worker
+     * @param {Object}  data
+     * @param {Boolean} data.broadcast
+     * @param {Object}  data.config
+     * @param {String}  [data.excludeOrigin]
+     */
+    setNeoConfig({broadcast, config, excludeOrigin}) {
+        let me = this;
+
+        Neo.merge(Neo.config, config);
+
+        me.fire('neoConfigChange', config);
+
+        broadcast && me.broadcast({action: 'setNeoConfig', config}, excludeOrigin)
     }
 }
 

package/resources/data/deck/learnneo/tree.json

@@ -1,50 +0,0 @@
-{"data": [
-    {"name": "Using These Topics",                         "parentId": null,                                 "id": "UsingTheseTopics" },
-    {"name": "Benefits",                                   "parentId": null,                "isLeaf": false, "id": "Benefits"},
-        {"name": "Introduction ",                          "parentId": "Benefits",                           "id": "benefits.Introduction"},
-        {"name": "Off the Main Thread",                    "parentId": "Benefits",                           "id": "benefits.OffTheMainThread"},
-        {"name": "4 Environments",                         "parentId": "Benefits",                           "id": "benefits.FourEnvironments"},
-        {"name": "Unified Config System",                  "parentId": "Benefits",                           "id": "benefits.ConfigSystem"},
-        {"name": "Extreme Speed",                          "parentId": "Benefits",                           "id": "benefits.Speed"},
-        {"name": "Multi-Window Applications",              "parentId": "Benefits",                           "id": "benefits.MultiWindow"},
-        {"name": "Quick Application Development",          "parentId": "Benefits",                           "id": "benefits.Quick"},
-        {"name": "Complexity and Effort",                  "parentId": "Benefits",                           "id": "benefits.Effort"},
-        {"name": "Forms Engine",                           "parentId": "Benefits",                           "id": "benefits.FormsEngine"},
-        {"name": "Features and Benefits Summary",          "parentId": "Benefits",                           "id": "benefits.Features"},
-    {"name": "Getting Started",                            "parentId": null,                "isLeaf": false, "id": "GettingStarted", "collapsed": true},
-        {"name": "Setup",                                  "parentId": "GettingStarted",                     "id": "gettingstarted.Setup"},
-        {"name": "Workspaces and Applications",            "parentId": "GettingStarted",                     "id": "gettingstarted.Workspaces"},
-        {"name": "Describing a View",                      "parentId": "GettingStarted",                     "id": "gettingstarted.DescribingTheUI"},
-        {"name": "Events",                                 "parentId": "GettingStarted",                     "id": "gettingstarted.Events"},
-        {"name": "Component References",                   "parentId": "GettingStarted",                     "id": "gettingstarted.References"},
-        {"name": "Extending Classes",                      "parentId": "GettingStarted",                     "id": "gettingstarted.Extending"},
-        {"name": "Config",                                 "parentId": "GettingStarted",                     "id": "gettingstarted.Config"},
-        {"name": "Shared Bindable Data",                   "parentId": "GettingStarted",                     "id": "gettingstarted.ComponentModels"},
-    {"name": "Tutorials",                                  "parentId": null,                "isLeaf": false, "id": "Tutorials",  "collapsed": true},
-        {"name": "Rock Scissors Paper",                    "parentId": "Tutorials",                          "id": "tutorials.RSP", "hidden": true},
-        {"name": "Earthquakes",                            "parentId": "Tutorials",                          "id": "tutorials.Earthquakes"},
-        {"name": "Todo List",                              "parentId": "Tutorials",                          "id": "tutorials.TodoList"},
-    {"name": "Guides",                                     "parentId": null,                "isLeaf": false, "id": "InDepth",  "collapsed": true},
-        {"name": "Instance Lifecycle",                     "parentId": "InDepth",                            "id": "guides.InstanceLifecycle", "hidden": true},
-        {"name": "User Input (Forms)",                     "parentId": "InDepth",                            "id": "guides.Forms",  "hidden": true},
-        {"name": "Component and Container Basics",         "parentId": "InDepth",                            "id": "guides.ComponentsAndContainers"},
-        {"name": "Layouts",                                "parentId": "InDepth",           "isLeaf": false, "id": "guides.Layouts", "hidden": true},
-        {"name": "Shared Bindable Data (State Providers)", "parentId": "InDepth",                            "id": "guides.StateProviders"},
-        {"name": "Custom Components",                      "parentId": "InDepth",                            "id": "guides.CustomComponents", "hidden": true},
-        {"name": "Events",                                 "parentId": "InDepth",           "isLeaf": false, "id": "GuideEvents"},
-            {"name": "Custom Events",                      "parentId": "GuideEvents",                        "id": "guides.events.CustomEvents"},
-            {"name": "DOM Events",                         "parentId": "GuideEvents",                        "id": "guides.events.DomEvents"},
-        {"name": "Portal App",                             "parentId": "InDepth",                            "id": "guides.PortalApp"},
-        {"name": "Tables (Stores)",                        "parentId": "InDepth",                            "id": "guides.Tables", "hidden": true},
-        {"name": "Multi-Window Applications",              "parentId": "InDepth",                            "id": "guides.MultiWindow", "hidden":  true},
-        {"name": "Main Thread Addons",                     "parentId": "InDepth",           "isLeaf": false, "id": "MainThreadAddons", "hidden": true},
-            {"name": "Introduction",                       "parentId": "MainThreadAddons",                   "id": "guides.MainThreadAddonIntro"},
-            {"name": "Example",                            "parentId": "MainThreadAddons",                   "id": "guides.MainThreadAddonExample"},
-        {"name": "Mixins",                                 "parentId": "InDepth",                            "id": "guides.Mixins", "hidden": true},
-    {"name": "JavaScript Classes",                         "parentId": null,                "isLeaf": false, "id": "JavaScript", "hidden": true},
-        {"name": "Classes, Properties, and Methods",       "parentId": "JavaScript",                         "id": "javascript.Classes"},
-        {"name": "Overriding Methods",                     "parentId": "JavaScript",                         "id": "javascript.Overrides"},
-        {"name": "Other JavaScript Class Features",        "parentId": "JavaScript",                         "id": "javascript.ClassFeatures"},
-        {"name": "Super",                                  "parentId": "JavaScript",                         "id": "javascript.Super"},
-        {"name": "New Node",                               "parentId": "JavaScript",                         "id": "javascript.NewNode"}
-]}

package/resources/data/deck/whyneo.md

@@ -1,80 +0,0 @@
-
-#hi
-
-
-Neo.mjs is a framework used to create browser-based applications.
-
-Some key features and benefits of Neo.mjs are:
-
-<div type="expander" caption="Multi-Threaded">
-<p>
-When a Neo.mjs application starts, the framework spawns three web-workers. 
-Web-workers are each run in their own thread. As a result, a typical Neo.mjs application
-has four threads:
-<ol>
-<li>The _main_ thread, where DOM updates are applied
-<li>An _application_ web-worker where normal application locic is run
-    <li>A _data_ web-worker were HTTP and socket calls are run
-<li>A _view_ web-worker that manages delta updates
-</ol>
-</div>
-
-<div type="expander" caption="Extreme Speed">
-<p>
-The Neo.mjs web-worker proccesses are automatically run in parallel, on separate CPU cores.
-</p>
-<p>
-By contrast, other JavaScript frameworks run in a single thread. That means 
-in a typical framework all business logic, data handling, and DOM rendering compete for 
-CPU reasources.
-</p>
-<p>
-This means Neo.mjs applications run and render faster. This is 
-particularly beneficial for processor- and data-intensive applications, 
-and applications that need to rapidly update what's viewed. In testing, Neo.mjs applications 
-easily apply over 20,000 DOM updates per second. 
-</p>
-<p>
-If the default four threads aren't enough, you're free to launch additional web-worker threads 
-to run other specialized logic. 
-</p>
-</div>
-
-<div type="expander" caption="Quick Application Development">
-<p>
-Neo.js classes let you specify properties in a way that allows code to detect "before" and "after"
-changes. This makes it easy to handle value validation and transformation, and react to changes. 
-</p>
-<p>
-Neo.mjs also has elegant yet powerful state management features that make it easy to create shared,
-bindable data. For example, if two components are bound to the same propery, a change to the 
-property will automatically be applied to both components.
-</p>
-</div>
-
-<div type="expander" caption="Multi-Window Applications">
-<p>
-Neo.mjs applications can also launch as _shared web workers_, which allows you to have a single 
-application run in multiple browser windows; those windows could be moved to multiple monitors.
-</p>
-<p>
-For example, you can have a data analysis application with a control panel on one monitor, 
-tabular data in another, and charts on another &mdash; all sharing the same data, handling events
-across windows, running seamlessly as a single application. 
-</p>
-</div>
-
-<div type="expander" caption="Open-Source and Standards-Based">
-<p>
-Neo.mjs is an open-source library. Features needed for the community can be added to the
-library via pull-requests. And since Neo.mjs uses the standard JavaScript class system, 
-all Neo.mjs classes can be extended.
-</p>
-<p>
-Neo.mjs uses standard modular JavaScript, so developers don't need to learn non-standard language
-syntax, and there's no need for special pre-compilers or WebPack modules.
-That means fewer dependencies and easier configuration. Furthermore, the use of
-standard JavaScript makes debugging easier: any statement you write while developing your
-applcation can also be run in the debugging console.
-</p>
-</div>