@ai-matrx/capture 0.2.0 → 0.3.0

package/dist/react.d.cts

@@ -114,6 +114,54 @@ interface CaptureCameraSlots {
     /** Free overlays rendered above everything (sheets, pagers). */
     overlays?: React.ReactNode;
 }
+/** One action on the v3 right-hand rail. */
+interface CaptureRailAction {
+    id: string;
+    /** Accessible name; also the label shown when `showLabels` is on. */
+    label: string;
+    icon: React.ReactNode;
+    /** Engaged/on — rendered in the accent colour. */
+    active?: boolean;
+    /** A short read-out under the icon (e.g. "3s", "4:3", "Auto"). */
+    valueLabel?: string;
+    disabled?: boolean;
+    /**
+     * Primary actions stay visible when the rail is collapsed. Everything else
+     * hides behind the chevron. Keep this to the two or three a user reaches for
+     * without thinking — a rail where nothing collapses is just a long rail.
+     */
+    primary?: boolean;
+    onPress: () => void;
+}
+/**
+ * Slots for the v3 chrome. Deliberately fewer and differently shaped than
+ * `CaptureCameraSlots`: v3 has no mode row, so the slots that existed to sit
+ * around one are gone, and the rail replaces the options grid.
+ */
+interface CaptureCameraV3Slots {
+    /** Centre of the top row — the item label / count. Keep it to one line. */
+    topCenter?: React.ReactNode;
+    /** Honesty chips under the top row (QR confirmation, upload progress). */
+    statusChips?: React.ReactNode;
+    /** Rendered OVER the feed just above the shutter row — the filmstrip home. */
+    aboveShutter?: React.ReactNode;
+    /**
+     * The one action to the RIGHT of the shutter (Next / Break / Process).
+     * Exactly one: the shutter row is a thumb-reach zone and a second control
+     * there turns a one-hand camera into a two-hand one.
+     */
+    shutterTrailing?: React.ReactNode;
+    /** Actions on the right rail, in order. */
+    railActions?: CaptureRailAction[];
+    /**
+     * The expanding text entry pinned to the top row (serial, tag, caption).
+     * Supply `<CaptureExpandingField/>` or any control — it is a slot so a host
+     * that needs none pays nothing for it.
+     */
+    topEntry?: React.ReactNode;
+    /** Free overlays above everything (sheets, pagers). */
+    overlays?: React.ReactNode;
+}
 
 /**
  * CaptureSheet — the iOS-style system sheet used over the camera: a light,
@@ -240,6 +288,9 @@ interface CameraCaptureProps {
     preview: React__default.ReactNode;
     /** Session media — enables the package-owned filmstrip + viewer + editor. */
     media?: CaptureMediaSession;
+    /** Fires when the package review loop (viewer or editor) opens/closes over
+     *  the live feed — hosts pause things that watch the feed (QR scanning). */
+    onReviewOpenChange?: (open: boolean) => void;
     /** Close affordance top-left; omitted = no close button. */
     onClose?: () => void;
     /** Body + actions for the camera-blocked iOS-style sheet. */
@@ -252,7 +303,182 @@ interface CameraCaptureProps {
     shutterDisabled?: boolean;
     slots?: CaptureCameraSlots;
 }
