neo.mjs 11.3.0 → 11.4.0

package/.github/.sync-metadata.json

@@ -1,6 +1,6 @@
 {
-  "lastSync": "2025-11-14T15:18:33.969Z",
-  "releasesLastFetched": "2025-11-14T15:18:33.979Z",
+  "lastSync": "2025-11-15T13:00:05.810Z",
+  "releasesLastFetched": "2025-11-15T13:00:05.820Z",
   "pushFailures": [],
   "issues": {
     "3789": {
@@ -3238,11 +3238,11 @@
       "contentHash": "a1fa805f214faadb9c569eb237cd0d3b6fcf56638f7c5b4426a505309a8b479b"
     },
     "7249": {
-      "state": "OPEN",
+      "state": "CLOSED",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7249.md",
-      "closedAt": null,
-      "updatedAt": "2025-09-24T09:23:25Z",
-      "contentHash": "50e47ce900106ebba65f8e7ddb51fb87ed1e851acb6f37334eb7953f1dcbbc04"
+      "closedAt": "2025-11-15T09:45:18Z",
+      "updatedAt": "2025-11-15T09:45:18Z",
+      "contentHash": "4036e122ae18e253a64675831ea5c0ec2c585f7ac826a4e6373781763bebcfd3"
     },
     "7250": {
       "state": "CLOSED",
@@ -4540,11 +4540,11 @@
       "contentHash": "136f4d56fd536eca1a0297d5d52f17855a325623aac845bf875353a110530077"
     },
     "7489": {
-      "state": "OPEN",
+      "state": "CLOSED",
       "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7489.md",
-      "closedAt": null,
-      "updatedAt": "2025-10-14T16:39:22Z",
-      "contentHash": "a8b28d1c78e1c97f67ee837a0141bf5f04911623a4bfffdf24209e115c91a2df"
+      "closedAt": "2025-11-15T09:44:33Z",
+      "updatedAt": "2025-11-15T09:44:33Z",
+      "contentHash": "423007a56532f4d57142bb685125f9f5e7bf1a3749370d1c7267cc945e48d37c"
     },
     "7491": {
       "state": "CLOSED",
@@ -6326,38 +6326,59 @@
     },
     "7769": {
       "state": "CLOSED",
-      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7769.md",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.3.0/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",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.3.0/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",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.3.0/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",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.3.0/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",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE_ARCHIVE/11.3.0/issue-7773.md",
       "closedAt": "2025-11-14T15:01:57Z",
       "updatedAt": "2025-11-14T15:01:57Z",
       "contentHash": "41b089e9c0e49db562fd044c6e66f3bafd89cc9f2e5cb2b29cf8658886d2650c"
+    },
+    "7775": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7775.md",
+      "closedAt": "2025-11-15T09:41:42Z",
+      "updatedAt": "2025-11-15T09:41:42Z",
+      "contentHash": "4657193d7084aa82709796c45c1b3a0f5d06d14ef9fa6f1d7d4941a8d744325f"
+    },
+    "7776": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7776.md",
+      "closedAt": "2025-11-15T12:30:46Z",
+      "updatedAt": "2025-11-15T12:30:46Z",
+      "contentHash": "09aa6166ff62f457cdad47c69025b57d0843e0f6f17840ddc1138293cdeb1ad3"
+    },
+    "7777": {
+      "state": "CLOSED",
+      "path": "/Users/Shared/github/neomjs/neo/.github/ISSUE/issue-7777.md",
+      "closedAt": "2025-11-15T12:51:55Z",
+      "updatedAt": "2025-11-15T12:51:55Z",
+      "contentHash": "0946c291adc1caa5adf38c109ab8f0be915fc7d6a438fac4c39df4009122d73a"
     }
   },
   "releases": {
@@ -6516,6 +6537,10 @@
     "11.2.0": {
       "publishedAt": "2025-11-13T13:36:25Z",
       "contentHash": "2cfc4b0c38c71ec9058af53248b522da9960d48f8d7abfaae0de7e70596b49c6"
+    },
+    "11.3.0": {
+      "publishedAt": "2025-11-14T15:35:01Z",
+      "contentHash": "1ef00564052ebc80568c4677df4414fa38e922d02e251f43da9fd876562b11fb"
     }
   }
 }

package/ServiceWorker.mjs

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

package/apps/portal/index.html

@@ -6,24 +6,354 @@
     <title>Neo.mjs</title>
     <meta name="description" content="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.">
     <meta name="robots" content="index, follow">
