@public-ui/kolibri-cli 4.0.0-alpha.0 → 4.0.0-alpha.10

package/README.md

@@ -1,8 +1,19 @@
 # KoliBri - CLI-Tools
 
+Command line utilities to help maintain and migrate KoliBri projects.
+
+[![npm](https://img.shields.io/npm/v/@public-ui/kolibri-cli)](https://www.npmjs.com/package/@public-ui/components)
+[![license](https://img.shields.io/npm/l/@public-ui/kolibri-cli)](https://github.com/public-ui/kolibri/blob/main/LICENSE)
+[![downloads](https://img.shields.io/npm/dt/@public-ui/kolibri-cli)](https://www.npmjs.com/package/@public-ui/kolibri-cli)
+[![issues](https://img.shields.io/github/issues/public-ui/kolibri)](https://github.com/public-ui/kolibri/issues)
+[![pull requests](https://img.shields.io/github/issues-pr/public-ui/kolibri)](https://github.com/public-ui/kolibri/pulls)
+[![size](https://img.shields.io/bundlephobia/min/@public-ui/kolibri-cli)](https://bundlephobia.com/result?p=@public-ui/kolibri-cli)
+![contributors](https://img.shields.io/github/contributors/public-ui/kolibri)
+
 ## Motivation
 
 The `KoliBri` CLI-Tools are a collection of tools to support the development with `KoliBri` components.
+They also help migrating projects when new components or design tokens are introduced.
 
 ## Installation
 
@@ -14,6 +25,16 @@ pnpm i -g @public-ui/kolibri-cli
 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.
@@ -45,6 +66,7 @@ Commands:
 ```
 
 ### Info
+
 With the `info` command you can show the current system and KoliBri package information.
 
 This command is mainly needed for our bug issue templates.
@@ -55,27 +77,141 @@ 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
+
+The CLI also supports migrating KoliBri themes alongside component updates to ensure theme packages remain synchronized with breaking changes in the component library.
+
+##### Goal
+
+Synchronies breaking changes in components with the styling of each theme package so that upgrades require minimal manual work.
+
+##### Requirements
+
+- Components and themes follow the BEM naming convention via `typed-bem`.
+- Each theme lives under `packages/themes` and keeps its SCSS sources in `src/`.
+- The CLI migration tool can read and modify `.scss` files.
+
+##### Concept
+
+1. **Central BEM schemas**
+   - Every component exports its BEM schema. These schemas are used by the CLI to generate SCSS files and by themes to reference selectors.
+   - When a selector changes, the same schema information allows the migration to update all theme packages consistently.
+
+2. **SCSS migration tasks**
+   The CLI runner is extended with task types operating on SCSS. They behave like the existing property tasks and are idempotent.
+   - `RenameBlockTask` – rename a block selector everywhere in a theme.
+   - `RenameElementTask` – rename an element within a block.
+   - `RenameModifierTask` – rename or replace a modifier.
+   - `AddSelectorTask` and `RemoveSelectorTask` – insert or remove entire rule sets.
+   - `UpdateTokenTask` – adjust variable names or values when tokens change.
+   - `MoveRulesTask` – move declarations from one selector to another if the DOM structure changes.
+
+   Tasks scan the SCSS with regular expressions or an AST parser. If a pattern is missing the task logs a warning instead of failing.
+
+3. **Safe execution**
+   - Migrations abort when uncommitted changes are detected unless `--ignore-uncommitted-changes` is specified.
+   - Each task logs the files it touched. After completion Prettier can format them automatically.
+   - Because tasks are idempotent, rerunning the migration produces no new changes. To undo a run, reset the Git state.
+
+##### Theme Migration Workflow Example
+
+```bash
+pnpm i -g @public-ui/kolibri-cli@2      # install the CLI matching the next version
+kolibri migrate path/to/project         # run all tasks for the upgrade
+pnpm format                             # format changed files
+git diff                                # review results and commit
+```
+
+Using these tasks, theme packages remain aligned with component updates. Future breaking changes can be scripted and applied via the CLI so that projects can upgrade in a controlled and reproducible way.
 
 #### How does it work?
 
@@ -122,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,
@@ -177,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,
@@ -194,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/generate-scss/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const components_1 = require("@public-ui/components");
+const scss_1 = require("typed-bem/scss");
+/**
+ * This function is used to register the scss generator command.
+ * @param {Command} program The program object to register the command
+ */
+function default_1(program) {
+    program
+        .command('generate-scss')
+        .description('Generate SCSS files with BEM selectors for KoliBri components (experimental).')
+        .action(() => {
+        (0, scss_1.generateBemScssFile)(components_1.BEM_ALERT, 'alert');
+        (0, scss_1.generateBemScssFile)(components_1.BEM_ICON, 'icon');
+    });
+}

package/dist/index.js

@@ -6,24 +6,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const gradient_string_1 = __importDefault(require("gradient-string"));
+const generate_scss_1 = __importDefault(require("./generate-scss"));
 const info_1 = __importDefault(require("./info"));
 const migrate_1 = __importDefault(require("./migrate"));
 const reuse_1 = require("./migrate/shares/reuse");
 const versionOfPublicUiKoliBriCli = (0, reuse_1.getVersionOfPublicUiKoliBriCli)();
-const banner = gradient_string_1.default.atlas.multiline(`
+const banner = (0, gradient_string_1.default)(['red', 'green'], { interpolation: 'hsv', hsvSpin: 'long' }).multiline(`
 ,--. ,--.         ,--. ,--. ,-----.           ,--.
 |  .'   /  ,---.  |  | \`--' |  |) /_  ,--.--. \`--'
 |  .   '  | .-. | |  | ,--. |  .-.  \\ |  .--' ,--.
 |  |\\   \\ | '-' | |  | |  | |  '--' / |  |    |  |
 \`--' \`--´  \`---´  \`--' \`--' \`------´  \`--'    \`--'
 🚹 The accessible HTML-Standard | 👉 https://public-ui.github.io | ${versionOfPublicUiKoliBriCli}
-`, {
-    interpolation: 'hsv',
-});
+`);
 console.log(banner);
 const program = new commander_1.Command();
 program.name('kolibri').description('CLI for executing some helpful commands for KoliBri projects.').version(versionOfPublicUiKoliBriCli);
 // Add commands
+(0, generate_scss_1.default)(program);
 (0, info_1.default)(program);
 (0, migrate_1.default)(program);
-program.parse();
+void program.parseAsync();

package/dist/info/index.js

@@ -4,16 +4,29 @@ 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 {
+        // For yarn, use a temporary directory to prevent package.json modification
+        // Yarn with Corepack automatically adds packageManager field when executed
+        if (command === 'yarn') {
+            const originalCwd = process.cwd();
+            const tmpDir = os_1.default.tmpdir();
+            process.chdir(tmpDir);
+            try {
+                return (0, child_process_1.execSync)(`${command} --version`, { encoding: 'utf8' }).trim();
+            }
+            finally {
+                process.chdir(originalCwd);
+            }
+        }
         return (0, child_process_1.execSync)(`${command} --version`, { encoding: 'utf8' }).trim();
     }
-    catch (_a) {
+    catch {
         return 'N/A';
     }
 };
@@ -36,16 +49,16 @@ const getRelevantPackagesInfo = () => {
     const packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, 'utf8'));
     const packagePattern = /^@public-ui\//;
     const packagesInfo = {};
-    const allDependencies = Object.assign(Object.assign({}, packageJson === null || packageJson === void 0 ? void 0 : packageJson.dependencies), packageJson === null || packageJson === void 0 ? void 0 : packageJson.devDependencies);
+    const allDependencies = { ...packageJson?.dependencies, ...packageJson?.devDependencies };
     Object.keys(allDependencies).forEach((pkg) => {
         if (packagePattern.test(pkg)) {
-            packagesInfo[pkg] = allDependencies === null || allDependencies === void 0 ? void 0 : allDependencies[pkg];
+            packagesInfo[pkg] = allDependencies?.[pkg];
         }
     });
     // Add specific packages not matching the pattern
     const additionalPackages = ['react', 'react-dom', 'typescript'];
     additionalPackages.forEach((pkg) => {
-        packagesInfo[pkg] = (allDependencies === null || allDependencies === void 0 ? void 0 : allDependencies[pkg]) || 'N/A';
+        packagesInfo[pkg] = allDependencies?.[pkg] || 'N/A';
     });
     return packagesInfo;
 };

package/dist/migrate/index.js

@@ -15,8 +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 v2_1 = require("./runner/tasks/v2");
 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 reuse_1 = require("./shares/reuse");
 const types_1 = require("./types");
 const currentVersionOfPublicUi = (0, reuse_1.getVersionOfPublicUiComponents)();
@@ -61,6 +63,12 @@ Current version of @public-ui/*: ${options.overwriteCurrentVersion}
 Target version of @public-ui/*: ${options.overwriteTargetVersion}
 Source folder to migrate: ${baseDir}
 `);
+            if (!fs_1.default.existsSync(baseDir)) {
+                throw (0, reuse_1.logAndCreateError)(`The specified source folder "${baseDir}" does not exist or is inaccessible. Please check the path and try again.`);
+            }
+            if (!(0, reuse_1.hasKoliBriTags)(baseDir)) {
+                console.log(chalk_1.default.yellow(`No KoliBri components (web or React) found under "${baseDir}". Check the path or your task configuration.`));
+            }
             if (!options.ignoreGreaterVersion && semver_1.default.lt(options.overwriteTargetVersion, options.overwriteCurrentVersion)) {
                 throw (0, reuse_1.logAndCreateError)('Your current version of @public-ui/components is greater than the version of @public-ui/kolibri-cli. Please update @public-ui/kolibri-cli or force the migration with --ignore-greater-version.');
             }
@@ -78,6 +86,8 @@ Source folder to migrate: ${baseDir}
             runner.registerTasks(tasks_1.commonTasks);
             runner.registerTasks(v1_1.v1Tasks);
             runner.registerTasks(v2_1.v2Tasks);
+            runner.registerTasks(v3_1.v3Tasks);
+            runner.registerTasks(v4_1.v4Tasks);
             runner.registerTasks((0, assets_1.getAssetTasks)(baseDir));
             if (options.testTasks) {
                 runner.registerTasks(test_1.testTasks);
@@ -143,14 +153,16 @@ Source folder to migrate: ${baseDir}
              * Prints the status of the task runner and the modified files.
              */
             function finish() {
-                var _a, _b;
                 console.log(`
 Status of all executed Tasks:`);
                 const status = runner.getStatus(true);
                 // Merge config with current config of Runner
                 config = {
                     migrate: {
-                        tasks: Object.assign(Object.assign({}, (_a = status.config.migrate) === null || _a === void 0 ? void 0 : _a.tasks), (_b = config.migrate) === null || _b === void 0 ? void 0 : _b.tasks),
+                        tasks: {
+                            ...status.config.migrate?.tasks,
+                            ...config.migrate?.tasks,
+                        },
                     },
                 };
                 fs_1.default.writeFileSync(configFile, JSON.stringify(config, null, 2));
@@ -159,6 +171,9 @@ Modified files: ${reuse_1.MODIFIED_FILES.size}`);
                 reuse_1.MODIFIED_FILES.forEach((file) => {
                     console.log(`- ${file}`);
                 });
+                if (reuse_1.MODIFIED_FILES.size === 0) {
+                    console.log(chalk_1.default.yellow(`No files were modified. Verify the folder "${baseDir}" or check your .kolibri.config.json tasks.`));
+                }
                 if (reuse_1.MODIFIED_FILES.size > 0 && options.format) {
                     console.log(`
 We try to format the modified files with prettier...`);