node-tao 0.0.1

package/README.md

@@ -0,0 +1,230 @@
+## Node Tao
+
+<p align="center">
+<img src="https://raw.githubusercontent.com/GreenFlag31/node-tao/main/node-tao.jpg" alt="node-tao template engine representation" width="300" height="300"/>
+
+</p>
+
+**`TAO`** is a simple, lightweight and very fast embedded JS templating. It emphasizes great performance, security, and developer experience.
+
+### 🌟 Features
+
+- 🚀 Super Fast
+- 🔧 Configurable
+- 🔥 Caching
+- ⚡️ Support for partials
+- 📝 Easy template syntax (no prefix needed)
+- 💻 Developer experience
+- 🧩 Support for local and global helpers
+- 🛡️ Security by design
+
+## Get Started
+
+Define a template `simple.html` inside a view directory `templates`
+
+```html
+<!-- templates/simple.html -->
+<h1>Hi <%= name %>!</h1>
+```
+
+```javascript
+import { Tao } from 'tao';
+
+const tao = new Tao({ views: path.join(__dirname, 'templates') });
+
+const res = tao.render('simple', { name: 'Tao' });
+console.log(res); // <h1>Hi Tao!</h1>
+```
+
+## Helpers
+
+Helpers are functions that can be used inside a template. Helpers can be **local** (only available in a particular `render`) or **global** (available everywhere on the instance).
+
+```javascript
+import { Tao } from 'tao';
+
+const tao = new Tao({ views: path.join(__dirname, 'templates') });
+
+// Global helper
+function nPlusTwo(n: number) {
+  return n + 2;
+}
+// Global helper need to be registered on the instance
+tao.defineHelpers({ nPlusTwo });
+
+// Render a template
+app.get('/', (req, res) => {
+  // Local helper
+  function nPlusOne(n: number) {
+    return n + 1;
+  }
+
+  const res = tao.render('simple', { name: 'Ben' }, { nPlusOne });
+  console.log(res); // <h1>Hi Ben!</h1>
+});
+```
+
+Usage:
+
+```javascript
+// simple.html
+<%= nPlusOne(1) %>
+```
+
+NB: _Always escape (=) the output of a helper function when it includes user-controlled data._
+
+It is also possible to register helpers on `globalThis` without providing them to the template engine, but it can lead to name collision.
+
+## Include
+
+In your template, you might want to include other templates:
+
+```html
+<h1>Hi <%= name %>!</h1>
+<!-- include "article" template and provide data -->
+<%~ include('article', { phone: 'Tao T9' }) %>
+```
+
+Child components will inherit from **data** and **helpers** provided in the parent component.
+
+## Template prefix options
+
+There are three differents template prefixes:
+
+```html
+<!-- Evaluation (''): no escape (ideal for js execution) -->
+<% const age = 33; %>
+<!-- Interpolation (=): escaping (ideal for data interpolation) -->
+<p><%= `Age: ${age}` %></p>
+<!-- Raw (~): no escape (ideal for HTML inclusion) -->
+<%~ include('product') %>
+```
+
+NB: _Those prefix are configurable in the options._
+
+## Template paths resolution
+
+`TAO` will recursively add all templates matching the containing `views` path definition
+
+```javascript
+import { Tao } from 'tao';
+
+const tao = new Tao({ views: path.join(__dirname, 'templates') });
+```
+
+...such that following structure is ok :
+
+```
+| /templates
+|   - simple.html         ✔️
+|   /products
+|     - article.html      ✔️
+|     /...
+|       - nested.html     ✔️
+```
+
+By default, `fileResolution` is set to `flexible`, which means that you can just provide the _unique end of the path_:
+
+```javascript
+const res = tao.render('nested'); // accepted ✔️
+const res = tao.render('products/.../nested'); // not necessary ❌
+```
+
+`TAO` will successfully identify the nested templates without providing the subfolder(s).
+
+## Programmatically defined templates
+
+You might want to define programmatically templates:
+
+```javascript
+const headerPartial = `
+  <header>
+    <h1><%= title %></h1>
+  </header>
+`;
+
+tao.loadTemplate('@header', headerPartial);
+const rendered = tao.render('@header', { title: 'Computer shop' });
+```
+
+## Cache Storage
+
+`TAO` uses cache stores to manage caching. You might want to interact with those stores to retrieve or delete an entry:
+
+```javascript
+tao.helpersStore.remove('myHelperFn');
+```
+
+## Security by design
+
+By default, `TAO` assume you are running your app in production, so no error will be thrown, such that error stack traces are not visible in your browser. Errors will be displayed in your editor console, and visual error representation (see developer experience) is available in your browser by setting `debug: true` at option initialisation.
+
+## Developer experience
+
+All methods, properties are correctly typed and documented, so you should get help from your editor.
+
+In case of an error, a visual representation is available in your browser, giving you all the details and the precise line of the error (if available).
+
+![Error representation](https://raw.githubusercontent.com/GreenFlag31/node-tao/main/error-representation.png)
+
+NB: _set `debug: true` to activate this option. Do not activate this option in production._
+
+Metrics are also available, so you get usefull informations about the template rendering time, cache hit, mapped templates, etc. in your browser console.
+
+![Metrics](https://raw.githubusercontent.com/GreenFlag31/node-tao/main/metrics.png)
+
+If you want to inspect the data provided to the template, it is available directly in your browser console under the object `data`.
+
+![Data](https://raw.githubusercontent.com/GreenFlag31/node-tao/main/data.png)
+
+NB: _set `metrics: true` to activate this option. Do not activate this option in production._
+
+## FAQs
+
+<details>
+  <summary>
+    <b>Some words about this library</b>
+  </summary>
+
+It started as a fork of `eta`, but became a dedicated library because the changes made were too significant. Some parts are still based on `eta`, especially the template parsing, and if you know `eta`, the API will be familiar.
+
+</details>
+
+<details>
+  <summary>
+    <b>If you want to compare tao with eta</b>
+  </summary>
+
+- **Tao set security by design**: Stack traces are not visible in the browser. Increased security in files mapping.
+- **Increased developer experience**: Visual error representation, metrics, configuration options are checked.
+- **Immutability**: Data provided in the template is immutable, ie. template data modification does not affect original data.
+- **Clearer API**: Scope is well defined and restricted, which also improves security. Clean code practices are enforced.
+- **Clearer template syntax**: No prefix are needed.
+- **Helpers**: Global and local helpers, which are clearer and more suitable for little template logic.
+- **Flexible template path resolution**: With `fileResolution` mode set to `flexible`, only end unique paths can be provided, which increases file path readability (aka. `namespaces`).
+- **Performance**: Various performance optimization.
+
+</details>
+
+<details>
+  <summary>
+    <b>Choices</b>
+  </summary>
+
+- **No async support**: Supporting async rendering (e.g., `await include`) within templates encourages placing too much logic in the view layer and can be considered as an _anti-pattern_. Templates should be responsible for displaying data, while controllers should handle logic. Async behavior in templates would also require error handling (e.g., `try/catch`), adding complexity and possible errors. Async logic in template make it impossible de optimize through a `Promise.all` or any parallelism, hard to test and debug. In short: if you have async data, fetch it beforehand and render it synchronously.
+
+- **No `layouts`**: Layouts are essentially includes and add unnecessary complexity to the rendering process.
+
+- **No `rmWhitespace`**: Stripping whitespace at the template level yields negligible HTML size savings. Using compression (e.g., via Nginx or other proxies) is far more effective and scalable.
+
+_If you think those features are absolutely necessary, please open a new discussion on github and provide an example._
+
+</details>
+
+<br />
+
+## Change logs
+
+## Credits
+
+- Syntax and some parts of compilation are based on `eta`.

package/checks.d.ts

@@ -0,0 +1,8 @@
+import { Parse, Tags } from './interfaces';
+import { getPathWithExtension } from './utils';
+declare function isTemplateDynamicallyDefined(template: string): boolean;
+declare function checkOpeningAndClosingTag(tags: Tags): void;
+declare function checkPrefixTemplateTags(parse: Parse): void;
+declare function trimDotFromExtension(extension: string): string;
+export { getPathWithExtension, isTemplateDynamicallyDefined, checkOpeningAndClosingTag, checkPrefixTemplateTags, trimDotFromExtension, };
+//# sourceMappingURL=checks.d.ts.map

package/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,iBAAS,4BAA4B,CAAC,QAAQ,EAAE,MAAM,WAErD;AAED,iBAAS,yBAAyB,CAAC,IAAI,EAAE,IAAI,QAK5C;AAED,iBAAS,uBAAuB,CAAC,KAAK,EAAE,KAAK,QAgB5C;AAED,iBAAS,oBAAoB,CAAC,SAAS,EAAE,MAAM,UAI9C;AAED,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,GACrB,CAAC"}

package/checks.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trimDotFromExtension = exports.checkPrefixTemplateTags = exports.checkOpeningAndClosingTag = exports.isTemplateDynamicallyDefined = exports.getPathWithExtension = void 0;
+const const_1 = require("./const");
+const utils_1 = require("./utils");
+Object.defineProperty(exports, "getPathWithExtension", { enumerable: true, get: function () { return utils_1.getPathWithExtension; } });
+function isTemplateDynamicallyDefined(template) {
+    return template.startsWith(const_1.DYNAMICAL_TEMPLATE_PREFIX);
+}
+exports.isTemplateDynamicallyDefined = isTemplateDynamicallyDefined;
+function checkOpeningAndClosingTag(tags) {
+    const { opening, closing } = tags;
+    if (opening === closing) {
+        throw new Error('Opening and closing tag should be different');
+    }
+}
+exports.checkOpeningAndClosingTag = checkOpeningAndClosingTag;
+function checkPrefixTemplateTags(parse) {
+    const parseValues = Object.entries(parse);
+    for (let i = 0; i < parseValues.length; i++) {
+        const [key, value] = parseValues[i];
+        for (let j = i + 1; j < parseValues.length; j++) {
+            const [nextKey, nextValue] = parseValues[j];
+            if (value === nextValue) {
+                throw new Error(`Cannot have the same parse value at '${key}' and '${nextKey}' with value '${value}'`);
+            }
+        }
+    }
+}
+exports.checkPrefixTemplateTags = checkPrefixTemplateTags;
+function trimDotFromExtension(extension) {
+    if (extension.startsWith('.'))
+        return extension.slice(1);
+    return extension;
+}
+exports.trimDotFromExtension = trimDotFromExtension;
+//# sourceMappingURL=checks.js.map

package/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":";;;AAAA,mCAAoD;AAEpD,mCAA+C;AAsC7C,qGAtCO,4BAAoB,OAsCP;AApCtB,SAAS,4BAA4B,CAAC,QAAgB;IACpD,OAAO,QAAQ,CAAC,UAAU,CAAC,iCAAyB,CAAC,CAAC;AACxD,CAAC;AAmCC,oEAA4B;AAjC9B,SAAS,yBAAyB,CAAC,IAAU;IAC3C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAClC,IAAI,OAAO,KAAK,OAAO,EAAE;QACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;KAChE;AACH,CAAC;AA6BC,8DAAyB;AA3B3B,SAAS,uBAAuB,CAAC,KAAY;IAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC/C,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAE5C,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,MAAM,IAAI,KAAK,CACb,wCAAwC,GAAG,UAAU,OAAO,iBAAiB,KAAK,GAAG,CACtF,CAAC;aACH;SACF;KACF;AACH,CAAC;AAYC,0DAAuB;AAVzB,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAOC,oDAAoB"}

package/const.d.ts

@@ -0,0 +1,24 @@
+declare const DEFAULT_EXTENSION = "html";
+declare const DEFAULT_OPENING = "<%";
+declare const DEFAULT_CLOSING = "%>";
+declare const DEFAULT_EXEC = "";
+declare const DEFAULT_INTERPOLATE = "=";
+declare const DEFAULT_RAW = "~";
+declare const TEMPLATE_VARNAME = "it";
+declare const HELPER_VARNAME = "hp";
+declare const TP_VARNAME_WITH_PREFIX: string;
+declare const HELPER_WITH_PREFIX: string;
+declare const DYNAMICAL_TEMPLATE_PREFIX = "@";
+declare const PLACEHOLDER_VAR_START = "\"<injected-var-start>\";";
+declare const PLACEHOLDER_VAR_END = "\"<injected-var-end>\";";
+declare const LITERAL_REGEX: RegExp;
+declare const SINGLE_QUOTE_REGEX: RegExp;
+declare const DOUBLE_QUOTE_REGEX: RegExp;
+/**
+ * A map of special HTML characters to their XML-escaped equivalents
+ */
+declare const ESC_MAP: {
+    [key: string]: string;
+};
+export { DEFAULT_EXTENSION, LITERAL_REGEX, SINGLE_QUOTE_REGEX, DOUBLE_QUOTE_REGEX, ESC_MAP, TEMPLATE_VARNAME, DYNAMICAL_TEMPLATE_PREFIX, TP_VARNAME_WITH_PREFIX, HELPER_WITH_PREFIX, HELPER_VARNAME, DEFAULT_CLOSING, DEFAULT_OPENING, DEFAULT_EXEC, DEFAULT_INTERPOLATE, DEFAULT_RAW, PLACEHOLDER_VAR_START, PLACEHOLDER_VAR_END, };
+//# sourceMappingURL=const.d.ts.map

package/const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,iBAAiB,SAAS,CAAC;AACjC,QAAA,MAAM,eAAe,OAAO,CAAC;AAC7B,QAAA,MAAM,eAAe,OAAO,CAAC;AAE7B,QAAA,MAAM,YAAY,KAAK,CAAC;AACxB,QAAA,MAAM,mBAAmB,MAAM,CAAC;AAChC,QAAA,MAAM,WAAW,MAAM,CAAC;AAExB,QAAA,MAAM,gBAAgB,OAAO,CAAC;AAC9B,QAAA,MAAM,cAAc,OAAO,CAAC;AAO5B,QAAA,MAAM,sBAAsB,QAAuC,CAAC;AACpE,QAAA,MAAM,kBAAkB,QAAqC,CAAC;AAC9D,QAAA,MAAM,yBAAyB,MAAM,CAAC;AAEtC,QAAA,MAAM,qBAAqB,8BAA4B,CAAC;AACxD,QAAA,MAAM,mBAAmB,4BAA0B,CAAC;AAEpD,QAAA,MAAM,aAAa,QAAuE,CAAC;AAC3F,QAAA,MAAM,kBAAkB,QAAsC,CAAC;AAC/D,QAAA,MAAM,kBAAkB,QAAsC,CAAC;AAE/D;;GAEG;AACH,QAAA,MAAM,OAAO,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAMrC,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,GACpB,CAAC"}

package/const.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLACEHOLDER_VAR_END = exports.PLACEHOLDER_VAR_START = exports.DEFAULT_RAW = exports.DEFAULT_INTERPOLATE = exports.DEFAULT_EXEC = exports.DEFAULT_OPENING = exports.DEFAULT_CLOSING = exports.HELPER_VARNAME = exports.HELPER_WITH_PREFIX = exports.TP_VARNAME_WITH_PREFIX = exports.DYNAMICAL_TEMPLATE_PREFIX = exports.TEMPLATE_VARNAME = exports.ESC_MAP = exports.DOUBLE_QUOTE_REGEX = exports.SINGLE_QUOTE_REGEX = exports.LITERAL_REGEX = exports.DEFAULT_EXTENSION = void 0;
+const DEFAULT_EXTENSION = 'html';
+exports.DEFAULT_EXTENSION = DEFAULT_EXTENSION;
+const DEFAULT_OPENING = '<%';
+exports.DEFAULT_OPENING = DEFAULT_OPENING;
+const DEFAULT_CLOSING = '%>';
+exports.DEFAULT_CLOSING = DEFAULT_CLOSING;
+const DEFAULT_EXEC = '';
+exports.DEFAULT_EXEC = DEFAULT_EXEC;
+const DEFAULT_INTERPOLATE = '=';
+exports.DEFAULT_INTERPOLATE = DEFAULT_INTERPOLATE;
+const DEFAULT_RAW = '~';
+exports.DEFAULT_RAW = DEFAULT_RAW;
+const TEMPLATE_VARNAME = 'it';
+exports.TEMPLATE_VARNAME = TEMPLATE_VARNAME;
+const HELPER_VARNAME = 'hp';
+exports.HELPER_VARNAME = HELPER_VARNAME;
+/**
+ * Internal variable signal.
+ */
+const PRIVATE_ONLY = 'ɵɵ';
+const TP_VARNAME_WITH_PREFIX = `${PRIVATE_ONLY}${TEMPLATE_VARNAME}`;
+exports.TP_VARNAME_WITH_PREFIX = TP_VARNAME_WITH_PREFIX;
+const HELPER_WITH_PREFIX = `${PRIVATE_ONLY}${HELPER_VARNAME}`;
+exports.HELPER_WITH_PREFIX = HELPER_WITH_PREFIX;
+const DYNAMICAL_TEMPLATE_PREFIX = '@';
+exports.DYNAMICAL_TEMPLATE_PREFIX = DYNAMICAL_TEMPLATE_PREFIX;
+const PLACEHOLDER_VAR_START = '"<injected-var-start>";';
+exports.PLACEHOLDER_VAR_START = PLACEHOLDER_VAR_START;
+const PLACEHOLDER_VAR_END = '"<injected-var-end>";';
+exports.PLACEHOLDER_VAR_END = PLACEHOLDER_VAR_END;
+const LITERAL_REGEX = /`(?:\\[\s\S]|\${(?:[^{}]|{(?:[^{}]|{[^}]*})*})*}|(?!\${)[^\\`])*`/g;
+exports.LITERAL_REGEX = LITERAL_REGEX;
+const SINGLE_QUOTE_REGEX = /'(?:\\[\s\w"'\\`]|[^\n\r'\\])*?'/g;
+exports.SINGLE_QUOTE_REGEX = SINGLE_QUOTE_REGEX;
+const DOUBLE_QUOTE_REGEX = /"(?:\\[\s\w"'\\`]|[^\n\r"\\])*?"/g;
+exports.DOUBLE_QUOTE_REGEX = DOUBLE_QUOTE_REGEX;
+/**
+ * A map of special HTML characters to their XML-escaped equivalents
+ */
+const ESC_MAP = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+exports.ESC_MAP = ESC_MAP;
+//# sourceMappingURL=const.js.map

package/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":";;;AAAA,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAuC/B,8CAAiB;AAtCnB,MAAM,eAAe,GAAG,IAAI,CAAC;AAiD3B,0CAAe;AAhDjB,MAAM,eAAe,GAAG,IAAI,CAAC;AA+C3B,0CAAe;AA7CjB,MAAM,YAAY,GAAG,EAAE,CAAC;AA+CtB,oCAAY;AA9Cd,MAAM,mBAAmB,GAAG,GAAG,CAAC;AA+C9B,kDAAmB;AA9CrB,MAAM,WAAW,GAAG,GAAG,CAAC;AA+CtB,kCAAW;AA7Cb,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAoC5B,4CAAgB;AAnClB,MAAM,cAAc,GAAG,IAAI,CAAC;AAuC1B,wCAAc;AArChB;;GAEG;AACH,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,sBAAsB,GAAG,GAAG,YAAY,GAAG,gBAAgB,EAAE,CAAC;AA8BlE,wDAAsB;AA7BxB,MAAM,kBAAkB,GAAG,GAAG,YAAY,GAAG,cAAc,EAAE,CAAC;AA8B5D,gDAAkB;AA7BpB,MAAM,yBAAyB,GAAG,GAAG,CAAC;AA2BpC,8DAAyB;AAzB3B,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAkCtD,sDAAqB;AAjCvB,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAkClD,kDAAmB;AAhCrB,MAAM,aAAa,GAAG,oEAAoE,CAAC;AAiBzF,sCAAa;AAhBf,MAAM,kBAAkB,GAAG,mCAAmC,CAAC;AAiB7D,gDAAkB;AAhBpB,MAAM,kBAAkB,GAAG,mCAAmC,CAAC;AAiB7D,gDAAkB;AAfpB;;GAEG;AACH,MAAM,OAAO,GAA8B;IACzC,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAOA,0BAAO"}

package/default-config.d.ts

@@ -0,0 +1,4 @@
+import { DefinitiveOptions } from './interfaces';
+declare const defaultConfig: DefinitiveOptions;
+export { defaultConfig };
+//# sourceMappingURL=default-config.d.ts.map

package/default-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.d.ts","sourceRoot":"","sources":["../src/default-config.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,QAAA,MAAM,aAAa,EAAE,iBAiBpB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/default-config.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConfig = void 0;
+const const_1 = require("./const");
+const utils_1 = require("./utils");
+const defaultConfig = {
+    views: process.cwd(),
+    autoEscape: true,
+    escapeFunction: utils_1.XMLEscape,
+    cache: true,
+    development: false,
+    fileResolution: 'flexible',
+    parse: {
+        exec: const_1.DEFAULT_EXEC,
+        interpolate: const_1.DEFAULT_INTERPOLATE,
+        raw: const_1.DEFAULT_RAW,
+    },
+    tags: {
+        opening: const_1.DEFAULT_OPENING,
+        closing: const_1.DEFAULT_CLOSING,
+    },
+    extension: const_1.DEFAULT_EXTENSION,
+};
+exports.defaultConfig = defaultConfig;
+//# sourceMappingURL=default-config.js.map

package/default-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.js","sourceRoot":"","sources":["../src/default-config.ts"],"names":[],"mappings":";;;AAAA,mCAOiB;AAEjB,mCAAoC;AAEpC,MAAM,aAAa,GAAsB;IACvC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE;IACpB,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,iBAAS;IACzB,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,UAAU;IAC1B,KAAK,EAAE;QACL,IAAI,EAAE,oBAAY;QAClB,WAAW,EAAE,2BAAmB;QAChC,GAAG,EAAE,mBAAW;KACjB;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,uBAAe;QACxB,OAAO,EAAE,uBAAe;KACzB;IACD,SAAS,EAAE,yBAAiB;CAC7B,CAAC;AAEO,sCAAa"}

package/error/error.html

@@ -0,0 +1,259 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>An error occurred</title>
+    <link
+      rel="icon"
+      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'%3E%3Ccircle cx='50' cy='50' r='45' fill='white' stroke='red' stroke-width='10'/%3E%3Cline x1='30' y1='30' x2='70' y2='70' stroke='red' stroke-width='10'/%3E%3Cline x1='70' y1='30' x2='30' y2='70' stroke='red' stroke-width='10'/%3E%3C/svg%3E"
+      type="image/svg+xml"
+    />
+    <style>
+      * {
+        padding: 0;
+        margin: 0;
+        box-sizing: border-box;
+        font-family: sans-serif;
+      }
+
+      body {
+        background: #f4f4f4;
+      }
+
+      .general-container {
+        display: flex;
+      }
+
+      .error-container {
+        position: absolute;
+        top: 40%;
+        left: 50%;
+        transform: translate(-50%, -50%);
+        padding: 1rem;
+        border-radius: 0.2rem;
+        box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
+        background: #fff;
+        min-width: 300px;
+      }
+
+      .error h2 {
+        text-align: center;
+      }
+
+      .error-message {
+        margin-top: 2rem;
+      }
+
+      .error-message .general {
+        font-weight: bold;
+        font-size: 1rem;
+        color: #e74c3c;
+      }
+
+      .error-message .line {
+        font-size: 0.9rem;
+      }
+
+      .error-container {
+        border-left: 3px solid #e74c3c;
+      }
+
+      .error-container .content {
+        margin-top: 0.3rem;
+      }
+
+      .error-container .filename {
+        display: flex;
+        justify-content: flex-end;
+      }
+
+      .source-code-container {
+        display: flex;
+        flex-direction: column;
+        max-height: 400px;
+        overflow-y: auto;
+      }
+
+      .source-code-container span {
+        padding: 0.2rem;
+        font-family: system-ui;
+        font-size: 1rem;
+      }
+
+      .error-line-container {
+        display: flex;
+      }
+
+      .error-line-container .line-number {
+        background: #000;
+        color: #9b9b9b;
+        text-align: right;
+        min-width: 5ch;
+        padding-right: 0.5ch;
+      }
+
+      .error-line-container .error-line {
+        font-weight: 500;
+      }
+
+      .line-number.active {
+        color: #fff;
+      }
+
+      .error-line-container .html {
+        width: 100%;
+      }
+      .error-line {
+        background: #ffe9e9;
+        color: #c0392b;
+      }
+      .error-line-container:hover {
+        background-color: #f1f1f1;
+      }
+
+      .github {
+        display: flex;
+        justify-content: flex-end;
+        margin-top: 2rem;
+      }
+
+      .github button {
+        display: flex;
+        align-items: center;
+        gap: 0.5rem;
+        padding: 0.5rem;
+        cursor: pointer;
+      }
+
+      a {
+        text-decoration: none;
+      }
+
+      .github svg {
+        width: 20px;
+      }
+
+      .tips p {
+        font-size: 0.8rem;
+        margin-top: 0.1rem;
+      }
+
+      /* RESIZE */
+      .resize-handle {
+        top: 0;
+        position: absolute;
+        width: 6px;
+        height: 100%;
+        z-index: 2;
+        cursor: w-resize;
+      }
+      .resize-handle.left:hover,
+      .resize-handle.right:hover {
+        background-color: rgba(192, 192, 192, 0.479);
+      }
+      .resize-handle.left {
+        left: -3px;
+        border-radius: 0.5rem;
+      }
+      .resize-handle.right {
+        right: -3px;
+        border-radius: 0.5rem;
+      }
+    </style>
+  </head>
+
+  <body>
+    <div class="general-container">
+      <section class="error-container">
+        <div class="resize-handle left"></div>
+        <div class="resize-handle right"></div>
+        <div class="error">
+          <div class="header">
+            <h2>An error occurred</h2>
+          </div>
+
+          <div class="error-message">
+            <% const lineNumberMessage = lineNumber ? ` at line ${lineNumber} in ${filename}` : ""
+            %>
+            <p class="general"><%= `${message}${lineNumberMessage}` %></p>
+            <% if (isNaN(lineNumber)) { %>
+            <p class="line">⚠️ Error line number cannot be retrieved</p>
+            <% } %>
+          </div>
+
+          <div class="content">
+            <div class="source-code-container">
+              <% for (let i = 0; i < fileContent.length; i++) { %>
+
+              <div class="error-line-container">
+                <% const errorLine = i === lineNumber - 1 %>
+                <span class="<%= errorLine ? 'line-number active' : 'line-number' %>"
+                  ><%= i + 1 %>
+                </span>
+                <span class="<%= errorLine ? 'html error-line' : 'html' %>">
+                  <%= fileContent[i] %>
+                </span>
+              </div>
+              <% } %>
+            </div>
+          </div>
+        </div>
+        <div class="tips">
+          <p>Tip: resize the box by dragging its sides.</p>
+        </div>
+
+        <div class="github">
+          <a href="https://github.com/GreenFlag31/node-tao" target="_blank">
+            <button>
+              <span>GitHub</span>
+              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512">
+                <path
+                  d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3 .3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5 .3-6.2 2.3zm44.2-1.7c-2.9 .7-4.9 2.6-4.6 4.9 .3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3 .7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3 .3 2.9 2.3 3.9 1.6 1 3.6 .7 4.3-.7 .7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3 .7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3 .7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"
+                />
+              </svg>
+            </button>
+          </a>
+        </div>
+      </section>
+    </div>
+
+    <script>
+      const errorContainer = document.querySelector('.error-container');
+      const sourceCode = document.querySelector('.source-code-container');
+      const errorLine = sourceCode.querySelector('.error-line-container .line-number.active');
+      const resizeHandlers = document.querySelectorAll('.resize-handle');
+      const htmlLines = sourceCode.querySelectorAll('span.html');
+      const minWidth = errorContainer.clientWidth;
+      errorLine?.scrollIntoView();
+
+      resizeHandlers.forEach((resizer) => {
+        resizer.addEventListener('mousedown', (e) => {
+          e.preventDefault();
+          const startX = e.clientX;
+          const startWidth = errorContainer.offsetWidth;
+          const isLeft = resizer.classList.contains('left');
+
+          // 10 padding on each side
+          const maxWidth = window.innerWidth - 20;
+
+          const onMouseMove = (event) => {
+            const dx = event.clientX - startX;
+            const newWidth = isLeft ? startWidth - dx : startWidth + dx;
+            if (newWidth < minWidth || newWidth > maxWidth) return;
+
+            errorContainer.style.width = `${newWidth}px`;
+          };
+
+          const onMouseUp = () => {
+            document.removeEventListener('mousemove', onMouseMove);
+            document.removeEventListener('mouseup', onMouseUp);
+          };
+
+          document.addEventListener('mousemove', onMouseMove);
+          document.addEventListener('mouseup', onMouseUp);
+        });
+      });
+    </script>
+  </body>
+</html>