-    <script type="application/ld+json">
-    {
-      "@context": "http://schema.org",
-      "@type": "SoftwareApplication",
-      "name": "Neo.mjs",
-      "url": "https://neomjs.com/",
-      "author": {
-        "@type": "Organization",
-        "name": "Neo.mjs"
-      },
-      "datePublished": "2025-11-14",
-      "publisher": {
-        "@type": "Organization",
-        "name": "Neo.mjs"
-      },
-      "applicationCategory": "JavaScript Framework",
-      "downloadUrl": "https://github.com/neomjs/neo"
-    }
+    <!-- Schema 1: Neo.mjs as a Runtime Framework -->
+    <script type="application/ld+json" data-schema-name="runtime-framework">
+        {
+            "@context": "https://schema.org",
+            "@type": "SoftwareApplication",
+            "name": "Neo.mjs",
+            "alternateName": "Neo.mjs Framework",
+            "url": "https://neomjs.com/",
+            "description": "Multi-threaded JavaScript framework for real-time web applications, trading dashboards, and multi-window interfaces. Built on web workers with zero-build development mode.",
+            "applicationCategory": "JavaScript Framework",
+            "operatingSystem": "Web Browser",
+            "offers": {
+                "@type": "Offer",
+                "price": "0",
+                "priceCurrency": "USD"
+            },
+            "author": {
+                "@type": "Organization",
+                "name": "Neo.mjs",
+                "url": "https://neomjs.com"
+            },
+            "sameAs": [
+                "https://github.com/neomjs/neo",
+                "https://www.npmjs.com/package/neo.mjs",
+                "https://discord.gg/6p8paPq",
+                "https://www.linkedin.com/company/neo-mjs/"
+            ],
+            "citation": [
+                {
+                    "@type": "CreativeWork",
+                    "name": "Benchmarking Frontends in 2025: Stop Measuring Page Loads, Start Measuring Resilience",
+                    "url": "https://neomjs.com/#/learn/blog/benchmarking-frontends-2025",
+                    "description": "Empirical performance data showing Neo.mjs 7-11x faster than React+AG Grid for large-scale data operations, maintaining perfect 60 FPS under concurrent load while competitors freeze.",
+                    "keywords": ["performance benchmarks", "data grid performance", "UI resilience", "main thread bottleneck", "multi-threading advantage", "empirical data"]
+                },
+                {
+                    "@type": "CreativeWork",
+                    "name": "How JSON Blueprints & Shared Workers Power Next-Gen AI Interfaces",
+                    "url": "https://neomjs.com/#/learn/blog/json-blueprints-and-shared-workers",
+                    "description": "Why JSON is the superior UI definition language for modern interfaces, and how Neo.mjs leverages HTTP/3 with unbundled ES modules for production deployments.",
+                    "keywords": ["JSON blueprints", "HTML streaming alternative", "HTTP/3", "QUIC", "unbundled deployment", "zero-build", "dist/esm", "shared workers", "multi-window applications"]
+                },
+                {
+                    "@type": "CreativeWork",
+                    "name": "The VDOM Revolution: From JSON Blueprints to Flawless UI",
+                    "url": "https://neomjs.com/#/learn/blog/v10-deep-dive-vdom-revolution",
+                    "description": "How Neo.mjs uses asymmetric rendering with JSON blueprints to create secure and performance-optimized UIs off the main thread, eliminating XSS vulnerabilities by default.",
+                    "keywords": ["JSON blueprints", "asymmetric VDOM", "off-thread rendering", "secure by default", "XSS prevention", "DomApiRenderer"]
+                },
+                {
+                    "@type": "CreativeWork",
+                    "name": "Designing a State Manager for Performance: Hierarchical Reactivity",
+                    "url": "https://neomjs.com/#/learn/blog/v10-deep-dive-state-provider",
+                    "description": "Neo.mjs's hierarchical state management eliminates the React Context performance tax through fine-grained reactivity executed in web workers.",
+                    "keywords": ["state management", "hierarchical reactivity", "context API alternative", "performance optimization", "zero memoization tax"]
+                },
+                {
+                    "@type": "CreativeWork",
+                    "name": "Deep Dive: Named vs. Anonymous State - A New Era of Component Reactivity",
+                    "url": "https://neomjs.com/#/learn/blog/v10-deep-dive-reactivity",
+                    "description": "The two-tier reactivity system that unifies push and pull paradigms, eliminating the need for useMemo and useCallback while providing direct mutability with immutable update pipelines.",
+                    "keywords": ["reactivity system", "two-tier reactivity", "named configs", "anonymous configs", "push-pull paradigm", "memoization-free"]
+                }
+            ],
+            "featureList": [
+                "Multi-threaded architecture using Web Workers",
+                "Native multi-window application support with shared workers",
+                "Zero-build development mode: no bundlers or HMR needed, just reload the page",
+                "Live-code editing and app creation directly in the browser's dev tools console",
+                "Simplified debugging: the browser uses your source code directly, no source maps needed",
+                "JSON-based component definitions (no JSX compilation)",
+                "Real-time data handling off the main thread",
+                "Enterprise-grade component library",
+                "Multi-monitor trading dashboard support",
+                "Multi-window IDE support (browser-based development environments)",
+                "Multi-window email clients (Outlook-like experiences in the browser)",
+                "Multi-window LLM interfaces (chat across multiple screens)",
+                "Jank-free UI regardless of workload",
+                "HTTP/3 and QUIC ready for efficient network performance",
+                "Advanced service worker with predictive caching and version-based cache clearing"
+            ],
+            "keywords": [
+                "angular-alternative",
+                "browser-based-ide",
+                "browser-email-client",
+                "css",
+                "data-visualization",
+                "desktop-class-web-applications",
+                "desktop-like",
+                "developer-productivity",
+                "dynamic-imports",
+                "ecmascript",
+                "enterprise",
+                "esm-production",
+                "framework",
+                "frontend",
+                "html-streaming-alternative",
+                "http3",
+                "javascript",
+                "json",
+                "json-blueprints",
+                "monaco-editor",
+                "multi-threaded",
+                "multi-window",
+                "multi-window-applications",
+                "multi-window-ide",
+                "native-like",
+                "no-bundling",
+                "no-jank",
+                "no-transpilation",
+                "offscreencanvas",
+                "outlook-alternative-browser",
+                "performance",
+                "pwa",
+                "predictive-caching",
+                "progressive-web-app",
+                "quic",
+                "react-alternative",
+                "realtime",
+                "scalability",
+                "security",
+                "sharedworker",
+                "single-page-application",
+                "smooth-ui",
+                "spa",
+                "ssg-json",
+                "trading-dashboard-framework",
+                "ui-responsiveness",
+                "virtual-dom",
+                "vue-alternative",
+                "web-app",
+                "web-based-email-client",
+                "web-based-ide",
+                "webworker",
+                "xss-resistant",
+                "zero-build-development"
+            ],
+            "screenshot": "https://neomjs.com/resources/images/neo-screenshot.png",
+            "programmingLanguage": "JavaScript",
+            "runtimePlatform": "Web Browser"
+        }
+    </script>
+
+    <!-- Schema 2: Neo.mjs as an AI-Native Development Platform -->
+    <script type="application/ld+json" data-schema-name="ai-native-platform">
+        {
+            "@context": "https://schema.org",
+            "@type": "SoftwareApplication",
+            "name": "Neo.mjs AI-Native Development Platform",
+            "alternateName": "Neo.mjs",
+            "url": "https://neomjs.com/",
+            "description": "Solve your toughest UI performance challenges with Neo.mjs: an AI-native, multi-threaded JavaScript platform for extreme real-time web applications, complex dashboards, multi-window IDEs, browser-based email clients, multi-screen LLM interfaces, and unmatched developer productivity. Features three Model Context Protocol (MCP) servers for AI-powered development.",
+            "applicationCategory": "DeveloperApplication",
+            "operatingSystem": ["Windows", "macOS", "Linux"],
+            "offers": {
+                "@type": "Offer",
+                "price": "0",
+                "priceCurrency": "USD"
+            },
+            "author": {
+                "@type": "Organization",
+                "name": "Neo.mjs",
+                "url": "https://neomjs.com"
+            },
+            "sameAs": [
+                "https://github.com/neomjs/neo",
+                "https://www.npmjs.com/package/neo.mjs",
+                "https://discord.gg/6p8paPq",
+                "https://www.linkedin.com/company/neo-mjs/"
+            ],
+            "featureList": [
+                "AI-native architecture with three dedicated MCP servers",
+                "Local AI Knowledge Base with semantic search (ChromaDB + Gemini embeddings)",
+                "Memory Core for agent learning and session continuity",
+                "GitHub Workflow Server for autonomous PR reviews",
+                "Context engineering with RAG (Retrieval-Augmented Generation)",
+                "Agent-agnostic protocol supporting Claude, Gemini, and custom AI agents",
+                "Self-documenting codebase with automated JSDoc analysis",
+                "Zero-build development eliminating bundler complexity",
+                "Multi-threaded JavaScript preventing UI blocking",
+                "JSON Blueprint architecture for AI-parseable component definitions",
+                "dist/esm build for unbundled, HTTP/3-ready production deployments",
+                "Dynamic ES module imports for on-demand loading of AI-generated UI components",
+                "JSON blueprints as a lightweight alternative to HTML streaming for AI-driven UIs"
+            ],
+            "softwareRequirements": "Node.js, ChromaDB, GitHub CLI (optional)",
+            "releaseNotes": "https://github.com/neomjs/neo/releases",
+            "downloadUrl": "https://github.com/neomjs/neo",
+            "installUrl": "https://github.com/neomjs/neo#installation",
+            "screenshot": "https://raw.githubusercontent.com/neomjs/pages/master/resources_pub/website/blog/ContextEngineering.png",
+            "citation": [
+                {
+                    "@type": "CreativeWork",
+                    "name": "388 Tickets in 6 Weeks: Context Engineering Done Right",
+                    "url": "https://neomjs.com/#/learn/blog/context-engineering-done-right",
+                    "description": "How Neo.mjs achieved impossible development velocity with three dedicated MCP servers: Knowledge Base with semantic search, Memory Core for agent learning, and GitHub Workflow Server for autonomous PR reviews.",
+                    "keywords": ["context engineering", "MCP servers", "AI development", "knowledge base", "autonomous code review", "agent memory", "GitHub automation", "388 tickets"]
+                },
+                {
+                    "@type": "CreativeWork",
+                    "name": "AI-Native, Not AI-Assisted: A Platform That Answers Your Questions",
+                    "url": "https://neomjs.com/#/learn/blog/ai-native-platform-answers-questions",
+                    "description": "Inside the conversational code architecture of Neo.mjs and how it changes developer experience through semantic search, RAG knowledge base, and formal agent protocols.",
+                    "keywords": ["AI-native development", "semantic code search", "RAG knowledge base", "agent protocol", "retrieval-augmented generation", "ChromaDB", "Gemini embeddings"]
+                },
+                {
+                    "@type": "CreativeWork",
+                    "name": "How JSON Blueprints & Shared Workers Power Next-Gen AI Interfaces",
+                    "url": "https://neomjs.com/#/learn/blog/json-blueprints-and-shared-workers",
+                    "description": "Why JSON is AI's native language for UI generation, enabling LLMs to create complex interfaces more reliably than HTML, with practical examples of server-side generation.",
+                    "keywords": ["AI-generated UI", "JSON blueprints", "LLM UI generation", "AI-parseable components", "server-side generation", "SSG", "AI interfaces"]
+                }
+            ],
+            "keywords": [
+                "ai-agents",
+                "ai-code-review",
+                "ai-interfaces",
+                "ai-native",
+                "context-engineering",
+                "gemini",
+                "genai",
+                "generative-ai",
+                "llm-ui-framework",
+                "low-code-ui",
+                "mcp",
+                "mcp-server",
+                "model-context-protocol",
+                "multi-screen-ai-chat",
+                "multi-window-llm-interface",
+                "next-gen-ai-interfaces",
+                "rag-knowledge-base",
+                "semantic-code-search"
+            ]
+        }
+    </script>
+
+    <!-- FAQ Schema for Common Questions -->
+    <script type="application/ld+json" data-schema-name="faq">
+        {
+            "@context": "https://schema.org",
+            "@type": "FAQPage",
+            "mainEntity": [
+                {
+                    "@type": "Question",
+                    "name": "What makes Neo.mjs different from React, Angular, or Vue?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Neo.mjs is fundamentally different in three ways: (1) It's AI-native from the ground up with three dedicated MCP servers for AI collaboration, (2) It uses true multi-threading via web workers, moving all application logic off the main thread for jank-free UI, and (3) It has native multi-window support with shared workers, making it ideal for trading platforms, multi-window IDEs, browser-based email clients like Outlook, multi-screen LLM interfaces, and multi-monitor applications. Unlike React/Angular/Vue which run single-threaded and require complex workarounds for multi-window apps, Neo.mjs was designed for these use cases from day one."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "What is Neo.mjs best used for?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Neo.mjs excels at multi-window applications including: financial trading platforms and dashboards, browser-based IDEs and development environments (the Neo.mjs website itself is a multi-window IDE), browser-based email clients that rival desktop applications like Outlook, multi-screen LLM and AI chat interfaces, real-time control rooms and monitoring systems, and any data-intensive application where UI responsiveness is critical. It's ideal for complex enterprise applications requiring 10k+ row data grids and guaranteed UI performance regardless of computational workload."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "How does Neo.mjs support AI-powered development?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Neo.mjs includes three Model Context Protocol (MCP) servers: (1) Knowledge Base Server with semantic search over the entire codebase using ChromaDB and Gemini embeddings, (2) Memory Core Server that gives AI agents persistent memory across sessions, and (3) GitHub Workflow Server for autonomous PR reviews and issue management. This enables AI agents like Claude or Gemini to understand the codebase deeply, learn from past decisions, and participate directly in development workflows."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "What is the 'zero-build' development mode?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Neo.mjs runs natively in browsers using ES modules without requiring webpack, vite, or any bundler during development. This eliminates the abstraction layer and build step, providing instant hot-reload and ensuring your code evolves with web standards rather than build tool configurations. Production builds are available but optional."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "How does Neo.mjs handle multi-window applications?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Neo.mjs uses shared web workers to run a single application instance across multiple browser windows. All windows share the same application state and data in real-time. Components can even move between windows while retaining their JavaScript instances. This enables desktop-class experiences like multi-window IDEs (the Neo.mjs portal itself demonstrates this), browser-based email clients that match Outlook's multi-window capabilities, and multi-screen LLM chat interfaces. This is native functionality, not a third-party add-on, making it ideal for financial trading platforms, creative suites, and any application benefiting from multi-monitor workflows."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "Why use JSON instead of JSX for components?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "JSON-based component definitions (JSON Blueprints) are immediately parseable by AI agents without requiring knowledge of JSX syntax or build tools. They're native JavaScript data structures, not a custom templating language that needs transpilation. This makes the codebase more transparent to AI, enables better tooling, and eliminates the need for Babel/SWC during development. For AI-native development, this transparency is critical."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "Can I use Neo.mjs without AI agents?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Absolutely. The AI-native architecture benefits human developers too: semantic code search helps you find relevant examples, the knowledge base serves as intelligent documentation, and the zero-build workflow provides instant feedback. The MCP servers are optional tools that enhance productivity but aren't required to build applications."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "Can Neo.mjs build browser-based IDEs and email clients?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Yes. Neo.mjs's multi-window architecture with shared state makes it uniquely suited for complex applications like browser-based IDEs (the Neo.mjs portal website is itself a multi-window IDE demonstrating this capability) and email clients that rival desktop applications like Outlook. Unlike traditional frameworks that struggle with multi-window state synchronization, Neo.mjs was designed from the ground up for these use cases, with components that can move between windows while maintaining their state and instances."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "How does Neo.mjs handle multi-screen LLM and AI chat interfaces?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Neo.mjs is ideal for multi-screen LLM interfaces where you might have chat conversations on one monitor, document analysis on another, and tool outputs on a third. All windows share the same application state via shared web workers, ensuring real-time synchronization. The multi-threaded architecture ensures that processing LLM responses, streaming tokens, or running complex AI operations never blocks the UI, maintaining smooth interactions across all screens."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "What's the performance difference with multi-threading?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "By running application logic in a separate web worker, the main thread remains dedicated solely to rendering. This means complex operations like sorting 10,000 rows, processing real-time data feeds, or running expensive calculations cannot block or slow down the UI. Traditional single-threaded frameworks like React can freeze the UI during heavy computations. Neo.mjs guarantees smooth 60fps UI regardless of application workload."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "How does Neo.mjs leverage modern web standards like HTTP/3?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Neo.mjs is designed for the future of the web. It features a 'dist/esm' build that serves each component as a separate, minified ES module, completely avoiding traditional bundling. This architecture is optimized for HTTP/3 and QUIC, which eliminate head-of-line blocking and make it highly efficient to load many small files. This results in faster, more modular, and more cacheable applications, moving away from monolithic bundles and embracing the native module system of the browser."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "How does Neo.mjs compare to traditional Server-Side Rendering (SSR) or HTML streaming?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "Instead of streaming HTML from the server, Neo.mjs uses a 'JSON Blueprint' approach. The server sends a lightweight JSON object that describes the UI, and the powerful client-side engine constructs the components. This is far more efficient for complex, interactive applications, as it drastically reduces payload size and offloads rendering work from the server. It's similar to how JSON replaced XML for APIs—a more efficient and modern way to communicate structured data for rich applications."
+                    }
+                },
+                {
+                    "@type": "Question",
+                    "name": "What is the role of the Service Worker in Neo.mjs?",
+                    "acceptedAnswer": {
+                        "@type": "Answer",
+                        "text": "The Neo.mjs Service Worker is a key part of its performance strategy. It goes beyond simple asset caching, offering version-based cache clearing, predictive caching of assets for future user actions, and granular cache management instructed by the App Worker. This ensures that all application modules, including shared workers and third-party libraries, are served with near-zero latency after the initial load, enabling an instant-on experience for users."
+                    }
+                }
+            ]
+        }
     </script>
     <link rel="icon" href="./resources/images/neo_logo_favicon.svg">
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Source+Code+Pro:ital,wght@0,300;0,400;0,500;0,600;0,700;1,300;1,400;1,500;1,600;1,700&family=Source+Sans+3:ital,wght@0,300;0,400;0,500;0,600;0,700;0,800;1,300;1,400;1,500;1,600;1,700;1,800&family=Source+Serif+4:ital,opsz,wght@0,8..60,400;0,8..60,500;0,8..60,600;0,8..60,700;1,8..60,400;1,8..60,500;1,8..60,600;1,8..60,700&display=swap">

