@css-modules-kit/codegen 0.0.1

package/README.md

@@ -0,0 +1,21 @@
+# `@css-modules-kit/codegen`
+
+A tool for generating `*.d.ts` files for `*.module.css`.
+
+## Installation
+
+```bash
+npm i -D @css-modules-kit/codegen
+```
+
+## Usage
+
+From the command line, run the `cmk` command.
+
+```bash
+cmk
+```
+
+## Options
+
+See [css-modules-kit's README](https://github.com/mizdra/css-modules-kit?tab=readme-ov-file#options).

package/bin/cmk.mjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { SystemError } from '@css-modules-kit/core';
+import { createLogger, runCMK } from '../dist/index.js';
+
+// TODO: Support `--help` option
+// TODO: Support `--version` option
+// TODO: Support `--project` option
+
+const cwd = process.cwd();
+const project = cwd;
+const logger = createLogger(cwd);
+try {
+  await runCMK(project, logger);
+} catch (e) {
+  if (e instanceof SystemError) {
+    logger.logSystemError(e);
+    // eslint-disable-next-line n/no-process-exit
+    process.exit(1);
+  }
+  throw e;
+}

package/dist/dts-writer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Get .d.ts file path.
+ * @param cssModuleFileName The path to the CSS Module file (i.e. `/src/foo.module.css`). It is absolute.
+ * @param options Output directory options
+ * @returns The path to the .d.ts file. It is absolute.
+ */
+export declare function getDtsFilePath(cssModuleFileName: string, options: WriteDtsFileOption): string;
+export interface WriteDtsFileOption {
+    /** Directory to write the d.ts file. This is an absolute path. */
+    outDir: string;
+    basePath: string;
+    /** Generate `.d.css.ts` instead of `.css.d.ts`. */
+    arbitraryExtensions: boolean;
+}
+/**
+ * Write a d.ts file to the file system.
+ * @param text The d.ts text to write.
+ * @param cssModuleFileName The filename of the CSS module file.
+ * @param options Options for writing the d.ts file.
+ * @throws {WriteDtsFileError} When the file cannot be written.
+ */
+export declare function writeDtsFile(text: string, cssModuleFileName: string, options: WriteDtsFileOption): Promise<void>;
+//# sourceMappingURL=dts-writer.d.ts.map

package/dist/dts-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts-writer.d.ts","sourceRoot":"","sources":["../src/dts-writer.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAU7F;AAED,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/dts-writer.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDtsFilePath = getDtsFilePath;
+exports.writeDtsFile = writeDtsFile;
+const promises_1 = require("node:fs/promises");
+const core_1 = require("@css-modules-kit/core");
+const error_js_1 = require("./error.js");
+/**
+ * Get .d.ts file path.
+ * @param cssModuleFileName The path to the CSS Module file (i.e. `/src/foo.module.css`). It is absolute.
+ * @param options Output directory options
+ * @returns The path to the .d.ts file. It is absolute.
+ */
+function getDtsFilePath(cssModuleFileName, options) {
+    const relativePath = (0, core_1.relative)(options.basePath, cssModuleFileName);
+    const outputFilePath = (0, core_1.resolve)(options.outDir, relativePath);
+    if (options.arbitraryExtensions) {
+        const { dir, name, ext } = (0, core_1.parse)(outputFilePath);
+        return (0, core_1.join)(dir, `${name}.d${ext}.ts`);
+    }
+    else {
+        return `${outputFilePath}.d.ts`;
+    }
+}
+/**
+ * Write a d.ts file to the file system.
+ * @param text The d.ts text to write.
+ * @param cssModuleFileName The filename of the CSS module file.
+ * @param options Options for writing the d.ts file.
+ * @throws {WriteDtsFileError} When the file cannot be written.
+ */
+async function writeDtsFile(text, cssModuleFileName, options) {
+    const dtsFileName = getDtsFilePath(cssModuleFileName, options);
+    try {
+        await (0, promises_1.mkdir)((0, core_1.dirname)(dtsFileName), { recursive: true });
+        await (0, promises_1.writeFile)(dtsFileName, text);
+    }
+    catch (error) {
+        throw new error_js_1.WriteDtsFileError(dtsFileName, error);
+    }
+}
+//# sourceMappingURL=dts-writer.js.map

package/dist/dts-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts-writer.js","sourceRoot":"","sources":["../src/dts-writer.ts"],"names":[],"mappings":";;AAUA,wCAUC;AAiBD,oCAYC;AAjDD,+CAAoD;AACpD,gDAAgF;AAChF,yCAA+C;AAE/C;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,iBAAyB,EAAE,OAA2B;IACnF,MAAM,YAAY,GAAG,IAAA,eAAQ,EAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,IAAA,cAAO,EAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE7D,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAA,YAAK,EAAC,cAAc,CAAC,CAAC;QACjD,OAAO,IAAA,WAAI,EAAC,GAAG,EAAE,GAAG,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,cAAc,OAAO,CAAC;IAClC,CAAC;AACH,CAAC;AAUD;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,iBAAyB,EACzB,OAA2B;IAE3B,MAAM,WAAW,GAAG,cAAc,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,IAAA,gBAAK,EAAC,IAAA,cAAO,EAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,IAAA,oBAAS,EAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,4BAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,8 @@
+import { SystemError } from '@css-modules-kit/core';
+export declare class WriteDtsFileError extends SystemError {
+    constructor(fileName: string, cause: unknown);
+}
+export declare class ReadCSSModuleFileError extends SystemError {
+    constructor(fileName: string, cause: unknown);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAG7C;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAG7C"}

package/dist/error.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadCSSModuleFileError = exports.WriteDtsFileError = void 0;
+const core_1 = require("@css-modules-kit/core");
+class WriteDtsFileError extends core_1.SystemError {
+    constructor(fileName, cause) {
+        super('WRITE_DTS_FILE_ERROR', `Failed to write .d.ts file ${fileName}.`, { cause });
+    }
+}
+exports.WriteDtsFileError = WriteDtsFileError;
+class ReadCSSModuleFileError extends core_1.SystemError {
+    constructor(fileName, cause) {
+        super('READ_CSS_MODULE_FILE_ERROR', `Failed to read CSS Module file ${fileName}.`, { cause });
+    }
+}
+exports.ReadCSSModuleFileError = ReadCSSModuleFileError;
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":";;;AAAA,gDAAoD;AAEpD,MAAa,iBAAkB,SAAQ,kBAAW;IAChD,YAAY,QAAgB,EAAE,KAAc;QAC1C,KAAK,CAAC,sBAAsB,EAAE,8BAA8B,QAAQ,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;CACF;AAJD,8CAIC;AAED,MAAa,sBAAuB,SAAQ,kBAAW;IACrD,YAAY,QAAgB,EAAE,KAAc;QAC1C,KAAK,CAAC,4BAA4B,EAAE,kCAAkC,QAAQ,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;CACF;AAJD,wDAIC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { runCMK } from './runner.js';
+export { type Logger, createLogger } from './logger/logger.js';
+export { WriteDtsFileError, ReadCSSModuleFileError } from './error.js';
+//# 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":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadCSSModuleFileError = exports.WriteDtsFileError = exports.createLogger = exports.runCMK = void 0;
+var runner_js_1 = require("./runner.js");
+Object.defineProperty(exports, "runCMK", { enumerable: true, get: function () { return runner_js_1.runCMK; } });
+var logger_js_1 = require("./logger/logger.js");
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_js_1.createLogger; } });
+var error_js_1 = require("./error.js");
+Object.defineProperty(exports, "WriteDtsFileError", { enumerable: true, get: function () { return error_js_1.WriteDtsFileError; } });
+Object.defineProperty(exports, "ReadCSSModuleFileError", { enumerable: true, get: function () { return error_js_1.ReadCSSModuleFileError; } });
+//# 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,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,gDAA+D;AAAzC,yGAAA,YAAY,OAAA;AAClC,uCAAuE;AAA9D,6GAAA,iBAAiB,OAAA;AAAE,kHAAA,sBAAsB,OAAA"}

