gps-plus-slam-app-framework 1.3.0 → 1.4.0

package/dist/visualization/camera-follower.d.ts

@@ -1,2 +1,2 @@
-import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-C2mwEn7c.js";
+import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-BTb2Yp12.js";
 export { CameraFollower, createCameraFollower };

package/dist/visualization/css3d-renderer-manager.d.ts

@@ -1,2 +1,2 @@
-import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-ptu_t3B3.js";
+import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-m-ab19vp.js";
 export { Css3dRendererManager, createCss3dRendererManager };

package/dist/visualization/frame-conversions.d.ts

@@ -1,2 +1,2 @@
-import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-BfsafGWR.js";
+import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-D_Af8Dt3.js";
 export { nueToArLocal, worldNueToGps };

package/dist/visualization/frustum-visibility.d.ts

@@ -1,2 +1,2 @@
-import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-CmI96ESS.js";
+import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-D_RGmH98.js";
 export { buildCameraFrustum, isObjectInCameraFrustum, isPointInCameraFrustum, isSphereInCameraFrustum };

package/dist/visualization/gps-anchor.d.ts

@@ -1,2 +1,2 @@
-import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-dYeCvvp5.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-C6I9NDHA.js";
 export { GpsAnchor, GpsAnchorMode, GpsAnchorOptions, GpsAnchorPhase, GpsAnchorSamplePoint, createGpsAnchor };

package/dist/visualization/gps-compass-cubes.d.ts

@@ -1,2 +1,2 @@
-import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-BM1uGiYV.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-BExxrWJ-.js";
 export { COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, GpsCompassCubes, createGpsCompassCubes };

package/dist/visualization/gps-event-markers.d.ts

@@ -1,2 +1,2 @@
-import { n as GpsEventVisualizer, r as gpsEventVisualizer, t as GpsEventAccuracy } from "../gps-event-markers-Dc9FT-q1.js";
+import { n as GpsEventVisualizer, r as gpsEventVisualizer, t as GpsEventAccuracy } from "../gps-event-markers-Dd0G2bD0.js";
 export { GpsEventAccuracy, GpsEventVisualizer, gpsEventVisualizer };

package/dist/visualization/gps-event-markers.js

@@ -1,6 +1,6 @@
 import { createLogger } from "../utils/logger.js";
 import { disposeMeshArray } from "./three-dispose.js";
-import { c as getArWorldGroup, m as getScene } from "../webxr-session-TIaD883f.js";
+import { _ as getScene, l as getArWorldGroup } from "../webxr-session-CJF9Nijp.js";
 import { VIS_COLORS } from "./vis-colors.js";
 import * as THREE from "three";
 //#region ../src/visualization/gps-event-markers.ts
@@ -20,10 +20,20 @@ import * as THREE from "three";
 *   world positions update automatically via Three.js scene-graph propagation.
 */
 const log = createLogger("GpsEventVisualizer");
