@markbattistella/docsify-autoheaders 4.0.0 → 5.0.0

package/.browserslistrc

@@ -0,0 +1,4 @@
+# browsers we support
+last 4 versions
+> 0.5%
+ie >= 11

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+
+## 5.0.0 - Tue Jun 11 2024
+
+### Breaking Changes
+
+- Bumped to new major version
+- Fixing the documentation
+- Added new functionality for `@autoHeaders:` and `<!-- autoHeaders: -->` signifiers
+- Allows numbering in sidebar and main body
+- Better handling of debugging
+- Numbering can use letters and not just numbers
+- Many more fatures and cleanups

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# docsify-autoHeaders
+# docsify-auto-headers
 
 ![Github2npm](https://github.com/markbattistella/docsify-autoHeaders/workflows/gh2npm/badge.svg?event=registry_package) ![npm (scoped)](https://img.shields.io/npm/v/@markbattistella/docsify-autoheaders) ![GitHub](https://img.shields.io/github/license/markbattistella/docsify-autoheaders) ![npm bundle size (scoped)](https://img.shields.io/bundlephobia/minzip/@markbattistella/docsify-autoheaders)
 
@@ -9,8 +9,6 @@
 [![](https://img.shields.io/badge/%20-@markbattistella-blue?logo=paypal&style=for-the-badge)](https://www.paypal.me/markbattistella/6AUD)
 [![](https://img.shields.io/badge/%20-buymeacoffee-black?logo=buy-me-a-coffee&style=for-the-badge)](https://www.buymeacoffee.com/markbattistella)
 
-[![](https://img.shields.io/badge/demo-@markbattistella/docsify--autoHeaders-1E5749?style=for-the-badge)](https://markbattistella.github.io/docsify-autoHeaders/)
-
 </div>
 
 ---
@@ -44,18 +42,19 @@ Assuming you have a working [docsify](https://docsify.js.org/) framework set up,
 
 1. In docsify setup configure the plugin (see [configuration](#configuration) for setup):
 
-    ```js
-    <script>
-    window.$docsify = {
-      autoHeaders: {
-        separator: String,  // how numbers should be separated
-        levels:    String,  // heading levels h[1-6]
-        scope:     String,  // plugin search scope
-        debug:     Boolean  // show console.log messages
-      }
-    };
-    </script>
-    ```
+  ```js
+  <script>
+  window.$docsify = {
+    autoHeaders: {
+      separator: String,          // how numbers should be separated
+      custom:    String,          // if `separator` is set to other then specify own here
+      levels:    String | Object, // heading levels h[1-6]
+      scope:     String,          // plugin search scope
+      debug:     Boolean          // show console.log messages
+    }
+  };
+  </script>
+  ```
 
 ### npm install
 
@@ -71,8 +70,10 @@ There are some options available for the `docsify-autoHeaders`:
 
 | setting   | options                                                         |
 |-----------|-----------------------------------------------------------------|
-| separator | how the numbers are separated - `decimal`, `dash`, or `bracket` |
-| levels    | heading levels to target `1-6`                                  |
+| separator | how the numbers are separated: `decimal`, `dash`, `bracket`, or `other` |
+| custom    | if `separator` is set to `other` then you can specify the custom styled separator here |
+| levels    | String: heading levels to target `1-6`                          |
+|           | Object: start and finish for custom range                       |
 | scope     | the element to narrow it down to. `#main` is the default scope  |
 | debug     | `true` or `false` if you want to see `console.log` info         |
 
@@ -106,7 +107,50 @@ You can also manually set the starting number of each of the levels by using the
 
 Respectively starting the first level 6 heading (H6) at:
 
-    3.5.6.6.2.1 New heading
+```md
+3.5.6.6.2.1 New heading
+```
+
+## Start and finish range
+
+You can also target specific heading levels for the numbering which works well if you want to skip H1.
+
+```js
+<script>
+window.$docsify = {
+  autoHeaders: {
+    separator: 'other',
+    custom:    '--',
+    levels:    {
+       start:  '2',
+       finish: '4'
+    },
+    scope:     '#main',
+    debug:     false
+  }
+};
+</script>
+```
+
+```md
+@autoheaders:1.2.3.4.5.6
+
+# Level 1 heading
+
+## Level 2 heading
+
+### Level 3 heading
+```
+
+```md
+Level 1 heading
+
+1-- Level 2 heading
+
+1--2-- Level 3 heading
+```
+
+!> **Note:** though it skips H1, the numbering starts at the first integer from the `@autoheaders:1.2.3.4.5.6` data. The above example should be read as `@autoheaders:1.2.3`
 
 ## Contributing
 

package/dist/docsify-auto-headers.js

@@ -0,0 +1,579 @@
+/*! docsify-auto-headers 5.0.0 | (c) Mark Battistella */
+; (() => {
+
+  'use strict';
+
+  /**
+   * Default settings for the Docsify Auto Headers plugin.
+   * @type {Object}
+   * @property {string} separator - The separator for header numbering (e.g., '.', '-', ')').
+   * @property {boolean} sidebar - Boolean indicating if headers should be added to the sidebar.
+   * @property {number|Object} levels - Number of header levels to include (1 to 6) or an object with start and finish properties.
+   * @property {boolean} debug - Boolean to enable or disable debug messages.
+   */
+  const docsifyAutoHeadersDefaults = {
+
+      // Separator for header numbering (e.g., '.', '-', ')')
+      separator: '.',
+
+      // Boolean indicating if headers should be added to the sidebar
+      sidebar: false,
+
+      // Number of header levels to include (1 to 6) or an object with start and finish properties
+      levels: 6,
+
+      // Boolean to enable or disable debug messages
+      debug: false
+  };
+
+  /**
+   * Main function for the Docsify Auto Headers plugin.
+   * @param {Object} hook - Docsify hook object.
+   * @param {Object} vm - Docsify virtual machine object.
+   */
+  const autoHeaders = (hook, vm) => {
+
+      /**
+       * Predefined error messages for invalid configurations.
+       * @type {Object}
+       * @property {string} invalidConfiguration - General error message for invalid configuration.
+       * @property {string} invalidConfigurationSidebar - Error message for invalid sidebar configuration.
+       * @property {string} invalidConfigurationLevels - Error message for invalid levels configuration.
+       * @property {string} nonNumericHeadingLevel - Error message when levels start or finish values are not numbers.
+       * @property {string} badNumericOrderHeadingLevel - Error message when start value is greater than finish value.
+       * @property {string} outOfRangeHeadingLevel - Error message when start or finish values are out of range (1-6).
+       * @property {string} moreThanSixElements - Error message when more than 6 elements are found in the signifier.
+       * @property {string} invalidParsedElements - Error message when elements in the signifier are not purely numeric or alphabetic.
+       * @property {string} signifierNotFound - Error message when the auto header signifier is missing in the markdown file.
+       */
+      const errorMessage = {
+          invalidConfiguration:
+              'Configuration settings are not set correctly. Please review the autoHeaders parameters and documentation.',
+          invalidConfigurationSidebar:
+              'The sidebar setting for autoHeaders only accepts a boolean of true or false. Please check you\'ve entered this data correctly.',
+          invalidConfigurationLevels:
+              'The levels settings for autoHeaders only accepts a number from 1-6 or an object with the start and finish options. Please check you\'ve entered this data correctly.',
+          nonNumericHeadingLevel:
+              'The levels setting has been configured with a start and finish option. However, the values for one of these is not a number. Please check you\'ve entered this data correctly.',
+          badNumericOrderHeadingLevel:
+              'The levels setting has been configured with a start and finish option. However, the start value is greater than the finish. Please check you\'ve entered this data correctly.',
+          outOfRangeHeadingLevel:
+              'The levels setting has been configured with a start and finish option. However, the values for one of these is not from 1-6. Please check you\'ve entered this data correctly.',
+          moreThanSixElements:
+              'The elements found in the signifier have equated to more than 6 headings. Please check the configuration of your markdown that you have no more than 6 numbers',
+          invalidParsedElements:
+              'The elements found in the signifier are not numbers only or alphabet only. Please check the configuration of your markdown that all the items are numeric or alphabetic.',
+          signifierNotFound:
+              'The current markdown file is missing the @autoHeader: or <!-- autoHeader: --> signifier',
+      };
+
+      /**
+       * Boolean flag indicating whether the processing should continue.
+       * @type {boolean}
+       */
+      let shouldContinue = true;
+
+      /**
+       * Logs an error message if a configuration is invalid.
+       * @param {boolean} shouldShow - Boolean indicating if the error message should be shown.
+       * @param {string} message - The error message to log.
+       * @returns {null} Always returns null after logging the error.
+       */
+      const logErrorMessage = (shouldShow, message) => {
+          if (shouldShow) {
+              console.warn(`Docsify Auto Headers:\n>> ${message}`);
+          }
+          shouldContinue = false;
+          return null;
+      };
+
+      /**
+       * Sets the default options for the plugin by merging user-defined options with defaults.
+       * @param {Object} options - User-defined options to override the default settings.
+       * @param {string} options.separator - The separator for header numbering.
+       * @param {number|Object} options.levels - Number of header levels to include or an object with start and finish properties.
+       * @param {boolean} options.sidebar - Boolean indicating if headers should be added to the sidebar.
+       * @param {boolean} options.debug - Boolean to enable or disable debug messages.
+       * @returns {Object|null} The final options object or null if there is an invalid configuration.
+       */
+      const setDefaultOptions = (options) => {
+          if (!options.separator || options.levels === undefined) {
+              return logErrorMessage(options.debug, errorMessage.invalidConfiguration);
+          }
+
+          // Map user-friendly separator names to actual separator characters
+          const separatorMap = {
+              'decimal': '.',
+              'dot': '.',
+              'dash': '-',
+              'hyphen': '-',
+              'bracket': ')',
+              'parenthesis': ')'
+          };
+          // Determine the separator to use
+          const separator = separatorMap[options.separator] || options.separator;
+
+          // Set the levels, defaulting to 6 if not provided
+          const levels = options.levels || 6;
+
+          // Ensure sidebar and debug options are booleans
+          const sidebar = !!options.sidebar;
+
+          const debug = !!options.debug;
+
+          return { separator, levels, sidebar, debug };
+      };
+
+      /**
+       * Validates and retrieves the sidebar setting.
+       * @param {boolean} input - The sidebar setting input.
+       * @param {Object} options - The current plugin options.
+       * @param {boolean} options.debug - Boolean to enable or disable debug messages.
+       * @returns {boolean|null} The validated sidebar setting or null if the input is invalid.
+       */
+      const validateThenGetSidebar = (input, options) => {
+          if (typeof input !== 'boolean') {
+              return logErrorMessage(options.debug, errorMessage.invalidConfigurationSidebar);
+          }
+          return input;
+      };
+
+      /**
+       * Validates and retrieves the heading range setting.
+       * @param {number|Object} input - The levels setting input, which can be a number or an object with start and finish properties.
+       * @param {Object} options - The current plugin options.
+       * @param {boolean} options.debug - Boolean to enable or disable debug messages.
+       * @returns {Object|null} The validated heading range configuration or null if the input is invalid.
+       */
+      const validateThenGetHeadingRange = (input, options) => {
+          if (typeof input !== 'number' && (typeof input !== 'object' || input === null)) {
+              return logErrorMessage(options.debug, errorMessage.invalidConfigurationLevels);
+          }
+
+          // Helper function to check if a value is within a specified range
+          const isInRange = (value, min, max) => value >= min && value <= max;
+          let start, finish;
+
+          if (typeof input === 'number') {
+              start = 1;
+              finish = input;
+          } else if (typeof input === 'object') {
+              ({ start, finish } = input);
+              if (typeof start !== 'number' || typeof finish !== 'number') {
+                  return logErrorMessage(options.debug, errorMessage.nonNumericHeadingLevel);
+              }
+              if (start > finish) {
+                  return logErrorMessage(options.debug, errorMessage.badNumericOrderHeadingLevel);
+              }
+          }
+
+          if (!isInRange(start, 1, 6) || !isInRange(finish, 1, 6)) {
+              return logErrorMessage(options.debug, errorMessage.outOfRangeHeadingLevel);
+          }
+
+          const headings = {};
+          for (let i = 1; i <= 6; i++) {
+              headings[`h${i}`] = { inScope: isInRange(i, start, finish) };
+          }
+          return headings;
+      };
+
+      /**
+       * Converts a number to a header string based on the type (numeric or alphabetic).
+       * @param {number} num - The number to convert.
+       * @param {string} type - The type of conversion ("numeric", "alphabetic-lower", "alphabetic-upper").
+       * @returns {string} The converted header string.
+       */
+      const numberToHeader = (num, type) => {
+          if (type === "numeric") {
+              return num + ""; // Convert number to string
+          } else {
+              num--; // Adjust the number for zero-based index
+              let result = '';
+              while (num >= 0) {
+                  let remainder = num % 26;
+                  result = String.fromCharCode(65 + remainder) + result;
+                  num = Math.floor(num / 26) - 1;
+              }
+
+              // Convert result to lowercase if type is "alphabetic-lower"
+              return (type === "alphabetic-lower") ? result.toLowerCase() : result;
+          }
+      };
+
+      /**
+       * Converts a header string to a number based on the type.
+       * @param {string} header - The header string to convert.
+       * @param {string} type - The type of conversion ("numeric", "alphabetic-lower", "alphabetic-upper").
+       * @returns {number} The converted number.
+       */
+      const headerToNumber = (header, type) => {
+          if (type === "numeric") {
+              return parseInt(header, 10); // Convert header string to number
+          } else {
+              header = header.toUpperCase(); // Convert header to uppercase for alphabetic conversion
+              let result = 0;
+              for (let i = 0; i < header.length; i++) {
+                  result *= 26;
+                  result += header.charCodeAt(i) - 65 + 1;
+              }
+              return result;
+          }
+      };
+
+      /**
+       * Parses the starting values for headers from the signifier.
+       * @param {string} headerNumbers - The header numbers string.
+       * @param {Object} options - The current plugin options.
+       * @param {string} options.separator - The separator for header numbering.
+       * @param {boolean} options.debug - Boolean to enable or disable debug messages.
+       * @returns {Array<Object>|null} The parsed header values as an array of objects or null if the input is invalid.
+       */
+      const parseHeadingStartingValues = (headerNumbers, options) => {
+          // Helper functions to check if a string is all numeric or alphabetic
+          const isAllNumeric = (str) => /^\d+$/.test(str);
+          const isAllAlphabeticLower = (str) => /^[a-z]+$/.test(str);
+          const isAllAlphabeticUpper = (str) => /^[A-Z]+$/.test(str);
+
+          // Split the header numbers string by the separator and trim each element
+          let elements = headerNumbers.split(options.separator).map(el => el.trim());
+          if (elements.length > 6) {
+              return logErrorMessage(options.debug, errorMessage.moreThanSixElements);
+          }
+
+          // Check if all elements are numeric or alphabetic
+          const isNumeric = elements.every(isAllNumeric);
+          const isAlphabeticLower = elements.every(isAllAlphabeticLower);
+          const isAlphabeticUpper = elements.every(isAllAlphabeticUpper);
+          if (!isNumeric && !isAlphabeticLower && !isAlphabeticUpper) {
+              return logErrorMessage(options.debug, errorMessage.invalidParsedElements);
+          }
+
+          // Ensure there are at least 6 elements by filling with default values
+          while (elements.length < 6) {
+              elements.push(isNumeric ? '1' : (isAlphabeticLower ? 'a' : 'A'));
+          }
+
+          // Determine the type of header values
+          let type = isNumeric ? 'numeric' : (isAlphabeticLower ? 'alphabetic-lower' : 'alphabetic-upper');
+
+          // Convert the elements to header values
+          return elements.map(x => ({ counter: headerToNumber(x, type), type }));
+      };
+
+      /**
+       * Validates the presence of the auto header signifier in the markdown.
+       * @param {string} markdown - The markdown content.
+       * @param {Object} options - The current plugin options.
+       * @param {boolean} options.debug - Boolean to enable or disable debug messages.
+       * @returns {Object|null} An object containing the heading signifier and the remaining markdown content, or null if the signifier is not found.
+       */
+      const validateAutoHeaderSignifier = (markdown, options) => {
+          // Regular expression pattern to match the auto header signifier
+          const autoHeaderPattern = /^\s*(?:@autoHeader:|<!--\s+autoHeader:)([\d.a-zA-Z\-:,~]*)(?:\s+-->)?/;
+          const match = markdown.match(autoHeaderPattern);
+
+          if (!match) {
+              return logErrorMessage(options.debug, errorMessage.signifierNotFound);
+          }
+
+          // Remove the matched signifier from the markdown
+          markdown = markdown.substring(match[0].length);
+
+          return {
+              headingSignifier: match[1], // The captured signifier
+              markdown, // The remaining markdown content
+          };
+      };
+
+      /**
+       * Creates count context objects for header levels.
+       * @param {Object} levels - The header levels configuration.
+       * @returns {Object} An object containing the current counts and scoped tag names.
+       */
+      const createCountContextObjects = (levels) => {
+          const configEntries = Object.entries(levels);
+
+          // Create a map of current counts for each header level
+          const currentCounts = new Map(
+              configEntries.map(([key, { counter, type }]) => {
+                  counter = parseInt(counter, 10); // Convert counter to an integer
+                  counter = Number.isFinite(counter) ? counter - 1 : 0; // Decrement counter or set to 0 if not a number
+                  return [key, { current: counter, type, skipDownstreamReset: true }];
+              })
+          );
+
+          // Create a set of tag names that are in scope
+          const scopedTagNames = new Set(
+              configEntries.filter(([_, { inScope }]) => inScope).map(([key]) => key)
+          );
+
+          return { currentCounts, scopedTagNames };
+      };
+
+      /**
+       * Applies the current count to the heading node.
+       * @param {HTMLElement} headingNode - The heading node to update.
+       * @param {Object} options - The current plugin options.
+       * @param {string} options.separator - The separator for header numbering.
+       */
+      const applyCurrentCountThroughBoundContext = function (headingNode, options) {
+          const { currentCounts, scopedTagNames } = this;
+          const headingName = headingNode.tagName.toLowerCase();
+          const headingNameList = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'];
+          const counts = currentCounts.get(headingName);
+
+          counts.current += 1; // Increment the current count for the heading level
+          if (!counts.skipDownstreamReset) {
+              // Reset counts for heading levels below the current level
+              headingNameList.slice(headingNameList.indexOf(headingName) + 1).forEach(name => {
+                  if (currentCounts.has(name)) {
+                      const nextMinorCount = currentCounts.get(name);
+                      nextMinorCount.current = 0;
+                  }
+              });
+          }
+          counts.skipDownstreamReset = false; // Reset the flag
+
+          if (scopedTagNames.has(headingName)) {
+              // Generate the counter value for the heading
+              const counterValue = headingNameList
+                  .slice(0, headingNameList.indexOf(headingName) + 1)
+                  .map(name => {
+                      const { current, type } = currentCounts.get(name);
+                      return numberToHeader(current, type);
+                  })
+                  .join(options.separator) + options.separator;
+
+              headingNode.innerHTML = `${counterValue} ${headingNode.innerHTML}`; // Update the heading's innerHTML
+          }
+      };
+
+      /**
+       * Parses the markdown content and updates headers based on the settings.
+       * @param {string} markdown - The markdown content to parse.
+       * @param {Object} options - The current plugin options.
+       * @param {string} options.separator - The separator for header numbering.
+       * @param {Object} levels - The header levels configuration.
+       * @returns {string} The updated markdown content with applied header counts.
+       */
+      const parseMarkdown = (markdown, options, levels) => {
+          const { currentCounts, scopedTagNames } = createCountContextObjects(levels);
+          const headingPattern = /^(#{1,6})\s+(.*)$/gm; // Regex pattern to match markdown headers
+          const headingNameList = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'];
+
+          let result = markdown.replace(headingPattern, (match, hashes, text) => {
+              const headingLevel = hashes.length;
+              const headingName = `h${headingLevel}`;
+              const counts = currentCounts.get(headingName);
+
+              counts.current += 1; // Increment the current count for the heading level
+              if (!counts.skipDownstreamReset) {
+                  // Reset counts for heading levels below the current level
+                  headingNameList.slice(headingLevel).forEach(name => {
+                      if (currentCounts.has(name)) {
+                          const nextMinorCount = currentCounts.get(name);
+                          nextMinorCount.current = 0;
+                      }
+                  });
+              }
+              counts.skipDownstreamReset = false; // Reset the flag
+
+              if (scopedTagNames.has(headingName)) {
+                  // Generate the counter value for the heading
+                  const counterValue = headingNameList
+                      .slice(0, headingLevel)
+                      .map(name => {
+                          const { current, type } = currentCounts.get(name);
+                          return numberToHeader(current, type);
+                      })
+                      .join(options.separator) + options.separator;
+                  return `${hashes} ${counterValue} ${text}`; // Update the header in the markdown
+              } else {
+                  return match; // Return the original match if the heading is not in scope
+              }
+          });
+          return result; // Return the updated markdown content
+      };
+
+      /**
+       * Applies scoped heading counts to the input content.
+       * @param {Object} levels - The header levels configuration.
+       * @param {Object} options - The current plugin options.
+       * @param {string} options.separator - The separator for header numbering.
+       * @param {string} input - The input content (HTML or markdown).
+       * @param {string} type - The type of input content ('html' or 'markdown').
+       * @returns {string} The updated content with applied header counts.
+       */
+      const applyScopedHeadingCounts = (levels, options, input, type) => {
+          const { currentCounts, scopedTagNames } = createCountContextObjects(levels);
+
+          if (type === 'html') {
+              // Parse the input HTML content
+              const parser = new DOMParser();
+              input = parser.parseFromString(input, 'text/html').body;
+
+              // Get all heading elements
+              const headingList = [...input.querySelectorAll('h1, h2, h3, h4, h5, h6')];
+
+              // Apply the current count to each heading element
+              headingList.forEach(
+                  heading => applyCurrentCountThroughBoundContext.call(
+                      { currentCounts, scopedTagNames },
+                      heading,
+                      options
+                  )
+              );
+
+              return input.innerHTML; // Return the updated HTML content
+          } else if (type === 'markdown') {
+              // Parse and update the markdown content
+              return parseMarkdown(input, options, levels);
+          }
+      };
+
+      // Set the default options by merging user-defined options with default settings
+      const defaultOptions = setDefaultOptions(docsifyAutoHeadersDefaults);
+      if (!defaultOptions) return;
+
+      // Initialize options with validated settings
+      /**
+       * The plugin options after validation and initialization.
+       * @type {Object}
+       * @property {string} separator - The separator for header numbering.
+       * @property {Object} levels - The validated header levels configuration.
+       * @property {boolean} sidebar - Boolean indicating if headers should be added to the sidebar.
+       * @property {boolean} debug - Boolean to enable or disable debug messages.
+       */
+      let options = {
+          separator: defaultOptions.separator,
+          levels: validateThenGetHeadingRange(defaultOptions.levels, defaultOptions),
+          sidebar: validateThenGetSidebar(defaultOptions.sidebar, defaultOptions),
+          debug: defaultOptions.debug,
+      };
+
+      /**
+       * Docsify hook to process markdown before it is rendered.
+       * @param {Function} hook - Docsify hook function.
+       * @param {Object} options - The current plugin options.
+       */
+      hook.beforeEach(markdown => {
+          shouldContinue = true;
+          if (!shouldContinue) return markdown;
+
+          // Validate the presence of the auto header signifier in the markdown
+          const result = validateAutoHeaderSignifier(markdown, options);
+          if (!result) {
+              return markdown;
+          }
+          let headingSignifier;
+          ({ headingSignifier, markdown } = result); // Destructure the result
+
+          // Validate and retrieve the heading range setting
+          const headingRanges = validateThenGetHeadingRange(defaultOptions.levels, options);
+          if (!headingRanges) {
+              return markdown;
+          }
+
+          // Parse the starting values for headers from the signifier
+          const startingHeadingValues = parseHeadingStartingValues(
+              headingSignifier,
+              options
+          );
+          if (!startingHeadingValues) {
+              return markdown;
+          }
+
+          // Create the heading configuration
+          const headingConfiguration = {};
+          for (const [index, key] of Object.keys(headingRanges).entries()) {
+              headingConfiguration[key] = {
+                  ...headingRanges[key],
+                  ...startingHeadingValues[index],
+              };
+          }
+
+          // Update the options with the new heading configuration
+          options.levels = headingConfiguration;
+
+          return markdown; // Return the updated markdown
+      });
+
+
+      // Check if the sidebar option is enabled
+      if (options.sidebar) {
+
+          /**
+           * Docsify hook to process markdown before it is rendered if the sidebar option is enabled.
+           * @param {Function} hook - Docsify hook function.
+           * @param {Object} options - The current plugin options.
+           */
+          hook.beforeEach((markdown, next) => {
+              let output;
+
+              try {
+                  // Apply scoped heading counts to the markdown content
+                  output = applyScopedHeadingCounts(
+                      options.levels,
+                      options,
+                      markdown,
+                      'markdown'
+                  );
+                  if (!shouldContinue) output = markdown;
+
+              } catch (error) {
+                  output = markdown;
+                  console.warn(error.message);
+              } finally {
+                  next(output); // Pass the updated markdown to the next hook
+              }
+          });
+      } else {
+
+          /**
+           * Docsify hook to process HTML after it is rendered if the sidebar option is disabled.
+           * @param {Function} hook - Docsify hook function.
+           * @param {Object} options - The current plugin options.
+           */
+          hook.afterEach((html, next) => {
+              let output;
+
+              try {
+                  // Apply scoped heading counts to the HTML content
+                  output = applyScopedHeadingCounts(
+                      options.levels,
+                      options,
+                      html,
+                      'html'
+                  );
+                  if (!shouldContinue) output = html;
+
+              } catch (error) {
+                  output = html;
+                  console.warn(error.message);
+              } finally {
+                  next(output); // Pass the updated HTML to the next hook
+              }
+          });
+      }
+  };
+
+  /**
+   * Initializes the plugin if running in a browser environment.
+   * This adds the autoHeaders plugin to the Docsify instance.
+   */
+  if (window) {
+      window.$docsify = window.$docsify || {};
+
+      // Merge user-defined settings with default settings
+      window.$docsify.autoHeaders = Object.assign(
+          docsifyAutoHeadersDefaults,
+          window.$docsify.autoHeaders
+      );
+
+      // Add the autoHeaders function to the list of Docsify plugins
+      window.$docsify.plugins = (
+          window.$docsify.plugins || []
+      ).concat(autoHeaders);
+  }
+})();

package/dist/docsify-auto-headers.min.js

@@ -0,0 +1,2 @@
+/*! docsify-auto-headers 5.0.0 | (c) Mark Battistella */
+"use strict";function ownKeys(r,e){var t,n=Object.keys(r);return Object.getOwnPropertySymbols&&(t=Object.getOwnPropertySymbols(r),e&&(t=t.filter(function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})),n.push.apply(n,t)),n}function _objectSpread(r){for(var e=1;e<arguments.length;e++){var t=null!=arguments[e]?arguments[e]:{};e%2?ownKeys(Object(t),!0).forEach(function(e){_defineProperty(r,e,t[e])}):Object.getOwnPropertyDescriptors?Object.defineProperties(r,Object.getOwnPropertyDescriptors(t)):ownKeys(Object(t)).forEach(function(e){Object.defineProperty(r,e,Object.getOwnPropertyDescriptor(t,e))})}return r}function _defineProperty(e,r,t){return(r=_toPropertyKey(r))in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function _toPropertyKey(e){e=_toPrimitive(e,"string");return"symbol"==_typeof(e)?e:e+""}function _toPrimitive(e,r){if("object"!=_typeof(e)||!e)return e;var t=e[Symbol.toPrimitive];if(void 0===t)return("string"===r?String:Number)(e);t=t.call(e,r||"default");if("object"!=_typeof(t))return t;throw new TypeError("@@toPrimitive must return a primitive value.")}function _createForOfIteratorHelper(e,r){var t,n,o,a,i="undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(i)return o=!(n=!0),{s:function(){i=i.call(e)},n:function(){var e=i.next();return n=e.done,e},e:function(e){o=!0,t=e},f:function(){try{n||null==i.return||i.return()}finally{if(o)throw t}}};if(Array.isArray(e)||(i=_unsupportedIterableToArray(e))||r&&e&&"number"==typeof e.length)return i&&(e=i),a=0,{s:r=function(){},n:function(){return a>=e.length?{done:!0}:{done:!1,value:e[a++]}},e:function(e){throw e},f:r};throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function _toConsumableArray(e){return _arrayWithoutHoles(e)||_iterableToArray(e)||_unsupportedIterableToArray(e)||_nonIterableSpread()}function _nonIterableSpread(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function _iterableToArray(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function _arrayWithoutHoles(e){if(Array.isArray(e))return _arrayLikeToArray(e)}function _slicedToArray(e,r){return _arrayWithHoles(e)||_iterableToArrayLimit(e,r)||_unsupportedIterableToArray(e,r)||_nonIterableRest()}function _nonIterableRest(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function _unsupportedIterableToArray(e,r){var t;if(e)return"string"==typeof e?_arrayLikeToArray(e,r):"Map"===(t="Object"===(t={}.toString.call(e).slice(8,-1))&&e.constructor?e.constructor.name:t)||"Set"===t?Array.from(e):"Arguments"===t||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t)?_arrayLikeToArray(e,r):void 0}function _arrayLikeToArray(e,r){(null==r||r>e.length)&&(r=e.length);for(var t=0,n=Array(r);t<r;t++)n[t]=e[t];return n}function _iterableToArrayLimit(e,r){var t=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=t){var n,o,a,i,u=[],s=!0,c=!1;try{if(a=(t=t.call(e)).next,0===r){if(Object(t)!==t)return;s=!1}else for(;!(s=(n=a.call(t)).done)&&(u.push(n.value),u.length!==r);s=!0);}catch(e){c=!0,o=e}finally{try{if(!s&&null!=t.return&&(i=t.return(),Object(i)!==i))return}finally{if(c)throw o}}return u}}function _arrayWithHoles(e){if(Array.isArray(e))return e}function _typeof(e){return(_typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e})(e)}!function(){function e(e,r){function y(e,r){return e&&console.warn("Docsify Auto Headers:\n>> ".concat(r)),m=!1,null}function h(e,r){if("number"!=typeof e&&("object"!==_typeof(e)||null===e))return y(r.debug,u);function t(e,r,t){return r<=e&&e<=t}var n,o;if("number"==typeof e)n=1,o=e;else if("object"===_typeof(e)){if(n=e.start,o=e.finish,"number"!=typeof n||"number"!=typeof o)return y(r.debug,s);if(o<n)return y(r.debug,c)}if(!t(n,1,6)||!t(o,1,6))return y(r.debug,l);for(var a={},i=1;i<=6;i++)a["h".concat(i)]={inScope:t(i,n,o)};return a}function d(e,r){var t=e.split(r.separator).map(function(e){return e.trim()});if(6<t.length)return y(r.debug,i);var n=t.every(function(e){return/^\d+$/.test(e)}),o=t.every(function(e){return/^[a-z]+$/.test(e)}),e=t.every(function(e){return/^[A-Z]+$/.test(e)});if(!n&&!o&&!e)return y(r.debug,f);for(;t.length<6;)t.push(n?"1":o?"a":"A");var a=n?"numeric":o?"alphabetic-lower":"alphabetic-upper";return t.map(function(e){return{counter:function(e,r){if("numeric"===r)return parseInt(e,10);e=e.toUpperCase();for(var t=0,n=0;n<e.length;n++)t=(t*=26)+(e.charCodeAt(n)-65+1);return t}(e,a),type:a}})}function n(e,r,t,n){var i,u,s,c,o=g(e),a=o.currentCounts,l=o.scopedTagNames;return"html"===n?(_toConsumableArray((t=(new DOMParser).parseFromString(t,"text/html").body).querySelectorAll("h1, h2, h3, h4, h5, h6")).forEach(function(e){return function(e,r){var t=this.currentCounts,n=this.scopedTagNames,o=e.tagName.toLowerCase(),a=["h1","h2","h3","h4","h5","h6"],i=t.get(o);i.current+=1,i.skipDownstreamReset||a.slice(a.indexOf(o)+1).forEach(function(e){t.has(e)&&(t.get(e).current=0)}),i.skipDownstreamReset=!1,n.has(o)&&(i=a.slice(0,a.indexOf(o)+1).map(function(e){var e=t.get(e),r=e.current,e=e.type;return v(r,e)}).join(r.separator)+r.separator,e.innerHTML="".concat(i," ").concat(e.innerHTML))}.call({currentCounts:a,scopedTagNames:l},e,r)}),t.innerHTML):"markdown"===n?(o=t,i=r,n=g(n=e),u=n.currentCounts,s=n.scopedTagNames,c=["h1","h2","h3","h4","h5","h6"],o.replace(/^(#{1,6})\s+(.*)$/gm,function(e,r,t){var n=r.length,o="h".concat(n),a=u.get(o);return a.current+=1,a.skipDownstreamReset||c.slice(n).forEach(function(e){u.has(e)&&(u.get(e).current=0)}),a.skipDownstreamReset=!1,s.has(o)?(a=c.slice(0,n).map(function(e){var e=u.get(e),r=e.current,e=e.type;return v(r,e)}).join(i.separator)+i.separator,"".concat(r," ").concat(a," ").concat(t)):e})):void 0}var p,t,o="Configuration settings are not set correctly. Please review the autoHeaders parameters and documentation.",a="The sidebar setting for autoHeaders only accepts a boolean of true or false. Please check you've entered this data correctly.",u="The levels settings for autoHeaders only accepts a number from 1-6 or an object with the start and finish options. Please check you've entered this data correctly.",s="The levels setting has been configured with a start and finish option. However, the values for one of these is not a number. Please check you've entered this data correctly.",c="The levels setting has been configured with a start and finish option. However, the start value is greater than the finish. Please check you've entered this data correctly.",l="The levels setting has been configured with a start and finish option. However, the values for one of these is not from 1-6. Please check you've entered this data correctly.",i="The elements found in the signifier have equated to more than 6 headings. Please check the configuration of your markdown that you have no more than 6 numbers",f="The elements found in the signifier are not numbers only or alphabet only. Please check the configuration of your markdown that all the items are numeric or alphabetic.",b="The current markdown file is missing the @autoHeader: or \x3c!-- autoHeader: --\x3e signifier",m=!0,v=function(e,r){if("numeric"===r)return e+"";e--;for(var t="";0<=e;){t=String.fromCharCode(65+e%26)+t;e=Math.floor(e/26)-1}return"alphabetic-lower"===r?t.toLowerCase():t},g=function(e){e=Object.entries(e);return{currentCounts:new Map(e.map(function(e){var e=_slicedToArray(e,2),r=e[0],e=e[1],t=e.counter,e=e.type,t=parseInt(t,10);return[r,{current:Number.isFinite(t)?t-1:0,type:e,skipDownstreamReset:!0}]})),scopedTagNames:new Set(e.filter(function(e){e=_slicedToArray(e,2);e[0];return e[1].inScope}).map(function(e){return _slicedToArray(e,1)[0]}))}},w=(t=_).separator&&void 0!==t.levels?{separator:{decimal:".",dot:".",dash:"-",hyphen:"-",bracket:")",parenthesis:")"}[t.separator]||t.separator,levels:t.levels||6,sidebar:!!t.sidebar,debug:!!t.debug}:y(t.debug,o);w&&(p={separator:w.separator,levels:h(w.levels,w),sidebar:(t=w.sidebar,o=w,"boolean"!=typeof t?y(o.debug,a):t),debug:w.debug},e.beforeEach(function(e){if(m=!0){r=p;var r,t=(t=(n=e).match(/^\s*(?:@autoHeader:|<!--\s+autoHeader:)([\d.a-zA-Z\-:,~]*)(?:\s+-->)?/))?(n=n.substring(t[0].length),{headingSignifier:t[1],markdown:n}):y(r.debug,b);if(t){var n=t.headingSignifier,o=(e=t.markdown,h(w.levels,p));if(o){var a=d(n,p);if(a){var i,u={},s=_createForOfIteratorHelper(Object.keys(o).entries());try{for(s.s();!(i=s.n()).done;){var c=_slicedToArray(i.value,2),l=c[0],f=c[1];u[f]=_objectSpread(_objectSpread({},o[f]),a[l])}}catch(e){s.e(e)}finally{s.f()}p.levels=u}}}}return e}),p.sidebar?e.beforeEach(function(r,e){var t;try{t=n(p.levels,p,r,"markdown"),m||(t=r)}catch(e){t=r,console.warn(e.message)}finally{e(t)}}):e.afterEach(function(r,e){var t;try{t=n(p.levels,p,r,"html"),m||(t=r)}catch(e){t=r,console.warn(e.message)}finally{e(t)}}))}var _={separator:".",sidebar:!1,levels:6,debug:!1};window&&(window.$docsify=window.$docsify||{},window.$docsify.autoHeaders=Object.assign(_,window.$docsify.autoHeaders),window.$docsify.plugins=(window.$docsify.plugins||[]).concat(e))}();

package/package.json

@@ -1,25 +1,47 @@
 {
-	"name": "@markbattistella/docsify-autoheaders",
-	"version": "4.0.0",
-	"description": "Auto header numbering for docsify.js",
-	"main": "dist/docsify-autoHeaders.min.js",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/markbattistella/docsify-autoHeaders.git"
-	},
-	"author": "Mark Battistella",
-	"license": "MIT",
-	"bugs": {
-		"url": "https://github.com/markbattistella/docsify-autoHeaders/issues"
-	},
-	"homepage": "https://github.com/markbattistella/docsify-autoHeaders#readme",
-	"keywords": [
-		"auto numbering",
-		"headings",
-		"docsify",
-		"plugin"
-	],
-	"directories": {
-		"doc": "docs"
-	}
+  "name": "@markbattistella/docsify-autoheaders",
+  "version": "5.0.0",
+  "description": "Auto header numbering for docsify.js",
+  "main": "./dist/docsify-auto-headers.min.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/markbattistella/docsify-auto-headers.git"
+  },
+  "scripts": {
+    "launch": "docsify serve ./docs -o",
+    "update": "ncu -u && npm update && npm install",
+    "babel": "npx babel ./dist/docsify-auto-headers.js -o ./dist/docsify-auto-headers.babel.js",
+    "uglify": "uglifyjs ./dist/docsify-auto-headers.babel.js --verbose -c -m -o ./dist/docsify-auto-headers.min.js",
+    "minify": "npm run babel && npm run uglify",
+    "patch": "node ./.github/scripts/release.js -patch",
+    "minor": "node ./.github/scripts/release.js -minor",
+    "major": "node ./.github/scripts/release.js -major"
+  },
+  "devDependencies": {
+    "@babel/cli": "^7.24.7",
+    "@babel/core": "^7.24.7",
+    "@babel/preset-env": "^7.24.7",
+    "docsify-cli": "^4.4.4",
+    "jsonfile": "^6.1.0"
+  },
+  "babel": {
+    "presets": [
+      "@babel/env"
+    ]
+  },
+  "unpkg": "./dist/docsify-auto-headers.min.js",
+  "jsdelivr": "./dist/docsify-auto-headers.min.js",
+  "keywords": [
+    "auto numbering",
+    "headings",
+    "header",
+    "docsify",
+    "plugin"
+  ],
+  "author": "Mark Battistella",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/markbattistella/docsify-auto-headers/issues"
+  },
+  "homepage": "https://autoheader.docsify.markbattistella.com"
 }

package/.gitattributes

@@ -1,7 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto
-dist/* linguist-vendored=true
-*.js linguist-vendored=true
-*.md linguist-detectable=false
-*.html linguist-detectable=false
-*.css linguist-detectable=false

package/dist/docsify-autoHeaders.js

@@ -1,313 +0,0 @@
-/*! docsify-autoHeaders.js v4.0.0 | (c) Mark Battistella */
-'use strict';
-
-function getHeading( headingOptions ) {
-
-	// if it is empty
-	if(
-		!headingOptions.separator	&&
-		!headingOptions.levels		&&
-		!headingOptions.scope
-	) {
-		return 'No config set'
-	}
-
-	// blank separator
-	var separator = '';
-
-	// output the correct from words
-	switch (headingOptions.separator) {
-		case 'decimal':
-			separator = '.'
-			break;
-		case 'dash':
-			separator = '-'
-			break;
-		case 'bracket':
-			separator = ')'
-			break;
-		default:
-			return;
-	}
-
-	// get othe settings
-	let levels	= headingOptions.levels	? headingOptions.levels	: 6;
-	let scope	= headingOptions.scope	? headingOptions.scope	: "main";
-	let debug	= headingOptions.debug == true	? 1	: 0;
-
-	// return the array
-	return [ separator, levels, scope, debug ];
-}
-
-// defaults - and setup
-const headingOptions = {
-	separator:	'',
-	levels:		'',
-	scope:		''
-};
-
-
-// the function
-function autoHeaders( hook, vm ) {
-
-	// make the variables global
-	var getHeadingNumber = null;
-
-	// get the variables from the config
-	const	headingOptionsArray = getHeading( headingOptions ),
-
-			// create variables
-			arraySeparator	= headingOptionsArray[0],
-			arrayLevel		= headingOptionsArray[1],
-			arrayScope		= headingOptionsArray[2],
-			arrayDebug		= headingOptionsArray[3];
-
-	// reset counter
-	function resetBelowLevels( currentLevel ) {
-		// currentLevel is string so need to convert it to number
-		for( let i = +currentLevel + 1; i <= 6; i++ ) {
-			startingNumbers[i] = 0;
-		}
-	}
-
-	//
-	// MARK: - check if the document starts with the signifier
-	//
-
-	// get the `@autoHeader:` data
-	hook.beforeEach( function( content ) {
-
-		// get the first 12 characters
-		const getFirstCharacters = content.slice( 0, 12 );
-
-		// check if beginning with the plugin key
-		if( getFirstCharacters === "@autoHeader:" ) {
-
-			// get the first line of data
-			const getFirstLine = content.split( "\n" )[0];
-
-			// get everything after the `:`
-			getHeadingNumber = getFirstLine.split( ":" )[1];
-
-			// there is no data to continue
-			if(
-				!getHeadingNumber			||
-				getHeadingNumber == null	||
-				getHeadingNumber == ''
-			) {
-
-				// set the headerNumber to null
-				getHeadingNumber = null;
-
-			// transform the data
-			} else {
-
-				// make an array from the separator
-				getHeadingNumber = getHeadingNumber.split( arraySeparator );
-
-				// dont work with too many items in the array
-				if( getHeadingNumber.length > 6 ) {
-
-					// set the headerNumber to null
-					getHeadingNumber = null;
-
-				} else {
-
-					// pad in the extra array items
-					getHeadingNumber = getHeadingNumber.concat(
-						new Array(6)		// add a new array upto 6 items
-						.fill(0) )			// fill it with zeros
-						.slice(0, 6)		// cut off after 6 items
-						.map( x => +x );	// map the Strings to Int
-				}
-			}
-
-			// remove the line
-			var cleanedContent = content.replace( getFirstLine, '' );
-
-			// return the cleaned content
-			return cleanedContent;
-
-		} else {
-
-			// set the headerNumber to null
-			getHeadingNumber = null;
-		}
-	});
-
-
-	//
-	// MARK: - add the heading numbers
-	//
-
-	hook.doneEach( function() {
-
-		// set the scope of the automisation
-		const contentScope	= document.querySelector( arrayScope );
-
-		// if the scope is empty
-		if( !contentScope && arrayDebug ) {
-			console.log(	'--- autoHeaders error: start ---'  + '\n' +
-							'The "scope" entry is not valid :(' + '\n' +
-							'--- autoHeaders error: end  ---'
-						);
-
-			// exit out
-			return;
-		}
-
-		// MARK: - are we running autoHeaders
-		if( getHeadingNumber == null ) {
-
-			// if we're debugging
-			if( arrayDebug ) {
-				console.log( '--- autoHeaders error: start ---'    + '\n\n' +
-						 	'The "start" number is empty or null' + '\n' +
-						 	'Logged value: "' + getHeadingNumber + '" \n\n' +
-						 	'--- autoHeaders error: end  ---'
-							);
-			}
-
-		// no errors
-		} else {
-
-
-			// check if all the items in the array are numeric
-			if( !getHeadingNumber.every( isNaN ) ) {
-
-				// set the variable up
-				var validHeadingNumber	= '';
-
-				// get the headings into array
-				const 	contentHeaders	= contentScope.querySelectorAll(
-											'h1, h2, h3, h4, h5, h6'
-										),
-
-						// check if the array items are positive numbers
-						positiveNumber = (element) => ( element >= 0 ),
-
-						// rount the numbers down
-						roundDown = (element) => Math.floor( element );
-
-
-				// are the numbers all positive
-				if( getHeadingNumber.every( positiveNumber ) ) {
-
-					// set the starting values
-					// -- minus 1 since we add immediately in the loop
-					const startingNumbers	= [ 0,                       // null
-												getHeadingNumber[0] - 1, // h1
-												getHeadingNumber[1] - 1, // h2
-												getHeadingNumber[2] - 1, // h3
-												getHeadingNumber[3] - 1, // h4
-												getHeadingNumber[4] - 1, // h5
-												getHeadingNumber[5] - 1, // h6
-										];
-
-					// track the first run
-					let firstRun = [	true,	// null
-										true, 	// h1 run yet
-										true,	// h2 run yet
-										true,	// h3 run yet
-										true,	// h4 run yet
-										true,	// h5 run yet
-										true	// h6 run yet
-									];
-
-					// loop through all the elements inside scope
-					for( var item in contentHeaders ) {
-
-						// this element from item number
-						var element		= contentHeaders[item],
-							numberText	= '';
-
-						// limit the heading tag number in search
-						const headingRegex = new RegExp(	'^H([1-'	+
-															arrayLevel	+
-															'])$'
-														);
-
-						// does the element match a heading regex
-						if( !element			||
-							!element.tagName	||
-							!element.tagName.match( headingRegex )
-						) {
-
-							// return to beginning of loop
-							continue;
-						}
-
-						// return the heading level number
-						var elementLevel = RegExp.$1;
-
-						// add `1` to the array numbers
-						startingNumbers[elementLevel]++;
-
-						// reset all level below except for the first run
-					    if( !firstRun[ elementLevel ] ) {
-							resetBelowLevels( elementLevel );
-					    	firstRun[ elementLevel ] = false;
-						}
-
-						// loop through the headings
-						for(	var levelNumber = 1;
-								levelNumber <= 6;
-								levelNumber++
-						) {
-
-							// if the number is lt the element number
-							if( levelNumber <= elementLevel ) {
-								numberText += startingNumbers[levelNumber] + arraySeparator
-							}
-
-						}
-
-						// add the number outside the heading
-						// -- keep the anchor links :)
-						element.innerHTML =  numberText + ' ' + element.innerHTML.replace(/^[0-9\.\s]+/,'' );
-
-					}
-
-				} else {
-
-					// if we're debugging
-					if( arrayDebug ) {
-						console.log( '--- autoHeaders error: start ---'  + '\n\n' +
-								 	'The numbers are not positive' + '\n' +
-								 	'Value: "' + getHeadingNumber + '" \n\n' +
-								 	'--- autoHeaders error: end  ---'
-									);
-					}
-
-					// exit out
-					return;
-
-				}
-
-			// one of the items in the array is not numeric
-			} else {
-
-				// if we're debugging
-				if( arrayDebug ) {
-					console.log( '--- autoHeaders error: start ---'  + '\n\n' +
-							 	'The "start" number is not numeric' + '\n' +
-							 	'Value: "' + getHeadingNumber + '" \n\n' +
-							 	'--- autoHeaders error: end  ---'
-								);
-				}
-
-				// exit out
-				return;
-
-			}
-		}
-	});
-}
-
-
-// find heading plugin options
-window.$docsify.autoHeaders = Object.assign(
-	headingOptions,
-	window.$docsify.autoHeaders
-);
-window.$docsify.plugins = [].concat(autoHeaders, window.$docsify.plugins);

package/dist/docsify-autoHeaders.min.js

@@ -1,6 +0,0 @@
-/*
- docsify-autoHeaders.js v4.0.0 | (c) Mark Battistella */
-function getHeading(c){if(!c.separator&&!c.levels&&!c.scope)return"No config set";switch(c.separator){case "decimal":var g=".";break;case "dash":g="-";break;case "bracket":g=")";break;default:return}return[g,c.levels?c.levels:6,c.scope?c.scope:"main",1==c.debug?1:0]}var headingOptions={separator:"",levels:"",scope:""};
-function autoHeaders(c,g){function r(b){for(b=+b+1;6>=b;b++)startingNumbers[b]=0}var a=null,h=getHeading(headingOptions),n=h[0],t=h[1],u=h[2],k=h[3];c.beforeEach(function(b){if("@autoHeader:"===b.slice(0,12)){var e=b.split("\n")[0];(a=e.split(":")[1])&&null!=a&&""!=a?(a=a.split(n),a=6<a.length?null:a.concat(Array(6).fill(0)).slice(0,6).map(function(l){return+l})):a=null;return b.replace(e,"")}a=null});c.doneEach(function(){var b=document.querySelector(u);if(!b&&k)console.log('--- autoHeaders error: start ---\nThe "scope" entry is not valid :(\n--- autoHeaders error: end  ---');
-else if(null==a)k&&console.log('--- autoHeaders error: start ---\n\nThe "start" number is empty or null\nLogged value: "'+a+'" \n\n--- autoHeaders error: end  ---');else if(a.every(isNaN))k&&console.log('--- autoHeaders error: start ---\n\nThe "start" number is not numeric\nValue: "'+a+'" \n\n--- autoHeaders error: end  ---');else if(b=b.querySelectorAll("h1, h2, h3, h4, h5, h6"),a.every(function(v){return 0<=v})){var e=[0,a[0]-1,a[1]-1,a[2]-1,a[3]-1,a[4]-1,a[5]-1],l=[!0,!0,!0,!0,!0,!0,!0],p;for(p in b){var f=
-b[p],q="",d=new RegExp("^H([1-"+t+"])$");if(f&&f.tagName&&f.tagName.match(d)){d=RegExp.$1;e[d]++;l[d]||(r(d),l[d]=!1);for(var m=1;6>=m;m++)m<=d&&(q+=e[m]+n);f.innerHTML=q+" "+f.innerHTML.replace(/^[0-9\.\s]+/,"")}}}else k&&console.log('--- autoHeaders error: start ---\n\nThe numbers are not positive\nValue: "'+a+'" \n\n--- autoHeaders error: end  ---')})}window.$docsify.autoHeaders=Object.assign(headingOptions,window.$docsify.autoHeaders);window.$docsify.plugins=[].concat(autoHeaders,window.$docsify.plugins);