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

package/esri-compat/feature.js

@@ -0,0 +1,83 @@
+import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener } from "./event-bus.js";
+export class FeatureCompat {
+    view;
+    map;
+    container;
+    eventBus;
+    loaded;
+    loadStatus;
+    graphic;
+    title;
+    watchListeners;
+    constructor(options = {}) {
+        this.view = options.view;
+        this.map = options.map;
+        this.container = options.container;
+        this.eventBus = options.eventBus ?? resolveCompatEventBus(options.view, options.map) ?? new CompatEventBus();
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.graphic = options.graphic;
+        this.title = options.title;
+        this.watchListeners = new Map();
+    }
+    async load() {
+        if (this.loaded) {
+            return this;
+        }
+        this.loadStatus = "loading";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("feature-widget.loading", undefined, this);
+        this.loaded = true;
+        this.notifyWatchers("loaded", this.loaded);
+        this.loadStatus = "loaded";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("feature-widget.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);
+            },
+        };
+    }
+    setGraphic(graphic, title) {
+        this.graphic = graphic;
+        this.notifyWatchers("graphic", this.graphic);
+        if (title !== undefined) {
+            this.title = title;
+            this.notifyWatchers("title", this.title);
+        }
+        this.eventBus.emit("feature-widget.updated", { graphic: this.graphic, title: this.title }, this);
+    }
+    clear() {
+        this.graphic = undefined;
+        this.notifyWatchers("graphic", this.graphic);
+        this.eventBus.emit("feature-widget.cleared", undefined, this);
+    }
+    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/graphic.d.ts

@@ -0,0 +1,46 @@
+/** Structural type for geometry-like objects (point, polyline, polygon, extent, etc.). */
+export type CompatGeometryLike = Record<string, unknown>;
+/** Structural type for symbol-like objects (marker, line, fill, text, etc.). */
+export type CompatSymbolLike = Record<string, unknown>;
+/** Structural type for popup template-like objects. */
+export type CompatPopupTemplateLike = Record<string, unknown>;
+export interface GraphicCompatOptions {
+    geometry?: CompatGeometryLike | null;
+    symbol?: CompatSymbolLike | null;
+    attributes?: Record<string, unknown>;
+    popupTemplate?: CompatPopupTemplateLike | null;
+    layer?: unknown;
+}
+export type GraphicLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface GraphicHandleCompat {
+    remove(): void;
+}
+export declare class GraphicCompat {
+    loaded: boolean;
+    loadStatus: GraphicLoadStatusCompat;
+    geometry: CompatGeometryLike | null;
+    symbol: CompatSymbolLike | null;
+    attributes: Record<string, unknown>;
+    popupTemplate: CompatPopupTemplateLike | null;
+    layer: unknown;
+    private readonly watchListeners;
+    constructor(options?: GraphicCompatOptions);
+    load(): Promise<GraphicCompat>;
+    when(callback?: (graphic: GraphicCompat) => void): Promise<GraphicCompat>;
+    watch(propertyName: "loaded", listener: (value: boolean) => void): GraphicHandleCompat;
+    watch(propertyName: "loadStatus", listener: (value: GraphicLoadStatusCompat) => void): GraphicHandleCompat;
+    watch(propertyName: "geometry", listener: (value: CompatGeometryLike | null) => void): GraphicHandleCompat;
+    watch(propertyName: "symbol", listener: (value: CompatSymbolLike | null) => void): GraphicHandleCompat;
+    watch(propertyName: "attributes", listener: (value: Record<string, unknown>) => void): GraphicHandleCompat;
+    watch(propertyName: string, listener: (value: unknown) => void): GraphicHandleCompat;
+    setGeometry(geometry: CompatGeometryLike | null): void;
+    setSymbol(symbol: CompatSymbolLike | null): void;
+    setAttributes(attributes: Record<string, unknown>): void;
+    setPopupTemplate(popupTemplate: CompatPopupTemplateLike | null): void;
+    setLayer(layer: unknown): void;
+    clone(): GraphicCompat;
+    toJSON(): Record<string, unknown>;
+    destroy(): void;
+    private notifyWatchers;
+}
+//# sourceMappingURL=graphic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphic.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/graphic.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzD,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,uDAAuD;AACvD,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,aAAa;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,uBAAuB,CAAC;IACpC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,aAAa,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9C,KAAK,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,oBAAyB;IAWxC,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAc9B,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ/E,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,mBAAmB;IACtF,KAAK,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,mBAAmB;IAC1G,KAAK,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,GAAG,mBAAmB;IAC1G,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,GAAG,mBAAmB;IACtG,KAAK,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,mBAAmB;IAC1G,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,mBAAmB;IAgBpF,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAKtD,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAKhD,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKxD,gBAAgB,CAAC,aAAa,EAAE,uBAAuB,GAAG,IAAI,GAAG,IAAI;IAKrE,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK9B,KAAK,IAAI,aAAa;IAUtB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUjC,OAAO,IAAI,IAAI;IAItB,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/graphic.js

