@mlut/core 1.0.0

package/dist/sass/tools/functions/high/utils/_index.scss

@@ -0,0 +1,288 @@
+@use 'sass:list';
+@use 'sass:map';
+@use 'sass:meta';
+@use 'sass:math';
+@use 'sass:string';
+@use 'sass:selector';
+@use 'sass:color';
+
+@forward 'value-converters';
+@forward 'parse-util';
+@forward 'util-apply-selector';
+@forward 'range-generators' as generate-uv-*;
+@forward 'value-transformers' as transform-uv-*;
+
+@use '../forward-tools' as ml;
+@use 'value-converters' as converters;
+@use 'value-transformers' as transformers;
+@use 'range-generators';
+@use 'parse-util' as pu;
+
+// Utilities
+//
+// Functions for working with utilities.
+//
+// Styleguide: sass-tools.functions.utils
+
+/// Styleguide: sass-tools.functions.high.utils
+
+@function convert-util-states($states, $this-util: null, $pre: false) {
+	$prefix: '&';
+	$suffix: '';
+
+	@if $pre {
+		$prefix: '';
+
+		@if string.slice($states, -1) == '.' {
+			$states: string.slice($states, 1, -2);
+		} @else {
+			$suffix: ' ';
+		}
+	}
+
+	$result: $prefix;
+	$or: ', ';
+
+	@each $state in ml.str-split($states, ml.$tSOr) {
+		@each $item in ml.str-split($state, ml.$tSAnd) {
+			$converted: '';
+			$not: string.slice($item, 1, 1) == ml.$tSNot;
+
+			@if $not {
+				$item: string.slice($item, 2);
+			}
+
+			@if map.has-key(ml.$utils-states, $item) {
+				$converted: map.get(ml.$utils-states, $item);
+			} @else if ml.str-starts($item, ml.$tSCs) {
+				$item-name: string.slice($item, string.length(ml.$tSCs) + 1);
+
+				@if map.has-key(ml.$utils-cfg, 'states', 'custom', $item-name) {
+					$converted: map.get(ml.$utils-cfg, 'states', 'custom', $item-name);
+				} @else {
+					@return ml.error('Undefined custom state: `#{$item}`');
+				}
+			} @else if ml.str-starts($item, ml.$tSCn) {
+				$ctx-value: string.slice($item, 2);
+				$converted: '.' + ml.str-escape(
+					ml.$cCtx + util-separated-value($ctx-value)
+				);
+			} @else if ml.str-starts($item, ml.$tSRaw) {
+				$converted: string.slice($item, 2);
+			} @else if ml.str-starts($item, ml.$tSTu) {
+				@if not $this-util {
+					@return ml.error('`#{ml.$tSTu}` cannot be used because $this-util is not passed');
+				}
+
+				@if $item == ml.$tSTu {
+					$converted: ml.str-escape(ml.$tSTu);
+				} @else if $item == ml.$tSTudv {
+					$converted: ml.css-class($this-util);
+				} @else {
+					$converted: ml.css-class($this-util + ml.str-escape(string.slice($item, 2)));
+				}
+			} @else if $item == '' {
+				$converted: ' ';
+			} @else {
+				$converted: $item;
+			}
+
+			@if $not {
+				$converted: ':not(#{$converted})';
+			}
+
+			$result: $result + $converted;
+		}
+
+		$result:  $result + $suffix + $or + $prefix;
+	}
+
+	@return string.slice($result, 1, -(1 + string.length($or) + string.length($prefix)));
+}
+
+@function util-separated-value($value) {
+	@if $value == '' {
+		@return '';
+	}
+
+	@if ml.str2n($value) {
+		@return ml.$tUNv + $value;
+	}
+
+	$str-value: if(
+		meta.type-of($value) == 'string',
+		$value,
+		$value + ''
+	);
+
+	$first-char: string.slice($str-value, 1, 1);
+
+	@if $first-char == '#' {
+		@return ml.$tUHv + $str-value;
+	}
+
+	@return if(
+		$first-char == ml.$tURv,
+		$str-value,
+		ml.$tUSv + $str-value
+	);
+}
+
+@function expand-util-kw-alias($raw-alias, $util) {
+	$alias-data: pu.parse-util($raw-alias);
+	$alias-list: ml.str-split(map.get($alias-data, 'value'), ml.$tUKwc);
+	$length: list.length($alias-list);
+	$values: ();
+
+	$result: if(
+		list.length($alias-data) > 1,
+		('components': map.remove($alias-data, 'value')),
+		()
+	);
+
+	@if $length == 1 {
+		$keywords: map.get(ml.$utils-db, 'utils', 'registry', $util, 'keywords');
+
+		@if meta.type-of($keywords) == 'map' {
+			$values: $keywords;
+		} @else {
+			@each $link in $keywords {
+				@if map.has-key(ml.$utils-db, 'utils', 'keywords', $link) {
+					$values: map.merge($values, map.get(ml.$utils-db, 'utils', 'keywords', $link));
+				}
+			}
+
+			@if $values == () {
+				$values: map.get(ml.$utils-db, 'common', 'keywords', 'css');
+			}
+		}
+	} @else if $length == 2 {
+		$group: list.nth($alias-list, 2);
+
+		@if map.has-key(ml.$utils-db, 'common', 'keywords', $group) {
+			$values: map.get(ml.$utils-db, 'common', 'keywords', $group);
+		} @else if $group == 'General' {
+			$values: map.merge(
+				map.get(ml.$utils-db, 'common', 'keywords', 'css'),
+				map.get(ml.$utils-db, 'common', 'keywords', 'global'),
+			);
+		} @else if $group == 'All' {
+			$values: map.merge(
+				map.merge(
+					map.get(ml.$utils-db, 'common', 'keywords', 'css'),
+					map.get(ml.$utils-db, 'common', 'keywords', 'global'),
+				),
+				map.get(ml.$utils-db, 'utils', 'registry', $util, 'keywords') or ()
+			);
+		} @else {
+			@return ml.error('Invalid keyword group alias: `#{$group}`');
+		}
+	} @else {
+		$section: list.nth($alias-list, 2);
+		$group: list.nth($alias-list, 3);
+
+		@if not map.has-key(ml.$utils-db, $section, 'keywords', $group) {
+			@return ml.error('Not found keywords on this path: `#{$section}.#{$group}`');
+		}
+
+		$values: map.get(ml.$utils-db, $section, 'keywords', $group);
+	}
+
+	@if map.has-key($values, '') {
+		@if ml.$uv-kw-alias-behavior == 1 {
+			$def-value: map.get($values, '');
+			$kw-def-value-index: list.index(
+				map.values(map.set($values, '', null)), $def-value
+			);
+
+			@if $kw-def-value-index {
+				$values: map.remove(
+					$values, list.nth(list.nth($values, $kw-def-value-index), 1)
+				);
+			}
+		} @else if ml.$uv-kw-alias-behavior == 2 {
+			$values: map.remove($values, '');
+		}
+	}
+
+	@return map.set($result, 'values', $values);
+}
+
+// uv
+//
+// Get CSS value of utility.
+// ```scss
+//@debug ml.uv('D'); // 'block'
+//@debug ml.uv('C#c06*80'); // rgba(204, 0, 102, 0.8)
+//@debug ml.uv('M3gg;a;gSm'); // calc(var(--ml-gg) * 3) auto 520px
+//```
+//
+// $util -  `string` <div> Any utility </div>
+//
+// Styleguide: sass-tools.functions.utils.uv
+
+/// Styleguide: sass-tools.functions.high.utils.uv
+
+@function uv($util) {
+	@if $util == '' {
+		@return ml.error('Empty string passed');
+	}
+
+	$util-data: ml.parse-abbr($util);
+
+	@return ml.convert-util-value(
+		map.get($util-data, 'value'),
+		map.get($util-data, 'name'),
+	);
+}
+
+// TODO: replace several `map.set()` to one `map.merge`
+$-util-value-converters: ();
+
+$-fn-prefix-length: string.length('convert-uv-');
+
+@each $key, $value in meta.module-functions(converters) {
+	$-util-value-converters: map.set(
+		$-util-value-converters, string.slice($key, $-fn-prefix-length + 1), $value
+	);
+}
+
+ml.$utils-cfg: map.set(
+	ml.$utils-cfg,
+	'converters',
+	map.merge(
+		$-util-value-converters, map.get(ml.$utils-cfg, 'converters')
+	)
+);
+
+$-util-range-generators: ();
+
+@each $key, $value in meta.module-functions(range-generators) {
+	$-util-range-generators: map.set(
+		$-util-range-generators, ml.str-replace($key, '-range'), $value
+	);
+}
+
+ml.$utils-cfg: map.set(
+	ml.$utils-cfg,
+	'range-generators',
+	map.merge(
+		$-util-range-generators, map.get(ml.$utils-cfg, 'range-generators')
+	)
+);
+
+$-util-value-transformers: ();
+
+@each $key, $value in meta.module-functions(transformers) {
+	$-util-value-transformers: map.set(
+		$-util-value-transformers, $key, $value
+	);
+}
+
+ml.$utils-cfg: map.set(
+	ml.$utils-cfg,
+	'transformers',
+	map.merge(
+		$-util-value-transformers, map.get(ml.$utils-cfg, 'transformers')
+	)
+);

