@honua/react 0.1.2-beta.0 → 0.1.4-beta.0

package/core/wms-feature-info.js

@@ -0,0 +1,285 @@
+/**
+ * Capabilities-driven WMS 1.3 `GetFeatureInfo` execution.
+ *
+ * The first-party path in `wms.ts` addresses Honua Server's
+ * `/rest/services/{id}/MapServer/WMS` alias by service id. This module
+ * generalizes the same wire request so it can also be issued against the
+ * DCP operation URL a third-party `GetCapabilities` advertises, reusing the
+ * shared KVP serializer (and therefore the shared WMS 1.3 axis-order rule)
+ * rather than restating it.
+ *
+ * Everything here is fail-closed. A format the canonical `Result` contract
+ * cannot represent is never selected, a CRS whose WMS 1.3 axis order the SDK
+ * cannot prove is never sent, and a response body that does not decode into
+ * features raises `HonuaCapabilityNotSupportedError` instead of degrading into
+ * a silently empty result.
+ *
+ * @module
+ */
+import { parseCapabilitiesXml } from "./capabilities-xml.js";
+import { HonuaCapabilityNotSupportedError } from "./errors.js";
+import { parseEpsgCode } from "./wms-axis.js";
+import { serializeWmsFeatureInfoParams } from "./wms.js";
+/**
+ * Response ceiling for a point `GetFeatureInfo`. The request renders a 1×1
+ * image, so a conformant answer is small; the bound keeps a hostile or
+ * misconfigured server from turning identify-on-click into an unbounded read.
+ */
+export const WMS_FEATURE_INFO_MAX_RESPONSE_BYTES = 1024 * 1024;
+/**
+ * `INFO_FORMAT` values the canonical adapter can project into
+ * `Result.features`, most preferred first. GeoJSON/JSON keeps geometry and
+ * typed attribute values; GML is the interoperable fallback that MapServer and
+ * GeoServer deployments advertise when JSON output is not installed.
+ *
+ * Unstructured `text/plain` and `text/html` are deliberately absent: their
+ * bodies are template-defined per deployment, so projecting them into canonical
+ * features would mean inventing structure. Sources whose only advertised info
+ * formats are unstructured keep `query` disabled and stay reachable through the
+ * protocol escape hatch.
+ */
+const WMS_FEATURE_INFO_JSON_FORMATS = [
+    "application/geo+json",
+    "application/vnd.geo+json",
+    "application/json",
+    "application/json;subtype=geojson",
+    "geojson",
+    "json",
+];
+const WMS_FEATURE_INFO_GML_FORMATS = [
+    "application/vnd.ogc.gml",
+    "application/vnd.ogc.gml/3.1.1",
+    "application/gml+xml",
+    "application/gml+xml;version=3.2",
+    "text/xml;subtype=gml/3.1.1",
+    "text/xml;subtype=gml/3.2",
+    "text/xml;subtype=gml/3.2.1",
+    "text/xml",
+    "application/xml",
+    "gml",
+];
+function normalizeFormat(value) {
+    return value.replace(/\s+/g, "").toLowerCase();
+}
+/**
+ * Classify one advertised `INFO_FORMAT`. Returns `undefined` when the format
+ * carries no structure the canonical contract can project.
+ */
+export function classifyWmsFeatureInfoFormat(format) {
+    const normalized = normalizeFormat(format);
+    if (WMS_FEATURE_INFO_JSON_FORMATS.includes(normalized))
+        return "json";
+    if (WMS_FEATURE_INFO_GML_FORMATS.includes(normalized))
+        return "gml";
+    return undefined;
+}
+/**
+ * Pick the `INFO_FORMAT` the canonical adapter should request from the formats
+ * a service advertises for `GetFeatureInfo`. JSON families win over GML; within
+ * a family the SDK's preference order decides, not the server's ordering, so
+ * the selection is deterministic across deployments.
+ */
+export function selectWmsFeatureInfoFormat(advertised) {
+    for (const [kind, preference] of [
+        ["json", WMS_FEATURE_INFO_JSON_FORMATS],
+        ["gml", WMS_FEATURE_INFO_GML_FORMATS],
+    ]) {
+        for (const candidate of preference) {
+            const match = advertised.find((value) => normalizeFormat(value) === candidate);
+            if (match)
+                return Object.freeze({ kind, format: match });
+        }
+    }
+    return undefined;
+}
+function classifyWmsQueryCrs(code) {
+    const upper = code.toUpperCase();
+    if (upper === "CRS:84" || upper.includes("CRS84"))
+        return "crs84";
+    const epsg = parseEpsgCode(code);
+    if (epsg === 4326)
+        return "epsg4326";
+    if (epsg === 3857)
+        return "epsg3857";
+    return undefined;
+}
+/**
+ * Filter a layer's advertised CRS list down to the identifiers a point
+ * `GetFeatureInfo` may use, preserving the advertised spelling and order.
+ */
+export function reviewedWmsQueryCrs(advertised) {
+    const seen = new Set();
+    const reviewed = [];
+    for (const code of advertised) {
+        if (seen.has(code) || classifyWmsQueryCrs(code) === undefined)
+            continue;
+        seen.add(code);
+        reviewed.push(code);
+    }
+    return Object.freeze(reviewed);
+}
+/**
+ * Resolve the CRS a canonical query should put on the wire.
+ *
+ * The requested code comes from the spatial filter geometry (defaulting to
+ * `CRS:84`). An exact advertised spelling always wins. `CRS:84` and `EPSG:4326`
+ * are interchangeable *inputs* — both describe the same canonical `(x, y)` =
+ * `(lon, lat)` point and differ only in the wire axis order, which the shared
+ * serializer applies for whichever spelling is chosen — so a request in one is
+ * satisfied by the other when only that one is advertised. Anything else
+ * returns `undefined` so the caller can fail closed.
+ */
+export function resolveWmsQueryCrs(reviewed, requested) {
+    const requestedKind = classifyWmsQueryCrs(requested);
+    if (requestedKind === undefined)
+        return undefined;
+    const exact = reviewed.find((code) => code.toUpperCase() === requested.toUpperCase());
+    if (exact)
+        return exact;
+    const sameKind = reviewed.find((code) => classifyWmsQueryCrs(code) === requestedKind);
+    if (sameKind)
+        return sameKind;
+    if (requestedKind === "crs84" || requestedKind === "epsg4326") {
+        const interchangeable = requestedKind === "crs84" ? "epsg4326" : "crs84";
+        return reviewed.find((code) => classifyWmsQueryCrs(code) === interchangeable);
+    }
+    return undefined;
+}
+/**
+ * Issue a `GetFeatureInfo` against the capabilities-advertised operation URL
+ * and project the response into canonical typed features.
+ *
+ * Vendor query state already present on the advertised URL (tenant selectors,
+ * map identifiers) is preserved; the WMS KVP names are overwritten so a
+ * capabilities document cannot pin a stale `BBOX` or `INFO_FORMAT`.
+ */
+export async function executeWmsFeatureInfo(transport, options) {
+    const infoFormat = options.request.infoFormat ?? options.binding.format;
+    const kind = classifyWmsFeatureInfoFormat(infoFormat);
+    if (kind === undefined) {
+        throw new HonuaCapabilityNotSupportedError("query", "wms", `${options.sourceId} (GetFeatureInfo format "${infoFormat}" cannot be projected into canonical features)`);
+    }
+    const url = new URL(options.binding.url);
+    for (const [name, value] of serializeWmsFeatureInfoParams({ ...options.request, infoFormat })) {
+        url.searchParams.set(name, value);
+    }
+    const { text, contentType } = await transport.requestText("GET", url.toString(), {
+        accept: infoFormat,
+        maxResponseBytes: WMS_FEATURE_INFO_MAX_RESPONSE_BYTES,
+        ...(options.request.signal ? { signal: options.request.signal } : {}),
+    });
+    return decodeWmsFeatureInfoBody(text, contentType, kind, options.sourceId);
+}
+/**
+ * Project a decoded `GetFeatureInfo` body into canonical typed features.
+ * `kind` is the negotiated decoder family; the observed `contentType` only
+ * narrows a JSON negotiation that the server answered with XML (a common
+ * shape for OGC `ServiceExceptionReport` bodies returned with HTTP 200).
+ */
+export function decodeWmsFeatureInfoBody(text, contentType, kind, sourceId) {
+    const body = text.trim();
+    if (body.length === 0)
+        return Object.freeze([]);
+    if (kind === "json" && !/xml/i.test(contentType)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            throw unprojectableResponse(sourceId, "the JSON body could not be parsed");
+        }
+        return extractJsonFeatureInfoFeatures(parsed);
+    }
+    return extractGmlFeatureInfoFeatures(body, sourceId);
+}
+function unprojectableResponse(sourceId, detail) {
+    return new HonuaCapabilityNotSupportedError("query", "wms", `${sourceId} (GetFeatureInfo returned ${detail})`);
+}
+/**
+ * Decode a GeoJSON `FeatureCollection` or a Honua `FeatureInfoResponse`
+ * envelope. Mirrors the first-party JSON decoder so both wire paths produce the
+ * same canonical shape.
+ */
+function extractJsonFeatureInfoFeatures(parsed) {
+    if (!parsed || typeof parsed !== "object")
+        return Object.freeze([]);
+    const raw = parsed.features;
+    const features = Array.isArray(raw) ? raw : [];
+    const out = [];
+    for (const entry of features) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const feature = entry;
+        out.push({
+            attributes: (feature.attributes ?? feature.properties ?? {}),
+            geometry: feature.geometry ?? null,
+        });
+    }
+    return Object.freeze(out);
+}
+/** Property elements every GML feature carries that are not user attributes. */
+const GML_NON_ATTRIBUTE_PROPERTIES = new Set(["boundedBy", "extent"]);
+/**
+ * Project a GML `GetFeatureInfo` body into canonical typed features.
+ *
+ * Only the two container shapes the specification and the dominant server
+ * implementations produce are recognized: `gml:featureMember` /
+ * `gml:featureMembers` (GeoServer, deegree, QGIS Server) and MapServer's
+ * `msGMLOutput` layer wrapper. Each feature contributes its leaf property
+ * elements as attributes; complex properties (geometry, nested objects) are
+ * skipped rather than flattened, and `geometry` stays `null` because
+ * GetFeatureInfo answers a point the caller already holds.
+ */
+function extractGmlFeatureInfoFeatures(xml, sourceId) {
+    let root;
+    try {
+        root = parseCapabilitiesXml(xml, "WMS");
+    }
+    catch {
+        throw unprojectableResponse(sourceId, "a GML body that is not well-formed XML");
+    }
+    if (root.localName === "ServiceExceptionReport" || root.localName === "ExceptionReport") {
+        throw unprojectableResponse(sourceId, "an OGC exception report");
+    }
+    const featureNodes = collectGmlFeatureNodes(root);
+    if (featureNodes === undefined) {
+        throw unprojectableResponse(sourceId, "a GML body with no recognized feature container");
+    }
+    return Object.freeze(featureNodes.map((node) => ({ attributes: gmlFeatureAttributes(node), geometry: null })));
+}
+function collectGmlFeatureNodes(root) {
+    const members = [];
+    let sawContainer = false;
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (node.localName === "featureMember" || node.localName === "featureMembers") {
+            sawContainer = true;
+            members.push(...node.children);
+            continue;
+        }
+        stack.push(...node.children);
+    }
+    if (sawContainer)
+        return members;
+    if (root.localName === "msGMLOutput") {
+        // MapServer wraps each queried layer in `<{layer}_layer>` and each hit in
+        // `<{layer}_feature>`.
+        return root.children.flatMap((layer) => layer.children.filter((child) => child.localName.endsWith("_feature")));
+    }
+    return undefined;
+}
+function gmlFeatureAttributes(feature) {
+    const attributes = {};
+    for (const property of feature.children) {
+        if (GML_NON_ATTRIBUTE_PROPERTIES.has(property.localName))
+            continue;
+        if (property.children.length > 0)
+            continue;
+        const value = property.text.trim();
+        if (Object.hasOwn(attributes, property.localName))
+            continue;
+        attributes[property.localName] = value;
+    }
+    return attributes;
+}

