@lipemat/js-boilerplate-shared 0.0.1

package/README.md

@@ -0,0 +1 @@
+"# js-boilerplate-shared" 

package/config/jest.config.js

@@ -0,0 +1,29 @@
+const jestConfig = {
+    globals: {
+        __TEST__: true,
+    },
+    roots: [
+        './tests',
+    ],
+    transform: {
+        '^.+\\.m?[tj]sx?$': ['babel-jest', {
+                presets: [
+                    ['@babel/preset-env', { targets: { node: 'current' } }],
+                    '@babel/preset-typescript',
+                ],
+                plugins: [
+                    ['babel-plugin-transform-import-meta', { module: 'ES6' }],
+                ],
+            }],
+    },
+    transformIgnorePatterns: [
+        'node_modules/(?!@lipemat)',
+    ],
+    moduleNameMapper: {
+        '\\.(pcss|less|css)$': 'identity-obj-proxy',
+        'is-plain-obj': 'identity-obj-proxy',
+        uuid: 'identity-obj-proxy',
+    },
+};
+export default jestConfig;
+//# sourceMappingURL=jest.config.js.map

package/config/jest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.js","sourceRoot":"","sources":["jest.config.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAW;IAC1B,OAAO,EAAE;QACR,QAAQ,EAAE,IAAI;KACd;IACD,KAAK,EAAE;QACN,SAAS;KACT;IACD,SAAS,EAAE;QACV,kBAAkB,EAAE,CAAE,YAAY,EAAE;gBACnC,OAAO,EAAE;oBACR,CAAE,mBAAmB,EAAE,EAAC,OAAO,EAAE,EAAC,IAAI,EAAE,SAAS,EAAC,EAAC,CAAE;oBACrD,0BAA0B;iBAC1B;gBACD,OAAO,EAAE;oBACR,CAAE,oCAAoC,EAAE,EAAC,MAAM,EAAE,KAAK,EAAC,CAAE;iBACzD;aACD,CAAE;KACH;IACD,uBAAuB,EAAE;QACxB,2BAA2B;KAC3B;IACD,gBAAgB,EAAE;QACjB,qBAAqB,EAAE,oBAAoB;QAC3C,cAAc,EAAE,oBAAoB;QACpC,IAAI,EAAE,oBAAoB;KAC1B;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/config/jest.config.ts

@@ -0,0 +1,31 @@
+import type {Config} from 'jest';
+
+const jestConfig: Config = {
+	globals: {
+		__TEST__: true,
+	},
+	roots: [
+		'./tests',
+	],
+	transform: {
+		'^.+\\.m?[tj]sx?$': [ 'babel-jest', {
+			presets: [
+				[ '@babel/preset-env', {targets: {node: 'current'}} ],
+				'@babel/preset-typescript',
+			],
+			plugins: [
+				[ 'babel-plugin-transform-import-meta', {module: 'ES6'} ],
+			],
+		} ],
+	},
+	transformIgnorePatterns: [
+		'node_modules/(?!@lipemat)',
+	],
+	moduleNameMapper: {
+		'\\.(pcss|less|css)$': 'identity-obj-proxy',
+		'is-plain-obj': 'identity-obj-proxy',
+		uuid: 'identity-obj-proxy',
+	},
+};
+
+export default jestConfig;

package/helpers/browserslist.js

@@ -0,0 +1,18 @@
+// @ts-expect-error
+import wpBrowsers from '@wordpress/browserslist-config';
+import browserslist from 'browserslist';
+/**
+ * Get the browserslist from the current project.
+ *
+ * - If specified using standard browserslist config, we will use that.
+ *
+ *  @link https://github.com/browserslist/browserslist#config-file
+ */
+export function getBrowsersList() {
+    const projectBrowsersList = browserslist();
+    if (browserslist(browserslist.defaults) === projectBrowsersList) {
+        return wpBrowsers;
+    }
+    return projectBrowsersList;
+}
+//# sourceMappingURL=browserslist.js.map

package/helpers/browserslist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserslist.js","sourceRoot":"","sources":["browserslist.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,UAAU,MAAM,gCAAgC,CAAC;AACxD,OAAO,YAAY,MAAM,cAAc,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC9B,MAAM,mBAAmB,GAAG,YAAY,EAAE,CAAC;IAC3C,IAAK,YAAY,CAAE,YAAY,CAAC,QAAQ,CAAE,KAAK,mBAAmB,EAAG,CAAC;QACrE,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC5B,CAAC"}

