Перейти к содержимому
Топаздокументация

Поиск в документации

Спецификация 6.0

Выберите результат стрелками и нажмите Enter, чтобы открыть его.

Введите имя API, номер диагностики, правило или тему проекта.

    Загрузка →

    Проектные решения

    Ошибки, конкурентность и модули

    Для невыводимого типа ошибки Result требуется аннотация

    Принято 9 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Тип успешного значения может быть известен, а данных для вывода типа ошибки недостаточно. Подстановка широкого типа скрыла бы ограничение при вызове.

    Решение

    Если тип ошибки вывести невозможно, проверка выдаёт 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()
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check main.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • 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 →

    Обратный вызов возвращает собственную переданную ошибку

    Принято 10 ноября 2026 г. · 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. }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check main.tpz --language-version 6.0
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5001 →

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

    Рассмотренные варианты

    • Возвращаться сразу из внешней функции. Вызывающей стороне пришлось бы обрабатывать нелокальную передачу управления.
    • Не определять, куда передаёт управление ?. У каждой границы функции должно быть одно назначение для ?, чтобы один и тот же код читался одинаково.

    Причина

    Ближайшее тело функции показывает, откуда возвращается ?.

    Изменённые правила Propagation returns from the current callable →

    Решённые открытые вопросы Return inference and nested callable contexts →

    Пустая параллельная группа возвращает пустую запись

    Принято 7 ноября 2026 г. · 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 {}
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5001 →

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

    Рассмотренные варианты

    • Требовать хотя бы одну ветвь. Для нуля ветвей пришлось бы ввести исключение из правила результата.

    Причина

    Соответствие между ветвями и полями действует и для пустой группы.

    Изменённые правила Concurrent groups may contain zero arms →

    Ограничение времени вычисляет выражение Duration один раз

    Принято 7 ноября 2026 г. · 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 →

    При одновременном завершении и истечении срока побеждает срок

    Принято 7 ноября 2026 г. · 6.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 →

    Ветвь параллельного выполнения не передаёт управление наружу

    Принято 7 ноября 2026 г. · 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. }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • 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. }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • 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. }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • 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. }
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check example.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • 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 →

    Группа с тайм-аутом завершится даже при бесконечной ветви

    Принято 9 ноября 2026 г. · 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 →

    Ветвь, прерванная по тайм-ауту, пропускает пользовательскую очистку

    Принято 10 ноября 2026 г. · 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 →

    Входные файлы и импортируемые модули используют одинаковые операторы

    Принято 7 ноября 2026 г. · 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 →

    Пользовательский код не может обращаться по имени к объявлениям, созданным компилятором

    Принято 20 ноября 2026 г. · 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 →

    Export let связывает имена обычным шаблоном

    Принято 7 ноября 2026 г. · 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
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check main.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения parse. Ненулевой код завершения.

    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
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check main.tpz --language-version 6.0 --format json
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • 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
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    • TPZ3014 →

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

    Рассмотренные варианты

    • Разрешить одно имя в экспортируемом let. Чтобы экспортировать те же данные, пришлось бы снова записать разбор и объявление.
    • Перечислять экспортируемые имена в отдельном списке. Экспорт не должен требовать переписывать деструктуризацию.

    Причина

    Структура разбора значения остаётся видна при экспорте.

    Изменённые правила The shape of an exported binding →Exported bindings are immutable →

    Публичные объявления проверяются после разрешения типов

    Принято 7 ноября 2026 г. · 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()
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    • 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()
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    • 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()
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    • 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 →

    Значения по умолчанию в записях соблюдают видимость экспорта

    Принято 7 ноября 2026 г. · 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}")
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    • 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 {}
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    • 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 {}
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    • TPZ3009 →

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

    Рассмотренные варианты

    • Разрешить закрытые имена только внутри значений по умолчанию. Граница экспорта будет зависеть от места чтения имени.

    Причина

    Видимость проверяется так же, как при обычном доступе.

    Изменённые правила Record defaults respect module privacy →

    As задаёт новое имя при импорте

    Принято 7 ноября 2026 г. · 6.0.0 · Проверяется

    Проблема

    Модуль или значение можно импортировать под исходным именем. Повторение имени после as заставляет сравнить две записи, прежде чем станет ясно, что имя не изменилось.

    Решение

    Пишите as только при переименовании. Повтор исходного имени вызывает TPZ2009.

    Примеры

    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
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    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
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ 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. Ненулевой код завершения.

    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 →

    Импортированные значения имеют неизменяемые привязки

    Принято 9 ноября 2026 г. · 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
    Ожидаемый выводНенулевой код завершения
    Нет стандартного вывода.
    $ topaz check main.tpz --language-version 6.0
    helpers.tpzAn imported array has an immutable root
    1. export let items = [1, 2]
    Ожидаемый результат

    Ожидаемый результат

    Этап отклонения check. Ненулевой код завершения.

    • TPZ5003 →

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

    Причина

    Импортирующий модуль может изменить собственный массив, сохранив значение экспортирующего модуля.

    Изменённые правила Imported values →Rebinding imported declarations →

    Решённые открытые вопросы Mutation through imported values →