@osm-editor-kit/street-imagery-react 0.1.0-alpha.7 → 0.1.0-alpha.8

package/README.md

@@ -117,10 +117,49 @@ const { data: detections } = useMapillaryImageDetections(photo.photoId, {
 <StreetLevelImageryViewer photo={photo} outlines={detections?.map((d) => ({ id: d.id, outline: d.outline }))} … />
 ```
 
-- Map layers: `filter.mapFeatureValue` limits which signs/objects are drawn (`matchesAnyGroup(SIGN_GROUPS)`).
+- Map layers: `filter.mapFeatureValue` limits which signs/objects are drawn: `signGroupFilter(['parking', 'bike'])` for sign groups, or `matchesAnyGroup(…)`.
 - Suggested views: `useViewSuggestions(viewpoints, { sources: [mapillaryPhotoSource, streetViewPhotoSource] })`.
 - `turnMapillaryViewerTo` / `setMapillaryViewerOutlines` work on a mapillary-js `Viewer` you own.
 
+## A selected sign: viewer, bar and map highlight
+
+Keep the selected sign (`featureId`) and its shown photo in your own state or URL:
+
+```tsx
+const { data, shownImage, firstImage } = useSelectedMapillaryFeature({
+  featureId,
+  shownPhotoId, // the photo the viewer shows now
+  minCapturedAt: fromMs, // optional: open the best photo from this time on
+})
+// Open `firstImage` first: showPhoto(targetImageToPhoto(firstImage))
+<MapillaryFeatureBar data={data} shownImage={shownImage} onShow={(image) => showPhoto(targetImageToPhoto(image))} />
+<StreetLevelImageryViewer lookAt={{ lngLat: data.feature.lngLat, outline: shownImage?.outline, value: data.feature.value }} … />
+// On the map, after StreetLevelImagerySourcesAndLayers: the sign's halo and a line from the camera
+<SelectedMapFeatureLayer data={data} shownImage={shownImage} providers={providers} bbox={bbox} zoom={zoom} />
+```
+
+A click on a sign dot: `queryStreetImageryFeatures(event).find((hit) => hit.kind === 'mapFeature')?.featureId`.
+
+## Date filter with a slider
+
+`PhotoDateRangeFilter` is the date filter of iD's photo panel as a controlled component: one slider with two handles on a scale that gives recent years more room. It works on plain `{ from?, to? }` days (`YYYY-MM-DD`), the same `DateRange` the layers take as `filter.date`.
+
+```tsx
+const { photos } = useAllProviderPhotos(providers, bbox, zoom) // no date: all photos in view
+
+<PhotoDateRangeFilter
+  value={date}
+  onChange={setDate} // on release of a handle, not while dragging
+  capturedAt={photos.map((photo) => photo.capturedAt)} // marks: where photos are
+  yearLines={[1, 2, 3, 4]} // lines with a label; a click shows the last N years
+  recommendedMaxAgeYears={2} // this line is red
+  markers={[{ date: '2024-04-01', label: 'Survey start' }]} // dashed lines for fixed dates
+  dateInputs="collapsed" // exact days: 'collapsed' (default), 'open' or 'none'
+/>
+```
+
+A handle at its end means no limit, so the left end also shows photos older than the slider spans (`maxYears`, default 10). The scale itself is in the core package (`dateSliderPosition`, `dateSliderBins`, …) for a host that draws its own chart. The texts are in `messages.dateFilter`.
+
 ## Pick a place on the map to open elsewhere
 
 A button arms a location opener (see `@osm-editor-kit/street-imagery`), the next map click opens the clicked place in that service and disarms; Escape cancels.

package/dist/{chunk-EE7V3OIZ.js → chunk-ZAIXGYAH.js}

@@ -18,6 +18,21 @@ var en = {
     nextPhotoOfView: (label) => `${label} \u2014 click for the next photo`
   },
   unknownDate: "Unknown date",
+  dateFilter: {
+    allDates: "All dates",
+    since: (date) => `Since ${date}`,
+    until: (date) => `Until ${date}`,
+    between: (from, to) => `${from} \u2013 ${to}`,
+    yearsShort: (years) => `${years} y`,
+    lastYears: (years) => years === 1 ? "Show the last year" : `Show the last ${years} years`,
+    recommendedMaxAge: (years) => `Recommended: photos of the last ${years === 1 ? "year" : `${years} years`}`,
+    fromHandle: "Oldest photos to show",
+    toHandle: "Newest photos to show",
+    exactDates: "Exact dates",
+    from: "From",
+    to: "To",
+    photoCount: (count) => count === 1 ? "1 photo" : `${count} photos`
+  },
   viewpointRole: {
     here: "Here",
     "line-start": "Start",
@@ -59,6 +74,21 @@ var de = {
     nextPhotoOfView: (label) => `${label} \u2014 klicken f\xFCr das n\xE4chste Foto`
   },
   unknownDate: "Datum unbekannt",
+  dateFilter: {
+    allDates: "Alle Daten",
+    since: (date) => `Seit ${date}`,
+    until: (date) => `Bis ${date}`,
+    between: (from, to) => `${from} \u2013 ${to}`,
+    yearsShort: (years) => `${years} J.`,
+    lastYears: (years) => years === 1 ? "Das letzte Jahr zeigen" : `Die letzten ${years} Jahre zeigen`,
+    recommendedMaxAge: (years) => `Empfohlen: Fotos ${years === 1 ? "des letzten Jahres" : `der letzten ${years} Jahre`}`,
+    fromHandle: "\xC4lteste Fotos, die gezeigt werden",
+    toHandle: "Neueste Fotos, die gezeigt werden",
+    exactDates: "Genaue Daten",
+    from: "Von",
+    to: "Bis",
+    photoCount: (count) => count === 1 ? "1 Foto" : `${count} Fotos`
+  },
   viewpointRole: {
     here: "Hier",
     "line-start": "Anfang",
@@ -95,6 +125,7 @@ var DEFAULT_I18N = {
 var I18nContext = createContext(DEFAULT_I18N);
 var mergeMessages = (base, overrides) => overrides ? {
   unknownDate: overrides.unknownDate ?? base.unknownDate,
+  dateFilter: { ...base.dateFilter, ...overrides.dateFilter },
   viewer: { ...base.viewer, ...overrides.viewer },
   viewpointRole: { ...base.viewpointRole, ...overrides.viewpointRole },
   compass: overrides.compass?.length === 8 ? overrides.compass : base.compass,

package/dist/filters/PhotoDateRangeFilter.d.ts

@@ -0,0 +1,41 @@
+import { type DateRange } from '@osm-editor-kit/street-imagery';
+/** A fixed date to show in the chart, e.g. the start of a project or of a survey. */
+export type PhotoDateMarker = {
+    /** A day as `YYYY-MM-DD`, or a time (ms). */
+    date: string | number;
+    label: string;
+    /** CSS color of line and label. Default red. */
+    color?: string;
+};
+export type PhotoDateRangeFilterProps = {
+    /** The chosen range, days as `YYYY-MM-DD`. No `from` and no `to`: all dates. */
+    value: DateRange;
+    /** Called when a handle is released, a year label is clicked or a date input changes. */
+    onChange: (range: DateRange) => void;
+    /**
+     * Capture times (ms) of the photos to show as marks above the slider, usually all photos in
+     * view before the date filter. Without it there are no marks.
+     */
+    capturedAt?: Iterable<number | null | undefined>;
+    /** Lines with a label at these ages in years; a click on a label shows that many years. */
+    yearLines?: readonly number[];
+    /** Its line is red; added to `yearLines` when it is not one of them. */
+    recommendedMaxAgeYears?: number;
+    markers?: readonly PhotoDateMarker[];
+    /** Years the slider spans. Default 10. */
+    maxYears?: number;
+    /** Reference time (ms). Default: the time of the first render. */
+    now?: number;
+    /**
+     * The two date inputs for exact days, in sync with the slider: folded away (default), open,
+     * or left out.
+     */
+    dateInputs?: 'collapsed' | 'open' | 'none';
+    className?: string;
+};
+/**
+ * Date filter for photos after iD's photo age slider: one slider with two handles on a scale that
+ * gives recent years more room, marks that show how many photos there are at each time, lines at
+ * whole years, and optional fixed markers. Controlled: `value` in, `onChange` out.
+ */
+export declare const PhotoDateRangeFilter: ({ value, onChange, capturedAt, yearLines, recommendedMaxAgeYears, markers, maxYears, now: nowProp, dateInputs, className, }: PhotoDateRangeFilterProps) => import("react").JSX.Element;

package/dist/i18n/messages.d.ts

@@ -21,6 +21,24 @@ export type StreetImageryMessages = {
     /** Eight compass points, clockwise from north: N, NE, E, SE, S, SW, W, NW. */
     compass: readonly string[];
     unknownDate: string;
+    dateFilter: {
+        allDates: string;
+        /** e.g. "Since 5 Oct 2024". */
+        since: (date: string) => string;
+        until: (date: string) => string;
+        between: (from: string, to: string) => string;
+        /** Short label below a year line, e.g. "2 y". */
+        yearsShort: (years: number) => string;
+        /** Tooltip of a year label; a click shows the photos of the last `years` years. */
+        lastYears: (years: number) => string;
+        recommendedMaxAge: (years: number) => string;
+        fromHandle: string;
+        toHandle: string;
+        exactDates: string;
+        from: string;
+        to: string;
+        photoCount: (count: number) => string;
+    };
     /** e.g. "Start, looking along the street"; `role` is the viewpoint's label. */
     viewDirection: (role: string, kind: ViewDirection['kind']) => string;
 };

package/dist/index.d.ts

@@ -21,9 +21,11 @@ export { mapillaryViewFor, setMapillaryViewerOutlines, turnMapillaryViewerTo, ty
 export * from './mapillary/useMapillaryFeatures';
 export { LocationPickOnMap, type LocationPickOnMapProps } from './openers/LocationPickOnMap';
 export * from './openers/useLocationPickStore';
+export { SelectedMapFeatureLayer, type SelectedMapFeatureLayerProps, } from './mapillary/SelectedMapFeatureLayer';
 export { MapillaryFeatureBar, type MapillaryFeatureBarProps } from './mapillary/MapillaryFeatureBar';
 export { MAPILLARY_FEATURE_BAR_LABELS, type MapillaryFeatureBarLabels, } from './mapillary/featureBarLabels';
 export { STREET_IMAGERY_MESSAGES, type StreetImageryMessages } from './i18n/messages';
 export { StreetImageryLocaleProvider, useStreetImageryI18n, type StreetImageryMessageOverrides, } from './i18n/StreetImageryLocaleProvider';
+export { PhotoDateRangeFilter, type PhotoDateMarker, type PhotoDateRangeFilterProps, } from './filters/PhotoDateRangeFilter';
 export { PhotoDate } from './i18n/PhotoDate';
 export { PhotoCount } from './i18n/PhotoCount';

package/dist/index.js

@@ -1,9 +1,9 @@
-import { useStreetImageryI18n } from './chunk-EE7V3OIZ.js';
-export { STREET_IMAGERY_MESSAGES, StreetImageryLocaleProvider, useStreetImageryI18n } from './chunk-EE7V3OIZ.js';
+import { useStreetImageryI18n } from './chunk-ZAIXGYAH.js';
+export { STREET_IMAGERY_MESSAGES, StreetImageryLocaleProvider, useStreetImageryI18n } from './chunk-ZAIXGYAH.js';
 export { MapillaryPanel, mapillaryViewFor, setMapillaryViewerOutlines, turnMapillaryViewerTo } from './chunk-53RA4OSJ.js';
 export { PanoramaxPanel } from './chunk-EQ2JKLGT.js';
 export { useViewerActions, useViewerBearing, useViewerHfov, useViewerLngLat } from './chunk-25UGGXIE.js';
-import { distanceMeters, sequencesToFeatureCollection, emptyLineCollection, adapterById, providerById, providerCoversBbox, viewConeGeoJson, viewShapeRadiusMeters, setStreetImageryConfig, viewfieldLayerId, photoLayerId, featureLayerId, PROVIDER_IDS, mapFeatureMatchesDateRange, isBrowserAvailableProvider, photoMatchesFilters, resolvePhotoPanoramaUrl, photoFullUrlQueryKey, resolvePhotoThumbnailUrl, photoThumbnailQueryKey, formatLocalDateTime, formatMonth, formatRelativeDate, formatDateTooltip, mapillaryPhotoSource, buildViewSuggestions, yearsToMs, SIGN_TARGET, fetchMapFeatureImages, fetchMapillaryMapFeaturesInBbox, bboxAround, fetchImageDetections, findLocationOpener, mapillaryValueName, mapillaryIconUrl, openLocationInNewTab, alignLineToPoints, coneRadiusMeters, mapFeaturesToFeatureCollection, emptyPointCollection, buildMapFeatureLayerFilter, featureSourceId, photosToFeatureCollection, photosToViewfieldsFeatureCollection, emptyPolygonCollection, buildPhotoLayerFilter, photoSourceId, viewfieldSourceId, sequenceSourceId, sequenceLayerId, viewfieldLineLayerId, VIEWFIELD_MIN_ZOOM } from '@osm-editor-kit/street-imagery';
+import { distanceMeters, sequencesToFeatureCollection, emptyLineCollection, adapterById, providerById, providerCoversBbox, viewConeGeoJson, viewShapeRadiusMeters, setStreetImageryConfig, viewfieldLayerId, photoLayerId, featureLayerId, PROVIDER_IDS, mapFeatureMatchesDateRange, isBrowserAvailableProvider, photoMatchesFilters, resolvePhotoPanoramaUrl, photoFullUrlQueryKey, resolvePhotoThumbnailUrl, photoThumbnailQueryKey, formatLocalDateTime, formatMonth, formatRelativeDate, formatDateTooltip, mapillaryPhotoSource, buildViewSuggestions, yearsToMs, SIGN_TARGET, fetchMapFeatureImages, fetchMapillaryMapFeaturesInBbox, bboxAround, fetchImageDetections, bestTargetImage, findLocationOpener, MAP_FEATURE_COLOR, mapillaryValueName, mapillaryIconUrl, dateRangeToSliderPositions, sliderPositionsToDateRange, dateSliderBins, dateSliderPosition, yearsAgoMs, parseIsoDateStartMs, openLocationInNewTab, formatDate, isIsoDate, alignLineToPoints, coneRadiusMeters, mapFeaturesToFeatureCollection, emptyPointCollection, buildMapFeatureLayerFilter, featureSourceId, photosToFeatureCollection, photosToViewfieldsFeatureCollection, emptyPolygonCollection, buildPhotoLayerFilter, photoSourceId, viewfieldSourceId, sequenceSourceId, sequenceLayerId, viewfieldLineLayerId, VIEWFIELD_MIN_ZOOM } from '@osm-editor-kit/street-imagery';
 import { Source, Layer, useMap } from 'react-map-gl/maplibre';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { lazy, useEffect, Fragment as Fragment$1, Suspense, useState, useRef, useEffectEvent } from 'react';
@@ -1484,6 +1484,20 @@ var useMapillaryImageDetections = (imageId, { filter, filterKey } = {}) => useQu
   enabled: !!imageId,
   staleTime: STALE_TIME
 });
+var useSelectedMapillaryFeature = ({
+  featureId,
+  shownPhotoId,
+  minCapturedAt,
+  shape
+}) => {
+  const { data, isLoading, isError } = useMapillaryMapFeatureImages(featureId, { shape });
+  const shownImage = data?.images.find((image) => image.id === shownPhotoId) ?? null;
+  const firstImage = data ? bestTargetImage(data.images, data.feature.lngLat, {
+    minCapturedAt: minCapturedAt ?? void 0,
+    shape
+  }) ?? null : null;
+  return { data: data ?? null, isLoading, isError, shownImage, firstImage };
+};
 var useLocationPickStore = create()((set) => ({
   armedOpenerId: null,
   actions: {
@@ -1535,6 +1549,70 @@ var LocationPickOnMap = ({ onPick }) => {
   );
   return null;
 };
+var SelectedMapFeatureLayer = ({
+  data,
+  shownImage,
+  providers,
+  bbox,
+  zoom,
+  color = MAP_FEATURE_COLOR
+}) => {
+  const drawnFeatures = useAllProviderMapFeatures(providers, bbox, zoom);
+  const target = data ? drawnFeatures.find((feature) => feature.featureId === data.feature.id)?.lngLat ?? data.feature.lngLat : null;
+  const camera = shownImage?.lngLat;
+  const points = {
+    type: "FeatureCollection",
+    features: target ? [{ type: "Feature", properties: {}, geometry: { type: "Point", coordinates: target } }] : []
+  };
+  const line = {
+    type: "FeatureCollection",
+    features: target && camera ? [
+      {
+        type: "Feature",
+        properties: {},
+        geometry: { type: "LineString", coordinates: [camera, target] }
+      }
+    ] : []
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Source, { data: line, id: "selected-map-feature-line", type: "geojson" }),
+    /* @__PURE__ */ jsx(
+      Layer,
+      {
+        id: "selected-map-feature-line",
+        paint: { "line-color": SELECTION_COLOR, "line-width": 1.5, "line-dasharray": [2, 1.5] },
+        source: "selected-map-feature-line",
+        type: "line"
+      }
+    ),
+    /* @__PURE__ */ jsx(Source, { data: points, id: "selected-map-feature-point", type: "geojson" }),
+    /* @__PURE__ */ jsx(
+      Layer,
+      {
+        id: "selected-map-feature-disk",
+        paint: {
+          "circle-radius": 17,
+          "circle-color": color,
+          "circle-opacity": VIEW_SHAPE_FILL_OPACITY
+        },
+        source: "selected-map-feature-point",
+        type: "circle"
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Layer,
+      {
+        id: "selected-map-feature-dot",
+        paint: {
+          "circle-radius": ["interpolate", ["linear"], ["zoom"], 10, 1.8, 14, 3.6, 18, 4.8],
+          "circle-color": color
+        },
+        source: "selected-map-feature-point",
+        type: "circle"
+      }
+    )
+  ] });
+};
 var MAPILLARY_FEATURE_BAR_LABELS = {
   en: {
     name: (value) => mapillaryValueName(value, "en"),
@@ -1630,5 +1708,233 @@ ${labels.dayPhotos(day.images.length, active && day.images.length > 1)}`,
     )
   ] });
 };
