neo.mjs 11.2.0 → 11.3.0

package/.github/.sync-metadata.json

@@ -1,6 +1,6 @@
 {
-  "lastSync": "2025-11-13T13:00:00.077Z",
-  "releasesLastFetched": "2025-11-13T13:00:00.085Z",
+  "lastSync": "2025-11-14T15:18:33.969Z",
+  "releasesLastFetched": "2025-11-14T15:18:33.979Z",
   "pushFailures": [],
   "issues": {
     "3789": {
@@ -3617,7 +3617,7 @@
     },
     "7304": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7304.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7304.md",
       "closedAt": "2025-11-12T11:53:00Z",
       "updatedAt": "2025-11-12T11:53:00Z",
       "contentHash": "05f00d7410005fca52997dbb8bd707808c490e5d5a49f2f4fbf554284eb01e4f"
@@ -4331,7 +4331,7 @@
     },
     "7447": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7447.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7447.md",
       "closedAt": "2025-11-12T13:57:32Z",
       "updatedAt": "2025-11-12T13:57:32Z",
       "contentHash": "98d159a41e22c79c28779b7d601cd03166d8e2142f5281dbc6580094c04376b5"
@@ -5619,7 +5619,7 @@
     },
     "7650": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7650.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7650.md",
       "closedAt": "2025-11-13T11:52:40Z",
       "updatedAt": "2025-11-13T11:55:57Z",
       "contentHash": "b71d8302ec3201b6efc5c1108d404f70a4c42056433fb7ebb2f3e943441414b9"
@@ -6235,28 +6235,28 @@
     },
     "7749": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7749.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7749.md",
       "closedAt": "2025-11-12T14:23:01Z",
       "updatedAt": "2025-11-12T14:23:01Z",
       "contentHash": "d5cc4155dc32e52669f21a2464f96e1289fb20aa13486bda0ea89b84a279d855"
     },
     "7750": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7750.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7750.md",
       "closedAt": "2025-11-12T14:27:19Z",
       "updatedAt": "2025-11-12T14:27:19Z",
       "contentHash": "61d61d64ad2c541baa15b10af96e2209318a7acbdb4329b63d41a52ce3841e48"
     },
     "7751": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7751.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7751.md",
       "closedAt": "2025-11-13T10:12:48Z",
       "updatedAt": "2025-11-13T10:12:48Z",
       "contentHash": "f7ec6f01b3c83c34cc3699ca6eee0f4488bffd0c566cccfe9433d6cbc5a87219"
     },
     "7752": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7752.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7752.md",
       "closedAt": "2025-11-12T14:31:45Z",
       "updatedAt": "2025-11-12T14:31:45Z",
       "contentHash": "5f0121262ce785189cb1057dde143df058782f4eec704acd6792d3963a1867d7"
@@ -6265,64 +6265,99 @@
       "state": "OPEN",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7756.md",
       "closedAt": null,
