igniteui-cli 15.6.1 → 15.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/commands/ai-config.js +6 -4
- package/lib/commands/upgrade.js +4 -7
- package/package.json +4 -4
- package/templates/blazor/igb/projects/ai-config/files/skills/AGENTS.md +1 -1
- package/templates/blazor/igb/projects/ai-config/files/skills/README.md +1 -7
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/SKILL.md +8 -6
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/client-scripts.md +100 -0
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/data-display.md +25 -2
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/form-controls.md +20 -0
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/layout.md +15 -1
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/setup.md +13 -3
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/SKILL.md +2 -2
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/references/component-mapping.md +3 -0
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/SKILL.md +2 -2
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/SKILL.md +1 -2
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/references/common-patterns.md +0 -1
- package/templates/react/igr-ts/breadcrumbs/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/breadcrumbs/default/files/src/app/__path__/__filePrefix__.tsx +20 -0
- package/templates/react/igr-ts/breadcrumbs/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/breadcrumbs/default/index.d.ts +1 -0
- package/templates/react/igr-ts/breadcrumbs/default/index.js +18 -0
- package/templates/react/igr-ts/breadcrumbs/index.d.ts +1 -0
- package/templates/react/igr-ts/breadcrumbs/index.js +12 -0
- package/templates/react/igr-ts/bullet-graph/default/index.js +2 -1
- package/templates/react/igr-ts/carousel/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/carousel/default/files/src/app/__path__/__filePrefix__.tsx +27 -0
- package/templates/react/igr-ts/carousel/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/carousel/default/index.d.ts +1 -0
- package/templates/react/igr-ts/carousel/default/index.js +18 -0
- package/templates/react/igr-ts/carousel/index.d.ts +1 -0
- package/templates/react/igr-ts/carousel/index.js +12 -0
- package/templates/react/igr-ts/category-chart/default/index.js +2 -1
- package/templates/react/igr-ts/chat/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/chat/default/files/src/app/__path__/__filePrefix__.tsx +20 -0
- package/templates/react/igr-ts/chat/default/files/src/app/__path__/style.module.css +21 -0
- package/templates/react/igr-ts/chat/default/index.d.ts +1 -0
- package/templates/react/igr-ts/chat/default/index.js +18 -0
- package/templates/react/igr-ts/chat/index.d.ts +1 -0
- package/templates/react/igr-ts/chat/index.js +12 -0
- package/templates/react/igr-ts/color-picker/color-picker-alpha/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/color-picker/color-picker-alpha/files/src/app/__path__/__filePrefix__.tsx +23 -0
- package/templates/react/igr-ts/color-picker/color-picker-alpha/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/color-picker/color-picker-alpha/index.d.ts +1 -0
- package/templates/react/igr-ts/color-picker/color-picker-alpha/index.js +18 -0
- package/templates/react/igr-ts/color-picker/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/color-picker/default/files/src/app/__path__/__filePrefix__.tsx +16 -0
- package/templates/react/igr-ts/color-picker/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/color-picker/default/index.d.ts +1 -0
- package/templates/react/igr-ts/color-picker/default/index.js +18 -0
- package/templates/react/igr-ts/color-picker/index.d.ts +1 -0
- package/templates/react/igr-ts/color-picker/index.js +12 -0
- package/templates/react/igr-ts/combo/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/combo/default/files/src/app/__path__/__filePrefix__.tsx +30 -0
- package/templates/react/igr-ts/combo/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/combo/default/index.d.ts +1 -0
- package/templates/react/igr-ts/combo/default/index.js +18 -0
- package/templates/react/igr-ts/combo/index.d.ts +1 -0
- package/templates/react/igr-ts/combo/index.js +12 -0
- package/templates/react/igr-ts/constants.d.ts +4 -2
- package/templates/react/igr-ts/constants.js +5 -3
- package/templates/react/igr-ts/date-range-picker/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/date-range-picker/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/date-range-picker/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/date-range-picker/default/index.d.ts +1 -0
- package/templates/react/igr-ts/date-range-picker/default/index.js +18 -0
- package/templates/react/igr-ts/date-range-picker/index.d.ts +1 -0
- package/templates/react/igr-ts/date-range-picker/index.js +12 -0
- package/templates/react/igr-ts/date-time-input/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/date-time-input/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/date-time-input/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/date-time-input/default/index.d.ts +1 -0
- package/templates/react/igr-ts/date-time-input/default/index.js +18 -0
- package/templates/react/igr-ts/date-time-input/index.d.ts +1 -0
- package/templates/react/igr-ts/date-time-input/index.js +12 -0
- package/templates/react/igr-ts/dialog/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/dialog/default/files/src/app/__path__/__filePrefix__.tsx +20 -0
- package/templates/react/igr-ts/dialog/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/dialog/default/index.d.ts +1 -0
- package/templates/react/igr-ts/dialog/default/index.js +18 -0
- package/templates/react/igr-ts/dialog/index.d.ts +1 -0
- package/templates/react/igr-ts/dialog/index.js +12 -0
- package/templates/react/igr-ts/divider/default/index.js +1 -1
- package/templates/react/igr-ts/divider/index.js +1 -1
- package/templates/react/igr-ts/doughnut-chart/default/index.js +2 -1
- package/templates/react/igr-ts/file-input/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/file-input/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/file-input/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/file-input/default/index.d.ts +1 -0
- package/templates/react/igr-ts/file-input/default/index.js +18 -0
- package/templates/react/igr-ts/file-input/index.d.ts +1 -0
- package/templates/react/igr-ts/file-input/index.js +12 -0
- package/templates/react/igr-ts/financial-chart/default/index.js +2 -1
- package/templates/react/igr-ts/grid/basic/index.js +1 -1
- package/templates/react/igr-ts/groups.json +7 -8
- package/templates/react/igr-ts/hierarchical-grid/basic/index.js +1 -1
- package/templates/react/igr-ts/highlight/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/highlight/default/files/src/app/__path__/__filePrefix__.tsx +16 -0
- package/templates/react/igr-ts/highlight/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/highlight/default/index.d.ts +1 -0
- package/templates/react/igr-ts/highlight/default/index.js +18 -0
- package/templates/react/igr-ts/highlight/index.d.ts +1 -0
- package/templates/react/igr-ts/highlight/index.js +12 -0
- package/templates/react/igr-ts/linear-gauge/default/index.js +2 -1
- package/templates/react/igr-ts/mask-input/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/mask-input/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/mask-input/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/mask-input/default/index.d.ts +1 -0
- package/templates/react/igr-ts/mask-input/default/index.js +18 -0
- package/templates/react/igr-ts/mask-input/index.d.ts +1 -0
- package/templates/react/igr-ts/mask-input/index.js +12 -0
- package/templates/react/igr-ts/nav-drawer/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/nav-drawer/default/files/src/app/__path__/__filePrefix__.tsx +27 -0
- package/templates/react/igr-ts/nav-drawer/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/nav-drawer/default/index.d.ts +1 -0
- package/templates/react/igr-ts/nav-drawer/default/index.js +18 -0
- package/templates/react/igr-ts/nav-drawer/index.d.ts +1 -0
- package/templates/react/igr-ts/nav-drawer/index.js +12 -0
- package/templates/react/igr-ts/pie-chart/default/index.js +2 -1
- package/templates/react/igr-ts/pivot-grid/basic/index.js +1 -1
- package/templates/react/igr-ts/projects/_base/files/package.json +1 -1
- package/templates/react/igr-ts/projects/ai-config/files/skills/README.md +7 -7
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/SKILL.md +10 -9
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/{reference → references}/DATAVIZ.md +1 -1
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/SKILL.md +4 -3
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/SKILL.md +5 -4
- package/templates/react/igr-ts/projects/ai-config/files/skills/{grid-lite-to-igr-grid-migration → igniteui-react-migrate-grid-lite-to-premium}/SKILL.md +3 -2
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-optimize-bundle-size/SKILL.md +4 -3
- package/templates/react/igr-ts/qr-code/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/qr-code/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/qr-code/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/qr-code/default/index.d.ts +1 -0
- package/templates/react/igr-ts/qr-code/default/index.js +18 -0
- package/templates/react/igr-ts/qr-code/index.d.ts +1 -0
- package/templates/react/igr-ts/qr-code/index.js +12 -0
- package/templates/react/igr-ts/radial-gauge/default/index.js +2 -2
- package/templates/react/igr-ts/range-slider/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/range-slider/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/range-slider/default/files/src/app/__path__/style.module.css +14 -0
- package/templates/react/igr-ts/range-slider/default/index.d.ts +1 -0
- package/templates/react/igr-ts/range-slider/default/index.js +18 -0
- package/templates/react/igr-ts/range-slider/index.d.ts +1 -0
- package/templates/react/igr-ts/range-slider/index.js +12 -0
- package/templates/react/igr-ts/select/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/select/default/files/src/app/__path__/__filePrefix__.tsx +25 -0
- package/templates/react/igr-ts/select/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/select/default/index.d.ts +1 -0
- package/templates/react/igr-ts/select/default/index.js +18 -0
- package/templates/react/igr-ts/select/index.d.ts +1 -0
- package/templates/react/igr-ts/select/index.js +12 -0
- package/templates/react/igr-ts/snackbar/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/snackbar/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/snackbar/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/snackbar/default/index.d.ts +1 -0
- package/templates/react/igr-ts/snackbar/default/index.js +18 -0
- package/templates/react/igr-ts/snackbar/index.d.ts +1 -0
- package/templates/react/igr-ts/snackbar/index.js +12 -0
- package/templates/react/igr-ts/splitter/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/splitter/default/files/src/app/__path__/__filePrefix__.tsx +21 -0
- package/templates/react/igr-ts/splitter/default/files/src/app/__path__/style.module.css +31 -0
- package/templates/react/igr-ts/splitter/default/index.d.ts +1 -0
- package/templates/react/igr-ts/splitter/default/index.js +18 -0
- package/templates/react/igr-ts/splitter/index.d.ts +1 -0
- package/templates/react/igr-ts/splitter/index.js +12 -0
- package/templates/react/igr-ts/stepper/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/stepper/default/files/src/app/__path__/__filePrefix__.tsx +27 -0
- package/templates/react/igr-ts/stepper/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/stepper/default/index.d.ts +1 -0
- package/templates/react/igr-ts/stepper/default/index.js +18 -0
- package/templates/react/igr-ts/stepper/index.d.ts +1 -0
- package/templates/react/igr-ts/stepper/index.js +12 -0
- package/templates/react/igr-ts/theme-provider/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/theme-provider/default/files/src/app/__path__/__filePrefix__.tsx +18 -0
- package/templates/react/igr-ts/theme-provider/default/files/src/app/__path__/style.module.css +25 -0
- package/templates/react/igr-ts/theme-provider/default/index.d.ts +1 -0
- package/templates/react/igr-ts/theme-provider/default/index.js +18 -0
- package/templates/react/igr-ts/theme-provider/index.d.ts +1 -0
- package/templates/react/igr-ts/theme-provider/index.js +12 -0
- package/templates/react/igr-ts/tile-manager/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/tile-manager/default/files/src/app/__path__/__filePrefix__.tsx +27 -0
- package/templates/react/igr-ts/tile-manager/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/tile-manager/default/index.d.ts +1 -0
- package/templates/react/igr-ts/tile-manager/default/index.js +18 -0
- package/templates/react/igr-ts/tile-manager/index.d.ts +1 -0
- package/templates/react/igr-ts/tile-manager/index.js +12 -0
- package/templates/react/igr-ts/toast/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/toast/default/files/src/app/__path__/__filePrefix__.tsx +14 -0
- package/templates/react/igr-ts/toast/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/toast/default/index.d.ts +1 -0
- package/templates/react/igr-ts/toast/default/index.js +18 -0
- package/templates/react/igr-ts/toast/index.d.ts +1 -0
- package/templates/react/igr-ts/toast/index.js +12 -0
- package/templates/react/igr-ts/toggle-button/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/toggle-button/default/files/src/app/__path__/__filePrefix__.tsx +16 -0
- package/templates/react/igr-ts/toggle-button/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/toggle-button/default/index.d.ts +1 -0
- package/templates/react/igr-ts/toggle-button/default/index.js +18 -0
- package/templates/react/igr-ts/toggle-button/index.d.ts +1 -0
- package/templates/react/igr-ts/toggle-button/index.js +12 -0
- package/templates/react/igr-ts/tooltip/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/tooltip/default/files/src/app/__path__/__filePrefix__.tsx +15 -0
- package/templates/react/igr-ts/tooltip/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/tooltip/default/index.d.ts +1 -0
- package/templates/react/igr-ts/tooltip/default/index.js +18 -0
- package/templates/react/igr-ts/tooltip/index.d.ts +1 -0
- package/templates/react/igr-ts/tooltip/index.js +12 -0
- package/templates/react/igr-ts/tree-grid/basic/index.js +1 -1
- package/templates/react/igr-ts/virtual-scroll/default/files/src/app/__path__/__filePrefix__.test.tsx +13 -0
- package/templates/react/igr-ts/virtual-scroll/default/files/src/app/__path__/__filePrefix__.tsx +34 -0
- package/templates/react/igr-ts/virtual-scroll/default/files/src/app/__path__/style.module.css +16 -0
- package/templates/react/igr-ts/virtual-scroll/default/index.d.ts +1 -0
- package/templates/react/igr-ts/virtual-scroll/default/index.js +18 -0
- package/templates/react/igr-ts/virtual-scroll/index.d.ts +1 -0
- package/templates/react/igr-ts/virtual-scroll/index.js +12 -0
- package/templates/webcomponents/igc-ts/breadcrumb/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/breadcrumb/default/files/src/app/__path__/__filePrefix__.ts +36 -0
- package/templates/webcomponents/igc-ts/breadcrumb/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/breadcrumb/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/breadcrumb/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/breadcrumb/index.js +15 -0
- package/templates/webcomponents/igc-ts/carousel/carousel-vertical/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/carousel/carousel-vertical/files/src/app/__path__/__filePrefix__.ts +46 -0
- package/templates/webcomponents/igc-ts/carousel/carousel-vertical/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/carousel/carousel-vertical/index.js +16 -0
- package/templates/webcomponents/igc-ts/carousel/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/carousel/default/files/src/app/__path__/__filePrefix__.ts +45 -0
- package/templates/webcomponents/igc-ts/carousel/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/carousel/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/carousel/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/carousel/index.js +15 -0
- package/templates/webcomponents/igc-ts/chat/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/chat/default/files/src/app/__path__/__filePrefix__.ts +46 -0
- package/templates/webcomponents/igc-ts/chat/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/chat/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/chat/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/chat/index.js +15 -0
- package/templates/webcomponents/igc-ts/color-picker/color-picker-alpha/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/color-picker/color-picker-alpha/files/src/app/__path__/__filePrefix__.ts +31 -0
- package/templates/webcomponents/igc-ts/color-picker/color-picker-alpha/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/color-picker/color-picker-alpha/index.js +16 -0
- package/templates/webcomponents/igc-ts/color-picker/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/color-picker/default/files/src/app/__path__/__filePrefix__.ts +29 -0
- package/templates/webcomponents/igc-ts/color-picker/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/color-picker/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/color-picker/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/color-picker/index.js +15 -0
- package/templates/webcomponents/igc-ts/combo/combo-groups/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/combo/combo-groups/files/src/app/__path__/__filePrefix__.ts +39 -0
- package/templates/webcomponents/igc-ts/combo/combo-groups/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/combo/combo-groups/index.js +16 -0
- package/templates/webcomponents/igc-ts/combo/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/combo/default/files/src/app/__path__/__filePrefix__.ts +31 -0
- package/templates/webcomponents/igc-ts/combo/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/combo/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/combo/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/combo/index.js +15 -0
- package/templates/webcomponents/igc-ts/date-range-picker/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/date-range-picker/default/files/src/app/__path__/__filePrefix__.ts +17 -0
- package/templates/webcomponents/igc-ts/date-range-picker/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/date-range-picker/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/date-range-picker/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/date-range-picker/index.js +15 -0
- package/templates/webcomponents/igc-ts/dialog/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/dialog/default/files/src/app/__path__/__filePrefix__.ts +28 -0
- package/templates/webcomponents/igc-ts/dialog/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/dialog/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/dialog/dialog-form/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/dialog/dialog-form/files/src/app/__path__/__filePrefix__.ts +32 -0
- package/templates/webcomponents/igc-ts/dialog/dialog-form/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/dialog/dialog-form/index.js +16 -0
- package/templates/webcomponents/igc-ts/dialog/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/dialog/index.js +15 -0
- package/templates/webcomponents/igc-ts/divider/default/index.js +1 -1
- package/templates/webcomponents/igc-ts/divider/index.js +1 -1
- package/templates/webcomponents/igc-ts/file-input/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/file-input/default/files/src/app/__path__/__filePrefix__.ts +21 -0
- package/templates/webcomponents/igc-ts/file-input/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/file-input/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/file-input/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/file-input/index.js +15 -0
- package/templates/webcomponents/igc-ts/groups.json +9 -10
- package/templates/webcomponents/igc-ts/highlight/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/highlight/default/files/src/app/__path__/__filePrefix__.ts +34 -0
- package/templates/webcomponents/igc-ts/highlight/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/highlight/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/highlight/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/highlight/index.js +15 -0
- package/templates/webcomponents/igc-ts/mask-input/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/mask-input/default/files/src/app/__path__/__filePrefix__.ts +17 -0
- package/templates/webcomponents/igc-ts/mask-input/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/mask-input/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/mask-input/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/mask-input/index.js +15 -0
- package/templates/webcomponents/igc-ts/mask-input/mask-input-formats/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/mask-input/mask-input-formats/files/src/app/__path__/__filePrefix__.ts +20 -0
- package/templates/webcomponents/igc-ts/mask-input/mask-input-formats/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/mask-input/mask-input-formats/index.js +16 -0
- package/templates/webcomponents/igc-ts/nav-drawer/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/nav-drawer/default/files/src/app/__path__/__filePrefix__.ts +40 -0
- package/templates/webcomponents/igc-ts/nav-drawer/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/nav-drawer/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/nav-drawer/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/nav-drawer/index.js +15 -0
- package/templates/webcomponents/igc-ts/projects/_base/files/package.json +1 -1
- package/templates/webcomponents/igc-ts/projects/_base_with_home/files/package.json +1 -1
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/README.md +4 -3
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-choose-components/SKILL.md +2 -1
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-customize-component-theme/SKILL.md +2 -1
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/SKILL.md +328 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/asset-extraction.md +343 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/design-provenance.md +199 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/design-token-bridge.md +489 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/figma-component-map.md +370 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/figma-exploration.md +222 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/mcp-setup.md +363 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/project-setup.md +105 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/theme-generation.md +180 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-figma-to-app/references/validation-patterns.md +370 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-generate-from-image-design/SKILL.md +2 -1
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-generate-from-image-design/references/gotchas.md +24 -3
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-grids/SKILL.md +133 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-integrate-with-framework/SKILL.md +6 -4
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-integrate-with-framework/references/vanilla-js.md +14 -0
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-migrate-grid-lite-to-premium/SKILL.md +36 -8
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/igniteui-wc-optimize-bundle-size/SKILL.md +2 -1
- package/templates/webcomponents/igc-ts/qr-code/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/qr-code/default/files/src/app/__path__/__filePrefix__.ts +20 -0
- package/templates/webcomponents/igc-ts/qr-code/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/qr-code/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/qr-code/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/qr-code/index.js +15 -0
- package/templates/webcomponents/igc-ts/range-slider/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/range-slider/default/files/src/app/__path__/__filePrefix__.ts +26 -0
- package/templates/webcomponents/igc-ts/range-slider/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/range-slider/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/range-slider/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/range-slider/index.js +15 -0
- package/templates/webcomponents/igc-ts/select/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/select/default/files/src/app/__path__/__filePrefix__.ts +26 -0
- package/templates/webcomponents/igc-ts/select/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/select/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/select/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/select/index.js +15 -0
- package/templates/webcomponents/igc-ts/select/select-groups/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/select/select-groups/files/src/app/__path__/__filePrefix__.ts +42 -0
- package/templates/webcomponents/igc-ts/select/select-groups/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/select/select-groups/index.js +16 -0
- package/templates/webcomponents/igc-ts/snackbar/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/snackbar/default/files/src/app/__path__/__filePrefix__.ts +24 -0
- package/templates/webcomponents/igc-ts/snackbar/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/snackbar/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/snackbar/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/snackbar/index.js +15 -0
- package/templates/webcomponents/igc-ts/snackbar/snackbar-action/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/snackbar/snackbar-action/files/src/app/__path__/__filePrefix__.ts +25 -0
- package/templates/webcomponents/igc-ts/snackbar/snackbar-action/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/snackbar/snackbar-action/index.js +16 -0
- package/templates/webcomponents/igc-ts/splitter/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/splitter/default/files/src/app/__path__/__filePrefix__.ts +31 -0
- package/templates/webcomponents/igc-ts/splitter/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/splitter/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/splitter/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/splitter/index.js +15 -0
- package/templates/webcomponents/igc-ts/splitter/splitter-vertical/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/splitter/splitter-vertical/files/src/app/__path__/__filePrefix__.ts +27 -0
- package/templates/webcomponents/igc-ts/splitter/splitter-vertical/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/splitter/splitter-vertical/index.js +16 -0
- package/templates/webcomponents/igc-ts/stepper/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/stepper/default/files/src/app/__path__/__filePrefix__.ts +38 -0
- package/templates/webcomponents/igc-ts/stepper/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/stepper/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/stepper/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/stepper/index.js +15 -0
- package/templates/webcomponents/igc-ts/stepper/stepper-vertical/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/stepper/stepper-vertical/files/src/app/__path__/__filePrefix__.ts +37 -0
- package/templates/webcomponents/igc-ts/stepper/stepper-vertical/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/stepper/stepper-vertical/index.js +16 -0
- package/templates/webcomponents/igc-ts/theme-provider/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/theme-provider/default/files/src/app/__path__/__filePrefix__.ts +40 -0
- package/templates/webcomponents/igc-ts/theme-provider/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/theme-provider/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/theme-provider/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/theme-provider/index.js +15 -0
- package/templates/webcomponents/igc-ts/tile-manager/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/tile-manager/default/files/src/app/__path__/__filePrefix__.ts +40 -0
- package/templates/webcomponents/igc-ts/tile-manager/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/tile-manager/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/tile-manager/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/tile-manager/index.js +15 -0
- package/templates/webcomponents/igc-ts/toast/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/toast/default/files/src/app/__path__/__filePrefix__.ts +22 -0
- package/templates/webcomponents/igc-ts/toast/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/toast/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/toast/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/toast/index.js +15 -0
- package/templates/webcomponents/igc-ts/toggle-button/default/files/src/app/__path__/__filePrefix__.test.ts +25 -0
- package/templates/webcomponents/igc-ts/toggle-button/default/files/src/app/__path__/__filePrefix__.ts +61 -0
- package/templates/webcomponents/igc-ts/toggle-button/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/toggle-button/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/toggle-button/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/toggle-button/index.js +15 -0
- package/templates/webcomponents/igc-ts/tooltip/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/tooltip/default/files/src/app/__path__/__filePrefix__.ts +22 -0
- package/templates/webcomponents/igc-ts/tooltip/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/tooltip/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/tooltip/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/tooltip/index.js +15 -0
- package/templates/webcomponents/igc-ts/virtual-scroll/default/files/src/app/__path__/__filePrefix__.test.ts +9 -0
- package/templates/webcomponents/igc-ts/virtual-scroll/default/files/src/app/__path__/__filePrefix__.ts +64 -0
- package/templates/webcomponents/igc-ts/virtual-scroll/default/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/virtual-scroll/default/index.js +16 -0
- package/templates/webcomponents/igc-ts/virtual-scroll/index.d.ts +1 -0
- package/templates/webcomponents/igc-ts/virtual-scroll/index.js +15 -0
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-lite-testing/SKILL.md +0 -86
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-lite-testing/references/interop-contracts.md +0 -220
- package/templates/react/igr-ts/projects/_base/files/__dot__vscode/mcp.json +0 -12
- package/templates/webcomponents/igc-ts/projects/_base/files/__dot__vscode/mcp.json +0 -12
- /package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/{reference → references}/COMPONENTS.md +0 -0
- /package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/{reference → references}/MCP.md +0 -0
- /package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/{reference → references}/TROUBLESHOOTING.md +0 -0
- /package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/{reference → references}/USAGE.md +0 -0
- /package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/{reference → references}/CSS-THEMING.md +0 -0
- /package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/{reference → references}/gotchas.md +0 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const cli_core_1 = require("@igniteui/cli-core");
|
|
4
|
+
class IgcTooltipComponent extends cli_core_1.BaseComponent {
|
|
5
|
+
/**
|
|
6
|
+
*
|
|
7
|
+
*/
|
|
8
|
+
constructor() {
|
|
9
|
+
super(__dirname);
|
|
10
|
+
this.name = "Tooltip";
|
|
11
|
+
this.group = "Interactions";
|
|
12
|
+
this.description = `Displays informative text when users hover, focus or tap an element`;
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
module.exports = new IgcTooltipComponent();
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import $(ClassName) from './$(path).js';
|
|
3
|
+
|
|
4
|
+
describe('IgcVirtualScrollComponent', () => {
|
|
5
|
+
it('<app-$(path)> is an instance of $(ClassName)', async () => {
|
|
6
|
+
const element = document.createElement('app-$(path)');
|
|
7
|
+
expect(element).to.be.instanceOf($(ClassName));
|
|
8
|
+
});
|
|
9
|
+
});
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { html, LitElement, css } from 'lit';
|
|
2
|
+
import { customElement } from 'lit/decorators.js';
|
|
3
|
+
import {
|
|
4
|
+
defineComponents,
|
|
5
|
+
IgcAvatarComponent,
|
|
6
|
+
IgcListComponent,
|
|
7
|
+
IgcListItemComponent,
|
|
8
|
+
IgcVirtualScrollComponent,
|
|
9
|
+
type VirtualScrollItemContext,
|
|
10
|
+
type VirtualScrollItemTemplate,
|
|
11
|
+
} from 'igniteui-webcomponents';
|
|
12
|
+
|
|
13
|
+
defineComponents(
|
|
14
|
+
IgcVirtualScrollComponent,
|
|
15
|
+
IgcListComponent,
|
|
16
|
+
IgcListItemComponent,
|
|
17
|
+
IgcAvatarComponent,
|
|
18
|
+
);
|
|
19
|
+
|
|
20
|
+
interface Employee {
|
|
21
|
+
name: string;
|
|
22
|
+
email: string;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
@customElement('app-$(path)')
|
|
26
|
+
export default class $(ClassName) extends LitElement {
|
|
27
|
+
// host must have an explicit width - it's a flex item with no intrinsic size
|
|
28
|
+
static styles = css`
|
|
29
|
+
:host {
|
|
30
|
+
display: block;
|
|
31
|
+
width: 100%;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
igc-virtual-scroll {
|
|
35
|
+
height: 320px;
|
|
36
|
+
}
|
|
37
|
+
`;
|
|
38
|
+
|
|
39
|
+
private employees: Employee[] = Array.from({ length: 1000 }, (_, i) => ({
|
|
40
|
+
name: `Employee ${i + 1}`,
|
|
41
|
+
email: `employee${i + 1}@example.com`,
|
|
42
|
+
}));
|
|
43
|
+
|
|
44
|
+
private itemTemplate: VirtualScrollItemTemplate<Employee> = (
|
|
45
|
+
ctx: VirtualScrollItemContext<Employee>
|
|
46
|
+
) => html`
|
|
47
|
+
<igc-list-item>
|
|
48
|
+
<igc-avatar slot="start" shape="circle" initials=${ctx.value.name.slice(0, 2)}></igc-avatar>
|
|
49
|
+
<span slot="title">${ctx.value.name}</span>
|
|
50
|
+
<span slot="subtitle">${ctx.value.email}</span>
|
|
51
|
+
</igc-list-item>
|
|
52
|
+
`;
|
|
53
|
+
|
|
54
|
+
render() {
|
|
55
|
+
return html`
|
|
56
|
+
<igc-list>
|
|
57
|
+
<igc-virtual-scroll
|
|
58
|
+
.data=${this.employees}
|
|
59
|
+
.itemTemplate=${this.itemTemplate as VirtualScrollItemTemplate<unknown>}
|
|
60
|
+
></igc-virtual-scroll>
|
|
61
|
+
</igc-list>
|
|
62
|
+
`;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const IgniteUIForWebComponentsTemplate_1 = require("../../../../../lib/templates/IgniteUIForWebComponentsTemplate");
|
|
4
|
+
class IgcVirtualScrollTemplate extends IgniteUIForWebComponentsTemplate_1.IgniteUIForWebComponentsTemplate {
|
|
5
|
+
constructor() {
|
|
6
|
+
super(__dirname);
|
|
7
|
+
this.components = ["Virtual Scroll"];
|
|
8
|
+
this.controlGroup = "Data Entry & Display";
|
|
9
|
+
this.listInComponentTemplates = true;
|
|
10
|
+
this.id = "virtual-scroll";
|
|
11
|
+
this.projectType = "igc-ts";
|
|
12
|
+
this.name = "Virtual Scroll";
|
|
13
|
+
this.description = "basic IgcVirtualScroll";
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
module.exports = new IgcVirtualScrollTemplate();
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const cli_core_1 = require("@igniteui/cli-core");
|
|
4
|
+
class IgcVirtualScrollComponent extends cli_core_1.BaseComponent {
|
|
5
|
+
/**
|
|
6
|
+
*
|
|
7
|
+
*/
|
|
8
|
+
constructor() {
|
|
9
|
+
super(__dirname);
|
|
10
|
+
this.name = "Virtual Scroll";
|
|
11
|
+
this.group = "Data Entry & Display";
|
|
12
|
+
this.description = `Efficiently renders large or unbounded lists by only rendering visible items`;
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
module.exports = new IgcVirtualScrollComponent();
|
package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-lite-testing/SKILL.md
DELETED
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
license: MIT
|
|
3
|
-
name: igniteui-blazor-lite-testing
|
|
4
|
-
description: "Testing in the IgniteUI Blazor (Lite) repository itself: the bUnit unit suite (tests/IgniteUI.Blazor.Tests — base classes, attribute/serialization specs, declarative interop wire contracts) and the Playwright integration suite (tests/IgniteUI.Blazor.Lite.IntegrationTests + TestBed — reflection-driven live-browser sweep, componentsConfig.json). Use when adding or changing tests in this repo, covering a new component, pinning interop behavior, or deciding which suite a check belongs in. Not for consumer-facing component usage — use igniteui-blazor-components for that."
|
|
5
|
-
user-invocable: true
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Testing in the IgniteUI Blazor (Lite) repo
|
|
9
|
-
|
|
10
|
-
Three test projects under `tests/`, two suites:
|
|
11
|
-
|
|
12
|
-
| Project | Suite | What it is |
|
|
13
|
-
|---|---|---|
|
|
14
|
-
| `IgniteUI.Blazor.Tests` | **Unit** | xUnit + bUnit, multi-targeted `net8.0`/`net9.0`/`net10.0`; renders components in-process with a recording JS runtime — no browser |
|
|
15
|
-
| `IgniteUI.Blazor.Lite.IntegrationTests` | **Integration** | NUnit + Playwright; one generated test fixture per component |
|
|
16
|
-
| `IgniteUI.Blazor.Lite.TestBed` | (integration host) | Blazor app the integration tests drive; renders one component per run and sweeps its surface |
|
|
17
|
-
|
|
18
|
-
## How the suites divide the work
|
|
19
|
-
|
|
20
|
-
| Behavior | Where it's tested |
|
|
21
|
-
|---|---|
|
|
22
|
-
| Property → rendered attribute (direct-render components) | unit: plain bUnit facts (`cut.Find(...).GetAttribute(...)`) |
|
|
23
|
-
| Markup/child content rendering | unit: plain bUnit facts |
|
|
24
|
-
| **Parent/child collection membership** — a child registering itself into its parent's collection and leaving again over the child's lifetime | unit: plain bUnit facts in the *parent's* suite, in a `#region Child collection lifecycle` — membership only; name resolution *off* that collection is interop behavior and stays in the contract |
|
|
25
|
-
| Message-borne state serialization shapes | unit: `PropertySerializationTests` / `EnumSerializationTests` / `RenderingSerializationTests` |
|
|
26
|
-
| **Interop wire behavior** — method identifiers, argument serialization + type tags, return decoding, event-handler registration/removal transmissions + JS→.NET event dispatch, `@bind-` two-way round trips, interop-borne props/data | unit: the component's `ComponentContract` — full authoring guide: [`references/interop-contracts.md`](./references/interop-contracts.md) |
|
|
27
|
-
| `<Member>Script` parameters (JS-side handlers/providers) | unit: automated sweep (`ScriptPropTests`, all components at once — no per-contract entries, no integration coverage exists) |
|
|
28
|
-
| End-to-end prop/event/method behavior against the **real web component in a real browser** | integration: the TestBed sweep |
|
|
29
|
-
| Visual output, client-side component logic | integration / e2e — never unit |
|
|
30
|
-
|
|
31
|
-
The suites overlap on purpose but answer different questions. Integration proves the full pipeline works end-to-end, but can't attribute a failure to a side of the boundary and skips everything excluded in `componentsConfig.json`. Interop contracts pin the .NET side of the wire protocol at unit speed, per member — including the members integration excludes — and tolerate different implementations through the `InteropHarness` seam (`InteropHarnessRegistry` swaps stacks per component).
|
|
32
|
-
|
|
33
|
-
## Unit suite (`tests/IgniteUI.Blazor.Tests`)
|
|
34
|
-
|
|
35
|
-
### Base classes
|
|
36
|
-
|
|
37
|
-
- **`BlazorComponentTestBase`** — bUnit `BunitContext` with setup `IIgniteUIBlazor` service, a recording JS runtime (`JSRuntimeMode.Loose`; every invocation recorded) and an `Interop` harness property (an `InteropHarness`, resolved per component type via `InteropFor<TComponent>()`). Default base for suites without an interop contract.
|
|
38
|
-
- **`ComponentWithContractTestBase<TComponent>`** — adds a declarative `ComponentContract<TComponent>`, `protected` runners (`VerifyMethodContract`/`VerifyPropContract`/`VerifyEventContract`) that the suite exposes as one-liner `[Fact]`s, and an inherited `Contract_SectionsHaveFacts` guard that fails if a non-empty contract section has no runner fact. Exactly one suite per component carries the contract; sync/async method pairs are declared together via the twin overloads.
|
|
39
|
-
|
|
40
|
-
### Running
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
dotnet test tests/IgniteUI.Blazor.Tests -f net10.0 --nologo --filter "FullyQualifiedName~<Name>Tests"
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
- Iterate on one TFM (`-f net10.0`); finish with a full run on all TFMs (drop `-f`).
|
|
47
|
-
- Contract failure stacks carry the violated contract line as the top frame — the test UI navigates to the spec, not the shared runner.
|
|
48
|
-
|
|
49
|
-
### Conventions
|
|
50
|
-
|
|
51
|
-
- Generally follow **one file per component: `<Name>Tests.cs` holds `<Name>Tests`.** A component's **child** components may share the parent's file (`SelectTests.cs` also holds `SelectItemTests`/`SelectGroupTests`/`SelectHeaderTests`; likewise Card, List, Dropdown, NavDrawer, Tabs, Stepper, TileManager, Tree, Rating, Slider) — that's the only permitted multi-class file. Cross-cutting suites (`BaseControlTests`, `*SerializationTests`, `ScriptPropTests`, `Interop*Tests`) are keyed to a class/behavior, not a component, and keep their own files.
|
|
52
|
-
- New facts go into the existing `<Name>Tests` class; if the class carries a contract, plain bUnit facts sit alongside the contract runners in the same class.
|
|
53
|
-
- Shared test helpers live in `ElementAssertionExtensions.cs`.
|
|
54
|
-
- **Readable arrange/act/assert in the test beats sharing.** A little repetition across suites is fine; extract obvious repeated mechanics if needed, but ensure those are well documented and easy to grasp without breaking the flow of the test itself.
|
|
55
|
-
- **Skips need a mechanism reason.** Bug-tracker or `componentsConfig.json` listings are not skip reasons. If a member's decode hits a gap in shared infrastructure the change doesn't own, cover it pinning current behavior and write the *correct* assertion commented out under a `// TODO:` explaining the gap — ready to uncomment when fixed. A gap in a component under construction is a bug to fix, not to pin — see the two authoring modes in the interop reference.
|
|
56
|
-
- Components are `partial` — the generated `src/components/Blazor/<Name>.cs` is not the whole class; always check `src/componentsBase/WebInputs/<Name>.cs` for hand-written extensions before drawing conclusions.
|
|
57
|
-
- Formatting: only `dotnet format whitespace --folder` is safe in this repo — a full `dotnet format` writes conflict markers into multi-targeted sources.
|
|
58
|
-
|
|
59
|
-
## Integration suite (Playwright + TestBed)
|
|
60
|
-
|
|
61
|
-
One generic NUnit test per component (`ComponentTest`, fixture-sourced from the TestBed's
|
|
62
|
-
component list): it boots the TestBed app (in-memory by default), calls the browser-side
|
|
63
|
-
`renderComponent('<IgbName>')`, and asserts `getErrors()` returns nothing. The real work
|
|
64
|
-
happens inside the TestBed (`Components/Pages/Home.razor`): a **reflection-driven sweep**
|
|
65
|
-
over the component's public surface —
|
|
66
|
-
|
|
67
|
-
- **`TestProps`**: sets each `[Parameter]` server-side with generated sample values and compares against the live web component's DOM property in the browser (`TestUtil.PropertyValuesAreEqual`, client value via `stringifyObject`).
|
|
68
|
-
- **`TestEvents`**: dispatches synthetic events against the web component and verifies the bound .NET callbacks fire.
|
|
69
|
-
- **Method spies** (`spyOnMethod`/`checkOnSpy` in `wwwroot/app.js`): invoking the .NET API must call the matching web-component method with the right args/result. **Async methods only** — the sweep filters to `*Async` and also excludes `Get*Async` getters; sync variants can't run on the Server-hosted TestBed (no in-process JS runtime), so sync variants, getters, and `<Member>Script` params have no integration coverage — the unit suite is their only net.
|
|
70
|
-
|
|
71
|
-
**`componentsConfig.json`** (in the TestBed project) gates the sweep per component:
|
|
72
|
-
`ExcludedProps`, `ExcludedEvents`, `DependantProps`/`DependantMethods` — each entry usually cites a BUG number or a shape the generic sweep can't model. An excluded member has **no integration coverage at all** — treat those as *higher* priority for the unit interop contract, never as members to skip there too.
|
|
73
|
-
|
|
74
|
-
### Running
|
|
75
|
-
|
|
76
|
-
- One-time: build, then install browsers — `pwsh tests/IgniteUI.Blazor.Lite.IntegrationTests/bin/Debug/net<version>/playwright.ps1 install chromium`.
|
|
77
|
-
- `dotnet test tests/IgniteUI.Blazor.Lite.IntegrationTests` (or per component from the Test Explorer — fixtures are named by component).
|
|
78
|
-
- `.runsettings` knobs: headless off for local debugging; `useInMemoryClient: false` to run against your own `dotnet run` instance of the TestBed.
|
|
79
|
-
- Full setup details: [tests/IgniteUI.Blazor.Lite.IntegrationTests/README.md](../../tests/IgniteUI.Blazor.Lite.IntegrationTests/README.md).
|
|
80
|
-
|
|
81
|
-
## Adding coverage for a new component — checklist
|
|
82
|
-
|
|
83
|
-
1. Unit suite: bUnit facts for rendered attributes/markup; if the component has an interop surface (it sends interop invocations or registers JS-originated event handlers — the reference explains how to identify these per stack), add a `ComponentContract` per [`references/interop-contracts.md`](./references/interop-contracts.md). For a brand-new component this works TDD-style: author the contract first from the intended API following the library's conventions; the contract doubles as the API design record (spec mode in the reference).
|
|
84
|
-
2. If it is a parent that collects children, or a child that registers with a parent, exercise that membership **over the child's lifetime**, not just at first render: the children are the collection in order, a disposed child leaves it, all disposed empties it. Keep these facts to membership and asserting resolution that are covered by the interop contract.
|
|
85
|
-
3. Integration: the sweep picks the component up automatically; add `componentsConfig.json` entries only for members the generic sweep genuinely cannot model (cite why), and mirror each exclusion with unit contract coverage.
|
|
86
|
-
4. Verify: unit full-suite on all TFMs, plus the component's integration fixture.
|
|
@@ -1,220 +0,0 @@
|
|
|
1
|
-
# Interop wire contracts — authoring reference
|
|
2
|
-
|
|
3
|
-
Goal: every component with an interop surface carries a declarative `ComponentContract<TComponent>` in its test suite, pinning how its public API maps onto the wire — method identifiers, argument serialization and type tags, return decoding, and event names + args deserialization. Contracts run through the `InteropHarness` seam (`tests/IgniteUI.Blazor.Tests/Interop/`), so the contract verifies a component regardless of the interop stack (swap per component via `InteropHarnessRegistry`).
|
|
4
|
-
|
|
5
|
-
Scope note: contracts cover **methods, current-state getters, events, two-way binding pairs, and props that travel over interop**. Simple property → attribute rendering (direct-render components) is already covered by the existing attribute tests and the integration suite — never duplicate it with `.Prop`.
|
|
6
|
-
|
|
7
|
-
Exemplars to imitate: `ButtonTests.cs` (simplest), `CarouselTests.cs` (void/bool methods, args, getters, number event), `ChipTests.cs` (bool-detail events, getter), `ChatTests.cs` (renderer-container component: `.Prop` config object, complex event args), `ComboTests.cs` (data sources, uuid refs), `TreeTests.cs` (child refs, hosted getter).
|
|
8
|
-
|
|
9
|
-
Cross-check the integration exclusions: members listed for the component in `tests/IgniteUI.Blazor.Lite.TestBed/componentsConfig.json` (`ExcludedProps`, `DependantMethods`, `ExcludedEvents`) have **no integration coverage at all** — treat them as higher priority for the contract, never as members to skip. Client-side bugs cannot reach the stubbed boundary, so the contract covers the public API as exposed today; reference the bug in a note (not the skip comment) for context.
|
|
10
|
-
|
|
11
|
-
**The file is not the whole class.** `partial` classes may have split implementations — always check `src/` for other parts.
|
|
12
|
-
|
|
13
|
-
## Two authoring modes — know which one you're in
|
|
14
|
-
|
|
15
|
-
- **Pin mode** — the component exists and is presumed working (retrofitting coverage, gating a migration). Author specs from the source and run them; when a spec disagrees with what actually crossed (failure output shows the recorded wire values), judge which side is off. Usually the spec mis-derived a wire form — correct it. When the *implementation* looks wrong instead, decide whether there is an issue that can't be asserted correctly right now: if so, assert what holds today and leave the correct assertion commented out under a `// TODO:` explaining the issue (exemplars: `StepperTests` `GetSteps`, `ComboTests` `ChangeType`; grep `TODO` in the test project — every hit is an uncomment-when-fixed marker).
|
|
16
|
-
- **Spec mode (TDD / new component / intended behavior change)** — the contract is the reference and is written *first*, from the intended public API and the stack's wire conventions (cheat-sheet). Where the component wraps a web component, its emitted shapes (`node_modules/igniteui-webcomponents` `.d.ts` / `custom-elements.json`) supply the payload truth. For a **Blazor-specific component with no web-component counterpart**, the API and the wire vocabulary are themselves design deliverables: propose them from the component's requirements, patterned on the library's conventions (`*Async` methods with sync twins, `EventCallback<TArgs>` with a dedicated args type, camelCase wire identifiers, the existing type-tag vocabulary) and the closest existing contracts as exemplars — the contract then doubles as the reviewable API design record.
|
|
17
|
-
|
|
18
|
-
The recipe below is phrased for pin mode ("read the source"); in spec mode, substitute the intended API design for the source — everything else (the DSL, the guards, the payload derivation from WC metadata) applies unchanged.
|
|
19
|
-
|
|
20
|
-
## Where a contract lives
|
|
21
|
-
|
|
22
|
-
Each component has (at most) **one** suite carrying the contract:
|
|
23
|
-
|
|
24
|
-
- If the component already has a test class, change its base from `BlazorComponentTestBase` to `ComponentWithContractTestBase<Igb<Name>>`, add `using IgniteUI.Blazor.Tests.Interop;`, and add the `Contract` property at the top. Leave all existing facts untouched. `<Name>Tests` lives in `<Name>Tests.cs` — except for **child** components, whose suite may share the parent's file (`SelectItemTests` is in `SelectTests.cs`).
|
|
25
|
-
- If no suite exists anywhere, create `<Name>Tests.cs` with the contract.
|
|
26
|
-
- Components with **no interop surface** (they never send an interop invocation and register no JS-originated event handlers — e.g. Badge) stay on `BlazorComponentTestBase`.
|
|
27
|
-
|
|
28
|
-
## Recipe — pin the component's interop surface
|
|
29
|
-
|
|
30
|
-
Read the component's source (all `partial` parts) and find every place it:
|
|
31
|
-
|
|
32
|
-
1. **sends an outbound interop invocation** from a public API member → a `.Method` or `.Getter` spec;
|
|
33
|
-
2. **registers a handler for a JS-originated event** (paired with an `EventCallback<TArgs>` parameter) → an `.Event` spec;
|
|
34
|
-
3. **transmits state over interop** rather than rendering it as an attribute → a `.Prop` spec;
|
|
35
|
-
4. **pairs a `[Parameter] X` with an `EventCallback<TValue> XChanged`** (what `@bind-X` needs) → a `.Bind` spec.
|
|
36
|
-
|
|
37
|
-
The *concrete idioms* for all three depend on which interop stack the component currently sits on — the [cheat-sheet below](#current-stack-cheat-sheet-legacy-renderermessage-pipeline) lists them for the legacy `RendererMessage` pipeline. For a component on a different stack, find the equivalent call sites in its implementation (whatever sits between the public member and the JS runtime — a direct `IJSRuntime.InvokeAsync`, a channel service, etc.); the principles and the DSL below are unchanged.
|
|
38
|
-
|
|
39
|
-
### Values that only exist after the render — one mechanism, everywhere
|
|
40
|
-
|
|
41
|
-
Interop instance ids, data-item uuids and element handles are assigned when the component renders, which is *after* the contract itself is constructed. Wherever a spec states such a value, the parameter is a `FromRender<T>`: pass the value directly when it is fixed (the common case — nothing to think about), or `FromRender.Of((interop, cut) => …)` when it can only be settled once rendered. The DSL has exactly one such mechanism, so a new kind of late value needs no new API:
|
|
42
|
-
|
|
43
|
-
```csharp
|
|
44
|
-
returns: FromRender.Of((interop, cut) => InteropReturn.Ref(...)) // a getter's stubbed return
|
|
45
|
-
args: [FromRender.Of((interop, cut) => $"containerId:::{...}")] // one late argument among fixed ones
|
|
46
|
-
argsJson: FromRender.Of((interop, cut) => ...) // an event payload carrying a child ref
|
|
47
|
-
wire: FromRender.Of<object?>((interop, cut) => new RawJson(...)) // a prop whose value references data items
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
The render scope handed to the lambda is the cut for an arranged spec and the whole host render for a hosted one — the same scope the spec's own `assert:` receives. Pair it with `arrange:` (or `host:`/`target:`) so there is something rendered to reference.
|
|
51
|
-
|
|
52
|
-
### Dates
|
|
53
|
-
|
|
54
|
-
Decoding converts to local time (`ReturnToDate`, default `RoundTripDateConversion.Auto`), so a decoded date is `Kind=Local` with a shifted reading. Rules:
|
|
55
|
-
|
|
56
|
-
- State every date **expectation** as the UTC instant with an explicit `DateTimeKind.Utc` — `returns:`, `expect:`, args. The runner compares against its local rendering and asserts the kind; an `Unspecified` expectation throws.
|
|
57
|
-
- Never write `.ToLocalTime()` in a spec to make a comparison pass. If one seems needed, the assertion helper is missing a case — add it there. The one exception is an author-written `assert:` lambda, where you do the comparing: use `…Utc).ToLocalTime()` (see `DateRangePickerTests`' bind assert).
|
|
58
|
-
- Outbound dates (`.Prop` values, method args) are not decoded and keep the kind the spec wrote, so their wire expectation is a plain literal — `DateTimeKind.Utc` serializes with `Z`.
|
|
59
|
-
|
|
60
|
-
Exemplars: `CalendarTests` (scalar + array), `DateRangePickerTests` (nested in an object), `DatePickerTests`/`DateTimeInputTests` (nullable, with a `// TODO:` for the cleared case crossing as `MinValue`).
|
|
61
|
-
|
|
62
|
-
### 1. Methods and getters
|
|
63
|
-
|
|
64
|
-
- Every public API member that produces an outbound invocation gets a spec. Distinguish two kinds:
|
|
65
|
-
- **Actions** → `.Method(c => c.NextAsync(), c => c.Next(), "next", ...)` — async selector, sync twin selector, then the wire identifier (matching the member-first pattern of `.Event`/`.Prop`; single-selector overloads exist for async-only members). The contract pins the identifier, the serialized arguments, their type tags, and the decoded return — for both dispatches.
|
|
66
|
-
- **Current-state reads** (a `Get...Async` that decodes a component property's live value) → `.Getter(c => c.GetTotalAsync(), "Total", returns: 5.0)` with the **bare property name** — how a read travels (its wire identifier or call shape) is implementation-specific and owned by the harness, never written in contracts.
|
|
67
|
-
- **Args and type tags**: state what crosses — sample values chosen by you, wire forms derived from the member's serialization (cheat-sheet for the legacy conversions) or, in pin mode, by running the spec and reading the recorded wire values from the failure output. Write both as collection expressions: `args: [2.0, "next"], types: ["Number", "Json"]`. Structured values use `new JsonSubset(...)` (subset match) or `new RawJson(...)` (exact).
|
|
68
|
-
- **Returns** — choose by the *semantic* return kind:
|
|
69
|
-
| Return kind | Contract form |
|
|
70
|
-
|---|---|
|
|
71
|
-
| none | omit — void overload |
|
|
72
|
-
| scalar (bool/number/string/date) | just the value: `returns: true` / `5.0` / a UTC `DateTime` — the wire return kind is derived from the value's type, and the decoded .NET return must round-trip back to it (dates: see the rule above — stated as the UTC instant, asserted as its local rendering) |
|
|
73
|
-
| single serialized object | arranged `Getter` overload with `InteropReturn.Object(...)` + value-level `assert:` — see `ChatTests.cs` `DraftMessage` |
|
|
74
|
-
| array of component/data-item references | arranged `Getter` overload with `InteropReturn.Array` of refs, `Assert.Same` against arranged instances — see `TileManagerTests.cs` `Tiles`, `ComboTests.cs` `Value` |
|
|
75
|
-
| single bound-object reference | arranged `Getter` overload with `InteropReturn.Ref(...)`, `Assert.Same` against the arranged child — see `SelectTests.cs`/`DropdownTests.cs` `SelectedItem` |
|
|
76
|
-
|
|
77
|
-
(An explicit `InteropReturn` + separate `expect:` overload exists for wire returns that decode to a different value than sent — rare.)
|
|
78
|
-
- **Value-returning methods must state their return** — enforced at compile time: a `Task<TResult>`-returning lambda on the void `.Method` overload is `[Obsolete(error: true)]` as a guard, so the contract states the `returns:` stub. The void overload needs no stub.
|
|
79
|
-
- **Hosted arrange — child components that only exist inside a parent** - Currently available in the hosted `Getter` overload (e.g. a tree item's `GetPathAsync` needs real ancestors). Build the full render with `ContractHost.Of<THost>(ps => ps.AddChildContent(...))` (parent as the root, structure nested inside), pick the component under test with `target: h => h.FindComponents<TComponent>()[n]`, and note that `returns:`/`assert:` receive the whole host render — so `interop.ContainerIdOf(h, "<selector>")` reaches ancestors and siblings outside the cut's subtree. The read still travels on the target's own container. See `TreeItemTests` in `TreeTests.cs`.
|
|
80
|
-
- **Render-sourced arguments — a value that only exists once rendered** (a sibling component instance, an `ElementReference` captured from markup): the spec's selectors run *after* its render, so read the value from a holder the `arrange:` render fills — `.Method(c => c.ShowAsync(anchor.Component), ...)` — rather than reaching for a new overload. The expected *wire* value comes the same way: `args: [FromRender.Of((interop, cut) => ...)]` is settled right before comparison, when child instance ids exist. `elements:` states the element handles the invocation must carry alongside its arguments; omitting it asserts the invocation carries none — so a component-typed target is positively pinned as crossing without an element handle. Both `arrange:` and `elements:` are available on the void and the value-returning twin overloads. See the `show`/`toggle` target overloads in `DropdownTests.cs`.
|
|
81
|
-
- **Sync twins are declared inside the member's spec**: every `X()`/`XAsync()` pair uses the twin overloads — both selectors up front, async first: `.Method(c => c.ShowAsync(), c => c.Show(), "show", returns: true)` (same for `.Getter`, including the arranged/hosted forms). The runner re-invokes the sync twin against the same expectations (identifier, args, types, decoded return). Declaring the twin is the contract author's responsibility — when enumerating methods, treat an `X()`/`XAsync()` pair as one member and use the twin overload. Sync dispatch rides the in-process JS runtime (`IJSInProcessRuntime` — WASM/WebView-only in production; the Server-hosted integration TestBed can't run sync variants, so contracts are their only coverage).
|
|
82
|
-
- **Skip and list**: a member whose decode hits an implementation gap (unregistered child type, missing marshal-by-value entry) is covered, not skipped — per the authoring modes above.
|
|
83
|
-
|
|
84
|
-
### 2. Events
|
|
85
|
-
|
|
86
|
-
- The contract entry is member-first — `.Event(c => c.SlideChanged, argsJson, assert)`, or the bare `.Event(c => c.Closing)` for a void event. The wire event name is derived from the member name (it matches the registered handler name on every generated component — if you ever hit one that differs, pass `name:` explicitly), the args type is inferred from the `EventCallback<TArgs>` signature.
|
|
87
|
-
- **What an `.Event` spec verifies** — the full loop, automatically: (1) binding round-trips — the member returns the exact callback assigned; (2) binding transmits an **event-handler registration** over interop, carrying the member's event identity — the client's cue to subscribe (same ref machinery as Script props, harness-normalized); (3) dispatching the spec's payload under the wire event name reaches the handler with args of the declared type, satisfying the spec's asserts; (4) unbinding (setting the parameter back to an empty callback) resets the member, transmits the **cleared registration** — the client's cue to unsubscribe — and stops delivery: a subsequent dispatch must not reach the handler.
|
|
88
|
-
- **The bare form compiles only for `EventCallback<IgbVoidEventArgs>` members** (the type is invariant), and `argsJson` is required on the data overload.
|
|
89
|
-
- **Args JSON**: derive from the args type's deserialization code (which keys it reads, into which .NET properties), and/or the web component's emitted event detail (the events are not black boxes: check `node_modules/igniteui-webcomponents` `.d.ts` / `custom-elements.json` for the emitted shape). Wire envelope framing for object details is stack-specific — see the cheat-sheet; `ChatTests.cs` `MessageCreated` is the exemplar.
|
|
90
|
-
- **Assert** each property you put in the payload: `assert: args => Assert.Equal(3, args.Detail)`. Keep assertions **value-level** (compare data, not instance identity) — with one exception: **self-reference details**
|
|
91
|
-
- **Assert references**
|
|
92
|
-
- When a component's own event carries a reference to itself, the contract asserts it resolves back to the instance via the component-aware overload: `assert: (panel, a) => Assert.Same(panel, a.Detail)` (see `ExpansionPanelTests.cs`, `TileTests` in `TileManagerTests.cs`). Resolution of a reference IS its value semantics.
|
|
93
|
-
- For child-component references (a parent's event whose detail contains a child — Accordion's panels, Tabs' tab, Tree's items, TileManager's tiles): use the arranged-children `Event` overload — `arrange:` adds child components via `AddChildContent`, `argsJson:` is a factory building a reference payload with `interop.ContainerIdOf(cut, "igc-tab:nth-of-type(2)")`, and `assert:` receives the cut to `Assert.Same` against the arranged child instance. See `TabsTests.cs` `Change` for example.
|
|
94
|
-
- Specs need no component state by default — the interop boundary is state-free (a method sends its invocation regardless of slides/messages existing; effects are integration's job). Use `arrange:` only when a member genuinely needs .NET-side arrangement (bound children, data) just to *reach* the boundary — e.g. payloads carrying references that must resolve, or data-source items referenced by uuid.
|
|
95
|
-
- The `<PropName>Script` string parameters are not events but ARE valid public API — covered **automatically** by the generic sweep in `ScriptPropTests`: every generated `<Member>Script` prop must transmit a script reference for its target member, carrying the script name. No per-contract entries needed (the integration TestBed does not exercise these either, so the sweep is their only coverage).
|
|
96
|
-
|
|
97
|
-
### 3. Interop-borne props
|
|
98
|
-
|
|
99
|
-
The contract entry is the member selector plus a sample value: the wire name is derived from the member (camelCase, honoring `[WCWidgetMemberName]`; `wireName:` overrides), and for scalar values the wire value is the value itself — `.Prop(c => c.Open, true)`. Enums and serialized objects/arrays must state the wire form explicitly: `.Prop(c => c.GroupSorting, GroupingDirection.Desc, wire: "desc")`, `.Prop(c => c.Options, new IgbChatOptions { ... }, wire: new JsonSubset("""..."""))`.
|
|
100
|
-
|
|
101
|
-
- A property belongs in the contract **only when its value travels over interop** rather than as a rendered attribute. Determine which from the component's serialization path (stack-specific — see the cheat-sheet) or empirically: for an attribute prop, the runner fails with *"no property update transmission was observed"*. Attribute props are covered by the suite's attribute facts instead.
|
|
102
|
-
- **Serialized config objects and arrays**: set an instance with 2–3 distinctive values and expect a `JsonSubset` — subset match, extra bookkeeping fields on the transmitted value are ignored; arrays compare element-wise (equal length, per-element subset). See `ChatTests.cs`, `CalendarTests.cs`.
|
|
103
|
-
- **Data sources** (`Data`/`DataSource` props): covered by `.Prop(c => c.Data, ...)` too — the harness follows whatever indirection the stack uses to the actual transfer. Item property names cross with their .NET names (not camelized). See `ComboTests.cs`.
|
|
104
|
-
- **Props referencing data items** (e.g. Combo's `Value`): add `arrange:` for the `Data` the value points into and state the wire value late, since tracked items cross as refs whose ids are only assigned on transfer: `.Prop(c => c.Value, [_item1], wire: FromRender.Of<object?>((interop, cut) => new RawJson(...)), arrange: ps => ps.Add(c => c.Data, items))`.
|
|
105
|
-
|
|
106
|
-
### 4. Two-way binding pairs
|
|
107
|
-
|
|
108
|
-
A `[Parameter] TValue X` plus `EventCallback<TValue> XChanged` is what `@bind-X` needs. `XChanged` is a filtered proxy of a **driving event** (`Change`, or `Select` on Chip): assigning it force-binds a no-op onto that event so it registers, and the callback then fires from inside that event's handler with the value projected out of its detail. A client change only ever arrives as a dispatch of the driving event.
|
|
109
|
-
|
|
110
|
-
`.Bind` covers what `.Event` can't: it renders the pair with real two-way binding and asserts the **property adopted the value** — what `@bind-X` consumers depend on. (`.Event(c => c.XChanged, …, name: "Change")` does work for the callback half alone, since binding it registers the driving event; it just says nothing about the property.)
|
|
111
|
-
|
|
112
|
-
```csharp
|
|
113
|
-
.Bind(c => c.Selected, c => c.SelectedChanged, via: c => c.Select,
|
|
114
|
-
argsJson: """{"detail": true}""", expect: true)
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
One dispatch pins: the driving event's registration crossed, the callback member kept the callback, the binding received the decoded value, and the property adopted it. Clearing the parameter then has to stop the callback. Payload is the same shape and can be reused from the driving event's own `.Event` spec.
|
|
118
|
-
|
|
119
|
-
- `expect:` is the value the dispatch must produce, often a projection of the detail — a checkbox detail is an object, the bound value is its `checked` field. The runner checks the property doesn't already hold it, so a spec can't pass without the change happening. For a type with no value equality add `assert:` and check field-wise.
|
|
120
|
-
- `arrange:` when the dispatch needs more — Calendar's `Selection` for the `Values` branch, Combo's `Data`. Order the named arguments arrange → argsJson → expect, so a spec reads arrange/act/assert.
|
|
121
|
-
- `initial:` only for a pair that must start somewhere other than the type default; no current spec needs it.
|
|
122
|
-
- A pair with no event of its own (`IgbTab.Selected`, written by `IgbTabs`' `Change` handler) is not a `.Bind` spec: cover it in the parent's `.Event` spec, whose arrange binds each child's `XChanged` to a holder the assert then checks.
|
|
123
|
-
- Nothing checks the value going back out: the client already holds it, and the property's own `.Prop` spec (or its rendered-attribute fact) pins how it serializes. `.Bind` is the inbound direction only.
|
|
124
|
-
|
|
125
|
-
## Current-stack cheat-sheet (legacy `RendererMessage` pipeline)
|
|
126
|
-
|
|
127
|
-
> Everything in this section is specific to components still on the legacy
|
|
128
|
-
> `BaseRendererControl`/`RendererMessage` stack.
|
|
129
|
-
|
|
130
|
-
**Surface markers** in the component's source:
|
|
131
|
-
- `InvokeMethod("...", args, types)` inside `public async Task...` wrappers → methods/getters;
|
|
132
|
-
- `SetHandler<TArgs>(this.Name, "EventName", ...)` (the `[Parameter] EventCallback<TArgs>` is right above it) → events;
|
|
133
|
-
- `SerializeCore` at the bottom of the class (each `if (IsPropDirty("X")) { ser.AddXxxProp(...) }` line) → interop-borne props.
|
|
134
|
-
|
|
135
|
-
**Methods**: the JS name is the first `InvokeMethod` argument, used verbatim — *except* a `p:` prefix (e.g. `InvokeMethod("p:Total", ...)`), which marks a current-state read: use `.Getter` with the bare property name; the prefix is harness-owned. `types:` = the `new string[] { ... }` values verbatim (getters have none).
|
|
136
|
-
|
|
137
|
-
**Argument wire forms** (per argument expression in the source):
|
|
138
|
-
|
|
139
|
-
| Argument expression in source | Sample .NET arg | Expected wire arg (contract `args:`) |
|
|
140
|
-
|--------------------------------------------|--------------------------|--------------------------------------|
|
|
141
|
-
| bare value, type tag `"Number"` | `2` / `2.5` | `2.0` / `2.5` (always as double) |
|
|
142
|
-
| `StringToString(x)`, tag `"String"` | `"message-42"` | `"message-42"` |
|
|
143
|
-
| bare bool, tag `"Boolean"` | `true` | `true` |
|
|
144
|
-
| `ObjectToParam(x, typeof(SomeEnum))`, tag `"Json"` | `SomeEnum.Member` | the `[WCEnumName("...")]` value if the member has one, else camelCase of the member name (`Next` → `"next"`) |
|
|
145
|
-
| `ObjectToParam(x)` with a plain string, tag `"Json"` | `"item-1"` | `"item-1"` |
|
|
146
|
-
| `ObjectToParam(x)` with a marshal-by-value object, tag `"Json"` | an options object | `new JsonSubset("""{"key": value, ...}""")` |
|
|
147
|
-
| `x` DateTime, tag `"Date"` | a `DateTime` | the same `DateTime` — outbound, so it keeps the kind the spec wrote |
|
|
148
|
-
| array helpers (`IntArrayToString`, ...), tag `"NumberArray"` etc. | array | `new RawJson("[1,2,3]")` |
|
|
149
|
-
| `ComponentToJson(x, i)`, tag `"Component"` | an `Igb*` component | `"containerId:::<that component's own container id>"` (a `FromRender` value) — no element handle |
|
|
150
|
-
| `ComponentToJson(x, i)`, tag `"Component"` | an `ElementReference` | `"elementIndex:::<i>"`, plus the handle itself declared via `elements:` (it rides beside the arguments, not in them) |
|
|
151
|
-
| `ComponentToJson(x, i)`, tag `"Component"` | anything else | nothing — the argument is dropped, so `arguments` arrives empty while `types` still lists the tag |
|
|
152
|
-
|
|
153
|
-
**Return decodes** (the line after `InvokeMethod` → the semantic kinds in the recipe's table):
|
|
154
|
-
|
|
155
|
-
| Source decode | Semantic kind |
|
|
156
|
-
|---|---|
|
|
157
|
-
| `ReturnToBoolean/Double/Int/Long/String/Date(iv)` | scalar (`returns:` the value; note `ReturnToBoolean(null) == false` — why unstubbed void specs would pass silently) |
|
|
158
|
-
| `ReturnToObject<T>(iv, "TypeName")` | single serialized object — stub `InteropReturn.Object("", ...)`: the wire type is empty, .NET fills it from its typeGuess |
|
|
159
|
-
| `ReturnToObjectArray<T>` | array of refs — component refs are `{"refType": "name", "id": <containerId>}`; data-item refs are `{"refType": "uuid", "id": <observed ___id>}` |
|
|
160
|
-
| bare `ConvertReturnValue(iv)` cast to a component | single bound-object reference — crosses as a bare `{"refType": "name", "id": ...}` with no retType envelope (`InteropReturn.Ref`) |
|
|
161
|
-
| `StringToEnum` returns | not modeled — skip with this reason |
|
|
162
|
-
|
|
163
|
-
**Events**: Payload keys come from the args type's `FromEventJson` (`if (args.ContainsKey("key")) { this.X = ReturnToXxx(args["key"]); }` → key + sample value: `ReturnToBoolean` → `true`, `ReturnToDouble` → `3`, `ReturnToDate` → `"2026-01-02T03:04:05.000Z"`).
|
|
164
|
-
Object details are envelope-wrapped by the client bridge (`src/src/index.ts` `toReturn` → `Loader.transformReturn`) as `{"detail": {"retType": "object", "type": "", "value": { ...detail... }}}` — type empty, .NET fills it from the typeGuess. Child references resolve through named cascading-parameter registration.
|
|
165
|
-
|
|
166
|
-
**Props**: Wire details: enum values are `[WCEnumName]` or camelCase; nested keys camelCase; dates inside serialized objects cross as `"@d:<ISO>"` strings (`AddPrimitiveProp`) while dedicated date arrays (`AddDateArrayProp`) cross as plain ISO strings; data sources ride a `refChanged` transfer under a generated ref id the description advertises as `<wireName>Ref` (the harness follows it). Skip `SerializeCore` entries whose wire name ends in `Ref` (event/script ref advertisements — the script side is swept by `ScriptPropTests`; script refs transmit as `refChanged` with refValue `script:::<name>`, which the harness normalizes to the bare name).
|
|
167
|
-
|
|
168
|
-
## Contract template
|
|
169
|
-
|
|
170
|
-
```csharp
|
|
171
|
-
public class <Name>Tests : ComponentWithContractTestBase<Igb<Name>>
|
|
172
|
-
{
|
|
173
|
-
protected override ComponentContract<Igb<Name>> InteropContract { get; } = new ComponentContract<Igb<Name>>()
|
|
174
|
-
.Method(c => c.ShowAsync(), c => c.Show(), "show", returns: true)
|
|
175
|
-
.Getter(c => c.GetCurrentValueAsync(), c => c.GetCurrentValue(), "Value", returns: ...)
|
|
176
|
-
.Event(c => c.SomeEvent, ...)
|
|
177
|
-
.Prop(c => c.SomeProp, ...)
|
|
178
|
-
.Bind(c => c.Value, c => c.ValueChanged, via: c => c.Change, argsJson: ..., initial: ..., expect: ...);
|
|
179
|
-
|
|
180
|
-
// One runner fact per non-empty contract section (omit facts for empty sections
|
|
181
|
-
[Fact]
|
|
182
|
-
public Task Methods_FollowContract() => VerifyMethodContract();
|
|
183
|
-
|
|
184
|
-
[Fact]
|
|
185
|
-
public void Props_FollowContract() => VerifyPropContract();
|
|
186
|
-
|
|
187
|
-
[Fact]
|
|
188
|
-
public void Events_FollowContract() => VerifyEventContract();
|
|
189
|
-
|
|
190
|
-
[Fact]
|
|
191
|
-
public void Binds_FollowContract() => VerifyBindContract();
|
|
192
|
-
|
|
193
|
-
// ... other/existing facts ...
|
|
194
|
-
}
|
|
195
|
-
```
|
|
196
|
-
|
|
197
|
-
Contract failures carry the violated member and, as the top stack frame, the contract line that declared it (captured via caller info).
|
|
198
|
-
|
|
199
|
-
## Verify
|
|
200
|
-
|
|
201
|
-
```
|
|
202
|
-
dotnet test tests/IgniteUI.Blazor.Tests/IgniteUI.Blazor.Tests.csproj -f net10.0 --nologo --filter "FullyQualifiedName~<Name>Tests"
|
|
203
|
-
```
|
|
204
|
-
|
|
205
|
-
Common failures:
|
|
206
|
-
|
|
207
|
-
- `handler was not invoked` → wrong event name (must match the name the component registers) or a payload key the args deserialization doesn't read.
|
|
208
|
-
- Types/args mismatch → the assertion message shows the recorded wire values; judge which side is off per the authoring modes (in spec mode an unintended wire value is the implementation's bug — the red spec is doing its job).
|
|
209
|
-
- A method call that never returns (test timeout) means its identifier reached JS without a stub match — check the name matches the stub you declared (getters: bare property name).
|
|
210
|
-
- `no property update transmission was observed` → wrong wire name, an attribute-rendered prop, or a serialization exception upstream (nothing transmits at all).
|
|
211
|
-
- `transmitted no "<Event>" event registration` (bind specs) → the pair's `EnsureXHandled()` isn't running, or `via:` names the wrong event; without it the client never reports changes.
|
|
212
|
-
- `the <X>Changed binding was never invoked` → dispatch failures are swallowed by the control, so this one message covers three causes: wrong `via:`, a payload the args type doesn't decode, or a value that doesn't coerce to the bound type.
|
|
213
|
-
|
|
214
|
-
Finish with a full-suite sanity run: same command without `--filter`.
|
|
215
|
-
|
|
216
|
-
## Definition of done (per component)
|
|
217
|
-
|
|
218
|
-
- Contract on exactly one suite, all facts green, plus full suite green on all TFMs.
|
|
219
|
-
- Every public method that goes out through interop — async **and** its sync twin (declared together via the twin overloads) — every registered JS-originated event, every interop-borne prop, and every `@bind-` pair is either covered, globally excluded, or named in the skip comment with a mechanism reason — nothing silently omitted. (`<Member>Script` params are covered by the `ScriptPropTests` sweep.)
|
|
220
|
-
- Implementation issues found along the way are handled per the authoring modes (`// TODO:` markers or fixes), never silently skipped.
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|