rehype-highlight-code-lines 1.0.5 → 1.0.8

package/README.md

@@ -140,6 +140,8 @@ All options are **optional** and have **default values**.
 ```typescript
 type HighlightLinesOptions = {
   showLineNumbers?: boolean; // default is "false"
+  lineContainerTagName?: "span" | "div"; // deprecated, always span
+  trimBlankLines?: boolean; // default is "false"
 };
 
 use(rehypeHighlightLines, HighlightLinesOptions);
@@ -173,20 +175,53 @@ Sometimes you may want to start the line numbering from a specific number. In th
 
 **\`\`\`showLineNumbers=8**
 
-#### `lineContainerTagName`
+#### `lineContainerTagName` (Deprecated)
 
-**It is a deprecated option.** Marked as `@deprecated`, will be removed in the next versions.
+**It is marked as `@deprecated` and will be removed in the next versions.
 
-It was a **union** type option which was **"div" | "span"** for providing custom HTML tag name for code lines.
+It was a **union** option which was **"div" | "span"** for providing custom HTML tag name for code lines.
 
 By default, it is `span` which is **inline** level container. If you set it as `div`, the container will still be `span` after deprecation.
 
 ```javascript
 use(rehypeHighlightLines, {
-  lineContainerTagName: "div", // @deprecated, always "span"
+  lineContainerTagName: "div", // @deprecated, effectless, always "span"
 });
 ```
 
+#### `trimBlankLines`
+
+It is a **boolean** option. It is designed to delete one blank/empty line at the beginning and one at the end of the code block, if happened due to html parsing `<pre><code /></pre>`.
+
+By default, it is `false`.
+
+Let's assume you want to highlight `pre`, and `code` element in markdown (not code fence).
+
+```markdown
+Here is markdown content
+
+<pre><code class="language-javascript">
+console.log("rehype-highlight-code-lines");
+</code></pre>
+```
+
+For above markdown, the parsed result (for example via `rehype-parse` and `rehype-stringfy`) is going to contain empty/blank code lines due to nature of `pre` preserving whitespaces. In order to prevent having unintentionally blank lines, use the option `trimBlankLines`.
+
+```javascript
+use(rehypeHighlightLines, {
+  trimBlankLines: true,
+});
+```
+
+Actually, the trimming could have been the default behaviour. However, some developers may intentionally include empty lines at the beginning and at the end in code fences for specific reasons and may want to preserve them.
+````markdown
+```javascript
+
+console.log("rehype-highlight-code-lines");
+
+```
+````
+
 ### Examples:
 
 ```typescript

package/dist/esm/index.d.ts

@@ -1,5 +1,10 @@
 import type { Plugin } from "unified";
 import type { Root } from "hast";
+declare module "hast" {
+    interface Data {
+        meta?: string | undefined;
+    }
+}
 export type HighlightLinesOptions = {
     showLineNumbers?: boolean;
     /**
@@ -7,6 +12,7 @@ export type HighlightLinesOptions = {
      * will be removed in the next versions
      */
     lineContainerTagName?: "div" | "span";
+    trimBlankLines?: boolean;
 };
 export declare function clsx(arr: (string | false | null | undefined | 0)[]): string[];
 /**

package/dist/esm/index.js

@@ -3,11 +3,30 @@ import rangeParser from "parse-numeric-range";
 const DEFAULT_SETTINGS = {
     showLineNumbers: false,
     lineContainerTagName: "span",
+    trimBlankLines: false,
 };
 // a simple util for our use case, like clsx package
 export function clsx(arr) {
     return arr.filter((item) => !!item);
 }
+// check if it is string array
+function isStringArray(value) {
+    return (
+    // type-coverage:ignore-next-line
+    Array.isArray(value) && value.every((item) => typeof item === "string"));
+}
+// check if it is Element which first child is text
+function isElementWithTextNode(node) {
+    return (node?.type === "element" && node.children[0]?.type === "text" && "value" in node.children[0]);
+}
+function hasClassName(node, className) {
+    return (node?.type === "element" &&
+        isStringArray(node.properties.className) &&
+        node.properties.className.some((cls) => cls.includes(className)));
+}
+// match all common types of line breaks
+const REGEX_LINE_BREAKS = /\r?\n|\r/g;
+const REGEX_LINE_BREAKS_IN_THE_BEGINNING = /^(\r?\n|\r)+/;
 /**
  *
  * add line numbers to code blocks and allow highlighting of desired code lines
@@ -20,19 +39,20 @@ const plugin = (options) => {
      * check code element children need flattening or not
      *
      */
