@wise/wds-codemods 0.0.1-experimental-731cdc7 → 0.0.1-experimental-17c5d52

package/.changeset/better-impalas-drop.md

@@ -0,0 +1,5 @@
+---
+'@wise/wds-codemods': patch
+---
+
+NPM release setup

package/.changeset/config.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@2.3.0/schema.json",
+  "changelog": ["@changesets/changelog-github", { "repo": "transferwise/wds-codemods" }],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "minor",
+  "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
+    "onlyUpdatePeerDependentsWhenOutOfRange": true
+  }
+}

package/.changeset/quick-mails-joke.md

@@ -0,0 +1,128 @@
+---
+'@wise/wds-codemods': major
+---
+
+# 🎉 @wise/wds-codemods@1.0.0 - Initial Release
+
+Welcome to the first major release of WDS Codemods! This comprehensive toolkit provides automated migration support for Wise Design System components, making it easy to upgrade your codebase to the latest component versions.
+
+## ✨ Core Features
+
+### 🔧 Transform Engine
+
+- **Interactive CLI**: Choose transforms and configure options with an intuitive command-line interface
+- **Dry Run Mode**: Preview changes before applying them to your codebase
+- **Monorepo Support**: Built-in support for monorepo package structures with automatic package detection
+- **Smart Package Detection**: Automatically detects package versions in both `package.json` dependencies and `node_modules`
+- **Comprehensive Reporting**: Generates detailed reports for manual review items that require developer attention
+
+### 🎯 Button Component Transform
+
+- **ActionButton Migration**: Automatically converts deprecated `ActionButton` components to modern `Button` with `v2` prop
+- **Legacy Prop Migration**: Transforms legacy props (`priority`, `size`, `type`, `htmlType`, `sentiment`) to new API
+- **Enum Value Conversion**: Converts enum values (e.g., `Priority.PRIMARY`, `Size.LARGE`) to string literals
+- **Icon Integration**: Intelligently processes icon children and converts them to `addonStart`/`addonEnd` props
+- **Link Button Handling**: Properly migrates `as="a"` usage with automatic `href` management
+- **Smart Size Mapping**: Maps legacy size values to new design tokens (`xs`, `sm`, `md`, `lg`, `xl`)
+
+### 🛡️ Robust Validation & Safety
+
+- **Package Version Validation**: Ensures transforms only run when target packages are present and meet version requirements
+- **TypeScript & JSX Support**: Full support for TypeScript and JSX syntax parsing
+- **Expression Analysis**: Handles complex expressions, conditionals, and dynamic values with appropriate fallbacks
+- **Gitignore Integration**: Respects `.gitignore` patterns to avoid processing unnecessary files
+- **Caching System**: Intelligent caching for package version checks to improve performance
+
+### 📊 Advanced Reporting
+
+- **Manual Review Detection**: Identifies code patterns that require human attention
+- **Line-by-Line Reporting**: Precise location reporting for manual review items
+- **Issue Classification**: Categorizes issues by type (deprecated props, unsupported values, ambiguous expressions)
+- **Batch Processing**: Handles multiple files and provides comprehensive summary reports
+
+## 🚀 Usage Examples
+
+### Basic Usage
+
+```bash
+npx @wise/wds-codemods
+```
+
+### Advanced Usage
+
+```bash
+# Run specific transform on a directory
+npx @wise/wds-codemods button ./src --dry
+
+# Target monorepo packages
+npx @wise/wds-codemods button ./packages --monorepo
+
+# Custom ignore patterns
+npx @wise/wds-codemods button ./src --ignore-pattern "**/*.test.tsx,**/stories/**"
+```
+
+## 📋 Supported Transforms
+
+### Button Transform (`button`)
+
+Migrates Button and ActionButton components from `@transferwise/components` v46.5.0+
+
+**Transformations include:**
+
+- ✅ `ActionButton` → `Button` with `v2` prop
+- ✅ Legacy prop migrations (`priority`, `size`, `type`, etc.)
+- ✅ Enum value conversions
+- ✅ Icon children processing
+- ✅ Link button handling (`as="a"` → proper href management)
+- ✅ Sentiment mapping (`type="negative"` → `sentiment="negative"`)
+
+## 🏗️ Architecture Highlights
+
+### Modular Design
+
+- **Transform System**: Extensible architecture for adding new component transforms
+- **Helper Utilities**: Reusable utilities for JSX manipulation, reporting, and validation
+- **Package Detection**: Multi-strategy package version detection (dependencies + node_modules)
+- **Test Infrastructure**: Comprehensive testing utilities for transform development
+
+### Developer Experience
+
+- **Type Safety**: Full TypeScript support with proper type definitions
+- **Error Handling**: Graceful error handling with helpful error messages
+- **Debug Support**: Extensive debug logging for troubleshooting
+- **Extensible**: Easy to add new transforms and extend existing functionality
+
+## 🧪 Quality Assurance
+
+This release includes:
+
+- ✅ **100% Test Coverage** for core utilities and transforms
+- ✅ **End-to-End Testing** with real-world code examples
+- ✅ **Edge Case Handling** for complex expressions and unusual patterns
+- ✅ **Performance Optimization** with intelligent caching and batching
+- ✅ **Memory Management** for large codebases
+
+## 🔮 What's Next?
+
+This foundation enables:
+
+- 🎯 Additional component transforms (Forms, Navigation, etc.)
+- 🚀 Enhanced reporting and analytics
+- 🔧 IDE integrations and tooling
+- 📱 Support for additional package managers
+- 🌍 Community contributions and extensibility
+
+## 🙏 Getting Started
+
+1. Install the package: `npm install -D @wise/wds-codemods`
+2. Run your first transform: `npx @wise/wds-codemods`
+3. Review the generated `codemod-report.txt` for any manual review items
+4. Commit your changes and enjoy your modernized codebase!
+
+---
+
+**Breaking Changes**: This is the initial release, so no breaking changes from previous versions.
+
+**Migration Guide**: See our documentation for detailed migration examples and best practices.
+
+Ready to modernize your Wise Design System components? Let's go! 🚀

