@lipemat/js-boilerplate 10.9.0 → 10.9.2

package/bin/lipemat-js-boilerplate.js

@@ -1,11 +1,6 @@
 #!/usr/bin/env node
 'use strict';
 
-// Update notifier.
-const updateNotifier = require( 'update-notifier' );
-const pkg = require( '../package.json' );
-updateNotifier( {pkg, shouldNotifyInNpmScript: true} ).notify();
-
 const spawn = require( 'cross-spawn' );
 const args = process.argv.slice( 2 );
 

package/config/css-loader.config.js

@@ -1,51 +1,45 @@
-const {getLocalIdent, usingShortCssClasses} = require( '../helpers/css-classnames' );
-
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const css_classnames_1 = require("../helpers/css-classnames");
 /**
  * Options for the Webpack `css-loader`.
  *
  * Extracted to its on file to allow easy overrides.
  */
-
 /**
  * Default to :global for classes in "global" or "pcss" directories.
  *
  * @param {string} resourcePath
  * @return {string}
  */
-const mode = resourcePath => {
-	if ( /globals?\//i.test( resourcePath.replace( /\\/g, '/' ) ) ) {
-		return 'global';
-	}
-	if ( /pcss?\//i.test( resourcePath.replace( /\\/g, '/' ) ) ) {
-		return 'global';
-	}
-	return 'local';
+const mode = (resourcePath) => {
+    if (/globals?\//i.test(resourcePath.replace(/\\/g, '/'))) {
+        return 'global';
+    }
+    if (/pcss?\//i.test(resourcePath.replace(/\\/g, '/'))) {
+        return 'global';
+    }
+    return 'local';
 };
-
-let cssLoader = {
-	importLoaders: 1,
-	modules: {
-		exportLocalsConvention: 'camelCase',
-		localIdentName: 'Ⓜ[name]__[local]__[contenthash:base64:2]',
-		mode,
-	},
-	sourceMap: true,
-	url: false,
+const cssLoader = {
+    importLoaders: 1,
+    modules: {
+        exportLocalsConvention: 'camelCase',
+        localIdentName: 'Ⓜ[name]__[local]__[contenthash:base64:2]',
+        mode,
+    },
+    sourceMap: true,
+    url: false,
 };
-
-if ( 'production' === process.env.NODE_ENV ) {
-	cssLoader = {
-		importLoaders: 1,
-		modules: {
-			exportLocalsConvention: 'camelCase',
-			// Use short CSS Classes if enabled.
-			...usingShortCssClasses() ? {getLocalIdent} : {},
-			// Hash used when short CSS classes are not enabled.
-			localIdentName: '[contenthash:base64:5]',
-			mode,
-		},
-		url: false,
-	};
+if ('production' === process.env.NODE_ENV) {
+    cssLoader.modules = {
+        exportLocalsConvention: 'camelCase',
+        // Use short CSS Classes if enabled.
+        ...(0, css_classnames_1.usingShortCssClasses)() ? { getLocalIdent: css_classnames_1.getLocalIdent } : {},
+        // Hash used when short CSS classes are not enabled.
+        localIdentName: '[contenthash:base64:5]',
+        mode,
+    };
+    cssLoader.sourceMap = false;
 }
-
 module.exports = cssLoader;

package/config/css-loader.config.ts

@@ -0,0 +1,52 @@
+import {getLocalIdent, usingShortCssClasses} from '../helpers/css-classnames';
+import type {Config, Mode} from '../types/css-loader';
+import type {AtLeast} from '../types/utility';
+
+export type CssLoaderConfig = AtLeast<Config, 'importLoaders' | 'modules' | 'sourceMap' | 'url'>
+
+/**
+ * Options for the Webpack `css-loader`.
+ *
+ * Extracted to its on file to allow easy overrides.
+ */
+
+/**
+ * Default to :global for classes in "global" or "pcss" directories.
+ *
+ * @param {string} resourcePath
+ * @return {string}
+ */
+const mode = ( resourcePath: string ): Mode => {
+	if ( /globals?\//i.test( resourcePath.replace( /\\/g, '/' ) ) ) {
+		return 'global';
+	}
+	if ( /pcss?\//i.test( resourcePath.replace( /\\/g, '/' ) ) ) {
+		return 'global';
+	}
+	return 'local';
+};
+
+const cssLoader: CssLoaderConfig = {
+	importLoaders: 1,
+	modules: {
+		exportLocalsConvention: 'camelCase',
+		localIdentName: 'Ⓜ[name]__[local]__[contenthash:base64:2]',
+		mode,
+	},
+	sourceMap: true,
+	url: false,
+};
+
+if ( 'production' === process.env.NODE_ENV ) {
+	cssLoader.modules = {
+		exportLocalsConvention: 'camelCase',
+		// Use short CSS Classes if enabled.
+		...usingShortCssClasses() ? {getLocalIdent} : {},
+		// Hash used when short CSS classes are not enabled.
+		localIdentName: '[contenthash:base64:5]',
+		mode,
+	}
+	cssLoader.sourceMap = false;
+}
+
+module.exports = cssLoader;

package/helpers/config.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.adjustBrowserslist = exports.getDefaultBrowsersList = exports.getBrowsersList = exports.getTsConfigFile = exports.getExtensionsConfig = exports.getConfig = exports.hasLocalOverride = void 0;
+exports.getDefaultBrowsersList = void 0;
+exports.hasLocalOverride = hasLocalOverride;
+exports.getConfig = getConfig;
+exports.getExtensionsConfig = getExtensionsConfig;
+exports.getTsConfigFile = getTsConfigFile;
+exports.getBrowsersList = getBrowsersList;
+exports.adjustBrowserslist = adjustBrowserslist;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const package_config_1 = require("./package-config");
@@ -32,10 +38,14 @@ function hasLocalOverride(fileName, inWorkingDirectory = false) {
         }
     }
     catch (e) {
+        if (e instanceof Error) {
+            if (!('code' in e) || 'MODULE_NOT_FOUND' !== e.code) {
+                console.error(e);
+            }
+        }
     }
     return hasLocal;
 }
-exports.hasLocalOverride = hasLocalOverride;
 /**
  * Get a config from our /config directory merged with any
  * matching configuration from the project directory.
@@ -77,10 +87,14 @@ function getConfig(fileName) {
         }
     }
     catch (e) {
+        if (e instanceof Error) {
+            if (!('code' in e) || 'MODULE_NOT_FOUND' !== e.code) {
+                console.error(e);
+            }
+        }
     }
     return mergedConfig;
 }
-exports.getConfig = getConfig;
 /**
  * Get a config from any existing extension's /config directories
  * merged into one.
@@ -106,11 +120,15 @@ function getExtensionsConfig(fileName, defaultConfig) {
             }
         }
         catch (e) {
+            if (e instanceof Error) {
+                if (!('code' in e) || 'MODULE_NOT_FOUND' !== e.code) {
+                    console.error(e);
+                }
+            }
         }
     });
     return mergedConfig;
 }
-exports.getExtensionsConfig = getExtensionsConfig;
 /**
  * Get the path to the "tsconfig.json" file if it exists.
  *
@@ -134,7 +152,6 @@ function getTsConfigFile() {
     });
     return tsConfig;
 }
-exports.getTsConfigFile = getTsConfigFile;
 /**
  * Get the browserslist from the current project.
  *
@@ -150,7 +167,6 @@ function getBrowsersList() {
     }
     return projectBrowsersList;
 }
-exports.getBrowsersList = getBrowsersList;
 /**
  * If browserslist is not specified, we fall back to WordPress defaults.
  *
@@ -183,4 +199,3 @@ function adjustBrowserslist(browserRules) {
     browserRules.push('not op_mini all');
     return browserRules;
 }
-exports.adjustBrowserslist = adjustBrowserslist;

package/helpers/config.ts

@@ -6,6 +6,7 @@ import type {JestConfig} from '../config/jest.config';
 import {getPackageConfig} from './package-config';
 import type {EntriesConfig} from '../config/entries.config';
 import type {Config as PostCSSConfig} from 'postcss-load-config';
+import type {CssLoaderConfig} from '../config/css-loader.config';
 
 // Must be required to avoid issues with browserslist.
 const browserslist = require( 'browserslist' );
@@ -13,6 +14,7 @@ const browserslist = require( 'browserslist' );
 
 type Configs = {
 	'babel.config': BabelConfig;
+	'css-loader.config': CssLoaderConfig;
 	'entries.config': EntriesConfig;
 	'jest.config': JestConfig;
 	'postcss.config': PostCSSConfig;
@@ -46,6 +48,11 @@ export function hasLocalOverride( fileName: string, inWorkingDirectory: boolean
 			hasLocal = true;
 		}
 	} catch ( e ) {
+		if ( e instanceof Error ) {
+			if ( ! ( 'code' in e ) || 'MODULE_NOT_FOUND' !== e.code ) {
+				console.error( e );
+			}
+		}
 	}
 
 	return hasLocal;
@@ -91,6 +98,11 @@ export function getConfig<T extends keyof Configs>( fileName: T ): Configs[T] {
 			mergedConfig = {...mergedConfig, ...localConfig};
 		}
 	} catch ( e ) {
+		if ( e instanceof Error ) {
+			if ( ! ( 'code' in e ) || 'MODULE_NOT_FOUND' !== e.code ) {
+				console.error( e );
+			}
+		}
 	}
 	return mergedConfig;
 }
@@ -119,6 +131,11 @@ export function getExtensionsConfig<T extends object>( fileName: string, default
 				mergedConfig = {...mergedConfig, ...extensionConfig};
 			}
 		} catch ( e ) {
+			if ( e instanceof Error ) {
+				if ( ! ( 'code' in e ) || 'MODULE_NOT_FOUND' !== e.code ) {
+					console.error( e );
+				}
+			}
 		}
 	} );
 

package/helpers/css-classnames.js

@@ -1,34 +1,35 @@
-const {getPackageConfig} = require( './package-config' );
-
-const SHORT_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
-const ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
-
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocalIdent = exports.ALPHABET = exports.SHORT_ALPHABET = void 0;
+exports.usingShortCssClasses = usingShortCssClasses;
+exports.resetCounters = resetCounters;
+exports.getNextClass = getNextClass;
+const package_config_1 = require("./package-config");
+exports.SHORT_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+exports.ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
 const classes = {};
-let counters = [ -1 ];
-
+let counters = [-1];
 /**
  * Check if short CSS classes are enabled.
  *
  * Using a helper function to allow for future enhancements.
  *
- * @since 10.3.0
+ * @since 4.6.0
  */
 function usingShortCssClasses() {
-	return getPackageConfig().shortCssClasses;
+    return Boolean((0, package_config_1.getPackageConfig)().shortCssClasses);
 }
-
 /**
  * Reset all counters.
  *
  * @notice Mostly here for unit tests.
  */
 function resetCounters() {
-	counters = [ -1 ];
+    counters = [-1];
 }
-
 /**
  * Get the next class is sequence based on:
- * 1. Single character from SHORT_ALPHABET (prevent conflicts with CSS boilerplate).
+ * 1. Single character from SHORT_ALPHABET (prevent conflicts with JS boilerplate).
  * 2. Incremented character from the `ALPHABET`.
  *      1. Used once require 2+ characters.
  *      2. Grows to 3+ characters as needed.
@@ -36,26 +37,22 @@ function resetCounters() {
  * @return {string}
  */
 function getNextClass() {
-	const last = counters.length - 1;
-	let totalLetters = ALPHABET.length - 1;
-
-	// First level uses the SHORT_ALPHABET.
-	if ( 0 === last ) {
-		totalLetters = SHORT_ALPHABET.length - 1;
-	}
-
-	if ( counters[ last ] < totalLetters ) {
-		counters[ last ]++;
-	} else {
-		incrementParent();
-	}
-
-	return counters.map( ( counter, i ) => {
-		return 0 === i ? SHORT_ALPHABET[ counter ] : ALPHABET[ counter ];
-	} ).join( '' );
+    const last = counters.length - 1;
+    let totalLetters = exports.ALPHABET.length - 1;
+    // First level uses the SHORT_ALPHABET.
+    if (0 === last) {
+        totalLetters = exports.SHORT_ALPHABET.length - 1;
+    }
+    if (counters[last] < totalLetters) {
+        counters[last]++;
+    }
+    else {
+        incrementParent();
+    }
+    return counters.map((counter, i) => {
+        return 0 === i ? exports.SHORT_ALPHABET[counter] : exports.ALPHABET[counter];
+    }).join('');
 }
-
-
 /**
  * When we run out of characters on the current level:
  * 1. Increment the parent level.
@@ -68,31 +65,28 @@ function getNextClass() {
  *
  */
 function incrementParent() {
-	let parent = counters.length - 2;
-	let totalLetters = ALPHABET.length - 1;
-
-	while ( counters[ parent ] !== undefined ) {
-		// First level uses the SHORT_ALPHABET.
-		if ( 0 === parent ) {
-			totalLetters = SHORT_ALPHABET.length - 1;
-		}
-		if ( counters[ parent ] < totalLetters ) {
-			counters[ parent ]++;
-			// Reset all child levels to 0.
-			while ( counters[ parent + 1 ] !== undefined ) {
-				counters[ parent + 1 ] = 0;
-				parent++;
-			}
-			return;
-		}
-		parent--;
-	}
-
-	// Add a new level and reset all existing levels.
-	counters.forEach( ( _, i ) => counters[ i ] = 0 );
-	counters.push( 0 );
+    let parent = counters.length - 2;
+    let totalLetters = exports.ALPHABET.length - 1;
+    while (counters[parent] !== undefined) {
+        // First level uses the SHORT_ALPHABET.
+        if (0 === parent) {
+            totalLetters = exports.SHORT_ALPHABET.length - 1;
+        }
+        if (counters[parent] < totalLetters) {
+            counters[parent]++;
+            // Reset all child levels to 0.
+            while (counters[parent + 1] !== undefined) {
+                counters[parent + 1] = 0;
+                parent++;
+            }
+            return;
+        }
+        parent--;
+    }
+    // Add a new level and reset all existing levels.
+    counters.forEach((_, i) => counters[i] = 0);
+    counters.push(0);
 }
-
 /**
  * Return a single character unique CSS class name based on WebPack
  * css-loader's `getLocalIdentName` callback.
@@ -104,17 +98,9 @@ function incrementParent() {
  *
  * @link https://webpack.js.org/loaders/css-loader/#getlocalident
  */
-const getLocalIdent = ( {resourcePath}, _, localName ) => {
-	classes[ resourcePath ] ||= {};
-	classes[ resourcePath ][ localName ] ||= getNextClass();
-	return classes[ resourcePath ][ localName ];
-};
-
-module.exports = {
-	ALPHABET,
-	SHORT_ALPHABET,
-	getLocalIdent,
-	getNextClass,
-	usingShortCssClasses,
-	resetCounters,
+const getLocalIdent = ({ resourcePath }, _, localName) => {
+    classes[resourcePath] ||= {};
+    classes[resourcePath][localName] ||= getNextClass();
+    return classes[resourcePath][localName];
 };
+exports.getLocalIdent = getLocalIdent;

package/helpers/css-classnames.ts

@@ -0,0 +1,117 @@
+import {getPackageConfig} from './package-config';
+import type {GetLocalIdent, Resource} from '../types/css-loader';
+
+export const SHORT_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+export const ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+
+const classes: {
+	[ filename: string ]: {
+		[ className: string ]: string
+	}
+} = {};
+
+let counters = [ -1 ];
+
+/**
+ * Check if short CSS classes are enabled.
+ *
+ * Using a helper function to allow for future enhancements.
+ *
+ * @since 4.6.0
+ */
+export function usingShortCssClasses(): boolean {
+	return Boolean( getPackageConfig().shortCssClasses );
+}
+
+/**
+ * Reset all counters.
+ *
+ * @notice Mostly here for unit tests.
+ */
+export function resetCounters(): void {
+	counters = [ -1 ];
+}
+
+/**
+ * Get the next class is sequence based on:
+ * 1. Single character from SHORT_ALPHABET (prevent conflicts with JS boilerplate).
+ * 2. Incremented character from the `ALPHABET`.
+ *      1. Used once require 2+ characters.
+ *      2. Grows to 3+ characters as needed.
+ *
+ * @return {string}
+ */
+export function getNextClass(): string {
+	const last = counters.length - 1;
+	let totalLetters = ALPHABET.length - 1;
+
+	// First level uses the SHORT_ALPHABET.
+	if ( 0 === last ) {
+		totalLetters = SHORT_ALPHABET.length - 1;
+	}
+
+	if ( counters[ last ] < totalLetters ) {
+		counters[ last ]++;
+	} else {
+		incrementParent();
+	}
+
+	return counters.map( ( counter, i ) => {
+		return 0 === i ? SHORT_ALPHABET[ counter ] : ALPHABET[ counter ];
+	} ).join( '' );
+}
+
+
+/**
+ * When we run out of characters on the current level:
+ * 1. Increment the parent level.
+ * 2. Reset current level and all child levels back to 0.
+ *
+ * If we are out of characters on the parent level or have
+ * no parent level:
+ * 1. Add a new child level.
+ * 2. Reset all levels back to 0.
+ *
+ */
+function incrementParent() {
+	let parent = counters.length - 2;
+	let totalLetters = ALPHABET.length - 1;
+
+	while ( counters[ parent ] !== undefined ) {
+		// First level uses the SHORT_ALPHABET.
+		if ( 0 === parent ) {
+			totalLetters = SHORT_ALPHABET.length - 1;
+		}
+		if ( counters[ parent ] < totalLetters ) {
+			counters[ parent ]++;
+			// Reset all child levels to 0.
+			while ( counters[ parent + 1 ] !== undefined ) {
+				counters[ parent + 1 ] = 0;
+				parent++;
+			}
+			return;
+		}
+		parent--;
+	}
+
+	// Add a new level and reset all existing levels.
+	counters.forEach( ( _, i ) => counters[ i ] = 0 );
+	counters.push( 0 );
+}
+
+/**
+ * Return a single character unique CSS class name based on WebPack
+ * css-loader's `getLocalIdentName` callback.
+ *
+ * Tracks CSS classes per each file so duplicate uses of the
+ * same class in a file receive the same result.
+ *
+ * @notice Only enabled if the `package.json` has `shortCssClasses` set to true.
+ *
+ * @link https://webpack.js.org/loaders/css-loader/#getlocalident
+ */
+export const getLocalIdent: GetLocalIdent = ( {resourcePath}: Resource, _: string, localName: string ): string => {
+	classes[ resourcePath ] ||= {};
+	classes[ resourcePath ][ localName ] ||= getNextClass();
+	return classes[ resourcePath ][ localName ];
+};

package/helpers/entries.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEntries = void 0;
+exports.getEntries = getEntries;
 const config_1 = require("./config");
 const package_config_1 = require("./package-config");
 const fs_1 = require("fs");
@@ -28,4 +28,3 @@ function getEntries() {
     });
     return matches;
 }