-    function checkCodeTreeForFlatteningNeed(code) {
+    function hasFlatteningNeed(code) {
         const elementContents = code.children;
         // type ElementContent = Comment | Element | Text
         for (const elemenContent of elementContents) {
-            if (elemenContent.type === "element")
-                if (elemenContent.children.length >= 1 && elemenContent.children[0].type === "element")
+            if (elemenContent.type === "element" && Boolean(elemenContent.children.length))
+                if (elemenContent.children.some((ec) => ec.type === "element"))
                     return true;
         }
         return false;
     }
     /**
      *
-     * flatten code element children, recursively
+     * flatten deeper nodes into first level <span> and text, especially for languages like jsx, tsx
+     * mutates the code, recursively
      * inspired from https://github.com/react-syntax-highlighter/react-syntax-highlighter/blob/master/src/highlight.js
      *
      */
@@ -65,14 +85,10 @@ const plugin = (options) => {
      * construct the line element
      *
      */
-    const createLine = (children, lineNumber, startingNumber, directiveShowLineNumbers, linesToBeHighlighted) => {
+    const createLine = (children, lineNumber, directiveShowLineNumbers, directiveHighlightLines) => {
         const firstChild = children[0];
-        const isAddition = firstChild?.type === "element" &&
-            Array.isArray(firstChild.properties.className) &&
-            firstChild.properties.className.some((cls) => typeof cls === "string" && cls.includes("addition"));
-        const isDeletion = firstChild?.type === "element" &&
-            Array.isArray(firstChild.properties.className) &&
-            firstChild.properties.className.some((cls) => typeof cls === "string" && cls.includes("deletion"));
+        const isAddition = hasClassName(firstChild, "addition");
+        const isDeletion = hasClassName(firstChild, "deletion");
         return {
             type: "element",
             tagName: "span", // now it is always "span"
@@ -81,40 +97,110 @@ const plugin = (options) => {
                 className: clsx([
                     "code-line",
                     directiveShowLineNumbers && "numbered-code-line",
-                    linesToBeHighlighted.includes(lineNumber) && "highlighted-code-line",
+                    directiveHighlightLines.includes(lineNumber) && "highlighted-code-line",
                     isAddition && "inserted",
                     isDeletion && "deleted",
                 ]),
-                dataLineNumber: directiveShowLineNumbers ? startingNumber - 1 + lineNumber : undefined,
+                dataLineNumber: typeof directiveShowLineNumbers === "number"
+                    ? directiveShowLineNumbers - 1 + lineNumber
+                    : directiveShowLineNumbers
+                        ? lineNumber
+                        : undefined,
             },
         };
     };
-    // match all common types of line breaks
-    const REGEX_LINE_BREAKS = /\r?\n|\r/g;
     /**
      *
-     * check the code line is empty or with value only spaces
+     * handle elements which is multi line comment in code
+     * mutates the code
+     *
+     */
+    function handleMultiLineComments(code) {
+        for (let index = 0; index < code.children.length; index++) {
+            const replacement = [];
+            const child = code.children[index];
+            if (!isElementWithTextNode(child))
+                continue;
+            if (!hasClassName(child, "comment"))
+                continue;
+            const textNode = child.children[0];
+            if (!REGEX_LINE_BREAKS.test(textNode.value))
+                continue;
+            const comments = textNode.value.split(REGEX_LINE_BREAKS);
+            for (let i = 0; i < comments.length; i++) {
+                const newChild = structuredClone(child);
+                newChild.children[0].value = comments[i];
+                replacement.push(newChild);
+                if (i < comments.length - 1) {
+                    replacement.push({ type: "text", value: "\n" }); // eol
+                }
+            }
+            code.children = [
+                ...code.children.slice(0, index),
+                ...replacement,
+                ...code.children.slice(index + 1),
+            ];
+        }
+    }
+    /**
+     *
+     * handle eol characters in the beginning of the only first element
+     * (because gutter function does not check the first element in the HAST whether contain eol at the beginning)
+     * mutates the code
      *
      */
-    function isEmptyLine(line) {
-        return (line.length === 0 ||
-            (line.length === 1 && line[0].type === "text" && line[0].value.trim() === ""));
+    function handleFirstElementContent(code) {
+        const elementNode = code.children[0];
+        if (!isElementWithTextNode(elementNode))
+            return;
+        const textNode = elementNode.children[0];
+        if (!REGEX_LINE_BREAKS_IN_THE_BEGINNING.test(textNode.value))
+            return;
+        const match = REGEX_LINE_BREAKS_IN_THE_BEGINNING.exec(textNode.value);
+        if (match) {
+            code.children.unshift({ type: "text", value: match[0] });
+            textNode.value = textNode.value.replace(REGEX_LINE_BREAKS_IN_THE_BEGINNING, "");
+        }
     }
-    function gutter(tree, directiveShowLineNumbers, startingNumber, linesToBeHighlighted) {
+    /**
+     *
+     * handle trimming blank line for the last text node
+     *
+     */
+    function handleTrimmingBlankLines(code, directiveTrimBlankLines) {
+        if (!directiveTrimBlankLines)
+            return;
+        const lastChild = code.children[code.children.length - 1];
+        if (lastChild.type === "text") {
+            if (/(\r?\n|\r)(\1)$/.test(lastChild.value)) {
+                lastChild.value = lastChild.value.replace(/(\r?\n|\r)(\1)$/, "$1");
+            }
+        }
+    }
+    /**
+     *
+     * extract the lines from HAST of code element
+     * mutates the code
+     *
+     */
+    function gutter(code, { directiveShowLineNumbers, directiveHighlightLines, directiveTrimBlankLines, }) {
+        hasFlatteningNeed(code) && flattenCodeTree(code); // mutates the code
+        handleMultiLineComments(code); // mutates the code
+        handleFirstElementContent(code); // mutates the code
+        handleTrimmingBlankLines(code, directiveTrimBlankLines);
         const replacement = [];
-        let index = -1;
         let start = 0;
         let startTextRemainder = "";
         let lineNumber = 0;
-        while (++index < tree.children.length) {
-            const child = tree.children[index];
+        for (let index = 0; index < code.children.length; index++) {
+            const child = code.children[index];
             if (child.type !== "text")
                 continue;
             let textStart = 0;
-            let match = REGEX_LINE_BREAKS.exec(child.value);
-            while (match !== null) {
-                // Nodes in this line. (current child is exclusive)
-                const line = tree.children.slice(start, index);
+            const matches = Array.from(child.value.matchAll(REGEX_LINE_BREAKS));
+            matches.forEach((match, iteration) => {
+                // Nodes in this line. (current child (index) is exclusive)
+                const line = code.children.slice(start, index);
                 // Prepend text from a partial matched earlier text.
                 if (startTextRemainder) {
                     line.unshift({ type: "text", value: startTextRemainder });
@@ -125,36 +211,35 @@ const plugin = (options) => {
                     const value = child.value.slice(textStart, match.index);
                     line.push({ type: "text", value });
                 }
-                if (!isEmptyLine(line)) {
+                const isFirstIteration = index === 0 && iteration === 0;
+                if (isFirstIteration && directiveTrimBlankLines && line.length === 0) {
+                    replacement.push({ type: "text", value: match[0] }); // eol
+                }
+                else {
                     lineNumber += 1;
-                    replacement.push(createLine(line, lineNumber, startingNumber, directiveShowLineNumbers, linesToBeHighlighted));
+                    replacement.push(createLine(line, lineNumber, directiveShowLineNumbers, directiveHighlightLines), { type: "text", value: match[0] });
                 }
-                // Add eol
-                replacement.push({ type: "text", value: match[0] });
                 start = index + 1;
                 textStart = match.index + match[0].length;
-                // iterate the match
-                match = REGEX_LINE_BREAKS.exec(child.value);
-            }
+            });
             // If we matched, make sure to not drop the text after the last line ending.
             if (start === index + 1) {
                 startTextRemainder = child.value.slice(textStart);
             }
         }
-        const line = tree.children.slice(start);
+        const line = code.children.slice(start);
         // Prepend text from a partial matched earlier text.
         if (startTextRemainder) {
             line.unshift({ type: "text", value: startTextRemainder });
             startTextRemainder = "";
         }
-        if (!isEmptyLine(line)) {
-            if (line.length > 0) {
-                lineNumber += 1;
-                replacement.push(createLine(line, lineNumber, startingNumber, directiveShowLineNumbers, linesToBeHighlighted));
-            }
+        if (line.length > 0) {
+            directiveTrimBlankLines
+                ? replacement.push(...line)
+                : replacement.push(createLine(line, ++lineNumber, directiveShowLineNumbers, directiveHighlightLines));
         }
         // Replace children with new array.
-        tree.children = replacement;
+        code.children = replacement;
     }
     /**
      *
@@ -183,53 +268,58 @@ const plugin = (options) => {
      *   Nothing.
      */
     return (tree) => {
-        visit(tree, "element", function (node, index, parent) {
-            if (!parent || index === undefined || node.tagName !== "code") {
+        visit(tree, "element", function (code, index, parent) {
+            if (!parent || index === undefined || code.tagName !== "code") {
                 return;
             }
             if (parent.type !== "element" || parent.tagName !== "pre") {
                 return;
             }
-            const code = node;
             const classNames = code.properties.className;
             // only for type narrowing
             /* v8 ignore next */
-            if (!Array.isArray(classNames) && classNames !== undefined)
+            if (!isStringArray(classNames) && classNames !== undefined)
                 return;
-            let meta = code.data?.meta?.toLowerCase().trim() || "";
+            let meta = code.data?.meta?.toLowerCase().trim() ?? "";
             const language = getLanguage(classNames);
             if (language?.startsWith("{") ||
                 language?.startsWith("showlinenumbers") ||
-                language?.startsWith("nolinenumbers")) {
+                language?.startsWith("nolinenumbers") ||
+                language?.startsWith("trimblanklines")) {
                 // add specifiers to meta
                 meta = (language + " " + meta).trim();
-                // remove all classnames like hljs, lang-x, language-x, because of false positive
+                // correct the code's meta
+                code.data && (code.data.meta = meta);
+                // remove all classnames like hljs, lang-{1,3}, language-showLineNumbers, because of false positive
                 code.properties.className = undefined;
             }
-            const directiveShowLineNumbers = meta.includes("nolinenumbers")
+            let directiveShowLineNumbers = meta.includes("nolinenumbers")
                 ? false
                 : settings.showLineNumbers || meta.includes("showlinenumbers");
-            let startingNumber = 1;
             // find the number where the line number starts, if exists
-            if (directiveShowLineNumbers) {
-                const REGEX1 = /showlinenumbers=(?<start>\d+)/i;
-                const start = REGEX1.exec(meta)?.groups?.start;
-                if (start && !isNaN(Number(start)))
-                    startingNumber = Number(start);
-            }
+            const REGEX1 = /showlinenumbers=(?<start>\d+)/i;
+            const start = REGEX1.exec(meta)?.groups?.start;
+            if (start && !isNaN(Number(start)))
+                directiveShowLineNumbers = Number(start);
             // find number range string within curly braces and parse it
             const REGEX2 = /{(?<lines>[\d\s,-]+)}/g;
             const strLineNumbers = REGEX2.exec(meta)?.groups?.lines?.replace(/\s/g, "");
-            const linesToBeHighlighted = strLineNumbers ? rangeParser(strLineNumbers) : [];
-            // if nothing to do for numbering and highlihting, just return
-            if (!directiveShowLineNumbers && linesToBeHighlighted.length === 0)
+            const directiveHighlightLines = strLineNumbers ? rangeParser(strLineNumbers) : [];
+            // find the directive for trimming blank lines
+            const REGEX3 = /trimblanklines/i;
+            const directiveTrimBlankLines = settings.trimBlankLines || REGEX3.test(meta);
+            // if nothing to do for numbering, highlihting or trimming blank lines, just return;
+            if (directiveShowLineNumbers === false &&
+                directiveHighlightLines.length === 0 &&
+                directiveTrimBlankLines === false) {
                 return;
-            // flatten deeper nodes into first level <span> and text, especially for languages like jsx, tsx
-            if (checkCodeTreeForFlatteningNeed(code)) {
-                flattenCodeTree(code);
             }
             // add container for each line mutating the code element
-            gutter(code, directiveShowLineNumbers, startingNumber, linesToBeHighlighted);
+            gutter(code, {
+                directiveShowLineNumbers,
+                directiveHighlightLines,
+                directiveTrimBlankLines,
+            });
         });
     };
 };

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rehype-highlight-code-lines",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "Rehype plugin to add line numbers to code blocks and allow highlighting of desired code lines",
   "type": "module",
   "exports": "./dist/esm/index.js",
@@ -13,7 +13,10 @@
     "lint": "eslint .",
     "test": "vitest --watch=false",
     "test:watch": "vitest",
-    "test:file": "vitest test.html.spec.ts",
+    "test:file1": "vitest test.md.spec.ts",
+    "test:file2": "vitest test.html.spec.ts",
+    "test:file3": "vitest test.cases.spec.ts",
+    "test:file4": "vitest from-rehype-highlight/test.rhcl2.spec.ts",
     "prepack": "npm run build",
     "prepublishOnly": "npm run test && npm run format && npm run test-coverage",
     "test-coverage": "vitest run --coverage"
@@ -51,16 +54,16 @@
     "url": "https://github.com/ipikuka/rehype-highlight-code-lines/issues"
   },
   "devDependencies": {
-    "@eslint/js": "^9.19.0",
+    "@eslint/js": "^9.20.0",
     "@types/dedent": "^0.7.2",
     "@types/node": "^22.13.1",
     "@vitest/coverage-v8": "^3.0.5",
-    "@vitest/eslint-plugin": "^1.1.25",
+    "@vitest/eslint-plugin": "^1.1.27",
     "dedent": "^1.5.3",
-    "eslint": "^9.19.0",
+    "eslint": "^9.20.0",
     "eslint-config-prettier": "^10.0.1",
     "eslint-plugin-prettier": "^5.2.3",
-    "prettier": "^3.4.2",
+    "prettier": "^3.5.0",
     "rehype": "^13.0.2",
     "rehype-highlight": "^7.0.2",
     "rehype-parse": "^9.0.1",
@@ -74,14 +77,17 @@
     "typescript-eslint": "^8.23.0",
     "unist-util-remove-position": "^5.0.0",
     "vfile": "^6.0.3",
-    "vitest": "^3.0.5"
+    "vitest": "^3.0.5",
+    "unified": "^11.0.5"
   },
   "dependencies": {
     "@types/hast": "^3.0.4",
     "parse-numeric-range": "^1.3.0",
-    "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0"
   },
+  "peerDependencies": {
+    "unified": "^11"
+  },
   "typeCoverage": {
     "atLeast": 100,
     "detail": true,

package/src/index.ts

@@ -1,5 +1,5 @@
 import type { Plugin } from "unified";
-import type { Root, Element, ElementContent, ElementData } from "hast";
+import type { Root, Element, Text, ElementContent } from "hast";
 import { visit, type VisitorResult } from "unist-util-visit";
 import rangeParser from "parse-numeric-range";
 
@@ -7,6 +7,16 @@ type Prettify<T> = { [K in keyof T]: T[K] } & {};
 
 type PartiallyRequired<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
 
+declare module "hast" {
+  interface Data {
+    meta?: string | undefined;
+  }
+}
+
+type ElementWithTextNode = Element & {
+  children: [Text, ...ElementContent[]];
+};
+
 export type HighlightLinesOptions = {
   showLineNumbers?: boolean;
   /**
@@ -14,19 +24,23 @@ export type HighlightLinesOptions = {
    * will be removed in the next versions
    */
   lineContainerTagName?: "div" | "span";
+  trimBlankLines?: boolean;
 };
 
 const DEFAULT_SETTINGS: HighlightLinesOptions = {
   showLineNumbers: false,
   lineContainerTagName: "span",
+  trimBlankLines: false,
 };
 
 type PartiallyRequiredHighlightLinesOptions = Prettify<
   PartiallyRequired<HighlightLinesOptions, "showLineNumbers" | "lineContainerTagName">
 >;
 
-type CodeData = ElementData & {
-  meta?: string;
+type GutterOptions = {
+  directiveShowLineNumbers: boolean | number;
+  directiveHighlightLines: number[];
+  directiveTrimBlankLines: boolean;
 };
 
 // a simple util for our use case, like clsx package
@@ -34,6 +48,33 @@ export function clsx(arr: (string | false | null | undefined | 0)[]): string[] {
   return arr.filter((item): item is string => !!item);
 }
 
+// check if it is string array
+function isStringArray(value: unknown): value is string[] {
+  return (
+    // type-coverage:ignore-next-line
+    Array.isArray(value) && value.every((item) => typeof item === "string")
+  );
+}
+
+// check if it is Element which first child is text
+function isElementWithTextNode(node: ElementContent | undefined): node is ElementWithTextNode {
+  return (
+    node?.type === "element" && node.children[0]?.type === "text" && "value" in node.children[0]
+  );
+}
+
+function hasClassName(node: ElementContent | undefined, className: string): boolean {
+  return (
+    node?.type === "element" &&
+    isStringArray(node.properties.className) &&
+    node.properties.className.some((cls) => cls.includes(className))
+  );
+}
+
+// match all common types of line breaks
+const REGEX_LINE_BREAKS = /\r?\n|\r/g;
+const REGEX_LINE_BREAKS_IN_THE_BEGINNING = /^(\r?\n|\r)+/;
+
 /**
  *
  * add line numbers to code blocks and allow highlighting of desired code lines
@@ -51,14 +92,13 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
    * check code element children need flattening or not
    *
    */
-  function checkCodeTreeForFlatteningNeed(code: Element): boolean {
+  function hasFlatteningNeed(code: Element): boolean {
     const elementContents = code.children;
 
     // type ElementContent = Comment | Element | Text
     for (const elemenContent of elementContents) {
-      if (elemenContent.type === "element")
-        if (elemenContent.children.length >= 1 && elemenContent.children[0].type === "element")
-          return true;
+      if (elemenContent.type === "element" && Boolean(elemenContent.children.length))
+        if (elemenContent.children.some((ec) => ec.type === "element")) return true;
     }
 
     return false;
@@ -66,7 +106,8 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
 
   /**
    *
-   * flatten code element children, recursively
+   * flatten deeper nodes into first level <span> and text, especially for languages like jsx, tsx
+   * mutates the code, recursively
    * inspired from https://github.com/react-syntax-highlighter/react-syntax-highlighter/blob/master/src/highlight.js
    *
    */
@@ -106,25 +147,12 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
   const createLine = (
     children: ElementContent[],
     lineNumber: number,
-    startingNumber: number,
-    directiveShowLineNumbers: boolean,
-    linesToBeHighlighted: number[],
+    directiveShowLineNumbers: boolean | number,
+    directiveHighlightLines: number[],
   ): Element => {
     const firstChild = children[0];
-
-    const isAddition =
-      firstChild?.type === "element" &&
-      Array.isArray(firstChild.properties.className) &&
-      firstChild.properties.className.some(
-        (cls) => typeof cls === "string" && cls.includes("addition"),
-      );
-
-    const isDeletion =
-      firstChild?.type === "element" &&
-      Array.isArray(firstChild.properties.className) &&
-      firstChild.properties.className.some(
-        (cls) => typeof cls === "string" && cls.includes("deletion"),
-      );
+    const isAddition = hasClassName(firstChild, "addition");
+    const isDeletion = hasClassName(firstChild, "deletion");
 
     return {
       type: "element",
@@ -134,54 +162,136 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
         className: clsx([
           "code-line",
           directiveShowLineNumbers && "numbered-code-line",
-          linesToBeHighlighted.includes(lineNumber) && "highlighted-code-line",
+          directiveHighlightLines.includes(lineNumber) && "highlighted-code-line",
           isAddition && "inserted",
           isDeletion && "deleted",
         ]),
-        dataLineNumber: directiveShowLineNumbers ? startingNumber - 1 + lineNumber : undefined,
+        dataLineNumber:
+          typeof directiveShowLineNumbers === "number"
+            ? directiveShowLineNumbers - 1 + lineNumber
+            : directiveShowLineNumbers
+              ? lineNumber
+              : undefined,
       },
     };
   };
 
-  // match all common types of line breaks
-  const REGEX_LINE_BREAKS = /\r?\n|\r/g;
+  /**
+   *
+   * handle elements which is multi line comment in code
+   * mutates the code
+   *
+   */
+  function handleMultiLineComments(code: Element): undefined {
+    for (let index = 0; index < code.children.length; index++) {
+      const replacement: ElementContent[] = [];
+
+      const child = code.children[index];
+
+      if (!isElementWithTextNode(child)) continue;
+      if (!hasClassName(child, "comment")) continue;
+
+      const textNode = child.children[0];
+      if (!REGEX_LINE_BREAKS.test(textNode.value)) continue;
+      const comments = textNode.value.split(REGEX_LINE_BREAKS);
+
+      for (let i = 0; i < comments.length; i++) {
+        const newChild = structuredClone(child);
+        newChild.children[0].value = comments[i];
+        replacement.push(newChild);
+
+        if (i < comments.length - 1) {
+          replacement.push({ type: "text", value: "\n" }); // eol
+        }
+      }
+
+      code.children = [
+        ...code.children.slice(0, index),
+        ...replacement,
+        ...code.children.slice(index + 1),
+      ];
+    }
+  }
 
   /**
    *
-   * check the code line is empty or with value only spaces
+   * handle eol characters in the beginning of the only first element
+   * (because gutter function does not check the first element in the HAST whether contain eol at the beginning)
+   * mutates the code
    *
    */
-  function isEmptyLine(line: ElementContent[]): boolean {
-    return (
-      line.length === 0 ||
-      (line.length === 1 && line[0].type === "text" && line[0].value.trim() === "")
-    );
+  function handleFirstElementContent(code: Element): undefined {
+    const elementNode = code.children[0];
+    if (!isElementWithTextNode(elementNode)) return;
+
+    const textNode = elementNode.children[0];
+    if (!REGEX_LINE_BREAKS_IN_THE_BEGINNING.test(textNode.value)) return;
+
+    const match = REGEX_LINE_BREAKS_IN_THE_BEGINNING.exec(textNode.value);
+
+    if (match) {
+      code.children.unshift({ type: "text", value: match[0] });
+
+      textNode.value = textNode.value.replace(REGEX_LINE_BREAKS_IN_THE_BEGINNING, "");
+    }
   }
 
+  /**
+   *
+   * handle trimming blank line for the last text node
+   *
+   */
+  function handleTrimmingBlankLines(code: Element, directiveTrimBlankLines: boolean) {
+    if (!directiveTrimBlankLines) return;
+
+    const lastChild = code.children[code.children.length - 1];
+
+    if (lastChild.type === "text") {
+      if (/(\r?\n|\r)(\1)$/.test(lastChild.value)) {
+        lastChild.value = lastChild.value.replace(/(\r?\n|\r)(\1)$/, "$1");
+      }
+    }
+  }
+
+  /**
+   *
+   * extract the lines from HAST of code element
+   * mutates the code
+   *
+   */
   function gutter(
-    tree: Element,
-    directiveShowLineNumbers: boolean,
-    startingNumber: number,
-    linesToBeHighlighted: number[],
+    code: Element,
+    {
+      directiveShowLineNumbers,
+      directiveHighlightLines,
+      directiveTrimBlankLines,
+    }: GutterOptions,
   ) {
+    hasFlatteningNeed(code) && flattenCodeTree(code); // mutates the code
+
+    handleMultiLineComments(code); // mutates the code
+
+    handleFirstElementContent(code); // mutates the code
+
+    handleTrimmingBlankLines(code, directiveTrimBlankLines);
+
     const replacement: ElementContent[] = [];
 
-    let index = -1;
     let start = 0;
     let startTextRemainder = "";
     let lineNumber = 0;
 
-    while (++index < tree.children.length) {
-      const child = tree.children[index];
+    for (let index = 0; index < code.children.length; index++) {
+      const child = code.children[index];
 
       if (child.type !== "text") continue;
 
       let textStart = 0;
-      let match = REGEX_LINE_BREAKS.exec(child.value);
 
-      while (match !== null) {
-        // Nodes in this line. (current child is exclusive)
-        const line = tree.children.slice(start, index);
+      const matches = Array.from(child.value.matchAll(REGEX_LINE_BREAKS));
+      matches.forEach((match, iteration) => {
+        // Nodes in this line. (current child (index) is exclusive)
+        const line = code.children.slice(start, index);
 
         // Prepend text from a partial matched earlier text.
         if (startTextRemainder) {
@@ -195,28 +305,21 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
           line.push({ type: "text", value });
         }
 
-        if (!isEmptyLine(line)) {
+        const isFirstIteration = index === 0 && iteration === 0;
+
+        if (isFirstIteration && directiveTrimBlankLines && line.length === 0) {
+          replacement.push({ type: "text", value: match[0] }); // eol
+        } else {
           lineNumber += 1;
           replacement.push(
-            createLine(
-              line,
-              lineNumber,
-              startingNumber,
-              directiveShowLineNumbers,
-              linesToBeHighlighted,
-            ),
+            createLine(line, lineNumber, directiveShowLineNumbers, directiveHighlightLines),
+            { type: "text", value: match[0] }, // eol
           );
         }
 
-        // Add eol
-        replacement.push({ type: "text", value: match[0] });
-
         start = index + 1;
         textStart = match.index + match[0].length;
-
-        // iterate the match
-        match = REGEX_LINE_BREAKS.exec(child.value);
-      }
+      });
 
       // If we matched, make sure to not drop the text after the last line ending.
       if (start === index + 1) {
@@ -224,7 +327,7 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
       }
     }
 
-    const line = tree.children.slice(start);
+    const line = code.children.slice(start);
 
     // Prepend text from a partial matched earlier text.
     if (startTextRemainder) {
@@ -232,23 +335,16 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
       startTextRemainder = "";
     }
 
-    if (!isEmptyLine(line)) {
-      if (line.length > 0) {
-        lineNumber += 1;
-        replacement.push(
-          createLine(
-            line,
-            lineNumber,
-            startingNumber,
-            directiveShowLineNumbers,
-            linesToBeHighlighted,
-          ),
-        );
-      }
+    if (line.length > 0) {
+      directiveTrimBlankLines
+        ? replacement.push(...line)
+        : replacement.push(
+            createLine(line, ++lineNumber, directiveShowLineNumbers, directiveHighlightLines),
+          );
     }
 
     // Replace children with new array.
-    tree.children = replacement;
+    code.children = replacement;
   }
 
   /**
@@ -283,8 +379,8 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
    *   Nothing.
    */
   return (tree: Root): undefined => {
-    visit(tree, "element", function (node, index, parent): VisitorResult {
-      if (!parent || index === undefined || node.tagName !== "code") {
+    visit(tree, "element", function (code, index, parent): VisitorResult {
+      if (!parent || index === undefined || code.tagName !== "code") {
         return;
       }
 
@@ -292,58 +388,65 @@ const plugin: Plugin<[HighlightLinesOptions?], Root> = (options) => {
         return;
       }
 
-      const code = node;
-
       const classNames = code.properties.className;
 
       // only for type narrowing
       /* v8 ignore next */
-      if (!Array.isArray(classNames) && classNames !== undefined) return;
+      if (!isStringArray(classNames) && classNames !== undefined) return;
 
-      let meta = (code.data as CodeData)?.meta?.toLowerCase().trim() || "";
+      let meta = code.data?.meta?.toLowerCase().trim() ?? "";
 
       const language = getLanguage(classNames);
 
       if (
         language?.startsWith("{") ||
         language?.startsWith("showlinenumbers") ||
-        language?.startsWith("nolinenumbers")
+        language?.startsWith("nolinenumbers") ||
+        language?.startsWith("trimblanklines")
       ) {
         // add specifiers to meta
         meta = (language + " " + meta).trim();
 
-        // remove all classnames like hljs, lang-x, language-x, because of false positive
+        // correct the code's meta
+        code.data && (code.data.meta = meta);
+
+        // remove all classnames like hljs, lang-{1,3}, language-showLineNumbers, because of false positive
         code.properties.className = undefined;
       }
 
-      const directiveShowLineNumbers = meta.includes("nolinenumbers")
+      let directiveShowLineNumbers: boolean | number = meta.includes("nolinenumbers")
         ? false
         : settings.showLineNumbers || meta.includes("showlinenumbers");
 
-      let startingNumber = 1;
-
       // find the number where the line number starts, if exists
-      if (directiveShowLineNumbers) {
-        const REGEX1 = /showlinenumbers=(?<start>\d+)/i;
-        const start = REGEX1.exec(meta)?.groups?.start;
-        if (start && !isNaN(Number(start))) startingNumber = Number(start);
-      }
+      const REGEX1 = /showlinenumbers=(?<start>\d+)/i;
+      const start = REGEX1.exec(meta)?.groups?.start;
+      if (start && !isNaN(Number(start))) directiveShowLineNumbers = Number(start);
 
       // find number range string within curly braces and parse it
       const REGEX2 = /{(?<lines>[\d\s,-]+)}/g;
       const strLineNumbers = REGEX2.exec(meta)?.groups?.lines?.replace(/\s/g, "");
-      const linesToBeHighlighted = strLineNumbers ? rangeParser(strLineNumbers) : [];
+      const directiveHighlightLines = strLineNumbers ? rangeParser(strLineNumbers) : [];
 
-      // if nothing to do for numbering and highlihting, just return
-      if (!directiveShowLineNumbers && linesToBeHighlighted.length === 0) return;
+      // find the directive for trimming blank lines
+      const REGEX3 = /trimblanklines/i;
+      const directiveTrimBlankLines = settings.trimBlankLines || REGEX3.test(meta);
 
-      // flatten deeper nodes into first level <span> and text, especially for languages like jsx, tsx
-      if (checkCodeTreeForFlatteningNeed(code)) {
-        flattenCodeTree(code);
+      // if nothing to do for numbering, highlihting or trimming blank lines, just return;
+      if (
+        directiveShowLineNumbers === false &&
+        directiveHighlightLines.length === 0 &&
+        directiveTrimBlankLines === false
+      ) {
+        return;
       }
 
       // add container for each line mutating the code element
-      gutter(code, directiveShowLineNumbers, startingNumber, linesToBeHighlighted);
+      gutter(code, {
+        directiveShowLineNumbers,
+        directiveHighlightLines,
+        directiveTrimBlankLines,
+      });
     });
   };
 };