@honua/sdk-esri-compat 0.0.6-alpha.0

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"}

package/esri-compat/basemap-layer-list.js

@@ -0,0 +1,139 @@
+import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener, } from "./event-bus.js";
+export class BasemapLayerListCompat {
+    view;
+    map;
+    container;
+    eventBus;
+    autoRefresh;
+    loaded;
+    loadStatus;
+    basemap;
+    baseLayers;
+    referenceLayers;
+    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, options.map) ?? new CompatEventBus();
+        this.autoRefresh = options.autoRefresh ?? true;
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.basemap = undefined;
+        this.baseLayers = [];
+        this.referenceLayers = [];
+        this.subscriptions = [];
+        this.watchListeners = new Map();
+        this.refresh();
+        if (this.autoRefresh) {
+            this.subscriptions.push(this.eventBus.on("map.basemap-changed", () => this.refresh()));
+            this.subscriptions.push(this.eventBus.on("basemap.toggle", () => this.refresh()));
+        }
+    }
+    async load() {
+        if (this.loaded) {
+            return this;
+        }
+        this.loadStatus = "loading";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("basemap-layer-list.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-layer-list.loaded", undefined, 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);
+            },
+        };
+    }
+    refresh() {
+        const basemap = extractMapBasemap(this.map);
+        this.basemap = basemap;
+        this.notifyWatchers("basemap", this.basemap);
+        this.baseLayers = extractBasemapLayerCollection(basemap, "baseLayers");
+        this.notifyWatchers("baseLayers", this.baseLayers);
+        this.referenceLayers = extractBasemapLayerCollection(basemap, "referenceLayers");
+        this.notifyWatchers("referenceLayers", this.referenceLayers);
+        this.eventBus.emit("basemap-layer-list.refreshed", {
+            basemap: this.basemap,
+            baseLayerCount: this.baseLayers.length,
+            referenceLayerCount: this.referenceLayers.length,
+        }, this);
+        return [...this.baseLayers, ...this.referenceLayers];
+    }
+    setBasemap(basemap) {
+        setMapBasemap(this.map, basemap, this.eventBus, this);
+        this.refresh();
+    }
+    destroy() {
+        for (const subscription of this.subscriptions.splice(0)) {
+            subscription.remove();
+        }
+        this.watchListeners.clear();
+    }
+    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 extractMapBasemap(map) {
+    if (!isRecord(map)) {
+        return undefined;
+    }
+    return map.basemap;
+}
+function extractBasemapLayerCollection(basemap, key) {
+    if (!isRecord(basemap)) {
+        return [];
+    }
+    const value = basemap[key];
+    return Array.isArray(value) ? [...value] : [];
+}
+function extractViewMap(view) {
+    if (!isRecord(view)) {
+        return undefined;
+    }
+    return view.map;
+}
+function isMapBasemapSetter(value) {
+    return isRecord(value) && typeof value.setBasemap === "function";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}

package/esri-compat/basemap.d.ts

@@ -0,0 +1,32 @@
+import { CompatEventBus } from "./event-bus.js";
+export interface BasemapCompatOptions {
+    id?: string;
+    title?: string;
+    baseLayers?: readonly unknown[];
+    referenceLayers?: readonly unknown[];
+    eventBus?: CompatEventBus;
+}
+export type BasemapLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface BasemapHandleCompat {
+    remove(): void;
+}
+export declare class BasemapCompat {
+    readonly eventBus: CompatEventBus;
+    id: string | undefined;
+    title: string | undefined;
+    baseLayers: unknown[];
+    referenceLayers: unknown[];
+    loaded: boolean;
+    loadStatus: BasemapLoadStatusCompat;
+    private readonly watchListeners;
+    constructor(options?: BasemapCompatOptions);
+    static fromId(id: string): BasemapCompat;
+    setBaseLayers(layers: readonly unknown[]): void;
+    setReferenceLayers(layers: readonly unknown[]): void;
+    load(): Promise<BasemapCompat>;
+    when(callback?: (basemap: BasemapCompat) => void): Promise<BasemapCompat>;
+    watch(propertyName: string, listener: (value: unknown) => void): BasemapHandleCompat;
+    destroy(): void;
+    private notifyWatchers;
+}
+//# sourceMappingURL=basemap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basemap.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/basemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,gBAAgB,CAAC;AAEjG,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,aAAa;IACxB,SAAgB,QAAQ,EAAE,cAAc,CAAC;IAClC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,uBAAuB,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,oBAAyB;WAYvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAOxC,aAAa,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAM/C,kBAAkB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAM9C,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAgB9B,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ/E,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,mBAAmB;IAepF,OAAO,IAAI,IAAI;IAItB,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/basemap.js

