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

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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"}

package/core/wms-types.js

@@ -0,0 +1,32 @@
+/**
+ * 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
+ */
+// ── WMTS wire-format helpers ──────────────────────────────────
+/**
+ * Canonical mapping from WMTS `Format` MIME types to RESTful path
+ * extensions. Shared between the wire client (`getWmtsTile` /
+ * `featureInfo` URL builders in `src/core/client.ts`) and the MapLibre
+ * raster source helper (`buildWmtsRasterSourceSpec` in
+ * `src/runtime/source-bridge.ts`) so a caller-supplied `format` lands on
+ * the same extension regardless of which surface composes the URL.
+ *
+ * The map is intentionally narrow — formats not listed here fall back
+ * to `png` per the conservative WMTS default. Add a new entry only when
+ * honua-server adds first-party support for the encoding.
+ */
+const WMTS_TILE_FORMAT_TO_EXTENSION = new Map([
+    ["image/png", "png"],
+    ["image/jpeg", "jpeg"],
+    ["image/jpg", "jpeg"],
+    ["image/webp", "webp"],
+]);
+/** Resolve the RESTful path extension for a WMTS tile `Format` MIME type. */
+export function wmtsExtensionForFormat(format) {
+    return WMTS_TILE_FORMAT_TO_EXTENSION.get(format.toLowerCase()) ?? "png";
+}

package/core/wms.d.ts

@@ -0,0 +1,108 @@
+/**
+ * First-party WMS 1.3.0 adapter. `HonuaWms` is the service-level handle
+ * returned by `client.wms(serviceId)`; `HonuaWmsLayer` is the bound
+ * handle returned by `HonuaWms.layer(name)` that pre-fills the LAYER and
+ * default STYLE so per-call envelopes can drop the routing fields.
+ *
+ * Wire transport lives on `HonuaClient` (`getWmsCapabilities`,
+ * `getWmsMap`, `getWmsFeatureInfo`, `getWmsLegend`); this class is the
+ * typed surface consumers reach through `Source.protocol("wms")`.
+ *
+ * @module
+ */
+import type { HonuaClient } from "./client.js";
+import type { WmsCapabilities, WmsCapabilityLayer, WmsCapabilityStyle } from "./wms-capabilities.js";
+import type { HonuaWmsFeatureInfoResponse, HonuaWmsImageResponse, WmsFeatureInfoRequest, WmsLegendRequest, WmsMapRequest } from "./wms-types.js";
+export interface HonuaWmsOptions {
+    client: HonuaClient;
+    serviceId: string;
+}
+/**
+ * Split a WMS `LAYERS=` value (or `locator.typeName` / `spec.layers` of
+ * the same shape) into the list of non-empty trimmed layer tokens. Used
+ * by the contract WMS adapter and shared style resolver so the
+ * single-layer handle rule stays in one place.
+ */
+export declare function parseWmsLayerNames(value: string | undefined): readonly string[];
+export interface HonuaWmsLayerOptions extends HonuaWmsOptions {
+    /** WMS LAYER name (single layer; multi-layer renders use the parent handle). */
+    layerName: string;
+    /** Default STYLE for renders / feature-info on this layer. */
+    defaultStyleId?: string;
+}
+/**
+ * Service-level WMS handle. Use `layer(name)` to bind a single LAYER and
+ * style; for multi-layer composites (`LAYERS=a,b,c`) call `map()` /
+ * `featureInfo()` directly on this handle.
+ */
+export declare class HonuaWms {
+    readonly client: HonuaClient;
+    readonly serviceId: string;
+    private capabilitiesPromise;
+    constructor(options: HonuaWmsOptions);
+    /** Bind a single named layer for layer-scoped requests. */
+    layer(name: string, defaultStyleId?: string): HonuaWmsLayer;
+    /** Fetch and parse the service `GetCapabilities` document. */
+    capabilities(options?: {
+        signal?: AbortSignal;
+    }): Promise<WmsCapabilities>;
+    /** Render a `GetMap` request across one or more advertised layers. */
+    map(request: WmsMapRequest): Promise<HonuaWmsImageResponse>;
+    /** Issue a `GetFeatureInfo` against one or more advertised layers. */
+    featureInfo<T = Record<string, unknown>>(request: WmsFeatureInfoRequest): Promise<HonuaWmsFeatureInfoResponse<T>>;
+    /**
+     * Fetch a `GetLegendGraphic` image. Always gates on parsed Capabilities:
+     * when the caller does not pre-supply `options.capabilities`, the handle
+     * lazily loads them once via `getWmsCapabilities` and caches the
+     * promise on the instance so repeat calls reuse the same fetch. Throws
+     * `HonuaCapabilityNotSupportedError("legend", "wms", serviceId)` when
+     * the service does not advertise `<GetLegendGraphic>`.
+     */
+    legend(request: WmsLegendRequest, options?: {
+        capabilities?: WmsCapabilities;
+    }): Promise<HonuaWmsImageResponse>;
+    private loadCachedCapabilities;
+}
+/**
+ * Bound layer handle. Drops `layers` / `styles` from per-call requests
+ * and pre-fills the LAYER name. `featureInfo()` carries the same `i`,
+ * `j`, and `bbox` envelope as the service-level handle.
+ */
+export declare class HonuaWmsLayer {
+    readonly client: HonuaClient;
+    readonly serviceId: string;
+    readonly layerName: string;
+    readonly defaultStyleId: string | undefined;
+    private capabilitiesPromise;
+    constructor(options: HonuaWmsLayerOptions);
+    /** Fetch the parent service's `GetCapabilities`. */
+    capabilities(options?: {
+        signal?: AbortSignal;
+    }): Promise<WmsCapabilities>;
+    /** Find this layer in a parsed Capabilities document. */
+    describe(capabilities: WmsCapabilities): WmsCapabilityLayer | undefined;
+    /** Enumerate the styles advertised on this layer. */
+    stylesIn(capabilities: WmsCapabilities): readonly WmsCapabilityStyle[];
+    map(request: Omit<WmsMapRequest, "layers" | "styles"> & {
+        style?: string;
+    }): Promise<HonuaWmsImageResponse>;
+    featureInfo<T = Record<string, unknown>>(request: Omit<WmsFeatureInfoRequest, "layers" | "queryLayers" | "styles"> & {
+        style?: string;
+    }): Promise<HonuaWmsFeatureInfoResponse<T>>;
+    /**
+     * Fetch a `GetLegendGraphic` image scoped to the bound layer + style.
+     * Mirrors `HonuaWms.legend`'s gating: when `options.capabilities` is
+     * not supplied, the handle lazily loads them once via
+     * `getWmsCapabilities` and caches the promise. Throws
+     * `HonuaCapabilityNotSupportedError("legend", "wms", serviceId)` when
+     * the service does not advertise `<GetLegendGraphic>`.
+     */
+    legend(request?: Omit<WmsLegendRequest, "layer" | "style"> & {
+        style?: string;
+    }, options?: {
+        capabilities?: WmsCapabilities;
+    }): Promise<HonuaWmsImageResponse>;
+    private loadCachedCapabilities;
+}
+export declare function createHonuaWms(client: HonuaClient, serviceId: string): HonuaWms;
+//# sourceMappingURL=wms.d.ts.map

