@mcp-b/geo-support 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MCP-B contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/base/geo-map-element.d.ts

@@ -0,0 +1,60 @@
+import { type PropertyValues } from "lit";
+import { SigveloElement } from "@mcp-b/wc-support/base/sigvelo-element";
+import type { FlyToOptions, FitBoundsOptions } from "../types/map.js";
+/**
+ * Abstract base class for all geo map components. Provides shared reactive
+ * properties, ResizeObserver lifecycle, and abstract hooks for library-specific
+ * map creation and updates.
+ *
+ * Subclasses must implement `createMap`, `destroyMap`, `updateView`, and
+ * `invalidateSize`.
+ */
+export declare abstract class GeoMapElement extends SigveloElement {
+    static styles: import("lit").CSSResult[];
+    /** Map center latitude. */
+    latitude: number;
+    /** Map center longitude. */
+    longitude: number;
+    /** Map zoom level. */
+    zoom: number;
+    /** Minimum allowed zoom level. */
+    minZoom: number;
+    /** Maximum allowed zoom level. */
+    maxZoom: number;
+    /** Map bearing (rotation) in degrees. Not all libraries support this. */
+    bearing: number;
+    /** Map pitch (tilt) in degrees. Not all libraries support this. */
+    pitch: number;
+    protected mapHost: HTMLDivElement;
+    private _resizeObserver;
+    /**
+     * When true, property changes from map interaction callbacks are suppressed
+     * to avoid re-triggering `updateView`. Subclasses should set this to `true`
+     * before syncing properties from the map, and back to `false` after.
+     */
+    protected _suppressExternalUpdate: boolean;
+    /**
+     * Resolved when the underlying map instance is ready. Child components
+     * (markers, layers, controls) should await this before registering.
+     */
+    readonly mapReady: Promise<void>;
+    protected _resolveMapReady: () => void;
+    constructor();
+    /** Create the map instance and attach it to the given container element. */
+    protected abstract createMap(container: HTMLElement): void;
+    /** Destroy the map instance and clean up resources. */
+    protected abstract destroyMap(): void;
+    /** Update the map view when reactive properties change. */
+    protected abstract updateView(changed: PropertyValues): void;
+    /** Notify the map library that its container has been resized. */
+    protected abstract invalidateSize(): void;
+    /** Programmatically fly to a location. */
+    abstract flyTo(options: FlyToOptions): void;
+    /** Programmatically fit the map to bounds. */
+    abstract fitBounds(options: FitBoundsOptions): void;
+    protected firstUpdated(changed: PropertyValues): void;
+    protected updated(changed: PropertyValues): void;
+    disconnectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=geo-map-element.d.ts.map

package/dist/base/geo-map-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-map-element.d.ts","sourceRoot":"","sources":["../../src/base/geo-map-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;;;;;;GAOG;AACH,8BAAsB,aAAc,SAAQ,cAAc;IACxD,MAAM,CAAC,MAAM,4BAA+B;IAE5C,2BAA2B;IACC,QAAQ,SAAK;IAEzC,4BAA4B;IACA,SAAS,SAAK;IAE1C,sBAAsB;IACM,IAAI,SAAK;IAErC,kCAAkC;IACiB,OAAO,SAAK;IAE/D,kCAAkC;IACiB,OAAO,SAAM;IAEhE,yEAAyE;IAC7C,OAAO,SAAK;IAExC,mEAAmE;IACvC,KAAK,SAAK;IAElB,SAAS,CAAC,OAAO,EAAG,cAAc,CAAC;IAEvD,OAAO,CAAC,eAAe,CAA+B;IAEtD;;;;OAIG;IACH,SAAS,CAAC,uBAAuB,UAAS;IAE1C;;;OAGG;IACH,SAAgB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,SAAS,CAAC,gBAAgB,EAAG,MAAM,IAAI,CAAC;;IASxC,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAE1D,uDAAuD;IACvD,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;IAErC,2DAA2D;IAC3D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAE5D,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,IAAI;IAEzC,0CAA0C;aAC1B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAElD,8CAA8C;aAC9B,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAE1D,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc;IAU9C,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc;IAOzC,oBAAoB;IAOpB,MAAM;CAMP"}

package/dist/base/geo-map-element.js

@@ -0,0 +1,100 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html } from "lit";
+import { property, query } from "lit/decorators.js";
+import { SigveloElement } from "@mcp-b/wc-support/base/sigvelo-element";
+import hostStyles from "@mcp-b/wc-support/styles/host.styles";
+import mapHostStyles from "../styles/map-host.styles.js";
+/**
+ * Abstract base class for all geo map components. Provides shared reactive
+ * properties, ResizeObserver lifecycle, and abstract hooks for library-specific
+ * map creation and updates.
+ *
+ * Subclasses must implement `createMap`, `destroyMap`, `updateView`, and
+ * `invalidateSize`.
+ */
+export class GeoMapElement extends SigveloElement {
+    constructor() {
+        super();
+        /** Map center latitude. */
+        this.latitude = 0;
+        /** Map center longitude. */
+        this.longitude = 0;
+        /** Map zoom level. */
+        this.zoom = 2;
+        /** Minimum allowed zoom level. */
+        this.minZoom = 0;
+        /** Maximum allowed zoom level. */
+        this.maxZoom = 22;
+        /** Map bearing (rotation) in degrees. Not all libraries support this. */
+        this.bearing = 0;
+        /** Map pitch (tilt) in degrees. Not all libraries support this. */
+        this.pitch = 0;
+        this._resizeObserver = null;
+        /**
+         * When true, property changes from map interaction callbacks are suppressed
+         * to avoid re-triggering `updateView`. Subclasses should set this to `true`
+         * before syncing properties from the map, and back to `false` after.
+         */
+        this._suppressExternalUpdate = false;
+        this.mapReady = new Promise((resolve) => {
+            this._resolveMapReady = resolve;
+        });
+    }
+    firstUpdated(changed) {
+        super.firstUpdated(changed);
+        this.createMap(this.mapHost);
+        this._resizeObserver = new ResizeObserver(() => {
+            this.invalidateSize();
+        });
+        this._resizeObserver.observe(this.mapHost);
+    }
+    updated(changed) {
+        super.updated(changed);
+        if (!this._suppressExternalUpdate) {
+            this.updateView(changed);
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this._resizeObserver?.disconnect();
+        this._resizeObserver = null;
+        this.destroyMap();
+    }
+    render() {
+        return html `
+      <div class="map-host" part="map"></div>
+      <slot></slot>
+    `;
+    }
+}
+GeoMapElement.styles = [hostStyles, mapHostStyles];
+__decorate([
+    property({ type: Number })
+], GeoMapElement.prototype, "latitude", void 0);
+__decorate([
+    property({ type: Number })
+], GeoMapElement.prototype, "longitude", void 0);
+__decorate([
+    property({ type: Number })
+], GeoMapElement.prototype, "zoom", void 0);
+__decorate([
+    property({ attribute: "min-zoom", type: Number })
+], GeoMapElement.prototype, "minZoom", void 0);
+__decorate([
+    property({ attribute: "max-zoom", type: Number })
+], GeoMapElement.prototype, "maxZoom", void 0);
+__decorate([
+    property({ type: Number })
+], GeoMapElement.prototype, "bearing", void 0);
+__decorate([
+    property({ type: Number })
+], GeoMapElement.prototype, "pitch", void 0);
+__decorate([
+    query(".map-host")
+], GeoMapElement.prototype, "mapHost", void 0);
+//# sourceMappingURL=geo-map-element.js.map

package/dist/base/geo-map-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-map-element.js","sourceRoot":"","sources":["../../src/base/geo-map-element.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,UAAU,MAAM,sCAAsC,CAAC;AAC9D,OAAO,aAAa,MAAM,8BAA8B,CAAC;AAGzD;;;;;;;GAOG;AACH,MAAM,OAAgB,aAAc,SAAQ,cAAc;IA0CxD;QACE,KAAK,EAAE,CAAC;QAxCV,2BAA2B;QACC,aAAQ,GAAG,CAAC,CAAC;QAEzC,4BAA4B;QACA,cAAS,GAAG,CAAC,CAAC;QAE1C,sBAAsB;QACM,SAAI,GAAG,CAAC,CAAC;QAErC,kCAAkC;QACiB,YAAO,GAAG,CAAC,CAAC;QAE/D,kCAAkC;QACiB,YAAO,GAAG,EAAE,CAAC;QAEhE,yEAAyE;QAC7C,YAAO,GAAG,CAAC,CAAC;QAExC,mEAAmE;QACvC,UAAK,GAAG,CAAC,CAAC;QAI9B,oBAAe,GAA0B,IAAI,CAAC;QAEtD;;;;WAIG;QACO,4BAAuB,GAAG,KAAK,CAAC;QAWxC,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAoBS,YAAY,CAAC,OAAuB;QAC5C,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE7B,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE;YAC7C,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAES,OAAO,CAAC,OAAuB;QACvC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,oBAAoB;QAClB,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC7B,IAAI,CAAC,eAAe,EAAE,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAA;;;KAGV,CAAC;IACJ,CAAC;;AA/FM,oBAAM,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,AAA9B,CAA+B;AAGhB;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;+CAAc;AAGb;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gDAAe;AAGd;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;2CAAU;AAGc;IAAlD,QAAQ,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;8CAAa;AAGZ;IAAlD,QAAQ,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;8CAAc;AAGpC;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;8CAAa;AAGZ;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;4CAAW;AAER;IAA7B,KAAK,CAAC,WAAW,CAAC;8CAAoC"}

package/dist/classification/algorithms.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Classification algorithms for choropleth mapping.
+ * All break functions return `numClasses + 1` values: [min, break1, ..., max].
+ */
+/**
+ * Equal interval classification.
+ * Divides the range [min, max] into equal-width bins.
+ */
+export declare function equalInterval(values: number[], numClasses: number): number[];
+/**
+ * Quantile classification.
+ * Splits sorted values into groups of approximately equal count.
+ */
+export declare function quantileBreaks(values: number[], numClasses: number): number[];
+/**
+ * Natural breaks (Jenks-Fisher) classification.
+ * Minimizes within-class variance using dynamic programming.
+ */
+export declare function naturalBreaks(values: number[], numClasses: number): number[];
+/**
+ * Returns the class index (0-based) for a value given a breaks array.
+ * The breaks array has `numClasses + 1` entries: [min, break1, ..., max].
+ * Returns -1 for NaN/null/undefined values.
+ */
+export declare function classifyValue(value: number, breaks: number[]): number;
+//# sourceMappingURL=algorithms.d.ts.map

package/dist/classification/algorithms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithms.d.ts","sourceRoot":"","sources":["../../src/classification/algorithms.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAK5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAY7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAiE5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAOrE"}

package/dist/classification/algorithms.js

@@ -0,0 +1,101 @@
+/**
+ * Classification algorithms for choropleth mapping.
+ * All break functions return `numClasses + 1` values: [min, break1, ..., max].
+ */
+/**
+ * Equal interval classification.
+ * Divides the range [min, max] into equal-width bins.
+ */
+export function equalInterval(values, numClasses) {
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    const step = (max - min) / numClasses;
+    return Array.from({ length: numClasses + 1 }, (_, i) => min + i * step);
+}
+/**
+ * Quantile classification.
+ * Splits sorted values into groups of approximately equal count.
+ */
+export function quantileBreaks(values, numClasses) {
+    const sorted = [...values].toSorted((a, b) => a - b);
+    const n = sorted.length;
+    const breaks = [sorted[0]];
+    for (let i = 1; i < numClasses; i++) {
+        const idx = Math.floor((i / numClasses) * n);
+        breaks.push(sorted[Math.min(idx, n - 1)]);
+    }
+    breaks.push(sorted[n - 1]);
+    return breaks;
+}
+/**
+ * Natural breaks (Jenks-Fisher) classification.
+ * Minimizes within-class variance using dynamic programming.
+ */
+export function naturalBreaks(values, numClasses) {
+    const sorted = [...values].toSorted((a, b) => a - b);
+    const n = sorted.length;
+    if (n <= numClasses) {
+        return [...sorted, sorted[n - 1]];
+    }
+    // Lower class limits matrix: lc[i][j] = start index for class j considering first i values
+    const lc = Array.from({ length: n + 1 }, () => Array.from({ length: numClasses + 1 }, () => 0));
+    // Variance combinations matrix
+    const vc = Array.from({ length: n + 1 }, () => {
+        const row = Array.from({ length: numClasses + 1 }, () => Infinity);
+        return row;
+    });
+    for (let j = 1; j <= numClasses; j++) {
+        lc[1][j] = 1;
+        vc[1][j] = 0;
+    }
+    for (let l = 2; l <= n; l++) {
+        let sum = 0;
+        let sumSq = 0;
+        for (let m = 1; m <= l; m++) {
+            const lower = l - m + 1;
+            const val = sorted[lower - 1];
+            sum += val;
+            sumSq += val * val;
+            const variance = sumSq - (sum * sum) / m;
+            const i = lower - 1;
+            if (i !== 0) {
+                for (let j = 2; j <= numClasses; j++) {
+                    const candidate = variance + vc[i][j - 1];
+                    if (vc[l][j] >= candidate) {
+                        lc[l][j] = lower;
+                        vc[l][j] = candidate;
+                    }
+                }
+            }
+            lc[l][1] = 1;
+            vc[l][1] = sumSq - (sum * sum) / l;
+        }
+    }
+    // Extract breaks by backtracking through the lower class limits matrix
+    const breaks = Array.from({ length: numClasses + 1 }, () => 0);
+    breaks[numClasses] = sorted[n - 1];
+    breaks[0] = sorted[0];
+    let k = n;
+    for (let j = numClasses; j >= 2; j--) {
+        const idx = lc[k][j] - 1;
+        breaks[j - 1] = sorted[idx];
+        k = lc[k][j] - 1;
+    }
+    return breaks;
+}
+/**
+ * Returns the class index (0-based) for a value given a breaks array.
+ * The breaks array has `numClasses + 1` entries: [min, break1, ..., max].
+ * Returns -1 for NaN/null/undefined values.
+ */
+export function classifyValue(value, breaks) {
+    if (value == null || Number.isNaN(value))
+        return -1;
+    const numClasses = breaks.length - 1;
+    for (let i = 1; i <= numClasses; i++) {
+        if (value <= breaks[i])
+            return i - 1;
+    }
+    return numClasses - 1;
+}
+//# sourceMappingURL=algorithms.js.map

package/dist/classification/algorithms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithms.js","sourceRoot":"","sources":["../../src/classification/algorithms.ts"],"names":[],"mappings":"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"}

package/dist/classification/channel.d.ts

@@ -0,0 +1,16 @@
+import type { ClassificationMethod, StyleFunction } from "../types/style.js";
+/** Payload published when classification settings change. */
+export interface ClassifyUpdateDetail {
+    styleFunction: StyleFunction;
+    breaks: number[];
+    colors: string[];
+    property: string;
+    method: ClassificationMethod;
+}
+type ClassifyUpdateHandler = (detail: ClassifyUpdateDetail) => void;
+/** Subscribe to classification updates on a named channel. Returns an unsubscribe function. */
+export declare function subscribeClassify(channelId: string, handler: ClassifyUpdateHandler): () => void;
+/** Publish a classification update to all subscribers on a named channel. */
+export declare function publishClassify(channelId: string, detail: ClassifyUpdateDetail): void;
+export {};
+//# sourceMappingURL=channel.d.ts.map

package/dist/classification/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/classification/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE7E,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAIpE,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAQ/F;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,QAE9E"}

package/dist/classification/channel.js

@@ -0,0 +1,18 @@
+const channels = new Map();
+/** Subscribe to classification updates on a named channel. Returns an unsubscribe function. */
+export function subscribeClassify(channelId, handler) {
+    if (!channels.has(channelId))
+        channels.set(channelId, new Set());
+    channels.get(channelId).add(handler);
+    return () => {
+        const subs = channels.get(channelId);
+        subs?.delete(handler);
+        if (subs?.size === 0)
+            channels.delete(channelId);
+    };
+}
+/** Publish a classification update to all subscribers on a named channel. */
+export function publishClassify(channelId, detail) {
+    channels.get(channelId)?.forEach((handler) => handler(detail));
+}
+//# sourceMappingURL=channel.js.map

package/dist/classification/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/classification/channel.ts"],"names":[],"mappings":"AAaA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAC;AAE/D,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAA8B;IACjF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IACjE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,GAAG,EAAE;QACV,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,IAAI,EAAE,IAAI,KAAK,CAAC;YAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAA4B;IAC7E,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/classification/classify-style.d.ts

@@ -0,0 +1,25 @@
+import type { GeoJsonFeature } from "../types/geojson.js";
+import type { ClassifyResult, ClassifyStyleOptions } from "../types/style.js";
+/**
+ * Creates a {@link StyleFunction} that classifies features by a numeric property
+ * and assigns fill colors from a color scheme.
+ *
+ * @param features - The full set of features (used to compute classification breaks).
+ * @param options  - Classification configuration.
+ * @returns A {@link ClassifyResult} containing the style function, breaks, and colors.
+ *
+ * @example
+ * ```ts
+ * const { styleFunction, breaks, colors } = createClassifyStyle(statesData.features, {
+ *   property: 'density',
+ *   method: 'naturalBreaks',
+ *   numClasses: 5,
+ *   colorScheme: 'Blues',
+ * })
+ * geojsonEl.styleFunction = styleFunction
+ * legendEl.breaks = breaks
+ * legendEl.colors = colors
+ * ```
+ */
+export declare function createClassifyStyle(features: GeoJsonFeature[], options: ClassifyStyleOptions): ClassifyResult;
+//# sourceMappingURL=classify-style.d.ts.map

package/dist/classification/classify-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-style.d.ts","sourceRoot":"","sources":["../../src/classification/classify-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAgB,MAAM,mBAAmB,CAAC;AAI5F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,cAAc,CAiDhB"}

package/dist/classification/classify-style.js

@@ -0,0 +1,70 @@
+import { classifyValue, equalInterval, naturalBreaks, quantileBreaks } from "./algorithms.js";
+import { getSchemeColors } from "./color-schemes.js";
+/**
+ * Creates a {@link StyleFunction} that classifies features by a numeric property
+ * and assigns fill colors from a color scheme.
+ *
+ * @param features - The full set of features (used to compute classification breaks).
+ * @param options  - Classification configuration.
+ * @returns A {@link ClassifyResult} containing the style function, breaks, and colors.
+ *
+ * @example
+ * ```ts
+ * const { styleFunction, breaks, colors } = createClassifyStyle(statesData.features, {
+ *   property: 'density',
+ *   method: 'naturalBreaks',
+ *   numClasses: 5,
+ *   colorScheme: 'Blues',
+ * })
+ * geojsonEl.styleFunction = styleFunction
+ * legendEl.breaks = breaks
+ * legendEl.colors = colors
+ * ```
+ */
+export function createClassifyStyle(features, options) {
+    const { property, method, numClasses, colorScheme } = options;
+    const values = features
+        .map((f) => f.properties?.[property])
+        .filter((v) => typeof v === "number" && !Number.isNaN(v));
+    if (values.length === 0) {
+        return { styleFunction: () => undefined, breaks: [], colors: [], property, method };
+    }
+    let breaks;
+    switch (method) {
+        case "equalInterval":
+            breaks = equalInterval(values, numClasses);
+            break;
+        case "quantile":
+            breaks = quantileBreaks(values, numClasses);
+            break;
+        case "naturalBreaks":
+            breaks = naturalBreaks(values, numClasses);
+            break;
+    }
+    const colors = getSchemeColors(colorScheme, numClasses);
+    if (!colors) {
+        return { styleFunction: () => undefined, breaks: [], colors: [], property, method };
+    }
+    const fillOpacity = options.fillOpacity ?? 0.7;
+    const styleFunction = (feature) => {
+        const value = feature.properties?.[property];
+        if (typeof value !== "number" || Number.isNaN(value))
+            return undefined;
+        const idx = classifyValue(value, breaks);
+        if (idx < 0 || idx >= colors.length)
+            return undefined;
+        const style = {
+            fillColor: colors[idx],
+            fillOpacity,
+        };
+        if (options.strokeColor != null)
+            style.strokeColor = options.strokeColor;
+        if (options.strokeWidth != null)
+            style.strokeWidth = options.strokeWidth;
+        if (options.strokeOpacity != null)
+            style.strokeOpacity = options.strokeOpacity;
+        return style;
+    };
+    return { styleFunction, breaks, colors, property, method };
+}
+//# sourceMappingURL=classify-style.js.map

package/dist/classification/classify-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-style.js","sourceRoot":"","sources":["../../src/classification/classify-style.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA0B,EAC1B,OAA6B;IAE7B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE9D,MAAM,MAAM,GAAG,QAAQ;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;SACpC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACtF,CAAC;IAED,IAAI,MAAgB,CAAC;IACrB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAe;YAClB,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,UAAU;YACb,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC5C,MAAM;QACR,KAAK,eAAe;YAClB,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC3C,MAAM;IACV,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACtF,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAE/C,MAAM,aAAa,GAAG,CAAC,OAAuB,EAA4B,EAAE;QAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAEvE,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAEtD,MAAM,KAAK,GAAiB;YAC1B,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;YACtB,WAAW;SACZ,CAAC;QACF,IAAI,OAAO,CAAC,WAAW,IAAI,IAAI;YAAE,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACzE,IAAI,OAAO,CAAC,WAAW,IAAI,IAAI;YAAE,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACzE,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI;YAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC7D,CAAC"}

package/dist/classification/color-schemes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ColorBrewer-style color schemes for choropleth mapping.
+ * Keyed by scheme name for direct lookup.
+ *
+ * @see https://colorbrewer2.org
+ */
+import type { ColorSchemeType } from "../types/style.js";
+export interface ColorScheme {
+    name: string;
+    type: ColorSchemeType;
+    colors: Record<number, string[]>;
+}
+export declare const colorSchemes: Record<string, ColorScheme>;
+/** Look up a color scheme by name. */
+export declare function getColorScheme(name: string): ColorScheme | undefined;
+/** Get the color array for a scheme at a given class count. */
+export declare function getSchemeColors(name: string, numClasses: number): string[] | undefined;
+//# sourceMappingURL=color-schemes.d.ts.map

package/dist/classification/color-schemes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-schemes.d.ts","sourceRoot":"","sources":["../../src/classification/color-schemes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAmLpD,CAAC;AAEF,sCAAsC;AACtC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAEtF"}