@phila/layerboard 3.0.0-beta.20 → 3.0.0-beta.21

package/dist/composables/useDataSource.d.ts

@@ -0,0 +1,340 @@
+import { Ref } from 'vue';
+/**
+ * Bounding box for spatial queries
+ */
+export interface Bounds {
+    north: number;
+    south: number;
+    east: number;
+    west: number;
+}
+/**
+ * Configuration for a data source
+ */
+export interface DataSourceConfig {
+    /** ArcGIS FeatureServer URL */
+    url: string;
+    /** Optional where clause for filtering features */
+    where?: string;
+    /** Maximum features per request (default: 2000) */
+    pageSize?: number;
+    /** Whether to clip geometries to viewport bounds */
+    clipToViewport?: boolean;
+}
+/**
+ * Options for fetch operations
+ */
+export interface FetchOptions {
+    /** Spatial bounds for the query */
+    bounds?: Bounds;
+    /** Override where clause */
+    where?: string;
+    /** Output spatial reference (default: 4326) */
+    outSR?: number;
+}
+/**
+ * Composable for fetching data from ArcGIS Feature Services.
+ *
+ * @example
+ * ```typescript
+ * const { data, isLoading, error, fetch } = useDataSource({
+ *   url: 'https://services.arcgis.com/.../FeatureServer/0',
+ *   where: "STATUS = 'Active'"
+ * })
+ *
+ * // Fetch with spatial bounds
+ * await fetch({ bounds: { north: 40, south: 39, east: -75, west: -76 } })
+ * ```
+ */
+export declare function useDataSource(config: DataSourceConfig): {
+    data: Readonly<Ref<{
+        readonly type: "FeatureCollection";
+        readonly features: readonly {
+            readonly type: "Feature";
+            readonly geometry: {
+                readonly type: "Point";
+                readonly coordinates: readonly number[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPoint";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "LineString";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiLineString";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "Polygon";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPolygon";
+                readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "GeometryCollection";
+                readonly geometries: readonly ({
+                    readonly type: "Point";
+                    readonly coordinates: readonly number[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPoint";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "LineString";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiLineString";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "Polygon";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPolygon";
+                    readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | /*elided*/ any)[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            };
+            readonly id?: string | number | undefined | undefined;
+            readonly properties: {
+                readonly [x: string]: any;
+            } | null;
+            readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+        }[];
+        readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+    } | null, {
+        readonly type: "FeatureCollection";
+        readonly features: readonly {
+            readonly type: "Feature";
+            readonly geometry: {
+                readonly type: "Point";
+                readonly coordinates: readonly number[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPoint";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "LineString";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiLineString";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "Polygon";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPolygon";
+                readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "GeometryCollection";
+                readonly geometries: readonly ({
+                    readonly type: "Point";
+                    readonly coordinates: readonly number[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPoint";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "LineString";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiLineString";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "Polygon";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPolygon";
+                    readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | /*elided*/ any)[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            };
+            readonly id?: string | number | undefined | undefined;
+            readonly properties: {
+                readonly [x: string]: any;
+            } | null;
+            readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+        }[];
+        readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+    } | null>>;
+    isLoading: Readonly<Ref<boolean, boolean>>;
+    error: Readonly<Ref<Error | null, Error | null>>;
+    totalFeatures: Readonly<Ref<number, number>>;
+    config: DataSourceConfig;
+    fetch: (options?: FetchOptions) => Promise<GeoJSON.FeatureCollection>;
+    refetch: (options?: FetchOptions) => Promise<GeoJSON.FeatureCollection>;
+    clear: () => void;
+};
+/**
+ * Create a reactive data source that refetches when a trigger changes.
+ *
+ * @example
+ * ```typescript
+ * const address = ref({ lat: 39.9526, lng: -75.1652 })
+ * const { data, isLoading } = useReactiveDataSource(
+ *   { url: 'https://services.arcgis.com/.../FeatureServer/0' },
+ *   address,
+ *   (addr) => ({ bounds: boundsFromAddress(addr) })
+ * )
+ * // Data refetches automatically when address changes
+ * ```
+ */
+export declare function useReactiveDataSource<T>(config: DataSourceConfig, trigger: Ref<T>, optionsFn: (value: T) => FetchOptions): {
+    data: Readonly<Ref<{
+        readonly type: "FeatureCollection";
+        readonly features: readonly {
+            readonly type: "Feature";
+            readonly geometry: {
+                readonly type: "Point";
+                readonly coordinates: readonly number[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPoint";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "LineString";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiLineString";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "Polygon";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPolygon";
+                readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "GeometryCollection";
+                readonly geometries: readonly ({
+                    readonly type: "Point";
+                    readonly coordinates: readonly number[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPoint";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "LineString";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiLineString";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "Polygon";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPolygon";
+                    readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | /*elided*/ any)[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            };
+            readonly id?: string | number | undefined | undefined;
+            readonly properties: {
+                readonly [x: string]: any;
+            } | null;
+            readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+        }[];
+        readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+    } | null, {
+        readonly type: "FeatureCollection";
+        readonly features: readonly {
+            readonly type: "Feature";
+            readonly geometry: {
+                readonly type: "Point";
+                readonly coordinates: readonly number[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPoint";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "LineString";
+                readonly coordinates: readonly (readonly number[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiLineString";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "Polygon";
+                readonly coordinates: readonly (readonly (readonly number[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "MultiPolygon";
+                readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            } | {
+                readonly type: "GeometryCollection";
+                readonly geometries: readonly ({
+                    readonly type: "Point";
+                    readonly coordinates: readonly number[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPoint";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "LineString";
+                    readonly coordinates: readonly (readonly number[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiLineString";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "Polygon";
+                    readonly coordinates: readonly (readonly (readonly number[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | {
+                    readonly type: "MultiPolygon";
+                    readonly coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+                    readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+                } | /*elided*/ any)[];
+                readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+            };
+            readonly id?: string | number | undefined | undefined;
+            readonly properties: {
+                readonly [x: string]: any;
+            } | null;
+            readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+        }[];
+        readonly bbox?: readonly [number, number, number, number] | readonly [number, number, number, number, number, number] | undefined;
+    } | null>>;
+    isLoading: Readonly<Ref<boolean, boolean>>;
+    error: Readonly<Ref<Error | null, Error | null>>;
+    totalFeatures: Readonly<Ref<number, number>>;
+    config: DataSourceConfig;
+    fetch: (options?: FetchOptions) => Promise<GeoJSON.FeatureCollection>;
+    refetch: (options?: FetchOptions) => Promise<GeoJSON.FeatureCollection>;
+    clear: () => void;
+};
+/** Type for the return value of useDataSource */
+export type UseDataSourceReturn = ReturnType<typeof useDataSource>;

package/dist/composables/useLayerConfig.d.ts

@@ -0,0 +1,45 @@
+import { LayerConfig } from '../types';
+export declare function useLayerConfig(): {
+    layers: import('vue').ComputedRef<{
+        id: string;
+        title: string;
+        type: "fill" | "line" | "circle";
+        url: string;
+        where?: string | undefined;
+        minZoom?: number | undefined;
+        maxZoom?: number | undefined;
+        opacity: number;
+        paint?: Record<string, unknown> | undefined;
+        outlinePaint?: Record<string, unknown> | undefined;
+        legend: {
+            type: "fill" | "line" | "circle";
+            color: string;
+            label: string;
+            width?: number | undefined;
+            radius?: number | undefined;
+        }[];
+        popup: {
+            title: string;
+            fields: {
+                field: string;
+                label: string;
+                format?: {
+                    dateFormat?: string | undefined;
+                    digitSeparator?: boolean | undefined;
+                    places?: number | undefined;
+                } | undefined;
+            }[];
+            showTime?: boolean | undefined;
+        } | null;
+        displayOptions?: {
+            shouldShowCheckbox?: boolean | undefined;
+            shouldShowSlider?: boolean | undefined;
+            shouldShowLegendBox?: boolean | undefined;
+            layerNameChange?: string | undefined;
+        } | undefined;
+    }[]>;
+    visibleLayerIds: import('vue').ComputedRef<Set<string> & Omit<Set<string>, keyof Set<any>>>;
+    loadingLayerIds: import('vue').ComputedRef<Set<string> & Omit<Set<string>, keyof Set<any>>>;
+    toggleLayer: (layerId: string) => void;
+    setLayers: (newLayers: LayerConfig[]) => void;
+};

package/dist/composables/useLayerboard.d.ts

@@ -0,0 +1,211 @@
+import { LayerboardConfig } from '../types/config';
+/**
+ * Main composable for initializing and managing the layerboard framework.
+ *
+ * @example
+ * ```typescript
+ * const {
+ *   layerConfigs,
+ *   visibleLayers,
+ *   isLoading,
+ *   error,
+ *   toggleLayer,
+ *   setLayerOpacity,
+ *   filterLayers
+ * } = useLayerboard({
+ *   webMapId: '1596df70df0349e293ceec46a06ccc50',
+ *   mode: 'dynamic',
+ *   panelMode: 'flat'
+ * })
+ * ```
+ */
+export declare function useLayerboard(config: LayerboardConfig): {
+    layerConfigs: Readonly<import('vue').Ref<readonly {
+        readonly id: string;
+        readonly title: string;
+        readonly type: "fill" | "line" | "circle";
+        readonly url: string;
+        readonly where?: string | undefined;
+        readonly minZoom?: number | undefined;
+        readonly maxZoom?: number | undefined;
+        readonly opacity: number;
+        readonly paint?: {
+            readonly [x: string]: Readonly<unknown>;
+        } | undefined;
+        readonly outlinePaint?: {
+            readonly [x: string]: Readonly<unknown>;
+        } | undefined;
+        readonly legend: readonly {
+            readonly type: "fill" | "line" | "circle";
+            readonly color: string;
+            readonly label: string;
+            readonly width?: number | undefined;
+            readonly radius?: number | undefined;
+        }[];
+        readonly popup: {
+            readonly title: string;
+            readonly fields: readonly {
+                readonly field: string;
+                readonly label: string;
+                readonly format?: {
+                    readonly dateFormat?: string | undefined;
+                    readonly digitSeparator?: boolean | undefined;
+                    readonly places?: number | undefined;
+                } | undefined;
+            }[];
+            readonly showTime?: boolean | undefined;
+        } | null;
+        readonly displayOptions?: {
+            readonly shouldShowCheckbox?: boolean | undefined;
+            readonly shouldShowSlider?: boolean | undefined;
+            readonly shouldShowLegendBox?: boolean | undefined;
+            readonly layerNameChange?: string | undefined;
+        } | undefined;
+    }[], readonly {
+        readonly id: string;
+        readonly title: string;
+        readonly type: "fill" | "line" | "circle";
+        readonly url: string;
+        readonly where?: string | undefined;
+        readonly minZoom?: number | undefined;
+        readonly maxZoom?: number | undefined;
+        readonly opacity: number;
+        readonly paint?: {
+            readonly [x: string]: Readonly<unknown>;
+        } | undefined;
+        readonly outlinePaint?: {
+            readonly [x: string]: Readonly<unknown>;
+        } | undefined;
+        readonly legend: readonly {
+            readonly type: "fill" | "line" | "circle";
+            readonly color: string;
+            readonly label: string;
+            readonly width?: number | undefined;
+            readonly radius?: number | undefined;
+        }[];
+        readonly popup: {
+            readonly title: string;
+            readonly fields: readonly {
+                readonly field: string;
+                readonly label: string;
+                readonly format?: {
+                    readonly dateFormat?: string | undefined;
+                    readonly digitSeparator?: boolean | undefined;
+                    readonly places?: number | undefined;
+                } | undefined;
+            }[];
+            readonly showTime?: boolean | undefined;
+        } | null;
+        readonly displayOptions?: {
+            readonly shouldShowCheckbox?: boolean | undefined;
+            readonly shouldShowSlider?: boolean | undefined;
+            readonly shouldShowLegendBox?: boolean | undefined;
+            readonly layerNameChange?: string | undefined;
+        } | undefined;
+    }[]>>;
+    visibleLayers: Readonly<import('vue').Ref<ReadonlySet<string>, ReadonlySet<string>>>;
+    layerOpacities: Readonly<import('vue').Ref<{
+        readonly [x: string]: number;
+    }, {
+        readonly [x: string]: number;
+    }>>;
+    loadingLayers: Readonly<import('vue').Ref<ReadonlySet<string>, ReadonlySet<string>>>;
+    layerErrors: Readonly<import('vue').Ref<{
+        readonly [x: string]: string;
+    }, {
+        readonly [x: string]: string;
+    }>>;
+    searchQuery: Readonly<import('vue').Ref<string, string>>;
+    isLoading: Readonly<import('vue').Ref<boolean, boolean>>;
+    isInitialized: Readonly<import('vue').Ref<boolean, boolean>>;
+    error: Readonly<import('vue').Ref<Error | null, Error | null>>;
+    filteredLayerConfigs: import('vue').ComputedRef<{
+        id: string;
+        title: string;
+        type: "fill" | "line" | "circle";
+        url: string;
+        where?: string | undefined;
+        minZoom?: number | undefined;
+        maxZoom?: number | undefined;
+        opacity: number;
+        paint?: Record<string, unknown> | undefined;
+        outlinePaint?: Record<string, unknown> | undefined;
+        legend: {
+            type: "fill" | "line" | "circle";
+            color: string;
+            label: string;
+            width?: number | undefined;
+            radius?: number | undefined;
+        }[];
+        popup: {
+            title: string;
+            fields: {
+                field: string;
+                label: string;
+                format?: {
+                    dateFormat?: string | undefined;
+                    digitSeparator?: boolean | undefined;
+                    places?: number | undefined;
+                } | undefined;
+            }[];
+            showTime?: boolean | undefined;
+        } | null;
+        displayOptions?: {
+            shouldShowCheckbox?: boolean | undefined;
+            shouldShowSlider?: boolean | undefined;
+            shouldShowLegendBox?: boolean | undefined;
+            layerNameChange?: string | undefined;
+        } | undefined;
+    }[]>;
+    layerList: import('vue').ComputedRef<{
+        config: {
+            id: string;
+            title: string;
+            type: "fill" | "line" | "circle";
+            url: string;
+            where?: string | undefined;
+            minZoom?: number | undefined;
+            maxZoom?: number | undefined;
+            opacity: number;
+            paint?: Record<string, unknown> | undefined;
+            outlinePaint?: Record<string, unknown> | undefined;
+            legend: {
+                type: "fill" | "line" | "circle";
+                color: string;
+                label: string;
+                width?: number | undefined;
+                radius?: number | undefined;
+            }[];
+            popup: {
+                title: string;
+                fields: {
+                    field: string;
+                    label: string;
+                    format?: {
+                        dateFormat?: string | undefined;
+                        digitSeparator?: boolean | undefined;
+                        places?: number | undefined;
+                    } | undefined;
+                }[];
+                showTime?: boolean | undefined;
+            } | null;
+            displayOptions?: {
+                shouldShowCheckbox?: boolean | undefined;
+                shouldShowSlider?: boolean | undefined;
+                shouldShowLegendBox?: boolean | undefined;
+                layerNameChange?: string | undefined;
+            } | undefined;
+        };
+        component: "fill" | "line" | "circle";
+    }[]>;
+    config: LayerboardConfig;
+    initialize: () => Promise<void>;
+    toggleLayer: (layerId: string) => void;
+    setLayerOpacity: (layerId: string, opacity: number) => void;
+    filterLayers: (query: string) => void;
+    setLayerLoading: (layerId: string, loading: boolean) => void;
+    setLayerError: (layerId: string, errorMessage: string | null) => void;
+    reset: () => void;
+};
+/** Type for the return value of useLayerboard */
+export type UseLayerboardReturn = ReturnType<typeof useLayerboard>;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './components';
+export * from './composables';
+export * from './services';
+export * from './utils';
+export * from './types';
+export type { CyclomediaConfig, PictometryCredentials, AisGeocodeResult } from '@phila/phila-ui-map-core';

package/dist/services/index.d.ts

@@ -0,0 +1 @@
+export { getLayerConfigs, clearCache, buildWebMapUrl, getWebMapUrl, WEBMAP_ID } from './layerConfigService';

package/dist/services/layerConfigService.d.ts

@@ -0,0 +1,40 @@
+import { LayerConfig } from '../types/layer';
+/**
+ * The default Esri WebMap ID (OpenMaps)
+ * This can be overridden by passing a webMapId to getLayerConfigs()
+ */
+export declare const DEFAULT_WEBMAP_ID = "376af635c84643cd816a8c5d017a53aa";
+/**
+ * @deprecated Use DEFAULT_WEBMAP_ID instead
+ */
+export declare const WEBMAP_ID = "376af635c84643cd816a8c5d017a53aa";
+/**
+ * Builds the fetch URL for the Esri WebMap JSON
+ * @param webMapId The Esri WebMap ID
+ * @param token Optional ArcGIS token for accessing protected WebMaps
+ * @returns The full URL to fetch the WebMap data
+ */
+export declare function buildWebMapUrl(webMapId: string, token?: string): string;
+/**
+ * Gets the WebMap fetch URL using the default WEBMAP_ID
+ */
+export declare function getWebMapUrl(): string;
+/**
+ * Clear the cached layer configs
+ * @param webMapId Optional - if provided, only clears cache for that webMapId
+ *                 If not provided, clears all cached configs
+ */
+export declare function clearCache(webMapId?: string): void;
+/**
+ * Gets layer configurations by fetching from ArcGIS Online WebMap
+ *
+ * This function:
+ * - Fetches WebMap JSON and transforms it at runtime
+ * - Caches results in memory to avoid redundant fetches/transforms
+ * - Prevents concurrent loads with a loading promise guard
+ *
+ * @param webMapId Optional - the WebMap ID to fetch. Defaults to DEFAULT_WEBMAP_ID
+ * @returns Promise resolving to an array of LayerConfig objects
+ * @throws Error if fetch or transform fails
+ */
+export declare function getLayerConfigs(webMapId?: string): Promise<LayerConfig[]>;