-/** Sphere radius in meters (8cm - smaller than reference point markers) */
-const GPS_MARKER_RADIUS = .08;
-/** Slightly larger radius for alignment snapshots to stand out */
-const SNAPSHOT_MARKER_RADIUS = .1;
+/**
+* Sphere radius in meters for the raw-GPS / fused debug markers.
+*
+* Halved 0.08 → 0.04 (D5, 2026-06-16 user feedback): these "different colours"
+* tracking spheres were cluttering the AR scene and hiding the ref-point
+* markers. They now shrink while the ref-point marker spheres grow (×2), so the
+* marker the user cares about stands out. This is a framework-level constant
+* rendered in BOTH live recording and replay, so replays of older recordings
+* also show the smaller debug spheres — intended and accepted (requester
+* decision); a plain constant change is correct (no live-vs-replay flag).
+*/
+const GPS_MARKER_RADIUS = .04;
+/** Slightly larger radius for alignment snapshots to stand out (halved 0.1 → 0.05 with the GPS markers, D5). */
+const SNAPSHOT_MARKER_RADIUS = .05;
 /**
 * Default opacity for the yellow raw-GPS sphere when it is rendered at the
 * legacy fixed 8 cm radius (no accuracy passed). Matches the original 30 %
@@ -67,6 +77,14 @@ var GpsEventVisualizer = class {
 	eventCounter = 0;
 	snapshotCounter = 0;
 	/**
+	* Whether the debug markers are drawn. Toggled by {@link setVisible} for the
+	* recorder's `visualization.gpsAlignmentMarkers` opt-out (Finding B). Applied
+	* to every marker at creation so events spawned later by the live
+	* store-subscriber inherit the current state instead of popping into view.
+	* Default `true` — the markers render exactly as before until opted out.
+	*/
+	markersVisible = true;
+	/**
 	* Set the GPS zero reference (origin for coordinate conversion).
 	* Must be called before adding GPS events.
 	*
@@ -167,9 +185,25 @@ var GpsEventVisualizer = class {
 		});
 		const mesh = new THREE.Mesh(geometry, material);
 		mesh.name = `${namePrefix}-${eventId}`;
+		mesh.visible = this.markersVisible;
 		return mesh;
 	}
 	/**
+	* Show or hide ALL debug markers — raw GPS (yellow), fused (cyan), and
+	* alignment-snapshot (red) — and remember the state so markers added later
+	* inherit it. Used by the recorder's `visualization.gpsAlignmentMarkers`
+	* opt-out, read once at Enter-AR (live only; replay keeps markers visible).
+	*
+	* This only changes rendering: capture, GPS-event recording, counts, and the
+	* snapshot positions read back at session end are all unaffected.
+	*/
+	setVisible(visible) {
+		this.markersVisible = visible;
+		for (const mesh of this.rawGpsMarkers) mesh.visible = visible;
+		for (const mesh of this.fusedMarkers) mesh.visible = visible;
+		for (const mesh of this.snapshotMarkers) mesh.visible = visible;
+	}
+	/**
 	* Clear all markers from the scene and reset state.
 	*/
 	clearAll() {
@@ -181,6 +215,7 @@ var GpsEventVisualizer = class {
 		this.zeroRef = null;
 		this.eventCounter = 0;
 		this.snapshotCounter = 0;
+		this.markersVisible = true;
 	}
 	/**
 	* Get count of visible markers.

package/dist/visualization/hit-test-reticle.d.ts

@@ -1,2 +1,2 @@
-import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-BEzEybxZ.js";
+import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-Dqak9hiR.js";
 export { HitMatrix, createReticleMesh, updateReticle };

package/dist/visualization/hit-test-reticle.js

@@ -75,6 +75,7 @@ function updateReticle(reticle, matrix) {
 	}
 	hitPoseMatrix.fromArray(matrix);
 	reticle.matrix.multiplyMatrices(WEBXR_TO_NUE, hitPoseMatrix);
+	reticle.matrixWorldNeedsUpdate = true;
 	reticle.visible = true;
 }
 //#endregion

package/dist/visualization/index.d.ts

@@ -1,19 +1,19 @@
-import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-ptu_t3B3.js";
-import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-C2mwEn7c.js";
-import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-Dm9G7JJO.js";
-import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-CkloBxIl.js";
-import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-C9lwwIyI.js";
-import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-BM1uGiYV.js";
-import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-CmI96ESS.js";
-import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-BfsafGWR.js";
-import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-BEzEybxZ.js";
-import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-dYeCvvp5.js";
-import { n as GpsEventVisualizer, r as gpsEventVisualizer } from "../gps-event-markers-Dc9FT-q1.js";
-import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "../leaflet-map-overlay-6CJC-E1l.js";
-import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-BpV-0Dtk.js";
-import { a as addAccuracyCircles, i as AccuracyCircleSample, n as ACCURACY_CIRCLE_STROKE_OPACITY, r as ACCURACY_CIRCLE_WEIGHT, t as ACCURACY_CIRCLE_FILL_OPACITY } from "../accuracy-circles-BpwWAs8G.js";
-import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-krOKwDAq.js";
-import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "../map-overlay-bcogY5fK.js";
-import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-D950t71B.js";
-import { t as VIS_COLORS } from "../vis-colors-D6omC64K.js";
+import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-m-ab19vp.js";
+import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-BTb2Yp12.js";
+import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-BUTsQ2yu.js";
+import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-DdjPiSav.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-DDLkgNf_.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-BExxrWJ-.js";
+import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-D_RGmH98.js";
+import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-D_Af8Dt3.js";
+import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-Dqak9hiR.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-C6I9NDHA.js";
+import { n as GpsEventVisualizer, r as gpsEventVisualizer } from "../gps-event-markers-Dd0G2bD0.js";
+import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "../leaflet-map-overlay-bnb2U1NQ.js";
+import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-kLxMJ2Xj.js";
+import { a as addAccuracyCircles, i as AccuracyCircleSample, n as ACCURACY_CIRCLE_STROKE_OPACITY, r as ACCURACY_CIRCLE_WEIGHT, t as ACCURACY_CIRCLE_FILL_OPACITY } from "../accuracy-circles-Pi2YeCrM.js";
+import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-CPVdAsFq.js";
+import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "../map-overlay-Dci4yvm3.js";
+import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-BCZkSJp2.js";
+import { t as VIS_COLORS } from "../vis-colors-BZsSLI4i.js";
 export { ACCURACY_CIRCLE_FILL_OPACITY, ACCURACY_CIRCLE_STROKE_OPACITY, ACCURACY_CIRCLE_WEIGHT, ALIGNMENT_SNAPSHOT_COLOR, type AccuracyCircleSample, type AlignmentLerper, type ArWorldGroupAlignmentHandle, type ArWorldGroupAlignmentOptions, COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, type CameraFollower, type Css3dRendererManager, DEFAULT_HEIGHT_OFFSET, DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_LERP_RATE, DEFAULT_MAP_SIZE, DEFAULT_WORLD_SIZE, DEFAULT_ZOOM, DEFAULT_Z_OFFSET, type DisposeOptions, type DrawMapDataOptions, type DrawnMapData, FUSED_PATH_COLOR, type GpsAnchor, type GpsAnchorMode, type GpsAnchorOptions, type GpsAnchorPhase, type GpsAnchorSamplePoint, type GpsCompassCubes, GpsEventVisualizer, type HitMatrix, LeafletMapOverlay, type LeafletMapOverlayOptions, MAP_PATH_POLYLINE_OPACITY, MAP_PATH_POLYLINE_WEIGHT, type MapData, type MapDataInput, MapOverlay, type MapOverlayOptions, RAW_GPS_COLOR, type TextureLoaderInterface, USER_POSITION_COLOR, VIS_COLORS, addAccuracyCircles, buildCameraFrustum, buildMapData, clampedAlpha, createAlignmentLerper, createCameraFollower, createCss3dRendererManager, createGpsAnchor, createGpsCompassCubes, createReticleMesh, disposeMeshArray, disposeObject3D, drawMapData, enableArWorldGroupAlignment, gpsEventVisualizer, isObjectInCameraFrustum, isPointInCameraFrustum, isSphereInCameraFrustum, latLonToTileXY, nueToArLocal, tileXYToLatLon, updateReticle, worldNueToGps };

package/dist/visualization/leaflet-map-overlay.d.ts

@@ -1,2 +1,2 @@
-import { a as DEFAULT_Z_OFFSET, i as DEFAULT_ZOOM, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions, t as DEFAULT_HEIGHT_OFFSET } from "../leaflet-map-overlay-6CJC-E1l.js";
+import { a as DEFAULT_Z_OFFSET, i as DEFAULT_ZOOM, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions, t as DEFAULT_HEIGHT_OFFSET } from "../leaflet-map-overlay-bnb2U1NQ.js";
 export { DEFAULT_HEIGHT_OFFSET, DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_WORLD_SIZE, DEFAULT_ZOOM, DEFAULT_Z_OFFSET, LeafletMapOverlay, LeafletMapOverlayOptions };

package/dist/visualization/leaflet-map-overlay.js

@@ -7,6 +7,16 @@ import L from "leaflet";
 const log = createLogger("LeafletMapOverlay");
 /** Default pixel size of the Leaflet map container */
 const DEFAULT_LEAFLET_MAP_SIZE_PX = 600;
+/**
+* Diameter (px) of the ref-point markers on the in-AR minimap.
+*
+* Enlarged 12 → 20 px (F5-A, 2026-06-16 user feedback): the field tester
+* reported the minimap "showed the user but not the marker". The markers WERE
+* rendered — they were just too small to notice on the small CSS3D minimap. A
+* bigger dot plus a thicker white halo and a drop shadow makes them the most
+* prominent feature on the minimap (the user-position marker stays 14 px).
+*/
+const REF_POINT_MARKER_SIZE_PX = 20;
 /** Default world-space size in meters (matches old MapOverlay) */
 const DEFAULT_WORLD_SIZE = 10;
 /** Default height offset below camera (negative = below) */
@@ -259,11 +269,13 @@ var LeafletMapOverlay = class {
 		const color = isPrior ? VIS_COLORS.PRIOR_REF_POINT.css : VIS_COLORS.CURRENT_REF_POINT.css;
 		const opacity = isPrior ? "opacity:0.8;" : "";
 		const label = isPrior ? `📌 ${name} (prior)` : name;
+		const size = REF_POINT_MARKER_SIZE_PX;
+		const anchor = size / 2;
 		return L.marker([lat, lon], { icon: L.divIcon({
 			className: "",
-			html: `<div style="background:${color};width:12px;height:12px;border-radius:50%;border:2px solid white;${opacity}"></div>`,
-			iconSize: [12, 12],
-			iconAnchor: [6, 6]
+			html: `<div style="background:${color};width:${size}px;height:${size}px;border-radius:50%;border:3px solid white;box-shadow:0 0 4px rgba(0,0,0,0.7);${opacity}"></div>`,
+			iconSize: [size, size],
+			iconAnchor: [anchor, anchor]
 		}) }).bindPopup(label).addTo(this.leafletMap);
 	}
 };

