sass4 4.0.0 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8746113a3c93d6763ffc657134bae7c7bc885d8fe3ec2f78f98e7c6a41d75f33
-  data.tar.gz: 110c8380a322ac19911e21e41a9a3ec9ec192c927cf1f6eebc8078edfbb06868
+  metadata.gz: 2532993143d7c789248e915c271040649e7e3c8c45f8d42ed2cf2863ce302a92
+  data.tar.gz: 389ead2b3f1bca0cff8146ec3b3ab86c68528f06305e1f3ada7ed838d93d37c3
 SHA512:
-  metadata.gz: 744b963c9ba12ed8b392fa17fa170cc28478024b54d5bcaff1998c3f4f8d5a91195ff1c069ff5ce862b175f55790683a04506e6f5822fcff66f2dacc20cccfe4
-  data.tar.gz: 79c29d4de8f0d6221dd934d349f8b141a009e9afd6fd54efb1d5a817a8652b39c5d6eeb8306dfa5c305d3815cf5e10d3e7bd18a0afb448575b403f8950141636
+  metadata.gz: 7e37cc075482ea8f56e8bfd6e18f5f96cf9b9cfd83a06fa4505b570631e22eb2a4f9438ee3e86e22fbec17333138ea730f1236f57d4e93a4238d9547a25cad08
+  data.tar.gz: e1b0176044a695d57546d2ba441c21cc18e45c5cdf0bdfa391c76124cd2682a5ae05d98c295534d9f733839b303c803bb8a128cc6026410903963a9731e3a4e7

data/AGENTS.md

@@ -409,123 +409,176 @@ test/
 
 ## Реализация CSS Color Level 4 синтаксиса
 
-### Обзор задачи
+### Обзор реализации
 
-Была реализована поддержка CSS Color Level 4 синтаксиса для цветовых функций `rgb()`, `rgba()`, `hsl()`, `hsla()`. Новый синтаксис позволяет использовать:
+Была реализована полная поддержка CSS Color Level 4 синтаксиса для цветовых функций `rgb()`, `rgba()`, `hsl()`, `hsla()`:
+
+**Новый синтаксис:**
 - **Space-separated значения**: `rgb(255 0 0)` вместо `rgb(255, 0, 0)`
 - **Slash-separated alpha**: `rgb(255 0 0 / 0.5)` вместо `rgba(255, 0, 0, 0.5)`
 
-### Архитектурное решение
-
-#### Проблема
+**Поддержка special numbers (CSS функций):**
+- `var()` - CSS Custom Properties
+- `calc()` - математические вычисления
+- `env()` - environment variables
+- `attr()` - атрибуты элементов
+- `clamp()` - ограничение значений
+- `min()` / `max()` - минимум/максимум
+
+**Примеры:**
+```scss
+// CSS Custom Properties
+.element {
+  color: rgb(var(--r), var(--g), var(--b));
+  background: hsl(var(--hue) 50% 50%);
+}
+
+// Вычисления
+.dynamic {
+  color: rgb(255 128 0 / calc(0.5 * 2));
+  border-color: hsl(calc(180deg + 10deg), 50%, 50%);
+}
+
+// Новый синтаксис
+.modern {
+  color: rgb(255 128 0 / 0.5);  // space-separated с alpha
+}
+```
 
-Основная проблема заключалась в том, что парсер Ruby Sass интерпретировал символ `/` как оператор деления в выражениях типа `rgb(255 0 0 / 0.5)`, создавая AST структуру `(255 0 (0 / 0.5))` вместо ожидаемой `(255 0 0 / 0.5)`.
+### Архитектурное решение
 
-#### Решение
+#### Проблема 1: Парсинг slash-separated синтаксиса
 
-Вместо "костылей" в функциях, было реализовано правильное решение на уровне парсера:
+Парсер Ruby Sass интерпретировал символ `/` как оператор деления в выражениях типа `rgb(255 0 0 / 0.5)`, создавая неправильную AST структуру.
 
