@progress/kendo-theme-core 6.1.1-dev.3 → 6.1.1-dev.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/all.scss CHANGED
@@ -1,82 +1,187 @@
1
1
  // This file is auto-generated. Do not edit!
2
- // baka:source packages/core/scss/all.scss
2
+ // baka:source scss/all.scss
3
3
 
4
- // #region @import "./index.import.scss"; -> packages/core/scss/index.import.scss
5
- // #region @import "./functions/index.import.scss"; -> packages/core/scss/functions/index.import.scss
6
- // #region @import "../_variables.scss"; -> packages/core/scss/_variables.scss
4
+ // #region @import "./index.import.scss"; -> scss/index.import.scss
5
+ // #region @import "./functions/index.import.scss"; -> scss/functions/index.import.scss
6
+ // #region @import "../_variables.scss"; -> scss/_variables.scss
7
7
  // Equilateral triangle variables
8
8
  $equilateral-index: 1.7320508076 !default;
9
9
  $equilateral-height: .8660254038 !default;
10
10
 
11
11
  // #endregion
12
12
 
13
- // #region @import "./_color.import.scss"; -> packages/core/scss/functions/_color.import.scss
13
+ // #region @import "./_color.import.scss"; -> scss/functions/_color.import.scss
14
+ /// Returns the alpha channel of a color.
15
+ /// @param {Color} $color - The color to get the alpha channel for.
16
+ /// @return {Number} - The alpha channel of the color.
17
+ ///
18
+ /// @example scss - Usage
19
+ /// @debug k-color-alpha( rgba( 0, 0, 0, 0.5 ) ); // => 0.5
20
+ /// @debug k-color-alpha( #000 ); // => 1
14
21
  @function k-color-alpha( $color ) {
15
22
  @return alpha( $color );
16
23
  }
17
24
 
25
+ /// Returns the red channel of a color.
26
+ /// @param {Color} $color - The color to get the red channel for.
27
+ /// @return {Number} - The red channel of the color.
28
+ ///
29
+ /// @example scss - Usage
30
+ /// @debug k-color-red( #ff0000 ); // => 255
18
31
  @function k-color-red( $color ) {
19
32
  @return red( $color );
20
33
  }
21
34
 
35
+ /// Returns the green channel of a color.
36
+ /// @param {Color} $color - The color to get the green channel for.
37
+ /// @return {Number} - The green channel of the color.
38
+ ///
39
+ /// @example scss - Usage
40
+ /// @debug k-color-green( #00ff00 ); // => 255
22
41
  @function k-color-green( $color ) {
23
42
  @return green( $color );
24
43
  }
25
44
 
45
+ /// Returns the blue channel of a color.
46
+ /// @param {Color} $color - The color to get the blue channel for.
47
+ /// @return {Number} - The blue channel of the color.
48
+ ///
49
+ /// @example scss - Usage
50
+ /// @debug k-color-blue( #0000ff ); // => 255
26
51
  @function k-color-blue( $color ) {
27
52
  @return blue( $color );
28
53
  }
29
54
 
55
+ /// Returns the hue of a color.
56
+ /// @param {Color} $color - The color to get the hue for.
57
+ /// @return {Number} - The hue of the color.
58
+ ///
59
+ /// @example scss - Usage
60
+ /// @debug k-color-hue( #e1d7d2 ); // => 20deg
30
61
  @function k-color-hue( $color ) {
31
62
  @return hue( $color );
32
63
  }
33
64
 
65
+ /// Returns the saturation of a color.
66
+ /// @param {Color} $color - The color to get the saturation for.
67
+ /// @return {Number} - The saturation of the color.
68
+ ///
69
+ /// @example scss - Usage
70
+ /// @debug k-color-saturation( #e1d7d2 ); // => 20%
34
71
  @function k-color-saturation( $color ) {
35
72
  @return saturation( $color );
36
73
  }
37
74
 
75
+ /// Returns the lightness of a color.
76
+ /// @param {Color} $color - The color to get the lightness for.
77
+ /// @return {Number} - The lightness of the color.
78
+ ///
79
+ /// @example scss - Usage
80
+ /// @debug k-color-lightness( #e1d7d2 ); // => 80%
38
81
  @function k-color-lightness( $color ) {
39
82
  @return lightness( $color );
40
83
  }
41
84
 
85
+ /// Returns a color that is a mix of two colors.
86
+ /// @param {Color} $color1 - The first color.
87
+ /// @param {Color} $color2 - The second color.
88
+ /// @param {Number} $weight - The weight of the first color in the mix.
89
+ /// @return {Color} - The mixed color.
90
+ ///
91
+ /// @example scss - Usage
92
+ /// @debug k-color-mix( #f00, #00f ); // => #800080
42
93
  @function k-color-mix( $color1, $color2, $weight: 50% ) {
43
94
  @return mix( $color1, $color2, $weight );
44
95
  }
45
96
 
97
+ /// Makes a color darker by decreasing its lightness.
98
+ /// @param {Color} $color - The color to darken.
99
+ /// @param {Number} $amount - The amount to darken the color.
100
+ /// @return {Color} - The darkened color.
101
+ ///
102
+ /// @example scss - Usage
103
+ /// @debug k-color-darken( #f00, 10% ); // => #e60000
46
104
  @function k-color-darken( $color, $amount) {
47
105
  @return darken( $color, $amount );
48
106
  }
49
107
 
108
+ /// Makes a color lighter by increasing its lightness.
109
+ /// @param {Color} $color - The color to lighten.
110
+ /// @param {Number} $amount - The amount to lighten the color.
111
+ /// @return {Color} - The lightened color.
112
+ ///
113
+ /// @example scss - Usage
114
+ /// @debug k-color-lighten( #f00, 10% ); // => #ff1a1a
50
115
  @function k-color-lighten( $color, $amount) {
51
116
  @return lighten( $color, $amount );
52
117
  }
53
118
 
119
+ /// Increases or decreases the hue of a color.
120
+ /// @param {Color} $color - The color to adjust the hue for.
121
+ /// @param {Number} $degrees - The amount to adjust the hue.
122
+ /// @return {Color} - The adjusted color.
123
+ ///
124
+ /// @example scss - Usage
125
+ /// @debug k-color-adjust-hue( #f00, 10deg ); // => #ff1a00
54
126
  @function k-color-adjust-hue( $color, $degrees ) {
55
127
  @return adjust-hue( $color, $degrees );
56
128
  }
57
129
 
130
+ /// Increases the saturation of a color.
131
+ /// @param {Color} $color - The color to saturate.
132
+ /// @param {Number} $amount - The amount to saturate the color.
133
+ /// @return {Color} - The saturated color.
134
+ ///
135
+ /// @example scss - Usage
136
+ /// @debug k-color-saturate( #f00, 10% ); // => #ff3333
58
137
  @function k-color-saturate( $color, $amount ) {
59
138
  @return saturate( $color, $amount );
60
139
  }
61
140
 
141
+ /// Decreases the saturation of a color.
142
+ /// @param {Color} $color - The color to desaturate.
143
+ /// @param {Number} $amount - The amount to desaturate the color.
144
+ /// @return {Color} - The desaturated color.
145
+ ///
146
+ /// @example scss - Usage
147
+ /// @debug k-color-desaturate( #f00, 10% ); // => #e60000
62
148
  @function k-color-desaturate( $color, $amount ) {
63
149
  @return desaturate( $color, $amount );
64
150
  }
65
151
 
152
+ /// Returns a gray color with the same lightness as the input color.
153
+ /// @param {Color} $color - The color to convert to grayscale.
154
+ /// @return {Color} - The grayscale color.
155
+ ///
156
+ /// @example scss - Usage
157
+ /// @debug k-color-grayscale( #f00 ); // => #808080
66
158
  @function k-color-grayscale( $color ) {
67
159
  @return grayscale( $color );
68
160
  }
69
161
 
162
+ /// Returns the RGB complement of a color. This identical to adjusting the hue
163
+ /// by 180 degrees.
164
+ /// @param {Color} $color - The color to get the complement for.
165
+ /// @return {Color} - The complement color.
166
+ ///
167
+ /// @example scss - Usage
168
+ /// @debug k-color-complement( #f00 ); // => #00ffff
70
169
  @function k-color-complement( $color ) {
71
170
  @return complement( $color );
72
171
  }
73
172
 
173
+ /// Returns the inverse of a color.
174
+ /// @param {Color} $color - The color to invert.
175
+ /// @return {Color} - The inverted color.
176
+ ///
177
+ /// @example scss - Usage
178
+ /// @debug k-color-invert( #f00 ); // => #00ffff
74
179
  @function k-color-invert( $color ) {
75
180
  @return invert( $color );
76
181
  }
77
182
 
78
183
  // #endregion
79
- // #region @import "./_color-contrast.import.scss"; -> packages/core/scss/functions/_color-contrast.import.scss
184
+ // #region @import "./_color-contrast.import.scss"; -> scss/functions/_color-contrast.import.scss
80
185
  // Adapted from https://gist.github.com/sgomes/ccc72f71137fe29039c92c0a9fe9b657
81
186
  // Adapted from https://github.com/twbs/bootstrap/commit/03908ea37a55eaa44c12ce5694dddc1630c980b3
82
187
 
@@ -350,17 +455,31 @@ $_linear-channel-values: (
350
455
  1
351
456
  );
352
457
 
353
- // The contrast ratio to reach against white, to determine if color changes from "light" to "dark".
354
- // Acceptable values for WCAG 2.0 are 3, 4.5 and 7.
355
- // See https://www.w3.org/TR/WCAG20/#visual-audio-contrast-contrast
356
- // See https://www.w3.org/TR/WCAG20-TECHS/G17.html#G17-tests
458
+ /// The contrast ratio to reach against white, to determine if color changes from "light" to "dark".
459
+ /// Acceptable values for WCAG 2.0 are 3, 4.5 and 7.
460
+ /// @type Number
461
+ /// @group accessibility
462
+ ///
463
+ /// @link https://www.w3.org/TR/WCAG20/#visual-audio-contrast-contrast
464
+ /// @link https://www.w3.org/TR/WCAG20-TECHS/G17.html#G17-tests
357
465
  $wcag-min-contrast-ratio: 7 !default;
