@capillarytech/blaze-ui 5.20.0 → 5.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (189) hide show
  1. package/CapAskAira/CapAiMediaGeneration/saga.js +1446 -0
  2. package/CapAskAira/CapAiMediaGeneration/saga.js.map +1 -0
  3. package/CapCollapsibleLeftNavigation/saga.js +1441 -0
  4. package/CapCollapsibleLeftNavigation/saga.js.map +1 -0
  5. package/CapLanguageProvider/actions.js +125 -0
  6. package/CapLanguageProvider/actions.js.map +1 -0
  7. package/CapLanguageProvider/constants.js +37 -0
  8. package/CapLanguageProvider/constants.js.map +1 -0
  9. package/CapLanguageProvider/reducer.js +130 -0
  10. package/CapLanguageProvider/reducer.js.map +1 -0
  11. package/CapLanguageProvider/saga.js +1457 -0
  12. package/CapLanguageProvider/saga.js.map +1 -0
  13. package/CapLanguageProvider/selector.js +186 -0
  14. package/CapLanguageProvider/selector.js.map +1 -0
  15. package/CapSupportVideosWrapper/utils.js +34 -0
  16. package/CapSupportVideosWrapper/utils.js.map +1 -0
  17. package/package.json +1 -1
  18. package/CapActionBar/README.md +0 -11
  19. package/CapAdvancedIcon/README.md +0 -185
  20. package/CapAdvancedIcon/use-cases.md +0 -44
  21. package/CapAlert/README.md +0 -144
  22. package/CapAppNotEnabled/README.md +0 -84
  23. package/CapAskAira/README.md +0 -328
  24. package/CapBanner/README.md +0 -4
  25. package/CapBlock/README.md +0 -175
  26. package/CapBorderedBox/Status.md +0 -40
  27. package/CapCSVFileUploader/README.md +0 -124
  28. package/CapCSVFileUploader/Status.md +0 -47
  29. package/CapCard/README.md +0 -85
  30. package/CapCard/Status.md +0 -41
  31. package/CapCardBox/README.md +0 -169
  32. package/CapCardBox/Status.md +0 -52
  33. package/CapCarousel/README.md +0 -190
  34. package/CapCarousel/Status.md +0 -73
  35. package/CapCheckbox/README.md +0 -254
  36. package/CapCheckbox/Status.md +0 -41
  37. package/CapColorPicker/README.md +0 -112
  38. package/CapColorPicker/Status.md +0 -52
  39. package/CapColorPicker/tests/USE_CASES_ANALYSIS.md +0 -92
  40. package/CapColoredTag/README.md +0 -167
  41. package/CapColoredTag/Status.md +0 -49
  42. package/CapConditionPreview/MIGRATION_ANALYSIS.md +0 -70
  43. package/CapConditionPreview/README.md +0 -40
  44. package/CapConditionPreview/tests/USE_CASES_CapConditionPreview.md +0 -65
  45. package/CapCustomCard/README.md +0 -182
  46. package/CapCustomCard/Status.md +0 -40
  47. package/CapCustomCarousel/Status.md +0 -69
  48. package/CapCustomCheckboxList/README.md +0 -178
  49. package/CapCustomCheckboxList/Status.md +0 -52
  50. package/CapCustomCheckboxList/tests/USE_CASES_ANALYSIS.md +0 -174
  51. package/CapCustomList/README.md +0 -117
  52. package/CapCustomList/Status.md +0 -77
  53. package/CapCustomList/tests/USE_CASES_ANALYSIS.md +0 -124
  54. package/CapCustomSelect/README.md +0 -38
  55. package/CapDatePicker/README.md +0 -139
  56. package/CapDateRangePicker/README.md +0 -159
  57. package/CapDateTimePicker/README.md +0 -136
  58. package/CapDateTimeRangePicker/README.md +0 -243
  59. package/CapDivider/README.md +0 -122
  60. package/CapDrawer/README.md +0 -207
  61. package/CapDrawer/Status.md +0 -52
  62. package/CapDrawer/tests/MISSING_USE_CASES.md +0 -170
  63. package/CapDropdown/README.md +0 -515
  64. package/CapDropdown/Status.md +0 -45
  65. package/CapDropdown/tests/USE_CASES_ANALYSIS.md +0 -137
  66. package/CapError/README.md +0 -88
  67. package/CapErrorBoundary/CapErrorBoundary-use-cases.md +0 -89
  68. package/CapErrorBoundary/README.md +0 -150
  69. package/CapErrorStateIllustration/README.md +0 -222
  70. package/CapErrorStateIllustration/USE_CASES.md +0 -33
  71. package/CapExpressionEditor/README.md +0 -32
  72. package/CapForm/README.md +0 -132
  73. package/CapForm/Status.md +0 -40
  74. package/CapForm/tests/PHASE1_UNFULFILLED_USE_CASES.md +0 -113
  75. package/CapForm/tests/USE_CASES_ANALYSIS.md +0 -119
  76. package/CapFormItem/README.md +0 -320
  77. package/CapFormItem/Status.md +0 -73
  78. package/CapFormItem/tests/USE_CASES_ANALYSIS.md +0 -84
  79. package/CapGraph/README.md +0 -69
  80. package/CapGraph/USE_CASES.md +0 -66
  81. package/CapHamburgerMenu/README.md +0 -234
  82. package/CapHamburgerMenu/USE_CASES.md +0 -48
  83. package/CapHeader/Status.md +0 -41
  84. package/CapHeading/README.md +0 -220
  85. package/CapHeading/Status.md +0 -41
  86. package/CapIcon/README.md +0 -207
  87. package/CapIllustration/Status.md +0 -41
  88. package/CapImage/README.md +0 -50
  89. package/CapImportMFEComponent/README.md +0 -121
  90. package/CapInfoNote/Status.md +0 -40
  91. package/CapInfoNote/tests/USE_CASES_ANALYSIS.md +0 -114
  92. package/CapInput/README.md +0 -196
  93. package/CapInput/Status.md +0 -123
  94. package/CapInput/tests/USE_CASES_ANALYSIS.md +0 -169
  95. package/CapLanguageProvider/CapLanguageProvider-use-cases.md +0 -56
  96. package/CapLanguageProvider/README.md +0 -206
  97. package/CapLevelGraphRenderer/CapLevelGraphRenderer-test-cases.md +0 -50
  98. package/CapLevelGraphRenderer/README.md +0 -123
  99. package/CapLevelGraphRenderer/Tooltip_MIGRATION_ANALYSIS.md +0 -120
  100. package/CapLink/README.md +0 -203
  101. package/CapLink/Status.md +0 -32
  102. package/CapLink/tests/CapLink.missingUseCases.md +0 -95
  103. package/CapList/README.md +0 -129
  104. package/CapList/Status.md +0 -69
  105. package/CapListLayout/README.md +0 -7
  106. package/CapLogin/README.md +0 -7
  107. package/CapMenu/README.md +0 -86
  108. package/CapModal/README.md +0 -357
  109. package/CapModal/Status.md +0 -52
  110. package/CapModal/tests/USE_CASES_GAPS.md +0 -207
  111. package/CapMultiSelect/README.md +0 -170
  112. package/CapMultiSelect/tests/USE_CASES_ANALYSIS.md +0 -29
  113. package/CapMultiSelectDatePicker/README.md +0 -11
  114. package/CapNavigation/README.md +0 -72
  115. package/CapNotification/README.md +0 -228
  116. package/CapNotificationDropdown/README.md +0 -5
  117. package/CapPopover/README.md +0 -234
  118. package/CapProgress/Status.md +0 -40
  119. package/CapRadio/Status.md +0 -54
  120. package/CapRadioButton/README.md +0 -152
  121. package/CapRadioButton/Status.md +0 -70
  122. package/CapRadioButton/tests/USE_CASES_ANALYSIS.md +0 -120
  123. package/CapRadioCard/README.md +0 -161
  124. package/CapRadioCard/Status.md +0 -78
  125. package/CapRadioGroup/README.md +0 -141
  126. package/CapRadioGroup/Status.md +0 -59
  127. package/CapReorderComponent/README.md +0 -179
  128. package/CapReorderComponent/Status.md +0 -41
  129. package/CapRoadMap/README.md +0 -126
  130. package/CapRoadMap/Status.md +0 -53
  131. package/CapRoadMap/tests/USE_CASE_GAPS.md +0 -92
  132. package/CapRow/README.md +0 -424
  133. package/CapSKUUploader/README.md +0 -189
  134. package/CapSKUUploader/Status.md +0 -66
  135. package/CapSecondaryTopBar/README.md +0 -7
  136. package/CapSelect/README.md +0 -243
  137. package/CapSelectFilter/README.md +0 -121
  138. package/CapShape/README.md +0 -96
  139. package/CapShape/Status.md +0 -36
  140. package/CapShape/tests/USE_CASES_ANALYSIS.md +0 -120
  141. package/CapSideBar/README.md +0 -298
  142. package/CapSideBar/Status.md +0 -5
  143. package/CapSlideBox/README.md +0 -68
  144. package/CapSlider/README.md +0 -423
  145. package/CapSlider/Status.md +0 -48
  146. package/CapSlider/tests/TEST_COVERAGE.md +0 -118
  147. package/CapSnackBar/README.md +0 -222
  148. package/CapSnackBar/Status.md +0 -41
  149. package/CapSomethingWentWrong/README.md +0 -97
  150. package/CapSplit/README.md +0 -19
  151. package/CapStatisticCard/README.md +0 -138
  152. package/CapStatus/README.md +0 -148
  153. package/CapStatus/Status.md +0 -40
  154. package/CapSteps/Status.md +0 -40
  155. package/CapStepsAccordian/README.md +0 -305
  156. package/CapStepsAccordian/Status.md +0 -48
  157. package/CapSupportVideosWrapper/README.md +0 -14
  158. package/CapSwitch/README.md +0 -351
  159. package/CapTab/README.md +0 -406
  160. package/CapTab/Status.md +0 -104
  161. package/CapTab/tests/USE_CASE_GAPS.md +0 -143
  162. package/CapTabV3/ANALYSIS.md +0 -60
  163. package/CapTabV3/README.md +0 -156
  164. package/CapTabV3/Status.md +0 -52
  165. package/CapTabV3/tests/USE_CASE_GAPS.md +0 -149
  166. package/CapTable/README.md +0 -160
  167. package/CapTable/Status.md +0 -41
  168. package/CapTag/README.md +0 -16
  169. package/CapTagDropdown/README.md +0 -171
  170. package/CapTagDropdown/Status.md +0 -55
  171. package/CapTimePicker/README.md +0 -170
  172. package/CapTooltip/README.md +0 -336
  173. package/CapTooltipWithInfo/Status.md +0 -75
  174. package/CapTopBar/README.md +0 -146
  175. package/CapTree/README.md +0 -124
  176. package/CapTree/Status.md +0 -48
  177. package/CapTree/tests/STATUS.md +0 -154
  178. package/CapTreeSelect/README.md +0 -217
  179. package/CapTreeSelect/Status.md +0 -52
  180. package/CapTruncateList/README.md +0 -13
  181. package/CapUnifiedSelect/README.md +0 -40
  182. package/CapUploader/README.md +0 -313
  183. package/CapUploader/Status.md +0 -76
  184. package/CapUploader/tests/USE_CASES_ANALYSIS.md +0 -225
  185. package/CapUserProfile/README.md +0 -105
  186. package/CapUserProfile/Status.md +0 -95
  187. package/CapVirtualList/README.md +0 -162
  188. package/CapVirtualList/Status.md +0 -71
  189. package/assets/HOCs/ComponentWithLabelHOC/README.md +0 -230
