@css-modules-kit/codegen 0.6.0 → 0.8.0

package/dist/project.js

@@ -0,0 +1,174 @@
+import { readFileSync } from 'node:fs';
+import { checkCSSModule, createExportBuilder, createMatchesPattern, createResolver, generateDts, getFileNamesByPattern, parseCSSModule, readConfigFile, relative, } from '@css-modules-kit/core';
+import ts from 'typescript';
+import { writeDtsFile } from './dts-writer.js';
+import { ReadCSSModuleFileError } from './error.js';
+/**
+ * Create a Project instance.
+ * Project is like a facade that calls core operations such as loading settings, parsing CSS Module files, and performing checks.
+ * The parsing and checking results are cached, and methods are also provided to clear the cache when files change.
+ * @throws {TsConfigFileNotFoundError}
+ * @throws {ReadCSSModuleFileError}
+ */
+export function createProject(args) {
+    const config = readConfigFile(args.project);
+    const getCanonicalFileName = (fileName) => ts.sys.useCaseSensitiveFileNames ? fileName : fileName.toLowerCase();
+    const moduleResolutionCache = ts.createModuleResolutionCache(config.basePath, getCanonicalFileName, config.compilerOptions);
+    const resolver = createResolver(config.compilerOptions, moduleResolutionCache);
+    const matchesPattern = createMatchesPattern(config);
+    const cssModuleMap = new Map();
+    const semanticDiagnosticsMap = new Map();
+    // Tracks whether .d.ts has been emitted after the last change
+    const emittedSet = new Set();
+    const getCSSModule = (path) => cssModuleMap.get(path);
+    const exportBuilder = createExportBuilder({ getCSSModule, matchesPattern, resolver });
+    for (const fileName of getFileNamesByPattern(config)) {
+        // NOTE: Files may be deleted between executing `getFileNamesByPattern` and `tryParseCSSModule`.
+        // Therefore, `tryParseCSSModule` may return `undefined`.
+        const cssModule = tryParseCSSModule(fileName);
+        if (cssModule)
+            cssModuleMap.set(fileName, cssModule);
+    }
+    /**
+     * @throws {ReadCSSModuleFileError}
+     */
+    function addFile(fileName) {
+        if (cssModuleMap.has(fileName))
+            return;
+        const cssModule = tryParseCSSModule(fileName);
+        if (!cssModule)
+            return;
+        cssModuleMap.set(fileName, cssModule);
+        // TODO: Delete only the minimum amount of check stage cache
+        moduleResolutionCache.clear();
+        exportBuilder.clearCache();
+        semanticDiagnosticsMap.clear();
+    }
+    /**
+     * @throws {ReadCSSModuleFileError}
+     */
+    function updateFile(fileName) {
+        if (!cssModuleMap.has(fileName))
+            return;
+        const cssModule = tryParseCSSModule(fileName);
+        if (!cssModule)
+            return;
+        cssModuleMap.set(fileName, cssModule);
+        // TODO: Delete only the minimum amount of check stage cache
+        exportBuilder.clearCache();
+        semanticDiagnosticsMap.clear();
+        emittedSet.delete(fileName);
+    }
+    function removeFile(fileName) {
+        if (!cssModuleMap.has(fileName))
+            return;
+        cssModuleMap.delete(fileName);
+        // TODO: Delete only the minimum amount of check stage cache
+        moduleResolutionCache.clear();
+        exportBuilder.clearCache();
+        semanticDiagnosticsMap.clear();
+        emittedSet.delete(fileName);
+    }
+    /**
+     * @throws {ReadCSSModuleFileError}
+     */
+    function tryParseCSSModule(fileName) {
+        let text;
+        try {
+            // NOTE: We are not using asynchronous APIs for the following reasons:
+            //
+            // - Asynchronous APIs are slow in Node.js.
+            //   - https://github.com/nodejs/performance/issues/151
+            // - Handling race conditions is cumbersome.
+            //   - Using an asynchronous API makes `addFile` asynchronous too.
+            //   - If `deleteFile` runs while `addFile` is executing, a race condition occurs.
+            //   - Avoiding this requires something like a mutex. However, implementing that is cumbersome.
+            text = readFileSync(fileName, 'utf-8');
+        }
+        catch (error) {
+            if (isNodeJSSystemError(error) && error.code === 'ENOENT') {
+                return undefined;
+            }
+            throw new ReadCSSModuleFileError(fileName, error);
+        }
+        return parseCSSModule(text, { fileName, includeSyntaxError: true, keyframes: config.keyframes });
+    }
+    function getDiagnostics() {
+        const diagnostics = [...getProjectDiagnostics(), ...getSyntacticDiagnostics()];
+        // If there are project or syntactic diagnostics, skip semantic diagnostics
+        if (diagnostics.length > 0)
+            return diagnostics;
+        diagnostics.push(...getSemanticDiagnostics());
+        return diagnostics;
+    }
+    function getProjectDiagnostics() {
+        const diagnostics = [];
+        diagnostics.push(...config.diagnostics);
+        if (config.enabled === undefined) {
+            diagnostics.push({
+                category: 'warning',
+                text: `"cmkOptions.enabled" will be required in a future version of css-modules-kit. Add \`"cmkOptions": { "enabled": true }\` to ${relative(config.basePath, config.configFileName)}. See https://github.com/mizdra/css-modules-kit/issues/289 for details.`,
+            });
+        }
+        if (cssModuleMap.size === 0) {
+            diagnostics.push({
+                category: 'error',
+                text: `The file specified in tsconfig.json not found.`,
+            });
+        }
+        return diagnostics;
+    }
+    function getSyntacticDiagnostics() {
+        return Array.from(cssModuleMap.values()).flatMap(({ diagnostics }) => diagnostics);
+    }
+    function getSemanticDiagnostics() {
+        const allDiagnostics = [];
+        for (const cssModule of cssModuleMap.values()) {
+            let diagnostics = semanticDiagnosticsMap.get(cssModule.fileName);
+            if (!diagnostics) {
+                diagnostics = checkCSSModule(cssModule, {
+                    config,
+                    getExportRecord: (m) => exportBuilder.build(m),
+                    matchesPattern,
+                    resolver,
+                    getCSSModule,
+                });
+                semanticDiagnosticsMap.set(cssModule.fileName, diagnostics);
+            }
+            allDiagnostics.push(...diagnostics);
+        }
+        return allDiagnostics;
+    }
+    /**
+     * @throws {WriteDtsFileError}
+     */
+    async function emitDtsFiles() {
+        const promises = [];
+        for (const cssModule of cssModuleMap.values()) {
+            if (emittedSet.has(cssModule.fileName))
+                continue;
+            const dts = generateDts(cssModule, { ...config, forTsPlugin: false });
+            promises.push(writeDtsFile(dts.text, cssModule.fileName, {
+                outDir: config.dtsOutDir,
+                basePath: config.basePath,
+                arbitraryExtensions: config.arbitraryExtensions,
+            }).then(() => {
+                emittedSet.add(cssModule.fileName);
+            }));
+        }
+        await Promise.all(promises);
+    }
+    return {
+        config,
+        isWildcardMatchedFile: (fileName) => matchesPattern(fileName),
+        addFile,
+        updateFile,
+        removeFile,
+        getDiagnostics,
+        emitDtsFiles,
+    };
+}
+function isNodeJSSystemError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && typeof error.code === 'string';
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/runner.d.ts

