@capillarytech/blaze-ui 5.21.0 → 5.22.0

package/CapLink/README.md

@@ -1,203 +0,0 @@
-# CapLink Migration Guide
-
-## Summary
-
-CapLink has been migrated from `cap-ui-library` to `blaze-ui` with the following changes:
-
-- Converted from class component to functional component
-- Removed styled-components dependency (moved font-weight styling to SCSS)
-- Migrated to Ant Design v6 APIs
-- Removed all `.ant-` class selectors from SCSS
-- Maintained backward compatibility with the existing API
-
-## Breaking Changes
-
-**No breaking changes** - The component maintains full backward compatibility with the previous version.
-
-### Ant Design Component Changes
-
-- **Anchor component**: No breaking changes - All props used (`affix`) remain valid in Ant Design v6
-- **Anchor.Link component**: No breaking changes - Standard HTML anchor attributes are passed through unchanged
-
-## Prop Changes
-
-### All Props (Unchanged)
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `children` | `React.ReactNode` | `undefined` | Link text content |
-| `className` | `string` | `undefined` | Additional CSS class name |
-| `disabled` | `boolean` | `false` | Whether the link is disabled |
-| `fontWeight` | `'m' \| 'regular'` | `undefined` | Font weight: 'm' for medium, 'regular' for regular |
-| `href` | `string` | `undefined` | URL to navigate to |
-| `onClick` | `(e: React.MouseEvent<HTMLAnchorElement>, link: { href?: string; title?: React.ReactNode }) => void` | `undefined` | Click handler |
-| `prefix` | `React.ReactNode` | `undefined` | Content displayed before the link text |
-| `style` | `React.CSSProperties` | `undefined` | Inline styles for the link |
-| `suffix` | `React.ReactNode` | `undefined` | Content displayed after the link text |
-| `title` | `string` | `undefined` | Link title attribute |
-
-### Deprecated Props
-
-**None** - No deprecated Ant Design props identified.
-
-#### Ant Design Component Verification
-
-CapLink uses Ant Design's **Anchor** component internally. After verification against the Ant Design v6 migration guide:
-
-- ✅ **Anchor component**: No deprecated props identified in Ant Design v6
-- ✅ **Props used**: `affix={false}` - Still valid in v6
-- ✅ **Anchor.Link component**: Receives standard HTML anchor attributes (via `{...rest}`) - No deprecated Ant Design props
-
-**Note**: The Anchor component is not listed in the deprecated API fixes table in `ANTD_V6_MIGRATION.md`, confirming that Anchor does not have any deprecated props in Ant Design v6. The component uses a minimal Anchor API (`affix={false}`) which remains valid in v6.
-
-## API Changes
-
-### Before (cap-ui-library)
-
-```tsx
-import CapLink from '@capillarytech/cap-ui-library/components/CapLink';
-
-<CapLink href="#section" fontWeight="m" onClick={handleClick}>
-  Link Text
-</CapLink>
-```
-
-### After (blaze-ui)
-
-```tsx
-import { CapLink } from '@capillarytech/blaze-ui';
-
-<CapLink href="#section" fontWeight="m" onClick={handleClick}>
-  Link Text
-</CapLink>
-```
-
-## Migration Steps for Consumers
-
-1. **Update imports:**
-   ```tsx
-   // Old
-   import CapLink from '@capillarytech/cap-ui-library/components/CapLink';
-   
-   // New
-   import { CapLink } from '@capillarytech/blaze-ui';
-   ```
-
-2. **No prop changes required** - All existing props work exactly the same.
-
-## Implementation Details
-
-### Component Structure
-
-- **Before**: Class component using styled-components for font-weight styling
-- **After**: Functional component using SCSS classes for font-weight styling
-
-### Styling Changes
-
-- **Removed**: All `.ant-` class selectors from SCSS
-- **Removed**: styled-components dependency
-- **Added**: SCSS-based font-weight classes (`font-weight-medium`, `font-weight-regular`)
-- **Maintained**: All visual styling and behavior
-
-### Technical Changes
-
-1. Converted from `React.Component` to `React.FC`
-2. Removed `PropTypes` (using TypeScript types only)
-3. Removed `styled-components` dependency
-4. Moved font-weight logic from styled-components to SCSS classes
-5. Updated to use `classNames` library (camelCase import)
-6. Removed all `.ant-` class selectors from styles.scss
-
-## Behavioral Changes
-
-- **No breaking changes** - All existing functionality is preserved
-- Component behavior remains identical to the previous version
-- Visual appearance is unchanged
-
-## TypeScript Support
-
-Full TypeScript support with exported `CapLinkProps` interface:
-
-```tsx
-import type { CapLinkProps } from '@capillarytech/blaze-ui';
-
-const props: CapLinkProps = {
-  href: '#section',
-  children: 'Link Text',
-  fontWeight: 'm',
-};
-```
-
-## Examples
-
-### Basic Usage
-
-```tsx
-import { CapLink } from '@capillarytech/blaze-ui';
-
-<CapLink href="#section">Basic Link</CapLink>
-```
-
-### With Prefix and Suffix
-
-```tsx
-import { CapLink } from '@capillarytech/blaze-ui';
-import { CapIcon } from '@capillarytech/blaze-ui';
-
-<CapLink 
-  href="#section" 
-  prefix={<CapIcon name="chevron-left" />}
-  suffix={<CapIcon name="chevron-right" />}
->
-  Link with Icons
-</CapLink>
-```
-
-### With Custom Font Weight
-
-```tsx
-<CapLink href="#section" fontWeight="m">
-  Medium Weight Link
-</CapLink>
-
-<CapLink href="#section" fontWeight="regular">
-  Regular Weight Link
-</CapLink>
-```
-
-### Disabled State
-
-```tsx
-<CapLink href="#section" disabled>
-  Disabled Link
-</CapLink>
-```
-
-### With Click Handler
-
-```tsx
-<CapLink 
-  href="#section" 
-  onClick={(e, link) => {
-    console.log('Clicked:', link.href);
-  }}
->
-  Clickable Link
-</CapLink>
-```
-
-## Notes
-
-- The component uses Ant Design's **Anchor** component internally
-- The Anchor component uses `affix={false}` to disable the affix behavior
-- All Ant Design Anchor props (except those overridden) can be passed through via `{...rest}`
-- Standard HTML anchor attributes (`href`, `title`, etc.) are passed to `Anchor.Link` via `{...rest}`
-- The component prevents default anchor behavior and calls the custom `onClick` handler
-- Font weight styling is now handled via SCSS classes instead of styled-components
-
-### Ant Design v6 Compliance
-
-✅ **Fully compliant** - CapLink uses Ant Design v6 APIs:
-- Uses `Anchor` component from `antd` (v6)
-- No deprecated Ant Design props are used
-- All Ant Design component props are v6-compatible