package/helpers/browserslist.ts

@@ -0,0 +1,18 @@
+// @ts-expect-error
+import wpBrowsers from '@wordpress/browserslist-config';
+import browserslist from 'browserslist';
+
+/**
+ * Get the browserslist from the current project.
+ *
+ * - If specified using standard browserslist config, we will use that.
+ *
+ *  @link https://github.com/browserslist/browserslist#config-file
+ */
+export function getBrowsersList(): readonly string[] {
+	const projectBrowsersList = browserslist();
+	if ( browserslist( browserslist.defaults ) === projectBrowsersList ) {
+		return wpBrowsers;
+	}
+	return projectBrowsersList;
+}

package/helpers/camel-case.js

@@ -0,0 +1,93 @@
+/**
+ * Convert a dash/dot/underscore/space separated string to camelCase or PascalCase
+ *
+ * Inspired by the 'camelcase' npm package, no longer maintained.
+ *
+ * ```ts
+ * import camelCase from '../helpers/camel-case';
+ *
+ * camelCase('foo-bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('foo_bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('Foo-Bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('Foo-Bar', true);
+ * //=> 'FooBar'
+ *
+ * camelCase('--foo.bar', false);
+ * //=> 'fooBar'
+ *
+ * camelCase('foo bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('--foo-bar');
+ * //=> 'fooBar'
+ *
+ * camelCase(['foo', 'bar']);
+ * //=> 'fooBar'
+ *
+ * camelCase(['__foo__', '--bar'], pascalCase);
+ * //=> 'FooBar'
+ * ```
+ */
+function preserveCamelCase(string) {
+    let isLastCharLower = false;
+    let isLastCharUpper = false;
+    let isLastLastCharUpper = false;
+    for (let i = 0; i < string.length; i++) {
+        const character = string[i];
+        if (isLastCharLower && /[a-zA-Z]/.test(character) && character.toUpperCase() === character) {
+            string = string.slice(0, i) + '-' + string.slice(i);
+            isLastCharLower = false;
+            isLastLastCharUpper = isLastCharUpper;
+            isLastCharUpper = true;
+            i++;
+        }
+        else if (isLastCharUpper && isLastLastCharUpper && /[a-zA-Z]/.test(character) && character.toLowerCase() === character) {
+            string = string.slice(0, i - 1) + '-' + string.slice(i - 1);
+            isLastLastCharUpper = isLastCharUpper;
+            isLastCharUpper = false;
+            isLastCharLower = true;
+        }
+        else {
+            isLastCharLower = character.toLowerCase() === character && character.toUpperCase() !== character;
+            isLastLastCharUpper = isLastCharUpper;
+            isLastCharUpper = character.toUpperCase() === character && character.toLowerCase() !== character;
+        }
+    }
+    return string;
+}
+export default function camelCase(input, pascalCase = false) {
+    let value;
+    if ('string' === typeof input) {
+        value = input.trim();
+    }
+    else {
+        value = input.map(x => x.trim())
+            .filter((item) => item.length > 0)
+            .join('-');
+    }
+    if (0 === value.length) {
+        return '';
+    }
+    if (1 === value.length) {
+        return pascalCase ? value.toUpperCase() : value.toLowerCase();
+    }
+    if (value !== value.toLowerCase()) {
+        value = preserveCamelCase(value);
+    }
+    value = value
+        .replace(/^[_.\- ]+/, '')
+        .toLowerCase()
+        .replace(/[_.\- ]+(\w|$)/g, (_, p1) => p1.toUpperCase())
+        .replace(/\d+(\w|$)/g, m => m.toUpperCase());
+    if (pascalCase) {
+        value = value.charAt(0).toUpperCase() + value.slice(1);
+    }
+    return value;
+}
+//# sourceMappingURL=camel-case.js.map

package/helpers/camel-case.js.map

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

package/helpers/camel-case.ts