@@ -1,10 +1,37 @@
-import type { ParsedArgs } from './cli.js';
 import type { Logger } from './logger/logger.js';
+import { type Project } from './project.js';
+interface RunnerArgs {
+    project: string;
+    clean: boolean;
+    preserveWatchOutput: boolean;
+}
+export interface Watcher {
+    /** Exported for testing purposes */
+    project: Project;
+    close(): Promise<void>;
+}
 /**
  * Run css-modules-kit .d.ts generation.
  * @param project The absolute path to the project directory or the path to `tsconfig.json`.
+ * @throws {CMKDisabledError} When css-modules-kit is disabled.
  * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
  * @throws {WriteDtsFileError}
+ * @returns Whether the process succeeded without errors.
  */
-export declare function runCMK(args: ParsedArgs, logger: Logger): Promise<void>;
+export declare function runCMK(args: RunnerArgs, logger: Logger): Promise<boolean>;
+/**
+ * Run css-modules-kit .d.ts generation in watch mode.
+ *
+ * The promise resolves when the initial diagnostics report, emit, and watcher initialization are complete.
+ * Errors are reported through the logger.
+ *
+ * NOTE: For implementation simplicity, config file changes are not watched.
+ * @param project The absolute path to the project directory or the path to `tsconfig.json`.
+ * @throws {CMKDisabledError} When css-modules-kit is disabled.
+ * @throws {TsConfigFileNotFoundError}
+ * @throws {ReadCSSModuleFileError}
+ * @throws {WriteDtsFileError}
+ */
+export declare function runCMKInWatchMode(args: RunnerArgs, logger: Logger): Promise<Watcher>;
+export {};
 //# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAoCjD;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE5E"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,OAAO;IACtB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6G1F"}

package/dist/runner.js

