/** Created by Claude(kimi) on 2026/08/19 from [maptalks.heatmap/index.js](https://github.com/maptalks/maptalks.heatmap/blob/e1d070755c9606bf77fe825257704ee32af549cf/index.js) */
declare module 'maptalks.heatmap' {
  import * as maptalks from 'maptalks'

  export type HeatPoint = [lng:number, lat: number, intensity: number?]

  export interface HeatLayerOptionsType extends maptalks.LayerOptionsType {
    /**
     * max data value
     * @default 1
     */
    max?: number;
    /** 
     * point radius
     * @default 25
     */
    radius?: number;
    /**
     * blur radius
     * @default 15
     */
    blur?: number;
    /**
     * minimum point opacity
     * @default 0.05
     */
    minOpacity?: number;
    /**
     * the scale value to multiply with heat data
     * @default 1
     */
    heatValueScale?: number;
    /**
     * set gradient colors as `{<stop>: '<color>'}`,
     * @default = { 0.4: 'blue', 0.6: 'cyan', 0.7: 'lime', 0.8: 'yellow', 1.0: 'red' }
     */
    gradient?: Record<number, string>;
  }

  export class HeatLayer extends maptalks.Layer {
    config(options: HeatLayerOptionsType): this
    config<K extends keyof HeatLayerOptionsType>(conf: K, value: HeatLayerOptionsType[K]): this
    /** @deprecated */ config(): HeatLayerOptionsType
    options: HeatLayerOptionsType

    constructor(id: string, data?: HeatPoint[], options?: HeatLayerOptionsType)
    constructor(id: string, options?: HeatLayerOptionsType)

    /**
     * get layer's data
     */
    getData(): HeatPoint[]

    /**
     * set new data
     * @param data data to set
     */
    setData(data: HeatPoint[]): this

    /**
     * add more points
     * @param point points to add, [[x, y, value], [x, y, value]..]
     */
    addPoint(point: HeatPoint | HeatPoint[]): this

    /**
     * @return whether the layer is empty
     */
    isEmpty(): boolean

    /**
     * clear the layer
     */
    clear(): this

    /**
     * export the layer's JSON.
     * @param options options
     */
    toJSON(options?: {
    /** * the extent to clip */
      clipExtent?: maptalks.Extent;
    }): {
      type: string;
      id: string;
      options: Record<string, any>;
      data: HeatPoint[];
    }

    /**
     * Reproduce a HeatLayer from layer's JSON.
     * @param json layer's JSON
     */
    static fromJSON(json: Record<string, any>): HeatLayer | null
  }
}