@stackoverflow/stacks 2.5.4 → 2.5.5

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 (101) hide show
  1. package/LICENSE.MD +9 -9
  2. package/README.md +180 -180
  3. package/dist/css/stacks.css +102 -122
  4. package/dist/css/stacks.min.css +1 -1
  5. package/lib/atomic/border.less +139 -139
  6. package/lib/atomic/color.less +36 -36
  7. package/lib/atomic/flex.less +426 -426
  8. package/lib/atomic/gap.less +44 -44
  9. package/lib/atomic/grid.less +139 -139
  10. package/lib/atomic/misc.less +374 -374
  11. package/lib/atomic/spacing.less +98 -98
  12. package/lib/atomic/typography.less +264 -264
  13. package/lib/atomic/width-height.less +194 -194
  14. package/lib/base/body.less +44 -44
  15. package/lib/base/configuration-static.less +61 -61
  16. package/lib/base/fieldset.less +5 -5
  17. package/lib/base/icon.less +11 -11
  18. package/lib/base/internal.less +220 -220
  19. package/lib/base/reset-meyer.less +64 -64
  20. package/lib/base/reset-normalize.less +449 -449
  21. package/lib/base/reset.less +20 -20
  22. package/lib/components/activity-indicator/activity-indicator.less +53 -53
  23. package/lib/components/anchor/anchor.less +78 -68
  24. package/lib/components/avatar/avatar.less +108 -108
  25. package/lib/components/award-bling/award-bling.less +31 -31
  26. package/lib/components/badge/badge.less +258 -258
  27. package/lib/components/banner/banner.less +44 -44
  28. package/lib/components/banner/banner.ts +149 -149
  29. package/lib/components/block-link/block-link.less +82 -82
  30. package/lib/components/breadcrumbs/breadcrumbs.less +41 -41
  31. package/lib/components/button/button.less +473 -473
  32. package/lib/components/button-group/button-group.less +82 -82
  33. package/lib/components/card/card.less +37 -37
  34. package/lib/components/check-control/check-control.less +17 -17
  35. package/lib/components/check-group/check-group.less +19 -19
  36. package/lib/components/checkbox_radio/checkbox_radio.less +159 -159
  37. package/lib/components/code-block/code-block.fixtures.ts +88 -88
  38. package/lib/components/code-block/code-block.less +116 -116
  39. package/lib/components/description/description.less +9 -9
  40. package/lib/components/empty-state/empty-state.less +16 -16
  41. package/lib/components/expandable/expandable.less +118 -118
  42. package/lib/components/expandable/expandable.ts +238 -238
  43. package/lib/components/input-fill/input-fill.less +35 -35
  44. package/lib/components/input-icon/input-icon.less +45 -45
  45. package/lib/components/input-message/input-message.less +49 -49
  46. package/lib/components/input_textarea/input_textarea.less +150 -150
  47. package/lib/components/label/label.less +110 -110
  48. package/lib/components/link/link.less +135 -120
  49. package/lib/components/link-preview/link-preview.less +148 -148
  50. package/lib/components/menu/menu.less +41 -41
  51. package/lib/components/modal/modal.less +118 -118
  52. package/lib/components/modal/modal.ts +383 -383
  53. package/lib/components/navigation/navigation.less +136 -136
  54. package/lib/components/navigation/navigation.ts +128 -128
  55. package/lib/components/notice/notice.less +195 -195
  56. package/lib/components/page-title/page-title.less +51 -51
  57. package/lib/components/pagination/pagination.less +65 -65
  58. package/lib/components/popover/popover.less +159 -159
  59. package/lib/components/popover/popover.ts +651 -651
  60. package/lib/components/popover/tooltip.ts +343 -343
  61. package/lib/components/post-summary/post-summary.less +457 -447
  62. package/lib/components/progress-bar/progress-bar.less +291 -291
  63. package/lib/components/prose/prose.less +452 -452
  64. package/lib/components/select/select.less +138 -138
  65. package/lib/components/sidebar-widget/sidebar-widget.less +257 -257
  66. package/lib/components/spinner/spinner.less +103 -103
  67. package/lib/components/table/table.less +307 -307
  68. package/lib/components/table/table.ts +296 -296
  69. package/lib/components/table-container/table-container.less +4 -4
  70. package/lib/components/tag/tag.less +186 -186
  71. package/lib/components/toast/toast.less +35 -35
  72. package/lib/components/toast/toast.ts +357 -357
  73. package/lib/components/toggle-switch/toggle-switch.less +104 -104
  74. package/lib/components/topbar/topbar.less +553 -553
  75. package/lib/components/uploader/uploader.less +205 -205
  76. package/lib/components/uploader/uploader.ts +207 -207
  77. package/lib/components/user-card/user-card.less +129 -129
  78. package/lib/controllers.ts +33 -33
  79. package/lib/exports/color-mixins.less +283 -283
  80. package/lib/exports/color-sets.less +711 -711
  81. package/lib/exports/color.less +65 -65
  82. package/lib/exports/constants-helpers.less +108 -108
  83. package/lib/exports/constants-type.less +155 -155
  84. package/lib/exports/exports.less +15 -15
  85. package/lib/exports/mixins.less +333 -333
  86. package/lib/exports/spacing-mixins.less +67 -67
  87. package/lib/index.ts +32 -32
  88. package/lib/input-utils.less +41 -41
  89. package/lib/stacks-dynamic.less +24 -24
  90. package/lib/stacks-static.less +93 -93
  91. package/lib/stacks.less +13 -13
  92. package/lib/stacks.ts +113 -113
  93. package/lib/test/a11y-test-utils.ts +94 -94
  94. package/lib/test/assertions.ts +36 -36
  95. package/lib/test/less-test-utils.ts +28 -28
  96. package/lib/test/open-wc-testing-patch.d.ts +26 -26
  97. package/lib/test/test-utils.ts +364 -364
  98. package/lib/test/visual-test-utils.ts +58 -58
  99. package/lib/tsconfig.build.json +4 -4
  100. package/lib/tsconfig.json +17 -17
  101. package/package.json +115 -115