package/dist/visualization/lerp-utils.d.ts

@@ -1,2 +1,2 @@
-import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-BpV-0Dtk.js";
+import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-kLxMJ2Xj.js";
 export { DEFAULT_LERP_RATE, clampedAlpha };

package/dist/visualization/map-data.d.ts

@@ -1,2 +1,2 @@
-import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-CkloBxIl.js";
+import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-DdjPiSav.js";
 export { MapData, MapDataInput, buildMapData };

package/dist/visualization/map-overlay-draw.d.ts

@@ -1,2 +1,2 @@
-import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-krOKwDAq.js";
+import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-CPVdAsFq.js";
 export { ALIGNMENT_SNAPSHOT_COLOR, DrawMapDataOptions, DrawnMapData, FUSED_PATH_COLOR, MAP_PATH_POLYLINE_OPACITY, MAP_PATH_POLYLINE_WEIGHT, RAW_GPS_COLOR, USER_POSITION_COLOR, drawMapData };

package/dist/visualization/map-overlay.d.ts

@@ -1,2 +1,2 @@
-import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "../map-overlay-bcogY5fK.js";
+import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "../map-overlay-Dci4yvm3.js";
 export { DEFAULT_HEIGHT_OFFSET, DEFAULT_MAP_SIZE, DEFAULT_ZOOM, MapOverlay, MapOverlayOptions, TextureLoaderInterface, latLonToTileXY, tileXYToLatLon };

