From 9056d2205a744643e829684b082c9b15ee76eae2 Mon Sep 17 00:00:00 2001
From: mde <mde@fleegix.org>
Date: Wed, 1 May 2024 10:50:06 -0700
Subject: [PATCH] publish: Support Nodes back to 0.12

generated from commit f232139b7fbb257ec8a94bd15339d107519209a0
---
 Cache.html                                 |    8 +-
 docs_jsdoc_cache.jsdoc.html                |    2 +-
 docs_jsdoc_callbacks.jsdoc.html            |    4 +-
 docs_jsdoc_fileLoader.jsdoc.html           |    2 +-
 docs_jsdoc_options.jsdoc.html              |   16 +-
 docs_jsdoc_template-functions.jsdoc.html   |    5 +-
 global.html                                |  146 ++-
 index.html                                 |  109 +-
 lib_cjs_ejs.js.html                        |  923 +++++++++++++
 lib_cjs_utils.js.html                      |  297 +++++
 lib_ejs.js.html => lib_esm_ejs.js.html     |  455 +++----
 lib_utils.js.html => lib_esm_utils.js.html |  130 +-
 module-ejs.html                            | 1366 +++++++++++++-------
 scripts/linenumber.js                      |   18 +-
 styles/jsdoc-default.css                   |    4 +-
 15 files changed, 2728 insertions(+), 757 deletions(-)
 create mode 100644 lib_cjs_ejs.js.html
 create mode 100644 lib_cjs_utils.js.html
 rename lib_ejs.js.html => lib_esm_ejs.js.html (69%)
 rename lib_utils.js.html => lib_esm_utils.js.html (57%)

diff --git a/Cache.html b/Cache.html
index f4d4b5cf..1d4fde32 100644
--- a/Cache.html
+++ b/Cache.html
@@ -238,6 +238,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -351,6 +353,8 @@ <h4 class="name" id="reset"><span class="type-signature"></span>reset<span class
 
 
 
+
+
         
             
 
@@ -509,6 +513,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
         
     
 
@@ -531,7 +537,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs_jsdoc_cache.jsdoc.html b/docs_jsdoc_cache.jsdoc.html
index f12c89f4..1281c322 100644
--- a/docs_jsdoc_cache.jsdoc.html
+++ b/docs_jsdoc_cache.jsdoc.html
@@ -79,7 +79,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs_jsdoc_callbacks.jsdoc.html b/docs_jsdoc_callbacks.jsdoc.html
index aed87efc..7ec6b990 100644
--- a/docs_jsdoc_callbacks.jsdoc.html
+++ b/docs_jsdoc_callbacks.jsdoc.html
@@ -31,7 +31,7 @@ <h1 class="page-title">Source: docs/jsdoc/callbacks.jsdoc</h1>
  *
  * @callback RenderFileCallback
  * @param {?Error}  err error, if any resulted from the rendering process
- * @param {?String} str output string, is `null` if there is an error
+ * @param {?String} [str] output string, is `null` or `undefined` if there is an error
  * @static
  * @global
  */
@@ -51,7 +51,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs_jsdoc_fileLoader.jsdoc.html b/docs_jsdoc_fileLoader.jsdoc.html
index 125385b0..54f221e6 100644
--- a/docs_jsdoc_fileLoader.jsdoc.html
+++ b/docs_jsdoc_fileLoader.jsdoc.html
@@ -52,7 +52,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs_jsdoc_options.jsdoc.html b/docs_jsdoc_options.jsdoc.html
index aa359c9a..64ca8386 100644
--- a/docs_jsdoc_options.jsdoc.html
+++ b/docs_jsdoc_options.jsdoc.html
@@ -45,6 +45,14 @@ <h1 class="page-title">Source: docs/jsdoc/options.jsdoc</h1>
  * whose name is specified by {@link module:ejs.localsName} (default to
  * `locals`).
  *
+ * @property {Boolean} [strict=false]
+ * Whether to run in strict mode or not.
+ * Enforces `_with=false`.
+ *
+ * @property {String[]} [destructuredLocals=[]]
+ * An array of local variables that are always destructured from {@link module:ejs.localsName},
+ * available even in strict mode.
+ *
  * @property {Boolean} [rmWhitespace=false]
  * Remove all safe-to-remove whitespace, including leading and trailing
  * whitespace. It also enables a safer version of `-%>` line slurping for all
@@ -64,9 +72,9 @@ <h1 class="page-title">Source: docs/jsdoc/options.jsdoc</h1>
  * The filename of the template. Required for inclusion and caching unless
  * you are using {@link module:ejs.renderFile}. Also used for error reporting.
  *
- * @property {String}  [root=undefined]
- * The path to the project root. When this is set, absolute paths for includes
- * (/filename.ejs) will be relative to the project root.
+ * @property {String|String[]}  [root=undefined]
+ * The path to the template root(s). When this is set, absolute paths for includes
+ * (/filename.ejs) will be relative to the template root(s).
  *
  * @property {String}  [openDelimiter='&lt;']
  * The opening delimiter for all statements. This allows you to clearly delinate
@@ -118,7 +126,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/docs_jsdoc_template-functions.jsdoc.html b/docs_jsdoc_template-functions.jsdoc.html
index 640d912e..ed8dd862 100644
--- a/docs_jsdoc_template-functions.jsdoc.html
+++ b/docs_jsdoc_template-functions.jsdoc.html
@@ -86,7 +86,8 @@ <h1 class="page-title">Source: docs/jsdoc/template-functions.jsdoc</h1>
  * @param {Error}  err      Error object
  * @param {String} str      full EJS source
  * @param {String} filename file name of the EJS file
- * @param {String} lineno   line number of the error
+ * @param {Number} lineno   line number of the error
+ * @param {EscapeCallback} esc
  * @static
  * @global
  */
@@ -117,7 +118,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/global.html b/global.html
index 9e2c2225..0c134016 100644
--- a/global.html
+++ b/global.html
@@ -229,6 +229,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -279,7 +281,7 @@ <h4 class="name" id="ClientFunction"><span class="type-signature"></span>ClientF
 
 
 <div class="description">
-    <p>This type of function is returned from <a href="module-ejs.html#.compile"><code>module:ejs.compile</code></a>, when
+    <p>This type of function is returned from <code>module:ejs.compile</code>, when
 <a href="global.html#Options"><code>Options</code></a><code>.client</code> is true.</p>
 <p>This is also used internally to generate a
 <a href="global.html#TemplateFunction"><code>TemplateFunction</code></a>.</p>
@@ -355,7 +357,7 @@ <h5>Parameters:</h5>
             
 
             <td class="description last"><p>an object of data to be passed into the template. The name of this variable
-is adjustable through <a href="module-ejs.html#.localsName"><code>module:ejs.localsName</code></a>.</p></td>
+is adjustable through <code>module:ejs.localsName</code>.</p></td>
         </tr>
 
     
@@ -534,6 +536,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -694,6 +698,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -871,7 +877,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="docs_jsdoc_template-functions.jsdoc.html">docs/jsdoc/template-functions.jsdoc</a>, <a href="docs_jsdoc_template-functions.jsdoc.html#line66">line 66</a>
+        <a href="docs_jsdoc_template-functions.jsdoc.html">docs/jsdoc/template-functions.jsdoc</a>, <a href="docs_jsdoc_template-functions.jsdoc.html#line67">line 67</a>
     </li></ul></dd>
     
 
@@ -894,6 +900,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -1085,12 +1093,88 @@ <h5 class="subsection-title">Properties:</h5>
 
             <td class="description last"><p>Whether or not to use <code>with () {}</code> construct in the generated template
 functions. If set to <code>false</code>, data is still accessible through the object
