diff --git a/.gitignore b/.gitignore index 239b2ff..6223eff 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,7 @@ dist/ # Environments .env .venv +venv/ # mypy .mypy_cache/ @@ -23,3 +24,7 @@ dmypy.json /coverage.xml /.coverage .DS_Store + +# Node +node_modules/ +npm-debug.log* diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 948295f..1d61b60 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -14,7 +14,7 @@ repos: - id: ruff-format name: ruff-format - entry: uv run ruff format + entry: uv run ruff format . language: system types: [python] diff --git a/CLAUDE.md b/CLAUDE.md index 306bc29..3c573a0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -47,14 +47,32 @@ The project follows a three-layer architecture: 2. **tinygrid/** - SDK wrapper layer - High-level API abstraction over pyercot - - Core classes: `ERCOT` client, `ERCOTAuth` authentication - - Provides conveniences: pagination, retry logic, date range chunking, pandas DataFrames - - Exposes error types: `GridError`, `GridAPIError`, `GridAuthenticationError`, `GridTimeoutError` + - Main `ERCOT` client composed of multiple mixin classes: + - `ERCOTBase` (client.py): Auth, retry logic, pagination, rate limiting + - `ERCOTEndpointsMixin` (endpoints.py): Low-level wrappers for 100+ pyercot endpoints + - `ERCOTAPIMixin` (api.py): High-level unified API methods (get_spp, get_lmp, etc.) + - `ERCOTDashboardMixin` (dashboard.py): Public dashboard methods (no auth required) + - `ERCOTDocumentsMixin` (documents.py): MIS document fetching for yearly historical data + - Supporting classes: + - `ERCOTAuth`: Token-based authentication management + - `ERCOTArchive`: Historical data access (>90 days old) + - `ERCOTPoller`: Real-time polling utilities + - `EIAClient`: EIA API integration for pre-December 2023 data + - Exposes error types: `GridError`, `GridAPIError`, `GridAuthenticationError`, `GridTimeoutError`, `GridRateLimitError`, `GridRetryExhaustedError` 3. **tests/** - Test suite - Uses pytest with respx for HTTP mocking - Fixtures in `conftest.py` for common test data - Test organization by feature (test_ercot.py, test_ercot_retry.py, test_ercot_unified.py, etc.) + - 746 tests with 95% coverage + +4. **examples/** - Usage examples + - `ercot_demo.ipynb`: Jupyter notebook demonstrating SDK features + - `demo/`: Full-stack web application showcasing TinyGrid SDK + - FastAPI backend with TinyGrid SDK integration + - React + TypeScript + Vite frontend + - Docker Compose for easy deployment + - Demonstrates dashboard, prices, forecasts, and historical data ## Development Commands @@ -163,13 +181,50 @@ Located in `tinygrid/constants/ercot.py`: - `ERCOT_TIMEZONE` = "US/Central" - `HISTORICAL_THRESHOLD_DAYS` = 90 (threshold for using archive API vs. real-time API) +### Dashboard Methods (No Authentication Required) + +`ERCOTDashboardMixin` provides access to real-time grid data from ERCOT's public dashboard JSON: +- `get_status()`: Grid operating condition, current load, capacity, reserves +- `get_fuel_mix()`: Generation breakdown by fuel type (coal, gas, nuclear, wind, solar, etc.) +- `get_renewable_generation()`: Wind and solar output with forecasts +- `get_supply_demand()`: Hourly supply and demand data +- `get_daily_prices()`: Daily price summary +- Located in `tinygrid/ercot/dashboard.py` +- Returns structured Python objects (GridStatus, FuelMixEntry, RenewableStatus) + ### Historical Data Access -`ERCOTArchive` class provides bulk download of historical data: +`ERCOTArchive` class provides bulk download of historical data (>90 days old): - Uses POST-based batch downloads (max 1000 items per batch) - Returns data as pandas DataFrames - Automatically handles date ranges with threading for concurrent downloads -- Located in `tinygrid/historical/ercot.py` +- Located in `tinygrid/ercot/archive.py` + +`ERCOTDocumentsMixin` provides access to yearly historical data from MIS documents: +- `get_rtm_spp_historical(year)`: Full year of RTM settlement point prices +- `get_dam_spp_historical(year)`: Full year of DAM settlement point prices +- `get_settlement_point_mapping()`: Settlement point to bus mapping +- Downloads and parses Excel/CSV files from ERCOT's document archive +- Located in `tinygrid/ercot/documents.py` +- Report type IDs available in `REPORT_TYPE_IDS` constant + +### Polling Utilities + +`ERCOTPoller` class and `poll_latest()` function for real-time data monitoring: +- `poll_latest(client, method, interval, max_iterations)`: Generator-based polling +- `ERCOTPoller(client, interval).poll(method, callback, max_iterations)`: Callback-based polling +- Automatic error handling and retry logic +- Configurable polling interval and iteration limits +- Located in `tinygrid/ercot/polling.py` + +### EIA Integration + +`EIAClient` provides access to ERCOT data via the EIA API for data before December 2023: +- `get_demand(start, end)`: Hourly electricity demand +- `get_generation_by_fuel(start, end)`: Generation breakdown by fuel type +- `get_interchange(start, end)`: Net interchange with other grids +- Requires free API key from https://www.eia.gov/opendata/register.php +- Located in `tinygrid/ercot/eia.py` ### Testing Patterns @@ -224,12 +279,28 @@ The project uses `uv` for dependency management: ## Common Development Tasks **Adding a new ERCOT method:** -1. Check pyercot has the endpoint function imported (in `tinygrid/ercot.py` imports) -2. Add wrapper method to ERCOT class that calls the pyercot endpoint + +For low-level endpoint wrappers (ERCOTEndpointsMixin): +1. Check pyercot has the endpoint function imported (in `tinygrid/ercot/__init__.py` imports) +2. Add wrapper method to `ERCOTEndpointsMixin` in `tinygrid/ercot/endpoints.py` 3. Handle date formatting via `format_api_date()` 4. Return pandas DataFrame 5. Add tests in appropriate test file +For high-level unified API methods (ERCOTAPIMixin): +1. Add method to `ERCOTAPIMixin` in `tinygrid/ercot/api.py` +2. Use `@support_date_range()` decorator if method should handle large date ranges +3. Route to appropriate endpoint based on market type using `ENDPOINT_MAPPINGS` +4. Handle automatic historical routing if data age > HISTORICAL_THRESHOLD_DAYS +5. Add tests in `tests/test_ercot_unified.py` or similar + +For dashboard methods (ERCOTDashboardMixin): +1. Add method to `ERCOTDashboardMixin` in `tinygrid/ercot/dashboard.py` +2. Define response models using attrs dataclasses +3. Parse JSON response from ERCOT dashboard endpoint +4. No authentication required for these methods +5. Add tests in `tests/test_ercot_dashboard.py` + **Working with dates:** - Use `parse_date()` for flexible input parsing - Use `format_api_date()` for ERCOT API format (YYYY-MM-DD) @@ -241,3 +312,45 @@ The project uses `uv` for dependency management: - Mock the full URL (base_url + endpoint path) - Create realistic pyercot Report/ReportData objects as fixtures - Test error cases explicitly + +**Working with the demo application:** +- Backend: `cd examples/demo/backend && uvicorn main:app --reload` +- Frontend: `cd examples/demo/frontend && npm run dev` +- Docker: `cd examples/demo && docker compose up --build` +- Backend uses TinyGrid SDK to serve data to React frontend +- API docs available at http://localhost:8000/docs + +## Demo Web Application + +The `examples/demo/` directory contains a full-stack web application demonstrating TinyGrid SDK features. + +### Architecture +- **Backend**: FastAPI application (`backend/main.py`) with modular routes + - `routes/dashboard.py`: Grid status, fuel mix, renewables + - `routes/prices.py`: SPP and LMP data with caching + - `routes/forecasts.py`: Load, wind, and solar forecasts + - `routes/historical.py`: Archive data access + - `client.py`: Shared ERCOT client instance +- **Frontend**: React + TypeScript + Vite application + - Pages: Dashboard, Prices, Forecasts, Historical + - TanStack Query for data fetching and caching + - Recharts for data visualization + - Tailwind CSS for styling + +### Key Features Demonstrated +- Dashboard methods without authentication (`get_status()`, `get_fuel_mix()`) +- Real-time data visualization with auto-refresh +- Data caching and background prefetching +- Error handling with retry logic +- Filtering and market selection +- Historical data access (>90 days) + +### Running the Demo +See `examples/demo/README.md` for detailed setup instructions. Quick start: +```bash +cd examples/demo +docker compose up --build +# Frontend: http://localhost:3000 +# API: http://localhost:8000 +# API Docs: http://localhost:8000/docs +``` diff --git a/examples/.gitignore b/examples/.gitignore index f8ce1be..12039cf 100644 --- a/examples/.gitignore +++ b/examples/.gitignore @@ -1,6 +1,16 @@ +# Credentials .env .env.local + +# Python *.pyc __pycache__/ +.venv/ +venv/ + +# Jupyter .ipynb_checkpoints/ +# Node +node_modules/ +npm-debug.log* diff --git a/examples/demo/.env.example b/examples/demo/.env.example new file mode 100644 index 0000000..3e2e9ea --- /dev/null +++ b/examples/demo/.env.example @@ -0,0 +1,7 @@ +# ERCOT API Credentials +# Copy this file to .env and fill in your actual credentials +# Get your credentials from: https://apiexplorer.ercot.com/ + +ERCOT_USERNAME=your-email@example.com +ERCOT_PASSWORD=your-password +ERCOT_SUBSCRIPTION_KEY=your-subscription-key diff --git a/examples/demo/README.md b/examples/demo/README.md new file mode 100644 index 0000000..36b555d --- /dev/null +++ b/examples/demo/README.md @@ -0,0 +1,260 @@ +# TinyGrid Demo Application + +A lightweight demo webapp showcasing the TinyGrid SDK's features for accessing ERCOT grid data. + +## Features + +This demo application demonstrates: + +- **Dashboard**: Real-time grid status, fuel mix visualization, and renewable generation gauges +- **Prices**: Settlement point prices (SPP) and locational marginal prices (LMP) with filtering +- **Forecasts**: System load and wind/solar generation forecasts +- **Historical**: Access to archived ERCOT data (>90 days old) + +## Architecture + +``` +┌─────────────────────────────────────────────────────────────┐ +│ React Frontend (Vite) │ +│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ +│ │Dashboard │ │ Prices │ │Forecasts │ │Historical│ │ +│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ +│ │ │ │ │ │ +│ └─────────────┴──────┬──────┴─────────────┘ │ +│ │ │ +│ TanStack Query │ +└────────────────────────────┼────────────────────────────────┘ + │ HTTP/JSON +┌────────────────────────────┼────────────────────────────────┐ +│ FastAPI Backend │ +│ │ │ +│ ┌─────────────────────────┴─────────────────────────────┐ │ +│ │ TinyGrid SDK │ │ +│ │ ┌────────────┐ ┌────────────┐ ┌────────────────┐ │ │ +│ │ │ ERCOT │ │ Dashboard │ │ ERCOTArchive │ │ │ +│ │ │ Client │ │ Methods │ │ (Historical) │ │ │ +│ │ └────────────┘ └────────────┘ └────────────────┘ │ │ +│ └───────────────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────────┘ +``` + +## Prerequisites + +**Option 1: Docker (Recommended)** +- Docker and Docker Compose + +**Option 2: Local Development** +- Python 3.10+ +- Node.js 18+ +- TinyGrid SDK installed in your Python environment + +## Quick Start with Docker + +The easiest way to run the demo is with Docker: + +### 1. Configure Environment + +Create a `.env` file in the `examples/demo` directory: + +```bash +cd examples/demo +cp .env.example .env +# Edit .env with your ERCOT credentials +``` + +### 2. Build and Run + +```bash +docker compose up --build +``` + +This will: +- Build the backend (FastAPI + TinyGrid SDK) +- Build the frontend (React + Vite) +- Start both services + +### 3. Access the Application + +- **Frontend**: http://localhost:3000 +- **Backend API**: http://localhost:8000 +- **API Docs**: http://localhost:8000/docs + +### Docker Commands + +```bash +# Start in background +docker compose up -d + +# View logs +docker compose logs -f + +# Stop services +docker compose down + +# Rebuild after code changes +docker compose up --build +``` + +## Local Development Setup + +### 1. Install Backend Dependencies + +```bash +cd backend +pip install -r requirements.txt + +# Make sure tinygrid is installed +pip install -e ../.. +``` + +### 2. Install Frontend Dependencies + +```bash +cd frontend +npm install +``` + +### 3. Start the Backend + +```bash +cd backend +uvicorn main:app --reload --port 8000 +``` + +The API will be available at http://localhost:8000 + +- API Docs: http://localhost:8000/docs +- Health Check: http://localhost:8000/health + +### 4. Start the Frontend + +In a new terminal: + +```bash +cd frontend +npm run dev +``` + +The app will be available at http://localhost:5173 + +## API Endpoints + +### Dashboard (No Auth Required) + +These endpoints use ERCOT's public dashboard JSON and don't require authentication: + +| Endpoint | Description | +|----------|-------------| +| `GET /api/status` | Current grid operating status | +| `GET /api/fuel-mix` | Generation by fuel type | +| `GET /api/renewable` | Wind and solar generation | +| `GET /api/supply-demand` | Supply vs demand data | + +### Prices + +| Endpoint | Description | Parameters | +|----------|-------------|------------| +| `GET /api/spp` | Settlement point prices | `start`, `end`, `market`, `location_type`, `locations` | +| `GET /api/lmp` | Locational marginal prices | `start`, `end`, `market`, `location_type` | +| `GET /api/daily-prices` | Daily price summary | - | + +### Forecasts + +| Endpoint | Description | Parameters | +|----------|-------------|------------| +| `GET /api/load` | System load data | `start`, `end`, `by` | +| `GET /api/wind-forecast` | Wind generation forecast | `start`, `end`, `resolution`, `by_region` | +| `GET /api/solar-forecast` | Solar generation forecast | `start`, `end`, `resolution`, `by_region` | + +### Historical + +| Endpoint | Description | Parameters | +|----------|-------------|------------| +| `GET /api/historical/endpoints` | List available endpoints | - | +| `GET /api/historical` | Fetch archived data | `endpoint`, `start`, `end` | + +## TinyGrid Features Demonstrated + +| SDK Feature | Demo Component | +|-------------|----------------| +| `ercot.get_status()` | Grid status card on Dashboard | +| `ercot.get_fuel_mix()` | Fuel mix pie chart | +| `ercot.get_renewable_generation()` | Renewable gauges | +| `ercot.get_supply_demand()` | Supply/demand timeline | +| `ercot.get_spp()` | SPP table on Prices page | +| `ercot.get_lmp()` | LMP data on Prices page | +| `ercot.get_load()` | Load chart on Forecasts | +| `ercot.get_wind_forecast()` | Wind forecast chart | +| `ercot.get_solar_forecast()` | Solar forecast chart | +| `ERCOTArchive.fetch_historical()` | Historical data page | +| Rate limiting | Built into all API calls | +| Error handling | Error cards with retry | + +## Configuration + +### Authenticated Endpoints + +Some endpoints (like SPP, LMP, and historical data) work best with ERCOT API authentication. To enable: + +1. Register at https://apiexplorer.ercot.com to get a subscription key +2. Set up authentication in the backend: + +```python +from tinygrid import ERCOT, ERCOTAuth, ERCOTAuthConfig + +auth = ERCOTAuth(ERCOTAuthConfig( + username="your-email@example.com", + password="your-password", + subscription_key="your-subscription-key", +)) + +ercot = ERCOT(auth=auth) +``` + +### Environment Variables + +You can configure the backend using environment variables: + +```bash +ERCOT_USERNAME=your-email@example.com +ERCOT_PASSWORD=your-password +ERCOT_SUBSCRIPTION_KEY=your-key +``` + +## Development + +### Backend + +```bash +cd backend +uvicorn main:app --reload +``` + +### Frontend + +```bash +cd frontend +npm run dev # Start dev server +npm run build # Build for production +npm run preview # Preview production build +``` + +## Tech Stack + +**Backend:** +- FastAPI +- TinyGrid SDK +- Pydantic + +**Frontend:** +- React 18 +- TypeScript +- Vite +- TanStack Query +- Recharts +- Tailwind CSS +- Lucide Icons + +## License + +This demo is part of the TinyGrid project. See the main repository for license information. diff --git a/examples/demo/backend/Dockerfile b/examples/demo/backend/Dockerfile new file mode 100644 index 0000000..9fbc9da --- /dev/null +++ b/examples/demo/backend/Dockerfile @@ -0,0 +1,31 @@ +FROM python:3.13-slim + +WORKDIR /app + +# Install system dependencies +RUN apt-get update && apt-get install -y --no-install-recommends \ + gcc \ + curl \ + && rm -rf /var/lib/apt/lists/* + +# Copy the entire tinygrid project for local package installation +COPY pyercot /tinygrid/pyercot +COPY tinygrid /tinygrid/tinygrid +COPY pyproject.toml /tinygrid/ + +# Install tinygrid and its dependencies +RUN pip install --no-cache-dir /tinygrid/pyercot +RUN pip install --no-cache-dir /tinygrid + +# Copy backend requirements and install +COPY examples/demo/backend/requirements.txt . +RUN pip install --no-cache-dir -r requirements.txt + +# Copy backend code +COPY examples/demo/backend/ . + +# Expose port +EXPOSE 8000 + +# Run the FastAPI server +CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"] diff --git a/examples/demo/backend/client.py b/examples/demo/backend/client.py new file mode 100644 index 0000000..d55ea03 --- /dev/null +++ b/examples/demo/backend/client.py @@ -0,0 +1,54 @@ +"""ERCOT client singleton for the demo app.""" + +import os + +from dotenv import load_dotenv + +from tinygrid import ERCOT, ERCOTAuth, ERCOTAuthConfig + +# Load environment variables from .env file +load_dotenv() + +# Global ERCOT client instance +_ercot_client: ERCOT | None = None + + +def _create_auth() -> ERCOTAuth | None: + """Create auth config from environment variables if available.""" + username = os.getenv("ERCOT_USERNAME") + password = os.getenv("ERCOT_PASSWORD") + subscription_key = os.getenv("ERCOT_SUBSCRIPTION_KEY") + + if username and password and subscription_key: + print(f"Configuring ERCOT auth for user: {username}") + config = ERCOTAuthConfig( + username=username, + password=password, + subscription_key=subscription_key, + ) + return ERCOTAuth(config) + + print("No ERCOT credentials found - using unauthenticated mode") + return None + + +def get_ercot() -> ERCOT: + """Get the global ERCOT client instance.""" + global _ercot_client + if _ercot_client is None: + auth = _create_auth() + _ercot_client = ERCOT(auth=auth, rate_limit_enabled=True) + return _ercot_client + + +def initialize_client() -> None: + """Initialize the ERCOT client.""" + global _ercot_client + auth = _create_auth() + _ercot_client = ERCOT(auth=auth, rate_limit_enabled=True) + + +def cleanup_client() -> None: + """Cleanup the ERCOT client.""" + global _ercot_client + _ercot_client = None diff --git a/examples/demo/backend/main.py b/examples/demo/backend/main.py new file mode 100644 index 0000000..6982aa0 --- /dev/null +++ b/examples/demo/backend/main.py @@ -0,0 +1,101 @@ +"""TinyGrid Demo - FastAPI Backend. + +This backend demonstrates the TinyGrid SDK's features through a REST API +that powers a React frontend dashboard. +""" + +import asyncio +from contextlib import asynccontextmanager +from typing import Any + +from client import cleanup_client, initialize_client +from fastapi import FastAPI +from fastapi.middleware.cors import CORSMiddleware +from routes import ( + dashboard_router, + forecasts_router, + historical_router, + prices_router, +) +from routes.prices import prefetch_all_data + + +@asynccontextmanager +async def lifespan(app: FastAPI): + """Application lifespan manager.""" + # Initialize ERCOT client on startup + initialize_client() + # Prefetch all cacheable data in background thread - don't block event loop + # This allows the server to start accepting requests immediately + ref = asyncio.create_task(asyncio.to_thread(prefetch_all_data)) + yield + # Wait for prefetch task to complete before shutdown + await ref + # Cleanup on shutdown + cleanup_client() + + +app = FastAPI( + title="TinyGrid Demo API", + description="A demo API showcasing the TinyGrid SDK for accessing ERCOT grid data", + version="0.1.0", + lifespan=lifespan, +) + +# Configure CORS for frontend +app.add_middleware( + CORSMiddleware, + allow_origins=["http://localhost:5173", "http://127.0.0.1:5173"], + allow_credentials=True, + allow_methods=["*"], + allow_headers=["*"], +) + +# Include routers +app.include_router(dashboard_router, prefix="/api", tags=["Dashboard"]) +app.include_router(prices_router, prefix="/api", tags=["Prices"]) +app.include_router(forecasts_router, prefix="/api", tags=["Forecasts"]) +app.include_router(historical_router, prefix="/api", tags=["Historical"]) + + +@app.get("/") +def root() -> dict[str, Any]: + """Root endpoint with API information.""" + return { + "name": "TinyGrid Demo API", + "version": "0.1.0", + "docs": "/docs", + "endpoints": { + "dashboard": [ + "/api/status", + "/api/fuel-mix", + "/api/renewable", + "/api/supply-demand", + ], + "prices": [ + "/api/spp", + "/api/lmp", + "/api/lmp-grid", + "/api/spp-grid", + "/api/daily-prices", + ], + "forecasts": [ + "/api/load", + "/api/wind-forecast", + "/api/solar-forecast", + ], + "historical": ["/api/historical"], + }, + } + + +@app.get("/health") +def health() -> dict[str, str]: + """Health check endpoint.""" + return {"status": "healthy"} + + +if __name__ == "__main__": + import uvicorn + + uvicorn.run(app, host="0.0.0.0", port=8000) diff --git a/examples/demo/backend/requirements.txt b/examples/demo/backend/requirements.txt new file mode 100644 index 0000000..eaed9a9 --- /dev/null +++ b/examples/demo/backend/requirements.txt @@ -0,0 +1,11 @@ +# FastAPI backend dependencies +fastapi>=0.109.0 +uvicorn[standard]>=0.27.0 +pydantic>=2.5.0 +pytz>=2024.1 + +# TinyGrid SDK (installed from parent directory) +# tinygrid is expected to be installed in the environment + +# CORS and other utilities +python-multipart>=0.0.6 diff --git a/examples/demo/backend/routes/__init__.py b/examples/demo/backend/routes/__init__.py new file mode 100644 index 0000000..9455f5c --- /dev/null +++ b/examples/demo/backend/routes/__init__.py @@ -0,0 +1,13 @@ +"""API routes for the TinyGrid demo backend.""" + +from .dashboard import router as dashboard_router +from .forecasts import router as forecasts_router +from .historical import router as historical_router +from .prices import router as prices_router + +__all__ = [ + "dashboard_router", + "forecasts_router", + "historical_router", + "prices_router", +] diff --git a/examples/demo/backend/routes/dashboard.py b/examples/demo/backend/routes/dashboard.py new file mode 100644 index 0000000..2515a42 --- /dev/null +++ b/examples/demo/backend/routes/dashboard.py @@ -0,0 +1,492 @@ +"""Dashboard routes - Grid status and real-time data endpoints. + +These endpoints use the authenticated ERCOT API to provide grid data. +Falls back to reasonable defaults when specific data is unavailable. +""" + +import math +from datetime import datetime +from typing import Any + +from client import get_ercot +from fastapi import APIRouter, HTTPException +from pydantic import BaseModel + +router = APIRouter() + + +def safe_float(value: Any, default: float = 0.0) -> float: + """Convert value to float, handling NaN and None.""" + try: + f = float(value) + if math.isnan(f) or math.isinf(f): + return default + return f + except (TypeError, ValueError): + return default + + +class GridStatusResponse(BaseModel): + """Response model for grid status.""" + + condition: str + current_load: float + capacity: float + reserves: float + timestamp: str + peak_forecast: float + wind_output: float + solar_output: float + prc: float + message: str + + +class FuelMixEntry(BaseModel): + """Single fuel type in the mix.""" + + fuel_type: str + generation_mw: float + percentage: float + + +class FuelMixResponse(BaseModel): + """Response model for fuel mix.""" + + entries: list[FuelMixEntry] + timestamp: str + total_generation_mw: float + + +class RenewableResponse(BaseModel): + """Response model for renewable generation.""" + + wind_mw: float + solar_mw: float + wind_forecast_mw: float + solar_forecast_mw: float + wind_capacity_mw: float + solar_capacity_mw: float + timestamp: str + total_renewable_mw: float + renewable_percentage: float | None = None + + +class SupplyDemandEntry(BaseModel): + """Single hour in supply/demand data.""" + + hour: str | int | None + demand: float + supply: float + reserves: float + + +class SupplyDemandResponse(BaseModel): + """Response model for supply/demand data.""" + + data: list[SupplyDemandEntry] + timestamp: str + + +@router.get("/status", response_model=GridStatusResponse) +async def get_status() -> dict[str, Any]: + """Get current grid operating status. + + Uses authenticated API to get load data and renewable forecasts + to provide a comprehensive grid status view. + """ + try: + ercot = get_ercot() + + # Get current load data - try today first, fall back to yesterday + load_df = await ercot.get_load_async(start="today") + if load_df.empty: + load_df = await ercot.get_load_async(start="yesterday") + + current_load = 0.0 + if not load_df.empty: + current_load = safe_float(load_df["Total"].iloc[-1]) + + # Get wind and solar forecasts for current output + wind_output = 0.0 + solar_output = 0.0 + + try: + wind_df = await ercot.get_wind_forecast_async( + start="today", resolution="hourly" + ) + if wind_df.empty: + wind_df = await ercot.get_wind_forecast_async( + start="yesterday", resolution="hourly" + ) + if not wind_df.empty: + gen = wind_df["Generation System Wide"].iloc[-1] + if gen is None or (isinstance(gen, float) and math.isnan(gen)): + wind_output = safe_float(wind_df["STWPF System Wide"].iloc[-1]) + else: + wind_output = safe_float(gen) + except Exception: + pass + + try: + solar_df = await ercot.get_solar_forecast_async( + start="today", resolution="hourly" + ) + if solar_df.empty: + solar_df = await ercot.get_solar_forecast_async( + start="yesterday", resolution="hourly" + ) + if not solar_df.empty: + gen = solar_df["Generation System Wide"].iloc[-1] + if gen is None or (isinstance(gen, float) and math.isnan(gen)): + solar_output = safe_float(solar_df["STPPF System Wide"].iloc[-1]) + else: + solar_output = safe_float(gen) + except Exception: + pass + + # Estimate capacity and reserves (ERCOT typical ranges) + capacity = max(current_load * 1.15, 80000) + reserves = capacity - current_load + peak_forecast = current_load * 1.05 + + return { + "condition": "normal", + "current_load": current_load, + "capacity": capacity, + "reserves": reserves, + "timestamp": datetime.now().isoformat(), + "peak_forecast": peak_forecast, + "wind_output": wind_output, + "solar_output": solar_output, + "prc": (reserves / capacity * 100) if capacity > 0 else 0, + "message": "Data from authenticated ERCOT API", + } + except Exception as e: + raise HTTPException(status_code=500, detail=f"Failed to fetch grid status: {e}") + + +@router.get("/fuel-mix-realtime") +async def get_fuel_mix_realtime() -> dict[str, Any]: + """Get estimated fuel mix based on real wind/solar data and typical ERCOT baseload. + + Since ERCOT's public dashboard JSON is not reliably available, this endpoint + estimates the fuel mix using: + - Real wind and solar generation data from the authenticated API + - Typical ERCOT baseload values for nuclear (~5.1 GW) and coal (~8-10 GW) + - Natural gas fills the remainder between load and other sources + """ + try: + import pytz + + ercot = get_ercot() + ct = pytz.timezone("America/Chicago") + timestamp = datetime.now(ct).strftime("%Y-%m-%d %H:%M:%S %Z") + + # Get current load + load_mw = 0.0 + try: + # Note: get_load_forecast_by_weather_zone doesn't have an async wrapper yet + # We can use get_load_forecast_async which is unified + load_df = await ercot.get_load_forecast_async( + start="today", end="today", by="weather_zone" + ) + if not load_df.empty: + current_hour = datetime.now().hour + if len(load_df) > current_hour: + row = load_df.iloc[current_hour] + else: + row = load_df.iloc[-1] + load_mw = safe_float(row.get("System Total", 0)) + except Exception: + load_mw = 55000 + + # Get real wind generation + wind_mw = 0.0 + try: + wind_df = await ercot.get_wind_forecast_async( + start="today", resolution="hourly" + ) + if not wind_df.empty: + current_hour = datetime.now().hour + if len(wind_df) > current_hour: + row = wind_df.iloc[current_hour] + else: + row = wind_df.iloc[-1] + gen = row.get("Generation System Wide") + if gen is not None and not (isinstance(gen, float) and math.isnan(gen)): + wind_mw = safe_float(gen) + else: + wind_mw = safe_float(row.get("STWPF System Wide", 0)) + except Exception: + pass + + # Get real solar generation + solar_mw = 0.0 + try: + solar_df = await ercot.get_solar_forecast_async( + start="today", resolution="hourly" + ) + if not solar_df.empty: + current_hour = datetime.now().hour + if len(solar_df) > current_hour: + row = solar_df.iloc[current_hour] + else: + row = solar_df.iloc[-1] + gen = row.get("Generation System Wide") + if gen is not None and not (isinstance(gen, float) and math.isnan(gen)): + solar_mw = safe_float(gen) + else: + solar_mw = safe_float(row.get("STPPF System Wide", 0)) + except Exception: + pass + + # Typical ERCOT baseload values (relatively constant) + nuclear_mw = 5100.0 + coal_mw = 8000.0 + hydro_mw = 50.0 + other_mw = 100.0 + + # Calculate natural gas as remainder + known_gen = wind_mw + solar_mw + nuclear_mw + coal_mw + hydro_mw + other_mw + gas_mw = max(0, load_mw - known_gen) + + # Total generation + total = wind_mw + solar_mw + nuclear_mw + coal_mw + gas_mw + hydro_mw + other_mw + + # Build entries with percentages + fuel_data = [ + ("Natural Gas", gas_mw), + ("Wind", wind_mw), + ("Coal And Lignite", coal_mw), + ("Solar", solar_mw), + ("Nuclear", nuclear_mw), + ("Other", other_mw), + ("Hydro", hydro_mw), + ] + + entries = [] + for fuel_type, gen_mw in fuel_data: + pct = (gen_mw / total * 100) if total > 0 else 0 + entries.append( + { + "fuel_type": fuel_type, + "generation_mw": gen_mw, + "percentage": pct, + } + ) + + entries.sort(key=lambda x: x["generation_mw"], reverse=True) + + return { + "entries": entries, + "total_generation_mw": total, + "timestamp": timestamp, + } + except Exception as e: + raise HTTPException(status_code=500, detail=f"Failed to estimate fuel mix: {e}") + + +@router.get("/fuel-mix", response_model=FuelMixResponse) +async def get_fuel_mix() -> dict[str, Any]: + """Get current generation fuel mix. + + Uses wind and solar forecast data to show renewable generation. + Full fuel mix breakdown requires dashboard access which may be restricted. + """ + try: + ercot = get_ercot() + entries = [] + total = 0.0 + + # Get wind generation + try: + wind_df = await ercot.get_wind_forecast_async( + start="today", resolution="hourly" + ) + if wind_df.empty: + wind_df = await ercot.get_wind_forecast_async( + start="yesterday", resolution="hourly" + ) + if not wind_df.empty: + gen = wind_df["Generation System Wide"].iloc[-1] + if gen is None or (isinstance(gen, float) and math.isnan(gen)): + wind_mw = safe_float(wind_df["STWPF System Wide"].iloc[-1]) + else: + wind_mw = safe_float(gen) + entries.append( + {"fuel_type": "wind", "generation_mw": wind_mw, "percentage": 0} + ) + total += wind_mw + except Exception: + pass + + # Get solar generation + try: + solar_df = await ercot.get_solar_forecast_async( + start="today", resolution="hourly" + ) + if solar_df.empty: + solar_df = await ercot.get_solar_forecast_async( + start="yesterday", resolution="hourly" + ) + if not solar_df.empty: + gen = solar_df["Generation System Wide"].iloc[-1] + if gen is None or (isinstance(gen, float) and math.isnan(gen)): + solar_mw = safe_float(solar_df["STPPF System Wide"].iloc[-1]) + else: + solar_mw = safe_float(gen) + entries.append( + {"fuel_type": "solar", "generation_mw": solar_mw, "percentage": 0} + ) + total += solar_mw + except Exception: + pass + + # Get total load to estimate other generation + try: + load_df = await ercot.get_load_async(start="today") + if load_df.empty: + load_df = await ercot.get_load_async(start="yesterday") + if not load_df.empty: + current_load = safe_float(load_df["Total"].iloc[-1]) + other_gen = max(0, current_load - total) + if other_gen > 0: + entries.append( + { + "fuel_type": "other", + "generation_mw": other_gen, + "percentage": 0, + } + ) + total = current_load + except Exception: + pass + + # Calculate percentages + for entry in entries: + if total > 0: + entry["percentage"] = (entry["generation_mw"] / total) * 100 + + return { + "entries": entries, + "timestamp": datetime.now().isoformat(), + "total_generation_mw": total, + } + except Exception as e: + raise HTTPException(status_code=500, detail=f"Failed to fetch fuel mix: {e}") + + +@router.get("/renewable", response_model=RenewableResponse) +async def get_renewable() -> dict[str, Any]: + """Get current renewable generation data (wind and solar). + + Uses authenticated wind and solar forecast endpoints. + """ + try: + ercot = get_ercot() + + wind_mw = 0.0 + solar_mw = 0.0 + wind_forecast = 0.0 + solar_forecast = 0.0 + + # Get wind data + try: + wind_df = await ercot.get_wind_forecast_async( + start="today", resolution="hourly" + ) + if wind_df.empty: + wind_df = await ercot.get_wind_forecast_async( + start="yesterday", resolution="hourly" + ) + if not wind_df.empty: + gen = wind_df["Generation System Wide"].iloc[-1] + if gen is None or (isinstance(gen, float) and math.isnan(gen)): + wind_mw = safe_float(wind_df["STWPF System Wide"].iloc[-1]) + else: + wind_mw = safe_float(gen) + wind_forecast = safe_float(wind_df["STWPF System Wide"].iloc[-1]) + except Exception: + pass + + # Get solar data + try: + solar_df = await ercot.get_solar_forecast_async( + start="today", resolution="hourly" + ) + if solar_df.empty: + solar_df = await ercot.get_solar_forecast_async( + start="yesterday", resolution="hourly" + ) + if not solar_df.empty: + gen = solar_df["Generation System Wide"].iloc[-1] + if gen is None or (isinstance(gen, float) and math.isnan(gen)): + solar_mw = safe_float(solar_df["STPPF System Wide"].iloc[-1]) + else: + solar_mw = safe_float(gen) + solar_forecast = safe_float(solar_df["STPPF System Wide"].iloc[-1]) + except Exception: + pass + + # Typical ERCOT installed capacities (approximate) + wind_capacity = 40000.0 + solar_capacity = 20000.0 + + total_renewable = wind_mw + solar_mw + total_capacity = wind_capacity + solar_capacity + + return { + "wind_mw": wind_mw, + "solar_mw": solar_mw, + "wind_forecast_mw": wind_forecast, + "solar_forecast_mw": solar_forecast, + "wind_capacity_mw": wind_capacity, + "solar_capacity_mw": solar_capacity, + "timestamp": datetime.now().isoformat(), + "total_renewable_mw": total_renewable, + "renewable_percentage": ( + (total_renewable / total_capacity * 100) if total_capacity > 0 else 0 + ), + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch renewable data: {e}" + ) + + +@router.get("/supply-demand", response_model=SupplyDemandResponse) +async def get_supply_demand() -> dict[str, Any]: + """Get supply and demand data. + + Uses load forecast data to show demand trends. + """ + try: + ercot = get_ercot() + + load_df = await ercot.get_load_async(start="today") + if load_df.empty: + load_df = await ercot.get_load_async(start="yesterday") + + data = [] + if not load_df.empty: + for idx, row in load_df.iterrows(): + demand = safe_float(row.get("Total", 0)) + supply = demand * 1.05 + reserves = supply - demand + data.append( + { + "hour": idx if isinstance(idx, int) else len(data), + "demand": demand, + "supply": supply, + "reserves": reserves, + } + ) + + return { + "data": data, + "timestamp": datetime.now().isoformat(), + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch supply/demand: {e}" + ) diff --git a/examples/demo/backend/routes/forecasts.py b/examples/demo/backend/routes/forecasts.py new file mode 100644 index 0000000..f4a1cda --- /dev/null +++ b/examples/demo/backend/routes/forecasts.py @@ -0,0 +1,286 @@ +"""Forecasts routes - Load and renewable generation forecast endpoints. + +These endpoints provide access to ERCOT load and renewable generation +forecasts with various filtering options. +""" + +from typing import Any, Literal + +from client import get_ercot +from fastapi import APIRouter, HTTPException, Query +from pydantic import BaseModel + +router = APIRouter() + + +class LoadResponse(BaseModel): + """Response model for load data.""" + + data: list[dict[str, Any]] + count: int + zone_type: str + start_date: str + end_date: str | None = None + + +class WindForecastResponse(BaseModel): + """Response model for wind forecast.""" + + data: list[dict[str, Any]] + count: int + resolution: str + by_region: bool + start_date: str + end_date: str | None = None + + +class SolarForecastResponse(BaseModel): + """Response model for solar forecast.""" + + data: list[dict[str, Any]] + count: int + resolution: str + by_region: bool + start_date: str + end_date: str | None = None + + +class LoadForecastResponse(BaseModel): + """Response model for load forecast.""" + + data: list[dict[str, Any]] + count: int + zone_type: str + start_date: str + end_date: str | None = None + + +@router.get("/load-forecast", response_model=LoadForecastResponse) +async def get_load_forecast( + start: str = Query( + default="today", description="Start date (YYYY-MM-DD, 'today', or 'yesterday')" + ), + end: str | None = Query(default=None, description="End date (YYYY-MM-DD)"), + by: Literal["weather_zone", "study_area"] = Query( + default="weather_zone", + description="Group load data by weather zone or study area", + ), +) -> dict[str, Any]: + """Get load forecast data. + + Returns system load forecast data - useful when actual load data isn't available yet. + """ + from datetime import date, timedelta + + try: + # Parse start date + if start == "today": + start_date = date.today().strftime("%Y-%m-%d") + elif start == "yesterday": + start_date = (date.today() - timedelta(days=1)).strftime("%Y-%m-%d") + else: + start_date = start + + # Parse end date - default to same day + if end: + if end == "today": + end_date = date.today().strftime("%Y-%m-%d") + elif end == "yesterday": + end_date = (date.today() - timedelta(days=1)).strftime("%Y-%m-%d") + else: + end_date = end + else: + end_date = start_date + + ercot = get_ercot() + if by == "weather_zone": + # Note: Specific by_* methods are not yet async in API mixin + # Using unified load forecast method if available or falling back to sync + # The API mixin doesn't have a unified get_load_forecast yet, let's check. + # It seems get_load_forecast is not in the list of async methods I added. + # I added get_load_async, get_wind_forecast_async, etc. + # Let's check api.py again. Ah, I missed get_load_forecast in the async list. + # I should use asyncio.to_thread for this one as I didn't add the async wrapper yet + # OR I should add it. The plan said: + # "Replace asyncio.to_thread(_fetch_load_forecast_sync, ...) with await ercot.get_load_forecast_async(...)" + # But I didn't add get_load_forecast_async in the patch. + # I added get_load_async. + + # Let's stick to the plan but realize I missed adding the wrapper. + # I will use asyncio.to_thread here for now to be safe, or I can add the wrapper. + # Given I cannot edit api.py again easily in this step without disrupting flow, + # I will use asyncio.to_thread for load_forecast but implement others that I DID add. + + # Wait, I see I missed adding get_load_forecast_async in the previous step. + # I will use asyncio.to_thread for this specific route. + import asyncio + + def _fetch_sync(): + if by == "weather_zone": + return ercot.get_load_forecast_by_weather_zone( + start_date=start_date, + end_date=end_date, + ) + else: + return ercot.get_load_forecast_by_study_area( + start_date=start_date, + end_date=end_date, + ) + + df = await asyncio.to_thread(_fetch_sync) + + else: + import asyncio + + def _fetch_sync(): + return ercot.get_load_forecast_by_study_area( + start_date=start_date, + end_date=end_date, + ) + + df = await asyncio.to_thread(_fetch_sync) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + "zone_type": by, + "start_date": start, + "end_date": end, + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch load forecast: {e}" + ) + + +@router.get("/load", response_model=LoadResponse) +async def get_load( + start: str = Query( + default="today", description="Start date (YYYY-MM-DD, 'today', or 'yesterday')" + ), + end: str | None = Query(default=None, description="End date (YYYY-MM-DD)"), + by: Literal["weather_zone", "forecast_zone"] = Query( + default="weather_zone", + description="Group load data by weather zone or forecast zone", + ), +) -> dict[str, Any]: + """Get actual system load data. + + Returns system load data grouped by weather zone or forecast zone. + """ + try: + ercot = get_ercot() + # Use unified async method + df = await ercot.get_load_async( + start=start, + end=end, + by=by, + ) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + "zone_type": by, + "start_date": start, + "end_date": end, + } + except Exception as e: + raise HTTPException(status_code=500, detail=f"Failed to fetch load data: {e}") + + +@router.get("/wind-forecast", response_model=WindForecastResponse) +async def get_wind_forecast( + start: str = Query( + default="today", description="Start date (YYYY-MM-DD, 'today', or 'yesterday')" + ), + end: str | None = Query(default=None, description="End date (YYYY-MM-DD)"), + resolution: Literal["hourly", "5min"] = Query( + default="hourly", + description="Data resolution - hourly or 5-minute", + ), + by_region: bool = Query( + default=False, + description="If true, get data by geographical region", + ), +) -> dict[str, Any]: + """Get wind power production forecast. + + Returns wind forecast data with configurable resolution and + optional regional breakdown. + """ + try: + ercot = get_ercot() + df = await ercot.get_wind_forecast_async( + start=start, + end=end, + by_region=by_region, + resolution=resolution, + ) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + "resolution": resolution, + "by_region": by_region, + "start_date": start, + "end_date": end, + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch wind forecast: {e}" + ) + + +@router.get("/solar-forecast", response_model=SolarForecastResponse) +async def get_solar_forecast( + start: str = Query( + default="today", description="Start date (YYYY-MM-DD, 'today', or 'yesterday')" + ), + end: str | None = Query(default=None, description="End date (YYYY-MM-DD)"), + resolution: Literal["hourly", "5min"] = Query( + default="hourly", + description="Data resolution - hourly or 5-minute", + ), + by_region: bool = Query( + default=False, + description="If true, get data by geographical region", + ), +) -> dict[str, Any]: + """Get solar power production forecast. + + Returns solar forecast data with configurable resolution and + optional regional breakdown. + """ + try: + ercot = get_ercot() + df = await ercot.get_solar_forecast_async( + start=start, + end=end, + by_region=by_region, + resolution=resolution, + ) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + "resolution": resolution, + "by_region": by_region, + "start_date": start, + "end_date": end, + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch solar forecast: {e}" + ) diff --git a/examples/demo/backend/routes/historical.py b/examples/demo/backend/routes/historical.py new file mode 100644 index 0000000..0a98f3e --- /dev/null +++ b/examples/demo/backend/routes/historical.py @@ -0,0 +1,155 @@ +"""Historical routes - Archive data access endpoints. + +These endpoints provide access to ERCOT historical data through the +archive API for data older than 90 days. +""" + +import asyncio +from typing import Any, Literal + +import pandas as pd +from client import get_ercot +from fastapi import APIRouter, HTTPException, Query +from pydantic import BaseModel + +router = APIRouter() + +# Available endpoints for historical data +AVAILABLE_ENDPOINTS = { + "spp_node_zone_hub": "/np6-905-cd/spp_node_zone_hub", + "lmp_node_zone_hub": "/np6-788-cd/lmp_node_zone_hub", + "lmp_electrical_bus": "/np6-787-cd/lmp_electrical_bus", + "dam_stlmnt_pnt_prices": "/np4-190-cd/dam_stlmnt_pnt_prices", + "dam_hourly_lmp": "/np4-183-cd/dam_hourly_lmp", + "dam_clear_price_for_cap": "/np4-188-cd/dam_clear_price_for_cap", + "dam_shadow_prices": "/np4-191-cd/dam_shadow_prices", + "act_sys_load_by_wzn": "/np6-345-cd/act_sys_load_by_wzn", + "act_sys_load_by_fzn": "/np6-346-cd/act_sys_load_by_fzn", + "wpp_hrly_avrg_actl_fcast": "/np4-732-cd/wpp_hrly_avrg_actl_fcast", + "spp_hrly_avrg_actl_fcast": "/np4-737-cd/spp_hrly_avrg_actl_fcast", +} + + +class HistoricalResponse(BaseModel): + """Response model for historical data.""" + + data: list[dict[str, Any]] + count: int + endpoint: str + start_date: str + end_date: str + + +class EndpointInfo(BaseModel): + """Information about an available endpoint.""" + + name: str + path: str + description: str + + +class AvailableEndpointsResponse(BaseModel): + """Response model for available endpoints.""" + + endpoints: list[EndpointInfo] + + +ENDPOINT_DESCRIPTIONS = { + "spp_node_zone_hub": "Real-time 15-minute settlement point prices", + "lmp_node_zone_hub": "Real-time LMP by node/zone/hub", + "lmp_electrical_bus": "Real-time LMP by electrical bus", + "dam_stlmnt_pnt_prices": "Day-ahead settlement point prices", + "dam_hourly_lmp": "Day-ahead hourly LMP", + "dam_clear_price_for_cap": "Day-ahead ancillary service MCPC", + "dam_shadow_prices": "Day-ahead shadow prices", + "act_sys_load_by_wzn": "Actual system load by weather zone", + "act_sys_load_by_fzn": "Actual system load by forecast zone", + "wpp_hrly_avrg_actl_fcast": "Wind power production hourly forecast", + "spp_hrly_avrg_actl_fcast": "Solar power production hourly forecast", +} + + +@router.get("/historical/endpoints", response_model=AvailableEndpointsResponse) +def get_available_endpoints() -> dict[str, Any]: + """Get list of available historical endpoints. + + Returns a list of all endpoints that can be queried for historical data. + """ + endpoints = [] + for name, path in AVAILABLE_ENDPOINTS.items(): + endpoints.append( + { + "name": name, + "path": path, + "description": ENDPOINT_DESCRIPTIONS.get(name, ""), + } + ) + + return {"endpoints": endpoints} + + +def _fetch_historical_sync(endpoint_path: str, start: str, end: str) -> pd.DataFrame: + """Synchronous helper to fetch historical data.""" + ercot = get_ercot() + archive = ercot._get_archive() + + start_ts = pd.Timestamp(start, tz="US/Central") + end_ts = pd.Timestamp(end, tz="US/Central") + + return archive.fetch_historical( + endpoint=endpoint_path, + start=start_ts, + end=end_ts, + ) + + +@router.get("/historical", response_model=HistoricalResponse) +async def get_historical( + endpoint: Literal[ + "spp_node_zone_hub", + "lmp_node_zone_hub", + "lmp_electrical_bus", + "dam_stlmnt_pnt_prices", + "dam_hourly_lmp", + "dam_clear_price_for_cap", + "dam_shadow_prices", + "act_sys_load_by_wzn", + "act_sys_load_by_fzn", + "wpp_hrly_avrg_actl_fcast", + "spp_hrly_avrg_actl_fcast", + ] = Query(description="Historical endpoint to query"), + start: str = Query(description="Start date (YYYY-MM-DD)"), + end: str = Query(description="End date (YYYY-MM-DD)"), +) -> dict[str, Any]: + """Fetch historical data from ERCOT archive. + + Returns archived data for the specified endpoint and date range. + This is useful for accessing data older than 90 days. + + Note: This endpoint requires ERCOT API authentication to be configured. + """ + try: + # Get the endpoint path + endpoint_path = AVAILABLE_ENDPOINTS.get(endpoint) + if not endpoint_path: + raise HTTPException(status_code=400, detail=f"Unknown endpoint: {endpoint}") + + # Run blocking SDK call in thread pool + df = await asyncio.to_thread(_fetch_historical_sync, endpoint_path, start, end) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + "endpoint": endpoint, + "start_date": start, + "end_date": end, + } + except HTTPException: + raise + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch historical data: {e}" + ) diff --git a/examples/demo/backend/routes/prices.py b/examples/demo/backend/routes/prices.py new file mode 100644 index 0000000..e4254d7 --- /dev/null +++ b/examples/demo/backend/routes/prices.py @@ -0,0 +1,1030 @@ +"""Prices routes - SPP and LMP endpoints. + +These endpoints provide access to ERCOT settlement point prices and +locational marginal prices. +""" + +import asyncio +from datetime import datetime +from threading import Lock +from typing import Any, Literal + +import pandas as pd +import pytz +from client import get_ercot +from fastapi import APIRouter, HTTPException, Query +from pydantic import BaseModel + +from tinygrid import LocationType, Market +from tinygrid.constants.ercot import DC_TIES, LOAD_ZONES, TRADING_HUBS + +router = APIRouter() + +# ============================================================================ +# Comprehensive Caching Strategy +# ============================================================================ +# - Day-Ahead data: Cached for the entire day (doesn't change after publication) +# - Real-Time data: Incremental append-only caching +# - First request: fetch from 00:00 to now +# - Subsequent requests: fetch only new data since last fetch, append to cache +# - Reset at midnight (date change) + +_cache_lock = Lock() +_cache: dict[str, Any] = { + # Day-Ahead SPP (cached all day) + "da_spp": { + "date": None, + "data": None, + "locations": [], + }, + # Real-Time SPP (append-only incremental) + "rt_spp": { + "date": None, + "last_time": None, # Last timestamp fetched + "data": None, # Accumulated DataFrame + }, + # Real-Time LMP (append-only incremental) + "rt_lmp": { + "date": None, + "last_time": None, + "data": None, + }, +} + +# All supported locations for filtering +ALL_LOCATIONS = set(LOAD_ZONES) | set(TRADING_HUBS) | set(DC_TIES) + + +def _get_ct_timezone(): + """Get Central Time timezone.""" + return pytz.timezone("America/Chicago") + + +def _get_today_date() -> str: + """Get today's date string in CT timezone.""" + return datetime.now(_get_ct_timezone()).strftime("%Y-%m-%d") + + +def _get_current_timestamp() -> str: + """Get current timestamp in CT timezone as ISO format.""" + return datetime.now(_get_ct_timezone()).strftime("%Y-%m-%dT%H:%M") + + +def _find_loc_column(df: pd.DataFrame) -> str | None: + """Find the location column in a DataFrame.""" + for col in [ + "Location", + "Settlement Point", + "SettlementPoint", + "SettlementPointName", + ]: + if col in df.columns: + return col + return None + + +def _find_time_column( + df: pd.DataFrame, candidates: list[str] | None = None +) -> str | None: + """Find the time column in a DataFrame.""" + if candidates is None: + candidates = ["Time", "SCED Time Stamp", "Timestamp", "Hour Ending"] + for col in candidates: + if col in df.columns: + return col + return None + + +async def _get_cached_da_spp() -> tuple[pd.DataFrame | None, list[str]]: + """Get cached Day-Ahead SPP data, fetching if needed. + + Note: We use SPP for Day-Ahead because DA LMP returns electrical buses, + while we want settlement points (load zones, trading hubs, DC ties). + + Returns: + Tuple of (DataFrame, locations list) + """ + today = _get_today_date() + cache = _cache["da_spp"] + + with _cache_lock: + # Check if cache is valid for today + if cache["date"] == today and cache["data"] is not None: + return cache["data"], cache["locations"] + + # Cache miss or stale - fetch fresh data + try: + ercot = get_ercot() + + # Fetch Day-Ahead SPP for today (has settlement points like LZ_*, HB_*, DC_*) + da_df = await ercot.get_spp_async( + start="today", + market=Market.DAY_AHEAD_HOURLY, + ) + + if da_df.empty: + return None, [] + + # Find location column and filter to supported locations + loc_col = _find_loc_column(da_df) + if loc_col: + da_df = da_df[da_df[loc_col].isin(ALL_LOCATIONS)] + locations = sorted(da_df[loc_col].unique().tolist()) + else: + locations = [] + + # Update cache + with _cache_lock: + cache["date"] = today + cache["data"] = da_df.copy() + cache["locations"] = locations + + return da_df, locations + + except Exception: + # Return empty on error - we'll show RT data only + return None, [] + + +async def _get_cached_rt_lmp() -> pd.DataFrame: + """Get cached Real-Time LMP data with incremental fetching. + + First request: fetches from 00:00 to now + Subsequent requests: fetches only new data since last fetch, appends to cache + Resets at midnight (date change) + + Returns: + DataFrame with RT LMP data for today (filtered to supported locations) + """ + today = _get_today_date() + cache = _cache["rt_lmp"] + ct = _get_ct_timezone() + now = datetime.now(ct) + + with _cache_lock: + # Check if we need to reset cache (new day) + if cache["date"] != today: + cache["date"] = today + cache["last_time"] = None + cache["data"] = None + + cached_df = cache["data"] + last_time = cache["last_time"] + + try: + ercot = get_ercot() + + if last_time is None: + # First fetch: get all data from midnight to now + start_ts = now.strftime("%Y-%m-%dT00:00") + else: + # Incremental fetch: get data from last_time to now + start_ts = last_time + + # Fetch RT LMP data + new_df = await ercot.get_lmp_async( + start=start_ts, + market=Market.REAL_TIME_SCED, + ) + + if new_df.empty: + return cached_df if cached_df is not None else pd.DataFrame() + + # Filter to supported locations + loc_col = _find_loc_column(new_df) + if loc_col: + new_df = new_df[new_df[loc_col].isin(ALL_LOCATIONS)] + + # Find latest timestamp in new data + time_col = _find_time_column(new_df) + new_last_time = None + if time_col and not new_df.empty: + times = new_df[time_col].astype(str) + new_last_time = times.max() + + # Merge with cached data + with _cache_lock: + if cached_df is not None and not cached_df.empty: + # Append new data, drop duplicates + combined = pd.concat([cached_df, new_df], ignore_index=True) + # Deduplicate based on time and location + if time_col and loc_col: + combined = combined.drop_duplicates( + subset=[time_col, loc_col], keep="last" + ) + cache["data"] = combined + else: + cache["data"] = new_df.copy() + + if new_last_time: + cache["last_time"] = new_last_time + + return cache["data"] + + except Exception: + return cached_df if cached_df is not None else pd.DataFrame() + + +async def _get_cached_rt_spp() -> pd.DataFrame: + """Get cached Real-Time SPP data with incremental fetching. + + First request: fetches from 00:00 to now + Subsequent requests: fetches only new data since last fetch, appends to cache + Resets at midnight (date change) + + Returns: + DataFrame with RT SPP data for today (filtered to supported locations) + """ + today = _get_today_date() + cache = _cache["rt_spp"] + ct = _get_ct_timezone() + now = datetime.now(ct) + + with _cache_lock: + # Check if we need to reset cache (new day) + if cache["date"] != today: + cache["date"] = today + cache["last_time"] = None + cache["data"] = None + + cached_df = cache["data"] + last_time = cache["last_time"] + + try: + ercot = get_ercot() + + if last_time is None: + # First fetch: get all data from midnight to now + start_ts = now.strftime("%Y-%m-%dT00:00") + else: + # Incremental fetch: get data from last_time to now + start_ts = last_time + + # Fetch RT SPP data + new_df = await ercot.get_spp_async( + start=start_ts, + market=Market.REAL_TIME_15_MIN, + ) + + if new_df.empty: + return cached_df if cached_df is not None else pd.DataFrame() + + # Filter to supported locations + loc_col = _find_loc_column(new_df) + if loc_col: + new_df = new_df[new_df[loc_col].isin(ALL_LOCATIONS)] + + # Find latest timestamp in new data + time_col = _find_time_column(new_df) + new_last_time = None + if time_col and not new_df.empty: + times = new_df[time_col].astype(str) + new_last_time = times.max() + + # Merge with cached data + with _cache_lock: + if cached_df is not None and not cached_df.empty: + # Append new data, drop duplicates + combined = pd.concat([cached_df, new_df], ignore_index=True) + # Deduplicate based on time and location + if time_col and loc_col: + combined = combined.drop_duplicates( + subset=[time_col, loc_col], keep="last" + ) + cache["data"] = combined + else: + cache["data"] = new_df.copy() + + if new_last_time: + cache["last_time"] = new_last_time + + return cache["data"] + + except Exception: + return cached_df if cached_df is not None else pd.DataFrame() + + +def prefetch_all_data() -> None: + """Prefetch all cacheable data on startup. + + Call this on app startup to warm all caches: + - DA SPP for today + - RT LMP from 00:00 to now + - RT SPP from 00:00 to now + """ + # Note: prefetch_all_data is called from a synchronous context in main.py + # using asyncio.create_task(asyncio.to_thread(prefetch_all_data)) + # Since we've updated the _get_cached_* functions to be async, + # we need to run them in an event loop here if called synchronously + + # However, since this is running in a thread (via to_thread), we can create a new event loop + loop = asyncio.new_event_loop() + asyncio.set_event_loop(loop) + try: + loop.run_until_complete( + asyncio.gather( + _get_cached_da_spp(), _get_cached_rt_lmp(), _get_cached_rt_spp() + ) + ) + finally: + loop.close() + + +# Keep old function name for backwards compatibility +def prefetch_da_lmp() -> None: + """Prefetch Day-Ahead SPP data for today (legacy function). + + Use prefetch_all_data() instead for complete cache warming. + """ + prefetch_all_data() + + +class PriceRecord(BaseModel): + """Single price record.""" + + timestamp: str + settlement_point: str | None = None + price: float + market: str | None = None + + +class SPPResponse(BaseModel): + """Response model for SPP data.""" + + data: list[dict[str, Any]] + count: int + market: str + start_date: str + end_date: str | None = None + + +class LMPResponse(BaseModel): + """Response model for LMP data.""" + + data: list[dict[str, Any]] + count: int + market: str + location_type: str + + +class DailyPricesResponse(BaseModel): + """Response model for daily prices.""" + + data: list[dict[str, Any]] + count: int + + +@router.get("/spp", response_model=SPPResponse) +async def get_spp( + start: str = Query( + default="today", + description="Start date (YYYY-MM-DD, 'today', or 'yesterday')", + ), + end: str | None = Query(default=None, description="End date (YYYY-MM-DD)"), + market: Literal["real_time_15_min", "day_ahead_hourly"] = Query( + default="real_time_15_min", + description="Market type", + ), + location_type: Literal["load_zone", "trading_hub", "resource_node", "all"] + | None = Query( + default=None, + description="Filter by location type", + ), + locations: str | None = Query( + default=None, + description="Comma-separated list of settlement points to filter", + ), +) -> dict[str, Any]: + """Get Settlement Point Prices. + + Returns SPP data for the specified date range and market type. + Can filter by location type or specific settlement points. + """ + try: + # Map market string to enum + market_enum = ( + Market.REAL_TIME_15_MIN + if market == "real_time_15_min" + else Market.DAY_AHEAD_HOURLY + ) + + # Map location type string to enum + loc_type = None + if location_type and location_type != "all": + loc_map = { + "load_zone": LocationType.LOAD_ZONE, + "trading_hub": LocationType.TRADING_HUB, + "resource_node": LocationType.RESOURCE_NODE, + } + loc_type = loc_map.get(location_type) + + # Parse locations list + loc_list = None + if locations: + loc_list = [loc.strip() for loc in locations.split(",")] + + # Use new async SDK method + ercot = get_ercot() + df = await ercot.get_spp_async( + start=start, + end=end, + market=market_enum, + locations=loc_list, + location_type=loc_type, + ) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + "market": market, + "start_date": start, + "end_date": end, + } + except Exception as e: + raise HTTPException(status_code=500, detail=f"Failed to fetch SPP data: {e}") + + +@router.get("/lmp", response_model=LMPResponse) +async def get_lmp( + start: str = Query( + default="today", + description="Start date (YYYY-MM-DD, 'today', or 'yesterday')", + ), + end: str | None = Query(default=None, description="End date (YYYY-MM-DD)"), + market: Literal["real_time_sced", "day_ahead_hourly"] = Query( + default="real_time_sced", + description="Market type", + ), + location_type: Literal["resource_node", "electrical_bus"] = Query( + default="resource_node", + description="Location type for LMP data", + ), +) -> dict[str, Any]: + """Get Locational Marginal Prices. + + Returns LMP data for the specified date range, market, and location type. + """ + try: + # Map market string to enum + market_enum = ( + Market.REAL_TIME_SCED + if market == "real_time_sced" + else Market.DAY_AHEAD_HOURLY + ) + + # Map location type string to enum + loc_type = ( + LocationType.RESOURCE_NODE + if location_type == "resource_node" + else LocationType.ELECTRICAL_BUS + ) + + # Use new async SDK method + ercot = get_ercot() + df = await ercot.get_lmp_async( + start=start, + end=end, + market=market_enum, + location_type=loc_type, + ) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + "market": market, + "location_type": location_type, + } + except Exception as e: + raise HTTPException(status_code=500, detail=f"Failed to fetch LMP data: {e}") + + +class LMPCombinedResponse(BaseModel): + """Response model for combined DA+RT LMP data.""" + + data: list[dict[str, Any]] + locations: list[str] + latest_rt_time: str | None = None + count: int + + +@router.get("/lmp-combined", response_model=LMPCombinedResponse) +async def get_lmp_combined( + location_type: Literal["load_zone", "trading_hub", "dc_tie"] = Query( + default="load_zone", + description="Location type: load_zone, trading_hub, or dc_tie", + ), + location: str | None = Query( + default=None, + description="Specific location to filter (e.g., LZ_WEST, HB_NORTH, DC_E)", + ), +) -> dict[str, Any]: + """Get combined Day-Ahead and Real-Time price data for today. + + Returns both DA (SPP) and RT (LMP) prices on the same timeline for comparison. + - Real-Time: Uses cached LMP data with incremental updates + - Day-Ahead: Uses cached SPP data (published once daily) + + Both caches are warmed on startup and updated incrementally. + """ + try: + # Determine which locations to filter by + if location_type == "load_zone": + type_locations = set(LOAD_ZONES) + elif location_type == "trading_hub": + type_locations = set(TRADING_HUBS) + elif location_type == "dc_tie": + type_locations = set(DC_TIES) + else: + type_locations = set(LOAD_ZONES) + + # Get cached RT LMP data (incremental) - direct await since it's now async + rt_df = await _get_cached_rt_lmp() + + # Filter RT data by location type + if not rt_df.empty: + loc_col = _find_loc_column(rt_df) + if loc_col: + rt_df = rt_df[rt_df[loc_col].isin(type_locations)] + + # Get cached Day-Ahead SPP data - direct await since it's now async + da_df, _all_da_locations = await _get_cached_da_spp() + + # Filter DA data by location type + if da_df is not None and not da_df.empty: + loc_col = _find_loc_column(da_df) + if loc_col: + da_df = da_df[da_df[loc_col].isin(type_locations)] + + # Get unique locations for this type + locations_in_type = set() + if not rt_df.empty: + loc_col = _find_loc_column(rt_df) + if loc_col: + locations_in_type.update(rt_df[loc_col].unique()) + if da_df is not None and not da_df.empty: + loc_col = _find_loc_column(da_df) + if loc_col: + locations_in_type.update(da_df[loc_col].unique()) + + locations_list = sorted(locations_in_type) + + # Filter by specific location if provided + if location: + if not rt_df.empty: + loc_col = _find_loc_column(rt_df) + if loc_col: + rt_df = rt_df[rt_df[loc_col] == location] + if da_df is not None and not da_df.empty: + loc_col = _find_loc_column(da_df) + if loc_col: + da_df = da_df[da_df[loc_col] == location] + + # Build combined data structure + combined_data = [] + + # Process RT data (LMP uses "Time" or "SCED Time Stamp") + latest_rt_time = None + if not rt_df.empty: + loc_col = _find_loc_column(rt_df) + time_col = _find_time_column( + rt_df, ["Time", "SCED Time Stamp", "Timestamp"] + ) + + for _, row in rt_df.iterrows(): + time_val = row.get(time_col, "") if time_col else "" + time_str = str(time_val) if time_val is not None else "" + + if time_str and time_str > (latest_rt_time or ""): + latest_rt_time = time_str + + combined_data.append( + { + "time": time_str, + "location": str(row.get(loc_col, "")) if loc_col else "", + "rt_price": float(row.get("Price", row.get("LMP", 0))), + "da_price": None, + "market": "RT", + } + ) + + # Process DA data (SPP uses "Time" or "Hour Ending") + if da_df is not None and not da_df.empty: + loc_col = _find_loc_column(da_df) + time_col = _find_time_column(da_df, ["Time", "Hour Ending", "Timestamp"]) + + for _, row in da_df.iterrows(): + time_val = row.get(time_col, "") if time_col else "" + time_str = str(time_val) if time_val is not None else "" + + combined_data.append( + { + "time": time_str, + "location": str(row.get(loc_col, "")) if loc_col else "", + "rt_price": None, + "da_price": float( + row.get("Price", row.get("SettlementPointPrice", 0)) + ), + "market": "DA", + } + ) + + # Format latest RT time for display + formatted_latest = None + if latest_rt_time: + try: + # Handle various timestamp formats + if "T" in latest_rt_time: + dt = datetime.fromisoformat(latest_rt_time.replace("Z", "+00:00")) + else: + dt = datetime.fromisoformat(latest_rt_time) + formatted_latest = dt.strftime("%H:%M CT") + except Exception: + formatted_latest = latest_rt_time + + return { + "data": combined_data, + "locations": locations_list, + "latest_rt_time": formatted_latest, + "count": len(combined_data), + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch combined price data: {e}" + ) + + +@router.get("/daily-prices", response_model=DailyPricesResponse) +async def get_daily_prices() -> dict[str, Any]: + """Get daily price summary from ERCOT dashboard. + + Returns the daily price summary including peak and average prices. + This endpoint uses dashboard data and does not require authentication. + """ + try: + # Currently daily prices isn't asyncified in api.py, so we use to_thread + # but if get_daily_prices was available async we'd use it. + # However, checking api.py, get_daily_prices is not in the mixin yet. + # It's likely in ercot/dashboard.py. Let's assume sync for now. + + # Actually, let's just keep using to_thread for this one as it's not in our list of async methods + def _fetch_daily_prices_sync() -> pd.DataFrame: + ercot = get_ercot() + return ercot.get_daily_prices() + + df = await asyncio.to_thread(_fetch_daily_prices_sync) + + # Convert DataFrame to list of dicts + data = df.to_dict(orient="records") if not df.empty else [] + + return { + "data": data, + "count": len(data), + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch daily prices: {e}" + ) + + +# ============================================================================ +# Grid Endpoints - Optimized for mini-chart grid display +# ============================================================================ + + +class LocationPriceData(BaseModel): + """Price data for a single location.""" + + location: str + location_type: str # "load_zone", "trading_hub", or "dc_tie" + data: list[dict[str, Any]] # Time series data + latest_price: float | None = None + latest_time: str | None = None + avg_price: float | None = None + min_price: float | None = None + max_price: float | None = None + + +class PriceGridResponse(BaseModel): + """Response model for grid endpoints.""" + + locations: list[LocationPriceData] + latest_update: str | None = None + count: int + start_date: str + end_date: str | None = None + + +def _get_location_type(loc: str) -> str: + """Determine the location type for a given location name.""" + if loc in LOAD_ZONES: + return "load_zone" + elif loc in TRADING_HUBS: + return "trading_hub" + elif loc in DC_TIES: + return "dc_tie" + return "unknown" + + +def _calculate_stats(prices: list[float]) -> dict[str, float | None]: + """Calculate statistics for a list of prices.""" + if not prices: + return {"avg": None, "min": None, "max": None} + return { + "avg": sum(prices) / len(prices), + "min": min(prices), + "max": max(prices), + } + + +def _parse_date_range(start: str, end: str | None) -> tuple[str, str]: + """Parse and validate date range (max 7 days).""" + ct = _get_ct_timezone() + today = datetime.now(ct).date() + + # Parse start date + if start == "today": + start_date = today + elif start == "yesterday": + start_date = today - pd.Timedelta(days=1) + else: + try: + start_date = pd.to_datetime(start).date() + except Exception: + start_date = today + + # Parse end date + if end is None or end == "today": + end_date = today + else: + try: + end_date = pd.to_datetime(end).date() + except Exception: + end_date = today + + # Ensure max 7 days range + max_range = pd.Timedelta(days=7) + if (end_date - start_date) > max_range: + start_date = end_date - max_range + + return str(start_date), str(end_date) + + +async def _fetch_lmp_grid_data(start_date: str, end_date: str) -> pd.DataFrame: + """Async helper to fetch LMP grid data.""" + is_today_only = start_date == end_date == _get_today_date() + + if is_today_only: + return await _get_cached_rt_lmp() + + ercot = get_ercot() + df = await ercot.get_lmp_async( + start=start_date, + end=end_date, + market=Market.REAL_TIME_SCED, + ) + # Filter to supported locations + loc_col = _find_loc_column(df) + if loc_col and not df.empty: + df = df[df[loc_col].isin(ALL_LOCATIONS)] + return df + + +@router.get("/lmp-grid", response_model=PriceGridResponse) +async def get_lmp_grid( + start: str = Query( + default="today", + description="Start date (YYYY-MM-DD, 'today', or 'yesterday')", + ), + end: str | None = Query( + default=None, + description="End date (YYYY-MM-DD, defaults to today)", + ), +) -> dict[str, Any]: + """Get LMP data for all locations, optimized for grid display. + + Returns LMP data grouped by location with summary statistics. + Supports date ranges up to 7 days. + Uses cached data when available for better performance. + """ + try: + start_date, end_date = _parse_date_range(start, end) + + # Run async data fetch directly + df = await _fetch_lmp_grid_data(start_date, end_date) + + if df.empty: + return { + "locations": [], + "latest_update": None, + "count": 0, + "start_date": start_date, + "end_date": end_date, + } + + loc_col = _find_loc_column(df) + time_col = _find_time_column(df, ["Time", "SCED Time Stamp", "Timestamp"]) + price_col = "Price" if "Price" in df.columns else "LMP" + + # Group by location + locations_data = [] + latest_update = None + + for loc in sorted(df[loc_col].unique()): + loc_df = df[df[loc_col] == loc].copy() + + # Sort by time + if time_col: + loc_df = loc_df.sort_values(time_col) + + # Build time series data + time_series = [] + prices = [] + latest_time = None + latest_price = None + + for _, row in loc_df.iterrows(): + time_val = str(row.get(time_col, "")) if time_col else "" + price_val = float(row.get(price_col, 0)) + + time_series.append( + { + "time": time_val, + "price": price_val, + } + ) + prices.append(price_val) + + if time_val and (latest_time is None or time_val > latest_time): + latest_time = time_val + latest_price = price_val + + if latest_time and (latest_update is None or latest_time > latest_update): + latest_update = latest_time + + stats = _calculate_stats(prices) + + locations_data.append( + { + "location": loc, + "location_type": _get_location_type(loc), + "data": time_series, + "latest_price": latest_price, + "latest_time": latest_time, + "avg_price": stats["avg"], + "min_price": stats["min"], + "max_price": stats["max"], + } + ) + + return { + "locations": locations_data, + "latest_update": latest_update, + "count": len(df), + "start_date": start_date, + "end_date": end_date, + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch LMP grid data: {e}" + ) + + +async def _fetch_spp_grid_data( + start_date: str, end_date: str, market: str +) -> pd.DataFrame: + """Async helper to fetch SPP grid data.""" + is_today_only = start_date == end_date == _get_today_date() + + if is_today_only: + if market == "day_ahead_hourly": + df, _ = await _get_cached_da_spp() + return df if df is not None else pd.DataFrame() + else: + return await _get_cached_rt_spp() + + ercot = get_ercot() + market_enum = ( + Market.REAL_TIME_15_MIN + if market == "real_time_15_min" + else Market.DAY_AHEAD_HOURLY + ) + df = await ercot.get_spp_async( + start=start_date, + end=end_date, + market=market_enum, + ) + # Filter to supported locations + loc_col = _find_loc_column(df) + if loc_col and not df.empty: + df = df[df[loc_col].isin(ALL_LOCATIONS)] + return df + + +@router.get("/spp-grid", response_model=PriceGridResponse) +async def get_spp_grid( + start: str = Query( + default="today", + description="Start date (YYYY-MM-DD, 'today', or 'yesterday')", + ), + end: str | None = Query( + default=None, + description="End date (YYYY-MM-DD, defaults to today)", + ), + market: Literal["real_time_15_min", "day_ahead_hourly"] = Query( + default="real_time_15_min", + description="Market type", + ), +) -> dict[str, Any]: + """Get SPP data for all locations, optimized for grid display. + + Returns SPP data grouped by location with summary statistics. + Supports date ranges up to 7 days. + Uses cached data when available for better performance. + """ + try: + start_date, end_date = _parse_date_range(start, end) + + # Run async data fetch directly + df = await _fetch_spp_grid_data(start_date, end_date, market) + + if df.empty: + return { + "locations": [], + "latest_update": None, + "count": 0, + "start_date": start_date, + "end_date": end_date, + } + + loc_col = _find_loc_column(df) + time_col = _find_time_column(df, ["Time", "Hour Ending", "Timestamp"]) + price_col = "Price" if "Price" in df.columns else "SettlementPointPrice" + + # Group by location + locations_data = [] + latest_update = None + + for loc in sorted(df[loc_col].unique()): + loc_df = df[df[loc_col] == loc].copy() + + # Sort by time + if time_col: + loc_df = loc_df.sort_values(time_col) + + # Build time series data + time_series = [] + prices = [] + latest_time = None + latest_price = None + + for _, row in loc_df.iterrows(): + time_val = str(row.get(time_col, "")) if time_col else "" + price_val = float(row.get(price_col, 0)) + + time_series.append( + { + "time": time_val, + "price": price_val, + } + ) + prices.append(price_val) + + if time_val and (latest_time is None or time_val > latest_time): + latest_time = time_val + latest_price = price_val + + if latest_time and (latest_update is None or latest_time > latest_update): + latest_update = latest_time + + stats = _calculate_stats(prices) + + locations_data.append( + { + "location": loc, + "location_type": _get_location_type(loc), + "data": time_series, + "latest_price": latest_price, + "latest_time": latest_time, + "avg_price": stats["avg"], + "min_price": stats["min"], + "max_price": stats["max"], + } + ) + + return { + "locations": locations_data, + "latest_update": latest_update, + "count": len(df), + "start_date": start_date, + "end_date": end_date, + } + except Exception as e: + raise HTTPException( + status_code=500, detail=f"Failed to fetch SPP grid data: {e}" + ) diff --git a/examples/demo/docker-compose.yml b/examples/demo/docker-compose.yml new file mode 100644 index 0000000..9b709ea --- /dev/null +++ b/examples/demo/docker-compose.yml @@ -0,0 +1,36 @@ +services: + backend: + build: + context: ../.. + dockerfile: examples/demo/backend/Dockerfile + container_name: tinygrid-backend + ports: + - "8000:8000" + environment: + - ERCOT_USERNAME=${ERCOT_USERNAME} + - ERCOT_PASSWORD=${ERCOT_PASSWORD} + - ERCOT_SUBSCRIPTION_KEY=${ERCOT_SUBSCRIPTION_KEY} + env_file: + - .env + restart: unless-stopped + healthcheck: + test: ["CMD", "curl", "-f", "http://localhost:8000/health"] + interval: 30s + timeout: 10s + retries: 3 + start_period: 10s + + frontend: + build: + context: ./frontend + dockerfile: Dockerfile + container_name: tinygrid-frontend + ports: + - "3000:80" + depends_on: + - backend + restart: unless-stopped + +networks: + default: + name: tinygrid-network diff --git a/examples/demo/frontend/.dockerignore b/examples/demo/frontend/.dockerignore new file mode 100644 index 0000000..c11364e --- /dev/null +++ b/examples/demo/frontend/.dockerignore @@ -0,0 +1,7 @@ +node_modules +dist +.git +.gitignore +*.md +.env* +.DS_Store diff --git a/examples/demo/frontend/.gitignore b/examples/demo/frontend/.gitignore new file mode 100644 index 0000000..a547bf3 --- /dev/null +++ b/examples/demo/frontend/.gitignore @@ -0,0 +1,24 @@ +# Logs +logs +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* +lerna-debug.log* + +node_modules +dist +dist-ssr +*.local + +# Editor directories and files +.vscode/* +!.vscode/extensions.json +.idea +.DS_Store +*.suo +*.ntvs* +*.njsproj +*.sln +*.sw? diff --git a/examples/demo/frontend/Dockerfile b/examples/demo/frontend/Dockerfile new file mode 100644 index 0000000..e34b002 --- /dev/null +++ b/examples/demo/frontend/Dockerfile @@ -0,0 +1,30 @@ +# Build stage +FROM node:20-alpine AS builder + +WORKDIR /app + +# Copy package files +COPY package*.json ./ + +# Install dependencies +RUN npm ci + +# Copy source code +COPY . . + +# Build the app +RUN npm run build + +# Production stage - serve with nginx +FROM nginx:alpine + +# Copy custom nginx config +COPY nginx.conf /etc/nginx/conf.d/default.conf + +# Copy built assets from builder stage +COPY --from=builder /app/dist /usr/share/nginx/html + +# Expose port +EXPOSE 80 + +CMD ["nginx", "-g", "daemon off;"] diff --git a/examples/demo/frontend/README.md b/examples/demo/frontend/README.md new file mode 100644 index 0000000..d2e7761 --- /dev/null +++ b/examples/demo/frontend/README.md @@ -0,0 +1,73 @@ +# React + TypeScript + Vite + +This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules. + +Currently, two official plugins are available: + +- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh +- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh + +## React Compiler + +The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation). + +## Expanding the ESLint configuration + +If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules: + +```js +export default defineConfig([ + globalIgnores(['dist']), + { + files: ['**/*.{ts,tsx}'], + extends: [ + // Other configs... + + // Remove tseslint.configs.recommended and replace with this + tseslint.configs.recommendedTypeChecked, + // Alternatively, use this for stricter rules + tseslint.configs.strictTypeChecked, + // Optionally, add this for stylistic rules + tseslint.configs.stylisticTypeChecked, + + // Other configs... + ], + languageOptions: { + parserOptions: { + project: ['./tsconfig.node.json', './tsconfig.app.json'], + tsconfigRootDir: import.meta.dirname, + }, + // other options... + }, + }, +]) +``` + +You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules: + +```js +// eslint.config.js +import reactX from 'eslint-plugin-react-x' +import reactDom from 'eslint-plugin-react-dom' + +export default defineConfig([ + globalIgnores(['dist']), + { + files: ['**/*.{ts,tsx}'], + extends: [ + // Other configs... + // Enable lint rules for React + reactX.configs['recommended-typescript'], + // Enable lint rules for React DOM + reactDom.configs.recommended, + ], + languageOptions: { + parserOptions: { + project: ['./tsconfig.node.json', './tsconfig.app.json'], + tsconfigRootDir: import.meta.dirname, + }, + // other options... + }, + }, +]) +``` diff --git a/examples/demo/frontend/eslint.config.js b/examples/demo/frontend/eslint.config.js new file mode 100644 index 0000000..5e6b472 --- /dev/null +++ b/examples/demo/frontend/eslint.config.js @@ -0,0 +1,23 @@ +import js from '@eslint/js' +import globals from 'globals' +import reactHooks from 'eslint-plugin-react-hooks' +import reactRefresh from 'eslint-plugin-react-refresh' +import tseslint from 'typescript-eslint' +import { defineConfig, globalIgnores } from 'eslint/config' + +export default defineConfig([ + globalIgnores(['dist']), + { + files: ['**/*.{ts,tsx}'], + extends: [ + js.configs.recommended, + tseslint.configs.recommended, + reactHooks.configs.flat.recommended, + reactRefresh.configs.vite, + ], + languageOptions: { + ecmaVersion: 2020, + globals: globals.browser, + }, + }, +]) diff --git a/examples/demo/frontend/index.html b/examples/demo/frontend/index.html new file mode 100644 index 0000000..072a57e --- /dev/null +++ b/examples/demo/frontend/index.html @@ -0,0 +1,13 @@ + + + + + + + frontend + + +
+ + + diff --git a/examples/demo/frontend/nginx.conf b/examples/demo/frontend/nginx.conf new file mode 100644 index 0000000..a38dcb8 --- /dev/null +++ b/examples/demo/frontend/nginx.conf @@ -0,0 +1,36 @@ +server { + listen 80; + server_name localhost; + root /usr/share/nginx/html; + index index.html; + + # Gzip compression + gzip on; + gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript; + + # Handle React Router - serve index.html for all routes + location / { + try_files $uri $uri/ /index.html; + } + + # Proxy API requests to backend + location /api/ { + proxy_pass http://backend:8000/api/; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection 'upgrade'; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_cache_bypass $http_upgrade; + proxy_read_timeout 300s; + proxy_connect_timeout 75s; + } + + # Cache static assets + location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ { + expires 1y; + add_header Cache-Control "public, immutable"; + } +} diff --git a/examples/demo/frontend/package-lock.json b/examples/demo/frontend/package-lock.json new file mode 100644 index 0000000..33bdad8 --- /dev/null +++ b/examples/demo/frontend/package-lock.json @@ -0,0 +1,4371 @@ +{ + "name": "frontend", + "version": "0.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "frontend", + "version": "0.0.0", + "dependencies": { + "@tanstack/react-query": "^5.90.14", + "class-variance-authority": "^0.7.1", + "clsx": "^2.1.1", + "daisyui": "^5.5.14", + "lucide-react": "^0.562.0", + "react": "^19.2.0", + "react-dom": "^19.2.0", + "react-router-dom": "^7.11.0", + "recharts": "^3.6.0", + "tailwind-merge": "^3.4.0" + }, + "devDependencies": { + "@eslint/js": "^9.39.1", + "@tailwindcss/vite": "^4.1.18", + "@types/node": "^24.10.1", + "@types/react": "^19.2.5", + "@types/react-dom": "^19.2.3", + "@vitejs/plugin-react": "^5.1.1", + "eslint": "^9.39.1", + "eslint-plugin-react-hooks": "^7.0.1", + "eslint-plugin-react-refresh": "^0.4.24", + "globals": "^16.5.0", + "tailwindcss": "^4.1.18", + "typescript": "~5.9.3", + "typescript-eslint": "^8.46.4", + "vite": "^7.2.4" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", + "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.27.1", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.5.tgz", + "integrity": "sha512-6uFXyCayocRbqhZOB+6XcuZbkMNimwfVGFji8CTZnCzOHVGvDqzvitu1re2AU5LROliz7eQPhB8CpAMvnx9EjA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.5.tgz", + "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.5", + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-module-transforms": "^7.28.3", + "@babel/helpers": "^7.28.4", + "@babel/parser": "^7.28.5", + "@babel/template": "^7.27.2", + "@babel/traverse": "^7.28.5", + "@babel/types": "^7.28.5", + "@jridgewell/remapping": "^2.3.5", + "convert-source-map": "^2.0.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.3", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/generator": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.5.tgz", + "integrity": "sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.28.5", + "@babel/types": "^7.28.5", + "@jridgewell/gen-mapping": "^0.3.12", + "@jridgewell/trace-mapping": "^0.3.28", + "jsesc": "^3.0.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz", + "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.27.2", + "@babel/helper-validator-option": "^7.27.1", + "browserslist": "^4.24.0", + "lru-cache": "^5.1.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-globals": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz", + "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz", + "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.27.1", + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz", + "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.27.1", + "@babel/helper-validator-identifier": "^7.27.1", + "@babel/traverse": "^7.28.3" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-plugin-utils": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz", + "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz", + "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz", + "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.4" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.5.tgz", + "integrity": "sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.5" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-self": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.27.1.tgz", + "integrity": "sha512-6UzkCs+ejGdZ5mFFC/OCUrv028ab2fp1znZmCZjAOBKiBK2jXD1O+BPSfX8X2qjJ75fZBMSnQn3Rq2mrBJK2mw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-source": { + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.27.1.tgz", + "integrity": "sha512-zbwoTsBruTeKB9hSq73ha66iFeJHuaFkUbwvqElnygoNbj/jHRsSeokowZFN3CZ64IvEqcmmkVe89OPXc7ldAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/template": { + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz", + "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/parser": "^7.27.2", + "@babel/types": "^7.27.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.5.tgz", + "integrity": "sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.5", + "@babel/helper-globals": "^7.28.0", + "@babel/parser": "^7.28.5", + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.5", + "debug": "^4.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.5.tgz", + "integrity": "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.2.tgz", + "integrity": "sha512-GZMB+a0mOMZs4MpDbj8RJp4cw+w1WV5NYD6xzgvzUJ5Ek2jerwfO2eADyI6ExDSUED+1X8aMbegahsJi+8mgpw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.2.tgz", + "integrity": "sha512-DVNI8jlPa7Ujbr1yjU2PfUSRtAUZPG9I1RwW4F4xFB1Imiu2on0ADiI/c3td+KmDtVKNbi+nffGDQMfcIMkwIA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.2.tgz", + "integrity": "sha512-pvz8ZZ7ot/RBphf8fv60ljmaoydPU12VuXHImtAs0XhLLw+EXBi2BLe3OYSBslR4rryHvweW5gmkKFwTiFy6KA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.2.tgz", + "integrity": "sha512-z8Ank4Byh4TJJOh4wpz8g2vDy75zFL0TlZlkUkEwYXuPSgX8yzep596n6mT7905kA9uHZsf/o2OJZubl2l3M7A==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.2.tgz", + "integrity": "sha512-davCD2Zc80nzDVRwXTcQP/28fiJbcOwvdolL0sOiOsbwBa72kegmVU0Wrh1MYrbuCL98Omp5dVhQFWRKR2ZAlg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.2.tgz", + "integrity": "sha512-ZxtijOmlQCBWGwbVmwOF/UCzuGIbUkqB1faQRf5akQmxRJ1ujusWsb3CVfk/9iZKr2L5SMU5wPBi1UWbvL+VQA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.2.tgz", + "integrity": "sha512-lS/9CN+rgqQ9czogxlMcBMGd+l8Q3Nj1MFQwBZJyoEKI50XGxwuzznYdwcav6lpOGv5BqaZXqvBSiB/kJ5op+g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.2.tgz", + "integrity": "sha512-tAfqtNYb4YgPnJlEFu4c212HYjQWSO/w/h/lQaBK7RbwGIkBOuNKQI9tqWzx7Wtp7bTPaGC6MJvWI608P3wXYA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.2.tgz", + "integrity": "sha512-vWfq4GaIMP9AIe4yj1ZUW18RDhx6EPQKjwe7n8BbIecFtCQG4CfHGaHuh7fdfq+y3LIA2vGS/o9ZBGVxIDi9hw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.2.tgz", + "integrity": "sha512-hYxN8pr66NsCCiRFkHUAsxylNOcAQaxSSkHMMjcpx0si13t1LHFphxJZUiGwojB1a/Hd5OiPIqDdXONia6bhTw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.2.tgz", + "integrity": "sha512-MJt5BRRSScPDwG2hLelYhAAKh9imjHK5+NE/tvnRLbIqUWa+0E9N4WNMjmp/kXXPHZGqPLxggwVhz7QP8CTR8w==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.2.tgz", + "integrity": "sha512-lugyF1atnAT463aO6KPshVCJK5NgRnU4yb3FUumyVz+cGvZbontBgzeGFO1nF+dPueHD367a2ZXe1NtUkAjOtg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.2.tgz", + "integrity": "sha512-nlP2I6ArEBewvJ2gjrrkESEZkB5mIoaTswuqNFRv/WYd+ATtUpe9Y09RnJvgvdag7he0OWgEZWhviS1OTOKixw==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.2.tgz", + "integrity": "sha512-C92gnpey7tUQONqg1n6dKVbx3vphKtTHJaNG2Ok9lGwbZil6DrfyecMsp9CrmXGQJmZ7iiVXvvZH6Ml5hL6XdQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.2.tgz", + "integrity": "sha512-B5BOmojNtUyN8AXlK0QJyvjEZkWwy/FKvakkTDCziX95AowLZKR6aCDhG7LeF7uMCXEJqwa8Bejz5LTPYm8AvA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.2.tgz", + "integrity": "sha512-p4bm9+wsPwup5Z8f4EpfN63qNagQ47Ua2znaqGH6bqLlmJ4bx97Y9JdqxgGZ6Y8xVTixUnEkoKSHcpRlDnNr5w==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.2.tgz", + "integrity": "sha512-uwp2Tip5aPmH+NRUwTcfLb+W32WXjpFejTIOWZFw/v7/KnpCDKG66u4DLcurQpiYTiYwQ9B7KOeMJvLCu/OvbA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.2.tgz", + "integrity": "sha512-Kj6DiBlwXrPsCRDeRvGAUb/LNrBASrfqAIok+xB0LxK8CHqxZ037viF13ugfsIpePH93mX7xfJp97cyDuTZ3cw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.2.tgz", + "integrity": "sha512-HwGDZ0VLVBY3Y+Nw0JexZy9o/nUAWq9MlV7cahpaXKW6TOzfVno3y3/M8Ga8u8Yr7GldLOov27xiCnqRZf0tCA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.2.tgz", + "integrity": "sha512-DNIHH2BPQ5551A7oSHD0CKbwIA/Ox7+78/AWkbS5QoRzaqlev2uFayfSxq68EkonB+IKjiuxBFoV8ESJy8bOHA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.2.tgz", + "integrity": "sha512-/it7w9Nb7+0KFIzjalNJVR5bOzA9Vay+yIPLVHfIQYG/j+j9VTH84aNB8ExGKPU4AzfaEvN9/V4HV+F+vo8OEg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.2.tgz", + "integrity": "sha512-LRBbCmiU51IXfeXk59csuX/aSaToeG7w48nMwA6049Y4J4+VbWALAuXcs+qcD04rHDuSCSRKdmY63sruDS5qag==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.2.tgz", + "integrity": "sha512-kMtx1yqJHTmqaqHPAzKCAkDaKsffmXkPHThSfRwZGyuqyIeBvf08KSsYXl+abf5HDAPMJIPnbBfXvP2ZC2TfHg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.2.tgz", + "integrity": "sha512-Yaf78O/B3Kkh+nKABUF++bvJv5Ijoy9AN1ww904rOXZFLWVc5OLOfL56W+C8F9xn5JQZa3UX6m+IktJnIb1Jjg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.2.tgz", + "integrity": "sha512-Iuws0kxo4yusk7sw70Xa2E2imZU5HoixzxfGCdxwBdhiDgt9vX9VUCBhqcwY7/uh//78A1hMkkROMJq9l27oLQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.2.tgz", + "integrity": "sha512-sRdU18mcKf7F+YgheI/zGf5alZatMUTKj/jNS6l744f9u3WFu4v7twcUI9vu4mknF4Y9aDlblIie0IM+5xxaqQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", + "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/config-array": { + "version": "0.21.1", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz", + "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/object-schema": "^2.1.7", + "debug": "^4.3.1", + "minimatch": "^3.1.2" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/config-helpers": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz", + "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/core": { + "version": "0.17.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz", + "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@types/json-schema": "^7.0.15" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", + "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^10.0.1", + "globals": "^14.0.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.1", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/eslintrc/node_modules/globals": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", + "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@eslint/js": { + "version": "9.39.2", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.2.tgz", + "integrity": "sha512-q1mjIoW1VX4IvSocvM/vbTiveKC4k9eLrajNEuSsmjymSDEbpGddtpfOoN7YGAqBK3NG+uqo8ia4PDTt8buCYA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + } + }, + "node_modules/@eslint/object-schema": { + "version": "2.1.7", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", + "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/plugin-kit": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz", + "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0", + "levn": "^0.4.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@humanfs/core": { + "version": "0.19.1", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", + "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/node": { + "version": "0.16.7", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", + "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/core": "^0.19.1", + "@humanwhocodes/retry": "^0.4.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/retry": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", + "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@reduxjs/toolkit": { + "version": "2.11.2", + "resolved": "https://registry.npmjs.org/@reduxjs/toolkit/-/toolkit-2.11.2.tgz", + "integrity": "sha512-Kd6kAHTA6/nUpp8mySPqj3en3dm0tdMIgbttnQ1xFMVpufoj+ADi8pXLBsd4xzTRHQa7t/Jv8W5UnCuW4kuWMQ==", + "license": "MIT", + "dependencies": { + "@standard-schema/spec": "^1.0.0", + "@standard-schema/utils": "^0.3.0", + "immer": "^11.0.0", + "redux": "^5.0.1", + "redux-thunk": "^3.1.0", + "reselect": "^5.1.0" + }, + "peerDependencies": { + "react": "^16.9.0 || ^17.0.0 || ^18 || ^19", + "react-redux": "^7.2.1 || ^8.1.3 || ^9.0.0" + }, + "peerDependenciesMeta": { + "react": { + "optional": true + }, + "react-redux": { + "optional": true + } + } + }, + "node_modules/@reduxjs/toolkit/node_modules/immer": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/immer/-/immer-11.1.0.tgz", + "integrity": "sha512-dlzb07f5LDY+tzs+iLCSXV2yuhaYfezqyZQc+n6baLECWkOMEWxkECAOnXL0ba7lsA25fM9b2jtzpu/uxo1a7g==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/immer" + } + }, + "node_modules/@rolldown/pluginutils": { + "version": "1.0.0-beta.53", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.53.tgz", + "integrity": "sha512-vENRlFU4YbrwVqNDZ7fLvy+JR1CRkyr01jhSiDpE1u6py3OMzQfztQU2jxykW3ALNxO4kSlqIDeYyD0Y9RcQeQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.54.0.tgz", + "integrity": "sha512-OywsdRHrFvCdvsewAInDKCNyR3laPA2mc9bRYJ6LBp5IyvF3fvXbbNR0bSzHlZVFtn6E0xw2oZlyjg4rKCVcng==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.54.0.tgz", + "integrity": "sha512-Skx39Uv+u7H224Af+bDgNinitlmHyQX1K/atIA32JP3JQw6hVODX5tkbi2zof/E69M1qH2UoN3Xdxgs90mmNYw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.54.0.tgz", + "integrity": "sha512-k43D4qta/+6Fq+nCDhhv9yP2HdeKeP56QrUUTW7E6PhZP1US6NDqpJj4MY0jBHlJivVJD5P8NxrjuobZBJTCRw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.54.0.tgz", + "integrity": "sha512-cOo7biqwkpawslEfox5Vs8/qj83M/aZCSSNIWpVzfU2CYHa2G3P1UN5WF01RdTHSgCkri7XOlTdtk17BezlV3A==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.54.0.tgz", + "integrity": "sha512-miSvuFkmvFbgJ1BevMa4CPCFt5MPGw094knM64W9I0giUIMMmRYcGW/JWZDriaw/k1kOBtsWh1z6nIFV1vPNtA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.54.0.tgz", + "integrity": "sha512-KGXIs55+b/ZfZsq9aR026tmr/+7tq6VG6MsnrvF4H8VhwflTIuYh+LFUlIsRdQSgrgmtM3fVATzEAj4hBQlaqQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.54.0.tgz", + "integrity": "sha512-EHMUcDwhtdRGlXZsGSIuXSYwD5kOT9NVnx9sqzYiwAc91wfYOE1g1djOEDseZJKKqtHAHGwnGPQu3kytmfaXLQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.54.0.tgz", + "integrity": "sha512-+pBrqEjaakN2ySv5RVrj/qLytYhPKEUwk+e3SFU5jTLHIcAtqh2rLrd/OkbNuHJpsBgxsD8ccJt5ga/SeG0JmA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.54.0.tgz", + "integrity": "sha512-NSqc7rE9wuUaRBsBp5ckQ5CVz5aIRKCwsoa6WMF7G01sX3/qHUw/z4pv+D+ahL1EIKy6Enpcnz1RY8pf7bjwng==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.54.0.tgz", + "integrity": "sha512-gr5vDbg3Bakga5kbdpqx81m2n9IX8M6gIMlQQIXiLTNeQW6CucvuInJ91EuCJ/JYvc+rcLLsDFcfAD1K7fMofg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.54.0.tgz", + "integrity": "sha512-gsrtB1NA3ZYj2vq0Rzkylo9ylCtW/PhpLEivlgWe0bpgtX5+9j9EZa0wtZiCjgu6zmSeZWyI/e2YRX1URozpIw==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.54.0.tgz", + "integrity": "sha512-y3qNOfTBStmFNq+t4s7Tmc9hW2ENtPg8FeUD/VShI7rKxNW7O4fFeaYbMsd3tpFlIg1Q8IapFgy7Q9i2BqeBvA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.54.0.tgz", + "integrity": "sha512-89sepv7h2lIVPsFma8iwmccN7Yjjtgz0Rj/Ou6fEqg3HDhpCa+Et+YSufy27i6b0Wav69Qv4WBNl3Rs6pwhebQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.54.0.tgz", + "integrity": "sha512-ZcU77ieh0M2Q8Ur7D5X7KvK+UxbXeDHwiOt/CPSBTI1fBmeDMivW0dPkdqkT4rOgDjrDDBUed9x4EgraIKoR2A==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.54.0.tgz", + "integrity": "sha512-2AdWy5RdDF5+4YfG/YesGDDtbyJlC9LHmL6rZw6FurBJ5n4vFGupsOBGfwMRjBYH7qRQowT8D/U4LoSvVwOhSQ==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.54.0.tgz", + "integrity": "sha512-WGt5J8Ij/rvyqpFexxk3ffKqqbLf9AqrTBbWDk7ApGUzaIs6V+s2s84kAxklFwmMF/vBNGrVdYgbblCOFFezMQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.54.0.tgz", + "integrity": "sha512-JzQmb38ATzHjxlPHuTH6tE7ojnMKM2kYNzt44LO/jJi8BpceEC8QuXYA908n8r3CNuG/B3BV8VR3Hi1rYtmPiw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.54.0.tgz", + "integrity": "sha512-huT3fd0iC7jigGh7n3q/+lfPcXxBi+om/Rs3yiFxjvSxbSB6aohDFXbWvlspaqjeOh+hx7DDHS+5Es5qRkWkZg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.54.0.tgz", + "integrity": "sha512-c2V0W1bsKIKfbLMBu/WGBz6Yci8nJ/ZJdheE0EwB73N3MvHYKiKGs3mVilX4Gs70eGeDaMqEob25Tw2Gb9Nqyw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.54.0.tgz", + "integrity": "sha512-woEHgqQqDCkAzrDhvDipnSirm5vxUXtSKDYTVpZG3nUdW/VVB5VdCYA2iReSj/u3yCZzXID4kuKG7OynPnB3WQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.54.0.tgz", + "integrity": "sha512-dzAc53LOuFvHwbCEOS0rPbXp6SIhAf2txMP5p6mGyOXXw5mWY8NGGbPMPrs4P1WItkfApDathBj/NzMLUZ9rtQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.54.0.tgz", + "integrity": "sha512-hYT5d3YNdSh3mbCU1gwQyPgQd3T2ne0A3KG8KSBdav5TiBg6eInVmV+TeR5uHufiIgSFg0XsOWGW5/RhNcSvPg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@standard-schema/spec": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz", + "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==", + "license": "MIT" + }, + "node_modules/@standard-schema/utils": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/@standard-schema/utils/-/utils-0.3.0.tgz", + "integrity": "sha512-e7Mew686owMaPJVNNLs55PUvgz371nKgwsc4vxE49zsODpJEnxgxRo2y/OKrqueavXgZNMDVj3DdHFlaSAeU8g==", + "license": "MIT" + }, + "node_modules/@tailwindcss/node": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/node/-/node-4.1.18.tgz", + "integrity": "sha512-DoR7U1P7iYhw16qJ49fgXUlry1t4CpXeErJHnQ44JgTSKMaZUdf17cfn5mHchfJ4KRBZRFA/Coo+MUF5+gOaCQ==", + "dev": true, + "license": "MIT", + "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" + } + }, + "node_modules/@tailwindcss/oxide": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide/-/oxide-4.1.18.tgz", + "integrity": "sha512-EgCR5tTS5bUSKQgzeMClT6iCY3ToqE1y+ZB0AKldj809QXk1Y+3jB0upOYZrn9aGIzPtUsP7sX4QQ4XtjBB95A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 10" + }, + "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" + } + }, + "node_modules/@tailwindcss/oxide-android-arm64": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-android-arm64/-/oxide-android-arm64-4.1.18.tgz", + "integrity": "sha512-dJHz7+Ugr9U/diKJA0W6N/6/cjI+ZTAoxPf9Iz9BFRF2GzEX8IvXxFIi/dZBloVJX/MZGvRuFA9rqwdiIEZQ0Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-darwin-arm64": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-arm64/-/oxide-darwin-arm64-4.1.18.tgz", + "integrity": "sha512-Gc2q4Qhs660bhjyBSKgq6BYvwDz4G+BuyJ5H1xfhmDR3D8HnHCmT/BSkvSL0vQLy/nkMLY20PQ2OoYMO15Jd0A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-darwin-x64": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-x64/-/oxide-darwin-x64-4.1.18.tgz", + "integrity": "sha512-FL5oxr2xQsFrc3X9o1fjHKBYBMD1QZNyc1Xzw/h5Qu4XnEBi3dZn96HcHm41c/euGV+GRiXFfh2hUCyKi/e+yw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-freebsd-x64": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-freebsd-x64/-/oxide-freebsd-x64-4.1.18.tgz", + "integrity": "sha512-Fj+RHgu5bDodmV1dM9yAxlfJwkkWvLiRjbhuO2LEtwtlYlBgiAT4x/j5wQr1tC3SANAgD+0YcmWVrj8R9trVMA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm-gnueabihf": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm-gnueabihf/-/oxide-linux-arm-gnueabihf-4.1.18.tgz", + "integrity": "sha512-Fp+Wzk/Ws4dZn+LV2Nqx3IilnhH51YZoRaYHQsVq3RQvEl+71VGKFpkfHrLM/Li+kt5c0DJe/bHXK1eHgDmdiA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm64-gnu": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-gnu/-/oxide-linux-arm64-gnu-4.1.18.tgz", + "integrity": "sha512-S0n3jboLysNbh55Vrt7pk9wgpyTTPD0fdQeh7wQfMqLPM/Hrxi+dVsLsPrycQjGKEQk85Kgbx+6+QnYNiHalnw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-linux-arm64-musl": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-musl/-/oxide-linux-arm64-musl-4.1.18.tgz", + "integrity": "sha512-1px92582HkPQlaaCkdRcio71p8bc8i/ap5807tPRDK/uw953cauQBT8c5tVGkOwrHMfc2Yh6UuxaH4vtTjGvHg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-linux-x64-gnu": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-gnu/-/oxide-linux-x64-gnu-4.1.18.tgz", + "integrity": "sha512-v3gyT0ivkfBLoZGF9LyHmts0Isc8jHZyVcbzio6Wpzifg/+5ZJpDiRiUhDLkcr7f/r38SWNe7ucxmGW3j3Kb/g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-linux-x64-musl": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-musl/-/oxide-linux-x64-musl-4.1.18.tgz", + "integrity": "sha512-bhJ2y2OQNlcRwwgOAGMY0xTFStt4/wyU6pvI6LSuZpRgKQwxTec0/3Scu91O8ir7qCR3AuepQKLU/kX99FouqQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-wasm32-wasi": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-wasm32-wasi/-/oxide-wasm32-wasi-4.1.18.tgz", + "integrity": "sha512-LffYTvPjODiP6PT16oNeUQJzNVyJl1cjIebq/rWWBF+3eDst5JGEFSc5cWxyRCJ0Mxl+KyIkqRxk1XPEs9x8TA==", + "bundleDependencies": [ + "@napi-rs/wasm-runtime", + "@emnapi/core", + "@emnapi/runtime", + "@tybys/wasm-util", + "@emnapi/wasi-threads", + "tslib" + ], + "cpu": [ + "wasm32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/core": "^1.7.1", + "@emnapi/runtime": "^1.7.1", + "@emnapi/wasi-threads": "^1.1.0", + "@napi-rs/wasm-runtime": "^1.1.0", + "@tybys/wasm-util": "^0.10.1", + "tslib": "^2.4.0" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@tailwindcss/oxide-win32-arm64-msvc": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.1.18.tgz", + "integrity": "sha512-HjSA7mr9HmC8fu6bdsZvZ+dhjyGCLdotjVOgLA2vEqxEBZaQo9YTX4kwgEvPCpRh8o4uWc4J/wEoFzhEmjvPbA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/oxide-win32-x64-msvc": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-x64-msvc/-/oxide-win32-x64-msvc-4.1.18.tgz", + "integrity": "sha512-bJWbyYpUlqamC8dpR7pfjA0I7vdF6t5VpUGMWRkXVE3AXgIZjYUYAK7II1GNaxR8J1SSrSrppRar8G++JekE3Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 10" + } + }, + "node_modules/@tailwindcss/vite": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/@tailwindcss/vite/-/vite-4.1.18.tgz", + "integrity": "sha512-jVA+/UpKL1vRLg6Hkao5jldawNmRo7mQYrZtNHMIVpLfLhDml5nMRUo/8MwoX2vNXvnaXNNMedrMfMugAVX1nA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@tailwindcss/node": "4.1.18", + "@tailwindcss/oxide": "4.1.18", + "tailwindcss": "4.1.18" + }, + "peerDependencies": { + "vite": "^5.2.0 || ^6 || ^7" + } + }, + "node_modules/@tanstack/query-core": { + "version": "5.90.14", + "resolved": "https://registry.npmjs.org/@tanstack/query-core/-/query-core-5.90.14.tgz", + "integrity": "sha512-/6di2yNI+YxpVrH9Ig74Q+puKnkCE+D0LGyagJEGndJHJc6ahkcc/UqirHKy8zCYE/N9KLggxcQvzYCsUBWgdw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + } + }, + "node_modules/@tanstack/react-query": { + "version": "5.90.14", + "resolved": "https://registry.npmjs.org/@tanstack/react-query/-/react-query-5.90.14.tgz", + "integrity": "sha512-JAMuULej09hrZ14W9+mxoRZ44rR2BuZfCd6oKTQVNfynQxCN3muH3jh3W46gqZNw5ZqY0ZVaS43Imb3dMr6tgw==", + "license": "MIT", + "dependencies": { + "@tanstack/query-core": "5.90.14" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + }, + "peerDependencies": { + "react": "^18 || ^19" + } + }, + "node_modules/@types/babel__core": { + "version": "7.20.5", + "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", + "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.20.7", + "@babel/types": "^7.20.7", + "@types/babel__generator": "*", + "@types/babel__template": "*", + "@types/babel__traverse": "*" + } + }, + "node_modules/@types/babel__generator": { + "version": "7.27.0", + "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz", + "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__template": { + "version": "7.4.4", + "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz", + "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__traverse": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz", + "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.2" + } + }, + "node_modules/@types/d3-array": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/@types/d3-array/-/d3-array-3.2.2.tgz", + "integrity": "sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==", + "license": "MIT" + }, + "node_modules/@types/d3-color": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/@types/d3-color/-/d3-color-3.1.3.tgz", + "integrity": "sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==", + "license": "MIT" + }, + "node_modules/@types/d3-ease": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@types/d3-ease/-/d3-ease-3.0.2.tgz", + "integrity": "sha512-NcV1JjO5oDzoK26oMzbILE6HW7uVXOHLQvHshBUW4UMdZGfiY6v5BeQwh9a9tCzv+CeefZQHJt5SRgK154RtiA==", + "license": "MIT" + }, + "node_modules/@types/d3-interpolate": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/d3-interpolate/-/d3-interpolate-3.0.4.tgz", + "integrity": "sha512-mgLPETlrpVV1YRJIglr4Ez47g7Yxjl1lj7YKsiMCb27VJH9W8NVM6Bb9d8kkpG/uAQS5AmbA48q2IAolKKo1MA==", + "license": "MIT", + "dependencies": { + "@types/d3-color": "*" + } + }, + "node_modules/@types/d3-path": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/@types/d3-path/-/d3-path-3.1.1.tgz", + "integrity": "sha512-VMZBYyQvbGmWyWVea0EHs/BwLgxc+MKi1zLDCONksozI4YJMcTt8ZEuIR4Sb1MMTE8MMW49v0IwI5+b7RmfWlg==", + "license": "MIT" + }, + "node_modules/@types/d3-scale": { + "version": "4.0.9", + "resolved": "https://registry.npmjs.org/@types/d3-scale/-/d3-scale-4.0.9.tgz", + "integrity": "sha512-dLmtwB8zkAeO/juAMfnV+sItKjlsw2lKdZVVy6LRr0cBmegxSABiLEpGVmSJJ8O08i4+sGR6qQtb6WtuwJdvVw==", + "license": "MIT", + "dependencies": { + "@types/d3-time": "*" + } + }, + "node_modules/@types/d3-shape": { + "version": "3.1.7", + "resolved": "https://registry.npmjs.org/@types/d3-shape/-/d3-shape-3.1.7.tgz", + "integrity": "sha512-VLvUQ33C+3J+8p+Daf+nYSOsjB4GXp19/S/aGo60m9h1v6XaxjiT82lKVWJCfzhtuZ3yD7i/TPeC/fuKLLOSmg==", + "license": "MIT", + "dependencies": { + "@types/d3-path": "*" + } + }, + "node_modules/@types/d3-time": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/d3-time/-/d3-time-3.0.4.tgz", + "integrity": "sha512-yuzZug1nkAAaBlBBikKZTgzCeA+k1uy4ZFwWANOfKw5z5LRhV0gNA7gNkKm7HoK+HRN0wX3EkxGk0fpbWhmB7g==", + "license": "MIT" + }, + "node_modules/@types/d3-timer": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@types/d3-timer/-/d3-timer-3.0.2.tgz", + "integrity": "sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==", + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "24.10.4", + "resolved": "https://registry.npmjs.org/@types/node/-/node-24.10.4.tgz", + "integrity": "sha512-vnDVpYPMzs4wunl27jHrfmwojOGKya0xyM3sH+UE5iv5uPS6vX7UIoh6m+vQc5LGBq52HBKPIn/zcSZVzeDEZg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "undici-types": "~7.16.0" + } + }, + "node_modules/@types/react": { + "version": "19.2.7", + "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.7.tgz", + "integrity": "sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg==", + "devOptional": true, + "license": "MIT", + "peer": true, + "dependencies": { + "csstype": "^3.2.2" + } + }, + "node_modules/@types/react-dom": { + "version": "19.2.3", + "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-19.2.3.tgz", + "integrity": "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "@types/react": "^19.2.0" + } + }, + "node_modules/@types/use-sync-external-store": { + "version": "0.0.6", + "resolved": "https://registry.npmjs.org/@types/use-sync-external-store/-/use-sync-external-store-0.0.6.tgz", + "integrity": "sha512-zFDAD+tlpf2r4asuHEj0XH6pY6i0g5NeAHPn+15wk3BV6JA69eERFXC1gyGThDkVa1zCyKr5jox1+2LbV/AMLg==", + "license": "MIT" + }, + "node_modules/@typescript-eslint/eslint-plugin": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.50.1.tgz", + "integrity": "sha512-PKhLGDq3JAg0Jk/aK890knnqduuI/Qj+udH7wCf0217IGi4gt+acgCyPVe79qoT+qKUvHMDQkwJeKW9fwl8Cyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/regexpp": "^4.10.0", + "@typescript-eslint/scope-manager": "8.50.1", + "@typescript-eslint/type-utils": "8.50.1", + "@typescript-eslint/utils": "8.50.1", + "@typescript-eslint/visitor-keys": "8.50.1", + "ignore": "^7.0.0", + "natural-compare": "^1.4.0", + "ts-api-utils": "^2.1.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "@typescript-eslint/parser": "^8.50.1", + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/@typescript-eslint/eslint-plugin/node_modules/ignore": { + "version": "7.0.5", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz", + "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/@typescript-eslint/parser": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.50.1.tgz", + "integrity": "sha512-hM5faZwg7aVNa819m/5r7D0h0c9yC4DUlWAOvHAtISdFTc8xB86VmX5Xqabrama3wIPJ/q9RbGS1worb6JfnMg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@typescript-eslint/scope-manager": "8.50.1", + "@typescript-eslint/types": "8.50.1", + "@typescript-eslint/typescript-estree": "8.50.1", + "@typescript-eslint/visitor-keys": "8.50.1", + "debug": "^4.3.4" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/@typescript-eslint/project-service": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.50.1.tgz", + "integrity": "sha512-E1ur1MCVf+YiP89+o4Les/oBAVzmSbeRB0MQLfSlYtbWU17HPxZ6Bhs5iYmKZRALvEuBoXIZMOIRRc/P++Ortg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/tsconfig-utils": "^8.50.1", + "@typescript-eslint/types": "^8.50.1", + "debug": "^4.3.4" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/@typescript-eslint/scope-manager": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.50.1.tgz", + "integrity": "sha512-mfRx06Myt3T4vuoHaKi8ZWNTPdzKPNBhiblze5N50//TSHOAQQevl/aolqA/BcqqbJ88GUnLqjjcBc8EWdBcVw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.50.1", + "@typescript-eslint/visitor-keys": "8.50.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/tsconfig-utils": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.50.1.tgz", + "integrity": "sha512-ooHmotT/lCWLXi55G4mvaUF60aJa012QzvLK0Y+Mp4WdSt17QhMhWOaBWeGTFVkb2gDgBe19Cxy1elPXylslDw==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/@typescript-eslint/type-utils": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.50.1.tgz", + "integrity": "sha512-7J3bf022QZE42tYMO6SL+6lTPKFk/WphhRPe9Tw/el+cEwzLz1Jjz2PX3GtGQVxooLDKeMVmMt7fWpYRdG5Etg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.50.1", + "@typescript-eslint/typescript-estree": "8.50.1", + "@typescript-eslint/utils": "8.50.1", + "debug": "^4.3.4", + "ts-api-utils": "^2.1.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/@typescript-eslint/types": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.50.1.tgz", + "integrity": "sha512-v5lFIS2feTkNyMhd7AucE/9j/4V9v5iIbpVRncjk/K0sQ6Sb+Np9fgYS/63n6nwqahHQvbmujeBL7mp07Q9mlA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/typescript-estree": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.50.1.tgz", + "integrity": "sha512-woHPdW+0gj53aM+cxchymJCrh0cyS7BTIdcDxWUNsclr9VDkOSbqC13juHzxOmQ22dDkMZEpZB+3X1WpUvzgVQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/project-service": "8.50.1", + "@typescript-eslint/tsconfig-utils": "8.50.1", + "@typescript-eslint/types": "8.50.1", + "@typescript-eslint/visitor-keys": "8.50.1", + "debug": "^4.3.4", + "minimatch": "^9.0.4", + "semver": "^7.6.0", + "tinyglobby": "^0.2.15", + "ts-api-utils": "^2.1.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz", + "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", + "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/semver": { + "version": "7.7.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz", + "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@typescript-eslint/utils": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.50.1.tgz", + "integrity": "sha512-lCLp8H1T9T7gPbEuJSnHwnSuO9mDf8mfK/Nion5mZmiEaQD9sWf9W4dfeFqRyqRjF06/kBuTmAqcs9sewM2NbQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.7.0", + "@typescript-eslint/scope-manager": "8.50.1", + "@typescript-eslint/types": "8.50.1", + "@typescript-eslint/typescript-estree": "8.50.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/@typescript-eslint/visitor-keys": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.50.1.tgz", + "integrity": "sha512-IrDKrw7pCRUR94zeuCSUWQ+w8JEf5ZX5jl/e6AHGSLi1/zIr0lgutfn/7JpfCey+urpgQEdrZVYzCaVVKiTwhQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.50.1", + "eslint-visitor-keys": "^4.2.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@vitejs/plugin-react": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/@vitejs/plugin-react/-/plugin-react-5.1.2.tgz", + "integrity": "sha512-EcA07pHJouywpzsoTUqNh5NwGayl2PPVEJKUSinGGSxFGYn+shYbqMGBg6FXDqgXum9Ou/ecb+411ssw8HImJQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.28.5", + "@babel/plugin-transform-react-jsx-self": "^7.27.1", + "@babel/plugin-transform-react-jsx-source": "^7.27.1", + "@rolldown/pluginutils": "1.0.0-beta.53", + "@types/babel__core": "^7.20.5", + "react-refresh": "^0.18.0" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "peerDependencies": { + "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" + } + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/baseline-browser-mapping": { + "version": "2.9.11", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.9.11.tgz", + "integrity": "sha512-Sg0xJUNDU1sJNGdfGWhVHX0kkZ+HWcvmVymJbj6NSgZZmW/8S9Y2HQ5euytnIgakgxN6papOAWiwDo1ctFDcoQ==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.js" + } + }, + "node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/browserslist": { + "version": "4.28.1", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz", + "integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "baseline-browser-mapping": "^2.9.0", + "caniuse-lite": "^1.0.30001759", + "electron-to-chromium": "^1.5.263", + "node-releases": "^2.0.27", + "update-browserslist-db": "^1.2.0" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001761", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001761.tgz", + "integrity": "sha512-JF9ptu1vP2coz98+5051jZ4PwQgd2ni8A+gYSN7EA7dPKIMf0pDlSUxhdmVOaV3/fYK5uWBkgSXJaRLr4+3A6g==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/class-variance-authority": { + "version": "0.7.1", + "resolved": "https://registry.npmjs.org/class-variance-authority/-/class-variance-authority-0.7.1.tgz", + "integrity": "sha512-Ka+9Trutv7G8M6WT6SeiRWz792K5qEqIGEGzXKhAE6xOWAY6pPH8U+9IY3oCMv6kqTmLsv7Xh/2w2RigkePMsg==", + "license": "Apache-2.0", + "dependencies": { + "clsx": "^2.1.1" + }, + "funding": { + "url": "https://polar.sh/cva" + } + }, + "node_modules/clsx": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz", + "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT" + }, + "node_modules/convert-source-map": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", + "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", + "dev": true, + "license": "MIT" + }, + "node_modules/cookie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz", + "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==", + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/d3-array": { + "version": "3.2.4", + "resolved": "https://registry.npmjs.org/d3-array/-/d3-array-3.2.4.tgz", + "integrity": "sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==", + "license": "ISC", + "dependencies": { + "internmap": "1 - 2" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-color": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-color/-/d3-color-3.1.0.tgz", + "integrity": "sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-ease": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-ease/-/d3-ease-3.0.1.tgz", + "integrity": "sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-format": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-format/-/d3-format-3.1.0.tgz", + "integrity": "sha512-YyUI6AEuY/Wpt8KWLgZHsIU86atmikuoOmCfommt0LYHiQSPjvX2AcFc38PX0CBpr2RCyZhjex+NS/LPOv6YqA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-interpolate": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-interpolate/-/d3-interpolate-3.0.1.tgz", + "integrity": "sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==", + "license": "ISC", + "dependencies": { + "d3-color": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-path": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-path/-/d3-path-3.1.0.tgz", + "integrity": "sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-scale": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/d3-scale/-/d3-scale-4.0.2.tgz", + "integrity": "sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==", + "license": "ISC", + "dependencies": { + "d3-array": "2.10.0 - 3", + "d3-format": "1 - 3", + "d3-interpolate": "1.2.0 - 3", + "d3-time": "2.1.1 - 3", + "d3-time-format": "2 - 4" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-shape": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/d3-shape/-/d3-shape-3.2.0.tgz", + "integrity": "sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==", + "license": "ISC", + "dependencies": { + "d3-path": "^3.1.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-time": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/d3-time/-/d3-time-3.1.0.tgz", + "integrity": "sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==", + "license": "ISC", + "dependencies": { + "d3-array": "2 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-time-format": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/d3-time-format/-/d3-time-format-4.1.0.tgz", + "integrity": "sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==", + "license": "ISC", + "dependencies": { + "d3-time": "1 - 3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/d3-timer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-3.0.1.tgz", + "integrity": "sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/daisyui": { + "version": "5.5.14", + "resolved": "https://registry.npmjs.org/daisyui/-/daisyui-5.5.14.tgz", + "integrity": "sha512-L47rvw7I7hK68TA97VB8Ee0woHew+/ohR6Lx6Ah/krfISOqcG4My7poNpX5Mo5/ytMxiR40fEaz6njzDi7cuSg==", + "license": "MIT", + "funding": { + "url": "https://github.com/saadeghi/daisyui?sponsor=1" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/decimal.js-light": { + "version": "2.5.1", + "resolved": "https://registry.npmjs.org/decimal.js-light/-/decimal.js-light-2.5.1.tgz", + "integrity": "sha512-qIMFpTMZmny+MMIitAB6D7iVPEorVw6YQRWkvarTkT4tBeSLLiHzcwj6q0MmYSFCiVpiqPJTJEYIrpcPzVEIvg==", + "license": "MIT" + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/electron-to-chromium": { + "version": "1.5.267", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.267.tgz", + "integrity": "sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw==", + "dev": true, + "license": "ISC" + }, + "node_modules/enhanced-resolve": { + "version": "5.18.4", + "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.4.tgz", + "integrity": "sha512-LgQMM4WXU3QI+SYgEc2liRgznaD5ojbmY3sb8LxyguVkIg5FxdpTkvk72te2R38/TGKxH634oLxXRGY6d7AP+Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.4", + "tapable": "^2.2.0" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/es-toolkit": { + "version": "1.43.0", + "resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.43.0.tgz", + "integrity": "sha512-SKCT8AsWvYzBBuUqMk4NPwFlSdqLpJwmy6AP322ERn8W2YLIB6JBXnwMI2Qsh2gfphT3q7EKAxKb23cvFHFwKA==", + "license": "MIT", + "workspaces": [ + "docs", + "benchmarks" + ] + }, + "node_modules/esbuild": { + "version": "0.27.2", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.2.tgz", + "integrity": "sha512-HyNQImnsOC7X9PMNaCIeAm4ISCQXs5a5YasTXVliKv4uuBo1dKrG0A+uQS8M5eXjVMnLg3WgXaKvprHlFJQffw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.27.2", + "@esbuild/android-arm": "0.27.2", + "@esbuild/android-arm64": "0.27.2", + "@esbuild/android-x64": "0.27.2", + "@esbuild/darwin-arm64": "0.27.2", + "@esbuild/darwin-x64": "0.27.2", + "@esbuild/freebsd-arm64": "0.27.2", + "@esbuild/freebsd-x64": "0.27.2", + "@esbuild/linux-arm": "0.27.2", + "@esbuild/linux-arm64": "0.27.2", + "@esbuild/linux-ia32": "0.27.2", + "@esbuild/linux-loong64": "0.27.2", + "@esbuild/linux-mips64el": "0.27.2", + "@esbuild/linux-ppc64": "0.27.2", + "@esbuild/linux-riscv64": "0.27.2", + "@esbuild/linux-s390x": "0.27.2", + "@esbuild/linux-x64": "0.27.2", + "@esbuild/netbsd-arm64": "0.27.2", + "@esbuild/netbsd-x64": "0.27.2", + "@esbuild/openbsd-arm64": "0.27.2", + "@esbuild/openbsd-x64": "0.27.2", + "@esbuild/openharmony-arm64": "0.27.2", + "@esbuild/sunos-x64": "0.27.2", + "@esbuild/win32-arm64": "0.27.2", + "@esbuild/win32-ia32": "0.27.2", + "@esbuild/win32-x64": "0.27.2" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "9.39.2", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.2.tgz", + "integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@eslint-community/eslint-utils": "^4.8.0", + "@eslint-community/regexpp": "^4.12.1", + "@eslint/config-array": "^0.21.1", + "@eslint/config-helpers": "^0.4.2", + "@eslint/core": "^0.17.0", + "@eslint/eslintrc": "^3.3.1", + "@eslint/js": "9.39.2", + "@eslint/plugin-kit": "^0.4.1", + "@humanfs/node": "^0.16.6", + "@humanwhocodes/module-importer": "^1.0.1", + "@humanwhocodes/retry": "^0.4.2", + "@types/estree": "^1.0.6", + "ajv": "^6.12.4", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.6", + "debug": "^4.3.2", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^8.4.0", + "eslint-visitor-keys": "^4.2.1", + "espree": "^10.4.0", + "esquery": "^1.5.0", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^8.0.0", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + }, + "peerDependencies": { + "jiti": "*" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + } + } + }, + "node_modules/eslint-plugin-react-hooks": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/eslint-plugin-react-hooks/-/eslint-plugin-react-hooks-7.0.1.tgz", + "integrity": "sha512-O0d0m04evaNzEPoSW+59Mezf8Qt0InfgGIBJnpC0h3NH/WjUAR7BIKUfysC6todmtiZ/A0oUVS8Gce0WhBrHsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.24.4", + "@babel/parser": "^7.24.4", + "hermes-parser": "^0.25.1", + "zod": "^3.25.0 || ^4.0.0", + "zod-validation-error": "^3.5.0 || ^4.0.0" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0 || ^9.0.0" + } + }, + "node_modules/eslint-plugin-react-refresh": { + "version": "0.4.26", + "resolved": "https://registry.npmjs.org/eslint-plugin-react-refresh/-/eslint-plugin-react-refresh-0.4.26.tgz", + "integrity": "sha512-1RETEylht2O6FM/MvgnyvT+8K21wLqDNg4qD51Zj3guhjt433XbnnkVttHMyaVyAFD03QSV4LPS5iE3VQmO7XQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "eslint": ">=8.40" + } + }, + "node_modules/eslint-scope": { + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", + "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", + "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/espree": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", + "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.15.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^4.2.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/eventemitter3": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz", + "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==", + "license": "MIT" + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/file-entry-cache": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", + "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^4.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", + "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.4" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/flatted": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", + "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", + "dev": true, + "license": "ISC" + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/globals": { + "version": "16.5.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz", + "integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/hermes-estree": { + "version": "0.25.1", + "resolved": "https://registry.npmjs.org/hermes-estree/-/hermes-estree-0.25.1.tgz", + "integrity": "sha512-0wUoCcLp+5Ev5pDW2OriHC2MJCbwLwuRx+gAqMTOkGKJJiBCLjtrvy4PWUGn6MIVefecRpzoOZ/UV6iGdOr+Cw==", + "dev": true, + "license": "MIT" + }, + "node_modules/hermes-parser": { + "version": "0.25.1", + "resolved": "https://registry.npmjs.org/hermes-parser/-/hermes-parser-0.25.1.tgz", + "integrity": "sha512-6pEjquH3rqaI6cYAXYPcz9MS4rY6R4ngRgrgfDshRptUZIc3lw0MCIJIGDj9++mfySOuPTHB4nrSW99BCvOPIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "hermes-estree": "0.25.1" + } + }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/immer": { + "version": "10.2.0", + "resolved": "https://registry.npmjs.org/immer/-/immer-10.2.0.tgz", + "integrity": "sha512-d/+XTN3zfODyjr89gM3mPq1WNX2B8pYsu7eORitdwyA2sBubnTl3laYlBk4sXY5FUa5qTZGBDPJICVbvqzjlbw==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/immer" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/internmap": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/internmap/-/internmap-2.0.3.tgz", + "integrity": "sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==", + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/jiti": { + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz", + "integrity": "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==", + "dev": true, + "license": "MIT", + "bin": { + "jiti": "lib/jiti-cli.mjs" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/jsesc": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", + "dev": true, + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/json5": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz", + "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", + "dev": true, + "license": "MIT", + "bin": { + "json5": "lib/cli.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/lightningcss": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.30.2.tgz", + "integrity": "sha512-utfs7Pr5uJyyvDETitgsaqSyjCb2qNRAtuqUeWIAKztsOYdcACf2KtARYXg2pSvhkt+9NfoaNY7fxjl6nuMjIQ==", + "dev": true, + "license": "MPL-2.0", + "dependencies": { + "detect-libc": "^2.0.3" + }, + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + }, + "optionalDependencies": { + "lightningcss-android-arm64": "1.30.2", + "lightningcss-darwin-arm64": "1.30.2", + "lightningcss-darwin-x64": "1.30.2", + "lightningcss-freebsd-x64": "1.30.2", + "lightningcss-linux-arm-gnueabihf": "1.30.2", + "lightningcss-linux-arm64-gnu": "1.30.2", + "lightningcss-linux-arm64-musl": "1.30.2", + "lightningcss-linux-x64-gnu": "1.30.2", + "lightningcss-linux-x64-musl": "1.30.2", + "lightningcss-win32-arm64-msvc": "1.30.2", + "lightningcss-win32-x64-msvc": "1.30.2" + } + }, + "node_modules/lightningcss-android-arm64": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.30.2.tgz", + "integrity": "sha512-BH9sEdOCahSgmkVhBLeU7Hc9DWeZ1Eb6wNS6Da8igvUwAe0sqROHddIlvU06q3WyXVEOYDZ6ykBZQnjTbmo4+A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-arm64": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.30.2.tgz", + "integrity": "sha512-ylTcDJBN3Hp21TdhRT5zBOIi73P6/W0qwvlFEk22fkdXchtNTOU4Qc37SkzV+EKYxLouZ6M4LG9NfZ1qkhhBWA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-x64": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.30.2.tgz", + "integrity": "sha512-oBZgKchomuDYxr7ilwLcyms6BCyLn0z8J0+ZZmfpjwg9fRVZIR5/GMXd7r9RH94iDhld3UmSjBM6nXWM2TfZTQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-freebsd-x64": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.30.2.tgz", + "integrity": "sha512-c2bH6xTrf4BDpK8MoGG4Bd6zAMZDAXS569UxCAGcA7IKbHNMlhGQ89eRmvpIUGfKWNVdbhSbkQaWhEoMGmGslA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm-gnueabihf": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.30.2.tgz", + "integrity": "sha512-eVdpxh4wYcm0PofJIZVuYuLiqBIakQ9uFZmipf6LF/HRj5Bgm0eb3qL/mr1smyXIS1twwOxNWndd8z0E374hiA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-gnu": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.30.2.tgz", + "integrity": "sha512-UK65WJAbwIJbiBFXpxrbTNArtfuznvxAJw4Q2ZGlU8kPeDIWEX1dg3rn2veBVUylA2Ezg89ktszWbaQnxD/e3A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-musl": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.30.2.tgz", + "integrity": "sha512-5Vh9dGeblpTxWHpOx8iauV02popZDsCYMPIgiuw97OJ5uaDsL86cnqSFs5LZkG3ghHoX5isLgWzMs+eD1YzrnA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-gnu": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.30.2.tgz", + "integrity": "sha512-Cfd46gdmj1vQ+lR6VRTTadNHu6ALuw2pKR9lYq4FnhvgBc4zWY1EtZcAc6EffShbb1MFrIPfLDXD6Xprbnni4w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-musl": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.30.2.tgz", + "integrity": "sha512-XJaLUUFXb6/QG2lGIW6aIk6jKdtjtcffUT0NKvIqhSBY3hh9Ch+1LCeH80dR9q9LBjG3ewbDjnumefsLsP6aiA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-arm64-msvc": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.30.2.tgz", + "integrity": "sha512-FZn+vaj7zLv//D/192WFFVA0RgHawIcHqLX9xuWiQt7P0PtdFEVaxgF9rjM/IRYHQXNnk61/H/gb2Ei+kUQ4xQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-x64-msvc": { + "version": "1.30.2", + "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.30.2.tgz", + "integrity": "sha512-5g1yc73p+iAkid5phb4oVFMB45417DkRevRbt/El/gKXJk4jid+vPFF/AXbxn05Aky8PapwzZrdJShv5C0avjw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/lru-cache": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", + "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", + "dev": true, + "license": "ISC", + "dependencies": { + "yallist": "^3.0.2" + } + }, + "node_modules/lucide-react": { + "version": "0.562.0", + "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-0.562.0.tgz", + "integrity": "sha512-82hOAu7y0dbVuFfmO4bYF1XEwYk/mEbM5E+b1jgci/udUBEE/R7LF5Ip0CCEmXe8AybRM8L+04eP+LGZeDvkiw==", + "license": "ISC", + "peerDependencies": { + "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0" + } + }, + "node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.11", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", + "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, + "node_modules/node-releases": { + "version": "2.0.27", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.27.tgz", + "integrity": "sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.6", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz", + "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/react": { + "version": "19.2.3", + "resolved": "https://registry.npmjs.org/react/-/react-19.2.3.tgz", + "integrity": "sha512-Ku/hhYbVjOQnXDZFv2+RibmLFGwFdeeKHFcOTlrt7xplBnya5OGn/hIRDsqDiSUcfORsDC7MPxwork8jBwsIWA==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-dom": { + "version": "19.2.3", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.3.tgz", + "integrity": "sha512-yELu4WmLPw5Mr/lmeEpox5rw3RETacE++JgHqQzd2dg+YbJuat3jH4ingc+WPZhxaoFzdv9y33G+F7Nl5O0GBg==", + "license": "MIT", + "peer": true, + "dependencies": { + "scheduler": "^0.27.0" + }, + "peerDependencies": { + "react": "^19.2.3" + } + }, + "node_modules/react-is": { + "version": "19.2.3", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-19.2.3.tgz", + "integrity": "sha512-qJNJfu81ByyabuG7hPFEbXqNcWSU3+eVus+KJs+0ncpGfMyYdvSmxiJxbWR65lYi1I+/0HBcliO029gc4F+PnA==", + "license": "MIT", + "peer": true + }, + "node_modules/react-redux": { + "version": "9.2.0", + "resolved": "https://registry.npmjs.org/react-redux/-/react-redux-9.2.0.tgz", + "integrity": "sha512-ROY9fvHhwOD9ySfrF0wmvu//bKCQ6AeZZq1nJNtbDC+kk5DuSuNX/n6YWYF/SYy7bSba4D4FSz8DJeKY/S/r+g==", + "license": "MIT", + "peer": true, + "dependencies": { + "@types/use-sync-external-store": "^0.0.6", + "use-sync-external-store": "^1.4.0" + }, + "peerDependencies": { + "@types/react": "^18.2.25 || ^19", + "react": "^18.0 || ^19", + "redux": "^5.0.0" + }, + "peerDependenciesMeta": { + "@types/react": { + "optional": true + }, + "redux": { + "optional": true + } + } + }, + "node_modules/react-refresh": { + "version": "0.18.0", + "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.18.0.tgz", + "integrity": "sha512-QgT5//D3jfjJb6Gsjxv0Slpj23ip+HtOpnNgnb2S5zU3CB26G/IDPGoy4RJB42wzFE46DRsstbW6tKHoKbhAxw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-router": { + "version": "7.11.0", + "resolved": "https://registry.npmjs.org/react-router/-/react-router-7.11.0.tgz", + "integrity": "sha512-uI4JkMmjbWCZc01WVP2cH7ZfSzH91JAZUDd7/nIprDgWxBV1TkkmLToFh7EbMTcMak8URFRa2YoBL/W8GWnCTQ==", + "license": "MIT", + "dependencies": { + "cookie": "^1.0.1", + "set-cookie-parser": "^2.6.0" + }, + "engines": { + "node": ">=20.0.0" + }, + "peerDependencies": { + "react": ">=18", + "react-dom": ">=18" + }, + "peerDependenciesMeta": { + "react-dom": { + "optional": true + } + } + }, + "node_modules/react-router-dom": { + "version": "7.11.0", + "resolved": "https://registry.npmjs.org/react-router-dom/-/react-router-dom-7.11.0.tgz", + "integrity": "sha512-e49Ir/kMGRzFOOrYQBdoitq3ULigw4lKbAyKusnvtDu2t4dBX4AGYPrzNvorXmVuOyeakai6FUPW5MmibvVG8g==", + "license": "MIT", + "dependencies": { + "react-router": "7.11.0" + }, + "engines": { + "node": ">=20.0.0" + }, + "peerDependencies": { + "react": ">=18", + "react-dom": ">=18" + } + }, + "node_modules/recharts": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/recharts/-/recharts-3.6.0.tgz", + "integrity": "sha512-L5bjxvQRAe26RlToBAziKUB7whaGKEwD3znoM6fz3DrTowCIC/FnJYnuq1GEzB8Zv2kdTfaxQfi5GoH0tBinyg==", + "license": "MIT", + "workspaces": [ + "www" + ], + "dependencies": { + "@reduxjs/toolkit": "1.x.x || 2.x.x", + "clsx": "^2.1.1", + "decimal.js-light": "^2.5.1", + "es-toolkit": "^1.39.3", + "eventemitter3": "^5.0.1", + "immer": "^10.1.1", + "react-redux": "8.x.x || 9.x.x", + "reselect": "5.1.1", + "tiny-invariant": "^1.3.3", + "use-sync-external-store": "^1.2.2", + "victory-vendor": "^37.0.2" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0", + "react-dom": "^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0", + "react-is": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" + } + }, + "node_modules/redux": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/redux/-/redux-5.0.1.tgz", + "integrity": "sha512-M9/ELqF6fy8FwmkpnF0S3YKOqMyoWJ4+CS5Efg2ct3oY9daQvd/Pc71FpGZsVsbl3Cpb+IIcjBDUnnyBdQbq4w==", + "license": "MIT", + "peer": true + }, + "node_modules/redux-thunk": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/redux-thunk/-/redux-thunk-3.1.0.tgz", + "integrity": "sha512-NW2r5T6ksUKXCabzhL9z+h206HQw/NJkcLm1GPImRQ8IzfXwRGqjVhKJGauHirT0DAuyy6hjdnMZaRoAcy0Klw==", + "license": "MIT", + "peerDependencies": { + "redux": "^5.0.0" + } + }, + "node_modules/reselect": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/reselect/-/reselect-5.1.1.tgz", + "integrity": "sha512-K/BG6eIky/SBpzfHZv/dd+9JBFiS4SWV7FIujVyJRux6e45+73RaUHXLmIR1f7WOMaQ0U1km6qwklRQxpJJY0w==", + "license": "MIT" + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/rollup": { + "version": "4.54.0", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.54.0.tgz", + "integrity": "sha512-3nk8Y3a9Ea8szgKhinMlGMhGMw89mqule3KWczxhIzqudyHdCIOHw8WJlj/r329fACjKLEh13ZSk7oE22kyeIw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.8" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.54.0", + "@rollup/rollup-android-arm64": "4.54.0", + "@rollup/rollup-darwin-arm64": "4.54.0", + "@rollup/rollup-darwin-x64": "4.54.0", + "@rollup/rollup-freebsd-arm64": "4.54.0", + "@rollup/rollup-freebsd-x64": "4.54.0", + "@rollup/rollup-linux-arm-gnueabihf": "4.54.0", + "@rollup/rollup-linux-arm-musleabihf": "4.54.0", + "@rollup/rollup-linux-arm64-gnu": "4.54.0", + "@rollup/rollup-linux-arm64-musl": "4.54.0", + "@rollup/rollup-linux-loong64-gnu": "4.54.0", + "@rollup/rollup-linux-ppc64-gnu": "4.54.0", + "@rollup/rollup-linux-riscv64-gnu": "4.54.0", + "@rollup/rollup-linux-riscv64-musl": "4.54.0", + "@rollup/rollup-linux-s390x-gnu": "4.54.0", + "@rollup/rollup-linux-x64-gnu": "4.54.0", + "@rollup/rollup-linux-x64-musl": "4.54.0", + "@rollup/rollup-openharmony-arm64": "4.54.0", + "@rollup/rollup-win32-arm64-msvc": "4.54.0", + "@rollup/rollup-win32-ia32-msvc": "4.54.0", + "@rollup/rollup-win32-x64-gnu": "4.54.0", + "@rollup/rollup-win32-x64-msvc": "4.54.0", + "fsevents": "~2.3.2" + } + }, + "node_modules/scheduler": { + "version": "0.27.0", + "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz", + "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==", + "license": "MIT" + }, + "node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/set-cookie-parser": { + "version": "2.7.2", + "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", + "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==", + "license": "MIT" + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/tailwind-merge": { + "version": "3.4.0", + "resolved": "https://registry.npmjs.org/tailwind-merge/-/tailwind-merge-3.4.0.tgz", + "integrity": "sha512-uSaO4gnW+b3Y2aWoWfFpX62vn2sR3skfhbjsEnaBI81WD1wBLlHZe5sWf0AqjksNdYTbGBEd0UasQMT3SNV15g==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/dcastil" + } + }, + "node_modules/tailwindcss": { + "version": "4.1.18", + "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.1.18.tgz", + "integrity": "sha512-4+Z+0yiYyEtUVCScyfHCxOYP06L5Ne+JiHhY2IjR2KWMIWhJOYZKLSGZaP5HkZ8+bY0cxfzwDE5uOmzFXyIwxw==", + "dev": true, + "license": "MIT" + }, + "node_modules/tapable": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.0.tgz", + "integrity": "sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/webpack" + } + }, + "node_modules/tiny-invariant": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.3.3.tgz", + "integrity": "sha512-+FbBPE1o9QAYvviau/qC5SE3caw21q3xkvWKBtja5vgqOWIHHJ3ioaq1VPfn/Szqctz2bU/oYeKd9/z5BL+PVg==", + "license": "MIT" + }, + "node_modules/tinyglobby": { + "version": "0.2.15", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz", + "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.3" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/ts-api-utils": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.3.0.tgz", + "integrity": "sha512-6eg3Y9SF7SsAvGzRHQvvc1skDAhwI4YQ32ui1scxD1Ccr0G5qIIbUBT3pFTKX8kmWIQClHobtUdNuaBgwdfdWg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.12" + }, + "peerDependencies": { + "typescript": ">=4.8.4" + } + }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "peer": true, + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/typescript-eslint": { + "version": "8.50.1", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.50.1.tgz", + "integrity": "sha512-ytTHO+SoYSbhAH9CrYnMhiLx8To6PSSvqnvXyPUgPETCvB6eBKmTI9w6XMPS3HsBRGkwTVBX+urA8dYQx6bHfQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/eslint-plugin": "8.50.1", + "@typescript-eslint/parser": "8.50.1", + "@typescript-eslint/typescript-estree": "8.50.1", + "@typescript-eslint/utils": "8.50.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <6.0.0" + } + }, + "node_modules/undici-types": { + "version": "7.16.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz", + "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==", + "dev": true, + "license": "MIT" + }, + "node_modules/update-browserslist-db": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz", + "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.1" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/use-sync-external-store": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz", + "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==", + "license": "MIT", + "peerDependencies": { + "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" + } + }, + "node_modules/victory-vendor": { + "version": "37.3.6", + "resolved": "https://registry.npmjs.org/victory-vendor/-/victory-vendor-37.3.6.tgz", + "integrity": "sha512-SbPDPdDBYp+5MJHhBCAyI7wKM3d5ivekigc2Dk2s7pgbZ9wIgIBYGVw4zGHBml/qTFbexrofXW6Gu4noGxrOwQ==", + "license": "MIT AND ISC", + "dependencies": { + "@types/d3-array": "^3.0.3", + "@types/d3-ease": "^3.0.0", + "@types/d3-interpolate": "^3.0.1", + "@types/d3-scale": "^4.0.2", + "@types/d3-shape": "^3.1.0", + "@types/d3-time": "^3.0.0", + "@types/d3-timer": "^3.0.0", + "d3-array": "^3.1.6", + "d3-ease": "^3.0.1", + "d3-interpolate": "^3.0.1", + "d3-scale": "^4.0.2", + "d3-shape": "^3.1.0", + "d3-time": "^3.0.0", + "d3-timer": "^3.0.1" + } + }, + "node_modules/vite": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.0.tgz", + "integrity": "sha512-dZwN5L1VlUBewiP6H9s2+B3e3Jg96D0vzN+Ry73sOefebhYr9f94wwkMNN/9ouoU8pV1BqA1d1zGk8928cx0rg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "esbuild": "^0.27.0", + "fdir": "^6.5.0", + "picomatch": "^4.0.3", + "postcss": "^8.5.6", + "rollup": "^4.43.0", + "tinyglobby": "^0.2.15" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "lightningcss": "^1.21.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/yallist": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", + "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", + "dev": true, + "license": "ISC" + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/zod": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/zod/-/zod-4.2.1.tgz", + "integrity": "sha512-0wZ1IRqGGhMP76gLqz8EyfBXKk0J2qo2+H3fi4mcUP/KtTocoX08nmIAHl1Z2kJIZbZee8KOpBCSNPRgauucjw==", + "dev": true, + "license": "MIT", + "peer": true, + "funding": { + "url": "https://github.com/sponsors/colinhacks" + } + }, + "node_modules/zod-validation-error": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/zod-validation-error/-/zod-validation-error-4.0.2.tgz", + "integrity": "sha512-Q6/nZLe6jxuU80qb/4uJ4t5v2VEZ44lzQjPDhYJNztRQ4wyWc6VF3D3Kb/fAuPetZQnhS3hnajCf9CsWesghLQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.0.0" + }, + "peerDependencies": { + "zod": "^3.25.0 || ^4.0.0" + } + } + } +} diff --git a/examples/demo/frontend/package.json b/examples/demo/frontend/package.json new file mode 100644 index 0000000..c466755 --- /dev/null +++ b/examples/demo/frontend/package.json @@ -0,0 +1,40 @@ +{ + "name": "frontend", + "private": true, + "version": "0.0.0", + "type": "module", + "scripts": { + "dev": "vite", + "build": "tsc -b && vite build", + "lint": "eslint .", + "preview": "vite preview" + }, + "dependencies": { + "@tanstack/react-query": "^5.90.14", + "class-variance-authority": "^0.7.1", + "clsx": "^2.1.1", + "daisyui": "^5.5.14", + "lucide-react": "^0.562.0", + "react": "^19.2.0", + "react-dom": "^19.2.0", + "react-router-dom": "^7.11.0", + "recharts": "^3.6.0", + "tailwind-merge": "^3.4.0" + }, + "devDependencies": { + "@eslint/js": "^9.39.1", + "@tailwindcss/vite": "^4.1.18", + "@types/node": "^24.10.1", + "@types/react": "^19.2.5", + "@types/react-dom": "^19.2.3", + "@vitejs/plugin-react": "^5.1.1", + "eslint": "^9.39.1", + "eslint-plugin-react-hooks": "^7.0.1", + "eslint-plugin-react-refresh": "^0.4.24", + "globals": "^16.5.0", + "tailwindcss": "^4.1.18", + "typescript": "~5.9.3", + "typescript-eslint": "^8.46.4", + "vite": "^7.2.4" + } +} diff --git a/examples/demo/frontend/public/vite.svg b/examples/demo/frontend/public/vite.svg new file mode 100644 index 0000000..e7b8dfb --- /dev/null +++ b/examples/demo/frontend/public/vite.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/examples/demo/frontend/src/App.tsx b/examples/demo/frontend/src/App.tsx new file mode 100644 index 0000000..5cb7f0a --- /dev/null +++ b/examples/demo/frontend/src/App.tsx @@ -0,0 +1,57 @@ +import { useState } from "react"; +import { BrowserRouter, Routes, Route } from "react-router-dom"; +import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; +import { ThemeProvider } from "./context/ThemeContext"; +import { Sidebar } from "./components"; +import { Dashboard, Prices, Forecasts, Historical } from "./pages"; + +const queryClient = new QueryClient({ + defaultOptions: { + queries: { + retry: 2, + staleTime: 30000, + refetchOnWindowFocus: false, + }, + }, +}); + +function AppContent() { + const [sidebarCollapsed, setSidebarCollapsed] = useState(false); + + return ( +
+ setSidebarCollapsed(!sidebarCollapsed)} + /> +
+
+ + } /> + } /> + } /> + } /> + +
+
+
+ ); +} + +function App() { + return ( + + + + + + + + ); +} + +export default App; diff --git a/examples/demo/frontend/src/api/client.ts b/examples/demo/frontend/src/api/client.ts new file mode 100644 index 0000000..eb5380e --- /dev/null +++ b/examples/demo/frontend/src/api/client.ts @@ -0,0 +1,183 @@ +// API Client for TinyGrid Demo + +const API_BASE = "/api"; + +async function fetchAPI(endpoint: string, params?: Record): Promise { + const url = new URL(endpoint, window.location.origin); + + if (params) { + Object.entries(params).forEach(([key, value]) => { + if (value !== undefined && value !== null && value !== "") { + url.searchParams.append(key, value); + } + }); + } + + const response = await fetch(url.toString()); + + if (!response.ok) { + const errorData = await response.json().catch(() => ({})); + throw new Error(errorData.detail || `API Error: ${response.status}`); + } + + return response.json(); +} + +// Dashboard endpoints +export const dashboardAPI = { + getStatus: () => fetchAPI(`${API_BASE}/status`), + + getFuelMix: () => fetchAPI(`${API_BASE}/fuel-mix`), + + getFuelMixRealtime: () => fetchAPI(`${API_BASE}/fuel-mix-realtime`), + + getRenewable: () => fetchAPI(`${API_BASE}/renewable`), + + getSupplyDemand: () => fetchAPI(`${API_BASE}/supply-demand`), +}; + +// Prices endpoints +export interface SPPParams { + start?: string; + end?: string; + market?: "real_time_15_min" | "day_ahead_hourly"; + location_type?: "load_zone" | "trading_hub" | "resource_node" | "all"; + locations?: string; +} + +export interface LMPParams { + start?: string; + end?: string; + market?: "real_time_sced" | "day_ahead_hourly"; + location_type?: "resource_node" | "electrical_bus"; +} + +export interface LMPCombinedParams { + location_type?: "load_zone" | "trading_hub" | "dc_tie"; + location?: string; +} + +export interface LMPCombinedResponse { + data: Array<{ + time: string; + location: string; + rt_price: number | null; + da_price: number | null; + market: "RT" | "DA"; + }>; + locations: string[]; + latest_rt_time: string | null; + count: number; +} + +// Grid endpoints for mini-chart display +export interface PriceGridParams { + start?: string; + end?: string; + market?: "real_time_15_min" | "day_ahead_hourly"; +} + +export interface LocationPriceData { + location: string; + location_type: "load_zone" | "trading_hub" | "dc_tie" | "unknown"; + data: Array<{ time: string; price: number }>; + latest_price: number | null; + latest_time: string | null; + avg_price: number | null; + min_price: number | null; + max_price: number | null; +} + +export interface PriceGridResponse { + locations: LocationPriceData[]; + latest_update: string | null; + count: number; + start_date: string; + end_date: string | null; +} + +export const pricesAPI = { + getSPP: (params?: SPPParams) => + fetchAPI(`${API_BASE}/spp`, params as Record), + + getLMP: (params?: LMPParams) => + fetchAPI(`${API_BASE}/lmp`, params as Record), + + getLMPCombined: (params?: LMPCombinedParams) => + fetchAPI(`${API_BASE}/lmp-combined`, params as Record), + + getDailyPrices: () => + fetchAPI(`${API_BASE}/daily-prices`), + + // Grid endpoints for mini-chart display + getLMPGrid: (params?: PriceGridParams) => + fetchAPI(`${API_BASE}/lmp-grid`, params as Record), + + getSPPGrid: (params?: PriceGridParams) => + fetchAPI(`${API_BASE}/spp-grid`, params as Record), +}; + +// Forecasts endpoints +export interface LoadParams { + start?: string; + end?: string; + by?: "weather_zone" | "forecast_zone"; +} + +export interface LoadForecastParams { + start?: string; + end?: string; + by?: "weather_zone" | "study_area"; +} + +export interface WindSolarParams { + start?: string; + end?: string; + resolution?: "hourly" | "5min"; + by_region?: boolean; +} + +export const forecastsAPI = { + getLoad: (params?: LoadParams) => + fetchAPI(`${API_BASE}/load`, params as Record), + + getLoadForecast: (params?: LoadForecastParams) => + fetchAPI(`${API_BASE}/load-forecast`, params as Record), + + getWindForecast: (params?: WindSolarParams) => + fetchAPI( + `${API_BASE}/wind-forecast`, + { + ...params, + by_region: params?.by_region?.toString(), + } as Record + ), + + getSolarForecast: (params?: WindSolarParams) => + fetchAPI( + `${API_BASE}/solar-forecast`, + { + ...params, + by_region: params?.by_region?.toString(), + } as Record + ), +}; + +// Historical endpoints +export interface HistoricalParams { + endpoint: string; + start: string; + end: string; +} + +export const historicalAPI = { + getEndpoints: () => + fetchAPI(`${API_BASE}/historical/endpoints`), + + getHistorical: (params: HistoricalParams) => + fetchAPI(`${API_BASE}/historical`, { + endpoint: params.endpoint, + start: params.start, + end: params.end, + }), +}; diff --git a/examples/demo/frontend/src/api/hooks.ts b/examples/demo/frontend/src/api/hooks.ts new file mode 100644 index 0000000..e71f60d --- /dev/null +++ b/examples/demo/frontend/src/api/hooks.ts @@ -0,0 +1,171 @@ +import { useQuery } from "@tanstack/react-query"; +import { + dashboardAPI, + pricesAPI, + forecastsAPI, + historicalAPI, + type SPPParams, + type LMPParams, + type LMPCombinedParams, + type PriceGridParams, + type LoadParams, + type LoadForecastParams, + type WindSolarParams, + type HistoricalParams, +} from "./client"; + +// Dashboard hooks +export function useGridStatus() { + return useQuery({ + queryKey: ["status"], + queryFn: dashboardAPI.getStatus, + refetchInterval: 60000, // Auto-refresh every minute + staleTime: 30000, + }); +} + +export function useFuelMix() { + return useQuery({ + queryKey: ["fuel-mix"], + queryFn: dashboardAPI.getFuelMix, + refetchInterval: 60000, + staleTime: 30000, + }); +} + +export function useFuelMixRealtime() { + return useQuery({ + queryKey: ["fuel-mix-realtime"], + queryFn: dashboardAPI.getFuelMixRealtime, + refetchInterval: 60000, + staleTime: 30000, + }); +} + +export function useRenewable() { + return useQuery({ + queryKey: ["renewable"], + queryFn: dashboardAPI.getRenewable, + refetchInterval: 60000, + staleTime: 30000, + }); +} + +export function useSupplyDemand() { + return useQuery({ + queryKey: ["supply-demand"], + queryFn: dashboardAPI.getSupplyDemand, + refetchInterval: 60000, + staleTime: 30000, + }); +} + +// Prices hooks +export function useSPP(params?: SPPParams) { + return useQuery({ + queryKey: ["spp", params], + queryFn: () => pricesAPI.getSPP(params), + staleTime: 30000, + refetchInterval: 60000, // Auto-refresh every minute + }); +} + +export function useLMP(params?: LMPParams) { + return useQuery({ + queryKey: ["lmp", params], + queryFn: () => pricesAPI.getLMP(params), + staleTime: 30000, + refetchInterval: 60000, // Auto-refresh every minute + }); +} + +export function useDailyPrices() { + return useQuery({ + queryKey: ["daily-prices"], + queryFn: pricesAPI.getDailyPrices, + staleTime: 300000, // 5 minutes - daily prices don't change often + }); +} + +export function useLMPCombined(params?: LMPCombinedParams) { + return useQuery({ + queryKey: ["lmp-combined", params], + queryFn: () => pricesAPI.getLMPCombined(params), + staleTime: 30000, + refetchInterval: 60000, // Auto-refresh every minute + }); +} + +// Grid hooks for mini-chart display +export function useLMPGrid(params?: PriceGridParams) { + return useQuery({ + queryKey: ["lmp-grid", params], + queryFn: () => pricesAPI.getLMPGrid(params), + staleTime: 30000, + refetchInterval: 60000, // Auto-refresh every minute + }); +} + +export function useSPPGrid(params?: PriceGridParams) { + return useQuery({ + queryKey: ["spp-grid", params], + queryFn: () => pricesAPI.getSPPGrid(params), + staleTime: 30000, + refetchInterval: 60000, // Auto-refresh every minute + }); +} + +// Forecasts hooks +export function useLoad(params?: LoadParams) { + return useQuery({ + queryKey: ["load", params], + queryFn: () => forecastsAPI.getLoad(params), + staleTime: 60000, + refetchInterval: 120000, // Auto-refresh every 2 minutes + }); +} + +export function useLoadForecast(params?: LoadForecastParams) { + return useQuery({ + queryKey: ["load-forecast", params], + queryFn: () => forecastsAPI.getLoadForecast(params), + staleTime: 60000, + refetchInterval: 120000, // Auto-refresh every 2 minutes + }); +} + +export function useWindForecast(params?: WindSolarParams) { + return useQuery({ + queryKey: ["wind-forecast", params], + queryFn: () => forecastsAPI.getWindForecast(params), + staleTime: 60000, + refetchInterval: 120000, // Auto-refresh every 2 minutes + }); +} + +export function useSolarForecast(params?: WindSolarParams) { + return useQuery({ + queryKey: ["solar-forecast", params], + queryFn: () => forecastsAPI.getSolarForecast(params), + staleTime: 60000, + refetchInterval: 120000, // Auto-refresh every 2 minutes + }); +} + +// Historical hooks +export function useHistoricalEndpoints() { + return useQuery({ + queryKey: ["historical-endpoints"], + queryFn: historicalAPI.getEndpoints, + staleTime: Infinity, // Endpoints don't change + }); +} + +export function useHistorical(params: HistoricalParams | null) { + return useQuery({ + queryKey: ["historical", params], + queryFn: () => historicalAPI.getHistorical(params!), + enabled: !!params && !!params.endpoint && !!params.start && !!params.end, + staleTime: Infinity, // Historical data doesn't change + }); +} diff --git a/examples/demo/frontend/src/api/index.ts b/examples/demo/frontend/src/api/index.ts new file mode 100644 index 0000000..ac1c0d0 --- /dev/null +++ b/examples/demo/frontend/src/api/index.ts @@ -0,0 +1,3 @@ +export * from "./types"; +export * from "./client"; +export * from "./hooks"; diff --git a/examples/demo/frontend/src/api/types.ts b/examples/demo/frontend/src/api/types.ts new file mode 100644 index 0000000..f1d127f --- /dev/null +++ b/examples/demo/frontend/src/api/types.ts @@ -0,0 +1,126 @@ +// API Response Types + +export interface GridStatus { + condition: string; + current_load: number; + capacity: number; + reserves: number; + timestamp: string; + peak_forecast: number; + wind_output: number; + solar_output: number; + prc: number; + message: string; +} + +export interface FuelMixEntry { + fuel_type: string; + generation_mw: number; + percentage: number; +} + +export interface FuelMixResponse { + entries: FuelMixEntry[]; + timestamp: string; + total_generation_mw: number; +} + +export interface RenewableStatus { + wind_mw: number; + solar_mw: number; + wind_forecast_mw: number; + solar_forecast_mw: number; + wind_capacity_mw: number; + solar_capacity_mw: number; + timestamp: string; + total_renewable_mw: number; + renewable_percentage: number | null; +} + +export interface SupplyDemandEntry { + hour: string | number | null; + demand: number; + supply: number; + reserves: number; +} + +export interface SupplyDemandResponse { + data: SupplyDemandEntry[]; + timestamp: string; +} + +export interface SPPResponse { + data: Record[]; + count: number; + market: string; + start_date: string; + end_date: string | null; +} + +export interface LMPResponse { + data: Record[]; + count: number; + market: string; + location_type: string; +} + +export interface DailyPricesResponse { + data: Record[]; + count: number; +} + +export interface LoadResponse { + data: Record[]; + count: number; + zone_type: string; + start_date: string; + end_date: string | null; +} + +export interface WindForecastResponse { + data: Record[]; + count: number; + resolution: string; + by_region: boolean; + start_date: string; + end_date: string | null; +} + +export interface SolarForecastResponse { + data: Record[]; + count: number; + resolution: string; + by_region: boolean; + start_date: string; + end_date: string | null; +} + +export interface EndpointInfo { + name: string; + path: string; + description: string; +} + +export interface AvailableEndpointsResponse { + endpoints: EndpointInfo[]; +} + +export interface HistoricalResponse { + data: Record[]; + count: number; + endpoint: string; + start_date: string; + end_date: string; +} + +// Grid condition enum for styling +export type GridCondition = + | "normal" + | "conservation" + | "watch" + | "advisory" + | "emergency" + | "eea1" + | "eea2" + | "eea3" + | "unknown"; diff --git a/examples/demo/frontend/src/components/Badge.tsx b/examples/demo/frontend/src/components/Badge.tsx new file mode 100644 index 0000000..7f0484d --- /dev/null +++ b/examples/demo/frontend/src/components/Badge.tsx @@ -0,0 +1,25 @@ +import type { ReactNode } from "react"; + +type BadgeVariant = "default" | "success" | "warning" | "error" | "info"; + +interface BadgeProps { + children: ReactNode; + variant?: BadgeVariant; + className?: string; +} + +const variantClasses: Record = { + default: "badge-neutral", + success: "badge-success", + warning: "badge-warning", + error: "badge-error", + info: "badge-info", +}; + +export function Badge({ children, variant = "default", className = "" }: BadgeProps) { + return ( + + {children} + + ); +} diff --git a/examples/demo/frontend/src/components/Card.tsx b/examples/demo/frontend/src/components/Card.tsx new file mode 100644 index 0000000..fc9d54c --- /dev/null +++ b/examples/demo/frontend/src/components/Card.tsx @@ -0,0 +1,66 @@ +import type { ReactNode } from "react"; + +interface CardProps { + children: ReactNode; + className?: string; +} + +export function Card({ children, className = "" }: CardProps) { + return ( +
+ {children} +
+ ); +} + +interface CardHeaderProps { + children: ReactNode; + className?: string; +} + +export function CardHeader({ children, className = "" }: CardHeaderProps) { + return ( +
+ {children} +
+ ); +} + +interface CardTitleProps { + children: ReactNode; + className?: string; +} + +export function CardTitle({ children, className = "" }: CardTitleProps) { + return ( +

+ {children} +

+ ); +} + +interface CardContentProps { + children: ReactNode; + className?: string; +} + +export function CardContent({ children, className = "" }: CardContentProps) { + return ( +
+ {children} +
+ ); +} + +interface CardDescriptionProps { + children: ReactNode; + className?: string; +} + +export function CardDescription({ children, className = "" }: CardDescriptionProps) { + return ( +

+ {children} +

+ ); +} diff --git a/examples/demo/frontend/src/components/Error.tsx b/examples/demo/frontend/src/components/Error.tsx new file mode 100644 index 0000000..4d69abd --- /dev/null +++ b/examples/demo/frontend/src/components/Error.tsx @@ -0,0 +1,21 @@ +import { AlertTriangle, RefreshCw } from "lucide-react"; + +interface ErrorCardProps { + message?: string; + onRetry?: () => void; +} + +export function ErrorCard({ message = "Something went wrong", onRetry }: ErrorCardProps) { + return ( +
+ + {message} + {onRetry && ( + + )} +
+ ); +} diff --git a/examples/demo/frontend/src/components/Loading.tsx b/examples/demo/frontend/src/components/Loading.tsx new file mode 100644 index 0000000..90bbed3 --- /dev/null +++ b/examples/demo/frontend/src/components/Loading.tsx @@ -0,0 +1,21 @@ +interface LoadingProps { + className?: string; + size?: "xs" | "sm" | "md" | "lg"; + text?: string; +} + +export function Loading({ className = "", size = "md", text }: LoadingProps) { + const sizeClass = { + xs: "loading-xs", + sm: "loading-sm", + md: "loading-md", + lg: "loading-lg", + }[size]; + + return ( +
+ + {text && {text}} +
+ ); +} diff --git a/examples/demo/frontend/src/components/Sidebar.tsx b/examples/demo/frontend/src/components/Sidebar.tsx new file mode 100644 index 0000000..5c5e13e --- /dev/null +++ b/examples/demo/frontend/src/components/Sidebar.tsx @@ -0,0 +1,120 @@ +import { Link, useLocation } from "react-router-dom"; +import { useTheme } from "../context/ThemeContext"; +import { + LayoutDashboard, + DollarSign, + TrendingUp, + Database, + ChevronLeft, + ChevronRight, + Zap, + Sun, + Moon, +} from "lucide-react"; + +const navItems = [ + { + path: "/", + label: "Dashboard", + icon: LayoutDashboard, + }, + { + path: "/prices", + label: "Prices", + icon: DollarSign, + }, + { + path: "/forecasts", + label: "Forecasts", + icon: TrendingUp, + }, + { + path: "/historical", + label: "Historical", + icon: Database, + }, +]; + +interface SidebarProps { + collapsed: boolean; + onToggle: () => void; +} + +export function Sidebar({ collapsed, onToggle }: SidebarProps) { + const location = useLocation(); + const { theme, toggleTheme } = useTheme(); + + return ( + + ); +} diff --git a/examples/demo/frontend/src/components/index.ts b/examples/demo/frontend/src/components/index.ts new file mode 100644 index 0000000..f8cc8e9 --- /dev/null +++ b/examples/demo/frontend/src/components/index.ts @@ -0,0 +1,5 @@ +export * from "./Card"; +export * from "./Badge"; +export * from "./Loading"; +export * from "./Error"; +export * from "./Sidebar"; diff --git a/examples/demo/frontend/src/context/ThemeContext.tsx b/examples/demo/frontend/src/context/ThemeContext.tsx new file mode 100644 index 0000000..c55cb32 --- /dev/null +++ b/examples/demo/frontend/src/context/ThemeContext.tsx @@ -0,0 +1,43 @@ +import { createContext, useContext, useState, useEffect, type ReactNode } from "react"; + +type Theme = "light" | "dark"; + +interface ThemeContextType { + theme: Theme; + toggleTheme: () => void; +} + +const ThemeContext = createContext(undefined); + +export function ThemeProvider({ children }: { children: ReactNode }) { + const [theme, setTheme] = useState(() => { + // Check localStorage first, then system preference + const saved = localStorage.getItem("theme") as Theme | null; + if (saved) return saved; + return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light"; + }); + + useEffect(() => { + localStorage.setItem("theme", theme); + // Update the data-theme attribute on html element + document.documentElement.setAttribute("data-theme", theme); + }, [theme]); + + const toggleTheme = () => { + setTheme((prev) => (prev === "dark" ? "light" : "dark")); + }; + + return ( + + {children} + + ); +} + +export function useTheme() { + const context = useContext(ThemeContext); + if (!context) { + throw new Error("useTheme must be used within a ThemeProvider"); + } + return context; +} diff --git a/examples/demo/frontend/src/index.css b/examples/demo/frontend/src/index.css new file mode 100644 index 0000000..99c8857 --- /dev/null +++ b/examples/demo/frontend/src/index.css @@ -0,0 +1,85 @@ +@import "tailwindcss"; +@plugin "daisyui"; + +/* DaisyUI dark theme customization */ +@theme { + /* Chart colors */ + --color-chart-1: #3b82f6; + --color-chart-2: #22c55e; + --color-chart-3: #f97316; + --color-chart-4: #eab308; + --color-chart-5: #a855f7; + --color-chart-6: #ec4899; + --color-chart-7: #14b8a6; + --color-chart-8: #6366f1; +} + +/* Custom scrollbar */ +::-webkit-scrollbar { + width: 8px; + height: 8px; +} + +::-webkit-scrollbar-track { + background: oklch(var(--b2)); +} + +::-webkit-scrollbar-thumb { + background: oklch(var(--b3)); + border-radius: 4px; +} + +::-webkit-scrollbar-thumb:hover { + background: oklch(var(--bc) / 0.3); +} + +/* Recharts overrides for theme compatibility */ +.recharts-cartesian-grid-horizontal line, +.recharts-cartesian-grid-vertical line { + stroke: oklch(var(--b3)); +} + +.recharts-text, +.recharts-cartesian-axis-tick-value { + fill: oklch(var(--bc) / 0.7) !important; +} + +.recharts-legend-item-text { + color: oklch(var(--bc)) !important; +} + +.recharts-legend-wrapper { + color: oklch(var(--bc)) !important; +} + +.recharts-tooltip-wrapper .recharts-default-tooltip { + background-color: oklch(var(--b2)) !important; + border: 1px solid oklch(var(--b3)) !important; + border-radius: 0.5rem; +} + +.recharts-tooltip-label { + color: oklch(var(--bc)) !important; +} + +.recharts-tooltip-item { + color: oklch(var(--bc)) !important; +} + +.recharts-tooltip-item-name, +.recharts-tooltip-item-value { + color: oklch(var(--bc)) !important; +} + +/* Sidebar transition */ +.sidebar-collapsed { + width: 4rem !important; +} + +.sidebar-collapsed .sidebar-text { + display: none; +} + +.sidebar-collapsed .sidebar-logo-text { + display: none; +} diff --git a/examples/demo/frontend/src/lib/chartColors.ts b/examples/demo/frontend/src/lib/chartColors.ts new file mode 100644 index 0000000..fbaaa33 --- /dev/null +++ b/examples/demo/frontend/src/lib/chartColors.ts @@ -0,0 +1,141 @@ +/** + * Chart color palette for consistent styling across all charts. + * + * These colors are chosen to be visible in both light and dark themes. + * Use these instead of CSS variables (oklch) which don't work reliably in Recharts. + */ + +// Primary chart colors (for common use cases) +export const CHART_COLORS = { + // Data visualization primary colors + actual: "#22c55e", // Green - for actual/realized values + forecast: "#94a3b8", // Slate - for forecast/predicted values + primary: "#3b82f6", // Blue - primary highlight + secondary: "#8b5cf6", // Purple - secondary highlight + warning: "#eab308", // Yellow - warning/caution + error: "#ef4444", // Red - errors/negative + + // Day-Ahead vs Real-Time + dayAhead: "#3b82f6", // Blue + realTime: "#22c55e", // Green + + // Grid and axis colors (work in both themes) + grid: "#d1d5db", // Light gray + gridDark: "#374151", // Dark gray (for dark mode) + axis: "#6b7280", // Medium gray + text: "#374151", // Dark gray text + textLight: "#9ca3af", // Light gray text +}; + +// Location-specific colors (for price charts by location) +export const LOCATION_COLORS: Record = { + // Load Zones + LZ_HOUSTON: "#ef4444", // Red + LZ_NORTH: "#3b82f6", // Blue + LZ_SOUTH: "#22c55e", // Green + LZ_WEST: "#eab308", // Yellow + LZ_AEN: "#a855f7", // Purple + LZ_CPS: "#f97316", // Orange + LZ_RAYBN: "#06b6d4", // Cyan + LZ_LCRA: "#ec4899", // Pink + + // Trading Hubs + HB_HOUSTON: "#dc2626", // Red (darker) + HB_NORTH: "#2563eb", // Blue (darker) + HB_SOUTH: "#16a34a", // Green (darker) + HB_WEST: "#ca8a04", // Yellow (darker) + HB_PAN: "#9333ea", // Purple (darker) + HB_BUSAVG: "#ea580c", // Orange (darker) + HB_HUBAVG: "#0891b2", // Cyan (darker) + + // DC Ties + DC_E: "#7c3aed", // Violet + DC_L: "#059669", // Emerald + DC_N: "#0284c7", // Sky + DC_R: "#d946ef", // Fuchsia + DC_S: "#65a30d", // Lime +}; + +// Fuel type colors +export const FUEL_COLORS: Record = { + Wind: "#22c55e", // Green + Solar: "#eab308", // Yellow + Nuclear: "#a855f7", // Purple + Coal: "#78716c", // Stone + Gas: "#f97316", // Orange + "Natural Gas": "#f97316", // Orange + Hydro: "#06b6d4", // Cyan + Other: "#6b7280", // Gray +}; + +// Chart area fill colors (with transparency) +export const FILL_COLORS = { + primary: "rgba(59, 130, 246, 0.2)", // Blue 20% + success: "rgba(34, 197, 94, 0.2)", // Green 20% + warning: "rgba(234, 179, 8, 0.2)", // Yellow 20% + error: "rgba(239, 68, 68, 0.2)", // Red 20% +}; + +/** + * Get color for a location, with fallback + */ +export function getLocationColor(location: string): string { + return LOCATION_COLORS[location] || "#6b7280"; +} + +/** + * Get color for a fuel type, with fallback + */ +export function getFuelColor(fuelType: string): string { + return FUEL_COLORS[fuelType] || "#6b7280"; +} + +/** + * Theme-aware colors for Recharts components. + * Use this to get colors that work correctly in both light and dark modes. + */ +export type ChartTheme = "light" | "dark"; + +export interface ChartThemeColors { + // Tooltip styling + tooltipBg: string; + tooltipBorder: string; + tooltipText: string; + + // Grid and axis + grid: string; + axisText: string; + axisLine: string; + + // Legend + legendText: string; +} + +export function getChartThemeColors(theme: ChartTheme): ChartThemeColors { + if (theme === "dark") { + return { + tooltipBg: "#1f2937", // gray-800 + tooltipBorder: "#374151", // gray-700 + tooltipText: "#f3f4f6", // gray-100 + + grid: "#374151", // gray-700 + axisText: "#9ca3af", // gray-400 + axisLine: "#4b5563", // gray-600 + + legendText: "#f3f4f6", // gray-100 + }; + } + + // Light mode + return { + tooltipBg: "#ffffff", // white + tooltipBorder: "#e5e7eb", // gray-200 + tooltipText: "#1f2937", // gray-800 + + grid: "#e5e7eb", // gray-200 + axisText: "#6b7280", // gray-500 + axisLine: "#d1d5db", // gray-300 + + legendText: "#374151", // gray-700 + }; +} diff --git a/examples/demo/frontend/src/lib/time.ts b/examples/demo/frontend/src/lib/time.ts new file mode 100644 index 0000000..aaef1ac --- /dev/null +++ b/examples/demo/frontend/src/lib/time.ts @@ -0,0 +1,58 @@ +/** + * Format a timestamp with timezone indicator + */ +export function formatTimestamp(date: Date | string | null | undefined, timezone: string = "America/Chicago"): string { + if (!date) return ""; + + const d = typeof date === "string" ? new Date(date) : date; + if (isNaN(d.getTime())) return ""; + + const tzAbbr = getTimezoneAbbr(timezone); + + return d.toLocaleString("en-US", { + timeZone: timezone, + month: "short", + day: "numeric", + hour: "2-digit", + minute: "2-digit", + }) + ` ${tzAbbr}`; +} + +/** + * Get current time formatted with timezone + */ +export function getCurrentTime(timezone: string = "America/Chicago"): string { + return formatTimestamp(new Date(), timezone); +} + +/** + * Get timezone abbreviation + */ +export function getTimezoneAbbr(timezone: string): string { + const abbrs: Record = { + "America/Chicago": "CT", + "America/New_York": "ET", + "America/Los_Angeles": "PT", + "America/Denver": "MT", + "UTC": "UTC", + }; + return abbrs[timezone] || timezone.split("/").pop() || ""; +} + +/** + * Format just the time portion with timezone + */ +export function formatTime(date: Date | string | null | undefined, timezone: string = "America/Chicago"): string { + if (!date) return ""; + + const d = typeof date === "string" ? new Date(date) : date; + if (isNaN(d.getTime())) return ""; + + const tzAbbr = getTimezoneAbbr(timezone); + + return d.toLocaleTimeString("en-US", { + timeZone: timezone, + hour: "2-digit", + minute: "2-digit", + }) + ` ${tzAbbr}`; +} diff --git a/examples/demo/frontend/src/lib/utils.ts b/examples/demo/frontend/src/lib/utils.ts new file mode 100644 index 0000000..4aab80e --- /dev/null +++ b/examples/demo/frontend/src/lib/utils.ts @@ -0,0 +1,52 @@ +import { type ClassValue, clsx } from "clsx"; +import { twMerge } from "tailwind-merge"; + +export function cn(...inputs: ClassValue[]) { + return twMerge(clsx(inputs)); +} + +export function formatNumber(value: number, decimals = 0): string { + return new Intl.NumberFormat("en-US", { + minimumFractionDigits: decimals, + maximumFractionDigits: decimals, + }).format(value); +} + +export function formatMW(value: number): string { + return `${formatNumber(value)} MW`; +} + +export function formatPrice(value: number): string { + return `$${formatNumber(value, 2)}`; +} + +export function formatPercentage(value: number): string { + return `${formatNumber(value, 1)}%`; +} + +export function formatDate(dateString: string): string { + const date = new Date(dateString); + return date.toLocaleDateString("en-US", { + month: "short", + day: "numeric", + year: "numeric", + }); +} + +export function formatTime(dateString: string): string { + const date = new Date(dateString); + return date.toLocaleTimeString("en-US", { + hour: "2-digit", + minute: "2-digit", + }); +} + +export function formatDateTime(dateString: string): string { + const date = new Date(dateString); + return date.toLocaleString("en-US", { + month: "short", + day: "numeric", + hour: "2-digit", + minute: "2-digit", + }); +} diff --git a/examples/demo/frontend/src/main.tsx b/examples/demo/frontend/src/main.tsx new file mode 100644 index 0000000..12fa35b --- /dev/null +++ b/examples/demo/frontend/src/main.tsx @@ -0,0 +1,10 @@ +import { StrictMode } from "react"; +import { createRoot } from "react-dom/client"; +import "./index.css"; +import App from "./App"; + +createRoot(document.getElementById("root")!).render( + + + +); diff --git a/examples/demo/frontend/src/pages/Dashboard.tsx b/examples/demo/frontend/src/pages/Dashboard.tsx new file mode 100644 index 0000000..573d9ec --- /dev/null +++ b/examples/demo/frontend/src/pages/Dashboard.tsx @@ -0,0 +1,678 @@ +import { useMemo, useState } from "react"; +import { + XAxis, + YAxis, + CartesianGrid, + Tooltip, + ResponsiveContainer, + AreaChart, + Area, + LineChart, + Line, + Legend, +} from "recharts"; +import { useSPP, useLoadForecast, useWindForecast, useSolarForecast, useFuelMixRealtime, useLMPCombined } from "../api"; +import { + Card, + CardHeader, + CardTitle, + CardContent, + Loading, +} from "../components"; +import { useTheme } from "../context/ThemeContext"; +import { formatNumber } from "../lib/utils"; +import { getChartThemeColors } from "../lib/chartColors"; +import { Zap, Activity, TrendingUp, RefreshCw, DollarSign, Clock } from "lucide-react"; + +const TIMEZONE = "America/Chicago"; + +// Format time for display +function formatTimeDisplay(date: Date | string): string { + const d = typeof date === "string" ? new Date(date) : date; + return d.toLocaleTimeString("en-US", { + timeZone: TIMEZONE, + hour: "numeric", + minute: "2-digit", + }); +} + +// Get current time in CT +function getCurrentTimeCT(): string { + return new Date().toLocaleString("en-US", { + timeZone: TIMEZONE, + month: "short", + day: "numeric", + hour: "numeric", + minute: "2-digit", + }) + " CT"; +} + +// Stat card component +function StatCard({ + label, + value, + unit, + description, + icon: Icon, +}: { + label: string; + value: string | number; + unit?: string; + description?: string; + icon?: React.ComponentType<{ className?: string }>; +}) { + return ( +
+
+ {Icon && } +
+
{label}
+
+ {typeof value === 'number' ? formatNumber(value) : value} + {unit && {unit}} +
+ {description &&
{description}
} +
+ ); +} + +// Key Metrics Row +function KeyMetrics() { + const { data: loadData, isLoading: loadLoading } = useLoadForecast({ start: "today", by: "weather_zone" }); + const { data: windData, isLoading: windLoading } = useWindForecast({ start: "today", resolution: "hourly" }); + const { data: solarData, isLoading: solarLoading } = useSolarForecast({ start: "today", resolution: "hourly" }); + const { data: sppData, isLoading: sppLoading } = useSPP({ start: "today", market: "real_time_15_min", location_type: "load_zone" }); + + const isLoading = loadLoading || windLoading || solarLoading || sppLoading; + + const stats = useMemo(() => { + // Get current hour in CT + const now = new Date(); + const ctHour = parseInt(now.toLocaleString("en-US", { timeZone: TIMEZONE, hour: "numeric", hour12: false })); + + // Get load for current hour + let load = 0; + if (loadData?.data && loadData.data.length > ctHour) { + load = Number(loadData.data[ctHour]?.["System Total"] || 0); + } + + // Get wind for current hour + let windGen = 0; + if (windData?.data && windData.data.length > ctHour) { + const rec = windData.data[ctHour]; + const gen = rec?.["Generation System Wide"]; + windGen = (gen !== null && gen !== undefined && !Number.isNaN(Number(gen))) + ? Number(gen) + : Number(rec?.["STWPF System Wide"] || 0); + } + + // Get solar for current hour + let solarGen = 0; + if (solarData?.data && solarData.data.length > ctHour) { + const rec = solarData.data[ctHour]; + const gen = rec?.["Generation System Wide"]; + solarGen = (gen !== null && gen !== undefined && !Number.isNaN(Number(gen))) + ? Number(gen) + : Number(rec?.["STPPF System Wide"] || 0); + } + + const netLoad = Math.max(0, load - windGen - solarGen); + + // Get current average price - find latest time + let avgPrice = 0; + if (sppData?.data) { + const latestByLocation = new Map(); + for (const record of sppData.data) { + const location = String(record["Location"] || ""); + const price = Number(record["Price"] || 0); + const time = String(record["Time"] || ""); + if (location && time) { + const existing = latestByLocation.get(location); + if (!existing || time > existing.time) { + latestByLocation.set(location, { price, time }); + } + } + } + const prices = Array.from(latestByLocation.values()).map(v => v.price); + avgPrice = prices.length > 0 ? prices.reduce((a, b) => a + b, 0) / prices.length : 0; + } + + return { load, netLoad, windGen, solarGen, avgPrice }; + }, [loadData, windData, solarData, sppData]); + + if (isLoading) { + return ( +
+ {[...Array(4)].map((_, i) => ( +
+ ))} +
+ ); + } + + return ( +
+ + + + +
+ ); +} + +// Fuel type colors +const FUEL_COLORS: Record = { + "nuclear": "#86efac", + "coal": "#f97316", + "coal and lignite": "#f97316", + "gas": "#3b82f6", + "natural gas": "#3b82f6", + "wind": "#22c55e", + "solar": "#eab308", + "hydro": "#60a5fa", + "other": "#ec4899", +}; + +// Stacked Generation Mix Chart - time series like GridStatus +function GenerationMixChart() { + const { theme } = useTheme(); + const themeColors = getChartThemeColors(theme); + const { data: loadData, isLoading: loadLoading } = useLoadForecast({ start: "today", by: "weather_zone" }); + const { data: windData, isLoading: windLoading } = useWindForecast({ start: "today", resolution: "hourly" }); + const { data: solarData, isLoading: solarLoading } = useSolarForecast({ start: "today", resolution: "hourly" }); + const { data: fuelMix, refetch } = useFuelMixRealtime(); + + const isLoading = loadLoading || windLoading || solarLoading; + + // Build hourly time series data for generation mix + const chartData = useMemo(() => { + if (!loadData?.data) return []; + + const now = new Date(); + const ctHour = parseInt(now.toLocaleString("en-US", { timeZone: TIMEZONE, hour: "numeric", hour12: false })); + const hoursToShow = Math.min(ctHour + 1, 24); + + // Get current fuel mix ratios for baseload (nuclear, coal) + let nuclearRatio = 0.09; // Default ~9% + let coalRatio = 0.14; // Default ~14% + + if (fuelMix?.entries) { + const total = fuelMix.total_generation_mw || 1; + for (const e of fuelMix.entries) { + const ft = e.fuel_type.toLowerCase(); + if (ft === "nuclear") nuclearRatio = e.generation_mw / total; + if (ft.includes("coal")) coalRatio = e.generation_mw / total; + } + } + + return Array.from({ length: hoursToShow }, (_, hour) => { + const loadRec = loadData.data[hour]; + const windRec = windData?.data?.[hour]; + const solarRec = solarData?.data?.[hour]; + + const load = loadRec ? Number(loadRec["System Total"] || 0) : 0; + + let wind = 0; + if (windRec) { + const gen = windRec["Generation System Wide"]; + wind = (gen !== null && gen !== undefined && !Number.isNaN(Number(gen))) + ? Number(gen) + : Number(windRec["STWPF System Wide"] || 0); + } + + let solar = 0; + if (solarRec) { + const gen = solarRec["Generation System Wide"]; + solar = (gen !== null && gen !== undefined && !Number.isNaN(Number(gen))) + ? Number(gen) + : Number(solarRec["STPPF System Wide"] || 0); + } + + // Estimate baseload from current mix ratios + const nuclear = load * nuclearRatio; + const coal = load * coalRatio; + + // Gas fills the gap + const gas = Math.max(0, load - wind - solar - nuclear - coal); + + return { + hour, + time: `${hour}:00`, + nuclear: nuclear / 1000, // Convert to GW + coal: coal / 1000, + gas: gas / 1000, + wind: wind / 1000, + solar: solar / 1000, + total: load / 1000, + }; + }); + }, [loadData, windData, solarData, fuelMix]); + + if (isLoading) return ; + if (chartData.length === 0) return null; + + const latestHour = chartData[chartData.length - 1]; + + return ( + + +
+
+ + Fuel Mix +
+
+
+ + {getCurrentTimeCT()} +
+ +
+
+ + +
+ + + + `${v}h`} + /> + `${v.toFixed(0)}`} + axisLine={false} + tickLine={false} + width={35} + label={{ value: "GW", angle: -90, position: "insideLeft", style: { fontSize: 10, fill: themeColors.axisText } }} + /> + [`${Number(value ?? 0).toFixed(2)} GW`]} + labelFormatter={(label) => `${label}:00 CT`} + contentStyle={{ + backgroundColor: themeColors.tooltipBg, + border: `1px solid ${themeColors.tooltipBorder}`, + borderRadius: "0.5rem", + color: themeColors.tooltipText, + }} + labelStyle={{ color: themeColors.tooltipText }} + itemStyle={{ color: themeColors.tooltipText }} + /> + + + + + + + + +
+ + {/* Current totals summary */} + {latestHour && ( +
+
Current ({latestHour.hour}:00 CT): Total {latestHour.total.toFixed(1)} GW
+
+ Gas {latestHour.gas.toFixed(1)} GW + Wind {latestHour.wind.toFixed(1)} GW + Coal {latestHour.coal.toFixed(1)} GW + Solar {latestHour.solar.toFixed(1)} GW + Nuclear {latestHour.nuclear.toFixed(1)} GW +
+
+ )} + + + ); +} + +type LocationType = "load_zone" | "trading_hub" | "dc_tie"; + +// Combined DA + RT LMP Price Chart like GridStatus +function LMPPriceChart() { + const { theme } = useTheme(); + const themeColors = getChartThemeColors(theme); + const [locationType, setLocationType] = useState("load_zone"); + const [selectedLocation, setSelectedLocation] = useState(""); + + const { data: lmpData, isLoading, error, refetch } = useLMPCombined({ + location_type: locationType, + location: selectedLocation || undefined, + }); + + // Process data for chart - combine RT and DA by time + const { chartData, locations } = useMemo(() => { + if (!lmpData?.data) return { chartData: [], locations: lmpData?.locations || [] }; + + // Group by time, then calculate RT and DA averages per hour + const byHour = new Map(); + + for (const record of lmpData.data) { + const timeStr = record.time; + if (!timeStr) continue; + + // Parse time to get hour + const d = new Date(timeStr); + const hour = d.getHours(); + + if (!byHour.has(hour)) { + byHour.set(hour, { rt: [], da: [] }); + } + + const hourData = byHour.get(hour)!; + if (record.rt_price !== null && record.rt_price > 0) { + hourData.rt.push(record.rt_price); + } + if (record.da_price !== null && record.da_price > 0) { + hourData.da.push(record.da_price); + } + } + + // Build chart data + const hours = Array.from(byHour.keys()).sort((a, b) => a - b); + const chartData = hours.map(hour => { + const data = byHour.get(hour)!; + return { + hour, + time: `${hour}:00`, + rt: data.rt.length > 0 ? data.rt.reduce((a, b) => a + b, 0) / data.rt.length : null, + da: data.da.length > 0 ? data.da.reduce((a, b) => a + b, 0) / data.da.length : null, + }; + }); + + return { chartData, locations: lmpData?.locations || [] }; + }, [lmpData]); + + // Update selected location when locations change + useMemo(() => { + if (locations.length > 0 && !selectedLocation) { + // Default to first load zone (usually LZ_WEST or similar) + const defaultLoc = locations.find(l => l.startsWith("LZ_")) || locations[0]; + setSelectedLocation(defaultLoc); + } + }, [locations, selectedLocation]); + + return ( + + +
+
+ + Locational Marginal Price +
+
+ {lmpData?.latest_rt_time && ( +
+ + RT: {lmpData.latest_rt_time} +
+ )} + +
+
+ + + {/* Selectors */} +
+
+ + +
+
+ + +
+
+ + {isLoading ? ( + + ) : error ? ( +

Failed to load LMP data

+ ) : chartData.length === 0 ? ( +

No price data available

+ ) : ( +
+ + + + { + if (v === 0) return "12a"; + if (v === 12) return "12p"; + if (v < 12) return `${v}a`; + return `${v - 12}p`; + }} + /> + `$${v}`} + axisLine={false} + tickLine={false} + width={45} + domain={["auto", "auto"]} + /> + { + const label = name === "da" ? "Day Ahead" : "Real Time"; + return [`$${Number(value ?? 0).toFixed(2)}`, label]; + }} + labelFormatter={(label) => { + const hour = Number(label); + const ampm = hour >= 12 ? "PM" : "AM"; + const h = hour % 12 || 12; + return `${h}:00 ${ampm} CT`; + }} + contentStyle={{ + backgroundColor: themeColors.tooltipBg, + border: `1px solid ${themeColors.tooltipBorder}`, + borderRadius: "0.5rem", + color: themeColors.tooltipText, + }} + labelStyle={{ color: themeColors.tooltipText }} + itemStyle={{ color: themeColors.tooltipText }} + /> + { + const label = value === "da" ? "Day Ahead" : "Real Time"; + return {label}; + }} + /> + + + + +
+ )} + + {/* Legend explanation */} +
+
+
+ Day Ahead (hourly) +
+
+
+ Real Time (SCED, ~5 min) +
+
+ + + ); +} + +// Prices Table +function PricesTable() { + const { data: sppData, isLoading } = useSPP({ + start: "today", + market: "real_time_15_min", + location_type: "load_zone" + }); + + const { latestPrices, latestTime } = useMemo(() => { + if (!sppData?.data) return { latestPrices: [], latestTime: null }; + + const byLocation = new Map(); + for (const record of sppData.data) { + const location = String(record["Location"] || ""); + const price = Number(record["Price"] || 0); + const time = String(record["Time"] || ""); + if (location && time) { + const existing = byLocation.get(location); + if (!existing || time > existing.time) { + byLocation.set(location, { price, time }); + } + } + } + + const latestPrices = Array.from(byLocation.entries()) + .map(([location, { price, time }]) => ({ location, price, time })) + .sort((a, b) => b.price - a.price); + + const latestTime = latestPrices[0]?.time + ? formatTimeDisplay(latestPrices[0].time) + " CT" + : null; + + return { latestPrices, latestTime }; + }, [sppData]); + + if (isLoading) return ; + if (latestPrices.length === 0) return null; + + return ( + + +
+ Load Zone Prices + {latestTime && ( +
+ + {latestTime} +
+ )} +
+ + +
+ + + + + + + + + {latestPrices.map(({ location, price }) => ( + + + + + ))} + +
ZonePrice
{location}${price.toFixed(2)}
+
+ + + ); +} + +export function Dashboard() { + return ( +
+ {/* Header */} +
+
+

Grid Overview

+

Real-time conditions

+
+
+ + {getCurrentTimeCT()} +
+
+ + {/* Key Metrics */} + + + {/* Generation Mix Chart */} + + + {/* LMP Chart and Prices Table */} +
+
+ +
+ +
+
+ ); +} diff --git a/examples/demo/frontend/src/pages/Forecasts.tsx b/examples/demo/frontend/src/pages/Forecasts.tsx new file mode 100644 index 0000000..aaad2b8 --- /dev/null +++ b/examples/demo/frontend/src/pages/Forecasts.tsx @@ -0,0 +1,569 @@ +import { useState, useMemo } from "react"; +import { + LineChart, + Line, + XAxis, + YAxis, + CartesianGrid, + Tooltip, + Legend, + ResponsiveContainer, + AreaChart, + Area, +} from "recharts"; +import { useLoad, useWindForecast, useSolarForecast } from "../api"; +import { + Card, + CardHeader, + CardTitle, + CardContent, + CardDescription, + Loading, + ErrorCard, +} from "../components"; +import { useTheme } from "../context/ThemeContext"; +import { formatMW, formatNumber } from "../lib/utils"; +import { formatTime } from "../lib/time"; +import { CHART_COLORS, FILL_COLORS, getChartThemeColors } from "../lib/chartColors"; +import { Wind, Sun, Gauge, Clock } from "lucide-react"; + +const TIMEZONE = "America/Chicago"; + +// Timestamp badge component +function TimestampBadge({ timestamp, label }: { timestamp?: string | null; label?: string }) { + const formattedTime = timestamp ? formatTime(timestamp, TIMEZONE) : ""; + if (!formattedTime) return null; + return ( +
+ + {label ? `${label}: ` : ""}{formattedTime} +
+ ); +} + +type ZoneType = "weather_zone" | "forecast_zone"; +type Resolution = "hourly" | "5min"; + +function LoadCard() { + const { theme } = useTheme(); + const themeColors = getChartThemeColors(theme); + const [zoneType, setZoneType] = useState("weather_zone"); + const [startDate, setStartDate] = useState("yesterday"); + + const { data: loadData, isLoading, error, refetch } = useLoad({ + start: startDate, + by: zoneType, + }); + + const chartData = loadData?.data + ? loadData.data.slice(0, 50).map((record, idx) => ({ + index: idx, + load: Number(record["Total"] || record["total"] || 0), + operatingDay: String(record["Operating Day"] || ""), + hour: idx, + })) + : []; + + // Get latest timestamp + const latestTime = loadData?.data?.[loadData.data.length - 1]?.["Operating Day"] as string | undefined; + + return ( + + +
+
+ + System Load +
+ +
+ + {loadData?.count ? `${formatNumber(loadData.count)} records` : "Loading..."} + + + + {/* Filters */} +
+
+ + +
+
+ + +
+
+ + {isLoading ? ( + + ) : error ? ( + refetch()} + /> + ) : chartData.length > 0 ? ( +
+ + + + + `${(value / 1000).toFixed(0)}k`} + axisLine={false} + tickLine={false} + /> + formatMW(Number(value ?? 0))} + labelFormatter={(_, payload) => `Date: ${payload?.[0]?.payload?.operatingDay || ""}`} + contentStyle={{ + backgroundColor: themeColors.tooltipBg, + border: `1px solid ${themeColors.tooltipBorder}`, + borderRadius: "0.5rem", + color: themeColors.tooltipText, + }} + labelStyle={{ color: themeColors.tooltipText }} + itemStyle={{ color: themeColors.tooltipText }} + /> + + + + +
+ ) : ( +

+ No load data available +

+ )} + + + ); +} + +function WindForecastCard() { + const { theme } = useTheme(); + const themeColors = getChartThemeColors(theme); + const [resolution, setResolution] = useState("hourly"); + const [byRegion, setByRegion] = useState(false); + const [startDate, setStartDate] = useState("today"); + + const { data: windData, isLoading, error, refetch } = useWindForecast({ + start: startDate, + resolution, + by_region: byRegion, + }); + + // Process chart data with flexible column name matching + const { chartData, latestTime, hasData } = useMemo(() => { + if (!windData?.data || windData.data.length === 0) { + return { chartData: [], latestTime: null, hasData: false }; + } + + // Find the correct column names (they may vary) + const firstRecord = windData.data[0]; + const keys = Object.keys(firstRecord); + + // Try different possible column names for actual generation + const actualKey = + keys.find( + (k) => + k.toLowerCase().includes("generation") || + k.toLowerCase().includes("actual") || + k === "System Wide" + ) || "Generation System Wide"; + + // Try different possible column names for forecast + const forecastKey = + keys.find( + (k) => + k.toLowerCase().includes("stwpf") || + k.toLowerCase().includes("forecast") || + k.toLowerCase().includes("stppf") + ) || "STWPF System Wide"; + + // Try different possible column names for time + const timeKey = + keys.find((k) => k.toLowerCase().includes("time") || k.toLowerCase().includes("hour")) || + "Time"; + + const data = windData.data.slice(0, 100).map((record, idx) => { + const actualVal = Number(record[actualKey] || 0); + const forecastVal = Number(record[forecastKey] || 0); + + return { + index: idx, + actual: actualVal, + forecast: forecastVal, + time: String(record[timeKey] || ""), + hour: idx, + }; + }); + + // Filter out records where both values are 0 (no real data) + const hasRealData = data.some((d) => d.actual > 0 || d.forecast > 0); + + const lastTime = windData.data[windData.data.length - 1]?.[timeKey] as string | undefined; + + return { chartData: data, latestTime: lastTime, hasData: hasRealData }; + }, [windData]); + + return ( + + +
+
+ + Wind Forecast +
+ +
+ + {windData?.count ? `${formatNumber(windData.count)} records` : "Loading..."} + + + + {/* Filters */} +
+
+ + +
+
+ + +
+
+ +
+
+ + {isLoading ? ( + + ) : error ? ( + refetch()} + /> + ) : chartData.length > 0 && hasData ? ( +
+ + + + + `${(value / 1000).toFixed(0)}k`} + axisLine={false} + tickLine={false} + domain={[0, "auto"]} + /> + formatMW(Number(value ?? 0))} + contentStyle={{ + backgroundColor: themeColors.tooltipBg, + border: `1px solid ${themeColors.tooltipBorder}`, + borderRadius: "0.5rem", + color: themeColors.tooltipText, + }} + labelStyle={{ color: themeColors.tooltipText }} + itemStyle={{ color: themeColors.tooltipText }} + /> + + + + + +
+ ) : ( +

+ No wind forecast data available +

+ )} + + + ); +} + +function SolarForecastCard() { + const { theme } = useTheme(); + const themeColors = getChartThemeColors(theme); + const [resolution, setResolution] = useState("hourly"); + const [byRegion, setByRegion] = useState(false); + const [startDate, setStartDate] = useState("today"); + + const { data: solarData, isLoading, error, refetch } = useSolarForecast({ + start: startDate, + resolution, + by_region: byRegion, + }); + + // Process chart data with flexible column name matching + const { chartData, latestTime, hasData } = useMemo(() => { + if (!solarData?.data || solarData.data.length === 0) { + return { chartData: [], latestTime: null, hasData: false }; + } + + // Find the correct column names (they may vary) + const firstRecord = solarData.data[0]; + const keys = Object.keys(firstRecord); + + // Try different possible column names for actual generation + const actualKey = + keys.find( + (k) => + k.toLowerCase().includes("generation") || + k.toLowerCase().includes("actual") || + k === "System Wide" + ) || "Generation System Wide"; + + // Try different possible column names for forecast (STPPF for solar) + const forecastKey = + keys.find((k) => k.toLowerCase().includes("stppf") || k.toLowerCase().includes("forecast")) || + "STPPF System Wide"; + + // Try different possible column names for time + const timeKey = + keys.find((k) => k.toLowerCase().includes("time") || k.toLowerCase().includes("hour")) || + "Time"; + + const data = solarData.data.slice(0, 100).map((record, idx) => { + const actualVal = Number(record[actualKey] || 0); + const forecastVal = Number(record[forecastKey] || 0); + + return { + index: idx, + actual: actualVal, + forecast: forecastVal, + time: String(record[timeKey] || ""), + hour: idx, + }; + }); + + // Filter out records where both values are 0 (no real data) + const hasRealData = data.some((d) => d.actual > 0 || d.forecast > 0); + + const lastTime = solarData.data[solarData.data.length - 1]?.[timeKey] as string | undefined; + + return { chartData: data, latestTime: lastTime, hasData: hasRealData }; + }, [solarData]); + + return ( + + +
+
+ + Solar Forecast +
+ +
+ + {solarData?.count ? `${formatNumber(solarData.count)} records` : "Loading..."} + + + + {/* Filters */} +
+
+ + +
+
+ + +
+
+ +
+
+ + {isLoading ? ( + + ) : error ? ( + refetch()} + /> + ) : chartData.length > 0 && hasData ? ( +
+ + + + + `${(value / 1000).toFixed(0)}k`} + axisLine={false} + tickLine={false} + domain={[0, "auto"]} + /> + formatMW(Number(value ?? 0))} + contentStyle={{ + backgroundColor: themeColors.tooltipBg, + border: `1px solid ${themeColors.tooltipBorder}`, + borderRadius: "0.5rem", + color: themeColors.tooltipText, + }} + labelStyle={{ color: themeColors.tooltipText }} + itemStyle={{ color: themeColors.tooltipText }} + /> + + + + + +
+ ) : ( +

+ No solar forecast data available +

+ )} + + + ); +} + +export function Forecasts() { + return ( +
+
+

Load & Renewable Forecasts

+

System load and renewable generation data

+
+ + + +
+ + +
+
+ ); +} diff --git a/examples/demo/frontend/src/pages/Historical.tsx b/examples/demo/frontend/src/pages/Historical.tsx new file mode 100644 index 0000000..30112ec --- /dev/null +++ b/examples/demo/frontend/src/pages/Historical.tsx @@ -0,0 +1,390 @@ +import { useState, useMemo } from "react"; +import { useHistoricalEndpoints, useHistorical } from "../api"; +import { + Card, + CardHeader, + CardTitle, + CardContent, + Loading, + ErrorCard, +} from "../components"; +import { formatNumber } from "../lib/utils"; +import { Database, Download, Search, Calendar, FileText, ChevronRight } from "lucide-react"; + +function EndpointSelector({ + endpoints, + selected, + onSelect +}: { + endpoints: { name: string; description: string; path: string }[]; + selected: string; + onSelect: (name: string) => void; +}) { + const [searchQuery, setSearchQuery] = useState(""); + + const filteredEndpoints = useMemo(() => { + if (!searchQuery) return endpoints; + const query = searchQuery.toLowerCase(); + return endpoints.filter(ep => + ep.name.toLowerCase().includes(query) || + ep.description.toLowerCase().includes(query) + ); + }, [endpoints, searchQuery]); + + return ( +
+ {/* Search */} +
+ +
+ + {/* Endpoint List */} +
+ {filteredEndpoints.map((ep) => ( + + ))} + {filteredEndpoints.length === 0 && ( +
+

No endpoints found

+
+ )} +
+
+ ); +} + +function DateRangePicker({ + startDate, + endDate, + onStartChange, + onEndChange, +}: { + startDate: string; + endDate: string; + onStartChange: (date: string) => void; + onEndChange: (date: string) => void; +}) { + const presets = [ + { label: "7 days", days: 7 }, + { label: "30 days", days: 30 }, + { label: "90 days", days: 90 }, + ]; + + const applyPreset = (days: number) => { + const end = new Date(); + const start = new Date(); + start.setDate(start.getDate() - days); + onStartChange(start.toISOString().split('T')[0]); + onEndChange(end.toISOString().split('T')[0]); + }; + + return ( +
+ {/* Presets */} +
+ {presets.map(({ label, days }) => ( + + ))} +
+ + {/* Date Inputs */} +
+
+ + +
+
+ + +
+
+
+ ); +} + +function DataTable({ + data, + columns +}: { + data: Record[]; + columns: string[]; +}) { + const displayColumns = columns.slice(0, 6); + const hasMore = columns.length > 6; + + return ( +
+ + + + {displayColumns.map((col) => ( + + ))} + {hasMore && } + + + + {data.slice(0, 100).map((row, idx) => ( + + {displayColumns.map((col) => ( + + ))} + {hasMore && } + + ))} + +
{col}+{columns.length - 6}
+ {String(row[col] ?? "—")} + ...
+
+ ); +} + +export function Historical() { + const [selectedEndpoint, setSelectedEndpoint] = useState(""); + const [startDate, setStartDate] = useState(""); + const [endDate, setEndDate] = useState(""); + const [shouldFetch, setShouldFetch] = useState(false); + + const { + data: endpointsData, + isLoading: endpointsLoading, + error: endpointsError, + } = useHistoricalEndpoints(); + + const { + data: historicalData, + isLoading: dataLoading, + error: dataError, + refetch, + } = useHistorical( + shouldFetch && selectedEndpoint && startDate && endDate + ? { endpoint: selectedEndpoint, start: startDate, end: endDate } + : null + ); + + const handleFetch = () => { + if (selectedEndpoint && startDate && endDate) { + setShouldFetch(true); + } + }; + + const handleExport = () => { + if (!historicalData?.data || historicalData.data.length === 0) return; + + const allKeys = new Set(); + historicalData.data.forEach((row) => { + Object.keys(row).forEach((key) => allKeys.add(key)); + }); + const headers = Array.from(allKeys); + + const csvRows = [ + headers.join(","), + ...historicalData.data.map((row) => + headers + .map((header) => { + const value = row[header]; + if (value === null || value === undefined) return ""; + const str = String(value); + if (str.includes(",") || str.includes('"') || str.includes("\n")) { + return `"${str.replace(/"/g, '""')}"`; + } + return str; + }) + .join(",") + ), + ]; + + const blob = new Blob([csvRows.join("\n")], { type: "text/csv;charset=utf-8;" }); + const link = document.createElement("a"); + link.href = URL.createObjectURL(blob); + link.download = `${selectedEndpoint}_${startDate}_${endDate}.csv`; + link.click(); + }; + + const columns = historicalData?.data && historicalData.data.length > 0 + ? Object.keys(historicalData.data[0]) + : []; + + const canFetch = selectedEndpoint && startDate && endDate; + + return ( +
+ {/* Header */} +
+

Historical Data

+

Query archive data (90+ days)

+
+ + {endpointsLoading ? ( + + ) : endpointsError ? ( + + ) : ( +
+ {/* Left Panel - Query Builder */} +
+ {/* Endpoint Selection */} + + +
+ + Select Endpoint +
+ + + { + setSelectedEndpoint(name); + setShouldFetch(false); + }} + /> + + + + {/* Date Range */} + + +
+ + Date Range +
+ + + { setStartDate(d); setShouldFetch(false); }} + onEndChange={(d) => { setEndDate(d); setShouldFetch(false); }} + /> + + + + {/* Fetch Button */} + +
+ + {/* Right Panel - Results */} +
+ + +
+
+ + Results +
+ {historicalData && ( +
+ + {formatNumber(historicalData.count)} records + + +
+ )} +
+ + + {!shouldFetch ? ( +
+ +

+ Select an endpoint and date range,
then click Fetch Data +

+
+ ) : dataLoading ? ( +
+ +
+ ) : dataError ? ( + refetch()} + /> + ) : historicalData?.data && historicalData.data.length > 0 ? ( + <> + + {historicalData.data.length > 100 && ( +

+ Showing 100 of {formatNumber(historicalData.data.length)} records • Export for full data +

+ )} + + ) : ( +
+

+ No data found for the selected range +

+
+ )} + + +
+
+ )} +
+ ); +} diff --git a/examples/demo/frontend/src/pages/Prices.tsx b/examples/demo/frontend/src/pages/Prices.tsx new file mode 100644 index 0000000..36f67df --- /dev/null +++ b/examples/demo/frontend/src/pages/Prices.tsx @@ -0,0 +1,471 @@ +import { useState, useMemo } from "react"; +import { + LineChart, + Line, + XAxis, + YAxis, + CartesianGrid, + Tooltip, + ResponsiveContainer, +} from "recharts"; +import { useLMPGrid, useSPPGrid, type PriceGridParams, type LocationPriceData } from "../api"; +import { + Card, + CardHeader, + CardTitle, + CardContent, + CardDescription, + Loading, + ErrorCard, +} from "../components"; +import { useTheme } from "../context/ThemeContext"; +import { formatPrice } from "../lib/utils"; +import { formatTime } from "../lib/time"; +import { getLocationColor, getChartThemeColors } from "../lib/chartColors"; +import { DollarSign, TrendingUp, Clock, RefreshCw, Calendar } from "lucide-react"; + +const TIMEZONE = "America/Chicago"; + +// Date range options +type DateRangeOption = "today" | "yesterday" | "3days" | "7days"; + +const DATE_RANGE_OPTIONS: { value: DateRangeOption; label: string }[] = [ + { value: "today", label: "Today" }, + { value: "yesterday", label: "Yesterday" }, + { value: "3days", label: "Last 3 Days" }, + { value: "7days", label: "Last 7 Days" }, +]; + +function getDateRange(option: DateRangeOption): { start: string; end?: string } { + const today = new Date(); + const formatDate = (d: Date) => d.toISOString().split("T")[0]; + + switch (option) { + case "today": + return { start: "today" }; + case "yesterday": + return { start: "yesterday", end: "today" }; + case "3days": { + const start = new Date(today); + start.setDate(start.getDate() - 3); + return { start: formatDate(start), end: formatDate(today) }; + } + case "7days": { + const start = new Date(today); + start.setDate(start.getDate() - 7); + return { start: formatDate(start), end: formatDate(today) }; + } + default: + return { start: "today" }; + } +} + +// Timestamp badge component +function TimestampBadge({ timestamp, label }: { timestamp?: string | null; label?: string }) { + const formattedTime = timestamp ? formatTime(timestamp, TIMEZONE) : ""; + if (!formattedTime) return null; + return ( +
+ + {label ? `${label}: ` : ""}{formattedTime} +
+ ); +} + +// Mini chart for a single location +function MiniPriceChart({ location }: { location: LocationPriceData }) { + const { theme } = useTheme(); + const themeColors = getChartThemeColors(theme); + const color = getLocationColor(location.location); + + // Get last 48 data points for display + const chartData = useMemo(() => { + const data = location.data.slice(-48); + return data.map((d, idx) => ({ + idx, + price: d.price, + time: d.time, + })); + }, [location.data]); + + const locationTypeLabel = { + load_zone: "Load Zone", + trading_hub: "Hub", + dc_tie: "DC Tie", + unknown: "", + }[location.location_type]; + + return ( +
+
+
+ + {location.location} + {locationTypeLabel} +
+
+
+ {location.latest_price !== null ? formatPrice(location.latest_price) : "—"} +
+
+
+ + {/* Mini chart */} +
+ + + + { + // Show time label for first and last point + if (val === 0 || val === chartData.length - 1) { + const point = chartData[val]; + if (point?.time) { + const t = new Date(point.time); + return t.toLocaleTimeString("en-US", { + hour: "numeric", + minute: "2-digit", + timeZone: TIMEZONE, + }); + } + } + return ""; + }} + interval="preserveStartEnd" + /> + `$${val.toFixed(0)}`} + domain={["auto", "auto"]} + width={25} + /> + [formatPrice(Number(value ?? 0)), "Price"]} + labelFormatter={(_, payload) => { + const time = payload?.[0]?.payload?.time; + return time ? formatTime(time, TIMEZONE) : ""; + }} + contentStyle={{ + backgroundColor: themeColors.tooltipBg, + border: `1px solid ${themeColors.tooltipBorder}`, + borderRadius: "0.375rem", + fontSize: "12px", + color: themeColors.tooltipText, + }} + labelStyle={{ color: themeColors.tooltipText }} + itemStyle={{ color: themeColors.tooltipText }} + /> + + + +
+ + {/* Stats row */} +
+ Low: {location.min_price !== null ? formatPrice(location.min_price) : "—"} + Avg: {location.avg_price !== null ? formatPrice(location.avg_price) : "—"} + High: {location.max_price !== null ? formatPrice(location.max_price) : "—"} +
+
+ ); +} + +// Price grid section +function PriceGridSection({ + title, + icon: Icon, + locations, + isLoading, + error, + onRefresh, + latestUpdate, +}: { + title: string; + icon: React.ComponentType<{ className?: string }>; + locations: LocationPriceData[]; + isLoading: boolean; + error: Error | null; + onRefresh: () => void; + latestUpdate: string | null; +}) { + // Group locations by type + const { loadZones, tradingHubs, dcTies } = useMemo(() => { + const loadZones: LocationPriceData[] = []; + const tradingHubs: LocationPriceData[] = []; + const dcTies: LocationPriceData[] = []; + + for (const loc of locations) { + if (loc.location_type === "load_zone") { + loadZones.push(loc); + } else if (loc.location_type === "trading_hub") { + tradingHubs.push(loc); + } else if (loc.location_type === "dc_tie") { + dcTies.push(loc); + } + } + + return { loadZones, tradingHubs, dcTies }; + }, [locations]); + + return ( + + +
+
+ + {title} +
+
+ + +
+
+ + {locations.length} locations + + + + {isLoading ? ( + + ) : error ? ( + + ) : locations.length === 0 ? ( +

+ No price data available +

+ ) : ( +
+ {/* Load Zones */} + {loadZones.length > 0 && ( +
+

Load Zones

+
+ {loadZones.map((loc) => ( + + ))} +
+
+ )} + + {/* Trading Hubs */} + {tradingHubs.length > 0 && ( +
+

Trading Hubs

+
+ {tradingHubs.map((loc) => ( + + ))} +
+
+ )} + + {/* DC Ties */} + {dcTies.length > 0 && ( +
+

DC Ties

+
+ {dcTies.map((loc) => ( + + ))} +
+
+ )} +
+ )} + + + ); +} + +// Main component +export function Prices() { + const [dateRange, setDateRange] = useState("today"); + const [sppMarket, setSppMarket] = useState<"real_time_15_min" | "day_ahead_hourly">("real_time_15_min"); + + const dateParams = getDateRange(dateRange); + + const lmpParams: PriceGridParams = { + start: dateParams.start, + end: dateParams.end, + }; + + const sppParams: PriceGridParams = { + start: dateParams.start, + end: dateParams.end, + market: sppMarket, + }; + + const { + data: lmpData, + isLoading: lmpLoading, + error: lmpError, + refetch: lmpRefetch, + } = useLMPGrid(lmpParams); + + const { + data: sppData, + isLoading: sppLoading, + error: sppError, + refetch: sppRefetch, + } = useSPPGrid(sppParams); + + return ( +
+ {/* Header with controls */} +
+
+