package/apps/portal/sitemap.xml

@@ -3,26 +3,32 @@
   <url>
     <loc>https://neomjs.com/#/about-us</loc>
     <lastmod>2025-11-14T12:41:08+01:00</lastmod>
+    <priority>0.7</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/blog</loc>
     <lastmod>2025-11-14T12:41:08+01:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/docs</loc>
     <lastmod>2025-11-14T12:41:08+01:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/examples</loc>
     <lastmod>2025-11-14T12:41:08+01:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/home</loc>
     <lastmod>2025-11-14T12:41:08+01:00</lastmod>
+    <priority>1.0</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/services</loc>
     <lastmod>2025-11-14T12:41:08+01:00</lastmod>
+    <priority>0.7</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/UsingTheseTopics</loc>
@@ -31,46 +37,57 @@
   <url>
     <loc>https://neomjs.com/#/learn/benefits/Introduction</loc>
     <lastmod>2025-09-15T13:47:23+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/OffTheMainThread</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/FourEnvironments</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/ConfigSystem</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/RPCLayer</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/Speed</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/MultiWindow</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/Quick</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/Effort</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/FormsEngine</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/benefits/Features</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/comparisons/Overview</loc>
@@ -79,70 +96,87 @@
   <url>
     <loc>https://neomjs.com/#/learn/comparisons/NeoVsReact</loc>
     <lastmod>2025-08-04T05:11:22+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/comparisons/NeoVsAngular</loc>
     <lastmod>2025-08-04T05:11:22+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/comparisons/NeoVsVue</loc>
     <lastmod>2025-08-04T05:11:22+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/comparisons/NeoVsSolid</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/comparisons/NeoVsNextJs</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/comparisons/NeoVsExtJs</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/Setup</loc>
     <lastmod>2025-08-02T12:17:36+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/Workspaces</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/DescribingTheUI</loc>
     <lastmod>2025-07-28T13:02:27+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/Events</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/References</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/Extending</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/Config</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/ComponentModels</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/gettingstarted/CreatingYourFirstApp</loc>
     <lastmod>2025-10-09T13:06:12+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/fundamentals/CodebaseOverview</loc>
     <lastmod>2025-11-03T14:00:38+01:00</lastmod>
