{"id":13406353,"url":"https://github.com/williamngan/pts","last_synced_at":"2026-10-18T23:48:31.350Z","repository":{"id":11304528,"uuid":"86075041","full_name":"williamngan/pts","owner":"williamngan","description":"A library for visualization and creative-coding","archived":false,"fork":false,"pushed_at":"2026-10-03T08:50:30.000Z","size":30888,"stargazers_count":5352,"open_issues_count":19,"forks_count":183,"subscribers_count":64,"default_branch":"master","last_synced_at":"2026-10-13T15:52:40.590Z","etag":null,"topics":["art","canvas","creative-coding","design","generative","generative-art","graphic-design","graphics","linear-algebra","pts","sound","svg","typescript","vector","visualization"],"latest_commit_sha":null,"homepage":"https://ptsjs.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/williamngan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2017-03-24T14:09:43.000Z","updated_at":"2026-10-13T12:11:50.000Z","dependencies_parsed_at":"2026-09-17T10:22:32.907Z","dependency_job_id":null,"html_url":"https://github.com/williamngan/pts","commit_stats":{"total_commits":813,"total_committers":27,"mean_commits":30.11111111111111,"dds":0.1340713407134071,"last_synced_commit":"0f350d4145efd2d54a57a7cd29d3c9a03a4e6bbb"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/williamngan/pts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamngan%2Fpts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamngan%2Fpts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamngan%2Fpts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamngan%2Fpts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/williamngan","download_url":"https://codeload.github.com/williamngan/pts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamngan%2Fpts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38343425,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-18T02:00:06.448Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["art","canvas","creative-coding","design","generative","generative-art","graphic-design","graphics","linear-algebra","pts","sound","svg","typescript","vector","visualization"],"created_at":"2024-07-30T19:02:27.949Z","updated_at":"2026-10-18T23:48:31.343Z","avatar_url":"https://github.com/williamngan.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","Libraries","Canvas"],"sub_categories":["Creativity","JavaScript"],"readme":"# Pts\n\n![Pts examples](https://raw.githubusercontent.com/williamngan/pts/master/assets/pts-gif-10.gif)\n\nPts is a TypeScript and JavaScript library for visualization and creative coding.\n\n**Get started at [ptsjs.org](https://ptsjs.org).** Please try it, [file issues](https://github.com/williamngan/pts/issues), and send feedback to [@williamngan](https://twitter.com/williamngan).\n\n## Usage\n\n### Browser script\n\nDownload `pts.js` or `pts.min.js` from the [dist directory](https://github.com/williamngan/pts/tree/master/dist), or use a CDN such as [cdnjs](https://cdnjs.com/libraries/pts), [jsDelivr](https://cdn.jsdelivr.net/npm/pts/dist/pts.min.js), or [unpkg](https://unpkg.com/pts/dist/pts.min.js).\n\n```html\n\u003cscript src=\"path/to/pts.min.js\"\u003e\u003c/script\u003e\n```\n\nThe classic script exposes the library as `globalThis.Pts`.\n\n### Package\n\nInstall the package:\n\n```bash\nnpm install pts\n```\n\nPts is ESM-first and also provides a CommonJS compatibility entry.\n\n```js\nimport { CanvasSpace, Group, Line, Pt } from \"pts\";\n```\n\n```js\nconst { CanvasSpace, Group, Line, Pt } = require(\"pts\");\n```\n\nStarter projects and integrations:\n\n- [pts-starter-kit](https://github.com/williamngan/pts-starter-kit)\n- [pts-react-example](https://github.com/williamngan/pts-react-example)\n- [react-pts-canvas](https://www.npmjs.com/package/react-pts-canvas)\n\nRead the [guides](https://ptsjs.org/guide/Get-started-0100.html) and explore the [demos](https://ptsjs.org/demo/?name=circle.intersectCircle2D).\n\n## Development\n\nThe maintained build environment is Node 24.18 or newer in the Node 24 line. The published library is also exercised on current Node 20 and 22 releases.\n\n```bash\npnpm install --frozen-lockfile\npnpm exec playwright install chromium\npnpm check\n```\n\nUseful individual commands include:\n\n```bash\npnpm build\npnpm typecheck\npnpm test\npnpm test:browser\npnpm test:integrations\npnpm check:package\npnpm format\npnpm format:watch\n```\n\n`pnpm check` validates formatting, linting, types, unit tests, deterministic documentation, documentation and bundle behavior in a real browser, reproducible artifacts, the packed package, ESM and CommonJS resolution, declarations, and tree-shaking. Its packed-package integration suite also builds and runs the maintained React, Vue, `skia-canvas`, and single-file vanilla fixtures in [`test/integrations`](./test/integrations).\n\nPrettier defines the repository's formatting rules. Run `pnpm format` once or keep `pnpm format:watch` running to reformat maintained source files as they change. The recommended VS Code extension and workspace settings also enable Prettier on save, while `pnpm check` rejects unformatted changes in CI.\n\n### Generate documentation\n\nThe documentation generator uses TypeDoc's Node API to rebuild the custom static documentation JSON from explicit source entry points. It also generates [`docs.md`](./docs.md), [`guide.md`](./guide.md), and [`llms.txt`](./llms.txt) for agents and other clients that cannot navigate the documentation SPA:\n\n```bash\npnpm run docs\n```\n\nGenerated documentation is checked in. `pnpm check:docs` regenerates it in memory, reports stale or extra files, and exercises navigation, search, anchors, and responsive layouts in Chromium.\n\n## Contributing\n\nIssues and small pull requests are welcome. For larger changes, please start a discussion with [@williamngan](https://twitter.com/williamngan).\n\n## License\n\nApache License 2.0. See [LICENSE](./LICENSE).\n\nCopyright © 2017-present William Ngan and contributors.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilliamngan%2Fpts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwilliamngan%2Fpts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilliamngan%2Fpts/lists"}