package/CapLink/Status.md

@@ -1,32 +0,0 @@
-# Migration Status: CapLink
-
-**Last Updated**: 2026-01-31 18:40:39
-
-## Migration Steps
-
-- [x] **Step 0**: Setup branch and remote tracking
-- [x] **Step 1**: Migration Prompt 1 (Main migration)
-- [x] **Step 2**: Migration Prompt 2 (Storybook support)
-- [x] **Step 3**: Migration Prompt 3 (Unit tests)
-- [x] **Step 4**: Migration Prompt 4 (Visual test cases)
-- [x] **Step 5**: Linting (ESLint)
-- [x] **Step 6**: Pre-build Validation
-- [ ] **Step 7**: Build blaze-ui
-- [ ] **Step 8**: Visual Testing
-- [ ] **Step 9**: CSS Analysis (if mismatches found)
-- [ ] **Step 9.5**: CSS Analysis Completed
-- [ ] **Step 10**: Git Commit & Push to branch (pre-commit hook will run tests)
-- [ ] **Step 11**: Create Pull Request
-
-## Visual Testing Results
-
-_No visual testing results yet._
-
-## CSS Fixes Applied
-
-_No CSS fixes applied yet._
-
-## Notes
-
-_No notes yet._
-

package/CapLink/tests/CapLink.missingUseCases.md

