@css-modules-kit/core 0.6.0 → 0.8.0

package/src/config.ts

@@ -13,6 +13,7 @@ const DEFAULT_INCLUDE_SPEC = '**/*';
 export interface CMKConfig {
   includes: string[];
   excludes: string[];
+  enabled: boolean | undefined;
   dtsOutDir: string;
   arbitraryExtensions: boolean;
   namedExports: boolean;
@@ -58,6 +59,8 @@ export interface CMKConfig {
   basePath: string;
   configFileName: string;
   compilerOptions: ts.CompilerOptions;
+  /** The directories to watch when watch mode is enabled. */
+  wildcardDirectories: { fileName: string; recursive: boolean }[];
   /** The diagnostics that occurred while reading the config file. */
   diagnostics: Diagnostic[];
 }
@@ -69,6 +72,7 @@ export interface CMKConfig {
 interface UnnormalizedRawConfig {
   includes?: string[];
   excludes?: string[];
+  enabled?: boolean;
   dtsOutDir?: string;
   arbitraryExtensions?: boolean;
   namedExports?: boolean;
@@ -84,7 +88,7 @@ interface ParsedRawData {
   diagnostics: Diagnostic[];
 }
 
-export function findTsConfigFile(project: string): string | undefined {
+function findTsConfigFile(project: string): string | undefined {
   const configFile =
     ts.sys.directoryExists(project) ?
       ts.findConfigFile(project, ts.sys.fileExists.bind(ts.sys), 'tsconfig.json')
@@ -93,6 +97,11 @@ export function findTsConfigFile(project: string): string | undefined {
   return resolve(configFile);
 }
 
+function isTsConfigFileExists(fileName: string): boolean {
+  return ts.findConfigFile(dirname(fileName), ts.sys.fileExists.bind(ts.sys), basename(fileName)) !== undefined;
+}
+
+// eslint-disable-next-line complexity
 function parseRawData(raw: unknown, tsConfigSourceFile: ts.TsConfigSourceFile): ParsedRawData {
   const result: ParsedRawData = {
     config: {},
@@ -118,6 +127,16 @@ function parseRawData(raw: unknown, tsConfigSourceFile: ts.TsConfigSourceFile):
     // MEMO: The errors for this option are reported by `tsc` or `tsserver`, so we don't need to report.
   }
   if ('cmkOptions' in raw && typeof raw.cmkOptions === 'object' && raw.cmkOptions !== null) {
+    if ('enabled' in raw.cmkOptions) {
+      if (typeof raw.cmkOptions.enabled === 'boolean') {
+        result.config.enabled = raw.cmkOptions.enabled;
+      } else {
+        result.diagnostics.push({
+          category: 'error',
+          text: `\`enabled\` in ${tsConfigSourceFile.fileName} must be a boolean.`,
+        });
+      }
+    }
     if ('dtsOutDir' in raw.cmkOptions) {
       if (typeof raw.cmkOptions.dtsOutDir === 'string') {
         result.config.dtsOutDir = raw.cmkOptions.dtsOutDir;
@@ -175,21 +194,9 @@ function parseRawData(raw: unknown, tsConfigSourceFile: ts.TsConfigSourceFile):
   }
   return result;
 }
-export { parseRawData as parseRawDataForTest };
-
-/**
- * @throws {TsConfigFileNotFoundError}
- */
-export function readTsConfigFile(project: string): {
-  configFileName: string;
-  config: UnnormalizedRawConfig;
-  compilerOptions: ts.CompilerOptions;
-  diagnostics: Diagnostic[];
-} {
-  const configFileName = findTsConfigFile(project);
-  if (!configFileName) throw new TsConfigFileNotFoundError();
 
-  const tsConfigSourceFile = ts.readJsonConfigFile(configFileName, ts.sys.readFile.bind(ts.sys));
+function parseTsConfigFile(fileName: string) {
+  const tsConfigSourceFile = ts.readJsonConfigFile(fileName, ts.sys.readFile.bind(ts.sys));
   // MEMO: `tsConfigSourceFile.parseDiagnostics` (Internal API) contains a syntax error for `tsconfig.json`.
   // However, it is ignored so that ts-plugin will work even if `tsconfig.json` is somewhat broken.
   // Also, this error is reported to the user by `tsc` or `tsserver`.
@@ -198,9 +205,9 @@ export function readTsConfigFile(project: string): {
   const parsedCommandLine = ts.parseJsonSourceFileConfigFileContent(
     tsConfigSourceFile,
     ts.sys,
-    dirname(configFileName),
+    dirname(fileName),
     undefined,
-    configFileName,
+    fileName,
     undefined,
     [
       {
@@ -211,29 +218,15 @@ export function readTsConfigFile(project: string): {
     ],
   );
   // Read options from `parsedCommandLine.raw`
-  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`.
-  if (tsConfigSourceFile.extendedSourceFiles) {
-    for (const extendedSourceFile of tsConfigSourceFile.extendedSourceFiles) {
-      let base: ParsedRawData;
-      try {
-        base = readTsConfigFile(extendedSourceFile);
-      } catch (error) {
-        if (error instanceof TsConfigFileNotFoundError) continue;
-        throw error;
-      }
-      parsedRawData = {
-        config: { ...base.config, ...parsedRawData.config },
-        diagnostics: [...base.diagnostics, ...parsedRawData.diagnostics],
-      };
-    }
-  }
+  const parsedRawData = parseRawData(parsedCommandLine.raw, tsConfigSourceFile);
 
   return {
-    configFileName,
+    extendedSourceFiles: tsConfigSourceFile.extendedSourceFiles,
     compilerOptions: parsedCommandLine.options,
+    wildcardDirectories: Object.entries(parsedCommandLine.wildcardDirectories ?? {}).map(([fileName, flags]) => ({
+      fileName,
+      recursive: (flags & ts.WatchDirectoryFlags.Recursive) !== 0,
+    })),
     ...parsedRawData,
   };
 }
@@ -247,21 +240,39 @@ export function readTsConfigFile(project: string): {
  * @throws {TsConfigFileNotFoundError}
  */
 export function readConfigFile(project: string): CMKConfig {
-  const { configFileName, config, compilerOptions, diagnostics } = readTsConfigFile(project);
+  const configFileName = findTsConfigFile(project);
+  if (!configFileName) throw new TsConfigFileNotFoundError();
+
+  const parsedTsConfig = parseTsConfigFile(configFileName);
+
+  // 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`.
+  if (parsedTsConfig.extendedSourceFiles) {
+    for (const extendedSourceFile of parsedTsConfig.extendedSourceFiles) {
+      if (isTsConfigFileExists(extendedSourceFile)) {
+        const base = parseTsConfigFile(extendedSourceFile);
+        parsedTsConfig.config = { ...base.config, ...parsedTsConfig.config };
+        parsedTsConfig.diagnostics = [...base.diagnostics, ...parsedTsConfig.diagnostics];
+      }
+    }
+  }
+
   const basePath = dirname(configFileName);
   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,
-    namedExports: config.namedExports ?? false,
-    prioritizeNamedImports: config.prioritizeNamedImports ?? false,
-    keyframes: config.keyframes ?? true,
+    includes: (parsedTsConfig.config.includes ?? [DEFAULT_INCLUDE_SPEC]).map((i) => join(basePath, i)),
+    excludes: (parsedTsConfig.config.excludes ?? []).map((e) => join(basePath, e)),
+    dtsOutDir: join(basePath, parsedTsConfig.config.dtsOutDir ?? 'generated'),
+    arbitraryExtensions: parsedTsConfig.config.arbitraryExtensions ?? false,
+    namedExports: parsedTsConfig.config.namedExports ?? false,
+    prioritizeNamedImports: parsedTsConfig.config.prioritizeNamedImports ?? false,
+    keyframes: parsedTsConfig.config.keyframes ?? true,
+    enabled: parsedTsConfig.config.enabled,
     basePath,
     configFileName,
-    compilerOptions,
-    diagnostics,
+    compilerOptions: parsedTsConfig.compilerOptions,
+    wildcardDirectories: parsedTsConfig.wildcardDirectories,
+    diagnostics: parsedTsConfig.diagnostics,
   };
 }

package/src/diagnostic.ts

@@ -1,20 +1,18 @@
 import ts from 'typescript';
 import type { SystemError } from './error.js';
-import type { Diagnostic, DiagnosticSourceFile, DiagnosticWithLocation } from './type.js';
+import type { Diagnostic, DiagnosticCategory, DiagnosticSourceFile, DiagnosticWithLocation } from './type.js';
 
 /** 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';
 
-function convertErrorCategory(category: 'error' | 'warning' | 'suggestion'): ts.DiagnosticCategory {
+function convertErrorCategory(category: DiagnosticCategory): 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)}`);
   }

package/src/{dts-creator.ts → dts-generator.ts}

@@ -1,14 +1,9 @@
-import type { CSSModule, MatchesPattern, Resolver, Token, TokenImporter } from './type.js';
-import { isValidAsJSIdentifier } from './util.js';
+import type { CSSModule, Token, TokenImporter } from './type.js';
+import { isURLSpecifier, isValidAsJSIdentifier } from './util.js';
 
 export const STYLES_EXPORT_NAME = 'styles';
 
-export interface CreateDtsHost {
-  resolver: Resolver;
-  matchesPattern: MatchesPattern;
-}
-
-export interface CreateDtsOptions {
+export interface GenerateDtsOptions {
   namedExports: boolean;
   prioritizeNamedImports: boolean;
   /** Generate .d.ts for ts-plugin */
@@ -37,19 +32,19 @@ interface LinkedCodeMapping extends CodeMapping {
   generatedLengths: number[];
 }
 
-interface CreateDtsResult {
+interface GenerateDtsResult {
   text: string;
   mapping: CodeMapping;
   linkedCodeMapping: LinkedCodeMapping;
 }
 
 /**
- * Create a d.ts file.
+ * Generate .d.ts from `CSSModule`.
  */
-export function createDts(cssModules: CSSModule, host: CreateDtsHost, options: CreateDtsOptions): CreateDtsResult {
+export function generateDts(cssModule: CSSModule, options: GenerateDtsOptions): GenerateDtsResult {
   // Exclude invalid tokens
-  const localTokens = cssModules.localTokens.filter((token) => isValidName(token.name, options));
-  const tokenImporters = cssModules.tokenImporters
+  const localTokens = cssModule.localTokens.filter((token) => isValidName(token.name, options));
+  const tokenImporters = cssModule.tokenImporters
     // Exclude invalid imported tokens
     .map((tokenImporter) => {
       if (tokenImporter.type === 'value') {
@@ -65,21 +60,54 @@ export function createDts(cssModules: CSSModule, host: CreateDtsHost, options: C
         return tokenImporter;
       }
     })
-    // Exclude token importers for external files
     .filter((tokenImporter) => {
-      const resolved = host.resolver(tokenImporter.from, { request: cssModules.fileName });
-      return resolved !== undefined && host.matchesPattern(resolved);
+      /**
+       * In principle, token importers with specifiers that cannot be resolved are still included in the type
+       * definitions. For example, consider the following:
+       *
+       * ```css
+       * // src/a.module.css
+       * @import './unresolved.module.css';
+       * @import './unmatched.css';
+       * .a_1 { color: red; }
+       * ```
+       *
+       * In this case, CSS Modules Kit generates the following type definitions:
+       *
+       * ```ts
+       * // generated/src/a.module.css.d.ts
+       * // @ts-nocheck
+       * declare const styles = {
+       *   a_1: '' as readonly string,
+       *   ...(await import('./unresolved.module.css')).default,
+       *   ...(await import('./unmatched.css')).default,
+       * };
+       * ```
+       *
+       * Even if `./unresolved.module.css` or `./unmatched.css` does not exist, the same type definitions are
+       * generated. It is important that the generated type definitions do not change depending on whether the
+       * files exist. This provides the following benefits:
+       *
+       * - Simplifies the watch mode implementation
+       *   - Only the type definitions for changed files need to be regenerated
+       * - Makes it easier to parallelize code generation
+       *   - Type definitions can be generated independently per file
+       *
+       * However, as an exception, URL specifiers are not included in the type definitions, because URL
+       * specifiers are typically resolved at runtime.
+       */
+      return !isURLSpecifier(tokenImporter.from);
     });
 
   if (options.namedExports) {
-    return createNamedExportsDts(localTokens, tokenImporters, options);
+    return generateNamedExportsDts(localTokens, tokenImporters, options);
   } else {
-    return createDefaultExportDts(localTokens, tokenImporters);
+    return generateDefaultExportDts(localTokens, tokenImporters);
   }
 }
 
 /**
- * Create a d.ts file with named exports.
+ * Generate a d.ts file with named exports.
  * @example
  * If the CSS module file is:
  * ```css
@@ -100,10 +128,10 @@ export function createDts(cssModules: CSSModule, host: CreateDtsHost, options: C
  * } from './b.module.css';
  * ```
  */
-function createNamedExportsDts(
+function generateNamedExportsDts(
   localTokens: Token[],
   tokenImporters: TokenImporter[],
-  options: CreateDtsOptions,
+  options: GenerateDtsOptions,
 ): { text: string; mapping: CodeMapping; linkedCodeMapping: LinkedCodeMapping } {
   const mapping: CodeMapping = { sourceOffsets: [], lengths: [], generatedOffsets: [] };
   const linkedCodeMapping: LinkedCodeMapping = {
@@ -176,7 +204,7 @@ function createNamedExportsDts(
 }
 
 /**
- * Create a d.ts file with a default export.
+ * Generate a d.ts file with a default export.
  * @example
  * If the CSS module file is:
  * ```css
@@ -198,7 +226,7 @@ function createNamedExportsDts(
  * export default styles;
  * ```
  */
-function createDefaultExportDts(
+function generateDefaultExportDts(
   localTokens: Token[],
   tokenImporters: TokenImporter[],
 ): { text: string; mapping: CodeMapping; linkedCodeMapping: LinkedCodeMapping } {
@@ -215,8 +243,18 @@ function createDefaultExportDts(
   //
   // If `--skipLibCheck` is false, those errors will be reported by `tsc`. However, these are negligible errors.
   // Therefore, `@ts-nocheck` is added to the generated type definition file.
-  let text = `// @ts-nocheck\ndeclare const ${STYLES_EXPORT_NAME} = {\n`;
+  let text = `// @ts-nocheck\n`;
+
+  // This is a workaround to avoid the issue described as a "Drawbacks" in https://github.com/mizdra/css-modules-kit/pull/302.
+  // It uses the technique from https://stackoverflow.com/a/55541672 to fall back from `any` to `{}`.
+  // However, the import type for an unresolvable specifier becomes a special `any` type called `errorType`.
+  // The technique from https://stackoverflow.com/a/55541672 does not work with `errorType`.
+  // Therefore, this combines it with the approach from https://github.com/microsoft/TypeScript/issues/62972.
+  if (tokenImporters.some((importer) => importer.type === 'import')) {
+    text += `function blockErrorType<T>(val: T): [0] extends [(1 & T)] ? {} : T;\n`;
+  }
 
+  text += `declare const ${STYLES_EXPORT_NAME} = {\n`;
   for (const token of localTokens) {
     text += `  `;
     mapping.sourceOffsets.push(token.loc.start.offset);
@@ -226,11 +264,11 @@ function createDefaultExportDts(
   }
   for (const tokenImporter of tokenImporters) {
     if (tokenImporter.type === 'import') {
-      text += `  ...(await import(`;
+      text += `  ...blockErrorType((await import(`;
       mapping.sourceOffsets.push(tokenImporter.fromLoc.start.offset - 1);
       mapping.lengths.push(tokenImporter.from.length + 2);
       mapping.generatedOffsets.push(text.length);
-      text += `'${tokenImporter.from}')).default,\n`;
+      text += `'${tokenImporter.from}')).default),\n`;
     } else {
       // eslint-disable-next-line no-loop-func
       tokenImporter.values.forEach((value, i) => {
@@ -263,7 +301,7 @@ function createDefaultExportDts(
   return { text, mapping, linkedCodeMapping };
 }
 
-function isValidName(name: string, options: CreateDtsOptions): boolean {
+function isValidName(name: string, options: GenerateDtsOptions): boolean {
   if (!isValidAsJSIdentifier(name)) return false;
   if (name === '__proto__') return false;
   if (options.namedExports && name === 'default') return false;

package/src/index.ts

@@ -1,7 +1,7 @@
 export type { CMKConfig } from './config.js';
 export { readConfigFile } from './config.js';
 export { TsConfigFileNotFoundError, SystemError } from './error.js';
-export { parseCSSModule, type ParseCSSModuleOptions, type ParseCSSModuleResult } from './parser/css-module-parser.js';
+export { parseCSSModule, type ParseCSSModuleOptions } from './parser/css-module-parser.js';
 export { parseRule } from './parser/rule-parser.js';
 export {
   type Location,
@@ -15,13 +15,14 @@ export {
   type Resolver,
   type MatchesPattern,
   type ExportBuilder,
+  type ExportRecord,
   type DiagnosticSourceFile,
   type Diagnostic,
   type DiagnosticWithLocation,
   type DiagnosticCategory,
   type DiagnosticPosition,
 } from './type.js';
-export { type CreateDtsOptions, createDts, STYLES_EXPORT_NAME } from './dts-creator.js';
+export { type GenerateDtsOptions, generateDts, STYLES_EXPORT_NAME } from './dts-generator.js';
 export { createResolver } from './resolver.js';
 export {
   CSS_MODULE_EXTENSION,
@@ -33,8 +34,8 @@ export {
   createMatchesPattern,
   getFileNamesByPattern,
 } from './file.js';
-export { checkCSSModule } from './checker.js';
+export { checkCSSModule, type CheckerArgs } from './checker.js';
 export { createExportBuilder } from './export-builder.js';
-export { join, resolve, relative, dirname, basename, parse, isAbsolute } from './path.js';
+export { join, resolve, relative, dirname, basename, parse } from './path.js';
 export { findUsedTokenNames } from './util.js';
 export { convertDiagnostic, convertDiagnosticWithLocation, convertSystemError } from './diagnostic.js';

package/src/parser/css-module-parser.ts

@@ -78,48 +78,50 @@ function collectTokens(ast: Root, keyframes: boolean) {
 
 export interface ParseCSSModuleOptions {
   fileName: string;
-  safe: boolean;
+  /** Whether to include syntax errors from diagnostics */
+  includeSyntaxError: boolean;
   keyframes: boolean;
 }
-
-export interface ParseCSSModuleResult {
-  cssModule: CSSModule;
-  diagnostics: DiagnosticWithLocation[];
-}
-
+/**
+ * Parse CSS Module text.
+ * If a syntax error is detected in the text, it is re-parsed using `postcss-safe-parser`, and `localTokens` are collected as much as possible.
+ */
 export function parseCSSModule(
   text: string,
-  { fileName, safe, keyframes }: ParseCSSModuleOptions,
-): ParseCSSModuleResult {
+  { fileName, includeSyntaxError, keyframes }: ParseCSSModuleOptions,
+): CSSModule {
   let ast: Root;
-  const diagnosticSourceFile = { fileName, text };
-  try {
-    const parser = safe ? safeParser : parse;
-    ast = parser(text, { from: fileName });
-  } catch (e) {
-    if (e instanceof CssSyntaxError) {
+  const diagnosticFile = { fileName, text };
+  const allDiagnostics: DiagnosticWithLocation[] = [];
+  if (includeSyntaxError) {
+    try {
+      ast = parse(text, { from: fileName });
+    } catch (e) {
+      if (!(e instanceof CssSyntaxError)) throw e;
+      // If syntax error, try to parse with safe parser. While this incurs a cost
+      // due to parsing the file twice, it rarely becomes an issue since files
+      // with syntax errors are usually few in number.
+      ast = safeParser(text, { from: fileName });
       const { line, column, endColumn } = e.input!;
-      return {
-        cssModule: { fileName, text, localTokens: [], tokenImporters: [] },
-        diagnostics: [
-          {
-            file: diagnosticSourceFile,
-            start: { line, column },
-            length: endColumn !== undefined ? endColumn - column : 1,
-            text: e.reason,
-            category: 'error',
-          },
-        ],
-      };
+      allDiagnostics.push({
+        file: diagnosticFile,
+        start: { line, column },
+        length: endColumn !== undefined ? endColumn - column : 1,
+        text: e.reason,
+        category: 'error',
+      });
     }
-    throw e;
+  } else {
+    ast = safeParser(text, { from: fileName });
   }
+
   const { localTokens, tokenImporters, diagnostics } = collectTokens(ast, keyframes);
-  const cssModule = {
+  allDiagnostics.push(...diagnostics.map((diagnostic) => ({ ...diagnostic, file: diagnosticFile })));
+  return {
     fileName,
     text,
     localTokens,
     tokenImporters,
+    diagnostics: allDiagnostics,
   };
-  return { cssModule, diagnostics: diagnostics.map((diagnostic) => ({ ...diagnostic, file: diagnosticSourceFile })) };
 }

package/src/path.ts

@@ -32,6 +32,3 @@ export function parse(path: string): ParsedPath {
   const { root, dir, base, name, ext } = nodePath.parse(path);
   return { root: slash(root), dir: slash(dir), base, name, ext };
 }
-
-// eslint-disable-next-line @typescript-eslint/unbound-method
-export const isAbsolute = nodePath.isAbsolute;

package/src/resolver.ts

@@ -1,16 +1,14 @@
-import { fileURLToPath, pathToFileURL } from 'node:url';
 import type { CompilerOptions } from 'typescript';
 import ts from 'typescript';
-import { isAbsolute, resolve } from './path.js';
 import type { Resolver, ResolverOptions } from './type.js';
+import { isURLSpecifier } from './util.js';
 
 export function createResolver(
   compilerOptions: CompilerOptions,
   moduleResolutionCache: ts.ModuleResolutionCache | undefined,
 ): Resolver {
-  return (_specifier: string, options: ResolverOptions) => {
-    let specifier = _specifier;
-
+  return (specifier: string, options: ResolverOptions) => {
+    if (isURLSpecifier(specifier)) return undefined;
     const host: ts.ModuleResolutionHost = {
       ...ts.sys,
       fileExists: (fileName) => {
@@ -29,27 +27,8 @@ export function createResolver(
     );
     if (resolvedModule) {
       // TODO: Logging that the paths is used.
-      specifier = resolvedModule.resolvedFileName.replace(/\.module\.d\.css\.ts$/u, '.module.css');
-    }
-    if (isAbsolute(specifier)) {
-      return resolve(specifier);
-    } else if (isRelativeSpecifier(specifier)) {
-      // Convert the specifier to an absolute path
-      // NOTE: Node.js resolves relative specifier with standard relative URL resolution semantics. So we will follow that here as well.
-      // ref: https://nodejs.org/docs/latest-v23.x/api/esm.html#terminology
-      return resolve(fileURLToPath(new URL(specifier, pathToFileURL(options.request)).href));
-    } else {
-      // Do not support URL or bare specifiers
-      // TODO: Logging that the specifier could not resolve.
-      return undefined;
+      return resolvedModule.resolvedFileName.replace(/\.module\.d\.css\.ts$/u, '.module.css');
     }
+    return undefined;
   };
 }
-
-/**
- * Check if the specifier is a relative specifier.
- * @see https://nodejs.org/docs/latest-v23.x/api/esm.html#terminology
- */
-function isRelativeSpecifier(specifier: string): boolean {
-  return specifier.startsWith('./') || specifier.startsWith('../');
-}

package/src/type.ts

@@ -116,6 +116,8 @@ export interface CSSModule {
    * Token importer is a statement that imports tokens from another file.
    */
   tokenImporters: TokenImporter[];
+  /** Diagnostics found during parsing. */
+  diagnostics: DiagnosticWithLocation[];
 }
 
 export interface ResolverOptions {

package/src/util.ts

@@ -25,3 +25,7 @@ export function findUsedTokenNames(componentText: string): Set<string> {
   }
   return usedClassNames;
 }
+
+export function isURLSpecifier(specifier: string): boolean {
+  return URL.canParse(specifier);
+}

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

@@ -1 +0,0 @@
-{"version":3,"file":"dts-creator.d.ts","sourceRoot":"","sources":["../src/dts-creator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAwB,MAAM,WAAW,CAAC;AAG3F,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,sBAAsB,EAAE,OAAO,CAAC;IAChC,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,WAAW;IACnB,iEAAiE;IACjE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,8CAA8C;AAE9C,UAAU,iBAAkB,SAAQ,WAAW;IAC7C,iDAAiD;IACjD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA8BhH"}

package/dist/dts-creator.js.map

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