@@ -0,0 +1,101 @@
+/**
+ * Convert a dash/dot/underscore/space separated string to camelCase or PascalCase
+ *
+ * Inspired by the 'camelcase' npm package, no longer maintained.
+ *
+ * ```ts
+ * import camelCase from '../helpers/camel-case';
+ *
+ * camelCase('foo-bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('foo_bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('Foo-Bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('Foo-Bar', true);
+ * //=> 'FooBar'
+ *
+ * camelCase('--foo.bar', false);
+ * //=> 'fooBar'
+ *
+ * camelCase('foo bar');
+ * //=> 'fooBar'
+ *
+ * camelCase('--foo-bar');
+ * //=> 'fooBar'
+ *
+ * camelCase(['foo', 'bar']);
+ * //=> 'fooBar'
+ *
+ * camelCase(['__foo__', '--bar'], pascalCase);
+ * //=> 'FooBar'
+ * ```
+ */
+
+function preserveCamelCase( string: string ): string {
+	let isLastCharLower = false;
+	let isLastCharUpper = false;
+	let isLastLastCharUpper = false;
+
+	for ( let i = 0; i < string.length; i++ ) {
+		const character = string[ i ];
+
+		if ( isLastCharLower && /[a-zA-Z]/.test( character ) && character.toUpperCase() === character ) {
+			string = string.slice( 0, i ) + '-' + string.slice( i );
+			isLastCharLower = false;
+			isLastLastCharUpper = isLastCharUpper;
+			isLastCharUpper = true;
+			i++;
+		} else if ( isLastCharUpper && isLastLastCharUpper && /[a-zA-Z]/.test( character ) && character.toLowerCase() === character ) {
+			string = string.slice( 0, i - 1 ) + '-' + string.slice( i - 1 );
+			isLastLastCharUpper = isLastCharUpper;
+			isLastCharUpper = false;
+			isLastCharLower = true;
+		} else {
+			isLastCharLower = character.toLowerCase() === character && character.toUpperCase() !== character;
+			isLastLastCharUpper = isLastCharUpper;
+			isLastCharUpper = character.toUpperCase() === character && character.toLowerCase() !== character;
+		}
+	}
+
+	return string;
+}
+
+
+export default function camelCase( input: string | ReadonlyArray<string>, pascalCase: boolean = false ): string {
+	let value: string;
+	if ( 'string' === typeof input ) {
+		value = input.trim();
+	} else {
+		value = input.map( x => x.trim() )
+			.filter( ( item: string ) => item.length > 0 )
+			.join( '-' );
+	}
+
+	if ( 0 === value.length ) {
+		return '';
+	}
+
+	if ( 1 === value.length ) {
+		return pascalCase ? value.toUpperCase() : value.toLowerCase();
+	}
+
+	if ( value !== value.toLowerCase() ) {
+		value = preserveCamelCase( value );
+	}
+
+	value = value
+		.replace( /^[_.\- ]+/, '' )
+		.toLowerCase()
+		.replace( /[_.\- ]+(\w|$)/g, ( _, p1 ) => p1.toUpperCase() )
+		.replace( /\d+(\w|$)/g, m => m.toUpperCase() );
+
+	if ( pascalCase ) {
+		value = value.charAt( 0 ).toUpperCase() + value.slice( 1 )
+	}
+
+	return value;
+}

package/helpers/config.js

@@ -0,0 +1,61 @@
+import { getPackageConfig } from './package-config.js';
+import { createRequire } from 'node:module';
+const requireModule = createRequire(import.meta.url);
+/**
+ * Get a list of installed js-boilerplate extensions.
+ *
+ * - Exclude @lipemat/js-boilerplate-shared and @lipemat/js-boilerplate
+ *   as they are libraries not extensions.
+ */
+export function getExtensions() {
+    const { dependencies, devDependencies } = getPackageConfig();
+    return [...Object.keys(dependencies), ...Object.keys(devDependencies)].filter((extension) => {
+        return extension.includes('js-boilerplate-') &&
+            extension !== '@lipemat/js-boilerplate-shared' &&
+            extension !== '@lipemat/js-boilerplate';
+    });
+}
+/**
+ * Get a config from any existing extension's /config directories
+ * merged into one.
+ *
+ * @param {string} fileName      - Name of the config file to load.
+ * @param {Object} defaultConfig - Default config sed for passing to an extension callback.
+ */
+export function getExtensionsConfig(fileName, defaultConfig) {
+    let mergedConfig = {};
+    for (const extension of getExtensions()) {
+        try {
+            let extensionConfig = requireModule(extension + '/config/' + fileName);
+            // For ES Modules, we need to use the default export.
+            if ('default' in extensionConfig) {
+                extensionConfig = extensionConfig.default;
+            }
+            if ('function' === typeof extensionConfig) {
+                mergedConfig = { ...mergedConfig, ...extensionConfig({ ...defaultConfig, ...mergedConfig }) };
+            }
+            else {
+                mergedConfig = { ...mergedConfig, ...extensionConfig };
+            }
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                if (!('code' in e) || 'MODULE_NOT_FOUND' !== e.code) {
+                    console.error(e);
+                }
+            }
+        }
+    }
+    return mergedConfig;
+}
+/**
+ * Ensure the file extension is .js.
+ */
+export function ensureJSExtension(fileName) {
+    const withoutExtension = fileName.replace(/\.(ts|js)$/, '');
+    if (!withoutExtension.endsWith('.js')) {
+        return withoutExtension + '.js';
+    }
+    return withoutExtension;
+}
+//# sourceMappingURL=config.js.map