+var DEFAULT_YEAR_LINES = [1, 2, 3, 4];
+var BINS = 60;
+var STEP = 1e-3;
+var CHART_HEIGHT_PX = 36;
+var RED = "#dc2626";
+var HANDLE_CLASS = "pointer-events-none absolute inset-0 m-0 h-full w-full cursor-pointer appearance-none bg-transparent focus:outline-none [&::-webkit-slider-runnable-track]:appearance-none [&::-webkit-slider-runnable-track]:bg-transparent [&::-moz-range-track]:bg-transparent [&::-webkit-slider-thumb]:pointer-events-auto [&::-webkit-slider-thumb]:size-4 [&::-webkit-slider-thumb]:cursor-grab [&::-webkit-slider-thumb]:appearance-none [&::-webkit-slider-thumb]:rounded-full [&::-webkit-slider-thumb]:border-2 [&::-webkit-slider-thumb]:border-white [&::-webkit-slider-thumb]:bg-slate-800 [&::-webkit-slider-thumb]:shadow [&::-moz-range-thumb]:pointer-events-auto [&::-moz-range-thumb]:box-border [&::-moz-range-thumb]:size-4 [&::-moz-range-thumb]:cursor-grab [&::-moz-range-thumb]:rounded-full [&::-moz-range-thumb]:border-2 [&::-moz-range-thumb]:border-white [&::-moz-range-thumb]:bg-slate-800 [&::-moz-range-thumb]:shadow focus-visible:[&::-webkit-slider-thumb]:ring-2 focus-visible:[&::-webkit-slider-thumb]:ring-sky-500 focus-visible:[&::-moz-range-thumb]:ring-2 focus-visible:[&::-moz-range-thumb]:ring-sky-500";
+var percent = (position) => `${position * 100}%`;
+var PhotoDateRangeFilter = ({
+  value,
+  onChange,
+  capturedAt,
+  yearLines = DEFAULT_YEAR_LINES,
+  recommendedMaxAgeYears,
+  markers = [],
+  maxYears,
+  now: nowProp,
+  dateInputs = "collapsed",
+  className
+}) => {
+  const { locale, messages } = useStreetImageryI18n();
+  const text = messages.dateFilter;
+  const [startNow] = useState(() => Date.now());
+  const now = nowProp ?? startNow;
+  const scale = { now, maxYears };
+  const [dragged, setDragged] = useState(null);
+  const fromInput = useRef(null);
+  const toInput = useRef(null);
+  const positions = dragged ?? dateRangeToSliderPositions(value, scale);
+  const shownRange = dragged ? sliderPositionsToDateRange(dragged, scale) : value;
+  const readPositions = (moved) => {
+    const from = Number(fromInput.current?.value ?? positions.from);
+    const to = Number(toInput.current?.value ?? positions.to);
+    return moved === "from" ? { from: Math.min(from, to), to } : { from, to: Math.max(from, to) };
+  };
+  const commitOnRelease = (moved) => (input) => {
+    if (!input) {
+      return void 0;
+    }
+    const commit = () => {
+      setDragged(null);
+      const next = sliderPositionsToDateRange(readPositions(moved), scale);
+      const other = moved === "from" ? "to" : "from";
+      onChange({ ...next, [other]: value[other] });
+    };
+    input.addEventListener("change", commit);
+    return () => {
+      input.removeEventListener("change", commit);
+    };
+  };
+  const trackDrag = (moved, event) => {
+    if (event.type === "input") {
+      setDragged(readPositions(moved));
+    }
+  };
+  const bins = capturedAt ? dateSliderBins(capturedAt, scale, BINS) : [];
+  const maxCount = Math.max(1, ...bins);
+  const years = [
+    ...new Set(recommendedMaxAgeYears ? [...yearLines, recommendedMaxAgeYears] : yearLines)
+  ].map((count) => ({ count, position: dateSliderPosition(yearsAgoMs(count, now), scale) })).filter(({ position }) => position > 0 && position < 1);
+  const shownMarkers = markers.map((marker) => {
+    const time = typeof marker.date === "number" ? marker.date : parseIsoDateStartMs(marker.date);
+    return { ...marker, position: dateSliderPosition(time, scale) };
+  }).filter(({ position }) => position > 0 && position < 1);
+  const day = (isoDate) => formatDate(parseIsoDateStartMs(isoDate), locale);
+  const rangeLabel = shownRange.from && shownRange.to ? text.between(day(shownRange.from), day(shownRange.to)) : shownRange.from ? text.since(day(shownRange.from)) : shownRange.to ? text.until(day(shownRange.to)) : text.allDates;
+  const setYears = (count) => {
+    onChange({ from: new Date(yearsAgoMs(count, now)).toISOString().slice(0, 10) });
+  };
+  const setDay = (key, input) => {
+    if (input === "") {
+      onChange({ ...value, [key]: void 0 });
+    } else if (isIsoDate(input)) {
+      onChange({ ...value, [key]: input });
+    }
+  };
+  const isAllDates = !shownRange.from && !shownRange.to;
+  return /* @__PURE__ */ jsxs("div", { className, children: [
+    /* @__PURE__ */ jsx("div", { className: "mx-2", children: /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "relative",
+        style: { height: CHART_HEIGHT_PX, marginTop: shownMarkers.length > 0 ? 14 : 0 },
+        children: [
+          /* @__PURE__ */ jsx("div", { "aria-hidden": true, className: "absolute inset-0 flex items-end", children: bins.map((count, index) => {
+            const start = index / BINS;
+            const inRange = start + 1 / BINS > positions.from && start < positions.to;
+            return /* @__PURE__ */ jsx(
+              "div",
+              {
+                className: `flex-1 rounded-t-[1px] ${inRange ? "bg-slate-500" : "bg-slate-300"}`,
+                style: {
+                  height: count === 0 ? 0 : Math.max(2, Math.sqrt(count / maxCount) * CHART_HEIGHT_PX)
+                },
+                title: count > 0 ? text.photoCount(count) : void 0
+              },
+              index
+            );
+          }) }),
+          years.map(({ count, position }) => /* @__PURE__ */ jsx(
+            "div",
+            {
+              "aria-hidden": true,
+              className: "pointer-events-none absolute inset-y-0 w-px -translate-x-1/2",
+              style: {
+                left: percent(position),
+                backgroundColor: count === recommendedMaxAgeYears ? RED : "rgb(148 163 184 / 0.7)"
+              }
+            },
+            count
+          )),
+          shownMarkers.map((marker) => /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: "pointer-events-none absolute inset-y-0 w-0 border-l-2 border-dashed",
+              style: { left: percent(marker.position), borderColor: marker.color ?? RED },
+              children: /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: "absolute -top-3.5 -translate-x-1/2 text-[10px] leading-none whitespace-nowrap",
+                  style: { color: marker.color ?? RED },
+                  children: marker.label
+                }
+              )
+            },
+            `${marker.date}-${marker.label}`
+          ))
+        ]
+      }
+    ) }),
+    /* @__PURE__ */ jsxs("div", { className: "relative h-4", children: [
+      /* @__PURE__ */ jsx("div", { className: "absolute inset-x-2 top-1/2 h-1 -translate-y-1/2 rounded-full bg-slate-200", children: /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: "absolute inset-y-0 rounded-full bg-slate-700",
+          style: {
+            left: percent(positions.from),
+            right: percent(1 - positions.to)
+          }
+        }
+      ) }),
+      /* @__PURE__ */ jsx(
+        "input",
+        {
+          "aria-label": text.fromHandle,
+          "aria-valuetext": shownRange.from ? day(shownRange.from) : text.allDates,
+          className: HANDLE_CLASS,
+          max: 1,
+          min: 0,
+          onChange: (event) => {
+            trackDrag("from", event.nativeEvent);
+          },
+          ref: (input) => {
+            fromInput.current = input;
+            return commitOnRelease("from")(input);
+          },
+          step: STEP,
+          type: "range",
+          value: positions.from
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        "input",
+        {
+          "aria-label": text.toHandle,
+          "aria-valuetext": shownRange.to ? day(shownRange.to) : text.allDates,
+          className: HANDLE_CLASS,
+          max: 1,
+          min: 0,
+          onChange: (event) => {
+            trackDrag("to", event.nativeEvent);
+          },
+          ref: (input) => {
+            toInput.current = input;
+            return commitOnRelease("to")(input);
+          },
+          step: STEP,
+          type: "range",
+          value: positions.to
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "relative mx-2 h-4", children: years.map(({ count, position }) => /* @__PURE__ */ jsx(
+      "button",
+      {
+        className: `absolute top-0 -translate-x-1/2 rounded px-0.5 text-[10px] leading-4 whitespace-nowrap hover:underline ${count === recommendedMaxAgeYears ? "font-semibold text-red-600" : "text-slate-500 hover:text-slate-900"}`,
+        onClick: () => {
+          setYears(count);
+        },
+        style: { left: percent(position) },
+        title: count === recommendedMaxAgeYears ? text.recommendedMaxAge(count) : text.lastYears(count),
+        type: "button",
+        children: text.yearsShort(count)
+      },
+      count
+    )) }),
+    /* @__PURE__ */ jsxs("div", { className: "mt-1 flex items-baseline justify-between gap-2 text-xs", children: [
+      /* @__PURE__ */ jsx("span", { className: "font-medium text-slate-700", children: rangeLabel }),
+      isAllDates ? null : /* @__PURE__ */ jsx(
+        "button",
+        {
+          className: "shrink-0 font-medium text-slate-600 underline decoration-slate-300 underline-offset-2 hover:text-slate-900",
+          onClick: () => {
+            onChange({});
+          },
+          type: "button",
+          children: text.allDates
+        }
+      )
+    ] }),
+    dateInputs === "none" ? null : /* @__PURE__ */ jsxs("details", { className: "mt-1 text-xs text-slate-600", open: dateInputs === "open" || void 0, children: [
+      /* @__PURE__ */ jsx("summary", { className: "cursor-pointer select-none hover:text-slate-900", children: text.exactDates }),
+      /* @__PURE__ */ jsx("div", { className: "mt-1.5 grid grid-cols-2 gap-2", children: ["from", "to"].map((key) => /* @__PURE__ */ jsxs("label", { className: "flex flex-col gap-1", children: [
+        text[key],
+        /* @__PURE__ */ jsx(
+          "input",
+          {
+            className: "rounded-md border border-slate-200 px-2 py-1.5 text-sm text-slate-800",
+            onChange: (event) => {
+              setDay(key, event.target.value);
+            },
+            type: "date",
+            value: value[key] ?? ""
+          }
+        )
+      ] }, key)) })
+    ] })
+  ] });
+};
 
