@public-ui/kolibri-cli 4.0.0-alpha.1 → 4.0.0-alpha.11

package/README.md

@@ -27,6 +27,14 @@ yarn add -g @public-ui/kolibri-cli
 
 > **Important:** Install exactly the CLI version you want to upgrade to. The migration tool compares your locally installed `@public-ui/components` version with the CLI version to decide which migration tasks must run and in which order.
 
+## Quickstart (Happy Path)
+
+1. Install the CLI version that matches your target `@public-ui/components` release (see above).
+2. Run the migration in your project root: `kolibri migrate .`.
+3. Review the changes: `git status` and `git diff`.
+4. Format updated files: `pnpm format`.
+5. Commit the result and continue development.
+
 ## Usage
 
 The `KoliBri` CLI is intended to be executed in your project root directory. Use the `kolibri` command to start the CLI.
@@ -69,27 +77,94 @@ If errors occur in our packages, we would like to ask you to create an issue und
 
 With the `migrate` command you can migrate your project to the latest version of `KoliBri`.
 
-Actually the following migration tasks from version 1 to version 2 are available:
-
-- Component renaming ✓
-- Component removal (no one yet)
-- Property renaming ✓
-- Property removal ✓
-- Slots renaming (`content`) ✓
-- Slots removal (`footer`, `header`) ✓
-- Logic refactoring (no one yet)
-- Expert-Slot refactoring
-  - Move `innerText` to property ✓
-  - Property type change (remove `_label={false}`) ✓
-  - Set `_label=""` to activate the expert slot ([#5396](https://github.com/public-ui/kolibri/issues/5396)) ✓
-- `.vscode/settings.json` add IntelliSense for HTML ✓
-- `.gitignore` exclude `.kolibri.migrate.json` ✓
-- `.tsconfig` add `@public-ui/components` to `types` array ✓
-- Format modified files (`prettier@^3`) ✓
-- Copy and integrate new assets ✓
-- Handles `_icon-align` with a refactoring tasks ([#5397](https://github.com/public-ui/kolibri/issues/5397)) ⏰
-- Detection of `_iconOnly` in TSX is not stable ([#5404](https://github.com/public-ui/kolibri/issues/5404)) ⏰
-- Handle the remove `@public-ui/core` package ([#???](https://github.com/public-ui/kolibri/issues/????)) ⏰
+> **Hint:** The migration tool currently supports React projects (JSX/TSX), Vue single-file components, and HTML/XHTML template-based projects such as Angular applications or vanilla custom elements. Support for additional project types is planned.
+
+The migration runner registers tasks in the following order and executes only those whose semantic version ranges match your
+project: common tasks (`*`), v1 tasks (`^1`), v2 tasks (`^2` / `>=2.1.7 <3`), v3 tasks (`>=2 <4`), v4 tasks (`^4`) and
+asset-related tasks (`^1`). All tasks are enabled by default. If you need to disable a noisy task or explicitly re-enable a
+previously deactivated one for better migratability, set the corresponding flag in `.kolibri.config.json` under
+`migrate.tasks` to `false` or `true`.
+
+#### Migration tasks and version ranges
+
+- **Common tasks (`*`)**
+  - Add `.kolibri.migrate.json` to `.gitignore`.
+  - Add `save-exact=true` to `.npmrc`.
+  - Configure `html.customData` in `.vscode/settings.json` to point to `@public-ui/components/vscode-custom-data.json`.
+- **Version 1 tasks (`^1`, unless noted)**
+  - `kol-abbr`: rename `_align` → `_tooltip-align`; rename `_title` → `_label`.
+  - `kol-accordion`: rename `_heading` → `_label`; mark removed slot `header`; rename slot `content` to the default slot.
+  - `kol-alert`: rename `_heading` → `_label`.
+  - `kol-badge`: remove `_icon-only`; rename `_icon-only` → `_hide-label`; remove `_hide-label`; rename `_icon` → `_icons`.
+  - `kol-breadcrumb`: rename `_aria-label` → `_label`.
+  - `kol-button`: remove `_aria-current`; remove `_aria-label`; rename `_icon-only` → `_hide-label`; rename `_icon` → `_icons`;
+    refactor `_icon-align` into `_icons` (**`^2`**).
+  - `kol-button-link`: remove `_aria-current`; remove `_aria-label`; rename `_icon-only` → `_hide-label`; rename `_icon` →
+    `_icons`.
+  - `kol-card`: rename `_heading` → `_label`; rename `_headline` → `_label`; mark removed slots `footer` and `header`; rename
+    slot `content` to the default slot.
+  - `kol-details`: rename `_summary` → `_label`.
+  - `kol-icon`: rename `_aria-label` → `_label`; remove `_part`; rename `_icon` → `_icons`.
+  - `kol-input`: rename `_icon` → `_icons`.
+  - `kol-input-checkbox`: rename `_type` → `_variant`; rename `_icon` → `_icons`.
+  - `kol-input-color`: rename `_list` → `_suggestions`; rename `_icon` → `_icons`.
+  - `kol-input-date` / `kol-date`: rename `_list` → `_suggestions`; rename `_icon` → `_icons`.
+  - `kol-input-email`: rename `_list` → `_suggestions`; rename `_icon` → `_icons`; remove `_size`.
+  - `kol-input-file`: rename `_icon` → `_icons`.
+  - `kol-input-number`: rename `_list` → `_suggestions`; rename `_icon` → `_icons`; remove `_type`.
+  - `kol-input-password`: rename `_icon` → `_icons`; remove `_size`.
+  - `kol-input-radio`: rename `_list` → `_options`.
+  - `kol-input-range`: rename `_list` → `_suggestions`; rename `_icon` → `_icons`.
+  - `kol-input-text`: rename `_list` → `_suggestions`; rename `_icon` → `_icons`; remove `_size`.
+  - `kol-link`: remove `_aria-controls`, `_aria-expanded`, `_aria-label`, `_aria-selected`, `_disabled`, `_selector`, `_stealth`,
+    `_use-case`; rename `_aria-current` → `_listen-aria-current`; rename `_icon-only` → `_hide-label`; rename `_icon` → `_icons`;
+    refactor `_icon-align` (**`^2`**).
+  - `kol-link-button`: remove `_aria-controls`, `_aria-expanded`, `_aria-label`, `_aria-selected`, `_disabled`; rename
+    `_aria-current` → `_listen-aria-current`; rename `_icon-only` → `_hide-label`; rename `_icon` → `_icons`.
+  - `kol-link-group`: rename `_aria-label` → `_label`; rename `_heading` → `_label`; remove `_heading`; remove `_ordered`.
+  - `kol-logo`: rename `_abbr` → `_org`.
+  - `kol-modal`: rename `_aria-label` → `_label`.
+  - `kol-nav`: rename `_aria-label` → `_label`; rename `_compact` → `_hide-label`; remove `_variant`.
+  - `kol-pagination`: rename `_count` → `_total`; rename `_total` → `_max`.
+  - `kol-progress`: rename `_type` → `_variant`.
+  - `kol-quote`: rename `_caption` → `_label`.
+  - `kol-select`: rename `_height` → `_rows`; rename `_list` → `_options`; rename `_icon` → `_icons`; remove `_size`.
+  - `kol-skip-nav`: rename `_aria-label` → `_label`.
+  - `kol-span`: rename `_icon-only` → `_hide-label`; rename `_icon` → `_icons`.
+  - `kol-split-button`: remove `_aria-label`, `_access-key`, `_show-dropdown`; remove `_show`.
+  - `kol-symbol`: rename `_aria-label` → `_label`.
+  - `kol-table`: rename `_caption` → `_label`.
+  - `kol-tabs`: rename `_aria-label` → `_label`; rename `_tab-align` → `_align`; rename `_icon` → `_icons`; rename `_icon-only`
+    → `_hide-label`.
+  - `kol-toast`: remove `_show-duration`; rename `_heading` → `_label`.
+  - `kol-version`: rename `_version` → `_label`.
+  - Expert slot migrations: move `innerText` to `_label` for `kol-heading`, `kol-input-*`, `kol-link`, `kol-select`,
+    `kol-textarea` (**`^1`**).
+  - Slot removals: mark removed `kol-accordion` `header`, `kol-card` `footer`/`header` (**`^1`**).
+  - Slot renames: `kol-accordion` / `kol-card` slot `content` → default slot (**`^1`**).
+  - Refactor `_label={false}` to empty string (**`>=1.6 <=1.7`**).
+- **Version 2 tasks**
+  - `kol-card`: remove `_has-footer` (**`^2`**).
+  - `kol-link-group`: remove `_level` (**`^2`**).
+  - `kol-table`: rename tag `kol-table` → `kol-table-stateful` (**`>=2.1.7 <3`**).
+- **Version 3 tasks (`>=2 <4`)**
+  - `kol-abbr`: remove `_tooltip-align`.
+  - `kol-input-file`: remove `_value`.
+  - `kol-modal`: remove `_active-element`.
+  - `kol-textarea`: `_resize="both"` → `_resize="vertical"`; `_resize="horizontal"` → `_resize="none"`.
+  - `kol-toaster`: rename `alertVariant` → `variant`; rename `defaultAlertType` → `defaultVariant`.
+  - All inputs (`kol-combobox`, `kol-input-*`, `kol-select`, `kol-single-select`, `kol-textarea`): remove `_alert`; rename
+    `_hide-error` → `_hide-msg`; refactor `_error` → `_msg`.
+- **Version 4 tasks (`^4`)**
+  - Remove `_id` from `kol-button`, `kol-button-link`, `kol-combobox`, `kol-input-*`, `kol-popover-button`, `kol-select`,
+    `kol-single-select`, `kol-split-button`, `kol-textarea`, `kol-tooltip`.
+  - Remove `_label` and `_variant` keys from `_msg` objects.
+  - `kol-toast`: remove `variant` from `enqueue()` calls.
+  - `kol-toaster`: remove `defaultVariant` option from `getInstance()` calls.
+- **Asset tasks (`^1`)**
+  - Remove old `cpy-cli`/`rimraf` versions and reinstall pinned ones.
+  - Add `scripts.prepare` to copy component assets into the project and remove `public/assets/codicons` before copying.
+  - Inject the Codicon stylesheet link into `index.html` (or warn if the file is missing).
 
 #### Theme Migration
 
@@ -183,53 +258,124 @@ You can configure the migration with the `.kolibri.config.json` file in your pro
 		"tasks": {
 			".gitignore-add-rule-.kolibri.migrate.json": true,
 			".npmrc-add-rule-save-exact=true": true,
-			"vscode-settings-reconfigure-html.customData": true,
+			"add--cpy-cli,rimraf": true,
+			"exec-npx cpy \"node_modules/@public-ui/components/assets/**/*\" \"public/assets\" --dot": true,
+			"kol-abbr-remove-property-_tooltip-align": true,
 			"kol-abbr-rename-property-_align-to-_tooltip-align": true,
 			"kol-abbr-rename-property-_title-to-_label": true,
+			"kol-accordion-mark-removed-slot-header": true,
 			"kol-accordion-rename-property-_heading-to-_label": true,
+			"kol-accordion-rename-slot-content-to-": true,
 			"kol-alert-rename-property-_heading-to-_label": true,
-			"kol-badge-rename-property-_icon-only-to-_hide-label": true,
 			"kol-badge-remove-property-_hide-label": true,
 			"kol-badge-remove-property-_icon-only": true,
+			"kol-badge-rename-property-_icon-only-to-_hide-label": true,
 			"kol-badge-rename-property-_icon-to-_icons": true,
 			"kol-breadcrumb-rename-property-_aria-label-to-_label": true,
+			"kol-button-link-remove-property-_access-key": true,
 			"kol-button-link-remove-property-_aria-current": true,
 			"kol-button-link-remove-property-_aria-label": true,
+			"kol-button-link-remove-property-_id": true,
+			"kol-button-link-rename-property-_aria-current-to-_listen-aria-current": true,
 			"kol-button-link-rename-property-_icon-only-to-_hide-label": true,
 			"kol-button-link-rename-property-_icon-to-_icons": true,
+			"kol-button-remove-property-_access-key": true,
 			"kol-button-remove-property-_aria-current": true,
 			"kol-button-remove-property-_aria-label": true,
 			"kol-button-remove-property-_icon-align": true,
+			"kol-button-remove-property-_id": true,
 			"kol-button-rename-property-_icon-only-to-_hide-label": true,
+			"refactor-property-icon-align": true,
 			"kol-button-rename-property-_icon-to-_icons": true,
+			"kol-card-mark-removed-slot-footer": true,
+			"kol-card-mark-removed-slot-header": true,
+			"kol-card-remove-property-_has-footer": true,
 			"kol-card-rename-property-_heading-to-_label": true,
 			"kol-card-rename-property-_headline-to-_label": true,
+			"kol-card-rename-slot-content-to-": true,
+			"kol-checkbox-rename-property-_type-to-_variant": true,
+			"kol-color-rename-property-_icon-to-_icons": true,
+			"kol-color-rename-property-_list-to-_suggestions": true,
+			"kol-combobox-refactor-property-error-to-msg": true,
+			"kol-combobox-remove-property-_alert": true,
+			"kol-combobox-remove-property-_id": true,
+			"kol-combobox-rename-property-_hide-error-to-_hide-msg": true,
+			"kol-date-rename-property-_list-to-_suggestions": true,
 			"kol-details-rename-property-_summary-to-_label": true,
+			"kol-heading-move-innerText-to-property-_label": true,
 			"kol-icon-remove-property-_part": true,
 			"kol-icon-rename-property-_aria-label-to-_label": true,
 			"kol-icon-rename-property-_icon-to-_icons": true,
+			"kol-input-checkbox-move-innerText-to-property-_label": true,
+			"kol-input-checkbox-refactor-property-error-to-msg": true,
+			"kol-input-checkbox-remove-property-_alert": true,
+			"kol-input-checkbox-remove-property-_id": true,
+			"kol-input-checkbox-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-checkbox-rename-property-_icon-to-_icons": true,
-			"kol-checkbox-rename-property-_type-to-_variant": true,
-			"kol-color-rename-property-_icon-to-_icons": true,
-			"kol-color-rename-property-_list-to-_suggestions": true,
+			"kol-input-checkbox-rename-property-_type-to-_variant": true,
+			"kol-input-color-move-innerText-to-property-_label": true,
+			"kol-input-color-refactor-property-error-to-msg": true,
+			"kol-input-color-remove-property-_alert": true,
+			"kol-input-color-remove-property-_id": true,
+			"kol-input-color-rename-property-_hide-error-to-_hide-msg": true,
+			"kol-input-date-move-innerText-to-property-_label": true,
+			"kol-input-date-refactor-property-error-to-msg": true,
+			"kol-input-date-remove-property-_alert": true,
+			"kol-input-date-remove-property-_id": true,
+			"kol-input-date-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-date-rename-property-_icon-to-_icons": true,
-			"kol-date-rename-property-_list-to-_suggestions": true,
+			"kol-input-email-move-innerText-to-property-_label": true,
+			"kol-input-email-refactor-property-error-to-msg": true,
+			"kol-input-email-remove-property-_alert": true,
+			"kol-input-email-remove-property-_id": true,
+			"kol-input-email-remove-property-_size": true,
+			"kol-input-email-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-email-rename-property-_icon-to-_icons": true,
 			"kol-input-email-rename-property-_list-to-_suggestions": true,
-			"kol-input-email-remove-property-_size": true,
+			"kol-input-file-move-innerText-to-property-_label": true,
+			"kol-input-file-refactor-property-error-to-msg": true,
+			"kol-input-file-remove-property-_alert": true,
+			"kol-input-file-remove-property-_id": true,
+			"kol-input-file-remove-property-_value": true,
+			"kol-input-file-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-file-rename-property-_icon-to-_icons": true,
+			"kol-input-number-move-innerText-to-property-_label": true,
+			"kol-input-number-refactor-property-error-to-msg": true,
+			"kol-input-number-remove-property-_alert": true,
+			"kol-input-number-remove-property-_id": true,
+			"kol-input-number-remove-property-_type": true,
+			"kol-input-number-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-number-rename-property-_icon-to-_icons": true,
 			"kol-input-number-rename-property-_list-to-_suggestions": true,
-			"kol-input-number-remove-property-_type": true,
-			"kol-input-password-rename-property-_icon-to-_icons": true,
+			"kol-input-password-move-innerText-to-property-_label": true,
+			"kol-input-password-refactor-property-error-to-msg": true,
+			"kol-input-password-remove-property-_alert": true,
+			"kol-input-password-remove-property-_id": true,
 			"kol-input-password-remove-property-_size": true,
+			"kol-input-password-rename-property-_hide-error-to-_hide-msg": true,
+			"kol-input-password-rename-property-_icon-to-_icons": true,
+			"kol-input-radio-move-innerText-to-property-_label": true,
+			"kol-input-radio-refactor-property-error-to-msg": true,
+			"kol-input-radio-remove-property-_alert": true,
+			"kol-input-radio-remove-property-_id": true,
+			"kol-input-radio-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-radio-rename-property-_list-to-_options": true,
+			"kol-input-range-move-innerText-to-property-_label": true,
+			"kol-input-range-refactor-property-error-to-msg": true,
+			"kol-input-range-remove-property-_alert": true,
+			"kol-input-range-remove-property-_id": true,
+			"kol-input-range-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-range-rename-property-_icon-to-_icons": true,
 			"kol-input-range-rename-property-_list-to-_suggestions": true,
 			"kol-input-rename-property-_icon-to-_icons": true,
+			"kol-input-text-move-innerText-to-property-_label": true,
+			"kol-input-text-refactor-property-error-to-msg": true,
+			"kol-input-text-remove-property-_alert": true,
+			"kol-input-text-remove-property-_id": true,
+			"kol-input-text-remove-property-_size": true,
+			"kol-input-text-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-input-text-rename-property-_icon-to-_icons": true,
 			"kol-input-text-rename-property-_list-to-_suggestions": true,
-			"kol-input-text-remove-property-_size": true,
 			"kol-link-button-remove-property-_aria-controls": true,
 			"kol-link-button-remove-property-_aria-expanded": true,
 			"kol-link-button-remove-property-_aria-label": true,
@@ -238,16 +384,17 @@ You can configure the migration with the `.kolibri.config.json` file in your pro
 			"kol-link-button-rename-property-_aria-current-to-_listen-aria-current": true,
 			"kol-link-button-rename-property-_icon-only-to-_hide-label": true,
 			"kol-link-button-rename-property-_icon-to-_icons": true,
-			"kol-link-group-rename-property-_heading-to-_label": true,
 			"kol-link-group-remove-property-_heading": true,
+			"kol-link-group-remove-property-_level": true,
 			"kol-link-group-remove-property-_ordered": true,
 			"kol-link-group-rename-property-_aria-label-to-_label": true,
+			"kol-link-group-rename-property-_heading-to-_label": true,
+			"kol-link-move-innerText-to-property-_label": true,
 			"kol-link-remove-property-_aria-controls": true,
 			"kol-link-remove-property-_aria-expanded": true,
 			"kol-link-remove-property-_aria-label": true,
 			"kol-link-remove-property-_aria-selected": true,
 			"kol-link-remove-property-_disabled": true,
-			"kol-link-remove-property-_icon-align": true,
 			"kol-link-remove-property-_selector": true,
 			"kol-link-remove-property-_stealth": true,
 			"kol-link-remove-property-_use-case": true,
@@ -255,69 +402,74 @@ You can configure the migration with the `.kolibri.config.json` file in your pro
 			"kol-link-rename-property-_icon-only-to-_hide-label": true,
 			"kol-link-rename-property-_icon-to-_icons": true,
 			"kol-logo-rename-property-_abbr-to-_org": true,
+			"kol-modal-remove-property-_active-element": true,
 			"kol-modal-rename-property-_aria-label-to-_label": true,
+			"kol-nav-remove-property-_has-compact-button": true,
 			"kol-nav-remove-property-_variant": true,
 			"kol-nav-rename-property-_aria-label-to-_label": true,
 			"kol-nav-rename-property-_compact-to-_hide-label": true,
 			"kol-pagination-rename-property-_count-to-_total": true,
 			"kol-pagination-rename-property-_total-to-_max": true,
+			"kol-popover-button-remove-property-_id": true,
 			"kol-progress-rename-property-_type-to-_variant": true,
 			"kol-quote-rename-property-_caption-to-_label": true,
+			"kol-select-move-innerText-to-property-_label": true,
+			"kol-select-refactor-property-error-to-msg": true,
+			"kol-select-remove-property-_alert": true,
+			"kol-select-remove-property-_id": true,
+			"kol-select-remove-property-_size": true,
 			"kol-select-rename-property-_height-to-_rows": true,
+			"kol-select-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-select-rename-property-_icon-to-_icons": true,
 			"kol-select-rename-property-_list-to-_options": true,
-			"kol-select-remove-property-_size": true,
+			"kol-single-select-refactor-property-error-to-msg": true,
+			"kol-single-select-remove-property-_alert": true,
+			"kol-single-select-remove-property-_id": true,
+			"kol-single-select-rename-property-_hide-error-to-_hide-msg": true,
 			"kol-skip-nav-rename-property-_aria-label-to-_label": true,
 			"kol-span-rename-property-_icon-only-to-_hide-label": true,
 			"kol-span-rename-property-_icon-to-_icons": true,
-			"kol-split-button-remove-property-_aria-label": true,
 			"kol-split-button-remove-property-_access-key": true,
-			"kol-split-button-remove-property-_show-dropdown": true,
+			"kol-split-button-remove-property-_aria-label": true,
+			"kol-split-button-remove-property-_id": true,
 			"kol-split-button-remove-property-_show": true,
+			"kol-split-button-remove-property-_show-dropdown": true,
 			"kol-symbol-rename-property-_aria-label-to-_label": true,
 			"kol-table-rename-property-_caption-to-_label": true,
 			"kol-tabs-rename-property-_aria-label-to-_label": true,
+			"kol-tabs-rename-property-_icon-only-to-_hide-label": true,
 			"kol-tabs-rename-property-_icon-to-_icons": true,
 			"kol-tabs-rename-property-_tab-align-to-_align": true,
-			"kol-tabs-rename-property-_icon-only-to-_hide-label": true,
+			"kol-textarea-move-innerText-to-property-_label": true,
+			"kol-textarea-refactor-property-error-to-msg": true,
+			"kol-textarea-remove-property-_alert": true,
+			"kol-textarea-remove-property-_id": true,
+			"kol-textarea-rename-property-_hide-error-to-_hide-msg": true,
+			"kol-textarea-update-property-_resize-value-both-to-vertical": true,
+			"kol-textarea-update-property-_resize-value-horizontal-to-none": true,
 			"kol-toast-remove-property-_show-duration": true,
 			"kol-toast-rename-property-_heading-to-_label": true,
+			"kol-tooltip-remove-property-_id": true,
 			"kol-version-rename-property-_version-to-_label": true,
-			"kol-heading-move-innerText-to-property-_label": true,
-			"kol-input-checkbox-move-innerText-to-property-_label": true,
-			"kol-input-color-move-innerText-to-property-_label": true,
-			"kol-input-date-move-innerText-to-property-_label": true,
-			"kol-input-email-move-innerText-to-property-_label": true,
-			"kol-input-file-move-innerText-to-property-_label": true,
-			"kol-input-number-move-innerText-to-property-_label": true,
-			"kol-input-password-move-innerText-to-property-_label": true,
-			"kol-input-radio-move-innerText-to-property-_label": true,
-			"kol-input-range-move-innerText-to-property-_label": true,
-			"kol-input-text-move-innerText-to-property-_label": true,
-			"kol-link-move-innerText-to-property-_label": true,
-			"kol-select-move-innerText-to-property-_label": true,
-			"kol-textarea-move-innerText-to-property-_label": true,
-			"kol-accordion-mark-removed-slot-header": true,
-			"kol-card-mark-removed-slot-footer": true,
-			"kol-card-mark-removed-slot-header": true,
-			"kol-accordion-rename-slot-content-to-": true,
-			"kol-card-rename-slot-content-to-": true,
+			"merge-html-codicon-in-index.html": true,
+			"package.json-reconfigure-scripts.prepare": true,
+			"refactor-property-icon-align": true,
 			"refactor-property-label-replace-false": true,
-			"kol-card-remove-property-_has-footer": true,
-			"kol-link-group-remove-property-_level": true,
 			"remove--cpy-cli,rimraf": true,
-			"add--cpy-cli,rimraf": true,
-			"package.json-reconfigure-scripts.prepare": true,
+			"remove-msg-props": true,
 			"remove-public/assets/codicons": true,
-			"exec-npx cpy \"node_modules/@public-ui/components/assets/**/*\" \"undefined/assets\" --dot": true,
-			"kol-button-link-remove-property-_access-key": true,
-			"kol-button-remove-property-_access-key": true,
-			"kol-nav-remove-property-_has-compact-button": true
+			"remove-toast-variant-^4": true,
+			"remove-toaster-get-instance-options-^4": true,
+			"rename-tag-name-kol-table-to-kol-table-stateful": true,
+			"toaster-rename-properties": true,
+			"vscode-settings-reconfigure-html.customData": true
 		}
 	}
 }
 ```
 
+> The `exec-npx cpy` task copies the packaged component assets into your project's `public/assets` folder; leave it enabled unless your build already handles asset copying in a different location.
+
 ## Troubleshooting
 
 If the migration failed, you can reset the migration with `git reset --hard HEAD~1`.

package/dist/info/index.js

@@ -4,10 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
-const os_1 = __importDefault(require("os"));
 const child_process_1 = require("child_process");
-const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
 // Function to get the binary version
 const getBinaryVersion = (command) => {
     try {

package/dist/migrate/index.js

@@ -15,10 +15,10 @@ const task_runner_1 = require("./runner/task-runner");
 const tasks_1 = require("./runner/tasks");
 const test_1 = require("./runner/tasks/test");
 const v1_1 = require("./runner/tasks/v1");
+const assets_1 = require("./runner/tasks/v1/assets");
 const v2_1 = require("./runner/tasks/v2");
 const v3_1 = require("./runner/tasks/v3");
 const v4_1 = require("./runner/tasks/v4");
-const assets_1 = require("./runner/tasks/v1/assets");
 const reuse_1 = require("./shares/reuse");
 const types_1 = require("./types");
 const currentVersionOfPublicUi = (0, reuse_1.getVersionOfPublicUiComponents)();

package/dist/migrate/runner/tasks/common/GenericUpdatePropertyValueTask.js

@@ -55,14 +55,6 @@ class GenericUpdatePropertyValueTask extends abstract_task_1.AbstractTask {
     }
 }
 exports.GenericUpdatePropertyValueTask = GenericUpdatePropertyValueTask;
-// Helper function to update attribute values in HTML strings
-/**
- *
- * @param htmlString
- * @param tagRegExp
- * @param oldValue
- * @param newValue
- */
 function updateAttributeValue(htmlString, tagRegExp, oldValue, newValue) {
     return htmlString.replace(tagRegExp, (match) => {
         return match.replace(`="${oldValue}"`, `="${newValue}"`).replace(`='${oldValue}'`, `='${newValue}'`);

package/dist/migrate/runner/tasks/common/HandleDependencyTask.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HandleDependencyTask = void 0;
 const child_process_1 = require("child_process");
-const abstract_task_1 = require("../../abstract-task");
 const reuse_1 = require("../../../shares/reuse");
+const abstract_task_1 = require("../../abstract-task");
 class HandleDependencyTask extends abstract_task_1.AbstractTask {
     command;
     dependencies;

package/dist/migrate/runner/tasks/v1/button.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ButtonRenamePropertyIconToIcons = exports.ButtonRenamePropertyIconOnlyToHideLabel = exports.ButtonRefactorPropertyIconAlign = exports.ButtonRemovePropertyAriaLabel = exports.ButtonRemovePropertyAriaCurrent = void 0;
+const RefactorPropertyIconAlign_1 = require("../common/RefactorPropertyIconAlign");
 const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
 const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
-const RefactorPropertyIconAlign_1 = require("../common/RefactorPropertyIconAlign");
 exports.ButtonRemovePropertyAriaCurrent = RemovePropertyNameTask_1.RemovePropertyNameTask.getInstance('kol-button', '_aria-current', '^1');
 exports.ButtonRemovePropertyAriaLabel = RemovePropertyNameTask_1.RemovePropertyNameTask.getInstance('kol-button', '_aria-label', '^1');
 exports.ButtonRefactorPropertyIconAlign = RefactorPropertyIconAlign_1.RefactorPropertyIconAlign.getInstance('kol-button');

package/dist/migrate/runner/tasks/v1/index.js

@@ -7,6 +7,7 @@ const RefactorPropertyLabelReplaceFalse_1 = require("../common/RefactorPropertyL
 const RenameSlotNameTask_1 = require("../common/RenameSlotNameTask");
 const abbr_1 = require("./abbr");
 const accordion_1 = require("./accordion");
+const alert_1 = require("./alert");
 const badge_1 = require("./badge");
 const breadcrumb_1 = require("./breadcrumb");
 const button_1 = require("./button");
@@ -38,12 +39,11 @@ const select_1 = require("./select");
 const skip_nav_1 = require("./skip-nav");
 const span_1 = require("./span");
 const split_button_1 = require("./split-button");
+const symbol_1 = require("./symbol");
 const table_1 = require("./table");
 const tabs_1 = require("./tabs");
 const toast_1 = require("./toast");
 const version_1 = require("./version");
-const alert_1 = require("./alert");
-const symbol_1 = require("./symbol");
 exports.v1Tasks = [];
 exports.v1Tasks.push(abbr_1.AbbrRenamePropertyAlignToTooltipAlign);
 exports.v1Tasks.push(abbr_1.AbbrRenamePropertyTitleToLabel);

package/dist/migrate/runner/tasks/v1/input-email.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InputEmailRemovePropertySize = exports.InputEmailRenamePropertyIconToIcons = exports.InputEmailRenamePropertyListToSuggestions = void 0;
-const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
+const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 exports.InputEmailRenamePropertyListToSuggestions = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-input-email', '_list', '_suggestions', '^1');
 exports.InputEmailRenamePropertyIconToIcons = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-input-email', '_icon', '_icons', '^1');
 exports.InputEmailRemovePropertySize = RemovePropertyNameTask_1.RemovePropertyNameTask.getInstance('kol-input-email', '_size', '^1');

package/dist/migrate/runner/tasks/v1/input-number.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InputNumberRemovePropertyType = exports.InputNumberRenamePropertyIconToIcons = exports.InputNumberRenamePropertyListToSuggestions = void 0;
-const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
+const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 exports.InputNumberRenamePropertyListToSuggestions = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-input-number', '_list', '_suggestions', '^1');
 // @todo export const InputNumberRemovePropertyType = RemovePropertyNameTask.getInstance('kol-input-number', '_type', '^1');
 exports.InputNumberRenamePropertyIconToIcons = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-input-number', '_icon', '_icons', '^1');

package/dist/migrate/runner/tasks/v1/input-password.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InputPasswordRemovePropertySize = exports.InputPasswordRenamePropertyIconToIcons = void 0;
-const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
+const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 exports.InputPasswordRenamePropertyIconToIcons = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-input-password', '_icon', '_icons', '^1');
 exports.InputPasswordRemovePropertySize = RemovePropertyNameTask_1.RemovePropertyNameTask.getInstance('kol-input-password', '_size', '^1');

package/dist/migrate/runner/tasks/v1/input-text.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InputTextRemovePropertySize = exports.InputTextRenamePropertyIconToIcons = exports.InputTextRenamePropertyListToSuggestions = void 0;
-const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
+const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 exports.InputTextRenamePropertyListToSuggestions = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-input-text', '_list', '_suggestions', '^1');
 exports.InputTextRenamePropertyIconToIcons = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-input-text', '_icon', '_icons', '^1');
 exports.InputTextRemovePropertySize = RemovePropertyNameTask_1.RemovePropertyNameTask.getInstance('kol-input-text', '_size', '^1');

package/dist/migrate/runner/tasks/v1/link.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LinkRemovePropertyUseCase = exports.LinkRemovePropertyStealth = exports.LinkRemovePropertySelector = exports.LinkRenamePropertyIconOnlyToHideLabel = exports.LinkRefactorPropertyIconAlign = exports.LinkRenamePropertyIconToIcons = exports.LinkRemovePropertyDisabled = exports.LinkRemovePropertyAriaSelected = exports.LinkRemovePropertyAriaLabel = exports.LinkRemovePropertyAriaExpanded = exports.LinkRenamePropertyAriaCurrentToListenAriaCurrent = exports.LinkRemovePropertyAriaControls = void 0;
+const RefactorPropertyIconAlign_1 = require("../common/RefactorPropertyIconAlign");
 const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
 const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
-const RefactorPropertyIconAlign_1 = require("../common/RefactorPropertyIconAlign");
 exports.LinkRemovePropertyAriaControls = RemovePropertyNameTask_1.RemovePropertyNameTask.getInstance('kol-link', '_aria-controls', '^1');
 exports.LinkRenamePropertyAriaCurrentToListenAriaCurrent = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-link', '_aria-current', '_listen-aria-current', '^1');
 exports.LinkRemovePropertyAriaExpanded = RemovePropertyNameTask_1.RemovePropertyNameTask.getInstance('kol-link', '_aria-expanded', '^1');

package/dist/migrate/runner/tasks/v1/select.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SelectRemovePropertySize = exports.SelectRenamePropertyIconToIcons = exports.SelectRenamePropertyListToOptions = exports.SelectRenamePropertyHeightToRows = void 0;
-const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
+const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 exports.SelectRenamePropertyHeightToRows = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-select', '_height', '_rows', '^1');
 exports.SelectRenamePropertyListToOptions = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-select', '_list', '_options', '^1');
 exports.SelectRenamePropertyIconToIcons = RenamePropertyNameTask_1.RenamePropertyNameTask.getInstance('kol-select', '_icon', '_icons', '^1');

package/dist/migrate/runner/tasks/v3/all-input.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AllInputTasks = void 0;
-const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
 const RefactorPropertyErrorToMsg_1 = require("../common/RefactorPropertyErrorToMsg");
+const RemovePropertyNameTask_1 = require("../common/RemovePropertyNameTask");
 const RenamePropertyNameTask_1 = require("../common/RenamePropertyNameTask");
 const INPUT_COMPONENTS = [
     'kol-combobox',

package/dist/migrate/runner/tasks/v3/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.v3Tasks = void 0;
-const textarea_1 = require("./textarea");
 const abbr_1 = require("./abbr");
-const modal_1 = require("./modal");
-const input_file_1 = require("./input-file");
 const all_input_1 = require("./all-input");
+const input_file_1 = require("./input-file");
+const modal_1 = require("./modal");
+const textarea_1 = require("./textarea");
 const toaster_1 = require("./toaster");
 exports.v3Tasks = [];
 exports.v3Tasks.push(textarea_1.TextareaUpdatePropertyValue_Resize_Both);

package/dist/migrate/runner/tasks/v3/toaster.js

@@ -6,9 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToasterRenameProperties = void 0;
 const fs_1 = __importDefault(require("fs"));
 const types_1 = require("../../../../types");
-const fileExtensions = [...types_1.FILE_EXTENSIONS];
 const reuse_1 = require("../../../shares/reuse");
 const abstract_task_1 = require("../../abstract-task");
+const fileExtensions = [...types_1.FILE_EXTENSIONS];
 class ToasterRenamePropertiesTask extends abstract_task_1.AbstractTask {
     constructor() {
         super('toaster-rename-properties', 'Rename Toaster properties `alertVariant` to `variant` and `defaultAlertType` to `defaultVariant`', fileExtensions, '>=2 <4');

package/dist/migrate/runner/tasks/v4/clear-button.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenameClearButtonPropTasks = exports.RenameClearButtonPropTask = void 0;
+const fs_1 = __importDefault(require("fs"));
+const types_1 = require("../../../../types");
+const reuse_1 = require("../../../shares/reuse");
+const abstract_task_1 = require("../../abstract-task");
+class RenameClearButtonPropTask extends abstract_task_1.AbstractTask {
+    constructor(identifier, versionRange) {
+        super(identifier, 'Rename _hide-clear-button to _has-clear-button', types_1.MARKUP_EXTENSIONS, versionRange);
+    }
+    static getInstance(versionRange) {
+        const identifier = 'rename-clear-button-prop';
+        if (!this.instances.has(identifier)) {
+            this.instances.set(identifier, new RenameClearButtonPropTask(identifier, versionRange));
+        }
+        return this.instances.get(identifier);
+    }
+    run(baseDir) {
+        (0, reuse_1.filterFilesByExt)(baseDir, types_1.MARKUP_EXTENSIONS).forEach((file) => {
+            const content = fs_1.default.readFileSync(file, 'utf8');
+            const newContent = content
+                .replace(/_hide-clear-button\s*=\s*"(true|false)"/g, (_match, value) => {
+                return `_has-clear-button="${value === 'true' ? 'false' : 'true'}"`;
+            })
+                .replace(/_hide-clear-button\s*=\s*'(true|false)'/g, (_match, value) => {
+                return `_has-clear-button='${value === 'true' ? 'false' : 'true'}'`;
+            })
+                .replace(/_hide-clear-button\s*=\s*\{\s*(true|false)\s*\}/g, (_match, value) => {
+                return `_has-clear-button={${value === 'true' ? 'false' : 'true'}}`;
+            })
+                .replace(/_hideClearButton\s*=\s*"(true|false)"/g, (_match, value) => {
+                return `_hasClearButton="${value === 'true' ? 'false' : 'true'}"`;
+            })
+                .replace(/_hideClearButton\s*=\s*'(true|false)'/g, (_match, value) => {
+                return `_hasClearButton='${value === 'true' ? 'false' : 'true'}'`;
+            })
+                .replace(/_hideClearButton\s*=\s*\{\s*(true|false)\s*\}/g, (_match, value) => {
+                return `_hasClearButton={${value === 'true' ? 'false' : 'true'}}`;
+            })
+                .replace(/_hide-clear-button(?=[\s/>])/g, '_has-clear-button="false"')
+                .replace(/_hideClearButton(?=[\s/>])/g, '_hasClearButton={false}');
+            if (content !== newContent) {
+                fs_1.default.writeFileSync(file, newContent);
+                reuse_1.MODIFIED_FILES.add(file);
+            }
+        });
+    }
+}
+exports.RenameClearButtonPropTask = RenameClearButtonPropTask;
+exports.RenameClearButtonPropTasks = [RenameClearButtonPropTask.getInstance('^4')];

package/dist/migrate/runner/tasks/v4/index.js

@@ -1,12 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.v4Tasks = void 0;
+const clear_button_1 = require("./clear-button");
 const id_1 = require("./id");
+const link_1 = require("./link");
+const loader_1 = require("./loader");
 const msg_1 = require("./msg");
 const toast_1 = require("./toast");
 const toaster_1 = require("./toaster");
 exports.v4Tasks = [];
+exports.v4Tasks.push(...link_1.MapVariantStandaloneToInlineTasks);
 exports.v4Tasks.push(...id_1.RemoveIdPropTasks);
 exports.v4Tasks.push(...msg_1.RemoveMsgPropsTasks);
+exports.v4Tasks.push(...clear_button_1.RenameClearButtonPropTasks);
 exports.v4Tasks.push(toast_1.RemoveToastVariantTask.getInstance('^4'));
 exports.v4Tasks.push(toaster_1.RemoveToasterGetInstanceOptionsTask.getInstance('^4'));
+exports.v4Tasks.push(loader_1.UpdateLoaderImportPathTask.getInstance('^4'));

package/dist/migrate/runner/tasks/v4/link.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapVariantStandaloneToInlineTasks = exports.MapLinkVariantStandaloneToInlineTask = exports.MapButtonLinkVariantStandaloneToInlineTask = void 0;
+const fs_1 = __importDefault(require("fs"));
+const types_1 = require("../../../../types");
+const reuse_1 = require("../../../shares/reuse");
+const abstract_task_1 = require("../../abstract-task");
+class MapVariantStandaloneToInlineTask extends abstract_task_1.AbstractTask {
+    tag;
+    tagCapitalCase;
+    variantStandaloneRegExp = /\s_variant\s*=\s*(\{["'`]standalone["'`]\}|["'`]standalone["'`])/;
+    constructor(identifier, tag, versionRange, dependentTasks, options) {
+        super(identifier, `Map "_variant=standalone" to "_inline" for "${tag}"`, types_1.MARKUP_EXTENSIONS, versionRange, dependentTasks, options);
+        this.tag = tag;
+        this.tagCapitalCase = (0, reuse_1.kebabToCapitalCase)(tag);
+    }
+    static getInstance(tag, versionRange, dependentTasks, options) {
+        const identifier = `${tag}-map-variant-standalone-to-inline`;
+        if (!this.instances.has(identifier)) {
+            this.instances.set(identifier, new MapVariantStandaloneToInlineTask(identifier, tag, versionRange, dependentTasks, options));
+        }
+        return this.instances.get(identifier);
+    }
+    run(baseDir) {
+        this.transpileComponentFiles(baseDir);
+        this.transpileCustomElementFiles(baseDir);
+    }
+    transpileComponentFiles(baseDir) {
+        const tagRegExp = new RegExp(`<${this.tagCapitalCase}[^>]*_variant[^>]*>`, 'g');
+        (0, reuse_1.filterFilesByExt)(baseDir, types_1.COMPONENT_FILE_EXTENSIONS).forEach((file) => {
+            const content = fs_1.default.readFileSync(file, 'utf8');
+            const newContent = content.replace(tagRegExp, (componentTag) => this.rewriteTag(componentTag, true));
+            if (content !== newContent) {
+                reuse_1.MODIFIED_FILES.add(file);
+                fs_1.default.writeFileSync(file, newContent);
+            }
+        });
+    }
+    transpileCustomElementFiles(baseDir) {
+        const tagRegExp = new RegExp(`<${this.tag}[^>]*_variant[^>]*>`, 'g');
+        (0, reuse_1.filterFilesByExt)(baseDir, types_1.CUSTOM_ELEMENT_FILE_EXTENSIONS).forEach((file) => {
+            const content = fs_1.default.readFileSync(file, 'utf8');
+            const newContent = content.replace(tagRegExp, (componentTag) => this.rewriteTag(componentTag, false));
+            if (content !== newContent) {
+                reuse_1.MODIFIED_FILES.add(file);
+                fs_1.default.writeFileSync(file, newContent);
+            }
+        });
+    }
+    rewriteTag(componentTag, isComponent) {
+        if (!this.variantStandaloneRegExp.test(componentTag)) {
+            return componentTag;
+        }
+        const inlineReplacement = isComponent ? ' _inline={false}' : ' _inline="false"';
+        if (/\s_inline\s*=/.test(componentTag)) {
+            return componentTag.replace(this.variantStandaloneRegExp, '');
+        }
+        return componentTag.replace(this.variantStandaloneRegExp, inlineReplacement);
+    }
+}
+exports.MapButtonLinkVariantStandaloneToInlineTask = MapVariantStandaloneToInlineTask.getInstance('kol-button-link', '^4');
+exports.MapLinkVariantStandaloneToInlineTask = MapVariantStandaloneToInlineTask.getInstance('kol-link', '^4');
+exports.MapVariantStandaloneToInlineTasks = [exports.MapButtonLinkVariantStandaloneToInlineTask, exports.MapLinkVariantStandaloneToInlineTask];

package/dist/migrate/runner/tasks/v4/loader.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateLoaderImportPathTask = void 0;
+const fs_1 = __importDefault(require("fs"));
+const reuse_1 = require("../../../shares/reuse");
+const abstract_task_1 = require("../../abstract-task");
+const LOADER_FILE_EXTENSIONS = ['js', 'jsx', 'ts', 'tsx', 'vue'];
+class UpdateLoaderImportPathTask extends abstract_task_1.AbstractTask {
+    constructor(identifier, versionRange, dependentTasks, options) {
+        super(identifier, 'Update loader imports to @public-ui/components/loader', LOADER_FILE_EXTENSIONS, versionRange, dependentTasks, options);
+    }
+    static getInstance(versionRange, dependentTasks = [], options = {}) {
+        const identifier = `update-loader-import-path-${versionRange}`;
+        if (!this.instances.has(identifier)) {
+            this.instances.set(identifier, new UpdateLoaderImportPathTask(identifier, versionRange, dependentTasks, options));
+        }
+        return this.instances.get(identifier);
+    }
+    run(baseDir) {
+        this.transpileFiles(baseDir);
+    }
+    transpileFiles(baseDir) {
+        (0, reuse_1.filterFilesByExt)(baseDir, LOADER_FILE_EXTENSIONS).forEach((file) => {
+            const content = fs_1.default.readFileSync(file, 'utf8');
+            const newContent = content.replace(/@public-ui\/components\/dist\/loader/g, '@public-ui/components/loader');
+            if (newContent !== content) {
+                reuse_1.MODIFIED_FILES.add(file);
+                fs_1.default.writeFileSync(file, newContent);
+            }
+        });
+    }
+}
+exports.UpdateLoaderImportPathTask = UpdateLoaderImportPathTask;

package/dist/migrate/shares/reuse.js

@@ -177,7 +177,10 @@ function setRemoveMode(mode) {
     REMOVE_MODE = mode;
 }
 /**
- * Gets the remove mode.
+ * Gets the current remove mode chosen via the CLI flag `--remove-mode`.
+ * - `prefix` (default) renames removed properties to `data-removed-<property>` so that developers can
+ *   clean them up manually after the migration.
+ * - `delete` removes the properties entirely during migration.
  * @returns {RemoveMode} The remove mode
  */
 function getRemoveMode() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@public-ui/kolibri-cli",
-  "version": "4.0.0-alpha.1",
+  "version": "4.0.0-alpha.11",
   "license": "EUPL-1.2",
   "homepage": "https://public-ui.github.io",
   "repository": {
@@ -22,34 +22,34 @@
   "type": "commonjs",
   "dependencies": {
     "chalk": "5.6.2",
-    "commander": "14.0.1",
+    "commander": "14.0.2",
     "deepmerge": "4.3.1",
     "gradient-string": "3.0.0",
     "loglevel": "1.9.2",
-    "prettier": "3.6.2",
-    "semver": "7.7.2",
+    "prettier": "3.7.4",
+    "prettier-plugin-organize-imports": "4.3.0",
+    "semver": "7.7.3",
     "typed-bem": "1.0.2"
   },
   "devDependencies": {
-    "@types/node": "24.5.2",
+    "@types/node": "24.10.4",
     "@typescript-eslint/eslint-plugin": "7.18.0",
     "@typescript-eslint/parser": "7.18.0",
     "cpy-cli": "6.0.0",
-    "cross-env": "10.0.0",
+    "cross-env": "10.1.0",
     "eslint": "8.57.1",
     "eslint-config-prettier": "9.1.2",
     "eslint-plugin-html": "8.1.3",
-    "eslint-plugin-jsdoc": "50.8.0",
     "eslint-plugin-json": "3.1.0",
     "eslint-plugin-jsx-a11y": "6.10.2",
     "eslint-plugin-react": "7.37.5",
-    "knip": "5.64.1",
-    "mocha": "11.7.2",
-    "nodemon": "3.1.10",
-    "rimraf": "6.0.1",
+    "knip": "5.73.4",
+    "mocha": "11.7.5",
+    "nodemon": "3.1.11",
+    "rimraf": "6.1.2",
     "ts-node": "10.9.2",
-    "typescript": "5.9.2",
-    "@public-ui/components": "4.0.0-alpha.1"
+    "typescript": "5.9.3",
+    "@public-ui/components": "4.0.0-alpha.11"
   },
   "files": [
     "dist"
@@ -61,10 +61,9 @@
     "lint": "pnpm lint:eslint && pnpm lint:tsc",
     "lint:eslint": "eslint src",
     "lint:tsc": "tsc --noemit",
-    "pretest": "pnpm build",
+    "pretest:unit": "pnpm build",
     "restart": "pnpm reset && pnpm start",
     "start": "rimraf test && cpy \"../../samples/react/src/components\" test/src && cpy \"../../samples/react/public/*.html\" test/ && ts-node src/index.ts migrate --ignore-uncommitted-changes --test-tasks test",
-    "test": "pnpm test:unit",
     "test:unit": "cross-env TS_NODE_PROJECT=tsconfig.test.json mocha --require ts-node/register test/**/*.ts --no-experimental-strip-types",
     "unused": "knip",
     "watch": "nodemon --ignore package.json src/index.ts migrate --ignore-uncommitted-changes --test-tasks test"