@aurodesignsystem-dev/auro-formkit 0.0.0-pr1379.0 → 0.0.0-pr1379.10

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 (226) hide show
  1. package/CHANGELOG.md +2 -2
  2. package/README.md +87 -113
  3. package/components/combobox/demo/keyboardBehavior.html +81 -0
  4. package/components/counter/demo/keyboardBehavior.html +81 -0
  5. package/components/datepicker/demo/keyboard-behavior.html +81 -0
  6. package/components/dropdown/demo/keyboardBehavior.html +81 -0
  7. package/components/select/demo/keyboardBehavior.html +81 -0
  8. package/package.json +64 -53
  9. package/components/bibtemplate/dist/auro-bibtemplate.d.ts +0 -66
  10. package/components/bibtemplate/dist/buttonVersion.d.ts +0 -2
  11. package/components/bibtemplate/dist/headerVersion.d.ts +0 -2
  12. package/components/bibtemplate/dist/iconVersion.d.ts +0 -2
  13. package/components/bibtemplate/dist/index.d.ts +0 -2
  14. package/components/bibtemplate/dist/index.js +0 -395
  15. package/components/bibtemplate/dist/registered.js +0 -395
  16. package/components/bibtemplate/dist/styles/color-css.d.ts +0 -2
  17. package/components/bibtemplate/dist/styles/style-css.d.ts +0 -2
  18. package/components/bibtemplate/dist/styles/tokens-css.d.ts +0 -2
  19. package/components/checkbox/demo/api.md +0 -489
  20. package/components/checkbox/demo/api.min.js +0 -2133
  21. package/components/checkbox/demo/index.md +0 -55
  22. package/components/checkbox/demo/index.min.js +0 -2108
  23. package/components/checkbox/demo/readme.md +0 -142
  24. package/components/checkbox/dist/auro-checkbox-group.d.ts +0 -176
  25. package/components/checkbox/dist/auro-checkbox.d.ts +0 -209
  26. package/components/checkbox/dist/index.d.ts +0 -3
  27. package/components/checkbox/dist/index.js +0 -2057
  28. package/components/checkbox/dist/registered.js +0 -2058
  29. package/components/checkbox/dist/styles/auro-checkbox-css.d.ts +0 -2
  30. package/components/checkbox/dist/styles/auro-checkbox-group-css.d.ts +0 -2
  31. package/components/checkbox/dist/styles/color-css.d.ts +0 -2
  32. package/components/checkbox/dist/styles/colorGroup-css.d.ts +0 -2
  33. package/components/checkbox/dist/styles/tokens-css.d.ts +0 -2
  34. package/components/combobox/demo/api.md +0 -2287
  35. package/components/combobox/demo/api.min.js +0 -17549
  36. package/components/combobox/demo/index.md +0 -196
  37. package/components/combobox/demo/index.min.js +0 -17454
  38. package/components/combobox/demo/readme.md +0 -158
  39. package/components/combobox/dist/auro-combobox.d.ts +0 -552
  40. package/components/combobox/dist/comboboxKeyboardStrategy.d.ts +0 -6
  41. package/components/combobox/dist/index.d.ts +0 -2
  42. package/components/combobox/dist/index.js +0 -15474
  43. package/components/combobox/dist/registered.js +0 -15476
  44. package/components/combobox/dist/styles/emphasized/style-css.d.ts +0 -2
  45. package/components/combobox/dist/styles/snowflake/style-css.d.ts +0 -2
  46. package/components/combobox/dist/styles/style-css.d.ts +0 -2
  47. package/components/counter/demo/api.md +0 -1285
  48. package/components/counter/demo/api.min.js +0 -7993
  49. package/components/counter/demo/index.md +0 -92
  50. package/components/counter/demo/index.min.js +0 -7974
  51. package/components/counter/demo/readme.md +0 -161
  52. package/components/counter/dist/auro-counter-button.d.ts +0 -14
  53. package/components/counter/dist/auro-counter-group.d.ts +0 -390
  54. package/components/counter/dist/auro-counter-wrapper.d.ts +0 -17
  55. package/components/counter/dist/auro-counter.d.ts +0 -126
  56. package/components/counter/dist/buttonVersion.d.ts +0 -2
  57. package/components/counter/dist/iconVersion.d.ts +0 -2
  58. package/components/counter/dist/index.d.ts +0 -3
  59. package/components/counter/dist/index.js +0 -7896
  60. package/components/counter/dist/registered.js +0 -7897
  61. package/components/counter/dist/styles/color-css.d.ts +0 -2
  62. package/components/counter/dist/styles/counter-button-color-css.d.ts +0 -2
  63. package/components/counter/dist/styles/counter-button-css.d.ts +0 -2
  64. package/components/counter/dist/styles/counter-group-css.d.ts +0 -2
  65. package/components/counter/dist/styles/counter-wrapper-color-css.d.ts +0 -2
  66. package/components/counter/dist/styles/counter-wrapper-css.d.ts +0 -2
  67. package/components/counter/dist/styles/shapeSize-css.d.ts +0 -2
  68. package/components/counter/dist/styles/style-css.d.ts +0 -2
  69. package/components/counter/dist/styles/tokens-css.d.ts +0 -2
  70. package/components/datepicker/demo/api.md +0 -1824
  71. package/components/datepicker/demo/api.min.js +0 -24530
  72. package/components/datepicker/demo/index.md +0 -158
  73. package/components/datepicker/demo/index.min.js +0 -24251
  74. package/components/datepicker/demo/readme.md +0 -137
  75. package/components/datepicker/dist/auro-calendar-cell.d.ts +0 -169
  76. package/components/datepicker/dist/auro-calendar-month.d.ts +0 -20
  77. package/components/datepicker/dist/auro-calendar.d.ts +0 -173
  78. package/components/datepicker/dist/auro-datepicker.d.ts +0 -722
  79. package/components/datepicker/dist/buttonVersion.d.ts +0 -2
  80. package/components/datepicker/dist/iconVersion.d.ts +0 -2
  81. package/components/datepicker/dist/index.d.ts +0 -2
  82. package/components/datepicker/dist/index.js +0 -24166
  83. package/components/datepicker/dist/popoverVersion.d.ts +0 -2
  84. package/components/datepicker/dist/registered.js +0 -24166
  85. package/components/datepicker/dist/styles/classic/color-css.d.ts +0 -2
  86. package/components/datepicker/dist/styles/classic/style-css.d.ts +0 -2
  87. package/components/datepicker/dist/styles/color-calendar-css.d.ts +0 -2
  88. package/components/datepicker/dist/styles/color-cell-css.d.ts +0 -2
  89. package/components/datepicker/dist/styles/color-css.d.ts +0 -2
  90. package/components/datepicker/dist/styles/color-month-css.d.ts +0 -2
  91. package/components/datepicker/dist/styles/shapeSize-css.d.ts +0 -2
  92. package/components/datepicker/dist/styles/snowflake/color-css.d.ts +0 -2
  93. package/components/datepicker/dist/styles/snowflake/style-css.d.ts +0 -2
  94. package/components/datepicker/dist/styles/style-auro-calendar-cell-css.d.ts +0 -2
  95. package/components/datepicker/dist/styles/style-auro-calendar-css.d.ts +0 -2
  96. package/components/datepicker/dist/styles/style-auro-calendar-month-css.d.ts +0 -2
  97. package/components/datepicker/dist/styles/style-css.d.ts +0 -2
  98. package/components/datepicker/dist/styles/tokens-css.d.ts +0 -2
  99. package/components/datepicker/dist/utilities.d.ts +0 -78
  100. package/components/datepicker/dist/utilitiesCalendar.d.ts +0 -38
  101. package/components/datepicker/dist/utilitiesCalendarRender.d.ts +0 -50
  102. package/components/datepicker/dist/vendor/wc-range-datepicker/day.d.ts +0 -5
  103. package/components/datepicker/dist/vendor/wc-range-datepicker/range-datepicker-calendar.d.ts +0 -60
  104. package/components/datepicker/dist/vendor/wc-range-datepicker/range-datepicker-cell.d.ts +0 -1
  105. package/components/datepicker/dist/vendor/wc-range-datepicker/range-datepicker.d.ts +0 -57
  106. package/components/dropdown/demo/api.md +0 -1358
  107. package/components/dropdown/demo/api.min.js +0 -4853
  108. package/components/dropdown/demo/index.md +0 -283
  109. package/components/dropdown/demo/index.min.js +0 -4788
  110. package/components/dropdown/demo/readme.md +0 -160
  111. package/components/dropdown/dist/auro-dropdown.d.ts +0 -482
  112. package/components/dropdown/dist/auro-dropdownBib.d.ts +0 -155
  113. package/components/dropdown/dist/iconVersion.d.ts +0 -2
  114. package/components/dropdown/dist/index.d.ts +0 -2
  115. package/components/dropdown/dist/index.js +0 -4685
  116. package/components/dropdown/dist/keyboardUtils.d.ts +0 -18
  117. package/components/dropdown/dist/registered.js +0 -4685
  118. package/components/dropdown/dist/styles/classic/bibColors-css.d.ts +0 -2
  119. package/components/dropdown/dist/styles/classic/bibStyles-css.d.ts +0 -2
  120. package/components/dropdown/dist/styles/classic/color-css.d.ts +0 -2
  121. package/components/dropdown/dist/styles/classic/style-css.d.ts +0 -2
  122. package/components/dropdown/dist/styles/color-css.d.ts +0 -2
  123. package/components/dropdown/dist/styles/emphasized/style-css.d.ts +0 -2
  124. package/components/dropdown/dist/styles/shapeSize-css.d.ts +0 -2
  125. package/components/dropdown/dist/styles/snowflake/style-css.d.ts +0 -2
  126. package/components/dropdown/dist/styles/style-css.d.ts +0 -2
  127. package/components/dropdown/dist/styles/tokens-css.d.ts +0 -2
  128. package/components/form/demo/api.md +0 -319
  129. package/components/form/demo/api.min.js +0 -69996
  130. package/components/form/demo/index.md +0 -128
  131. package/components/form/demo/index.min.js +0 -69996
  132. package/components/form/demo/readme.md +0 -145
  133. package/components/form/dist/auro-form.d.ts +0 -280
  134. package/components/form/dist/index.d.ts +0 -2
  135. package/components/form/dist/index.js +0 -718
  136. package/components/form/dist/registered.d.ts +0 -1
  137. package/components/form/dist/registered.js +0 -718
  138. package/components/form/dist/styles/style-css.d.ts +0 -2
  139. package/components/helptext/dist/auro-helptext.d.ts +0 -69
  140. package/components/helptext/dist/index.d.ts +0 -2
  141. package/components/helptext/dist/index.js +0 -231
  142. package/components/helptext/dist/registered.js +0 -231
  143. package/components/helptext/dist/styles/color-css.d.ts +0 -2
  144. package/components/helptext/dist/styles/style-css.d.ts +0 -2
  145. package/components/helptext/dist/styles/tokens-css.d.ts +0 -2
  146. package/components/input/demo/api.md +0 -1397
  147. package/components/input/demo/api.min.js +0 -7435
  148. package/components/input/demo/index.md +0 -161
  149. package/components/input/demo/index.min.js +0 -7355
  150. package/components/input/demo/readme.md +0 -134
  151. package/components/input/dist/auro-input.d.ts +0 -195
  152. package/components/input/dist/base-input.d.ts +0 -628
  153. package/components/input/dist/buttonVersion.d.ts +0 -2
  154. package/components/input/dist/i18n.d.ts +0 -18
  155. package/components/input/dist/iconVersion.d.ts +0 -2
  156. package/components/input/dist/index.d.ts +0 -2
  157. package/components/input/dist/index.js +0 -7278
  158. package/components/input/dist/registered.js +0 -7278
  159. package/components/input/dist/styles/classic/color-css.d.ts +0 -2
  160. package/components/input/dist/styles/classic/style-css.d.ts +0 -2
  161. package/components/input/dist/styles/color-css.d.ts +0 -2
  162. package/components/input/dist/styles/default/borders-css.d.ts +0 -2
  163. package/components/input/dist/styles/default/color-css.d.ts +0 -2
  164. package/components/input/dist/styles/default/mixins-css.d.ts +0 -2
  165. package/components/input/dist/styles/default/notificationIcons-css.d.ts +0 -2
  166. package/components/input/dist/styles/default/style-css.d.ts +0 -2
  167. package/components/input/dist/styles/emphasized/color-css.d.ts +0 -2
  168. package/components/input/dist/styles/emphasized/style-css.d.ts +0 -2
  169. package/components/input/dist/styles/mixins-css.d.ts +0 -2
  170. package/components/input/dist/styles/shapeSize-css.d.ts +0 -2
  171. package/components/input/dist/styles/snowflake/style-css.d.ts +0 -2
  172. package/components/input/dist/styles/style-css.d.ts +0 -2
  173. package/components/input/dist/styles/tokens-css.d.ts +0 -2
  174. package/components/input/dist/utilities.d.ts +0 -25
  175. package/components/layoutElement/dist/auroElement.d.ts +0 -40
  176. package/components/layoutElement/dist/index.d.ts +0 -2
  177. package/components/layoutElement/dist/index.js +0 -107
  178. package/components/layoutElement/dist/registered.js +0 -107
  179. package/components/menu/demo/api.md +0 -1200
  180. package/components/menu/demo/api.min.js +0 -2292
  181. package/components/menu/demo/index.md +0 -72
  182. package/components/menu/demo/index.min.js +0 -2185
  183. package/components/menu/demo/readme.md +0 -145
  184. package/components/menu/dist/auro-menu-utils.d.ts +0 -34
  185. package/components/menu/dist/auro-menu.context.d.ts +0 -227
  186. package/components/menu/dist/auro-menu.d.ts +0 -324
  187. package/components/menu/dist/auro-menuoption.d.ts +0 -210
  188. package/components/menu/dist/iconVersion.d.ts +0 -2
  189. package/components/menu/dist/index.d.ts +0 -4
  190. package/components/menu/dist/index.js +0 -2148
  191. package/components/menu/dist/registered.js +0 -2096
  192. package/components/menu/dist/styles/default/color-menu-css.d.ts +0 -2
  193. package/components/menu/dist/styles/default/color-menuoption-css.d.ts +0 -2
  194. package/components/menu/dist/styles/default/style-menu-css.d.ts +0 -2
  195. package/components/menu/dist/styles/default/style-menuoption-css.d.ts +0 -2
  196. package/components/menu/dist/styles/default/tokens-css.d.ts +0 -2
  197. package/components/radio/demo/api.md +0 -675
  198. package/components/radio/demo/api.min.js +0 -2210
  199. package/components/radio/demo/index.md +0 -73
  200. package/components/radio/demo/index.min.js +0 -2167
  201. package/components/radio/demo/readme.md +0 -141
  202. package/components/radio/dist/auro-radio-group.d.ts +0 -250
  203. package/components/radio/dist/auro-radio.d.ts +0 -180
  204. package/components/radio/dist/index.d.ts +0 -3
  205. package/components/radio/dist/index.js +0 -2116
  206. package/components/radio/dist/registered.js +0 -2117
  207. package/components/radio/dist/styles/auro-radio-group-css.d.ts +0 -2
  208. package/components/radio/dist/styles/color-css.d.ts +0 -2
  209. package/components/radio/dist/styles/groupColor-css.d.ts +0 -2
  210. package/components/radio/dist/styles/style-css.d.ts +0 -2
  211. package/components/radio/dist/styles/tokens-css.d.ts +0 -2
  212. package/components/select/demo/api.md +0 -2378
  213. package/components/select/demo/api.min.js +0 -10133
  214. package/components/select/demo/index.md +0 -355
  215. package/components/select/demo/index.min.js +0 -10040
  216. package/components/select/demo/readme.md +0 -148
  217. package/components/select/dist/auro-select.d.ts +0 -545
  218. package/components/select/dist/index.d.ts +0 -2
  219. package/components/select/dist/index.js +0 -8072
  220. package/components/select/dist/registered.js +0 -8072
  221. package/components/select/dist/selectKeyboardStrategy.d.ts +0 -8
  222. package/components/select/dist/styles/emphasized/color-css.d.ts +0 -2
  223. package/components/select/dist/styles/shapeSize-css.d.ts +0 -2
  224. package/components/select/dist/styles/style-css.d.ts +0 -2
  225. package/components/select/dist/styles/tokens-css.d.ts +0 -2
  226. package/custom-elements.json +0 -18656