-      "updatedAt": "2025-11-12T14:12:09Z",
-      "contentHash": "656a49e4f060dc6f95bf1e8822f1daff6a6db216c29b42f62b5400a04caa6951"
+      "updatedAt": "2025-11-14T09:15:12Z",
+      "contentHash": "8b3fc488721f1838ea30740801783a201daf70d0c46c49d6dc1543277160f7a3"
     },
     "7757": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7757.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7757.md",
       "closedAt": "2025-11-12T21:15:11Z",
       "updatedAt": "2025-11-12T21:15:11Z",
       "contentHash": "d319761e4e4f6af17f61f8fa82b7585ef80b132adea31a40465a61927e42fcf1"
     },
     "7758": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7758.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7758.md",
       "closedAt": "2025-11-13T10:28:44Z",
       "updatedAt": "2025-11-13T10:28:44Z",
       "contentHash": "b953d24b316824788abe7e050e24e52a80b3c4352e549a09d95ce0f27d04326d"
     },
     "7759": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7759.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7759.md",
       "closedAt": "2025-11-13T10:32:35Z",
       "updatedAt": "2025-11-13T10:32:35Z",
       "contentHash": "b0e8cb24d6a43e6116738dc56ef146d021a8fc0ea67546208b77c53139b5ea22"
     },
     "7760": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7760.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7760.md",
       "closedAt": "2025-11-13T12:49:31Z",
       "updatedAt": "2025-11-13T12:49:31Z",
       "contentHash": "31e236b43a34dbd4199bee0ed79d4d40a88541225f426f877c40cf58f4a1a4d2"
     },
     "7761": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7761.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7761.md",
       "closedAt": "2025-11-12T20:55:18Z",
       "updatedAt": "2025-11-12T20:55:18Z",
       "contentHash": "129524e52a7392ca95e5ac74c61fba0742b2a3fd2ad3e95eacfac986a58acddd"
     },
     "7765": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7765.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7765.md",
       "closedAt": "2025-11-13T09:11:30Z",
       "updatedAt": "2025-11-13T09:11:30Z",
       "contentHash": "12b225e52c7f69b98aeb6f37e7513b5b42221e79865faaaa87642470a9e60d3a"
     },
     "7766": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7766.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7766.md",
       "closedAt": "2025-11-13T09:21:18Z",
       "updatedAt": "2025-11-13T09:21:18Z",
       "contentHash": "1baec98eccb68b5faf5e043729f629da8e6c145b1c3e18d7ee6370df6b28e43f"
     },
     "7767": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7767.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.2.0/issue-7767.md",
       "closedAt": "2025-11-13T10:51:52Z",
       "updatedAt": "2025-11-13T10:51:52Z",
       "contentHash": "67f664cfd7f3c74e548fac407743ea56b2663dd9bf9669a8dd9d6e9eb1d43d74"
+    },
+    "7769": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7769.md",
+      "closedAt": "2025-11-13T22:12:31Z",
+      "updatedAt": "2025-11-13T22:12:31Z",
+      "contentHash": "7c2a6b46c1de475ba4a5c585d2f8fa397aa7bceb8e86767906145c9cd0c33219"
+    },
+    "7770": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7770.md",
+      "closedAt": "2025-11-13T22:17:28Z",
+      "updatedAt": "2025-11-13T22:17:28Z",
+      "contentHash": "7575cb7f05c4aa45189926563059610b8588fc7e6455a4f2a4bb9e030d188f9e"
+    },
+    "7771": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7771.md",
+      "closedAt": "2025-11-13T22:54:46Z",
+      "updatedAt": "2025-11-13T22:54:46Z",
+      "contentHash": "262498b1110113a15db6536f3fe79d8eff910724095bfdf166b5fb885766bd7d"
+    },
+    "7772": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7772.md",
+      "closedAt": "2025-11-14T11:41:20Z",
+      "updatedAt": "2025-11-14T11:41:20Z",
+      "contentHash": "59a12299ce0880d4942ee5509f3f8935c1306bcec067997dbbd7f758dcb1d13c"
+    },
+    "7773": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7773.md",
+      "closedAt": "2025-11-14T15:01:57Z",
+      "updatedAt": "2025-11-14T15:01:57Z",
+      "contentHash": "41b089e9c0e49db562fd044c6e66f3bafd89cc9f2e5cb2b29cf8658886d2650c"
     }
   },
   "releases": {
@@ -6477,6 +6512,10 @@
     "11.1.0": {
       "publishedAt": "2025-11-12T08:53:49Z",
       "contentHash": "9f07fa7f781bea98dbbb0dbd61621e869611d5e8b39da9e7556c1969f352dc4b"
+    },
+    "11.2.0": {
+      "publishedAt": "2025-11-13T13:36:25Z",
+      "contentHash": "2cfc4b0c38c71ec9058af53248b522da9960d48f8d7abfaae0de7e70596b49c6"
     }
   }
 }

package/ServiceWorker.mjs

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

package/ai/mcp/server/knowledge-base/services/DatabaseService.mjs

