happy-css-modules 3.1.0 → 3.2.0

package/dist/transformer/scss-transformer.test.js

@@ -0,0 +1,149 @@
+import { jest } from '@jest/globals';
+import dedent from 'dedent';
+import { Locator } from '../locator/index.js';
+import { createFixtures, getFixturePath } from '../test-util/util.js';
+import { createScssTransformer } from './scss-transformer.js';
+const locator = new Locator({ transformer: createScssTransformer() });
+const loadSpy = jest.spyOn(locator, 'load');
+afterEach(() => {
+    loadSpy.mockClear();
+});
+test('handles sass features', async () => {
+    createFixtures({
+        '/test/1.scss': dedent `
+      @use './2.scss' as two; // sass feature test (@use)
+      @import './3.scss'; // css feature test (@import)
+      .a_1 { dummy: ''; }
+      .a_2 {
+        dummy: '';
+        // sass feature test (nesting)
+        .a_2_1 { dummy: ''; }
+        &_2 { dummy: ''; }
+      }
+      `,
+        '/test/2.scss': dedent `
+      .b_1 { dummy: ''; }
+      @mixin b_2 { dummy: ''; }
+      `,
+        '/test/3.scss': dedent `
+      .c { dummy: ''; }
+      `,
+        '/test/4.scss': dedent `
+      .d { dummy: ''; }
+      `,
+    });
+    const result = await locator.load(getFixturePath('/test/1.scss'));
+    // NOTE: There should be only one originalLocations for 'a_2', but there are multiple.
+    // This is probably due to an incorrect sourcemap output by the sass compiler.
+    // FIXME: The sass compiler or Loader implementation needs to be fixed.
+    // FIXME: The end position of 'a_2_2' is incorrect.
+    expect(result).toMatchInlineSnapshot(`
+    {
+      dependencies: ["<fixtures>/test/2.scss", "<fixtures>/test/3.scss"],
+      tokens: [
+        {
+          name: "b_1",
+          originalLocation: {
+            filePath: "<fixtures>/test/2.scss",
+            start: { line: 1, column: 1 },
+            end: { line: 1, column: 4 },
+          },
+        },
+        {
+          name: "c",
+          originalLocation: {
+            filePath: "<fixtures>/test/3.scss",
+            start: { line: 1, column: 1 },
+            end: { line: 1, column: 2 },
+          },
+        },
+        {
+          name: "a_1",
+          originalLocation: {
+            filePath: "<fixtures>/test/1.scss",
+            start: { line: 3, column: 1 },
+            end: { line: 3, column: 4 },
+          },
+        },
+        {
+          name: "a_2",
+          originalLocation: {
+            filePath: "<fixtures>/test/1.scss",
+            start: { line: 4, column: 1 },
+            end: { line: 4, column: 4 },
+          },
+        },
+        {
+          name: "a_2",
+          originalLocation: {
+            filePath: "<fixtures>/test/1.scss",
+            start: { line: 7, column: 3 },
+            end: { line: 7, column: 6 },
+          },
+        },
+        {
+          name: "a_2_1",
+          originalLocation: {
+            filePath: "<fixtures>/test/1.scss",
+            start: { line: 7, column: 3 },
+            end: { line: 7, column: 8 },
+          },
+        },
+        {
+          name: "a_2_2",
+          originalLocation: {
+            filePath: "<fixtures>/test/1.scss",
+            start: { line: 8, column: 3 },
+            end: { line: 8, column: 8 },
+          },
+        },
+      ],
+    }
+  `);
+});
+test('tracks dependencies that have been pre-bundled by sass compiler', async () => {
+    createFixtures({
+        '/test/1.scss': dedent `
+    @import './2.scss';
+    @import './3.scss';
+    `,
+        '/test/2.scss': dedent `
+    `,
+        '/test/3.scss': dedent `
+    @import './4.scss';
+    `,
+        '/test/4.scss': dedent `
+    `,
+    });
+    const result = await locator.load(getFixturePath('/test/1.scss'));
+    // The files imported using @import are pre-bundled by the compiler.
+    // Therefore, `Locator#load` is not called to process other files.
+    expect(loadSpy).toBeCalledTimes(1);
+    expect(loadSpy).toHaveBeenNthCalledWith(1, getFixturePath('/test/1.scss'));
+    // The files pre-bundled by the compiler are also included in `result.dependencies`
+    expect(result.dependencies).toStrictEqual(['/test/2.scss', '/test/3.scss', '/test/4.scss'].map(getFixturePath));
+});
+test('resolves specifier using resolver', async () => {
+    createFixtures({
+        '/test/1.scss': dedent `
+    @import 'package-1';
+    @import 'package-2';
+    `,
+        '/node_modules/package-1/index.css': `.a {}`,
+        '/node_modules/package-2/index.scss': `.a {}`,
+    });
+    const result = await locator.load(getFixturePath('/test/1.scss'));
+    expect(result.dependencies).toStrictEqual(['/node_modules/package-1/index.css', '/node_modules/package-2/index.scss'].map(getFixturePath));
+});
+test('ignores http(s) protocol file', async () => {
+    createFixtures({
+        '/test/1.scss': dedent `
+    @import 'http://example.com/path/http.css';
+    @import 'https://example.com/path/https.css';
+    @import 'https://example.com/path/scss.scss';
+    `,
+    });
+    const result = await locator.load(getFixturePath('/test/1.scss'));
+    expect(result.dependencies).toStrictEqual([]);
+});
+//# sourceMappingURL=scss-transformer.test.js.map