466
+ /// Default dark color for WCAG 2.0.
467
+ /// @type Color
468
+ /// @group accessibility
358
469
  $wcag-dark: black !default;
470
+ /// Default light color for WCAG 2.0.
471
+ /// @type Color
472
+ /// @group accessibility
359
473
  $wcag-light: white !default;
360
474
 
361
- // Calculate the luminance for a color.
362
- // See https://www.w3.org/TR/WCAG/#dfn-relative-luminance
363
- // See https://www.w3.org/TR/WCAG20-TECHS/G17.html#G17-tests
475
+ /// Calculate the relative luminance for a color.
476
+ /// @param {Color} $color - The color to calculate the relative luminance for.
477
+ /// @return {Number} - The relative luminance for the color.
478
+ ///
479
+ /// @group accessibility
480
+ ///
481
+ /// @link https://www.w3.org/TR/WCAG/#dfn-relative-luminance
482
+ /// @link https://www.w3.org/TR/WCAG20-TECHS/G17.html#G17-tests
364
483
  @function k-color-luminance( $color ) {
365
484
  $red: k-list-nth( $_linear-channel-values, k-color-red( $color ) + 1 );
366
485
  $green: k-list-nth( $_linear-channel-values, k-color-green( $color ) + 1 );
@@ -369,9 +488,15 @@ $wcag-light: white !default;
369
488
  @return .2126 * $red + .7152 * $green + .0722 * $blue;
370
489
  }
371
490
 
372
- // Calculate the luminance for a color.
373
- // See https://www.w3.org/TR/WCAG/#dfn-contrast-ratio
374
- // See https://www.w3.org/TR/WCAG20-TECHS/G17.html#G17-tests
491
+ /// Calculates contrast ratio between two colors
492
+ /// @param {Color} $background - The background color
493
+ /// @param {Color} $foreground - The foreground color
494
+ /// @return {Number} - The contrast ratio between the two colors
495
+ ///
496
+ /// @group accessibility
497
+ ///
498
+ /// @link https://www.w3.org/TR/WCAG/#dfn-contrast-ratio
499
+ /// @link https://www.w3.org/TR/WCAG20-TECHS/G17.html#G17-tests
375
500
  @function k-color-contrast-ratio( $background, $foreground ) {
376
501
  // sass-lint:disable-block variable-name-format
377
502
  $backLum: k-color-luminance( $background ) + .05;
@@ -380,15 +505,34 @@ $wcag-light: white !default;
380
505
  @return k-math-div( k-math-max( $backLum, $foreLum ), k-math-min( $backLum, $foreLum ) );
381
506
  }
382
507
 
508
+ /// Checks if a color is dark
509
+ /// @param {Color} $color - The color to check
510
+ /// @return {Boolean} - True if the color is dark, false otherwise
511
+ ///
512
+ /// @group accessibility
383
513
  @function k-is-dark( $color ) {
384
514
  @return if( k-color-luminance( $color ) < .5, true, false );
385
515
  }
516
+
517
+ /// Checks if a color is light
518
+ /// @param {Color} $color - The color to check
519
+ /// @return {Boolean} - True if the color is light, false otherwise
520
+ ///
521
+ /// @group accessibility
386
522
  @function k-is-light( $color ) {
387
523
  @return if( k-color-luminance( $color ) < .5, false, true );
388
524
  }
389
525
 
390
526
 
391
- // Contrast functions
527
+ /// Calculates the contrast ratio between a background color and a foreground color.
528
+ /// If the contrast ratio is not high enough, it will return the color with the highest contrast ratio.
529
+ /// @param {Color} $background - The background color
530
+ /// @param {Color} $dark - The dark color to use as a fallback
531
+ /// @param {Color} $light - The light color to use as a fallback
532
+ /// @param {Number} $min-ratio - The minimum contrast ratio to reach
533
+ /// @return {Color} - The color with the highest contrast ratio
534
+ ///
535
+ /// @group accessibility
392
536
  @function k-contrast-color( $background, $dark: $wcag-dark, $light: $wcag-light, $min-ratio: $wcag-min-contrast-ratio ) {
393
537
  $foregrounds: $light, $dark, #ffffff, #000000;
394
538
  $max-ratio: 0;
@@ -436,13 +580,18 @@ $wcag-light: white !default;
436
580
  }
437
581
 
438
582
  // #endregion
439
- // #region @import "./_color-manipulation.import.scss"; -> packages/core/scss/functions/_color-manipulation.import.scss
583
+ // #region @import "./_color-manipulation.import.scss"; -> scss/functions/_color-manipulation.import.scss
584
+ $kendo-light-color-level-step: 8% !default;
585
+ $kendo-dark-color-level-step: 16% !default;
586
+
440
587
  /// Set a specific jump point for requesting color jumps
441
588
  /// @group color-system
442
589
  /// @access private
443
590
  $kendo-color-level-step: 8% !default;
444
591
 
445
592
  @function k-color-level( $color, $level: 0 ) {
593
+ $_dark-theme: if( k-meta-variable-exists( kendo-is-dark-theme ), $kendo-is-dark-theme, false );
594
+ $_color-level-step: if( $_dark-theme, $kendo-dark-color-level-step, $kendo-light-color-level-step );
446
595
 
447
596
  @if ( $level == 0 ) or ( $level == 0% ) {
448
597
  @return $color;
@@ -456,16 +605,41 @@ $kendo-color-level-step: 8% !default;
456
605
  @return k-color-mix( $base, $color, $level );
457
606
  }
458
607
 
459
- @return k-color-mix( $base, $color, $level * $kendo-color-level-step );
608
+ @return k-color-mix( $base, $color, k-math-clamp( $level * $_color-level-step, 0%, 100% ) );
460
609
  }
461
610
 
611
+ /// Makes a color lighter by mixing it with white
612
+ /// @param {Color} $color - The color to lighten
613
+ /// @param {Number} $level - The amount to lighten the color
614
+ /// @return {Color} - The lightened color
615
+ ///
616
+ /// @group color-system
617
+ ///
618
+ /// @example scss - Usage
619
+ /// @debug k-color-tint( #f00, 1 ); // => #ff1a1a
462
620
  @function k-color-tint( $color, $level: 1 ) {
463
621
  @return k-color-level( $color, -$level );
464
622
  }
623
+
624
+ /// Makes a color darker by mixing it with black
625
+ /// @param {Color} $color - The color to darken
626
+ /// @param {Number} $level - The amount to darken the color
627
+ /// @return {Color} - The darkened color
628
+ ///
629
+ /// @group color-system
630
+ ///
631
+ /// @example scss - Usage
632
+ /// @debug k-color-shade( #f00, 1 ); // => #e60000
465
633
  @function k-color-shade( $color, $level: 1 ) {
466
634
  @return k-color-level( $color, $level );
467
635
  }
468
636
 
637
+ /// Shades the color in light themes and tints it in dark themes
638
+ /// @param {Color} $color - The color to shade or tint
639
+ /// @param {Number} $level - The amount to shade or tint the color
640
+ /// @return {Color} - The shaded or tinted color
641
+ ///
642
+ /// @group color-system
469
643
  @function k-try-shade( $color, $level: 1 ) {
470
644
  $_dark-theme: if( k-meta-variable-exists( kendo-is-dark-theme ), $kendo-is-dark-theme, false );
471
645
 
@@ -475,6 +649,13 @@ $kendo-color-level-step: 8% !default;
475
649
 
476
650
  @return k-color-shade( $color, $level );
477
651
  }
652
+
653
+ /// Tints the color in light themes and shades it in dark themes
654
+ /// @param {Color} $color - The color to tint or shade
655
+ /// @param {Number} $level - The amount to tint or shade the color
656
+ /// @return {Color} - The tinted or shaded color
657
+ ///
658
+ /// @group color-system
478
659
  @function k-try-tint( $color, $level: 1 ) {
479
660
  $_dark-theme: if( k-meta-variable-exists( kendo-is-dark-theme ), $kendo-is-dark-theme, false );
480
661
 
@@ -485,7 +666,12 @@ $kendo-color-level-step: 8% !default;
485
666
  @return k-color-tint( $color, $level );
486
667
  }
487
668
 
488
-
669
+ /// Darkens the color in light themes and lightens it in dark themes
670
+ /// @param {Color} $color - The color to darken or lighten
671
+ /// @param {Number} $level - The amount to darken or lighten the color
672
+ /// @return {Color} - The darkened or lightened color
673
+ ///
674
+ /// @group color-system
489
675
  @function k-try-darken( $color, $amount ) {
490
676
  $_dark-theme: if( k-meta-variable-exists( kendo-is-dark-theme ), $kendo-is-dark-theme, false );
491
677
 
@@ -495,6 +681,12 @@ $kendo-color-level-step: 8% !default;
495
681
  @return k-color-darken( $color, $amount );
496
682
  }
497
683
 
684
+ /// Lightens the color in light themes and darkens it in dark themes
685
+ /// @param {Color} $color - The color to lighten or darken
686
+ /// @param {Number} $level - The amount to lighten or darken the color
687
+ /// @return {Color} - The lightened or darkened color
688
+ ///
689
+ /// @group color-system
498
690
  @function k-try-lighten( $color, $amount ) {
499
691
  $_dark-theme: if( k-meta-variable-exists( kendo-is-dark-theme ), $kendo-is-dark-theme, false );
500
692
 
@@ -504,6 +696,15 @@ $kendo-color-level-step: 8% !default;
504
696
  @return k-color-lighten( $color, $amount );
505
697
  }
506
698
 
699
+ /// Converts a color with alpha to solid color mixed with a background color
700
+ /// @param {Color} $color - The color to convert
701
+ /// @param {Color} $bg - The background color
702
+ /// @return {Color} - The converted color
703
+ ///
704
+ /// @group color-system
705
+ ///
706
+ /// @example scss - Usage
707
+ /// @debug k-rgba-to-mix( rgba( #f00, 0.5 ), #fff ); // => #ff8080
507
708
  @function k-rgba-to-mix( $color, $bg ) {
508
709
  $percent: k-color-alpha( $color ) * 100%;
509
710
 
@@ -516,7 +717,7 @@ $kendo-color-level-step: 8% !default;
516
717
  }
517
718
 
518
719
  // #endregion