@@ -0,0 +1,103 @@
+import { safeInvokeCompatListener } from "./event-bus.js";
+export class GraphicCompat {
+    loaded;
+    loadStatus;
+    geometry;
+    symbol;
+    attributes;
+    popupTemplate;
+    layer;
+    watchListeners;
+    constructor(options = {}) {
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.geometry = options.geometry ?? null;
+        this.symbol = options.symbol ?? null;
+        this.attributes = options.attributes ? { ...options.attributes } : {};
+        this.popupTemplate = options.popupTemplate ?? null;
+        this.layer = options.layer;
+        this.watchListeners = new Map();
+    }
+    async load() {
+        if (this.loaded) {
+            return this;
+        }
+        this.loadStatus = "loading";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.loaded = true;
+        this.notifyWatchers("loaded", this.loaded);
+        this.loadStatus = "loaded";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        return this;
+    }
+    async when(callback) {
+        const graphic = await this.load();
+        if (callback) {
+            callback(graphic);
+        }
+        return graphic;
+    }
+    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);
+            },
+        };
+    }
+    setGeometry(geometry) {
+        this.geometry = geometry;
+        this.notifyWatchers("geometry", this.geometry);
+    }
+    setSymbol(symbol) {
+        this.symbol = symbol;
+        this.notifyWatchers("symbol", this.symbol);
+    }
+    setAttributes(attributes) {
+        this.attributes = { ...attributes };
+        this.notifyWatchers("attributes", this.attributes);
+    }
+    setPopupTemplate(popupTemplate) {
+        this.popupTemplate = popupTemplate;
+        this.notifyWatchers("popupTemplate", this.popupTemplate);
+    }
+    setLayer(layer) {
+        this.layer = layer;
+        this.notifyWatchers("layer", this.layer);
+    }
+    clone() {
+        return new GraphicCompat({
+            geometry: this.geometry,
+            symbol: this.symbol,
+            attributes: this.attributes,
+            popupTemplate: this.popupTemplate,
+            layer: this.layer,
+        });
+    }
+    toJSON() {
+        return {
+            geometry: this.geometry,
+            symbol: this.symbol,
+            attributes: { ...this.attributes },
+            popupTemplate: this.popupTemplate,
+            layer: this.layer,
+        };
+    }
+    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/graphics-layer.d.ts

