@ai-matrx/capture 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -22,3 +22,26 @@ Real-phone feedback pass (the bar was eating the viewfinder):
 - New `slots.aboveBar`: host content rendered OVER the feed above the bottom bar (filmstrip home) — zero bar height.
 - Domain action returned to the mode row (absolute right of the narrow track).
 - Bottom paddings cut (mode row py-1.5, shutter row pb-1.5), thumbs 44px.
+
+## 0.1.2 — 2026-08-29
+
+- Mode row: the trailing domain action is a flex SIBLING of the connected track (absolute positioning collided with the labels on narrow phones).
+
+## 0.2.0 — 2026-08-29
+
+The package-completeness release: the whole capture loop now lives in the box (Arman's rule — likely to fail, likely to need tuning, or less-than-perfect unless done perfectly ⇒ in the package).
+
+- `MediaViewer` — the full-screen swipe pager moved in: pointer-gesture paging with the real-phone-tuned thresholds (40px / 0.25 px-per-ms flick), vertical-drag dismiss, neighbor preload (±2 photos, ±1 video kept mounted + decoded), desktop keys/chevrons. Zero animation deps.
+- `media-cache` — package-owned media resolution cache: memoized `resolve()` per item, in-flight dedup, LRU eviction, owned-URL revocation, `useMediaUrl`/`primeMedia`/`invalidateMedia`.
+- `CaptureFilmstrip` — the over-feed thumbnail strip (uploading/error/accent states) rendered by the chrome from `media.items`.
+- `CameraCapture` gained `media: CaptureMediaSession` — filmstrip → viewer → editor with REPLACE semantics (saving an edit removes the source item and its cached URL) orchestrated inside the package; hosts implement only item CRUD.
+- `useDefaultCaptureEngine` + `CameraFeed` — the batteries-included engine: getUserMedia (the ONE sanctioned site, `src/engine/`), flip, full-sensor photo with center-crop aspects, MediaRecorder video with a concrete-MIME ladder and mic-optional composition, package-created upload picker. A Vite host is a few lines; AI Matrx keeps injecting its lease-managed runtime.
+- Safe-area correctness in ANY host: the host-app `pt-safe`/`pb-safe`/`mb-safe` utility classes (which only exist in AI Matrx) are replaced with inline `env(safe-area-inset-*)` styles.
+- Laws updated: law 2 is now "getUserMedia only inside src/engine/".
+
+### Also in 0.2.0 — adversarial-review fixes
+
+- Viewer: preload slides can no longer steal touches (`pointer-events-auto` only on the ACTIVE slide — an invisible neighbor video previously sat above the stage and ate swipes); mounted preload reduced to ±1 (iOS memory), URL priming stays ±2; delete states its consequence before acting; keyboard suppressed while the editor is on top; audio items render natively (filmstrip tile + viewer slide).
+- Chrome: a photo countdown is cancelled by a mode switch (it used to fire a photo mid-video); the dead `CaptureCloudPort.onSaveEdited` port is removed — the editor saves through `media.onReplacePhoto` only.
+- Editor: rotate/flip BAKE into the working bitmap immediately (full-res canvas re-encode), so the crop frame always matches the pixels on screen — the CSS-transform approach diverged at 90°/270°; Save failures surface an inline error instead of silently doing nothing; baked object URLs are revoked on replace/close.
+- Track controls: capabilities poll on a widening ladder (0.5s→5s) until torch/zoom/exposure appear — iPhones that report late now get their pills.

package/README.md

@@ -4,6 +4,67 @@ The AI Matrx capture kit — the opinionated, iPhone-style camera experience as
 
 **THE CLOUD LAW:** cloud integration is WHAT this system does, not an add-on. `CameraCapture` requires a `CaptureCloudPort` (recents thumb, library opener, edited-image persistence). The host decides HOW the cloud is reached — never WHETHER.
 
+## Drop-in quickstart (any React host)
+
+No media runtime required — the package ships its own engine:
+
+```tsx
+import { useState } from "react";
+import {
+  CameraCapture,
+  CameraFeed,
+  useDefaultCaptureEngine,
+  type CaptureMediaItem,
+} from "@ai-matrx/capture/react";
+
+export function Camera() {
+  const [mode, setMode] = useState<"photo" | "video">("photo");
+  const [items, setItems] = useState<CaptureMediaItem[]>([]);
+
+  const add = (file: File, kind: "photo" | "video") =>
+    setItems((xs) => [
+      ...xs,
+      { key: crypto.randomUUID(), kind, src: URL.createObjectURL(file) },
+    ]);
+
+  const engine = useDefaultCaptureEngine({
+    onPhoto: (f) => add(f, "photo"),
+    onVideo: (f) => add(f, "video"),
+    onFiles: (fs) => [...fs].forEach((f) =>
+      add(f, f.type.startsWith("video/") ? "video" : "photo")),
+  });
+
+  return (
+    <div style={{ position: "fixed", inset: 0 }}>
+      <CameraCapture
+        engine={engine}
+        preview={<CameraFeed engine={engine} />}
+        mode={mode}
+        onModeChange={setMode}
+        media={{
+          items,
+          onDelete: (key) => setItems((xs) => xs.filter((x) => x.key !== key)),
+          onReplacePhoto: (key, blob) =>
+            setItems((xs) => xs.map((x) =>
+              x.key === key
+                ? { ...x, src: URL.createObjectURL(blob) }
+                : x)),
+        }}
+        cloud={{ recentsThumb: null, onOpenLibrary: () => {/* your gallery */} }}
+      />
+    </div>
+  );
+}
+```
+
+That is the whole wiring: filmstrip, swipe viewer (tuned gestures + neighbor
+preload + resolution caching), crop/rotate editor with replace semantics,
+two-tap options grid, timer, torch/zoom (when the hardware reports them),
+upload lane and safe-area handling all come from the package. Hosts with
+their own camera runtime (AI Matrx) pass a custom `CaptureCameraEngine`
+instead of the default one; persisted items provide `resolve()` instead of
+`src` and the package caches the resolutions.
+
 ## What's inside
 
 - `CameraCapture` — the assembled chrome: full-bleed feed under semi-transparent near-black bars; top bar (close · center slot · torch · extras · options); real zoom pills (track capabilities only — nothing faked); VIDEO · PHOTO · UPLOAD mode row (upload is first-class); recents thumb · shutter · flip; honesty chips (recording clock survives hidden chrome).

package/dist/index.d.cts

@@ -37,8 +37,6 @@ interface CaptureCloudPort {
     recentsThumb: React.ReactNode;
     /** Opens the host's cloud media library (tiled gallery). */
     onOpenLibrary: () => void;
-    /** Persists an edited image produced by the edit sheet. */
-    onSaveEdited: (blob: Blob, suggestedName: string) => void;
 }
 /**
  * The engine port — everything the chrome needs from the host's camera

package/dist/index.d.ts

@@ -37,8 +37,6 @@ interface CaptureCloudPort {
     recentsThumb: React.ReactNode;
     /** Opens the host's cloud media library (tiled gallery). */
     onOpenLibrary: () => void;
-    /** Persists an edited image produced by the edit sheet. */
-    onSaveEdited: (blob: Blob, suggestedName: string) => void;
 }
 /**
  * The engine port — everything the chrome needs from the host's camera