@btndprojects/loam-ui-native 0.1.1 → 0.3.1

package/dist/{chunk-S7F6XLTK.js → chunk-CBCJSO2B.js}

@@ -1,11 +1,14 @@
-import { ContinuousNotice, ShutterButton, TorchToggle, GridToggle, GuideOverlay, ExpertPanel, LensPicker, SequenceStrip, ShutterTray, FlipButton, TrackingOverlay, GridOverlay, FocusTapZone, FocusIndicator } from './chunk-BV3B2HYZ.js';
-import { PlaceholderFeed } from './chunk-LAECSR4H.js';
-import { decorativeProps, camInk, SurfaceLiveRegion, ViewfinderTopBar, GlassIconButton, GuidanceChip, GateHint, useSurfaceAnnounce } from './chunk-RW6ZL2FQ.js';
-import { Icon } from './chunk-TKVFVF5D.js';
+import { IdentifyCard, ContinuousNotice, ShutterButton, TorchToggle, ViewfinderGridToggle, GuideOverlay, ExpertPanel, LensPicker, SequenceStrip, ShutterTray, FlipButton, TrackingOverlay, ObjectHighlight, ObjectLabel, ViewfinderGridOverlay, FocusTapZone, FocusIndicator, ViewfinderModes } from './chunk-HHOMFQ7R.js';
+import { PlaceholderFeed } from './chunk-RJA3RXO3.js';
+import { camInk, decorativeProps, useAnalyzerCopy, useAnalyzerLabels, AnalyzerCopyScope, SurfaceLiveRegion, ViewfinderTopBar, GlassIconButton, GuidanceChip, GateHint, useSurfaceAnnounce } from './chunk-OCHPK5YV.js';
+import { NAMED_ROLE } from './chunk-W23G6JLF.js';
+import { Spinner } from './chunk-G7H3NX3G.js';
+import { isAndroidIdiom } from './chunk-TH4PW2WU.js';
+import { Icon } from './chunk-PCEFCOLN.js';
 import * as React2 from 'react';
 import { View, Animated, Easing, Text, Pressable } from 'react-native';
 import { createStyleSheet, useStyles, useLoamTheme } from '@btndprojects/loam-theme-native';