-exports.getEntries = getEntries;

package/helpers/modules.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBabelExcludeRegex = void 0;
+exports.getBabelExcludeRegex = getBabelExcludeRegex;
 const babel_loader_regex_builder_1 = require("are-you-es5/dist/babel-loader-regex-builder");
 const package_config_1 = require("./package-config");
 const are_you_es5_1 = require("are-you-es5");
@@ -25,4 +25,3 @@ function getBabelExcludeRegex() {
     // We must strip off the leading and trailing '/'.
     return new RegExp(regex.replace(/^\/|\/$/g, ''));
 }
-exports.getBabelExcludeRegex = getBabelExcludeRegex;

package/helpers/package-config.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPackageConfig = void 0;
+exports.getPackageConfig = getPackageConfig;
 const path_1 = require("path");
 const node_fs_1 = require("node:fs");
 const workingDirectory = (0, node_fs_1.realpathSync)(process.cwd());
@@ -33,7 +33,6 @@ catch (e) {
 function getPackageConfig() {
     return packageConfig;
 }
-exports.getPackageConfig = getPackageConfig;
 packageConfig.getPackageConfig = getPackageConfig;
 packageConfig.default = packageConfig;
 module.exports = packageConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lipemat/js-boilerplate",
-  "version": "10.9.0",
+  "version": "10.9.2",
   "description": "Dependencies and scripts for a no config JavaScript app",
   "author": "Mat Lipe",
   "license": "MIT",
@@ -28,7 +28,8 @@
     "config/",
     "helpers/",
     "lib/",
-    "scripts/"
+    "scripts/",
+    "types/"
   ],
   "bin": {
     "lipemat-js-boilerplate": "bin/lipemat-js-boilerplate.js"
@@ -43,12 +44,12 @@
     "watch": "ts-node ./bin/watch.ts"
   },
   "dependencies": {
-    "@babel/core": "^7.4.3",
+    "@babel/core": "^7.24.7",
     "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-    "@babel/plugin-transform-react-jsx-source": "^7.12.1",
-    "@babel/preset-env": "^7.22.9",
-    "@babel/preset-react": "^7.12.10",
-    "@babel/preset-typescript": "^7.12.7",
+    "@babel/plugin-transform-react-jsx-source": "^7.24.7",
+    "@babel/preset-env": "^7.24.7",
+    "@babel/preset-react": "^7.24.7",
+    "@babel/preset-typescript": "^7.24.7",
     "@csstools/postcss-global-data": "2.0.0",
     "@lipemat/eslint-config": "^3.1.3",
     "@pmmmwh/react-refresh-webpack-plugin": "^0.5.10",
@@ -94,8 +95,7 @@
     "react-refresh": "^0.14.0",
     "style-loader": "^3.3.1",
     "ts-node": "^10.9.1",
-    "typescript": "^5.1.3",
-    "update-notifier": "^4.1.3",
+    "typescript": "^5.5.2",
     "webpack": "^5.72.1",
     "webpack-assets-manifest": "^5.0.6",
     "webpack-cli": "^4.9.1",
@@ -111,5 +111,5 @@
     "memfs": "^3.5.3",
     "setimmediate": "^1.0.5"
   },
