@honua/react 0.0.20-alpha.0

package/studio/validation.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Unified validation and preview response envelopes shared across every
+ * Studio package family and across the SDK, Console, MCP, and QGIS clients.
+ *
+ * The existing {@link ValidateMapPackageResult} (map family) stays unchanged;
+ * {@link toStudioValidationResponse} and {@link fromMapPackageValidation}
+ * adapt it into the generic {@link StudioPackageValidationResponse} envelope
+ * without renaming or restructuring it. {@link HonuaMapPackageDiagnostic} is
+ * already a structural subtype of {@link StudioPackageDiagnostic}.
+ *
+ * @experimental Not yet covered by the SDK's semver contract — these shapes
+ *   may change in any minor release prior to `1.0.0`.
+ * @module
+ */
+import type { ValidateMapPackageResult } from "../runtime/map-package-validation.js";
+import type { HonuaMapPackage } from "../runtime/map-package.js";
+import type { HonuaStudioPackageFamily } from "./types.js";
+/**
+ * Severity of a single {@link StudioPackageDiagnostic}. Matches the frozen
+ * server / honua-sdk-dotnet `StudioPackageDiagnosticSeverity` enum members
+ * (`info`, `warning`, `error`, `blocker`); the map-package validator emits only
+ * `error`/`warning`, which remain assignable.
+ */
+export type StudioPackageDiagnosticSeverity = "info" | "warning" | "error" | "blocker";
+/**
+ * One diagnostic emitted while validating a Studio package. The shape is a
+ * superset-compatible mirror of `HonuaMapPackageDiagnostic` so the map
+ * validator's output adapts without conversion.
+ *
+ * @experimental
+ */
+export interface StudioPackageDiagnostic {
+    readonly code: string;
+    readonly severity: StudioPackageDiagnosticSeverity;
+    readonly message: string;
+    readonly path?: string;
+    readonly detail?: unknown;
+}
+/**
+ * Generic validation response envelope. Every package family returns the
+ * same `{ valid, diagnostics, pkg? }` shape, so SDK, Console, MCP, and QGIS
+ * clients consume one contract.
+ *
+ * @experimental
+ */
+export interface StudioPackageValidationResponse<T> {
+    readonly valid: boolean;
+    readonly diagnostics: readonly StudioPackageDiagnostic[];
+    readonly pkg?: T;
+}
+/** Reference to a server-rendered preview artifact for a package. */
+export interface StudioPreviewArtifactRef {
+    readonly id?: string;
+    readonly kind?: string;
+    readonly url?: string;
+    readonly mediaType?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * Generic preview response envelope returned when a package is previewed
+ * (composed without publishing). Diagnostics reuse the validation shape.
+ *
+ * @experimental
+ */
+export interface StudioPackagePreviewResponse<T> {
+    readonly packageId?: string;
+    readonly packageFamily?: HonuaStudioPackageFamily | (string & {});
+    readonly pkg?: T;
+    readonly diagnostics?: readonly StudioPackageDiagnostic[];
+    readonly artifacts?: readonly StudioPreviewArtifactRef[];
+    readonly expiresAt?: string;
+    readonly [extra: string]: unknown;
+}
+/**
+ * Loose shape a family-specific validation result must satisfy to be adapted
+ * by {@link toStudioValidationResponse}. Diagnostics carry no index signature
+ * so that results with extra diagnostic fields (e.g. `packageId` on
+ * {@link HonuaMapPackageDiagnostic}) — and results that carry a named package
+ * field alongside `valid`/`diagnostics` — assign without a structural index
+ * signature on the caller's type.
+ */
+interface StudioValidationResultLike {
+    readonly valid: boolean;
+    readonly diagnostics: readonly {
+        readonly code: string;
+        readonly severity: StudioPackageDiagnosticSeverity;
+        readonly message: string;
+        readonly path?: string;
+        readonly detail?: unknown;
+    }[];
+}
+/**
+ * Adapt any family validation result — an object with `valid`, `diagnostics`,
+ * and a named package field — into the unified
+ * {@link StudioPackageValidationResponse}. `pkgKey` names the field holding
+ * the package (e.g. `"mapPackage"`). The package field is loosely typed; for
+ * the map family prefer the fully-typed {@link fromMapPackageValidation}.
+ *
+ * @experimental
+ */
+export declare function toStudioValidationResponse<T>(result: StudioValidationResultLike, pkgKey: string): StudioPackageValidationResponse<T>;
+/**
+ * Fully-typed convenience adapter from the map family's
+ * {@link ValidateMapPackageResult} to a
+ * {@link StudioPackageValidationResponse}. Equivalent to
+ * `toStudioValidationResponse<HonuaMapPackage>(result, "mapPackage")`.
+ *
+ * @experimental
+ */
+export declare function fromMapPackageValidation(result: ValidateMapPackageResult): StudioPackageValidationResponse<HonuaMapPackage>;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/studio/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/studio/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,+BAA+B,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B,CAAC,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,UAAU,0BAA0B;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS;QAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;QACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC3B,EAAE,CAAC;CACL;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,MAAM,GACb,+BAA+B,CAAC,CAAC,CAAC,CAOpC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,+BAA+B,CAAC,eAAe,CAAC,CAElD"}

package/studio/validation.js

@@ -0,0 +1,42 @@
+/**
+ * Unified validation and preview response envelopes shared across every
+ * Studio package family and across the SDK, Console, MCP, and QGIS clients.
+ *
+ * The existing {@link ValidateMapPackageResult} (map family) stays unchanged;
+ * {@link toStudioValidationResponse} and {@link fromMapPackageValidation}
+ * adapt it into the generic {@link StudioPackageValidationResponse} envelope
+ * without renaming or restructuring it. {@link HonuaMapPackageDiagnostic} is
+ * already a structural subtype of {@link StudioPackageDiagnostic}.
+ *
+ * @experimental Not yet covered by the SDK's semver contract — these shapes
+ *   may change in any minor release prior to `1.0.0`.
+ * @module
+ */
+/**
+ * Adapt any family validation result — an object with `valid`, `diagnostics`,
+ * and a named package field — into the unified
+ * {@link StudioPackageValidationResponse}. `pkgKey` names the field holding
+ * the package (e.g. `"mapPackage"`). The package field is loosely typed; for
+ * the map family prefer the fully-typed {@link fromMapPackageValidation}.
+ *
+ * @experimental
+ */
+export function toStudioValidationResponse(result, pkgKey) {
+    const pkg = result[pkgKey];
+    return {
+        valid: result.valid,
+        diagnostics: [...result.diagnostics],
+        ...(pkg === undefined ? {} : { pkg: pkg }),
+    };
+}
+/**
+ * Fully-typed convenience adapter from the map family's
+ * {@link ValidateMapPackageResult} to a
+ * {@link StudioPackageValidationResponse}. Equivalent to
+ * `toStudioValidationResponse<HonuaMapPackage>(result, "mapPackage")`.
+ *
+ * @experimental
+ */
+export function fromMapPackageValidation(result) {
+    return toStudioValidationResponse(result, "mapPackage");
+}

package/style/factory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Style-to-source factory: creates Honua SDK surface instances from a
+ * HonuaStyleSpecification's source definitions.
+ *
+ * @module
+ */
+import type { HonuaClient } from "../core/client.js";
+import { HonuaFeatureLayer, HonuaMapService, type HonuaOgcFeatureCollection } from "../core/surfaces.js";
+import type { HonuaWms, HonuaWmsLayer } from "../core/wms.js";
+import type { HonuaWmts, HonuaWmtsTileset } from "../core/wmts.js";
+import type { HonuaStyleSpecification } from "./specification.js";
+/** A resolved Honua source: either a surface instance or `null` for non-Honua (MapLibre-native) sources. */
+export type ResolvedSource = HonuaFeatureLayer | HonuaMapService | HonuaOgcFeatureCollection | HonuaWms | HonuaWmsLayer | HonuaWmts | HonuaWmtsTileset | null;
+/**
+ * Create Honua SDK surface instances for each source in a style.
+ *
+ * Non-Honua sources (e.g. `vector`, `raster`, `geojson`) are mapped to `null` —
+ * these should be handled directly by MapLibre's built-in source types.
+ *
+ * @example
+ * ```ts
+ * const sources = createSources(client, style);
+ * const parcels = sources.get("parcels"); // HonuaFeatureLayer
+ * if (parcels instanceof HonuaFeatureLayer) {
+ *   const features = await parcels.queryFeatures({ where: "status = 'active'" });
+ * }
+ * ```
+ */
+export declare function createSources(client: HonuaClient, style: HonuaStyleSpecification): Map<string, ResolvedSource>;
+//# sourceMappingURL=factory.d.ts.map

package/style/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/style/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,yBAAyB,EAE/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAWlE,4GAA4G;AAC5G,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,eAAe,GACf,yBAAyB,GACzB,QAAQ,GACR,aAAa,GACb,SAAS,GACT,gBAAgB,GAChB,IAAI,CAAC;AAET;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAsC9G"}

package/style/factory.js

@@ -0,0 +1,61 @@
+/**
+ * Style-to-source factory: creates Honua SDK surface instances from a
+ * HonuaStyleSpecification's source definitions.
+ *
+ * @module
+ */
+import { HonuaFeatureLayer, HonuaMapService, HonuaOgcFeatures, } from "../core/surfaces.js";
+import { parseFeatureLayerUrl, parseMapServiceUrl } from "../esri-compat/url.js";
+import { isFeatureServiceSource, isMapServiceSource, isOgcFeaturesSource, isWmsSource, isWmtsSource, parseOgcFeaturesUrl, } from "./specification.js";
+import { resolveWmsSpec, resolveWmtsSpec } from "./wms-wmts-resolvers.js";
+/**
+ * Create Honua SDK surface instances for each source in a style.
+ *
+ * Non-Honua sources (e.g. `vector`, `raster`, `geojson`) are mapped to `null` —
+ * these should be handled directly by MapLibre's built-in source types.
+ *
+ * @example
+ * ```ts
+ * const sources = createSources(client, style);
+ * const parcels = sources.get("parcels"); // HonuaFeatureLayer
+ * if (parcels instanceof HonuaFeatureLayer) {
+ *   const features = await parcels.queryFeatures({ where: "status = 'active'" });
+ * }
+ * ```
+ */
+export function createSources(client, style) {
+    const result = new Map();
+    for (const [name, spec] of Object.entries(style.sources)) {
+        if (isFeatureServiceSource(spec)) {
+            const parsed = parseFeatureLayerUrl(spec.url);
+            result.set(name, new HonuaFeatureLayer({
+                client,
+                serviceId: parsed.serviceId,
+                layerId: parsed.layerId,
+            }));
+        }
+        else if (isMapServiceSource(spec)) {
+            const parsed = parseMapServiceUrl(spec.url);
+            result.set(name, new HonuaMapService({
+                client,
+                serviceId: parsed.serviceId,
+            }));
+        }
+        else if (isOgcFeaturesSource(spec)) {
+            const parsed = parseOgcFeaturesUrl(spec.url);
+            const ogcRoot = new HonuaOgcFeatures({ client });
+            const collectionId = spec.collectionId ?? parsed.collectionId ?? "";
+            result.set(name, ogcRoot.collection(collectionId));
+        }
+        else if (isWmsSource(spec)) {
+            result.set(name, resolveWmsSpec(client, spec));
+        }
+        else if (isWmtsSource(spec)) {
+            result.set(name, resolveWmtsSpec(client, spec));
+        }
+        else {
+            result.set(name, null);
+        }
+    }
+    return result;
+}

package/style/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `@honua/sdk-js/style` — Honua style spec source parsers and validators.
+ *
+ * Translate `Source`/`SourceDescriptor` shapes to and from MapLibre-style
+ * source specifications, and validate Honua style documents.
+ *
+ * @example
+ * ```ts
+ * import { createSources, validateHonuaStyle, parseOgcFeaturesUrl } from "@honua/sdk-js/style";
+ *
+ * const sources = createSources(dataset.sourceDescriptors);
+ * const errors = validateHonuaStyle(myStyle);
+ * if (errors.length) throw new Error(errors.map(e => e.message).join("\n"));
+ *
+ * const parsed = parseOgcFeaturesUrl("https://example.com/ogc/collections/parcels/items");
+ * console.log(parsed.collectionId); // "parcels"
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { isHonuaSource, isFeatureServiceSource, isMapServiceSource, isOgcFeaturesSource, isWmsSource, isWmtsSource, parseOgcFeaturesUrl, validateHonuaStyle, } from "./specification.js";
+export type { HonuaSourceBase, HonuaFeatureServiceSourceSpecification, HonuaMapServiceSourceSpecification, HonuaOgcFeaturesSourceSpecification, HonuaWmsSourceSpecification, HonuaWmtsSourceSpecification, HonuaSourceSpecification, HonuaLayerSpecification, HonuaStyleSpecification, ParsedOgcFeaturesUrl, StyleValidationError, } from "./specification.js";
+export { createSources } from "./factory.js";
+export type { ResolvedSource } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

package/style/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/style/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,sCAAsC,EACtC,kCAAkC,EAClC,mCAAmC,EACnC,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/style/index.js

@@ -0,0 +1,24 @@
+/**
+ * `@honua/sdk-js/style` — Honua style spec source parsers and validators.
+ *
+ * Translate `Source`/`SourceDescriptor` shapes to and from MapLibre-style
+ * source specifications, and validate Honua style documents.
+ *
+ * @example
+ * ```ts
+ * import { createSources, validateHonuaStyle, parseOgcFeaturesUrl } from "@honua/sdk-js/style";
+ *
+ * const sources = createSources(dataset.sourceDescriptors);
+ * const errors = validateHonuaStyle(myStyle);
+ * if (errors.length) throw new Error(errors.map(e => e.message).join("\n"));
+ *
+ * const parsed = parseOgcFeaturesUrl("https://example.com/ogc/collections/parcels/items");
+ * console.log(parsed.collectionId); // "parcels"
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { isHonuaSource, isFeatureServiceSource, isMapServiceSource, isOgcFeaturesSource, isWmsSource, isWmtsSource, parseOgcFeaturesUrl, validateHonuaStyle, } from "./specification.js";
+export { createSources } from "./factory.js";
+// Feature Service and Map Service URL parsers are exported from
+// esri-compat/url.ts via the main index.ts barrel — no re-export needed here.

package/style/specification.d.ts

@@ -0,0 +1,203 @@
+/**
+ * HonuaMapSpec — Honua-specific source type definitions extending MapLibre Style Spec v8.
+ *
+ * Defines three custom source types (`honua-feature-service`, `honua-map-service`,
+ * `honua-ogc-features`) and a `HonuaStyleSpecification` that widens the MapLibre
+ * style's `sources` map to accept them. Standard MapLibre layer types, paint/layout
+ * properties, and expressions are used unchanged.
+ *
+ * These types are standalone (zero dependency on `maplibre-gl` or
+ * `@maplibre/maplibre-gl-style-spec`), but structurally compatible — a
+ * `HonuaStyleSpecification` can be narrowed to `StyleSpecification` by filtering
+ * out Honua sources.
+ *
+ * @module
+ */
+/** Common fields shared by all Honua source specifications. */
+export interface HonuaSourceBase {
+    /** Full URL to the service endpoint. */
+    url: string;
+    /** Attribution string displayed on the map. */
+    attribution?: string;
+}
+/**
+ * A source backed by an Esri-compatible Feature Service layer.
+ *
+ * URL format: `https://host/rest/services/{serviceId}/FeatureServer/{layerId}`
+ */
+export interface HonuaFeatureServiceSourceSpecification extends HonuaSourceBase {
+    type: "honua-feature-service";
+    /** Server-side WHERE clause applied to all queries. */
+    definitionExpression?: string;
+    /** Fields to include in query responses. Defaults to all (`["*"]`). */
+    outFields?: string[];
+    /** Whether queries return geometry. Defaults to `true`. */
+    returnGeometry?: boolean;
+    /** Output spatial reference WKID (e.g. `4326`, `3857`). */
+    outSR?: number;
+}
+/**
+ * A source backed by an Esri-compatible Map Service (dynamic map export).
+ *
+ * URL format: `https://host/rest/services/{serviceId}/MapServer`
+ */
+export interface HonuaMapServiceSourceSpecification extends HonuaSourceBase {
+    type: "honua-map-service";
+    /** Comma-separated layer IDs to include (e.g. `"0,1,3"`). */
+    layers?: string;
+    /** Export DPI. Defaults to `96`. */
+    dpi?: number;
+    /** Image format. */
+    format?: "png" | "png24" | "png32" | "jpg" | "gif";
+    /** Whether the exported image has a transparent background. */
+    transparent?: boolean;
+}
+/**
+ * A source backed by an OGC API Features collection.
+ *
+ * URL format: `https://host/ogc/collections/{collectionId}` or
+ * `https://host/ogc` (with `collectionId` specified separately).
+ */
+export interface HonuaOgcFeaturesSourceSpecification extends HonuaSourceBase {
+    type: "honua-ogc-features";
+    /** The OGC collection identifier. Required if the URL does not include it. */
+    collectionId?: string;
+    /** Coordinate reference system URI (e.g. `"http://www.opengis.net/def/crs/OGC/1.3/CRS84"`). */
+    crs?: string;
+    /** CQL2 filter expression applied server-side. */
+    filter?: string;
+    /** Maximum items per request page. */
+    limit?: number;
+}
+/**
+ * A source backed by a first-party WMS 1.3.0 service.
+ *
+ * URL format: `https://host/rest/services/{serviceId}/MapServer/WMS`.
+ */
+export interface HonuaWmsSourceSpecification extends HonuaSourceBase {
+    type: "honua-wms";
+    /** Service identifier, when not parseable from the URL. */
+    serviceId?: string;
+    /** Comma-separated layer names (the WMS `LAYERS=` value). */
+    layers?: string;
+    /** Comma-separated style names (the WMS `STYLES=` value). */
+    styles?: string;
+    /** Image MIME type. Defaults to `image/png`. */
+    format?: string;
+    /** Whether the rendered image should be transparent. */
+    transparent?: boolean;
+    /** CRS code. Defaults to `EPSG:3857`. */
+    crs?: string;
+}
+/**
+ * A source backed by a first-party WMTS 1.0.0 service.
+ *
+ * URL format: `https://host/rest/services/{serviceId}/MapServer/WMTS`.
+ */
+export interface HonuaWmtsSourceSpecification extends HonuaSourceBase {
+    type: "honua-wmts";
+    /** Service identifier, when not parseable from the URL. */
+    serviceId?: string;
+    /** Layer identifier. */
+    layer?: string;
+    /** Style identifier. Defaults to `default`. */
+    style?: string;
+    /** TileMatrixSet identifier. Defaults to `WebMercatorQuad`. */
+    tileMatrixSet?: string;
+    /** Image MIME type. Defaults to `image/png`. */
+    format?: string;
+}
+/** Union of all Honua custom source types. */
+export type HonuaSourceSpecification = HonuaFeatureServiceSourceSpecification | HonuaMapServiceSourceSpecification | HonuaOgcFeaturesSourceSpecification | HonuaWmsSourceSpecification | HonuaWmtsSourceSpecification;
+/** Minimal layer shape compatible with MapLibre Style Spec v8. */
+export interface HonuaLayerSpecification {
+    id: string;
+    type: string;
+    source?: string;
+    "source-layer"?: string;
+    filter?: unknown;
+    layout?: Record<string, unknown>;
+    paint?: Record<string, unknown>;
+    minzoom?: number;
+    maxzoom?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A MapLibre Style Spec v8 document extended with Honua custom source types.
+ *
+ * Standard MapLibre sources (`vector`, `raster`, `geojson`, etc.) are accepted
+ * alongside Honua sources. Layer definitions use standard MapLibre types.
+ */
+export interface HonuaStyleSpecification {
+    version: 8;
+    name?: string;
+    metadata?: Record<string, unknown>;
+    center?: [number, number];
+    zoom?: number;
+    bearing?: number;
+    pitch?: number;
+    sources: Record<string, HonuaSourceSpecification | {
+        type: string;
+        [key: string]: unknown;
+    }>;
+    layers: HonuaLayerSpecification[];
+    sprite?: string | {
+        id: string;
+        url: string;
+    }[];
+    glyphs?: string;
+    transition?: {
+        duration?: number;
+        delay?: number;
+    };
+}
+/** Test whether a source specification is any Honua custom type. */
+export declare function isHonuaSource(source: {
+    type: string;
+}): source is HonuaSourceSpecification;
+/** Test whether a source is a `honua-feature-service`. */
+export declare function isFeatureServiceSource(source: {
+    type: string;
+}): source is HonuaFeatureServiceSourceSpecification;
+/** Test whether a source is a `honua-map-service`. */
+export declare function isMapServiceSource(source: {
+    type: string;
+}): source is HonuaMapServiceSourceSpecification;
+/** Test whether a source is a `honua-ogc-features`. */
+export declare function isOgcFeaturesSource(source: {
+    type: string;
+}): source is HonuaOgcFeaturesSourceSpecification;
+/** Test whether a source is a `honua-wms`. */
+export declare function isWmsSource(source: {
+    type: string;
+}): source is HonuaWmsSourceSpecification;
+/** Test whether a source is a `honua-wmts`. */
+export declare function isWmtsSource(source: {
+    type: string;
+}): source is HonuaWmtsSourceSpecification;
+/** Parsed components of an OGC Features URL. */
+export interface ParsedOgcFeaturesUrl {
+    baseUrl: string;
+    collectionId: string | undefined;
+}
+/**
+ * Parse an OGC Features URL into baseUrl and optional collectionId.
+ *
+ * Accepts URLs like:
+ * - `https://gis.example.com/ogc/collections/admin-boundaries`
+ * - `https://gis.example.com/ogc` (collectionId provided separately)
+ */
+export declare function parseOgcFeaturesUrl(url: string): ParsedOgcFeaturesUrl;
+/** A validation error found in a HonuaStyleSpecification. */
+export interface StyleValidationError {
+    path: string;
+    message: string;
+}
+/**
+ * Validate a HonuaStyleSpecification for structural correctness.
+ *
+ * Returns an empty array if the style is valid. Does not validate MapLibre
+ * layer/expression semantics — use `@maplibre/maplibre-gl-style-spec` for that.
+ */
+export declare function validateHonuaStyle(style: unknown): StyleValidationError[];
+//# sourceMappingURL=specification.d.ts.map

package/style/specification.d.ts.map

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