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

package/query-planner/wfs-v1.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Lightweight deterministic WFS 2.0 compiler.
+ *
+ * Kept separate from the semantic WFS compiler so importing the public
+ * `wfsProtocolModule()` does not pull the larger semantic compiler graph into
+ * contract-only bundles.
+ */
+import type { ProtocolModuleQueryCompileInput, ProtocolModuleQueryOperation } from "../contract/protocol-module.js";
+import type { CanonicalQuery, QueryIrSourceIdentity, WfsCompiledQueryV1, WfsProtocolCompiledQueryV1 } from "./types.js";
+/** Compile canonical query IR to the legacy deterministic WFS 2.0 GetFeature request. */
+export declare function compileWfsQuery(source: QueryIrSourceIdentity, query: CanonicalQuery): WfsCompiledQueryV1;
+/**
+ * The exact deterministic compiler hook installed on the first-party WFS
+ * protocol module and used by planner dispatch.
+ */
+export declare const wfsProtocolQueryCompiler: Readonly<{
+    kind: "wfs";
+    compile(input: ProtocolModuleQueryCompileInput<QueryIrSourceIdentity, CanonicalQuery>): WfsProtocolCompiledQueryV1;
+}>;
+type WfsProtocolRequest = Omit<WfsProtocolCompiledQueryV1, "compiler" | "operation">;
+/** Bind a WFS wire request to the exact operation authorized to execute it. */
+export declare function bindWfsProtocolQueryOperation(request: WfsProtocolRequest, operation: ProtocolModuleQueryOperation): WfsProtocolCompiledQueryV1;
+/** Credential-free endpoint identity used to bind an executable artifact to a runtime handle. */
+export declare function wfsRuntimeEndpointIdentity(value: string): string;
+/** Derive the only transport method authorized by the compiled filter budget. */
+export declare function wfsProtocolMethodForFilter(filter: string | undefined): "GET" | "POST";
+/**
+ * @internal True when the compiled request must name the geometry property in
+ * an FES spatial predicate. The `bbox=` KVP shortcut addresses the feature
+ * type's default geometry positionally, so it needs no name; every other
+ * spatial predicate emits `<fes:ValueReference>` and does. The live adapter
+ * uses this to resolve the property (and fail closed) only when the wire
+ * actually depends on it.
+ */
+export declare function wfsSpatialFilterNeedsGeometryProperty(query: CanonicalQuery): boolean;
+/** @internal Shared with legacy non-query WFS drains to preserve CRS parity. */
+export declare function wfsSrsNameFromOutSr(outSr: string | number | undefined): string | undefined;
+/** @internal Resolve only the input geometry CRS; response `outSr` is separate. */
+export declare function wfsFilterSrsNameFromGeometry(geometry: Readonly<Record<string, unknown>>, fallback: string | number | undefined): string | undefined;
+export {};
+//# sourceMappingURL=wfs-v1.d.ts.map

package/query-planner/wfs-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wfs-v1.d.ts","sourceRoot":"","sources":["../../../src/query-planner/wfs-v1.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAkBpH,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAaxH,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,cAAc,GAAG,kBAAkB,CA4BxG;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;mBAEpB,+BAA+B,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,0BAA0B;EAuDlH,CAAC;AAEH,KAAK,kBAAkB,GAAG,IAAI,CAAC,0BAA0B,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC;AAErF,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,4BAA4B,GACtC,0BAA0B,CA+B5B;AAED,iGAAiG;AACjG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAErF;AAuFD;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAGpF;AAeD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAa1F;AAQD,mFAAmF;AACnF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACpC,MAAM,GAAG,SAAS,CAiCpB"}

package/query-planner/wfs-v1.js

