API Reference › Program structure › namespace
keyword

namespace

namespace Name { export function foo(…) … internal function bar(…) … }

A namespace block declares a Name.* namespace once and controls its public surface declaratively, instead of annotating every function with @Namespace(Name) one at a time. Inside the block each function short(…) is emitted as namelower_short; an export function (the default) is callable from anywhere as Name.short(…), while an internal function is a private helper — emitted, and callable by its short name from other functions in the same block, but not part of the Name.* surface (calling Name.internalOne() is a compile error). It is the block sugar for the per-function @Namespace annotation, so a package's public API reads at a glance.

Sibling calls inside the block use the short name (base()), and the compiler rewrites them to the emitted name — so a namespace reads like a self-contained module.

Example

program Demo {
  namespace Combat {
    export function amount() -> int { return base() + 5 }
    internal function base() -> int { return 10 }
    export function double(n: int) -> int { return n + n }
  }
  entry {
    print(Combat.amount())      # 15
    print(Combat.double(21))    # 42
  }
}
← All symbols