@honua/app-platform 0.0.20-alpha.0

package/core/wmts.js

@@ -0,0 +1,332 @@
+/**
+ * First-party WMTS 1.0.0 adapter. `HonuaWmts` is the service-level
+ * handle returned by `client.wmts(serviceId)`; `HonuaWmtsLayer` is a
+ * single-layer projection that pre-fills LAYER and (optionally) STYLE;
+ * `HonuaWmtsTileset` adds a TileMatrixSet binding so per-call requests
+ * shrink to `{tileMatrix, tileRow, tileCol}`.
+ *
+ * The wire path lives on `HonuaClient` (`getWmtsCapabilities`,
+ * `fetchWmtsTile`, `getWmtsFeatureInfo`).
+ *
+ * @module
+ */
+import { encodeServiceIdPath } from "./path-utils.js";
+import { wmtsExtensionForFormat, } from "./wms-types.js";
+import { decodeWmsFeatureInfoResponse } from "./wms.js";
+import { findWmtsLayer, findWmtsTileMatrixSet, parseWmtsCapabilities } from "./wmts-capabilities.js";
+export class HonuaWmts {
+    client;
+    serviceId;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+    }
+    /** Bind a single LAYER + optional STYLE / TileMatrixSet defaults. */
+    layer(name, options) {
+        const opts = {
+            client: this.client,
+            serviceId: this.serviceId,
+            layerName: name,
+        };
+        if (options?.styleId !== undefined)
+            opts.defaultStyleId = options.styleId;
+        if (options?.tileMatrixSetId !== undefined)
+            opts.defaultTileMatrixSetId = options.tileMatrixSetId;
+        return new HonuaWmtsLayer(opts);
+    }
+    tileset(layerName, styleId, tileMatrixSetId) {
+        return new HonuaWmtsTileset({
+            client: this.client,
+            serviceId: this.serviceId,
+            layerName,
+            styleId,
+            tileMatrixSetId,
+        });
+    }
+    async capabilities(options) {
+        return this.client.getWmtsCapabilities({
+            serviceId: this.serviceId,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+    }
+    async tile(request) {
+        return this.client.fetchWmtsTile({ serviceId: this.serviceId, ...request });
+    }
+    async featureInfo(request) {
+        return this.client.getWmtsFeatureInfo({ serviceId: this.serviceId, ...request });
+    }
+}
+export class HonuaWmtsLayer {
+    client;
+    serviceId;
+    layerName;
+    defaultStyleId;
+    defaultTileMatrixSetId;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+        this.layerName = options.layerName;
+        this.defaultStyleId = options.defaultStyleId;
+        this.defaultTileMatrixSetId = options.defaultTileMatrixSetId;
+    }
+    describe(capabilities) {
+        return findWmtsLayer(capabilities, this.layerName);
+    }
+    tileset(styleId, tileMatrixSetId) {
+        const style = styleId ?? this.defaultStyleId ?? "default";
+        const tms = tileMatrixSetId ?? this.defaultTileMatrixSetId ?? "WebMercatorQuad";
+        return new HonuaWmtsTileset({
+            client: this.client,
+            serviceId: this.serviceId,
+            layerName: this.layerName,
+            styleId: style,
+            tileMatrixSetId: tms,
+        });
+    }
+    async tile(request) {
+        return this.client.fetchWmtsTile({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: request.style ?? this.defaultStyleId,
+            tileMatrixSet: request.tileMatrixSet ?? this.defaultTileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+    async featureInfo(request) {
+        return this.client.getWmtsFeatureInfo({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: request.style ?? this.defaultStyleId,
+            tileMatrixSet: request.tileMatrixSet ?? this.defaultTileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            i: request.i,
+            j: request.j,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.infoFormat !== undefined ? { infoFormat: request.infoFormat } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+}
+/**
+ * Tileset handle bound to (layer × style × tileMatrixSet). The runtime
+ * binding for MapLibre's `raster` source spec is keyed off this shape.
+ */
+export class HonuaWmtsTileset {
+    client;
+    serviceId;
+    layerName;
+    styleId;
+    tileMatrixSetId;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+        this.layerName = options.layerName;
+        this.styleId = options.styleId;
+        this.tileMatrixSetId = options.tileMatrixSetId;
+    }
+    describe(capabilities) {
+        return findWmtsTileMatrixSet(capabilities, this.tileMatrixSetId);
+    }
+    async tile(request) {
+        return this.client.fetchWmtsTile({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: this.styleId,
+            tileMatrixSet: this.tileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+    async featureInfo(request) {
+        return this.client.getWmtsFeatureInfo({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: this.styleId,
+            tileMatrixSet: this.tileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            i: request.i,
+            j: request.j,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.infoFormat !== undefined ? { infoFormat: request.infoFormat } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+}
+export function createHonuaWmts(client, serviceId) {
+    return new HonuaWmts({ client, serviceId });
+}
+// ── WMTS 1.0 wire methods ───────────────────────────────────────
+/** Canonical WMTS endpoint path. */
+function wmtsBasePath(serviceId) {
+    return `/rest/services/${encodeServiceIdPath(serviceId)}/MapServer/WMTS`;
+}
+export async function getWmtsCapabilities(transport, request) {
+    const params = new URLSearchParams();
+    params.set("SERVICE", "WMTS");
+    params.set("REQUEST", "GetCapabilities");
+    params.set("VERSION", "1.0.0");
+    const path = `${wmtsBasePath(request.serviceId)}?${params.toString()}`;
+    const { text: xml } = await transport.requestText("GET", path, {
+        accept: "text/xml,application/xml",
+        signal: request.signal,
+    });
+    return parseWmtsCapabilities(xml);
+}
+/**
+ * Fetch a single WMTS tile. `mode` selects between KVP
+ * (`?REQUEST=GetTile&...`) and the RESTful path
+ * (`/{layer}/{style}/{tms}/{z}/{y}/{x}.{ext}`). honua-server
+ * advertises both; the SDK defaults to RESTful because the wire path
+ * is a single string substitution per tile and skips
+ * URLSearchParams serialisation on the hot path.
+ */
+export async function fetchWmtsTile(transport, request) {
+    const mode = request.mode ?? "rest";
+    const format = request.format ?? "image/png";
+    const style = request.style ?? "default";
+    const tileMatrixSet = request.tileMatrixSet ?? "WebMercatorQuad";
+    if (mode === "kvp") {
+        const params = new URLSearchParams();
+        params.set("SERVICE", "WMTS");
+        params.set("VERSION", "1.0.0");
+        params.set("REQUEST", "GetTile");
+        params.set("LAYER", request.layer);
+        params.set("STYLE", style);
+        params.set("FORMAT", format);
+        params.set("TILEMATRIXSET", tileMatrixSet);
+        params.set("TILEMATRIX", String(request.tileMatrix));
+        params.set("TILEROW", String(request.tileRow));
+        params.set("TILECOL", String(request.tileCol));
+        if (request.extraParams) {
+            for (const [key, value] of Object.entries(request.extraParams)) {
+                params.set(key, String(value));
+            }
+        }
+        const path = `${wmtsBasePath(request.serviceId)}?${params.toString()}`;
+        return transport.requestBytes("GET", path, format, undefined, request.signal);
+    }
+    const ext = wmtsExtensionForFormat(format);
+    const base = wmtsBasePath(request.serviceId);
+    const layer = encodeURIComponent(request.layer);
+    const styleSeg = encodeURIComponent(style);
+    const tmsSeg = encodeURIComponent(tileMatrixSet);
+    const tm = encodeURIComponent(String(request.tileMatrix));
+    const tr = encodeURIComponent(String(request.tileRow));
+    const tc = encodeURIComponent(String(request.tileCol));
+    const extra = wmtsRestExtraParamsSuffix(request.extraParams);
+    const path = `${base}/${layer}/${styleSeg}/${tmsSeg}/${tm}/${tr}/${tc}.${ext}${extra}`;
+    return transport.requestBytes("GET", path, format, undefined, request.signal);
+}
+/**
+ * WMTS GetFeatureInfo. honua-server accepts both KVP and RESTful
+ * routing; mode default mirrors `fetchWmtsTile`.
+ */
+export async function getWmtsFeatureInfo(transport, request) {
+    const mode = request.mode ?? "rest";
+    const infoFormat = request.infoFormat ?? "application/json";
+    const format = request.format ?? "image/png";
+    const style = request.style ?? "default";
+    const tileMatrixSet = request.tileMatrixSet ?? "WebMercatorQuad";
+    if (mode === "kvp") {
+        const params = new URLSearchParams();
+        params.set("SERVICE", "WMTS");
+        params.set("VERSION", "1.0.0");
+        params.set("REQUEST", "GetFeatureInfo");
+        params.set("LAYER", request.layer);
+        params.set("STYLE", style);
+        params.set("FORMAT", format);
+        params.set("TILEMATRIXSET", tileMatrixSet);
+        params.set("TILEMATRIX", String(request.tileMatrix));
+        params.set("TILEROW", String(request.tileRow));
+        params.set("TILECOL", String(request.tileCol));
+        params.set("I", String(Math.trunc(request.i)));
+        params.set("J", String(Math.trunc(request.j)));
+        params.set("INFOFORMAT", infoFormat);
+        if (request.extraParams) {
+            for (const [key, value] of Object.entries(request.extraParams)) {
+                params.set(key, String(value));
+            }
+        }
+        const path = `${wmtsBasePath(request.serviceId)}?${params.toString()}`;
+        const response = await transport.requestBytes("GET", path, infoFormat, undefined, request.signal);
+        return decodeWmsFeatureInfoResponse(response.bytes, response.contentType, infoFormat);
+    }
+    const ext = wmtsFeatureInfoExtensionForFormat(infoFormat);
+    const base = wmtsBasePath(request.serviceId);
+    const layer = encodeURIComponent(request.layer);
+    const styleSeg = encodeURIComponent(style);
+    const tmsSeg = encodeURIComponent(tileMatrixSet);
+    const tm = encodeURIComponent(String(request.tileMatrix));
+    const tr = encodeURIComponent(String(request.tileRow));
+    const tc = encodeURIComponent(String(request.tileCol));
+    const jSeg = encodeURIComponent(String(Math.trunc(request.j)));
+    const iSeg = encodeURIComponent(String(Math.trunc(request.i)));
+    const extra = wmtsRestExtraParamsSuffix(request.extraParams);
+    const path = `${base}/${layer}/${styleSeg}/${tmsSeg}/${tm}/${tr}/${tc}/${jSeg}/${iSeg}.${ext}${extra}`;
+    const response = await transport.requestBytes("GET", path, infoFormat, undefined, request.signal);
+    return decodeWmsFeatureInfoResponse(response.bytes, response.contentType, infoFormat);
+}
+const WMTS_FEATURE_INFO_FORMAT_TO_EXTENSION = new Map([
+    ["application/json", "json"],
+    ["text/plain", "txt"],
+    ["text/html", "html"],
+    ["application/geo+json", "geojson"],
+]);
+function wmtsFeatureInfoExtensionForFormat(format) {
+    return WMTS_FEATURE_INFO_FORMAT_TO_EXTENSION.get(format.toLowerCase()) ?? "txt";
+}
+const WMTS_REST_RESERVED_KEYS = new Set([
+    "service",
+    "version",
+    "request",
+    "layer",
+    "style",
+    "format",
+    "infoformat",
+    "tilematrixset",
+    "tilematrix",
+    "tilerow",
+    "tilecol",
+    "i",
+    "j",
+]);
+/**
+ * Serialize `extraParams` for the RESTful WMTS routes. Path-encoded WMTS
+ * keys take precedence — any extraParams whose key (case-insensitively)
+ * matches a path-derived value is dropped so the same URL never carries
+ * the value twice. Returns the query-string suffix to append (empty
+ * string when there is nothing left after filtering).
+ */
+function wmtsRestExtraParamsSuffix(extraParams) {
+    if (!extraParams)
+        return "";
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(extraParams)) {
+        if (value === undefined || value === null)
+            continue;
+        if (WMTS_REST_RESERVED_KEYS.has(key.toLowerCase()))
+            continue;
+        params.set(key, String(value));
+    }
+    const serialized = params.toString();
+    return serialized.length > 0 ? `?${serialized}` : "";
+}

package/core/xml-text.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Single-pass XML text decoding used by the WMS/WMTS capabilities parsers.
+ *
+ * Decoding XML entities with a chain of independent `String.prototype.replace`
+ * calls is unsafe: an earlier substitution (for example `&` -> `&`) can
+ * synthesize characters that a later substitution then re-interprets, causing
+ * double-unescaping (CodeQL `js/double-escaping`). Walking the input exactly
+ * once and emitting each decoded character directly avoids that class of bug —
+ * a `&` produced by decoding `&` is final and never re-scanned.
+ */
+/**
+ * Decode XML character data in a single forward pass.
+ *
+ * Handles `<![CDATA[…]]>` sections (emitted verbatim), the five predefined
+ * named entities (`&lt;`, `&gt;`, `&amp;`, `&apos;`, `&quot;`), and numeric
+ * character references (`&#1234;` / `&#x1F4A9;`). Any `&` that does not begin
+ * a recognized reference is emitted literally.
+ */
+export declare function decodeXmlText(text: string): string;
+//# sourceMappingURL=xml-text.d.ts.map

package/core/xml-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-text.d.ts","sourceRoot":"","sources":["../../../src/core/xml-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsClD"}

package/core/xml-text.js

@@ -0,0 +1,85 @@
+/**
+ * Single-pass XML text decoding used by the WMS/WMTS capabilities parsers.
+ *
+ * Decoding XML entities with a chain of independent `String.prototype.replace`
+ * calls is unsafe: an earlier substitution (for example `&` -> `&`) can
+ * synthesize characters that a later substitution then re-interprets, causing
+ * double-unescaping (CodeQL `js/double-escaping`). Walking the input exactly
+ * once and emitting each decoded character directly avoids that class of bug —
+ * a `&` produced by decoding `&` is final and never re-scanned.
+ */
+const NAMED_ENTITIES = {
+    lt: "<",
+    gt: ">",
+    amp: "&",
+    apos: "'",
+    quot: '"',
+};
+const CDATA_OPEN = "<![CDATA[";
+const CDATA_CLOSE = "]]>";
+/**
+ * Decode XML character data in a single forward pass.
+ *
+ * Handles `<![CDATA[…]]>` sections (emitted verbatim), the five predefined
+ * named entities (`&lt;`, `&gt;`, `&amp;`, `&apos;`, `&quot;`), and numeric
+ * character references (`&#1234;` / `&#x1F4A9;`). Any `&` that does not begin
+ * a recognized reference is emitted literally.
+ */
+export function decodeXmlText(text) {
+    let result = "";
+    let i = 0;
+    const length = text.length;
+    while (i < length) {
+        const char = text[i];
+        if (char === "<" && text.startsWith(CDATA_OPEN, i)) {
+            const end = text.indexOf(CDATA_CLOSE, i + CDATA_OPEN.length);
+            if (end < 0) {
+                // Unterminated CDATA: emit the remainder verbatim.
+                result += text.slice(i + CDATA_OPEN.length);
+                break;
+            }
+            result += text.slice(i + CDATA_OPEN.length, end);
+            i = end + CDATA_CLOSE.length;
+            continue;
+        }
+        if (char === "&") {
+            const semicolon = text.indexOf(";", i + 1);
+            if (semicolon > i) {
+                const entity = text.slice(i + 1, semicolon);
+                const decoded = decodeEntity(entity);
+                if (decoded !== undefined) {
+                    result += decoded;
+                    i = semicolon + 1;
+                    continue;
+                }
+            }
+        }
+        result += char;
+        i += 1;
+    }
+    return result;
+}
+function decodeEntity(entity) {
+    const named = NAMED_ENTITIES[entity];
+    if (named !== undefined) {
+        return named;
+    }
+    if (entity.length >= 2 && entity.charCodeAt(0) === 35 /* '#' */) {
+        const isHex = entity.charCodeAt(1) === 120 /* 'x' */ || entity.charCodeAt(1) === 88 /* 'X' */;
+        const digits = isHex ? entity.slice(2) : entity.slice(1);
+        if (digits === "") {
+            return undefined;
+        }
+        const codePoint = isHex ? Number.parseInt(digits, 16) : Number.parseInt(digits, 10);
+        if (Number.isNaN(codePoint) || codePoint < 0 || codePoint > 0x10ffff) {
+            return undefined;
+        }
+        try {
+            return String.fromCodePoint(codePoint);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}

package/esri-compat/basemap-gallery.d.ts

@@ -0,0 +1,38 @@
+import { CompatEventBus } from "./event-bus.js";
+export interface BasemapGalleryCompatOptions {
+    view?: unknown;
+    map?: unknown;
+    container?: unknown;
+    source?: readonly unknown[];
+    eventBus?: CompatEventBus;
+    autoRefresh?: boolean;
+}
+export type BasemapGalleryLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface BasemapGalleryHandleCompat {
+    remove(): void;
+}
+export declare class BasemapGalleryCompat {
+    readonly view: unknown;
+    readonly map: unknown;
+    readonly container: unknown;
+    readonly eventBus: CompatEventBus;
+    readonly autoRefresh: boolean;
+    loaded: boolean;
+    loadStatus: BasemapGalleryLoadStatusCompat;
+    source: unknown[];
+    activeBasemap: unknown;
+    private readonly subscriptions;
+    private readonly watchListeners;
+    constructor(options?: BasemapGalleryCompatOptions);
+    load(): Promise<BasemapGalleryCompat>;
+    when(callback?: (widget: BasemapGalleryCompat) => void): Promise<BasemapGalleryCompat>;
+    watch(propertyName: string, listener: (value: unknown) => void): BasemapGalleryHandleCompat;
+    get basemaps(): readonly unknown[];
+    setBasemaps(basemaps: readonly unknown[]): void;
+    select(basemapOrId: unknown): unknown;
+    refresh(): unknown;
+    destroy(): void;
+    private resolveBasemap;
+    private notifyWatchers;
+}
+//# sourceMappingURL=basemap-gallery.d.ts.map

package/esri-compat/basemap-gallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basemap-gallery.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/basemap-gallery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAIf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,0BAA0B;IACzC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,oBAAoB;IAC/B,SAAgB,IAAI,EAAE,OAAO,CAAC;IAC9B,SAAgB,GAAG,EAAE,OAAO,CAAC;IAC7B,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,SAAgB,WAAW,EAAE,OAAO,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,8BAA8B,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,2BAAgC;IAwB/C,IAAI,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAiBrC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQ5F,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,0BAA0B;IAelG,IAAW,QAAQ,IAAI,SAAS,OAAO,EAAE,CAExC;IAEM,WAAW,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAM/C,MAAM,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO;IAcrC,OAAO,IAAI,OAAO;IAOlB,OAAO,IAAI,IAAI;IAOtB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/basemap-gallery.js

@@ -0,0 +1,159 @@
+import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener, } from "./event-bus.js";
+export class BasemapGalleryCompat {
+    view;
+    map;
+    container;
+    eventBus;
+    autoRefresh;
+    loaded;
+    loadStatus;
+    source;
+    activeBasemap;
+    subscriptions;
+    watchListeners;
+    constructor(options = {}) {
+        this.view = options.view;
+        this.map = options.map ?? extractViewMap(options.view);
+        this.container = options.container;
+        this.eventBus = options.eventBus ?? resolveCompatEventBus(options.view, this.map) ?? new CompatEventBus();
+        this.autoRefresh = options.autoRefresh ?? true;
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.source = Array.isArray(options.source) ? [...options.source] : [];
+        this.activeBasemap = extractMapBasemap(this.map);
+        this.subscriptions = [];
+        this.watchListeners = new Map();
+        if (this.autoRefresh) {
+            this.subscriptions.push(this.eventBus.on("map.basemap-changed", (event) => {
+                this.activeBasemap = extractPayloadBasemap(event.payload);
+                this.notifyWatchers("activeBasemap", this.activeBasemap);
+                this.eventBus.emit("basemap-gallery.active-basemap-changed", { basemap: this.activeBasemap }, this);
+            }));
+        }
+    }
+    async load() {
+        if (this.loaded) {
+            return this;
+        }
+        this.loadStatus = "loading";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("basemap-gallery.loading", undefined, this);
+        this.refresh();
+        this.loaded = true;
+        this.notifyWatchers("loaded", this.loaded);
+        this.loadStatus = "loaded";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("basemap-gallery.loaded", { basemapCount: this.source.length }, this);
+        return this;
+    }
+    async when(callback) {
+        const widget = await this.load();
+        if (callback) {
+            callback(widget);
+        }
+        return widget;
+    }
+    watch(propertyName, listener) {
+        let listeners = this.watchListeners.get(propertyName);
+        if (!listeners) {
+            listeners = new Set();
+            this.watchListeners.set(propertyName, listeners);
+        }
+        listeners.add(listener);
+        return {
+            remove: () => {
+                listeners?.delete(listener);
+            },
+        };
+    }
+    get basemaps() {
+        return this.source;
+    }
+    setBasemaps(basemaps) {
+        this.source = [...basemaps];
+        this.notifyWatchers("source", this.source);
+        this.eventBus.emit("basemap-gallery.updated", { basemapCount: this.source.length }, this);
+    }
+    select(basemapOrId) {
+        const basemap = this.resolveBasemap(basemapOrId);
+        if (basemap === undefined) {
+            return undefined;
+        }
+        setMapBasemap(this.map, basemap, this.eventBus, this);
+        this.activeBasemap = basemap;
+        this.notifyWatchers("activeBasemap", this.activeBasemap);
+        this.eventBus.emit("basemap-gallery.selected", { basemap }, this);
+        this.eventBus.emit("basemap.toggle", { activeBasemap: basemap }, this);
+        return basemap;
+    }
+    refresh() {
+        this.activeBasemap = extractMapBasemap(this.map);
+        this.notifyWatchers("activeBasemap", this.activeBasemap);
+        this.eventBus.emit("basemap-gallery.active-basemap-changed", { basemap: this.activeBasemap }, this);
+        return this.activeBasemap;
+    }
+    destroy() {
+        for (const subscription of this.subscriptions.splice(0)) {
+            subscription.remove();
+        }
+        this.watchListeners.clear();
+    }
+    resolveBasemap(basemapOrId) {
+        if (typeof basemapOrId !== "string") {
+            return basemapOrId;
+        }
+        for (const candidate of this.source) {
+            if (!isRecord(candidate)) {
+                continue;
+            }
+            if (candidate.id === basemapOrId || candidate.title === basemapOrId) {
+                return candidate;
+            }
+        }
+        return undefined;
+    }
+    notifyWatchers(propertyName, value) {
+        const listeners = this.watchListeners.get(propertyName);
+        if (!listeners) {
+            return;
+        }
+        for (const listener of listeners) {
+            safeInvokeCompatListener(listener, value);
+        }
+    }
+}
+function setMapBasemap(map, basemap, eventBus, source) {
+    if (!isRecord(map)) {
+        return;
+    }
+    if (isMapBasemapSetter(map)) {
+        map.setBasemap(basemap);
+        return;
+    }
+    map.basemap = basemap;
+    eventBus.emit("map.basemap-changed", { basemap }, source);
+}
+function extractViewMap(view) {
+    if (!isRecord(view)) {
+        return undefined;
+    }
+    return view.map;
+}
+function extractMapBasemap(map) {
+    if (!isRecord(map)) {
+        return undefined;
+    }
+    return map.basemap;
+}
+function extractPayloadBasemap(payload) {
+    if (!isRecord(payload)) {
+        return undefined;
+    }
+    return payload.basemap;
+}
+function isMapBasemapSetter(value) {
+    return isRecord(value) && typeof value.setBasemap === "function";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}

package/esri-compat/basemap-layer-list.d.ts

@@ -0,0 +1,35 @@
+import { CompatEventBus } from "./event-bus.js";
+export interface BasemapLayerListCompatOptions {
+    view?: unknown;
+    map?: unknown;
+    container?: unknown;
+    eventBus?: CompatEventBus;
+    autoRefresh?: boolean;
+}
+export type BasemapLayerListLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface BasemapLayerListHandleCompat {
+    remove(): void;
+}
+export declare class BasemapLayerListCompat {
+    readonly view: unknown;
+    readonly map: unknown;
+    readonly container: unknown;
+    readonly eventBus: CompatEventBus;
+    readonly autoRefresh: boolean;
+    loaded: boolean;
+    loadStatus: BasemapLayerListLoadStatusCompat;
+    basemap: unknown;
+    baseLayers: unknown[];
+    referenceLayers: unknown[];
+    private readonly subscriptions;
+    private readonly watchListeners;
+    constructor(options?: BasemapLayerListCompatOptions);
+    load(): Promise<BasemapLayerListCompat>;
+    when(callback?: (widget: BasemapLayerListCompat) => void): Promise<BasemapLayerListCompat>;
+    watch(propertyName: string, listener: (value: unknown) => void): BasemapLayerListHandleCompat;
+    refresh(): readonly unknown[];
+    setBasemap(basemap: unknown): void;
+    destroy(): void;
+    private notifyWatchers;
+}
+//# sourceMappingURL=basemap-layer-list.d.ts.map

package/esri-compat/basemap-layer-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basemap-layer-list.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/basemap-layer-list.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAIf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,gCAAgC,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,4BAA4B;IAC3C,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,sBAAsB;IACjC,SAAgB,IAAI,EAAE,OAAO,CAAC;IAC9B,SAAgB,GAAG,EAAE,OAAO,CAAC;IAC7B,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,SAAgB,WAAW,EAAE,OAAO,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,gCAAgC,CAAC;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,EAAE,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,6BAAkC;IAqBjD,IAAI,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAiBvC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAQhG,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,4BAA4B;IAe7F,OAAO,IAAI,SAAS,OAAO,EAAE;IAoB7B,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC,OAAO,IAAI,IAAI;IAOtB,OAAO,CAAC,cAAc;CAUvB"}