render

type BundleRenderer any

type KernelModuleRenderer struct {
	// Kernel is the shared, long-lived library Kernel (one per process).
	Kernel *kernel.Kernel

	// Store holds the generated platform written by the PlatformReconciler.
	Store *platformstore.Store

	// Registry is passed through to moduleacquire.Acquire's retained registry
	// parameter and does not affect resolution: the Kernel resolves the
	// mapping it was constructed with (kernel.WithRegistry).
	Registry string

	// RuntimeName is the runtime identity injected into each transformer's
	// #context (e.g. "opm-controller").
	RuntimeName string
}

type KernelPackageRenderer struct {
	// Kernel is the shared, long-lived library Kernel (one per process). The
	// registry mapping it was constructed with resolves the package's imports.
	Kernel *kernel.Kernel

	// Store holds the generated platform written by the PlatformReconciler.
	Store *platformstore.Store

	// RuntimeName is the runtime identity injected into each transformer's
	// #context (e.g. "opm-controller").
	RuntimeName string
}

type ModuleRenderer interface {
	RenderModule(
		ctx context.Context,
		name, namespace, modulePath, moduleVersion string,
		values *releasesv1alpha1.RawValues,
	) (*RenderResult, error)
}

type PackageRenderer interface {
	Render(ctx context.Context, packageDir string) (kind string, result *RenderResult, err error)
}

type RenderResult struct {
	// Resources is the ordered list of rendered Kubernetes resources.
	Resources []*core.Resource

	// InventoryEntries are the CRD-typed inventory entries built from Resources.
	InventoryEntries []releasesv1alpha1.InventoryEntry

	// Warnings are the render's advisory findings, worded by the operator
	// (renderWarnings) from the diagnostics' rows: effectively-optional unhandled
	// traits and, under the Warn skew policy, catalog version skew. Unresolved
	// demands (undemandable resources, unhandled load-bearing traits) refuse the
	// render instead of landing here (0010:D28). The reconciler emits them as
	// RenderWarning events on transition, keyed on the rows below rather than on
	// these strings.
	Warnings []string

	// UnhandledTraits maps a component to the effectively-optional traits no
	// matched transformer handles, as the build reported it. Plain data: the
	// facts behind the trait warnings, the reconciler's transition key.
	UnhandledTraits map[string][]string

	// ResolvedVersions are the per-path version rows the build reports
	// (0019:D18): for every OPM-namespace path the instance module requires,
	// the build it asked for and the build the platform carries. Plain data;
	// the reconciler logs them at debug level, and a row marked Newer is the
	// fact behind a skew warning.
	ResolvedVersions []kernel.ResolvedVersion

	// RequiredContracts is every contract FQN the instance's components
	// declare, sorted and deduplicated (0015:D3, D16): the
	// instance's demand, in the keyspace TransformerRegistration.spec.provides
	// carries. The reconciler persists it on status.requiredContracts, where
	// the claim reconciler's removal guard intersects it with a claim's
	// provides to count that claim's dependents.
	//
	// Read off the synthesized instance, never off the platform, so it is a
	// property of the instance alone and does not move when the platform does.
	RequiredContracts []string

	// PlatformIdentity is the identity of the generated platform package this
	// render built against, in its string form (0015:D13, D17):
	// the Platform CR generation plus a digest of the active claims' catalog
	// coordinates. A render holds its package under a lease for its whole
	// duration, so this is the exact registry state the render consumed, even
	// when a newer package was generated while it ran.
	PlatformIdentity string
}