@tony.ganchev/eslint-plugin-header 3.4.1 → 3.4.2

package/README.md

@@ -7,8 +7,8 @@
 The native ESLint 9/10 standard header-validating plugin. A zero-bloat, drop-in
 replacement for [eslint-plugin-header](https://github.com/Stuk/eslint-plugin-header)
 with first-class Flat Config & TypeScript support. Auto-fix copyright, license,
-and banner comments in JavaScript, TypeScript, Vue, CSS, HTML, and Markdown files.
-Supports _oxlint_.
+and banner comments in JavaScript, TypeScript, Vue, Svelte, CSS, HTML, and
+Markdown files. Supports _oxlint_.
 
 ## Table of Contents
 
@@ -31,7 +31,8 @@ Supports _oxlint_.
    5. [Linting CSS](#linting-css)
    6. [Linting HTML](#linting-html)
    7. [Linting Vue](#linting-vue)
-   8. [Linting Markdown](#linting-markdown)
+   8. [Linting Svelte](#linting-svelte)
+   9. [Linting Markdown](#linting-markdown)
 5. [Comparison to Alternatives](#comparison-to-alternatives)
    1. [Compared to eslint-plugin-headers](#compared-to-eslint-plugin-headers)
       1. [Health Scans](#health-scans)
@@ -133,9 +134,9 @@ statements. Smoke tests cover this support as well.
 ### Languages
 
 Currently the plugin supports linting copyright headers in JavaScript,
-TypeScript and their JSX / TSX flavors; Vue, CSS, HTML, and Markdown files. As
-mentioned in the previous sections, not all languages are supported for oxlint
-or ESLint older than 9. Refer to the table below for more details.
+TypeScript and their JSX / TSX flavors; Vue, Svelte, CSS, HTML, and Markdown
+files. As mentioned in the previous sections, not all languages are supported
+for oxlint or ESLint older than 9. Refer to the table below for more details.
 
 | Language   | ESLint 7 / 8  | ESLint 9 / 10 | oxlint |
 |------------|---------------|---------------|--------|
@@ -144,6 +145,7 @@ or ESLint older than 9. Refer to the table below for more details.
 | JSX        | ✅ Yes        | ✅ Yes        | ✅ Yes |
 | TSX        | ✅ Yes        | ✅ Yes        | ✅ Yes |
 | Vue        | ✅ Yes        | ✅ Yes        | ❌ No  |
+| Svelte     | ✅ Yes        | ✅ Yes        | ❌ No  |
 | CSS        | ❌ No         | ✅ Yes        | ❌ No  |
 | HTML       | ❌ No         | ✅ Yes        | ❌ No  |
 | Markdown   | ❌ No         | ✅ Yes        | ❌ No  |
@@ -1379,6 +1381,55 @@ export default [
 As with HTML and CSS, only block comments are supported at the top of the file -
 no line- or shebang comments.
 
+### Linting Svelte
+
+The rule supports linting copyright notices in Svelte files. The rule works with
+the _eslint-plugin-svelte_ plugin and its parser.
+
+To turn on header validation for Svelte files, configure the parser and the rule:
+
+```ts
+import header from "@tony.ganchev/eslint-plugin-header";
+import svelteParser from "svelte-eslint-parser";
+import sveltePlugin from "eslint-plugin-svelte";
+
+export default [
+    {
+        files: ["**/*.svelte"],
+        plugins: {
+            "@tony.ganchev": header,
+            svelte: sveltePlugin
+        },
+        languageOptions: {
+            parser: svelteParser
+        },
+        rules: {
+            "@tony.ganchev/header": [
+                "error",
+                {
+                    header: {
+                        commentType: "block",
+                        lines: [" Copyright 2025 "]
+                    }
+                }
+            ]
+        }
+    }
+];
+```
+
+```svelte
+<!-- Copyright 2025 -->
+<script>
+    let name = 'world';
+</script>
+
+<h1>Hello {name}!</h1>
+```
+
+As with Vue, HTML and CSS, only block comments are supported at the top of the
+file - no line- or shebang comments.
+
 ### Linting Markdown
 
 The rule supports copyright comments in Markdown syntax in both _commonmark_ and

package/lib/comment-parser.js

@@ -37,10 +37,8 @@ const assert = require("node:assert");
  * This is a really simple and dumb parser, that looks just for a
  * single kind of comment. It won't detect multiple block comments.
  * @param {string} commentText Content to parse.
- * @param {Language} language The language
- * configuration.
- * @returns {[CommentType, string[]]} Comment type and
- * content.
+ * @param {Language} language The language configuration.
+ * @returns {[CommentType, string[]]} Comment type and content.
  * @throws {Error} If `commentText` starts with an unrecognized comment token.
  */
 module.exports = function commentParser(commentText, language) {

package/lib/rules/header.js

@@ -1205,16 +1205,46 @@ const headerRule = {
             }
         };
 
+        /**
+         * Tests if the source code was parsed by _@html-eslint/eslint-plugin_'s
+         * parser.
+         * @returns {boolean} `true` if the source code is parsed by the parser.
+         */
+        function isHtmlParser() {
+            return sourceCode.constructor.name === "HTMLSourceCode";
+        }
+
+        /**
+         * Tests if the source code was parsed by _vue-eslint-parser_.
+         * @returns {boolean} `true` if the source code is parsed by the parser.
+         */
+        function isVueParser() {
+            // Vue parser mimic JS parser identity but has a
+            // template section under its AST.
+            return "templateBody" in sourceCode.ast;
+        }
+
+        /**
+         * Tests if the source code was parsed by _svelte-eslint-parser_.
+         * @returns {boolean} `true` if the source code is parsed by the parser.
+         */
+        function isSvelteParser() {
+            // Svelte parser mimic JS parser identity but has an
+            // identifier in its `parserServices` section.
+            return sourceCode.parserServices.isSvelte;
+        }
+
+        /**
+         * Tests if the source code is parsed by a HTML-style language parser.
+         * @returns {boolean} `true` if the source code is parsed by a
+         * HTML-style language parser.
+         */
+        function isHtmlStyleLanguage() {
+            return isHtmlParser() || isVueParser() || isSvelteParser();
+        };
+
         const hooks = {
-            Program: () =>
-                onRootNode(
-                    (sourceCode.constructor.name === "HTMLSourceCode"
-                        // Vue parser mimics JS parser identity but has a
-                        // template section.
-                        || "templateBody" in sourceCode.ast)
-                        ? htmlStyleLanguage
-                        : jsStyleLanguage
-                ),
+            Program: () => onRootNode(isHtmlStyleLanguage() ? htmlStyleLanguage : jsStyleLanguage),
             StyleSheet: () => onRootNode(cssStyleLanguage),
             // eslint/markdown
             root: () => onRootNode(htmlStyleLanguage),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tony.ganchev/eslint-plugin-header",
-  "version": "3.4.1",
-  "description": "The native ESLint 9/10 header plugin. A zero-bloat, drop-in replacement for 'eslint-plugin-header' with first-class Flat Config & TypeScript support. Auto-fix Copyright, License, and banner comments in JavaScript, TypeScript, Vue, CSS, HTML, and Markdown files. Supports oxlint.",
+  "version": "3.4.2",
+  "description": "The native ESLint 9/10 header plugin. A zero-bloat, drop-in replacement for 'eslint-plugin-header' with first-class Flat Config & TypeScript support. Auto-fix Copyright, License, and banner comments in JavaScript, TypeScript, Vue, Svelte, CSS, HTML, and Markdown files. Supports oxlint.",
   "main": "index.js",
   "types": "index.d.ts",
   "exports": {
@@ -32,10 +32,12 @@
     "eslint-plugin-eslint-plugin": "^7.3.2",
     "eslint-plugin-jsdoc": "^62.9.0",
     "eslint-plugin-n": "^17.24.0",
+    "eslint-plugin-svelte": "^3.17.0",
     "eslint-plugin-vue": "^10.8.0",
     "globals": "^17.4.0",
     "markdownlint-cli": "^0.48.0",
     "mocha": "12.0.0-beta-10",
+    "svelte-eslint-parser": "^1.6.0",
     "testdouble": "^3.20.2",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.58.0",
@@ -76,6 +78,9 @@
     "oxc",
     "react",
     "source-header",
+    "svelte",
+    "sveltejs",
+    "svelte-js",
     "typescript",
     "vue",
     "vuejs",

package/types/lib/comment-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comment-parser.d.ts","sourceRoot":"","sources":["../../lib/comment-parser.js"],"names":[],"mappings":"AA6CiB,uCAPN,MAAM,YACN,QAAQ,GAEN,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CA4BnC;;8BAxCyC,gBAAgB;iCAAhB,gBAAgB"}
+{"version":3,"file":"comment-parser.d.ts","sourceRoot":"","sources":["../../lib/comment-parser.js"],"names":[],"mappings":"AA2CiB,uCALN,MAAM,YACN,QAAQ,GACN,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CA2BnC;;8BAtCyC,gBAAgB;iCAAhB,gBAAgB"}

package/types/lib/rules/header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../lib/rules/header.js"],"names":[],"mappings":"2BAsCa,iBAAiB;0BACjB,gBAAgB;wBAChB,cAAc;0BACd,gBAAgB;;;;;yBAIhB,IAAI,GAAG,MAAM;;;;;;;;;;aAOZ,MAAM,GAAG,MAAM;;;;;;;;;;;;yBAOhB,MAAM,GAAG,MAAM,GAAG,iBAAiB;;;;;0BAGnC,UAAU,GAAG,UAAU,EAAE;;;;;;+BAEzB,IAAI,GAAG,MAAM,GAAG,SAAS;;;;;6BAGzB;IAAE,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAAE;;;;;0BAElC,OAAO,GAAG,MAAM;;;;;;;;;;UAOf,MAAM;;;;;;;;;;;;;;;iBASN,WAAW;;;;;;WACX,UAAU,EAAE;;;;;;;;;;;;cAQZ,CAAC,eAAe,GAAG,YAAY,CAAC,EAAE;;;;;;;;;;;;;;;;;;YAclC,eAAe,GAAG,YAAY;;;;;;;;;;;;;;;;;4BAU/B,4BAA4B,GAAG,cAAc;oCAK7C,CAAC,QAAQ,EAAE,MAAM,CAAC;4CAClB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC;iCAE5C,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC;yCACvC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC;yCAEjE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC;iDAEzD,CACV,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,CACvB;;;;+BACS,CAAC,aAAa,CAAC,GACvB,qBAAqB,GACrB,6BAA6B,GAC7B,kBAAkB,GAClB,0BAA0B,GAC1B,0BAA0B,GAC1B,kCAAkC;;;;;+BAK1B,iBAAiB,gBAAgB,CAAC;oBAiClC,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;UAKf,SAAS,GAAG,OAAO,GAAG,MAAM;;;;WAC5B,MAAM;;;;WACN,KAAK;;;;SACL,cAAc;;;;;;;oBAKd,MAAM;;;;;kBAEN,MAAM;;;;;;;oBAMN,MAAM;;;;;;;kBAML,YAAY;;;;;;;;;;;;AAmwB3B,8BAA8B;AAC9B,0BADW,eAAe,CAoPxB;AAloBF,2EAA2E;AAC3E,+BADW,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAC3C;0BAniBkC,QAAQ;4BAAR,QAAQ;oCAC1B,QAAQ"}
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../lib/rules/header.js"],"names":[],"mappings":"2BAsCa,iBAAiB;0BACjB,gBAAgB;wBAChB,cAAc;0BACd,gBAAgB;;;;;yBAIhB,IAAI,GAAG,MAAM;;;;;;;;;;aAOZ,MAAM,GAAG,MAAM;;;;;;;;;;;;yBAOhB,MAAM,GAAG,MAAM,GAAG,iBAAiB;;;;;0BAGnC,UAAU,GAAG,UAAU,EAAE;;;;;;+BAEzB,IAAI,GAAG,MAAM,GAAG,SAAS;;;;;6BAGzB;IAAE,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAAE;;;;;0BAElC,OAAO,GAAG,MAAM;;;;;;;;;;UAOf,MAAM;;;;;;;;;;;;;;;iBASN,WAAW;;;;;;WACX,UAAU,EAAE;;;;;;;;;;;;cAQZ,CAAC,eAAe,GAAG,YAAY,CAAC,EAAE;;;;;;;;;;;;;;;;;;YAclC,eAAe,GAAG,YAAY;;;;;;;;;;;;;;;;;4BAU/B,4BAA4B,GAAG,cAAc;oCAK7C,CAAC,QAAQ,EAAE,MAAM,CAAC;4CAClB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC;iCAE5C,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC;yCACvC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC;yCAEjE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC;iDAEzD,CACV,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,CACvB;;;;+BACS,CAAC,aAAa,CAAC,GACvB,qBAAqB,GACrB,6BAA6B,GAC7B,kBAAkB,GAClB,0BAA0B,GAC1B,0BAA0B,GAC1B,kCAAkC;;;;;+BAK1B,iBAAiB,gBAAgB,CAAC;oBAiClC,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;UAKf,SAAS,GAAG,OAAO,GAAG,MAAM;;;;WAC5B,MAAM;;;;WACN,KAAK;;;;SACL,cAAc;;;;;;;oBAKd,MAAM;;;;;kBAEN,MAAM;;;;;;;oBAMN,MAAM;;;;;;;kBAML,YAAY;;;;;;;;;;;;AAmwB3B,8BAA8B;AAC9B,0BADW,eAAe,CAkRxB;AAhqBF,2EAA2E;AAC3E,+BADW,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAC3C;0BAniBkC,QAAQ;4BAAR,QAAQ;oCAC1B,QAAQ"}