@feltmaps/js-sdk 1.10.2-next.0 → 1.11.0-next.0

package/dist/{controller-DXsOpGmy.d.cts → controller-m5hIgJCz.d.cts}

@@ -4992,12 +4992,28 @@ interface RasterLayerSource {
     bands: Array<RasterBand>;
 }
 /**
- * The RasterBand interface describes the metadata for a raster band, necessary for
- * calculating the encoded raster value from the red, green, and blue values of the pixel.
+ * The RasterBand interface describes one band of a raster: how to identify it when
+ * asking for statistics, what to call it, and the values needed to calculate the
+ * encoded raster value from the red, green, and blue values of a pixel.
  *
  * @group Layer sources
  */
 interface RasterBand {
+    /**
+     * The identifier for this band, such as `"band:1"`.
+     *
+     * Pass this to the raster statistics methods, such as
+     * {@link LayersController.getRasterAggregates}, and use it to refer to the band
+     * inside a filter.
+     */
+    id: string;
+    /**
+     * The name of the band, such as "Red" or "Elevation".
+     *
+     * Felt takes this from the raster itself when the file names its bands, and
+     * falls back to "Band 1", "Band 2" and so on.
+     */
+    displayName: string;
     /**
      * Encoding base value as a floating point number
      */
@@ -7080,6 +7096,633 @@ interface GetLayerPrecomputedCalculationParams extends z.infer<typeof GetLayerPr
     gridConfig: GridConfig;
 }
 
