@chipmobilesdk/rn-camera 0.1.1 → 0.2.1

package/src/geometry/coordinateMapping.ts

@@ -1,129 +1,129 @@
-/**
- * Bidirectional coordinate mapping between preview space and captured-image
- * space (FR-036, SC-012).
- *
- * Pure functions with no native involvement (research R5). Everything needed is
- * already known in JavaScript, so keeping this pure is what makes the 2-pixel
- * round-trip tolerance verifiable in CI rather than only on a device.
- *
- * Composition order, preview -> image: undo mirror, undo letterbox/crop offset,
- * undo scale, undo orientation. Image -> preview reverses it exactly.
- */
-
-import type { Point, PreviewGeometry, Rect } from '../config/types';
-
-/** Orientation rotates the image for display, swapping dimensions at 90/270. */
-function isQuarterTurn(orientation: number): boolean {
-	const normalized = ((orientation % 360) + 360) % 360;
-	return normalized === 90 || normalized === 270;
-}
-
-function normalizeOrientation(orientation: number): 0 | 90 | 180 | 270 {
-	const normalized = ((Math.round(orientation / 90) * 90) % 360 + 360) % 360;
-	return normalized as 0 | 90 | 180 | 270;
-}
-
-interface Projection {
-	readonly scale: number;
-	readonly offsetX: number;
-	readonly offsetY: number;
-	/** Image dimensions as displayed, after orientation. */
-	readonly displayWidth: number;
-	readonly displayHeight: number;
-}
-
-function projection(geometry: PreviewGeometry): Projection {
-	const swap = isQuarterTurn(geometry.orientation);
-	const displayWidth = swap ? geometry.imageHeight : geometry.imageWidth;
-	const displayHeight = swap ? geometry.imageWidth : geometry.imageHeight;
-
-	const scaleX = geometry.previewWidth / displayWidth;
-	const scaleY = geometry.previewHeight / displayHeight;
-	// `cover` fills and crops the overflow; `contain` fits and letterboxes.
-	const scale =
-		geometry.resizeMode === 'cover' ? Math.max(scaleX, scaleY) : Math.min(scaleX, scaleY);
-
-	return {
-		scale,
-		// Negative under `cover` (cropped away), positive under `contain`
-		// (letterbox bands). The same arithmetic covers both.
-		offsetX: (geometry.previewWidth - displayWidth * scale) / 2,
-		offsetY: (geometry.previewHeight - displayHeight * scale) / 2,
-		displayWidth,
-		displayHeight,
-	};
-}
-
-/** Display-space point -> original image point, undoing the rotation. */
-function unrotate(point: Point, geometry: PreviewGeometry): Point {
-	switch (normalizeOrientation(geometry.orientation)) {
-		case 90:
-			return { x: point.y, y: geometry.imageHeight - point.x };
-		case 180:
-			return { x: geometry.imageWidth - point.x, y: geometry.imageHeight - point.y };
-		case 270:
-			return { x: geometry.imageWidth - point.y, y: point.x };
-		default:
-			return point;
-	}
-}
-
-/** Original image point -> display-space point, applying the rotation. */
-function rotate(point: Point, geometry: PreviewGeometry): Point {
-	switch (normalizeOrientation(geometry.orientation)) {
-		case 90:
-			return { x: geometry.imageHeight - point.y, y: point.x };
-		case 180:
-			return { x: geometry.imageWidth - point.x, y: geometry.imageHeight - point.y };
-		case 270:
-			return { x: point.y, y: geometry.imageWidth - point.x };
-		default:
-			return point;
-	}
-}
-
-/**
- * Maps a preview-space point into captured-image space. Points outside the
- * visible region stay representable (they fall outside the image bounds) rather
- * than being clamped to an edge, so callers can detect an out-of-frame overlay.
- */
-export function mapPointToImage(point: Point, geometry: PreviewGeometry): Point {
-	const { scale, offsetX, offsetY } = projection(geometry);
-	const x = geometry.isMirrored ? geometry.previewWidth - point.x : point.x;
-	return unrotate({ x: (x - offsetX) / scale, y: (point.y - offsetY) / scale }, geometry);
-}
-
-/** Maps a captured-image point into preview space. Exact inverse of the above. */
-export function mapPointToPreview(point: Point, geometry: PreviewGeometry): Point {
-	const { scale, offsetX, offsetY } = projection(geometry);
-	const rotated = rotate(point, geometry);
-	const x = rotated.x * scale + offsetX;
-	return {
-		x: geometry.isMirrored ? geometry.previewWidth - x : x,
-		y: rotated.y * scale + offsetY,
-	};
-}
-
-/** Axis-aligned bounding box of the mapped corners — exact for quarter turns. */
-function boundsOf(a: Point, b: Point): Rect {
-	return {
-		x: Math.min(a.x, b.x),
-		y: Math.min(a.y, b.y),
-		width: Math.abs(b.x - a.x),
-		height: Math.abs(b.y - a.y),
-	};
-}
-
-export function mapRectToImage(rect: Rect, geometry: PreviewGeometry): Rect {
-	return boundsOf(
-		mapPointToImage({ x: rect.x, y: rect.y }, geometry),
-		mapPointToImage({ x: rect.x + rect.width, y: rect.y + rect.height }, geometry),
-	);
-}
-
-export function mapRectToPreview(rect: Rect, geometry: PreviewGeometry): Rect {
-	return boundsOf(
-		mapPointToPreview({ x: rect.x, y: rect.y }, geometry),
-		mapPointToPreview({ x: rect.x + rect.width, y: rect.y + rect.height }, geometry),
-	);
-}
+/**
+ * Bidirectional coordinate mapping between preview space and captured-image
+ * space (FR-036, SC-012).
+ *
+ * Pure functions with no native involvement (research R5). Everything needed is
+ * already known in JavaScript, so keeping this pure is what makes the 2-pixel
+ * round-trip tolerance verifiable in CI rather than only on a device.
+ *
+ * Composition order, preview -> image: undo mirror, undo letterbox/crop offset,
+ * undo scale, undo orientation. Image -> preview reverses it exactly.
+ */
+
+import type { Point, PreviewGeometry, Rect } from '../config/types';
+
+/** Orientation rotates the image for display, swapping dimensions at 90/270. */
+function isQuarterTurn(orientation: number): boolean {
+	const normalized = ((orientation % 360) + 360) % 360;
+	return normalized === 90 || normalized === 270;
+}
+
+function normalizeOrientation(orientation: number): 0 | 90 | 180 | 270 {
+	const normalized = (((Math.round(orientation / 90) * 90) % 360) + 360) % 360;
+	return normalized as 0 | 90 | 180 | 270;
+}
+
+interface Projection {
+	readonly scale: number;
+	readonly offsetX: number;
+	readonly offsetY: number;
+	/** Image dimensions as displayed, after orientation. */
+	readonly displayWidth: number;
+	readonly displayHeight: number;
+}
+
+function projection(geometry: PreviewGeometry): Projection {
+	const swap = isQuarterTurn(geometry.orientation);
+	const displayWidth = swap ? geometry.imageHeight : geometry.imageWidth;
+	const displayHeight = swap ? geometry.imageWidth : geometry.imageHeight;
+
+	const scaleX = geometry.previewWidth / displayWidth;
+	const scaleY = geometry.previewHeight / displayHeight;
+	// `cover` fills and crops the overflow; `contain` fits and letterboxes.
+	const scale =
+		geometry.resizeMode === 'cover' ? Math.max(scaleX, scaleY) : Math.min(scaleX, scaleY);
+
+	return {
+		scale,
+		// Negative under `cover` (cropped away), positive under `contain`
+		// (letterbox bands). The same arithmetic covers both.
+		offsetX: (geometry.previewWidth - displayWidth * scale) / 2,
+		offsetY: (geometry.previewHeight - displayHeight * scale) / 2,
+		displayWidth,
+		displayHeight,
+	};
+}
+
+/** Display-space point -> original image point, undoing the rotation. */
+function unrotate(point: Point, geometry: PreviewGeometry): Point {
+	switch (normalizeOrientation(geometry.orientation)) {
+		case 90:
+			return { x: point.y, y: geometry.imageHeight - point.x };
+		case 180:
+			return { x: geometry.imageWidth - point.x, y: geometry.imageHeight - point.y };
+		case 270:
+			return { x: geometry.imageWidth - point.y, y: point.x };
+		default:
+			return point;
+	}
+}
+
+/** Original image point -> display-space point, applying the rotation. */
+function rotate(point: Point, geometry: PreviewGeometry): Point {
+	switch (normalizeOrientation(geometry.orientation)) {
+		case 90:
+			return { x: geometry.imageHeight - point.y, y: point.x };
+		case 180:
+			return { x: geometry.imageWidth - point.x, y: geometry.imageHeight - point.y };
+		case 270:
+			return { x: point.y, y: geometry.imageWidth - point.x };
+		default:
+			return point;
+	}
+}
+
+/**
+ * Maps a preview-space point into captured-image space. Points outside the
+ * visible region stay representable (they fall outside the image bounds) rather
+ * than being clamped to an edge, so callers can detect an out-of-frame overlay.
+ */
+export function mapPointToImage(point: Point, geometry: PreviewGeometry): Point {
+	const { scale, offsetX, offsetY } = projection(geometry);
+	const x = geometry.isMirrored ? geometry.previewWidth - point.x : point.x;
+	return unrotate({ x: (x - offsetX) / scale, y: (point.y - offsetY) / scale }, geometry);
+}
+
+/** Maps a captured-image point into preview space. Exact inverse of the above. */
+export function mapPointToPreview(point: Point, geometry: PreviewGeometry): Point {
+	const { scale, offsetX, offsetY } = projection(geometry);
+	const rotated = rotate(point, geometry);
+	const x = rotated.x * scale + offsetX;
+	return {
+		x: geometry.isMirrored ? geometry.previewWidth - x : x,
+		y: rotated.y * scale + offsetY,
+	};
+}
+
+/** Axis-aligned bounding box of the mapped corners — exact for quarter turns. */
+function boundsOf(a: Point, b: Point): Rect {
+	return {
+		x: Math.min(a.x, b.x),
+		y: Math.min(a.y, b.y),
+		width: Math.abs(b.x - a.x),
+		height: Math.abs(b.y - a.y),
+	};
+}
+
+export function mapRectToImage(rect: Rect, geometry: PreviewGeometry): Rect {
+	return boundsOf(
+		mapPointToImage({ x: rect.x, y: rect.y }, geometry),
+		mapPointToImage({ x: rect.x + rect.width, y: rect.y + rect.height }, geometry),
+	);
+}
+
+export function mapRectToPreview(rect: Rect, geometry: PreviewGeometry): Rect {
+	return boundsOf(
+		mapPointToPreview({ x: rect.x, y: rect.y }, geometry),
+		mapPointToPreview({ x: rect.x + rect.width, y: rect.y + rect.height }, geometry),
+	);
+}