package/CHANGELOG.md CHANGED
@@ -1,5 +1,5 @@
1
- ### Changelog
1
+ # Changelog
2
2
 
3
- You can view a history of changes to this repository on the releases page:
3
+ You can view a complete history of changes to this repository on the GitHub releases page:
4
4
 
5
5
  https://github.com/AlaskaAirlines/auro-formkit/releases
package/README.md CHANGED
@@ -1,27 +1,27 @@
1
1
  <!--
2
2
  The README.md file is a compiled document. No edits should be made directly to this file.
3
3
 
4
- README.md is created by running `npm run build:docs`.
4
+ README.md is created by running `npm run build:docs:kit`.
5
5
 
6
- This file is generated based on a template fetched from
7
- `../../docs/templates/componentReadmeTemplate.md`
8
- and copied to `./componentDocs/README.md` each time the docs are compiled.
6
+ This file is generated based on the template at
7
+ `./docs/templates/kitReadmeTemplate.md`
8
+ and compiled to `./README.md` each time the docs are compiled.
9
9
 
10
10
  The following sections are editable by making changes to the following files:
11
11
 
12
12
  | SECTION | DESCRIPTION | FILE LOCATION |
13
13
  |------------------------|---------------------------------------------------|-------------------------------------|
14
- | Description | Description of the component | `./docs/partials/description.md` |
15
- | Use Cases | Examples for when to use this component | `./docs/partials/useCases.md` |
16
- | Additional Information | For use to add any component specific information | `./docs/partials/readmeAddlInfo.md` |
17
- | Component Example Code | HTML sample code of the components use | `./apiExamples/basic.html` |
18
- -->
19
-
14
+ | Description | Description of the kit | `./docs/partials/description.md` |
15
+ | Use Cases | Examples for when to use this kit | `./docs/partials/useCases.md` |
16
+ | Additional Information | For use to add any kit specific information | `./docs/partials/readmeAddlInfo.md` |
17
+ | kit Example Code | HTML sample code of the kits use | `./apiExamples/basic.html` |
18
+ -->
19
+
20
20
  # Formkit