@@ -0,0 +1,366 @@
+import { compileQueryFilterToFes } from "../contract/query-filter-fes.js";
+import { andQueryFilters, temporalFilterToExpression, } from "../contract/query-filter.js";
+import { UNSUPPORTED_FES, compileSpatialFilter, compileWhere, formatWfsBboxKvp, serializeFes, } from "../core/wfs-filter.js";
+import { queryIrAuthorityFingerprint } from "./ir.js";
+import { HonuaQueryPlanningError } from "./types.js";
+const WFS_GET_FILTER_BUDGET = 7000;
+/**
+ * Metadata-free planning fallback only. The live WFS adapter resolves the real
+ * geometry property per feature type (DescribeFeatureType, or an explicit
+ * `locator.geometryName`) and carries it on the IR source identity, so this
+ * legacy PostGIS-via-GeoServer default is used only when a caller compiles a
+ * plan without any geometry evidence at all.
+ */
+const DEFAULT_WFS_GEOMETRY_PROPERTY = "the_geom";
+/** Compile canonical query IR to the legacy deterministic WFS 2.0 GetFeature request. */
+export function compileWfsQuery(source, query) {
+    const typeName = requireWfsTypeName(source);
+    const geometryProperty = wfsGeometryProperty(source);
+    assertNoWfsAggregation(query);
+    if (query.spatialFilter && query.outSr !== undefined) {
+        throw new HonuaQueryPlanningError("unsupported-query", "WFS planning cannot use outSr to label input filter coordinates; stamp the input geometry through the typed WFS escape hatch");
+    }
+    const filter = compileWfsFes(typeName, query, geometryProperty);
+    const propertyName = compileWfsPropertyNames(query, geometryProperty);
+    return {
+        compiler: "wfs-2.0-get-feature-v1",
+        typeName,
+        ...(filter !== undefined ? { filter } : {}),
+        ...(propertyName ? { propertyName } : {}),
+        ...(query.orderBy && query.orderBy.length > 0
+            ? {
+                sortBy: query.orderBy.map((sort) => `${sort.field} ${sort.direction === "desc" ? "DESC" : "ASC"}`).join(","),
+            }
+            : {}),
+        ...(query.pagination?.offset !== undefined ? { startIndex: query.pagination.offset } : {}),
+        ...(query.pagination?.limit !== undefined ? { count: query.pagination.limit } : {}),
+        ...(query.outSr !== undefined ? { srsName: String(query.outSr) } : {}),
+    };
+}
+/**
+ * The exact deterministic compiler hook installed on the first-party WFS
+ * protocol module and used by planner dispatch.
+ */
+export const wfsProtocolQueryCompiler = Object.freeze({
+    kind: "wfs",
+    compile(input) {
+        const typeName = requireWfsTypeName(input.source);
+        if (!/^[A-Za-z_][A-Za-z0-9_.-]*(?::[A-Za-z_][A-Za-z0-9_.-]*)?$/.test(typeName)) {
+            throw new HonuaQueryPlanningError("invalid-query", `Source "${input.source.id}" has an invalid WFS typeName`);
+        }
+        assertNoWfsAggregation(input.query);
+        const endpoint = requireCredentialFreeWfsCompileEndpoint(input.source.endpoint);
+        const authorityFingerprint = input.source.authorityFingerprint ??
+            queryIrAuthorityFingerprint(input.source.endpoint, input.source.authorizationScope);
+        if (!/^sha256:[0-9a-f]{64}$/.test(authorityFingerprint)) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS source authority fingerprint is invalid");
+        }
+        if (typeof input.source.id !== "string" ||
+            input.source.id.length === 0 ||
+            containsControlCharacter(input.source.id)) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS source id is invalid");
+        }
+        const srsName = wfsSrsNameFromOutSr(input.query.outSr);
+        const filterSrsName = wfsSpatialFilterSrsName(input.source, input.query);
+        const geometryProperty = wfsGeometryProperty(input.source);
+        const bbox = wfsBboxKvp(input.query, filterSrsName);
+        const filter = bbox === undefined ? compileWfsFes(typeName, input.query, geometryProperty, filterSrsName) : undefined;
+        const method = wfsProtocolMethodForFilter(filter);
+        const propertyName = compileWfsPropertyNames(input.query, geometryProperty);
+        const sortBy = input.query.orderBy && input.query.orderBy.length > 0
+            ? input.query.orderBy.map((sort) => `${sort.field}${sort.direction === "desc" ? " D" : " A"}`).join(",")
+            : undefined;
+        const startIndex = input.query.pagination?.offset !== undefined && input.query.pagination.offset > 0
+            ? input.query.pagination.offset
+            : undefined;
+        return bindWfsProtocolQueryOperation({
+            sourceId: input.source.id,
+            endpoint,
+            authorityFingerprint,
+            typeName,
+            method,
+            ...(filter !== undefined ? { filter } : {}),
+            ...(bbox !== undefined ? { bbox } : {}),
+            ...(propertyName !== undefined ? { propertyName: Object.freeze([...propertyName]) } : {}),
+            ...(sortBy !== undefined ? { sortBy } : {}),
+            ...(startIndex !== undefined ? { startIndex } : {}),
+            ...(input.query.pagination?.limit !== undefined ? { count: input.query.pagination.limit } : {}),
+            ...(filterSrsName !== undefined ? { filterSrsName } : {}),
+            ...(srsName !== undefined ? { srsName } : {}),
+        }, input.operation);
+    },
+});
+/** Bind a WFS wire request to the exact operation authorized to execute it. */
+export function bindWfsProtocolQueryOperation(request, operation) {
+    if (operation !== "query" && operation !== "queryAll" && operation !== "queryAggregate") {
+        throw new HonuaQueryPlanningError("invalid-query", "WFS protocol operation is invalid");
+    }
+    let count = request.count;
+    if (operation === "queryAll" && count !== undefined) {
+        if (!Number.isSafeInteger(count) || count < 0 || count >= Number.MAX_SAFE_INTEGER) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS queryAll pagination.limit must leave room for one lookahead row");
+        }
+        count += 1;
+    }
+    return Object.freeze({
+        compiler: "wfs-2.0-protocol-query-v1",
+        operation,
+        sourceId: request.sourceId,
+        endpoint: request.endpoint,
+        authorityFingerprint: request.authorityFingerprint,
+        typeName: request.typeName,
+        method: request.method,
+        ...(request.filter !== undefined ? { filter: request.filter } : {}),
+        ...(request.bbox !== undefined ? { bbox: request.bbox } : {}),
+        ...(request.propertyName !== undefined ? { propertyName: Object.freeze([...request.propertyName]) } : {}),
+        ...(request.sortBy !== undefined ? { sortBy: request.sortBy } : {}),
+        ...(request.startIndex !== undefined ? { startIndex: request.startIndex } : {}),
+        ...(count !== undefined ? { count } : {}),
+        ...(request.filterSrsName !== undefined ? { filterSrsName: request.filterSrsName } : {}),
+        ...(request.srsName !== undefined ? { srsName: request.srsName } : {}),
+    });
+}
+/** Credential-free endpoint identity used to bind an executable artifact to a runtime handle. */
+export function wfsRuntimeEndpointIdentity(value) {
+    return normalizeWfsEndpoint(value, true);
+}
+/** Derive the only transport method authorized by the compiled filter budget. */
+export function wfsProtocolMethodForFilter(filter) {
+    return filter !== undefined && encodeURIComponent(filter).length > WFS_GET_FILTER_BUDGET ? "POST" : "GET";
+}
+function requireCredentialFreeWfsCompileEndpoint(value) {
+    return normalizeWfsEndpoint(value, false);
+}
+function normalizeWfsEndpoint(value, allowRuntimeAuthority) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value === "[invalid-endpoint]" ||
+        containsControlCharacter(value)) {
+        throw new HonuaQueryPlanningError("invalid-query", "WFS endpoint identity is invalid");
+    }
+    try {
+        const parsed = new URL(value);
+        if (!allowRuntimeAuthority && (parsed.username || parsed.password || parsed.search || parsed.hash)) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS compile endpoint must not contain credentials, query, or fragment");
+        }
+        parsed.username = "";
+        parsed.password = "";
+        parsed.search = "";
+        parsed.hash = "";
+        // Match queryIrSourceIdentity(): normalize the URL serializer's single
+        // terminal separator without collapsing a path that intentionally ends
+        // in multiple slashes.
+        return parsed.toString().replace(/\/$/, "");
+    }
+    catch (error) {
+        if (error instanceof HonuaQueryPlanningError)
+            throw error;
+        if (/^[A-Za-z][A-Za-z0-9+.-]*:\/\//.test(value) || value.startsWith("//") || value.includes("@")) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS endpoint identity is invalid");
+        }
+        const queryIndex = value.search(/[?#]/);
+        if (!allowRuntimeAuthority && queryIndex >= 0) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS compile endpoint must not contain credentials, query, or fragment");
+        }
+        const path = queryIndex >= 0 ? value.slice(0, queryIndex) : value;
+        const normalized = path.replace(/\/$/, "");
+        if (path === "/")
+            return "/";
+        if (normalized.length === 0) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS endpoint identity is invalid");
+        }
+        return normalized;
+    }
+}
+function wfsBboxKvp(query, filterSrsName) {
+    const envelope = wfsBboxShortcutEnvelope(query);
+    if (!envelope)
+        return undefined;
+    return formatWfsBboxKvp(envelope.xmin, envelope.ymin, envelope.xmax, envelope.ymax, filterSrsName);
+}
+function wfsBboxShortcutEnvelope(query) {
+    const filter = query.spatialFilter;
+    // The `bbox=` KVP is mutually exclusive with `FILTER=`, so any other
+    // constraint that has to be expressed as FES (source-native `where`, the
+    // typed filter, a temporal predicate) disables the shortcut.
+    if (query.where !== undefined || query.filter !== undefined || query.temporalFilter !== undefined)
+        return undefined;
+    if (!filter || filter.geometryType !== "esriGeometryEnvelope")
+        return undefined;
+    if (filter.spatialRel !== undefined &&
+        filter.spatialRel !== "esriSpatialRelIntersects" &&
+        filter.spatialRel !== "esriSpatialRelEnvelopeIntersects") {
+        return undefined;
+    }
+    const envelope = filter.geometry;
+    if (typeof envelope.xmin !== "number" ||
+        typeof envelope.ymin !== "number" ||
+        typeof envelope.xmax !== "number" ||
+        typeof envelope.ymax !== "number") {
+        return undefined;
+    }
+    return { xmin: envelope.xmin, ymin: envelope.ymin, xmax: envelope.xmax, ymax: envelope.ymax };
+}
+/**
+ * @internal True when the compiled request must name the geometry property in
+ * an FES spatial predicate. The `bbox=` KVP shortcut addresses the feature
+ * type's default geometry positionally, so it needs no name; every other
+ * spatial predicate emits `<fes:ValueReference>` and does. The live adapter
+ * uses this to resolve the property (and fail closed) only when the wire
+ * actually depends on it.
+ */
+export function wfsSpatialFilterNeedsGeometryProperty(query) {
+    if (query.filter !== undefined && queryFilterContainsSpatial(query.filter))
+        return true;
+    return query.spatialFilter !== undefined && wfsBboxShortcutEnvelope(query) === undefined;
+}
+/** True when the typed filter references the feature type's geometry property. */
+function queryFilterContainsSpatial(filter) {
+    if (filter.kind === "spatial")
+        return filter.property === undefined;
+    if (filter.kind === "boolean")
+        return filter.args.some(queryFilterContainsSpatial);
+    if (filter.kind === "not")
+        return queryFilterContainsSpatial(filter.arg);
+    return false;
+}
+/** Geometry property the compiled request references by name. */
+function wfsGeometryProperty(source) {
+    return source.geometryProperty ?? DEFAULT_WFS_GEOMETRY_PROPERTY;
+}
+/** @internal Shared with legacy non-query WFS drains to preserve CRS parity. */
+export function wfsSrsNameFromOutSr(outSr) {
+    if (typeof outSr === "string") {
+        if (outSr.length === 0)
+            return undefined;
+        if (outSr.trim() !== outSr || /[\s,]/.test(outSr) || containsControlCharacter(outSr)) {
+            throw new HonuaQueryPlanningError("invalid-query", "WFS CRS identifier is invalid");
+        }
+        return outSr;
+    }
+    if (typeof outSr === "number" && Number.isSafeInteger(outSr) && outSr > 0) {
+        return `urn:ogc:def:crs:EPSG::${outSr}`;
+    }
+    if (outSr === undefined)
+        return undefined;
+    throw new HonuaQueryPlanningError("invalid-query", "WFS CRS identifier is invalid");
+}
+function wfsSpatialFilterSrsName(source, query) {
+    const spatialFilter = query.spatialFilter;
+    if (!spatialFilter)
+        return undefined;
+    return wfsFilterSrsNameFromGeometry(spatialFilter.geometry, source.srsName);
+}
+/** @internal Resolve only the input geometry CRS; response `outSr` is separate. */
+export function wfsFilterSrsNameFromGeometry(geometry, fallback) {
+    const spatialReference = geometry.spatialReference;
+    if (spatialReference === undefined)
+        return wfsSrsNameFromOutSr(fallback);
+    if (spatialReference === null || typeof spatialReference !== "object" || Array.isArray(spatialReference)) {
+        throw new HonuaQueryPlanningError("invalid-query", "WFS spatial filter geometry has an invalid spatialReference");
+    }
+    const reference = spatialReference;
+    const keys = Object.keys(reference);
+    if (keys.some((key) => key !== "wkid" && key !== "latestWkid" && key !== "wkt")) {
+        throw new HonuaQueryPlanningError("invalid-query", "WFS spatial filter geometry has an unsupported spatialReference member");
+    }
+    if (reference.wkt !== undefined) {
+        throw new HonuaQueryPlanningError("unsupported-query", "WFS spatial filters require a WKID-backed CRS; WKT cannot be serialized as a portable srsName");
+    }
+    for (const [name, value] of [
+        ["wkid", reference.wkid],
+        ["latestWkid", reference.latestWkid],
+    ]) {
+        if (value !== undefined && (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0)) {
+            throw new HonuaQueryPlanningError("invalid-query", `WFS spatial filter geometry has an invalid ${name}`);
+        }
+    }
+    const wkid = reference.latestWkid ?? reference.wkid;
+    if (typeof wkid !== "number") {
+        throw new HonuaQueryPlanningError("invalid-query", "WFS spatial filter geometry requires a positive WKID");
+    }
+    return wfsSrsNameFromOutSr(wkid);
+}
+function requireWfsTypeName(source) {
+    if (source.protocol !== "wfs") {
+        throw new HonuaQueryPlanningError("unsupported-compiler", `wfs-2.0-get-feature-v1 does not compile protocol "${source.protocol}"`);
+    }
+    if (!source.typeName) {
+        throw new HonuaQueryPlanningError("invalid-query", `Source "${source.id}" requires locator.typeName for WFS planning`);
+    }
+    return source.typeName;
+}
+function assertNoWfsAggregation(query) {
+    if (query.aggregation) {
+        throw new HonuaQueryPlanningError("unsupported-query", "WFS 2.0 has no portable remote aggregation; use degraded policy with an explicit bounded-local fallback");
+    }
+}
+function compileWfsFes(typeName, query, geometryProperty, srsName) {
+    const filters = [];
+    const typed = compileWfsTypedFilter(query, geometryProperty);
+    if (typed)
+        filters.push(typed);
+    if (query.where) {
+        const where = compileWhere(query.where.expression);
+        if (where === UNSUPPORTED_FES) {
+            throw new HonuaQueryPlanningError("unsupported-query", "The where clause is not expressible as FES 2.0");
+        }
+        if (where.kind !== "and" || where.operands.length > 0)
+            filters.push(where);
+    }
+    if (query.spatialFilter) {
+        const spatial = compileSpatialFilter({
+            geometry: query.spatialFilter.geometry,
+            geometryType: query.spatialFilter.geometryType,
+            ...(query.spatialFilter.spatialRel ? { spatialRel: query.spatialFilter.spatialRel } : {}),
+        }, {
+            geometryProperty,
+            ...(srsName !== undefined ? { srsName } : {}),
+        });
+        if (spatial === UNSUPPORTED_FES) {
+            throw new HonuaQueryPlanningError("unsupported-query", "The spatial predicate is not expressible as FES 2.0");
+        }
+        filters.push(spatial);
+    }
+    return filters.length > 0 ? serializeFes(filters, { typeName }) : undefined;
+}
+/**
+ * Compile the canonical typed filter (and a field-bound temporal filter) into
+ * FES 2.0. WFS has no protocol-level time parameter, so a temporal filter
+ * without a field is refused instead of being applied to a guessed column.
+ */
+function compileWfsTypedFilter(query, geometryProperty) {
+    const ctx = { protocol: "wfs", geometryProperty };
+    const temporalExpression = query.temporalFilter ? temporalFilterToExpression(query.temporalFilter, ctx) : undefined;
+    if (query.temporalFilter && temporalExpression === undefined) {
+        throw new HonuaQueryPlanningError("unsupported-query", "WFS has no protocol-level time parameter; Query.temporalFilter must name the temporal field");
+    }
+    const expression = andQueryFilters(query.filter, temporalExpression);
+    if (!expression)
+        return undefined;
+    return compileQueryFilterToFes(expression, ctx);
+}
+function compileWfsPropertyNames(query, geometryProperty) {
+    if (query.outFields && query.outFields.length > 0) {
+        const fields = [...query.outFields];
+        if (query.returnGeometry === false && fields.includes(geometryProperty)) {
+            throw new HonuaQueryPlanningError("unsupported-query", `WFS returnGeometry=false conflicts with outFields containing the geometry property "${geometryProperty}"`);
+        }
+        if (query.returnGeometry !== false && !fields.includes(geometryProperty)) {
+            fields.push(geometryProperty);
+        }
+        return fields;
+    }
+    if (query.returnGeometry === false) {
+        throw new HonuaQueryPlanningError("unsupported-query", "WFS returnGeometry=false requires explicit outFields because propertyName cannot otherwise suppress geometry exactly");
+    }
+    return undefined;
+}
+function containsControlCharacter(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code <= 0x1f || code === 0x7f)
+            return true;
+    }
+    return false;
+}