@@ -0,0 +1,49 @@
+import { CompatEventBus } from "./event-bus.js";
+export interface GraphicsLayerCompatOptions {
+    id?: string;
+    title?: string;
+    graphics?: unknown[];
+    visible?: boolean;
+    opacity?: number;
+    listMode?: "show" | "hide";
+    eventBus?: CompatEventBus;
+}
+export interface GraphicsLayerQueryResult {
+    features: unknown[];
+}
+export type GraphicsLayerLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface GraphicsLayerHandleCompat {
+    remove(): void;
+}
+export declare class GraphicsLayerCompat {
+    readonly type: "graphics";
+    id: string | undefined;
+    title: string | undefined;
+    visible: boolean;
+    opacity: number;
+    listMode: "show" | "hide";
+    loaded: boolean;
+    loadStatus: GraphicsLayerLoadStatusCompat;
+    readonly eventBus: CompatEventBus;
+    private readonly graphicsInternal;
+    private readonly watchListeners;
+    private readonly eventListeners;
+    constructor(options?: GraphicsLayerCompatOptions);
+    load(): Promise<GraphicsLayerCompat>;
+    when(callback?: (layer: GraphicsLayerCompat) => void): Promise<GraphicsLayerCompat>;
+    watch(propertyName: string, listener: (value: unknown) => void): GraphicsLayerHandleCompat;
+    get graphics(): readonly unknown[];
+    add(graphic: unknown, index?: number): unknown;
+    addMany(graphics: readonly unknown[], index?: number): readonly unknown[];
+    remove(graphic: unknown): unknown | undefined;
+    removeMany(graphics: readonly unknown[]): unknown[];
+    removeAll(): void;
+    setVisibility(visible: boolean): void;
+    setOpacity(opacity: number): void;
+    queryFeatures(): Promise<GraphicsLayerQueryResult>;
+    queryFeatureCount(): Promise<number>;
+    on(eventName: string, listener: (event: unknown) => void): GraphicsLayerHandleCompat;
+    destroy(): void;
+    private notifyWatchers;
+}
+//# sourceMappingURL=graphics-layer.d.ts.map

package/esri-compat/graphics-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics-layer.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/graphics-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,gBAAgB,CAAC;AAEjG,MAAM,WAAW,0BAA0B;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,6BAA6B,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,yBAAyB;IACxC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,mBAAmB;IAC9B,SAAgB,IAAI,EAAE,UAAU,CAAC;IAC1B,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,6BAA6B,CAAC;IACjD,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,0BAA+B;IAe9C,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAgBpC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQzF,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,yBAAyB;IAejG,IAAW,QAAQ,IAAI,SAAS,OAAO,EAAE,CAExC;IAEM,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAmB9C,OAAO,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE;IA4BzE,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;IAY7C,UAAU,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE;IAWnD,SAAS,IAAI,IAAI;IAWjB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,aAAa,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAMlD,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1C,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,yBAAyB;IAqBpF,OAAO,IAAI,IAAI;IAMtB,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/graphics-layer.js

