@fluentui/web-components 1.6.3 → 2.1.0

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.
Files changed (170) hide show
  1. package/CHANGELOG.json +103 -1
  2. package/CHANGELOG.md +40 -2
  3. package/dist/dts/calendar/calendar.stories.d.ts +86 -0
  4. package/dist/dts/calendar/calendar.styles.d.ts +7 -0
  5. package/dist/dts/calendar/index.d.ts +18 -0
  6. package/dist/dts/color/palette.d.ts +43 -1
  7. package/dist/dts/color/recipes/contrast-and-delta-swatch-set.d.ts +11 -0
  8. package/dist/dts/color/recipes/contrast-swatch.d.ts +12 -0
  9. package/dist/dts/color/recipes/delta-swatch-set.d.ts +36 -0
  10. package/dist/dts/color/recipes/{neutral-divider.d.ts → delta-swatch.d.ts} +3 -2
  11. package/dist/dts/color/recipes/focus-stroke.d.ts +2 -2
  12. package/dist/dts/color/recipes/foreground-on-accent.d.ts +6 -0
  13. package/dist/dts/color/recipes/gradient-shadow-stroke.d.ts +7 -0
  14. package/dist/dts/color/recipes/gradient-swatch.d.ts +36 -0
  15. package/dist/dts/color/recipes/neutral-layer-1.d.ts +4 -0
  16. package/dist/dts/color/recipes/neutral-layer-2.d.ts +1 -5
  17. package/dist/dts/color/recipes/neutral-layer-3.d.ts +1 -1
  18. package/dist/dts/color/recipes/neutral-layer-4.d.ts +1 -1
  19. package/dist/dts/color/recipes/neutral-layer-floating.d.ts +1 -1
  20. package/dist/dts/color/recipes/underline-stroke.d.ts +7 -0
  21. package/dist/dts/color/swatch.d.ts +7 -0
  22. package/dist/dts/color/utilities/base-layer-luminance.d.ts +2 -2
  23. package/dist/dts/combobox/index.d.ts +1 -2
  24. package/dist/dts/custom-elements.d.ts +4 -2
  25. package/dist/dts/data-grid/data-grid-row.styles.d.ts +1 -1
  26. package/dist/dts/data-grid/index.d.ts +1 -1
  27. package/dist/dts/design-system-provider/index.d.ts +14 -29
  28. package/dist/dts/design-tokens.d.ts +198 -82
  29. package/dist/dts/menu/index.d.ts +11 -6
  30. package/dist/dts/menu/menu.stories.d.ts +1 -1
  31. package/dist/dts/select/index.d.ts +1 -1
  32. package/dist/dts/select/select.stories.d.ts +8 -0
  33. package/dist/dts/select/select.styles.d.ts +1 -0
  34. package/dist/dts/skeleton/skeleton.stories.d.ts +1 -0
  35. package/dist/dts/styles/elevation.d.ts +44 -5
  36. package/dist/dts/styles/patterns/button.styles.d.ts +7 -6
  37. package/dist/dts/styles/patterns/index.d.ts +1 -1
  38. package/dist/dts/styles/patterns/input.styles.d.ts +22 -0
  39. package/dist/dts/text-area/text-area.stories.d.ts +1 -1
  40. package/dist/dts/tree-view/tree-view.stories.d.ts +0 -5
  41. package/dist/esm/accordion/accordion-item/accordion-item.styles.js +54 -17
  42. package/dist/esm/accordion/accordion-item/index.js +4 -22
  43. package/dist/esm/accordion/accordion.styles.js +4 -4
  44. package/dist/esm/anchor/anchor.stories.js +2 -2
  45. package/dist/esm/anchor/anchor.styles.js +8 -2
  46. package/dist/esm/badge/badge.styles.js +10 -2
  47. package/dist/esm/breadcrumb-item/breadcrumb-item.styles.js +44 -53
  48. package/dist/esm/breadcrumb-item/index.js +2 -4
  49. package/dist/esm/button/button.stories.js +1 -1
  50. package/dist/esm/button/button.styles.js +21 -71
  51. package/dist/esm/calendar/calendar.stories.js +115 -0
  52. package/dist/esm/calendar/calendar.styles.js +133 -0
  53. package/dist/esm/calendar/index.js +31 -0
  54. package/dist/esm/card/card.stories.js +14 -0
  55. package/dist/esm/card/card.styles.js +23 -32
  56. package/dist/esm/card/index.js +1 -1
  57. package/dist/esm/checkbox/checkbox.styles.js +58 -51
  58. package/dist/esm/checkbox/index.js +5 -13
  59. package/dist/esm/color/palette.js +174 -12
  60. package/dist/esm/color/recipes/contrast-and-delta-swatch-set.js +28 -0
  61. package/dist/esm/color/recipes/contrast-swatch.js +12 -0
  62. package/dist/esm/color/recipes/delta-swatch-set.js +53 -0
  63. package/dist/esm/color/recipes/{neutral-divider.js → delta-swatch.js} +3 -2
  64. package/dist/esm/color/recipes/focus-stroke.js +4 -3
  65. package/dist/esm/color/recipes/foreground-on-accent.js +14 -0
  66. package/dist/esm/color/recipes/gradient-shadow-stroke.js +54 -0
  67. package/dist/esm/color/recipes/gradient-swatch.js +36 -0
  68. package/dist/esm/color/recipes/neutral-layer-1.js +7 -1
  69. package/dist/esm/color/recipes/neutral-layer-2.js +3 -9
  70. package/dist/esm/color/recipes/neutral-layer-3.js +3 -3
  71. package/dist/esm/color/recipes/neutral-layer-4.js +3 -3
  72. package/dist/esm/color/recipes/neutral-layer-floating.js +3 -4
  73. package/dist/esm/color/recipes/underline-stroke.js +31 -0
  74. package/dist/esm/color/swatch.js +22 -2
  75. package/dist/esm/color/utilities/base-layer-luminance.js +2 -2
  76. package/dist/esm/combobox/combobox.stories.js +1 -0
  77. package/dist/esm/combobox/index.js +6 -9
  78. package/dist/esm/custom-elements.js +3 -1
  79. package/dist/esm/data-grid/data-grid-cell.styles.js +4 -4
  80. package/dist/esm/data-grid/data-grid-row.styles.js +3 -3
  81. package/dist/esm/design-system-provider/design-system-provider.vscode.definition.json +17 -9
  82. package/dist/esm/design-system-provider/index.js +24 -39
  83. package/dist/esm/design-tokens.js +303 -217
  84. package/dist/esm/dialog/dialog.styles.js +2 -3
  85. package/dist/esm/divider/divider.styles.js +1 -2
  86. package/dist/esm/flipper/flipper.styles.js +28 -65
  87. package/dist/esm/flipper/index.js +4 -8
  88. package/dist/esm/listbox/listbox.styles.js +8 -29
  89. package/dist/esm/listbox-option/listbox-option.styles.js +52 -35
  90. package/dist/esm/menu/index.js +16 -6
  91. package/dist/esm/menu/menu.stories.js +16 -2
  92. package/dist/esm/menu/menu.styles.js +38 -27
  93. package/dist/esm/menu-item/index.js +6 -33
  94. package/dist/esm/menu-item/menu-item.stories.js +1 -1
  95. package/dist/esm/menu-item/menu-item.styles.js +58 -84
  96. package/dist/esm/number-field/index.js +7 -3
  97. package/dist/esm/number-field/number-field.styles.js +30 -175
  98. package/dist/esm/progress/progress/index.js +1 -1
  99. package/dist/esm/progress/progress/progress.styles.js +13 -18
  100. package/dist/esm/progress/progress-ring/progress-ring.styles.js +65 -69
  101. package/dist/esm/radio/index.js +3 -1
  102. package/dist/esm/radio/radio.stories.js +3 -2
  103. package/dist/esm/radio/radio.styles.js +52 -42
  104. package/dist/esm/radio-group/radio-group.styles.js +0 -2
  105. package/dist/esm/select/index.js +6 -9
  106. package/dist/esm/select/select.stories.js +10 -2
  107. package/dist/esm/select/select.styles.js +100 -124
  108. package/dist/esm/select/select.vscode.definition.json +3 -0
  109. package/dist/esm/skeleton/skeleton.stories.js +3 -2
  110. package/dist/esm/skeleton/skeleton.styles.js +11 -6
  111. package/dist/esm/slider/slider.styles.js +54 -14
  112. package/dist/esm/slider-label/slider-label.styles.js +5 -6
  113. package/dist/esm/styles/direction.js +1 -1
  114. package/dist/esm/styles/elevation.js +54 -5
  115. package/dist/esm/styles/patterns/button.styles.js +274 -294
  116. package/dist/esm/styles/patterns/index.js +1 -1
  117. package/dist/esm/styles/patterns/input.styles.js +218 -0
  118. package/dist/esm/switch/index.js +3 -1
  119. package/dist/esm/switch/switch.stories.js +3 -3
  120. package/dist/esm/switch/switch.styles.js +79 -60
  121. package/dist/esm/tabs/tab/tab.styles.js +11 -14
  122. package/dist/esm/tabs/tabs.styles.js +9 -8
  123. package/dist/esm/text-area/text-area.stories.js +2 -2
  124. package/dist/esm/text-area/text-area.styles.js +16 -96
  125. package/dist/esm/text-field/text-field.stories.js +1 -1
  126. package/dist/esm/text-field/text-field.styles.js +16 -144
  127. package/dist/esm/toolbar/index.js +1 -0
  128. package/dist/esm/toolbar/toolbar.styles.js +56 -56
  129. package/dist/esm/tooltip/index.js +2 -4
  130. package/dist/esm/tooltip/tooltip.styles.js +14 -14
  131. package/dist/esm/tree-item/index.js +2 -8
  132. package/dist/esm/tree-item/tree-item.styles.js +45 -80
  133. package/dist/esm/tree-view/tree-view.stories.js +23 -11
  134. package/dist/fluent-web-components.api.json +4900 -2353
  135. package/dist/web-components.d.ts +397 -100
  136. package/dist/web-components.js +2240 -2175
  137. package/dist/web-components.min.js +158 -128
  138. package/docs/api-report.md +338 -80
  139. package/package.json +2 -5
  140. package/public/switches.ts +13 -14
  141. package/dist/dts/color/recipes/accent-fill.d.ts +0 -7
  142. package/dist/dts/color/recipes/accent-foreground.d.ts +0 -7
  143. package/dist/dts/color/recipes/neutral-fill-contrast.d.ts +0 -7
  144. package/dist/dts/color/recipes/neutral-fill-input.d.ts +0 -7
  145. package/dist/dts/color/recipes/neutral-fill-inverse.d.ts +0 -7
  146. package/dist/dts/color/recipes/neutral-fill-layer.d.ts +0 -6
  147. package/dist/dts/color/recipes/neutral-fill-stealth.d.ts +0 -7
  148. package/dist/dts/color/recipes/neutral-fill.d.ts +0 -14
  149. package/dist/dts/color/recipes/neutral-foreground-hint.d.ts +0 -10
  150. package/dist/dts/color/recipes/neutral-foreground.d.ts +0 -6
  151. package/dist/dts/color/recipes/neutral-layer-card-container.d.ts +0 -6
  152. package/dist/dts/color/recipes/neutral-stroke-strong.d.ts +0 -7
  153. package/dist/dts/color/recipes/neutral-stroke.d.ts +0 -7
  154. package/dist/dts/styles/patterns/input.d.ts +0 -4
  155. package/dist/dts/utilities/math.d.ts +0 -24
  156. package/dist/esm/color/recipes/accent-fill.js +0 -18
  157. package/dist/esm/color/recipes/accent-foreground.js +0 -31
  158. package/dist/esm/color/recipes/neutral-fill-contrast.js +0 -26
  159. package/dist/esm/color/recipes/neutral-fill-input.js +0 -14
  160. package/dist/esm/color/recipes/neutral-fill-inverse.js +0 -26
  161. package/dist/esm/color/recipes/neutral-fill-layer.js +0 -7
  162. package/dist/esm/color/recipes/neutral-fill-stealth.js +0 -14
  163. package/dist/esm/color/recipes/neutral-fill.js +0 -21
  164. package/dist/esm/color/recipes/neutral-foreground-hint.js +0 -10
  165. package/dist/esm/color/recipes/neutral-foreground.js +0 -6
  166. package/dist/esm/color/recipes/neutral-layer-card-container.js +0 -9
  167. package/dist/esm/color/recipes/neutral-stroke-strong.js +0 -15
  168. package/dist/esm/color/recipes/neutral-stroke.js +0 -18
  169. package/dist/esm/styles/patterns/input.js +0 -31
  170. package/dist/esm/utilities/math.js +0 -49
