@css-modules-kit/codegen 0.6.0 → 0.7.0

package/dist/runner.js

@@ -4,89 +4,143 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCMK = runCMK;
+exports.runCMKInWatchMode = runCMKInWatchMode;
 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");
+const chokidar_1 = __importDefault(require("chokidar"));
+const project_js_1 = require("./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 {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');
+async function runCMK(args, logger) {
+    const project = (0, project_js_1.createProject)(args);
+    if (args.clean) {
+        await (0, promises_1.rm)(project.config.dtsOutDir, { recursive: true, force: true });
     }
-    catch (error) {
-        throw new error_js_1.ReadCSSModuleFileError(fileName, error);
+    await project.emitDtsFiles();
+    const diagnostics = project.getDiagnostics();
+    if (diagnostics.length > 0) {
+        logger.logDiagnostics(diagnostics);
+        return false;
     }
-    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,
-    });
+    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 {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);
+async function runCMKInWatchMode(args, logger) {
+    const fsWatchers = [];
+    const project = (0, project_js_1.createProject)(args);
+    let emitAndReportDiagnosticsTimer = undefined;
+    if (args.clean) {
+        await (0, promises_1.rm)(project.config.dtsOutDir, { recursive: true, force: true });
     }
-    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.`,
+    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_1.default
+            .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);
+                }
             },
-        ]);
-        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);
+            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()));
     }
-    if (syntacticDiagnostics.length > 0) {
-        logger.logDiagnostics(syntacticDiagnostics);
-        // eslint-disable-next-line n/no-process-exit
-        process.exit(1);
+    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);
     }
-    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);
+    /**
+     * @throws {WriteDtsFileError}
+     */
+    async function emitAndReportDiagnostics() {
+        logger.clearScreen();
+        await project.emitDtsFiles();
+        const diagnostics = project.getDiagnostics();
+        if (diagnostics.length > 0) {
+            logger.logDiagnostics(diagnostics);
+        }
+        logger.logMessage(`Found ${diagnostics.length} error${diagnostics.length === 1 ? '' : 's'}. Watching for file changes.`, { time: true });
     }
-    if (semanticDiagnostics.length > 0) {
-        logger.logDiagnostics(semanticDiagnostics);
-        // eslint-disable-next-line n/no-process-exit
-        process.exit(1);
+    async function close() {
+        await Promise.all(fsWatchers.map(async (watcher) => watcher.close()));
     }
-    if (args.clean) {
-        await (0, promises_1.rm)(config.dtsOutDir, { recursive: true, force: true });
-    }
-    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,7 +1,7 @@
 {
   "name": "@css-modules-kit/codegen",
   "description": "A tool for generating `*.d.ts` files for `*.module.css`.",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "commonjs",
   "sideEffects": false,
   "repository": {
@@ -38,7 +38,8 @@
     "dist"
   ],
   "dependencies": {
-    "@css-modules-kit/core": "^0.6.0"
+    "@css-modules-kit/core": "^0.7.0",
+    "chokidar": "^4.0.3"
   },
   "peerDependencies": {
     "typescript": "^5.7.3"

package/src/cli.ts

@@ -12,6 +12,7 @@ Options:
   --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]
 `;
 
 export function printHelpText(): void {
@@ -30,6 +31,7 @@ export interface ParsedArgs {
   project: string;
   pretty: boolean | undefined;
   clean: boolean;
+  watch: boolean;
 }
 
 /**
@@ -46,6 +48,7 @@ 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 },
       },
       allowNegative: true,
     });
@@ -55,6 +58,7 @@ export function parseCLIArgs(args: string[], cwd: string): ParsedArgs {
       project: resolve(cwd, values.project),
       pretty: values.pretty,
       clean: values.clean,
+      watch: values.watch,
     };
   } catch (cause) {
     throw new ParseCLIArgsError(cause);

package/src/index.ts

@@ -1,4 +1,4 @@
-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 { parseCLIArgs, printHelpText, printVersion } from './cli.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}]`;
+  }
+}

package/src/logger/logger.ts

@@ -1,12 +1,14 @@
+import { inspect } from 'node:util';
 import type { DiagnosticSourceFile } from '@css-modules-kit/core';
-import { convertDiagnostic, convertSystemError, type Diagnostic, type SystemError } from '@css-modules-kit/core';
+import { convertDiagnostic, convertSystemError, type Diagnostic, SystemError } from '@css-modules-kit/core';
 import ts from 'typescript';
-import { formatDiagnostics } from './formatter.js';
+import { formatDiagnostics, formatTime } from './formatter.js';
 
 export interface Logger {
   logDiagnostics(diagnostics: Diagnostic[]): void;
-  logSystemError(error: SystemError): void;
-  logMessage(message: string): void;
+  logError(error: unknown): void;
+  logMessage(message: string, options?: { time?: boolean }): void;
+  clearScreen(): void;
 }
 
 export function createLogger(cwd: string, pretty: boolean): Logger {
@@ -29,12 +31,24 @@ export function createLogger(cwd: string, pretty: boolean): Logger {
       );
       process.stderr.write(result);
     },
-    logSystemError(error: SystemError): void {
-      const result = formatDiagnostics([convertSystemError(error)], host, pretty);
-      process.stderr.write(result);
+    logError(error: unknown): void {
+      // NOTE: SystemErrors are errors expected by the css-modules-kit specification and may occur within normal usage.
+      // These errors are formatted clearly and concisely. No stack trace is output.
+      //
+      // All other errors are unexpected errors. To assist in debugging when these errors occur, a stack trace is output.
+      if (error instanceof SystemError) {
+        const result = formatDiagnostics([convertSystemError(error)], host, pretty);
+        process.stderr.write(result);
+      } else {
+        process.stderr.write(`${inspect(error, { colors: pretty })}\n`);
+      }
+    },
+    logMessage(message: string, options?: { time?: boolean }): void {
+      const header = options?.time ? `${formatTime(new Date(), pretty)} ` : '';
+      process.stdout.write(`${header}${message}\n`);
     },
-    logMessage(message: string): void {
-      process.stdout.write(`${message}\n`);
+    clearScreen(): void {
+      process.stdout.write('\x1B[2J\x1B[3J\x1B[H');
     },
   };
 }

package/src/project.ts

@@ -0,0 +1,229 @@
+import { readFileSync } from 'node:fs';
+import type { CSSModule, Diagnostic } from '@css-modules-kit/core';
+import {
+  checkCSSModule,
+  type CMKConfig,
+  createExportBuilder,
+  createMatchesPattern,
+  createResolver,
+  generateDts,
+  getFileNamesByPattern,
+  parseCSSModule,
+  readConfigFile,
+} from '@css-modules-kit/core';
+import ts from 'typescript';
+import { writeDtsFile } from './dts-writer.js';
+import { ReadCSSModuleFileError } from './error.js';
+
+interface ProjectArgs {
+  project: string;
+}
+
+export interface Project {
+  config: CMKConfig;
+  /** Whether the file matches the wildcard patterns in `include` / `exclude` options */
+  isWildcardMatchedFile(fileName: string): boolean;
+  /**
+   * Add a file to the project.
+   * @throws {ReadCSSModuleFileError}
+   */
+  addFile(fileName: string): void;
+  /**
+   * Update a file in the project.
+   * @throws {ReadCSSModuleFileError}
+   */
+  updateFile(fileName: string): void;
+  /** Remove a file from the project. */
+  removeFile(fileName: string): void;
+  /**
+   * Get all diagnostics.
+   * Including three types of diagnostics: project diagnostics, syntactic diagnostics, and semantic diagnostics.
+   * - Project diagnostics: For example, it includes configuration errors in tsconfig.json or warnings when there are no target files.
+   * - Syntactic diagnostics: Syntax errors in CSS Module files.
+   * - Semantic diagnostics: Errors related to the use of imports and exports in CSS module files.
+   * If there are any project diagnostics or syntactic diagnostics, semantic diagnostics will be skipped.
+   */
+  getDiagnostics(): Diagnostic[];
+  /**
+   * Emit .d.ts files for all project files.
+   * @throws {WriteDtsFileError}
+   */
+  emitDtsFiles(): Promise<void>;
+}
+
+/**
+ * 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: ProjectArgs): Project {
+  const config = readConfigFile(args.project);
+
+  const getCanonicalFileName = (fileName: string) =>
+    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<string, CSSModule>();
+  const semanticDiagnosticsMap = new Map<string, Diagnostic[]>();
+  // Tracks whether .d.ts has been emitted after the last change
+  const emittedSet = new Set<string>();
+  const getCSSModule = (path: string) => 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: string) {
+    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: string) {
+    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: string) {
+    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: string): CSSModule | undefined {
+    let text: string;
+    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(): Diagnostic[] {
+    const diagnostics: Diagnostic[] = [...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: Diagnostic[] = [];
+    diagnostics.push(...config.diagnostics);
+    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: Diagnostic[] = [];
+    for (const cssModule of cssModuleMap.values()) {
+      let diagnostics = semanticDiagnosticsMap.get(cssModule.fileName);
+      if (!diagnostics) {
+        diagnostics = checkCSSModule(cssModule, config, exportBuilder, matchesPattern, resolver, getCSSModule);
+        semanticDiagnosticsMap.set(cssModule.fileName, diagnostics);
+      }
+      allDiagnostics.push(...diagnostics);
+    }
+    return allDiagnostics;
+  }
+
+  /**
+   * @throws {WriteDtsFileError}
+   */
+  async function emitDtsFiles(): Promise<void> {
+    const promises: Promise<void>[] = [];
+    for (const cssModule of cssModuleMap.values()) {
+      if (emittedSet.has(cssModule.fileName)) continue;
+      const dts = generateDts(cssModule, { resolver, matchesPattern }, { ...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: unknown): error is NodeJS.ErrnoException {
+  return typeof error === 'object' && error !== null && 'code' in error && typeof error.code === 'string';
+}