-declare function CameraCapture({ engine, cloud, mode, onModeChange, preview, media, onClose, blockedSheet, controlsHidden, shutterDisabled, slots, }: CameraCaptureProps): React__default.JSX.Element;
+declare function CameraCapture({ engine, cloud, mode, onModeChange, preview, media, onReviewOpenChange, onClose, blockedSheet, controlsHidden, shutterDisabled, slots, }: CameraCaptureProps): React__default.JSX.Element;
+
+/**
+ * CameraCaptureV3 — the vertical-rail camera chrome.
+ *
+ * A SECOND chrome over the same ports as `CameraCapture`, not a replacement.
+ * Same engine, same cloud port, same package-owned review loop (filmstrip →
+ * viewer → editor). What differs is the layout and the input model, and every
+ * difference answers something the v2 chrome got wrong on a real phone
+ * (Arman, 2026-08-30):
+ *
+ *   ONE SHUTTER.      Tap = photo, press-and-hold = video. v2 spent a whole
+ *                     row on a mode selector, so the user paid bar height AND
+ *                     a decision before the moment they were trying to catch.
+ *   THE RIGHT EDGE.   Options live on a rail over the feed instead of a
+ *                     two-tap grid behind a button. No layout cost, one tap
+ *                     to anything, and the viewfinder stays whole.
+ *   IT COLLAPSES.     Extras hide behind a chevron so the idle rail is short.
+ *   TEXT IS A BUTTON. Entry expands from a pill (see CaptureExpandingField) —
+ *                     no permanent field, no keyboard-bait over the frame.
+ *   ONE MEDIA DOOR.   There is no UPLOAD mode. The library button is the only
+ *                     way to existing media, and picking files is an option
+ *                     INSIDE that drawer — the host renders it there.
+ *
+ * Deliberately NOT copied from the app this borrows its shape from: fixed
+ * duration choices (they belong to that product's format, not to a camera),
+ * and the oversized promo pill for a new feature (chrome is not a billboard).
+ *
+ * Package source (`@ai-matrx/capture`). UI state only — capture, streams and
+ * persistence come from the injected engine.
+ */
+
+interface CameraCaptureV3Props {
+    engine: CaptureCameraEngine;
+    /** THE CLOUD LAW: still required. v3 changes where the door is, not whether
+     *  there is one — and in v3 it is the ONLY door to existing media. */
+    cloud: CaptureCloudPort;
+    preview: React__default.ReactNode;
+    media?: CaptureMediaSession;
+    /**
+     * Fired on pointer-DOWN, before the hold threshold decides photo vs video.
+     *
+     * 🚨 THIS EXISTS FOR iOS. Hosts warm the microphone when they believe a
+     * recording is coming (one permission prompt per medium). With a mode row
+     * that signal arrived when the user chose VIDEO — early. With a hold
+     * shutter there is no such moment, so waiting for the recording to actually
+     * start means warming DURING the take, which on iOS Safari costs the first
+     * second of audio or throws a prompt over the viewfinder mid-recording.
+     *
+     * The host is expected to make this idempotent: it fires on every press,
+     * including the taps that turn out to be photos.
+     */
+    onRecordIntent?: () => void;
+    /** Ring completes here; presentational only — it never stops the recorder. */
+    maxRecordSeconds?: number;
+    onReviewOpenChange?: (open: boolean) => void;
+    onClose?: () => void;
+    blockedSheet?: {
+        body: React__default.ReactNode;
+        actions: CaptureSheetAction[];
+    };
+    /** Hide all chrome except status chips (host renders its own toggle). */
+    controlsHidden?: boolean;
+    shutterDisabled?: boolean;
+    slots?: CaptureCameraV3Slots;
+}
+declare function CameraCaptureV3({ engine, cloud, preview, media, onRecordIntent, maxRecordSeconds, onReviewOpenChange, onClose, blockedSheet, controlsHidden, shutterDisabled, slots, }: CameraCaptureV3Props): React__default.JSX.Element;
+
+/**
+ * CaptureExpandingField — a pill BUTTON that becomes a text field on press,
+ * and goes back to being a button when it is done.
+ *
+ * 🚨 WHY IT IS NOT AN INPUT (Arman, 2026-08-30). v2 pinned a live `<input>` in
+ * the bottom bar. On a camera that is wrong three ways: it occupies a row
+ * permanently for something used occasionally, it invites the keyboard over
+ * the viewfinder on an accidental tap, and it makes an idle camera look like a
+ * form. The pattern that fits is the one Apple uses for search — a compact
+ * control that admits it is a control, and grows only when you mean it.
+ *
+ * COMMIT ON UNMOUNT, always. The v2 input already learned this the hard way:
+ * hiding the controls or switching item remounts the field, `onBlur` never
+ * fires, and a typed value evaporates. Anything typed is committed on the way
+ * out, whatever caused the exit.
+ *
+ * Presentational + local draft state only; the host owns what a value means.
+ */
+
+interface CaptureExpandingFieldProps {
+    /** Collapsed label, e.g. "Serial / tag". Also the accessible name. */
+    label: string;
+    /** Placeholder once expanded. Defaults to `label`. */
+    placeholder?: string;
+    /** Icon shown in the collapsed pill and at the field's leading edge. */
+    icon?: React__default.ReactNode;
+    /** Commit a non-empty trimmed value. Called on Enter, blur, and unmount. */
+    onCommit: (value: string) => void;
+    /** Start expanded (a host that knows entry is imminent). */
+    defaultExpanded?: boolean;
+    disabled?: boolean;
+    /** Shown in the collapsed pill instead of `label` — e.g. the current tag. */
+    currentValue?: string | null;
+    className?: string;
+}
+declare function CaptureExpandingField({ label, placeholder, icon, onCommit, defaultExpanded, disabled, currentValue, className, }: CaptureExpandingFieldProps): React__default.JSX.Element;
+
+/**
+ * CaptureRail — the vertical action rail down the RIGHT edge of the frame.
+ *
+ * Why the edge and not a bar: a bottom bar steals height from the viewfinder
+ * on every phone, and the options grid it fed cost two taps to reach anything.
+ * A rail sits over the feed, costs no layout, and puts every option one tap
+ * away under the thumb that is already holding the phone.
+ *
+ * Why it collapses: a complete rail is a long rail, and a long rail is a wall
+ * of icons nobody reads. Actions marked `primary` stay; the rest hide behind a
+ * chevron. The chevron is only rendered when there is something to hide —
+ * a control that toggles nothing is a lie about the interface.
+ *
+ * Presentational only.
+ */
+
+interface CaptureRailProps {
+    actions: CaptureRailAction[];
+    /** Start expanded. Default false — an idle camera shows the short rail. */
+    defaultExpanded?: boolean;
+    className?: string;
+}
+declare function CaptureRail({ actions, defaultExpanded, className, }: CaptureRailProps): React__default.JSX.Element | null;
+
+/**
+ * HoldShutter — ONE button for photo and video.
+ *
+ * Tap takes a photo. Press and hold records, and releasing stops. The mode is
+ * therefore a gesture, not a control you must set before the moment you are
+ * trying to catch — which is the whole reason the v2 mode row was wrong on a
+ * phone: it cost bar height AND a decision, and the decision was usually made
+ * after the thing had happened.
+ *
+ * The interaction, precisely:
+ *
+ *   pointerdown            → arm a hold timer (HOLD_MS)
+ *   timer fires            → start recording, ring begins filling
+ *   pointerup  < HOLD_MS   → cancel the timer, take a photo
+ *   pointerup >= HOLD_MS   → stop recording
+ *   pointercancel / leave  → same as pointerup (a drag off the button must not
+ *                            leave the camera recording with nothing to stop it)
+ *
+ * A LOCK is deliberate: after ~1.2s of recording the button latches, so a user
+ * whose finger slips does not lose the take. Once latched, the next tap stops.
+ * Without it, the single-button model punishes exactly the long recordings it
+ * exists to make easy.
+ *
+ * Presentational only — the host owns the recorder.
+ */
+
+interface HoldShutterProps {
+    recording: boolean;
+    /** Elapsed recording seconds, for the ring + read-out. */
+    elapsedSeconds: number;
+    /**
+     * Ring completes at this many seconds. Presentational only — it does not
+     * stop the recorder, because a chrome that silently ends a take is worse
+     * than one that shows a full ring. Omit for no progress arc.
+     */
+    maxSeconds?: number;
+    disabled?: boolean;
+    /**
+     * Fired on pointer-DOWN, before the hold threshold decides photo vs video.
+     * Hosts use it to warm the microphone — see `CameraCaptureV3Props`.
+     */
+    onPressStart?: () => void;
+    onPhoto: () => void;
+    onStartRecording: () => void;
+    onStopRecording: () => void;
+}
+declare function HoldShutter({ recording, elapsedSeconds, maxSeconds, disabled, onPressStart, onPhoto, onStartRecording, onStopRecording, }: HoldShutterProps): React__default.JSX.Element;
 
 /**
  * CameraFeed — the package's live preview <video> for the default engine
@@ -491,4 +717,4 @@ interface DefaultEngineOptions {
 }
 declare function useDefaultCaptureEngine(options: DefaultEngineOptions): CaptureCameraEngine;
 
-export { CameraCapture, type CameraCaptureProps, CameraFeed, type CaptureAspect, type CaptureCameraEngine, type CaptureCameraMode, type CaptureCameraSlots, type CaptureCloudPort, CaptureFilmstrip, type CaptureFilmstripProps, type CaptureMediaItem, type CaptureMediaSession, type CaptureOptionTile, CaptureSheet, type CaptureSheetAction, type CaptureSheetProps, type CaptureTimerSetting, CountdownOverlay, type DefaultEngineOptions, GridOverlay, ImageEditSheet, type ImageEditSheetProps, MediaViewer, type MediaViewerProps, ModeSelector, type ModeSelectorProps, OptionsGridPanel, type OptionsGridPanelProps, type ResolvedMedia, ShutterButton, type ShutterButtonProps, type TrackControls, ZoomRow, type ZoomRowProps, getMediaUrl, invalidateMedia, primeMedia, useDefaultCaptureEngine, useMediaUrl, useTrackControls };
+export { CameraCapture, type CameraCaptureProps, CameraCaptureV3, type CameraCaptureV3Props, CameraFeed, type CaptureAspect, type CaptureCameraEngine, type CaptureCameraMode, type CaptureCameraSlots, type CaptureCameraV3Slots, type CaptureCloudPort, CaptureExpandingField, type CaptureExpandingFieldProps, CaptureFilmstrip, type CaptureFilmstripProps, type CaptureMediaItem, type CaptureMediaSession, type CaptureOptionTile, CaptureRail, type CaptureRailAction, type CaptureRailProps, CaptureSheet, type CaptureSheetAction, type CaptureSheetProps, type CaptureTimerSetting, CountdownOverlay, type DefaultEngineOptions, GridOverlay, HoldShutter, type HoldShutterProps, ImageEditSheet, type ImageEditSheetProps, MediaViewer, type MediaViewerProps, ModeSelector, type ModeSelectorProps, OptionsGridPanel, type OptionsGridPanelProps, type ResolvedMedia, ShutterButton, type ShutterButtonProps, type TrackControls, ZoomRow, type ZoomRowProps, getMediaUrl, invalidateMedia, primeMedia, useDefaultCaptureEngine, useMediaUrl, useTrackControls };

package/dist/react.d.ts

@@ -114,6 +114,54 @@ interface CaptureCameraSlots {
     /** Free overlays rendered above everything (sheets, pagers). */
     overlays?: React.ReactNode;
 }
