@stackql/docusaurus-plugin-aeo 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.2
+
+Fix: cross-plugin loaded content was not captured because contentLoaded does not receive allContent in Docusaurus 3.x. Use allContentLoaded hook. Without this fix, feature 1 (.md companions) emitted zero files and feature 2 (llms.txt / llms-full.txt) was empty.
+
 ## 0.1.1
 
 Bugfix release. v0.1.0 failed to build on a real Docusaurus 3.10 consumer with three distinct crashes; all three are fixed here.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackql/docusaurus-plugin-aeo",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "AEO (Answer Engine Optimization) helpers for Docusaurus: .md companion files, llms.txt / llms-full.txt, an Ask AI dropdown, and /ai/* route conventions.",
   "main": "src/index.js",
   "exports": {

package/src/index.js

@@ -119,9 +119,27 @@ module.exports = function pluginAeo(context, rawOptions) {
   const plugin = {
     name: '@stackql/docusaurus-plugin-aeo',
 
-    // Surface the askAi config to theme components via a global data
-    // injection. Docusaurus client code can read this through useDocusaurusContext().
-    async contentLoaded({ actions, allContent }) {
+    // Surface the askAi config to theme components. setGlobalData MUST be
+    // called from contentLoaded - Docusaurus does not accept it from
+    // allContentLoaded, and theme components read it via
+    // usePluginData('@stackql/docusaurus-plugin-aeo') at render time.
+    async contentLoaded({ actions }) {
+      await actions.setGlobalData({
+        askAi: {
+          enabled: options.askAi.enabled,
+          providerOrder: options.askAi.providerOrder,
+          promptTemplate: options.askAi.promptTemplate,
+          placement: options.askAi.placement,
+          companionsEnabled: options.companions.enabled,
+        },
+      });
+    },
+
+    // Cross-plugin loaded content (docs, blog, pages) is only delivered to
+    // allContentLoaded in Docusaurus 3.x. contentLoaded receives only the
+    // current plugin's own content, so feature 1 needs this hook to see
+    // the docs/blog source files it has to mirror.
+    async allContentLoaded({ allContent }) {
       if (allContent) {
         for (const [pluginName, byId] of Object.entries(allContent)) {
           if (!byId) continue;
@@ -135,16 +153,6 @@ module.exports = function pluginAeo(context, rawOptions) {
         }
       }
 
-      await actions.setGlobalData({
-        askAi: {
-          enabled: options.askAi.enabled,
-          providerOrder: options.askAi.providerOrder,
-          promptTemplate: options.askAi.promptTemplate,
-          placement: options.askAi.placement,
-          companionsEnabled: options.companions.enabled,
-        },
-      });
-
       if (options.aiRoutes.validate) {
         validateAiRoutes({
           loadedContentByPlugin,