@honua/react 0.1.11-beta.0 → 0.1.13

package/core/client.js

@@ -9,6 +9,7 @@ import { HonuaOgcMaps, getOgcMapImage, getOgcMapsConformance, getOgcMapsLanding
 import { HonuaOgcProcesses, cancelOgcProcessJob, executeOgcProcess, getOgcProcess, getOgcProcessJob, getOgcProcessJobResults, getOgcProcessesConformance, getOgcProcessesLanding, listOgcProcesses, } from "./ogc-processes.js";
 import { HonuaOgcRecords, fetchOgcRecordRaw, fetchOgcRecordsRaw, getOgcRecord, getOgcRecordCollection, getOgcRecordsConformance, getOgcRecordsLanding, listOgcRecordCollections, searchOgcRecords, } from "./ogc-records.js";
 import { HonuaOgcTiles, fetchOgcTile, getOgcCollectionTileset, getOgcTileMatrixSet, getOgcTilesConformance, getOgcTilesLanding, listOgcCollectionTilesets, listOgcTileMatrixSets, } from "./ogc-tiles.js";
+import { explainOptionalGrpcLoadFailure } from "./optional-grpc-peer.js";
 import { stripQuery, trimTrailingSlashes } from "./path-utils.js";
 import { decodePbfQueryResponse, isPbfResponse } from "./pbf-decoder.js";
 import { createGeoServicesGpAdapter, createGeospatialGrpcProcessAdapter, createHonuaProcessRunner, createOgcProcessesAdapter, } from "./process-runner.js";
@@ -303,16 +304,12 @@ export class HonuaClient {
         if (this.connectClient) {
             return this.connectClient;
         }
-        // Keep optional Connect peers out of the module graph until the first
-        // gRPC operation is actually awaited. Caching the in-flight promise also
-        // prevents concurrent first calls from constructing competing clients.
+        // Keep optional Connect peers out of the static module graph until the
+        // first gRPC operation is awaited. A literal import() is followed by
+        // Vite/Rolldown and fails a REST production build when the peer is absent.
         let initPromise = this.connectClientPromise;
         if (!initPromise) {
-            initPromise = Promise.all([
-                import("@connectrpc/connect"),
-                import("@connectrpc/connect-web"),
-                import("../gen/geospatial/v1/feature_service_pb.js"),
-            ]).then(([{ createClient }, { createGrpcWebTransport }, { FeatureService }]) => {
+            initPromise = loadGrpcWebRuntime().then(({ createClient, createGrpcWebTransport, FeatureService }) => {
                 const transport = createGrpcWebTransport(this.connectTransportOptions());
                 this.connectClient = createClient(FeatureService, transport);
                 return this.connectClient;
@@ -327,7 +324,7 @@ export class HonuaClient {
             if (this.connectClientPromise === initPromise) {
                 this.connectClientPromise = undefined;
             }
-            throw error;
+            throw explainOptionalGrpcLoadFailure(error);
         }
     }
     /**
@@ -400,7 +397,17 @@ export class HonuaClient {
         }
     }
     static async loadGrpcAdapter() {
-        return import("./grpc-adapter.js");
+        let loaded;
+        try {
+            loaded = await importOptionalGrpcSpecifier(GRPC_ADAPTER_SPECIFIER);
+        }
+        catch (error) {
+            throw explainOptionalGrpcLoadFailure(error);
+        }
+        if (!isGrpcAdapterModule(loaded)) {
+            throw new Error("HonuaClient gRPC adapter loaded but did not export the query runtime.");
+        }
+        return loaded;
     }
     get isGrpcWeb() {
         return this.transport === "grpc-web";
@@ -1276,9 +1283,10 @@ export class HonuaClient {
         };
         return this.executeRequest(request, {
             callerSignal,
+            deadlineThroughFinalize: true,
             readOnlyQuery: policy?.readOnlyQuery,
             redirect: policy?.readOnlyQuery ? "preserve-method" : undefined,
-            finalize: async (response, durationMs, currentRequest, runAfter) => {
+            finalize: async (response, _durationMs, _currentRequest, runAfter) => {
                 // Parse the original body directly when no after-interceptor will read
                 // it; only clone when an interceptor needs an independent copy.
                 const body = await parseResponseBody(this.hasAfterInterceptors() ? response.clone() : response);
@@ -1288,11 +1296,9 @@ export class HonuaClient {
                 // failure envelope back as a "successful" response object.
                 const envelopeError = toGeoServicesError(response.status, body, response.headers);
                 if (envelopeError) {
-                    await this.applyErrorInterceptors({
-                        request: cloneRequestContext(currentRequest),
-                        error: envelopeError,
-                        durationMs,
-                    });
+                    // deadlineThroughFinalize is set for this wrapper, so executeRequest
+                    // dispatches error interceptors for this throw. Notifying here as well
+                    // runs every hook twice.
                     throw envelopeError;
                 }
                 await runAfter();
@@ -1552,9 +1558,14 @@ export class HonuaClient {
                         return shorted.value;
                 }
                 if (!response.ok && !options.okStatuses?.includes(response.status)) {
-                    const body = options.errorBody
-                        ? await options.errorBody(response, options.deadlineThroughFinalize ? timeout.signal : undefined)
-                        : await parseResponseBody(response.clone());
+                    const errorBodyRead = options.errorBody
+                        ? options.errorBody(response, options.deadlineThroughFinalize ? timeout.signal : undefined)
+                        : parseResponseBody(response.clone());
+                    // A custom fetchFn can return a non-OK body that ignores init.signal.
+                    // Race that read with the same deadline as a successful body.
+                    const body = options.deadlineThroughFinalize
+                        ? await awaitAbortable(errorBodyRead, timeout.signal)
+                        : await errorBodyRead;
                     const httpError = toHttpError(response.status, body, response.headers);
                     if (!refreshedAuth &&
                         (response.status === 401 || response.status === 403) &&
@@ -1591,6 +1602,16 @@ export class HonuaClient {
                 if (!options.deadlineThroughFinalize || !timeout.signal?.aborted)
                     throw error;
                 const terminalError = timeout.didTimeout ? new HonuaTimeoutError(this.timeoutMs ?? 0) : new HonuaAbortError();
+                // A body-read or finalize deadline is the same transient failure as a
+                // timeout inside fetch. Replay-safe requests re-enter the retry policy.
+                // Caller cancellation is never retried. Interceptors run only once the
+                // attempt is terminal, so a later successful retry does not observe it.
+                if (timeout.didTimeout &&
+                    shouldRetryRequest(this.retryOptions, request.method, attempt, undefined, terminalError, readOnlyQuery)) {
+                    await options.beforeReplay?.(cloneRequestContext(request), undefined, "retry");
+                    await this.sleepBeforeRetry(attempt, undefined, retrySignal);
+                    continue;
+                }
                 beginTerminalErrorNotification(terminalError, performance.now() - startTime);
                 throw terminalError;
             }
@@ -1978,3 +1999,50 @@ function mergePathWithQueryParams(path, additionalParams) {
     const withQuery = nextQuery.length > 0 ? `${basePath}?${nextQuery}` : basePath;
     return `${withQuery}${hash}`;
 }
+const CONNECT_SPECIFIER = "@connectrpc/connect";
+const CONNECT_WEB_SPECIFIER = "@connectrpc/connect-web";
+const FEATURE_SERVICE_SPECIFIER = "../gen/geospatial/v1/feature_service_pb.js";
+const GRPC_ADAPTER_SPECIFIER = "./grpc-adapter.js";
+/**
+ * Bundlers statically follow a literal `import("@connectrpc/connect")` and a
+ * relative `import("./grpc-adapter.js")` even when REST never calls them.
+ * Passing the specifier through a parameter leaves the import unbound, so a
+ * REST production build does not resolve the optional peers. Node still
+ * resolves the same strings when `transport: "grpc-web"` is selected.
+ */
+function importOptionalGrpcSpecifier(specifier) {
+    return import(/* @vite-ignore */ specifier);
+}
+function isNamespace(value) {
+    return (typeof value === "object" && value !== null) || typeof value === "function";
+}
+async function loadGrpcWebRuntime() {
+    const [connect, connectWeb, featureService] = await Promise.all([
+        importOptionalGrpcSpecifier(CONNECT_SPECIFIER),
+        importOptionalGrpcSpecifier(CONNECT_WEB_SPECIFIER),
+        importOptionalGrpcSpecifier(FEATURE_SERVICE_SPECIFIER),
+    ]);
+    if (!isNamespace(connect) || typeof connect.createClient !== "function") {
+        throw new Error('The optional peer "@connectrpc/connect" loaded but did not export createClient.');
+    }
+    if (!isNamespace(connectWeb) || typeof connectWeb.createGrpcWebTransport !== "function") {
+        throw new Error('The optional peer "@connectrpc/connect-web" loaded but did not export createGrpcWebTransport.');
+    }
+    const descriptor = isNamespace(featureService) ? featureService.FeatureService : undefined;
+    if (descriptor == null || typeof descriptor !== "object") {
+        throw new Error("The gRPC FeatureService descriptor loaded but was not a service descriptor.");
+    }
+    return {
+        createClient: connect.createClient,
+        createGrpcWebTransport: connectWeb.createGrpcWebTransport,
+        FeatureService: descriptor,
+    };
+}
+function isGrpcAdapterModule(value) {
+    if (!isNamespace(value))
+        return false;
+    return (typeof value.toProtoQueryRequest === "function" &&
+        typeof value.fromProtoQueryResponse === "function" &&
+        typeof value.wrapConnectError === "function" &&
+        typeof value.streamProtoPages === "function");
+}

package/core/deprecation-notice.d.ts

@@ -0,0 +1,28 @@
+type DeprecationWarningEmitter = {
+    emitWarning(message: string, options: {
+        code: string;
+        type: string;
+    }): void;
+};
+type DeprecationNoticeRuntime = {
+    process?: Partial<DeprecationWarningEmitter>;
+    console?: {
+        warn?: (message: string) => void;
+    };
+};
+export interface DeprecationNotice {
+    /** Stable `process.emitWarning` code, also the once-per-process key. */
+    code: string;
+    message: string;
+}
+/**
+ * Emits `notice` at most once per process (once per page in a browser), however
+ * many copies of the calling module are evaluated. Node routes it through
+ * `process.emitWarning` as a `DeprecationWarning`, so `--no-deprecation` and
+ * `--trace-deprecation` apply; runtimes without `process` get `console.warn`.
+ *
+ * Returns true when this call emitted the notice.
+ */
+export declare function emitDeprecationNoticeOnce(notice: DeprecationNotice, runtime?: DeprecationNoticeRuntime): boolean;
+export {};
+//# sourceMappingURL=deprecation-notice.d.ts.map

package/core/deprecation-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation-notice.d.ts","sourceRoot":"","sources":["../../../src/core/deprecation-notice.ts"],"names":[],"mappings":"AAAA,KAAK,yBAAyB,GAAG;IAC/B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7E,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,wBAAiE,GACzE,OAAO,CAYT"}

package/core/deprecation-notice.js

@@ -0,0 +1,22 @@
+/**
+ * Emits `notice` at most once per process (once per page in a browser), however
+ * many copies of the calling module are evaluated. Node routes it through
+ * `process.emitWarning` as a `DeprecationWarning`, so `--no-deprecation` and
+ * `--trace-deprecation` apply; runtimes without `process` get `console.warn`.
+ *
+ * Returns true when this call emitted the notice.
+ */
+export function emitDeprecationNoticeOnce(notice, runtime = globalThis) {
+    const key = Symbol.for(`@honua/sdk-js:deprecation:${notice.code}`);
+    const registry = runtime;
+    if (registry[key] === true)
+        return false;
+    registry[key] = true;
+    if (typeof runtime.process?.emitWarning === "function") {
+        runtime.process.emitWarning(notice.message, { code: notice.code, type: "DeprecationWarning" });
+    }
+    else {
+        runtime.console?.warn?.(`DeprecationWarning [${notice.code}]: ${notice.message}`);
+    }
+    return true;
+}

package/core/esri-geojson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esri-geojson.d.ts","sourceRoot":"","sources":["../../../src/core/esri-geojson.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,YAAY,EAKZ,cAAc,EACd,YAAY,EACZ,qBAAqB,EACtB,MAAM,YAAY,CAAC;AA0MpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAClE,eAAe,GAAG,IAAI,CA0ExB;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAQ1E;AAyBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC5C,gBAAgB,CAAC,EAAE,qBAAqB,GACvC,YAAY,GAAG,IAAI,CAuCrB"}
+{"version":3,"file":"esri-geojson.d.ts","sourceRoot":"","sources":["../../../src/core/esri-geojson.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,YAAY,EAKZ,cAAc,EACd,YAAY,EACZ,qBAAqB,EACtB,MAAM,YAAY,CAAC;AA2MpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAClE,eAAe,GAAG,IAAI,CA0ExB;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAQ1E;AAyBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC5C,gBAAgB,CAAC,EAAE,qBAAqB,GACvC,YAAY,GAAG,IAAI,CAuCrB"}

package/core/esri-geojson.js

@@ -62,18 +62,22 @@ function isExteriorRing(ring) {
 }
 function isPointOnSegment(point, segmentStart, segmentEnd) {
     const epsilon = 1e-9;
-    const crossProduct = (point[0] - segmentStart[0]) * (segmentEnd[1] - segmentStart[1]) -
-        (point[1] - segmentStart[1]) * (segmentEnd[0] - segmentStart[0]);
+    const segmentDeltaX = segmentEnd[0] - segmentStart[0];
+    const segmentDeltaY = segmentEnd[1] - segmentStart[1];
+    const segmentLengthSquared = segmentDeltaX * segmentDeltaX + segmentDeltaY * segmentDeltaY;
+    if (segmentLengthSquared <= epsilon * epsilon) {
+        const pointDeltaX = point[0] - segmentStart[0];
+        const pointDeltaY = point[1] - segmentStart[1];
+        return pointDeltaX * pointDeltaX + pointDeltaY * pointDeltaY <= epsilon * epsilon;
+    }
+    const crossProduct = (point[0] - segmentStart[0]) * segmentDeltaY - (point[1] - segmentStart[1]) * segmentDeltaX;
     if (Math.abs(crossProduct) > epsilon) {
         return false;
     }
-    const dotProduct = (point[0] - segmentStart[0]) * (segmentEnd[0] - segmentStart[0]) +
-        (point[1] - segmentStart[1]) * (segmentEnd[1] - segmentStart[1]);
+    const dotProduct = (point[0] - segmentStart[0]) * segmentDeltaX + (point[1] - segmentStart[1]) * segmentDeltaY;
     if (dotProduct < -epsilon) {
         return false;
     }
-    const segmentLengthSquared = (segmentEnd[0] - segmentStart[0]) * (segmentEnd[0] - segmentStart[0]) +
-        (segmentEnd[1] - segmentStart[1]) * (segmentEnd[1] - segmentStart[1]);
     return dotProduct - segmentLengthSquared <= epsilon;
 }
 function isPointInsideRing(point, ring) {

package/core/optional-grpc-peer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Optional gRPC-Web peers are not part of a REST install. Resolution failures
+ * for those packages become an actionable error only after `transport:
+ * "grpc-web"` has actually loaded them. Connect/RPC failures are returned
+ * unchanged so a real gRPC error is not relabeled as a missing install.
+ */
+declare const OPTIONAL_GRPC_PACKAGES: readonly ["@connectrpc/connect-web", "@connectrpc/connect", "@bufbuild/protobuf"];
+export type OptionalGrpcPackage = (typeof OPTIONAL_GRPC_PACKAGES)[number];
+export declare class HonuaOptionalGrpcPeerError extends Error {
+    readonly peer: OptionalGrpcPackage;
+    constructor(peer: OptionalGrpcPackage, cause: unknown);
+}
+export declare function explainOptionalGrpcLoadFailure(error: unknown): unknown;
+export {};
+//# sourceMappingURL=optional-grpc-peer.d.ts.map

package/core/optional-grpc-peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-grpc-peer.d.ts","sourceRoot":"","sources":["../../../src/core/optional-grpc-peer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAA,MAAM,sBAAsB,mFAAoF,CAAC;AAKjH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,SAAgB,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO;CAU7D;AAkCD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItE"}

package/core/optional-grpc-peer.js

@@ -0,0 +1,60 @@
+/**
+ * Optional gRPC-Web peers are not part of a REST install. Resolution failures
+ * for those packages become an actionable error only after `transport:
+ * "grpc-web"` has actually loaded them. Connect/RPC failures are returned
+ * unchanged so a real gRPC error is not relabeled as a missing install.
+ */
+const OPTIONAL_GRPC_PACKAGES = ["@connectrpc/connect-web", "@connectrpc/connect", "@bufbuild/protobuf"];
+const RESOLUTION_FAILURE = /ERR_MODULE_NOT_FOUND|ERR_PACKAGE_PATH_NOT_EXPORTED|Failed to resolve module specifier|Failed to fetch dynamically imported module|Cannot find package|Cannot find module/;
+export class HonuaOptionalGrpcPeerError extends Error {
+    peer;
+    constructor(peer, cause) {
+        const message = [
+            `HonuaClient transport "grpc-web" could not load the optional peer "${peer}".`,
+            "Install @bufbuild/protobuf, @connectrpc/connect, and @connectrpc/connect-web.",
+            "REST, including createHonua, does not load them.",
+        ].join(" ");
+        super(message, cause instanceof Error ? { cause } : undefined);
+        this.name = "HonuaOptionalGrpcPeerError";
+        this.peer = peer;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isGenuineGrpcFailure(error) {
+    if (!isRecord(error))
+        return false;
+    if (error instanceof Error && error.name === "HonuaGrpcError")
+        return true;
+    return typeof error.code === "number";
+}
+function peerNamedByResolutionFailure(error) {
+    if (!(error instanceof Error))
+        return undefined;
+    const code = "code" in error && (typeof error.code === "string" || typeof error.code === "number") ? String(error.code) : "";
+    const message = `${code}\n${error.message}`;
+    if (!RESOLUTION_FAILURE.test(message))
+        return undefined;
+    return OPTIONAL_GRPC_PACKAGES.find((name) => message.includes(name));
+}
+function missingOptionalGrpcPeer(error) {
+    const seen = new Set();
+    let current = error;
+    while (isRecord(current) && !seen.has(current)) {
+        seen.add(current);
+        if (isGenuineGrpcFailure(current))
+            return undefined;
+        const peer = peerNamedByResolutionFailure(current);
+        if (peer)
+            return peer;
+        current = current.cause;
+    }
+    return undefined;
+}
+export function explainOptionalGrpcLoadFailure(error) {
+    const peer = missingOptionalGrpcPeer(error);
+    if (!peer)
+        return error;
+    return new HonuaOptionalGrpcPeerError(peer, error);
+}

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

@@ -23,6 +23,7 @@ export declare class BasemapGalleryCompat {
     activeBasemap: unknown;
     private readonly subscriptions;
     private readonly watchListeners;
+    private readonly widgetHost;
     constructor(options?: BasemapGalleryCompatOptions);
     load(): Promise<BasemapGalleryCompat>;
     when(callback?: (widget: BasemapGalleryCompat) => void): Promise<BasemapGalleryCompat>;
@@ -33,6 +34,7 @@ export declare class BasemapGalleryCompat {
     refresh(): unknown;
     destroy(): void;
     private resolveBasemap;
+    private pushWidgetHost;
     private notifyWatchers;
 }
 //# sourceMappingURL=basemap-gallery.d.ts.map

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

@@ -1 +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"}
+{"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;AAGxB,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;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;gBAEtC,OAAO,GAAE,2BAAgC;IA0B/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;IAO/C,MAAM,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO;IAcrC,OAAO,IAAI,OAAO;IAOlB,OAAO,IAAI,IAAI;IAOtB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/basemap-gallery.js

@@ -1,4 +1,5 @@
 import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener, } from "./event-bus.js";
+import { bindHonuaWidgetHost, pushWidgetHostState } from "./widget-host.js";
 export class BasemapGalleryCompat {
     view;
     map;
@@ -11,6 +12,7 @@ export class BasemapGalleryCompat {
     activeBasemap;
     subscriptions;
     watchListeners;
+    widgetHost;
     constructor(options = {}) {
         this.view = options.view;
         this.map = options.map ?? extractViewMap(options.view);
@@ -23,6 +25,8 @@ export class BasemapGalleryCompat {
         this.activeBasemap = extractMapBasemap(this.map);
         this.subscriptions = [];
         this.watchListeners = new Map();
+        this.widgetHost = bindHonuaWidgetHost("honua-basemap-control", this.container, this.eventBus);
+        this.pushWidgetHost();
         if (this.autoRefresh) {
             this.subscriptions.push(this.eventBus.on("map.basemap-changed", (event) => {
                 this.activeBasemap = extractPayloadBasemap(event.payload);
@@ -73,6 +77,7 @@ export class BasemapGalleryCompat {
         this.source = [...basemaps];
         this.notifyWatchers("source", this.source);
         this.eventBus.emit("basemap-gallery.updated", { basemapCount: this.source.length }, this);
+        this.pushWidgetHost();
     }
     select(basemapOrId) {
         const basemap = this.resolveBasemap(basemapOrId);
@@ -112,6 +117,13 @@ export class BasemapGalleryCompat {
         }
         return undefined;
     }
+    pushWidgetHost() {
+        pushWidgetHostState(this.widgetHost, {
+            view: this.view,
+            mode: "gallery",
+            basemaps: this.source,
+        });
+    }
     notifyWatchers(propertyName, value) {
         const listeners = this.watchListeners.get(propertyName);
         if (!listeners) {

package/esri-compat/basemap.d.ts

@@ -4,6 +4,8 @@ export interface BasemapCompatOptions {
     title?: string;
     baseLayers?: readonly unknown[];
     referenceLayers?: readonly unknown[];
+    /** ArcGIS portal item, `{ id }` or a portal item id string. `load` fills the tiled layers from its data. */
+    portalItem?: unknown;
     eventBus?: CompatEventBus;
 }
 export type BasemapLoadStatusCompat = "not-loaded" | "loading" | "loaded";
@@ -14,6 +16,7 @@ export declare class BasemapCompat {
     readonly eventBus: CompatEventBus;
     id: string | undefined;
     title: string | undefined;
+    portalItem: unknown;
     baseLayers: unknown[];
     referenceLayers: unknown[];
     loaded: boolean;
@@ -27,6 +30,7 @@ export declare class BasemapCompat {
     when(callback?: (basemap: BasemapCompat) => void): Promise<BasemapCompat>;
     watch(propertyName: string, listener: (value: unknown) => void): BasemapHandleCompat;
     destroy(): void;
+    private populateFromPortalItem;
     private notifyWatchers;
 }
 //# sourceMappingURL=basemap.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"basemap.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/basemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,gBAAgB,CAAC;AAGjG,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,4GAA4G;IAC5G,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,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,CAAC;IACpB,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;WAavC,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;IAiB9B,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;YAIR,sBAAsB;IA2BpC,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/basemap.js

@@ -1,8 +1,10 @@
 import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener } from "./event-bus.js";
+import { PortalCompat } from "./portal.js";
 export class BasemapCompat {
     eventBus;
     id;
     title;
+    portalItem;
     baseLayers;
     referenceLayers;
     loaded;
@@ -13,6 +15,7 @@ export class BasemapCompat {
             options.eventBus ?? resolveCompatEventBus(options.baseLayers, options.referenceLayers) ?? new CompatEventBus();
         this.id = options.id;
         this.title = options.title ?? options.id;
+        this.portalItem = options.portalItem;
         this.baseLayers = options.baseLayers ? [...options.baseLayers] : [];
         this.referenceLayers = options.referenceLayers ? [...options.referenceLayers] : [];
         this.loaded = false;
@@ -42,6 +45,7 @@ export class BasemapCompat {
         this.loadStatus = "loading";
         this.notifyWatchers("loadStatus", this.loadStatus);
         this.eventBus.emit("basemap.loading", { id: this.id }, this);
+        await this.populateFromPortalItem();
         this.loaded = true;
         this.notifyWatchers("loaded", this.loaded);
         this.loadStatus = "loaded";
@@ -72,6 +76,33 @@ export class BasemapCompat {
     destroy() {
         this.watchListeners.clear();
     }
+    async populateFromPortalItem() {
+        if (this.baseLayers.length > 0 || this.portalItem === undefined || this.portalItem === null) {
+            return;
+        }
+        const portalItem = readPortalItem(this.portalItem);
+        if (!portalItem) {
+            return;
+        }
+        const portal = new PortalCompat({ portalUrl: portalItem.portalUrl });
+        try {
+            const data = await portal.getItemData(portalItem.id);
+            const layers = tiledLayersFromPortalData(data);
+            if (layers.title && (this.title === undefined || this.title === this.id)) {
+                this.title = layers.title;
+                this.notifyWatchers("title", this.title);
+            }
+            if (layers.base.length > 0) {
+                this.setBaseLayers(layers.base);
+            }
+            if (layers.reference.length > 0) {
+                this.setReferenceLayers(layers.reference);
+            }
+        }
+        catch {
+            // A private item or a missing data document leaves the basemap without tiles.
+        }
+    }
     notifyWatchers(propertyName, value) {
         const listeners = this.watchListeners.get(propertyName);
         if (!listeners) {
@@ -82,3 +113,42 @@ export class BasemapCompat {
         }
     }
 }
+function readPortalItem(value) {
+    if (typeof value === "string" && value.length > 0) {
+        return { id: value };
+    }
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    const record = value;
+    if (typeof record.id !== "string" || record.id.length === 0) {
+        return undefined;
+    }
+    const portalUrl = typeof record.portal?.url === "string" ? record.portal.url : undefined;
+    return { id: record.id, portalUrl };
+}
+function tiledLayersFromPortalData(data) {
+    if (!data || typeof data !== "object") {
+        return { base: [], reference: [] };
+    }
+    const record = data;
+    const basemap = record.baseMap ?? record.basemap;
+    if (!basemap || typeof basemap !== "object") {
+        return { base: [], reference: [] };
+    }
+    const source = basemap;
+    const title = typeof source.title === "string" ? source.title : typeof record.title === "string" ? record.title : undefined;
+    return {
+        title,
+        base: portalLayers(source.baseMapLayers ?? source.baseLayers),
+        reference: portalLayers(source.referenceLayers),
+    };
+}
+function portalLayers(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((layer) => {
+        return Boolean(layer) && typeof layer === "object" && typeof layer.url === "string";
+    });
+}

package/esri-compat/bookmarks.d.ts

@@ -23,6 +23,7 @@ export declare class BookmarksCompat {
     bookmarks: BookmarkCompatItem[];
     activeBookmark: BookmarkCompatItem | undefined;
     private readonly watchListeners;
+    private readonly widgetHost;
     constructor(options?: BookmarksCompatOptions);
     load(): Promise<BookmarksCompat>;
     when(callback?: (widget: BookmarksCompat) => void): Promise<BookmarksCompat>;
@@ -31,6 +32,7 @@ export declare class BookmarksCompat {
     remove(nameOrBookmark: string | BookmarkCompatItem): boolean;
     goTo(nameOrBookmark: string | BookmarkCompatItem): Promise<BookmarkCompatItem | undefined>;
     destroy(): void;
+    private pushWidgetHost;
     private notifyWatchers;
 }
 //# sourceMappingURL=bookmarks.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"bookmarks.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/bookmarks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,gBAAgB,CAAC;AAGjG,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;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;gBAEtC,OAAO,GAAE,sBAA2B;IAa1C,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;IAOvC,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;IAKtB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;CAUvB"}

package/esri-compat/bookmarks.js

@@ -1,4 +1,5 @@
 import { CompatEventBus, resolveCompatEventBus, safeInvokeCompatListener } from "./event-bus.js";
+import { bindHonuaWidgetHost, pushWidgetHostState } from "./widget-host.js";
 export class BookmarksCompat {
     view;
     container;
@@ -8,6 +9,7 @@ export class BookmarksCompat {
     bookmarks;
     activeBookmark;
     watchListeners;
+    widgetHost;
     constructor(options = {}) {
         this.view = options.view;
         this.container = options.container;
@@ -17,6 +19,8 @@ export class BookmarksCompat {
         this.bookmarks = options.bookmarks ? [...options.bookmarks] : [];
         this.activeBookmark = undefined;
         this.watchListeners = new Map();
+        this.widgetHost = bindHonuaWidgetHost("honua-bookmarks", this.container, this.eventBus);
+        this.pushWidgetHost();
     }
     async load() {
         if (this.loaded) {
@@ -56,6 +60,7 @@ export class BookmarksCompat {
         this.bookmarks.push(bookmark);
         this.notifyWatchers("bookmarks", this.bookmarks);
         this.eventBus.emit("bookmarks.updated", { bookmarkCount: this.bookmarks.length }, this);
+        this.pushWidgetHost();
     }
     remove(nameOrBookmark) {
         const index = typeof nameOrBookmark === "string"
@@ -89,6 +94,13 @@ export class BookmarksCompat {
     }
     destroy() {
         this.watchListeners.clear();
+        this.widgetHost?.destroy();
+    }
+    pushWidgetHost() {
+        pushWidgetHostState(this.widgetHost, {
+            view: this.view,
+            bookmarkList: this.bookmarks,
+        });
     }
     notifyWatchers(propertyName, value) {
         const listeners = this.watchListeners.get(propertyName);