toolchain

type EnsureOptions ¶

type EnsureOptions struct {
	GoOverride          string
	TinyGoOverride      string
	WasmToolsOverride   string
	MaterializeOverride string
	NeedGo              bool
	NeedTinyGo          bool
	NeedWasmTools       bool
	NeedMaterialize     bool
}

EnsureOptions selects the SDK tools needed by a command. An explicit tool path is deliberately never downloaded or replaced.

type EnsurePaths ¶

type EnsurePaths struct {
	Go          string
	TinyGo      string
	WasmTools   string
	Materialize string
}

EnsurePaths reports the resolved locations of tools that Ensure checked.

func Ensure(ctx context.Context, manifest sdk.Manifest, options EnsureOptions) (EnsurePaths, error)

type GoOptions ¶

type GoOptions struct {
	Override string
	Version  string
	Getenv   func(string) string
}

GoOptions configures the Go compiler selection.

type InstallMaterialToolOptions ¶ added in v0.0.2

type InstallMaterialToolOptions struct {
	Spec     MaterialToolSpec
	CacheDir string
	Platform string // Empty selects runtime.GOOS + "-" + runtime.GOARCH.
	Download func(context.Context, string) (io.ReadCloser, error)
}

type InstallTinyGoOptions ¶

type InstallTinyGoOptions struct {
	Version  string
	Artifact sdk.ToolArtifact
	CacheDir string
	Platform string
	Download func(context.Context, string) (io.ReadCloser, error)
}

InstallTinyGoOptions identifies a TinyGo release and where to install it.

type InstallWasmToolsOptions ¶

type InstallWasmToolsOptions struct {
	Version  string
	Artifact sdk.ToolArtifact
	CacheDir string
	Platform string
	Download func(context.Context, string) (io.ReadCloser, error)
}

InstallWasmToolsOptions identifies a wasm-tools release and where to install it.

type MaterialTool ¶ added in v0.0.2

type MaterialTool string

MaterialTool identifies a binary tool, not a source build or the Unity editor.

const (
	MaterialToolMaterialize MaterialTool = "materialize-cli" // AiGameKit Materialize Rust CLI.
)

type MaterialToolArtifact ¶ added in v0.0.2

type MaterialToolArtifact struct {
	URL        string
	SHA256     string
	Format     string // "zip"; never inferred from the URL.
	Executable string
}

MaterialToolArtifact describes a publisher-supplied, checksum-pinned archive. Executable is its exact slash-separated member path; all other regular files (including licenses and notices) are preserved alongside it.

type MaterialToolSpec ¶ added in v0.0.2

type MaterialToolSpec struct {
	Tool      MaterialTool
	Revision  string
	Artifacts map[string]MaterialToolArtifact
}

MaterialToolSpec pins a full Git commit and per-developer-platform artifacts. MaterializeSpec adapts optional released SDK pins to this installer contract; released SDKs select Materialize. No PATH fallback exists.

func MaterializeSpec(manifest sdk.Manifest) (MaterialToolSpec, error)

type TinyGoOptions ¶

type TinyGoOptions struct {
	Override string
	Version  string
	CacheDir string
	Getenv   func(string) string
}

TinyGoOptions supplies the supported TinyGo selection inputs.