@pelayo2010/vision

Núcleo agnóstico de visión/pose: extracción de ángulos y articulaciones, comparación de poses y puntuación de sesión.

Paquete del Core de ConfÍA Platform. ESM puro, TypeScript strict, Node >= 20, licencia Apache-2.0 y cero dependencias de terceros.

Instalación

npm install @pelayo2010/vision

Uso

import * as vision from "@pelayo2010/vision";

Reglas del paquete

• Puramente matemático y determinista; sin dependencias de terceros ni de DOM.
• Agnóstico del proveedor de landmarks (MediaPipe, TFJS, nativo…).
• Sin semántica de producto: umbrales y ejercicios los aporta el consumidor.

Estructura

• src/accuracy-score.ts
• src/body-frame.ts
• src/errors.ts
• src/index.ts
• src/joint-cue.ts
• src/pose-angles.ts
• src/pose-comparison.ts
• src/pose-types.ts
• src/simple-pose.ts
• src/vision-port.ts

Superficie pública

53 símbolos exportados (17 de runtime, 36 de tipo). La lista congelada vive en core/api/public-api.json y se verifica en CI con npm run api:check.

AccuracyVerdict, AngleName, Angles, BodyPoint, CompareOptions, CoreVisionPort, FrameSample, IdealJointName, IdealPose, IdealPoseTemplate, JointAccuracy, JointCueInput, JointCueResolver, JointCueResult, JointDeviation, JointName, JointPoint, JointStatus, Joints, LANDMARK_INDEX, MainError, PoseComparisonResult, PoseLandmark, PoseSnapshot, SKELETON_EDGES, SessionAccuracy, SimpleAngleName, SimpleAngles, SimpleJoint, SimpleJointName, SimpleJoints, SimplePoseSnapshot, UserAnchor, VisionDetectionResult, VisionError, VisionErrorCode, VisionFrameSource, VisionLandmark, angle2D, angleAtJoint, buildSimpleSnapshot, comparePose, comparisonToFrame, computeUserAnchor, extractAngles, extractJoints, extractSimpleAngles, extractSimpleJoints, projectToImage, resolveJointCue, scoreSession, simpleVisibilityAverage, visibilityAverage.

Versionado

Publicación en lockstep con el resto del ecosistema (ADR-007): todos los paquetes comparten versión y release.

• Exports públicos: src/index.ts
• Tests: tests/
• Licencia: Apache-2.0 (LICENSE, NOTICE)