21
21
 
22
22
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/description.md) -->
23
- <!-- The below content is automatically added from ./docs/partials/description.md -->
24
-
23
+ <!-- The below content is automatically added from ./docs/partials/description.md -->
24
+
25
25
  ## Description
26
26
 
27
27
  `auro-formkit` is a collection of web components that can be used to build forms.
@@ -42,81 +42,72 @@ It is a monorepo that contains the following components:
42
42
  - `auro-radio`
43
43
  - `auro-radio-group`
44
44
  - `auro-select`
45
- <!-- AURO-GENERATED-CONTENT:END -->
46
-
45
+ <!-- AURO-GENERATED-CONTENT:END -->
46
+
47
47
  ## Use Cases
48
48
 
49
49
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/useCases.md) -->
50
- <!-- The below content is automatically added from ./docs/partials/useCases.md -->
51
-
50
+ <!-- The below content is automatically added from ./docs/partials/useCases.md -->
51
+
52
52
  ### 1. User Accounts
53
53
  - Sign up and login forms
54
- - Email and password validation
55
-
54
+ - Email and password validation
55
+
56
56
  ### 2. Checkout & Payments
57
57
  - Collect shipping and billing info
58
- - Use autofill and validation to reduce errors
59
-
58
+ - Use autofill and validation to reduce errors
59
+
60
60
  ### 3. Booking & Scheduling