@@ -1,136 +1,136 @@
1
- .s-navigation {
2
- --_na-fd: row;
3
- --_na-fw: wrap;
4
- --_na-p: var(--su2) 0;
5
- --_na-gap: var(--su4);
6
- --_na-item-bg: none;
7
- --_na-item-fc: var(--black-500);
8
- --_na-item-fs: unset;
9
- --_na-item-p: var(--su6) var(--su12);
10
- --_na-item-py: var(--su12);
11
- --_na-item-ws: nowrap;
12
- --_na-item-bg-hover: var(--black-200);
13
- --_na-item-fc-hover: var(--_na-item-fc);
14
- --_na-item-selected-bg: var(--theme-primary);
15
- --_na-item-selected-fc: var(--white);
16
- --_na-item-selected-bg-hover: var(--theme-primary-500);
17
- --_na-title-mt: var(--su16);
18
-
19
- // CONTEXTUAL STYLES
20
- .highcontrast-mode({
21
- --_na-item-bg-hover: var(--black-500);
22
- --_na-item-fc-hover: var(--black-225);
23
- });
24
-
25
- // MODIFIERS
26
- &&__scroll {
27
- --_na-fw: nowrap;
28
-
29
- overflow-x: auto;
30
- @scrollbar-styles();
31
- }
32
-
33
- &&__sm {
34
- --_na-item-fs: var(--fs-caption);
35
- --_na-item-p: var(--su4) var(--su12);
36
- }
37
-
38
- &&__vertical {
39
- --_na-fd: column;
40
- --_na-gap: 0;
41
- --_na-p: 0;
42
- --_na-item-ws: normal;
43
- }
44
-
45
- // VARIANTS
46
- &&__muted {
47
- --_na-item-selected-bg: var(--black-150);
48
- --_na-item-selected-fc: var(--black-600);
49
- --_na-item-selected-bg-hover: var(--_na-item-bg);
50
-
51
- .highcontrast-mode({
52
- --_na-item-selected-bg: var(--black-600);
53
- --_na-item-selected-fc: var(--black-150);
54
- --_na-item-selected-bg-hover: var(--black-600);
55
- });
56
- }
57
-
58
- // CHILD ELEMENTS
59
- & &--item {
60
- &.is-selected {
61
- --_na-item-bg: var(--_na-item-selected-bg);
62
- --_na-item-fc: var(--_na-item-selected-fc);
63
- --_na-item-fc-hover: var(--_na-item-fc);
64
- --_na-item-bg-hover: var(--_na-item-selected-bg-hover);
65
-
66
- .highcontrast-mode({
67
- text-decoration: none;
68
- });
69
- }
70
-
71
- // TODO: include child component class (without variant) on selector
72
- &__dropdown {
73
- &:after {
74
- border-style: solid;
75
- border-width: var(--su-static4) var(--su-static4) 0 var(--su-static4);
76
- border-color: currentColor transparent;
77
- content: "";
78
- pointer-events: none;
79
- position: absolute;
80
- right: 0.9em;
81
- top: calc(50% - var(--su-static2)); // 50% - 2px
82
- z-index: var(--zi-active);
83
- }
84
-
85
- padding-right: 2em;
86
- }
87
-
88
- &:hover,
89
- &:active {
90
- background-color: var(--_na-item-bg-hover);
91
- color: var(--_na-item-fc-hover);
92
- }
93
-
94
- &:focus-visible {
95
- .focus-styles(true);
96
- }
97
-
98
- background-color: var(--_na-item-bg);
99
- color: var(--_na-item-fc);
100
- font: unset; // Needs to come before font-size for cascade
101
- font-size: var(--_na-item-fs);
102
- padding: var(--_na-item-p);
103
- white-space: var(--_na-item-ws);
104
-
105
- align-items: center;
106
- border: none; // Reset some things for when the navigation item is also a button
107
- border-radius: 1000px;
108
- box-shadow: none;
109
- cursor: pointer;
110
- display: flex;
111
- position: relative;
112
- user-select: auto;
113
- }
114
-
115
- & &--title {
116
- &:first-child {
117
- --_na-title-mt: 0;
118
- }
119
-
120
- margin-top: var(--_na-title-mt);
121
-
122
- font-size: var(--fs-fine);
123
- font-weight: bold;
124
- padding: var(--su6) var(--su12);
125
- text-transform: uppercase;
126
- }
127
-
128
- flex-direction: var(--_na-fd);
129
- flex-wrap: var(--_na-fw);
130
- gap: var(--_na-gap);
131
- padding: var(--_na-p);
132
-
133
- display: flex;
134
- list-style: none; // If the s-navigation is a list, let's reset all the properties
135
- margin: 0;
136
- }
1
+ .s-navigation {
2
+ --_na-fd: row;
3
+ --_na-fw: wrap;
4
+ --_na-p: var(--su2) 0;
5
+ --_na-gap: var(--su4);
6
+ --_na-item-bg: none;
7
+ --_na-item-fc: var(--black-500);
8
+ --_na-item-fs: unset;
9
+ --_na-item-p: var(--su6) var(--su12);
10
+ --_na-item-py: var(--su12);
11
+ --_na-item-ws: nowrap;
12
+ --_na-item-bg-hover: var(--black-200);
13
+ --_na-item-fc-hover: var(--_na-item-fc);
14
+ --_na-item-selected-bg: var(--theme-primary);
15
+ --_na-item-selected-fc: var(--white);
16
+ --_na-item-selected-bg-hover: var(--theme-primary-500);
17
+ --_na-title-mt: var(--su16);
18
+
19
+ // CONTEXTUAL STYLES
20
+ .highcontrast-mode({
21
+ --_na-item-bg-hover: var(--black-500);
22
+ --_na-item-fc-hover: var(--black-225);
23
+ });
24
+
25
+ // MODIFIERS
26
+ &&__scroll {
27
+ --_na-fw: nowrap;
28
+
29
+ overflow-x: auto;
30
+ @scrollbar-styles();
31
+ }
32
+
33
+ &&__sm {
34
+ --_na-item-fs: var(--fs-caption);
35
+ --_na-item-p: var(--su4) var(--su12);
36
+ }
37
+
38
+ &&__vertical {
39
+ --_na-fd: column;
40
+ --_na-gap: 0;
41
+ --_na-p: 0;
42
+ --_na-item-ws: normal;
43
+ }
44
+
45
+ // VARIANTS
46
+ &&__muted {
47
+ --_na-item-selected-bg: var(--black-150);
48
+ --_na-item-selected-fc: var(--black-600);
49
+ --_na-item-selected-bg-hover: var(--_na-item-bg);
50
+
51
+ .highcontrast-mode({
52
+ --_na-item-selected-bg: var(--black-600);
53
+ --_na-item-selected-fc: var(--black-150);
54
+ --_na-item-selected-bg-hover: var(--black-600);
55
+ });
56
+ }
57
+
58
+ // CHILD ELEMENTS
59
+ & &--item {
60
+ &.is-selected {
61
+ --_na-item-bg: var(--_na-item-selected-bg);
62
+ --_na-item-fc: var(--_na-item-selected-fc);
63
+ --_na-item-fc-hover: var(--_na-item-fc);
64
+ --_na-item-bg-hover: var(--_na-item-selected-bg-hover);
65
+
66
+ .highcontrast-mode({
67
+ text-decoration: none;
68
+ });
69
+ }
70
+
71
+ // TODO: include child component class (without variant) on selector
72
+ &__dropdown {
73
+ &:after {
74
+ border-style: solid;
75
+ border-width: var(--su-static4) var(--su-static4) 0 var(--su-static4);
76
+ border-color: currentColor transparent;
77
+ content: "";
78
+ pointer-events: none;
79
+ position: absolute;
80
+ right: 0.9em;
81
+ top: calc(50% - var(--su-static2)); // 50% - 2px
82
+ z-index: var(--zi-active);
83
+ }
84
+
85
+ padding-right: 2em;
86
+ }
87
+
88
+ &:hover,
89
+ &:active {
90
+ background-color: var(--_na-item-bg-hover);
91
+ color: var(--_na-item-fc-hover);
92
+ }
93
+
94
+ &:focus-visible {
95
+ .focus-styles(true);
96
+ }
97
+
98
+ background-color: var(--_na-item-bg);
99
+ color: var(--_na-item-fc);
100
+ font: unset; // Needs to come before font-size for cascade
101
+ font-size: var(--_na-item-fs);
102
+ padding: var(--_na-item-p);
103
+ white-space: var(--_na-item-ws);
104
+
105
+ align-items: center;
106
+ border: none; // Reset some things for when the navigation item is also a button
107
+ border-radius: 1000px;
108
+ box-shadow: none;
109
+ cursor: pointer;
110
+ display: flex;
111
+ position: relative;
112
+ user-select: auto;
113
+ }
114
+
115
+ & &--title {
116
+ &:first-child {
117
+ --_na-title-mt: 0;
118
+ }
119
+
120
+ margin-top: var(--_na-title-mt);
121
+
122
+ font-size: var(--fs-fine);
123
+ font-weight: bold;
124
+ padding: var(--su6) var(--su12);
125
+ text-transform: uppercase;
126
+ }
127
+
128
+ flex-direction: var(--_na-fd);
129
+ flex-wrap: var(--_na-fw);
130
+ gap: var(--_na-gap);
131
+ padding: var(--_na-p);
132
+
133
+ display: flex;
134
+ list-style: none; // If the s-navigation is a list, let's reset all the properties
135
+ margin: 0;
136
+ }
@@ -1,128 +1,128 @@
1
- import * as Stacks from "../../stacks";
2
-
3
- export class TabListController extends Stacks.StacksController {
4
- private boundSelectTab!: (event: MouseEvent) => void;
5
- private boundHandleKeydown!: (event: KeyboardEvent) => void;
6
-
7
- connect() {
8
- super.connect();
9
-
10
- this.boundSelectTab = this.selectTab.bind(this);
11
- this.boundHandleKeydown = this.handleKeydown.bind(this);
12
-
13
- for (const tab of this.tabTargets) {
14
- tab.addEventListener("click", this.boundSelectTab);
15
- tab.addEventListener("keydown", this.boundHandleKeydown);
16
- }
17
- }
18
-
19
- disconnect() {
20
- super.disconnect();
21
-
22
- for (const tab of this.tabTargets) {
23
- tab.removeEventListener("click", this.boundSelectTab);
24
- tab.removeEventListener("keydown", this.boundHandleKeydown);
25
- }
26
- }
27
-
28
- /**
29
- * Gets all tabs within the controller.
30
- */
31
- get tabTargets(): HTMLElement[] {
32
- return Array.from(this.element.querySelectorAll("[role=tab]"));
33
- }
34
-
35
- /**
36
- * Handles click events on individual tabs, causing them to be selected.
37
- */
38
- selectTab(event: MouseEvent) {
39
- this.switchToTab(<HTMLElement>event.currentTarget);
40
- }
41
-
42
- /**
43
- * Handles left and right arrow keydown events on individual tabs,
44
- * selecting the adjacent tab corresponding to the event.
45
- */
46
- handleKeydown(event: KeyboardEvent) {
47
- let tabElement = <HTMLElement>event.currentTarget;
48
-
49
- const tabs = this.tabTargets;
50
- let tabIndex = tabs.indexOf(tabElement);
51
-
52
- if (event.key === "ArrowRight") {
53
- tabIndex++;
54
- } else if (event.key === "ArrowLeft") {
55
- tabIndex--;
56
- } else {
57
- return;
58
- }
59
-
60
- // Use circular navigation when users go past the first or last tab.
61
- if (tabIndex < 0) {
62
- tabIndex = tabs.length - 1;
63
- }
64
- if (tabIndex >= tabs.length) {
65
- tabIndex = 0;
66
- }
67
-
68
- tabElement = tabs[tabIndex];
69
- this.switchToTab(tabElement);
70
-
71
- // Focus the newly selected tab so it can receive keyboard events.
72
- this.selectedTab?.focus();
73
- }
74
-
75
- /**
76
- * Attempts to switch to a new tab, doing nothing if the tab is already selected or
77
- * the s-navigation-tablist:select event is prevented.
78
- */
79
- private switchToTab(newTab: HTMLElement) {
80
- const oldTab = this.selectedTab;
81
- if (oldTab === newTab) {
82
- return;
83
- }
84
-
85
- if (this.triggerEvent("select", { oldTab, newTab }).defaultPrevented) {
86
- return;
87
- }
88
-
89
- this.selectedTab = newTab;
90
- this.triggerEvent("selected", { oldTab, newTab });
91
- }
92
-
93
- /**
94
- * Returns the currently selected tab or null if no tabs are selected.
95
- */
96
- public get selectedTab(): HTMLElement | null {
97
- return (
98
- this.tabTargets.find(
99
- (e) => e.getAttribute("aria-selected") === "true"
100
- ) || null
101
- );
102
- }
103
-
104
- /**
105
- * Switches the tablist to the provided tab, updating the tabs and panels
106
- * to reflect the change.
107
- * @param selectedTab The tab to select. If `null` is provided or the element
108
- * is not a valid tab, all tabs will be unselected.
109
- */
110
- public set selectedTab(selectedTab: HTMLElement | null) {
111
- for (const tab of this.tabTargets) {
112
- const panelId = tab.getAttribute("aria-controls");
113
- const panel = panelId ? document.getElementById(panelId) : null;
114
-
115
- if (tab === selectedTab) {
116
- tab.classList.add("is-selected");
117
- tab.setAttribute("aria-selected", "true");
118
- tab.removeAttribute("tabindex");
119
- panel?.classList.remove("d-none");
120
- } else {
121
- tab.classList.remove("is-selected");
122
- tab.setAttribute("aria-selected", "false");
123
- tab.setAttribute("tabindex", "-1");
124
- panel?.classList.add("d-none");
125
- }
126
- }
127
- }
128
- }
1
+ import * as Stacks from "../../stacks";
2
+
3
+ export class TabListController extends Stacks.StacksController {
4
+ private boundSelectTab!: (event: MouseEvent) => void;
5
+ private boundHandleKeydown!: (event: KeyboardEvent) => void;
6
+
7
+ connect() {
8
+ super.connect();
9
+
10
+ this.boundSelectTab = this.selectTab.bind(this);
11
+ this.boundHandleKeydown = this.handleKeydown.bind(this);
12
+
13
+ for (const tab of this.tabTargets) {
14
+ tab.addEventListener("click", this.boundSelectTab);
15
+ tab.addEventListener("keydown", this.boundHandleKeydown);
16
+ }
17
+ }
18
+
19
+ disconnect() {
20
+ super.disconnect();
21
+
22
+ for (const tab of this.tabTargets) {
23
+ tab.removeEventListener("click", this.boundSelectTab);
24
+ tab.removeEventListener("keydown", this.boundHandleKeydown);
25
+ }
26
+ }
27
+
28
+ /**
29
+ * Gets all tabs within the controller.
30
+ */
31
+ get tabTargets(): HTMLElement[] {
32
+ return Array.from(this.element.querySelectorAll("[role=tab]"));
33
+ }
34
+
35
+ /**
36
+ * Handles click events on individual tabs, causing them to be selected.
37
+ */
38
+ selectTab(event: MouseEvent) {
39
+ this.switchToTab(<HTMLElement>event.currentTarget);
40
+ }
41
+
42
+ /**
43
+ * Handles left and right arrow keydown events on individual tabs,
44
+ * selecting the adjacent tab corresponding to the event.
45
+ */
46
+ handleKeydown(event: KeyboardEvent) {
47
+ let tabElement = <HTMLElement>event.currentTarget;
48
+
49
+ const tabs = this.tabTargets;
50
+ let tabIndex = tabs.indexOf(tabElement);
51
+
52
+ if (event.key === "ArrowRight") {
53
+ tabIndex++;
54
+ } else if (event.key === "ArrowLeft") {
55
+ tabIndex--;
56
+ } else {
57
+ return;
58
+ }
59
+
60
+ // Use circular navigation when users go past the first or last tab.
61
+ if (tabIndex < 0) {
62
+ tabIndex = tabs.length - 1;
63
+ }
64
+ if (tabIndex >= tabs.length) {
65
+ tabIndex = 0;
66
+ }
67
+
68
+ tabElement = tabs[tabIndex];
69
+ this.switchToTab(tabElement);
70
+
71
+ // Focus the newly selected tab so it can receive keyboard events.
72
+ this.selectedTab?.focus();
73
+ }
74
+
75
+ /**
76
+ * Attempts to switch to a new tab, doing nothing if the tab is already selected or
77
+ * the s-navigation-tablist:select event is prevented.
78
+ */
79
+ private switchToTab(newTab: HTMLElement) {
80
+ const oldTab = this.selectedTab;
81
+ if (oldTab === newTab) {
82
+ return;
83
+ }
84
+
85
+ if (this.triggerEvent("select", { oldTab, newTab }).defaultPrevented) {
86
+ return;
87
+ }
88
+
89
+ this.selectedTab = newTab;
90
+ this.triggerEvent("selected", { oldTab, newTab });
91
+ }
92
+
93
+ /**
94
+ * Returns the currently selected tab or null if no tabs are selected.
95
+ */
96
+ public get selectedTab(): HTMLElement | null {
97
+ return (
98
+ this.tabTargets.find(
99
+ (e) => e.getAttribute("aria-selected") === "true"
100
+ ) || null
101
+ );
102
+ }
103
+
104
+ /**
105
+ * Switches the tablist to the provided tab, updating the tabs and panels
106
+ * to reflect the change.
107
+ * @param selectedTab The tab to select. If `null` is provided or the element
108
+ * is not a valid tab, all tabs will be unselected.
109
+ */
110
+ public set selectedTab(selectedTab: HTMLElement | null) {
111
+ for (const tab of this.tabTargets) {
112
+ const panelId = tab.getAttribute("aria-controls");
113
+ const panel = panelId ? document.getElementById(panelId) : null;
114
+
115
+ if (tab === selectedTab) {
116
+ tab.classList.add("is-selected");
117
+ tab.setAttribute("aria-selected", "true");
118
+ tab.removeAttribute("tabindex");
119
+ panel?.classList.remove("d-none");
120
+ } else {
121
+ tab.classList.remove("is-selected");
122
+ tab.setAttribute("aria-selected", "false");
123
+ tab.setAttribute("tabindex", "-1");
124
+ panel?.classList.add("d-none");
125
+ }
126
+ }
127
+ }
128
+ }