@mlut/core 1.0.0

package/dist/sass/tools/functions/common/_utils.scss

@@ -0,0 +1,211 @@
+@use 'sass:list';
+@use 'sass:map';
+@use 'sass:meta';
+@use 'sass:math';
+@use 'sass:string';
+
+@use 'forward-tools' as ml;
+@use 'helpers';
+
+// Utils
+//
+// Basically, here are functions for internal needs. Perhaps the documentation will appear later.
+//
+/// Styleguide: sass-tools.functions.common.utils
+
+// convert-util-value
+//
+// Determines the type of utility and, depending on type, calls the converter from the `$util-value-converters` map. If the utility type is not recognized, the [default converter](#kssref-sass-tools-functions-utils-value_converters-def) is called. If the `$utils-value-converters` does not contain a converter for this type, the utility value is returned without conversion. Else the result of the converter work is returned.
+// ```scss
+//@debug ml.convert-util-value('2r', 'Fns'); // 2rem
+//@debug ml.convert-util-value(100, 'Fnw'); // 100
+// ```
+//
+// $util-val - utility value
+// $name - utility name
+// $section = 'utils' - section in the registry in which utility was defined
+//
+/// Styleguide: sass-tools.functions.common.utils.convert_util_value
+
+@function convert-util-value($util-val, $name, $section: 'utils') {
+	$result: null;
+
+	@if meta.type-of($util-val) == 'string' {
+		$multi-list-sep: if(
+			map.has-key(ml.$utils-db, $section, 'registry', $name, 'multi-list-separator'),
+			map.get(ml.$utils-db, $section, 'registry', $name, 'multi-list-separator'),
+			ml.$tUNls
+		);
+
+		@if string.index($util-val, $multi-list-sep) or string.index($util-val, ml.$tUSp) {
+			$converted: ();
+			$separator: map.get(ml.$utils-cfg, 'tokens-values', $multi-list-sep);
+
+			@each $list in ml.str-split($util-val, $multi-list-sep) {
+				$items: ml.str-split($list, ml.$tUSp);
+				$one-value: list.length($items) == 1;
+				$converted-items: ();
+
+				@each $value in $items {
+					$converted-items: list.append(
+						$converted-items,
+						apply-value-converter($value, $name, $section, $one-value)
+					);
+				}
+
+				$converted: list.append($converted, $converted-items, $separator);
+			}
+
+			$result: if(
+				list.length($converted) == 1,
+				list.nth($converted, 1),
+				$converted
+			);
+		} @else if string.slice($util-val, 1, 1) == ml.$tURv {
+			$result: string.unquote(string.slice($util-val, 2));
+		}
+	}
+
+	@if not $result {
+		$result: apply-value-converter($util-val, $name, $section);
+	}
+
+	@if map.has-key(
+		ml.$utils-db, $section, 'registry', $name, 'transformer'
+	) {
+		@return meta.call(
+			map.get(
+				ml.$utils-cfg,
+				'transformers',
+				map.get(ml.$utils-db, $section, 'registry', $name, 'transformer')
+			),
+			$result,
+			('name': $name)
+		);
+	}
+
+	@return $result;
+}
+
+@function apply-value-converter(
+	$util-value, $name, $section: 'utils', $one-value: true
+) {
+	@if ml.str-starts($util-value, ml.$tURv) {
+		@return string.unquote(string.slice($util-value, 2));
+	}
+
+	$conversion: (
+		map.get(ml.$utils-db, $section, 'registry', $name, 'conversion') or
+		'default'
+	);
+	$is-pipeline: false;
+	$negative: (
+		meta.type-of($util-value) == 'string' and
+		string.slice($util-value, 1, 1) == '-' and
+		not list.index(ml.$dec-digits, string.slice($util-value, 2, 2))
+	);
+
+	@if $negative {
+		$util-value: string.slice($util-value, 2);
+	}
+
+	@each $item in map.get(ml.$utils-cfg, 'conversion-types', $conversion) {
+		@if map.has-key(ml.$utils-cfg, 'converters', $item) {
+			$prev-value: $util-value;
+
+			$util-value: meta.call(
+				map.get(ml.$utils-cfg, 'converters', $item),
+				$util-value,
+				(
+					'name': $name,
+					'section': $section,
+					'negative': $negative,
+					'one-value': $one-value,
+				)
+			);
+
+			@if $util-value != $prev-value and not $is-pipeline {
+				@if $negative and ($item == 'keyword' or $item == 'global-kw') {
+					@if meta.type-of($util-value) == 'number' {
+						@return $util-value * -1;
+					} @else if(
+						helpers.is-css-var($util-value) or
+						meta.type-of($util-value) == 'calculation'
+					) {
+						@return calc($util-value * -1);
+					}
+				}
+
+				@return $util-value;
+			}
+		} @else if $item == ml.$kSsVCP {
+			$is-pipeline: true;
+		}
+	}
+
+	@if $negative {
+		$util-value: '-' + $util-value;
+	}
+
+	@return if(
+		//checks type again because here we could get after the converter pipeline
+		meta.type-of($util-value) == 'string',
+		string.unquote($util-value),
+		$util-value
+	);
+}
+
+@function parse-abbr($abbr) {
+	$abbr-value: '';
+	$abbr-prefix: '';
+	$hash-value-sep: ml.$tUHv;
+	$all-separators: ml.$abbr-separators;
+	$result: ();
+
+	@if string.slice($abbr, 1, 1) == '-' {
+		$abbr: string.slice($abbr, 2);
+		$abbr-prefix: '-';
+	}
+
+	@if ml.$tUHv == '' {
+		$hash-value-sep: '#';
+		$all-separators: list.append($all-separators, '#');
+	}
+
+	$abbr-name: $abbr;
+	$number-index: ml.str-digit-index($abbr);
+	$separator: ml.ls-find(
+		$all-separators, meta.get-function('str-contains-item', false, ml), $abbr
+	);
+
+	$sep-before-digit: if(
+		$separator and $number-index,
+		$number-index > string.index($abbr, $separator),
+		true
+	);
+
+	@if $separator and $sep-before-digit {
+		$abbr-parts: ml.str-split($abbr, $separator, 1);
+		$abbr-name: list.nth($abbr-parts, 1);
+		$abbr-value: list.nth($abbr-parts, 2);
+
+		@if ml.$tUNv == '' and $separator == '-' and ml.str2n($abbr-value) {
+			$abbr-value: '-' + $abbr-value;
+		} @else if $separator == $hash-value-sep or $separator == ml.$tURv {
+			$abbr-value: $separator + $abbr-value;
+		} @else {
+			$result: map.set($result, 'separator', $separator);
+		}
+	} @else if ml.$tUNv == '' and $number-index {
+		$abbr-name: string.slice($abbr, 1, $number-index - 1);
+		$abbr-value: string.slice($abbr, $number-index);
+	}
+
+	@return map.merge(
+		$result,
+		(
+			'value': $abbr-value,
+			'name': $abbr-prefix + $abbr-name,
+		)
+	);
+}

