docusaurus-plugin-glossary 3.1.0 → 3.3.0

package/README.md

@@ -63,6 +63,7 @@ A comprehensive Docusaurus plugin that provides glossary functionality with an a
 
    ```json
    {
+     "title": "Glossary",
      "description": "A collection of technical terms and their definitions",
      "terms": [
        {
@@ -108,6 +109,7 @@ Create a JSON file at `glossary/glossary.json` (or your configured path) in your
 
 ```json
 {
+  "title": "Glossary",
   "description": "A collection of technical terms and their definitions",
   "terms": [
     {
@@ -136,6 +138,8 @@ Create a JSON file at `glossary/glossary.json` (or your configured path) in your
 - `abbreviation` (string): The full form if the term is an abbreviation
 - `relatedTerms` (string[]): Array of related term names that link to other glossary entries
 - `id` (string): Custom ID for linking (auto-generated from term name if not provided)
+- `autoLink` (boolean): Set to `false` to opt a term out of automatic linking (default: `true`)
+- `aliases` (string[]): Additional phrases that should also auto-link to this term. Useful for inflections (e.g. `["cleaning", "cleaned"]` for `clean`) or alternate forms. The rendered link and tooltip always use the canonical `term`
 
 ### Step 2: Configure the Plugin
 
@@ -455,6 +459,7 @@ See the [Usage Guide](#usage-guide) section above for complete examples. Here ar
 
 ```json
 {
+  "title": "Glossary",
   "description": "Technical terms used in our documentation",
   "terms": [
     {

package/dist/chunk-22LFZL7L.js

@@ -0,0 +1,109 @@
+import {
+  GlossaryValidationError,
+  validateGlossaryData
+} from "./chunk-7Z37JEHW.js";
+import {
+  remarkGlossaryTerms
+} from "./chunk-WYKSBP3X.js";
+
+// src/index.ts
+import path from "path";
+import { fileURLToPath } from "url";
+import fs from "fs-extra";
+import validatePeerDependencies from "validate-peer-dependencies";
+var currentFilePath = fileURLToPath(import.meta.url);
+var currentDir = path.dirname(currentFilePath);
+validatePeerDependencies(currentDir);
+function glossaryPlugin(context, options = {}) {
+  const { glossaryPath = "glossary/glossary.json", routePath = "/glossary" } = options;
+  return {
+    name: "docusaurus-plugin-glossary",
+    getClientModules() {
+      return [path.resolve(currentDir, "./client/index.js")];
+    },
+    async loadContent() {
+      const glossaryFilePath = path.resolve(context.siteDir, glossaryPath);
+      if (await fs.pathExists(glossaryFilePath)) {
+        try {
+          const rawData = await fs.readJson(glossaryFilePath);
+          const validationResult = validateGlossaryData(rawData, { throwOnError: false });
+          if (!validationResult.valid) {
+            console.warn(
+              `[glossary-plugin] Glossary file has validation errors at ${glossaryFilePath}:`
+            );
+            validationResult.errors.forEach((err) => {
+              console.warn(`  - [${err.field}] ${err.message}`);
+            });
+            console.warn("[glossary-plugin] Proceeding with valid terms only.");
+          }
+          return validationResult.data;
+        } catch (error) {
+          if (error instanceof GlossaryValidationError) {
+            throw error;
+          }
+          throw new Error(
+            `Failed to parse glossary file at ${glossaryFilePath}: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      }
+      console.warn(`Glossary file not found at ${glossaryFilePath}. Using empty glossary.`);
+      return { terms: [] };
+    },
+    async contentLoaded({ content, actions }) {
+      const { createData, addRoute, setGlobalData } = actions;
+      const glossaryContent = content;
+      const glossaryDataPath = await createData(
+        "glossary-data.json",
+        JSON.stringify(glossaryContent)
+      );
+      await createData(
+        "remark-glossary-data.json",
+        JSON.stringify({
+          terms: glossaryContent.terms || [],
+          routePath
+        })
+      );
+      addRoute({
+        path: routePath,
+        component: path.join(currentDir, "components/GlossaryPage.js"),
+        exact: true,
+        modules: {
+          glossaryData: glossaryDataPath
+        }
+      });
+      setGlobalData({
+        terms: glossaryContent.terms || [],
+        routePath
+      });
+    },
+    getThemePath() {
+      return path.resolve(currentDir, "./theme");
+    },
+    getPathsToWatch() {
+      return [path.resolve(context.siteDir, glossaryPath)];
+    },
+    async postBuild() {
+      console.log("Glossary plugin: Build completed");
+    }
+  };
+}
+var remarkPlugin = remarkGlossaryTerms;
+function getRemarkPlugin(pluginOptions, context) {
+  const { glossaryPath = "glossary/glossary.json", routePath = "/glossary" } = pluginOptions;
+  const siteDir = context?.siteDir;
+  return [
+    remarkGlossaryTerms,
+    {
+      glossaryPath,
+      routePath,
+      siteDir
+    }
+  ];
+}
+
+export {
+  glossaryPlugin,
+  remarkPlugin,
+  getRemarkPlugin
+};
+//# sourceMappingURL=chunk-22LFZL7L.js.map

