@css-modules-kit/stylelint-plugin 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 mizdra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# `@css-modules-kit/stylelint-plugin`
+
+A stylelint plugin for CSS Modules
+
+## Installation
+
+```bash
+npm i -D @css-modules-kit/stylelint-plugin
+```
+
+## Usage
+
+```js
+// stylelint.config.js
+/** @type {import('stylelint').Config} */
+export default {
+  plugins: ['@css-modules-kit/stylelint-plugin'],
+  rules: {
+    'css-modules-kit/no-unused-class-names': true,
+    'css-modules-kit/no-missing-component-file': true,
+  },
+};
+```
+
+## Rules
+
+- `css-modules-kit/no-unused-class-names`
+- `css-modules-kit/no-missing-component-file`

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("stylelint").Plugin[];
+export = _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAGA,kBAAsD"}

package/dist/index.js

@@ -0,0 +1,5 @@
+"use strict";
+const no_missing_component_file_js_1 = require("./rules/no-missing-component-file.js");
+const no_unused_class_names_js_1 = require("./rules/no-unused-class-names.js");
+module.exports = [no_unused_class_names_js_1.noUnusedClassNames, no_missing_component_file_js_1.noMissingComponentFile];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,uFAA8E;AAC9E,+EAAsE;AAEtE,iBAAS,CAAC,6CAAkB,EAAE,qDAAsB,CAAC,CAAC"}

package/dist/rules/no-missing-component-file.d.ts

@@ -0,0 +1,3 @@
+import stylelint from 'stylelint';
+export declare const noMissingComponentFile: stylelint.Plugin;
+//# sourceMappingURL=no-missing-component-file.d.ts.map

package/dist/rules/no-missing-component-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-missing-component-file.d.ts","sourceRoot":"","sources":["../../src/rules/no-missing-component-file.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,WAAW,CAAC;AAwClC,eAAO,MAAM,sBAAsB,kBAAuC,CAAC"}

package/dist/rules/no-missing-component-file.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noMissingComponentFile = void 0;
+const core_1 = require("@css-modules-kit/core");
+const stylelint_1 = __importDefault(require("stylelint"));
+const util_js_1 = require("../util.js");
+// TODO: Report cjs-module-lexer compatibility problem to stylelint
+const { createPlugin, utils } = stylelint_1.default;
+const ruleName = 'css-modules-kit/no-missing-component-file';
+const messages = utils.ruleMessages(ruleName, {
+    disallow: () => `The corresponding component file is not found.`,
+});
+const meta = {
+    url: 'https://github.com/mizdra/css-modules-kit/blob/main/packages/stylelint-plugin/docs/rules/no-missing-component-file.md',
+};
+const ruleFunction = (_primaryOptions, _secondaryOptions, _context) => {
+    return async (root, result) => {
+        const fileName = root.source?.input.file;
+        if (fileName === undefined || !(0, core_1.isCSSModuleFile)(fileName))
+            return;
+        const componentFile = await (0, core_1.findComponentFile)(fileName, util_js_1.readFile);
+        if (componentFile === undefined) {
+            utils.report({
+                result,
+                ruleName,
+                message: messages.disallow(),
+                node: root,
+                index: 0,
+                endIndex: 0,
+            });
+        }
+    };
+};
+ruleFunction.ruleName = ruleName;
+ruleFunction.messages = messages;
+ruleFunction.meta = meta;
+exports.noMissingComponentFile = createPlugin(ruleName, ruleFunction);
+//# sourceMappingURL=no-missing-component-file.js.map

