Testowanie lokalnie

Przykładowa struktura folderów do testowania:

Folder/
- Folderlib-web-solvro-config/
  - package.json
  - …
- Foldermy-new-next-project/
  - next.config.ts
  - package.json
  - …

W tej sytuacji lib-web-solvro-config jest katalogiem zawierającym projekt paczki, którą chcemy testować, zaś my-new-next-project jest katalogiem projektu, w którym chcemy testować paczkę.

npm
pnpm

Lokalne testowanie paczki należy rozpocząć od jej zbudowania.
Okno terminala
```
npm run build # przykładowo, zależy od projektu pakietu
```
Następnie należy ją dodać do globalnego katalogu pakietów.
Okno terminala
```
npm link
```

Na koniec należy powiązać paczkę testowaną w katalogu projektu testowanego.

cd ../my-new-next-project
npm link @solvro/config # npm teraz wie, że pakiet jest dostępny lokalnie

Po powiązaniu pakietu, utworzone zostały linki symboliczne do lokalnej paczki, które umożliwiają nam lokalne importowanie i uruchamianie komend paczek.
Okno terminala
```
npx @solvro/config # uruchomiona zostaje lokalna wersja paczki
```
W celu pogłębiania swojej wiedzy na temat linkowania pakietów, warto zapoznać się z oficjalną dokumentacją menedżera pakietów.
Linkowanie pakietów w npm

Lokalne testowanie paczki należy rozpocząć od jej zbudowania.

Tutaj używamy menedżera pakietów skonfigurowanego w projekcie paczki, a nie w projekcie, w którym będziemy testować paczkę. W tym przykładzie w lib-web-solvro-config skonfigurowany jest npm, więc dla tego kroku nie używamy komendy pnpm.
Okno terminala
```
npm run build # przykładowo, zależy od projektu pakietu
```
Następnie należy ją dodać do globalnego katalogu pakietów.
Okno terminala
```
pnpm add -g .
```
Gdy projekt pakietu ma skonfigurowany menedżer pakietów inny niż pnpm, to w niektórych środowiskach, np. przy użyciu volta, komenda pnpm może być zablokowana w katalogu pakietu. Wówczas należy tę komendę wykonać z innego katalogu i wskazać ścieżkę do projektu.
Okno terminala
```
cd ../my-new-next-project
pnpm add -g ../lib-web-solvro-config
```
Po powiązaniu pakietu, utworzone zostały linki symboliczne do binarek deklarowanych w lokalnej paczce, które umożliwiają nam lokalne uruchamianie komend paczek.
Okno terminala
```
pnpm exec config # uruchomiona zostaje lokalna wersja paczki
```
Gdy nazwa pakietu składa się również z namespace-u, pnpm linkuje tylko nazwę bazową paczki. Dlatego w powyższym przykładzie używamy config zamiast @solvro/config.

Tą metodą linkowane są tylko komendy wykonywalne wystawiane przez pakiet, a nie sam pakiet. Oznacza to, że importy z tej paczki w kodzie nie będą odnosiły się do lokalnej wersji. Jeśli tego potrzebujesz, to przejdź do kolejnego kroku.
Żeby móc importować lokalną paczkę w kodzie (lub np. w konfiguracji eslint albo innego narzędzia), można opcjonalnie powiązać paczkę w katalogu projektu testowanego.
Okno terminala
```
pnpm link ../lib-web-solvro-config
```
Tą metodą zajdą zmiany w plikach package.json, pnpm-lock.yaml i pnpm-workspace.yaml, które nie powinny być commitowane. Ze względu na to, ten sposób linkowania pakietów nie jest polecany i powinien tylko być stosowany, gdy metoda z poprzedniego kroku nie spełnia naszych potrzeb.

Teraz możemy importować lokalną paczkę w kodzie, np. w konfiguracji eslint:
eslint.config.mjs
```
import { solvro } from "@solvro/config/eslint";
export default solvro(); // to jest lokalna wersja paczki
```
W celu pogłębiania swojej wiedzy na temat linkowania pakietów, warto zapoznać się z oficjalną dokumentacją menedżera pakietów.
Linkowanie pakietów w pnpm