@@ -0,0 +1,84 @@
+import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener } from "./event-bus.js";
+export class BasemapCompat {
+    eventBus;
+    id;
+    title;
+    baseLayers;
+    referenceLayers;
+    loaded;
+    loadStatus;
+    watchListeners;
+    constructor(options = {}) {
+        this.eventBus =
+            options.eventBus ?? resolveCompatEventBus(options.baseLayers, options.referenceLayers) ?? new CompatEventBus();
+        this.id = options.id;
+        this.title = options.title ?? options.id;
+        this.baseLayers = options.baseLayers ? [...options.baseLayers] : [];
+        this.referenceLayers = options.referenceLayers ? [...options.referenceLayers] : [];
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.watchListeners = new Map();
+    }
+    static fromId(id) {
+        return new BasemapCompat({
+            id,
+            title: id,
+        });
+    }
+    setBaseLayers(layers) {
+        this.baseLayers = [...layers];
+        this.notifyWatchers("baseLayers", this.baseLayers);
+        this.eventBus.emit("basemap.base-layers-changed", { count: this.baseLayers.length }, this);
+    }
+    setReferenceLayers(layers) {
+        this.referenceLayers = [...layers];
+        this.notifyWatchers("referenceLayers", this.referenceLayers);
+        this.eventBus.emit("basemap.reference-layers-changed", { count: this.referenceLayers.length }, this);
+    }
+    async load() {
+        if (this.loaded) {
+            return this;
+        }
+        this.loadStatus = "loading";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("basemap.loading", { id: this.id }, this);
+        this.loaded = true;
+        this.notifyWatchers("loaded", this.loaded);
+        this.loadStatus = "loaded";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("basemap.loaded", { id: this.id }, this);
+        return this;
+    }
+    async when(callback) {
+        const basemap = await this.load();
+        if (callback) {
+            callback(basemap);
+        }
+        return basemap;
+    }
+    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);
+            },
+        };
+    }
+    destroy() {
+        this.watchListeners.clear();
+    }
+    notifyWatchers(propertyName, value) {
+        const listeners = this.watchListeners.get(propertyName);
+        if (!listeners) {
+            return;
+        }
+        for (const listener of listeners) {
+            safeInvokeCompatListener(listener, value);
+        }
+    }
+}

package/esri-compat/bookmarks.d.ts

@@ -0,0 +1,36 @@
+import { CompatEventBus } from "./event-bus.js";
+export interface BookmarkCompatItem {
+    name: string;
+    viewpoint?: unknown;
+    target?: unknown;
+}
+export interface BookmarksCompatOptions {
+    view?: unknown;
+    container?: unknown;
+    bookmarks?: readonly BookmarkCompatItem[];
+    eventBus?: CompatEventBus;
+}
+export type BookmarksLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface BookmarksHandleCompat {
+    remove(): void;
+}
+export declare class BookmarksCompat {
+    readonly view: unknown;
+    readonly container: unknown;
+    readonly eventBus: CompatEventBus;
+    loaded: boolean;
+    loadStatus: BookmarksLoadStatusCompat;
+    bookmarks: BookmarkCompatItem[];
+    activeBookmark: BookmarkCompatItem | undefined;
+    private readonly watchListeners;
+    constructor(options?: BookmarksCompatOptions);
+    load(): Promise<BookmarksCompat>;
+    when(callback?: (widget: BookmarksCompat) => void): Promise<BookmarksCompat>;
+    watch(propertyName: string, listener: (value: unknown) => void): BookmarksHandleCompat;
+    add(bookmark: BookmarkCompatItem): void;
+    remove(nameOrBookmark: string | BookmarkCompatItem): boolean;
+    goTo(nameOrBookmark: string | BookmarkCompatItem): Promise<BookmarkCompatItem | undefined>;
+    destroy(): void;
+    private notifyWatchers;
+}
+//# sourceMappingURL=bookmarks.d.ts.map

