impact-nova 2.6.0-alpha.0 → 2.6.0

package/dist/llms/rules/migration.js

@@ -1 +1 @@
-export default "# Migration: Impact UI → Impact Nova\n\nGuide for migrating from **Impact UI** (or similar legacy UI) to **Impact Nova**. Use with other Impact Nova MCP tools: `get_component`, `get_installation_and_config`, `get_real_world_patterns`, `validate_snippet`.\n\n---\n\n## 1. Prerequisites & MCP usage\n\n**Impact UI MCP (optional):** If migrating from Impact UI, `impact-ui-mcp-server` can help map legacy component names during transition. Disable it after migration completes.\n\n- **impact-ui-mcp-server** (optional) — Source API: Impact UI component names, props, import paths.\n- **Impact Nova MCP** — Target API: Nova imports, compound components, patterns; validate with `validate_snippet`.\n\n**Impact Nova MCP tools:** `query_components` | `get_component_props` | `get_deprecations` | `get_component` | `get_installation_and_config` | `get_real_world_patterns` | `validate_snippet` | `suggest_components_for_ui`.\n\nBefore migrating: find all usages of the old UI library; choose big-bang or incremental strategy.\n\n---\n\n## 2. Phase 1 — Install and configure Impact Nova\n\n**Dependencies:**\n```bash\nnpm install impact-nova impact-nova-icons\nnpm install react@^19 react-dom@^19\n```\nWith AG Grid: `ag-grid-community@36.0.1 ag-grid-react@36.0.1 ag-grid-enterprise@36.0.1`. Optional charts: `highcharts@^12 highcharts-react-official@^3`. Then `npm uninstall impact-ui` when ready.\n\n**Styles:** In app root: `import 'impact-nova/dist/impact-nova.css';`\n\n**Font (Manrope):** Link in HTML; set `body { font-family: 'Manrope', sans-serif; }` in global CSS.\n\n**i18n:** Wrap app with `<ImpactNovaProviders locale=\"en\">` from `impact-nova/form`. Formatting locales are BCP 47 (`de-DE`, `en-GB`, …). Pass a locale pack (`de` from `impact-nova/locale/de`) for translated chrome. Format with `formatDate` / `formatNumber` from `impact-nova/i18n`. See `impact-nova://i18n`.\n\n**Tailwind (optional):** Preset `impact-nova/tailwind.config.js`; add `node_modules/impact-nova/dist/**/*.js` to `content`.\n\n**Vite:** Add `resolve.dedupe: ['react','react-dom','ag-grid-community','ag-grid-enterprise','ag-grid-react']`.\n\nUse MCP **`get_installation_and_config`** for project-specific steps.\n\n---\n\n## 3. Phase 2 — Component mapping (Impact UI → Impact Nova)\n\nUse **`get_component`** for exact API of each Nova component.\n\n| Legacy (Impact UI / common) | Impact Nova | Import |\n|-----------------------------|-------------|--------|\n| Button | Button | `impact-nova` / `impact-nova/button` |\n| Modal / Dialog | Dialog, AlertDialog, Prompt | `impact-nova`, `impact-nova/prompt` |\n| Slide-out / Drawer | Sheet | `impact-nova/sheet` |\n| Select / Dropdown | Select | `impact-nova/select` |\n| Input, TextField | Input, SmartInput | `impact-nova/input`, `impact-nova/smart-input` |\n| Textarea | Textarea | `impact-nova/textarea` |\n| Checkbox | Checkbox | `impact-nova/checkbox` |\n| Radio group | RadioGroup, RadioGroupItem | `impact-nova/radio-group` |\n| Switch / Toggle | Switch | `impact-nova/switch` |\n| Date picker / range | DatePicker, DateRangePicker, WeekRangePicker, MonthRangePicker | `impact-nova/date-picker` |\n| Tabs | Tabs, TabsList, TabsTrigger, TabsContent | `impact-nova/tabs` |\n| Alert / Banner | Alert, AlertTitle, AlertDescription, AlertIcon | `impact-nova/alert` |\n| Toast / Snackbar | toast, Toaster, useToast | `impact-nova` |\n| Badge / Tag | Badge, Tag, Chips | `impact-nova/badge`, `impact-nova`, `impact-nova/chips` |\n| Loader / Spinner | Loader, LoadingSpinner (icons) | `impact-nova/loader`, `impact-nova-icons` |\n| Accordion | Accordion, AccordionItem, AccordionTrigger, AccordionContent | `impact-nova/accordion` |\n| Sidebar / Nav | Sidebar | `impact-nova/sidebar` |\n| Header / AppBar | Header + subcomponents | `impact-nova/header` |\n| Breadcrumb | Breadcrumb, BreadcrumbList, etc. | `impact-nova/breadcrumb` |\n| Avatar | Avatar, AvatarFallback | `impact-nova/avatar` |\n| Tooltip | Tooltip, TooltipTrigger, TooltipContent | `impact-nova/tooltip` |\n| File upload | FileUpload (composition) | `impact-nova/file-upload` |\n| Data grid / Table | DataTable, AG Grid | `impact-nova`, `impact-nova/ag-grid-react/cell-renderers` |\n| Filter panel / strip | FilterPanel, FilterStrip | `impact-nova/filter-panel`, `impact-nova` |\n| Empty state | EmptyContainer + subcomponents | `impact-nova/empty-container` |\n| Confirmation dialog | Prompt, AlertDialog | `impact-nova/prompt`, `impact-nova` |\n| Nested list / Tree | NestedList | `impact-nova/nested-list` |\n| Chart | Chart | `impact-nova/chart` |\n| Horizontal scroll list | HorizontalScroller | `impact-nova/horizontal-scroller` |\n\nIcons: `impact-nova-icons` (e.g. Pin, Chart, LoadingSpinner) + `createIconResolver` for string lookup.\n\n---\n\n## 4. Phase 3 — Import and API changes\n\n**Imports:** **Prefer subpath imports** in all feature code. Run a codemod or migrate manually:\n\n```tsx\n// Before (barrel)\nimport { Button, Select, DataTable } from 'impact-nova';\n\n// After (subpath — preferred)\nimport { Button } from 'impact-nova/button';\nimport { Select } from 'impact-nova/select';\nimport { DataTable, useDataTable } from 'impact-nova/data-table';\nimport { CheckCircle } from 'impact-nova-icons';\n```\n\nBarrel OK for locale packs: `import { de } from 'impact-nova';`\n\nTypes: `import type { Option } from 'impact-nova/select';`, `import type { SavedTableViewItem } from 'impact-nova/data-table';`, `import type { RowSelectionState } from 'impact-nova/virtualized';`\n\n**API:** Severity/type → `variant` (e.g. `variant=\"destructive\"`). Alert: use AlertTitle, AlertDescription, AlertIcon. Toast: `toast()`, Toaster, useToast. Dialog: compound components; confirmations → Prompt or AlertDialog. Select options: type `Option` from `impact-nova/select`. Prefer compound components (e.g. SheetContent, SheetHeader, SheetTitle, SheetBody, SheetFooter). Use **`validate_snippet`** on snippets.\n\n---\n\n## 5. Phase 4 — Compound patterns\n\nUse **`get_real_world_patterns`** for more detail.\n\n- **Filter UI:** FilterPanel + FilterPanelSidebar, FilterPanelBody, FilterPanelFooter; FilterStrip; types FilterItem, SavedFilterItem, FilterSidebarItem.\n- **Data table + AG Grid:** DataTable, DataTableContent, processBackendColumnDefs, BackendColDef; AG_GRID_CELL_COMPONENTS, LinkCellRenderer from `impact-nova/ag-grid-react/cell-renderers`.\n- **Sheet:** Sheet, SheetContent, SheetHeader, SheetTitle, SheetBody, SheetFooter from `impact-nova/sheet`; pair with react-hook-form.\n- **Empty state:** EmptyContainer, EmptyContainerImage, EmptyContainerTitle, EmptyContainerDescription, EmptyContainerAction.\n- **Toast + Alert:** Toaster + toast()/useToast; Alert + AlertTitle, AlertDescription, AlertIcon from `impact-nova/alert`.\n- **Tabs + NestedList + Accordion:** Tabs components; NestedList + NestedListItem; Accordion components.\n\n---\n\n## 6. Phase 5 — Verification\n\n**Setup:** Impact Nova MCP enabled; keep impact-ui-mcp-server during migration. Nova + peers installed; CSS + Manrope + ImpactNovaProviders; optional Tailwind + Vite dedupe.\n\n**Migration:** All legacy imports → Nova (barrel/subpath); Alert/Toast/Dialog use Nova variants and compounds; Option/MultiValue from `impact-nova/select`; types via `import type`; use tokens and variant/size.\n\n**MCP:** Use `validate_snippet`, `get_component`, `suggest_components_for_ui`.\n\n**Build/tests:** `npm run build`, lint, manual test of forms, filters, tables, toasts, dialogs.\n";
+export default "# Migration: Impact UI → Impact Nova\n\nGuide for migrating from **Impact UI** (or similar legacy UI) to **Impact Nova**. Use with other Impact Nova MCP tools: `get_component`, `get_installation_and_config`, `get_real_world_patterns`, `validate_snippet`.\n\n---\n\n## 1. Prerequisites & MCP usage\n\n**Impact UI MCP (optional):** If migrating from Impact UI, `impact-ui-mcp-server` can help map legacy component names during transition. Disable it after migration completes.\n\n- **impact-ui-mcp-server** (optional) — Source API: Impact UI component names, props, import paths.\n- **Impact Nova MCP** — Target API: Nova imports, compound components, patterns; validate with `validate_snippet`.\n\n**Impact Nova MCP tools:** `query_components` | `get_component_props` | `get_deprecations` | `get_component` | `get_installation_and_config` | `get_real_world_patterns` | `validate_snippet` | `suggest_components_for_ui`.\n\nBefore migrating: find all usages of the old UI library; choose big-bang or incremental strategy.\n\n---\n\n## 2. Phase 1 — Install and configure Impact Nova\n\n**Dependencies:**\n```bash\nnpm install impact-nova impact-nova-icons\nnpm install react@^19 react-dom@^19\n```\nWith AG Grid: `ag-grid-community@36.0.1 ag-grid-react@36.0.1 ag-grid-enterprise@36.0.1`. Optional charts: `highcharts@^12 highcharts-react-official@^3`. Then `npm uninstall impact-ui` when ready.\n\n**Styles:** In app root: `import 'impact-nova/dist/impact-nova.css';`\n\n**Font (Manrope):** Link in HTML; set `body { font-family: 'Manrope', sans-serif; }` in global CSS.\n\n**i18n:** Wrap app with `<ImpactNovaProviders locale=\"en\">` from `impact-nova/form`. Use locale packs (e.g. `de`) for other locales.\n\n**Tailwind (optional):** Preset `impact-nova/tailwind.config.js`; add `node_modules/impact-nova/dist/**/*.js` to `content`.\n\n**Vite:** Add `resolve.dedupe: ['react','react-dom','ag-grid-community','ag-grid-enterprise','ag-grid-react']`.\n\nUse MCP **`get_installation_and_config`** for project-specific steps.\n\n---\n\n## 3. Phase 2 — Component mapping (Impact UI → Impact Nova)\n\nUse **`get_component`** for exact API of each Nova component.\n\n| Legacy (Impact UI / common) | Impact Nova | Import |\n|-----------------------------|-------------|--------|\n| Button | Button | `impact-nova` / `impact-nova/button` |\n| Modal / Dialog | Dialog, AlertDialog, Prompt | `impact-nova`, `impact-nova/prompt` |\n| Slide-out / Drawer | Sheet | `impact-nova/sheet` |\n| Select / Dropdown | Select | `impact-nova/select` |\n| Input, TextField | Input, SmartInput | `impact-nova/input`, `impact-nova/smart-input` |\n| Textarea | Textarea | `impact-nova/textarea` |\n| Checkbox | Checkbox | `impact-nova/checkbox` |\n| Radio group | RadioGroup, RadioGroupItem | `impact-nova/radio-group` |\n| Switch / Toggle | Switch | `impact-nova/switch` |\n| Date picker / range | DatePicker, DateRangePicker, WeekRangePicker, MonthRangePicker | `impact-nova/date-picker` |\n| Tabs | Tabs, TabsList, TabsTrigger, TabsContent | `impact-nova/tabs` |\n| Alert / Banner | Alert, AlertTitle, AlertDescription, AlertIcon | `impact-nova/alert` |\n| Toast / Snackbar | toast, Toaster, useToast | `impact-nova` |\n| Badge / Tag | Badge, Tag, Chips | `impact-nova/badge`, `impact-nova`, `impact-nova/chips` |\n| Loader / Spinner | Loader, LoadingSpinner (icons) | `impact-nova/loader`, `impact-nova-icons` |\n| Accordion | Accordion, AccordionItem, AccordionTrigger, AccordionContent | `impact-nova/accordion` |\n| Sidebar / Nav | Sidebar | `impact-nova/sidebar` |\n| Header / AppBar | Header + subcomponents | `impact-nova/header` |\n| Breadcrumb | Breadcrumb, BreadcrumbList, etc. | `impact-nova/breadcrumb` |\n| Avatar | Avatar, AvatarFallback | `impact-nova/avatar` |\n| Tooltip | Tooltip, TooltipTrigger, TooltipContent | `impact-nova/tooltip` |\n| File upload | FileUpload (composition) | `impact-nova/file-upload` |\n| Data grid / Table | DataTable, AG Grid | `impact-nova`, `impact-nova/ag-grid-react/cell-renderers` |\n| Filter panel / strip | FilterPanel, FilterStrip | `impact-nova/filter-panel`, `impact-nova` |\n| Empty state | EmptyContainer + subcomponents | `impact-nova/empty-container` |\n| Confirmation dialog | Prompt, AlertDialog | `impact-nova/prompt`, `impact-nova` |\n| Nested list / Tree | NestedList | `impact-nova/nested-list` |\n| Chart | Chart | `impact-nova/chart` |\n| Horizontal scroll list | HorizontalScroller | `impact-nova/horizontal-scroller` |\n\nIcons: `impact-nova-icons` (e.g. Pin, Chart, LoadingSpinner) + `createIconResolver` for string lookup.\n\n---\n\n## 4. Phase 3 — Import and API changes\n\n**Imports:** **Prefer subpath imports** in all feature code. Run a codemod or migrate manually:\n\n```tsx\n// Before (barrel)\nimport { Button, Select, DataTable } from 'impact-nova';\n\n// After (subpath — preferred)\nimport { Button } from 'impact-nova/button';\nimport { Select } from 'impact-nova/select';\nimport { DataTable, useDataTable } from 'impact-nova/data-table';\nimport { CheckCircle } from 'impact-nova-icons';\n```\n\nBarrel OK for locale packs: `import { de } from 'impact-nova';`\n\nTypes: `import type { Option } from 'impact-nova/select';`, `import type { SavedTableViewItem } from 'impact-nova/data-table';`, `import type { RowSelectionState } from 'impact-nova/virtualized';`\n\n**API:** Severity/type → `variant` (e.g. `variant=\"destructive\"`). Alert: use AlertTitle, AlertDescription, AlertIcon. Toast: `toast()`, Toaster, useToast. Dialog: compound components; confirmations → Prompt or AlertDialog. Select options: type `Option` from `impact-nova/select`. Prefer compound components (e.g. SheetContent, SheetHeader, SheetTitle, SheetBody, SheetFooter). Use **`validate_snippet`** on snippets.\n\n---\n\n## 5. Phase 4 — Compound patterns\n\nUse **`get_real_world_patterns`** for more detail.\n\n- **Filter UI:** FilterPanel + FilterPanelSidebar, FilterPanelBody, FilterPanelFooter; FilterStrip; types FilterItem, SavedFilterItem, FilterSidebarItem.\n- **Data table + AG Grid:** DataTable, DataTableContent, processBackendColumnDefs, BackendColDef; AG_GRID_CELL_COMPONENTS, LinkCellRenderer from `impact-nova/ag-grid-react/cell-renderers`.\n- **Sheet:** Sheet, SheetContent, SheetHeader, SheetTitle, SheetBody, SheetFooter from `impact-nova/sheet`; pair with react-hook-form.\n- **Empty state:** EmptyContainer, EmptyContainerImage, EmptyContainerTitle, EmptyContainerDescription, EmptyContainerAction.\n- **Toast + Alert:** Toaster + toast()/useToast; Alert + AlertTitle, AlertDescription, AlertIcon from `impact-nova/alert`.\n- **Tabs + NestedList + Accordion:** Tabs components; NestedList + NestedListItem; Accordion components.\n\n---\n\n## 6. Phase 5 — Verification\n\n**Setup:** Impact Nova MCP enabled; keep impact-ui-mcp-server during migration. Nova + peers installed; CSS + Manrope + ImpactNovaProviders; optional Tailwind + Vite dedupe.\n\n**Migration:** All legacy imports → Nova (barrel/subpath); Alert/Toast/Dialog use Nova variants and compounds; Option/MultiValue from `impact-nova/select`; types via `import type`; use tokens and variant/size.\n\n**MCP:** Use `validate_snippet`, `get_component`, `suggest_components_for_ui`.\n\n**Build/tests:** `npm run build`, lint, manual test of forms, filters, tables, toasts, dialogs.\n";