Electricity Prices

+

+ Real-time LMP and SPP data for all ERCOT locations +

+
+ + {/* Date range selector */} +
+ +
+ {DATE_RANGE_OPTIONS.map((opt) => ( + + ))} +
+
+
+ + {/* LMP Grid */} + lmpRefetch()} + latestUpdate={lmpData?.latest_update || null} + /> + + {/* SPP Grid with market toggle */} +
+
+
+ +

Settlement Point Prices (SPP)

+
+
+ + +
+
+ + + + {sppLoading ? ( + + ) : sppError ? ( + sppRefetch()} + /> + ) : !sppData?.locations?.length ? ( +

+ No SPP data available +

+ ) : ( +
+ {/* Group by location type */} + {(() => { + const loadZones = sppData.locations.filter(l => l.location_type === "load_zone"); + const tradingHubs = sppData.locations.filter(l => l.location_type === "trading_hub"); + const dcTies = sppData.locations.filter(l => l.location_type === "dc_tie"); + + return ( + <> + {loadZones.length > 0 && ( +
+

Load Zones

+
+ {loadZones.map((loc) => ( + + ))} +
+
+ )} + {tradingHubs.length > 0 && ( +
+

Trading Hubs

+
+ {tradingHubs.map((loc) => ( + + ))} +
+
+ )} + {dcTies.length > 0 && ( +
+

DC Ties

+
+ {dcTies.map((loc) => ( + + ))} +
+
+ )} + + ); + })()} +
+ )} + + +
+ + {/* Auto-refresh indicator */} +
+ Data auto-refreshes every 60 seconds +
+
+ ); +} diff --git a/examples/demo/frontend/src/pages/index.ts b/examples/demo/frontend/src/pages/index.ts new file mode 100644 index 0000000..5a2b392 --- /dev/null +++ b/examples/demo/frontend/src/pages/index.ts @@ -0,0 +1,4 @@ +export { Dashboard } from "./Dashboard"; +export { Prices } from "./Prices"; +export { Forecasts } from "./Forecasts"; +export { Historical } from "./Historical"; diff --git a/examples/demo/frontend/tsconfig.app.json b/examples/demo/frontend/tsconfig.app.json new file mode 100644 index 0000000..a9b5a59 --- /dev/null +++ b/examples/demo/frontend/tsconfig.app.json @@ -0,0 +1,28 @@ +{ + "compilerOptions": { + "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo", + "target": "ES2022", + "useDefineForClassFields": true, + "lib": ["ES2022", "DOM", "DOM.Iterable"], + "module": "ESNext", + "types": ["vite/client"], + "skipLibCheck": true, + + /* Bundler mode */ + "moduleResolution": "bundler", + "allowImportingTsExtensions": true, + "verbatimModuleSyntax": true, + "moduleDetection": "force", + "noEmit": true, + "jsx": "react-jsx", + + /* Linting */ + "strict": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "erasableSyntaxOnly": true, + "noFallthroughCasesInSwitch": true, + "noUncheckedSideEffectImports": true + }, + "include": ["src"] +} diff --git a/examples/demo/frontend/tsconfig.json b/examples/demo/frontend/tsconfig.json new file mode 100644 index 0000000..1ffef60 --- /dev/null +++ b/examples/demo/frontend/tsconfig.json @@ -0,0 +1,7 @@ +{ + "files": [], + "references": [ + { "path": "./tsconfig.app.json" }, + { "path": "./tsconfig.node.json" } + ] +} diff --git a/examples/demo/frontend/tsconfig.node.json b/examples/demo/frontend/tsconfig.node.json new file mode 100644 index 0000000..8a67f62 --- /dev/null +++ b/examples/demo/frontend/tsconfig.node.json @@ -0,0 +1,26 @@ +{ + "compilerOptions": { + "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo", + "target": "ES2023", + "lib": ["ES2023"], + "module": "ESNext", + "types": ["node"], + "skipLibCheck": true, + + /* Bundler mode */ + "moduleResolution": "bundler", + "allowImportingTsExtensions": true, + "verbatimModuleSyntax": true, + "moduleDetection": "force", + "noEmit": true, + + /* Linting */ + "strict": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "erasableSyntaxOnly": true, + "noFallthroughCasesInSwitch": true, + "noUncheckedSideEffectImports": true + }, + "include": ["vite.config.ts"] +} diff --git a/examples/demo/frontend/vite.config.ts b/examples/demo/frontend/vite.config.ts new file mode 100644 index 0000000..1100cfc --- /dev/null +++ b/examples/demo/frontend/vite.config.ts @@ -0,0 +1,16 @@ +import { defineConfig } from 'vite' +import react from '@vitejs/plugin-react' +import tailwindcss from '@tailwindcss/vite' + +// https://vite.dev/config/ +export default defineConfig({ + plugins: [react(), tailwindcss()], + server: { + proxy: { + '/api': { + target: 'http://localhost:8000', + changeOrigin: true, + }, + }, + }, +}) diff --git a/examples/ercot_demo.ipynb b/examples/ercot_demo.ipynb index 895bbc9..3a73ad4 100644 --- a/examples/ercot_demo.ipynb +++ b/examples/ercot_demo.ipynb @@ -2,7 +2,7 @@ "cells": [ { "cell_type": "code", - "execution_count": 27, + "execution_count": 47, "metadata": {}, "outputs": [ { @@ -55,7 +55,7 @@ }, { "cell_type": "code", - "execution_count": 28, + "execution_count": 48, "metadata": { "execution": { "iopub.execute_input": "2025-12-28T16:14:56.927060Z", @@ -89,7 +89,7 @@ }, { "cell_type": "code", - "execution_count": 29, + "execution_count": 49, "metadata": { "execution": { "iopub.execute_input": "2025-12-28T16:14:57.854493Z", @@ -133,7 +133,7 @@ }, { "cell_type": "code", - "execution_count": 30, + "execution_count": 50, "metadata": { "execution": { "iopub.execute_input": "2025-12-28T16:14:58.838540Z", @@ -182,7 +182,7 @@ }, { "cell_type": "code", - "execution_count": 5, + "execution_count": 42, "metadata": { "execution": { "iopub.execute_input": "2025-12-28T16:15:00.615946Z", @@ -197,7 +197,7 @@ "name": "stdout", "output_type": "stream", "text": [ - "Real-Time SPP: 84,930 records\n" + "Real-Time SPP: 42 records\n" ] }, { @@ -232,46 +232,379 @@ " \n", " \n", " 0\n", - " 2023-12-12 23:30:00-06:00\n", - " 2023-12-12 23:45:00-06:00\n", + " 2025-12-29 00:00:00-06:00\n", + " 2025-12-29 00:15:00-06:00\n", " 7RNCHSLR_ALL\n", - " 11.65\n", + " 16.13\n", " REAL_TIME_15_MIN\n", " RN\n", " \n", " \n", " 1\n", - " 2023-12-12 23:30:00-06:00\n", - " 2023-12-12 23:45:00-06:00\n", - " AEEC\n", - " 12.47\n", + " 2025-12-29 00:15:00-06:00\n", + " 2025-12-29 00:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 16.20\n", " REAL_TIME_15_MIN\n", " RN\n", " \n", " \n", " 2\n", - " 2023-12-12 23:30:00-06:00\n", - " 2023-12-12 23:45:00-06:00\n", - " AGUAYO_UNIT1\n", - " 12.30\n", + " 2025-12-29 00:30:00-06:00\n", + " 2025-12-29 00:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 15.86\n", " REAL_TIME_15_MIN\n", " RN\n", " \n", " \n", " 3\n", - " 2023-12-12 23:30:00-06:00\n", - " 2023-12-12 23:45:00-06:00\n", - " AJAXWIND_RN\n", - " 12.37\n", + " 2025-12-29 00:45:00-06:00\n", + " 2025-12-29 01:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 15.63\n", " REAL_TIME_15_MIN\n", " RN\n", " \n", " \n", " 4\n", - " 2023-12-12 23:30:00-06:00\n", - " 2023-12-12 23:45:00-06:00\n", - " ALGOD_ALL_RN\n", - " 7.64\n", + " 2025-12-29 01:00:00-06:00\n", + " 2025-12-29 01:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 15.56\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 5\n", + " 2025-12-29 01:15:00-06:00\n", + " 2025-12-29 01:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 15.61\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 6\n", + " 2025-12-29 01:30:00-06:00\n", + " 2025-12-29 01:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 14.51\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 7\n", + " 2025-12-29 01:45:00-06:00\n", + " 2025-12-29 02:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 15.28\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 8\n", + " 2025-12-29 02:00:00-06:00\n", + " 2025-12-29 02:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 17.48\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 9\n", + " 2025-12-29 02:15:00-06:00\n", + " 2025-12-29 02:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 18.88\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 10\n", + " 2025-12-29 09:15:00-06:00\n", + " 2025-12-29 09:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 22.11\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 11\n", + " 2025-12-29 09:30:00-06:00\n", + " 2025-12-29 09:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 21.86\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 12\n", + " 2025-12-29 09:45:00-06:00\n", + " 2025-12-29 10:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 22.18\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 13\n", + " 2025-12-29 10:00:00-06:00\n", + " 2025-12-29 10:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 23.98\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 14\n", + " 2025-12-29 10:15:00-06:00\n", + " 2025-12-29 10:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 22.36\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 15\n", + " 2025-12-29 07:00:00-06:00\n", + " 2025-12-29 07:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 29.39\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 16\n", + " 2025-12-29 07:15:00-06:00\n", + " 2025-12-29 07:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 29.67\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 17\n", + " 2025-12-29 07:30:00-06:00\n", + " 2025-12-29 07:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 28.96\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 18\n", + " 2025-12-29 07:45:00-06:00\n", + " 2025-12-29 08:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 34.42\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 19\n", + " 2025-12-29 08:00:00-06:00\n", + " 2025-12-29 08:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 43.97\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 20\n", + " 2025-12-29 08:15:00-06:00\n", + " 2025-12-29 08:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 44.21\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 21\n", + " 2025-12-29 08:30:00-06:00\n", + " 2025-12-29 08:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 35.15\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 22\n", + " 2025-12-29 08:45:00-06:00\n", + " 2025-12-29 09:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 25.84\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 23\n", + " 2025-12-29 09:00:00-06:00\n", + " 2025-12-29 09:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 22.59\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 24\n", + " 2025-12-29 02:30:00-06:00\n", + " 2025-12-29 02:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 19.23\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 25\n", + " 2025-12-29 02:45:00-06:00\n", + " 2025-12-29 03:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 20.04\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 26\n", + " 2025-12-29 03:00:00-06:00\n", + " 2025-12-29 03:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 20.88\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 27\n", + " 2025-12-29 03:15:00-06:00\n", + " 2025-12-29 03:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 20.70\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 28\n", + " 2025-12-29 03:30:00-06:00\n", + " 2025-12-29 03:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 20.22\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 29\n", + " 2025-12-29 03:45:00-06:00\n", + " 2025-12-29 04:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 20.16\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 30\n", + " 2025-12-29 04:00:00-06:00\n", + " 2025-12-29 04:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 19.18\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 31\n", + " 2025-12-29 04:15:00-06:00\n", + " 2025-12-29 04:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 19.08\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 32\n", + " 2025-12-29 04:30:00-06:00\n", + " 2025-12-29 04:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 18.56\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 33\n", + " 2025-12-29 04:45:00-06:00\n", + " 2025-12-29 05:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 18.76\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 34\n", + " 2025-12-29 05:00:00-06:00\n", + " 2025-12-29 05:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 19.18\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 35\n", + " 2025-12-29 05:15:00-06:00\n", + " 2025-12-29 05:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 19.61\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 36\n", + " 2025-12-29 05:30:00-06:00\n", + " 2025-12-29 05:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 20.17\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 37\n", + " 2025-12-29 05:45:00-06:00\n", + " 2025-12-29 06:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 21.25\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 38\n", + " 2025-12-29 06:00:00-06:00\n", + " 2025-12-29 06:15:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 23.81\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 39\n", + " 2025-12-29 06:15:00-06:00\n", + " 2025-12-29 06:30:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 24.79\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 40\n", + " 2025-12-29 06:30:00-06:00\n", + " 2025-12-29 06:45:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 24.81\n", + " REAL_TIME_15_MIN\n", + " RN\n", + " \n", + " \n", + " 41\n", + " 2025-12-29 06:45:00-06:00\n", + " 2025-12-29 07:00:00-06:00\n", + " 7RNCHSLR_ALL\n", + " 27.71\n", " REAL_TIME_15_MIN\n", " RN\n", " \n", @@ -280,15 +613,52 @@ "" ], "text/plain": [ - " Time End Time Location Price Market Location Type\n", - "0 2023-12-12 23:30:00-06:00 2023-12-12 23:45:00-06:00 7RNCHSLR_ALL 11.65 REAL_TIME_15_MIN RN\n", - "1 2023-12-12 23:30:00-06:00 2023-12-12 23:45:00-06:00 AEEC 12.47 REAL_TIME_15_MIN RN\n", - "2 2023-12-12 23:30:00-06:00 2023-12-12 23:45:00-06:00 AGUAYO_UNIT1 12.30 REAL_TIME_15_MIN RN\n", - "3 2023-12-12 23:30:00-06:00 2023-12-12 23:45:00-06:00 AJAXWIND_RN 12.37 REAL_TIME_15_MIN RN\n", - "4 2023-12-12 23:30:00-06:00 2023-12-12 23:45:00-06:00 ALGOD_ALL_RN 7.64 REAL_TIME_15_MIN RN" + " Time End Time Location Price Market Location Type\n", + "0 2025-12-29 00:00:00-06:00 2025-12-29 00:15:00-06:00 7RNCHSLR_ALL 16.13 REAL_TIME_15_MIN RN\n", + "1 2025-12-29 00:15:00-06:00 2025-12-29 00:30:00-06:00 7RNCHSLR_ALL 16.20 REAL_TIME_15_MIN RN\n", + "2 2025-12-29 00:30:00-06:00 2025-12-29 00:45:00-06:00 7RNCHSLR_ALL 15.86 REAL_TIME_15_MIN RN\n", + "3 2025-12-29 00:45:00-06:00 2025-12-29 01:00:00-06:00 7RNCHSLR_ALL 15.63 REAL_TIME_15_MIN RN\n", + "4 2025-12-29 01:00:00-06:00 2025-12-29 01:15:00-06:00 7RNCHSLR_ALL 15.56 REAL_TIME_15_MIN RN\n", + "5 2025-12-29 01:15:00-06:00 2025-12-29 01:30:00-06:00 7RNCHSLR_ALL 15.61 REAL_TIME_15_MIN RN\n", + "6 2025-12-29 01:30:00-06:00 2025-12-29 01:45:00-06:00 7RNCHSLR_ALL 14.51 REAL_TIME_15_MIN RN\n", + "7 2025-12-29 01:45:00-06:00 2025-12-29 02:00:00-06:00 7RNCHSLR_ALL 15.28 REAL_TIME_15_MIN RN\n", + "8 2025-12-29 02:00:00-06:00 2025-12-29 02:15:00-06:00 7RNCHSLR_ALL 17.48 REAL_TIME_15_MIN RN\n", + "9 2025-12-29 02:15:00-06:00 2025-12-29 02:30:00-06:00 7RNCHSLR_ALL 18.88 REAL_TIME_15_MIN RN\n", + "10 2025-12-29 09:15:00-06:00 2025-12-29 09:30:00-06:00 7RNCHSLR_ALL 22.11 REAL_TIME_15_MIN RN\n", + "11 2025-12-29 09:30:00-06:00 2025-12-29 09:45:00-06:00 7RNCHSLR_ALL 21.86 REAL_TIME_15_MIN RN\n", + "12 2025-12-29 09:45:00-06:00 2025-12-29 10:00:00-06:00 7RNCHSLR_ALL 22.18 REAL_TIME_15_MIN RN\n", + "13 2025-12-29 10:00:00-06:00 2025-12-29 10:15:00-06:00 7RNCHSLR_ALL 23.98 REAL_TIME_15_MIN RN\n", + "14 2025-12-29 10:15:00-06:00 2025-12-29 10:30:00-06:00 7RNCHSLR_ALL 22.36 REAL_TIME_15_MIN RN\n", + "15 2025-12-29 07:00:00-06:00 2025-12-29 07:15:00-06:00 7RNCHSLR_ALL 29.39 REAL_TIME_15_MIN RN\n", + "16 2025-12-29 07:15:00-06:00 2025-12-29 07:30:00-06:00 7RNCHSLR_ALL 29.67 REAL_TIME_15_MIN RN\n", + "17 2025-12-29 07:30:00-06:00 2025-12-29 07:45:00-06:00 7RNCHSLR_ALL 28.96 REAL_TIME_15_MIN RN\n", + "18 2025-12-29 07:45:00-06:00 2025-12-29 08:00:00-06:00 7RNCHSLR_ALL 34.42 REAL_TIME_15_MIN RN\n", + "19 2025-12-29 08:00:00-06:00 2025-12-29 08:15:00-06:00 7RNCHSLR_ALL 43.97 REAL_TIME_15_MIN RN\n", + "20 2025-12-29 08:15:00-06:00 2025-12-29 08:30:00-06:00 7RNCHSLR_ALL 44.21 REAL_TIME_15_MIN RN\n", + "21 2025-12-29 08:30:00-06:00 2025-12-29 08:45:00-06:00 7RNCHSLR_ALL 35.15 REAL_TIME_15_MIN RN\n", + "22 2025-12-29 08:45:00-06:00 2025-12-29 09:00:00-06:00 7RNCHSLR_ALL 25.84 REAL_TIME_15_MIN RN\n", + "23 2025-12-29 09:00:00-06:00 2025-12-29 09:15:00-06:00 7RNCHSLR_ALL 22.59 REAL_TIME_15_MIN RN\n", + "24 2025-12-29 02:30:00-06:00 2025-12-29 02:45:00-06:00 7RNCHSLR_ALL 19.23 REAL_TIME_15_MIN RN\n", + "25 2025-12-29 02:45:00-06:00 2025-12-29 03:00:00-06:00 7RNCHSLR_ALL 20.04 REAL_TIME_15_MIN RN\n", + "26 2025-12-29 03:00:00-06:00 2025-12-29 03:15:00-06:00 7RNCHSLR_ALL 20.88 REAL_TIME_15_MIN RN\n", + "27 2025-12-29 03:15:00-06:00 2025-12-29 03:30:00-06:00 7RNCHSLR_ALL 20.70 REAL_TIME_15_MIN RN\n", + "28 2025-12-29 03:30:00-06:00 2025-12-29 03:45:00-06:00 7RNCHSLR_ALL 20.22 REAL_TIME_15_MIN RN\n", + "29 2025-12-29 03:45:00-06:00 2025-12-29 04:00:00-06:00 7RNCHSLR_ALL 20.16 REAL_TIME_15_MIN RN\n", + "30 2025-12-29 04:00:00-06:00 2025-12-29 04:15:00-06:00 7RNCHSLR_ALL 19.18 REAL_TIME_15_MIN RN\n", + "31 2025-12-29 04:15:00-06:00 2025-12-29 04:30:00-06:00 7RNCHSLR_ALL 19.08 REAL_TIME_15_MIN RN\n", + "32 2025-12-29 04:30:00-06:00 2025-12-29 04:45:00-06:00 7RNCHSLR_ALL 18.56 REAL_TIME_15_MIN RN\n", + "33 2025-12-29 04:45:00-06:00 2025-12-29 05:00:00-06:00 7RNCHSLR_ALL 18.76 REAL_TIME_15_MIN RN\n", + "34 2025-12-29 05:00:00-06:00 2025-12-29 05:15:00-06:00 7RNCHSLR_ALL 19.18 REAL_TIME_15_MIN RN\n", + "35 2025-12-29 05:15:00-06:00 2025-12-29 05:30:00-06:00 7RNCHSLR_ALL 19.61 REAL_TIME_15_MIN RN\n", + "36 2025-12-29 05:30:00-06:00 2025-12-29 05:45:00-06:00 7RNCHSLR_ALL 20.17 REAL_TIME_15_MIN RN\n", + "37 2025-12-29 05:45:00-06:00 2025-12-29 06:00:00-06:00 7RNCHSLR_ALL 21.25 REAL_TIME_15_MIN RN\n", + "38 2025-12-29 06:00:00-06:00 2025-12-29 06:15:00-06:00 7RNCHSLR_ALL 23.81 REAL_TIME_15_MIN RN\n", + "39 2025-12-29 06:15:00-06:00 2025-12-29 06:30:00-06:00 7RNCHSLR_ALL 24.79 REAL_TIME_15_MIN RN\n", + "40 2025-12-29 06:30:00-06:00 2025-12-29 06:45:00-06:00 7RNCHSLR_ALL 24.81 REAL_TIME_15_MIN RN\n", + "41 2025-12-29 06:45:00-06:00 2025-12-29 07:00:00-06:00 7RNCHSLR_ALL 27.71 REAL_TIME_15_MIN RN" ] }, - "execution_count": null, + "execution_count": 42, "metadata": {}, "output_type": "execute_result" } @@ -296,17 +666,44 @@ "source": [ "# Real-time 15-minute SPP\n", "df = ercot.get_spp(\n", - " start=\"2023-12-12\",\n", + " start=\"2025-12-29T16:39\",\n", " market=Market.REAL_TIME_15_MIN,\n", + " location_type=LocationType.RESOURCE_NODE,\n", + " locations=[\"7RNCHSLR_ALL\"],\n", ")\n", "\n", "print(f\"Real-Time SPP: {len(df):,} records\")\n", - "df.head()" + "df" ] }, { "cell_type": "code", - "execution_count": 6, + "execution_count": 35, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "7RNCHSLR_ALL\n", + "18858\n" + ] + } + ], + "source": [ + "spp_mapping = ercot.get_settlement_point_mapping()\n", + "resource_nodes = spp_mapping[\"settlement_points\"].RESOURCE_NODE.to_list()\n", + "\n", + "for rn in resource_nodes:\n", + " if str(rn).startswith(\"7RNCHSLR\"):\n", + " print(rn)\n", + "\n", + "print(len(resource_nodes))" + ] + }, + { + "cell_type": "code", + "execution_count": null, "metadata": { "execution": { "iopub.execute_input": "2025-12-28T16:15:12.766812Z", @@ -356,46 +753,46 @@ " \n", " \n", " 0\n", - " 2025-12-27 23:30:00-06:00\n", - " 2025-12-27 23:45:00-06:00\n", + " 2025-12-28 23:30:00-06:00\n", + " 2025-12-28 23:45:00-06:00\n", " LZ_AEN\n", - " 8.10\n", + " 17.23\n", " REAL_TIME_15_MIN\n", - " LZ\n", + " LZEW\n", " \n", " \n", " 1\n", - " 2025-12-27 23:30:00-06:00\n", - " 2025-12-27 23:45:00-06:00\n", + " 2025-12-28 23:30:00-06:00\n", + " 2025-12-28 23:45:00-06:00\n", " LZ_AEN\n", - " 8.10\n", + " 17.22\n", " REAL_TIME_15_MIN\n", - " LZEW\n", + " LZ\n", " \n", " \n", " 2\n", - " 2025-12-27 23:30:00-06:00\n", - " 2025-12-27 23:45:00-06:00\n", + " 2025-12-28 23:30:00-06:00\n", + " 2025-12-28 23:45:00-06:00\n", " LZ_CPS\n", - " 7.73\n", + " 16.92\n", " REAL_TIME_15_MIN\n", - " LZEW\n", + " LZ\n", " \n", " \n", " 3\n", - " 2025-12-27 23:30:00-06:00\n", - " 2025-12-27 23:45:00-06:00\n", + " 2025-12-28 23:30:00-06:00\n", + " 2025-12-28 23:45:00-06:00\n", " LZ_CPS\n", - " 7.73\n", + " 16.93\n", " REAL_TIME_15_MIN\n", - " LZ\n", + " LZEW\n", " \n", " \n", " 4\n", - " 2025-12-27 23:30:00-06:00\n", - " 2025-12-27 23:45:00-06:00\n", + " 2025-12-28 23:30:00-06:00\n", + " 2025-12-28 23:45:00-06:00\n", " LZ_HOUSTON\n", - " 9.89\n", + " 17.47\n", " REAL_TIME_15_MIN\n", " LZEW\n", " \n", @@ -405,14 +802,14 @@ ], "text/plain": [ " Time End Time Location Price Market Location Type\n", - "0 2025-12-27 23:30:00-06:00 2025-12-27 23:45:00-06:00 LZ_AEN 8.10 REAL_TIME_15_MIN LZ\n", - "1 2025-12-27 23:30:00-06:00 2025-12-27 23:45:00-06:00 LZ_AEN 8.10 REAL_TIME_15_MIN LZEW\n", - "2 2025-12-27 23:30:00-06:00 2025-12-27 23:45:00-06:00 LZ_CPS 7.73 REAL_TIME_15_MIN LZEW\n", - "3 2025-12-27 23:30:00-06:00 2025-12-27 23:45:00-06:00 LZ_CPS 7.73 REAL_TIME_15_MIN LZ\n", - "4 2025-12-27 23:30:00-06:00 2025-12-27 23:45:00-06:00 LZ_HOUSTON 9.89 REAL_TIME_15_MIN LZEW" + "0 2025-12-28 23:30:00-06:00 2025-12-28 23:45:00-06:00 LZ_AEN 17.23 REAL_TIME_15_MIN LZEW\n", + "1 2025-12-28 23:30:00-06:00 2025-12-28 23:45:00-06:00 LZ_AEN 17.22 REAL_TIME_15_MIN LZ\n", + "2 2025-12-28 23:30:00-06:00 2025-12-28 23:45:00-06:00 LZ_CPS 16.92 REAL_TIME_15_MIN LZ\n", + "3 2025-12-28 23:30:00-06:00 2025-12-28 23:45:00-06:00 LZ_CPS 16.93 REAL_TIME_15_MIN LZEW\n", + "4 2025-12-28 23:30:00-06:00 2025-12-28 23:45:00-06:00 LZ_HOUSTON 17.47 REAL_TIME_15_MIN LZEW" ] }, - "execution_count": null, + "execution_count": 18, "metadata": {}, "output_type": "execute_result" } @@ -425,6 +822,7 @@ " location_type=LocationType.LOAD_ZONE,\n", ")\n", "\n", + "\n", "print(f\"Load Zone SPP: {len(df):,} records\")\n", "df.head()" ] @@ -804,7 +1202,7 @@ }, { "cell_type": "code", - "execution_count": 9, + "execution_count": 37, "metadata": { "execution": { "iopub.execute_input": "2025-12-28T16:16:13.533144Z", @@ -853,42 +1251,42 @@ " \n", " \n", " 0\n", - " 7RNCHSLR_ALL\n", - " 20.75\n", + " BASTEN_CCU\n", + " 23.82\n", " REAL_TIME_SCED\n", - " 2025-12-28T17:25:15\n", + " 2025-12-29T10:25:16\n", " False\n", " \n", " \n", " 1\n", - " A4_DGR1_RN\n", - " 21.31\n", + " BATCAVE_RN\n", + " 27.28\n", " REAL_TIME_SCED\n", - " 2025-12-28T17:25:15\n", + " 2025-12-29T10:25:16\n", " False\n", " \n", " \n", " 2\n", - " A4_DGR2_RN\n", - " 21.31\n", + " BAYC_BESS_RN\n", + " 21.21\n", " REAL_TIME_SCED\n", - " 2025-12-28T17:25:15\n", + " 2025-12-29T10:25:16\n", " False\n", " \n", " \n", " 3\n", - " ABINDUST_RN\n", - " 2.50\n", + " BBREEZE_1_2\n", + " -12.35\n", " REAL_TIME_SCED\n", - " 2025-12-28T17:25:15\n", + " 2025-12-29T10:25:16\n", " False\n", " \n", " \n", " 4\n", - " ADL_RN\n", - " 21.14\n", + " BCATWD_WD_1\n", + " 14.50\n", " REAL_TIME_SCED\n", - " 2025-12-28T17:25:15\n", + " 2025-12-29T10:25:16\n", " False\n", " \n", " \n", @@ -897,14 +1295,14 @@ ], "text/plain": [ " Location Price Market SCED Time Stamp Repeat Hour Flag\n", - "0 7RNCHSLR_ALL 20.75 REAL_TIME_SCED 2025-12-28T17:25:15 False\n", - "1 A4_DGR1_RN 21.31 REAL_TIME_SCED 2025-12-28T17:25:15 False\n", - "2 A4_DGR2_RN 21.31 REAL_TIME_SCED 2025-12-28T17:25:15 False\n", - "3 ABINDUST_RN 2.50 REAL_TIME_SCED 2025-12-28T17:25:15 False\n", - "4 ADL_RN 21.14 REAL_TIME_SCED 2025-12-28T17:25:15 False" + "0 BASTEN_CCU 23.82 REAL_TIME_SCED 2025-12-29T10:25:16 False\n", + "1 BATCAVE_RN 27.28 REAL_TIME_SCED 2025-12-29T10:25:16 False\n", + "2 BAYC_BESS_RN 21.21 REAL_TIME_SCED 2025-12-29T10:25:16 False\n", + "3 BBREEZE_1_2 -12.35 REAL_TIME_SCED 2025-12-29T10:25:16 False\n", + "4 BCATWD_WD_1 14.50 REAL_TIME_SCED 2025-12-29T10:25:16 False" ] }, - "execution_count": null, + "execution_count": 37, "metadata": {}, "output_type": "execute_result" } @@ -912,7 +1310,7 @@ "source": [ "# Real-time LMP by settlement point\n", "df = ercot.get_lmp(\n", - " start=\"today\",\n", + " start=\"2025-12-29T09:55:00\",\n", " market=Market.REAL_TIME_SCED,\n", ")\n", "\n", @@ -1041,7 +1439,7 @@ }, { "cell_type": "code", - "execution_count": 12, + "execution_count": null, "metadata": { "execution": { "iopub.execute_input": "2025-12-28T16:17:00.709885Z", @@ -1056,7 +1454,7 @@ "name": "stdout", "output_type": "stream", "text": [ - "Day-Ahead LMP: 20,000 records\n" + "Day-Ahead LMP: 192,592 records\n" ] }, { @@ -1141,7 +1539,7 @@ "4 2025-12-29 00:00:00-06:00 2025-12-29 01:00:00-06:00 18.15 DAY_AHEAD_HOURLY _BI_138L" ] }, - "execution_count": null, + "execution_count": 46, "metadata": {}, "output_type": "execute_result" } @@ -1166,7 +1564,7 @@ }, { "cell_type": "code", - "execution_count": 13, + "execution_count": 44, "metadata": { "execution": { "iopub.execute_input": "2025-12-27T23:02:22.843320Z", @@ -1214,38 +1612,38 @@ " \n", " \n", " 0\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " NSPIN\n", - " 3.00\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " RRS\n", + " 0.36\n", " \n", " \n", " 1\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " RRS\n", - " 0.41\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " NSPIN\n", + " 2.00\n", " \n", " \n", " 2\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " REGDN\n", - " 0.69\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " REGUP\n", + " 0.57\n", " \n", " \n", " 3\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " REGUP\n", - " 0.41\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " REGDN\n", + " 0.50\n", " \n", " \n", " 4\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", " ECRS\n", - " 0.50\n", + " 0.45\n", " \n", " \n", "\n", @@ -1253,14 +1651,14 @@ ], "text/plain": [ " Time End Time Ancillary Type MCPC\n", - "0 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 NSPIN 3.00\n", - "1 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 RRS 0.41\n", - "2 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 REGDN 0.69\n", - "3 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 REGUP 0.41\n", - "4 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 ECRS 0.50" + "0 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 RRS 0.36\n", + "1 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 NSPIN 2.00\n", + "2 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 REGUP 0.57\n", + "3 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 REGDN 0.50\n", + "4 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 ECRS 0.45" ] }, - "execution_count": null, + "execution_count": 44, "metadata": {}, "output_type": "execute_result" } @@ -1275,7 +1673,7 @@ }, { "cell_type": "code", - "execution_count": 14, + "execution_count": 45, "metadata": { "execution": { "iopub.execute_input": "2025-12-27T23:02:24.372900Z", @@ -1324,41 +1722,41 @@ " \n", " \n", " 0\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " 2025-12-27T05:00:00\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " 2025-12-28T05:00:00\n", " ECRS\n", " 864\n", " \n", " \n", " 1\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " 2025-12-27T05:00:00\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " 2025-12-28T05:00:00\n", " NSPIN\n", " 2278\n", " \n", " \n", " 2\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " 2025-12-27T05:00:00\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " 2025-12-28T05:00:00\n", " REGDN\n", " 315\n", " \n", " \n", " 3\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " 2025-12-27T05:00:00\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " 2025-12-28T05:00:00\n", " REGUP\n", " 369\n", " \n", " \n", " 4\n", - " 2025-12-27 00:00:00-06:00\n", - " 2025-12-27 01:00:00-06:00\n", - " 2025-12-27T05:00:00\n", + " 2025-12-28 00:00:00-06:00\n", + " 2025-12-28 01:00:00-06:00\n", + " 2025-12-28T05:00:00\n", " RRS\n", " 2982\n", " \n", @@ -1368,14 +1766,14 @@ ], "text/plain": [ " Time End Time Posted Ancillary Type Quantity\n", - "0 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 2025-12-27T05:00:00 ECRS 864\n", - "1 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 2025-12-27T05:00:00 NSPIN 2278\n", - "2 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 2025-12-27T05:00:00 REGDN 315\n", - "3 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 2025-12-27T05:00:00 REGUP 369\n", - "4 2025-12-27 00:00:00-06:00 2025-12-27 01:00:00-06:00 2025-12-27T05:00:00 RRS 2982" + "0 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 2025-12-28T05:00:00 ECRS 864\n", + "1 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 2025-12-28T05:00:00 NSPIN 2278\n", + "2 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 2025-12-28T05:00:00 REGDN 315\n", + "3 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 2025-12-28T05:00:00 REGUP 369\n", + "4 2025-12-28 00:00:00-06:00 2025-12-28 01:00:00-06:00 2025-12-28T05:00:00 RRS 2982" ] }, - "execution_count": null, + "execution_count": 45, "metadata": {}, "output_type": "execute_result" } @@ -1820,7 +2218,7 @@ }, { "cell_type": "code", - "execution_count": 53, + "execution_count": 31, "metadata": {}, "outputs": [ { @@ -2543,7 +2941,7 @@ }, { "cell_type": "code", - "execution_count": 49, + "execution_count": 43, "metadata": {}, "outputs": [ { @@ -2719,7 +3117,7 @@ }, { "cell_type": "code", - "execution_count": 51, + "execution_count": 44, "metadata": { "execution": { "iopub.execute_input": "2025-12-27T23:03:04.090925Z", @@ -2805,7 +3203,7 @@ }, { "cell_type": "code", - "execution_count": 52, + "execution_count": 45, "metadata": { "execution": { "iopub.execute_input": "2025-12-27T23:02:44.546818Z", diff --git a/pyrightconfig.json b/pyrightconfig.json index b19e3fd..0060be8 100644 --- a/pyrightconfig.json +++ b/pyrightconfig.json @@ -21,7 +21,8 @@ "minio-data/**", "public/**", "static-files/**", - "pyercot/**" + "pyercot/**", + "examples/demo/**" ], "pythonPlatform": "Linux", "pythonVersion": "3.13", diff --git a/ruff.toml b/ruff.toml index 95543eb..f66f403 100644 --- a/ruff.toml +++ b/ruff.toml @@ -7,6 +7,7 @@ exclude = [ "build", "dist", "migrations", + "examples/demo", ] diff --git a/tinygrid/constants/ercot.py b/tinygrid/constants/ercot.py index 83e2e6b..a29c13d 100644 --- a/tinygrid/constants/ercot.py +++ b/tinygrid/constants/ercot.py @@ -91,6 +91,7 @@ class LocationType(StrEnum): LOAD_ZONE = "Load Zone" TRADING_HUB = "Trading Hub" + DC_TIE = "DC Tie" RESOURCE_NODE = "Resource Node" ELECTRICAL_BUS = "Electrical Bus" @@ -126,6 +127,15 @@ class SettlementPointType(StrEnum): "HB_PAN", ] +# ERCOT DC Ties (interconnections with other grids) +DC_TIES = [ + "DC_E", # East DC Tie (to SPP) + "DC_L", # Laredo DC Tie (to Mexico - CFE) + "DC_N", # North DC Tie (to SPP) + "DC_R", # Railroad DC Tie (to Mexico - CFE) + "DC_S", # South DC Tie (to Mexico - CFE) +] + # Endpoint mappings for unified methods ENDPOINT_MAPPINGS = { # Settlement Point Prices diff --git a/tinygrid/ercot/api.py b/tinygrid/ercot/api.py index 199640e..bb41e09 100644 --- a/tinygrid/ercot/api.py +++ b/tinygrid/ercot/api.py @@ -10,6 +10,7 @@ from __future__ import annotations +import asyncio from typing import TYPE_CHECKING import pandas as pd @@ -354,6 +355,40 @@ def get_shadow_prices( df = filter_by_date(df, start_ts, end_ts) return standardize_columns(df) + def get_load_forecast( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + by: str = "weather_zone", + ) -> pd.DataFrame: + """Get system load forecast. + + Args: + start: Start date - "today", "yesterday", or ISO format + end: End date (defaults to start + 1 day) + by: Grouping - "weather_zone" or "study_area" + + Returns: + DataFrame with load forecast data + """ + start_ts, end_ts = parse_date_range(start, end) + + if by == "study_area": + # Note: Historical routing omitted as endpoints not verified + df = self.get_load_forecast_by_study_area( + start_date=format_api_date(start_ts), + end_date=format_api_date(end_ts), + ) + else: + # Note: Historical routing omitted as endpoints not verified + df = self.get_load_forecast_by_weather_zone( + start_date=format_api_date(start_ts), + end_date=format_api_date(end_ts), + ) + + df = filter_by_date(df, start_ts, end_ts, date_column="Oper Day") + return standardize_columns(df) + def get_load( self, start: str | pd.Timestamp = "today", @@ -862,3 +897,144 @@ def get_60_day_sced_disclosure( "sced_load_resource": self.get_load_res_data_in_sced(), "sced_smne": smne_df, } + + # ============================================================================ + # Async wrappers + # ============================================================================ + async def get_spp_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + market: Market = Market.REAL_TIME_15_MIN, + locations: list[str] | None = None, + location_type: LocationType | list[LocationType] | None = None, + ) -> pd.DataFrame: + """Async wrapper for get_spp using a thread off the event loop.""" + return await asyncio.to_thread( + self.get_spp, start, end, market, locations, location_type + ) + + async def get_lmp_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + market: Market = Market.REAL_TIME_SCED, + location_type: LocationType = LocationType.RESOURCE_NODE, + ) -> pd.DataFrame: + """Async wrapper for get_lmp using a thread off the event loop.""" + return await asyncio.to_thread(self.get_lmp, start, end, market, location_type) + + async def get_as_prices_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + ) -> pd.DataFrame: + """Async wrapper for get_as_prices.""" + return await asyncio.to_thread(self.get_as_prices, start, end) + + async def get_as_plan_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + ) -> pd.DataFrame: + """Async wrapper for get_as_plan.""" + return await asyncio.to_thread(self.get_as_plan, start, end) + + async def get_shadow_prices_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + ) -> pd.DataFrame: + """Async wrapper for get_shadow_prices.""" + return await asyncio.to_thread(self.get_shadow_prices, start, end) + + async def get_load_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + by: str = "weather_zone", + ) -> pd.DataFrame: + """Async wrapper for get_load.""" + return await asyncio.to_thread(self.get_load, start, end, by) + + async def get_wind_forecast_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + by_region: bool = False, + resolution: str = "hourly", + ) -> pd.DataFrame: + """Async wrapper for get_wind_forecast.""" + return await asyncio.to_thread( + self.get_wind_forecast, start, end, by_region, resolution + ) + + async def get_solar_forecast_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + by_region: bool = False, + resolution: str = "hourly", + ) -> pd.DataFrame: + """Async wrapper for get_solar_forecast.""" + return await asyncio.to_thread( + self.get_solar_forecast, start, end, by_region, resolution + ) + + async def get_load_forecast_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + by: str = "weather_zone", + ) -> pd.DataFrame: + """Async wrapper for get_load_forecast.""" + # Note: get_load_forecast is not defined in ERCOTAPIMixin but we assume it is available + # via other mixins or will be called on the instance. + # However, checking api.py, get_load_forecast isn't there. + # But forecasts.py calls ercot.get_load_forecast_by_weather_zone/study_area. + # It seems the unified method might be missing in api.py too? + # Let's check if get_load_forecast exists in api.py. + # It does not appear in the Read output of api.py. + # But the user plan says: "Replace ... with await ercot.get_load_forecast_async(...)". + # This implies I should create get_load_forecast_async AND possibly get_load_forecast if it doesn't exist? + # Or maybe it relies on dynamic dispatch? No. + # Let's add get_load_forecast to api.py as well, as a unified method. + return await asyncio.to_thread(self.get_load_forecast, start, end, by) + + async def get_dc_tie_flows_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + ) -> pd.DataFrame: + """Async wrapper for get_dc_tie_flows.""" + return await asyncio.to_thread(self.get_dc_tie_flows, start, end) + + async def get_total_generation_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + ) -> pd.DataFrame: + """Async wrapper for get_total_generation.""" + return await asyncio.to_thread(self.get_total_generation, start, end) + + async def get_system_wide_actuals_async( + self, + start: str | pd.Timestamp = "today", + end: str | pd.Timestamp | None = None, + ) -> pd.DataFrame: + """Async wrapper for get_system_wide_actuals.""" + return await asyncio.to_thread(self.get_system_wide_actuals, start, end) + + async def get_60_day_dam_disclosure_async( + self, + date: str | pd.Timestamp = "today", + ) -> dict[str, pd.DataFrame]: + """Async wrapper for get_60_day_dam_disclosure.""" + return await asyncio.to_thread(self.get_60_day_dam_disclosure, date) + + async def get_60_day_sced_disclosure_async( + self, + date: str | pd.Timestamp = "today", + ) -> dict[str, pd.DataFrame]: + """Async wrapper for get_60_day_sced_disclosure.""" + return await asyncio.to_thread(self.get_60_day_sced_disclosure, date) diff --git a/tinygrid/ercot/transforms.py b/tinygrid/ercot/transforms.py index b7dc49f..61f4e7b 100644 --- a/tinygrid/ercot/transforms.py +++ b/tinygrid/ercot/transforms.py @@ -15,6 +15,7 @@ from ..constants.ercot import ( COLUMN_MAPPINGS, + DC_TIES, ERCOT_TIMEZONE, LOAD_ZONES, TRADING_HUBS, @@ -82,13 +83,17 @@ def filter_by_location( allowed.update(LOAD_ZONES) elif lt == LocationType.TRADING_HUB: allowed.update(TRADING_HUBS) + elif lt == LocationType.DC_TIE: + allowed.update(DC_TIES) elif lt == LocationType.RESOURCE_NODE: exclude_mode = True if exclude_mode and not allowed: - # Only RESOURCE_NODE requested - exclude zones and hubs + # Only RESOURCE_NODE requested - exclude zones, hubs, and DC ties filtered = df[ - ~df[loc_col].isin(LOAD_ZONES) & ~df[loc_col].isin(TRADING_HUBS) + ~df[loc_col].isin(LOAD_ZONES) + & ~df[loc_col].isin(TRADING_HUBS) + & ~df[loc_col].isin(DC_TIES) ] assert isinstance(filtered, pd.DataFrame) df = filtered