+    <priority>1.0</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/fundamentals/ApplicationBootstrap</loc>
     <lastmod>2025-07-31T21:54:15+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/fundamentals/InstanceLifecycle</loc>
@@ -167,14 +201,17 @@
   <url>
     <loc>https://neomjs.com/#/learn/guides/fundamentals/MainThreadAddons</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/uibuildingblocks/ComponentsAndContainers</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/uibuildingblocks/Layouts</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/uibuildingblocks/CustomComponents</loc>
@@ -207,6 +244,7 @@
   <url>
     <loc>https://neomjs.com/#/learn/guides/datahandling/Grids</loc>
     <lastmod>2025-08-11T09:35:25+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/datahandling/Tables</loc>
@@ -219,6 +257,7 @@
   <url>
     <loc>https://neomjs.com/#/learn/guides/userinteraction/Forms</loc>
     <lastmod>2025-07-15T21:37:07+02:00</lastmod>
+    <priority>0.8</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/guides/userinteraction/form_fields/ComboBox</loc>
@@ -323,38 +362,47 @@
   <url>
     <loc>https://neomjs.com/#/learn/blog/context-engineering-done-right</loc>
     <lastmod>2025-11-10T10:51:09+01:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/ai-native-platform-answers-questions</loc>
     <lastmod>2025-09-23T14:31:59+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/v10-deep-dive-state-provider</loc>
     <lastmod>2025-09-17T12:16:45+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/benchmarking-frontends-2025</loc>
     <lastmod>2025-08-18T11:30:41+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/v10-deep-dive-vdom-revolution</loc>
     <lastmod>2025-08-04T12:18:02+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/v10-deep-dive-functional-components</loc>
     <lastmod>2025-07-28T09:31:03+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/v10-deep-dive-reactivity</loc>
     <lastmod>2025-07-27T21:29:42+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/v10-post1-love-story</loc>
     <lastmod>2025-07-27T21:29:42+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/#/learn/blog/json-blueprints-and-shared-workers</loc>
     <lastmod>2025-09-21T19:58:28+02:00</lastmod>