package/dist/rules/no-missing-component-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-missing-component-file.js","sourceRoot":"","sources":["../../src/rules/no-missing-component-file.ts"],"names":[],"mappings":";;;;;;AAAA,gDAA2E;AAE3E,0DAAkC;AAClC,wCAAsC;AAEtC,mEAAmE;AACnE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,mBAAS,CAAC;AAE1C,MAAM,QAAQ,GAAG,2CAA2C,CAAC;AAE7D,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,GAAG,EAAE,CAAC,gDAAgD;CACjE,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG;IACX,GAAG,EAAE,uHAAuH;CAC7H,CAAC;AAEF,MAAM,YAAY,GAAS,CAAC,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE;IAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAA,sBAAe,EAAC,QAAQ,CAAC;YAAE,OAAO;QAEjE,MAAM,aAAa,GAAG,MAAM,IAAA,wBAAiB,EAAC,QAAQ,EAAE,kBAAQ,CAAC,CAAC;QAElE,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,CAAC,MAAM,CAAC;gBACX,MAAM;gBACN,QAAQ;gBACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAC5B,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,CAAC;gBACR,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;AAEZ,QAAA,sBAAsB,GAAG,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC"}

package/dist/rules/no-missing-ts-file.d.ts

@@ -0,0 +1,3 @@
+import stylelint from 'stylelint';
+export declare const noMissingTsFile: stylelint.Plugin;
+//# sourceMappingURL=no-missing-ts-file.d.ts.map

package/dist/rules/no-missing-ts-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-missing-ts-file.d.ts","sourceRoot":"","sources":["../../src/rules/no-missing-ts-file.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,WAAW,CAAC;AA0ClC,eAAO,MAAM,eAAe,kBAAuC,CAAC"}

package/dist/rules/no-missing-ts-file.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noMissingTsFile = void 0;
+const stylelint_1 = __importDefault(require("stylelint"));
+const util_js_1 = require("../util.js");
+// TODO: Report cjs-module-lexer compatibility problem to stylelint
+const { createPlugin, utils } = stylelint_1.default;
+const ruleName = 'honey-css-modules/no-missing-ts-file';
+const messages = utils.ruleMessages(ruleName, {
+    disallow: () => `The corresponding TypeScript file is not found.`,
+});
+const meta = {
+    url: 'https://github.com/mizdra/honey-css-modules/blob/main/packages/stylelint-plugin-honey-css-modules/docs/rules/no-missing-ts-file.md',
+};
+const ruleFunction = (_primaryOptions, _secondaryOptions, _context) => {
+    return async (root, result) => {
+        if (root.source?.input.file === undefined)
+            return;
+        const cssModuleFileName = root.source.input.file;
+        if (!cssModuleFileName.endsWith('.module.css'))
+            return;
+        const tsFile = await (0, util_js_1.findComponentFile)(cssModuleFileName);
+        if (tsFile === undefined) {
+            utils.report({
+                result,
+                ruleName,
+                message: messages.disallow(),
+                node: root,
+                index: 0,
+                endIndex: 0,
+            });
+        }
+    };
+};
+ruleFunction.ruleName = ruleName;
+ruleFunction.messages = messages;
+ruleFunction.meta = meta;
+exports.noMissingTsFile = createPlugin(ruleName, ruleFunction);
+//# sourceMappingURL=no-missing-ts-file.js.map

package/dist/rules/no-missing-ts-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-missing-ts-file.js","sourceRoot":"","sources":["../../src/rules/no-missing-ts-file.ts"],"names":[],"mappings":";;;;;;AACA,0DAAkC;AAClC,wCAA+C;AAE/C,mEAAmE;AACnE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,mBAAS,CAAC;AAE1C,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAExD,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,GAAG,EAAE,CAAC,iDAAiD;CAClE,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG;IACX,GAAG,EAAE,oIAAoI;CAC1I,CAAC;AAEF,MAAM,YAAY,GAAS,CAAC,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE;IAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC5B,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAClD,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAEjD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,OAAO;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAiB,EAAC,iBAAiB,CAAC,CAAC;QAE1D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,CAAC,MAAM,CAAC;gBACX,MAAM;gBACN,QAAQ;gBACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAC5B,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,CAAC;gBACR,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;AAEZ,QAAA,eAAe,GAAG,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC"}

package/dist/rules/no-unused-class-names.d.ts

@@ -0,0 +1,5 @@
+import stylelint from 'stylelint';
+declare function findUsedTokenNames(componentText: string): Set<string>;
+export declare const noUnusedClassNames: stylelint.Plugin;
+export { findUsedTokenNames as findUsedTokenNamesForTest };
+//# sourceMappingURL=no-unused-class-names.d.ts.map