61
61
  - Select dates and times
62
- - Prevent invalid selections (like past dates)
63
-
62
+ - Prevent invalid selections (like past dates)
63
+
64
64
  ### 4. Search & Filters
65
65
  - Search inputs with suggestions
66
- - Filters like price ranges or categories
67
-
66
+ - Filters like price ranges or categories
67
+
68
68
  ### 5. File Uploads
69
69
  - Upload images, documents, or media
70
- - Restrict file types and allow multiple files
71
-
70
+ - Restrict file types and allow multiple files
71
+
72
72
  ### 6. Feedback & Surveys
73
73
  - Collect ratings, choices, and comments
74
- - Require answers where needed
75
-
74
+ - Require answers where needed
75
+
76
76
  ### 7. Calculators & Dynamic Forms
77
- - Show real-time results (e.g., pricing, totals)
78
-
77
+ - Show real-time results (e.g., pricing, totals)
78
+
79
79
  ### 8. Multi-Step Forms
80
- - Break long forms into smaller steps
81
-
80
+ - Break long forms into smaller steps
81
+
82
82
  ### 9. Mobile-Friendly Input
83
- - Use input types that trigger the right keyboard
84
-
83
+ - Use input types that trigger the right keyboard
84
+
85
85
  ### 10. Accessible Forms
