feat(scripts, eslint, stylelint): DLT-3359 add success-to-positive migration tooling (#1231)

Author: francisrupert

apps/dialtone-documentation/docs/_data/site-nav.json

@@ -247,6 +247,10 @@
                     "text": "Layout & Spacing Tokens",
                     "link": "/guides/migration/layout-and-spacing-tokens/"
                   },
+                  {
+                    "text": "Success to Positive",
+                    "link": "/guides/migration/success-to-positive/"
+                  },
                   {
                     "text": "Flex to DtStack",
                     "link": "/guides/migration/flex-to-stack/"

apps/dialtone-documentation/docs/guides/migration/component-props/index.md

@@ -24,6 +24,15 @@ description: Prop renames, value standardization, event consolidation, slot rena
 | `dt-link` | Prop value | `tone="success"` | `tone="positive"` |
 | `dt-modal` | Prop value | `bannerKind="error"` | `bannerKind="critical"` |
 | `dt-modal` | Prop value | `bannerKind="success"` | `bannerKind="positive"` |
+| `dt-text` | Prop value | `tone="success"` | `tone="positive"` |
+| `dt-text` | Prop value | `tone="success-strong"` | `tone="positive-strong"` |
+| `dt-button` | Prop value | `link-kind="danger"` | `link-kind="critical"` |
+| `dt-button` | Prop value | `link-kind="success"` | `link-kind="positive"` |
+| `dt-box` | Prop value | `surface="success*"` (subtle, strong, opaque, subtle-opaque) | `surface="positive*"` |
+| `dt-box` | Prop value | `bc="success*"` (subtle, strong) | `bc="positive*"` |
+
+> [!INFO] CSS variables and utility classes also rename
+> The success-to-positive rename also covers `var(--dt-color-*-success-*)` design tokens, `d-fc-success*` / `d-bgc-success*` / `d-bc-success*` utility classes, and ships an ESLint rule and Stylelint rule. See the [Success to Positive](../success-to-positive/) migration guide for the CSS / token side and run `dialtone-migration-helper`.
 
 ### Visibility and open state
 
@@ -120,6 +129,61 @@ Prop values across the system map to a shared set of names. `danger` and `error`
 </div>
 </div>
 
+## DtBox `surface` / `bc`, DtText `tone-strong`, and DtButton `link-kind` Value Renames
+
+DtBox, DtText, and DtButton each have severity-value props that the original DLT-3157 release missed. The migration script handles all of them.
+
+**Affected components:** [DtBox](/components/box.html), [DtText](/components/text.html), [DtButton](/components/button.html)
+
+<div class="d-d-grid d-g-200 d-g-cols1 md:d-g-cols2">
+<div>
+
+### Before
+
+```vue
+<dt-box surface="success" />
+<dt-box surface="success-subtle" />
+<dt-box surface="success-strong" />
+<dt-box surface="success-opaque" />
+<dt-box surface="success-subtle-opaque" />
+
+<dt-box bc="success" />
+<dt-box bc="success-subtle" />
+<dt-box bc="success-strong" />
+
+<dt-text tone="success">Saved.</dt-text>
+<dt-text tone="success-strong">Saved.</dt-text>
+
+<dt-button link-kind="danger">Delete</dt-button>
+<dt-button link-kind="success">Confirm</dt-button>
+```
+
+</div>
+<div>
+
+### After
+
+```vue
+<dt-box surface="positive" />
+<dt-box surface="positive-subtle" />
+<dt-box surface="positive-strong" />
+<dt-box surface="positive-opaque" />
+<dt-box surface="positive-subtle-opaque" />
+
+<dt-box bc="positive" />
+<dt-box bc="positive-subtle" />
+<dt-box bc="positive-strong" />
+
+<dt-text tone="positive">Saved.</dt-text>
+<dt-text tone="positive-strong">Saved.</dt-text>
+
+<dt-button link-kind="critical">Delete</dt-button>
+<dt-button link-kind="positive">Confirm</dt-button>
+```
+
+</div>
+</div>
+
 ## `show` → `open` on Overlay Components
 
 On overlay components, `show` is now `open` and `update:show` is now `update:open`. This matches the `v-model:open` convention already used by `dt-popover`, `dt-dropdown`, and `dt-combobox-with-popover`.
@@ -549,6 +613,9 @@ npx dialtone-migrate-props --cwd ./src --yes
 - `type="success"` → `type="positive"` on `dt-badge`
 - `kind` → `tone` prop rename on `dt-link`, with value renames applied in the same pass
 - `banner-kind` / `bannerKind` value renames on `dt-modal` (`error` → `critical`, `success` → `positive`)
+- `tone="success-strong"` → `tone="positive-strong"` on `dt-text` (the bare `tone="success"` is covered by the global `tone` rule above)
+- `link-kind="danger"` → `link-kind="critical"` and `link-kind="success"` → `link-kind="positive"` on `dt-button`
+- `surface="success*"` → `surface="positive*"` and `bc="success*"` → `bc="positive*"` on `dt-box` (covers `subtle`, `strong`, `opaque`, and `subtle-opaque` variants)
 
 **Visibility and open state**
 

apps/dialtone-documentation/docs/guides/migration/index.md

@@ -12,7 +12,7 @@ This guide walks you through every breaking and deprecation change in the upcomi
 
 Work through each applicable guide in order. Guides earlier in the list are prerequisites for later ones (e.g. color stop renames before base-to-semantic).
 
-### CSS & Tokens
+### CSS and Design Tokens
 
 | # | Guide | Breaking? | Tool | Summary |
 | --- | --- | --- | --- | --- |
@@ -21,23 +21,24 @@ Work through each applicable guide in order. Guides earlier in the list are prer
 | 3 | [HSL to OKLCH](./hsl-to-oklch/) | **Yes** | `dialtone-migration-helper` | Color tokens moved from HSL to OKLCH. Per-channel breakout variables removed (~3,200 CSS vars). |
 | 4 | [Base to Semantic Colors](./color-stops/#adopting-semantic-color-tokens) | Deprecation | `dialtone-migration-helper` | Upgrade base color utilities/tokens to theme-aware semantic equivalents. |
 | 5 | [Layout & Spacing Tokens](./layout-and-spacing-tokens/) | **Yes** | `dialtone-migration-helper` | `--dt-size-*` → `--dt-layout-*`, `--dt-space-*` → `--dt-spacing-*`. |
+| 6 | [Success to Positive](./success-to-positive/) | Deprecation | `dialtone-migration-helper` | `success*` design tokens and `d-fc-success*` / `d-bgc-success*` / `d-bc-success*` utility classes deprecated in favor of `positive*`. Includes ESLint and Stylelint rules. |
 
 ### Components
 
 | # | Guide | Breaking? | Tool | Summary |
 | --- | --- | --- | --- | --- |
-| 6 | [Flex to DtStack](./flex-to-stack/) | Deprecation | `dialtone-migrate-flex-to-stack` | Replace `d-d-flex` utilities with the `<dt-stack>` component. |
-| 7 | [Component Sizes to Numeric](./component-sizes/) | Deprecation | ESLint + `dialtone-migrate-tshirt-to-numeric` | `size="sm"` → `:size="200"` across all components. |
-| 8 | [Avatar Updates](./avatar-updates/) | **Yes** | Manual (grep) | `DtAvatar` size prop moves to numeric, `iconSize` removed, group avatar behavior changed. |
-| 9 | [Logical Naming](./logical-naming/) | Deprecation | `dialtone-migration-helper` | Slots, props, events: `left`/`right` → `start`/`end`. |
-| 10 | [Recipes to UI Kits](./recipes-to-ui-kits/) | **Yes** | Migration script | `DtRecipe*` components move to standalone `@dialpad/` UI Kit packages. |
-| 11 | [Component Props & Events](./component-props/) | **Yes** | `dialtone-migrate-props` | Value renames, `show`→`open`, `hide-*` inversion, `title`→`header-text`, event/slot renames, `rootClass` removal. |
+| 7 | [Flex to DtStack](./flex-to-stack/) | Deprecation | `dialtone-migrate-flex-to-stack` | Replace `d-d-flex` utilities with the `<dt-stack>` component. |
+| 8 | [Component Sizes to Numeric](./component-sizes/) | Deprecation | ESLint + `dialtone-migrate-tshirt-to-numeric` | `size="sm"` → `:size="200"` across all components. |
+| 9 | [Avatar Updates](./avatar-updates/) | **Yes** | Manual (grep) | `DtAvatar` size prop moves to numeric, `iconSize` removed, group avatar behavior changed. |
+| 10 | [Logical Naming](./logical-naming/) | Deprecation | `dialtone-migration-helper` | Slots, props, events: `left`/`right` → `start`/`end`. |
+| 11 | [Recipes to UI Kits](./recipes-to-ui-kits/) | **Yes** | Migration script | `DtRecipe*` components move to standalone `@dialpad/` UI Kit packages. |
+| 12 | [Component Props & Events](./component-props/) | **Yes** | `dialtone-migrate-props` | Value renames (including DtBox `surface`/`bc`, DtText `tone-strong`, DtButton `link-kind`), `show`→`open`, `hide-*` inversion, `title`→`header-text`, event/slot renames, `rootClass` removal. |
 
 ### Framework
 
 | # | Guide | Breaking? | Tool | Summary |
 | --- | --- | --- | --- | --- |
-| 12 | [Vue 2 Removal](./vue2-removal/) | **Yes** | — | Vue 2 support dropped. Last Vue 2 version: `9.154.0`. |
+| 13 | [Vue 2 Removal](./vue2-removal/) | **Yes** | — | Vue 2 support dropped. Last Vue 2 version: `9.154.0`. |
 
 ## Quick Start
 
@@ -64,20 +65,24 @@ npx dialtone-migration-helper --cwd ./src
 npx dialtone-migration-helper --cwd ./src
 # Select "size-to-layout"
 
-# 6. Flex to Stack
+# 6. Success to positive (tokens + utility classes)
+npx dialtone-migration-helper --cwd ./src
+# Select "success-to-positive"
+
+# 7. Flex to Stack
 npx dialtone-migrate-flex-to-stack --cwd ./src
 
-# 7. T-shirt sizes to numeric
+# 8. T-shirt sizes to numeric
 npx dialtone-migrate-tshirt-to-numeric --cwd ./src
 
-# 8. Physical to logical naming
+# 9. Physical to logical naming
 npx dialtone-migration-helper --cwd ./src
 # Select "physical-to-logical"
 
-# 9. Component props, events, and slots
+# 10. Component props, events, and slots
 npx dialtone-migrate-props --cwd ./src
 
-# 10. ESLint auto-fix pass
+# 11. ESLint auto-fix pass
 npx eslint --fix "src/**/*.vue"
 ```