htmljs-parser 3.3.5 → 5.0.0

package/README.md

@@ -155,20 +155,29 @@ const parser = createParser({
     range.value; // Another range that includes only the value itself without the leading $ or surrounding braces (if applicable).
   },
 
+  /**
+   * Called when we're about to begin an HTML open tag (before the tag name).
+   * Note: This is only called for HTML mode tags and can be used to track if you are in concise mode.
+   *
+   * @example
+   * 1╭─ <div>Hi</div>
+   *  ╰─ ╰─ openTagStart
+   */
+  onOpenTagStart(range) {}
+
   /**
    * Called when a tag name, which can include placeholders, has been parsed.
    *
    * @example
    * 1╭─ <div/>
-   *  ╰─  ╰─ tagName "div"
+   *  ╰─  ╰─ openTagName "div"
    * 2╭─ <hello-${test}-again/>
-   *  │   │     │      ╰─ tagName.quasis[1] "-again"
-   *  │   │     ╰─ tagName.expressions[0] "${test}"
-   *  │   ├─ tagName.quasis[0] "hello-"
-   *  ╰─  ╰─ tagName "hello-${test}-again"
+   *  │   │     │      ╰─ openTagName.quasis[1] "-again"
+   *  │   │     ╰─ openTagName.expressions[0] "${test}"
+   *  │   ├─ openTagName.quasis[0] "hello-"
+   *  ╰─  ╰─ openTagName "hello-${test}-again"
    */
-  onTagName(range) {
-    range.concise; // true if this tag is a concise mode tag.
+  onOpenTagName(range) {
     range.quasis; // An array of ranges that indicate the string literal parts of the tag name.
     range.expressions; // A list of placeholder ranges (similar to whats emitted via onPlaceholder).
 
@@ -353,21 +362,38 @@ const parser = createParser({
    *  ╰─     ╰─ openTagEnd ">"
    */
   onOpenTagEnd(range) {
-    range.selfClosed; // true if this tag was self closed (onCloseTag would not be called if so).
+    range.selfClosed; // true if this tag was self closed (the onCloseTag* handlers will not be called if so).
   },
 
   /**
-   * Called once the closing tag (or in concise mode an outdent or eof) is parsed.
+   * Called when we start parsing and html closing tag.
+   * Note this is not emitted for concise, selfClosed, void or statement tags.
+   *
+   * @example
+   * 1╭─ <div><span/></div>
+   *  ╰─             ╰─ closeTagStart "</"
+   */
+  onCloseTagStart(range) {},
+
+  /**
+   * Called after the content within the brackets of an html closing tag has been parsed.
+   * Note this is not emitted for concise, selfClosed, void or statement tags.
+   *
+   * @example
+   * 1╭─ <div><span/></div>
+   *  ╰─               ╰─ closeTagName "div"
+   */
+  onCloseTagName(range) {},
+
+  /**
+   * Called once the closing tag has finished parsing, or in concise mode we hit an outdent or eof.
    * Note this is not called for selfClosed, void or statement tags.
    *
    * @example
    * 1╭─ <div><span/></div>
-   *  │              │ ╰─ closeTag(div).value "div"
-   *  ╰─             ╰─ closeTag(div) "</div>"
+   *  ╰─                  ╰─ closeTagEnd ">"
    */
-  onCloseTag(range) {
-    range.value; // The raw content of the closing tag (undefined in concise mode).
-  },
+  onCloseTagEnd(range) {},
 });
 ```
 

package/dist/core/Parser.d.ts

@@ -57,7 +57,7 @@ export declare class Parser {
      */
     beginHtmlBlock(delimiter: string | undefined, singleLine: boolean): void;
     emitError(range: number | Range, code: ErrorCode, message: string): void;
-    closeTag(start: number, end: number, value: Range | undefined): void;
+    closeTagEnd(start: number, end: number, name: Range | undefined): void;
     consumeWhitespaceIfBefore(str: string, start?: number): boolean;
     getPreviousNonWhitespaceCharCode(start?: number): number;
     onlyWhitespaceRemainsOnLine(start?: number): boolean;

package/dist/index.js

@@ -89,10 +89,10 @@ function getPos(lines, startLine, index) {
   };
 }
 function getLines(src) {
-  const lines = [-1];
+  const lines = [0];
   for (let i = 0; i < src.length; i++) {
     if (src.charCodeAt(i) === 10 /* NEWLINE */) {
-      lines.push(i);
+      lines.push(i + 1);
     }
   }
   return lines;
@@ -101,7 +101,7 @@ function htmlEOF() {
   this.endText();
   while (this.activeTag) {
     if (this.activeTag.concise) {
-      this.closeTag(this.pos, this.pos, void 0);
+      this.closeTagEnd(this.pos, this.pos, void 0);
     } else {
       return this.emitError(this.activeTag, 22 /* MISSING_END_TAG */, 'Missing ending "' + this.read(this.activeTag.tagName) + '" tag');
     }
@@ -231,17 +231,15 @@ var Parser = class {
     });
     this.pos = this.maxPos + 1;
   }
-  closeTag(start, end, value) {
-    var _a, _b;
+  closeTagEnd(start, end, name) {
+    var _a, _b, _c, _d;
     const { beginMixedMode, parentTag } = this.activeTag;
     if (beginMixedMode)
       this.endingMixedModeAtEOL = true;
     this.activeTag = parentTag;
-    (_b = (_a = this.options).onCloseTag) == null ? void 0 : _b.call(_a, {
-      start,
-      end,
-      value
-    });
+    if (name)
+      (_b = (_a = this.options).onCloseTagName) == null ? void 0 : _b.call(_a, name);
+    (_d = (_c = this.options).onCloseTagEnd) == null ? void 0 : _d.call(_c, { start, end });
   }
   consumeWhitespaceIfBefore(str, start = 0) {
     const { pos, data } = this;
@@ -778,7 +776,7 @@ function ensureExpectedCloseTag(parser, closeTag) {
       }
     }
   }
-  parser.closeTag(closeTag.start, closeTag.end, closeTagNamePos);
+  parser.closeTagEnd(closeTagNameEnd, closeTag.end, closeTagNamePos);
   return true;
 }
 
@@ -805,7 +803,7 @@ var CONCISE_HTML_CONTENT = {
       const indentStart = this.pos - curIndent - 1;
       let parentTag = this.activeTag;
       while (parentTag && parentTag.indent.length >= curIndent) {
-        this.closeTag(indentStart, indentStart, void 0);
+        this.closeTagEnd(indentStart, indentStart, void 0);
         parentTag = this.activeTag;
       }
       if (!parentTag && curIndent) {
@@ -1210,6 +1208,7 @@ var HTML_CONTENT = {
   exit() {
   },
   char(code) {
+    var _a, _b, _c, _d;
     if (code === 60 /* OPEN_ANGLE_BRACKET */) {
       if (states_exports.checkForCDATA(this))
         return;
@@ -1226,11 +1225,19 @@ var HTML_CONTENT = {
         this.enterState(states_exports.DECLARATION);
         this.pos++;
       } else if (nextCode === 47 /* FORWARD_SLASH */) {
+        (_b = (_a = this.options).onCloseTagStart) == null ? void 0 : _b.call(_a, {
+          start: this.pos,
+          end: this.pos + 2
+        });
         this.enterState(states_exports.CLOSE_TAG);
         this.pos++;
       } else if (nextCode === 62 /* CLOSE_ANGLE_BRACKET */ || nextCode === 60 /* OPEN_ANGLE_BRACKET */ || isWhitespaceCode(nextCode)) {
         this.startText();
       } else {
+        (_d = (_c = this.options).onOpenTagStart) == null ? void 0 : _d.call(_c, {
+          start: this.pos,
+          end: this.pos + 1
+        });
         this.enterState(states_exports.OPEN_TAG);
       }
     } else if (code === 36 /* DOLLAR */ && isWhitespaceCode(this.lookAtCharCodeAhead(1)) && isBeginningOfLine(this)) {
@@ -1632,12 +1639,11 @@ var TAG_NAME = {
         break;
       default: {
         const tag = this.activeTag;
-        const tagType = (_f = (_e = this.options).onTagName) == null ? void 0 : _f.call(_e, {
+        const tagType = (_f = (_e = this.options).onOpenTagName) == null ? void 0 : _f.call(_e, {
           start,
           end,
           quasis,
-          expressions,
-          concise: this.isConcise
+          expressions
         });
         tag.tagName = tagName;
         if (tagType) {

package/dist/index.mjs

@@ -68,10 +68,10 @@ function getPos(lines, startLine, index) {
   };
 }
 function getLines(src) {
-  const lines = [-1];
+  const lines = [0];
   for (let i = 0; i < src.length; i++) {
     if (src.charCodeAt(i) === 10 /* NEWLINE */) {
-      lines.push(i);
+      lines.push(i + 1);
     }
   }
   return lines;
@@ -80,7 +80,7 @@ function htmlEOF() {
   this.endText();
   while (this.activeTag) {
     if (this.activeTag.concise) {
-      this.closeTag(this.pos, this.pos, void 0);
+      this.closeTagEnd(this.pos, this.pos, void 0);
     } else {
       return this.emitError(this.activeTag, 22 /* MISSING_END_TAG */, 'Missing ending "' + this.read(this.activeTag.tagName) + '" tag');
     }
@@ -210,17 +210,15 @@ var Parser = class {
     });
     this.pos = this.maxPos + 1;
   }
-  closeTag(start, end, value) {
-    var _a, _b;
+  closeTagEnd(start, end, name) {
+    var _a, _b, _c, _d;
     const { beginMixedMode, parentTag } = this.activeTag;
     if (beginMixedMode)
       this.endingMixedModeAtEOL = true;
     this.activeTag = parentTag;
-    (_b = (_a = this.options).onCloseTag) == null ? void 0 : _b.call(_a, {
-      start,
-      end,
-      value
-    });
+    if (name)
+      (_b = (_a = this.options).onCloseTagName) == null ? void 0 : _b.call(_a, name);
+    (_d = (_c = this.options).onCloseTagEnd) == null ? void 0 : _d.call(_c, { start, end });
   }
   consumeWhitespaceIfBefore(str, start = 0) {
     const { pos, data } = this;
@@ -757,7 +755,7 @@ function ensureExpectedCloseTag(parser, closeTag) {
       }
     }
   }
-  parser.closeTag(closeTag.start, closeTag.end, closeTagNamePos);
+  parser.closeTagEnd(closeTagNameEnd, closeTag.end, closeTagNamePos);
   return true;
 }
 
@@ -784,7 +782,7 @@ var CONCISE_HTML_CONTENT = {
       const indentStart = this.pos - curIndent - 1;
       let parentTag = this.activeTag;
       while (parentTag && parentTag.indent.length >= curIndent) {
-        this.closeTag(indentStart, indentStart, void 0);
+        this.closeTagEnd(indentStart, indentStart, void 0);
         parentTag = this.activeTag;
       }
       if (!parentTag && curIndent) {
@@ -1189,6 +1187,7 @@ var HTML_CONTENT = {
   exit() {
   },
   char(code) {
+    var _a, _b, _c, _d;
     if (code === 60 /* OPEN_ANGLE_BRACKET */) {
       if (states_exports.checkForCDATA(this))
         return;
@@ -1205,11 +1204,19 @@ var HTML_CONTENT = {
         this.enterState(states_exports.DECLARATION);
         this.pos++;
       } else if (nextCode === 47 /* FORWARD_SLASH */) {
+        (_b = (_a = this.options).onCloseTagStart) == null ? void 0 : _b.call(_a, {
+          start: this.pos,
+          end: this.pos + 2
+        });
         this.enterState(states_exports.CLOSE_TAG);
         this.pos++;
       } else if (nextCode === 62 /* CLOSE_ANGLE_BRACKET */ || nextCode === 60 /* OPEN_ANGLE_BRACKET */ || isWhitespaceCode(nextCode)) {
         this.startText();
       } else {
+        (_d = (_c = this.options).onOpenTagStart) == null ? void 0 : _d.call(_c, {
+          start: this.pos,
+          end: this.pos + 1
+        });
         this.enterState(states_exports.OPEN_TAG);
       }
     } else if (code === 36 /* DOLLAR */ && isWhitespaceCode(this.lookAtCharCodeAhead(1)) && isBeginningOfLine(this)) {
@@ -1611,12 +1618,11 @@ var TAG_NAME = {
         break;
       default: {
         const tag = this.activeTag;
-        const tagType = (_f = (_e = this.options).onTagName) == null ? void 0 : _f.call(_e, {
+        const tagType = (_f = (_e = this.options).onOpenTagName) == null ? void 0 : _f.call(_e, {
           start,
           end,
           quasis,
-          expressions,
-          concise: this.isConcise
+          expressions
         });
         tag.tagName = tagName;
         if (tagType) {

package/dist/util/constants.d.ts

@@ -79,9 +79,6 @@ export declare namespace Ranges {
     interface Placeholder extends Value {
         escape: boolean;
     }
-    interface TagName extends Template {
-        concise: boolean;
-    }
     interface AttrValue extends Value {
         bound: boolean;
     }
@@ -92,9 +89,6 @@ export declare namespace Ranges {
     interface OpenTagEnd extends Range {
         selfClosed: boolean;
     }
-    interface CloseTag extends Range {
-        value: Range | undefined;
-    }
 }
 export declare enum ErrorCode {
     EXTRA_CLOSING_TAG = 0,
@@ -139,7 +133,8 @@ export interface ParserOptions {
     onDeclaration?(data: Ranges.Value): void;
     onDoctype?(data: Ranges.Value): void;
     onScriptlet?(data: Ranges.Scriptlet): void;
-    onTagName?(data: Ranges.TagName): TagType | void;
+    onOpenTagStart?(data: Range): void;
+    onOpenTagName?(data: Ranges.Template): TagType | void;
     onTagShorthandId?(data: Ranges.Template): void;
     onTagShorthandClass?(data: Ranges.Template): void;
     onTagVar?(data: Ranges.Value): void;
@@ -151,5 +146,7 @@ export interface ParserOptions {
     onAttrMethod?(data: Ranges.AttrMethod): void;
     onAttrSpread?(data: Ranges.Value): void;
     onOpenTagEnd?(data: Ranges.OpenTagEnd): void;
-    onCloseTag?(data: Ranges.CloseTag): void;
+    onCloseTagStart?(data: Range): void;
+    onCloseTagName?(data: Range): void;
+    onCloseTagEnd?(data: Range): void;
 }

package/package.json

@@ -1,32 +1,31 @@
 {
   "name": "htmljs-parser",
   "description": "An HTML parser recognizes content and string placeholders and allows JavaScript expressions as attribute values",
-  "version": "3.3.5",
+  "version": "5.0.0",
   "devDependencies": {
     "@changesets/changelog-github": "^0.4.4",
     "@changesets/cli": "^2.22.0",
-    "@types/benchmark": "^2.1.1",
     "@types/degit": "^2.8.3",
     "@types/mocha": "^9.1.1",
-    "@types/node": "^17.0.27",
-    "@typescript-eslint/eslint-plugin": "^5.21.0",
-    "@typescript-eslint/parser": "^5.21.0",
-    "benchmark": "^2.1.4",
+    "@types/node": "^17.0.38",
+    "@typescript-eslint/eslint-plugin": "^5.27.0",
+    "@typescript-eslint/parser": "^5.27.0",
     "cross-env": "^7.0.3",
     "degit": "^2.8.4",
-    "esbuild": "0.14.38",
-    "esbuild-register": "^3.3.2",
-    "eslint": "^8.14.0",
+    "esbuild": "0.14.42",
+    "eslint": "^8.16.0",
     "eslint-config-prettier": "^8.5.0",
     "fast-glob": "^3.2.11",
     "fixpack": "^4.0.0",
-    "husky": "^7.0.4",
-    "lint-staged": "^12.4.1",
-    "mocha": "^9.2.2",
+    "husky": "^8.0.1",
+    "lint-staged": "^13.0.0",
+    "mitata": "^0.1.1",
+    "mocha": "^10.0.0",
     "mocha-snap": "^4.3.0",
     "nyc": "^15.1.0",
     "prettier": "^2.6.2",
-    "typescript": "^4.6.3"
+    "tsx": "^3.4.2",
+    "typescript": "^4.7.2"
   },
   "exports": {
     ".": {
@@ -59,8 +58,9 @@
     "url": "https://github.com/marko-js/htmljs-parser.git"
   },
   "scripts": {
-    "bench": "npm run build && node -r esbuild-register ./src/__tests__/bench",
-    "build": "tsc -b && node -r esbuild-register build",
+    "bench": "tsx bench.mts",
+    "build": "tsc -b && tsx build.mts",
+    "change": "changeset add",
     "ci:test": "nyc npm run mocha -- --forbid-only",
     "format": "npm run lint:eslint -- --fix && npm run lint:prettier -- --write && (fixpack || true)",
     "lint": "tsc -b && npm run lint:eslint && npm run lint:prettier -- -l && fixpack",
@@ -68,7 +68,7 @@
     "lint:prettier": "prettier \"./**/*{.ts,.js,.json,.md,.yml,rc}\"",
     "mocha": "cross-env NODE_ENV=test mocha \"./src/**/__tests__/*.test.ts\"",
     "prepare": "husky install",
-    "publish": "npm run build && changeset publish",
+    "release": "npm run build && changeset publish",
     "report": "open ./coverage/lcov-report/index.html",
     "test": "npm run mocha -- --watch",
     "test:inspect": "npm test -- --inspect",