package/dist/transformer/scss-transformer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scss-transformer.test.js","sourceRoot":"","sources":["../../src/transformer/scss-transformer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;AACtE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAE5C,SAAS,CAAC,GAAG,EAAE;IACb,OAAO,CAAC,SAAS,EAAE,CAAC;AACtB,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;IACvC,cAAc,CAAC;QACb,cAAc,EAAE,MAAM,CAAA;;;;;;;;;;OAUnB;QACH,cAAc,EAAE,MAAM,CAAA;;;OAGnB;QACH,cAAc,EAAE,MAAM,CAAA;;OAEnB;QACH,cAAc,EAAE,MAAM,CAAA;;OAEnB;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;IAElE,sFAAsF;IACtF,8EAA8E;IAC9E,uEAAuE;IAEvE,mDAAmD;IACnD,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DpC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;IACjF,cAAc,CAAC;QACb,cAAc,EAAE,MAAM,CAAA;;;KAGrB;QACD,cAAc,EAAE,MAAM,CAAA;KACrB;QACD,cAAc,EAAE,MAAM,CAAA;;KAErB;QACD,cAAc,EAAE,MAAM,CAAA;KACrB;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;IAElE,oEAAoE;IACpE,kEAAkE;IAClE,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,OAAO,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;IAE3E,mFAAmF;IACnF,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAClH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;IACnD,cAAc,CAAC;QACb,cAAc,EAAE,MAAM,CAAA;;;KAGrB;QACD,mCAAmC,EAAE,OAAO;QAC5C,oCAAoC,EAAE,OAAO;KAC9C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,aAAa,CACvC,CAAC,mCAAmC,EAAE,oCAAoC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAChG,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;IAC/C,cAAc,CAAC;QACb,cAAc,EAAE,MAAM,CAAA;;;;KAIrB;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The SystemError type of Node.js.
+ * @see https://nodejs.org/api/errors.html#class-systemerror
+ */
+export interface SystemError {
+    code: string;
+}
+export declare function isSystemError(value: unknown): value is SystemError;
+export declare function isObject(value: unknown): value is object;
+export declare function hasProp<T extends string>(obj: object, prop: T): obj is {
+    [key in T]: unknown;
+};
+export declare function unique<T>(array: T[]): T[];
+export declare function uniqueBy<T, U>(arr: T[], fn: (el: T) => U): T[];
+export declare function sleepSync(ms: number): void;
+export declare function exists(path: string): Promise<boolean>;
+export declare function isMatchByGlob(filePath: string, pattern: string, options: {
+    cwd: string;
+}): boolean;
+export declare function getPackageJson(): any;
+export declare function getInstalledPeerDependencies(): string[];

