@paulinasource/face-capture-landmarks-lib/README.md

Biblioteca React para captura facial e detecção de landmarks em tempo real.

# @paulinasource/face-capture-landmarks-lib

A modern React library for real-time face capture and landmark detection, featuring ready-to-use UI components for facial authentication, registration, and behavioral biometrics.

## ✨ Features

- Real-time face detection and tracking
- Accurate facial landmarks using TensorFlow.js and MediaPipe
- Reusable React UI components
- Fully typed with TypeScript
- Prebuilt CSS styling included

## ⚠️ Important

To ensure styles are applied correctly, **don't forget to import the library's CSS** in your project:

```ts
import '@paulinasource/face-capture-landmarks-lib/styles.css';
```

## 🚀 Getting Started

```tsx
import { FaceAuthenticator, ProviderComponent } from '@paulinasource/face-capture-landmarks-lib';

function App() {
  return (
    <ProviderComponent>
      <FaceAuthenticator
        onSuccess={(landmarks) => console.log('Authenticated:', landmarks)}
        onError={(err) => console.error('Error:', err)}
      />
    </ProviderComponent>
  );
}
```

## 🧱 Available Components

- `DetectionFrame`
- `ErrorFrame`
- `FaceAuthenticator`
- `FloatingCameraMonitor`
- `ProcessingFrame`
- `ProgressIndicator`
- `SuccessFrame`
- `FaceRegistrationModal`
- `ProviderComponent`
- `FaceCaptureFlow`

All components can be imported individually:

```tsx
import {
  DetectionFrame,
  ErrorFrame,
  FaceAuthenticator,
  FloatingCameraMonitor,
  ProcessingFrame,
  ProgressIndicator,
  SuccessFrame,
  FaceRegistrationModal,
  ProviderComponent,
  FaceCaptureFlow
} from '@paulinasource/face-capture-landmarks-lib';
```

## 🧰 Built With

- [@tensorflow/tfjs](https://github.com/tensorflow/tfjs)
- [@tensorflow-models/face-landmarks-detection](https://github.com/tensorflow/tfjs-models/tree/master/face-landmarks-detection)
- [@mediapipe/face_mesh](https://github.com/google/mediapipe)
- [react-webcam](https://github.com/mozmorris/react-webcam)
- [framer-motion](https://www.framer.com/motion/)
- [lucide-react](https://lucide.dev/)
- React 19 and React DOM 19
- Autoprefixer

## 🌐 Browser Compatibility

Fully compatible with modern browsers:

- ✅ Google Chrome
- ✅ Firefox
- ✅ Microsoft Edge
- ✅ Safari

## 📄 License

MIT

## 📁 Repository

Source code available on GitHub:

[https://github.com/DelcioLuis/face-capture-landmarks-lib](https://github.com/DelcioLuis/face-capture-landmarks-lib)

## 🤝 Contributing

Contributions are welcome! Feel free to:

- Open issues for bugs, suggestions, or questions
- Submit pull requests with new features or fixes
- Discuss ideas and use cases

---

Made with ❤️ by [PaulinaSource](https://paulinasource.com)



credito,
nome do curso,
assinatura.

assinatura.


Deteccao de placho.