@@ -1,92 +1,157 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-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 typescript_1 = __importDefault(require("typescript"));
-const dts_writer_js_1 = require("./dts-writer.js");
-const error_js_1 = require("./error.js");
+import { rm } from 'node:fs/promises';
+import chokidar from 'chokidar';
+import { CMKDisabledError } from './error.js';
+import { createProject } from './project.js';
 /**
+ * Run css-modules-kit .d.ts generation.
+ * @param project The absolute path to the project directory or the path to `tsconfig.json`.
+ * @throws {CMKDisabledError} When css-modules-kit is disabled.
  * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
+ * @throws {WriteDtsFileError}
+ * @returns Whether the process succeeded without errors.
  */
-async function parseCSSModuleByFileName(fileName, config) {
-    let text;
-    try {
-        text = await (0, promises_1.readFile)(fileName, 'utf-8');
+export async function runCMK(args, logger) {
+    const project = createProject(args);
+    if (project.config.enabled === false) {
+        throw new CMKDisabledError(project.config);
     }
-    catch (error) {
-        throw new error_js_1.ReadCSSModuleFileError(fileName, error);
+    if (args.clean) {
+        await rm(project.config.dtsOutDir, { recursive: true, force: true });
     }
-    return (0, core_1.parseCSSModule)(text, { fileName, safe: false, keyframes: config.keyframes });
-}
-/**
- * @throws {WriteDtsFileError}
- */
-async function writeDtsByCSSModule(cssModule, { dtsOutDir, basePath, arbitraryExtensions, namedExports, prioritizeNamedImports }, resolver, matchesPattern) {
-    const dts = (0, core_1.createDts)(cssModule, { resolver, matchesPattern }, { namedExports, prioritizeNamedImports, forTsPlugin: false });
-    await (0, dts_writer_js_1.writeDtsFile)(dts.text, cssModule.fileName, {
-        outDir: dtsOutDir,
-        basePath,
-        arbitraryExtensions,
-    });
+    await project.emitDtsFiles();
+    const diagnostics = project.getDiagnostics();
+    if (diagnostics.length > 0) {
+        logger.logDiagnostics(diagnostics);
+        const hasErrors = diagnostics.some((d) => d.category === 'error');
+        return !hasErrors;
+    }
+    return true;
 }
 /**
- * Run css-modules-kit .d.ts generation.
+ * Run css-modules-kit .d.ts generation in watch mode.
+ *
+ * The promise resolves when the initial diagnostics report, emit, and watcher initialization are complete.
+ * Errors are reported through the logger.
+ *
+ * NOTE: For implementation simplicity, config file changes are not watched.
  * @param project The absolute path to the project directory or the path to `tsconfig.json`.
- * @throws {ReadCSSModuleFileError} When failed to read CSS Module file.
+ * @throws {CMKDisabledError} When css-modules-kit is disabled.
+ * @throws {TsConfigFileNotFoundError}
+ * @throws {ReadCSSModuleFileError}
  * @throws {WriteDtsFileError}
  */
-async function runCMK(args, logger) {
-    const config = (0, core_1.readConfigFile)(args.project);
-    if (config.diagnostics.length > 0) {
-        logger.logDiagnostics(config.diagnostics);
-        // eslint-disable-next-line n/no-process-exit
-        process.exit(1);
+export async function runCMKInWatchMode(args, logger) {
+    const fsWatchers = [];
+    const project = createProject(args);
+    if (project.config.enabled === false) {
+        throw new CMKDisabledError(project.config);
     }
-    const getCanonicalFileName = (fileName) => typescript_1.default.sys.useCaseSensitiveFileNames ? fileName : fileName.toLowerCase();
-    const moduleResolutionCache = typescript_1.default.createModuleResolutionCache(config.basePath, getCanonicalFileName, config.compilerOptions);
-    const resolver = (0, core_1.createResolver)(config.compilerOptions, moduleResolutionCache);
-    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([
-            {
-                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);
+    let emitAndReportDiagnosticsTimer = undefined;
+    if (args.clean) {
+        await rm(project.config.dtsOutDir, { recursive: true, force: true });
     }
-    if (syntacticDiagnostics.length > 0) {
-        logger.logDiagnostics(syntacticDiagnostics);
-        // eslint-disable-next-line n/no-process-exit
-        process.exit(1);
+    await emitAndReportDiagnostics();
+    // Watch project files and report diagnostics on changes
+    const readyPromises = [];
+    for (const wildcardDirectory of project.config.wildcardDirectories) {
+        const { promise, resolve } = promiseWithResolvers();
+        readyPromises.push(promise);
+        fsWatchers.push(chokidar
+            .watch(wildcardDirectory.fileName, {
+            ignored: (fileName, stats) => {
+                // The ignored function is called twice for the same path. The first time with stats undefined,
+                // and the second time with stats provided.
+                // In the first call, we can't determine if the path is a directory or file.
+                // So we include it in the watch target considering it might be a directory.
+                if (!stats)
+                    return false;
+                // In the second call, we include directories or files that match wildcards in the watch target.
+                // However, `dtsOutDir` is excluded from the watch target.
+                if (stats.isDirectory()) {
+                    return fileName === project.config.dtsOutDir;
+                }
+                else {
+                    return !project.isWildcardMatchedFile(fileName);
+                }
+            },
+            ignoreInitial: true,
+            ...(wildcardDirectory.recursive ? {} : { depth: 0 }),
+        })
+            .on('add', (fileName) => {
+            try {
+                project.addFile(fileName);
+            }
+            catch (e) {
+                logger.logError(e);
+                return;
+            }
+            scheduleEmitAndReportDiagnostics();
+        })
+            .on('change', (fileName) => {
+            try {
+                project.updateFile(fileName);
+            }
+            catch (e) {
+                logger.logError(e);
+                return;
+            }
+            scheduleEmitAndReportDiagnostics();
+        })
+            .on('unlink', (fileName) => {
+            project.removeFile(fileName);
+            scheduleEmitAndReportDiagnostics();
+        })
+            .on('error', (e) => logger.logError(e))
+            .on('ready', () => resolve()));
     }
-    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, config, exportBuilder, matchesPattern, resolver, getCSSModule);
-        semanticDiagnostics.push(...diagnostics);
+    await Promise.all(readyPromises);
+    function scheduleEmitAndReportDiagnostics() {
+        // Switching between git branches results in numerous file changes occurring rapidly.
+        // Reporting diagnostics for each file change would overwhelm users.
+        // Therefore, we batch the processing.
+        if (emitAndReportDiagnosticsTimer !== undefined)
+            clearTimeout(emitAndReportDiagnosticsTimer);
+        emitAndReportDiagnosticsTimer = setTimeout(() => {
+            emitAndReportDiagnosticsTimer = undefined;
+            emitAndReportDiagnostics().catch(logger.logError.bind(logger));
+        }, 250);
     }
-    if (semanticDiagnostics.length > 0) {
-        logger.logDiagnostics(semanticDiagnostics);
-        // eslint-disable-next-line n/no-process-exit
-        process.exit(1);
+    /**
+     * @throws {WriteDtsFileError}
+     */
+    async function emitAndReportDiagnostics() {
+        if (!args.preserveWatchOutput) {
+            logger.clearScreen();
+        }
+        await project.emitDtsFiles();
+        const diagnostics = project.getDiagnostics();
+        if (diagnostics.length > 0) {
+            logger.logDiagnostics(diagnostics);
+        }
+        const errorCount = diagnostics.filter((d) => d.category === 'error').length;
+        const warningCount = diagnostics.filter((d) => d.category === 'warning').length;
+        const warningPart = warningCount > 0 ? ` and ${warningCount} warning${warningCount === 1 ? '' : 's'}` : '';
+        logger.logMessage(`Found ${errorCount} error${errorCount === 1 ? '' : 's'}${warningPart}. Watching for file changes.`, { time: true });
+        if (args.preserveWatchOutput) {
+            logger.logMessage('');
+        }
     }
-    if (args.clean) {
-        await (0, promises_1.rm)(config.dtsOutDir, { recursive: true, force: true });
+    async function close() {
+        await Promise.all(fsWatchers.map(async (watcher) => watcher.close()));
     }
-    await Promise.all(parseResults.map(async (parseResult) => writeDtsByCSSModule(parseResult.cssModule, config, resolver, matchesPattern)));
+    return { project, close };
+}
+function promiseWithResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return {
+        promise,
+        resolve: resolve,
+        reject: reject,
+    };
 }
 //# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@css-modules-kit/codegen",
   "description": "A tool for generating `*.d.ts` files for `*.module.css`.",
-  "version": "0.6.0",
-  "type": "commonjs",
+  "version": "0.8.0",
+  "type": "module",
   "sideEffects": false,
   "repository": {
     "type": "git",
@@ -23,7 +23,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "bin": {
-    "cmk": "bin/cmk.mjs"
+    "cmk": "bin/cmk.js"
   },
   "keywords": [
     "css-modules",
@@ -38,7 +38,8 @@
     "dist"
   ],
   "dependencies": {
-    "@css-modules-kit/core": "^0.6.0"
+    "@css-modules-kit/core": "^0.8.0",
+    "chokidar": "^4.0.3"
   },
   "peerDependencies": {
     "typescript": "^5.7.3"

package/src/cli.ts

@@ -1,17 +1,20 @@
 import { parseArgs } from 'node:util';
 import { resolve } from '@css-modules-kit/core';
-import packageJson from '../package.json';
+import packageJson from '../package.json' with { type: 'json' };
 import { ParseCLIArgsError } from './error.js';
 
+// NOTE: Keep this help text in sync with the one in packages/codegen/README.md.
 const helpText = `
 Usage: cmk [options]
 
 Options:
-  --help, -h     Show help information
-  --version, -v  Show version number
-  --project, -p  The path to its configuration file, or to a folder with a 'tsconfig.json'.
-  --pretty       Enable color and formatting in output to make errors easier to read.
-  --clean        Remove the output directory before generating files.                       [default: false]
+  --help, -h             Show help information
+  --version, -v          Show version number
+  --project, -p          The path to its configuration file, or to a folder with a 'tsconfig.json'.
+  --pretty               Enable color and formatting in output to make errors easier to read.
+  --clean                Remove the output directory before generating files.                       [default: false]
+  --watch, -w            Watch for changes and regenerate files.                                    [default: false]
+  --preserveWatchOutput  Disable wiping the console in watch mode.                                  [default: false]
 `;
 
 export function printHelpText(): void {
@@ -30,6 +33,8 @@ export interface ParsedArgs {
   project: string;
   pretty: boolean | undefined;
   clean: boolean;
+  watch: boolean;
+  preserveWatchOutput: boolean;
 }
 
 /**
@@ -46,6 +51,8 @@ export function parseCLIArgs(args: string[], cwd: string): ParsedArgs {
         project: { type: 'string', short: 'p', default: '.' },
         pretty: { type: 'boolean' },
         clean: { type: 'boolean', default: false },
+        watch: { type: 'boolean', short: 'w', default: false },
+        preserveWatchOutput: { type: 'boolean', default: false },
       },
       allowNegative: true,
     });
@@ -55,6 +62,8 @@ export function parseCLIArgs(args: string[], cwd: string): ParsedArgs {
       project: resolve(cwd, values.project),
       pretty: values.pretty,
       clean: values.clean,
+      watch: values.watch,
+      preserveWatchOutput: values.preserveWatchOutput,
     };
   } catch (cause) {
     throw new ParseCLIArgsError(cause);

package/src/error.ts

@@ -1,4 +1,5 @@
-import { SystemError } from '@css-modules-kit/core';
+import type { CMKConfig } from '@css-modules-kit/core';
+import { relative, SystemError } from '@css-modules-kit/core';
 
 export class ParseCLIArgsError extends SystemError {
   constructor(cause: unknown) {
@@ -17,3 +18,12 @@ export class ReadCSSModuleFileError extends SystemError {
     super('READ_CSS_MODULE_FILE_ERROR', `Failed to read CSS Module file ${fileName}.`, cause);
   }
 }
+
+export class CMKDisabledError extends SystemError {
+  constructor(config: CMKConfig) {
+    super(
+      'CMK_DISABLED_ERROR',
+      `css-modules-kit is disabled by configuration. Set \`"cmkOptions": { "enabled": true }\` in ${relative(config.basePath, config.configFileName)} to enable it.`,
+    );
+  }
+}

package/src/index.ts

@@ -1,5 +1,5 @@
-export { runCMK } from './runner.js';
+export { runCMK, runCMKInWatchMode } from './runner.js';
 export { type Logger, createLogger } from './logger/logger.js';
-export { WriteDtsFileError, ReadCSSModuleFileError } from './error.js';
+export { WriteDtsFileError, ReadCSSModuleFileError, CMKDisabledError } from './error.js';
 export { parseCLIArgs, printHelpText, printVersion } from './cli.js';
 export { shouldBePretty } from './3rd-party/typescript.js';

package/src/logger/formatter.ts

@@ -1,5 +1,8 @@
 import ts from 'typescript';
 
+const GRAY = '\u001b[90m';
+const RESET = '\u001b[0m';
+
 export function formatDiagnostics(
   diagnostics: ts.Diagnostic[],
   host: ts.FormatDiagnosticsHost,
@@ -12,3 +15,12 @@ export function formatDiagnostics(
   }
   return result;
 }
+
+export function formatTime(date: Date, pretty: boolean): string {
+  const text = date.toLocaleTimeString('en-US', { timeZone: 'UTC' });
+  if (pretty) {
+    return `[${GRAY}${text}${RESET}]`;
+  } else {
+    return `[${text}]`;
+  }
+}