neo.mjs 7.13.0 → 7.15.0

package/apps/ServiceWorker.mjs

@@ -20,9 +20,9 @@ class ServiceWorker extends ServiceBase {
          */
         singleton: true,
         /**
-         * @member {String} version='7.13.0'
+         * @member {String} version='7.15.0'
          */
-        version: '7.13.0'
+        version: '7.15.0'
     }
 
     /**

package/apps/portal/index.html

@@ -16,7 +16,7 @@
         "@type": "Organization",
         "name": "Neo.mjs"
       },
-      "datePublished": "2024-10-02",
+      "datePublished": "2024-10-12",
       "publisher": {
         "@type": "Organization",
         "name": "Neo.mjs"

package/apps/portal/resources/data/blog.json

@@ -1,4 +1,16 @@
 [{
+    "author"      : "Henrique Sagara",
+    "authorImage" : "author_htsagara.png",
+    "date"        : "Oct 04, 2024",
+    "id"          : 62,
+    "image"       : "neo-website-logo.png",
+    "name"        : "Neo.mjs: A high-performance open-source JavaScript framework.",
+    "provider"    : "Dev.to",
+    "publisher"   : "",
+    "selectedInto": [],
+    "type"        : "Blog Post",
+    "url"         : "https://dev.to/htsagara/neomjs-a-high-performance-open-source-javascript-framework-739"
+}, {
     "author"      : "Nikhilesh Joshi",
     "authorImage" : "author_hashnj.jpg",
     "date"        : "Oct 01, 2024",

package/apps/portal/view/home/FooterContainer.mjs

@@ -111,7 +111,7 @@ class FooterContainer extends Container {
             }, {
                 module: Component,
                 cls   : ['neo-version'],
-                html  : 'v7.13.0'
+                html  : 'v7.15.0'
             }]
         }],
         /**

package/buildScripts/createApp.mjs

@@ -7,18 +7,19 @@ import inquirer      from 'inquirer';
 import os            from 'os';
 import path          from 'path';
 
-const __dirname    = path.resolve(),
-      cwd          = process.cwd(),
-      requireJson  = path => JSON.parse(fs.readFileSync((path))),
-      packageJson  = requireJson(path.join(__dirname, 'package.json')),
-      insideNeo    = packageJson.name === 'neo.mjs',
-      neoPath      = insideNeo ? './' : './node_modules/neo.mjs/',
-      addonChoices = fs.readdirSync(path.join(neoPath, '/src/main/addon')).map(item => item.slice(0, -4)),
-      program      = new Command(),
-      programName  = `${packageJson.name} create-app`,
-      questions    = [],
-      scssFolders  = fs.readdirSync(path.join(neoPath, '/resources/scss')),
-      themeFolders = [];
+const
+    __dirname    = path.resolve(),
+    cwd          = process.cwd(),
+    requireJson  = path => JSON.parse(fs.readFileSync((path))),
+    packageJson  = requireJson(path.join(__dirname, 'package.json')),
+    insideNeo    = packageJson.name === 'neo.mjs',
+    neoPath      = insideNeo ? './' : './node_modules/neo.mjs/',
+    addonChoices = fs.readdirSync(path.join(neoPath, '/src/main/addon')).map(item => item.slice(0, -4)),
+    program      = new Command(),
+    programName  = `${packageJson.name} create-app`,
+    questions    = [],
+    scssFolders  = fs.readdirSync(path.join(neoPath, '/resources/scss')),
+    themeFolders = [];
 
 scssFolders.forEach(folder => {
     if (folder.includes('theme')) {
@@ -86,16 +87,6 @@ if (programOpts.info) {
         });
     }
 
-    if (!programOpts.mainThreadAddons) {
-        questions.push({
-            type   : 'checkbox',
-            name   : 'mainThreadAddons',
-            message: 'Please choose your main thread addons:',
-            choices: addonChoices,
-            default: ['DragDrop', 'Stylesheet']
-        });
-    }
-
     if (!programOpts.useSharedWorkers) {
         questions.push({
             type   : 'list',
@@ -106,22 +97,12 @@ if (programOpts.info) {
         });
     }
 
-    if (!programOpts.useServiceWorker) {
-        questions.push({
-            type   : 'list',
-            name   : 'useServiceWorker',
-            message: 'Do you want to use a ServiceWorker for caching assets?',
-            choices: ['yes', 'no'],
-            default: 'no'
-        });
-    }
-
     inquirer.prompt(questions).then(answers => {
         let appName          = programOpts.appName          || answers.appName,
-            mainThreadAddons = programOpts.mainThreadAddons || answers.mainThreadAddons,
+            mainThreadAddons = programOpts.mainThreadAddons || ['DragDrop', 'Navigator', 'Stylesheet'],
             themes           = programOpts.themes           || answers.themes,
             useSharedWorkers = programOpts.useSharedWorkers || answers.useSharedWorkers,
-            useServiceWorker = programOpts.useServiceWorker || answers.useServiceWorker,
+            useServiceWorker = programOpts.useServiceWorker || 'no',
             lAppName         = appName.toLowerCase(),
             appPath          = 'apps/' + lAppName + '/',
             dir              = 'apps/' + lAppName,
@@ -177,7 +158,12 @@ if (programOpts.info) {
                 mainPath   : `${insideNeo ? './' : '../node_modules/neo.mjs/src/'}Main.mjs`
             };
 
-            if (!(mainThreadAddons.includes('DragDrop') && mainThreadAddons.includes('Stylesheet') && mainThreadAddons.length === 2)) {
+            if (!(
+                mainThreadAddons.includes('DragDrop')   &&
+                mainThreadAddons.includes('Navigator')  &&
+                mainThreadAddons.includes('Stylesheet') &&
+                mainThreadAddons.length === 3)
+            ) {
                 neoConfig.mainThreadAddons = mainThreadAddons;
             }
 

package/examples/ServiceWorker.mjs

@@ -20,9 +20,9 @@ class ServiceWorker extends ServiceBase {
          */
         singleton: true,
         /**
-         * @member {String} version='7.13.0'
+         * @member {String} version='7.15.0'
          */