-  "packageManager": "yarn@4.1.1"
+  "packageManager": "yarn@4.3.1"
 }

package/tsconfig.json

@@ -9,7 +9,8 @@
     "lib/**/*",
     "jest/**/*",
     "scripts/**/*",
-    "src/**/*"
+    "src/**/*",
+    "types/**/*",
   ],
   "compilerOptions": {
     "esModuleInterop": true,

package/types/css-loader.d.ts

@@ -0,0 +1,87 @@
+/**
+ * No public types available.
+ *
+ * @link https://webpack.js.org/loaders/css-loader/#options
+ */
+
+import type {LoaderContext} from 'webpack';
+
+export type Mode = 'local' | 'global' | 'pure' | 'icss';
+
+export type Resource = LoaderContext<{
+	resourcePath: string
+}>;
+
+export type GetLocalIdent = ( context: Resource, localIdentName: string, localName: string ) => string;
+
+export type Modules =
+	| boolean
+	| 'local'
+	| 'global'
+	| 'pure'
+	| 'icss'
+	| {
+	auto: boolean | RegExp | ( ( resourcePath: string ) => boolean );
+	mode: Mode | ( ( resourcePath: string ) => Mode );
+	localIdentName: string;
+	localIdentContext: string;
+	localIdentHashSalt: string;
+	localIdentHashFunction: string;
+	localIdentHashDigest: string;
+	localIdentRegExp: string | RegExp;
+	getLocalIdent: GetLocalIdent;
+	namedExport: boolean;
+	exportGlobals: boolean;
+	exportLocalsConvention:
+		| 'asIs'
+		| 'camelCase'
+		| 'camelCaseOnly'
+		| 'dashes'
+		| 'dashesOnly'
+		| ( ( name: string ) => string );
+	exportOnlyLocals: boolean;
+	getJSON: ( {
+		resourcePath,
+		imports,
+		exports,
+		replacements,
+	}: {
+		resourcePath: string;
+		imports: object[];
+		exports: object[];
+		replacements: object[];
+	} ) => Promise<void> | void;
+};
+
+type Base = {
+	importLoaders?: number;
+	sourceMap?: boolean;
+	url?: boolean | {
+		filter: ( url: string, resourcePath: string ) => boolean;
+	};
+	importFn?: boolean | {
+		filter: (
+			url: string,
+			media: string,
+			resourcePath: string,
+			supports?: string,
+			layer?: string,
+		) => boolean;
+	};
+	esModule?: boolean;
+};
+
+
+type CssStyleSheetExport = Base & {
+	exportType?: 'css-style-sheet' | 'string';
+	modules?: Partial<Modules> & {
+		exportLocalsConvention: 'camelCaseOnly' | 'dashesOnly'
+	};
+};
+
+type ArrayExport = Base & {
+	exportType?: 'array';
+	modules: Partial<Modules>
+};
+
+export type Config = CssStyleSheetExport | ArrayExport;

package/types/utility.d.ts

@@ -0,0 +1 @@
+export type AtLeast<T, K extends keyof T> = Partial<T> & Required<Pick<T, K>>;