Merge origin/main: Google Street View, KartaView and Panoramax on the slim Street Level

Main gained three imagery providers (Google Street View, KartaView,
Panoramax), shared line-coverage, cone and photo-viewer modules, one source
lit at a time and the translated interface. Their shared modules still
carried what this branch removes, so the merge ports them onto it:

- lineCoverage.js is this branch's coverage.js made provider-neutral
  (draped lines near the ground only, the selection drawn over them, key
  and rate-limit blocking); sequenceCones.js is sequences.js the same way.
  Mapillary, KartaView and Panoramax all build on them; Mapillary moves
  back to providers/mapillary/ beside the others.
- No ground casting, mesh sampling, surface modes, FOLLOW, legend, prewarm,
  orbit overview points (Panoramax's density dots included), stale-tile
  swaps or water-filled point budget come back.
- Kept from main because the new providers need them: requiresMapStack and
  attachMapStackController (Street View on Google 3D only), ground clicks,
  openNearest with an optional provider nearestImage, openImage {frame},
  reportError, the view-cone marker (now an SVG glyph), filters /
  coverageLabel / sinceBasis, OPEN STREET VIEW, keyAlternatives and i18n.
- photoViewer.js treats the viewer as expanded when its wrap is full screen
  or the iPhone popover, as EXPAND now is.
- The fixture browser gate keeps its 8 steps and adds one each for
  KartaView and Panoramax; catalogs, docs, boundaries and format scope
  follow.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

src/layers/streetLevel/policy.js

@@ -1,17 +1,9 @@
-/** Identity and tuning for the Street Level layer and its Mapillary provider. */
-export const STREET_LEVEL_LAYER_ID = 'street-level';
-export const MAPILLARY_PROVIDER_ID = 'mapillary';
-export const MAPILLARY_NAME = 'Mapillary';
-export const MAPILLARY_LABEL = 'MAPILLARY';
-export const MAPILLARY_KEY_ID = 'mapillary';
-export const MAPILLARY_GRAPH_HOST = 'https://graph.mapillary.com';
+// Reached by the providers' source modules (no browser globals, see
+// check:boundaries), so no i18n import: the text stays English data here.
+const msg = (text) => text;
 
-/** What the provider needs from its source (source.js or a stand-in). */
-export const MAPILLARY_SOURCE_METHODS = Object.freeze([
-  'getStatus',
-  'getTile',
-  'getSequenceImages',
-]);
+/** Identity and shared tuning for the provider-neutral Street Level layer. */
+export const STREET_LEVEL_LAYER_ID = 'street-level';
 
 /**
  * The pixel window a click picks in: coverage lines are 2.5 px wide and there
@@ -19,19 +11,19 @@ export const MAPILLARY_SOURCE_METHODS = Object.freeze([
  */
 export const CLICK_PICK_WINDOW_PX = 9;
 
-/** Pick id of the viewer position marker. */
+/** Pick id of the viewer position marker; the core owns it, not a provider. */
 export const POSITION_PICK_ID = 'sl:pos';
 
-/** Stable id prefixes for picked primitives; every one starts with `mly:`. */
-export const PICK_PREFIX = Object.freeze({
-  root: 'mly:',
-  sequence: 'mly:seq:',
-  image: 'mly:img:',
+/** One colour per imagery source: chip, coverage lines and cones. */
+export const PROVIDER_COLORS = Object.freeze({
+  mapillary: '#05cb63',
+  google: '#4285f4',
+  kartaview: '#635bff',
+  panoramax: '#ff6f00',
 });
 
-/** Mapillary green for lines and cones, GEV cyan for the selection, amber for the marker. */
+/** Colours every provider shares: the selection highlight and the marker. */
 export const COLORS = Object.freeze({
-  coverage: '#05cb63',
   selected: '#00d4ff',
   position: '#ffb300',
 });
@@ -42,49 +34,25 @@ export const PANO_MODES = Object.freeze(['all', 'pano', 'flat']);
 /** Longest "captured since" window the filter accepts, in days (~100 years). */
 export const MAX_SINCE_DAYS = 36_500;
 
-/** Filter the layer starts with: all imagery, any date. */
+/** Filter every provider starts with: all imagery, any date. */
 export const FILTER_DEFAULT = Object.freeze({ pano: 'all', sinceDays: 0 });
 
-/** Camera-driven coverage refresh. */
-export const COVERAGE_MOVE_DEBOUNCE_MS = 320;
-export const COVERAGE_MAX_TILES = 9;
-/** Shown when Mapillary refuses the server's token (401/403). */
-export const KEY_REJECTED_MESSAGE =
-  'Mapillary rejected MAPILLARY_CLIENT_TOKEN — replace it in Provider Settings';
-/** Shown while Mapillary rate-limits tile requests (429). */
-export const RATE_LIMITED_MESSAGE =
-  'Coverage requests are being rate-limited — they resume on their own';
-/**
- * Street-zoom coverage reaches this far from the camera: camera height times
- * the factor, never below the floor, even when a tilted view sees further.
- */
-export const SEQUENCE_VIEW_RANGE_MIN_M = 2_500;
-export const SEQUENCE_VIEW_RANGE_PER_HEIGHT = 10;
-export const COVERAGE_MAX_SEQUENCES = 6000;
-export const COVERAGE_LINE_WIDTH_PX = 2.5;
+/** Nearest-image search radius in metres. */
+export const NEAREST_RADIUS_M = 50;
 
-/** Per-sequence image cones after a sequence is selected. */
-export const SEQUENCE_IMAGES_LIMIT = 2000;
-export const IMAGE_CONE_SIZE_PX = 26;
-export const IMAGE_CONE_MIN_SPACING_M = 3;
+/** The Google 3D map stack: Street View may be shown only on it. */
+export const GOOGLE_3D_MAP_STACK_ID = 'photoreal';
 
-/** On-globe credit: Mapillary imagery is CC BY-SA 4.0 and needs attribution. */
-export const MAPILLARY_CREDIT_HTML =
-  'Street Level: imagery © <a href="https://www.mapillary.com" target="_blank" rel="noopener">Mapillary</a> contributors, CC BY-SA 4.0';
+/** Above this, a ground click is a misclick, not a street. */
+export const GROUND_CLICK_MAX_HEIGHT_M = 3_000;
 
-/** Deep link to an image on mapillary.com, as the web app shares them. */
-export function mapillaryImageUrl(imageId) {
-  const id = String(imageId || '').trim();
-  if (!id) return 'https://www.mapillary.com/app/';
-  return `https://www.mapillary.com/app/?pKey=${encodeURIComponent(id)}&focus=photo`;
-}
-
-/** Fields requested for a sequence's images. */
-export const SEQUENCE_IMAGE_FIELDS =
-  'id,captured_at,compass_angle,geometry,is_pano';
+/** English data: the Street Level panel translates it (translateKnown). */
+export const AIM_AT_GROUND_MESSAGE = msg(
+  'Aim the middle of the view at a street to look for imagery there',
+);
 
 /** The key gate's label for the pill and the layer list, or null when the key is fine. */
 export function keyStatusLabel({ keyRequired, keyRejected }) {
-  if (keyRejected) return 'KEY REJECTED';
-  return keyRequired ? 'KEY REQUIRED' : null;
+  if (keyRejected) return msg('KEY REJECTED');
+  return keyRequired ? msg('KEY REQUIRED') : null;
 }