@honua/app-platform 0.0.20-alpha.0

package/runtime/pmtiles-protocol.js

@@ -0,0 +1,120 @@
+/**
+ * Auto-registration of the MapLibre `pmtiles://` protocol.
+ *
+ * MapLibre GL JS resolves a source `url` of `pmtiles://https://…` by calling a
+ * protocol handler registered through `maplibregl.addProtocol("pmtiles", …)`.
+ * The `pmtiles` package supplies that handler via its `Protocol` class. This
+ * module wires the two together **lazily and idempotently**: the `pmtiles` and
+ * `maplibre-gl` packages are only pulled in (`await import(...)`) the first time
+ * a PMTiles-backed map is loaded, and registration happens exactly once no
+ * matter how many maps attach (MapLibre's protocol registry is process-global,
+ * and the `pmtiles.Protocol` instance caches every archive it opens).
+ *
+ * `loadMapPackage` calls {@link ensurePmtilesProtocol} before `map.setStyle`
+ * whenever the composed style references a `pmtiles://` source, so consumers get
+ * PMTiles rendering out-of-the-box with no manual `addProtocol` wiring. Adding a
+ * PMTiles source to a live map through `runtime.addSource` is synchronous — call
+ * {@link ensurePmtilesProtocol} yourself beforehand in that case.
+ *
+ * The `maplibre-gl` / `pmtiles` slices are injectable so the wiring is
+ * unit-testable without either real package.
+ *
+ * @module
+ */
+/** The default MapLibre protocol scheme PMTiles archives are addressed under. */
+export const PMTILES_PROTOCOL_SCHEME = "pmtiles";
+let registration;
+let inFlight;
+/**
+ * Resolve the MapLibre `addProtocol` registrar from the lazily-imported module.
+ * MapLibre exposes it both as a named ESM export and off the default namespace;
+ * accept either so this works against any v5 packaging.
+ */
+async function loadMaplibreRegistrar() {
+    const mod = (await import("maplibre-gl"));
+    if (typeof mod.addProtocol === "function") {
+        return { addProtocol: mod.addProtocol, removeProtocol: mod.removeProtocol };
+    }
+    if (mod.default && typeof mod.default.addProtocol === "function") {
+        return mod.default;
+    }
+    throw new Error("maplibre-gl does not expose addProtocol(); ensure maplibre-gl >= 2 is installed.");
+}
+async function loadPmtilesModule() {
+    return (await import("pmtiles"));
+}
+/**
+ * Register the `pmtiles://` protocol on MapLibre if it has not been registered
+ * already. Idempotent: repeated calls (including from multiple maps loading
+ * concurrently) share a single registration and a single in-flight import.
+ *
+ * Returns once the protocol is registered so callers can `await` it before
+ * handing a `pmtiles://`-referencing style to `map.setStyle`.
+ */
+export async function ensurePmtilesProtocol(deps = {}) {
+    const scheme = deps.scheme ?? PMTILES_PROTOCOL_SCHEME;
+    if (registration && registration.scheme === scheme)
+        return;
+    if (inFlight)
+        return inFlight;
+    inFlight = (async () => {
+        const registrar = deps.maplibre ?? (await loadMaplibreRegistrar());
+        const pmtilesModule = deps.pmtilesModule ?? (await loadPmtilesModule());
+        // `metadata: true` lets MapLibre auto-populate source attribution and the
+        // inspect surface from the archive header without a second wiring step.
+        const protocol = new pmtilesModule.Protocol({ metadata: true });
+        registrar.addProtocol(scheme, protocol.tile);
+        registration = { scheme, registrar, protocol };
+    })();
+    try {
+        await inFlight;
+    }
+    finally {
+        inFlight = undefined;
+    }
+}
+/** Whether the `pmtiles://` protocol (or `scheme`) is currently registered. */
+export function isPmtilesProtocolRegistered(scheme = PMTILES_PROTOCOL_SCHEME) {
+    return registration?.scheme === scheme;
+}
+/**
+ * Tear down a prior {@link ensurePmtilesProtocol} registration. Primarily a test
+ * seam so the module-global registration does not leak between cases; also
+ * useful if a host wants to fully release the protocol. Best-effort — a
+ * registrar without `removeProtocol` just clears the local record.
+ */
+export function resetPmtilesProtocol() {
+    if (registration) {
+        registration.registrar.removeProtocol?.(registration.scheme);
+        registration = undefined;
+    }
+    inFlight = undefined;
+}
+function sourceReferencesPmtiles(source, scheme) {
+    if (!source || typeof source !== "object")
+        return false;
+    const prefix = `${scheme}://`;
+    const url = source.url;
+    if (typeof url === "string" && url.startsWith(prefix))
+        return true;
+    const tiles = source.tiles;
+    if (Array.isArray(tiles) && tiles.some((tile) => typeof tile === "string" && tile.startsWith(prefix))) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Whether a composed MapLibre style references at least one `pmtiles://` source.
+ * Used by `loadMapPackage` to decide whether the protocol must be registered
+ * before `map.setStyle`.
+ */
+export function styleUsesPmtiles(style, scheme = PMTILES_PROTOCOL_SCHEME) {
+    const sources = style?.sources;
+    if (!sources)
+        return false;
+    for (const source of Object.values(sources)) {
+        if (sourceReferencesPmtiles(source, scheme))
+            return true;
+    }
+    return false;
+}

package/runtime/popups.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Popup bindings. The runtime wires `MapPackage.popupBindings[]` into
+ * MapLibre `click` handlers using a duck-typed map interface (no runtime
+ * dependency on `maplibre-gl`). The default DOM renderer is intentionally
+ * unstyled — `#29` operator components replace it with richer popup UIs.
+ *
+ * @module
+ */
+import type { MapEventTarget } from "../interactions/feature-state.js";
+import type { HonuaMapPackagePopupBinding } from "./map-package.js";
+/**
+ * Minimal subset of `maplibre-gl.Popup` needed to open a popup at
+ * click coordinates. Any object implementing these methods works.
+ */
+export interface PopupHandle {
+    setLngLat(coord: [number, number]): this;
+    setDOMContent(node: Node): this;
+    setHTML(html: string): this;
+    addTo(map: unknown): this;
+    remove(): void;
+}
+/** Factory a host supplies so the runtime never imports `maplibre-gl` directly. */
+export type PopupFactory = () => PopupHandle;
+/** Custom popup renderer that receives the click event features. */
+export type PopupRenderer = (context: PopupRenderContext) => Node | string | undefined;
+export interface PopupRenderContext {
+    binding: HonuaMapPackagePopupBinding;
+    features: ReadonlyArray<PopupFeature>;
+    lngLat: [number, number];
+}
+export interface PopupFeature {
+    id?: string | number;
+    properties?: Record<string, unknown>;
+    geometry?: unknown;
+}
+export interface BindPopupOptions {
+    binding: HonuaMapPackagePopupBinding;
+    /** MapLibre layer id to listen to for clicks. */
+    layerId: string;
+    /** Create a new popup handle (usually `new maplibregl.Popup()`). */
+    popupFactory: PopupFactory;
+    /** Custom renderer; defaults to unstyled key/value list. */
+    render?: PopupRenderer;
+}
+/** Handle returned by {@link bindPopup} — call `remove()` on teardown. */
+export interface PopupBindingHandle {
+    remove(): void;
+    readonly layerId: string;
+}
+/**
+ * Subscribe to `click` events on `layerId` and render a popup at the
+ * click point. Assumes the host passes a map that matches `MapEventTarget`
+ * (all MapLibre `Map` instances do).
+ */
+export declare function bindPopup(map: MapEventTarget & {}, options: BindPopupOptions): PopupBindingHandle;
+/**
+ * Default renderer: an unstyled `<dl>` list of `binding.fieldName` (when
+ * set) or all properties on the first feature. Use a custom renderer for
+ * anything production-quality.
+ */
+export declare function defaultPopupRenderer(context: PopupRenderContext): Node | undefined;
+//# sourceMappingURL=popups.d.ts.map

package/runtime/popups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popups.d.ts","sourceRoot":"","sources":["../../../src/runtime/popups.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACzC,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC;AAE7C,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,2BAA2B,CAAC;IACrC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,2BAA2B,CAAC;IACrC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,YAAY,EAAE,YAAY,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,GAAG,EAErB,EACD,OAAO,EAAE,gBAAgB,GACxB,kBAAkB,CAkCpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAoClF"}

package/runtime/popups.js

@@ -0,0 +1,95 @@
+/**
+ * Popup bindings. The runtime wires `MapPackage.popupBindings[]` into
+ * MapLibre `click` handlers using a duck-typed map interface (no runtime
+ * dependency on `maplibre-gl`). The default DOM renderer is intentionally
+ * unstyled — `#29` operator components replace it with richer popup UIs.
+ *
+ * @module
+ */
+/**
+ * Subscribe to `click` events on `layerId` and render a popup at the
+ * click point. Assumes the host passes a map that matches `MapEventTarget`
+ * (all MapLibre `Map` instances do).
+ */
+export function bindPopup(map, options) {
+    const { binding, layerId, popupFactory, render = defaultPopupRenderer } = options;
+    let current;
+    function onClick(...args) {
+        const event = args[0];
+        if (!event?.lngLat || !event.features || event.features.length === 0)
+            return;
+        const lngLat = [event.lngLat.lng, event.lngLat.lat];
+        const rendered = render({ binding, features: event.features, lngLat });
+        if (!rendered)
+            return;
+        current?.remove();
+        current = popupFactory().setLngLat(lngLat);
+        if (typeof rendered === "string")
+            current.setHTML(rendered);
+        else
+            current.setDOMContent(rendered);
+        current.addTo(map);
+    }
+    map.on("click", layerId, onClick);
+    return {
+        layerId,
+        remove() {
+            current?.remove();
+            current = undefined;
+            map.off("click", layerId, onClick);
+        },
+    };
+}
+/**
+ * Default renderer: an unstyled `<dl>` list of `binding.fieldName` (when
+ * set) or all properties on the first feature. Use a custom renderer for
+ * anything production-quality.
+ */
+export function defaultPopupRenderer(context) {
+    const doc = resolveDocument();
+    if (!doc)
+        return undefined;
+    const root = doc.createElement("div");
+    if (context.binding.title) {
+        const title = doc.createElement("h3");
+        title.textContent = context.binding.title;
+        root.appendChild(title);
+    }
+    const feature = context.features[0];
+    if (!feature || !feature.properties)
+        return root;
+    if (context.binding.template) {
+        const body = doc.createElement("div");
+        body.textContent = renderStringTemplate(context.binding.template, feature.properties);
+        root.appendChild(body);
+        return root;
+    }
+    const fields = context.binding.fieldName
+        ? [context.binding.fieldName].filter((f) => Object.hasOwn(feature.properties ?? {}, f))
+        : Object.keys(feature.properties);
+    const dl = doc.createElement("dl");
+    for (const field of fields) {
+        const dt = doc.createElement("dt");
+        dt.textContent = field;
+        const dd = doc.createElement("dd");
+        dd.textContent = String(feature.properties[field]);
+        dl.appendChild(dt);
+        dl.appendChild(dd);
+    }
+    root.appendChild(dl);
+    return root;
+}
+function renderStringTemplate(template, properties) {
+    // [^{}] (not [^}]) keeps candidate matches non-overlapping so the scan stays
+    // linear on adversarial input like "{{{{…" (CodeQL js/polynomial-redos), and
+    // stops a stray "{" from being swallowed into the preceding placeholder key.
+    return template.replace(/\{([^{}]+)\}/g, (_, key) => {
+        const value = properties[key];
+        return value === undefined || value === null ? "" : String(value);
+    });
+}
+function resolveDocument() {
+    if (typeof document !== "undefined")
+        return document;
+    return undefined;
+}

package/runtime/query-tiles.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Runtime helpers for query-backed vector tile sources.
+ *
+ * This module is MapLibre-shaped but does not import `maplibre-gl`.
+ * Callers can use the pure source-spec helpers, or the request controller
+ * when they need explicit viewport/tile lifecycle management outside
+ * MapLibre's built-in source loader.
+ *
+ * @module
+ */
+import { type QueryTileCacheKeyOptions, type QueryTileCachePolicy, type QueryTileEndpointDescriptor, type QueryTileFeatureDetailResponse, type QueryTileFeatureIdentityTarget, type QueryTileJson, type QueryTileKey, type QueryTileKeyInput, type QueryTileServerCacheValidators, type QueryTileServerDegradation, type QueryTileServerErrorResponse, type QueryTileServerRequestParameters, type QueryTileSourceDescriptor } from "../contract/tiles.js";
+import type { Capability, Protocol } from "../contract/types.js";
+export interface MapLibreQueryTileSourceSpec {
+    type: "vector";
+    tiles?: string[];
+    url?: string;
+    scheme?: "xyz" | "tms";
+    tileSize?: number;
+    minzoom?: number;
+    maxzoom?: number;
+    bounds?: readonly [number, number, number, number];
+    attribution?: string;
+    promoteId?: string | Readonly<Record<string, string>>;
+    volatile?: boolean;
+}
+export interface QueryTileUrlTemplateOptions {
+    endpoint?: QueryTileEndpointDescriptor;
+    cache?: QueryTileCacheKeyOptions["cache"];
+    includeCacheKey?: boolean;
+    extraParams?: Readonly<Record<string, string | number | boolean | undefined>>;
+}
+export interface QueryTileSourceSpecOptions extends QueryTileUrlTemplateOptions {
+    useTileJsonUrl?: boolean;
+    volatile?: boolean;
+}
+export type QueryTileServerFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface QueryTileServerFetchOptions {
+    fetch?: QueryTileServerFetch;
+    headers?: HeadersInit;
+    signal?: AbortSignal;
+    credentials?: RequestCredentials;
+    validators?: QueryTileServerCacheValidators;
+}
+export interface FetchQueryTileJsonOptions extends QueryTileUrlTemplateOptions, QueryTileServerFetchOptions {
+    url?: string;
+    routePrefix?: string;
+    params?: QueryTileServerRequestParameters;
+}
+export interface FetchQueryTileFeatureDetailOptions extends QueryTileServerFetchOptions {
+    url?: string;
+    routePrefix?: string;
+    params?: QueryTileServerRequestParameters;
+    extraParams?: Readonly<Record<string, string | number | boolean | undefined>>;
+}
+export interface QueryTileJsonFetchResult {
+    url: string;
+    status: number;
+    notModified: boolean;
+    validators: QueryTileServerCacheValidators;
+    tilejson?: QueryTileJson;
+    degraded?: readonly QueryTileServerDegradation[];
+}
+export interface QueryTileFeatureDetailFetchResult<T = Record<string, unknown>> {
+    url: string;
+    status: number;
+    notModified: boolean;
+    validators: QueryTileServerCacheValidators;
+    detail?: QueryTileFeatureDetailResponse<T>;
+    degraded?: readonly QueryTileServerDegradation[];
+}
+export declare class QueryTileServerResponseError extends Error {
+    readonly status: number;
+    readonly url: string;
+    readonly response: QueryTileServerErrorResponse | undefined;
+    readonly body: unknown;
+    readonly validators: QueryTileServerCacheValidators;
+    constructor(options: {
+        status: number;
+        url: string;
+        message: string;
+        response?: QueryTileServerErrorResponse;
+        body?: unknown;
+        validators?: QueryTileServerCacheValidators;
+    });
+}
+export interface QueryTileViewport {
+    /** `[west, south, east, north]` in WGS84 degrees. */
+    bounds: readonly [number, number, number, number];
+    zoom: number;
+    minzoom?: number;
+    maxzoom?: number;
+    maxTiles?: number;
+}
+export type QueryTileDiagnosticSeverity = "info" | "warning" | "error";
+export type QueryTileDiagnosticCode = "tile-pushdown-supported" | "tile-pushdown-unavailable" | "fallback-enabled" | "fallback-disabled" | "unsupported-protocol" | "analytics-tile-pushdown-supported" | "analytics-tile-pushdown-unavailable" | "client-materialization-disabled" | "missing-tile-endpoint" | "missing-cache-scope" | "unbounded-cache";
+export interface QueryTileDiagnostic {
+    severity: QueryTileDiagnosticSeverity;
+    code: QueryTileDiagnosticCode;
+    message: string;
+    sourceId: string;
+    descriptorId: string;
+    protocol?: Protocol;
+    capability?: Capability;
+}
+export interface QueryTileRequest {
+    descriptor: QueryTileSourceDescriptor;
+    tileKey: QueryTileKey;
+    cacheKey: string;
+    url: string;
+    signal: AbortSignal;
+}
+export type QueryTileFetcher<T> = (request: QueryTileRequest) => Promise<T>;
+export type QueryTileLifecycleEvent<T = unknown> = {
+    type: "tile-requested";
+    descriptorId: string;
+    sourceId: string;
+    tileKey: QueryTileKey;
+    cacheKey: string;
+    url: string;
+} | {
+    type: "tile-cache-hit";
+    descriptorId: string;
+    sourceId: string;
+    tileKey: QueryTileKey;
+    cacheKey: string;
+    value: T;
+} | {
+    type: "tile-loaded";
+    descriptorId: string;
+    sourceId: string;
+    tileKey: QueryTileKey;
+    cacheKey: string;
+    value: T;
+} | {
+    type: "tile-aborted";
+    descriptorId: string;
+    sourceId: string;
+    tileKey: QueryTileKey;
+    cacheKey: string;
+    reason?: unknown;
+} | {
+    type: "tile-error";
+    descriptorId: string;
+    sourceId: string;
+    tileKey: QueryTileKey;
+    cacheKey: string;
+    error: unknown;
+} | {
+    type: "tile-evicted";
+    descriptorId: string;
+    sourceId: string;
+    tileKey: QueryTileKey;
+    cacheKey: string;
+    reason: "invalidate" | "lru" | "clear";
+};
+export type QueryTileLifecycleListener<T = unknown> = (event: QueryTileLifecycleEvent<T>) => void;
+export interface QueryTileRequestControllerOptions<T> {
+    fetchTile: QueryTileFetcher<T>;
+    cache?: QueryTileCachePolicy;
+    onEvent?: QueryTileLifecycleListener<T>;
+}
+export interface QueryTileRequestTileOptions {
+    signal?: AbortSignal;
+    cache?: QueryTileCacheKeyOptions["cache"];
+}
+export interface QueryTileViewportRequestOptions extends QueryTileRequestTileOptions {
+    abortOutOfViewport?: boolean;
+    concurrency?: number;
+}
+export interface QueryTileViewportRequestResult<T> {
+    viewport: QueryTileViewport;
+    tiles: readonly QueryTileKey[];
+    results: readonly PromiseSettledResult<T>[];
+    diagnostics: readonly QueryTileDiagnostic[];
+}
+export interface QueryTileCacheSnapshot {
+    entries: number;
+    inflight: number;
+    maxEntries: number | undefined;
+    tileKeys: readonly string[];
+}
+/** Build a MapLibre-compatible TileJSON document from a query tile descriptor. */
+export declare function buildQueryTileJson<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, options?: QueryTileUrlTemplateOptions): QueryTileJson;
+/** Build a MapLibre vector source spec using TileJSON URL or inline tile template metadata. */
+export declare function buildMapLibreQueryTileSourceSpec<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, options?: QueryTileSourceSpecOptions): MapLibreQueryTileSourceSpec;
+/** Build a URL template with MapLibre `{z}` / `{x}` / `{y}` placeholders. */
+export declare function buildQueryTileUrlTemplate<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, options?: QueryTileUrlTemplateOptions): string;
+/** Substitute one normalized tile key into a query tile URL template. */
+export declare function buildQueryTileUrl<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, tileKey: QueryTileKeyInput, options?: QueryTileUrlTemplateOptions): string;
+/** Fetch and validate TileJSON from a dynamic query tile server. */
+export declare function fetchQueryTileJson<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, options?: FetchQueryTileJsonOptions): Promise<QueryTileJsonFetchResult>;
+/** Fetch and validate a source-qualified feature-detail response from a query tile server. */
+export declare function fetchQueryTileFeatureDetail<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, target: QueryTileFeatureIdentityTarget, options?: FetchQueryTileFeatureDetailOptions): Promise<QueryTileFeatureDetailFetchResult<T>>;
+/** Compute visible XYZ tiles for a WGS84 bounds + zoom viewport. */
+export declare function queryTilesForViewport(viewport: QueryTileViewport): readonly QueryTileKey[];
+/** Diagnose protocol support, fallback behavior, and cache observability gaps. */
+export declare function diagnoseQueryTileSourceSupport<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>): readonly QueryTileDiagnostic[];
+export declare function createQueryTileRequestController<T = unknown>(descriptor: QueryTileSourceDescriptor, options: QueryTileRequestControllerOptions<T>): QueryTileRequestController<T>;
+/** Viewport-aware tile request manager with abortable inflight requests and bounded cache. */
+export declare class QueryTileRequestController<T = unknown> {
+    #private;
+    readonly descriptor: QueryTileSourceDescriptor;
+    constructor(descriptor: QueryTileSourceDescriptor, options: QueryTileRequestControllerOptions<T>);
+    requestTile(tileKey: QueryTileKeyInput, options?: QueryTileRequestTileOptions): Promise<T>;
+    requestViewport(viewport: QueryTileViewport, options?: QueryTileViewportRequestOptions): Promise<QueryTileViewportRequestResult<T>>;
+    abort(tileKey?: QueryTileKeyInput, reason?: unknown): void;
+    invalidate(predicate?: (entry: {
+        cacheKey: string;
+        tileKey: QueryTileKey;
+        value: T;
+    }) => boolean): number;
+    clearCache(): void;
+    dispose(): void;
+    cacheSnapshot(): QueryTileCacheSnapshot;
+    diagnostics(): readonly QueryTileDiagnostic[];
+}
+//# sourceMappingURL=query-tiles.d.ts.map

package/runtime/query-tiles.d.ts.map

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