package/helpers/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAE1C,MAAM,aAAa,GAAG,aAAa,CAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC;AAGvD;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC5B,MAAM,EAAC,YAAY,EAAE,eAAe,EAAC,GAAG,gBAAgB,EAAE,CAAC;IAE3D,OAAO,CAAE,GAAG,MAAM,CAAC,IAAI,CAAE,YAAY,CAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAE,eAAe,CAAE,CAAE,CAAC,MAAM,CAAE,CAAE,SAAiB,EAAG,EAAE;QAC5G,OAAO,SAAS,CAAC,QAAQ,CAAE,iBAAiB,CAAE;YAC7C,SAAS,KAAK,gCAAgC;YAC9C,SAAS,KAAK,yBAAyB,CAAC;IAC1C,CAAC,CAAE,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAoB,QAAgB,EAAE,aAAgB;IACxF,IAAI,YAAY,GAAM,EAAO,CAAC;IAC9B,KAAM,MAAM,SAAS,IAAI,aAAa,EAAE,EAAG,CAAC;QAC3C,IAAI,CAAC;YACJ,IAAI,eAAe,GAAG,aAAa,CAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAE,CAAC;YACzE,qDAAqD;YACrD,IAAK,SAAS,IAAI,eAAe,EAAG,CAAC;gBACpC,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC;YAC3C,CAAC;YACD,IAAK,UAAU,KAAK,OAAO,eAAe,EAAG,CAAC;gBAC7C,YAAY,GAAG,EAAC,GAAG,YAAY,EAAE,GAAG,eAAe,CAAE,EAAC,GAAG,aAAa,EAAE,GAAG,YAAY,EAAC,CAAE,EAAC,CAAC;YAC7F,CAAC;iBAAM,CAAC;gBACP,YAAY,GAAG,EAAC,GAAG,YAAY,EAAE,GAAG,eAAe,EAAC,CAAC;YACtD,CAAC;QACF,CAAC;QAAC,OAAQ,CAAC,EAAG,CAAC;YACd,IAAK,CAAC,YAAY,KAAK,EAAG,CAAC;gBAC1B,IAAK,CAAE,CAAE,MAAM,IAAI,CAAC,CAAE,IAAI,kBAAkB,KAAK,CAAC,CAAC,IAAI,EAAG,CAAC;oBAC1D,OAAO,CAAC,KAAK,CAAE,CAAC,CAAE,CAAC;gBACpB,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,YAAY,CAAC;AACrB,CAAC;AAGD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAE,QAAgB;IAClD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAE,YAAY,EAAE,EAAE,CAAE,CAAC;IAC9D,IAAK,CAAE,gBAAgB,CAAC,QAAQ,CAAE,KAAK,CAAE,EAAG,CAAC;QAC5C,OAAO,gBAAgB,GAAG,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,gBAAgB,CAAC;AACzB,CAAC"}

package/helpers/config.ts

