@vention/machine-apps-components 1.10.1 → 1.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vention/machine-apps-components",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/VentionCo/machine-cloud.git"
@@ -15,7 +15,8 @@
     "i18next": "^23.0.0",
     "i18next-browser-languagedetector": "^8.0.0",
     "react-i18next": "^15.0.1",
-    "tss-react": "^4.9.20"
+    "tss-react": "^4.9.20",
+    "@vention/machine-logic-ui-sdk": "0.37.0"
   },
   "peerDependencies": {
     "react": "17.0.2",

package/src/i18n/locales/de.d.ts

@@ -137,5 +137,41 @@ declare const _default: {
         deleteConfirmation: string;
         emptyState: string;
     };
+    calibration: {
+        footer: {
+            loading: string;
+            cancel: string;
+            neverCompleted: string;
+            lastCompleted: string;
+        };
+        handEye: {
+            calibrate: {
+                calibrate: string;
+                update: string;
+                cancel: string;
+                cancelling: string;
+                running: string;
+                lastCalibratedOn: string;
+                never: string;
+            };
+            verify: {
+                action: string;
+                loading: string;
+            };
+        };
+        environment: {
+            topAlert: string;
+            helper: string;
+            startSession: string;
+            starting: string;
+            takePhoto: string;
+            endSession: string;
+            sessionLabel: string;
+            photoCount: string;
+            noPhotos: string;
+            lastPhotoAt: string;
+            error: string;
+        };
+    };
 };
 export default _default;

package/src/i18n/locales/en.d.ts

@@ -137,5 +137,41 @@ declare const _default: {
         deleteConfirmation: string;
         emptyState: string;
     };
+    calibration: {
+        footer: {
+            loading: string;
+            cancel: string;
+            neverCompleted: string;
+            lastCompleted: string;
+        };
+        handEye: {
+            calibrate: {
+                calibrate: string;
+                update: string;
+                cancel: string;
+                cancelling: string;
+                running: string;
+                lastCalibratedOn: string;
+                never: string;
+            };
+            verify: {
+                action: string;
+                loading: string;
+            };
+        };
+        environment: {
+            topAlert: string;
+            helper: string;
+            startSession: string;
+            starting: string;
+            takePhoto: string;
+            endSession: string;
+            sessionLabel: string;
+            photoCount: string;
+            noPhotos: string;
+            lastPhotoAt: string;
+            error: string;
+        };
+    };
 };
 export default _default;

package/src/i18n/locales/es.d.ts

@@ -137,5 +137,41 @@ declare const _default: {
         deleteConfirmation: string;
         emptyState: string;
     };
+    calibration: {
+        footer: {
+            loading: string;
+            cancel: string;
+            neverCompleted: string;
+            lastCompleted: string;
+        };
+        handEye: {
+            calibrate: {
+                calibrate: string;
+                update: string;
+                cancel: string;
+                cancelling: string;
+                running: string;
+                lastCalibratedOn: string;
+                never: string;
+            };
+            verify: {
+                action: string;
+                loading: string;
+            };
+        };
+        environment: {
+            topAlert: string;
+            helper: string;
+            startSession: string;
+            starting: string;
+            takePhoto: string;
+            endSession: string;
+            sessionLabel: string;
+            photoCount: string;
+            noPhotos: string;
+            lastPhotoAt: string;
+            error: string;
+        };
+    };
 };
 export default _default;

package/src/i18n/locales/fr.d.ts

@@ -137,5 +137,41 @@ declare const _default: {
         deleteConfirmation: string;
         emptyState: string;
     };
+    calibration: {
+        footer: {
+            loading: string;
+            cancel: string;
+            neverCompleted: string;
+            lastCompleted: string;
+        };
+        handEye: {
+            calibrate: {
+                calibrate: string;
+                update: string;
+                cancel: string;
+                cancelling: string;
+                running: string;
+                lastCalibratedOn: string;
+                never: string;
+            };
+            verify: {
+                action: string;
+                loading: string;
+            };
+        };
+        environment: {
+            topAlert: string;
+            helper: string;
+            startSession: string;
+            starting: string;
+            takePhoto: string;
+            endSession: string;
+            sessionLabel: string;
+            photoCount: string;
+            noPhotos: string;
+            lastPhotoAt: string;
+            error: string;
+        };
+    };
 };
 export default _default;

package/src/index.d.ts

@@ -21,6 +21,13 @@ export * from "./lib/step-progress-circle/step-progress-circle";
 export * from "./lib/action-button/action-button";
 export * from "./lib/press-button/press-button";
 export * from "./lib/product-form-list/product-form-list";
+export * from "./lib/calibration-footer/calibration-footer";
+export type { CalibrationFooterProps } from "./lib/calibration-footer/calibration-footer";
+export * from "./lib/calibration-mqtt/topics";
+export * from "./lib/calibration-hand-eye-page/calibration-hand-eye-page";
+export type { CalibrationHandEyePageProps, CalibrationProgress, CalibrationProgressStatus, HandEyeVerifyResult, } from "./lib/calibration-hand-eye-page/calibration-hand-eye-page";
+export * from "./lib/calibration-environment-page/calibration-environment-page";
+export type { CalibrationEnvironmentPageProps } from "./lib/calibration-environment-page/calibration-environment-page";
 export * from "./hooks/use-auto-scroll-input";
 export * from "./types/user-level";
 export * from "./lib/utils/api-config-utils";

