@omnisass/library 0.2.1 → 0.4.0

package/modules/utilities/helpers/misc/_url-encode.scss

@@ -1,6 +1,6 @@
-@forward 'url-encode.configs';
+@forward './url-encode.configs';
 
-@use 'url-encode.configs' as configs;
+@use './url-encode.configs' as configs;
 @use '../string/string-replace' as *;
 @use '../../loggers/log-invalid-type' as *;
 @use '../../validators/type-of/is-map' as *;
@@ -66,12 +66,11 @@
 /// 	значение - процентное представление символа.
 /// @return {String} - Закодированная строка, где все символы
 /// 	из карты замены преобразованы в их процентное
-/// 	представление. Строка безопасна для использования в
-/// 	любой части URL (path, query, fragment).
-/// @throws {Error} - Может выбросить ошибку при передаче
-/// 	нестрокового значения или если функция `string-replace`
-/// 	не определена. Требуется наличие функции `string-replace`
-/// 	в доступном scope.
+/// 	представление.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `string` (`$value`) или
+/// 	`map` (`$chars-map`). Компиляция Sass будет остановлена
+/// 	с ошибкой.
 /// @require {function} string-replace - Вспомогательная
 /// 	функция замены подстрок в строке. Должна быть определена
 /// 	и доступна для корректной работы данной функции.

package/modules/utilities/helpers/number/_number-ceil-to.scss

@@ -1,4 +1,6 @@
 @use 'sass:math';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
 
 /// Округляет число вверх до ближайшего кратного значения.
 ///
@@ -103,9 +105,59 @@
 /// @return {Number} - Число, округленное вверх до ближайшего
 /// 	значения, кратного `$nearest`. Сохраняет единицы
 /// 	измерения исходного числа `$value`.
