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.

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:

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.