@shikijs/transformers 3.18.0 → 3.20.0

package/dist/index.d.mts

@@ -74,6 +74,10 @@ interface TransformerNotationDiffOptions extends MatchAlgorithmOptions {
      * Class added to the <pre> element when the current code has diff
      */
     classActivePre?: string;
+    /**
+     * Class added to the <code> element when the current code has diff
+     */
+    classActiveCode?: string;
 }
 /**
  * Use `[!code ++]` and `[!code --]` to mark added and removed lines.
@@ -86,6 +90,10 @@ interface TransformerNotationErrorLevelOptions extends MatchAlgorithmOptions {
      * Class added to the <pre> element when the current code has diff
      */
     classActivePre?: string;
+    /**
+     * Class added to the <code> element when the current code has diff
+     */
+    classActiveCode?: string;
 }
 /**
  * Allow using `[!code error]` `[!code warning]` notation in code to mark highlighted lines.
@@ -101,6 +109,10 @@ interface TransformerNotationFocusOptions extends MatchAlgorithmOptions {
      * Class added to the root element when the code has focused lines
      */
     classActivePre?: string;
+    /**
+     * Class added to the <code> element when the code has focused lines
+     */
+    classActiveCode?: string;
 }
 /**
  * Allow using `[!code focus]` notation in code to mark focused lines.
@@ -116,6 +128,10 @@ interface TransformerNotationHighlightOptions extends MatchAlgorithmOptions {
      * Class added to the root element when the code has highlighted lines
      */
     classActivePre?: string;
+    /**
+     * Class added to the <code> element when the code has highlighted lines
+     */
+    classActiveCode?: string;
 }
 /**
  * Allow using `[!code highlight]` notation in code to mark highlighted lines.
@@ -140,9 +156,25 @@ interface TransformerNotationMapOptions extends MatchAlgorithmOptions {
      * Class added to the <pre> element when the current code has diff
      */
     classActivePre?: string;
+    /**
+     * Class added to the <code> element when the current code has diff
+     */
+    classActiveCode?: string;
 }
 declare function transformerNotationMap(options?: TransformerNotationMapOptions, name?: string): ShikiTransformer$1;
 
+interface TransformerRemoveCommentsOptions {
+    /**
+     * Remove lines that become empty after removing comments.
+     * @default true
+     */
+    removeEmptyLines?: boolean;
+}
+/**
+ * Remove comments from the code.
+ */
+declare function transformerRemoveComments(options?: TransformerRemoveCommentsOptions): ShikiTransformer$1;
+
 /**
  * Remove line breaks between lines.
  * Useful when you override `display: block` to `.line` in CSS.
@@ -218,5 +250,5 @@ interface ShikiTransformerStyleToClass extends ShikiTransformer$1 {
  */
 declare function transformerStyleToClass(options?: TransformerStyleToClassOptions): ShikiTransformerStyleToClass;
 
-export { createCommentNotationTransformer, findAllSubstringIndexes, parseMetaHighlightString, parseMetaHighlightWords, transformerCompactLineOptions, transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationMap, transformerNotationWordHighlight, transformerRemoveLineBreak, transformerRemoveNotationEscape, transformerRenderIndentGuides, transformerRenderWhitespace, transformerStyleToClass };
-export type { ShikiTransformerStyleToClass, TransformerCompactLineOption, TransformerMetaHighlightOptions, TransformerMetaWordHighlightOptions, TransformerNotationDiffOptions, TransformerNotationErrorLevelOptions, TransformerNotationFocusOptions, TransformerNotationHighlightOptions, TransformerNotationMapOptions, TransformerNotationWordHighlightOptions, TransformerRenderIndentGuidesOptions, TransformerRenderWhitespaceOptions, TransformerStyleToClassOptions };
+export { createCommentNotationTransformer, findAllSubstringIndexes, parseMetaHighlightString, parseMetaHighlightWords, transformerCompactLineOptions, transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationMap, transformerNotationWordHighlight, transformerRemoveComments, transformerRemoveLineBreak, transformerRemoveNotationEscape, transformerRenderIndentGuides, transformerRenderWhitespace, transformerStyleToClass };
+export type { ShikiTransformerStyleToClass, TransformerCompactLineOption, TransformerMetaHighlightOptions, TransformerMetaWordHighlightOptions, TransformerNotationDiffOptions, TransformerNotationErrorLevelOptions, TransformerNotationFocusOptions, TransformerNotationHighlightOptions, TransformerNotationMapOptions, TransformerNotationWordHighlightOptions, TransformerRemoveCommentsOptions, TransformerRenderIndentGuidesOptions, TransformerRenderWhitespaceOptions, TransformerStyleToClassOptions };

package/dist/index.mjs