@@ -1,95 +0,0 @@
-# CapLink - Missing Use Cases Analysis
-
-## Phase 1: Use Cases the Component is NOT Fulfilling
-
-Based on analysis of the CapLink component implementation and comparison with common link component patterns in the codebase, the following use cases are **NOT currently supported**:
-
-### 1. **External Link Handling**
-- **Missing**: Automatic detection and handling of external links
-- **Impact**: No automatic `target="_blank"` or `rel="noopener noreferrer"` for external URLs
-- **Current Behavior**: All links use the same behavior regardless of URL type
-- **Expected**: External links should open in new tab with proper security attributes
-
-### 2. **Conditional preventDefault**
-- **Missing**: Option to allow default navigation behavior
-- **Impact**: Component always calls `e.preventDefault()`, even when onClick is not provided
-- **Current Behavior**: `handleClick` always prevents default navigation
-- **Expected**: Should only prevent default when onClick handler is provided, or allow prop to control this behavior
-
-### 3. **Target Attribute Support**
-- **Missing**: Explicit support for `target` prop (though it can be passed via rest props)
-- **Impact**: No clear API for opening links in new tabs/windows
-- **Current Behavior**: Can pass target via rest props, but not documented or type-safe
-- **Expected**: Explicit `target` prop with common values like `_blank`, `_self`, `_parent`, `_top`
-
-### 4. **Rel Attribute for Security**
-- **Missing**: Automatic `rel="noopener noreferrer"` for external links
-- **Impact**: Security vulnerability when opening external links in new tabs
-- **Current Behavior**: No automatic security attributes
-- **Expected**: Should automatically add security attributes for external links with `target="_blank"`
-
-### 5. **Loading State**
-- **Missing**: Visual feedback during navigation/loading
-- **Impact**: No way to indicate that a link action is in progress
-- **Current Behavior**: No loading state support
-- **Expected**: Support for loading spinner or disabled state during async operations
-
-### 6. **Error State**
-- **Missing**: Error state handling
-- **Impact**: No way to show error state if link fails
-- **Current Behavior**: No error state support
-- **Expected**: Visual indication when link action fails
-
-### 7. **Keyboard Navigation**
-- **Missing**: Explicit keyboard event handlers
-- **Impact**: Relies on default anchor behavior, may not handle all keyboard interactions
-- **Current Behavior**: Uses default anchor keyboard behavior
-- **Expected**: Explicit support for Enter/Space key activation
-
-### 8. **ARIA Attributes**
-- **Missing**: Comprehensive ARIA support
-- **Impact**: May not be fully accessible to screen readers
-- **Current Behavior**: Relies on default anchor accessibility
-- **Expected**: Support for `aria-label`, `aria-describedby`, `role` attributes
-
-### 9. **Disabled State Click Prevention**
-- **Missing**: Programmatic prevention of clicks when disabled
-- **Impact**: Disabled state relies only on CSS (`pointer-events: none`), onClick handler still attached
-- **Current Behavior**: CSS prevents clicks, but handler logic still exists
-- **Expected**: Early return in handleClick when disabled is true
-
-### 10. **Link Type Detection**
-- **Missing**: Automatic detection of link type (internal vs external, anchor vs route)
-- **Impact**: No smart routing or navigation handling
-- **Current Behavior**: All links treated the same
-- **Expected**: Different behavior for internal routes vs external URLs vs anchor links
-
-### 11. **Analytics/Tracking Integration**
-- **Missing**: Built-in support for analytics tracking
-- **Impact**: No automatic click tracking
-- **Current Behavior**: Requires manual onClick handler for tracking
-- **Expected**: Optional analytics prop or automatic tracking
-
-### 12. **Icon-Only Links**
-- **Missing**: Explicit support for icon-only links with proper accessibility
-- **Impact**: Icon-only links may not have proper aria-labels
-- **Current Behavior**: Can render icons but no special handling
-- **Expected**: Automatic aria-label for icon-only links
-
----
-
-## Notes
-
-- Some of these features can be partially achieved by passing props via the `rest` spread, but they're not explicitly supported or documented
-- The component is built on Ant Design's Anchor component, which may have its own limitations
-- The `always preventDefault` behavior may be intentional for SPA navigation patterns
-
----
-
-## Recommendations
-
-1. **High Priority**: Add conditional `preventDefault` logic
-2. **High Priority**: Add explicit `target` and `rel` prop support
-3. **Medium Priority**: Add disabled state early return in handleClick
-4. **Medium Priority**: Improve accessibility with ARIA attributes
-5. **Low Priority**: Add loading/error states (may be out of scope for a link component)

