---
title: Pakiety
description: Importuj funkcje i struktury JSON przypięte do treści z biblioteki standardowej, struktur konektorów lub repozytorium danych.
species: reference
---
# Pakiety

Pakiet typesql to wersjonowana przestrzeń nazw funkcji, sygnatur modeli i struktur JSON. Rozwiązywanie jest przypięte do treści: te same bajty `typesql.lock` zawsze wybierają ten sam artefakt pakietu.

```typesql
import type shapes from 'connector/stripe';
import finance from 'skycrane/finance';
```

## Nazwy pakietów

Odwołaniem jest dokładnie `stdlib` albo zapisane małymi literami `namespace/name`. Segment zaczyna się znakiem `a-z`, a dalej może zawierać `a-z`, `0-9`, `_` lub `-`.

Pakiety organizacji znajdują się w `packages/<namespace>/<name>/typesql.pkg`. Przestrzeń `connector/*` jest zarezerwowana dla pakietów struktur konektorów. Ścieżki bezwzględne, `.`, `..`, powtórzone separatory, aliasy z wielkimi literami i trzeci segment ścieżki są odrzucane.

## Importy

`import type` wprowadza struktury i sygnatury, a następnie jest całkowicie usuwany. Samo `import` wprowadza też ciała funkcji i należy do pełnej warstwy typesql.

Pakiety nie odczytują samodzielnie systemu plików. Wywołujący sprawdza, czy kanoniczna ścieżka artefaktu pozostaje w katalogu `packages/` repozytorium, i dostarcza jego bajty.

## Plik blokady

`typesql.lock` używa jednego posortowanego wiersza dla każdego dokładnego skrótu artefaktu:

```text
typesql-lock-v1
package skycrane/finance sha256:813c25d0f81d8963fd60345cf6be0a8d3e40f52612f491d6d97e06c77b16f9d0
```

Brak przypięcia zwraca `TS0601`, brak artefaktu — `TS0602`, a niezgodność skrótu — `TS0603`. Błędy formatu, eksportu, cyklu, przesłonięcia, limitu zasobów i nieużywanego importu używają kodów od `TS0604` do `TS0609`.