neo.mjs 10.3.0 → 10.3.1

package/.github/RELEASE_NOTES/v10.3.0.md

@@ -33,7 +33,9 @@ This new feature is built on a core Neo.mjs principle: **a commitment to a zero-
 To achieve both developer convenience and production performance, the framework uses a sophisticated dual-mode approach:
 
 1.  **Development Mode:** Templates are parsed live in the browser using `parse5`. This parser is **only loaded if templates are actually used**, ensuring zero overhead for applications that stick to the JSON VDOM.
-2.  **Production Mode:** For `dist/esm`, `dist/dev`, and `dist/prod` builds, a powerful **build-time AST transformation** converts templates directly into optimized VDOM objects. This eliminates the `parse5` dependency from production builds entirely, resulting in **zero runtime parsing overhead** and maximum performance.
+2.  **Production Mode:** For `dist/esm`, `dist/dev`, and `dist/prod` builds, a powerful **build-time AST transformation** converts templates directly into optimized VDOM objects. This eliminates the `parse5` dependency from production builds entirely, resulting in **zero runtime parsing overhead** and maximum performance. The `enableHtmlTemplates` flag is also automatically set to `false` in production environments, ensuring that the runtime parser is never accidentally used.
+
+As a developer convenience, if you name your template-generating method `render()`, the build process will automatically rename it to `createVdom()` for you, aligning with the framework's lifecycle methods while providing a familiar entry point.
 
 ## Foundational Enhancements
 
@@ -51,4 +53,19 @@ To support this major new feature, we have added two comprehensive guides:
 -   [Using HTML Templates](../learn/guides/uibuildingblocks/HtmlTemplates.md): A guide focused on the syntax, features, and best practices for using the new template system.
 -   [Under the Hood: HTML Templates](../learn/guides/uibuildingblocks/HtmlTemplatesUnderTheHood.md): A deep dive into the philosophy and the dual-mode architecture, explaining how templates work in both development and production environments.
 
+All changes combined into 1 commit: https://github.com/neomjs/neo/commit/0841e7e1a715c7afe67d07eebb8229e54828eedd
+
 We are incredibly excited about this release and believe it makes Neo.mjs more powerful and accessible than ever. Please explore the new feature, read the documentation, and share your feedback!
+
+Try it out by yourself:</br>
+https://neomjs.com/examples/functional/nestedTemplateComponent/
+
+<img width="1603" height="1292" alt="Screenshot 2025-08-02 at 17 01 25" src="https://github.com/user-attachments/assets/79cb4aad-b791-4b03-bf25-7147bbeeed39" />
+
+https://neomjs.com/dist/esm/examples/functional/nestedTemplateComponent/
+
+<img width="1606" height="1062" alt="Screenshot 2025-08-02 at 17 00 12" src="https://github.com/user-attachments/assets/7a21638f-cb68-4f28-ba04-6ebaccb3b3f3" />
+
+https://neomjs.com/dist/development/examples/functional/nestedTemplateComponent/
+
+<img width="1602" height="1179" alt="Screenshot 2025-08-02 at 17 06 24" src="https://github.com/user-attachments/assets/2c1d3ef7-2008-41a1-9025-2859d907ce2d" />

package/.github/RELEASE_NOTES/v10.3.1.md

@@ -0,0 +1,14 @@
+# Neo.mjs v10.3.1: Build Process Reliability
+
+This is a patch release focused on improving the stability and reliability of the core build process.
+
+## Key Fix: Build Process Dependency Order
+
+### The Problem
+The main `buildAll.mjs` script could fail on a clean repository checkout. The build steps that process HTML templates (e.g., `buildESModules`) have a dependency on the `dist/parse5.mjs` bundle. However, the script did not guarantee that this bundle was created before it was needed, leading to a potential crash.
+
+### The Solution
+We have updated `buildAll.mjs` to explicitly run the `bundleParse5.mjs` script as one of its first actions, immediately after the optional `npm install`.
+
+### The Impact
+This change ensures the `parse5` dependency is always available for subsequent build tasks. It makes the build process more robust and predictable, particularly for developers setting up the project for the first time.

package/ServiceWorker.mjs

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

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

@@ -108,7 +108,7 @@ class FooterContainer extends Container {
             }, {
                 module: Component,
                 cls   : ['neo-version'],
-                text  : 'v10.3.0'
+                text  : 'v10.3.1'
             }]
         }],
         /**

package/buildScripts/buildAll.mjs

@@ -129,6 +129,10 @@ if (programOpts.info) {
             childProcess.status && process.exit(childProcess.status);
         }
 
+        console.log(chalk.blue('Bundling parse5...'));
+        childProcess = spawnSync('node', [`${neoPath}/buildScripts/bundleParse5.mjs`], cpOpts);
+        childProcess.status && process.exit(childProcess.status);
+
         if (themes === 'yes') {
             childProcess = spawnSync('node', [`${neoPath}/buildScripts/buildThemes.mjs`].concat(cpArgs), cpOpts);
             childProcess.status && process.exit(childProcess.status);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "neo.mjs",
-    "version": "10.3.0",
+    "version": "10.3.1",
     "description": "Neo.mjs: The multi-threaded UI framework for building ultra-fast, desktop-like web applications with uncompromised responsiveness, inherent security, and a transpilation-free dev mode.",
     "type": "module",
     "repository": {
@@ -29,7 +29,6 @@
         "inject-package-version": "node ./buildScripts/injectPackageVersion.mjs",
         "server-start": "webpack serve -c ./buildScripts/webpack/webpack.server.config.mjs --open",
         "test": "echo \"Error: no test specified\" && exit 1",
-        "build-single-file": "node ./buildScripts/buildSingleFile.mjs",
         "watch-themes": "node ./buildScripts/watchThemes.mjs"
     },
     "keywords": [

package/src/DefaultConfig.mjs

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

package/buildScripts/util/vdomToString.mjs

@@ -1,46 +0,0 @@
-/**
- * A regex to check if a string is a valid JavaScript identifier.
- * @member {RegExp} validIdentifierRegex=/^[a-zA-Z_$][a-zA-Z0-9_$]*$/
- */
-const validIdentifierRegex = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
-
-/**
- * Serializes a VDOM object into a JavaScript object literal string.
- * This is a custom implementation to ensure keys are unquoted if they are
- * valid identifiers, and correctly quoted otherwise. It also handles
- * special placeholders for runtime expressions.
- * @param {Object} vdom The VDOM object to serialize.
- * @returns {String} The string representation of the VDOM.
- */
-export function vdomToString(vdom) {
-    if (vdom === null) {
-        return 'null';
-    }
-    if (typeof vdom !== 'object') {
-        // It's a primitive value (string, number, boolean)
-        // Check for our special expression placeholder
-        if (typeof vdom === 'string') {
-            const match = vdom.match(/##__NEO_EXPR__(.*)##__NEO_EXPR__##/);
-            if (match) {
-                return match[1]; // Return the raw expression
-            }
-        }
-        // Otherwise, stringify it normally
-        return JSON.stringify(vdom);
-    }
-
-    if (Array.isArray(vdom)) {
-        return `[${vdom.map(vdomToString).join(',')}]`;
-    }
-
-    const parts = [];
-    for (const key in vdom) {
-        if (Object.prototype.hasOwnProperty.call(vdom, key)) {
-            const value = vdom[key];
-            const keyString = validIdentifierRegex.test(key) ? key : `'${key}'`;
-            parts.push(`${keyString}:${vdomToString(value)}`);
-        }
-    }
-
-    return `{${parts.join(',')}}`;
-}