@honua/react 0.0.20-alpha.0

package/esri-compat/color.js

@@ -0,0 +1,106 @@
+import { safeInvokeCompatListener } from "./event-bus.js";
+export class ColorCompat {
+    loaded;
+    loadStatus;
+    value;
+    watchListeners;
+    constructor(input = [0, 0, 0, 1]) {
+        this.loaded = false;
+        this.loadStatus = "not-loaded";
+        this.value = normalizeInput(input);
+        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 color = await this.load();
+        if (callback) {
+            callback(color);
+        }
+        return color;
+    }
+    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);
+            },
+        };
+    }
+    set(input) {
+        this.value = normalizeInput(input);
+        this.notifyWatchers("value", this.toJSON());
+    }
+    clone() {
+        return new ColorCompat(this.toJSON());
+    }
+    toJSON() {
+        if (Array.isArray(this.value)) {
+            return [...this.value];
+        }
+        if (typeof this.value === "object") {
+            return { ...this.value };
+        }
+        return this.value;
+    }
+    toCss(includeAlpha = true) {
+        if (typeof this.value === "string") {
+            return this.value;
+        }
+        if (Array.isArray(this.value)) {
+            const [r = 0, g = 0, b = 0, a = 1] = this.value;
+            if (includeAlpha) {
+                return `rgba(${r}, ${g}, ${b}, ${a})`;
+            }
+            return `rgb(${r}, ${g}, ${b})`;
+        }
+        const record = this.value;
+        const r = toFiniteNumber(record.r, 0);
+        const g = toFiniteNumber(record.g, 0);
+        const b = toFiniteNumber(record.b, 0);
+        const a = toFiniteNumber(record.a, 1);
+        if (includeAlpha) {
+            return `rgba(${r}, ${g}, ${b}, ${a})`;
+        }
+        return `rgb(${r}, ${g}, ${b})`;
+    }
+    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 normalizeInput(input) {
+    if (typeof input === "string") {
+        return input;
+    }
+    if (Array.isArray(input)) {
+        return input.filter((value) => typeof value === "number" && Number.isFinite(value));
+    }
+    return { ...input };
+}
+function toFiniteNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}

package/esri-compat/controls.d.ts

