@iress-oss/ids-mcp-server 5.14.2 → 6.0.0-alpha.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 (105) hide show
  1. package/generated/docs/components-alert-docs.md +579 -7
  2. package/generated/docs/components-autocomplete-docs.md +694 -15
  3. package/generated/docs/components-autocomplete-recipes-docs.md +1 -1
  4. package/generated/docs/components-badge-docs.md +442 -59
  5. package/generated/docs/components-button-docs.md +1150 -70
  6. package/generated/docs/components-buttongroup-docs.md +441 -3
  7. package/generated/docs/components-card-docs.md +487 -37
  8. package/generated/docs/components-checkbox-docs.md +506 -5
  9. package/generated/docs/components-checkboxgroup-docs.md +586 -191
  10. package/generated/docs/components-checkboxgroup-recipes-docs.md +3 -3
  11. package/generated/docs/components-col-docs.md +451 -36
  12. package/generated/docs/components-container-docs.md +32 -0
  13. package/generated/docs/components-divider-docs.md +427 -27
  14. package/generated/docs/components-expander-docs.md +487 -108
  15. package/generated/docs/components-field-docs.md +1400 -68
  16. package/generated/docs/components-filter-docs.md +269 -56
  17. package/generated/docs/components-hide-docs.md +447 -10
  18. package/generated/docs/components-icon-docs.md +522 -259
  19. package/generated/docs/components-image-docs.md +493 -0
  20. package/generated/docs/components-inline-docs.md +1179 -44
  21. package/generated/docs/components-input-docs.md +544 -12
  22. package/generated/docs/components-input-recipes-docs.md +4 -4
  23. package/generated/docs/components-inputcurrency-docs.md +532 -0
  24. package/generated/docs/components-inputcurrency-recipes-docs.md +4 -5
  25. package/generated/docs/components-introduction-docs.md +450 -0
  26. package/generated/docs/components-label-docs.md +454 -27
  27. package/generated/docs/components-link-docs.md +586 -0
  28. package/generated/docs/components-menu-docs.md +531 -89
  29. package/generated/docs/components-menu-menuitem-docs.md +556 -10
  30. package/generated/docs/components-modal-docs.md +814 -55
  31. package/generated/docs/components-panel-docs.md +418 -198
  32. package/generated/docs/components-placeholder-docs.md +420 -1
  33. package/generated/docs/components-popover-docs.md +1097 -32
  34. package/generated/docs/components-popover-recipes-docs.md +39 -73
  35. package/generated/docs/components-progress-docs.md +464 -0
  36. package/generated/docs/components-provider-docs.md +160 -0
  37. package/generated/docs/components-radio-docs.md +460 -4
  38. package/generated/docs/components-radiogroup-docs.md +586 -116
  39. package/generated/docs/components-readonly-docs.md +450 -4
  40. package/generated/docs/components-richselect-docs.md +4660 -1257
  41. package/generated/docs/components-row-docs.md +2065 -588
  42. package/generated/docs/components-select-docs.md +489 -5
  43. package/generated/docs/components-skeleton-docs.md +399 -16
  44. package/generated/docs/components-skeleton-recipes-docs.md +7 -7
  45. package/generated/docs/components-skiplink-docs.md +548 -27
  46. package/generated/docs/components-slideout-docs.md +648 -150
  47. package/generated/docs/components-slider-docs.md +515 -33
  48. package/generated/docs/components-spinner-docs.md +393 -2
  49. package/generated/docs/components-stack-docs.md +732 -74
  50. package/generated/docs/components-table-ag-grid-docs.md +501 -1723
  51. package/generated/docs/components-table-docs.md +1049 -27
  52. package/generated/docs/components-tabset-docs.md +454 -27
  53. package/generated/docs/components-tabset-tab-docs.md +464 -0
  54. package/generated/docs/components-tag-docs.md +452 -19
  55. package/generated/docs/components-text-docs.md +322 -131
  56. package/generated/docs/components-toaster-docs.md +512 -51
  57. package/generated/docs/components-toggle-docs.md +476 -20
  58. package/generated/docs/components-tooltip-docs.md +443 -7
  59. package/generated/docs/components-validationmessage-docs.md +933 -13
  60. package/generated/docs/extensions-editor-docs.md +906 -13
  61. package/generated/docs/extensions-editor-recipes-docs.md +51 -1
  62. package/generated/docs/foundations-accessibility-docs.md +1 -23
  63. package/generated/docs/foundations-grid-docs.md +74 -0
  64. package/generated/docs/foundations-introduction-docs.md +6 -4
  65. package/generated/docs/foundations-responsive-breakpoints-docs.md +193 -0
  66. package/generated/docs/foundations-tokens-colour-docs.md +564 -0
  67. package/generated/docs/foundations-tokens-elevation-docs.md +155 -0
  68. package/generated/docs/foundations-tokens-introduction-docs.md +190 -0
  69. package/generated/docs/foundations-tokens-radius-docs.md +71 -0
  70. package/generated/docs/foundations-tokens-spacing-docs.md +89 -0
  71. package/generated/docs/foundations-tokens-typography-docs.md +322 -0
  72. package/generated/docs/foundations-z-index-stacking-docs.md +31 -0
  73. package/generated/docs/get-started-develop-docs.md +177 -16
  74. package/generated/docs/guidelines.md +1537 -295
  75. package/generated/docs/introduction-docs.md +65 -21
  76. package/generated/docs/news-version-6-docs.md +93 -0
  77. package/generated/docs/patterns-form-docs.md +3902 -0
  78. package/generated/docs/patterns-form-recipes-docs.md +1370 -0
  79. package/generated/docs/patterns-introduction-docs.md +24 -0
  80. package/generated/docs/patterns-loading-docs.md +2942 -203
  81. package/generated/docs/resources-introduction-docs.md +38 -0
  82. package/generated/docs/resources-mcp-server-docs.md +27 -0
  83. package/generated/docs/styling-props-colour-docs.md +172 -0
  84. package/generated/docs/styling-props-elevation-docs.md +88 -0
  85. package/generated/docs/styling-props-radius-docs.md +86 -0
  86. package/generated/docs/styling-props-reference-docs.md +160 -0
  87. package/generated/docs/styling-props-screen-readers-docs.md +71 -0
  88. package/generated/docs/styling-props-sizing-docs.md +627 -0
  89. package/generated/docs/styling-props-spacing-docs.md +2282 -0
  90. package/generated/docs/styling-props-typography-docs.md +121 -0
  91. package/generated/docs/themes-available-themes-docs.md +29 -29
  92. package/generated/docs/themes-introduction-docs.md +1 -1
  93. package/package.json +3 -22
  94. package/generated/docs/components-button-recipes-docs.md +0 -76
  95. package/generated/docs/components-card-recipes-docs.md +0 -89
  96. package/generated/docs/components-combobox-docs.md +0 -1016
  97. package/generated/docs/components-form-docs.md +0 -2442
  98. package/generated/docs/components-form-recipes-docs.md +0 -892
  99. package/generated/docs/components-navbar-docs.md +0 -291
  100. package/generated/docs/components-navbar-recipes-docs.md +0 -413
  101. package/generated/docs/components-toaster-toast-docs.md +0 -157
  102. package/generated/docs/foundations-colours-docs.md +0 -257
  103. package/generated/docs/foundations-typography-docs.md +0 -191
  104. package/generated/docs/resources-changelog-docs.md +0 -6
  105. package/generated/docs/themes-tokens-docs.md +0 -1200
