@honua/react 0.0.20-alpha.0

package/core/wms-capabilities.js

@@ -0,0 +1,559 @@
+/**
+ * WMS 1.3.0 Capabilities parser. Hand-rolled, narrow-scope text-walker
+ * over a `WMS_Capabilities` document. Returns a typed shape (layers,
+ * styles, bbox-per-CRS, dimensions, advertised formats) that the SDK
+ * can route through the canonical `Source` surface without leaking XML
+ * nodes into its public API.
+ *
+ * The parser is closed-schema (WMS 1.3 + the ISO 19128 service-metadata
+ * subset honua-server emits) and tolerates missing optional nodes
+ * gracefully. Vendor-extension elements outside the named set are
+ * ignored. A `HonuaWmsCapabilitiesParseError` (extends `HonuaError`) is
+ * thrown when a required root or top-level node is missing.
+ *
+ * @module
+ */
+import { decodeXmlText as decodeXmlEntities } from "./xml-text.js";
+/**
+ * Thrown when WMS Capabilities XML is missing required root structure or
+ * is otherwise malformed in a way that prevents extracting the typed
+ * shape above. Recoverable per-node gaps (missing `<Title>`,
+ * `<Abstract>`, etc.) are tolerated and return defaults.
+ */
+export class HonuaWmsCapabilitiesParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HonuaWmsCapabilitiesParseError";
+    }
+}
+/**
+ * Parse a `WMS_Capabilities` text body into the typed `WmsCapabilities`
+ * shape. The input is the raw XML string returned by `requestText`; the
+ * parser walks it once with a small named-element matcher and tolerates
+ * vendor extensions (unknown elements are skipped).
+ */
+export function parseWmsCapabilities(xml) {
+    if (typeof xml !== "string" || xml.length === 0) {
+        throw new HonuaWmsCapabilitiesParseError("WMS Capabilities body is empty");
+    }
+    const root = findElement(xml, 0, "WMS_Capabilities") ?? findElement(xml, 0, "WMT_MS_Capabilities");
+    if (!root) {
+        throw new HonuaWmsCapabilitiesParseError("missing <WMS_Capabilities> root element (received WMS Capabilities XML?)");
+    }
+    const version = readAttribute(root.openTag, "version") ?? "1.3.0";
+    const service = parseServiceMetadata(root.inner);
+    const capabilityNode = findElement(root.inner, 0, "Capability");
+    const requestNode = capabilityNode ? findElement(capabilityNode.inner, 0, "Request") : undefined;
+    const formats = parseFormats(requestNode?.inner ?? "");
+    const requestSupport = {
+        getFeatureInfo: requestNode ? findElement(requestNode.inner, 0, "GetFeatureInfo") !== undefined : false,
+        getLegendGraphic: requestNode ? findElement(requestNode.inner, 0, "GetLegendGraphic") !== undefined : false,
+    };
+    const layers = [];
+    if (capabilityNode) {
+        for (const layer of iterChildLayers(capabilityNode.inner, [])) {
+            layers.push(layer);
+        }
+    }
+    return {
+        version,
+        service,
+        layers,
+        formats,
+        request: requestSupport,
+    };
+}
+function parseServiceMetadata(capabilityXml) {
+    const node = findElement(capabilityXml, 0, "Service");
+    if (!node)
+        return {};
+    const out = {};
+    const title = readTextElement(node.inner, "Title");
+    if (title !== undefined)
+        out.title = title;
+    const abstract = readTextElement(node.inner, "Abstract");
+    if (abstract !== undefined)
+        out.abstract = abstract;
+    return out;
+}
+function parseFormats(requestInnerXml) {
+    const map = collectFormats(requestInnerXml, "GetMap");
+    const featureInfo = collectFormats(requestInnerXml, "GetFeatureInfo");
+    const legend = collectFormats(requestInnerXml, "GetLegendGraphic");
+    return { map, featureInfo, legend };
+}
+function collectFormats(requestInnerXml, requestName) {
+    const node = findElement(requestInnerXml, 0, requestName);
+    if (!node)
+        return [];
+    const formats = [];
+    let cursor = 0;
+    while (cursor < node.inner.length) {
+        const fmt = findElement(node.inner, cursor, "Format");
+        if (!fmt)
+            break;
+        const text = decodeXmlText(fmt.inner.trim());
+        if (text.length > 0)
+            formats.push(text);
+        cursor = fmt.endIndex;
+    }
+    return formats;
+}
+/**
+ * Walk every `<Layer>` element directly inside `parentInner`, applying
+ * inherited CRS / dimension / style fields from ancestors per WMS 1.3
+ * §7.2.4.6 inheritance rules. Iterative (no recursion through closures)
+ * to keep the parse hot path small.
+ */
+function* iterChildLayers(parentInner, ancestors) {
+    let cursor = 0;
+    while (cursor < parentInner.length) {
+        const layer = findElement(parentInner, cursor, "Layer");
+        if (!layer)
+            break;
+        const queryableAttr = readAttribute(layer.openTag, "queryable");
+        const inherited = mergeAncestors(ancestors);
+        // Strip nested <Layer>...</Layer> subtrees from the layer's own inner so
+        // descendant Name / Title / CRS / BoundingBox / Style / Dimension nodes
+        // do not leak upward into the parent (and from there into siblings via
+        // `mergeAncestors`). WMS 1.3 §7.2.4.6 inheritance is ancestor → descendant
+        // only; without this guard, an unnamed group layer takes its first child's
+        // name and bleeds the child's style across siblings.
+        const ownInner = stripNestedLayers(layer.inner);
+        const name = readTextElement(ownInner, "Name") ?? "";
+        const title = readTextElement(ownInner, "Title");
+        const abstract = readTextElement(ownInner, "Abstract");
+        const localCrs = collectChildText(ownInner, "CRS");
+        const localBbox = collectBoundingBoxes(ownInner);
+        const localStyles = collectStyles(ownInner);
+        const localDimensions = collectDimensions(ownInner);
+        const mergedCrs = uniqueOrder([...inherited.crs, ...localCrs]);
+        const mergedBbox = mergeBoundingBoxes(inherited.bbox, localBbox);
+        const mergedStyles = mergeStyles(inherited.styles, localStyles);
+        const mergedDimensions = mergeDimensions(inherited.dimensions, localDimensions);
+        const queryable = queryableAttr === "1" || /^true$/i.test(queryableAttr ?? "")
+            ? true
+            : queryableAttr === "0"
+                ? false
+                : inherited.queryable;
+        const node = {
+            name,
+            ...(title !== undefined ? { title } : {}),
+            ...(abstract !== undefined ? { abstract } : {}),
+            crs: mergedCrs,
+            bbox: mergedBbox,
+            styles: mergedStyles,
+            dimensions: mergedDimensions,
+            queryable,
+            children: [],
+        };
+        const ancestorsForChildren = [...ancestors, node];
+        const children = [];
+        for (const child of iterChildLayers(layer.inner, ancestorsForChildren)) {
+            children.push(child);
+        }
+        yield { ...node, children };
+        cursor = layer.endIndex;
+    }
+}
+function mergeAncestors(ancestors) {
+    if (ancestors.length === 0) {
+        return { crs: [], bbox: [], styles: [], dimensions: [], queryable: false };
+    }
+    let crs = [];
+    let bbox = [];
+    let styles = [];
+    let dimensions = [];
+    let queryable = false;
+    for (const ancestor of ancestors) {
+        crs = uniqueOrder([...crs, ...ancestor.crs]);
+        bbox = mergeBoundingBoxes(bbox, ancestor.bbox);
+        styles = mergeStyles(styles, ancestor.styles);
+        dimensions = mergeDimensions(dimensions, ancestor.dimensions);
+        queryable = queryable || ancestor.queryable;
+    }
+    return { crs, bbox, styles, dimensions, queryable };
+}
+function uniqueOrder(values) {
+    const seen = new Set();
+    const out = [];
+    for (const v of values) {
+        if (seen.has(v))
+            continue;
+        seen.add(v);
+        out.push(v);
+    }
+    return out;
+}
+function mergeBoundingBoxes(parent, local) {
+    if (local.length === 0)
+        return parent;
+    const out = [];
+    const seen = new Set();
+    for (const bb of local) {
+        seen.add(bb.crs);
+        out.push(bb);
+    }
+    for (const bb of parent) {
+        if (!seen.has(bb.crs))
+            out.push(bb);
+    }
+    return out;
+}
+function mergeStyles(parent, local) {
+    if (parent.length === 0)
+        return local;
+    const seen = new Set(local.map((s) => s.name));
+    const out = [...local];
+    for (const s of parent) {
+        if (!seen.has(s.name))
+            out.push(s);
+    }
+    return out;
+}
+function mergeDimensions(parent, local) {
+    if (parent.length === 0)
+        return local;
+    const seen = new Set(local.map((d) => d.name));
+    const out = [...local];
+    for (const d of parent) {
+        if (!seen.has(d.name))
+            out.push(d);
+    }
+    return out;
+}
+function collectBoundingBoxes(inner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < inner.length) {
+        const node = findElement(inner, cursor, "BoundingBox");
+        if (!node)
+            break;
+        const crs = readAttribute(node.openTag, "CRS") ?? readAttribute(node.openTag, "SRS");
+        const minx = parseFloatAttr(node.openTag, "minx");
+        const miny = parseFloatAttr(node.openTag, "miny");
+        const maxx = parseFloatAttr(node.openTag, "maxx");
+        const maxy = parseFloatAttr(node.openTag, "maxy");
+        if (crs && Number.isFinite(minx) && Number.isFinite(miny) && Number.isFinite(maxx) && Number.isFinite(maxy)) {
+            out.push({ crs, minx, miny, maxx, maxy });
+        }
+        cursor = node.endIndex;
+    }
+    // EX_GeographicBoundingBox is the WMS 1.3 alternative geographic bbox node
+    // (always WGS84). honua-server emits both; we pull it as a CRS:84 entry
+    // when the layer has not advertised one already.
+    const geo = findElement(inner, 0, "EX_GeographicBoundingBox");
+    if (geo) {
+        const w = parseFloatText(readTextElement(geo.inner, "westBoundLongitude"));
+        const e = parseFloatText(readTextElement(geo.inner, "eastBoundLongitude"));
+        const s = parseFloatText(readTextElement(geo.inner, "southBoundLatitude"));
+        const n = parseFloatText(readTextElement(geo.inner, "northBoundLatitude"));
+        if (Number.isFinite(w) &&
+            Number.isFinite(e) &&
+            Number.isFinite(s) &&
+            Number.isFinite(n) &&
+            !out.some((bb) => bb.crs === "CRS:84")) {
+            out.push({ crs: "CRS:84", minx: w, miny: s, maxx: e, maxy: n });
+        }
+    }
+    return out;
+}
+function collectStyles(inner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < inner.length) {
+        const node = findElement(inner, cursor, "Style");
+        if (!node)
+            break;
+        const name = readTextElement(node.inner, "Name") ?? "";
+        const title = readTextElement(node.inner, "Title");
+        const legend = findElement(node.inner, 0, "LegendURL");
+        const onlineResource = legend ? findElement(legend.inner, 0, "OnlineResource") : undefined;
+        const legendUrl = onlineResource ? readAttribute(onlineResource.openTag, "xlink:href") : undefined;
+        if (name.length > 0) {
+            const entry = { name };
+            if (title !== undefined)
+                entry.title = title;
+            if (legendUrl !== undefined)
+                entry.legendUrl = legendUrl;
+            out.push(entry);
+        }
+        cursor = node.endIndex;
+    }
+    return out;
+}
+function collectDimensions(inner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < inner.length) {
+        const node = findElement(inner, cursor, "Dimension");
+        if (!node)
+            break;
+        const name = readAttribute(node.openTag, "name");
+        if (typeof name === "string" && name.length > 0) {
+            const units = readAttribute(node.openTag, "units");
+            const def = readAttribute(node.openTag, "default");
+            const text = decodeXmlText(node.inner.trim());
+            const values = text.length > 0
+                ? text
+                    .split(",")
+                    .map((v) => v.trim())
+                    .filter((v) => v.length > 0)
+                : [];
+            const dim = { name, values };
+            if (units !== undefined)
+                dim.units = units;
+            if (def !== undefined)
+                dim.default = def;
+            out.push(dim);
+        }
+        cursor = node.endIndex;
+    }
+    return out;
+}
+function collectChildText(inner, tag) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < inner.length) {
+        const node = findElement(inner, cursor, tag);
+        if (!node)
+            break;
+        const text = decodeXmlText(node.inner.trim());
+        if (text.length > 0)
+            out.push(text);
+        cursor = node.endIndex;
+    }
+    return out;
+}
+/**
+ * Return `inner` with every nested `<Layer>...</Layer>` (and self-closed
+ * `<Layer .../>`) subtree elided. Used by `iterChildLayers` to read the
+ * layer's *own* metadata without walking into descendant layers.
+ */
+function stripNestedLayers(inner) {
+    if (inner.indexOf("<Layer") < 0)
+        return inner;
+    let cursor = 0;
+    let out = "";
+    while (cursor < inner.length) {
+        const node = findElement(inner, cursor, "Layer");
+        if (!node) {
+            out += inner.slice(cursor);
+            break;
+        }
+        out += inner.slice(cursor, node.startIndex);
+        cursor = node.endIndex;
+    }
+    return out;
+}
+/**
+ * Find the next `<tag …>…</tag>` (or `<tag …/>`) starting at `from`. The
+ * search ignores element nesting other than the requested tag and walks
+ * a balanced depth counter for the same tag so nested same-name elements
+ * (`<Layer>` inside `<Layer>`) terminate against the correct close. Skips
+ * XML comments (`<!-- … -->`) and CDATA sections (`<![CDATA[ … ]]>`).
+ */
+function findElement(xml, from, tag) {
+    let i = from;
+    while (i < xml.length) {
+        if (xml[i] !== "<") {
+            i += 1;
+            continue;
+        }
+        const next = xml[i + 1];
+        if (next === "!" && xml.startsWith("<!--", i)) {
+            const end = xml.indexOf("-->", i + 4);
+            if (end < 0)
+                return undefined;
+            i = end + 3;
+            continue;
+        }
+        if (next === "!" && xml.startsWith("<![CDATA[", i)) {
+            const end = xml.indexOf("]]>", i + 9);
+            if (end < 0)
+                return undefined;
+            i = end + 3;
+            continue;
+        }
+        if (next === "?" || next === "!") {
+            const end = xml.indexOf(">", i);
+            if (end < 0)
+                return undefined;
+            i = end + 1;
+            continue;
+        }
+        const isClosing = next === "/";
+        const nameStart = isClosing ? i + 2 : i + 1;
+        const matchesTag = xml.startsWith(tag, nameStart) && isTagBoundary(xml.charCodeAt(nameStart + tag.length));
+        if (!matchesTag) {
+            const close = xml.indexOf(">", i);
+            if (close < 0)
+                return undefined;
+            i = close + 1;
+            continue;
+        }
+        const close = xml.indexOf(">", i);
+        if (close < 0)
+            return undefined;
+        const openTag = xml.slice(i, close + 1);
+        const selfClosing = !isClosing && xml.charCodeAt(close - 1) === 47; // '/'
+        if (selfClosing) {
+            return { openTag, inner: "", startIndex: i, endIndex: close + 1 };
+        }
+        if (isClosing) {
+            // unmatched closing tag at this level — caller advanced past the
+            // opener. Skip past and keep searching.
+            i = close + 1;
+            continue;
+        }
+        // Walk forward looking for the matching close tag, accounting for
+        // nested same-name openings.
+        let depth = 1;
+        let cursor = close + 1;
+        while (cursor < xml.length && depth > 0) {
+            const angle = xml.indexOf("<", cursor);
+            if (angle < 0)
+                break;
+            const next2 = xml[angle + 1];
+            if (next2 === "!" && xml.startsWith("<!--", angle)) {
+                const end = xml.indexOf("-->", angle + 4);
+                if (end < 0)
+                    return undefined;
+                cursor = end + 3;
+                continue;
+            }
+            if (next2 === "!" && xml.startsWith("<![CDATA[", angle)) {
+                const end = xml.indexOf("]]>", angle + 9);
+                if (end < 0)
+                    return undefined;
+                cursor = end + 3;
+                continue;
+            }
+            const isCloser = next2 === "/";
+            const inspectStart = isCloser ? angle + 2 : angle + 1;
+            const matchesSame = xml.startsWith(tag, inspectStart) && isTagBoundary(xml.charCodeAt(inspectStart + tag.length));
+            const angleClose = xml.indexOf(">", angle);
+            if (angleClose < 0)
+                return undefined;
+            if (matchesSame) {
+                if (isCloser) {
+                    depth -= 1;
+                    if (depth === 0) {
+                        return {
+                            openTag,
+                            inner: xml.slice(close + 1, angle),
+                            startIndex: i,
+                            endIndex: angleClose + 1,
+                        };
+                    }
+                }
+                else {
+                    const innerSelfClose = xml.charCodeAt(angleClose - 1) === 47;
+                    if (!innerSelfClose)
+                        depth += 1;
+                }
+            }
+            cursor = angleClose + 1;
+        }
+        return undefined;
+    }
+    return undefined;
+}
+function isTagBoundary(code) {
+    // Whitespace, '/', or '>' terminate a tag name.
+    return code === 32 || code === 9 || code === 10 || code === 13 || code === 47 || code === 62;
+}
+function readAttribute(openTag, name) {
+    // Match `name="value"` or `name='value'`. Tolerates leading whitespace
+    // and case-sensitive name match (WMS attribute names are case-sensitive).
+    const idx = findAttributeIndex(openTag, name);
+    if (idx < 0)
+        return undefined;
+    const after = openTag.slice(idx + name.length);
+    const eq = after.indexOf("=");
+    if (eq < 0)
+        return undefined;
+    let cursor = eq + 1;
+    while (cursor < after.length && /\s/.test(after[cursor]))
+        cursor += 1;
+    const quote = after[cursor];
+    if (quote !== '"' && quote !== "'")
+        return undefined;
+    const end = after.indexOf(quote, cursor + 1);
+    if (end < 0)
+        return undefined;
+    return decodeXmlText(after.slice(cursor + 1, end));
+}
+function findAttributeIndex(openTag, name) {
+    let i = 0;
+    while (i < openTag.length) {
+        const found = openTag.indexOf(name, i);
+        if (found < 0)
+            return -1;
+        const before = openTag.charCodeAt(found - 1);
+        const isBoundaryStart = found === 0 || before === 32 || before === 9 || before === 10 || before === 13;
+        const after = openTag.charCodeAt(found + name.length);
+        const isBoundaryEnd = after === 61 || after === 32 || after === 9 || after === 10 || after === 13;
+        if (isBoundaryStart && isBoundaryEnd) {
+            return found;
+        }
+        i = found + 1;
+    }
+    return -1;
+}
+function readTextElement(xml, tag) {
+    const node = findElement(xml, 0, tag);
+    if (!node)
+        return undefined;
+    const decoded = decodeXmlText(node.inner.trim());
+    return decoded;
+}
+function parseFloatAttr(openTag, name) {
+    const value = readAttribute(openTag, name);
+    if (value === undefined)
+        return Number.NaN;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : Number.NaN;
+}
+function parseFloatText(value) {
+    if (value === undefined)
+        return Number.NaN;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : Number.NaN;
+}
+function decodeXmlText(text) {
+    if (text.indexOf("&") < 0 && text.indexOf("<![CDATA[") < 0)
+        return text;
+    return decodeXmlEntities(text);
+}
+/**
+ * Walk a parsed `WmsCapabilities` tree and yield every named layer
+ * (skipping container layers without a `name`). Useful for descriptor
+ * resolution: callers want to bind a `LAYER` name without re-walking
+ * the parent hierarchy.
+ */
+export function* iterateWmsLayers(capabilities) {
+    const stack = [...capabilities.layers];
+    while (stack.length > 0) {
+        const next = stack.shift();
+        if (!next)
+            break;
+        if (next.name.length > 0)
+            yield next;
+        for (const child of next.children) {
+            stack.push(child);
+        }
+    }
+}
+/**
+ * Find the first named layer with a matching name, or `undefined` if the
+ * capabilities document does not advertise it. Walks both root layers and
+ * children. Intended for the `HonuaWms.layer(name)` resolver path.
+ */
+export function findWmsLayer(capabilities, name) {
+    for (const layer of iterateWmsLayers(capabilities)) {
+        if (layer.name === name)
+            return layer;
+    }
+    return undefined;
+}