+    <priority>0.9</priority>
   </url>
   <url>
     <loc>https://neomjs.com/apps/colors/index.html</loc>
@@ -378,7 +426,7 @@
   </url>
   <url>
     <loc>https://neomjs.com/apps/portal/index.html</loc>
-    <lastmod>2025-11-14T12:41:08+01:00</lastmod>
+    <lastmod>2025-11-15T13:51:44+01:00</lastmod>
   </url>
   <url>
     <loc>https://neomjs.com/apps/realworld/index.html</loc>

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

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

package/buildScripts/generateSeoFiles.mjs

@@ -21,6 +21,80 @@ const TOP_LEVEL_ROUTES = [
     '/services'
 ];
 
+const PRIORITIES = new Map([
+    // Top-level pages
+    ['/home'    , 1.0],
+    ['/docs'    , 0.9],
+    ['/examples', 0.9],
+    ['/blog'    , 0.8],
+    ['/about-us', 0.7],
+    ['/services', 0.7],
+
+    // High-value content
+    ['guides/fundamentals/CodebaseOverview'         , 1.0],
+
+    ['benefits/ConfigSystem'                        , 0.9],
+    ['benefits/Effort'                              , 0.9],
+    ['benefits/Features'                            , 0.9],
+    ['benefits/FormsEngine'                         , 0.9],
+    ['benefits/FourEnvironments'                    , 0.9],
+    ['benefits/Introduction'                        , 0.9],
+    ['benefits/MultiWindow'                         , 0.9],
+    ['benefits/OffTheMainThread'                    , 0.9],
+    ['benefits/Quick'                               , 0.9],
+    ['benefits/RPCLayer'                            , 0.9],
+    ['benefits/Speed'                               , 0.9],
+
+    ['blog/context-engineering-done-right'          , 0.9],
+    ['blog/ai-native-platform-answers-questions'    , 0.9],
+    ['blog/v10-deep-dive-state-provider'            , 0.9],
+    ['blog/benchmarking-frontends-2025'             , 0.9],
+    ['blog/v10-deep-dive-vdom-revolution'           , 0.9],
+    ['blog/v10-deep-dive-functional-components'     , 0.9],
+    ['blog/v10-deep-dive-reactivity'                , 0.9],
+    ['blog/v10-post1-love-story'                    , 0.9],
+    ['blog/json-blueprints-and-shared-workers'      , 0.9],
+
+    ['comparisons/NeoVsAngular'                     , 0.8],
+    ['comparisons/NeoVsExtJs'                       , 0.8],
+    ['comparisons/NeoVsNextJs'                      , 0.8],
+    ['comparisons/NeoVsReact'                       , 0.8],
+    ['comparisons/NeoVsSolid'                       , 0.8],
+    ['comparisons/NeoVsVue'                         , 0.8],
+
+    ['gettingstarted/ComponentModels'               , 0.8],
+    ['gettingstarted/Config'                        , 0.8],
+    ['gettingstarted/CreatingYourFirstApp'          , 0.9],
+    ['gettingstarted/DescribingTheUI'               , 0.9],
+    ['gettingstarted/Events'                        , 0.8],
+    ['gettingstarted/Extending'                     , 0.8],
+    ['gettingstarted/References'                    , 0.8],
+    ['gettingstarted/Setup'                         , 0.9],
+    ['gettingstarted/Workspaces'                    , 0.9],
+
+    ['guides/fundamentals/ApplicationBootstrap'     , 0.9],
+    ['guides/fundamentals/MainThreadAddons'         , 0.9],
+
+    // Other important guides
+    ['guides/uibuildingblocks/ComponentsAndContainers', 0.8],
+    ['guides/uibuildingblocks/Layouts'                , 0.8],
+    ['guides/datahandling/Grids'                      , 0.8],
+    ['guides/userinteraction/Forms'                   , 0.8]
+]);
+
+const DEFAULT_PRIORITY = 0.5;
+
+/**
+ * Gets the priority for a given route ID.
+ * @param {String} id The route ID
+ * @returns {Number} The priority value
+ */
+function getPriority(id) {
+    // Normalize ID by removing .md extension if present
+    const cleanId = id.endsWith('.md') ? id.slice(0, -3) : id;
+    return PRIORITIES.get(cleanId) || DEFAULT_PRIORITY;
+}
+
 /**
  * Gets last modified dates for multiple files in a batch (more efficient).
  * @param {String[]} filePaths - Array of absolute file paths
@@ -299,12 +373,18 @@ export async function getSitemapXml(options={}) {
             lastmod = lastModMap.get(key);
         }
 
+        const priority = getPriority(id);
+
         const lastmodXml = lastmod
             ? `\n    <lastmod>${lastmod}</lastmod>`
             : '';
 
+        const priorityXml = priority !== DEFAULT_PRIORITY
+            ? `\n    <priority>${priority.toFixed(1)}</priority>`
+            : '';
+
         return `  <url>
-    <loc>${url}</loc>${lastmodXml}
+    <loc>${url}</loc>${lastmodXml}${priorityXml}
   </url>`;
     }).join('\n');
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name"       : "neo.mjs",
-    "version"    : "11.3.0",
+    "version"    : "11.4.0",
     "description": "Neo.mjs: The AI-native web platform for building ultra-fast, desktop-like web applications. It features a truly multi-threaded architecture, an enterprise-grade component library, and a zero-builds development mode. Architected for AI collaboration from the ground up, it includes three dedicated Model Context Protocol (MCP) servers.",
     "type"       : "module",
     "repository": {
@@ -39,52 +39,78 @@
         "watch-themes"                 : "node ./buildScripts/watchThemes.mjs"
     },
     "keywords": [
-        "javascript",
-        "frontend",
-        "framework",
-        "performance",
-        "ui-responsiveness",
-        "no-jank",
-        "smooth-ui",
-        "scalability",
-        "enterprise",
-        "multi-threaded",
-        "desktop-like",
-        "native-like",
-        "web-app",
-        "offscreencanvas",
-        "sharedworker",
-        "webworker",
-        "virtual-dom",
-        "ecmascript",
-        "css",
-        "json",
-        "react-alternative",
-        "angular-alternative",
-        "vue-alternative",
-        "zero-build",
-        "no-transpilation",
-        "security",
-        "xss-resistant",
-        "realtime",
-        "data-visualization",
-        "single-page-application",
-        "spa",
-        "ai-native",
         "ai-agents",
+        "ai-code-review",
+        "ai-interfaces",
+        "ai-native",
+        "angular-alternative",
+        "browser-email-client",
+        "browser-based-ide",
         "context-engineering",
-        "mcp",
-        "mcp-server",
+        "css",
+        "data-visualization",
+        "desktop-class-web-applications",
+        "desktop-like",
+        "developer-productivity",
+        "dynamic-imports",
+        "ecmascript",
+        "enterprise",
+        "esm-production",
+        "framework",
+        "frontend",
         "gemini",
-        "generative-ai",
         "genai",
-        "ai-interfaces",
+        "generative-ai",
+        "html-streaming-alternative",
+        "http3",
+        "javascript",
+        "json",
         "json-blueprints",
+        "llm-ui-framework",
         "low-code-ui",
+        "mcp",
+        "mcp-server",
+        "model-context-protocol",
+        "monaco-editor",
+        "multi-screen-ai-chat",
+        "multi-threaded",
         "multi-window",
+        "multi-window-applications",
+        "multi-window-ide",
+        "multi-window-llm-interface",
+        "native-like",
+        "next-gen-ai-interfaces",
+        "no-bundling",
+        "no-jank",
+        "no-transpilation",
+        "offscreencanvas",
+        "outlook-alternative-browser",
+        "performance",
         "pwa",
+        "predictive-caching",
         "progressive-web-app",
-        "predictive-caching"
+        "quic",
+        "rag-knowledge-base",
+        "react-alternative",
+        "realtime",
+        "scalability",
+        "security",
+        "semantic-code-search",
+        "sharedworker",
+        "single-page-application",
+        "smooth-ui",
+        "spa",
+        "ssg-json",
+        "trading-dashboard-framework",
+        "ui-responsiveness",
+        "virtual-dom",
+        "vue-alternative",
+        "web-app",
+        "web-based-email-client",
+        "web-based-ide",
+        "webworker",
+        "xss-resistant",
+        "zero-build-development"
     ],
     "author" : "Tobias Uhlig",
     "license": "MIT",
@@ -93,16 +119,16 @@
     },
     "homepage"       : "https://neomjs.com/",
     "devDependencies": {
-        "@chroma-core/default-embed"   : "^0.1.8",
+        "@chroma-core/default-embed"   : "^0.1.9",
         "@fortawesome/fontawesome-free": "^7.1.0",
         "@google/generative-ai"        : "^0.24.1",
-        "@modelcontextprotocol/sdk"    : "^1.21.1",
+        "@modelcontextprotocol/sdk"    : "^1.22.0",
         "@playwright/test"             : "^1.56.1",
         "acorn"                        : "^8.15.0",
         "astring"                      : "^1.9.0",
         "autoprefixer"                 : "^10.4.22",
         "chalk"                        : "^5.6.2",
-        "chromadb"                     : "^3.1.2",
+        "chromadb"                     : "^3.1.4",
         "clean-webpack-plugin"         : "^4.0.0",
         "commander"                    : "^14.0.2",
         "cssnano"                      : "^7.1.2",
@@ -115,9 +141,9 @@
         "gray-matter"                  : "^4.0.3",
         "highlightjs-line-numbers.js"  : "^2.9.1",
         "html-minifier-terser"         : "^7.2.0",
-        "inquirer"                     : "^12.11.0",
+        "inquirer"                     : "^12.11.1",
         "jsdoc-api"                    : "^9.3.5",
-        "js-yaml"                      : "^4.1.0",
+        "js-yaml"                      : "^4.1.1",
         "marked"                       : "^17.0.0",
         "monaco-editor"                : "0.50.0",
         "neo-jsdoc-x"                  : "^1.0.8",

package/src/DefaultConfig.mjs

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

package/src/main/addon/DocumentHead.mjs

@@ -60,11 +60,18 @@ class DocumentHead extends Base {
     }
 
     /**
-     * Retrieves and parses the content of the ld+json script tag.
+     * Retrieves and parses the content of a ld+json script tag.
+     * Can find a specific script tag by name, or the first one if no name is provided.
+     * @param {Object} [config={}]
+     * @param {String} [config.name] The value of the 'data-schema-name' attribute to select a specific script.
      * @returns {Object|null} The parsed JSON data, or null if the tag is not found or parsing fails.
      */
