import Node from "three/src/nodes/core/Node.js";
//#region src/materials/channels.d.ts
/**
 * Well-known channel name — named per-fragment data that effects can require.
 * Users extend via module augmentation on ChannelNodeMap for custom channels.
 */
type ChannelName = keyof ChannelNodeMap;
/**
 * Maps well-known channel names to their TSL node types.
 * Users extend via module augmentation for custom channels:
 *
 * @example
 * ```typescript
 * declare module 'three-flatland' {
 *   interface ChannelNodeMap {
 *     roughness: Node<'float'>
 *     emissive: Node<'vec3'>
 *   }
 * }
 * ```
 */
interface ChannelNodeMap {
  normal: Node<'vec3'>;
  /**
   * World-space elevation of the fragment in [0, 1]. 0 = ground plane
   * (floor), 1 = top-of-wall (cap). Consumed by `DefaultLightEffect`
   * to compute `L.z = lightHeight − elevation` per fragment per light,
   * so torches below wall caps stop lighting them. Baked into the
   * normal atlas's B channel; reconstructed-nz is derived at runtime
   * from the RG channels (nz = sqrt(1 − nx² − ny²)).
   */
  elevation: Node<'float'>;
}
/**
 * Narrows a type by adding required channel properties.
 * Known channels use mapped types; unknown channels fall back to Node.
 *
 * Used by createLightEffect to type the light callback context —
 * if requires: ['normal'], then ctx.normal is Node<'vec3'> (guaranteed).
 */
type WithRequiredChannels<C extends readonly string[]> = { [K in C[number]]: K extends keyof ChannelNodeMap ? ChannelNodeMap[K] : Node; };
/**
 * Default TSL node factories for well-known channels.
 * When a colorTransform requires a channel but no provider effect supplies it,
 * the pipeline fills it from this map. Users can register defaults for custom
 * channels by adding entries.
 */
declare const channelDefaults: Record<string, () => Node>;
//#endregion
export { ChannelName, ChannelNodeMap, WithRequiredChannels, channelDefaults };
//# sourceMappingURL=channels.d.ts.map