package/CHANGELOG.json CHANGED
@@ -2,7 +2,109 @@
2
2
  "name": "@fluentui/web-components",
3
3
  "entries": [
4
4
  {
5
- "date": "Fri, 22 Oct 2021 19:29:44 GMT",
5
+ "date": "Tue, 23 Nov 2021 07:26:04 GMT",
6
+ "tag": "@fluentui/web-components_v2.1.0",
7
+ "version": "2.1.0",
8
+ "comments": {
9
+ "minor": [
10
+ {
11
+ "author": "jes@microsoft.com",
12
+ "package": "@fluentui/web-components",
13
+ "commit": "2dbe9eadd8ae071bbb056ad15461c1c7ea8d9430",
14
+ "comment": "fix: remove margins from host elements"
15
+ }
16
+ ]
17
+ }
18
+ },
19
+ {
20
+ "date": "Tue, 09 Nov 2021 07:38:11 GMT",
21
+ "tag": "@fluentui/web-components_v2.0.2",
22
+ "version": "2.0.2",
23
+ "comments": {
24
+ "patch": [
25
+ {
26
+ "author": "robarb@microsoft.com",
27
+ "package": "@fluentui/web-components",
28
+ "commit": "55a9400f93758ad7cb37789aa524a6eb6b2a5322",
29
+ "comment": "FluentUI calendar component"
30
+ }
31
+ ]
32
+ }
33
+ },
34
+ {
35
+ "date": "Tue, 02 Nov 2021 07:37:01 GMT",
36
+ "tag": "@fluentui/web-components_v2.0.1",
37
+ "version": "2.0.1",
38
+ "comments": {
39
+ "patch": [
40
+ {
41
+ "author": "chhol@microsoft.com",
42
+ "package": "@fluentui/web-components",
43
+ "commit": "71d4e117d0bad7e238ff53e4d1a0671a6ead7085",
44
+ "comment": "fix web components webpack integration docs and update the package dependencies"
45
+ },
46
+ {
47
+ "author": "khamu@microsoft.com",
48
+ "package": "@fluentui/web-components",
49
+ "commit": "2cb0ac33d03c843c556c2cd554fd6ac9a91f4f33",
50
+ "comment": "fixed high contrast visual for web components"
51
+ },
52
+ {
53
+ "author": "chhol@microsoft.com",
54
+ "package": "@fluentui/web-components",
55
+ "commit": "e9e7f438f1530d5629108a27dfd1d81d7c107293",
56
+ "comment": "change input state styles to fix height and prevent z-index from blocking cursor"
57
+ }
58
+ ]
59
+ }
60
+ },
61
+ {
62
+ "date": "Mon, 01 Nov 2021 21:28:50 GMT",
63
+ "tag": "@fluentui/web-components_v2.0.0",
64
+ "version": "2.0.0",
65
+ "comments": {
66
+ "none": [
67
+ {
68
+ "author": "brookdozer@gmail.com",
69
+ "package": "@fluentui/web-components",
70
+ "commit": "197823fe1233c21127dbce9c546c90e3e0e548be",
71
+ "comment": "Fixing visual update merge conflicts"
72
+ }
73
+ ]
74
+ }
75
+ },
76
+ {
77
+ "date": "Mon, 25 Oct 2021 07:38:02 GMT",
78
+ "tag": "@fluentui/web-components_v2.0.0",
79
+ "version": "2.0.0",
80
+ "comments": {
81
+ "none": [
82
+ {
83
+ "author": "chhol@microsoft.com",
84
+ "package": "@fluentui/web-components",
85
+ "comment": "remove beachball configuration override to again disallow major versions",
86
+ "commit": "a88fb53fb38a20912b7ddea33b5f3313a721e148"
87
+ }
88
+ ]
89
+ }
90
+ },
91
+ {
92
+ "date": "Fri, 22 Oct 2021 23:04:22 GMT",
93
+ "tag": "@fluentui/web-components_v2.0.0",
94
+ "version": "2.0.0",
95
+ "comments": {
96
+ "major": [
97
+ {
98
+ "author": "47367562+bheston@users.noreply.github.com",
99
+ "package": "@fluentui/web-components",
100
+ "comment": "Update to Sun Valley visual styling",
101
+ "commit": "4e422ca35d0eb8dcf173031e1b0915e2439b2e19"
102
+ }
103
+ ]
104
+ }
105
+ },
106
+ {
107
+ "date": "Fri, 22 Oct 2021 19:30:28 GMT",
6
108
  "tag": "@fluentui/web-components_v1.6.3",
7
109
  "version": "1.6.3",
8
110
  "comments": {
package/CHANGELOG.md CHANGED
@@ -1,12 +1,50 @@
1
1
  # Change Log - @fluentui/web-components
2
2
 
3
- This log was last generated on Fri, 22 Oct 2021 19:29:44 GMT and should not be manually modified.
3
+ This log was last generated on Tue, 23 Nov 2021 07:26:04 GMT and should not be manually modified.
4
4
 
5
5
  <!-- Start content -->
6
6
 
7
+ ## [2.1.0](https://github.com/microsoft/fluentui/tree/@fluentui/web-components_v2.1.0)
8
+
9
+ Tue, 23 Nov 2021 07:26:04 GMT
10
+ [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/web-components_v2.0.2..@fluentui/web-components_v2.1.0)
11
+
12
+ ### Minor changes
13
+
14
+ - fix: remove margins from host elements ([PR #20710](https://github.com/microsoft/fluentui/pull/20710) by jes@microsoft.com)
15
+
16
+ ## [2.0.2](https://github.com/microsoft/fluentui/tree/@fluentui/web-components_v2.0.2)
17
+
18
+ Tue, 09 Nov 2021 07:38:11 GMT
19
+ [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/web-components_v2.0.1..@fluentui/web-components_v2.0.2)
20
+
21
+ ### Patches
22
+
23
+ - FluentUI calendar component ([PR #20356](https://github.com/microsoft/fluentui/pull/20356) by robarb@microsoft.com)
24
+
25
+ ## [2.0.1](https://github.com/microsoft/fluentui/tree/@fluentui/web-components_v2.0.1)
26
+
27
+ Tue, 02 Nov 2021 07:37:01 GMT
28
+ [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/web-components_v2.0.0..@fluentui/web-components_v2.0.1)
29
+
30
+ ### Patches
31
+
32
+ - fix web components webpack integration docs and update the package dependencies ([PR #20429](https://github.com/microsoft/fluentui/pull/20429) by chhol@microsoft.com)
33
+ - fixed high contrast visual for web components ([PR #20418](https://github.com/microsoft/fluentui/pull/20418) by khamu@microsoft.com)
34
+ - change input state styles to fix height and prevent z-index from blocking cursor ([PR #20445](https://github.com/microsoft/fluentui/pull/20445) by chhol@microsoft.com)
35
+
36
+ ## [2.0.0](https://github.com/microsoft/fluentui/tree/@fluentui/web-components_v2.0.0)
37
+
38
+ Fri, 22 Oct 2021 23:04:22 GMT
39
+ [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/web-components_v1.6.3..@fluentui/web-components_v2.0.0)
40
+
41
+ ### Major changes
42
+
43
+ - Update to Sun Valley visual styling ([PR #19263](https://github.com/microsoft/fluentui/pull/19263) by 47367562+bheston@users.noreply.github.com)
44
+
7
45
  ## [1.6.3](https://github.com/microsoft/fluentui/tree/@fluentui/web-components_v1.6.3)
8
46
 
9
- Fri, 22 Oct 2021 19:29:44 GMT
47
+ Fri, 22 Oct 2021 19:30:28 GMT
10
48
  [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/web-components_v1.6.2..@fluentui/web-components_v1.6.3)
11
49
 
12
50
  ### Patches
@@ -0,0 +1,86 @@
1
+ import './index';
2
+ declare const _default: {
3
+ title: string;
4
+ component: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").CalendarOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").CalendarOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
5
+ argTypes: {
6
+ month: {
7
+ description: string;
8
+ control: {
9
+ type: string;
10
+ };
11
+ options: string[];
12
+ default: string;
13
+ };
14
+ year: {
15
+ description: string;
16
+ control: {
17
+ type: string;
18
+ };
19
+ options: string[];
20
+ default: string;
21
+ };
22
+ locale: {
23
+ control: {
24
+ type: string;
25
+ };
26
+ options: string[];
27
+ default: string;
28
+ description: string;
29
+ };
30
+ dayFormat: {
31
+ description: string;
32
+ options: string[];
33
+ control: {
34
+ type: string;
35
+ };
36
+ default: string;
37
+ };
38
+ weekdayFormat: {
39
+ description: string;
40
+ options: string[];
41
+ control: {
42
+ type: string;
43
+ };
44
+ default: string;
45
+ };
46
+ monthFormat: {
47
+ description: string;
48
+ options: string[];
49
+ control: {
50
+ type: string;
51
+ };
52
+ default: string;
53
+ };
54
+ yearFormat: {
55
+ description: string;
56
+ options: string[];
57
+ control: {
58
+ type: string;
59
+ };
60
+ default: string;
61
+ };
62
+ disabledDates: {
63
+ description: string;
64
+ options: any;
65
+ control: {
66
+ type: string;
67
+ };
68
+ };
69
+ selectedDates: {
70
+ description: string;
71
+ options: any;
72
+ control: {
73
+ type: string;
74
+ };
75
+ };
76
+ readonly: {
77
+ description: string;
78
+ control: {
79
+ type: string;
80
+ };
81
+ default: boolean;
82
+ };
83
+ };
84
+ };
85
+ export default _default;
86
+ export declare const Calendar: any;
@@ -0,0 +1,7 @@
1
+ import { ElementStyles } from "@microsoft/fast-element";
2
+ import { ElementDefinitionContext, FoundationElementDefinition } from '@microsoft/fast-foundation';
3
+ /**
4
+ * Styles for calendar
5
+ * @public
6
+ */
7
+ export declare const calendarStyles: (context: ElementDefinitionContext, definition: FoundationElementDefinition) => ElementStyles;
@@ -0,0 +1,18 @@
1
+ import { CalendarOptions, Calendar as FoundationCalendar } from '@microsoft/fast-foundation';
2
+ import { calendarStyles as styles } from './calendar.styles';
3
+ /**
4
+ * Updated Calendar class that is readonly by default
5
+ */
6
+ export declare class Calendar extends FoundationCalendar {
7
+ readonly: boolean;
8
+ }
9
+ /**
10
+ * The Fluent Calendar Element. Implements {@link @microsoft/fast-foundation#Calendar},
11
+ * {@link @microsoft/fast-foundation#calendarTemplate}
12
+ *
13
+ * @public
14
+ * @remarks
15
+ * HTML Element \<fluent-calendar\>
16
+ */
17
+ export declare const fluentCalendar: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<CalendarOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<CalendarOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
18
+ export { styles as calendarStyles };
@@ -23,9 +23,51 @@ export interface Palette<T extends Swatch = Swatch> {
23
23
  */
24
24
  get(index: number): T;
25
25
  }
26
+ /**
27
+ * Options to tailor the generation of the color palette.
28
+ * @public
29
+ */
30
+ export interface PaletteRGBOptions {
31
+ /**
32
+ * The minimum amount of contrast between steps in the palette. Default 1.03.
33
+ * Recommended increments by hundredths.
34
+ */
35
+ stepContrast: number;
36
+ /**
37
+ * Multiplier for increasing step contrast as the swatches darken. Default 0.03.
38
+ * Recommended increments by hundredths.
39
+ */
40
+ stepContrastRamp: number;
41
+ /**
42
+ * Whether to keep the exact source color in the target palette. Default false.
43
+ * Only recommended when the exact color is required and used in stateful interaction recipes like hover.
44
+ * Note that custom recipes can still access the source color even if it's not in the ramp,
45
+ * but turning this on will potentially increase the contrast between steps toward the ends of the palette.
46
+ */
47
+ preserveSource: boolean;
48
+ }
26
49
  /** @public */
27
50
  export declare type PaletteRGB = Palette<SwatchRGB>;
51
+ /**
52
+ * Creates a PaletteRGB from input R, G, B color values.
53
+ * @param r - Red value represented as a number between 0 and 1.
54
+ * @param g - Green value represented as a number between 0 and 1.
55
+ * @param b - Blue value represented as a number between 0 and 1.
56
+ */
57
+ declare function create(r: number, g: number, b: number): PaletteRGB;
58
+ /**
59
+ * Creates a PaletteRGB from a source SwatchRGB object.
60
+ * @deprecated - Use PaletteRGB.from()
61
+ */
62
+ declare function create(source: SwatchRGB): PaletteRGB;
63
+ /**
64
+ * Creates a PaletteRGB from a source color object.
65
+ * @param source - The source color
66
+ */
67
+ declare function from(source: SwatchRGB, options?: Partial<PaletteRGBOptions>): PaletteRGB;
28
68
  /** @public */
29
69
  export declare const PaletteRGB: Readonly<{
30
- create(source: SwatchRGB): PaletteRGB;
70
+ create: typeof create;
71
+ from: typeof from;
31
72
  }>;
73
+ export {};
@@ -0,0 +1,11 @@
1
+ import { Palette } from '../palette';
2
+ import { InteractiveSwatchSet } from '../recipe';
3
+ import { Swatch } from '../swatch';
4
+ /**
5
+ * @internal
6
+ */
7
+ export declare function contrastAndDeltaSwatchSet(palette: Palette, reference: Swatch, baseContrast: number, restDelta: number, hoverDelta: number, activeDelta: number, focusDelta: number, direction?: -1 | 1 | null): InteractiveSwatchSet;
8
+ /**
9
+ * @internal
10
+ */
11
+ export declare function contrastAndDeltaSwatchSetByLuminance(palette: Palette, reference: Swatch, lightBaseContrast: number, lightRestDelta: number, lightHoverDelta: number, lightActiveDelta: number, lightFocusDelta: number, lightDirection: 1 | -1 | null | undefined, darkBaseContrast: number, darkRestDelta: number, darkHoverDelta: number, darkActiveDelta: number, darkFocusDelta: number, darkDirection?: -1 | 1 | undefined | null): InteractiveSwatchSet;
@@ -0,0 +1,12 @@
1
+ import { Palette } from '../palette';
2
+ import { Swatch } from '../swatch';
3
+ /**
4
+ * Color algorithm using contrast from the reference color.
5
+ *
6
+ * @param palette - The palette to operate on
7
+ * @param reference - The reference color
8
+ * @param contrast - The desired minimum contrast
9
+ *
10
+ * @internal
11
+ */
12
+ export declare function contrastSwatch(palette: Palette, reference: Swatch, contrast: number): Swatch;
@@ -0,0 +1,36 @@
1
+ import { Palette } from '../palette';
2
+ import { InteractiveSwatchSet } from '../recipe';
3
+ import { Swatch } from '../swatch';
4
+ /**
5
+ * Color algorithm using deltas from the reference color for states.
6
+ *
7
+ * @param palette The palette to operate on
8
+ * @param reference The reference color to calculate a color for
9
+ * @param restDelta The rest state offset from reference
10
+ * @param hoverDelta The hover state offset from reference
11
+ * @param activeDelta The active state offset from reference
12
+ * @param focusDelta The focus state offset from reference
13
+ * @param direction The direction the deltas move on the ramp, default goes darker for light references and lighter for dark references
14
+ *
15
+ * @internal
16
+ */
17
+ export declare function deltaSwatchSet(palette: Palette, reference: Swatch, restDelta: number, hoverDelta: number, activeDelta: number, focusDelta: number, direction?: -1 | 1 | null): InteractiveSwatchSet;
18
+ /**
19
+ * Color algorithm using deltas from the reference color for states, allowing different deltas based on a light or dark reference color.
20
+ *
21
+ * @param palette The palette to operate on
22
+ * @param reference The reference color to calculate a color for
23
+ * @param lightRestDelta The rest offset for a light reference
24
+ * @param lightHoverDelta The hover offset for a light reference
25
+ * @param lightActiveDelta The rest offset for a light reference
26
+ * @param lightFocusDelta The hover offset for a light reference
27
+ * @param lightDirection The direction the deltas move on the ramp, default goes darker for light references
28
+ * @param darkRestDelta The rest offset for a dark reference
29
+ * @param darkHoverDelta The hover offset for a dark reference
30
+ * @param darkActiveDelta The rest offset for a dark reference
31
+ * @param darkFocusDelta The hover offset for a dark reference
32
+ * @param darkDirection The direction the deltas move on the ramp, default goes lighter for dark references
33
+ *
34
+ * @internal
35
+ */
36
+ export declare function deltaSwatchSetByLuminance(palette: Palette, reference: Swatch, lightRestDelta: number, lightHoverDelta: number, lightActiveDelta: number, lightFocusDelta: number, lightDirection: 1 | -1 | null | undefined, darkRestDelta: number, darkHoverDelta: number, darkActiveDelta: number, darkFocusDelta: number, darkDirection?: -1 | 1 | undefined | null): InteractiveSwatchSet;
@@ -1,11 +1,12 @@
1
1
  import { Swatch } from '../swatch';
2
2
  import { Palette } from '../palette';
3
3
  /**
4
- * The neutralDivider color recipe
4
+ * Color algorithm using a delta from the reference color.
5
+ *
5
6
  * @param palette - The palette to operate on
6
7
  * @param reference - The reference color
7
8
  * @param delta - The offset from the reference
8
9
  *
9
10
  * @internal
10
11
  */
11
- export declare function neutralDivider(palette: Palette, reference: Swatch, delta: number): Swatch;
12
+ export declare function deltaSwatch(palette: Palette, reference: Swatch, delta: number): Swatch;
@@ -3,8 +3,8 @@ import { Swatch } from '../swatch';
3
3
  /**
4
4
  * @internal
5
5
  */
6
- export declare function focusStrokeOuter(palette: Palette, reference: Swatch): Swatch;
6
+ export declare function focusStrokeOuter(palette: Palette, reference: Swatch): import("../swatch").SwatchRGB;
7
7
  /**
8
8
  * @internal
9
9
  */
10
- export declare function focusStrokeInner(palette: Palette, reference: Swatch, focusColor: Swatch): Swatch;
10
+ export declare function focusStrokeInner(palette: Palette, reference: Swatch, focusColor: Swatch): import("../swatch").SwatchRGB;
@@ -3,3 +3,9 @@ import { Swatch } from '../swatch';
3
3
  * @internal
4
4
  */
5
5
  export declare function foregroundOnAccent(reference: Swatch, contrastTarget: number): import("../swatch").SwatchRGB;
6
+ export declare function foregroundOnAccentSet(restFill: Swatch, hoverFill: Swatch, activeFill: Swatch, focusFill: Swatch, contrastTarget: number): {
7
+ rest: import("../swatch").SwatchRGB;
8
+ hover: import("../swatch").SwatchRGB;
9
+ active: import("../swatch").SwatchRGB;
10
+ focus: import("../swatch").SwatchRGB;
11
+ };
@@ -0,0 +1,7 @@
1
+ import { Palette } from '../palette';
2
+ import { InteractiveSwatchSet } from '../recipe';
3
+ import { Swatch } from '../swatch';
4
+ /**
5
+ * @internal
6
+ */
7
+ export declare function gradientShadowStroke(palette: Palette, reference: Swatch, restDelta: number, hoverDelta: number, activeDelta: number, focusDelta: number, shadowDelta: number, direction?: -1 | 1, shadowPercentage?: number, blendWithReference?: boolean): InteractiveSwatchSet;
@@ -0,0 +1,36 @@
1
+ import { SwatchRGB } from '../swatch';
2
+ /**
3
+ * An implementation of {@link Swatch} that produces a gradient.
4
+ * This assumes a subtle gradient such that `relativeLuminance` is still meaningful,
5
+ * either with consistent luminance across the steps or a small edge of larger change.
6
+ * @internal
7
+ */
8
+ export declare class GradientSwatchRGB implements SwatchRGB {
9
+ private color;
10
+ private cssGradient;
11
+ readonly relativeLuminance: number;
12
+ readonly r: number;
13
+ readonly g: number;
14
+ readonly b: number;
15
+ /**
16
+ *
17
+ * @param red Red channel expressed as a number between 0 and 1
18
+ * @param green Green channel expressed as a number between 0 and 1
19
+ * @param blue Blue channel expressed as a number between 0 and 1
20
+ */
21
+ constructor(red: number, green: number, blue: number, cssGradient: string);
22
+ toColorString: () => string;
23
+ contrast: any;
24
+ createCSS: () => string;
25
+ /**
26
+ * Creates a GradientSwatch from a base color and gradient definition
27
+ * @param obj The base color object, used for relative luminance
28
+ * @param cssGradient The actual gradient to be rendered
29
+ * @returns New GradientSwatch object
30
+ */
31
+ static fromObject(obj: {
32
+ r: number;
33
+ g: number;
34
+ b: number;
35
+ }, cssGradient: string): GradientSwatchRGB;
36
+ }
@@ -1,5 +1,9 @@
1
1
  import { Palette } from '../palette';
2
2
  import { Swatch } from '../swatch';
3
+ /**
4
+ * @internal
5
+ */
6
+ export declare function neutralLayer1Index(palette: Palette, baseLayerLuminance: number): number;
3
7
  /**
4
8
  * @internal
5
9
  */
@@ -3,8 +3,4 @@ import { Swatch } from '../swatch';
3
3
  /**
4
4
  * @internal
5
5
  */
6
- export declare function neutralLayer2Index(palette: Palette, luminance: number, layerDelta: number, fillRestDelta: number, fillHoverDelta: number, fillActiveDelta: number): number;
7
- /**
8
- * @internal
9
- */
10
- export declare function neutralLayer2(palette: Palette, luminance: number, layerDelta: number, fillRestDelta: number, fillHoverDelta: number, fillActiveDelta: number): Swatch;
6
+ export declare function neutralLayer2(palette: Palette, baseLayerLuminance: number, layerDelta: number): Swatch;
@@ -3,4 +3,4 @@ import { Swatch } from '../swatch';
3
3
  /**
4
4
  * @internal
5
5
  */
6
- export declare function neutralLayer3(palette: Palette, luminance: number, layerDelta: number, fillRestDelta: number, fillHoverDelta: number, fillActiveDelta: number): Swatch;
6
+ export declare function neutralLayer3(palette: Palette, baseLayerLuminance: number, layerDelta: number): Swatch;
@@ -3,4 +3,4 @@ import { Swatch } from '../swatch';
3
3
  /**
4
4
  * @internal
5
5
  */
6
- export declare function neutralLayer4(palette: Palette, luminance: number, layerDelta: number, fillRestDelta: number, fillHoverDelta: number, fillActiveDelta: number): Swatch;
6
+ export declare function neutralLayer4(palette: Palette, baseLayerLuminance: number, layerDelta: number): Swatch;
@@ -3,4 +3,4 @@ import { Swatch } from '../swatch';
3
3
  /**
4
4
  * @internal
5
5
  */
6
- export declare function neutralLayerFloating(palette: Palette, relativeLuminance: number, layerDelta: number): Swatch;
6
+ export declare function neutralLayerFloating(palette: Palette, baseLayerLuminance: number, layerDelta: number): Swatch;
@@ -0,0 +1,7 @@
1
+ import { Palette } from '../palette';
2
+ import { InteractiveSwatchSet } from '../recipe';
3
+ import { Swatch } from '../swatch';
4
+ /**
5
+ * @internal
6
+ */
7
+ export declare function underlineStroke(palette: Palette, reference: Swatch, restDelta: number, hoverDelta: number, activeDelta: number, focusDelta: number, shadowDelta: number, width: string): InteractiveSwatchSet;
@@ -22,3 +22,10 @@ export declare const SwatchRGB: Readonly<{
22
22
  b: number;
23
23
  }): SwatchRGB;
24
24
  }>;
25
+ /**
26
+ * Runtime test for an objects conformance with the SwatchRGB interface.
27
+ * @internal
28
+ */
29
+ export declare function isSwatchRGB(value: {
30
+ [key: string]: any;
31
+ }): value is SwatchRGB;
@@ -6,6 +6,6 @@ export declare function baseLayerLuminanceSwatch(luminance: number): Swatch;
6
6
  * @public
7
7
  */
8
8
  export declare enum StandardLuminance {
9
- LightMode = 1,
10
- DarkMode = 0.23
9
+ LightMode = 0.98,
10
+ DarkMode = 0.15
11
11
  }
@@ -1,10 +1,9 @@
1
1
  import { ComboboxOptions, Combobox as FoundationCombobox } from '@microsoft/fast-foundation';
2
- import { SelectAppearance } from '../select';
3
2
  /**
4
3
  * Combobox appearances
5
4
  * @public
6
5
  */
7
- export declare type ComboboxAppearance = SelectAppearance;
6
+ export declare type ComboboxAppearance = 'filled' | 'outline';
8
7
  /**
9
8
  * The Fluent combobox class
10
9
  * @internal
@@ -9,6 +9,7 @@ import { fluentBadge } from './badge/index';
9
9
  import { fluentBreadcrumb } from './breadcrumb/index';
10
10
  import { fluentBreadcrumbItem } from './breadcrumb-item/index';
11
11
  import { fluentButton } from './button/index';
12
+ import { fluentCalendar } from './calendar/index';
12
13
  import { fluentCard } from './card/index';
13
14
  import { fluentCheckbox } from './checkbox/index';
14
15
  import { fluentCombobox } from './combobox/index';
@@ -38,7 +39,7 @@ import { fluentToolbar } from './toolbar/index';
38
39
  import { fluentTooltip } from './tooltip/index';
39
40
  import { fluentTreeView } from './tree-view/index';
40
41
  import { fluentTreeItem } from './tree-item/index';
41
- export { fluentAccordion, fluentAccordionItem, fluentAnchor, fluentAnchoredRegion, fluentBadge, fluentBreadcrumb, fluentBreadcrumbItem, fluentButton, fluentCard, fluentCheckbox, fluentCombobox, fluentDataGrid, fluentDataGridCell, fluentDataGridRow, fluentDesignSystemProvider, fluentDialog, fluentDivider, fluentFlipper, fluentHorizontalScroll, fluentListbox, fluentOption, fluentMenu, fluentMenuItem, fluentNumberField, fluentProgress, fluentProgressRing, fluentRadio, fluentRadioGroup, fluentSelect, fluentSkeleton, fluentSlider, fluentSliderLabel, fluentSwitch, fluentTabs, fluentTab, fluentTabPanel, fluentTextArea, fluentTextField, fluentToolbar, fluentTooltip, fluentTreeView, fluentTreeItem, };
42
+ export { fluentAccordion, fluentAccordionItem, fluentAnchor, fluentAnchoredRegion, fluentBadge, fluentBreadcrumb, fluentBreadcrumbItem, fluentButton, fluentCard, fluentCalendar, fluentCheckbox, fluentCombobox, fluentDataGrid, fluentDataGridCell, fluentDataGridRow, fluentDesignSystemProvider, fluentDialog, fluentDivider, fluentFlipper, fluentHorizontalScroll, fluentListbox, fluentOption, fluentMenu, fluentMenuItem, fluentNumberField, fluentProgress, fluentProgressRing, fluentRadio, fluentRadioGroup, fluentSelect, fluentSkeleton, fluentSlider, fluentSliderLabel, fluentSwitch, fluentTabs, fluentTab, fluentTabPanel, fluentTextArea, fluentTextField, fluentToolbar, fluentTooltip, fluentTreeView, fluentTreeItem, };
42
43
  /**
43
44
  * All Fluent UI Web Components
44
45
  * @public
@@ -52,6 +53,7 @@ export declare const allComponents: {
52
53
  fluentBreadcrumb: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").FoundationElementDefinition> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").FoundationElementDefinition, typeof import("@microsoft/fast-foundation").Breadcrumb>;
53
54
  fluentBreadcrumbItem: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").BreadcrumbItemOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").BreadcrumbItemOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
54
55
  fluentButton: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").FoundationElementDefinition> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").FoundationElementDefinition, typeof import("./button").Button>;
56
+ fluentCalendar: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").CalendarOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").CalendarOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
55
57
  fluentCard: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").FoundationElementDefinition> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").FoundationElementDefinition, typeof import("./card").Card>;
56
58
  fluentCheckbox: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").CheckboxOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").CheckboxOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
57
59
  fluentCombobox: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").ComboboxOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").ComboboxOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
@@ -73,7 +75,7 @@ export declare const allComponents: {
73
75
  fluentHorizontalScroll: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").HorizontalScrollOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").HorizontalScrollOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
74
76
  fluentListbox: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").FoundationElementDefinition> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").FoundationElementDefinition, typeof import("@microsoft/fast-foundation").Listbox>;
75
77
  fluentOption: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").FoundationElementDefinition> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").FoundationElementDefinition, typeof import("@microsoft/fast-foundation").ListboxOption>;
76
- fluentMenu: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").FoundationElementDefinition> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").FoundationElementDefinition, typeof import("@microsoft/fast-foundation").Menu>;
78
+ fluentMenu: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").FoundationElementDefinition> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").FoundationElementDefinition, typeof import("./menu").Menu>;
77
79
  fluentMenuItem: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").MenuItemOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").MenuItemOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
78
80
  fluentNumberField: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").NumberFieldOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").NumberFieldOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
79
81
  fluentProgress: (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<import("@microsoft/fast-foundation").ProgressOptions> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<import("@microsoft/fast-foundation").ProgressOptions, import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>;
@@ -1,3 +1,3 @@
1
1
  import { ElementStyles } from '@microsoft/fast-element';
2
2
  import { ElementDefinitionContext, FoundationElementDefinition } from '@microsoft/fast-foundation';
3
- export declare const dataGridRowStyles: (context: ElementDefinitionContext, defintion: FoundationElementDefinition) => ElementStyles;
3
+ export declare const dataGridRowStyles: (context: ElementDefinitionContext, definition: FoundationElementDefinition) => ElementStyles;
@@ -24,7 +24,7 @@ export declare const fluentDataGridRow: (overrideDefinition?: import("@microsoft
24
24
  * Styles for DataGrid row
25
25
  * @public
26
26
  */
27
- export declare const dataGridRowStyles: (context: import("@microsoft/fast-foundation").ElementDefinitionContext, defintion: import("@microsoft/fast-foundation").FoundationElementDefinition) => import("@microsoft/fast-element").ElementStyles;
27
+ export declare const dataGridRowStyles: (context: import("@microsoft/fast-foundation").ElementDefinitionContext, definition: import("@microsoft/fast-foundation").FoundationElementDefinition) => import("@microsoft/fast-element").ElementStyles;
28
28
  /**
29
29
  * The Fluent Data Grid Element.
30
30
  *