@@ -0,0 +1,174 @@
+import { CompatEventBus, type CompatEventSubscription } from "./event-bus.js";
+/** Structural type for viewpoint-like objects used by controls. */
+export interface ControlViewpointLike {
+    targetGeometry?: Record<string, unknown>;
+    scale?: number;
+    rotation?: number;
+}
+export interface HomeCompatOptions {
+    view?: unknown;
+    container?: HTMLElement | string | null;
+    eventBus?: CompatEventBus;
+    viewpoint?: HomeViewpointCompat;
+}
+export interface HomeViewpointCompat {
+    center?: unknown;
+    zoom?: number;
+}
+export type ControlLoadStatusCompat = "not-loaded" | "loading" | "loaded";
+export interface ControlHandleCompat {
+    remove(): void;
+}
+interface BaseControlCompatOptions {
+    view?: unknown;
+    container?: HTMLElement | string | null;
+    eventBus?: CompatEventBus;
+}
+export declare class BaseControlCompat {
+    readonly view: unknown;
+    readonly container: HTMLElement | string | null;
+    readonly eventBus: CompatEventBus;
+    loaded: boolean;
+    loadStatus: ControlLoadStatusCompat;
+    protected readonly subscriptions: CompatEventSubscription[];
+    private readonly watchListeners;
+    protected constructor(options: BaseControlCompatOptions, ...extraEventBusCandidates: unknown[]);
+    /**
+     * Subclasses override to provide the event-name prefix used in load(), e.g.
+     * `"home"` yields `"home.loading"` / `"home.loaded"`.
+     */
+    protected get controlName(): string;
+    load(): Promise<this>;
+    /** Hook for subclasses to perform work during load (e.g. ScaleBarCompat.refresh). */
+    protected onLoad(): void;
+    when(callback?: (widget: this) => void): Promise<this>;
+    watch(propertyName: "visible", listener: (value: boolean) => void): ControlHandleCompat;
+    watch(propertyName: "disabled", listener: (value: boolean) => void): ControlHandleCompat;
+    watch(propertyName: "loaded", listener: (value: boolean) => void): ControlHandleCompat;
+    watch(propertyName: "loadStatus", listener: (value: ControlLoadStatusCompat) => void): ControlHandleCompat;
+    watch(propertyName: string, listener: (value: unknown) => void): ControlHandleCompat;
+    destroy(): void;
+    protected notifyWatchers(propertyName: string, value: unknown): void;
+}
+export declare class HomeCompat extends BaseControlCompat {
+    viewpoint: HomeViewpointCompat;
+    protected get controlName(): string;
+    constructor(options?: HomeCompatOptions);
+    go(): Promise<void>;
+    reset(): void;
+}
+export interface BasemapToggleCompatOptions {
+    view?: unknown;
+    map?: unknown;
+    container?: HTMLElement | string | null;
+    nextBasemap?: unknown;
+    eventBus?: CompatEventBus;
+}
+export declare class BasemapToggleCompat extends BaseControlCompat {
+    readonly map: unknown;
+    activeBasemap: unknown;
+    nextBasemap: unknown;
+    protected get controlName(): string;
+    constructor(options?: BasemapToggleCompatOptions);
+    toggle(): unknown;
+}
+export type ScaleBarUnitCompat = "metric" | "imperial" | "dual";
+export interface ScaleBarCompatOptions {
+    view?: unknown;
+    container?: HTMLElement | string | null;
+    unit?: ScaleBarUnitCompat;
+    eventBus?: CompatEventBus;
+}
+export declare class ScaleBarCompat extends BaseControlCompat {
+    unit: ScaleBarUnitCompat;
+    scale: number | undefined;
+    text: string;
+    protected get controlName(): string;
+    constructor(options?: ScaleBarCompatOptions);
+    protected onLoad(): void;
+    refresh(): string;
+}
+export interface LocateCompatOptions {
+    view?: unknown;
+    container?: HTMLElement | string | null;
+    eventBus?: CompatEventBus;
+    zoom?: number;
+    locateProvider?: () => Promise<LocatePositionCompat>;
+}
+export interface LocatePositionCompat {
+    coords: {
+        latitude: number;
+        longitude: number;
+        accuracy?: number;
+    };
+}
+export declare class LocateCompat extends BaseControlCompat {
+    readonly zoom: number | undefined;
+    lastPosition: LocatePositionCompat | undefined;
+    private readonly locateProvider;
+    protected get controlName(): string;
+    constructor(options?: LocateCompatOptions);
+    locate(): Promise<LocatePositionCompat>;
+}
+export interface CompassCompatOptions {
+    view?: unknown;
+    container?: HTMLElement | string | null;
+    eventBus?: CompatEventBus;
+}
+export declare class CompassCompat extends BaseControlCompat {
+    orientation: number;
+    protected get controlName(): string;
+    constructor(options?: CompassCompatOptions);
+    rotateTo(rotation: number): number;
+    reset(): number;
+    goToNorth(): number;
+}
+export interface ZoomCompatOptions {
+    view?: unknown;
+    container?: HTMLElement | string | null;
+    eventBus?: CompatEventBus;
+    layout?: "vertical" | "horizontal";
+}
+export declare class ZoomCompat extends BaseControlCompat {
+    readonly layout: "vertical" | "horizontal";
+    protected get controlName(): string;
+    constructor(options?: ZoomCompatOptions);
+    zoomIn(step?: number): number | undefined;
+    zoomOut(step?: number): number | undefined;
+    private adjustZoom;
+}
+export interface FullscreenCompatOptions {
+    view?: unknown;
+    container?: HTMLElement | string | null;
+    element?: HTMLElement | null;
+    eventBus?: CompatEventBus;
+}
+export declare class FullscreenCompat extends BaseControlCompat {
+    readonly element: HTMLElement | null;
+    active: boolean;
+    protected get controlName(): string;
+    constructor(options?: FullscreenCompatOptions);
+    enter(): void;
+    exit(): void;
+    toggle(force?: boolean): boolean;
+}
+export interface AttributionCompatOptions {
+    view?: unknown;
+    map?: unknown;
+    container?: HTMLElement | string | null;
+    eventBus?: CompatEventBus;
+    itemDelimiter?: string;
+    attributions?: readonly string[];
+}
+export declare class AttributionCompat extends BaseControlCompat {
+    readonly map: unknown;
+    itemDelimiter: string;
+    attributions: string[];
+    protected get controlName(): string;
+    constructor(options?: AttributionCompatOptions);
+    addAttribution(value: string): void;
+    removeAttribution(value: string): boolean;
+    getText(): string;
+}
+export {};
+//# sourceMappingURL=controls.d.ts.map

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

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