package/dist/rules/no-unused-class-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unused-class-names.d.ts","sourceRoot":"","sources":["../../src/rules/no-unused-class-names.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,WAAW,CAAC;AA4DlC,iBAAS,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAO9D;AAMD,eAAO,MAAM,kBAAkB,kBAAuC,CAAC;AACvE,OAAO,EAAE,kBAAkB,IAAI,yBAAyB,EAAE,CAAC"}

package/dist/rules/no-unused-class-names.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noUnusedClassNames = void 0;
+exports.findUsedTokenNamesForTest = findUsedTokenNames;
+const core_1 = require("@css-modules-kit/core");
+const stylelint_1 = __importDefault(require("stylelint"));
+const util_js_1 = require("../util.js");
+// TODO: Report cjs-module-lexer compatibility problem to stylelint
+const { createPlugin, utils } = stylelint_1.default;
+const ruleName = 'css-modules-kit/no-unused-class-names';
+const messages = utils.ruleMessages(ruleName, {
+    disallow: (className, componentFileName) => `"${className}" is defined but never used in "${(0, core_1.basename)(componentFileName)}"`,
+});
+const meta = {
+    url: 'https://github.com/mizdra/css-modules-kit/blob/main/packages/stylelint-plugin/docs/rules/no-unused-class-names.md',
+};
+const ruleFunction = (_primaryOptions, _secondaryOptions, _context) => {
+    return async (root, result) => {
+        const fileName = root.source?.input.file;
+        if (fileName === undefined || !(0, core_1.isCSSModuleFile)(fileName))
+            return;
+        const componentFile = await (0, core_1.findComponentFile)(fileName, util_js_1.readFile);
+        // If the corresponding component file is not found, it is treated as a CSS Module file shared by the entire project.
+        // It is difficult to determine where class names in a shared CSS Module file are used. Therefore, it is
+        // assumed that all class names are used.
+        if (componentFile === undefined)
+            return;
+        const usedTokenNames = findUsedTokenNames(componentFile.text);
+        root.walkRules((rule) => {
+            const { classSelectors } = (0, core_1.parseRule)(rule);
+            for (const classSelector of classSelectors) {
+                if (!usedTokenNames.has(classSelector.name)) {
+                    utils.report({
+                        result,
+                        ruleName,
+                        message: messages.disallow(classSelector.name, componentFile.fileName),
+                        node: rule,
+                        index: classSelector.loc.start.offset,
+                        endIndex: classSelector.loc.end.offset,
+                        word: classSelector.name,
+                    });
+                }
+            }
+        });
+    };
+};
+/**
+ * The syntax pattern for consuming tokens imported from CSS Module.
+ * @example `styles.foo`
+ */
+// TODO: Support `styles['foo']` and `styles["foo"]`
+// MEMO: The `xxxStyles.foo` format is not supported, because the css module file for current component file is usually imported with `styles`.
+//       It is sufficient to support only the `styles.foo` format.
+const TOKEN_CONSUMER_PATTERN = /styles\.([$_\p{ID_Start}][$\u200c\u200d\p{ID_Continue}]*)/gu;
+function findUsedTokenNames(componentText) {
+    const usedClassNames = new Set();
+    let match;
+    while ((match = TOKEN_CONSUMER_PATTERN.exec(componentText)) !== null) {
+        usedClassNames.add(match[1]);
+    }
+    return usedClassNames;
+}
+ruleFunction.ruleName = ruleName;
+ruleFunction.messages = messages;
+ruleFunction.meta = meta;
+exports.noUnusedClassNames = createPlugin(ruleName, ruleFunction);
+//# sourceMappingURL=no-unused-class-names.js.map