-import { queueLabel, profile, caps, isFrozen, primaryCheck, TOASTS, gateHint, angleAt, viewfinderSubtitle, PRIVACY_STATEMENT, confidenceTone, confidenceLabel, CAPTURED_PILL, DONE_LABEL } from '@btndprojects/loam-analyzer';
+import { queueLabel, localizeProfile, profile, caps, isFrozen, nearestToCentre, primaryCheck, gateHint, angleAt, viewfinderSubtitle, confidenceTone, confidenceLabel } from '@btndprojects/loam-analyzer';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
 function numericRatio(ratio) {
@@ -18,13 +21,14 @@ function numericRatio(ratio) {
 }
 function CameraSurface({
   ratio,
-  platform = "ios",
+  platform: platformProp,
   insets = {},
   feed,
   accessibilityLabel,
   children
 }) {
-  const { styles } = useStyles(stageSheet);
+  const { styles, theme } = useStyles(stageSheet);
+  const platform = platformProp ?? (isAndroidIdiom(theme) ? "android" : "ios");
   const aspect = numericRatio(ratio);
   return /* @__PURE__ */ jsxs(
     View,
@@ -60,7 +64,7 @@ function PreviewSlot({ preview, label, topInset }) {
   return /* @__PURE__ */ jsx(View, { style: styles.previewSlot, children: preview ?? /* @__PURE__ */ jsx(PlaceholderFeed, { label, topInset }) });
 }
 function CaptureFlash({ token = null }) {
-  const theme = useLoamTheme();
+  const theme = useLoamTheme("analyzer");
   const { styles } = useStyles(stageSheet);
   const [flashes, setFlashes] = React2.useState(0);
   const first = React2.useRef(true);
@@ -91,11 +95,12 @@ function CaptureFlash({ token = null }) {
     }
   );
 }
-function QueueBadge({ count, onPress }) {
-  const theme = useLoamTheme();
+function QueueBadge({ count, onPress, copy }) {
+  const theme = useLoamTheme("analyzer");
   const { styles } = useStyles(stageSheet);
+  const words = useAnalyzerCopy(copy);
   if (count <= 0) return null;
-  const text = queueLabel(count);
+  const text = queueLabel(count, words);
   const ink = camInk(theme);
   const body = /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(Icon, { name: "scan", size: theme.icon.sm, color: ink }),
@@ -113,7 +118,7 @@ function QueueBadge({ count, onPress }) {
       }
     );
   }
-  return /* @__PURE__ */ jsx(View, { accessible: true, accessibilityLabel: text, style: styles.badge, children: body });
+  return /* @__PURE__ */ jsx(View, { accessible: true, accessibilityRole: NAMED_ROLE, accessibilityLabel: text, style: styles.badge, children: body });
 }
 var stageSheet = createStyleSheet((theme) => ({
   stage: {
@@ -183,22 +188,22 @@ var SCRIM_STOP = {
   analysing: "a10",
   failure: "a11"
 };
-function feedLabel(p, phase, platform, zoom) {
-  const facing = platform === "web" ? "webcam \xB7 front" : "rear camera";
-  if (phase === "live") return `${facing} \xB7 ${p.ratio} \xB7 ${zoom}x \xB7 placeholder feed`;
-  if (phase === "captured") return `frozen frame \xB7 ${p.ratio} \xB7 placeholder`;
-  if (phase === "analysing") return "frozen frame \xB7 analysing";
-  if (phase === "result" || phase === "failure") return "frozen frame";
-  if (phase === "done") return "captured frame";
-  return `${facing} \xB7 ${p.ratio} \xB7 placeholder feed`;
+function feedLabel(p, phase, platform, zoom, t) {
+  const facing = platform === "web" ? t.webcamFront : t.rearCamera;
+  if (phase === "live") return t.feedLive(facing, p.ratio, zoom);
+  if (phase === "captured") return t.feedCaptured(p.ratio);
+  if (phase === "analysing") return t.feedAnalysing;
+  if (phase === "result" || phase === "failure") return t.feedFrozen;
+  if (phase === "done") return t.feedDone;
+  return t.feedLive(facing, p.ratio, zoom);
 }
-function phaseMessage(p, phase) {
-  if (phase === "live") return `${p.label}. ${p.subject}.`;
-  if (phase === "captured") return CAPTURED_PILL;
-  if (phase === "analysing") return "Analysing";
-  if (phase === "result") return "Result ready";
-  if (phase === "failure") return "Analysis failed";
-  if (phase === "done") return DONE_LABEL;
+function phaseMessage(p, phase, copy, t) {
+  if (phase === "live") return copy.viewfinder.phaseLine(p.label, p.subject);
+  if (phase === "captured") return copy.capturedPill;
+  if (phase === "analysing") return t.analysing;
+  if (phase === "result") return t.resultReady;
+  if (phase === "failure") return t.analysisFailed;
+  if (phase === "done") return copy.done;
   return null;
 }
 function detectedChip(detected, confidence) {
@@ -212,15 +217,17 @@ function detectedChip(detected, confidence) {
 function PhaseAnnouncer({
   profile: p,
   phase,
-  detected
+  detected,
+  copy,
+  labels
 }) {
   const announce = useSurfaceAnnounce();
   const sink = React2.useRef(announce);
   sink.current = announce;
   React2.useEffect(() => {
-    const message = phaseMessage(p, phase);
+    const message = phaseMessage(p, phase, copy, labels);
     if (message) sink.current?.(message);
-  }, [p, phase]);
+  }, [p, phase, copy, labels]);
   React2.useEffect(() => {
     if (detected) sink.current?.(detected);
   }, [detected]);
@@ -229,12 +236,23 @@ function PhaseAnnouncer({
 function Analyzer({
   profile: profileProp,
   level = "guided",
-  platform = "ios",
+  platform: platformProp,
   phase,
   ratio,
   insets,
   preview,
   objects = [],
+  highlight = true,
+  highlightPhase,
+  targetId,
+  aimedId,
+  identifySub,
+  identifyThumb,
+  modes,
+  mode,
+  onTargetChange,
+  onOpenResult,
+  onModeChange,
   gate = { pass: true, failing: [] },
   countdown = null,
   detected = null,
@@ -252,7 +270,11 @@ function Analyzer({
   focusPoint = null,
   flashToken = null,
   title,
-  privacyStatement = PRIVACY_STATEMENT,
+  privacyStatement,
+  enforceGate = true,
+  uploadLabel,
+  labels: labelsProp,
+  copy: copyProp,
   children,
   onCapture,
   onUpload,
@@ -268,11 +290,16 @@ function Analyzer({
   onSequenceRead,
   onQueuePress,
   onGatePass,
-  onNotify
+  onNotify,
+  loading = false,
+  tone
 }) {
-  const theme = useLoamTheme();
+  const theme = useLoamTheme("analyzer");
+  const platform = platformProp ?? (isAndroidIdiom(theme) ? "android" : "ios");
   const { styles } = useStyles(analyzerSheet);
-  const p = profile(profileProp);
+  const copy = useAnalyzerCopy(copyProp);
+  const t = useAnalyzerLabels(labelsProp);
+  const p = React2.useMemo(() => localizeProfile(profile(profileProp), copy), [profileProp, copy]);
   const caps$1 = caps(level);
   const chip = detected ? detectedChip(detected, detectedConfidence) : null;
   const live = phase === "live";
@@ -280,11 +307,42 @@ function Analyzer({
   const continuous = p.shutter === "continuous";
   const tracking = objects.length > 0;
   const trackLocked = objects.some((o) => o.locked === true);
+  const flow = highlight && objects.length > 0 && mode !== "photo";
+  const target = flow ? objects.find((o) => o.id === (targetId ?? aimedId ?? nearestToCentre(objects))) ?? objects[0] : void 0;
+  const hp = highlightPhase ?? (phase === "result" ? "result" : target?.locked ? "lock" : "aim");
+  const cardRef = React2.useRef(null);
+  const openResult = () => onOpenResult?.(cardRef);
+  const card = target && (hp === "identify" || hp === "result") ? (
+    // Native parts do not forward refs: the wrapper View is the morph source.
+    /* @__PURE__ */ jsx(View, { ref: cardRef, collapsable: false, children: /* @__PURE__ */ jsx(
+      IdentifyCard,
+      {
+        platform: platform === "android" ? "android" : "ios",
+        name: target.label,
+        sub: identifySub,
+        conf: target.conf,
+        thumb: identifyThumb,
+        onOpen: openResult
+      }
+    ) })
+  ) : null;
+  const modeStrip = modes && mode !== void 0 ? /* @__PURE__ */ jsx(
+    ViewfinderModes,
+    {
+      modes,
+      value: mode,
+      platform: platform === "android" ? "android" : "ios",
+      onChange: onModeChange
+    }
+  ) : null;
   const gateOpen = caps$1.gate ? gate.pass : true;
+  const captureOpen = (enforceGate ? gateOpen : true) && !loading;
   const blockedToast = React2.useMemo(() => {
     const check = primaryCheck(p, gate);
-    return TOASTS.gateBlocked(check ? check.fix : gateHint(p, gate));
-  }, [p, gate]);
+    return copy.toasts.gateBlocked(
+      check ? copy.checks[check.id]?.fix ?? check.fix : gateHint(p, gate, null, copy)
+    );
+  }, [p, gate, copy]);
   const notify = React2.useRef(onNotify);
   notify.current = onNotify;
   const gatePass = React2.useRef(onGatePass);
@@ -302,16 +360,16 @@ function Analyzer({
     (next) => {
       if (!caps$1.grid) return;
       onGridChange?.(next);
-      notify.current?.({ title: TOASTS.grid(next) });
+      notify.current?.({ title: copy.toasts.grid(next) });
     },
     [caps$1.grid, onGridChange]
   );
   const close = React2.useCallback(() => {
     onClose?.();
-    notify.current?.({ title: TOASTS.close });
+    notify.current?.({ title: copy.toasts.close });
   }, [onClose]);
   const angle = angleAt(p, angleIndex);
-  const subtitle = viewfinderSubtitle(p, { angleIndex, shots });
+  const subtitle = viewfinderSubtitle(p, { angleIndex, shots }, copy);
   const sequence = caps$1.sequence && (p.frames === "multi" || typeof p.frames === "number" && p.frames > 1);
   const scrimStop = SCRIM_STOP[phase];
   const trayPrimary = continuous ? /* @__PURE__ */ jsx(ContinuousNotice, {}) : /* @__PURE__ */ jsx(
@@ -319,31 +377,64 @@ function Analyzer({
     {
       platform,
       mode: p.shutter,
-      enabled: gateOpen,
+      enabled: captureOpen,
       countdown: caps$1.auto ? countdown : null,
       blockedToast,
       onPress: onCapture,
       onBlocked: blocked
     }
   );
-  return /* @__PURE__ */ jsxs(SurfaceLiveRegion, { children: [
-    /* @__PURE__ */ jsx(PhaseAnnouncer, { profile: p, phase, detected: chip ? chip.text : null }),
+  return /* @__PURE__ */ jsx(AnalyzerCopyScope.Provider, { value: copyProp, children: /* @__PURE__ */ jsxs(SurfaceLiveRegion, { children: [
+    /* @__PURE__ */ jsx(
+      PhaseAnnouncer,
+      {
+        profile: p,
+        phase,
+        detected: chip ? chip.text : null,
+        copy,
+        labels: t
+      }
+    ),
     /* @__PURE__ */ jsxs(
       CameraSurface,
       {
         ratio,
         platform,
         insets,
-        accessibilityLabel: `${title ?? p.label} viewfinder`,
+        accessibilityLabel: copy.viewfinder.aria(title ?? p.label),
         feed: /* @__PURE__ */ jsxs(Fragment, { children: [
           /* @__PURE__ */ jsx(
             PreviewSlot,
             {
               preview,
-              label: feedLabel(p, phase, platform, zoom),
+              label: feedLabel(p, phase, platform, zoom, t),
               topInset: insets?.top ?? 0
             }
           ),
+          loading ? /* @__PURE__ */ jsx(
+            View,
+            {
+              testID: "loam-cam-loading",
+              accessible: true,
+              accessibilityLabel: t.startingCamera,
+              accessibilityState: { busy: true },
+              "aria-busy": true,
+              style: [styles.loading, { backgroundColor: theme.black.a8 }],
+              children: /* @__PURE__ */ jsx(Spinner, { size: "lg", color: camInk(theme) })
+            }
+          ) : null,
+          tone && tone !== "neutral" ? /* @__PURE__ */ jsx(
+            View,
+            {
+              accessible: false,
+              testID: `loam-cam-tone-${tone}`,
+              style: [
+                styles.scrim,
+                { borderWidth: theme.borderWidth.thick, borderColor: theme.color[tone] }
+              ],
+              ...decorativeProps()
+            }
+          ) : null,
           scrimStop ? /* @__PURE__ */ jsx(
             View,
             {
@@ -353,7 +444,7 @@ function Analyzer({
               ...decorativeProps()
             }
           ) : null,
-          tracking ? /* @__PURE__ */ jsx(
+          tracking && !target ? /* @__PURE__ */ jsx(
             TrackingOverlay,
             {
               objects,
@@ -362,8 +453,46 @@ function Analyzer({
               safeAreaBottom: insets?.bottom ?? 0
             }
           ) : null,
-          live ? /* @__PURE__ */ jsx(GridOverlay, { visible: caps$1.grid && grid }) : null,
+          target ? /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx(
+              ObjectHighlight,
+              {
+                target,
+                phase: hp,
+                locked: hp === "aim" ? true : target.locked !== false
+              }
+            ),
+            hp === "lock" || hp === "identify" ? /* @__PURE__ */ jsx(
+              ObjectLabel,
+              {
+                name: target.label,
+                conf: target.conf,
+                box: target.box,
+                state: target.locked === false ? "lost" : hp === "lock" ? "identifying" : "identified",
+                onOpen: openResult
+              }
+            ) : null
+          ] }) : null,
+          live ? /* @__PURE__ */ jsx(ViewfinderGridOverlay, { visible: caps$1.grid && grid }) : null,
           live ? /* @__PURE__ */ jsx(FocusTapZone, { onFocusPoint }) : null,
+          live && target ? objects.filter((o) => o.id !== target.id).map((o) => /* @__PURE__ */ jsx(
+            Pressable,
+            {
+              accessibilityRole: "button",
+              accessibilityLabel: o.label,
+              hitSlop: Math.max(0, (theme.hit.lg - theme.space[12]) / 2),
+              testID: `loam-target-dot-${o.id}`,
+              onPress: () => onTargetChange?.(o.id),
+              style: [
+                styles.targetDot,
+                {
+                  left: `${o.box[0] + o.box[2] / 2}%`,
+                  top: `${o.box[1] + o.box[3] / 2}%`
+                }
+              ]
+            },
+            o.id
+          )) : null,
           live ? /* @__PURE__ */ jsx(
             FocusIndicator,
             {
@@ -383,12 +512,12 @@ function Analyzer({
               onClose: onClose ? close : void 0,
               children: [
                 caps$1.torch ? /* @__PURE__ */ jsx(TorchToggle, { on: torch, available: torchAvailable, onChange: onTorchChange }) : null,
-                caps$1.grid ? /* @__PURE__ */ jsx(GridToggle, { on: grid, onChange: toggleGrid }) : null,
+                caps$1.grid ? /* @__PURE__ */ jsx(ViewfinderGridToggle, { on: grid, onChange: toggleGrid }) : null,
                 caps$1.expert && onExpertOpenChange ? /* @__PURE__ */ jsx(
                   GlassIconButton,
                   {
                     icon: "sliders",
-                    label: "Expert controls",
+                    label: t.expertControls,
                     on: expertOpen,
                     onPress: () => onExpertOpenChange(!expertOpen)
                   }
@@ -402,7 +531,7 @@ function Analyzer({
               {
                 kind: p.guide,
                 pass: gateOpen,
-                dimmed: trackLocked,
+                dimmed: trackLocked || target !== void 0,
                 hint: angle?.hint,
                 scanning: continuous
               }
@@ -418,7 +547,7 @@ function Analyzer({
                   onClose: onExpertOpenChange ? () => onExpertOpenChange(false) : void 0
                 }
               ) }) : null,
-              caps$1.zoom ? /* @__PURE__ */ jsx(LensPicker, { stops: zoomStops, value: zoom, onChange: onZoomChange }) : null,
+              caps$1.zoom && !card ? /* @__PURE__ */ jsx(LensPicker, { stops: zoomStops, value: zoom, onChange: onZoomChange }) : null,
               chip ? /* @__PURE__ */ jsx(GuidanceChip, { tone: chip.tone, icon: chip.icon, text: chip.text }) : null,
               caps$1.gate ? (
                 // `live={!detected}` suspends the guidance line's announcements
@@ -438,7 +567,10 @@ function Analyzer({
             ] }) : null
           ] }),
           frozen || !live ? /* @__PURE__ */ jsx(View, { style: [styles.phaseLayer, styles.raised], children }) : null,
+          !live && card ? /* @__PURE__ */ jsx(View, { style: [styles.liveColumn, styles.raised], children: card }) : null,
           live ? /* @__PURE__ */ jsxs(View, { style: [styles.liveColumn, styles.raised], children: [
+            card,
+            modeStrip,
             sequence ? /* @__PURE__ */ jsx(
               SequenceStrip,
               {
@@ -455,18 +587,25 @@ function Analyzer({
               ShutterTray,
               {
                 platform,
-                start: /* @__PURE__ */ jsx(GlassIconButton, { icon: "upload", label: "Upload a photo", onPress: onUpload }),
+                start: /* @__PURE__ */ jsx(
+                  GlassIconButton,
+                  {
+                    icon: "upload",
+                    label: uploadLabel ?? t.uploadPhoto,
+                    onPress: onUpload
+                  }
+                ),
                 primary: trayPrimary,
                 stack: continuous,
                 end: caps$1.flip ? /* @__PURE__ */ jsx(FlipButton, { onFlip }) : null
               }
             ),
-            /* @__PURE__ */ jsx(Text, { style: [styles.privacy, { color: camInk(theme) }], children: privacyStatement })
+            privacyStatement ? /* @__PURE__ */ jsx(Text, { style: [styles.privacy, { color: camInk(theme) }], children: privacyStatement }) : null
           ] }) : null
         ]
       }
     )
-  ] });
+  ] }) });
 }
 var analyzerSheet = createStyleSheet((theme) => ({
   scrim: {
@@ -477,6 +616,15 @@ var analyzerSheet = createStyleSheet((theme) => ({
     left: theme.space[0],
     right: theme.space[0]
   },
+  loading: {
+    position: "absolute",
+    top: theme.space[0],
+    bottom: theme.space[0],
+    left: theme.space[0],
+    right: theme.space[0],
+    alignItems: "center",
+    justifyContent: "center"
+  },
   topLayer: {
     pointerEvents: "box-none",
     zIndex: 1
@@ -508,6 +656,17 @@ var analyzerSheet = createStyleSheet((theme) => ({
     paddingHorizontal: theme.space[8],
     paddingBottom: theme.space[8]
   },
+  targetDot: {
+    position: "absolute",
+    width: theme.space[12],
+    height: theme.space[12],
+    marginLeft: -theme.space[12] / 2,
+    marginTop: -theme.space[12] / 2,
+    borderRadius: theme.radius.full,
+    borderWidth: theme.borderWidth.hair,
+    borderColor: theme.black.a12,
+    backgroundColor: camInk(theme)
+  },
   stretch: {
     alignSelf: "stretch"
   },