package/dist/logger/formatter.d.ts

@@ -0,0 +1,4 @@
+import { type Diagnostic, type SystemError } from '@css-modules-kit/core';
+export declare function formatDiagnostic(diagnostic: Diagnostic, cwd: string): string;
+export declare function formatSystemError(error: SystemError): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/logger/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/logger/formatter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAE/B,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAS5E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAS5D"}

package/dist/logger/formatter.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDiagnostic = formatDiagnostic;
+exports.formatSystemError = formatSystemError;
+const node_util_1 = require("node:util");
+const core_1 = require("@css-modules-kit/core");
+function formatDiagnostic(diagnostic, cwd) {
+    let result = '';
+    if (diagnostic.fileName) {
+        result += `${formatLocation(diagnostic.fileName, diagnostic.start, cwd)} - `;
+    }
+    result += `${formatCategory(diagnostic.category)}: `;
+    result += diagnostic.text;
+    // TODO: Add source code if diagnostics has a location
+    return result;
+}
+function formatSystemError(error) {
+    let result = '';
+    result += `${formatCategory('error')}`;
+    result += ' ';
+    result += (0, node_util_1.styleText)('gray', error.code);
+    result += ': ';
+    result += error.message;
+    // TODO: Include cause if exists
+    return result;
+}
+function formatLocation(fileName, start, cwd) {
+    let result = '';
+    result += (0, node_util_1.styleText)('cyan', (0, core_1.relative)(cwd, fileName));
+    if (start !== undefined) {
+        result += ':';
+        result += (0, node_util_1.styleText)('yellow', start.line.toString());
+        result += ':';
+        result += (0, node_util_1.styleText)('yellow', start.column.toString());
+    }
+    return result;
+}
+function formatCategory(category) {
+    switch (category) {
+        case 'error':
+            return (0, node_util_1.styleText)('red', 'error');
+        case 'warning':
+            return (0, node_util_1.styleText)('yellow', 'warning');
+        default:
+            throw new Error(`Unknown diagnostic category: ${String(category)}`);
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/logger/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/logger/formatter.ts"],"names":[],"mappings":";;AASA,4CASC;AAED,8CASC;AA7BD,yCAAsC;AACtC,gDAM+B;AAE/B,SAAgB,gBAAgB,CAAC,UAAsB,EAAE,GAAW;IAClE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC;IAC/E,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;IACrD,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC;IAC1B,sDAAsD;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAkB;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,CAAC;IACd,MAAM,IAAI,IAAA,qBAAS,EAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;IACxB,gCAAgC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,KAAqC,EAAE,GAAW;IAC1F,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,IAAI,IAAA,qBAAS,EAAC,MAAM,EAAE,IAAA,eAAQ,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC;QACd,MAAM,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,CAAC;QACd,MAAM,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,QAA4B;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,IAAA,qBAAS,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnC,KAAK,SAAS;YACZ,OAAO,IAAA,qBAAS,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxC;YACE,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/logger/logger.d.ts

@@ -0,0 +1,7 @@
+import type { Diagnostic, SystemError } from '@css-modules-kit/core';
+export interface Logger {
+    logDiagnostics(diagnostics: Diagnostic[]): void;
+    logSystemError(error: SystemError): void;
+}
+export declare function createLogger(cwd: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,WAAW,MAAM;IACrB,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAChD,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAahD"}

package/dist/logger/logger.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const formatter_js_1 = require("./formatter.js");
+function createLogger(cwd) {
+    return {
+        logDiagnostics(diagnostics) {
+            let result = '';
+            for (const diagnostic of diagnostics) {
+                result += `${(0, formatter_js_1.formatDiagnostic)(diagnostic, cwd)}\n\n`;
+            }
+            process.stderr.write(result);
+        },
+        logSystemError(error) {
+            process.stderr.write(`${(0, formatter_js_1.formatSystemError)(error)}\n`);
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":";;AAQA,oCAaC;AApBD,iDAAqE;AAOrE,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO;QACL,cAAc,CAAC,WAAyB;YACtC,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAA,+BAAgB,EAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC;YACvD,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,cAAc,CAAC,KAAkB;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,gCAAiB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from './logger/logger.js';
+/**
+ * Run css-modules-kit .d.ts generation.
+ * @param project The absolute path to the project directory or the path to `tsconfig.json`.
+ * @throws {GlobError} When failed to retrieve files by glob pattern.
+ * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
+ * @throws {WriteDtsFileError}
+ */
+export declare function runCMK(project: string, logger: Logger): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAgCjD;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD3E"}

package/dist/runner.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCMK = runCMK;
+const promises_1 = require("node:fs/promises");
+const core_1 = require("@css-modules-kit/core");
+const dts_writer_js_1 = require("./dts-writer.js");
+const error_js_1 = require("./error.js");
+/**
+ * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
+ */
+async function parseCSSModuleByFileName(fileName, { dashedIdents }) {
+    let text;
+    try {
+        text = await (0, promises_1.readFile)(fileName, 'utf-8');
+    }
+    catch (error) {
+        throw new error_js_1.ReadCSSModuleFileError(fileName, error);
+    }
+    return (0, core_1.parseCSSModule)(text, { fileName, dashedIdents, safe: false });
+}
+/**
+ * @throws {WriteDtsFileError}
+ */
+async function writeDtsByCSSModule(cssModule, { dtsOutDir, basePath, arbitraryExtensions }, resolver, matchesPattern) {
+    const dts = (0, core_1.createDts)(cssModule, { resolver, matchesPattern });
+    await (0, dts_writer_js_1.writeDtsFile)(dts.text, cssModule.fileName, {
+        outDir: dtsOutDir,
+        basePath,
+        arbitraryExtensions,
+    });
+}
+/**
+ * Run css-modules-kit .d.ts generation.
+ * @param project The absolute path to the project directory or the path to `tsconfig.json`.
+ * @throws {GlobError} When failed to retrieve files by glob pattern.
+ * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
+ * @throws {WriteDtsFileError}
+ */
+async function runCMK(project, logger) {
+    const config = (0, core_1.readConfigFile)(project);
+    if (config.diagnostics.length > 0) {
+        logger.logDiagnostics(config.diagnostics);
+        // eslint-disable-next-line n/no-process-exit
+        process.exit(1);
+    }
+    const resolver = (0, core_1.createResolver)(config.paths);
+    const matchesPattern = (0, core_1.createMatchesPattern)(config);
+    const cssModuleMap = new Map();
+    const syntacticDiagnostics = [];
+    const fileNames = (0, core_1.getFileNamesByPattern)(config);
+    if (fileNames.length === 0) {
+        logger.logDiagnostics([
+            {
+                type: 'semantic',
+                category: 'warning',
+                text: `The file specified in tsconfig.json not found.`,
+            },
+        ]);
+        return;
+    }
+    const parseResults = await Promise.all(fileNames.map(async (fileName) => parseCSSModuleByFileName(fileName, config)));
+    for (const parseResult of parseResults) {
+        cssModuleMap.set(parseResult.cssModule.fileName, parseResult.cssModule);
+        syntacticDiagnostics.push(...parseResult.diagnostics);
+    }
+    if (syntacticDiagnostics.length > 0) {
+        logger.logDiagnostics(syntacticDiagnostics);
+        // eslint-disable-next-line n/no-process-exit
+        process.exit(1);
+    }
+    const getCSSModule = (path) => cssModuleMap.get(path);
+    const exportBuilder = (0, core_1.createExportBuilder)({ getCSSModule, matchesPattern, resolver });
+    const semanticDiagnostics = [];
+    for (const { cssModule } of parseResults) {
+        const diagnostics = (0, core_1.checkCSSModule)(cssModule, exportBuilder, matchesPattern, resolver, getCSSModule);
+        semanticDiagnostics.push(...diagnostics);
+    }
+    if (semanticDiagnostics.length > 0) {
+        logger.logDiagnostics(semanticDiagnostics);
+        // eslint-disable-next-line n/no-process-exit
+        process.exit(1);
+    }
+    await Promise.all(parseResults.map(async (parseResult) => writeDtsByCSSModule(parseResult.cssModule, config, resolver, matchesPattern)));
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@css-modules-kit/codegen",
+  "description": "A tool for generating `*.d.ts` files for `*.module.css`.",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mizdra/css-modules-kit.git",
+    "directory": "packages/codegen"
+  },
+  "author": "mizdra <pp.mizdra@gmail.com>",
+  "license": "MIT",
+  "private": false,
+  "exports": {
+    ".": {
+      "default": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bin": {
+    "cmk": "bin/cmk.mjs"
+  },
+  "keywords": [
+    "css-modules",
+    "typescript"
+  ],
+  "files": [
+    "bin",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/__snapshots__",
+    "!src/test",
+    "dist"
+  ],
+  "dependencies": {
+    "@css-modules-kit/core": "^0.0.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5.7.3"
+  }
+}

package/src/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/src/dts-writer.ts

@@ -0,0 +1,50 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join, parse, relative, resolve } from '@css-modules-kit/core';
+import { WriteDtsFileError } from './error.js';
+
+/**
+ * Get .d.ts file path.
+ * @param cssModuleFileName The path to the CSS Module file (i.e. `/src/foo.module.css`). It is absolute.
+ * @param options Output directory options
+ * @returns The path to the .d.ts file. It is absolute.
+ */
+export function getDtsFilePath(cssModuleFileName: string, options: WriteDtsFileOption): string {
+  const relativePath = relative(options.basePath, cssModuleFileName);
+  const outputFilePath = resolve(options.outDir, relativePath);
+
+  if (options.arbitraryExtensions) {
+    const { dir, name, ext } = parse(outputFilePath);
+    return join(dir, `${name}.d${ext}.ts`);
+  } else {
+    return `${outputFilePath}.d.ts`;
+  }
+}
+
+export interface WriteDtsFileOption {
+  /** Directory to write the d.ts file. This is an absolute path. */
+  outDir: string;
+  basePath: string;
+  /** Generate `.d.css.ts` instead of `.css.d.ts`. */
+  arbitraryExtensions: boolean;
+}
+
+/**
+ * Write a d.ts file to the file system.
+ * @param text The d.ts text to write.
+ * @param cssModuleFileName The filename of the CSS module file.
+ * @param options Options for writing the d.ts file.
+ * @throws {WriteDtsFileError} When the file cannot be written.
+ */
+export async function writeDtsFile(
+  text: string,
+  cssModuleFileName: string,
+  options: WriteDtsFileOption,
+): Promise<void> {
+  const dtsFileName = getDtsFilePath(cssModuleFileName, options);
+  try {
+    await mkdir(dirname(dtsFileName), { recursive: true });
+    await writeFile(dtsFileName, text);
+  } catch (error) {
+    throw new WriteDtsFileError(dtsFileName, error);
+  }
+}

package/src/error.ts

@@ -0,0 +1,13 @@
+import { SystemError } from '@css-modules-kit/core';
+
+export class WriteDtsFileError extends SystemError {
+  constructor(fileName: string, cause: unknown) {
+    super('WRITE_DTS_FILE_ERROR', `Failed to write .d.ts file ${fileName}.`, { cause });
+  }
+}
+
+export class ReadCSSModuleFileError extends SystemError {
+  constructor(fileName: string, cause: unknown) {
+    super('READ_CSS_MODULE_FILE_ERROR', `Failed to read CSS Module file ${fileName}.`, { cause });
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { runCMK } from './runner.js';
+export { type Logger, createLogger } from './logger/logger.js';
+export { WriteDtsFileError, ReadCSSModuleFileError } from './error.js';

package/src/logger/formatter.ts

@@ -0,0 +1,53 @@
+import { styleText } from 'node:util';
+import {
+  type Diagnostic,
+  type DiagnosticCategory,
+  type DiagnosticPosition,
+  relative,
+  type SystemError,
+} from '@css-modules-kit/core';
+
+export function formatDiagnostic(diagnostic: Diagnostic, cwd: string): string {
+  let result = '';
+  if (diagnostic.fileName) {
+    result += `${formatLocation(diagnostic.fileName, diagnostic.start, cwd)} - `;
+  }
+  result += `${formatCategory(diagnostic.category)}: `;
+  result += diagnostic.text;
+  // TODO: Add source code if diagnostics has a location
+  return result;
+}
+
+export function formatSystemError(error: SystemError): string {
+  let result = '';
+  result += `${formatCategory('error')}`;
+  result += ' ';
+  result += styleText('gray', error.code);
+  result += ': ';
+  result += error.message;
+  // TODO: Include cause if exists
+  return result;
+}
+
+function formatLocation(fileName: string, start: DiagnosticPosition | undefined, cwd: string): string {
+  let result = '';
+  result += styleText('cyan', relative(cwd, fileName));
+  if (start !== undefined) {
+    result += ':';
+    result += styleText('yellow', start.line.toString());
+    result += ':';
+    result += styleText('yellow', start.column.toString());
+  }
+  return result;
+}
+
+function formatCategory(category: DiagnosticCategory): string {
+  switch (category) {
+    case 'error':
+      return styleText('red', 'error');
+    case 'warning':
+      return styleText('yellow', 'warning');
+    default:
+      throw new Error(`Unknown diagnostic category: ${String(category)}`);
+  }
+}

package/src/logger/logger.ts

@@ -0,0 +1,22 @@
+import type { Diagnostic, SystemError } from '@css-modules-kit/core';
+import { formatDiagnostic, formatSystemError } from './formatter.js';
+
+export interface Logger {
+  logDiagnostics(diagnostics: Diagnostic[]): void;
+  logSystemError(error: SystemError): void;
+}
+
+export function createLogger(cwd: string): Logger {
+  return {
+    logDiagnostics(diagnostics: Diagnostic[]): void {
+      let result = '';
+      for (const diagnostic of diagnostics) {
+        result += `${formatDiagnostic(diagnostic, cwd)}\n\n`;
+      }
+      process.stderr.write(result);
+    },
+    logSystemError(error: SystemError): void {
+      process.stderr.write(`${formatSystemError(error)}\n`);
+    },
+  };
+}

package/src/runner.ts

@@ -0,0 +1,118 @@
+import { readFile } from 'node:fs/promises';
+import type {
+  CMKConfig,
+  CSSModule,
+  MatchesPattern,
+  ParseCSSModuleResult,
+  Resolver,
+  SemanticDiagnostic,
+  SyntacticDiagnostic,
+} from '@css-modules-kit/core';
+import {
+  checkCSSModule,
+  createDts,
+  createExportBuilder,
+  createMatchesPattern,
+  createResolver,
+  getFileNamesByPattern,
+  parseCSSModule,
+  readConfigFile,
+} from '@css-modules-kit/core';
+import { writeDtsFile } from './dts-writer.js';
+import { ReadCSSModuleFileError } from './error.js';
+import type { Logger } from './logger/logger.js';
+
+/**
+ * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
+ */
+async function parseCSSModuleByFileName(fileName: string, { dashedIdents }: CMKConfig): Promise<ParseCSSModuleResult> {
+  let text: string;
+  try {
+    text = await readFile(fileName, 'utf-8');
+  } catch (error) {
+    throw new ReadCSSModuleFileError(fileName, error);
+  }
+  return parseCSSModule(text, { fileName, dashedIdents, safe: false });
+}
+
+/**
+ * @throws {WriteDtsFileError}
+ */
+async function writeDtsByCSSModule(
+  cssModule: CSSModule,
+  { dtsOutDir, basePath, arbitraryExtensions }: CMKConfig,
+  resolver: Resolver,
+  matchesPattern: MatchesPattern,
+): Promise<void> {
+  const dts = createDts(cssModule, { resolver, matchesPattern });
+  await writeDtsFile(dts.text, cssModule.fileName, {
+    outDir: dtsOutDir,
+    basePath,
+    arbitraryExtensions,
+  });
+}
+
+/**
+ * Run css-modules-kit .d.ts generation.
+ * @param project The absolute path to the project directory or the path to `tsconfig.json`.
+ * @throws {GlobError} When failed to retrieve files by glob pattern.
+ * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
+ * @throws {WriteDtsFileError}
+ */
+export async function runCMK(project: string, logger: Logger): Promise<void> {
+  const config = readConfigFile(project);
+  if (config.diagnostics.length > 0) {
+    logger.logDiagnostics(config.diagnostics);
+    // eslint-disable-next-line n/no-process-exit
+    process.exit(1);
+  }
+
+  const resolver = createResolver(config.paths);
+  const matchesPattern = createMatchesPattern(config);
+
+  const cssModuleMap = new Map<string, CSSModule>();
+  const syntacticDiagnostics: SyntacticDiagnostic[] = [];
+
+  const fileNames = getFileNamesByPattern(config);
+  if (fileNames.length === 0) {
+    logger.logDiagnostics([
+      {
+        type: 'semantic',
+        category: 'warning',
+        text: `The file specified in tsconfig.json not found.`,
+      },
+    ]);
+    return;
+  }
+  const parseResults = await Promise.all(fileNames.map(async (fileName) => parseCSSModuleByFileName(fileName, config)));
+  for (const parseResult of parseResults) {
+    cssModuleMap.set(parseResult.cssModule.fileName, parseResult.cssModule);
+    syntacticDiagnostics.push(...parseResult.diagnostics);
+  }
+
+  if (syntacticDiagnostics.length > 0) {
+    logger.logDiagnostics(syntacticDiagnostics);
+    // eslint-disable-next-line n/no-process-exit
+    process.exit(1);
+  }
+
+  const getCSSModule = (path: string) => cssModuleMap.get(path);
+  const exportBuilder = createExportBuilder({ getCSSModule, matchesPattern, resolver });
+  const semanticDiagnostics: SemanticDiagnostic[] = [];
+  for (const { cssModule } of parseResults) {
+    const diagnostics = checkCSSModule(cssModule, exportBuilder, matchesPattern, resolver, getCSSModule);
+    semanticDiagnostics.push(...diagnostics);
+  }
+
+  if (semanticDiagnostics.length > 0) {
+    logger.logDiagnostics(semanticDiagnostics);
+    // eslint-disable-next-line n/no-process-exit
+    process.exit(1);
+  }
+
+  await Promise.all(
+    parseResults.map(async (parseResult) =>
+      writeDtsByCSSModule(parseResult.cssModule, config, resolver, matchesPattern),
+    ),
+  );
+}