package/core/wms-types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Public request/response envelopes for the WMS / WMTS first-party
+ * adapter. Kept in their own module so the canonical SDK surface
+ * (`src/contract/index.ts`, `src/runtime/index.ts`, `src/index.ts`) can
+ * re-export them without dragging the runtime classes into trees that
+ * never reference WMS.
+ *
+ * @module
+ */
+import type { HonuaTypedFeature } from "./types.js";
+/**
+ * Coordinate reference system identifier accepted by WMS 1.3 endpoints.
+ * `EPSG:4326`, `EPSG:3857`, `CRS:84` are first-party; any other string is
+ * accepted but the adapter will trust the caller for axis order.
+ */
+export type WmsCrs = "EPSG:4326" | "EPSG:3857" | "CRS:84" | (string & {});
+/** WMS 1.3 GetMap request envelope. */
+export interface WmsMapRequest {
+    /** Layer names. Multiple layers are serialized as a comma-separated `LAYERS=` value. */
+    layers: readonly string[];
+    /**
+     * Style names. When present the array length must match `layers`. An
+     * empty array (or a missing entry) selects the layer's default style.
+     */
+    styles?: readonly string[];
+    /** CRS code. Defaults to `EPSG:3857`. */
+    crs?: WmsCrs;
+    /**
+     * Bounding box in the requested CRS. Tuple is the canonical
+     * `[minx, miny, maxx, maxy]` shape; the adapter swaps axis order when
+     * the CRS is `EPSG:4326` (lat,lon) per WMS 1.3 §6.7.3.2.
+     */
+    bbox: readonly [number, number, number, number];
+    width: number;
+    height: number;
+    /** Image MIME type. Defaults to `image/png`. */
+    format?: string;
+    /** Whether the rendered image should be transparent. Defaults to `true`. */
+    transparent?: boolean;
+    /** WMS `TIME` dimension override; falls back to the layer default. */
+    time?: string;
+    /** WMS `ELEVATION` dimension override. */
+    elevation?: string;
+    /** Background colour as `0xRRGGBB` or `#RRGGBB`. */
+    bgcolor?: string;
+    /** Vendor extras forwarded verbatim on the wire. */
+    extraParams?: Record<string, string | number | boolean>;
+    signal?: AbortSignal;
+}
+/** WMS 1.3 GetFeatureInfo request envelope. */
+export interface WmsFeatureInfoRequest extends WmsMapRequest {
+    /** Layers to query. Subset of `layers`. */
+    queryLayers: readonly string[];
+    /** Pixel column offset within the rendered image. */
+    i: number;
+    /** Pixel row offset within the rendered image. */
+    j: number;
+    /** `INFO_FORMAT` MIME type. Defaults to `application/json`. */
+    infoFormat?: "application/json" | "text/plain" | "text/html" | (string & {});
+    /** Maximum features to return. */
+    featureCount?: number;
+}
+/** WMS GetLegendGraphic request envelope. */
+export interface WmsLegendRequest {
+    layer: string;
+    style?: string;
+    format?: string;
+    width?: number;
+    height?: number;
+    signal?: AbortSignal;
+    extraParams?: Record<string, string | number | boolean>;
+}
+/**
+ * Decoded GetFeatureInfo response. `features` carries the canonical
+ * typed-feature shape when the wire response was JSON; non-JSON content
+ * is exposed through `bytes` so the protocol escape hatch still owns the
+ * raw payload.
+ */
+export interface HonuaWmsFeatureInfoResponse<T = Record<string, unknown>> {
+    contentType: string;
+    /** Decoded features when `infoFormat` was `application/json`. */
+    features?: ReadonlyArray<HonuaTypedFeature<T>>;
+    /** Raw bytes for non-JSON info formats (text/plain, html, …). */
+    bytes?: Uint8Array;
+}
+/** Raw bytes returned by `GetMap` / `GetLegendGraphic`. */
+export interface HonuaWmsImageResponse {
+    bytes: Uint8Array;
+    contentType: string;
+}
+/** Routing mode for `GetTile`. honua-server advertises both. */
+export type WmtsTileMode = "kvp" | "rest";
+/** WMTS 1.0 GetTile request envelope. */
+export interface WmtsTileRequest {
+    layer: string;
+    /** Style identifier. Defaults to `default`. */
+    style?: string;
+    /** TileMatrixSet identifier. Defaults to `WebMercatorQuad`. */
+    tileMatrixSet?: string;
+    /** TileMatrix identifier (zoom level). */
+    tileMatrix: string | number;
+    tileRow: number;
+    tileCol: number;
+    /** Image MIME type. Defaults to `image/png`. */
+    format?: string;
+    /** Routing mode. Defaults to `rest`. */
+    mode?: WmtsTileMode;
+    signal?: AbortSignal;
+    extraParams?: Record<string, string | number | boolean>;
+}
+/** WMTS 1.0 GetFeatureInfo request envelope. */
+export interface WmtsFeatureInfoRequest extends WmtsTileRequest {
+    i: number;
+    j: number;
+    infoFormat?: "application/json" | "text/plain" | "text/html" | (string & {});
+}
+/** Raw bytes returned by a WMTS `GetTile`. */
+export interface HonuaWmtsTileResponse {
+    bytes: Uint8Array;
+    contentType: string;
+    /** True when the server returned a non-error empty payload (sparse tile). */
+    empty: boolean;
+}
+/** WMTS GetFeatureInfo response (mirrors WMS). */
+export type HonuaWmtsFeatureInfoResponse<T = Record<string, unknown>> = HonuaWmsFeatureInfoResponse<T>;
+/** Resolve the RESTful path extension for a WMTS tile `Format` MIME type. */
+export declare function wmtsExtensionForFormat(format: string): string;
+//# sourceMappingURL=wms-types.d.ts.map

package/core/wms-types.d.ts.map

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