@ai-matrx/capture 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog — @ai-matrx/capture
 
+## 0.5.2 — 2026-09-01
+
+- `CameraCapture` no longer wraps the injected recents thumbnail in its Open-library button. Persisted-media error fallbacks may own remedy buttons (for example, Copy URL); those controls now remain valid siblings, act without also opening the library, and the non-interactive thumbnail area still opens the library.
+- Added an exact fail-first regression covering the real `InlineMediaRef` error-panel shape and preventing nested interactive markup from returning.
+
 ## 0.1.0 — 2026-08-29
 
 Initial extraction from matrx-frontend `features/capture-camera/` (the iPhone-style rebuild of the commerce intake camera, generalized):
@@ -127,3 +132,25 @@ The injected-engine seam is unchanged: hosts with their own cross-feature
 media runtime (matrx-frontend's lease manager) still inject a
 `CaptureCameraEngine`; their adapters now import the package's crop /
 classification / flip helpers instead of carrying twins.
+
+### Consumer action (C28)
+
+- **Host engine adapters**: delete local copies of the aspect crop, the
+  NotAllowedError/SecurityError classification, and the flip-cycling
+  algorithm — import `cropBlobToAspect`, `classifyCameraBlockReason`,
+  `nextCameraDevice`, `PHOTO_JPEG_QUALITY` from `@ai-matrx/capture/react`.
+  Any remaining adapter line must be lease-runtime identity wiring with a
+  C22 justification. (matrx-frontend: done same-session.)
+- **Host cloud-library sheets**: replace bespoke tiled-gallery chrome with
+  the package `CloudLibrarySheet` — the host supplies
+  `items: CaptureCloudLibraryItem[]` (own thumbnail nodes), `loading`,
+  `onOpenItem`, optional `onUpload` (v3 in-library door). (matrx-frontend:
+  host copy collapsed to a data wrapper, consumer props unchanged.)
+- **Runtime-less hosts**: adopt the rewritten `useDefaultCaptureEngine`
+  (now returns `DefaultCaptureEngine` = engine + `flash` +
+  `capturePhotoWith`; new options `mode`, `fileNamePrefix`, `onError`).
+  No breaking signature change — existing options still work.
+- **`DefaultEngineOptions` behavior delta**: video capture callbacks now
+  fire with warm-mic-managed audio and the combined permission prompt;
+  hosts that suppressed their own double-prompt workarounds can delete
+  them.

package/dist/index.d.cts

@@ -33,8 +33,8 @@ type CaptureAspect = "full" | "4:3" | "1:1" | "16:9";
  */
 interface CaptureCloudPort {
     /** Content of the bottom-left recents thumbnail (latest cloud/session
-     *  media). Null renders the placeholder — the button still opens the
-     *  library. */
+     *  media). Null renders the placeholder. Non-interactive thumbnail space
+     *  opens the library; any injected remedy control owns its own action. */
     recentsThumb: React.ReactNode;
     /** Opens the host's cloud media library (tiled gallery). */
     onOpenLibrary: () => void;

package/dist/index.d.ts

@@ -33,8 +33,8 @@ type CaptureAspect = "full" | "4:3" | "1:1" | "16:9";
  */
 interface CaptureCloudPort {
     /** Content of the bottom-left recents thumbnail (latest cloud/session
-     *  media). Null renders the placeholder — the button still opens the
-     *  library. */
+     *  media). Null renders the placeholder. Non-interactive thumbnail space
+     *  opens the library; any injected remedy control owns its own action. */
     recentsThumb: React.ReactNode;
     /** Opens the host's cloud media library (tiled gallery). */
     onOpenLibrary: () => void;

package/dist/react.cjs

@@ -1553,6 +1553,18 @@ function CameraCapture({
   const [timerSetting, setTimerSetting] = (0, import_react5.useState)(0);
   const [aspect, setAspect] = (0, import_react5.useState)("full");
   const [exposureOpen, setExposureOpen] = (0, import_react5.useState)(false);
+  const openLibraryFromRecents = (0, import_react5.useCallback)(
+    (event) => {
+      const target = event.target;
+      if (target instanceof Element && target.closest(
+        "button, a, input, select, textarea, [role='button'], [role='link']"
+      )) {
+        return;
+      }
+      cloud.onOpenLibrary();
+    },
+    [cloud]
+  );
   const [countdown, setCountdown] = (0, import_react5.useState)(null);
   const [blockedDismissed, setBlockedDismissed] = (0, import_react5.useState)(false);
   const countdownRef = (0, import_react5.useRef)(null);
@@ -1800,16 +1812,26 @@ function CameraCapture({
               slots.modeRowTrailing && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: "shrink-0", children: slots.modeRowTrailing })
             ] }),
             /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "flex items-center justify-between px-2 pb-1.5 pt-0.5", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: "flex w-14 justify-start", children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
-                "button",
-                {
-                  type: "button",
-                  onClick: cloud.onOpenLibrary,
-                  "aria-label": "Open your media library",
-                  className: "h-11 w-11 touch-manipulation overflow-hidden rounded-xl bg-white/10 ring-1 ring-white/25 transition-transform active:scale-95",
-                  children: cloud.recentsThumb ?? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("span", { className: "block h-full w-full bg-white/5" })
-                }
-              ) }),
+              /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "flex w-14 justify-start", children: [
+                /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
+                  "div",
+                  {
+                    onClick: openLibraryFromRecents,
+                    className: "h-11 w-11 touch-manipulation overflow-hidden rounded-xl bg-white/10 ring-1 ring-white/25 transition-transform active:scale-95",
+                    children: cloud.recentsThumb ?? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("span", { className: "block h-full w-full bg-white/5" })
+                  }
+                ),
+                /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
+                  "button",
+                  {
+                    type: "button",
+                    onClick: cloud.onOpenLibrary,
+                    "aria-label": "Open your media library",
+                    className: "sr-only",
+                    children: "Open your media library"
+                  }
+                )
+              ] }),
               /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
                 ShutterButton,
                 {