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: -3. Or use [GitHub Security Advisories](https://github.com/miccy/snake-evolution/security/advisories/new) - -We will respond within 48 hours and work with you to: - -- Confirm the vulnerability -- Develop a fix -- Release a patched version -- Credit you in the release notes (unless you prefer anonymity) - -## Security Considerations - -### GitHub Token Handling - -- Tokens are **never** stored or logged -- Tokens are only used for GitHub GraphQL API requests -- If no token is provided, we use public HTML scraping (rate-limited) - -### SVG Output - -- Generated SVGs contain only safe elements (rect, animate, filter) -- No JavaScript or external resources in generated files -- Output is deterministic based on contribution data - -### GitHub Action - -- Runs with minimal permissions by default -- Only writes to specified output path -- No network requests except GitHub API diff --git a/apps/api/README.md b/apps/api/README.md new file mode 100644 index 0000000..be7bffb --- /dev/null +++ b/apps/api/README.md @@ -0,0 +1,59 @@ +# Snake Evolution API + +REST API for generating GitHub contribution snake animations on-demand. + +## Tech Stack + +- **Runtime**: [Bun](https://bun.sh/) +- **Framework**: [Elysia](https://elysiajs.com/) +- **Documentation**: Swagger/OpenAPI + +## Development + +```bash +# Start development server +bun dev + +# Or run directly +bun run src/index.ts +``` + +The API runs on `http://localhost:3001` with Swagger docs at `/swagger`. + +## Endpoints + +| Method | Endpoint | Description | +|--------|----------|-------------| +| `GET` | `/` | API info | +| `GET` | `/api/v1/health` | Health check | +| `POST` | `/api/v1/generate` | Queue snake generation | +| `GET` | `/api/v1/job/:id` | Check job status | + +## Example Request + +```bash +curl -X POST http://localhost:3001/api/v1/generate \ + -H "Content-Type: application/json" \ + -d '{"username": "octocat", "theme": "github"}' +``` + +## Response + +```json +{ + "message": "Generation queued", + "jobId": "550e8400-e29b-41d4-a716-446655440000" +} +``` + +## Environment Variables + +| Variable | Description | Default | +|----------|-------------|---------| +| `PORT` | Server port | `3001` | +| `GITHUB_TOKEN` | GitHub API token (optional) | – | + +## Related + +- [`apps/web`](../web) – Web frontend +- [`docker/`](../../docker) – Docker development stack diff --git a/docker/README.md b/docker/README.md new file mode 100644 index 0000000..4d060db --- /dev/null +++ b/docker/README.md @@ -0,0 +1,61 @@ +# Docker Development Stack + +Docker Compose configuration for local development with Appwrite backend. + +## Quick Start + +```bash +# Start all services +docker compose up -d + +# View logs +docker compose logs -f + +# Stop services +docker compose down +``` + +## Services + +| Service | Port | Description | +|---------|------|-------------| +| **Appwrite** | 80, 443 | Backend as a Service | +| **MariaDB** | – | Database for Appwrite | +| **Redis** | 6379 | Cache & queues | +| **MailDev** | 1080, 1025 | Email testing (Web UI + SMTP) | + +## Access URLs + +- **Appwrite Console**: http://localhost +- **MailDev UI**: http://localhost:1080 +- **Redis**: `localhost:6379` + +## Data Persistence + +All data is stored in named Docker volumes: + +- `appwrite-data`, `appwrite-config`, `appwrite-cache` +- `mariadb-data` +- `redis-data` + +To reset all data: + +```bash +docker compose down -v +``` + +## Configuration + +Default credentials (development only): + +| Service | User | Password | +|---------|------|----------| +| MariaDB | `user` | `password` | +| MariaDB Root | `root` | `rootpassword` | + +> ⚠️ **Warning**: Change these credentials for any non-local deployment! + +## Related + +- [`apps/api`](../apps/api) – API server +- [`scripts/setup-mac.sh`](../scripts) – Mac setup script diff --git a/TEST_SUMMARY.md b/docs/testing/TEST_SUMMARY.md similarity index 100% rename from TEST_SUMMARY.md rename to docs/testing/TEST_SUMMARY.md diff --git a/UNIT_TESTS_GENERATED.md b/docs/testing/UNIT_TESTS_GENERATED.md similarity index 100% rename from UNIT_TESTS_GENERATED.md rename to docs/testing/UNIT_TESTS_GENERATED.md diff --git a/packages/biome-config/README.md b/packages/biome-config/README.md new file mode 100644 index 0000000..2a4315a --- /dev/null +++ b/packages/biome-config/README.md @@ -0,0 +1,25 @@ +# @snake-evolution/biome-config + +Shared [Biome](https://biomejs.dev/) configuration for the Snake Evolution monorepo. + +## Usage + +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 + +- **Linting** – TypeScript-aware rules +- **Formatting** – Consistent code style (tabs, 100 char width) +- **Import Sorting** – Automatic organization + +## Related + +- [Biome Documentation](https://biomejs.dev/docs/) +- [`@snake-evolution/typescript-config`](../typescript-config) – TypeScript settings diff --git a/packages/engine/README.md b/packages/engine/README.md new file mode 100644 index 0000000..f55839d --- /dev/null +++ b/packages/engine/README.md @@ -0,0 +1,53 @@ +# @snake-evolution/engine + +Core simulation engine for the Snake Evolution project. Implements pathfinding and game logic for the snake animation. + +## Features + +- 🐍 **Snake Simulation** – Create and control snake movement +- 🎯 **Pathfinding** – BFS algorithm prioritizing high-value contributions +- 🔄 **Frame Generation** – Produces animation frames for the renderer + +## Installation + +```bash +bun add @snake-evolution/engine +``` + +## Usage + +```typescript +import { simulateSnake, createSnake, moveSnake } from '@snake-evolution/engine'; +import type { ContributionGrid } from '@snake-evolution/types'; + +// Run complete simulation +const frames = simulateSnake(contributionGrid, { + startPosition: { x: 0, y: 3 }, + maxLength: 10, + growEvery: 4, + maxSteps: 2000, + frameMode: 'every' +}); + +// Or control manually +const snake = createSnake({ x: 0, y: 3 }); +const movedSnake = moveSnake(snake, 'right'); +``` + +## API + +| Function | Description | +|----------|-------------| +| `simulateSnake(grid, options)` | Run complete snake simulation | +| `createSnake(position)` | Initialize snake at position | +| `moveSnake(snake, direction)` | Move snake one step | +| `growSnake(snake, count)` | Grow snake by N segments | +| `findNextDirection(grid, snake)` | Get optimal next move | +| `hasContribution(grid, pos)` | Check if cell has contribution | +| `eatContribution(grid, pos)` | Mark contribution as eaten | + +## Related Packages + +- [`@snake-evolution/types`](../types) – Shared TypeScript types +- [`@snake-evolution/renderer`](../renderer) – SVG/GIF rendering +- [`@snake-evolution/github`](../github) – GitHub API client diff --git a/packages/github/README.md b/packages/github/README.md new file mode 100644 index 0000000..bfc2775 --- /dev/null +++ b/packages/github/README.md @@ -0,0 +1,57 @@ +# @snake-evolution/github + +GitHub API client for Snake Evolution. Fetches contribution data via GraphQL or HTML scraping. + +## Features + +- 🔐 **GraphQL API** – Authenticated access with full data +- 🌐 **HTML Scraping** – Public access without token +- 📅 **Year Selection** – Fetch specific year's contributions +- ⚡ **Smart Fallback** – Automatically uses best available method + +## Installation + +```bash +bun add @snake-evolution/github +``` + +## Usage + +```typescript +import { fetchContributions, fetchPublicContributions } from '@snake-evolution/github'; + +// With GitHub token (recommended) +const grid = await fetchContributions('username', process.env.GITHUB_TOKEN, 2025); + +// Without token (public scraping) +const publicGrid = await fetchPublicContributions('username', 2025); +``` + +## API + +| Function | Description | +|----------|-------------| +| `fetchContributions(username, token?, year?)` | Smart fetch – uses GraphQL if token provided | +| `fetchPublicContributions(username, year?)` | Always uses HTML scraping (no auth) | + +## Response Format + +```typescript +interface ContributionGrid { + username: string; + year: number; + totalContributions: number; + weeks: GitHubContribution[][]; // 53 weeks × 7 days +} + +interface GitHubContribution { + date: string; // "2025-01-01" + count: number; // 0-N contributions + level: 0 | 1 | 2 | 3 | 4; // Visual intensity +} +``` + +## Related Packages + +- [`@snake-evolution/types`](../types) – Shared TypeScript types +- [`@snake-evolution/engine`](../engine) – Simulation engine diff --git a/packages/renderer/README.md b/packages/renderer/README.md new file mode 100644 index 0000000..65eb213 --- /dev/null +++ b/packages/renderer/README.md @@ -0,0 +1,60 @@ +# @snake-evolution/renderer + +SVG renderer for Snake Evolution. Generates static and animated SVG images from simulation frames. + +## Features + +- 🖼️ **Static SVG** – Single-frame renders +- 🎬 **Animated SVG** – SMIL-based animations (like Platane's original) +- 🎨 **Theming** – Multiple color palettes (GitHub, Ocean, Synthwave, CypherPunk) +- ⚡ **Performant** – Optimized for GitHub profile embedding + +## Installation + +```bash +bun add @snake-evolution/renderer +``` + +## Usage + +```typescript +import { renderStaticSVG, renderAnimatedSVG } from '@snake-evolution/renderer'; +import { simulateSnake } from '@snake-evolution/engine'; + +// Static render +const staticSvg = renderStaticSVG(grid, snake, { + cellSize: 12, + gap: 2, + palette: 'github' +}); + +// Animated render +const frames = simulateSnake(grid); +const animatedSvg = renderAnimatedSVG(frames, { + loop: true, + duration: 5000 +}); +``` + +## API + +| 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+) | + +## Related Packages + +- [`@snake-evolution/engine`](../engine) – Simulation engine +- [`@snake-evolution/types`](../types) – Shared TypeScript types diff --git a/packages/types/README.md b/packages/types/README.md new file mode 100644 index 0000000..1e1c007 --- /dev/null +++ b/packages/types/README.md @@ -0,0 +1,72 @@ +# @snake-evolution/types + +Shared TypeScript type definitions for the Snake Evolution monorepo. + +## Installation + +```bash +bun add @snake-evolution/types +``` + +## Usage + +```typescript +import type { + ContributionGrid, + GitHubContribution, + SnakeState, + SnakeFrame, + Position, + Direction, + ColorPalette, + RenderOptions +} from '@snake-evolution/types'; +``` + +## Type Categories + +### GitHub Types + +| Type | Description | +|------|-------------| +| `GitHubContribution` | Single day contribution data | +| `ContributionGrid` | Full year contribution grid | + +### Snake Types + +| Type | Description | +|------|-------------| +| `Position` | `{ x: number, y: number }` | +| `Direction` | `"up" \| "down" \| "left" \| "right"` | +| `SnakeSegment` | Position + direction | +| `SnakeState` | Complete snake state | + +### Simulation Types + +| Type | Description | +|------|-------------| +| `SnakeFrame` | Single animation frame | +| `SimulationOptions` | Engine configuration | + +### Rendering Types + +| Type | Description | +|------|-------------| +| `ColorPalette` | Theme color definitions | +| `RenderOptions` | Renderer configuration | +| `OutputFormat` | `"svg" \| "gif" \| "png"` | + +### API Types + +| Type | Description | +|------|-------------| +| `GenerationRequest` | API request payload | +| `GenerationResult` | API response payload | +| `ApiResponse` | Generic API wrapper | +| `HealthCheckResponse` | Health endpoint response | + +## Related Packages + +- [`@snake-evolution/engine`](../engine) – Simulation engine +- [`@snake-evolution/renderer`](../renderer) – SVG/GIF rendering +- [`@snake-evolution/github`](../github) – GitHub API client diff --git a/packages/typescript-config/README.md b/packages/typescript-config/README.md new file mode 100644 index 0000000..10b2f86 --- /dev/null +++ b/packages/typescript-config/README.md @@ -0,0 +1,52 @@ +# @snake-evolution/typescript-config + +Shared TypeScript configurations for the Snake Evolution monorepo. + +## Available Configs + +| Config | Use Case | +|--------|----------| +| `base.json` | Base settings for all packages | +| `node.json` | Node.js/Bun applications | +| `react.json` | React web applications | + +## Usage + +Extend in your package's `tsconfig.json`: + +```json +{ + "extends": "@snake-evolution/typescript-config/base.json", + "compilerOptions": { + "outDir": "./dist" + }, + "include": ["src"] +} +``` + +### For React Apps + +```json +{ + "extends": "@snake-evolution/typescript-config/react.json" +} +``` + +### For Node/Bun Packages + +```json +{ + "extends": "@snake-evolution/typescript-config/node.json" +} +``` + +## Included Settings + +- **Target**: ESNext +- **Module**: ESNext with Bundler resolution +- **Strict Mode**: Enabled +- **Interop**: esModuleInterop, allowSyntheticDefaultImports + +## Related + +- [`@snake-evolution/biome-config`](../biome-config) – Linting & formatting diff --git a/packages/ui/README.md b/packages/ui/README.md new file mode 100644 index 0000000..521563a --- /dev/null +++ b/packages/ui/README.md @@ -0,0 +1,68 @@ +# @snake-evolution/ui + +Shared React UI components for the Snake Evolution web applications. + +## Installation + +```bash +bun add @snake-evolution/ui +``` + +## Components + +### Button + +Styled button component with variants. + +```tsx +import { Button } from '@snake-evolution/ui'; + + +``` + +### Card + +Container component with consistent styling. + +```tsx +import { Card } from '@snake-evolution/ui'; + + + Snake + +``` + +### SnakePreview + +Live preview component for snake animations. + +```tsx +import { SnakePreview } from '@snake-evolution/ui'; + + +``` + +## Exports + +```typescript +// Components +export { Button } from './components/Button'; +export { Card } from './components/Card'; +export { SnakePreview } from './components/SnakePreview'; + +// Types +export type { ButtonProps } from './components/Button'; +export type { CardProps } from './components/Card'; +export type { SnakePreviewProps } from './components/SnakePreview'; +``` + +## Related Packages + +- [`apps/web`](../../apps/web) – Web application using these components +- [`@snake-evolution/types`](../types) – Shared TypeScript types diff --git a/scripts/README.md b/scripts/README.md new file mode 100644 index 0000000..bd029b2 --- /dev/null +++ b/scripts/README.md @@ -0,0 +1,49 @@ +# Scripts + +Utility scripts for the Snake Evolution project. + +## Available Scripts + +### `setup-mac.sh` + +One-command setup for macOS development environment. + +```bash +chmod +x scripts/setup-mac.sh +./scripts/setup-mac.sh +``` + +**What it does:** + +1. ✅ Checks/installs **Homebrew** +2. ✅ Checks/installs **Bun** +3. ✅ Checks/installs **Docker Desktop** +4. ✅ Runs `bun install` +5. ✅ Starts Docker services + +**Prerequisites:** + +- macOS +- Terminal access +- Admin rights (for Homebrew) + +**After running:** + +1. Open http://localhost for Appwrite +2. Create account and project +3. Add API key to `.env.local` +4. Run `bun dev` + +## Adding New Scripts + +Place new scripts in this directory and document them here. Follow these conventions: + +- Use `#!/bin/bash` shebang +- Include `set -e` for fail-fast +- Add helpful output with emoji prefixes +- Make scripts idempotent (safe to run multiple times) + +## Related + +- [`docker/`](../docker) – Docker development stack +- [`.github/workflows/`](../.github/workflows) – CI/CD automation From 85cde4a9fba3e299b295295d4ebf4a5926668771 Mon Sep 17 00:00:00 2001 From: Miccy 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; - const qualityScript = scripts.quality; + const checkScript = scripts.check; - // Quality script should run check (which includes lint, format, type-check) and test - expect(qualityScript).toContain("check"); - expect(qualityScript).toContain("test"); + expect(checkScript).toContain("lint"); + expect(checkScript).toContain("typecheck"); }); test("should use turbo for monorepo tasks", () => { diff --git a/apps/web/src/content/docs/guides/installation.md b/apps/web/src/content/docs/guides/installation.md index 97bc301..4e63941 100644 --- a/apps/web/src/content/docs/guides/installation.md +++ b/apps/web/src/content/docs/guides/installation.md @@ -69,10 +69,11 @@ snake-evolution/ ## Verify Installation ```bash -# Run quality checks -bun run lint -bun run format:check -bun run type-check +# Run all quality checks (lint + typecheck) +bun run check + +# Or run tests too +bun run check && bun run test ``` ## Troubleshooting diff --git a/package.json b/package.json index 447bf84..a7fed44 100644 --- a/package.json +++ b/package.json @@ -11,31 +11,31 @@ "license": "MIT", "scripts": { "prepare": "git config core.hooksPath .githooks 2>/dev/null || true", + "dev": "turbo run dev", "dev:web": "turbo run dev --filter=@snake-evolution/web", "dev:api": "turbo run dev --filter=@snake-evolution/api", + "build": "turbo run build", "build:web": "turbo run build --filter=@snake-evolution/web", - "build:api": "turbo run build --filter=@snake-evolution/api", "build:cli": "turbo run build --filter=@snake-evolution/cli", + "test": "turbo run test", - "test:watch": "turbo run test:watch", - "lint": "biome check . && bun run lint:md", - "lint:fix": "biome check --fix . && bun run lint:md:fix", - "lint:md": "markdownlint-cli2 '*.md' 'docs/**/*.md' '.github/**/*.md' --config .markdownlint.jsonc", - "lint:md:fix": "markdownlint-cli2 --fix '*.md' 'docs/**/*.md' '.github/**/*.md' --config .markdownlint.jsonc", - "format": "biome format --write .", - "format:check": "biome format .", - "type-check": "tsc --noEmit && turbo run type-check --filter=@snake-evolution/web", - "clean": "turbo run clean && rm -rf .turbo", - "clean:all": "turbo run clean && rm -rf node_modules .turbo bun.lock && find . -name 'node_modules' -type d -prune -exec rm -rf {} + 2>/dev/null || true", - "reinstall": "bun run clean:all && bun install", - "fix": "bun run lint:fix && bun run format", - "check": "bun run lint && bun run format:check && bun run type-check", - "quality": "bun run check && bun run test", - "precommit": "bun run check", + + "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", + + "typecheck": "tsc --noEmit && turbo run type-check", + + "check": "bun run lint && bun run typecheck", + "fix": "bun run lint:fix", + + "clean": "turbo run clean && rm -rf .turbo node_modules", + "reinstall": "bun run clean && bun install", + "snake": "bun run packages/cli/src/index.ts", "generate": "bun run packages/cli/src/index.ts generate", + "changeset": "changeset", "version": "changeset version", "release": "changeset publish" diff --git a/turbo.json b/turbo.json index 69da7c9..023e84a 100644 --- a/turbo.json +++ b/turbo.json @@ -14,12 +14,8 @@ "persistent": true }, "test": { - "outputs": ["coverage/**"], - "cache": true - }, - "test:watch": { - "cache": false, - "persistent": true + "outputs": [], + "cache": false }, "lint": { "outputs": [], @@ -29,14 +25,6 @@ "outputs": [], "cache": false }, - "format": { - "outputs": [], - "cache": false - }, - "format:check": { - "outputs": [], - "cache": true - }, "type-check": { "dependsOn": ["^build"], "outputs": [], From cb8c650d634c5aceb5787154e7121238cb090b67 Mon Sep 17 00:00:00 2001 From: Miccy 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 { + width?: number; + height?: number; + frameDelay?: number; + loop?: boolean; + onProgress?: (current: number, total: number) => void; +} + +export async function renderAnimatedGIF( + frames: SnakeFrame[], + options: GifOptions = {} +): Promise { + const { + width = 847, + height = 112, + frameDelay = 150, + loop = true, + onProgress, + ...renderOptions + } = options; + + 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 + + // 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, { + palette, + delay: frameDelay, + dispose: 2, // restore to background + }); + } + + gif.finish(); + return Buffer.from(gif.bytes()); +} +``` + +### Frame Sampling (Optimization) + +For animations with many frames, sample to reduce file size: + +```typescript +export async function renderAnimatedGIFSampled( + frames: SnakeFrame[], + options: GifOptions & { sampleRate?: number } = {} +): Promise { + const { sampleRate = 1, ...gifOptions } = options; + + if (sampleRate <= 1) { + return renderAnimatedGIF(frames, gifOptions); + } + + // Sample every Nth frame, adjust delay accordingly + const sampled = frames.filter((_, i) => i % sampleRate === 0); + const adjustedDelay = (gifOptions.frameDelay || 150) * sampleRate; + + return renderAnimatedGIF(sampled, { + ...gifOptions, + frameDelay: adjustedDelay, + }); +} +``` + +### CLI Integration + +**File:** `packages/cli/src/index.ts` + +```typescript +import { renderAnimatedGIF } from "@snake-evolution/renderer"; + +// In generate action: +if (options.format === "gif") { + console.log("🎬 Rendering animated GIF..."); + + const gifBuffer = await renderAnimatedGIF(frames, { + ...renderOptions, + onProgress: (current, total) => { + process.stdout.write(`\r Frame ${current}/${total}`); + }, + }); + + process.stdout.write("\n"); + writeFileSync(outputPath, gifBuffer); +} else { + // Existing SVG logic +} +``` + +### Export from Package + +**File:** `packages/renderer/src/index.ts` + +```typescript +// Add export +export { renderAnimatedGIF, renderAnimatedGIFSampled } from "./gif"; +``` + +## Glass Theme + +Glass theme uses blur filters that are expensive in SVG but free in GIF: + +```typescript +// packages/cli/src/format.ts +export function validateOutputFormat(format: string, theme: string) { + if (theme === "glass" && format !== "gif") { + return { + ok: false, + reason: "Glass theme requires GIF format for blur effects.", + hint: "Use: --format gif --theme glass", + }; + } + return { ok: true }; +} +``` + +## Performance Considerations + +### File Size + +| Frames | Raw GIF | With Sampling (2x) | +|--------|---------|-------------------| +| 100 | ~300 KB | ~150 KB | +| 300 | ~800 KB | ~400 KB | +| 500 | ~1.3 MB | ~650 KB | + +### Encoding Speed + +- resvg-js: ~50-100 frames/second (WASM) +- gifenc: Very fast (pure JS, optimized) +- 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 +- GIF encoder streams, doesn't buffer all frames + +## 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 | + +## Testing + +```bash +# Generate test GIF +bun run snake generate -u octocat -f gif -o test.gif -t github-dark + +# Verify output +file test.gif # Should show "GIF image data, version 89a" + +# Test Glass theme +bun run snake generate -u octocat -f gif -o glass.gif -t glass + +# Run unit tests +bun test packages/renderer/src/gif.test.ts +``` + +## Bun 1.3.5 Features + +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) | + +## References + +- [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) diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 27a8c7f..4ab5a15 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -6,34 +6,74 @@ Make Snake Evolution the most fun way to visualize GitHub contributions - from s --- -## ✅ v1.2 - Current Release (December 2024) (December 2024) +## ✅ v1.2.4 - Current Release (December 2025) **What's Live:** - ✅ CLI tool with npm support (`npx @snake-evolution/cli@latest`) -- ✅ 6 stunning themes (Glass planned once GIF rendering ships) +- ✅ 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) +- ✅ Monorepo architecture (Turborepo + Bun 1.3.5) +- ✅ Consolidated scripts (30 → 21) +- ✅ Professional README files for all packages --- -## 🚧 v1.3 - Polish & Glass Theme (Q1 2025) +## 🚧 v1.3.0 - GIF Output & Glass Theme (January 2025) -**Focus:** Performance, GIF support, and the stunning Glass theme +**Focus:** GIF format, Glass theme, Bun 1.3.5 integration -- [ ] **GIF output format** - Enables glass theme with blur effects -- [ ] **Glass theme fully supported** - Liquid glass visual effects -- [ ] **Smaller file sizes** - Optimize SVG animation data -- [ ] **Speed control** - Adjust animation speed -- [ ] **CLI preview mode** - Local preview server -- [ ] **More community themes** - Submissions welcome! +### 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 From 51432fece5ec41fe5ba7bbd56323a95215115631 Mon Sep 17 00:00:00 2001 From: Miccy 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'; +--- + + + + +``` + +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) diff --git a/package.json b/package.json index a7fed44..55a0b77 100644 --- a/package.json +++ b/package.json @@ -11,42 +11,33 @@ "license": "MIT", "scripts": { "prepare": "git config core.hooksPath .githooks 2>/dev/null || true", - "dev": "turbo run dev", "dev:web": "turbo run dev --filter=@snake-evolution/web", "dev:api": "turbo run dev --filter=@snake-evolution/api", - "build": "turbo run build", "build:web": "turbo run build --filter=@snake-evolution/web", "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", - "typecheck": "tsc --noEmit && turbo run type-check", - "check": "bun run lint && bun run typecheck", "fix": "bun run lint:fix", - "clean": "turbo run clean && rm -rf .turbo node_modules", "reinstall": "bun run clean && bun install", - "snake": "bun run packages/cli/src/index.ts", "generate": "bun run packages/cli/src/index.ts generate", - "changeset": "changeset", "version": "changeset version", "release": "changeset publish" }, "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" }, diff --git a/packages/cli/package.json b/packages/cli/package.json index 6f9c7e2..28e6eec 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.3", + "@types/node": "^25.0.6", "commander": "^14.0.2" }, "engines": { diff --git a/packages/ui/package.json b/packages/ui/package.json index ad23a37..a3002f8 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -15,11 +15,11 @@ "clean": "rm -rf node_modules" }, "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" From 58df15f5370962f033dd00a3c723534a4bca1931 Mon Sep 17 00:00:00 2001 From: Miccy 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 @@ Snake Evolution

-

🐍 Snake Evolution

- -

- Turn your GitHub contributions into an animated snake that devours them! -

-

Stars npm - downloads - release License CI

- Quick Start • - Themes • - GitHub Action • - CLI • - PvP Mode + Turn your GitHub contributions into an animated snake that devours them!

---- -

@@ -35,115 +21,30 @@

---- - -## ⚡ Quick Start - -**Using npx (zero-install):** - -```bash -npx @snake-evolution/cli@latest generate -u YOUR_USERNAME -``` - -**Using GitHub Action:** - -See [🤖 GitHub Action](#-github-action) section below. - -**Local development:** - -```bash -git clone https://github.com/miccy/snake-evolution.git -cd snake-evolution -bun install -npx @snake-evolution/cli generate -u YOUR_USERNAME -o snake.svg -``` - ---- - -## ✨ Why Snake Evolution? - -- **🎨 6 Beautiful Themes** - Match your profile's aesthetic (Glass arrives with GIF support) -- **🧠 Smart Pathfinding** - Snake hunts high-value contributions first -- **⚡ Zero-Install CLI** - `npx @snake-evolution/cli@latest` - no setup needed -- **🤖 GitHub Action** - Automated daily updates -- **📦 Full Monorepo** - Engine, renderer, and themes are separate packages -- **🎯 Production Ready** - Used by developers worldwide - -## 🎨 Showcase - -Explore all available themes: - -````carousel -![GitHub Dark Theme](./assets/examples/github-dark.svg) - -![Ocean Theme](./assets/examples/ocean.svg) - -![Sunset Theme](./assets/examples/sunset.svg) - -![Neon Gamer Theme](./assets/examples/neon-gamer.svg) - -![CypherPunk Theme](./assets/examples/cypherpunk.svg) -```` - -**Real-world examples:** - -- 💼 Portfolio README animations -- 📚 Documentation sites with contribution graphs -- 🎤 Conference presentation slides -- ✍️ Technical articles and blog posts - ---- - -## 🎨 Themes - -### 🌑 GitHub Dark (Default) - -![GitHub Dark](./assets/examples/github-dark.svg) - -### ☀️ GitHub Light - -![GitHub Light](./assets/examples/github-light.svg) - -### 🌊 Ocean - -![Ocean](./assets/examples/ocean.svg) - -### 🌅 Sunset +## ✨ Features -![Sunset](./assets/examples/sunset.svg) +- **🎨 6 Beautiful Themes** - Match your profile's aesthetic. +- **🧠 Smart Pathfinding** - Snake hunts high-value contributions first. +- **⚡ Zero-Install** - Run instantly with `bunx` or `npx`. +- **🤖 GitHub Action** - Automated daily updates for your profile. +- **🗓️ Rolling Year** - Always shows the last 12 months of contributions. -### 🎮 Neon Gamer +## 🚀 Usage -![Neon Gamer](./assets/examples/neon-gamer.svg) +### GitHub Action (Recommended) -### 🔵 Cypherpunk - -![Cypherpunk](./assets/examples/cypherpunk.svg) - -### 🧊 Glass (Coming Soon) - -> GIF rendering is still in progress. The Glass theme will unlock once GIF output is available. - ---- - -## 🤖 GitHub Action - -Add to your profile README repository: - -**`.github/workflows/snake.yml`** +Add this workflow to your repository (e.g., `.github/workflows/snake.yml`) to automatically generate the snake animation every day. ```yaml name: Generate Snake on: schedule: - - cron: "0 0 * * *" # Daily - workflow_dispatch: - push: - branches: [main] + - cron: "0 0 * * *" # Run daily at midnight + workflow_dispatch: # Allow manual run jobs: - generate: + build: runs-on: ubuntu-latest permissions: contents: write @@ -156,154 +57,118 @@ jobs: outputs: | dist/snake.svg dist/snake-dark.svg?palette=github-dark - # dist/snake.gif?palette=ocean&format=gif # ⚠️ GIF support pending - theme: github-dark - - - name: Commit and Push - run: | - git config user.name "github-actions[bot]" - git config user.email "41898282+github-actions[bot]@users.noreply.github.com" - git add dist/*.svg - git diff --staged --quiet || git commit -m "🐍 Update snake" - git push -``` - -Then in your **README.md**: + dist/snake-ocean.svg?palette=ocean -```markdown -![Snake](./dist/snake.svg) + - name: Push to Output Branch + uses: crazy-max/ghaction-github-pages@v3.1.0 + with: + target_branch: output + build_dir: dist + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} ``` -**Outputs input:** You can provide multiple outputs separated by commas or new lines. Each entry is written inside `github.workspace` and can optionally include query params for per-output overrides, e.g. `dist/snake.svg?palette=ocean&format=svg`. +### CLI (Zero-Install) ---- - -## 💻 CLI - -[![npm version](https://img.shields.io/npm/v/@snake-evolution/cli)](https://www.npmjs.com/package/@snake-evolution/cli) -[![npm downloads](https://img.shields.io/npm/dm/@snake-evolution/cli)](https://www.npmjs.com/package/@snake-evolution/cli) - -### Zero-Install (Recommended) - -No installation required! Use `npx` or `bunx`: +Generate animations locally without installing anything. ```bash +# Using Bun (Recommended) +bunx @snake-evolution/cli@latest generate -u YOUR_USERNAME + # Using npx npx @snake-evolution/cli@latest generate -u YOUR_USERNAME +``` -# Using bunx (faster) -bunx @snake-evolution/cli@latest generate -u YOUR_USERNAME +### Markdown Usage -# With custom options -npx @snake-evolution/cli@latest generate -u YOUR_USERNAME -t ocean -o snake.svg -``` +Add this into your README.md -### Global Installation +```markdown +!![GitHub Dark](./assets/examples/github-dark.svg) +``` -```bash -# Using npm -npm install -g @snake-evolution/cli +### HTML in Markdown -# Using bun -bun add -g @snake-evolution/cli +Add this into your README.md for centered image with dark/light mode support -# Then use anywhere -snake generate -u YOUR_USERNAME -snake themes # List available themes +```html +

+ + + + Snake eating contributions + +

``` -### Local Project +## 🎨 Themes -```bash -npm install @snake-evolution/cli -# or -bun add @snake-evolution/cli -``` +Available themes: `github-dark`, `github-light`, `ocean`, `sunset`, `neon-gamer`, `cypherpunk`. -### Options +### 🌑 GitHub Dark (Default) -| Option | Description | Default | -|--------|-------------|---------| -| `-u, --username` | GitHub username | *required* | -| `-o, --output` | Output file path | `snake.svg` | -| `-t, --theme` | Color theme | `github-dark` | -| `-f, --format` | Output format (svg only; GIF not supported yet) | `svg` | -| `-y, --year` | Year to generate | current | -| `--static` | Static SVG (final frame with snake) | `false` | +![GitHub Dark](./assets/examples/github-dark.svg) -> ℹ️ GIF output is not available yet. The CLI will stop with a clear error if you request `--format gif` or the Glass theme. +### ☀️ GitHub Light ---- +![GitHub Light](./assets/examples/github-light.svg) -## 🎮 Coming Soon: PvP Mode +### 🌊 Ocean -

- Coming Soon -

+![Ocean](./assets/examples/ocean.svg) -**Challenge your friends to snake battles!** +### 🌅 Sunset -- 🏆 **Leaderboards** - Global rankings -- ⚔️ **1v1 Challenges** - Battle friends -- 👥 **Team Battles** - Company vs company -- ⚡ **Power-ups** - Shrink, teleport, shield -- 📈 **Progressive rounds** - Gets faster each level! +![Sunset](./assets/examples/sunset.svg) -[📍 View Roadmap →](./docs/ROADMAP.md) +### 🎮 Neon Gamer ---- +![Neon Gamer](./assets/examples/neon-gamer.svg) -## 🏗️ Development +### 🔵 Cypherpunk -```bash -git clone https://github.com/miccy/snake-evolution.git -cd snake-evolution -bun install -bun run generate -u YOUR_USERNAME -o test.svg -``` +![Cypherpunk](./assets/examples/cypherpunk.svg) ---- +## 📦 Installation (Global) -## 🤝 Contributing +If you prefer to have the tool available globally: -We love contributions! See [CONTRIBUTING.md](.github/CONTRIBUTING.md) +```bash +bun add -g @snake-evolution/cli +# or +npm install -g @snake-evolution/cli -- 🐛 [Report bugs](https://github.com/miccy/snake-evolution/issues) -- 💡 [Request features](https://github.com/miccy/snake-evolution/issues) -- 🎨 [Submit new themes](https://github.com/miccy/snake-evolution/pulls) +# Usage +snake generate -u miccy +``` ---- +## 🛠️ Development -## 💖 Support +This project is a monorepo managed by **Turbo** and **Bun**. -

- - Sponsor - -

+```bash +# Clone repository +git clone https://github.com/miccy/snake-evolution.git +cd snake-evolution -If you find this useful: +# Install dependencies +bun install -- ⭐ **Star this repo** - It helps a lot! -- 🐦 **Share on Twitter/X** - Spread the word -- 💬 **Join Discussions** - Ideas and feedback +# Build all packages +bun run build ---- +# Run CLI from source +bun run snake generate -u YOUR_USERNAME -o test.svg +``` ## 📄 License -MIT © [Miccy](https://github.com/miccy) - Original snake concept by [Platane](https://github.com/Platane) 🙏 --- -

- - Star - -

- -

- Built with 🐍 by @miccy -

+
+

🛠 Maintained by @miccy with 💙

+

© 2026 ownCTRL™

+
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 ", diff --git a/packages/engine/CHANGELOG.md b/packages/engine/CHANGELOG.md new file mode 100644 index 0000000..e1a7b2d --- /dev/null +++ b/packages/engine/CHANGELOG.md @@ -0,0 +1,12 @@ +# @snake-evolution/engine + +## 1.3.0 + +### Minor Changes + +- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation. + +### Patch Changes + +- Updated dependencies + - @snake-evolution/types@1.3.0 diff --git a/packages/engine/package.json b/packages/engine/package.json index 4f9c05f..ccb70a0 100644 --- a/packages/engine/package.json +++ b/packages/engine/package.json @@ -1,6 +1,6 @@ { "name": "@snake-evolution/engine", - "version": "1.2.4", + "version": "1.3.0", "private": true, "type": "module", "main": "./src/index.ts", diff --git a/packages/github/CHANGELOG.md b/packages/github/CHANGELOG.md new file mode 100644 index 0000000..985aa98 --- /dev/null +++ b/packages/github/CHANGELOG.md @@ -0,0 +1,12 @@ +# @snake-evolution/github + +## 1.3.0 + +### Minor Changes + +- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation. + +### Patch Changes + +- Updated dependencies + - @snake-evolution/types@1.3.0 diff --git a/packages/github/package.json b/packages/github/package.json index 6b154e4..39134b3 100644 --- a/packages/github/package.json +++ b/packages/github/package.json @@ -1,6 +1,6 @@ { "name": "@snake-evolution/github", - "version": "1.2.4", + "version": "1.3.0", "private": true, "type": "module", "main": "./src/index.ts", diff --git a/packages/github/src/index.ts b/packages/github/src/index.ts index 5723b26..ee66d12 100644 --- a/packages/github/src/index.ts +++ b/packages/github/src/index.ts @@ -93,9 +93,28 @@ async function fetchContributionsGraphQL( } `; - const targetYear = year ?? new Date().getFullYear(); - const from = `${targetYear}-01-01T00:00:00Z`; - const to = `${targetYear}-12-31T23:59:59Z`; + const now = new Date(); + const currentYear = now.getFullYear(); + const targetYear = year ?? currentYear; + + let from: string; + let to: string; + + if (targetYear === currentYear) { + // Rolling year: last 12 months ending today + 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. + from = oneYearAgo.toISOString(); + } else { + // Calendar year: Jan 1 to Dec 31 + from = `${targetYear}-01-01T00:00:00Z`; + to = `${targetYear}-12-31T23:59:59Z`; + } const response = await fetch(GITHUB_GRAPHQL_URL, { method: "POST", @@ -157,8 +176,21 @@ function levelToNumber(level: ContributionDay["contributionLevel"]): 0 | 1 | 2 | // ============================================ async function fetchContributionsHTML(username: string, year?: number): Promise { - const targetYear = year ?? new Date().getFullYear(); - const url = `https://github.com/users/${username}/contributions?from=${targetYear}-01-01&to=${targetYear}-12-31`; + 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`; + } const response = await fetch(url, { headers: { diff --git a/packages/renderer/CHANGELOG.md b/packages/renderer/CHANGELOG.md new file mode 100644 index 0000000..f41f5cf --- /dev/null +++ b/packages/renderer/CHANGELOG.md @@ -0,0 +1,12 @@ +# @snake-evolution/renderer + +## 1.3.0 + +### Minor Changes + +- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation. + +### Patch Changes + +- Updated dependencies + - @snake-evolution/types@1.3.0 diff --git a/packages/renderer/package.json b/packages/renderer/package.json index 173b805..a63e65a 100644 --- a/packages/renderer/package.json +++ b/packages/renderer/package.json @@ -1,6 +1,6 @@ { "name": "@snake-evolution/renderer", - "version": "1.2.4", + "version": "1.3.0", "private": true, "type": "module", "main": "./src/index.ts", diff --git a/packages/types/CHANGELOG.md b/packages/types/CHANGELOG.md new file mode 100644 index 0000000..c6181c4 --- /dev/null +++ b/packages/types/CHANGELOG.md @@ -0,0 +1,7 @@ +# @snake-evolution/types + +## 1.3.0 + +### Minor Changes + +- feat: Implemented matching 12-month rolling contribution window. Updated Node requirements to >=24. Overhauled documentation. diff --git a/packages/types/package.json b/packages/types/package.json index ea90d1d..3a6a8bf 100644 --- a/packages/types/package.json +++ b/packages/types/package.json @@ -1,6 +1,6 @@ { "name": "@snake-evolution/types", - "version": "1.2.4", + "version": "1.3.0", "private": true, "type": "module", "main": "./src/index.ts", From f8413b3978c27b229e69db440c218eb9f8bf7eb1 Mon Sep 17 00:00:00 2001 From: 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 -!![GitHub Dark](./assets/examples/github-dark.svg) +![GitHub Dark](./assets/examples/github-dark.svg) ``` - ### 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 ![GitHub Dark](./assets/examples/github-dark.svg) ``` + ### 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) 🙏

🛠 Maintained by @miccy with 💙

-

© 2026 ownCTRL™

+

© 2026 Miccy

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")}`;