@honua/sdk-esri-compat 0.0.6-alpha.0

package/core/wmts-capabilities.js

@@ -0,0 +1,409 @@
+/**
+ * WMTS 1.0.0 Capabilities parser. Hand-rolled, narrow-scope walker over
+ * the `Capabilities` document advertised by honua-server (single
+ * advertised TileMatrixSet today: `WebMercatorQuad`). Yields a typed
+ * `WmtsCapabilities` shape so the SDK can route through the canonical
+ * `Source` surface without leaking XML.
+ *
+ * @module
+ */
+export class HonuaWmtsCapabilitiesParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HonuaWmtsCapabilitiesParseError";
+    }
+}
+/**
+ * Parse a `Capabilities` text body for WMTS 1.0 into the typed
+ * `WmtsCapabilities` shape.
+ */
+export function parseWmtsCapabilities(xml) {
+    if (typeof xml !== "string" || xml.length === 0) {
+        throw new HonuaWmtsCapabilitiesParseError("WMTS Capabilities body is empty");
+    }
+    const root = findElement(xml, 0, "Capabilities");
+    if (!root) {
+        throw new HonuaWmtsCapabilitiesParseError("missing <Capabilities> root element");
+    }
+    const version = readAttribute(root.openTag, "version") ?? "1.0.0";
+    const service = parseServiceMetadata(root.inner);
+    const contents = findElement(root.inner, 0, "Contents");
+    const layers = contents ? collectLayers(contents.inner) : [];
+    const tileMatrixSets = contents ? collectTileMatrixSets(contents.inner) : [];
+    return { version, service, layers, tileMatrixSets };
+}
+function parseServiceMetadata(xml) {
+    const node = findElement(xml, 0, "ows:ServiceIdentification") ?? findElement(xml, 0, "ServiceIdentification");
+    if (!node)
+        return {};
+    const out = {};
+    const title = readTextElement(node.inner, "ows:Title") ?? readTextElement(node.inner, "Title");
+    if (title !== undefined)
+        out.title = title;
+    const abstract = readTextElement(node.inner, "ows:Abstract") ?? readTextElement(node.inner, "Abstract");
+    if (abstract !== undefined)
+        out.abstract = abstract;
+    return out;
+}
+function collectLayers(contentsInner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < contentsInner.length) {
+        const node = findElement(contentsInner, cursor, "Layer");
+        if (!node)
+            break;
+        const identifier = readTextElement(node.inner, "Identifier") ?? readTextElement(node.inner, "ows:Identifier") ?? "";
+        if (identifier.length > 0) {
+            const title = readTextElement(node.inner, "Title") ?? readTextElement(node.inner, "ows:Title");
+            const abstract = readTextElement(node.inner, "Abstract") ?? readTextElement(node.inner, "ows:Abstract");
+            const formats = collectChildText(node.inner, "Format");
+            const styles = collectStyles(node.inner);
+            const tileMatrixSetIds = collectTileMatrixSetLinks(node.inner);
+            const resources = collectResources(node.inner, "tile");
+            const featureInfoResources = collectResources(node.inner, "FeatureInfo");
+            const bbox = readWgs84BoundingBox(node.inner);
+            const layer = {
+                identifier,
+                formats,
+                styles,
+                tileMatrixSetIds,
+                resourceTemplates: resources,
+                featureInfoTemplates: featureInfoResources,
+            };
+            if (title !== undefined)
+                layer.title = title;
+            if (abstract !== undefined)
+                layer.abstract = abstract;
+            if (bbox !== undefined)
+                layer.bbox = bbox;
+            out.push(layer);
+        }
+        cursor = node.endIndex;
+    }
+    return out;
+}
+function collectStyles(layerInner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < layerInner.length) {
+        const node = findElement(layerInner, cursor, "Style");
+        if (!node)
+            break;
+        const identifier = readTextElement(node.inner, "Identifier") ?? readTextElement(node.inner, "ows:Identifier") ?? "";
+        if (identifier.length > 0) {
+            const title = readTextElement(node.inner, "Title") ?? readTextElement(node.inner, "ows:Title");
+            const isDefault = readAttribute(node.openTag, "isDefault") === "true";
+            const legend = findElement(node.inner, 0, "LegendURL");
+            const legendUrl = legend ? readAttribute(legend.openTag, "xlink:href") : undefined;
+            const style = { identifier, isDefault };
+            if (title !== undefined)
+                style.title = title;
+            if (legendUrl !== undefined)
+                style.legendUrl = legendUrl;
+            out.push(style);
+        }
+        cursor = node.endIndex;
+    }
+    return out;
+}
+function collectTileMatrixSetLinks(layerInner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < layerInner.length) {
+        const node = findElement(layerInner, cursor, "TileMatrixSetLink");
+        if (!node)
+            break;
+        const tms = readTextElement(node.inner, "TileMatrixSet") ?? readTextElement(node.inner, "ows:TileMatrixSet");
+        if (tms !== undefined && tms.length > 0)
+            out.push(tms);
+        cursor = node.endIndex;
+    }
+    return out;
+}
+function collectResources(layerInner, resourceType) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < layerInner.length) {
+        const node = findElement(layerInner, cursor, "ResourceURL");
+        if (!node)
+            break;
+        const type = readAttribute(node.openTag, "resourceType");
+        if (type === resourceType) {
+            const format = readAttribute(node.openTag, "format") ?? "";
+            const template = readAttribute(node.openTag, "template") ?? "";
+            if (template.length > 0) {
+                out.push({ format, template });
+            }
+        }
+        cursor = node.endIndex;
+    }
+    return out;
+}
+function readWgs84BoundingBox(layerInner) {
+    const node = findElement(layerInner, 0, "WGS84BoundingBox") ?? findElement(layerInner, 0, "ows:WGS84BoundingBox");
+    if (!node)
+        return undefined;
+    const lower = readTextElement(node.inner, "LowerCorner") ?? readTextElement(node.inner, "ows:LowerCorner") ?? "";
+    const upper = readTextElement(node.inner, "UpperCorner") ?? readTextElement(node.inner, "ows:UpperCorner") ?? "";
+    const lowerParts = lower.trim().split(/\s+/).map(Number);
+    const upperParts = upper.trim().split(/\s+/).map(Number);
+    if (lowerParts.length !== 2 ||
+        upperParts.length !== 2 ||
+        !Number.isFinite(lowerParts[0]) ||
+        !Number.isFinite(lowerParts[1]) ||
+        !Number.isFinite(upperParts[0]) ||
+        !Number.isFinite(upperParts[1])) {
+        return undefined;
+    }
+    return {
+        west: lowerParts[0],
+        south: lowerParts[1],
+        east: upperParts[0],
+        north: upperParts[1],
+    };
+}
+function collectTileMatrixSets(contentsInner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < contentsInner.length) {
+        const node = findElement(contentsInner, cursor, "TileMatrixSet");
+        if (!node)
+            break;
+        const identifier = readTextElement(node.inner, "Identifier") ?? readTextElement(node.inner, "ows:Identifier");
+        // Skip the per-layer `TileMatrixSet` reference inside `TileMatrixSetLink`
+        // (those carry only an identifier and no nested `TileMatrix` children).
+        const matrices = collectTileMatrices(node.inner);
+        if (identifier !== undefined && identifier.length > 0 && matrices.length > 0) {
+            const supportedCrs = readTextElement(node.inner, "SupportedCRS") ?? readTextElement(node.inner, "ows:SupportedCRS");
+            const wellKnown = readTextElement(node.inner, "WellKnownScaleSet") ?? readTextElement(node.inner, "ows:WellKnownScaleSet");
+            const tms = {
+                identifier,
+                matrices,
+            };
+            if (supportedCrs !== undefined)
+                tms.supportedCrs = supportedCrs;
+            if (wellKnown !== undefined)
+                tms.wellKnownScaleSet = wellKnown;
+            out.push(tms);
+        }
+        cursor = node.endIndex;
+    }
+    return out;
+}
+function collectTileMatrices(tmsInner) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < tmsInner.length) {
+        const node = findElement(tmsInner, cursor, "TileMatrix");
+        if (!node)
+            break;
+        const identifier = readTextElement(node.inner, "Identifier") ?? readTextElement(node.inner, "ows:Identifier") ?? "";
+        const scale = Number.parseFloat(readTextElement(node.inner, "ScaleDenominator") ?? "");
+        const topLeft = (readTextElement(node.inner, "TopLeftCorner") ?? "").trim().split(/\s+/).map(Number);
+        const tileWidth = Number.parseFloat(readTextElement(node.inner, "TileWidth") ?? "");
+        const tileHeight = Number.parseFloat(readTextElement(node.inner, "TileHeight") ?? "");
+        const matrixWidth = Number.parseFloat(readTextElement(node.inner, "MatrixWidth") ?? "");
+        const matrixHeight = Number.parseFloat(readTextElement(node.inner, "MatrixHeight") ?? "");
+        if (identifier.length > 0 &&
+            Number.isFinite(scale) &&
+            Number.isFinite(tileWidth) &&
+            Number.isFinite(tileHeight) &&
+            Number.isFinite(matrixWidth) &&
+            Number.isFinite(matrixHeight) &&
+            topLeft.length === 2 &&
+            Number.isFinite(topLeft[0]) &&
+            Number.isFinite(topLeft[1])) {
+            out.push({
+                identifier,
+                scaleDenominator: scale,
+                tileWidth,
+                tileHeight,
+                matrixWidth,
+                matrixHeight,
+                topLeftCorner: [topLeft[0], topLeft[1]],
+            });
+        }
+        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;
+}
+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: "", endIndex: close + 1 };
+        if (isClosing) {
+            i = close + 1;
+            continue;
+        }
+        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),
+                            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) {
+    return code === 32 || code === 9 || code === 10 || code === 13 || code === 47 || code === 62;
+}
+function readAttribute(openTag, name) {
+    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;
+    return decodeXmlText(node.inner.trim());
+}
+function decodeXmlText(text) {
+    if (text.indexOf("&") < 0 && text.indexOf("<![CDATA[") < 0)
+        return text;
+    return text
+        .replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, "$1")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&apos;/g, "'")
+        .replace(/&quot;/g, '"')
+        .replace(/&#(\d+);/g, (_match, dec) => String.fromCodePoint(Number(dec)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_match, hex) => String.fromCodePoint(Number.parseInt(hex, 16)));
+}
+/** Find a layer by identifier in a parsed `WmtsCapabilities`. */
+export function findWmtsLayer(capabilities, identifier) {
+    return capabilities.layers.find((l) => l.identifier === identifier);
+}
+/** Find a tile-matrix-set by identifier. */
+export function findWmtsTileMatrixSet(capabilities, identifier) {
+    return capabilities.tileMatrixSets.find((t) => t.identifier === identifier);
+}