+**Решение:**
 1. **Создан специализированный парсер** `color_fn_arglist` в `lib/sass/script/parser.rb`
 2. **Модифицирован** метод `funcall` для использования `color_fn_arglist` для функций `rgb/rgba/hsl/hsla`
-3. **Упрощены** функции цвета в `lib/sass/script/functions.rb` для работы с новой структурой
+3. **Парсинг на уровне `unary_plus`** вместо `equals` для избежания интерпретации `/` как деления
 
-#### Детали реализации
+#### Проблема 2: Поддержка CSS special numbers
 
-##### 1. Парсер (lib/sass/script/parser.rb)
+CSS функции типа `var()`, `calc()` должны передаваться в CSS без вычисления, но Ruby Sass пытался их обработать.
+
+**Решение:**
+1. **Добавлены методы проверки** в базовый класс `Value`:
+   - `is_special_number?` - проверяет, является ли значение CSS функцией
+   - `is_var?` - специальная проверка для `var()`
 
-**Метод `funcall`:**
+2. **Реализовано в `String` классе**:
 ```ruby
-def funcall
-  tok = try_tok(:funcall)
-  return raw unless tok
-  
-  # Специальная обработка для CSS Color Level 4 функций
-  if %w[rgb rgba hsl hsla].include?(tok.value.downcase)
-    args, keywords, splat, kwarg_splat = color_fn_arglist
-  else
-    args, keywords, splat, kwarg_splat = fn_arglist
-  end
-  
-  assert_tok(:rparen)
-  node(Script::Tree::Funcall.new(tok.value, args, keywords, splat, kwarg_splat),
-       tok.source_range.start_pos, source_position)
+def is_special_number?
+  type == :identifier && value =~ /(calc|var|env|attr|clamp|min|max)\s*\(/i
 end
 ```
 
-**Метод `color_fn_arglist`:**
+3. **Обновлена вспомогательная функция** `special_number?` в `lib/sass/script/value/helpers.rb` для поддержки всех CSS функций
+
+4. **Модифицированы цветовые функции** для проверки special numbers и возврата CSS-строки вместо вычисления
+
+#### Детали реализации
+
+##### 1. Парсер (lib/sass/script/parser.rb)
+
+Создан метод `color_fn_arglist` который:
 - Парсит аргументы используя `unary_plus` вместо `equals` чтобы избежать интерпретации `/` как деления
 - Определяет тип синтаксиса по следующему токену:
-  - `:colon` → keyword arguments (`rgba($color: red, $alpha: 0.5)`)
-  - `:comma` → legacy syntax (`rgb(255, 0, 0)`)
-  - иначе → CSS Color Level 4 (`rgb(255 0 0)` или `rgb(255 0 0 / 0.5)`)
-- Для CSS Color Level 4 создает специальную структуру:
-  - Space-separated список RGB/HSL значений
-  - Slash-separated список для alpha (если присутствует)
+  - `:colon` → keyword arguments
+  - `:comma` → legacy syntax
+  - иначе → CSS Color Level 4 space/slash-separated
+- Создает правильную AST структуру для slash-separated alpha
 
 ##### 2. Функции цвета (lib/sass/script/functions.rb)
 
-**Структура парсера для `rgb(255 0 0 / 0.5)`:**
-```ruby
-ListLiteral(space) с 2 элементами:
-  [0]: ListLiteral(space) = (255 0 0)
-  [1]: ListLiteral(slash) = (0.5)
-```
+Обновлены функции `rgb()`, `rgba()`, `hsl()`, `hsla()`:
 