package/.github/CODEOWNERS

@@ -0,0 +1 @@
+*              @transferwise/design-system-web

package/.github/actions/bootstrap/action.yml

@@ -0,0 +1,49 @@
+name: 'Bootstrap'
+description: 'Set up Node.js and install dependencies'
+
+inputs:
+  github-token:
+    description: 'GitHub token for authentication'
+    required: true
+  npm-token-automation:
+    description: 'NPM token for authentication'
+    required: false
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version-file: '.nvmrc'
+        registry-url: 'https://registry.npmjs.org'
+
+    - name: Setup pnpm
+      uses: pnpm/action-setup@v4
+
+    - name: Configure npm registry
+      shell: bash
+      run: |
+        echo "registry=https://registry.npmjs.org/" > .npmrc
+        echo "//registry.npmjs.org/:_authToken=${{ inputs.npm-token-automation }}" >> .npmrc
+      env:
+        NODE_AUTH_TOKEN: ${{ inputs.npm-token-automation }}
+
+    - name: Get pnpm store directory
+      shell: bash
+      run: |
+        echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+    - name: Setup pnpm cache
+      uses: actions/cache@v4
+      with:
+        path: ${{ env.STORE_PATH }}
+        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+        restore-keys: |
+          ${{ runner.os }}-pnpm-store-
+
+    - name: Install dependencies
+      shell: bash
+      run: pnpm install --frozen-lockfile
+      env:
+        NODE_AUTH_TOKEN: ${{ inputs.npm-token-automation }}

package/.github/actions/commitlint/action.yml

@@ -0,0 +1,27 @@
+name: Commitlint
+description: 'Lint all commit messages for the project'
+
+inputs:
+  github-token:
+    required: true
+    description: 'secrets.GITHUB_TOKEN'
+
+runs:
+  using: composite
+  steps:
+    - name: 🔐 Mark repo directory as safe for git # https://github.blog/2022-04-12-git-security-vulnerability-announced/
+      run: git config --global --add safe.directory $GITHUB_WORKSPACE
+      shell: bash
+
+    - name: 🛠️ Bootstrap dependencies
+      uses: ./.github/actions/bootstrap
+      with:
+        github-token: ${{ inputs.github-token }}
+
+    - name: Fetch full commit history
+      run: git fetch --unshallow
+      shell: bash
+
+    - name: Run Commitlint
+      run: npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose
+      shell: bash

package/.github/actions/test/action.yml

