@xplortech/apollo-core 2.4.2 → 2.5.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 (156) hide show
  1. package/.typings/apollo-components.html-data.json +1011 -3481
  2. package/build/style.css +7 -7
  3. package/dist/apollo-core/apollo-core.css +1 -1
  4. package/dist/apollo-core/apollo-core.esm.js +1 -1
  5. package/dist/apollo-core/{p-8c1f73ea.entry.js → p-0e1877a2.entry.js} +1 -1
  6. package/dist/apollo-core/{p-94209785.entry.js → p-1c2e4034.entry.js} +1 -1
  7. package/dist/apollo-core/p-77f0fd4a.entry.js +1 -0
  8. package/dist/apollo-core/p-7c22b842.entry.js +1 -0
  9. package/dist/apollo-core/p-7d245bf0.entry.js +1 -0
  10. package/dist/apollo-core/{p-b1f4604d.entry.js → p-f4c2626d.entry.js} +1 -1
  11. package/dist/cjs/xpl-avatar_41.cjs.entry.js +11732 -1165
  12. package/dist/cjs/xpl-dynamic-table-cell.cjs.entry.js +2 -2
  13. package/dist/cjs/xpl-dynamic-table-row.cjs.entry.js +2 -2
  14. package/dist/cjs/xpl-dynamic-table.cjs.entry.js +1 -1
  15. package/dist/cjs/xpl-grid-item.cjs.entry.js +1 -1
  16. package/dist/cjs/xpl-grid.cjs.entry.js +1 -1
  17. package/dist/collection/collection-manifest.json +1 -1
  18. package/dist/collection/components/xpl-data-card/xpl-data-card.js +11 -25
  19. package/dist/collection/components/xpl-divider/xpl-divider.js +1 -1
  20. package/dist/collection/components/xpl-dropdown/dropdown.stories.js +4 -0
  21. package/dist/collection/components/xpl-dropdown/xpl-dropdown-group/xpl-dropdown-group.js +1 -1
  22. package/dist/collection/components/xpl-dropdown/xpl-dropdown-heading/xpl-dropdown-heading.js +1 -1
  23. package/dist/collection/components/xpl-dropdown/xpl-dropdown-option/xpl-dropdown-option.js +2 -2
  24. package/dist/collection/components/xpl-dropdown/xpl-dropdown.js +2 -2
  25. package/dist/collection/components/xpl-dynamic-table/dynamic-table.stories.js +4 -0
  26. package/dist/collection/components/xpl-dynamic-table/xpl-dynamic-table.js +1 -1
  27. package/dist/collection/components/xpl-dynamic-table-cell/xpl-dynamic-table-cell.js +2 -2
  28. package/dist/collection/components/xpl-dynamic-table-row/xpl-dynamic-table-row.js +2 -2
  29. package/dist/collection/components/xpl-grid/xpl-grid.js +1 -1
  30. package/dist/collection/components/xpl-grid-item/xpl-grid-item.js +1 -1
  31. package/dist/collection/components/xpl-header-accordion/header-accordion.stories.js +4 -0
  32. package/dist/collection/components/xpl-header-accordion/xpl-header-accordion.js +1 -1
  33. package/dist/collection/components/xpl-icon/icon-types.js +1 -0
  34. package/dist/collection/components/xpl-icon/icons.stories.js +47 -12
  35. package/dist/collection/components/xpl-icon/xpl-icon.js +13 -15
  36. package/dist/collection/components/xpl-input/input.stories.js +4 -0
  37. package/dist/collection/components/xpl-input/xpl-input-color/xpl-input-color.js +3 -3
  38. package/dist/collection/components/xpl-input/xpl-input.js +5 -4
  39. package/dist/collection/components/xpl-list/list.stories.js +4 -0
  40. package/dist/collection/components/xpl-progress/progress.stories.js +4 -0
  41. package/dist/collection/components/xpl-radio/radio.stories.js +4 -0
  42. package/dist/collection/components/xpl-select/select.stories.js +4 -0
  43. package/dist/collection/components/xpl-select/xpl-select.js +13 -19
  44. package/dist/collection/components/xpl-skeleton/skeleton.stories.js +4 -0
  45. package/dist/collection/components/xpl-slideout/slideout.stories.js +6 -0
  46. package/dist/collection/components/xpl-table/table.stories.js +4 -0
  47. package/dist/collection/components/xpl-table-header/table-header.stories.js +4 -0
  48. package/dist/collection/components/xpl-table-header-cell/table-header-cell.stories.js +4 -0
  49. package/dist/collection/components/xpl-table-header-cell/xpl-table-header-cell.js +5 -15
  50. package/dist/collection/components/xpl-tabs/tabs.stories.js +4 -0
  51. package/dist/collection/components/xpl-toast/toast.stories.js +4 -0
  52. package/dist/collection/components/xpl-toggle/toggle.stories.js +4 -0
  53. package/dist/collection/components/xpl-tooltip/tooltip.stories.js +4 -0
  54. package/dist/components/xpl-data-card.js +1 -1
  55. package/dist/components/xpl-divider2.js +1 -1
  56. package/dist/components/xpl-dropdown-group2.js +1 -1
  57. package/dist/components/xpl-dropdown-heading2.js +1 -1
  58. package/dist/components/xpl-dropdown-option2.js +1 -1
  59. package/dist/components/xpl-dropdown2.js +1 -1
  60. package/dist/components/xpl-dynamic-table-cell.js +1 -1
  61. package/dist/components/xpl-dynamic-table-row.js +1 -1
  62. package/dist/components/xpl-dynamic-table.js +1 -1
  63. package/dist/components/xpl-grid-item.js +1 -1
  64. package/dist/components/xpl-grid.js +1 -1
  65. package/dist/components/xpl-header-accordion.js +1 -1
  66. package/dist/components/xpl-icon2.js +1 -6
  67. package/dist/components/xpl-input2.js +1 -1
  68. package/dist/components/xpl-select2.js +1 -1
  69. package/dist/docs/xpl-accordion/readme.md +62 -0
  70. package/dist/docs/xpl-application-shell/readme.md +33 -0
  71. package/dist/docs/xpl-avatar/readme.md +35 -0
  72. package/dist/docs/xpl-backdrop/readme.md +34 -0
  73. package/dist/docs/xpl-badge/readme.md +29 -0
  74. package/dist/docs/xpl-breadcrumbs/xpl-breadcrumb-item/readme.md +19 -0
  75. package/dist/docs/xpl-breadcrumbs/xpl-breadcrumbs/readme.md +22 -0
  76. package/dist/docs/xpl-button/readme.md +44 -0
  77. package/dist/docs/xpl-button-row/readme.md +41 -0
  78. package/dist/docs/xpl-calendar/readme.md +48 -0
  79. package/dist/docs/xpl-checkbox/readme.md +47 -0
  80. package/dist/docs/xpl-choicelist/readme.md +43 -0
  81. package/dist/docs/xpl-content-area/readme.md +17 -0
  82. package/dist/docs/xpl-dashboard/readme.md +10 -0
  83. package/dist/docs/xpl-data-card/readme.md +54 -0
  84. package/dist/docs/xpl-divider/readme.md +30 -0
  85. package/dist/docs/xpl-dropdown/readme.md +80 -0
  86. package/dist/docs/xpl-dropdown/xpl-dropdown-group/readme.md +39 -0
  87. package/dist/docs/xpl-dropdown/xpl-dropdown-heading/readme.md +30 -0
  88. package/dist/docs/xpl-dropdown/xpl-dropdown-option/readme.md +36 -0
  89. package/dist/docs/xpl-dynamic-table/readme.md +19 -0
  90. package/dist/docs/xpl-dynamic-table-cell/readme.md +18 -0
  91. package/dist/docs/xpl-dynamic-table-row/readme.md +19 -0
  92. package/dist/docs/xpl-grid/readme.md +10 -0
  93. package/dist/docs/xpl-grid-item/readme.md +20 -0
  94. package/dist/docs/xpl-header-accordion/readme.md +39 -0
  95. package/dist/docs/xpl-icon/readme.md +80 -0
  96. package/dist/docs/xpl-input/readme.md +90 -0
  97. package/dist/docs/xpl-input/xpl-input-color/readme.md +61 -0
  98. package/dist/docs/xpl-input/xpl-input-date/readme.md +56 -0
  99. package/dist/docs/xpl-input/xpl-input-file/readme.md +79 -0
  100. package/dist/docs/xpl-input/xpl-input-time/readme.md +69 -0
  101. package/dist/docs/xpl-large-card/readme.md +40 -0
  102. package/dist/docs/xpl-list/readme.md +34 -0
  103. package/dist/docs/xpl-main-nav/readme.md +28 -0
  104. package/dist/docs/xpl-modal/readme.md +55 -0
  105. package/dist/docs/xpl-nav-item/readme.md +24 -0
  106. package/dist/docs/xpl-pagination/readme.md +52 -0
  107. package/dist/docs/xpl-popover/readme.md +48 -0
  108. package/dist/docs/xpl-progress/readme.md +22 -0
  109. package/dist/docs/xpl-radio/readme.md +43 -0
  110. package/dist/docs/xpl-secondary-nav/readme.md +10 -0
  111. package/dist/docs/xpl-select/readme.md +88 -0
  112. package/dist/docs/xpl-skeleton/readme.md +31 -0
  113. package/dist/docs/xpl-slideout/readme.md +46 -0
  114. package/dist/docs/xpl-tab/readme.md +25 -0
  115. package/dist/docs/xpl-tab-panel/readme.md +18 -0
  116. package/dist/docs/xpl-table/readme.md +46 -0
  117. package/dist/docs/xpl-table-header/readme.md +13 -0
  118. package/dist/docs/xpl-table-header-cell/readme.md +47 -0
  119. package/dist/docs/xpl-tabs/readme.md +54 -0
  120. package/dist/docs/xpl-tag/readme.md +30 -0
  121. package/dist/docs/xpl-toast/readme.md +42 -0
  122. package/dist/docs/xpl-toggle/readme.md +23 -0
  123. package/dist/docs/xpl-toolbar/readme.md +18 -0
  124. package/dist/docs/xpl-tooltip/readme.md +35 -0
  125. package/dist/docs/xpl-utility-bar/readme.md +55 -0
  126. package/dist/esm/xpl-avatar_41.entry.js +11732 -1165
  127. package/dist/esm/xpl-dynamic-table-cell.entry.js +2 -2
  128. package/dist/esm/xpl-dynamic-table-row.entry.js +2 -2
  129. package/dist/esm/xpl-dynamic-table.entry.js +1 -1
  130. package/dist/esm/xpl-grid-item.entry.js +1 -1
  131. package/dist/esm/xpl-grid.entry.js +1 -1
  132. package/dist/types/components/xpl-data-card/xpl-data-card.d.ts +2 -3
  133. package/dist/types/components/xpl-dynamic-table/dynamic-table.stories.d.ts +4 -0
  134. package/dist/types/components/xpl-header-accordion/header-accordion.stories.d.ts +4 -0
  135. package/dist/types/components/xpl-icon/icon-types.d.ts +2 -0
  136. package/dist/types/components/xpl-icon/xpl-icon.d.ts +1 -3
  137. package/dist/types/components/xpl-input/input.stories.d.ts +4 -0
  138. package/dist/types/components/xpl-list/list.stories.d.ts +4 -0
  139. package/dist/types/components/xpl-progress/progress.stories.d.ts +4 -0
  140. package/dist/types/components/xpl-radio/radio.stories.d.ts +4 -0
  141. package/dist/types/components/xpl-select/select.stories.d.ts +4 -0
  142. package/dist/types/components/xpl-select/xpl-select.d.ts +1 -3
  143. package/dist/types/components/xpl-slideout/slideout.stories.d.ts +6 -0
  144. package/dist/types/components/xpl-table/table.stories.d.ts +4 -0
  145. package/dist/types/components/xpl-table-header/table-header.stories.d.ts +4 -0
  146. package/dist/types/components/xpl-table-header-cell/table-header-cell.stories.d.ts +4 -0
  147. package/dist/types/components/xpl-table-header-cell/xpl-table-header-cell.d.ts +1 -2
  148. package/dist/types/components/xpl-tabs/tabs.stories.d.ts +4 -0
  149. package/dist/types/components/xpl-toast/toast.stories.d.ts +4 -0
  150. package/dist/types/components/xpl-toggle/toggle.stories.d.ts +4 -0
  151. package/dist/types/components/xpl-tooltip/tooltip.stories.d.ts +4 -0
  152. package/dist/types/components.d.ts +24 -28
  153. package/package.json +7 -4
  154. package/dist/apollo-core/p-23ef2717.entry.js +0 -6
  155. package/dist/apollo-core/p-31461db7.entry.js +0 -1
  156. package/dist/apollo-core/p-7f8e5cd0.entry.js +0 -1