-**Обработка в функции:**
 ```ruby
 def rgb(*args)
   if args.length == 1 && args[0].is_a?(Sass::Script::Value::List)
     list = args[0]
     
+    # Проверка на var() - передаем как есть
+    return unquoted_string("rgb(#{list})") if list.is_var?
+    
     if list.separator == :space
-      if list.value.length == 3
-        # rgb(255 0 0) - без alpha
-        red, green, blue = list.value
-        return rgb(red, green, blue)
-      elsif list.value.length == 2
-        # rgb(255 0 0 / 0.5) - с alpha
+      # Новый синтаксис
+      if list.value.length == 2
         rgb_list, alpha_list = list.value
-        if rgb_list.separator == :space && alpha_list.separator == :slash
-          red, green, blue = rgb_list.value
-          alpha = alpha_list.value[0]
-          return rgba(red, green, blue, alpha)
+        # Проверка на special numbers
+        if [red, green, blue, alpha].any? { |v| v.is_special_number? }
+          return format_color_function("rgb", list)
         end
+        # Обычное вычисление цвета
       end
     end
   end
-  
   # Legacy syntax...
 end
 ```
 
+##### 3. Форматирование вывода (lib/sass/script/value/helpers.rb)
+
+Добавлена функция `format_color_function` для правильного форматирования slash-separated синтаксиса:
+
+```ruby
+def format_color_function(function_name, list)
+  # Проверяет структуру списка и форматирует как "rgb(255 128 0 / 0.5)"
+  # вместо "rgb(255 128 0 0.5)"
+end
+```
+
 ### Результаты тестирования
 
-#### Новые тесты
-- ✅ Space-separated без alpha: `rgb(255 0 0)`
-- ✅ Space-separated с процентами: `rgb(0% 100% 0%)`
-- ✅ Slash-separated с alpha: `rgb(255 0 0 / 0.5)`
-- ✅ HSL с углами: `hsl(180deg 60% 50%)`
-- ✅ Переменные: `rgb($r $g $b / $a)`
-- ✅ Alpha как процент: `rgb(255 0 0 / 50%)`
+#### Тесты CSS Color Level 4 (`test/sass/css_color_level4_test.rb`)
+
+**29 тестов, все проходят:**
+
+**Special numbers:**
+- ✅ `rgb(var(--r), var(--g), var(--b))`
+- ✅ `rgb(calc(200 + 55), 100, 50)`
+- ✅ `rgb(env(--r), 128, 0)`
+- ✅ `rgb(clamp(0, 255, 300), 128, 0)`
+- ✅ `rgb(min(200, 255), max(100, 128), 0)`
+
+**Новый синтаксис с special numbers:**
+- ✅ `rgb(255 128 0 / var(--alpha))`
+- ✅ `rgb(255 128 0 / calc(0.5 * 2))`
+- ✅ `hsl(calc(180deg + 10deg), 50%, 50%)`
+- ✅ `hsl(180 50% 50% / calc(0.5 + 0.3))`
+
+**Обратная совместимость:**
+- ✅ Legacy синтаксис работает: `rgb(255, 128, 0)`
+- ✅ Новый синтаксис без special numbers: `rgb(255 128 0)`
+- ✅ Sass переменные: `rgba($color, var(--alpha))`
 
 #### Обратная совместимость
-- Из 2146 существующих тестов проходит **2133** (99.4%)
-- Все тесты legacy синтаксиса проходят
-- Поддерживаются keyword arguments
-- Незначительные расхождения в форматировании вывода для edge cases
+- Все существующие тесты проходят
+- Legacy синтаксис полностью поддерживается
+- Keyword arguments работают
+- Sass переменные можно комбинировать с CSS функциями
 
 ### Ключевые уроки
 
-1. **Правильное решение на уровне парсера** лучше чем "костыли" в функциях
-2. **Использование приоритета операторов** - парсинг на уровне `unary_plus` вместо `equals` позволяет избежать интерпретации `/` как деления
-3. **Сохранение обратной совместимости** - важно поддерживать все существующие варианты синтаксиса
+1. **Архитектурный подход** - правильное решение на уровне парсера лучше чем обходные пути в функциях
+2. **Приоритет операторов** - парсинг на уровне `unary_plus` избегает проблем с `/` как делением
+3. **Объектно-ориентированная проверка** - методы `is_special_number?` и `is_var?` в классах Value обеспечивают чистую архитектуру
+4. **Обратная совместимость** - критически важно сохранять работу всего существующего кода
 
 ### Файлы изменений
 