@@ -0,0 +1,23 @@
+name: Test
+description: 'Run all tests for the project'
+
+inputs:
+  github-token:
+    required: true
+    description: 'secrets.GITHUB_TOKEN'
+
+runs:
+  using: composite
+  steps:
+    - name: 🔐 Mark repo directory as safe for git # https://github.blog/2022-04-12-git-security-vulnerability-announced/
+      run: git config --global --add safe.directory $GITHUB_WORKSPACE
+      shell: bash
+
+    - name: 🛠️ Bootstrap dependencies
+      uses: ./.github/actions/bootstrap
+      with:
+        github-token: ${{ inputs.github-token }}
+
+    - name: 🧪 Run tests
+      run: pnpm run test
+      shell: bash

package/.github/workflows/cd-cd.yml

@@ -0,0 +1,127 @@
+name: '🚀 CI/CD'
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+env:
+  DO_NOT_TRACK: 1
+
+jobs:
+  pipeline:
+    name: '🚀 Build, Lint & Test'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 🛒 Check out repository
+        uses: actions/checkout@v5
+
+      - name: ⚙️ Bootstrap
+        uses: ./.github/actions/bootstrap
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          npm-token-automation: ${{ secrets.NPM_TOKEN_AUTOMATION }}
+
+      - name: 📝 Lint
+        run: pnpm run lint
+
+      - name: 🧪 Run Tests
+        run: pnpm test
+
+      - name: 🏗️ Build
+        run: pnpm run build
+
+  publish-branch:
+    name: 🚀 Publish experimental packages
+    if: ${{ github.event_name == 'pull_request' && !startsWith(github.head_ref, 'changeset-release/') }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    needs: [pipeline]
+
+    steps:
+      - name: 🛒 Check out repository
+        uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.GH_ACCESS_TOKEN }}
+
+      - name: ⚙️ Bootstrap
+        uses: ./.github/actions/bootstrap
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          npm-token-automation: ${{ secrets.NPM_TOKEN_AUTOMATION }}
+
+      - name: 🏗️ Build
+        run: pnpm run build
+
+      - name: Setup npm token
+        run: echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN_AUTOMATION }}" >> ~/.npmrc
+        shell: bash
+
+      - name: Publish snapshot release on npm
+        run: |
+          # Get current version from package.json
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          EXPERIMENTAL_VERSION="${CURRENT_VERSION}-experimental-${GITHUB_SHA:0:7}"
+
+          # Update package.json version directly
+          npm version $EXPERIMENTAL_VERSION --no-git-tag-version
+
+          # Publish the experimental version
+          npm publish --tag experimental
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_ACCESS_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN_AUTOMATION }}
+
+  publish:
+    name: 🚀 Publish stable packages
+    if: ${{ github.ref == 'refs/heads/main' }}
+    runs-on: ubuntu-latest
+    needs: [pipeline]
+
+    steps:
+      - name: 🛒 Check out repository
+        uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.GH_ACCESS_TOKEN }}
+
+      - name: ⚙️ Bootstrap
+        uses: ./.github/actions/bootstrap
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          npm-token-automation: ${{ secrets.NPM_TOKEN_AUTOMATION }}
+
+      - name: 🏗️ Build
+        run: pnpm run build
+
+      - name: 👩‍💻 Set GitHub credentials
+        run: |
+          mkdir -p ~/.ssh
+          ssh-keyscan github.com >> ~/.ssh/known_hosts
+          git config --global user.name "tw-actions"
+          git config --global user.email circle@circle.tw.ee
+
+      - name: 🔐 Set up commit signing
+        uses: crazy-max/ghaction-import-gpg@v6
+        with:
+          gpg_private_key: ${{ secrets.GPG_SIGN_KEY }}
+          git_config_global: true
+          git_user_signingkey: true
+          git_commit_gpgsign: true
+
+      - name: Create changesets release PR
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: pnpm release
+          commit: 'chore: release'
+          title: 'chore: release new version and update changelog'
+          setupGitUser: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_ACCESS_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN_AUTOMATION }}

package/.github/workflows/renovate.yml

@@ -0,0 +1,16 @@
+name: Renovate
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - pnpm-lock.yaml
+  schedule:
+    - cron: '0 2 * * 1' # Run every Monday at 2AM
+  workflow_dispatch:
+
+jobs:
+  renovate:
+    uses: transferwise/renovate-workflows/.github/workflows/run.yaml@v1
+    secrets: inherit

package/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1

package/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm lint

package/.nvmrc

@@ -0,0 +1 @@
+lts/*

package/.prettierignore

@@ -0,0 +1 @@
+pnpm-lock.yaml

package/.prettierrc.js

@@ -0,0 +1,5 @@
+export default {
+  printWidth: 100,
+  singleQuote: true,
+  trailingComma: 'all',
+};