+/** One action on the v3 right-hand rail. */
+interface CaptureRailAction {
+    id: string;
+    /** Accessible name; also the label shown when `showLabels` is on. */
+    label: string;
+    icon: React.ReactNode;
+    /** Engaged/on — rendered in the accent colour. */
+    active?: boolean;
+    /** A short read-out under the icon (e.g. "3s", "4:3", "Auto"). */
+    valueLabel?: string;
+    disabled?: boolean;
+    /**
+     * Primary actions stay visible when the rail is collapsed. Everything else
+     * hides behind the chevron. Keep this to the two or three a user reaches for
+     * without thinking — a rail where nothing collapses is just a long rail.
+     */
+    primary?: boolean;
+    onPress: () => void;
+}
+/**
+ * Slots for the v3 chrome. Deliberately fewer and differently shaped than
+ * `CaptureCameraSlots`: v3 has no mode row, so the slots that existed to sit
+ * around one are gone, and the rail replaces the options grid.
+ */
+interface CaptureCameraV3Slots {
+    /** Centre of the top row — the item label / count. Keep it to one line. */
+    topCenter?: React.ReactNode;
+    /** Honesty chips under the top row (QR confirmation, upload progress). */
+    statusChips?: React.ReactNode;
+    /** Rendered OVER the feed just above the shutter row — the filmstrip home. */
+    aboveShutter?: React.ReactNode;
+    /**
+     * The one action to the RIGHT of the shutter (Next / Break / Process).
+     * Exactly one: the shutter row is a thumb-reach zone and a second control
+     * there turns a one-hand camera into a two-hand one.
+     */
+    shutterTrailing?: React.ReactNode;
+    /** Actions on the right rail, in order. */
+    railActions?: CaptureRailAction[];
+    /**
+     * The expanding text entry pinned to the top row (serial, tag, caption).
+     * Supply `<CaptureExpandingField/>` or any control — it is a slot so a host
+     * that needs none pays nothing for it.
+     */
+    topEntry?: React.ReactNode;
+    /** Free overlays above everything (sheets, pagers). */
+    overlays?: React.ReactNode;
+}
 
 /**
  * CaptureSheet — the iOS-style system sheet used over the camera: a light,
@@ -240,6 +288,9 @@ interface CameraCaptureProps {
     preview: React__default.ReactNode;
     /** Session media — enables the package-owned filmstrip + viewer + editor. */
     media?: CaptureMediaSession;
