happy-css-modules 3.2.0 → 5.0.0

package/LICENSE.txt

@@ -0,0 +1,23 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 mizdra
+Copyright (c) [2016] [Yosuke Kurami]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -1,5 +1,310 @@
-# happy-css-modules
+<p align="center">
+  <img alt="Cover image" src="./docs/cover.svg" />
+</p>
+
+<h2 align="center">Happy CSS Modules</h2>
+
+<p align="center">
+  <em>Typed, definition jumpable CSS Modules.</em>
+  <br />
+  <em>Moreover, easy!</em>
+</p>
+
+https://user-images.githubusercontent.com/9639995/189538880-872ad38d-2c9d-4c19-b257-521018963eec.mov
+
+## NOTICE: Migration to css-modules-kit
+
+Consider migrating to [`mizdra/css-modules-kit`](https://github.com/mizdra/css-modules-kit), which is the successor to happy-css-modules. It offers enhanced features such as Renaming and Find All References support.
+
+Please note that `css-modules-kit` **does not support** Sass and Less. There are no plans to add support in the future. If you depend on these preprocessors, continue using `happy-css-modules`.
+
+See the [`css-modules-kit` repository](https://github.com/mizdra/css-modules-kit).
+
+## Features
+
+- :white_check_mark: Strict type checking
+  - Generate `.d.ts` of CSS Modules for type checking
+- :mag: Definition jumps
+  - Clicking on a property on `.jsx`/`.tsx` will jump to the source of the definition on `.module.css`.
+  - This is accomplished by generating `.d.ts.map` (a.k.a. [Declaration Map](https://www.typescriptlang.org/tsconfig#declarationMap)).
+- :handshake: High compatibility with the ecosystem
+  - Support for Postcss/Sass/Less
+  - Implement webpack-compatible resolving algorithms
+  - Also supports [`resolve.alias`](https://webpack.js.org/configuration/resolve/#resolvealias)
+- :beginner: Easy to use
+  - No configuration file, some simple CLI options
+
+## Installation
+
+```console
+$ npm i -D happy-css-modules
+```
 
 ## Usage
 
-See [https://github.com/mizdra/happy-css-modules](https://github.com/mizdra/happy-css-modules) for more information.
+In the simple case, everything goes well with the following!
+
+```console
+$ hcm 'src/**/*.module.{css,scss,less}'
+```
+
+If you want to customize the behavior, see `--help`.
+
+```console
+$ hcm --help
+Generate .d.ts and .d.ts.map for CSS modules.
+
+Usage: hcm [options] <glob>
+
+Options:
+  -w, --[no-]watch               Watch input directory's css files or pattern (default: false)
+      --localsConvention         Style of exported class names.
+                                 [choices: camelCase, camelCaseOnly, dashes, dashesOnly]
+      --[no-]declarationMap      Create sourcemaps for d.ts files (default: true)
+      --sassLoadPaths            The option compatible with sass's `--load-path`.
+      --lessIncludePaths         The option compatible with less's `--include-path`.
+      --webpackResolveAlias      The option compatible with webpack's `resolve.alias`.
+      --postcssConfig            The option compatible with postcss's `--config`.
+      --[no-]arbitraryExtensions Generate `.d.css.ts` instead of `.css.d.ts` (default: false)
+      --[no-]cache               Only generate .d.ts and .d.ts.map for changed files (default: true)
+      --cacheStrategy            Strategy for the cache to use for detecting changed files.
+                                 [choices: content, metadata] (default: content)
+      --logLevel                 What level of logs to report.
+                                 [choices: debug, info, silent] (default: info)
+  -o, --outDir                   Output directory for generated files.
+  -h, --help                     Show help
+  -v, --version                  Show version number
+
+Examples:
+  hcm 'src/**/*.module.css'
+  hcm 'src/**/*.module.{css,scss,less}'
+  hcm 'src/**/*.module.css' --watch
+  hcm 'src/**/*.module.css' --no-declarationMap
+  hcm 'src/**/*.module.css' --sassLoadPaths src/style
+  hcm 'src/**/*.module.css' --lessIncludePaths src/style
+  hcm 'src/**/*.module.css' --webpackResolveAlias '{"@": "src"}'
+  hcm 'src/**/*.module.css' --no-cache
+```
+
+## How docs definition jumps work?
+
+In addition to `.module.css.d.ts`, happy-css-modules also generates a `.module.css.d.ts.map` file (a.k.a. [Declaration Map](https://www.typescriptlang.org/tsconfig#declarationMap)). This file is a Source Map that contains code mapping information from generated (`.module.css.d.ts`) to source (`.module.css`).
+
+When tsserver (TypeScript Language Server for VSCode) tries to jump to the code on `.module.css.d.ts`, it restores the original location from this Source Map and redirects to the code on` .module.css`. happy-css-modules uses this mechanism to realize definition jump.
+
+![Illustration of how definition jump works](docs/how-does-definition-jumps-work/basic/flow.drawio.svg)
+
+The case of multiple definitions is a bit more complicated. This is because the Source Map specification does not allow for a 1:N mapping of the generated:original locations. Therefore, happy-css-modules define multiple definitions of the same property type and map each property to a different location in `.module.css`.
+
+![Illustration of a case with multiple definitions](docs/how-does-definition-jumps-work/multiple-definitions/flow.drawio.svg)
+
+## How to use `--outDir` option
+
+Use `--outDir` to output `.module.css.d.ts` and `.module.css.d.ts.map` in a separate directory. This is useful for keeping the `src/` directory clean.
+
+However, by default tsc and tsserver cannot load it. To enable tsc or tsserver to load them, use the [`rootDirs`](https://www.typescriptlang.org/tsconfig/#rootDirs) option in `tsconfig.json`. An example is given below.
+
+```json
+// package.json
+{
+  "scripts": {
+    "gen": "hcm -o generated/hcm 'src/**/*.module.css'"
+  }
+}
+```
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "rootDirs": ["src", "generated/hcm/src"]
+  }
+}
+```
+
+## Node.js API (Experimental)
+
+> **Warning**
+> This feature is experimental and may change significantly. The API is not stable and may have breaking changes even in minor or patch version updates.
+
+`happy-css-modules` provides Node.js API for programmatically generating .d.ts and .d.ts.map.
+
+See [src/index.ts](https://github.com/mizdra/happy-css-modules/blob/main/src/index.ts) for available API.
+
+### Example: Custom `hcm` commands
+
+You can create your own customized `hcm` commands. We also provide a `parseArgv` utility that parses `process.argv` and extracts options.
+
+```javascript
+#!/usr/bin/env ts-node
+// scripts/hcm.ts
+
+import { run, parseArgv } from 'happy-css-modules';
+
+// Write your code here...
+
+run({
+  // Inherit default CLI options (e.g. --watch).
+  ...parseArgv(process.argv),
+  // Add custom CLI options.
+  cwd: __dirname,
+}).catch((e) => {
+  console.error(e);
+  process.exit(1);
+});
+```
+
+### Example: Custom transformer
+
+With the `transformer` option, you can use AltCSS, which is not supported by `happy-css-modules`.
+
+```typescript
+#!/usr/bin/env ts-node
+
+import { run, parseArgv, createDefaultTransformer, type Transformer } from 'happy-css-modules';
+import sass from 'sass';
+import { promisify } from 'util';
+
+const defaultTransformer = createDefaultTransformer();
+const render = promisify(sass.render);
+
+// The custom transformer supporting sass indented syntax
+const transformer: Transformer = async (source, options) => {
+  if (from.endsWith('.sass')) {
+    const result = await render({
+      // Use indented syntax.
+      // ref: https://sass-lang.com/documentation/syntax#the-indented-syntax
+      indentedSyntax: true,
+      data: source,
+      file: options.from,
+      outFile: 'DUMMY',
+      // Output sourceMap.
+      sourceMap: true,
+      // Resolve import specifier using resolver.
+      importer: (url, prev, done) => {
+        options
+          .resolver(url, { request: prev })
+          .then((resolved) => done({ file: resolved }))
+          .catch((e) => done(e));
+      },
+    });
+    return { css: result.css, map: result.sourceMap!, dependencies: result.loadedUrls };
+  }
+  // Fallback to default transformer.
+  return await defaultTransformer(source, from);
+};
+
+run({ ...parseArgv(process.argv), transformer }).catch((e) => {
+  console.error(e);
+  process.exit(1);
+});
+```
+
+### Example: Custom resolver
+
+With the `resolver` option, you can customize the resolution algorithm for import specifier (such as `@import "specifier"`).
+
+```typescript
+#!/usr/bin/env ts-node
+
+import { run, parseArgv, createDefaultResolver, type Resolver } from 'happy-css-modules';
+import { exists } from 'fs/promises';
+import { resolve, join } from 'path';
+
+const cwd = process.cwd();
+const runnerOptions = parseArgv(process.argv);
+const { sassLoadPaths, lessIncludePaths, webpackResolveAlias } = runnerOptions;
+// Some runner options must be passed to the default resolver.
+const defaultResolver = createDefaultResolver({ cwd, sassLoadPaths, lessIncludePaths, webpackResolveAlias });
+const stylesDir = resolve(__dirname, 'src/styles');
+
+const resolver: Resolver = async (specifier, options) => {
+  // If the default resolver cannot resolve, fallback to a customized resolve algorithm.
+  const resolvedByDefaultResolver = await defaultResolver(specifier, options);
+  if (resolvedByDefaultResolver === false) {
+    // Search for files in `src/styles` directory.
+    const path = join(stylesDir, specifier);
+    if (await exists(path)) return path;
+  }
+  // Returns `false` if specifier cannot be resolved.
+  return false;
+};
+
+run({ ...runnerOptions, resolver, cwd }).catch((e) => {
+  console.error(e);
+  process.exit(1);
+});
+```
+
+### Example: Get locations for selectors exported by CSS Modules
+
+`Locator` can be used to get location for selectors exported by CSS Modules.
+
+```typescript
+import { Locator } from 'happy-css-modules';
+import { resolve } from 'path';
+import assert from 'assert';
+
+const locator = new Locator({
+  // You can customize the transformer and resolver used by the locator.
+  // transformer: createDefaultTransformer(),
+  // resolver: createDefaultResolver(),
+});
+
+// Process https://github.com/mizdra/happy-css-modules/blob/main/example/02-import/2.css
+const filePath = resolve('example/02-import/2.css'); // Convert to absolute path
+const result = await locator.load(filePath);
+
+assert.deepEqual(result, {
+  dependencies: ['/Users/mizdra/src/github.com/mizdra/example/02-import/3.css'],
+  tokens: [
+    {
+      name: 'b',
+      originalLocation: {
+        filePath: '/Users/mizdra/src/github.com/mizdra/example/02-import/3.css',
+        start: { line: 1, column: 1 },
+        end: { line: 1, column: 2 },
+      },
+    },
+    {
+      name: 'a',
+      originalLocation: {
+        filePath: '/Users/mizdra/src/github.com/mizdra/example/02-import/2.css',
+        start: { line: 3, column: 1 },
+        end: { line: 3, column: 2 },
+      },
+    },
+  ],
+});
+```
+
+## About the origins of this project
+
+This project was born as a PoC for [Quramy/typed-css-modules#177](https://github.com/Quramy/typed-css-modules/issues/177). That is why this project forks [`Quramy/typed-css-modules`](https://github.com/Quramy/typed-css-modules). Due to refactoring, only a small amount of code now comes from `Quramy/typed-css-modules`, but its contributions can still be found in the credits of the license.
+
+Thank you [@Quramy](https://github.com/Quramy)!
+
+## Prior art
+
+There is a lot of excellent prior art.
+
+- ✅ Supported
+- 🔶 Partially supported
+- 🛑 Not supported
+- ❓ Unknown
+
+| Repository                                                                                        | Strict type checking | Definition jumps | Sass | Less | `resolve.alias` |              How implemented              |
+| :------------------------------------------------------------------------------------------------ | :------------------: | :--------------: | :--: | :--: | :-------------: | :---------------------------------------: |
+| [Quramy/typed-css-modules](https://github.com/Quramy/typed-css-modules)                           |          ✅          |        🛑        |  🛑  |  🛑  |       🛑        |                 CLI Tool                  |
+| [skovy/typed-scss-modules](https://github.com/skovy/typed-scss-modules)                           |          ✅          |        🛑        |  ✅  |  🛑  |       🛑        |                 CLI Tool                  |
+| [qiniu/typed-less-modules](https://github.com/qiniu/typed-less-modules)                           |          ✅          |        🛑        |  🛑  |  ✅  |       🛑        |                 CLI Tool                  |
+| [mrmckeb/typescript-plugin-css-modules](https://github.com/mrmckeb/typescript-plugin-css-modules) |   🔶<sup>\*1</sup>   | 🔶<sup>\*2</sup> |  ✅  |  ✅  |       🛑        | TypeScript Language Service<sup>\*3</sup> |
+| [clinyong/vscode-css-modules](https://github.com/clinyong/vscode-css-modules)                     |          🛑          |        ✅        |  ✅  |  ✅  |       🛑        |             VSCode Extension              |
+| [Viijay-Kr/react-ts-css](https://github.com/Viijay-Kr/react-ts-css)                               |   🔶<sup>\*1</sup>   |        ✅        |  ✅  |  ✅  |       ❓        |             VSCode Extension              |
+| [mizdra/happy-css-modules](https://github.com/mizdra/happy-css-modules)                           |          ✅          |        ✅        |  ✅  |  ✅  |       ✅        |        CLI Tool + Declaration Map         |
+
+- \*1: Warnings are displayed in the editor, but not at compile time.
+- \*2: Not supported for `.less` definition jumps.
+- \*3: The TypeScript language service can display warnings in the editor, but not at compile time. It is also complicated to set up.
+
+Another known tool for generating `.css.d.ts` is [wix/stylable](https://github.com/wix/stylable) , which does not use CSS Modules.

package/bin/hcm.js

@@ -3,7 +3,7 @@
 import { run, parseArgv } from '../dist/index.js';
 
 run(parseArgv(process.argv)).catch((e) => {
-  // eslint-disable-next-line no-console
+  // oxlint-disable-next-line no-console
   console.error(e);
   process.exit(1);
 });

package/dist/cli.d.ts

@@ -1,6 +1,2 @@
 import { type RunnerOptions } from './runner.js';
-/**
- * Parse command line arguments.
- * @returns Runner options.
- */
 export declare function parseArgv(argv: string[]): RunnerOptions;

package/dist/cli.js

@@ -1,127 +1,120 @@
-import yargs from 'yargs';
-import { hideBin } from 'yargs/helpers';
+import { parseArgs } from 'node:util';
 import { DEFAULT_ARBITRARY_EXTENSIONS } from './config.js';
 import { getPackageJson } from './util.js';
-/**
- * Parse command line arguments.
- * @returns Runner options.
- */
+const HELP_TEXT = `
+Generate .d.ts and .d.ts.map for CSS modules.
+
+Usage: hcm [options] <glob>
+
+Options:
+  -w, --[no-]watch               Watch input directory's css files or pattern (default: false)
+      --localsConvention         Style of exported class names.
+                                 [choices: camelCase, camelCaseOnly, dashes, dashesOnly]
+      --[no-]declarationMap      Create sourcemaps for d.ts files (default: true)
+      --sassLoadPaths            The option compatible with sass's \`--load-path\`.
+      --lessIncludePaths         The option compatible with less's \`--include-path\`.
+      --webpackResolveAlias      The option compatible with webpack's \`resolve.alias\`.
+      --postcssConfig            The option compatible with postcss's \`--config\`.
+      --[no-]arbitraryExtensions Generate \`.d.css.ts\` instead of \`.css.d.ts\` (default: false)
+      --[no-]cache               Only generate .d.ts and .d.ts.map for changed files (default: true)
+      --cacheStrategy            Strategy for the cache to use for detecting changed files.
+                                 [choices: content, metadata] (default: content)
+      --logLevel                 What level of logs to report.
+                                 [choices: debug, info, silent] (default: info)
+  -o, --outDir                   Output directory for generated files.
+  -h, --help                     Show help
+  -v, --version                  Show version number
+
+Examples:
+  hcm 'src/**/*.module.css'
+  hcm 'src/**/*.module.{css,scss,less}'
+  hcm 'src/**/*.module.css' --watch
+  hcm 'src/**/*.module.css' --no-declarationMap
+  hcm 'src/**/*.module.css' --sassLoadPaths src/style
+  hcm 'src/**/*.module.css' --lessIncludePaths src/style
+  hcm 'src/**/*.module.css' --webpackResolveAlias '{"@": "src"}'
+  hcm 'src/**/*.module.css' --no-cache
+`.trim();
 export function parseArgv(argv) {
     const pkgJson = getPackageJson();
-    const parsedArgv = yargs(hideBin(argv))
-        .wrap(Math.min(140, process.stdout.columns))
-        .scriptName('hcm')
-        .usage('Generate .d.ts and .d.ts.map for CSS modules.\n\n$0 [options] <glob>')
-        .example("$0 'src/**/*.module.css'", 'Generate .d.ts and .d.ts.map.')
-        .example("$0 'src/**/*.module.{css,scss,less}'", 'Also generate files for sass and less.')
-        .example("$0 'src/**/*.module.css' --watch", 'Watch for changes and generate .d.ts and .d.ts.map.')
-        .example("$0 'src/**/*.module.css' --declarationMap=false", 'Generate .d.ts only.')
-        .example("$0 'src/**/*.module.css' --sassLoadPaths=src/style", "Run with sass's `--load-path`.")
-        .example("$0 'src/**/*.module.css' --lessIncludePaths=src/style", "Run with less's `--include-path`.")
-        .example('$0 \'src/**/*.module.css\' --webpackResolveAlias=\'{"@": "src"}\'', "Run with webpack's `resolve.alias`.")
-        .example("$0 'src/**/*.module.css' --cache=false", 'Disable cache.')
-        .detectLocale(false)
-        .option('watch', {
-        type: 'boolean',
-        alias: 'w',
-        default: false,
-        describe: "Watch input directory's css files or pattern",
-    })
-        .option('localsConvention', {
-        choices: ['camelCase', 'camelCaseOnly', 'dashes', 'dashesOnly'],
-        describe: 'Style of exported class names.',
-    })
-        .option('declarationMap', {
-        type: 'boolean',
-        default: true,
-        describe: 'Create sourcemaps for d.ts files',
-    })
-        .option('sassLoadPaths', {
-        array: true,
-        nargs: 1,
-        describe: "The option compatible with sass's `--load-path`.",
-    })
-        .option('lessIncludePaths', {
-        array: true,
-        nargs: 1,
-        describe: "The option compatible with less's `--include-path`.",
-    })
-        .option('webpackResolveAlias', {
-        string: true,
-        describe: "The option compatible with webpack's `resolve.alias`.",
-    })
-        // TODO: Support --noPostcssConfig option.
-        .option('postcssConfig', {
-        string: true,
-        describe: "The option compatible with postcss's `--config`.",
-    })
-        .option('arbitraryExtensions', {
-        type: 'boolean',
-        default: DEFAULT_ARBITRARY_EXTENSIONS,
-        describe: 'Generate `.d.css.ts` instead of `.css.d.ts`.',
-    })
-        .option('cache', {
-        type: 'boolean',
-        default: true,
-        describe: 'Only generate .d.ts and .d.ts.map for changed files.',
-    })
-        .option('cacheStrategy', {
-        choices: ['content', 'metadata'],
-        // NOTE: This is a workaround for `parsedArgv.cacheStrategy` type breaks.
-        default: 'content',
-        describe: 'Strategy for the cache to use for detecting changed files.',
-    })
-        .option('logLevel', {
-        choices: ['debug', 'info', 'silent'],
-        default: 'info',
-        describe: 'What level of logs to report.',
-    })
-        .option('outDir', {
-        type: 'string',
-        alias: 'o',
-        describe: 'Output directory for generated files.',
-    })
-        .alias('h', 'help')
-        .alias('v', 'version')
-        .version(pkgJson.version)
-        .check((argv) => {
-        const patterns = argv._;
-        // TODO: support multiple patterns
-        if (patterns.length !== 1)
-            throw new Error('Only one pattern is allowed.');
-        if (argv.webpackResolveAlias) {
-            let parsedWebpackResolveAlias;
-            try {
-                parsedWebpackResolveAlias = JSON.parse(argv.webpackResolveAlias);
-            }
-            catch (e) {
-                throw new Error('--webpackResolveAlias must be a valid JSON string.');
-            }
-            if (typeof parsedWebpackResolveAlias !== 'object' || parsedWebpackResolveAlias === null)
-                throw new Error('--webpackResolveAlias must be an object');
-            if (!Object.keys(parsedWebpackResolveAlias).every((key) => typeof key === 'string'))
-                throw new Error('--webpackResolveAlias must be an object of string keys');
-            if (!Object.values(parsedWebpackResolveAlias).every((value) => typeof value === 'string'))
-                throw new Error('--webpackResolveAlias must be an object of string values');
+    const { values, positionals } = parseArgs({
+        args: argv.slice(2),
+        options: {
+            watch: { type: 'boolean', short: 'w', default: false },
+            localsConvention: { type: 'string' },
+            declarationMap: { type: 'boolean', default: true },
+            sassLoadPaths: { type: 'string', multiple: true },
+            lessIncludePaths: { type: 'string', multiple: true },
+            webpackResolveAlias: { type: 'string' },
+            postcssConfig: { type: 'string' },
+            arbitraryExtensions: { type: 'boolean', default: DEFAULT_ARBITRARY_EXTENSIONS },
+            cache: { type: 'boolean', default: true },
+            cacheStrategy: { type: 'string', default: 'content' },
+            logLevel: { type: 'string', default: 'info' },
+            outDir: { type: 'string', short: 'o' },
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean', short: 'v' },
+        },
+        allowPositionals: true,
+        allowNegative: true,
+    });
+    if (values.help) {
+        // oxlint-disable-next-line no-console
+        console.log(HELP_TEXT);
+        // oxlint-disable-next-line unicorn/no-process-exit
+        process.exit(0);
+    }
+    if (values.version) {
+        // oxlint-disable-next-line no-console
+        console.log(pkgJson.version);
+        // oxlint-disable-next-line unicorn/no-process-exit
+        process.exit(0);
+    }
+    if (positionals.length !== 1)
+        throw new Error('Only one pattern is allowed.');
+    const validLocalsConventions = ['camelCase', 'camelCaseOnly', 'dashes', 'dashesOnly'];
+    if (values.localsConvention !== undefined && !validLocalsConventions.includes(values.localsConvention)) {
+        throw new Error(`--localsConvention must be one of: ${validLocalsConventions.join(', ')}`);
+    }
+    const validCacheStrategies = ['content', 'metadata'];
+    if (!validCacheStrategies.includes(values.cacheStrategy)) {
+        throw new Error(`--cacheStrategy must be one of: ${validCacheStrategies.join(', ')}`);
+    }
+    const validLogLevels = ['debug', 'info', 'silent'];
+    if (!validLogLevels.includes(values.logLevel)) {
+        throw new Error(`--logLevel must be one of: ${validLogLevels.join(', ')}`);
+    }
+    let webpackResolveAlias;
+    if (values.webpackResolveAlias) {
+        let parsed;
+        try {
+            parsed = JSON.parse(values.webpackResolveAlias);
         }
-        return true;
-    })
-        .parseSync();
-    const patterns = parsedArgv._.map((pattern) => pattern.toString());
+        catch {
+            throw new Error('--webpackResolveAlias must be a valid JSON string.');
+        }
+        if (typeof parsed !== 'object' || parsed === null)
+            throw new Error('--webpackResolveAlias must be an object');
+        if (!Object.keys(parsed).every((key) => typeof key === 'string'))
+            throw new Error('--webpackResolveAlias must be an object of string keys');
+        if (!Object.values(parsed).every((value) => typeof value === 'string'))
+            throw new Error('--webpackResolveAlias must be an object of string values');
+        webpackResolveAlias = parsed;
+    }
     return {
-        pattern: patterns[0],
-        watch: parsedArgv.watch,
-        localsConvention: parsedArgv.localsConvention,
-        declarationMap: parsedArgv.declarationMap,
-        sassLoadPaths: parsedArgv.sassLoadPaths?.map((item) => item.toString()),
-        lessIncludePaths: parsedArgv.lessIncludePaths?.map((item) => item.toString()),
-        webpackResolveAlias: parsedArgv.webpackResolveAlias ? JSON.parse(parsedArgv.webpackResolveAlias) : undefined,
-        postcssConfig: parsedArgv.postcssConfig,
-        arbitraryExtensions: parsedArgv.arbitraryExtensions,
-        cache: parsedArgv.cache,
-        cacheStrategy: parsedArgv.cacheStrategy,
-        logLevel: parsedArgv.logLevel,
-        outDir: parsedArgv.outDir,
+        pattern: positionals[0],
+        watch: values.watch,
+        localsConvention: values.localsConvention,
+        declarationMap: values.declarationMap,
+        sassLoadPaths: values.sassLoadPaths,
+        lessIncludePaths: values.lessIncludePaths,
+        webpackResolveAlias,
+        postcssConfig: values.postcssConfig,
+        arbitraryExtensions: values.arbitraryExtensions,
+        cache: values.cache,
+        cacheStrategy: values.cacheStrategy,
+        logLevel: values.logLevel,
+        outDir: values.outDir,
     };
 }
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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