package/dist/sass/tools/functions/high/_at-rules.scss

@@ -0,0 +1,296 @@
+@use 'sass:list';
+@use 'sass:map';
+@use 'sass:string';
+@use 'sass:math';
+@use 'sass:meta';
+
+@use 'forward-tools' as ml;
+
+// At-rules
+//
+// Functions for working with at-rules.
+//
+/// Styleguide: sass-tools.functions.high.at_rules
+
+$-tALs-length: string.length(ml.$tALs);
+$-tACs-length: string.length(ml.$tACs);
+
+@function convert-bp-list($bp-list) {
+	$from: list.nth($bp-list, 1);
+	$is-max: ml.str-starts($from, ml.$tALs);
+
+	@if $is-max {
+		$from: string.slice($from, $-tALs-length + 1);
+	}
+
+	$from-value: map.get(ml.$bp-map, $from);
+
+	@if not $from-value {
+		@return ml.error(
+			'Invalid breakpoint name: `#{$from}`',
+		);
+	}
+
+	$media-str: '(min-width: #{$from-value})';
+
+	@if $is-max {
+		$media-str: '(max-width: #{$from-value - 1px})';
+	} @else if list.length($bp-list) >= 2 {
+		$media-str:
+			$media-str + ' and (max-width: #{ml.bp(list.nth($bp-list, 2)) - 1px})';
+	}
+
+	@return $media-str;
+}
+
+@function convert-feature-abbr($abbr, $section: 'utils') {
+	@if $abbr == '' {
+		@return ml.error('Passed empty string');
+	}
+
+	$result: '';
+	$abbr-data: ml.parse-abbr($abbr);
+	$abbr-feature: map.get($abbr-data, 'name');
+	$abbr-value: map.get($abbr-data, 'value');
+	$separator: map.get($abbr-data, 'separator');
+	$feat-prefix: '';
+	$feature: ml.util-prop($abbr-feature, $section, false, true);
+
+	@if not $feature {
+		@if $section == 'container' and $abbr-value == '' {
+			@return $abbr;
+		}
+
+		@return ml.error(
+			'Invalid feature abbreviation: `#{$abbr}`. `#{$abbr}` is not defined in `#{$section}` section of $utils-db map'
+		);
+	}
+
+	@if (
+		$abbr-value == '' and
+		not map.has-key(ml.$utils-db, $section, 'registry', $abbr-feature, 'keywords')
+	) {
+		@return '(#{$feature})';
+	}
+
+	@if $separator {
+		@if string.index($separator, ml.$tALs) {
+			$feat-prefix: 'max-';
+		} @else if string.index($separator, ml.$tAGt) {
+			$feat-prefix: 'min-';
+		}
+	}
+
+	$feat-value: ml.convert-util-value($abbr-value, $abbr-feature, $section);
+
+	@if meta.type-of($feat-value) == 'number' {
+		$value-unit: math.unit($feat-value);
+
+		@if $value-unit == 'u' {
+			$feat-value: ml.su($feat-value);
+		}
+
+		@if $separator == ml.$tALs or $separator == ml.$tAGt {
+			$value-diff: bp-value-diff($feat-value, $value-unit);
+
+			@if $separator == ml.$tALs {
+				$value-diff: $value-diff * -1;
+			}
+
+			$feat-value: $feat-value + $value-diff;
+		}
+	}
+
+	@return '(#{$feat-prefix + $feature}: #{$feat-value})';
+}
+
+@function bp-value-diff($value, $computed-unit: null) {
+	$unit: $computed-unit or math.unit($value);
+	$diff: map.get(ml.$general-cfg, 'units', 'css', $unit) or 1;
+
+	@if $unit == 'rem' or $unit == 'em' {
+		$diff: $diff * 0.06; // 1px = 0.062rem
+	} @else if $unit != 'px' and $unit != '' {
+		// TODO: add calculations for other units
+		$diff: $diff * 0.01;
+	}
+
+	@return $diff;
+}
+
+// Converters
+//
+// Converts abbreviations to at-rules. The name of the converter begins with `convert-ar-` and ends with the name of the at-rule, which it corresponds. The exception is the breakpoint converter. All converters take the same arguments, see below.
+//
+// Converter is bind to the at-rule that contains in the `$at-rules-db` map. It is recorded on the 'converter' key in the map of the relevant rule.
+//
+// Available converters:
+// ```scss
+//@debug ml.convert-ar-bp('<sm,xl'); // '(max-width: 519px), (min-width: 1168px)'
+//@debug ml.convert-ar-media('s:fc'); // 'screen and (forced-colors)'
+//@debug ml.convert-ar-supports('!&', 'D-ig'); // '(not (display: inline-grid))'
+// ```
+//
+// $ar - string with abbreviations
+// $this-util = null - utility for which the at-rules will be generated
+//
+/// Styleguide: sass-tools.functions.high.at_rules.converters
+
+@function convert-ar-bp($ar, $this-util: null) {
+	$result: '';
+	$queries: ml.str-split($ar, ml.$tAOr);
+
+	@each $queary in $queries {
+		$result: $result + convert-bp-list(ml.str-split($queary, ml.$tAAnd)) + ', ';
+	}
+
+	@return string.slice($result, 1, -3);
+}
+
+@function convert-ar-media($ar, $this-util: null) {
+	$result: '';
+	$queries: ml.str-split($ar, ml.$tAOr);
+	$and: ' and ';
+	$or: ', ';
+
+	@each $queary in $queries {
+		$queary-list: ml.str-split($queary, ml.$tAAnd);
+
+		@each $item in $queary-list {
+			@if map.has-key(ml.$at-rules-db, 'media', 'types', $item) {
+				$result: $result + map.get(ml.$at-rules-db, 'media', 'types', $item);
+			} @else if ml.str-starts($item, ml.$tACs) {
+				$item-name: string.slice($item, $-tACs-length + 1);
+
+				@if map.has-key(ml.$at-rules-db, 'media', 'custom', $item-name) {
+					$result: $result + map.get(ml.$at-rules-db, 'media', 'custom', $item-name);
+				} @else {
+					@return ml.error('Undefined custom media query: `#{$item}`');
+				}
+			} @else {
+				$result: $result + convert-feature-abbr($item, 'media');
+			}
+
+			$result: $result + $and;
+		}
+
+		$result: string.slice($result, 1, -(1 + string.length($and))) + $or;
+	}
+
+	@return string.slice($result, 1, -(1 + string.length($or)));
+}
+
+@function convert-ar-supports($ar, $this-util: null) {
+	@if $ar == '' and $this-util {
+		@return convert-feature-abbr(
+			map.get($this-util, 'name') + map.get($this-util, 'value')
+		);
+	}
+
+	$result: '';
+	$separator: ml.$tAAnd;
+	$operator: ' and ';
+
+	@if string.index($ar, ml.$tAOr) {
+		@if string.index($ar, ml.$tAAnd) {
+			@return ml.error('Different operators are not allowed in one abbreviations list');
+		}
+
+		$separator: ml.$tAOr;
+		$operator: ' or ';
+	}
+
+	@each $item in ml.str-split($ar, $separator) {
+		$converted: '';
+		$not: string.slice($item, 1, 1) == ml.$tANot;
+
+		@if $not {
+			$item: string.slice($item, 2);
+		}
+
+		@if ml.str-starts($item, ml.$tACs) {
+			$item-name: string.slice($item, 2);
+
+			@if map.has-key(ml.$at-rules-db, 'supports', 'custom', $item-name) {
+				$converted: map.get(ml.$at-rules-db, 'supports', 'custom', $item-name);
+			} @else {
+				@return ml.error('Undefined custom supports condition: `#{$item}`');
+			}
+		} @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');
+			}
+
+			$value: map.get($this-util, 'value');
+
+			@if $item == ml.$tSTu + ml.$tUSv {
+				$value: ml.$tUSv + 'ini';
+			} @else if $item != ml.$tSTu {
+				$value: string.slice($item, 2);
+			}
+
+			$converted: convert-feature-abbr(map.get($this-util, 'name') + $value);
+		} @else {
+			$converted: convert-feature-abbr(ml.str-ucfirst($item));
+		}
+
+		@if $not {
+			$converted: '(not #{$converted})';
+		}
+
+		$result: $result + $converted + $operator;
+	}
+
+	@return string.slice($result, 1, -(1 + string.length($operator)));
+}
+
+@function convert-ar-container($ar, $this-util: null) {
+	$result: '';
+	$queries: ml.str-split($ar, ml.$tAOr);
+	$and: ' and ';
+	$or: ', ';
+
+	@each $queary in $queries {
+		$queary-list: ml.str-split($queary, ml.$tAAnd);
+
+		@each $item in $queary-list {
+			$is-container-name: false;
+
+			@if ml.str-starts($item, ml.$tACs) {
+				$item-name: string.slice($item, $-tACs-length + 1);
+
+				@if map.has-key(ml.$at-rules-db, 'container', 'custom', $item-name) {
+					$result: $result + map.get(ml.$at-rules-db, 'container', 'custom', $item-name);
+				} @else {
+					@return ml.error('Undefined custom container condition: `#{$item}`');
+				}
+			} @else {
+				$converted: convert-feature-abbr($item, 'container');
+
+				@if $converted == $item {
+					$is-container-name: true;
+				}
+
+				$result: $result + $converted;
+			}
+
+			$result: $result + if($is-container-name, ' ', $and);
+		}
+
+		$result: string.slice($result, 1, -(1 + string.length($and))) + $or;
+	}
+
+	@return string.slice($result, 1, -(1 + string.length($or)));
+}
+
+@function convert-ar-layer($ar, $this-util: null) {
+	@return $ar;
+}
+
+@each $key, $value in ml.$at-rules-db {
+	@if meta.function-exists('convert-ar-#{$key}') {
+		ml.$at-rules-db: map.set(
+			ml.$at-rules-db, $key, 'converter', meta.get-function('convert-ar-#{$key}')
+		);
+	}
+}

package/dist/sass/tools/functions/high/_forward-tools.scss

@@ -0,0 +1,3 @@
+@forward '../../settings';
+@forward '../base';
+@forward '../common';

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

@@ -0,0 +1,8 @@
+// High
+//
+// High-level functions.
+//
+/// Styleguide: sass-tools.functions.high
+
+@forward 'utils';
+@forward 'at-rules';