package/dist/sass/tools/functions/high/utils/_parse-util.scss

@@ -0,0 +1,107 @@
+@use 'sass:list';
+@use 'sass:map';
+@use 'sass:meta';
+@use 'sass:string';
+
+@use '../forward-tools' as ml;
+
+$-ar-keywords: list.join(
+	map.keys(ml.$bp-map),
+	map.keys(map.get(ml.$at-rules-cfg, 'keywords')),
+);
+$-states-tokens: (ml.$tSCn, ml.$tSAnd, ml.$tSTu);
+
+// parse-util
+//
+// Parse utility value or name. Return map with passed value components:
+// - `value` - pure value or name
+// - `mq` - breakpoint or any mediaquery
+// ```scss
+//parse-util('1u_md') => ('value': '1u', 'mq': 'md')
+// ```
+//
+// $raw-value - utility value or name. Type string.
+//
+/// Styleguide: sass-tools.functions.high.utils.parse_util
+
+@function parse-util($raw-value) {
+	$raw-value-parts: ml.str-split($raw-value + '', ml.$tUCm);
+	$result: ();
+	$at-rules: null;
+	$value: null;
+	$states: ();
+	$comp-indexes: ();
+	$i: 1;
+
+	@if list.length($raw-value-parts) > 1 {
+		@each $component in $raw-value-parts {
+			$component-trimmed: ml.str-trim($component);
+			$component-item: list.nth(ml.str-split($component-trimmed, ' '), 1);
+
+			@if string.slice($component-item, 1, 1) == ml.$tSNot {
+				$component-item: string.slice($component-item, 2);
+			}
+
+			$part: list.nth(ml.str-split(
+				list.nth(ml.str-split($component-item, ml.$tSOr), 1),
+				ml.$tSAnd
+			), 1);
+
+			@if not $at-rules and (
+				string.index($part, ml.$tAAr) or
+				list.index($-ar-keywords, $part) or
+				ml.str-starts($part, ml.$tALs)
+			) {
+				$at-rules: $component-trimmed;
+				$comp-indexes: map.set($comp-indexes, 'ar', $i);
+			} @else if (
+				not $value and not string.index($component, ' ') and
+				not list.index($-states-tokens, string.slice($component-item, 1, 1))
+			) {
+				$value: $component-trimmed;
+				$comp-indexes: map.set($comp-indexes, 'value', $i);
+			} @else {
+				$states: list.append($states, $component-trimmed);
+				$comp-indexes: map.set(
+					$comp-indexes, 'state' + list.length($states), $i
+				);
+			}
+
+			$i: $i + 1;
+		}
+	} @else {
+		$value: $raw-value;
+	}
+
+	@if not $value {
+		$value: $at-rules;
+		$comp-indexes: map.set($comp-indexes, 'value', map.get($comp-indexes, 'ar'));
+	} @else if $at-rules {
+		$result: map.set($result, 'at-rules', $at-rules);
+	}
+
+	@if not $value {
+		@return ml.error('Not specified value or name in string `#{$raw-value}`');
+	}
+
+	$i: 1;
+
+	@each $item in $states {
+		@if map.get($comp-indexes, 'state' + $i) < map.get($comp-indexes, 'value') {
+			$result: map.set($result, 'pre-states', $item);
+		} @else {
+			$result: map.set($result, 'post-states', $item);
+		}
+
+		$i: $i + 1;
+	}
+
+	@if meta.type-of($value) == 'string' and (
+		string.slice($value, -(string.length(ml.$tUIm))) == ml.$tUIm
+	) {
+		$value: string.slice($value, 1, -(1 + string.length(ml.$tUIm)));
+		$result: map.set($result, 'important', true);
+	}
+
+	@return map.set($result, 'value', $value);
+}