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

문서 검색

명세 6.0

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

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

    다운로드 →

    설계 결정

    실패, 동시성, 모듈

    Result의 오류 타입이 정해지지 않으면 주석을 씁니다

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

    문제

    코드에서 Result의 성공값만 확인할 수 있으면 실패할 때 어떤 타입을 돌려주는지 정할 수 없습니다. 넓은 타입으로 자동 처리하면 그 제약이 호출에 드러나지 않습니다.

    결정

    오류 타입을 추론하지 못하면 검사 단계의 TPZ5022와 함께 타입 주석을 요구합니다.

    예제

    An unknown Result error type requires an annotation

    main.tpzAn unknown Result error type requires an annotation
    1. function value() { Ok(1) }
    2. let result = value()
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5022 →

      result-error-annotation-required at main.tpz:1:10

    A Result return annotation fixes the error type

    main.tpzA Result return annotation fixes the error type플레이그라운드 열기 →
    1. import std.io
    2. function value() -> Result<int, string> { Ok(1) }
    3. let result = match (value()) {
    4. case Ok(number) => number
    5. case Err(_) => 0
    6. }
    7. io.writeLine("{result}")
    기대 출력종료 코드 0
    1
    
    $ topaz run main.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 1

    검토한 대안

    • 오류 타입을 동적 값 타입으로 대체한다. 실제로 어떤 오류 값이 나올 수 있는지 함수 계약에서 읽을 수 없습니다.
    • 새 진단 코드를 만든다. 반환 추론과 같은 규칙, 같은 코드여야 말하는 방법이 하나입니다.

    이유

    반환 추론과 같은 진단으로 고칠 곳을 찾을 수 있습니다.

    바뀐 규칙 Annotating an unresolved Result error type →

    일부 답한 미정 항목 Return inference and nested callable contexts →

    콜백의 오류값은 콜백에서 반환합니다

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

    문제

    map에 넘긴 람다 안에서 ?를 쓰면 어느 함수가 반환하는지 알아야 합니다. 바깥 함수까지 벗어나면 콜백을 부르는 코드는 반환을 예상하기 어렵습니다.

    결정

    • 람다와 콜백의 ?는 그 호출에서 Result나 Option을 반환합니다.
    • Result 오류 타입을 정할 수 없으면 검사 단계에 TPZ5022가 나오므로 타입 주석을 씁니다.

    예제

    Mapping a propagating lambda produces an array of Results

    main.tpzMapping a propagating lambda produces an array of Results플레이그라운드 열기 →
    1. import std.io
    2. function surrounding() -> int {
    3. let inputs: Array<Result<int, string>> = [Ok(1), Err("stop"), Ok(3)]
    4. let advance: (Result<int, string>) -> Result<int, string> = (value) => {
    5. let number = value?
    6. io.writeLine("lambda {number}")
    7. Ok(number + 1)
    8. }
    9. let results: Array<Result<int, string>> = inputs.map(advance)
    10. io.writeLine("after map")
    11. for result in (results) {
    12. match (result) {
    13. case Ok(number) => io.writeLine("ok {number}")
    14. case Err(error) => io.writeLine("err {error}")
    15. }
    16. }
    17. 7
    18. }
    19. io.writeLine("{surrounding()}")
    기대 출력종료 코드 0
    lambda 1
    lambda 3
    after map
    ok 2
    err stop
    ok 4
    7
    
    $ topaz run main.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. lambda 1
    2. lambda 3
    3. after map
    4. ok 2
    5. err stop
    6. ok 4
    7. 7

    None returns from its lambda while the caller continues

    main.tpzNone returns from its lambda while the caller continues
    1. import std.io
    2. let advance: (Option<int>) -> Option<int> = (value) => {
    3. let number = value?
    4. io.writeLine("some {number}")
    5. Some(number + 1)
    6. }
    7. let missing = advance(None())
    8. io.writeLine("after none")
    9. match (missing) {
    10. case Some(number) => io.writeLine("{number}")
    11. case None() => io.writeLine("none")
    12. }
    13. let present = advance(Some(2))
    14. match (present) {
    15. case Some(number) => io.writeLine("{number}")
    16. case None() => io.writeLine("none")
    17. }
    기대 출력종료 코드 0
    after none
    none
    some 2
    3
    
    $ topaz run main.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. after none
    2. none
    3. some 2
    4. 3

    An integer-returning lambda cannot propagate a Result

    main.tpzAn integer-returning lambda cannot propagate a Result플레이그라운드 열기 →
    1. let read: (Result<int, string>) -> int = (value) => {
    2. value?
    3. }
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5001 →

      propagation-requires-result-return at main.tpz:2:5

    검토한 대안

    • ?가 콜백을 넘어 바깥 함수에서 반환한다. 콜백을 부르는 함수에도 비지역 반환을 처리하는 규칙이 필요합니다.
    • ?가 어디로 나가는지 정하지 않는다. 함수 경계마다 ?의 목적지가 하나여야 같은 코드를 같은 뜻으로 읽습니다.

    이유

    ?의 반환 대상을 가장 가까운 함수 본문에서 확인할 수 있습니다.

    바뀐 규칙 Propagation returns from the current callable →

    해결한 미정 항목 Return inference and nested callable contexts →

    갈래가 없는 동시 실행은 빈 레코드를 돌려줍니다

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

    문제

    동시 실행 결과는 갈래마다 필드를 가집니다. 갈래가 하나도 없는 경우에도 그 방식으로 결과를 만드는지 정해야 합니다.

    결정

    • 갈래가 없는 concurrent는 빈 레코드를 돌려줍니다.
    • 타입 자리의 {}는 빈 레코드 타입입니다. 식 자리의 {}는 단위 값을 돌려주는 블록입니다.

    예제

    An untimed group may have no arms

    example.tpzAn untimed group may have no arms
    1. let joined = concurrent {}
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    An empty concurrent record passes through an explicit record signature

    example.tpzAn empty concurrent record passes through an explicit record signature
    1. import std.io
    2. function keep(value: {}) -> {} { value }
    3. let joined: {} = keep(concurrent {})
    4. io.writeLine("completed")
    기대 출력종료 코드 0
    completed
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. completed

    The zero-field record is distinct from unit

    example.tpzThe zero-field record is distinct from unit
    1. let joined: () = concurrent {}
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5001 →

      concurrent-empty-result-is-not-unit at example.tpz:1:18

    검토한 대안

    • 갈래가 하나 이상이어야 한다고 제한한다. 결과 레코드 규칙에 갈래 수가 0일 때만 따르는 예외가 생깁니다.

    이유

    결과 필드가 갈래와 대응하는 규칙을 0개에도 그대로 씁니다.

    바뀐 규칙 Concurrent groups may contain zero arms →

    시간 제한은 Duration 식을 한 번 평가합니다

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

    문제

    시간 제한을 설정에서 읽거나 계산해서 얻을 수 있습니다. 리터럴만 받으면 이미 같은 길이의 값을 얻은 코드도 다시 써야 합니다.

    결정

    시간 제한은 일반 Duration 식입니다. 식을 한 번 평가한 뒤 제한 시간과 갈래 실행을 시작합니다.

    예제

    Parentheses preserve a timeout value

    example.tpzParentheses preserve a timeout value
    1. import std.io
    2. let joined = concurrent(timeout: (0ms)) { value: 1 } else { { value: 7 } }
    3. io.writeLine("{joined.value}")
    기대 출력종료 코드 0
    7
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 7

    A bound Duration is the same timeout value

    example.tpzA bound Duration is the same timeout value
    1. import std.io
    2. let budget: Duration = 0ms
    3. let joined = concurrent(timeout: budget) { value: 1 } else { { value: 7 } }
    4. io.writeLine("{joined.value}")
    기대 출력종료 코드 0
    7
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 7

    Evaluate the timeout once before any arm

    example.tpzEvaluate the timeout once before any arm
    1. import std.io
    2. function budget() -> Duration {
    3. io.writeLine("budget")
    4. 0ms
    5. }
    6. let joined = concurrent(timeout: budget()) {
    7. value: { io.writeLine("arm")
    8. 1 }
    9. } else {
    10. io.writeLine("fallback")
    11. { value: 7 }
    12. }
    13. io.writeLine("{joined.value}")
    기대 출력종료 코드 0
    budget
    fallback
    7
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. budget
    2. fallback
    3. 7

    An integer does not implicitly become Duration

    example.tpzAn integer does not implicitly become Duration
    1. let joined = concurrent(timeout: 1) { value: 1 } else { { value: 7 } }
    기대 출력종료 코드 1
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드 1.

    • TPZ5001 →

      concurrent-timeout-duration-type at example.tpz:1:34

    검토한 대안

    • 리터럴만 받는다(지금 동작). 같은 값을 괄호나 이름으로 썼다는 이유로 거절됩니다.
    • 상수식만 받는다. 같은 값을 계산하는 식도 받아야 쓰는 방법이 갈리지 않습니다.

    이유

    다른 식과 같은 방법으로 시간을 계산하며 평가 시점도 정해져 있습니다.

    바뀐 규칙 A timeout accepts a Duration expression →

    완료와 제한 시간이 겹치면 제한 시간이 우선합니다

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

    문제

    한 갈래가 끝나는 순간에 제한 시간도 끝날 수 있습니다. 어느 쪽을 먼저 처리하는지에 따라 같은 프로그램이 다른 결과를 내게 됩니다.

    결정

    • 제한 시간에 닿은 순간과 완료가 겹치면 시간 초과가 우선합니다. 0밀리초도 같습니다.
    • 동시에 난 실행 오류는 갈래의 선언 순서로 우선순위를 정하지 않습니다.

    예제

    Zero duration takes the fallback for one ready arm

    example.tpzZero duration takes the fallback for one ready arm
    1. import std.io
    2. let joined = concurrent(timeout: 0ms) {
    3. value: 1
    4. } else {
    5. { value: 7 }
    6. }
    7. io.writeLine("{joined.value}")
    기대 출력종료 코드 0
    7
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 7

    Zero duration takes the complete fallback for multiple ready arms

    example.tpzZero duration takes the complete fallback for multiple ready arms플레이그라운드 열기 →
    1. import std.io
    2. let joined = concurrent(timeout: 0ms) {
    3. left: 1
    4. right: 2
    5. } else {
    6. { left: 7, right: 8 }
    7. }
    8. io.writeLine("{joined.left}:{joined.right}")
    기대 출력종료 코드 0
    7:8
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 7:8

    A zero-duration fallback can raise its own runtime fault

    example.tpzA zero-duration fallback can raise its own runtime fault
    1. function divide(divisor: int) -> int {
    2. 42 / divisor
    3. }
    4. let joined = concurrent(timeout: 0ms) {
    5. value: 1
    6. } else {
    7. { value: divide(0) }
    8. }
    기대 출력종료 코드 1
    표준 출력 없음.
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    거절 단계 run. 종료 코드 1.

    검토한 대안

    • 마지막 확인에서 본 완료에 우선권을 준다. 결과가 시간 경계보다 마지막 확인 시점에 따라 달라집니다.
    • 마감과 완료가 겹칠 때의 결과를 보장하지 않는다. 0ms와 동시 완료의 결과를 정해야 같은 프로그램이 같은 결과를 냅니다.

    이유

    경계에 걸친 성공과 대체 결과 중 어느 쪽을 받는지 알 수 있습니다.

    바뀐 규칙 Deadline priority and competing faults →

    해결한 미정 항목 Zero duration and competing outcomes →

    동시 실행의 갈래는 바깥 함수나 반복문으로 이동하지 않습니다

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

    문제

    동시에 실행하는 한 갈래가 바깥 함수에서 반환하면 다른 갈래의 동작도 정해야 합니다. 갈래 안에서만 일어나는 반환과 반복 이동은 그 문제가 없습니다.

    결정

    갈래 밖의 함수나 반복문을 대상으로 하는 반환, 반복 제어, 오류 전파는 정적으로 거절합니다.

    예제

    Called functions and inner loops consume their own control transfer

    example.tpzCalled functions and inner loops consume their own control transfer플레이그라운드 열기 →
    1. import std.io
    2. function advance(value: Result<int, string>) -> Result<int, string> {
    3. let number: int = value?
    4. return Ok(number + 1)
    5. }
    6. let joined = concurrent {
    7. result: advance(Err("missing"))
    8. count: {
    9. let mut count = 0
    10. while (count < 3) {
    11. count += 1
    12. if (count < 3) { continue }
    13. break
    14. }
    15. count
    16. }
    17. }
    18. match (joined.result) {
    19. case Ok(_) => io.writeLine("unexpected")
    20. case Err(message) => io.writeLine(message)
    21. }
    22. io.writeLine("{joined.count}")
    기대 출력종료 코드 0
    missing
    3
    
    $ topaz run example.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. missing
    2. 3

    An arm cannot return from its enclosing function

    example.tpzAn arm cannot return from its enclosing function
    1. function escape() -> int {
    2. let joined = concurrent {
    3. value: {
    4. return 1
    5. }
    6. }
    7. 0
    8. }
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5001 →

      concurrent-arm-function-boundary at example.tpz:4:13

    An arm cannot break its enclosing loop

    example.tpzAn arm cannot break its enclosing loop
    1. while (true) {
    2. let joined = concurrent {
    3. value: {
    4. break
    5. }
    6. }
    7. break
    8. }
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5001 →

      concurrent-arm-loop-boundary at example.tpz:4:13

    An arm cannot continue its enclosing loop

    example.tpzAn arm cannot continue its enclosing loop
    1. while (true) {
    2. let joined = concurrent {
    3. value: {
    4. continue
    5. }
    6. }
    7. break
    8. }
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5001 →

      concurrent-arm-loop-boundary at example.tpz:4:13

    An arm cannot propagate a Result to its enclosing function

    example.tpzAn arm cannot propagate a Result to its enclosing function
    1. function escape(value: Result<int, string>) -> Result<int, string> {
    2. let joined = concurrent {
    3. result: value?
    4. }
    5. Ok(0)
    6. }
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check example.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5001 →

      concurrent-arm-function-boundary at example.tpz:3:17

    검토한 대안

    • 갈래에서 바깥으로 이동할 때 형제 갈래를 취소한다. 한 갈래의 반환과 형제의 취소를 함께 정의해야 합니다.
    • 갈래 자체의 return과 Result 의미를 정의한다. 지금 실행기의 갈래 경계와 맞지 않고 새 제어 의미를 만들어야 합니다.

    이유

    한 갈래의 제어 이동을 소스에서 독립적으로 읽을 수 있습니다.

    바뀐 규칙 Each arm has its own control boundary →

    해결한 미정 항목 Control transfer and propagation across an arm boundary →

    시간 제한 그룹은 끝나지 않는 갈래가 있어도 대체 결과로 끝납니다

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

    문제

    무한 반복이나 깊은 재귀에 빠진 갈래를 기다리면 그룹이 끝나지 않습니다. 호출자는 이미 실행한 외부 작업에 어떤 영향이 있는지도 알아야 합니다.

    결정

    • 시간 제한을 넘기면 concurrent 그룹은 대체 경로로 끝납니다.
    • 진행 중인 호스트 호출은 완료까지 기다립니다. 그룹이 끝난 뒤 버려진 갈래는 효과를 일으키지 않으며 기존 효과는 남습니다.
    • 시간 제한이 없는 그룹은 실행 순서의 공정성을 보장하지 않습니다.

    예제

    A positive deadline ends an infinite loop

    main.tpzA positive deadline ends an infinite loop플레이그라운드 열기 →
    1. import std.io
    2. let joined = concurrent(timeout: 1ms) {
    3. value: {
    4. while (true) {}
    5. 0
    6. }
    7. } else {
    8. io.writeLine("fallback")
    9. { value: 7 }
    10. }
    11. io.writeLine("{joined.value}")
    기대 출력종료 코드 0
    fallback
    7
    
    $ topaz run main.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. fallback
    2. 7

    검토한 대안

    • 마감 시간에 호스트 호출을 끊는다. 동기 호스트 호출까지 중간에 끊어야 하는 별도 약속이 생깁니다.
    • 시간 제한 없는 그룹도 공정하게 번갈아 실행한다. 일반 코드 전체에 실행을 양보할 지점의 비용이 생깁니다.

    이유

    시간 제한을 사용하면 끝나지 않는 언어 코드에서 벗어나는 경로를 확보할 수 있습니다.

    바뀐 규칙 Timed group progress →

    일부 답한 미정 항목 Deferred cleanup in abandoned arms →

    시간 제한으로 중단된 갈래는 사용자 정리를 실행하지 않습니다

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

    문제

    시간 제한이 끝났는데 갈래의 정리가 다시 오래 걸리면 호출자는 결과를 받을 수 없습니다. 중단된 갈래가 연 파일도 어떻게 닫히는지 알아야 합니다.

    결정

    • 마감으로 중단된 concurrent 갈래는 남은 defer 코드와 using 정리를 실행하지 않습니다.
    • 정상 종료와 return, break, continue, ?의 오류 전파에서는 언어 정리를 실행합니다.
    • 중단된 갈래가 연 호스트 자원은 그룹이 끝날 때 런타임이 회수합니다.

    예제

    An abandoned arm skips its registered defer

    main.tpzAn abandoned arm skips its registered defer플레이그라운드 열기 →
    1. import std.io
    2. let joined = concurrent(timeout: 1ms) {
    3. value: {
    4. defer { io.writeLine("abandoned cleanup") }
    5. while (true) {}
    6. 0
    7. }
    8. } else {
    9. io.writeLine("fallback")
    10. { value: 7 }
    11. }
    기대 출력종료 코드 0
    fallback
    
    $ topaz run main.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. fallback

    A normally completed arm runs its defer before the result

    main.tpzA normally completed arm runs its defer before the result플레이그라운드 열기 →
    1. import std.io
    2. let joined = concurrent(timeout: 10s) {
    3. value: {
    4. defer { io.writeLine("completed cleanup") }
    5. 7
    6. }
    7. } else {
    8. io.writeLine("fallback")
    9. { value: 0 }
    10. }
    11. io.writeLine("{joined.value}")
    기대 출력종료 코드 0
    completed cleanup
    7
    
    $ topaz run main.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. completed cleanup
    2. 7

    Completed cleanup followed by an abandoned arm

    main.tpzCompleted cleanup followed by an abandoned arm플레이그라운드 열기 →
    1. import std.io
    2. let completed = concurrent {
    3. value: {
    4. defer { io.writeLine("completed cleanup") }
    5. 1
    6. }
    7. }
    8. let abandoned = concurrent(timeout: 1s) {
    9. value: {
    10. defer { io.writeLine("abandoned cleanup") }
    11. while (true) {}
    12. 0
    13. }
    14. } else {
    15. io.writeLine("fallback")
    16. { value: 0 }
    17. }
    기대 출력종료 코드 0
    completed cleanup
    fallback
    
    $ topaz run main.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. completed cleanup
    2. fallback

    검토한 대안

    • 중단된 갈래도 정리 코드를 실행한다. 정리 코드가 멈추면 시간 제한 뒤에도 그룹이 끝나지 않습니다.
    • 정리 실행 여부를 구현에 맡긴다. 실행 대상에 따라 같은 그룹의 정리 효과가 달라집니다.

    이유

    정리 함수가 느리거나 멈춰도 중단된 갈래 때문에 호출자가 기다리는 시간을 더 늘리지 않습니다.

    바뀐 규칙 Deadline abandonment skips language cleanup →Runtime reclamation of abandoned arm handles →

    해결한 미정 항목 Deferred cleanup in abandoned arms →

    모듈 어디서나 같은 문장 규칙을 씁니다

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

    문제

    직접 실행한 파일에서 되던 문장이 모듈로 가져오면 빠질 수 있었습니다. 파일 역할만 바꿔도 초기화 동작을 다시 알아야 했습니다.

    결정

    • 진입 파일과 가져온 파일에 같은 최상위 문장 규칙을 씁니다.
    • 의존성을 먼저 초기화하고 준비된 이름을 순서대로 처리합니다. 실행당 초기화는 한 번이며, 순환은 초기화 전에 TPZ3006으로 거절합니다.

    예제

    Free calls, assignments, and loops in an entry

    helpers.tpzFree calls, assignments, and loops in an entry플레이그라운드 열기 →
    1. import std.io
    2. export let value: int = 1
    3. let mut count: int = 0
    4. io.writeLine("free")
    5. for item in ([1]) {
    6. count = count + item
    7. io.writeLine("loop")
    8. }
    9. io.writeLine("{count}")
    기대 출력종료 코드 0
    free
    loop
    1
    
    $ topaz run helpers.tpz --language-version 6.0
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. free
    2. loop
    3. 1

    The same source file imported

    main.tpzThe same source file imported
    1. import helpers
    2. import std.io
    3. io.writeLine("{helpers.value}")
    기대 출력종료 코드 0
    free
    loop
    1
    1
    
    $ topaz run main.tpz --language-version 6.0
    helpers.tpzThe same source file imported
    1. import std.io
    2. export let value: int = 1
    3. let mut count: int = 0
    4. io.writeLine("free")
    5. for item in ([1]) {
    6. count = count + item
    7. io.writeLine("loop")
    8. }
    9. io.writeLine("{count}")
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. free
    2. loop
    3. 1
    4. 1

    검토한 대안

    • 가져온 파일에서는 별도의 초기화 함수만 실행한다. 같은 코드를 진입점과 모듈에 둘 때 초기화 문법을 다르게 써야 합니다.
    • 가져오는 파일의 문장을 지금처럼 거른다. 파일 역할에 따라 문장 규칙이 갈립니다.

    이유

    파일을 가져오도록 바꿔도 어떤 문장이 실행되는지 같은 기준으로 읽을 수 있습니다.

    바뀐 규칙 The same statements in every source file →Dependency order and one initialization →Reject cycles before initialization →

    컴파일러가 만든 이름은 사용자 코드에서 쓸 수 없습니다

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

    문제

    표준 모듈 std.lispex에는 규칙 팩토리를 구현하려고 컴파일러가 만든 타입 __PreparedLispexRuleCarrier가 있습니다. 사용자 코드가 import std.lispex { __PreparedLispexRuleCarrier }로 이 이름을 가져오면 컴파일러가 진단 대신 내부 오류로 멈췄습니다. 컴파일러가 만든 이름을 사용자 코드가 쓸 수 있는지 정한 규칙이 없었습니다.

    결정

    • 컴파일러가 만든 선언은 사용자 코드가 이름으로 쓸 수 없습니다. 표준 모듈 안에서 이름이 __로 시작하는 생성 선언이 여기에 속합니다. 이런 선언의 타입은 그 모듈의 공개 별칭(PreparedLispexRule 등)을 거쳐서만 공개 표면에 나타나며, 이 공개 별칭은 비공개 타입 노출(TPZ3014)이 아닙니다.
    • 사용자 코드가 이름을 골라 가져오거나 네임스페이스 경로로 그 이름을 쓰면 이름 해석 단계의 TPZ3009입니다. 모듈이 내보내지 않는 다른 이름과 같은 진단이며 내부 오류로 이어지지 않습니다.
    • 생성 선언은 같은 표준 모듈 안의 구현과 컴파일러가 만든 코드만 씁니다. 사용자 코드에 철자가 같은 선언이 있으면 이 결정과 상관없이 일반 규칙을 따릅니다.

    검토한 대안

    • 생성 이름을 사용자 코드가 쓸 수 있게 둔다. 구현 세부가 사용자 계약이 됩니다. 이 이름을 공개하면 지금 구현에서는 정상 프로그램도 내부 오류로 멈춥니다.
    • 생성 이름을 가져오는 코드를 내부 오류로 둔다. 사용자 코드 때문에 컴파일러 내부 오류가 나면 진단 계약을 어깁니다.

    이유

    공개 표면은 사용자가 기대어 쓸 수 있는 계약입니다. 컴파일러가 구현을 위해 만든 이름이 밖으로 새어 나가면 구현을 바꿀 때마다 사용자 프로그램이 깨집니다.

    바뀐 규칙 Public and private declarations →Namespace imports and selected exports →Visibility through a namespace →

    공개 let은 일반 패턴으로 이름을 묶습니다

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

    문제

    여러 값을 분해해 공개할 때 이름을 하나씩 다시 선언해야 하면 초기화가 중복될 수 있습니다. 공개되지 않는 분해와 같은 패턴을 쓰고 싶을 수 있습니다.

    결정

    • export let은 일반 불변 let의 패턴으로 바인딩하고 그 이름을 모두 공개합니다.
    • 초기화는 한 번입니다. 패턴이 모두 맞은 뒤 이름을 설치하고 공개 타입을 검사합니다. 묶는 이름이 없으면 TPZ2007입니다.

    예제

    Export every record binding after one initializer

    main.tpzExport every record binding after one initializer
    1. import lib
    2. import std.io { writeLine }
    3. writeLine("{lib.first}")
    4. writeLine("{lib.second}")
    기대 출력종료 코드 0
    init
    10
    20
    
    $ topaz run main.tpz --language-version 6.0
    lib.tpzExport every record binding after one initializer
    1. import std.io { writeLine }
    2. function make() -> { first: int, second: int } {
    3. writeLine("init")
    4. { first: 10, second: 20 }
    5. }
    6. export let { first: first, second: second } = make()
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. init
    2. 10
    3. 20

    An outer pattern annotation supplies each public binding type

    main.tpzAn outer pattern annotation supplies each public binding type
    1. import lib { count, label }
    2. let number: int = count
    3. let text: string = label
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzAn outer pattern annotation supplies each public binding type
    1. export let { nested: { count: count }, label: label }: { nested: { count: int }, label: string } = { nested: { count: 4 }, label: "four" }
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    Export names from an ordinary nominal record pattern

    main.tpzExport names from an ordinary nominal record pattern
    1. import lib
    2. import std.io { writeLine }
    3. writeLine("{lib.first + lib.second}")
    기대 출력종료 코드 0
    42
    
    $ topaz run main.tpz --language-version 6.0
    lib.tpzExport names from an ordinary nominal record pattern
    1. record Pair { first: int, second: int }
    2. export let Pair { first: first, second: second } = Pair { first: 20, second: 22 }
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 42

    Use plain let when a pattern publishes no binding

    main.tpzUse plain let when a pattern publishes no binding플레이그라운드 열기 →
    1. export let _ = 1
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    Export preserves the ordinary refutable-let rejection

    main.tpzExport preserves the ordinary refutable-let rejection
    1. let maybe: Option<int> = None()
    2. export let Some(value) = maybe
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5026 →

      diagnostics-refutable-let-pattern at main.tpz:2:12

    Each bound name must have a public resolved type

    main.tpzEach bound name must have a public resolved type
    1. import lib
    2. let observed = lib.count
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzEach bound name must have a public resolved type
    1. record Hidden { value: int }
    2. export let { item: item, count: count } = { item: Hidden { value: 1 }, count: 2 }
    기대 결과

    기대 결과

    거절 단계 resolve. 종료 코드가 0이 아닙니다.

    • TPZ3014 →

      modules-public-private-nominal at lib.tpz:2:20

    검토한 대안

    • 공개 let에는 이름 하나만 허용한다. 같은 데이터를 공개하려면 분해와 선언을 다시 써야 합니다.
    • 별도 export 목록으로 공개할 이름을 정한다. 공개 여부 때문에 분해를 다시 쓰지 않아야 합니다.

    이유

    분해할 때 쓴 구조가 이름을 공개할 때도 그대로 읽힙니다.

    바뀐 규칙 The shape of an exported binding →Exported bindings are immutable →

    공개 선언은 해석된 타입으로 검사합니다

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

    문제

    공개 함수에 타입 주석을 쓰거나 추론에 맡길 수 있습니다. 주석 유무에 따라 같은 비공개 타입의 노출이 허용되면 공개 계약이 달라집니다.

    결정

    • 공개 표면에서 해석된 타입을 검사합니다. 모듈의 비공개 명목 타입이 노출되면 TPZ3014입니다.
    • 투명 별칭을 펼쳐 공개 타입이 나오면 허용합니다.

    예제

    An explicit public result cannot expose a private nominal type

    main.tpzAn explicit public result cannot expose a private nominal type
    1. import lib
    2. let value = lib.make()
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzAn explicit public result cannot expose a private nominal type
    1. record Hidden { value: int }
    2. export function make() -> Hidden { Hidden { value: 7 } }
    기대 결과

    기대 결과

    거절 단계 resolve. 종료 코드가 0이 아닙니다.

    • TPZ3014 →

      modules-public-private-nominal at lib.tpz:2:27

    An inferred public result obeys the same visibility rule

    main.tpzAn inferred public result obeys the same visibility rule
    1. import lib
    2. let value = lib.make()
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzAn inferred public result obeys the same visibility rule
    1. record Hidden { value: int }
    2. export function make() { Hidden { value: 7 } }
    기대 결과

    기대 결과

    거절 단계 resolve. 종료 코드가 0이 아닙니다.

    • TPZ3014 →

      modules-public-private-nominal at lib.tpz:2:17

    An alias expansion cannot hide a private nominal result

    main.tpzAn alias expansion cannot hide a private nominal result
    1. import lib
    2. let value = lib.make()
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzAn alias expansion cannot hide a private nominal result
    1. record Hidden { value: int }
    2. type Alias = Hidden
    3. export function make() -> Alias { Hidden { value: 7 } }
    기대 결과

    기대 결과

    거절 단계 resolve. 종료 코드가 0이 아닙니다.

    • TPZ3014 →

      modules-public-private-nominal at lib.tpz:3:27

    A private alias of a public type is transparent

    main.tpzA private alias of a public type is transparent
    1. import lib
    2. let value: int = lib.count()
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzA private alias of a public type is transparent
    1. type Count = int
    2. export function count() -> Count { 1 }
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    검토한 대안

    • 모든 공개 이름에 타입 주석을 강제한다. 같은 타입을 추론할 수 있는 코드에도 결과를 다시 적어야 합니다.
    • 해석된 타입 대신 지금처럼 문법 형태만 검사한다. 주석을 썼는지에 따라 결과가 갈리지 않아야 합니다.

    이유

    공개 여부는 타입으로 정해지고 주석을 쓰는 방식과 무관합니다.

    바뀐 규칙 Resolved public type visibility →

    레코드의 기본값도 공개 이름의 경계를 따릅니다

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

    문제

    다른 모듈의 이름을 레코드 기본값에서 읽을 수 있는지 확인하려면 공개 범위를 봐야 합니다. 기본값에서만 비공개 이름을 받으면 같은 접근을 다르게 읽습니다.

    결정

    레코드 기본값의 이름 접근에 일반 모듈 가시성 규칙을 적용합니다.

    예제

    Reject a private value in a record default

    main.tpzReject a private value in a record default
    1. import std.io
    2. import defaults
    3. record Item {
    4. value: int = defaults.seed
    5. }
    6. let item = Item {}
    7. io.writeLine("{item.value}")
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    defaults.tpzReject a private value in a record default
    1. export let visible: int = 0
    2. let seed: int = 41
    3. let mut state: int = 42
    4. type Secret = int
    기대 결과

    기대 결과

    거절 단계 resolve. 종료 코드가 0이 아닙니다.

    • TPZ3009 →

      record-default-private-immutable-member at main.tpz:4:27

    Use an exported value in a record default

    main.tpzUse an exported value in a record default
    1. import std.io
    2. import defaults
    3. record Item {
    4. value: int = defaults.seed
    5. }
    6. let item = Item {}
    7. io.writeLine("{item.value}")
    기대 출력종료 코드 0
    41
    
    $ topaz run main.tpz --language-version 6.0
    defaults.tpzUse an exported value in a record default
    1. export let visible: int = 0
    2. export let seed: int = 41
    3. let mut state: int = 42
    4. type Secret = int
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 41

    A record default cannot read a private mutable value

    main.tpzA record default cannot read a private mutable value
    1. import defaults
    2. record Item {
    3. value: int = defaults.state
    4. }
    5. let item = Item {}
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    defaults.tpzA record default cannot read a private mutable value
    1. export let visible: int = 0
    2. let seed: int = 41
    3. let mut state: int = 42
    4. type Secret = int
    기대 결과

    기대 결과

    거절 단계 resolve. 종료 코드가 0이 아닙니다.

    • TPZ3009 →

      record-default-private-mutable-member at main.tpz:3:27

    A default value does not grant access to a private type

    main.tpzA default value does not grant access to a private type
    1. import defaults
    2. record Item {
    3. value: int = {
    4. let saved: defaults.Secret = 1
    5. saved
    6. }
    7. }
    8. let item = Item {}
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    defaults.tpzA default value does not grant access to a private type
    1. export let visible: int = 0
    2. let seed: int = 41
    3. let mut state: int = 42
    4. type Secret = int
    기대 결과

    기대 결과

    거절 단계 resolve. 종료 코드가 0이 아닙니다.

    • TPZ3009 →

      record-default-private-type-member at main.tpz:4:29

    검토한 대안

    • 기본값에서만 비공개 이름을 열어 준다. 이름을 읽는 위치에 따라 같은 공개 경계가 달라집니다.

    이유

    기본값에 쓰인 이름의 가시성을 다른 접근과 같은 방법으로 확인합니다.

    바뀐 규칙 Record defaults respect module privacy →

    as는 가져온 이름이 실제로 바뀔 때만 씁니다

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

    문제

    모듈이나 값을 원래 이름으로 가져오면서 같은 이름의 별칭을 쓰면 이름이 바뀌었는지 한 번 더 비교해야 합니다. 별칭 표기에 역할을 하나 정합니다.

    결정

    as로 기본 이름을 그대로 반복하면 TPZ2009로 거절합니다. 실제로 새 이름을 쓸 때만 as를 붙입니다.

    예제

    Reject a namespace alias repeating its default name

    main.tpzReject a namespace alias repeating its default name
    1. import lib as lib
    2. let result: int = lib.value
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzReject a namespace alias repeating its default name
    1. export let value: int = 1
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    Omit the namespace alias to keep its default name

    main.tpzOmit the namespace alias to keep its default name
    1. import lib
    2. let result: int = lib.value
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzOmit the namespace alias to keep its default name
    1. export let value: int = 1
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    Reject a selected alias repeating its source name

    main.tpzReject a selected alias repeating its source name
    1. import lib { value as value }
    2. let result: int = value
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzReject a selected alias repeating its source name
    1. export let value: int = 1
    기대 결과

    기대 결과

    거절 단계 parse. 종료 코드가 0이 아닙니다.

    Omit the selected alias to keep its source name

    main.tpzOmit the selected alias to keep its source name
    1. import lib { value }
    2. let result: int = value
    기대 출력종료 코드 0
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0 --format json
    lib.tpzOmit the selected alias to keep its source name
    1. export let value: int = 1
    기대 결과

    기대 결과

    검사가 프로그램을 받아들입니다. 종료 코드 0.

    검토한 대안

    • 같은 이름을 되풀이하는 별칭도 허용한다. 똑같은 가져오기에 별칭이 있는 형태와 없는 형태가 남습니다.
    • 모든 가져오기에 별칭을 요구한다. 같은 가져오기를 쓰는 방법이 하나여야 합니다.

    이유

    별칭을 보면 새 이름을 쓴 자리임을 바로 알 수 있습니다.

    바뀐 규칙 An alias changes the local name →

    가져온 값의 바인딩은 수정할 수 없습니다

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

    문제

    외부 모듈에서 가져온 배열을 바꾸고 싶을 때가 있습니다. 모듈 밖에서 바뀌는 값과 같은 파일 핸들이 공유하는 상태를 구별해야 합니다.

    결정

    • 가져온 값의 바인딩은 불변입니다. let mut x = imported를 쓰면 수정 가능한 별도 값이 생깁니다.
    • 가져온 File 같은 호스트 자원 핸들만 상태를 공유합니다.

    예제

    A mutable local leaves the exported array unchanged

    main.tpzA mutable local leaves the exported array unchanged
    1. import std.io
    2. import helpers { items }
    3. let mut local = items
    4. local.push(3)
    5. io.writeLine("{items.length}:{local.length}")
    기대 출력종료 코드 0
    2:3
    
    $ topaz run main.tpz --language-version 6.0
    helpers.tpzA mutable local leaves the exported array unchanged
    1. export let items = [1, 2]
    기대 결과

    기대 결과

    실행을 마칩니다. 종료 코드 0.

    기대 표준 출력
    1. 2:3

    An imported array has an immutable root

    main.tpzAn imported array has an immutable root
    1. import helpers { items }
    2. items[0] = 9
    기대 출력0이 아닌 종료 코드
    표준 출력 없음.
    $ topaz check main.tpz --language-version 6.0
    helpers.tpzAn imported array has an immutable root
    1. export let items = [1, 2]
    기대 결과

    기대 결과

    거절 단계 check. 종료 코드가 0이 아닙니다.

    • TPZ5003 →

      bindings-assignment-to-immutable at main.tpz:2:1

    이유

    배열을 가져온 모듈은 원본을 수정하지 않고 자기 값을 편집할 수 있습니다.

    바뀐 규칙 Imported values →Rebinding imported declarations →

    해결한 미정 항목 Mutation through imported values →