package/dist/chunk-22LFZL7L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @ts-ignore\nimport path from 'path';\n// @ts-ignore\nimport { fileURLToPath } from 'url';\nimport fs from 'fs-extra';\nimport type { LoadContext, Plugin } from '@docusaurus/types';\nimport validatePeerDependencies from 'validate-peer-dependencies';\nimport remarkGlossaryTerms from './remark/glossary-terms.js';\nimport { validateGlossaryData, GlossaryValidationError } from './validation.js';\n\n// Standard ES module directory resolution\nconst currentFilePath = fileURLToPath(import.meta.url);\nconst currentDir = path.dirname(currentFilePath);\n\n// Validate peer dependencies at module load time\nvalidatePeerDependencies(currentDir);\n\nexport interface GlossaryPluginOptions {\n  glossaryPath?: string;\n  routePath?: string;\n  autoLinkTerms?: boolean;\n}\n\nexport interface GlossaryTerm {\n  term: string;\n  definition: string;\n  abbreviation?: string;\n  relatedTerms?: string[];\n  id?: string;\n  autoLink?: boolean;\n  aliases?: string[];\n}\n\nexport interface GlossaryData {\n  title?: string;\n  description?: string;\n  terms: GlossaryTerm[];\n}\n\n/**\n * Docusaurus Glossary Plugin\n *\n * A plugin that provides glossary functionality with:\n * - Glossary terms defined in a JSON file\n * - Auto-generated glossary page with term definitions\n * - GlossaryTerm component for inline definitions with interactive tooltips\n * - Automatic client-side initialization via getClientModules() (no manual imports needed)\n * - Optional automatic glossary term detection in markdown files via remark plugin\n *\n * ## Basic Usage (Manual Term Markup)\n *\n * Just install the plugin - the GlossaryTerm component is automatically available:\n * ```javascript\n * module.exports = {\n *   plugins: [\n *     ['docusaurus-plugin-glossary', {\n *       glossaryPath: 'glossary/glossary.json',\n *       routePath: '/glossary',\n *     }],\n *   ],\n * };\n * ```\n *\n * Then use `<GlossaryTerm>` in your MDX files without importing:\n * ```mdx\n * <GlossaryTerm term=\"API\">API</GlossaryTerm>\n * ```\n *\n * ## Advanced Usage (Automatic Term Detection)\n *\n * To automatically detect and link glossary terms in markdown, add the remark plugin:\n * ```javascript\n * const glossaryPlugin = require('docusaurus-plugin-glossary');\n *\n * module.exports = {\n *   presets: [\n *     ['@docusaurus/preset-classic', {\n *       docs: {\n *         remarkPlugins: [\n *           glossaryPlugin.getRemarkPlugin({\n *             glossaryPath: 'glossary/glossary.json',\n *             routePath: '/glossary',\n *           }, { siteDir: __dirname }),\n *         ],\n *       },\n *     }],\n *   ],\n *   plugins: [\n *     ['docusaurus-plugin-glossary', {\n *       glossaryPath: 'glossary/glossary.json',\n *       routePath: '/glossary',\n *     }],\n *   ],\n * };\n * ```\n *\n * @param context - Docusaurus context\n * @param options - Plugin options\n * @param options.glossaryPath - Path to glossary JSON file (default: 'glossary/glossary.json')\n * @param options.routePath - Route path for glossary page (default: '/glossary')\n * @param options.autoLinkTerms - Legacy option, kept for compatibility but no longer used (configure remark plugin manually instead)\n * @returns Plugin object\n */\nexport default function glossaryPlugin(\n  context: LoadContext,\n  options: GlossaryPluginOptions = {}\n): Plugin {\n  const { glossaryPath = 'glossary/glossary.json', routePath = '/glossary' } = options;\n\n  return {\n    name: 'docusaurus-plugin-glossary',\n\n    getClientModules() {\n      return [path.resolve(currentDir, './client/index.js')];\n    },\n\n    async loadContent() {\n      // Load glossary terms from JSON file\n      const glossaryFilePath = path.resolve(context.siteDir, glossaryPath);\n\n      if (await fs.pathExists(glossaryFilePath)) {\n        try {\n          const rawData = await fs.readJson(glossaryFilePath);\n\n          // Validate glossary data structure\n          const validationResult = validateGlossaryData(rawData, { throwOnError: false });\n\n          if (!validationResult.valid) {\n            console.warn(\n              `[glossary-plugin] Glossary file has validation errors at ${glossaryFilePath}:`\n            );\n            validationResult.errors.forEach(err => {\n              console.warn(`  - [${err.field}] ${err.message}`);\n            });\n            console.warn('[glossary-plugin] Proceeding with valid terms only.');\n          }\n\n          return validationResult.data;\n        } catch (error) {\n          if (error instanceof GlossaryValidationError) {\n            throw error;\n          }\n          // JSON parsing error\n          throw new Error(\n            `Failed to parse glossary file at ${glossaryFilePath}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      }\n\n      console.warn(`Glossary file not found at ${glossaryFilePath}. Using empty glossary.`);\n      return { terms: [] };\n    },\n\n    async contentLoaded({ content, actions }) {\n      const { createData, addRoute, setGlobalData } = actions;\n      const glossaryContent = content as GlossaryData;\n\n      // Create data file that can be imported by components\n      const glossaryDataPath = await createData(\n        'glossary-data.json',\n        JSON.stringify(glossaryContent)\n      );\n\n      // Create a data file for the remark plugin to access glossary terms\n      await createData(\n        'remark-glossary-data.json',\n        JSON.stringify({\n          terms: glossaryContent.terms || [],\n          routePath: routePath,\n        })\n      );\n\n      // Add glossary page route\n      addRoute({\n        path: routePath,\n        component: path.join(currentDir, 'components/GlossaryPage.js'),\n        exact: true,\n        modules: {\n          glossaryData: glossaryDataPath,\n        },\n      });\n\n      // Expose global data for runtime lookups (used by GlossaryTerm)\n      setGlobalData({\n        terms: glossaryContent.terms || [],\n        routePath,\n      });\n    },\n\n    getThemePath() {\n      return path.resolve(currentDir, './theme');\n    },\n\n    getPathsToWatch() {\n      return [path.resolve(context.siteDir, glossaryPath)];\n    },\n\n    async postBuild() {\n      // You can add any post-build steps here if needed\n      console.log('Glossary plugin: Build completed');\n    },\n  };\n}\n\n// Export remark plugin factory for use in markdown configuration\nexport const remarkPlugin = remarkGlossaryTerms;\n\n// Export cache clearing utility\nexport { clearGlossaryCache } from './remark/glossary-terms.js';\n\n// Export validation utilities\nexport {\n  validateGlossaryData,\n  GlossaryValidationError,\n  formatValidationErrors,\n  type ValidationError,\n  type ValidationResult,\n} from './validation.js';\n\n/**\n * Helper function to get the configured remark plugin\n * This can be used in docusaurus.config.js markdown configuration\n *\n * @param pluginOptions - Plugin options from docusaurus.config.js\n * @param context - Context with siteDir\n * @returns Configured remark plugin\n */\nexport function getRemarkPlugin(\n  pluginOptions: GlossaryPluginOptions,\n  context?: { siteDir?: string }\n): [typeof remarkGlossaryTerms, { glossaryPath: string; routePath: string; siteDir?: string }] {\n  const { glossaryPath = 'glossary/glossary.json', routePath = '/glossary' } = pluginOptions;\n\n  const siteDir = context?.siteDir;\n\n  return [\n    remarkGlossaryTerms,\n    {\n      glossaryPath,\n      routePath,\n      siteDir,\n    },\n  ];\n}\n"],"mappings":";;;;;;;;;AACA,OAAO,UAAU;AAEjB,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AAEf,OAAO,8BAA8B;AAKrC,IAAM,kBAAkB,cAAc,YAAY,GAAG;AACrD,IAAM,aAAa,KAAK,QAAQ,eAAe;AAG/C,yBAAyB,UAAU;AAwFpB,SAAR,eACL,SACA,UAAiC,CAAC,GAC1B;AACR,QAAM,EAAE,eAAe,0BAA0B,YAAY,YAAY,IAAI;AAE7E,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,mBAAmB;AACjB,aAAO,CAAC,KAAK,QAAQ,YAAY,mBAAmB,CAAC;AAAA,IACvD;AAAA,IAEA,MAAM,cAAc;AAElB,YAAM,mBAAmB,KAAK,QAAQ,QAAQ,SAAS,YAAY;AAEnE,UAAI,MAAM,GAAG,WAAW,gBAAgB,GAAG;AACzC,YAAI;AACF,gBAAM,UAAU,MAAM,GAAG,SAAS,gBAAgB;AAGlD,gBAAM,mBAAmB,qBAAqB,SAAS,EAAE,cAAc,MAAM,CAAC;AAE9E,cAAI,CAAC,iBAAiB,OAAO;AAC3B,oBAAQ;AAAA,cACN,4DAA4D,gBAAgB;AAAA,YAC9E;AACA,6BAAiB,OAAO,QAAQ,SAAO;AACrC,sBAAQ,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,OAAO,EAAE;AAAA,YAClD,CAAC;AACD,oBAAQ,KAAK,qDAAqD;AAAA,UACpE;AAEA,iBAAO,iBAAiB;AAAA,QAC1B,SAAS,OAAO;AACd,cAAI,iBAAiB,yBAAyB;AAC5C,kBAAM;AAAA,UACR;AAEA,gBAAM,IAAI;AAAA,YACR,oCAAoC,gBAAgB,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,UACjH;AAAA,QACF;AAAA,MACF;AAEA,cAAQ,KAAK,8BAA8B,gBAAgB,yBAAyB;AACpF,aAAO,EAAE,OAAO,CAAC,EAAE;AAAA,IACrB;AAAA,IAEA,MAAM,cAAc,EAAE,SAAS,QAAQ,GAAG;AACxC,YAAM,EAAE,YAAY,UAAU,cAAc,IAAI;AAChD,YAAM,kBAAkB;AAGxB,YAAM,mBAAmB,MAAM;AAAA,QAC7B;AAAA,QACA,KAAK,UAAU,eAAe;AAAA,MAChC;AAGA,YAAM;AAAA,QACJ;AAAA,QACA,KAAK,UAAU;AAAA,UACb,OAAO,gBAAgB,SAAS,CAAC;AAAA,UACjC;AAAA,QACF,CAAC;AAAA,MACH;AAGA,eAAS;AAAA,QACP,MAAM;AAAA,QACN,WAAW,KAAK,KAAK,YAAY,4BAA4B;AAAA,QAC7D,OAAO;AAAA,QACP,SAAS;AAAA,UACP,cAAc;AAAA,QAChB;AAAA,MACF,CAAC;AAGD,oBAAc;AAAA,QACZ,OAAO,gBAAgB,SAAS,CAAC;AAAA,QACjC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,eAAe;AACb,aAAO,KAAK,QAAQ,YAAY,SAAS;AAAA,IAC3C;AAAA,IAEA,kBAAkB;AAChB,aAAO,CAAC,KAAK,QAAQ,QAAQ,SAAS,YAAY,CAAC;AAAA,IACrD;AAAA,IAEA,MAAM,YAAY;AAEhB,cAAQ,IAAI,kCAAkC;AAAA,IAChD;AAAA,EACF;AACF;AAGO,IAAM,eAAe;AAsBrB,SAAS,gBACd,eACA,SAC6F;AAC7F,QAAM,EAAE,eAAe,0BAA0B,YAAY,YAAY,IAAI;AAE7E,QAAM,UAAU,SAAS;AAEzB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-7Z37JEHW.js

@@ -0,0 +1,257 @@
+// src/validation.ts
+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}`;
+}
+
+export {
+  validateGlossaryData,
+  GlossaryValidationError,
+  formatValidationErrors
+};
+//# sourceMappingURL=chunk-7Z37JEHW.js.map

package/dist/chunk-7Z37JEHW.js.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":[]}