package/core/wms.d.ts

@@ -131,6 +131,15 @@ export declare function getWmsMap(transport: HonuaProtocolTransport, request: {
 export declare function getWmsFeatureInfo<T = Record<string, unknown>>(transport: HonuaProtocolTransport, request: {
     serviceId: string;
 } & WmsFeatureInfoRequest): Promise<HonuaWmsFeatureInfoResponse<T>>;
+/**
+ * Serialize the WMS 1.3.0 KVP for a `GetFeatureInfo` request, including the
+ * authority-defined `BBOX` axis order for the requested CRS.
+ *
+ * Shared by the Honua service-id path above and the capabilities-driven
+ * third-party path (`wms-feature-info.ts`) so both emit byte-identical query
+ * state and only differ in which URL receives it.
+ */
+export declare function serializeWmsFeatureInfoParams(request: WmsFeatureInfoRequest): URLSearchParams;
 /**
  * Fetch a WMS `GetLegendGraphic`. honua-server does not implement
  * GetLegendGraphic today; callers should branch on

package/core/wms.d.ts.map

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

package/core/wms.js

@@ -226,19 +226,31 @@ export async function getWmsMap(transport, request) {
  * raw payload behind the protocol escape hatch.
  */
 export async function getWmsFeatureInfo(transport, request) {
+    const params = serializeWmsFeatureInfoParams(request);
+    const infoFormat = params.get("INFO_FORMAT");
+    const path = `${wmsBasePath(request.serviceId)}?${params.toString()}`;
+    const response = await transport.requestBytes("GET", path, infoFormat, undefined, request.signal);
+    return decodeWmsFeatureInfoResponse(response.bytes, response.contentType, infoFormat);
+}
+/**
+ * Serialize the WMS 1.3.0 KVP for a `GetFeatureInfo` request, including the
+ * authority-defined `BBOX` axis order for the requested CRS.
+ *
+ * Shared by the Honua service-id path above and the capabilities-driven
+ * third-party path (`wms-feature-info.ts`) so both emit byte-identical query
+ * state and only differ in which URL receives it.
+ */
+export function serializeWmsFeatureInfoParams(request) {
     const params = serializeWmsMapParams(request);
     params.set("REQUEST", "GetFeatureInfo");
     params.set("QUERY_LAYERS", request.queryLayers.join(","));
     params.set("I", String(Math.trunc(request.i)));
     params.set("J", String(Math.trunc(request.j)));
-    const infoFormat = request.infoFormat ?? "application/json";
-    params.set("INFO_FORMAT", infoFormat);
+    params.set("INFO_FORMAT", request.infoFormat ?? "application/json");
     if (request.featureCount !== undefined) {
         params.set("FEATURE_COUNT", String(Math.trunc(request.featureCount)));
     }
-    const path = `${wmsBasePath(request.serviceId)}?${params.toString()}`;
-    const response = await transport.requestBytes("GET", path, infoFormat, undefined, request.signal);
-    return decodeWmsFeatureInfoResponse(response.bytes, response.contentType, infoFormat);
+    return params;
 }
 /**
  * Fetch a WMS `GetLegendGraphic`. honua-server does not implement

package/esri-compat/event-bus.d.ts

@@ -87,6 +87,26 @@ export interface CompatEventPayloads {
             end: Date;
         } | undefined;
     };
+    /**
+     * Emitted the first time a compat widget shim tries to mount its delegated
+     * web component while no widget kit is registered (see
+     * `esri-compat/widget-host.ts`). Without a kit the shims stay
+     * state-model-only and their `container` renders nothing, so this is the
+     * machine-readable half of the one-time `console.warn` the host emits.
+     *
+     * Subscribe before constructing widgets: the diagnostic fires once per
+     * runtime and re-arms only when `registerHonuaWidgetKit` is called again.
+     */
+    "widget-kit.missing": {
+        /** Delegation tag the shim failed to mount (e.g. `honua-legend`). */
+        tagName: string;
+        /** The API the application must call to fix this. */
+        api: "registerHonuaWidgetKit";
+        /** Documentation entry describing the required registration step. */
+        docs: string;
+        /** The same human-readable text written to `console.warn`. */
+        message: string;
+    };
 }
 export declare class CompatEventBus {
     private readonly listenersByType;

package/esri-compat/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/event-bus.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,CAAC,QAAQ,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAE7F,MAAM,WAAW,uBAAuB;IACtC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,0BAA0B,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3G,uBAAuB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvG,uBAAuB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,sBAAsB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,sBAAsB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3F,yBAAyB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,yBAAyB,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,qBAAqB,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,gCAAgC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,sCAAsC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,gCAAgC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,6CAA6C,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC7G,kCAAkC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IACzF,sCAAsC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IACpF,mCAAmC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7F,sCAAsC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IACpF,kCAAkC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE;YAAE,KAAK,EAAE,IAAI,CAAC;YAAC,GAAG,EAAE,IAAI,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;CAC7G;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA+C;IAC/E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;;IAOxD,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAC3C,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GACpD,uBAAuB;IACnB,EAAE,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,uBAAuB;IAiBtG,KAAK,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,uBAAuB;IAU3F,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAE,OAAmB,GAAG,WAAW,CAAC,QAAQ,CAAC;IAY7G,KAAK,IAAI,IAAI;IAKpB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,UAAU;CAOnB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,UAAU,EAAE,SAAS,OAAO,EAAE,GAAG,cAAc,GAAG,SAAS,CAYnG;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMvG"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/event-bus.ts"],"names":[],"mappings":"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"}