package/core/wmts.d.ts

@@ -0,0 +1,80 @@
+/**
+ * First-party WMTS 1.0.0 adapter. `HonuaWmts` is the service-level
+ * handle returned by `client.wmts(serviceId)`; `HonuaWmtsLayer` is a
+ * single-layer projection that pre-fills LAYER and (optionally) STYLE;
+ * `HonuaWmtsTileset` adds a TileMatrixSet binding so per-call requests
+ * shrink to `{tileMatrix, tileRow, tileCol}`.
+ *
+ * The wire path lives on `HonuaClient` (`getWmtsCapabilities`,
+ * `fetchWmtsTile`, `getWmtsFeatureInfo`).
+ *
+ * @module
+ */
+import type { HonuaClient } from "./client.js";
+import type { HonuaWmtsFeatureInfoResponse, HonuaWmtsTileResponse, WmtsFeatureInfoRequest, WmtsTileRequest } from "./wms-types.js";
+import type { WmtsCapabilities, WmtsCapabilityLayer, WmtsCapabilityTileMatrixSet } from "./wmts-capabilities.js";
+export interface HonuaWmtsOptions {
+    client: HonuaClient;
+    serviceId: string;
+}
+export interface HonuaWmtsLayerOptions extends HonuaWmtsOptions {
+    layerName: string;
+    defaultStyleId?: string;
+    defaultTileMatrixSetId?: string;
+}
+export interface HonuaWmtsTilesetOptions extends HonuaWmtsOptions {
+    layerName: string;
+    styleId: string;
+    tileMatrixSetId: string;
+}
+export declare class HonuaWmts {
+    readonly client: HonuaClient;
+    readonly serviceId: string;
+    constructor(options: HonuaWmtsOptions);
+    /** Bind a single LAYER + optional STYLE / TileMatrixSet defaults. */
+    layer(name: string, options?: {
+        styleId?: string;
+        tileMatrixSetId?: string;
+    }): HonuaWmtsLayer;
+    tileset(layerName: string, styleId: string, tileMatrixSetId: string): HonuaWmtsTileset;
+    capabilities(options?: {
+        signal?: AbortSignal;
+    }): Promise<WmtsCapabilities>;
+    tile(request: WmtsTileRequest): Promise<HonuaWmtsTileResponse>;
+    featureInfo<T = Record<string, unknown>>(request: WmtsFeatureInfoRequest): Promise<HonuaWmtsFeatureInfoResponse<T>>;
+}
+export declare class HonuaWmtsLayer {
+    readonly client: HonuaClient;
+    readonly serviceId: string;
+    readonly layerName: string;
+    readonly defaultStyleId: string | undefined;
+    readonly defaultTileMatrixSetId: string | undefined;
+    constructor(options: HonuaWmtsLayerOptions);
+    describe(capabilities: WmtsCapabilities): WmtsCapabilityLayer | undefined;
+    tileset(styleId?: string, tileMatrixSetId?: string): HonuaWmtsTileset;
+    tile(request: Omit<WmtsTileRequest, "layer" | "style" | "tileMatrixSet"> & {
+        style?: string;
+        tileMatrixSet?: string;
+    }): Promise<HonuaWmtsTileResponse>;
+    featureInfo<T = Record<string, unknown>>(request: Omit<WmtsFeatureInfoRequest, "layer" | "style" | "tileMatrixSet"> & {
+        style?: string;
+        tileMatrixSet?: string;
+    }): Promise<HonuaWmtsFeatureInfoResponse<T>>;
+}
+/**
+ * Tileset handle bound to (layer × style × tileMatrixSet). The runtime
+ * binding for MapLibre's `raster` source spec is keyed off this shape.
+ */
+export declare class HonuaWmtsTileset {
+    readonly client: HonuaClient;
+    readonly serviceId: string;
+    readonly layerName: string;
+    readonly styleId: string;
+    readonly tileMatrixSetId: string;
+    constructor(options: HonuaWmtsTilesetOptions);
+    describe(capabilities: WmtsCapabilities): WmtsCapabilityTileMatrixSet | undefined;
+    tile(request: Omit<WmtsTileRequest, "layer" | "style" | "tileMatrixSet">): Promise<HonuaWmtsTileResponse>;
+    featureInfo<T = Record<string, unknown>>(request: Omit<WmtsFeatureInfoRequest, "layer" | "style" | "tileMatrixSet">): Promise<HonuaWmtsFeatureInfoResponse<T>>;
+}
+export declare function createHonuaWmts(client: HonuaClient, serviceId: string): HonuaWmts;
+//# sourceMappingURL=wmts.d.ts.map

