igniteui-cli 15.5.0 → 15.6.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 (76) hide show
  1. package/package.json +4 -4
  2. package/templates/blazor/igb/projects/ai-config/files/skills/AGENTS.md +6 -3
  3. package/templates/blazor/igb/projects/ai-config/files/skills/README.md +30 -45
  4. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/SKILL.md +48 -96
  5. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/charts.md +61 -238
  6. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/data-display.md +60 -193
  7. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/feedback.md +36 -92
  8. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/form-controls.md +66 -224
  9. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/layout-manager.md +39 -88
  10. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/layout.md +75 -152
  11. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/setup.md +40 -149
  12. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/SKILL.md +58 -243
  13. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/references/component-mapping.md +89 -280
  14. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/references/gotchas.md +143 -431
  15. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/SKILL.md +91 -157
  16. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/data-operations.md +50 -228
  17. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/editing.md +61 -222
  18. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/features.md +67 -360
  19. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/grid-migration.md +55 -236
  20. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/paging-remote.md +53 -202
  21. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/sizing.md +31 -232
  22. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/state.md +27 -119
  23. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/structure.md +88 -363
  24. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/types.md +87 -415
  25. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-lite-testing/SKILL.md +86 -0
  26. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-lite-testing/references/interop-contracts.md +220 -0
  27. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/SKILL.md +83 -211
  28. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/references/common-patterns.md +93 -184
  29. package/templates/react/igr-ts/projects/_base/files/src/main.tsx +1 -0
  30. package/templates/react/igr-ts/projects/_base_with_home/files/src/app/home/style.module.css +3 -3
  31. package/templates/react/igr-ts/projects/ai-config/files/skills/README.md +30 -83
  32. package/templates/react/igr-ts/projects/ai-config/files/skills/grid-lite-to-igr-grid-migration/SKILL.md +98 -191
  33. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/SKILL.md +38 -147
  34. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/COMPONENTS.md +65 -0
  35. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/DATAVIZ.md +90 -0
  36. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/MCP.md +43 -0
  37. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/TROUBLESHOOTING.md +17 -145
  38. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/USAGE.md +85 -0
  39. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/SKILL.md +83 -135
  40. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/reference/CSS-THEMING.md +51 -218
  41. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/SKILL.md +58 -187
  42. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/reference/gotchas.md +55 -154
  43. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-optimize-bundle-size/SKILL.md +48 -401
  44. package/templates/react/igr-ts/projects/side-nav/files/src/app/app.css +9 -9
  45. package/templates/react/igr-ts/projects/side-nav/files/src/app/home/style.module.css +7 -7
  46. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/app.css +8 -8
  47. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/components/Login.module.css +1 -69
  48. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/components/Login.tsx +5 -5
  49. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/components/LoginBar.module.css +5 -26
  50. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/components/LoginDialog.module.css +0 -1
  51. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/components/Register.module.css +1 -56
  52. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/components/Register.tsx +2 -2
  53. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/pages/Profile.module.css +11 -11
  54. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/pages/RedirectFacebook.tsx +1 -1
  55. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/pages/RedirectGoogle.tsx +1 -1
  56. package/templates/react/igr-ts/projects/side-nav-auth/files/src/app/authentication/pages/RedirectMicrosoft.tsx +1 -1
  57. package/templates/react/igr-ts/projects/side-nav-mini/files/src/app/app.css +9 -9
  58. package/templates/react/igr-ts/projects/side-nav-mini/files/src/app/home/style.module.css +7 -7
  59. package/templates/react/igr-ts/projects/side-nav-mini-auth/files/src/app/app.css +7 -7
  60. package/templates/webcomponents/igc-ts/constants.d.ts +5 -5
  61. package/templates/webcomponents/igc-ts/constants.js +5 -5
  62. package/templates/webcomponents/igc-ts/projects/_base/files/package.json +1 -1
  63. package/templates/webcomponents/igc-ts/projects/_base_with_home/files/package.json +6 -6
  64. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/mcp-setup.md +0 -78
  65. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/mcp-setup.md +0 -78
  66. package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/references/mcp-setup.md +0 -81
  67. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/CHARTS-GRIDS.md +0 -398
  68. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/COMPONENT-CATALOGUE.md +0 -161
  69. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/EVENT-HANDLING.md +0 -72
  70. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/INSTALLATION.md +0 -139
  71. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/JSX-PATTERNS.md +0 -187
  72. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/MCP-SERVER.md +0 -77
  73. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/REFS-FORMS.md +0 -232
  74. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/reference/MCP-SERVER.md +0 -67
  75. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/reference/TROUBLESHOOTING.md +0 -35
  76. package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/reference/component-mapping.md +0 -132
