@feltmaps/js-sdk 1.5.0-next.5 → 1.5.0-next.6

package/dist/{types-BKxKmuZn.d.cts → types-CQwkpLq-.d.cts}

@@ -1350,22 +1350,40 @@ interface LatLng {
  * GeoJSON.
  */
 type LngLatTuple = [longitude: number, latitude: number];
+interface PointGeometry extends zInfer<typeof PointGeometrySchema> {
+}
 /**
  * A GeoJSON point geometry.
  */
-type PointGeometry = {
+declare const PointGeometrySchema: z.ZodObject<{
+    type: z.ZodLiteral<"Point">;
+    coordinates: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+}, "strip", z.ZodTypeAny, {
     type: "Point";
-    coordinates: LngLatTuple;
-};
+    coordinates: [number, number];
+}, {
+    type: "Point";
+    coordinates: [number, number];
+}>;
+interface PolygonGeometry extends zInfer<typeof PolygonGeometrySchema> {
+}
 /**
  * A GeoJSON polygon geometry.
  */
-type PolygonGeometry = {
+declare const PolygonGeometrySchema: z.ZodObject<{
+    type: z.ZodLiteral<"Polygon">;
+    coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+}, "strip", z.ZodTypeAny, {
     type: "Polygon";
-    coordinates: LngLatTuple[][];
-};
+    coordinates: [number, number][][];
+}, {
+    type: "Polygon";
+    coordinates: [number, number][][];
+}>;
 /**
  * A GeoJSON multi-polygon geometry.
+ *
+ * @interface
  */
 type MultiPolygonGeometry = {
     type: "MultiPolygon";
@@ -1373,6 +1391,8 @@ type MultiPolygonGeometry = {
 };
 /**
  * A GeoJSON line string geometry.
+ *
+ * @interface
  */
 type LineStringGeometry = {
     type: "LineString";
@@ -1380,6 +1400,8 @@ type LineStringGeometry = {
 };
 /**
  * A GeoJSON multi-line string geometry.
+ *
+ * @interface
  */
 type MultiLineStringGeometry = {
     type: "MultiLineString";
@@ -1945,6 +1967,582 @@ interface LayerFilters {
     combined: Filters;
 }
 
+declare const AggregateMethodSchema: z.ZodEnum<["avg", "max", "min", "sum", "median"]>;
+declare const AggregationConfigSchema: z.ZodObject<{
+    /**
+     * The operation to use on the values from the features in the layer
+     */
+    method: z.ZodEnum<["avg", "max", "min", "sum", "median"]>;
+    /**
+     * The attribute to use for the aggregation. This must be a numeric attribute.
+     */
+    attribute: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    attribute: string;
+    method: "avg" | "max" | "min" | "sum" | "median";
+}, {
+    attribute: string;
+    method: "avg" | "max" | "min" | "sum" | "median";
+}>;
+declare const MutliAggregationConfigSchema: z.ZodObject<{
+    /**
+     * The operations to use on the values from the features in the layer
+     */
+    methods: z.ZodArray<z.ZodUnion<[z.ZodEnum<["avg", "max", "min", "sum", "median"]>, z.ZodLiteral<"count">]>, "many">;
+    /**
+     * The attribute to use for the aggregation. This must be a numeric attribute.
+     */
+    attribute: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    methods: ("avg" | "max" | "min" | "sum" | "median" | "count")[];
+    attribute?: string | undefined;
+}, {
+    methods: ("avg" | "max" | "min" | "sum" | "median" | "count")[];
+    attribute?: string | undefined;
+}>;
+/**
+ * Defines how to aggregate a value across features in a layer.
+ */
+interface AggregationConfig extends zInfer<typeof AggregationConfigSchema> {
+    /**
+     * The method to use for the aggregation.
+     */
+    method: AggregationMethod;
+}
+/**
+ * The method to use for the aggregation.
+ */
+type AggregationMethod = z.infer<typeof AggregateMethodSchema>;
+/**
+ * Defines how to aggregate a value across features in a layer with multiple aggregations
+ * returned at once.
+ */
+interface MultiAggregationConfig<T extends AggregationMethod | "count"> extends zInfer<typeof MutliAggregationConfigSchema> {
+    methods: T[];
+    /**
+     * The attribute to use for the aggregation when aggregations other than "count" are used.
+     *
+     * This can be omitted if the only aggregation is "count", but must be a numeric attribute
+     * otherwise.
+     */
+    attribute?: string;
+}
+declare const ValueConfigurationSchema: z.ZodObject<{
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        type: z.ZodLiteral<"Polygon">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>>;
+    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.ZodOptional<z.ZodObject<{
+        /**
+         * The operation to use on the values from the features in the layer
+         */
+        method: z.ZodEnum<["avg", "max", "min", "sum", "median"]>;
+        /**
+         * The attribute to use for the aggregation. This must be a numeric attribute.
+         */
+        attribute: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        attribute: string;
+        method: "avg" | "max" | "min" | "sum" | "median";
+    }, {
+        attribute: string;
+        method: "avg" | "max" | "min" | "sum" | "median";
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+    aggregation?: {
+        attribute: string;
+        method: "avg" | "max" | "min" | "sum" | "median";
+    } | undefined;
+}, {
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+    aggregation?: {
+        attribute: string;
+        method: "avg" | "max" | "min" | "sum" | "median";
+    } | undefined;
+}>;
+/**
+ * Configuration for filtering and aggregating values across features.
+ *
+ * This can be used to restrict the features considered for aggregation via the `boundary`
+ * and `filters` properties.
+ *
+ * It can also be used to specify how to aggregate the values via the `aggregation` property.
+ */
+interface ValueConfiguration extends zInfer<typeof ValueConfigurationSchema> {
+    /**
+     * A spatial boundary to filter what gets counted or aggregated, while still including
+     * all possible categories or bin ranges in the results.
+     */
+    boundary?: PolygonGeometry | LngLatTuple[] | FeltBoundary;
+    /**
+     * Attribute filters to determine what gets counted or aggregated, while still including
+     * all possible categories or bin ranges in the results.
+     */
+    filters?: Filters;
+    /**
+     * Specifies how to aggregate values within each category or bin. When omitted,
+     * features are counted. When specified, the chosen calculation (avg, sum, etc.)
+     * is performed on the specified attribute.
+     *
+     * For example, instead of counting buildings in each category, you might want
+     * to sum their square footage or average their assessed values.
+     */
+    aggregation?: AggregationConfig;
+}
+declare const GetLayerCategoriesParamsSchema: z.ZodObject<{
+    /**
+     * The ID of the layer to get categories from.
+     */
+    layerId: z.ZodString;
+    /**
+     * The attribute to use for categorization.
+     */
+    attribute: z.ZodString;
+    /**
+     * The maximum number of categories to return.
+     */
+    limit: z.ZodOptional<z.ZodNumber>;
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        type: z.ZodLiteral<"Polygon">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>>;
+    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]>>;
+    values: z.ZodOptional<z.ZodObject<{
+        boundary: z.ZodOptional<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+            type: z.ZodLiteral<"Polygon">;
+            coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        }, {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>>;
+        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.ZodOptional<z.ZodObject<{
+            /**
+             * The operation to use on the values from the features in the layer
+             */
+            method: z.ZodEnum<["avg", "max", "min", "sum", "median"]>;
+            /**
+             * The attribute to use for the aggregation. This must be a numeric attribute.
+             */
+            attribute: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        }, {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    }, {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    layerId: string;
+    attribute: string;
+    values?: {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    } | undefined;
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+    limit?: number | undefined;
+}, {
+    layerId: string;
+    attribute: string;
+    values?: {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    } | undefined;
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+    limit?: number | undefined;
+}>;
+/**
+ * The parameters for getting categories from a layer, passed to
+ * the {@link LayersController.getCategoryData} method.
+ */
+interface GetLayerCategoriesParams extends zInfer<typeof GetLayerCategoriesParamsSchema> {
+    /**
+     * Attribute filters to determine what gets counted or aggregated.
+     */
+    filters?: Filters;
+    /**
+     * A spatial boundary to filter what gets counted or aggregated. This can be either
+     * a [w, s, e, n] bounding box, a GeoJSON Polygon geometry, or a list of coordinates
+     * that form a polyline.
+     */
+    boundary?: PolygonGeometry | LngLatTuple[] | FeltBoundary;
+    /**
+     * Configuration for filtering and aggregating values while preserving the full set of
+     * categories in the results.
+     *
+     * This is particularly useful when you want to compare different subsets of data while
+     * maintaining consistent categories. For example:
+     *
+     * - Show all building types in a city, but only count recent buildings in each type
+     * - Keep all neighborhood categories but only sum up residential square footage
+     *
+     * Unlike top-level filters which affect both what categories appear AND their values,
+     * filters in this configuration only affect the values while keeping all possible
+     * categories in the results.
+     */
+    values?: ValueConfiguration;
+}
+declare const GetLayerCategoriesGroupSchema: z.ZodObject<{
+    /**
+     * The category for which the value was calculated.
+     */
+    key: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodBoolean]>;
+    /**
+     * The value calculated for the category, whether a count, sum, average, etc.
+     *
+     * `null` is returned if there are no features in the category as opposed to zero,
+     * so as not to confuse with a real zero value from some aggregation.
+     */
+    value: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value: number | null;
+    key: string | number | boolean;
+}, {
+    value: number | null;
+    key: string | number | boolean;
+}>;
+/**
+ * A single category from the response from the {@link LayersController.getCategoryData} method.
+ */
+interface GetLayerCategoriesGroup extends zInfer<typeof GetLayerCategoriesGroupSchema> {
+}
+declare const GetLayerHistogramParamsSchema: z.ZodObject<{
+    layerId: z.ZodString;
+    attribute: z.ZodString;
+    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.ZodObject<{
+        type: z.ZodLiteral<"time-interval">;
+        interval: z.ZodEnum<["hour", "day", "week", "month", "year"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "time-interval";
+        interval: "hour" | "day" | "week" | "month" | "year";
+    }, {
+        type: "time-interval";
+        interval: "hour" | "day" | "week" | "month" | "year";
+    }>, z.ZodArray<z.ZodNumber, "many">]>;
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        type: z.ZodLiteral<"Polygon">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>>;
+    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]>>;
+    /**
+     * Configuration for filtering and aggregating values while preserving the full set of
+     * bin ranges in the results.
+     *
+     * This is particularly useful when you want to compare different subsets of data while
+     * maintaining consistent ranges. For example:
+     *
+     * - Use the same height ranges for comparing old vs new buildings
+     *
+     * Unlike top-level filters which affect both what ranges appear AND their values,
+     * filters in this configuration only affect the values while keeping all possible
+     * ranges in the results.
+     */
+    values: z.ZodOptional<z.ZodObject<{
+        boundary: z.ZodOptional<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+            type: z.ZodLiteral<"Polygon">;
+            coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        }, {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>>;
+        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.ZodOptional<z.ZodObject<{
+            /**
+             * The operation to use on the values from the features in the layer
+             */
+            method: z.ZodEnum<["avg", "max", "min", "sum", "median"]>;
+            /**
+             * The attribute to use for the aggregation. This must be a numeric attribute.
+             */
+            attribute: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        }, {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    }, {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    layerId: string;
+    attribute: string;
+    steps: number[] | {
+        type: "equal-intervals";
+        count: number;
+    } | {
+        type: "time-interval";
+        interval: "hour" | "day" | "week" | "month" | "year";
+    };
+    values?: {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    } | undefined;
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+}, {
+    layerId: string;
+    attribute: string;
+    steps: number[] | {
+        type: "equal-intervals";
+        count: number;
+    } | {
+        type: "time-interval";
+        interval: "hour" | "day" | "week" | "month" | "year";
+    };
+    values?: {
+        boundary?: [number, number][] | {
+            type: "Polygon";
+            coordinates: [number, number][][];
+        } | [number, number, number, number] | undefined;
+        filters?: boolean | [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] | FilterTernary | null | undefined;
+        aggregation?: {
+            attribute: string;
+            method: "avg" | "max" | "min" | "sum" | "median";
+        } | undefined;
+    } | undefined;
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+}>;
+/**
+ * The params used to request a histogram of values from a layer, passed to
+ * the {@link LayersController.getHistogramData} method.
+ */
+interface GetLayerHistogramParams extends zInfer<typeof GetLayerHistogramParamsSchema> {
+    /**
+     * Attribute filters to determine what gets counted or aggregated.
+     */
+    filters?: Filters;
+    /**
+     * A spatial boundary to filter what gets counted or aggregated. This can be either
+     * a [w, s, e, n] bounding box, a GeoJSON Polygon geometry, or a list of coordinates
+     * that form a polyline.
+     */
+    boundary?: PolygonGeometry | LngLatTuple[] | FeltBoundary;
+}
+declare const GetLayerHistogramBinSchema: z.ZodObject<{
+    /**
+     * The left edge of the bin.
+     */
+    min: z.ZodNumber;
+    /**
+     * The right edge of the bin.
+     */
+    max: z.ZodNumber;
+    /**
+     * The number of features 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 from the {@link LayersController.getHistogramData} method.
+ */
+interface GetLayerHistogramBin extends zInfer<typeof GetLayerHistogramBinSchema> {
+}
+declare const GetLayerCalculationParamsSchema: z.ZodObject<{
+    /**
+     * The ID of the layer to calculate an aggregate value for.
+     */
+    layerId: z.ZodString;
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodObject<{
+        type: z.ZodLiteral<"Polygon">;
+        coordinates: z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }, {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    }>, z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, "many">]>>;
+    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<{
+        /**
+         * The operations to use on the values from the features in the layer
+         */
+        methods: z.ZodArray<z.ZodUnion<[z.ZodEnum<["avg", "max", "min", "sum", "median"]>, z.ZodLiteral<"count">]>, "many">;
+        /**
+         * The attribute to use for the aggregation. This must be a numeric attribute.
+         */
+        attribute: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "count")[];
+        attribute?: string | undefined;
+    }, {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "count")[];
+        attribute?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    layerId: string;
+    aggregation: {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "count")[];
+        attribute?: string | undefined;
+    };
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+}, {
+    layerId: string;
+    aggregation: {
+        methods: ("avg" | "max" | "min" | "sum" | "median" | "count")[];
+        attribute?: string | undefined;
+    };
+    boundary?: [number, number][] | {
+        type: "Polygon";
+        coordinates: [number, number][][];
+    } | [number, number, number, number] | undefined;
+    filters?: boolean | [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] | FilterTernary | null | undefined;
+}>;
+/**
+ * The parameters for calculating a single aggregate value for a layer, passed to
+ * the {@link LayersController.getAggregates} method.
+ */
+interface GetLayerCalculationParams<T extends AggregationMethod | "count"> extends z.infer<typeof GetLayerCalculationParamsSchema> {
+    /**
+     * Attribute filters to determine what gets counted or aggregated.
+     */
+    filters?: Filters;
+    /**
+     * A spatial boundary to filter what gets counted or aggregated. This can be either
+     * a [w, s, e, n] bounding box, a GeoJSON Polygon geometry, or a list of coordinates
+     * that form a polyline.
+     */
+    boundary?: PolygonGeometry | LngLatTuple[] | FeltBoundary;
+    /**
+     * Specifies how to aggregate values within each category or bin. When omitted,
+     * features are counted. When specified, the chosen calculation (avg, sum, etc.)
+     * is performed on the specified attribute.
+     */
+    aggregation: MultiAggregationConfig<T>;
+}
+
 /**
  * The event object passed to the interaction listeners.
  */
@@ -2446,4 +3044,4 @@ declare const ViewportFitBoundsParamsSchema: z.ZodObject<{
     bounds: [number, number, number, number];
 }>;
 
-export type { NoteElementRead as $, ViewportConstraints as A, ViewportFitBoundsParams as B, ConfigurableToolType as C, ViewportCenterZoom as D, Element as E, Filters as F, Geometry as G, CircleElementCreate as H, InputToolSettings as I, CircleElementRead as J, CircleElementUpdate as K, Layer as L, MapInteractionEvent as M, HighlighterElementCreate as N, HighlighterElementRead as O, HighlighterElementUpdate as P, ImageElementCreate as Q, ImageElementRead as R, SetVisibilityRequest as S, ToolType as T, ImageElementUpdate as U, ViewportState as V, LinkElementRead as W, MarkerElementCreate as X, MarkerElementRead as Y, MarkerElementUpdate as Z, NoteElementCreate as _, GetElementsConstraint as a, NoteElementUpdate as a0, PathElementCreate as a1, PathElementRead as a2, PathElementUpdate as a3, PlaceElementCreate as a4, PlaceElementRead as a5, PlaceElementUpdate as a6, PolygonElementCreate as a7, PolygonElementRead as a8, PolygonElementUpdate as a9, NoteToolSettings as aA, PinToolSettings as aB, PlaceFrame as aC, PlaceSymbol as aD, PolygonToolSettings as aE, RouteToolSettings as aF, TextToolSettings as aG, UnionToIntersection as aH, PromiseOrNot as aI, TextElementCreate as aa, TextElementRead as ab, TextElementUpdate as ac, LayerProcessingStatus as ad, RasterValue as ae, FilterExpression as af, FilterLogicGate as ag, FilterTernary as ah, ElementGroupNode as ai, ElementNode as aj, FeatureNode as ak, LayerGroupNode as al, LayerNode as am, FeltBoundary as an, FeltZoom as ao, LatLng as ap, LineStringGeometry as aq, LngLatTuple as ar, MultiLineStringGeometry as as, MultiPolygonGeometry as at, PointGeometry as au, PolygonGeometry as av, CircleToolSettings as aw, HighlighterToolSettings as ax, LineToolSettings as ay, MarkerToolSettings as az, ElementGroup as b, GetElementGroupsConstraint as c, ElementChangeCallbackParams as d, ElementGroupChangeCallbackParams as e, ElementCreate as f, ElementUpdate as g, GetLayersConstraint as h, LayerChangeCallbackParams as i, LayerGroup as j, GetLayerGroupsConstraint as k, LayerGroupChangeCallbackParams as l, LegendItemIdentifier as m, LegendItem as n, LegendItemsConstraint as o, LegendItemChangeCallbackParams as p, LayerFilters as q, GetRenderedFeaturesConstraint as r, Feature as s, MapDetails as t, EntityNode as u, FeatureSelection as v, ToolSettingsMap as w, ToolSettingsChangeEvent as x, SetViewportCenterZoomParams as y, zInfer as z };
+export type { ImageElementUpdate as $, AggregationMethod as A, FeatureSelection as B, ConfigurableToolType as C, ToolSettingsMap as D, Element as E, Filters as F, Geometry as G, ToolSettingsChangeEvent as H, InputToolSettings as I, zInfer as J, SetViewportCenterZoomParams as K, Layer as L, MapInteractionEvent as M, ViewportConstraints as N, ViewportFitBoundsParams as O, ViewportCenterZoom as P, CircleElementCreate as Q, CircleElementRead as R, SetVisibilityRequest as S, ToolType as T, CircleElementUpdate as U, ViewportState as V, HighlighterElementCreate as W, HighlighterElementRead as X, HighlighterElementUpdate as Y, ImageElementCreate as Z, ImageElementRead as _, GetElementsConstraint as a, LinkElementRead as a0, MarkerElementCreate as a1, MarkerElementRead as a2, MarkerElementUpdate as a3, NoteElementCreate as a4, NoteElementRead as a5, NoteElementUpdate as a6, PathElementCreate as a7, PathElementRead as a8, PathElementUpdate as a9, LngLatTuple as aA, MultiLineStringGeometry as aB, MultiPolygonGeometry as aC, PointGeometry as aD, PolygonGeometry as aE, CircleToolSettings as aF, HighlighterToolSettings as aG, LineToolSettings as aH, MarkerToolSettings as aI, NoteToolSettings as aJ, PinToolSettings as aK, PlaceFrame as aL, PlaceSymbol as aM, PolygonToolSettings as aN, RouteToolSettings as aO, TextToolSettings as aP, UnionToIntersection as aQ, PromiseOrNot as aR, PlaceElementCreate as aa, PlaceElementRead as ab, PlaceElementUpdate as ac, PolygonElementCreate as ad, PolygonElementRead as ae, PolygonElementUpdate as af, TextElementCreate as ag, TextElementRead as ah, TextElementUpdate as ai, LayerProcessingStatus as aj, RasterValue as ak, FilterExpression as al, FilterLogicGate as am, FilterTernary as an, AggregationConfig as ao, MultiAggregationConfig as ap, ValueConfiguration as aq, ElementGroupNode as ar, ElementNode as as, FeatureNode as at, LayerGroupNode as au, LayerNode as av, FeltBoundary as aw, FeltZoom as ax, LatLng as ay, LineStringGeometry as az, ElementGroup as b, GetElementGroupsConstraint as c, ElementChangeCallbackParams as d, ElementGroupChangeCallbackParams as e, ElementCreate as f, ElementUpdate as g, GetLayersConstraint as h, LayerChangeCallbackParams as i, LayerGroup as j, GetLayerGroupsConstraint as k, LayerGroupChangeCallbackParams as l, LegendItemIdentifier as m, LegendItem as n, LegendItemsConstraint as o, LegendItemChangeCallbackParams as p, LayerFilters as q, GetRenderedFeaturesConstraint as r, Feature as s, GetLayerCategoriesParams as t, GetLayerCategoriesGroup as u, GetLayerHistogramParams as v, GetLayerHistogramBin as w, GetLayerCalculationParams as x, MapDetails as y, EntityNode as z };