-export { BASE_COLOR, FloatingPhotoViewer, FloatingViewerInfoButton, LocationPickOnMap, MAPILLARY_FEATURE_BAR_LABELS, MapillaryFeatureBar, PhotoCount, PhotoDate, SELECTION_COLOR, StreetLevelImagerySelectionOverlay, StreetLevelImagerySourcesAndLayers, StreetLevelImageryViewCone, StreetLevelImageryViewer, VIEWPOINT_DEFAULT_COLOR, VIEWPOINT_DIRECTION_LAYER_ID, VIEW_SHAPE_FILL_OPACITY, ViewpointLayer, getViewpointSession, queryStreetImageryFeatures, resolveSelectedSequence, streetImageryInteractiveLayerIds, useActiveDirectionKey, useAllProviderMapFeatures, useAllProviderPhotos, useArmedLocationOpenerId, useCanGoBack, useCanGoForward, useCurrentHistoryEntry, useLocationPickActions, useMapViewportBbox, useMapillaryImageDetections, useMapillaryMapFeatureImages, useMapillaryMapFeaturesNear, usePhotoFullUrl, usePhotoThumbnail, useProviderMapFeatures, useProviderPhotos, useProviderSequences, useViewSuggestions, useViewpointLine, useViewpoints, viewDirectionKeyFromFeatures, viewSuggestionLabel };
+export { BASE_COLOR, FloatingPhotoViewer, FloatingViewerInfoButton, LocationPickOnMap, MAPILLARY_FEATURE_BAR_LABELS, MapillaryFeatureBar, PhotoCount, PhotoDate, PhotoDateRangeFilter, SELECTION_COLOR, SelectedMapFeatureLayer, StreetLevelImagerySelectionOverlay, StreetLevelImagerySourcesAndLayers, StreetLevelImageryViewCone, StreetLevelImageryViewer, VIEWPOINT_DEFAULT_COLOR, VIEWPOINT_DIRECTION_LAYER_ID, VIEW_SHAPE_FILL_OPACITY, ViewpointLayer, getViewpointSession, queryStreetImageryFeatures, resolveSelectedSequence, streetImageryInteractiveLayerIds, useActiveDirectionKey, useAllProviderMapFeatures, useAllProviderPhotos, useArmedLocationOpenerId, useCanGoBack, useCanGoForward, useCurrentHistoryEntry, useLocationPickActions, useMapViewportBbox, useMapillaryImageDetections, useMapillaryMapFeatureImages, useMapillaryMapFeaturesNear, usePhotoFullUrl, usePhotoThumbnail, useProviderMapFeatures, useProviderPhotos, useProviderSequences, useSelectedMapillaryFeature, useViewSuggestions, useViewpointLine, useViewpoints, viewDirectionKeyFromFeatures, viewSuggestionLabel };