@@ -318,7 +318,8 @@ function escapeRegExp(str) {
 function transformerNotationMap(options = {}, name = "@shikijs/transformers:notation-map") {
   const {
     classMap = {},
-    classActivePre = void 0
+    classActivePre = void 0,
+    classActiveCode = void 0
   } = options;
   return createCommentNotationTransformer(
     name,
@@ -330,6 +331,8 @@ function transformerNotationMap(options = {}, name = "@shikijs/transformers:nota
       }
       if (classActivePre)
         this.addClassToHast(this.pre, classActivePre);
+      if (classActiveCode)
+        this.addClassToHast(this.code, classActiveCode);
       return true;
     },
     options.matchAlgorithm
@@ -340,7 +343,8 @@ function transformerNotationDiff(options = {}) {
   const {
     classLineAdd = "diff add",
     classLineRemove = "diff remove",
-    classActivePre = "has-diff"
+    classActivePre = "has-diff",
+    classActiveCode
   } = options;
   return transformerNotationMap(
     {
@@ -349,6 +353,7 @@ function transformerNotationDiff(options = {}) {
         "--": classLineRemove
       },
       classActivePre,
+      classActiveCode,
       matchAlgorithm: options.matchAlgorithm
     },
     "@shikijs/transformers:notation-diff"
@@ -361,12 +366,14 @@ function transformerNotationErrorLevel(options = {}) {
       error: ["highlighted", "error"],
       warning: ["highlighted", "warning"]
     },
-    classActivePre = "has-highlighted"
+    classActivePre = "has-highlighted",
+    classActiveCode
   } = options;
   return transformerNotationMap(
     {
       classMap,
       classActivePre,
+      classActiveCode,
       matchAlgorithm: options.matchAlgorithm
     },
     "@shikijs/transformers:notation-error-level"
@@ -376,7 +383,8 @@ function transformerNotationErrorLevel(options = {}) {
 function transformerNotationFocus(options = {}) {
   const {
     classActiveLine = "focused",
-    classActivePre = "has-focused"
+    classActivePre = "has-focused",
+    classActiveCode
   } = options;
   return transformerNotationMap(
     {
@@ -384,6 +392,7 @@ function transformerNotationFocus(options = {}) {
         focus: classActiveLine
       },
       classActivePre,
+      classActiveCode,
       matchAlgorithm: options.matchAlgorithm
     },
     "@shikijs/transformers:notation-focus"
@@ -393,7 +402,8 @@ function transformerNotationFocus(options = {}) {
 function transformerNotationHighlight(options = {}) {
   const {
     classActiveLine = "highlighted",
-    classActivePre = "has-highlighted"
+    classActivePre = "has-highlighted",
+    classActiveCode
   } = options;
   return transformerNotationMap(
     {
@@ -402,6 +412,7 @@ function transformerNotationHighlight(options = {}) {
         hl: classActiveLine
       },
       classActivePre,
+      classActiveCode,
       matchAlgorithm: options.matchAlgorithm
     },
     "@shikijs/transformers:notation-highlight"
@@ -497,6 +508,41 @@ function transformerNotationWordHighlight(options = {}) {
   );
 }
 
+function transformerRemoveComments(options = {}) {
+  const { removeEmptyLines = true } = options;
+  return {
+    name: "@shikijs/transformers:remove-comments",
+    preprocess(_code, options2) {
+      if (options2.includeExplanation !== true && options2.includeExplanation !== "scopeName")
+        throw new Error("`transformerRemoveComments` requires `includeExplanation` to be set to `true` or `'scopeName'`");
+    },
+    tokens(tokens) {
+      const result = [];
+      for (const line of tokens) {
+        const filteredLine = [];
+        let hasComment = false;
+        for (const token of line) {
+          const isComment = token.explanation?.some(
+            (exp) => exp.scopes.some((s) => s.scopeName.startsWith("comment"))
+          );
+          if (isComment) {
+            hasComment = true;
+          } else {
+            filteredLine.push(token);
+          }
+        }
+        if (removeEmptyLines && hasComment) {
+          const isAllWhitespace = filteredLine.every((token) => !token.content.trim());
+          if (isAllWhitespace)
+            continue;
+        }
+        result.push(filteredLine);
+      }
+      return result;
+    }
+  };
+}
+
 function transformerRemoveLineBreak() {
   return {
     name: "@shikijs/transformers:remove-line-break",
@@ -779,4 +825,4 @@ function cyrb53(str, seed = 0) {
   return (4294967296 * (2097151 & h2) + (h1 >>> 0)).toString(36).slice(0, 6);
 }
 
-export { createCommentNotationTransformer, findAllSubstringIndexes, parseMetaHighlightString, parseMetaHighlightWords, transformerCompactLineOptions, transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationMap, transformerNotationWordHighlight, transformerRemoveLineBreak, transformerRemoveNotationEscape, transformerRenderIndentGuides, transformerRenderWhitespace, transformerStyleToClass };
+export { createCommentNotationTransformer, findAllSubstringIndexes, parseMetaHighlightString, parseMetaHighlightWords, transformerCompactLineOptions, transformerMetaHighlight, transformerMetaWordHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationFocus, transformerNotationHighlight, transformerNotationMap, transformerNotationWordHighlight, transformerRemoveComments, transformerRemoveLineBreak, transformerRemoveNotationEscape, transformerRenderIndentGuides, transformerRenderWhitespace, transformerStyleToClass };

package/package.json

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