Przejdź do treści
Biblioteka skilli
Programowanie · Konwersja i formaty

migrate-react-18

/migrate-react-18

Aktualizuje projekt konsumenta do najnowszych głównych wersji pakietów @entur/* systemu projektowego: zmiany łamiące (eksporty ESM, modal, tabs, layout) i weryfikacja minimum React 18.

Repozytorium
design-system ↗
Licencja
AGPL-3.0
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

Co robi i kiedy

Aktualizuje projekt konsumenta do najnowszych głównych wersji pakietów @entur/* systemu projektowego: zmiany łamiące (eksporty ESM, modal, tabs, layout) i weryfikacja minimum React 18.

Oryginalny opis (EN)

Upgrade a consumer project to the latest major @entur/* design system packages. Covers breaking changes (ESM exports, modal, tabs, expand, layout, utils) and verifies the project meets the React 18 minimum. Use when upgrading @entur packages, fixing breakage after updating @entur dependencies, or migrating to the newest design system versions.

Jak działa

  1. Steps
Sekcje z nagłówków SKILL.md, w oryginale · 111 linii, 760 słów
Podgląd SKILL.md
---
name: migrate-react-18
description: Upgrade a consumer project to the latest major @entur/* design system packages. Covers breaking changes (ESM exports, modal, tabs, expand, layout, utils) and verifies the project meets the React 18 minimum. Use when upgrading @entur packages, fixing breakage after updating @entur dependencies, or migrating to the newest design system versions.
disable-model-invocation: true
---

# Upgrade @entur/\* packages to latest major versions

The latest major versions of all `@entur/*` packages require React 18 as a minimum. Most consumer projects are already on React 18+ — the main work is handling package-specific breaking changes.

> **Resolving `references/` paths:** if you are reading this over HTTP rather than from an installed skill folder, resolve every `references/<file>` path in this file against `https://raw.githubusercontent.com/entur/design-system/main/skills/migrate-react-18/` — not against the folder of whichever skill linked you here.

## Steps

### 1. Inventory

Scan `package.json` (and monorepo workspace `package.json` files if applicable) for:

- All `@entur/*` packages and their current versions
- Current React and React-DOM versions
- `@testing-library/react` version (if present)
- `tsconfig.json` `jsx` setting

Report what you found before proceeding.

**Done when:** every `@entur/*` package, React version, and testing-library version is listed.

### 2. Check React version

If React is already 18+, skip to step 3.

If React is below 18:

```bash
npm install react@^18 react-dom@^18 @types/react@^18 @types/react-dom@^18
```

Then search for `ReactDOM.render` — replace with `createRoot`:

```tsx
// Before
import ReactDOM from 'react-dom';
ReactDOM.render(<App />, document.getElementById('root'));

// After
import { createRoot } from 'react-dom/client';
const root = createRoot(document.getElementById('root')!);
root.render(<App />);
```

Also search for `ReactDOM.hydrate` — replace with `hydrateRoot` from `react-dom/client`.

If `tsconfig.json` has `"jsx": "react"`, change to `"jsx": "react-jsx"`.

**Done when:** React is 18+ and entry points use the new API (or were already there).

### 3. Upgrade @entur/\* packages

Update all `@entur/*` packages to their latest versions:

```bash
npm install @entur/button@latest @entur/modal@latest ...
```

List every `@entur/*` package in the project and upgrade them all in one command.

**Done when:** all `@entur/*` packages are at their latest versions.

### 4. Fix breaking changes

Load **[references/breaking-changes.md](references/breaking-changes.md)** and work through each section that applies to this project. Only process sections for packages the project actually uses.

The reference covers:

| Package                      | Key changes                                                                                             |
| ---------------------------- | ------------------------------------------------------------------------------------------------------- |
| ESM `exports` (all packages) | Deep `dist/` imports break; built files renamed to `.mjs`/`.cjs`                                        |
| `@entur/modal`               | `onDismiss` required, `<div>` → `<dialog>`, `data-reach-*` selectors gone                               |
| `@entur/tab`                 | `data-reach-*` selectors gone, stricter types, ID format changed, tab/panel index comes from the markup |
| `@entur/expand`              | Content stays in DOM when collapsed; `unmountOnClose` opt-out                                           |
| `@entur/layout` (beta)       | `LayoutProvider` removed; responsive base key `s` → `base`                                              |
| `@entur/utils`               | `useRandomId` deprecated → use React `useId()`                                                          |

For each applicable section: grep for the affected patterns, fix them, and confirm no instances remain.

**Done when:** every pattern listed in breaking-changes.md has been searched for and resolved for each used package.

### 5. Report behavioral changes

After all code changes are applied, inform the user about behavioral differences they should be aware of. Load **[references/behavioral-changes.md](references/behavioral-changes.md)** and present every section relevant to the packages this project uses.

These are changes that require no code fix but alter how the application behaves at runtime, in tests, or during development.

**Done when:** every relevant behavioral change has been communicated to the user.

### 6. Verify

Run the project's build and test suite:

```bash
npm run build
npm test
```

Fix any remaining type errors or test failures. Common issues:

- **Type errors from stricter props** — `@entur/tab` components no longer accept arbitrary props. Remove unknown props.
- **Test failures from ID changes** — Tab/panel IDs now use `useId()` format. Don't match specific ID strings; use `aria-controls`/`aria-labelledby` to find linked elements.
- **All panels render under the first tab** — panels hidden behind a component of your own (an error boundary, a data wrapper, or a component per panel) share one index. Render each panel from `<TabPanels>`, or pass each one an explicit `index` prop. `@entur/tab` logs an error in development when this happens.
- **Panels are off by one** — a component of your own inside `<TabPanels>` takes an index even when it renders no panel, so a heading or layout component shifts every panel after it. Move it out of `<TabPanels>`, or inline it as plain markup.
- **A tab shows the wrong panel** — a `<Tab>` and its `<TabPanel>` sit under different conditions, so a falsy conditional shifts every later index on one side only. Silent when the conditional is mid-list; merely logged when it's last. Put both behind the same condition.
- **Test failures from batched updates** — React 18 batches all state updates. Wrap assertions that depend on intermediate states in `act()` or use `waitFor`.
- **Double renders in dev** — `<StrictMode>` now mounts, unmounts, and re-mounts components. This is expected; fix missing `useEffect` cleanups it reveals.

**Done when:** build succeeds and tests pass.
Pliki w paczce (3)
  • SKILL.md 6 KB
  • references/behavioral-changes.md 6 KB
  • references/breaking-changes.md 15 KB

Wersje

W bazie nie ma innych skilli o nazwie migrate-react-18.

Migawka bazy z 13.11.2026 · wersja paczki c503d126642f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100entur-web-development
    Wspiera budowę aplikacji React z pakietami komponentów Entur Linje @entur/*: komponenty, tokeny, zmienne CSS i system projektowy Entur.
  • 100migrate-typography
    Przenosi projekt na nową typografię Entur i skalę odstępów, ze zmianami nazw wariantów i starych komponentów.
  • 95react-modernization
    Aktualizuje aplikacje React do najnowszych wersji, migruje komponenty klasowe na hooki i wdraża funkcje współbieżne.
  • 100react-modernization
    Aktualizuje aplikacje React do najnowszych wersji, migruje komponenty klasowe na hooki i wprowadza funkcje współbieżne.
  • 95elevenlabs:sdk-migration
    Prowadzi migrację do następnej wersji głównej @elevenlabs/client, @elevenlabs/react i @elevenlabs/react-native, w tym zmiany w Conversation, useConversation i ElevenLabsProvider.
  • 100dependency-upgrade
    Bezpiecznie aktualizuje zależności przez katalog pnpm, sprawdza zmiany łamiące i testuje upgrade, przy łataniu bezpieczeństwa, wersjach głównych i modernizacji stosu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.