codegen

type BindingMapKey struct {
	Group   uint32
	Binding uint32
}

type Features uint32

type ImmediateItem struct {
	AccessPath string
	Type       ir.TypeInner
	Offset     uint32
	SizeBytes  uint32
}

type MissingFeaturesError struct {
	Version            Version
	Features           Features
	ForImageLoadChecks bool
}

type Options struct {
	// LangVersion is the target GLSL version.
	// Defaults to Version330 if zero.
	LangVersion Version

	// EntryPoint selects the entry point to compile; nil selects the first.
	EntryPoint *backend.EntryPointSelector

	// SkipAdjustCoordinateSpace leaves gl_Position as written; by default a
	// vertex entry point ends with
	// gl_Position.yz = vec2(-gl_Position.y, gl_Position.z * 2.0 - gl_Position.w);
	// (Rust naga's WriterFlags::ADJUST_COORDINATE_SPACE).
	SkipAdjustCoordinateSpace bool

	// ForcePointSize writes gl_PointSize = 1.0 in vertex entry points
	// (FORCE_POINT_SIZE).
	ForcePointSize bool

	// TextureShadowLod enables GL_EXT_texture_shadow_lod (TEXTURE_SHADOW_LOD).
	TextureShadowLod bool

	// DrawParameters uses GL_ARB_shader_draw_parameters (DRAW_PARAMETERS).
	DrawParameters bool

	// BoundsCheckPolicies controls bounds checking for resource accesses.
	// Matches Rust naga's proc::BoundsCheckPolicies.
	BoundsCheckPolicies backend.BoundsCheckPolicies

	// BindingMap maps resource bindings to flat GL binding indices.
	// Matches Rust naga's back::glsl::BindingMap.
	// When set, layout(binding = N) qualifiers are emitted.
	BindingMap map[BindingMapKey]uint8

	// FakeMissingBindings writes a resource a non-nil BindingMap leaves out
	// without a binding qualifier instead of failing.
	FakeMissingBindings bool

	// ZeroInitializeWorkgroupMemory is how compute entry points zero the
	// shared variables they use: Polyfill (zero) or None; Native is an
	// error.
	ZeroInitializeWorkgroupMemory backend.ZeroInitializeWorkgroupMemoryMode

	// ClampFragDepth clamps the depth a fragment entry point writes to the
	// range at byte ClampFragDepth.Offset of its immediate data (see the
	// glsl package).
	ClampFragDepth *backend.ClampFragDepth
}

type TextureMapping struct {
	// TextureBinding is the (group, binding) of the texture global variable.
	TextureBinding ir.ResourceBinding

	// SamplerBinding is the (group, binding) of the associated sampler, if any.
	// Nil for storage images which have no sampler.
	SamplerBinding *ir.ResourceBinding
}

type TranslationInfo struct {
	// EntryPointNames maps original entry point names to generated GLSL names.
	EntryPointNames map[string]string

	// UsedExtensions lists GLSL extensions required by the shader.
	UsedExtensions []string

	// RequiredVersion is the minimum GLSL version needed for this shader.
	// May be higher than the requested version if features require it.
	RequiredVersion Version

	// TextureSamplerPairs lists the combined texture-sampler pairs generated.
	// Each entry is "textureName_samplerName".
	TextureSamplerPairs []string

	// TextureMappings maps combined sampler2D uniform names to their texture
	// and sampler source bindings. Used by GLES HAL to build SamplerBindMap
	// (bind GL sampler to texture's unit, not sampler's own binding).
	// Matches Rust naga ReflectionInfo.texture_mapping.
	TextureMappings map[string]TextureMapping

	// Uniforms maps global variable block names to their binding info.
	// Used by GLES HAL for runtime binding fallback on GL < 4.2 where
	// layout(binding=N) is unavailable. After glLinkProgram, the HAL
	// queries block indices by name and assigns bindings via GL calls.
	// Matches Rust naga ReflectionInfo.uniforms.
	Uniforms []UniformInfo

	// ImmediateItems lists the GL uniforms of the immediate data.
	// Matches Rust naga ReflectionInfo.immediates_items.
	ImmediateItems []ImmediateItem
}

type UniformInfo struct {
	// BlockName is the GLSL block name (e.g., "Uniforms_block_0Vertex").
	// Used with glGetUniformBlockIndex (uniform buffers) or
	// glGetShaderStorageBlockIndex (storage buffers).
	BlockName string

	// Binding is the source (group, binding) from the IR.
	Binding ir.ResourceBinding

	// IsStorage is true for storage buffers (SSBO), false for uniform buffers (UBO).
	IsStorage bool
}

type Version struct {
	Major uint8
	Minor uint8
	ES    bool // true for GLSL ES (OpenGL ES / WebGL)
}

type Writer struct {
	textutil.IndentWriter // provides Out, Indent, WriteLine, WriteIndent, PushIndent, PopIndent
	// contains filtered or unexported fields
}