-        version: '7.13.0'
+        version: '7.15.0'
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "neo.mjs",
-    "version": "7.13.0",
+    "version": "7.15.0",
     "description": "The webworkers driven UI framework",
     "type": "module",
     "repository": {
@@ -60,7 +60,7 @@
         "neo-jsdoc": "1.0.1",
         "neo-jsdoc-x": "1.0.5",
         "postcss": "^8.4.47",
-        "sass": "^1.79.4",
+        "sass": "^1.79.5",
         "siesta-lite": "5.5.2",
         "url": "^0.11.4",
         "webpack": "^5.95.0",

package/resources/scss/src/apps/portal/home/parts/MainNeo.scss

@@ -1,17 +1,22 @@
 @font-face {
     font-family: "GT-Planar";
-    src: url("../../../../../../../../resources/fonts/GT-Planar-Regular.otf") format("opentype");
+    src        : url("../../../../../../../../resources/fonts/GT-Planar-Regular.otf") format("opentype");
 }
+
 .portal-home-main-neo.portal-home-content-view {
-    padding: 3em;
+    background-color: #ffffff;
+    background-image: url("data:image/svg+xml,%3Csvg width='8' height='8' viewBox='0 0 6 6' xmlns='http://www.w3.org/2000/svg'%3E%3Cg fill='%23504e54' fill-opacity='0.18' fill-rule='evenodd'%3E%3Cpath d='M5 0h1L0 6V5zM6 5v1H5z'/%3E%3C/g%3E%3C/svg%3E");
+    padding         : 3em;
 
     .logo-container {
-        display        : flex;
-        flex-direction : row;
-        flex-wrap      : wrap;
-        gap            : 20px;
-        min-width      : 240px;
-        min-height     : 130px;
+        align-items     : center;
+        background-color: transparent;
+        display         : flex;
+        flex-direction  : row;
+        flex-wrap       : wrap;
+        gap             : 20px;
+        min-height      : 130px;
+        min-width       : 240px;
     }
 
     .button-group {
@@ -22,56 +27,47 @@
     }
 
     .neo-h1 {
-        font-size  : 110px;
         font-family: "GT-Planar";
-        line-height: 1;
+        font-size  : 60px;
     }
 
     .neo-h2 {
-        margin: 2rem;
+        font-size  : 2.5rem;
+        font-weight: 800;
+        margin     : 1.25rem;
     }
 
     .neo-h3 {
-        margin   : 1rem 14rem;
-        max-width: 900px;
+        margin    : 1rem 14rem;
+        max-width : 900px;
+        text-align: center;
     }
 
     .vector {
+        background-color   : transparent;
         background-image   : url("../../../../../../../../resources/images/logo/neo_logo_primary.svg");
         background-position: center center;
         background-repeat  : no-repeat;
         background-size    : contain;
-        height             : 10VW;
-        max-height         : 130px;
-        min-height         : 120px;
-        min-width          : 140px;
-    }
-
-    @media (max-width: 1000px) {
-        .neo-h3 {
-            margin: 1rem 10rem;
-        }
+        height             : 80px;
+        width              : 80px;
     }
 
-    @media (max-width: 900px) {
+    @media (max-width : 1000px) {
         .neo-h3 {
             margin: 1rem 7rem;
         }
     }
 
-    @media (max-width: 645px) {
+    @media (max-width : 645px) {
         padding: 1.5em 0.5em;
 
         .logo-container {
             gap: 10px;
         }
 
-        .neo-h1 {
-            line-height: 1.2;
-        }
-
         .neo-h2 {
-            margin: 0.5rem 0;
+            margin: 0.5rem 0.5rem;
         }
 
         .neo-h3 {
@@ -79,7 +75,7 @@
         }
 
         .vector {
-            height: 17VW;
+            height: 17vw;
         }
 
         .button-group {
@@ -87,18 +83,27 @@
         }
     }
 
-    @media (max-width: 500px) {
+    @media (max-width : 500px) {
         .logo-container {
             gap: 10px;
         }
 
         .neo-h1 {
-            font-size  : 100px;
-            line-height: 1.2;
+            font-size: 40px;
         }
 
         .neo-h2 {
-            margin: 0.5rem 2rem;
+            font-size: 2rem;
+            margin   : 0.5rem 2rem;
+        }
+
+        .neo-h3 {
+            font-size: 1.15rem;
+        }
+
+        .vector {
+            height: 70px;
+            width : 70px;
         }
     }
 }

package/src/DefaultConfig.mjs

@@ -262,12 +262,12 @@ const DefaultConfig = {
     useVdomWorker: true,
     /**
      * buildScripts/injectPackageVersion.mjs will update this value
-     * @default '7.13.0'
+     * @default '7.15.0'
      * @memberOf! module:Neo
      * @name config.version
      * @type String
      */
-    version: '7.13.0'
+    version: '7.15.0'
 };
 
 Object.assign(DefaultConfig, {

package/src/main/addon/FileSystemAccess.mjs

@@ -0,0 +1,88 @@
+import Base from './Base.mjs';
+
+/**
+ * Basic support for File System Access API
+ *
+ * Note: the "File System API" is available in Web Workers.
+ * However, the "File System Access API" extensions are Not available in Web Workers,
+ * because they must handle user gestures and Web Workers do Not have access to the
+ * UI, aka main, thread.
+ *
+ * The extensions return a promises fulfilled by FileSystemHandles,
+ * the FileSystemHandles are serializable and make it through (Neo's) Web Worker
+ * postMessage signaling to the App worker code, and we are in business,
+ *
+ * Only supported by Chrome, Edge, Opera; tested with Neo on Chrome, Opera, Edge:
+ * https://developer.chrome.com/docs/capabilities/web-apis/file-system-access#browser_support
+ *
+ * Note:  method parameters (the opts below) are identical to the method parameters in
+ * https://developer.mozilla.org/en-US/docs/Web/API/Window/showOpenFilePicker
+ *
+ * @class Neo.main.addon.FileSystemAccess
+ * @extends Neo.main.addon.Base
+ */
+class FileSystemAccess extends Base {
+    static config = {
+        /**
+         * @member {String} className='Neo.main.addon.FileSystemAccess'
+         * @protected
+         */
+        className: 'Neo.main.addon.FileSystemAccess',
+        /**
+         * Remote method access for other workers
+         * @member {Object} remote
+         * @protected
+         */
+        remote: {
+            app: [
+                'showDirectoryPicker',
+                'showOpenFilePicker',
+                'showSaveFilePicker',
+                'supported'
+            ]
+        }
+    }
+
+    /**
+     * Shows a directory picker which allows the user to select a directory.
+     * returns a promise fulfilled by a directory handle object.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/Window/showDirectoryPicker
+     * @param {Object} [opts]
+     * @returns {Promise<FileSystemDirectoryHandle>}
+     */
+    async showDirectoryPicker(opts) {
+       return await window.showDirectoryPicker(opts)
+    }
+
+    /**
+     * Shows a file picker which allows a user to select a file or files.
+     * returns a promise fulfilled an array of 1 or more filehandle objects.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/Window/showOpenFilePicker
+     * @param {Object} [opts]
+     * @returns {Promise<FileSystemFileHandle[]>}
+     */
+    async showOpenFilePicker(opts) {
+       return await window.showOpenFilePicker(opts)
+    }
+
+    /**
+     * Shows a file picker that allows a user to save a file.
+     * returns a promise fulfilled by a filehandle object fulfillment.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/Window/showSaveFilePicker
+     * @param {Object} [opts]
+     * @returns {Promise<FileSystemFileHandle>}
+     */
+    async showSaveFilePicker(opts) {
+       return await window.showSaveFilePicker(opts)
+    }
+
+    /**
+     * Tests if the browser supports the File System Access API.
+     * @returns {Boolean}
+     **/
+    supported() {
+        return 'showOpenFilePicker' in window
+    }
+}
+
+export default Neo.setupClass(FileSystemAccess);

package/src/main/addon/ServiceWorker.mjs

@@ -42,7 +42,7 @@ class ServiceWorker extends Base {
                              * or in case of a force refresh.
                              * See: https://www.w3.org/TR/service-workers/#navigator-service-worker-controller
                              */
-                            WorkerManager.serviceWorker = registration.active;
+                            WorkerManager.serviceWorker = registration.active
                         }
 
                         WorkerManager.sendMessage('service', {
@@ -60,7 +60,7 @@ class ServiceWorker extends Base {
     onBeforeUnload() {
         WorkerManager.sendMessage('service', {
             action: 'unregisterPort'
-        });
+        })
     }
 }
 

package/src/worker/ServiceBase.mjs

@@ -96,7 +96,7 @@ class ServiceBase extends Base {
 
     /**
      * @param {String} name=this.cacheName
-     * @returns {Object}
+     * @returns {Promise<Object>}
      */
     async clearCache(name=this.cacheName) {
         await caches.delete(name);
@@ -104,7 +104,7 @@ class ServiceBase extends Base {
     }
 
     /**
-     * @returns {Object}
+     * @returns {Promise<Object>}
      */
     async clearCaches() {
         let keys = await caches.keys();
@@ -289,6 +289,7 @@ class ServiceBase extends Base {
      * @param {String} [data.cacheName=this.cacheName]
      * @param {String[]|String} data.files
      * @param {Boolean} [data.foreReload=false]
+     * @returns {Promise<Object>}
      */
     async preloadAssets(data) {
         let cacheName = data.cacheName || this.cacheName,
@@ -348,7 +349,7 @@ class ServiceBase extends Base {
      * @param {Boolean} data.options.ignoreMethod=false
      * @param {Boolean} data.options.ignoreSearch=false
      * @param {Boolean} data.options.ignoreVary=false
-     * @returns {Object}
+     * @returns {Promise<Object>}
      */
     async removeAssets(data) {
         if (!Neo.isObject(data)) {
@@ -356,9 +357,9 @@ class ServiceBase extends Base {
         }
 
         let {assets, options={}} = data,
-            cacheName              = data.cacheName || this.cacheName,
-            cache                  = await caches.open(cacheName),
-            promises               = [];
+            cacheName            = data.cacheName || this.cacheName,
+            cache                = await caches.open(cacheName),
+            promises             = [];
 
         if (!Array.isArray(assets)) {
             assets = [assets]