@shikijs/transformers 1.16.2 → 1.17.0

package/dist/index.d.mts

@@ -1,55 +1,48 @@
 import { ShikiTransformer, ShikiTransformerContext } from 'shiki';
 import { Element } from 'hast';
 
-interface TransformerRenderWhitespaceOptions {
+interface TransformerCompactLineOption {
     /**
-     * Class for tab
-     *
-     * @default 'tab'
+     * 1-based line number.
      */
-    classTab?: string;
+    line: number;
+    classes?: string[];
+}
+/**
+ * Transformer for `shiki`'s legacy `lineOptions`
+ */
+declare function transformerCompactLineOptions(lineOptions?: TransformerCompactLineOption[]): ShikiTransformer;
+
+interface TransformerNotationDiffOptions {
     /**
-     * Class for space
-     *
-     * @default 'space'
+     * Class for added lines
      */
-    classSpace?: string;
+    classLineAdd?: string;
     /**
-     * Position of rendered whitespace
-     * @default all position
+     * Class for removed lines
      */
-    position?: 'all' | 'boundary' | 'trailing';
+    classLineRemove?: string;
+    /**
+     * Class added to the <pre> element when the current code has diff
+     */
+    classActivePre?: string;
 }
 /**
- * Render whitespaces as separate tokens.
- * Apply with CSS, it can be used to render tabs and spaces visually.
- */
-declare function transformerRenderWhitespace(options?: TransformerRenderWhitespaceOptions): ShikiTransformer;
-
-/**
- * Remove line breaks between lines.
- * Useful when you override `display: block` to `.line` in CSS.
- */
-declare function transformerRemoveLineBreak(): ShikiTransformer;
-
-/**
- * Remove notation escapes.
- * Useful when you want to write `// [!code` in markdown.
- * If you process `// [\!code ...]` expression, you can get `// [!code ...]` in the output.
+ * Use `[!code ++]` and `[!code --]` to mark added and removed lines.
  */
-declare function transformerRemoveNotationEscape(): ShikiTransformer;
+declare function transformerNotationDiff(options?: TransformerNotationDiffOptions): ShikiTransformer;
 
-interface TransformerCompactLineOption {
+interface TransformerNotationErrorLevelOptions {
+    classMap?: Record<string, string | string[]>;
     /**
-     * 1-based line number.
+     * Class added to the <pre> element when the current code has diff
      */
-    line: number;
-    classes?: string[];
+    classActivePre?: string;
 }
 /**
- * Transformer for `shiki`'s legacy `lineOptions`
+ * Allow using `[!code error]` `[!code warning]` notation in code to mark highlighted lines.
  */
-declare function transformerCompactLineOptions(lineOptions?: TransformerCompactLineOption[]): ShikiTransformer;
+declare function transformerNotationErrorLevel(options?: TransformerNotationErrorLevelOptions): ShikiTransformer;
 
 interface TransformerNotationFocusOptions {
     /**
@@ -93,50 +86,43 @@ interface TransformerNotationWordHighlightOptions {
 }
 declare function transformerNotationWordHighlight(options?: TransformerNotationWordHighlightOptions): ShikiTransformer;
 
-declare function parseMetaHighlightWords(meta: string): string[];
-interface TransformerMetaWordHighlightOptions {
-    /**
-     * Class for highlighted words
-     *
-     * @default 'highlighted-word'
-     */
-    className?: string;
-}
 /**
- * Allow using `/word/` in the code snippet meta to mark highlighted words.
+ * Remove line breaks between lines.
+ * Useful when you override `display: block` to `.line` in CSS.
  */
-declare function transformerMetaWordHighlight(options?: TransformerMetaWordHighlightOptions): ShikiTransformer;
+declare function transformerRemoveLineBreak(): ShikiTransformer;
 
-interface TransformerNotationDiffOptions {
-    /**
-     * Class for added lines
-     */
-    classLineAdd?: string;
+/**
+ * Remove notation escapes.
+ * Useful when you want to write `// [!code` in markdown.
+ * If you process `// [\!code ...]` expression, you can get `// [!code ...]` in the output.
+ */
+declare function transformerRemoveNotationEscape(): ShikiTransformer;
+
+interface TransformerRenderWhitespaceOptions {
     /**
-     * Class for removed lines
+     * Class for tab
+     *
+     * @default 'tab'
      */
-    classLineRemove?: string;
+    classTab?: string;
     /**
-     * Class added to the <pre> element when the current code has diff
+     * Class for space
+     *
+     * @default 'space'
      */
-    classActivePre?: string;
-}
-/**
- * Use `[!code ++]` and `[!code --]` to mark added and removed lines.
- */
-declare function transformerNotationDiff(options?: TransformerNotationDiffOptions): ShikiTransformer;
-
-interface TransformerNotationErrorLevelOptions {
-    classMap?: Record<string, string | string[]>;
+    classSpace?: string;
     /**
-     * Class added to the <pre> element when the current code has diff
+     * Position of rendered whitespace
+     * @default all position
      */
-    classActivePre?: string;
+    position?: 'all' | 'boundary' | 'trailing';
 }
 /**
- * Allow using `[!code error]` `[!code warning]` notation in code to mark highlighted lines.
+ * Render whitespaces as separate tokens.
+ * Apply with CSS, it can be used to render tabs and spaces visually.
  */
-declare function transformerNotationErrorLevel(options?: TransformerNotationErrorLevelOptions): ShikiTransformer;
+declare function transformerRenderWhitespace(options?: TransformerRenderWhitespaceOptions): ShikiTransformer;
 
 declare function parseMetaHighlightString(meta: string): number[] | null;
 interface TransformerMetaHighlightOptions {
@@ -152,6 +138,20 @@ interface TransformerMetaHighlightOptions {
  */
 declare function transformerMetaHighlight(options?: TransformerMetaHighlightOptions): ShikiTransformer;
 
+declare function parseMetaHighlightWords(meta: string): string[];
+interface TransformerMetaWordHighlightOptions {
+    /**
+     * Class for highlighted words
+     *
+     * @default 'highlighted-word'
+     */
+    className?: string;
+}
+/**
+ * Allow using `/word/` in the code snippet meta to mark highlighted words.
+ */
+declare function transformerMetaWordHighlight(options?: TransformerMetaWordHighlightOptions): ShikiTransformer;
+
 declare function createCommentNotationTransformer(name: string, regex: RegExp, onMatch: (this: ShikiTransformerContext, match: string[], line: Element, commentNode: Element, lines: Element[], index: number) => boolean, removeEmptyLines?: boolean): ShikiTransformer;
 
 export { type TransformerCompactLineOption, type TransformerMetaHighlightOptions, type TransformerMetaWordHighlightOptions, type TransformerNotationDiffOptions, type TransformerNotationErrorLevelOptions, type TransformerNotationFocusOptions, type TransformerNotationHighlightOptions, type TransformerNotationWordHighlightOptions, type TransformerRenderWhitespaceOptions, createCommentNotationTransformer, parseMetaHighlightString, parseMetaHighlightWords, transformerCompactLineOptions, transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationWordHighlight, transformerRemoveLineBreak, transformerRemoveNotationEscape, transformerRenderWhitespace };

package/dist/index.d.ts

@@ -1,55 +1,48 @@
 import { ShikiTransformer, ShikiTransformerContext } from 'shiki';
 import { Element } from 'hast';
 
-interface TransformerRenderWhitespaceOptions {
+interface TransformerCompactLineOption {
     /**
-     * Class for tab
-     *
-     * @default 'tab'
+     * 1-based line number.
      */
-    classTab?: string;
+    line: number;
+    classes?: string[];
+}
+/**
+ * Transformer for `shiki`'s legacy `lineOptions`
+ */
+declare function transformerCompactLineOptions(lineOptions?: TransformerCompactLineOption[]): ShikiTransformer;
+
+interface TransformerNotationDiffOptions {
     /**
-     * Class for space
-     *
-     * @default 'space'
+     * Class for added lines
      */
-    classSpace?: string;
+    classLineAdd?: string;
     /**
-     * Position of rendered whitespace
-     * @default all position
+     * Class for removed lines
      */
-    position?: 'all' | 'boundary' | 'trailing';
+    classLineRemove?: string;
+    /**
+     * Class added to the <pre> element when the current code has diff
+     */
+    classActivePre?: string;
 }
 /**
- * Render whitespaces as separate tokens.
- * Apply with CSS, it can be used to render tabs and spaces visually.
- */
-declare function transformerRenderWhitespace(options?: TransformerRenderWhitespaceOptions): ShikiTransformer;
-
-/**
- * Remove line breaks between lines.
- * Useful when you override `display: block` to `.line` in CSS.
- */
-declare function transformerRemoveLineBreak(): ShikiTransformer;
-
-/**
- * Remove notation escapes.
- * Useful when you want to write `// [!code` in markdown.
- * If you process `// [\!code ...]` expression, you can get `// [!code ...]` in the output.
+ * Use `[!code ++]` and `[!code --]` to mark added and removed lines.
  */
-declare function transformerRemoveNotationEscape(): ShikiTransformer;
+declare function transformerNotationDiff(options?: TransformerNotationDiffOptions): ShikiTransformer;
 
-interface TransformerCompactLineOption {
+interface TransformerNotationErrorLevelOptions {
+    classMap?: Record<string, string | string[]>;
     /**
-     * 1-based line number.
+     * Class added to the <pre> element when the current code has diff
      */
-    line: number;
-    classes?: string[];
+    classActivePre?: string;
 }
 /**
- * Transformer for `shiki`'s legacy `lineOptions`
+ * Allow using `[!code error]` `[!code warning]` notation in code to mark highlighted lines.
  */
-declare function transformerCompactLineOptions(lineOptions?: TransformerCompactLineOption[]): ShikiTransformer;
+declare function transformerNotationErrorLevel(options?: TransformerNotationErrorLevelOptions): ShikiTransformer;
 
 interface TransformerNotationFocusOptions {
     /**
@@ -93,50 +86,43 @@ interface TransformerNotationWordHighlightOptions {
 }
 declare function transformerNotationWordHighlight(options?: TransformerNotationWordHighlightOptions): ShikiTransformer;
 
-declare function parseMetaHighlightWords(meta: string): string[];
-interface TransformerMetaWordHighlightOptions {
-    /**
-     * Class for highlighted words
-     *
-     * @default 'highlighted-word'
-     */
-    className?: string;
-}
 /**
- * Allow using `/word/` in the code snippet meta to mark highlighted words.
+ * Remove line breaks between lines.
+ * Useful when you override `display: block` to `.line` in CSS.
  */
-declare function transformerMetaWordHighlight(options?: TransformerMetaWordHighlightOptions): ShikiTransformer;
+declare function transformerRemoveLineBreak(): ShikiTransformer;
 
-interface TransformerNotationDiffOptions {
-    /**
-     * Class for added lines
-     */
-    classLineAdd?: string;
+/**
+ * Remove notation escapes.
+ * Useful when you want to write `// [!code` in markdown.
+ * If you process `// [\!code ...]` expression, you can get `// [!code ...]` in the output.
+ */
+declare function transformerRemoveNotationEscape(): ShikiTransformer;
+
+interface TransformerRenderWhitespaceOptions {
     /**
-     * Class for removed lines
+     * Class for tab
+     *
+     * @default 'tab'
      */
-    classLineRemove?: string;
+    classTab?: string;
     /**
-     * Class added to the <pre> element when the current code has diff
+     * Class for space
+     *
+     * @default 'space'
      */
-    classActivePre?: string;
-}
-/**
- * Use `[!code ++]` and `[!code --]` to mark added and removed lines.
- */
-declare function transformerNotationDiff(options?: TransformerNotationDiffOptions): ShikiTransformer;
-
-interface TransformerNotationErrorLevelOptions {
-    classMap?: Record<string, string | string[]>;
+    classSpace?: string;
     /**
-     * Class added to the <pre> element when the current code has diff
+     * Position of rendered whitespace
+     * @default all position
      */
-    classActivePre?: string;
+    position?: 'all' | 'boundary' | 'trailing';
 }
 /**
- * Allow using `[!code error]` `[!code warning]` notation in code to mark highlighted lines.
+ * Render whitespaces as separate tokens.
+ * Apply with CSS, it can be used to render tabs and spaces visually.
  */
-declare function transformerNotationErrorLevel(options?: TransformerNotationErrorLevelOptions): ShikiTransformer;
+declare function transformerRenderWhitespace(options?: TransformerRenderWhitespaceOptions): ShikiTransformer;
 
 declare function parseMetaHighlightString(meta: string): number[] | null;
 interface TransformerMetaHighlightOptions {
@@ -152,6 +138,20 @@ interface TransformerMetaHighlightOptions {
  */
 declare function transformerMetaHighlight(options?: TransformerMetaHighlightOptions): ShikiTransformer;
 
+declare function parseMetaHighlightWords(meta: string): string[];
+interface TransformerMetaWordHighlightOptions {
+    /**
+     * Class for highlighted words
+     *
+     * @default 'highlighted-word'
+     */
+    className?: string;
+}
+/**
+ * Allow using `/word/` in the code snippet meta to mark highlighted words.
+ */
+declare function transformerMetaWordHighlight(options?: TransformerMetaWordHighlightOptions): ShikiTransformer;
+
 declare function createCommentNotationTransformer(name: string, regex: RegExp, onMatch: (this: ShikiTransformerContext, match: string[], line: Element, commentNode: Element, lines: Element[], index: number) => boolean, removeEmptyLines?: boolean): ShikiTransformer;
 
 export { type TransformerCompactLineOption, type TransformerMetaHighlightOptions, type TransformerMetaWordHighlightOptions, type TransformerNotationDiffOptions, type TransformerNotationErrorLevelOptions, type TransformerNotationFocusOptions, type TransformerNotationHighlightOptions, type TransformerNotationWordHighlightOptions, type TransformerRenderWhitespaceOptions, createCommentNotationTransformer, parseMetaHighlightString, parseMetaHighlightWords, transformerCompactLineOptions, transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationWordHighlight, transformerRemoveLineBreak, transformerRemoveNotationEscape, transformerRenderWhitespace };

package/dist/index.mjs

@@ -1,134 +1,3 @@
-function separateContinuousSpaces(inputs) {
-  const result = [];
-  let current = "";
-  function bump() {
-    if (current.length)
-      result.push(current);
-    current = "";
-  }
-  inputs.forEach((part, idx) => {
-    if (isTab(part)) {
-      bump();
-      result.push(part);
-    } else if (isSpace(part) && (isSpace(inputs[idx - 1]) || isSpace(inputs[idx + 1]))) {
-      bump();
-      result.push(part);
-    } else {
-      current += part;
-    }
-  });
-  bump();
-  return result;
-}
-function isTab(part) {
-  return part === "	";
-}
-function isSpace(part) {
-  return part === " " || part === "	";
-}
-function splitSpaces(parts, type, renderContinuousSpaces = true) {
-  if (type === "all")
-    return parts;
-  let leftCount = 0;
-  let rightCount = 0;
-  if (type === "boundary") {
-    for (let i = 0; i < parts.length; i++) {
-      if (isSpace(parts[i]))
-        leftCount++;
-      else
-        break;
-    }
-  }
-  if (type === "boundary" || type === "trailing") {
-    for (let i = parts.length - 1; i >= 0; i--) {
-      if (isSpace(parts[i]))
-        rightCount++;
-      else
-        break;
-    }
-  }
-  const middle = parts.slice(leftCount, parts.length - rightCount);
-  return [
-    ...parts.slice(0, leftCount),
-    ...renderContinuousSpaces ? separateContinuousSpaces(middle) : [middle.join("")],
-    ...parts.slice(parts.length - rightCount)
-  ];
-}
-
-function transformerRenderWhitespace(options = {}) {
-  const classMap = {
-    " ": options.classSpace ?? "space",
-    "	": options.classTab ?? "tab"
-  };
-  const position = options.position ?? "all";
-  const keys = Object.keys(classMap);
-  return {
-    name: "@shikijs/transformers:render-whitespace",
-    // We use `root` hook here to ensure it runs after all other transformers
-    root(root) {
-      const pre = root.children[0];
-      const code = pre.children[0];
-      code.children.forEach(
-        (line) => {
-          if (line.type !== "element")
-            return;
-          const elements = line.children.filter((token) => token.type === "element");
-          const last = elements.length - 1;
-          line.children = line.children.flatMap((token) => {
-            if (token.type !== "element")
-              return token;
-            const index = elements.indexOf(token);
-            if (position === "boundary" && index !== 0 && index !== last)
-              return token;
-            if (position === "trailing" && index !== last)
-              return token;
-            const node = token.children[0];
-            if (node.type !== "text" || !node.value)
-              return token;
-            const parts = splitSpaces(
-              node.value.split(/([ \t])/).filter((i) => i.length),
-              position === "boundary" && index === last && last !== 0 ? "trailing" : position,
-              position !== "trailing"
-            );
-            if (parts.length <= 1)
-              return token;
-            return parts.map((part) => {
-              const clone = {
-                ...token,
-                properties: { ...token.properties }
-              };
-              clone.children = [{ type: "text", value: part }];
-              if (keys.includes(part)) {
-                this.addClassToHast(clone, classMap[part]);
-                delete clone.properties.style;
-              }
-              return clone;
-            });
-          });
-        }
-      );
-    }
-  };
-}
-
-function transformerRemoveLineBreak() {
-  return {
-    name: "@shikijs/transformers:remove-line-break",
-    code(code) {
-      code.children = code.children.filter((line) => !(line.type === "text" && line.value === "\n"));
-    }
-  };
-}
-
-function transformerRemoveNotationEscape() {
-  return {
-    name: "@shikijs/transformers:remove-notation-escape",
-    postprocess(code) {
-      return code.replace(/\[\\!code/g, "[!code");
-    }
-  };
-}
-
 function transformerCompactLineOptions(lineOptions = []) {
   return {
     name: "@shikijs/transformers:compact-line-options",
@@ -207,6 +76,41 @@ function transformerNotationMap(options = {}, name = "@shikijs/transformers:nota
   );
 }
 
+function transformerNotationDiff(options = {}) {
+  const {
+    classLineAdd = "diff add",
+    classLineRemove = "diff remove",
+    classActivePre = "has-diff"
+  } = options;
+  return transformerNotationMap(
+    {
+      classMap: {
+        "++": classLineAdd,
+        "--": classLineRemove
+      },
+      classActivePre
+    },
+    "@shikijs/transformers:notation-diff"
+  );
+}
+
+function transformerNotationErrorLevel(options = {}) {
+  const {
+    classMap = {
+      error: ["highlighted", "error"],
+      warning: ["highlighted", "warning"]
+    },
+    classActivePre = "has-highlighted"
+  } = options;
+  return transformerNotationMap(
+    {
+      classMap,
+      classActivePre
+    },
+    "@shikijs/transformers:notation-error-level"
+  );
+}
+
 function transformerNotationFocus(options = {}) {
   const {
     classActiveLine = "focused",
@@ -329,79 +233,135 @@ function transformerNotationWordHighlight(options = {}) {
   );
 }
 
-function parseMetaHighlightWords(meta) {
-  if (!meta)
-    return [];
-  const match = Array.from(meta.matchAll(/\/((?:\\.|[^/])+)\//g));
-  return match.map((v) => v[1].replace(/\\(.)/g, "$1"));
-}
-function transformerMetaWordHighlight(options = {}) {
-  const {
-    className = "highlighted-word"
-  } = options;
+function transformerRemoveLineBreak() {
   return {
-    name: "@shikijs/transformers:meta-word-highlight",
-    preprocess(code, options2) {
-      if (!this.options.meta?.__raw)
-        return;
-      const words = parseMetaHighlightWords(this.options.meta.__raw);
-      options2.decorations || (options2.decorations = []);
-      for (const word of words) {
-        const indexes = findAllSubstringIndexes(code, word);
-        for (const index of indexes) {
-          options2.decorations.push({
-            start: index,
-            end: index + word.length,
-            properties: {
-              class: className
-            }
-          });
-        }
-      }
+    name: "@shikijs/transformers:remove-line-break",
+    code(code) {
+      code.children = code.children.filter((line) => !(line.type === "text" && line.value === "\n"));
     }
   };
 }
-function findAllSubstringIndexes(str, substr) {
-  const indexes = [];
-  let i = -1;
-  while ((i = str.indexOf(substr, i + 1)) !== -1)
-    indexes.push(i);
-  return indexes;
+
+function transformerRemoveNotationEscape() {
+  return {
+    name: "@shikijs/transformers:remove-notation-escape",
+    postprocess(code) {
+      return code.replace(/\[\\!code/g, "[!code");
+    }
+  };
 }
 
-function transformerNotationDiff(options = {}) {
-  const {
-    classLineAdd = "diff add",
-    classLineRemove = "diff remove",
-    classActivePre = "has-diff"
-  } = options;
-  return transformerNotationMap(
-    {
-      classMap: {
-        "++": classLineAdd,
-        "--": classLineRemove
-      },
-      classActivePre
-    },
-    "@shikijs/transformers:notation-diff"
-  );
+function separateContinuousSpaces(inputs) {
+  const result = [];
+  let current = "";
+  function bump() {
+    if (current.length)
+      result.push(current);
+    current = "";
+  }
+  inputs.forEach((part, idx) => {
+    if (isTab(part)) {
+      bump();
+      result.push(part);
+    } else if (isSpace(part) && (isSpace(inputs[idx - 1]) || isSpace(inputs[idx + 1]))) {
+      bump();
+      result.push(part);
+    } else {
+      current += part;
+    }
+  });
+  bump();
+  return result;
+}
+function isTab(part) {
+  return part === "	";
+}
+function isSpace(part) {
+  return part === " " || part === "	";
+}
+function splitSpaces(parts, type, renderContinuousSpaces = true) {
+  if (type === "all")
+    return parts;
+  let leftCount = 0;
+  let rightCount = 0;
+  if (type === "boundary") {
+    for (let i = 0; i < parts.length; i++) {
+      if (isSpace(parts[i]))
+        leftCount++;
+      else
+        break;
+    }
+  }
+  if (type === "boundary" || type === "trailing") {
+    for (let i = parts.length - 1; i >= 0; i--) {
+      if (isSpace(parts[i]))
+        rightCount++;
+      else
+        break;
+    }
+  }
+  const middle = parts.slice(leftCount, parts.length - rightCount);
+  return [
+    ...parts.slice(0, leftCount),
+    ...renderContinuousSpaces ? separateContinuousSpaces(middle) : [middle.join("")],
+    ...parts.slice(parts.length - rightCount)
+  ];
 }
 
-function transformerNotationErrorLevel(options = {}) {
-  const {
-    classMap = {
-      error: ["highlighted", "error"],
-      warning: ["highlighted", "warning"]
-    },
-    classActivePre = "has-highlighted"
-  } = options;
-  return transformerNotationMap(
-    {
-      classMap,
-      classActivePre
-    },
-    "@shikijs/transformers:notation-error-level"
-  );
+function transformerRenderWhitespace(options = {}) {
+  const classMap = {
+    " ": options.classSpace ?? "space",
+    "	": options.classTab ?? "tab"
+  };
+  const position = options.position ?? "all";
+  const keys = Object.keys(classMap);
+  return {
+    name: "@shikijs/transformers:render-whitespace",
+    // We use `root` hook here to ensure it runs after all other transformers
+    root(root) {
+      const pre = root.children[0];
+      const code = pre.children[0];
+      code.children.forEach(
+        (line) => {
+          if (line.type !== "element")
+            return;
+          const elements = line.children.filter((token) => token.type === "element");
+          const last = elements.length - 1;
+          line.children = line.children.flatMap((token) => {
+            if (token.type !== "element")
+              return token;
+            const index = elements.indexOf(token);
+            if (position === "boundary" && index !== 0 && index !== last)
+              return token;
+            if (position === "trailing" && index !== last)
+              return token;
+            const node = token.children[0];
+            if (node.type !== "text" || !node.value)
+              return token;
+            const parts = splitSpaces(
+              node.value.split(/([ \t])/).filter((i) => i.length),
+              position === "boundary" && index === last && last !== 0 ? "trailing" : position,
+              position !== "trailing"
+            );
+            if (parts.length <= 1)
+              return token;
+            return parts.map((part) => {
+              const clone = {
+                ...token,
+                properties: { ...token.properties }
+              };
+              clone.children = [{ type: "text", value: part }];
+              if (keys.includes(part)) {
+                this.addClassToHast(clone, classMap[part]);
+                delete clone.properties.style;
+              }
+              return clone;
+            });
+          });
+        }
+      );
+    }
+  };
 }
 
 function parseMetaHighlightString(meta) {
@@ -440,4 +400,44 @@ function transformerMetaHighlight(options = {}) {
   };
 }
 
+function parseMetaHighlightWords(meta) {
+  if (!meta)
+    return [];
+  const match = Array.from(meta.matchAll(/\/((?:\\.|[^/])+)\//g));
+  return match.map((v) => v[1].replace(/\\(.)/g, "$1"));
+}
+function transformerMetaWordHighlight(options = {}) {
+  const {
+    className = "highlighted-word"
+  } = options;
+  return {
+    name: "@shikijs/transformers:meta-word-highlight",
+    preprocess(code, options2) {
+      if (!this.options.meta?.__raw)
+        return;
+      const words = parseMetaHighlightWords(this.options.meta.__raw);
+      options2.decorations || (options2.decorations = []);
+      for (const word of words) {
+        const indexes = findAllSubstringIndexes(code, word);
+        for (const index of indexes) {
+          options2.decorations.push({
+            start: index,
+            end: index + word.length,
+            properties: {
+              class: className
+            }
+          });
+        }
+      }
+    }
+  };
+}
+function findAllSubstringIndexes(str, substr) {
+  const indexes = [];
+  let i = -1;
+  while ((i = str.indexOf(substr, i + 1)) !== -1)
+    indexes.push(i);
+  return indexes;
+}
+
 export { createCommentNotationTransformer, parseMetaHighlightString, parseMetaHighlightWords, transformerCompactLineOptions, transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationWordHighlight, transformerRemoveLineBreak, transformerRemoveNotationEscape, transformerRenderWhitespace };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shikijs/transformers",
   "type": "module",
-  "version": "1.16.2",
+  "version": "1.17.0",
   "description": "Collective of common transformers transformers for Shiki",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "dist"
   ],
   "dependencies": {
-    "shiki": "1.16.2"
+    "shiki": "1.17.0"
   },
   "scripts": {
     "build": "unbuild",