@@ -331,7 +331,7 @@ class DatabaseService extends Base {
         logger.log(`Using collection: ${collection.name}`);
 
         logger.log('Fetching existing documents from ChromaDB...');
-        const existingDocs = await collection.get({ include: ["metadatas"] });
+        const existingDocs    = await collection.get({ include: ["metadatas"] });
         const existingDocsMap = new Map();
 
         existingDocs.ids.forEach((id, index) => {
@@ -374,8 +374,7 @@ class DatabaseService extends Base {
         logger.log(`Initialized Google AI embedding model: ${aiConfig.embeddingModel}.`);
 
         logger.log('Embedding chunks...');
-        const batchSize  = aiConfig.batchSize;
-        const maxRetries = aiConfig.maxRetries;
+        const {batchSize, maxRetries} = aiConfig;
 
         for (let i = 0; i < chunksToProcess.length; i += batchSize) {
             const batch = chunksToProcess.slice(i, i + batchSize);
@@ -402,7 +401,7 @@ class DatabaseService extends Base {
                     await collection.upsert({
                         ids      : batch.map(chunk => chunk.id),
                         embeddings,
-                        metadatas: metadatas
+                        metadatas
                     });
                     logger.log(`Processed and embedded batch ${i / batchSize + 1} of ${Math.ceil(chunksToProcess.length / batchSize)}`);
                     success = true;

package/apps/portal/index.html

@@ -16,7 +16,7 @@
         "@type": "Organization",
         "name": "Neo.mjs"
       },
-      "datePublished": "2025-11-13",
+      "datePublished": "2025-11-14",
       "publisher": {
         "@type": "Organization",
         "name": "Neo.mjs"

package/apps/portal/llms.txt

@@ -1,10 +1,34 @@
 # Neo.mjs Platform
 
-> Neo.mjs is not a library, but a comprehensive web platform and a new operating system for the web, with over 1000 files and 130,000 lines of code. It is architected for AI collaboration from the ground up, featuring three dedicated Model Context Protocol (MCP) servers. It reimagines web development from first principles, treating the browser as a distributed computing environment, not a single-threaded document renderer.
+> Neo.mjs is not a library, but a comprehensive web platform and a new operating system for the web, with over 1000 
+> files and 130,000 lines of code. It is architected for AI collaboration from the ground up, featuring three dedicated 
+> Model Context Protocol (MCP) servers. It reimagines web development from first principles, treating the browser as a 
+> distributed computing environment, not a single-threaded document renderer.
 >
-> The core of Neo.mjs is its truly multi-threaded architecture which moves all application logic, state management, and data processing off the main thread. This ensures a "jank-free" user experience where the UI remains perfectly responsive, regardless of the workload. The platform provides a holistic, managed environment with operational guarantees, a unified class config system for declaratively describing entire component trees, and critical operational primitives like multi-window state. It includes an enterprise-grade component library.
+> The core of Neo.mjs is its truly multi-threaded architecture which moves all application logic, state management, and 
+> data processing off the main thread. This ensures a "jank-free" user experience where the UI remains perfectly 
+> responsive, regardless of the workload. The platform provides a holistic, managed environment with operational 
+> guarantees, a unified class config system for declaratively describing entire component trees, and critical operational 
+> primitives like multi-window state. It includes an enterprise-grade component library.
 >
-> The developer experience is revolutionary and future-proof, featuring a zero-builds development mode that is 100% based on web standards. This eliminates the frustrating abstraction layer of bundlers and transpilers and ensures that applications evolve with the web platform itself.
+> The developer experience is revolutionary and future-proof, featuring a zero-builds development mode that is 100% based 
+> on web standards. This eliminates the frustrating abstraction layer of bundlers and transpilers and ensures that 
+> applications evolve with the web platform itself.
+
+Neo.mjs uniquely deploys each application and example in four equivalent environments, each serving identical 
+functionality through different code delivery methods: development mode (zero-builds), dist/development (bundled, 
+unminified), dist/esm (native ES modules, optimized), and dist/production (bundled, minified). 
+
+The URLs listed below use the development mode paths (e.g., /apps/ or /examples/), representing the zero-builds, 
+browser-native version that embodies Neo.mjs's core philosophy. To access any application in a different environment, 
+simply prefix the path with /dist/development/, /dist/esm/, or /dist/production/.
+
+For example, the Portal app is available at all four environment URLs, plus a fifth version mapped to the domain root:
+- https://neomjs.com/ (mapped to dist/production)
+- https://neomjs.com/apps/portal/index.html (dev mode)
+- https://neomjs.com/dist/development/apps/portal/index.html
+- https://neomjs.com/dist/esm/apps/portal/index.html
+- https://neomjs.com/dist/production/apps/portal/index.html
 
 ## main
 
@@ -117,3 +141,135 @@
 - [v10 Post 1: A Love Story](https://neomjs.com/#/learn/blog/v10-post1-love-story)
 - [JSON Blueprints & Shared Workers](https://neomjs.com/#/learn/blog/json-blueprints-and-shared-workers)
 
+## Demo Apps and Examples
+
+- [Colors Dashboard](https://neomjs.com/apps/colors/index.html)
+- [COVID-19 IN NUMBERS](https://neomjs.com/apps/covid/index.html)
+- [Email](https://neomjs.com/apps/email/index.html)
+- [Neo.mjs Finance Dashboard](https://neomjs.com/apps/finance/index.html)
+- [Form](https://neomjs.com/apps/form/index.html)
+- [Neo.mjs](https://neomjs.com/apps/portal/index.html)
+- [Conduit](https://neomjs.com/apps/realworld/index.html)
+- [RealWorld2](https://neomjs.com/apps/realworld2/index.html)
+- [Route](https://neomjs.com/apps/route/index.html)
+- [SharedCovid MainWindow](https://neomjs.com/apps/sharedcovid/index.html)
+- [SharedDialog](https://neomjs.com/apps/shareddialog/index.html)
+- [Neo Button](https://neomjs.com/examples/button/base/index.html)
+- [Neo EffectButton](https://neomjs.com/examples/button/effect/index.html)
+- [Neo SplitButton](https://neomjs.com/examples/button/split/index.html)
+- [neo.mjs Calendar Basic](https://neomjs.com/examples/calendar/basic/index.html)
+- [neo.mjs Calendar WeekView](https://neomjs.com/examples/calendar/weekview/index.html)
+- [Neo amCharts](https://neomjs.com/examples/charts/index.html)
+- [Neo OffscreenCanvas](https://neomjs.com/examples/component/canvas/index.html)
+- [Neo Carousel](https://neomjs.com/examples/component/carousel/index.html)
+- [Neo Chip](https://neomjs.com/examples/component/chip/index.html)
+- [Neo Circle](https://neomjs.com/examples/component/circle/index.html)
+- [Neo Clock](https://neomjs.com/examples/component/clock/index.html)
+- [COVID19 Gallery](https://neomjs.com/examples/component/coronaGallery/index.html)
+- [COVID19 Helix](https://neomjs.com/examples/component/coronaHelix/index.html)
+- [Neo DateSelector](https://neomjs.com/examples/component/dateSelector/index.html)
+- [Neo Gallery](https://neomjs.com/examples/component/gallery/index.html)
+- [Neo Helix](https://neomjs.com/examples/component/helix/index.html)
+- [Neo Magic Move - Text](https://neomjs.com/examples/component/magicmovetext/index.html)
+- [Gallery Controls](https://neomjs.com/examples/component/multiWindowCoronaGallery/childapp/index.html)
+- [Neo Multi-Window Corona Gallery](https://neomjs.com/examples/component/multiWindowCoronaGallery/index.html)
+- [Helix Controls](https://neomjs.com/examples/component/multiWindowHelix/childapp/index.html)
+- [Neo Multi-Window Helix](https://neomjs.com/examples/component/multiWindowHelix/index.html)
+- [Neo MWC Button](https://neomjs.com/examples/component/mwc/button/index.html)
+- [Neo MWC Buttons](https://neomjs.com/examples/component/mwc/buttons/index.html)
+- [Neo MWC TextField](https://neomjs.com/examples/component/mwc/textField/index.html)
+- [Neo MWC TextFields](https://neomjs.com/examples/component/mwc/textFields/index.html)
+- [Neo Process Component](https://neomjs.com/examples/component/process/index.html)
+- [Neo Process Real World Example](https://neomjs.com/examples/component/process/realWorldExample/index.html)
+- [Neo Progress](https://neomjs.com/examples/component/progress/index.html)
+- [Neo Splitter](https://neomjs.com/examples/component/splitter/index.html)
+- [Neo StatusBadge](https://neomjs.com/examples/component/statusbadge/index.html)
+- [Neo Timer](https://neomjs.com/examples/component/timer/index.html)
+- [Neo Toast Component](https://neomjs.com/examples/component/toast/index.html)
+- [Neo Video](https://neomjs.com/examples/component/video/index.html)
+- [Neo CesiumJS Component](https://neomjs.com/examples/component/wrapper/cesiumJS/index.html)
+- [Neo GoogleMaps Component](https://neomjs.com/examples/component/wrapper/googleMaps/index.html)
+- [Neo Monaco Editor](https://neomjs.com/examples/component/wrapper/monacoEditor/index.html)
+- [Neo OpenStreetMaps/OpenLayers Component](https://neomjs.com/examples/component/wrapper/openStreetMaps/index.html)
+- [Neo Accordion](https://neomjs.com/examples/container/accordion/index.html)
+- [Neo Containers](https://neomjs.com/examples/container/base/index.html)
+- [neo.mjs config system](https://neomjs.com/examples/core/config/index.html)
+- [Neo Dashboard](https://neomjs.com/examples/dashboard/index.html)
+- [Neo DateSelector](https://neomjs.com/examples/date/selectorContainer/index.html)
+- [Neo Dialog](https://neomjs.com/examples/dialog/index.html)
+- [Neo Fields](https://neomjs.com/examples/fields/index.html)
+- [Field with Prefix](https://neomjs.com/examples/fieldWithPrefix/index.html)
+- [Neo CheckBoxField](https://neomjs.com/examples/form/field/checkbox/index.html)
+- [Neo ChipField](https://neomjs.com/examples/form/field/chip/index.html)
+- [Neo ColorField](https://neomjs.com/examples/form/field/color/index.html)
+- [Neo ComboBox](https://neomjs.com/examples/form/field/combobox/index.html)
+- [Neo DateField](https://neomjs.com/examples/form/field/date/index.html)
+- [Neo EmailField](https://neomjs.com/examples/form/field/email/index.html)
+- [Neo FileUploadField](https://neomjs.com/examples/form/field/fileupload/index.html)
+- [Neo NumberField](https://neomjs.com/examples/form/field/number/index.html)
+- [Neo PickerField](https://neomjs.com/examples/form/field/picker/index.html)
+- [Neo RadioField](https://neomjs.com/examples/form/field/radio/index.html)
+- [Neo SwitchField](https://neomjs.com/examples/form/field/switch/index.html)
+- [Neo TextField](https://neomjs.com/examples/form/field/text/index.html)
+- [Neo TextAreaField](https://neomjs.com/examples/form/field/textarea/index.html)
+- [Neo TimeField](https://neomjs.com/examples/form/field/time/index.html)
+- [Neo Copy to Clipboard Triggers](https://neomjs.com/examples/form/field/trigger/copyToClipboard/index.html)
+- [Neo UrlField](https://neomjs.com/examples/form/field/url/index.html)
+- [Neo Fieldset](https://neomjs.com/examples/form/fieldset/index.html)
+- [Neo Functional Button](https://neomjs.com/examples/functional/button/base/index.html)
+- [Neo Functional Component](https://neomjs.com/examples/functional/defineComponent/index.html)
+- [Functional Component Hosting Component](https://neomjs.com/examples/functional/hostComponent/index.html)
+- [Neo Functional Nested Templates](https://neomjs.com/examples/functional/nestedTemplateComponent/index.html)
+- [Neo Functional Template Component](https://neomjs.com/examples/functional/templateComponent/index.html)
+- [Neo Grid: Animated Row Sorting](https://neomjs.com/examples/grid/animatedRowSorting/index.html)
+- [Neo GridContainer - Big Data](https://neomjs.com/examples/grid/bigData/index.html)
+- [Neo Grid CellEditing](https://neomjs.com/examples/grid/cellEditing/index.html)
+- [Neo GridContainer](https://neomjs.com/examples/grid/container/index.html)
+- [Neo CovidGrid](https://neomjs.com/examples/grid/covid/index.html)
+- [Neo Grid: Nested Record Fields](https://neomjs.com/examples/grid/nestedRecordFields/index.html)
+- [Neo Card Layout](https://neomjs.com/examples/layout/card/index.html)
+- [Neo Cube Layout](https://neomjs.com/examples/layout/cube/index.html)
+- [Neo Form Layout](https://neomjs.com/examples/layout/form/index.html)
+- [Neo AnimatedList](https://neomjs.com/examples/list/animate/index.html)
+- [Neo List](https://neomjs.com/examples/list/base/index.html)
+- [Neo ChipList](https://neomjs.com/examples/list/chip/index.html)
+- [Neo CircleList](https://neomjs.com/examples/list/circle/index.html)
+- [Neo ColorList](https://neomjs.com/examples/list/color/index.html)
+- [Neo MenuList](https://neomjs.com/examples/menu/list/index.html)
+- [Neo Menu](https://neomjs.com/examples/menu/panel/index.html)
+- [Neo Panels](https://neomjs.com/examples/panel/index.html)
+- [Neo Tree](https://neomjs.com/examples/popover/index.html)
+- [Preloading Assets](https://neomjs.com/examples/preloadingAssets/index.html)
+- [Remotes API Basic](https://neomjs.com/examples/remotesApi/basic/index.html)
+- [Neo.mjs - Load Grid Container](https://neomjs.com/examples/serverside/gridContainer/index.html)
+- [Neo.mjs - Load Toolbar Items](https://neomjs.com/examples/serverside/toolbarItems/index.html)
+- [Neo Sitemap](https://neomjs.com/examples/sitemap/index.html)
+- [state.Provider: advanced](https://neomjs.com/examples/stateProvider/advanced/index.html)
+- [state.Provider: dialog](https://neomjs.com/examples/stateProvider/dialog/index.html)
+- [state.Provider: extended class](https://neomjs.com/examples/stateProvider/extendedClass/index.html)
+- [state.Provider: inline definition](https://neomjs.com/examples/stateProvider/inline/index.html)
+- [inline example without using a state.Provider](https://neomjs.com/examples/stateProvider/inlineNoStateProvider/index.html)
+- [stateProvider.multiWindow](https://neomjs.com/examples/stateProvider/multiWindow/index.html)
+- [stateProvider.multiWindow2](https://neomjs.com/examples/stateProvider/multiWindow2/index.html)
+- [state.Provider: nested data](https://neomjs.com/examples/stateProvider/nestedData/index.html)
+- [Neo table & bound store](https://neomjs.com/examples/stateProvider/table/index.html)
+- [state.Provider: 2 way binding](https://neomjs.com/examples/stateProvider/twoWay/index.html)
+- [Neo TabContainer](https://neomjs.com/examples/tab/container/index.html)
+- [Neo Table CellEditing](https://neomjs.com/examples/table/cellEditing/index.html)
+- [Neo TableContainer](https://neomjs.com/examples/table/container/index.html)
+- [Neo CovidTable](https://neomjs.com/examples/table/covid/index.html)
+- [Neo Table: Nested Record Fields](https://neomjs.com/examples/table/nestedRecordFields/index.html)
+- [Neo Table Filtering](https://neomjs.com/examples/tableFiltering/index.html)
+- [Neo Table Performance](https://neomjs.com/examples/tablePerformance/index.html)
+- [Neo Table & Store](https://neomjs.com/examples/tableStore/index.html)
+- [Neo Tabs](https://neomjs.com/examples/tabs/index.html)
+- [Neo TodoList version1](https://neomjs.com/examples/todoList/version1/index.html)
+- [Neo TodoList version2](https://neomjs.com/examples/todoList/version2/index.html)
+- [Neo Breadcrumb Toolbar](https://neomjs.com/examples/toolbar/breadcrumb/index.html)
+- [Neo Paging Toolbar](https://neomjs.com/examples/toolbar/paging/index.html)
+- [Neo Tree](https://neomjs.com/examples/tree/index.html)
+- [Neo Tree](https://neomjs.com/examples/treeAccordion/index.html)
+- [Neo.mjs - Moving a Video Tag](https://neomjs.com/examples/videoMove/index.html)
+- [Neo Viewport](https://neomjs.com/examples/viewport/index.html)
+- [Neo TaskWorker](https://neomjs.com/examples/worker/task/index.html)
+

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

@@ -0,0 +1,30 @@
+{
+    "/about-us": {
+        "title": "About Us - Neo.mjs",
+        "description": "Learn more about the team behind Neo.mjs."
+    },
+    "/blog": {
+        "title": "Neo.mjs Blog",
+        "description": "The official blog for the Neo.mjs platform."
+    },
+    "/docs": {
+        "title": "Neo.mjs Docs",
+        "description": "Official documentation for the Neo.mjs platform."
+    },
+    "/examples": {
+        "title": "Neo.mjs Examples",
+        "description": "A collection of examples for the Neo.mjs platform."
+    },
+    "/home": {
+        "title": "Neo.mjs",
+        "description": "Solve your toughest UI performance challenges with Neo.mjs: a multi-threaded JavaScript platform for extreme real-time web applications, complex dashboards, and unmatched developer productivity."
+    },
+    "/learn": {
+        "title": "Learn Neo.mjs",
+        "description": "Learn the fundamentals of the Neo.mjs platform."
+    },
+    "/services": {
+        "title": "Neo.mjs Services",
+        "description": "Professional services for the Neo.mjs platform."
+    }
+}

package/apps/portal/service/Seo.mjs

@@ -0,0 +1,146 @@
+import Base from '../../../src/core/Base.mjs';
+
+/**
+ * @summary Manages SEO metadata for the Portal application, fetching it from a JSON file
+ * and intelligently updating the document head based on route changes.
+ *
+ * This singleton service is responsible for centralizing all SEO-related logic.
+ * It fetches route-specific title and description metadata from `apps/portal/resources/data/seo.json`
+ * during its asynchronous initialization. It then provides a mechanism for the `ViewportController`
+ * to notify it of route changes. The service ensures that the document's `<title>` and `<meta name="description">`
+ * tags are updated only when the service is fully ready and with the most recent route hash,
+ * preventing race conditions on slow network connections.
+ *
+ * This class demonstrates the use of asynchronous initialization (`initAsync`), reactive config hooks (`afterSetIsReady`),
+ * and private class fields to manage internal state and ensure robust behavior.
+ *
+ * @class Portal.service.Seo
+ * @extends Neo.core.Base
+ * @singleton
+ * @see Portal.view.ViewportController
+ */
+class Seo extends Base {
+    static config = {
+        /**
+         * @member {String} className='Portal.service.Seo'
+         * @protected
+         */
+        className: 'Portal.service.Seo',
+        /**
+         * @member {Boolean} singleton=true
+         * @protected
+         */
+        singleton: true
+    }
+
+    /**
+     * Stores the most recent route hash received from `onRouteChanged()`.
+     * This is used to process a pending route update if the service becomes ready after a route change occurred.
+     * @member {String|null} #lastRouteHash=null
+     * @private
+     */
+    #lastRouteHash = null
+    /**
+     * Caches the SEO metadata fetched from `apps/portal/resources/data/seo.json`.
+     * This object maps route hash strings to their corresponding title and description.
+     * @member {Object|null} #metadata=null
+     * @private
+     */
+    #metadata = null
+
+    /**
+     * Hook that fires after the `isReady` config changes. If the service becomes ready (`value` is true)
+     * and there's a pending route hash (`#lastRouteHash` is not null), it triggers an update
+     * of the document head with the metadata for that route.
+     * @param {Boolean} value The new value of the `isReady` config.
+     * @param {Boolean} oldValue The old value of the `isReady` config.
+     * @protected
+     */
+    afterSetIsReady(value, oldValue) {
+        if (value && this.#lastRouteHash) {
+            this.#updateDocumentHeadIfNeeded(this.#lastRouteHash)
+        }
+    }
+
+    /**
+     * Retrieves the SEO metadata (title and description) for a given route hash.
+     * @param {String} route The route hash string (e.g., '/home', '/blog').
+     * @returns {Object|null} An object containing `title` and `description` for the route, or `null` if not found.
+     */
+    getMetadata(route) {
+        return this.#metadata?.[route] || null
+    }
+
+    /**
+     * Asynchronously initializes the SEO service by fetching the `seo.json` file.
+     * This method simulates an API call to retrieve SEO data, making the service ready
+     * to provide metadata. It ensures that the service is fully loaded before processing
+     * any route-related document head updates.
+     * @returns {Promise<void>} A promise that resolves when the metadata has been fetched and parsed.
+     */
+    async initAsync() {
+        await super.initAsync();
+
+        try {
+            const response = await fetch('../../apps/portal/resources/data/seo.json');
+            if (!response.ok) {
+                throw new Error(`HTTP error with status: ${response.status}`)
+            }
+            this.#metadata = await response.json();
+        } catch (error) {
+            console.error('Error fetching SEO metadata:', error)
+        }
+    }
+
+    /**
+     * Called by the `ViewportController` when the application's route changes.
+     * This method stores the new route hash and attempts to update the document head.
+     * If the service is not yet ready (i.e., `initAsync` is still running), the update
+     * is deferred until `isReady` becomes true.
+     * @param {String} hash The new route hash string.
+     */
+    onRouteChanged(hash) {
+        this.#lastRouteHash = hash;
+        this.#updateDocumentHeadIfNeeded(hash)
+    }
+
+    /**
+     * This private method calls the `DocumentHead` main thread addon to update the document's
+     * title and meta-description for SEO purposes. It is the actual mechanism for applying
+     * the SEO changes to the browser's DOM.
+     * @param {Object} config The configuration object containing `description` and `title`.
+     * @param {String} config.description The new meta-description for the document.
+     * @param {String} config.title The new title for the document.
+     * @private
+     */
+    async #updateDocumentHead({description, title}) {
+        let {windowId}   = this,
+            DocumentHead = await Neo.currentWorker.getAddon('DocumentHead', windowId);
+
+        await DocumentHead.update({description, title, windowId})
+    }
+
+    /**
+     * A private helper method that conditionally updates the document head.
+     * It checks if the service is `isReady` before attempting to retrieve metadata
+     * and call `#updateDocumentHead`. If an update occurs, it clears `#lastRouteHash`.
+     * This prevents multiple updates for the same route if `onRouteChanged` is called
+     * before `initAsync` completes.
+     * @param {String} hash The route hash for which to update the document head.
+     * @private
+     */
+    #updateDocumentHeadIfNeeded(hash) {
+        let me = this;
+
+        if (me.isReady) {
+            let metadata = me.getMetadata(hash);
+
+            if (metadata) {
+                me.#updateDocumentHead(metadata);
+                me.#lastRouteHash = null
+            }
+        }
+    }
+}
+
+export default Neo.setupClass(Seo);