@@ -0,0 +1,185 @@
+import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener } from "./event-bus.js";
+export class GraphicsLayerCompat {
+    type;
+    id;
+    title;
+    visible;
+    opacity;
+    listMode;
+    loaded;
+    loadStatus;
+    eventBus;
+    graphicsInternal;
+    watchListeners;
+    eventListeners;
+    constructor(options = {}) {
+        this.type = "graphics";
+        this.id = options.id;
+        this.title = options.title;
+        this.visible = options.visible ?? true;
+        this.opacity = options.opacity ?? 1;
+        this.listMode = options.listMode ?? "show";
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.graphicsInternal = Array.isArray(options.graphics) ? [...options.graphics] : [];
+        this.eventBus = options.eventBus ?? resolveCompatEventBus(options.graphics) ?? new CompatEventBus();
+        this.watchListeners = new Map();
+        this.eventListeners = new Map();
+    }
+    async load() {
+        if (this.loaded) {
+            return this;
+        }
+        this.loadStatus = "loading";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("graphics-layer.loading", { layerId: this.id }, this);
+        this.loaded = true;
+        this.notifyWatchers("loaded", this.loaded);
+        this.loadStatus = "loaded";
+        this.notifyWatchers("loadStatus", this.loadStatus);
+        this.eventBus.emit("graphics-layer.loaded", { layerId: this.id }, this);
+        return this;
+    }
+    async when(callback) {
+        const layer = await this.load();
+        if (callback) {
+            callback(layer);
+        }
+        return layer;
+    }
+    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 graphics() {
+        return this.graphicsInternal;
+    }
+    add(graphic, index) {
+        if (index === undefined) {
+            this.graphicsInternal.push(graphic);
+            this.notifyWatchers("graphics", this.graphics);
+            this.eventBus.emit("graphics-layer.graphic-added", { layerId: this.id, graphic, index: this.graphicsInternal.length - 1 }, this);
+            return graphic;
+        }
+        const insertAt = normalizeInsertIndex(index, this.graphicsInternal.length);
+        this.graphicsInternal.splice(insertAt, 0, graphic);
+        this.notifyWatchers("graphics", this.graphics);
+        this.eventBus.emit("graphics-layer.graphic-added", { layerId: this.id, graphic, index: insertAt }, this);
+        return graphic;
+    }
+    addMany(graphics, index) {
+        if (graphics.length === 0) {
+            return [];
+        }
+        if (index === undefined) {
+            const startIndex = this.graphicsInternal.length;
+            this.graphicsInternal.push(...graphics);
+            this.notifyWatchers("graphics", this.graphics);
+            this.eventBus.emit("graphics-layer.graphics-added", { layerId: this.id, graphics: [...graphics], index: startIndex }, this);
+            return graphics;
+        }
+        const insertAt = normalizeInsertIndex(index, this.graphicsInternal.length);
+        this.graphicsInternal.splice(insertAt, 0, ...graphics);
+        this.notifyWatchers("graphics", this.graphics);
+        this.eventBus.emit("graphics-layer.graphics-added", { layerId: this.id, graphics: [...graphics], index: insertAt }, this);
+        return graphics;
+    }
+    remove(graphic) {
+        const index = this.graphicsInternal.indexOf(graphic);
+        if (index < 0) {
+            return undefined;
+        }
+        const [removed] = this.graphicsInternal.splice(index, 1);
+        this.notifyWatchers("graphics", this.graphics);
+        this.eventBus.emit("graphics-layer.graphic-removed", { layerId: this.id, graphic: removed, index }, this);
+        return removed;
+    }
+    removeMany(graphics) {
+        const removed = [];
+        for (const graphic of graphics) {
+            const removedGraphic = this.remove(graphic);
+            if (removedGraphic !== undefined) {
+                removed.push(removedGraphic);
+            }
+        }
+        return removed;
+    }
+    removeAll() {
+        if (this.graphicsInternal.length === 0) {
+            return;
+        }
+        const removed = [...this.graphicsInternal];
+        this.graphicsInternal.length = 0;
+        this.notifyWatchers("graphics", this.graphics);
+        this.eventBus.emit("graphics-layer.graphics-cleared", { layerId: this.id, graphics: removed }, this);
+    }
+    setVisibility(visible) {
+        this.visible = visible;
+        this.notifyWatchers("visible", this.visible);
+        this.eventBus.emit("layer.visibility-changed", { layerId: this.id, visible }, this);
+    }
+    setOpacity(opacity) {
+        this.opacity = normalizeOpacity(opacity);
+        this.notifyWatchers("opacity", this.opacity);
+        this.eventBus.emit("layer.opacity-changed", { layerId: this.id, opacity: this.opacity }, this);
+    }
+    async queryFeatures() {
+        return {
+            features: [...this.graphicsInternal],
+        };
+    }
+    async queryFeatureCount() {
+        return this.graphicsInternal.length;
+    }
+    on(eventName, listener) {
+        const namespacedEvent = `graphics-layer.${eventName}`;
+        let listeners = this.eventListeners.get(eventName);
+        if (!listeners) {
+            listeners = new Set();
+            this.eventListeners.set(eventName, listeners);
+        }
+        listeners.add(listener);
+        const subscription = this.eventBus.on(namespacedEvent, (event) => {
+            safeInvokeCompatListener(listener, event.payload);
+        });
+        return {
+            remove: () => {
+                listeners?.delete(listener);
+                subscription.remove();
+            },
+        };
+    }
+    destroy() {
+        this.watchListeners.clear();
+        this.eventListeners.clear();
+        this.eventBus.emit("graphics-layer.destroyed", { layerId: this.id }, this);
+    }
+    notifyWatchers(propertyName, value) {
+        const listeners = this.watchListeners.get(propertyName);
+        if (!listeners) {
+            return;
+        }
+        for (const listener of listeners) {
+            safeInvokeCompatListener(listener, value);
+        }
+    }
+}
+function normalizeInsertIndex(index, length) {
+    const sanitized = Number.isFinite(index) ? Math.trunc(index) : length;
+    return Math.min(Math.max(sanitized, 0), length);
+}
+function normalizeOpacity(opacity) {
+    if (!Number.isFinite(opacity)) {
+        return 1;
+    }
+    return Math.min(Math.max(opacity, 0), 1);
+}