package/esri-compat/bookmarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarks.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/bookmarks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,gBAAgB,CAAC;AAEjG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B,SAAgB,IAAI,EAAE,OAAO,CAAC;IAC9B,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,QAAQ,EAAE,cAAc,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,cAAc,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,sBAA2B;IAW1C,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAgBhC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IAQlF,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,qBAAqB;IAetF,GAAG,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAMvC,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,kBAAkB,GAAG,OAAO;IAmBtD,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAiBhG,OAAO,IAAI,IAAI;IAItB,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/bookmarks.js

@@ -0,0 +1,108 @@
+import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener } from "./event-bus.js";
+export class BookmarksCompat {
+    view;
+    container;
+    eventBus;
+    loaded;
+    loadStatus;
+    bookmarks;
+    activeBookmark;
+    watchListeners;
+    constructor(options = {}) {
+        this.view = options.view;
+        this.container = options.container;
+        this.eventBus = options.eventBus ?? resolveCompatEventBus(options.view) ?? new CompatEventBus();
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.bookmarks = options.bookmarks ? [...options.bookmarks] : [];
+        this.activeBookmark = undefined;
+        this.watchListeners = new Map();
+    }
+    async load() {
+        if (this.loaded) {
+            return this;
+        }
+        this.loadStatus = "loading";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("bookmarks.loading", undefined, this);
+        this.loaded = true;
+        this.notifyWatchers("loaded", this.loaded);
+        this.loadStatus = "loaded";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("bookmarks.loaded", { bookmarkCount: this.bookmarks.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);
+            },
+        };
+    }
+    add(bookmark) {
+        this.bookmarks.push(bookmark);
+        this.notifyWatchers("bookmarks", this.bookmarks);
+        this.eventBus.emit("bookmarks.updated", { bookmarkCount: this.bookmarks.length }, this);
+    }
+    remove(nameOrBookmark) {
+        const index = typeof nameOrBookmark === "string"
+            ? this.bookmarks.findIndex((bookmark) => bookmark.name === nameOrBookmark)
+            : this.bookmarks.indexOf(nameOrBookmark);
+        if (index < 0) {
+            return false;
+        }
+        const [removed] = this.bookmarks.splice(index, 1);
+        this.notifyWatchers("bookmarks", this.bookmarks);
+        if (this.activeBookmark === removed) {
+            this.activeBookmark = undefined;
+            this.notifyWatchers("activeBookmark", this.activeBookmark);
+        }
+        this.eventBus.emit("bookmarks.updated", { bookmarkCount: this.bookmarks.length }, this);
+        return true;
+    }
+    async goTo(nameOrBookmark) {
+        const bookmark = typeof nameOrBookmark === "string" ? this.bookmarks.find((item) => item.name === nameOrBookmark) : nameOrBookmark;
+        if (!bookmark) {
+            return undefined;
+        }
+        this.activeBookmark = bookmark;
+        this.notifyWatchers("activeBookmark", this.activeBookmark);
+        const target = bookmark.viewpoint ?? bookmark.target;
+        if (target !== undefined && isGoToProvider(this.view)) {
+            await this.view.goTo(target);
+        }
+        this.eventBus.emit("bookmarks.go-to", { bookmark }, this);
+        return bookmark;
+    }
+    destroy() {
+        this.watchListeners.clear();
+    }
+    notifyWatchers(propertyName, value) {
+        const listeners = this.watchListeners.get(propertyName);
+        if (!listeners) {
+            return;
+        }
+        for (const listener of listeners) {
+            safeInvokeCompatListener(listener, value);
+        }
+    }
+}
+function isGoToProvider(value) {
+    return isRecord(value) && typeof value.goTo === "function";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}