dxil

type BindTarget struct {
	// Space is the register space (0-based).
	Space uint32

	// Register is the register index within the space. This is the
	// DXIL metadata "lowerBound" and, for non-array resources, also
	// the dx.op.createHandle index.
	Register uint32

	// BindingArraySize is the array size for binding arrays. If nil,
	// the resource is not an array.
	//
	// Note: the DXIL backend takes the actual array size from the IR
	// type (BindingArrayType.Size). This field is accepted for parity
	// with hlsl.BindTarget so callers can share a single binding-map
	// builder; it is currently not consulted by the DXIL backend.
	BindingArraySize *uint32
}

type BindingLocation struct {
	// Group corresponds to WGSL @group or SPIR-V DescriptorSet.
	Group uint32

	// Binding corresponds to WGSL @binding or SPIR-V Binding.
	Binding uint32
}

type BindingMap map[BindingLocation]BindTarget

type Options struct {
	// ShaderModel is the target shader model version.
	ShaderModel ShaderModel

	// UseBypassHash uses the BYPASS sentinel hash (16×0x01) instead of
	// the retail validator hash. The BYPASS form is accepted by
	// AgilitySDK 1.615+ (January 2025) ONLY with developer mode
	// enabled; on consumer systems it is rejected by the D3D12
	// runtime format validator with STATE_CREATION error id 67 /
	// 93 "Shader is corrupt or in an unrecognized format" even
	// though IDxcValidator accepts either hash form.
	//
	// Default: false (retail hash). Set to true explicitly only
	// when the target system is guaranteed to be in dev mode with
	// the right AgilitySDK version.
	UseBypassHash bool

	// BindingMap remaps WGSL @group(N) @binding(M) to DXIL (space, register)
	// at emit time. If a shader binding is not present in the map, its raw
	// WGSL numbers are used (current behavior, preserved for backward
	// compatibility when the map is nil).
	//
	// This is the DXIL analog of hlsl.Options.BindingMap. It is required
	// when the shader is consumed by a pipeline whose root signature uses
	// a different register scheme than the raw WGSL binding numbers —
	// notably wgpu/hal/dx12, which assigns registers via monotonic per-class
	// counters (SRV=t0,t1,... / UAV=u0,u1,... / CBV=b0,b1,...).
	BindingMap BindingMap

	// SamplerHeapTargets specifies binding targets for the synthesized
	// sampler heap arrays (nagaSamplerHeap / nagaComparisonSamplerHeap).
	// Mirrors hlsl.Options.SamplerHeapTargets. When nil, falls back to
	// the defaults: standard at (space=0, register=0), comparison at
	// (space=1, register=0).
	//
	// The D3D12 root signature allocates sampler heap arrays at specific
	// (space, register) positions; these targets must match or the PSO
	// creation will fail with E_INVALIDARG.
	SamplerHeapTargets *SamplerHeapBindTargets

	// SamplerBufferBindingMap maps bind group numbers to SRV binding
	// targets for per-group sampler index buffers
	// (StructuredBuffer<uint> nagaGroup<N>SamplerIndexArray). Mirrors
	// hlsl.Options.SamplerBufferBindingMap.
	//
	// When nil, falls back to the current defaults: each group's index
	// buffer at (space=255, register=group). The D3D12 HAL should
	// populate this map so that the generated DXIL matches the root
	// signature's SRV layout for sampler index buffers.
	SamplerBufferBindingMap map[uint32]BindTarget
}

type SamplerHeapBindTargets struct {
	// StandardSamplers is the binding for non-comparison samplers.
	// Default: (space=0, register=0).
	StandardSamplers BindTarget

	// ComparisonSamplers is the binding for comparison samplers.
	// Default: (space=1, register=0).
	ComparisonSamplers BindTarget
}

type ShaderModel struct {
	Major uint32
	Minor uint32
}

type ValidationLevel int