+/**
+ * The spatial boundary for a raster statistic.
+ *
+ * Raster statistics accept everything a vector statistic accepts, and also accept
+ * a line. A polygon or bounding box selects the pixels whose centres fall inside
+ * it. A line is sampled along its length instead, so its statistics are weighted
+ * by distance rather than by area.
+ *
+ * @group Stats
+ */
+type RasterGeometryFilter = GeometryFilter | LineStringGeometry | MultiLineStringGeometry;
+declare const RasterAggregationMethodSchema: z.ZodEnum<["avg", "min", "max", "sum", "median", "stddev", "majority", "area"]>;
+/**
+ * A statistic that can be calculated for a raster band.
+ *
+ * `area` is the ground area of the selected pixels, in square metres. `majority`
+ * is the most common value, and applies only to a band holding whole numbers.
+ *
+ * Neither `sum` nor `area` is available for a line boundary, because both need a
+ * ground area for each pixel and a line only samples points. A request for a
+ * statistic that the band or the boundary cannot answer throws.
+ *
+ * @group Stats
+ */
+type RasterAggregationMethod = z.infer<typeof RasterAggregationMethodSchema>;
+declare const GetRasterAggregatesParamsSchema: z.ZodObject<z.objectUtil.extendShape<{
+    layerId: z.ZodString;
+    band: z.ZodString;
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        type: z.ZodLiteral<"Polygon">;
+        coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"MultiPolygon">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    }, {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>, z.ZodObject<{
+        type: z.ZodLiteral<"LineString">;
+        coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"MultiLineString">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }>]>>;
+    filters: z.ZodOptional<z.ZodUnion<[z.ZodType<FilterTernary, z.ZodTypeDef, FilterTernary>, z.ZodUnion<[z.ZodTuple<[z.ZodUnion<[z.ZodString, z.ZodNull]>, z.ZodEnum<["in", "ni"]>, z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodNull]>, "many">, z.ZodNull]>], null>, z.ZodTuple<[z.ZodUnion<[z.ZodString, z.ZodNull]>, z.ZodEnum<["lt", "gt", "le", "ge", "eq", "ne", "cn", "nc", "is", "isnt"]>, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodNull]>], null>]>, z.ZodNull, z.ZodBoolean]>>;
+}, {
+    aggregation: z.ZodObject<{
+        methods: z.ZodArray<z.ZodEnum<["avg", "min", "max", "sum", "median", "stddev", "majority", "area"]>, "many">;
+        percentiles: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "stddev" | "majority" | "area")[];
+        percentiles?: number[] | undefined;
+    }, {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "stddev" | "majority" | "area")[];
+        percentiles?: number[] | undefined;
+    }>;
+}>, "strip", z.ZodTypeAny, {
+    layerId: string;
+    aggregation: {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "stddev" | "majority" | "area")[];
+        percentiles?: number[] | undefined;
+    };
+    band: string;
+    filters?: boolean | FilterTernary | [string | null, "in" | "ni", (string | number | boolean | null)[] | null] | [string | null, "lt" | "gt" | "le" | "ge" | "eq" | "ne" | "cn" | "nc" | "is" | "isnt", string | number | boolean | null] | null | undefined;
+    boundary?: [number, number, number, number] | [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    } | {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    } | undefined;
+}, {
+    layerId: string;
+    aggregation: {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "stddev" | "majority" | "area")[];
+        percentiles?: number[] | undefined;
+    };
+    band: string;
+    filters?: boolean | FilterTernary | [string | null, "in" | "ni", (string | number | boolean | null)[] | null] | [string | null, "lt" | "gt" | "le" | "ge" | "eq" | "ne" | "cn" | "nc" | "is" | "isnt", string | number | boolean | null] | null | undefined;
+    boundary?: [number, number, number, number] | [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    } | {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    } | undefined;
+}>;
+/**
+ * The parameters for calculating statistics for a raster band, passed to the
+ * {@link LayersController.getRasterAggregates} method.
+ *
+ * @group Stats
+ */
+interface GetRasterAggregatesParams<T extends RasterAggregationMethod> extends zInfer<typeof GetRasterAggregatesParamsSchema> {
+    /**
+     * The ID of the band to calculate statistics for, such as `"band:1"`.
+     *
+     * Read the available band IDs from the `bands` on a raster layer's source.
+     */
+    band: string;
+    /**
+     * The spatial boundary for the pixels to include. Omit this to cover the whole
+     * raster.
+     */
+    boundary?: RasterGeometryFilter;
+    /**
+     * Filters on band values for the pixels to include, such as
+     * `["band:1", "gt", 100]`.
+     */
+    filters?: Filters;
+    /**
+     * Which statistics to calculate for the band.
+     */
+    aggregation: {
+        /**
+         * The statistics to calculate for the band.
+         */
+        methods: T[];
+        /**
+         * Percentile ranks between 0 and 100 to calculate, such as `[10, 50, 90]`.
+         */
+        percentiles?: number[];
+    };
+}
+declare const RasterPercentileSchema: z.ZodObject<{
+    /**
+     * The percentile rank that was requested.
+     */
+    rank: z.ZodNumber;
+    /**
+     * The band value at this rank.
+     */
+    value: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value: number | null;
+    rank: number;
+}, {
+    value: number | null;
+    rank: number;
+}>;
+/**
+ * One percentile from the response to the
+ * {@link LayersController.getRasterAggregates} method.
+ *
+ * @group Stats
+ */
+interface RasterPercentile extends zInfer<typeof RasterPercentileSchema> {
+}
+/**
+ * The response from the {@link LayersController.getRasterAggregates} method.
+ *
+ * @group Stats
+ */
+interface GetRasterAggregatesResult<T extends RasterAggregationMethod> {
+    /**
+     * The value calculated for each requested statistic.
+     *
+     * `null` is returned when the boundary and filters selected no pixels, as
+     * opposed to zero, so as not to confuse an empty selection with a real zero.
+     */
+    stats: Record<T, number | null>;
+    /**
+     * The requested percentiles, in the order they were requested. Present only
+     * when percentile ranks were requested.
+     */
+    percentiles?: Array<RasterPercentile>;
+}
+declare const GetRasterHistogramParamsSchema: z.ZodObject<z.objectUtil.extendShape<{
+    layerId: z.ZodString;
+    band: z.ZodString;
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        type: z.ZodLiteral<"Polygon">;
+        coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"MultiPolygon">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    }, {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>, z.ZodObject<{
+        type: z.ZodLiteral<"LineString">;
+        coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"MultiLineString">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }>]>>;
+    filters: z.ZodOptional<z.ZodUnion<[z.ZodType<FilterTernary, z.ZodTypeDef, FilterTernary>, z.ZodUnion<[z.ZodTuple<[z.ZodUnion<[z.ZodString, z.ZodNull]>, z.ZodEnum<["in", "ni"]>, z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodNull]>, "many">, z.ZodNull]>], null>, z.ZodTuple<[z.ZodUnion<[z.ZodString, z.ZodNull]>, z.ZodEnum<["lt", "gt", "le", "ge", "eq", "ne", "cn", "nc", "is", "isnt"]>, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodNull]>], null>]>, z.ZodNull, z.ZodBoolean]>>;
+}, {
+    steps: z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"equal-intervals">;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "equal-intervals";
+        count: number;
+    }, {
+        type: "equal-intervals";
+        count: number;
+    }>, z.ZodArray<z.ZodNumber, "many">]>;
+}>, "strip", z.ZodTypeAny, {
+    layerId: string;
+    steps: number[] | {
+        type: "equal-intervals";
+        count: number;
+    };
+    band: string;
+    filters?: boolean | FilterTernary | [string | null, "in" | "ni", (string | number | boolean | null)[] | null] | [string | null, "lt" | "gt" | "le" | "ge" | "eq" | "ne" | "cn" | "nc" | "is" | "isnt", string | number | boolean | null] | null | undefined;
+    boundary?: [number, number, number, number] | [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    } | {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    } | undefined;
+}, {
+    layerId: string;
+    steps: number[] | {
+        type: "equal-intervals";
+        count: number;
+    };
+    band: string;
+    filters?: boolean | FilterTernary | [string | null, "in" | "ni", (string | number | boolean | null)[] | null] | [string | null, "lt" | "gt" | "le" | "ge" | "eq" | "ne" | "cn" | "nc" | "is" | "isnt", string | number | boolean | null] | null | undefined;
+    boundary?: [number, number, number, number] | [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    } | {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    } | undefined;
+}>;
+/**
+ * The parameters for requesting a histogram of a raster band's values, passed to
+ * the {@link LayersController.getRasterHistogramData} method.
+ *
+ * @group Stats
+ */
+interface GetRasterHistogramParams extends zInfer<typeof GetRasterHistogramParamsSchema> {
+    /**
+     * The ID of the band to bin, such as `"band:1"`.
+     *
+     * Read the available band IDs from the `bands` on a raster layer's source.
+     */
+    band: string;
+    /**
+     * The spatial boundary for the pixels to include. Omit this to cover the whole
+     * raster.
+     */
+    boundary?: RasterGeometryFilter;
+    /**
+     * Filters on band values for the pixels to include.
+     */
+    filters?: Filters;
+    /**
+     * How to divide the band's values into bins, either as a number of equal
+     * intervals or as the bin edges themselves.
+     */
+    steps: {
+        type: "equal-intervals";
+        count: number;
+    } | number[];
+}
+declare const RasterHistogramBinSchema: z.ZodObject<{
+    /**
+     * The left edge of the bin.
+     */
+    min: z.ZodNumber;
+    /**
+     * The right edge of the bin.
+     */
+    max: z.ZodNumber;
+    /**
+     * The number of pixels in the bin.
+     */
+    value: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    max: number;
+    min: number;
+}, {
+    value: number;
+    max: number;
+    min: number;
+}>;
+/**
+ * One bin from the response to the
+ * {@link LayersController.getRasterHistogramData} method.
+ *
+ * @group Stats
+ */
+interface RasterHistogramBin extends zInfer<typeof RasterHistogramBinSchema> {
+}
+/**
+ * The response from the {@link LayersController.getRasterHistogramData} method.
+ *
+ * @group Stats
+ */
+interface GetRasterHistogramResult {
+    /**
+     * The bins, in ascending order of value.
+     */
+    bins: Array<RasterHistogramBin>;
+}
+declare const GetRasterCategoriesParamsSchema: z.ZodObject<z.objectUtil.extendShape<{
+    layerId: z.ZodString;
+    band: z.ZodString;
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        type: z.ZodLiteral<"Polygon">;
+        coordinates: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"MultiPolygon">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, [number, number][], [number, number][]>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    }, {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>, z.ZodObject<{
+        type: z.ZodLiteral<"LineString">;
+        coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"MultiLineString">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }>]>>;
+    filters: z.ZodOptional<z.ZodUnion<[z.ZodType<FilterTernary, z.ZodTypeDef, FilterTernary>, z.ZodUnion<[z.ZodTuple<[z.ZodUnion<[z.ZodString, z.ZodNull]>, z.ZodEnum<["in", "ni"]>, z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodNull]>, "many">, z.ZodNull]>], null>, z.ZodTuple<[z.ZodUnion<[z.ZodString, z.ZodNull]>, z.ZodEnum<["lt", "gt", "le", "ge", "eq", "ne", "cn", "nc", "is", "isnt"]>, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodNull]>], null>]>, z.ZodNull, z.ZodBoolean]>>;
+}, {
+    limit: z.ZodOptional<z.ZodNumber>;
+}>, "strip", z.ZodTypeAny, {
+    layerId: string;
+    band: string;
+    filters?: boolean | FilterTernary | [string | null, "in" | "ni", (string | number | boolean | null)[] | null] | [string | null, "lt" | "gt" | "le" | "ge" | "eq" | "ne" | "cn" | "nc" | "is" | "isnt", string | number | boolean | null] | null | undefined;
+    boundary?: [number, number, number, number] | [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    } | {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    } | undefined;
+    limit?: number | undefined;
+}, {
+    layerId: string;
+    band: string;
+    filters?: boolean | FilterTernary | [string | null, "in" | "ni", (string | number | boolean | null)[] | null] | [string | null, "lt" | "gt" | "le" | "ge" | "eq" | "ne" | "cn" | "nc" | "is" | "isnt", string | number | boolean | null] | null | undefined;
+    boundary?: [number, number, number, number] | [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | {
+        type: "MultiPolygon";
+        coordinates: [number, number][][][];
+    } | {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    } | undefined;
+    limit?: number | undefined;
+}>;
+/**
+ * The parameters for counting the distinct values of a raster band, passed to the
+ * {@link LayersController.getRasterCategoryData} method.
+ *
+ * @group Stats
+ */
+interface GetRasterCategoriesParams extends zInfer<typeof GetRasterCategoriesParamsSchema> {
+    /**
+     * The ID of the band to count values for, such as `"band:1"`.
+     *
+     * Read the available band IDs from the `bands` on a raster layer's source.
+     */
+    band: string;
+    /**
+     * The spatial boundary for the pixels to include. Omit this to cover the whole
+     * raster.
+     */
+    boundary?: RasterGeometryFilter;
+    /**
+     * Filters on band values for the pixels to include.
+     */
+    filters?: Filters;
+    /**
+     * The maximum number of categories to return. The most frequent categories are
+     * kept.
+     */
+    limit?: number;
+}
+declare const RasterCategorySchema: z.ZodObject<{
+    /**
+     * The band value this category counts.
+     */
+    key: z.ZodNumber;
+    /**
+     * The number of pixels holding this value.
+     */
+    value: z.ZodNumber;
+    /**
+     * The ground area of this category's pixels, in square metres. Absent for a
+     * line boundary, which samples points and so has no area.
+     */
+    areaM2: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    key: number;
+    areaM2?: number | undefined;
+}, {
+    value: number;
+    key: number;
+    areaM2?: number | undefined;
+}>;
+/**
+ * One category from the response to the
+ * {@link LayersController.getRasterCategoryData} method.
+ *
+ * @group Stats
+ */
+interface RasterCategory extends zInfer<typeof RasterCategorySchema> {
+}
+/**
+ * The response from the {@link LayersController.getRasterCategoryData} method.
+ *
+ * @group Stats
+ */
+interface GetRasterCategoriesResult {
+    /**
+     * The categories, most frequent first.
+     */
+    categories: Array<RasterCategory>;
+    /**
+     * How many distinct values the band holds within the scope, which is larger
+     * than the number of categories returned when `limit` drops some.
+     */
+    total: number;
+}
+declare const GetRasterProfileParamsSchema: z.ZodObject<{
+    layerId: z.ZodString;
+    band: z.ZodString;
+    boundary: z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"LineString">;
+        coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }, {
+        type: "LineString";
+        coordinates: [number, number][];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"MultiLineString">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }, {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    layerId: string;
+    boundary: {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    };
+    band: string;
+}, {
+    layerId: string;
+    boundary: {
+        type: "LineString";
+        coordinates: [number, number][];
+    } | {
+        type: "MultiLineString";
+        coordinates: [number, number][][];
+    };
+    band: string;
+}>;
+/**
+ * The parameters for sampling a raster band along a line, passed to the
+ * {@link LayersController.getRasterProfile} method.
+ *
+ * @group Stats
+ */
+interface GetRasterProfileParams extends zInfer<typeof GetRasterProfileParamsSchema> {
+    /**
+     * The ID of the band to sample, such as `"band:1"`.
+     *
+     * Read the available band IDs from the `bands` on a raster layer's source.
+     */
+    band: string;
+    /**
+     * The line to sample the band along. The band is sampled at roughly one sample
+     * per pixel along the line's length.
+     */
+    boundary: LineStringGeometry | MultiLineStringGeometry;
+}
+declare const RasterProfileSampleSchema: z.ZodObject<{
+    /**
+     * How far along the line this sample was taken, in ground metres from the
+     * line's start.
+     */
+    distanceM: z.ZodNumber;
+    /**
+     * The band's value at this sample, or `null` where the raster holds no data or
+     * the line runs outside the raster.
+     */
+    value: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value: number | null;
+    distanceM: number;
+}, {
+    value: number | null;
+    distanceM: number;
+}>;
+/**
+ * One sample from the response to the {@link LayersController.getRasterProfile}
+ * method.
+ *
+ * @group Stats
+ */
+interface RasterProfileSample extends zInfer<typeof RasterProfileSampleSchema> {
+}
+/**
+ * The response from the {@link LayersController.getRasterProfile} method.
+ *
+ * @group Stats
+ */
+interface GetRasterProfileResult {
+    /**
+     * The samples, ordered from the line's start.
+     */
+    samples: Array<RasterProfileSample>;
+    /**
+     * The mean distance between consecutive samples, in ground metres. Absent when
+     * the line was too short to walk.
+     */
+    spacingM?: number;
+}
+
 /**
  * The Layers controller allows you to get information about the layers on the
  * map, and make changes to their visibility.
@@ -7899,6 +8542,113 @@ interface LayersController {
         sum: number | null;
         count: number | null;
     }>;
+    /**
+     * Calculates statistics for a raster band.
+     *
+     * @remarks
+     * Summarizes the pixel values of one band of a raster layer. Omit the boundary
+     * to summarize the whole raster, or pass a bounding box, a polygon, or a line to
+     * summarize part of it. Filters restrict the summary to pixels whose band values
+     * match a condition.
+     *
+     * @example
+     * ```typescript
+     * // The elevation range of a whole raster
+     * const elevation = await felt.getRasterAggregates({
+     *   layerId: "elevation",
+     *   band: "band:1",
+     *   aggregation: { methods: ["min", "max", "avg"] },
+     * });
+     *
+     * // How much ground inside a parcel sits above 2,000 metres
+     * const highGround = await felt.getRasterAggregates({
+     *   layerId: "elevation",
+     *   band: "band:1",
+     *   aggregation: { methods: ["area"] },
+     *   boundary: parcel,
+     *   filters: ["band:1", "gt", 2000],
+     * });
+     *
+     * // The steepest tenth of a slope raster
+     * const steep = await felt.getRasterAggregates({
+     *   layerId: "slope",
+     *   band: "band:1",
+     *   aggregation: { methods: ["avg"], percentiles: [90] },
+     * });
+     * ```
+     */
+    getRasterAggregates<T extends RasterAggregationMethod>(params: GetRasterAggregatesParams<T>): Promise<GetRasterAggregatesResult<T>>;
+    /**
+     * Calculates a histogram of a raster band's values.
+     *
+     * @remarks
+     * Divides a band's values into bins and counts the pixels falling into each one.
+     * You can pass a number of equal intervals, or the bin edges themselves when you
+     * already know how you want the values divided.
+     *
+     * As with the vector histogram, filters apply in two ways. The top-level
+     * boundary and filters decide both where the bins fall and what gets counted in
+     * them. Filters in `values` only change what gets counted, so two histograms can
+     * be compared against identical bins.
+     *
+     * @example
+     * ```typescript
+     * // Elevation distribution in ten equal intervals
+     * const elevation = await felt.getRasterHistogramData({
+     *   layerId: "elevation",
+     *   band: "band:1",
+     *   steps: { type: "equal-intervals", count: 10 },
+     * });
+     *
+     * // The same bins, counting only pixels inside a watershed
+     * const inWatershed = await felt.getRasterHistogramData({
+     *   layerId: "elevation",
+     *   band: "band:1",
+     *   steps: [0, 500, 1000, 1500, 2000, 3000],
+     *   values: { boundary: watershed },
+     * });
+     * ```
+     */
+    getRasterHistogramData(params: GetRasterHistogramParams): Promise<GetRasterHistogramResult>;
+    /**
+     * Counts the pixels holding each distinct value of a raster band.
+     *
+     * @remarks
+     * This suits a band whose values are class codes, such as a land cover raster.
+     * Each category reports how many pixels hold the value and how much ground they
+     * cover. A band whose values are not whole numbers cannot be counted this way,
+     * and throws.
+     *
+     * @example
+     * ```typescript
+     * // How much of a county each land cover class covers
+     * const landCover = await felt.getRasterCategoryData({
+     *   layerId: "land-cover",
+     *   band: "band:1",
+     *   boundary: county,
+     *   limit: 10,
+     * });
+     * ```
+     */
+    getRasterCategoryData(params: GetRasterCategoriesParams): Promise<GetRasterCategoriesResult>;
+    /**
+     * Samples a raster band's values along a line.
+     *
+     * @remarks
+     * Returns the values themselves rather than a summary of them, each paired with
+     * how far along the line it was taken. This is what an elevation profile along a
+     * route is drawn from.
+     *
+     * @example
+     * ```typescript
+     * const profile = await felt.getRasterProfile({
+     *   layerId: "elevation",
+     *   band: "band:1",
+     *   boundary: route,
+     * });
+     * ```
+     */
+    getRasterProfile(params: GetRasterProfileParams): Promise<GetRasterProfileResult>;
     /**
      * Get the schema for a layer.
      *
@@ -13848,20 +14598,46 @@ declare const UiControlsOptionsSchema: z.ZodObject<{
      * @defaultValue true
      */
     scaleBar: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Whether or not the map can be rotated.
+     *
+     * @remarks
+     * This affects all rotation interactions — dragging with the right mouse
+     * button or Ctrl held, two-finger touch rotation, and keyboard shortcuts —
+     * as well as the compass control, which is hidden when rotation is
+     * disabled.
+     *
+     * @defaultValue true
+     */
+    rotation: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Whether or not the right-click context menu is available on the map.
+     *
+     * @remarks
+     * When disabled, right-clicking the map opens neither Felt's context menu
+     * nor the browser's own.
+     *
+     * @defaultValue true
+     */
+    contextMenu: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    rotation?: boolean | undefined;
     showLegend?: boolean | undefined;
     cooperativeGestures?: boolean | undefined;
     fullScreenButton?: boolean | undefined;
     geolocation?: boolean | undefined;
     zoomControls?: boolean | undefined;
     scaleBar?: boolean | undefined;
+    contextMenu?: boolean | undefined;
 }, {
+    rotation?: boolean | undefined;
     showLegend?: boolean | undefined;
     cooperativeGestures?: boolean | undefined;
     fullScreenButton?: boolean | undefined;
     geolocation?: boolean | undefined;
     zoomControls?: boolean | undefined;
     scaleBar?: boolean | undefined;
+    contextMenu?: boolean | undefined;
 }>;
 /**
  * The options for which parts of the Felt UI can be shown when interacting with
@@ -14698,4 +15474,4 @@ interface FeltController extends ViewportController, UiController, LayersControl
     iframe: HTMLIFrameElement | null;
 }
 
-export { type GeoJsonDataVectorSource as $, type PlaceElementRead as A, type BasemapsController as B, type ColorBasemap as C, type PlaceElementUpdate as D, type Element as E, type FeltController as F, type GetElementGroupsConstraint as G, type HighlighterElementCreate as H, type ImageElementCreate as I, type PolygonElementCreate as J, type PolygonElementRead as K, type LinkElementRead as L, type MarkerElementCreate as M, type NoteElementCreate as N, type PolygonElementUpdate as O, type PathElementCreate as P, type TextElementRead as Q, type TextElementUpdate as R, type ElementsController as S, type TextElementCreate as T, type UiControlsOptions as U, type ViewportCenterZoom as V, type MapInteractionEvent as W, type InteractionsController as X, type CreateLayersFromGeoJsonParams as Y, type DataOnlyLayer as Z, type FeltTiledVectorSource as _, type Basemap as a, type SelectionController as a$, type GeoJsonFileVectorSource as a0, type GeoJsonUrlVectorSource as a1, type GetLayerGroupsConstraint as a2, type GetLayersConstraint as a3, type GetRenderedFeaturesConstraint as a4, type Layer as a5, type LayerChangeCallbackParams as a6, type LayerCommon as a7, type LayerGroup as a8, type LayerGroupChangeCallbackParams as a9, type LayerBoundaries as aA, type LayerFilters as aB, type AggregatedGridConfig as aC, type AggregationConfig as aD, type AggregationMethod as aE, type CountGridConfig as aF, type GetLayerCalculationParams as aG, type GetLayerCategoriesGroup as aH, type GetLayerCategoriesParams as aI, type GetLayerHistogramBin as aJ, type GetLayerHistogramParams as aK, type GetLayerPrecomputedCalculationParams as aL, type GridConfig as aM, type GridType as aN, type MultiAggregationConfig as aO, type PrecomputedAggregationMethod as aP, type ValueConfiguration as aQ, type LayersController as aR, type MapDetails as aS, type MiscController as aT, type ElementGroupNode as aU, type ElementNode as aV, type EntityNode as aW, type FeatureNode as aX, type FeatureSelection as aY, type LayerGroupNode as aZ, type LayerNode as a_, type LayerProcessingStatus as aa, type LegendDisplay as ab, type LegendItem as ac, type LegendItemChangeCallbackParams as ad, type LegendItemIdentifier as ae, type LegendItemsConstraint as af, type RasterBand as ag, type RasterLayer as ah, type RasterLayerSource as ai, type UpdateLayerParams as aj, type VectorLayer as ak, type LayerFeature as al, type RasterValue as am, type LayerSchema as an, type LayerSchemaAttribute as ao, type LayerSchemaBooleanAttribute as ap, type LayerSchemaCommonAttribute as aq, type LayerSchemaDateAttribute as ar, type LayerSchemaDateTimeAttribute as as, type LayerSchemaNumericAttribute as at, type LayerSchemaTextAttribute as au, type FilterExpression as av, type FilterLogicGate as aw, type FilterTernary as ax, type Filters as ay, type GeometryFilter as az, type ColorBasemapInput as b, type UIPanelElement as b$, type FeltBoundary as b0, type FeltZoom as b1, type GeoJsonFeature as b2, type GeoJsonGeometry as b3, type GeoJsonProperties as b4, type LatLng as b5, type LineStringGeometry as b6, type LngLatTuple as b7, type MultiLineStringGeometry as b8, type MultiPointGeometry as b9, type CreatePanelElementsParams as bA, type DeletePanelElementsParams as bB, type UiOnMapInteractionsOptions as bC, type UpdateActionTriggerParams as bD, type UpdateFeatureActionParams as bE, type UpdatePanelElementsParams as bF, type PlacementForUIElement as bG, type UIPanel as bH, type UIPanelCreateOrUpdate as bI, type UIButtonElement as bJ, type UIButtonElementCreate as bK, type UIButtonElementUpdate as bL, type UITextElement as bM, type UITextElementCreate as bN, type UITextElementUpdate as bO, type UIFlexibleSpaceElement as bP, type UIFlexibleSpaceElementCreate as bQ, type UIFlexibleSpaceElementUpdate as bR, type UIDividerElement as bS, type UIDividerElementCreate as bT, type UIDividerElementUpdate as bU, type UITextInputElement as bV, type UITextInputElementCreate as bW, type UITextInputElementUpdate as bX, type UISelectElement as bY, type UISelectElementCreate as bZ, type UISelectElementUpdate as b_, type MultiPolygonGeometry as ba, type PointGeometry as bb, type PolygonGeometry as bc, type SetVisibilityRequest as bd, type SortConfig as be, type SortDirection as bf, type CircleToolSettings as bg, type ConfigurableToolType as bh, type HighlighterToolSettings as bi, type InputToolSettings as bj, type LineToolSettings as bk, type MarkerToolSettings as bl, type NoteToolSettings as bm, type PinToolSettings as bn, type PlaceFrame as bo, type PlaceSymbol as bp, type PolygonToolSettings as bq, type RouteToolSettings as br, type TextToolSettings as bs, type ToolSettingsChangeEvent as bt, type ToolSettingsMap as bu, type ToolType as bv, type ToolsController as bw, type CreateActionTriggerParams as bx, type CreateFeatureActionParams as by, type CreateOrUpdatePanelParams as bz, type CustomTileBasemap as c, type UIPanelElementCreate as c0, type UIPanelElementUpdate as c1, type UIGridContainerElement as c2, type UIGridContainerElementCreate as c3, type UIGridContainerElementUpdate as c4, type UIButtonRowElement as c5, type UIButtonRowElementCreate as c6, type UIButtonRowElementUpdate as c7, type UICheckboxGroupElement as c8, type UICheckboxGroupElementCreate as c9, type MakeClonableSchema as cA, type UIButtonRowElementCreateClonable as cB, type PromiseOrNot as cC, type UnionToIntersection as cD, type UICheckboxGroupElementUpdate as ca, type UIRadioGroupElement as cb, type UIRadioGroupElementCreate as cc, type UIRadioGroupElementUpdate as cd, type UIToggleGroupElement as ce, type UIToggleGroupElementCreate as cf, type UIToggleGroupElementUpdate as cg, type UIIframeElement as ch, type UIIframeElementCreate as ci, type UIIframeElementUpdate as cj, type UIControlElementOption as ck, type UIActionTriggerCreate as cl, type UIFeatureAction as cm, type UIFeatureActionCreate as cn, type UiController as co, type SetViewportCenterZoomParams as cp, type ViewportConstraints as cq, type ViewportFitBoundsParams as cr, type ViewportState as cs, type ViewportController as ct, type UnwrapPromise as cu, uiActionTriggerSchema as cv, uiFeatureActionSchema as cw, type UIPanelElementCreateClonable as cx, uiPanelCreateSchema as cy, type UIButtonElementCreateClonable as cz, type CustomTileBasemapInput as d, type FeltBasemap as e, type CircleElementCreate as f, type CircleElementRead as g, type CircleElementUpdate as h, type ElementChangeCallbackParams as i, type ElementCreate as j, type ElementGroup as k, type ElementGroupChangeCallbackParams as l, type ElementUpdate as m, type GetElementsConstraint as n, type HighlighterElementRead as o, type HighlighterElementUpdate as p, type ImageElementRead as q, type ImageElementUpdate as r, type MarkerElementRead as s, type MarkerElementUpdate as t, type NoteElementRead as u, type NoteElementUpdate as v, type PathElementRead as w, type PathElementUpdate as x, type PlaceElementCreate as y, type zInfer as z };
+export { type GeoJsonDataVectorSource as $, type PlaceElementRead as A, type BasemapsController as B, type ColorBasemap as C, type PlaceElementUpdate as D, type Element as E, type FeltController as F, type GetElementGroupsConstraint as G, type HighlighterElementCreate as H, type ImageElementCreate as I, type PolygonElementCreate as J, type PolygonElementRead as K, type LinkElementRead as L, type MarkerElementCreate as M, type NoteElementCreate as N, type PolygonElementUpdate as O, type PathElementCreate as P, type TextElementRead as Q, type TextElementUpdate as R, type ElementsController as S, type TextElementCreate as T, type UiControlsOptions as U, type ViewportCenterZoom as V, type MapInteractionEvent as W, type InteractionsController as X, type CreateLayersFromGeoJsonParams as Y, type DataOnlyLayer as Z, type FeltTiledVectorSource as _, type Basemap as a, type RasterGeometryFilter as a$, type GeoJsonFileVectorSource as a0, type GeoJsonUrlVectorSource as a1, type GetLayerGroupsConstraint as a2, type GetLayersConstraint as a3, type GetRenderedFeaturesConstraint as a4, type Layer as a5, type LayerChangeCallbackParams as a6, type LayerCommon as a7, type LayerGroup as a8, type LayerGroupChangeCallbackParams as a9, type LayerBoundaries as aA, type LayerFilters as aB, type AggregatedGridConfig as aC, type AggregationConfig as aD, type AggregationMethod as aE, type CountGridConfig as aF, type GetLayerCalculationParams as aG, type GetLayerCategoriesGroup as aH, type GetLayerCategoriesParams as aI, type GetLayerHistogramBin as aJ, type GetLayerHistogramParams as aK, type GetLayerPrecomputedCalculationParams as aL, type GridConfig as aM, type GridType as aN, type MultiAggregationConfig as aO, type PrecomputedAggregationMethod as aP, type ValueConfiguration as aQ, type GetRasterAggregatesParams as aR, type GetRasterAggregatesResult as aS, type GetRasterCategoriesParams as aT, type GetRasterCategoriesResult as aU, type GetRasterHistogramParams as aV, type GetRasterHistogramResult as aW, type GetRasterProfileParams as aX, type GetRasterProfileResult as aY, type RasterAggregationMethod as aZ, type RasterCategory as a_, type LayerProcessingStatus as aa, type LegendDisplay as ab, type LegendItem as ac, type LegendItemChangeCallbackParams as ad, type LegendItemIdentifier as ae, type LegendItemsConstraint as af, type RasterBand as ag, type RasterLayer as ah, type RasterLayerSource as ai, type UpdateLayerParams as aj, type VectorLayer as ak, type LayerFeature as al, type RasterValue as am, type LayerSchema as an, type LayerSchemaAttribute as ao, type LayerSchemaBooleanAttribute as ap, type LayerSchemaCommonAttribute as aq, type LayerSchemaDateAttribute as ar, type LayerSchemaDateTimeAttribute as as, type LayerSchemaNumericAttribute as at, type LayerSchemaTextAttribute as au, type FilterExpression as av, type FilterLogicGate as aw, type FilterTernary as ax, type Filters as ay, type GeometryFilter as az, type ColorBasemapInput as b, type UITextElementCreate as b$, type RasterHistogramBin as b0, type RasterPercentile as b1, type RasterProfileSample as b2, type LayersController as b3, type MapDetails as b4, type MiscController as b5, type ElementGroupNode as b6, type ElementNode as b7, type EntityNode as b8, type FeatureNode as b9, type NoteToolSettings as bA, type PinToolSettings as bB, type PlaceFrame as bC, type PlaceSymbol as bD, type PolygonToolSettings as bE, type RouteToolSettings as bF, type TextToolSettings as bG, type ToolSettingsChangeEvent as bH, type ToolSettingsMap as bI, type ToolType as bJ, type ToolsController as bK, type CreateActionTriggerParams as bL, type CreateFeatureActionParams as bM, type CreateOrUpdatePanelParams as bN, type CreatePanelElementsParams as bO, type DeletePanelElementsParams as bP, type UiOnMapInteractionsOptions as bQ, type UpdateActionTriggerParams as bR, type UpdateFeatureActionParams as bS, type UpdatePanelElementsParams as bT, type PlacementForUIElement as bU, type UIPanel as bV, type UIPanelCreateOrUpdate as bW, type UIButtonElement as bX, type UIButtonElementCreate as bY, type UIButtonElementUpdate as bZ, type UITextElement as b_, type FeatureSelection as ba, type LayerGroupNode as bb, type LayerNode as bc, type SelectionController as bd, type FeltBoundary as be, type FeltZoom as bf, type GeoJsonFeature as bg, type GeoJsonGeometry as bh, type GeoJsonProperties as bi, type LatLng as bj, type LineStringGeometry as bk, type LngLatTuple as bl, type MultiLineStringGeometry as bm, type MultiPointGeometry as bn, type MultiPolygonGeometry as bo, type PointGeometry as bp, type PolygonGeometry as bq, type SetVisibilityRequest as br, type SortConfig as bs, type SortDirection as bt, type CircleToolSettings as bu, type ConfigurableToolType as bv, type HighlighterToolSettings as bw, type InputToolSettings as bx, type LineToolSettings as by, type MarkerToolSettings as bz, type CustomTileBasemap as c, type UITextElementUpdate as c0, type UIFlexibleSpaceElement as c1, type UIFlexibleSpaceElementCreate as c2, type UIFlexibleSpaceElementUpdate as c3, type UIDividerElement as c4, type UIDividerElementCreate as c5, type UIDividerElementUpdate as c6, type UITextInputElement as c7, type UITextInputElementCreate as c8, type UITextInputElementUpdate as c9, type UIFeatureAction as cA, type UIFeatureActionCreate as cB, type UiController as cC, type SetViewportCenterZoomParams as cD, type ViewportConstraints as cE, type ViewportFitBoundsParams as cF, type ViewportState as cG, type ViewportController as cH, type UnwrapPromise as cI, uiActionTriggerSchema as cJ, uiFeatureActionSchema as cK, type UIPanelElementCreateClonable as cL, uiPanelCreateSchema as cM, type UIButtonElementCreateClonable as cN, type MakeClonableSchema as cO, type UIButtonRowElementCreateClonable as cP, type PromiseOrNot as cQ, type UnionToIntersection as cR, type UISelectElement as ca, type UISelectElementCreate as cb, type UISelectElementUpdate as cc, type UIPanelElement as cd, type UIPanelElementCreate as ce, type UIPanelElementUpdate as cf, type UIGridContainerElement as cg, type UIGridContainerElementCreate as ch, type UIGridContainerElementUpdate as ci, type UIButtonRowElement as cj, type UIButtonRowElementCreate as ck, type UIButtonRowElementUpdate as cl, type UICheckboxGroupElement as cm, type UICheckboxGroupElementCreate as cn, type UICheckboxGroupElementUpdate as co, type UIRadioGroupElement as cp, type UIRadioGroupElementCreate as cq, type UIRadioGroupElementUpdate as cr, type UIToggleGroupElement as cs, type UIToggleGroupElementCreate as ct, type UIToggleGroupElementUpdate as cu, type UIIframeElement as cv, type UIIframeElementCreate as cw, type UIIframeElementUpdate as cx, type UIControlElementOption as cy, type UIActionTriggerCreate as cz, type CustomTileBasemapInput as d, type FeltBasemap as e, type CircleElementCreate as f, type CircleElementRead as g, type CircleElementUpdate as h, type ElementChangeCallbackParams as i, type ElementCreate as j, type ElementGroup as k, type ElementGroupChangeCallbackParams as l, type ElementUpdate as m, type GetElementsConstraint as n, type HighlighterElementRead as o, type HighlighterElementUpdate as p, type ImageElementRead as q, type ImageElementUpdate as r, type MarkerElementRead as s, type MarkerElementUpdate as t, type NoteElementRead as u, type NoteElementUpdate as v, type PathElementRead as w, type PathElementUpdate as x, type PlaceElementCreate as y, type zInfer as z };