@osm-editor-kit/street-imagery 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,29 @@
+# `@osm-editor-kit/street-imagery`
+
+**Status:** First npm **alpha** (`0.1.0-alpha.0`). Publish with `bun run packages:release -- --publish-only` after `npm login`.
+
+## What it does
+
+Provider-agnostic street-level imagery core: ten adapters (Mapillary, Panoramax, KartaView, Mapilio, Bing Streetside, Vegbilder, Google Street View, Apple Look Around, plus Mapillary signs and map features), normalized photo/sequence/map-feature types, bbox and MVT tile fetching, GeoJSON builders, viewfield geometry, date/type filters, and viewer helpers (deep links, click-radius grouping, thumbnails).
+
+For MapLibre React layers, use `@osm-editor-kit/street-imagery-react`.
+
+## Usage
+
+```ts
+import {
+  adapterById,
+  createStreetImageryConfig,
+  photosToFeatureCollection,
+  setStreetImageryConfig,
+} from '@osm-editor-kit/street-imagery'
+
+setStreetImageryConfig(
+  createStreetImageryConfig({ mapillaryToken: '…' }),
+)
+
+const bbox = [13.44, 52.47, 13.45, 52.48] as const // west, south, east, north
+const controller = new AbortController()
+const photos = await adapterById.mapillary.fetchPhotos!(bbox, 16, controller.signal)
+const geojson = photosToFeatureCollection(photos)
+```

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export type StreetImageryConfig = {
+    mapillaryToken: string;
+    panoramaxApiBase: string;
+};
+export declare const createStreetImageryConfig: (input: {
+    mapillaryToken: string;
+    panoramaxApiBase?: string;
+}) => StreetImageryConfig;
+export declare const setStreetImageryConfig: (config: StreetImageryConfig) => void;
+export declare const getStreetImageryConfig: () => StreetImageryConfig;

package/dist/data/geojson.d.ts

@@ -0,0 +1,7 @@
+import type { FeatureCollection, LineString, MultiLineString, Point } from 'geojson';
+import type { NormalizedMapFeature, NormalizedPhoto, NormalizedSequence } from '../providers/model';
+export declare const photosToFeatureCollection: (photos: NormalizedPhoto[]) => FeatureCollection<Point>;
+export declare const mapFeaturesToFeatureCollection: (features: NormalizedMapFeature[]) => FeatureCollection<Point>;
+export declare const sequencesToFeatureCollection: (sequences: NormalizedSequence[]) => FeatureCollection<LineString | MultiLineString>;
+export declare const emptyPointCollection: () => FeatureCollection<Point>;
+export declare const emptyLineCollection: () => FeatureCollection<LineString | MultiLineString>;

package/dist/filters/searchFilters.d.ts

@@ -0,0 +1,19 @@
+import type { ExpressionSpecification } from 'maplibre-gl';
+import type { NormalizedMapFeature, NormalizedPhoto } from '../providers/model';
+export type PhotoTypeFilter = 'flat' | 'pano';
+export type DateRange = {
+    from?: string;
+    to?: string;
+};
+export declare const parseIsoDateStartMs: (isoDate: string) => number;
+export declare const parseIsoDateEndMs: (isoDate: string) => number;
+/** iD edge case: swap when from > to. */
+export declare const normalizeDateRange: (date?: DateRange) => DateRange | undefined;
+export declare const photoTypesFilter: (photoTypes?: PhotoTypeFilter[]) => PhotoTypeFilter[] | undefined;
+export declare const photoMatchesPhotoTypes: (photo: NormalizedPhoto, photoTypes?: PhotoTypeFilter[]) => boolean;
+export declare const photoMatchesDateRange: (photo: NormalizedPhoto, date?: DateRange) => boolean;
+export declare const photoMatchesFilters: (photo: NormalizedPhoto, photoTypes?: PhotoTypeFilter[], date?: DateRange) => boolean;
+/** Map features use iD date semantics: last_seen_at >= from; first_seen_at <= to. */
+export declare const mapFeatureMatchesDateRange: (feature: NormalizedMapFeature, date?: DateRange) => boolean;
+export declare const buildPhotoLayerFilter: (photoTypes?: PhotoTypeFilter[], date?: DateRange) => ExpressionSpecification;
+export declare const buildMapFeatureLayerFilter: (date?: DateRange) => ExpressionSpecification;

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { createStreetImageryConfig, getStreetImageryConfig, setStreetImageryConfig, type StreetImageryConfig, } from './config';
+export * from './data/geojson';
+export { buildMapFeatureLayerFilter, buildPhotoLayerFilter, mapFeatureMatchesDateRange, normalizeDateRange, parseIsoDateEndMs, parseIsoDateStartMs, photoMatchesDateRange, photoMatchesFilters, photoMatchesPhotoTypes, photoTypesFilter, type DateRange, type PhotoTypeFilter, } from './filters/searchFilters';
+export { coneRadiusMeters, viewConeGeoJson } from './map/viewCone';
+export { emptyPolygonCollection, FLAT_VIEWFIELD_FOV_DEG, flatViewfieldTriangle, PANO_VIEWFIELD_FOV_DEG, photosToViewfieldsFeatureCollection, type ViewfieldPhotoProps, } from './map/viewfields';
+export * from './providers/model';
+export * from './providers/registry';
+export { fetchMapillaryMvtTiles, mapillaryTileUrl, pointLngLat } from './providers/mapillaryShared';
+export * from './providers/fetchMvt';
+export * from './providers/tileCache';
+export * from './providers/tileMath';
+export * from './viewer/clickRadius';
+export * from './viewer/externalLinks';
+export * from './viewer/groupClickedPhotos';
+export * from './viewer/photoThumbnails';
+export { buildStreetsidePreviewUrl } from './viewer/streetsidePreview';
+export { lookAroundDeepLink } from './providers/adapters/lookaround';
+export { fetchStreetViewMetadata, getGoogleMapsApiKey, type StreetViewMetadataResponse, } from './providers/adapters/streetview';