@@ -1,52 +0,0 @@
1
- # Migration Status: CapCardBox
2
-
3
- **Last Updated**: 2026-02-06 11:25:58
4
-
5
- ## Migration Steps
6
-
7
- - [x] **Step 0**: Setup branch and remote tracking
8
- - [x] **Step 1**: Migration Prompt 1 (Main migration)
9
- - [x] **Step 1.5**: Export component in blaze-ui/components/index.ts
10
- - [x] **Step 2**: Migration Prompt 2 (Storybook support)
11
- - [x] **Step 2.5**: Verify deprecated props and prop changes (REQUIRED - enforced)
12
- - [x] **Step 3**: Migration Prompt 3 (Unit tests)
13
- - [x] **Step 4**: Migration Prompt 4 (Visual test cases)
14
- - [x] **Step 5**: Linting (ESLint)
15
- - [x] **Step 6**: Pre-build Validation
16
- - [x] **Step 7**: Build blaze-ui
17
- - [x] **Step 8**: Visual Testing
18
- - [x] **Step 9**: CSS Analysis (if mismatches found)
19
- - [x] **Step 9.5**: CSS Analysis Completed
20
- - [x] **Step 10**: Git Commit & Push to branch (pre-commit hook will run tests)
21
- - [x] **Step 11**: Create Pull Request
22
-
23
- ## Deprecated Props Verification
24
-
25
- _No deprecated props verification results yet._
26
-
27
- **Note**: Step 2.5 is REQUIRED and enforced.
28
- - Focus: **Ant Design component prop changes** (e.g., Dropdown, Input, Alert, Tooltip, etc.)
29
- - Reference: MIGRATION_CHANGELOG_TEMPLATE.md for format, ANTD_V6_MIGRATION.md for Ant Design deprecated APIs
30
- - Skip: If original component doesn't exist in cap-ui-library
31
- - All deprecated Ant Design props and prop changes must be documented before proceeding.
32
-
33
- ## Visual Testing Results
34
-
35
- **Last Test**: 2026-02-06 11:25:58
36
- **Maximum Mismatch**: 0%
37
-
38
- ### Mismatched Variants:
39
- -
40
-
41
-
42
- ## CSS Fixes Applied
43
-
44
- **Date**: 2026-01-31 11:07:27
45
- **Summary**: CSS fixes applied based on visual testing analysis.
46
-
47
- _See full analysis in: `/Users/sarahkhader/repos/migration/blaze-ui/tools/visual-testing/report/CapCardBox/css-fix-analysis.md`_
48
-
49
-
50
- ## Notes
51
-
52
- _No notes yet._
@@ -1,190 +0,0 @@
1
- # CapCarousel
2
-
3
- A carousel component built on Ant Design's Carousel component with Capillary-specific enhancements including top switcher navigation and custom data structure.
4
-
5
- ## Migration from cap-ui-library
6
-
7
- This component has been migrated from `@capillarytech/cap-ui-library` to `@capillarytech/blaze-ui` with the following changes:
8
-
9
- - Converted from JavaScript to TypeScript
10
- - Converted from styled-components to SCSS modules
11
- - Migrated to Ant Design v6 APIs
12
- - Added TypeScript interfaces for props
13
- - Maintained backward compatibility with the existing API
14
-
15
- ## Breaking Changes
16
-
17
- **No breaking changes from cap-ui-library v8.x**
18
-
19
- The component maintains backward compatibility with the previous version.
20
-
21
- ## Deprecated Props
22
-
23
- **Status:** ✅ **No deprecated props**
24
-
25
- The Ant Design `Carousel` component does not have any deprecated props in v6 that require backward compatibility mapping. Unlike other Ant Design components (Dropdown, Tooltip, Tabs, Alert, Slider, etc.), the Carousel component's prop API remained stable during the v3 → v6 migration.
26
-
27
- ### Ant Design Carousel Component Props
28
-
29
- **Ant Design Component:** `Carousel`
30
-
31
- **Deprecated Props:** None
32
-
33
- The Ant Design `Carousel` component has **no deprecated props** in v6. All Carousel props from v3 continue to work in v6 without any changes.
34
-
35
- **Verification References:**
36
- - ✅ Checked `MIGRATION_CHANGELOG_TEMPLATE.md` (PRIMARY REFERENCE) - No Carousel deprecated props patterns documented in the "Common Patterns & Solutions" section
37
- - ✅ Checked `ANTD_V6_MIGRATION.md` - Carousel component is **not** listed in the deprecated API fixes table (lines 25-40), confirming that Carousel has no deprecated props in Ant Design v6 migration
38
- - ✅ Verified all Carousel props used in the component (`dots`, `beforeChange`, `className`, and all props passed via `...rest`) are standard Ant Design v6 API props
39
-
40
- **Verified Ant Design Carousel Props (All Supported in v6):**
41
- - `beforeChange` - Callback before slide changes (wrapped by CapCarousel with custom signature)
42
- - `dots` - Whether to show dots indicator
43
- - `dotPosition` - Position of dots (`'top' | 'bottom' | 'left' | 'right'`)
44
- - `autoplay` - Whether to scroll automatically
45
- - `autoplaySpeed` - Interval time of autoplay (ms)
46
- - `effect` - Transition effect (`'scrollx' | 'fade'`)
47
- - `speed` - Transition speed (ms)
48
- - `easing` - Transition easing function
49
- - `vertical` - Whether to use vertical layout
50
- - `infinite` - Whether to loop infinitely
51
- - `draggable` - Whether to enable dragging
52
- - `swipeToSlide` - Whether to swipe to slide
53
- - `pauseOnHover` - Whether to pause autoplay on hover
54
- - `waitForAnimate` - Whether to wait for animation
55
- - `adaptiveHeight` - Whether to adapt height to current slide
56
- - All other `CarouselProps` from Ant Design v6
57
-
58
- **Note:** The component uses a custom `beforeChange` prop signature that wraps Ant Design's `beforeChange` callback. This is a Cap-specific enhancement and not related to Ant Design prop deprecations.
59
-
60
- ## Prop Changes
61
-
62
- | Prop | Status | Notes |
63
- |------|--------|-------|
64
- | `showTopSwitcher` | ✅ Unchanged | Whether to show the top switcher with navigation icons and heading |
65
- | `data` | ✅ Unchanged | Array of carousel data items |
66
- | `beforeChange` | ✅ Unchanged | Callback function called when carousel changes (custom signature: `(params: { currentIndex: number }) => void`) |
67
- | `currentIndex` | ✅ Unchanged | Current index of the carousel (controlled mode) |
68
- | `className` | ✅ Unchanged | Custom CSS class name for the carousel component |
69
- | `wrapperClassName` | ✅ Unchanged | Custom CSS class name for the wrapper element |
70
- | `width` | ✅ Unchanged | Width of the carousel wrapper (default: `'100%'`) |
71
- | `dots` | ✅ Unchanged | Whether to show dots indicator (default: `false`) |
72
- | All other Ant Design Carousel props | ✅ Unchanged | Passed through to underlying Carousel component |
73
-
74
- ## API Changes
75
-
76
- Since `Carousel` has no deprecated props in Ant Design v6, no API changes are required. All existing code using CapCarousel will continue to work without modifications.
77
-
78
- ### Custom beforeChange Signature
79
-
80
- CapCarousel wraps Ant Design's `beforeChange` callback to provide a simpler API:
81
-
82
- **Ant Design Carousel beforeChange:**
83
- ```tsx
84
- beforeChange: (from: number, to: number) => void
85
- ```
86
-
87
- **CapCarousel beforeChange:**
88
- ```tsx
89
- beforeChange: (params: { currentIndex: number }) => void
90
- ```
91
-
92
- This is a Cap-specific enhancement and not related to Ant Design prop deprecations.
93
-
94
- ## Code Examples
95
-
96
- ### Basic Usage
97
-
98
- ```tsx
99
- import CapCarousel from '@capillarytech/blaze-ui/components/CapCarousel';
100
-
101
- const carouselData = [
102
- {
103
- key: '1',
104
- name: 'Slide 1',
105
- content: <div>Content for slide 1</div>,
106
- },
107
- {
108
- key: '2',
109
- name: 'Slide 2',
110
- content: <div>Content for slide 2</div>,
111
- },
112
- ];
113
-
114
- <CapCarousel data={carouselData} />
115
- ```
116
-
117
- ### With Custom Width
118
-
119
- ```tsx
120
- <CapCarousel
121
- data={carouselData}
122
- width="800px"
123
- />
124
- ```
125
-
126
- ### Controlled Mode
127
-
128
- ```tsx
129
- const [currentIndex, setCurrentIndex] = useState(0);
130
-
131
- <CapCarousel
132
- data={carouselData}
133
- currentIndex={currentIndex}
134
- beforeChange={({ currentIndex }) => {
135
- setCurrentIndex(currentIndex);
136
- }}
137
- />
138
- ```
139
-
140
- ### Without Top Switcher
141
-
142
- ```tsx
143
- <CapCarousel
144
- data={carouselData}
145
- showTopSwitcher={false}
146
- dots={true}
147
- />
148
- ```
149
-
150
- ### With Ant Design Carousel Props
151
-
152
- ```tsx
153
- <CapCarousel
154
- data={carouselData}
155
- autoplay={true}
156
- autoplaySpeed={3000}
157
- effect="fade"
158
- speed={500}
159
- />
160
- ```
161
-
162
- ## Verification
163
-
164
- ### ✅ Deprecated Props Check
165
- - **Status:** ✅ **No deprecated props found**
166
- - **Ant Design Component:** Carousel
167
- - **Verification Method:**
168
- - Checked `ANTD_V6_MIGRATION.md` - Carousel is **not** listed in deprecated API fixes table
169
- - Checked `MIGRATION_CHANGELOG_TEMPLATE.md` - No Carousel deprecated props patterns documented
170
- - Verified all Carousel props used are standard v6 API props
171
-
172
- ### ✅ Component Props
173
- - All CapCarousel-specific props remain unchanged
174
- - All Ant Design Carousel props are passed through unchanged
175
- - Custom `beforeChange` signature is a Cap enhancement, not a deprecation
176
-
177
- ### ✅ Backward Compatibility
178
- - **Status:** ✅ **100% backward compatible**
179
- - All existing code using CapCarousel will continue to work without modifications
180
- - No deprecated props to migrate
181
-
182
- ## Summary
183
-
184
- ✅ **Carousel Component**: No deprecated props found
185
-
186
- **Verification Results:**
187
- - Deprecated props check: **None** - Carousel has no deprecated props in v6
188
- - Backward compatibility: **100%** - All props remain valid
189
- - API changes: **None** - No migration required
190
- - README.md created with "Deprecated Props" section documenting no deprecated props
@@ -1,73 +0,0 @@
1
- # Migration Status: CapCarousel
2
-
3
- **Last Updated**: 2026-02-06 22:57:09
4
-
5
- ## Migration Steps
6
-
7
- - [x] **Step 0**: Setup branch and remote tracking
8
- - [x] **Step 1**: Migration Prompt 1 (Main migration)
9
- - [ ] **Step 1.5**: Export component in blaze-ui/components/index.ts
10
- - [x] **Step 2**: Migration Prompt 2 (Storybook support)
11
- - [x] **Step 2.5**: Verify deprecated props and prop changes (REQUIRED - enforced)
12
- - [x] **Step 3**: Migration Prompt 3 (Unit tests)
13
- - [x] **Step 4**: Migration Prompt 4 (Visual test cases)
14
- - [x] **Step 5**: Linting (ESLint)
15
- - [x] **Step 6**: Pre-build Validation
16
- - [x] **Step 7**: Build blaze-ui
17
- - [ ] **Step 8**: Visual Testing
18
- - [ ] **Step 9**: CSS Analysis (if mismatches found)
19
- - [ ] **Step 9.5**: CSS Analysis Completed
20
- - [ ] **Step 10**: Git Commit & Push to branch (pre-commit hook will run tests)
21
- - [ ] **Step 11**: Create Pull Request
22
-
23
- ## Deprecated Props Verification
24
-
25
- ✅ **Verification Complete** - 2026-02-06
26
-
27
- **Status:** ✅ **No deprecated props found**
28
-
29
- **Ant Design Component Used:** Carousel
30
-
31
- **Verification Results:**
32
- 1. **Checked MIGRATION_CHANGELOG_TEMPLATE.md** - No Carousel deprecated props patterns documented
33
- 2. **Checked ANTD_V6_MIGRATION.md** - Carousel component is **not** listed in the deprecated API fixes table
34
- 3. **Component Analysis:**
35
- - Component uses `Carousel` from `antd-v5` (alias for `antd@^6.1.0`)
36
- - Props passed via `...rest` spread: `beforeChange`, `dots`, `className`, and all other standard Carousel props
37
- - All props used are standard Ant Design v6 Carousel API props
38
- - No deprecated props identified (e.g., no `visible` → `open`, no `overlayClassName` → `classNames.root`, etc.)
39
-
40
- **Conclusion:** The Ant Design `Carousel` component does not have any deprecated props in v6. No backward compatibility mapping or deprecation warnings are required.
41
-
42
- **Documentation:**
43
- - ✅ README.md created with "Deprecated Props" section documenting no deprecated props
44
- - ✅ Status.md updated with verification results
45
- - ✅ No @deprecated JSDoc comments needed (no deprecated props)
46
-
47
- **Note**: Step 2.5 is REQUIRED and enforced.
48
- - Focus: **Ant Design component prop changes** (e.g., Dropdown, Input, Alert, Tooltip, etc.)
49
- - Reference: MIGRATION_CHANGELOG_TEMPLATE.md for format, ANTD_V6_MIGRATION.md for Ant Design deprecated APIs
50
- - Skip: If original component doesn't exist in cap-ui-library
51
- - All deprecated Ant Design props and prop changes must be documented before proceeding.
52
-
53
- ## Visual Testing Results
54
-
55
- **Last Test**: 2026-02-06 17:58:24
56
- **Maximum Mismatch**: 2.08%
57
-
58
- ### Mismatched Variants:
59
- - empty-data:2.08%
60
-
61
-
62
- ## CSS Fixes Applied
63
-
64
- **Date**: 2026-02-06 17:59:02
65
- **Summary**: CSS fixes applied based on visual testing analysis.
66
-
67
- _See full analysis in: `/Users/sarahkhader/repos/migration/blaze-ui/tools/visual-testing/report/CapCarousel/css-fix-analysis.md`_
68
-
69
-
70
- ## Notes
71
-
72
- _No notes yet._
73
-
@@ -1,254 +0,0 @@
1
- # CapCheckbox Component
2
-
3
- A checkbox component built on top of Ant Design v6 Checkbox with additional features like error messages, inductive text, and custom label types.
4
-
5
- ## Migration from cap-ui-library to blaze-ui
6
-
7
- ### Summary of Changes
8
-
9
- This component has been migrated from `cap-ui-library` to `blaze-ui` with the following improvements:
10
-
11
- 1. **TypeScript Conversion**
12
- - Converted from JavaScript to TypeScript
13
- - Added comprehensive TypeScript interfaces in separate `CapCheckbox.interfaces.ts` file
14
- - Replaced PropTypes with TypeScript types
15
- - Full type safety with no `any` types
16
-
17
- 2. **Modern React Patterns**
18
- - Maintained as functional component
19
- - Uses React hooks (already functional in cap-ui-library)
20
- - Better type safety with TypeScript
21
-
22
- 3. **Styling**
23
- - Converted from styled-components to SCSS modules
24
- - Uses SCSS variables from `components/styled/` directory
25
- - Maintains backward design compatibility with existing class names
26
-
27
- 4. **Ant Design v6 Migration**
28
- - Updated to use Ant Design v6 APIs (`antd-v5` package)
29
- - All Ant Design Checkbox props are supported through prop spreading
30
-
31
- ### Breaking Changes
32
-
33
- **No breaking changes from cap-ui-library v8.x**
34
-
35
- All props remain backward compatible. The component maintains the same API and behavior as the cap-ui-library version.
36
-
37
- ### Props
38
-
39
- | Prop Name | Type | Default | Description |
40
- |-----------|------|---------|-------------|
41
- | `className` | `string` | `undefined` | Additional CSS class name for the checkbox wrapper |
42
- | `children` | `React.ReactNode` | `undefined` | Label text/content for the checkbox |
43
- | `errorMessage` | `string` | `undefined` | Error message displayed below the checkbox when `className` contains "error" |
44
- | `inductiveText` | `string` | `undefined` | Additional text displayed below the checkbox label |
45
- | `suffix` | `React.ReactNode` | `undefined` | Additional content displayed after the label |
46
- | `labelType` | `string` | `'h4'` | Type of label to use (passed to `CapLabel.CapLabelInline`) |
47
- | `checked` | `boolean` | `undefined` | Whether the checkbox is checked (Ant Design prop) |
48
- | `disabled` | `boolean` | `undefined` | Whether the checkbox is disabled (Ant Design prop) |
49
- | `onChange` | `(e: CheckboxChangeEvent) => void` | `undefined` | Callback when checkbox state changes (Ant Design prop) |
50
- | `...rest` | `CheckboxProps` | - | All other Ant Design Checkbox props are supported |
51
-
52
- ### Deprecated Props
53
-
54
- **No deprecated props** - All props from cap-ui-library v8.x are still supported.
55
-
56
- The Checkbox component in Ant Design v6 does not have deprecated props that require backward compatibility mapping.
57
-
58
- ### TypeScript Interfaces
59
-
60
- ```typescript
61
- import type { CapCheckboxProps } from '@capillarytech/blaze-ui';
62
-
63
- interface CapCheckboxProps extends Omit<CheckboxProps, 'children'> {
64
- className?: string;
65
- children?: React.ReactNode;
66
- errorMessage?: string;
67
- inductiveText?: string;
68
- suffix?: React.ReactNode;
69
- labelType?: string;
70
- }
71
- ```
72
-
73
- ### Static Properties
74
-
75
- The component exposes `CapCheckbox.Group` for checkbox groups:
76
-
77
- ```tsx
78
- import { CapCheckbox } from '@capillarytech/blaze-ui';
79
-
80
- <CapCheckbox.Group>
81
- <CapCheckbox value="option1">Option 1</CapCheckbox>
82
- <CapCheckbox value="option2">Option 2</CapCheckbox>
83
- </CapCheckbox.Group>
84
- ```
85
-
86
- ### Behavioral Changes
87
-
88
- None. The component behaves identically to the original cap-ui-library implementation.
89
-
90
- ### Migration Steps
91
-
92
- #### 1. Update Import
93
-
94
- ```tsx
95
- // Before (cap-ui-library)
96
- import CapCheckbox from '@capillarytech/cap-ui-library/CapCheckbox';
97
-
98
- // After (blaze-ui)
99
- import { CapCheckbox } from '@capillarytech/blaze-ui';
100
- // or
101
- import CapCheckbox from '@capillarytech/blaze-ui/CapCheckbox';
102
- ```
103
-
104
- #### 2. Usage (No Changes Required)
105
-
106
- ```tsx
107
- // Basic usage - works exactly the same
108
- <CapCheckbox>Checkbox Label</CapCheckbox>
109
-
110
- // With error message
111
- <CapCheckbox className="error" errorMessage="This field is required">
112
- Required Field
113
- </CapCheckbox>
114
-
115
- // With inductive text
116
- <CapCheckbox inductiveText="Additional information">
117
- Checkbox with Info
118
- </CapCheckbox>
119
-
120
- // With suffix
121
- <CapCheckbox suffix={<span>★</span>}>Checkbox with Suffix</CapCheckbox>
122
-
123
- // Controlled checkbox
124
- <CapCheckbox checked={isChecked} onChange={handleChange}>
125
- Controlled Checkbox
126
- </CapCheckbox>
127
-
128
- // Disabled checkbox
129
- <CapCheckbox disabled>Disabled Checkbox</CapCheckbox>
130
- ```
131
-
132
- #### 3. TypeScript (New Benefit)
133
-
134
- If using TypeScript, you now get full type checking:
135
-
136
- ```tsx
137
- import { CapCheckbox, CapCheckboxProps } from '@capillarytech/blaze-ui';
138
-
139
- // Type-safe props
140
- const props: CapCheckboxProps = {
141
- labelType: 'h3',
142
- errorMessage: 'Error message',
143
- children: 'Checkbox Label'
144
- };
145
-
146
- <CapCheckbox {...props} />
147
- ```
148
-
149
- ### Examples
150
-
151
- #### Basic Usage
152
-
153
- ```tsx
154
- import { CapCheckbox } from '@capillarytech/blaze-ui';
155
-
156
- function Form() {
157
- const [checked, setChecked] = React.useState(false);
158
-
159
- return (
160
- <CapCheckbox checked={checked} onChange={(e) => setChecked(e.target.checked)}>
161
- I agree to the terms and conditions
162
- </CapCheckbox>
163
- );
164
- }
165
- ```
166
-
167
- #### With Error Message
168
-
169
- ```tsx
170
- import { CapCheckbox } from '@capillarytech/blaze-ui';
171
-
172
- function Form() {
173
- const [hasError, setHasError] = React.useState(true);
174
-
175
- return (
176
- <CapCheckbox
177
- className={hasError ? 'error' : ''}
178
- errorMessage="Please accept the terms to continue"
179
- >
180
- Accept Terms
181
- </CapCheckbox>
182
- );
183
- }
184
- ```
185
-
186
- #### With Inductive Text
187
-
188
- ```tsx
189
- import { CapCheckbox } from '@capillarytech/blaze-ui';
190
-
191
- function Form() {
192
- return (
193
- <CapCheckbox inductiveText="By checking this, you agree to receive marketing emails">
194
- Subscribe to newsletter
195
- </CapCheckbox>
196
- );
197
- }
198
- ```
199
-
200
- #### Checkbox Group
201
-
202
- ```tsx
203
- import { CapCheckbox } from '@capillarytech/blaze-ui';
204
-
205
- function Form() {
206
- const [selectedValues, setSelectedValues] = React.useState<string[]>([]);
207
-
208
- return (
209
- <CapCheckbox.Group
210
- value={selectedValues}
211
- onChange={(values) => setSelectedValues(values as string[])}
212
- >
213
- <CapCheckbox value="option1">Option 1</CapCheckbox>
214
- <CapCheckbox value="option2">Option 2</CapCheckbox>
215
- <CapCheckbox value="option3">Option 3</CapCheckbox>
216
- </CapCheckbox.Group>
217
- );
218
- }
219
- ```
220
-
221
- #### Custom Label Type
222
-
223
- ```tsx
224
- import { CapCheckbox } from '@capillarytech/blaze-ui';
225
-
226
- function Form() {
227
- return (
228
- <CapCheckbox labelType="h3">
229
- Large Label Checkbox
230
- </CapCheckbox>
231
- );
232
- }
233
- ```
234
-
235
- ### Styling
236
-
237
- The component uses SCSS modules with the following class structure:
238
-
239
- - `.cap-checkbox-wrapper` - Main wrapper
240
- - `.cap-checkbox-v2` - Checkbox container
241
- - `.title` - Label styling
242
- - `.title.has-suffix` - Label with suffix spacing
243
- - `.inductive-text` - Inductive text styling
244
- - `.error-message` - Error message styling
245
-
246
- All styles use SCSS variables from `components/styled/variables` for consistency.
247
-
248
- ### Notes
249
-
250
- - The component wraps Ant Design's Checkbox component and extends it with additional features
251
- - Error messages are only displayed when `className` contains the string "error" and `errorMessage` is provided
252
- - The `labelType` prop is passed directly to `CapLabel.CapLabelInline` component
253
- - All Ant Design Checkbox props are supported through prop spreading
254
- - The component maintains backward compatibility with existing designs and class names
@@ -1,41 +0,0 @@
1
- # Migration Status: CapCheckbox
2
-
3
- **Last Updated**: 2026-01-19 02:40:52
4
-
5
- ## Migration Steps
6
-
7
- - [x] **Step 0**: Setup branch and remote tracking
8
- - [x] **Step 1**: Migration Prompt 1 (Main migration)
9
- - [x] **Step 2**: Migration Prompt 2 (Storybook support)
10
- - [x] **Step 3**: Migration Prompt 3 (Unit tests)
11
- - [x] **Step 4**: Linting (ESLint)
12
- - [x] **Step 5**: Pre-build Validation
13
- - [x] **Step 6**: Build blaze-ui
14
- - [x] **Step 7**: Visual Testing
15
- - [x] **Step 8**: CSS Analysis (if mismatches found)
16
- - [x] **Step 8.5**: CSS Analysis Completed
17
- - [x] **Step 8.9**: Run Tests & Fix Failures
18
- - [ ] **Step 9**: Git Commit & Push to branch
19
- - [ ] **Step 10**: Create Pull Request
20
-
21
- ## Visual Testing Results
22
-
23
- **Last Test**: 2026-01-19 02:40:52
24
- **Maximum Mismatch**: 2.48%
25
-
26
- ### Mismatched Variants:
27
- - ✅ All variants match perfectly!
28
-
29
-
30
- ## CSS Fixes Applied
31
-
32
- **Date**: 2026-01-19 02:40:52
33
- **Summary**: CSS fixes applied based on visual testing analysis.
34
-
35
- _See full analysis in: `/Users/sarahkhader/repos/migration/blaze-ui/tools/visual-testing/report/CapCheckbox/css-fix-analysis.md`_
36
-
37
-
38
- ## Notes
39
-
40
- _No notes yet._
41
-