pts

Pts — это библиотека на TypeScript и JavaScript, предназначенная для визуализации и креативного кодинга. Она предоставляет примитивы для рисования и анимации на canvas и распространяется как в виде браузерного скрипта, так и в виде npm-пакета. Варианты использования - Браузерный скрипт: скачайте pts.js или pts.min.js из каталога dist или загрузите с CDN, такого как cdnjs, jsDelivr или unpkg. Классический скрипт предоставляет библиотеку как globalThis.Pts. - Пакет: установите с помощью npm install pts. Библиотека ориентирована на ESM, но также предоставляет совместимую запись для CommonJS, поэтому её можно импортировать через import { CanvasSpace, Group, Line, Pt } from "pts" или подключить через require("pts"). Стартовые проекты и интеграции, перечисленные в README, включают pts-starter-kit, pts-react-example и npm-пакет react-pts-canvas. Руководства и демо доступны на сайте проекта. Разработка Поддерживаемая среда сборки — Node 24.18 или новее в линейке Node 24, а опубликованная библиотека также тестируется на текущих версиях Node 20 и 22. Настройка выполняется с помощью pnpm install --frozen-lockfile, pnpm exec playwright install chromium и pnpm check. Отдельные команды включают build, typecheck, test, test:browser, test:integrations, check:package, format и format:watch. Команда pnpm check проверяет форматирование, линтинг, типы, модульные тесты, детерминированную документацию, поведение документации и бандла в реальном браузере, воспроизводимые артефакты, упакованный пакет, разрешение ESM и CommonJS, объявления и tree-shaking. Её набор интеграционных тестов для упакованного пакета также собирает и запускает поддерживаемые фикстуры React, Vue, skia-canvas и одностраничного vanilla в каталоге test/integrations. Prettier определяет правила форматирования репозитория. Запуск pnpm format один раз или постоянный запуск pnpm format:watch переформатирует поддерживаемые исходные файлы по мере их изменения. Рекомендуемое расширение VS Code и настройки рабочего пространства также включают Prettier при сохранении, а pnpm check отклоняет неотформатированные изменения в CI. Генерация документации Генератор документации использует Node API TypeDoc для пересборки пользовательского статического JSON-документа из явных точек входа исходного кода. Он также генерирует docs.md, guide.md и llms.txt для агентов и других клиентов, которые не могут перемещаться по SPA-документации. Сгенерированная документация включена в репозиторий; pnpm check:docs перегенерирует её в памяти, сообщает об устаревших или лишних файлах и проверяет навигацию, поиск, якоря и адаптивные макеты в Chromium. Вклад и лицензия Приветствуются сообщения об ошибках и небольшие pull request; крупные изменения следует начинать с обсуждения с мейнтейнером. Проект лицензирован под Apache License 2.0, авторские права с 2017 года принадлежат William Ngan и участникам.