package/src/lib/calibration-environment-page/calibration-environment-page.d.ts

@@ -0,0 +1,22 @@
+import { ReactNode } from "react";
+import { SxProps, Theme } from "@mui/material";
+export interface CalibrationEnvironmentPageProps {
+    onStartSession: () => Promise<void>;
+    onTakePhoto: () => Promise<void>;
+    onEndSession: () => Promise<void>;
+    sessionName?: string | null;
+    photoCount: number;
+    lastPhotoAt?: Date | null;
+    isError?: boolean;
+    errorMessage?: string;
+    isBusy?: boolean;
+    illustration?: ReactNode;
+    helperText?: string;
+    topAlertTitle?: string;
+    className?: string;
+    sx?: SxProps<Theme>;
+}
+export declare const CalibrationEnvironmentPage: {
+    ({ onStartSession, onTakePhoto, onEndSession, sessionName, photoCount, lastPhotoAt, isError, errorMessage, isBusy, illustration, helperText, topAlertTitle, className, sx, }: CalibrationEnvironmentPageProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/src/lib/calibration-footer/calibration-footer.d.ts

@@ -0,0 +1,20 @@
+import { SxProps, Theme } from "@mui/material";
+export interface CalibrationFooterProps {
+    primaryLabel: string;
+    onPrimaryAction: () => void;
+    isLoading?: boolean;
+    loadingLabel?: string;
+    disabled?: boolean;
+    onCancel?: () => void;
+    cancelLabel?: string;
+    lastCompletedAt?: Date | null;
+    completedLabelPrefix?: string;
+    neverCompletedLabel?: string;
+    className?: string;
+    sx?: SxProps<Theme>;
+    "data-testid"?: string;
+}
+export declare const CalibrationFooter: {
+    ({ primaryLabel, onPrimaryAction, isLoading, loadingLabel, disabled, onCancel, cancelLabel, lastCompletedAt, completedLabelPrefix, neverCompletedLabel, className, sx, "data-testid": dataTestId, }: CalibrationFooterProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/src/lib/calibration-hand-eye-page/calibration-hand-eye-page.d.ts

@@ -0,0 +1,45 @@
+import { SxProps, Theme } from "@mui/material";
+export type CalibrationProgressStatus = "idle" | "running" | "success" | "error" | "cancelled";
+export interface CalibrationProgress {
+    percent: number;
+    status: CalibrationProgressStatus;
+    message?: string;
+}
+export interface HandEyeVerifyResult {
+    isValid: boolean;
+    message: string;
+    posErrorMm?: number;
+    rotErrorDeg?: number;
+}
+export interface CalibrationHandEyePageProps {
+    /** Fire-and-forget start. Throws are caught and surfaced via `onError`. */
+    onCalibrate: () => Promise<void>;
+    /** Fire-and-forget cancel. While the cancel call is in flight the UI shows a "Cancelling..." state. */
+    onCancel: () => Promise<void> | void;
+    /**
+     * Live progress. If passed, wins over MQTT — useful in stories and tests.
+     * Outside those contexts, leave undefined and rely on the MQTT subscription
+     * to `griip/calibration/hand_eye/progress`.
+     */
+    progress?: CalibrationProgress;
+    /** Last successful hand-eye calibration. Renders "Calibrated on …" below the primary button. */
+    lastCalibrationAt?: Date | null;
+    /** Force Start to render even when a (possibly stale) "running" message says otherwise. */
+    forceShowStart?: boolean;
+    /** Disable the primary button (consumer-driven, e.g. while another flow holds the hardware). */
+    disabled?: boolean;
+    /**
+     * Inline error message rendered above the primary button. Use this for backend errors
+     * the consumer wants to surface (e.g. "calibration_joints not set in cell yaml").
+     */
+    error?: string | null;
+    /** Invoked when `onCalibrate` or `onCancel` rejects. The component shows the rejection's `message` until cleared. */
+    onError?: (error: Error) => void;
+    onVerify?: () => Promise<HandEyeVerifyResult>;
+    className?: string;
+    sx?: SxProps<Theme>;
+}
+export declare const CalibrationHandEyePage: {
+    ({ onCalibrate, onCancel, progress, lastCalibrationAt, forceShowStart, disabled, error, onError, onVerify, className, sx, }: CalibrationHandEyePageProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/src/lib/calibration-mqtt/topics.d.ts

@@ -0,0 +1,13 @@
+export declare const HAND_EYE_PROGRESS_TOPIC = "griip/calibration/hand_eye/progress";
+export declare const ENVIRONMENT_PROGRESS_TOPIC = "griip/calibration/environment/progress";
+export interface HandEyeProgressMessage {
+    percentage: number;
+    status: "in_progress" | "success" | "error" | "cancelled";
+    message: string;
+}
+export interface EnvironmentProgressMessage {
+    status: "in_progress" | "success" | "error";
+    message: string;
+    sessionName?: string | null;
+    photoCount?: number;
+}