igniteui-angular 21.2.0-rc.2 → 21.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "igniteui-angular",
-  "version": "21.2.0-rc.2",
+  "version": "21.2.0",
   "description": "Ignite UI for Angular is a dependency-free Angular toolkit for building modern web apps",
   "author": "Infragistics",
   "license": "SEE LICENSE IN LICENSE",
@@ -104,7 +104,7 @@
     }
   },
   "igxDevDependencies": {
-    "@igniteui/angular-schematics": "~21.1.1490"
+    "@igniteui/angular-schematics": "~21.2.1500"
   },
   "ng-update": {
     "migrations": "./migrations/migration-collection.json",

package/skills/igniteui-angular-components/references/charts.md

@@ -57,7 +57,7 @@ chartComponent.itemsSource = dataArray;
 
 ### Chart Type Selection
 - **Category Chart**: `chartType` property (Auto, Area, Column, Line, Point, etc.)
-- **Financial Chart**: `chartType` property (Line, Candlestick, OHLC Bar)
+- **Financial Chart**: `chartType` property (Auto, Candle, Line, Bar, Column)
 - **Data Chart**: Configure explicit series (IgxAreaSeriesComponent, IgxBarSeriesComponent, IgxBarSeries, etc.)
 - **Pie Chart**: No chartType needed; inherent pie structure
 
@@ -75,6 +75,7 @@ chartComponent.itemsSource = dataArray;
 
 **IgxFinancialChartComponent** (stock data):
 - `dataSource` — Data array with date + OHLC columns
+- `chartType` — Chart type (Auto, Candle, Line, Bar, Column)
 - `openMemberPath`, `highMemberPath`, `lowMemberPath`, `closeMemberPath` — OHLC field names
 
 **IgxPieChartComponent**:
@@ -184,9 +185,9 @@ chartComponent.itemsSource = dataArray;
   - **Volume Pane**: Show trading volume (column, line, or area chart)
   - **Indicator Pane**: Financial indicators (RSI, MACD, Bollinger Bands, etc.)
   - **Zoom Pane**: Navigation slider to zoom/pan
-- **Chart Types**: `Line`, `Candlestick` (default), `OHLC Bar`, `Column`
+- **Chart Types**: `Auto` (default), `Candle`, `Line`, `Bar`, `Column`
 - **API**:
-  - `chartType` — Price display type (Line, Candlestick, OHLC, Column — default Auto)
+  - `chartType` — Price display type (Auto, Line, Candle, Bar, Column)
   - `volumeType` — Volume display (None, Column, Line, Area)
   - `indicatorTypes` — Array of indicators (0 or more)
   - `zoomSliderType` — Zoom pane display (defaults to match chartType)
@@ -257,7 +258,7 @@ transitionInDuration: number;           // Animation duration (milliseconds)
 
 ### IgxFinancialChartComponent (Stock/Candlestick/OHLC)
 ```typescript
-chartType: FinancialChartType; // Line, Candlestick, OHLC, Column
+chartType: FinancialChartType; // Auto, Line, Candle, Bar, Column
 itemsSource: any[];
 openMemberPath: string;
 highMemberPath: string;

package/skills/igniteui-angular-generate-from-image-design/SKILL.md

@@ -0,0 +1,226 @@
+---
+name: igniteui-angular-generate-from-image-design
+description: Implement Angular application views from design images using Ignite UI Angular components. Uses MCP servers (igniteui-cli, igniteui-theming, angular-cli) to discover components, generate themes, and follow best practices. Triggers when the user provides a design image (screenshot, mockup, wireframe) and wants it built as a working Angular view with igniteui-angular components. Also triggers when the user asks to "implement this design", "build this UI", "convert this mockup", or "create a page from this image" in an Ignite UI Angular project.
+user-invocable: true
+---
+
+# Implementing Ignite UI Angular Views from Design Images
+
+## MANDATORY AGENT PROTOCOL
+
+Before writing any implementation code, you must complete these steps in order:
+
+1. Analyze the image and identify all visible regions and UI patterns.
+2. Read [references/component-mapping.md](references/component-mapping.md) and [references/gotchas.md](references/gotchas.md).
+3. This skill is Angular-only. Check package layout or licensing only when imports, packages, or theming depend on it.
+4. To apply a theme, use the theming workflow from this skill and the dedicated `igniteui-angular-theming` skill; use the `igniteui-theming` MCP tools instead of styling from memory.
+5. Call `get_doc` for every chosen component family before using it.
+6. Only then start coding.
+
+## Workflow
+
+1. **Analyze the design image** - Read the image, identify every UI section, component, layout structure.
+2. **Confirm package layout if needed** - this skill is Angular-only; check package layout or licensing only when imports, packages, or theming depend on it
+3. **Discover components** - Call `list_components` with targeted filters to find matching components for each UI pattern
+4. **Look up component docs** - Call `get_doc` for every chosen component family before coding
+5. **Generate theme** - (a) To generate a theme, first extract colors and create a color palette using `create_palette` or `create_custom_palette` depending on the scenario. Then extract elevations and call `create_elevations`. Then extract typography and call `create_typography`. Then call `create_theme` with the palette, elevations, and typography. (b) After a theme exists, prefer using design tokens or scoped semantic CSS variables over raw literals. (c) For every Ignite UI component, call `get_component_design_tokens`, map extracted image tokens to token roles, then call `create_component_theme` with the tokens differing from the global theme for the specific component.
+6. **Implement** - Build the screenshot-first layout, data, and view components
+7. **Refine** - Use the `set_size`, `set_spacing`, `set_roundness` tools to refine the view's visual fidelity against the image, then iterate on implementation and theming until the view matches the design closely
+8. **Validate** - Build, test, run, compare against the image, and fix differences
+
+## Step 1: Analyze the Design Image
+
+Read the input image carefully. For each visual section, identify:
+
+- **Layout structure**: grid rows/columns, sidebar, navbar, content area proportions, and estimated fixed widths or percentages for major regions.
+> Note: Do not guess the exact CSS properties at this stage; just identify the high-level structure and relative proportions. Do not try to fit the view into exact breakpoints or pixel values. Try to generate a flexible layout that preserves the observed proportions and can adapt to different screen sizes. You will refine the exact CSS rules in Step 8 after building a first version of the view.
+- **Component type**: chart, list, card, map, gauge, table, form, etc.
+- **Color palette**: primary, secondary, surface/background, accent, text colors
+- **Typography**: font sizes, weights, letter-spacing patterns
+- **Surface styling**: borders, border-radius, shadows, elevation, divider treatments
+- **Data patterns**: what mock data is needed (time series, lists, KPIs, geographic)
+- **Spacing system**: translate observed padding and gaps into a small reusable scale derived from the design
+
+Before writing code, create a decomposition table with one row per visible region containing:
+
+| Region | Visual role | Candidate component | Custom CSS required | Data type |
+|---|---|---|---|---|
+| Example: sidebar item list | repeated rows with icon + label | `IgxListComponent` | yes - item height, icon size | domain-appropriate mock data |
+| Example: top bar | brand + tabs + search | `IgxNavbarComponent` | yes - multi-zone flex layout | n/a |
+| Example: side panel | always-visible navigation | `IgxNavigationDrawerComponent` | yes - width, item styling | n/a |
+
+Start every region with the most appropriate Ignite UI component from [references/component-mapping.md](references/component-mapping.md). Only fall back to plain semantic HTML when the component DOM structure is fundamentally incompatible with the design after CSS overrides are considered. Document the reason for any plain-HTML fallback in a code comment.
+
+Before writing code, produce a compact implementation brief that captures:
+
+- chosen components per region
+- fallback HTML regions
+- theme strategy
+- package needs
+- major assumptions
+
+After the table, translate the image into CSS Grid rows and columns first. Preserve desktop proportions before adding responsive behavior, then define explicit breakpoint stacking rules for smaller screens.
+
+## Step 2-3: Use MCP Tools for Discovery
+
+This skill is Angular-only. Check package layout or licensing only when imports, packages, or theming depend on it.
+
+If you need to confirm package layout or licensing state, act on the result immediately:
+
+- If the project uses Open Source package layout, use `igniteui-angular` for all core imports.
+- If the project is unlicensed or uses Open Source package layout, do not mark any core UI components as blocked or premium-only during implementation.
+- If the result indicates a licensed package layout, follow the licensed import paths shown in the component reference when needed.
+
+Then call `list_components` with `framework: "angular"` and relevant filters to find components matching each UI pattern. Common filters:
+
+- `chart`, `sparkline` - for data visualization
+- `list view`, `card`, `avatar`, `badge` - for data display
+- `nav`, `navbar`, `drawer` - for navigation
+- `progress`, `gauge` - for metrics
+- `map` - for geographic displays
+- `grid` - for tabular data
+
+Use narrow search terms to reduce noisy MCP results. Search for the specific UI pattern you need, such as `list view` instead of `list`.
+
+For component-to-Ignite-UI mapping, see [references/component-mapping.md](references/component-mapping.md).
+
+## Step 4: Look Up Component API
+
+For every chosen component category, call `get_doc` with the doc name from `list_components` results (e.g., `name: "card"`, `framework: "angular"`). Use the doc `name` field from the MCP results, not the result title shown in the list. This is mandatory before coding and gives exact usage patterns, inputs, and template structure.
+
+Call `search_docs` for feature-based questions (e.g., "how to configure [component] for [specific behavior or styling need]").
+
+## Step 5: Generate Theme with MCP
+
+Use this skill for the image-to-view theming workflow only. The dedicated [`igniteui-angular-theming`](../igniteui-angular-theming/SKILL.md) skill remains the source of truth for palette-token behavior, global theme rules, and broader theming-system guidance.
+
+### 5a - Existing app guard (always run first)
+
+Before generating any theme code, inspect the project's global stylesheet (typically `styles.scss`). Look for an active `@include theme(...)` or `@include palette(...)` call that already references a palette variable.
+
+- **Existing theme found** -> the global palette is already set. Do **not** call `create_theme` or `create_palette` unless the user explicitly wants a global theme change. Instead:
+  1. Inspect the existing theme definition and any exposed palette tokens or semantic CSS variables
+  2. Reuse the current design system, variant, and palette tokens wherever they already match the design image
+  3. Skip to **5c** and apply only minimal scoped overrides for the new view's components
+- **No theme found / blank/default palette** -> proceed with **5b** to generate a fresh global theme.
+
+### 5b - Global theme generation (new projects only)
+
+Follow this order - MCP guidance first, image extraction second:
+
+1. **Read MCP guidance first** - call `theming://guidance/colors/rules` (or `get_theming_guidance`) before looking at the image. This tells you the available theme inputs and any luminance or variant constraints.
+2. **Resolve the design system** - infer it from the existing workspace, explicit user request, or the closest visual match in the design. Do not assume one if a stronger signal exists.
+3. **Extract from the image** - now that you know the available slots, extract values only for the inputs you actually need.
+4. **Call `create_theme` or `create_palette`** with the extracted seed values:
+
+```
+create_theme({
+  primaryColor: "<color extracted from image for primary slot>",
+  secondaryColor: "<color extracted from image for secondary slot>",
+  surfaceColor: "<color extracted from image for surface/background slot>",
+  variant: "<resolved theme variant>",
+  platform: "angular",
+  licensed: <detected licensing state>,
+  fontFamily: "<font extracted from image or existing app>",
+  designSystem: "<resolved design system>"
+})
+```
+
+Read and act on any luminance warnings returned. If the design needs multiple surface depths that a single generated surface color does not cover, use `create_custom_palette` or define semantic CSS variables for the additional depths in `styles.scss`.
+
+Use `create_palette` for straightforward designs with a small, coherent color system. Use `create_custom_palette` when the design has multiple distinct surface depths, several accent families, or when the generated palette cannot reliably match the screenshot.
+
+### 5c - Per-component token discovery and mapping (always run)
+
+> **Scope:** this step applies only to **core Ignite UI Angular components** (grid, list, navbar, drawer, card, inputs, chips, etc.). DV components - charts, maps, gauges, and sparklines - have no Sass design tokens. Skip this step for them and set their visual properties exclusively via component inputs as described in [references/gotchas.md](references/gotchas.md) and in Step 7.
+
+For **every** core Ignite UI component chosen in Steps 3-4, follow this MCP-first loop - query MCP before touching the image:
+
+1. **Discover (MCP first)** - call `get_component_design_tokens(component)` before looking at the image for that component. Read the full token list with names, types, and descriptions. Identify which tokens correspond to visible surfaces, text, borders, icons, and interaction states.
+2. **Extract (image second)** - now that you know the exact token names, go to the image region for that component and read the exact token value for each relevant token slot. Do not guess; zoom into the component region.
+3. **Generate** - call `create_component_theme(component, platform, licensed, tokens)` passing only the tokens whose resolved value differs from the global theme. This produces scoped SCSS with the minimal override set.
+
+**Example - theming a grid:**
+- `get_component_design_tokens("grid")` returns `header-background`, `content-background`, `row-hover-background` among many others
+- Look at the grid region in the image -> extract the color intent for header, row background, and hover state
+- Resolve each value to a palette token or local semantic CSS variable
+- Call `create_component_theme("grid", ...)` with only `{ "header-background": "<resolved token>", "content-background": "<resolved token>", "row-hover-background": "<resolved token>" }`
+
+Apply the generated theme blocks inside `::ng-deep` scoped to the component selector as shown in the `create_component_theme` output.
+
+Do not run `create_component_theme` for regions built with custom HTML/CSS only.
+
+### 5d - Theming sequence summary
+
+Apply in this exact order:
+
+1. Inspect `styles.scss` -> existing theme or blank?
+2. Create or update a theme: `create_theme` (Step 5b)
+3. For each Ignite UI component: `get_component_design_tokens` -> map image design tokens -> resolve values to design tokens or semantic CSS variables -> `create_component_theme` (Step 5c)
+4. Use `get_color` after palette generation whenever a palette token can represent the final color intent
+
+If you use typography mixins with a comma-separated font family list, wrap the font families in parentheses as described in [references/gotchas.md](references/gotchas.md).
+
+## Step 6: Install DV Packages
+
+Core UI components ship with `igniteui-angular` in Open Source projects and may use `@infragistics/igniteui-angular` in licensed setups. Charts, maps, gauges, and sparklines require additional DV packages. These packages are version-sensitive: determine the installed Ignite UI version, resolve the compatible published DV package version, and install only the package set required by the selected components. See [references/component-mapping.md](references/component-mapping.md) for package names and import patterns.
+
+If DV packages are missing, identify the exact packages and versions required first, then ask for approval before installing packages or changing dependency manifests.
+
+In standalone Angular apps, DV chart, map, and gauge packages are imported via modules in the component `imports` array, not as standalone components.
+
+## Step 7: Implement
+
+### Structure
+
+- **Layout**: use Ignite UI layout and data-display components as the starting point for standard regions, then apply CSS Grid/Flexbox and component overrides to match the screenshot. Only substitute plain semantic HTML when an Ignite UI component remains structurally incompatible after a genuine attempt
+- **Data**: use typed mock data that matches the design's density and domain; add models/services only when they help the implementation
+- **View**: keep layout, spacing, typography, and surface styling in SCSS rather than inline attributes
+- **Theming**: apply the resolved design system and theme variant from Step 5, and keep color usage aligned with palette tokens or local semantic CSS variables
+
+### Implementation Checks
+
+- Follow Angular and repo conventions from `AGENTS.md` and `.github/copilot-instructions.md`
+- Use [references/component-mapping.md](references/component-mapping.md) for component-choice and semantic-fallback rules
+- Use [references/gotchas.md](references/gotchas.md) for components, theming, and API edge cases instead of re-encoding those rules inline
+- Favor Ignite UI components over custom HTML when both approaches can reach similar visual fidelity
+- Import standalone pipes explicitly when their template syntax requires them
+- Preserve spacing, hierarchy, and data density before adding extra interactivity
+- Avoid generic placeholders when the image shows domain-specific content
+- Document brief assumptions when the image is ambiguous instead of silently guessing
+
+## Step 8: Refine
+
+After the first implementation pass, use the `set_size`, `set_spacing`, and `set_roundness` tools to adjust the view's visual properties and close the gap with the image. Focus on the most visually distinctive elements first (e.g., panel proportions, chart shape, button prominence) before tuning smaller details (e.g., row heights, spacing between regions).
+
+## Step 9: Validate
+
+Use this validation loop explicitly:
+
+1. Build
+2. Test
+3. Run the app
+4. Visually compare against the image
+5. Adjust and repeat
+
+In terminal-only environments, the user performs the visual comparison and provides feedback on any mismatches. Only perform the visual check directly when the environment has browser and screenshot capabilities available to the agent.
+
+Use this checklist during the first visual comparison:
+
+- panel proportions
+- control density
+- chart shape
+- legend placement
+- button prominence
+- row heights
+- spacing between regions
+
+Fix TypeScript or template errors immediately during the build/test steps. Use the build output, component docs, [references/gotchas.md](references/gotchas.md), and the user's visual feedback to close the remaining gaps. Typical adjustments include:
+
+- revisiting chart data density, smoothing, or marker visibility
+- adjusting layout ratios, region spacing, or row heights
+- correcting navigation mode, panel chrome, or component choice
+- tuning map/filter treatment and dark-surface hierarchy
+- re-examining the original design for overlooked sections or missing imports
+
+After the build succeeds with zero errors, refine layout proportions, color values, missing sections, and typography until the view matches closely.

package/skills/igniteui-angular-generate-from-image-design/references/component-mapping.md

@@ -0,0 +1,144 @@
+# Ignite UI Angular Component Mapping Reference
+
+## Table of Contents
+- [Dashboard & Layout Components](#dashboard--layout-components)
+- [Chart Components](#chart-components)
+- [Data Display Components](#data-display-components)
+- [Form & Input Components](#form--input-components)
+- [Calendar & Scheduling Components](#calendar--scheduling-components)
+- [Map Components](#map-components)
+- [Gauge Components](#gauge-components)
+- [Package Requirements](#package-requirements)
+- [Import Patterns](#import-patterns)
+
+## Dashboard & Layout Components
+
+| UI Pattern | Ignite UI Component | Key Properties |
+|---|---|---|
+| Top navigation bar | `IgxNavbarComponent` | `igxNavbarAction`, `igxNavbarTitle` |
+| Side navigation | `IgxNavigationDrawerComponent` | `[pin]`, `[pinThreshold]`, `igxDrawer` template, `igxDrawerMini` template |
+| Content cards/panels | `IgxCardComponent` | `igxCardHeader`, `igxCardContent`, `igxCardActions` |
+| Tabbed content | `IgxBottomNavComponent` or `IgxTabsComponent` | Panel-based or router-based |
+| Accordion sections | `IgxAccordionComponent` | `IgxExpansionPanelComponent` children |
+| Split layouts | `IgxSplitterComponent` | Horizontal/vertical panes |
+| Tile dashboard | `IgxTileManagerComponent` | Drag/resize tiles (Premium) |
+
+Decision rule:
+
+- Use `IgxNavbarComponent` for a top horizontal bar when its slot structure and behavior match the screenshot. Use custom projected content and CSS flex overrides to achieve multi-zone layouts inside it. Use a plain `<header>` when that is a closer structural fit.
+- Use `IgxNavigationDrawerComponent` for a sidebar or side-navigation panel when drawer structure and behavior match the screenshot. Configure pinning and mini mode 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.
+- Use `IgxTabsComponent` for a horizontal tab strip when the screenshot clearly shows tabbed state switching.
+
+Component decision matrix (by visual pattern, domain-neutral):
+
+| Visual Pattern | Recommended Component | Notes |
+|---|---|---|
+| Repeated rows with icon/text/action | `IgxListComponent` + `IgxListItemComponent` | Use when the row anatomy and interaction model match; use `igxListLine`, `igxListThumbnail`, `igxListAction` slots. Use native `<ul>/<li>` or custom containers when that is a closer visual fit |
+| Spreadsheet-like editable or sortable table | `IgxGridComponent` | Use only when content is truly tabular |
+| Hierarchical or tree-structured table | `IgxTreeGridComponent` | Use when rows have parent-child relationships |
+| Content blocks / summary cards | `IgxCardComponent` | Use when card chrome helps match the panel shape and structure. Use `igxCardHeader`, `igxCardContent`, `igxCardActions` slots with custom projected content. Use plain `<div>` containers for flat or highly custom tiles |
+| Any text input field | `IgxInputGroupComponent` + `IgxInputDirective` | Use when the input anatomy matches the screenshot, including search fields and inline editors. Apply CSS to match the screenshot's border/radius style |
+| Dropdown or select | `IgxSelectComponent` | Use when the screenshot clearly shows select/dropdown behavior |
+| Form fields with labels and inputs | `IgxInputGroupComponent`, `IgxSelectComponent`, `IgxComboComponent` | Cover text, select, combo, and date inputs |
+| Multi-step form / wizard | `IgxStepperComponent` | Use when a sequence of steps is visually present |
+| Filter chips / tag inputs | `IgxChipComponent` | Use when chip anatomy matches status badges, filter tags, or removable labels in the screenshot |
+| Calendar or date picker as a primary view element | `IgxCalendarComponent`, `IgxDatePickerComponent` | Use when scheduling or date selection is the core UI |
+| Top icon/action bar | `IgxNavbarComponent` with projected icon buttons | Use when a navbar structure matches the screenshot; use plain icon buttons or custom containers when that is a closer fit |
+
+## Chart Components
+
+| UI Pattern | Ignite UI Component | Key Properties |
+|---|---|---|
+| Area chart | `IgxCategoryChartComponent` | `chartType`, `markerTypes`, `areaFillOpacity` |
+| Line chart | `IgxCategoryChartComponent` | `chartType`, `markerTypes` |
+| Column/bar chart | `IgxCategoryChartComponent` | `chartType`, `markerTypes` |
+| Sparkline (mini chart) | `IgxSparklineComponent` | `displayType`, `valueMemberPath` |
+| Pie/donut chart | `IgxPieChartComponent` / `IgxDoughnutChartComponent` | `valueMemberPath`, `labelMemberPath` |
+| Financial chart | `IgxFinancialChartComponent` | OHLC/candlestick data |
+| Complex multi-series | `IgxDataChartComponent` | Multiple series + axes |
+
+Decision rule:
+
+- Financial or OHLC screenshot: prefer `IgxFinancialChartComponent`
+- Simple or moderate trend panel: prefer `IgxCategoryChartComponent`; move to `IgxDataChartComponent` when you need lower-level per-series control
+- Highly custom sparkline or microchart: use `IgxSparklineComponent` or a custom fallback if the built-in anatomy is not a close visual match
+
+## Data Display Components
+
+| UI Pattern | Ignite UI Component | Key Properties |
+|---|---|---|
+| Item list | `IgxListComponent` + `IgxListItemComponent` | `igxListLine`, `igxListThumbnail`, `igxListAction` |
+| User avatar | `IgxAvatarComponent` | `[initials]`, `shape`, `size` |
+| Status badge | `IgxBadgeComponent` | `[value]`, `type` |
+| Icons | `IgxIconComponent` | icon name, family, styling |
+| Progress bar | `IgxLinearProgressBarComponent` | `[value]`, `[max]` |
+| Circular progress | `IgxCircularProgressBarComponent` | `[value]`, `[max]` |
+| Flat data grid | `IgxGridComponent` | Full-featured data grid |
+| Hierarchical/tree data grid | `IgxTreeGridComponent` | `primaryKey`, `foreignKey`, `childDataKey` |
+| Filter/tag chips | `IgxChipComponent` | `[removable]`, `[selectable]`, `chipClick` |
+
+Decision rule:
+
+- Use `IgxListComponent` 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.
+- Choose `IgxGridComponent` only when the image is truly tabular (flat rows and columns, spreadsheet-style).
+- Choose `IgxTreeGridComponent` when rows have parent-child or hierarchical structure.
+- Use `IgxChipComponent` 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.
+
+## Form & Input Components
+
+| UI Pattern | Ignite UI Component | Key Properties |
+|---|---|---|
+| Text input | `IgxInputGroupComponent` + `IgxInputDirective` | `igxInput`, `igxLabel`, `igxHint` |
+| Dropdown select | `IgxSelectComponent` | `<igx-select-item>` children |
+| Searchable multi-select | `IgxComboComponent` | `[data]`, `displayKey`, `valueKey` |
+| Date picker | `IgxDatePickerComponent` | `[value]`, `(valueChange)` |
+| Time picker | `IgxTimePickerComponent` | `[value]`, `(valueChange)` |
+| Toggle switch | `IgxSwitchComponent` | value binding, change events |
+| Checkbox | `IgxCheckboxComponent` | value binding, `[indeterminate]` |
+| Radio button group | `IgxRadioGroupDirective` + `IgxRadioComponent` | `name` |
+| Slider | `IgxSliderComponent` | `[minValue]`, `[maxValue]`, `[type]` |
+| Multi-step wizard | `IgxStepperComponent` + `IgxStepComponent` | `orientation`, `[linear]` |
+| Chip filter bar | `IgxChipsAreaComponent` + `IgxChipComponent` | `(reorder)`, `(remove)` |
+
+## Calendar & Scheduling Components
+
+| UI Pattern | Ignite UI Component | Key Properties |
+|---|---|---|
+| Calendar view | `IgxCalendarComponent` | `selection`, `[value]`, `(selected)` |
+| Date range picker | `IgxDateRangePickerComponent` | `[value]`, `(rangeSelected)` |
+| Month/year picker | `IgxCalendarComponent` | `view="decade"` or `view="year"` |
+
+## Map Components
+
+| UI Pattern | Ignite UI Component | Key Properties |
+|---|---|---|
+| World map | `IgxGeographicMapComponent` | `[zoomable]`, `backgroundContent` |
+| Map markers | `IgxGeographicSymbolSeriesComponent` | `latitudeMemberPath`, `longitudeMemberPath`, `markerType`, `markerBrush` |
+| Bubble overlay | `IgxGeographicProportionalSymbolSeriesComponent` | Sized markers |
+| Shape regions | `IgxGeographicShapeSeriesComponent` | Polygon rendering |
+
+## Gauge Components
+
+| UI Pattern | Ignite UI Component | Key Properties |
+|---|---|---|
+| Linear gauge | `IgxLinearGaugeComponent` | `[value]`, `[minimumValue]`, `[maximumValue]`, `[needleBrush]` |
+| Radial gauge | `IgxRadialGaugeComponent` | `[value]`, `[minimumValue]`, `[maximumValue]` |
+| Bullet graph | `IgxBulletGraphComponent` | Performance vs target |
+
+## Package Requirements
+
+The main `igniteui-angular` package contains core UI components in Open Source projects (list, avatar, navbar, drawer, card, badge, progress, icon, etc.). Licensed projects may use `@infragistics/igniteui-angular` instead.
+
+Data visualization components may require **additional packages** beyond the main Angular package:
+
+| Capability | Additional packages |
+|---|---|
+| Charts / sparklines | `igniteui-angular-core`, `igniteui-angular-charts` |
+| Maps | `igniteui-angular-core`, `igniteui-angular-maps` |
+| Gauges / bullet graphs | `igniteui-angular-core`, `igniteui-angular-gauges` |
+
+Install only the packages required by the components you actually selected. These are bare-name packages (not `@infragistics/` scoped). Resolve the exact package version against the installed Ignite UI major and the actual published DV package versions before installing.
+
+## Import Patterns
+
+Treat this file as a component selection reference, not as authoritative import guidance for a specific repo. Confirm exact imports from `detect_platform`, the current workspace, Angular best practices, and `get_doc` results.

package/skills/igniteui-angular-generate-from-image-design/references/gotchas.md

@@ -0,0 +1,204 @@
+# Ignite UI Angular Gotchas & Pitfalls
+
+## Table of Contents
+- [Sass Conflicts](#sass-conflicts)
+- [Chart Properties](#chart-properties)
+- [Component Properties](#component-properties)
+- [Theming Pitfalls](#theming-pitfalls)
+- [Map Component](#map-component)
+- [Dark Theme Specifics](#dark-theme-specifics)
+
+## Sass Conflicts
+
+### `contrast()` function collision
+The CSS `contrast()` filter function can collide with `igniteui-theming`'s `contrast()` Sass function. When you need the native CSS function, call it explicitly via `sass:meta`:
+```scss
+@use "sass:meta";
+
+.uses-css-contrast {
+  filter: meta.call(meta.get-function("contrast", $css: true), <contrast-value>);
+}
+```
+Prefer this approach over string escaping when a native CSS function name collides with a Sass function.
+
+### Font family in typography mixin
+Comma-separated font families are parsed as multiple Sass arguments. Wrap in parentheses:
+```scss
+// BAD
+@include typography($font-family: "Primary Font", "Fallback Font", sans-serif);
+
+// GOOD
+@include typography($font-family: ("Primary Font", "Fallback Font", sans-serif));
+```
+Replace `"Primary Font"` and `"Fallback Font"` with the font families extracted from the design image.
+
+## Chart Properties
+
+### Markers shown by default
+Category charts show markers at every data point by default. If the screenshot does not show markers, set `markerTypes` to the matching no-marker option documented for the component:
+```html
+[markerTypes]="<resolvedMarkerTypes>"
+```
+
+`markerTypes` expects values such as `"Circle"` or `"None"`, or an `IgxMarkerTypeCollection`. Do not pass an array of lowercase strings.
+
+### `plotAreaBackground` does NOT exist on `igx-category-chart`
+Use CSS to style the chart container background instead.
+
+### `areaFillOpacity` exists on `IgxCategoryChartComponent` (via domain chart parent)
+It does NOT exist on `IgxSparklineComponent`.
+
+### `includedProperties` must be a bound array
+Use property binding, not a plain string attribute:
+```html
+<igx-category-chart [includedProperties]="['fieldOne', 'fieldTwo', 'fieldThree']"></igx-category-chart>
+```
+Replace `'fieldOne'`, `'fieldTwo'`, etc. with the actual data property names from your mock data.
+
+### Chart callback inputs must use Angular property binding
+Function-valued chart inputs must be bound, not passed as plain attributes:
+```html
+<igx-category-chart [xAxisFormatLabel]="<labelFormatter>"></igx-category-chart>
+```
+
+### Smooth area charts
+For smooth-looking area charts where the data should appear continuous rather than spiky:
+- Increase data density until the line or area reads as continuous at the rendered size
+- Apply smoothing only when the source shape in the design looks smoothed rather than point-to-point
+- Hide markers unless the screenshot clearly shows visible data points
+- Tune fill opacity and label density to match the screenshot instead of relying on a fixed default
+
+### Charts inside CSS Grid can collapse
+In a flexible CSS Grid track, set `min-height: 0` on the grid cell and `height: 100%` on the chart element:
+```scss
+.chart-panel {
+  min-height: 0;
+}
+
+igx-category-chart {
+  display: block;
+  height: 100%;
+}
+```
+
+## Component Properties
+
+### `roundShape` does NOT exist on `IgxAvatarComponent`
+Use the supported `shape` input alone. Do not add `[roundShape]="true"`.
+
+### `IgxListLineDirective` is the directive for `igxListLine`
+It must be imported for list item text content. Confirm the exact package variant and entry point from the workspace and component docs before adding the import.
+
+### Avatar background color via CSS variable
+```html
+<igx-avatar [style.--ig-avatar-background]="color"></igx-avatar>
+```
+
+## Theming Pitfalls
+
+### DV components do NOT inherit Sass theme colors
+Charts, maps, gauges, and sparklines ignore the global Sass theme. Set their visual properties explicitly via component inputs. After a palette exists, prefer palette tokens or local semantic CSS variables over leaving raw color literals in the final template:
+```html
+[brushes]="'<resolved-series-brush>'"
+[outlines]="'<resolved-series-outline>'"
+[xAxisLabelTextColor]="'<resolved-axis-label-color>'"
+[yAxisMajorStroke]="'<resolved-grid-line-color>'"
+```
+
+### Component theme functions
+For core UI component theming, prefer `create_component_theme` and apply the returned theme block as generated by the MCP server.
+
+### Nav drawer width
+Override the drawer aside width via its internal class using the width measured from the design image:
+```scss
+igx-nav-drawer {
+  --ig-nav-drawer-size: <extracted-sidebar-width>; // <- Use this to overwrite the width of the full navdrawer
+  --ig-nav-drawer-size--mini: <extracted-mini-drawer-width>; // <- Use this to overwrite the width of the mini navdrawer
+}
+```
+
+### Dark theme overrides for `IgxGridComponent`
+Grid internals often need explicit dark-theme overrides. Use palette tokens or local semantic CSS variables that map to the design:
+```scss
+:host ::ng-deep igx-grid {
+  .igx-grid__thead,
+  .igx-grid__tr {
+    background: <resolved-surface-token>;
+  }
+
+  .igx-grid__th,
+  .igx-grid__td {
+    color: <resolved-text-token>;
+    border-color: <resolved-border-token>;
+  }
+
+  .igx-grid__tbody {
+    background: <resolved-surface-token>;
+  }
+}
+```
+
+### Read luminance warnings from theme generation
+If `create_theme` returns a luminance warning for a generated surface, do not ignore it. If the design needs multiple surface depths, use `create_custom_palette` or define semantic CSS variables such as `--surface-1` and `--surface-2` in `styles.scss` instead of relying on a single generated surface color.
+
+## Map Component
+
+### Adding markers programmatically
+The geographic map often requires programmatic series setup once the map instance is available:
+```typescript
+const symbolSeries = new IgxGeographicSymbolSeriesComponent();
+symbolSeries.dataSource = locations;
+symbolSeries.latitudeMemberPath = '<latitude-field>';
+symbolSeries.longitudeMemberPath = '<longitude-field>';
+symbolSeries.markerType = <resolvedMarkerType>;
+symbolSeries.markerBrush = '<resolved-accent-color>';
+symbolSeries.markerOutline = '<resolved-accent-color>';
+map.series.add(symbolSeries);
+// Set zoom bounds to match the geographic region visible in the design image
+map.zoomToGeographic({ left: <min-longitude>, top: <top-latitude>, width: <longitude-span>, height: <latitude-span> });
+```
+
+### Dark map styling
+OpenStreetMap tiles are light by default. For dark themes, apply a CSS filter to the container. Adjust the values to match the map tone in the design image:
+```scss
+.map-container {
+  /* tune grayscale (0-1) and brightness (0-1) to match the design */
+  filter: grayscale(<0-1>) brightness(<0-1>);
+}
+```
+
+## Dark Theme Specifics
+
+### Use the resolved dark schema for dark themes
+```scss
+@include theme(
+  $palette: $resolved-palette,
+  $schema: <resolved-dark-schema>
+);
+```
+
+### CSS custom properties for dark panels
+When the design uses multiple dark surface depths (panels, sidebars, cards on a dark background), define reusable semantic tokens using palette references or values derived from the design intent:
+
+```scss
+:root {
+  --surface-primary: <resolved-surface-token>;
+  --surface-secondary: <resolved-surface-token>;
+  --accent-strong: <resolved-accent-token>;
+  --text-primary: <resolved-text-token>;
+  --text-secondary: <resolved-text-token>;
+}
+```
+
+If `create_theme` returns a single surface color that doesn't cover all depth levels visible in the design, define additional surface tokens (`--surface-1`, `--surface-2`, etc.) for each distinct depth.
+
+### Standalone pipes must be imported explicitly
+When using Angular pipes in a standalone component template, add the pipe classes to the component `imports` array:
+```typescript
+import { CurrencyPipe, DatePipe, DecimalPipe } from '@angular/common';
+
+@Component({
+  imports: [DecimalPipe, DatePipe, CurrencyPipe]
+})
+export class <ViewComponent> {}
+```