package/core/wms.d.ts.map

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

package/core/wms.js

@@ -0,0 +1,182 @@
+/**
+ * First-party WMS 1.3.0 adapter. `HonuaWms` is the service-level handle
+ * returned by `client.wms(serviceId)`; `HonuaWmsLayer` is the bound
+ * handle returned by `HonuaWms.layer(name)` that pre-fills the LAYER and
+ * default STYLE so per-call envelopes can drop the routing fields.
+ *
+ * Wire transport lives on `HonuaClient` (`getWmsCapabilities`,
+ * `getWmsMap`, `getWmsFeatureInfo`, `getWmsLegend`); this class is the
+ * typed surface consumers reach through `Source.protocol("wms")`.
+ *
+ * @module
+ */
+import { HonuaCapabilityNotSupportedError } from "./errors.js";
+import { findWmsLayer } from "./wms-capabilities.js";
+/**
+ * Split a WMS `LAYERS=` value (or `locator.typeName` / `spec.layers` of
+ * the same shape) into the list of non-empty trimmed layer tokens. Used
+ * by the contract WMS adapter and shared style resolver so the
+ * single-layer handle rule stays in one place.
+ */
+export function parseWmsLayerNames(value) {
+    if (typeof value !== "string" || value.length === 0)
+        return [];
+    return value
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+/**
+ * Service-level WMS handle. Use `layer(name)` to bind a single LAYER and
+ * style; for multi-layer composites (`LAYERS=a,b,c`) call `map()` /
+ * `featureInfo()` directly on this handle.
+ */
+export class HonuaWms {
+    client;
+    serviceId;
+    capabilitiesPromise;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+    }
+    /** Bind a single named layer for layer-scoped requests. */
+    layer(name, defaultStyleId) {
+        const opts = {
+            client: this.client,
+            serviceId: this.serviceId,
+            layerName: name,
+        };
+        if (defaultStyleId !== undefined)
+            opts.defaultStyleId = defaultStyleId;
+        return new HonuaWmsLayer(opts);
+    }
+    /** Fetch and parse the service `GetCapabilities` document. */
+    async capabilities(options) {
+        return this.client.getWmsCapabilities({
+            serviceId: this.serviceId,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+    }
+    /** Render a `GetMap` request across one or more advertised layers. */
+    async map(request) {
+        return this.client.getWmsMap({ serviceId: this.serviceId, ...request });
+    }
+    /** Issue a `GetFeatureInfo` against one or more advertised layers. */
+    async featureInfo(request) {
+        return this.client.getWmsFeatureInfo({ serviceId: this.serviceId, ...request });
+    }
+    /**
+     * Fetch a `GetLegendGraphic` image. Always gates on parsed Capabilities:
+     * when the caller does not pre-supply `options.capabilities`, the handle
+     * lazily loads them once via `getWmsCapabilities` and caches the
+     * promise on the instance so repeat calls reuse the same fetch. Throws
+     * `HonuaCapabilityNotSupportedError("legend", "wms", serviceId)` when
+     * the service does not advertise `<GetLegendGraphic>`.
+     */
+    async legend(request, options) {
+        const caps = options?.capabilities ?? (await this.loadCachedCapabilities());
+        if (!caps.request.getLegendGraphic) {
+            throw new HonuaCapabilityNotSupportedError("legend", "wms", this.serviceId);
+        }
+        return this.client.getWmsLegend({ serviceId: this.serviceId, ...request });
+    }
+    async loadCachedCapabilities() {
+        if (!this.capabilitiesPromise) {
+            this.capabilitiesPromise = this.capabilities().catch((error) => {
+                // Drop the cached promise on failure so the next call retries
+                // instead of permanently surfacing the same error.
+                this.capabilitiesPromise = undefined;
+                throw error;
+            });
+        }
+        return this.capabilitiesPromise;
+    }
+}
+/**
+ * Bound layer handle. Drops `layers` / `styles` from per-call requests
+ * and pre-fills the LAYER name. `featureInfo()` carries the same `i`,
+ * `j`, and `bbox` envelope as the service-level handle.
+ */
+export class HonuaWmsLayer {
+    client;
+    serviceId;
+    layerName;
+    defaultStyleId;
+    capabilitiesPromise;
+    constructor(options) {
+        this.client = options.client;
+        this.serviceId = options.serviceId;
+        this.layerName = options.layerName;
+        this.defaultStyleId = options.defaultStyleId;
+    }
+    /** Fetch the parent service's `GetCapabilities`. */
+    async capabilities(options) {
+        return this.client.getWmsCapabilities({
+            serviceId: this.serviceId,
+            ...(options?.signal ? { signal: options.signal } : {}),
+        });
+    }
+    /** Find this layer in a parsed Capabilities document. */
+    describe(capabilities) {
+        return findWmsLayer(capabilities, this.layerName);
+    }
+    /** Enumerate the styles advertised on this layer. */
+    stylesIn(capabilities) {
+        return this.describe(capabilities)?.styles ?? [];
+    }
+    async map(request) {
+        const { style, ...rest } = request;
+        const styleId = style ?? this.defaultStyleId;
+        return this.client.getWmsMap({
+            serviceId: this.serviceId,
+            layers: [this.layerName],
+            ...(styleId !== undefined ? { styles: [styleId] } : {}),
+            ...rest,
+        });
+    }
+    async featureInfo(request) {
+        const { style, ...rest } = request;
+        const styleId = style ?? this.defaultStyleId;
+        return this.client.getWmsFeatureInfo({
+            serviceId: this.serviceId,
+            layers: [this.layerName],
+            queryLayers: [this.layerName],
+            ...(styleId !== undefined ? { styles: [styleId] } : {}),
+            ...rest,
+        });
+    }
+    /**
+     * Fetch a `GetLegendGraphic` image scoped to the bound layer + style.
+     * Mirrors `HonuaWms.legend`'s gating: when `options.capabilities` is
+     * not supplied, the handle lazily loads them once via
+     * `getWmsCapabilities` and caches the promise. Throws
+     * `HonuaCapabilityNotSupportedError("legend", "wms", serviceId)` when
+     * the service does not advertise `<GetLegendGraphic>`.
+     */
+    async legend(request = {}, options) {
+        const caps = options?.capabilities ?? (await this.loadCachedCapabilities());
+        if (!caps.request.getLegendGraphic) {
+            throw new HonuaCapabilityNotSupportedError("legend", "wms", this.serviceId);
+        }
+        const { style, ...rest } = request;
+        const styleId = style ?? this.defaultStyleId;
+        return this.client.getWmsLegend({
+            serviceId: this.serviceId,
+            layer: this.layerName,
+            ...(styleId !== undefined ? { style: styleId } : {}),
+            ...rest,
+        });
+    }
+    async loadCachedCapabilities() {
+        if (!this.capabilitiesPromise) {
+            this.capabilitiesPromise = this.capabilities().catch((error) => {
+                this.capabilitiesPromise = undefined;
+                throw error;
+            });
+        }
+        return this.capabilitiesPromise;
+    }
+}
+export function createHonuaWms(client, serviceId) {
+    return new HonuaWms({ client, serviceId });
+}

package/core/wmts-capabilities.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 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
+ */
+/**
+ * Top-level WMTS Capabilities surface.
+ */
+export interface WmtsCapabilities {
+    /** Protocol version. honua-server advertises `1.0.0`. */
+    version: string;
+    service: WmtsCapabilitiesService;
+    layers: ReadonlyArray<WmtsCapabilityLayer>;
+    tileMatrixSets: ReadonlyArray<WmtsCapabilityTileMatrixSet>;
+}
+export interface WmtsCapabilitiesService {
+    title?: string;
+    abstract?: string;
+}
+export interface WmtsCapabilityLayer {
+    identifier: string;
+    title?: string;
+    abstract?: string;
+    formats: readonly string[];
+    styles: ReadonlyArray<WmtsCapabilityStyle>;
+    /** TileMatrixSet identifiers the layer supports. */
+    tileMatrixSetIds: readonly string[];
+    /** RESTful tile templates (xlink:href) advertised by `ResourceURL@resourceType="tile"`. */
+    resourceTemplates: ReadonlyArray<WmtsCapabilityResourceUrl>;
+    /** RESTful FeatureInfo templates advertised by `ResourceURL@resourceType="FeatureInfo"`. */
+    featureInfoTemplates: ReadonlyArray<WmtsCapabilityResourceUrl>;
+    /** Geographic bounding box (WGS84) when advertised. */
+    bbox?: {
+        west: number;
+        south: number;
+        east: number;
+        north: number;
+    };
+}
+export interface WmtsCapabilityStyle {
+    identifier: string;
+    title?: string;
+    isDefault: boolean;
+    legendUrl?: string;
+}
+export interface WmtsCapabilityResourceUrl {
+    format: string;
+    template: string;
+}
+export interface WmtsCapabilityTileMatrixSet {
+    identifier: string;
+    /** CRS supportedCRS or wellKnownScaleSet href when advertised. */
+    supportedCrs?: string;
+    wellKnownScaleSet?: string;
+    matrices: ReadonlyArray<WmtsCapabilityTileMatrix>;
+}
+export interface WmtsCapabilityTileMatrix {
+    identifier: string;
+    scaleDenominator: number;
+    matrixWidth: number;
+    matrixHeight: number;
+    tileWidth: number;
+    tileHeight: number;
+    topLeftCorner: readonly [number, number];
+}
+export declare class HonuaWmtsCapabilitiesParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a `Capabilities` text body for WMTS 1.0 into the typed
+ * `WmtsCapabilities` shape.
+ */
+export declare function parseWmtsCapabilities(xml: string): WmtsCapabilities;
+/** Find a layer by identifier in a parsed `WmtsCapabilities`. */
+export declare function findWmtsLayer(capabilities: WmtsCapabilities, identifier: string): WmtsCapabilityLayer | undefined;
+/** Find a tile-matrix-set by identifier. */
+export declare function findWmtsTileMatrixSet(capabilities: WmtsCapabilities, identifier: string): WmtsCapabilityTileMatrixSet | undefined;
+//# sourceMappingURL=wmts-capabilities.d.ts.map

package/core/wmts-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wmts-capabilities.d.ts","sourceRoot":"","sources":["../../../src/core/wmts-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,cAAc,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,oDAAoD;IACpD,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2FAA2F;IAC3F,iBAAiB,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAC5D,4FAA4F;IAC5F,oBAAoB,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAC/D,uDAAuD;IACvD,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,qBAAa,+BAAgC,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAInC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAcnE;AAwWD,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEjH;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,gBAAgB,EAC9B,UAAU,EAAE,MAAM,GACjB,2BAA2B,GAAG,SAAS,CAEzC"}