package/dist/llms/rules/real-world-patterns.js

@@ -1 +1 @@
-export default "# Impact Nova — Real-World Patterns (from production apps)\n\nPatterns observed in apps that use Impact Nova extensively (e.g. filter UIs, data tables, sheets, empty states).\n\n---\n\n## 1. Subpath imports (tree-shaking)\n\n**Default for production apps:** use subpath imports. Production apps (e.g. mtp-mfe-itemsmart-v3) migrated to 100% subpath imports — zero barrel `from 'impact-nova'` in feature code. Barrel is OK for i18n bootstrapping only.\n\n| Use case | Import |\n|----------|--------|\n| Layout (app shell) | `import { Layout } from 'impact-nova/layout';` |\n| Sidebar | `import { Sidebar, SidebarProvider, SidebarContent } from 'impact-nova/sidebar';` |\n| Header | `import { Header, HeaderLeft, HeaderRight, HeaderTitle } from 'impact-nova/header';` |\n| Breadcrumb | `import { Breadcrumb, BreadcrumbList, BreadcrumbHeader } from 'impact-nova/breadcrumb';` |\n| Button only | `import { Button } from 'impact-nova/button';` |\n| Combobox | `import { Combobox } from 'impact-nova/combobox';` |\n| Sheet (side panel) | `import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetBody, SheetFooter } from 'impact-nova/sheet';` |\n| Filter panel | `import { FilterPanel, FilterPanelSidebar } from 'impact-nova/filter-panel';` and `FilterPanelBody`, `FilterPanelFooter` |\n| Filter strip | `import { FilterStrip } from 'impact-nova/filter-strip';` |\n| Empty state | `import { EmptyContainer, EmptyContainerImage, EmptyContainerTitle, EmptyContainerDescription, EmptyContainerAction } from 'impact-nova/empty-container';` |\n| Accordion | `import { Accordion, AccordionItem, AccordionTrigger, AccordionContent } from 'impact-nova/accordion';` |\n| Date pickers | `import { DateRangePicker } from 'impact-nova/date-picker';` or `WeekRangePicker`, `MonthRangePicker`. Week range selection language (Wk gutter join, rounded-lg start/end caps) is built into Calendar — do not restyle the grid. |\n| Select | `import { Select } from 'impact-nova/select';` |\n| Data table | `import { DataTable, DataTableContent, DataTableToolbar, useDataTable } from 'impact-nova/data-table';` |\n| Progress bar | `import { ProgressBar } from 'impact-nova/progress-bar';` |\n| Virtualized list hooks | `import { useVirtualizedList, useDebouncedValue } from 'impact-nova/virtualized';` |\n| Expandable list row | `import { ExpandableListItem, type ExpandableListItemSection } from 'impact-nova/expandable-list-item';` |\n| Row selection type | `import type { RowSelectionState } from 'impact-nova/virtualized';` |\n| Alert | `import { Alert, AlertTitle, AlertDescription, AlertIcon } from 'impact-nova/alert';` |\n| Tooltip | `import { Tooltip, TooltipTrigger, TooltipContent } from 'impact-nova/tooltip';` |\n| Icons | `import { Pin, Unpin, Chart } from 'impact-nova-icons';` + `createIconResolver` for dynamic lookup |\n| AG Grid cell renderers | `import { AG_GRID_CELL_COMPONENTS, LinkCellRenderer } from 'impact-nova/ag-grid-react/cell-renderers';` |\n| Prompt | `import { Prompt } from 'impact-nova/prompt';` |\n| Radio group | `import { RadioGroup, RadioGroupItem } from 'impact-nova/radio-group';` |\n| Button group | `import { ButtonGroup } from 'impact-nova/button-group';` |\n| Smart input | `import { SmartInput as InputWrapper } from 'impact-nova/smart-input';` |\n| Chips | `import { Chip } from 'impact-nova/chips';` |\n| Loader | `import { Loader } from 'impact-nova/loader';` |\n\n---\n\n## 2. Type-only imports\n\nUse type-only imports for types to avoid pulling runtime code:\n\n```ts\nimport type { Option, MultiValue, ActionMeta } from 'impact-nova/select';\nimport type { FilterSidebarItem } from 'impact-nova/filter-panel';\nimport type { FilterItem, SavedFilterItem } from 'impact-nova/filter-strip';\nimport type { NestedListItem } from 'impact-nova/nested-list';\nimport type { FileUploadProps } from 'impact-nova/file-upload';\nimport type { BackendColDef } from 'impact-nova';\n```\n\n---\n\n## 3. Compound patterns\n\n### Filter UI (panel + strip)\n\n- **FilterPanel** + **FilterPanelSidebar** for the sliding panel; **FilterPanelBody** and **FilterPanelFooter** for content and Apply/Cancel.\n- **FilterStrip** to show applied filters (chips/tags). Types: `FilterItem`, `SavedFilterItem` from `impact-nova/filter-strip`.\n- Config drives **FilterSidebarItem** (from `impact-nova/filter-panel`); form state often with react-hook-form.\n\n### Data table + AG Grid\n\n**Mandatory (no deviation):** For DataTable or any data table using AG Grid, refer **only** to AG Grid's official documentation, follow **only** AG Grid recommended patterns, and use **only** the AG Grid API for grid operations. See resource `impact-nova://ag-grid-rules` for full rules. If the user has **ag-mcp** installed, use it for AG Grid API/docs and collaborate with this MCP for Impact Nova integration.\n\n- **DataTable**, **DataTableContent**, **DataTableSheet**, **DataTableSheetContent**, **DataTableSheetHeader**, **DataTableSheetBody**, **DataTableSheetSection**, **DataTableSheetTabs**, **DataTableSheetTabsList**, **DataTableSheetTabPanel**, **DataTableColumnList**, **DataTableFormatOptions** from `impact-nova/data-table`.\n- **Settings sheet layout:** Use compound sheet layout components — not raw `Tabs` + manual `overflow-y-auto`. `DataTableSheetTabPanel layout=\"list\"` for column/KPI lists; `layout=\"scroll\"` for format/filter forms. Resource: `impact-nova://data-table-sheet-layout`.\n- **AG Grid v36 peers:** `ag-grid-community@36.0.1`, `ag-grid-react@36.0.1`, `ag-grid-enterprise@36.0.1` — exact pin, dedupe in Vite. No legacy `ag-theme-*` CSS.\n- **Column settings:** `DataTableColumnList` reads pin/sort/filter from the live `GridApi` (frozen vs scrollable sections). Storybook: `Data/DataTable/Column settings scenarios`.\n- Use **processBackendColumnDefs** from `impact-nova` when column defs come from the backend; type **BackendColDef**.\n- Cell renderers: **AG_GRID_CELL_COMPONENTS** or **LinkCellRenderer** from `impact-nova/ag-grid-react/cell-renderers`; extend/wrap as needed (e.g. PlanningLinkCellRenderer).\n- **Cell comments / notes / row Chat** are independent opt-ins on `DataTableContent`. Omit a prop → zero host. Do not put threads in `rowData`. Do not use AG Grid Notes for comment threads.\n  - **Comments** (`comments={…}` from `impact-nova/ag-grid-react/comments`): cell `{ rowId, colId }` thread. Required: `hasIndicator`, `loadThread`, `persist`, `getAuthor`. Resource: `impact-nova://data-table-comments`. Topic: `comments`.\n  - **Notes** (`notes={…}` from `impact-nova/ag-grid-react/notes`): AG Grid `NotesModule` via public `notesDataSource`. Yellow indicator. Resource: `impact-nova://data-table-notes`. Topic: `notes`.\n  - **Chat** (`chat={…}` from `impact-nova/ag-grid-react/chat`): row `{ getRowId }`, many conversations per row. Required: `hasConversation`, `loadConversation`, `persist`, `getAuthor`. Permissions: `can(action, context)`. Resource: `impact-nova://data-table-chat`. Topic: `chat`.\n\n### Sheet (side panel with form)\n\n- **Sheet**, **SheetContent**, **SheetHeader**, **SheetTitle**, **SheetBody**, **SheetFooter** from `impact-nova/sheet`.\n- Use for “Match With”, “Bulk Edit”, “View Management” panels. Pair with react-hook-form for form content.\n\n### Empty state\n\n- **EmptyContainer** wrapping **EmptyContainerImage**, **EmptyContainerTitle**, **EmptyContainerDescription**, **EmptyContainerAction** (e.g. a Button to “Select filter” or “Add item”).\n- **Lazy illustrations:** When no custom `children` are passed to `EmptyContainerImage`, one random illustration loads via dynamic `import()` — only ~1 webp chunk per empty state, not all 6 upfront. Pass custom children to skip illustration loading entirely.\n\n### Tabs + NestedList + Accordion (view management)\n\n- **Tabs**, **TabsList**, **TabsTrigger**, **TabsContent** for switching sections.\n- **NestedList** with **SelectionMode**; data shape **NestedListItem** from `impact-nova/nested-list`.\n- **Accordion**, **AccordionItem**, **AccordionTrigger**, **AccordionContent** for expandable blocks (e.g. Versions & Variance).\n\n### Chart (Highcharts)\n\n- Use **Chart** from `impact-nova/chart` as the wrapper.\n- For **series, options, and configuration** refer to **Highcharts documentation** ([highcharts.com/docs](https://www.highcharts.com/docs/)); use the Highcharts API for chart behavior. Impact Nova provides the React integration and styling; options/series follow Highcharts.\n- Install: `highcharts@^12`, `highcharts-react-official@^3`, optional `highcharts-border-radius@^0.0.4`.\n\n### Toast + Alert\n\n- **toast**, **Toaster**, **useToast** from `impact-nova`; wrap app with **Toaster**.\n- **Alert**, **AlertTitle**, **AlertDescription**, **AlertIcon** from `impact-nova/alert` for inline or toast-style messages.\n\n### Expandable list row vs virtualized list (independent, composable)\n\nBoth are **decoupled** subpaths. Pick the integration style that fits — preset, compound, or headless hooks.\n\n#### ExpandableListItem (`impact-nova/expandable-list-item`)\n\n| Style | When | Example |\n|-------|------|---------|\n| **Preset** | Data-driven sections from API/config | `<ExpandableListItem title=\"…\" description=\"…\" sections={sections} />` |\n| **Compound** | Custom row layout / slots | `ExpandableListItemRoot` → `Row` → `Checkbox` + `Trigger` → `Content` |\n| **Inside virtualized** | Large lists (optional) | Render preset or compound inside `VirtualizedListItem` |\n\n- Props: **`title`**, **`description`** (not legacy `sku` / `subtitle`)\n- Sections: `ExpandableListItemSection[]` — `metrics` | `attributes` | `custom`\n- Storybook: **Expandable List Item → Composition**\n\n#### Virtualized (`impact-nova/virtualized`)\n\n| Style | When | Example |\n|-------|------|---------|\n| **Compound UI** | New list chrome (search, select-all, viewport) | `VirtualizedList` → `Viewport` → `Content` → `Item` |\n| **Headless hooks** | Full DOM control / existing layout | `useVirtualizedList` + `getItemProps` / `resetRowSize` |\n| **Custom rows** | Any row JSX | ExpandableListItem optional — not required |\n\n- Expandable rows: `getItemProps(index, { measure: isExpanded })`; call `resetRowSize(index)` on collapse\n- Types: `RowSelectionState`, `VirtualRowModel`, `UseVirtualizedListResult`\n- Storybook: **Virtualized List → Composition** and **Custom row UI**\n- Patterns: `query_patterns` → `virtualized-selectable-list`, `expandable-list-item-preset`, `expandable-list-item-compound`\n- **Renamed:** `impact-nova/expandable-sku` → `impact-nova/expandable-list-item`. See `impact-nova://removed-imports`.\n\n### Command Palette & keyboard shortcuts\n\nImplementation is **more involved** than other components. Use the dedicated guide: resource **`impact-nova://command-palette`**.\n\n- **Import:** `import { CommandPaletteProvider, CommandPalette, useShortcut, useGlobalShortcut, ShortcutSettings, ShortcutScopeProvider, Kbd, useCommandPalette, useBrowserShortcuts } from 'impact-nova/command-palette';`\n- **Minimal setup:** Wrap app with `CommandPaletteProvider`; render `<CommandPalette />` once inside it (⌘K overlay). Register commands with `useShortcut` (scoped: page/module/modal) or `useGlobalShortcut` (app-wide). Use correct `scope` for priority (modal > page > module > global).\n- **Multi-table:** When multiple DataTables share the same shortcut, wrap each in `ShortcutScopeProvider` with a unique `instance` so only the focused one responds.\n- **ShortcutSettings:** AG Grid–powered panel for user customisation; put inside a Sheet (e.g. Keyboard Shortcuts settings). For AG Grid behaviour follow `impact-nova://ag-grid-rules`.\n- **Kbd:** Use `<Kbd keybinding={{ key: 'k', meta: true }} />` to show shortcut in UI. **Button trigger:** `useCommandPalette().setOpen(true)`.\n\n---\n\n## 4. App setup\n\n- **CSS once at root**: `import 'impact-nova/dist/impact-nova.css';` (e.g. in App.tsx or main.tsx).\n- **AG Grid**: Set `LicenseManager.setLicenseKey(...)` if using enterprise. Install `ag-grid-community@36.0.1 ag-grid-react@36.0.1 ag-grid-enterprise@36.0.1`.\n- **Vite**: Dedupe react/ag-grid when using impact-nova to avoid dual instances. Exclude `impact-nova-icons` from `optimizeDeps` to prevent SVG asset warnings in dev:\n\n```js\noptimizeDeps: {\n  exclude: ['impact-nova-icons'],\n},\nresolve: {\n  dedupe: ['react', 'react-dom', 'ag-grid-community', 'ag-grid-enterprise', 'ag-grid-react'],\n},\n```\n\n---\n\n## 5. Known workarounds\n\n- **HorizontalScroller**: If the package entry is empty in your build, add a Vite alias to `.../horizontal-scroller/horizontal-scroller.js` and a small `declare module 'impact-nova/horizontal-scroller'` for TypeScript.\n- **Chart**: Prefer `import { Chart } from 'impact-nova/chart'`. Pre-bundle Highcharts UMD modules in Vite `optimizeDeps.include` if you see interop errors in dev.\n\n---\n\n## 6. Forms and options\n\n- **Select options**: Use type **Option** (or **SelectOption**) from `impact-nova/select` for `{ value, label }` (and optional fields). **MultiValue** for multi-select.\n- **react-hook-form**: Use Impact Nova form controls (SmartInput, Select, DateRangePicker, RadioGroup, ButtonGroup, Chips, etc.) as controlled components; pass `value`/`onChange` from the form library.\n- **Validation and errors**: Show validation errors with **Alert** or field-level messages; use the form library’s error state (e.g. `formState.errors`) and optional schema validation (e.g. Zod) with react-hook-form.\n\n### ReactHooksForm (config-driven dynamic forms)\n\nUse when the form layout and rules come from **JSON** (`IFormConfig`) — bulk edit sheets, settings, wizards, filters.\n\n```tsx\nimport { ReactHooksForm, type IFormConfig, type FormContext } from 'impact-nova/form-react';\n\nconst formContext: FormContext = {\n  transport: {\n    fetchSelectOptions: async ({ fieldId, apiConfig }) => { /* your fetch */ },\n    showFormErrorToast: ({ title, description }) => { /* your toast */ },\n  },\n  validateForm: ({ formValues }) => ({ isValid: true }), // optional cross-field rules\n};\n\n<ReactHooksForm formConfig={formConfig} formContext={formContext} onSubmit={handleSubmit} />\n```\n\n| Concept | What it does |\n|---------|----------------|\n| `isRequired` | Mandatory field — blocks submit when visible and empty |\n| `disableDependency` + `__empty__` | Disable child until parent has value; **auto-clear** when parent empties |\n| `disableDependency` + `null` | Disable when other field has any value (mutually exclusive) |\n| `disableDependency` + `\"true\"` | Disable when switch/checkbox is on (grand total, lock) |\n| `visibilityDependency` | Show/hide fields (month range vs multi-month; filter hierarchy) |\n| `formContext.transport` | **Required** for API selects — Nova never calls HTTP |\n| `formContext.validateForm` | Cross-field submit validation (e.g. “at least one edit”) |\n| `doNotIncludeInSubmit` | UI-only toggles excluded from payload |\n| `includeOnlyVisibleFieldsInSubmit` | Only active picker variant submitted |\n\n**MCP resource (full catalog):** `impact-nova://dynamic-form-framework`\n\n**Storybook (12 ItemSmart patterns):** `Dynamic Form / ReactHooksForm` + `Dynamic Form / Guide`\n\n| Story | URL slug |\n|-------|----------|\n| Required fields | `dynamic-form-reacthooksform--required-fields` |\n| Disable dependency | `dynamic-form-reacthooksform--disable-dependency-period-gates-value` |\n| validateForm gate | `dynamic-form-reacthooksform--item-details-bulk-edit-validate-form` |\n| Scenario simulate | `dynamic-form-reacthooksform--scenario-simulate` |\n| Filter disable chain | `dynamic-form-reacthooksform--filter-disable-chain` |\n| Filter visibility | `dynamic-form-reacthooksform--filter-visibility-hierarchy` |\n\n**`query_patterns` ids:** `config-driven-dynamic-form`, `form-required-fields`, `form-visibility-dependency`, `time-phased-metric-bulk-edit`, `form-validate-form-submit-gate`, `form-mutually-exclusive-fields`, `form-switch-disable-bypass`, `form-approval-hub-lock`, `filter-form-dependencies`, `form-filter-visibility-hierarchy`\n\n**Fixtures:** `impact-nova/src/form-react/stories/fixtures/itemSmartProductionFormConfigs.ts`\n\n**ItemSmart reference:** `mtp-mfe-itemsmart-v3/docs/react-hooks-form-production-patterns.md`\n\n**Packages:** `impact-nova/form-engine` · `impact-nova/form-react` · `impact-nova/filter-shell`\n\n---\n\n## 7. Breadcrumb and toolbar\n\n- **Breadcrumb** with **BreadcrumbList**, **BreadcrumbItem**, **BreadcrumbLink**, **BreadcrumbSeparator**, **BreadcrumbPage** for table/section context.\n- **DataTableToolbar** for table toolbars (view mode, view management, filters, Update/Cancel when editing).\n\nUse these patterns so the MCP and generated code stay close to how Impact Nova is used in real apps.\n\n---\n\n## 8. Wizard (multi-step flow)\n\nUse **Wizard** for any multi-step creation or onboarding flow. Radix-style controlled state (`value` / `onValueChange`), optional split-panel layout, and `useWizard()` for flexible footers.\n\n### Import\n\n```ts\nimport {\n  WizardRoot,\n  WizardLayout,\n  WizardSidebar,\n  WizardTitle,\n  WizardDescription,\n  WizardMedia,\n  WizardBody,\n  WizardProgress,\n  WizardHeader,\n  WizardContent,\n  WizardStep,\n  WizardFooter,\n  useWizard,\n} from 'impact-nova/wizard';\n```\n\n### Minimal multi-step example\n\n```tsx\nimport { useState } from 'react';\nimport {\n  WizardRoot, WizardLayout,\n  WizardSidebar, WizardTitle, WizardDescription, WizardMedia,\n  WizardBody, WizardProgress,\n  WizardContent, WizardStep, WizardHeader,\n  WizardFooter,\n} from 'impact-nova/wizard';\nimport { Button } from 'impact-nova/button';\n\nexport function CreateAlertFlow() {\n  const [step, setStep] = useState(1);\n\n  return (\n    <WizardRoot value={step} totalSteps={3} onValueChange={setStep}>\n      <WizardLayout>\n        <WizardSidebar>\n          <WizardTitle>Create Alert</WizardTitle>\n          <WizardDescription>Configure your alert step by step.</WizardDescription>\n          <WizardMedia />\n        </WizardSidebar>\n\n        <WizardBody>\n          <WizardProgress />\n          <WizardContent>\n            <WizardStep value={1}>\n              <WizardHeader>Alert Details</WizardHeader>\n            </WizardStep>\n            <WizardStep value={2}>\n              <WizardHeader>Configuration</WizardHeader>\n            </WizardStep>\n            <WizardStep value={3}>\n              <WizardHeader>Review</WizardHeader>\n            </WizardStep>\n          </WizardContent>\n          <WizardFooter>\n            <Button variant=\"secondary\">Cancel</Button>\n            <Button variant=\"default\">Submit</Button>\n          </WizardFooter>\n        </WizardBody>\n      </WizardLayout>\n    </WizardRoot>\n  );\n}\n```\n\n### Key rules\n\n- **WizardRoot** is the context provider — every other sub-component must be a descendant.\n- Use **useWizard()** for `goNext`, `goBack`, `isFirstStep`, `isLastStep` without prop drilling.\n- **WizardStep** renders nothing when `value` doesn't match the current step — use one per step.\n- **WizardMedia** renders a default SVG when neither `src` nor `children` are provided.\n- The sidebar is hidden below the `lg` breakpoint.\n- All sub-components except **WizardRoot** are optional — compose only what you need.\n---\n\n## 9. App layout (app shell)\n\n**Use `Layout`** for the app chrome — not `DynamicLayout` (that is a grid/flex/stack utility only).\n\nFull beginner scaffold: resource **`impact-nova://layout`**.\n\n### Structure\n\n```tsx\nimport { Layout } from 'impact-nova/layout';\nimport { Sidebar, SidebarProvider } from 'impact-nova/sidebar';\nimport { Header, HeaderLeft, HeaderTitle } from 'impact-nova/header';\nimport { BreadcrumbHeader, Breadcrumb, BreadcrumbList } from 'impact-nova/breadcrumb';\nimport { FilterStrip } from 'impact-nova/filter-strip';\n\n<SidebarProvider defaultOpen={false} id=\"app-sidebar\" className=\"flex h-svh min-h-0 w-full min-w-0 overflow-hidden\">\n  <Layout\n    sidebar={<Sidebar collapsible=\"offcanvas\">...</Sidebar>}\n    header={<Header>...</Header>}\n  >\n    {/* Page content — Item Smart parity */}\n    <PageShell>\n      <PageStickyHeader pageTitle=\"...\" filterStrip={filtersApplied ? <FilterStrip ... /> : undefined} />\n      {filtersApplied ? <WorkspaceBody /> : <EmptyStateView title=\"...\" primaryActionLabel=\"Select filter\" />}\n    </PageShell>\n  </Layout>\n</SidebarProvider>\n```\n\n### Key rules\n\n- **`SidebarProvider` at app root** — wraps `Layout`, not inside the sidebar slot.\n- **Page background** — `PageShell` → `bg-brand-subtle` (not `bg-canvas-wash` on module pages)\n- **Filter strip** — white sticky bar via `PageStickyHeader` `filterStrip` slot (`page-filter-strip` class)\n- **Tables** — `module-table-container mx-6 flex min-h-[480px] flex-1` → white `DataTable` card with shadow\n- **Subpath imports** — `impact-nova/layout`, `impact-nova/sidebar`, `impact-nova/header`, `impact-nova/breadcrumb`, `impact-nova/filter-strip`.\n- **With React Router** — put `<Outlet />` inside `Layout` children; route pages render breadcrumb + body.\n- **With Command Palette** — `CommandPaletteProvider` at root; `<CommandPalette />` as sibling inside `SidebarProvider`. See `impact-nova://command-palette`.\n\n### Premium primitives (shipped in create-impact-nova template)\n\n| Component | Role |\n|-----------|------|\n| `PageShell` | `bg-brand-subtle` + flex fill chain |\n| `PageStickyHeader` | Breadcrumb `z-30` + white filter strip slot |\n| `EmptyStateView` | Illustration + primary/secondary CTAs |\n| `SummaryMetricCard` | Dashboard KPI tiles (`border-[#C3C8D4]`, hover shadow) |\n| `module-table-container` | Table card shadow + `min-h-[480px] flex-1` fill |\n";
+export default "# Impact Nova — Real-World Patterns (from production apps)\n\nPatterns observed in apps that use Impact Nova extensively (e.g. filter UIs, data tables, sheets, empty states).\n\n---\n\n## 1. Subpath imports (tree-shaking)\n\n**Default for production apps:** use subpath imports. Production apps (e.g. mtp-mfe-itemsmart-v3) migrated to 100% subpath imports — zero barrel `from 'impact-nova'` in feature code. Barrel is OK for i18n bootstrapping only.\n\n| Use case | Import |\n|----------|--------|\n| Layout (app shell) | `import { Layout } from 'impact-nova/layout';` |\n| Sidebar | `import { Sidebar, SidebarProvider, SidebarContent } from 'impact-nova/sidebar';` |\n| Header | `import { Header, HeaderLeft, HeaderRight, HeaderTitle } from 'impact-nova/header';` |\n| Breadcrumb | `import { Breadcrumb, BreadcrumbList, BreadcrumbHeader } from 'impact-nova/breadcrumb';` |\n| Button only | `import { Button } from 'impact-nova/button';` |\n| Combobox | `import { Combobox } from 'impact-nova/combobox';` |\n| Sheet (side panel) | `import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetBody, SheetFooter } from 'impact-nova/sheet';` |\n| Filter panel | `import { FilterPanel, FilterPanelSidebar } from 'impact-nova/filter-panel';` and `FilterPanelBody`, `FilterPanelFooter` |\n| Filter strip | `import { FilterStrip } from 'impact-nova/filter-strip';` |\n| Empty state | `import { EmptyContainer, EmptyContainerImage, EmptyContainerTitle, EmptyContainerDescription, EmptyContainerAction } from 'impact-nova/empty-container';` |\n| Accordion | `import { Accordion, AccordionItem, AccordionTrigger, AccordionContent } from 'impact-nova/accordion';` |\n| Date pickers | `import { DateRangePicker } from 'impact-nova/date-picker';` or `WeekRangePicker`, `MonthRangePicker`. Week range selection language (Wk gutter join, rounded-lg start/end caps) is built into Calendar — do not restyle the grid. |\n| Select | `import { Select } from 'impact-nova/select';` |\n| Data table | `import { DataTable, DataTableContent, DataTableToolbar, useDataTable } from 'impact-nova/data-table';` |\n| Progress bar | `import { ProgressBar } from 'impact-nova/progress-bar';` |\n| Virtualized list hooks | `import { useVirtualizedList, useDebouncedValue } from 'impact-nova/virtualized';` |\n| Expandable list row | `import { ExpandableListItem, type ExpandableListItemSection } from 'impact-nova/expandable-list-item';` |\n| Row selection type | `import type { RowSelectionState } from 'impact-nova/virtualized';` |\n| Alert | `import { Alert, AlertTitle, AlertDescription, AlertIcon } from 'impact-nova/alert';` |\n| Tooltip | `import { Tooltip, TooltipTrigger, TooltipContent } from 'impact-nova/tooltip';` |\n| Icons | `import { Pin, Unpin, Chart } from 'impact-nova-icons';` + `createIconResolver` for dynamic lookup |\n| AG Grid cell renderers | `import { AG_GRID_CELL_COMPONENTS, LinkCellRenderer } from 'impact-nova/ag-grid-react/cell-renderers';` |\n| Prompt | `import { Prompt } from 'impact-nova/prompt';` |\n| Radio group | `import { RadioGroup, RadioGroupItem } from 'impact-nova/radio-group';` |\n| Button group | `import { ButtonGroup } from 'impact-nova/button-group';` |\n| Smart input | `import { SmartInput as InputWrapper } from 'impact-nova/smart-input';` |\n| Chips | `import { Chip } from 'impact-nova/chips';` |\n| Loader | `import { Loader } from 'impact-nova/loader';` |\n\n---\n\n## 2. Type-only imports\n\nUse type-only imports for types to avoid pulling runtime code:\n\n```ts\nimport type { Option, MultiValue, ActionMeta } from 'impact-nova/select';\nimport type { FilterSidebarItem } from 'impact-nova/filter-panel';\nimport type { FilterItem, SavedFilterItem } from 'impact-nova/filter-strip';\nimport type { NestedListItem } from 'impact-nova/nested-list';\nimport type { FileUploadProps } from 'impact-nova/file-upload';\nimport type { BackendColDef } from 'impact-nova';\n```\n\n---\n\n## 3. Compound patterns\n\n### Filter UI (panel + strip)\n\n- **FilterPanel** + **FilterPanelSidebar** for the sliding panel; **FilterPanelBody** and **FilterPanelFooter** for content and Apply/Cancel.\n- **FilterStrip** to show applied filters (chips/tags). Types: `FilterItem`, `SavedFilterItem` from `impact-nova/filter-strip`.\n- Config drives **FilterSidebarItem** (from `impact-nova/filter-panel`); form state often with react-hook-form.\n\n### Data table + AG Grid\n\n**Mandatory (no deviation):** For DataTable or any data table using AG Grid, refer **only** to AG Grid's official documentation, follow **only** AG Grid recommended patterns, and use **only** the AG Grid API for grid operations. See resource `impact-nova://ag-grid-rules` for full rules. If the user has **ag-mcp** installed, use it for AG Grid API/docs and collaborate with this MCP for Impact Nova integration.\n\n- **DataTable**, **DataTableContent**, **DataTableSheet**, **DataTableSheetContent**, **DataTableSheetHeader**, **DataTableSheetBody**, **DataTableSheetSection**, **DataTableSheetTabs**, **DataTableSheetTabsList**, **DataTableSheetTabPanel**, **DataTableColumnList**, **DataTableFormatOptions** from `impact-nova/data-table`.\n- **Settings sheet layout:** Use compound sheet layout components — not raw `Tabs` + manual `overflow-y-auto`. `DataTableSheetTabPanel layout=\"list\"` for column/KPI lists; `layout=\"scroll\"` for format/filter forms. Resource: `impact-nova://data-table-sheet-layout`.\n- **AG Grid v36 peers:** `ag-grid-community@36.0.1`, `ag-grid-react@36.0.1`, `ag-grid-enterprise@36.0.1` — exact pin, dedupe in Vite. No legacy `ag-theme-*` CSS.\n- **Column settings:** `DataTableColumnList` reads pin/sort/filter from the live `GridApi` (frozen vs scrollable sections). Storybook: `Data/DataTable/Column settings scenarios`.\n- Use **processBackendColumnDefs** from `impact-nova` when column defs come from the backend; type **BackendColDef**.\n- Cell renderers: **AG_GRID_CELL_COMPONENTS** or **LinkCellRenderer** from `impact-nova/ag-grid-react/cell-renderers`; extend/wrap as needed (e.g. PlanningLinkCellRenderer).\n\n### Sheet (side panel with form)\n\n- **Sheet**, **SheetContent**, **SheetHeader**, **SheetTitle**, **SheetBody**, **SheetFooter** from `impact-nova/sheet`.\n- Use for “Match With”, “Bulk Edit”, “View Management” panels. Pair with react-hook-form for form content.\n\n### Empty state\n\n- **EmptyContainer** wrapping **EmptyContainerImage**, **EmptyContainerTitle**, **EmptyContainerDescription**, **EmptyContainerAction** (e.g. a Button to “Select filter” or “Add item”).\n- **Lazy illustrations:** When no custom `children` are passed to `EmptyContainerImage`, one random illustration loads via dynamic `import()` — only ~1 webp chunk per empty state, not all 6 upfront. Pass custom children to skip illustration loading entirely.\n\n### Tabs + NestedList + Accordion (view management)\n\n- **Tabs**, **TabsList**, **TabsTrigger**, **TabsContent** for switching sections.\n- **NestedList** with **SelectionMode**; data shape **NestedListItem** from `impact-nova/nested-list`.\n- **Accordion**, **AccordionItem**, **AccordionTrigger**, **AccordionContent** for expandable blocks (e.g. Versions & Variance).\n\n### Chart (Highcharts)\n\n- Use **Chart** from `impact-nova/chart` as the wrapper.\n- For **series, options, and configuration** refer to **Highcharts documentation** ([highcharts.com/docs](https://www.highcharts.com/docs/)); use the Highcharts API for chart behavior. Impact Nova provides the React integration and styling; options/series follow Highcharts.\n- Install: `highcharts@^12`, `highcharts-react-official@^3`, optional `highcharts-border-radius@^0.0.4`.\n\n### Toast + Alert\n\n- **toast**, **Toaster**, **useToast** from `impact-nova`; wrap app with **Toaster**.\n- **Alert**, **AlertTitle**, **AlertDescription**, **AlertIcon** from `impact-nova/alert` for inline or toast-style messages.\n\n### Expandable list row vs virtualized list (independent, composable)\n\nBoth are **decoupled** subpaths. Pick the integration style that fits — preset, compound, or headless hooks.\n\n#### ExpandableListItem (`impact-nova/expandable-list-item`)\n\n| Style | When | Example |\n|-------|------|---------|\n| **Preset** | Data-driven sections from API/config | `<ExpandableListItem title=\"…\" description=\"…\" sections={sections} />` |\n| **Compound** | Custom row layout / slots | `ExpandableListItemRoot` → `Row` → `Checkbox` + `Trigger` → `Content` |\n| **Inside virtualized** | Large lists (optional) | Render preset or compound inside `VirtualizedListItem` |\n\n- Props: **`title`**, **`description`** (not legacy `sku` / `subtitle`)\n- Sections: `ExpandableListItemSection[]` — `metrics` | `attributes` | `custom`\n- Storybook: **Expandable List Item → Composition**\n\n#### Virtualized (`impact-nova/virtualized`)\n\n| Style | When | Example |\n|-------|------|---------|\n| **Compound UI** | New list chrome (search, select-all, viewport) | `VirtualizedList` → `Viewport` → `Content` → `Item` |\n| **Headless hooks** | Full DOM control / existing layout | `useVirtualizedList` + `getItemProps` / `resetRowSize` |\n| **Custom rows** | Any row JSX | ExpandableListItem optional — not required |\n\n- Expandable rows: `getItemProps(index, { measure: isExpanded })`; call `resetRowSize(index)` on collapse\n- Types: `RowSelectionState`, `VirtualRowModel`, `UseVirtualizedListResult`\n- Storybook: **Virtualized List → Composition** and **Custom row UI**\n- Patterns: `query_patterns` → `virtualized-selectable-list`, `expandable-list-item-preset`, `expandable-list-item-compound`\n- **Renamed:** `impact-nova/expandable-sku` → `impact-nova/expandable-list-item`. See `impact-nova://removed-imports`.\n\n### Command Palette & keyboard shortcuts\n\nImplementation is **more involved** than other components. Use the dedicated guide: resource **`impact-nova://command-palette`**.\n\n- **Import:** `import { CommandPaletteProvider, CommandPalette, useShortcut, useGlobalShortcut, ShortcutSettings, ShortcutScopeProvider, Kbd, useCommandPalette, useBrowserShortcuts } from 'impact-nova/command-palette';`\n- **Minimal setup:** Wrap app with `CommandPaletteProvider`; render `<CommandPalette />` once inside it (⌘K overlay). Register commands with `useShortcut` (scoped: page/module/modal) or `useGlobalShortcut` (app-wide). Use correct `scope` for priority (modal > page > module > global).\n- **Multi-table:** When multiple DataTables share the same shortcut, wrap each in `ShortcutScopeProvider` with a unique `instance` so only the focused one responds.\n- **ShortcutSettings:** AG Grid–powered panel for user customisation; put inside a Sheet (e.g. Keyboard Shortcuts settings). For AG Grid behaviour follow `impact-nova://ag-grid-rules`.\n- **Kbd:** Use `<Kbd keybinding={{ key: 'k', meta: true }} />` to show shortcut in UI. **Button trigger:** `useCommandPalette().setOpen(true)`.\n\n---\n\n## 4. App setup\n\n- **CSS once at root**: `import 'impact-nova/dist/impact-nova.css';` (e.g. in App.tsx or main.tsx).\n- **AG Grid**: Set `LicenseManager.setLicenseKey(...)` if using enterprise. Install `ag-grid-community@36.0.1 ag-grid-react@36.0.1 ag-grid-enterprise@36.0.1`.\n- **Vite**: Dedupe react/ag-grid when using impact-nova to avoid dual instances. Exclude `impact-nova-icons` from `optimizeDeps` to prevent SVG asset warnings in dev:\n\n```js\noptimizeDeps: {\n  exclude: ['impact-nova-icons'],\n},\nresolve: {\n  dedupe: ['react', 'react-dom', 'ag-grid-community', 'ag-grid-enterprise', 'ag-grid-react'],\n},\n```\n\n---\n\n## 5. Known workarounds\n\n- **HorizontalScroller**: If the package entry is empty in your build, add a Vite alias to `.../horizontal-scroller/horizontal-scroller.js` and a small `declare module 'impact-nova/horizontal-scroller'` for TypeScript.\n- **Chart**: Prefer `import { Chart } from 'impact-nova/chart'`. Pre-bundle Highcharts UMD modules in Vite `optimizeDeps.include` if you see interop errors in dev.\n\n---\n\n## 6. Forms and options\n\n- **Select options**: Use type **Option** (or **SelectOption**) from `impact-nova/select` for `{ value, label }` (and optional fields). **MultiValue** for multi-select.\n- **react-hook-form**: Use Impact Nova form controls (SmartInput, Select, DateRangePicker, RadioGroup, ButtonGroup, Chips, etc.) as controlled components; pass `value`/`onChange` from the form library.\n- **Validation and errors**: Show validation errors with **Alert** or field-level messages; use the form library’s error state (e.g. `formState.errors`) and optional schema validation (e.g. Zod) with react-hook-form.\n\n### ReactHooksForm (config-driven dynamic forms)\n\nUse when the form layout and rules come from **JSON** (`IFormConfig`) — bulk edit sheets, settings, wizards, filters.\n\n```tsx\nimport { ReactHooksForm, type IFormConfig, type FormContext } from 'impact-nova/form-react';\n\nconst formContext: FormContext = {\n  transport: {\n    fetchSelectOptions: async ({ fieldId, apiConfig }) => { /* your fetch */ },\n    showFormErrorToast: ({ title, description }) => { /* your toast */ },\n  },\n  validateForm: ({ formValues }) => ({ isValid: true }), // optional cross-field rules\n};\n\n<ReactHooksForm formConfig={formConfig} formContext={formContext} onSubmit={handleSubmit} />\n```\n\n| Concept | What it does |\n|---------|----------------|\n| `isRequired` | Mandatory field — blocks submit when visible and empty |\n| `disableDependency` + `__empty__` | Disable child until parent has value; **auto-clear** when parent empties |\n| `disableDependency` + `null` | Disable when other field has any value (mutually exclusive) |\n| `disableDependency` + `\"true\"` | Disable when switch/checkbox is on (grand total, lock) |\n| `visibilityDependency` | Show/hide fields (month range vs multi-month; filter hierarchy) |\n| `formContext.transport` | **Required** for API selects — Nova never calls HTTP |\n| `formContext.validateForm` | Cross-field submit validation (e.g. “at least one edit”) |\n| `doNotIncludeInSubmit` | UI-only toggles excluded from payload |\n| `includeOnlyVisibleFieldsInSubmit` | Only active picker variant submitted |\n\n**MCP resource (full catalog):** `impact-nova://dynamic-form-framework`\n\n**Storybook (12 ItemSmart patterns):** `Dynamic Form / ReactHooksForm` + `Dynamic Form / Guide`\n\n| Story | URL slug |\n|-------|----------|\n| Required fields | `dynamic-form-reacthooksform--required-fields` |\n| Disable dependency | `dynamic-form-reacthooksform--disable-dependency-period-gates-value` |\n| validateForm gate | `dynamic-form-reacthooksform--item-details-bulk-edit-validate-form` |\n| Scenario simulate | `dynamic-form-reacthooksform--scenario-simulate` |\n| Filter disable chain | `dynamic-form-reacthooksform--filter-disable-chain` |\n| Filter visibility | `dynamic-form-reacthooksform--filter-visibility-hierarchy` |\n\n**`query_patterns` ids:** `config-driven-dynamic-form`, `form-required-fields`, `form-visibility-dependency`, `time-phased-metric-bulk-edit`, `form-validate-form-submit-gate`, `form-mutually-exclusive-fields`, `form-switch-disable-bypass`, `form-approval-hub-lock`, `filter-form-dependencies`, `form-filter-visibility-hierarchy`\n\n**Fixtures:** `impact-nova/src/form-react/stories/fixtures/itemSmartProductionFormConfigs.ts`\n\n**ItemSmart reference:** `mtp-mfe-itemsmart-v3/docs/react-hooks-form-production-patterns.md`\n\n**Packages:** `impact-nova/form-engine` · `impact-nova/form-react` · `impact-nova/filter-shell`\n\n---\n\n## 7. Breadcrumb and toolbar\n\n- **Breadcrumb** with **BreadcrumbList**, **BreadcrumbItem**, **BreadcrumbLink**, **BreadcrumbSeparator**, **BreadcrumbPage** for table/section context.\n- **DataTableToolbar** for table toolbars (view mode, view management, filters, Update/Cancel when editing).\n\nUse these patterns so the MCP and generated code stay close to how Impact Nova is used in real apps.\n\n---\n\n## 8. Wizard (multi-step flow)\n\nUse **Wizard** for any multi-step creation or onboarding flow. Radix-style controlled state (`value` / `onValueChange`), optional split-panel layout, and `useWizard()` for flexible footers.\n\n### Import\n\n```ts\nimport {\n  WizardRoot,\n  WizardLayout,\n  WizardSidebar,\n  WizardTitle,\n  WizardDescription,\n  WizardMedia,\n  WizardBody,\n  WizardProgress,\n  WizardHeader,\n  WizardContent,\n  WizardStep,\n  WizardFooter,\n  useWizard,\n} from 'impact-nova/wizard';\n```\n\n### Minimal multi-step example\n\n```tsx\nimport { useState } from 'react';\nimport {\n  WizardRoot, WizardLayout,\n  WizardSidebar, WizardTitle, WizardDescription, WizardMedia,\n  WizardBody, WizardProgress,\n  WizardContent, WizardStep, WizardHeader,\n  WizardFooter,\n} from 'impact-nova/wizard';\nimport { Button } from 'impact-nova/button';\n\nexport function CreateAlertFlow() {\n  const [step, setStep] = useState(1);\n\n  return (\n    <WizardRoot value={step} totalSteps={3} onValueChange={setStep}>\n      <WizardLayout>\n        <WizardSidebar>\n          <WizardTitle>Create Alert</WizardTitle>\n          <WizardDescription>Configure your alert step by step.</WizardDescription>\n          <WizardMedia />\n        </WizardSidebar>\n\n        <WizardBody>\n          <WizardProgress />\n          <WizardContent>\n            <WizardStep value={1}>\n              <WizardHeader>Alert Details</WizardHeader>\n            </WizardStep>\n            <WizardStep value={2}>\n              <WizardHeader>Configuration</WizardHeader>\n            </WizardStep>\n            <WizardStep value={3}>\n              <WizardHeader>Review</WizardHeader>\n            </WizardStep>\n          </WizardContent>\n          <WizardFooter>\n            <Button variant=\"secondary\">Cancel</Button>\n            <Button variant=\"default\">Submit</Button>\n          </WizardFooter>\n        </WizardBody>\n      </WizardLayout>\n    </WizardRoot>\n  );\n}\n```\n\n### Key rules\n\n- **WizardRoot** is the context provider — every other sub-component must be a descendant.\n- Use **useWizard()** for `goNext`, `goBack`, `isFirstStep`, `isLastStep` without prop drilling.\n- **WizardStep** renders nothing when `value` doesn't match the current step — use one per step.\n- **WizardMedia** renders a default SVG when neither `src` nor `children` are provided.\n- The sidebar is hidden below the `lg` breakpoint.\n- All sub-components except **WizardRoot** are optional — compose only what you need.\n---\n\n## 9. App layout (app shell)\n\n**Use `Layout`** for the app chrome — not `DynamicLayout` (that is a grid/flex/stack utility only).\n\nFull beginner scaffold: resource **`impact-nova://layout`**.\n\n### Structure\n\n```tsx\nimport { Layout } from 'impact-nova/layout';\nimport { Sidebar, SidebarProvider } from 'impact-nova/sidebar';\nimport { Header, HeaderLeft, HeaderTitle } from 'impact-nova/header';\nimport { BreadcrumbHeader, Breadcrumb, BreadcrumbList } from 'impact-nova/breadcrumb';\nimport { FilterStrip } from 'impact-nova/filter-strip';\n\n<SidebarProvider defaultOpen={false} id=\"app-sidebar\" className=\"flex h-svh min-h-0 w-full min-w-0 overflow-hidden\">\n  <Layout\n    sidebar={<Sidebar collapsible=\"offcanvas\">...</Sidebar>}\n    header={<Header>...</Header>}\n  >\n    {/* Page content — Item Smart parity */}\n    <PageShell>\n      <PageStickyHeader pageTitle=\"...\" filterStrip={filtersApplied ? <FilterStrip ... /> : undefined} />\n      {filtersApplied ? <WorkspaceBody /> : <EmptyStateView title=\"...\" primaryActionLabel=\"Select filter\" />}\n    </PageShell>\n  </Layout>\n</SidebarProvider>\n```\n\n### Key rules\n\n- **`SidebarProvider` at app root** — wraps `Layout`, not inside the sidebar slot.\n- **Page background** — `PageShell` → `bg-brand-subtle` (not `bg-canvas-wash` on module pages)\n- **Filter strip** — white sticky bar via `PageStickyHeader` `filterStrip` slot (`page-filter-strip` class)\n- **Tables** — `module-table-container mx-6 flex min-h-[480px] flex-1` → white `DataTable` card with shadow\n- **Subpath imports** — `impact-nova/layout`, `impact-nova/sidebar`, `impact-nova/header`, `impact-nova/breadcrumb`, `impact-nova/filter-strip`.\n- **With React Router** — put `<Outlet />` inside `Layout` children; route pages render breadcrumb + body.\n- **With Command Palette** — `CommandPaletteProvider` at root; `<CommandPalette />` as sibling inside `SidebarProvider`. See `impact-nova://command-palette`.\n\n### Premium primitives (shipped in create-impact-nova template)\n\n| Component | Role |\n|-----------|------|\n| `PageShell` | `bg-brand-subtle` + flex fill chain |\n| `PageStickyHeader` | Breadcrumb `z-30` + white filter strip slot |\n| `EmptyStateView` | Illustration + primary/secondary CTAs |\n| `SummaryMetricCard` | Dashboard KPI tiles (`border-[#C3C8D4]`, hover shadow) |\n| `module-table-container` | Table card shadow + `min-h-[480px] flex-1` fill |\n";