package/dist/mapillary/SelectedMapFeatureLayer.d.ts

@@ -0,0 +1,19 @@
+import { type Bbox, type MapFeatureImages, type ProviderId, type TargetImage } from '@osm-editor-kit/street-imagery';
+export type SelectedMapFeatureLayerProps = {
+    /** From `useSelectedMapillaryFeature`. Nothing is drawn without it. */
+    data: MapFeatureImages | null;
+    /** The shown photo of the feature: a dotted line runs from its camera to the feature. */
+    shownImage?: TargetImage | null;
+    /** The providers whose map features are drawn, to ring the dot that is on the map. */
+    providers: ProviderId[];
+    bbox: Bbox | null;
+    zoom: number;
+    /** Color of the dot and disk. Default: the map features' purple. */
+    color?: string;
+};
+/**
+ * The selected sign or object on the map: its dot on a light disk, and a dotted line to it from
+ * the camera position of the shown photo (Mapillary's computed position, which the feature was
+ * located from). Draw it after `StreetLevelImagerySourcesAndLayers`.
+ */
+export declare const SelectedMapFeatureLayer: ({ data, shownImage, providers, bbox, zoom, color, }: SelectedMapFeatureLayerProps) => import("react").JSX.Element;

package/dist/mapillary/useMapillaryFeatures.d.ts