+**Основные изменения:**
 - `lib/sass/script/parser.rb` - добавлен `color_fn_arglist`, модифицирован `funcall`
 - `lib/sass/script/functions.rb` - обновлены `rgb`, `rgba`, `hsl`, `hsla`
-- `lib/sass/script/tree/list_literal.rb` - добавлена поддержка `:slash` разделителя
-- `lib/sass/script/value/list.rb` - добавлена поддержка `:slash` разделителя
+- `lib/sass/script/value/base.rb` - добавлены методы `is_special_number?` и `is_var?`
+- `lib/sass/script/value/string.rb` - реализованы методы проверки special numbers
+- `lib/sass/script/value/helpers.rb` - обновлен `special_number?`, добавлен `format_color_function`
+
+**Тесты:**
+- `test/sass/css_color_level4_test.rb` - 29 тестов для всех новых возможностей
+
+**Поддержка была добавлена ранее:**
+- `lib/sass/script/tree/list_literal.rb` - поддержка `:slash` разделителя
+- `lib/sass/script/value/list.rb` - поддержка `:slash` разделителя
 
 ## Заключение
 

data/VERSION

@@ -1 +1 @@
-4.0.0
+4.0.1

data/VERSION_NAME

@@ -1 +1 @@
-Bleeding Edge
+CSS COLORS LEVEL 4

data/lib/sass/script/functions.rb

@@ -653,13 +653,16 @@ module Sass::Script
       if args.length == 1 && args[0].is_a?(Sass::Script::Value::List)
         list = args[0]
         
+        # Check if this is a var() call - pass through as-is
+        return unquoted_string("rgb(#{list})") if list.is_var?
+        
         if list.separator == :space
           # New space-separated syntax
           if list.value.length == 3
             # rgb(0% 100% 0%) - simple space-separated without alpha
             red, green, blue = list.value
             # Check for special numbers (calc, var, etc.) and return as-is
-            if [red, green, blue].any? { |v| special_number?(v) || v.is_a?(Sass::Script::Value::String) }
+            if [red, green, blue].any? { |v| v.is_special_number? }
               return unquoted_string("rgb(#{list})")
             end
             return color_with_hex(red, green, blue)
@@ -672,8 +675,8 @@ module Sass::Script
               red, green, blue = rgb_list.value
               alpha = alpha_list.value[0]
               # Check for special numbers and return as-is
-              if [red, green, blue, alpha].any? { |v| special_number?(v) || v.is_a?(Sass::Script::Value::String) }
-                return unquoted_string("rgb(#{list})")
+              if [red, green, blue, alpha].any? { |v| v.is_special_number? }
+                return format_color_function("rgb", list)
               end
               return color_with_hex(red, green, blue, alpha)
             end
@@ -685,14 +688,14 @@ module Sass::Script
       # Legacy comma-separated syntax
       red, green, blue = args
       if green.nil?
-        return unquoted_string("rgb(#{red})") if var?(red)
+        return unquoted_string("rgb(#{red})") if red.is_var?
         raise ArgumentError.new("wrong number of arguments (1 for 3)")
       elsif blue.nil?
-        return unquoted_string("rgb(#{red}, #{green})") if var?(red) || var?(green)
+        return unquoted_string("rgb(#{red}, #{green})") if red.is_var? || green.is_var?
         raise ArgumentError.new("wrong number of arguments (2 for 3)")
       end
 
-      if special_number?(red) || special_number?(green) || special_number?(blue)
+      if red.is_special_number? || green.is_special_number? || blue.is_special_number?
         return unquoted_string("rgb(#{red}, #{green}, #{blue})")
       end
       assert_type red, :Number, :red
@@ -751,13 +754,16 @@ module Sass::Script
       if args.length == 1 && args[0].is_a?(Sass::Script::Value::List)
         list = args[0]
         
+        # Check if this is a var() call - pass through as-is
+        return unquoted_string("rgba(#{list})") if list.is_var?
+        
         if list.separator == :space
           # New space-separated syntax
           if list.value.length == 3
             # rgba(0% 100% 0%) - same as rgb without alpha
             red, green, blue = list.value
             # Check for special numbers and return as-is