package/dist/llms/rules/requirements.js

@@ -1 +1 @@
-export default "# Impact Nova — baseline\n\nUse **Impact Nova** design-system components and tokens. Prefer subpath imports (e.g. `impact-nova/button`) when you only need a few modules. For live component lists, specs, and codegen, use the **impact-nova-mcp** MCP server (see npm `impact-nova-mcp`). Browse **Storybook**: https://impact-nova.iaproducts.ai/\n\n## Peer dependency summary\n\n```json\n{\n  \"impactNova\": {\n    \"package\": \"impact-nova\",\n    \"recommendedVersion\": \"2.6.0-alpha.0\",\n    \"recommendedDistTag\": \"latest\",\n    \"description\": \"Design system package — ESM with 90+ subpath exports. Install: npm install impact-nova@latest\"\n  },\n  \"createImpactNova\": {\n    \"package\": \"create-impact-nova\",\n    \"recommendedVersion\": \"^1.4.9\",\n    \"description\": \"Vite + React scaffold with recipe-based modules\"\n  },\n  \"localDevelopment\": {\n    \"defaultScaffoldDependency\": \"auto\",\n    \"description\": \"create-impact-nova auto-detects: file: link when run inside the impact-nova monorepo; npm (impact-nova@^2.6.0-alpha.0) otherwise. CLI: --from-npm or --link-monorepo to override. Rebuild impact-nova (npm run build) after DS changes when using file: link.\",\n    \"cliFlagForNpm\": \"--from-npm\",\n    \"cliFlagForMonorepo\": \"--link-monorepo\",\n    \"mcpScaffoldFlag\": \"usePublishedPackages: true | false (omit for auto-detect)\"\n  },\n  \"mandatoryRules\": {\n    \"componentsOnly\": \"Use Impact Nova components only — never create new custom UI components\",\n    \"tables\": \"Any table/grid/spreadsheet → DataTable from impact-nova/data-table (not HTML table, not raw ag-grid-react)\",\n    \"validateBeforeDone\": \"Call validate_snippet on generated UI code\",\n    \"resource\": \"impact-nova://design-system-mandate\"\n  },\n  \"requiredPeers\": [\n    {\n      \"package\": \"react\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React 19 required\"\n    },\n    {\n      \"package\": \"react-dom\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React DOM 19 required\"\n    },\n    {\n      \"package\": \"impact-nova-icons\",\n      \"recommendedVersion\": \">=0.1.0\",\n      \"description\": \"Icons peer — not bundled in impact-nova; 0.1.x and 0.2.x supported\"\n    }\n  ],\n  \"optionalPeers\": [\n    {\n      \"package\": \"ag-grid-community\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"AG Grid community types/API; pin to the same version as ag-grid-react\"\n    },\n    {\n      \"package\": \"ag-grid-react\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"For DataTable and grid components; use exact version to match Impact Nova\"\n    },\n    {\n      \"package\": \"ag-grid-enterprise\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"Required if using ag-grid-react with enterprise features\"\n    },\n    {\n      \"package\": \"highcharts\",\n      \"recommendedVersion\": \"^12.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-react-official\",\n      \"recommendedVersion\": \"^3.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-border-radius\",\n      \"recommendedVersion\": \"^0.0.4\",\n      \"description\": \"Optional Highcharts plugin for rounded corners\"\n    }\n  ]\n}\n```\n";
+export default "# Impact Nova — baseline\n\nUse **Impact Nova** design-system components and tokens. Prefer subpath imports (e.g. `impact-nova/button`) when you only need a few modules. For live component lists, specs, and codegen, use the **impact-nova-mcp** MCP server (see npm `impact-nova-mcp`). Browse **Storybook**: https://impact-nova.iaproducts.ai/\n\n## Peer dependency summary\n\n```json\n{\n  \"impactNova\": {\n    \"package\": \"impact-nova\",\n    \"recommendedVersion\": \"2.5.22\",\n    \"recommendedDistTag\": \"latest\",\n    \"description\": \"Design system package — ESM with 90+ subpath exports. Install: npm install impact-nova@latest\"\n  },\n  \"createImpactNova\": {\n    \"package\": \"create-impact-nova\",\n    \"recommendedVersion\": \"^1.4.9\",\n    \"description\": \"Vite + React scaffold with recipe-based modules\"\n  },\n  \"localDevelopment\": {\n    \"defaultScaffoldDependency\": \"auto\",\n    \"description\": \"create-impact-nova auto-detects: file: link when run inside the impact-nova monorepo; npm (impact-nova@^2.5.22) otherwise. CLI: --from-npm or --link-monorepo to override. Rebuild impact-nova (npm run build) after DS changes when using file: link.\",\n    \"cliFlagForNpm\": \"--from-npm\",\n    \"cliFlagForMonorepo\": \"--link-monorepo\",\n    \"mcpScaffoldFlag\": \"usePublishedPackages: true | false (omit for auto-detect)\"\n  },\n  \"mandatoryRules\": {\n    \"componentsOnly\": \"Use Impact Nova components only — never create new custom UI components\",\n    \"tables\": \"Any table/grid/spreadsheet → DataTable from impact-nova/data-table (not HTML table, not raw ag-grid-react)\",\n    \"validateBeforeDone\": \"Call validate_snippet on generated UI code\",\n    \"resource\": \"impact-nova://design-system-mandate\"\n  },\n  \"requiredPeers\": [\n    {\n      \"package\": \"react\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React 19 required\"\n    },\n    {\n      \"package\": \"react-dom\",\n      \"recommendedVersion\": \"^19.0.0\",\n      \"description\": \"React DOM 19 required\"\n    },\n    {\n      \"package\": \"impact-nova-icons\",\n      \"recommendedVersion\": \">=0.1.0\",\n      \"description\": \"Icons peer — not bundled in impact-nova; 0.1.x and 0.2.x supported\"\n    }\n  ],\n  \"optionalPeers\": [\n    {\n      \"package\": \"ag-grid-community\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"AG Grid community types/API; pin to the same version as ag-grid-react\"\n    },\n    {\n      \"package\": \"ag-grid-react\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"For DataTable and grid components; use exact version to match Impact Nova\"\n    },\n    {\n      \"package\": \"ag-grid-enterprise\",\n      \"recommendedVersion\": \"36.0.1\",\n      \"description\": \"Required if using ag-grid-react with enterprise features\"\n    },\n    {\n      \"package\": \"highcharts\",\n      \"recommendedVersion\": \"^12.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-react-official\",\n      \"recommendedVersion\": \"^3.0.0\",\n      \"description\": \"For Chart component\"\n    },\n    {\n      \"package\": \"highcharts-border-radius\",\n      \"recommendedVersion\": \"^0.0.4\",\n      \"description\": \"Optional Highcharts plugin for rounded corners\"\n    }\n  ]\n}\n```\n";

