feat: add edutainment drawing and visual package flows

src/components/child-motion-demo/childMotionWarmupModel.ts

@@ -32,6 +32,20 @@ export type ChildMotionWarmupStep = {
 export type ChildMotionPoint = {
   x: number;
   y: number;
+  isRaised?: boolean;
+  isArmExtended?: boolean;
+  armAngleDeg?: number;
+  armReach?: number;
+};
+
+export type ChildMotionHandSpace = {
+  minX: number;
+  maxX: number;
+  minY: number;
+  maxY: number;
+  minAngleDeg: number | null;
+  maxAngleDeg: number | null;
+  maxReach: number | null;
 };
 
 export type ChildMotionWarmupCalibration = {
@@ -39,6 +53,8 @@ export type ChildMotionWarmupCalibration = {
   rightBoundary: number | null;
   leftHandPath: ChildMotionPoint[];
   rightHandPath: ChildMotionPoint[];
+  leftHandSpace: ChildMotionHandSpace | null;
+  rightHandSpace: ChildMotionHandSpace | null;
   jumpSpace: number | null;
 };
 
@@ -206,10 +222,39 @@ export function createEmptyChildMotionCalibration(): ChildMotionWarmupCalibratio
     rightBoundary: null,
     leftHandPath: [],
     rightHandPath: [],
+    leftHandSpace: null,
+    rightHandSpace: null,
     jumpSpace: null,
   };
 }
 
+function resolveChildMotionHandSpace(
+  path: ChildMotionPoint[],
+): ChildMotionHandSpace | null {
+  if (path.length === 0) {
+    return null;
+  }
+
+  const xValues = path.map((point) => point.x);
+  const yValues = path.map((point) => point.y);
+  const angleValues = path
+    .map((point) => point.armAngleDeg)
+    .filter((angle): angle is number => typeof angle === 'number');
+  const reachValues = path
+    .map((point) => point.armReach)
+    .filter((reach): reach is number => typeof reach === 'number');
+
+  return {
+    minX: Math.min(...xValues),
+    maxX: Math.max(...xValues),
+    minY: Math.min(...yValues),
+    maxY: Math.max(...yValues),
+    minAngleDeg: angleValues.length > 0 ? Math.min(...angleValues) : null,
+    maxAngleDeg: angleValues.length > 0 ? Math.max(...angleValues) : null,
+    maxReach: reachValues.length > 0 ? Math.max(...reachValues) : null,
+  };
+}
+
 export function applyChildMotionWarmupCompletion(
   stepId: ChildMotionWarmupStepId,
   calibration: ChildMotionWarmupCalibration,
@@ -233,6 +278,7 @@ export function applyChildMotionWarmupCompletion(
     return {
       ...calibration,
       leftHandPath: completion.path,
+      leftHandSpace: resolveChildMotionHandSpace(completion.path),
     };
   }
 
@@ -240,6 +286,7 @@ export function applyChildMotionWarmupCompletion(
     return {
       ...calibration,
       rightHandPath: completion.path,
+      rightHandSpace: resolveChildMotionHandSpace(completion.path),
     };
   }