@@ -0,0 +1,31 @@
1
+ [](#z-index-stacking)Z-index (stacking)
2
+ =======================================
3
+
4
+ The z-index determines the stacking order of elements. Elements with a higher z-index always sit in front of elements with a lower z-index. Each index has been mapped to the appropriate elevation(s).
5
+
6
+ [](#reference)Reference
7
+ -----------------------
8
+
9
+ | Name | Usage | Value |
10
+ | --- | --- | --- |
11
+ | DEFAULT | The default z-index used for most elements. Can be combined with raised and floating elevations. | 0 |
12
+ | MODAL | Used for IressModal. Can be combined with floating elevation. | 400 |
13
+ | NAVBAR | Used for navbars. Can be combined with overflow elevation. | 100 |
14
+ | POPOVER | Used for IressPopover. Can be combined with floating elevation. | 200 |
15
+ | SLIDEOUT | Used for IressSlideout. Can be combined with floating elevation. | 300 |
16
+ | TOAST | Used for IressToast. Can be combined with floating elevation. | 500 |
17
+ | TOOLTIP | Used for IressTooltip. Can be combined with floating elevation. | 600 |
18
+
19
+ * * *
20
+
21
+ [](#for-developers)For developers
22
+ ---------------------------------
23
+
24
+ If you are using the IDS components, the z-indexes have already been mapped out to their respective components based on the usage above. They are hardcoded into the components, so you don't need to worry about them.
25
+
26
+ The mapping is exported as `Z_INDEX` from the `@iress-oss/ids-components` package, in case you need to reference it in your own code.
27
+
28
+ On this page
29
+
30
+ * [Reference](#reference)
31
+ * [For developers](#for-developers)
@@ -12,10 +12,108 @@ Set up your environment to use the latest version of the Iress Design System (ID
12
12
  [](#set-up-the-component-library)Set up the component library
13
13
  -------------------------------------------------------------
14
14
 
15
- 1. Install using: `yarn add @iress-oss/ids-components`
16
- 2. Import the styles: `import '@iress-oss/ids-components/dist/style.css'`
17
- 3. Import the components: `import { IressButton, IressText } from '@iress-oss/ids-components'`
18
- 4. Use the components: `<IressButton>Click me</IressButton>`
15
+ 1. Install using the command line:
16
+
17
+ \[data-radix-scroll-area-viewport\] {
18
+ scrollbar-width: none;
19
+ -ms-overflow-style: none;
20
+ -webkit-overflow-scrolling: touch;
21
+ }
22
+ \[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
23
+ display: none;
24
+ }
25
+ :where(\[data-radix-scroll-area-viewport\]) {
26
+ display: flex;
27
+ flex-direction: column;
28
+ align-items: stretch;
29
+ }
30
+ :where(\[data-radix-scroll-area-content\]) {
31
+ flex-grow: 1;
32
+ }
33
+
34
+ yarn add @iress-oss/ids-components
35
+
36
+ Copy
37
+
38
+ 2. Import the styles:
39
+
40
+ \[data-radix-scroll-area-viewport\] {
41
+ scrollbar-width: none;
42
+ -ms-overflow-style: none;
43
+ -webkit-overflow-scrolling: touch;
44
+ }
45
+ \[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
46
+ display: none;
47
+ }
48
+ :where(\[data-radix-scroll-area-viewport\]) {
49
+ display: flex;
50
+ flex-direction: column;
51
+ align-items: stretch;
52
+ }
53
+ :where(\[data-radix-scroll-area-content\]) {
54
+ flex-grow: 1;
55
+ }
56
+
57
+ import '@iress-oss/ids-components/dist/style.css';
58
+
59
+ Copy
60
+
61
+ 3. Import the components. The provider is optional, but recommended for most applications. It sets up the design system and provides a consistent container for components like modals, slideouts, and toasts.
62
+
63
+ \[data-radix-scroll-area-viewport\] {
64
+ scrollbar-width: none;
65
+ -ms-overflow-style: none;
66
+ -webkit-overflow-scrolling: touch;
67
+ }
68
+ \[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
69
+ display: none;
70
+ }
71
+ :where(\[data-radix-scroll-area-viewport\]) {
72
+ display: flex;
73
+ flex-direction: column;
74
+ align-items: stretch;
75
+ }
76
+ :where(\[data-radix-scroll-area-content\]) {
77
+ flex-grow: 1;
78
+ }
79
+
80
+ import { IressProvider, IressButton } from '@iress-oss/ids-components';
81
+
82
+ Copy
83
+
84
+ 4. Use the components:
85
+
86
+ \[data-radix-scroll-area-viewport\] {
87
+ scrollbar-width: none;
88
+ -ms-overflow-style: none;
89
+ -webkit-overflow-scrolling: touch;
90
+ }
91
+ \[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
92
+ display: none;
93
+ }
94
+ :where(\[data-radix-scroll-area-viewport\]) {
95
+ display: flex;
96
+ flex-direction: column;
97
+ align-items: stretch;
98
+ }
99
+ :where(\[data-radix-scroll-area-content\]) {
100
+ flex-grow: 1;
101
+ }
102
+
103
+ const App \= () \=> (
104
+ <IressButton onClick\={() \=> success({ children: 'Toast triggered' })}\>
105
+ Trigger toast </IressButton\>
106
+ );
107
+ ReactDOM.createRoot(document.getElementById('root')!).render(
108
+ <IressProvider\>
109
+ <App />
110
+ </IressProvider\>,
111
+ );
112
+
113
+ Copy
114
+
115
+
116
+ * * *
19
117
 
20
118
  [](#set-up-the-theme)Set up the theme
21
119
  -------------------------------------
@@ -27,22 +125,85 @@ Microfrontends
27
125
 
28
126
  If you are building a React App that is intended to be used as a microfrontend, please skip this step. Microfrontends should inherit the parent application's theme, and not define a theme itself, as it may conflict with other microfrontends in the same parent application.
29
127
 
30
- 1. Install using `yarn add @iress/ids-themes`
31
- 2. Import the component: `import { IressTheme } from '@iress/ids-themes'`
32
- 3. Add the component to your application: `<IressTheme name="iress-beta-theme-light" />`.
128
+ 1. Install using the command line:
129
+
130
+ \[data-radix-scroll-area-viewport\] {
131
+ scrollbar-width: none;
132
+ -ms-overflow-style: none;
133
+ -webkit-overflow-scrolling: touch;
134
+ }
135
+ \[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
136
+ display: none;
137
+ }
138
+ :where(\[data-radix-scroll-area-viewport\]) {
139
+ display: flex;
140
+ flex-direction: column;
141
+ align-items: stretch;
142
+ }
143
+ :where(\[data-radix-scroll-area-content\]) {
144
+ flex-grow: 1;
145
+ }
146
+
147
+ yarn add @iress/ids-themes
148
+
149
+ Copy
150
+
151
+ 2. Import the component:
152
+
153
+ \[data-radix-scroll-area-viewport\] {
154
+ scrollbar-width: none;
155
+ -ms-overflow-style: none;
156
+ -webkit-overflow-scrolling: touch;
157
+ }
158
+ \[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
159
+ display: none;
160
+ }
161
+ :where(\[data-radix-scroll-area-viewport\]) {
162
+ display: flex;
163
+ flex-direction: column;
164
+ align-items: stretch;
165
+ }
166
+ :where(\[data-radix-scroll-area-content\]) {
167
+ flex-grow: 1;
168
+ }
169
+
170
+ import { IressTheme } from '@iress-oss/ids-components';
171
+
172
+ Copy
173
+
174
+ 3. Add the component to your application:
175
+
176
+ \[data-radix-scroll-area-viewport\] {
177
+ scrollbar-width: none;
178
+ -ms-overflow-style: none;
179
+ -webkit-overflow-scrolling: touch;
180
+ }
181
+ \[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
182
+ display: none;
183
+ }
184
+ :where(\[data-radix-scroll-area-viewport\]) {
185
+ display: flex;
186
+ flex-direction: column;
187
+ align-items: stretch;
188
+ }
189
+ :where(\[data-radix-scroll-area-content\]) {
190
+ flex-grow: 1;
191
+ }
192
+
193
+ ReactDOM.createRoot(document.getElementById('root')!).render(
194
+ <IressProvider\>
195
+ <IressTheme />
196
+ <App />
197
+ </IressProvider\>,
198
+ );
199
+
200
+ Copy
201
+
33
202
 
34
203
  For alternative ways to import the theme, see the [Themes documentation](./?path=/docs/themes-introduction--docs).
35
204
 
36
- [](#set-up-the-icons)Set up the icons
37
- -------------------------------------
38
-
39
- If you are planning to use the `<IressIcon />` component, you need to include the Font Awesome CSS in your application.
40
-
41
- You can do this by including the Font Awesome CSS [via the Iress CDN](./?path=/docs/components-icon--docs#installation).
42
-
43
205
  On this page
44
206
 
45
207
  * [Requirements](#requirements)
46
208
  * [Set up the component library](#set-up-the-component-library)
47
- * [Set up the theme](#set-up-the-theme)
48
- * [Set up the icons](#set-up-the-icons)
209
+ * [Set up the theme](#set-up-the-theme)