docusaurus-plugin-glossary 1.1.0 → 1.1.2

package/index.js

@@ -81,7 +81,7 @@ function glossaryPlugin(context, options = {}) {
     },
 
     async contentLoaded({ content, actions }) {
-      const { createData, addRoute } = actions;
+      const { createData, addRoute, setGlobalData } = actions;
 
       // Create data file that can be imported by components
       const glossaryDataPath = await createData('glossary-data.json', JSON.stringify(content));
@@ -104,6 +104,12 @@ function glossaryPlugin(context, options = {}) {
           glossaryData: glossaryDataPath,
         },
       });
+
+      // Expose global data for runtime lookups (used by GlossaryTerm)
+      setGlobalData({
+        terms: content.terms || [],
+        routePath,
+      });
     },
 
     getThemePath() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-plugin-glossary",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "A Docusaurus plugin for creating and managing glossary terms with auto-generated pages and inline tooltips",
   "main": "index.js",
   "files": [
@@ -15,6 +15,9 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
+    "example:start": "npm --prefix examples/docusaurus-v3 run start",
+    "example:build": "npm --prefix examples/docusaurus-v3 run build",
+    "example:serve": "npm --prefix examples/docusaurus-v3 run serve",
     "prepublishOnly": "npm test",
     "version": "npm version",
     "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,css,md}\"",

package/theme/GlossaryTerm/index.js

@@ -1,4 +1,5 @@
-import React, { useState } from 'react';
+import React, { useMemo, useState } from 'react';
+import {usePluginData} from '@docusaurus/useGlobalData';
 import styles from './styles.module.css';
 
 /**
@@ -20,13 +21,31 @@ import styles from './styles.module.css';
 export default function GlossaryTerm({ term, definition, routePath = '/glossary', children }) {
   const [showTooltip, setShowTooltip] = useState(false);
 
+  // Pull definition/route from plugin global data if not provided
+  const pluginData = usePluginData('docusaurus-plugin-glossary');
+  const effectiveDefinition = useMemo(() => {
+    if (definition && typeof definition === 'string' && definition.length > 0) {
+      return definition;
+    }
+    const terms = (pluginData && pluginData.terms) || [];
+    const found = terms.find(
+      (t) => typeof t.term === 'string' && t.term.toLowerCase() === String(term).toLowerCase()
+    );
+    return found && found.definition ? found.definition : undefined;
+  }, [definition, pluginData, term]);
+
+  const effectiveRoutePath = useMemo(() => {
+    if (routePath && typeof routePath === 'string' && routePath.length > 0) return routePath;
+    return (pluginData && pluginData.routePath) || '/glossary';
+  }, [pluginData, routePath]);
+
   const displayText = children || term;
   const termId = term.toLowerCase().replace(/\s+/g, '-');
 
   return (
     <span className={styles.glossaryTermWrapper}>
       <a
-        href={`${routePath}#${termId}`}
+        href={`${effectiveRoutePath}#${termId}`}
         className={styles.glossaryTerm}
         onMouseEnter={() => setShowTooltip(true)}
         onMouseLeave={() => setShowTooltip(false)}
@@ -36,13 +55,13 @@ export default function GlossaryTerm({ term, definition, routePath = '/glossary'
       >
         {displayText}
       </a>
-      {definition && (
+      {effectiveDefinition && (
         <span
           id={`tooltip-${termId}`}
           className={`${styles.tooltip} ${showTooltip ? styles.tooltipVisible : ''}`}
           role="tooltip"
         >
-          <strong>{term}:</strong> {definition}
+          <strong>{term}:</strong> {effectiveDefinition}
         </span>
       )}
     </span>