package/core/wmts.d.ts.map

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

package/core/wmts.js

@@ -0,0 +1,173 @@
+/**
+ * First-party WMTS 1.0.0 adapter. `HonuaWmts` is the service-level
+ * handle returned by `client.wmts(serviceId)`; `HonuaWmtsLayer` is a
+ * single-layer projection that pre-fills LAYER and (optionally) STYLE;
+ * `HonuaWmtsTileset` adds a TileMatrixSet binding so per-call requests
+ * shrink to `{tileMatrix, tileRow, tileCol}`.
+ *
+ * The wire path lives on `HonuaClient` (`getWmtsCapabilities`,
+ * `fetchWmtsTile`, `getWmtsFeatureInfo`).
+ *
+ * @module
+ */
+import { findWmtsLayer, findWmtsTileMatrixSet } from "./wmts-capabilities.js";
+export class HonuaWmts {
+    client;
+    serviceId;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+    }
+    /** Bind a single LAYER + optional STYLE / TileMatrixSet defaults. */
+    layer(name, options) {
+        const opts = {
+            client: this.client,
+            serviceId: this.serviceId,
+            layerName: name,
+        };
+        if (options?.styleId !== undefined)
+            opts.defaultStyleId = options.styleId;
+        if (options?.tileMatrixSetId !== undefined)
+            opts.defaultTileMatrixSetId = options.tileMatrixSetId;
+        return new HonuaWmtsLayer(opts);
+    }
+    tileset(layerName, styleId, tileMatrixSetId) {
+        return new HonuaWmtsTileset({
+            client: this.client,
+            serviceId: this.serviceId,
+            layerName,
+            styleId,
+            tileMatrixSetId,
+        });
+    }
+    async capabilities(options) {
+        return this.client.getWmtsCapabilities({
+            serviceId: this.serviceId,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+    }
+    async tile(request) {
+        return this.client.fetchWmtsTile({ serviceId: this.serviceId, ...request });
+    }
+    async featureInfo(request) {
+        return this.client.getWmtsFeatureInfo({ serviceId: this.serviceId, ...request });
+    }
+}
+export class HonuaWmtsLayer {
+    client;
+    serviceId;
+    layerName;
+    defaultStyleId;
+    defaultTileMatrixSetId;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+        this.layerName = options.layerName;
+        this.defaultStyleId = options.defaultStyleId;
+        this.defaultTileMatrixSetId = options.defaultTileMatrixSetId;
+    }
+    describe(capabilities) {
+        return findWmtsLayer(capabilities, this.layerName);
+    }
+    tileset(styleId, tileMatrixSetId) {
+        const style = styleId ?? this.defaultStyleId ?? "default";
+        const tms = tileMatrixSetId ?? this.defaultTileMatrixSetId ?? "WebMercatorQuad";
+        return new HonuaWmtsTileset({
+            client: this.client,
+            serviceId: this.serviceId,
+            layerName: this.layerName,
+            styleId: style,
+            tileMatrixSetId: tms,
+        });
+    }
+    async tile(request) {
+        return this.client.fetchWmtsTile({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: request.style ?? this.defaultStyleId,
+            tileMatrixSet: request.tileMatrixSet ?? this.defaultTileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+    async featureInfo(request) {
+        return this.client.getWmtsFeatureInfo({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: request.style ?? this.defaultStyleId,
+            tileMatrixSet: request.tileMatrixSet ?? this.defaultTileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            i: request.i,
+            j: request.j,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.infoFormat !== undefined ? { infoFormat: request.infoFormat } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+}
+/**
+ * Tileset handle bound to (layer × style × tileMatrixSet). The runtime
+ * binding for MapLibre's `raster` source spec is keyed off this shape.
+ */
+export class HonuaWmtsTileset {
+    client;
+    serviceId;
+    layerName;
+    styleId;
+    tileMatrixSetId;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+        this.layerName = options.layerName;
+        this.styleId = options.styleId;
+        this.tileMatrixSetId = options.tileMatrixSetId;
+    }
+    describe(capabilities) {
+        return findWmtsTileMatrixSet(capabilities, this.tileMatrixSetId);
+    }
+    async tile(request) {
+        return this.client.fetchWmtsTile({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: this.styleId,
+            tileMatrixSet: this.tileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+    async featureInfo(request) {
+        return this.client.getWmtsFeatureInfo({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            style: this.styleId,
+            tileMatrixSet: this.tileMatrixSetId,
+            tileMatrix: request.tileMatrix,
+            tileRow: request.tileRow,
+            tileCol: request.tileCol,
+            i: request.i,
+            j: request.j,
+            ...(request.format !== undefined ? { format: request.format } : {}),
+            ...(request.infoFormat !== undefined ? { infoFormat: request.infoFormat } : {}),
+            ...(request.mode !== undefined ? { mode: request.mode } : {}),
+            ...(request.signal !== undefined ? { signal: request.signal } : {}),
+            ...(request.extraParams !== undefined ? { extraParams: request.extraParams } : {}),
+        });
+    }
+}
+export function createHonuaWmts(client, serviceId) {
+    return new HonuaWmts({ client, serviceId });
+}