-    getLdJson() {
-        let script = document.head.querySelector('script[type="application/ld+json"]');
+    getLdJson({name}={}) {
+        let selector = name
+            ? `script[type="application/ld+json"][data-schema-name="${name}"]`
+            : 'script[type="application/ld+json"]';
+
+        let script = document.head.querySelector(selector);
 
         if (script) {
             try {
@@ -150,16 +157,25 @@ class DocumentHead extends Base {
     }
 
     /**
-     * Creates or updates the ld+json script tag with new structured data.
+     * Creates or updates a ld+json script tag with new structured data.
+     * Can target a specific script tag by name.
      * @param {Object} data
+     * @param {String} [data.name] The value for the 'data-schema-name' attribute to select a specific script.
      * @param {Object} data.value The JavaScript object to be stringified and set as the script's content.
      */
-    setLdJson({value}) {
-        let script = document.head.querySelector('script[type="application/ld+json"]');
+    setLdJson({name, value}) {
+        let selector = name
+            ? `script[type="application/ld+json"][data-schema-name="${name}"]`
+            : 'script[type="application/ld+json"]';
+
+        let script = document.head.querySelector(selector);
 
         if (!script) {
             script = document.createElement('script');
             script.type = 'application/ld+json';
+            if (name) {
+                script.dataset.schemaName = name
+            }
             document.head.appendChild(script)
         }