lumina-sass 2.5.0 → 2.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumina-sass",
-  "version": "2.5.0",
+  "version": "2.6.2",
   "description": "Lumina Sass design tokens, mixins and public sub-modules (flexbox, color, mix).",
   "main": "src/_index.sass",
   "sass": "src/_index.sass",

package/src/flexbox/_flexbox-row.sass

@@ -6,6 +6,9 @@
     align-items: center
     @include mix.flexbox-generator('flex-row')
 
+.flex-items-center
+    align-items: center
+    @include mix.flexbox-generator('flex')
 .flex-inline-flex-row
     @include mix.flexbox-generator('inline-flex-row')
 

package/src/mix/_typography.sass

@@ -1,6 +1,8 @@
 
 @use 'sass:map'
 @use 'sass:list'
+@use 'sass:meta'
+@use 'sass:string'
 @use '../map/fonts' as fonts
 
 @mixin text-wrap-safe($inline: 0)
@@ -14,8 +16,18 @@
 @mixin font-style($font, $family: null, $line-height: null, $variant: null)
   $detected-family: font-family-of($font)
 
-  @if $detected-family != null
+  @if is-known-font($font)
     $family: $detected-family
+  
+  @else if $family == null
+    $family: $detected-family
+    @if $font != null
+      @warn "Font '#{$font}' not found in configuration map. Defaulting to stack: '#{$font}', #{$family}."
+
+  @if meta.type-of($font) == 'list'
+    $last: list.nth($font, list.length($font))
+    @if $last == $family
+      $family: null
 
   @if $line-height != null
     line-height: $line-height
@@ -23,11 +35,13 @@
   @if $variant != null
     font-variant: $variant
 
-  font-family: $font, $family
+  @if $font != null
+    font-family: $font, $family
+  @else
+    font-family: $family
 
 @mixin font( $font:null, $size: 1rem, $family: null, $style: null, $weight: null, $line-height: null, $variant: null)
-  @if $font != null
-    @include font-style($font, $family, $line-height, $variant)
+  @include font-style($font, $family, $line-height, $variant)
 
   @if $size != null
     font-size: $size
@@ -41,17 +55,46 @@
   @if $variant != null
     font-variant: $variant
 
-@mixin sans-serif($font, $size: 1rem, $weight: null, $style: null)
+@function get-default-stack($category)
+  @if not map.has-key(fonts.$fonts, $category)
+    @return null
+  $map: map.get(fonts.$fonts, $category)
+  $keys: map.keys($map)
+  $generic: $category
+  @if $category == 'mono'
+    $generic: monospace
+  @return list.append($keys, $generic)
+
+@mixin sans-serif($font: null, $size: 1rem, $weight: null, $style: null)
+  @if $font == null
+    $font: get-default-stack('sans-serif')
   @include font($font, $size, sans-serif, $style, $weight)
 
-@mixin serif($font, $size: 1rem, $weight: null, $style: null)
+@mixin serif($font: null, $size: 1rem, $weight: null, $style: null)
+  @if $font == null
+    $font: get-default-stack('serif')
   @include font($font, $size, serif, $style, $weight)
 
-@mixin monospace($font, $size: 1rem, $weight: null, $style: null)
+@mixin monospace($font: null, $size: 1rem, $weight: null, $style: null)
+  @if $font == null
+    $font: get-default-stack('mono')
   @include font($font, $size, monospace, $style, $weight)
 
+@function is-known-font($font)
+  @if $font == null
+    @return false
+  @if map.has-key(fonts.$fonts, $font)
+    @return true
+  @each $category, $map in fonts.$fonts
+    @if map.has-key($map, $font)
+      @return true
+  @return false
+
 // Helper: return the generic family for a given font name using the fonts map.
 @function font-family-of($font)
+  @if $font == null
+    @return ('Nunito', Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif)
+
   @if map.has-key(fonts.$fonts, $font)
     @if $font == 'mono'
       @return monospace
@@ -60,7 +103,9 @@
   @each $category, $map in fonts.$fonts
     @if map.has-key($map, $font)
       @return map.get($map, $font)
-  @return null
+
+  // Default fallback stack when font is not found
+  @return ('Nunito', Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif)
 
 @mixin text-adjustments($alignment: null, $decoration: null)
   @if $alignment != null

package/src/test/mixins.spec.sass

@@ -142,6 +142,69 @@
     @include true.assert-equal(typo.font-family-of('mono'), monospace)
     @include true.assert-equal(typo.font-family-of('serif'), serif)
 
+  @include true.test('Provides fallbacks for unknown fonts in font-family-of')
+    @include true.assert-equal(typo.font-family-of('MyCustomFont'), ('Nunito', Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif))
+
+  @include true.test('Generates fallback for unknown font')
+    @include true.assert
+      @include true.output
+        @include typo.font('MyCustomFont')
+      
+      @include true.expect
+        font-family: "MyCustomFont", "Nunito", Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif
+
+  @include true.test('Generates fallback for unknown font')
+    @include true.assert
+      @include true.output
+        @include typo.font()
+      
+      @include true.expect
+        font-family: "Nunito", Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif
+
+  @include true.test('Does not overwrite explicit fallback override for unknown font')
+    @include true.assert
+      @include true.output
+        @include typo.font('MyCustomFont', $family: serif)
+      
+      @include true.expect
+        font-family: "MyCustomFont", serif
+
+  @include true.test('Generates default fallback stack when no font is provided')
+    @include true.assert
+      @include true.output
+        @include typo.font()
+      
+      @include true.expect
+        font-family: "Nunito", Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif
+        font-size: 1rem
+
+  @include true.test('Generates default system sans-serif stack when no font is provided')
+    @include true.assert
+      @include true.output
+        @include typo.sans-serif()
+      
+      @include true.expect
+        font-family: "Roboto", "Helvetica", "Arial", "Work Sans", "Nunito", "Open Sans", "Lato", "Montserrat", "Source Sans Pro", "Inter", "Tahoma", "Verdana", "Gill Sans", "Futura", "Ubuntu", "Noto Sans", "Noto Sans KR", "Noto Sans JP", "Noto Sans SC", "Noto Sans Arabic", "Noto Sans Hebrew", sans-serif
+        font-size: 1rem
+
+  @include true.test('Generates default system serif stack when no font is provided')
+    @include true.assert
+      @include true.output
+        @include typo.serif()
+      
+      @include true.expect
+        font-family: "Georgia", "Times New Roman", "Palatino", "Libre Baskerville", "Merriweather", "PT Serif", "Noto Serif", "Noto Serif KR", "Noto Serif JP", "Noto Serif SC", serif
+        font-size: 1rem
+
+  @include true.test('Generates default system monospace stack when no font is provided')
+    @include true.assert
+      @include true.output
+        @include typo.monospace()
+      
+      @include true.expect
+        font-family: "Courier New", "Consolas", "Ubuntu Mono", "Source Code Pro", "Fira Code", "Inconsolata", "Menlo", "Monaco", "Noto Mono", monospace
+        font-size: 1rem
+
 @include true.test-module('Styling (Native)')
   @include true.test('Applies typography font styling to figcaption')
     @include true.assert