sass-apca 1.1.0 → 1.2.0

package/README.md

@@ -50,6 +50,24 @@ body {
 }
 ```
 
+### Warning levels configuration
+
+Control the verbosity of the warnings when loading the module, default is `90`.
+
+To *only warn for critical issues* (e.g., lower than 45):
+```scss
+@use "sass-apca/apca" with (
+  $warning-threshold: 45
+);
+```
+
+To *disable all warnings*:
+```scss
+@use "sass-apca/apca" with (
+  $warning-threshold: 0
+);
+```
+
 ## About contrast levels
 These general levels are appropriate for use by themselves, without the need to reference a lookup table. APCA reports contrast as an L<sup>c</sup> value (lightness contrast) from L<sup>c</sup> 0 to L<sup>c</sup> 105+. For accessibility, consider L<sup>c</sup> 15 the point of invisibility for many users, and L<sup>c</sup> 90 is preferred for body text. [^2]
 
@@ -61,7 +79,6 @@ These general levels are appropriate for use by themselves, without the need to
 - **L<sup>c</sup> 15** • The absolute minimum for any non-text that needs to be discernible and differentiable, and is no less than 6px in its smallest dimension. This may include disabled large buttons. Designers should treat anything below this level as invisible, as it will not be visible for many users. This minimum level should be avoided for any items important to the use, understanding, or interaction of the site.
 
 ## Roadmap
-- Polarity function for figuring out if light or dark text has a higher contrast on any given background
 - Compliance check for getting the current level of compliance of a given contrast ratio
 
 
@@ -71,4 +88,4 @@ These general levels are appropriate for use by themselves, without the need to
 Code published in this repository licensed under the [MIT license](https://github.com/gfellerph/sass-apca/blob/main/LICENSE).
 
 [^1]: APCA contrast calculator (https://www.myndex.com/APCA/)
-[^2]: Why APCA (https://git.apcacontrast.com/documentation/WhyAPCA#use-case-ranges)
+[^2]: Why APCA (https://git.apcacontrast.com/documentation/WhyAPCA#use-case-ranges)

package/apca.scss

@@ -10,6 +10,24 @@
 //
 // -------------------
 
+/**
+ * Configuration: Warning Threshold
+ *
+ * Defines the APCA contrast level below which the library will output warnings.
+ * The default is 90, which is the preferred level for fluent body text.
+ *
+ * To disable all warnings, set this value to 0.
+ * To only receive warnings for critical contrast issues, set this to a lower value (e.g., 30 or 45).
+ *
+ * @example
+ * ```
+ *   @use "sass-apca" with (
+ *     $warning-threshold: 0
+ *   );
+ * ```
+ */
+$warning-threshold: 90 !default;
+
 // Powercurve exponents
 $_Strc: 2.4;
 $_Ntx: 0.57;
@@ -30,9 +48,9 @@ $_greenMultiplier: 0.7151522;
 $_blueMultiplier: 0.072175;
 
 @function _luminance($color) {
-  $red: color.red($color);
-  $green: color.green($color);
-  $blue: color.blue($color);
+  $red: color.channel($color, "red", $space: rgb);
+  $green: color.channel($color, "green", $space: rgb);
+  $blue: color.channel($color, "blue", $space: rgb);
 
   $redLuminance: math.pow(math.div($red, 255), $_Strc) * $_redMultiplier;
   $greenLuminance: math.pow(math.div($green, 255), $_Strc) * $_greenMultiplier;
@@ -69,7 +87,7 @@ $_blueMultiplier: 0.072175;
  * @param   {color}  $textColor        Text color
  * @param   {color}  $backgroundColor  Background color
  *
- * @return  {number}                    A number between -108 and 107 representing the lightness contrast 
+ * @return  {number}                    A number between -108 and 107 representing the lightness contrast
  */
 @function contrast($textColor, $backgroundColor) {
   @if (meta.type-of($textColor) != 'color') {
@@ -113,7 +131,7 @@ $_blueMultiplier: 0.072175;
   @if (meta.type-of($backgroundColor) != 'color') {
     @error "Type Error: apca.recommend-text-color expects a color as third argument but received #{meta.type-of($darkColor)}. Please provide a valid color.";
   }
-  
+
   $lightContrast: math.abs(contrast($lightColor, $backgroundColor));
   $darkContrast: math.abs(contrast($darkColor, $backgroundColor));
   $contrastColor: null;
@@ -127,18 +145,20 @@ $_blueMultiplier: 0.072175;
     $bestContrast: $lightContrast
   }
 
-  @if ($bestContrast < 15) {
-    @warn "Your best contrast is #{$bestContrast}. This is lower than 15, the absolute minimum for any non-text that needs to be discernible and differentiable, and is no less than 6px in its smallest dimension. This may include disabled large buttons. Designers should treat anything below this level as invisible, as it will not be visible for many users. This minimum level should be avoided for any items important to the use, understanding, or interaction of the site.";
-  } @else if ($bestContrast < 30) {
-    @warn "Your best contrast is #{$bestContrast}. This is lower than 30, the absolute minimum for any text not listed above. This includes placeholder text and disabled element text. This is also the minimum for large/solid semantic & understandable non-text elements.";
-  } @else if ($bestContrast < 45) {
-    @warn "Your best contrast is #{$bestContrast}. This is lower than 45, the minimum for larger, heavier text (36px normal weight or 24px bold) such as headlines. This is also the minimum for pictograms with fine details.";
-  } @else if ($bestContrast < 60) {
-    @warn "Your best contrast is #{$bestContrast}. This is lower than 60, the minimum level recommended for content text that is not body, column, or block text. In other words, text you want people to read. The minimums: 24px normal weight (400) or 16px/700 (bold). These values based on the reference font Helvetica.";
-  } @else if ($bestContrast < 75) {
-    @warn "Your best contrast is #{$bestContrast}. This is lower than 75, the minimum level for columns of body text with a font no smaller than 18px/400. Lc 75 should be considered a minimum for text where readability is important.";
-  } @else if ($bestContrast < 90) {
-    @warn "Your best contrast is #{$bestContrast}. This is lower than 90, the preferred level for fluent text and columns of body text with a font no smaller than 14px/weight 400 (normal).";
+  @if ($bestContrast < $warning-threshold) {
+    @if ($bestContrast < 15) {
+      @warn "Your best contrast is #{$bestContrast}. This is lower than 15, the absolute minimum for any non-text that needs to be discernible and differentiable, and is no less than 6px in its smallest dimension. This may include disabled large buttons. Designers should treat anything below this level as invisible, as it will not be visible for many users. This minimum level should be avoided for any items important to the use, understanding, or interaction of the site.";
+    } @else if ($bestContrast < 30) {
+      @warn "Your best contrast is #{$bestContrast}. This is lower than 30, the absolute minimum for any text not listed above. This includes placeholder text and disabled element text. This is also the minimum for large/solid semantic & understandable non-text elements.";
+    } @else if ($bestContrast < 45) {
+      @warn "Your best contrast is #{$bestContrast}. This is lower than 45, the minimum for larger, heavier text (36px normal weight or 24px bold) such as headlines. This is also the minimum for pictograms with fine details.";
+    } @else if ($bestContrast < 60) {
+      @warn "Your best contrast is #{$bestContrast}. This is lower than 60, the minimum level recommended for content text that is not body, column, or block text. In other words, text you want people to read. The minimums: 24px normal weight (400) or 16px/700 (bold). These values based on the reference font Helvetica.";
+    } @else if ($bestContrast < 75) {
+      @warn "Your best contrast is #{$bestContrast}. This is lower than 75, the minimum level for columns of body text with a font no smaller than 18px/400. Lc 75 should be considered a minimum for text where readability is important.";
+    } @else if ($bestContrast < 90) {
+      @warn "Your best contrast is #{$bestContrast}. This is lower than 90, the preferred level for fluent text and columns of body text with a font no smaller than 14px/weight 400 (normal).";
+    }
   }
 
   @return $contrastColor;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sass-apca",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Sass implementation of the [Accessible Perceptual Contrast Algorithm (APCA)](https://git.apcacontrast.com/) for the WCAG 3.0 specification.",
   "keywords": [
     "sass",
@@ -29,7 +29,7 @@
   "devDependencies": {
     "@semantic-release/changelog": "6.0.3",
     "@semantic-release/git": "10.0.1",
-    "sass": "1.60.0",
-    "semantic-release": "21.0.0"
+    "sass": "1.98.0",
+    "semantic-release": "25.0.1"
   }
 }