package/dist/visualization/three-dispose.d.ts

@@ -1,2 +1,2 @@
-import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-D950t71B.js";
+import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-BCZkSJp2.js";
 export { DisposeOptions, disposeMeshArray, disposeObject3D };

package/dist/visualization/vis-colors.d.ts

@@ -1,2 +1,2 @@
-import { t as VIS_COLORS } from "../vis-colors-D6omC64K.js";
+import { t as VIS_COLORS } from "../vis-colors-BZsSLI4i.js";
 export { VIS_COLORS };

package/dist/{webxr-session-TIaD883f.js → webxr-session-CJF9Nijp.js}

@@ -1,19 +1,92 @@
 import { createLogger } from "./utils/logger.js";
-import { CameraBlitCapture, computeCaptureSize } from "./ar/camera-blit-capture.js";
+import { CameraBlitCapture, computeAspectFitSize, computeCaptureSize } from "./ar/camera-blit-capture.js";
 import { getLastDeviceOrientation } from "./state/gps-event-coordinator.js";
 import { DepthSampler, wrapXRDepthInfo } from "./ar/depth-sampler.js";
+import { WEBXR_TO_NUE } from "./ar/webxr-nue-basis.js";
 import { clearFrameUpdates, runFrameUpdates } from "./ar/frame-loop.js";
 import { clearXrFrameUpdates, runXrFrameUpdates } from "./ar/xr-frame-loop.js";