package/dist/llms/rules/troubleshooting.js

@@ -1 +1 @@
-export default "# Impact Nova — Troubleshooting\n\nCommon setup and runtime issues when using Impact Nova, and how to fix them.\n\n---\n\n## 1. Duplicate React or AG Grid (Vite)\n\n**Symptom:** \"Invalid hook call\", \"Multiple copies of React\", or AG Grid warnings about multiple instances.\n\n**Fix:** In Vite config, add `resolve.dedupe` so the app uses a single copy of React and AG Grid:\n\n```js\n// vite.config.js / vite.config.ts\nimport { defineConfig } from 'vite';\nimport react from '@vitejs/plugin-react';\n\nexport default defineConfig({\n  plugins: [react()],\n  resolve: {\n    dedupe: ['react', 'react-dom', 'ag-grid-community', 'ag-grid-enterprise', 'ag-grid-react'],\n  },\n});\n```\n\n---\n\n## 2. Styles not applying\n\n**Symptom:** Components render but look unstyled or wrong.\n\n**Fix:**\n\n- Import Impact Nova CSS **once** at the app root, **before** your app component:  \n  `import 'impact-nova/dist/impact-nova.css';`  \n  Or, if you use **CSS or SCSS (no Tailwind)**, you can `@import 'impact-nova/dist/impact-nova.css';` in your main.css or main.scss. See installation **§5. Using Impact Nova with CSS or SCSS (no Tailwind)**.\n- Ensure your build includes the CSS (no rule excluding `node_modules/impact-nova`).\n- If using Tailwind, ensure the design system tokens aren’t overridden by a conflicting Tailwind theme.\n\n---\n\n## 3. Font (Manrope) not loading\n\n**Symptom:** Text renders in fallback font.\n\n**Fix:**\n\n- Add the Manrope link in `index.html`:  \n  `<link href=\"https://fonts.googleapis.com/css2?family=Manrope:wght@200..800&display=swap\" rel=\"stylesheet\" />`\n- In global CSS or Tailwind base:  \n  `body { font-family: 'Manrope', sans-serif; }`\n\n---\n\n## 4. Chart component not found or wrong export\n\n**Symptom:** `import { Chart } from 'impact-nova'` fails, Chart doesn't render, or dev throws:\n\n`The requested module '.../highcharts-react-official/dist/highcharts-react.min.js' does not provide an export named 'default'`\n\n**Fix:**\n\n- Use the public subpath: `import { Chart } from 'impact-nova/chart';`\n- Ensure Highcharts is installed: `npm install highcharts@^12 highcharts-react-official@^3`\n- In Vite, add `highcharts-react-official` to `optimizeDeps.include` (the `create-impact-nova` template includes it in `HIGHCHARTS_OPTIMIZE_DEPENDENCIES`). Clear `.vite` cache and restart dev after changing config.\n\n---\n\n## 5. impact-nova-icons SVG warnings in Vite dev\n\n**Symptom:** Hundreds of \"Failed to resolve import\" warnings for `.svg` files from `impact-nova-icons` on dev startup.\n\n**Fix:** Exclude icons from dependency pre-bundling:\n\n```js\noptimizeDeps: {\n  exclude: ['impact-nova-icons'],\n},\n```\n\nIf using Module Federation, add an asset URL rewrite plugin for `impact-nova-icons/dist/assets/*2.svg.js` shims.\n\n---\n\n## 6. React 19 — \"Cannot access refs during render\"\n\n**Symptom:** React 19 error about updating or reading refs during render.\n\n**Fix:** Never assign to `ref.current` during render. Use refs only in event handlers, effects, or callbacks. Prefer deriving values during render instead of mirroring props into refs.\n\n---\n\n## 6b. Truncated text tooltip not showing\n\n**Symptom:** `OverflowTooltip` never opens, or tooltips appear inside AG Grid cells incorrectly.\n\n**Fix:**\n\n- Ensure the trigger has **`truncate`** (or `line-clamp`) and a bounded width so CSS overflow can occur.\n- Pass explicit **`content`** when children are not plain text.\n- Inside buttons, Select options, or comboboxes: keep default **`focusable={false}`** (pointer-only).\n- **AG Grid cells:** use `useAgGridTruncationTooltip` from `impact-nova/ag-grid-react` — do not use `OverflowTooltip` in cell renderers.\n\n---\n\n## 7. HorizontalScroller or other subpath missing\n\n**Symptom:** Import from `impact-nova/horizontal-scroller` (or similar) fails.\n\n**Fix:**\n\n- If the package doesn’t export that subpath, add a Vite alias to the component file and a small TypeScript declaration:\n\n```js\n// vite.config\nresolve: {\n  alias: {\n    'impact-nova/horizontal-scroller': resolve(__dirname, 'node_modules/impact-nova/dist/components/ui/horizontal-scroller/horizontal-scroller.js'),\n  },\n},\n```\n\n```ts\n// declare module 'impact-nova/horizontal-scroller'\ndeclare module 'impact-nova/horizontal-scroller' {\n  const Component: React.ComponentType<{ /* props */ }>;\n  export default Component;\n}\n```\n\n---\n\n## 8. AG Grid CSS not applied (legacy container conflict)\n\n**Symptom:** AG Grid in a micro-frontend (MFE) looks wrong or unstyled; the new AG Grid theme is not applied.\n\n**Cause:** The **container** (host app) is loading legacy AG Grid CSS. Those legacy style tags conflict with the new theme, so the MFE’s AG Grid doesn’t get the correct styles.\n\n**Fix:** Apply the fix in the **container** app, not in the MFE/remote repo. In the container, when you mount the remote (e.g. in a `useEffect`), remove the legacy AG Grid style tags from the document so the new theme can apply. Example:\n\n```tsx\n// In the CONTAINER app (not in the MFE repo)\nuseEffect(() => {\n  const { onParentNavigate } = mount(ref.current, {\n    initialPath: history.location.pathname,\n    onNavigate: ({ pathname: nextPathname }) => {\n      const { pathname } = history.location;\n      if (pathname !== nextPathname) {\n        history.push(nextPathname);\n      }\n    },\n    containerStore,\n    routes,\n    defaultHistory: history,\n  });\n\n  history.listen(onParentNavigate);\n\n  const removeAgGridStyles = () => {\n    const styleTags = document.querySelectorAll('style');\n    styleTags.forEach((styleTag) => {\n      const content = styleTag.textContent || styleTag.innerHTML || '';\n      // Legacy AG Grid styles (--ag-legacy-styles-loaded + .ag-icon)\n      const isLegacyStyles =\n        content.includes('--ag-legacy-styles-loaded') && content.includes('.ag-icon');\n      // Generic AG Grid selectors that override the new theme\n      const hasAgGridSelectors =\n        content.includes('ag-grid,ag-grid-angular') ||\n        content.includes('ag-grid, ag-grid-angular') ||\n        content.includes('ag-grid-ng2') ||\n        content.includes('ag-grid-polymer') ||\n        content.includes('ag-grid-aurelia');\n      if (isLegacyStyles || hasAgGridSelectors) {\n        styleTag.remove();\n      }\n    });\n  };\n\n  removeAgGridStyles();\n\n  const domNode = document.getElementById('itemsmart-remote'); // or your remote mount node id\n  return () => {\n    unmountComponentAtNode(domNode);\n  };\n}, []);\n```\n\nAdjust `mount`, `ref`, `history`, `containerStore`, `routes`, and the mount node id to match your container’s setup. The important part is calling `removeAgGridStyles()` so legacy AG Grid `<style>` tags are removed and the new theme can apply.\n\n---\n\n## 9. AG Grid license or enterprise features\n\n**Symptom:** AG Grid shows watermark or enterprise features don’t work.\n\n**Fix:** Set the license key once (e.g. in root or layout):\n\n```ts\nimport { LicenseManager } from 'ag-grid-enterprise';\n\nLicenseManager.setLicenseKey('your-license-key');\n```\n\n---\n\n## 10. i18n / locale not applied\n\n**Symptom:** Date pickers, selects, or numbers show US formatting, or UI copy stays English after setting `locale`.\n\n**Fix:** Wrap the app with `ImpactNovaProviders` from `impact-nova/form`. Formatting uses BCP 47 (`locale`, optional `dateLocale` / `numberLocale`). UI copy is a separate opt-in pack — `locale=\"de-DE\"` does not load German messages by itself.\n\n```tsx\nimport { ImpactNovaProviders } from 'impact-nova/form';\nimport { de } from 'impact-nova/locale/de';\nimport { formatDate, formatNumber } from 'impact-nova/i18n';\n\n<ImpactNovaProviders locale=\"de-DE\" messages={de}>\n  <App />\n</ImpactNovaProviders>\n```\n\nDo not call `toLocaleString` in feature code. Use `formatDate` / `formatNumber` with `dateLocale` / `numberLocale` from `useImpactNovaI18n()`. See `impact-nova://i18n`.\n\n---\n\n## 11. React 19 compatibility\n\n**Symptom:** Peer dependency warnings or runtime errors after adding Impact Nova.\n\n**Fix:** Impact Nova targets React 19. Upgrade React and React DOM:\n\n```bash\nnpm install react@^19 react-dom@^19\n```\n\nUse `analyze_project_for_impact_nova` with your `package.json` content to get exact recommended versions and install commands.\n\n---\n\nUse `get_installation_and_config` for full setup steps and `impact-nova://install` for the installation resource.\n";
+export default "# Impact Nova — Troubleshooting\n\nCommon setup and runtime issues when using Impact Nova, and how to fix them.\n\n---\n\n## 1. Duplicate React or AG Grid (Vite)\n\n**Symptom:** \"Invalid hook call\", \"Multiple copies of React\", or AG Grid warnings about multiple instances.\n\n**Fix:** In Vite config, add `resolve.dedupe` so the app uses a single copy of React and AG Grid:\n\n```js\n// vite.config.js / vite.config.ts\nimport { defineConfig } from 'vite';\nimport react from '@vitejs/plugin-react';\n\nexport default defineConfig({\n  plugins: [react()],\n  resolve: {\n    dedupe: ['react', 'react-dom', 'ag-grid-community', 'ag-grid-enterprise', 'ag-grid-react'],\n  },\n});\n```\n\n---\n\n## 2. Styles not applying\n\n**Symptom:** Components render but look unstyled or wrong.\n\n**Fix:**\n\n- Import Impact Nova CSS **once** at the app root, **before** your app component:  \n  `import 'impact-nova/dist/impact-nova.css';`  \n  Or, if you use **CSS or SCSS (no Tailwind)**, you can `@import 'impact-nova/dist/impact-nova.css';` in your main.css or main.scss. See installation **§5. Using Impact Nova with CSS or SCSS (no Tailwind)**.\n- Ensure your build includes the CSS (no rule excluding `node_modules/impact-nova`).\n- If using Tailwind, ensure the design system tokens aren’t overridden by a conflicting Tailwind theme.\n\n---\n\n## 3. Font (Manrope) not loading\n\n**Symptom:** Text renders in fallback font.\n\n**Fix:**\n\n- Add the Manrope link in `index.html`:  \n  `<link href=\"https://fonts.googleapis.com/css2?family=Manrope:wght@200..800&display=swap\" rel=\"stylesheet\" />`\n- In global CSS or Tailwind base:  \n  `body { font-family: 'Manrope', sans-serif; }`\n\n---\n\n## 4. Chart component not found or wrong export\n\n**Symptom:** `import { Chart } from 'impact-nova'` fails, Chart doesn't render, or dev throws:\n\n`The requested module '.../highcharts-react-official/dist/highcharts-react.min.js' does not provide an export named 'default'`\n\n**Fix:**\n\n- Use the public subpath: `import { Chart } from 'impact-nova/chart';`\n- Ensure Highcharts is installed: `npm install highcharts@^12 highcharts-react-official@^3`\n- In Vite, add `highcharts-react-official` to `optimizeDeps.include` (the `create-impact-nova` template includes it in `HIGHCHARTS_OPTIMIZE_DEPENDENCIES`). Clear `.vite` cache and restart dev after changing config.\n\n---\n\n## 5. impact-nova-icons SVG warnings in Vite dev\n\n**Symptom:** Hundreds of \"Failed to resolve import\" warnings for `.svg` files from `impact-nova-icons` on dev startup.\n\n**Fix:** Exclude icons from dependency pre-bundling:\n\n```js\noptimizeDeps: {\n  exclude: ['impact-nova-icons'],\n},\n```\n\nIf using Module Federation, add an asset URL rewrite plugin for `impact-nova-icons/dist/assets/*2.svg.js` shims.\n\n---\n\n## 6. React 19 — \"Cannot access refs during render\"\n\n**Symptom:** React 19 error about updating or reading refs during render.\n\n**Fix:** Never assign to `ref.current` during render. Use refs only in event handlers, effects, or callbacks. Prefer deriving values during render instead of mirroring props into refs.\n\n---\n\n## 6b. Truncated text tooltip not showing\n\n**Symptom:** `OverflowTooltip` never opens, or tooltips appear inside AG Grid cells incorrectly.\n\n**Fix:**\n\n- Ensure the trigger has **`truncate`** (or `line-clamp`) and a bounded width so CSS overflow can occur.\n- Pass explicit **`content`** when children are not plain text.\n- Inside buttons, Select options, or comboboxes: keep default **`focusable={false}`** (pointer-only).\n- **AG Grid cells:** use `useAgGridTruncationTooltip` from `impact-nova/ag-grid-react` — do not use `OverflowTooltip` in cell renderers.\n\n---\n\n## 7. HorizontalScroller or other subpath missing\n\n**Symptom:** Import from `impact-nova/horizontal-scroller` (or similar) fails.\n\n**Fix:**\n\n- If the package doesn’t export that subpath, add a Vite alias to the component file and a small TypeScript declaration:\n\n```js\n// vite.config\nresolve: {\n  alias: {\n    'impact-nova/horizontal-scroller': resolve(__dirname, 'node_modules/impact-nova/dist/components/ui/horizontal-scroller/horizontal-scroller.js'),\n  },\n},\n```\n\n```ts\n// declare module 'impact-nova/horizontal-scroller'\ndeclare module 'impact-nova/horizontal-scroller' {\n  const Component: React.ComponentType<{ /* props */ }>;\n  export default Component;\n}\n```\n\n---\n\n## 8. AG Grid CSS not applied (legacy container conflict)\n\n**Symptom:** AG Grid in a micro-frontend (MFE) looks wrong or unstyled; the new AG Grid theme is not applied.\n\n**Cause:** The **container** (host app) is loading legacy AG Grid CSS. Those legacy style tags conflict with the new theme, so the MFE’s AG Grid doesn’t get the correct styles.\n\n**Fix:** Apply the fix in the **container** app, not in the MFE/remote repo. In the container, when you mount the remote (e.g. in a `useEffect`), remove the legacy AG Grid style tags from the document so the new theme can apply. Example:\n\n```tsx\n// In the CONTAINER app (not in the MFE repo)\nuseEffect(() => {\n  const { onParentNavigate } = mount(ref.current, {\n    initialPath: history.location.pathname,\n    onNavigate: ({ pathname: nextPathname }) => {\n      const { pathname } = history.location;\n      if (pathname !== nextPathname) {\n        history.push(nextPathname);\n      }\n    },\n    containerStore,\n    routes,\n    defaultHistory: history,\n  });\n\n  history.listen(onParentNavigate);\n\n  const removeAgGridStyles = () => {\n    const styleTags = document.querySelectorAll('style');\n    styleTags.forEach((styleTag) => {\n      const content = styleTag.textContent || styleTag.innerHTML || '';\n      // Legacy AG Grid styles (--ag-legacy-styles-loaded + .ag-icon)\n      const isLegacyStyles =\n        content.includes('--ag-legacy-styles-loaded') && content.includes('.ag-icon');\n      // Generic AG Grid selectors that override the new theme\n      const hasAgGridSelectors =\n        content.includes('ag-grid,ag-grid-angular') ||\n        content.includes('ag-grid, ag-grid-angular') ||\n        content.includes('ag-grid-ng2') ||\n        content.includes('ag-grid-polymer') ||\n        content.includes('ag-grid-aurelia');\n      if (isLegacyStyles || hasAgGridSelectors) {\n        styleTag.remove();\n      }\n    });\n  };\n\n  removeAgGridStyles();\n\n  const domNode = document.getElementById('itemsmart-remote'); // or your remote mount node id\n  return () => {\n    unmountComponentAtNode(domNode);\n  };\n}, []);\n```\n\nAdjust `mount`, `ref`, `history`, `containerStore`, `routes`, and the mount node id to match your container’s setup. The important part is calling `removeAgGridStyles()` so legacy AG Grid `<style>` tags are removed and the new theme can apply.\n\n---\n\n## 9. AG Grid license or enterprise features\n\n**Symptom:** AG Grid shows watermark or enterprise features don’t work.\n\n**Fix:** Set the license key once (e.g. in root or layout):\n\n```ts\nimport { LicenseManager } from 'ag-grid-enterprise';\n\nLicenseManager.setLicenseKey('your-license-key');\n```\n\n---\n\n## 10. i18n / locale not applied\n\n**Symptom:** Date pickers, selects, or other components show wrong locale or default English.\n\n**Fix:** Wrap the app with `ImpactNovaProviders` from `impact-nova/form` and pass the correct `locale` (and optional `messages`):\n\n```tsx\nimport { ImpactNovaProviders } from 'impact-nova/form';\nimport { de } from 'impact-nova/locale/de';\n\n<ImpactNovaProviders locale=\"de\" messages={de}>\n  <App />\n</ImpactNovaProviders>\n```\n\n---\n\n## 11. React 19 compatibility\n\n**Symptom:** Peer dependency warnings or runtime errors after adding Impact Nova.\n\n**Fix:** Impact Nova targets React 19. Upgrade React and React DOM:\n\n```bash\nnpm install react@^19 react-dom@^19\n```\n\nUse `analyze_project_for_impact_nova` with your `package.json` content to get exact recommended versions and install commands.\n\n---\n\nUse `get_installation_and_config` for full setup steps and `impact-nova://install` for the installation resource.\n";

