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

package/core/wms-capabilities.d.ts

@@ -1,110 +1,82 @@
 /**
- * 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.
+ * Bounded WMS capabilities projection.
  *
- * 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.
+ * The parser accepts the metadata subset needed by discovery and the WMS
+ * runtime, rejects malformed/active XML, and returns plain immutable-friendly
+ * records. Unknown vendor extensions are ignored; required structural drift is
+ * surfaced through {@link HonuaWmsCapabilitiesParseError}.
  *
  * @module
  */
-/**
- * Top-level WMS Capabilities surface.
- */
+import { HonuaSdkError } from "./error-envelope.js";
 export interface WmsCapabilities {
-    /** WMS protocol version. honua-server advertises `1.3.0`. */
-    version: string;
-    service: WmsCapabilitiesService;
-    layers: ReadonlyArray<WmsCapabilityLayer>;
-    formats: WmsCapabilitiesFormats;
-    request: WmsCapabilitiesRequestSupport;
+    readonly version: string;
+    readonly service: WmsCapabilitiesService;
+    readonly layers: ReadonlyArray<WmsCapabilityLayer>;
+    readonly formats: WmsCapabilitiesFormats;
+    readonly request: WmsCapabilitiesRequestSupport;
+    /** Optional metadata entries ignored because they were malformed. */
+    readonly warnings: readonly string[];
 }
 export interface WmsCapabilitiesService {
-    title?: string;
-    abstract?: string;
+    readonly title?: string;
+    readonly abstract?: string;
 }
 export interface WmsCapabilitiesFormats {
-    /** Image MIME types accepted by `GetMap`. */
-    map: readonly string[];
-    /** Info-format MIME types accepted by `GetFeatureInfo`. */
-    featureInfo: readonly string[];
-    /** Image MIME types accepted by `GetLegendGraphic`. */
-    legend: readonly string[];
+    readonly map: readonly string[];
+    readonly featureInfo: readonly string[];
+    readonly legend: readonly string[];
+}
+export type WmsOperationName = "GetCapabilities" | "GetMap" | "GetFeatureInfo" | "GetLegendGraphic";
+export interface WmsCapabilityOperation {
+    readonly name: WmsOperationName;
+    readonly formats: readonly string[];
+    readonly methods: readonly ("GET" | "POST")[];
+    readonly getUrls: readonly string[];
+    readonly postUrls: readonly string[];
 }
 export interface WmsCapabilitiesRequestSupport {
-    /** Capability advertises a `GetFeatureInfo` request element. */
-    getFeatureInfo: boolean;
-    /** Capability advertises a `GetLegendGraphic` request element. */
-    getLegendGraphic: boolean;
+    readonly getMap: boolean;
+    readonly getFeatureInfo: boolean;
+    readonly getLegendGraphic: boolean;
+    readonly operations: readonly WmsCapabilityOperation[];
 }
 export interface WmsCapabilityLayer {
-    name: string;
-    title?: string;
-    abstract?: string;
-    /** CRS codes advertised on this layer (and inherited from ancestors). */
-    crs: readonly string[];
-    /** Bounding boxes per CRS. Multiple entries permitted. */
-    bbox: ReadonlyArray<WmsCapabilityBoundingBox>;
-    /** Styles advertised on this layer. The first entry is the default. */
-    styles: ReadonlyArray<WmsCapabilityStyle>;
-    /** Dimensions (`time`, `elevation`, vendor names). */
-    dimensions: ReadonlyArray<WmsCapabilityDimension>;
-    queryable: boolean;
-    /** Sub-layers nested under this entry. */
-    children: ReadonlyArray<WmsCapabilityLayer>;
+    readonly name: string;
+    readonly title?: string;
+    readonly abstract?: string;
+    readonly crs: readonly string[];
+    readonly bbox: ReadonlyArray<WmsCapabilityBoundingBox>;
+    readonly styles: ReadonlyArray<WmsCapabilityStyle>;
+    readonly dimensions: ReadonlyArray<WmsCapabilityDimension>;
+    readonly queryable: boolean;
+    readonly children: ReadonlyArray<WmsCapabilityLayer>;
 }
 export interface WmsCapabilityBoundingBox {
-    crs: string;
-    minx: number;
-    miny: number;
-    maxx: number;
-    maxy: number;
+    readonly crs: string;
+    readonly minx: number;
+    readonly miny: number;
+    readonly maxx: number;
+    readonly maxy: number;
 }
 export interface WmsCapabilityStyle {
-    name: string;
-    title?: string;
-    /** Externally-served legend URL (`OnlineResource@xlink:href`) when advertised. */
-    legendUrl?: string;
+    readonly name: string;
+    readonly title?: string;
+    readonly legendUrl?: string;
+    readonly legendFormat?: string;
 }
 export interface WmsCapabilityDimension {
-    name: string;
-    units?: string;
-    default?: string;
-    /** Discrete values; for time this is typically a comma-separated list. */
-    values: readonly string[];
+    readonly name: string;
+    readonly units?: string;
+    readonly default?: string;
+    readonly values: readonly string[];
 }
-/**
- * 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 declare class HonuaWmsCapabilitiesParseError extends Error {
-    constructor(message: string);
+export declare class HonuaWmsCapabilitiesParseError extends HonuaSdkError {
+    constructor(message: string, options?: {
+        readonly cause?: unknown;
+    });
 }
-/**
- * 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 declare function parseWmsCapabilities(xml: string): WmsCapabilities;
-/**
- * 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 declare function iterateWmsLayers(capabilities: WmsCapabilities): Generator<WmsCapabilityLayer>;
-/**
- * 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 declare function findWmsLayer(capabilities: WmsCapabilities, name: string): WmsCapabilityLayer | undefined;
 //# sourceMappingURL=wms-capabilities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wms-capabilities.d.ts","sourceRoot":"","sources":["../../../src/core/wms-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC1C,OAAO,EAAE,sBAAsB,CAAC;IAChC,OAAO,EAAE,6BAA6B,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,uDAAuD;IACvD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C,gEAAgE;IAChE,cAAc,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,IAAI,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;IAC9C,uEAAuE;IACvE,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC1C,sDAAsD;IACtD,UAAU,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAInC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAgCjE;AA+dD;;;;;GAKG;AACH,wBAAiB,gBAAgB,CAAC,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAU9F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAKxG"}
+{"version":3,"file":"wms-capabilities.d.ts","sourceRoot":"","sources":["../../../src/core/wms-capabilities.ts"],"names":[],"mappings":"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"}