@honua/app-platform 0.0.20-alpha.0

package/web-components/types.d.ts

@@ -0,0 +1,397 @@
+import type { FeatureId, Query } from "../contract/index.js";
+import type { HonuaTypedFeature } from "../core/types.js";
+import type { HonuaHitTestOptions, HonuaHitTestResult, HonuaPointerInput } from "../interactions/index.js";
+import type { HonuaMapPackage, HonuaMapPackageLegendEntry } from "../runtime/index.js";
+import type { HonuaLayerSpecification } from "../style/index.js";
+export type HonuaComponentStatus = "idle" | "loading" | "ready" | "error" | "unsupported";
+export interface HonuaLayerModel {
+    id: string;
+    title: string;
+    sourceId?: string;
+    type?: string;
+    visible: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface HonuaLegendItem {
+    id: string;
+    label: string;
+    color?: string;
+    iconUrl?: string;
+    layerId?: string;
+    minValue?: number;
+    maxValue?: number;
+}
+export interface HonuaViewportState {
+    bbox?: readonly [number, number, number, number];
+    center?: readonly [number, number];
+    zoom?: number;
+    pitch?: number;
+    bearing?: number;
+}
+export interface HonuaFeatureRecord<T = Record<string, unknown>> {
+    id: FeatureId;
+    sourceId: string;
+    attributes: T;
+    geometry?: HonuaTypedFeature<T>["geometry"];
+    title?: string;
+}
+export interface HonuaFeatureTableModel<T = Record<string, unknown>> {
+    sourceId: string | undefined;
+    status: HonuaComponentStatus;
+    fields: readonly string[];
+    rows: readonly HonuaFeatureRecord<T>[];
+    totalCount: number;
+    exceededTransferLimit?: boolean;
+    error?: unknown;
+}
+export interface HonuaSearchResult<T = Record<string, unknown>> {
+    id: string;
+    label: string;
+    sourceId?: string;
+    sourceLayer?: string;
+    featureId?: FeatureId;
+    feature?: HonuaFeatureRecord<T>;
+    subtitle?: string;
+    score?: number;
+    viewport?: HonuaViewportState;
+}
+export interface HonuaSelectionState<T = Record<string, unknown>> {
+    sourceId?: string;
+    sourceLayer?: string;
+    featureId?: FeatureId;
+    feature?: HonuaFeatureRecord<T>;
+}
+export interface HonuaFeatureStateTarget {
+    sourceId: string;
+    featureId: FeatureId;
+    sourceLayer?: string;
+}
+export interface HonuaFeatureStateEntry extends HonuaFeatureStateTarget {
+    state: Readonly<Record<string, unknown>>;
+}
+export interface HonuaFilterState {
+    sourceId?: string;
+    expression?: string;
+    text?: string;
+}
+export interface HonuaEditCapabilities {
+    canCreate: boolean;
+    canUpdate: boolean;
+    canDelete: boolean;
+    readOnly: boolean;
+    reason?: string;
+}
+export interface HonuaEditorModel {
+    sourceId?: string;
+    status: HonuaComponentStatus;
+    capabilities: HonuaEditCapabilities;
+    selectedFeatureId?: FeatureId;
+    fields?: readonly string[];
+    message?: string;
+}
+export interface HonuaChartDatum {
+    label: string;
+    value: number;
+    color?: string;
+}
+export interface HonuaChartModel {
+    id: string;
+    title: string;
+    kind: "bar" | "line" | "pie" | "number" | "placeholder";
+    status: HonuaComponentStatus;
+    sourceId?: string;
+    data?: readonly HonuaChartDatum[];
+    message?: string;
+}
+export interface HonuaWebComponentState<T = Record<string, unknown>> {
+    packageId?: string;
+    status: HonuaComponentStatus;
+    mapPackage?: HonuaMapPackage;
+    layers: readonly HonuaLayerModel[];
+    legend: readonly HonuaLegendItem[];
+    viewport: HonuaViewportState;
+    featuresBySource: Readonly<Record<string, readonly HonuaFeatureRecord<T>[]>>;
+    selection?: HonuaSelectionState<T>;
+    featureStates: readonly HonuaFeatureStateEntry[];
+    filters: Readonly<Record<string, HonuaFilterState>>;
+    editor?: HonuaEditorModel;
+    chart?: HonuaChartModel;
+    refreshedAt?: string;
+    stale?: boolean;
+}
+export type HonuaControllerStateListener<T = Record<string, unknown>> = (state: HonuaWebComponentState<T>) => void;
+export interface HonuaControllerSubscription {
+    remove(): void;
+}
+export interface HonuaQueryFeaturesOptions {
+    sourceId?: string;
+    fields?: readonly string[];
+    filter?: HonuaFilterState;
+    pagination?: {
+        offset?: number;
+        limit?: number;
+    };
+    signal?: AbortSignal;
+}
+export interface HonuaSearchOptions {
+    sourceId?: string;
+    limit?: number;
+    fields?: readonly string[];
+    signal?: AbortSignal;
+}
+export interface HonuaEditRequest<T = Record<string, unknown>> {
+    sourceId: string;
+    feature: HonuaFeatureRecord<T>;
+    operation: "create" | "update" | "delete";
+    signal?: AbortSignal;
+}
+export interface HonuaWebComponentController<T = Record<string, unknown>> {
+    getState(): HonuaWebComponentState<T>;
+    subscribe(listener: HonuaControllerStateListener<T>): HonuaControllerSubscription;
+    setLayerVisibility(layerId: string, visible: boolean): void;
+    setViewport(viewport: HonuaViewportState): void;
+    setFilter(filter: HonuaFilterState): void;
+    selectFeature(selection: HonuaSelectionState<T>): void;
+    clearSelection(): void;
+    setFeatureState(target: HonuaFeatureStateTarget, state: Record<string, unknown>): void;
+    removeFeatureState(target: HonuaFeatureStateTarget, key?: string): void;
+    queryFeatures(sourceId?: string, options?: HonuaQueryFeaturesOptions): Promise<HonuaFeatureTableModel<T>>;
+    search(query: string, options?: HonuaSearchOptions): Promise<readonly HonuaSearchResult<T>[]>;
+    hitTest?(input: HonuaPointerInput | unknown, options?: HonuaHitTestOptions): Promise<HonuaHitTestResult>;
+    onPointer?(handler: (hit: HonuaHitTestResult) => void | Promise<void>, options?: HonuaHitTestOptions & {
+        readonly event?: "click" | "dblclick" | "mousemove";
+    }): HonuaControllerSubscription;
+    applyEdit?(request: HonuaEditRequest<T>): Promise<HonuaEditorModel>;
+    updateFeatures?(sourceId: string, features: readonly HonuaFeatureRecord<T>[]): void;
+    /** Whether a measurement drawing provider is configured. */
+    canMeasure(): boolean;
+    /** Whether a sketch drawing provider is configured. */
+    canSketch(): boolean;
+    /** Activate a measuring mode through the configured provider. */
+    setMeasureMode(mode: HonuaMeasureMode): Promise<HonuaMeasureChangeDetail>;
+    /** Activate a drawing mode through the configured provider. */
+    setSketchMode(mode: HonuaSketchMode): Promise<HonuaSketchChangeDetail<T>>;
+    destroy?(): void;
+}
+export interface CreateHonuaWebComponentControllerOptions<T = Record<string, unknown>> {
+    mapPackage?: HonuaMapPackage;
+    layers?: readonly HonuaLayerModel[];
+    legend?: readonly HonuaLegendItem[];
+    viewport?: HonuaViewportState;
+    featuresBySource?: Readonly<Record<string, readonly HonuaFeatureRecord<T>[]>>;
+    fieldsBySource?: Readonly<Record<string, readonly string[]>>;
+    editor?: Partial<HonuaEditorModel>;
+    chart?: HonuaChartModel;
+    searchFields?: readonly string[];
+    status?: HonuaComponentStatus;
+    /**
+     * Optional drawing backend that powers `<honua-measure-control>`. When
+     * omitted the control renders disabled with a "configure a provider"
+     * affordance — measurement geometry is not available from the bare
+     * in-memory controller by design. Supply an adapter (for example one backed
+     * by maplibre-gl-draw) to enable distance/area measuring.
+     */
+    measurementGeometry?: HonuaMeasureProvider;
+    /**
+     * Optional drawing backend that powers `<honua-sketch-control>`. When
+     * omitted the control renders disabled with a "configure a provider"
+     * affordance. Supply an adapter to enable point/line/polygon sketching.
+     */
+    sketchGeometry?: HonuaSketchProvider<T>;
+}
+export interface HonuaWebComponentRuntimeLike<T = Record<string, unknown>> {
+    readonly mapPackage: HonuaMapPackage;
+    readonly composedStyle: {
+        layers: readonly HonuaLayerSpecification[];
+    };
+    getLegend(): readonly HonuaMapPackageLegendEntry[];
+    setLayerVisibility(layerId: string, visible: boolean): void;
+    setViewState(viewport: HonuaViewportState): void;
+    readonly dataset?: {
+        source(id: string): {
+            query(request?: Query<T>): Promise<{
+                features: readonly HonuaTypedFeature<T>[];
+                totalCount?: number;
+                exceededTransferLimit?: boolean;
+                fields?: readonly {
+                    name: string;
+                }[];
+            }>;
+        } | undefined;
+    };
+    on?(listener: (event: {
+        type: string;
+        sourceId?: string;
+        error?: unknown;
+    }) => void): HonuaControllerSubscription;
+}
+export interface HonuaSelectionChangeDetail<T = Record<string, unknown>> extends HonuaSelectionState<T> {
+}
+export interface HonuaLayerVisibilityChangeDetail {
+    layerId: string;
+    visible: boolean;
+}
+export interface HonuaViewportChangeDetail extends HonuaViewportState {
+}
+export interface HonuaFilterChangeDetail extends HonuaFilterState {
+}
+export interface HonuaMapReadyDetail<T = Record<string, unknown>> {
+    map: unknown;
+    runtime?: HonuaWebComponentRuntimeLike<T>;
+    controller?: HonuaWebComponentController<T>;
+    mapPackage?: HonuaMapPackage;
+}
+export interface HonuaMapErrorDetail {
+    error: unknown;
+    message: string;
+    sourceId?: string;
+}
+export interface HonuaMapInteractionPoint {
+    x: number;
+    y: number;
+}
+export interface HonuaMapInteractionDetail<T = Record<string, unknown>> {
+    layerId?: string;
+    sourceId?: string;
+    sourceLayer?: string;
+    featureId?: FeatureId;
+    feature?: HonuaFeatureRecord<T>;
+    mapFeature?: unknown;
+    point?: HonuaMapInteractionPoint;
+    lngLat?: readonly [number, number];
+    originalEvent?: unknown;
+}
+export interface HonuaMapClickDetail<T = Record<string, unknown>> extends HonuaMapInteractionDetail<T> {
+}
+export interface HonuaMapHoverDetail<T = Record<string, unknown>> extends HonuaMapInteractionDetail<T> {
+    hovering: boolean;
+}
+export interface HonuaSearchDetail<T = Record<string, unknown>> {
+    query: string;
+    results: readonly HonuaSearchResult<T>[];
+}
+export interface HonuaEditChangeDetail<T = Record<string, unknown>> {
+    status: HonuaComponentStatus;
+    request?: HonuaEditRequest<T>;
+    model: HonuaEditorModel;
+}
+export interface HonuaControllerReadyDetail<T = Record<string, unknown>> {
+    controller: HonuaWebComponentController<T>;
+}
+export interface HonuaBasemapChangeDetail {
+    basemapId: string;
+    previousBasemapId?: string;
+    status: HonuaComponentStatus;
+}
+export interface HonuaBookmark {
+    id: string;
+    label: string;
+    viewport: HonuaViewportState;
+}
+export interface HonuaBookmarkChangeDetail extends HonuaBookmark {
+    status: HonuaComponentStatus;
+}
+export interface HonuaLocateChangeDetail {
+    status: HonuaComponentStatus;
+    viewport?: HonuaViewportState;
+    error?: unknown;
+    message?: string;
+}
+export type HonuaMeasureMode = "off" | "distance" | "area";
+/**
+ * A drawn measurement geometry plus its computed result.
+ *
+ * Geometry is intentionally protocol-neutral (GeoJSON-style coordinates) so a
+ * provider can be backed by maplibre-gl-draw, Terra Draw, a custom canvas
+ * tool, or an in-memory fixture without the SDK depending on any of them.
+ */
+export interface HonuaMeasureResult {
+    mode: HonuaMeasureMode;
+    /** GeoJSON `[lng, lat]` positions describing the drawn line or ring. */
+    coordinates: readonly (readonly [number, number])[];
+    /** Total length in metres for distance mode. */
+    distance?: number;
+    /** Enclosed area in square metres for area mode. */
+    area?: number;
+}
+export interface HonuaMeasureChangeDetail {
+    mode: HonuaMeasureMode;
+    status: HonuaComponentStatus;
+    message?: string;
+    result?: HonuaMeasureResult;
+}
+export type HonuaSketchMode = "off" | "point" | "line" | "polygon";
+/**
+ * A drawn sketch feature emitted by a {@link HonuaSketchProvider}.
+ */
+export interface HonuaSketchResult<T = Record<string, unknown>> {
+    mode: HonuaSketchMode;
+    /** Stable id for the drawn feature when the backend assigns one. */
+    id?: FeatureId;
+    /** Protocol-neutral GeoJSON geometry produced by the drawing backend. */
+    geometry: HonuaTypedFeature<T>["geometry"];
+    /** Optional attributes the backend attaches to the drawn feature. */
+    attributes?: T;
+}
+/**
+ * Minimal drawing-backend contract for the `<honua-measure-control>` widget.
+ *
+ * Implementations adapt a concrete drawing tool (for example a
+ * maplibre-gl-draw instance) to the protocol-neutral measurement surface. The
+ * SDK never imports a drawing library directly; consumers supply an adapter via
+ * {@link CreateHonuaWebComponentControllerOptions.measurementGeometry}.
+ */
+export interface HonuaMeasureProvider {
+    /**
+     * Enter (or leave, when `mode === "off"`) a measuring mode. Returns the
+     * current/last measurement result when one is immediately available.
+     */
+    startMode(mode: HonuaMeasureMode): HonuaMeasureResult | undefined | Promise<HonuaMeasureResult | undefined>;
+    /** Stop measuring and discard any in-progress geometry. */
+    stop?(): void;
+    /** Subscribe to measurement results as the user draws. */
+    onResult?(listener: (result: HonuaMeasureResult) => void): HonuaControllerSubscription;
+}
+/**
+ * Minimal drawing-backend contract for the `<honua-sketch-control>` widget.
+ *
+ * @see HonuaMeasureProvider for the design rationale (no hard drawing-library
+ *   dependency; adapters are supplied by the consumer).
+ */
+export interface HonuaSketchProvider<T = Record<string, unknown>> {
+    /**
+     * Enter (or leave, when `mode === "off"`) a drawing mode. Returns the
+     * current/last sketch result when one is immediately available.
+     */
+    startMode(mode: HonuaSketchMode): HonuaSketchResult<T> | undefined | Promise<HonuaSketchResult<T> | undefined>;
+    /** Stop drawing and discard any in-progress geometry. */
+    stop?(): void;
+    /** Subscribe to sketch results as the user draws. */
+    onResult?(listener: (result: HonuaSketchResult<T>) => void): HonuaControllerSubscription;
+}
+export interface HonuaSketchChangeDetail<T = Record<string, unknown>> {
+    mode: HonuaSketchMode;
+    status: HonuaComponentStatus;
+    message?: string;
+    result?: HonuaSketchResult<T>;
+}
+export interface HonuaExportDetail {
+    format: "print" | "png" | "json";
+    status: HonuaComponentStatus;
+    title?: string;
+    message?: string;
+}
+export interface HonuaFullscreenChangeDetail {
+    fullscreen: boolean;
+    status: HonuaComponentStatus;
+    message?: string;
+}
+export interface HonuaActionPanelAction {
+    id: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface HonuaActionDetail extends HonuaActionPanelAction {
+    status: HonuaComponentStatus;
+}
+//# sourceMappingURL=types.d.ts.map

package/web-components/types.d.ts.map

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

package/web-components/types.js

@@ -0,0 +1 @@
+export {};

package/webmap/contract.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Compatibility contract for WebMap JSON → HonuaStyleSpecification conversion.
+ *
+ * Documents every WebMap JSON property path and its support level,
+ * enabling consumers to programmatically audit which features are
+ * handled (or not) by the parser.
+ *
+ * @module
+ */
+export type ContractSupport = "full" | "partial" | "ignored" | "unsupported";
+export interface ContractEntry {
+    /** JSON path pattern (e.g. `"operationalLayers[].layerDefinition.drawingInfo.renderer"`). */
+    path: string;
+    /** Support level. */
+    support: ContractSupport;
+    /** Additional notes about limitations or behavior. */
+    notes?: string;
+}
+export declare const CONTRACT: ContractEntry[];
+export interface ContractSummary {
+    total: number;
+    full: number;
+    partial: number;
+    ignored: number;
+    unsupported: number;
+}
+export declare function getContractSummary(): ContractSummary;
+//# sourceMappingURL=contract.d.ts.map

package/webmap/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/webmap/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,QAAQ,EAAE,aAAa,EA2HnC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAOpD"}

package/webmap/contract.js

@@ -0,0 +1,130 @@
+/**
+ * Compatibility contract for WebMap JSON → HonuaStyleSpecification conversion.
+ *
+ * Documents every WebMap JSON property path and its support level,
+ * enabling consumers to programmatically audit which features are
+ * handled (or not) by the parser.
+ *
+ * @module
+ */
+export const CONTRACT = [
+    // ── Top-level ──
+    { path: "version", support: "ignored", notes: "Informational only" },
+    { path: "authoringApp", support: "ignored" },
+    { path: "authoringAppVersion", support: "ignored" },
+    { path: "spatialReference", support: "partial", notes: "Web Mercator (3857/102100) supported; others warn" },
+    { path: "unknown top-level properties", support: "ignored", notes: "Ignored with warning" },
+    // ── Initial viewpoint / extent ──
+    {
+        path: "initialViewpoint",
+        support: "partial",
+        notes: "targetGeometry point/extent supported; camera/3D unsupported",
+    },
+    { path: "initialViewpoint.targetGeometry", support: "partial", notes: "Point or extent in 3857/102100/4326" },
+    { path: "initialViewpoint.scale", support: "full", notes: "Converted to approximate zoom" },
+    { path: "initialExtent", support: "full", notes: "Converted to center/zoom for Web Mercator" },
+    { path: "initialExtent.spatialReference", support: "partial", notes: "Web Mercator only" },
+    // ── Bookmarks ──
+    { path: "bookmarks", support: "full", notes: "Passed through as-is in result" },
+    { path: "bookmarks[].name", support: "full" },
+    { path: "bookmarks[].extent", support: "full" },
+    // ── Basemap ──
+    { path: "baseMap", support: "partial" },
+    { path: "baseMap.title", support: "full" },
+    { path: "baseMap.baseMapLayers[]", support: "partial" },
+    { path: "baseMap.baseMapLayers[].url", support: "full" },
+    {
+        path: "baseMap.baseMapLayers[].layerType",
+        support: "partial",
+        notes: "ArcGISTiledMapServiceLayer supported; VectorTileLayer partial",
+    },
+    { path: "baseMap.baseMapLayers[].visibility", support: "full" },
+    { path: "baseMap.baseMapLayers[].opacity", support: "full" },
+    {
+        path: "baseMap.baseMapLayers[].styleUrl",
+        support: "partial",
+        notes: "Noted in metadata; sprite/glyph resolution not performed",
+    },
+    // ── Operational layers ──
+    { path: "operationalLayers[]", support: "partial" },
+    { path: "operationalLayers[].id", support: "full" },
+    { path: "operationalLayers[].title", support: "full", notes: "Used as layer metadata" },
+    { path: "operationalLayers[].url", support: "full" },
+    {
+        path: "operationalLayers[].layerType",
+        support: "partial",
+        notes: "ArcGISFeatureLayer, ArcGISMapServiceLayer supported",
+    },
+    { path: "operationalLayers[].visibility", support: "full" },
+    { path: "operationalLayers[].opacity", support: "full" },
+    { path: "operationalLayers[].minScale", support: "full" },
+    { path: "operationalLayers[].maxScale", support: "full" },
+    // ── Layer definition ──
+    { path: "operationalLayers[].layerDefinition", support: "partial" },
+    { path: "operationalLayers[].layerDefinition.definitionExpression", support: "full" },
+    { path: "operationalLayers[].layerDefinition.drawingInfo", support: "partial" },
+    { path: "operationalLayers[].layerDefinition.drawingInfo.transparency", support: "full" },
+    // ── Renderers ──
+    { path: "operationalLayers[].layerDefinition.drawingInfo.renderer", support: "partial" },
+    { path: "operationalLayers[].layerDefinition.drawingInfo.renderer (simple)", support: "full" },
+    { path: "operationalLayers[].layerDefinition.drawingInfo.renderer (uniqueValue)", support: "full" },
+    { path: "operationalLayers[].layerDefinition.drawingInfo.renderer (classBreaks)", support: "full" },
+    {
+        path: "operationalLayers[].layerDefinition.drawingInfo.renderer (heatmap)",
+        support: "unsupported",
+        notes: "Warning emitted",
+    },
+    {
+        path: "operationalLayers[].layerDefinition.drawingInfo.renderer (dotDensity)",
+        support: "unsupported",
+        notes: "Warning emitted",
+    },
+    // ── Symbols ──
+    { path: "symbol (esriSFS)", support: "full", notes: "Simple fill symbol → fill layer" },
+    { path: "symbol (esriSLS)", support: "full", notes: "Simple line symbol → line layer" },
+    { path: "symbol (esriSMS)", support: "full", notes: "Simple marker symbol → circle layer" },
+    { path: "symbol (esriPMS)", support: "partial", notes: "Picture marker → symbol layer; requires sprite setup" },
+    { path: "symbol (esriTS)", support: "partial", notes: "Text symbol → symbol layer with text" },
+    // ── Labeling ──
+    { path: "operationalLayers[].layerDefinition.drawingInfo.labelingInfo", support: "partial" },
+    {
+        path: "operationalLayers[].layerDefinition.drawingInfo.labelingInfo[].labelExpressionInfo.expression",
+        support: "partial",
+        notes: "Simple $feature.FIELD supported; complex Arcade skipped",
+    },
+    // ── Popups ──
+    {
+        path: "operationalLayers[].popupInfo",
+        support: "full",
+        notes: "Passed through as metadata (MapLibre has no popup spec)",
+    },
+    { path: "operationalLayers[].popupInfo.title", support: "full" },
+    { path: "operationalLayers[].popupInfo.description", support: "full" },
+    { path: "operationalLayers[].popupInfo.fieldInfos", support: "full" },
+    { path: "operationalLayers[].popupInfo.mediaInfos", support: "full" },
+    {
+        path: "operationalLayers[].popupInfo.expressionInfos",
+        support: "unsupported",
+        notes: "Warning emitted; manual intervention",
+    },
+    // ── Feature collection (inline) ──
+    {
+        path: "operationalLayers[].featureCollection",
+        support: "unsupported",
+        notes: "Inline feature collections not yet supported",
+    },
+    // ── 3D ──
+    {
+        path: "ground / viewingMode / camera / elevationInfo",
+        support: "unsupported",
+        notes: "Warning emitted; manual intervention",
+    },
+];
+export function getContractSummary() {
+    const summary = { total: 0, full: 0, partial: 0, ignored: 0, unsupported: 0 };
+    for (const entry of CONTRACT) {
+        summary.total++;
+        summary[entry.support]++;
+    }
+    return summary;
+}

package/webmap/convert-basemap.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts Esri WebMap baseMap to Honua sources and layers.
+ *
+ * @module
+ */
+import type { HonuaLayerSpecification, HonuaMapServiceSourceSpecification } from "../style/specification.js";
+import type { WebMapBaseMap } from "./types.js";
+import { type WarningCollector } from "./warnings.js";
+export interface BasemapConversionResult {
+    sources: Record<string, HonuaMapServiceSourceSpecification | {
+        type: string;
+        [key: string]: unknown;
+    }>;
+    layers: HonuaLayerSpecification[];
+}
+export declare function convertBasemap(baseMap: WebMapBaseMap | undefined, warn: WarningCollector): BasemapConversionResult;
+//# sourceMappingURL=convert-basemap.d.ts.map

package/webmap/convert-basemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-basemap.d.ts","sourceRoot":"","sources":["../../../src/webmap/convert-basemap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC;AAC7G,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,KAAK,gBAAgB,EAAyB,MAAM,eAAe,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kCAAkC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACvG,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,uBAAuB,CA6ElH"}