package/CapList/README.md

@@ -1,129 +0,0 @@
-# CapList
-
-A wrapper component around Ant Design's List component with Capillary-specific styling.
-
-## Migration from cap-ui-library
-
-This component has been migrated from `@capillarytech/cap-ui-library` to `@capillarytech/blaze-ui` with the following changes:
-
-### Breaking Changes
-
-**No breaking changes** - The component maintains full backward compatibility with the previous version.
-
-### Deprecated Props
-
-**Status:** ✅ **No deprecated props**
-
-The Ant Design `List` component does not have any deprecated props in v6 that require backward compatibility mapping. Unlike other Ant Design components (Dropdown, Tooltip, Tabs, Alert, etc.), the List component's prop API remained stable during the v3 → v6 migration.
-
-#### Ant Design Component Used
-
-- **List** (`antd-v5`) - Used directly from Ant Design
-
-#### Verification Steps
-
-The following verification steps were completed to confirm no deprecated props exist:
-
-| Verification Step | Status | Result |
-|-------------------|--------|--------|
-| Checked `MIGRATION_CHANGELOG_TEMPLATE.md` | ✅ | No List component deprecated props patterns documented |
-| Checked `ANTD_V6_MIGRATION.md` | ✅ | List component is NOT listed in the deprecated API fixes table |
-| Verified against Ant Design v6 migration guide | ✅ | List component API remains stable with no deprecated props |
-| Compared original vs migrated component | ✅ | No deprecated props used in either version |
-
-#### Reference: Other Ant Design Components with Deprecated Props
-
-The following Ant Design components **do** have deprecated props in v6, but **List is not among them**:
-
-- **Dropdown**: `visible` → `open`, `overlayClassName` → `classNames.root`, `overlay` → `menu`
-- **Tooltip**: `destroyTooltipOnHide` → `destroyOnHidden`, `overlayClassName` → `classNames.root`, `overlayStyle` → `styles.root`
-- **Tabs**: `TabPane` children → `items` prop, `tabPosition` → `tabPlacement`
-- **Alert**: `message` → `title`
-- **All components**: `visible` → `open`, `onVisibleChange` → `onOpenChange`
-
-**Conclusion:** CapList only uses Ant Design's `List` component, which has no deprecated props in v6. All List props remain valid and unchanged in v6. No backward compatibility mapping, deprecation warnings, or `@deprecated` JSDoc comments are required.
-
-### Prop Changes
-
-| Prop | Status | Notes |
-|------|--------|-------|
-| All Ant Design List props | ✅ Unchanged | All props from Ant Design List component are passed through unchanged |
-| `className` | ✅ Unchanged | Custom CSS class name |
-
-### API Changes
-
-- **TypeScript Support:** Full TypeScript support with exported `CapListProps` interface
-- **Ant Design Version:** Upgraded from Ant Design v3 to v6 (via v5)
-- **Styling:** Migrated from SCSS overrides to Ant Design theme tokens
-
-### Style Migration
-
-**Ant Design v5 → v6 Style Changes:**
-
-The component's split border color styling has been migrated from SCSS overrides to Ant Design theme tokens:
-
-- **Before (v5):** SCSS override `.ant-list.cap-list-v2.ant-list-split .ant-list-item { border-bottom: 1px solid $CAP_G07; }`
-- **After (v6):** Theme config token `components.List.colorSplit: '#dfe2e7'`
-
-This change ensures better theme consistency and eliminates the need for CSS overrides. The visual appearance remains identical.
-
-### Usage Examples
-
-#### Basic Usage
-
-```tsx
-import { CapList } from '@capillarytech/blaze-ui';
-
-<CapList
-  dataSource={[
-    { id: 1, name: 'Item 1' },
-    { id: 2, name: 'Item 2' },
-  ]}
-  renderItem={(item) => <CapList.Item>{item.name}</CapList.Item>}
-/>
-```
-
-#### With Header and Footer
-
-```tsx
-<CapList
-  header={<div>Header</div>}
-  footer={<div>Footer</div>}
-  dataSource={data}
-  renderItem={(item) => <CapList.Item>{item.name}</CapList.Item>}
-/>
-```
-
-#### Using CapList.Item
-
-```tsx
-<CapList>
-  <CapList.Item>Item 1</CapList.Item>
-  <CapList.Item>Item 2</CapList.Item>
-  <CapList.Item>Item 3</CapList.Item>
-</CapList>
-```
-
-### TypeScript
-
-```tsx
-import { CapList, CapListProps } from '@capillarytech/blaze-ui';
-
-const props: CapListProps = {
-  dataSource: [{ id: 1, name: 'Item 1' }],
-  renderItem: (item) => <CapList.Item>{item.name}</CapList.Item>,
-};
-
-<CapList {...props} />
-```
-
-### Migration Steps for Consumers
-
-**No migration required** - All existing code using CapList will continue to work without modifications. The component maintains 100% backward compatibility.
-
-### Component Structure
-
-The component is a simple wrapper that:
-- Passes all props through to Ant Design's List component
-- Adds the `cap-list-v2` CSS class prefix
-- Exposes `CapList.Item` as a reference to `List.Item`

