@chipmobilesdk/rn-camera 0.4.0 → 0.5.0

package/lib/typescript/commonjs/core/contract.d.ts

@@ -0,0 +1,92 @@
+/**
+ * What a camera controller is, for the app that drives it.
+ *
+ * The contract lives apart from the orchestration in `controller.ts`: it is
+ * what a consumer reads, and what a test double has to satisfy, while the file
+ * next to it is how this package happens to satisfy it.
+ */
+import type { CameraPermissionState, CameraState, CapabilityProfile, CapturedImage, CaptureRequest, FlashMode, StartOptions } from '../config/types';
+import type { CameraError } from '../diagnostics/errors';
+import type { CameraLogger } from '../diagnostics/logger';
+import type { CameraEngine } from '../native/cameraEngine';
+import type { SurfaceInfo, VisionSurface } from '../native/visionSurface';
+import type { PermissionPort } from '../permissions/permissionPort';
+import type { ArtifactStore } from '../storage/artifactStore';
+export declare const DEFAULT_TEMPORARY_TTL_MS: number;
+export type AppStatus = 'active' | 'background';
+export interface CameraControllerOptions {
+    /** Required. Use the default adapters, or `createTestCamera()` in tests. */
+    readonly engine: CameraEngine;
+    readonly permissions: PermissionPort;
+    readonly store?: ArtifactStore | undefined;
+    readonly logger?: CameraLogger | undefined;
+    readonly temporaryTtlMs?: number;
+    /**
+     * App foreground/background source. Defaults to rn-core's shared `appLifecycle()`,
+     * where `inactive` counts as background. Injectable so lifecycle rules are
+     * testable without an app (FR-015).
+     */
+    readonly subscribeToAppState?: (listener: (status: AppStatus) => void) => () => void;
+    /**
+     * Set false to skip the sweep that runs when the controller is first used
+     * (tests). Defaults to true.
+     */
+    readonly sweepOnInit?: boolean;
+    /**
+     * How long to wait for a preview surface to report frames before failing the
+     * start (FR-014). Only applies to an engine whose session belongs to the
+     * surface (`awaitsSurfaceStart`). Defaults to 8 s.
+     */
+    readonly startTimeoutMs?: number;
+    /** Test seam for that timeout. */
+    readonly scheduler?: {
+        setTimeout(callback: () => void, ms: number): unknown;
+        clearTimeout(handle: unknown): void;
+    };
+}
+export interface CameraController {
+    readonly state: CameraState;
+    subscribe(listener: (state: CameraState) => void): () => void;
+    getPermission(): Promise<CameraPermissionState>;
+    requestPermission(): Promise<CameraPermissionState>;
+    start(options?: StartOptions): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    stop(): Promise<void>;
+    capture(request?: CaptureRequest): Promise<CapturedImage>;
+    cleanup(image: CapturedImage | string): Promise<void>;
+    getCapabilities(): Promise<CapabilityProfile>;
+    setFlashMode(mode: FlashMode): void;
+    setTorch(enabled: boolean): Promise<void>;
+    /** Marks the preview surface mounted, enabling foreground auto-restart. */
+    setSurfaceMounted(mounted: boolean): void;
+    /**
+     * Attaches the mounted preview surface to the engine, for an engine that
+     * captures through it. Returns the detach function; a no-op for engines that
+     * own their own session.
+     */
+    attachSurface(surface: VisionSurface): () => void;
+    /**
+     * The preview reported frames: the session is active for real, not merely
+     * requested (CAM-08). What the surface turned out to be — the format's pixel
+     * size, the orientation, the device's own position — is published as
+     * `state.surface` for coordinate mapping.
+     */
+    reportSurfaceStarted(info: SurfaceInfo): void;
+    /** The preview's own session failed, or the OS took the camera away. */
+    reportSurfaceFailed(code: CameraError['code']): void;
+    /**
+     * Called by `CameraPreview` when the native preview surface cannot load (the
+     * VisionCamera module is missing or unlinked). Fails the session with
+     * `cameraUnavailable` rather than leaving a black preview and no error.
+     */
+    reportSurfaceUnavailable(): void;
+    /**
+     * Releases ports, listeners, and the camera. Safe to call twice. Afterwards
+     * `start`, `resume`, `capture` and the permission and capability reads reject
+     * with `notReady`; `stop`, `pause` and `cleanup` stay safe no-ops so teardown
+     * code never has to check.
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=contract.d.ts.map

package/lib/typescript/commonjs/core/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../src/core/contract.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/core/controller.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Camera controller — the object consuming apps actually drive.
+ *
+ * It owns observable state and orchestrates the three ports (engine,
+ * permissions, artifact store). All I/O lives here; the decisions live in
+ * `sessionMachine` and `captureController`, which stay pure so they can be
+ * tested without a camera.
+ */
+import { type CameraController, type CameraControllerOptions } from './contract';
+/** 24 hours (FR-029). */
+export { DEFAULT_TEMPORARY_TTL_MS, type AppStatus, type CameraController, type CameraControllerOptions, } from './contract';
+/** 8 s: a cold camera on a slow device, with room to spare (PERF-001 is 1.5 s). */
+export declare const DEFAULT_START_TIMEOUT_MS = 8000;
+export declare function createCameraController(options: CameraControllerOptions): CameraController;
+//# sourceMappingURL=controller.d.ts.map

package/lib/typescript/commonjs/core/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../src/core/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,OAAO,EAGN,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,MAAM,YAAY,CAAC;AAYpB,yBAAyB;AACzB,OAAO,EACN,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC5B,MAAM,YAAY,CAAC;AAQpB,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAE9C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CA2ZzF"}

package/lib/typescript/commonjs/core/sessionMachine.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Session lifecycle state machine (FR-014..FR-019).
+ *
+ * Pure and synchronous: it decides what a transition means, the controller
+ * performs the I/O. That split is what makes every lifecycle rule in
+ * `data-model.md` section 2 testable without a camera.
+ *
+ * Backgrounding STOPS rather than pauses. Both operating systems can reclaim
+ * the camera anyway, and holding it risks leaving the OS camera indicator lit
+ * after the app is no longer in front of the user (FR-015).
+ */
+import type { SessionStatus } from '../config/types';
+import { CameraError, type CameraErrorCode } from '../diagnostics/errors';
+export type SessionEvent = {
+    readonly type: 'START';
+} | {
+    readonly type: 'STARTED';
+} | {
+    readonly type: 'PAUSE';
+} | {
+    readonly type: 'RESUME';
+} | {
+    readonly type: 'STOP';
+} | {
+    readonly type: 'STOPPED';
+} | {
+    readonly type: 'BACKGROUND';
+} | {
+    readonly type: 'FOREGROUND';
+    readonly surfaceMounted: boolean;
+} | {
+    readonly type: 'FAIL';
+    readonly code: CameraErrorCode;
+} | {
+    readonly type: 'START_TIMEOUT';
+};
+export interface SessionSnapshot {
+    readonly status: SessionStatus;
+    readonly error: CameraError | null;
+}
+export declare const initialSession: SessionSnapshot;
+export declare function canStart(status: SessionStatus): boolean;
+/** Capture is only ever legal from a fully active session (FR-020). */
+export declare function canCapture(status: SessionStatus): boolean;
+export declare function sessionReducer(snapshot: SessionSnapshot, event: SessionEvent): SessionSnapshot;
+//# sourceMappingURL=sessionMachine.d.ts.map

package/lib/typescript/commonjs/core/sessionMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionMachine.d.ts","sourceRoot":"","sources":["../../../../src/core/sessionMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,MAAM,YAAY,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,cAAc,EAAE,eAAiD,CAAC;AAK/E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEvD;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEzD;AAMD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,eAAe,CAqD9F"}

package/lib/typescript/commonjs/core/sessionRuntime.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The session's own I/O: starting it, waiting for frames, releasing it, and
+ * following the app in and out of the foreground.
+ *
+ * Split out of `controller.ts`, which had grown to hold three jobs at once:
+ * publishing state, running the session, and serving the public API. The
+ * decisions still live in `sessionMachine` (pure); this is the part that
+ * actually awaits the engine, and the controller composes it.
+ *
+ * It reads and writes the controller's state through `SessionContext` rather
+ * than owning it: one snapshot reaches subscribers, whichever part of the
+ * controller changed it.
+ */
+import type { StartOptions } from '../config/types';
+import { type CameraErrorCode } from '../diagnostics/errors';
+import type { CameraLogger } from '../diagnostics/logger';
+import type { CameraEngine } from '../native/cameraEngine';
+import type { SurfaceInfo } from '../native/visionSurface';
+import type { SessionEvent, SessionSnapshot } from './sessionMachine';
+/** What the runtime needs from the controller that owns the state. */
+export interface SessionContext {
+    readonly engine: CameraEngine;
+    readonly logger: CameraLogger;
+    /** How long to wait for a preview surface to report frames. */
+    readonly startTimeoutMs: number;
+    readonly scheduler: {
+        setTimeout(callback: () => void, ms: number): unknown;
+        clearTimeout(handle: unknown): void;
+    };
+    session(): SessionSnapshot;
+    dispatch(event: SessionEvent): void;
+    emit(): void;
+    cameraPosition(): 'front' | 'back';
+    setCameraPosition(position: 'front' | 'back'): void;
+    torchEnabled(): boolean;
+    setTorchEnabled(enabled: boolean): void;
+    surfaceMounted(): boolean;
+    permissionGranted(): boolean;
+    disposed(): boolean;
+}
+export interface SessionRuntime {
+    /** Starts the engine and, where the surface owns the session, waits for frames. */
+    start(options?: StartOptions): Promise<void>;
+    /** Turns the torch off and releases the camera. Safe from any state. */
+    release(): Promise<void>;
+    /** Torch off, whatever the session is doing. */
+    forceTorchOff(): Promise<void>;
+    /** The app went to the background or came back. */
+    onAppState(status: 'active' | 'background'): void;
+    /** The preview reported frames; carries what the mounted device turned out to be. */
+    reportSurfaceStarted(info: SurfaceInfo): void;
+    /** The preview's own session failed, or the OS took the camera. */
+    reportSurfaceFailed(code: CameraErrorCode): void;
+    /** The engine lost the camera: another app, a call, a disconnected device. */
+    onInterruption(code: CameraErrorCode): void;
+    /** What the surface last reported, for the published state. */
+    surfaceInfo(): SurfaceInfo | null;
+    /** Set when the app foregrounds with a surface mounted, so the session restarts. */
+    armResumeOnForeground(): void;
+    /** A release still in flight, so a restart can wait for it. */
+    pending(): Promise<void> | undefined;
+}
+export declare function createSessionRuntime(context: SessionContext): SessionRuntime;
+//# sourceMappingURL=sessionRuntime.d.ts.map

package/lib/typescript/commonjs/core/sessionRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionRuntime.d.ts","sourceRoot":"","sources":["../../../../src/core/sessionRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEtE,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE;QACnB,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QACtD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;KACpC,CAAC;IACF,OAAO,IAAI,eAAe,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,IAAI,IAAI,IAAI,CAAC;IACb,cAAc,IAAI,OAAO,GAAG,MAAM,CAAC;IACnC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACpD,YAAY,IAAI,OAAO,CAAC;IACxB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,cAAc,IAAI,OAAO,CAAC;IAC1B,iBAAiB,IAAI,OAAO,CAAC;IAC7B,QAAQ,IAAI,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,mFAAmF;IACnF,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,wEAAwE;IACxE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,gDAAgD;IAChD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,mDAAmD;IACnD,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI,CAAC;IAClD,qFAAqF;IACrF,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9C,mEAAmE;IACnE,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACjD,8EAA8E;IAC9E,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,+DAA+D;IAC/D,WAAW,IAAI,WAAW,GAAG,IAAI,CAAC;IAClC,oFAAoF;IACpF,qBAAqB,IAAI,IAAI,CAAC;IAC9B,+DAA+D;IAC/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CACrC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CA+K5E"}

package/lib/typescript/commonjs/diagnostics/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Typed error taxonomy (FR-044) and redaction helper (FR-038).
+ *
+ * The taxonomy exists so consuming apps can branch on `code` and `recoverable`
+ * instead of string-matching messages. Messages never carry file paths or image
+ * payloads — `redact` is applied before any value reaches a log sink.
+ */
+import { SdkError } from '@chipmobilesdk/rn-core';
+export type CameraErrorCode = 'permissionDenied' | 'cameraUnavailable' | 'cameraBlocked' | 'cameraInUse' | 'sessionConflict' | 'notReady' | 'captureInProgress' | 'captureFailed' | 'storageFailure' | 'unsupportedCapability' | 'interrupted';
+/** The package's error; an `SdkError` (`@chipmobilesdk/rn-core`) with `pkg: 'rn-camera'`. */
+export declare class CameraError extends SdkError<CameraErrorCode> {
+    constructor(code: CameraErrorCode, message?: string);
+    /** @deprecated Use `retryable`, the name every SDK package shares. */
+    get recoverable(): boolean;
+}
+export declare function isCameraError(value: unknown): value is CameraError;
+/**
+ * Strips paths and payload-shaped strings from a value before logging (FR-038).
+ * Recurses through plain objects and arrays; known-sensitive keys are dropped
+ * wholesale rather than pattern-matched, since a bare filename has no separator
+ * for the path pattern to catch.
+ */
+export declare function redact(value: unknown): unknown;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/commonjs/diagnostics/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAiC,QAAQ,EAAkB,MAAM,wBAAwB,CAAC;AAEjG,MAAM,MAAM,eAAe,GACxB,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,aAAa,GACb,iBAAiB,GACjB,UAAU,GACV,mBAAmB,GACnB,eAAe,GACf,gBAAgB,GAChB,uBAAuB,GACvB,aAAa,CAAC;AAejB,6FAA6F;AAC7F,qBAAa,WAAY,SAAQ,QAAQ,CAAC,eAAe,CAAC;gBAC7C,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM;IAKnD,sEAAsE;IACtE,IAAI,WAAW,IAAI,OAAO,CAEzB;CACD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAeD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqB9C"}

package/lib/typescript/commonjs/diagnostics/logger.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Optional consumer-supplied logger (research R4).
+ *
+ * The default is no logging at all, so FR-038 holds whether or not a consumer
+ * opts in. Event bodies carry codes and states only — never file paths, never
+ * image data — so an opted-in logger still cannot leak an image path.
+ */
+export type CameraLogEventType = 'session' | 'permission' | 'capture' | 'capability' | 'cleanup';
+export interface CameraLogEvent {
+    readonly type: CameraLogEventType;
+    readonly code: string;
+    readonly recoverable?: boolean | undefined;
+}
+export interface CameraLogger {
+    log(event: CameraLogEvent): void;
+}
+/**
+ * Every event also reaches the app's SDK sinks (`installSdkSink`, CORE-08), as
+ * `<type>.<code>`: the same code-and-state body, so nothing new can leak.
+ */
+export declare function withSdkSinks(logger: CameraLogger): CameraLogger;
+/** No-op logger used when the consumer supplies none. */
+export declare const silentLogger: CameraLogger;
+//# sourceMappingURL=logger.d.ts.map

package/lib/typescript/commonjs/diagnostics/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjG,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC5B,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAW/D;AAED,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,YAI1B,CAAC"}

package/lib/typescript/commonjs/geometry/coordinateMapping.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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';
+/**
+ * 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 declare function mapPointToImage(point: Point, geometry: PreviewGeometry): Point;
+/** Maps a captured-image point into preview space. Exact inverse of the above. */
+export declare function mapPointToPreview(point: Point, geometry: PreviewGeometry): Point;
+export declare function mapRectToImage(rect: Rect, geometry: PreviewGeometry): Rect;
+export declare function mapRectToPreview(rect: Rect, geometry: PreviewGeometry): Rect;
+//# sourceMappingURL=coordinateMapping.d.ts.map

package/lib/typescript/commonjs/geometry/coordinateMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinateMapping.d.ts","sourceRoot":"","sources":["../../../../src/geometry/coordinateMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAwEpE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,GAAG,KAAK,CAI9E;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,GAAG,KAAK,CAQhF;AAYD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAK1E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAK5E"}

package/lib/typescript/commonjs/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @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.
+ */
+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';
+export { createCameraController, DEFAULT_TEMPORARY_TTL_MS } from './core/controller';
+export type { AppStatus, CameraController, CameraControllerOptions } from './core/controller';
+export type { CameraEngine } from './native/cameraEngine';
+export type { SurfaceInfo, SurfaceRegistry, VisionSurface } from './native/visionSurface';
+export { createSurfaceRegistry } from './native/visionSurface';
+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';
+export { CameraPreview } from './react/CameraPreview';
+export type { CameraPreviewProps } from './react/CameraPreview';
+export { useCameraController, useCameraState } from './react/hooks';
+export { mapPointToImage, mapPointToPreview, mapRectToImage, mapRectToPreview, } from './geometry/coordinateMapping';
+export { CameraError, isCameraError, redact } from './diagnostics/errors';
+export type { CameraErrorCode } from './diagnostics/errors';
+export type { CameraLogEvent, CameraLogEventType, CameraLogger } from './diagnostics/logger';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EACX,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,SAAS,EACT,KAAK,EACL,KAAK,EACL,KAAK,EACL,eAAe,EACf,IAAI,EACJ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACrF,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG9F,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAGxF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,GAChB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/typescript/commonjs/native/cameraEngine.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CameraEngine port + default react-native-vision-camera adapter.
+ *
+ * This is the only module that knows a native camera library exists. The
+ * default adapter lazily requires it, mirroring
+ * `packages/rn-auth/src/tokens/secureStore.ts`, so unit tests that inject a
+ * fake never load native code.
+ *
+ * Preview frames never cross this boundary: `capture` returns a file reference
+ * plus metadata and nothing else (PERF-002, FR-021a).
+ *
+ * Targets the VisionCamera v5 API, where devices come from an async
+ * `CameraDeviceFactory` and capture runs through the photo output owned by the
+ * mounted preview surface (see `visionSurface`).
+ */
+import type { CapabilityProfile, CapturedImage, CaptureRequest, StartOptions } from '../config/types';
+import type { CameraErrorCode } from '../diagnostics/errors';
+import { type VisionSurface } from './visionSurface';
+export interface CameraEngine {
+    start(options: StartOptions): Promise<void>;
+    stop(): Promise<void>;
+    capture(request: CaptureRequest): Promise<CapturedImage>;
+    setTorch(enabled: boolean): Promise<void>;
+    getCapabilities(): Promise<CapabilityProfile>;
+    /**
+     * True when `start()` only prepares the engine and the session becomes
+     * active once a mounted preview surface reports frames. The controller then
+     * waits for that report instead of calling the session active immediately,
+     * and times out rather than sitting in `starting` forever (CAM-08).
+     */
+    readonly awaitsSurfaceStart?: boolean;
+    /**
+     * Attaches the mounted preview surface this engine captures through.
+     * Returns the detach function. Engines that own their own session omit it.
+     */
+    attachSurface?(surface: VisionSurface): () => void;
+    /**
+     * The engine lost the camera: another app took it, a call came in, the
+     * device was disconnected. The controller tears the session down with this
+     * code rather than leaving a frozen preview (CAM-19).
+     */
+    subscribeToInterruptions?(listener: (code: CameraErrorCode) => void): () => void;
+}
+/**
+ * Default engine. VisionCamera drives the preview through its own React
+ * component, so this adapter owns capability discovery while `CameraPreview`
+ * owns the rendered surface and the photo output that capture runs through.
+ */
+export declare function createVisionCameraEngine(): CameraEngine;
+//# sourceMappingURL=cameraEngine.d.ts.map

package/lib/typescript/commonjs/native/cameraEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraEngine.d.ts","sourceRoot":"","sources":["../../../../src/native/cameraEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACX,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC;;;OAGG;IACH,aAAa,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAAC;IACnD;;;;OAIG;IACH,wBAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACjF;AASD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,CAwEvD"}

package/lib/typescript/commonjs/native/visionCameraPeer.d.ts

@@ -0,0 +1,2 @@
+export declare function loadVisionCamera<T>(): T;
+//# sourceMappingURL=visionCameraPeer.d.ts.map

package/lib/typescript/commonjs/native/visionCameraPeer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visionCameraPeer.d.ts","sourceRoot":"","sources":["../../../../src/native/visionCameraPeer.ts"],"names":[],"mappings":"AAqBA,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAQvC"}

package/lib/typescript/commonjs/native/visionSurface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The port between a mounted preview surface and an engine.
+ *
+ * VisionCamera v5 owns capture through the session the `<Camera>` view
+ * configures, so the photo output only exists while a surface is mounted. The
+ * engine is created before any surface exists, so the surface attaches itself
+ * to the engine and the engine reads it back at capture time.
+ *
+ * The registry belongs to an engine instance, not to the module. A module-level
+ * slot meant two controllers — two screens in a stack — shared one, so a
+ * capture could run through the other screen's surface (CAM-20).
+ */
+import type { CameraErrorCode } from '../diagnostics/errors';
+import type { CapturedImage, CaptureRequest } from '../config/types';
+/** What the mounted preview actually is, once the device and format are known. */
+export interface SurfaceInfo {
+    /** Capture dimensions of the selected format, in pixels. */
+    readonly imageWidth: number;
+    readonly imageHeight: number;
+    /** Clockwise degrees the image is rotated relative to the preview. */
+    readonly orientation: number;
+    /** The position of the device actually mounted, whatever was asked for. */
+    readonly cameraPosition: 'front' | 'back';
+}
+export interface VisionSurface {
+    capture(request: CaptureRequest): Promise<CapturedImage>;
+}
+/** What a surface reports back about its own session. */
+export interface SurfaceEvents {
+    /** The preview is running: frames are arriving. */
+    onStarted(info: SurfaceInfo): void;
+    /** The session failed or was taken away (another app, a phone call). */
+    onFailed(code: CameraErrorCode): void;
+}
+export interface SurfaceRegistry {
+    /** Attaches the mounted surface. Returns the detach function. */
+    attach(surface: VisionSurface): () => void;
+    current(): VisionSurface | null;
+}
+export declare function createSurfaceRegistry(): SurfaceRegistry;
+//# sourceMappingURL=visionSurface.d.ts.map

package/lib/typescript/commonjs/native/visionSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visionSurface.d.ts","sourceRoot":"","sources":["../../../../src/native/visionSurface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACzD;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC7B,mDAAmD;IACnD,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAAC;IAC3C,OAAO,IAAI,aAAa,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAavD"}

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/typescript/commonjs/permissions/permissionPort.d.ts

@@ -0,0 +1,24 @@
+/**
+ * PermissionPort + default react-native-vision-camera adapter (FR-004..FR-008).
+ *
+ * `getStatus` never prompts and never opens a session (FR-005); only `request`
+ * may prompt, and it refuses to re-prompt once the OS reports a permanent
+ * denial (FR-006). The default adapter lazily requires the native module so
+ * unit tests that inject a fake never load native code — same approach as
+ * `packages/rn-auth/src/tokens/secureStore.ts`.
+ *
+ * The adapter targets the VisionCamera v5 API: permissions live on the
+ * `VisionCamera` hybrid object, not on the `Camera` component (which carries no
+ * statics since v5).
+ */
+import type { CameraPermissionState } from '../config/types';
+export interface PermissionPort {
+    /** Reads current status. MUST NOT prompt or start a session (FR-005). */
+    getStatus(): Promise<CameraPermissionState>;
+    /** Explicitly requests permission (FR-006). */
+    request(): Promise<CameraPermissionState>;
+    /** Notifies on external changes, e.g. revocation in Settings (FR-007). */
+    subscribe(listener: (state: CameraPermissionState) => void): () => void;
+}
+export declare function createVisionCameraPermissions(): PermissionPort;
+//# sourceMappingURL=permissionPort.d.ts.map

package/lib/typescript/commonjs/permissions/permissionPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionPort.d.ts","sourceRoot":"","sources":["../../../../src/permissions/permissionPort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC9B,yEAAyE;IACzE,SAAS,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,OAAO,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACxE;AAwBD,wBAAgB,6BAA6B,IAAI,cAAc,CAoE9D"}

package/lib/typescript/commonjs/react/CameraPreview.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Camera preview surface (FR-009..FR-013, UX-001, UX-003).
+ *
+ * Renders the camera feed and nothing else: no shutter button, no permission
+ * copy, no error text, and no theme dependency. Consuming apps draw their own
+ * controls and overlays through `children`, positioned with the geometry
+ * reported by `onGeometryChange`.
+ */
+import React from 'react';
+import { type AccessibilityRole, type StyleProp, type ViewStyle } from 'react-native';
+import type { PreviewGeometry, ResizeMode } from '../config/types';
+import type { CameraController } from '../core/controller';
+export interface CameraPreviewProps {
+    readonly controller: CameraController;
+    readonly resizeMode?: ResizeMode;
+    readonly style?: StyleProp<ViewStyle>;
+    readonly onGeometryChange?: (geometry: PreviewGeometry) => void;
+    /** Forwarded untouched; the package never overrides consumer a11y (UX-003). */
+    readonly accessibilityLabel?: string;
+    readonly accessibilityRole?: AccessibilityRole;
+    /** Overlay layer rendered above the feed. */
+    readonly children?: React.ReactNode;
+}
+export declare const CameraPreview: React.FC<CameraPreviewProps>;
+//# sourceMappingURL=CameraPreview.d.ts.map

package/lib/typescript/commonjs/react/CameraPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraPreview.d.ts","sourceRoot":"","sources":["../../../../src/react/CameraPreview.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAoD,MAAM,OAAO,CAAC;AACzE,OAAO,EAEN,KAAK,iBAAiB,EAEtB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAM3D,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IAChE,+EAA+E;IAC/E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAiBD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAqHtD,CAAC"}

package/lib/typescript/commonjs/react/VisionCameraFeed.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The live VisionCamera surface rendered inside `CameraPreview`.
+ *
+ * Split into its own module so `CameraPreview` can require it lazily: consumers
+ * that only use the pure utilities or the test adapter never load the native
+ * module, while the hooks this component needs (`useCameraDevice`,
+ * `usePhotoOutput`) can still be called normally.
+ *
+ * It also owns capture. In VisionCamera v5 the photo output belongs to the
+ * session the `<Camera>` view configures, so the output only exists while this
+ * surface is mounted; it is published to the engine through `visionSurface`.
+ */
+import React from 'react';
+import { type CameraPosition, type ResizeMode } from '../config/types';
+import { type CameraErrorCode } from '../diagnostics/errors';
+import type { SurfaceInfo, VisionSurface } from '../native/visionSurface';
+export interface VisionCameraFeedProps {
+    readonly cameraPosition: CameraPosition;
+    readonly resizeMode: ResizeMode;
+    readonly torchEnabled: boolean;
+    /** False while the session is paused: the view stays mounted, the camera stops. */
+    readonly isActive: boolean;
+    /** Attaches this surface to the engine that captures through it. */
+    readonly attachSurface: (surface: VisionSurface) => () => void;
+    /** The preview is running; carries what the mounted device turned out to be. */
+    readonly onStarted: (info: SurfaceInfo) => void;
+    /** The session failed or the camera was taken away. */
+    readonly onFailed: (code: CameraErrorCode) => void;
+}
+export declare const VisionCameraFeed: React.FC<VisionCameraFeedProps>;
+//# sourceMappingURL=VisionCameraFeed.d.ts.map

package/lib/typescript/commonjs/react/VisionCameraFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisionCameraFeed.d.ts","sourceRoot":"","sources":["../../../../src/react/VisionCameraFeed.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAuC,MAAM,OAAO,CAAC;AAS5D,OAAO,EAGN,KAAK,cAAc,EAInB,KAAK,UAAU,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,IAAI,CAAC;IAC/D,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD;AA0ID,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAmD5D,CAAC"}

package/lib/typescript/commonjs/react/hooks.d.ts

@@ -0,0 +1,12 @@
+/**
+ * React bindings for the camera controller.
+ *
+ * `useCameraController` owns the controller lifetime and disposes it on
+ * unmount, which is what guarantees the camera is released when a screen goes
+ * away (FR-016).
+ */
+import type { CameraState } from '../config/types';
+import { type CameraController, type CameraControllerOptions } from '../core/controller';
+export declare function useCameraController(options: CameraControllerOptions): CameraController;
+export declare function useCameraState(controller: CameraController): CameraState;
+//# sourceMappingURL=hooks.d.ts.map

package/lib/typescript/commonjs/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,MAAM,oBAAoB,CAAC;AAE5B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CA0BtF;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,WAAW,CAUxE"}