language · language · Updated 2026-09-09

Using and external declarations

using imports a dotted package path. external makes an eligible top-level declaration visible outside its package.

Use using for a dependency you actually call and external only for the smallest intentional package API.

using package.path
external thing Name { ... }
external Function(...) { ... }

Status: stable

using dolphin.math
using dolphin.spatial3d

external DistanceToGoal(Vector3 position) -> float
{
    return DolphinDistance3(position, Vector3(3.0, 4.0, 0.0))
}
Console.Log(Text.From(DistanceToGoal(Vector3(0.0, 0.0, 0.0))))

manifestVersion = "2"
package = "api.example.language__using_external"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "dolphin.math"
version = "0.1.0"
path = "../../../dolphin/packages/math"

[[dependencies]]
package = "dolphin.spatial3d"
version = "0.1.0"
path = "../../../dolphin/packages/spatial3d"