@@ -34,3 +34,21 @@ export declare const useMapillaryImageDetections: (imageId: string | null | unde
     filter?: (value: string) => boolean;
     filterKey?: string;
 }) => import("@tanstack/react-query").UseQueryResult<NoInfer<import("@osm-editor-kit/street-imagery").MapillaryDetection[]>, Error>;
+/**
+ * A selected Mapillary map feature (sign, object) for a host's feature + photo selection: all its
+ * photos by day, the photo that is shown (`shownPhotoId`), and the one to open first — the best of
+ * the newest day, from within `minCapturedAt` (ms) when set. Feed `data` and `shownImage` to
+ * `MapillaryFeatureBar` and `SelectedMapFeatureLayer`, and `shownImage.outline` to `lookAt`.
+ */
+export declare const useSelectedMapillaryFeature: ({ featureId, shownPhotoId, minCapturedAt, shape, }: {
+    featureId: string | null | undefined;
+    shownPhotoId?: string | null;
+    minCapturedAt?: number | null;
+    shape?: TargetShape;
+}) => {
+    data: NonNullable<NoInfer<import("@osm-editor-kit/street-imagery").MapFeatureImages | null>> | null;
+    isLoading: boolean;
+    isError: boolean;
+    shownImage: import("@osm-editor-kit/street-imagery").TargetImage | null;
+    firstImage: import("@osm-editor-kit/street-imagery").TargetImage | null;
+};

package/dist/photo-details.js

@@ -1,4 +1,4 @@
-import { useStreetImageryI18n } from './chunk-EE7V3OIZ.js';
+import { useStreetImageryI18n } from './chunk-ZAIXGYAH.js';
 import { providerById, formatLocalDateTime, formatDate, formatRelativeDate } from '@osm-editor-kit/street-imagery';
 import { useRef, useEffect } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osm-editor-kit/street-imagery-react",
-  "version": "0.1.0-alpha.7",
+  "version": "0.1.0-alpha.8",
   "description": "React MapLibre layers and photo viewers for street-level imagery providers.",
   "homepage": "https://github.com/osmberlin/street-space-editor/tree/main/packages/street-imagery-react",
   "license": "MIT",
@@ -56,7 +56,7 @@
     "zustand": "^5.0.7"
   },
   "peerDependencies": {
-    "@osm-editor-kit/street-imagery": "^0.1.0-alpha.6",
+    "@osm-editor-kit/street-imagery": "^0.1.0-alpha.7",
     "@panoramax/web-viewer": "^5",
     "@tanstack/react-query": "^5",
     "mapillary-js": "^4",