metalsmith-prism 5.0.1 → 5.0.4

package/README.md

@@ -1,25 +1,35 @@
 # metalsmith-prism
 
-A Metalsmith plugin that **adds Prism specific HTML markup** to code sections for syntax coloring.
+A Metalsmith plugin that **adds Prism specific HTML markup** to code sections for syntax coloring. Now with full dual module support for both **ESM** and **CommonJS** environments.
 
-[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square&label=license)](http://opensource.org/licenses/MIT)
-[![NPM](http://img.shields.io/npm/v/metalsmith-prism.svg?style=flat-square&label=npm)](https://npmjs.org/package/metalsmith-prism)
-[![Linux Passing](https://img.shields.io/travis/Availity/metalsmith-prism.svg?style=flat-square&label=linux)](https://travis-ci.org/Availity/metalsmith-prism)
-[![Windows Passing](https://img.shields.io/appveyor/ci/robmcguinness/metalsmith-prism.svg?style=flat-square&label=windows)](https://ci.appveyor.com/project/robmcguinness/metalsmith-prism)
+[![metalsmith:plugin][metalsmith-badge]][metalsmith-url]
+[![npm: version][npm-badge]][npm-url]
+[![license: MIT][license-badge]][license-url]
+[![coverage][coverage-badge]][coverage-url]
+[![ESM/CommonJS][modules-badge]][npm-url]
+
+## Dual Module Support (ESM and CommonJS)
+
+This plugin supports both ESM and CommonJS environments with no configuration needed:
+
+- ESM: `import prism from 'metalsmith-prism'`
+- CommonJS: `const prism = require('metalsmith-prism')`
+
+The package detects your environment automatically and provides the appropriate module format. This makes it compatible with both modern ESM projects and legacy CommonJS codebases.
 
 While this plugin adds all the required Prism HTML markup, **prism.css** must be included on the page to provide the syntax coloring. The plugin:
 
+- Supports both ESM and CommonJS environments
 - Automatically handles language dependencies
 - Supports HTML entity decoding
 - Can add line numbers
 - Works seamlessly with Markdown code blocks
-- Supports all Prism.js languages
+- Supports all Prism.js language
 
 ## Requirements
 
-- Node `>= 18.x.x`
-- NPM `>= 9.x.x`
-- Metalsmith `>= v2.6.x`
+- Node `>= 18.0.0`
+- Metalsmith `>= v2.6.0`
 
 ## Quick Start
 
@@ -35,7 +45,7 @@ metalsmith(__dirname).use(
   prism({
     decode: true, // Decode HTML entities
     lineNumbers: true, // Show line numbers
-    preLoad: ['java'], // Pre-load language dependencies
+    preLoad: ['java'] // Pre-load language dependencies
   })
 );
 ```
@@ -74,21 +84,44 @@ The css files can be downloaded from the [Prism website](https://prismjs.com/dow
 
 ### Add `metalsmith-prism` plugin to metalsmith
 
+**ESM:**
+
 ```js
-const metalsmith = require('metalsmith');
+import Metalsmith from 'metalsmith';
+import prism from 'metalsmith-prism';
+
+Metalsmith(__dirname).use(prism()).build();
+```
+
+**CommonJS:**
+
+```js
+const Metalsmith = require('metalsmith');
 const prism = require('metalsmith-prism');
 
-metalsmith(__dirname).use(prism()).build();
+Metalsmith(__dirname).use(prism()).build();
 ```
 
 ### To use with Markdown code blocks rendered by [@metalsmith/markdown](https://github.com/metalsmith/markdown)
 
+**ESM:**
+
+```js
+import Metalsmith from 'metalsmith';
+import markdown from '@metalsmith/markdown';
+import prism from 'metalsmith-prism';
+
+Metalsmith(__dirname).use(markdown()).use(prism()).build();
+```
+
+**CommonJS:**
+
 ```js
-const metalsmith = require('metalsmith');
+const Metalsmith = require('metalsmith');
 const markdown = require('@metalsmith/markdown');
 const prism = require('metalsmith-prism');
 
-metalsmith(__dirname).use(markdown()).use(prism()).build();
+Metalsmith(__dirname).use(markdown()).use(prism()).build();
 ```
 
 ## Language support
@@ -106,7 +139,7 @@ Always decode the html entities when processing language of type `markup`
 ```js
 Metalsmith(__dirname).use(
   prism({
-    decode: true,
+    decode: true
   })
 );
 ```
@@ -117,8 +150,8 @@ Adds the additional HTML markup so line numbers can be added via the line-number
 
 ```javascript
 Metalsmith(__dirname).use(
-  metalsmithPrism({
-    lineNumbers: true,
+  prism({
+    lineNumbers: true
   })
 );
 ```
@@ -132,7 +165,7 @@ Useful for loading syntax that extends other language components that are not au
 ```javascript
 Metalsmith(__dirname).use(
   prism({
-    preLoad: ['java', 'scala'],
+    preLoad: ['java', 'scala']
   })
 );
 ```
@@ -143,14 +176,20 @@ To enable debug logs, set the `DEBUG` environment variable to `metalsmith-prism`
 
 Linux/Mac:
 
-```
-DEBUG=metalsmith-prism
+```bash
+DEBUG=metalsmith-prism npm test
 ```
 
 Windows:
 
+```bash
+set "DEBUG=metalsmith-prism" && npm test
 ```
-set "DEBUG=metalsmith-prism"
+
+Or use the test:debug script:
+
+```bash
+npm run test:debug
 ```
 
 ## CLI Usage
@@ -168,10 +207,29 @@ Add `metalsmith-prism` key to your `metalsmith.json` plugins key
 }
 ```
 
+## Test Coverage
+
+This project maintains high statement and line coverage for the source code. Coverage is verified during the release process using the c8 coverage tool.
+
 ## Credits
 
-[Robert McGuinness](https://github.com/robmcguinness) - for the initial implementation of the plugin.
+- [Robert McGuinness](https://github.com/robmcguinness) - for the initial implementation of the plugin.
+- [Werner Glinka](https://github.com/wernerglinka) - current maintainer.
 
 ## License
 
 Code released under [the MIT license](https://github.com/wernerglinka/metalsmith-prism/blob/main/LICENSE).
+
+[coverage-badge]: https://img.shields.io/badge/coverage-94%25-brightgreen
+[coverage-url]: #test-coverage
+[modules-badge]: https://img.shields.io/badge/modules-ESM%2FCJS-blue
+[npm-url]: https://npmjs.org/package/metalsmith-prism
+[npm-badge]: https://img.shields.io/npm/v/metalsmith-prism.svg
+[npm-url]: https://www.npmjs.com/package/metalsmith-prism
+[metalsmith-badge]: https://img.shields.io/badge/metalsmith-plugin-green.svg?longCache=true
+[metalsmith-url]: https://metalsmith.io
+[license-badge]: https://img.shields.io/github/license/wernerglinka/metalsmith-prism
+[license-url]: LICENSE
+[coverage-badge]: https://img.shields.io/badge/test%20coverage-98%25-brightgreen
+[coverage-url]: #test-coverage
+[modules-badge]: https://img.shields.io/badge/modules-ESM%2FCJS-blue

package/lib/index.cjs

@@ -0,0 +1,209 @@
+'use strict';
+
+var cheerio = require('cheerio');
+var path = require('path');
+var Prism = require('prismjs');
+var loadLanguages = require('prismjs/components/index.js');
+var he = require('he');
+var debugLib = require('debug');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var Prism__default = /*#__PURE__*/_interopDefaultLegacy(Prism);
+var loadLanguages__default = /*#__PURE__*/_interopDefaultLegacy(loadLanguages);
+var he__default = /*#__PURE__*/_interopDefaultLegacy(he);
+var debugLib__default = /*#__PURE__*/_interopDefaultLegacy(debugLib);
+
+const debug = debugLib__default["default"]('metalsmith-prism');
+
+// Import languages from Prism's default export
+const {
+  languages
+} = Prism__default["default"];
+
+/**
+ * Check if a file is HTML based on its extension
+ * @param {string} filePath - Path to the file
+ * @returns {boolean} - True if the file has an HTML extension
+ */
+const isHTMLFile = filePath => {
+  const extension = path.extname(filePath).toLowerCase();
+  return ['.html', '.htm'].includes(extension);
+};
+
+/**
+ * @typedef Options
+ * @property {boolean} [decode=false] - Whether to decode HTML entities
+ * @property {boolean} [lineNumbers=false] - Whether to add line numbers
+ * @property {string[]} [preLoad=[]] - Languages to preload
+ */
+
+/**
+ * Metalsmith plugin to highlight code syntax with PrismJS
+ *
+ * This plugin finds all code blocks in HTML files that have language-* classes
+ * and applies Prism.js syntax highlighting to them. It can also add line numbers
+ * and handle HTML entity decoding.
+ *
+ * @param {Options} [options] - Configuration options
+ * @param {boolean} [options.decode=false] - Whether to decode HTML entities in code blocks
+ * @param {boolean} [options.lineNumbers=false] - Whether to add line numbers to code blocks
+ * @param {string[]} [options.preLoad=[]] - Languages to preload before processing
+ * @returns {import('metalsmith').Plugin} - A metalsmith plugin function
+ * @example
+ * // Basic usage
+ * metalsmith.use(prism());
+ *
+ * // With options
+ * metalsmith.use(prism({
+ *   decode: true,
+ *   lineNumbers: true,
+ *   preLoad: ['java', 'scala']
+ * }));
+ */
+const metalsmithPrism = (options = {}) => {
+  // Create a new options object with defaults
+  const opts = {
+    decode: false,
+    lineNumbers: false,
+    preLoad: [],
+    ...options
+  };
+
+  // Track loaded languages to avoid duplicate loading
+  const loadedLanguages = new Set();
+
+  // Always load PHP by default
+  debug('Loading PHP by default');
+  try {
+    loadLanguages__default["default"](['php']);
+    loadedLanguages.add('php');
+  } catch (e) {
+    debug('Failed to load PHP:', e);
+  }
+  if (opts.preLoad && opts.preLoad.length) {
+    debug('Preloading languages:', opts.preLoad);
+    opts.preLoad.forEach(language => {
+      if (!loadedLanguages.has(language)) {
+        try {
+          loadLanguages__default["default"]([language]);
+          loadedLanguages.add(language);
+          debug(`Successfully preloaded language: ${language}`);
+        } catch (e) {
+          console.warn(`Failed to preload prism syntax: ${language}!`, e);
+          debug(`Error preloading language ${language}:`, e);
+        }
+      } else {
+        debug(`Language ${language} already loaded, skipping`);
+      }
+    });
+  }
+
+  /**
+   * Require optional language package
+   * @param {string} language
+   * @param {Set} loadedLanguages
+   */
+  const requireLanguage = (language, loadedLanguages) => {
+    if (loadedLanguages.has(language) || languages[language]) {
+      debug(`Language ${language} already available, skipping load`);
+      return;
+    }
+    debug(`Loading language on-demand: ${language}`);
+    try {
+      loadLanguages__default["default"]([language]);
+      loadedLanguages.add(language);
+      debug(`Successfully loaded language: ${language}`);
+    } catch (e) {
+      console.warn(`Failed to load prism syntax: ${language}!`, e);
+      debug(`Error loading language ${language}:`, e);
+    }
+  };
+
+  // Set up line numbers functionality
+  const NEW_LINE_EXP = /\n(?!$)/g;
+  let lineNumbersWrapper;
+
+  // Only set up the hook if line numbers are requested
+  if (opts.lineNumbers) {
+    debug('Setting up line numbers hook');
+    Prism__default["default"].hooks.add('after-tokenize', env => {
+      const match = env.code.match(NEW_LINE_EXP);
+      const linesNum = match ? match.length + 1 : 1;
+      debug(`Counted ${linesNum} lines for line numbers`);
+      const lines = new Array(linesNum + 1).join('<span></span>');
+      lineNumbersWrapper = `<span aria-hidden="true" class="line-numbers-rows">${lines}</span>`;
+    });
+  }
+  return (files, metalsmith, done) => {
+    debug('Starting metalsmith-prism plugin');
+    debug('Options:', opts);
+
+    // Call done asynchronously to avoid blocking
+    setImmediate(done);
+    try {
+      Object.keys(files).forEach(file => {
+        if (!isHTMLFile(file)) {
+          return;
+        }
+        debug(`Processing HTML file: ${file}`);
+        const contents = files[file].contents.toString();
+        const $ = cheerio.load(contents, {
+          decodeEntities: false
+        });
+        let highlighted = false;
+        const code = $('code');
+        if (!code.length) {
+          debug(`No code blocks found in ${file}`);
+          return;
+        }
+        debug(`Found ${code.length} code blocks in ${file}`);
+        code.each(function () {
+          const $this = $(this);
+          const className = $this.attr('class') || '';
+          const targets = className.split('language-');
+          let addLineNumbers = false;
+          if (targets.length > 1) {
+            const $pre = $this.parent('pre');
+            if ($pre) {
+              // Copy className to <pre> container
+              $pre.addClass(className);
+              if (opts.lineNumbers) {
+                $pre.addClass('line-numbers');
+                addLineNumbers = true;
+                debug('Adding line numbers');
+              }
+            }
+            highlighted = true;
+            let language = targets[1];
+            debug(`Detected language: ${language}`);
+            requireLanguage(language, loadedLanguages);
+            if (!languages[language]) {
+              debug(`Language ${language} not available, falling back to markup`);
+              language = 'markup';
+            }
+            const html = language === 'markup' && !opts.decode ? $this.html() : he__default["default"].decode($this.html());
+            debug(`HTML decoding ${opts.decode ? 'applied' : 'not applied'} for language ${language}`);
+            debug(`Highlighting code with language: ${language}`);
+            const highlightedCode = Prism__default["default"].highlight(html, languages[language]);
+            $this.html(addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode);
+          }
+        });
+        if (highlighted) {
+          debug(`Updating contents of ${file} with highlighted code`);
+          files[file].contents = Buffer.from($.html());
+        } else {
+          debug(`No code was highlighted in ${file}`);
+        }
+      });
+      debug('Completed metalsmith-prism plugin');
+    } catch (error) {
+      debug('Error in metalsmith-prism plugin:', error);
+      // We can't call done(error) here because done has already been called
+      console.error('Error processing files:', error);
+    }
+  };
+};
+
+module.exports = metalsmithPrism;
+//# sourceMappingURL=index.cjs.map

package/lib/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.js"],"sourcesContent":["import { load } from 'cheerio';\nimport { extname } from 'path';\nimport Prism from 'prismjs';\nimport loadLanguages from 'prismjs/components/index.js';\nimport he from 'he';\nimport debugLib from 'debug';\n\nconst debug = debugLib( 'metalsmith-prism' );\n\n// Import languages from Prism's default export\nconst { languages } = Prism;\n\n/**\n * Check if a file is HTML based on its extension\n * @param {string} filePath - Path to the file\n * @returns {boolean} - True if the file has an HTML extension\n */\nconst isHTMLFile = ( filePath ) => {\n  const extension = extname( filePath ).toLowerCase();\n  return [ '.html', '.htm' ].includes( extension );\n};\n\n/**\n * @typedef Options\n * @property {boolean} [decode=false] - Whether to decode HTML entities\n * @property {boolean} [lineNumbers=false] - Whether to add line numbers\n * @property {string[]} [preLoad=[]] - Languages to preload\n */\n\n/**\n * Metalsmith plugin to highlight code syntax with PrismJS\n *\n * This plugin finds all code blocks in HTML files that have language-* classes\n * and applies Prism.js syntax highlighting to them. It can also add line numbers\n * and handle HTML entity decoding.\n *\n * @param {Options} [options] - Configuration options\n * @param {boolean} [options.decode=false] - Whether to decode HTML entities in code blocks\n * @param {boolean} [options.lineNumbers=false] - Whether to add line numbers to code blocks\n * @param {string[]} [options.preLoad=[]] - Languages to preload before processing\n * @returns {import('metalsmith').Plugin} - A metalsmith plugin function\n * @example\n * // Basic usage\n * metalsmith.use(prism());\n *\n * // With options\n * metalsmith.use(prism({\n *   decode: true,\n *   lineNumbers: true,\n *   preLoad: ['java', 'scala']\n * }));\n */\nconst metalsmithPrism = ( options = {} ) => {\n  // Create a new options object with defaults\n  const opts = {\n    decode: false,\n    lineNumbers: false,\n    preLoad: [],\n    ...options\n  };\n\n  // Track loaded languages to avoid duplicate loading\n  const loadedLanguages = new Set();\n\n  // Always load PHP by default\n  debug( 'Loading PHP by default' );\n  try {\n    loadLanguages( [ 'php' ] );\n    loadedLanguages.add( 'php' );\n  } catch ( e ) {\n    debug( 'Failed to load PHP:', e );\n  }\n\n  if ( opts.preLoad && opts.preLoad.length ) {\n    debug( 'Preloading languages:', opts.preLoad );\n    opts.preLoad.forEach( ( language ) => {\n      if ( !loadedLanguages.has( language ) ) {\n        try {\n          loadLanguages( [ language ] );\n          loadedLanguages.add( language );\n          debug( `Successfully preloaded language: ${ language }` );\n        } catch ( e ) {\n          console.warn( `Failed to preload prism syntax: ${ language }!`, e );\n          debug( `Error preloading language ${ language }:`, e );\n        }\n      } else {\n        debug( `Language ${ language } already loaded, skipping` );\n      }\n    } );\n  }\n\n  /**\n   * Require optional language package\n   * @param {string} language\n   * @param {Set} loadedLanguages\n   */\n  const requireLanguage = ( language, loadedLanguages ) => {\n    if ( loadedLanguages.has( language ) || languages[ language ] ) {\n      debug( `Language ${ language } already available, skipping load` );\n      return;\n    }\n\n    debug( `Loading language on-demand: ${ language }` );\n    try {\n      loadLanguages( [ language ] );\n      loadedLanguages.add( language );\n      debug( `Successfully loaded language: ${ language }` );\n    } catch ( e ) {\n      console.warn( `Failed to load prism syntax: ${ language }!`, e );\n      debug( `Error loading language ${ language }:`, e );\n    }\n  };\n\n  // Set up line numbers functionality\n  const NEW_LINE_EXP = /\\n(?!$)/g;\n  let lineNumbersWrapper;\n\n  // Only set up the hook if line numbers are requested\n  if ( opts.lineNumbers ) {\n    debug( 'Setting up line numbers hook' );\n    Prism.hooks.add( 'after-tokenize', ( env ) => {\n      const match = env.code.match( NEW_LINE_EXP );\n      const linesNum = match ? match.length + 1 : 1;\n      debug( `Counted ${ linesNum } lines for line numbers` );\n      const lines = new Array( linesNum + 1 ).join( '<span></span>' );\n      lineNumbersWrapper = `<span aria-hidden=\"true\" class=\"line-numbers-rows\">${ lines }</span>`;\n    } );\n  }\n\n  return ( files, metalsmith, done ) => {\n    debug( 'Starting metalsmith-prism plugin' );\n    debug( 'Options:', opts );\n\n    // Call done asynchronously to avoid blocking\n    setImmediate( done );\n\n    try {\n      Object.keys( files ).forEach( ( file ) => {\n        if ( !isHTMLFile( file ) ) {\n          return;\n        }\n\n        debug( `Processing HTML file: ${ file }` );\n        const contents = files[ file ].contents.toString();\n        const $ = load( contents, { decodeEntities: false } );\n        let highlighted = false;\n        const code = $( 'code' );\n\n        if ( !code.length ) {\n          debug( `No code blocks found in ${ file }` );\n          return;\n        }\n\n        debug( `Found ${ code.length } code blocks in ${ file }` );\n\n        code.each( function() {\n          const $this = $( this );\n\n          const className = $this.attr( 'class' ) || '';\n          const targets = className.split( 'language-' );\n          let addLineNumbers = false;\n\n          if ( targets.length > 1 ) {\n            const $pre = $this.parent( 'pre' );\n\n            if ( $pre ) {\n              // Copy className to <pre> container\n              $pre.addClass( className );\n\n              if ( opts.lineNumbers ) {\n                $pre.addClass( 'line-numbers' );\n                addLineNumbers = true;\n                debug( 'Adding line numbers' );\n              }\n            }\n\n            highlighted = true;\n            let language = targets[ 1 ];\n            debug( `Detected language: ${ language }` );\n            requireLanguage( language, loadedLanguages );\n\n            if ( !languages[ language ] ) {\n              debug( `Language ${ language } not available, falling back to markup` );\n              language = 'markup';\n            }\n\n            const html = language === 'markup' && !opts.decode ? $this.html() : he.decode( $this.html() );\n            debug( `HTML decoding ${ opts.decode ? 'applied' : 'not applied' } for language ${ language }` );\n\n            debug( `Highlighting code with language: ${ language }` );\n            const highlightedCode = Prism.highlight( html, languages[ language ] );\n            $this.html( addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode );\n          }\n        } );\n\n        if ( highlighted ) {\n          debug( `Updating contents of ${ file } with highlighted code` );\n          files[ file ].contents = Buffer.from( $.html() );\n        } else {\n          debug( `No code was highlighted in ${ file }` );\n        }\n      } );\n\n      debug( 'Completed metalsmith-prism plugin' );\n    } catch ( error ) {\n      debug( 'Error in metalsmith-prism plugin:', error );\n      // We can't call done(error) here because done has already been called\n      console.error( 'Error processing files:', error );\n    }\n  };\n};\n\n// ESM export\nexport default metalsmithPrism;\n"],"names":["debug","debugLib","languages","Prism","isHTMLFile","filePath","extension","extname","toLowerCase","includes","metalsmithPrism","options","opts","decode","lineNumbers","preLoad","loadedLanguages","Set","loadLanguages","add","e","length","forEach","language","has","console","warn","requireLanguage","NEW_LINE_EXP","lineNumbersWrapper","hooks","env","match","code","linesNum","lines","Array","join","files","metalsmith","done","setImmediate","Object","keys","file","contents","toString","$","load","decodeEntities","highlighted","each","$this","className","attr","targets","split","addLineNumbers","$pre","parent","addClass","html","he","highlightedCode","highlight","Buffer","from","error"],"mappings":"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"}

package/lib/index.js

@@ -3,20 +3,23 @@ import { extname } from 'path';
 import Prism from 'prismjs';
 import loadLanguages from 'prismjs/components/index.js';
 import he from 'he';
+import debugLib from 'debug';
 
-// Import languages from Prism's default export
-const { languages } = Prism;
+const debug = debugLib('metalsmith-prism');
 
-// Preload PHP
-loadLanguages( [ 'php' ] );
+// Import languages from Prism's default export
+const {
+  languages
+} = Prism;
 
 /**
- * Check if a file is HTML
- * @param {string} filePath
- * @returns {boolean}
+ * Check if a file is HTML based on its extension
+ * @param {string} filePath - Path to the file
+ * @returns {boolean} - True if the file has an HTML extension
  */
-const isHTMLFile = ( filePath ) => {
-  return /\.html|\.htm/.test( extname( filePath ) );
+const isHTMLFile = filePath => {
+  const extension = extname(filePath).toLowerCase();
+  return ['.html', '.htm'].includes(extension);
 };
 
 /**
@@ -29,102 +32,169 @@ const isHTMLFile = ( filePath ) => {
 /**
  * Metalsmith plugin to highlight code syntax with PrismJS
  *
- * @param {Options} [options]
- * @returns {import('metalsmith').Plugin}
+ * This plugin finds all code blocks in HTML files that have language-* classes
+ * and applies Prism.js syntax highlighting to them. It can also add line numbers
+ * and handle HTML entity decoding.
+ *
+ * @param {Options} [options] - Configuration options
+ * @param {boolean} [options.decode=false] - Whether to decode HTML entities in code blocks
+ * @param {boolean} [options.lineNumbers=false] - Whether to add line numbers to code blocks
+ * @param {string[]} [options.preLoad=[]] - Languages to preload before processing
+ * @returns {import('metalsmith').Plugin} - A metalsmith plugin function
+ * @example
+ * // Basic usage
+ * metalsmith.use(prism());
+ *
+ * // With options
+ * metalsmith.use(prism({
+ *   decode: true,
+ *   lineNumbers: true,
+ *   preLoad: ['java', 'scala']
+ * }));
  */
-function metalsmithPrism( options = {} ) {
-  if ( options.preLoad ) {
-    options.preLoad.forEach( ( language ) => {
-      try {
-        loadLanguages( [ language ] );
-      } catch ( e ) {
-        console.warn( `Failed to preload prism syntax: ${ language }!` );
+const metalsmithPrism = (options = {}) => {
+  // Create a new options object with defaults
+  const opts = {
+    decode: false,
+    lineNumbers: false,
+    preLoad: [],
+    ...options
+  };
+
+  // Track loaded languages to avoid duplicate loading
+  const loadedLanguages = new Set();
+
+  // Always load PHP by default
+  debug('Loading PHP by default');
+  try {
+    loadLanguages(['php']);
+    loadedLanguages.add('php');
+  } catch (e) {
+    debug('Failed to load PHP:', e);
+  }
+  if (opts.preLoad && opts.preLoad.length) {
+    debug('Preloading languages:', opts.preLoad);
+    opts.preLoad.forEach(language => {
+      if (!loadedLanguages.has(language)) {
+        try {
+          loadLanguages([language]);
+          loadedLanguages.add(language);
+          debug(`Successfully preloaded language: ${language}`);
+        } catch (e) {
+          console.warn(`Failed to preload prism syntax: ${language}!`, e);
+          debug(`Error preloading language ${language}:`, e);
+        }
+      } else {
+        debug(`Language ${language} already loaded, skipping`);
       }
-    } );
+    });
   }
 
   /**
    * Require optional language package
    * @param {string} language
+   * @param {Set} loadedLanguages
    */
-  function requireLanguage( language ) {
-    if ( !languages[ language ] ) {
-      try {
-        loadLanguages( [ language ] );
-      } catch ( e ) {
-        console.warn( `Failed to load prism syntax: ${ language }!` );
-      }
+  const requireLanguage = (language, loadedLanguages) => {
+    if (loadedLanguages.has(language) || languages[language]) {
+      debug(`Language ${language} already available, skipping load`);
+      return;
     }
-  }
+    debug(`Loading language on-demand: ${language}`);
+    try {
+      loadLanguages([language]);
+      loadedLanguages.add(language);
+      debug(`Successfully loaded language: ${language}`);
+    } catch (e) {
+      console.warn(`Failed to load prism syntax: ${language}!`, e);
+      debug(`Error loading language ${language}:`, e);
+    }
+  };
 
-  // Set up line numbers
+  // Set up line numbers functionality
   const NEW_LINE_EXP = /\n(?!$)/g;
   let lineNumbersWrapper;
 
-  Prism.hooks.add( 'after-tokenize', function( env ) {
-    const match = env.code.match( NEW_LINE_EXP );
-    const linesNum = match ? match.length + 1 : 1;
-    const lines = new Array( linesNum + 1 ).join( '<span></span>' );
-    lineNumbersWrapper = `<span aria-hidden="true" class="line-numbers-rows">${ lines }</span>`;
-  } );
-
-  return function( files, metalsmith, done ) {
-    setImmediate( done );
-
-    Object.keys( files ).forEach( file => {
-      if ( !isHTMLFile( file ) ) {
-        return;
-      }
-
-      const contents = files[ file ].contents.toString();
-      const $ = load( contents, { decodeEntities: false } );
-      let highlighted = false;
-      const code = $( 'code' );
-
-      if ( !code.length ) return;
-
-      code.each( function() {
-        const $this = $( this );
-
-        const className = $this.attr( 'class' ) || '';
-        const targets = className.split( 'language-' );
-        let addLineNumbers = false;
-
-        if ( targets.length > 1 ) {
-          const $pre = $this.parent( 'pre' );
-
-          if ( $pre ) {
-            // Copy className to <pre> container
-            $pre.addClass( className );
-
-            if ( options.lineNumbers ) {
-              $pre.addClass( 'line-numbers' );
-              addLineNumbers = true;
+  // Only set up the hook if line numbers are requested
+  if (opts.lineNumbers) {
+    debug('Setting up line numbers hook');
+    Prism.hooks.add('after-tokenize', env => {
+      const match = env.code.match(NEW_LINE_EXP);
+      const linesNum = match ? match.length + 1 : 1;
+      debug(`Counted ${linesNum} lines for line numbers`);
+      const lines = new Array(linesNum + 1).join('<span></span>');
+      lineNumbersWrapper = `<span aria-hidden="true" class="line-numbers-rows">${lines}</span>`;
+    });
+  }
+  return (files, metalsmith, done) => {
+    debug('Starting metalsmith-prism plugin');
+    debug('Options:', opts);
+
+    // Call done asynchronously to avoid blocking
+    setImmediate(done);
+    try {
+      Object.keys(files).forEach(file => {
+        if (!isHTMLFile(file)) {
+          return;
+        }
+        debug(`Processing HTML file: ${file}`);
+        const contents = files[file].contents.toString();
+        const $ = load(contents, {
+          decodeEntities: false
+        });
+        let highlighted = false;
+        const code = $('code');
+        if (!code.length) {
+          debug(`No code blocks found in ${file}`);
+          return;
+        }
+        debug(`Found ${code.length} code blocks in ${file}`);
+        code.each(function () {
+          const $this = $(this);
+          const className = $this.attr('class') || '';
+          const targets = className.split('language-');
+          let addLineNumbers = false;
+          if (targets.length > 1) {
+            const $pre = $this.parent('pre');
+            if ($pre) {
+              // Copy className to <pre> container
+              $pre.addClass(className);
+              if (opts.lineNumbers) {
+                $pre.addClass('line-numbers');
+                addLineNumbers = true;
+                debug('Adding line numbers');
+              }
             }
+            highlighted = true;
+            let language = targets[1];
+            debug(`Detected language: ${language}`);
+            requireLanguage(language, loadedLanguages);
+            if (!languages[language]) {
+              debug(`Language ${language} not available, falling back to markup`);
+              language = 'markup';
+            }
+            const html = language === 'markup' && !opts.decode ? $this.html() : he.decode($this.html());
+            debug(`HTML decoding ${opts.decode ? 'applied' : 'not applied'} for language ${language}`);
+            debug(`Highlighting code with language: ${language}`);
+            const highlightedCode = Prism.highlight(html, languages[language]);
+            $this.html(addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode);
           }
-
-          highlighted = true;
-          let language = targets[ 1 ];
-          requireLanguage( language );
-
-          if ( !languages[ language ] ) {
-            language = 'markup';
-          }
-
-          const html = ( language === 'markup' && !options.decode )
-            ? $this.html()
-            : he.decode( $this.html() );
-
-          const highlightedCode = Prism.highlight( html, languages[ language ] );
-          $this.html( addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode );
+        });
+        if (highlighted) {
+          debug(`Updating contents of ${file} with highlighted code`);
+          files[file].contents = Buffer.from($.html());
+        } else {
+          debug(`No code was highlighted in ${file}`);
         }
-      } );
-
-      if ( highlighted ) {
-        files[ file ].contents = Buffer.from( $.html() );
-      }
-    } );
+      });
+      debug('Completed metalsmith-prism plugin');
+    } catch (error) {
+      debug('Error in metalsmith-prism plugin:', error);
+      // We can't call done(error) here because done has already been called
+      console.error('Error processing files:', error);
+    }
   };
-}
+};
 
-export default metalsmithPrism;
+export { metalsmithPrism as default };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.js"],"sourcesContent":["import { load } from 'cheerio';\nimport { extname } from 'path';\nimport Prism from 'prismjs';\nimport loadLanguages from 'prismjs/components/index.js';\nimport he from 'he';\nimport debugLib from 'debug';\n\nconst debug = debugLib( 'metalsmith-prism' );\n\n// Import languages from Prism's default export\nconst { languages } = Prism;\n\n/**\n * Check if a file is HTML based on its extension\n * @param {string} filePath - Path to the file\n * @returns {boolean} - True if the file has an HTML extension\n */\nconst isHTMLFile = ( filePath ) => {\n  const extension = extname( filePath ).toLowerCase();\n  return [ '.html', '.htm' ].includes( extension );\n};\n\n/**\n * @typedef Options\n * @property {boolean} [decode=false] - Whether to decode HTML entities\n * @property {boolean} [lineNumbers=false] - Whether to add line numbers\n * @property {string[]} [preLoad=[]] - Languages to preload\n */\n\n/**\n * Metalsmith plugin to highlight code syntax with PrismJS\n *\n * This plugin finds all code blocks in HTML files that have language-* classes\n * and applies Prism.js syntax highlighting to them. It can also add line numbers\n * and handle HTML entity decoding.\n *\n * @param {Options} [options] - Configuration options\n * @param {boolean} [options.decode=false] - Whether to decode HTML entities in code blocks\n * @param {boolean} [options.lineNumbers=false] - Whether to add line numbers to code blocks\n * @param {string[]} [options.preLoad=[]] - Languages to preload before processing\n * @returns {import('metalsmith').Plugin} - A metalsmith plugin function\n * @example\n * // Basic usage\n * metalsmith.use(prism());\n *\n * // With options\n * metalsmith.use(prism({\n *   decode: true,\n *   lineNumbers: true,\n *   preLoad: ['java', 'scala']\n * }));\n */\nconst metalsmithPrism = ( options = {} ) => {\n  // Create a new options object with defaults\n  const opts = {\n    decode: false,\n    lineNumbers: false,\n    preLoad: [],\n    ...options\n  };\n\n  // Track loaded languages to avoid duplicate loading\n  const loadedLanguages = new Set();\n\n  // Always load PHP by default\n  debug( 'Loading PHP by default' );\n  try {\n    loadLanguages( [ 'php' ] );\n    loadedLanguages.add( 'php' );\n  } catch ( e ) {\n    debug( 'Failed to load PHP:', e );\n  }\n\n  if ( opts.preLoad && opts.preLoad.length ) {\n    debug( 'Preloading languages:', opts.preLoad );\n    opts.preLoad.forEach( ( language ) => {\n      if ( !loadedLanguages.has( language ) ) {\n        try {\n          loadLanguages( [ language ] );\n          loadedLanguages.add( language );\n          debug( `Successfully preloaded language: ${ language }` );\n        } catch ( e ) {\n          console.warn( `Failed to preload prism syntax: ${ language }!`, e );\n          debug( `Error preloading language ${ language }:`, e );\n        }\n      } else {\n        debug( `Language ${ language } already loaded, skipping` );\n      }\n    } );\n  }\n\n  /**\n   * Require optional language package\n   * @param {string} language\n   * @param {Set} loadedLanguages\n   */\n  const requireLanguage = ( language, loadedLanguages ) => {\n    if ( loadedLanguages.has( language ) || languages[ language ] ) {\n      debug( `Language ${ language } already available, skipping load` );\n      return;\n    }\n\n    debug( `Loading language on-demand: ${ language }` );\n    try {\n      loadLanguages( [ language ] );\n      loadedLanguages.add( language );\n      debug( `Successfully loaded language: ${ language }` );\n    } catch ( e ) {\n      console.warn( `Failed to load prism syntax: ${ language }!`, e );\n      debug( `Error loading language ${ language }:`, e );\n    }\n  };\n\n  // Set up line numbers functionality\n  const NEW_LINE_EXP = /\\n(?!$)/g;\n  let lineNumbersWrapper;\n\n  // Only set up the hook if line numbers are requested\n  if ( opts.lineNumbers ) {\n    debug( 'Setting up line numbers hook' );\n    Prism.hooks.add( 'after-tokenize', ( env ) => {\n      const match = env.code.match( NEW_LINE_EXP );\n      const linesNum = match ? match.length + 1 : 1;\n      debug( `Counted ${ linesNum } lines for line numbers` );\n      const lines = new Array( linesNum + 1 ).join( '<span></span>' );\n      lineNumbersWrapper = `<span aria-hidden=\"true\" class=\"line-numbers-rows\">${ lines }</span>`;\n    } );\n  }\n\n  return ( files, metalsmith, done ) => {\n    debug( 'Starting metalsmith-prism plugin' );\n    debug( 'Options:', opts );\n\n    // Call done asynchronously to avoid blocking\n    setImmediate( done );\n\n    try {\n      Object.keys( files ).forEach( ( file ) => {\n        if ( !isHTMLFile( file ) ) {\n          return;\n        }\n\n        debug( `Processing HTML file: ${ file }` );\n        const contents = files[ file ].contents.toString();\n        const $ = load( contents, { decodeEntities: false } );\n        let highlighted = false;\n        const code = $( 'code' );\n\n        if ( !code.length ) {\n          debug( `No code blocks found in ${ file }` );\n          return;\n        }\n\n        debug( `Found ${ code.length } code blocks in ${ file }` );\n\n        code.each( function() {\n          const $this = $( this );\n\n          const className = $this.attr( 'class' ) || '';\n          const targets = className.split( 'language-' );\n          let addLineNumbers = false;\n\n          if ( targets.length > 1 ) {\n            const $pre = $this.parent( 'pre' );\n\n            if ( $pre ) {\n              // Copy className to <pre> container\n              $pre.addClass( className );\n\n              if ( opts.lineNumbers ) {\n                $pre.addClass( 'line-numbers' );\n                addLineNumbers = true;\n                debug( 'Adding line numbers' );\n              }\n            }\n\n            highlighted = true;\n            let language = targets[ 1 ];\n            debug( `Detected language: ${ language }` );\n            requireLanguage( language, loadedLanguages );\n\n            if ( !languages[ language ] ) {\n              debug( `Language ${ language } not available, falling back to markup` );\n              language = 'markup';\n            }\n\n            const html = language === 'markup' && !opts.decode ? $this.html() : he.decode( $this.html() );\n            debug( `HTML decoding ${ opts.decode ? 'applied' : 'not applied' } for language ${ language }` );\n\n            debug( `Highlighting code with language: ${ language }` );\n            const highlightedCode = Prism.highlight( html, languages[ language ] );\n            $this.html( addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode );\n          }\n        } );\n\n        if ( highlighted ) {\n          debug( `Updating contents of ${ file } with highlighted code` );\n          files[ file ].contents = Buffer.from( $.html() );\n        } else {\n          debug( `No code was highlighted in ${ file }` );\n        }\n      } );\n\n      debug( 'Completed metalsmith-prism plugin' );\n    } catch ( error ) {\n      debug( 'Error in metalsmith-prism plugin:', error );\n      // We can't call done(error) here because done has already been called\n      console.error( 'Error processing files:', error );\n    }\n  };\n};\n\n// ESM export\nexport default metalsmithPrism;\n"],"names":["debug","debugLib","languages","Prism","isHTMLFile","filePath","extension","extname","toLowerCase","includes","metalsmithPrism","options","opts","decode","lineNumbers","preLoad","loadedLanguages","Set","loadLanguages","add","e","length","forEach","language","has","console","warn","requireLanguage","NEW_LINE_EXP","lineNumbersWrapper","hooks","env","match","code","linesNum","lines","Array","join","files","metalsmith","done","setImmediate","Object","keys","file","contents","toString","$","load","decodeEntities","highlighted","each","$this","className","attr","targets","split","addLineNumbers","$pre","parent","addClass","html","he","highlightedCode","highlight","Buffer","from","error"],"mappings":"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"}

package/lib/index.modern.js

@@ -0,0 +1,186 @@
+import { load } from 'cheerio';
+import { extname } from 'path';
+import Prism from 'prismjs';
+import loadLanguages from 'prismjs/components/index.js';
+import he from 'he';
+import debugLib from 'debug';
+
+const debug = debugLib('metalsmith-prism');
+
+// Import languages from Prism's default export
+const {
+  languages
+} = Prism;
+
+/**
+ * Check if a file is HTML based on its extension
+ * @param {string} filePath - Path to the file
+ * @returns {boolean} - True if the file has an HTML extension
+ */
+const isHTMLFile = filePath => {
+  const extension = extname(filePath).toLowerCase();
+  return extension === '.html' || extension === '.htm';
+};
+
+/**
+ * @typedef Options
+ * @property {boolean} [decode=false] - Whether to decode HTML entities
+ * @property {boolean} [lineNumbers=false] - Whether to add line numbers
+ * @property {string[]} [preLoad=[]] - Languages to preload
+ */
+
+/**
+ * Metalsmith plugin to highlight code syntax with PrismJS
+ *
+ * This plugin finds all code blocks in HTML files that have language-* classes
+ * and applies Prism.js syntax highlighting to them. It can also add line numbers
+ * and handle HTML entity decoding.
+ *
+ * @param {Options} [options] - Configuration options
+ * @param {boolean} [options.decode=false] - Whether to decode HTML entities in code blocks
+ * @param {boolean} [options.lineNumbers=false] - Whether to add line numbers to code blocks
+ * @param {string[]} [options.preLoad=[]] - Languages to preload before processing
+ * @returns {import('metalsmith').Plugin} - A metalsmith plugin function
+ * @example
+ * // Basic usage
+ * metalsmith.use(prism());
+ *
+ * // With options
+ * metalsmith.use(prism({
+ *   decode: true,
+ *   lineNumbers: true,
+ *   preLoad: ['java', 'scala']
+ * }));
+ */
+function metalsmithPrism(options = {}) {
+  // Track loaded languages to avoid duplicate loading
+  const loadedLanguages = new Set();
+
+  // Always load PHP by default
+  debug('Loading PHP by default');
+  try {
+    loadLanguages(['php']);
+    loadedLanguages.add('php');
+  } catch (e) {
+    debug('Failed to load PHP:', e);
+  }
+  if (options.preLoad) {
+    debug('Preloading languages:', options.preLoad);
+    options.preLoad.forEach(language => {
+      if (!loadedLanguages.has(language)) {
+        try {
+          loadLanguages([language]);
+          loadedLanguages.add(language);
+          debug(`Successfully preloaded language: ${language}`);
+        } catch (e) {
+          console.warn(`Failed to preload prism syntax: ${language}!`, e);
+          debug(`Error preloading language ${language}:`, e);
+        }
+      } else {
+        debug(`Language ${language} already loaded, skipping`);
+      }
+    });
+  }
+
+  /**
+   * Require optional language package
+   * @param {string} language
+   */
+  function requireLanguage(language) {
+    if (!loadedLanguages.has(language) && !languages[language]) {
+      debug(`Loading language on-demand: ${language}`);
+      try {
+        loadLanguages([language]);
+        loadedLanguages.add(language);
+        debug(`Successfully loaded language: ${language}`);
+      } catch (e) {
+        console.warn(`Failed to load prism syntax: ${language}!`, e);
+        debug(`Error loading language ${language}:`, e);
+      }
+    }
+  }
+
+  // Set up line numbers functionality
+  const NEW_LINE_EXP = /\n(?!$)/g;
+  let lineNumbersWrapper;
+
+  // Only set up the hook if line numbers are requested
+  if (options.lineNumbers) {
+    debug('Setting up line numbers hook');
+    Prism.hooks.add('after-tokenize', env => {
+      const match = env.code.match(NEW_LINE_EXP);
+      const linesNum = match ? match.length + 1 : 1;
+      debug(`Counted ${linesNum} lines for line numbers`);
+      const lines = new Array(linesNum + 1).join('<span></span>');
+      lineNumbersWrapper = `<span aria-hidden="true" class="line-numbers-rows">${lines}</span>`;
+    });
+  }
+  return function (files, metalsmith, done) {
+    debug('Starting metalsmith-prism plugin');
+    debug('Options:', options);
+    setImmediate(done);
+    Object.keys(files).forEach(file => {
+      if (!isHTMLFile(file)) {
+        return;
+      }
+      debug(`Processing HTML file: ${file}`);
+      const contents = files[file].contents.toString();
+      const $ = load(contents, {
+        decodeEntities: false
+      });
+      let highlighted = false;
+      const code = $('code');
+      if (!code.length) {
+        debug(`No code blocks found in ${file}`);
+        return;
+      }
+      debug(`Found ${code.length} code blocks in ${file}`);
+      code.each(function () {
+        const $this = $(this);
+        const className = $this.attr('class') || '';
+        const targets = className.split('language-');
+        let addLineNumbers = false;
+        if (targets.length > 1) {
+          const $pre = $this.parent('pre');
+          if ($pre) {
+            // Copy className to <pre> container
+            $pre.addClass(className);
+            if (options.lineNumbers) {
+              $pre.addClass('line-numbers');
+              addLineNumbers = true;
+              debug('Adding line numbers');
+            }
+          }
+          highlighted = true;
+          let language = targets[1];
+          debug(`Detected language: ${language}`);
+          requireLanguage(language);
+          if (!languages[language]) {
+            debug(`Language ${language} not available, falling back to markup`);
+            language = 'markup';
+          }
+          const html = language === 'markup' && !options.decode ? $this.html() : he.decode($this.html());
+          debug(`HTML decoding ${options.decode ? 'applied' : 'not applied'} for language ${language}`);
+          debug(`Highlighting code with language: ${language}`);
+          const highlightedCode = Prism.highlight(html, languages[language]);
+          $this.html(addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode);
+        }
+      });
+      if (highlighted) {
+        debug(`Updating contents of ${file} with highlighted code`);
+        files[file].contents = Buffer.from($.html());
+      } else {
+        debug(`No code was highlighted in ${file}`);
+      }
+    });
+    debug('Completed metalsmith-prism plugin');
+  };
+}
+
+// CommonJS export compatibility
+if (typeof module !== 'undefined') {
+  module.exports = metalsmithPrism;
+}
+
+export { metalsmithPrism as default };
+//# sourceMappingURL=index.modern.js.map

package/lib/index.modern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.modern.js","sources":["../src/index.js"],"sourcesContent":["import { load } from 'cheerio';\nimport { extname } from 'path';\nimport Prism from 'prismjs';\nimport loadLanguages from 'prismjs/components/index.js';\nimport he from 'he';\nimport debugLib from 'debug';\n\nconst debug = debugLib('metalsmith-prism');\n\n// Import languages from Prism's default export\nconst { languages } = Prism;\n\n/**\n * Check if a file is HTML based on its extension\n * @param {string} filePath - Path to the file\n * @returns {boolean} - True if the file has an HTML extension\n */\nconst isHTMLFile = (filePath) => {\n  const extension = extname(filePath).toLowerCase();\n  return extension === '.html' || extension === '.htm';\n};\n\n/**\n * @typedef Options\n * @property {boolean} [decode=false] - Whether to decode HTML entities\n * @property {boolean} [lineNumbers=false] - Whether to add line numbers\n * @property {string[]} [preLoad=[]] - Languages to preload\n */\n\n/**\n * Metalsmith plugin to highlight code syntax with PrismJS\n *\n * This plugin finds all code blocks in HTML files that have language-* classes\n * and applies Prism.js syntax highlighting to them. It can also add line numbers\n * and handle HTML entity decoding.\n *\n * @param {Options} [options] - Configuration options\n * @param {boolean} [options.decode=false] - Whether to decode HTML entities in code blocks\n * @param {boolean} [options.lineNumbers=false] - Whether to add line numbers to code blocks\n * @param {string[]} [options.preLoad=[]] - Languages to preload before processing\n * @returns {import('metalsmith').Plugin} - A metalsmith plugin function\n * @example\n * // Basic usage\n * metalsmith.use(prism());\n *\n * // With options\n * metalsmith.use(prism({\n *   decode: true,\n *   lineNumbers: true,\n *   preLoad: ['java', 'scala']\n * }));\n */\nfunction metalsmithPrism(options = {}) {\n  // Track loaded languages to avoid duplicate loading\n  const loadedLanguages = new Set();\n\n  // Always load PHP by default\n  debug('Loading PHP by default');\n  try {\n    loadLanguages(['php']);\n    loadedLanguages.add('php');\n  } catch (e) {\n    debug('Failed to load PHP:', e);\n  }\n\n  if (options.preLoad) {\n    debug('Preloading languages:', options.preLoad);\n    options.preLoad.forEach((language) => {\n      if (!loadedLanguages.has(language)) {\n        try {\n          loadLanguages([language]);\n          loadedLanguages.add(language);\n          debug(`Successfully preloaded language: ${language}`);\n        } catch (e) {\n          console.warn(`Failed to preload prism syntax: ${language}!`, e);\n          debug(`Error preloading language ${language}:`, e);\n        }\n      } else {\n        debug(`Language ${language} already loaded, skipping`);\n      }\n    });\n  }\n\n  /**\n   * Require optional language package\n   * @param {string} language\n   */\n  function requireLanguage(language) {\n    if (!loadedLanguages.has(language) && !languages[language]) {\n      debug(`Loading language on-demand: ${language}`);\n      try {\n        loadLanguages([language]);\n        loadedLanguages.add(language);\n        debug(`Successfully loaded language: ${language}`);\n      } catch (e) {\n        console.warn(`Failed to load prism syntax: ${language}!`, e);\n        debug(`Error loading language ${language}:`, e);\n      }\n    }\n  }\n\n  // Set up line numbers functionality\n  const NEW_LINE_EXP = /\\n(?!$)/g;\n  let lineNumbersWrapper;\n\n  // Only set up the hook if line numbers are requested\n  if (options.lineNumbers) {\n    debug('Setting up line numbers hook');\n    Prism.hooks.add('after-tokenize', (env) => {\n      const match = env.code.match(NEW_LINE_EXP);\n      const linesNum = match ? match.length + 1 : 1;\n      debug(`Counted ${linesNum} lines for line numbers`);\n      const lines = new Array(linesNum + 1).join('<span></span>');\n      lineNumbersWrapper = `<span aria-hidden=\"true\" class=\"line-numbers-rows\">${lines}</span>`;\n    });\n  }\n\n  return function (files, metalsmith, done) {\n    debug('Starting metalsmith-prism plugin');\n    debug('Options:', options);\n\n    setImmediate(done);\n\n    Object.keys(files).forEach((file) => {\n      if (!isHTMLFile(file)) {\n        return;\n      }\n\n      debug(`Processing HTML file: ${file}`);\n      const contents = files[file].contents.toString();\n      const $ = load(contents, { decodeEntities: false });\n      let highlighted = false;\n      const code = $('code');\n\n      if (!code.length) {\n        debug(`No code blocks found in ${file}`);\n        return;\n      }\n\n      debug(`Found ${code.length} code blocks in ${file}`);\n\n      code.each(function () {\n        const $this = $(this);\n\n        const className = $this.attr('class') || '';\n        const targets = className.split('language-');\n        let addLineNumbers = false;\n\n        if (targets.length > 1) {\n          const $pre = $this.parent('pre');\n\n          if ($pre) {\n            // Copy className to <pre> container\n            $pre.addClass(className);\n\n            if (options.lineNumbers) {\n              $pre.addClass('line-numbers');\n              addLineNumbers = true;\n              debug('Adding line numbers');\n            }\n          }\n\n          highlighted = true;\n          let language = targets[1];\n          debug(`Detected language: ${language}`);\n          requireLanguage(language);\n\n          if (!languages[language]) {\n            debug(`Language ${language} not available, falling back to markup`);\n            language = 'markup';\n          }\n\n          const html = language === 'markup' && !options.decode ? $this.html() : he.decode($this.html());\n          debug(`HTML decoding ${options.decode ? 'applied' : 'not applied'} for language ${language}`);\n\n          debug(`Highlighting code with language: ${language}`);\n          const highlightedCode = Prism.highlight(html, languages[language]);\n          $this.html(addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode);\n        }\n      });\n\n      if (highlighted) {\n        debug(`Updating contents of ${file} with highlighted code`);\n        files[file].contents = Buffer.from($.html());\n      } else {\n        debug(`No code was highlighted in ${file}`);\n      }\n    });\n\n    debug('Completed metalsmith-prism plugin');\n  };\n}\n\n// ESM export\nexport { metalsmithPrism as default };\n\n// CommonJS export compatibility\nif (typeof module !== 'undefined') {\n  module.exports = metalsmithPrism;\n}\n"],"names":["debug","debugLib","languages","Prism","isHTMLFile","filePath","extension","extname","toLowerCase","metalsmithPrism","options","loadedLanguages","Set","loadLanguages","add","e","preLoad","forEach","language","has","console","warn","requireLanguage","NEW_LINE_EXP","lineNumbersWrapper","lineNumbers","hooks","env","match","code","linesNum","length","lines","Array","join","files","metalsmith","done","setImmediate","Object","keys","file","contents","toString","$","load","decodeEntities","highlighted","each","$this","className","attr","targets","split","addLineNumbers","$pre","parent","addClass","html","decode","he","highlightedCode","highlight","Buffer","from","module","exports"],"mappings":"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"}

package/package.json

@@ -1,17 +1,37 @@
 {
   "name": "metalsmith-prism",
-  "version": "5.0.1",
+  "version": "5.0.4",
   "description": "Syntax highlighting for Metalsmith HTML templates using Prism.js",
   "type": "module",
-  "main": "lib/index.js",
-  "exports": "./lib/index.js",
+  "main": "./lib/index.cjs",
+  "module": "./lib/index.js",
+  "exports": {
+    "import": "./lib/index.js",
+    "require": "./lib/index.cjs",
+    "default": "./lib/index.js"
+  },
   "engines": {
     "node": ">= 18.0.0"
   },
   "scripts": {
-    "preversion": "npm run test",
-    "test": "mocha ./tests/index.mjs",
-    "lint": "eslint ./lib ./tests"
+    "build": "microbundle --entry src/index.js --output lib/index.js --target node -f esm,cjs --strict --generateTypes=false",
+    "changelog": "auto-changelog -u --commit-limit false --ignore-commit-pattern '^((dev|chore|ci):|Release)'",
+    "coverage": "npm test && c8 report --reporter=text-lcov > ./coverage.info",
+    "format": "prettier --write \"**/*.{yml,md,json}\"",
+    "format:check": "prettier --list-different \"**/*.{yml,md,js,json}\"",
+    "lint": "eslint --fix .",
+    "lint:check": "eslint --fix-dry-run .",
+    "format-and-lint": "npm run format && npm run lint",
+    "prepublishOnly": "npm run build",
+    "update-coverage": "node scripts/update-coverage-badge.js",
+    "prerelease": "npm run update-coverage && git add README.md && git commit -m \"Update coverage badge in README\" || true",
+    "release": "npm run build && GITHUB_TOKEN=$(grep GITHUB_TOKEN .env | cut -d '=' -f2) ./node_modules/.bin/release-it . ",
+    "release:check": "npm run lint:check && npm run build && GITHUB_TOKEN=$(grep GITHUB_TOKEN .env | cut -d '=' -f2) ./node_modules/.bin/release-it . --dry-run",
+    "test": "c8 --include=src/**/*.js mocha 'test/index.js' 'test/cjs.test.cjs' 'test/comprehensive.mjs' 'test/additional.mjs' -t 15000",
+    "test:esm": "c8 --include=src/**/*.js mocha 'test/index.js' 'test/comprehensive.mjs' 'test/additional.mjs' -t 15000",
+    "test:cjs": "c8 --include=src/**/*.js mocha test/cjs.test.cjs -t 15000",
+    "test:e2e": "serve -l 3000 test/fixtures",
+    "depcheck": "depcheck"
   },
   "repository": {
     "type": "git",
@@ -24,6 +44,7 @@
     "highlighting"
   ],
   "files": [
+    "src",
     "lib",
     "README.md"
   ],
@@ -35,17 +56,23 @@
   "homepage": "https://github.com/wernerglinka/metalsmith-prism",
   "dependencies": {
     "cheerio": "^1.0.0",
-    "debug": "^4.3.7",
+    "debug": "^4.4.0",
+    "dotenv": "^16.5.0",
     "he": "^1.2.0",
     "metalsmith": "^2.6.3",
-    "prismjs": "^1.29.0"
+    "prismjs": "^1.30.0"
   },
   "devDependencies": {
-    "chai": "^5.1.2",
-    "eslint": "^9.15.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-prettier": "^5.2.1",
-    "mocha": "^10.8.2",
-    "prettier": "^3.3.3"
+    "auto-changelog": "^2.5.0",
+    "c8": "^10.1.3",
+    "chai": "^5.2.0",
+    "eslint": "^9.25.1",
+    "eslint-config-prettier": "^10.1.2",
+    "eslint-plugin-prettier": "^5.2.6",
+    "globals": "^16.0.0",
+    "microbundle": "^0.15.1",
+    "mocha": "^11.1.0",
+    "prettier": "^3.5.3",
+    "release-it": "^19.0.1"
   }
 }

package/src/index.js

@@ -0,0 +1,214 @@
+import { load } from 'cheerio';
+import { extname } from 'path';
+import Prism from 'prismjs';
+import loadLanguages from 'prismjs/components/index.js';
+import he from 'he';
+import debugLib from 'debug';
+
+const debug = debugLib( 'metalsmith-prism' );
+
+// Import languages from Prism's default export
+const { languages } = Prism;
+
+/**
+ * Check if a file is HTML based on its extension
+ * @param {string} filePath - Path to the file
+ * @returns {boolean} - True if the file has an HTML extension
+ */
+const isHTMLFile = ( filePath ) => {
+  const extension = extname( filePath ).toLowerCase();
+  return [ '.html', '.htm' ].includes( extension );
+};
+
+/**
+ * @typedef Options
+ * @property {boolean} [decode=false] - Whether to decode HTML entities
+ * @property {boolean} [lineNumbers=false] - Whether to add line numbers
+ * @property {string[]} [preLoad=[]] - Languages to preload
+ */
+
+/**
+ * Metalsmith plugin to highlight code syntax with PrismJS
+ *
+ * This plugin finds all code blocks in HTML files that have language-* classes
+ * and applies Prism.js syntax highlighting to them. It can also add line numbers
+ * and handle HTML entity decoding.
+ *
+ * @param {Options} [options] - Configuration options
+ * @param {boolean} [options.decode=false] - Whether to decode HTML entities in code blocks
+ * @param {boolean} [options.lineNumbers=false] - Whether to add line numbers to code blocks
+ * @param {string[]} [options.preLoad=[]] - Languages to preload before processing
+ * @returns {import('metalsmith').Plugin} - A metalsmith plugin function
+ * @example
+ * // Basic usage
+ * metalsmith.use(prism());
+ *
+ * // With options
+ * metalsmith.use(prism({
+ *   decode: true,
+ *   lineNumbers: true,
+ *   preLoad: ['java', 'scala']
+ * }));
+ */
+const metalsmithPrism = ( options = {} ) => {
+  // Create a new options object with defaults
+  const opts = {
+    decode: false,
+    lineNumbers: false,
+    preLoad: [],
+    ...options
+  };
+
+  // Track loaded languages to avoid duplicate loading
+  const loadedLanguages = new Set();
+
+  // Always load PHP by default
+  debug( 'Loading PHP by default' );
+  try {
+    loadLanguages( [ 'php' ] );
+    loadedLanguages.add( 'php' );
+  } catch ( e ) {
+    debug( 'Failed to load PHP:', e );
+  }
+
+  if ( opts.preLoad && opts.preLoad.length ) {
+    debug( 'Preloading languages:', opts.preLoad );
+    opts.preLoad.forEach( ( language ) => {
+      if ( !loadedLanguages.has( language ) ) {
+        try {
+          loadLanguages( [ language ] );
+          loadedLanguages.add( language );
+          debug( `Successfully preloaded language: ${ language }` );
+        } catch ( e ) {
+          console.warn( `Failed to preload prism syntax: ${ language }!`, e );
+          debug( `Error preloading language ${ language }:`, e );
+        }
+      } else {
+        debug( `Language ${ language } already loaded, skipping` );
+      }
+    } );
+  }
+
+  /**
+   * Require optional language package
+   * @param {string} language
+   * @param {Set} loadedLanguages
+   */
+  const requireLanguage = ( language, loadedLanguages ) => {
+    if ( loadedLanguages.has( language ) || languages[ language ] ) {
+      debug( `Language ${ language } already available, skipping load` );
+      return;
+    }
+
+    debug( `Loading language on-demand: ${ language }` );
+    try {
+      loadLanguages( [ language ] );
+      loadedLanguages.add( language );
+      debug( `Successfully loaded language: ${ language }` );
+    } catch ( e ) {
+      console.warn( `Failed to load prism syntax: ${ language }!`, e );
+      debug( `Error loading language ${ language }:`, e );
+    }
+  };
+
+  // Set up line numbers functionality
+  const NEW_LINE_EXP = /\n(?!$)/g;
+  let lineNumbersWrapper;
+
+  // Only set up the hook if line numbers are requested
+  if ( opts.lineNumbers ) {
+    debug( 'Setting up line numbers hook' );
+    Prism.hooks.add( 'after-tokenize', ( env ) => {
+      const match = env.code.match( NEW_LINE_EXP );
+      const linesNum = match ? match.length + 1 : 1;
+      debug( `Counted ${ linesNum } lines for line numbers` );
+      const lines = new Array( linesNum + 1 ).join( '<span></span>' );
+      lineNumbersWrapper = `<span aria-hidden="true" class="line-numbers-rows">${ lines }</span>`;
+    } );
+  }
+
+  return ( files, metalsmith, done ) => {
+    debug( 'Starting metalsmith-prism plugin' );
+    debug( 'Options:', opts );
+
+    // Call done asynchronously to avoid blocking
+    setImmediate( done );
+
+    try {
+      Object.keys( files ).forEach( ( file ) => {
+        if ( !isHTMLFile( file ) ) {
+          return;
+        }
+
+        debug( `Processing HTML file: ${ file }` );
+        const contents = files[ file ].contents.toString();
+        const $ = load( contents, { decodeEntities: false } );
+        let highlighted = false;
+        const code = $( 'code' );
+
+        if ( !code.length ) {
+          debug( `No code blocks found in ${ file }` );
+          return;
+        }
+
+        debug( `Found ${ code.length } code blocks in ${ file }` );
+
+        code.each( function() {
+          const $this = $( this );
+
+          const className = $this.attr( 'class' ) || '';
+          const targets = className.split( 'language-' );
+          let addLineNumbers = false;
+
+          if ( targets.length > 1 ) {
+            const $pre = $this.parent( 'pre' );
+
+            if ( $pre ) {
+              // Copy className to <pre> container
+              $pre.addClass( className );
+
+              if ( opts.lineNumbers ) {
+                $pre.addClass( 'line-numbers' );
+                addLineNumbers = true;
+                debug( 'Adding line numbers' );
+              }
+            }
+
+            highlighted = true;
+            let language = targets[ 1 ];
+            debug( `Detected language: ${ language }` );
+            requireLanguage( language, loadedLanguages );
+
+            if ( !languages[ language ] ) {
+              debug( `Language ${ language } not available, falling back to markup` );
+              language = 'markup';
+            }
+
+            const html = language === 'markup' && !opts.decode ? $this.html() : he.decode( $this.html() );
+            debug( `HTML decoding ${ opts.decode ? 'applied' : 'not applied' } for language ${ language }` );
+
+            debug( `Highlighting code with language: ${ language }` );
+            const highlightedCode = Prism.highlight( html, languages[ language ] );
+            $this.html( addLineNumbers ? highlightedCode + lineNumbersWrapper : highlightedCode );
+          }
+        } );
+
+        if ( highlighted ) {
+          debug( `Updating contents of ${ file } with highlighted code` );
+          files[ file ].contents = Buffer.from( $.html() );
+        } else {
+          debug( `No code was highlighted in ${ file }` );
+        }
+      } );
+
+      debug( 'Completed metalsmith-prism plugin' );
+    } catch ( error ) {
+      debug( 'Error in metalsmith-prism plugin:', error );
+      // We can't call done(error) here because done has already been called
+      console.error( 'Error processing files:', error );
+    }
+  };
+};
+
+// ESM export
+export default metalsmithPrism;