package/dist/rules/no-unused-class-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unused-class-names.js","sourceRoot":"","sources":["../../src/rules/no-unused-class-names.ts"],"names":[],"mappings":";;;;;;AA4E+B,uDAAyB;AA5ExD,gDAAgG;AAEhG,0DAAkC;AAClC,wCAAsC;AAEtC,mEAAmE;AACnE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,mBAAS,CAAC;AAE1C,MAAM,QAAQ,GAAG,uCAAuC,CAAC;AAEzD,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,CAAC,SAAiB,EAAE,iBAAyB,EAAE,EAAE,CACzD,IAAI,SAAS,mCAAmC,IAAA,eAAQ,EAAC,iBAAiB,CAAC,GAAG;CACjF,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG;IACX,GAAG,EAAE,mHAAmH;CACzH,CAAC;AAEF,MAAM,YAAY,GAAS,CAAC,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE;IAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAA,sBAAe,EAAC,QAAQ,CAAC;YAAE,OAAO;QAEjE,MAAM,aAAa,GAAG,MAAM,IAAA,wBAAiB,EAAC,QAAQ,EAAE,kBAAQ,CAAC,CAAC;QAElE,qHAAqH;QACrH,wGAAwG;QACxG,yCAAyC;QACzC,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO;QAExC,MAAM,cAAc,GAAG,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE9D,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YACtB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;YAE3C,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;gBAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5C,KAAK,CAAC,MAAM,CAAC;wBACX,MAAM;wBACN,QAAQ;wBACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC;wBACtE,IAAI,EAAE,IAAI;wBACV,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM;wBACrC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM;wBACtC,IAAI,EAAE,aAAa,CAAC,IAAI;qBACzB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,oDAAoD;AACpD,+IAA+I;AAC/I,kEAAkE;AAClE,MAAM,sBAAsB,GAAG,6DAA6D,CAAC;AAE7F,SAAS,kBAAkB,CAAC,aAAqB;IAC/C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrE,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACjC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;AAEZ,QAAA,kBAAkB,GAAG,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,2 @@
+export declare function readFile(path: string): Promise<string>;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAEA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5D"}

