@honua/react 0.0.20-alpha.0 → 0.1.0-beta.0

package/contract/index.d.ts

@@ -56,6 +56,8 @@ export type { DefineQueryTileSourceOptions, QueryTileCacheIdentityDescriptor, Qu
 export { ALL_CAPABILITIES, FIRST_PARTY_PROTOCOLS, createDataset, geoServicesFeatureSource, geoServicesGPServiceSource, geoServicesGeometryServiceSource, geoServicesImageSource, geoServicesMapServiceSource, odataSource, ogcFeaturesSource, ogcTilesSource, ogcMapsSource, ogcRecordsSource, stacSearchSource, wfsSource, wmsSource, wmtsSource, } from "./source.js";
 export type { IJobRun, JobError, JobProgress, JobResult, JobResultsOptions, JobSnapshot, JobSnapshotListener, JobStatus, } from "./jobs.js";
 export { HonuaJobPollTimeoutError, isJobTerminal } from "./jobs.js";
+export { HonuaPmtilesArchive, describePmtilesArchive, stripPmtilesScheme, toPmtilesSourceUrl } from "./pmtiles.js";
+export type { DescribePmtilesArchiveDeps, PmtilesArchiveDescription, PmtilesArchiveLike, PmtilesHeaderLike, PmtilesModuleLike, PmtilesRangeResponse, PmtilesSourceLike, PmtilesTileKind, PmtilesVectorLayerInfo, } from "./pmtiles.js";
 export { TEMPORAL_CAPABILITY, TEMPORAL_ROUTE_PREFIX, TEMPORAL_ROUTES, TEMPORAL_SCHEMA_VERSION, assertValidTemporalRollbackPlanRequest, createTemporalClient, isReadOnlyTemporalHistory, temporalModeSupports, validateTemporalRollbackPlanRequest, } from "./temporal.js";
 export type { TemporalAsOfRequest, TemporalAttributeChange, TemporalCheckpoint, TemporalChangeSet, TemporalChangeSetOperationKind, TemporalClient, TemporalClientCallOptions, TemporalContractFixture, TemporalCursor, TemporalCursorType, TemporalDiff, TemporalDiffRequest, TemporalDiffStatus, TemporalDiffSummary, TemporalError, TemporalErrorCode, TemporalFeatureChangeType, TemporalFeatureDiff, TemporalFeatureTimeline, TemporalFeatureTimelineRequest, TemporalFilter, TemporalGeometryChange, TemporalHistoryModel, TemporalJobRef, TemporalMode, TemporalRequestClient, TemporalRevision, TemporalRevisionOperation, TemporalRiskLevel, TemporalRollbackExecuteRequest, TemporalRollbackMode, TemporalRollbackOperation, TemporalRollbackPlan, TemporalRollbackPlanRequest, TemporalRollbackScope, TemporalRollbackStatus, TemporalSourceCapability, TemporalValidationIssue, } from "./temporal.js";
 //# sourceMappingURL=index.d.ts.map

package/contract/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contract/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contract/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,YAAY,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,iCAAiC,EACjC,8BAA8B,EAC9B,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EACzB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,OAAO,EACP,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,MAAM,EACN,QAAQ,EACR,MAAM,EACN,2BAA2B,EAC3B,gBAAgB,EAChB,uBAAuB,EACvB,iCAAiC,EACjC,QAAQ,EACR,aAAa,EACb,cAAc,EACd,YAAY,EACZ,kCAAkC,GACnC,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,+BAA+B,EAC/B,gCAAgC,EAChC,qCAAqC,EACrC,+BAA+B,EAC/B,sBAAsB,EACtB,8BAA8B,EAC9B,iCAAiC,EACjC,kCAAkC,EAClC,4BAA4B,EAC5B,6BAA6B,EAC7B,iCAAiC,EACjC,6BAA6B,EAC7B,gCAAgC,EAChC,iCAAiC,EACjC,sCAAsC,EACtC,gCAAgC,EAChC,yBAAyB,EACzB,oCAAoC,EACpC,uCAAuC,EACvC,gCAAgC,EAChC,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,mCAAmC,EACnC,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,oCAAoC,EACpC,gCAAgC,EAChC,kCAAkC,EAClC,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EAClC,4BAA4B,EAC5B,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,uCAAuC,EACvC,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,EAC9B,iCAAiC,EACjC,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EAChC,qCAAqC,GACtC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,YAAY,EACZ,6BAA6B,EAC7B,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,iBAAiB,EACjB,6BAA6B,EAC7B,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,gCAAgC,EAChC,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,iCAAiC,EACjC,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,mBAAmB,EACnB,kCAAkC,EAClC,iCAAiC,EACjC,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,4BAA4B,EAC5B,gCAAgC,EAChC,0BAA0B,EAC1B,8BAA8B,EAC9B,8BAA8B,EAC9B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAC1G,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,eAAe,EACf,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACrF,YAAY,EACV,6BAA6B,EAC7B,iCAAiC,EACjC,8BAA8B,EAC9B,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oDAAoD,EACpD,8BAA8B,EAC9B,2CAA2C,EAC3C,kCAAkC,EAClC,8CAA8C,EAC9C,oCAAoC,EACpC,4BAA4B,EAC5B,sCAAsC,EACtC,0BAA0B,EAC1B,uDAAuD,EACvD,0CAA0C,EAC1C,yBAAyB,EACzB,gDAAgD,EAChD,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,kCAAkC,EAClC,+CAA+C,EAC/C,kCAAkC,EAClC,8BAA8B,EAC9B,uCAAuC,EACvC,yCAAyC,EACzC,qCAAqC,EACrC,sBAAsB,EACtB,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,kCAAkC,EAClC,mCAAmC,EACnC,kBAAkB,EAClB,iCAAiC,EACjC,0CAA0C,EAC1C,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,4BAA4B,EAC5B,gCAAgC,EAChC,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,+BAA+B,EAC/B,kCAAkC,EAClC,8BAA8B,EAC9B,8BAA8B,EAC9B,eAAe,EACf,8BAA8B,EAC9B,aAAa,EACb,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,6BAA6B,EAC7B,eAAe,EACf,oCAAoC,EACpC,8BAA8B,EAC9B,8BAA8B,EAC9B,0BAA0B,EAC1B,8BAA8B,EAC9B,kCAAkC,EAClC,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,wCAAwC,EACxC,8BAA8B,EAC9B,gCAAgC,EAChC,wBAAwB,EACxB,2BAA2B,EAC3B,+BAA+B,EAC/B,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,EAChC,sBAAsB,EACtB,2BAA2B,EAC3B,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,OAAO,EACP,QAAQ,EACR,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACnH,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,sCAAsC,EACtC,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,mCAAmC,GACpC,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,cAAc,EACd,yBAAyB,EACzB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,8BAA8B,EAC9B,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,8BAA8B,EAC9B,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,eAAe,CAAC"}

package/contract/index.js

@@ -48,4 +48,5 @@ export { FEATURE_SERVER_H3_SPATIAL_AGGREGATION_INDEX_MODEL_ID, SPATIAL_AGGREGATI
 export { QUERY_TILE_SERVER_CONTRACT_VERSION, QUERY_TILE_SERVER_FEATURE_DETAIL_ROUTE_TEMPLATE, QUERY_TILE_SERVER_RESPONSE_HEADERS, QUERY_TILE_SERVER_ROUTE_PREFIX, QUERY_TILE_SERVER_SOURCE_ROUTE_TEMPLATE, QUERY_TILE_SERVER_TILEJSON_ROUTE_TEMPLATE, QUERY_TILE_SERVER_TILE_ROUTE_TEMPLATE, buildQueryTileCacheKey, buildQueryTileFeatureDetailQuery, buildQueryTileServerPath, buildQueryTileServerUrl, defineQueryTileSource, loadQueryTileFeatureDetail, mapQueryTileFeatureIdentity, normalizeQueryTileKey, normalizeQueryTileSourceDescriptor, parseQueryTileFeatureDetailResponse, parseQueryTileJson, parseQueryTileServerErrorResponse, queryTileServerRequestParamsFromDescriptor, queryTileKeyString, stableJson, } from "./tiles.js";
 export { ALL_CAPABILITIES, FIRST_PARTY_PROTOCOLS, createDataset, geoServicesFeatureSource, geoServicesGPServiceSource, geoServicesGeometryServiceSource, geoServicesImageSource, geoServicesMapServiceSource, odataSource, ogcFeaturesSource, ogcTilesSource, ogcMapsSource, ogcRecordsSource, stacSearchSource, wfsSource, wmsSource, wmtsSource, } from "./source.js";
 export { HonuaJobPollTimeoutError, isJobTerminal } from "./jobs.js";
+export { HonuaPmtilesArchive, describePmtilesArchive, stripPmtilesScheme, toPmtilesSourceUrl } from "./pmtiles.js";
 export { TEMPORAL_CAPABILITY, TEMPORAL_ROUTE_PREFIX, TEMPORAL_ROUTES, TEMPORAL_SCHEMA_VERSION, assertValidTemporalRollbackPlanRequest, createTemporalClient, isReadOnlyTemporalHistory, temporalModeSupports, validateTemporalRollbackPlanRequest, } from "./temporal.js";

package/contract/pmtiles.d.ts

@@ -0,0 +1,162 @@
+/**
+ * PMTiles archive inspection for the protocol-neutral contract.
+ *
+ * A PMTiles archive is a single, immutable file (on object storage or any
+ * static host) that stores an entire raster or vector tile pyramid. It
+ * participates in the `Dataset` / `Source` model as a **tiles-only** protocol:
+ * the canonical query family throws {@link HonuaCapabilityNotSupportedError}
+ * (there is no feature-query surface on an archive), while archive metadata —
+ * bounds, min/max zoom, and vector layer names — is inspected through
+ * `Source.protocol("pmtiles").describe()`.
+ *
+ * This module never statically imports the `pmtiles` package. The reader is
+ * pulled in lazily (`await import("pmtiles")`) the first time an archive is
+ * actually described, mirroring the Cesium adapter so consumers that never
+ * touch PMTiles pay zero bundle cost. A minimal `pmtiles` module slice is
+ * modelled here so the wiring stays unit-testable against an injected fake
+ * without a network fetch.
+ *
+ * @module
+ */
+/**
+ * Canonical tile-payload kinds a PMTiles archive can store. `mvt` is a vector
+ * archive (Mapbox Vector Tiles); the rest are raster encodings. `unknown`
+ * covers archives whose header tile-type byte the reader could not classify.
+ */
+export type PmtilesTileKind = "mvt" | "png" | "jpeg" | "webp" | "avif" | "unknown";
+/**
+ * One vector layer advertised in a vector archive's TileJSON-style metadata
+ * (`vector_layers`). Present only for `mvt` archives; raster archives report an
+ * empty {@link PmtilesArchiveDescription.vectorLayers} list.
+ */
+export interface PmtilesVectorLayerInfo {
+    /** Layer id — the MapLibre `source-layer` name to reference in a style. */
+    readonly id: string;
+    /** Optional human description carried in the archive metadata. */
+    readonly description?: string;
+    /** Optional per-layer minimum zoom advertised in the metadata. */
+    readonly minZoom?: number;
+    /** Optional per-layer maximum zoom advertised in the metadata. */
+    readonly maxZoom?: number;
+    /** Optional field-name → type map advertised in the metadata. */
+    readonly fields?: Readonly<Record<string, string>>;
+}
+/**
+ * The archive metadata surfaced by {@link describePmtilesArchive}. Bounds are
+ * `[west, south, east, north]` in degrees; `center` is `[lon, lat, zoom]`. The
+ * raw metadata JSON is preserved on `metadata` for callers that need archive
+ * fields beyond the normalized shape.
+ */
+export interface PmtilesArchiveDescription {
+    /** Archive URL the description was read from. */
+    readonly url: string;
+    /** Tile payload kind stored in the archive. */
+    readonly tileKind: PmtilesTileKind;
+    /** Geographic bounds `[west, south, east, north]` in degrees. */
+    readonly bounds: readonly [number, number, number, number];
+    /** Lowest zoom level present in the archive. */
+    readonly minZoom: number;
+    /** Highest zoom level present in the archive. */
+    readonly maxZoom: number;
+    /** Suggested view center `[lon, lat, zoom]`. */
+    readonly center: readonly [number, number, number];
+    /** Vector layer definitions (empty for raster archives). */
+    readonly vectorLayers: readonly PmtilesVectorLayerInfo[];
+    /** Attribution string advertised in the archive metadata, when present. */
+    readonly attribution?: string;
+    /** The raw, parsed archive metadata JSON. */
+    readonly metadata: Readonly<Record<string, unknown>>;
+}
+/** A byte-range response from a {@link PmtilesSourceLike}. */
+export interface PmtilesRangeResponse {
+    readonly data: ArrayBuffer;
+    readonly etag?: string;
+}
+/**
+ * The `pmtiles` `Source` surface — a byte-range reader over the archive. A
+ * remote archive uses the reader's own `FetchSource`; a local fixture (tests)
+ * supplies a buffer-backed implementation.
+ */
+export interface PmtilesSourceLike {
+    getBytes(offset: number, length: number, signal?: AbortSignal, etag?: string): Promise<PmtilesRangeResponse>;
+    getKey(): string;
+}
+/** The `Header` fields this module reads (a subset of `pmtiles.Header`). */
+export interface PmtilesHeaderLike {
+    readonly minZoom: number;
+    readonly maxZoom: number;
+    readonly minLon: number;
+    readonly minLat: number;
+    readonly maxLon: number;
+    readonly maxLat: number;
+    readonly centerZoom: number;
+    readonly centerLon: number;
+    readonly centerLat: number;
+    readonly tileType: number;
+}
+/** The `PMTiles` reader surface this module drives. */
+export interface PmtilesArchiveLike {
+    getHeader(): Promise<PmtilesHeaderLike>;
+    getMetadata(): Promise<unknown>;
+}
+/** The minimal slice of `typeof import("pmtiles")` the describe path needs. */
+export interface PmtilesModuleLike {
+    new (source: PmtilesSourceLike | string): PmtilesArchiveLike;
+}
+/** Injectable dependencies for {@link describePmtilesArchive} (test seams). */
+export interface DescribePmtilesArchiveDeps {
+    /** Override the lazily-imported `pmtiles.PMTiles` constructor. */
+    readonly PMTiles?: PmtilesModuleLike;
+    /** Read from a local/in-memory source instead of fetching `url`. */
+    readonly source?: PmtilesSourceLike;
+}
+/**
+ * Inspect a PMTiles archive and return its normalized metadata (bounds, min/max
+ * zoom, suggested center, and vector layer names). The `pmtiles` reader is
+ * imported lazily on first use.
+ *
+ * Pass {@link DescribePmtilesArchiveDeps.source} to read a local archive (the
+ * unit-test path) or {@link DescribePmtilesArchiveDeps.PMTiles} to inject a fake
+ * reader; both default to fetching `url` through the real reader.
+ *
+ * @example
+ * ```ts
+ * const info = await describePmtilesArchive("https://example.com/basemap.pmtiles");
+ * console.log(info.bounds, info.minZoom, info.maxZoom);
+ * for (const layer of info.vectorLayers) console.log(layer.id);
+ * ```
+ */
+export declare function describePmtilesArchive(url: string, deps?: DescribePmtilesArchiveDeps): Promise<PmtilesArchiveDescription>;
+/**
+ * Typed adapter handle for a PMTiles archive, reachable through
+ * `Source.protocol("pmtiles")`. Provides the archive-metadata inspection
+ * surface ({@link HonuaPmtilesArchive.describe}) that the tiles-only PMTiles
+ * `Source` uses to participate in the Dataset model honestly. The first
+ * `describe()` call is cached so repeated inspection does not re-open the
+ * archive.
+ */
+export declare class HonuaPmtilesArchive {
+    #private;
+    /** The `pmtiles://`-free archive URL this handle inspects. */
+    readonly url: string;
+    constructor(url: string, deps?: DescribePmtilesArchiveDeps);
+    /**
+     * Inspect the archive and return its normalized metadata. Cached after the
+     * first successful call; a failed inspection is not cached so a transient
+     * fetch error can be retried.
+     */
+    describe(): Promise<PmtilesArchiveDescription>;
+}
+/**
+ * Strip a leading `pmtiles://` scheme from an archive URL, if present. MapLibre
+ * style sources address PMTiles archives as `pmtiles://https://…`; the reader
+ * (and this contract's describe path) want the bare archive URL.
+ */
+export declare function stripPmtilesScheme(url: string): string;
+/**
+ * Add the `pmtiles://` scheme to a bare archive URL if it is not already
+ * present. The inverse of {@link stripPmtilesScheme}; use it when composing a
+ * MapLibre source `url` from a plain archive locator.
+ */
+export declare function toPmtilesSourceUrl(url: string): string;
+//# sourceMappingURL=pmtiles.d.ts.map

package/contract/pmtiles.d.ts.map

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

package/contract/pmtiles.js

@@ -0,0 +1,155 @@
+/**
+ * PMTiles archive inspection for the protocol-neutral contract.
+ *
+ * A PMTiles archive is a single, immutable file (on object storage or any
+ * static host) that stores an entire raster or vector tile pyramid. It
+ * participates in the `Dataset` / `Source` model as a **tiles-only** protocol:
+ * the canonical query family throws {@link HonuaCapabilityNotSupportedError}
+ * (there is no feature-query surface on an archive), while archive metadata —
+ * bounds, min/max zoom, and vector layer names — is inspected through
+ * `Source.protocol("pmtiles").describe()`.
+ *
+ * This module never statically imports the `pmtiles` package. The reader is
+ * pulled in lazily (`await import("pmtiles")`) the first time an archive is
+ * actually described, mirroring the Cesium adapter so consumers that never
+ * touch PMTiles pay zero bundle cost. A minimal `pmtiles` module slice is
+ * modelled here so the wiring stays unit-testable against an injected fake
+ * without a network fetch.
+ *
+ * @module
+ */
+/**
+ * Lazily import the `pmtiles` reader. Kept in its own function so the dynamic
+ * `import("pmtiles")` is the only reference to the package in `src/`, which is
+ * what keeps PMTiles out of every bundle that never inspects an archive.
+ */
+async function loadPmtilesCtor() {
+    const mod = (await import("pmtiles"));
+    return mod.PMTiles;
+}
+/**
+ * The `pmtiles` `TileType` enum values (spec v3). Duplicated here as a plain
+ * map so classification does not force a value import of the package.
+ */
+const TILE_KIND_BY_TYPE = {
+    0: "unknown",
+    1: "mvt",
+    2: "png",
+    3: "jpeg",
+    4: "webp",
+    5: "avif",
+};
+function tileKindFromHeader(tileType) {
+    return TILE_KIND_BY_TYPE[tileType] ?? "unknown";
+}
+function readVectorLayers(metadata) {
+    const raw = metadata.vector_layers;
+    if (!Array.isArray(raw))
+        return [];
+    const layers = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const record = entry;
+        const id = record.id;
+        if (typeof id !== "string" || id === "")
+            continue;
+        const info = { id };
+        if (typeof record.description === "string")
+            info.description = record.description;
+        if (typeof record.minzoom === "number")
+            info.minZoom = record.minzoom;
+        if (typeof record.maxzoom === "number")
+            info.maxZoom = record.maxzoom;
+        if (record.fields && typeof record.fields === "object") {
+            info.fields = record.fields;
+        }
+        layers.push(info);
+    }
+    return layers;
+}
+function asMetadataRecord(metadata) {
+    return metadata && typeof metadata === "object" ? metadata : {};
+}
+/**
+ * Inspect a PMTiles archive and return its normalized metadata (bounds, min/max
+ * zoom, suggested center, and vector layer names). The `pmtiles` reader is
+ * imported lazily on first use.
+ *
+ * Pass {@link DescribePmtilesArchiveDeps.source} to read a local archive (the
+ * unit-test path) or {@link DescribePmtilesArchiveDeps.PMTiles} to inject a fake
+ * reader; both default to fetching `url` through the real reader.
+ *
+ * @example
+ * ```ts
+ * const info = await describePmtilesArchive("https://example.com/basemap.pmtiles");
+ * console.log(info.bounds, info.minZoom, info.maxZoom);
+ * for (const layer of info.vectorLayers) console.log(layer.id);
+ * ```
+ */
+export async function describePmtilesArchive(url, deps = {}) {
+    const PMTiles = deps.PMTiles ?? (await loadPmtilesCtor());
+    const archive = deps.source ? new PMTiles(deps.source) : new PMTiles(url);
+    const [header, rawMetadata] = await Promise.all([archive.getHeader(), archive.getMetadata()]);
+    const metadata = asMetadataRecord(rawMetadata);
+    const attribution = typeof metadata.attribution === "string" ? metadata.attribution : undefined;
+    return {
+        url,
+        tileKind: tileKindFromHeader(header.tileType),
+        bounds: [header.minLon, header.minLat, header.maxLon, header.maxLat],
+        minZoom: header.minZoom,
+        maxZoom: header.maxZoom,
+        center: [header.centerLon, header.centerLat, header.centerZoom],
+        vectorLayers: readVectorLayers(metadata),
+        ...(attribution ? { attribution } : {}),
+        metadata,
+    };
+}
+/**
+ * Typed adapter handle for a PMTiles archive, reachable through
+ * `Source.protocol("pmtiles")`. Provides the archive-metadata inspection
+ * surface ({@link HonuaPmtilesArchive.describe}) that the tiles-only PMTiles
+ * `Source` uses to participate in the Dataset model honestly. The first
+ * `describe()` call is cached so repeated inspection does not re-open the
+ * archive.
+ */
+export class HonuaPmtilesArchive {
+    /** The `pmtiles://`-free archive URL this handle inspects. */
+    url;
+    #deps;
+    #description;
+    constructor(url, deps = {}) {
+        this.url = url;
+        this.#deps = deps;
+    }
+    /**
+     * Inspect the archive and return its normalized metadata. Cached after the
+     * first successful call; a failed inspection is not cached so a transient
+     * fetch error can be retried.
+     */
+    describe() {
+        if (!this.#description) {
+            this.#description = describePmtilesArchive(this.url, this.#deps).catch((error) => {
+                this.#description = undefined;
+                throw error;
+            });
+        }
+        return this.#description;
+    }
+}
+/**
+ * Strip a leading `pmtiles://` scheme from an archive URL, if present. MapLibre
+ * style sources address PMTiles archives as `pmtiles://https://…`; the reader
+ * (and this contract's describe path) want the bare archive URL.
+ */
+export function stripPmtilesScheme(url) {
+    return url.startsWith("pmtiles://") ? url.slice("pmtiles://".length) : url;
+}
+/**
+ * Add the `pmtiles://` scheme to a bare archive URL if it is not already
+ * present. The inverse of {@link stripPmtilesScheme}; use it when composing a
+ * MapLibre source `url` from a plain archive locator.
+ */
+export function toPmtilesSourceUrl(url) {
+    return url.startsWith("pmtiles://") ? url : `pmtiles://${url}`;
+}

