@zelgadis87/utils-core 4.7.0 → 4.8.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@zelgadis87/utils-core",
-  "version": "4.7.0",
+  "version": "4.8.0",
   "author": "Zelgadis87",
   "license": "ISC",
   "private": false,

package/src/utils/css.ts

@@ -0,0 +1,33 @@
+import { isFunction, type TProducer } from "./index.ts";
+import { type TKeysOfType } from "./records.ts";
+
+export type TCSSRuleDeclarationKey = TKeysOfType<CSSStyleDeclaration, string> & string;
+export type TCSSVariableDeclarationKey = `--${string}`;
+export type TCSSGenericDeclarationKey = TCSSRuleDeclarationKey | TCSSVariableDeclarationKey;
+export type TCSSDeclarationRulesDictionary = Partial<Record<TCSSGenericDeclarationKey, string>>;
+// export type TCSSDeclarationProduceableRulesDictionary = Partial<Record<TCSSGenericDeclarationKey, TProduceable<string>>>;
+type TProduceable<T> = T | TProducer<T>;
+
+const newLine = '\n', tabulation = '\t', colon = ':', semiColon = ';', space = ' ', openBracket = '{', closeBracket = '}';
+
+export function cssDeclarationRulesDictionaryToCss( syleDeclarationRulesForSelectors: Record<string, TCSSDeclarationRulesDictionary> ) {
+	return Object.entries( syleDeclarationRulesForSelectors ).map( ( [ selector, styleDeclarationRules ] ) => {
+		const cssRules = cssSelectorDeclarationRulesDictionaryToCss( styleDeclarationRules );
+		if ( !cssRules.length ) return null;
+		return selector + space + openBracket + newLine + cssRules.map( rule => tabulation + rule + semiColon ).join( newLine ) + newLine + closeBracket;
+	} ).filter( Boolean ).join( newLine + newLine );
+}
+
+/* exported for test purposes only */
+export function cssSelectorDeclarationRulesDictionaryToCss( styleDeclarationRulesProduceable: TCSSDeclarationRulesDictionary ): string[] {
+	const styleDeclarationRules = produceableToValue( styleDeclarationRulesProduceable );
+	return Object.entries( styleDeclarationRules ).map( ( [ key, value ] ) => pascalCaseToKebabCase(key) + colon + space + produceableToValue( value ) );
+}
+
+function pascalCaseToKebabCase( s: string ) {
+	return s.split( /([A-Z][a-z]*)/ ).filter( Boolean ).map( n => n.toLowerCase() ).join( '-' );
+}
+
+function produceableToValue<T>( t: TProduceable<T> ): T {
+	return isFunction( t ) ? t() : t;
+}

package/src/utils/index.ts

@@ -1,6 +1,7 @@
 
 export * from './arrays.js';
 export * from './booleans.js';
+export { TCSSDeclarationRulesDictionary, cssDeclarationRulesDictionaryToCss } from './css.js';
 export * from './empties.js';
 export * from './errors.js';
 export * from './functions.js';

package/src/utils/strings/StringParts.ts

@@ -111,4 +111,15 @@ export class StringParts {
 		return new StringParts( ...parts );
 	};
 
+	/**
+	 * Tries to convert a word in PascalCase to an array of words. Will not work if there are spaces or special characters. Does not cope well on uppercase abbreviations (eg, "CSS").
+	 * @param s a string in PascalCase. 
+	 * @returns a StringParts where each sub-word in PascalCase is now a part.
+	 */
+	public static tryToParsePascalCaseWord( s: string ): StringParts {
+		return new StringParts( ...s.split( /([A-Z][a-z]*)/ ).filter( Boolean ).map( n => n.toLowerCase() ) );
+	}
+
 }
+
+