package/CapList/Status.md

@@ -1,69 +0,0 @@
-# Migration Status: CapList
-
-**Last Updated**: 2026-02-08 14:27:45
-
-## Migration Steps
-
-- [x] **Step 0**: Setup branch and remote tracking
-- [x] **Step 1**: Migration Prompt 1 (Main migration)
-- [x] **Step 1.5**: Export component in blaze-ui/components/index.ts
-- [x] **Step 2**: Migration Prompt 2 (Storybook support)
-- [x] **Step 2.5**: Verify deprecated props and prop changes (REQUIRED - enforced)
-- [x] **Step 3**: Migration Prompt 3 (Unit tests)
-- [x] **Step 4**: Migration Prompt 4 (Visual test cases)
-- [x] **Step 5**: Linting (ESLint)
-- [x] **Step 6**: Pre-build Validation
-- [x] **Step 7**: Build blaze-ui
-- [x] **Step 8**: Visual Testing
-- [x] **Step 9**: CSS Analysis (if mismatches found)
-- [x] **Step 9.5**: CSS Analysis Completed
-- [x] **Step 10**: Git Commit & Push to branch (pre-commit hook will run tests)
-- [x] **Step 11**: Create Pull Request
-
-## Deprecated Props Verification
-
-**Status:** ✅ **Verification Complete**
-
-### Ant Design Components Used
-- **List** (`antd`) - Used directly from Ant Design
-
-### Deprecated Props Status
-✅ **No deprecated props found**
-
-The Ant Design `List` component does **not** have any deprecated props in v6 according to the [Ant Design v6 Migration Guide](https://ant.design/docs/react/migration-v6) and the project's `ANTD_V6_MIGRATION.md`.
-
-**Verification Steps Completed:**
-- ✅ Checked `MIGRATION_CHANGELOG_TEMPLATE.md` - No List component deprecated props patterns documented
-- ✅ Checked `ANTD_V6_MIGRATION.md` - List component is NOT listed in the deprecated API fixes table
-- ✅ Compared original component (`cap-ui-library/components/CapList/index.js`) with migrated component - No deprecated props used
-- ✅ Verified component structure - Simple wrapper that passes all props through to Ant Design List
-- ✅ README.md created with "Deprecated Props" section documenting no deprecated props
-
-**Conclusion:** The Ant Design `List` component does not have any deprecated props in v6. No backward compatibility mapping or deprecation warnings are required. All List props remain valid and unchanged in v6.
-
-**Note**: Step 2.5 is REQUIRED and enforced. 
-- Focus: **Ant Design component prop changes** (e.g., Dropdown, Input, Alert, Tooltip, etc.)
-- Reference: MIGRATION_CHANGELOG_TEMPLATE.md for format, ANTD_V6_MIGRATION.md for Ant Design deprecated APIs
-- Skip: If original component doesn't exist in cap-ui-library
-- All deprecated Ant Design props and prop changes must be documented before proceeding.
-
-## Visual Testing Results
-
-**Last Test**: 2026-02-08 14:27:45
-**Maximum Mismatch**: 0%
-
-### Mismatched Variants:
-- 
-
-
-## CSS Fixes Applied
-
-**Date**: 2026-02-06 13:30:53
-**Summary**: CSS fixes applied based on visual testing analysis.
-
-_See full analysis in: `/Users/sarahkhader/repos/migration/blaze-ui/tools/visual-testing/report/CapList/css-fix-analysis.md`_
-
-
-## Notes
-
-_No notes yet._

package/CapListLayout/README.md

@@ -1,7 +0,0 @@
-# CapListLayout
-
-A layout component that combines CapActionBar and CapTable for creating list views with action bars and data tables.
-
-### Breaking Changes
-
-None - This component is a simple wrapper that doesn't use Antd components directly.

package/CapLogin/README.md

@@ -1,7 +0,0 @@
-# CapLogin
-
-Login component with username and password fields, integrated with authentication API.
-
-### Breaking Changes
-
-**No breaking changes from cap-ui-library v8.x**

package/CapMenu/README.md

@@ -1,86 +0,0 @@
-# CapMenu
-
-A wrapper component around Ant Design's Menu component, providing Capillary-specific styling and behavior.
-
-## Migration Status: ✅ Ant Design v6 Compatible
-
-This component has been migrated to be compatible with Ant Design v6. No breaking changes were required as the component was already using v6-compatible APIs.
-
-## Usage
-
-```tsx
-import { CapMenu } from '@capillarytech/blaze-ui';
-
-// Basic usage
-<CapMenu
-  mode="horizontal"
-  theme="light"
-  items={[
-    { key: '1', label: 'Home' },
-    { key: '2', label: 'About' },
-  ]}
-/>
-
-// With submenu
-<CapMenu
-  mode="inline"
-  items={[
-    { key: '1', label: 'Home' },
-    {
-      key: '2',
-      label: 'Products',
-      children: [
-        { key: '2-1', label: 'Product 1' },
-        { key: '2-2', label: 'Product 2' },
-      ],
-    },
-  ]}
-/>
-
-// Using static components
-<CapMenu mode="vertical">
-  <CapMenu.Item key="1">Home</CapMenu.Item>
-  <CapMenu.SubMenu key="2" title="Products">
-    <CapMenu.Item key="2-1">Product 1</CapMenu.Item>
-    <CapMenu.Item key="2-2">Product 2</CapMenu.Item>
-  </CapMenu.SubMenu>
-  <CapMenu.Divider />
-  <CapMenu.ItemGroup title="Settings">
-    <CapMenu.Item key="3">Profile</CapMenu.Item>
-    <CapMenu.Item key="4">Logout</CapMenu.Item>
-  </CapMenu.ItemGroup>
-</CapMenu>
-```
-
-## Props
-
-All props from Ant Design's `Menu` component are supported. See [Ant Design Menu API](https://ant.design/components/menu) for complete documentation.
-
-### Common Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `mode` | `'horizontal' \| 'vertical' \| 'inline'` | `'horizontal'` | Menu display mode |
-| `theme` | `'light' \| 'dark'` | `'light'` | Menu theme |
-| `selectedKeys` | `string[]` | - | Selected menu item keys (controlled) |
-| `defaultSelectedKeys` | `string[]` | - | Default selected menu item keys (uncontrolled) |
-| `openKeys` | `string[]` | - | Open submenu keys (controlled) |
-| `defaultOpenKeys` | `string[]` | - | Default open submenu keys (uncontrolled) |
-| `onSelect` | `(info: { key: string; selectedKeys: string[] }) => void` | - | Callback when menu item is selected |
-| `onOpenChange` | `(openKeys: string[]) => void` | - | Callback when submenu open state changes |
-| `className` | `string` | - | Additional CSS class name |
-
-## Static Components
-
-- `CapMenu.Item` - Menu item component
-- `CapMenu.SubMenu` - Submenu component
-- `CapMenu.ItemGroup` - Item group component
-- `CapMenu.Divider` - Divider component
-
-## Breaking Changes
-
-**None** - This component was already using v6-compatible APIs and required no breaking changes.
-
-## Deprecated Props
-
-**None** - No deprecated props are currently in use.