wasm

type BuildConfig struct {
	// SrcDir is the directory containing the user's source files.
	SrcDir string

	// OutDir is the directory where generated files and the WASM binary
	// are written.
	OutDir string

	// PkgName is the Go package name for the build directory.
	PkgName string

	// ModulePath is the module path from the project's go.mod
	// (e.g., "github.com/cleat-team/cleat").
	ModulePath string

	// ProjectRoot is the absolute path to the project root (where go.mod lives).
	ProjectRoot string

	// GoVersion is the Go version from the project's go.mod (e.g., "1.26").
	GoVersion string

	// Outputs holds the generated file contents.
	Outputs *OutputFiles

	// WASMOutput is the filename for the compiled WASM binary
	// (e.g., "place_order.wasm").
	WASMOutput string

	// Target is the compilation target. Only "go" (standard Go/wasip1) is
	// currently supported.
	Target string

	// XfrmSource, if non-nil, provides transformed source files to write
	// instead of copying original source files. Keyed by filename.
	XfrmSource map[string][]byte
}

type ComponentBundle struct {
	// Modules are the raw core WASM binaries extracted from the component.
	Modules [][]byte

	// Instances describes how to instantiate each core module instance in the
	// component's instance DAG. The slice index IS the instance index.
	Instances []CoreInstance

	// Exports maps component-level export names (e.g. "handler") to the
	// specific instance and export that provides them.
	Exports map[string]ComponentExport

	// ImportModules lists the module names used in import sections across
	// all core modules (e.g. "env", "wasi_snapshot_preview1", "teavm").
	ImportModules []string
}

type ComponentExport struct {
	// Name is the component-level export name (e.g. "handler").
	Name string

	// Kind is the export kind: 0=func, 1=table, 2=memory, 3=global.
	Kind byte

	// InstanceIndex is the component instance index that provides this export.
	InstanceIndex int

	// ExportIndex is the index of the export within the instance's module.
	ExportIndex int
}

type CoreInstance struct {
	// ModuleIndex is the index into ComponentBundle.Modules. -1 means this
	// instance has no module of its own (FromExports-only alias).
	ModuleIndex int

	// Args maps each import module name that the module's WASM import section
	// declares to the source instance that supplies it.
	Args []InstantiateArg

	// FromExports lists export aliases that re-export exports from other
	// instances under different names.
	FromExports []ExportSpec
}

type ExportSpec struct {
	// Name is the export name in THIS instance (the alias).
	Name string

	// Kind is the export kind: 0=func, 1=table, 2=memory, 3=global.
	Kind byte

	// Index is the position within this instance's module's exports
	// (unused for FromExports-only instances).
	Index int

	// SourceInstance is the index of the source instance.
	SourceInstance int

	// SourceName is the export name in the source instance.
	SourceName string
}

type HostFunction struct {
	ImportName string // snake_case name used in //go:wasmimport
	FieldName  string // the HostCallsOptions field name (e.g., "DurableCall")
}

type InstantiateArg struct {
	// Name is the import module name the WASM binary uses, e.g. "env",
	// "wasi_snapshot_preview1", or a cross-module name like "libpython3.14.so".
	Name string

	// InstanceIndex is the index of the source instance in
	// ComponentBundle.Instances.
	InstanceIndex int
}

type LockEntry struct {
	Version int `json:"version"`
}

type LockFile struct {
	Version int                  `json:"version"`
	Policy  string               `json:"policy,omitempty"` // the binding policy used ("frozen", "stable", "latest", "tag:X")
	Entries map[string]LockEntry `json:"entries"`
}

type Metadata struct {
	WorkflowName         string            `json:"workflow_name"`
	WorkflowVersion      int               `json:"workflow_version"`
	ABIVersion           int               `json:"abi_version"`
	MinCompatibleVersion int               `json:"min_compatible_version"`
	PluginDeps           map[string]string `json:"plugin_deps,omitempty"`
	ChildVersions        map[string]int    `json:"child_versions,omitempty"`
	ChildBindingPolicy   string            `json:"child_binding_policy,omitempty"` // deployment channel / binding policy
	Language             string            `json:"language,omitempty"`
}

type OutputFiles struct {
	Imports string // gen_wasm_imports.go
	Memory  string // gen_wasm_memory.go
	Adapter string // gen_host_adapter.go
	Exports string // gen_wasm_exports.go
}

type ScannedImport struct {
	Module string // import module name (e.g. "env")
	Name   string // import field name (e.g. "cleat_call")
	Kind   byte   // 0 = func, 1 = table, 2 = mem, 3 = global
}

type UsageInfo struct {
	Used map[string]bool // keyed by ImportName

	// Funcs lists the HostFunction descriptors that are actually used,
	// in a stable order (by ImportName).
	Funcs []HostFunction

	// Children records child workflow names detected in the AST.
	// Keys are the first argument string literals of h.ChildWorkflow(name, ...),
	// h.ChildWorkflowWithOptions(name, ...), and h.ChildWorkflowTyped(name, ...).
	Children map[string]bool
}