package/dist/util.js

@@ -0,0 +1,72 @@
+import { constants, readFileSync } from 'fs';
+import { access } from 'fs/promises';
+import { join, dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { resolve as importMetaResolve } from 'import-meta-resolve';
+import { minimatch } from 'minimatch';
+export function isSystemError(value) {
+    return (isObject(value) &&
+        hasProp(value, 'constructor') &&
+        isObject(value.constructor) &&
+        hasProp(value.constructor, 'name') &&
+        value.constructor.name === 'Error' &&
+        hasProp(value, 'code') &&
+        typeof value.code === 'string');
+}
+export function isObject(value) {
+    return (typeof value === 'object' || typeof value === 'function') && value !== null;
+}
+export function hasProp(obj, prop) {
+    return prop in obj;
+}
+export function unique(array) {
+    return [...new Set(array)];
+}
+export function uniqueBy(arr, fn) {
+    const result = [];
+    const keys = new Set();
+    for (const el of arr) {
+        const key = fn(el);
+        if (!keys.has(key)) {
+            keys.add(key);
+            result.push(el);
+        }
+    }
+    return result;
+}
+export function sleepSync(ms) {
+    const start = Date.now();
+    // eslint-disable-next-line no-empty
+    while (Date.now() - start < ms) { }
+}
+export async function exists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+}
+export function isMatchByGlob(filePath, pattern, options) {
+    return minimatch(filePath, join(options.cwd, pattern), { windowsPathsNoEscape: true });
+}
+export function getPackageJson() {
+    return JSON.parse(readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf-8'));
+}
+export function getInstalledPeerDependencies() {
+    const pkgJson = getPackageJson();
+    const result = [];
+    for (const deps of Object.keys(pkgJson.peerDependencies)) {
+        try {
+            importMetaResolve(deps, import.meta.url);
+            // If the package is installed, push it to the result array.
+            result.push(deps);
+        }
+        catch {
+            // If the package is not installed, do nothing.
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/dist/util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/util.test.js

@@ -0,0 +1,74 @@
+import { join } from 'path';
+import { createFixtures, getFixturePath } from './test-util/util.js';
+import { hasProp, isObject, isSystemError, unique, uniqueBy, isMatchByGlob, exists } from './util.js';
+function fakeSystemError({ code }) {
+    const error = new Error();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    error.code = code;
+    return error;
+}
+test('isSystemError', () => {
+    expect(isSystemError(fakeSystemError({ code: 'ENOENT' }))).toBe(true);
+    expect(isSystemError(fakeSystemError({ code: 'EACCES' }))).toBe(true);
+    expect(isSystemError(new Error('ENOENT'))).toBe(false);
+    expect(isSystemError({ code: 'ENOENT' })).toBe(false);
+});
+test('isObject', () => {
+    expect(isObject({})).toBe(true);
+    expect(isObject({ a: '1' })).toBe(true);
+    expect(isObject([])).toBe(true);
+    expect(isObject(() => {
+        /* noop */
+    })).toBe(true);
+    expect(isObject(null)).toBe(false);
+    expect(isObject(undefined)).toBe(false);
+    expect(isObject(1)).toBe(false);
+    expect(isObject('1')).toBe(false);
+    expect(isObject(true)).toBe(false);
+});
+test('hasProp', () => {
+    expect(hasProp({ a: '1' }, 'a')).toBe(true);
+    expect(hasProp({ a: '1' }, 'b')).toBe(false);
+    // it can check prototype
+    expect(hasProp({}, 'toString')).toBe(true);
+    expect(hasProp([], 'length')).toBe(true);
+});
+test('unique', () => {
+    expect(unique([0, 1, 1, 2, 1])).toStrictEqual([0, 1, 2]);
+});
+test('uniqueBy', () => {
+    expect(uniqueBy([], () => 0)).toStrictEqual([]);
+    expect(uniqueBy([
+        { key: 'a', value: 0 },
+        { key: 'a', value: 1 },
+        { key: 'b', value: 2 },
+        { key: 'b', value: 3 },
+        { key: 'c', value: 4 },
+        { key: 'c', value: 5 },
+    ], (el) => el.key)).toStrictEqual([
+        { key: 'a', value: 0 },
+        { key: 'b', value: 2 },
+        { key: 'c', value: 4 },
+    ]);
+});
+test('exists', async () => {
+    createFixtures({
+        '/test/1.css': `.a {}`,
+    });
+    expect(await exists(getFixturePath('/test/1.css'))).toBe(true);
+    expect(await exists(getFixturePath('/test/2.css'))).toBe(false);
+});
+test('isMatchByGlob', () => {
+    const cwd = process.cwd();
+    expect(isMatchByGlob(join(cwd, '1.css'), '*.css', { cwd })).toBe(true);
+    expect(isMatchByGlob(join(cwd, '1.scss'), '*.css', { cwd })).toBe(false);
+    expect(isMatchByGlob(join(cwd, 'dir/1.css'), '**/*.css', { cwd })).toBe(true);
+    expect(isMatchByGlob(join(cwd, 'dir/dir/1.css'), '**/*.css', { cwd })).toBe(true);
+    expect(isMatchByGlob(join(cwd, '1.css'), '*.{css,scss}', { cwd })).toBe(true);
+    expect(isMatchByGlob(join(cwd, '1.scss'), '*.{css,scss}', { cwd })).toBe(true);
+    expect(isMatchByGlob(join(cwd, '1.less'), '*.{css,scss}', { cwd })).toBe(false);
+    expect(isMatchByGlob(join(cwd, '1.css'), '!(*.css)', { cwd })).toBe(false);
+    expect(isMatchByGlob(join(cwd, '1.scss'), '!(*.css)', { cwd })).toBe(true);
+    expect(isMatchByGlob(join(cwd, '1.less'), '!(*.css)', { cwd })).toBe(true);
+});
+//# sourceMappingURL=util.test.js.map

package/dist/util.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "happy-css-modules",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Creates .d.ts files from CSS Modules .css files",
   "type": "module",
   "main": "dist/index.js",

package/src/cli.ts

@@ -78,6 +78,11 @@ export function parseArgv(argv: string[]): RunnerOptions {
       default: 'info' as RunnerOptions['logLevel'],
       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)
@@ -116,5 +121,6 @@ export function parseArgv(argv: string[]): RunnerOptions {
     cache: parsedArgv.cache,
     cacheStrategy: parsedArgv.cacheStrategy,
     logLevel: parsedArgv.logLevel,
+    outDir: parsedArgv.outDir,
   };
 }

package/src/emitter/dts.test.ts

@@ -9,10 +9,13 @@ const locator = new Locator();
 const isExternalFile = () => false;
 
 test('getDtsFilePath', () => {
-  expect(getDtsFilePath('/app/src/dir/1.css', false)).toBe('/app/src/dir/1.css.d.ts');
-  expect(getDtsFilePath('/app/src/dir/1.scss', false)).toBe('/app/src/dir/1.scss.d.ts');
-  expect(getDtsFilePath('/app/src/dir/1.css', true)).toBe('/app/src/dir/1.d.css.ts');
-  expect(getDtsFilePath('/app/src/dir/1.scss', true)).toBe('/app/src/dir/1.d.scss.ts');
+  expect(getDtsFilePath('/app/src/dir/1.css', false, undefined)).toBe('/app/src/dir/1.css.d.ts');
+  expect(getDtsFilePath('/app/src/dir/1.scss', false, undefined)).toBe('/app/src/dir/1.scss.d.ts');
+  expect(getDtsFilePath('/app/src/dir/1.css', true, undefined)).toBe('/app/src/dir/1.d.css.ts');
+  expect(getDtsFilePath('/app/src/dir/1.scss', true, undefined)).toBe('/app/src/dir/1.d.scss.ts');
+  expect(getDtsFilePath('/app/src/dir/1.css', false, { cwd: '/app', outDir: 'dist' })).toBe(
+    '/app/dist/src/dir/1.css.d.ts',
+  );
 });
 
 describe('generateDtsContentWithSourceMap', () => {

package/src/emitter/dts.ts

@@ -1,23 +1,35 @@
 import { EOL } from 'os';
-import { basename, parse, join } from 'path';
+import path, { basename, parse, join } from 'path';
 import camelcase from 'camelcase';
-import { SourceNode, type CodeWithSourceMap } from '../library/source-map/index.js';
+import { SourceNode, type CodeWithSourceMap } from 'source-map';
 import { type Token } from '../locator/index.js';
 import { type LocalsConvention } from '../runner.js';
-import { getRelativePath, type DtsFormatOptions } from './index.js';
+import { getRelativePath } from './index.js';
+import type { OutDirOptions, DtsFormatOptions } from './index.js';
 
 /**
  * Get .d.ts file path.
  * @param filePath The path to the source file (i.e. `/dir/foo.css`). It is absolute.
  * @param arbitraryExtensions Generate `.d.css.ts` instead of `.css.d.ts`.
+ * @param options Output directory options
  * @returns The path to the .d.ts file. It is absolute.
  */
-export function getDtsFilePath(filePath: string, arbitraryExtensions: boolean): string {
+export function getDtsFilePath(
+  filePath: string,
+  arbitraryExtensions: boolean,
+  options: OutDirOptions | undefined,
+): string {
+  let outputFilePath = filePath;
+  if (options?.outDir) {
+    const relativePath = path.relative(options.cwd, filePath);
+    outputFilePath = path.resolve(options.cwd, options.outDir, relativePath);
+  }
+
   if (arbitraryExtensions) {
-    const { dir, name, ext } = parse(filePath);
+    const { dir, name, ext } = parse(outputFilePath);
     return join(dir, `${name}.d${ext}.ts`);
   } else {
-    return `${filePath}.d.ts`;
+    return `${outputFilePath}.d.ts`;
   }
 }
 
@@ -61,9 +73,9 @@ function generateTokenDeclarations(
   tokens: Token[],
   dtsFormatOptions: DtsFormatOptions | undefined,
   isExternalFile: (filePath: string) => boolean,
-): (typeof SourceNode)[] {
+): SourceNode[] {
   const formattedTokens = formatTokens(tokens, dtsFormatOptions?.localsConvention);
-  const result: (typeof SourceNode)[] = [];
+  const result: SourceNode[] = [];
 
   for (const token of formattedTokens) {
     // Only one original position can be associated with one generated position.
@@ -140,13 +152,13 @@ export function generateDtsContentWithSourceMap(
     isExternalFile,
   );
 
-  let sourceNode: typeof SourceNode;
+  let sourceNode: SourceNode;
   if (!tokenDeclarations || !tokenDeclarations.length) {
     sourceNode = new SourceNode(null, null, null, '');
   } else {
     sourceNode = new SourceNode(1, 0, getRelativePath(sourceMapFilePath, filePath), [
       `declare const styles:${EOL}`,
-      ...tokenDeclarations.map((tokenDeclaration) => ['  ', tokenDeclaration, EOL]),
+      ...tokenDeclarations.map((tokenDeclaration) => ['  ', tokenDeclaration, EOL]).flat(),
       `;${EOL}`,
       `export default styles;${EOL}`,
     ]);

package/src/emitter/index.test.ts

@@ -30,6 +30,7 @@ describe('emitGeneratedFiles', () => {
     dtsFormatOptions: undefined,
     cwd: getFixturePath('/test'),
     isExternalFile: () => false,
+    outDir: undefined,
   };
   beforeEach(() => {
     createFixtures({
@@ -75,4 +76,13 @@ describe('emitGeneratedFiles', () => {
     expect(mtimeForDts1).not.toEqual(mtimeForDts3); // not skipped
     expect(mtimeForSourceMap1).not.toEqual(mtimeForSourceMap3); // not skipped
   });
+  test('changes output directory by outDir', async () => {
+    await emitGeneratedFiles({ ...defaultArgs, outDir: 'dist' });
+    expect(await exists(getFixturePath('/test/dist/1.css.d.ts'))).toBeTruthy();
+    // A link to the source map is not embedded.
+    expect(await readFile(getFixturePath('/test/dist/1.css.d.ts'), 'utf8')).toEqual(
+      expect.not.stringContaining('//# sourceMappingURL=1.css.d.ts.map'),
+    );
+    expect(await exists(getFixturePath('/test/dist/1.css.d.ts.map'))).toBeTruthy();
+  });
 });

package/src/emitter/index.ts

@@ -45,6 +45,10 @@ export type EmitterOptions = {
   dtsFormatOptions: DtsFormatOptions | undefined;
   /** Whether the file is from an external library or not. */
   isExternalFile: (filePath: string) => boolean;
+  /** Output directory for generated files. */
+  outDir: string | undefined;
+  /** Current working directory. */
+  cwd: string;
 };
 
 export async function emitGeneratedFiles({
@@ -53,10 +57,12 @@ export async function emitGeneratedFiles({
   emitDeclarationMap,
   dtsFormatOptions,
   isExternalFile,
+  outDir,
+  cwd,
 }: EmitterOptions): Promise<void> {
   const arbitraryExtensions = dtsFormatOptions?.arbitraryExtensions ?? DEFAULT_ARBITRARY_EXTENSIONS;
-  const dtsFilePath = getDtsFilePath(filePath, arbitraryExtensions);
-  const sourceMapFilePath = getSourceMapFilePath(filePath, arbitraryExtensions);
+  const dtsFilePath = getDtsFilePath(filePath, arbitraryExtensions, { outDir, cwd });
+  const sourceMapFilePath = getSourceMapFilePath(filePath, arbitraryExtensions, { outDir, cwd });
   const { dtsContent, sourceMap } = generateDtsContentWithSourceMap(
     filePath,
     dtsFilePath,
@@ -84,9 +90,11 @@ export async function isGeneratedFilesExist(
   filePath: string,
   emitDeclarationMap: boolean | undefined,
   arbitraryExtensions: boolean,
+  outDir: string | undefined,
+  cwd: string,
 ): Promise<boolean> {
-  const dtsFilePath = getDtsFilePath(filePath, arbitraryExtensions);
-  const sourceMapFilePath = getSourceMapFilePath(filePath, arbitraryExtensions);
+  const dtsFilePath = getDtsFilePath(filePath, arbitraryExtensions, { outDir, cwd });
+  const sourceMapFilePath = getSourceMapFilePath(filePath, arbitraryExtensions, { outDir, cwd });
   if (emitDeclarationMap && !(await exists(sourceMapFilePath))) {
     return false;
   }
@@ -95,3 +103,8 @@ export async function isGeneratedFilesExist(
   }
   return true;
 }
+
+export type OutDirOptions = {
+  outDir: string | undefined;
+  cwd: string;
+};

package/src/emitter/source-map.test.ts

@@ -2,10 +2,10 @@ import { EOL } from 'os';
 import { getSourceMapFilePath, generateSourceMappingURLComment } from './source-map.js';
 
 test('getSourceMapFilePath', () => {
-  expect(getSourceMapFilePath('/app/src/dir/1.css', false)).toBe('/app/src/dir/1.css.d.ts.map');
-  expect(getSourceMapFilePath('/app/src/dir/1.scss', false)).toBe('/app/src/dir/1.scss.d.ts.map');
-  expect(getSourceMapFilePath('/app/src/dir/1.css', true)).toBe('/app/src/dir/1.d.css.ts.map');
-  expect(getSourceMapFilePath('/app/src/dir/1.scss', true)).toBe('/app/src/dir/1.d.scss.ts.map');
+  expect(getSourceMapFilePath('/app/src/dir/1.css', false, undefined)).toBe('/app/src/dir/1.css.d.ts.map');
+  expect(getSourceMapFilePath('/app/src/dir/1.scss', false, undefined)).toBe('/app/src/dir/1.scss.d.ts.map');
+  expect(getSourceMapFilePath('/app/src/dir/1.css', true, undefined)).toBe('/app/src/dir/1.d.css.ts.map');
+  expect(getSourceMapFilePath('/app/src/dir/1.scss', true, undefined)).toBe('/app/src/dir/1.d.scss.ts.map');
 });
 
 test('generateSourceMappingURLComment', () => {

package/src/emitter/source-map.ts

@@ -1,15 +1,21 @@
 import { EOL } from 'os';
 import { getDtsFilePath } from './dts.js';
+import type { OutDirOptions } from './index.js';
 import { getRelativePath } from './index.js';
 
 /**
  * Get .d.ts.map file path.
  * @param filePath The path to the source file (i.e. `foo.css`). It is absolute.
  * @param arbitraryExtensions Generate `.d.css.ts` instead of `.css.d.ts`.
+ * @param outDir Output directory for generated files.
  * @returns The path to the .d.ts.map file. It is absolute.
  */
-export function getSourceMapFilePath(filePath: string, arbitraryExtensions: boolean): string {
-  return `${getDtsFilePath(filePath, arbitraryExtensions)}.map`;
+export function getSourceMapFilePath(
+  filePath: string,
+  arbitraryExtensions: boolean,
+  options: OutDirOptions | undefined,
+): string {
+  return `${getDtsFilePath(filePath, arbitraryExtensions, options)}.map`;
 }
 
 export function generateSourceMappingURLComment(dtsFilePath: string, sourceMapFilePath: string): string {

package/src/runner.test.ts

@@ -351,3 +351,26 @@ test('support symlink', async () => {
     `"{"version":3,"sources":["./1.css"],"names":["a"],"mappings":"AAAA;AAAA,E,aAAAA,G,WAAA;AAAA;AAAA","file":"1.css.d.ts","sourceRoot":""}"`,
   );
 });
+
+test('changes output directory by outDir', async () => {
+  createFixtures({
+    '/test/1.css': '.a {}',
+  });
+
+  await run({ ...defaultOptions, outDir: getFixturePath('/dist'), cache: false, watch: false });
+
+  expect(await exists(getFixturePath('/dist/test/1.css.d.ts'))).toBe(true);
+  expect(await exists(getFixturePath('/dist/test/1.css.d.ts.map'))).toBe(true);
+
+  expect(await readFile(getFixturePath('/dist/test/1.css.d.ts'), 'utf8')).toMatchInlineSnapshot(`
+    "declare const styles:
+      & Readonly<{ "a": string }>
+    ;
+    export default styles;
+    //# sourceMappingURL=./1.css.d.ts.map
+    "
+  `);
+  expect(await readFile(getFixturePath('/dist/test/1.css.d.ts.map'), 'utf8')).toMatchInlineSnapshot(
+    `"{"version":3,"sources":["../../test/1.css"],"names":["a"],"mappings":"AAAA;AAAA,E,aAAAA,G,WAAA;AAAA;AAAA","file":"1.css.d.ts","sourceRoot":""}"`,
+  );
+});

package/src/runner.ts

@@ -79,6 +79,8 @@ export interface RunnerOptions {
   logLevel?: 'debug' | 'info' | 'silent' | undefined;
   /** Working directory path. */
   cwd?: string | undefined;
+  /** Output directory for generated files. */
+  outDir?: string | undefined;
 }
 
 type OverrideProp<T, K extends keyof T, V extends T[K]> = Omit<T, K> & { [P in K]: V };
@@ -140,6 +142,8 @@ export async function run(options: RunnerOptions): Promise<Watcher | void> {
         filePath,
         options.declarationMap,
         options.arbitraryExtensions ?? DEFAULT_ARBITRARY_EXTENSIONS,
+        options.outDir,
+        cwd,
       );
       const _isChangedFile = await isChangedFile(filePath);
       // Generate .d.ts and .d.ts.map only when the file has been updated.
@@ -159,6 +163,8 @@ export async function run(options: RunnerOptions): Promise<Watcher | void> {
           arbitraryExtensions: options.arbitraryExtensions,
         },
         isExternalFile,
+        outDir: options.outDir,
+        cwd,
       });
       logger.info(chalk.green(`${relative(cwd, filePath)} (generated)`));
 

package/src/library/README.md

@@ -1,3 +0,0 @@
-## library
-
-This is a directory to put library forks or wrappers to avoid bugs.