+    /** Fires when the package review loop (viewer or editor) opens/closes over
+     *  the live feed — hosts pause things that watch the feed (QR scanning). */
+    onReviewOpenChange?: (open: boolean) => void;
     /** Close affordance top-left; omitted = no close button. */
     onClose?: () => void;
     /** Body + actions for the camera-blocked iOS-style sheet. */
@@ -252,7 +303,182 @@ interface CameraCaptureProps {
     shutterDisabled?: boolean;
     slots?: CaptureCameraSlots;
 }
-declare function CameraCapture({ engine, cloud, mode, onModeChange, preview, media, onClose, blockedSheet, controlsHidden, shutterDisabled, slots, }: CameraCaptureProps): React__default.JSX.Element;
+declare function CameraCapture({ engine, cloud, mode, onModeChange, preview, media, onReviewOpenChange, onClose, blockedSheet, controlsHidden, shutterDisabled, slots, }: CameraCaptureProps): React__default.JSX.Element;
+
+/**
+ * CameraCaptureV3 — the vertical-rail camera chrome.
+ *
+ * A SECOND chrome over the same ports as `CameraCapture`, not a replacement.
+ * Same engine, same cloud port, same package-owned review loop (filmstrip →
+ * viewer → editor). What differs is the layout and the input model, and every
+ * difference answers something the v2 chrome got wrong on a real phone
+ * (Arman, 2026-08-30):
+ *
+ *   ONE SHUTTER.      Tap = photo, press-and-hold = video. v2 spent a whole
+ *                     row on a mode selector, so the user paid bar height AND
+ *                     a decision before the moment they were trying to catch.
+ *   THE RIGHT EDGE.   Options live on a rail over the feed instead of a
+ *                     two-tap grid behind a button. No layout cost, one tap
+ *                     to anything, and the viewfinder stays whole.
+ *   IT COLLAPSES.     Extras hide behind a chevron so the idle rail is short.
+ *   TEXT IS A BUTTON. Entry expands from a pill (see CaptureExpandingField) —
+ *                     no permanent field, no keyboard-bait over the frame.
+ *   ONE MEDIA DOOR.   There is no UPLOAD mode. The library button is the only
+ *                     way to existing media, and picking files is an option
+ *                     INSIDE that drawer — the host renders it there.
+ *
+ * Deliberately NOT copied from the app this borrows its shape from: fixed
+ * duration choices (they belong to that product's format, not to a camera),
+ * and the oversized promo pill for a new feature (chrome is not a billboard).
+ *
+ * Package source (`@ai-matrx/capture`). UI state only — capture, streams and
+ * persistence come from the injected engine.
+ */
+
+interface CameraCaptureV3Props {
+    engine: CaptureCameraEngine;
+    /** THE CLOUD LAW: still required. v3 changes where the door is, not whether
+     *  there is one — and in v3 it is the ONLY door to existing media. */
+    cloud: CaptureCloudPort;
+    preview: React__default.ReactNode;
+    media?: CaptureMediaSession;
+    /**
+     * Fired on pointer-DOWN, before the hold threshold decides photo vs video.
+     *
+     * 🚨 THIS EXISTS FOR iOS. Hosts warm the microphone when they believe a
+     * recording is coming (one permission prompt per medium). With a mode row
+     * that signal arrived when the user chose VIDEO — early. With a hold
+     * shutter there is no such moment, so waiting for the recording to actually
+     * start means warming DURING the take, which on iOS Safari costs the first
+     * second of audio or throws a prompt over the viewfinder mid-recording.
+     *
+     * The host is expected to make this idempotent: it fires on every press,
+     * including the taps that turn out to be photos.
+     */
+    onRecordIntent?: () => void;
+    /** Ring completes here; presentational only — it never stops the recorder. */
+    maxRecordSeconds?: number;
+    onReviewOpenChange?: (open: boolean) => void;
+    onClose?: () => void;
+    blockedSheet?: {
+        body: React__default.ReactNode;
+        actions: CaptureSheetAction[];
+    };
+    /** Hide all chrome except status chips (host renders its own toggle). */
+    controlsHidden?: boolean;
+    shutterDisabled?: boolean;
+    slots?: CaptureCameraV3Slots;
+}
+declare function CameraCaptureV3({ engine, cloud, preview, media, onRecordIntent, maxRecordSeconds, onReviewOpenChange, onClose, blockedSheet, controlsHidden, shutterDisabled, slots, }: CameraCaptureV3Props): React__default.JSX.Element;
+
+/**
+ * CaptureExpandingField — a pill BUTTON that becomes a text field on press,
+ * and goes back to being a button when it is done.
+ *
+ * 🚨 WHY IT IS NOT AN INPUT (Arman, 2026-08-30). v2 pinned a live `<input>` in
+ * the bottom bar. On a camera that is wrong three ways: it occupies a row
+ * permanently for something used occasionally, it invites the keyboard over
+ * the viewfinder on an accidental tap, and it makes an idle camera look like a
+ * form. The pattern that fits is the one Apple uses for search — a compact
+ * control that admits it is a control, and grows only when you mean it.
+ *
+ * COMMIT ON UNMOUNT, always. The v2 input already learned this the hard way:
+ * hiding the controls or switching item remounts the field, `onBlur` never
+ * fires, and a typed value evaporates. Anything typed is committed on the way
+ * out, whatever caused the exit.
+ *
+ * Presentational + local draft state only; the host owns what a value means.
+ */
+
+interface CaptureExpandingFieldProps {
+    /** Collapsed label, e.g. "Serial / tag". Also the accessible name. */
+    label: string;
+    /** Placeholder once expanded. Defaults to `label`. */
+    placeholder?: string;
+    /** Icon shown in the collapsed pill and at the field's leading edge. */
+    icon?: React__default.ReactNode;
+    /** Commit a non-empty trimmed value. Called on Enter, blur, and unmount. */
+    onCommit: (value: string) => void;
+    /** Start expanded (a host that knows entry is imminent). */
+    defaultExpanded?: boolean;
+    disabled?: boolean;
+    /** Shown in the collapsed pill instead of `label` — e.g. the current tag. */
+    currentValue?: string | null;
+    className?: string;
+}
+declare function CaptureExpandingField({ label, placeholder, icon, onCommit, defaultExpanded, disabled, currentValue, className, }: CaptureExpandingFieldProps): React__default.JSX.Element;
+
+/**
+ * CaptureRail — the vertical action rail down the RIGHT edge of the frame.
+ *
+ * Why the edge and not a bar: a bottom bar steals height from the viewfinder
+ * on every phone, and the options grid it fed cost two taps to reach anything.
+ * A rail sits over the feed, costs no layout, and puts every option one tap
+ * away under the thumb that is already holding the phone.
+ *
+ * Why it collapses: a complete rail is a long rail, and a long rail is a wall
+ * of icons nobody reads. Actions marked `primary` stay; the rest hide behind a
+ * chevron. The chevron is only rendered when there is something to hide —
+ * a control that toggles nothing is a lie about the interface.
+ *
+ * Presentational only.
+ */
+
+interface CaptureRailProps {
+    actions: CaptureRailAction[];
+    /** Start expanded. Default false — an idle camera shows the short rail. */
+    defaultExpanded?: boolean;
+    className?: string;
+}
+declare function CaptureRail({ actions, defaultExpanded, className, }: CaptureRailProps): React__default.JSX.Element | null;
+
+/**
+ * HoldShutter — ONE button for photo and video.
+ *
+ * Tap takes a photo. Press and hold records, and releasing stops. The mode is
+ * therefore a gesture, not a control you must set before the moment you are
+ * trying to catch — which is the whole reason the v2 mode row was wrong on a
+ * phone: it cost bar height AND a decision, and the decision was usually made
+ * after the thing had happened.
+ *
+ * The interaction, precisely:
+ *
+ *   pointerdown            → arm a hold timer (HOLD_MS)
+ *   timer fires            → start recording, ring begins filling
+ *   pointerup  < HOLD_MS   → cancel the timer, take a photo
+ *   pointerup >= HOLD_MS   → stop recording
+ *   pointercancel / leave  → same as pointerup (a drag off the button must not
+ *                            leave the camera recording with nothing to stop it)
+ *
+ * A LOCK is deliberate: after ~1.2s of recording the button latches, so a user
+ * whose finger slips does not lose the take. Once latched, the next tap stops.
+ * Without it, the single-button model punishes exactly the long recordings it
+ * exists to make easy.
+ *
+ * Presentational only — the host owns the recorder.
+ */
+
+interface HoldShutterProps {
+    recording: boolean;
+    /** Elapsed recording seconds, for the ring + read-out. */
+    elapsedSeconds: number;
+    /**
+     * Ring completes at this many seconds. Presentational only — it does not
+     * stop the recorder, because a chrome that silently ends a take is worse
+     * than one that shows a full ring. Omit for no progress arc.
+     */
+    maxSeconds?: number;
+    disabled?: boolean;
+    /**
+     * Fired on pointer-DOWN, before the hold threshold decides photo vs video.
+     * Hosts use it to warm the microphone — see `CameraCaptureV3Props`.
+     */
+    onPressStart?: () => void;
+    onPhoto: () => void;
+    onStartRecording: () => void;
+    onStopRecording: () => void;
+}
+declare function HoldShutter({ recording, elapsedSeconds, maxSeconds, disabled, onPressStart, onPhoto, onStartRecording, onStopRecording, }: HoldShutterProps): React__default.JSX.Element;
 
 /**
  * CameraFeed — the package's live preview <video> for the default engine
@@ -491,4 +717,4 @@ interface DefaultEngineOptions {
 }
 declare function useDefaultCaptureEngine(options: DefaultEngineOptions): CaptureCameraEngine;
 
-export { CameraCapture, type CameraCaptureProps, CameraFeed, type CaptureAspect, type CaptureCameraEngine, type CaptureCameraMode, type CaptureCameraSlots, type CaptureCloudPort, CaptureFilmstrip, type CaptureFilmstripProps, type CaptureMediaItem, type CaptureMediaSession, type CaptureOptionTile, CaptureSheet, type CaptureSheetAction, type CaptureSheetProps, type CaptureTimerSetting, CountdownOverlay, type DefaultEngineOptions, GridOverlay, ImageEditSheet, type ImageEditSheetProps, MediaViewer, type MediaViewerProps, ModeSelector, type ModeSelectorProps, OptionsGridPanel, type OptionsGridPanelProps, type ResolvedMedia, ShutterButton, type ShutterButtonProps, type TrackControls, ZoomRow, type ZoomRowProps, getMediaUrl, invalidateMedia, primeMedia, useDefaultCaptureEngine, useMediaUrl, useTrackControls };
+export { CameraCapture, type CameraCaptureProps, CameraCaptureV3, type CameraCaptureV3Props, CameraFeed, type CaptureAspect, type CaptureCameraEngine, type CaptureCameraMode, type CaptureCameraSlots, type CaptureCameraV3Slots, type CaptureCloudPort, CaptureExpandingField, type CaptureExpandingFieldProps, CaptureFilmstrip, type CaptureFilmstripProps, type CaptureMediaItem, type CaptureMediaSession, type CaptureOptionTile, CaptureRail, type CaptureRailAction, type CaptureRailProps, CaptureSheet, type CaptureSheetAction, type CaptureSheetProps, type CaptureTimerSetting, CountdownOverlay, type DefaultEngineOptions, GridOverlay, HoldShutter, type HoldShutterProps, ImageEditSheet, type ImageEditSheetProps, MediaViewer, type MediaViewerProps, ModeSelector, type ModeSelectorProps, OptionsGridPanel, type OptionsGridPanelProps, type ResolvedMedia, ShutterButton, type ShutterButtonProps, type TrackControls, ZoomRow, type ZoomRowProps, getMediaUrl, invalidateMedia, primeMedia, useDefaultCaptureEngine, useMediaUrl, useTrackControls };