@stackoverflow/stacks 1.8.0 → 1.9.1

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 (137) hide show
  1. package/README.md +161 -153
  2. package/dist/{controllers/s-banner.d.ts → components/banner/banner.d.ts} +1 -1
  3. package/dist/{controllers/s-expandable-control.d.ts → components/expandable/expandable.d.ts} +1 -1
  4. package/dist/{controllers/s-modal.d.ts → components/modal/modal.d.ts} +1 -1
  5. package/dist/{controllers/s-navigation-tablist.d.ts → components/navigation/navigation.d.ts} +1 -1
  6. package/dist/{controllers/s-popover.d.ts → components/popover/popover.d.ts} +1 -1
  7. package/dist/{controllers/s-tooltip.d.ts → components/popover/tooltip.d.ts} +1 -1
  8. package/dist/components/table/table.d.ts +30 -0
  9. package/dist/{controllers/s-toast.d.ts → components/toast/toast.d.ts} +1 -1
  10. package/dist/{controllers/s-uploader.d.ts → components/uploader/uploader.d.ts} +1 -1
  11. package/dist/controllers.d.ts +9 -0
  12. package/dist/css/stacks.css +2063 -1994
  13. package/dist/css/stacks.min.css +1 -1
  14. package/dist/index.d.ts +1 -1
  15. package/dist/js/stacks.js +1465 -1436
  16. package/dist/js/stacks.min.js +1 -1
  17. package/lib/{css/atomic/borders.less → atomic/border.less} +397 -379
  18. package/lib/{css/atomic/colors.less → atomic/color.less} +210 -210
  19. package/lib/{css/atomic → atomic}/flex.less +426 -426
  20. package/lib/{css/atomic → atomic}/gap.less +44 -44
  21. package/lib/{css/atomic → atomic}/grid.less +139 -139
  22. package/lib/{css/atomic → atomic}/misc.less +343 -343
  23. package/lib/{css/atomic → atomic}/spacing.less +342 -342
  24. package/lib/{css/atomic → atomic}/typography.less +267 -267
  25. package/lib/{css/atomic → atomic}/width-height.less +194 -194
  26. package/lib/{css/base → base}/body.less +44 -44
  27. package/lib/{css/base → base}/configuration-static.less +61 -61
  28. package/lib/{css/base → base}/fieldset.less +5 -5
  29. package/lib/{css/base/icons.less → base/icon.less} +11 -20
  30. package/lib/{css/base/internals.less → base/internal.less} +220 -220
  31. package/lib/{css/base → base}/reset-meyer.less +64 -64
  32. package/lib/{css/base → base}/reset-normalize.less +449 -449
  33. package/lib/{css/base → base}/reset.less +20 -20
  34. package/lib/components/activity-indicator/activity-indicator.a11y.test.ts +21 -0
  35. package/lib/{css/components → components/activity-indicator}/activity-indicator.less +40 -40
  36. package/lib/components/activity-indicator/activity-indicator.visual.test.ts +23 -0
  37. package/lib/{css/components/anchors.less → components/anchor/anchor.less} +61 -61
  38. package/lib/components/avatar/avatar.a11y.test.ts +36 -0
  39. package/lib/{css/components/avatars.less → components/avatar/avatar.less} +108 -108
  40. package/lib/components/avatar/avatar.visual.test.ts +54 -0
  41. package/lib/components/award-bling/award-bling.a11y.test.ts +17 -0
  42. package/lib/{css/components → components/award-bling}/award-bling.less +31 -31
  43. package/lib/components/award-bling/award-bling.visual.test.ts +26 -0
  44. package/lib/{css/components/badges.less → components/badge/badge.less} +251 -251
  45. package/lib/components/banner/banner.a11y.test.ts +37 -0
  46. package/lib/components/banner/banner.less +51 -0
  47. package/lib/{test/s-banner.test.ts → components/banner/banner.test.ts} +73 -73
  48. package/lib/{ts/controllers/s-banner.ts → components/banner/banner.ts} +149 -149
  49. package/lib/components/banner/banner.visual.test.ts +37 -0
  50. package/lib/components/block-link/block-link.a11y.test.ts +68 -0
  51. package/lib/{css/components → components/block-link}/block-link.less +80 -80
  52. package/lib/components/block-link/block-link.visual.test.ts +61 -0
  53. package/lib/components/breadcrumbs/breadcrumbs.a11y.test.ts +37 -0
  54. package/lib/{css/components → components/breadcrumbs}/breadcrumbs.less +41 -41
  55. package/lib/components/breadcrumbs/breadcrumbs.visual.test.ts +37 -0
  56. package/lib/components/button/button.a11y.test.ts +32 -0
  57. package/lib/{css/components/buttons.less → components/button/button.less} +502 -501
  58. package/lib/components/button/button.visual.test.ts +52 -0
  59. package/lib/{css/components/button-groups.less → components/button-group/button-group.less} +83 -83
  60. package/lib/components/card/card.a11y.test.ts +13 -0
  61. package/lib/{css/components/cards.less → components/card/card.less} +29 -29
  62. package/lib/components/card/card.visual.test.ts +54 -0
  63. package/lib/components/check-control/check-control.less +17 -0
  64. package/lib/components/check-group/check-group.less +19 -0
  65. package/lib/{css/components/checkboxes-radios.less → components/checkbox_radio/checkbox_radio.less} +158 -158
  66. package/lib/{css/components/code-blocks.less → components/code-block/code-block.less} +116 -116
  67. package/lib/{css/components → components/description}/description.less +9 -9
  68. package/lib/{css/components/empty-states.less → components/empty-state/empty-state.less} +16 -16
  69. package/lib/{css/components → components/expandable}/expandable.less +118 -115
  70. package/lib/components/expandable/expandable.test.ts +51 -0
  71. package/lib/{ts/controllers/s-expandable-control.ts → components/expandable/expandable.ts} +238 -238
  72. package/lib/components/input-fill/input-fill.less +35 -0
  73. package/lib/components/input-icon/input-icon.less +45 -0
  74. package/lib/components/input-message/input-message.less +48 -0
  75. package/lib/{css/components/inputs.less → components/input_textarea/input_textarea.less} +166 -297
  76. package/lib/{css/components/labels.less → components/label/label.less} +111 -111
  77. package/lib/{css/components → components/link}/link.less +119 -119
  78. package/lib/{css/components/link-previews.less → components/link-preview/link-preview.less} +139 -139
  79. package/lib/{css/components → components/menu}/menu.less +41 -41
  80. package/lib/{css/components/modals.less → components/modal/modal.less} +113 -113
  81. package/lib/{ts/controllers/s-modal.ts → components/modal/modal.ts} +379 -379
  82. package/lib/{css/components → components/navigation}/navigation.less +134 -134
  83. package/lib/{ts/controllers/s-navigation-tablist.ts → components/navigation/navigation.ts} +128 -128
  84. package/lib/{css/components/notices.less → components/notice/notice.less} +203 -292
  85. package/lib/{css/components/page-titles.less → components/page-title/page-title.less} +51 -51
  86. package/lib/{css/components → components/pagination}/pagination.less +52 -52
  87. package/lib/{css/components/popovers.less → components/popover/popover.less} +148 -147
  88. package/lib/{ts/controllers/s-popover.ts → components/popover/popover.ts} +651 -651
  89. package/lib/{test/s-tooltip.test.ts → components/popover/tooltip.test.ts} +62 -62
  90. package/lib/{ts/controllers/s-tooltip.ts → components/popover/tooltip.ts} +343 -343
  91. package/lib/{test/s-tooltip.visual.test.ts → components/popover/tooltip.visual.test.ts} +31 -31
  92. package/lib/{css/components → components/post-summary}/post-summary.less +415 -415
  93. package/lib/{css/components/progress-bars.less → components/progress-bar/progress-bar.less} +291 -291
  94. package/lib/{css/components → components/prose}/prose.less +452 -452
  95. package/lib/{css/components → components/select}/select.less +148 -148
  96. package/lib/{css/components/sidebar-widgets.less → components/sidebar-widget/sidebar-widget.less} +257 -259
  97. package/lib/{css/components → components/spinner}/spinner.less +103 -103
  98. package/lib/{css/components → components/table}/table.less +307 -297
  99. package/lib/components/table/table.test.ts +366 -0
  100. package/lib/{ts/controllers/s-table.ts → components/table/table.ts} +296 -263
  101. package/lib/components/table-container/table-container.less +4 -0
  102. package/lib/{css/components/tags.less → components/tag/tag.less} +213 -213
  103. package/lib/components/toast/toast.less +35 -0
  104. package/lib/{test/s-toast.test.ts → components/toast/toast.test.ts} +63 -63
  105. package/lib/{ts/controllers/s-toast.ts → components/toast/toast.ts} +357 -357
  106. package/lib/components/toast/toast.visual.test.ts +27 -0
  107. package/lib/{css/components/toggle-switches.less → components/toggle-switch/toggle-switch.less} +110 -110
  108. package/lib/{css/components → components/topbar}/topbar.less +436 -435
  109. package/lib/{css/components → components/uploader}/uploader.less +195 -195
  110. package/lib/{ts/controllers/s-uploader.ts → components/uploader/uploader.ts} +205 -205
  111. package/lib/{css/components/user-cards.less → components/user-card/user-card.less} +129 -129
  112. package/lib/controllers.ts +33 -0
  113. package/lib/{css/exports → exports}/constants-colors.less +1112 -1111
  114. package/lib/{css/exports → exports}/constants-helpers.less +108 -108
  115. package/lib/{css/exports → exports}/constants-type.less +153 -153
  116. package/lib/{css/exports → exports}/exports.less +15 -15
  117. package/lib/{css/exports → exports}/mixins.less +299 -299
  118. package/lib/{ts/index.ts → index.ts} +32 -32
  119. package/lib/{css/input-utils.less → input-utils.less} +44 -44
  120. package/lib/{css/stacks-dynamic.less → stacks-dynamic.less} +24 -25
  121. package/lib/stacks-static.less +93 -0
  122. package/lib/{css/stacks.less → stacks.less} +13 -13
  123. package/lib/{ts/stacks.ts → stacks.ts} +113 -113
  124. package/lib/test/open-wc-testing-patch.d.ts +26 -0
  125. package/lib/test/test-utils.ts +466 -0
  126. package/lib/tsconfig.build.json +4 -0
  127. package/lib/tsconfig.json +16 -13
  128. package/package.json +106 -105
  129. package/dist/controllers/index.d.ts +0 -9
  130. package/dist/controllers/s-table.d.ts +0 -8
  131. package/lib/css/stacks-static.less +0 -87
  132. package/lib/test/s-avatar.a11y.test.ts +0 -77
  133. package/lib/test/s-banner.visual.test.ts +0 -61
  134. package/lib/test/s-btn.a11y.test.ts +0 -123
  135. package/lib/test/s-btn.visual.test.ts +0 -16
  136. package/lib/test/s-toast.visual.test.ts +0 -48
  137. package/lib/ts/controllers/index.ts +0 -17