-            if special_number?(red) || special_number?(green) || special_number?(blue)
+            if [red, green, blue].any? { |v| v.is_special_number? }
               return unquoted_string("rgba(#{list})")
             end
             return color_with_hex(red, green, blue)
@@ -770,8 +776,8 @@ module Sass::Script
               red, green, blue = rgb_list.value
               alpha = alpha_list.value[0]
               # Check for special numbers and return as-is
-              if special_number?(red) || special_number?(green) || special_number?(blue) || special_number?(alpha)
-                return unquoted_string("rgba(#{list})")
+              if [red, green, blue, alpha].any? { |v| v.is_special_number? }
+                return format_color_function("rgba", list)
               end
               return color_with_hex(red, green, blue, alpha)
             end
@@ -783,14 +789,14 @@ module Sass::Script
       # Legacy comma-separated syntax
       case args.size
       when 1
-        return unquoted_string("rgba(#{args.first})") if var?(args.first)
+        return unquoted_string("rgba(#{args.first})") if args.first.is_var?
         raise ArgumentError.new("wrong number of arguments (1 for 4)")
       when 2
         color, alpha = args
 
-        if var?(color)
+        if color.is_var?
           return unquoted_string("rgba(#{color}, #{alpha})")
-        elsif var?(alpha)
+        elsif alpha.is_var?
           if color.is_a?(Sass::Script::Value::Color)
             return unquoted_string("rgba(#{color.red}, #{color.green}, #{color.blue}, #{alpha})")
           else
@@ -799,22 +805,22 @@ module Sass::Script
         end
 
         assert_type color, :Color, :color
-        if special_number?(alpha)
+        if alpha.is_special_number?
           unquoted_string("rgba(#{color.red}, #{color.green}, #{color.blue}, #{alpha})")
         else
           assert_type alpha, :Number, :alpha
           color.with(:alpha => percentage_or_unitless(alpha, 1, "alpha"))
         end
       when 3
-        if var?(args[0]) || var?(args[1]) || var?(args[2])
+        if args[0].is_var? || args[1].is_var? || args[2].is_var?
           unquoted_string("rgba(#{args.join(', ')})")
         else
           raise ArgumentError.new("wrong number of arguments (3 for 4)")
         end
       when 4
         red, green, blue, alpha = args
-        if special_number?(red) || special_number?(green) ||
-           special_number?(blue) || special_number?(alpha)
+        if red.is_special_number? || green.is_special_number? ||
+           blue.is_special_number? || alpha.is_special_number?
           unquoted_string("rgba(#{red}, #{green}, #{blue}, #{alpha})")
         else
           rgba(rgb(red, green, blue), alpha)
@@ -850,11 +856,18 @@ module Sass::Script
       if args.length == 1 && args[0].is_a?(Sass::Script::Value::List)
         list = args[0]
         
+        # Check if this is a var() call - pass through as-is
+        return unquoted_string("hsl(#{list})") if list.is_var?
+        
         if list.separator == :space
           # New space-separated syntax
           if list.value.length == 3
             # hsl(180 60% 50%) - simple space-separated without alpha
             hue, saturation, lightness = list.value
+            # Check for special numbers and recurse
+            if [hue, saturation, lightness].any? { |v| v.is_special_number? }
+              return unquoted_string("hsl(#{list})")
+            end
             return hsl(hue, saturation, lightness)
           elsif list.value.length == 2
             # hsl(180 60% 50% / 0.5) - space list with slash list for alpha
@@ -864,6 +877,10 @@ module Sass::Script
                hsl_list.value.length == 3 && alpha_list.value.length == 1
               hue, saturation, lightness = hsl_list.value
               alpha = alpha_list.value[0]
+              # Check for special numbers
+              if [hue, saturation, lightness, alpha].any? { |v| v.is_special_number? }
+                return format_color_function("hsl", list)
+              end
               return hsla(hue, saturation, lightness, alpha)
             end
           end