-/// @throws {Error} - Может выбросить ошибку если `$value` или
-/// 	`$nearest` не являются числами, или если происходит
-/// 	деление на ноль.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function number-ceil-to($value, $nearest) {
-	@return math.ceil(math.div($value, $nearest)) * $nearest;
+
+	// Проверка типа первого параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'number-ceil-to',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение
+	// для шага округления. $nearest определяет, до какого ближайшего
+	// кратного значения нужно округлить исходное число.
+	@else if not is-number($nearest) {
+
+		// Если $nearest не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $value прошел валидацию.
+		@return log-invalid-type(
+			'number-ceil-to',
+			$nearest,
+			'$nearest',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - выполняем округление вверх.
+	@else {
+
+		// Формула округления вверх до ближайшего кратного значения:
+		// 1. math.div($value, $nearest) - делим исходное значение на шаг округления
+		// 2. math.ceil() - округляем результат деления вверх до ближайшего целого
+		// 3. * $nearest - умножаем округленное целое на шаг округления
+		//
+		// Математическая формула:
+		// result = ceil(value / nearest) × nearest
+		//
+		// Ключевая особенность: функция всегда округляет ВВЕРХ до ближайшего
+		// кратного значения, даже если исходное число уже близко к нижнему крайнему.
+		@return math.ceil(math.div($value, $nearest)) * $nearest;
+
+	}
+
 }

package/modules/utilities/helpers/number/_number-clamp-max.scss

@@ -1,4 +1,6 @@
 @use 'sass:math';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
 
 /// Ограничивает число сверху, обеспечивая максимальное
 /// значение.
@@ -13,7 +15,7 @@
 /// - Если `value ≤ max` → возвращает `value`
 ///
 /// Важные особенности функции:
-/// - Гарантирует, что результат будет не больше `$max`
+/// - Гарантирует, что результат будет не больше `$value-max`
 /// - Использует встроенную функцию `math.min()`
 /// - Работает с любыми числовыми значениями (целые, дробные,
 /// 	с единицами)
@@ -78,15 +80,68 @@
 /// 	сверху. Может быть любым числом: целым, дробным,
 /// 	положительным, отрицательным, с единицами измерения
 /// 	или без.
-/// @param {Number} $max - Максимальное допустимое значение.
-/// 	Если `$value` больше `$max`, возвращается `$max`.
+/// @param {Number} $value-max - Максимальное допустимое значение.
+/// 	Если `$value` больше `$value-max`, возвращается `$value-max`.
 /// @return {Number} - Наименьшее из двух значений: `$value`
-/// 	или `$max`. Если `$value` меньше или равно `$max`,
+/// 	или `$value-max`. Если `$value` меньше или равно `$value-max`,
 /// 	возвращается `$value`. В противном случае возвращается
-/// 	`$max`.
-/// @throws Не выбрасывает ошибок, безопасно обрабатывает
-/// 	все числовые значения. Оба аргумента должны быть
-/// 	числами для корректной работы.
-@function number-clamp-max($value, $max) {
-	@return math.min($value, $max);
+/// 	`$value-max`.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
+@function number-clamp-max($value, $value-max) {
+
+	// Проверка типа первого параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'number-clamp-max',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение
+	// максимального предела. $value-max определяет верхнюю границу,
+	// которую не может превышать возвращаемое значение.
+	@else if not is-number($value-max) {
+
+		// Если $value-max не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $value прошел валидацию.
+		@return log-invalid-type(
+			'number-clamp-max',
+			$value-max,
+			'$value-max',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - выполняем ограничение сверху.
+	@else {
+
+		// Формула ограничения значения сверху:
+		// Используем встроенную функцию math.min() для выбора
+		// меньшего из двух значений.
+		//
+		// Логика работы:
+		// - Если $value меньше или равен $value-max, возвращается $value
+		// - Если $value больше $value-max, возвращается $value-max
+		//
+		// Математическая формула:
+		// result = min(value, max-value)
+		//
+		// Ключевая особенность: функция гарантирует, что возвращаемое
+		// значение никогда не превысит указанный максимальный предел.
+		@return math.min($value, $value-max);
+
+	}
+
 }

package/modules/utilities/helpers/number/_number-clamp-min.scss

@@ -1,4 +1,6 @@
 @use 'sass:math';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
 
 /// Ограничивает число снизу, обеспечивая минимальное значение.
 ///
@@ -12,7 +14,7 @@
 /// - Если `value ≥ min` → возвращает `value`
 ///
 /// Важные особенности функции:
-/// - Гарантирует, что результат будет не меньше `$min`
+/// - Гарантирует, что результат будет не меньше `$value-min`
 /// - Использует встроенную функцию `math.max()`
 /// - Работает с любыми числовыми значениями (целые, дробные,
 /// 	с единицами)
@@ -86,15 +88,68 @@
 /// 	снизу. Может быть любым числом: целым, дробным,
 /// 	положительным, отрицательным, с единицами измерения или
 /// 	без.
-/// @param {Number} $min - Минимальное допустимое значение.
-/// 	Если `$value` меньше `$min`, возвращается `$min`.
+/// @param {Number} $value-min - Минимальное допустимое значение.
+/// 	Если `$value` меньше `$value-min`, возвращается `$value-min`.
 /// @return {Number} - Наибольшее из двух значений: `$value`
-/// 	или `$min`. Если `$value` больше или равно `$min`,
+/// 	или `$value-min`. Если `$value` больше или равно `$value-min`,
 /// 	возвращается `$value`. В противном случае возвращается
-/// 	`$min`.
-/// @throws Не выбрасывает ошибок, безопасно обрабатывает все
-/// 	числовые значения. Оба аргумента должны быть числами
-/// 	для корректной работы.
-@function number-clamp-min($value, $min) {
-	@return math.max($value, $min);
+/// 	`$value-min`.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
+@function number-clamp-min($value, $value-min) {
+
+	// Проверка типа первого параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'number-clamp-min',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение
+	// минимального предела. $value-min определяет нижнюю границу,
+	// ниже которой не может опускаться возвращаемое значение.
+	@else if not is-number($value-min) {
+
+		// Если $value-min не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $value прошел валидацию.
+		@return log-invalid-type(
+			'number-clamp-min',
+			$value-min,
+			'$value-min',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - выполняем ограничение снизу.
+	@else {
+
+		// Формула ограничения значения снизу:
+		// Используем встроенную функцию math.max() для выбора
+		// большего из двух значений.
+		//
+		// Логика работы:
+		// - Если $value больше или равен $value-min, возвращается $value
+		// - Если $value меньше $value-min, возвращается $value-min
+		//
+		// Математическая формула:
+		// result = max(value, min-value)
+		//
+		// Ключевая особенность: функция гарантирует, что возвращаемое
+		// значение никогда не будет меньше указанного минимального предела.
+		@return math.max($value, $value-min);
+
+	}
+
 }

package/modules/utilities/helpers/number/_number-clamp.scss

@@ -1,4 +1,6 @@
 @use 'sass:math';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
 
 /// Ограничивает число заданным диапазоном значений.
 ///
@@ -16,7 +18,7 @@
 /// - Если `min ≤ value ≤ max` → возвращает `value`
 ///
 /// Важные особенности функции:
-/// - Гарантирует, что результат будет в диапазоне `[$min, $max]`
+/// - Гарантирует, что результат будет в диапазоне `[$value-min, $value-max]`
 /// - Использует встроенные функции `math.max()` и `math.min()`
 /// - Работает с любыми числовыми значениями (целые, дробные,
 /// 	с единицами)
@@ -32,7 +34,7 @@
 /// > `number-clamp()` вычисляется один раз при компиляции и
 /// > возвращает фиксированное значение. Для обеспечения
 /// > корректной работы рекомендуется всегда передавать
-/// > `$min ≤ $max`. При `$min > $max` функция все равно
+/// > `$value-min ≤ $value-max`. При `$value-min > $value-max` функция все равно
 /// > работает, но результат может отличаться от ожидаемого.
 /// ---
 /// @name number-clamp
@@ -92,18 +94,92 @@
 /// @param {Number} $value - Число, которое нужно ограничить.
 /// 	Может быть любым числом: целым, дробным, положительным,
 /// 	отрицательным, с единицами измерения или без.
-/// @param {Number} $min - Минимальное допустимое значение.
-/// 	Если `$value` меньше `$min`, возвращается `$min`.
-/// @param {Number} $max - Максимальное допустимое значение.
-/// 	Если `$value` больше `$max`, возвращается `$max`.
+/// @param {Number} $value-min - Минимальное допустимое значение.
+/// 	Если `$value` меньше `$value-min`, возвращается `$value-min`.
+/// @param {Number} $value-max - Максимальное допустимое значение.
+/// 	Если `$value` больше `$value-max`, возвращается `$value-max`.
 /// @return {Number} - Значение `$value`, ограниченное
-/// 	диапазоном `[$min, $max]`. Если `$value` находится в
+/// 	диапазоном `[$value-min, $value-max]`. Если `$value` находится в
 /// 	пределах диапазона, возвращается исходное значение. В
 /// 	противном случае возвращается соответствующая граница
 /// 	диапазона.
-/// @throws {Error} - Не выбрасывает ошибок, даже при
-/// 	некорректных диапазонах (когда `$min > $max`). Однако
-/// 	в таких случаях поведение функции может быть неинтуитивным.
-@function number-clamp($value, $min, $max) {
-	@return math.min(math.max($value, $min), $max);
+/// @throws {Warning} - когда `$value-min > $value-max` поведение
+/// 	функции может быть неинтуитивным.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
+@function number-clamp($value, $value-min, $value-max) {
+
+	// Проверка типа первого параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'number-clamp',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение
+	// минимального предела. $value-min определяет нижнюю границу,
+	// ниже которой не может опускаться возвращаемое значение.
+	@else if not is-number($value-min) {
+
+		// Если $value-min не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $value прошел валидацию.
+		@return log-invalid-type(
+			'number-clamp',
+			$value-min,
+			'$value-min',
+			'number'
+		);
+
+	}
+
+	// Проверка типа третьего параметра: ожидается числовое значение
+	// максимального предела. $value-max определяет верхнюю границу,
+	// которую не может превышать возвращаемое значение.
+	@else if not is-number($value-max) {
+
+		// Если $value-max не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $value и $value-min
+		// прошли валидацию.
+		@return log-invalid-type(
+			'number-clamp',
+			$value-max,
+			'$value-max',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - выполняем ограничение диапазона.
+	@else {
+
+		// Формула ограничения значения в заданном диапазоне:
+		// Используем комбинацию встроенных функций math.max() и math.min().
+		//
+		// Логика работы:
+		// 1. math.max($value, $value-min) - гарантирует, что значение
+		//    не будет меньше минимального предела
+		// 2. math.min(..., $value-max) - гарантирует, что значение
+		//    не будет больше максимального предела
+		//
+		// Математическая формула:
+		// result = min(max(value, min-value), max-value)
+		//
+		// Ключевая особенность: функция гарантирует, что возвращаемое
+		// значение всегда будет находиться в диапазоне между $value-min
+		// и $value-max включительно.
+		@return math.min(math.max($value, $value-min), $value-max);
+
+	}
+
 }

package/modules/utilities/helpers/number/_number-denormalize.scss

@@ -1,9 +1,12 @@
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
+
 /// Денормализует число из единичного интервала [0, 1] в
 /// исходный диапазон.
 ///
 /// Функция выполняет обратное линейное преобразование числа
 /// из нормализованного диапазона `[0, 1]` обратно в исходный
-/// диапазон `[$min, $max]`. Это операция, обратная функции
+/// диапазон `[$value-min, $value-max]`. Это операция, обратная функции
 /// `number-normalize()`, и восстанавливает исходное значение
 /// после нормализации.
 ///
@@ -28,8 +31,8 @@
 ///
 /// > Эта функция является точной обратной операцией к
 /// > `number-normalize()`. Для любого значения `x` в диапазоне
-/// > `[$min, $max]` выполняется тождество:
-/// > `number-denormalize(number-normalize(x, $min, $max), $min, $max) == x`.
+/// > `[$value-min, $value-max]` выполняется тождество:
+/// > `number-denormalize(number-normalize(x, $value-min, $value-max), $value-min, $value-max) == x`.
 /// > Функция также поддерживает экстраполяцию для значений
 /// > вне диапазона [0, 1], что полезно для выхода за пределы
 /// > исходного диапазона или для работы с выбросами.
@@ -155,18 +158,93 @@
 /// 	диапазоне [0, 1]. Обычно полученное с помощью
 /// 	`number-normalize()`. Может быть любым числом, включая
 /// 	значения вне [0, 1] для экстраполяции.
-/// @param {Number} $min - Нижняя граница целевого диапазона.
+/// @param {Number} $value-min - Нижняя граница целевого диапазона.
 /// 	Значение, соответствующее `0` в нормализованном диапазоне.
-/// @param {Number} $max - Верхняя граница целевого диапазона.
+/// @param {Number} $value-max - Верхняя граница целевого диапазона.
 /// 	Значение, соответствующее `1` в нормализованном диапазоне.
 /// @return {Number} - Денормализованное значение в целевом
 /// 	диапазоне. Восстанавливает исходные единицы измерения
-/// 	из `$min` и `$max`. Для `$value` в [0, 1] результат
-/// 	будет в диапазоне `[$min, $max]`. Для значений вне [0, 1]
+/// 	из `$value-min` и `$value-max`. Для `$value` в [0, 1] результат
+/// 	будет в диапазоне `[$value-min, $value-max]`. Для значений вне [0, 1]
 /// 	выполняет линейную экстраполяцию.
 /// @throws Не выбрасывает ошибок, безопасно обрабатывает все
 /// 	числовые значения. Формула математически корректна для
 /// 	любых числовых аргументов.
-@function number-denormalize($value, $min, $max) {
-	@return $value * ($max - $min) + $min;
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
+@function number-denormalize($value, $value-min, $value-max) {
+
+	// Проверка типа первого параметра: ожидается нормализованное числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// $value должно быть числом в диапазоне от 0 до 1 (нормализованное значение).
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'number-denormalize',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение
+	// минимальной границы диапазона. $value-min определяет нижнее
+	// значение целевого диапазона, в который будет денормализовано число.
+	@else if not is-number($value-min) {
+
+		// Если $value-min не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $value прошел валидацию.
+		@return log-invalid-type(
+			'number-denormalize',
+			$value-min,
+			'$value-min',
+			'number'
+		);
+
+	}
+
+	// Проверка типа третьего параметра: ожидается числовое значение
+	// максимальной границы диапазона. $value-max определяет верхнее
+	// значение целевого диапазона, в который будет денормализовано число.
+	@else if not is-number($value-max) {
+
+		// Если $value-max не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $value и $value-min
+		// прошли валидацию.
+		@return log-invalid-type(
+			'number-denormalize',
+			$value-max,
+			'$value-max',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - выполняем денормализацию.
+	@else {
+
+		// Формула денормализации числа из диапазона [0, 1]
+		// в произвольный диапазон [$value-min, $value-max]:
+		//
+		// Алгоритм вычислений:
+		// 1. ($value-max - $value-min) - вычисляем ширину целевого диапазона
+		// 2. $value * ... - умножаем нормализованное значение на ширину диапазона
+		// 3. ... + $value-min - добавляем минимальное значение для смещения
+		//    результата в нужный диапазон
+		//
+		// Математическая формула:
+		// result = value × (value-max - value-min) + value-min
+		//
+		// Ключевая особенность: функция преобразует нормализованное значение
+		// (обычно в диапазоне от 0 до 1) в значение в произвольном диапазоне,
+		// сохраняя относительное положение в пределах диапазона.
+		@return $value * ($value-max - $value-min) + $value-min;
+
+	}
+
 }

package/modules/utilities/helpers/number/_number-fibonacci.scss

@@ -1,4 +1,6 @@
 @use 'sass:list';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
 
 /// Генерирует последовательность чисел Фибоначчи.
 ///
@@ -216,20 +218,71 @@
 /// - Второй элемент: всегда 1 (если `$n > 1`)
 /// - Каждый последующий элемент: сумма двух предыдущих
 /// - Все элементы: целые положительные числа
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function number-fibonacci($n) {
-	$-result: ();
-	$-a: 0;
-	$-b: 1;
 
-	@for $i from 1 through $n {
+	// Проверка типа входного параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $n числом.
+	// $n определяет количество чисел Фибоначчи, которые нужно сгенерировать.
+	@if not is-number($n) {
 
-		$-result: list.append($-result, $-b);
-		$-temp: $-a + $-b;
-		$-a: $-b;
-		$-b: $-temp;
+		// Если $n не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'number-fibonacci',
+			$n,
+			'$n',
+			'number'
+		);
 
 	}
 
-	@return $-result;
+	// Основная логика выполняется только если $n является
+	// корректным числом.
+	@else {
+
+		// Инициализация переменной для хранения результата.
+		// $-result будет содержать список чисел Фибоначчи.
+		$-result: ();
+
+		// Инициализация начальных значений последовательности Фибоначчи.
+		// $-a и $-b представляют два предыдущих числа в последовательности.
+		// Последовательность Фибоначчи начинается с: 0, 1, 1, 2, 3, 5, 8...
+		// Для генерации n чисел мы начинаем с $-a = 0, $-b = 1.
+		$-a: 0;
+		$-b: 1;
+
+		// Цикл генерации чисел Фибоначчи.
+		// Переменная $i принимает значения от 1 до $n включительно.
+		// На каждой итерации генерируется одно число Фибоначчи.
+		@for $i from 1 through $n {
+
+			// Добавление текущего числа Фибоначчи в список результата.
+			// На первой итерации $-b = 1 (первое число Фибоначчи).
+			// Функция list.append() добавляет число в конец списка.
+			$-result: list.append($-result, $-b);
+
+			// Вычисление следующего числа Фибоначчи.
+			// Алгоритм:
+			// 1. $-temp: временная переменная для хранения суммы двух предыдущих чисел
+			// 2. $-a: обновление для следующей итерации (становится предыдущим $-b)
+			// 3. $-b: обновление для следующей итерации (становится вычисленной суммой)
+			$-temp: $-a + $-b;
+			$-a: $-b;
+			$-b: $-temp;
+
+		}
+
+		// Возвращаем список сгенерированных чисел Фибоначчи.
+		// Список содержит $n чисел, начиная с 1 (первое число Фибоначчи).
+		// Классическая последовательность Фибоначчи начинается с 0, 1,
+		// но данная реализация начинает с 1 для более практического использования
+		// в дизайне (золотое сечение, пропорции и т.д.).
+		@return $-result;
+
+	}
 
 }