@ai-matrx/capture 0.3.1 → 0.4.2

package/dist/react.d.cts

@@ -4,10 +4,11 @@ import React__default from 'react';
 /**
  * features/capture-camera/ — EXTRACTION SOURCE for the `@ai-matrx/capture`
  * package (aidream/apps/shared/capture). Everything outside `host/` must stay
- * free of app imports beyond React, lucide-react and `cn` — those are the
- * documented substitution points when this directory is mirrored into the
- * package (icons → inlined SVGs, cn → tailwind-merge), exactly like
- * `@ai-matrx/media` was extracted from `features/files`.
+ * free of app imports beyond React and `cn` — those are the documented
+ * substitution points when this directory is mirrored into the package
+ * (icons → the package's own inlined SVGs in `components/icons.tsx` per
+ * ruling C19, cn → tailwind-merge), exactly like `@ai-matrx/media` was
+ * extracted from `features/files`.
  *
  * The package is the OPINIONATED iPhone-style camera chrome: translucent
  * top/bottom bars over a full-bleed feed, the two-tap options grid, zoom
@@ -78,7 +79,7 @@ interface CaptureOptionTile {
     /** Highlight state (iPhone: yellow when engaged/auto). */
     active?: boolean;
     /** Small value read-out under the icon (e.g. "3s", "4:3"). */
-    valueLabel?: string;
+    valueLabel?: string | undefined;
     disabled?: boolean;
     onPress: () => void;
 }
@@ -110,7 +111,7 @@ interface CaptureCameraSlots {
         id: string;
         label: string;
         onSelect: () => void;
-    }[];
+    }[] | undefined;
     /** Free overlays rendered above everything (sheets, pagers). */
     overlays?: React.ReactNode;
 }
@@ -123,7 +124,7 @@ interface CaptureRailAction {
     /** Engaged/on — rendered in the accent colour. */
     active?: boolean;
     /** A short read-out under the icon (e.g. "3s", "4:3", "Auto"). */
-    valueLabel?: string;
+    valueLabel?: string | undefined;
     disabled?: boolean;
     /**
      * Primary actions stay visible when the rail is collapsed. Everything else
@@ -446,14 +447,18 @@ declare function CaptureRail({ actions, defaultExpanded, className, }: CaptureRa
  *   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
+ *   pointerup >= HOLD_MS   → stop recording (recording follows the finger)
+ *   slide up ≥ LOCK_DRAG_PX while holding → LOCK: release keeps recording,
+ *                            the next tap stops
  *   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.
+ * A LOCK is a GESTURE, never a timer (Arman, 2026-08-30: recording follows
+ * the finger — releasing stops, full stop — unless the user deliberately
+ * locks): while holding a recording, slide UP to the lock target that
+ * appears above the button. Locked, release keeps recording and the next
+ * tap stops. An automatic time-based latch shipped first and was wrong —
+ * it silently converted "I let go" into "still recording".
  *
  * Presentational only — the host owns the recorder.
  */
@@ -584,9 +589,9 @@ interface MediaViewerProps {
     /** Key of the item to open on. */
     initialKey: string | null;
     onClose: () => void;
-    onDelete?: (item: CaptureMediaItem) => void;
+    onDelete?: ((item: CaptureMediaItem) => void) | undefined;
     /** Offered on photo items with a renderable URL. */
-    onEdit?: (item: CaptureMediaItem) => void;
+    onEdit?: ((item: CaptureMediaItem) => void) | undefined;
     /** What deleting costs, stated BEFORE the delete (destructive-actions
      *  rule). Override per domain; deletion is never one silent tap. */
     deleteConsequence?: string;
@@ -624,7 +629,7 @@ interface ModeSelectorProps {
         id: string;
         label: string;
         onSelect: () => void;
-    }[];
+    }[] | undefined;
 }
 declare function ModeSelector({ mode, onModeChange, onUpload, modeDisabled, uploadDisabled, extraModes, }: ModeSelectorProps): React__default.JSX.Element;
 