-import { WEBXR_TO_NUE } from "./ar/webxr-nue-basis.js";
 import { DEFAULT_CAPTURE_CONFIG, ImageCaptureManager } from "./ar/image-capture.js";
 import { clearLastRestartedPayload, originReset, poseLost, poseReceived, resetTracking, selectLastRestartedPayload, selectTrackingPhase } from "./state/tracking-slice.js";
 import { acquireCameraTexture } from "./ar/xr-camera-texture.js";
-import { n as runSessionDisposers } from "./session-disposers-M-oashRH.js";
+import { n as runSessionDisposers } from "./session-disposers-D8wnO-uW.js";
 import { DEFAULT_RECORDING_OPTIONS, validateArCrashIsolationOptions } from "./state/recording-options.js";
 import { SCENE_NODE } from "./ar/scene-node-names.js";
 import { createCss3dRendererManager } from "./visualization/css3d-renderer-manager.js";
 import * as THREE from "three";
 import { nueQuaternionToWebXR, nueToWebXR } from "gps-plus-slam-js";
+//#region ../src/ar/camera-frame-source.ts
+const DEFAULT_CONFIG = { intervalMs: 125 };
+/**
+* Throttled RGBA capturer. Construct with the injected `capture`/`onCapture`
+* pair, `start()`, then call `onFrame(timestamp)` once per XR frame.
+*/
+var CameraFrameSource = class {
+	callbacks;
+	config;
+	running = false;
+	captureCount = 0;
+	lastCaptureTime = -Infinity;
+	constructor(callbacks, config) {
+		this.callbacks = callbacks;
+		this.config = { ...DEFAULT_CONFIG };
+		if (config) this.updateConfig(config);
+	}
+	/** Begin throttling. Resets the cadence so the first tick captures. */
+	start() {
+		this.running = true;
+		this.captureCount = 0;
+		this.lastCaptureTime = -Infinity;
+	}
+	/** Stop capturing. `onFrame` becomes a no-op until `start()` is called again. */
+	stop() {
+		this.running = false;
+	}
+	isRunning() {
+		return this.running;
+	}
+	/** Number of frames successfully captured + delivered since `start()`. */
+	getFrameCount() {
+		return this.captureCount;
+	}
+	getConfig() {
+		return { ...this.config };
+	}
+	/**
+	* Apply partial config (e.g. the app's detection cadence). Invalid values
+	* are ignored defensively — `intervalMs` requires a finite positive number.
+	*/
+	updateConfig(config) {
+		if (typeof config.intervalMs === "number" && Number.isFinite(config.intervalMs) && config.intervalMs > 0) this.config.intervalMs = config.intervalMs;
+	}
+	/**
+	* Per-XR-frame tick. Captures + delivers a frame at most once per
+	* `intervalMs`; otherwise a cheap no-op so it is safe to call every frame.
+	*
+	* @param timestamp - monotonic frame time in ms (the XR `time` argument).
+	*/
+	onFrame(timestamp) {
+		if (!this.running) return;
+		if (timestamp - this.lastCaptureTime < this.config.intervalMs) return;
+		const image = this.captureSafely();
+		if (!image) return;
+		this.lastCaptureTime = timestamp;
+		this.captureCount++;
+		this.callbacks.onCapture(image);
+	}
+	/**
+	* Run the injected capture, guarded so a blit failure (e.g. GL context loss)
+	* can never throw out of the XR frame loop — it degrades to "no frame this
+	* tick", exactly like a missing texture.
+	*/
+	captureSafely() {
+		try {
+			return this.callbacks.capture();
+		} catch {
+			return null;
+		}
+	}
+};
+//#endregion
 //#region ../src/ar/depth-rgb-lookup.ts
 /**
 * Build an {@link RgbLookup} over an RGBA readback buffer.
@@ -159,6 +232,13 @@ function resetWebXRState() {
 		depthRgbBlit.dispose();
 		depthRgbBlit = null;
 	}
+	cameraFrameSource = null;
+	onCameraFrame = null;
+	cameraFrameCaptureSize = DEFAULT_CAMERA_FRAME_CAPTURE_SIZE;
+	if (cameraFrameBlit) {
+		cameraFrameBlit.dispose();
+		cameraFrameBlit = null;
+	}
 	onFrameCallback = null;
 	if (css3dManager) {
 		css3dManager.dispose();
@@ -285,6 +365,53 @@ const DEPTH_RGB_BLIT_CONFIG = {
 	height: 192
 };
 /**
+* Session-owned blit target for the generic camera-frame RGBA capture
+* (framework-wiring options Part A / B2) — feeds QR detection today, object
+* detection / OpenCV later. Separate from `depthRgbBlit` (256×192) on purpose:
+* CV detection needs more pixels across the target (~1024 long edge) than a
+* colour lookup, but only at the detection cadence, so the {@link CameraFrameSource}
+* throttle keeps the readback off the per-frame path. Created lazily on the
+* first capture, disposed by resetWebXRState(). The longer-edge size is
+* configurable via `startCameraFrameCapture`; the blit preserves the camera
+* aspect (see `acquireCameraFrameRgba`).
+*/
+let cameraFrameBlit = null;
+/**
+* Default longer-edge resolution (px) for the camera-frame blit the QR / CV
+* detector sees. The on-device capture-resolution sweep (2026-06-17, via the
+* `?capture=` override) showed **1024** decodes a small / out-of-focus QR
+* markedly better than the prior 512 with no perceptible cadence cost on the
+* test phone; 2048 helped slightly more but risks low-end devices (4096 lagged),
+* so 1024 is the safe default. Raise per-consumer via
+* `startCameraFrameCapture({ captureSize })`.
+*
+* @see GpsPlusSlamJs_Docs/docs/2026-06-17-qr-size-accuracy-and-thin-demo-plan.md (WS-C)
+*/
+const DEFAULT_CAMERA_FRAME_CAPTURE_SIZE = 1024;
+/**
+* Longer-edge resolution of the camera-frame blit (px), default
+* {@link DEFAULT_CAMERA_FRAME_CAPTURE_SIZE}. The blit preserves the camera
+* aspect, so the actual target is e.g. 1024×768 for a 4:3 frame — see
+* `computeAspectFitSize` / `acquireCameraFrameRgba`.
+*/
+let cameraFrameCaptureSize = DEFAULT_CAMERA_FRAME_CAPTURE_SIZE;
+/**
+* Throttled camera frame source (created in initAR when `onCameraFrame` is
+* set). Blits the camera texture to RGBA at the detection cadence and hands it
+* to `onCameraFrame`. @see camera-frame-source.ts
+*
+* SINGLE consumer by design: one source, one callback, one blit. That covers
+* one CV consumer at a time (QR *or* object detection). To run two live CV
+* consumers **simultaneously** at independent cadences/resolutions, replace this
+* single-callback wiring with a small registry (e.g.
+* `registerCameraFrameConsumer({ intervalMs, captureSize, onFrame })`) holding a
+* `CameraFrameSource` per consumer — the class is already per-instance. See the
+* SCOPE note in `camera-frame-source.ts`.
+*/
+let cameraFrameSource = null;
+/** Callback for each throttled camera RGBA frame (set via setCameraFrameCallback). */
+let onCameraFrame = null;
+/**
 * Latest WebXR camera texture, updated each frame when camera-access is enabled.
 * Acquired via Three.js's renderer.xr.getCameraTexture() API (ExternalTexture).
 * @see xr-camera-texture.ts
@@ -333,6 +460,20 @@ function acquireDepthRgbLookup() {
 	return readback ? createRgbLookup(readback.pixels, readback.width, readback.height) : null;
 }
 /**
+* Capture the current XR frame as top-left RGBA for CV detection (the
+* `capture` injected into {@link CameraFrameSource}; called at most once per
+* detection interval). Returns null — no frame this tick — when camera access
+* or the texture is unavailable; the lazy blit makes a disposal elsewhere
+* self-healing. Reuses `latestCameraTexture`, exactly like the depth-RGB path.
+*/
+function acquireCameraFrameRgba() {
+	if (!renderer || !latestCameraTexture) return null;
+	const target = computeAspectFitSize(latestCameraWidth, latestCameraHeight, cameraFrameCaptureSize);
+	if (!cameraFrameBlit) cameraFrameBlit = new CameraBlitCapture(target);
+	else cameraFrameBlit.resizeIfNeeded(target.width, target.height);
+	return cameraFrameBlit.captureToRgba(renderer, latestCameraTexture);
+}
+/**
 * Extract the reset transform from an XRReferenceSpaceEvent-like object.
 *
 * Distinguishes three cases per OdometryTrackingRestartedPayload semantics:
@@ -563,6 +704,13 @@ async function initAR(container, isolationOptions = {}, sessionFeatures = {}) {
 		acquireRgbLookup: acquireDepthRgbLookup,
 		onDepthUnavailable: onDepthUnavailable ?? void 0
 	});
+	if (onCameraFrame) {
+		const deliver = onCameraFrame;
+		cameraFrameSource = new CameraFrameSource({
+			capture: acquireCameraFrameRgba,
+			onCapture: (image) => deliver(image)
+		});
+	}
 	renderer.setAnimationLoop(onXRFrame);
 	log.info("AR session started");
 }
@@ -681,6 +829,7 @@ function onXRFrame(time, frame) {
 		const depthInfo = getDepthInfoFromFrame(frame, pose);
 		depthSampler.onFrame(time, depthInfo);
 	}
+	if (cameraFrameSource) cameraFrameSource.onFrame(time);
 	if (onFrameCallback) try {
 		onFrameCallback();
 	} catch (error) {
@@ -897,7 +1046,8 @@ function startImageCapture(config) {
 	const currentRenderer = renderer;
 	const divisor = mergedConfig.resolutionDivisor;
 	callbacks.captureFrame = async (quality) => {
-		if (!blitCapture || !latestCameraTexture) {
+		const bc = blitCapture;
+		if (!bc || !latestCameraTexture) {
 			const canvas = currentRenderer.domElement;
 			return new Promise((resolve) => {
 				canvas.toBlob((blob) => resolve(blob ? {
@@ -909,14 +1059,14 @@ function startImageCapture(config) {
 		}
 		if (latestCameraWidth > 0 && latestCameraHeight > 0) {
 			const target = computeCaptureSize(latestCameraWidth, latestCameraHeight, divisor);
-			blitCapture.resizeIfNeeded(target.width, target.height);
+			bc.resizeIfNeeded(target.width, target.height);
 		}
-		const blob = await blitCapture.captureToBlob(currentRenderer, latestCameraTexture, quality);
+		const blob = await bc.captureToBlob(currentRenderer, latestCameraTexture, quality);
 		if (!blob) return null;
 		return {
 			blob,
-			width: blitCapture.getWidth(),
-			height: blitCapture.getHeight()
+			width: bc.getWidth(),
+			height: bc.getHeight()
 		};
 	};
 	log.info(`Blit capture pipeline initialized (resolutionDivisor=${divisor})`);
@@ -1033,6 +1183,68 @@ function getDepthSampleCount() {
 	return depthSampler?.getSampleCount() ?? 0;
 }
 /**
+* Set the per-frame camera RGBA callback (B2) — the generic CV frame feed (QR
+* detection today, object detection / OpenCV later). Call this BEFORE initAR to
+* enable in-session camera frame capture; `startCameraFrameCapture` then begins
+* delivering frames.
+*
+* The callback receives a **top-left-origin** RGBA image (no JPEG round-trip),
+* captured at the throttled detection cadence — feed it straight to a
+* `BarcodeDetector` / OpenCV front-end. Mirrors `setDepthCaptureCallback`.
+*
+* @param onFrame - Called with each throttled camera frame, or `null` to clear.
+*/
+function setCameraFrameCallback(onFrame) {
+	onCameraFrame = onFrame;
+}
+/**
+* Start camera frame capture during an AR session. Must call
+* setCameraFrameCallback before initAR (the source is created there). No-op if
+* the source was not initialized (callback not set before initAR).
+*
+* The source is the single cadence owner: drive your detection scheduler from
+* the delivered frames with its own `minIntervalMs: 0` (Option A).
+*
+* @param config - optional cadence / blit-resolution overrides.
+*/
+function startCameraFrameCapture(config) {
+	if (!cameraFrameSource) {
+		log.warn("Cannot start camera frame capture - frame source not initialized");
+		return;
+	}
+	if (typeof config?.captureSize === "number" && Number.isFinite(config.captureSize) && config.captureSize > 0) cameraFrameCaptureSize = Math.floor(config.captureSize);
+	if (config?.intervalMs !== void 0) cameraFrameSource.updateConfig({ intervalMs: config.intervalMs });
+	cameraFrameSource.start();
+	log.info(`Camera frame capture started (interval: ${cameraFrameSource.getConfig().intervalMs}ms, long edge ${cameraFrameCaptureSize}px, aspect-preserved)`);
+}
+/**
+* Stop camera frame capture. Safe to call when not running.
+*/
+function stopCameraFrameCapture() {
+	if (cameraFrameSource) {
+		const count = cameraFrameSource.getFrameCount();
+		cameraFrameSource.stop();
+		log.info(`Camera frame capture stopped (${count} frames captured)`);
+	}
+}
+/**
+* Get the number of camera frames captured since the last
+* `startCameraFrameCapture`.
+*/
+function getCameraFrameCount() {
+	return cameraFrameSource?.getFrameCount() ?? 0;
+}
+/**
+* The current longer-edge resolution (px) of the camera-frame blit — the
+* {@link DEFAULT_CAMERA_FRAME_CAPTURE_SIZE} default unless overridden via
+* `startCameraFrameCapture({ captureSize })`. Exposed for diagnostics and to
+* let tests assert the on-device-tuned default without reaching into module
+* state.
+*/
+function getCameraFrameCaptureSize() {
+	return cameraFrameCaptureSize;
+}
+/**
 * Set a per-frame callback for custom updates.
 * The callback is invoked every XR frame after pose updates but before render.
 * Useful for updating elements that need to follow the camera smoothly
@@ -1051,4 +1263,4 @@ function getLiveCss3dManager() {
 	return css3dManager;
 }
 //#endregion
-export { setTrackingLostCallback as A, setArWorldGroup as C, setImageCaptureCallback as D, setFrameCallback as E, startImageCapture as F, stopDepthCapture as I, stopImageCapture as L, setTrackingStore as M, shouldLogCameraAccessDiagnostic as N, setScene as O, startDepthCapture as P, setArPose as S, setDepthCaptureCallback as T, isWebXRSupported as _, extractPoseFromViewer as a, nueQuaternionToWebXR$1 as b, getArWorldGroup as c, getDepthSampleCount as d, getImageCaptureFrameCount as f, initAR as g, getXrCameraFromPose as h, endARSession as i, setTrackingRecoveredCallback as j, setTrackingCallbacks as k, getCamera as l, getScene as m, buildSessionOptions as n, extractResetTransformData as o, getLiveCss3dManager as p, createSceneHierarchy as r, getArPose as s, applyAlignmentMatrix as t, getCurrentArPose as u, isXRCameraLike as v, setCamera as w, resetWebXRState as x, nuePositionToWebXR as y };
+export { setFrameCallback as A, startImageCapture as B, nueQuaternionToWebXR$1 as C, setCamera as D, setArWorldGroup as E, setTrackingRecoveredCallback as F, stopDepthCapture as H, setTrackingStore as I, shouldLogCameraAccessDiagnostic as L, setScene as M, setTrackingCallbacks as N, setCameraFrameCallback as O, setTrackingLostCallback as P, startCameraFrameCapture as R, nuePositionToWebXR as S, setArPose as T, stopImageCapture as U, stopCameraFrameCapture as V, CameraFrameSource as W, getScene as _, endARSession as a, isWebXRSupported as b, getArPose as c, getCameraFrameCaptureSize as d, getCameraFrameCount as f, getLiveCss3dManager as g, getImageCaptureFrameCount as h, createSceneHierarchy as i, setImageCaptureCallback as j, setDepthCaptureCallback as k, getArWorldGroup as l, getDepthSampleCount as m, applyAlignmentMatrix as n, extractPoseFromViewer as o, getCurrentArPose as p, buildSessionOptions as r, extractResetTransformData as s, DEFAULT_CAMERA_FRAME_CAPTURE_SIZE as t, getCamera as u, getXrCameraFromPose as v, resetWebXRState as w, isXRCameraLike as x, initAR as y, startDepthCapture as z };