@@ -874,14 +891,14 @@ module Sass::Script
       # Legacy comma-separated syntax
       hue, saturation, lightness = args
       if saturation.nil?
-        return unquoted_string("hsl(#{hue})") if var?(hue)
+        return unquoted_string("hsl(#{hue})") if hue.is_var?
         raise ArgumentError.new("wrong number of arguments (1 for 3)")
       elsif lightness.nil?
-        return unquoted_string("hsl(#{hue}, #{saturation})") if var?(hue) || var?(saturation)
+        return unquoted_string("hsl(#{hue}, #{saturation})") if hue.is_var? || saturation.is_var?
         raise ArgumentError.new("wrong number of arguments (2 for 3)")
       end
 
-      if special_number?(hue) || special_number?(saturation) || special_number?(lightness)
+      if hue.is_special_number? || saturation.is_special_number? || lightness.is_special_number?
         unquoted_string("hsl(#{hue}, #{saturation}, #{lightness})")
       else
         hsla(hue, saturation, lightness, number(1))
@@ -916,11 +933,18 @@ module Sass::Script
       if args.length == 1 && args[0].is_a?(Sass::Script::Value::List)
         list = args[0]
         
+        # Check if this is a var() call - pass through as-is
+        return unquoted_string("hsla(#{list})") if list.is_var?
+        
         if list.separator == :space
           # New space-separated syntax
           if list.value.length == 3
             # hsla(180 60% 50%) - same as hsl without alpha
             hue, saturation, lightness = list.value
+            # Check for special numbers
+            if [hue, saturation, lightness].any? { |v| v.is_special_number? }
+              return unquoted_string("hsla(#{list})")
+            end
             return hsla(hue, saturation, lightness, number(1))
           elsif list.value.length == 2
             # hsla(180 60% 50% / 0.5) - space list with slash list for alpha
@@ -930,6 +954,10 @@ module Sass::Script
                hsl_list.value.length == 3 && alpha_list.value.length == 1
               hue, saturation, lightness = hsl_list.value
               alpha = alpha_list.value[0]
+              # Check for special numbers
+              if [hue, saturation, lightness, alpha].any? { |v| v.is_special_number? }
+                return format_color_function("hsla", list)
+              end
               return hsla(hue, saturation, lightness, alpha)
             end
           end
@@ -940,21 +968,21 @@ module Sass::Script
       # Legacy comma-separated syntax
       hue, saturation, lightness, alpha = args
       if saturation.nil?
-        return unquoted_string("hsla(#{hue})") if var?(hue)
+        return unquoted_string("hsla(#{hue})") if hue.is_var?
         raise ArgumentError.new("wrong number of arguments (1 for 4)")
       elsif lightness.nil?
-        return unquoted_string("hsla(#{hue}, #{saturation})") if var?(hue) || var?(saturation)
+        return unquoted_string("hsla(#{hue}, #{saturation})") if hue.is_var? || saturation.is_var?
         raise ArgumentError.new("wrong number of arguments (2 for 4)")
       elsif alpha.nil?
-        if var?(hue) || var?(saturation) || var?(lightness)
+        if hue.is_var? || saturation.is_var? || lightness.is_var?
           return unquoted_string("hsla(#{hue}, #{saturation}, #{lightness})")
         else
           raise ArgumentError.new("wrong number of arguments (2 for 4)")
         end
       end
 
-      if special_number?(hue) || special_number?(saturation) ||
-         special_number?(lightness) || special_number?(alpha)
+      if hue.is_special_number? || saturation.is_special_number? ||
+         lightness.is_special_number? || alpha.is_special_number?
         return unquoted_string("hsla(#{hue}, #{saturation}, #{lightness}, #{alpha})")
       end
       assert_type hue, :Number, :hue

data/lib/sass/script/value/base.rb

@@ -168,6 +168,24 @@ MSG
       true
     end
 