package/query-planner/wfs.d.ts

@@ -1,6 +1,4 @@
-import type { CanonicalQuery, QueryIrSourceIdentity, WfsCompiledQueryV1 } from "./types.js";
+export { compileWfsQuery } from "./wfs-v1.js";
 export { compileSemanticWfsQuery } from "./wfs-semantic.js";
 export type { SemanticWfsCompileOptions, SemanticWfsCompiledQueryV1, SemanticWfsSourceIdentity, Wfs20FilterCapabilitiesEvidence, } from "./wfs-semantic.js";
-/** Compile canonical query IR to a deterministic WFS 2.0 GetFeature request. */
-export declare function compileWfsQuery(source: QueryIrSourceIdentity, query: CanonicalQuery): WfsCompiledQueryV1;
 //# sourceMappingURL=wfs.d.ts.map

package/query-planner/wfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wfs.d.ts","sourceRoot":"","sources":["../../../src/query-planner/wfs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAuFxG"}
+{"version":3,"file":"wfs.d.ts","sourceRoot":"","sources":["../../../src/query-planner/wfs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC"}

package/query-planner/wfs.js

@@ -1,71 +1,2 @@
-import { UNSUPPORTED_FES, compileSpatialFilter, compileWhere, serializeFes } from "../core/wfs-filter.js";
-import { HonuaQueryPlanningError } from "./types.js";
+export { compileWfsQuery } from "./wfs-v1.js";
 export { compileSemanticWfsQuery } from "./wfs-semantic.js";
-/** Compile canonical query IR to a deterministic WFS 2.0 GetFeature request. */
-export function compileWfsQuery(source, query) {
-    if (source.protocol !== "wfs") {
-        throw new HonuaQueryPlanningError("unsupported-compiler", `wfs-2.0-get-feature-v1 does not compile protocol "${source.protocol}"`);
-    }
-    if (!source.typeName) {
-        throw new HonuaQueryPlanningError("invalid-query", `Source "${source.id}" requires locator.typeName for WFS planning`);
-    }
-    if (query.aggregation) {
-        throw new HonuaQueryPlanningError("unsupported-query", "WFS 2.0 has no portable remote aggregation; use degraded policy with an explicit bounded-local fallback");
-    }
-    if (query.spatialFilter && query.outSr !== undefined) {
-        throw new HonuaQueryPlanningError("unsupported-query", "WFS planning cannot use outSr to label input filter coordinates; stamp the input geometry through the typed WFS escape hatch");
-    }
-    // Keep this aligned with the current WFS adapter's reviewed default. A
-    // vendor-specific geometry property requires the typed WFS escape hatch
-    // until discovery carries that binding into both planner and executor.
-    const geometryProperty = "the_geom";
-    const filters = [];
-    if (query.where) {
-        const where = compileWhere(query.where.expression);
-        if (where === UNSUPPORTED_FES) {
-            throw new HonuaQueryPlanningError("unsupported-query", "The where clause is not expressible as FES 2.0");
-        }
-        if (where.kind !== "and" || where.operands.length > 0)
-            filters.push(where);
-    }
-    if (query.spatialFilter) {
-        const spatial = compileSpatialFilter({
-            geometry: query.spatialFilter.geometry,
-            geometryType: query.spatialFilter.geometryType,
-            ...(query.spatialFilter.spatialRel ? { spatialRel: query.spatialFilter.spatialRel } : {}),
-        }, {
-            geometryProperty,
-        });
-        if (spatial === UNSUPPORTED_FES) {
-            throw new HonuaQueryPlanningError("unsupported-query", "The spatial predicate is not expressible as FES 2.0");
-        }
-        filters.push(spatial);
-    }
-    let propertyName;
-    if (query.outFields && query.outFields.length > 0) {
-        const fields = [...query.outFields];
-        if (query.returnGeometry === false && fields.includes(geometryProperty)) {
-            throw new HonuaQueryPlanningError("unsupported-query", `WFS returnGeometry=false conflicts with outFields containing the geometry property "${geometryProperty}"`);
-        }
-        if (query.returnGeometry !== false && !fields.includes(geometryProperty))
-            fields.push(geometryProperty);
-        propertyName = fields;
-    }
-    else if (query.returnGeometry === false) {
-        throw new HonuaQueryPlanningError("unsupported-query", "WFS returnGeometry=false requires explicit outFields because propertyName cannot otherwise suppress geometry exactly");
-    }
-    return {
-        compiler: "wfs-2.0-get-feature-v1",
-        typeName: source.typeName,
-        ...(filters.length > 0 ? { filter: serializeFes(filters, { typeName: source.typeName }) } : {}),
-        ...(propertyName ? { propertyName } : {}),
-        ...(query.orderBy && query.orderBy.length > 0
-            ? {
-                sortBy: query.orderBy.map((sort) => `${sort.field} ${sort.direction === "desc" ? "DESC" : "ASC"}`).join(","),
-            }
-            : {}),
-        ...(query.pagination?.offset !== undefined ? { startIndex: query.pagination.offset } : {}),
-        ...(query.pagination?.limit !== undefined ? { count: query.pagination.limit } : {}),
-        ...(query.outSr !== undefined ? { srsName: String(query.outSr) } : {}),
-    };
-}

package/react/honua-map.d.ts

@@ -45,7 +45,9 @@ export interface HonuaMapProps {
     map?: MaplibreMap;
     /**
      * The `maplibre-gl` module. Provide it to avoid a dynamic import (and to pin
-     * the exact version). Ignored when {@link map} is supplied.
+     * the exact version). MapLibre 6 bundler hosts must call the module's
+     * `setWorkerUrl` before rendering; see `docs/react.md`. Ignored when
+     * {@link map} is supplied.
      */
     mapLibre?: MapLibreGlModule;
     /**

package/react/honua-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"honua-map.d.ts","sourceRoot":"","sources":["../../../src/react/honua-map.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAGxF,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOhH,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,KAAK,OAAO,EAAE,kBAAkB,KAAK,WAAW,GAAG;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;IAC3E,KAAK,EAAE,KAAK,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CAC3D;AAID,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,EAAE,eAAe,CAAC;IACzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC,CAAC;IAC5D;;;;OAIG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACpD,wCAAwC;IACxC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/C,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAwGxD"}
+{"version":3,"file":"honua-map.d.ts","sourceRoot":"","sources":["../../../src/react/honua-map.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAGxF,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOhH,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,KAAK,OAAO,EAAE,kBAAkB,KAAK,WAAW,GAAG;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;IAC3E,KAAK,EAAE,KAAK,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CAC3D;AAiBD,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,EAAE,eAAe,CAAC;IACzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC,CAAC;IAC5D;;;;OAIG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACpD,wCAAwC;IACxC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/C,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAwGxD"}

package/react/honua-map.js

@@ -18,6 +18,16 @@ import { loadMapPackage } from "../runtime/index.js";
 import { HonuaMapContext } from "./context.js";
 import { HonuaExternalMapContext } from "./external-map.js";
 import { useHonuaClient } from "./hooks.js";
+function normalizeMapLibreGlModule(imported) {
+    const module = imported;
+    if (typeof module.Map === "function" && typeof module.Popup === "function") {
+        return module;
+    }
+    if (typeof module.default?.Map === "function" && typeof module.default.Popup === "function") {
+        return module.default;
+    }
+    throw new Error("maplibre-gl does not expose Map and Popup constructors; install maplibre-gl 5.x or 6.x.");
+}
 const EMPTY_STYLE = { version: 8, sources: {}, layers: [] };
 /**
  * Render a Honua-composed MapLibre map.
@@ -50,7 +60,7 @@ export function HonuaMap(props) {
                 const container = containerRef.current;
                 if (!container)
                     return;
-                gl = mapLibre ?? (await import("maplibre-gl")).default;
+                gl = mapLibre ?? normalizeMapLibreGlModule(await import("maplibre-gl"));
                 if (cancelled)
                     return;
                 ownedMap = new gl.Map({

package/react/hooks.d.ts

@@ -101,7 +101,7 @@ export interface UseQueryResult<T> extends QuerySnapshot<Result<T>> {
  * ```tsx
  * const { data, isLoading, error, refetch } = useQuery(
  *   dataset.source("incidents"),
- *   { where: "STATUS = 'OPEN'", returnGeometry: true },
+ *   { pagination: { limit: 100 }, returnGeometry: true },
  * );
  * ```
  */

package/react/hooks.js

@@ -91,7 +91,7 @@ export function useDataset(options) {
  * ```tsx
  * const { data, isLoading, error, refetch } = useQuery(
  *   dataset.source("incidents"),
- *   { where: "STATUS = 'OPEN'", returnGeometry: true },
+ *   { pagination: { limit: 100 }, returnGeometry: true },
  * );
  * ```
  */

package/react/selection.d.ts.map

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

package/react/use-mounted-source.d.ts

@@ -57,7 +57,7 @@ export interface UseMountedSourceResult<T = Record<string, unknown>> {
  * @example
  * ```tsx
  * const { diagnostics, error } = useMountedSource(map, source, {
- *   query: { where: "STATUS = 'OPEN'" },
+ *   query: { pagination: { limit: 500 } },
  *   hover: true,
  *   onDiagnostics: (d) => console.log(d.strategy, d.featureCount),
  * });

package/react/use-mounted-source.js

@@ -161,7 +161,7 @@ function applyRendererDiff(map, handle, previous, next) {
  * @example
  * ```tsx
  * const { diagnostics, error } = useMountedSource(map, source, {
- *   query: { where: "STATUS = 'OPEN'" },
+ *   query: { pagination: { limit: 500 } },
  *   hover: true,
  *   onDiagnostics: (d) => console.log(d.strategy, d.featureCount),
  * });