package/dist/react.d.ts

@@ -4,10 +4,11 @@ import React__default from 'react';
 /**
  * features/capture-camera/ — EXTRACTION SOURCE for the `@ai-matrx/capture`
  * package (aidream/apps/shared/capture). Everything outside `host/` must stay
- * free of app imports beyond React, lucide-react and `cn` — those are the
- * documented substitution points when this directory is mirrored into the
- * package (icons → inlined SVGs, cn → tailwind-merge), exactly like
- * `@ai-matrx/media` was extracted from `features/files`.
+ * free of app imports beyond React and `cn` — those are the documented
+ * substitution points when this directory is mirrored into the package
+ * (icons → the package's own inlined SVGs in `components/icons.tsx` per
+ * ruling C19, cn → tailwind-merge), exactly like `@ai-matrx/media` was
+ * extracted from `features/files`.
  *
  * The package is the OPINIONATED iPhone-style camera chrome: translucent
  * top/bottom bars over a full-bleed feed, the two-tap options grid, zoom
@@ -78,7 +79,7 @@ interface CaptureOptionTile {
     /** Highlight state (iPhone: yellow when engaged/auto). */
     active?: boolean;
     /** Small value read-out under the icon (e.g. "3s", "4:3"). */
-    valueLabel?: string;
+    valueLabel?: string | undefined;
     disabled?: boolean;
     onPress: () => void;
 }
@@ -110,7 +111,7 @@ interface CaptureCameraSlots {
         id: string;
         label: string;
         onSelect: () => void;
-    }[];
+    }[] | undefined;
     /** Free overlays rendered above everything (sheets, pagers). */
     overlays?: React.ReactNode;
 }
@@ -123,7 +124,7 @@ interface CaptureRailAction {
     /** Engaged/on — rendered in the accent colour. */
     active?: boolean;
     /** A short read-out under the icon (e.g. "3s", "4:3", "Auto"). */
-    valueLabel?: string;
+    valueLabel?: string | undefined;
     disabled?: boolean;
     /**
      * Primary actions stay visible when the rail is collapsed. Everything else
@@ -446,14 +447,18 @@ declare function CaptureRail({ actions, defaultExpanded, className, }: CaptureRa
  *   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
+ *   pointerup >= HOLD_MS   → stop recording (recording follows the finger)
+ *   slide up ≥ LOCK_DRAG_PX while holding → LOCK: release keeps recording,
+ *                            the next tap stops
  *   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.
+ * A LOCK is a GESTURE, never a timer (Arman, 2026-08-30: recording follows
+ * the finger — releasing stops, full stop — unless the user deliberately
+ * locks): while holding a recording, slide UP to the lock target that
+ * appears above the button. Locked, release keeps recording and the next
+ * tap stops. An automatic time-based latch shipped first and was wrong —
+ * it silently converted "I let go" into "still recording".
  *
  * Presentational only — the host owns the recorder.
  */
@@ -584,9 +589,9 @@ interface MediaViewerProps {
     /** Key of the item to open on. */
     initialKey: string | null;
     onClose: () => void;
-    onDelete?: (item: CaptureMediaItem) => void;
+    onDelete?: ((item: CaptureMediaItem) => void) | undefined;
     /** Offered on photo items with a renderable URL. */
-    onEdit?: (item: CaptureMediaItem) => void;
+    onEdit?: ((item: CaptureMediaItem) => void) | undefined;
     /** What deleting costs, stated BEFORE the delete (destructive-actions
      *  rule). Override per domain; deletion is never one silent tap. */
     deleteConsequence?: string;
@@ -624,7 +629,7 @@ interface ModeSelectorProps {
         id: string;
         label: string;
         onSelect: () => void;
-    }[];
+    }[] | undefined;
 }
 declare function ModeSelector({ mode, onModeChange, onUpload, modeDisabled, uploadDisabled, extraModes, }: ModeSelectorProps): React__default.JSX.Element;