package/dist/util.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFile = readFile;
+const promises_1 = __importDefault(require("node:fs/promises"));
+async function readFile(path) {
+    return promises_1.default.readFile(path, 'utf-8');
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":";;;;;AAEA,4BAEC;AAJD,gEAAkC;AAE3B,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,OAAO,kBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@css-modules-kit/stylelint-plugin",
+  "description": "A stylelint plugin for CSS Modules",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mizdra/css-modules-kit.git",
+    "directory": "packages/stylelint-plugin"
+  },
+  "author": "mizdra <pp.mizdra@gmail.com>",
+  "license": "MIT",
+  "private": false,
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "css-modules",
+    "stylelint",
+    "stylelint-plugin"
+  ],
+  "files": [
+    "bin",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/__snapshots__",
+    "!src/test",
+    "dist"
+  ],
+  "dependencies": {
+    "@css-modules-kit/core": "^0.0.1"
+  },
+  "peerDependencies": {
+    "stylelint": "^16.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+import { noMissingComponentFile } from './rules/no-missing-component-file.js';
+import { noUnusedClassNames } from './rules/no-unused-class-names.js';
+
+export = [noUnusedClassNames, noMissingComponentFile];

package/src/rules/no-missing-component-file.ts

@@ -0,0 +1,43 @@
+import { findComponentFile, isCSSModuleFile } from '@css-modules-kit/core';
+import type { Rule } from 'stylelint';
+import stylelint from 'stylelint';
+import { readFile } from '../util.js';
+
+// TODO: Report cjs-module-lexer compatibility problem to stylelint
+const { createPlugin, utils } = stylelint;
+
+const ruleName = 'css-modules-kit/no-missing-component-file';
+
+const messages = utils.ruleMessages(ruleName, {
+  disallow: () => `The corresponding component file is not found.`,
+});
+
+const meta = {
+  url: 'https://github.com/mizdra/css-modules-kit/blob/main/packages/stylelint-plugin/docs/rules/no-missing-component-file.md',
+};
+
+const ruleFunction: Rule = (_primaryOptions, _secondaryOptions, _context) => {
+  return async (root, result) => {
+    const fileName = root.source?.input.file;
+    if (fileName === undefined || !isCSSModuleFile(fileName)) return;
+
+    const componentFile = await findComponentFile(fileName, readFile);
+
+    if (componentFile === undefined) {
+      utils.report({
+        result,
+        ruleName,
+        message: messages.disallow(),
+        node: root,
+        index: 0,
+        endIndex: 0,
+      });
+    }
+  };
+};
+
+ruleFunction.ruleName = ruleName;
+ruleFunction.messages = messages;
+ruleFunction.meta = meta;
+
+export const noMissingComponentFile = createPlugin(ruleName, ruleFunction);

package/src/rules/no-unused-class-names.ts

@@ -0,0 +1,77 @@
+import { basename, findComponentFile, isCSSModuleFile, parseRule } from '@css-modules-kit/core';
+import type { Rule } from 'stylelint';
+import stylelint from 'stylelint';
+import { readFile } from '../util.js';
+
+// TODO: Report cjs-module-lexer compatibility problem to stylelint
+const { createPlugin, utils } = stylelint;
+
+const ruleName = 'css-modules-kit/no-unused-class-names';
+
+const messages = utils.ruleMessages(ruleName, {
+  disallow: (className: string, componentFileName: string) =>
+    `"${className}" is defined but never used in "${basename(componentFileName)}"`,
+});
+
+const meta = {
+  url: 'https://github.com/mizdra/css-modules-kit/blob/main/packages/stylelint-plugin/docs/rules/no-unused-class-names.md',
+};
+
+const ruleFunction: Rule = (_primaryOptions, _secondaryOptions, _context) => {
+  return async (root, result) => {
+    const fileName = root.source?.input.file;
+    if (fileName === undefined || !isCSSModuleFile(fileName)) return;
+
+    const componentFile = await findComponentFile(fileName, readFile);
+
+    // If the corresponding component file is not found, it is treated as a CSS Module file shared by the entire project.
+    // It is difficult to determine where class names in a shared CSS Module file are used. Therefore, it is
+    // assumed that all class names are used.
+    if (componentFile === undefined) return;
+
+    const usedTokenNames = findUsedTokenNames(componentFile.text);
+
+    root.walkRules((rule) => {
+      const { classSelectors } = parseRule(rule);
+
+      for (const classSelector of classSelectors) {
+        if (!usedTokenNames.has(classSelector.name)) {
+          utils.report({
+            result,
+            ruleName,
+            message: messages.disallow(classSelector.name, componentFile.fileName),
+            node: rule,
+            index: classSelector.loc.start.offset,
+            endIndex: classSelector.loc.end.offset,
+            word: classSelector.name,
+          });
+        }
+      }
+    });
+  };
+};
+
+/**
+ * The syntax pattern for consuming tokens imported from CSS Module.
+ * @example `styles.foo`
+ */
+// TODO: Support `styles['foo']` and `styles["foo"]`
+// MEMO: The `xxxStyles.foo` format is not supported, because the css module file for current component file is usually imported with `styles`.
+//       It is sufficient to support only the `styles.foo` format.
+const TOKEN_CONSUMER_PATTERN = /styles\.([$_\p{ID_Start}][$\u200c\u200d\p{ID_Continue}]*)/gu;
+
+function findUsedTokenNames(componentText: string): Set<string> {
+  const usedClassNames = new Set<string>();
+  let match;
+  while ((match = TOKEN_CONSUMER_PATTERN.exec(componentText)) !== null) {
+    usedClassNames.add(match[1]!);
+  }
+  return usedClassNames;
+}
+
+ruleFunction.ruleName = ruleName;
+ruleFunction.messages = messages;
+ruleFunction.meta = meta;
+
+export const noUnusedClassNames = createPlugin(ruleName, ruleFunction);
+export { findUsedTokenNames as findUsedTokenNamesForTest };

package/src/util.ts

@@ -0,0 +1,5 @@
+import fs from 'node:fs/promises';
+
+export async function readFile(path: string): Promise<string> {
+  return fs.readFile(path, 'utf-8');
+}