package/dist/providers/app-providers.d.ts

@@ -5,11 +5,9 @@ export interface ImpactNovaProvidersProps {
     /** TooltipProvider delay (ms). */
     tooltipDelayDuration?: number;
     locale?: string;
-    dateLocale?: string;
-    numberLocale?: string;
     messages?: ImpactNovaMessages;
 }
 /**
  * App-level Impact Nova providers — mount once at root (Next.js `app/providers.tsx`).
  */
-export declare function ImpactNovaProviders({ children, tooltipDelayDuration, locale, dateLocale, numberLocale, messages, }: ImpactNovaProvidersProps): import("react/jsx-runtime").JSX.Element;
+export declare function ImpactNovaProviders({ children, tooltipDelayDuration, locale, messages, }: ImpactNovaProvidersProps): import("react/jsx-runtime").JSX.Element;

package/dist/providers/app-providers.js

@@ -1,34 +1,23 @@
 import { jsx as o } from "react/jsx-runtime";
 import "react";
-import { ImpactNovaI18nProvider as n } from "../i18n/impact-nova-i18n-context.js";
-import { defaultMessages as p } from "../i18n/defaultMessages.js";
-import { TooltipProvider as d } from "../components/feedback/tooltip/tooltip.js";
-function u({
+import { ImpactNovaI18nProvider as a } from "../i18n/impact-nova-i18n-context.js";
+import { defaultMessages as m } from "../i18n/defaultMessages.js";
+import { TooltipProvider as n } from "../components/feedback/tooltip/tooltip.js";
+function v({
   children: r,
   tooltipDelayDuration: e = 200,
   locale: t = "en",
-  dateLocale: i,
-  numberLocale: a,
-  messages: m = p
+  messages: i = m
 }) {
-  return /* @__PURE__ */ o(
+  return /* @__PURE__ */ o(a, { locale: t, messages: i, children: /* @__PURE__ */ o(
     n,
     {
-      locale: t,
-      dateLocale: i,
-      numberLocale: a,
-      messages: m,
-      children: /* @__PURE__ */ o(
-        d,
-        {
-          delayDuration: e,
-          disableHoverableContent: !1,
-          children: r
-        }
-      )
+      delayDuration: e,
+      disableHoverableContent: !1,
+      children: r
     }
-  );
+  ) });
 }
 export {
-  u as ImpactNovaProviders
+  v as ImpactNovaProviders
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impact-nova",
-  "version": "2.6.0-alpha.0",
+  "version": "2.6.0",
   "description": "Enterprise-grade React design system built with React 19, Vite, Tailwind CSS, and Radix UI. Built-in internationalization (i18n) and comprehensive UI component library for scalable, accessible, and performant applications.",
   "type": "module",
   "workspaces": [
@@ -513,22 +513,11 @@
     "./fiscal-calendar": {
       "types": "./dist/lib/fiscal-calendar/index.d.ts",
       "import": "./dist/lib/fiscal-calendar/index.js"
-    },
-    "./ag-grid-react/comments": {
-      "types": "./dist/components/data/ag-grid-react/comments/index.d.ts",
-      "import": "./dist/components/data/ag-grid-react/comments/index.js"
-    },
-    "./ag-grid-react/notes": {
-      "types": "./dist/components/data/ag-grid-react/notes/index.d.ts",
-      "import": "./dist/components/data/ag-grid-react/notes/index.js"
-    },
-    "./ag-grid-react/chat": {
-      "types": "./dist/components/data/ag-grid-react/chat/index.d.ts",
-      "import": "./dist/components/data/ag-grid-react/chat/index.js"
     }
   },
   "scripts": {
     "dev": "vite",
+    "dev:watch": "vite build --watch",
     "postpublish": "node scripts/publish-git-tag.mjs",
     "publish:alpha": "npm publish --tag alpha --access public",
     "publish:stable": "npm publish --access public",

package/dist/components/data/ag-grid-react/chat/chat-capabilities.d.ts

@@ -1,9 +0,0 @@
-import { ChatAction, ChatActionContext, ChatCapabilities, DataTableChatConfig } from './chat.types';
-export declare const DEFAULT_CHAT_CAPABILITIES: ChatCapabilities;
-export declare function resolveChatCapabilities(getCapabilities: ((rowId: string) => ChatCapabilities) | undefined, rowId: string): ChatCapabilities;
-/**
- * Nova asks. The consumer answers.
- * `can` returning `undefined` falls through to getCapabilities + listPeople.
- * Invite/remove default to off when `listPeople` is omitted (read-only roster).
- */
-export declare function chatAllows(config: Pick<DataTableChatConfig, "getCapabilities" | "can" | "listPeople">, action: ChatAction, context: ChatActionContext): boolean;

package/dist/components/data/ag-grid-react/chat/chat-capabilities.js

@@ -1,22 +0,0 @@
-const n = {
-  canView: !0,
-  canCreate: !0,
-  canEdit: !1,
-  canDelete: !1
-};
-function l(r, e) {
-  return r?.(e) ?? n;
-}
-function i(r, e, a) {
-  const t = l(r.getCapabilities, a.rowId);
-  return e === "view" ? t.canView : e === "create" ? t.canCreate : e === "edit" ? t.canEdit : e === "delete" ? t.canDelete : t.canCreate && r.listPeople != null;
-}
-function u(r, e, a) {
-  const t = r.can?.(e, a);
-  return typeof t == "boolean" ? t : i(r, e, a);
-}
-export {
-  n as DEFAULT_CHAT_CAPABILITIES,
-  u as chatAllows,
-  l as resolveChatCapabilities
-};

package/dist/components/data/ag-grid-react/chat/chat-column.d.ts

@@ -1,20 +0,0 @@
-import { ColDef, ColGroupDef, ICellRendererComp } from 'ag-grid-community';
-import { ChatPriority, DataTableChatConfig } from './chat.types';
-export declare function resolveChatColumnId(config: DataTableChatConfig): string | undefined;
-export declare function shouldInjectChatColumn(config: DataTableChatConfig): boolean;
-type ChatCellPresence = {
-    hasConversation: (rowId: string) => boolean;
-    unreadCount: (rowId: string) => number;
-    priority: (rowId: string) => ChatPriority | undefined;
-    label: (rowId: string, unread: number) => string;
-};
-export declare function createChatCellRenderer(read: () => ChatCellPresence): new () => ICellRendererComp;
-export declare function createChatSystemColumn(args: {
-    headerName: string;
-    cellRenderer: ColDef["cellRenderer"];
-    pinned?: "left" | "right" | null;
-    width?: number;
-}): ColDef;
-export declare function columnDefsIncludeColId(columnDefs: (ColDef | ColGroupDef)[] | undefined, colId: string): boolean;
-export declare function appendChatSystemColumn(columnDefs: (ColDef | ColGroupDef)[] | undefined, chatColumn: ColDef): (ColDef | ColGroupDef)[];
-export {};

package/dist/components/data/ag-grid-react/chat/chat-column.js

@@ -1,81 +0,0 @@
-import { IV_CHAT_COL_ID as o, IV_CHAT_COL_WIDTH as h } from "./chat-constants.js";
-const m = new URL("data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='21'%20height='21'%20viewBox='0%200%2021%2021'%20fill='none'%3e%3cpath%20d='M3.88867%204H17.1113C17.3481%204.00006%2017.5748%204.09396%2017.7412%204.25977C17.9074%204.42549%2018%204.65002%2018%204.88281V14.2939C18%2014.5268%2017.9075%2014.7513%2017.7412%2014.917C17.5748%2015.0828%2017.3481%2015.1767%2017.1113%2015.1768H6.4082C5.78401%2015.1768%205.17582%2015.3782%204.67578%2015.752L3%2017.0039V4.88281C3%204.65002%203.09261%204.42549%203.25879%204.25977C3.42517%204.09396%203.65189%204.00006%203.88867%204Z'%20stroke='url(%23iv-chat-message-stroke)'%20stroke-width='2'/%3e%3cdefs%3e%3clinearGradient%20id='iv-chat-message-stroke'%20x1='19'%20y1='11'%20x2='2'%20y2='11'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%234259EE'/%3e%3cstop%20offset='1'%20stop-color='%23F19579'/%3e%3c/linearGradient%3e%3c/defs%3e%3c/svg%3e", import.meta.url).href;
-function v(e) {
-  return e.column === !1 ? e.colId : e.colId ?? o;
-}
-function l(e, r, t, n) {
-  const i = t.node?.id;
-  if (!i) {
-    e.hidden = !0, e.removeAttribute("data-row-id"), e.removeAttribute("data-iv-chat-active"), e.removeAttribute("data-iv-chat-priority"), e.removeAttribute("aria-label"), r.remove();
-    return;
-  }
-  const a = n(), s = Math.max(0, a.unreadCount(i)), u = a.hasConversation(i);
-  e.hidden = !1, e.setAttribute("data-row-id", i), e.setAttribute("aria-label", a.label(i, s)), u ? e.setAttribute("data-iv-chat-active", "") : e.removeAttribute("data-iv-chat-active");
-  const c = a.priority(i);
-  c ? e.setAttribute("data-iv-chat-priority", c) : e.removeAttribute("data-iv-chat-priority"), s > 0 ? (r.textContent = s > 99 ? "99+" : String(s), r.isConnected || (e.querySelector(".iv-chat-cell-icon") ?? e).append(r)) : r.remove();
-}
-function A(e) {
-  return class {
-    button = document.createElement("button");
-    badge = document.createElement("span");
-    init(t) {
-      this.button.type = "button", this.button.className = "iv-chat-cell-button", this.button.setAttribute("data-iv-chat-cell", "");
-      const n = document.createElement("span");
-      n.className = "iv-chat-cell-icon", n.setAttribute("aria-hidden", "true");
-      const i = document.createElement("img");
-      i.src = m, i.alt = "", i.width = 21, i.height = 21, n.append(i), this.button.append(n), this.badge.className = "iv-chat-unread", l(this.button, this.badge, t, e);
-    }
-    getGui() {
-      return this.button;
-    }
-    refresh(t) {
-      return l(this.button, this.badge, t, e), !0;
-    }
-  };
-}
-function b(e) {
-  const r = e.width ?? h, t = e.pinned === void 0 ? "right" : e.pinned;
-  return {
-    colId: o,
-    headerName: e.headerName,
-    width: r,
-    minWidth: r,
-    maxWidth: r,
-    pinned: t,
-    lockPosition: t === "left" ? "left" : "right",
-    lockPinned: !0,
-    suppressMovable: !0,
-    suppressAutoSize: !0,
-    sortable: !1,
-    filter: !1,
-    resizable: !1,
-    suppressHeaderMenuButton: !0,
-    suppressColumnsToolPanel: !0,
-    context: { ivSystemColumn: !0 },
-    cellRenderer: e.cellRenderer,
-    valueGetter: () => ""
-  };
-}
-function d(e, r) {
-  if (!e) return !1;
-  for (const t of e) {
-    if ("children" in t && Array.isArray(t.children)) {
-      if (d(t.children, r)) return !0;
-      continue;
-    }
-    const n = t;
-    if ((n.colId ?? n.field) === r) return !0;
-  }
-  return !1;
-}
-function y(e, r) {
-  const t = e ?? [];
-  return d(t, o) ? t : [...t, r];
-}
-export {
-  y as appendChatSystemColumn,
-  d as columnDefsIncludeColId,
-  A as createChatCellRenderer,
-  b as createChatSystemColumn,
-  v as resolveChatColumnId
-};

package/dist/components/data/ag-grid-react/chat/chat-composer.d.ts

@@ -1,10 +0,0 @@
-import { ChatComposerRenderProps, ChatComposerToolContext, DataTableChatConfig } from './chat.types';
-export declare function ChatSendIcon(): import("react/jsx-runtime").JSX.Element;
-export declare function ChatComposer({ value, onChange, onSave, disabled, saving, author, placeholder, render, tools, toolContext, hideSend, hideChrome, priority, onPriorityChange, attachments, onAttachmentsChange, }: ChatComposerRenderProps & {
-    placeholder: string;
-    render?: DataTableChatConfig["renderComposer"];
-    tools?: DataTableChatConfig["composerTools"];
-    toolContext?: ChatComposerToolContext;
-    hideSend?: boolean;
-    hideChrome?: boolean;
-}): import("react/jsx-runtime").JSX.Element;