package/esri-compat/group-layer.d.ts

@@ -0,0 +1,48 @@
+import { CompatEventBus } from "./event-bus.js";
+export interface GroupLayerCompatOptions {
+    id?: string;
+    title?: string;
+    layers?: unknown[];
+    visible?: boolean;
+    opacity?: number;
+    listMode?: "show" | "hide";
+    visibilityMode?: "independent" | "inherited" | "exclusive";
+    eventBus?: CompatEventBus;
+}
+export type GroupLayerLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface GroupLayerHandleCompat {
+    remove(): void;
+}
+export declare class GroupLayerCompat {
+    readonly type: "group";
+    id: string | undefined;
+    title: string | undefined;
+    visible: boolean;
+    opacity: number;
+    listMode: "show" | "hide";
+    visibilityMode: "independent" | "inherited" | "exclusive";
+    loaded: boolean;
+    loadStatus: GroupLayerLoadStatusCompat;
+    readonly eventBus: CompatEventBus;
+    private readonly layersInternal;
+    private readonly watchListeners;
+    private readonly eventListeners;
+    constructor(options?: GroupLayerCompatOptions);
+    load(): Promise<GroupLayerCompat>;
+    when(callback?: (layer: GroupLayerCompat) => void): Promise<GroupLayerCompat>;
+    watch(propertyName: string, listener: (value: unknown) => void): GroupLayerHandleCompat;
+    get layers(): readonly unknown[];
+    get allLayers(): readonly unknown[];
+    add(layer: unknown, index?: number): void;
+    addMany(layers: readonly unknown[], index?: number): void;
+    remove(layer: unknown): boolean;
+    removeMany(layers: readonly unknown[]): number;
+    removeAll(): void;
+    findLayerById(id: string): unknown;
+    setVisibility(visible: boolean): void;
+    setOpacity(opacity: number): void;
+    on(eventName: string, listener: (event: unknown) => void): GroupLayerHandleCompat;
+    destroy(): void;
+    private notifyWatchers;
+}
+//# sourceMappingURL=group-layer.d.ts.map

package/esri-compat/group-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-layer.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/group-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,gBAAgB,CAAC;AAEjG,MAAM,WAAW,uBAAuB;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAC3D,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,0BAA0B,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,sBAAsB;IACrC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,gBAAgB;IAC3B,SAAgB,IAAI,EAAE,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,cAAc,EAAE,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,0BAA0B,CAAC;IAC9C,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,uBAA4B;IAgB3C,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAgBjC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQnF,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,sBAAsB;IAe9F,IAAW,MAAM,IAAI,SAAS,OAAO,EAAE,CAEtC;IAED,IAAW,SAAS,IAAI,SAAS,OAAO,EAAE,CAOzC;IAEM,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBzC,OAAO,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IA6BzD,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAa/B,UAAU,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM;IAU9C,SAAS,IAAI,IAAI;IAQjB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAUlC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,sBAAsB;IAqBjF,OAAO,IAAI,IAAI;IAMtB,OAAO,CAAC,cAAc;CAUvB"}