package/src/index.ts

@@ -1,78 +1,78 @@
-/**
- * @chipmobilesdk/rn-camera — reusable camera infrastructure for
- * ChipMobileSdk-family React Native apps.
- *
- * This is the single public entrypoint (LIB-003). Modules under `core/`,
- * `native/`, `permissions/`, `storage/`, `geometry/`, `diagnostics/`, and
- * `testing/` are private; import them only through this file.
- *
- * The package contains no business logic, sends nothing over the network, and
- * writes nothing to the device gallery. Phase one runs no on-device inference —
- * see the reserved frame-processing extension point in the README.
- */
-
-// Public types
-export type {
-	ArtifactOwnership,
-	CameraErrorLike,
-	CameraPermissionState,
-	CameraPosition,
-	CameraState,
-	CapabilityProfile,
-	CapturedImage,
-	CaptureRequest,
-	FlashMode,
-	Known,
-	Maybe,
-	Point,
-	PreviewGeometry,
-	Rect,
-	ResizeMode,
-	SessionStatus,
-	StartOptions,
-	Unavailable,
-} from './config/types';
-export { known, unavailable } from './config/types';
-
-// Controller
-export { createCameraController, DEFAULT_TEMPORARY_TTL_MS } from './core/controller';
-export type {
-	AppStatus,
-	CameraController,
-	CameraControllerOptions,
-} from './core/controller';
-
-// Ports + default adapters
-export type { CameraEngine, EngineOptions } from './native/cameraEngine';
-export { createVisionCameraEngine } from './native/cameraEngine';
-export type { PermissionPort } from './permissions/permissionPort';
-export { createVisionCameraPermissions } from './permissions/permissionPort';
-export type { ArtifactStore, FileSystemBridge, StoreOptions } from './storage/artifactStore';
-export { createArtifactStore, createCacheArtifactStore } from './storage/artifactStore';
-
-// React surface
-export { CameraPreview } from './react/CameraPreview';
-export type { CameraPreviewProps } from './react/CameraPreview';
-export { useCameraController, useCameraState } from './react/hooks';
-
-// Coordinate mapping (pure)
-export {
-	mapPointToImage,
-	mapPointToPreview,
-	mapRectToImage,
-	mapRectToPreview,
-} from './geometry/coordinateMapping';
-
-// Diagnostics
-export { CameraError, isCameraError, redact } from './diagnostics/errors';
-export type { CameraErrorCode } from './diagnostics/errors';
-export type { CameraLogEvent, CameraLogEventType, CameraLogger } from './diagnostics/logger';
-
-// Test adapter (FR-041) — exported from the single entrypoint so consumer tests
-// exercise the same published ports the real adapters implement.
-export { createTestCamera, createMemoryFileSystem, DEFAULT_TEST_CAPABILITIES } from './testing/testCameraAdapter';
-export type {
-	MemoryFileSystem,
-	TestCameraConfig,
-	TestCameraHandles,
-} from './testing/testCameraAdapter';
+/**
+ * @chipmobilesdk/rn-camera — reusable camera infrastructure for
+ * ChipMobileSdk-family React Native apps.
+ *
+ * This is the single public entrypoint (LIB-003). Modules under `core/`,
+ * `native/`, `permissions/`, `storage/`, `geometry/`, `diagnostics/`, and
+ * `testing/` are private; import them only through this file.
+ *
+ * The package contains no business logic, sends nothing over the network, and
+ * writes nothing to the device gallery. Phase one runs no on-device inference —
+ * see the reserved frame-processing extension point in the README.
+ */
+
+// Public types
+export type {
+	ArtifactOwnership,
+	CameraErrorLike,
+	CameraPermissionState,
+	CameraPosition,
+	CameraState,
+	CapabilityProfile,
+	CapturedImage,
+	CaptureRequest,
+	FlashMode,
+	Known,
+	Maybe,
+	Point,
+	PreviewGeometry,
+	Rect,
+	ResizeMode,
+	SessionStatus,
+	StartOptions,
+	Unavailable,
+} from './config/types';
+export { known, unavailable } from './config/types';
+
+// Controller
+export { createCameraController, DEFAULT_TEMPORARY_TTL_MS } from './core/controller';
+export type { AppStatus, CameraController, CameraControllerOptions } from './core/controller';
+
+// Ports + default adapters
+export type { CameraEngine, EngineOptions } from './native/cameraEngine';
+export { createVisionCameraEngine } from './native/cameraEngine';
+export type { PermissionPort } from './permissions/permissionPort';
+export { createVisionCameraPermissions } from './permissions/permissionPort';
+export type { ArtifactStore, FileSystemBridge, StoreOptions } from './storage/artifactStore';
+export { createArtifactStore, createCacheArtifactStore } from './storage/artifactStore';
+
+// React surface
+export { CameraPreview } from './react/CameraPreview';
+export type { CameraPreviewProps } from './react/CameraPreview';
+export { useCameraController, useCameraState } from './react/hooks';
+
+// Coordinate mapping (pure)
+export {
+	mapPointToImage,
+	mapPointToPreview,
+	mapRectToImage,
+	mapRectToPreview,
+} from './geometry/coordinateMapping';
+
+// Diagnostics
+export { CameraError, isCameraError, redact } from './diagnostics/errors';
+export type { CameraErrorCode } from './diagnostics/errors';
+export type { CameraLogEvent, CameraLogEventType, CameraLogger } from './diagnostics/logger';
+
+// Test adapter (FR-041) — exported from the single entrypoint so consumer tests
+// exercise the same published ports the real adapters implement.
+export {
+	createTestCamera,
+	createMemoryFileSystem,
+	DEFAULT_TEST_CAPABILITIES,
+} from './testing/testCameraAdapter';
+export type {
+	MemoryFileSystem,
+	TestCameraConfig,
+	TestCameraHandles,
+} from './testing/testCameraAdapter';