패키지#

typesql 패키지는 함수, 모델 시그니처, JSON 구조를 담은 버전이 지정된 네임스페이스입니다. 이름 확인은 콘텐츠에 고정됩니다. typesql.lock의 바이트가 같으면 항상 같은 패키지 아티팩트를 선택합니다.

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

패키지 이름#

참조는 정확히 stdlib이거나 소문자 namespace/name이어야 합니다. 각 부분은 a-z로 시작하며 이후에는 a-z, 0-9, _, -를 사용할 수 있습니다.

조직 패키지는 packages/<namespace>/<name>/typesql.pkg에 있습니다. connector/*는 커넥터 구조 패키지용으로 예약되어 있습니다. 절대 경로, ., .., 반복 구분 기호, 대문자 별칭, 세 번째 경로 부분은 허용하지 않습니다.

가져오기#

import type은 구조와 시그니처를 가져온 뒤 완전히 소거됩니다. 단독 import는 함수 본문도 가져오며 전체 typesql 계층에 속합니다.

패키지는 직접 파일 시스템을 읽지 않습니다. 호출자가 정규 아티팩트 경로가 저장소의 packages/ 디렉터리 안에 있는지 검증하고 바이트를 제공합니다.

잠금 파일#

typesql.lock은 정확한 아티팩트 해시마다 정렬된 줄 1개를 사용합니다.

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

고정 항목이 없으면 TS0601, 아티팩트가 없으면 TS0602, 해시가 일치하지 않으면 TS0603을 사용합니다. 형식, 내보내기, 순환, 가림, 리소스 제한, 사용하지 않는 가져오기 오류는 TS0604부터 TS0609까지 사용합니다.