package/contract/source.d.ts

@@ -23,6 +23,7 @@ import { HonuaFeatureLayer, HonuaGeometryService, HonuaGeoprocessingService, Hon
 import { HonuaWfsFeatureType } from "../core/wfs.js";
 import { HonuaWms, HonuaWmsLayer } from "../core/wms.js";
 import { HonuaWmts, HonuaWmtsLayer, HonuaWmtsTileset } from "../core/wmts.js";
+import { HonuaPmtilesArchive } from "./pmtiles.js";
 import { type Capability, type CapabilityPolicy, type CreateDatasetOptions, type Dataset, type Protocol, type Source, type SourceDescriptor } from "./types.js";
 /**
  * Construct a protocol-neutral `Dataset` over a `HonuaClient`.
@@ -216,6 +217,28 @@ export declare function geoServicesGPServiceSource<T>(descriptor: SourceDescript
  * ```
  */
 export declare function ogcTilesSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Tiles-only Source adapter for a PMTiles archive (`protocol: "pmtiles"`).
+ *
+ * PMTiles archives are immutable single-file tile stores, so the canonical
+ * query family throws `HonuaCapabilityNotSupportedError` (there is no
+ * feature-query surface on an archive). Archive metadata — bounds, min/max
+ * zoom, and vector layer names — is inspected through the typed escape hatch:
+ * `Source.protocol("pmtiles").describe()`. Rendering integrations register the
+ * `pmtiles://` protocol on the map (see `@honua/sdk-js/runtime`) and reference
+ * the archive as a MapLibre source `url`.
+ *
+ * `locator.url` may carry a leading `pmtiles://` scheme (the MapLibre form) or
+ * be a bare archive URL; both resolve to the same archive.
+ *
+ * @example
+ * ```ts
+ * const archive = dataset.source("basemap")!.protocol("pmtiles");
+ * const info = await archive!.describe();
+ * console.log(info.bounds, info.vectorLayers.map((layer) => layer.id));
+ * ```
+ */
+export declare function pmtilesSource<T>(descriptor: SourceDescriptor, _client: HonuaClient, policy: CapabilityPolicy): Source<T>;
 /**
  * Render-only Source adapter for OGC API Maps. Same shape as the Tiles
  * adapter — `Source.protocol("ogc-maps")` exposes the runtime class for
@@ -414,6 +437,7 @@ declare module "./types.js" {
         "wmts-layer": HonuaWmtsLayer;
         "wmts-tileset": HonuaWmtsTileset;
         odata: HonuaOdataEntitySet;
+        pmtiles: HonuaPmtilesArchive;
     }
 }
 /** Sentinel: `Capabilities` set that contains every defined capability. */

package/contract/source.d.ts.map

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

package/contract/source.js

@@ -18,12 +18,14 @@ import { HonuaOgcCollectionMap, HonuaOgcMaps } from "../core/ogc-maps.js";
 import { HonuaOgcRecordCollection } from "../core/ogc-records.js";
 import { HonuaOgcTiles, HonuaOgcTileset } from "../core/ogc-tiles.js";
 import { trimTrailingSlashes } from "../core/path-utils.js";
+import { HonuaStacStaticCatalog } from "../core/stac-static.js";
 import { HonuaStacSearch } from "../core/stac.js";
 import { HonuaFeatureLayer, HonuaGeometryService, HonuaGeoprocessingService, HonuaImageService, HonuaMapLayer, HonuaMapService, HonuaOgcFeatureCollection, HonuaOgcFeatures, } from "../core/surfaces.js";
 import { UNSUPPORTED_FES, compileSpatialFilter, compileWhere, geoJsonGeometryToGml, serializeFes, } from "../core/wfs-filter.js";
 import { HonuaWfs, HonuaWfsFeatureType } from "../core/wfs.js";
 import { HonuaWms, HonuaWmsLayer, parseWmsLayerNames } from "../core/wms.js";
 import { HonuaWmts, HonuaWmtsLayer, HonuaWmtsTileset } from "../core/wmts.js";
+import { HonuaPmtilesArchive, stripPmtilesScheme } from "./pmtiles.js";
 import { CAPABILITIES, PROTOCOL_DEFAULT_CAPABILITIES, } from "./types.js";
 /**
  * Construct a protocol-neutral `Dataset` over a `HonuaClient`.
@@ -161,6 +163,8 @@ function buildBuiltInSource(descriptor, client, policy) {
             return wfsSource(descriptor, client, policy);
         case "odata":
             return odataSource(descriptor, client, policy);
+        case "pmtiles":
+            return pmtilesSource(descriptor, client, policy);
         default:
             return undefined;
     }
@@ -378,8 +382,13 @@ export function geoServicesMapServiceSource(descriptor, client, policy) {
  */
 export function ogcFeaturesSource(descriptor, client, policy) {
     const { collectionId } = requireOgcLocator(descriptor);
-    const collection = new HonuaOgcFeatureCollection({ client, collectionId });
-    const root = new HonuaOgcFeatures({ client });
+    const layoutMode = ogcFeaturesLayoutMode(descriptor.locator.layout);
+    const collection = new HonuaOgcFeatureCollection({
+        client,
+        collectionId,
+        ...(layoutMode ? { layout: layoutMode } : {}),
+    });
+    const root = new HonuaOgcFeatures({ client, ...(layoutMode ? { layout: layoutMode } : {}) });
     const caps = descriptor.capabilities ?? PROTOCOL_DEFAULT_CAPABILITIES["ogc-features"];
     const adapterRegistry = {
         "ogc-features": collection,
@@ -763,6 +772,37 @@ export function ogcTilesSource(descriptor, client, policy) {
     };
     return makeSource(descriptor, caps, policy, adapterRegistry, unsupportedFeatureSurface(descriptor));
 }
+// ── PMTiles archive ───────────────────────────────────────────
+/**
+ * Tiles-only Source adapter for a PMTiles archive (`protocol: "pmtiles"`).
+ *
+ * PMTiles archives are immutable single-file tile stores, so the canonical
+ * query family throws `HonuaCapabilityNotSupportedError` (there is no
+ * feature-query surface on an archive). Archive metadata — bounds, min/max
+ * zoom, and vector layer names — is inspected through the typed escape hatch:
+ * `Source.protocol("pmtiles").describe()`. Rendering integrations register the
+ * `pmtiles://` protocol on the map (see `@honua/sdk-js/runtime`) and reference
+ * the archive as a MapLibre source `url`.
+ *
+ * `locator.url` may carry a leading `pmtiles://` scheme (the MapLibre form) or
+ * be a bare archive URL; both resolve to the same archive.
+ *
+ * @example
+ * ```ts
+ * const archive = dataset.source("basemap")!.protocol("pmtiles");
+ * const info = await archive!.describe();
+ * console.log(info.bounds, info.vectorLayers.map((layer) => layer.id));
+ * ```
+ */
+export function pmtilesSource(descriptor, _client, policy) {
+    const url = stripPmtilesScheme(requirePmtilesLocator(descriptor));
+    const caps = descriptor.capabilities ?? PROTOCOL_DEFAULT_CAPABILITIES.pmtiles;
+    const archive = new HonuaPmtilesArchive(url);
+    const adapterRegistry = {
+        pmtiles: archive,
+    };
+    return makeSource(descriptor, caps, policy, adapterRegistry, unsupportedFeatureSurface(descriptor));
+}
 // ── OGC API Maps ──────────────────────────────────────────────
 /**
  * Render-only Source adapter for OGC API Maps. Same shape as the Tiles
@@ -1074,7 +1114,14 @@ export function wmtsSource(descriptor, client, policy) {
  * ```
  */
 export function stacSearchSource(descriptor, client, policy) {
-    const stac = new HonuaStacSearch({ client });
+    // Endpoint-layout selection. `stac-api` treats `locator.url` as a raw STAC
+    // API root (search / collections mounted directly under it) rather than the
+    // Honua `/stac` facade. `stac-static` reads a static catalog.json tree with
+    // no search endpoint. Omitted / `honua-facade` keeps the `/stac` facade.
+    const layout = descriptor.locator.layout;
+    const stacBasePath = layout === "stac-api" ? "" : undefined;
+    const stac = new HonuaStacSearch({ client, ...(stacBasePath !== undefined ? { basePath: stacBasePath } : {}) });
+    const staticCatalog = layout === "stac-static" ? new HonuaStacStaticCatalog(client, client.serverBaseUrl) : undefined;
     const caps = descriptor.capabilities ?? PROTOCOL_DEFAULT_CAPABILITIES.stac;
     const collectionScope = descriptor.locator.collectionId;
     const adapterRegistry = {
@@ -1087,7 +1134,9 @@ export function stacSearchSource(descriptor, client, policy) {
                 throw new HonuaCapabilityNotSupportedError("queryAggregate", descriptor.protocol, descriptor.id);
             }
             const stacRequest = toStacRequest(request, collectionScope);
-            const response = await stac.search(stacRequest);
+            const response = staticCatalog
+                ? await staticCatalog.search(toStacStaticParams(stacRequest))
+                : await stac.search(stacRequest);
             const features = (response.features ?? []).map((toTypedFeatureFromStac));
             const totalCount = response.numberMatched ?? response.context?.matched;
             const exceededTransferLimit = totalCount !== undefined && features.length < totalCount;
@@ -1100,6 +1149,12 @@ export function stacSearchSource(descriptor, client, policy) {
         async queryAll(request) {
             ensureCapability(descriptor, caps, "query");
             const limit = request?.pagination?.limit;
+            if (staticCatalog) {
+                const response = await staticCatalog.search(toStacStaticParams(toStacRequest(request, collectionScope)));
+                const typed = (response.features ?? []).map((toTypedFeatureFromStac));
+                const { features, exceededTransferLimit } = applyQueryAllLimit(typed, limit);
+                return { features, exceededTransferLimit, totalCount: features.length };
+            }
             const items = await stac.searchAll({
                 ...toStacRequest(request, collectionScope),
                 ...withPagingBounds({}, limit),
@@ -1121,6 +1176,16 @@ export function stacSearchSource(descriptor, client, policy) {
         async *stream(request) {
             ensureCapability(descriptor, caps, "stream");
             const limit = request?.pagination?.limit;
+            if (staticCatalog) {
+                // A static catalog has no server-side paging; yield the whole
+                // filtered set as one page.
+                const response = await staticCatalog.search(toStacStaticParams(toStacRequest(request, collectionScope)));
+                yield {
+                    features: (response.features ?? []).map((toTypedFeatureFromStac)),
+                    exceededTransferLimit: false,
+                };
+                return;
+            }
             const stream = stac.searchStream({
                 ...toStacRequest(request, collectionScope),
                 pageSize: limit !== undefined ? Math.max(1, limit) : undefined,
@@ -1140,10 +1205,12 @@ export function stacSearchSource(descriptor, client, policy) {
             // routes through `withPagingBounds` so the underlying searchAll
             // fetches at most `limit + 1` rows, never a full-catalog scan.
             const limit = request?.pagination?.limit;
-            const items = await stac.searchAll({
-                ...toStacRequest(request, collectionScope),
-                ...withPagingBounds({}, limit),
-            });
+            const items = staticCatalog
+                ? ((await staticCatalog.search(toStacStaticParams(toStacRequest(request, collectionScope)))).features ?? [])
+                : await stac.searchAll({
+                    ...toStacRequest(request, collectionScope),
+                    ...withPagingBounds({}, limit),
+                });
             const ids = [];
             for (const item of items) {
                 if (item.id !== undefined && item.id !== null) {
@@ -2901,6 +2968,20 @@ function requireOgcLocator(descriptor) {
     }
     return { collectionId };
 }
+/**
+ * Map a `SourceLocator.layout` hint onto the OGC API Features endpoint
+ * discovery mode. `undefined` / `honua-facade` keep the fixed facade fast
+ * path; `ogc-api` and `auto` enable spec-driven landing-page discovery.
+ * The STAC-specific modes are not applicable to Features and fall back to
+ * the facade.
+ */
+function ogcFeaturesLayoutMode(layout) {
+    if (layout === "ogc-api")
+        return "ogc-api";
+    if (layout === "auto")
+        return "auto";
+    return undefined;
+}
 function requireOgcRecordsLocator(descriptor) {
     const { collectionId } = descriptor.locator;
     if (collectionId === undefined || collectionId === null || collectionId === "") {
@@ -2908,6 +2989,13 @@ function requireOgcRecordsLocator(descriptor) {
     }
     return { collectionId };
 }
+function requirePmtilesLocator(descriptor) {
+    const { url } = descriptor.locator;
+    if (typeof url !== "string" || url === "") {
+        throw new Error(`createDataset: source "${descriptor.id}" (pmtiles) requires locator.url`);
+    }
+    return url;
+}
 function requireImageServiceLocator(descriptor) {
     const { serviceId } = descriptor.locator;
     if (typeof serviceId !== "string") {
@@ -3110,6 +3198,24 @@ function toStacRequest(request, collectionScope) {
         out.signal = request.signal;
     return out;
 }
+/**
+ * Project a STAC API search request onto the client-side filter params a
+ * static catalog traversal applies (it has no server-side query grammar).
+ */
+function toStacStaticParams(request) {
+    const out = {};
+    if (request.collections && request.collections.length > 0)
+        out.collections = request.collections;
+    if (request.bbox)
+        out.bbox = request.bbox;
+    if (request.datetime !== undefined)
+        out.datetime = request.datetime;
+    if (request.limit !== undefined)
+        out.limit = request.limit;
+    if (request.signal)
+        out.signal = request.signal;
+    return out;
+}
 function toTypedFeatureFromStac(feature) {
     return {
         attributes: (feature.properties ?? {}),
@@ -3799,4 +3905,5 @@ export const FIRST_PARTY_PROTOCOLS = new Set([
     "wfs",
     "wms",
     "wmts",
+    "pmtiles",
 ]);