step-sequence-generator/README.md

A step sequence generator for figure skating programs

# 🎯 twizzle

Гибкая библиотека для генерации последовательностей движений на основе данных из Excel. Поддерживает инъекцию
зависимостей, собственные правила генерации и простое подключение новых источников данных.

## 🚀 Быстрый старт

```ts
import twizzle from 'index.ts';

const generator = twizzle();
generator.init();
const sequence = generator.generate();
```

## 📦 Что внутри

StepSequenceGenerator — ядро генерации.

BaseExcelParser — базовый Excel-парсер.

DefaultExcelFormatter — форматтер данных из Excel.

DifficultLevelAmountStep — настройка сложности последовательности.

## 🧱 Архитектура

Используется подход SOLID.

Возможность подключения:

🧠 Стратегий фильтрации (в будущих версиях).

## 📅 Планы

Поддержка стратегий фильтрации.

Поддержка нескольких форматов входных данных.

Визуализация и экспорт сгенерированных последовательностей.

## 🧪 Тестирование

Тесты написаны с использованием vitest. Покрываются:

- генерация
- Excel-парсинг
- загрузка движений

## 🪪 Лицензия

MIT

## Путь к xlsx
Указать в .env
### Переменные
EXCEL_DIR_PATH

EXCEL_FILE_NAME