docusaurus-plugin-glossary 3.1.0 → 3.3.0

package/dist/theme/GlossaryTerm/index.js

@@ -1,141 +1,107 @@
-import React, { useMemo, useState, useRef, useEffect, useCallback } from 'react';
-import { usePluginData } from '@docusaurus/useGlobalData';
-import styles from './styles.module.css';
-
-/**
- * GlossaryTerm component - displays an inline term with tooltip
- *
- * Usage:
- * import GlossaryTerm from '@theme/GlossaryTerm';
- *
- * <GlossaryTerm term="API" definition="Application Programming Interface" />
- * or
- * <GlossaryTerm term="API">custom display text</GlossaryTerm>
- *
- * @param {object} props
- * @param {string} props.term - The glossary term
- * @param {string} props.definition - The definition to show in tooltip
- * @param {string} props.routePath - Route path to glossary page (default: '/glossary')
- * @param {React.ReactNode} props.children - Optional custom display text
- */
-export default function GlossaryTerm({ term, definition, routePath = '/glossary', children }) {
+// src/theme/GlossaryTerm/index.js
+import React, { useMemo, useState, useRef, useEffect, useCallback } from "react";
+import { usePluginData } from "@docusaurus/useGlobalData";
+import styles from "../../styles.module-QQW7ISLV.module.css";
+import { jsx, jsxs } from "react/jsx-runtime";
+function GlossaryTerm({ term, definition, routePath = "/glossary", children }) {
   const [showTooltip, setShowTooltip] = useState(false);
   const [tooltipStyle, setTooltipStyle] = useState(null);
-  const [placement, setPlacement] = useState('top'); // 'top' | 'bottom'
+  const [placement, setPlacement] = useState("top");
   const wrapperRef = useRef(null);
   const tooltipRef = useRef(null);
-
   const updatePosition = useCallback(() => {
     if (!wrapperRef.current || !tooltipRef.current) return;
     const wrapperRect = wrapperRef.current.getBoundingClientRect();
     const tooltipRect = tooltipRef.current.getBoundingClientRect();
-
     const viewportWidth = window.innerWidth;
     const viewportHeight = window.innerHeight;
-
-    const preferredGap = 8; // px
-
-    // Decide top vs bottom based on available space
+    const preferredGap = 8;
     const hasSpaceAbove = wrapperRect.top >= tooltipRect.height + preferredGap;
     const hasSpaceBelow = viewportHeight - wrapperRect.bottom >= tooltipRect.height + preferredGap;
-    const nextPlacement = hasSpaceAbove || !hasSpaceBelow ? 'top' : 'bottom';
-
+    const nextPlacement = hasSpaceAbove || !hasSpaceBelow ? "top" : "bottom";
     let top;
-    if (nextPlacement === 'top') {
+    if (nextPlacement === "top") {
       top = wrapperRect.top - tooltipRect.height - preferredGap;
     } else {
       top = wrapperRect.bottom + preferredGap;
     }
-
-    // Center horizontally on the wrapper, then clamp within viewport with margin
     const horizontalMargin = 8;
     let left = wrapperRect.left + wrapperRect.width / 2 - tooltipRect.width / 2;
     left = Math.max(
       horizontalMargin,
       Math.min(left, viewportWidth - tooltipRect.width - horizontalMargin)
     );
-
     setPlacement(nextPlacement);
     setTooltipStyle({ top: Math.max(4, top), left });
   }, []);
-
   useEffect(() => {
     if (!showTooltip) return;
-
-    // Use double requestAnimationFrame to ensure DOM is fully rendered and layout is complete
-    // This ensures tooltipRef.current is available and has proper dimensions
     let rafId2;
     const rafId1 = requestAnimationFrame(() => {
       rafId2 = requestAnimationFrame(() => {
         updatePosition();
       });
     });
-
     const onScroll = () => updatePosition();
     const onResize = () => updatePosition();
-    window.addEventListener('scroll', onScroll, true);
-    window.addEventListener('resize', onResize);
+    window.addEventListener("scroll", onScroll, true);
+    window.addEventListener("resize", onResize);
     return () => {
       cancelAnimationFrame(rafId1);
       if (rafId2) cancelAnimationFrame(rafId2);
-      window.removeEventListener('scroll', onScroll, true);
-      window.removeEventListener('resize', onResize);
+      window.removeEventListener("scroll", onScroll, true);
+      window.removeEventListener("resize", onResize);
     };
   }, [showTooltip, updatePosition]);
-
-  // Pull definition/route from plugin global data if not provided
-  const pluginData = usePluginData('docusaurus-plugin-glossary');
+  const pluginData = usePluginData("docusaurus-plugin-glossary");
   const effectiveDefinition = useMemo(() => {
-    if (definition && typeof definition === 'string' && definition.length > 0) {
+    if (definition && typeof definition === "string" && definition.length > 0) {
       return definition;
     }
-    const terms = (pluginData && pluginData.terms) || [];
+    const terms = pluginData && pluginData.terms || [];
     const found = terms.find(
-      t => typeof t.term === 'string' && t.term.toLowerCase() === String(term).toLowerCase()
+      (t) => typeof t.term === "string" && t.term.toLowerCase() === String(term).toLowerCase()
     );
-    return found && found.definition ? found.definition : undefined;
+    return found && found.definition ? found.definition : void 0;
   }, [definition, pluginData, term]);
-
   const effectiveRoutePath = useMemo(() => {
-    if (routePath && typeof routePath === 'string' && routePath.length > 0) return routePath;
-    return (pluginData && pluginData.routePath) || '/glossary';
+    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 ref={wrapperRef} className={styles.glossaryTermWrapper}>
-      <a
-        href={`${effectiveRoutePath}#${termId}`}
-        className={styles.glossaryTerm}
-        onMouseEnter={() => setShowTooltip(true)}
-        onMouseLeave={() => setShowTooltip(false)}
-        onFocus={() => setShowTooltip(true)}
-        onBlur={() => setShowTooltip(false)}
-        aria-describedby={`tooltip-${termId}`}
-      >
-        {displayText}
-      </a>
-      {effectiveDefinition && (
-        <span
-          ref={tooltipRef}
-          id={`tooltip-${termId}`}
-          className={
-            `${styles.tooltip} ${showTooltip ? styles.tooltipVisible : ''} ` +
-            `${placement === 'top' ? styles.tooltipTop : styles.tooltipBottom} ` +
-            `${styles.tooltipFloating}`
-          }
-          role="tooltip"
-          style={
-            showTooltip && tooltipStyle
-              ? { top: `${tooltipStyle.top}px`, left: `${tooltipStyle.left}px` }
-              : undefined
-          }
-        >
-          <strong>{term}</strong> {effectiveDefinition}
-        </span>
-      )}
-    </span>
-  );
+  const termId = term.toLowerCase().replace(/\s+/g, "-");
+  return /* @__PURE__ */ jsxs("span", { ref: wrapperRef, className: styles.glossaryTermWrapper, children: [
+    /* @__PURE__ */ jsx(
+      "a",
+      {
+        href: `${effectiveRoutePath}#${termId}`,
+        className: styles.glossaryTerm,
+        onMouseEnter: () => setShowTooltip(true),
+        onMouseLeave: () => setShowTooltip(false),
+        onFocus: () => setShowTooltip(true),
+        onBlur: () => setShowTooltip(false),
+        "aria-describedby": `tooltip-${termId}`,
+        children: displayText
+      }
+    ),
+    effectiveDefinition && /* @__PURE__ */ jsxs(
+      "span",
+      {
+        ref: tooltipRef,
+        id: `tooltip-${termId}`,
+        className: `${styles.tooltip} ${showTooltip ? styles.tooltipVisible : ""} ${placement === "top" ? styles.tooltipTop : styles.tooltipBottom} ${styles.tooltipFloating}`,
+        role: "tooltip",
+        style: showTooltip && tooltipStyle ? { top: `${tooltipStyle.top}px`, left: `${tooltipStyle.left}px` } : void 0,
+        children: [
+          /* @__PURE__ */ jsx("strong", { children: term }),
+          " ",
+          effectiveDefinition
+        ]
+      }
+    )
+  ] });
 }
+export {
+  GlossaryTerm as default
+};
+//# sourceMappingURL=index.js.map

package/dist/theme/GlossaryTerm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/theme/GlossaryTerm/index.js"],"sourcesContent":["import React, { useMemo, useState, useRef, useEffect, useCallback } from 'react';\nimport { usePluginData } from '@docusaurus/useGlobalData';\nimport styles from './styles.module.css';\n\n/**\n * GlossaryTerm component - displays an inline term with tooltip\n *\n * Usage:\n * import GlossaryTerm from '@theme/GlossaryTerm';\n *\n * <GlossaryTerm term=\"API\" definition=\"Application Programming Interface\" />\n * or\n * <GlossaryTerm term=\"API\">custom display text</GlossaryTerm>\n *\n * @param {object} props\n * @param {string} props.term - The glossary term\n * @param {string} props.definition - The definition to show in tooltip\n * @param {string} props.routePath - Route path to glossary page (default: '/glossary')\n * @param {React.ReactNode} props.children - Optional custom display text\n */\nexport default function GlossaryTerm({ term, definition, routePath = '/glossary', children }) {\n  const [showTooltip, setShowTooltip] = useState(false);\n  const [tooltipStyle, setTooltipStyle] = useState(null);\n  const [placement, setPlacement] = useState('top'); // 'top' | 'bottom'\n  const wrapperRef = useRef(null);\n  const tooltipRef = useRef(null);\n\n  const updatePosition = useCallback(() => {\n    if (!wrapperRef.current || !tooltipRef.current) return;\n    const wrapperRect = wrapperRef.current.getBoundingClientRect();\n    const tooltipRect = tooltipRef.current.getBoundingClientRect();\n\n    const viewportWidth = window.innerWidth;\n    const viewportHeight = window.innerHeight;\n\n    const preferredGap = 8; // px\n\n    // Decide top vs bottom based on available space\n    const hasSpaceAbove = wrapperRect.top >= tooltipRect.height + preferredGap;\n    const hasSpaceBelow = viewportHeight - wrapperRect.bottom >= tooltipRect.height + preferredGap;\n    const nextPlacement = hasSpaceAbove || !hasSpaceBelow ? 'top' : 'bottom';\n\n    let top;\n    if (nextPlacement === 'top') {\n      top = wrapperRect.top - tooltipRect.height - preferredGap;\n    } else {\n      top = wrapperRect.bottom + preferredGap;\n    }\n\n    // Center horizontally on the wrapper, then clamp within viewport with margin\n    const horizontalMargin = 8;\n    let left = wrapperRect.left + wrapperRect.width / 2 - tooltipRect.width / 2;\n    left = Math.max(\n      horizontalMargin,\n      Math.min(left, viewportWidth - tooltipRect.width - horizontalMargin)\n    );\n\n    setPlacement(nextPlacement);\n    setTooltipStyle({ top: Math.max(4, top), left });\n  }, []);\n\n  useEffect(() => {\n    if (!showTooltip) return;\n\n    // Use double requestAnimationFrame to ensure DOM is fully rendered and layout is complete\n    // This ensures tooltipRef.current is available and has proper dimensions\n    let rafId2;\n    const rafId1 = requestAnimationFrame(() => {\n      rafId2 = requestAnimationFrame(() => {\n        updatePosition();\n      });\n    });\n\n    const onScroll = () => updatePosition();\n    const onResize = () => updatePosition();\n    window.addEventListener('scroll', onScroll, true);\n    window.addEventListener('resize', onResize);\n    return () => {\n      cancelAnimationFrame(rafId1);\n      if (rafId2) cancelAnimationFrame(rafId2);\n      window.removeEventListener('scroll', onScroll, true);\n      window.removeEventListener('resize', onResize);\n    };\n  }, [showTooltip, updatePosition]);\n\n  // Pull definition/route from plugin global data if not provided\n  const pluginData = usePluginData('docusaurus-plugin-glossary');\n  const effectiveDefinition = useMemo(() => {\n    if (definition && typeof definition === 'string' && definition.length > 0) {\n      return definition;\n    }\n    const terms = (pluginData && pluginData.terms) || [];\n    const found = terms.find(\n      t => typeof t.term === 'string' && t.term.toLowerCase() === String(term).toLowerCase()\n    );\n    return found && found.definition ? found.definition : undefined;\n  }, [definition, pluginData, term]);\n\n  const effectiveRoutePath = useMemo(() => {\n    if (routePath && typeof routePath === 'string' && routePath.length > 0) return routePath;\n    return (pluginData && pluginData.routePath) || '/glossary';\n  }, [pluginData, routePath]);\n\n  const displayText = children || term;\n  const termId = term.toLowerCase().replace(/\\s+/g, '-');\n\n  return (\n    <span ref={wrapperRef} className={styles.glossaryTermWrapper}>\n      <a\n        href={`${effectiveRoutePath}#${termId}`}\n        className={styles.glossaryTerm}\n        onMouseEnter={() => setShowTooltip(true)}\n        onMouseLeave={() => setShowTooltip(false)}\n        onFocus={() => setShowTooltip(true)}\n        onBlur={() => setShowTooltip(false)}\n        aria-describedby={`tooltip-${termId}`}\n      >\n        {displayText}\n      </a>\n      {effectiveDefinition && (\n        <span\n          ref={tooltipRef}\n          id={`tooltip-${termId}`}\n          className={\n            `${styles.tooltip} ${showTooltip ? styles.tooltipVisible : ''} ` +\n            `${placement === 'top' ? styles.tooltipTop : styles.tooltipBottom} ` +\n            `${styles.tooltipFloating}`\n          }\n          role=\"tooltip\"\n          style={\n            showTooltip && tooltipStyle\n              ? { top: `${tooltipStyle.top}px`, left: `${tooltipStyle.left}px` }\n              : undefined\n          }\n        >\n          <strong>{term}</strong> {effectiveDefinition}\n        </span>\n      )}\n    </span>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/validation.cjs

@@ -0,0 +1,283 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/validation.ts
+var validation_exports = {};
+__export(validation_exports, {
+  GlossaryValidationError: () => GlossaryValidationError,
+  formatValidationErrors: () => formatValidationErrors,
+  validateGlossaryData: () => validateGlossaryData
+});
+module.exports = __toCommonJS(validation_exports);
+function validateTerm(term, index) {
+  const errors = [];
+  const prefix = `terms[${index}]`;
+  if (term === null || term === void 0) {
+    errors.push({
+      field: prefix,
+      message: "Term cannot be null or undefined",
+      value: term
+    });
+    return errors;
+  }
+  if (typeof term !== "object") {
+    errors.push({
+      field: prefix,
+      message: `Term must be an object, got ${typeof term}`,
+      value: term
+    });
+    return errors;
+  }
+  const termObj = term;
+  if (!("term" in termObj)) {
+    errors.push({
+      field: `${prefix}.term`,
+      message: 'Missing required field "term"'
+    });
+  } else if (typeof termObj.term !== "string") {
+    errors.push({
+      field: `${prefix}.term`,
+      message: `Field "term" must be a string, got ${typeof termObj.term}`,
+      value: termObj.term
+    });
+  } else if (termObj.term.trim() === "") {
+    errors.push({
+      field: `${prefix}.term`,
+      message: 'Field "term" cannot be empty',
+      value: termObj.term
+    });
+  }
+  if (!("definition" in termObj)) {
+    errors.push({
+      field: `${prefix}.definition`,
+      message: 'Missing required field "definition"'
+    });
+  } else if (typeof termObj.definition !== "string") {
+    errors.push({
+      field: `${prefix}.definition`,
+      message: `Field "definition" must be a string, got ${typeof termObj.definition}`,
+      value: termObj.definition
+    });
+  }
+  if ("abbreviation" in termObj && termObj.abbreviation !== void 0) {
+    if (typeof termObj.abbreviation !== "string") {
+      errors.push({
+        field: `${prefix}.abbreviation`,
+        message: `Field "abbreviation" must be a string, got ${typeof termObj.abbreviation}`,
+        value: termObj.abbreviation
+      });
+    }
+  }
+  if ("relatedTerms" in termObj && termObj.relatedTerms !== void 0) {
+    if (!Array.isArray(termObj.relatedTerms)) {
+      errors.push({
+        field: `${prefix}.relatedTerms`,
+        message: `Field "relatedTerms" must be an array, got ${typeof termObj.relatedTerms}`,
+        value: termObj.relatedTerms
+      });
+    } else {
+      termObj.relatedTerms.forEach((relatedTerm, relatedIndex) => {
+        if (typeof relatedTerm !== "string") {
+          errors.push({
+            field: `${prefix}.relatedTerms[${relatedIndex}]`,
+            message: `Related term must be a string, got ${typeof relatedTerm}`,
+            value: relatedTerm
+          });
+        }
+      });
+    }
+  }
+  if ("id" in termObj && termObj.id !== void 0) {
+    if (typeof termObj.id !== "string") {
+      errors.push({
+        field: `${prefix}.id`,
+        message: `Field "id" must be a string, got ${typeof termObj.id}`,
+        value: termObj.id
+      });
+    }
+  }
+  if ("autoLink" in termObj && termObj.autoLink !== void 0) {
+    if (typeof termObj.autoLink !== "boolean") {
+      errors.push({
+        field: `${prefix}.autoLink`,
+        message: `Field "autoLink" must be a boolean, got ${typeof termObj.autoLink}`,
+        value: termObj.autoLink
+      });
+    }
+  }
+  if ("aliases" in termObj && termObj.aliases !== void 0) {
+    if (!Array.isArray(termObj.aliases)) {
+      errors.push({
+        field: `${prefix}.aliases`,
+        message: `Field "aliases" must be an array, got ${typeof termObj.aliases}`,
+        value: termObj.aliases
+      });
+    } else {
+      termObj.aliases.forEach((alias, aliasIndex) => {
+        if (typeof alias !== "string") {
+          errors.push({
+            field: `${prefix}.aliases[${aliasIndex}]`,
+            message: `Alias must be a string, got ${typeof alias}`,
+            value: alias
+          });
+        } else if (alias.trim() === "") {
+          errors.push({
+            field: `${prefix}.aliases[${aliasIndex}]`,
+            message: "Alias cannot be empty",
+            value: alias
+          });
+        }
+      });
+    }
+  }
+  return errors;
+}
+function validateGlossaryData(data, options = {}) {
+  const { throwOnError = true } = options;
+  const errors = [];
+  if (data === null || data === void 0) {
+    errors.push({
+      field: "root",
+      message: "Glossary data cannot be null or undefined",
+      value: data
+    });
+    if (throwOnError && errors.length > 0) {
+      throw new GlossaryValidationError(errors);
+    }
+    return { valid: false, errors, data: { terms: [] } };
+  }
+  if (typeof data !== "object") {
+    errors.push({
+      field: "root",
+      message: `Glossary data must be an object, got ${typeof data}`,
+      value: data
+    });
+    if (throwOnError && errors.length > 0) {
+      throw new GlossaryValidationError(errors);
+    }
+    return { valid: false, errors, data: { terms: [] } };
+  }
+  const glossaryData = data;
+  if ("title" in glossaryData && typeof glossaryData.title !== "string") {
+    errors.push({
+      field: "title",
+      message: "The title property in the GlossaryData must be a string."
+    });
+    if (throwOnError && errors.length > 0) {
+      throw new GlossaryValidationError(errors);
+    }
+  }
+  const validTitle = glossaryData.title;
+  if ("description" in glossaryData && typeof glossaryData.description !== "string") {
+    errors.push({
+      field: "description",
+      message: "The description property in the GlossaryData must be a string."
+    });
+    if (throwOnError && errors.length > 0) {
+      throw new GlossaryValidationError(errors);
+    }
+  }
+  const validDescription = glossaryData.description;
+  if (!("terms" in glossaryData)) {
+    errors.push({
+      field: "terms",
+      message: 'Glossary data must contain a "terms" array'
+    });
+    if (throwOnError && errors.length > 0) {
+      throw new GlossaryValidationError(errors);
+    }
+    return { valid: false, errors, data: { terms: [] } };
+  }
+  if (!Array.isArray(glossaryData.terms)) {
+    errors.push({
+      field: "terms",
+      message: `Field "terms" must be an array, got ${typeof glossaryData.terms}`,
+      value: glossaryData.terms
+    });
+    if (throwOnError && errors.length > 0) {
+      throw new GlossaryValidationError(errors);
+    }
+    return { valid: false, errors, data: { terms: [] } };
+  }
+  const validTerms = [];
+  glossaryData.terms.forEach((term, index) => {
+    const termErrors = validateTerm(term, index);
+    if (termErrors.length > 0) {
+      errors.push(...termErrors);
+    } else {
+      validTerms.push(term);
+    }
+  });
+  const termNames = /* @__PURE__ */ new Map();
+  validTerms.forEach((term, index) => {
+    const lowerName = term.term.toLowerCase();
+    if (termNames.has(lowerName)) {
+      errors.push({
+        field: `terms[${index}].term`,
+        message: `Duplicate term "${term.term}" (first occurrence at index ${termNames.get(lowerName)})`,
+        value: term.term
+      });
+    } else {
+      termNames.set(lowerName, index);
+    }
+  });
+  if (throwOnError && errors.length > 0) {
+    throw new GlossaryValidationError(errors);
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    data: { title: validTitle, description: validDescription, terms: validTerms }
+  };
+}
+var GlossaryValidationError = class _GlossaryValidationError extends Error {
+  constructor(errors) {
+    const message = formatValidationErrors(errors);
+    super(message);
+    this.name = "GlossaryValidationError";
+    this.errors = errors;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _GlossaryValidationError);
+    }
+  }
+};
+function formatValidationErrors(errors) {
+  if (errors.length === 0) {
+    return "No validation errors";
+  }
+  const header = `Glossary validation failed with ${errors.length} error${errors.length > 1 ? "s" : ""}:`;
+  const errorList = errors.map((err, index) => {
+    let msg = `  ${index + 1}. [${err.field}] ${err.message}`;
+    if (err.value !== void 0) {
+      const valueStr = typeof err.value === "object" ? JSON.stringify(err.value) : String(err.value);
+      const truncated = valueStr.length > 50 ? valueStr.substring(0, 50) + "..." : valueStr;
+      msg += ` (got: ${truncated})`;
+    }
+    return msg;
+  }).join("\n");
+  return `${header}
+${errorList}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GlossaryValidationError,
+  formatValidationErrors,
+  validateGlossaryData
+});
+//# sourceMappingURL=validation.cjs.map

package/dist/validation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation.ts"],"sourcesContent":["import type { GlossaryData, GlossaryTerm } from './index.js';\n\nexport interface ValidationError {\n  field: string;\n  message: string;\n  value?: unknown;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: ValidationError[];\n  data: GlossaryData;\n}\n\n/**\n * Validates a single glossary term object\n *\n * @param term - The term object to validate\n * @param index - The index in the terms array (for error messages)\n * @returns Array of validation errors (empty if valid)\n */\nfunction validateTerm(term: unknown, index: number): ValidationError[] {\n  const errors: ValidationError[] = [];\n  const prefix = `terms[${index}]`;\n\n  if (term === null || term === undefined) {\n    errors.push({\n      field: prefix,\n      message: 'Term cannot be null or undefined',\n      value: term,\n    });\n    return errors;\n  }\n\n  if (typeof term !== 'object') {\n    errors.push({\n      field: prefix,\n      message: `Term must be an object, got ${typeof term}`,\n      value: term,\n    });\n    return errors;\n  }\n\n  const termObj = term as Record<string, unknown>;\n\n  // Required: term (string)\n  if (!('term' in termObj)) {\n    errors.push({\n      field: `${prefix}.term`,\n      message: 'Missing required field \"term\"',\n    });\n  } else if (typeof termObj.term !== 'string') {\n    errors.push({\n      field: `${prefix}.term`,\n      message: `Field \"term\" must be a string, got ${typeof termObj.term}`,\n      value: termObj.term,\n    });\n  } else if (termObj.term.trim() === '') {\n    errors.push({\n      field: `${prefix}.term`,\n      message: 'Field \"term\" cannot be empty',\n      value: termObj.term,\n    });\n  }\n\n  // Required: definition (string)\n  if (!('definition' in termObj)) {\n    errors.push({\n      field: `${prefix}.definition`,\n      message: 'Missing required field \"definition\"',\n    });\n  } else if (typeof termObj.definition !== 'string') {\n    errors.push({\n      field: `${prefix}.definition`,\n      message: `Field \"definition\" must be a string, got ${typeof termObj.definition}`,\n      value: termObj.definition,\n    });\n  }\n\n  // Optional: abbreviation (string)\n  if ('abbreviation' in termObj && termObj.abbreviation !== undefined) {\n    if (typeof termObj.abbreviation !== 'string') {\n      errors.push({\n        field: `${prefix}.abbreviation`,\n        message: `Field \"abbreviation\" must be a string, got ${typeof termObj.abbreviation}`,\n        value: termObj.abbreviation,\n      });\n    }\n  }\n\n  // Optional: relatedTerms (string[])\n  if ('relatedTerms' in termObj && termObj.relatedTerms !== undefined) {\n    if (!Array.isArray(termObj.relatedTerms)) {\n      errors.push({\n        field: `${prefix}.relatedTerms`,\n        message: `Field \"relatedTerms\" must be an array, got ${typeof termObj.relatedTerms}`,\n        value: termObj.relatedTerms,\n      });\n    } else {\n      termObj.relatedTerms.forEach((relatedTerm, relatedIndex) => {\n        if (typeof relatedTerm !== 'string') {\n          errors.push({\n            field: `${prefix}.relatedTerms[${relatedIndex}]`,\n            message: `Related term must be a string, got ${typeof relatedTerm}`,\n            value: relatedTerm,\n          });\n        }\n      });\n    }\n  }\n\n  // Optional: id (string)\n  if ('id' in termObj && termObj.id !== undefined) {\n    if (typeof termObj.id !== 'string') {\n      errors.push({\n        field: `${prefix}.id`,\n        message: `Field \"id\" must be a string, got ${typeof termObj.id}`,\n        value: termObj.id,\n      });\n    }\n  }\n\n  // Optional: autoLink (boolean)\n  if ('autoLink' in termObj && termObj.autoLink !== undefined) {\n    if (typeof termObj.autoLink !== 'boolean') {\n      errors.push({\n        field: `${prefix}.autoLink`,\n        message: `Field \"autoLink\" must be a boolean, got ${typeof termObj.autoLink}`,\n        value: termObj.autoLink,\n      });\n    }\n  }\n\n  // Optional: aliases (string[])\n  if ('aliases' in termObj && termObj.aliases !== undefined) {\n    if (!Array.isArray(termObj.aliases)) {\n      errors.push({\n        field: `${prefix}.aliases`,\n        message: `Field \"aliases\" must be an array, got ${typeof termObj.aliases}`,\n        value: termObj.aliases,\n      });\n    } else {\n      termObj.aliases.forEach((alias, aliasIndex) => {\n        if (typeof alias !== 'string') {\n          errors.push({\n            field: `${prefix}.aliases[${aliasIndex}]`,\n            message: `Alias must be a string, got ${typeof alias}`,\n            value: alias,\n          });\n        } else if (alias.trim() === '') {\n          errors.push({\n            field: `${prefix}.aliases[${aliasIndex}]`,\n            message: 'Alias cannot be empty',\n            value: alias,\n          });\n        }\n      });\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Validates glossary data structure\n *\n * Ensures the glossary data conforms to the expected schema:\n * - Must be an object with a \"terms\" array\n * - Each term must have \"term\" (string) and \"definition\" (string)\n * - Optional fields: abbreviation (string), relatedTerms (string[]), id (string)\n *\n * @param data - The data to validate\n * @param options - Validation options\n * @param options.throwOnError - If true, throws an error on validation failure (default: true)\n * @returns Validation result with errors and sanitized data\n * @throws Error if data is invalid and throwOnError is true\n */\nexport function validateGlossaryData(\n  data: unknown,\n  options: { throwOnError?: boolean } = {}\n): ValidationResult {\n  const { throwOnError = true } = options;\n  const errors: ValidationError[] = [];\n\n  // Check if data is null or undefined\n  if (data === null || data === undefined) {\n    errors.push({\n      field: 'root',\n      message: 'Glossary data cannot be null or undefined',\n      value: data,\n    });\n\n    if (throwOnError && errors.length > 0) {\n      throw new GlossaryValidationError(errors);\n    }\n\n    return { valid: false, errors, data: { terms: [] } };\n  }\n\n  // Check if data is an object\n  if (typeof data !== 'object') {\n    errors.push({\n      field: 'root',\n      message: `Glossary data must be an object, got ${typeof data}`,\n      value: data,\n    });\n\n    if (throwOnError && errors.length > 0) {\n      throw new GlossaryValidationError(errors);\n    }\n\n    return { valid: false, errors, data: { terms: [] } };\n  }\n\n  const glossaryData = data as Record<string, unknown>;\n\n  //Check for title\n  if ('title' in glossaryData && typeof glossaryData.title !== 'string') {\n    errors.push({\n      field: 'title',\n      message: 'The title property in the GlossaryData must be a string.',\n    });\n\n    if (throwOnError && errors.length > 0) {\n      throw new GlossaryValidationError(errors);\n    }\n  }\n  const validTitle = glossaryData.title as string;\n\n  if ('description' in glossaryData && typeof glossaryData.description !== 'string') {\n    errors.push({\n      field: 'description',\n      message: 'The description property in the GlossaryData must be a string.',\n    });\n\n    if (throwOnError && errors.length > 0) {\n      throw new GlossaryValidationError(errors);\n    }\n  }\n\n  const validDescription = glossaryData.description as string;\n\n  if (!('terms' in glossaryData)) {\n    // Check for terms array\n    errors.push({\n      field: 'terms',\n      message: 'Glossary data must contain a \"terms\" array',\n    });\n\n    if (throwOnError && errors.length > 0) {\n      throw new GlossaryValidationError(errors);\n    }\n\n    return { valid: false, errors, data: { terms: [] } };\n  }\n\n  if (!Array.isArray(glossaryData.terms)) {\n    errors.push({\n      field: 'terms',\n      message: `Field \"terms\" must be an array, got ${typeof glossaryData.terms}`,\n      value: glossaryData.terms,\n    });\n\n    if (throwOnError && errors.length > 0) {\n      throw new GlossaryValidationError(errors);\n    }\n\n    return { valid: false, errors, data: { terms: [] } };\n  }\n\n  // Validate each term\n  const validTerms: GlossaryTerm[] = [];\n  glossaryData.terms.forEach((term, index) => {\n    const termErrors = validateTerm(term, index);\n    if (termErrors.length > 0) {\n      errors.push(...termErrors);\n    } else {\n      // Term is valid, add to valid terms\n      validTerms.push(term as GlossaryTerm);\n    }\n  });\n\n  // Check for duplicate terms\n  const termNames = new Map<string, number>();\n  validTerms.forEach((term, index) => {\n    const lowerName = term.term.toLowerCase();\n    if (termNames.has(lowerName)) {\n      errors.push({\n        field: `terms[${index}].term`,\n        message: `Duplicate term \"${term.term}\" (first occurrence at index ${termNames.get(lowerName)})`,\n        value: term.term,\n      });\n    } else {\n      termNames.set(lowerName, index);\n    }\n  });\n\n  if (throwOnError && errors.length > 0) {\n    throw new GlossaryValidationError(errors);\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    data: { title: validTitle, description: validDescription, terms: validTerms },\n  };\n}\n\n/**\n * Custom error class for glossary validation errors\n * Provides detailed error messages for debugging\n */\nexport class GlossaryValidationError extends Error {\n  public readonly errors: ValidationError[];\n\n  constructor(errors: ValidationError[]) {\n    const message = formatValidationErrors(errors);\n    super(message);\n    this.name = 'GlossaryValidationError';\n    this.errors = errors;\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    // @ts-ignore\n    if (Error.captureStackTrace) {\n      // @ts-ignore\n      Error.captureStackTrace(this, GlossaryValidationError);\n    }\n  }\n}\n\n/**\n * Formats validation errors into a readable string\n *\n * @param errors - Array of validation errors\n * @returns Formatted error message\n */\nexport function formatValidationErrors(errors: ValidationError[]): string {\n  if (errors.length === 0) {\n    return 'No validation errors';\n  }\n\n  const header = `Glossary validation failed with ${errors.length} error${errors.length > 1 ? 's' : ''}:`;\n  const errorList = errors\n    .map((err, index) => {\n      let msg = `  ${index + 1}. [${err.field}] ${err.message}`;\n      if (err.value !== undefined) {\n        const valueStr =\n          typeof err.value === 'object' ? JSON.stringify(err.value) : String(err.value);\n        // Truncate long values\n        const truncated = valueStr.length > 50 ? valueStr.substring(0, 50) + '...' : valueStr;\n        msg += ` (got: ${truncated})`;\n      }\n      return msg;\n    })\n    .join('\\n');\n\n  return `${header}\\n${errorList}`;\n}\n"],"mappings":"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","names":[]}

package/dist/validation.d.cts

@@ -0,0 +1,2 @@
+export { GlossaryValidationError, ValidationError, ValidationResult, formatValidationErrors, validateGlossaryData } from './index.cjs';
+import '@docusaurus/types';

package/dist/validation.d.ts

@@ -1,44 +1,2 @@
-import type { GlossaryData } from './index.js';
-export interface ValidationError {
-    field: string;
-    message: string;
-    value?: unknown;
-}
-export interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-    data: GlossaryData;
-}
-/**
- * Validates glossary data structure
- *
- * Ensures the glossary data conforms to the expected schema:
- * - Must be an object with a "terms" array
- * - Each term must have "term" (string) and "definition" (string)
- * - Optional fields: abbreviation (string), relatedTerms (string[]), id (string)
- *
- * @param data - The data to validate
- * @param options - Validation options
- * @param options.throwOnError - If true, throws an error on validation failure (default: true)
- * @returns Validation result with errors and sanitized data
- * @throws Error if data is invalid and throwOnError is true
- */
-export declare function validateGlossaryData(data: unknown, options?: {
-    throwOnError?: boolean;
-}): ValidationResult;
-/**
- * Custom error class for glossary validation errors
- * Provides detailed error messages for debugging
- */
-export declare class GlossaryValidationError extends Error {
-    readonly errors: ValidationError[];
-    constructor(errors: ValidationError[]);
-}
-/**
- * Formats validation errors into a readable string
- *
- * @param errors - Array of validation errors
- * @returns Formatted error message
- */
-export declare function formatValidationErrors(errors: ValidationError[]): string;
-//# sourceMappingURL=validation.d.ts.map
+export { GlossaryValidationError, ValidationError, ValidationResult, formatValidationErrors, validateGlossaryData } from './index.js';
+import '@docusaurus/types';