spec-up-t 1.2.3 → 1.2.5

package/assets/js/utils.js

@@ -1,4 +1,3 @@
-
 function delegateEvent(type, selector, fn, options = {}){
   return (options.container || document).addEventListener(type, e => {
     let match = e.target.closest(selector);
@@ -6,8 +5,8 @@ function delegateEvent(type, selector, fn, options = {}){
   }, options);
 }
 
-skipAnimationFrame = fn => requestAnimationFrame(() => requestAnimationFrame(fn));
+const skipAnimationFrame = fn => requestAnimationFrame(() => requestAnimationFrame(fn));
 
-var domReady = new Promise(resolve => {
+const domReady = new Promise(resolve => {
   document.addEventListener('DOMContentLoaded', e => resolve())
 });

package/index.js

@@ -1,5 +1,4 @@
 const { initialize } = require('./src/init');
-const {fetchExternalTerms} = require('./src/utils/fetch');
 
 module.exports = async function (options = {}) {
   try {
@@ -18,9 +17,6 @@ module.exports = async function (options = {}) {
     const { runJsonKeyValidatorSync } = require('./src/json-key-validator.js');
     runJsonKeyValidatorSync();
 
-    // const { createTermRelations } = require('./src/create-term-relations.js');
-    // createTermRelations();
-
     const { createTermIndex } = require('./src/create-term-index.js');
     createTermIndex();
 
@@ -29,9 +25,7 @@ module.exports = async function (options = {}) {
 
     const findPkgDir = require('find-pkg-dir');
     const modulePath = findPkgDir(__dirname);
-    let config = fs.readJsonSync('./output/specs-generated.json');
-
-    const externalTerms = fetchExternalTerms();
+    let config = fs.readJsonSync('./.cache/specs-generated.json');
 
     const createExternalSpecsList = require('./src/create-external-specs-list.js');
 
@@ -42,16 +36,14 @@ module.exports = async function (options = {}) {
 
     const { fixMarkdownFiles } = require('./src/fix-markdown-files.js');
 
-    // const { prepareTref } = require('./src/prepare-tref.js');
-
     let template = fs.readFileSync(path.join(modulePath, 'templates/template.html'), 'utf8');
     let assets = fs.readJsonSync(modulePath + '/src/asset-map.json');
     let externalReferences;
     let references = [];
     let definitions = [];
-    var toc;
-    var specGroups = {};
-    var noticeTitles = {};
+    let toc;
+    let specGroups = {};
+    let noticeTitles = {};
 
     const noticeTypes = {
       note: 1,
@@ -61,7 +53,7 @@ module.exports = async function (options = {}) {
       todo: 1
     };
     const spaceRegex = /\s+/g;
-    const specNameRegex = /^spec$|^spec[-]*\w+$/i;
+    const specNameRegex = /^spec$|^spec-*\w+$/i;
     const terminologyRegex = /^def$|^ref$|^xref|^tref$/i;
     const specCorpus = fs.readJsonSync(modulePath + '/assets/compiled/refs.json');
     const containers = require('markdown-it-container');
@@ -221,14 +213,12 @@ module.exports = async function (options = {}) {
       }
     ];
 
-    // prepareTref(path.join(config.specs[0].spec_directory, config.specs[0].spec_terms_directory));
-
     // Synchronously process markdown files
     fixMarkdownFiles(path.join(config.specs[0].spec_directory, config.specs[0].spec_terms_directory));
 
     function createScriptElementWithXTrefDataForEmbeddingInHtml() {
       // Test if xtrefs-data.js exists, else make it an empty string
-      const inputPath = path.join('output', 'xtrefs-data.js');
+      const inputPath = path.join('.cache', 'xtrefs-data.js');
 
       let xtrefsData = '';
       if (fs.existsSync(inputPath)) {
@@ -397,7 +387,7 @@ module.exports = async function (options = {}) {
 
       // Then filter to find the one with the terms-and-definitions-list class
       const dlElements = allDls.filter(dl => {
-        return dl.classList && dl.classList.contains('terms-and-definitions-list');
+        return dl?.classList?.contains('terms-and-definitions-list');
       });
 
       // Find any transcluded term dt elements anywhere in the document

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-up-t",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "Technical specification drafting tool that generates rich specification documents from markdown. Forked from https://github.com/decentralized-identity/spec-up by Daniel Buchner (https://github.com/csuwildcat)",
   "main": "./index",
   "repository": {
@@ -34,7 +34,7 @@
     "gulp": "4.0.2",
     "gulp-clean-css": "4.3.0",
     "gulp-concat": "2.6.1",
-    "gulp-terser": "1.2.0",
+    "gulp-terser": "^2.1.0",
     "jsdom": "^25.0.0",
     "markdown-it": "^13.0.1",
     "markdown-it-anchor": "^9.2.0",

package/src/README.md

@@ -78,9 +78,9 @@
 <ul>
 <li>Creates three output files:
 <ul>
-<li><code>output/xtrefs-data.json</code> - JSON data file</li>
-<li><code>output/xtrefs-data.js</code> - JavaScript module file</li>
-<li><code>output/xtrefs-history/xtrefs-data-[timestamp].js</code> - Historical record</li>
+<li><code>.cache/xtrefs-data.json</code> - JSON data file</li>
+<li><code>.cache/xtrefs-data.js</code> - JavaScript module file</li>
+<li><code>.cache/xtrefs-history/xtrefs-data-[timestamp].js</code> - Historical record</li>
 </ul>
 </li>
 </ul>

package/src/add-remove-xref-source.js

@@ -125,7 +125,6 @@ function updateJSON() {
         externalSpecs.push(inputs);
 
         fs.writeFileSync(JSON_FILE, JSON.stringify(data, null, 2), 'utf8');
-        // console.log(`Updated ${JSON_FILE} successfully.`);
         console.log(`Updated successfully.`);
     } catch (error) {
         console.error(`Error: Failed to update ${JSON_FILE}.`, error.message);
@@ -159,7 +158,6 @@ function removeEntry(externalSpec) {
         data.specs[0].external_specs = filteredSpecs;
 
         fs.writeFileSync(JSON_FILE, JSON.stringify(data, null, 2), 'utf8');
-        // console.log(`Removed entry with external_spec "${externalSpec}" successfully.`);
         console.log(`Removed entry successfully.`);
     } catch (error) {
         console.error(`Error: Failed to update ${JSON_FILE}.`, error.message);

package/src/asset-map.json

@@ -23,6 +23,8 @@
       "assets/css/external-links.css",
       "assets/css/repo-issues.css",
       "assets/css/adjust-font-size.css",
+      "assets/css/image-full-size.css",
+      "assets/css/add-bootstrap-classes-to-images.css",
       "assets/css/index.css"
     ],
     "js": [
@@ -44,6 +46,7 @@
       "assets/js/tippy.js",
       "assets/js/diff.min.js",
       "assets/js/edit-term-buttons.js",
+      "assets/js/hide-show-utility-container.js",
       "assets/js/create-alphabet-index.js",
       "assets/js/search.js",
       "assets/js/highlightMenuItems.js",
@@ -66,6 +69,8 @@
       "assets/js/close-off-canvas-menu.js",
       "assets/js/index.js",
       "assets/js/horizontal-scroll-hint.js",
+      "assets/js/add-bootstrap-classes-to-images.js",
+      "assets/js/image-full-size.js",
       "assets/js/bootstrap.bundle.min.js"
     ]
   }

package/src/collect-external-references.js

@@ -40,39 +40,58 @@
  * @since 2024-06-09
  */
 
-
+require('dotenv').config();
 const { shouldProcessFile } = require('./utils/file-filter');
 const path = require('path');
+const fs = require('fs-extra');
+const readlineSync = require('readline-sync');
 
+/**
+ * Checks if a specific xtref is present in the markdown content
+ * 
+ * @param {Object} xtref - The xtref object to check for
+ * @param {string} markdownContent - The markdown content to search in
+ * @returns {boolean} True if the xtref is found in the content
+ */
 function isXTrefInMarkdown(xtref, markdownContent) {
     const regex = new RegExp(`\\[\\[(?:x|t)ref:${xtref.externalSpec},\\s*${xtref.term}\\]\\]`, 'g');
     return regex.test(markdownContent);
 }
 
-// Helper function to process an XTref string and return an object.
+/**
+ * Helper function to process an XTref string and return an object.
+ * 
+ * @param {string} xtref - The xtref string to process
+ * @returns {Object} An object with externalSpec and term properties
+ */
 function processXTref(xtref) {
     let [externalSpec, term] = xtref
         .replace(/\[\[(?:xref|tref):/, '')
         .replace(/\]\]/, '')
         .trim()
         .split(/,/, 2);
-    return {
+    const xtrefObject = {
         externalSpec: externalSpec.trim(),
         term: term.trim()
     };
-}
 
+    return xtrefObject;
+}
 
-// allMarkdownContent: (string) The content to search for XTrefs.
-// allXTrefs: (object) An object with an array property "xtrefs" to which new entries will be added.
+/**
+ * Adds new xtrefs found in markdown content to the existing collection
+ * 
+ * @param {string} allMarkdownContent - The content to search for XTrefs
+ * @param {Object} allXTrefs - An object with an array property "xtrefs" to which new entries will be added
+ * @returns {Object} The updated allXTrefs object
+ */
 function addNewXTrefsFromMarkdown(allMarkdownContent, allXTrefs) {
     const regex = /\[\[(?:xref|tref):.*?\]\]/g;
     if (regex.test(allMarkdownContent)) {
         const xtrefs = allMarkdownContent.match(regex);
         xtrefs.forEach(xtref => {
             const newXTrefObj = processXTref(xtref);
-            // Add newXTrefObj only if an object with the same term and externalSpec doesn't already exist.
-            if (!allXTrefs.xtrefs.some(existingXTref =>
+            if (!allXTrefs?.xtrefs?.some(existingXTref =>
                 existingXTref.term === newXTrefObj.term &&
                 existingXTref.externalSpec === newXTrefObj.externalSpec)) {
                 allXTrefs.xtrefs.push(newXTrefObj);
@@ -82,6 +101,165 @@ function addNewXTrefsFromMarkdown(allMarkdownContent, allXTrefs) {
     return allXTrefs;
 }
 
+/**
+ * Extends xtref objects with additional information like repository URL and directory information
+ * 
+ * @param {Object} config - The configuration object from specs.json
+ * @param {Array} xtrefs - Array of xtref objects to extend
+ */
+function extendXTrefs(config, xtrefs) {
+    if (config.specs[0].external_specs_repos) {
+        console.log("ℹ️ PLEASE NOTE: Your specs.json file is outdated (not your fault, we changed something). Use this one: https://github.com/trustoverip/spec-up-t/blob/master/src/install-from-boilerplate/boilerplate/specs.json");
+        return;
+    }
+
+    xtrefs.forEach(xtref => {
+        config.specs.forEach(spec => {
+            // Loop through "external_specs" to find the repository URL for each xtref
+            xtref.repoUrl = null;
+            xtref.terms_dir = null;
+            xtref.owner = null;
+            xtref.repo = null;
+
+            spec.external_specs.forEach(repo => {
+                if (repo.external_spec === xtref.externalSpec) {
+                    xtref.repoUrl = repo.url;
+                    xtref.terms_dir = repo.terms_dir;
+                    const urlParts = new URL(xtref.repoUrl).pathname.split('/');
+                    xtref.owner = urlParts[1];
+                    xtref.repo = urlParts[2];
+                    xtref.avatarUrl = repo.avatar_url;
+                }
+            });
+
+            // Loop through "external_specs" to find the site URL for each xtref
+            xtref.site = null;
+            spec?.external_specs?.forEach(externalSpec => {
+                const key = Object.keys(externalSpec)[0];
+                if (key === xtref.externalSpec) {
+                    xtref.site = externalSpec[key];
+                }
+            });
+        });
+    });
+}
+
+/**
+ * Processes the main functionality after initial validation checks
+ * 
+ * @param {Object} config - The configuration object from specs.json
+ * @param {string} GITHUB_API_TOKEN - The GitHub API token
+ * @param {Object} options - Configuration options
+ */
+function processExternalReferences(config, GITHUB_API_TOKEN, options) {
+    const { processXTrefsData } = require('./collectExternalReferences/processXTrefsData.js');
+    const { doesUrlExist } = require('./utils/doesUrlExist.js');
+    const externalSpecsRepos = config.specs[0].external_specs;
+
+    // Check if the URLs for the external specs repositories are valid, and prompt the user to abort if they are not.
+    externalSpecsRepos.forEach(repo => {
+        doesUrlExist(repo.url).then(exists => {
+            if (!exists) {
+                const userInput = readlineSync.question(
+`❌ This external reference is not a valid URL:
+
+   Repository: ${repo.url},
+   
+   Terms directory: ${repo.terms_dir}
+
+   Please fix the external references in the specs.json file that you will find at the root of your project.
+
+   Do you want to stop? (yes/no): `);
+                if (userInput.toLowerCase() === 'yes' || userInput.toLowerCase() === 'y') {
+                    console.log('ℹ️ Stopping...');
+                    process.exit(1);
+                }
+            }
+        }).catch(error => {
+            console.error('❌ Error checking URL existence:', error);
+        });
+    });
+
+    // Collect all directories that contain files with a term and definition
+    // This maps over the specs in the config file and constructs paths to directories
+    // where the term definition files are located.
+    const specTermsDirectories = config.specs.map(spec => 
+        path.join(spec.spec_directory, spec.spec_terms_directory)
+    );
+
+    // Ensure that the 'output' directory exists, creating it if necessary.
+    const outputDir = '.cache';
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir);
+    }
+
+    // Ensure that the 'xtrefs-history' in outputDir exists, creating it if necessary.
+    const xtrefsHistoryDir = path.join(outputDir, 'xtrefs-history');
+    if (!fs.existsSync(xtrefsHistoryDir)) {
+        fs.mkdirSync(xtrefsHistoryDir);
+    }
+
+    // Define paths for various output files, including JSON and JS files.
+    const outputPathJSON = path.join(outputDir, 'xtrefs-data.json');
+    const outputPathJS = path.join(outputDir, 'xtrefs-data.js');
+    const outputPathJSTimeStamped = path.join(xtrefsHistoryDir, `xtrefs-data-${Date.now()}.js`);
+
+    // Initialize an object to store all xtrefs.
+    let allXTrefs = { xtrefs: [] };
+
+    // If the output JSON file exists, load its data.
+    if (fs.existsSync(outputPathJSON)) {
+        const existingXTrefs = fs.readJsonSync(outputPathJSON);
+        if (existingXTrefs?.xtrefs) {
+            allXTrefs = existingXTrefs;
+        }
+    }
+
+    // Collect all markdown content
+    let allMarkdownContent = '';
+
+    // Read all main repo Markdown files from a list of directories and concatenate their content into a single string.
+    specTermsDirectories.forEach(specDirectory => {
+        fs.readdirSync(specDirectory).forEach(file => {
+            if (shouldProcessFile(file)) {
+                const filePath = path.join(specDirectory, file);
+                const markdown = fs.readFileSync(filePath, 'utf8');
+                allMarkdownContent += markdown;
+            }
+        });
+    });
+
+    // Remove existing entries if not in the combined markdown content
+    allXTrefs.xtrefs = allXTrefs.xtrefs.filter(existingXTref => {
+        return isXTrefInMarkdown(existingXTref, allMarkdownContent);
+    });
+
+    addNewXTrefsFromMarkdown(allMarkdownContent, allXTrefs);
+
+    // Example at this point:
+    // allXTrefs.xtrefs: [
+    //     { externalSpec: 'kmg-1', term: 'authentic-chained-data-container' },
+    // ]
+
+    // Extend each xref with additional data and fetch commit information from GitHub.
+    extendXTrefs(config, allXTrefs.xtrefs);
+
+    // Example at this point:
+    // allXTrefs.xtrefs: [
+    //     {
+    //         externalSpec: 'kmg-1',
+    //         term: 'authentic-chained-data-container',
+    //         repoUrl: 'https://github.com/henkvancann/keri-main-glossary',
+    //         terms_dir: 'spec/terms-definitions',
+    //         owner: 'henkvancann',
+    //         repo: 'keri-main-glossary',
+    //         site: null
+    //     }
+    // ]
+    
+    processXTrefsData(allXTrefs, GITHUB_API_TOKEN, outputPathJSON, outputPathJS, outputPathJSTimeStamped, options);
+}
+
 /**
  * Collects external references from markdown files and processes them into usable data files.
  * 
@@ -107,9 +285,6 @@ function addNewXTrefsFromMarkdown(allMarkdownContent, allXTrefs) {
  * collectExternalReferences({ pat: 'github_pat_xxxxxxxxxxxx' });
  */
 function collectExternalReferences(options = {}) {
-    require('dotenv').config();
-    const fs = require('fs-extra');
-    const readlineSync = require('readline-sync');
     const config = fs.readJsonSync('specs.json');
     const externalSpecsRepos = config.specs[0].external_specs;
     const GITHUB_API_TOKEN = options.pat || process.env.GITHUB_API_TOKEN;
@@ -134,7 +309,6 @@ function collectExternalReferences(options = {}) {
 
 `;
     
-    
     // First do some checks
 
     // Do not run the script if the GitHub API token is not set
@@ -148,7 +322,6 @@ function collectExternalReferences(options = {}) {
             return;
         }
     }
-
     else if (externalSpecsRepos.length === 0) {
         // Check if the URLs for the external specs repositories are valid, and prompt the user to abort if they are not.
         console.log(explanationNoExternalReferences);
@@ -160,173 +333,8 @@ function collectExternalReferences(options = {}) {
             return;
         }
     } else {
-        main();
-    }
-
-    function main() {
-        const { processXTrefsData } = require('./collectExternalReferences/processXTrefsData.js');
-        const { doesUrlExist } = require('./utils/doesUrlExist.js');
-
-        // Check if the URLs for the external specs repositories are valid, and prompt the user to abort if they are not.
-        externalSpecsRepos.forEach(repo => {
-            doesUrlExist(repo.url).then(exists => {
-                if (!exists) {
-                    const userInput = readlineSync.question(
-`❌ This external reference is not a valid URL:
-
-   Repository: ${repo.url},
-   
-   Terms directory: ${repo.terms_dir}
-
-   Please fix the external references in the specs.json file that you will find at the root of your project.
-
-   Do you want to stop? (yes/no): `);
-                    if (userInput.toLowerCase() === 'yes' || userInput.toLowerCase() === 'y') {
-                        console.log('ℹ️ Stopping...');
-                        process.exit(1);
-                    }
-                }
-            }).catch(error => {
-                console.error('❌ Error checking URL existence:', error);
-            });
-        });
-
-        // Collect all directories that contain files with a term and definition
-        // This maps over the specs in the config file and constructs paths to directories
-        // where the term definition files are located.
-        const specTermsDirectories = config.specs.map(spec => 
-            path.join(spec.spec_directory, spec.spec_terms_directory)
-        );
-
-        // Ensure that the 'output' directory exists, creating it if necessary.
-        const outputDir = 'output';
-        if (!fs.existsSync(outputDir)) {
-            fs.mkdirSync(outputDir);
-        }
-
-        // Ensure that the 'output/xtrefs-history' directory exists, creating it if necessary.
-        const xtrefsHistoryDir = path.join(outputDir, 'xtrefs-history');
-        if (!fs.existsSync(xtrefsHistoryDir)) {
-            fs.mkdirSync(xtrefsHistoryDir);
-        }
-
-        // Define paths for various output files, including JSON and JS files.
-        const outputPathJSON = path.join(outputDir, 'xtrefs-data.json');
-        const outputPathJS = path.join(outputDir, 'xtrefs-data.js');
-        const outputPathJSTimeStamped = path.join(xtrefsHistoryDir, `xtrefs-data-${Date.now()}.js`);
-
-        // Function to extend xtref objects with additional information, such as repository URL and directory information.
-        function extendXTrefs(config, xtrefs) {
-            if (config.specs[0].external_specs_repos) {
-                console.log("ℹ️ PLEASE NOTE: Your specs.json file is outdated (not your fault, we changed something). Use this one: https://github.com/trustoverip/spec-up-t/blob/master/src/install-from-boilerplate/boilerplate/specs.json");
-                return;
-            }
-
-            xtrefs.forEach(xtref => {
-                config.specs.forEach(spec => {
-                    // Loop through "external_specs" to find the repository URL for each xtref
-                    xtref.repoUrl = null;
-                    xtref.terms_dir = null;
-                    xtref.owner = null;
-                    xtref.repo = null;
-
-                    spec.external_specs.forEach(repo => {
-                        if (repo.external_spec === xtref.externalSpec) {
-                            xtref.repoUrl = repo.url;
-                            xtref.terms_dir = repo.terms_dir;
-                            const urlParts = new URL(xtref.repoUrl).pathname.split('/');
-                            xtref.owner = urlParts[1];
-                            xtref.repo = urlParts[2];
-                            xtref.avatarUrl = repo.avatar_url;
-                        }
-                    });
-
-                    // Loop through "external_specs" to find the site URL for each xtref
-
-                    xtref.site = null;
-                    if (spec.external_specs) {
-                        spec.external_specs.forEach(externalSpec => {
-                            const key = Object.keys(externalSpec)[0];
-                            if (key === xtref.externalSpec) {
-                                xtref.site = externalSpec[key];
-                            }
-                        });
-                    }
-                });
-            });
-        }
-
-        // Function to process and clean up xref / tref strings found in the markdown file, returning an object with `externalSpec` and `term` properties.
-        //TODO: check if this is correct
-        function processXTref(xtref) {
-            let [externalSpec, term] = xtref.replace(/\[\[(?:xref|tref):/, '').replace(/\]\]/, '').trim().split(/,/, 2);
-            const xtrefObject = {
-                externalSpec: externalSpec.trim(),
-                term: term.trim()
-            };
-
-            return xtrefObject;
-        }
-
-        // Initialize an object to store all xtrefs.
-        let allXTrefs = { xtrefs: [] };
-
-        // If the output JSON file exists, load its data.
-        if (fs.existsSync(outputPathJSON)) {
-            const existingXTrefs = fs.readJsonSync(outputPathJSON);
-            if (existingXTrefs && existingXTrefs.xtrefs) {
-                allXTrefs = existingXTrefs;
-            }
-        }
-
-        // Collect all markdown content
-        let allMarkdownContent = '';
-
-        // Read all main repo Markdown files from a list of directories and concatenate their content into a single string.
-        specTermsDirectories.forEach(specDirectory => {
-            fs.readdirSync(specDirectory).forEach(file => {
-                if (shouldProcessFile(file)) {
-                    const filePath = path.join(specDirectory, file);
-                    const markdown = fs.readFileSync(filePath, 'utf8');
-                    allMarkdownContent += markdown;
-                }
-            });
-        });
-
-        // Remove existing entries if not in the combined markdown content
-        allXTrefs.xtrefs = allXTrefs.xtrefs.filter(existingXTref => {
-            return isXTrefInMarkdown(existingXTref, allMarkdownContent);
-        });
-
-        addNewXTrefsFromMarkdown(allMarkdownContent, allXTrefs);
-
-        // Example at this point:
-        // allXTrefs.xtrefs: [
-        //     { externalSpec: 'kmg-1', term: 'authentic-chained-data-container' },
-        // ]
-
-        // Extend each xref with additional data and fetch commit information from GitHub.
-        extendXTrefs(config, allXTrefs.xtrefs);
-
-        // Example at this point:
-        // allXTrefs.xtrefs: [
-        //     {
-        //         externalSpec: 'kmg-1',
-        //         term: 'authentic-chained-data-container',
-        //         repoUrl: 'https://github.com/henkvancann/keri-main-glossary',
-        //         terms_dir: 'spec/terms-definitions',
-        //         owner: 'henkvancann',
-        //         repo: 'keri-main-glossary',
-        //         site: null
-        //     }
-        // ]
-
-        
-        processXTrefsData(allXTrefs, GITHUB_API_TOKEN, outputPathJSON, outputPathJS, outputPathJSTimeStamped, options);
-
+        processExternalReferences(config, GITHUB_API_TOKEN, options);
     }
-
-
 }
 
 module.exports = {

package/src/collectExternalReferences/fetchTermsFromIndex.js

@@ -33,10 +33,11 @@ function generateCacheKey(owner, repo) {
  * @param {object} options - Options object
  * @param {number} options.cacheTTL - Time-to-live for cache in milliseconds (default: 24 hours)
  * @returns {object|null} - Cached data or null if not found or expired
+ * @example
+ * const cacheTTL = options.cacheTTL || 24 * 60 * 60 * 1000; // Default: 24 hours
  */
 function getFromCache(cacheKey, options = {}) {
     const cachePath = path.join(CACHE_DIR, `${cacheKey}.json`);
-    // const cacheTTL = options.cacheTTL || 24 * 60 * 60 * 1000; // Default: 24 hours
     const cacheTTL = 0;
 
     if (!fs.existsSync(cachePath)) {

package/src/config/paths.js

@@ -12,9 +12,9 @@ const paths = {};
 // console.log(getAllPaths());
 
 // Add paths
-paths['output-local-terms'] = path.resolve('output', 'local-terms-dir');
+paths['output-local-terms'] = path.resolve('.cache', 'local-terms-dir');
 paths['specsjson'] = path.resolve('specs.json');
-paths['githubcache'] = path.resolve('output', 'github-cache');
+paths['githubcache'] = path.resolve('.cache', 'github-cache');
 
 module.exports = {
     /**

package/src/create-external-specs-list.js

@@ -13,7 +13,7 @@
  */
 
 module.exports = function createExternalSpecsList(config) {
-    if (!config || !config.specs || !Array.isArray(config.specs)) {
+    if (!config?.specs?.length || !Array.isArray(config.specs)) {
         console.warn('❌ Invalid config format. Expected an object with a specs array.');
         return '<p>No external specifications found.</p>';
     }