@@ -0,0 +1,66 @@
+import {getPackageConfig} from './package-config.js';
+import {createRequire} from 'node:module';
+
+const requireModule = createRequire( import.meta.url );
+
+
+/**
+ * Get a list of installed js-boilerplate extensions.
+ *
+ * - Exclude @lipemat/js-boilerplate-shared and @lipemat/js-boilerplate
+ *   as they are libraries not extensions.
+ */
+export function getExtensions(): readonly string[] {
+	const {dependencies, devDependencies} = getPackageConfig();
+
+	return [ ...Object.keys( dependencies ), ...Object.keys( devDependencies ) ].filter( ( extension: string ) => {
+		return extension.includes( 'js-boilerplate-' ) &&
+			extension !== '@lipemat/js-boilerplate-shared' &&
+			extension !== '@lipemat/js-boilerplate';
+	} );
+}
+
+/**
+ * Get a config from any existing extension's /config directories
+ * merged into one.
+ *
+ * @param {string} fileName      - Name of the config file to load.
+ * @param {Object} defaultConfig - Default config sed for passing to an extension callback.
+ */
+export function getExtensionsConfig<T extends object>( fileName: string, defaultConfig: T ): T {
+	let mergedConfig: T = {} as T;
+	for ( const extension of getExtensions() ) {
+		try {
+			let extensionConfig = requireModule( extension + '/config/' + fileName );
+			// For ES Modules, we need to use the default export.
+			if ( 'default' in extensionConfig ) {
+				extensionConfig = extensionConfig.default;
+			}
+			if ( 'function' === typeof extensionConfig ) {
+				mergedConfig = {...mergedConfig, ...extensionConfig( {...defaultConfig, ...mergedConfig} )};
+			} else {
+				mergedConfig = {...mergedConfig, ...extensionConfig};
+			}
+		} catch ( e ) {
+			if ( e instanceof Error ) {
+				if ( ! ( 'code' in e ) || 'MODULE_NOT_FOUND' !== e.code ) {
+					console.error( e );
+				}
+			}
+		}
+	}
+
+	return mergedConfig;
+}
+
+
+/**
+ * Ensure the file extension is .js.
+ */
+export function ensureJSExtension( fileName: string ): string {
+	const withoutExtension = fileName.replace( /\.(ts|js)$/, '' );
+	if ( ! withoutExtension.endsWith( '.js' ) ) {
+		return withoutExtension + '.js';
+	}
+	return withoutExtension;
+}

package/helpers/css-classnames.js

@@ -0,0 +1,104 @@
+import { getPackageConfig } from './package-config.js';
+export const SHORT_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+export const ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+const classes = {};
+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() {
+    const short = getPackageConfig().shortCssClasses;
+    if ('object' === typeof short) {
+        return Boolean(short.js);
+    }
+    return Boolean(short);
+}
+/**
+ * Reset all counters.
+ *
+ * @notice Mostly here for unit tests.
+ */
+export function resetCounters() {
+    counters = [-1];
+}
+/**
+ * Get the next class in the sequence based on:
+ * 1. Single character from SHORT_ALPHABET (prevent conflicts with JS boilerplate).
+ * 2. Incremented character from the `ALPHABET`.
+ *      1. Used once requires 2+ characters.
+ *      2. Grows to 3+ characters as needed.
+ *
+ * @return {string}
+ */
+export function getNextClass() {
+    const last = counters.length - 1;
+    let totalLetters = ALPHABET.length - 1;
+    // The 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 the 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) {
+        // The 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 = ({ resourcePath }, _, localName) => {
+    classes[resourcePath] ||= {};
+    classes[resourcePath][localName] ||= getNextClass();
+    return classes[resourcePath][localName];
+};
+//# sourceMappingURL=css-classnames.js.map

package/helpers/css-classnames.js.map

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

package/helpers/css-classnames.ts

@@ -0,0 +1,124 @@
+import {getPackageConfig} from './package-config.js';
+import type {GetLocalIdent} from '../types/css-loader.ts';
+import type {AtLeast} from '../types/utility.ts';
+
+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 {
+	const short = getPackageConfig().shortCssClasses;
+	if ( 'object' === typeof short ) {
+		return Boolean( short.js );
+	}
+	return Boolean( short );
+}
+
+/**
+ * Reset all counters.
+ *
+ * @notice Mostly here for unit tests.
+ */
+export function resetCounters(): void {
+	counters = [ -1 ];
+}
+
+/**
+ * Get the next class in the sequence based on:
+ * 1. Single character from SHORT_ALPHABET (prevent conflicts with JS boilerplate).
+ * 2. Incremented character from the `ALPHABET`.
+ *      1. Used once requires 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;
+
+	// The 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 the 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 ) {
+		// The 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 );
+}
+
+type LocalIdentParams = Parameters<GetLocalIdent>;
+
+/**
+ * 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 = ( {resourcePath}: AtLeast<LocalIdentParams[0], 'resourcePath'>, _: LocalIdentParams[1], localName: LocalIdentParams[2] ): ReturnType<GetLocalIdent> => {
+	classes[ resourcePath ] ||= {};
+	classes[ resourcePath ][ localName ] ||= getNextClass();
+	return classes[ resourcePath ][ localName ];
+};