boot

type API struct {
	// Required.
	//
	// ID is the stable component identifier used inside the bootstrap graph.
	//
	// RU: ID — стабильный идентификатор компонента внутри bootstrap-графа.
	ID string
	// Optional.
	//
	// Field overrides the generated Runtime field name.
	// When empty, the runtime derives it from ID.
	//
	// RU: Field переопределяет имя поля в generated Runtime.
	// Если поле пустое, runtime выводит его из ID.
	Field string
	// Required.
	//
	// Constructor points to the package-level constructor used to build the component.
	// Must point to a package-level function.
	//
	// RU: Constructor указывает на package-level constructor, который создаёт компонент.
	// Должно указывать на package-level функцию.
	Constructor any
}

type Input struct {
	// Required.
	// ID is the stable input identifier used inside the bootstrap graph.
	// RU: ID — стабильный идентификатор input внутри bootstrap-графа.
	ID string
	// Optional.
	// Field overrides the generated Runtime field name.
	// When empty, the runtime derives it from ID.
	// RU: Field переопределяет имя поля в generated Runtime.
	// Если поле пустое, runtime выводит его из ID.
	Field string
	// Required.
	// Prototype points to the input type prototype used for type resolution.
	// Must point to the final input type.
	// RU: Prototype указывает на прототип типа input для type-resolution.
	// Должно указывать на итоговый input type.
	Prototype any
	// Optional.
	// Prefix overrides the environment-variable prefix used to load the input.
	// When empty, the runtime derives the env prefix from input ID.
	// RU: Prefix переопределяет префикс env-переменных, используемый для загрузки input.
	// Если поле пустое, runtime выводит env prefix из input ID.
	Prefix string
	// Optional.
	// EnvPreset optionally points to an env preset type that should be loaded before conversion.
	// Use together with Mapper or with default field-by-field conversion.
	// RU: EnvPreset при необходимости указывает на тип env preset, который нужно загрузить до конверсии.
	// Используется вместе с Mapper или с дефолтной field-by-field конверсией.
	EnvPreset any
	// Optional.
	// Mapper optionally points to a preset-to-input mapper function.
	// Requires EnvPreset.
	// RU: Mapper при необходимости указывает на функцию преобразования preset -> input.
	// Требует EnvPreset.
	Mapper any
	// Optional.
	// Loader optionally points to a custom input loader function.
	// Alternative to EnvPreset + Mapper.
	// RU: Loader при необходимости указывает на кастомную функцию загрузки input.
	// Альтернатива связке EnvPreset + Mapper.
	Loader any
}

type Inventory struct {
	// Optional.
	//
	// Managed enables inventory expansion from Depsmith project bindings.
	// When false, only manually declared APIs/Repos/URLs are used.
	//
	// RU: Managed включает разворачивание inventory из binding'ов Depsmith-проекта.
	// Если false, используются только вручную объявленные APIs/Repos/URLs.
	Managed bool
}

type Repo struct {
	// Required.
	//
	// ID is the stable component identifier used inside the bootstrap graph.
	//
	// RU: ID — стабильный идентификатор компонента внутри bootstrap-графа.
	ID string
	// Optional.
	//
	// Field overrides the generated Runtime field name.
	// When empty, the runtime derives it from ID.
	//
	// RU: Field переопределяет имя поля в generated Runtime.
	// Если поле пустое, runtime выводит его из ID.
	Field string
	// Required.
	//
	// Constructor points to the package-level constructor used to build the component.
	// Must point to a package-level function.
	//
	// RU: Constructor указывает на package-level constructor, который создаёт компонент.
	// Должно указывать на package-level функцию.
	Constructor any
}