@@ -0,0 +1,90 @@
1
+ # xpl-input
2
+
3
+
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | --------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ----------- |
12
+ | `_id` | `_id` | Because `id` is a reserved HTMLElement attribute, we prefix it with an underscore here so that it doesn't get automatically applied to the outer container. Applies to all input types. | `string` | `undefined` |
13
+ | `accept` | `accept` | The accepted file types for the file input. Corresponds to the `accept` attribute on the input element. Example: 'image/*' for all image types, '.pdf' for PDF files, etc. Applies to file inputs. | `string` | `''` |
14
+ | `allowCustomOption` | `allow-custom-option` | For time inputs, whether to allow custom option in the input even if not available in the dropdown. Example: A step of 30 minutes will allow 15:03, 15:37, etc. Applies to time inputs. | `boolean` | `false` |
15
+ | `autocomplete` | `autocomplete` | Hint for form autofill feature Applies to text, password, number. | `string` | `undefined` |
16
+ | `dateFormat` | `date-format` | The date format to use for the datepicker input. This is used by flatpickr to format the date. Default is 'Y-m-d' (e.g., 2023-10-01). See https://flatpickr.js.org/formatting/ for more details. Applies to date inputs. | `string` | `'Y-m-d'` |
17
+ | `description` | `description` | Optional text that appears below the input label. Applies to all input types. | `string` | `undefined` |
18
+ | `disabled` | `disabled` | Whether the field is disabled Applies to all input types. | `boolean` | `undefined` |
19
+ | `error` | `error` | If an empty string (attribute present with no value), will display visually as an error. If a string is included, will display visually as an error and include the value as an error message. Applies to all input types. | `string` | `undefined` |
20
+ | `hideAcceptText` | `hide-accept-text` | Hides the "Accept" text that indicates the accepted file types This is useful for cases where you want to hide the "Accept" text. Applies to file inputs. | `boolean` | `false` |
21
+ | `hideEyeDropper` | `hide-eye-dropper` | Hide eye dropper Applies to color inputs. | `boolean` | `undefined` |
22
+ | `hideFileNames` | `hide-file-names` | Hides the file names in the file upload component This is useful for cases where you want to hide the file names after selection. Applies to file inputs. | `boolean` | `false` |
23
+ | `hideTriggerOnSelect` | `hide-trigger-on-select` | Hides the trigger element when a file is selected. This is useful for cases where you want to hide the trigger after a file is selected. Applies to file inputs. | `boolean` | `false` |
24
+ | `label` | `label` | Label text for the field Applies to all input types. | `string` | `undefined` |
25
+ | `max` | `max` | Maximum value for the input. Applies to number, time, and date inputs. If the input is a time input, the value must be in 24 hour format, ex: 18:25 for 6:25 PM | `number \| string` | `undefined` |
26
+ | `maxCharacterCount` | `max-character-count` | For multiline inputs, a max. character count will display along with the current character count, and will automatically render as an error if the character count exceeds the max. This is only applicable if `multiline` is `true`. | `number` | `undefined` |
27
+ | `min` | `min` | The minimum value for the input. Applies to number, time, and date inputs. If the input is a time input, the value must be in 24 hour format, ex: 05:25 for 5:25 AM | `number \| string` | `undefined` |
28
+ | `mode` | `mode` | For datepicker inputs, whether to allow only a single date or a range of dates. (Multiple non-consecutive dates planned to be supported in the future.) Applies to date inputs. | `"range" \| "single"` | `'single'` |
29
+ | `multiline` | `multiline` | Whether to render as a singleline text input or as a multiline textarea. (If `true`, `pre` and `post` values will be ignored, if present.) Applies to text inputs. | `boolean` | `false` |
30
+ | `multiple` | `multiple` | Whether the user can select multiple files at once. Corresponds to the `multiple` attribute on the input element. Applies to file inputs. | `boolean` | `false` |
31
+ | `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. Applies to all input types. | `string` | `undefined` |
32
+ | `placeholder` | `placeholder` | Placeholder text that appears when the field has no value Applies to text, password, number, and date inputs. | `string` | `undefined` |
33
+ | `post` | `post` | A string (recommended max 3 characters) that gets shown visually to the left of (before) the input. Applies to text, password, number, and date inputs. Note: This will be ignored if `multiline` is `true`. | `string` | `undefined` |
34
+ | `pre` | `pre` | A string (recommended max 8 characters) that gets shown visually to the right of (after) the input. Applies to text, password, number, and date inputs. Note: This will be ignored if `multiline` is `true`. | `string` | `undefined` |
35
+ | `readonly` | `readonly` | Whether the input is editable Applies to text, password, number, and date inputs. | `boolean` | `undefined` |
36
+ | `required` | `required` | Whether the input is required Applies to all input types. | `boolean` | `undefined` |
37
+ | `step` | `step` | The granularity that the value in a `number` input must adhere to when incrementing or decrementing. The default stepping value for number inputs is 1 Applies to number and time inputs. | `number` | `undefined` |
38
+ | `timeFormat` | `time-format` | The time format to display for the input. Applies to time inputs. If 12h is selected, the value will be displayed in 12 hour format, ex: 05:25 PM for 17:25 If 24h is selected, the value will be displayed in 24 hour format, ex: 17:25 for 17:25 | `"12h" \| "24h"` | `'24h'` |
39
+ | `type` | `type` | The type of form control | `"color" \| "date" \| "file" \| "number" \| "password" \| "text" \| "time"` | `'text'` |
40
+ | `value` | `value` | Including a `value` will pre-populate the input with the given string. Applies to text, password, number, and date inputs. | `string` | `undefined` |
41
+
42
+
43
+ ## Events
44
+
45
+ | Event | Description | Type |
46
+ | ------------- | ---------------------------------------------------------------------------------- | ------------------------- |
47
+ | `blurEvent` | The event handler for the blur event | `CustomEvent<FocusEvent>` |
48
+ | `focusEvent` | The event handler for the focus event | `CustomEvent<FocusEvent>` |
49
+ | `inputEvent` | Event that emits the current value of the input Applies to text like inputs only. | `CustomEvent<string>` |
50
+ | `valueChange` | Event that emits the current value of the input | `CustomEvent<string>` |
51
+
52
+
53
+ ## Dependencies
54
+
55
+ ### Used by
56
+
57
+ - [xpl-input-color](xpl-input-color)
58
+ - [xpl-input-time](xpl-input-time)
59
+
60
+ ### Depends on
61
+
62
+ - [xpl-input-file](xpl-input-file)
63
+ - [xpl-input-color](xpl-input-color)
64
+ - [xpl-input-date](xpl-input-date)
65
+ - [xpl-input-time](xpl-input-time)
66
+ - [xpl-icon](../xpl-icon)
67
+
68
+ ### Graph
69
+ ```mermaid
70
+ graph TD;
71
+ xpl-input --> xpl-input-file
72
+ xpl-input --> xpl-input-color
73
+ xpl-input --> xpl-input-date
74
+ xpl-input --> xpl-input-time
75
+ xpl-input --> xpl-icon
76
+ xpl-input-file --> xpl-icon
77
+ xpl-input-color --> xpl-input
78
+ xpl-input-date --> xpl-icon
79
+ xpl-input-time --> xpl-input
80
+ xpl-dropdown --> xpl-dropdown-group
81
+ xpl-dropdown --> xpl-dropdown-option
82
+ xpl-dropdown-group --> xpl-dropdown-group
83
+ xpl-dropdown-group --> xpl-dropdown-option
84
+ xpl-dropdown-group --> xpl-dropdown-heading
85
+ style xpl-input fill:#f9f,stroke:#333,stroke-width:4px
86
+ ```
87
+
88
+ ----------------------------------------------
89
+
90
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,61 @@
1
+ # xpl-input-color
2
+
3
+
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | ---------------- | ------------------ | ----------------------------------------------------------------------------- | --------- | ---------------- |
12
+ | `disabled` | `disabled` | Indicates whether the color picker is disabled. | `boolean` | `undefined` |
13
+ | `hideEyeDropper` | `hide-eye-dropper` | Hide eye dropper | `boolean` | `undefined` |
14
+ | `placeholder` | `placeholder` | Placeholder text for the color input. This is used when no color is selected. | `string` | `'Select color'` |
15
+ | `required` | `required` | Indicates whether the color picker is required. | `boolean` | `undefined` |
16
+ | `value` | `value` | The color value of the picker. | `string` | `undefined` |
17
+
18
+
19
+ ## Events
20
+
21
+ | Event | Description | Type |
22
+ | ---------------------- | ----------------------------------------------------------- | --------------------- |
23
+ | `hasErrorStateChanged` | Event that is emitted when the hasErrorState state changes. | `CustomEvent<string>` |
24
+ | `inputChange` | Event that is emitted when the color value changes. | `CustomEvent<string>` |
25
+
26
+
27
+ ## Dependencies
28
+
29
+ ### Used by
30
+
31
+ - [xpl-input](..)
32
+
33
+ ### Depends on
34
+
35
+ - [xpl-popover](../../xpl-popover)
36
+ - [xpl-icon](../../xpl-icon)
37
+ - [xpl-input](..)
38
+
39
+ ### Graph
40
+ ```mermaid
41
+ graph TD;
42
+ xpl-input-color --> xpl-popover
43
+ xpl-input-color --> xpl-icon
44
+ xpl-input-color --> xpl-input
45
+ xpl-input --> xpl-input-color
46
+ xpl-input-file --> xpl-icon
47
+ xpl-input-date --> xpl-icon
48
+ xpl-input-time --> xpl-input
49
+ xpl-input-time --> xpl-icon
50
+ xpl-input-time --> xpl-dropdown
51
+ xpl-dropdown --> xpl-dropdown-group
52
+ xpl-dropdown --> xpl-dropdown-option
53
+ xpl-dropdown-group --> xpl-dropdown-group
54
+ xpl-dropdown-group --> xpl-dropdown-option
55
+ xpl-dropdown-group --> xpl-dropdown-heading
56
+ style xpl-input-color fill:#f9f,stroke:#333,stroke-width:4px
57
+ ```
58
+
59
+ ----------------------------------------------
60
+
61
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,56 @@
1
+ # xpl-input-date
2
+
3
+
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | ------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------- |
12
+ | `dateFormat` | `date-format` | The date format to use for the datepicker input. This is used by flatpickr to format the date. Default is 'Y-m-d' (e.g., 2023-10-01). See https://flatpickr.js.org/formatting/ for more details. | `string` | `'Y-m-d'` |
13
+ | `disabled` | `disabled` | Whether the field is disabled | `boolean` | `undefined` |
14
+ | `inputId` | `input-id` | The `inputId` is used to associate the input with a label. | `string` | `undefined` |
15
+ | `max` | `max` | Maximum value for the input. | `number \| string` | `undefined` |
16
+ | `min` | `min` | The minimum value for the input. | `number \| string` | `undefined` |
17
+ | `mode` | `mode` | For datepicker inputs, whether to allow only a single date or a range of dates. (Multiple non-consecutive dates planned to be supported in the future.) | `"range" \| "single"` | `'single'` |
18
+ | `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. Applies to all input types. | `string` | `undefined` |
19
+ | `placeholder` | `placeholder` | Placeholder text that appears when the field has no value Applies to text, password, number, and date inputs. | `string` | `undefined` |
20
+ | `post` | `post` | A string (recommended max 3 characters) that gets shown visually to the left of (before) the input. | `string` | `undefined` |
21
+ | `pre` | `pre` | A string (recommended max 8 characters) that gets shown visually to the right of (after) the input. | `string` | `undefined` |
22
+ | `readonly` | `readonly` | Whether the input is editable | `boolean` | `undefined` |
23
+ | `required` | `required` | Whether the input is required | `boolean` | `undefined` |
24
+ | `value` | `value` | Including a `value` will pre-populate the input with the given string. | `string` | `undefined` |
25
+
26
+
27
+ ## Events
28
+
29
+ | Event | Description | Type |
30
+ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
31
+ | `hasErrorStateChanged` | Event that is emitted when the hasErrorState state changes. | `CustomEvent<string>` |
32
+ | `rangeSelected` | Event that emits the selected date range when the mode is 'range'. The emitted value is an object with `start` and `end` properties. | `CustomEvent<{ start: Date; end: Date; }>` |
33
+ | `valueChange` | Event that emits the current value of the input | `CustomEvent<string>` |
34
+
35
+
36
+ ## Dependencies
37
+
38
+ ### Used by
39
+
40
+ - [xpl-input](..)
41
+
42
+ ### Depends on
43
+
44
+ - [xpl-icon](../../xpl-icon)
45
+
46
+ ### Graph
47
+ ```mermaid
48
+ graph TD;
49
+ xpl-input-date --> xpl-icon
50
+ xpl-input --> xpl-input-date
51
+ style xpl-input-date fill:#f9f,stroke:#333,stroke-width:4px
52
+ ```
53
+
54
+ ----------------------------------------------
55
+
56
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,79 @@
1
+ # xpl-file-upload
2
+
3
+
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Overview
9
+
10
+ `xpl-input-file` is a component that allows users to upload files.
11
+
12
+ ## Properties
13
+
14
+ | Property | Attribute | Description | Type | Default |
15
+ | --------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- |
16
+ | `_id` | `_id` | Because `id` is a reserved HTMLElement attribute, we prefix it with an underscore here so that it doesn't get automatically applied to the outer container. | `string` | `undefined` |
17
+ | `accept` | `accept` | The accepted file types for the file input. Corresponds to the `accept` attribute on the input element. Example: 'image/*' for all image types, '.pdf' for PDF files, etc. | `string` | `''` |
18
+ | `disabled` | `disabled` | Whether the field is disabled | `boolean` | `undefined` |
19
+ | `hideAcceptText` | `hide-accept-text` | Hides the "Accept" text that indicates the accepted file types | `boolean` | `false` |
20
+ | `hideFileNames` | `hide-file-names` | Hides the file names in the file upload component | `boolean` | `false` |
21
+ | `hideTriggerOnSelect` | `hide-trigger-on-select` | Hides the trigger element when a file is selected. | `boolean` | `false` |
22
+ | `multiple` | `multiple` | Whether the user can select multiple files at once. Corresponds to the `multiple` attribute on the input element. | `boolean` | `false` |
23
+ | `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. | `string` | `undefined` |
24
+
25
+
26
+ ## Events
27
+
28
+ | Event | Description | Type |
29
+ | ------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------- |
30
+ | `inputChange` | Event emitted when a file is selected. The event detail contains the FileList object. | `CustomEvent<{ type: string; value: File[]; }>` |
31
+
32
+
33
+ ## Methods
34
+
35
+ ### `removeFileByIndex(fileIndex: number) => Promise<void>`
36
+
37
+ Removes a file from the selected files by its index.
38
+
39
+ #### Parameters
40
+
41
+ | Name | Type | Description |
42
+ | ----------- | -------- | -------------------------------- |
43
+ | `fileIndex` | `number` | The index of the file to remove. |
44
+
45
+ #### Returns
46
+
47
+ Type: `Promise<void>`
48
+
49
+
50
+
51
+
52
+ ## Slots
53
+
54
+ | Slot | Description |
55
+ | ----------- | ----------------------------------------------------------------- |
56
+ | `"trigger"` | The element that, when clicked, will open the file select dialog. |
57
+
58
+
59
+ ## Dependencies
60
+
61
+ ### Used by
62
+
63
+ - [xpl-input](..)
64
+
65
+ ### Depends on
66
+
67
+ - [xpl-icon](../../xpl-icon)
68
+
69
+ ### Graph
70
+ ```mermaid
71
+ graph TD;
72
+ xpl-input-file --> xpl-icon
73
+ xpl-input --> xpl-input-file
74
+ style xpl-input-file fill:#f9f,stroke:#333,stroke-width:4px
75
+ ```
76
+
77
+ ----------------------------------------------
78
+
79
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,69 @@
1
+ # xpl-input-time
2
+
3
+
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | ------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----------- |
12
+ | `allowCustomOption` | `allow-custom-option` | For time inputs, whether to allow custom option in the input even if not available in the dropdown. Example: A step of 30 minutes will allow 15:03, 15:37, etc. Applies to time inputs. | `boolean` | `false` |
13
+ | `disabled` | `disabled` | Whether the field is disabled | `boolean` | `undefined` |
14
+ | `inputId` | `input-id` | The `inputId` is used to associate the input with a label. | `string` | `undefined` |
15
+ | `max` | `max` | Maximum value for the input. | `number \| string` | `'23:59'` |
16
+ | `min` | `min` | The minimum value for the input. | `number \| string` | `'00:00'` |
17
+ | `mode` | `mode` | Whether the input is a single time or a range of times. Currently, only single time is supported. | `"range" \| "single"` | `'single'` |
18
+ | `name` | `name` | Most inputs are used in forms, and should have a `name` associated with the input for handling form data. Applies to all input types. | `string` | `undefined` |
19
+ | `placeholder` | `placeholder` | Placeholder text that appears when the field has no value Applies to text, password, number, and date inputs. | `string` | `undefined` |
20
+ | `readonly` | `readonly` | Whether the input is editable | `boolean` | `undefined` |
21
+ | `required` | `required` | Whether the input is required | `boolean` | `undefined` |
22
+ | `step` | `step` | Time increment for dropdown options | `number` | `30` |
23
+ | `timeFormat` | `time-format` | The time format to display for the input. | `"12h" \| "24h"` | `'24h'` |
24
+ | `value` | `value` | Including a `value` will pre-populate the input with the given string. Must be in 24 hour format, ex: 15:25 for 3:25 PM | `string` | `undefined` |
25
+
26
+
27
+ ## Events
28
+
29
+ | Event | Description | Type |
30
+ | ---------------------- | ----------------------------------------------------------- | --------------------- |
31
+ | `hasErrorStateChanged` | Event that is emitted when the hasErrorState state changes. | `CustomEvent<string>` |
32
+ | `valueChange` | Event that emits the current value of the input | `CustomEvent<string>` |
33
+
34
+
35
+ ## Dependencies
36
+
37
+ ### Used by
38
+
39
+ - [xpl-input](..)
40
+
41
+ ### Depends on
42
+
43
+ - [xpl-input](..)
44
+ - [xpl-icon](../../xpl-icon)
45
+ - [xpl-dropdown](../../xpl-dropdown)
46
+
47
+ ### Graph
48
+ ```mermaid
49
+ graph TD;
50
+ xpl-input-time --> xpl-input
51
+ xpl-input-time --> xpl-icon
52
+ xpl-input-time --> xpl-dropdown
53
+ xpl-input --> xpl-input-time
54
+ xpl-input-file --> xpl-icon
55
+ xpl-input-color --> xpl-popover
56
+ xpl-input-color --> xpl-icon
57
+ xpl-input-color --> xpl-input
58
+ xpl-input-date --> xpl-icon
59
+ xpl-dropdown --> xpl-dropdown-group
60
+ xpl-dropdown --> xpl-dropdown-option
61
+ xpl-dropdown-group --> xpl-dropdown-group
62
+ xpl-dropdown-group --> xpl-dropdown-option
63
+ xpl-dropdown-group --> xpl-dropdown-heading
64
+ style xpl-input-time fill:#f9f,stroke:#333,stroke-width:4px
65
+ ```
66
+
67
+ ----------------------------------------------
68
+
69
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,40 @@
1
+ # xpl-large-card
2
+
3
+
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | ------------- | ------------- | --------------------------------- | --------- | ----------- |
12
+ | `description` | `description` | Description of the Card | `string` | `undefined` |
13
+ | `link` | `link` | Whether the card is a link or not | `boolean` | `undefined` |
14
+ | `name` | `name` | Name of the Card | `string` | `undefined` |
15
+
16
+
17
+ ## Slots
18
+
19
+ | Slot | Description |
20
+ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
21
+ | `"graph-content"` | Content that is shown on the right-side of the card. Generally used for supplemental data visualizations for the data-card |
22
+ | `"title"` | The title for the card. This slot should be used as a replacement for the name field. Used to define a title and tooltip for the data-card |
23
+
24
+
25
+ ## Dependencies
26
+
27
+ ### Depends on
28
+
29
+ - [xpl-icon](../xpl-icon)
30
+
31
+ ### Graph
32
+ ```mermaid
33
+ graph TD;
34
+ xpl-large-card --> xpl-icon
35
+ style xpl-large-card fill:#f9f,stroke:#333,stroke-width:4px
36
+ ```
37
+
38
+ ----------------------------------------------
39
+
40
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,34 @@
1
+ # xpl-list
2
+
3
+ A list item is a card with interactive states. List items allow users to select items from a list of items and view more information or make edits.
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------- |
12
+ | `items` | -- | `items` should be an array of objects with the following signature: { avatar?: string; // The URL of the avatar, or the placeholder initials (ex. "SPD"). avatars?: string[]; // The URLs of multiple avatars to be displayed in a group on the right. badges?: string[] \| { // An array of strings or badge-like objects to be displayed as badges dot?: boolean; // in a group on the right. See <xpl-badge> for more details. text: string; variant?: string; }[]; href?: string; // A URL, if this list item is meant to link somewhere. title: string; // The text to be displayed for the list item. metadata?: string[] \| { // An array of strings or strings with icons (reference the allowed icon: string; // Apollo icons) to be displayed as metadata below the title. text: string; }[]; subtext?: string; // Subtext to be displayed on the right. } - Note that you should *only use one of* `avatars`, `badges`, or `subtext`, to avoid cluttering the right-hand side of the list item. | `ListItem[]` | `[]` |
13
+
14
+
15
+ ## Dependencies
16
+
17
+ ### Depends on
18
+
19
+ - [xpl-avatar](../xpl-avatar)
20
+ - [xpl-icon](../xpl-icon)
21
+ - [xpl-badge](../xpl-badge)
22
+
23
+ ### Graph
24
+ ```mermaid
25
+ graph TD;
26
+ xpl-list --> xpl-avatar
27
+ xpl-list --> xpl-icon
28
+ xpl-list --> xpl-badge
29
+ style xpl-list fill:#f9f,stroke:#333,stroke-width:4px
30
+ ```
31
+
32
+ ----------------------------------------------
33
+
34
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,28 @@
1
+ # xpl-main-nav
2
+
3
+ The Main Nav component contains is split in 3 areas. The top area is where the branding goes. It's divided into 2 slots `logo` and `brand-name`.
4
+ The middle area is where the main navigation links go. It's a `<nav>` tag with a slot named `navigation`, where a `<ul slot="navigation">` with `<xpl-nav-items>` should be rendered.
5
+
6
+ The bottom area is fixed to the bottom and should be used for actions. To render content within this area use the slot `footer` with a `<ul slot="footer">` tag.
7
+
8
+
9
+ <!-- Auto Generated Below -->
10
+
11
+
12
+ ## Properties
13
+
14
+ | Property | Attribute | Description | Type | Default |
15
+ | -------- | --------- | ----------- | --------------------------- | ----------- |
16
+ | `width` | `width` | | `"default" \| "md" \| "sm"` | `'default'` |
17
+
18
+
19
+ ## Events
20
+
21
+ | Event | Description | Type |
22
+ | ---------- | ----------- | --------------------- |
23
+ | `navWidth` | | `CustomEvent<string>` |
24
+
25
+
26
+ ----------------------------------------------
27
+
28
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,55 @@
1
+ # xpl-modal
2
+
3
+
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | --------- | --------- | -------------------------------- | -------------------------------- | ----------- |
12
+ | `isOpen` | `is-open` | Whether the modal is open. | `boolean` | `false` |
13
+ | `size` | `size` | The size of the modal. | `"large" \| "medium" \| "small"` | `'medium'` |
14
+ | `variant` | `variant` | The visual variant of the modal. | `"default" \| "warning"` | `'default'` |
15
+
16
+
17
+ ## Events
18
+
19
+ | Event | Description | Type |
20
+ | ------------- | --------------------------------- | ------------------- |
21
+ | `modalClosed` | Emitted when the modal is closed. | `CustomEvent<void>` |
22
+
23
+
24
+ ## Slots
25
+
26
+ | Slot | Description |
27
+ | ------------- | ---------------------------------- |
28
+ | `"body"` | The body of the modal. |
29
+ | `"primary"` | The primary button of the modal. |
30
+ | `"secondary"` | The secondary button of the modal. |
31
+ | `"subtitle"` | The subtitle of the modal. |
32
+ | `"tertiary"` | The tertiary button of the modal. |
33
+ | `"title"` | The title of the modal. |
34
+
35
+
36
+ ## Dependencies
37
+
38
+ ### Depends on
39
+
40
+ - [xpl-backdrop](../xpl-backdrop)
41
+ - [xpl-icon](../xpl-icon)
42
+ - [xpl-button](../xpl-button)
43
+
44
+ ### Graph
45
+ ```mermaid
46
+ graph TD;
47
+ xpl-modal --> xpl-backdrop
48
+ xpl-modal --> xpl-icon
49
+ xpl-modal --> xpl-button
50
+ style xpl-modal fill:#f9f,stroke:#333,stroke-width:4px
51
+ ```
52
+
53
+ ----------------------------------------------
54
+
55
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,24 @@
1
+ # xpl-nav-item
2
+
3
+ This component should be used within sections of the `<xpl-main-nav>`. This component yields a slot named `link`, where a `<a>` tag should be used. Within the `<a>` tag, there are two slots, one named `icon`, where any svg can be placed. An an unnamed slot, where the link text should be placed.
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | ------------ | ------------- | ----------- | --------- | ------- |
12
+ | `navControl` | `nav-control` | | `boolean` | `false` |
13
+
14
+
15
+ ## Events
16
+
17
+ | Event | Description | Type |
18
+ | --------- | ----------- | ---------------------- |
19
+ | `navOpen` | | `CustomEvent<boolean>` |
20
+
21
+
22
+ ----------------------------------------------
23
+
24
+ *Built with [StencilJS](https://stenciljs.com/)*
@@ -0,0 +1,52 @@
1
+ # xpl-pagination
2
+
3
+ > **Note:** This component is in beta. Use with caution and expect updates before the full release.
4
+
5
+ <!-- Auto Generated Below -->
6
+
7
+
8
+ ## Properties
9
+
10
+ | Property | Attribute | Description | Type | Default |
11
+ | --------------------- | ------------------------ | ------------------------------------------------------------------------------------------------- | --------- | -------------------- |
12
+ | `currentPage` | `current-page` | The current active page (1-based). Marked as mutable so we can update from inside this component. | `number` | `1` |
13
+ | `rowsPerPageOptions` | `rows-per-page-options` | The rows-per-page options offered in the dropdown. | `string` | `'10,25,50,100,150'` |
14
+ | `selectedRowsPerPage` | `selected-rows-per-page` | The currently selected rows-per-page. | `number` | `10` |
15
+ | `totalPages` | `total-pages` | Total number of pages. | `number` | `1` |
16
+ | `withPageControl` | `with-page-control` | Whether to allow go to page navigation. | `boolean` | `false` |
17
+
18
+
19
+ ## Events
20
+
21
+ | Event | Description | Type |
22
+ | ------------------- | ------------------------------------------- | --------------------- |
23
+ | `pageChange` | Emitted whenever the current page changes. | `CustomEvent<number>` |
24
+ | `rowsPerPageChange` | Emitted whenever the rows-per-page changes. | `CustomEvent<number>` |
25
+
26
+
27
+ ## Dependencies
28
+
29
+ ### Depends on
30
+
31
+ - [xpl-select](../xpl-select)
32
+ - [xpl-icon](../xpl-icon)
33
+
34
+ ### Graph
35
+ ```mermaid
36
+ graph TD;
37
+ xpl-pagination --> xpl-select
38
+ xpl-pagination --> xpl-icon
39
+ xpl-select --> xpl-tag
40
+ xpl-select --> xpl-icon
41
+ xpl-select --> xpl-dropdown
42
+ xpl-dropdown --> xpl-dropdown-group
43
+ xpl-dropdown --> xpl-dropdown-option
44
+ xpl-dropdown-group --> xpl-dropdown-group
45
+ xpl-dropdown-group --> xpl-dropdown-option
46
+ xpl-dropdown-group --> xpl-dropdown-heading
47
+ style xpl-pagination fill:#f9f,stroke:#333,stroke-width:4px
48
+ ```
49
+
50
+ ----------------------------------------------
51
+
52
+ *Built with [StencilJS](https://stenciljs.com/)*