519
- // #region @import "./_custom-properties.import.scss"; -> packages/core/scss/functions/_custom-properties.import.scss
720
+ // #region @import "./_custom-properties.import.scss"; -> scss/functions/_custom-properties.import.scss
520
721
  @function k-var( $prefix: kendo-, $var: null, $fallback: null ) {
521
722
  $_prefix: $prefix;
522
723
  $_var: $var;
@@ -556,7 +757,7 @@ $kendo-color-level-step: 8% !default;
556
757
  }
557
758
 
558
759
  // #endregion
559
- // #region @import "./_escape-string.import.scss"; -> packages/core/scss/functions/_escape-string.import.scss
760
+ // #region @import "./_escape-string.import.scss"; -> scss/functions/_escape-string.import.scss
560
761
  $_kendo-svg-escaped-characters: (
561
762
  ("%", "%25"),
562
763
  ("<", "%3c"),
@@ -566,7 +767,11 @@ $_kendo-svg-escaped-characters: (
566
767
  (")", "%29")
567
768
  ) !default;
568
769
 
569
- // See https://codepen.io/kevinweber/pen/dXWoRw
770
+ /// Escapes SVG characters in a string
771
+ /// @param {String} $string - The string to escape
772
+ /// @return {String} - The escaped string
773
+ ///
774
+ /// @link https://codepen.io/kevinweber/pen/dXWoRw
570
775
  @function k-escape-svg($string) {
571
776
  @if k-string-index($string, "data:image/svg+xml") {
572
777
  @each $char, $encoded in $_kendo-svg-escaped-characters {
@@ -589,6 +794,9 @@ $_kendo-escape-class-name: (
589
794
  "/": "\\/"
590
795
  );
591
796
 
797
+ /// Escapes special characters in a class name
798
+ /// @param {String} $text - The string to escape
799
+ /// @return {String} - The escaped string
592
800
  @function k-escape-class-name( $text ) {
593
801
  $_text: $text;
594
802
 
@@ -600,41 +808,111 @@ $_kendo-escape-class-name: (
600
808
  }
601
809
 
602
810
  // #endregion
603
- // #region @import "./_lang.import.scss"; -> packages/core/scss/functions/_lang.import.scss
811
+ // #region @import "./_lang.import.scss"; -> scss/functions/_lang.import.scss
812
+ /// Returns the value of a variable if it is not null,
813
+ /// otherwise returns the fallback value.
814
+ /// @param {Any} $var - The variable to check.
815
+ /// @param {Any} $fallback - The fallback value.
816
+ /// @return {Any} - The value of the variable or the fallback value.
817
+ ///
818
+ /// @example scss - Usage
819
+ /// $foo: null;
820
+ /// @debug k-if-var( $foo, "bar" ); // => "bar"
821
+ /// $foo: "baz";
822
+ /// @debug k-if-var( $foo, "bar" ); // => "baz"
604
823
  @function k-if-var( $var, $fallback ) {
605
824
  @return if( $var != null, $var, $fallback );
606
825
  }
607
826
 
608
827
  // #endregion
609
- // #region @import "./_list.import.scss"; -> packages/core/scss/functions/_list.import.scss
828
+ // #region @import "./_list.import.scss"; -> scss/functions/_list.import.scss
829
+ /// Returns a copy of `$list` with `$val` appended to the end.
830
+ /// @param {List} $list - The list to process.
831
+ /// @param {Any} $val - The value to append to `$list`.
832
+ /// @param {String} $separator - The separator to use between `$list` and `$val`.
833
+ /// @return {List} - A copy of `$list` with `$val` appended to the end.
834
+ ///
835
+ /// @example scss - Usage
836
+ /// @debug k-list-append( ( "foo", "bar" ), "baz" ); // => "foo, bar, baz"
610
837
  @function k-list-append( $list, $val, $separator: auto ) {
611
838
  @return append( $list, $val, $separator );
612
839
  }
613
840
 
841
+ /// Checks whether `$list` contains `$value`.
842
+ /// @param {List} $list - The list to check.
843
+ /// @param {Any} $value - The value to check for.
844
+ /// @return {Boolean} - Whether `$list` contains `$value`.
845
+ ///
846
+ /// @example scss - Usage
847
+ /// @debug k-list-includes( ( "foo", "bar" ), "foo" ); // => true
848
+ /// @debug k-list-includes( ( "foo", "bar" ), "baz" ); // => false
614
849
  @function k-list-includes( $list, $value ) {
615
850
  @return k-list-index( $list, $value ) != null;
616
851
  }
617
852
 
853
+ /// Returns the index of `$value` in `$list`.
854
+ /// @param {List} $list - The list to check.
855
+ /// @param {Any} $value - The value to check for.
856
+ /// @return {Number} - The index of `$value` in `$list`.
857
+ ///
858
+ /// @example scss - Usage
859
+ /// @debug k-list-index( ( "foo", "bar" ), "foo" ); // => 1
618
860
  @function k-list-index( $list, $value ) {
619
861
  @return index( $list, $value );
620
862
  }
621
863
 
864
+ /// Returns whether `$list` is bracketed.
865
+ /// @param {List} $list - The list to check.
866
+ /// @return {Boolean} - Whether `$list` is bracketed.
867
+ ///
868
+ /// @example scss - Usage
869
+ /// @debug k-list-is-bracketed( ( "foo", "bar" ) ); // => false
870
+ /// @debug k-list-is-bracketed( [ "foo", "bar" ] ); // => true
622
871
  @function k-list-is-bracketed( $list ) {
623
872
  @return is-bracketed( $list );
624
873
  }
625
874
 
875
+ /// Joins two lists together.
876
+ /// @param {List} $list1 - The first list to join.
877
+ /// @param {List} $list2 - The second list to join.
878
+ /// @param {String} $separator - The separator to use between `$list1` and `$list2`.
879
+ /// @param {Boolean} $bracketed - Whether the result should be bracketed.
880
+ /// @return {List} - The joined list.
881
+ ///
882
+ /// @example scss - Usage
883
+ /// @debug k-list-join( ( "foo", "bar" ), ( "baz", "qux" ) ); // => "foo, bar, baz, qux"
884
+ /// @debug k-list-join( ( "foo", "bar" ), ( "baz", "qux" ), " " ); // => "foo bar baz qux"
626
885
  @function k-list-join( $list1, $list2, $separator: auto, $bracketed: auto ) {
627
886
  @return join( $list1, $list2, $separator, $bracketed );
628
887
  }
629
888
 
889
+ /// Returns the length of `$list`.
890
+ /// @param {List} $list - The list to check.
891
+ /// @return {Number} - The length of `$list`.
892
+ ///
893
+ /// @example scss - Usage
894
+ /// @debug k-list-length( ( "foo", "bar" ) ); // => 2
630
895
  @function k-list-length( $list ) {
631
896
  @return length( $list );
632
897
  }
633
898
 
899
+ /// Returns the nth item in `$list`.
900
+ /// @param {List} $list - The list to check.
901
+ /// @param {Number} $n - The index of the item to return.
902
+ /// @return {Any} - The nth item in `$list`.
903
+ ///
904
+ /// @example scss - Usage
905
+ /// @debug k-list-nth( ( "foo", "bar" ), 1 ); // => "foo"
634
906
  @function k-list-nth( $list, $n ) {
635
907
  @return nth( $list, $n );
636
908
  }
637
909
 
910
+ /// Reverse the order of items in `$list`.
911
+ /// @param {List} $list - The list to reverse.
912
+ /// @return {List} - The reversed list.
913
+ ///
914
+ /// @example scss - Usage
915
+ /// @debug k-list-reverse( ( "foo", "bar" ) ); // => "bar, foo"
638
916
  @function k-list-reverse( $list: null ) {
639
917
  $result: ();
640
918
 
@@ -653,64 +931,185 @@ $_kendo-escape-class-name: (
653
931
  @return $result;
654
932
  }
655
933
 
934
+ /// Returns the separator of `$list`.
935
+ /// @param {List} $list - The list to check.
936
+ /// @return {String} - The separator of `$list`.
937
+ ///
938
+ /// @example scss - Usage
939
+ /// @debug k-list-separator( ( "foo", "bar" ) ); // => ","
656
940
  @function k-list-separator( $list ) {
657
941
  @return list-separator( $list );
658
942
  }
659
943
 
944
+ /// Returns a copy of `$list` with `$val` inserted at `$n`.
945
+ /// @param {List} $list - The list to process.
946
+ /// @param {Number} $n - The index at which to insert `$val`.
947
+ /// @param {Any} $val - The value to insert.
948
+ /// @return {List} - A copy of `$list` with `$val` inserted at `$n`.
949
+ ///
950
+ /// @example scss - Usage
951
+ /// @debug k-list-set-nth( ( "foo", "bar" ), 1, "baz" ); // => "baz, bar"
660
952
  @function k-list-set-nth( $list, $n, $value ) {
661
953
  @return set-nth( $list, $n, $value );
662
954
  }
663
955
 
956
+ /// Combines two lists into a single list of two-item lists.
957
+ /// @param {List} $list1 - The first list to combine.
958
+ /// @param {List} $list2 - The second list to combine.
959
+ /// @return {List} - A list of two-item lists.
960
+ ///
961
+ /// @example scss - Usage
962
+ /// @debug k-list-zip( ( "foo", "bar" ), ( "baz", "qux" ) ); // => ((foo, baz), (bar, qux))
664
963
  @function k-list-zip( $lists... ) {
665
964
  @return zip( $lists... );
666
965
  }
667
966
 
668
967
  // #endregion
669
- // #region @import "./_math.import.scss"; -> packages/core/scss/functions/_math.import.scss
968
+ // #region @import "./_math.import.scss"; -> scss/functions/_math.import.scss
969
+ /// Returns the absolute value of a number.
970
+ /// @param {Number} $number - The number to get the absolute value of.
971
+ /// @return {Number} - The absolute value of `$number`.
972
+ ///
973
+ /// @example scss - Usage
974
+ /// @debug k-math-abs( -10 ); // => 10
670
975
  @function k-math-abs( $number ) {
671
976
  @return abs( $number );
672
977
  }
673
978
 
979
+ /// Returns the smallest integer greater than or equal to a number.
980
+ /// @param {Number} $number - The number to get the ceiling of.
981
+ /// @return {Number} - The ceiling of `$number`.
982
+ ///
983
+ /// @example scss - Usage
984
+ /// @debug k-math-ceil( 10.1 ); // => 11
674
985
  @function k-math-ceil( $number ) {
675
986
  @return ceil( $number );
676
987
  }
677
988
 
678
- @function k-math-clamp( $value, $min, $max ) {
679
- @return k-math-max( $min, k-math-min( $max, $value ) );
680
- }
681
-
989
+ /// Returns the largest integer less than or equal to a number.
990
+ /// @param {Number} $number - The number to get the floor of.
991
+ /// @return {Number} - The floor of `$number`.
992
+ ///
993
+ /// @example scss - Usage
994
+ /// @debug k-math-floor( 10.9 ); // => 10
995
+ @function k-math-floor( $number ) {
996
+ @return floor( $number );
997
+ }
998
+
999
+ /// Restricts `$number` to the range between `$min` and `$max`. If `$number` is
1000
+ /// less than `$min`, `$min` is returned. If `$number` is greater than `$max`,
1001
+ /// `$max` is returned. Otherwise, `$number` is returned.
1002
+ /// @param {Number} $number - The number to clamp.
1003
+ /// @param {Number} $min - The minimum value.
1004
+ /// @param {Number} $max - The maximum value.
1005
+ /// @return {Number} - The clamped number.
1006
+ ///
1007
+ /// @example scss - Usage
1008
+ /// @debug k-math-clamp( 10, 0, 5 ); // => 5
1009
+ @function k-math-clamp( $number, $min, $max ) {
1010
+ @return k-math-max( $min, k-math-min( $max, $number ) );
1011
+ }
1012
+
1013
+ /// Returns whether two numbers have compatible units.
1014
+ /// @param {Number} $a - The first number.
1015
+ /// @param {Number} $b - The second number.
1016
+ /// @return {Boolean} - Whether the numbers have compatible units.
1017
+ ///
1018
+ /// @example scss - Usage
1019
+ /// @debug k-math-compatible( 10px, 10px ); // => true
1020
+ /// @debug k-math-compatible( 10px, 10em ); // => false
682
1021
  @function k-math-compatible( $a, $b ) {
683
1022
  @return comparable( $a, $b );
684
1023
  }
685
1024
 
1025
+ /// Returns the quotient of two numbers.
1026
+ /// @param {Number} $a - The dividend.
1027
+ /// @param {Number} $b - The divisor.
1028
+ /// @return {Number} - The quotient of `$a` and `$b`.
1029
+ ///
1030
+ /// @example scss - Usage
1031
+ /// @debug k-math-div( 10, 2 ); // => 5
1032
+ /// @debug k-math-div( 10px, 2 ); // => 5px
686
1033
  @function k-math-div( $a, $b ) {
687
1034
  @return ( $a / $b );
688
1035
  }
689
1036
 
1037
+ /// Returns whether `$number` has no units.
1038
+ /// @param {Number} $number - The number to check.
1039
+ /// @return {Boolean} - Whether `$number` has no units.
1040
+ ///
1041
+ /// @example scss - Usage
1042
+ /// @debug k-math-is-unitless( 10 ); // => true
1043
+ /// @debug k-math-is-unitless( 10px ); // => false
690
1044
  @function k-math-is-unitless( $number ) {
691
1045
  @return unitless( $number );
692
1046
  }
693
1047
 
1048
+ /// Returns the larger of two numbers.
1049
+ /// @param {Number} $a - The first number.
1050
+ /// @param {Number} $b - The second number.
1051
+ /// @return {Number} - The larger of `$a` and `$b`.
1052
+ ///
1053
+ /// @example scss - Usage
1054
+ /// @debug k-math-max( 10, 20 ); // => 20
1055
+ /// @debug k-math-max( 10px, 20px ); // => 20px
694
1056
  @function k-math-max( $a, $b ) {
695
1057
  @return max( $a, $b );
696
1058
  }
697
1059
 
1060
+ /// Returns the smaller of two numbers.
1061
+ /// @param {Number} $a - The first number.
1062
+ /// @param {Number} $b - The second number.
1063
+ /// @return {Number} - The smaller of `$a` and `$b`.
1064
+ ///
1065
+ /// @example scss - Usage
1066
+ /// @debug k-math-min( 10, 20 ); // => 10
1067
+ /// @debug k-math-min( 10px, 20px ); // => 10px
698
1068
  @function k-math-min( $a, $b ) {
699
1069
  @return min( $a, $b );
700
1070
  }
701
1071
 
1072
+ /// Returns the remainder of two numbers.
1073
+ /// @param {Number} $a - The dividend.
1074
+ /// @param {Number} $b - The divisor.
1075
+ /// @return {Number} - The remainder of `$a` and `$b`.
1076
+ ///
1077
+ /// @example scss - Usage
1078
+ /// @debug k-math-mod( 10, 3 ); // => 1
1079
+ /// @debug k-math-mod( 10px, 3 ); // => 1px
702
1080
  @function k-math-mod( $a, $b ) {
703
1081
  @return ( $a % $b );
704
1082
  }
705
1083
 
1084
+ /// Returns the product of two numbers.
1085
+ /// @param {Number} $a - The first number.
1086
+ /// @param {Number} $b - The second number.
1087
+ /// @return {Number} - The product of `$a` and `$b`.
1088
+ ///
1089
+ /// @example scss - Usage
1090
+ /// @debug k-math-mul( 10, 2 ); // => 20
1091
+ /// @debug k-math-mul( 10px, 2 ); // => 20px
706
1092
  @function k-math-mul( $a, $b ) {
707
1093
  @return ( $a * $b );
708
1094
  }
709
1095
 
1096
+ /// Converts a unitless number to a percentage.
1097
+ /// @param {Number} $number - The number to convert.
1098
+ /// @return {Number} - The percentage.
1099
+ ///
1100
+ /// @example scss - Usage
1101
+ /// @debug k-math-percentage( 0.5 ); // => 50%
710
1102
  @function k-math-percentage( $number ) {
711
- @return ( $number * 100% );
1103
+ @return percentage( $number );
712
1104
  }
713
1105
 
1106
+ /// Returns the result of raising `$x` to the power of `$n`.
1107
+ /// @param {Number} $x - The base.
1108
+ /// @param {Number} $n - The exponent.
1109
+ /// @return {Number} - The result of raising `$x` to the power of `$n`.
1110
+ ///
1111
+ /// @example scss - Usage
1112
+ /// @debug k-math-pow( 2, 3 ); // => 8
714
1113
  @function k-math-pow( $x, $n ) {
715
1114
  $ret: 1;
716
1115
 
@@ -732,10 +1131,12 @@ $_kendo-escape-class-name: (
732
1131
 
733
1132
  }
734
1133
 
735
- @function k-math-percentage( $number ) {
736
- @return percentage( $number );
737
- }
738
-
1134
+ /// Returns a random number between 0 and 1.
1135
+ /// @param {Number} $limit - The upper limit of the random number.
1136
+ /// @return {Number} - A random number between 0 and 1.
1137
+ ///
1138
+ /// @example scss - Usage
1139
+ /// @debug k-math-random(); // => 0.123456789
739
1140
  @function k-math-random( $limit: null ) {
740
1141
  @if ( $limit == null ) {
741
1142
  @return random();
@@ -744,6 +1145,14 @@ $_kendo-escape-class-name: (
744
1145
  @return random( $limit );
745
1146
  }
746
1147
 
1148
+ /// Returns the result of rounding `$number` to the nearest integer
1149
+ /// using the specified `$precision`.
1150
+ /// @param {Number} $number - The number to round.
1151
+ /// @param {Number} $precision - The number of decimal places to round to.
1152
+ /// @return {Number} - The rounded number.
1153
+ ///
1154
+ /// @example scss - Usage
1155
+ /// @debug k-math-round( 10.123456789, 3 ); // => 10.123
747
1156
  @function k-math-round( $number, $precision: 0 ) {
748
1157
 
749
1158
  @if ( $precision == 0 ) {
@@ -755,10 +1164,22 @@ $_kendo-escape-class-name: (
755
1164
  @return k-math-div( round( $number * $pow ), $pow );
756
1165
  }
757
1166
 
1167
+ /// Returns a string representation of `$number`'s unit.
1168
+ /// @param {Number} $number - The number to get the unit of.
1169
+ /// @return {String} - The unit of `$number`.
1170
+ ///
1171
+ /// @example scss - Usage
1172
+ /// @debug k-math-unit( 10px ); // => px
758
1173
  @function k-math-unit( $number ) {
759
1174
  @return unit( $number );
760
1175
  }
761
1176
 
1177
+ /// Remove the unit from a number.
1178
+ /// @param {Number} $number - The number to remove the unit from.
1179
+ /// @return {Number} - The unitless number.
1180
+ ///
1181
+ /// @example scss - Usage
1182
+ /// @debug k-math-strip-unit( 10px ); // => 10
762
1183
  @function k-math-strip-unit($number) {
763
1184
  @if ( k-meta-type-of( $number ) == "number" ) and not k-math-is-unitless( $number ) {
764
1185
  @return k-math-div( $number, 1 * k-math-unit( $number) );
@@ -768,7 +1189,13 @@ $_kendo-escape-class-name: (
768
1189
  }
769
1190
 
770
1191
  // #endregion
771
- // #region @import "./_map.import.scss"; -> packages/core/scss/functions/_map.import.scss
1192
+ // #region @import "./_map.import.scss"; -> scss/functions/_map.import.scss
1193
+ /// Returns the value at `$key` in `$map`.
1194
+ /// @param {Map} $map - The map to get the value from.
1195
+ /// @param {Any} $key - The key to get the value for.
1196
+ ///
1197
+ /// @example scss - Usage
1198
+ /// @debug k-map-get( ( "foo": "bar" ), "foo" ); // => "bar"
772
1199
  @function k-map-get( $map, $keys... ) {
773
1200
  @each $key in $keys {
774
1201
  $map: map-get( $map, $key );
@@ -776,14 +1203,35 @@ $_kendo-escape-class-name: (
776
1203
  @return $map;
777
1204
  }
778
1205
 
1206
+ /// Returns whether `$map` has a value at `$key`.
1207
+ /// @param {Map} $map - The map to check.
1208
+ /// @param {Any} $key - The key to check.
1209
+ /// @return {Boolean} - Whether `$map` has a value at `$key`.
1210
+ ///
1211
+ /// @example scss - Usage
1212
+ /// @debug k-map-has( ( "foo": "bar" ), "foo" ); // => true
1213
+ /// @debug k-map-has( ( "foo": "bar" ), "bar" ); // => false
779
1214
  @function k-map-has-key( $map, $key ) {
780
1215
  @return map-has-key( $map, $key );
781
1216
  }
782
1217
 
1218
+ /// Returns a comma separated list of the keys in `$map`.
1219
+ /// @param {Map} $map - The map to get the keys from.
1220
+ /// @return {List} - A comma separated list of the keys in `$map`.
1221
+ ///
1222
+ /// @example scss - Usage
1223
+ /// @debug k-map-keys( ( "foo": "bar", "baz": "qux" ) ); // => "foo, baz"
783
1224
  @function k-map-keys( $map ) {
784
1225
  @return map-keys( $map );
785
1226
  }
786
1227
 
1228
+ /// Returns a map with the keys and values from `$map` and `$args`.
1229
+ /// @param {Map} $map - The map to merge.
1230
+ /// @param {Map} $args - The map to merge into `$map`.
1231
+ /// @return {Map} - A map with the keys and values from `$map` and `$args`.
1232
+ ///
1233
+ /// @example scss - Usage
1234
+ /// @debug k-map-merge( ( "foo": "bar" ), ( "baz": "qux" ) ); // => ( "foo": "bar", "baz": "qux" )
787
1235
  @function k-map-merge( $map, $args... ) {
788
1236
  @each $arg in $args {
789
1237
  $map: map-merge( $map, $arg );
@@ -791,117 +1239,337 @@ $_kendo-escape-class-name: (
791
1239
  @return $map;
792
1240
  }
793
1241
 
1242
+ /// Returns a map with the keys and values from `$map` except for `$keys`.
1243
+ /// @param {Map} $map - The map to remove keys from.
1244
+ /// @param {Any} $keys - The keys to remove from `$map`.
1245
+ /// @return {Map} - A map with the keys and values from `$map` except for `$keys`.
1246
+ ///
1247
+ /// @example scss - Usage
1248
+ /// @debug k-map-remove( ( "foo": "bar", "baz": "qux" ), "foo" ); // => ( "baz": "qux" )
794
1249
  @function k-map-remove( $map, $keys... ) {
795
1250
  @return map-remove( $map, $keys... );
796
1251
  }
797
1252
 
1253
+ /// Sets a single key and value in `$map`.
1254
+ /// @param {Map} $map - The map to set the value in.
1255
+ /// @param {Any} $key - The key to set the value for.
1256
+ /// @param {Any} $value - The value to set.
1257
+ /// @return {Map} - A map with the key and value set.
1258
+ ///
1259
+ /// @example scss - Usage
1260
+ /// @debug k-map-set( ( "foo": "bar" ), "baz", "qux" ); // => ( "foo": "bar", "baz": "qux" )
798
1261
  @function k-map-set( $map, $key, $value ) {
799
1262
  @return k-map-merge( $map, ( $key: $value ) );
800
1263
  }
801
1264
 
1265
+ /// Returns a comma separated list of the values in `$map`.
1266
+ /// @param {Map} $map - The map to get the values from.
1267
+ /// @return {List} - A comma separated list of the values in `$map`.
1268
+ ///
1269
+ /// @example scss - Usage
1270
+ /// @debug k-map-values( ( "foo": "bar", "baz": "qux" ) ); // => "bar, qux"
802
1271
  @function k-map-values( $map ) {
803
1272
  @return map-values( $map );
804
1273
  }
805
1274
 
806
1275
  // #endregion
807
- // #region @import "./_meta.import.scss"; -> packages/core/scss/functions/_meta.import.scss
1276
+ // #region @import "./_meta.import.scss"; -> scss/functions/_meta.import.scss
808
1277
  // Adapted from https://css-tricks.com/snippets/sass/advanced-type-checking/
809
1278
 
1279
+ /// A wrapper around the `call()` function.
1280
+ /// Calls the function `$function` with the arguments `$args`.
1281
+ /// @param {Function} $function - The function to call.
1282
+ /// @param {List} $args - The arguments to pass to `$function`.
1283
+ /// @return {Any} - The result of calling `$function` with `$args`.
1284
+ ///
1285
+ /// @example scss - Usage
1286
+ /// @debug k-meta-call( k-meta-get-function( "k-string-replace" ), "foo bar", "bar", "baz" ); // => "foo baz"
810
1287
  @function k-meta-call( $function, $args... ) {
811
1288
  @return call( $function, $args... );
812
1289
  }
813
1290
 
1291
+ /// A wrapper around the `function-exists()` function.
1292
+ /// Returns whether a function with the name `$name` exists.
1293
+ /// @param {String} $name - The name of the function to check.
1294
+ /// @return {Boolean} - Whether a function with the name `$name` exists.
1295
+ ///
1296
+ /// @example scss - Usage
1297
+ /// @debug k-meta-function-exists( "k-string-replace" ); // => true
814
1298
  @function k-meta-function-exists( $name ) {
815
1299
  @return function-exists( $name );
816
1300
  }
817
1301
 
1302
+ /// A wrapper around the `get-function()` function.
1303
+ /// Returns the function with the name `$name`.
1304
+ /// @param {String} $name - The name of the function to get.
1305
+ /// @param {Boolean} $css - Whether to return the CSS representation of the function.
1306
+ /// @param {Module} $module - The module to get the function from.
1307
+ /// @return {Function} - The function with the name `$name`.
1308
+ ///
1309
+ /// @example scss - Usage
1310
+ /// @debug k-meta-get-function( "k-string-replace" ); // => Function
818
1311
  @function k-meta-get-function( $name, $args... ) {
819
1312
  @return get-function( $name, $args... );
820
1313
  }
821
1314
 
1315
+ /// A wrapper around the `inspect()` function.
1316
+ /// Returns a string representation of `$value`.
1317
+ /// @param {Any} $value - The value to inspect.
1318
+ /// @return {String} - A string representation of `$value`.
1319
+ ///
1320
+ /// @example scss - Usage
1321
+ /// @debug k-meta-inspect( "foo bar" ); // => "foo bar"
822
1322
  @function k-meta-inspect( $value ) {
823
1323
  @return inspect( $value );
824
1324
  }
825
1325
 
1326
+ /// A wrapper around the `keywords()` function.
1327
+ /// Returns a map of the keywords in `$args`.
1328
+ /// @param {List} $args - The arguments to process.
1329
+ /// @return {Map} - A map of the keywords in `$args`.
1330
+ ///
1331
+ /// @example scss - Usage
1332
+ /// @debug k-meta-keywords( ( "foo" "bar" "baz" "qux" ) ); // => ( "foo": "bar", "baz": "qux" )
826
1333
  @function k-meta-keywords( $args ) {
827
1334
  @return keywords( $args );
828
1335
  }
829
1336
 
1337
+ /// A wrapper around the `type-of()` function.
1338
+ /// Returns the type of `$value`.
1339
+ /// @param {Any} $value - The value to get the type of.
1340
+ /// @return {String} - The type of `$value`.
1341
+ ///
1342
+ /// @example scss - Usage
1343
+ /// @debug k-meta-type-of( "foo bar" ); // => "string"
830
1344
  @function k-meta-type-of( $value ) {
831
1345
  @return type-of( $value );
832
1346
  }
833
1347
 
1348
+ /// A wrapper around the `variable-exists()` function.
1349
+ /// Returns whether a variable with the name `$name` exists.
1350
+ /// @param {String} $name - The name of the variable to check.
1351
+ /// @return {Boolean} - Whether a variable with the name `$name` exists.
1352
+ ///
1353
+ /// @example scss - Usage
1354
+ /// @debug k-meta-variable-exists( "foo" ); // => true
834
1355
  @function k-meta-variable-exists( $name ) {
835
1356
  @return variable-exists( $name );
836
1357
  }
837
1358
 
1359
+ /// Checks whether `$value` is a <number> CSS data type.
1360
+ /// @param {Any} $value - The value to check.
1361
+ /// @return {Boolean} - Whether `$value` is a number.
1362
+ ///
1363
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/number
1364
+ ///
1365
+ /// @example scss - Usage
1366
+ /// @debug k-meta-is-number( 1 ); // => true
1367
+ /// @debug k-meta-is-number( "foo" ); // => false
838
1368
  @function k-meta-is-number( $value ) {
839
1369
  @return k-meta-type-of( $value ) == "number";
840
1370
  }
841
1371
 
1372
+ /// Checks whether `$value` is a <integer> CSS data type.
1373
+ /// @param {Any} $value - The value to check.
1374
+ /// @return {Boolean} - Whether `$value` is a integer.
1375
+ ///
1376
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/integer
1377
+ ///
1378
+ /// @example scss - Usage
1379
+ /// @debug k-meta-is-integer( 1 ); // => true
1380
+ /// @debug k-meta-is-integer( 1.5 ); // => false
842
1381
  @function k-meta-is-integer( $value ) {
843
1382
  @return k-meta-is-number( $value ) and k-math-round( $value ) == $value;
844
1383
  }
845
1384
 
1385
+ /// Checks whether `$value` is a <time> CSS data type.
1386
+ /// @param {Any} $value - The value to check.
1387
+ /// @return {Boolean} - Whether `$value` is a time.
1388
+ ///
1389
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/time
1390
+ ///
1391
+ /// @example scss - Usage
1392
+ /// @debug k-meta-is-time( 1s ); // => true
1393
+ /// @debug k-meta-is-time( 1 ); // => false
846
1394
  @function k-meta-is-time( $value ) {
847
1395
  @return k-meta-is-number( $value ) and k-string-index( "ms" "s", k-math-unit( $value ) ) != null;
848
1396
  }
849
1397
 
1398
+ /// Checks whether `$value` is a valid duration period.
1399
+ /// @param {Any} $value - The value to check.
1400
+ /// @return {Boolean} - Whether `$value` is a duration.
1401
+ ///
1402
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/time
1403
+ ///
1404
+ /// @example scss - Usage
1405
+ /// @debug k-meta-is-duration( 1s ); // => true
1406
+ /// @debug k-meta-is-duration( 1 ); // => false
850
1407
  @function k-meta-is-duration( $value ) {
851
1408
  @return k-meta-is-time( $value );
852
1409
  }
853
1410
 
1411
+ /// Checks whether `$value` is a <angle> CSS data type.
1412
+ /// @param {Any} $value - The value to check.
1413
+ /// @return {Boolean} - Whether `$value` is a angle.
1414
+ ///
1415
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/angle
1416
+ ///
1417
+ /// @example scss - Usage
1418
+ /// @debug k-meta-is-angle( 1deg ); // => true
1419
+ /// @debug k-meta-is-angle( 1 ); // => false
854
1420
  @function k-meta-is-angle( $value ) {
855
1421
  @return k-meta-is-number( $value ) and k-string-index( "deg" "rad" "grad" "turn", k-math-unit( $value ) ) != null;
856
1422
  }
857
1423
 
1424
+ /// Checks whether `$value` is a <frequency> CSS data type.
1425
+ /// @param {Any} $value - The value to check.
1426
+ /// @return {Boolean} - Whether `$value` is a frequency.
1427
+ ///
1428
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/frequency
1429
+ ///
1430
+ /// @example scss - Usage
1431
+ /// @debug k-meta-is-frequency( 1Hz ); // => true
1432
+ /// @debug k-meta-is-frequency( 1 ); // => false
858
1433
  @function k-meta-is-frequency( $value ) {
859
1434
  @return k-meta-is-number( $value ) and k-string-index( "Hz" "kHz", k-math-unit( $value ) ) != null;
860
1435
  }
861
1436
 
1437
+ /// Checks whether `$value` is a relative <length> CSS data type.
1438
+ /// @param {Any} $value - The value to check.
1439
+ /// @return {Boolean} - Whether `$value` is a relative length.
1440
+ ///
1441
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/length#relative_length_units_based_on_font
1442
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/length#relative_length_units_based_on_viewport
1443
+ ///
1444
+ /// @example scss - Usage
1445
+ /// @debug k-meta-is-relative-length( 1em ); // => true
1446
+ /// @debug k-meta-is-relative-length( 1ch ); // => true
1447
+ /// @debug k-meta-is-relative-length( 1 ); // => false
862
1448
  @function k-meta-is-relative-length( $value ) {
863
1449
  @return k-meta-is-number( $value ) and k-string-index( "em" "ex" "ch" "rem" "vw" "vh" "vmin" "vmax", k-math-unit( $value ) ) != null;
864
1450
  }
865
1451
 
1452
+ /// Checks whether `$value` is an absolute <length> CSS data type.
1453
+ /// @param {Any} $value - The value to check.
1454
+ /// @return {Boolean} - Whether `$value` is an absolute length.
1455
+ ///
1456
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/length#absolute_length_units
1457
+ ///
1458
+ /// @example scss - Usage
1459
+ /// @debug k-meta-is-absolute-length( 1cm ); // => true
1460
+ /// @debug k-meta-is-absolute-length( 1 ); // => false
866
1461
  @function k-meta-is-absolute-length( $value ) {
867
1462
  @return k-meta-is-number( $value ) and k-string-index( "cm" "mm" "in" "px" "pt" "pc", k-math-unit( $value ) ) != null;
868
1463
  }
869
1464
 
1465
+ /// Checks whether `$value` is a <percentage> CSS data type.
1466
+ /// @param {Any} $value - The value to check.
1467
+ /// @return {Boolean} - Whether `$value` is a percentage.
1468
+ ///
1469
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/percentage
1470
+ ///
1471
+ /// @example scss - Usage
1472
+ /// @debug k-meta-is-percentage( 1% ); // => true
1473
+ /// @debug k-meta-is-percentage( 1 ); // => false
870
1474
  @function k-meta-is-percentage( $value ) {
871
1475
  @return k-meta-is-number( $value ) and k-math-unit( $value ) == "%";
872
1476
  }
873
1477
 
1478
+ /// Checks whether `$value` is a <length> CSS data type.
1479
+ /// @param {Any} $value - The value to check.
1480
+ /// @return {Boolean} - Whether `$value` is a length.
1481
+ ///
1482
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/length
1483
+ ///
1484
+ /// @example scss - Usage
1485
+ /// @debug k-meta-is-length( 1em ); // => true
1486
+ /// @debug k-meta-is-length( 1cm ); // => true
1487
+ /// @debug k-meta-is-length( 1 ); // => false
874
1488
  @function k-meta-is-length( $value ) {
875
1489
  @return k-meta-is-relative-length( $value ) or k-meta-is-absolute-length( $value );
876
1490
  }
877
1491
 
1492
+ /// Checks whether `$value` is a <resolution> CSS data type.
1493
+ /// @param {Any} $value - The value to check.
1494
+ /// @return {Boolean} - Whether `$value` is a resolution.
1495
+ ///
1496
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/resolution
1497
+ ///
1498
+ /// @example scss - Usage
1499
+ /// @debug k-meta-is-resolution( 1dpi ); // => true
1500
+ /// @debug k-meta-is-resolution( 1 ); // => false
878
1501
  @function k-meta-is-resolution( $value ) {
879
1502
  @return k-meta-is-number( $value ) and k-string-index( "dpi" "dpcm" "dppx", k-math-unit( $value ) ) != null;
880
1503
  }
881
1504
 
1505
+ /// Checks whether `$value` is a <position> CSS data type.
1506
+ /// @param {Any} $value - The value to check.
1507
+ /// @return {Boolean} - Whether `$value` is a position.
1508
+ ///
1509
+ /// @link https://developer.mozilla.org/en-US/docs/Web/CSS/position
1510
+ ///
1511
+ /// @example scss - Usage
1512
+ /// @debug k-meta-is-position( center ); // => true
882
1513
  @function k-meta-is-position( $value ) {
883
1514
  @return k-meta-is-length( $value ) or k-meta-is-percentage( $value ) or k-string-index( "top" "right" "bottom" "left" "center", $value ) != null;
884
1515
  }
885
1516
 
886
1517
  // #endregion
887
- // #region @import "./_string.import.scss"; -> packages/core/scss/functions/_string.import.scss
1518
+ // #region @import "./_string.import.scss"; -> scss/functions/_string.import.scss
1519
+ /// Returns the first index of `$substring` in `$string`, or `null` if `$string` doesn’t contain `$substring`.
1520
+ /// @param {String} $string - The string to process.
1521
+ /// @param {String} $substring - The substring to look for.
1522
+ /// @return {Number} - The first index of `$substring` in `$string`, or `null` if `$string` doesn’t contain `$substring`.
1523
+ ///
1524
+ /// @example scss - Usage
1525
+ /// @debug k-string-index( "foo bar", "bar" ); // => 5
888
1526
  @function k-string-index( $string, $substring ) {
889
1527
  @return str-index( $string, $substring );
890
1528
  }
891
1529
 
1530
+ /// Returns a copy of `$string` with `$insert` inserted at `$index`.
1531
+ /// @param {String} $string - The string to process.
1532
+ /// @param {String} $insert - The string to insert.
1533
+ /// @param {Number} $index - The index at which to insert `$insert`.
1534
+ /// @return {String} - The resulting string.
1535
+ ///
1536
+ /// @example scss - Usage
1537
+ /// @debug k-string-insert( "foo bar", "baz", 5 ); // => "foo baz bar"
892
1538
  @function k-string-insert( $string, $insert, $index ) {
893
1539
  @return str-insert( $string, $insert, $index );
894
1540
  }
895
1541
 
1542
+ /// Returns the length of `$string`.
1543
+ /// @param {String} $string - The string to process.
1544
+ /// @return {Number} - The length of `$string`.
1545
+ ///
1546
+ /// @example scss - Usage
1547
+ /// @debug k-string-length( "foo bar" ); // => 7
896
1548
  @function k-string-length( $string ) {
897
1549
  @return str-length( $string );
898
1550
  }
899
1551
 
1552
+ /// Returns a copy of `$string` with quotes added.
1553
+ /// @param {String} $string - The string to process.
1554
+ /// @return {String} - The resulting string.
1555
+ ///
1556
+ /// @example scss - Usage
1557
+ /// @debug k-string-quote( "foo bar" ); // => "foo bar"
900
1558
  @function k-string-quote( $string ) {
901
1559
  @return quote( $string );
902
1560
  }
903
1561
 
904
- // See https://www.sassmeister.com/gist/1b4f2da5527830088e4d
1562
+ /// Returns a copy of `$string` with all occurrences of `$search`
1563
+ /// replaced by `$replace`.
1564
+ /// @param {String} $string - The string to process.
1565
+ /// @param {String} $search - The substring to look for.
1566
+ /// @param {String} $replace - The replacement string.
1567
+ /// @return {String} - The resulting string.
1568
+ ///
1569
+ /// @link https://www.sassmeister.com/gist/1b4f2da5527830088e4d
1570
+ ///
1571
+ /// @example scss - Usage
1572
+ /// @debug k-string-replace( "foo bar", "bar", "baz" ); // => "foo baz"
905
1573
  @function k-string-replace( $string, $search, $replace: "" ) {
906
1574
  @if k-meta-type-of( $string ) == number {
907
1575
  $string: $string + "";
@@ -916,22 +1584,53 @@ $_kendo-escape-class-name: (
916
1584
  @return $string;
917
1585
  }
918
1586
 
1587
+ /// Returns a substring of `$string` starting at `$start-at` and ending at `$end-at`.
1588
+ /// @param {String} $string - The string to process.
1589
+ /// @param {Number} $start-at - The index at which to start the substring.
1590
+ /// @param {Number} $end-at - The index at which to end the substring.
1591
+ /// @return {String} - The resulting string.
1592
+ ///
1593
+ /// @example scss - Usage
1594
+ /// @debug k-string-slice( "foo bar", 5 ); // => "bar"
919
1595
  @function k-string-slice( $string, $start-at, $end-at: -1 ) {
920
1596
  @return str-slice( $string, $start-at, $end-at );
921
1597
  }
922
1598
 
1599
+ /// Returns a copy of `$string` with all uppercase letters converted to lowercase.
1600
+ /// @param {String} $string - The string to process.
1601
+ /// @return {String} - The resulting string.
1602
+ ///
1603
+ /// @example scss - Usage
1604
+ /// @debug k-string-to-lower-case( "FOO BAR" ); // => "foo bar"
923
1605
  @function k-string-to-lower-case( $string ) {
924
1606
  @return to-lower-case( $string );
925
1607
  }
926
1608
 
1609
+ /// Returns a copy of `$string` with all lowercase letters converted to uppercase.
1610
+ /// @param {String} $string - The string to process.
1611
+ /// @return {String} - The resulting string.
1612
+ ///
1613
+ /// @example scss - Usage
1614
+ /// @debug k-string-to-upper-case( "foo bar" ); // => "FOO BAR"
927
1615
  @function k-string-to-upper-case( $string ) {
928
1616
  @return to-upper-case( $string );
929
1617
  }
930
1618
 
1619
+ /// Returns a unique identifier.
1620
+ /// @return {String} - The unique identifier.
1621
+ ///
1622
+ /// @example scss - Usage
1623
+ /// @debug k-string-unique-id(); // => UNIQUE_ID
931
1624
  @function k-string-unique-id() {
932
1625
  @return unique-id();
933
1626
  }
934
1627
 
1628
+ /// Returns a copy of `$string` with quotes removed.
1629
+ /// @param {String} $string - The string to process.
1630
+ /// @return {String} - The resulting string.
1631
+ ///
1632
+ /// @example scss - Usage
1633
+ /// @debug k-string-unquote( "foo bar" ); // => foo bar
935
1634
  @function k-string-unquote( $string ) {
936
1635
  @return unquote( $string );
937
1636
  }
@@ -939,8 +1638,8 @@ $_kendo-escape-class-name: (
939
1638
  // #endregion
940
1639
 
941
1640
  // #endregion
942
- // #region @import "./color-system/index.import.scss"; -> packages/core/scss/color-system/index.import.scss
943
- // #region @import "./_functions.import.scss"; -> packages/core/scss/color-system/_functions.import.scss
1641
+ // #region @import "./color-system/index.import.scss"; -> scss/color-system/index.import.scss
1642
+ // #region @import "./_functions.import.scss"; -> scss/color-system/_functions.import.scss
944
1643
  @function k-generate-theme-variant( $variant, $matrix, $src-palette-name ) {
945
1644
  $result: ();
946
1645
 
@@ -1034,25 +1733,131 @@ $_kendo-escape-class-name: (
1034
1733
  }
1035
1734
 
1036
1735
  // #endregion
1037
- // #region @import "./_mixins.import.scss"; -> packages/core/scss/color-system/_mixins.import.scss
1736
+ // #region @import "./_mixins.import.scss"; -> scss/color-system/_mixins.import.scss
1038
1737
 
1039
1738
  // #endregion
1040
- // #region @import "./_variables.scss"; -> packages/core/scss/color-system/_variables.scss
1739
+ // #region @import "./_variables.scss"; -> scss/color-system/_variables.scss
1041
1740
  // Color constants
1741
+
1742
+ /// The color white.
1743
+ /// Note: you cannot change this value.
1744
+ /// @type Color
1745
+ /// @group color-system
1042
1746
  $kendo-color-white: #ffffff; // stylelint-disable-line scss/dollar-variable-default
1747
+
1748
+ /// The color black.
1749
+ /// Note: you cannot change this value.
1750
+ /// @type Color
1751
+ /// @group color-system
1043
1752
  $kendo-color-black: #000000; // stylelint-disable-line scss/dollar-variable-default
1044
1753
 
1754
+ /// The color transparent.
1755
+ /// Note: you cannot change this value.
1756
+ /// @type Color
1757
+ /// @group color-system
1045
1758
  $kendo-color-rgba-transparent: rgba( 0, 0, 0, 0 ); // stylelint-disable-line scss/dollar-variable-default
1046
1759
 
1760
+ /// A gradient that goes from transparent to black.
1761
+ /// Note: you cannot change this value.
1762
+ /// @type Gradient
1763
+ /// @group color-system
1047
1764
  $kendo-gradient-transparent-to-black: rgba( black, 0 ), black; // stylelint-disable-line scss/dollar-variable-default
1765
+
1766
+ /// A gradient that goes from transparent to white.
1767
+ /// Note: you cannot change this value.
1768
+ /// @type Gradient
1769
+ /// @group color-system
1048
1770
  $kendo-gradient-transparent-to-white: rgba( white, 0 ), white; // stylelint-disable-line scss/dollar-variable-default
1771
+
1772
+ /// A gradient that goes from black to transparent.
1773
+ /// Note: you cannot change this value.
1774
+ /// @type Gradient
1775
+ /// @group color-system
1049
1776
  $kendo-gradient-black-to-transparent: black, rgba( black, 0 ); // stylelint-disable-line scss/dollar-variable-default
1777
+
1778
+ /// A gradient that goes from white to transparent.
1779
+ /// Note: you cannot change this value.
1780
+ /// @type Gradient
1781
+ /// @group color-system
1050
1782
  $kendo-gradient-white-to-transparent: white, rgba( white, 0 ); // stylelint-disable-line scss/dollar-variable-default
1051
1783
 
1784
+ /// A gradient that cycles through the colors of the rainbow.
1785
+ /// Note: you cannot change this value.
1786
+ /// @type Gradient
1787
+ /// @group color-system
1052
1788
  $kendo-gradient-rainbow: #ff0000, #ffff00, #00ff00, #00ffff, #0000ff, #ff00ff, #ff0000; // stylelint-disable-line scss/dollar-variable-default
1053
1789
 
1054
1790
  // #endregion
1055
- // #region @import "./_palettes.scss"; -> packages/core/scss/color-system/_palettes.scss
1791
+ // #region @import "./_palettes.scss"; -> scss/color-system/_palettes.scss
1792
+ /// Color palettes to be used in the Kendo UI themes.
1793
+ /// @access private
1794
+ /// @type Record<String, ColorMap>
1795
+ /// @prop {ColorMap} neutral - The neutral palette
1796
+ /// @prop {ColorMap} marsala - The marsala palette
1797
+ /// @prop {ColorMap} bootstrapGray - The Bootstrap gray palette
1798
+ /// @prop {ColorMap} bootstrapBlue - The Bootstrap blue palette
1799
+ /// @prop {ColorMap} bootstrapIndigo - The Bootstrap indigo palette
1800
+ /// @prop {ColorMap} bootstrapPurple - The Bootstrap purple palette
1801
+ /// @prop {ColorMap} bootstrapPink - The Bootstrap pink palette
1802
+ /// @prop {ColorMap} bootstrapRed - The Bootstrap red palette
1803
+ /// @prop {ColorMap} bootstrapOrange - The Bootstrap orange palette
1804
+ /// @prop {ColorMap} bootstrapYellow - The Bootstrap yellow palette
1805
+ /// @prop {ColorMap} bootstrapGreen - The Bootstrap green palette
1806
+ /// @prop {ColorMap} bootstrapTeal - The Bootstrap teal palette
1807
+ /// @prop {ColorMap} bootstrapCyan - The Bootstrap cyan palette
1808
+ /// @prop {ColorMap} fluentNeutral - The Fluent neutral palette
1809
+ /// @prop {ColorMap} materialGray - The Material gray palette
1810
+ /// @prop {ColorMap} materialBlueGray - The Material blue gray palette
1811
+ /// @prop {ColorMap} materialRed - The Material red palette
1812
+ /// @prop {ColorMap} materialPink - The Material pink palette
1813
+ /// @prop {ColorMap} materialPurple - The Material purple palette
1814
+ /// @prop {ColorMap} materialDeepPurple - The Material deep purple palette
1815
+ /// @prop {ColorMap} materialIndigo - The Material indigo palette
1816
+ /// @prop {ColorMap} materialBlue - The Material blue palette
1817
+ /// @prop {ColorMap} materialLightBlue - The Material light blue palette
1818
+ /// @prop {ColorMap} materialCyan - The Material cyan palette
1819
+ /// @prop {ColorMap} materialTeal - The Material teal palette
1820
+ /// @prop {ColorMap} materialGreen - The Material green palette
1821
+ /// @prop {ColorMap} materialLightGreen - The Material light green palette
1822
+ /// @prop {ColorMap} materialLime - The Material lime palette
1823
+ /// @prop {ColorMap} materialYellow - The Material yellow palette
1824
+ /// @prop {ColorMap} materialAmber - The Material amber palette
1825
+ /// @prop {ColorMap} materialOrange - The Material orange palette
1826
+ /// @prop {ColorMap} materialDeepOrange - The Material deep orange palette
1827
+ /// @prop {ColorMap} materialBrown - The Material brown palette
1828
+ /// @prop {ColorMap} primerGray - The Primer gray palette
1829
+ /// @prop {ColorMap} primerBlue - The Primer blue palette
1830
+ /// @prop {ColorMap} primerGreen - The Primer green palette
1831
+ /// @prop {ColorMap} primerYellow - The Primer yellow palette
1832
+ /// @prop {ColorMap} primerOrange - The Primer orange palette
1833
+ /// @prop {ColorMap} primerRed - The Primer red palette
1834
+ /// @prop {ColorMap} primerPurple - The Primer purple palette
1835
+ /// @prop {ColorMap} primerPink - The Primer pink palette
1836
+ /// @prop {ColorMap} primerCoral - The Primer coral palette
1837
+ /// @prop {ColorMap} tailwindNeutral - The Tailwind neutral palette
1838
+ /// @prop {ColorMap} tailwindSlate - The Tailwind slate palette
1839
+ /// @prop {ColorMap} tailwindGray - The Tailwind gray palette
1840
+ /// @prop {ColorMap} tailwindZinc - The Tailwind zinc palette
1841
+ /// @prop {ColorMap} tailwindStone - The Tailwind stone palette
1842
+ /// @prop {ColorMap} tailwindRed - The Tailwind red palette
1843
+ /// @prop {ColorMap} tailwindOrange - The Tailwind orange palette
1844
+ /// @prop {ColorMap} tailwindAmber - The Tailwind amber palette
1845
+ /// @prop {ColorMap} tailwindYellow - The Tailwind yellow palette
1846
+ /// @prop {ColorMap} tailwindLime - The Tailwind lime palette
1847
+ /// @prop {ColorMap} tailwindGreen - The Tailwind green palette
1848
+ /// @prop {ColorMap} tailwindEmerald - The Tailwind emerald palette
1849
+ /// @prop {ColorMap} tailwindTeal - The Tailwind teal palette
1850
+ /// @prop {ColorMap} tailwindCyan - The Tailwind cyan palette
1851
+ /// @prop {ColorMap} tailwindSky - The Tailwind sky palette
1852
+ /// @prop {ColorMap} tailwindBlue - The Tailwind blue palette
1853
+ /// @prop {ColorMap} tailwindIndigo - The Tailwind indigo palette
1854
+ /// @prop {ColorMap} tailwindViolet - The Tailwind violet palette
1855
+ /// @prop {ColorMap} tailwindPurple - The Tailwind purple palette
1856
+ /// @prop {ColorMap} tailwindFuchsia - The Tailwind fuchsia palette
1857
+ /// @prop {ColorMap} tailwindPink - The Tailwind pink palette
1858
+ /// @prop {ColorMap} tailwindRose - The Tailwind rose palette
1859
+ ///
1860
+ /// @group color-system
1056
1861
  $kendo-palettes: (
1057
1862
 
1058
1863
  // Kendo
@@ -1972,8 +2777,8 @@ $kendo-palettes: (
1972
2777
  // #endregion
1973
2778
 
1974
2779
  // #endregion
1975
- // #region @import "./mixins/index.import.scss"; -> packages/core/scss/mixins/index.import.scss
1976
- // #region @import "./_border-radius.scss"; -> packages/core/scss/mixins/_border-radius.scss
2780
+ // #region @import "./mixins/index.import.scss"; -> scss/mixins/index.import.scss
2781
+ // #region @import "./_border-radius.scss"; -> scss/mixins/_border-radius.scss
1977
2782
  // Border radius
1978
2783
  @mixin border-radius( $radius: null ) {
1979
2784
  @if $kendo-enable-rounded {
@@ -2034,7 +2839,7 @@ $kendo-palettes: (
2034
2839
  }
2035
2840
 
2036
2841
  // #endregion
2037
- // #region @import "./_box-shadow.scss"; -> packages/core/scss/mixins/_box-shadow.scss
2842
+ // #region @import "./_box-shadow.scss"; -> scss/mixins/_box-shadow.scss
2038
2843
  @mixin box-shadow( $shadow... ) {
2039
2844
  @if $kendo-enable-shadows and k-list-nth($shadow, 1) {
2040
2845
  box-shadow: $shadow;
@@ -2042,7 +2847,7 @@ $kendo-palettes: (
2042
2847
  }
2043
2848
 
2044
2849
  // #endregion
2045
- // #region @import "./_data-uri.scss"; -> packages/core/scss/mixins/_data-uri.scss
2850
+ // #region @import "./_data-uri.scss"; -> scss/mixins/_data-uri.scss
2046
2851
  /// A list of files converted to data URIs
2047
2852
  /// @access private
2048
2853
  $_kendo-data-uris: () !default;
@@ -2062,7 +2867,7 @@ $_kendo-data-uris: () !default;
2062
2867
  }
2063
2868
 
2064
2869
  // #endregion
2065
- // #region @import "./_disabled.scss"; -> packages/core/scss/mixins/_disabled.scss
2870
+ // #region @import "./_disabled.scss"; -> scss/mixins/_disabled.scss
2066
2871
  // Disabled
2067
2872
  @mixin disabled( $kendo-disabled-styling ) {
2068
2873
  outline: none;
@@ -2074,7 +2879,7 @@ $_kendo-data-uris: () !default;
2074
2879
  }
2075
2880
 
2076
2881
  // #endregion
2077
- // #region @import "./_focus-indicator.scss"; -> packages/core/scss/mixins/_focus-indicator.scss
2882
+ // #region @import "./_focus-indicator.scss"; -> scss/mixins/_focus-indicator.scss
2078
2883
  @mixin focus-indicator( $indicator, $inset: false, $themeable: false, $type: "box-shadow" ) {
2079
2884
  @if $kendo-enable-focus-contrast and k-list-nth($indicator, 1) {
2080
2885
  @include box-shadow( if( $inset, inset, null ) 0 0 0 2px if( $themeable, currentColor, rgb( 0, 0, 0 ) ) );
@@ -2084,7 +2889,7 @@ $_kendo-data-uris: () !default;
2084
2889
  }
2085
2890
 
2086
2891
  // #endregion
2087
- // #region @import "./_gradient.scss"; -> packages/core/scss/mixins/_gradient.scss
2892
+ // #region @import "./_gradient.scss"; -> scss/mixins/_gradient.scss
2088
2893
  @mixin linear-gradient( $gradient: null ) {
2089
2894
  @if $gradient and $kendo-enable-gradients {
2090
2895
  @if $gradient == none {
@@ -2123,7 +2928,7 @@ $_kendo-data-uris: () !default;
2123
2928
  }
2124
2929
 
2125
2930
  // #endregion
2126
- // #region @import "./_hide-scrollbar.scss"; -> packages/core/scss/mixins/_hide-scrollbar.scss
2931
+ // #region @import "./_hide-scrollbar.scss"; -> scss/mixins/_hide-scrollbar.scss
2127
2932
  $kendo-scrollbar-width: 17px !default;
2128
2933
 
2129
2934
  @mixin hide-scrollbar( $dir: "right", $max-scrollbar: 100px ) {
@@ -2144,7 +2949,7 @@ $kendo-scrollbar-width: 17px !default;
2144
2949
  }
2145
2950
 
2146
2951
  // #endregion
2147
- // #region @import "./_import-once.scss"; -> packages/core/scss/mixins/_import-once.scss
2952
+ // #region @import "./_import-once.scss"; -> scss/mixins/_import-once.scss
2148
2953
  /// A list of exported modules.
2149
2954
  /// @access private
2150
2955
  $_kendo-imported-modules: () !default;
@@ -2161,7 +2966,7 @@ $_kendo-imported-modules: () !default;
2161
2966
  }
2162
2967
 
2163
2968
  // #endregion
2164
- // #region @import "./_typography.scss"; -> packages/core/scss/mixins/_typography.scss
2969
+ // #region @import "./_typography.scss"; -> scss/mixins/_typography.scss
2165
2970
  @mixin typography( $font-size: null, $font-family: null, $line-height: null, $font-weight: null, $letter-spacing: null ) {
2166
2971
  font-size: $font-size;
2167
2972
  font-family: $font-family;
@@ -2186,8 +2991,8 @@ $_kendo-imported-modules: () !default;
2186
2991
  }
2187
2992
 
2188
2993
  // #endregion
2189
- // #region @import "./module-system/index.import.scss"; -> packages/core/scss/module-system/index.import.scss
2190
- // #region @import "./_components.scss"; -> packages/core/scss/module-system/_components.scss
2994
+ // #region @import "./module-system/index.import.scss"; -> scss/module-system/index.import.scss
2995
+ // #region @import "./_components.scss"; -> scss/module-system/_components.scss
2191
2996
  $kendo-components: (
2192
2997
  // Typography and utils
2193
2998
  "typography",
@@ -2331,7 +3136,7 @@ $kendo-components: (
2331
3136
  ) !default;
2332
3137
 
2333
3138
  // #endregion
2334
- // #region @import "./_dependencies.scss"; -> packages/core/scss/module-system/_dependencies.scss
3139
+ // #region @import "./_dependencies.scss"; -> scss/module-system/_dependencies.scss
2335
3140
  $_kendo-dependencies: (
2336
3141
  action-sheet: (
2337
3142
  "icon",
@@ -2859,8 +3664,8 @@ $_imported: ();
2859
3664
  @include verify-dependencies();
2860
3665
 
2861
3666
  // #endregion
2862
- // #region @import "./styles/index.import.scss"; -> packages/core/scss/styles/index.import.scss
2863
- // #region @import "./_accessibility.scss"; -> packages/core/scss/styles/_accessibility.scss
3667
+ // #region @import "./styles/index.import.scss"; -> scss/styles/index.import.scss
3668
+ // #region @import "./_accessibility.scss"; -> scss/styles/_accessibility.scss
2864
3669
  @mixin kendo-core--styles--accessibility() {
2865
3670
 
2866
3671
  /// This class could be assigned to elements which should be visually hidden, but remain accessible for screen readers.
@@ -2877,7 +3682,7 @@ $_imported: ();
2877
3682
  }
2878
3683
 
2879
3684
  // #endregion
2880
- // #region @import "./_asp-fallback.scss"; -> packages/core/scss/styles/_asp-fallback.scss
3685
+ // #region @import "./_asp-fallback.scss"; -> scss/styles/_asp-fallback.scss
2881
3686
  @mixin kendo-core--styles--asp-fallback() {
2882
3687
 
2883
3688
  .k-theme-test-class,
@@ -2888,7 +3693,7 @@ $_imported: ();
2888
3693
  }
2889
3694
 
2890
3695
  // #endregion
2891
- // #region @import "./_layout"; -> packages/core/scss/styles/_layout.scss
3696
+ // #region @import "./_layout"; -> scss/styles/_layout.scss
2892
3697
  @mixin kendo-core--styles--layout() {
2893
3698
 
2894
3699
  // Basic layout
@@ -2986,7 +3791,7 @@ $_imported: ();
2986
3791
  }
2987
3792
 
2988
3793
  // #endregion
2989
- // #region @import "./_normalize.scss"; -> packages/core/scss/styles/_normalize.scss
3794
+ // #region @import "./_normalize.scss"; -> scss/styles/_normalize.scss
2990
3795
  @mixin kendo-core--styles--normalize() {
2991
3796
 
2992
3797
  // Hidden attribute
@@ -3014,7 +3819,7 @@ $_imported: ();
3014
3819
  }
3015
3820
 
3016
3821
  // #endregion
3017
- // #region @import "./_variables.scss"; -> packages/core/scss/_variables.scss
3822
+ // #region @import "./_variables.scss"; -> scss/_variables.scss
3018
3823
  // File already imported_once. Skipping output.
3019
3824
  // #endregion
3020
3825