type Spec struct {
	// Optional.
	//
	// Inventory controls how API/repo/url inventory is sourced for this bootstrap.
	// Zero value keeps inventory fully manual.
	//
	// RU: Inventory управляет тем, откуда берётся inventory API/repo/url для этого bootstrap.
	// Нулевое значение оставляет inventory полностью ручным.
	Inventory Inventory
	// Optional.
	//
	// APIs lists manually declared API components.
	//
	// RU: APIs содержит вручную объявленные API-компоненты.
	APIs []API
	// Optional.
	//
	// Repos lists manually declared repository components.
	//
	// RU: Repos содержит вручную объявленные repository-компоненты.
	Repos []Repo
	// Optional.
	//
	// Steps lists manually declared step components.
	//
	// RU: Steps содержит вручную объявленные step-компоненты.
	Steps []Step
	// Optional.
	//
	// URLs lists manual URL definitions and overrides.
	// Managed API inventory can also contribute URL definitions automatically.
	//
	// RU: URLs содержит ручные URL-определения и override-настройки.
	// Managed inventory API также может автоматически добавлять URL-определения.
	URLs []URL
	// Optional.
	//
	// Inputs lists manual input definitions.
	//
	// RU: Inputs содержит ручные input-определения.
	Inputs []Input
}

type Step struct {
	// Optional.
	//
	// ID is the stable component identifier used inside the bootstrap graph.
	// When empty, the runtime derives it from the step constructor package name.
	//
	// RU: ID — стабильный идентификатор компонента внутри bootstrap-графа.
	// Если поле пустое, runtime выводит его из имени package у step constructor.
	ID string
	// Optional.
	//
	// Field overrides the generated Runtime field name.
	// When empty, the runtime derives it from the effective step ID.
	//
	// RU: Field переопределяет имя поля в generated Runtime.
	// Если поле пустое, runtime выводит его из итогового step ID.
	Field string
	// Required.
	//
	// Constructor points to the package-level step constructor.
	// Supported signatures are func()..., func(Deps)..., func(context.Context)...,
	// or func(context.Context, Deps)...
	// RU: Constructor указывает на package-level constructor step-компонента.
	// Поддерживаются сигнатуры func()..., func(Deps)...,
	// func(context.Context)... и func(context.Context, Deps)...
	Constructor any
	// Required.
	// URLs selects how string URL fields inside the step deps struct are resolved.
	// Every step must set it, even when the step has no URL fields.
	// Use URLsNone() when the step does not need URLs.
	// RU: URLs выбирает, как резолвятся string URL-поля внутри step deps struct.
	// Это поле обязательно для каждого step, даже если у step нет URL-полей.
	// Используйте URLsNone(), если step не требует URL-зависимостей.
	URLs URLStrategy
}

type URL struct {
	// Required.
	// ID is the stable URL identifier used inside the bootstrap graph.
	// RU: ID — стабильный идентификатор URL внутри bootstrap-графа.
	ID string
	// Optional.
	// Field overrides the generated Runtime field name.
	// When empty, the runtime derives it from ID.
	// RU: Field переопределяет имя поля в generated Runtime.
	// Если поле пустое, runtime выводит его из ID.
	Field string
	// Optional.
	// Prefix overrides the environment-variable prefix used to load the URL.
	// When empty, the runtime derives the env prefix from URL ID.
	// RU: Prefix переопределяет префикс env-переменных, используемый для загрузки URL.
	// Если поле пустое, runtime выводит env prefix из URL ID.
	Prefix string
}

type URLBinding struct {
	// Required.
	//
	// Field is the exported deps struct field name.
	//
	// RU: Field — имя exported-поля deps struct.
	Field string
	// Required.
	//
	// URLID is the target URL identifier from the bootstrap inventory.
	// RU: URLID — целевой идентификатор URL из bootstrap inventory.
	URLID string
}

type URLMode string

type URLStrategy struct {
	// Required.
	// Mode selects the resolution strategy for URL fields.
	// RU: Mode выбирает стратегию резолва URL-полей.
	Mode URLMode
	// Optional.
	// Bindings lists explicit URL bindings used in manual mode.
	// In manual mode, every URL field must be listed explicitly.
	// RU: Bindings содержит явные URL-binding'и для manual-режима.
	// В manual-режиме каждое URL-поле нужно перечислить явно.
	Bindings []URLBinding
}