happy-css-modules 3.1.0 → 3.2.0

package/dist/resolver/index.js

@@ -0,0 +1,44 @@
+import { exists } from '../util.js';
+import { createNodeResolver } from './node-resolver.js';
+import { createRelativeResolver } from './relative-resolver.js';
+import { createWebpackResolver } from './webpack-resolver.js';
+/**
+ * The Default resolver.
+ *
+ * This resolver implements a resolve algorithm that is as compatible as possible with the major toolchains,
+ * including Node.js, webpack (css-loader, sass-loader, less-loader) and vite. It is difficult to completely
+ * mimic the behavior of these toolchains, so the behavior may differ in some cases.
+ *
+ * @param specifier The specifier to resolve (i.e. './foo.css', '~bootstrap', etc.)
+ * @param options The options to resolve
+ * @returns The resolved path (absolute). `false` means to skip resolving.
+ */
+export const createDefaultResolver = (defaultResolverOptions) => {
+    const relativeResolver = createRelativeResolver();
+    const nodeResolver = createNodeResolver();
+    const webpackResolver = createWebpackResolver(defaultResolverOptions);
+    // In less-loader, `relativeResolver` has priority over `webpackResolver`.
+    // happy-css-modules follows suit.
+    // ref: https://github.com/webpack-contrib/sass-loader/blob/49a578a218574ddc92a597c7e365b6c21960717e/src/utils.js#L588-L596
+    // ref: https://github.com/webpack-contrib/less-loader/tree/454e187f58046356c3d383d67fda763db8bfc528#webpack-resolver
+    const resolvers = [relativeResolver, nodeResolver, webpackResolver];
+    return async (specifier, options) => {
+        for (const resolver of resolvers) {
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                const resolved = await resolver(specifier, options);
+                if (resolved !== false) {
+                    // eslint-disable-next-line no-await-in-loop
+                    const isExists = await exists(resolved);
+                    if (isExists)
+                        return resolved;
+                }
+            }
+            catch (e) {
+                // noop
+            }
+        }
+        return false;
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resolver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAc9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA8E,CAC9G,sBAAsB,EACtB,EAAE;IACF,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAC1C,MAAM,eAAe,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,CAAC;IAEtE,0EAA0E;IAC1E,kCAAkC;IAClC,2HAA2H;IAC3H,qHAAqH;IACrH,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;QAClC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,4CAA4C;gBAC5C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACpD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;oBACvB,4CAA4C;oBAC5C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACxC,IAAI,QAAQ;wBAAE,OAAO,QAAQ,CAAC;gBAChC,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/resolver/index.test.d.ts

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

package/dist/resolver/index.test.js

@@ -0,0 +1,16 @@
+import { createFixtures, getFixturePath } from '../test-util/util.js';
+import { createDefaultResolver } from './index.js';
+const defaultResolver = createDefaultResolver();
+const request = getFixturePath('/test/1.css');
+test('resolve with webpackResolver when other resolvers fail to resolve', async () => {
+    createFixtures({
+        '/test/2.css': `.a {}`,
+        '/test/3.css': `.a {}`,
+        '/node_modules/3.css/index.css': `.a {}`,
+        '/node_modules/4.css/index.css': `.a {}`,
+    });
+    expect(await defaultResolver('2.css', { request })).toBe(getFixturePath('/test/2.css'));
+    expect(await defaultResolver('3.css', { request })).toBe(getFixturePath('/test/3.css'));
+    expect(await defaultResolver('~4.css', { request })).toBe(getFixturePath('/node_modules/4.css/index.css'));
+});
+//# sourceMappingURL=index.test.js.map

package/dist/resolver/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/resolver/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAC;AAChD,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAE9C,IAAI,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;IACnF,cAAc,CAAC;QACb,aAAa,EAAE,OAAO;QACtB,aAAa,EAAE,OAAO;QACtB,+BAA+B,EAAE,OAAO;QACxC,+BAA+B,EAAE,OAAO;KACzC,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACxF,MAAM,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACxF,MAAM,CAAC,MAAM,eAAe,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,+BAA+B,CAAC,CAAC,CAAC;AAC7G,CAAC,CAAC,CAAC"}

package/dist/resolver/node-resolver.d.ts

@@ -0,0 +1,2 @@
+import type { Resolver } from './index.js';
+export declare const createNodeResolver: () => Resolver;

package/dist/resolver/node-resolver.js

@@ -0,0 +1,6 @@
+import { fileURLToPath, pathToFileURL } from 'url';
+import { resolve } from 'import-meta-resolve';
+export const createNodeResolver = () => (specifier, options) => {
+    return fileURLToPath(resolve(specifier, pathToFileURL(options.request).href));
+};
+//# sourceMappingURL=node-resolver.js.map

package/dist/resolver/node-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-resolver.js","sourceRoot":"","sources":["../../src/resolver/node-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C,MAAM,CAAC,MAAM,kBAAkB,GAAmB,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;IAC7E,OAAO,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAChF,CAAC,CAAC"}

package/dist/resolver/node-resolver.test.d.ts

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

package/dist/resolver/node-resolver.test.js

@@ -0,0 +1,25 @@
+import { createFixtures, getFixturePath } from '../test-util/util.js';
+import { createNodeResolver } from './node-resolver.js';
+const nodeResolver = createNodeResolver();
+const request = getFixturePath('/test/1.css');
+test('resolves specifier with node mechanism', async () => {
+    createFixtures({
+        '/test/2.css': `.a {}`,
+        '/test/dir/3.css': `.a {}`,
+        '/4.css': `.a {}`,
+        '/test/5.css': `.a {}`,
+        '/node_modules/package-1/6.css': `.a {}`,
+        '/package.json': `{ "imports": { "#subpath-1": "./test/7.css", "#subpath-2/*.css": "./test/*.css" } }`,
+        '/test/7.css': `.a {}`,
+        '/test/8.css': `.a {}`,
+    });
+    expect(await nodeResolver('./2.css', { request })).toBe(getFixturePath('/test/2.css'));
+    expect(await nodeResolver('./dir/3.css', { request })).toBe(getFixturePath('/test/dir/3.css'));
+    expect(await nodeResolver('../4.css', { request })).toBe(getFixturePath('/4.css'));
+    expect(await nodeResolver(getFixturePath('/test/5.css'), { request })).toBe(getFixturePath('/test/5.css'));
+    expect(await nodeResolver('package-1/6.css', { request })).toBe(getFixturePath('/node_modules/package-1/6.css'));
+    expect(await nodeResolver('#subpath-1', { request })).toBe(getFixturePath('/test/7.css'));
+    // FIXME: For some reason, it does not pass...
+    // expect(await nodeResolver('#subpath-2/8.css', { request })).toBe(getFixturePath('/test/8.css'));
+});
+//# sourceMappingURL=node-resolver.test.js.map

package/dist/resolver/node-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-resolver.test.js","sourceRoot":"","sources":["../../src/resolver/node-resolver.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;AAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAE9C,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;IACxD,cAAc,CAAC;QACb,aAAa,EAAE,OAAO;QACtB,iBAAiB,EAAE,OAAO;QAC1B,QAAQ,EAAE,OAAO;QACjB,aAAa,EAAE,OAAO;QACtB,+BAA+B,EAAE,OAAO;QACxC,eAAe,EAAE,qFAAqF;QACtG,aAAa,EAAE,OAAO;QACtB,aAAa,EAAE,OAAO;KACvB,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,YAAY,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,MAAM,YAAY,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,MAAM,YAAY,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnF,MAAM,CAAC,MAAM,YAAY,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3G,MAAM,CAAC,MAAM,YAAY,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACjH,MAAM,CAAC,MAAM,YAAY,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1F,8CAA8C;IAC9C,mGAAmG;AACrG,CAAC,CAAC,CAAC"}

package/dist/resolver/relative-resolver.d.ts

@@ -0,0 +1,2 @@
+import type { Resolver } from './index.js';
+export declare const createRelativeResolver: () => Resolver;

package/dist/resolver/relative-resolver.js

@@ -0,0 +1,5 @@
+import { dirname, resolve } from 'path';
+export const createRelativeResolver = () => (specifier, options) => {
+    return resolve(dirname(options.request), specifier);
+};
+//# sourceMappingURL=relative-resolver.js.map

package/dist/resolver/relative-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-resolver.js","sourceRoot":"","sources":["../../src/resolver/relative-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGxC,MAAM,CAAC,MAAM,sBAAsB,GAAmB,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;IACjF,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC,CAAC"}

package/dist/resolver/relative-resolver.test.d.ts

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

package/dist/resolver/relative-resolver.test.js

@@ -0,0 +1,12 @@
+import { getFixturePath } from '../test-util/util.js';
+import { createRelativeResolver } from './relative-resolver.js';
+const relativeResolver = createRelativeResolver();
+const request = getFixturePath('/test/1.css');
+test('resolves specifier with relative mechanism', async () => {
+    expect(await relativeResolver('2.css', { request })).toBe(getFixturePath('/test/2.css'));
+    expect(await relativeResolver('./3.css', { request })).toBe(getFixturePath('/test/3.css'));
+    expect(await relativeResolver('dir/4.css', { request })).toBe(getFixturePath('/test/dir/4.css'));
+    expect(await relativeResolver('../5.css', { request })).toBe(getFixturePath('/5.css'));
+    expect(await relativeResolver(getFixturePath('/test/6.css'), { request })).toBe(getFixturePath('/test/6.css'));
+});
+//# sourceMappingURL=relative-resolver.test.js.map

package/dist/resolver/relative-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-resolver.test.js","sourceRoot":"","sources":["../../src/resolver/relative-resolver.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;AAClD,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAE9C,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC5D,MAAM,CAAC,MAAM,gBAAgB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACzF,MAAM,CAAC,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3F,MAAM,CAAC,MAAM,gBAAgB,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACjG,MAAM,CAAC,MAAM,gBAAgB,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,MAAM,gBAAgB,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;AACjH,CAAC,CAAC,CAAC"}

package/dist/resolver/webpack-resolver.d.ts

@@ -0,0 +1,24 @@
+import type { Resolver } from './index.js';
+export type WebpackResolverOptions = {
+    /** Working directory path. */
+    cwd?: string | undefined;
+    /**
+     * The option compatible with sass's `--load-path`. It is an array of relative or absolute paths.
+     * @example ['src/styles']
+     * @example ['/home/user/repository/src/styles']
+     */
+    sassLoadPaths?: string[] | undefined;
+    /**
+     * The option compatible with less's `--include-path`. It is an array of relative or absolute paths.
+     * @example ['src/styles']
+     * @example ['/home/user/repository/src/styles']
+     */
+    lessIncludePaths?: string[] | undefined;
+    /**
+     * The option compatible with webpack's `resolve.alias`. It is an object consisting of a pair of alias names and relative or absolute paths.
+     * @example { style: 'src/styles', '@': 'src' }
+     * @example { style: '/home/user/repository/src/styles', '@': '/home/user/repository/src' }
+     */
+    webpackResolveAlias?: Record<string, string> | undefined;
+};
+export declare const createWebpackResolver: (webpackResolverOptions?: WebpackResolverOptions | undefined) => Resolver;

package/dist/resolver/webpack-resolver.js

@@ -0,0 +1,91 @@
+import { basename, dirname, join, resolve } from 'path';
+import enhancedResolve from 'enhanced-resolve';
+import { exists } from '../util.js';
+// TODO: Support `resolve.alias` for Node.js API
+export const createWebpackResolver = (webpackResolverOptions) => {
+    const cwd = webpackResolverOptions?.cwd ?? process.cwd();
+    const sassLoadPaths = webpackResolverOptions?.sassLoadPaths?.map((path) => resolve(cwd, path));
+    const lessIncludePaths = webpackResolverOptions?.lessIncludePaths?.map((path) => resolve(cwd, path));
+    const webpackResolveAlias = webpackResolverOptions?.webpackResolveAlias
+        ? Object.fromEntries(Object.entries(webpackResolverOptions?.webpackResolveAlias).map(([key, value]) => [key, resolve(cwd, value)]))
+        : undefined;
+    /**
+     * A resolver compatible with css-loader.
+     *
+     * @see https://github.com/webpack-contrib/css-loader/blob/897e7dd250ccdb0d31e6c66d4cd0d009f2022a85/src/plugins/postcss-import-parser.js#L228-L235
+     */
+    const cssLoaderResolver = enhancedResolve.create.sync({
+        conditionNames: ['style'],
+        // We are not sure how "..." affects behavior...
+        mainFields: ['css', 'style', 'main', '...'],
+        mainFiles: ['index', '...'],
+        extensions: ['.css', '...'],
+        preferRelative: true,
+        alias: webpackResolveAlias ?? {},
+    });
+    /**
+     * A resolver compatible with sass-loader.
+     *
+     * @see https://github.com/webpack-contrib/sass-loader/blob/49a578a218574ddc92a597c7e365b6c21960717e/src/utils.js#L531-L539
+     */
+    const sassLoaderResolver = enhancedResolve.create.sync({
+        conditionNames: ['sass', 'style'],
+        mainFields: ['sass', 'style', 'main', '...'],
+        mainFiles: ['_index', 'index', '...'],
+        extensions: ['.sass', '.scss', '.css'],
+        restrictions: [/\.((sa|sc|c)ss)$/iu],
+        preferRelative: true,
+        alias: webpackResolveAlias ?? {},
+        modules: ['node_modules', ...(sassLoadPaths ?? [])],
+    });
+    /**
+     * A resolver compatible with less-loader.
+     *
+     * @see https://github.com/webpack-contrib/less-loader/blob/d74f740c100c4006b00dfb3e02c6d5aaf8713519/src/utils.js#L35-L42
+     */
+    const lessLoaderResolver = enhancedResolve.create.sync({
+        conditionNames: ['less', 'style'],
+        mainFields: ['less', 'style', 'main', '...'],
+        mainFiles: ['index', '...'],
+        extensions: ['.less', '.css'],
+        preferRelative: true,
+        alias: webpackResolveAlias ?? {},
+        modules: ['node_modules', ...(lessIncludePaths ?? [])],
+    });
+    // NOTE: In theory, `sassLoaderResolver` should only be used when the resolver is called from `sassTransformer`.
+    // However, we do not implement such behavior because it is cumbersome. If someone wants it, we will implement it.
+    const resolvers = [cssLoaderResolver, sassLoaderResolver, lessLoaderResolver];
+    return async (specifier, options) => {
+        // `~` prefix is optional.
+        // ref: https://github.com/webpack-contrib/css-loader/blob/5e6cf91fd3f0c8b5fb4b91197b98dc56abdef4bf/src/utils.js#L92-L95
+        // ref: https://github.com/webpack-contrib/sass-loader/blob/49a578a218574ddc92a597c7e365b6c21960717e/src/utils.js#L368-L370
+        // ref: https://github.com/webpack-contrib/less-loader/blob/d74f740c100c4006b00dfb3e02c6d5aaf8713519/src/utils.js#L72-L75
+        // eslint-disable-next-line no-param-reassign
+        if (specifier.startsWith('~'))
+            specifier = specifier.slice(1);
+        for (const resolver of resolvers) {
+            const specifierVariants = resolver === sassLoaderResolver
+                ? // Support partial import for sass
+                    // https://sass-lang.com/documentation/at-rules/import#partials
+                    // https://github.com/webpack-contrib/sass-loader/blob/0e9494074f69a6b6d47efea6c083a02a31a5ae84/test/sass/import-with-underscore.sass
+                    [join(dirname(specifier), `_${basename(specifier)}`), specifier]
+                : [specifier];
+            for (const specifierVariant of specifierVariants) {
+                try {
+                    const resolved = resolver(dirname(options.request), specifierVariant);
+                    if (resolved !== false) {
+                        // eslint-disable-next-line no-await-in-loop
+                        const isExists = await exists(resolved);
+                        if (isExists)
+                            return resolved;
+                    }
+                }
+                catch (e) {
+                    // noop
+                }
+            }
+        }
+        return false;
+    };
+};
+//# sourceMappingURL=webpack-resolver.js.map

package/dist/resolver/webpack-resolver.js.map

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

package/dist/resolver/webpack-resolver.test.d.ts

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

package/dist/resolver/webpack-resolver.test.js

@@ -0,0 +1,89 @@
+import { createFixtures, getFixturePath } from '../test-util/util.js';
+import { createWebpackResolver } from './webpack-resolver.js';
+test('resolves specifier with css-loader mechanism', async () => {
+    const webpackResolver = createWebpackResolver({
+        cwd: getFixturePath('/'),
+        webpackResolveAlias: {
+            '@relative': 'test/alias-relative',
+            '@absolute': getFixturePath('/test/alias-absolute'),
+        },
+    });
+    const request = getFixturePath('/test/1.css');
+    createFixtures({
+        '/node_modules/package-1/index.css': `.a {}`,
+        '/node_modules/package-2/index.css': `.a {}`,
+        '/node_modules/package-3/index.css': `.a {}`,
+        '/node_modules/package-4/package.json': `{ "style": "./style.css" }`,
+        '/node_modules/package-4/style.css': `.a {}`,
+        '/node_modules/@scoped/package-5/index.css': `.a {}`,
+        '/node_modules/package-6/index.css': `.a {}`,
+        '/test/alias-relative/alias.css': `.a {}`,
+        '/test/alias-absolute/alias.css': `.a {}`,
+    });
+    expect(await webpackResolver('~package-1/index.css', { request })).toBe(getFixturePath('/node_modules/package-1/index.css'));
+    expect(await webpackResolver('~package-2', { request })).toBe(getFixturePath('/node_modules/package-2/index.css'));
+    expect(await webpackResolver('~package-3/', { request })).toBe(getFixturePath('/node_modules/package-3/index.css'));
+    expect(await webpackResolver('~package-4', { request })).toBe(getFixturePath('/node_modules/package-4/style.css'));
+    expect(await webpackResolver('~@scoped/package-5/index.css', { request })).toBe(getFixturePath('/node_modules/@scoped/package-5/index.css'));
+    expect(await webpackResolver('package-6/index.css', { request })).toBe(getFixturePath('/node_modules/package-6/index.css'));
+    expect(await webpackResolver('@relative/alias.css', { request })).toBe(getFixturePath('/test/alias-relative/alias.css'));
+    expect(await webpackResolver('@absolute/alias.css', { request })).toBe(getFixturePath('/test/alias-absolute/alias.css'));
+});
+test('resolves specifier with sass-loader mechanism', async () => {
+    const webpackResolver = createWebpackResolver({
+        cwd: getFixturePath('/'),
+        sassLoadPaths: ['test/load-paths-relative', getFixturePath('/test/load-paths-absolute')],
+        webpackResolveAlias: {
+            '@relative': 'test/alias-relative',
+            '@absolute': getFixturePath('/test/alias-absolute'),
+        },
+    });
+    const request = getFixturePath('/test/1.scss');
+    createFixtures({
+        '/node_modules/package-1/index.scss': `.a {}`,
+        '/test/load-paths-relative/load-paths-relative.scss': `.a {}`,
+        '/test/load-paths-absolute/load-paths-absolute.scss': `.a {}`,
+        '/test/_partial-import.scss': `.a {}`,
+        '/test/alias-relative/alias.scss': `.a {}`,
+        '/test/alias-absolute/alias.scss': `.a {}`,
+    });
+    expect(await webpackResolver('~package-1/index.scss', { request })).toBe(getFixturePath('/node_modules/package-1/index.scss'));
+    expect(await webpackResolver('~package-1', { request })).toBe(getFixturePath('/node_modules/package-1/index.scss'));
+    // ref: https://github.com/webpack-contrib/sass-loader/blob/bed9fb5799a90020d43f705ea405f85b368621d7/test/scss/import-include-paths.scss#L1
+    expect(await webpackResolver('load-paths-relative', { request })).toBe(getFixturePath('/test/load-paths-relative/load-paths-relative.scss'));
+    expect(await webpackResolver('load-paths-absolute', { request })).toBe(getFixturePath('/test/load-paths-absolute/load-paths-absolute.scss'));
+    // https://sass-lang.com/documentation/at-rules/import#partials
+    // https://github.com/webpack-contrib/sass-loader/blob/0e9494074f69a6b6d47efea6c083a02a31a5ae84/test/sass/import-with-underscore.sass
+    expect(await webpackResolver('partial-import', { request: getFixturePath('/test/1.scss') })).toBe(getFixturePath('/test/_partial-import.scss'));
+    expect(await webpackResolver('test/partial-import', { request: getFixturePath('/test') })).toBe(getFixturePath('/test/_partial-import.scss'));
+    expect(await webpackResolver('@relative/alias.scss', { request })).toBe(getFixturePath('/test/alias-relative/alias.scss'));
+    expect(await webpackResolver('@absolute/alias.scss', { request })).toBe(getFixturePath('/test/alias-absolute/alias.scss'));
+});
+test('resolves specifier with less-loader mechanism', async () => {
+    const webpackResolver = createWebpackResolver({
+        cwd: getFixturePath('/'),
+        lessIncludePaths: ['test/include-paths-relative', getFixturePath('/test/include-paths-absolute')],
+        webpackResolveAlias: {
+            '@relative': 'test/alias-relative',
+            '@absolute': getFixturePath('/test/alias-absolute'),
+        },
+    });
+    const request = getFixturePath('/test/1.less');
+    createFixtures({
+        '/node_modules/package-1/index.less': `.a {}`,
+        '/test/include-paths-relative/include-paths-relative.less': `.a {}`,
+        '/test/include-paths-absolute/include-paths-absolute.less': `.a {}`,
+        '/test/alias-relative/alias.less': `.a {}`,
+        '/test/alias-absolute/alias.less': `.a {}`,
+    });
+    expect(await webpackResolver('~package-1/index.less', { request })).toBe(getFixturePath('/node_modules/package-1/index.less'));
+    expect(await webpackResolver('~package-1', { request })).toBe(getFixturePath('/node_modules/package-1/index.less'));
+    // ref: https://github.com/webpack-contrib/less-loader/blob/81a0d27eb6d18e5dc550a60fc1007fdc77305b78/test/loader.test.js#L248-L253
+    // ref: https://github.com/webpack-contrib/less-loader/blob/393147064672ace986ec84aca21f69f0ab819a9c/test/fixtures/import-paths.less#L1
+    // ref: https://github.com/webpack-contrib/less-loader/blob/99d80bd290dae50375db6e17c5f56ec33754e258/test/helpers/getCodeFromLess.js#L47-L54
+    expect(await webpackResolver('include-paths-relative', { request })).toBe(getFixturePath('/test/include-paths-relative/include-paths-relative.less'));
+    expect(await webpackResolver('include-paths-absolute', { request })).toBe(getFixturePath('/test/include-paths-absolute/include-paths-absolute.less'));
+    expect(await webpackResolver('@relative/alias.less', { request })).toBe(getFixturePath('/test/alias-relative/alias.less'));
+    expect(await webpackResolver('@absolute/alias.less', { request })).toBe(getFixturePath('/test/alias-absolute/alias.less'));
+});
+//# sourceMappingURL=webpack-resolver.test.js.map

package/dist/resolver/webpack-resolver.test.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,78 @@
+import type { Resolver } from './resolver/index.js';
+import { type Transformer } from './transformer/index.js';
+export type Watcher = {
+    close: () => Promise<void>;
+};
+export type LocalsConvention = 'camelCase' | 'camelCaseOnly' | 'dashes' | 'dashesOnly' | undefined;
+export interface RunnerOptions {
+    pattern: string;
+    watch?: boolean | undefined;
+    /**
+     * Style of exported class names.
+     * @default undefined
+     */
+    localsConvention?: LocalsConvention | undefined;
+    declarationMap?: boolean | undefined;
+    transformer?: Transformer | undefined;
+    resolver?: Resolver | undefined;
+    /**
+     * The option compatible with sass's `--load-path`. It is an array of relative or absolute paths.
+     * @example ['src/styles']
+     * @example ['/home/user/repository/src/styles']
+     */
+    sassLoadPaths?: string[] | undefined;
+    /**
+     * The option compatible with less's `--include-path`. It is an array of relative or absolute paths.
+     * @example ['src/styles']
+     * @example ['/home/user/repository/src/styles']
+     */
+    lessIncludePaths?: string[] | undefined;
+    /**
+     * The option compatible with webpack's `resolve.alias`. It is an object consisting of a pair of alias names and relative or absolute paths.
+     * @example { style: 'src/styles', '@': 'src' }
+     * @example { style: '/home/user/repository/src/styles', '@': '/home/user/repository/src' }
+     */
+    webpackResolveAlias?: Record<string, 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;
+    /**
+     * Generate `.d.css.ts` instead of `.css.d.ts`.
+     * @default false
+     */
+    arbitraryExtensions?: boolean | undefined;
+    /**
+     * Only generate .d.ts and .d.ts.map for changed files.
+     * @default true
+     */
+    cache?: boolean | undefined;
+    /**
+     * Strategy for the cache to use for detecting changed files.
+     * @default 'content'
+     */
+    cacheStrategy?: 'content' | 'metadata' | undefined;
+    /**
+     * What level of logs to report.
+     * @default 'info'
+     */
+    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;
+};
+/**
+ * Run typed-css-module.
+ * @param options Runner options.
+ * @returns Returns `Promise<Watcher>` if `options.watch` is `true`, `Promise<void>` if `false`.
+ */
+export declare function run(options: OverrideProp<RunnerOptions, 'watch', true>): Promise<Watcher>;
+export declare function run(options: RunnerOptions): Promise<void>;
+export {};

package/dist/runner.js

@@ -0,0 +1,122 @@
+import { resolve, relative } from 'path';
+import * as process from 'process';
+import { createCache } from '@file-cache/core';
+import { createNpmPackageKey } from '@file-cache/npm';
+import AwaitLock from 'await-lock';
+import chalk from 'chalk';
+import * as chokidar from 'chokidar';
+import { glob } from 'glob';
+import { DEFAULT_ARBITRARY_EXTENSIONS } from './config.js';
+import { isGeneratedFilesExist, emitGeneratedFiles } from './emitter/index.js';
+import { Locator } from './locator/index.js';
+import { Logger } from './logger.js';
+import { createDefaultResolver } from './resolver/index.js';
+import { createDefaultTransformer } from './transformer/index.js';
+import { getInstalledPeerDependencies, isMatchByGlob } from './util.js';
+export async function run(options) {
+    // eslint-disable-next-line new-cap
+    const lock = new AwaitLock.default();
+    const logger = new Logger(options.logLevel ?? 'info');
+    const cwd = options.cwd ?? process.cwd();
+    const resolver = options.resolver ??
+        createDefaultResolver({
+            cwd,
+            sassLoadPaths: options.sassLoadPaths,
+            lessIncludePaths: options.lessIncludePaths,
+            webpackResolveAlias: options.webpackResolveAlias,
+        });
+    const transformer = options.transformer ?? createDefaultTransformer({ cwd, postcssConfig: options.postcssConfig });
+    const installedPeerDependencies = getInstalledPeerDependencies();
+    const cache = await createCache({
+        name: 'happy-css-modules',
+        mode: options.cacheStrategy ?? 'content',
+        keys: [
+            () => createNpmPackageKey(['happy-css-modules', ...installedPeerDependencies]),
+            () => {
+                return JSON.stringify(options);
+            },
+        ],
+        noCache: !(options.cache ?? true),
+    });
+    const locator = new Locator({ transformer, resolver });
+    const isExternalFile = (filePath) => {
+        return !isMatchByGlob(filePath, options.pattern, { cwd });
+    };
+    async function processFile(filePath) {
+        async function isChangedFile(filePath) {
+            const result = await cache.getAndUpdateCache(filePath);
+            // eslint-disable-next-line @typescript-eslint/no-throw-literal
+            if (result.error)
+                throw result.error;
+            return result.changed;
+        }
+        // Locator#load cannot be called concurrently. Therefore, it takes a lock and waits.
+        await lock.acquireAsync();
+        try {
+            const _isGeneratedFilesExist = await isGeneratedFilesExist(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.
+            // However, if .d.ts or .d.ts.map has not yet been generated, always generate.
+            if (_isGeneratedFilesExist && !_isChangedFile) {
+                logger.debug(chalk.gray(`${relative(cwd, filePath)} (skipped)`));
+                return;
+            }
+            const result = await locator.load(filePath);
+            await emitGeneratedFiles({
+                filePath,
+                tokens: result.tokens,
+                emitDeclarationMap: options.declarationMap,
+                dtsFormatOptions: {
+                    localsConvention: options.localsConvention,
+                    arbitraryExtensions: options.arbitraryExtensions,
+                },
+                isExternalFile,
+                outDir: options.outDir,
+                cwd,
+            });
+            logger.info(chalk.green(`${relative(cwd, filePath)} (generated)`));
+            await cache.reconcile(); // Update cache for the file
+        }
+        finally {
+            lock.release();
+        }
+    }
+    async function processAllFiles() {
+        const filePaths = (await glob(options.pattern, { dot: true, cwd }))
+            // convert relative path to absolute path
+            .map((file) => resolve(cwd, file));
+        const errors = [];
+        for (const filePath of filePaths) {
+            // eslint-disable-next-line no-await-in-loop
+            await processFile(filePath).catch((e) => errors.push(e));
+        }
+        if (errors.length > 0) {
+            throw new AggregateError(errors, 'Failed to process files');
+        }
+    }
+    if (!options.watch) {
+        logger.info(`Generate .d.ts for ${options.pattern}...`);
+        await processAllFiles();
+        // Write cache state to file for persistence
+    }
+    else {
+        // First, watch files.
+        logger.info(`Watch ${options.pattern}...`);
+        const watcher = chokidar.watch([options.pattern.replace(/\\/gu, '/')], { cwd });
+        watcher.on('all', (eventName, relativeFilePath) => {
+            const filePath = resolve(cwd, relativeFilePath);
+            // There is a bug in chokidar that matches symlinks that do not match the pattern.
+            // ref: https://github.com/paulmillr/chokidar/issues/967
+            if (isExternalFile(filePath))
+                return;
+            if (eventName !== 'add' && eventName !== 'change')
+                return;
+            processFile(filePath).catch((e) => {
+                logger.error(e);
+                // TODO: Emit a error by `Watcher#onerror`
+            });
+        });
+        return { close: async () => watcher.close() };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/runner.test.d.ts

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