happy-css-modules 0.4.0 → 0.5.0

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

@@ -41,37 +41,37 @@ test('handles less features', async () => {
         {
           name: "b_1",
           originalLocations: [
-            { filePath: "<fixtures>/test/2.less", start: { line: 1, column: 1 }, end: { line: 1, column: 3 } },
+            { filePath: "<fixtures>/test/2.less", start: { line: 1, column: 1 }, end: { line: 1, column: 4 } },
           ],
         },
         {
           name: "a_1",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.less", start: { line: 2, column: 1 }, end: { line: 2, column: 3 } },
+            { filePath: "<fixtures>/test/1.less", start: { line: 2, column: 1 }, end: { line: 2, column: 4 } },
           ],
         },
         {
           name: "a_2",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.less", start: { line: 3, column: 1 }, end: { line: 3, column: 3 } },
+            { filePath: "<fixtures>/test/1.less", start: { line: 3, column: 1 }, end: { line: 3, column: 4 } },
           ],
         },
         {
           name: "a_2_1",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.less", start: { line: 6, column: 3 }, end: { line: 6, column: 7 } },
+            { filePath: "<fixtures>/test/1.less", start: { line: 6, column: 3 }, end: { line: 6, column: 8 } },
           ],
         },
         {
           name: "a_2_2",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.less", start: { line: 7, column: 3 }, end: { line: 7, column: 7 } },
+            { filePath: "<fixtures>/test/1.less", start: { line: 7, column: 3 }, end: { line: 7, column: 8 } },
           ],
         },
         {
           name: "c",
           originalLocations: [
-            { filePath: "<fixtures>/test/3.less", start: { line: 1, column: 1 }, end: { line: 1, column: 1 } },
+            { filePath: "<fixtures>/test/3.less", start: { line: 1, column: 1 }, end: { line: 1, column: 2 } },
           ],
         },
       ],

package/dist/transformer/postcss-transformer.d.ts

@@ -0,0 +1,12 @@
+import type { Transformer } from '../index.js';
+export declare type PostcssTransformerOptions = {
+    cwd?: string | undefined;
+    /**
+     * The option compatible with postcss's `--config`. It is a relative or absolute path.
+     * @example '.'
+     * @example 'postcss.config.js'
+     * @example '/home/user/repository/src'
+     */
+    postcssConfig?: string | undefined;
+};
+export declare const createPostcssTransformer: (postcssTransformerOptions?: PostcssTransformerOptions) => Transformer;

package/dist/transformer/postcss-transformer.js

@@ -0,0 +1,32 @@
+import { createRequire } from 'node:module';
+import { resolve } from 'node:path';
+import { default as postcss } from 'postcss';
+const require = createRequire(import.meta.url);
+const postcssrc = require('postcss-load-config');
+function isDependencyMessage(message) {
+    return message.type === 'dependency';
+}
+export const createPostcssTransformer = (postcssTransformerOptions) => {
+    const cwd = postcssTransformerOptions?.cwd ?? process.cwd();
+    const configSearchPath = postcssTransformerOptions?.postcssConfig
+        ? resolve(cwd, postcssTransformerOptions?.postcssConfig)
+        : cwd;
+    return async (source, options) => {
+        // NOTE: postcss-load-config cache the configuration file so is is not reloaded.
+        const postcssConfig = await postcssrc({ cwd }, configSearchPath).catch((e) => {
+            if (e instanceof Error && e.message.includes('No PostCSS Config found'))
+                return undefined;
+            throw e;
+        });
+        if (postcssConfig === undefined)
+            return false;
+        const result = await postcss(postcssConfig.plugins).process(source, {
+            ...postcssConfig.options,
+            from: options.from,
+            map: { inline: false, absolute: true },
+        });
+        const dependencies = result.messages.filter(isDependencyMessage).map((message) => message.file);
+        return { css: result.css, map: result.map, dependencies };
+    };
+};
+//# sourceMappingURL=postcss-transformer.js.map