package/esri-compat/feature-filter.d.ts

@@ -33,9 +33,44 @@ export type FeatureFilterLoadStatusCompat = "loaded";
 export interface FeatureFilterHandleCompat {
     remove(): void;
 }
+/**
+ * ArcGIS-shaped `FeatureFilter` properties, for handing a compat filter to an
+ * ArcGIS construct that has not been migrated.
+ *
+ * `objectIds` is narrowed to ArcGIS's `number[]` here, which is exactly the
+ * narrowing {@link FeatureFilterCompat.toEsriProperties} has to prove.
+ */
+export interface FeatureFilterEsriProperties {
+    where?: string;
+    objectIds?: number[];
+    geometry?: FeatureFilterGeometryCompat;
+    spatialRelationship: FeatureFilterSpatialRelationshipCompat;
+    distance?: number;
+    units?: string;
+    timeExtent?: {
+        start?: Date | number | null;
+        end?: Date | number | null;
+    };
+}
+/**
+ * ArcGIS `FeatureFilter` shim.
+ *
+ * **Documented divergence — `objectIds` element type (#1013).** ArcGIS
+ * declares `objectIds: number[]`. This shim declares
+ * `Array<number | string>`: Honua's non-Esri sources (OGC API Features,
+ * GeoJSON, STAC) carry string feature ids, and narrowing the property to
+ * `number` would make the shim unable to hold ids it has to round-trip
+ * through `queryFeatures` / `queryObjectIds`. The array itself is mutable, as
+ * ArcGIS declares it — `filter.objectIds.push(id)` is honored, because the
+ * array the shim stores is the array it evaluates.
+ *
+ * Use {@link FeatureFilterCompat.toEsriProperties} to project the filter onto
+ * the exact ArcGIS shape; it fails loudly rather than silently dropping an id
+ * ArcGIS cannot represent. See `docs/migration-punch-list.md`.
+ */
 export declare class FeatureFilterCompat {
     where: string | null;
-    objectIds: ReadonlyArray<number | string> | null;
+    objectIds: Array<number | string> | null;
     geometry: FeatureFilterGeometryCompat | null;
     spatialRelationship: FeatureFilterSpatialRelationshipCompat;
     distance: number | undefined;
@@ -49,6 +84,16 @@ export declare class FeatureFilterCompat {
     watch(propertyName: string, listener: (value: unknown) => void): FeatureFilterHandleCompat;
     clone(): FeatureFilterCompat;
     update(patch: FeatureFilterCompatOptions): FeatureFilterCompat;
+    /**
+     * Project this filter onto the ArcGIS `FeatureFilterProperties` shape so a
+     * partially migrated app can hand it to an un-migrated `@arcgis/core`
+     * construct (#1013 REQ-003).
+     *
+     * Throws when `objectIds` holds an id ArcGIS cannot represent: ArcGIS object
+     * ids are numbers, and quietly dropping or coercing a string id would hand
+     * back a filter that selects a different set of features than this one.
+     */
+    toEsriProperties(): FeatureFilterEsriProperties;
     toJSON(): Record<string, unknown>;
     private notifyWatchers;
 }

package/esri-compat/feature-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-filter.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/feature-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA4B,MAAM,gBAAgB,CAAC;AAE1E,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,MAAM,sCAAsC,GAC9C,YAAY,GACZ,UAAU,GACV,SAAS,GACT,UAAU,GACV,qBAAqB,GACrB,kBAAkB,GAClB,UAAU,GACV,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,MAAM,6BAA6B,GACrC;IAAE,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,GAC5D,IAAI,GACJ,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,EAAE,sCAAsC,CAAC;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,yBAAyB;IACxC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,qBAAa,mBAAmB;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC7C,mBAAmB,EAAE,sCAAsC,CAAC;IAC5D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,EAAE,6BAA6B,CAAC;IACjD,SAAgB,MAAM,EAAE,IAAI,CAAC;IAC7B,SAAgB,UAAU,EAAE,6BAA6B,CAAC;IAC1D,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;gBAEzD,OAAO,GAAE,0BAA+B;IAcpD,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,yBAAyB;IAc1F,KAAK,IAAI,mBAAmB;IAa5B,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,mBAAmB;IAiC9D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYxC,OAAO,CAAC,cAAc;CAOvB"}
+{"version":3,"file":"feature-filter.d.ts","sourceRoot":"","sources":["../../../src/esri-compat/feature-filter.ts"],"names":[],"mappings":"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"}

package/esri-compat/feature-filter.js

@@ -1,4 +1,20 @@
 import { CompatEventBus, safeInvokeCompatListener } from "./event-bus.js";
+/**
+ * ArcGIS `FeatureFilter` shim.
+ *
+ * **Documented divergence — `objectIds` element type (#1013).** ArcGIS
+ * declares `objectIds: number[]`. This shim declares
+ * `Array<number | string>`: Honua's non-Esri sources (OGC API Features,
+ * GeoJSON, STAC) carry string feature ids, and narrowing the property to
+ * `number` would make the shim unable to hold ids it has to round-trip
+ * through `queryFeatures` / `queryObjectIds`. The array itself is mutable, as
+ * ArcGIS declares it — `filter.objectIds.push(id)` is honored, because the
+ * array the shim stores is the array it evaluates.
+ *
+ * Use {@link FeatureFilterCompat.toEsriProperties} to project the filter onto
+ * the exact ArcGIS shape; it fails loudly rather than silently dropping an id
+ * ArcGIS cannot represent. See `docs/migration-punch-list.md`.
+ */
 export class FeatureFilterCompat {
     where;
     objectIds;
@@ -81,6 +97,39 @@ export class FeatureFilterCompat {
         this.eventBus.emit("feature-filter.updated", { filter: this.toJSON() }, this);
         return this;
     }
+    /**
+     * Project this filter onto the ArcGIS `FeatureFilterProperties` shape so a
+     * partially migrated app can hand it to an un-migrated `@arcgis/core`
+     * construct (#1013 REQ-003).
+     *
+     * Throws when `objectIds` holds an id ArcGIS cannot represent: ArcGIS object
+     * ids are numbers, and quietly dropping or coercing a string id would hand
+     * back a filter that selects a different set of features than this one.
+     */
+    toEsriProperties() {
+        const properties = {
+            spatialRelationship: this.spatialRelationship,
+        };
+        if (this.where != null)
+            properties.where = this.where;
+        if (this.objectIds != null) {
+            const unrepresentable = this.objectIds.filter((objectId) => typeof objectId !== "number" || !Number.isFinite(objectId));
+            if (unrepresentable.length > 0) {
+                const rendered = unrepresentable.map((objectId) => JSON.stringify(objectId)).join(", ");
+                throw new Error(`FeatureFilterCompat.toEsriProperties cannot represent non-numeric object ids as ArcGIS number[]: ${rendered}.`);
+            }
+            properties.objectIds = this.objectIds;
+        }
+        if (this.geometry != null)
+            properties.geometry = this.geometry;
+        if (this.distance !== undefined)
+            properties.distance = this.distance;
+        if (this.units !== undefined)
+            properties.units = this.units;
+        if (this.timeExtent != null)
+            properties.timeExtent = this.timeExtent;
+        return properties;
+    }
     toJSON() {
         const json = {};
         if (this.where != null)

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

@@ -50,9 +50,11 @@ export declare class GeoJSONLayerCompat {
     listMode: string;
     renderer: unknown;
     popupTemplate: unknown;
-    outFields: ReadonlyArray<string> | undefined;
+    /** Mutable to match the ArcGIS declaration (`string[]`); see #1013. */
+    outFields: string[] | undefined;
     objectIdField: string;
-    fields: ReadonlyArray<{
+    /** Mutable to match the ArcGIS declaration (`Field[]`); see #1013. */
+    fields: Array<{
         name: string;
         alias?: string;
         type?: string;

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

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

package/esri-compat/geojson-layer.js

@@ -11,8 +11,10 @@ export class GeoJSONLayerCompat {
     listMode;
     renderer;
     popupTemplate;
+    /** Mutable to match the ArcGIS declaration (`string[]`); see #1013. */
     outFields;
     objectIdField;
+    /** Mutable to match the ArcGIS declaration (`Field[]`); see #1013. */
     fields;
     geometryType;
     spatialReference;
@@ -34,9 +36,9 @@ export class GeoJSONLayerCompat {
         this.listMode = options.listMode ?? "show";
         this.renderer = options.renderer;
         this.popupTemplate = options.popupTemplate;
-        this.outFields = options.outFields;
+        this.outFields = options.outFields === undefined ? undefined : [...options.outFields];
         this.objectIdField = options.objectIdField ?? "OBJECTID";
-        this.fields = options.fields ?? [];
+        this.fields = options.fields === undefined ? [] : [...options.fields];
         this.geometryType = options.geometryType;
         this.spatialReference = options.spatialReference ?? { wkid: 4326 };
         this.loaded = false;

package/esri-compat/identity-manager.js

@@ -105,7 +105,7 @@ class IdentityManagerCompatStore {
         if (!engine) {
             return this.checkSignInStatus(url);
         }
-        const credential = await this.resolveThroughEngine(engine, url);
+        const credential = await this.resolveThroughEngine(engine);
         this.registerToken(credential);
         return { ...credential };
     }
@@ -137,7 +137,7 @@ class IdentityManagerCompatStore {
         }
         return undefined;
     }
-    async resolveThroughEngine(bound, url) {
+    async resolveThroughEngine(bound) {
         const context = { reason: "initial", forceRefresh: false };
         let credentials;
         try {

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

@@ -50,7 +50,8 @@ export declare class ImageryLayerCompat {
     listMode: string;
     format: string;
     pixelType: string | undefined;
-    bandIds: ReadonlyArray<number> | undefined;
+    /** Mutable to match the ArcGIS declaration (`number[]`); see #1013. */
+    bandIds: number[] | undefined;
     renderingRule: Record<string, unknown> | undefined;
     mosaicRule: Record<string, unknown> | undefined;
     loaded: boolean;

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

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