-whose name is specified by <a href="module-ejs.html#.localsName"><code>module:ejs.localsName</code></a> (default to
+whose name is specified by <code>module:ejs.localsName</code> (default to
 <code>locals</code>).</p></td>
         </tr>
 
     
 
+        <tr>
+            
+                <td class="name"><code>strict</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Boolean</span>
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    false
+                
+                </td>
+            
+
+            <td class="description last"><p>Whether to run in strict mode or not.
+Enforces <code>_with=false</code>.</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>destructuredLocals</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array.&lt;String></span>
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    []
+                
+                </td>
+            
+
+            <td class="description last"><p>An array of local variables that are always destructured from <code>module:ejs.localsName</code>,
+available even in strict mode.</p></td>
+        </tr>
+
+    
+
         <tr>
             
                 <td class="name"><code>rmWhitespace</code></td>
@@ -1239,7 +1323,7 @@ <h5 class="subsection-title">Properties:</h5>
             
 
             <td class="description last"><p>The filename of the template. Required for inclusion and caching unless
-you are using <a href="module-ejs.html#.renderFile"><code>module:ejs.renderFile</code></a>. Also used for error reporting.</p></td>
+you are using <code>module:ejs.renderFile</code>. Also used for error reporting.</p></td>
         </tr>
 
     
@@ -1253,6 +1337,9 @@ <h5 class="subsection-title">Properties:</h5>
             
                 
 <span class="param-type">String</span>
+|
+
+<span class="param-type">Array.&lt;String></span>
 
 
             
@@ -1274,8 +1361,8 @@ <h5 class="subsection-title">Properties:</h5>
                 </td>
             
 
-            <td class="description last"><p>The path to the project root. When this is set, absolute paths for includes
-(/filename.ejs) will be relative to the project root.</p></td>
+            <td class="description last"><p>The path to the template root(s). When this is set, absolute paths for includes
+(/filename.ejs) will be relative to the template root(s).</p></td>
         </tr>
 
     
@@ -1604,7 +1691,7 @@ <h5 class="subsection-title">Properties:</h5>
     
 
     
-    <h4 class="name" id="RenderFileCallback"><span class="type-signature"></span>RenderFileCallback<span class="signature">(err<span class="signature-attributes">nullable</span>, str<span class="signature-attributes">nullable</span>)</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="RenderFileCallback"><span class="type-signature"></span>RenderFileCallback<span class="signature">(err<span class="signature-attributes">nullable</span>, str<span class="signature-attributes">opt, nullable</span>)</span><span class="type-signature"></span></h4>
     
 
     
@@ -1612,7 +1699,7 @@ <h4 class="name" id="RenderFileCallback"><span class="type-signature"></span>Ren
 
 
 <div class="description">
-    <p>Callback for receiving data from <a href="module-ejs.html#.renderFile"><code>module:ejs.renderFile</code></a>.</p>
+    <p>Callback for receiving data from <code>module:ejs.renderFile</code>.</p>
 </div>
 
 
@@ -1698,6 +1785,8 @@ <h5>Parameters:</h5>
             
                 <td class="attributes">
                 
+                    &lt;optional><br>
+                
 
                 
                     &lt;nullable><br>
@@ -1709,7 +1798,7 @@ <h5>Parameters:</h5>
 
             
 
-            <td class="description last"><p>output string, is <code>null</code> if there is an error</p></td>
+            <td class="description last"><p>output string, is <code>null</code> or <code>undefined</code> if there is an error</p></td>
         </tr>
 
     
@@ -1778,13 +1867,15 @@ <h5>Parameters:</h5>
 
 
 
+
+
             
                 
 
     
 
     
-    <h4 class="name" id="RethrowCallback"><span class="type-signature"></span>RethrowCallback<span class="signature">(err, str, filename, lineno)</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="RethrowCallback"><span class="type-signature"></span>RethrowCallback<span class="signature">(err, str, filename, lineno, esc)</span><span class="type-signature"></span></h4>
     
 
     
@@ -1905,7 +1996,7 @@ <h5>Parameters:</h5>
             <td class="type">
             
                 
-<span class="param-type">String</span>
+<span class="param-type">Number</span>
 
 
             
@@ -1919,6 +2010,29 @@ <h5>Parameters:</h5>
         </tr>
 
     
+
+        <tr>
+            
+                <td class="name"><code>esc</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type"><a href="global.html#EscapeCallback">EscapeCallback</a></span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"></td>
+        </tr>
+
+    
     </tbody>
 </table>
 
@@ -1984,6 +2098,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
             
                 
 
@@ -1998,7 +2114,7 @@ <h4 class="name" id="TemplateFunction"><span class="type-signature"></span>Templ
 
 
 <div class="description">
-    <p>This type of function is returned from <a href="module-ejs.html#.compile"><code>module:ejs.compile</code></a>, when
+    <p>This type of function is returned from <code>module:ejs.compile</code>, when
 <a href="global.html#Options"><code>Options</code></a><code>.client</code> is false.</p>
 </div>
 
@@ -2135,6 +2251,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -2185,7 +2303,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/index.html b/index.html
index 5674f860..b88bad1a 100644
--- a/index.html
+++ b/index.html
@@ -54,7 +54,7 @@ <h3> </h3>
 
 <header>
     
-        <h2>lib/ejs.js</h2>
+        <h2>lib/cjs/ejs.js</h2>
         
     
 </header>
@@ -92,8 +92,109 @@ <h2>lib/ejs.js</h2>
     <dd class="tag-author">
         <ul>
             <li><a href="mailto:mde@fleegix.org">Matthew Eernisse</a></li>
+        </ul>
+    </dd>
+    
+
+    
+
+    
+    <dt class="tag-license">License:</dt>
+    <dd class="tag-license"><ul class="dummy"><li><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></li></ul></dd>
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line27">line 27</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+        
+    
+    </div>
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</article>
+
+</section>
+
+
+
+
+
+
+
+<section>
+
+<header>
+    
+        <h2>lib/esm/ejs.js</h2>
+        
+    
+</header>
+
+<article>
+    <div class="container-overview">
+    
+        
+            <div class="description"><p>Embedded JavaScript templating engine. <a href="http://ejs.co">http://ejs.co</a></p></div>
+        
+
         
-            <li><a href="mailto:timothygu99@gmail.com">Tiancheng "Timothy" Gu</a></li>
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-author">Author:</dt>
+    <dd class="tag-author">
+        <ul>
+            <li><a href="mailto:mde@fleegix.org">Matthew Eernisse</a></li>
         </ul>
     </dd>
     
@@ -110,7 +211,7 @@ <h2>lib/ejs.js</h2>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line21">line 21</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line26">line 26</a>
     </li></ul></dd>
     
 
@@ -161,7 +262,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/lib_cjs_ejs.js.html b/lib_cjs_ejs.js.html
new file mode 100644
index 00000000..41303aac
--- /dev/null
+++ b/lib_cjs_ejs.js.html
@@ -0,0 +1,923 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>JSDoc: Source: lib/cjs/ejs.js</title>
+
+    <script src="scripts/prettify/prettify.js"> </script>
+    <script src="scripts/prettify/lang-css.js"> </script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+
+<body>
+
+<div id="main">
+
+    <h1 class="page-title">Source: lib/cjs/ejs.js</h1>
+
+    
+
+
+
+    
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>/*
+ * EJS Embedded JavaScript templates
+ * Copyright 2112 Matthew Eernisse (mde@fleegix.org)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *         http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+*/
+'use strict';
+var __importDefault = (this &amp;&amp; this.__importDefault) || function (mod) {
+    return (mod &amp;&amp; mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var fs_1 = __importDefault(require("fs"));
+var path_1 = __importDefault(require("path"));
+var url_1 = require("url");
+var utils_js_1 = __importDefault(require("./utils.js"));
+/**
+ * @file Embedded JavaScript templating engine. {@link http://ejs.co}
+ * @author Matthew Eernisse &lt;mde@fleegix.org>
+ * @project EJS
+ * @license {@link http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0}
+ */
+/**
+ * EJS internal functions.
+ *
+ * Technically this "module" lies in the same file as {@link module:ejs}, for
+ * the sake of organization all the private functions re grouped into this
+ * module.
+ *
+ * @module ejs-internal
+ * @private
+ */
+/**
+ * Embedded JavaScript templating engine.
+ *
+ * @module ejs
+ * @public
+ */
+// Shims for file/dir in ESM -- do not alter the code below, it generates code
+// that has to be removed in the CJS build by string replacement
+
+var ejs = {};
+var pkg = fs_1.default.readFileSync(path_1.default.join(__dirname, '../../package.json'), 'utf-8');
+pkg = JSON.parse(pkg);
+/** @type {string} */
+var _VERSION_STRING = pkg.version;
+var _DEFAULT_OPEN_DELIMITER = '&lt;';
+var _DEFAULT_CLOSE_DELIMITER = '>';
+var _DEFAULT_DELIMITER = '%';
+var _DEFAULT_LOCALS_NAME = 'locals';
+var _NAME = 'ejs';
+var _REGEX_STRING = '(&lt;%%|%%>|&lt;%=|&lt;%-|&lt;%_|&lt;%#|&lt;%|%>|-%>|_%>)';
+var _OPTS_PASSABLE_WITH_DATA = ['delimiter', 'scope', 'context', 'debug', 'compileDebug',
+    'client', '_with', 'rmWhitespace', 'strict', 'filename', 'async'];
+// We don't allow 'cache' option to be passed in the data obj for
+// the normal `render` call, but this is where Express 2 &amp; 3 put it
+// so we make an exception for `renderFile`
+var _OPTS_PASSABLE_WITH_DATA_EXPRESS = _OPTS_PASSABLE_WITH_DATA.concat('cache');
+var _BOM = /^\uFEFF/;
+var _JS_IDENTIFIER = /^[a-zA-Z_$][0-9a-zA-Z_$]*$/;
+/**
+ * EJS template function cache. This can be a LRU object from lru-cache NPM
+ * module. By default, it is {@link module:utils.cache}, a simple in-process
+ * cache that grows continuously.
+ *
+ * @type {Cache}
+ */
+ejs.cache = utils_js_1.default.cache;
+/**
+ * Custom file loader. Useful for template preprocessing or restricting access
+ * to a certain part of the filesystem.
+ *
+ * @type {fileLoader}
+ */
+ejs.fileLoader = fs_1.default.readFileSync;
+/**
+ * Name of the object containing the locals.
+ *
+ * This variable is overridden by {@link Options}`.localsName` if it is not
+ * `undefined`.
+ *
+ * @type {String}
+ * @public
+ */
+ejs.localsName = _DEFAULT_LOCALS_NAME;
+/**
+ * Promise implementation -- defaults to the native implementation if available
+ * This is mostly just for testability
+ *
+ * @type {PromiseConstructorLike}
+ * @public
+ */
+ejs.promiseImpl = (new Function('return this;'))().Promise;
+/**
+ * Get the path to the included file from the parent file path and the
+ * specified path.
+ *
+ * @param {String}  name     specified path
+ * @param {String}  filename parent file path
+ * @param {Boolean} [isDir=false] whether the parent file path is a directory
+ * @return {String}
+ */
+ejs.resolveInclude = function (name, filename, isDir) {
+    var dirname = path_1.default.dirname;
+    var extname = path_1.default.extname;
+    var resolve = path_1.default.resolve;
+    var includePath = resolve(isDir ? filename : dirname(filename), name);
+    var ext = extname(name);
+    if (!ext) {
+        includePath += '.ejs';
+    }
+    return includePath;
+};
+/**
+ * Try to resolve file path on multiple directories
+ *
+ * @param  {String}        name  specified path
+ * @param  {Array&lt;String>} paths list of possible parent directory paths
+ * @return {String}
+ */
+function resolvePaths(name, paths) {
+    var filePath;
+    if (paths.some(function (v) {
+        filePath = ejs.resolveInclude(name, v, true);
+        return fs_1.default.existsSync(filePath);
+    })) {
+        return filePath;
+    }
+}
+/**
+ * Get the path to the included file by Options
+ *
+ * @param  {String}  path    specified path
+ * @param  {Options} options compilation options
+ * @return {String}
+ */
+function getIncludePath(path, options) {
+    var includePath;
+    var filePath;
+    var views = options.views;
+    var match = /^[A-Za-z]+:\\|^\//.exec(path);
+    // Abs path
+    if (match &amp;&amp; match.length) {
+        path = path.replace(/^\/*/, '');
+        if (Array.isArray(options.root)) {
+            includePath = resolvePaths(path, options.root);
+        }
+        else {
+            includePath = ejs.resolveInclude(path, options.root || '/', true);
+        }
+    }
+    // Relative paths
+    else {
+        // Look relative to a passed filename first
+        if (options.filename) {
+            filePath = ejs.resolveInclude(path, options.filename);
+            if (fs_1.default.existsSync(filePath)) {
+                includePath = filePath;
+            }
+        }
+        // Then look in any views directories
+        if (!includePath &amp;&amp; Array.isArray(views)) {
+            includePath = resolvePaths(path, views);
+        }
+        if (!includePath &amp;&amp; typeof options.includer !== 'function') {
+            throw new Error('Could not find the include file "' +
+                options.escapeFunction(path) + '"');
+        }
+    }
+    return includePath;
+}
+/**
+ * Get the template from a string or a file, either compiled on-the-fly or
+ * read from cache (if enabled), and cache the template if needed.
+ *
+ * If `template` is not set, the file specified in `options.filename` will be
+ * read.
+ *
+ * If `options.cache` is true, this function reads the file from
+ * `options.filename` so it must be set prior to calling this function.
+ *
+ * @memberof module:ejs-internal
+ * @param {Options} options   compilation options
+ * @param {String} [template] template source
+ * @return {(TemplateFunction|ClientFunction)}
+ * Depending on the value of `options.client`, either type might be returned.
+ * @static
+ */
+function handleCache(options, template) {
+    var func;
+    var filename = options.filename;
+    var hasTemplate = arguments.length > 1;
+    if (options.cache) {
+        if (!filename) {
+            throw new Error('cache option requires a filename');
+        }
+        func = ejs.cache.get(filename);
+        if (func) {
+            return func;
+        }
+        if (!hasTemplate) {
+            template = fileLoader(filename).toString().replace(_BOM, '');
+        }
+    }
+    else if (!hasTemplate) {
+        // istanbul ignore if: should not happen at all
+        if (!filename) {
+            throw new Error('Internal EJS error: no file name or template '
+                + 'provided');
+        }
+        template = fileLoader(filename).toString().replace(_BOM, '');
+    }
+    func = ejs.compile(template, options);
+    if (options.cache) {
+        ejs.cache.set(filename, func);
+    }
+    return func;
+}
+/**
+ * Try calling handleCache with the given options and data and call the
+ * callback with the result. If an error occurs, call the callback with
+ * the error. Used by renderFile().
+ *
+ * @memberof module:ejs-internal
+ * @param {Options} options    compilation options
+ * @param {Object} data        template data
+ * @param {RenderFileCallback} cb callback
+ * @static
+ */
+function tryHandleCache(options, data, cb) {
+    var result;
+    if (!cb) {
+        if (typeof ejs.promiseImpl == 'function') {
+            return new ejs.promiseImpl(function (resolve, reject) {
+                try {
+                    result = handleCache(options)(data);
+                    resolve(result);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+        }
+        else {
+            throw new Error('Please provide a callback function');
+        }
+    }
+    else {
+        try {
+            result = handleCache(options)(data);
+        }
+        catch (err) {
+            return cb(err);
+        }
+        cb(null, result);
+    }
+}
+/**
+ * fileLoader is independent
+ *
+ * @param {String} filePath ejs file path.
+ * @return {String} The contents of the specified file.
+ * @static
+ */
+function fileLoader(filePath) {
+    return ejs.fileLoader(filePath);
+}
+/**
+ * Get the template function.
+ *
+ * If `options.cache` is `true`, then the template is cached.
+ *
+ * @memberof module:ejs-internal
+ * @param {String}  path    path for the specified file
+ * @param {Options} options compilation options
+ * @return {(TemplateFunction|ClientFunction)}
+ * Depending on the value of `options.client`, either type might be returned
+ * @static
+ */
+function includeFile(path, options) {
+    var opts = utils_js_1.default.shallowCopy(utils_js_1.default.createNullProtoObjWherePossible(), options);
+    opts.filename = getIncludePath(path, opts);
+    if (typeof options.includer === 'function') {
+        var includerResult = options.includer(path, opts.filename);
+        if (includerResult) {
+            if (includerResult.filename) {
+                opts.filename = includerResult.filename;
+            }
+            if (includerResult.template) {
+                return handleCache(opts, includerResult.template);
+            }
+        }
+    }
+    return handleCache(opts);
+}
+/**
+ * Re-throw the given `err` in context to the `str` of ejs, `filename`, and
+ * `lineno`.
+ *
+ * @implements {RethrowCallback}
+ * @memberof module:ejs-internal
+ * @param {Error}  err      Error object
+ * @param {String} str      EJS source
+ * @param {String} flnm     file name of the EJS file
+ * @param {Number} lineno   line number of the error
+ * @param {EscapeCallback} esc
+ * @static
+ */
+function rethrow(err, str, flnm, lineno, esc) {
+    var lines = str.split('\n');
+    var start = Math.max(lineno - 3, 0);
+    var end = Math.min(lines.length, lineno + 3);
+    var filename = esc(flnm);
+    // Error context
+    var context = lines.slice(start, end).map(function (line, i) {
+        var curr = i + start + 1;
+        return (curr == lineno ? ' >> ' : '    ')
+            + curr
+            + '| '
+            + line;
+    }).join('\n');
+    // Alter exception message
+    err.path = filename;
+    err.message = (filename || 'ejs') + ':'
+        + lineno + '\n'
+        + context + '\n\n'
+        + err.message;
+    throw err;
+}
+function stripSemi(str) {
+    return str.replace(/;(\s*$)/, '$1');
+}
+/**
+ * Compile the given `str` of ejs into a template function.
+ *
+ * @param {String}  template EJS template
+ *
+ * @param {Options} [opts] compilation options
+ *
+ * @return {(TemplateFunction|ClientFunction)}
+ * Depending on the value of `opts.client`, either type might be returned.
+ * Note that the return type of the function also depends on the value of `opts.async`.
+ * @public
+ */
+ejs.compile = function compile(template, opts) {
+    var templ;
+    // v1 compat
+    // 'scope' is 'context'
+    // FIXME: Remove this in a future version
+    if (opts &amp;&amp; opts.scope) {
+        console.warn('`scope` option is deprecated and will be removed in future EJS');
+        if (!opts.context) {
+            opts.context = opts.scope;
+        }
+        delete opts.scope;
+    }
+    templ = new Template(template, opts);
+    return templ.compile();
+};
+/**
+ * Render the given `template` of ejs.
+ *
+ * If you would like to include options but not data, you need to explicitly
+ * call this function with `data` being an empty object or `null`.
+ *
+ * @param {String}   template EJS template
+ * @param {Object}  [data={}] template data
+ * @param {Options} [opts={}] compilation and rendering options
+ * @return {(String|Promise&lt;String>)}
+ * Return value type depends on `opts.async`.
+ * @public
+ */
+ejs.render = function (template, d, o) {
+    var data = d || utils_js_1.default.createNullProtoObjWherePossible();
+    var opts = o || utils_js_1.default.createNullProtoObjWherePossible();
+    // No options object -- if there are optiony names
+    // in the data, copy them to options
+    if (arguments.length == 2) {
+        utils_js_1.default.shallowCopyFromList(opts, data, _OPTS_PASSABLE_WITH_DATA);
+    }
+    return handleCache(opts, template)(data);
+};
+/**
+ * Render an EJS file at the given `path` and callback `cb(err, str)`.
+ *
+ * If you would like to include options but not data, you need to explicitly
+ * call this function with `data` being an empty object or `null`.
+ *
+ * @param {String}             path     path to the EJS file
+ * @param {Object}            [data={}] template data
+ * @param {Options}           [opts={}] compilation and rendering options
+ * @param {RenderFileCallback} cb callback
+ * @public
+ */
+ejs.renderFile = function () {
+    var args = Array.prototype.slice.call(arguments);
+    var filename = args.shift();
+    var cb;
+    var opts = { filename: filename };
+    var data;
+    var viewOpts;
+    // Do we have a callback?
+    if (typeof arguments[arguments.length - 1] == 'function') {
+        cb = args.pop();
+    }
+    // Do we have data/opts?
+    if (args.length) {
+        // Should always have data obj
+        data = args.shift();
+        // Normal passed opts (data obj + opts obj)
+        if (args.length) {
+            // Use shallowCopy so we don't pollute passed in opts obj with new vals
+            utils_js_1.default.shallowCopy(opts, args.pop());
+        }
+        // Special casing for Express (settings + opts-in-data)
+        else {
+            // Express 3 and 4
+            if (data.settings) {
+                // Pull a few things from known locations
+                if (data.settings.views) {
+                    opts.views = data.settings.views;
+                }
+                if (data.settings['view cache']) {
+                    opts.cache = true;
+                }
+                // Undocumented after Express 2, but still usable, esp. for
+                // items that are unsafe to be passed along with data, like `root`
+                viewOpts = data.settings['view options'];
+                if (viewOpts) {
+                    utils_js_1.default.shallowCopy(opts, viewOpts);
+                }
+            }
+            // Express 2 and lower, values set in app.locals, or people who just
+            // want to pass options in their data. NOTE: These values will override
+            // anything previously set in settings  or settings['view options']
+            utils_js_1.default.shallowCopyFromList(opts, data, _OPTS_PASSABLE_WITH_DATA_EXPRESS);
+        }
+        opts.filename = filename;
+    }
+    else {
+        data = utils_js_1.default.createNullProtoObjWherePossible();
+    }
+    return tryHandleCache(opts, data, cb);
+};
+/**
+ * Clear intermediate JavaScript cache. Calls {@link Cache#reset}.
+ * @public
+ */
+/**
+ * EJS template class
+ * @public
+ */
+ejs.Template = Template;
+ejs.clearCache = function () {
+    ejs.cache.reset();
+};
+function Template(text, optsParam) {
+    var opts = utils_js_1.default.hasOwnOnlyObject(optsParam);
+    var options = utils_js_1.default.createNullProtoObjWherePossible();
+    this.templateText = text;
+    /** @type {string | null} */
+    this.mode = null;
+    this.truncate = false;
+    this.currentLine = 1;
+    this.source = '';
+    options.client = opts.client || false;
+    options.escapeFunction = opts.escape || opts.escapeFunction || utils_js_1.default.escapeXML;
+    options.compileDebug = opts.compileDebug !== false;
+    options.debug = !!opts.debug;
+    options.filename = opts.filename;
+    options.openDelimiter = opts.openDelimiter || ejs.openDelimiter || _DEFAULT_OPEN_DELIMITER;
+    options.closeDelimiter = opts.closeDelimiter || ejs.closeDelimiter || _DEFAULT_CLOSE_DELIMITER;
+    options.delimiter = opts.delimiter || ejs.delimiter || _DEFAULT_DELIMITER;
+    options.strict = opts.strict || false;
+    options.context = opts.context;
+    options.cache = opts.cache || false;
+    options.rmWhitespace = opts.rmWhitespace;
+    options.root = opts.root;
+    options.includer = opts.includer;
+    options.outputFunctionName = opts.outputFunctionName;
+    options.localsName = opts.localsName || ejs.localsName || _DEFAULT_LOCALS_NAME;
+    options.views = opts.views;
+    options.async = opts.async;
+    options.destructuredLocals = opts.destructuredLocals;
+    options.legacyInclude = typeof opts.legacyInclude != 'undefined' ? !!opts.legacyInclude : true;
+    if (options.strict) {
+        options._with = false;
+    }
+    else {
+        options._with = typeof opts._with != 'undefined' ? opts._with : true;
+    }
+    this.opts = options;
+    this.regex = this.createRegex();
+}
+Template.modes = {
+    EVAL: 'eval',
+    ESCAPED: 'escaped',
+    RAW: 'raw',
+    COMMENT: 'comment',
+    LITERAL: 'literal'
+};
+Template.prototype = {
+    createRegex: function () {
+        var str = _REGEX_STRING;
+        var delim = utils_js_1.default.escapeRegExpChars(this.opts.delimiter);
+        var open = utils_js_1.default.escapeRegExpChars(this.opts.openDelimiter);
+        var close = utils_js_1.default.escapeRegExpChars(this.opts.closeDelimiter);
+        str = str.replace(/%/g, delim)
+            .replace(/&lt;/g, open)
+            .replace(/>/g, close);
+        return new RegExp(str);
+    },
+    compile: function () {
+        /** @type {string} */
+        var src;
+        /** @type {ClientFunction} */
+        var fn;
+        var opts = this.opts;
+        var prepended = '';
+        var appended = '';
+        /** @type {EscapeCallback} */
+        var escapeFn = opts.escapeFunction;
+        /** @type {FunctionConstructor} */
+        var ctor;
+        /** @type {string} */
+        var sanitizedFilename = opts.filename ? JSON.stringify(opts.filename) : 'undefined';
+        if (!this.source) {
+            this.generateSource();
+            prepended +=
+                '  var __output = "";\n' +
+                    '  function __append(s) { if (s !== undefined &amp;&amp; s !== null) __output += s }\n';
+            if (opts.outputFunctionName) {
+                if (!_JS_IDENTIFIER.test(opts.outputFunctionName)) {
+                    throw new Error('outputFunctionName is not a valid JS identifier.');
+                }
+                prepended += '  var ' + opts.outputFunctionName + ' = __append;' + '\n';
+            }
+            if (opts.localsName &amp;&amp; !_JS_IDENTIFIER.test(opts.localsName)) {
+                throw new Error('localsName is not a valid JS identifier.');
+            }
+            if (opts.destructuredLocals &amp;&amp; opts.destructuredLocals.length) {
+                var destructuring = '  var __locals = (' + opts.localsName + ' || {}),\n';
+                for (var i = 0; i &lt; opts.destructuredLocals.length; i++) {
+                    var name_1 = opts.destructuredLocals[i];
+                    if (!_JS_IDENTIFIER.test(name_1)) {
+                        throw new Error('destructuredLocals[' + i + '] is not a valid JS identifier.');
+                    }
+                    if (i > 0) {
+                        destructuring += ',\n  ';
+                    }
+                    destructuring += name_1 + ' = __locals.' + name_1;
+                }
+                prepended += destructuring + ';\n';
+            }
+            if (opts._with !== false) {
+                prepended += '  with (' + opts.localsName + ' || {}) {' + '\n';
+                appended += '  }' + '\n';
+            }
+            appended += '  return __output;' + '\n';
+            this.source = prepended + this.source + appended;
+        }
+        if (opts.compileDebug) {
+            src = 'var __line = 1' + '\n'
+                + '  , __lines = ' + JSON.stringify(this.templateText) + '\n'
+                + '  , __filename = ' + sanitizedFilename + ';' + '\n'
+                + 'try {' + '\n'
+                + this.source
+                + '} catch (e) {' + '\n'
+                + '  rethrow(e, __lines, __filename, __line, escapeFn);' + '\n'
+                + '}' + '\n';
+        }
+        else {
+            src = this.source;
+        }
+        if (opts.client) {
+            src = 'escapeFn = escapeFn || ' + escapeFn.toString() + ';' + '\n' + src;
+            if (opts.compileDebug) {
+                src = 'rethrow = rethrow || ' + rethrow.toString() + ';' + '\n' + src;
+            }
+        }
+        if (opts.strict) {
+            src = '"use strict";\n' + src;
+        }
+        if (opts.debug) {
+            console.log(src);
+        }
+        if (opts.compileDebug &amp;&amp; opts.filename) {
+            src = src + '\n'
+                + '//# sourceURL=' + sanitizedFilename + '\n';
+        }
+        try {
+            if (opts.async) {
+                // Have to use generated function for this, since in envs without support,
+                // it breaks in parsing
+                try {
+                    ctor = (new Function('return (async function(){}).constructor;'))();
+                }
+                catch (e) {
+                    if (e instanceof SyntaxError) {
+                        throw new Error('This environment does not support async/await');
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            }
+            else {
+                ctor = Function;
+            }
+            fn = new ctor(opts.localsName + ', escapeFn, include, rethrow', src);
+        }
+        catch (e) {
+            // istanbul ignore else
+            if (e instanceof SyntaxError) {
+                if (opts.filename) {
+                    e.message += ' in ' + opts.filename;
+                }
+                e.message += ' while compiling ejs\n\n';
+                e.message += 'If the above error is not helpful, you may want to try EJS-Lint:\n';
+                e.message += 'https://github.com/RyanZim/EJS-Lint';
+                if (!opts.async) {
+                    e.message += '\n';
+                    e.message += 'Or, if you meant to create an async function, pass `async: true` as an option.';
+                }
+            }
+            throw e;
+        }
+        // Return a callable function which will execute the function
+        // created by the source-code, with the passed data as locals
+        // Adds a local `include` function which allows full recursive include
+        var returnedFn = opts.client ? fn : function anonymous(data) {
+            var include = function (path, includeData) {
+                var d = utils_js_1.default.shallowCopy(utils_js_1.default.createNullProtoObjWherePossible(), data);
+                if (includeData) {
+                    d = utils_js_1.default.shallowCopy(d, includeData);
+                }
+                return includeFile(path, opts)(d);
+            };
+            return fn.apply(opts.context, [data || utils_js_1.default.createNullProtoObjWherePossible(), escapeFn, include, rethrow]);
+        };
+        if (opts.filename &amp;&amp; typeof Object.defineProperty === 'function') {
+            var filename = opts.filename;
+            var basename = path_1.default.basename(filename, path_1.default.extname(filename));
+            try {
+                Object.defineProperty(returnedFn, 'name', {
+                    value: basename,
+                    writable: false,
+                    enumerable: false,
+                    configurable: true
+                });
+            }
+            catch (e) { /* ignore */ }
+        }
+        return returnedFn;
+    },
+    generateSource: function () {
+        var opts = this.opts;
+        if (opts.rmWhitespace) {
+            // Have to use two separate replace here as `^` and `$` operators don't
+            // work well with `\r` and empty lines don't work well with the `m` flag.
+            this.templateText =
+                this.templateText.replace(/[\r\n]+/g, '\n').replace(/^\s+|\s+$/gm, '');
+        }
+        // Slurp spaces and tabs before &lt;%_ and after _%>
+        this.templateText =
+            this.templateText.replace(/[ \t]*&lt;%_/gm, '&lt;%_').replace(/_%>[ \t]*/gm, '_%>');
+        var self = this;
+        var matches = this.parseTemplateText();
+        var d = this.opts.delimiter;
+        var o = this.opts.openDelimiter;
+        var c = this.opts.closeDelimiter;
+        if (matches &amp;&amp; matches.length) {
+            matches.forEach(function (line, index) {
+                var closing;
+                // If this is an opening tag, check for closing tags
+                // FIXME: May end up with some false positives here
+                // Better to store modes as k/v with openDelimiter + delimiter as key
+                // Then this can simply check against the map
+                if (line.indexOf(o + d) === 0 // If it is a tag
+                    &amp;&amp; line.indexOf(o + d + d) !== 0) { // and is not escaped
+                    closing = matches[index + 2];
+                    if (!(closing == d + c || closing == '-' + d + c || closing == '_' + d + c)) {
+                        throw new Error('Could not find matching close tag for "' + line + '".');
+                    }
+                }
+                self.scanLine(line);
+            });
+        }
+    },
+    parseTemplateText: function () {
+        var str = this.templateText;
+        var pat = this.regex;
+        var result = pat.exec(str);
+        var arr = [];
+        var firstPos;
+        while (result) {
+            firstPos = result.index;
+            if (firstPos !== 0) {
+                arr.push(str.substring(0, firstPos));
+                str = str.slice(firstPos);
+            }
+            arr.push(result[0]);
+            str = str.slice(result[0].length);
+            result = pat.exec(str);
+        }
+        if (str) {
+            arr.push(str);
+        }
+        return arr;
+    },
+    _addOutput: function (line) {
+        if (this.truncate) {
+            // Only replace single leading linebreak in the line after
+            // -%> tag -- this is the single, trailing linebreak
+            // after the tag that the truncation mode replaces
+            // Handle Win / Unix / old Mac linebreaks -- do the \r\n
+            // combo first in the regex-or
+            line = line.replace(/^(?:\r\n|\r|\n)/, '');
+            this.truncate = false;
+        }
+        if (!line) {
+            return line;
+        }
+        // Preserve literal slashes
+        line = line.replace(/\\/g, '\\\\');
+        // Convert linebreaks
+        line = line.replace(/\n/g, '\\n');
+        line = line.replace(/\r/g, '\\r');
+        // Escape double-quotes
+        // - this will be the delimiter during execution
+        line = line.replace(/"/g, '\\"');
+        this.source += '    ; __append("' + line + '")' + '\n';
+    },
+    scanLine: function (line) {
+        var self = this;
+        var d = this.opts.delimiter;
+        var o = this.opts.openDelimiter;
+        var c = this.opts.closeDelimiter;
+        var newLineCount = 0;
+        newLineCount = (line.split('\n').length - 1);
+        switch (line) {
+            case o + d:
+            case o + d + '_':
+                this.mode = Template.modes.EVAL;
+                break;
+            case o + d + '=':
+                this.mode = Template.modes.ESCAPED;
+                break;
+            case o + d + '-':
+                this.mode = Template.modes.RAW;
+                break;
+            case o + d + '#':
+                this.mode = Template.modes.COMMENT;
+                break;
+            case o + d + d:
+                this.mode = Template.modes.LITERAL;
+                this.source += '    ; __append("' + line.replace(o + d + d, o + d) + '")' + '\n';
+                break;
+            case d + d + c:
+                this.mode = Template.modes.LITERAL;
+                this.source += '    ; __append("' + line.replace(d + d + c, d + c) + '")' + '\n';
+                break;
+            case d + c:
+            case '-' + d + c:
+            case '_' + d + c:
+                if (this.mode == Template.modes.LITERAL) {
+                    this._addOutput(line);
+                }
+                this.mode = null;
+                this.truncate = line.indexOf('-') === 0 || line.indexOf('_') === 0;
+                break;
+            default:
+                // In script mode, depends on type of tag
+                if (this.mode) {
+                    // If '//' is found without a line break, add a line break.
+                    switch (this.mode) {
+                        case Template.modes.EVAL:
+                        case Template.modes.ESCAPED:
+                        case Template.modes.RAW:
+                            if (line.lastIndexOf('//') > line.lastIndexOf('\n')) {
+                                line += '\n';
+                            }
+                    }
+                    switch (this.mode) {
+                        // Just executing code
+                        case Template.modes.EVAL:
+                            this.source += '    ; ' + line + '\n';
+                            break;
+                        // Exec, esc, and output
+                        case Template.modes.ESCAPED:
+                            this.source += '    ; __append(escapeFn(' + stripSemi(line) + '))' + '\n';
+                            break;
+                        // Exec and output
+                        case Template.modes.RAW:
+                            this.source += '    ; __append(' + stripSemi(line) + ')' + '\n';
+                            break;
+                        case Template.modes.COMMENT:
+                            // Do nothing
+                            break;
+                        // Literal &lt;%% mode, append as raw output
+                        case Template.modes.LITERAL:
+                            this._addOutput(line);
+                            break;
+                    }
+                }
+                // In string mode, just add the output
+                else {
+                    this._addOutput(line);
+                }
+        }
+        if (self.opts.compileDebug &amp;&amp; newLineCount) {
+            this.currentLine += newLineCount;
+            this.source += '    ; __line = ' + this.currentLine + '\n';
+        }
+    }
+};
+/**
+ * Escape characters reserved in XML.
+ *
+ * This is simply an export of {@link module:utils.escapeXML}.
+ *
+ * If `markup` is `undefined` or `null`, the empty string is returned.
+ *
+ * @param {String} markup Input string
+ * @return {String} Escaped string
+ * @public
+ * @func
+ * */
+ejs.escapeXML = utils_js_1.default.escapeXML;
+/**
+ * Express.js support.
+ *
+ * This is an alias for {@link module:ejs.renderFile}, in order to support
+ * Express.js out-of-the-box.
+ *
+ * @func
+ */
+ejs.__express = ejs.renderFile;
+/**
+ * Version of EJS.
+ *
+ * @readonly
+ * @type {String}
+ * @public
+ */
+ejs.VERSION = _VERSION_STRING;
+/**
+ * Name for detection of EJS.
+ *
+ * @readonly
+ * @type {String}
+ * @public
+ */
+ejs.name = _NAME;
+/* istanbul ignore if */
+if (typeof window != 'undefined') {
+    window.ejs = ejs;
+}
+if (typeof module != 'undefined') {
+    module.exports = ejs;
+}
+exports.default = ejs;
+</code></pre>
+        </article>
+    </section>
+
+
+
+
+</div>
+
+<nav>
+    <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ejs.html">ejs</a></li></ul><h3>Interfaces</h3><ul><li><a href="Cache.html">Cache</a></li></ul><h3>Global</h3><ul><li><a href="global.html#fileLoader">fileLoader</a></li></ul>
+</nav>
+
+<br class="clear">
+
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
+</footer>
+
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>
diff --git a/lib_cjs_utils.js.html b/lib_cjs_utils.js.html
new file mode 100644
index 00000000..fc34b50f
--- /dev/null
+++ b/lib_cjs_utils.js.html
@@ -0,0 +1,297 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>JSDoc: Source: lib/cjs/utils.js</title>
+
+    <script src="scripts/prettify/prettify.js"> </script>
+    <script src="scripts/prettify/lang-css.js"> </script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+
+<body>
+
+<div id="main">
+
+    <h1 class="page-title">Source: lib/cjs/utils.js</h1>
+
+    
+
+
+
+    
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>/*
+ * EJS Embedded JavaScript templates
+ * Copyright 2112 Matthew Eernisse (mde@fleegix.org)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *         http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+*/
+/**
+ * Private utility functions
+ * @module utils
+ * @private
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+var utils = {};
+var regExpChars = /[|\\{}()[\]^$+*?.]/g;
+var hasOwnProperty = Object.prototype.hasOwnProperty;
+var hasOwn = function (obj, key) { return hasOwnProperty.apply(obj, [key]); };
+/**
+ * Escape characters reserved in regular expressions.
+ *
+ * If `string` is `undefined` or `null`, the empty string is returned.
+ *
+ * @param {String} string Input string
+ * @return {String} Escaped string
+ * @static
+ * @private
+ */
+utils.escapeRegExpChars = function (string) {
+    // istanbul ignore if
+    if (!string) {
+        return '';
+    }
+    return String(string).replace(regExpChars, '\\$&amp;');
+};
+var _ENCODE_HTML_RULES = {
+    '&amp;': '&amp;amp;',
+    '&lt;': '&amp;lt;',
+    '>': '&amp;gt;',
+    '"': '&amp;#34;',
+    "'": '&amp;#39;'
+};
+var _MATCH_HTML = /[&amp;&lt;>'"]/g;
+function encode_char(c) {
+    return _ENCODE_HTML_RULES[c] || c;
+}
+/**
+ * Stringified version of constants used by {@link module:utils.escapeXML}.
+ *
+ * It is used in the process of generating {@link ClientFunction}s.
+ *
+ * @readonly
+ * @type {String}
+ */
+var escapeFuncStr = 'var _ENCODE_HTML_RULES = {\n'
+    + '      "&amp;": "&amp;amp;"\n'
+    + '    , "&lt;": "&amp;lt;"\n'
+    + '    , ">": "&amp;gt;"\n'
+    + '    , \'"\': "&amp;#34;"\n'
+    + '    , "\'": "&amp;#39;"\n'
+    + '    }\n'
+    + '  , _MATCH_HTML = /[&amp;&lt;>\'"]/g;\n'
+    + 'function encode_char(c) {\n'
+    + '  return _ENCODE_HTML_RULES[c] || c;\n'
+    + '};\n';
+/**
+ * Escape characters reserved in XML.
+ *
+ * If `markup` is `undefined` or `null`, the empty string is returned.
+ *
+ * @implements {EscapeCallback}
+ * @param {String} markup Input string
+ * @return {String} Escaped string
+ * @static
+ * @private
+ */
+utils.escapeXML = function (markup) {
+    return markup == undefined
+        ? ''
+        : String(markup)
+            .replace(_MATCH_HTML, encode_char);
+};
+function escapeXMLToString() {
+    return Function.prototype.toString.call(this) + ';\n' + escapeFuncStr;
+}
+try {
+    if (typeof Object.defineProperty === 'function') {
+        // If the Function prototype is frozen, the "toString" property is non-writable. This means that any objects which inherit this property
+        // cannot have the property changed using an assignment. If using strict mode, attempting that will cause an error. If not using strict
+        // mode, attempting that will be silently ignored.
+        // However, we can still explicitly shadow the prototype's "toString" property by defining a new "toString" property on this object.
+        Object.defineProperty(utils.escapeXML, 'toString', { value: escapeXMLToString });
+    }
+    else {
+        // If Object.defineProperty() doesn't exist, attempt to shadow this property using the assignment operator.
+        utils.escapeXML.toString = escapeXMLToString;
+    }
+}
+catch (err) {
+    console.warn('Unable to set escapeXML.toString (is the Function prototype frozen?)');
+}
+/**
+ * Naive copy of properties from one object to another.
+ * Does not recurse into non-scalar properties
+ * Does not check to see if the property has a value before copying
+ *
+ * @param  {Object} to   Destination object
+ * @param  {Object} from Source object
+ * @return {Object}      Destination object
+ * @static
+ * @private
+ */
+utils.shallowCopy = function (to, from) {
+    from = from || {};
+    if ((to !== null) &amp;&amp; (to !== undefined)) {
+        for (var p in from) {
+            if (!hasOwn(from, p)) {
+                continue;
+            }
+            if (p === '__proto__' || p === 'constructor') {
+                continue;
+            }
+            to[p] = from[p];
+        }
+    }
+    return to;
+};
+/**
+ * Naive copy of a list of key names, from one object to another.
+ * Only copies property if it is actually defined
+ * Does not recurse into non-scalar properties
+ *
+ * @param  {Object} to   Destination object
+ * @param  {Object} from Source object
+ * @param  {Array} list List of properties to copy
+ * @return {Object}      Destination object
+ * @static
+ * @private
+ */
+utils.shallowCopyFromList = function (to, from, list) {
+    list = list || [];
+    from = from || {};
+    if ((to !== null) &amp;&amp; (to !== undefined)) {
+        for (var i = 0; i &lt; list.length; i++) {
+            var p = list[i];
+            if (typeof from[p] != 'undefined') {
+                if (!hasOwn(from, p)) {
+                    continue;
+                }
+                if (p === '__proto__' || p === 'constructor') {
+                    continue;
+                }
+                to[p] = from[p];
+            }
+        }
+    }
+    return to;
+};
+/**
+ * Simple in-process cache implementation. Does not implement limits of any
+ * sort.
+ *
+ * @implements {Cache}
+ * @static
+ * @private
+ */
+utils.cache = {
+    _data: {},
+    set: function (key, val) {
+        this._data[key] = val;
+    },
+    get: function (key) {
+        return this._data[key];
+    },
+    remove: function (key) {
+        delete this._data[key];
+    },
+    reset: function () {
+        this._data = {};
+    }
+};
+/**
+ * Transforms hyphen case variable into camel case.
+ *
+ * @param {String} string Hyphen case string
+ * @return {String} Camel case string
+ * @static
+ * @private
+ */
+utils.hyphenToCamel = function (str) {
+    return str.replace(/-[a-z]/g, function (match) { return match[1].toUpperCase(); });
+};
+/**
+ * Returns a null-prototype object in runtimes that support it
+ *
+ * @return {Object} Object, prototype will be set to null where possible
+ * @static
+ * @private
+ */
+utils.createNullProtoObjWherePossible = (function () {
+    if (typeof Object.create == 'function') {
+        return function () {
+            return Object.create(null);
+        };
+    }
+    if (!({ __proto__: null } instanceof Object)) {
+        return function () {
+            return { __proto__: null };
+        };
+    }
+    // Not possible, just pass through
+    return function () {
+        return {};
+    };
+})();
+/**
+ * Copies own-properties from one object to a null-prototype object for basic
+ * protection against prototype pollution
+ *
+ * @return {Object} Object with own-properties of input object
+ * @static
+ * @private
+ */
+utils.hasOwnOnlyObject = function (obj) {
+    var o = utils.createNullProtoObjWherePossible();
+    for (var p in obj) {
+        if (hasOwn(obj, p)) {
+            o[p] = obj[p];
+        }
+    }
+    return o;
+};
+if (typeof exports != 'undefined') {
+    module.exports = utils;
+}
+exports.default = utils;
+</code></pre>
+        </article>
+    </section>
+
+
+
+
+</div>
+
+<nav>
+    <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ejs.html">ejs</a></li></ul><h3>Interfaces</h3><ul><li><a href="Cache.html">Cache</a></li></ul><h3>Global</h3><ul><li><a href="global.html#fileLoader">fileLoader</a></li></ul>
+</nav>
+
+<br class="clear">
+
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
+</footer>
+
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>
diff --git a/lib_ejs.js.html b/lib_esm_ejs.js.html
similarity index 69%
rename from lib_ejs.js.html
rename to lib_esm_ejs.js.html
index 4c9fc2fa..99598a2d 100644
--- a/lib_ejs.js.html
+++ b/lib_esm_ejs.js.html
@@ -2,7 +2,7 @@
 <html lang="en">
 <head>
     <meta charset="utf-8">
-    <title>JSDoc: Source: lib/ejs.js</title>
+    <title>JSDoc: Source: lib/esm/ejs.js</title>
 
     <script src="scripts/prettify/prettify.js"> </script>
     <script src="scripts/prettify/lang-css.js"> </script>
@@ -17,7 +17,7 @@
 
 <div id="main">
 
-    <h1 class="page-title">Source: lib/ejs.js</h1>
+    <h1 class="page-title">Source: lib/esm/ejs.js</h1>
 
     
 
@@ -46,10 +46,14 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
 
 'use strict';
 
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import utils from './utils.js';
+
 /**
  * @file Embedded JavaScript templating engine. {@link http://ejs.co}
  * @author Matthew Eernisse &lt;mde@fleegix.org>
- * @author Tiancheng "Timothy" Gu &lt;timothygu99@gmail.com>
  * @project EJS
  * @license {@link http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0}
  */
@@ -72,25 +76,36 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  */
 
-var fs = require('fs');
-var path = require('path');
-var utils = require('./utils');
-
-var scopeOptionWarned = false;
-var _VERSION_STRING = require('../package.json').version;
-var _DEFAULT_OPEN_DELIMITER = '&lt;';
-var _DEFAULT_CLOSE_DELIMITER = '>';
-var _DEFAULT_DELIMITER = '%';
-var _DEFAULT_LOCALS_NAME = 'locals';
-var _NAME = 'ejs';
-var _REGEX_STRING = '(&lt;%%|%%>|&lt;%=|&lt;%-|&lt;%_|&lt;%#|&lt;%|%>|-%>|_%>)';
-var _OPTS_PASSABLE_WITH_DATA = ['delimiter', 'scope', 'context', 'debug', 'compileDebug',
+// Shims for file/dir in ESM -- do not alter the code below, it generates code
+// that has to be removed in the CJS build by string replacement
+let __filename, __dirname;
+if (typeof __filename == 'undefined') {
+  __filename = fileURLToPath(import.meta.url);
+}
+if (typeof __dirname == 'undefined') {
+  __dirname = path.dirname(__filename);
+}
+
+const ejs = {};
+let pkg = fs.readFileSync(path.join(__dirname, '../../package.json'), 'utf-8');
+pkg = JSON.parse(pkg);
+
+/** @type {string} */
+let _VERSION_STRING = pkg.version;
+let _DEFAULT_OPEN_DELIMITER = '&lt;';
+let _DEFAULT_CLOSE_DELIMITER = '>';
+let _DEFAULT_DELIMITER = '%';
+let _DEFAULT_LOCALS_NAME = 'locals';
+let _NAME = 'ejs';
+let _REGEX_STRING = '(&lt;%%|%%>|&lt;%=|&lt;%-|&lt;%_|&lt;%#|&lt;%|%>|-%>|_%>)';
+let _OPTS_PASSABLE_WITH_DATA = ['delimiter', 'scope', 'context', 'debug', 'compileDebug',
   'client', '_with', 'rmWhitespace', 'strict', 'filename', 'async'];
 // We don't allow 'cache' option to be passed in the data obj for
 // the normal `render` call, but this is where Express 2 &amp; 3 put it
 // so we make an exception for `renderFile`
-var _OPTS_PASSABLE_WITH_DATA_EXPRESS = _OPTS_PASSABLE_WITH_DATA.concat('cache');
-var _BOM = /^\uFEFF/;
+let _OPTS_PASSABLE_WITH_DATA_EXPRESS = _OPTS_PASSABLE_WITH_DATA.concat('cache');
+let _BOM = /^\uFEFF/;
+let _JS_IDENTIFIER = /^[a-zA-Z_$][0-9a-zA-Z_$]*$/;
 
 /**
  * EJS template function cache. This can be a LRU object from lru-cache NPM
@@ -100,7 +115,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @type {Cache}
  */
 
-exports.cache = utils.cache;
+ejs.cache = utils.cache;
 
 /**
  * Custom file loader. Useful for template preprocessing or restricting access
@@ -109,7 +124,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @type {fileLoader}
  */
 
-exports.fileLoader = fs.readFileSync;
+ejs.fileLoader = fs.readFileSync;
 
 /**
  * Name of the object containing the locals.
@@ -121,17 +136,17 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  */
 
-exports.localsName = _DEFAULT_LOCALS_NAME;
+ejs.localsName = _DEFAULT_LOCALS_NAME;
 
 /**
  * Promise implementation -- defaults to the native implementation if available
  * This is mostly just for testability
  *
- * @type {Function}
+ * @type {PromiseConstructorLike}
  * @public
  */
 
-exports.promiseImpl = (new Function('return this;'))().Promise;
+ejs.promiseImpl = (new Function('return this;'))().Promise;
 
 /**
  * Get the path to the included file from the parent file path and the
@@ -139,21 +154,38 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  *
  * @param {String}  name     specified path
  * @param {String}  filename parent file path
- * @param {Boolean} isDir    parent file path whether is directory
+ * @param {Boolean} [isDir=false] whether the parent file path is a directory
  * @return {String}
  */
-exports.resolveInclude = function(name, filename, isDir) {
-  var dirname = path.dirname;
-  var extname = path.extname;
-  var resolve = path.resolve;
-  var includePath = resolve(isDir ? filename : dirname(filename), name);
-  var ext = extname(name);
+ejs.resolveInclude = function(name, filename, isDir) {
+  let dirname = path.dirname;
+  let extname = path.extname;
+  let resolve = path.resolve;
+  let includePath = resolve(isDir ? filename : dirname(filename), name);
+  let ext = extname(name);
   if (!ext) {
     includePath += '.ejs';
   }
   return includePath;
 };
 
+/**
+ * Try to resolve file path on multiple directories
+ *
+ * @param  {String}        name  specified path
+ * @param  {Array&lt;String>} paths list of possible parent directory paths
+ * @return {String}
+ */
+function resolvePaths(name, paths) {
+  let filePath;
+  if (paths.some(function (v) {
+    filePath = ejs.resolveInclude(name, v, true);
+    return fs.existsSync(filePath);
+  })) {
+    return filePath;
+  }
+}
+
 /**
  * Get the path to the included file by Options
  *
@@ -162,34 +194,34 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @return {String}
  */
 function getIncludePath(path, options) {
-  var includePath;
-  var filePath;
-  var views = options.views;
-  var match = /^[A-Za-z]+:\\|^\//.exec(path);
+  let includePath;
+  let filePath;
+  let views = options.views;
+  let match = /^[A-Za-z]+:\\|^\//.exec(path);
 
   // Abs path
   if (match &amp;&amp; match.length) {
-    includePath = exports.resolveInclude(path.replace(/^\/*/,''), options.root || '/', true);
+    path = path.replace(/^\/*/, '');
+    if (Array.isArray(options.root)) {
+      includePath = resolvePaths(path, options.root);
+    } else {
+      includePath = ejs.resolveInclude(path, options.root || '/', true);
+    }
   }
   // Relative paths
   else {
     // Look relative to a passed filename first
     if (options.filename) {
-      filePath = exports.resolveInclude(path, options.filename);
+      filePath = ejs.resolveInclude(path, options.filename);
       if (fs.existsSync(filePath)) {
         includePath = filePath;
       }
     }
     // Then look in any views directories
-    if (!includePath) {
-      if (Array.isArray(views) &amp;&amp; views.some(function (v) {
-        filePath = exports.resolveInclude(path, v, true);
-        return fs.existsSync(filePath);
-      })) {
-        includePath = filePath;
-      }
+    if (!includePath &amp;&amp; Array.isArray(views)) {
+      includePath = resolvePaths(path, views);
     }
-    if (!includePath) {
+    if (!includePath &amp;&amp; typeof options.includer !== 'function') {
       throw new Error('Could not find the include file "' +
           options.escapeFunction(path) + '"');
     }
@@ -216,15 +248,15 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  */
 
 function handleCache(options, template) {
-  var func;
-  var filename = options.filename;
-  var hasTemplate = arguments.length > 1;
+  let func;
+  let filename = options.filename;
+  let hasTemplate = arguments.length > 1;
 
   if (options.cache) {
     if (!filename) {
       throw new Error('cache option requires a filename');
     }
-    func = exports.cache.get(filename);
+    func = ejs.cache.get(filename);
     if (func) {
       return func;
     }
@@ -240,9 +272,9 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
     }
     template = fileLoader(filename).toString().replace(_BOM, '');
   }
-  func = exports.compile(template, options);
+  func = ejs.compile(template, options);
   if (options.cache) {
-    exports.cache.set(filename, func);
+    ejs.cache.set(filename, func);
   }
   return func;
 }
@@ -260,10 +292,10 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  */
 
 function tryHandleCache(options, data, cb) {
-  var result;
+  let result;
   if (!cb) {
-    if (typeof exports.promiseImpl == 'function') {
-      return new exports.promiseImpl(function (resolve, reject) {
+    if (typeof ejs.promiseImpl == 'function') {
+      return new ejs.promiseImpl(function (resolve, reject) {
         try {
           result = handleCache(options)(data);
           resolve(result);
@@ -298,7 +330,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  */
 
 function fileLoader(filePath){
-  return exports.fileLoader(filePath);
+  return ejs.fileLoader(filePath);
 }
 
 /**
@@ -315,58 +347,44 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  */
 
 function includeFile(path, options) {
-  var opts = utils.shallowCopy({}, options);
+  let opts = utils.shallowCopy(utils.createNullProtoObjWherePossible(), options);
   opts.filename = getIncludePath(path, opts);
+  if (typeof options.includer === 'function') {
+    let includerResult = options.includer(path, opts.filename);
+    if (includerResult) {
+      if (includerResult.filename) {
+        opts.filename = includerResult.filename;
+      }
+      if (includerResult.template) {
+        return handleCache(opts, includerResult.template);
+      }
+    }
+  }
   return handleCache(opts);
 }
 
-/**
- * Get the JavaScript source of an included file.
- *
- * @memberof module:ejs-internal
- * @param {String}  path    path for the specified file
- * @param {Options} options compilation options
- * @return {Object}
- * @static
- */
-
-function includeSource(path, options) {
-  var opts = utils.shallowCopy({}, options);
-  var includePath;
-  var template;
-  includePath = getIncludePath(path, opts);
-  template = fileLoader(includePath).toString().replace(_BOM, '');
-  opts.filename = includePath;
-  var templ = new Template(template, opts);
-  templ.generateSource();
-  return {
-    source: templ.source,
-    filename: includePath,
-    template: template
-  };
-}
-
 /**
  * Re-throw the given `err` in context to the `str` of ejs, `filename`, and
  * `lineno`.
  *
- * @implements RethrowCallback
+ * @implements {RethrowCallback}
  * @memberof module:ejs-internal
  * @param {Error}  err      Error object
  * @param {String} str      EJS source
- * @param {String} filename file name of the EJS file
- * @param {String} lineno   line number of the error
+ * @param {String} flnm     file name of the EJS file
+ * @param {Number} lineno   line number of the error
+ * @param {EscapeCallback} esc
  * @static
  */
 
-function rethrow(err, str, flnm, lineno, esc){
-  var lines = str.split('\n');
-  var start = Math.max(lineno - 3, 0);
-  var end = Math.min(lines.length, lineno + 3);
-  var filename = esc(flnm); // eslint-disable-line
+function rethrow(err, str, flnm, lineno, esc) {
+  let lines = str.split('\n');
+  let start = Math.max(lineno - 3, 0);
+  let end = Math.min(lines.length, lineno + 3);
+  let filename = esc(flnm);
   // Error context
-  var context = lines.slice(start, end).map(function (line, i){
-    var curr = i + start + 1;
+  let context = lines.slice(start, end).map(function (line, i){
+    let curr = i + start + 1;
     return (curr == lineno ? ' >> ' : '    ')
       + curr
       + '| '
@@ -392,7 +410,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  *
  * @param {String}  template EJS template
  *
- * @param {Options} opts     compilation options
+ * @param {Options} [opts] compilation options
  *
  * @return {(TemplateFunction|ClientFunction)}
  * Depending on the value of `opts.client`, either type might be returned.
@@ -400,17 +418,14 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  */
 
-exports.compile = function compile(template, opts) {
-  var templ;
+ejs.compile = function compile(template, opts) {
+  let templ;
 
   // v1 compat
   // 'scope' is 'context'
   // FIXME: Remove this in a future version
   if (opts &amp;&amp; opts.scope) {
-    if (!scopeOptionWarned){
-      console.warn('`scope` option is deprecated and will be removed in EJS 3');
-      scopeOptionWarned = true;
-    }
+    console.warn('`scope` option is deprecated and will be removed in future EJS');
     if (!opts.context) {
       opts.context = opts.scope;
     }
@@ -434,9 +449,9 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  */
 
-exports.render = function (template, d, o) {
-  var data = d || {};
-  var opts = o || {};
+ejs.render = function (template, d, o) {
+  let data = d || utils.createNullProtoObjWherePossible();
+  let opts = o || utils.createNullProtoObjWherePossible();
 
   // No options object -- if there are optiony names
   // in the data, copy them to options
@@ -460,13 +475,13 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  */
 
-exports.renderFile = function () {
-  var args = Array.prototype.slice.call(arguments);
-  var filename = args.shift();
-  var cb;
-  var opts = {filename: filename};
-  var data;
-  var viewOpts;
+ejs.renderFile = function () {
+  let args = Array.prototype.slice.call(arguments);
+  let filename = args.shift();
+  let cb;
+  let opts = {filename: filename};
+  let data;
+  let viewOpts;
 
   // Do we have a callback?
   if (typeof arguments[arguments.length - 1] == 'function') {
@@ -507,7 +522,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
     opts.filename = filename;
   }
   else {
-    data = {};
+    data = utils.createNullProtoObjWherePossible();
   }
 
   return tryHandleCache(opts, data, cb);
@@ -522,38 +537,41 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * EJS template class
  * @public
  */
-exports.Template = Template;
+ejs.Template = Template;
 
-exports.clearCache = function () {
-  exports.cache.reset();
+ejs.clearCache = function () {
+  ejs.cache.reset();
 };
 
-function Template(text, opts) {
-  opts = opts || {};
-  var options = {};
+function Template(text, optsParam) {
+  let opts = utils.hasOwnOnlyObject(optsParam);
+  let options = utils.createNullProtoObjWherePossible();
   this.templateText = text;
+  /** @type {string | null} */
   this.mode = null;
   this.truncate = false;
   this.currentLine = 1;
   this.source = '';
-  this.dependencies = [];
   options.client = opts.client || false;
   options.escapeFunction = opts.escape || opts.escapeFunction || utils.escapeXML;
   options.compileDebug = opts.compileDebug !== false;
   options.debug = !!opts.debug;
   options.filename = opts.filename;
-  options.openDelimiter = opts.openDelimiter || exports.openDelimiter || _DEFAULT_OPEN_DELIMITER;
-  options.closeDelimiter = opts.closeDelimiter || exports.closeDelimiter || _DEFAULT_CLOSE_DELIMITER;
-  options.delimiter = opts.delimiter || exports.delimiter || _DEFAULT_DELIMITER;
+  options.openDelimiter = opts.openDelimiter || ejs.openDelimiter || _DEFAULT_OPEN_DELIMITER;
+  options.closeDelimiter = opts.closeDelimiter || ejs.closeDelimiter || _DEFAULT_CLOSE_DELIMITER;
+  options.delimiter = opts.delimiter || ejs.delimiter || _DEFAULT_DELIMITER;
   options.strict = opts.strict || false;
   options.context = opts.context;
   options.cache = opts.cache || false;
   options.rmWhitespace = opts.rmWhitespace;
   options.root = opts.root;
+  options.includer = opts.includer;
   options.outputFunctionName = opts.outputFunctionName;
-  options.localsName = opts.localsName || exports.localsName || _DEFAULT_LOCALS_NAME;
+  options.localsName = opts.localsName || ejs.localsName || _DEFAULT_LOCALS_NAME;
   options.views = opts.views;
   options.async = opts.async;
+  options.destructuredLocals = opts.destructuredLocals;
+  options.legacyInclude = typeof opts.legacyInclude != 'undefined' ? !!opts.legacyInclude : true;
 
   if (options.strict) {
     options._with = false;
@@ -577,10 +595,10 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
 
 Template.prototype = {
   createRegex: function () {
-    var str = _REGEX_STRING;
-    var delim = utils.escapeRegExpChars(this.opts.delimiter);
-    var open = utils.escapeRegExpChars(this.opts.openDelimiter);
-    var close = utils.escapeRegExpChars(this.opts.closeDelimiter);
+    let str = _REGEX_STRING;
+    let delim = utils.escapeRegExpChars(this.opts.delimiter);
+    let open = utils.escapeRegExpChars(this.opts.openDelimiter);
+    let close = utils.escapeRegExpChars(this.opts.closeDelimiter);
     str = str.replace(/%/g, delim)
       .replace(/&lt;/g, open)
       .replace(/>/g, close);
@@ -588,33 +606,60 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
   },
 
   compile: function () {
-    var src;
-    var fn;
-    var opts = this.opts;
-    var prepended = '';
-    var appended = '';
-    var escapeFn = opts.escapeFunction;
-    var ctor;
+    /** @type {string} */
+    let src;
+    /** @type {ClientFunction} */
+    let fn;
+    let opts = this.opts;
+    let prepended = '';
+    let appended = '';
+    /** @type {EscapeCallback} */
+    let escapeFn = opts.escapeFunction;
+    /** @type {FunctionConstructor} */
+    let ctor;
+    /** @type {string} */
+    let sanitizedFilename = opts.filename ? JSON.stringify(opts.filename) : 'undefined';
 
     if (!this.source) {
       this.generateSource();
-      prepended += '  var __output = [], __append = __output.push.bind(__output);' + '\n';
+      prepended +=
+        '  let __output = "";\n' +
+        '  function __append(s) { if (s !== undefined &amp;&amp; s !== null) __output += s }\n';
       if (opts.outputFunctionName) {
-        prepended += '  var ' + opts.outputFunctionName + ' = __append;' + '\n';
+        if (!_JS_IDENTIFIER.test(opts.outputFunctionName)) {
+          throw new Error('outputFunctionName is not a valid JS identifier.');
+        }
+        prepended += '  let ' + opts.outputFunctionName + ' = __append;' + '\n';
+      }
+      if (opts.localsName &amp;&amp; !_JS_IDENTIFIER.test(opts.localsName)) {
+        throw new Error('localsName is not a valid JS identifier.');
+      }
+      if (opts.destructuredLocals &amp;&amp; opts.destructuredLocals.length) {
+        let destructuring = '  let __locals = (' + opts.localsName + ' || {}),\n';
+        for (let i = 0; i &lt; opts.destructuredLocals.length; i++) {
+          let name = opts.destructuredLocals[i];
+          if (!_JS_IDENTIFIER.test(name)) {
+            throw new Error('destructuredLocals[' + i + '] is not a valid JS identifier.');
+          }
+          if (i > 0) {
+            destructuring += ',\n  ';
+          }
+          destructuring += name + ' = __locals.' + name;
+        }
+        prepended += destructuring + ';\n';
       }
       if (opts._with !== false) {
         prepended +=  '  with (' + opts.localsName + ' || {}) {' + '\n';
         appended += '  }' + '\n';
       }
-      appended += '  return __output.join("");' + '\n';
+      appended += '  return __output;' + '\n';
       this.source = prepended + this.source + appended;
     }
 
     if (opts.compileDebug) {
-      src = 'var __line = 1' + '\n'
+      src = 'let __line = 1' + '\n'
         + '  , __lines = ' + JSON.stringify(this.templateText) + '\n'
-        + '  , __filename = ' + (opts.filename ?
-        JSON.stringify(opts.filename) : 'undefined') + ';' + '\n'
+        + '  , __filename = ' + sanitizedFilename + ';' + '\n'
         + 'try {' + '\n'
         + this.source
         + '} catch (e) {' + '\n'
@@ -638,6 +683,10 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
     if (opts.debug) {
       console.log(src);
     }
+    if (opts.compileDebug &amp;&amp; opts.filename) {
+      src = src + '\n'
+        + '//# sourceURL=' + sanitizedFilename + '\n';
+    }
 
     try {
       if (opts.async) {
@@ -669,38 +718,45 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
         e.message += ' while compiling ejs\n\n';
         e.message += 'If the above error is not helpful, you may want to try EJS-Lint:\n';
         e.message += 'https://github.com/RyanZim/EJS-Lint';
-        if (!e.async) {
+        if (!opts.async) {
           e.message += '\n';
-          e.message += 'Or, if you meant to create an async function, pass async: true as an option.';
+          e.message += 'Or, if you meant to create an async function, pass `async: true` as an option.';
         }
       }
       throw e;
     }
 
-    if (opts.client) {
-      fn.dependencies = this.dependencies;
-      return fn;
-    }
-
     // Return a callable function which will execute the function
     // created by the source-code, with the passed data as locals
     // Adds a local `include` function which allows full recursive include
-    var returnedFn = function (data) {
-      var include = function (path, includeData) {
-        var d = utils.shallowCopy({}, data);
+    let returnedFn = opts.client ? fn : function anonymous(data) {
+      let include = function (path, includeData) {
+        let d = utils.shallowCopy(utils.createNullProtoObjWherePossible(), data);
         if (includeData) {
           d = utils.shallowCopy(d, includeData);
         }
         return includeFile(path, opts)(d);
       };
-      return fn.apply(opts.context, [data || {}, escapeFn, include, rethrow]);
+      return fn.apply(opts.context,
+        [data || utils.createNullProtoObjWherePossible(), escapeFn, include, rethrow]);
     };
-    returnedFn.dependencies = this.dependencies;
+    if (opts.filename &amp;&amp; typeof Object.defineProperty === 'function') {
+      let filename = opts.filename;
+      let basename = path.basename(filename, path.extname(filename));
+      try {
+        Object.defineProperty(returnedFn, 'name', {
+          value: basename,
+          writable: false,
+          enumerable: false,
+          configurable: true
+        });
+      } catch (e) {/* ignore */}
+    }
     return returnedFn;
   },
 
   generateSource: function () {
-    var opts = this.opts;
+    let opts = this.opts;
 
     if (opts.rmWhitespace) {
       // Have to use two separate replace here as `^` and `$` operators don't
@@ -713,20 +769,15 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
     this.templateText =
       this.templateText.replace(/[ \t]*&lt;%_/gm, '&lt;%_').replace(/_%>[ \t]*/gm, '_%>');
 
-    var self = this;
-    var matches = this.parseTemplateText();
-    var d = this.opts.delimiter;
-    var o = this.opts.openDelimiter;
-    var c = this.opts.closeDelimiter;
+    let self = this;
+    let matches = this.parseTemplateText();
+    let d = this.opts.delimiter;
+    let o = this.opts.openDelimiter;
+    let c = this.opts.closeDelimiter;
 
     if (matches &amp;&amp; matches.length) {
       matches.forEach(function (line, index) {
-        var opening;
-        var closing;
-        var include;
-        var includeOpts;
-        var includeObj;
-        var includeSrc;
+        let closing;
         // If this is an opening tag, check for closing tags
         // FIXME: May end up with some false positives here
         // Better to store modes as k/v with openDelimiter + delimiter as key
@@ -738,35 +789,6 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
             throw new Error('Could not find matching close tag for "' + line + '".');
           }
         }
-        // HACK: backward-compat `include` preprocessor directives
-        if ((include = line.match(/^\s*include\s+(\S+)/))) {
-          opening = matches[index - 1];
-          // Must be in EVAL or RAW mode
-          if (opening &amp;&amp; (opening == o + d || opening == o + d + '-' || opening == o + d + '_')) {
-            includeOpts = utils.shallowCopy({}, self.opts);
-            includeObj = includeSource(include[1], includeOpts);
-            if (self.opts.compileDebug) {
-              includeSrc =
-                  '    ; (function(){' + '\n'
-                  + '      var __line = 1' + '\n'
-                  + '      , __lines = ' + JSON.stringify(includeObj.template) + '\n'
-                  + '      , __filename = ' + JSON.stringify(includeObj.filename) + ';' + '\n'
-                  + '      try {' + '\n'
-                  + includeObj.source
-                  + '      } catch (e) {' + '\n'
-                  + '        rethrow(e, __lines, __filename, __line, escapeFn);' + '\n'
-                  + '      }' + '\n'
-                  + '    ; }).call(this)' + '\n';
-            }else{
-              includeSrc = '    ; (function(){' + '\n' + includeObj.source +
-                  '    ; }).call(this)' + '\n';
-            }
-            self.source += includeSrc;
-            self.dependencies.push(exports.resolveInclude(include[1],
-              includeOpts.filename));
-            return;
-          }
-        }
         self.scanLine(line);
       });
     }
@@ -774,11 +796,11 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
   },
 
   parseTemplateText: function () {
-    var str = this.templateText;
-    var pat = this.regex;
-    var result = pat.exec(str);
-    var arr = [];
-    var firstPos;
+    let str = this.templateText;
+    let pat = this.regex;
+    let result = pat.exec(str);
+    let arr = [];
+    let firstPos;
 
     while (result) {
       firstPos = result.index;
@@ -828,11 +850,11 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
   },
 
   scanLine: function (line) {
-    var self = this;
-    var d = this.opts.delimiter;
-    var o = this.opts.openDelimiter;
-    var c = this.opts.closeDelimiter;
-    var newLineCount = 0;
+    let self = this;
+    let d = this.opts.delimiter;
+    let o = this.opts.openDelimiter;
+    let c = this.opts.closeDelimiter;
+    let newLineCount = 0;
 
     newLineCount = (line.split('\n').length - 1);
 
@@ -927,7 +949,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  * @func
  * */
-exports.escapeXML = utils.escapeXML;
+ejs.escapeXML = utils.escapeXML;
 
 /**
  * Express.js support.
@@ -938,23 +960,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @func
  */
 
-exports.__express = exports.renderFile;
-
-// Add require support
-/* istanbul ignore else */
-if (require.extensions) {
-  require.extensions['.ejs'] = function (module, flnm) {
-    console.log('Deprecated: this API will go away in EJS v2.8');
-    var filename = flnm || /* istanbul ignore next */ module.filename;
-    var options = {
-      filename: filename,
-      client: true
-    };
-    var template = fileLoader(filename).toString();
-    var fn = exports.compile(template, options);
-    module._compile('module.exports = ' + fn.toString() + ';', filename);
-  };
-}
+ejs.__express = ejs.renderFile;
 
 /**
  * Version of EJS.
@@ -964,7 +970,7 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  */
 
-exports.VERSION = _VERSION_STRING;
+ejs.VERSION = _VERSION_STRING;
 
 /**
  * Name for detection of EJS.
@@ -974,12 +980,17 @@ <h1 class="page-title">Source: lib/ejs.js</h1>
  * @public
  */
 
-exports.name = _NAME;
+ejs.name = _NAME;
 
 /* istanbul ignore if */
 if (typeof window != 'undefined') {
-  window.ejs = exports;
+  window.ejs = ejs;
+}
+
+if (typeof module != 'undefined') {
+  module.exports = ejs;
 }
+export default ejs;
 </code></pre>
         </article>
     </section>
@@ -996,7 +1007,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/lib_utils.js.html b/lib_esm_utils.js.html
similarity index 57%
rename from lib_utils.js.html
rename to lib_esm_utils.js.html
index 9d8d8b0a..03271423 100644
--- a/lib_utils.js.html
+++ b/lib_esm_utils.js.html
@@ -2,7 +2,7 @@
 <html lang="en">
 <head>
     <meta charset="utf-8">
-    <title>JSDoc: Source: lib/utils.js</title>
+    <title>JSDoc: Source: lib/esm/utils.js</title>
 
     <script src="scripts/prettify/prettify.js"> </script>
     <script src="scripts/prettify/lang-css.js"> </script>
@@ -17,7 +17,7 @@
 
 <div id="main">
 
-    <h1 class="page-title">Source: lib/utils.js</h1>
+    <h1 class="page-title">Source: lib/esm/utils.js</h1>
 
     
 
@@ -52,7 +52,10 @@ <h1 class="page-title">Source: lib/utils.js</h1>
 
 'use strict';
 
+const utils = {};
 var regExpChars = /[|\\{}()[\]^$+*?.]/g;
+var hasOwnProperty = Object.prototype.hasOwnProperty;
+var hasOwn = function (obj, key) { return hasOwnProperty.apply(obj, [key]); };
 
 /**
  * Escape characters reserved in regular expressions.
@@ -64,7 +67,7 @@ <h1 class="page-title">Source: lib/utils.js</h1>
  * @static
  * @private
  */
-exports.escapeRegExpChars = function (string) {
+utils.escapeRegExpChars = function (string) {
   // istanbul ignore if
   if (!string) {
     return '';
@@ -119,15 +122,31 @@ <h1 class="page-title">Source: lib/utils.js</h1>
  * @private
  */
 
-exports.escapeXML = function (markup) {
+utils.escapeXML = function (markup) {
   return markup == undefined
     ? ''
     : String(markup)
       .replace(_MATCH_HTML, encode_char);
 };
-exports.escapeXML.toString = function () {
+
+function escapeXMLToString() {
   return Function.prototype.toString.call(this) + ';\n' + escapeFuncStr;
-};
+}
+
+try {
+  if (typeof Object.defineProperty === 'function') {
+  // If the Function prototype is frozen, the "toString" property is non-writable. This means that any objects which inherit this property
+  // cannot have the property changed using an assignment. If using strict mode, attempting that will cause an error. If not using strict
+  // mode, attempting that will be silently ignored.
+  // However, we can still explicitly shadow the prototype's "toString" property by defining a new "toString" property on this object.
+    Object.defineProperty(utils.escapeXML, 'toString', { value: escapeXMLToString });
+  } else {
+    // If Object.defineProperty() doesn't exist, attempt to shadow this property using the assignment operator.
+    utils.escapeXML.toString = escapeXMLToString;
+  }
+} catch (err) {
+  console.warn('Unable to set escapeXML.toString (is the Function prototype frozen?)');
+}
 
 /**
  * Naive copy of properties from one object to another.
@@ -140,10 +159,18 @@ <h1 class="page-title">Source: lib/utils.js</h1>
  * @static
  * @private
  */
-exports.shallowCopy = function (to, from) {
+utils.shallowCopy = function (to, from) {
   from = from || {};
-  for (var p in from) {
-    to[p] = from[p];
+  if ((to !== null) &amp;&amp; (to !== undefined)) {
+    for (var p in from) {
+      if (!hasOwn(from, p)) {
+        continue;
+      }
+      if (p === '__proto__' || p === 'constructor') {
+        continue;
+      }
+      to[p] = from[p];
+    }
   }
   return to;
 };
@@ -160,11 +187,21 @@ <h1 class="page-title">Source: lib/utils.js</h1>
  * @static
  * @private
  */
-exports.shallowCopyFromList = function (to, from, list) {
-  for (var i = 0; i &lt; list.length; i++) {
-    var p = list[i];
-    if (typeof from[p] != 'undefined') {
-      to[p] = from[p];
+utils.shallowCopyFromList = function (to, from, list) {
+  list = list || [];
+  from = from || {};
+  if ((to !== null) &amp;&amp; (to !== undefined)) {
+    for (var i = 0; i &lt; list.length; i++) {
+      var p = list[i];
+      if (typeof from[p] != 'undefined') {
+        if (!hasOwn(from, p)) {
+          continue;
+        }
+        if (p === '__proto__' || p === 'constructor') {
+          continue;
+        }
+        to[p] = from[p];
+      }
     }
   }
   return to;
@@ -174,11 +211,11 @@ <h1 class="page-title">Source: lib/utils.js</h1>
  * Simple in-process cache implementation. Does not implement limits of any
  * sort.
  *
- * @implements Cache
+ * @implements {Cache}
  * @static
  * @private
  */
-exports.cache = {
+utils.cache = {
   _data: {},
   set: function (key, val) {
     this._data[key] = val;
@@ -193,6 +230,65 @@ <h1 class="page-title">Source: lib/utils.js</h1>
     this._data = {};
   }
 };
+
+/**
+ * Transforms hyphen case variable into camel case.
+ *
+ * @param {String} string Hyphen case string
+ * @return {String} Camel case string
+ * @static
+ * @private
+ */
+utils.hyphenToCamel = function (str) {
+  return str.replace(/-[a-z]/g, function (match) { return match[1].toUpperCase(); });
+};
+
+/**
+ * Returns a null-prototype object in runtimes that support it
+ *
+ * @return {Object} Object, prototype will be set to null where possible
+ * @static
+ * @private
+ */
+utils.createNullProtoObjWherePossible = (function () {
+  if (typeof Object.create == 'function') {
+    return function () {
+      return Object.create(null);
+    };
+  }
+  if (!({__proto__: null} instanceof Object)) {
+    return function () {
+      return {__proto__: null};
+    };
+  }
+  // Not possible, just pass through
+  return function () {
+    return {};
+  };
+})();
+
+/**
+ * Copies own-properties from one object to a null-prototype object for basic
+ * protection against prototype pollution
+ *
+ * @return {Object} Object with own-properties of input object
+ * @static
+ * @private
+ */
+utils.hasOwnOnlyObject = function (obj) {
+  var o = utils.createNullProtoObjWherePossible();
+  for (var p in obj) {
+    if (hasOwn(obj, p)) {
+      o[p] = obj[p];
+    }
+  }
+  return o;
+};
+
+if (typeof exports != 'undefined') {
+  module.exports = utils;
+}
+export default utils;
 </code></pre>
         </article>
     </section>
@@ -209,7 +305,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/module-ejs.html b/module-ejs.html
index f6667aeb..a382cd0f 100644
--- a/module-ejs.html
+++ b/module-ejs.html
@@ -28,10 +28,6 @@ <h1 class="page-title">Module: ejs</h1>
 
 <header>
     
-        
-            
-        
-    
 </header>
 
 <article>
@@ -42,20 +38,6 @@ <h1 class="page-title">Module: ejs</h1>
         
 
         
-            
-
-
-
-
-
-
-
-
-
-
-
-
-
 
 
 <dl class="details">
@@ -87,7 +69,7 @@ <h1 class="page-title">Module: ejs</h1>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line40">line 40</a>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line43">line 43</a>
     </li></ul></dd>
     
 
@@ -99,22 +81,6 @@ <h1 class="page-title">Module: ejs</h1>
 </dl>
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
         
     
     </div>
@@ -136,24 +102,18 @@ <h3 class="subsection-title">Members</h3>
 
         
             
-<h4 class="name" id=".cache"><span class="type-signature">(static) </span>cache<span class="type-signature"> :<a href="Cache.html">Cache</a></span></h4>
+<h4 class="name" id="~_VERSION_STRING"><span class="type-signature">(inner) </span>_VERSION_STRING<span class="type-signature"> :string</span></h4>
 
 
 
 
-<div class="description">
-    <p>EJS template function cache. This can be a LRU object from lru-cache NPM
-module. By default, it is <code>module:utils.cache</code>, a simple in-process
-cache that grows continuously.</p>
-</div>
-
 
 
     <h5>Type:</h5>
     <ul>
         <li>
             
-<span class="param-type"><a href="Cache.html">Cache</a></span>
+<span class="param-type">string</span>
 
 
         </li>
@@ -192,7 +152,7 @@ <h5>Type:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line75">line 75</a>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line56">line 56</a>
     </li></ul></dd>
     
 
@@ -210,15 +170,10 @@ <h5>Type:</h5>
 
         
             
-<h4 class="name" id=".fileLoader"><span class="type-signature">(static) </span>fileLoader<span class="type-signature"> :<a href="global.html#fileLoader">fileLoader</a></span></h4>
-
+<h4 class="name" id="~_VERSION_STRING"><span class="type-signature">(inner) </span>_VERSION_STRING<span class="type-signature"> :string</span></h4>
 
 
 
-<div class="description">
-    <p>Custom file loader. Useful for template preprocessing or restricting access
-to a certain part of the filesystem.</p>
-</div>
 
 
 
@@ -226,7 +181,7 @@ <h5>Type:</h5>
     <ul>
         <li>
             
-<span class="param-type"><a href="global.html#fileLoader">fileLoader</a></span>
+<span class="param-type">string</span>
 
 
         </li>
@@ -265,7 +220,7 @@ <h5>Type:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line84">line 84</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line66">line 66</a>
     </li></ul></dd>
     
 
@@ -282,101 +237,84 @@ <h5>Type:</h5>
 
 
         
-            
-<h4 class="name" id=".localsName"><span class="type-signature">(static) </span>localsName<span class="type-signature"> :String</span></h4>
-
-
-
-
-<div class="description">
-    <p>Name of the object containing the locals.</p>
-<p>This variable is overridden by <a href="global.html#Options"><code>Options</code></a><code>.localsName</code> if it is not
-<code>undefined</code>.</p>
-</div>
-
+    
 
+    
+        <h3 class="subsection-title">Methods</h3>
 
-    <h5>Type:</h5>
-    <ul>
-        <li>
+        
             
-<span class="param-type">String</span>
-
-
-        </li>
-    </ul>
-
-
-
-
-
-<dl class="details">
 
     
 
     
-
+    <h4 class="name" id=".fileLoader"><span class="type-signature">(static) </span>fileLoader<span class="signature">(filePath)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
 
-    
 
-    
 
-    
+<div class="description">
+    <p>fileLoader is independent</p>
+</div>
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
-    <dt class="tag-source">Source:</dt>
-    <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line96">line 96</a>
-    </li></ul></dd>
-    
 
-    
 
-    
 
+    <h5>Parameters:</h5>
     
-</dl>
-
-
 
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
 
+        <th>Type</th>
 
+        
 
         
-            
-<h4 class="name" id=".name"><span class="type-signature">(static, readonly) </span>name<span class="type-signature"> :String</span></h4>
 
+        <th class="last">Description</th>
+    </tr>
+    </thead>
 
+    <tbody>
+    
 
+        <tr>
+            
+                <td class="name"><code>filePath</code></td>
+            
 
-<div class="description">
-    <p>Name for detection of EJS.</p>
-</div>
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
 
 
+            
+            </td>
 
-    <h5>Type:</h5>
-    <ul>
-        <li>
             
-<span class="param-type">String</span>
 
+            
+
+            <td class="description last"><p>ejs file path.</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
 
-        </li>
-    </ul>
 
 
 
@@ -411,7 +349,7 @@ <h5>Type:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line949">line 949</a>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line275">line 275</a>
     </li></ul></dd>
     
 
@@ -427,90 +365,114 @@ <h5>Type:</h5>
 
 
 
-        
-            
-<h4 class="name" id=".promiseImpl"><span class="type-signature">(static) </span>promiseImpl<span class="type-signature"> :function</span></h4>
 
 
 
 
-<div class="description">
-    <p>Promise implementation -- defaults to the native implementation if available
-This is mostly just for testability</p>
-</div>
 
 
 
-    <h5>Type:</h5>
-    <ul>
-        <li>
-            
-<span class="param-type">function</span>
 
 
-        </li>
-    </ul>
+<h5>Returns:</h5>
 
+        
+<div class="param-desc">
+    <p>The contents of the specified file.</p>
+</div>
 
 
 
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
 
-<dl class="details">
 
-    
+    </dd>
+</dl>
 
     
 
-    
 
-    
 
-    
 
-    
 
-    
+        
+            
 
     
 
     
-
+    <h4 class="name" id=".fileLoader"><span class="type-signature">(static) </span>fileLoader<span class="signature">(filePath)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
 
-    
 
-    
-    <dt class="tag-source">Source:</dt>
-    <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line106">line 106</a>
-    </li></ul></dd>
-    
 
-    
+<div class="description">
+    <p>fileLoader is independent</p>
+</div>
+
+
 
-    
 
-    
-</dl>
 
 
 
 
 
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
 
         
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>filePath</code></td>
             
-<h4 class="name" id=".Template"><span class="type-signature">(static) </span>Template<span class="type-signature"></span></h4>
 
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+            
+            </td>
 
+            
 
+            
 
-<div class="description">
-    <p>EJS template class</p>
-</div>
+            <td class="description last"><p>ejs file path.</p></td>
+        </tr>
 
+    
+    </tbody>
+</table>
 
 
 
@@ -546,7 +508,7 @@ <h4 class="name" id=".Template"><span class="type-signature">(static) </span>Tem
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line497">line 497</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line304">line 304</a>
     </li></ul></dd>
     
 
@@ -562,53 +524,163 @@ <h4 class="name" id=".Template"><span class="type-signature">(static) </span>Tem
 
 
 
-        
-            
-<h4 class="name" id=".VERSION"><span class="type-signature">(static, readonly) </span>VERSION<span class="type-signature"> :String</span></h4>
 
 
 
 
-<div class="description">
-    <p>Version of EJS.</p>
-</div>
 
 
 
-    <h5>Type:</h5>
-    <ul>
-        <li>
-            
-<span class="param-type">String</span>
 
 
-        </li>
-    </ul>
+<h5>Returns:</h5>
 
+        
+<div class="param-desc">
+    <p>The contents of the specified file.</p>
+</div>
 
 
 
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
 
-<dl class="details">
 
-    
+    </dd>
+</dl>
 
     
 
-    
 
-    
 
-    
 
-    
 
-    
+        
+            
 
     
 
     
-
+    <h4 class="name" id="~getIncludePath"><span class="type-signature">(inner) </span>getIncludePath<span class="signature">(path, options)</span><span class="type-signature"> &rarr; {String}</span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Get the path to the included file by Options</p>
+</div>
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>path</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>specified path</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>options</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type"><a href="global.html#Options">Options</a></span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>compilation options</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
     
 
     
@@ -618,7 +690,7 @@ <h5>Type:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line939">line 939</a>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line147">line 147</a>
     </li></ul></dd>
     
 
@@ -634,11 +706,37 @@ <h5>Type:</h5>
 
 
 
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
         
-    
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+    </dd>
+</dl>
 
     
-        <h3 class="subsection-title">Methods</h3>
+
+
+
+
 
         
             
@@ -646,7 +744,7 @@ <h3 class="subsection-title">Methods</h3>
     
 
     
-    <h4 class="name" id=".__express"><span class="type-signature">(static) </span>__express<span class="signature">()</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="~getIncludePath"><span class="type-signature">(inner) </span>getIncludePath<span class="signature">(path, options)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
@@ -654,9 +752,7 @@ <h4 class="name" id=".__express"><span class="type-signature">(static) </span>__
 
 
 <div class="description">
-    <p>Express.js support.</p>
-<p>This is an alias for <a href="module-ejs.html#.renderFile"><code>module:ejs.renderFile</code></a>, in order to support
-Express.js out-of-the-box.</p>
+    <p>Get the path to the included file by Options</p>
 </div>
 
 
@@ -667,6 +763,78 @@ <h4 class="name" id=".__express"><span class="type-signature">(static) </span>__
 
 
 
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>path</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>specified path</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>options</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type"><a href="global.html#Options">Options</a></span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>compilation options</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
 
 
 
@@ -700,7 +868,7 @@ <h4 class="name" id=".__express"><span class="type-signature">(static) </span>__
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line913">line 913</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line168">line 168</a>
     </li></ul></dd>
     
 
@@ -725,6 +893,26 @@ <h4 class="name" id=".__express"><span class="type-signature">(static) </span>__
 
 
 
+<h5>Returns:</h5>
+
+        
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
 
 
 
@@ -734,7 +922,7 @@ <h4 class="name" id=".__express"><span class="type-signature">(static) </span>__
     
 
     
-    <h4 class="name" id=".compile"><span class="type-signature">(static) </span>compile<span class="signature">(template, opts)</span><span class="type-signature"> &rarr; {<a href="global.html#TemplateFunction">TemplateFunction</a>|<a href="global.html#ClientFunction">ClientFunction</a>}</span></h4>
+    <h4 class="name" id="~resolvePaths"><span class="type-signature">(inner) </span>resolvePaths<span class="signature">(name, paths)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
@@ -742,7 +930,7 @@ <h4 class="name" id=".compile"><span class="type-signature">(static) </span>comp
 
 
 <div class="description">
-    <p>Compile the given <code>str</code> of ejs into a template function.</p>
+    <p>Try to resolve file path on multiple directories</p>
 </div>
 
 
@@ -778,7 +966,7 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>template</code></td>
+                <td class="name"><code>name</code></td>
             
 
             <td class="type">
@@ -794,36 +982,474 @@ <h5>Parameters:</h5>
 
             
 
-            <td class="description last"><p>EJS template</p></td>
+            <td class="description last"><p>specified path</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>opts</code></td>
+                <td class="name"><code>paths</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array.&lt;String></span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>list of possible parent directory paths</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line131">line 131</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="~resolvePaths"><span class="type-signature">(inner) </span>resolvePaths<span class="signature">(name, paths)</span><span class="type-signature"> &rarr; {String}</span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    <p>Try to resolve file path on multiple directories</p>
+</div>
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>name</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">String</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>specified path</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>paths</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Array.&lt;String></span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"><p>list of possible parent directory paths</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line151">line 151</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+
+
+        
+    
+
+    
+
+    
+</article>
+
+</section>
+
+
+
+
+
+
+
+<section>
+
+<header>
+    
+</header>
+
+<article>
+    <div class="container-overview">
+    
+        
+            <div class="description"><p>Embedded JavaScript templating engine.</p></div>
+        
+
+        
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line44">line 44</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+        
+    
+    </div>
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+        <h3 class="subsection-title">Members</h3>
+
+        
+            
+<h4 class="name" id="~_VERSION_STRING"><span class="type-signature">(inner) </span>_VERSION_STRING<span class="type-signature"> :string</span></h4>
+
+
+
+
+
+
+    <h5>Type:</h5>
+    <ul>
+        <li>
+            
+<span class="param-type">string</span>
+
+
+        </li>
+    </ul>
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line56">line 56</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+        
             
+<h4 class="name" id="~_VERSION_STRING"><span class="type-signature">(inner) </span>_VERSION_STRING<span class="type-signature"> :string</span></h4>
 
-            <td class="type">
-            
-                
-<span class="param-type"><a href="global.html#Options">Options</a></span>
 
 
-            
-            </td>
 
-            
 
-            
 
-            <td class="description last"><p>compilation options</p></td>
-        </tr>
+    <h5>Type:</h5>
+    <ul>
+        <li>
+            
+<span class="param-type">string</span>
 
-    
-    </tbody>
-</table>
 
+        </li>
+    </ul>
 
 
 
@@ -858,7 +1484,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line375">line 375</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line66">line 66</a>
     </li></ul></dd>
     
 
@@ -874,43 +1500,11 @@ <h5>Parameters:</h5>
 
 
 
-
-
-
-
-
-
-
-<h5>Returns:</h5>
-
-        
-<div class="param-desc">
-    <p>Depending on the value of <code>opts.client</code>, either type might be returned.
-Note that the return type of the function also depends on the value of <code>opts.async</code>.</p>
-</div>
-
-
-
-<dl>
-    <dt>
-        Type
-    </dt>
-    <dd>
         
-<span class="param-type"><a href="global.html#TemplateFunction">TemplateFunction</a></span>
-|
-
-<span class="param-type"><a href="global.html#ClientFunction">ClientFunction</a></span>
-
-
-    </dd>
-</dl>
-
     
 
-
-
-
+    
+        <h3 class="subsection-title">Methods</h3>
 
         
             
@@ -918,7 +1512,7 @@ <h5>Returns:</h5>
     
 
     
-    <h4 class="name" id=".escapeXML"><span class="type-signature">(static) </span>escapeXML<span class="signature">(markup)</span><span class="type-signature"> &rarr; {String}</span></h4>
+    <h4 class="name" id=".fileLoader"><span class="type-signature">(static) </span>fileLoader<span class="signature">(filePath)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
@@ -926,9 +1520,7 @@ <h4 class="name" id=".escapeXML"><span class="type-signature">(static) </span>es
 
 
 <div class="description">
-    <p>Escape characters reserved in XML.</p>
-<p>This is simply an export of <code>module:utils.escapeXML</code>.</p>
-<p>If <code>markup</code> is <code>undefined</code> or <code>null</code>, the empty string is returned.</p>
+    <p>fileLoader is independent</p>
 </div>
 
 
@@ -964,7 +1556,7 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>markup</code></td>
+                <td class="name"><code>filePath</code></td>
             
 
             <td class="type">
@@ -980,7 +1572,7 @@ <h5>Parameters:</h5>
 
             
 
-            <td class="description last"><p>Input string</p></td>
+            <td class="description last"><p>ejs file path.</p></td>
         </tr>
 
     
@@ -1021,7 +1613,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line902">line 902</a>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line275">line 275</a>
     </li></ul></dd>
     
 
@@ -1044,11 +1636,13 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
 <div class="param-desc">
-    <p>Escaped string</p>
+    <p>The contents of the specified file.</p>
 </div>
 
 
@@ -1178,7 +1772,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line272">line 272</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line304">line 304</a>
     </li></ul></dd>
     
 
@@ -1201,6 +1795,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -1234,7 +1830,7 @@ <h5>Returns:</h5>
     
 
     
-    <h4 class="name" id=".render"><span class="type-signature">(static) </span>render<span class="signature">(template, data<span class="signature-attributes">opt</span>, opts<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {String|Promise.&lt;String>}</span></h4>
+    <h4 class="name" id="~getIncludePath"><span class="type-signature">(inner) </span>getIncludePath<span class="signature">(path, options)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
@@ -1242,9 +1838,7 @@ <h4 class="name" id=".render"><span class="type-signature">(static) </span>rende
 
 
 <div class="description">
-    <p>Render the given <code>template</code> of ejs.</p>
-<p>If you would like to include options but not data, you need to explicitly
-call this function with <code>data</code> being an empty object or <code>null</code>.</p>
+    <p>Get the path to the included file by Options</p>
 </div>
 
 
@@ -1268,12 +1862,8 @@ <h5>Parameters:</h5>
         <th>Type</th>
 
         
-        <th>Attributes</th>
-        
 
         
-        <th>Default</th>
-        
 
         <th class="last">Description</th>
     </tr>
@@ -1284,7 +1874,7 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>template</code></td>
+                <td class="name"><code>path</code></td>
             
 
             <td class="type">
@@ -1297,68 +1887,17 @@ <h5>Parameters:</h5>
             </td>
 
             
-                <td class="attributes">
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                </td>
-            
-
-            <td class="description last"><p>EJS template</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>data</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">Object</span>
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
 
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    {}
-                
-                </td>
             
 
-            <td class="description last"><p>template data</p></td>
+            <td class="description last"><p>specified path</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>opts</code></td>
+                <td class="name"><code>options</code></td>
             
 
             <td class="type">
@@ -1371,26 +1910,10 @@ <h5>Parameters:</h5>
             </td>
 
             
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
 
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    {}
-                
-                </td>
             
 
-            <td class="description last"><p>compilation and rendering options</p></td>
+            <td class="description last"><p>compilation options</p></td>
         </tr>
 
     
@@ -1431,7 +1954,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line409">line 409</a>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line147">line 147</a>
     </li></ul></dd>
     
 
@@ -1454,13 +1977,11 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
-<div class="param-desc">
-    <p>Return value type depends on <code>opts.async</code>.</p>
-</div>
-
 
 
 <dl>
@@ -1470,9 +1991,6 @@ <h5>Returns:</h5>
     <dd>
         
 <span class="param-type">String</span>
-|
-
-<span class="param-type">Promise.&lt;String></span>
 
 
     </dd>
@@ -1490,7 +2008,7 @@ <h5>Returns:</h5>
     
 
     
-    <h4 class="name" id=".renderFile"><span class="type-signature">(static) </span>renderFile<span class="signature">(path, data<span class="signature-attributes">opt</span>, opts<span class="signature-attributes">opt</span>, cb)</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="~getIncludePath"><span class="type-signature">(inner) </span>getIncludePath<span class="signature">(path, options)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
@@ -1498,9 +2016,7 @@ <h4 class="name" id=".renderFile"><span class="type-signature">(static) </span>r
 
 
 <div class="description">
-    <p>Render an EJS file at the given <code>path</code> and callback <code>cb(err, str)</code>.</p>
-<p>If you would like to include options but not data, you need to explicitly
-call this function with <code>data</code> being an empty object or <code>null</code>.</p>
+    <p>Get the path to the included file by Options</p>
 </div>
 
 
@@ -1524,12 +2040,8 @@ <h5>Parameters:</h5>
         <th>Type</th>
 
         
-        <th>Attributes</th>
-        
 
         
-        <th>Default</th>
-        
 
         <th class="last">Description</th>
     </tr>
@@ -1553,68 +2065,17 @@ <h5>Parameters:</h5>
             </td>
 
             
-                <td class="attributes">
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                </td>
-            
-
-            <td class="description last"><p>path to the EJS file</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>data</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">Object</span>
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
 
             
-                <td class="default">
-                
-                    {}
-                
-                </td>
-            
 
-            <td class="description last"><p>template data</p></td>
+            <td class="description last"><p>specified path</p></td>
         </tr>
 
     
 
         <tr>
             
-                <td class="name"><code>opts</code></td>
+                <td class="name"><code>options</code></td>
             
 
             <td class="type">
@@ -1627,61 +2088,10 @@ <h5>Parameters:</h5>
             </td>
 
             
-                <td class="attributes">
-                
-                    &lt;optional><br>
-                
-
-                
-
-                
-                </td>
-            
-
-            
-                <td class="default">
-                
-                    {}
-                
-                </td>
-            
-
-            <td class="description last"><p>compilation and rendering options</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>cb</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type"><a href="global.html#RenderFileCallback">RenderFileCallback</a></span>
-
-
-            
-            </td>
-
-            
-                <td class="attributes">
-                
-
-                
-
-                
-                </td>
-            
 
             
-                <td class="default">
-                
-                </td>
-            
 
-            <td class="description last"><p>callback</p></td>
+            <td class="description last"><p>compilation options</p></td>
         </tr>
 
     
@@ -1722,7 +2132,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line435">line 435</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line168">line 168</a>
     </li></ul></dd>
     
 
@@ -1747,6 +2157,26 @@ <h5>Parameters:</h5>
 
 
 
+<h5>Returns:</h5>
+
+        
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
 
 
 
@@ -1756,7 +2186,7 @@ <h5>Parameters:</h5>
     
 
     
-    <h4 class="name" id=".resolveInclude"><span class="type-signature">(static) </span>resolveInclude<span class="signature">(name, filename, isDir)</span><span class="type-signature"> &rarr; {String}</span></h4>
+    <h4 class="name" id="~resolvePaths"><span class="type-signature">(inner) </span>resolvePaths<span class="signature">(name, paths)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
@@ -1764,8 +2194,7 @@ <h4 class="name" id=".resolveInclude"><span class="type-signature">(static) </sp
 
 
 <div class="description">
-    <p>Get the path to the included file from the parent file path and the
-specified path.</p>
+    <p>Try to resolve file path on multiple directories</p>
 </div>
 
 
@@ -1824,36 +2253,13 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>filename</code></td>
+                <td class="name"><code>paths</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type">String</span>
-
-
-            
-            </td>
-
-            
-
-            
-
-            <td class="description last"><p>parent file path</p></td>
-        </tr>
-
-    
-
-        <tr>
-            
-                <td class="name"><code>isDir</code></td>
-            
-
-            <td class="type">
-            
-                
-<span class="param-type">Boolean</span>
+<span class="param-type">Array.&lt;String></span>
 
 
             
@@ -1863,7 +2269,7 @@ <h5>Parameters:</h5>
 
             
 
-            <td class="description last"><p>parent file path whether is directory</p></td>
+            <td class="description last"><p>list of possible parent directory paths</p></td>
         </tr>
 
     
@@ -1904,7 +2310,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line117">line 117</a>
+        <a href="lib_cjs_ejs.js.html">lib/cjs/ejs.js</a>, <a href="lib_cjs_ejs.js.html#line131">line 131</a>
     </li></ul></dd>
     
 
@@ -1927,6 +2333,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -1956,7 +2364,7 @@ <h5>Returns:</h5>
     
 
     
-    <h4 class="name" id="~getIncludePath"><span class="type-signature">(inner) </span>getIncludePath<span class="signature">(path, options)</span><span class="type-signature"> &rarr; {String}</span></h4>
+    <h4 class="name" id="~resolvePaths"><span class="type-signature">(inner) </span>resolvePaths<span class="signature">(name, paths)</span><span class="type-signature"> &rarr; {String}</span></h4>
     
 
     
@@ -1964,7 +2372,7 @@ <h4 class="name" id="~getIncludePath"><span class="type-signature">(inner) </spa
 
 
 <div class="description">
-    <p>Get the path to the included file by Options</p>
+    <p>Try to resolve file path on multiple directories</p>
 </div>
 
 
@@ -2000,7 +2408,7 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>path</code></td>
+                <td class="name"><code>name</code></td>
             
 
             <td class="type">
@@ -2023,13 +2431,13 @@ <h5>Parameters:</h5>
 
         <tr>
             
-                <td class="name"><code>options</code></td>
+                <td class="name"><code>paths</code></td>
             
 
             <td class="type">
             
                 
-<span class="param-type"><a href="global.html#Options">Options</a></span>
+<span class="param-type">Array.&lt;String></span>
 
 
             
@@ -2039,7 +2447,7 @@ <h5>Parameters:</h5>
 
             
 
-            <td class="description last"><p>compilation options</p></td>
+            <td class="description last"><p>list of possible parent directory paths</p></td>
         </tr>
 
     
@@ -2080,7 +2488,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="lib_ejs.js.html">lib/ejs.js</a>, <a href="lib_ejs.js.html#line136">line 136</a>
+        <a href="lib_esm_ejs.js.html">lib/esm/ejs.js</a>, <a href="lib_esm_ejs.js.html#line151">line 151</a>
     </li></ul></dd>
     
 
@@ -2103,6 +2511,8 @@ <h5>Parameters:</h5>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -2148,7 +2558,7 @@ <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-ej
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 02 2019 12:31:27 GMT-0700 (Pacific Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.2</a> on Wed May 01 2024 10:49:53 GMT-0700 (Pacific Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>
diff --git a/scripts/linenumber.js b/scripts/linenumber.js
index 8d52f7ea..4354785c 100644
--- a/scripts/linenumber.js
+++ b/scripts/linenumber.js
@@ -1,12 +1,12 @@
 /*global document */
-(function() {
-    var source = document.getElementsByClassName('prettyprint source linenums');
-    var i = 0;
-    var lineNumber = 0;
-    var lineId;
-    var lines;
-    var totalLines;
-    var anchorHash;
+(() => {
+    const source = document.getElementsByClassName('prettyprint source linenums');
+    let i = 0;
+    let lineNumber = 0;
+    let lineId;
+    let lines;
+    let totalLines;
+    let anchorHash;
 
     if (source && source[0]) {
         anchorHash = document.location.hash.substring(1);
@@ -15,7 +15,7 @@
 
         for (; i < totalLines; i++) {
             lineNumber++;
-            lineId = 'line' + lineNumber;
+            lineId = `line${lineNumber}`;
             lines[i].id = lineId;
             if (lineId === anchorHash) {
                 lines[i].className += ' selected';
diff --git a/styles/jsdoc-default.css b/styles/jsdoc-default.css
index 9207bc82..7d1729dc 100644
--- a/styles/jsdoc-default.css
+++ b/styles/jsdoc-default.css
@@ -273,7 +273,7 @@ tr > th:last-child { border-right: 1px solid #ddd; }
     margin: 0;
 }
 
-.prettyprint
+.source
 {
     border: 1px solid #ddd;
     width: 80%;
@@ -284,7 +284,7 @@ tr > th:last-child { border-right: 1px solid #ddd; }
     width: inherit;
 }
 
-.prettyprint code
+.source code
 {
     font-size: 100%;
     line-height: 18px;