@@ -1,232 +0,0 @@
1
- # Refs & Forms
2
-
3
- ## Refs & Imperative API
4
-
5
- Use `useRef` to access the underlying web component element and call imperative methods (e.g., showing/hiding a dialog, focusing an input).
6
- Components from `igniteui-react`, `igniteui-react-grids` and `igniteui-react-dockmanager` are React Function Components forward the native element to `useRef` and expose alias with the same name for accessing the custom element API:
7
-
8
- ```tsx
9
- import { useRef } from 'react';
10
- import { IgrDialog, IgrButton, IgrInput } from 'igniteui-react';
11
-
12
- function MyPage() {
13
- const dialogRef = useRef<IgrDialog>(null);
14
- const inputRef = useRef<IgrInput>(null);
15
-
16
- const openDialog = () => {
17
- // Access the underlying web component and call its methods
18
- dialogRef.current?.show();
19
- };
20
-
21
- const focusInput = () => {
22
- inputRef.current?.focus();
23
- };
24
-
25
- return (
26
- <>
27
- <IgrButton onClick={openDialog}>
28
- <span>Open Dialog</span>
29
- </IgrButton>
30
-
31
- <IgrDialog ref={dialogRef} title="Confirmation">
32
- <p>Are you sure?</p>
33
- <IgrButton slot="footer" onClick={() => dialogRef.current?.hide()}>
34
- <span>Close</span>
35
- </IgrButton>
36
- </IgrDialog>
37
-
38
- <IgrButton onClick={focusInput}>
39
- <span>Focus Input</span>
40
- </IgrButton>
41
- <IgrInput ref={inputRef} label="Name" />
42
- </>
43
- );
44
- }
45
- ```
46
-
47
- > **Tip:** The ref gives you direct access to the web component's DOM element. You can call any method documented in the web component API.
48
-
49
-
50
- ## Uncontrolled Components
51
-
52
- `igniteui-react` Form elements like Inputs, Select, Checkbox, etc., integrate with the native form handling through Element internals, allowing to take advantage of the native state management and validation to create intuitive, straightforward forms. Use the `name` attribute to register the field value with `FormData`:
53
-
54
- ```tsx
55
- import { IgrInput, IgrSelect, IgrSelectItem, IgrButton } from 'igniteui-react';
56
-
57
- function SimpleForm() {
58
- const handleSubmit = (e: React.SubmitEvent<HTMLFormElement>) => {
59
- // e.preventDefault(); // optionally prevent default submit for custom handling
60
- const formData = new FormData(e.currentTarget);
61
- console.log(formData.get('name')); // input value
62
- console.log(formData.get('role')); // selected option value
63
- };
64
-
65
- return (
66
- <form onSubmit={handleSubmit}>
67
- <IgrInput name="name" label="Name" required={true} />
68
- <IgrSelect name="role" label="Role" required={true}>
69
- <IgrSelectItem value="user">User</IgrSelectItem>
70
- <IgrSelectItem value="admin">Admin</IgrSelectItem>
71
- <IgrSelectItem value="editor">Editor</IgrSelectItem>
72
- </IgrSelect>
73
- <IgrButton type="submit">
74
- <span>Submit</span>
75
- </IgrButton>
76
- </form>
77
- );
78
- }
79
- ```
80
-
81
- ## Controlled Components with `useState`
82
-
83
- Wire up Ignite UI form components with React state for controlled behavior:
84
-
85
- ```tsx
86
- import { useState } from 'react';
87
- import { IgrInput, IgrCheckbox, IgrSelect, IgrSelectItem, IgrCheckboxChangeEventArgsDetail } from 'igniteui-react';
88
-
89
- function ProfileForm() {
90
- const [name, setName] = useState('');
91
- const [newsletter, setNewsletter] = useState(false);
92
- const [role, setRole] = useState('user');
93
-
94
- return (
95
- <form>
96
- <IgrInput
97
- label="Name"
98
- value={name}
99
- onInput={(e: CustomEvent<string>) => setName(e.detail) }
100
- />
101
-
102
- <IgrCheckbox
103
- checked={newsletter}
104
- onChange={(e: CustomEvent<IgrCheckboxChangeEventArgsDetail>) =>
105
- setNewsletter(e.detail.checked)
106
- }
107
- >
108
- Subscribe to newsletter
109
- </IgrCheckbox>
110
-
111
- <IgrSelect
112
- label="Role"
113
- value={role}
114
- onChange={(e: CustomEvent<IgrSelectItem>) =>
115
- setRole(e.detail.value)
116
- }
117
- >
118
- <IgrSelectItem value="user">User</IgrSelectItem>
119
- <IgrSelectItem value="admin">Admin</IgrSelectItem>
120
- <IgrSelectItem value="editor">Editor</IgrSelectItem>
121
- </IgrSelect>
122
- </form>
123
- );
124
- }
125
- ```
126
-
127
- ## React Hook Form Integration
128
-
129
- Ignite UI components are form-associated web components. You can integrate them with React Hook Form using `Controller`:
130
-
131
- ```tsx
132
- import { useForm, Controller } from 'react-hook-form';
133
- import { IgrInput, IgrCheckbox, IgrButton, IgrCheckboxChangeEventArgsDetail } from 'igniteui-react';
134
-
135
- interface FormData {
136
- email: string;
137
- acceptTerms: boolean;
138
- }
139
-
140
- function SignUpForm() {
141
- const { control, handleSubmit, formState: { errors } } = useForm<FormData>();
142
-
143
- const onSubmit = (data: FormData) => {
144
- console.log(data);
145
- };
146
-
147
- return (
148
- <form onSubmit={handleSubmit(onSubmit)}>
149
- <Controller
150
- name="email"
151
- control={control}
152
- rules={{ required: 'Email is required' }}
153
- render={({ field }) => (
154
- <IgrInput
155
- label="Email"
156
- type="email"
157
- value={field.value || ''}
158
- onInput={(e: CustomEvent<string>) =>
159
- field.onChange(e.detail)
160
- }
161
- onBlur={() => field.onBlur()}
162
- invalid={!!errors.email}
163
- />
164
- )}
165
- />
166
- {errors.email && <span>{errors.email.message}</span>}
167
-
168
- <Controller
169
- name="acceptTerms"
170
- control={control}
171
- rules={{ required: 'You must accept the terms' }}
172
- render={({ field }) => (
173
- <IgrCheckbox
174
- checked={field.value || false}
175
- onChange={(e: CustomEvent<IgrCheckboxChangeEventArgsDetail>) =>
176
- field.onChange(e.detail.checked)
177
- }
178
- >
179
- I accept the terms and conditions
180
- </IgrCheckbox>
181
- )}
182
- />
183
-
184
- <IgrButton type="submit">
185
- <span>Sign Up</span>
186
- </IgrButton>
187
- </form>
188
- );
189
- }
190
- ```
191
-
192
- ## TypeScript
193
-
194
- ### Importing Component Types
195
-
196
- Each component exports its props interface. Import and use them for type-safe code:
197
-
198
- ```tsx
199
- import { IgrButton, IgrInput } from 'igniteui-react';
200
- import type { ComponentProps } from 'react';
201
-
202
- // Get the props type for a component
203
- type ButtonProps = ComponentProps<typeof IgrButton>;
204
- type InputProps = ComponentProps<typeof IgrInput>;
205
-
206
- // Use in your own components
207
- interface FormFieldProps {
208
- label: string;
209
- inputProps?: Partial<InputProps>;
210
- }
211
-
212
- function FormField({ label, inputProps }: FormFieldProps) {
213
- return (
214
- <div>
215
- <IgrInput label={label} {...inputProps} />
216
- </div>
217
- );
218
- }
219
- ```
220
-
221
- ### Auto-complete
222
-
223
- IDEs with TypeScript support will provide auto-complete for all `Igr*` component props. Make sure your `tsconfig.json` includes:
224
-
225
- ```json
226
- {
227
- "compilerOptions": {
228
- "jsx": "react-jsx",
229
- "moduleResolution": "bundler"
230
- }
231
- }
232
- ```
@@ -1,67 +0,0 @@
1
- # Ignite UI Theming MCP Server
2
-
3
- The Ignite UI Theming MCP server enables AI assistants to generate production-ready theming code. It must be configured in your editor before the theming tools become available.
4
-
5
- > **AGENT INSTRUCTION — MCP Server Setup (REQUIRED)**
6
- >
7
- > Before using any theming tools, you MUST verify the MCP server is available
8
- > by calling `detect_platform`. If the tool is not available or the call fails,
9
- > configure it by following the setup steps below.
10
-
11
- ## VS Code Setup
12
-
13
- Create or edit `.vscode/mcp.json` in your project:
14
-
15
- ```json
16
- {
17
- "servers": {
18
- "igniteui-theming": {
19
- "command": "npx",
20
- "args": ["-y", "igniteui-theming", "igniteui-theming-mcp"]
21
- }
22
- }
23
- }
24
- ```
25
-
26
- ## Cursor Setup
27
-
28
- Create or edit `.cursor/mcp.json`:
29
-
30
- ```json
31
- {
32
- "mcpServers": {
33
- "igniteui-theming": {
34
- "command": "npx",
35
- "args": ["-y", "igniteui-theming", "igniteui-theming-mcp"]
36
- }
37
- }
38
- }
39
- ```
40
-
41
- ## Claude Desktop Setup
42
-
43
- Edit the Claude Desktop config file:
44
- - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
45
- - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
46
-
47
- ```json
48
- {
49
- "mcpServers": {
50
- "igniteui-theming": {
51
- "command": "npx",
52
- "args": ["-y", "igniteui-theming", "igniteui-theming-mcp"]
53
- }
54
- }
55
- }
56
- ```
57
-
58
- ## WebStorm / JetBrains IDEs Setup
59
-
60
- 1. Go to **Settings → Tools → AI Assistant → MCP Servers**
61
- 2. Click **+ Add MCP Server**
62
- 3. Set Command to `npx` and Arguments to `igniteui-theming igniteui-theming-mcp`
63
- 4. Click OK and restart the AI Assistant
64
-
65
- ## File Safety Rule
66
-
67
- > **IMPORTANT — File Safety Rule**: When generating theme code, **never overwrite existing style files directly**. Always propose changes as an update and let the user review before writing to disk.
@@ -1,35 +0,0 @@
1
- # Theming Troubleshooting
2
-
3
- ## Issue: Theme overrides not taking effect
4
-
5
- **Cause:** Override CSS is loaded before the theme CSS.
6
-
7
- **Solution:** Make sure your custom CSS is imported *after* the theme:
8
-
9
- ```tsx
10
- // main.tsx
11
- import 'igniteui-webcomponents/themes/light/bootstrap.css'; // Theme first
12
- import './custom-overrides.css'; // Overrides second
13
- ```
14
-
15
- ## Issue: CSS custom properties not recognized by TypeScript in inline styles
16
-
17
- **Solution:** Cast to `React.CSSProperties`:
18
-
19
- ```tsx
20
- <div style={{ '--ig-primary-h': '260deg' } as React.CSSProperties}>
21
- ```
22
-
23
- ## Issue: Component-level CSS selectors don't match
24
-
25
- **Cause:** Using React component name instead of web component tag name in CSS.
26
-
27
- **Solution:** Use the underlying web component tag name in CSS selectors:
28
-
29
- ```css
30
- /* ✅ Correct — web component tag */
31
- igc-button { --ig-size: 1; }
32
-
33
- /* ❌ Wrong — React wrapper name */
34
- IgrButton { --ig-size: 1; }
35
- ```
@@ -1,132 +0,0 @@
1
- # Ignite UI React Component Mapping Reference
2
-
3
- ## Table of Contents
4
- - [Dashboard & Layout Components](#dashboard--layout-components)
5
- - [Chart Components](#chart-components)
6
- - [Data Display Components](#data-display-components)
7
- - [Form & Input Components](#form--input-components)
8
- - [Calendar & Scheduling Components](#calendar--scheduling-components)
9
- - [Map Components](#map-components)
10
- - [Gauge Components](#gauge-components)
11
- - [Package Requirements](#package-requirements)
12
- - [Import Patterns](#import-patterns)
13
-
14
- > **For component API details** (props, events, slots, examples), call `get_doc` with `'react'` and the doc name from `list_components` results. Use `search_api` for specific property lookup.
15
-
16
- ## Dashboard & Layout Components
17
-
18
- | UI Pattern | Ignite UI Component |
19
- |---|---|
20
- | Top navigation bar | `IgrNavbar` |
21
- | Side navigation | `IgrNavDrawer` |
22
- | Content cards/panels | `IgrCard` |
23
- | Tabbed content | `IgrTabs` + `IgrTab` |
24
- | Accordion sections | `IgrAccordion` |
25
- | Split layouts | `IgrSplitter` |
26
- | Tile dashboard | `IgrTileManager` |
27
-
28
- Decision rule:
29
-
30
- - Use `IgrNavbar` for a top horizontal bar when its slot structure and behavior match the screenshot. Use custom children and CSS flex overrides to achieve multi-zone layouts inside it. Use a plain `<header>` when that is a closer structural fit.
31
- - Use `IgrNavDrawer` for a sidebar or side-navigation panel when drawer structure and behavior match the screenshot. Configure open and mini behavior according to whether the design shows fixed, collapsible, or icon-only navigation. Use a plain `<aside>` when a static custom sidebar matches the screenshot better.
32
- - Use `IgrTabs` for a horizontal tab strip when the screenshot clearly shows tabbed state switching. Use label-only tabs for routed navigation and inline tab content for local view switching.
33
-
34
- ## Chart Components
35
-
36
- | UI Pattern | Ignite UI Component |
37
- |---|---|
38
- | Area chart | `IgrCategoryChart` |
39
- | Line chart | `IgrCategoryChart` |
40
- | Column chart | `IgrCategoryChart` |
41
- | Sparkline (mini chart) | `IgrSparkline` or `IgrDataChart` |
42
- | Pie/donut chart | `IgrPieChart` |
43
- | Financial chart | `IgrFinancialChart` |
44
- | Complex multi-series | `IgrDataChart` |
45
-
46
- Decision rule:
47
-
48
- - Financial or OHLC screenshot: prefer `IgrFinancialChart`
49
- - Simple or moderate trend panel: prefer `IgrCategoryChart`; move to `IgrDataChart` when you need lower-level per-series control
50
- - Highly custom sparkline or microchart: use the sparkline component from `igniteui-react-charts` or a custom fallback if the built-in anatomy is not a close visual match
51
-
52
- ## Data Display Components
53
-
54
- | UI Pattern | Ignite UI Component |
55
- |---|---|
56
- | Item list | `IgrList` |
57
- | User avatar | `IgrAvatar` |
58
- | Status badge | `IgrBadge` |
59
- | Icons | `IgrIcon` |
60
- | Progress bar | `IgrLinearProgress` |
61
- | Circular progress | `IgrCircularProgress` |
62
- | Flat data grid | `IgrGridLite` or `IgrGrid` |
63
- | Hierarchical/tree data grid | `IgrTreeGrid` |
64
- | Filter/tag chips | `IgrChip` |
65
-
66
- Decision rule:
67
-
68
- - Use `IgrList` for repeated-row content lists when its row structure and interaction model match the screenshot. The component adds accessible keyboard navigation, item structure, and theming when those benefits fit the design. Use native `<ul>/<li>` or custom containers when they are a closer visual fit.
69
- - Choose `IgrGridLite` or `IgrGrid` only when the image is truly tabular (flat rows and columns, spreadsheet-style).
70
- - Choose `IgrTreeGrid` when rows have parent-child or hierarchical structure.
71
- - Use `IgrChip` when chip anatomy matches the screenshot's status badges, tags, or label pills. Use custom badge or pill markup when a simpler or more exact visual match is needed.
72
-
73
- ## Form & Input Components
74
-
75
- | UI Pattern | Ignite UI Component |
76
- |---|---|
77
- | Text input | `IgrInput` |
78
- | Dropdown select | `IgrSelect` |
79
- | Searchable multi-select | `IgrCombo` |
80
- | Date picker | `IgrDatePicker` |
81
- | Date/time input | `IgrDateTimeInput` |
82
- | Toggle switch | `IgrSwitch` |
83
- | Checkbox | `IgrCheckbox` |
84
- | Radio button group | `IgrRadioGroup` + `IgrRadio` |
85
- | Slider | `IgrSlider` |
86
- | Multi-step wizard | `IgrStepper` |
87
- | Chip filter bar | `IgrChip` collection in a flex wrapper |
88
-
89
- ## Calendar & Scheduling Components
90
-
91
- | UI Pattern | Ignite UI Component |
92
- |---|---|
93
- | Calendar view | `IgrCalendar` |
94
- | Date range picker | `IgrDateRangePicker` |
95
- | Month/year picker | `IgrCalendar` |
96
-
97
- ## Map Components
98
-
99
- | UI Pattern | Ignite UI Component |
100
- |---|---|
101
- | World map | `IgrGeographicMap` |
102
- | Map markers | `IgrGeographicSymbolSeries` |
103
- | Bubble overlay | `IgrGeographicProportionalSymbolSeries` |
104
- | Shape regions | `IgrGeographicShapeSeries` |
105
-
106
- ## Gauge Components
107
-
108
- | UI Pattern | Ignite UI Component |
109
- |---|---|
110
- | Linear gauge | `IgrLinearGauge` |
111
- | Radial gauge | `IgrRadialGauge` |
112
- | Bullet graph | `IgrBulletGraph` |
113
-
114
- ## Package Requirements
115
-
116
- The main `igniteui-react` package contains core UI components (list, avatar, navbar, nav drawer, card, badge, progress, icon, etc.).
117
-
118
- Additional component families may require **additional packages** beyond the main React package:
119
-
120
- | Capability | Additional packages |
121
- |---|---|
122
- | Grid Lite | `igniteui-react` and `igniteui-grid-lite` |
123
- | Advanced grids | `igniteui-react-grids` or `@infragistics/igniteui-react-grids` |
124
- | Charts / sparklines | `igniteui-react-charts` or `@infragistics/igniteui-react-charts` |
125
- | Maps | `igniteui-react-maps` or `@infragistics/igniteui-react-maps` |
126
- | Gauges / bullet graphs | `igniteui-react-gauges` or `@infragistics/igniteui-react-gauges` |
127
-
128
- Install only the packages required by the components you actually selected. Resolve the exact package version against the installed Ignite UI major and the actual published package versions before installing. Charts, maps, and gauges also require module registration in React files.
129
-
130
- ## Import Patterns
131
-
132
- Treat this file as a component selection reference, not as authoritative import guidance for a specific repo. Confirm exact imports from the current workspace, the existing React skills, and `get_doc` results. For styling selectors, target the rendered `igc-*` tag names instead of the React `Igr*` component names.