package/dist/transformer/postcss-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcss-transformer.js","sourceRoot":"","sources":["../../src/transformer/postcss-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAgB,MAAM,SAAS,CAAC;AAI3D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,SAAS,GAAyC,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAQvF,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,OAAO,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC;AACvC,CAAC;AAaD,MAAM,CAAC,MAAM,wBAAwB,GAA2E,CAC9G,yBAAyB,EACzB,EAAE;IACF,MAAM,GAAG,GAAG,yBAAyB,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5D,MAAM,gBAAgB,GAAG,yBAAyB,EAAE,aAAa;QAC/D,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,yBAAyB,EAAE,aAAa,CAAC;QACxD,CAAC,CAAC,GAAG,CAAC;IACR,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC/B,gFAAgF;QAChF,MAAM,aAAa,GAAuB,MAAM,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/F,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC1F,MAAM,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;QACH,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAE9C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE;YAClE,GAAG,aAAa,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;SACvC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEhG,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/transformer/postcss-transformer.test.d.ts

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

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

@@ -0,0 +1,176 @@
+import { randomUUID } from 'node:crypto';
+import { createRequire } from 'node:module';
+import { jest } from '@jest/globals';
+import dedent from 'dedent';
+import { Loader } from '../loader/index.js';
+import { createFixtures, getFixturePath } from '../test/util.js';
+import { createPostcssTransformer } from './postcss-transformer.js';
+const cwd = getFixturePath('/');
+const require = createRequire(import.meta.url);
+// NOTE: postcss-load-config caches the configuration file using the path as a key.
+// Therefore, change the path for each test case so that a new configuration file is always used.
+test('handles postcss features', async () => {
+    const uuid = randomUUID();
+    const loader = new Loader({
+        transformer: createPostcssTransformer({
+            cwd,
+            postcssConfig: `${uuid}/postcss.config.js`,
+        }),
+    });
+    createFixtures({
+        [`/${uuid}/postcss.config.js`]: dedent `
+    module.exports = {
+      plugins: [
+        require('${require.resolve('postcss-simple-vars')}'),
+      ],
+    };
+    `,
+        '/test/1.css': dedent `
+    $prefix: foo;
+    .$(prefix)_bar {}
+    `,
+    });
+    const result = await loader.load(getFixturePath('/test/1.css'));
+    expect(result).toMatchInlineSnapshot(`
+    {
+      dependencies: [],
+      tokens: [
+        {
+          name: "foo_bar",
+          originalLocations: [
+            { filePath: "<fixtures>/test/1.css", start: { line: 2, column: 1 }, end: { line: 2, column: 8 } },
+          ],
+        },
+      ],
+    }
+  `);
+});
+test('tracks dependencies that have been pre-bundled by postcss compiler', async () => {
+    const uuid = randomUUID();
+    const loader = new Loader({
+        transformer: createPostcssTransformer({
+            cwd,
+            postcssConfig: `${uuid}/postcss.config.js`,
+        }),
+    });
+    const loadSpy = jest.spyOn(loader, 'load');
+    createFixtures({
+        [`/${uuid}/postcss.config.js`]: dedent `
+    module.exports = {
+      plugins: [
+        require('${require.resolve('postcss-import')}'),
+      ],
+    };
+    `,
+        '/test/1.css': dedent `
+    @import './2.css';
+    @import './3.css';
+    `,
+        '/test/2.css': ``,
+        '/test/3.css': `@import './4.css'`,
+        '/test/4.css': ``,
+    });
+    const result = await loader.load(getFixturePath('/test/1.css'));
+    // The files imported using @import are pre-bundled by the compiler.
+    // Therefore, `Loader#load` is not called to process other files.
+    expect(loadSpy).toBeCalledTimes(1);
+    expect(loadSpy).toHaveBeenNthCalledWith(1, getFixturePath('/test/1.css'));
+    // The files pre-bundled by the compiler are also included in `result.dependencies`
+    expect(result.dependencies).toStrictEqual(['/test/2.css', '/test/3.css', '/test/4.css'].map(getFixturePath));
+});
+test('resolves specifier using resolver', async () => {
+    const uuid = randomUUID();
+    const loader = new Loader({
+        transformer: createPostcssTransformer({
+            cwd,
+            postcssConfig: `${uuid}/postcss.config.js`,
+        }),
+    });
+    createFixtures({
+        [`/${uuid}/postcss.config.js`]: dedent `
+    module.exports = {
+      plugins: [
+        // When using postcss-import, the resolver of happy-css-modules is ignored.
+        // Therefore, we test here without postcss-import.
+        // require('${require.resolve('postcss-import')}'),
+      ],
+    };
+    `,
+        '/test/1.css': dedent `
+    @import 'package';
+    `,
+        '/node_modules/package/index.css': `.a {}`,
+    });
+    const result = await loader.load(getFixturePath('/test/1.css'));
+    expect(result.dependencies).toStrictEqual(['/node_modules/package/index.css'].map(getFixturePath));
+});
+test('ignores http(s) protocol file', async () => {
+    const uuid = randomUUID();
+    const loader = new Loader({
+        transformer: createPostcssTransformer({
+            cwd,
+            postcssConfig: `${uuid}/postcss.config.js`,
+        }),
+    });
+    createFixtures({
+        [`/${uuid}/postcss.config.js`]: dedent `
+    module.exports = {
+      plugins: [
+        // When using postcss-import, the resolver of happy-css-modules is ignored.
+        // Therefore, we test here without postcss-import.
+        // require('${require.resolve('postcss-import')}'),
+      ],
+    };
+    `,
+        '/test/1.css': dedent `
+    @import 'http://example.com/path/http.css';
+    @import 'https://example.com/path/https.css';
+    `,
+    });
+    const result = await loader.load(getFixturePath('/test/1.css'));
+    expect(result.dependencies).toStrictEqual([]);
+});
+test('returns false if postcssrc is not found', async () => {
+    const uuid = randomUUID();
+    const transformer = createPostcssTransformer({
+        cwd,
+        postcssConfig: `${uuid}/postcss.config.js`,
+    });
+    createFixtures({
+        '/test/1.css': dedent `
+    @import 'http://example.com/path/http.css';
+    @import 'https://example.com/path/https.css';
+    `,
+    });
+    expect(await transformer('', {
+        from: getFixturePath('/test/1.css'),
+        isIgnoredSpecifier: () => false,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        resolver: jest.fn(),
+    })).toBe(false);
+});
+test('searches config from cwd if postcssConfig option is missing', async () => {
+    const uuid = randomUUID();
+    const cwd = `/${uuid}`;
+    const loader = new Loader({
+        transformer: createPostcssTransformer({
+            cwd: getFixturePath(cwd),
+        }),
+    });
+    createFixtures({
+        [`/${uuid}/postcss.config.js`]: dedent `
+    module.exports = {
+      plugins: [
+        require('${require.resolve('postcss-simple-vars')}'),
+      ],
+    };
+    `,
+        '/test/1.css': dedent `
+    $prefix: foo;
+    .$(prefix)_bar {}
+    `,
+    });
+    const result = await loader.load(getFixturePath('/test/1.css'));
+    expect(result.tokens.map((token) => token.name)).toStrictEqual(['foo_bar']);
+});
+//# sourceMappingURL=postcss-transformer.test.js.map

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

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

