본문으로 건너뛰기
토파즈문서

문서 검색

명세 6.0

방향키로 결과를 고르고 Enter를 눌러 여세요.

API 이름, 진단 번호, 규칙 또는 프로젝트 주제를 입력하세요.

    다운로드 →

    설계 결정

    아직 규칙이 없는 결정

    타입 판정은 실패한 사실에 의존하는 부분만 보류합니다

    2026년 11월 19일 채택 · 6.0.0 · 구현 중

    문제

    타입 이름 하나를 잘못 썼을 때 같은 원인의 진단이 여러 번 나오기도 했습니다. 반대로 필드의 타입이 여전히 확실한 곳에서 별개의 오류가 빠지는 경우도 있었습니다.

    결정

    • 검사 단계에서 처음 실패한 구체적 의무마다 원인 진단을 한 번 냅니다. 타입 이름을 알 수 없는 오류의 예는 TPZ5022입니다.
    • 판정 질문마다 예, 아니오, 미확정 중 하나를 정합니다. 결론에 필요한 사실이 미확정인 경우에만 후속 진단을 보류합니다.
    • 명목 선언의 정체성, 변형 이름, 인수 수와 확정된 필드는 계속 검사합니다. 추론 문맥이 확실히 부족하면 TPZ5020, 이미 정해진 타입이 모순되면 TPZ5001입니다.
    • 생성자, 프로토콜 충족, 자동 생성, 사용처와 공개 표면에서도 원인과 독립적인 사실만으로 증명할 수 있는 오류를 보고합니다.
    • 패턴은 필드와 payload의 조합을 보존해서 검사합니다. 미확정 부분과 관계없이 증명되는 누락이나 도달 불가는 TPZ5021이나 TPZ5713으로 알립니다.
    • 원인 진단으로 검사가 실패하면 프로그램을 실행하지 않습니다.

    검토한 대안

    • 판정 위치마다 별도로 오류를 복구하거나 실패한 타입 전체를 미확정으로 둔다. 위치별 규칙은 중복과 연쇄 진단을 만들고, 타입 전체를 미확정으로 두면 알려진 사실을 잃습니다.
    • 원인이 있는 모듈의 나머지 진단을 중단한다. 같은 모듈의 독립적인 오류도 가려집니다.

    이유

    원인 하나를 고치면 함께 사라질 메시지를 줄이면서 따로 고쳐야 할 오류는 확인할 수 있습니다.

    제네릭 함수의 다형성은 바인딩에 남습니다

    2026년 11월 19일 채택 · 6.0.0 · 구현 중

    문제

    제네릭 함수를 다른 이름에 저장했다가 여러 타입으로 호출할 수 있습니다. 이전에는 다형 바인딩에 단형 함수를 대입해도 검사를 통과한 뒤 실행 중에 실패할 수 있었습니다.

    결정

    • 주석 없는 적격 바인딩은 함수의 제네릭 서명을 보존합니다. 일반 함수 값과 레코드 필드, 배열 원소의 타입은 단형입니다.
    • 값으로 사용할 때 새 타입 인스턴스를 정합니다. 같은 식에서 바로 소비할 수 있지만 바인딩이나 문장이 닫힐 때 추론 변수가 남으면 검사 단계 TPZ5020입니다.
    • 가변 제네릭 바인딩에 다시 대입하는 함수는 기존 바인딩이 허용하던 호출을 모두 받아야 합니다. 맞지 않는 단형 함수를 넣으면 검사 단계 TPZ5001입니다.
    • json.parseAs를 명시 타입 인수 없이 단형 값으로 만들면 검사 단계 TPZ5534입니다. json.stringify의 JSON 요건도 값의 타입을 정하는 자리에서 검사합니다.
    • 공개 바인딩에 노출되는 비공개 제약은 검사 단계 TPZ5524입니다.

    검토한 대안

    • 가변 바인딩을 모두 단형으로 제한한다. 유효한 제네릭 별칭도 가변이라는 이유로 여러 타입에 쓸 수 없게 됩니다.
    • 다형성을 레코드 필드나 배열 타입에 저장한다. 타입 인수와 저장 경로에서 다형 타입을 다루는 새 추론 규칙이 필요합니다.
    • 쓰이지 않는 타입 매개변수를 지우거나 컨테이너 생성에서 추론을 닫는다. 앞의 방식은 재대입에서도 소거 가능성을 증명해야 하고 뒤의 방식은 같은 식에서 사용해 타입을 정하는 경우를 막습니다.
    • 지금처럼 둔다. 검사를 통과한 프로그램이 실행 중 타입 오류를 내는 구멍과 공개 제약 누출이 남습니다.
    • 제한 없는 impredicative 추론을 쓴다. 추론기와 실행 계획과 실행기 모두에 새 운반 규칙이 듭니다.
    • parseAs를 문맥 타입으로 정상화한다. 명시 타입 인수 계약을 바꿔야 하므로 따로 결정합니다.

    이유

    정상적인 다형 별칭을 유지하면서 잘못된 재대입과 미해결 타입 인수를 실행 전에 발견할 수 있습니다.

    표준 라이브러리 생성자와 비용 계산 오류는 공개 호출 자리를 가리킵니다

    2026년 11월 7일 채택 · 6.0.0 · 확인 중

    문제

    생성자나 비용 계산이 라이브러리 내부에서 실패할 수 있습니다. 내부 연산 위치만 알면 사용자 코드에서 넘긴 값을 추적해야 합니다.

    결정

    표준 라이브러리 생성자와 비용 계산의 실행 오류는 사용자가 쓴 공개 호출을 주 위치로 가리킵니다.

    검토한 대안

    • 내부 연산 위치를 그대로 보여 준다. 사용자가 값을 고칠 호출 위치를 찾기 어렵습니다.

    이유

    문제를 일으킨 호출과 그 입력을 바로 확인할 수 있습니다.