From 9716389036fb416319f1dacc712ce385bebe9466 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Mon, 22 Dec 2025 12:52:49 +0100
Subject: [PATCH 01/29] docs: Add initial READMEs for various packages and
scripts, remove SECURITY.md, and update CodeRabbit path instructions.
---
.coderabbit.yaml | 7 ++
SECURITY.md | 43 -----------
apps/api/README.md | 59 +++++++++++++++
docker/README.md | 61 ++++++++++++++++
.../testing/TEST_SUMMARY.md | 0
.../testing/UNIT_TESTS_GENERATED.md | 0
packages/biome-config/README.md | 25 +++++++
packages/engine/README.md | 53 ++++++++++++++
packages/github/README.md | 57 +++++++++++++++
packages/renderer/README.md | 60 ++++++++++++++++
packages/types/README.md | 72 +++++++++++++++++++
packages/typescript-config/README.md | 52 ++++++++++++++
packages/ui/README.md | 68 ++++++++++++++++++
scripts/README.md | 49 +++++++++++++
14 files changed, 563 insertions(+), 43 deletions(-)
delete mode 100644 SECURITY.md
create mode 100644 apps/api/README.md
create mode 100644 docker/README.md
rename TEST_SUMMARY.md => docs/testing/TEST_SUMMARY.md (100%)
rename UNIT_TESTS_GENERATED.md => docs/testing/UNIT_TESTS_GENERATED.md (100%)
create mode 100644 packages/biome-config/README.md
create mode 100644 packages/engine/README.md
create mode 100644 packages/github/README.md
create mode 100644 packages/renderer/README.md
create mode 100644 packages/types/README.md
create mode 100644 packages/typescript-config/README.md
create mode 100644 packages/ui/README.md
create mode 100644 scripts/README.md
diff --git a/.coderabbit.yaml b/.coderabbit.yaml
index a3ddd6b..ffa2831 100644
--- a/.coderabbit.yaml
+++ b/.coderabbit.yaml
@@ -42,6 +42,13 @@ reviews:
# Auto-generate PR title following Conventional Commits
auto_title_instructions: "Generate the PR title following the Conventional Commits specification (e.g., 'feat:', 'fix:', 'chore:', 'docs:'). Keep it concise and descriptive."
+ # Path-specific instructions for generated content
+ path_instructions:
+ - path: "docs/testing/**"
+ instructions: "Place all test documentation, summaries, and generated test reports here."
+ - path: "*.md"
+ instructions: "Root-level markdown files should only contain essential project documentation (README, CHANGELOG, etc.). Generated documentation belongs in docs/."
+
chat:
# Enable conversational bot on PRs
auto_reply: true
diff --git a/SECURITY.md b/SECURITY.md
deleted file mode 100644
index 0172c41..0000000
--- a/SECURITY.md
+++ /dev/null
@@ -1,43 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported |
-| ------- | ------------------ |
-| 1.x.x | :white_check_mark: |
-| < 1.0 | :x: |
-
-## Reporting a Vulnerability
-
-If you discover a security vulnerability, please report it by:
-
-1. **DO NOT** open a public GitHub issue
-2. Email us at:
+
Date: Mon, 22 Dec 2025 13:09:05 +0100
Subject: [PATCH 02/29] refactor: Consolidate and simplify root package.json
scripts, removing redundant tasks and updating related configurations and
documentation.
---
CHANGELOG.md | 17 ++++++++++
__tests__/package-config.test.ts | 15 ++++-----
.../src/content/docs/guides/installation.md | 9 +++---
package.json | 32 +++++++++----------
turbo.json | 16 ++--------
5 files changed, 47 insertions(+), 42 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 576f874..d6800df 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,10 +13,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- **SVG Sanitization** - Replaced fragile regex-based sanitization with `isomorphic-dompurify` for robust, isomorphic SVG sanitization in both browser and server environments
- **ReDoS Fix** - Fixed polynomial regex vulnerability by replacing with O(1) string checks
+### Added
+
+- **README Files** - Added professional README.md documentation to all packages and directories:
+ - `packages/engine`, `packages/renderer`, `packages/github`, `packages/types`, `packages/ui`
+ - `packages/biome-config`, `packages/typescript-config`
+ - `apps/api`, `docker`, `scripts`
+
+### Changed
+
+- **Script Consolidation** - Reduced root package.json scripts from 30 to 21:
+ - `format` + `format:check` merged into `lint` (Biome handles both)
+ - `quality` + `precommit` consolidated into `check`
+ - `type-check` renamed to `typecheck`
+ - `clean:all` merged into `clean`
+- **Turbo Config** - Cleaned up unused tasks (`test:watch`, `format`, `format:check`)
+
### Fixed
- Removed deprecated `@types/dompurify` package (dompurify has built-in types)
- Fixed test for empty format string to correctly expect "svg" default
+- Removed duplicate `SECURITY.md` from root (using `.github/SECURITY.md`)
### Removed
diff --git a/__tests__/package-config.test.ts b/__tests__/package-config.test.ts
index 2b61e7e..6712ff7 100644
--- a/__tests__/package-config.test.ts
+++ b/__tests__/package-config.test.ts
@@ -44,19 +44,18 @@ describe("Package Configuration", () => {
expect(scripts.build).toBeDefined();
expect(scripts.test).toBeDefined();
expect(scripts.lint).toBeDefined();
- expect(scripts.format).toBeDefined();
- expect(scripts["type-check"]).toBeDefined();
- expect(scripts.quality).toBeDefined();
+ expect(scripts.typecheck).toBeDefined();
+ expect(scripts.check).toBeDefined();
+ expect(scripts.fix).toBeDefined();
});
- test("quality script should run all checks", () => {
+ test("check script should run lint and typecheck", () => {
expect(pkg.scripts).toBeDefined();
const scripts = pkg.scripts as Record
Date: Mon, 22 Dec 2025 13:45:04 +0100
Subject: [PATCH 03/29] feat: Add GIF output implementation guide and update
roadmap to detail v1.3.0 GIF and glass theme features.
---
docs/GIF_IMPLEMENTATION.md | 268 +++++++++++++++++++++++++++++++++++++
docs/ROADMAP.md | 62 +++++++--
2 files changed, 319 insertions(+), 11 deletions(-)
create mode 100644 docs/GIF_IMPLEMENTATION.md
diff --git a/docs/GIF_IMPLEMENTATION.md b/docs/GIF_IMPLEMENTATION.md
new file mode 100644
index 0000000..d69191b
--- /dev/null
+++ b/docs/GIF_IMPLEMENTATION.md
@@ -0,0 +1,268 @@
+# GIF Implementation Guide (v1.3.0)
+
+Technical documentation for implementing GIF output format in Snake Evolution.
+
+> **Status:** Planned for v1.3.0 (January 2025)
+> **Research date:** December 22, 2025
+
+## Overview
+
+GIF output enables:
+
+1. **Glass theme** - Pre-rendered blur effects (too heavy for SVG)
+2. **Email embedding** - Works in email clients unlike SVG
+3. **Universal compatibility** - Every platform supports GIF
+
+## Architecture
+
+```
+┌─────────────────┐
+│ SnakeFrame[] │ Simulation output
+└────────┬────────┘
+ │
+ ▼
+┌─────────────────┐
+│ renderStaticSVG │ Generate SVG for each frame
+└────────┬────────┘
+ │
+ ▼
+┌─────────────────┐
+│ @resvg/resvg-js│ Rust/WASM SVG → RGBA pixels
+└────────┬────────┘
+ │
+ ▼
+┌─────────────────┐
+│ gifenc │ Pure JS GIF encoder
+└────────┬────────┘
+ │
+ ▼
+┌─────────────────┐
+│ Buffer (GIF) │ Final output
+└─────────────────┘
+```
+
+## Dependencies
+
+Install in `packages/renderer`:
+
+```bash
+bun add @resvg/resvg-js gifenc
+```
+
+| Package | Version | Size | Notes |
+|---------|---------|------|-------|
+| `@resvg/resvg-js` | ^2.6.2 | ~3MB | Rust/WASM, Bun compatible since 0.8.1 |
+| `gifenc` | ^1.0.3 | 9KB | Pure JS, no deps |
+
+## Implementation
+
+### Core Function
+
+**File:** `packages/renderer/src/gif.ts`
+
+```typescript
+import { Resvg } from "@resvg/resvg-js";
+import { GIFEncoder, quantize, applyPalette } from "gifenc";
+import type { SnakeFrame, RenderOptions } from "@snake-evolution/types";
+import { renderStaticSVG } from "./index";
+
+interface GifOptions extends Partial
Date: Sat, 10 Jan 2026 07:15:20 +0100
Subject: [PATCH 04/29] update: all minors
---
apps/api/package.json | 4 +-
apps/web/package.json | 4 +-
bun.lock | 178 ++++----
docs/RELEASE_SETUP.md | 115 ------
docs/ROADMAP_V2.md | 836 ++++++++++++++++++++++++++++++++++++++
package.json | 13 +-
packages/cli/package.json | 2 +-
packages/ui/package.json | 4 +-
8 files changed, 937 insertions(+), 219 deletions(-)
delete mode 100644 docs/RELEASE_SETUP.md
create mode 100644 docs/ROADMAP_V2.md
diff --git a/apps/api/package.json b/apps/api/package.json
index 1b01d81..705f8cc 100644
--- a/apps/api/package.json
+++ b/apps/api/package.json
@@ -11,9 +11,9 @@
"clean": "rm -rf dist node_modules"
},
"dependencies": {
- "@elysiajs/cors": "^1.4.0",
+ "@elysiajs/cors": "^1.4.1",
"@elysiajs/swagger": "^1.3.1",
- "elysia": "^1.4.19"
+ "elysia": "^1.4.21"
},
"devDependencies": {}
}
diff --git a/apps/web/package.json b/apps/web/package.json
index 5f06ced..4b65b3d 100644
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -11,10 +11,10 @@
"clean": "rm -rf dist .astro node_modules"
},
"dependencies": {
- "@astrojs/starlight": "^0.37.1",
+ "@astrojs/starlight": "^0.37.2",
"@tailwindcss/postcss": "^4.1.18",
"@tailwindcss/vite": "^4.1.18",
- "astro": "^5.16.6",
+ "astro": "^5.16.8",
"sharp": "^0.34.2",
"tailwindcss": "^4.1.18"
},
diff --git a/bun.lock b/bun.lock
index d1a6902..2ccb80d 100644
--- a/bun.lock
+++ b/bun.lock
@@ -5,33 +5,33 @@
"": {
"name": "snake-evolution",
"devDependencies": {
- "@biomejs/biome": "^2.3.10",
+ "@biomejs/biome": "^2.3.11",
"@changesets/cli": "^2.29.8",
"@types/bun": "1.3.5",
"jsonc-parser": "^3.3.1",
"markdownlint-cli2": "^0.20.0",
- "turbo": "^2.7.1",
+ "turbo": "^2.7.3",
"typescript": "5.9.3",
"yaml": "2.8.2",
},
},
"apps/api": {
"name": "@snake-evolution/api",
- "version": "1.2.3",
+ "version": "1.2.4",
"dependencies": {
- "@elysiajs/cors": "^1.4.0",
+ "@elysiajs/cors": "^1.4.1",
"@elysiajs/swagger": "^1.3.1",
- "elysia": "^1.4.19",
+ "elysia": "^1.4.21",
},
},
"apps/web": {
"name": "@snake-evolution/web",
- "version": "1.2.3",
+ "version": "1.2.4",
"dependencies": {
- "@astrojs/starlight": "^0.37.1",
+ "@astrojs/starlight": "^0.37.2",
"@tailwindcss/postcss": "^4.1.18",
"@tailwindcss/vite": "^4.1.18",
- "astro": "^5.16.6",
+ "astro": "^5.16.8",
"sharp": "^0.34.2",
"tailwindcss": "^4.1.18",
},
@@ -41,11 +41,11 @@
},
"packages/biome-config": {
"name": "@snake-evolution/biome-config",
- "version": "1.2.3",
+ "version": "1.2.4",
},
"packages/cli": {
"name": "@snake-evolution/cli",
- "version": "1.2.3",
+ "version": "1.2.4",
"bin": {
"snake": "./dist/index.js",
},
@@ -54,48 +54,48 @@
"@snake-evolution/github": "workspace:*",
"@snake-evolution/renderer": "workspace:*",
"@snake-evolution/types": "workspace:*",
- "@types/node": "^25.0.3",
+ "@types/node": "^25.0.6",
"commander": "^14.0.2",
},
},
"packages/engine": {
"name": "@snake-evolution/engine",
- "version": "1.2.3",
+ "version": "1.2.4",
"dependencies": {
"@snake-evolution/types": "workspace:*",
},
},
"packages/github": {
"name": "@snake-evolution/github",
- "version": "1.2.3",
+ "version": "1.2.4",
"dependencies": {
"@snake-evolution/types": "workspace:*",
},
},
"packages/renderer": {
"name": "@snake-evolution/renderer",
- "version": "1.2.3",
+ "version": "1.2.4",
"dependencies": {
"@snake-evolution/types": "workspace:*",
},
},
"packages/types": {
"name": "@snake-evolution/types",
- "version": "1.2.3",
+ "version": "1.2.4",
},
"packages/typescript-config": {
"name": "@snake-evolution/typescript-config",
- "version": "1.2.3",
+ "version": "1.2.4",
},
"packages/ui": {
"name": "@snake-evolution/ui",
- "version": "1.2.3",
+ "version": "1.2.4",
"dependencies": {
- "isomorphic-dompurify": "^2.34.0",
+ "isomorphic-dompurify": "^2.35.0",
"react": "^19.0.0",
},
"devDependencies": {
- "@types/react": "^19.0.0",
+ "@types/react": "^19.2.8",
},
"peerDependencies": {
"react": "^18.0.0 || ^19.0.0",
@@ -135,7 +135,7 @@
"@astrojs/sitemap": ["@astrojs/sitemap@3.6.0", "", { "dependencies": { "sitemap": "^8.0.0", "stream-replace-string": "^2.0.0", "zod": "^3.25.76" } }, "sha512-4aHkvcOZBWJigRmMIAJwRQXBS+ayoP5z40OklTXYXhUDhwusz+DyDl+nSshY6y9DvkVEavwNcFO8FD81iGhXjg=="],
- "@astrojs/starlight": ["@astrojs/starlight@0.37.1", "", { "dependencies": { "@astrojs/markdown-remark": "^6.3.1", "@astrojs/mdx": "^4.2.3", "@astrojs/sitemap": "^3.3.0", "@pagefind/default-ui": "^1.3.0", "@types/hast": "^3.0.4", "@types/js-yaml": "^4.0.9", "@types/mdast": "^4.0.4", "astro-expressive-code": "^0.41.1", "bcp-47": "^2.1.0", "hast-util-from-html": "^2.0.1", "hast-util-select": "^6.0.2", "hast-util-to-string": "^3.0.0", "hastscript": "^9.0.0", "i18next": "^23.11.5", "js-yaml": "^4.1.0", "klona": "^2.0.6", "magic-string": "^0.30.17", "mdast-util-directive": "^3.0.0", "mdast-util-to-markdown": "^2.1.0", "mdast-util-to-string": "^4.0.0", "pagefind": "^1.3.0", "rehype": "^13.0.1", "rehype-format": "^5.0.0", "remark-directive": "^3.0.0", "ultrahtml": "^1.6.0", "unified": "^11.0.5", "unist-util-visit": "^5.0.0", "vfile": "^6.0.2" }, "peerDependencies": { "astro": "^5.5.0" } }, "sha512-STNsR5PaDoiW4IgcX17Fp42FfyqwuweWPts/EWEMcFPAeg9Nvpu3UvVCorasYrgfJgaJTeydsOV++0ACA1KYDA=="],
+ "@astrojs/starlight": ["@astrojs/starlight@0.37.2", "", { "dependencies": { "@astrojs/markdown-remark": "^6.3.1", "@astrojs/mdx": "^4.2.3", "@astrojs/sitemap": "^3.3.0", "@pagefind/default-ui": "^1.3.0", "@types/hast": "^3.0.4", "@types/js-yaml": "^4.0.9", "@types/mdast": "^4.0.4", "astro-expressive-code": "^0.41.1", "bcp-47": "^2.1.0", "hast-util-from-html": "^2.0.1", "hast-util-select": "^6.0.2", "hast-util-to-string": "^3.0.0", "hastscript": "^9.0.0", "i18next": "^23.11.5", "js-yaml": "^4.1.0", "klona": "^2.0.6", "magic-string": "^0.30.17", "mdast-util-directive": "^3.0.0", "mdast-util-to-markdown": "^2.1.0", "mdast-util-to-string": "^4.0.0", "pagefind": "^1.3.0", "rehype": "^13.0.1", "rehype-format": "^5.0.0", "remark-directive": "^3.0.0", "ultrahtml": "^1.6.0", "unified": "^11.0.5", "unist-util-visit": "^5.0.0", "vfile": "^6.0.2" }, "peerDependencies": { "astro": "^5.5.0" } }, "sha512-DGeaaKizwxHDsz72FdxyIBZ32eY8OdUoH6b757BGZlLEDq82O4uipFWoh+kz7+aKg1QoFu/rDq6fqtw+58tpRQ=="],
"@astrojs/telemetry": ["@astrojs/telemetry@3.3.0", "", { "dependencies": { "ci-info": "^4.2.0", "debug": "^4.4.0", "dlv": "^1.1.3", "dset": "^3.1.4", "is-docker": "^3.0.0", "is-wsl": "^3.1.0", "which-pm-runs": "^1.1.0" } }, "sha512-UFBgfeldP06qu6khs/yY+q1cDAaArM2/7AEIqQ9Cuvf7B1hNLq0xDrZkct+QoIGyjq56y8IaE2I3CTvG99mlhQ=="],
@@ -151,27 +151,27 @@
"@babel/types": ["@babel/types@7.28.5", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA=="],
- "@biomejs/biome": ["@biomejs/biome@2.3.10", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.3.10", "@biomejs/cli-darwin-x64": "2.3.10", "@biomejs/cli-linux-arm64": "2.3.10", "@biomejs/cli-linux-arm64-musl": "2.3.10", "@biomejs/cli-linux-x64": "2.3.10", "@biomejs/cli-linux-x64-musl": "2.3.10", "@biomejs/cli-win32-arm64": "2.3.10", "@biomejs/cli-win32-x64": "2.3.10" }, "bin": { "biome": "bin/biome" } }, "sha512-/uWSUd1MHX2fjqNLHNL6zLYWBbrJeG412/8H7ESuK8ewoRoMPUgHDebqKrPTx/5n6f17Xzqc9hdg3MEqA5hXnQ=="],
+ "@biomejs/biome": ["@biomejs/biome@2.3.11", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.3.11", "@biomejs/cli-darwin-x64": "2.3.11", "@biomejs/cli-linux-arm64": "2.3.11", "@biomejs/cli-linux-arm64-musl": "2.3.11", "@biomejs/cli-linux-x64": "2.3.11", "@biomejs/cli-linux-x64-musl": "2.3.11", "@biomejs/cli-win32-arm64": "2.3.11", "@biomejs/cli-win32-x64": "2.3.11" }, "bin": { "biome": "bin/biome" } }, "sha512-/zt+6qazBWguPG6+eWmiELqO+9jRsMZ/DBU3lfuU2ngtIQYzymocHhKiZRyrbra4aCOoyTg/BmY+6WH5mv9xmQ=="],
- "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.3.10", "", { "os": "darwin", "cpu": "arm64" }, "sha512-M6xUjtCVnNGFfK7HMNKa593nb7fwNm43fq1Mt71kpLpb+4mE7odO8W/oWVDyBVO4ackhresy1ZYO7OJcVo/B7w=="],
+ "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.3.11", "", { "os": "darwin", "cpu": "arm64" }, "sha512-/uXXkBcPKVQY7rc9Ys2CrlirBJYbpESEDme7RKiBD6MmqR2w3j0+ZZXRIL2xiaNPsIMMNhP1YnA+jRRxoOAFrA=="],
- "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.3.10", "", { "os": "darwin", "cpu": "x64" }, "sha512-Vae7+V6t/Avr8tVbFNjnFSTKZogZHFYl7MMH62P/J1kZtr0tyRQ9Fe0onjqjS2Ek9lmNLmZc/VR5uSekh+p1fg=="],
+ "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.3.11", "", { "os": "darwin", "cpu": "x64" }, "sha512-fh7nnvbweDPm2xEmFjfmq7zSUiox88plgdHF9OIW4i99WnXrAC3o2P3ag9judoUMv8FCSUnlwJCM1B64nO5Fbg=="],
- "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.3.10", "", { "os": "linux", "cpu": "arm64" }, "sha512-hhPw2V3/EpHKsileVOFynuWiKRgFEV48cLe0eA+G2wO4SzlwEhLEB9LhlSrVeu2mtSn205W283LkX7Fh48CaxA=="],
+ "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.3.11", "", { "os": "linux", "cpu": "arm64" }, "sha512-l4xkGa9E7Uc0/05qU2lMYfN1H+fzzkHgaJoy98wO+b/7Gl78srbCRRgwYSW+BTLixTBrM6Ede5NSBwt7rd/i6g=="],
- "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.3.10", "", { "os": "linux", "cpu": "arm64" }, "sha512-B9DszIHkuKtOH2IFeeVkQmSMVUjss9KtHaNXquYYWCjH8IstNgXgx5B0aSBQNr6mn4RcKKRQZXn9Zu1rM3O0/A=="],
+ "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.3.11", "", { "os": "linux", "cpu": "arm64" }, "sha512-XPSQ+XIPZMLaZ6zveQdwNjbX+QdROEd1zPgMwD47zvHV+tCGB88VH+aynyGxAHdzL+Tm/+DtKST5SECs4iwCLg=="],
- "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.3.10", "", { "os": "linux", "cpu": "x64" }, "sha512-wwAkWD1MR95u+J4LkWP74/vGz+tRrIQvr8kfMMJY8KOQ8+HMVleREOcPYsQX82S7uueco60L58Wc6M1I9WA9Dw=="],
+ "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-/1s9V/H3cSe0r0Mv/Z8JryF5x9ywRxywomqZVLHAoa/uN0eY7F8gEngWKNS5vbbN/BsfpCG5yeBT5ENh50Frxg=="],
- "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.3.10", "", { "os": "linux", "cpu": "x64" }, "sha512-QTfHZQh62SDFdYc2nfmZFuTm5yYb4eO1zwfB+90YxUumRCR171tS1GoTX5OD0wrv4UsziMPmrePMtkTnNyYG3g=="],
+ "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-vU7a8wLs5C9yJ4CB8a44r12aXYb8yYgBn+WeyzbMjaCMklzCv1oXr8x+VEyWodgJt9bDmhiaW/I0RHbn7rsNmw=="],
- "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.3.10", "", { "os": "win32", "cpu": "arm64" }, "sha512-o7lYc9n+CfRbHvkjPhm8s9FgbKdYZu5HCcGVMItLjz93EhgJ8AM44W+QckDqLA9MKDNFrR8nPbO4b73VC5kGGQ=="],
+ "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.3.11", "", { "os": "win32", "cpu": "arm64" }, "sha512-PZQ6ElCOnkYapSsysiTy0+fYX+agXPlWugh6+eQ6uPKI3vKAqNp6TnMhoM3oY2NltSB89hz59o8xIfOdyhi9Iw=="],
- "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.3.10", "", { "os": "win32", "cpu": "x64" }, "sha512-pHEFgq7dUEsKnqG9mx9bXihxGI49X+ar+UBrEIj3Wqj3UCZp1rNgV+OoyjFgcXsjCWpuEAF4VJdkZr3TrWdCbQ=="],
+ "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.3.11", "", { "os": "win32", "cpu": "x64" }, "sha512-43VrG813EW+b5+YbDbz31uUsheX+qFKCpXeY9kfdAx+ww3naKxeVkTD9zLIWxUPfJquANMHrmW3wbe/037G0Qg=="],
"@borewit/text-codec": ["@borewit/text-codec@0.1.1", "", {}, "sha512-5L/uBxmjaCIX5h8Z+uu+kA9BQLkc/Wl06UGR5ajNRxu+/XjonB5i8JpgFMrPj3LXTCPA0pv8yxUvbUi+QthGGA=="],
- "@capsizecss/unpack": ["@capsizecss/unpack@3.0.1", "", { "dependencies": { "fontkit": "^2.0.2" } }, "sha512-8XqW8xGn++Eqqbz3e9wKuK7mxryeRjs4LOHLxbh2lwKeSbuNR4NFifDZT4KzvjU6HMOPbiNTsWpniK5EJfTWkg=="],
+ "@capsizecss/unpack": ["@capsizecss/unpack@4.0.0", "", { "dependencies": { "fontkitten": "^1.0.0" } }, "sha512-VERIM64vtTP1C4mxQ5thVT9fK0apjPFobqybMtA1UdUujWka24ERHbRHFGmpbbhp73MhV+KSsHQH9C6uOTdEQA=="],
"@changesets/apply-release-plan": ["@changesets/apply-release-plan@7.0.14", "", { "dependencies": { "@changesets/config": "^3.1.2", "@changesets/get-version-range-type": "^0.4.0", "@changesets/git": "^3.0.4", "@changesets/should-skip-package": "^0.1.2", "@changesets/types": "^6.1.0", "@manypkg/get-packages": "^1.1.3", "detect-indent": "^6.0.0", "fs-extra": "^7.0.1", "lodash.startcase": "^4.4.0", "outdent": "^0.5.0", "prettier": "^2.7.1", "resolve-from": "^5.0.0", "semver": "^7.5.3" } }, "sha512-ddBvf9PHdy2YY0OUiEl3TV78mH9sckndJR14QAt87KLEbIov81XO0q0QAmvooBxXlqRRP8I9B7XOzZwQG7JkWA=="],
@@ -221,7 +221,7 @@
"@ctrl/tinycolor": ["@ctrl/tinycolor@4.2.0", "", {}, "sha512-kzyuwOAQnXJNLS9PSyrk0CWk35nWJW/zl/6KvnTBMFK65gm7U1/Z5BqjxeapjZCIhQcM/DsrEmcbRwDyXyXK4A=="],
- "@elysiajs/cors": ["@elysiajs/cors@1.4.0", "", { "peerDependencies": { "elysia": ">= 1.4.0" } }, "sha512-pb0SCzBfFbFSYA/U40HHO7R+YrcXBJXOWgL20eSViK33ol1e20ru2/KUaZYo5IMUn63yaTJI/bQERuQ+77ND8g=="],
+ "@elysiajs/cors": ["@elysiajs/cors@1.4.1", "", { "peerDependencies": { "elysia": ">= 1.4.0" } }, "sha512-lQfad+F3r4mNwsxRKbXyJB8Jg43oAOXjRwn7sKUL6bcOW3KjUqUimTS+woNpO97efpzjtDE0tEjGk9DTw8lqTQ=="],
"@elysiajs/swagger": ["@elysiajs/swagger@1.3.1", "", { "dependencies": { "@scalar/themes": "^0.9.52", "@scalar/types": "^0.0.12", "openapi-types": "^12.1.3", "pathe": "^1.1.2" }, "peerDependencies": { "elysia": ">= 1.3.0" } }, "sha512-LcbLHa0zE6FJKWPWKsIC/f+62wbDv3aXydqcNPVPyqNcaUgwvCajIi+5kHEU6GO3oXUCpzKaMsb3gsjt8sLzFQ=="],
@@ -293,6 +293,8 @@
"@esbuild/win32-x64": ["@esbuild/win32-x64@0.25.12", "", { "os": "win32", "cpu": "x64" }, "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA=="],
+ "@exodus/bytes": ["@exodus/bytes@1.8.0", "", { "peerDependencies": { "@exodus/crypto": "^1.0.0-rc.4" }, "optionalPeers": ["@exodus/crypto"] }, "sha512-8JPn18Bcp8Uo1T82gR8lh2guEOa5KKU/IEKvvdp0sgmi7coPBWf1Doi1EXsGZb2ehc8ym/StJCjffYV+ne7sXQ=="],
+
"@expressive-code/core": ["@expressive-code/core@0.41.4", "", { "dependencies": { "@ctrl/tinycolor": "^4.0.4", "hast-util-select": "^6.0.2", "hast-util-to-html": "^9.0.1", "hast-util-to-text": "^4.0.1", "hastscript": "^9.0.0", "postcss": "^8.4.38", "postcss-nested": "^6.0.1", "unist-util-visit": "^5.0.0", "unist-util-visit-parents": "^6.0.1" } }, "sha512-4eDiyq3hI3vJ0KnwIqonh9evy9p8aNixsf5wwnvDWcoPfYU3LGB6Nkb6WDdYS4z52tODCvN5gMRy1DtRopcxXg=="],
"@expressive-code/plugin-frames": ["@expressive-code/plugin-frames@0.41.4", "", { "dependencies": { "@expressive-code/core": "^0.41.4" } }, "sha512-W9jZW8LsPS8fW5T5CQyXUyyCrMxb7qfl6oxlLZB1rW74qM572Id4CWEXOM/7fFDcd1pW2fUxMoGzJMh0T2Awhg=="],
@@ -443,17 +445,17 @@
"@scalar/types": ["@scalar/types@0.0.12", "", { "dependencies": { "@scalar/openapi-types": "0.1.1", "@unhead/schema": "^1.9.5" } }, "sha512-XYZ36lSEx87i4gDqopQlGCOkdIITHHEvgkuJFrXFATQs9zHARop0PN0g4RZYWj+ZpCUclOcaOjbCt8JGe22mnQ=="],
- "@shikijs/core": ["@shikijs/core@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4", "hast-util-to-html": "^9.0.5" } }, "sha512-L7SrRibU7ZoYi1/TrZsJOFAnnHyLTE1SwHG1yNWjZIVCqjOEmCSuK2ZO9thnRbJG6TOkPp+Z963JmpCNw5nzvA=="],
+ "@shikijs/core": ["@shikijs/core@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4", "hast-util-to-html": "^9.0.5" } }, "sha512-AXSQu/2n1UIQekY8euBJlvFYZIw0PHY63jUzGbrOma4wPxzznJXTXkri+QcHeBNaFxiiOljKxxJkVSoB3PjbyA=="],
- "@shikijs/engine-javascript": ["@shikijs/engine-javascript@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "oniguruma-to-es": "^4.3.4" } }, "sha512-ZfWJNm2VMhKkQIKT9qXbs76RRcT0SF/CAvEz0+RkpUDAoDaCx0uFdCGzSRiD9gSlhm6AHkjdieOBJMaO2eC1rQ=="],
+ "@shikijs/engine-javascript": ["@shikijs/engine-javascript@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2", "oniguruma-to-es": "^4.3.4" } }, "sha512-ATwv86xlbmfD9n9gKRiwuPpWgPENAWCLwYCGz9ugTJlsO2kOzhOkvoyV/UD+tJ0uT7YRyD530x6ugNSffmvIiQ=="],
- "@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-1hRxtYIJfJSZeM5ivbUXv9hcJP3PWRo5prG/V2sWwiubUKTa+7P62d2qxCW8jiVFX4pgRHhnHNp+qeR7Xl+6kg=="],
+ "@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-OYknTCct6qiwpQDqDdf3iedRdzj6hFlOPv5hMvI+hkWfCKs5mlJ4TXziBG9nyabLwGulrUjHiCq3xCspSzErYQ=="],
- "@shikijs/langs": ["@shikijs/langs@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0" } }, "sha512-dBMFzzg1QiXqCVQ5ONc0z2ebyoi5BKz+MtfByLm0o5/nbUu3Iz8uaTCa5uzGiscQKm7lVShfZHU1+OG3t5hgwg=="],
+ "@shikijs/langs": ["@shikijs/langs@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0" } }, "sha512-g6mn5m+Y6GBJ4wxmBYqalK9Sp0CFkUqfNzUy2pJglUginz6ZpWbaWjDB4fbQ/8SHzFjYbtU6Ddlp1pc+PPNDVA=="],
- "@shikijs/themes": ["@shikijs/themes@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0" } }, "sha512-H36qw+oh91Y0s6OlFfdSuQ0Ld+5CgB/VE6gNPK+Hk4VRbVG/XQgkjnt4KzfnnoO6tZPtKJKHPjwebOCfjd6F8A=="],
+ "@shikijs/themes": ["@shikijs/themes@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0" } }, "sha512-BAE4cr9EDiZyYzwIHEk7JTBJ9CzlPuM4PchfcA5ao1dWXb25nv6hYsoDiBq2aZK9E3dlt3WB78uI96UESD+8Mw=="],
- "@shikijs/types": ["@shikijs/types@3.19.0", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-Z2hdeEQlzuntf/BZpFG8a+Fsw9UVXdML7w0o3TgSXV3yNESGon+bs9ITkQb3Ki7zxoXOOu5oJWqZ2uto06V9iQ=="],
+ "@shikijs/types": ["@shikijs/types@3.21.0", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-zGrWOxZ0/+0ovPY7PvBU2gIS9tmhSUUt30jAcNV0Bq0gb2S98gwfjIs1vxlmH5zM7/4YxLamT6ChlqqAJmPPjA=="],
"@shikijs/vscode-textmate": ["@shikijs/vscode-textmate@10.0.2", "", {}, "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg=="],
@@ -481,8 +483,6 @@
"@snake-evolution/web": ["@snake-evolution/web@workspace:apps/web"],
- "@swc/helpers": ["@swc/helpers@0.5.17", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-5IKx/Y13RsYd+sauPb2x+U/xZikHjolzfuDgTAl/Tdf3Q8rslRvC19NKDLgAJQ6wsqADk10ntlv08nPFw/gO/A=="],
-
"@tailwindcss/node": ["@tailwindcss/node@4.1.18", "", { "dependencies": { "@jridgewell/remapping": "^2.3.4", "enhanced-resolve": "^5.18.3", "jiti": "^2.6.1", "lightningcss": "1.30.2", "magic-string": "^0.30.21", "source-map-js": "^1.2.1", "tailwindcss": "4.1.18" } }, "sha512-DoR7U1P7iYhw16qJ49fgXUlry1t4CpXeErJHnQ44JgTSKMaZUdf17cfn5mHchfJ4KRBZRFA/Coo+MUF5+gOaCQ=="],
"@tailwindcss/oxide": ["@tailwindcss/oxide@4.1.18", "", { "optionalDependencies": { "@tailwindcss/oxide-android-arm64": "4.1.18", "@tailwindcss/oxide-darwin-arm64": "4.1.18", "@tailwindcss/oxide-darwin-x64": "4.1.18", "@tailwindcss/oxide-freebsd-x64": "4.1.18", "@tailwindcss/oxide-linux-arm-gnueabihf": "4.1.18", "@tailwindcss/oxide-linux-arm64-gnu": "4.1.18", "@tailwindcss/oxide-linux-arm64-musl": "4.1.18", "@tailwindcss/oxide-linux-x64-gnu": "4.1.18", "@tailwindcss/oxide-linux-x64-musl": "4.1.18", "@tailwindcss/oxide-wasm32-wasi": "4.1.18", "@tailwindcss/oxide-win32-arm64-msvc": "4.1.18", "@tailwindcss/oxide-win32-x64-msvc": "4.1.18" } }, "sha512-EgCR5tTS5bUSKQgzeMClT6iCY3ToqE1y+ZB0AKldj809QXk1Y+3jB0upOYZrn9aGIzPtUsP7sX4QQ4XtjBB95A=="],
@@ -527,8 +527,6 @@
"@types/estree-jsx": ["@types/estree-jsx@1.0.5", "", { "dependencies": { "@types/estree": "*" } }, "sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg=="],
- "@types/fontkit": ["@types/fontkit@2.0.8", "", { "dependencies": { "@types/node": "*" } }, "sha512-wN+8bYxIpJf+5oZdrdtaX04qUuWHcKxcDEgRS9Qm9ZClSHjzEn13SxUC+5eRM+4yXIeTYk8mTzLAWGF64847ew=="],
-
"@types/hast": ["@types/hast@3.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ=="],
"@types/js-yaml": ["@types/js-yaml@4.0.9", "", {}, "sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg=="],
@@ -543,9 +541,9 @@
"@types/nlcst": ["@types/nlcst@2.0.3", "", { "dependencies": { "@types/unist": "*" } }, "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA=="],
- "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+ "@types/node": ["@types/node@25.0.6", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-NNu0sjyNxpoiW3YuVFfNz7mxSQ+S4X2G28uqg2s+CzoqoQjLPsWSbsFFyztIAqt2vb8kfEAsJNepMGPTxFDx3Q=="],
- "@types/react": ["@types/react@19.2.7", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg=="],
+ "@types/react": ["@types/react@19.2.8", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-3MbSL37jEchWZz2p2mjntRZtPt837ij10ApxKfgmXCTuHWagYg7iA5bqPw6C8BMPfwidlvfPI/fxOc42HLhcyg=="],
"@types/sax": ["@types/sax@1.2.7", "", { "dependencies": { "@types/node": "*" } }, "sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A=="],
@@ -605,7 +603,7 @@
"astring": ["astring@1.9.0", "", { "bin": { "astring": "bin/astring" } }, "sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg=="],
- "astro": ["astro@5.16.6", "", { "dependencies": { "@astrojs/compiler": "^2.13.0", "@astrojs/internal-helpers": "0.7.5", "@astrojs/markdown-remark": "6.3.10", "@astrojs/telemetry": "3.3.0", "@capsizecss/unpack": "^3.0.1", "@oslojs/encoding": "^1.1.0", "@rollup/pluginutils": "^5.3.0", "acorn": "^8.15.0", "aria-query": "^5.3.2", "axobject-query": "^4.1.0", "boxen": "8.0.1", "ci-info": "^4.3.1", "clsx": "^2.1.1", "common-ancestor-path": "^1.0.1", "cookie": "^1.0.2", "cssesc": "^3.0.0", "debug": "^4.4.3", "deterministic-object-hash": "^2.0.2", "devalue": "^5.5.0", "diff": "^5.2.0", "dlv": "^1.1.3", "dset": "^3.1.4", "es-module-lexer": "^1.7.0", "esbuild": "^0.25.0", "estree-walker": "^3.0.3", "flattie": "^1.1.1", "fontace": "~0.3.1", "github-slugger": "^2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "^4.2.0", "import-meta-resolve": "^4.2.0", "js-yaml": "^4.1.1", "magic-string": "^0.30.21", "magicast": "^0.5.1", "mrmime": "^2.0.1", "neotraverse": "^0.6.18", "p-limit": "^6.2.0", "p-queue": "^8.1.1", "package-manager-detector": "^1.5.0", "piccolore": "^0.1.3", "picomatch": "^4.0.3", "prompts": "^2.4.2", "rehype": "^13.0.2", "semver": "^7.7.3", "shiki": "^3.15.0", "smol-toml": "^1.5.2", "svgo": "^4.0.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tsconfck": "^3.1.6", "ultrahtml": "^1.6.0", "unifont": "~0.6.0", "unist-util-visit": "^5.0.0", "unstorage": "^1.17.3", "vfile": "^6.0.3", "vite": "^6.4.1", "vitefu": "^1.1.1", "xxhash-wasm": "^1.1.0", "yargs-parser": "^21.1.1", "yocto-spinner": "^0.2.3", "zod": "^3.25.76", "zod-to-json-schema": "^3.25.0", "zod-to-ts": "^1.2.0" }, "optionalDependencies": { "sharp": "^0.34.0" }, "bin": { "astro": "astro.js" } }, "sha512-6mF/YrvwwRxLTu+aMEa5pwzKUNl5ZetWbTyZCs9Um0F12HUmxUiF5UHiZPy4rifzU3gtpM3xP2DfdmkNX9eZRg=="],
+ "astro": ["astro@5.16.8", "", { "dependencies": { "@astrojs/compiler": "^2.13.0", "@astrojs/internal-helpers": "0.7.5", "@astrojs/markdown-remark": "6.3.10", "@astrojs/telemetry": "3.3.0", "@capsizecss/unpack": "^4.0.0", "@oslojs/encoding": "^1.1.0", "@rollup/pluginutils": "^5.3.0", "acorn": "^8.15.0", "aria-query": "^5.3.2", "axobject-query": "^4.1.0", "boxen": "8.0.1", "ci-info": "^4.3.1", "clsx": "^2.1.1", "common-ancestor-path": "^1.0.1", "cookie": "^1.1.1", "cssesc": "^3.0.0", "debug": "^4.4.3", "deterministic-object-hash": "^2.0.2", "devalue": "^5.6.1", "diff": "^5.2.0", "dlv": "^1.1.3", "dset": "^3.1.4", "es-module-lexer": "^1.7.0", "esbuild": "^0.25.0", "estree-walker": "^3.0.3", "flattie": "^1.1.1", "fontace": "~0.4.0", "github-slugger": "^2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "^4.2.0", "import-meta-resolve": "^4.2.0", "js-yaml": "^4.1.1", "magic-string": "^0.30.21", "magicast": "^0.5.1", "mrmime": "^2.0.1", "neotraverse": "^0.6.18", "p-limit": "^6.2.0", "p-queue": "^8.1.1", "package-manager-detector": "^1.6.0", "piccolore": "^0.1.3", "picomatch": "^4.0.3", "prompts": "^2.4.2", "rehype": "^13.0.2", "semver": "^7.7.3", "shiki": "^3.20.0", "smol-toml": "^1.6.0", "svgo": "^4.0.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tsconfck": "^3.1.6", "ultrahtml": "^1.6.0", "unifont": "~0.7.1", "unist-util-visit": "^5.0.0", "unstorage": "^1.17.3", "vfile": "^6.0.3", "vite": "^6.4.1", "vitefu": "^1.1.1", "xxhash-wasm": "^1.1.0", "yargs-parser": "^21.1.1", "yocto-spinner": "^0.2.3", "zod": "^3.25.76", "zod-to-json-schema": "^3.25.1", "zod-to-ts": "^1.2.0" }, "optionalDependencies": { "sharp": "^0.34.0" }, "bin": { "astro": "astro.js" } }, "sha512-gzZE+epuCrNuxOa8/F1dzkllDOFvxWhGeobQKeBRIAef5sUpUKMHZo/8clse+02rYnKJCgwXBgjW4uTu9mqUUw=="],
"astro-expressive-code": ["astro-expressive-code@0.41.4", "", { "dependencies": { "rehype-expressive-code": "^0.41.4" }, "peerDependencies": { "astro": "^4.0.0-beta || ^5.0.0-beta || ^3.3.0" } }, "sha512-LK6EcK/hIHfOSo9zqapzu4CbTC0YBtMOVdvWjInpB2SgYtxiF22aZDqdpejN8J28mWPqPLQwSqdl2lWuirNXmw=="],
@@ -615,8 +613,6 @@
"base-64": ["base-64@1.0.0", "", {}, "sha512-kwDPIFCGx0NZHog36dj+tHiwP4QMzsZ3AgMViUBKI0+V5n4U0ufTCUMhnQ04diaRI8EX/QcPfql7zlhZ7j4zgg=="],
- "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
-
"bcp-47": ["bcp-47@2.1.0", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-9IIS3UPrvIa1Ej+lVDdDwO7zLehjqsaByECw0bu2RRGP73jALm6FYbzI5gWbgHLvNdkvfXB5YrSbocZdOS0c0w=="],
"bcp-47-match": ["bcp-47-match@2.0.3", "", {}, "sha512-JtTezzbAibu8G0R9op9zb3vcWZd9JF6M0xOYGPn0fNCd7wOpRB1mU2mH9T8gaBGbAAyIIVgB2G7xG0GP98zMAQ=="],
@@ -631,8 +627,6 @@
"braces": ["braces@3.0.3", "", { "dependencies": { "fill-range": "^7.1.1" } }, "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA=="],
- "brotli": ["brotli@1.3.3", "", { "dependencies": { "base64-js": "^1.1.2" } }, "sha512-oTKjJdShmDuGW94SyyaoQvAjf30dZaHnjJ8uAF+u2/vGJkJbJPJAT1gDiOJP5v1Zb6f9KEyW/1HpuaWIXtGHPg=="],
-
"bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
"camelcase": ["camelcase@8.0.0", "", {}, "sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA=="],
@@ -659,8 +653,6 @@
"cliui": ["cliui@8.0.1", "", { "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.1", "wrap-ansi": "^7.0.0" } }, "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ=="],
- "clone": ["clone@2.1.2", "", {}, "sha512-3Pe/CF1Nn94hyhIYpjtiLhdCoEoz0DqQ+988E9gmeEdQZlojxnOb74wctFyuwWQHzqyf9X7C7MG8juUpqBJT8w=="],
-
"clsx": ["clsx@2.1.1", "", {}, "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA=="],
"collapse-white-space": ["collapse-white-space@2.1.0", "", {}, "sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw=="],
@@ -723,8 +715,6 @@
"devlop": ["devlop@1.1.0", "", { "dependencies": { "dequal": "^2.0.0" } }, "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA=="],
- "dfa": ["dfa@1.2.0", "", {}, "sha512-ED3jP8saaweFTjeGX8HQPjeC1YYyZs98jGNZx6IiBvxW7JG5v492kamAQB3m2wop07CvU/RQmzcKr6bgcC5D/Q=="],
-
"diff": ["diff@5.2.0", "", {}, "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A=="],
"dir-glob": ["dir-glob@3.0.1", "", { "dependencies": { "path-type": "^4.0.0" } }, "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA=="],
@@ -745,7 +735,7 @@
"dset": ["dset@3.1.4", "", {}, "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA=="],
- "elysia": ["elysia@1.4.19", "", { "dependencies": { "cookie": "^1.1.1", "exact-mirror": "0.2.5", "fast-decode-uri-component": "^1.0.1", "memoirist": "^0.4.0" }, "peerDependencies": { "@sinclair/typebox": ">= 0.34.0 < 1", "@types/bun": ">= 1.2.0", "file-type": ">= 20.0.0", "openapi-types": ">= 12.0.0", "typescript": ">= 5.0.0" }, "optionalPeers": ["@types/bun", "typescript"] }, "sha512-DZb9y8FnWyX5IuqY44SvqAV0DjJ15NeCWHrLdgXrKgTPDPsl3VNwWHqrEr9bmnOCpg1vh6QUvAX/tcxNj88jLA=="],
+ "elysia": ["elysia@1.4.21", "", { "dependencies": { "cookie": "^1.1.1", "exact-mirror": "^0.2.6", "fast-decode-uri-component": "^1.0.1", "memoirist": "^0.4.0" }, "peerDependencies": { "@sinclair/typebox": ">= 0.34.0 < 1", "@types/bun": ">= 1.2.0", "file-type": ">= 20.0.0", "openapi-types": ">= 12.0.0", "typescript": ">= 5.0.0" }, "optionalPeers": ["@types/bun", "typescript"] }, "sha512-bGSbPSGnkWbO0qUDKS5Q+6iEewBdMmIiJ8F0li4djZ6WjpixUQouOzePYscG1Lemdv6pZpFi1YPfI/kjeq2voA=="],
"emmet": ["emmet@2.4.11", "", { "dependencies": { "@emmetio/abbreviation": "^2.3.3", "@emmetio/css-abbreviation": "^2.1.8" } }, "sha512-23QPJB3moh/U9sT4rQzGgeyyGIrcM+GH5uVYg2C6wZIxAIJq7Ng3QLT79tl8FUwDXhyq9SusfknOrofAKqvgyQ=="],
@@ -787,7 +777,7 @@
"eventemitter3": ["eventemitter3@5.0.1", "", {}, "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA=="],
- "exact-mirror": ["exact-mirror@0.2.5", "", { "peerDependencies": { "@sinclair/typebox": "^0.34.15" }, "optionalPeers": ["@sinclair/typebox"] }, "sha512-u8Wu2lO8nio5lKSJubOydsdNtQmH8ENba5m0nbQYmTvsjksXKYIS1nSShdDlO8Uem+kbo+N6eD5I03cpZ+QsRQ=="],
+ "exact-mirror": ["exact-mirror@0.2.6", "", { "peerDependencies": { "@sinclair/typebox": "^0.34.15" }, "optionalPeers": ["@sinclair/typebox"] }, "sha512-7s059UIx9/tnOKSySzUk5cPGkoILhTE4p6ncf6uIPaQ+9aRBQzQjc9+q85l51+oZ+P6aBxh084pD0CzBQPcFUA=="],
"expressive-code": ["expressive-code@0.41.4", "", { "dependencies": { "@expressive-code/core": "^0.41.4", "@expressive-code/plugin-frames": "^0.41.4", "@expressive-code/plugin-shiki": "^0.41.4", "@expressive-code/plugin-text-markers": "^0.41.4" } }, "sha512-A9aFLhgqLkL6VSfqYkPqkJVMtA90/bhCLmUO7L3/a1xWISNMcHoCS6d6i8ePwi8HvHr3xRLswHTNt6NheTjdXA=="],
@@ -815,9 +805,9 @@
"flattie": ["flattie@1.1.1", "", {}, "sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ=="],
- "fontace": ["fontace@0.3.1", "", { "dependencies": { "@types/fontkit": "^2.0.8", "fontkit": "^2.0.4" } }, "sha512-9f5g4feWT1jWT8+SbL85aLIRLIXUaDygaM2xPXRmzPYxrOMNok79Lr3FGJoKVNKibE0WCunNiEVG2mwuE+2qEg=="],
+ "fontace": ["fontace@0.4.0", "", { "dependencies": { "fontkitten": "^1.0.0" } }, "sha512-moThBCItUe2bjZip5PF/iZClpKHGLwMvR79Kp8XpGRBrvoRSnySN4VcILdv3/MJzbhvUA5WeiUXF5o538m5fvg=="],
- "fontkit": ["fontkit@2.0.4", "", { "dependencies": { "@swc/helpers": "^0.5.12", "brotli": "^1.3.2", "clone": "^2.1.2", "dfa": "^1.2.0", "fast-deep-equal": "^3.1.3", "restructure": "^3.0.0", "tiny-inflate": "^1.0.3", "unicode-properties": "^1.4.0", "unicode-trie": "^2.0.0" } }, "sha512-syetQadaUEDNdxdugga9CpEYVaQIxOwk7GlwZWWZ19//qW4zE5bknOKeMBDYAASwnpaSHKJITRLMF9m1fp3s6g=="],
+ "fontkitten": ["fontkitten@1.0.0", "", { "dependencies": { "tiny-inflate": "^1.0.3" } }, "sha512-b0RdzQeztiiUFWEDzq6Ka26qkNVNLCehoRtifOIGNbQ4CfxyYRh73fyWaQX/JshPVcueITOEeoSWPy5XQv8FUg=="],
"fs-extra": ["fs-extra@7.0.1", "", { "dependencies": { "graceful-fs": "^4.1.2", "jsonfile": "^4.0.0", "universalify": "^0.1.0" } }, "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw=="],
@@ -879,7 +869,7 @@
"hookable": ["hookable@5.5.3", "", {}, "sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ=="],
- "html-encoding-sniffer": ["html-encoding-sniffer@4.0.0", "", { "dependencies": { "whatwg-encoding": "^3.1.1" } }, "sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ=="],
+ "html-encoding-sniffer": ["html-encoding-sniffer@6.0.0", "", { "dependencies": { "@exodus/bytes": "^1.6.0" } }, "sha512-CV9TW3Y3f8/wT0BRFc1/KAVQ3TUHiXmaAb6VW9vtiMFf7SLoMd1PdAc4W3KFOFETBJUb90KatHqlsZMWV+R9Gg=="],
"html-escaper": ["html-escaper@3.0.3", "", {}, "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ=="],
@@ -941,13 +931,13 @@
"isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
- "isomorphic-dompurify": ["isomorphic-dompurify@2.34.0", "", { "dependencies": { "dompurify": "^3.3.1", "jsdom": "^27.3.0" } }, "sha512-7VeB/tDBQ8jt1+syT563hmmejY01nuwizpUIFPfM1aw3iTgLLiVP4/Nh+PKhNoa1V/H+E6ZlNcowsXLbChPCpw=="],
+ "isomorphic-dompurify": ["isomorphic-dompurify@2.35.0", "", { "dependencies": { "dompurify": "^3.3.1", "jsdom": "^27.4.0" } }, "sha512-a9+LQqylQCU8f1zmsYmg2tfrbdY2YS/Hc+xntcq/mDI2MY3Q108nq8K23BWDIg6YGC5JsUMC15fj2ZMqCzt/+A=="],
"jiti": ["jiti@2.6.1", "", { "bin": { "jiti": "lib/jiti-cli.mjs" } }, "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ=="],
"js-yaml": ["js-yaml@4.1.1", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA=="],
- "jsdom": ["jsdom@27.3.0", "", { "dependencies": { "@acemir/cssom": "^0.9.28", "@asamuzakjp/dom-selector": "^6.7.6", "cssstyle": "^5.3.4", "data-urls": "^6.0.0", "decimal.js": "^10.6.0", "html-encoding-sniffer": "^4.0.0", "http-proxy-agent": "^7.0.2", "https-proxy-agent": "^7.0.6", "is-potential-custom-element-name": "^1.0.1", "parse5": "^8.0.0", "saxes": "^6.0.0", "symbol-tree": "^3.2.4", "tough-cookie": "^6.0.0", "w3c-xmlserializer": "^5.0.0", "webidl-conversions": "^8.0.0", "whatwg-encoding": "^3.1.1", "whatwg-mimetype": "^4.0.0", "whatwg-url": "^15.1.0", "ws": "^8.18.3", "xml-name-validator": "^5.0.0" }, "peerDependencies": { "canvas": "^3.0.0" }, "optionalPeers": ["canvas"] }, "sha512-GtldT42B8+jefDUC4yUKAvsaOrH7PDHmZxZXNgF2xMmymjUbRYJvpAybZAKEmXDGTM0mCsz8duOa4vTm5AY2Kg=="],
+ "jsdom": ["jsdom@27.4.0", "", { "dependencies": { "@acemir/cssom": "^0.9.28", "@asamuzakjp/dom-selector": "^6.7.6", "@exodus/bytes": "^1.6.0", "cssstyle": "^5.3.4", "data-urls": "^6.0.0", "decimal.js": "^10.6.0", "html-encoding-sniffer": "^6.0.0", "http-proxy-agent": "^7.0.2", "https-proxy-agent": "^7.0.6", "is-potential-custom-element-name": "^1.0.1", "parse5": "^8.0.0", "saxes": "^6.0.0", "symbol-tree": "^3.2.4", "tough-cookie": "^6.0.0", "w3c-xmlserializer": "^5.0.0", "webidl-conversions": "^8.0.0", "whatwg-mimetype": "^4.0.0", "whatwg-url": "^15.1.0", "ws": "^8.18.3", "xml-name-validator": "^5.0.0" }, "peerDependencies": { "canvas": "^3.0.0" }, "optionalPeers": ["canvas"] }, "sha512-mjzqwWRD9Y1J1KUi7W97Gja1bwOOM5Ug0EZ6UDK3xS7j7mndrkwozHtSblfomlzyB4NepioNt+B2sOSzczVgtQ=="],
"json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
@@ -1185,8 +1175,6 @@
"pagefind": ["pagefind@1.4.0", "", { "optionalDependencies": { "@pagefind/darwin-arm64": "1.4.0", "@pagefind/darwin-x64": "1.4.0", "@pagefind/freebsd-x64": "1.4.0", "@pagefind/linux-arm64": "1.4.0", "@pagefind/linux-x64": "1.4.0", "@pagefind/windows-x64": "1.4.0" }, "bin": { "pagefind": "lib/runner/bin.cjs" } }, "sha512-z2kY1mQlL4J8q5EIsQkLzQjilovKzfNVhX8De6oyE6uHpfFtyBaqUpcl/XzJC/4fjD8vBDyh1zolimIcVrCn9g=="],
- "pako": ["pako@0.2.9", "", {}, "sha512-NUcwaKxUxWrZLpDG+z/xZaCgQITkA/Dv4V/T6bw7VON6l1Xz/VnrBqrYjZQ12TamKHzITTfOEIYUj48y2KXImA=="],
-
"parse-entities": ["parse-entities@4.0.2", "", { "dependencies": { "@types/unist": "^2.0.0", "character-entities-legacy": "^3.0.0", "character-reference-invalid": "^2.0.0", "decode-named-character-reference": "^1.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0", "is-hexadecimal": "^2.0.0" } }, "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw=="],
"parse-latin": ["parse-latin@7.0.0", "", { "dependencies": { "@types/nlcst": "^2.0.0", "@types/unist": "^3.0.0", "nlcst-to-string": "^4.0.0", "unist-util-modify-children": "^4.0.0", "unist-util-visit-children": "^3.0.0", "vfile": "^6.0.0" } }, "sha512-mhHgobPPua5kZ98EF4HWiH167JWBfl4pvAIXXdbaVohtK7a6YBOy56kvhCqduqyo/f3yrHFWmqmiMg/BkBkYYQ=="],
@@ -1291,8 +1279,6 @@
"resolve-from": ["resolve-from@5.0.0", "", {}, "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw=="],
- "restructure": ["restructure@3.0.2", "", {}, "sha512-gSfoiOEA0VPE6Tukkrr7I0RBdE0s7H1eFCDBk05l1KIQT1UIKNc5JZy6jdyW6eYH3aR3g5b3PuL77rq0hvwtAw=="],
-
"retext": ["retext@9.0.0", "", { "dependencies": { "@types/nlcst": "^2.0.0", "retext-latin": "^4.0.0", "retext-stringify": "^4.0.0", "unified": "^11.0.0" } }, "sha512-sbMDcpHCNjvlheSgMfEcVrZko3cDzdbe1x/e7G66dFp0Ff7Mldvi2uv6JkJQzdRcvLYE8CA8Oe8siQx8ZOgTcA=="],
"retext-latin": ["retext-latin@4.0.0", "", { "dependencies": { "@types/nlcst": "^2.0.0", "parse-latin": "^7.0.0", "unified": "^11.0.0" } }, "sha512-hv9woG7Fy0M9IlRQloq/N6atV82NxLGveq+3H2WOi79dtIYWN8OaxogDm77f8YnVXJL2VD3bbqowu5E3EMhBYA=="],
@@ -1321,7 +1307,7 @@
"shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
- "shiki": ["shiki@3.19.0", "", { "dependencies": { "@shikijs/core": "3.19.0", "@shikijs/engine-javascript": "3.19.0", "@shikijs/engine-oniguruma": "3.19.0", "@shikijs/langs": "3.19.0", "@shikijs/themes": "3.19.0", "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-77VJr3OR/VUZzPiStyRhADmO2jApMM0V2b1qf0RpfWya8Zr1PeZev5AEpPGAAKWdiYUtcZGBE4F5QvJml1PvWA=="],
+ "shiki": ["shiki@3.21.0", "", { "dependencies": { "@shikijs/core": "3.21.0", "@shikijs/engine-javascript": "3.21.0", "@shikijs/engine-oniguruma": "3.21.0", "@shikijs/langs": "3.21.0", "@shikijs/themes": "3.21.0", "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-N65B/3bqL/TI2crrXr+4UivctrAGEjmsib5rPMMPpFp1xAx/w03v8WZ9RDDFYteXoEgY7qZ4HGgl5KBIu1153w=="],
"signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
@@ -1331,7 +1317,7 @@
"slash": ["slash@5.1.0", "", {}, "sha512-ZA6oR3T/pEyuqwMgAKT0/hAv8oAXckzbkmR0UkUosQ+Mc4RxGoJkRmwHgHufaenlyAgE1Mxgpdcrf75y6XcnDg=="],
- "smol-toml": ["smol-toml@1.5.2", "", {}, "sha512-QlaZEqcAH3/RtNyet1IPIYPsEWAaYyXXv1Krsi+1L/QHppjX4Ifm8MQsBISz9vE8cHicIq3clogsheili5vhaQ=="],
+ "smol-toml": ["smol-toml@1.6.0", "", {}, "sha512-4zemZi0HvTnYwLfrpk/CF9LOd9Lt87kAt50GnqhMpyF9U3poDAP2+iukq2bZsO/ufegbYehBkqINbsWxj4l4cw=="],
"source-map": ["source-map@0.7.6", "", {}, "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ=="],
@@ -1395,19 +1381,19 @@
"tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
- "turbo": ["turbo@2.7.1", "", { "optionalDependencies": { "turbo-darwin-64": "2.7.1", "turbo-darwin-arm64": "2.7.1", "turbo-linux-64": "2.7.1", "turbo-linux-arm64": "2.7.1", "turbo-windows-64": "2.7.1", "turbo-windows-arm64": "2.7.1" }, "bin": { "turbo": "bin/turbo" } }, "sha512-zAj9jGc7VDvuAo/5Jbos4QTtWz9uUpkMhMKGyTjDJkx//hdL2bM31qQoJSAbU+7JyK5vb0LPzpwf6DUt3zayqg=="],
+ "turbo": ["turbo@2.7.3", "", { "optionalDependencies": { "turbo-darwin-64": "2.7.3", "turbo-darwin-arm64": "2.7.3", "turbo-linux-64": "2.7.3", "turbo-linux-arm64": "2.7.3", "turbo-windows-64": "2.7.3", "turbo-windows-arm64": "2.7.3" }, "bin": { "turbo": "bin/turbo" } }, "sha512-+HjKlP4OfYk+qzvWNETA3cUO5UuK6b5MSc2UJOKyvBceKucQoQGb2g7HlC2H1GHdkfKrk4YF1VPvROkhVZDDLQ=="],
- "turbo-darwin-64": ["turbo-darwin-64@2.7.1", "", { "os": "darwin", "cpu": "x64" }, "sha512-EaA7UfYujbY9/Ku0WqPpvfctxm91h9LF7zo8vjielz+omfAPB54Si+ADmUoBczBDC6RoLgbURC3GmUW2alnjJg=="],
+ "turbo-darwin-64": ["turbo-darwin-64@2.7.3", "", { "os": "darwin", "cpu": "x64" }, "sha512-aZHhvRiRHXbJw1EcEAq4aws1hsVVUZ9DPuSFaq9VVFAKCup7niIEwc22glxb7240yYEr1vLafdQ2U294Vcwz+w=="],
- "turbo-darwin-arm64": ["turbo-darwin-arm64@2.7.1", "", { "os": "darwin", "cpu": "arm64" }, "sha512-/pWGSygtBugd7sKQOeMm+jKY3qN1vyB0RiHBM6bN/6qUOo2VHo8IQwBTIaSgINN4Ue6fzEU+WfePNvonSU9yXw=="],
+ "turbo-darwin-arm64": ["turbo-darwin-arm64@2.7.3", "", { "os": "darwin", "cpu": "arm64" }, "sha512-CkVrHSq+Bnhl9sX2LQgqQYVfLTWC2gvI74C4758OmU0djfrssDKU9d4YQF0AYXXhIIRZipSXfxClQziIMD+EAg=="],
- "turbo-linux-64": ["turbo-linux-64@2.7.1", "", { "os": "linux", "cpu": "x64" }, "sha512-Y5H11mdhASw/dJuRFyGtTCDFX5/MPT73EKsVEiHbw5MkFc77lx3nMc5L/Q7bKEhef/vYJAsAb61QuHsB6qdP8Q=="],
+ "turbo-linux-64": ["turbo-linux-64@2.7.3", "", { "os": "linux", "cpu": "x64" }, "sha512-GqDsCNnzzr89kMaLGpRALyigUklzgxIrSy2pHZVXyifgczvYPnLglex78Aj3T2gu+T3trPPH2iJ+pWucVOCC2Q=="],
- "turbo-linux-arm64": ["turbo-linux-arm64@2.7.1", "", { "os": "linux", "cpu": "arm64" }, "sha512-L/r77jD7cqIEXoyu2LGBUrTY5GJSi/XcGLsQ2nZ/fefk6x3MpljTvwsXUVG1BUkiBPc4zaKRj6yGyWMo5MbLxQ=="],
+ "turbo-linux-arm64": ["turbo-linux-arm64@2.7.3", "", { "os": "linux", "cpu": "arm64" }, "sha512-NdCDTfIcIo3dWjsiaAHlxu5gW61Ed/8maah1IAF/9E3EtX0aAHNiBMbuYLZaR4vRJ7BeVkYB6xKWRtdFLZ0y3g=="],
- "turbo-windows-64": ["turbo-windows-64@2.7.1", "", { "os": "win32", "cpu": "x64" }, "sha512-rkeuviXZ/1F7lCare7TNKvYtT/SH9dZR55FAMrxrFRh88b+ZKwlXEBfq5/1OctEzRUo/VLIm+s5LJMOEy+QshA=="],
+ "turbo-windows-64": ["turbo-windows-64@2.7.3", "", { "os": "win32", "cpu": "x64" }, "sha512-7bVvO987daXGSJVYBoG8R4Q+csT1pKIgLJYZevXRQ0Hqw0Vv4mKme/TOjYXs9Qb1xMKh51Tb3bXKDbd8/4G08g=="],
- "turbo-windows-arm64": ["turbo-windows-arm64@2.7.1", "", { "os": "win32", "cpu": "arm64" }, "sha512-1rZk9htm3+iP/rWCf/h4/DFQey9sMs2TJPC4T5QQfwqAdMWsphgrxBuFqHdxczlbBCgbWNhVw0CH2bTxe1/GFg=="],
+ "turbo-windows-arm64": ["turbo-windows-arm64@2.7.3", "", { "os": "win32", "cpu": "arm64" }, "sha512-nTodweTbPmkvwMu/a55XvjMsPtuyUSC+sV7f/SR57K36rB2I0YG21qNETN+00LOTUW9B3omd8XkiXJkt4kx/cw=="],
"type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
@@ -1429,15 +1415,11 @@
"undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
- "unicode-properties": ["unicode-properties@1.4.1", "", { "dependencies": { "base64-js": "^1.3.0", "unicode-trie": "^2.0.0" } }, "sha512-CLjCCLQ6UuMxWnbIylkisbRj31qxHPAurvena/0iwSVbQ2G1VY5/HjV0IRabOEbDHlzZlRdCrD4NhB0JtU40Pg=="],
-
- "unicode-trie": ["unicode-trie@2.0.0", "", { "dependencies": { "pako": "^0.2.5", "tiny-inflate": "^1.0.0" } }, "sha512-x7bc76x0bm4prf1VLg79uhAzKw8DVboClSN5VxJuQ+LKDOVEW9CdH+VY7SP+vX7xCYQqzzgQpFqz15zeLvAtZQ=="],
-
"unicorn-magic": ["unicorn-magic@0.3.0", "", {}, "sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA=="],
"unified": ["unified@11.0.5", "", { "dependencies": { "@types/unist": "^3.0.0", "bail": "^2.0.0", "devlop": "^1.0.0", "extend": "^3.0.0", "is-plain-obj": "^4.0.0", "trough": "^2.0.0", "vfile": "^6.0.0" } }, "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA=="],
- "unifont": ["unifont@0.6.0", "", { "dependencies": { "css-tree": "^3.0.0", "ofetch": "^1.4.1", "ohash": "^2.0.0" } }, "sha512-5Fx50fFQMQL5aeHyWnZX9122sSLckcDvcfFiBf3QYeHa7a1MKJooUy52b67moi2MJYkrfo/TWY+CoLdr/w0tTA=="],
+ "unifont": ["unifont@0.7.1", "", { "dependencies": { "css-tree": "^3.1.0", "ofetch": "^1.5.1", "ohash": "^2.0.11" } }, "sha512-0lg9M1cMYvXof8//wZBq6EDEfbwv4++t7+dYpXeS2ypaLuZJmUFYEwTm412/1ED/Wfo/wyzSu6kNZEr9hgRNfg=="],
"unist-util-find-after": ["unist-util-find-after@5.0.0", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ=="],
@@ -1515,8 +1497,6 @@
"webidl-conversions": ["webidl-conversions@8.0.0", "", {}, "sha512-n4W4YFyz5JzOfQeA8oN7dUYpR+MBP3PIUsn2jLjWXwK5ASUzt0Jc/A5sAUZoCYFJRGF0FBKJ+1JjN43rNdsQzA=="],
- "whatwg-encoding": ["whatwg-encoding@3.1.1", "", { "dependencies": { "iconv-lite": "0.6.3" } }, "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ=="],
-
"whatwg-mimetype": ["whatwg-mimetype@4.0.0", "", {}, "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg=="],
"whatwg-url": ["whatwg-url@15.1.0", "", { "dependencies": { "tr46": "^6.0.0", "webidl-conversions": "^8.0.0" } }, "sha512-2ytDk0kiEj/yu90JOAp44PVPUkO9+jVhyf+SybKlRHSDlvOOZhdPIrr7xTH64l4WixO2cP+wQIcgujkGBPPz6g=="],
@@ -1557,7 +1537,7 @@
"zod": ["zod@3.25.76", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
- "zod-to-json-schema": ["zod-to-json-schema@3.25.0", "", { "peerDependencies": { "zod": "^3.25 || ^4" } }, "sha512-HvWtU2UG41LALjajJrML6uQejQhNJx+JBO9IflpSja4R03iNWfKXrj6W2h7ljuLyc1nKS+9yDyL/9tD1U/yBnQ=="],
+ "zod-to-json-schema": ["zod-to-json-schema@3.25.1", "", { "peerDependencies": { "zod": "^3.25 || ^4" } }, "sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA=="],
"zod-to-ts": ["zod-to-ts@1.2.0", "", { "peerDependencies": { "typescript": "^4.9.4 || ^5.0.2", "zod": "^3" } }, "sha512-x30XE43V+InwGpvTySRNz9kB7qFU8DlyEy7BsSTCHPH1R0QasMmHWZDCzYm6bVXtj/9NNJAZF3jW8rzFvH5OFA=="],
@@ -1569,8 +1549,14 @@
"@astrojs/language-server/prettier": ["prettier@3.7.4", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA=="],
+ "@astrojs/markdown-remark/shiki": ["shiki@3.19.0", "", { "dependencies": { "@shikijs/core": "3.19.0", "@shikijs/engine-javascript": "3.19.0", "@shikijs/engine-oniguruma": "3.19.0", "@shikijs/langs": "3.19.0", "@shikijs/themes": "3.19.0", "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-77VJr3OR/VUZzPiStyRhADmO2jApMM0V2b1qf0RpfWya8Zr1PeZev5AEpPGAAKWdiYUtcZGBE4F5QvJml1PvWA=="],
+
+ "@astrojs/markdown-remark/smol-toml": ["smol-toml@1.5.2", "", {}, "sha512-QlaZEqcAH3/RtNyet1IPIYPsEWAaYyXXv1Krsi+1L/QHppjX4Ifm8MQsBISz9vE8cHicIq3clogsheili5vhaQ=="],
+
"@astrojs/telemetry/ci-info": ["ci-info@4.3.1", "", {}, "sha512-Wdy2Igu8OcBpI2pZePZ5oWjPC38tmDVx5WKUXKwlLYkA0ozo85sLsLvkBbBn/sZaSCMFOGZJ14fvW9t5/d7kdA=="],
+ "@expressive-code/plugin-shiki/shiki": ["shiki@3.19.0", "", { "dependencies": { "@shikijs/core": "3.19.0", "@shikijs/engine-javascript": "3.19.0", "@shikijs/engine-oniguruma": "3.19.0", "@shikijs/langs": "3.19.0", "@shikijs/themes": "3.19.0", "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-77VJr3OR/VUZzPiStyRhADmO2jApMM0V2b1qf0RpfWya8Zr1PeZev5AEpPGAAKWdiYUtcZGBE4F5QvJml1PvWA=="],
+
"@manypkg/find-root/@types/node": ["@types/node@12.20.55", "", {}, "sha512-J8xLz7q2OFulZ2cyGTLE1TbbZcjpno7FaN6zdJNrgAdrJ+DZzh/uFR6YrTb4C+nXakvud8Q4+rbhoIWlYQbUFQ=="],
"@manypkg/find-root/fs-extra": ["fs-extra@8.1.0", "", { "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^4.0.0", "universalify": "^0.1.0" } }, "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g=="],
@@ -1597,8 +1583,6 @@
"@tailwindcss/oxide-wasm32-wasi/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
- "@types/fontkit/@types/node": ["@types/node@22.19.2", "", { "dependencies": { "undici-types": "~6.21.0" } }, "sha512-LPM2G3Syo1GLzXLGJAKdqoU35XvrWzGJ21/7sgZTUpbkBaOasTj8tjwn6w+hCkqaa1TfJ/w67rJSwYItlJ2mYw=="],
-
"@types/sax/@types/node": ["@types/node@22.19.2", "", { "dependencies": { "undici-types": "~6.21.0" } }, "sha512-LPM2G3Syo1GLzXLGJAKdqoU35XvrWzGJ21/7sgZTUpbkBaOasTj8tjwn6w+hCkqaa1TfJ/w67rJSwYItlJ2mYw=="],
"@vscode/emmet-helper/jsonc-parser": ["jsonc-parser@2.3.1", "", {}, "sha512-H8jvkz1O50L3dMZCsLqiuB2tA7muqbSg1AtGEkN0leAqGjsUzDJir3Zwr02BhqdcITPg3ei3mZ+HjMocAknhhg=="],
@@ -1615,6 +1599,8 @@
"boxen/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
+ "bun-types/@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+
"cliui/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
"cliui/wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
@@ -1647,8 +1633,6 @@
"svgo/commander": ["commander@11.1.0", "", {}, "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ=="],
- "whatwg-encoding/iconv-lite": ["iconv-lite@0.6.3", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw=="],
-
"widest-line/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
"wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
@@ -1663,6 +1647,30 @@
"yargs/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
+ "@astrojs/markdown-remark/shiki/@shikijs/core": ["@shikijs/core@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4", "hast-util-to-html": "^9.0.5" } }, "sha512-L7SrRibU7ZoYi1/TrZsJOFAnnHyLTE1SwHG1yNWjZIVCqjOEmCSuK2ZO9thnRbJG6TOkPp+Z963JmpCNw5nzvA=="],
+
+ "@astrojs/markdown-remark/shiki/@shikijs/engine-javascript": ["@shikijs/engine-javascript@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "oniguruma-to-es": "^4.3.4" } }, "sha512-ZfWJNm2VMhKkQIKT9qXbs76RRcT0SF/CAvEz0+RkpUDAoDaCx0uFdCGzSRiD9gSlhm6AHkjdieOBJMaO2eC1rQ=="],
+
+ "@astrojs/markdown-remark/shiki/@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-1hRxtYIJfJSZeM5ivbUXv9hcJP3PWRo5prG/V2sWwiubUKTa+7P62d2qxCW8jiVFX4pgRHhnHNp+qeR7Xl+6kg=="],
+
+ "@astrojs/markdown-remark/shiki/@shikijs/langs": ["@shikijs/langs@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0" } }, "sha512-dBMFzzg1QiXqCVQ5ONc0z2ebyoi5BKz+MtfByLm0o5/nbUu3Iz8uaTCa5uzGiscQKm7lVShfZHU1+OG3t5hgwg=="],
+
+ "@astrojs/markdown-remark/shiki/@shikijs/themes": ["@shikijs/themes@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0" } }, "sha512-H36qw+oh91Y0s6OlFfdSuQ0Ld+5CgB/VE6gNPK+Hk4VRbVG/XQgkjnt4KzfnnoO6tZPtKJKHPjwebOCfjd6F8A=="],
+
+ "@astrojs/markdown-remark/shiki/@shikijs/types": ["@shikijs/types@3.19.0", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-Z2hdeEQlzuntf/BZpFG8a+Fsw9UVXdML7w0o3TgSXV3yNESGon+bs9ITkQb3Ki7zxoXOOu5oJWqZ2uto06V9iQ=="],
+
+ "@expressive-code/plugin-shiki/shiki/@shikijs/core": ["@shikijs/core@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4", "hast-util-to-html": "^9.0.5" } }, "sha512-L7SrRibU7ZoYi1/TrZsJOFAnnHyLTE1SwHG1yNWjZIVCqjOEmCSuK2ZO9thnRbJG6TOkPp+Z963JmpCNw5nzvA=="],
+
+ "@expressive-code/plugin-shiki/shiki/@shikijs/engine-javascript": ["@shikijs/engine-javascript@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "oniguruma-to-es": "^4.3.4" } }, "sha512-ZfWJNm2VMhKkQIKT9qXbs76RRcT0SF/CAvEz0+RkpUDAoDaCx0uFdCGzSRiD9gSlhm6AHkjdieOBJMaO2eC1rQ=="],
+
+ "@expressive-code/plugin-shiki/shiki/@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-1hRxtYIJfJSZeM5ivbUXv9hcJP3PWRo5prG/V2sWwiubUKTa+7P62d2qxCW8jiVFX4pgRHhnHNp+qeR7Xl+6kg=="],
+
+ "@expressive-code/plugin-shiki/shiki/@shikijs/langs": ["@shikijs/langs@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0" } }, "sha512-dBMFzzg1QiXqCVQ5ONc0z2ebyoi5BKz+MtfByLm0o5/nbUu3Iz8uaTCa5uzGiscQKm7lVShfZHU1+OG3t5hgwg=="],
+
+ "@expressive-code/plugin-shiki/shiki/@shikijs/themes": ["@shikijs/themes@3.19.0", "", { "dependencies": { "@shikijs/types": "3.19.0" } }, "sha512-H36qw+oh91Y0s6OlFfdSuQ0Ld+5CgB/VE6gNPK+Hk4VRbVG/XQgkjnt4KzfnnoO6tZPtKJKHPjwebOCfjd6F8A=="],
+
+ "@expressive-code/plugin-shiki/shiki/@shikijs/types": ["@shikijs/types@3.19.0", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-Z2hdeEQlzuntf/BZpFG8a+Fsw9UVXdML7w0o3TgSXV3yNESGon+bs9ITkQb3Ki7zxoXOOu5oJWqZ2uto06V9iQ=="],
+
"@manypkg/get-packages/globby/ignore": ["ignore@5.3.2", "", {}, "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g=="],
"@manypkg/get-packages/globby/slash": ["slash@3.0.0", "", {}, "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q=="],
@@ -1671,8 +1679,6 @@
"@scalar/themes/@scalar/types/nanoid": ["nanoid@5.1.6", "", { "bin": { "nanoid": "bin/nanoid.js" } }, "sha512-c7+7RQ+dMB5dPwwCp4ee1/iV/q2P6aK1mTZcfr1BTuVlyW9hJYiMPybJCcnBlQtuSmTIWNeazm/zqNoZSSElBg=="],
- "@types/fontkit/@types/node/undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="],
-
"@types/sax/@types/node/undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="],
"boxen/string-width/emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
diff --git a/docs/RELEASE_SETUP.md b/docs/RELEASE_SETUP.md
deleted file mode 100644
index 37a48a0..0000000
--- a/docs/RELEASE_SETUP.md
+++ /dev/null
@@ -1,115 +0,0 @@
-# 🚀 Release Setup Guide
-
-## Step 1: Merge PR
-
-1. Go to [PR #1](https://github.com/miccy/snake-evolution/pull/1)
-2. Review changes
-3. Merge to main
-
-## Step 2: Repository Settings
-
-Go to **Settings → General**:
-
-### Description
-
-```text
-🐍 Turn your GitHub contributions into an animated snake that devours them! CLI + GitHub Action. PvP mode coming soon!
-```
-
-### Topics (click "Add topics")
-
-```text
-github-action snake contributions svg animation typescript bun cli github-profile readme-profile
-```
-
-### Features (checkboxes)
-
-- [x] Issues
-- [x] Discussions
-- [x] Releases
-- [x] Packages (for npm)
-- [x] Deployments (for future web)
-- [ ] Wiki (not needed)
-- [ ] Projects (optional)
-
-### Social Preview
-
-Upload `.github/banner.jpg`
-
-## Step 3: Make Repository Public
-
-Go to **Settings → Danger Zone → Change visibility → Make public**
-
-## Step 4: Create npm Token
-
-1. Go to [npm tokens page](https://www.npmjs.com/settings/YOUR_USERNAME/tokens)
-2. Click "Generate New Token" → "Classic Token"
-3. Select "Publish" permission
-4. Copy the token
-
-## Step 5: Add npm Token to GitHub Secrets
-
-1. Go to repo **Settings → Secrets and variables → Actions**
-2. Click "New repository secret"
-3. Name: `NPM_TOKEN`
-4. Value: paste your npm token
-5. Save
-
-## Step 6: Create Release & Publish
-
-```bash
-# Pull latest main
-git checkout main
-git pull origin main
-
-# Create version tag
-git tag v1.0.0
-git push origin v1.0.0
-```
-
-Then on GitHub:
-
-1. Go to **Releases → Draft a new release**
-2. Choose tag: `v1.0.0`
-3. Title: `v1.0.0 - Initial Release`
-4. Description: Copy from CHANGELOG.md
-5. Click **Publish release**
-
-This will automatically:
-
-- ✅ Create GitHub Release
-- ✅ Trigger npm publish workflow
-- ✅ Package will be available as `npx @snake-evolution/cli`
-
-## Step 7: Publish Action to Marketplace
-
-1. Go to **repo → Actions tab**
-2. Look for "Publish this action to the GitHub Marketplace" banner
-3. Follow the steps
-
-## Step 8: Enable Discussions
-
-Go to **Settings → Features → Discussions ✅**
-
-Create categories:
-
-- 💡 Ideas
-- 🙋 Q&A
-- 🎉 Show and Tell
-
----
-
-## Verification
-
-After release, test:
-
-```bash
-npx @snake-evolution/cli generate -u miccy -o test.svg
-```
-
-Check:
-
-- [ ] npm page: [@snake-evolution/cli on npm](https://www.npmjs.com/package/@snake-evolution/cli)
-- [ ] GitHub Action in Marketplace
-- [ ] README renders correctly
-- [ ] Social preview shows banner
diff --git a/docs/ROADMAP_V2.md b/docs/ROADMAP_V2.md
new file mode 100644
index 0000000..db73bf5
--- /dev/null
+++ b/docs/ROADMAP_V2.md
@@ -0,0 +1,836 @@
+# 🗺️ Snake Evolution Roadmap v2.0
+
+> **Updated:** December 29, 2025
+> **Strategic Focus:** Ethical positioning + Interactive playground + Monetization
+
+## 🎯 Vision
+
+**Make Snake Evolution the #1 ethical and fun way to visualize GitHub contributions** - from simple animations to competitive PvP battles. Position as "The Legitimate Alternative" in a market flooded with manipulation tools.
+
+---
+
+## 📍 Current Position (v1.2.4)
+
+### Market Context
+- **18,000+ GitHub stars** on contribution manipulation tools
+- **5,500+ stars** on legitimate visualization tools
+- **Growing demand** for profile customization
+- **Hiring managers** increasingly skeptical of fake graphs
+
+### Our Opportunity
+```
+gitfiti (2012): Pixel art, playful, 8.3K ⭐
+github-activity: Fake automation, 3.7K ⭐, SKETCHY
+Snake Evolution: ✨ Real data + Gamification + Customization ✨
+ TARGET: 10K ⭐ in 6 months
+```
+
+### What's Live ✅
+- CLI tool (`npx @snake-evolution/cli@latest`)
+- GitHub Action (marketplace)
+- 7 themes (6 SVG + Glass theme for GIF)
+- Smart pathfinding
+- Monorepo architecture
+
+### Critical Gaps 🚨
+- ❌ GIF output (80% ready, not shipped)
+- ❌ Interactive playground
+- ❌ Ethical positioning in marketing
+- ❌ Full color customization
+- ❌ Monetization strategy
+
+---
+
+## 🚀 Phase 1: v1.3.0 - Foundation Completion (January 2025)
+
+**Goal:** Ship GIF, complete v1 vision, establish ethical positioning
+
+### Priority 1: GIF Implementation (Week 1)
+**Status:** 80% complete, needs final push
+
+**Tasks:**
+- [ ] Complete `packages/renderer/src/gif.ts` integration
+- [ ] Test Glass theme rendering with blur effects
+- [ ] CLI `--format gif` option working
+- [ ] GitHub Action supports GIF output
+- [ ] Performance benchmarks (<5s for 365 days)
+- [ ] File size optimization (<1MB)
+
+**Success Metrics:**
+- Glass theme renders correctly
+- GIF generation time <5s
+- File size <1MB for full year
+- Zero regressions in SVG output
+
+**Acceptance Criteria:**
+```bash
+# These must work:
+npx @snake-evolution/cli generate -u octocat --format gif
+npx @snake-evolution/cli generate -u octocat -t glass --format gif
+
+# Output:
+✓ Generated snake.gif (847KB, 150 frames, 3.2s)
+✓ Glass theme with blur effects rendered
+```
+
+### Priority 2: Ethical Positioning (Week 1-2)
+
+**Strategic Message:**
+> "Snake Evolution shows your REAL GitHub activity in a fun way.
+> No fake commits. No manipulation. Just your actual work, animated."
+
+**Implementation:**
+
+**A) README.md Updates:**
+
+Add prominent badge section:
+```markdown
+## ✅ The Ethical Choice
+
+| Snake Evolution | Fake Activity Tools |
+|-----------------|---------------------|
+| ✅ Shows REAL contributions | ❌ Generates fake commits |
+| ✅ Trusted by hiring managers | ❌ Flagged by recruiters |
+| ✅ Open source & auditable | ⚠️ Black box scripts |
+| ✅ Zero security risk | 🚫 Run unknown shell scripts |
+| ✅ GitHub officially approved | ⚠️ Against ToS |
+
+**Used by 10,000+ developers who value authenticity.**
+```
+
+**B) Landing Page Section:**
+
+```markdown
+## Why Developers Trust Snake Evolution
+
+"I wanted to showcase my contributions without faking anything.
+Snake Evolution was perfect - it's fun, legitimate, and actually
+impresses hiring managers." - @developer
+
+[📊 Compare with alternatives] [🔐 Security audit]
+```
+
+**C) Marketplace Description Update:**
+
+Current:
+> "Generate a snake game from a GitHub user contribution graph"
+
+New:
+> "🐍 The #1 ethical way to animate your GitHub contributions.
+> Shows REAL activity only - trusted by 10K+ developers and
+> hiring managers. No fake commits, no manipulation, just fun."
+
+**Success Metrics:**
+- Trust indicators in README
+- "Ethical" mentioned prominently
+- Comparison table vs manipulation tools
+- Security audit badge
+
+### Priority 3: Custom Colors Preview (Week 2)
+
+**Goal:** Port that React component to web app as MVP
+
+**Quick Win Implementation:**
+
+Create `apps/web/src/pages/playground.astro`:
+
+```tsx
+---
+// Astro frontmatter
+import PlaygroundPreview from '../components/PlaygroundPreview';
+---
+
+
Date: Thu, 29 Jan 2026 07:40:50 +0100
Subject: [PATCH 05/29] chore: Update various dependencies including Astro,
Biome, Turbo, Elysia, and React across applications and packages.
---
apps/api/package.json | 2 +-
apps/web/package.json | 4 +-
bun.lock | 94 +++++++++++++++++++--------------------
package.json | 10 ++---
packages/cli/package.json | 2 +-
packages/ui/package.json | 6 +--
6 files changed, 59 insertions(+), 59 deletions(-)
diff --git a/apps/api/package.json b/apps/api/package.json
index 705f8cc..bc0b6f6 100644
--- a/apps/api/package.json
+++ b/apps/api/package.json
@@ -13,7 +13,7 @@
"dependencies": {
"@elysiajs/cors": "^1.4.1",
"@elysiajs/swagger": "^1.3.1",
- "elysia": "^1.4.21"
+ "elysia": "^1.4.22"
},
"devDependencies": {}
}
diff --git a/apps/web/package.json b/apps/web/package.json
index 4b65b3d..9215af3 100644
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -11,10 +11,10 @@
"clean": "rm -rf dist .astro node_modules"
},
"dependencies": {
- "@astrojs/starlight": "^0.37.2",
+ "@astrojs/starlight": "^0.37.4",
"@tailwindcss/postcss": "^4.1.18",
"@tailwindcss/vite": "^4.1.18",
- "astro": "^5.16.8",
+ "astro": "^5.16.16",
"sharp": "^0.34.2",
"tailwindcss": "^4.1.18"
},
diff --git a/bun.lock b/bun.lock
index 2ccb80d..e284099 100644
--- a/bun.lock
+++ b/bun.lock
@@ -5,12 +5,12 @@
"": {
"name": "snake-evolution",
"devDependencies": {
- "@biomejs/biome": "^2.3.11",
+ "@biomejs/biome": "^2.3.13",
"@changesets/cli": "^2.29.8",
- "@types/bun": "1.3.5",
+ "@types/bun": "1.3.7",
"jsonc-parser": "^3.3.1",
"markdownlint-cli2": "^0.20.0",
- "turbo": "^2.7.3",
+ "turbo": "^2.8.0",
"typescript": "5.9.3",
"yaml": "2.8.2",
},
@@ -21,17 +21,17 @@
"dependencies": {
"@elysiajs/cors": "^1.4.1",
"@elysiajs/swagger": "^1.3.1",
- "elysia": "^1.4.21",
+ "elysia": "^1.4.22",
},
},
"apps/web": {
"name": "@snake-evolution/web",
"version": "1.2.4",
"dependencies": {
- "@astrojs/starlight": "^0.37.2",
+ "@astrojs/starlight": "^0.37.4",
"@tailwindcss/postcss": "^4.1.18",
"@tailwindcss/vite": "^4.1.18",
- "astro": "^5.16.8",
+ "astro": "^5.16.16",
"sharp": "^0.34.2",
"tailwindcss": "^4.1.18",
},
@@ -54,7 +54,7 @@
"@snake-evolution/github": "workspace:*",
"@snake-evolution/renderer": "workspace:*",
"@snake-evolution/types": "workspace:*",
- "@types/node": "^25.0.6",
+ "@types/node": "^25.1.0",
"commander": "^14.0.2",
},
},
@@ -92,13 +92,13 @@
"version": "1.2.4",
"dependencies": {
"isomorphic-dompurify": "^2.35.0",
- "react": "^19.0.0",
+ "react": "^19.2.4",
},
"devDependencies": {
- "@types/react": "^19.2.8",
+ "@types/react": "^19.2.10",
},
"peerDependencies": {
- "react": "^18.0.0 || ^19.0.0",
+ "react": "^19.2.4",
},
},
},
@@ -135,7 +135,7 @@
"@astrojs/sitemap": ["@astrojs/sitemap@3.6.0", "", { "dependencies": { "sitemap": "^8.0.0", "stream-replace-string": "^2.0.0", "zod": "^3.25.76" } }, "sha512-4aHkvcOZBWJigRmMIAJwRQXBS+ayoP5z40OklTXYXhUDhwusz+DyDl+nSshY6y9DvkVEavwNcFO8FD81iGhXjg=="],
- "@astrojs/starlight": ["@astrojs/starlight@0.37.2", "", { "dependencies": { "@astrojs/markdown-remark": "^6.3.1", "@astrojs/mdx": "^4.2.3", "@astrojs/sitemap": "^3.3.0", "@pagefind/default-ui": "^1.3.0", "@types/hast": "^3.0.4", "@types/js-yaml": "^4.0.9", "@types/mdast": "^4.0.4", "astro-expressive-code": "^0.41.1", "bcp-47": "^2.1.0", "hast-util-from-html": "^2.0.1", "hast-util-select": "^6.0.2", "hast-util-to-string": "^3.0.0", "hastscript": "^9.0.0", "i18next": "^23.11.5", "js-yaml": "^4.1.0", "klona": "^2.0.6", "magic-string": "^0.30.17", "mdast-util-directive": "^3.0.0", "mdast-util-to-markdown": "^2.1.0", "mdast-util-to-string": "^4.0.0", "pagefind": "^1.3.0", "rehype": "^13.0.1", "rehype-format": "^5.0.0", "remark-directive": "^3.0.0", "ultrahtml": "^1.6.0", "unified": "^11.0.5", "unist-util-visit": "^5.0.0", "vfile": "^6.0.2" }, "peerDependencies": { "astro": "^5.5.0" } }, "sha512-DGeaaKizwxHDsz72FdxyIBZ32eY8OdUoH6b757BGZlLEDq82O4uipFWoh+kz7+aKg1QoFu/rDq6fqtw+58tpRQ=="],
+ "@astrojs/starlight": ["@astrojs/starlight@0.37.4", "", { "dependencies": { "@astrojs/markdown-remark": "^6.3.1", "@astrojs/mdx": "^4.2.3", "@astrojs/sitemap": "^3.3.0", "@pagefind/default-ui": "^1.3.0", "@types/hast": "^3.0.4", "@types/js-yaml": "^4.0.9", "@types/mdast": "^4.0.4", "astro-expressive-code": "^0.41.1", "bcp-47": "^2.1.0", "hast-util-from-html": "^2.0.1", "hast-util-select": "^6.0.2", "hast-util-to-string": "^3.0.0", "hastscript": "^9.0.0", "i18next": "^23.11.5", "js-yaml": "^4.1.0", "klona": "^2.0.6", "magic-string": "^0.30.17", "mdast-util-directive": "^3.0.0", "mdast-util-to-markdown": "^2.1.0", "mdast-util-to-string": "^4.0.0", "pagefind": "^1.3.0", "rehype": "^13.0.1", "rehype-format": "^5.0.0", "remark-directive": "^3.0.0", "ultrahtml": "^1.6.0", "unified": "^11.0.5", "unist-util-visit": "^5.0.0", "vfile": "^6.0.2" }, "peerDependencies": { "astro": "^5.5.0" } }, "sha512-ygPGDgRd9nCcNgaYMNN7UeAMAkDOR1ibv3ps3xEz+cuvKG3CRLd19UwdB+Gyz1tbkyfjPWPkFKNhLwNybro8Tw=="],
"@astrojs/telemetry": ["@astrojs/telemetry@3.3.0", "", { "dependencies": { "ci-info": "^4.2.0", "debug": "^4.4.0", "dlv": "^1.1.3", "dset": "^3.1.4", "is-docker": "^3.0.0", "is-wsl": "^3.1.0", "which-pm-runs": "^1.1.0" } }, "sha512-UFBgfeldP06qu6khs/yY+q1cDAaArM2/7AEIqQ9Cuvf7B1hNLq0xDrZkct+QoIGyjq56y8IaE2I3CTvG99mlhQ=="],
@@ -151,23 +151,23 @@
"@babel/types": ["@babel/types@7.28.5", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA=="],
- "@biomejs/biome": ["@biomejs/biome@2.3.11", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.3.11", "@biomejs/cli-darwin-x64": "2.3.11", "@biomejs/cli-linux-arm64": "2.3.11", "@biomejs/cli-linux-arm64-musl": "2.3.11", "@biomejs/cli-linux-x64": "2.3.11", "@biomejs/cli-linux-x64-musl": "2.3.11", "@biomejs/cli-win32-arm64": "2.3.11", "@biomejs/cli-win32-x64": "2.3.11" }, "bin": { "biome": "bin/biome" } }, "sha512-/zt+6qazBWguPG6+eWmiELqO+9jRsMZ/DBU3lfuU2ngtIQYzymocHhKiZRyrbra4aCOoyTg/BmY+6WH5mv9xmQ=="],
+ "@biomejs/biome": ["@biomejs/biome@2.3.13", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.3.13", "@biomejs/cli-darwin-x64": "2.3.13", "@biomejs/cli-linux-arm64": "2.3.13", "@biomejs/cli-linux-arm64-musl": "2.3.13", "@biomejs/cli-linux-x64": "2.3.13", "@biomejs/cli-linux-x64-musl": "2.3.13", "@biomejs/cli-win32-arm64": "2.3.13", "@biomejs/cli-win32-x64": "2.3.13" }, "bin": { "biome": "bin/biome" } }, "sha512-Fw7UsV0UAtWIBIm0M7g5CRerpu1eKyKAXIazzxhbXYUyMkwNrkX/KLkGI7b+uVDQ5cLUMfOC9vR60q9IDYDstA=="],
- "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.3.11", "", { "os": "darwin", "cpu": "arm64" }, "sha512-/uXXkBcPKVQY7rc9Ys2CrlirBJYbpESEDme7RKiBD6MmqR2w3j0+ZZXRIL2xiaNPsIMMNhP1YnA+jRRxoOAFrA=="],
+ "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.3.13", "", { "os": "darwin", "cpu": "arm64" }, "sha512-0OCwP0/BoKzyJHnFdaTk/i7hIP9JHH9oJJq6hrSCPmJPo8JWcJhprK4gQlhFzrwdTBAW4Bjt/RmCf3ZZe59gwQ=="],
- "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.3.11", "", { "os": "darwin", "cpu": "x64" }, "sha512-fh7nnvbweDPm2xEmFjfmq7zSUiox88plgdHF9OIW4i99WnXrAC3o2P3ag9judoUMv8FCSUnlwJCM1B64nO5Fbg=="],
+ "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.3.13", "", { "os": "darwin", "cpu": "x64" }, "sha512-AGr8OoemT/ejynbIu56qeil2+F2WLkIjn2d8jGK1JkchxnMUhYOfnqc9sVzcRxpG9Ycvw4weQ5sprRvtb7Yhcw=="],
- "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.3.11", "", { "os": "linux", "cpu": "arm64" }, "sha512-l4xkGa9E7Uc0/05qU2lMYfN1H+fzzkHgaJoy98wO+b/7Gl78srbCRRgwYSW+BTLixTBrM6Ede5NSBwt7rd/i6g=="],
+ "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.3.13", "", { "os": "linux", "cpu": "arm64" }, "sha512-xvOiFkrDNu607MPMBUQ6huHmBG1PZLOrqhtK6pXJW3GjfVqJg0Z/qpTdhXfcqWdSZHcT+Nct2fOgewZvytESkw=="],
- "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.3.11", "", { "os": "linux", "cpu": "arm64" }, "sha512-XPSQ+XIPZMLaZ6zveQdwNjbX+QdROEd1zPgMwD47zvHV+tCGB88VH+aynyGxAHdzL+Tm/+DtKST5SECs4iwCLg=="],
+ "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.3.13", "", { "os": "linux", "cpu": "arm64" }, "sha512-TUdDCSY+Eo/EHjhJz7P2GnWwfqet+lFxBZzGHldrvULr59AgahamLs/N85SC4+bdF86EhqDuuw9rYLvLFWWlXA=="],
- "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-/1s9V/H3cSe0r0Mv/Z8JryF5x9ywRxywomqZVLHAoa/uN0eY7F8gEngWKNS5vbbN/BsfpCG5yeBT5ENh50Frxg=="],
+ "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.3.13", "", { "os": "linux", "cpu": "x64" }, "sha512-s+YsZlgiXNq8XkgHs6xdvKDFOj/bwTEevqEY6rC2I3cBHbxXYU1LOZstH3Ffw9hE5tE1sqT7U23C00MzkXztMw=="],
- "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-vU7a8wLs5C9yJ4CB8a44r12aXYb8yYgBn+WeyzbMjaCMklzCv1oXr8x+VEyWodgJt9bDmhiaW/I0RHbn7rsNmw=="],
+ "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.3.13", "", { "os": "linux", "cpu": "x64" }, "sha512-0bdwFVSbbM//Sds6OjtnmQGp4eUjOTt6kHvR/1P0ieR9GcTUAlPNvPC3DiavTqq302W34Ae2T6u5VVNGuQtGlQ=="],
- "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.3.11", "", { "os": "win32", "cpu": "arm64" }, "sha512-PZQ6ElCOnkYapSsysiTy0+fYX+agXPlWugh6+eQ6uPKI3vKAqNp6TnMhoM3oY2NltSB89hz59o8xIfOdyhi9Iw=="],
+ "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.3.13", "", { "os": "win32", "cpu": "arm64" }, "sha512-QweDxY89fq0VvrxME+wS/BXKmqMrOTZlN9SqQ79kQSIc3FrEwvW/PvUegQF6XIVaekncDykB5dzPqjbwSKs9DA=="],
- "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.3.11", "", { "os": "win32", "cpu": "x64" }, "sha512-43VrG813EW+b5+YbDbz31uUsheX+qFKCpXeY9kfdAx+ww3naKxeVkTD9zLIWxUPfJquANMHrmW3wbe/037G0Qg=="],
+ "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.3.13", "", { "os": "win32", "cpu": "x64" }, "sha512-trDw2ogdM2lyav9WFQsdsfdVy1dvZALymRpgmWsvSez0BJzBjulhOT/t+wyKeh3pZWvwP3VMs1SoOKwO3wecMQ=="],
"@borewit/text-codec": ["@borewit/text-codec@0.1.1", "", {}, "sha512-5L/uBxmjaCIX5h8Z+uu+kA9BQLkc/Wl06UGR5ajNRxu+/XjonB5i8JpgFMrPj3LXTCPA0pv8yxUvbUi+QthGGA=="],
@@ -519,7 +519,7 @@
"@tokenizer/token": ["@tokenizer/token@0.3.0", "", {}, "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A=="],
- "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
+ "@types/bun": ["@types/bun@1.3.7", "", { "dependencies": { "bun-types": "1.3.7" } }, "sha512-lmNuMda+Z9b7tmhA0tohwy8ZWFSnmQm1UDWXtH5r9F7wZCfkeO3Jx7wKQ1EOiKq43yHts7ky6r8SDJQWRNupkA=="],
"@types/debug": ["@types/debug@4.1.12", "", { "dependencies": { "@types/ms": "*" } }, "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ=="],
@@ -541,9 +541,9 @@
"@types/nlcst": ["@types/nlcst@2.0.3", "", { "dependencies": { "@types/unist": "*" } }, "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA=="],
- "@types/node": ["@types/node@25.0.6", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-NNu0sjyNxpoiW3YuVFfNz7mxSQ+S4X2G28uqg2s+CzoqoQjLPsWSbsFFyztIAqt2vb8kfEAsJNepMGPTxFDx3Q=="],
+ "@types/node": ["@types/node@25.1.0", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-t7frlewr6+cbx+9Ohpl0NOTKXZNV9xHRmNOvql47BFJKcEG1CxtxlPEEe+gR9uhVWM4DwhnvTF110mIL4yP9RA=="],
- "@types/react": ["@types/react@19.2.8", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-3MbSL37jEchWZz2p2mjntRZtPt837ij10ApxKfgmXCTuHWagYg7iA5bqPw6C8BMPfwidlvfPI/fxOc42HLhcyg=="],
+ "@types/react": ["@types/react@19.2.10", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-WPigyYuGhgZ/cTPRXB2EwUw+XvsRA3GqHlsP4qteqrnnjDrApbS7MxcGr/hke5iUoeB7E/gQtrs9I37zAJ0Vjw=="],
"@types/sax": ["@types/sax@1.2.7", "", { "dependencies": { "@types/node": "*" } }, "sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A=="],
@@ -603,7 +603,7 @@
"astring": ["astring@1.9.0", "", { "bin": { "astring": "bin/astring" } }, "sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg=="],
- "astro": ["astro@5.16.8", "", { "dependencies": { "@astrojs/compiler": "^2.13.0", "@astrojs/internal-helpers": "0.7.5", "@astrojs/markdown-remark": "6.3.10", "@astrojs/telemetry": "3.3.0", "@capsizecss/unpack": "^4.0.0", "@oslojs/encoding": "^1.1.0", "@rollup/pluginutils": "^5.3.0", "acorn": "^8.15.0", "aria-query": "^5.3.2", "axobject-query": "^4.1.0", "boxen": "8.0.1", "ci-info": "^4.3.1", "clsx": "^2.1.1", "common-ancestor-path": "^1.0.1", "cookie": "^1.1.1", "cssesc": "^3.0.0", "debug": "^4.4.3", "deterministic-object-hash": "^2.0.2", "devalue": "^5.6.1", "diff": "^5.2.0", "dlv": "^1.1.3", "dset": "^3.1.4", "es-module-lexer": "^1.7.0", "esbuild": "^0.25.0", "estree-walker": "^3.0.3", "flattie": "^1.1.1", "fontace": "~0.4.0", "github-slugger": "^2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "^4.2.0", "import-meta-resolve": "^4.2.0", "js-yaml": "^4.1.1", "magic-string": "^0.30.21", "magicast": "^0.5.1", "mrmime": "^2.0.1", "neotraverse": "^0.6.18", "p-limit": "^6.2.0", "p-queue": "^8.1.1", "package-manager-detector": "^1.6.0", "piccolore": "^0.1.3", "picomatch": "^4.0.3", "prompts": "^2.4.2", "rehype": "^13.0.2", "semver": "^7.7.3", "shiki": "^3.20.0", "smol-toml": "^1.6.0", "svgo": "^4.0.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tsconfck": "^3.1.6", "ultrahtml": "^1.6.0", "unifont": "~0.7.1", "unist-util-visit": "^5.0.0", "unstorage": "^1.17.3", "vfile": "^6.0.3", "vite": "^6.4.1", "vitefu": "^1.1.1", "xxhash-wasm": "^1.1.0", "yargs-parser": "^21.1.1", "yocto-spinner": "^0.2.3", "zod": "^3.25.76", "zod-to-json-schema": "^3.25.1", "zod-to-ts": "^1.2.0" }, "optionalDependencies": { "sharp": "^0.34.0" }, "bin": { "astro": "astro.js" } }, "sha512-gzZE+epuCrNuxOa8/F1dzkllDOFvxWhGeobQKeBRIAef5sUpUKMHZo/8clse+02rYnKJCgwXBgjW4uTu9mqUUw=="],
+ "astro": ["astro@5.16.16", "", { "dependencies": { "@astrojs/compiler": "^2.13.0", "@astrojs/internal-helpers": "0.7.5", "@astrojs/markdown-remark": "6.3.10", "@astrojs/telemetry": "3.3.0", "@capsizecss/unpack": "^4.0.0", "@oslojs/encoding": "^1.1.0", "@rollup/pluginutils": "^5.3.0", "acorn": "^8.15.0", "aria-query": "^5.3.2", "axobject-query": "^4.1.0", "boxen": "8.0.1", "ci-info": "^4.3.1", "clsx": "^2.1.1", "common-ancestor-path": "^1.0.1", "cookie": "^1.1.1", "cssesc": "^3.0.0", "debug": "^4.4.3", "deterministic-object-hash": "^2.0.2", "devalue": "^5.6.2", "diff": "^8.0.3", "dlv": "^1.1.3", "dset": "^3.1.4", "es-module-lexer": "^1.7.0", "esbuild": "^0.25.0", "estree-walker": "^3.0.3", "flattie": "^1.1.1", "fontace": "~0.4.0", "github-slugger": "^2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "^4.2.0", "import-meta-resolve": "^4.2.0", "js-yaml": "^4.1.1", "magic-string": "^0.30.21", "magicast": "^0.5.1", "mrmime": "^2.0.1", "neotraverse": "^0.6.18", "p-limit": "^6.2.0", "p-queue": "^8.1.1", "package-manager-detector": "^1.6.0", "piccolore": "^0.1.3", "picomatch": "^4.0.3", "prompts": "^2.4.2", "rehype": "^13.0.2", "semver": "^7.7.3", "shiki": "^3.21.0", "smol-toml": "^1.6.0", "svgo": "^4.0.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tsconfck": "^3.1.6", "ultrahtml": "^1.6.0", "unifont": "~0.7.3", "unist-util-visit": "^5.0.0", "unstorage": "^1.17.4", "vfile": "^6.0.3", "vite": "^6.4.1", "vitefu": "^1.1.1", "xxhash-wasm": "^1.1.0", "yargs-parser": "^21.1.1", "yocto-spinner": "^0.2.3", "zod": "^3.25.76", "zod-to-json-schema": "^3.25.1", "zod-to-ts": "^1.2.0" }, "optionalDependencies": { "sharp": "^0.34.0" }, "bin": { "astro": "astro.js" } }, "sha512-MFlFvQ84ixaHyqB3uGwMhNHdBLZ3vHawyq3PqzQS2TNWiNfQrxp5ag6S3lX+Cvnh0MUcXX+UnJBPMBHjP1/1ZQ=="],
"astro-expressive-code": ["astro-expressive-code@0.41.4", "", { "dependencies": { "rehype-expressive-code": "^0.41.4" }, "peerDependencies": { "astro": "^4.0.0-beta || ^5.0.0-beta || ^3.3.0" } }, "sha512-LK6EcK/hIHfOSo9zqapzu4CbTC0YBtMOVdvWjInpB2SgYtxiF22aZDqdpejN8J28mWPqPLQwSqdl2lWuirNXmw=="],
@@ -627,7 +627,7 @@
"braces": ["braces@3.0.3", "", { "dependencies": { "fill-range": "^7.1.1" } }, "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA=="],
- "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
+ "bun-types": ["bun-types@1.3.7", "", { "dependencies": { "@types/node": "*" } }, "sha512-qyschsA03Qz+gou+apt6HNl6HnI+sJJLL4wLDke4iugsE6584CMupOtTY1n+2YC9nGVrEKUlTs99jjRLKgWnjQ=="],
"camelcase": ["camelcase@8.0.0", "", {}, "sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA=="],
@@ -711,11 +711,11 @@
"deterministic-object-hash": ["deterministic-object-hash@2.0.2", "", { "dependencies": { "base-64": "^1.0.0" } }, "sha512-KxektNH63SrbfUyDiwXqRb1rLwKt33AmMv+5Nhsw1kqZ13SJBRTgZHtGbE+hH3a1mVW1cz+4pqSWVPAtLVXTzQ=="],
- "devalue": ["devalue@5.6.1", "", {}, "sha512-jDwizj+IlEZBunHcOuuFVBnIMPAEHvTsJj0BcIp94xYguLRVBcXO853px/MyIJvbVzWdsGvrRweIUWJw8hBP7A=="],
+ "devalue": ["devalue@5.6.2", "", {}, "sha512-nPRkjWzzDQlsejL1WVifk5rvcFi/y1onBRxjaFMjZeR9mFpqu2gmAZ9xUB9/IEanEP/vBtGeGganC/GO1fmufg=="],
"devlop": ["devlop@1.1.0", "", { "dependencies": { "dequal": "^2.0.0" } }, "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA=="],
- "diff": ["diff@5.2.0", "", {}, "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A=="],
+ "diff": ["diff@8.0.3", "", {}, "sha512-qejHi7bcSD4hQAZE0tNAawRK1ZtafHDmMTMkrrIGgSLl7hTnQHmKCeB45xAcbfTqK2zowkM3j3bHt/4b/ARbYQ=="],
"dir-glob": ["dir-glob@3.0.1", "", { "dependencies": { "path-type": "^4.0.0" } }, "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA=="],
@@ -735,7 +735,7 @@
"dset": ["dset@3.1.4", "", {}, "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA=="],
- "elysia": ["elysia@1.4.21", "", { "dependencies": { "cookie": "^1.1.1", "exact-mirror": "^0.2.6", "fast-decode-uri-component": "^1.0.1", "memoirist": "^0.4.0" }, "peerDependencies": { "@sinclair/typebox": ">= 0.34.0 < 1", "@types/bun": ">= 1.2.0", "file-type": ">= 20.0.0", "openapi-types": ">= 12.0.0", "typescript": ">= 5.0.0" }, "optionalPeers": ["@types/bun", "typescript"] }, "sha512-bGSbPSGnkWbO0qUDKS5Q+6iEewBdMmIiJ8F0li4djZ6WjpixUQouOzePYscG1Lemdv6pZpFi1YPfI/kjeq2voA=="],
+ "elysia": ["elysia@1.4.22", "", { "dependencies": { "cookie": "^1.1.1", "exact-mirror": "^0.2.6", "fast-decode-uri-component": "^1.0.1", "memoirist": "^0.4.0" }, "peerDependencies": { "@sinclair/typebox": ">= 0.34.0 < 1", "@types/bun": ">= 1.2.0", "file-type": ">= 20.0.0", "openapi-types": ">= 12.0.0", "typescript": ">= 5.0.0" }, "optionalPeers": ["@types/bun", "typescript"] }, "sha512-Q90VCb1RVFxnFaRV0FDoSylESQQLWgLHFmWciQJdX9h3b2cSasji9KWEUvaJuy/L9ciAGg4RAhUVfsXHg5K2RQ=="],
"emmet": ["emmet@2.4.11", "", { "dependencies": { "@emmetio/abbreviation": "^2.3.3", "@emmetio/css-abbreviation": "^2.1.8" } }, "sha512-23QPJB3moh/U9sT4rQzGgeyyGIrcM+GH5uVYg2C6wZIxAIJq7Ng3QLT79tl8FUwDXhyq9SusfknOrofAKqvgyQ=="],
@@ -825,7 +825,7 @@
"graceful-fs": ["graceful-fs@4.2.11", "", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="],
- "h3": ["h3@1.15.4", "", { "dependencies": { "cookie-es": "^1.2.2", "crossws": "^0.3.5", "defu": "^6.1.4", "destr": "^2.0.5", "iron-webcrypto": "^1.2.1", "node-mock-http": "^1.0.2", "radix3": "^1.1.2", "ufo": "^1.6.1", "uncrypto": "^0.1.3" } }, "sha512-z5cFQWDffyOe4vQ9xIqNfCZdV4p//vy6fBnr8Q1AWnVZ0teurKMG66rLj++TKwKPUP3u7iMUvrvKaEUiQw2QWQ=="],
+ "h3": ["h3@1.15.5", "", { "dependencies": { "cookie-es": "^1.2.2", "crossws": "^0.3.5", "defu": "^6.1.4", "destr": "^2.0.5", "iron-webcrypto": "^1.2.1", "node-mock-http": "^1.0.4", "radix3": "^1.1.2", "ufo": "^1.6.3", "uncrypto": "^0.1.3" } }, "sha512-xEyq3rSl+dhGX2Lm0+eFQIAzlDN6Fs0EcC4f7BNUmzaRX/PTzeuM+Tr2lHB8FoXggsQIeXLj8EDVgs5ywxyxmg=="],
"hast-util-embedded": ["hast-util-embedded@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0", "hast-util-is-element": "^3.0.0" } }, "sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA=="],
@@ -985,7 +985,7 @@
"longest-streak": ["longest-streak@3.1.0", "", {}, "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g=="],
- "lru-cache": ["lru-cache@10.4.3", "", {}, "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ=="],
+ "lru-cache": ["lru-cache@11.2.4", "", {}, "sha512-B5Y16Jr9LB9dHVkh6ZevG+vAbOsNOYCX+sXvFWFu7B3Iz5mijW3zdbMyhsh8ANd2mSWBYdJgnqi+mL7/LrOPYg=="],
"magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
@@ -1223,7 +1223,7 @@
"radix3": ["radix3@1.1.2", "", {}, "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA=="],
- "react": ["react@19.2.3", "", {}, "sha512-Ku/hhYbVjOQnXDZFv2+RibmLFGwFdeeKHFcOTlrt7xplBnya5OGn/hIRDsqDiSUcfORsDC7MPxwork8jBwsIWA=="],
+ "react": ["react@19.2.4", "", {}, "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ=="],
"read-yaml-file": ["read-yaml-file@1.1.0", "", { "dependencies": { "graceful-fs": "^4.1.5", "js-yaml": "^3.6.1", "pify": "^4.0.1", "strip-bom": "^3.0.0" } }, "sha512-VIMnQi/Z4HT2Fxuwg5KrY174U1VdUIASQVWXXyqtNRtxSr9IYkn1rsI6Tb6HsrHCmB7gVpNwX6JxPTHcH6IoTA=="],
@@ -1381,19 +1381,19 @@
"tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
- "turbo": ["turbo@2.7.3", "", { "optionalDependencies": { "turbo-darwin-64": "2.7.3", "turbo-darwin-arm64": "2.7.3", "turbo-linux-64": "2.7.3", "turbo-linux-arm64": "2.7.3", "turbo-windows-64": "2.7.3", "turbo-windows-arm64": "2.7.3" }, "bin": { "turbo": "bin/turbo" } }, "sha512-+HjKlP4OfYk+qzvWNETA3cUO5UuK6b5MSc2UJOKyvBceKucQoQGb2g7HlC2H1GHdkfKrk4YF1VPvROkhVZDDLQ=="],
+ "turbo": ["turbo@2.8.0", "", { "optionalDependencies": { "turbo-darwin-64": "2.8.0", "turbo-darwin-arm64": "2.8.0", "turbo-linux-64": "2.8.0", "turbo-linux-arm64": "2.8.0", "turbo-windows-64": "2.8.0", "turbo-windows-arm64": "2.8.0" }, "bin": { "turbo": "bin/turbo" } }, "sha512-hYbxnLEdvJF+DLALS+Ia+PbfNtn0sDP0hH2u9AFoskSUDmcVHSrtwHpzdX94MrRJKo9D9tYxY3MyP20gnlrWyA=="],
- "turbo-darwin-64": ["turbo-darwin-64@2.7.3", "", { "os": "darwin", "cpu": "x64" }, "sha512-aZHhvRiRHXbJw1EcEAq4aws1hsVVUZ9DPuSFaq9VVFAKCup7niIEwc22glxb7240yYEr1vLafdQ2U294Vcwz+w=="],
+ "turbo-darwin-64": ["turbo-darwin-64@2.8.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-N7f4PYqz25yk8c5kituk09bJ89tE4wPPqKXgYccT6nbEQnGnrdvlyCHLyqViNObTgjjrddqjb1hmDkv7VcxE0g=="],
- "turbo-darwin-arm64": ["turbo-darwin-arm64@2.7.3", "", { "os": "darwin", "cpu": "arm64" }, "sha512-CkVrHSq+Bnhl9sX2LQgqQYVfLTWC2gvI74C4758OmU0djfrssDKU9d4YQF0AYXXhIIRZipSXfxClQziIMD+EAg=="],
+ "turbo-darwin-arm64": ["turbo-darwin-arm64@2.8.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-eVzejaP5fn51gmJAPW68U6mSjFaAZ26rPiE36mMdk+tMC4XBGmJHT/fIgrhcrXMvINCl27RF8VmguRe+MBlSuQ=="],
- "turbo-linux-64": ["turbo-linux-64@2.7.3", "", { "os": "linux", "cpu": "x64" }, "sha512-GqDsCNnzzr89kMaLGpRALyigUklzgxIrSy2pHZVXyifgczvYPnLglex78Aj3T2gu+T3trPPH2iJ+pWucVOCC2Q=="],
+ "turbo-linux-64": ["turbo-linux-64@2.8.0", "", { "os": "linux", "cpu": "x64" }, "sha512-ILR45zviYae3icf4cmUISdj8X17ybNcMh3Ms4cRdJF5sS50qDDTv8qeWqO/lPeHsu6r43gVWDofbDZYVuXYL7Q=="],
- "turbo-linux-arm64": ["turbo-linux-arm64@2.7.3", "", { "os": "linux", "cpu": "arm64" }, "sha512-NdCDTfIcIo3dWjsiaAHlxu5gW61Ed/8maah1IAF/9E3EtX0aAHNiBMbuYLZaR4vRJ7BeVkYB6xKWRtdFLZ0y3g=="],
+ "turbo-linux-arm64": ["turbo-linux-arm64@2.8.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-z9pUa8ENFuHmadPfjEYMRWlXO82t1F/XBDx2XTg+cWWRZHf85FnEB6D4ForJn/GoKEEvwdPhFLzvvhOssom2ug=="],
- "turbo-windows-64": ["turbo-windows-64@2.7.3", "", { "os": "win32", "cpu": "x64" }, "sha512-7bVvO987daXGSJVYBoG8R4Q+csT1pKIgLJYZevXRQ0Hqw0Vv4mKme/TOjYXs9Qb1xMKh51Tb3bXKDbd8/4G08g=="],
+ "turbo-windows-64": ["turbo-windows-64@2.8.0", "", { "os": "win32", "cpu": "x64" }, "sha512-J6juRSRjmSErEqJCv7nVIq2DgZ2NHXqyeV8NQTFSyIvrThKiWe7FDOO6oYpuR06+C1NW82aoN4qQt4/gYvz25w=="],
- "turbo-windows-arm64": ["turbo-windows-arm64@2.7.3", "", { "os": "win32", "cpu": "arm64" }, "sha512-nTodweTbPmkvwMu/a55XvjMsPtuyUSC+sV7f/SR57K36rB2I0YG21qNETN+00LOTUW9B3omd8XkiXJkt4kx/cw=="],
+ "turbo-windows-arm64": ["turbo-windows-arm64@2.8.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-qarBZvCu6uka35739TS+y/3CBU3zScrVAfohAkKHG+So+93Wn+5tKArs8HrO2fuTaGou8fMIeTV7V5NgzCVkSQ=="],
"type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
@@ -1405,7 +1405,7 @@
"uc.micro": ["uc.micro@2.1.0", "", {}, "sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A=="],
- "ufo": ["ufo@1.6.1", "", {}, "sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA=="],
+ "ufo": ["ufo@1.6.3", "", {}, "sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q=="],
"uint8array-extras": ["uint8array-extras@1.5.0", "", {}, "sha512-rvKSBiC5zqCCiDZ9kAOszZcDvdAHwwIKJG33Ykj43OKcWsnmcBRL09YTU4nOeHZ8Y2a7l1MgTd08SBe9A8Qj6A=="],
@@ -1419,7 +1419,7 @@
"unified": ["unified@11.0.5", "", { "dependencies": { "@types/unist": "^3.0.0", "bail": "^2.0.0", "devlop": "^1.0.0", "extend": "^3.0.0", "is-plain-obj": "^4.0.0", "trough": "^2.0.0", "vfile": "^6.0.0" } }, "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA=="],
- "unifont": ["unifont@0.7.1", "", { "dependencies": { "css-tree": "^3.1.0", "ofetch": "^1.5.1", "ohash": "^2.0.11" } }, "sha512-0lg9M1cMYvXof8//wZBq6EDEfbwv4++t7+dYpXeS2ypaLuZJmUFYEwTm412/1ED/Wfo/wyzSu6kNZEr9hgRNfg=="],
+ "unifont": ["unifont@0.7.3", "", { "dependencies": { "css-tree": "^3.1.0", "ofetch": "^1.5.1", "ohash": "^2.0.11" } }, "sha512-b0GtQzKCyuSHGsfj5vyN8st7muZ6VCI4XD4vFlr7Uy1rlWVYxC3npnfk8MyreHxJYrz1ooLDqDzFe9XqQTlAhA=="],
"unist-util-find-after": ["unist-util-find-after@5.0.0", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ=="],
@@ -1443,7 +1443,7 @@
"universalify": ["universalify@0.1.2", "", {}, "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg=="],
- "unstorage": ["unstorage@1.17.3", "", { "dependencies": { "anymatch": "^3.1.3", "chokidar": "^4.0.3", "destr": "^2.0.5", "h3": "^1.15.4", "lru-cache": "^10.4.3", "node-fetch-native": "^1.6.7", "ofetch": "^1.5.1", "ufo": "^1.6.1" }, "peerDependencies": { "@azure/app-configuration": "^1.8.0", "@azure/cosmos": "^4.2.0", "@azure/data-tables": "^13.3.0", "@azure/identity": "^4.6.0", "@azure/keyvault-secrets": "^4.9.0", "@azure/storage-blob": "^12.26.0", "@capacitor/preferences": "^6.0.3 || ^7.0.0", "@deno/kv": ">=0.9.0", "@netlify/blobs": "^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0", "@planetscale/database": "^1.19.0", "@upstash/redis": "^1.34.3", "@vercel/blob": ">=0.27.1", "@vercel/functions": "^2.2.12 || ^3.0.0", "@vercel/kv": "^1.0.1", "aws4fetch": "^1.0.20", "db0": ">=0.2.1", "idb-keyval": "^6.2.1", "ioredis": "^5.4.2", "uploadthing": "^7.4.4" }, "optionalPeers": ["@azure/app-configuration", "@azure/cosmos", "@azure/data-tables", "@azure/identity", "@azure/keyvault-secrets", "@azure/storage-blob", "@capacitor/preferences", "@deno/kv", "@netlify/blobs", "@planetscale/database", "@upstash/redis", "@vercel/blob", "@vercel/functions", "@vercel/kv", "aws4fetch", "db0", "idb-keyval", "ioredis", "uploadthing"] }, "sha512-i+JYyy0DoKmQ3FximTHbGadmIYb8JEpq7lxUjnjeB702bCPum0vzo6oy5Mfu0lpqISw7hCyMW2yj4nWC8bqJ3Q=="],
+ "unstorage": ["unstorage@1.17.4", "", { "dependencies": { "anymatch": "^3.1.3", "chokidar": "^5.0.0", "destr": "^2.0.5", "h3": "^1.15.5", "lru-cache": "^11.2.0", "node-fetch-native": "^1.6.7", "ofetch": "^1.5.1", "ufo": "^1.6.3" }, "peerDependencies": { "@azure/app-configuration": "^1.8.0", "@azure/cosmos": "^4.2.0", "@azure/data-tables": "^13.3.0", "@azure/identity": "^4.6.0", "@azure/keyvault-secrets": "^4.9.0", "@azure/storage-blob": "^12.26.0", "@capacitor/preferences": "^6 || ^7 || ^8", "@deno/kv": ">=0.9.0", "@netlify/blobs": "^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0", "@planetscale/database": "^1.19.0", "@upstash/redis": "^1.34.3", "@vercel/blob": ">=0.27.1", "@vercel/functions": "^2.2.12 || ^3.0.0", "@vercel/kv": "^1 || ^2 || ^3", "aws4fetch": "^1.0.20", "db0": ">=0.2.1", "idb-keyval": "^6.2.1", "ioredis": "^5.4.2", "uploadthing": "^7.4.4" }, "optionalPeers": ["@azure/app-configuration", "@azure/cosmos", "@azure/data-tables", "@azure/identity", "@azure/keyvault-secrets", "@azure/storage-blob", "@capacitor/preferences", "@deno/kv", "@netlify/blobs", "@planetscale/database", "@upstash/redis", "@vercel/blob", "@vercel/functions", "@vercel/kv", "aws4fetch", "db0", "idb-keyval", "ioredis", "uploadthing"] }, "sha512-fHK0yNg38tBiJKp/Vgsq4j0JEsCmgqH58HAn707S7zGkArbZsVr/CwINoi+nh3h98BRCwKvx1K3Xg9u3VV83sw=="],
"util-deprecate": ["util-deprecate@1.0.2", "", {}, "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw=="],
@@ -1543,10 +1543,6 @@
"zwitch": ["zwitch@2.0.4", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="],
- "@asamuzakjp/css-color/lru-cache": ["lru-cache@11.2.4", "", {}, "sha512-B5Y16Jr9LB9dHVkh6ZevG+vAbOsNOYCX+sXvFWFu7B3Iz5mijW3zdbMyhsh8ANd2mSWBYdJgnqi+mL7/LrOPYg=="],
-
- "@asamuzakjp/dom-selector/lru-cache": ["lru-cache@11.2.4", "", {}, "sha512-B5Y16Jr9LB9dHVkh6ZevG+vAbOsNOYCX+sXvFWFu7B3Iz5mijW3zdbMyhsh8ANd2mSWBYdJgnqi+mL7/LrOPYg=="],
-
"@astrojs/language-server/prettier": ["prettier@3.7.4", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA=="],
"@astrojs/markdown-remark/shiki": ["shiki@3.19.0", "", { "dependencies": { "@shikijs/core": "3.19.0", "@shikijs/engine-javascript": "3.19.0", "@shikijs/engine-oniguruma": "3.19.0", "@shikijs/langs": "3.19.0", "@shikijs/themes": "3.19.0", "@shikijs/types": "3.19.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-77VJr3OR/VUZzPiStyRhADmO2jApMM0V2b1qf0RpfWya8Zr1PeZev5AEpPGAAKWdiYUtcZGBE4F5QvJml1PvWA=="],
@@ -1599,8 +1595,6 @@
"boxen/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
- "bun-types/@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
-
"cliui/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
"cliui/wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
@@ -1617,6 +1611,8 @@
"micromatch/picomatch": ["picomatch@2.3.1", "", {}, "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA=="],
+ "ofetch/ufo": ["ufo@1.6.1", "", {}, "sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA=="],
+
"parse-entities/@types/unist": ["@types/unist@2.0.11", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="],
"parse5/entities": ["entities@6.0.1", "", {}, "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g=="],
@@ -1633,6 +1629,8 @@
"svgo/commander": ["commander@11.1.0", "", {}, "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ=="],
+ "unstorage/chokidar": ["chokidar@5.0.0", "", { "dependencies": { "readdirp": "^5.0.0" } }, "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw=="],
+
"widest-line/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
"wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
@@ -1697,6 +1695,8 @@
"string-width/strip-ansi/ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
+ "unstorage/chokidar/readdirp": ["readdirp@5.0.0", "", {}, "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ=="],
+
"widest-line/string-width/emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
"widest-line/string-width/strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
diff --git a/package.json b/package.json
index 55a0b77..11ae5f4 100644
--- a/package.json
+++ b/package.json
@@ -32,20 +32,20 @@
"release": "changeset publish"
},
"devDependencies": {
- "@biomejs/biome": "^2.3.11",
+ "@biomejs/biome": "^2.3.13",
"@changesets/cli": "^2.29.8",
- "@types/bun": "1.3.5",
+ "@types/bun": "1.3.7",
"jsonc-parser": "^3.3.1",
"markdownlint-cli2": "^0.20.0",
- "turbo": "^2.7.3",
+ "turbo": "^2.8.0",
"typescript": "5.9.3",
"yaml": "2.8.2"
},
"engines": {
- "node": ">=22",
+ "node": ">=24",
"bun": ">=1.3.0"
},
- "packageManager": "bun@1.3.5",
+ "packageManager": "bun@1.3.7",
"workspaces": [
"apps/*",
"packages/*"
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 28e6eec..8026012 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -44,7 +44,7 @@
"@snake-evolution/github": "workspace:*",
"@snake-evolution/renderer": "workspace:*",
"@snake-evolution/types": "workspace:*",
- "@types/node": "^25.0.6",
+ "@types/node": "^25.1.0",
"commander": "^14.0.2"
},
"engines": {
diff --git a/packages/ui/package.json b/packages/ui/package.json
index a3002f8..ee63896 100644
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -16,12 +16,12 @@
},
"dependencies": {
"isomorphic-dompurify": "^2.35.0",
- "react": "^19.0.0"
+ "react": "^19.2.4"
},
"devDependencies": {
- "@types/react": "^19.2.8"
+ "@types/react": "^19.2.10"
},
"peerDependencies": {
- "react": "^18.0.0 || ^19.0.0"
+ "react": "^19.2.4"
}
}
From 7fb6b0cc58b0430699e518168fa154c44df372d1 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 10:12:38 +0100
Subject: [PATCH 06/29] chore(release): prepare for v1.2.4
---
README.md | 299 +++++++++------------------------
apps/api/CHANGELOG.md | 7 +
apps/api/package.json | 2 +-
apps/web/CHANGELOG.md | 7 +
apps/web/package.json | 2 +-
docs/ROADMAP_V2.md | 68 ++++++++
package.json | 2 +-
packages/cli/CHANGELOG.md | 6 +
packages/cli/package.json | 2 +-
packages/engine/CHANGELOG.md | 12 ++
packages/engine/package.json | 2 +-
packages/github/CHANGELOG.md | 12 ++
packages/github/package.json | 2 +-
packages/github/src/index.ts | 42 ++++-
packages/renderer/CHANGELOG.md | 12 ++
packages/renderer/package.json | 2 +-
packages/types/CHANGELOG.md | 7 +
packages/types/package.json | 2 +-
18 files changed, 258 insertions(+), 230 deletions(-)
create mode 100644 apps/api/CHANGELOG.md
create mode 100644 apps/web/CHANGELOG.md
create mode 100644 packages/engine/CHANGELOG.md
create mode 100644 packages/github/CHANGELOG.md
create mode 100644 packages/renderer/CHANGELOG.md
create mode 100644 packages/types/CHANGELOG.md
diff --git a/README.md b/README.md
index d1b4c96..4dadd9c 100644
--- a/README.md
+++ b/README.md
@@ -2,31 +2,17 @@
- Turn your GitHub contributions into an animated snake that devours them! -
-- Quick Start • - Themes • - GitHub Action • - CLI • - PvP Mode + Turn your GitHub contributions into an animated snake that devours them!
---- -
+
+
-
-
-
-
-
-
-
-
-
-
- Built with 🐍 by @miccy -
+ diff --git a/apps/api/CHANGELOG.md b/apps/api/CHANGELOG.md new file mode 100644 index 0000000..72884ca --- /dev/null +++ b/apps/api/CHANGELOG.md @@ -0,0 +1,7 @@ +# @snake-evolution/api + +## 1.3.0 + +### Minor Changes + +- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation. diff --git a/apps/api/package.json b/apps/api/package.json index bc0b6f6..76ffe2e 100644 --- a/apps/api/package.json +++ b/apps/api/package.json @@ -1,6 +1,6 @@ { "name": "@snake-evolution/api", - "version": "1.2.4", + "version": "1.3.0", "private": true, "type": "module", "scripts": { diff --git a/apps/web/CHANGELOG.md b/apps/web/CHANGELOG.md new file mode 100644 index 0000000..4554763 --- /dev/null +++ b/apps/web/CHANGELOG.md @@ -0,0 +1,7 @@ +# @snake-evolution/web + +## 1.3.0 + +### Minor Changes + +- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation. diff --git a/apps/web/package.json b/apps/web/package.json index 9215af3..361c18a 100644 --- a/apps/web/package.json +++ b/apps/web/package.json @@ -1,7 +1,7 @@ { "name": "@snake-evolution/web", "type": "module", - "version": "1.2.4", + "version": "1.3.0", "private": true, "scripts": { "dev": "astro dev", diff --git a/docs/ROADMAP_V2.md b/docs/ROADMAP_V2.md index db73bf5..b99eb67 100644 --- a/docs/ROADMAP_V2.md +++ b/docs/ROADMAP_V2.md @@ -12,12 +12,14 @@ ## 📍 Current Position (v1.2.4) ### Market Context + - **18,000+ GitHub stars** on contribution manipulation tools - **5,500+ stars** on legitimate visualization tools - **Growing demand** for profile customization - **Hiring managers** increasingly skeptical of fake graphs ### Our Opportunity + ``` gitfiti (2012): Pixel art, playful, 8.3K ⭐ github-activity: Fake automation, 3.7K ⭐, SKETCHY @@ -26,6 +28,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨ ``` ### What's Live ✅ + - CLI tool (`npx @snake-evolution/cli@latest`) - GitHub Action (marketplace) - 7 themes (6 SVG + Glass theme for GIF) @@ -33,6 +36,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨ - Monorepo architecture ### Critical Gaps 🚨 + - ❌ GIF output (80% ready, not shipped) - ❌ Interactive playground - ❌ Ethical positioning in marketing @@ -46,9 +50,11 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨ **Goal:** Ship GIF, complete v1 vision, establish ethical positioning ### Priority 1: GIF Implementation (Week 1) + **Status:** 80% complete, needs final push **Tasks:** + - [ ] Complete `packages/renderer/src/gif.ts` integration - [ ] Test Glass theme rendering with blur effects - [ ] CLI `--format gif` option working @@ -57,12 +63,14 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨ - [ ] File size optimization (<1MB) **Success Metrics:** + - Glass theme renders correctly - GIF generation time <5s - File size <1MB for full year - Zero regressions in SVG output **Acceptance Criteria:** + ```bash # These must work: npx @snake-evolution/cli generate -u octocat --format gif @@ -84,6 +92,7 @@ npx @snake-evolution/cli generate -u octocat -t glass --format gif **A) README.md Updates:** Add prominent badge section: + ```markdown ## ✅ The Ethical Choice @@ -121,6 +130,7 @@ New: > hiring managers. No fake commits, no manipulation, just fun." **Success Metrics:** + - Trust indicators in README - "Ethical" mentioned prominently - Comparison table vs manipulation tools @@ -162,6 +172,7 @@ export default function PlaygroundPreview() { ``` **Success Metrics:** + - Live preview working - Color customization functional - Download generates actual files @@ -176,6 +187,7 @@ export default function PlaygroundPreview() { ### Week 1-2: Core Playground **Features:** + - [ ] **Username autocomplete** - GitHub API integration - [ ] **Theme selector** - All 7 themes + custom - [ ] **Color picker UI** - HSL sliders for each element: @@ -197,12 +209,14 @@ export default function PlaygroundPreview() { - Share link **Technical Stack:** + - Astro + React islands - TailwindCSS 4 for UI - Canvas API for preview - Web Workers for heavy computation **Success Metrics:** + - Preview update <100ms - Smooth 60fps animations - Mobile responsive @@ -231,12 +245,14 @@ const schema = { ``` **Features:** + - [ ] Save custom themes locally - [ ] Theme history (last 10) - [ ] Export/import themes - [ ] Offline-capable playground **Why Evolu:** + - Privacy-first (data stays local) - Works offline - No auth required for basic usage @@ -247,6 +263,7 @@ const schema = { **Community Showcase:** **Features:** + - [ ] Submit snake to public gallery - [ ] Browse community snakes - [ ] Upvote/favorite system @@ -256,6 +273,7 @@ const schema = { **Backend: Appwrite** Collections: + ``` snakes: - id @@ -275,6 +293,7 @@ votes: ``` **Social Features:** + - [ ] "Snake of the Week" badge - [ ] Share to Twitter with OG image - [ ] Embed code for blogs @@ -287,6 +306,7 @@ votes: **Goal:** Sustainable income to fund development ### Free Tier + ✅ All current features ✅ 7 pre-built themes ✅ Basic color customization @@ -296,6 +316,7 @@ votes: ### Sponsor Tier ($5/month) **Exclusive Features:** + - 🎨 **Unlimited custom themes** - Save unlimited themes - 🌈 **Advanced color editor** - HSL/gradient controls - ⚡ **Priority rendering** - Skip queue (when web service) @@ -313,6 +334,7 @@ votes: **A) GitHub Sponsors Setup** Tiers: + ```yaml $5/month - Supporter: - Sponsor badge @@ -352,12 +374,14 @@ if (tier === 'free') { **C) Marketing Page** `/pricing`: + - Compare tiers - Testimonials from sponsors - "Support open source" messaging - Clear value proposition **Success Metrics:** + - 20 sponsors by end of Q1 - $100 MRR (Monthly Recurring Revenue) - 5% conversion rate (free → sponsor) @@ -375,6 +399,7 @@ if (tier === 'free') { > First to eat all contributions (or highest score) wins. **Rounds System:** + ``` Round 1: Normal speed, 3 min limit Round 2: 1.5x speed, 2 min limit @@ -383,6 +408,7 @@ Finals: 3x speed, 30 sec limit ``` **Power-ups with Cooldowns:** + - 🔄 **Shrink** (10s cooldown) - Lose 3 body segments - ⚡ **Speed Boost** (20s cooldown) - 2x speed for 5s - 🌀 **Teleport** (30s cooldown) - Random safe position @@ -390,6 +416,7 @@ Finals: 3x speed, 30 sec limit - 🎯 **Vision** (15s cooldown) - Highlight highest value squares **Scoring:** + ```javascript base_points = contribution_level (1-5) round_multiplier = [1, 1.5, 2, 3, 5][current_round] @@ -428,6 +455,7 @@ setInterval(() => { ``` **Latency Optimization:** + - Client-side prediction - Server reconciliation - Rollback on desync @@ -453,6 +481,7 @@ async function aiMove(difficulty: Difficulty) { ``` **Anti-Cheat:** + - Server-authoritative movement - Input validation - Rate limiting @@ -461,6 +490,7 @@ async function aiMove(difficulty: Difficulty) { ### Leaderboards **Categories:** + - Global (all time) - Weekly - Monthly @@ -468,6 +498,7 @@ async function aiMove(difficulty: Difficulty) { - By company **Rewards:** + - Top 10: Special badge - Top 100: Custom title - Monthly winner: Featured on homepage @@ -490,6 +521,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Revised Milestones **Q1 2025 Goals:** + - ✅ Ship v1.3.0 with GIF (Jan 15) - ✅ Launch interactive playground (Feb 1) - ✅ Ethical positioning complete (Feb 1) @@ -499,12 +531,14 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments - 🎯 **20 GitHub Sponsors** **Q2 2025 Goals:** + - Premium tier launched - 50+ sponsors - 1,000+ community themes - Featured on GitHub Explore **Q3-Q4 2025 Goals:** + - PvP beta → full release - 10,000+ stars - 500+ sponsors @@ -550,6 +584,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Direct Competitors **Platane/snk (Original):** + - ✅ 7K+ stars, established - ✅ Simple, works well - ❌ No customization @@ -557,6 +592,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments - ❌ No community features **Our Advantages:** + - ✅ Full color customization - ✅ Growing snake mechanic - ✅ Interactive playground @@ -564,12 +600,14 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments - ✅ Premium features **github-contributions-chart (5.5K stars):** + - ✅ Shows full history - ❌ Static image only - ❌ No animation - ❌ No customization **Our Advantages:** + - ✅ Animated (way cooler) - ✅ Interactive - ✅ Gamification @@ -577,10 +615,12 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Manipulation Tools (TO AVOID) **gitfiti (8.3K stars):** + - Category: Playful pixel art - Ethics: Gray area, but clearly art **github-activity-generator (3.7K stars):** + - Category: Fake activity - Ethics: Sketchy, against ToS @@ -596,6 +636,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments **Risk:** GIF rendering too slow **Mitigation:** + - Benchmark early - Frame sampling - Web Workers @@ -603,12 +644,14 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments **Risk:** Playground performance on mobile **Mitigation:** + - Progressive enhancement - Reduced quality mode - Service Worker caching **Risk:** Appwrite cost at scale **Mitigation:** + - Self-hosted option - Cloudflare CDN - Aggressive caching @@ -617,6 +660,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments **Risk:** Low sponsor conversion **Mitigation:** + - Clear value proposition - Social proof (testimonials) - Trial period (7 days) @@ -624,6 +668,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments **Risk:** Comparison to "fake activity" tools **Mitigation:** + - Aggressive ethical positioning - Clear differentiation - Trust indicators @@ -631,6 +676,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments **Risk:** Competition from forks **Mitigation:** + - Keep innovating (playground, PvP) - Build community moat - Premium features @@ -643,6 +689,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Content Marketing **Blog Posts:** + 1. "Why I Built Snake Evolution (And Why It's Ethical)" 2. "Behind the Scenes: How Snake Pathfinding Works" 3. "The Problem with GitHub Contribution Manipulation" @@ -650,12 +697,14 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments 5. "Building a Local-First App with Evolu" **Videos:** + 1. Product demo (60s) 2. Playground tutorial (5 min) 3. "Ethical vs Fake" comparison (3 min) 4. Theme creation tutorial (10 min) **Social Media:** + - Twitter: Daily snake showcases - Dev.to: Technical deep dives - Reddit: r/github, r/programming @@ -664,6 +713,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Community Building **Discord Server:** + - #showcase - User snakes - #themes - Theme sharing - #support - Help channel @@ -671,12 +721,14 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments - #dev - Development updates **GitHub Discussions:** + - Ideas & Feature Requests - Show & Tell - Q&A - Announcements **Events:** + - Weekly "Snake of the Week" - Monthly theme contest - Quarterly PvP tournament (when ready) @@ -688,6 +740,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Before v2.0 **High Priority:** + - [ ] Reduce bundle size (400KB → <300KB) - [ ] Add error boundaries in React - [ ] Implement proper logging @@ -695,12 +748,14 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments - [ ] Write integration tests **Medium Priority:** + - [ ] Refactor engine to use Web Workers - [ ] Implement caching layer - [ ] Optimize SVG output - [ ] Add analytics (privacy-friendly) **Low Priority:** + - [ ] Migrate to Biome 2.0 when stable - [ ] Update to latest Astro - [ ] Consolidate types package @@ -712,6 +767,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Before v2.0 Launch **User Docs:** + - [ ] Getting started guide - [ ] Playground tutorial - [ ] Theme creation guide @@ -720,12 +776,14 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments - [ ] Video tutorials **Developer Docs:** + - [ ] Architecture overview - [ ] Contributing guide - [ ] Theme development - [ ] Plugin system (future) **Marketing:** + - [ ] Press kit - [ ] Brand guidelines - [ ] Screenshots library @@ -738,21 +796,25 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Before Starting v1.3 **Decision 1: GIF vs SVG Default** + - Option A: Keep SVG as default (backward compatible) - Option B: Make GIF default (better compatibility) - **Recommendation:** Keep SVG, add clear GIF benefits messaging **Decision 2: Color Customization Scope** + - Option A: Full HSL control (complex UI) - Option B: Preset palettes + limited tweaking - **Recommendation:** Start with B, add A for sponsors **Decision 3: Monetization Timing** + - Option A: Launch with v2.0 (February) - Option B: Wait until v2.1 (March/April) - **Recommendation:** Launch with v2.0, gives time to iterate **Decision 4: Evolu vs Traditional DB** + - Option A: Full Evolu (learning curve, offline-first) - Option B: Hybrid (Appwrite for public, Evolu for local) - **Recommendation:** Hybrid approach @@ -764,6 +826,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Weekly Check-ins **Metrics to Track:** + - npm downloads (weekly) - GitHub stars (daily) - Action usage (weekly) @@ -773,6 +836,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Monthly Reviews **Questions:** + 1. Are we hitting milestones? 2. What's working / not working? 3. Should we pivot anything? @@ -782,6 +846,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Quarterly Planning **Focus:** + - Review Q roadmap - Adjust based on learnings - Plan next Q priorities @@ -792,6 +857,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ## 💡 Future Ideas (Post v3.0) **Parking Lot:** + - Email signature mode (animated GIF) - Custom text mode ("your-name.dev" eaten by snake) - Mobile app (React Native) @@ -816,6 +882,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments ### Tech Stack Summary **Current:** + - Runtime: Bun 1.3.5 - Monorepo: Turborepo - Language: TypeScript 5.9 @@ -823,6 +890,7 @@ v3.1.0 📋 Q4 2025 - PvP full release + tournaments - Testing: Vitest **Planned (v2.0+):** + - Frontend: Astro + React 19 - Styling: TailwindCSS 4 - Database: Evolu (local) + Appwrite (cloud) diff --git a/package.json b/package.json index 11ae5f4..ff842e8 100644 --- a/package.json +++ b/package.json @@ -19,7 +19,7 @@ "build:cli": "turbo run build --filter=@snake-evolution/cli", "test": "turbo run test", "lint": "biome check . && markdownlint-cli2 '*.md' 'docs/**/*.md' '.github/**/*.md' 'apps/*/src/**/*.md' 'apps/*/*.md' 'packages/*/*.md' 'packages/*/src/**/*.md' 'docker/*.md' 'scripts/*.md' '__tests__/*.md' --config .markdownlint.jsonc", - "lint:fix": "biome check --fix --write . && markdownlint-cli2 --fix '*.md' 'docs/**/*.md' '.github/**/*.md' 'apps/*/src/**/*.md' 'apps/*/*.md' 'packages/*/*.md' 'packages/*/src/**/*.md' 'docker/*.md' 'scripts/*.md' '__tests__/*.md' --config .markdownlint.jsonc", + "lint:fix": "biome check --write . && markdownlint-cli2 --fix '*.md' 'docs/**/*.md' '.github/**/*.md' 'apps/*/src/**/*.md' 'apps/*/*.md' 'packages/*/*.md' 'packages/*/src/**/*.md' 'docker/*.md' 'scripts/*.md' '__tests__/*.md' --config .markdownlint.jsonc", "typecheck": "tsc --noEmit && turbo run type-check", "check": "bun run lint && bun run typecheck", "fix": "bun run lint:fix", diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md index 2b0c31c..e2d7489 100644 --- a/packages/cli/CHANGELOG.md +++ b/packages/cli/CHANGELOG.md @@ -1,5 +1,11 @@ # @snake-evolution/cli +## 1.3.0 + +### Minor Changes + +- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation. + ## 1.2.4 ### Security diff --git a/packages/cli/package.json b/packages/cli/package.json index 8026012..6acefe2 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@snake-evolution/cli", - "version": "1.2.4", + "version": "1.3.0", "description": "Generate animated snake eating your GitHub contributions", "license": "MIT", "author": "Miccy
Date: Thu, 29 Jan 2026 10:19:31 +0100
Subject: [PATCH 07/29] fix(ci): add missing scripts format:check and
type-check
---
package.json | 3 +++
1 file changed, 3 insertions(+)
diff --git a/package.json b/package.json
index ff842e8..5ac6fcd 100644
--- a/package.json
+++ b/package.json
@@ -20,7 +20,10 @@
"test": "turbo run test",
"lint": "biome check . && markdownlint-cli2 '*.md' 'docs/**/*.md' '.github/**/*.md' 'apps/*/src/**/*.md' 'apps/*/*.md' 'packages/*/*.md' 'packages/*/src/**/*.md' 'docker/*.md' 'scripts/*.md' '__tests__/*.md' --config .markdownlint.jsonc",
"lint:fix": "biome check --write . && markdownlint-cli2 --fix '*.md' 'docs/**/*.md' '.github/**/*.md' 'apps/*/src/**/*.md' 'apps/*/*.md' 'packages/*/*.md' 'packages/*/src/**/*.md' 'docker/*.md' 'scripts/*.md' '__tests__/*.md' --config .markdownlint.jsonc",
+ "format": "biome format --write .",
+ "format:check": "biome format .",
"typecheck": "tsc --noEmit && turbo run type-check",
+ "type-check": "bun run typecheck",
"check": "bun run lint && bun run typecheck",
"fix": "bun run lint:fix",
"clean": "turbo run clean && rm -rf .turbo node_modules",
From 76a7203d80e9503a08a86ff0e2f49d80cea6ee8b Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 10:21:46 +0100
Subject: [PATCH 08/29] fix(ci): bump bun to 1.3.7 to match package.json
---
.github/workflows/ci.yml | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index b169bd7..42f4dec 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,7 +21,7 @@ jobs:
- uses: oven-sh/setup-bun@v2
with:
- bun-version: 1.3.5
+ bun-version: 1.3.7
- name: Cache Bun dependencies
uses: actions/cache@v4
@@ -55,7 +55,7 @@ jobs:
- uses: oven-sh/setup-bun@v2
with:
- bun-version: 1.3.5
+ bun-version: 1.3.7
- name: Cache Bun dependencies
uses: actions/cache@v4
From 7e3a8f485ddc614c15e74d7f9218a9c8f294a1ce Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 10:22:59 +0100
Subject: [PATCH 09/29] fix(action): bump bun version to 1.3.7 to match project
---
action.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/action.yml b/action.yml
index a87288e..4a1ab62 100644
--- a/action.yml
+++ b/action.yml
@@ -41,7 +41,7 @@ runs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
- bun-version: 1.3.5
+ bun-version: 1.3.7
- name: Install dependencies
shell: bash
From 758afe8671ececd4277cc36a32f7a7b55a9667c4 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 10:24:05 +0100
Subject: [PATCH 10/29] fix(cli): bump engine requirements to node >=24 and bun
>=1.3.7
---
packages/cli/package.json | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 6acefe2..981c953 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -48,7 +48,8 @@
"commander": "^14.0.2"
},
"engines": {
- "node": ">=22"
+ "node": ">=24",
+ "bun": ">=1.3.7"
},
"publishConfig": {
"access": "public"
From fdd4407de24ec3fecc8215a872b4120070d69397 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 12:16:29 +0100
Subject: [PATCH 11/29] docs: Consolidate roadmap documentation into
`apps/web/src/content` and remove old roadmap and architecture files.
---
.../docs}/documentation.test.ts | 0
.../content/docs/guides/gif-implementation.md | 49 +-
apps/web/src/content/docs/roadmap.md | 127 +++
.../src/content/docs/testing/test-summary.md | 5 +-
.../docs/testing/unit-tests-generated.md | 21 +-
docs/ARCHITECTURE.md | 85 --
docs/ROADMAP.md | 259 -----
docs/ROADMAP_V2.md | 904 ------------------
8 files changed, 170 insertions(+), 1280 deletions(-)
rename {docs/__tests__ => __tests__/docs}/documentation.test.ts (100%)
rename docs/GIF_IMPLEMENTATION.md => apps/web/src/content/docs/guides/gif-implementation.md (82%)
create mode 100644 apps/web/src/content/docs/roadmap.md
rename docs/testing/TEST_SUMMARY.md => apps/web/src/content/docs/testing/test-summary.md (98%)
rename docs/testing/UNIT_TESTS_GENERATED.md => apps/web/src/content/docs/testing/unit-tests-generated.md (94%)
delete mode 100644 docs/ARCHITECTURE.md
delete mode 100644 docs/ROADMAP.md
delete mode 100644 docs/ROADMAP_V2.md
diff --git a/docs/__tests__/documentation.test.ts b/__tests__/docs/documentation.test.ts
similarity index 100%
rename from docs/__tests__/documentation.test.ts
rename to __tests__/docs/documentation.test.ts
diff --git a/docs/GIF_IMPLEMENTATION.md b/apps/web/src/content/docs/guides/gif-implementation.md
similarity index 82%
rename from docs/GIF_IMPLEMENTATION.md
rename to apps/web/src/content/docs/guides/gif-implementation.md
index d69191b..af2bc78 100644
--- a/docs/GIF_IMPLEMENTATION.md
+++ b/apps/web/src/content/docs/guides/gif-implementation.md
@@ -1,3 +1,8 @@
+---
+title: GIF Implementation Guide
+description: Technical guide for implementing GIF output support.
+---
+
# GIF Implementation Guide (v1.3.0)
Technical documentation for implementing GIF output format in Snake Evolution.
@@ -49,10 +54,10 @@ Install in `packages/renderer`:
bun add @resvg/resvg-js gifenc
```
-| Package | Version | Size | Notes |
-|---------|---------|------|-------|
-| `@resvg/resvg-js` | ^2.6.2 | ~3MB | Rust/WASM, Bun compatible since 0.8.1 |
-| `gifenc` | ^1.0.3 | 9KB | Pure JS, no deps |
+| Package | Version | Size | Notes |
+| ----------------- | ------- | ---- | ------------------------------------- |
+| `@resvg/resvg-js` | ^2.6.2 | ~3MB | Rust/WASM, Bun compatible since 0.8.1 |
+| `gifenc` | ^1.0.3 | 9KB | Pure JS, no deps |
## Implementation
@@ -206,10 +211,10 @@ export function validateOutputFormat(format: string, theme: string) {
### File Size
| Frames | Raw GIF | With Sampling (2x) |
-|--------|---------|-------------------|
-| 100 | ~300 KB | ~150 KB |
-| 300 | ~800 KB | ~400 KB |
-| 500 | ~1.3 MB | ~650 KB |
+| ------ | ------- | ------------------ |
+| 100 | ~300 KB | ~150 KB |
+| 300 | ~800 KB | ~400 KB |
+| 500 | ~1.3 MB | ~650 KB |
### Encoding Speed
@@ -225,14 +230,14 @@ export function validateOutputFormat(format: string, theme: string) {
## Why Not Platane's Approach
-| Platane (2021) | Snake Evolution (2025) |
-|----------------|------------------------|
-| `node-canvas` | `@resvg/resvg-js` |
-| Native cairo deps | Pure WASM |
-| `gif-encoder-2` | `gifenc` |
-| `gifsicle` binary | Not needed |
-| Complex setup | `bun add` and done |
-| Node.js only | Bun + Node + Edge |
+| Platane (2021) | Snake Evolution (2025) |
+| ----------------- | ---------------------- |
+| `node-canvas` | `@resvg/resvg-js` |
+| Native cairo deps | Pure WASM |
+| `gif-encoder-2` | `gifenc` |
+| `gifsicle` binary | Not needed |
+| Complex setup | `bun add` and done |
+| Node.js only | Bun + Node + Edge |
## Testing
@@ -254,12 +259,12 @@ bun test packages/renderer/src/gif.test.ts
Relevant features for GIF implementation:
-| Feature | Use |
-|---------|-----|
-| WASM support | resvg-js runs natively |
-| Buffer API | GIF output handling |
-| `Bun.stringWidth` | Progress bar (future) |
-| S3 client | Store GIFs in cloud (API) |
+| Feature | Use |
+| ----------------- | ------------------------- |
+| WASM support | resvg-js runs natively |
+| Buffer API | GIF output handling |
+| `Bun.stringWidth` | Progress bar (future) |
+| S3 client | Store GIFs in cloud (API) |
## References
diff --git a/apps/web/src/content/docs/roadmap.md b/apps/web/src/content/docs/roadmap.md
new file mode 100644
index 0000000..df612c2
--- /dev/null
+++ b/apps/web/src/content/docs/roadmap.md
@@ -0,0 +1,127 @@
+---
+title: Roadmap
+description: Strategic roadmap and vision for Snake Evolution.
+---
+
+# 🗺️ Snake Evolution Roadmap
+
+> **Updated:** January 2025
+> **Strategic Focus:** Ethical positioning + Interactive playground + Monetization
+
+## 🎯 Vision
+
+**Make Snake Evolution the #1 ethical and fun way to visualize GitHub contributions** - from simple animations to competitive PvP battles. Position as "The Legitimate Alternative" in a market flooded with manipulation tools.
+
+---
+
+## 📍 Current Position (v1.3.0)
+
+### Market Context
+
+- **18,000+ GitHub stars** on contribution manipulation tools
+- **5,500+ stars** on legitimate visualization tools
+- **Growing demand** for profile customization
+- **Hiring managers** increasingly skeptical of fake graphs
+
+### Our Opportunity
+
+```text
+gitfiti (2012): Pixel art, playful, 8.3K ⭐
+github-activity: Fake automation, 3.7K ⭐, SKETCHY
+Snake Evolution: ✨ Real data + Gamification + Customization ✨
+ TARGET: 10K ⭐ in 6 months
+```
+
+### What's Live ✅
+
+- CLI tool (`npx @snake-evolution/cli@latest`)
+- GitHub Action (marketplace)
+- 7 themes (6 SVG + Glass theme for GIF)
+- Smart pathfinding
+- Monorepo architecture
+- **v1.3.0:** GIF Output & Glass Theme support
+
+---
+
+## 🚀 Phase 1: v1.3.0 - Foundation Completion (January 2025)
+
+**Goal:** Ship GIF, complete v1 vision, establish ethical positioning
+
+### Priority 1: GIF Implementation
+
+**Status:** Shipping in v1.3.0
+
+- ✅ Glass theme fully supported
+- ✅ CLI `--format gif` option
+- ✅ GitHub Action supports GIF output
+- ✅ Performance benchmarks (<5s)
+
+### Priority 2: Ethical Positioning
+
+**Strategic Message:**
+> "Snake Evolution shows your REAL GitHub activity in a fun way.
+> No fake commits. No manipulation. Just your actual work, animated."
+
+---
+
+## 🎨 Phase 2: v2.0 - Interactive Web Platform (Q1 2025)
+
+**Goal:** Full-featured playground with save/share functionality
+
+### Core Features
+
+- [ ] **Username autocomplete** - GitHub API integration
+- [ ] **Theme selector** - All 7 themes + custom
+- [ ] **Color picker UI** - HSL sliders for each element
+- [ ] **Live preview** - Real-time canvas rendering (60fps)
+- [ ] **Export options:** SVG, GIF, Share link
+
+### Technical Stack
+
+- Astro + React islands
+- TailwindCSS 4 for UI
+- Canvas API for preview
+- Web Workers for heavy computation
+
+### Evolu Integration (Local-First)
+
+- Privacy-first (data stays local)
+- Works offline
+- No auth required for basic usage
+
+---
+
+## 💰 Phase 2.5: Monetization Strategy (Q1 2025)
+
+**Goal:** Sustainable income to fund development.
+
+### Tiers
+
+- **Free Tier:** All current features, 7 themes, SVG/GIF export.
+- **Sponsor Tier ($5/month):** Unlimited custom themes, advanced color editor, priority feedback.
+
+---
+
+## 🎮 Phase 3: v3.0 - PvP Mode (Q2-Q3 2025)
+
+**Core Concept:**
+> Two players compete on the same contribution graph.
+> First to eat all contributions (or highest score) wins.
+
+**Game Modes:**
+1. **Quick Match** (3 rounds)
+2. **Ranked** (ELO rating)
+3. **Team Battle** (2v2)
+
+---
+
+## 📅 Revised Timeline
+
+```text
+v1.2.4 ✅ Dec 2024 - Basic functionality
+v1.3.0 ✅ Jan 2025 - GIF + Ethical positioning + Color preview
+v1.4.0 📋 Feb 2025 - Performance optimization + bug fixes
+v2.0.0 📋 Mar 2025 - Full playground launch
+v2.1.0 📋 Apr 2025 - Gallery + social features
+v3.0.0 📋 Q3 2025 - PvP Mode beta
+```
diff --git a/docs/testing/TEST_SUMMARY.md b/apps/web/src/content/docs/testing/test-summary.md
similarity index 98%
rename from docs/testing/TEST_SUMMARY.md
rename to apps/web/src/content/docs/testing/test-summary.md
index e9706a1..77af3f6 100644
--- a/docs/testing/TEST_SUMMARY.md
+++ b/apps/web/src/content/docs/testing/test-summary.md
@@ -1,4 +1,7 @@
-# Comprehensive Unit Tests Generated
+---
+title: Test Summary
+description: Comprehensive summary of unit tests related to v1.3.0 changes.
+---
This document summarizes the thorough unit tests generated for the changes in this branch.
diff --git a/docs/testing/UNIT_TESTS_GENERATED.md b/apps/web/src/content/docs/testing/unit-tests-generated.md
similarity index 94%
rename from docs/testing/UNIT_TESTS_GENERATED.md
rename to apps/web/src/content/docs/testing/unit-tests-generated.md
index 014d56d..2897ee2 100644
--- a/docs/testing/UNIT_TESTS_GENERATED.md
+++ b/apps/web/src/content/docs/testing/unit-tests-generated.md
@@ -1,4 +1,7 @@
-# Comprehensive Unit Tests Generated for Snake Evolution
+---
+title: Unit Tests Generated
+description: Detailed breakdown of unit tests generated for v1.3.0.
+---
## Summary
@@ -164,14 +167,14 @@ Generated **80+ comprehensive unit tests** for all code changes in this branch,
## Test Statistics
-| Metric | Value |
-|--------|-------|
-| **Total New Tests** | ~80 |
-| **Lines of Test Code Added** | ~885 |
-| **Security Tests** | 20+ |
-| **Edge Case Tests** | 25+ |
-| **Integration Tests** | 15+ |
-| **Files Enhanced** | 4 |
+| Metric | Value |
+| ---------------------------- | ----- |
+| **Total New Tests** | ~80 |
+| **Lines of Test Code Added** | ~885 |
+| **Security Tests** | 20+ |
+| **Edge Case Tests** | 25+ |
+| **Integration Tests** | 15+ |
+| **Files Enhanced** | 4 |
---
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
deleted file mode 100644
index 12200b7..0000000
--- a/docs/ARCHITECTURE.md
+++ /dev/null
@@ -1,85 +0,0 @@
-# Architecture
-
-> Technical architecture documentation for Snake Evolution
-
-## Overview
-
-Snake Evolution is a monorepo project that transforms GitHub contribution graphs into animated snake visualizations.
-
-> ⚠️ **Note:** This document describes both current implementation and planned architecture. Items marked with 🚧 are not yet implemented.
-
-## Tech Stack
-
-| Category | Technology | Status | Purpose |
-|----------|------------|--------|---------|
-| Runtime | Bun | ✅ | JavaScript runtime |
-| Monorepo | Turborepo | ✅ | Build system and task orchestration |
-| CLI | Commander | ✅ | Command-line interface |
-| Linting | Biome | ✅ | Lint and format |
-| Types | TypeScript 5.9 | ✅ | Type safety |
-| Web | Astro + Starlight | 🚧 | Website and documentation |
-| UI | React 19 | 🚧 | Interactive components |
-| Styling | Tailwind CSS 4 | 🚧 | Utility-first CSS |
-| Database | Evolu | 🚧 | Local-first with CRDT sync |
-| API | ElysiaJS | 🚧 | Type-safe API server |
-| Backend | Appwrite | 🚧 | Backend-as-a-Service |
-
-## Project Structure
-
-```
-snake-evolution/
-├── apps/
-│ ├── web/ # 🚧 Astro + Starlight (scaffolded)
-│ ├── api/ # 🚧 ElysiaJS API server (scaffolded)
-│ └── docs/ # 🚧 Documentation site
-├── packages/
-│ ├── types/ # ✅ Shared TypeScript types
-│ ├── ui/ # 🚧 Shared React components
-│ ├── engine/ # ✅ Snake game logic
-│ ├── renderer/ # ✅ SVG rendering
-│ ├── github/ # ✅ GitHub API client
-│ ├── cli/ # ✅ Command-line interface
-│ ├── biome-config/ # ✅ Shared Biome config
-│ └── typescript-config/ # ✅ Shared TS configs
-├── docker/ # 🚧 Docker setup
-└── docs/ # Technical documentation
-```
-
-## Current Data Flow (v1.0)
-
-```
-GitHub API → packages/github → packages/engine → packages/renderer → SVG Output
-```
-
-## Planned Data Flow (v2.0+)
-
-```
-GitHub API → packages/github → packages/engine → packages/renderer → Output (SVG; GIF planned)
- ↓
- Evolu (local-first storage)
- ↓
- Appwrite (sync & multiplayer)
-```
-
-## Key Concepts
-
-### Snake Engine (✅ Implemented)
-
-The snake engine implements:
-
-- Priority-based pathfinding (hunts high-value contributions first)
-- Growth mechanics based on contribution intensity
-- Animation frame generation
-
-### Local-First Architecture (🚧 Planned)
-
-Using Evolu for local-first data storage with:
-
-- Offline capability
-- End-to-end encryption
-- CRDT-based conflict resolution
-- Cross-device sync
-
----
-
-*See [ROADMAP.md](./ROADMAP.md) for implementation timeline.*
diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
deleted file mode 100644
index 4ab5a15..0000000
--- a/docs/ROADMAP.md
+++ /dev/null
@@ -1,259 +0,0 @@
-# 🗺️ Roadmap
-
-## Vision
-
-Make Snake Evolution the most fun way to visualize GitHub contributions - from solo animations to competitive PvP battles!
-
----
-
-## ✅ v1.2.4 - Current Release (December 2025)
-
-**What's Live:**
-
-- ✅ CLI tool with npm support (`npx @snake-evolution/cli@latest`)
-- ✅ 7 themes: github-light, github-dark, ocean, sunset, neon-gamer, cypherpunk, glass (GIF only)
-- ✅ GitHub Action for automated generation
-- ✅ Smart pathfinding (priority-based hunting - eats darkest squares first)
-- ✅ Smooth SMIL animations with visual gradient
-- ✅ Works for any GitHub user
-- ✅ Zero-install via npx/bunx
-- ✅ Monorepo architecture (Turborepo + Bun 1.3.5)
-- ✅ Consolidated scripts (30 → 21)
-- ✅ Professional README files for all packages
-
----
-
-## 🚧 v1.3.0 - GIF Output & Glass Theme (January 2025)
-
-**Focus:** GIF format, Glass theme, Bun 1.3.5 integration
-
-### Features
-
-- [ ] **GIF output format** (`--format gif`) - Enables embedding everywhere
-- [ ] **Glass theme fully supported** - Pre-rendered blur effects in GIF
-- [ ] **CLI progress indicator** - Frame rendering progress
-- [ ] **Frame sampling** - Smaller files for large animations
-
-### Technical Implementation (Research Dec 2025)
-
-**Architecture:**
-
-```
-Static SVG → resvg-js (Rust/WASM) → gifenc (pure JS) → GIF
-```
-
-**Dependencies:**
-
-| Library | Version | Purpose | Bun 1.3.5 |
-|---------|---------|---------|-----------|
-| `@resvg/resvg-js` | 2.6.2 | SVG → PNG pixels (WASM) | ✅ Full |
-| `gifenc` | 1.0.3 | PNG → GIF encoding | ✅ Full |
-
-**Why not Platane's approach:**
-
-- ❌ `node-canvas` requires native cairo compilation
-- ❌ `gifsicle` requires binary installation
-- ✅ Our stack = zero native deps, works in Bun
-
-**Glass Theme:**
-
-- SVG blur filters too heavy for browsers
-- GIF pre-renders blur → zero runtime cost
-- Works everywhere: email, README, social media
-
-### Bun 1.3.5 Features We Can Use
-
-| Feature | Use Case |
-|---------|----------|
-| `CompressionStream` | Compressed GIF responses in API |
-| Built-in Redis | GitHub API response caching |
-| S3 support | Store generated GIFs |
-| `Bun.Terminal` | Rich CLI progress display |
-| Compile-time flags | Dev/prod build optimization |
-
----
-
-
-## 🎮 v2.0 - Interactive Web Playground (Q2 2025)
-
-**Focus:** Web app with live customization
-
-### Core Features
-
-- [ ] **Astro web app** with React islands
-- [ ] **Live playground** - Real-time preview as you type
-- [ ] **Theme customizer** - Create custom color palettes
-- [ ] **Multi-format** download (SVG, GIF, PNG)
-- [ ] **Share links** with custom settings
-- [ ] **Evolu integration** - Save preferences locally (offline-first)
-
-### Technical Stack
-
-- Frontend: Astro + React 19 + Tailwind CSS 4
-- Database: Evolu (local-first CRDT)
-- Backend: Appwrite (auth, storage)
-- Deployment: GitHub Pages + Vercel
-
----
-
-## 🏆 v3.0 - PvP Mode (Q3 2025)
-
-**Challenge your friends to a snake battle!**
-
-### Game Mechanics
-
-- [ ] **Leaderboards** - Global rankings by score
-- [ ] **Rounds system** - Each round gets faster, snake grows
-- [ ] **PvP Challenges** - Battle friends or colleagues
-- [ ] **Team battles** - Company vs company (B2B feature)
-
-### Power-ups
-
-- 🔄 **Shrink** - Reduce snake length
-- ⚡ **Speed Boost** - Temporary speed increase
-- 🌀 **Teleport** - Jump to random position
-- 🛡️ **Shield** - Pass through yourself once
-
-### Scoring System
-
-| Contribution Level | Points | Round Multiplier |
-|--------------------|--------|------------------|
-| Level 1 (light) | 1 pt | 1x → 1.5x → 2x → 3x → 5x |
-| Level 2 (medium) | 2 pts | |
-| Level 3 (dark) | 3 pts | |
-| Level 4 (darkest) | 5 pts | |
-
----
-
-## 🌟 Community Ideas & Under Consideration
-
-Vote on features at [GitHub Discussions](https://github.com/miccy/snake-evolution/discussions)!
-
-### Most Requested
-
-- ✉️ **Email Signature Mode** - Animated GIF for email footers (high demand!)
-- 🔤 **Custom Text Mode** - Type your own text (e.g., "your-name.dev") and watch snake eat it
-- 📜 **Scrolling Text Mode** - Marquee-style text animation (no snake)
-- 🎨 **Email Tool Integration** - Canva, Mailchimp, etc.
-
-### Future Explorations
-
-- 🎵 Sound effects and music
-- 📱 Mobile app (React Native)
-- 🤖 AI opponent mode
-- 📊 Statistics dashboard
-- 🏅 Achievement badges
-- 🎨 Custom snake skins
-- 🔌 Plugin system
-- 🌐 API for third-party integrations
-
----
-
-## 📅 Detailed Development Timeline
-
-### Phase 1: Foundation ✅ (Completed)
-
-*Week 1-2 - November 2024*
-
-- ✅ Monorepo setup with Turborepo
-- ✅ Core snake engine ported
-- ✅ Pathfinding algorithms
-- ✅ Basic SVG rendering
-- ✅ CI/CD pipeline
-
-### Phase 2: Web Platform 🚧 (Planned Q1 2025)
-
-*Week 2-4 - January 2025*
-
-- [ ] Astro landing page
-- [ ] Interactive playground
-- [ ] Evolu database integration
-- [ ] Appwrite backend setup
-
-### Phase 3: Gallery & Social 🚧 (Planned Q1 2025)
-
-*Week 4-6 - February 2025*
-
-- [ ] Community snake gallery
-- [ ] Voting system
-- [ ] Social sharing with OG images
-- [ ] GitHub OAuth authentication
-
-### Phase 4: Templates & Colors 🚧 (Planned Q2 2025)
-
-*Week 6-8 - March 2025*
-
-- [ ] 20+ visual templates
-- [ ] Template browser UI
-- [ ] Advanced color customization
-- [ ] Real-time preview
-
-### Phase 5: Launch 🚧 (Planned Q2 2025)
-
-*Week 8-10 - April 2025*
-
-- [ ] Product Hunt launch
-- [ ] Dev.to article series
-- [ ] Video demos and tutorials
-- [ ] Press kit and outreach
-
----
-
-## 💡 How to Contribute
-
-Want to help build the future of GitHub profile visualizations?
-
-**Priority Areas:**
-
-- 🎨 **Design** - Theme creation, UI/UX improvements
-- 🔧 **Development** - Web app (Astro + React), game mechanics
-- 📚 **Documentation** - Tutorials, examples, translations
-- 🌐 **Community** - Discord moderation, issue triage
-
-See [CONTRIBUTING.md](../CONTRIBUTING.md) for details!
-
----
-
-## 📊 Success Metrics
-
-### Current (v1.2)
-
-- ⭐ GitHub Stars: [Current count]
-- 📦 npm Downloads: [Monthly count]
-- 🎨 Themes: 7
-- 👥 Contributors: Growing!
-
-### Target (End 2025)
-
-- ⭐ 10,000+ GitHub stars
-- 👤 50,000+ active users
-- 🎨 100+ community templates
-- 🌍 Featured in GitHub Explore
-
----
-
-## 🎯 Release Schedule
-
-```
-v1.2.0 ✅ Dec 2024 Current release
-v1.3.0 🚧 Q1 2025 Glass theme + GIF support
-v2.0.0 🚧 Q2 2025 Web playground launch
-v2.1.0 🚧 Q3 2025 Gallery & community
-v3.0.0 🚧 Q4 2025 PvP Mode 🎮
-```
-
----
-
-
- ⭐ Star the repo to show support and stay updated!
-
-
-
- 📝 Request a Feature •
- 💬 Discussions
-
-
----
-
-**Last Updated:** December 18, 2024
-**Maintained By:** [@miccy](https://github.com/miccy)
diff --git a/docs/ROADMAP_V2.md b/docs/ROADMAP_V2.md
deleted file mode 100644
index b99eb67..0000000
--- a/docs/ROADMAP_V2.md
+++ /dev/null
@@ -1,904 +0,0 @@
-# 🗺️ Snake Evolution Roadmap v2.0
-
-> **Updated:** December 29, 2025
-> **Strategic Focus:** Ethical positioning + Interactive playground + Monetization
-
-## 🎯 Vision
-
-**Make Snake Evolution the #1 ethical and fun way to visualize GitHub contributions** - from simple animations to competitive PvP battles. Position as "The Legitimate Alternative" in a market flooded with manipulation tools.
-
----
-
-## 📍 Current Position (v1.2.4)
-
-### Market Context
-
-- **18,000+ GitHub stars** on contribution manipulation tools
-- **5,500+ stars** on legitimate visualization tools
-- **Growing demand** for profile customization
-- **Hiring managers** increasingly skeptical of fake graphs
-
-### Our Opportunity
-
-```
-gitfiti (2012): Pixel art, playful, 8.3K ⭐
-github-activity: Fake automation, 3.7K ⭐, SKETCHY
-Snake Evolution: ✨ Real data + Gamification + Customization ✨
- TARGET: 10K ⭐ in 6 months
-```
-
-### What's Live ✅
-
-- CLI tool (`npx @snake-evolution/cli@latest`)
-- GitHub Action (marketplace)
-- 7 themes (6 SVG + Glass theme for GIF)
-- Smart pathfinding
-- Monorepo architecture
-
-### Critical Gaps 🚨
-
-- ❌ GIF output (80% ready, not shipped)
-- ❌ Interactive playground
-- ❌ Ethical positioning in marketing
-- ❌ Full color customization
-- ❌ Monetization strategy
-
----
-
-## 🚀 Phase 1: v1.3.0 - Foundation Completion (January 2025)
-
-**Goal:** Ship GIF, complete v1 vision, establish ethical positioning
-
-### Priority 1: GIF Implementation (Week 1)
-
-**Status:** 80% complete, needs final push
-
-**Tasks:**
-
-- [ ] Complete `packages/renderer/src/gif.ts` integration
-- [ ] Test Glass theme rendering with blur effects
-- [ ] CLI `--format gif` option working
-- [ ] GitHub Action supports GIF output
-- [ ] Performance benchmarks (<5s for 365 days)
-- [ ] File size optimization (<1MB)
-
-**Success Metrics:**
-
-- Glass theme renders correctly
-- GIF generation time <5s
-- File size <1MB for full year
-- Zero regressions in SVG output
-
-**Acceptance Criteria:**
-
-```bash
-# These must work:
-npx @snake-evolution/cli generate -u octocat --format gif
-npx @snake-evolution/cli generate -u octocat -t glass --format gif
-
-# Output:
-✓ Generated snake.gif (847KB, 150 frames, 3.2s)
-✓ Glass theme with blur effects rendered
-```
-
-### Priority 2: Ethical Positioning (Week 1-2)
-
-**Strategic Message:**
-> "Snake Evolution shows your REAL GitHub activity in a fun way.
-> No fake commits. No manipulation. Just your actual work, animated."
-
-**Implementation:**
-
-**A) README.md Updates:**
-
-Add prominent badge section:
-
-```markdown
-## ✅ The Ethical Choice
-
-| Snake Evolution | Fake Activity Tools |
-|-----------------|---------------------|
-| ✅ Shows REAL contributions | ❌ Generates fake commits |
-| ✅ Trusted by hiring managers | ❌ Flagged by recruiters |
-| ✅ Open source & auditable | ⚠️ Black box scripts |
-| ✅ Zero security risk | 🚫 Run unknown shell scripts |
-| ✅ GitHub officially approved | ⚠️ Against ToS |
-
-**Used by 10,000+ developers who value authenticity.**
-```
-
-**B) Landing Page Section:**
-
-```markdown
-## Why Developers Trust Snake Evolution
-
-"I wanted to showcase my contributions without faking anything.
-Snake Evolution was perfect - it's fun, legitimate, and actually
-impresses hiring managers." - @developer
-
-[📊 Compare with alternatives] [🔐 Security audit]
-```
-
-**C) Marketplace Description Update:**
-
-Current:
-> "Generate a snake game from a GitHub user contribution graph"
-
-New:
-> "🐍 The #1 ethical way to animate your GitHub contributions.
-> Shows REAL activity only - trusted by 10K+ developers and
-> hiring managers. No fake commits, no manipulation, just fun."
-
-**Success Metrics:**
-
-- Trust indicators in README
-- "Ethical" mentioned prominently
-- Comparison table vs manipulation tools
-- Security audit badge
-
-### Priority 3: Custom Colors Preview (Week 2)
-
-**Goal:** Port that React component to web app as MVP
-
-**Quick Win Implementation:**
-
-Create `apps/web/src/pages/playground.astro`:
-
-```tsx
----
-// Astro frontmatter
-import PlaygroundPreview from '../components/PlaygroundPreview';
----
-
-
-
-
-```
-
-Create `apps/web/src/components/PlaygroundPreview.tsx`:
-
-```tsx
-// Port the GitHub_Contribution_Snake_Game.tsx
-// but connect to actual GitHub API for real data
-// Add "Generate SVG" / "Generate GIF" buttons
-
-export default function PlaygroundPreview() {
- // Your React component with:
- // - Username input
- // - Color customization sliders
- // - Live preview canvas
- // - "Download SVG/GIF" buttons
-}
-```
-
-**Success Metrics:**
-
-- Live preview working
-- Color customization functional
-- Download generates actual files
-- <2s load time
-
----
-
-## 🎨 Phase 2: v2.0 - Interactive Web Platform (Q1 2025)
-
-**Goal:** Full-featured playground with save/share functionality
-
-### Week 1-2: Core Playground
-
-**Features:**
-
-- [ ] **Username autocomplete** - GitHub API integration
-- [ ] **Theme selector** - All 7 themes + custom
-- [ ] **Color picker UI** - HSL sliders for each element:
- - Snake head color
- - Snake body gradient
- - Contribution levels (0-4)
- - Background color
- - Grid color
-- [ ] **Live preview** - Real-time canvas rendering (60fps)
-- [ ] **Settings panel:**
- - Year selector
- - Animation speed
- - Growth rate
- - Grid visibility
-- [ ] **Export options:**
- - Download SVG
- - Download GIF
- - Copy embed code
- - Share link
-
-**Technical Stack:**
-
-- Astro + React islands
-- TailwindCSS 4 for UI
-- Canvas API for preview
-- Web Workers for heavy computation
-
-**Success Metrics:**
-
-- Preview update <100ms
-- Smooth 60fps animations
-- Mobile responsive
-- Lighthouse 95+
-
-### Week 3: Evolu Integration
-
-**Local-First Storage:**
-
-```typescript
-// Schema
-const schema = {
- theme: table({
- id: id(),
- name: text().notNull(),
- colors: jsonb(),
- isPublic: boolean(),
- createdAt: timestamp(),
- }),
- settings: table({
- id: id(),
- userId: text(),
- preferences: jsonb(),
- }),
-};
-```
-
-**Features:**
-
-- [ ] Save custom themes locally
-- [ ] Theme history (last 10)
-- [ ] Export/import themes
-- [ ] Offline-capable playground
-
-**Why Evolu:**
-
-- Privacy-first (data stays local)
-- Works offline
-- No auth required for basic usage
-- Optional P2P sync later
-
-### Week 4: Gallery & Social
-
-**Community Showcase:**
-
-**Features:**
-
-- [ ] Submit snake to public gallery
-- [ ] Browse community snakes
-- [ ] Upvote/favorite system
-- [ ] Filter by theme, date, popularity
-- [ ] GitHub OAuth for submissions
-
-**Backend: Appwrite**
-
-Collections:
-
-```
-snakes:
- - id
- - userId
- - username
- - theme (string or JSON for custom)
- - settings (JSON)
- - imageUrl (CDN)
- - votes (relation)
- - createdAt
-
-votes:
- - id
- - snakeId (relation)
- - userId
- - value (+1 / -1)
-```
-
-**Social Features:**
-
-- [ ] "Snake of the Week" badge
-- [ ] Share to Twitter with OG image
-- [ ] Embed code for blogs
-- [ ] Pinterest-style grid layout
-
----
-
-## 💰 Phase 2.5: Monetization Strategy (Q1 2025)
-
-**Goal:** Sustainable income to fund development
-
-### Free Tier
-
-✅ All current features
-✅ 7 pre-built themes
-✅ Basic color customization
-✅ SVG/GIF export
-✅ GitHub Action
-
-### Sponsor Tier ($5/month)
-
-**Exclusive Features:**
-
-- 🎨 **Unlimited custom themes** - Save unlimited themes
-- 🌈 **Advanced color editor** - HSL/gradient controls
-- ⚡ **Priority rendering** - Skip queue (when web service)
-- 🎮 **Early access to PvP** - Beta testing
-- 📊 **Analytics dashboard** - Views, downloads stats
-- 💎 **Sponsor badge** - In gallery and profile
-- 🎁 **Exclusive themes** - Monthly premium theme pack
-
-**Value Proposition:**
-> "Support ethical open-source development while unlocking
-> advanced customization. Used by 500+ sponsors worldwide."
-
-### Implementation
-
-**A) GitHub Sponsors Setup**
-
-Tiers:
-
-```yaml
-$5/month - Supporter:
- - Sponsor badge
- - Priority support
- - Early access
-
-$15/month - Power User:
- - All Supporter benefits
- - Custom theme builder
- - Analytics dashboard
- - Remove watermark
-
-$50/month - Company:
- - All Power User benefits
- - Team licenses (10 users)
- - Private gallery
- - Custom branding
-```
-
-**B) Feature Gating**
-
-```typescript
-// Check sponsor status
-async function checkSponsorStatus(username: string): Promise {
- // GitHub GraphQL API
- // Return: 'free' | 'supporter' | 'power' | 'company'
-}
-
-// UI based on tier
-if (tier === 'free') {
- showUpgradePrompt("Unlock unlimited themes for $5/month");
-} else {
- enablePremiumFeatures();
-}
-```
-
-**C) Marketing Page**
-
-`/pricing`:
-
-- Compare tiers
-- Testimonials from sponsors
-- "Support open source" messaging
-- Clear value proposition
-
-**Success Metrics:**
-
-- 20 sponsors by end of Q1
-- $100 MRR (Monthly Recurring Revenue)
-- 5% conversion rate (free → sponsor)
-
----
-
-## 🎮 Phase 3: v3.0 - PvP Mode (Q2-Q3 2025)
-
-**Status:** Future planning, low priority until v2.0 ships
-
-### Game Mechanics (Refined)
-
-**Core Concept:**
-> Two players compete on the same contribution graph.
-> First to eat all contributions (or highest score) wins.
-
-**Rounds System:**
-
-```
-Round 1: Normal speed, 3 min limit
-Round 2: 1.5x speed, 2 min limit
-Round 3: 2x speed, 1 min limit
-Finals: 3x speed, 30 sec limit
-```
-
-**Power-ups with Cooldowns:**
-
-- 🔄 **Shrink** (10s cooldown) - Lose 3 body segments
-- ⚡ **Speed Boost** (20s cooldown) - 2x speed for 5s
-- 🌀 **Teleport** (30s cooldown) - Random safe position
-- 🛡️ **Shield** (60s cooldown) - Pass through yourself once
-- 🎯 **Vision** (15s cooldown) - Highlight highest value squares
-
-**Scoring:**
-
-```javascript
-base_points = contribution_level (1-5)
-round_multiplier = [1, 1.5, 2, 3, 5][current_round]
-combo_bonus = consecutive_eats * 0.5
-final_score = base_points * round_multiplier + combo_bonus
-```
-
-**Game Modes:**
-
-1. **Quick Match** (3 rounds, 6 min total)
-2. **Ranked** (5 rounds, 10 min, ELO rating)
-3. **Team Battle** (2v2, shared graph)
-4. **Company vs Company** (5v5, tournament style)
-
-### Technical Implementation
-
-**Real-time Engine:**
-
-Use Appwrite Realtime (WebSocket):
-
-```typescript
-// Game state sync
-interface GameState {
- gameId: string;
- players: [Player, Player];
- grid: ContributionGrid;
- round: number;
- timeRemaining: number;
- powerUps: PowerUp[];
-}
-
-// Broadcast updates at 60fps
-setInterval(() => {
- broadcastGameState(gameState);
-}, 16); // 60fps
-```
-
-**Latency Optimization:**
-
-- Client-side prediction
-- Server reconciliation
-- Rollback on desync
-
-**AI Opponent:**
-
-For practice mode:
-
-```typescript
-// Difficulty levels
-enum Difficulty {
- Easy = 500, // 500ms reaction time
- Medium = 250,
- Hard = 100,
- Insane = 50,
-}
-
-// AI uses same pathfinding but with delay
-async function aiMove(difficulty: Difficulty) {
- await sleep(difficulty);
- return calculateBestMove(grid, snake);
-}
-```
-
-**Anti-Cheat:**
-
-- Server-authoritative movement
-- Input validation
-- Rate limiting
-- Replay detection
-
-### Leaderboards
-
-**Categories:**
-
-- Global (all time)
-- Weekly
-- Monthly
-- By country
-- By company
-
-**Rewards:**
-
-- Top 10: Special badge
-- Top 100: Custom title
-- Monthly winner: Featured on homepage
-
----
-
-## 📅 Revised Timeline
-
-```
-v1.2.4 ✅ Current - Basic functionality
-v1.3.0 🚧 Jan 2025 - GIF + Ethical positioning + Color preview
-v1.4.0 📋 Feb 2025 - Performance optimization + bug fixes
-v2.0.0 📋 Mar 2025 - Full playground launch
-v2.1.0 📋 Apr 2025 - Gallery + social features
-v2.2.0 📋 May 2025 - Monetization (Sponsor tiers)
-v3.0.0 📋 Q3 2025 - PvP Mode beta
-v3.1.0 📋 Q4 2025 - PvP full release + tournaments
-```
-
-### Revised Milestones
-
-**Q1 2025 Goals:**
-
-- ✅ Ship v1.3.0 with GIF (Jan 15)
-- ✅ Launch interactive playground (Feb 1)
-- ✅ Ethical positioning complete (Feb 1)
-- ✅ Gallery + voting system (Mar 1)
-- 🎯 **5,000 GitHub stars**
-- 🎯 **10,000 npm downloads/month**
-- 🎯 **20 GitHub Sponsors**
-
-**Q2 2025 Goals:**
-
-- Premium tier launched
-- 50+ sponsors
-- 1,000+ community themes
-- Featured on GitHub Explore
-
-**Q3-Q4 2025 Goals:**
-
-- PvP beta → full release
-- 10,000+ stars
-- 500+ sponsors
-- 100,000+ npm downloads/month
-
----
-
-## 🎯 Success Metrics Dashboard
-
-### Product Metrics
-
-| Metric | Current | Q1 Target | Q2 Target | Q4 Target |
-|--------|---------|-----------|-----------|-----------|
-| GitHub Stars | ~500 | 5,000 | 7,500 | 10,000 |
-| npm Downloads/mo | ~1,000 | 10,000 | 25,000 | 100,000 |
-| GitHub Action Uses | ~100 | 5,000 | 10,000 | 25,000 |
-| Gallery Themes | 0 | 100 | 500 | 1,000 |
-| Active Users/mo | ~500 | 50,000 | 100,000 | 250,000 |
-
-### Revenue Metrics
-
-| Metric | Q1 | Q2 | Q3 | Q4 |
-|--------|----|----|----|----|
-| Sponsors | 20 | 50 | 150 | 300 |
-| MRR | $100 | $500 | $2,000 | $5,000 |
-| ARR | $1,200 | $6,000 | $24,000 | $60,000 |
-
-### Performance Metrics
-
-| Metric | Target |
-|--------|--------|
-| GIF Generation | <5s for 365 days |
-| Playground Load | <2s |
-| Preview Update | <100ms |
-| Lighthouse Score | 95+ |
-| Memory Usage | <512MB |
-| Bundle Size | <300KB |
-
----
-
-## 📊 Competitive Analysis
-
-### Direct Competitors
-
-**Platane/snk (Original):**
-
-- ✅ 7K+ stars, established
-- ✅ Simple, works well
-- ❌ No customization
-- ❌ No interactive playground
-- ❌ No community features
-
-**Our Advantages:**
-
-- ✅ Full color customization
-- ✅ Growing snake mechanic
-- ✅ Interactive playground
-- ✅ Ethical positioning
-- ✅ Premium features
-
-**github-contributions-chart (5.5K stars):**
-
-- ✅ Shows full history
-- ❌ Static image only
-- ❌ No animation
-- ❌ No customization
-
-**Our Advantages:**
-
-- ✅ Animated (way cooler)
-- ✅ Interactive
-- ✅ Gamification
-
-### Manipulation Tools (TO AVOID)
-
-**gitfiti (8.3K stars):**
-
-- Category: Playful pixel art
-- Ethics: Gray area, but clearly art
-
-**github-activity-generator (3.7K stars):**
-
-- Category: Fake activity
-- Ethics: Sketchy, against ToS
-
-**Our Differentiation:**
-> "We're on the opposite end of the spectrum.
-> Snake Evolution = Fun + Authentic + Trusted by hiring managers."
-
----
-
-## 🚨 Risk Mitigation
-
-### Technical Risks
-
-**Risk:** GIF rendering too slow
-**Mitigation:**
-
-- Benchmark early
-- Frame sampling
-- Web Workers
-- Caching
-
-**Risk:** Playground performance on mobile
-**Mitigation:**
-
-- Progressive enhancement
-- Reduced quality mode
-- Service Worker caching
-
-**Risk:** Appwrite cost at scale
-**Mitigation:**
-
-- Self-hosted option
-- Cloudflare CDN
-- Aggressive caching
-
-### Business Risks
-
-**Risk:** Low sponsor conversion
-**Mitigation:**
-
-- Clear value proposition
-- Social proof (testimonials)
-- Trial period (7 days)
-- "Support open source" angle
-
-**Risk:** Comparison to "fake activity" tools
-**Mitigation:**
-
-- Aggressive ethical positioning
-- Clear differentiation
-- Trust indicators
-- Hiring manager testimonials
-
-**Risk:** Competition from forks
-**Mitigation:**
-
-- Keep innovating (playground, PvP)
-- Build community moat
-- Premium features
-- Brand recognition
-
----
-
-## 🎨 Marketing Strategy
-
-### Content Marketing
-
-**Blog Posts:**
-
-1. "Why I Built Snake Evolution (And Why It's Ethical)"
-2. "Behind the Scenes: How Snake Pathfinding Works"
-3. "The Problem with GitHub Contribution Manipulation"
-4. "5 Creative Ways to Use Snake Evolution"
-5. "Building a Local-First App with Evolu"
-
-**Videos:**
-
-1. Product demo (60s)
-2. Playground tutorial (5 min)
-3. "Ethical vs Fake" comparison (3 min)
-4. Theme creation tutorial (10 min)
-
-**Social Media:**
-
-- Twitter: Daily snake showcases
-- Dev.to: Technical deep dives
-- Reddit: r/github, r/programming
-- HackerNews: Launch announcement
-
-### Community Building
-
-**Discord Server:**
-
-- #showcase - User snakes
-- #themes - Theme sharing
-- #support - Help channel
-- #feedback - Feature requests
-- #dev - Development updates
-
-**GitHub Discussions:**
-
-- Ideas & Feature Requests
-- Show & Tell
-- Q&A
-- Announcements
-
-**Events:**
-
-- Weekly "Snake of the Week"
-- Monthly theme contest
-- Quarterly PvP tournament (when ready)
-
----
-
-## 🔧 Technical Debt to Address
-
-### Before v2.0
-
-**High Priority:**
-
-- [ ] Reduce bundle size (400KB → <300KB)
-- [ ] Add error boundaries in React
-- [ ] Implement proper logging
-- [ ] Add performance monitoring
-- [ ] Write integration tests
-
-**Medium Priority:**
-
-- [ ] Refactor engine to use Web Workers
-- [ ] Implement caching layer
-- [ ] Optimize SVG output
-- [ ] Add analytics (privacy-friendly)
-
-**Low Priority:**
-
-- [ ] Migrate to Biome 2.0 when stable
-- [ ] Update to latest Astro
-- [ ] Consolidate types package
-
----
-
-## 📚 Documentation Needs
-
-### Before v2.0 Launch
-
-**User Docs:**
-
-- [ ] Getting started guide
-- [ ] Playground tutorial
-- [ ] Theme creation guide
-- [ ] API reference (for CLI)
-- [ ] FAQ
-- [ ] Video tutorials
-
-**Developer Docs:**
-
-- [ ] Architecture overview
-- [ ] Contributing guide
-- [ ] Theme development
-- [ ] Plugin system (future)
-
-**Marketing:**
-
-- [ ] Press kit
-- [ ] Brand guidelines
-- [ ] Screenshots library
-- [ ] Testimonials page
-
----
-
-## 🎯 Key Decisions to Make
-
-### Before Starting v1.3
-
-**Decision 1: GIF vs SVG Default**
-
-- Option A: Keep SVG as default (backward compatible)
-- Option B: Make GIF default (better compatibility)
-- **Recommendation:** Keep SVG, add clear GIF benefits messaging
-
-**Decision 2: Color Customization Scope**
-
-- Option A: Full HSL control (complex UI)
-- Option B: Preset palettes + limited tweaking
-- **Recommendation:** Start with B, add A for sponsors
-
-**Decision 3: Monetization Timing**
-
-- Option A: Launch with v2.0 (February)
-- Option B: Wait until v2.1 (March/April)
-- **Recommendation:** Launch with v2.0, gives time to iterate
-
-**Decision 4: Evolu vs Traditional DB**
-
-- Option A: Full Evolu (learning curve, offline-first)
-- Option B: Hybrid (Appwrite for public, Evolu for local)
-- **Recommendation:** Hybrid approach
-
----
-
-## 🔄 Feedback Loops
-
-### Weekly Check-ins
-
-**Metrics to Track:**
-
-- npm downloads (weekly)
-- GitHub stars (daily)
-- Action usage (weekly)
-- Website traffic (daily)
-- User feedback (continuous)
-
-### Monthly Reviews
-
-**Questions:**
-
-1. Are we hitting milestones?
-2. What's working / not working?
-3. Should we pivot anything?
-4. What's user feedback saying?
-5. How's revenue tracking?
-
-### Quarterly Planning
-
-**Focus:**
-
-- Review Q roadmap
-- Adjust based on learnings
-- Plan next Q priorities
-- Community check-in
-
----
-
-## 💡 Future Ideas (Post v3.0)
-
-**Parking Lot:**
-
-- Email signature mode (animated GIF)
-- Custom text mode ("your-name.dev" eaten by snake)
-- Mobile app (React Native)
-- API for third-party integrations
-- Plugin system for custom renderers
-- AI-generated themes
-- NFT badges (controversial, research first)
-- Corporate team dashboards
-- Contribution forecasting
-- Gamification achievements
-
----
-
-## 📌 Appendix
-
-### Key Resources
-
-- [Market Research Article](https://medium.com/data-science-collective/developers-are-gaming-their-github-profiles-3f58f1f00c2a)
-- [React Component Reference](GitHub_Contribution_Snake_Game.tsx)
-- [Platane/snk Original](https://github.com/Platane/snk)
-
-### Tech Stack Summary
-
-**Current:**
-
-- Runtime: Bun 1.3.5
-- Monorepo: Turborepo
-- Language: TypeScript 5.9
-- Linting: Biome
-- Testing: Vitest
-
-**Planned (v2.0+):**
-
-- Frontend: Astro + React 19
-- Styling: TailwindCSS 4
-- Database: Evolu (local) + Appwrite (cloud)
-- Payments: GitHub Sponsors API
-- Analytics: Plausible (privacy-friendly)
-
----
-
-**Last Updated:** December 29, 2025
-**Next Review:** January 15, 2025 (post v1.3.0 launch)
-**Maintainer:** [@miccy](https://github.com/miccy)
From ff863d6fe76f517473b6b72877a0177a8b46811d Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 12:18:06 +0100
Subject: [PATCH 12/29] chore(release): ensure all packages are at v1.3.0
---
package.json | 2 +-
packages/biome-config/package.json | 2 +-
packages/typescript-config/package.json | 2 +-
packages/ui/package.json | 2 +-
4 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/package.json b/package.json
index 5ac6fcd..9366358 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
{
"name": "snake-evolution",
"private": true,
- "version": "1.2.4",
+ "version": "1.3.0",
"description": "Transform your GitHub contribution graph into an epic snake animation",
"repository": {
"type": "git",
diff --git a/packages/biome-config/package.json b/packages/biome-config/package.json
index 745be29..a932715 100644
--- a/packages/biome-config/package.json
+++ b/packages/biome-config/package.json
@@ -1,6 +1,6 @@
{
"name": "@snake-evolution/biome-config",
- "version": "1.2.4",
+ "version": "1.3.0",
"private": true,
"license": "MIT",
"description": "Shared Biome configuration for snake-evolution monorepo",
diff --git a/packages/typescript-config/package.json b/packages/typescript-config/package.json
index 9c5eab9..8bdd2c6 100644
--- a/packages/typescript-config/package.json
+++ b/packages/typescript-config/package.json
@@ -1,6 +1,6 @@
{
"name": "@snake-evolution/typescript-config",
- "version": "1.2.4",
+ "version": "1.3.0",
"private": true,
"license": "MIT",
"publishConfig": {
diff --git a/packages/ui/package.json b/packages/ui/package.json
index ee63896..bbc5a37 100644
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -1,6 +1,6 @@
{
"name": "@snake-evolution/ui",
- "version": "1.2.4",
+ "version": "1.3.0",
"private": true,
"type": "module",
"main": "./src/index.ts",
From 0cc707a2ad4a7376e25d7f79a86d20a20d20166e Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 13:02:59 +0100
Subject: [PATCH 13/29] chore(release): finalize v1.3.0 - fix tests, update
docs, optimized animation
---
README.md | 5 +-
apps/web/package.json | 2 +-
.../content/docs/guides/gif-implementation.md | 9 +-
.../src/content/docs/guides/installation.md | 2 +-
apps/web/src/content/docs/roadmap.md | 3 +-
.../docs/testing/unit-tests-generated.md | 8 +-
assets/examples/cypherpunk.svg | 2 +-
assets/examples/github-dark.svg | 2 +-
assets/examples/github-light.svg | 2 +-
assets/examples/neon-gamer.svg | 2 +-
assets/examples/ocean.svg | 2 +-
assets/examples/sunset.svg | 2 +-
bun.lock | 24 +--
packages/cli/src/index.ts | 2 +-
packages/github/src/index.ts | 182 +++++++++++++-----
packages/renderer/README.md | 26 +--
packages/ui/package.json | 2 +-
scripts/README.md | 2 +-
18 files changed, 181 insertions(+), 98 deletions(-)
diff --git a/README.md b/README.md
index 4dadd9c..a02a414 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@
- **🤖 GitHub Action** - Automated daily updates for your profile.
- **🗓️ Rolling Year** - Always shows the last 12 months of contributions.
-## 🚀 Usage
+## 🚀 Quick Start
### GitHub Action (Recommended)
@@ -85,9 +85,8 @@ npx @snake-evolution/cli@latest generate -u YOUR_USERNAME
Add this into your README.md
```markdown
-!
+
```
-
### HTML in Markdown
Add this into your README.md for centered image with dark/light mode support
diff --git a/apps/web/package.json b/apps/web/package.json
index 361c18a..c4d90e4 100644
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -14,7 +14,7 @@
"@astrojs/starlight": "^0.37.4",
"@tailwindcss/postcss": "^4.1.18",
"@tailwindcss/vite": "^4.1.18",
- "astro": "^5.16.16",
+ "astro": "^5.17.0",
"sharp": "^0.34.2",
"tailwindcss": "^4.1.18"
},
diff --git a/apps/web/src/content/docs/guides/gif-implementation.md b/apps/web/src/content/docs/guides/gif-implementation.md
index af2bc78..0fc149e 100644
--- a/apps/web/src/content/docs/guides/gif-implementation.md
+++ b/apps/web/src/content/docs/guides/gif-implementation.md
@@ -7,7 +7,7 @@ description: Technical guide for implementing GIF output support.
Technical documentation for implementing GIF output format in Snake Evolution.
-> **Status:** Planned for v1.3.0 (January 2025)
+> **Status:** Planned for v1.3.0 (January 2026)
> **Research date:** December 22, 2025
## Overview
@@ -110,13 +110,15 @@ export async function renderAnimatedGIF(
});
const rendered = resvg.render();
const pixels = rendered.pixels; // Uint8Array RGBA
+ const actualWidth = rendered.width;
+ const actualHeight = rendered.height;
// 3. Quantize colors (GIF max 256)
const palette = quantize(pixels, 256, { format: "rgba4444" });
const indexed = applyPalette(pixels, palette, "rgba4444");
// 4. Add frame to GIF
- gif.writeFrame(indexed, width, height, {
+ gif.writeFrame(indexed, actualWidth, actualHeight, {
palette,
delay: frameDelay,
dispose: 2, // restore to background
@@ -223,9 +225,8 @@ export function validateOutputFormat(format: string, theme: string) {
- Total: ~5-10 seconds for typical animation
### Memory
-
- Hold one frame in memory at a time
-- ~4 bytes per pixel × 847 × 112 = ~380 KB per frame
+- ~4 bytes per pixel × 847 × 112 = ~370 KB per frame
- GIF encoder streams, doesn't buffer all frames
## Why Not Platane's Approach
diff --git a/apps/web/src/content/docs/guides/installation.md b/apps/web/src/content/docs/guides/installation.md
index 4e63941..9c5c936 100644
--- a/apps/web/src/content/docs/guides/installation.md
+++ b/apps/web/src/content/docs/guides/installation.md
@@ -69,7 +69,7 @@ snake-evolution/
## Verify Installation
```bash
-# Run all quality checks (lint + typecheck)
+# Run all quality checks (lint + format + typecheck)
bun run check
# Or run tests too
diff --git a/apps/web/src/content/docs/roadmap.md b/apps/web/src/content/docs/roadmap.md
index df612c2..35c7565 100644
--- a/apps/web/src/content/docs/roadmap.md
+++ b/apps/web/src/content/docs/roadmap.md
@@ -5,7 +5,7 @@ description: Strategic roadmap and vision for Snake Evolution.
# 🗺️ Snake Evolution Roadmap
-> **Updated:** January 2025
+> **Updated:** January 2026
> **Strategic Focus:** Ethical positioning + Interactive playground + Monetization
## 🎯 Vision
@@ -109,6 +109,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨
> First to eat all contributions (or highest score) wins.
**Game Modes:**
+
1. **Quick Match** (3 rounds)
2. **Ranked** (ELO rating)
3. **Team Battle** (2v2)
diff --git a/apps/web/src/content/docs/testing/unit-tests-generated.md b/apps/web/src/content/docs/testing/unit-tests-generated.md
index 2897ee2..db53dbb 100644
--- a/apps/web/src/content/docs/testing/unit-tests-generated.md
+++ b/apps/web/src/content/docs/testing/unit-tests-generated.md
@@ -5,7 +5,7 @@ description: Detailed breakdown of unit tests generated for v1.3.0.
## Summary
-Generated **80+ comprehensive unit tests** for all code changes in this branch, with a strong bias for action to ensure thorough coverage of edge cases, security concerns, and real-world scenarios.
+Generated **104+ comprehensive unit tests** for all code changes in this branch, with a strong bias for action to ensure thorough coverage of edge cases, security concerns, and real-world scenarios.
## Files Modified/Created
@@ -169,8 +169,8 @@ Generated **80+ comprehensive unit tests** for all code changes in this branch,
| Metric | Value |
| ---------------------------- | ----- |
-| **Total New Tests** | ~80 |
-| **Lines of Test Code Added** | ~885 |
+| **Total New Tests** | 104+ |
+| **Lines of Test Code Added** | 1,188 |
| **Security Tests** | 20+ |
| **Edge Case Tests** | 25+ |
| **Integration Tests** | 15+ |
@@ -257,7 +257,7 @@ Comprehensive validation:
## Conclusion
-These comprehensive unit tests provide a solid foundation for the codebase changes. With **80+ new tests** covering happy paths, edge cases, security concerns, and real-world scenarios, the code is well-protected against regressions and provides clear documentation of expected behavior.
+These comprehensive unit tests provide a solid foundation for the codebase changes. With **104+ new tests** covering happy paths, edge cases, security concerns, and real-world scenarios, the code is well-protected against regressions and provides clear documentation of expected behavior.
**Total Test Coverage Increase:**
diff --git a/assets/examples/cypherpunk.svg b/assets/examples/cypherpunk.svg
index 0f6d110..a4cd160 100644
--- a/assets/examples/cypherpunk.svg
+++ b/assets/examples/cypherpunk.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/github-dark.svg b/assets/examples/github-dark.svg
index ae4d819..d8c6a78 100644
--- a/assets/examples/github-dark.svg
+++ b/assets/examples/github-dark.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/github-light.svg b/assets/examples/github-light.svg
index ab8720c..dd25bda 100644
--- a/assets/examples/github-light.svg
+++ b/assets/examples/github-light.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/neon-gamer.svg b/assets/examples/neon-gamer.svg
index eee32b0..f037380 100644
--- a/assets/examples/neon-gamer.svg
+++ b/assets/examples/neon-gamer.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/ocean.svg b/assets/examples/ocean.svg
index d42499a..e4165b0 100644
--- a/assets/examples/ocean.svg
+++ b/assets/examples/ocean.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/sunset.svg b/assets/examples/sunset.svg
index 5728a79..2330df5 100644
--- a/assets/examples/sunset.svg
+++ b/assets/examples/sunset.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/bun.lock b/bun.lock
index e284099..4f14793 100644
--- a/bun.lock
+++ b/bun.lock
@@ -17,7 +17,7 @@
},
"apps/api": {
"name": "@snake-evolution/api",
- "version": "1.2.4",
+ "version": "1.3.0",
"dependencies": {
"@elysiajs/cors": "^1.4.1",
"@elysiajs/swagger": "^1.3.1",
@@ -26,12 +26,12 @@
},
"apps/web": {
"name": "@snake-evolution/web",
- "version": "1.2.4",
+ "version": "1.3.0",
"dependencies": {
"@astrojs/starlight": "^0.37.4",
"@tailwindcss/postcss": "^4.1.18",
"@tailwindcss/vite": "^4.1.18",
- "astro": "^5.16.16",
+ "astro": "^5.17.0",
"sharp": "^0.34.2",
"tailwindcss": "^4.1.18",
},
@@ -41,11 +41,11 @@
},
"packages/biome-config": {
"name": "@snake-evolution/biome-config",
- "version": "1.2.4",
+ "version": "1.3.0",
},
"packages/cli": {
"name": "@snake-evolution/cli",
- "version": "1.2.4",
+ "version": "1.3.0",
"bin": {
"snake": "./dist/index.js",
},
@@ -60,36 +60,36 @@
},
"packages/engine": {
"name": "@snake-evolution/engine",
- "version": "1.2.4",
+ "version": "1.3.0",
"dependencies": {
"@snake-evolution/types": "workspace:*",
},
},
"packages/github": {
"name": "@snake-evolution/github",
- "version": "1.2.4",
+ "version": "1.3.0",
"dependencies": {
"@snake-evolution/types": "workspace:*",
},
},
"packages/renderer": {
"name": "@snake-evolution/renderer",
- "version": "1.2.4",
+ "version": "1.3.0",
"dependencies": {
"@snake-evolution/types": "workspace:*",
},
},
"packages/types": {
"name": "@snake-evolution/types",
- "version": "1.2.4",
+ "version": "1.3.0",
},
"packages/typescript-config": {
"name": "@snake-evolution/typescript-config",
- "version": "1.2.4",
+ "version": "1.3.0",
},
"packages/ui": {
"name": "@snake-evolution/ui",
- "version": "1.2.4",
+ "version": "1.3.0",
"dependencies": {
"isomorphic-dompurify": "^2.35.0",
"react": "^19.2.4",
@@ -603,7 +603,7 @@
"astring": ["astring@1.9.0", "", { "bin": { "astring": "bin/astring" } }, "sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg=="],
- "astro": ["astro@5.16.16", "", { "dependencies": { "@astrojs/compiler": "^2.13.0", "@astrojs/internal-helpers": "0.7.5", "@astrojs/markdown-remark": "6.3.10", "@astrojs/telemetry": "3.3.0", "@capsizecss/unpack": "^4.0.0", "@oslojs/encoding": "^1.1.0", "@rollup/pluginutils": "^5.3.0", "acorn": "^8.15.0", "aria-query": "^5.3.2", "axobject-query": "^4.1.0", "boxen": "8.0.1", "ci-info": "^4.3.1", "clsx": "^2.1.1", "common-ancestor-path": "^1.0.1", "cookie": "^1.1.1", "cssesc": "^3.0.0", "debug": "^4.4.3", "deterministic-object-hash": "^2.0.2", "devalue": "^5.6.2", "diff": "^8.0.3", "dlv": "^1.1.3", "dset": "^3.1.4", "es-module-lexer": "^1.7.0", "esbuild": "^0.25.0", "estree-walker": "^3.0.3", "flattie": "^1.1.1", "fontace": "~0.4.0", "github-slugger": "^2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "^4.2.0", "import-meta-resolve": "^4.2.0", "js-yaml": "^4.1.1", "magic-string": "^0.30.21", "magicast": "^0.5.1", "mrmime": "^2.0.1", "neotraverse": "^0.6.18", "p-limit": "^6.2.0", "p-queue": "^8.1.1", "package-manager-detector": "^1.6.0", "piccolore": "^0.1.3", "picomatch": "^4.0.3", "prompts": "^2.4.2", "rehype": "^13.0.2", "semver": "^7.7.3", "shiki": "^3.21.0", "smol-toml": "^1.6.0", "svgo": "^4.0.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tsconfck": "^3.1.6", "ultrahtml": "^1.6.0", "unifont": "~0.7.3", "unist-util-visit": "^5.0.0", "unstorage": "^1.17.4", "vfile": "^6.0.3", "vite": "^6.4.1", "vitefu": "^1.1.1", "xxhash-wasm": "^1.1.0", "yargs-parser": "^21.1.1", "yocto-spinner": "^0.2.3", "zod": "^3.25.76", "zod-to-json-schema": "^3.25.1", "zod-to-ts": "^1.2.0" }, "optionalDependencies": { "sharp": "^0.34.0" }, "bin": { "astro": "astro.js" } }, "sha512-MFlFvQ84ixaHyqB3uGwMhNHdBLZ3vHawyq3PqzQS2TNWiNfQrxp5ag6S3lX+Cvnh0MUcXX+UnJBPMBHjP1/1ZQ=="],
+ "astro": ["astro@5.17.0", "", { "dependencies": { "@astrojs/compiler": "^2.13.0", "@astrojs/internal-helpers": "0.7.5", "@astrojs/markdown-remark": "6.3.10", "@astrojs/telemetry": "3.3.0", "@capsizecss/unpack": "^4.0.0", "@oslojs/encoding": "^1.1.0", "@rollup/pluginutils": "^5.3.0", "acorn": "^8.15.0", "aria-query": "^5.3.2", "axobject-query": "^4.1.0", "boxen": "8.0.1", "ci-info": "^4.3.1", "clsx": "^2.1.1", "common-ancestor-path": "^1.0.1", "cookie": "^1.1.1", "cssesc": "^3.0.0", "debug": "^4.4.3", "deterministic-object-hash": "^2.0.2", "devalue": "^5.6.2", "diff": "^8.0.3", "dlv": "^1.1.3", "dset": "^3.1.4", "es-module-lexer": "^1.7.0", "esbuild": "^0.25.0", "estree-walker": "^3.0.3", "flattie": "^1.1.1", "fontace": "~0.4.0", "github-slugger": "^2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "^4.2.0", "import-meta-resolve": "^4.2.0", "js-yaml": "^4.1.1", "magic-string": "^0.30.21", "magicast": "^0.5.1", "mrmime": "^2.0.1", "neotraverse": "^0.6.18", "p-limit": "^6.2.0", "p-queue": "^8.1.1", "package-manager-detector": "^1.6.0", "piccolore": "^0.1.3", "picomatch": "^4.0.3", "prompts": "^2.4.2", "rehype": "^13.0.2", "semver": "^7.7.3", "shiki": "^3.21.0", "smol-toml": "^1.6.0", "svgo": "^4.0.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tsconfck": "^3.1.6", "ultrahtml": "^1.6.0", "unifont": "~0.7.3", "unist-util-visit": "^5.0.0", "unstorage": "^1.17.4", "vfile": "^6.0.3", "vite": "^6.4.1", "vitefu": "^1.1.1", "xxhash-wasm": "^1.1.0", "yargs-parser": "^21.1.1", "yocto-spinner": "^0.2.3", "zod": "^3.25.76", "zod-to-json-schema": "^3.25.1", "zod-to-ts": "^1.2.0" }, "optionalDependencies": { "sharp": "^0.34.0" }, "bin": { "astro": "astro.js" } }, "sha512-6ltLRcs2WrVBMEcgHLntabSdJqz+z2PxzCS2Iw20g60y6hP2AXVn53Y7PCCIprMHsGXEkk1h+PoTkgKp4dDugA=="],
"astro-expressive-code": ["astro-expressive-code@0.41.4", "", { "dependencies": { "rehype-expressive-code": "^0.41.4" }, "peerDependencies": { "astro": "^4.0.0-beta || ^5.0.0-beta || ^3.3.0" } }, "sha512-LK6EcK/hIHfOSo9zqapzu4CbTC0YBtMOVdvWjInpB2SgYtxiF22aZDqdpejN8J28mWPqPLQwSqdl2lWuirNXmw=="],
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
index 1098359..38786f7 100644
--- a/packages/cli/src/index.ts
+++ b/packages/cli/src/index.ts
@@ -35,7 +35,7 @@ program
.option("--token ", "GitHub personal access token for higher rate limits")
.option("--animated", "Generate animated SVG (default: true)", true)
.option("--static", "Generate static SVG (single frame with the final snake)")
- .option("--frame-delay ", "Delay between frames in ms", "150")
+ .option("--frame-delay ", "Delay between frames in ms", "60")
.option("--max-length ", "Maximum snake length (0 = auto)", "0")
.option("--grow-every ", "Grow 1 segment every N contributions (0 = auto)", "0")
.action(async (options) => {
diff --git a/packages/github/src/index.ts b/packages/github/src/index.ts
index ee66d12..0165979 100644
--- a/packages/github/src/index.ts
+++ b/packages/github/src/index.ts
@@ -102,13 +102,11 @@ async function fetchContributionsGraphQL(
if (targetYear === currentYear) {
// Rolling year: last 12 months ending today
+ // Align start date to Sunday to ensure full weeks in the grid
to = now.toISOString();
const oneYearAgo = new Date(now);
oneYearAgo.setFullYear(now.getFullYear() - 1);
-
- // Adjust to start on Sunday for cleaner graph?
- // GitHub usually shows exactly 1 year or 53 weeks.
- // Let's just do exact 1 year for now, the renderer handles the grid.
+ oneYearAgo.setDate(oneYearAgo.getDate() - oneYearAgo.getDay()); // Align to previous Sunday
from = oneYearAgo.toISOString();
} else {
// Calendar year: Jan 1 to Dec 31
@@ -175,23 +173,9 @@ function levelToNumber(level: ContributionDay["contributionLevel"]): 0 | 1 | 2 |
// HTML Scraping (public, no auth)
// ============================================
-async function fetchContributionsHTML(username: string, year?: number): Promise {
- const now = new Date();
- const currentYear = now.getFullYear();
- const targetYear = year ?? currentYear;
-
- let url: string;
-
- if (targetYear === currentYear) {
- const toDate = now.toISOString().split("T")[0];
- const oneYearAgo = new Date(now);
- oneYearAgo.setFullYear(now.getFullYear() - 1);
- const fromDate = oneYearAgo.toISOString().split("T")[0];
- url = `https://github.com/users/${username}/contributions?from=${fromDate}&to=${toDate}`;
- } else {
- url = `https://github.com/users/${username}/contributions?from=${targetYear}-01-01&to=${targetYear}-12-31`;
- }
-
+// Helper to fetch a specific calendar year
+async function fetchYear(username: string, year: number): Promise {
+ const url = `https://github.com/users/${username}/contributions?from=${year}-01-01&to=${year}-12-31`;
const response = await fetch(url, {
headers: {
Accept: "text/html",
@@ -200,32 +184,136 @@ async function fetchContributionsHTML(username: string, year?: number): Promise<
});
if (!response.ok) {
- if (response.status === 404) {
- throw new Error(`User not found: ${username}`);
- }
+ if (response.status === 404) throw new Error(`User not found: ${username}`);
throw new Error(`GitHub error: ${response.status}`);
}
const html = await response.text();
- return parseContributionCalendar(html, username, targetYear);
+ return parseContributionCalendar(html, username, year);
+}
+
+async function fetchContributionsHTML(username: string, year?: number): Promise {
+ const now = new Date();
+ const currentYear = now.getFullYear();
+ const targetYear = year ?? currentYear;
+
+ // If specific past year requested, just fetch it
+ if (targetYear !== currentYear) {
+ return fetchYear(username, targetYear);
+ }
+
+ // For rolling year (current), fetch this year AND last year
+ const [currentGrid, prevGrid] = await Promise.all([
+ fetchYear(username, currentYear),
+ fetchYear(username, currentYear - 1),
+ ]);
+
+ // Merge logic
+ // 1. Flatten both grids to list of days
+ const allDays: GitHubContribution[] = [];
+
+ // Helper to push week days
+ const pushWeeks = (weeks: GitHubContribution[][]) => {
+ for (const week of weeks) {
+ for (const day of week) {
+ if (day.date) allDays.push(day);
+ }
+ }
+ };
+
+ pushWeeks(prevGrid.weeks);
+ pushWeeks(currentGrid.weeks);
+
+ // 2. Sort to be safe
+ allDays.sort((a, b) => a.date.localeCompare(b.date));
+
+ // 3. Remove duplicates (overlap at year boundary?)
+ const uniqueDays = allDays.filter(
+ (day, index, self) => index === self.findIndex((d) => d.date === day.date),
+ );
+
+ // 4. Slice last 365 days (approx 53 weeks)
+ // We want the graph to end TODAY.
+ // And strip ~1 year back.
+ const oneYearAgo = new Date(now);
+ oneYearAgo.setFullYear(now.getFullYear() - 1);
+ oneYearAgo.setDate(oneYearAgo.getDate() - oneYearAgo.getDay()); // Align to previous Sunday
+ const fromDate = oneYearAgo.toISOString().split("T")[0];
+ const toDate = now.toISOString().split("T")[0];
+
+ const rollingDays = uniqueDays.filter((d) => d.date >= fromDate && d.date <= toDate);
+
+ // 5. Reconstruct Weeks
+ const weeks: GitHubContribution[][] = [];
+ let currentWeek: GitHubContribution[] = [];
+
+ // Align start to Sunday?
+ // Should we pad the start to make the first week full?
+ // The renderer likely draws whatever we give it.
+ // But standard graph starts on Sunday.
+
+ // Handle edge case of no contributions
+ if (rollingDays.length === 0) {
+ return {
+ username,
+ year: currentYear,
+ totalContributions: 0,
+ weeks: [],
+ };
+ }
+
+ // Find the day of week of the first day
+ const firstDayObj = new Date(rollingDays[0].date);
+ const firstDayOfWeek = firstDayObj.getDay(); // 0 = Sunday
+
+ // Pad beginning if not Sunday
+ for (let i = 0; i < firstDayOfWeek; i++) {
+ currentWeek.push({ date: "", count: 0, level: 0 });
+ }
+
+ for (const day of rollingDays) {
+ currentWeek.push(day);
+ if (currentWeek.length === 7) {
+ weeks.push(currentWeek);
+ currentWeek = [];
+ }
+ }
+
+ // Pad end
+ if (currentWeek.length > 0) {
+ while (currentWeek.length < 7) {
+ currentWeek.push({ date: "", count: 0, level: 0 });
+ }
+ weeks.push(currentWeek);
+ }
+
+ // Calculate total
+ const totalContributions = rollingDays.reduce((acc, d) => acc + d.count, 0);
+
+ return {
+ username,
+ year: currentYear,
+ totalContributions,
+ weeks,
+ };
}
// We approximate missing counts from the visual level so the grid stays usable even without data-count.
+// NOTE: This is a heuristic (level * 3) and may result in inaccurate totals compared to the actual contribution count.
+// GitHub's HTML often omits the exact count for public scraping, or hides it in tooltips.
function contributionCountFromLevel(level: number): number {
if (level <= 0) return 0;
return level * 3;
}
function parseContributionCalendar(html: string, username: string, year: number): ContributionGrid {
- // Parse the contribution calendar from GitHub's HTML
- // The calendar contains elements with data-date and data-level attributes
-
const weeks: GitHubContribution[][] = [];
let currentWeek: GitHubContribution[] = [];
let totalContributions = 0;
// Match all contribution day cells
// GitHub uses:
+ // We use a robust regex that captures date, count (optional), and level
const dayPattern =
/ ]*data-date="(\d{4}-\d{2}-\d{2})"[^>]*?(?:data-count="(\d+)"[^>]*?)?data-level="(-?\d+)"[^>]*>/g;
const days: Array<{ date: string; level: number; count?: number }> = [];
@@ -243,6 +331,7 @@ function parseContributionCalendar(html: string, username: string, year: number)
/ ]*data-level="(-?\d+)"[^>]*?(?:data-count="(\d+)"[^>]*?)?data-date="(\d{4}-\d{2}-\d{2})"[^>]*>/g;
for (const match of html.matchAll(altPattern)) {
// Avoid duplicates
+ // Capturing groups: 1=level, 2=count(opt), 3=date
const date = match[3];
if (!days.some((d) => d.date === date)) {
days.push({
@@ -253,54 +342,45 @@ function parseContributionCalendar(html: string, username: string, year: number)
}
}
- // Sort by date
+ // Sort
days.sort((a, b) => a.date.localeCompare(b.date));
- // Group into weeks (7 days each)
+ // Build grid with Sunday alignment
+ if (days.length > 0) {
+ const firstDate = new Date(days[0].date);
+ const dayOfWeek = firstDate.getDay(); // 0 = Sunday
+
+ // Pad beginning
+ for (let i = 0; i < dayOfWeek; i++) {
+ currentWeek.push({ date: "", count: 0, level: 0 });
+ }
+ }
+
for (const day of days) {
const level = Math.max(0, Math.min(4, day.level)) as 0 | 1 | 2 | 3 | 4;
const count = day.count ?? contributionCountFromLevel(level);
totalContributions += count;
-
currentWeek.push({
date: day.date,
count,
level,
});
- // New week every 7 days
if (currentWeek.length === 7) {
weeks.push(currentWeek);
currentWeek = [];
}
}
- // Don't forget the last partial week
if (currentWeek.length > 0) {
- // Pad to 7 days if needed
+ // Pad end
while (currentWeek.length < 7) {
- currentWeek.push({
- date: "",
- count: 0,
- level: 0,
- });
+ currentWeek.push({ date: "", count: 0, level: 0 });
}
weeks.push(currentWeek);
}
- // If no data found, create empty grid
- if (weeks.length === 0) {
- console.warn("No contribution data found in HTML, creating empty grid");
- for (let w = 0; w < 53; w++) {
- const week: GitHubContribution[] = [];
- for (let d = 0; d < 7; d++) {
- week.push({ date: "", count: 0, level: 0 });
- }
- weeks.push(week);
- }
- }
-
return {
username,
year,
diff --git a/packages/renderer/README.md b/packages/renderer/README.md
index 65eb213..7bb19f1 100644
--- a/packages/renderer/README.md
+++ b/packages/renderer/README.md
@@ -38,21 +38,23 @@ const animatedSvg = renderAnimatedSVG(frames, {
## API
-| Function | Description |
-|----------|-------------|
-| `renderStaticSVG(grid, snake, options)` | Render single frame |
-| `renderAnimatedSVG(frames, options)` | Render animated SVG |
-| `renderGridSVG(grid, snake, options)` | ⚠️ Deprecated – use `renderStaticSVG` |
+| Function | Description |
+| --------------------------------------- | ------------------------------------ |
+| `renderStaticSVG(grid, snake, options)` | Render single frame |
+| `renderAnimatedSVG(frames, options)` | Render animated SVG |
+| `renderGridSVG(grid, snake, options)` | ⚠️ Deprecated – use `renderStaticSVG` |
## Available Themes
-| Theme | Description |
-|-------|-------------|
-| `github` | Classic GitHub green |
-| `ocean` | Blue ocean waves |
-| `synthwave` | Retro neon purple/pink |
-| `cypherpunk` | Blue/magenta cyberpunk |
-| `glass` | Glassmorphism (GIF only, v1.1+) |
+| Theme | Description |
+| -------------- | ------------------------------- |
+| `github-light` | GitHub's default light theme |
+| `github-dark` | GitHub's dark mode |
+| `ocean` | Cool blue ocean tones |
+| `sunset` | Warm sunset vibes |
+| `neon-gamer` | Vibrant neon purple/green |
+| `cypherpunk` | Blue/magenta cyberpunk |
+| `glass` | Glassmorphism (GIF only, v1.1+) |
## Related Packages
diff --git a/packages/ui/package.json b/packages/ui/package.json
index bbc5a37..8ec101c 100644
--- a/packages/ui/package.json
+++ b/packages/ui/package.json
@@ -22,6 +22,6 @@
"@types/react": "^19.2.10"
},
"peerDependencies": {
- "react": "^19.2.4"
+ "react": "^18.0.0 || ^19.0.0"
}
}
diff --git a/scripts/README.md b/scripts/README.md
index bd029b2..d3c46c4 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -29,7 +29,7 @@ chmod +x scripts/setup-mac.sh
**After running:**
-1. Open http://localhost for Appwrite
+1. Open http://localhost:80 for Appwrite
2. Create account and project
3. Add API key to `.env.local`
4. Run `bun dev`
From 06e3bcce68eff2ad8befee4763525c554431c726 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 13:39:43 +0100
Subject: [PATCH 14/29] chore: final polish - fix roadmap dates, secure github
fetch, update docs stats
---
.github/workflows/generate-demo.yml | 2 +-
.vscode/snake-evolution.code-workspace | 36 +++++++++----
README.md | 1 +
RELEASE_SETUP.md | 51 ++++++++++++++++++
__tests__/docs/documentation.test.ts | 53 +++++++++++--------
__tests__/package-config.test.ts | 4 +-
.../content/docs/guides/gif-implementation.md | 6 ++-
.../docs/testing/unit-tests-generated.md | 4 +-
assets/examples/cypherpunk.svg | 2 +-
assets/examples/github-dark.svg | 2 +-
assets/examples/github-light.svg | 2 +-
assets/examples/neon-gamer.svg | 2 +-
assets/examples/ocean.svg | 2 +-
assets/examples/sunset.svg | 2 +-
biome.json | 2 +-
bun.lock | 8 +--
package.json | 1 +
packages/biome-config/biome.json | 2 +-
packages/cli/package.json | 2 +-
packages/github/src/index.ts | 27 +++++++---
packages/renderer/README.md | 2 +-
21 files changed, 154 insertions(+), 59 deletions(-)
create mode 100644 RELEASE_SETUP.md
diff --git a/.github/workflows/generate-demo.yml b/.github/workflows/generate-demo.yml
index 3ff65e7..24555b3 100644
--- a/.github/workflows/generate-demo.yml
+++ b/.github/workflows/generate-demo.yml
@@ -25,7 +25,7 @@ jobs:
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
- bun-version: 1.3.5
+ bun-version: 1.3.7
- name: Install dependencies
run: bun install --frozen-lockfile
diff --git a/.vscode/snake-evolution.code-workspace b/.vscode/snake-evolution.code-workspace
index 9593cdf..6e697b0 100644
--- a/.vscode/snake-evolution.code-workspace
+++ b/.vscode/snake-evolution.code-workspace
@@ -1,36 +1,52 @@
{
"folders": [
{
- "name": "🐍 root",
+ "name": "|___🐍 SNAKE",
"path": ".."
},
{
- "name": "📦 packages/cli",
+ "name": " |___🌐 WEB",
+ "path": "../apps/web"
+ },
+ {
+ "name": " |___⚡ API",
+ "path": "../apps/api"
+ },
+ {
+ "name": " |___📦 CLI",
"path": "../packages/cli"
},
{
- "name": "📦 packages/engine",
+ "name": " |___📦 ENGINE",
"path": "../packages/engine"
},
{
- "name": "📦 packages/renderer",
+ "name": " |___📦 RENDER",
"path": "../packages/renderer"
},
{
- "name": "📦 packages/github",
+ "name": " |___📦 GITHUB",
"path": "../packages/github"
},
{
- "name": "📦 packages/types",
+ "name": " |___📦 TYPES",
"path": "../packages/types"
},
- {
- "name": "🌐 apps/web",
- "path": "../apps/web"
- },
{
"name": "⚡ apps/api",
"path": "../apps/api"
+ },
+ {
+ "name": "|___📚 KNOWLEDGE",
+ "path": "../../snake-knowledge"
+ },
+ {
+ "name": "|___🪦 SNAKE (legacy)",
+ "path": "../../contributions-devouring-snake"
+ },
+ {
+ "name": "ALL...",
+ "path": "../../"
}
],
"extensions": {
diff --git a/README.md b/README.md
index a02a414..b22d769 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,7 @@ Add this into your README.md
```markdown

```
+
### HTML in Markdown
Add this into your README.md for centered image with dark/light mode support
diff --git a/RELEASE_SETUP.md b/RELEASE_SETUP.md
new file mode 100644
index 0000000..e67dc6b
--- /dev/null
+++ b/RELEASE_SETUP.md
@@ -0,0 +1,51 @@
+# Release Setup & Process
+
+This document outlines the steps to release new versions of Snake Evolution packages.
+
+## Prerequisites
+
+- **GitHub Repository Settings**: Ensure `Allow auto-merge` is enabled.
+- **Secrets**: `NPM_TOKEN` must be set in GitHub Actions secrets.
+- **Permissions**: You need write access to the repository and npm organization.
+
+## Step 1: Create Changesets
+
+When making changes, generate a changeset file to document them:
+
+```bash
+bun changeset
+```
+
+Select the affected packages and write a summary.
+
+## Step 2: Push Changes
+
+Commit the changeset file along with your code changes.
+
+```bash
+git add .
+git commit -m "feat: my cool feature"
+git push
+```
+
+## Step 3: Create Release Pull Request
+
+When `main` has new changesets, the "Release" GitHub Action will automatically create a "Release Packages" PR.
+
+## Step 4: Verify Release
+
+1. Review the Release PR.
+2. Ensure tests pass in CI.
+3. Check the CHANGELOG updates.
+
+## Step 5: Merge and Publish
+
+Merge the Release PR. The GitHub Action will detect the merge, create a git tag for the release, build the packages, and publish them to npm.
+
+*Key actions:* `git tag`, `release` workflow.
+
+## Verification Checklist
+
+- [ ] All tests passed
+- [ ] Documentation updated
+- [ ] Changelog is correct
diff --git a/__tests__/docs/documentation.test.ts b/__tests__/docs/documentation.test.ts
index 3f25e6b..d0ad207 100644
--- a/__tests__/docs/documentation.test.ts
+++ b/__tests__/docs/documentation.test.ts
@@ -13,9 +13,12 @@ describe("Documentation Files", () => {
expect(content.length).toBeGreaterThan(100);
});
- test("should have main heading", () => {
+ test("should have main heading or banner", () => {
content = readFileSync(readmePath, "utf-8");
- expect(content).toMatch(/#+\s*.*Snake Evolution/i);
+ // Matches standard markdown H1 OR HTML img banner
+ const hasHeading = /^#+\s*.*Snake Evolution/i.test(content);
+ const hasBanner = / {
@@ -45,11 +48,12 @@ describe("Documentation Files", () => {
expect(content).toContain("npx @snake-evolution/cli");
});
- test("should mention PvP mode as coming soon", () => {
- content = readFileSync(readmePath, "utf-8");
- // Matches both "PvP mode coming soon" and "Coming Soon: PvP Mode"
- expect(content).toMatch(/(?:pvp.*coming|coming.*pvp)/i);
- });
+ // PvP mode mention removed from README in v1.3.0
+ // test("should mention PvP mode as coming soon", () => {
+ // content = readFileSync(readmePath, "utf-8");
+ // // Matches both "PvP mode coming soon" and "Coming Soon: PvP Mode"
+ // expect(content).toMatch(/(?:pvp.*coming|coming.*pvp)/i);
+ // });
test("should have license information", () => {
content = readFileSync(readmePath, "utf-8");
@@ -122,7 +126,7 @@ describe("Documentation Files", () => {
});
describe("RELEASE_SETUP.md", () => {
- const releasePath = resolve(__dirname, "../RELEASE_SETUP.md");
+ const releasePath = resolve(__dirname, "../../RELEASE_SETUP.md");
let content: string;
test("should exist", () => {
@@ -165,7 +169,7 @@ describe("Documentation Files", () => {
});
describe("ROADMAP.md", () => {
- const roadmapPath = resolve(__dirname, "../ROADMAP.md");
+ const roadmapPath = resolve(__dirname, "../../apps/web/src/content/docs/roadmap.md");
let content: string;
test("should exist", () => {
@@ -190,15 +194,16 @@ describe("Documentation Files", () => {
expect(content).toMatch(/battle/i);
});
- test("should list email signature mode", () => {
- content = readFileSync(roadmapPath, "utf-8");
- expect(content).toMatch(/email signature/i);
- });
-
- test("should mention custom text mode", () => {
- content = readFileSync(roadmapPath, "utf-8");
- expect(content).toMatch(/custom text/i);
- });
+ // Modes removed from Roadmap in 2026 update
+ // test("should list email signature mode", () => {
+ // content = readFileSync(roadmapPath, "utf-8");
+ // expect(content).toMatch(/email signature/i);
+ // });
+ //
+ // test("should mention custom text mode", () => {
+ // content = readFileSync(roadmapPath, "utf-8");
+ // expect(content).toMatch(/custom text/i);
+ // });
});
describe("Documentation Quality", () => {
@@ -206,8 +211,9 @@ describe("Documentation Files", () => {
const docs = [
"../../README.md",
"../../.github/CONTRIBUTING.md",
- "../RELEASE_SETUP.md",
- "../ROADMAP.md",
+ "../../.github/CONTRIBUTING.md",
+ "../../RELEASE_SETUP.md",
+ "../../apps/web/src/content/docs/roadmap.md",
];
docs.forEach((docPath) => {
@@ -226,8 +232,9 @@ describe("Documentation Files", () => {
const docs = [
{ path: "../../README.md", minSize: 2000 },
{ path: "../../.github/CONTRIBUTING.md", minSize: 3000 },
- { path: "../RELEASE_SETUP.md", minSize: 1000 },
- { path: "../ROADMAP.md", minSize: 1000 },
+ { path: "../../.github/CONTRIBUTING.md", minSize: 3000 },
+ { path: "../../RELEASE_SETUP.md", minSize: 500 },
+ { path: "../../apps/web/src/content/docs/roadmap.md", minSize: 1000 },
];
docs.forEach(({ path, minSize }) => {
@@ -238,7 +245,7 @@ describe("Documentation Files", () => {
});
test("no documentation should contain placeholder TODO", () => {
- const docs = ["../../README.md", "../../.github/CONTRIBUTING.md", "../RELEASE_SETUP.md"];
+ const docs = ["../../README.md", "../../.github/CONTRIBUTING.md", "../../RELEASE_SETUP.md"];
docs.forEach((docPath) => {
const fullPath = resolve(__dirname, docPath);
diff --git a/__tests__/package-config.test.ts b/__tests__/package-config.test.ts
index 6712ff7..fa4621b 100644
--- a/__tests__/package-config.test.ts
+++ b/__tests__/package-config.test.ts
@@ -27,7 +27,7 @@ describe("Package Configuration", () => {
test("should specify Node.js >= 22", () => {
expect(pkg.engines).toBeDefined();
const engines = pkg.engines as Record;
- expect(engines.node).toMatch(/>=\s*22/);
+ expect(engines.node).toMatch(/>=\s*24/);
});
test("should specify Bun >= 1.3.0", () => {
@@ -196,7 +196,7 @@ describe("Package Configuration", () => {
expect(pkg.engines).toBeDefined();
const engines = pkg.engines as Record;
- expect(engines.node).toMatch(/>=\s*22/);
+ expect(engines.node).toMatch(/>=\s*24/);
});
});
});
diff --git a/apps/web/src/content/docs/guides/gif-implementation.md b/apps/web/src/content/docs/guides/gif-implementation.md
index 0fc149e..c458486 100644
--- a/apps/web/src/content/docs/guides/gif-implementation.md
+++ b/apps/web/src/content/docs/guides/gif-implementation.md
@@ -161,6 +161,7 @@ export async function renderAnimatedGIFSampled(
**File:** `packages/cli/src/index.ts`
```typescript
+import { writeFileSync } from "node:fs";
import { renderAnimatedGIF } from "@snake-evolution/renderer";
// In generate action:
@@ -225,6 +226,7 @@ export function validateOutputFormat(format: string, theme: string) {
- Total: ~5-10 seconds for typical animation
### Memory
+
- Hold one frame in memory at a time
- ~4 bytes per pixel × 847 × 112 = ~370 KB per frame
- GIF encoder streams, doesn't buffer all frames
@@ -256,7 +258,7 @@ bun run snake generate -u octocat -f gif -o glass.gif -t glass
bun test packages/renderer/src/gif.test.ts
```
-## Bun 1.3.5 Features
+## Bun 1.3.7 Features
Relevant features for GIF implementation:
@@ -271,4 +273,4 @@ Relevant features for GIF implementation:
- [resvg-js on npm](https://www.npmjs.com/package/@resvg/resvg-js)
- [gifenc on GitHub](https://github.com/mattdesl/gifenc)
-- [Bun 1.3.5 release notes](https://bun.sh/blog/bun-v1.3.5)
+- [Bun 1.3.7 release notes](https://bun.sh/blog/bun-v1.3.7)
diff --git a/apps/web/src/content/docs/testing/unit-tests-generated.md b/apps/web/src/content/docs/testing/unit-tests-generated.md
index db53dbb..9b45fde 100644
--- a/apps/web/src/content/docs/testing/unit-tests-generated.md
+++ b/apps/web/src/content/docs/testing/unit-tests-generated.md
@@ -181,8 +181,8 @@ Generated **104+ comprehensive unit tests** for all code changes in this branch,
## Running Tests
```bash
-# Run all tests in the repository
-cd /home/jailuser/git
+# Run all tests (from the repository root)
+cd
bun test
# Run specific package tests
diff --git a/assets/examples/cypherpunk.svg b/assets/examples/cypherpunk.svg
index a4cd160..3ffe771 100644
--- a/assets/examples/cypherpunk.svg
+++ b/assets/examples/cypherpunk.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/github-dark.svg b/assets/examples/github-dark.svg
index d8c6a78..5e58a69 100644
--- a/assets/examples/github-dark.svg
+++ b/assets/examples/github-dark.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/github-light.svg b/assets/examples/github-light.svg
index dd25bda..380945c 100644
--- a/assets/examples/github-light.svg
+++ b/assets/examples/github-light.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/neon-gamer.svg b/assets/examples/neon-gamer.svg
index f037380..0795288 100644
--- a/assets/examples/neon-gamer.svg
+++ b/assets/examples/neon-gamer.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/ocean.svg b/assets/examples/ocean.svg
index e4165b0..973912a 100644
--- a/assets/examples/ocean.svg
+++ b/assets/examples/ocean.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/assets/examples/sunset.svg b/assets/examples/sunset.svg
index 2330df5..09ea28c 100644
--- a/assets/examples/sunset.svg
+++ b/assets/examples/sunset.svg
@@ -1 +1 @@
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/biome.json b/biome.json
index 11a2d8b..4b04536 100644
--- a/biome.json
+++ b/biome.json
@@ -1,5 +1,5 @@
{
- "$schema": "https://biomejs.dev/schemas/2.3.10/schema.json",
+ "$schema": "https://biomejs.dev/schemas/2.3.13/schema.json",
"vcs": {
"enabled": true,
"clientKind": "git",
diff --git a/bun.lock b/bun.lock
index 4f14793..786e27d 100644
--- a/bun.lock
+++ b/bun.lock
@@ -54,7 +54,7 @@
"@snake-evolution/github": "workspace:*",
"@snake-evolution/renderer": "workspace:*",
"@snake-evolution/types": "workspace:*",
- "@types/node": "^25.1.0",
+ "@types/node": "^24.0.0",
"commander": "^14.0.2",
},
},
@@ -98,7 +98,7 @@
"@types/react": "^19.2.10",
},
"peerDependencies": {
- "react": "^19.2.4",
+ "react": "^18.0.0 || ^19.0.0",
},
},
},
@@ -541,7 +541,7 @@
"@types/nlcst": ["@types/nlcst@2.0.3", "", { "dependencies": { "@types/unist": "*" } }, "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA=="],
- "@types/node": ["@types/node@25.1.0", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-t7frlewr6+cbx+9Ohpl0NOTKXZNV9xHRmNOvql47BFJKcEG1CxtxlPEEe+gR9uhVWM4DwhnvTF110mIL4yP9RA=="],
+ "@types/node": ["@types/node@24.10.9", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-ne4A0IpG3+2ETuREInjPNhUGis1SFjv1d5asp8MzEAGtOZeTeHVDOYqOgqfhvseqg/iXty2hjBf1zAOb7RNiNw=="],
"@types/react": ["@types/react@19.2.10", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-WPigyYuGhgZ/cTPRXB2EwUw+XvsRA3GqHlsP4qteqrnnjDrApbS7MxcGr/hke5iUoeB7E/gQtrs9I37zAJ0Vjw=="],
@@ -1595,6 +1595,8 @@
"boxen/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
+ "bun-types/@types/node": ["@types/node@25.1.0", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-t7frlewr6+cbx+9Ohpl0NOTKXZNV9xHRmNOvql47BFJKcEG1CxtxlPEEe+gR9uhVWM4DwhnvTF110mIL4yP9RA=="],
+
"cliui/string-width": ["string-width@4.2.3", "", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="],
"cliui/wrap-ansi": ["wrap-ansi@7.0.0", "", { "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", "strip-ansi": "^6.0.0" } }, "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q=="],
diff --git a/package.json b/package.json
index 9366358..470bab9 100644
--- a/package.json
+++ b/package.json
@@ -30,6 +30,7 @@
"reinstall": "bun run clean && bun install",
"snake": "bun run packages/cli/src/index.ts",
"generate": "bun run packages/cli/src/index.ts generate",
+ "quality": "bun run lint:fix && bun run format && bun run typecheck && bun run test && bun run packages/cli/src/index.ts generate -u miccy -t github-dark -o dist/smoke-check.svg",
"changeset": "changeset",
"version": "changeset version",
"release": "changeset publish"
diff --git a/packages/biome-config/biome.json b/packages/biome-config/biome.json
index 172a490..fee9319 100644
--- a/packages/biome-config/biome.json
+++ b/packages/biome-config/biome.json
@@ -1,5 +1,5 @@
{
- "$schema": "https://biomejs.dev/schemas/2.3.10/schema.json",
+ "$schema": "https://biomejs.dev/schemas/2.3.13/schema.json",
"root": false,
"linter": {
"enabled": true,
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 981c953..c2fbdda 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -44,7 +44,7 @@
"@snake-evolution/github": "workspace:*",
"@snake-evolution/renderer": "workspace:*",
"@snake-evolution/types": "workspace:*",
- "@types/node": "^25.1.0",
+ "@types/node": "^24.0.0",
"commander": "^14.0.2"
},
"engines": {
diff --git a/packages/github/src/index.ts b/packages/github/src/index.ts
index 0165979..03dffb7 100644
--- a/packages/github/src/index.ts
+++ b/packages/github/src/index.ts
@@ -203,9 +203,23 @@ async function fetchContributionsHTML(username: string, year?: number): Promise<
}
// For rolling year (current), fetch this year AND last year
+ // Use try/catch for previous year to handle new users gracefully
const [currentGrid, prevGrid] = await Promise.all([
fetchYear(username, currentYear),
- fetchYear(username, currentYear - 1),
+ fetchYear(username, currentYear - 1).catch((error) => {
+ // Only swallow 404s (User not found) or "Not Found" errors
+ // Propagate other errors (rate limits, network issues, etc.)
+ const msg = error instanceof Error ? error.message : String(error);
+ if (msg.includes("User not found") || msg.includes("404")) {
+ return {
+ weeks: [],
+ totalContributions: 0,
+ year: currentYear - 1,
+ username,
+ } as ContributionGrid;
+ }
+ throw error;
+ }),
]);
// Merge logic
@@ -262,9 +276,9 @@ async function fetchContributionsHTML(username: string, year?: number): Promise<
};
}
- // Find the day of week of the first day
- const firstDayObj = new Date(rollingDays[0].date);
- const firstDayOfWeek = firstDayObj.getDay(); // 0 = Sunday
+ // Find the day of week of the first day using UTC to avoid timezone shifts
+ const [y, m, d] = rollingDays[0].date.split("-").map(Number);
+ const firstDayOfWeek = new Date(Date.UTC(y, m - 1, d)).getUTCDay(); // 0 = Sunday
// Pad beginning if not Sunday
for (let i = 0; i < firstDayOfWeek; i++) {
@@ -347,8 +361,9 @@ function parseContributionCalendar(html: string, username: string, year: number)
// Build grid with Sunday alignment
if (days.length > 0) {
- const firstDate = new Date(days[0].date);
- const dayOfWeek = firstDate.getDay(); // 0 = Sunday
+ // Parse date in UTC to ensure consistent day of week
+ const [y, m, d] = days[0].date.split("-").map(Number);
+ const dayOfWeek = new Date(Date.UTC(y, m - 1, d)).getUTCDay(); // 0 = Sunday
// Pad beginning
for (let i = 0; i < dayOfWeek; i++) {
diff --git a/packages/renderer/README.md b/packages/renderer/README.md
index 7bb19f1..80e11c8 100644
--- a/packages/renderer/README.md
+++ b/packages/renderer/README.md
@@ -6,7 +6,7 @@ SVG renderer for Snake Evolution. Generates static and animated SVG images from
- 🖼️ **Static SVG** – Single-frame renders
- 🎬 **Animated SVG** – SMIL-based animations (like Platane's original)
-- 🎨 **Theming** – Multiple color palettes (GitHub, Ocean, Synthwave, CypherPunk)
+- 🎨 **Theming** – 7 built-in palettes including GitHub Light/Dark, Ocean, Neon Gamer, and Cypherpunk
- ⚡ **Performant** – Optimized for GitHub profile embedding
## Installation
From 8335365edf9c5a383f74495528799d610259ad03 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 14:28:18 +0100
Subject: [PATCH 15/29] feat: Add Biome formatting, simplify type-checking
scripts, and clean up VS Code workspace configuration.
---
.vscode/snake-evolution.code-workspace | 12 ------------
package.json | 1 -
packages/github/src/index.ts | 4 ++--
turbo.json | 8 ++++++++
4 files changed, 10 insertions(+), 15 deletions(-)
diff --git a/.vscode/snake-evolution.code-workspace b/.vscode/snake-evolution.code-workspace
index 6e697b0..e6f6fc8 100644
--- a/.vscode/snake-evolution.code-workspace
+++ b/.vscode/snake-evolution.code-workspace
@@ -35,18 +35,6 @@
{
"name": "⚡ apps/api",
"path": "../apps/api"
- },
- {
- "name": "|___📚 KNOWLEDGE",
- "path": "../../snake-knowledge"
- },
- {
- "name": "|___🪦 SNAKE (legacy)",
- "path": "../../contributions-devouring-snake"
- },
- {
- "name": "ALL...",
- "path": "../../"
}
],
"extensions": {
diff --git a/package.json b/package.json
index 470bab9..282ef03 100644
--- a/package.json
+++ b/package.json
@@ -23,7 +23,6 @@
"format": "biome format --write .",
"format:check": "biome format .",
"typecheck": "tsc --noEmit && turbo run type-check",
- "type-check": "bun run typecheck",
"check": "bun run lint && bun run typecheck",
"fix": "bun run lint:fix",
"clean": "turbo run clean && rm -rf .turbo node_modules",
diff --git a/packages/github/src/index.ts b/packages/github/src/index.ts
index 03dffb7..082f368 100644
--- a/packages/github/src/index.ts
+++ b/packages/github/src/index.ts
@@ -278,10 +278,10 @@ async function fetchContributionsHTML(username: string, year?: number): Promise<
// Find the day of week of the first day using UTC to avoid timezone shifts
const [y, m, d] = rollingDays[0].date.split("-").map(Number);
- const firstDayOfWeek = new Date(Date.UTC(y, m - 1, d)).getUTCDay(); // 0 = Sunday
+ const startDayOfWeek = new Date(Date.UTC(y, m - 1, d)).getUTCDay(); // 0 = Sunday
// Pad beginning if not Sunday
- for (let i = 0; i < firstDayOfWeek; i++) {
+ for (let i = 0; i < startDayOfWeek; i++) {
currentWeek.push({ date: "", count: 0, level: 0 });
}
diff --git a/turbo.json b/turbo.json
index 023e84a..cabf94c 100644
--- a/turbo.json
+++ b/turbo.json
@@ -21,6 +21,14 @@
"outputs": [],
"cache": true
},
+ "format": {
+ "outputs": [],
+ "cache": true
+ },
+ "format:check": {
+ "outputs": [],
+ "cache": true
+ },
"lint:fix": {
"outputs": [],
"cache": false
From f1fd756874544ea5aba1fb0e77da433322a2d50f Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 14:37:50 +0100
Subject: [PATCH 16/29] feat: Enhance GIF generation robustness with input
validation and error handling, update roadmap dates to 2026, and bump Node.js
engine requirement to v24.
---
__tests__/docs/documentation.test.ts | 2 -
__tests__/package-config.test.ts | 2 +-
.../content/docs/guides/gif-implementation.md | 100 ++++++++++++------
apps/web/src/content/docs/roadmap.md | 20 ++--
.../docs/testing/unit-tests-generated.md | 2 +-
5 files changed, 81 insertions(+), 45 deletions(-)
diff --git a/__tests__/docs/documentation.test.ts b/__tests__/docs/documentation.test.ts
index d0ad207..14a5ef6 100644
--- a/__tests__/docs/documentation.test.ts
+++ b/__tests__/docs/documentation.test.ts
@@ -211,7 +211,6 @@ describe("Documentation Files", () => {
const docs = [
"../../README.md",
"../../.github/CONTRIBUTING.md",
- "../../.github/CONTRIBUTING.md",
"../../RELEASE_SETUP.md",
"../../apps/web/src/content/docs/roadmap.md",
];
@@ -232,7 +231,6 @@ describe("Documentation Files", () => {
const docs = [
{ path: "../../README.md", minSize: 2000 },
{ path: "../../.github/CONTRIBUTING.md", minSize: 3000 },
- { path: "../../.github/CONTRIBUTING.md", minSize: 3000 },
{ path: "../../RELEASE_SETUP.md", minSize: 500 },
{ path: "../../apps/web/src/content/docs/roadmap.md", minSize: 1000 },
];
diff --git a/__tests__/package-config.test.ts b/__tests__/package-config.test.ts
index fa4621b..26b9deb 100644
--- a/__tests__/package-config.test.ts
+++ b/__tests__/package-config.test.ts
@@ -24,7 +24,7 @@ describe("Package Configuration", () => {
expect(pkg.private).toBe(true);
});
- test("should specify Node.js >= 22", () => {
+ test("should specify Node.js >= 24", () => {
expect(pkg.engines).toBeDefined();
const engines = pkg.engines as Record;
expect(engines.node).toMatch(/>=\s*24/);
diff --git a/apps/web/src/content/docs/guides/gif-implementation.md b/apps/web/src/content/docs/guides/gif-implementation.md
index c458486..124752e 100644
--- a/apps/web/src/content/docs/guides/gif-implementation.md
+++ b/apps/web/src/content/docs/guides/gif-implementation.md
@@ -83,6 +83,11 @@ export async function renderAnimatedGIF(
frames: SnakeFrame[],
options: GifOptions = {}
): Promise {
+ // Validate inputs
+ if (!frames || frames.length === 0) {
+ throw new Error("frames must be a non-empty array");
+ }
+
const {
width = 847,
height = 112,
@@ -92,41 +97,65 @@ export async function renderAnimatedGIF(
...renderOptions
} = options;
+ if (width <= 0 || height <= 0 || frameDelay <= 0) {
+ throw new Error("width, height, and frameDelay must be positive numbers");
+ }
+
const gif = GIFEncoder();
const total = frames.length;
- for (let i = 0; i < frames.length; i++) {
- const frame = frames[i];
-
- // Progress callback
- if (onProgress) onProgress(i + 1, total);
-
- // 1. Render static SVG for this frame
- const svg = renderStaticSVG(frame.grid, frame.snake, renderOptions);
-
- // 2. Convert SVG to RGBA pixels using resvg (WASM)
- const resvg = new Resvg(svg, {
- fitTo: { mode: "width", value: width },
- });
- const rendered = resvg.render();
- const pixels = rendered.pixels; // Uint8Array RGBA
- const actualWidth = rendered.width;
- const actualHeight = rendered.height;
-
- // 3. Quantize colors (GIF max 256)
- const palette = quantize(pixels, 256, { format: "rgba4444" });
- const indexed = applyPalette(pixels, palette, "rgba4444");
-
- // 4. Add frame to GIF
- gif.writeFrame(indexed, actualWidth, actualHeight, {
- palette,
- delay: frameDelay,
- dispose: 2, // restore to background
- });
+ try {
+ for (let i = 0; i < frames.length; i++) {
+ const frame = frames[i];
+
+ // Progress callback
+ if (onProgress) onProgress(i + 1, total);
+
+ try {
+ // 1. Render static SVG for this frame
+ const svg = renderStaticSVG(frame.grid, frame.snake, renderOptions);
+
+ // 2. Convert SVG to RGBA pixels using resvg (WASM)
+ const resvg = new Resvg(svg, {
+ fitTo: { mode: "width", value: width },
+ });
+ const rendered = resvg.render();
+ const pixels = rendered.pixels; // Uint8Array RGBA
+ const actualWidth = rendered.width;
+ const actualHeight = rendered.height;
+
+ // 3. Quantize colors (GIF max 256)
+ const palette = quantize(pixels, 256, { format: "rgba4444" });
+ const indexed = applyPalette(pixels, palette, "rgba4444");
+
+ // 4. Add frame to GIF
+ gif.writeFrame(indexed, actualWidth, actualHeight, {
+ palette,
+ delay: frameDelay,
+ dispose: 2, // restore to background
+ });
+ } catch (err) {
+ // Annotate error with frame index
+ const error = err instanceof Error ? err : new Error(String(err));
+ throw new Error(`Frame ${i} failed: ${error.message}`);
+ }
+ }
+
+ gif.finish();
+ return Buffer.from(gif.bytes());
+ } catch (error) {
+ if (onProgress) {
+ // Optional: signal failure via callback if contract supports it
+ }
+ throw error;
+ } finally {
+ // Ensure cleanup so internal streams are finalized even on error
+ try {
+ // Verify if finish() is safe to call multiple times or check internal state if possible
+ // gifenc's finish() writes the trailer.
+ gif.finish();
+ } catch {}
}
-
- gif.finish();
- return Buffer.from(gif.bytes());
}
```
@@ -141,12 +170,21 @@ export async function renderAnimatedGIFSampled(
): Promise {
const { sampleRate = 1, ...gifOptions } = options;
+ if (sampleRate < 1 || !Number.isInteger(sampleRate)) {
+ throw new Error("sampleRate must be a positive integer");
+ }
+
if (sampleRate <= 1) {
return renderAnimatedGIF(frames, gifOptions);
}
// Sample every Nth frame, adjust delay accordingly
const sampled = frames.filter((_, i) => i % sampleRate === 0);
+
+ if (sampled.length < 2) {
+ console.warn(`sampleRate ${sampleRate} too high, resulting in only ${sampled.length} frame(s)`);
+ }
+
const adjustedDelay = (gifOptions.frameDelay || 150) * sampleRate;
return renderAnimatedGIF(sampled, {
diff --git a/apps/web/src/content/docs/roadmap.md b/apps/web/src/content/docs/roadmap.md
index 35c7565..492cc32 100644
--- a/apps/web/src/content/docs/roadmap.md
+++ b/apps/web/src/content/docs/roadmap.md
@@ -43,7 +43,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨
---
-## 🚀 Phase 1: v1.3.0 - Foundation Completion (January 2025)
+## 🚀 Phase 1: v1.3.0 - Foundation Completion (January 2026)
**Goal:** Ship GIF, complete v1 vision, establish ethical positioning
@@ -64,7 +64,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨
---
-## 🎨 Phase 2: v2.0 - Interactive Web Platform (Q1 2025)
+## 🎨 Phase 2: v2.0 - Interactive Web Platform (Q1 2026)
**Goal:** Full-featured playground with save/share functionality
@@ -91,7 +91,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨
---
-## 💰 Phase 2.5: Monetization Strategy (Q1 2025)
+## 💰 Phase 2.5: Monetization Strategy (Q1 2026)
**Goal:** Sustainable income to fund development.
@@ -102,7 +102,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨
---
-## 🎮 Phase 3: v3.0 - PvP Mode (Q2-Q3 2025)
+## 🎮 Phase 3: v3.0 - PvP Mode (Q2-Q3 2026)
**Core Concept:**
> Two players compete on the same contribution graph.
@@ -119,10 +119,10 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨
## 📅 Revised Timeline
```text
-v1.2.4 ✅ Dec 2024 - Basic functionality
-v1.3.0 ✅ Jan 2025 - GIF + Ethical positioning + Color preview
-v1.4.0 📋 Feb 2025 - Performance optimization + bug fixes
-v2.0.0 📋 Mar 2025 - Full playground launch
-v2.1.0 📋 Apr 2025 - Gallery + social features
-v3.0.0 📋 Q3 2025 - PvP Mode beta
+v1.2.4 ✅ Dec 2025 - Basic functionality
+v1.3.0 ✅ Jan 2026 - GIF + Ethical positioning + Color preview
+v1.4.0 📋 Feb 2026 - Performance optimization + bug fixes
+v2.0.0 📋 Mar 2026 - Full playground launch
+v2.1.0 📋 Apr 2026 - Gallery + social features
+v3.0.0 📋 Q3 2026 - PvP Mode beta
```
diff --git a/apps/web/src/content/docs/testing/unit-tests-generated.md b/apps/web/src/content/docs/testing/unit-tests-generated.md
index 9b45fde..767d04c 100644
--- a/apps/web/src/content/docs/testing/unit-tests-generated.md
+++ b/apps/web/src/content/docs/testing/unit-tests-generated.md
@@ -266,4 +266,4 @@ These comprehensive unit tests provide a solid foundation for the codebase chang
- GitHub parsing: **+253 lines** (new coverage)
- Renderer: **+327 lines** (new coverage)
-**Overall Impact:** From ~100 baseline tests to **250+ total tests** in the project.
+**Overall Impact:** From ~100 baseline tests to **223+ total tests** in the project.
From 0e9bac3de5907e4bb7b4859bb7cc0ba8915552f0 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 14:49:16 +0100
Subject: [PATCH 17/29] docs: Enhance GIF encoder error handling in guide, mark
GIF implementation as shipped, and refine Biome config README.
---
.../content/docs/guides/gif-implementation.md | 17 +++++++++++------
apps/web/src/content/docs/roadmap.md | 2 +-
packages/biome-config/README.md | 9 ++-------
3 files changed, 14 insertions(+), 14 deletions(-)
diff --git a/apps/web/src/content/docs/guides/gif-implementation.md b/apps/web/src/content/docs/guides/gif-implementation.md
index 124752e..da12432 100644
--- a/apps/web/src/content/docs/guides/gif-implementation.md
+++ b/apps/web/src/content/docs/guides/gif-implementation.md
@@ -103,6 +103,7 @@ export async function renderAnimatedGIF(
const gif = GIFEncoder();
const total = frames.length;
+ let finished = false;
try {
for (let i = 0; i < frames.length; i++) {
@@ -142,19 +143,23 @@ export async function renderAnimatedGIF(
}
gif.finish();
+ finished = true;
return Buffer.from(gif.bytes());
} catch (error) {
if (onProgress) {
- // Optional: signal failure via callback if contract supports it
+ // Signal failure if callback supports error payload, or just log
+ // console.error("GIF encoding failed:", error);
}
throw error;
} finally {
// Ensure cleanup so internal streams are finalized even on error
- try {
- // Verify if finish() is safe to call multiple times or check internal state if possible
- // gifenc's finish() writes the trailer.
- gif.finish();
- } catch {}
+ if (!finished) {
+ try {
+ gif.finish();
+ } catch (cleanupError) {
+ console.warn("Failed to cleanup GIF encoder:", cleanupError);
+ }
+ }
}
}
```
diff --git a/apps/web/src/content/docs/roadmap.md b/apps/web/src/content/docs/roadmap.md
index 492cc32..33a5f59 100644
--- a/apps/web/src/content/docs/roadmap.md
+++ b/apps/web/src/content/docs/roadmap.md
@@ -49,7 +49,7 @@ Snake Evolution: ✨ Real data + Gamification + Customization ✨
### Priority 1: GIF Implementation
-**Status:** Shipping in v1.3.0
+**Status:** ✅ Shipped in v1.3.0
- ✅ Glass theme fully supported
- ✅ CLI `--format gif` option
diff --git a/packages/biome-config/README.md b/packages/biome-config/README.md
index 2a4315a..bea2c1d 100644
--- a/packages/biome-config/README.md
+++ b/packages/biome-config/README.md
@@ -6,12 +6,7 @@ Shared [Biome](https://biomejs.dev/) configuration for the Snake Evolution monor
Extend this configuration in your package's `biome.json`:
-```json
-{
- "$schema": "https://biomejs.dev/schemas/2.0.6/schema.json",
- "extends": ["@snake-evolution/biome-config"]
-}
-```
+
## What's Included
@@ -21,5 +16,5 @@ Extend this configuration in your package's `biome.json`:
## Related
-- [Biome Documentation](https://biomejs.dev/docs/)
+- **Formatting** – Consistent code style (2-space indentation, LF line endings)
- [`@snake-evolution/typescript-config`](../typescript-config) – TypeScript settings
From 107b8fa5f5b6cb07a73fe0140403f9542eb9404e Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:00:34 +0100
Subject: [PATCH 18/29] chore: Update type checking command from `type-check`
to `typecheck` in CI workflow.
---
.github/workflows/ci.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 42f4dec..f9bdc8f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -41,7 +41,7 @@ jobs:
run: bun run format:check
- name: Type check
- run: bun run type-check
+ run: bun run typecheck
- name: Run tests
run: bun test
From c5f1835baeeaa46102d5a084e87c0baff0ea74a1 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:08:38 +0100
Subject: [PATCH 19/29] feat: Add GIF sampling support, update Node requirement
to 24.0.0, and refine documentation examples and formatting.
---
packages/biome-config/README.md | 2 --
packages/cli/CHANGELOG.md | 2 +-
packages/renderer/README.md | 6 +++++-
3 files changed, 6 insertions(+), 4 deletions(-)
diff --git a/packages/biome-config/README.md b/packages/biome-config/README.md
index bea2c1d..d2d7e84 100644
--- a/packages/biome-config/README.md
+++ b/packages/biome-config/README.md
@@ -6,8 +6,6 @@ Shared [Biome](https://biomejs.dev/) configuration for the Snake Evolution monor
Extend this configuration in your package's `biome.json`:
-
-
## What's Included
- **Linting** – TypeScript-aware rules
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index e2d7489..3270eb9 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -4,7 +4,7 @@
### Minor Changes
-- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation.
+- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24.0.0. Added support for GIF sampling to reduce file size. Overhauled documentation.
## 1.2.4
diff --git a/packages/renderer/README.md b/packages/renderer/README.md
index 80e11c8..b83069f 100644
--- a/packages/renderer/README.md
+++ b/packages/renderer/README.md
@@ -25,7 +25,11 @@ import { simulateSnake } from '@snake-evolution/engine';
const staticSvg = renderStaticSVG(grid, snake, {
cellSize: 12,
gap: 2,
- palette: 'github'
+ const staticSvg = renderStaticSVG(grid, snake, {
+ cellSize: 12,
+ gap: 2,
+ palette: 'github-light'
+ });
});
// Animated render
From e5c07e67ab2eed78605195000c5928fc15879d2d Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:10:59 +0100
Subject: [PATCH 20/29] docs: Update roadmap v3.0.0 release date and test
summary test count.
---
apps/web/src/content/docs/roadmap.md | 4 +++-
apps/web/src/content/docs/testing/test-summary.md | 2 +-
2 files changed, 4 insertions(+), 2 deletions(-)
diff --git a/apps/web/src/content/docs/roadmap.md b/apps/web/src/content/docs/roadmap.md
index 33a5f59..eb39fe9 100644
--- a/apps/web/src/content/docs/roadmap.md
+++ b/apps/web/src/content/docs/roadmap.md
@@ -124,5 +124,7 @@ v1.3.0 ✅ Jan 2026 - GIF + Ethical positioning + Color preview
v1.4.0 📋 Feb 2026 - Performance optimization + bug fixes
v2.0.0 📋 Mar 2026 - Full playground launch
v2.1.0 📋 Apr 2026 - Gallery + social features
-v3.0.0 📋 Q3 2026 - PvP Mode beta
+v3.0.0 📋 Q2-Q3 2026 - PvP Mode beta
+
+> **Note:** Phase 2.5 (Monetization) runs in parallel to v2.x releases, starting Q1 2026.
```
diff --git a/apps/web/src/content/docs/testing/test-summary.md b/apps/web/src/content/docs/testing/test-summary.md
index 77af3f6..f04b25d 100644
--- a/apps/web/src/content/docs/testing/test-summary.md
+++ b/apps/web/src/content/docs/testing/test-summary.md
@@ -265,4 +265,4 @@ These comprehensive tests provide:
- **Regression prevention** for future changes
- **Clear examples** of API usage
-Total test count increased from ~100 to ~250+ tests, with focus on practical scenarios and edge cases.
+Total test count increased from ~100 to 223 tests, with focus on practical scenarios and edge cases.
From a6321d3f3ad931fa063ddbf6a38091387ef237c7 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:17:56 +0100
Subject: [PATCH 21/29] docs: remove duplicated code block from static SVG
example in README.md.
---
packages/renderer/README.md | 6 +-----
1 file changed, 1 insertion(+), 5 deletions(-)
diff --git a/packages/renderer/README.md b/packages/renderer/README.md
index b83069f..481f4a1 100644
--- a/packages/renderer/README.md
+++ b/packages/renderer/README.md
@@ -25,11 +25,7 @@ import { simulateSnake } from '@snake-evolution/engine';
const staticSvg = renderStaticSVG(grid, snake, {
cellSize: 12,
gap: 2,
- const staticSvg = renderStaticSVG(grid, snake, {
- cellSize: 12,
- gap: 2,
- palette: 'github-light'
- });
+ palette: 'github-light'
});
// Animated render
From f804e893f26f7a58cd9804cbcb1915bc35015bc2 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:19:52 +0100
Subject: [PATCH 22/29] Update CHANGELOG.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Miccy
---
CHANGELOG.md | 9 +++++----
1 file changed, 5 insertions(+), 4 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d6800df..ed51233 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,15 +20,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- `packages/biome-config`, `packages/typescript-config`
- `apps/api`, `docker`, `scripts`
-### Changed
+### Breaking Changes
-- **Script Consolidation** - Reduced root package.json scripts from 30 to 21:
- - `format` + `format:check` merged into `lint` (Biome handles both)
+- **Script & Turbo Task Changes (BREAKING)** - Consolidated root `package.json` scripts and removed Turbo tasks that may be referenced in local workflows and CI/CD pipelines:
+ - `format` + `format:check` merged into `lint` (Biome now handles both formatting and checks)
- `quality` + `precommit` consolidated into `check`
- `type-check` renamed to `typecheck`
- `clean:all` merged into `clean`
-- **Turbo Config** - Cleaned up unused tasks (`test:watch`, `format`, `format:check`)
+ - Removed unused Turbo tasks from `turbo.json`: `test:watch`, `format`, `format:check`
+### Changed
### Fixed
- Removed deprecated `@types/dompurify` package (dompurify has built-in types)
From 4ceed5c8f550a6d1f6fd24726be1c95298629d3e Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:20:16 +0100
Subject: [PATCH 23/29] Update README.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Miccy
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index b22d769..42dbece 100644
--- a/README.md
+++ b/README.md
@@ -170,5 +170,5 @@ Original snake concept by [Platane](https://github.com/Platane) 🙏
From b0170704e64e6aea174be648ab5b4a61ae0d6d98 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:26:24 +0100
Subject: [PATCH 24/29] Update CHANGELOG.md
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Miccy
---
CHANGELOG.md | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ed51233..eb68d31 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -29,7 +29,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- `clean:all` merged into `clean`
- Removed unused Turbo tasks from `turbo.json`: `test:watch`, `format`, `format:check`
+
### Changed
+
+_No changes in this category for this release._
+
### Fixed
- Removed deprecated `@types/dompurify` package (dompurify has built-in types)
From eba90ec76af5057cf9af0ad887b780b726701851 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 15:30:15 +0100
Subject: [PATCH 25/29] Update packages/github/src/index.ts
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Miccy
---
packages/github/src/index.ts | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/packages/github/src/index.ts b/packages/github/src/index.ts
index 082f368..8cff4cb 100644
--- a/packages/github/src/index.ts
+++ b/packages/github/src/index.ts
@@ -252,8 +252,9 @@ async function fetchContributionsHTML(username: string, year?: number): Promise<
const oneYearAgo = new Date(now);
oneYearAgo.setFullYear(now.getFullYear() - 1);
oneYearAgo.setDate(oneYearAgo.getDate() - oneYearAgo.getDay()); // Align to previous Sunday
- const fromDate = oneYearAgo.toISOString().split("T")[0];
- const toDate = now.toISOString().split("T")[0];
+ // Use UTC components directly to avoid timezone-induced shifts
+ const fromDate = `${oneYearAgo.getUTCFullYear()}-${String(oneYearAgo.getUTCMonth() + 1).padStart(2, "0")}-${String(oneYearAgo.getUTCDate()).padStart(2, "0")}`;
+ const toDate = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, "0")}-${String(now.getUTCDate()).padStart(2, "0")}`;
const rollingDays = uniqueDays.filter((d) => d.date >= fromDate && d.date <= toDate);
From 321ed1a727ef6b9f13c486a7228b719e2ff3406a Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 16:17:37 +0100
Subject: [PATCH 26/29] fix: CI/CD workflows, linting, and visual tapering
(v1.3.0 final)
---
README.md | 2 +-
__tests__/docs/documentation.test.ts | 7 +++---
apps/web/src/content/docs/roadmap.md | 2 +-
.../docs/testing/unit-tests-generated.md | 3 +--
package.json | 2 +-
packages/renderer/src/index.ts | 16 ++++++++++++-
packages/renderer/src/renderer.test.ts | 24 +++++++++++++------
7 files changed, 40 insertions(+), 16 deletions(-)
diff --git a/README.md b/README.md
index 42dbece..ca7aa51 100644
--- a/README.md
+++ b/README.md
@@ -60,7 +60,7 @@ jobs:
dist/snake-ocean.svg?palette=ocean
- name: Push to Output Branch
- uses: crazy-max/ghaction-github-pages@v3.1.0
+ uses: crazy-max/ghaction-github-pages@v4
with:
target_branch: output
build_dir: dist
diff --git a/__tests__/docs/documentation.test.ts b/__tests__/docs/documentation.test.ts
index 14a5ef6..3df81d4 100644
--- a/__tests__/docs/documentation.test.ts
+++ b/__tests__/docs/documentation.test.ts
@@ -15,10 +15,11 @@ describe("Documentation Files", () => {
test("should have main heading or banner", () => {
content = readFileSync(readmePath, "utf-8");
- // Matches standard markdown H1 OR HTML img banner
- const hasHeading = /^#+\s*.*Snake Evolution/i.test(content);
+ // Matches standard markdown H1 (# Title) OR HTML h1 tag
+ const hasHeading = /^#\s+.*Snake Evolution/i.test(content);
+ const hasHtmlHeading = /.*Snake Evolution.*<\/h1>/i.test(content);
const hasBanner = / {
diff --git a/apps/web/src/content/docs/roadmap.md b/apps/web/src/content/docs/roadmap.md
index eb39fe9..f2881d7 100644
--- a/apps/web/src/content/docs/roadmap.md
+++ b/apps/web/src/content/docs/roadmap.md
@@ -27,7 +27,7 @@ description: Strategic roadmap and vision for Snake Evolution.
```text
gitfiti (2012): Pixel art, playful, 8.3K ⭐
-github-activity: Fake automation, 3.7K ⭐, SKETCHY
+github-activity: Fake automation, 3.7K ⭐, manipulation tool
Snake Evolution: ✨ Real data + Gamification + Customization ✨
TARGET: 10K ⭐ in 6 months
```
diff --git a/apps/web/src/content/docs/testing/unit-tests-generated.md b/apps/web/src/content/docs/testing/unit-tests-generated.md
index 767d04c..6cc926e 100644
--- a/apps/web/src/content/docs/testing/unit-tests-generated.md
+++ b/apps/web/src/content/docs/testing/unit-tests-generated.md
@@ -181,8 +181,7 @@ Generated **104+ comprehensive unit tests** for all code changes in this branch,
## Running Tests
```bash
-# Run all tests (from the repository root)
-cd
+# Run all tests from the repository root
bun test
# Run specific package tests
diff --git a/package.json b/package.json
index 282ef03..c2e759c 100644
--- a/package.json
+++ b/package.json
@@ -22,7 +22,7 @@
"lint:fix": "biome check --write . && markdownlint-cli2 --fix '*.md' 'docs/**/*.md' '.github/**/*.md' 'apps/*/src/**/*.md' 'apps/*/*.md' 'packages/*/*.md' 'packages/*/src/**/*.md' 'docker/*.md' 'scripts/*.md' '__tests__/*.md' --config .markdownlint.jsonc",
"format": "biome format --write .",
"format:check": "biome format .",
- "typecheck": "tsc --noEmit && turbo run type-check",
+ "typecheck": "tsc --noEmit && turbo run type-check --filter='!//'",
"check": "bun run lint && bun run typecheck",
"fix": "bun run lint:fix",
"clean": "turbo run clean && rm -rf .turbo node_modules",
diff --git a/packages/renderer/src/index.ts b/packages/renderer/src/index.ts
index f664972..a85354a 100644
--- a/packages/renderer/src/index.ts
+++ b/packages/renderer/src/index.ts
@@ -89,6 +89,18 @@ function renderSnakeSegments(snake: SnakeState, opts: RenderOptions): string {
const cellX = gap + segment.x * (cellSize + gap);
const cellY = gap + segment.y * (cellSize + gap);
+ // Tapering logic matchin renderAnimatedSVG
+ const snakeLen = snake.segments.length;
+ const positionRatio = i / Math.max(1, snakeLen - 1); // 0 = head, 1 = tail
+
+ // Size: head is 1.3x, tail is 0.7x
+ const sizeMultiplier = i === 0 ? 1.3 : 1.0 - positionRatio * 0.3;
+ const segSize = Math.round(cellSize * sizeMultiplier);
+ const offset = (cellSize - segSize) / 2;
+
+ // Opacity: head is 1, fades to 0.5 at tail
+ const opacity = i === 0 ? 1 : 1 - positionRatio * 0.5;
+
let color: string;
if (i === 0) {
color = palette.snake.head;
@@ -98,8 +110,10 @@ function renderSnakeSegments(snake: SnakeState, opts: RenderOptions): string {
color = palette.snake.body;
}
+ const rx = i === 0 ? 4 : 2; // Head more rounded
const filterAttr = isGlass ? ' filter="url(#glass-glow)"' : "";
- return ` `;
+
+ return ` `;
})
.join("");
}
diff --git a/packages/renderer/src/renderer.test.ts b/packages/renderer/src/renderer.test.ts
index 864465a..1fff296 100644
--- a/packages/renderer/src/renderer.test.ts
+++ b/packages/renderer/src/renderer.test.ts
@@ -169,11 +169,10 @@ describe("Renderer - Static SVG", () => {
const headX = gap + snake.segments[0].x * (cellSize + gap);
const headY = gap + snake.segments[0].y * (cellSize + gap);
- const headRectPattern = new RegExp(
- `]*x="${headX}"[^>]*y="${headY}"[^>]*fill="${headColor}"`,
- );
+ const headRectPattern = new RegExp(`]*x="${headX}"[^>]*y="${headY}"`);
expect(svg).toMatch(headRectPattern);
+ expect(svg).toContain(`fill="${headColor}"`);
});
test("should render grid cells", () => {
@@ -623,10 +622,21 @@ describe("Renderer - Snake Segment Rendering", () => {
const svg = renderStaticSVG(grid, snake);
- const rxMatches = svg.match(/rx="2"/g);
- expect(rxMatches).toBeTruthy();
- // 371 grid cells + 3 snake segments = 374 elements with rounded corners
- expect(rxMatches!.length).toBe(371 + snake.segments.length);
+ const rx2Matches = svg.match(/rx="2"/g);
+ expect(rx2Matches).toBeTruthy();
+ // 371 grid cells + (3 snake segments - 1 head) = 373 elements with rx="2"
+ expect(rx2Matches!.length).toBe(371 + snake.segments.length - 1);
+
+ const rx4Matches = svg.match(/rx="4"/g);
+ expect(rx4Matches).toBeTruthy();
+ // Head should have rx="4"
+ expect(rx4Matches!.length).toBe(1);
+
+ // Verify tapering (opacity)
+ const opacityMatches = svg.match(/opacity="/g);
+ expect(opacityMatches).toBeTruthy();
+ // Head has opacity 1 (implicit or explicit), tail has lower. Check if opacity attr exists on at least some segments
+ expect(opacityMatches!.length).toBeGreaterThan(0);
});
test("should render segments in correct order (head first)", () => {
From 4e54d94990ae515d31c59abc83ec36fc5d100ba3 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 16:27:05 +0100
Subject: [PATCH 27/29] Update packages/github/src/index.ts
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Miccy
---
packages/github/src/index.ts | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/packages/github/src/index.ts b/packages/github/src/index.ts
index 8cff4cb..651c7b5 100644
--- a/packages/github/src/index.ts
+++ b/packages/github/src/index.ts
@@ -103,11 +103,11 @@ async function fetchContributionsGraphQL(
if (targetYear === currentYear) {
// Rolling year: last 12 months ending today
// Align start date to Sunday to ensure full weeks in the grid
- to = now.toISOString();
+ to = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, "0")}-${String(now.getUTCDate()).padStart(2, "0")}T23:59:59Z`;
const oneYearAgo = new Date(now);
oneYearAgo.setFullYear(now.getFullYear() - 1);
- oneYearAgo.setDate(oneYearAgo.getDate() - oneYearAgo.getDay()); // Align to previous Sunday
- from = oneYearAgo.toISOString();
+ oneYearAgo.setUTCDate(oneYearAgo.getUTCDate() - oneYearAgo.getUTCDay()); // Align to previous Sunday (UTC)
+ from = `${oneYearAgo.getUTCFullYear()}-${String(oneYearAgo.getUTCMonth() + 1).padStart(2, "0")}-${String(oneYearAgo.getUTCDate()).padStart(2, "0")}T00:00:00Z`;
} else {
// Calendar year: Jan 1 to Dec 31
from = `${targetYear}-01-01T00:00:00Z`;
From 3972d4ff9ea0f30caa7e203f73aacb7f53a937d7 Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 16:27:33 +0100
Subject: [PATCH 28/29] Update packages/renderer/src/index.ts
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Signed-off-by: Miccy
---
packages/renderer/src/index.ts | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/packages/renderer/src/index.ts b/packages/renderer/src/index.ts
index a85354a..9ae5a3e 100644
--- a/packages/renderer/src/index.ts
+++ b/packages/renderer/src/index.ts
@@ -89,7 +89,7 @@ function renderSnakeSegments(snake: SnakeState, opts: RenderOptions): string {
const cellX = gap + segment.x * (cellSize + gap);
const cellY = gap + segment.y * (cellSize + gap);
- // Tapering logic matchin renderAnimatedSVG
+ // Tapering logic matching renderAnimatedSVG
const snakeLen = snake.segments.length;
const positionRatio = i / Math.max(1, snakeLen - 1); // 0 = head, 1 = tail
From f2c8e1c140f08944b81610f2045986b02f8b51ef Mon Sep 17 00:00:00 2001
From: Miccy
Date: Thu, 29 Jan 2026 16:31:01 +0100
Subject: [PATCH 29/29] Update packages/github/src/index.ts
Co-authored-by: kiloconnect[bot] <240665456+kiloconnect[bot]@users.noreply.github.com>
Signed-off-by: Miccy
---
packages/github/src/index.ts | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/packages/github/src/index.ts b/packages/github/src/index.ts
index 651c7b5..9db4fda 100644
--- a/packages/github/src/index.ts
+++ b/packages/github/src/index.ts
@@ -251,7 +251,7 @@ async function fetchContributionsHTML(username: string, year?: number): Promise<
// And strip ~1 year back.
const oneYearAgo = new Date(now);
oneYearAgo.setFullYear(now.getFullYear() - 1);
- oneYearAgo.setDate(oneYearAgo.getDate() - oneYearAgo.getDay()); // Align to previous Sunday
+ oneYearAgo.setUTCDate(oneYearAgo.getUTCDate() - oneYearAgo.getUTCDay()); // Align to previous Sunday (UTC)
// Use UTC components directly to avoid timezone-induced shifts
const fromDate = `${oneYearAgo.getUTCFullYear()}-${String(oneYearAgo.getUTCMonth() + 1).padStart(2, "0")}-${String(oneYearAgo.getUTCDate()).padStart(2, "0")}`;
const toDate = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, "0")}-${String(now.getUTCDate()).padStart(2, "0")}`;