package/dist/transformer/scss-transformer.js

@@ -3,9 +3,25 @@
 // Therefore, the workaround is now disabled. See
 // https://github.com/mizdra/happy-css-modules/issues/65#issuecomment-1229471950 for more information.
 import { handleImportError } from './index.js';
-async function renderSass(sass, source, options) {
-    return new Promise((resolve, reject) => {
-        sass.render({
+// For some reason, `util.promisify` does not work. Therefore, use the original promisify.
+function promisifySassRender(sass) {
+    return async (options) => {
+        return new Promise((resolve, reject) => {
+            sass.render(options, (exception, result) => {
+                if (exception)
+                    reject(exception);
+                else
+                    resolve(result);
+            });
+        });
+    };
+}
+export const createScssTransformer = () => {
+    let sass;
+    return async (source, options) => {
+        sass ??= (await import('sass').catch(handleImportError('sass'))).default;
+        const render = promisifySassRender(sass);
+        const result = await render({
             data: source,
             file: options.from,
             outFile: 'DUMMY',
@@ -16,21 +32,7 @@ async function renderSass(sass, source, options) {
                     .then((resolved) => done({ file: resolved }))
                     .catch((e) => done(e));
             },
-        }, (exception, result) => {
-            if (exception) {
-                reject(exception);
-            }
-            else {
-                resolve(result);
-            }
         });
-    });
-}
-export const createScssTransformer = () => {
-    let sass;
-    return async (source, options) => {
-        sass ??= (await import('sass').catch(handleImportError('sass'))).default;
-        const result = await renderSass(sass, source, options);
         return { css: result.css.toString(), map: result.map.toString(), dependencies: result.stats.includedFiles };
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"scss-transformer.js","sourceRoot":"","sources":["../../src/transformer/scss-transformer.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,8FAA8F;AAC9F,iDAAiD;AACjD,sGAAsG;AAItG,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,UAAU,UAAU,CAAC,IAA2B,EAAE,MAAc,EAAE,OAA2B;IAChG,OAAO,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnD,IAAI,CAAC,MAAM,CACT;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;gBAC5B,OAAO;qBACJ,QAAQ,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;qBAChC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;qBAC5C,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;SACF,EACD,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE;YACpB,IAAI,SAAS,EAAE;gBACb,MAAM,CAAC,SAAS,CAAC,CAAC;aACnB;iBAAM;gBACL,OAAO,CAAC,MAAO,CAAC,CAAC;aAClB;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAsB,GAAG,EAAE;IAC3D,IAAI,IAA2B,CAAC;IAChC,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAI,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IAC/G,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"scss-transformer.js","sourceRoot":"","sources":["../../src/transformer/scss-transformer.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,8FAA8F;AAC9F,iDAAiD;AACjD,sGAAsG;AAItG,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,0FAA0F;AAC1F,SAAS,mBAAmB,CAAC,IAA2B;IACtD,OAAO,KAAK,EAAE,OAA+B,EAAE,EAAE;QAC/C,OAAO,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE;gBACzC,IAAI,SAAS;oBAAE,MAAM,CAAC,SAAS,CAAC,CAAC;;oBAC5B,OAAO,CAAC,MAAO,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAsB,GAAG,EAAE;IAC3D,IAAI,IAA2B,CAAC;IAChC,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACzE,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;YAC1B,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;gBAC5B,OAAO;qBACJ,QAAQ,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;qBAChC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;qBAC5C,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAI,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IAC/G,CAAC,CAAC;AACJ,CAAC,CAAC"}

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

@@ -46,44 +46,44 @@ test('handles sass features', async () => {
         {
           name: "b_1",
           originalLocations: [
-            { filePath: "<fixtures>/test/2.scss", start: { line: 1, column: 1 }, end: { line: 1, column: 3 } },
+            { filePath: "<fixtures>/test/2.scss", start: { line: 1, column: 1 }, end: { line: 1, column: 4 } },
           ],
         },
         {
           name: "c",
           originalLocations: [
-            { filePath: "<fixtures>/test/3.scss", start: { line: 1, column: 1 }, end: { line: 1, column: 1 } },
+            { filePath: "<fixtures>/test/3.scss", start: { line: 1, column: 1 }, end: { line: 1, column: 2 } },
           ],
         },
         {
           name: "a_1",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.scss", start: { line: 3, column: 1 }, end: { line: 3, column: 3 } },
+            { filePath: "<fixtures>/test/1.scss", start: { line: 3, column: 1 }, end: { line: 3, column: 4 } },
           ],
         },
         {
           name: "a_2",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.scss", start: { line: 4, column: 1 }, end: { line: 4, column: 3 } },
-            { filePath: "<fixtures>/test/1.scss", start: { line: 7, column: 3 }, end: { line: 7, column: 5 } },
+            { filePath: "<fixtures>/test/1.scss", start: { line: 4, column: 1 }, end: { line: 4, column: 4 } },
+            { filePath: "<fixtures>/test/1.scss", start: { line: 7, column: 3 }, end: { line: 7, column: 6 } },
           ],
         },
         {
           name: "a_2_1",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.scss", start: { line: 7, column: 3 }, end: { line: 7, column: 7 } },
+            { filePath: "<fixtures>/test/1.scss", start: { line: 7, column: 3 }, end: { line: 7, column: 8 } },
           ],
         },
         {
           name: "a_2_2",
           originalLocations: [
-            { filePath: "<fixtures>/test/1.scss", start: { line: 8, column: 3 }, end: { line: 8, column: 7 } },
+            { filePath: "<fixtures>/test/1.scss", start: { line: 8, column: 3 }, end: { line: 8, column: 8 } },
           ],
         },
         {
           name: "d",
           originalLocations: [
-            { filePath: "<fixtures>/test/4.scss", start: { line: 1, column: 1 }, end: { line: 1, column: 1 } },
+            { filePath: "<fixtures>/test/4.scss", start: { line: 1, column: 1 }, end: { line: 1, column: 2 } },
           ],
         },
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "happy-css-modules",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Creates .d.ts files from CSS Modules .css files",
   "type": "module",
   "main": "dist/index.js",
@@ -35,7 +35,8 @@
     "glob": "^8.0.3",
     "import-meta-resolve": "^2.1.0",
     "minimatch": "^5.1.0",
-    "postcss": "^8.4.14",
+    "postcss": "^8.4.17",
+    "postcss-load-config": "^4.0.1",
     "postcss-modules": "^4.3.1",
     "postcss-selector-parser": "^6.0.10",
     "postcss-value-parser": "^4.2.0",
@@ -58,7 +59,7 @@
     "@types/line-column": "^1.0.0",
     "@types/minimatch": "^5.1.2",
     "@types/node": "^18.0.6",
-    "@types/yargs": "^17.0.12",
+    "@types/yargs": "^17.0.13",
     "@typescript-eslint/eslint-plugin": "^5.31.0",
     "@typescript-eslint/parser": "^5.31.0",
     "@typescript/server-harness": "^0.2.0",
@@ -71,6 +72,8 @@
     "less": "^4.1.3",
     "line-column": "^1.0.2",
     "npm-run-all": "^4.1.5",
+    "postcss-import": "^15.0.0",
+    "postcss-simple-vars": "^7.0.0",
     "prettier": "~2.7.1",
     "sass": "^1.54.3",
     "tsc-watch": "^5.0.3",

package/src/cli.test.ts

@@ -45,6 +45,21 @@ describe('parseArgv', () => {
     // Passing a number is treated as a string
     expect(parseArgv([...baseArgs, '1.css', '--lessIncludePaths', '1']).lessIncludePaths).toStrictEqual(['1']);
   });
+  test('--webpackResolveAlias', () => {
+    expect(
+      parseArgv([...baseArgs, '1.css', '--webpackResolveAlias', '{ "key1": "value1", "key2": "value2" }'])
+        .webpackResolveAlias,
+    ).toStrictEqual({
+      key1: 'value1',
+      key2: 'value2',
+    });
+  });
+  test('--postcssConfig', () => {
+    expect(parseArgv([...baseArgs, '1.css', '--postcssConfig', '.']).postcssConfig).toBe('.');
+    expect(parseArgv([...baseArgs, '1.css', '--postcssConfig', 'postcss.config.js']).postcssConfig).toBe(
+      'postcss.config.js',
+    );
+  });
   test('--silent', () => {
     expect(parseArgv([...baseArgs, '1.css', '--silent']).silent).toBe(true);
     expect(parseArgv([...baseArgs, '1.css', '--no-silent']).silent).toBe(false);

package/src/cli.ts

@@ -13,7 +13,7 @@ const pkgJson = JSON.parse(readFileSync(resolve(dirname(fileURLToPath(import.met
  */
 export function parseArgv(argv: string[]): RunnerOptions {
   const parsedArgv = yargs(hideBin(argv))
-    .wrap(Math.min(120, process.stdout.columns))
+    .wrap(Math.min(140, process.stdout.columns))
     .scriptName('hcm')
     .usage('Create .d.ts and .d.ts.map from CSS modules *.css files.\n\n$0 [options] <glob>')
     .example("$0 'src/**/*.module.css'", 'Generate .d.ts and .d.ts.map.')
@@ -22,6 +22,7 @@ export function parseArgv(argv: string[]): RunnerOptions {
     .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`.")
     .detectLocale(false)
     .option('outDir', {
       type: 'string',
@@ -52,6 +53,15 @@ export function parseArgv(argv: string[]): RunnerOptions {
       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('silent', {
       type: 'boolean',
       default: false,
@@ -64,6 +74,20 @@ export function parseArgv(argv: string[]): RunnerOptions {
       const patterns = argv._;
       // TODO: support multiple patterns
       if (patterns.length !== 1) throw new Error('Only one pattern is allowed.');
+      if (argv.webpackResolveAlias) {
+        let parsedWebpackResolveAlias: unknown;
+        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');
+      }
       return true;
     })
     .parseSync();
@@ -76,6 +100,8 @@ export function parseArgv(argv: string[]): RunnerOptions {
     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,
     silent: parsedArgv.silent,
   };
 }

package/src/emitter/dts.ts

@@ -65,7 +65,16 @@ function generateTokenDeclarations(
     // This is due to the sourcemap specification. Therefore, we output multiple type definitions
     // with the same name and assign a separate original position to each.
 
-    for (const originalLocation of token.originalLocations) {
+    for (let originalLocation of token.originalLocations) {
+      if (originalLocation.filePath === undefined) {
+        // If the original location is not specified, fallback to the source file.
+        originalLocation = {
+          filePath: filePath,
+          start: { line: 1, column: 1 },
+          end: { line: 1, column: 1 },
+        };
+      }
+
       result.push(
         originalLocation.filePath === filePath || isExternalFile(originalLocation.filePath)
           ? new SourceNode(null, null, null, [

package/src/index.ts

@@ -1,3 +1,9 @@
 export { parseArgv } from './cli.js';
-export { run } from './runner.js';
-export { type Transformer } from './transformer/index.js';
+export { run, type LocalsConvention } from './runner.js';
+export {
+  type Transformer,
+  type TransformerOptions,
+  type TransformResult,
+  createDefaultTransformer,
+} from './transformer/index.js';
+export { type Resolver, type ResolverOptions, createDefaultResolver } from './resolver/index.js';

package/src/loader/index.test.ts

@@ -1,6 +1,8 @@
 import fs, { readFile, writeFile } from 'fs/promises';
+import { randomUUID } from 'node:crypto';
 import { jest } from '@jest/globals';
 import dedent from 'dedent';
+import { createDefaultTransformer } from '../index.js';
 import { createFixtures, FIXTURE_DIR_PATH, getFixturePath } from '../test/util.js';
 import { sleepSync } from '../util.js';
 
@@ -311,7 +313,83 @@ test('throws error the composition of non-existent file', async () => {
   }).rejects.toThrowError(`Could not resolve './2.css' in '<fixtures>/test/1.css'`);
 });
 
-test.todo('supports sourcemap file and inline sourcemap');
+describe('supports sourcemap', () => {
+  test('restores original locations from sourcemap', async () => {
+    const transformer = createDefaultTransformer();
+    const loader = new Loader({ transformer });
+    createFixtures({
+      '/test/1.scss': dedent`
+      .nesting {
+        dummy: '';
+        .nesting_child {
+          dummy: '';
+        }
+      }
+      `,
+    });
+    const result = await loader.load(getFixturePath('/test/1.scss'));
+    expect(result).toMatchInlineSnapshot(`
+      {
+        dependencies: [],
+        tokens: [
+          {
+            name: "nesting",
+            originalLocations: [
+              { filePath: "<fixtures>/test/1.scss", start: { line: 1, column: 1 }, end: { line: 1, column: 8 } },
+              { filePath: "<fixtures>/test/1.scss", start: { line: 3, column: 3 }, end: { line: 3, column: 10 } },
+            ],
+          },
+          {
+            name: "nesting_child",
+            originalLocations: [
+              { filePath: "<fixtures>/test/1.scss", start: { line: 3, column: 3 }, end: { line: 3, column: 16 } },
+            ],
+          },
+        ],
+      }
+    `);
+  });
+  test('treats originalLocation as empty if sourcemap is broken', async () => {
+    const uuid = randomUUID();
+    createFixtures({
+      [`/${uuid}/postcss.config.js`]: dedent`
+      module.exports = {
+        plugins: [],
+      };
+      `,
+      '/test/1.css': dedent`
+      .selector_list_a_1, .selector_list_a_2 {}
+      /* In postcss, including newlines in the selector list breaks the sourcemap. */
+      .selector_list_b_1,
+      .selector_list_b_2 {}
+      `,
+    });
+    const transformer = createDefaultTransformer({ postcssConfig: getFixturePath(`/${uuid}/postcss.config.js`) });
+    const loader = new Loader({ transformer });
+    const result = await loader.load(getFixturePath('/test/1.css'));
+    expect(result).toMatchInlineSnapshot(`
+      {
+        dependencies: [],
+        tokens: [
+          {
+            name: "selector_list_a_1",
+            originalLocations: [
+              { filePath: "<fixtures>/test/1.css", start: { line: 1, column: 1 }, end: { line: 1, column: 18 } },
+            ],
+          },
+          {
+            name: "selector_list_a_2",
+            originalLocations: [
+              { filePath: "<fixtures>/test/1.css", start: { line: 1, column: 1 }, end: { line: 1, column: 18 } },
+            ],
+          },
+          { name: "selector_list_b_1", originalLocations: [{}] },
+          { name: "selector_list_b_2", originalLocations: [{}] },
+        ],
+      }
+    `);
+  });
+});
 
 test('ignores http(s) protocol file', async () => {
   createFixtures({