86
86
  - Proper labels and grouped inputs
87
- - Built-in error handling
88
-
87
+ - Built-in error handling
88
+
89
89
  ### 11. Built-in Validation
90
90
  - Use HTML5 rules instead of custom JavaScript
91
- <!-- AURO-GENERATED-CONTENT:END -->
92
-
91
+ <!-- AURO-GENERATED-CONTENT:END -->
92
+
93
93
  ## Getting Started
94
94
 
95
95
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/kitInstall.md) -->
96
96
  <!-- The below content is automatically added from ./docs/partials/kitInstall.md -->
97
-
98
- #### NPM Installation
99
-
100
- ```shell
101
- $ npm i @aurodesignsystem/
102
- ```
103
- <!-- AURO-GENERATED-CONTENT:END -->
104
- <!-- AURO-GENERATED-CONTENT:START (REMOTE:url=https://raw.githubusercontent.com/AlaskaAirlines/WC-Generator/master/componentDocs/partials/usage/componentInstall_esm.md) -->
105
97
  [![Build Status](https://img.shields.io/github/actions/workflow/status/AlaskaAirlines/auro-formkit/testPublish.yml?style=for-the-badge)](https://github.com/AlaskaAirlines/auro-formkit/actions/workflows/testPublish.yml)
106
98
  [![See it on NPM!](https://img.shields.io/npm/v/@aurodesignsystem/auro-formkit?style=for-the-badge&color=orange)](https://www.npmjs.com/package/@aurodesignsystem/auro-formkit)
107
99
  [![License](https://img.shields.io/npm/l/@aurodesignsystem/auro-formkit?color=blue&style=for-the-badge)](https://www.apache.org/licenses/LICENSE-2.0)
108
100
  ![ESM supported](https://img.shields.io/badge/ESM-compatible-FFE900?style=for-the-badge)
109
101
 
102
+ #### NPM Installation
103
+
110
104
  ```shell
111
105
  $ npm i @aurodesignsystem/auro-formkit
112
106
  ```
113
-
114
- Installing as a direct, dev or peer dependency is up to the user installing the package. If you are unsure as to what type of dependency you should use, consider reading this [stack overflow](https://stackoverflow.com/questions/18875674/whats-the-difference-between-dependencies-devdependencies-and-peerdependencies) answer.
115
-
116
- <!-- AURO-GENERATED-CONTENT:END -->
107
+ <!-- AURO-GENERATED-CONTENT:END -->
117
108
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/gettingStarted.md) -->
118
- <!-- The below content is automatically added from ./docs/partials/gettingStarted.md -->
119
-
109
+ <!-- The below content is automatically added from ./docs/partials/gettingStarted.md -->
110
+
120
111
  ### TypeScript Module Resolution
121
112
 
122
113
  When using TypeScript set `moduleResolution` to `bundler`, add the following to your `tsconfig.json`:
@@ -130,43 +121,47 @@ When using TypeScript set `moduleResolution` to `bundler`, add the following to
130
121
  ```
131
122
 
132
123
  This configuration enables proper module resolution for the component's TypeScript files.
133
- <!-- AURO-GENERATED-CONTENT:END -->
134
-
124
+ <!-- AURO-GENERATED-CONTENT:END -->
125
+
135
126
  ## Install from CDN
136
127
 
137
128
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/bundleInstallDescription.md) -->
138
129
  <!-- The below content is automatically added from ./docs/partials/bundleInstallDescription.md -->
139
130
  In cases where the project is not able to process JS assets, there are pre-processed assets available for use. Legacy browsers such as IE11 are no longer supported.
140
131
 
141
- ```html
142
- <script type="module" src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/@latest/auro-formkit/+esm"></script>
143
- ```
144
- <!-- AURO-GENERATED-CONTENT:END -->
132
+ Each component is imported individually by its export path:
145
133
 
134
+ ```html
135
+ <script type="module" src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-formkit@latest/auro-checkbox/+esm"></script>
136
+ <script type="module" src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-formkit@latest/auro-input/+esm"></script>
137
+ <script type="module" src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-formkit@latest/auro-select/+esm"></script>
138
+ ```
139
+ <!-- AURO-GENERATED-CONTENT:END -->
140
+
146
141
  ## Additional Information
147
142
 
148
143
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/readmeAddlInfo.md) -->
149
- <!-- The below content is automatically added from ./docs/partials/readmeAddlInfo.md -->
150
-
144
+ <!-- The below content is automatically added from ./docs/partials/readmeAddlInfo.md -->
145
+
151
146
  ### Turborepo Overview
152
147
 
153
- This monorepo is managed using [Turborepo](https://turborepo.org/).
154
-
155
- ### Managing dependencies
156
-
148
+ This monorepo is managed using [Turborepo](https://turborepo.org/).
149
+
150
+ ### Managing dependencies
151
+
157
152
  #### Best practices for dependency installation
158
153
 
159
154
  When you install a dependency in a component or package in `auro-formkit`, you should install it directly in the package that uses it.
160
155
 
161
- The package's `package.json` will have every dependency that it needs. This is true for both external and internal dependencies.
162
-
163
- ### Types of Dependencies by Source
164
-
156
+ The package's `package.json` will have every dependency that it needs. This is true for both external and internal dependencies.
157
+
158
+ ### Types of Dependencies by Source
159
+
165
160
  #### External Dependencies
166
161
  - These are packages fetched from the `npm` registry (e.g., Lit, Rollup, Sass)
167
162
  - Declared in `package.json` using exact versions or version ranges
168
- - Installed in `node_modules` during `npm install` or `yarn install`
169
-
163
+ - Installed in `node_modules` during `npm install` or `yarn install`
164
+
170
165
  #### Internal Dependencies
171
166
  - These are packages from within the `auro-formkit` monorepo
172
167
  - Allow sharing code between different packages in your repository
@@ -174,33 +169,19 @@ The package's `package.json` will have every dependency that it needs. This is t
174
169
  - Must be declared in `package.json` just like external dependencies
175
170
  - Use workspace protocols (e.g., `"workspace:*"` or `"workspace:^1.0.0"`)
176
171
 
177
- ### Types of Dependencies by Purpose
178
-
172
+ ### Types of Dependencies by Purpose
173
+
179
174
  #### Dependencies (`dependencies`)
180
175
  - Required for the package to function in production
181
176
  - Example:
182
177
  ```json
183
178
  {
184
179
  "dependencies": {
185
- "lit.js": "^3.0.0", // External dependency
186
- "@aurodesignsystem/input": "workspace:*" // Internal dependency
180
+ "lit": "^3.0.0"
187
181
  }
188
182
  }
189
- ```
190
-
191
- #### Peer Dependencies (`peerDependencies`)
192
- - Packages that your library expects the consuming application to provide
193
- - Common for plugins or UI component libraries
194
- - Example:
195
- ```json
196
- {
197
- "peerDependencies": {
198
- "react": "^16.8.0 || ^17.0.0 || ^18.0.0",
199
- "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0"
200
- }
201
- }
202
- ```
203
-
183
+ ```
184
+
204
185
  ### Development Dependencies (`devDependencies`)
205
186
  - Only needed during development, testing, or building
206
187
  - Not included in the production bundle
@@ -208,36 +189,30 @@ The package's `package.json` will have every dependency that it needs. This is t
208
189
  ```json
209
190
  {
210
191
  "devDependencies": {
211
- "typescript": "^5.0.0",
212
- "@open-wc/testing": "^4.0.0" // Internal dev dependency
192
+ "@aurodesignsystem/auro-dropdown": "*",
193
+ "@aurodesignsystem/build-tools": "*",
194
+ "rollup": "^4.24.4"
213
195
  }
214
196
  }
215
- ```
216
-
197
+ ```
198
+
217
199
  ### Example: Component Dependencies
218
200
 
219
- Let's use `@auro-formki/combobox` as an example to illustrate these concepts:
201
+ Let's use `@aurodesignsystem/combobox` as an example to illustrate these concepts:
220
202
 
221
203
  ```json
222
204
  {
223
205
  "name": "@aurodesignsystem/combobox",
224
206
  "dependencies": {
225
- // Internal dependencies
226
- "@aurodesignsystem/auro-dropdown": "*", // Required UI component
227
- "@aurodesignsystem/auro-input": "*", // Required UI component
228
-
229
- // External dependencies
230
- "@alaskaairux/icons": "^5.3.0", // Required UI component
231
- "lit": "^3.2.1" // Framework
232
- },
233
- "peerDependencies": {
234
- "@aurodesignsystem/design-tokens": "^4.12.1",
235
- "@aurodesignsystem/webcorestylesheets": "^5.1.2"
207
+ "lit": "^3.2.1"
236
208
  },
237
209
  "devDependencies": {
210
+ // Internal component dependencies
211
+ "@aurodesignsystem/auro-dropdown": "*",
212
+ "@aurodesignsystem/auro-input": "*",
238
213
  // Build utilities
239
214
  "rollup": "^4.24.4",
240
- "@aurodesignsystem/build-tools": "*",
215
+ "@aurodesignsystem/build-tools": "*"
241
216
  }
242
217
  }
243
218
  ```
@@ -246,7 +221,6 @@ This structure ensures that:
246
221
  1. The package explicitly declares all its dependencies
247
222
  2. Internal dependencies are properly tracked and versioned
248
223
  3. Development tools are separated from production dependencies
249
- 4. Peer dependencies are clearly communicated to consumers
250
224
 
251
225
  - External dependencies come from the `npm` registry.
252
226
 
@@ -262,8 +236,8 @@ This practice has several benefits:
262
236
 
263
237
  - **Pruning unused dependencies:** When dependencies are installed in the packages that they are meant for, Turborepo can read your lockfile and remove dependencies that aren't used in the packages you need.
264
238
 
265
- For more information, see the [Turborepo docs](https://turbo.build/repo/docs/crafting-your-repository/managing-dependencies).
266
-
239
+ For more information, see the [Turborepo docs](https://turbo.build/repo/docs/crafting-your-repository/managing-dependencies).
240
+
267
241
  ### Root `package.json`
268
242
 
269
243
  The only dependencies that belong in the root `package.json` are **tools for managing the repository**.
@@ -271,13 +245,13 @@ The only dependencies that belong in the root `package.json` are **tools for man
271
245
  Some examples of dependencies that make sense to install in the root are `turbo`, `husky`, or `stylelint`.
272
246
 
273
247
  Conversely, dependencies Auro components rely on should be installed in their respective packages, such as `Lit`, `Rollup`, or other `auro-formkit` dependencies.
274
- <!-- AURO-GENERATED-CONTENT:END -->
275
-
248
+ <!-- AURO-GENERATED-CONTENT:END -->
249
+
276
250
  ## Formkit Development
277
251
 
278
252
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./docs/partials/developmentDescription.md) -->
279
- <!-- The below content is automatically added from ./docs/partials/developmentDescription.md -->
280
-
253
+ <!-- The below content is automatically added from ./docs/partials/developmentDescription.md -->
254
+
281
255
  ### Filtering
282
256
 
283
257
  Running the `dev` command will open a `localhost` development server for all components in the monorepo at once.
@@ -0,0 +1,81 @@
1
+ <!--
2
+ Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
3
+ See LICENSE in the project root for license information.
4
+
5
+ HTML in this document is standardized and NOT to be edited.
6
+ All demo code should be added/edited in ./demo/index.md
7
+
8
+ With the exception of adding custom elements if needed for the demo.
9
+
10
+ ----------------------- DO NOT EDIT -----------------------------
11
+
12
+ -->
13
+
14
+ <!DOCTYPE html>
15
+ <html lang="en">
16
+ <head>
17
+ <meta charset="UTF-8" />
18
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
19
+ <title>Auro Web Component Demo | auro-combobox</title>
20
+
21
+ <!-- Prism.js Stylesheet -->
22
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/prismjs@1.24.1/themes/prism.css"/>
23
+
24
+ <!-- Legacy reference is still needed to support auro-combobox's use of legacy token values at this time -->
25
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@latest/dist/legacy/auro-classic/CSSCustomProperties.css"/>
26
+
27
+ <!-- Design Token Alaska Theme -->
28
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@latest/dist/themes/alaska/CSSCustomProperties--alaska.min.css"/>
29
+
30
+ <!-- Webcore Stylesheet Alaska Theme -->
31
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/bundled/themes/alaska.global.min.css" />
32
+
33
+ <!-- Demo Specific Styles -->
34
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/demoWrapper.css" />
35
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/elementDemoStyles.css" />
36
+ <style>
37
+ table {
38
+ --ds-color-container-secondary-default: transparent;
39
+ }
40
+
41
+ tr:not(:last-of-type) {
42
+ border-bottom: 1px solid var(--ds-color-border-tertiary-default);
43
+ }
44
+
45
+ sup {
46
+ font-size: 60%;
47
+ font-style: italic;
48
+ opacity: 0.6;
49
+ top: -.5rem;
50
+ }
51
+
52
+ .note {
53
+ margin: 10px 0;
54
+ padding: 10px;
55
+ border-radius: 6px;
56
+ font-style: italic;
57
+ color: var(--ds-basic-color-texticon-muted);
58
+ background-color: var(--ds-basic-color-surface-neutral-subtle);
59
+ }
60
+ </style>
61
+ </head>
62
+ <body class="auro-markdown">
63
+ <main></main>
64
+
65
+ <script type="module">
66
+ import 'https://cdn.jsdelivr.net/npm/marked@latest/marked.min.js';
67
+ import 'https://cdn.jsdelivr.net/npm/prismjs@latest/prism.js';
68
+ fetch('./keyboardBehavior.md')
69
+ .then((response) => response.text())
70
+ .then((text) => {
71
+ const rawHtml = marked.parse(text);
72
+ document.querySelector('main').innerHTML = rawHtml;
73
+ Prism.highlightAll();
74
+ })
75
+ </script>
76
+
77
+ <!-- If additional elements are needed for the demo, add them here. -->
78
+ <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-header@latest/+esm" type="module"></script>
79
+ <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-hyperlink@latest/+esm" type="module"></script>
80
+ </body>
81
+ </html>
@@ -0,0 +1,81 @@
1
+ <!--
2
+ Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
3
+ See LICENSE in the project root for license information.
4
+
5
+ HTML in this document is standardized and NOT to be edited.
6
+ All demo code should be added/edited in ./demo/index.md
7
+
8
+ With the exception of adding custom elements if needed for the demo.
9
+
10
+ ----------------------- DO NOT EDIT -----------------------------
11
+
12
+ -->
13
+
14
+ <!DOCTYPE html>
15
+ <html lang="en">
16
+ <head>
17
+ <meta charset="UTF-8" />
18
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
19
+ <title>Auro Web Component Demo | auro-counter</title>
20
+
21
+ <!-- Prism.js Stylesheet -->
22
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/prismjs@1.24.1/themes/prism.css"/>
23
+
24
+ <!-- Legacy reference is still needed to support auro-counter's use of legacy token values at this time -->
25
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@latest/dist/legacy/auro-classic/CSSCustomProperties.css"/>
26
+
27
+ <!-- Design Token Alaska Theme -->
28
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@latest/dist/themes/alaska/CSSCustomProperties--alaska.min.css"/>
29
+
30
+ <!-- Webcore Stylesheet Alaska Theme -->
31
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/bundled/themes/alaska.global.min.css" />
32
+
33
+ <!-- Demo Specific Styles -->
34
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/demoWrapper.css" />
35
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/elementDemoStyles.css" />
36
+ <style>
37
+ table {
38
+ --ds-color-container-secondary-default: transparent;
39
+ }
40
+
41
+ tr:not(:last-of-type) {
42
+ border-bottom: 1px solid var(--ds-color-border-tertiary-default);
43
+ }
44
+
45
+ sup {
46
+ font-size: 60%;
47
+ font-style: italic;
48
+ opacity: 0.6;
49
+ top: -.5rem;
50
+ }
51
+
52
+ .note {
53
+ margin: 10px 0;
54
+ padding: 10px;
55
+ border-radius: 6px;
56
+ font-style: italic;
57
+ color: var(--ds-basic-color-texticon-muted);
58
+ background-color: var(--ds-basic-color-surface-neutral-subtle);
59
+ }
60
+ </style>
61
+ </head>
62
+ <body class="auro-markdown">
63
+ <main></main>
64
+
65
+ <script type="module">
66
+ import 'https://cdn.jsdelivr.net/npm/marked@latest/marked.min.js';
67
+ import 'https://cdn.jsdelivr.net/npm/prismjs@latest/prism.js';
68
+ fetch('./keyboardBehavior.md')
69
+ .then((response) => response.text())
70
+ .then((text) => {
71
+ const rawHtml = marked.parse(text);
72
+ document.querySelector('main').innerHTML = rawHtml;
73
+ Prism.highlightAll();
74
+ })
75
+ </script>
76
+
77
+ <!-- If additional elements are needed for the demo, add them here. -->
78
+ <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-header@latest/+esm" type="module"></script>
79
+ <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-hyperlink@latest/+esm" type="module"></script>
80
+ </body>
81
+ </html>
@@ -0,0 +1,81 @@
1
+ <!--
2
+ Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
3
+ See LICENSE in the project root for license information.
4
+
5
+ HTML in this document is standardized and NOT to be edited.
6
+ All demo code should be added/edited in ./demo/index.md
7
+
8
+ With the exception of adding custom elements if needed for the demo.
9
+
10
+ ----------------------- DO NOT EDIT -----------------------------
11
+
12
+ -->
13
+
14
+ <!DOCTYPE html>
15
+ <html lang="en">
16
+ <head>
17
+ <meta charset="UTF-8" />
18
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
19
+ <title>Auro Web Component Demo | auro-datepicker</title>
20
+
21
+ <!-- Prism.js Stylesheet -->
22
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/prismjs@1.24.1/themes/prism.css"/>
23
+
24
+ <!-- Legacy reference is still needed to support auro-datepicker's use of legacy token values at this time -->
25
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@latest/dist/legacy/auro-classic/CSSCustomProperties.css"/>
26
+
27
+ <!-- Design Token Alaska Theme -->
28
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/design-tokens@latest/dist/themes/alaska/CSSCustomProperties--alaska.min.css"/>
29
+
30
+ <!-- Webcore Stylesheet Alaska Theme -->
31
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/bundled/themes/alaska.global.min.css" />
32
+
33
+ <!-- Demo Specific Styles -->
34
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/demoWrapper.css" />
35
+ <link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/@aurodesignsystem/webcorestylesheets@latest/dist/elementDemoStyles.css" />
36
+ <style>
37
+ table {
38
+ --ds-color-container-secondary-default: transparent;
39
+ }
40
+
41
+ tr:not(:last-of-type) {
42
+ border-bottom: 1px solid var(--ds-color-border-tertiary-default);
43
+ }
44
+
45
+ sup {
46
+ font-size: 60%;
47
+ font-style: italic;
48
+ opacity: 0.6;
49
+ top: -.5rem;
50
+ }
51
+
52
+ .note {
53
+ margin: 10px 0;
54
+ padding: 10px;
55
+ border-radius: 6px;
56
+ font-style: italic;
57
+ color: var(--ds-basic-color-texticon-muted);
58
+ background-color: var(--ds-basic-color-surface-neutral-subtle);
59
+ }
60
+ </style>
61
+ </head>
62
+ <body class="auro-markdown">
63
+ <main></main>
64
+
65
+ <script type="module">
66
+ import 'https://cdn.jsdelivr.net/npm/marked@latest/marked.min.js';
67
+ import 'https://cdn.jsdelivr.net/npm/prismjs@latest/prism.js';
68
+ fetch('./keyboardBehavior.md')
69
+ .then((response) => response.text())
70
+ .then((text) => {
71
+ const rawHtml = marked.parse(text);
72
+ document.querySelector('main').innerHTML = rawHtml;
73
+ Prism.highlightAll();
74
+ })
75
+ </script>
76
+
77
+ <!-- If additional elements are needed for the demo, add them here. -->
78
+ <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-header@latest/+esm" type="module"></script>
79
+ <script src="https://cdn.jsdelivr.net/npm/@aurodesignsystem/auro-hyperlink@latest/+esm" type="module"></script>
80
+ </body>
81
+ </html>