@@ -1,44 +1,44 @@
1
- .input-states(@rules) {
2
- .is-disabled &,
3
- .is-readonly &,
4
- .has-success &,
5
- .has-error &,
6
- .has-warning & {
7
- @rules();
8
- }
9
- };
10
-
11
- .validation-states(@prefix, @error: {}, @success: {}, @warning: {}) {
12
- .has-error &,
13
- .has-success &,
14
- .has-warning & {
15
- --_@{prefix}-bc-focus: ~"var(--_@{prefix}-bc)";
16
- }
17
-
18
- .has-error & {
19
- --_@{prefix}-bc: var(--red-400);
20
- --_@{prefix}-bs-focus: 0 0 0 var(--su-static4) var(--focus-ring-error);
21
- @error();
22
- }
23
-
24
- .has-success & {
25
- --_@{prefix}-bc: var(--green-400);
26
- --_@{prefix}-bs-focus: 0 0 0 var(--su-static4) var(--focus-ring-success);
27
- @success();
28
- }
29
-
30
- .has-warning & {
31
- --_@{prefix}-bc: var(--yellow-600);
32
- --_@{prefix}-bs-focus: 0 0 0 var(--su-static4) var(--focus-ring-warning);
33
- @warning();
34
- }
35
- }
36
-
37
- .is-disabled,
38
- .is-readonly,
39
- .has-success,
40
- .has-error,
41
- .has-warning {
42
- position: relative;
43
- }
44
-
1
+ .input-states(@rules) {
2
+ .is-disabled &,
3
+ .is-readonly &,
4
+ .has-success &,
5
+ .has-error &,
6
+ .has-warning & {
7
+ @rules();
8
+ }
9
+ };
10
+
11
+ .validation-states(@prefix, @error: {}, @success: {}, @warning: {}) {
12
+ .has-error &,
13
+ .has-success &,
14
+ .has-warning & {
15
+ --_@{prefix}-bc-focus: ~"var(--_@{prefix}-bc)";
16
+ }
17
+
18
+ .has-error & {
19
+ --_@{prefix}-bc: var(--red-400);
20
+ --_@{prefix}-bs-focus: 0 0 0 var(--su-static4) var(--focus-ring-error);
21
+ @error();
22
+ }
23
+
24
+ .has-success & {
25
+ --_@{prefix}-bc: var(--green-400);
26
+ --_@{prefix}-bs-focus: 0 0 0 var(--su-static4) var(--focus-ring-success);
27
+ @success();
28
+ }
29
+
30
+ .has-warning & {
31
+ --_@{prefix}-bc: var(--yellow-600);
32
+ --_@{prefix}-bs-focus: 0 0 0 var(--su-static4) var(--focus-ring-warning);
33
+ @warning();
34
+ }
35
+ }
36
+
37
+ .is-disabled,
38
+ .is-readonly,
39
+ .has-success,
40
+ .has-error,
41
+ .has-warning {
42
+ position: relative;
43
+ }
44
+
@@ -1,25 +1,24 @@
1
- //
2
- // STACK OVERFLOW
3
- // DYNAMIC STACK ITEMS
4
- //
5
- // This CSS comes from Stacks, our CSS & Pattern library for rapidly building
6
- // Stack Overflow. For documentation of all these classes and how to contribute,
7
- // visit https://stackoverflow.design/
8
- //
9
- // This is where all the magic happens.
10
- //
11
- //
12
- // ============================================================================
13
- // $ DYNAMIC ELEMENTS
14
- // The following items are elements which we allow communities to modify
15
- // via variables.
16
- // ----------------------------------------------------------------------------
17
- // -- SET BASIC STYLES FOR BODY
18
- @import "base/body.less";
19
-
20
- // -- LESS CONSTANTS AND MIXINS
21
- @import "exports/exports.less";
22
-
23
- // -- CONFIG
24
- @import "base/configuration-static.less";
25
- @import "base/internals.less";
1
+ //
2
+ // STACK OVERFLOW
3
+ // DYNAMIC STACK ITEMS
4
+ //
5
+ // This CSS comes from Stacks, our CSS & Pattern library for rapidly building
6
+ // Stack Overflow. For documentation of all these classes and how to contribute,
7
+ // visit https://stackoverflow.design/
8
+ //
9
+ // This is where all the magic happens.
10
+ //
11
+ //
12
+ // ============================================================================
13
+ // $ DYNAMIC ELEMENTS
14
+ // The following items are elements which we allow communities to modify
15
+ // via variables.
16
+ // ----------------------------------------------------------------------------
17
+ // -- SET BASIC STYLES FOR BODY
18
+ @import "base/body.less";
19
+ // -- LESS CONSTANTS AND MIXINS
20
+ @import "exports/exports.less";
21
+
22
+ // -- CONFIG
23
+ @import "base/configuration-static.less";
24
+ @import "base/internal.less";
@@ -0,0 +1,93 @@
1
+ // stacks-static.less contains styles which we DO NOT allow communities to modify via variables
2
+ // BASE
3
+ @import "base/reset.less";
4
+ @import "base/fieldset.less";
5
+ @import "base/icon.less";
6
+ @import "input-utils.less";
7
+
8
+ // -- COMPONENTS
9
+ @import "components/activity-indicator/activity-indicator.less";
10
+ @import "components/anchor/anchor.less";
11
+ @import "components/avatar/avatar.less";
12
+ @import "components/award-bling/award-bling.less";
13
+ @import "components/badge/badge.less";
14
+ @import "components/banner/banner.less";
15
+ @import "components/block-link/block-link.less";
16
+ @import "components/breadcrumbs/breadcrumbs.less";
17
+ @import "components/button/button.less";
18
+ @import "components/button-group/button-group.less";
19
+ @import "components/card/card.less";
20
+ @import "components/check-control/check-control.less";
21
+ @import "components/check-group/check-group.less";
22
+ @import "components/checkbox_radio/checkbox_radio.less";
23
+ @import "components/code-block/code-block.less";
24
+ @import "components/description/description.less";
25
+ @import "components/empty-state/empty-state.less";
26
+ @import "components/expandable/expandable.less";
27
+ @import "components/input_textarea/input_textarea.less";
28
+ @import "components/input-fill/input-fill.less";
29
+ @import "components/input-icon/input-icon.less";
30
+ @import "components/input-message/input-message.less";
31
+ @import "components/label/label.less";
32
+ @import "components/link/link.less";
33
+ @import "components/link-preview/link-preview.less";
34
+ @import "components/menu/menu.less";
35
+ @import "components/modal/modal.less";
36
+ @import "components/navigation/navigation.less";
37
+ @import "components/notice/notice.less";
38
+ @import "components/page-title/page-title.less";
39
+ @import "components/pagination/pagination.less";
40
+ @import "components/popover/popover.less";
41
+ @import "components/post-summary/post-summary.less";
42
+ @import "components/progress-bar/progress-bar.less";
43
+ @import "components/prose/prose.less";
44
+ @import "components/select/select.less";
45
+ @import "components/sidebar-widget/sidebar-widget.less";
46
+ @import "components/spinner/spinner.less";
47
+ @import "components/table/table.less";
48
+ @import "components/table-container/table-container.less";
49
+ @import "components/tag/tag.less";
50
+ @import "components/toast/toast.less";
51
+ @import "components/toggle-switch/toggle-switch.less";
52
+ @import "components/topbar/topbar.less";
53
+ @import "components/uploader/uploader.less";
54
+ @import "components/user-card/user-card.less";
55
+
56
+ // LESS CONSTANTS AND MIXINS
57
+ @import "exports/exports.less";
58
+
59
+ // -- ATOMIC CLASSES
60
+ @import "atomic/border.less";
61
+ @import "atomic/color.less";
62
+ @import "atomic/flex.less";
63
+ @import "atomic/gap.less";
64
+ @import "atomic/grid.less";
65
+ @import "atomic/spacing.less";
66
+ @import "atomic/typography.less";
67
+ @import "atomic/misc.less";
68
+ @import "atomic/width-height.less";
69
+
70
+ /* stylelint-disable */
71
+ #stacks-internals #screen-lg({
72
+ #stacks-internals-collect-large();
73
+ });
74
+ #stacks-internals #screen-md({
75
+ #stacks-internals-collect-medium();
76
+ });
77
+ #stacks-internals #screen-sm({
78
+ #stacks-internals-collect-small();
79
+ });
80
+
81
+ @media print { // We need printing styles to be last so they can override all other styles.
82
+ .print\:d-block & {
83
+ display: block !important;
84
+ }
85
+ .print\:d-none & {
86
+ display: none !important;
87
+ }
88
+ }
89
+ /* stylelint-enable */
90
+
91
+ // CONFIG
92
+ @import "base/configuration-static.less";
93
+ @import "base/internal.less";
@@ -1,13 +1,13 @@
1
- //
2
- // STACK OVERFLOW
3
- // THE COMPLETE STANDALONE STACKS
4
- //
5
- // This CSS comes from Stacks, our CSS & Pattern library for rapidly building
6
- // Stack Overflow. For documentation of all these classes and how to contribute,
7
- // visit https://stackoverflow.design/
8
- //
9
- // This is where all the magic happens.
10
- //
11
- // ============================================================================
12
- @import "stacks-static.less";
13
- @import "stacks-dynamic.less";
1
+ //
2
+ // STACK OVERFLOW
3
+ // THE COMPLETE STANDALONE STACKS
4
+ //
5
+ // This CSS comes from Stacks, our CSS & Pattern library for rapidly building
6
+ // Stack Overflow. For documentation of all these classes and how to contribute,
7
+ // visit https://stackoverflow.design/
8
+ //
9
+ // This is where all the magic happens.
10
+ //
11
+ // ============================================================================
12
+ @import "stacks-static.less";
13
+ @import "stacks-dynamic.less";
@@ -1,113 +1,113 @@
1
- import * as Stimulus from "@hotwired/stimulus";
2
-
3
- export class StacksApplication extends Stimulus.Application {
4
- static _initializing = true;
5
-
6
- load(...definitions: Stimulus.Definition[]): void;
7
- load(definitions: Stimulus.Definition[]): void;
8
- load(
9
- head: Stimulus.Definition | Stimulus.Definition[],
10
- ...rest: Stimulus.Definition[]
11
- ) {
12
- const definitions = Array.isArray(head) ? head : [head, ...rest];
13
-
14
- for (const definition of definitions) {
15
- const hasPrefix = /^s-/.test(definition.identifier);
16
- if (StacksApplication._initializing && !hasPrefix) {
17
- throw 'Stacks-created Stimulus controller names must start with "s-".';
18
- }
19
- if (!StacksApplication._initializing && hasPrefix) {
20
- throw 'The "s-" prefix on Stimulus controller names is reserved for Stacks-created controllers.';
21
- }
22
- }
23
-
24
- super.load(definitions);
25
- }
26
-
27
- static start(
28
- element?: Element,
29
- schema?: Stimulus.Schema
30
- ): StacksApplication {
31
- const application = new StacksApplication(element, schema);
32
- // eslint-disable-next-line @typescript-eslint/no-floating-promises
33
- application.start();
34
- return application;
35
- }
36
-
37
- static finalize() {
38
- StacksApplication._initializing = false;
39
- }
40
- }
41
-
42
- export const application: Stimulus.Application = StacksApplication.start();
43
-
44
- export class StacksController extends Stimulus.Controller {
45
- protected getElementData(element: Element, key: string) {
46
- return element.getAttribute("data-" + this.identifier + "-" + key);
47
- }
48
- protected setElementData(element: Element, key: string, value: string) {
49
- element.setAttribute("data-" + this.identifier + "-" + key, value);
50
- }
51
- protected removeElementData(element: Element, key: string) {
52
- element.removeAttribute("data-" + this.identifier + "-" + key);
53
- }
54
- protected triggerEvent<T>(
55
- eventName: string,
56
- detail?: T,
57
- optionalElement?: Element
58
- ) {
59
- const namespacedName = this.identifier + ":" + eventName;
60
- let event: CustomEvent<T>;
61
- try {
62
- event = new CustomEvent(namespacedName, {
63
- bubbles: true,
64
- cancelable: true,
65
- detail: detail,
66
- });
67
- } catch (ex) {
68
- // Internet Explorer
69
- // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
70
- event = document.createEvent("CustomEvent");
71
- event.initCustomEvent(namespacedName, true, true, detail);
72
- }
73
- (optionalElement || this.element).dispatchEvent(event);
74
- return event;
75
- }
76
- }
77
-
78
- // ControllerDefinition/createController/addController is here to make
79
- // it easier to consume Stimulus from ES5 files (without classes)
80
- export interface ControllerDefinition {
81
- [name: string]: unknown;
82
- targets?: string[];
83
- }
84
- export function createController(
85
- controllerDefinition: ControllerDefinition
86
- ): typeof StacksController {
87
- // eslint-disable-next-line no-prototype-builtins
88
- const Controller = controllerDefinition.hasOwnProperty("targets")
89
- ? class Controller extends StacksController {
90
- static targets = controllerDefinition.targets ?? [];
91
- }
92
- : class Controller extends StacksController {};
93
-
94
- for (const prop in controllerDefinition) {
95
- const ownPropDescriptor =
96
- // eslint-disable-next-line no-prototype-builtins
97
- controllerDefinition.hasOwnProperty(prop) &&
98
- Object.getOwnPropertyDescriptor(controllerDefinition, prop);
99
- if (prop !== "targets" && ownPropDescriptor) {
100
- Object.defineProperty(
101
- Controller.prototype,
102
- prop,
103
- ownPropDescriptor
104
- );
105
- }
106
- }
107
-
108
- return Controller;
109
- }
110
-
111
- export function addController(name: string, controller: ControllerDefinition) {
112
- application.register(name, createController(controller));
113
- }
1
+ import * as Stimulus from "@hotwired/stimulus";
2
+
3
+ export class StacksApplication extends Stimulus.Application {
4
+ static _initializing = true;
5
+
6
+ load(...definitions: Stimulus.Definition[]): void;
7
+ load(definitions: Stimulus.Definition[]): void;
8
+ load(
9
+ head: Stimulus.Definition | Stimulus.Definition[],
10
+ ...rest: Stimulus.Definition[]
11
+ ) {
12
+ const definitions = Array.isArray(head) ? head : [head, ...rest];
13
+
14
+ for (const definition of definitions) {
15
+ const hasPrefix = /^s-/.test(definition.identifier);
16
+ if (StacksApplication._initializing && !hasPrefix) {
17
+ throw 'Stacks-created Stimulus controller names must start with "s-".';
18
+ }
19
+ if (!StacksApplication._initializing && hasPrefix) {
20
+ throw 'The "s-" prefix on Stimulus controller names is reserved for Stacks-created controllers.';
21
+ }
22
+ }
23
+
24
+ super.load(definitions);
25
+ }
26
+
27
+ static start(
28
+ element?: Element,
29
+ schema?: Stimulus.Schema
30
+ ): StacksApplication {
31
+ const application = new StacksApplication(element, schema);
32
+ // eslint-disable-next-line @typescript-eslint/no-floating-promises
33
+ application.start();
34
+ return application;
35
+ }
36
+
37
+ static finalize() {
38
+ StacksApplication._initializing = false;
39
+ }
40
+ }
41
+
42
+ export const application: Stimulus.Application = StacksApplication.start();
43
+
44
+ export class StacksController extends Stimulus.Controller {
45
+ protected getElementData(element: Element, key: string) {
46
+ return element.getAttribute("data-" + this.identifier + "-" + key);
47
+ }
48
+ protected setElementData(element: Element, key: string, value: string) {
49
+ element.setAttribute("data-" + this.identifier + "-" + key, value);
50
+ }
51
+ protected removeElementData(element: Element, key: string) {
52
+ element.removeAttribute("data-" + this.identifier + "-" + key);
53
+ }
54
+ protected triggerEvent<T>(
55
+ eventName: string,
56
+ detail?: T,
57
+ optionalElement?: Element
58
+ ) {
59
+ const namespacedName = this.identifier + ":" + eventName;
60
+ let event: CustomEvent<T>;
61
+ try {
62
+ event = new CustomEvent(namespacedName, {
63
+ bubbles: true,
64
+ cancelable: true,
65
+ detail: detail,
66
+ });
67
+ } catch (ex) {
68
+ // Internet Explorer
69
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
70
+ event = document.createEvent("CustomEvent");
71
+ event.initCustomEvent(namespacedName, true, true, detail);
72
+ }
73
+ (optionalElement || this.element).dispatchEvent(event);
74
+ return event;
75
+ }
76
+ }
77
+
78
+ // ControllerDefinition/createController/addController is here to make
79
+ // it easier to consume Stimulus from ES5 files (without classes)
80
+ export interface ControllerDefinition {
81
+ [name: string]: unknown;
82
+ targets?: string[];
83
+ }
84
+ export function createController(
85
+ controllerDefinition: ControllerDefinition
86
+ ): typeof StacksController {
87
+ // eslint-disable-next-line no-prototype-builtins
88
+ const Controller = controllerDefinition.hasOwnProperty("targets")
89
+ ? class Controller extends StacksController {
90
+ static targets = controllerDefinition.targets ?? [];
91
+ }
92
+ : class Controller extends StacksController {};
93
+
94
+ for (const prop in controllerDefinition) {
95
+ const ownPropDescriptor =
96
+ // eslint-disable-next-line no-prototype-builtins
97
+ controllerDefinition.hasOwnProperty(prop) &&
98
+ Object.getOwnPropertyDescriptor(controllerDefinition, prop);
99
+ if (prop !== "targets" && ownPropDescriptor) {
100
+ Object.defineProperty(
101
+ Controller.prototype,
102
+ prop,
103
+ ownPropDescriptor
104
+ );
105
+ }
106
+ }
107
+
108
+ return Controller;
109
+ }
110
+
111
+ export function addController(name: string, controller: ControllerDefinition) {
112
+ application.register(name, createController(controller));
113
+ }
@@ -0,0 +1,26 @@
1
+ // patch for @open-wc/testing types
2
+ // TODO: remove when this PR gets merged:
3
+ // https://github.com/open-wc/open-wc/pull/2652
4
+
5
+ // eslint-disable-next-line @typescript-eslint/triple-slash-reference
6
+ /// <reference path="../../node_modules/@open-wc/testing/register-chai-plugins.d.ts" />
7
+
8
+ export { html } from "@open-wc/testing-helpers";
9
+ export { unsafeStatic } from "@open-wc/testing-helpers";
10
+ export { triggerBlurFor } from "@open-wc/testing-helpers";
11
+ export { triggerFocusFor } from "@open-wc/testing-helpers";
12
+ export { oneEvent } from "@open-wc/testing-helpers";
13
+ export { isIE } from "@open-wc/testing-helpers";
14
+ export { defineCE } from "@open-wc/testing-helpers";
15
+ export { aTimeout } from "@open-wc/testing-helpers";
16
+ export { nextFrame } from "@open-wc/testing-helpers";
17
+ export { litFixture } from "@open-wc/testing-helpers";
18
+ export { litFixtureSync } from "@open-wc/testing-helpers";
19
+ export { fixture } from "@open-wc/testing-helpers";
20
+ export { fixtureSync } from "@open-wc/testing-helpers";
21
+ export { fixtureCleanup } from "@open-wc/testing-helpers";
22
+ export { elementUpdated } from "@open-wc/testing-helpers";
23
+ export { waitUntil } from "@open-wc/testing-helpers";
24
+
25
+ export * as chai from "chai";
26
+ export { expect, assert, should } from "chai";