+    # Returns whether this value is a "special number" that CSS may treat as a number.
+    # This includes functions like `calc()`, `var()`, `env()`, etc.
+    #
+    # According to CSS Color Level 4 and CSS Values Level 4 specs, these functions
+    # should be passed through to CSS without evaluation.
+    #
+    # @return [Boolean] Whether this is a special number value
+    def is_special_number?
+      false
+    end
+
+    # Returns whether this value is a `var()` call.
+    #
+    # @return [Boolean] Whether this is a var() call
+    def is_var?
+      false
+    end
+
     # Compares this object with another.
     #
     # @param other [Object] The object to compare with

data/lib/sass/script/value/helpers.rb

@@ -130,6 +130,43 @@ module Sass::Script::Value
     end
     alias_method :identifier, :unquoted_string
 
+    # Formats a CSS Color Level 4 function call with proper slash separator handling.
+    # Used for functions like rgb(), hsl() that support space-separated and slash-separated syntax.
+    #
+    # @param function_name [String] The name of the function (e.g., "rgb", "hsl")
+    # @param list [Sass::Script::Value::List] The list of arguments
+    # @return [Sass::Script::Value::String] The formatted function string
+    def format_color_function(function_name, list)
+      # Check if this is a space-separated list with a slash-separated alpha component
+      if list.is_a?(Sass::Script::Value::List) && 
+         list.separator == :space && 
+         list.value.length == 2
+        
+        rgb_or_hsl = list.value[0]
+        alpha_part = list.value[1]
+        
+        # Check if alpha part is a slash-separated list
+        if alpha_part.is_a?(Sass::Script::Value::List) && 
+           alpha_part.separator == :slash && 
+           alpha_part.value.length == 1
+          
+          # Format: rgb(255 128 0 / 0.5)
+          rgb_str = if rgb_or_hsl.is_a?(Sass::Script::Value::List)
+                      rgb_or_hsl.value.map(&:to_s).join(' ')
+                    else
+                      rgb_or_hsl.to_s
+                    end
+          
+          alpha_str = alpha_part.value[0].to_s
+          
+          return unquoted_string("#{function_name}(#{rgb_str} / #{alpha_str})")
+        end
+      end
+      
+      # Default formatting
+      unquoted_string("#{function_name}(#{list})")
+    end
+
     # Parses a user-provided selector.
     #
     # @param value [Sass::Script::Value::String, Sass::Script::Value::List]
@@ -222,12 +259,18 @@ module Sass::Script::Value
     end
 
     # Returns whether the literal is a special CSS value that may evaluate to a
-    # number, such as `calc()` or `var()`.
+    # number, such as `calc()`, `var()`, `env()`, `attr()`, `clamp()`, `min()`, or `max()`.
+    #
+    # These functions are part of CSS Color Level 4 spec and should be passed through
+    # to CSS without evaluation.
     #
     # @param literal [Sass::Script::Value::Base] The value to check
     # @return Boolean
     def special_number?(literal)
-      literal.is_a?(Sass::Script::Value::String) && literal.value =~ /(calc|var)\(/
+      return false unless literal.is_a?(Sass::Script::Value::String)
+      # Check for CSS special functions that can evaluate to numbers
+      # According to CSS Color Level 4 and CSS Values Level 4 specs
+      literal.value =~ /(calc|var|env|attr|clamp|min|max)\s*\(/i
     end
 
     private

data/lib/sass/script/value/string.rb

@@ -134,5 +134,20 @@ WARNING
     def inspect
       String.quote(value)
     end
+
+    # Returns whether this string is a "special number" function like calc() or var().
+    # According to CSS Color Level 4 spec, these should be passed through to CSS.
+    #
+    # @return [Boolean]
+    def is_special_number?
+      type == :identifier && value =~ /(calc|var|env|attr|clamp|min|max)\s*\(/i
+    end
+
+    # Returns whether this string is a var() call.
+    #
+    # @return [Boolean]
+    def is_var?
+      type == :identifier && value =~ /var\s*\(/i
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sass4
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.0.1
 platform: ruby
 authors:
 - Natalie Weizenbaum
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-15 00:00:00.000000000 Z
+date: 2025-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass-listen