@css-modules-kit/core 0.1.0 → 0.3.0

package/dist/resolver.js

@@ -7,7 +7,7 @@ exports.createResolver = createResolver;
 const node_url_1 = require("node:url");
 const typescript_1 = __importDefault(require("typescript"));
 const path_js_1 = require("./path.js");
-function createResolver(compilerOptions) {
+function createResolver(compilerOptions, moduleResolutionCache) {
     return (_specifier, options) => {
         let specifier = _specifier;
         const host = {
@@ -19,7 +19,7 @@ function createResolver(compilerOptions) {
                 return typescript_1.default.sys.fileExists(fileName);
             },
         };
-        const { resolvedModule } = typescript_1.default.resolveModuleName(specifier, options.request, compilerOptions, host);
+        const { resolvedModule } = typescript_1.default.resolveModuleName(specifier, options.request, compilerOptions, host, moduleResolutionCache);
         if (resolvedModule) {
             // TODO: Logging that the paths is used.
             specifier = resolvedModule.resolvedFileName.replace(/\.module\.d\.css\.ts$/u, '.module.css');

package/dist/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":";;;;;AAkBA,wCA+BC;AAjDD,uCAAwD;AAExD,4DAA4B;AAC5B,uCAAgD;AAehD,SAAgB,cAAc,CAAC,eAAgC;IAC7D,OAAO,CAAC,UAAkB,EAAE,OAAwB,EAAE,EAAE;QACtD,IAAI,SAAS,GAAG,UAAU,CAAC;QAE3B,MAAM,IAAI,GAA4B;YACpC,GAAG,oBAAE,CAAC,GAAG;YACT,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACvB,IAAI,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC1C,OAAO,oBAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC,CAAC;gBACtF,CAAC;gBACD,OAAO,oBAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;SACF,CAAC;QACF,MAAM,EAAE,cAAc,EAAE,GAAG,oBAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;QACnG,IAAI,cAAc,EAAE,CAAC;YACnB,wCAAwC;YACxC,SAAS,GAAG,cAAc,CAAC,gBAAgB,CAAC,OAAO,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAA,iBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,4CAA4C;YAC5C,kIAAkI;YAClI,qEAAqE;YACrE,OAAO,IAAA,iBAAO,EAAC,IAAA,wBAAa,EAAC,IAAI,GAAG,CAAC,SAAS,EAAE,IAAA,wBAAa,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,sDAAsD;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,SAAiB;IAC5C,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":";;;;;AAMA,wCAwCC;AA9CD,uCAAwD;AAExD,4DAA4B;AAC5B,uCAAgD;AAGhD,SAAgB,cAAc,CAC5B,eAAgC,EAChC,qBAA2D;IAE3D,OAAO,CAAC,UAAkB,EAAE,OAAwB,EAAE,EAAE;QACtD,IAAI,SAAS,GAAG,UAAU,CAAC;QAE3B,MAAM,IAAI,GAA4B;YACpC,GAAG,oBAAE,CAAC,GAAG;YACT,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACvB,IAAI,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC1C,OAAO,oBAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC,CAAC;gBACtF,CAAC;gBACD,OAAO,oBAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;SACF,CAAC;QACF,MAAM,EAAE,cAAc,EAAE,GAAG,oBAAE,CAAC,iBAAiB,CAC7C,SAAS,EACT,OAAO,CAAC,OAAO,EACf,eAAe,EACf,IAAI,EACJ,qBAAqB,CACtB,CAAC;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,wCAAwC;YACxC,SAAS,GAAG,cAAc,CAAC,gBAAgB,CAAC,OAAO,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAA,iBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,4CAA4C;YAC5C,kIAAkI;YAClI,qEAAqE;YACrE,OAAO,IAAA,iBAAO,EAAC,IAAA,wBAAa,EAAC,IAAI,GAAG,CAAC,SAAS,EAAE,IAAA,wBAAa,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,sDAAsD;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,SAAiB;IAC5C,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/type.d.ts

@@ -0,0 +1,174 @@
+/** The position of the node in the source file. */
+export interface Position {
+    /**
+     * The line number in the source file. It is 1-based.
+     * This is compatible with postcss and tsserver.
+     */
+    line: number;
+    /**
+     * The column number in the source file. It is 1-based.
+     * This is compatible with postcss and tsserver.
+     */
+    column: number;
+    /** The offset in the source file. It is 0-based. */
+    offset: number;
+}
+/** The location of the node in the source file. */
+export interface Location {
+    /**
+     * The starting position of the node. It is inclusive.
+     * This is compatible with postcss and tsserver.
+     */
+    start: Position;
+    /**
+     * The ending position of the node. It is exclusive.
+     * This is compatible with tsserver, but not postcss.
+     */
+    end: Position;
+}
+/** The item being exported from a CSS module file (a.k.a. token). */
+export interface Token {
+    /** The token name. */
+    name: string;
+    /** The location of the token in the source file. */
+    loc: Location;
+}
+/**
+ * A token importer using `@import '...'`.
+ * `@import` imports all tokens from the file. Therefore, it does not have
+ * the name of the imported token unlike {@link AtValueTokenImporter}.
+ */
+export interface AtImportTokenImporter {
+    type: 'import';
+    /**
+     * The specifier of the file from which the token is imported.
+     * This is a string before being resolved and unquoted.
+     * @example `@import './a.module.css'` would have `from` as `'./a.module.css'`.
+     */
+    from: string;
+    /** The location of the `from` in *.module.css file. */
+    fromLoc: Location;
+}
+/** A token importer using `@value ... from '...'`. */
+export interface AtValueTokenImporter {
+    type: 'value';
+    /** The values imported from the file. */
+    values: AtValueTokenImporterValue[];
+    /**
+     * The specifier of the file from which the token is imported.
+     * This is a string before being resolved and unquoted.
+     * @example `@value a from './a.module.css'` would have `from` as `'./a.module.css'`.
+     */
+    from: string;
+    /** The location of the `from` in *.module.css file. */
+    fromLoc: Location;
+}
+/** A value imported from a CSS module file using `@value ... from '...'`. */
+export interface AtValueTokenImporterValue {
+    /**
+     * The name of the token in the file from which it is imported.
+     * @example `@value a from './a.module.css'` would have `name` as `'a'`.
+     * @example `@value a as b from './a.module.css'` would have `name` as `'a'`.
+     */
+    name: string;
+    /** The location of the `name` in *.module.css file. */
+    loc: Location;
+    /**
+     * The name of the token in the current file.
+     * @example `@value a from './a.module.css'` would not have `localName`.
+     * @example `@value a as b from './a.module.css'` would have `localName` as `'b'`.
+     */
+    localName?: string;
+    /**
+     * The location of the `localName` in *.module.css file.
+     * This is `undefined` when `localName` is `undefined`.
+     */
+    localLoc?: Location;
+}
+export type TokenImporter = AtImportTokenImporter | AtValueTokenImporter;
+export interface CSSModule {
+    /** Absolute path of the file */
+    fileName: string;
+    /** The content of the file */
+    text: string;
+    /**
+     * List of token names defined in the file.
+     * @example
+     * Consider the following file:
+     * ```css
+     * .foo { color: red }
+     * .bar, .baz { color: red }
+     * ```
+     * The `localTokens` for this file would be `['foo', 'bar', 'baz']`.
+     */
+    localTokens: Token[];
+    /**
+     * List of token importers in the file.
+     * Token importer is a statement that imports tokens from another file.
+     */
+    tokenImporters: TokenImporter[];
+}
+export interface ResolverOptions {
+    /** The file that imports the specifier. It is a absolute path. */
+    request: string;
+}
+/**
+ * A resolver function that resolves import specifiers.
+ * @param specifier The import specifier.
+ * @param options The options.
+ * @returns The resolved import specifier. It is a absolute path. If the import specifier cannot be resolved, return `undefined`.
+ */
+export type Resolver = (specifier: string, options: ResolverOptions) => string | undefined;
+/**
+ * A function that checks if a file name matches a pattern.
+ * @param fileName The file name. It is an absolute path.
+ * @returns `true` if the file name matches the pattern, otherwise `false`.
+ */
+export type MatchesPattern = (fileName: string) => boolean;
+/** The export token record of a CSS module. */
+export interface ExportRecord {
+    /** The all exported tokens of the CSS module. */
+    allTokens: string[];
+}
+export interface ExportBuilder {
+    build(cssModule: CSSModule): ExportRecord;
+    clearCache(): void;
+}
+export type DiagnosticCategory = 'error' | 'warning';
+export interface DiagnosticSourceFile {
+    fileName: string;
+    text: string;
+}
+export interface DiagnosticPosition {
+    /** The line number in the source file. It is 1-based. */
+    line: number;
+    /** The column number in the source file. It is 1-based. */
+    column: number;
+}
+interface DiagnosticWithoutLocation {
+    /** Text of diagnostic message. */
+    text: string;
+    /** The category of the diagnostic message. */
+    category: DiagnosticCategory;
+}
+export interface DiagnosticWithLocation extends DiagnosticWithoutLocation {
+    /** The file in which the diagnostic occurred */
+    file: DiagnosticSourceFile;
+    /** Starting file position at which text applies. It is inclusive. */
+    start: DiagnosticPosition;
+    /** Length of the diagnostic. */
+    length: number;
+}
+export type Diagnostic = DiagnosticWithLocation | DiagnosticWithoutLocation;
+/**
+ * A diagnostic with location information detached from the source file.
+ * It is an intermediate representation used inside the CSS Module parser.
+ */
+export interface DiagnosticWithDetachedLocation extends DiagnosticWithoutLocation {
+    /** Starting file position at which text applies. It is inclusive. */
+    start: DiagnosticPosition;
+    /** Length of the diagnostic. */
+    length: number;
+}
+export {};
+//# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

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

package/dist/type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type.js.map

package/dist/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@css-modules-kit/core",
   "description": "The core of css-modules-kit",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "commonjs",
   "sideEffects": false,
   "repository": {
@@ -24,7 +24,7 @@
     "build": "tsc -b tsconfig.build.json"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=20.19.0"
   },
   "publishConfig": {
     "access": "public",

package/src/checker.ts

@@ -1,13 +1,13 @@
-import type { SemanticDiagnostic } from './diagnostic.js';
-import type { ExportBuilder } from './export-builder.js';
-import type { MatchesPattern } from './file.js';
 import type {
   AtValueTokenImporter,
   AtValueTokenImporterValue,
   CSSModule,
+  Diagnostic,
+  ExportBuilder,
+  MatchesPattern,
+  Resolver,
   TokenImporter,
-} from './parser/css-module-parser.js';
-import type { Resolver } from './resolver.js';
+} from './type.js';
 
 export function checkCSSModule(
   cssModule: CSSModule,
@@ -15,8 +15,8 @@ export function checkCSSModule(
   matchesPattern: MatchesPattern,
   resolver: Resolver,
   getCSSModule: (path: string) => CSSModule | undefined,
-): SemanticDiagnostic[] {
-  const diagnostics: SemanticDiagnostic[] = [];
+): Diagnostic[] {
+  const diagnostics: Diagnostic[] = [];
 
   for (const tokenImporter of cssModule.tokenImporters) {
     const from = resolver(tokenImporter.from, { request: cssModule.fileName });
@@ -39,14 +39,13 @@ export function checkCSSModule(
   return diagnostics;
 }
 
-function createCannotImportModuleDiagnostic(cssModule: CSSModule, tokenImporter: TokenImporter): SemanticDiagnostic {
+function createCannotImportModuleDiagnostic(cssModule: CSSModule, tokenImporter: TokenImporter): Diagnostic {
   return {
-    type: 'semantic',
     text: `Cannot import module '${tokenImporter.from}'`,
     category: 'error',
-    fileName: cssModule.fileName,
+    file: { fileName: cssModule.fileName, text: cssModule.text },
     start: { line: tokenImporter.fromLoc.start.line, column: tokenImporter.fromLoc.start.column },
-    end: { line: tokenImporter.fromLoc.end.line, column: tokenImporter.fromLoc.end.column },
+    length: tokenImporter.fromLoc.end.offset - tokenImporter.fromLoc.start.offset,
   };
 }
 
@@ -54,13 +53,12 @@ function createModuleHasNoExportedTokenDiagnostic(
   cssModule: CSSModule,
   tokenImporter: AtValueTokenImporter,
   value: AtValueTokenImporterValue,
-): SemanticDiagnostic {
+): Diagnostic {
   return {
-    type: 'semantic',
     text: `Module '${tokenImporter.from}' has no exported token '${value.name}'.`,
     category: 'error',
-    fileName: cssModule.fileName,
+    file: { fileName: cssModule.fileName, text: cssModule.text },
     start: { line: value.loc.start.line, column: value.loc.start.column },
-    end: { line: value.loc.end.line, column: value.loc.end.column },
+    length: value.loc.end.offset - value.loc.start.offset,
   };
 }

package/src/config.ts

@@ -1,15 +1,11 @@
 import ts from 'typescript';
-import type { SemanticDiagnostic } from './diagnostic.js';
 import { TsConfigFileNotFoundError } from './error.js';
 import { basename, dirname, join, resolve } from './path.js';
+import type { Diagnostic } from './type.js';
 
 // https://github.com/microsoft/TypeScript/blob/caf1aee269d1660b4d2a8b555c2d602c97cb28d7/src/compiler/commandLineParser.ts#L3006
 const DEFAULT_INCLUDE_SPEC = '**/*';
 
-type RemoveUndefined<T> = {
-  [K in keyof T]: Exclude<T[K], undefined>;
-};
-
 /**
  * The config used by css-modules-kit.
  * This is normalized. Paths are resolved from relative to absolute, and default values are set for missing options.
@@ -19,6 +15,8 @@ export interface CMKConfig {
   excludes: string[];
   dtsOutDir: string;
   arbitraryExtensions: boolean;
+  namedExports: boolean;
+  prioritizeNamedImports: boolean;
   /**
    * A root directory to resolve relative path entries in the config file to.
    * This is an absolute path.
@@ -60,7 +58,7 @@ export interface CMKConfig {
   configFileName: string;
   compilerOptions: ts.CompilerOptions;
   /** The diagnostics that occurred while reading the config file. */
-  diagnostics: SemanticDiagnostic[];
+  diagnostics: Diagnostic[];
 }
 
 /**
@@ -68,10 +66,12 @@ export interface CMKConfig {
  * This is unnormalized. Paths are relative, and some options may be omitted.
  */
 interface UnnormalizedRawConfig {
-  includes: string[] | undefined;
-  excludes: string[] | undefined;
-  dtsOutDir: string | undefined;
-  arbitraryExtensions: boolean | undefined;
+  includes?: string[];
+  excludes?: string[];
+  dtsOutDir?: string;
+  arbitraryExtensions?: boolean;
+  namedExports?: boolean;
+  prioritizeNamedImports?: boolean;
 }
 
 /**
@@ -79,7 +79,7 @@ interface UnnormalizedRawConfig {
  */
 interface ParsedRawData {
   config: UnnormalizedRawConfig;
-  diagnostics: SemanticDiagnostic[];
+  diagnostics: Diagnostic[];
 }
 
 export function findTsConfigFile(project: string): string | undefined {
@@ -91,14 +91,9 @@ export function findTsConfigFile(project: string): string | undefined {
   return resolve(configFile);
 }
 
-function parseRawData(raw: unknown, configFileName: string): ParsedRawData {
+function parseRawData(raw: unknown, tsConfigSourceFile: ts.TsConfigSourceFile): ParsedRawData {
   const result: ParsedRawData = {
-    config: {
-      includes: undefined,
-      excludes: undefined,
-      dtsOutDir: undefined,
-      arbitraryExtensions: undefined,
-    },
+    config: {},
     diagnostics: [],
   };
   if (typeof raw !== 'object' || raw === null) return result;
@@ -126,10 +121,9 @@ function parseRawData(raw: unknown, configFileName: string): ParsedRawData {
         result.config.dtsOutDir = raw.cmkOptions.dtsOutDir;
       } else {
         result.diagnostics.push({
-          type: 'semantic',
           category: 'error',
-          text: '`dtsOutDir` must be a string.',
-          fileName: configFileName,
+          text: `\`dtsOutDir\` in ${tsConfigSourceFile.fileName} must be a string.`,
+          // MEMO: Location information can be obtained from `tsConfigSourceFile.statements`, but this is complicated and will be omitted.
         });
       }
     }
@@ -138,10 +132,31 @@ function parseRawData(raw: unknown, configFileName: string): ParsedRawData {
         result.config.arbitraryExtensions = raw.cmkOptions.arbitraryExtensions;
       } else {
         result.diagnostics.push({
-          type: 'semantic',
           category: 'error',
-          text: '`arbitraryExtensions` must be a boolean.',
-          fileName: configFileName,
+          text: `\`arbitraryExtensions\` in ${tsConfigSourceFile.fileName} must be a boolean.`,
+          // MEMO: Location information can be obtained from `tsConfigSourceFile.statements`, but this is complicated and will be omitted.
+        });
+      }
+    }
+    if ('namedExports' in raw.cmkOptions) {
+      if (typeof raw.cmkOptions.namedExports === 'boolean') {
+        result.config.namedExports = raw.cmkOptions.namedExports;
+      } else {
+        result.diagnostics.push({
+          category: 'error',
+          text: `\`namedExports\` in ${tsConfigSourceFile.fileName} must be a boolean.`,
+          // MEMO: Location information can be obtained from `tsConfigSourceFile.statements`, but this is complicated and will be omitted.
+        });
+      }
+    }
+    if ('prioritizeNamedImports' in raw.cmkOptions) {
+      if (typeof raw.cmkOptions.prioritizeNamedImports === 'boolean') {
+        result.config.prioritizeNamedImports = raw.cmkOptions.prioritizeNamedImports;
+      } else {
+        result.diagnostics.push({
+          category: 'error',
+          text: `\`prioritizeNamedImports\` in ${tsConfigSourceFile.fileName} must be a boolean.`,
+          // MEMO: Location information can be obtained from `tsConfigSourceFile.statements`, but this is complicated and will be omitted.
         });
       }
     }
@@ -157,6 +172,7 @@ function mergeParsedRawData(base: ParsedRawData, overrides: ParsedRawData): Pars
   if (overrides.config.dtsOutDir !== undefined) result.config.dtsOutDir = overrides.config.dtsOutDir;
   if (overrides.config.arbitraryExtensions !== undefined)
     result.config.arbitraryExtensions = overrides.config.arbitraryExtensions;
+  if (overrides.config.namedExports !== undefined) result.config.namedExports = overrides.config.namedExports;
   result.diagnostics.push(...overrides.diagnostics);
   return result;
 }
@@ -168,7 +184,7 @@ export function readTsConfigFile(project: string): {
   configFileName: string;
   config: UnnormalizedRawConfig;
   compilerOptions: ts.CompilerOptions;
-  diagnostics: SemanticDiagnostic[];
+  diagnostics: Diagnostic[];
 } {
   const configFileName = findTsConfigFile(project);
   if (!configFileName) throw new TsConfigFileNotFoundError();
@@ -195,7 +211,7 @@ export function readTsConfigFile(project: string): {
     ],
   );
   // Read options from `parsedCommandLine.raw`
-  let parsedRawData = parseRawData(parsedCommandLine.raw, configFileName);
+  let parsedRawData = parseRawData(parsedCommandLine.raw, tsConfigSourceFile);
 
   // The options read from `parsedCommandLine.raw` do not inherit values from the file specified in `extends`.
   // So here we read the options from those files and merge them into `parsedRawData`.
@@ -219,24 +235,6 @@ export function readTsConfigFile(project: string): {
   };
 }
 
-/**
- * Normalize `UnnormalizedRawConfig`. Resolve relative paths to absolute paths, and set default values for missing options.
- * @param basePath A root directory to resolve relative path entries in the config file to.
- */
-export function normalizeConfig(
-  config: UnnormalizedRawConfig,
-  basePath: string,
-): RemoveUndefined<UnnormalizedRawConfig> {
-  return {
-    // If `include` is not specified, fallback to the default include spec.
-    // ref: https://github.com/microsoft/TypeScript/blob/caf1aee269d1660b4d2a8b555c2d602c97cb28d7/src/compiler/commandLineParser.ts#L3102
-    includes: (config.includes ?? [DEFAULT_INCLUDE_SPEC]).map((i) => join(basePath, i)),
-    excludes: (config.excludes ?? []).map((e) => join(basePath, e)),
-    dtsOutDir: join(basePath, config.dtsOutDir ?? 'generated'),
-    arbitraryExtensions: config.arbitraryExtensions ?? false,
-  };
-}
-
 /**
  * Reads the `tsconfig.json` file and returns the normalized config.
  * Even if the `tsconfig.json` file contains syntax or semantic errors,
@@ -249,7 +247,14 @@ export function readConfigFile(project: string): CMKConfig {
   const { configFileName, config, compilerOptions, diagnostics } = readTsConfigFile(project);
   const basePath = dirname(configFileName);
   return {
-    ...normalizeConfig(config, basePath),
+    // If `include` is not specified, fallback to the default include spec.
+    // ref: https://github.com/microsoft/TypeScript/blob/caf1aee269d1660b4d2a8b555c2d602c97cb28d7/src/compiler/commandLineParser.ts#L3102
+    includes: (config.includes ?? [DEFAULT_INCLUDE_SPEC]).map((i) => join(basePath, i)),
+    excludes: (config.excludes ?? []).map((e) => join(basePath, e)),
+    dtsOutDir: join(basePath, config.dtsOutDir ?? 'generated'),
+    arbitraryExtensions: config.arbitraryExtensions ?? false,
+    namedExports: config.namedExports ?? false,
+    prioritizeNamedImports: config.prioritizeNamedImports ?? false,
     basePath,
     configFileName,
     compilerOptions,

package/src/diagnostic.ts

@@ -1,37 +1,77 @@
-export type DiagnosticCategory = 'error' | 'warning';
+import ts from 'typescript';
+import type { SystemError } from './error.js';
+import type { Diagnostic, DiagnosticSourceFile, DiagnosticWithLocation } from './type.js';
 
-export interface DiagnosticPosition {
-  /** The line number in the source file. It is 1-based. */
-  line: number;
-  /** The column number in the source file. It is 1-based. */
-  column: number;
-}
+/** The error code used by tsserver to display the css-modules-kit error in the editor. */
+const TS_ERROR_CODE = 0;
+
+const TS_ERROR_SOURCE = 'css-modules-kit';
 
-export type Diagnostic = SemanticDiagnostic | SyntacticDiagnostic;
+function convertErrorCategory(category: 'error' | 'warning' | 'suggestion'): ts.DiagnosticCategory {
+  switch (category) {
+    case 'error':
+      return ts.DiagnosticCategory.Error;
+    case 'warning':
+      return ts.DiagnosticCategory.Warning;
+    case 'suggestion':
+      return ts.DiagnosticCategory.Suggestion;
+    default:
+      throw new Error(`Unknown category: ${String(category)}`);
+  }
+}
 
-interface DiagnosticBase {
-  /** Text of diagnostic message. */
-  text: string;
-  /** The category of the diagnostic message. */
-  category: DiagnosticCategory;
+export function convertDiagnostic(
+  diagnostic: Diagnostic,
+  getSourceFile: (file: DiagnosticSourceFile) => ts.SourceFile,
+): ts.Diagnostic {
+  if ('file' in diagnostic) {
+    return convertDiagnosticWithLocation(diagnostic, getSourceFile);
+  } else {
+    return {
+      file: undefined,
+      start: undefined,
+      length: undefined,
+      category: convertErrorCategory(diagnostic.category),
+      messageText: diagnostic.text,
+      code: TS_ERROR_CODE,
+      source: TS_ERROR_SOURCE,
+    };
+  }
 }
 
-export interface SemanticDiagnostic extends DiagnosticBase {
-  type: 'semantic';
-  /** The filename of the file in which the diagnostic occurred */
-  fileName?: string;
-  /** Starting file position at which text applies. It is inclusive. */
-  start?: DiagnosticPosition;
-  /**  The last file position at which the text applies. It is exclusive. */
-  end?: DiagnosticPosition;
+export function convertDiagnosticWithLocation(
+  diagnostic: DiagnosticWithLocation,
+  getSourceFile: (file: DiagnosticSourceFile) => ts.SourceFile,
+): ts.DiagnosticWithLocation {
+  const sourceFile = getSourceFile(diagnostic.file);
+  const start = ts.getPositionOfLineAndCharacter(sourceFile, diagnostic.start.line - 1, diagnostic.start.column - 1);
+  return {
+    file: sourceFile,
+    start,
+    length: diagnostic.length,
+    category: convertErrorCategory(diagnostic.category),
+    messageText: diagnostic.text,
+    code: TS_ERROR_CODE,
+    source: TS_ERROR_SOURCE,
+  };
 }
 
-export interface SyntacticDiagnostic extends DiagnosticBase {
-  type: 'syntactic';
-  /** The filename of the file in which the diagnostic occurred */
-  fileName: string;
-  /** Starting file position at which text applies. It is inclusive. */
-  start: DiagnosticPosition;
-  /**  The last file position at which the text applies. It is exclusive. */
-  end?: DiagnosticPosition;
+export function convertSystemError(systemError: SystemError): ts.Diagnostic {
+  let messageText = systemError.message;
+  if (systemError.cause) {
+    if (systemError.cause instanceof Error) {
+      messageText += `: ${systemError.cause.message}`;
+    } else {
+      messageText += `: ${JSON.stringify(systemError.cause)}`;
+    }
+  }
+  return {
+    file: undefined,
+    start: undefined,
+    length: undefined,
+    category: ts.DiagnosticCategory.Error,
+    messageText,
+    code: TS_ERROR_CODE,
+    source: TS_ERROR_SOURCE,
+  };
 }