From 3f6b6b1a6c26ba712fa30ec15eee7b91172e1156 Mon Sep 17 00:00:00 2001 From: qwazzarr Date: Mon, 12 Jan 2026 16:00:00 +0000 Subject: [PATCH 01/16] version 0.5 react tutorial --- .idea/.gitignore | 8 + .idea/discord.xml | 7 + .idea/ichack-hackpacks.iml | 12 + .idea/inspectionProfiles/Project_Default.xml | 6 + .idea/modules.xml | 8 + .idea/vcs.xml | 6 + .../react-example-tutorial/README.MD | 278 ++ .../vite-project/.gitignore | 24 + .../vite-project/README.md | 73 + .../vite-project/eslint.config.js | 23 + .../vite-project/index.html | 13 + .../vite-project/package-lock.json | 3257 +++++++++++++++++ .../vite-project/package.json | 30 + .../vite-project/public/vite.svg | 1 + .../vite-project/src/App.css | 42 + .../vite-project/src/App.tsx | 5 + .../vite-project/src/assets/react.svg | 1 + .../vite-project/src/components/Counter.tsx | 22 + .../vite-project/src/index.css | 68 + .../vite-project/src/main.tsx | 10 + .../vite-project/src/pages/HomePage.tsx | 10 + .../vite-project/tsconfig.app.json | 28 + .../vite-project/tsconfig.json | 7 + .../vite-project/tsconfig.node.json | 26 + .../vite-project/vite.config.ts | 7 + 25 files changed, 3972 insertions(+) create mode 100644 .idea/.gitignore create mode 100644 .idea/discord.xml create mode 100644 .idea/ichack-hackpacks.iml create mode 100644 .idea/inspectionProfiles/Project_Default.xml create mode 100644 .idea/modules.xml create mode 100644 .idea/vcs.xml create mode 100644 frontend-development/react-example-tutorial/README.MD create mode 100644 frontend-development/react-example-tutorial/vite-project/.gitignore create mode 100644 frontend-development/react-example-tutorial/vite-project/README.md create mode 100644 frontend-development/react-example-tutorial/vite-project/eslint.config.js create mode 100644 frontend-development/react-example-tutorial/vite-project/index.html create mode 100644 frontend-development/react-example-tutorial/vite-project/package-lock.json create mode 100644 frontend-development/react-example-tutorial/vite-project/package.json create mode 100644 frontend-development/react-example-tutorial/vite-project/public/vite.svg create mode 100644 frontend-development/react-example-tutorial/vite-project/src/App.css create mode 100644 frontend-development/react-example-tutorial/vite-project/src/App.tsx create mode 100644 frontend-development/react-example-tutorial/vite-project/src/assets/react.svg create mode 100644 frontend-development/react-example-tutorial/vite-project/src/components/Counter.tsx create mode 100644 frontend-development/react-example-tutorial/vite-project/src/index.css create mode 100644 frontend-development/react-example-tutorial/vite-project/src/main.tsx create mode 100644 frontend-development/react-example-tutorial/vite-project/src/pages/HomePage.tsx create mode 100644 frontend-development/react-example-tutorial/vite-project/tsconfig.app.json create mode 100644 frontend-development/react-example-tutorial/vite-project/tsconfig.json create mode 100644 frontend-development/react-example-tutorial/vite-project/tsconfig.node.json create mode 100644 frontend-development/react-example-tutorial/vite-project/vite.config.ts diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 0000000..13566b8 --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,8 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/.idea/discord.xml b/.idea/discord.xml new file mode 100644 index 0000000..30bab2a --- /dev/null +++ b/.idea/discord.xml @@ -0,0 +1,7 @@ + + + + + \ No newline at end of file diff --git a/.idea/ichack-hackpacks.iml b/.idea/ichack-hackpacks.iml new file mode 100644 index 0000000..24643cc --- /dev/null +++ b/.idea/ichack-hackpacks.iml @@ -0,0 +1,12 @@ + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml new file mode 100644 index 0000000..03d9549 --- /dev/null +++ b/.idea/inspectionProfiles/Project_Default.xml @@ -0,0 +1,6 @@ + + + + \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml new file mode 100644 index 0000000..91b69a1 --- /dev/null +++ b/.idea/modules.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 0000000..35eb1dd --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD new file mode 100644 index 0000000..09dd83c --- /dev/null +++ b/frontend-development/react-example-tutorial/README.MD @@ -0,0 +1,278 @@ +# React Hackathon Frontend Mini-Guide (with Vite) + +## 1) What is React (and why it’s perfect for hackathons) +**React** is a JavaScript library for building user interfaces by composing **reusable components**. You write UI as a function of state, and React updates the DOM efficiently when state changes. + +Why it’s great for hackathons: +- **Fast iteration**: instant updates while you code (Hot Module Reloading). +- **Component reuse**: build small pieces once, reuse everywhere. +- **Huge ecosystem**: UI libs, routers, state tools, deploy platforms. +- **Team-friendly**: clear structure; easy to split work (“you take this component/page”). + +Official docs: https://react.dev/ + +--- + +## 2) How to start + +### Required JS/TS +You can use plain **JavaScript**, but **TypeScript (TS)** is strongly recommended. +TS is basically **JS + types**, which catches dumb bugs early and makes teamwork easier. + +TypeScript docs: https://www.typescriptlang.org/ + +### Repo structure (recommended) +If your hackathon repo has backend + frontend, keep them separated: +~~~ +my-project/ +backend/ +frontend +~~~ + +This prevents dependency/config chaos and makes deploy easier. + +### Create a React app with Vite (recommended) +**Vite** is a modern dev server + build tool. It’s fast because it uses native ES modules in dev and bundles for production. + +Vite: https://vitejs.dev/ + +~~~ +mkdir frontend +cd frontend + +npm create vite@latest . -- --template react-ts +npm install +npm run dev +~~~ +Open the URL printed in the terminal (usually http://localhost:5173) + +## What Vite created (and what the files mean) + +Key files you’ll see: + +~~~ +package.json +~~~ + +Your project metadata + scripts + dependencies. + +Example scripts: "dev", "build", "preview" + +~~~ +package-lock.json (npm) / pnpm-lock.yaml / yarn.lock +~~~ + +Locks exact dependency versions so everyone gets the same installs. + +~~~ +tsconfig.json (+ sometimes tsconfig.app.json, tsconfig.node.json) +~~~ + +TypeScript compiler options (strictness, module settings, path aliases, etc.) + +~~~ +vite.config.ts +~~~ + +Vite configuration (plugins, aliases, proxies, build options). + +~~~ +index.html +~~~ + +The single HTML entry point (Vite injects your JS into it). + +~~~ +src/main.tsx +~~~ +The real entry file. It mounts React into the DOM. + +~~~ +src/App.tsx +~~~ +The starter component you’ll edit first. + +### No restart required + +When you edit `src/App.tsx` (or any component), Vite does HMR: updates the page instantly without restarting the server. +This is why React dev feels “live”. + +## React Components (what they actually are) + +A component is a reusable UI unit. In modern React, components are usually functions (not classes). +They: +- take **props** (inputs) +- return **JSX** (HTML-like syntax) +- can have **state** via hooks (e.g `useState`) + +Common structure: + +~~~ +src/ + components/ # reusable UI building blocks (buttons, cards, Counter, etc.) + pages/ # full screens/routes (HomePage, DashboardPage, etc.) + App.tsx +~~~ + +## Example: Page using a `` + +Code + +`src/components/Counter.tsx` + +~~~ +import { useState } from "react"; + +type CounterProps = { + maxValue: number; +}; + +export function Counter({ maxValue }: CounterProps) { + const [value, setValue] = useState(0); + + const inc = () => setValue((v) => Math.min(v + 1, maxValue)); + const reset = () => setValue(0); + + return ( +
+
Value: {value}
+ + +
+ ); +} +~~~ + +`src/pages/HomePage.tsx` + +~~~ +import { Counter } from "../components/Counter"; + +export function HomePage() { + return ( +
+

This is my counter

+ +
+ ); +} +~~~ + +`src/App.tsx` + +~~~ +import { HomePage } from "./pages/HomePage"; + +export default function App() { + return ; +} +~~~ + +## Main React Hooks (short, useful) + +- `useState` — local component state. +- `useEffect` — run side effects (fetching, subscriptions, timers) +- `useMemo` — memoize expensive computed values +- `useCallback` — memoize function references (useful when passing callbacks deep). +- `useRef` — mutable value that doesn’t trigger rerenders; also DOM refs. +- `useContext` — share data across many components without prop-drilling + +Hooks reference: https://react.dev/reference/react + +## Rerender mechanics + the `useEffect` trap + +**Rerender rule** : A component rerenders when its state, props, or context changes. + +The common `useEffect` trap (infinite loop) + +Bad: +~~~ +useEffect(() => { + setValue(value + 1); +}, [value]); +~~~ + +This updates `value`, which triggers the effect again, forever. + +Better patterns: +- Only run once on mount +~~~ +useEffect(() => { + // run once +}, []); +~~~ + +- Fetch data safely (avoid setting state if unmounted): +~~~ +useEffect(() => { + const controller = new AbortController(); + + (async () => { + const res = await fetch("/api/data", { signal: controller.signal }); + const json = await res.json(); + // setState(json) + })(); + + return () => controller.abort(); +}, []); +~~~ +If you feel stuck: read Effects properly (it’s where most beginner bugs come from): +https://react.dev/learn/synchronizing-with-effects + +For bigger apps: + +- Router (pages + URLs): https://reactrouter.com/ + +- Context (global state): https://react.dev/learn/passing-data-deeply-with-context + +## Deploy (Vite build + serving with backend) + +### Build commands + +- Dev server: +~~~ +npm run dev +~~~ + +- Production build (outputs static files): +~~~ +npm run build +~~~ + +- Preview the production build locally: +~~~ +npm run preview +~~~ + +Vite builds your React app into **vanilla JS/CSS/HTML assets** in `dist/` +React still runs in the browser, but now it’s bundled + optimized for production. + +### Serve the built frontend from a Node backend (Express example) + +If your backend is Express, you can serve the `dist/` folder at `/`: + +~~~ +import express from "express"; +import path from "path"; + +const app = express(); +const distPath = path.join(process.cwd(), "frontend", "dist"); + +app.use(express.static(distPath)); + +// SPA fallback: send index.html for unknown routes +app.get("*", (req, res) => { + res.sendFile(path.join(distPath, "index.html")); +}); + +app.listen(3000, () => console.log("Server running on http://localhost:3000")); +~~~ + +### Other options +- Deploy frontend separately (simplest) and call your backend via HTTP: + - Vercel, Netlify, Cloudflare Pages, GitHub Pages + +- Or host `dist/` on any static server (NGINX, S3, etc.) + diff --git a/frontend-development/react-example-tutorial/vite-project/.gitignore b/frontend-development/react-example-tutorial/vite-project/.gitignore new file mode 100644 index 0000000..a547bf3 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/.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/frontend-development/react-example-tutorial/vite-project/README.md b/frontend-development/react-example-tutorial/vite-project/README.md new file mode 100644 index 0000000..d2e7761 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/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/frontend-development/react-example-tutorial/vite-project/eslint.config.js b/frontend-development/react-example-tutorial/vite-project/eslint.config.js new file mode 100644 index 0000000..5e6b472 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/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/frontend-development/react-example-tutorial/vite-project/index.html b/frontend-development/react-example-tutorial/vite-project/index.html new file mode 100644 index 0000000..1440f42 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/index.html @@ -0,0 +1,13 @@ + + + + + + + vite-project + + +
+ + + diff --git a/frontend-development/react-example-tutorial/vite-project/package-lock.json b/frontend-development/react-example-tutorial/vite-project/package-lock.json new file mode 100644 index 0000000..6847a5d --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/package-lock.json @@ -0,0 +1,3257 @@ +{ + "name": "vite-project", + "version": "0.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "vite-project", + "version": "0.0.0", + "dependencies": { + "react": "^19.2.0", + "react-dom": "^19.2.0" + }, + "devDependencies": { + "@eslint/js": "^9.39.1", + "@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", + "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", + "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.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", + "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", + "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/@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.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.55.1.tgz", + "integrity": "sha512-9R0DM/ykwfGIlNu6+2U09ga0WXeZ9MRC2Ter8jnz8415VbuIykVuc6bhdrbORFZANDmTDvq26mJrEVTl8TdnDg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.55.1.tgz", + "integrity": "sha512-eFZCb1YUqhTysgW3sj/55du5cG57S7UTNtdMjCW7LwVcj3dTTcowCsC8p7uBdzKsZYa8J7IDE8lhMI+HX1vQvg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.55.1.tgz", + "integrity": "sha512-p3grE2PHcQm2e8PSGZdzIhCKbMCw/xi9XvMPErPhwO17vxtvCN5FEA2mSLgmKlCjHGMQTP6phuQTYWUnKewwGg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.55.1.tgz", + "integrity": "sha512-rDUjG25C9qoTm+e02Esi+aqTKSBYwVTaoS1wxcN47/Luqef57Vgp96xNANwt5npq9GDxsH7kXxNkJVEsWEOEaQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.55.1.tgz", + "integrity": "sha512-+JiU7Jbp5cdxekIgdte0jfcu5oqw4GCKr6i3PJTlXTCU5H5Fvtkpbs4XJHRmWNXF+hKmn4v7ogI5OQPaupJgOg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.55.1.tgz", + "integrity": "sha512-V5xC1tOVWtLLmr3YUk2f6EJK4qksksOYiz/TCsFHu/R+woubcLWdC9nZQmwjOAbmExBIVKsm1/wKmEy4z4u4Bw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.55.1.tgz", + "integrity": "sha512-Rn3n+FUk2J5VWx+ywrG/HGPTD9jXNbicRtTM11e/uorplArnXZYsVifnPPqNNP5BsO3roI4n8332ukpY/zN7rQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.55.1.tgz", + "integrity": "sha512-grPNWydeKtc1aEdrJDWk4opD7nFtQbMmV7769hiAaYyUKCT1faPRm2av8CX1YJsZ4TLAZcg9gTR1KvEzoLjXkg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.55.1.tgz", + "integrity": "sha512-a59mwd1k6x8tXKcUxSyISiquLwB5pX+fJW9TkWU46lCqD/GRDe9uDN31jrMmVP3feI3mhAdvcCClhV8V5MhJFQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.55.1.tgz", + "integrity": "sha512-puS1MEgWX5GsHSoiAsF0TYrpomdvkaXm0CofIMG5uVkP6IBV+ZO9xhC5YEN49nsgYo1DuuMquF9+7EDBVYu4uA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.55.1.tgz", + "integrity": "sha512-r3Wv40in+lTsULSb6nnoudVbARdOwb2u5fpeoOAZjFLznp6tDU8kd+GTHmJoqZ9lt6/Sys33KdIHUaQihFcu7g==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.55.1.tgz", + "integrity": "sha512-MR8c0+UxAlB22Fq4R+aQSPBayvYa3+9DrwG/i1TKQXFYEaoW3B5b/rkSRIypcZDdWjWnpcvxbNaAJDcSbJU3Lw==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.55.1.tgz", + "integrity": "sha512-3KhoECe1BRlSYpMTeVrD4sh2Pw2xgt4jzNSZIIPLFEsnQn9gAnZagW9+VqDqAHgm1Xc77LzJOo2LdigS5qZ+gw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.55.1.tgz", + "integrity": "sha512-ziR1OuZx0vdYZZ30vueNZTg73alF59DicYrPViG0NEgDVN8/Jl87zkAPu4u6VjZST2llgEUjaiNl9JM6HH1Vdw==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.55.1.tgz", + "integrity": "sha512-uW0Y12ih2XJRERZ4jAfKamTyIHVMPQnTZcQjme2HMVDAHY4amf5u414OqNYC+x+LzRdRcnIG1YodLrrtA8xsxw==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.55.1.tgz", + "integrity": "sha512-u9yZ0jUkOED1BFrqu3BwMQoixvGHGZ+JhJNkNKY/hyoEgOwlqKb62qu+7UjbPSHYjiVy8kKJHvXKv5coH4wDeg==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.55.1.tgz", + "integrity": "sha512-/0PenBCmqM4ZUd0190j7J0UsQ/1nsi735iPRakO8iPciE7BQ495Y6msPzaOmvx0/pn+eJVVlZrNrSh4WSYLxNg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.55.1.tgz", + "integrity": "sha512-a8G4wiQxQG2BAvo+gU6XrReRRqj+pLS2NGXKm8io19goR+K8lw269eTrPkSdDTALwMmJp4th2Uh0D8J9bEV1vg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.55.1.tgz", + "integrity": "sha512-bD+zjpFrMpP/hqkfEcnjXWHMw5BIghGisOKPj+2NaNDuVT+8Ds4mPf3XcPHuat1tz89WRL+1wbcxKY3WSbiT7w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.55.1.tgz", + "integrity": "sha512-eLXw0dOiqE4QmvikfQ6yjgkg/xDM+MdU9YJuP4ySTibXU0oAvnEWXt7UDJmD4UkYialMfOGFPJnIHSe/kdzPxg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.55.1.tgz", + "integrity": "sha512-xzm44KgEP11te3S2HCSyYf5zIzWmx3n8HDCc7EE59+lTcswEWNpvMLfd9uJvVX8LCg9QWG67Xt75AuHn4vgsXw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.55.1.tgz", + "integrity": "sha512-yR6Bl3tMC/gBok5cz/Qi0xYnVbIxGx5Fcf/ca0eB6/6JwOY+SRUcJfI0OpeTpPls7f194as62thCt/2BjxYN8g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.55.1.tgz", + "integrity": "sha512-3fZBidchE0eY0oFZBnekYCfg+5wAB0mbpCBuofh5mZuzIU/4jIVkbESmd2dOsFNS78b53CYv3OAtwqkZZmU5nA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.55.1.tgz", + "integrity": "sha512-xGGY5pXj69IxKb4yv/POoocPy/qmEGhimy/FoTpTSVju3FYXUQQMFCaZZXJVidsmGxRioZAwpThl/4zX41gRKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.55.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.55.1.tgz", + "integrity": "sha512-SPEpaL6DX4rmcXtnhdrQYgzQ5W2uW3SCJch88lB2zImhJRhIIK44fkUrgIV/Q8yUNfw5oyZ5vkeQsZLhCb06lw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "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/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.7", + "resolved": "https://registry.npmjs.org/@types/node/-/node-24.10.7.tgz", + "integrity": "sha512-+054pVMzVTmRQV8BhpGv3UyfZ2Llgl8rdpDTon+cUH9+na0ncBVXj3wTUKh14+Kiz18ziM3b4ikpP5/Pc0rQEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~7.16.0" + } + }, + "node_modules/@types/react": { + "version": "19.2.8", + "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.8.tgz", + "integrity": "sha512-3MbSL37jEchWZz2p2mjntRZtPt837ij10ApxKfgmXCTuHWagYg7iA5bqPw6C8BMPfwidlvfPI/fxOc42HLhcyg==", + "dev": true, + "license": "MIT", + "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/@typescript-eslint/eslint-plugin": { + "version": "8.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.52.0.tgz", + "integrity": "sha512-okqtOgqu2qmZJ5iN4TWlgfF171dZmx2FzdOv2K/ixL2LZWDStL8+JgQerI2sa8eAEfoydG9+0V96m7V+P8yE1Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/regexpp": "^4.12.2", + "@typescript-eslint/scope-manager": "8.52.0", + "@typescript-eslint/type-utils": "8.52.0", + "@typescript-eslint/utils": "8.52.0", + "@typescript-eslint/visitor-keys": "8.52.0", + "ignore": "^7.0.5", + "natural-compare": "^1.4.0", + "ts-api-utils": "^2.4.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.52.0", + "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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.52.0.tgz", + "integrity": "sha512-iIACsx8pxRnguSYhHiMn2PvhvfpopO9FXHyn1mG5txZIsAaB6F0KwbFnUQN3KCiG3Jcuad/Cao2FAs1Wp7vAyg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/scope-manager": "8.52.0", + "@typescript-eslint/types": "8.52.0", + "@typescript-eslint/typescript-estree": "8.52.0", + "@typescript-eslint/visitor-keys": "8.52.0", + "debug": "^4.4.3" + }, + "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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.52.0.tgz", + "integrity": "sha512-xD0MfdSdEmeFa3OmVqonHi+Cciab96ls1UhIF/qX/O/gPu5KXD0bY9lu33jj04fjzrXHcuvjBcBC+D3SNSadaw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/tsconfig-utils": "^8.52.0", + "@typescript-eslint/types": "^8.52.0", + "debug": "^4.4.3" + }, + "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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.52.0.tgz", + "integrity": "sha512-ixxqmmCcc1Nf8S0mS0TkJ/3LKcC8mruYJPOU6Ia2F/zUUR4pApW7LzrpU3JmtePbRUTes9bEqRc1Gg4iyRnDzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.52.0", + "@typescript-eslint/visitor-keys": "8.52.0" + }, + "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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.52.0.tgz", + "integrity": "sha512-jl+8fzr/SdzdxWJznq5nvoI7qn2tNYV/ZBAEcaFMVXf+K6jmXvAFrgo/+5rxgnL152f//pDEAYAhhBAZGrVfwg==", + "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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.52.0.tgz", + "integrity": "sha512-JD3wKBRWglYRQkAtsyGz1AewDu3mTc7NtRjR/ceTyGoPqmdS5oCdx/oZMWD5Zuqmo6/MpsYs0wp6axNt88/2EQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.52.0", + "@typescript-eslint/typescript-estree": "8.52.0", + "@typescript-eslint/utils": "8.52.0", + "debug": "^4.4.3", + "ts-api-utils": "^2.4.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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.52.0.tgz", + "integrity": "sha512-LWQV1V4q9V4cT4H5JCIx3481iIFxH1UkVk+ZkGGAV1ZGcjGI9IoFOfg3O6ywz8QqCDEp7Inlg6kovMofsNRaGg==", + "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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.52.0.tgz", + "integrity": "sha512-XP3LClsCc0FsTK5/frGjolyADTh3QmsLp6nKd476xNI9CsSsLnmn4f0jrzNoAulmxlmNIpeXuHYeEQv61Q6qeQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/project-service": "8.52.0", + "@typescript-eslint/tsconfig-utils": "8.52.0", + "@typescript-eslint/types": "8.52.0", + "@typescript-eslint/visitor-keys": "8.52.0", + "debug": "^4.4.3", + "minimatch": "^9.0.5", + "semver": "^7.7.3", + "tinyglobby": "^0.2.15", + "ts-api-utils": "^2.4.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.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.52.0.tgz", + "integrity": "sha512-wYndVMWkweqHpEpwPhwqE2lnD2DxC6WVLupU/DOt/0/v+/+iQbbzO3jOHjmBMnhu0DgLULvOaU4h4pwHYi2oRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.9.1", + "@typescript-eslint/scope-manager": "8.52.0", + "@typescript-eslint/types": "8.52.0", + "@typescript-eslint/typescript-estree": "8.52.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/visitor-keys": { + "version": "8.52.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.52.0.tgz", + "integrity": "sha512-ink3/Zofus34nmBsPjow63FP5M7IGff0RKAgqR6+CFpdk22M7aLwC9gOcLGYqr7MczLPzZVERW9hRog3O4n1sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.52.0", + "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", + "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.14", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.9.14.tgz", + "integrity": "sha512-B0xUquLkiGLgHhpPBqvl7GWegWBUNuujQ6kXd/r1U38ElPT6Ok8KZ8e+FpUGEc2ZoRQUzq/aUnaKFc/svWUGSg==", + "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", + "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.30001764", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001764.tgz", + "integrity": "sha512-9JGuzl2M+vPL+pz70gtMF9sHdMFbY9FJaQBi186cHKH3pSzDvzoUJUPV6fqiKIMyXbud9ZLg4F3Yza1vJ1+93g==", + "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/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/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==", + "dev": true, + "license": "MIT" + }, + "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/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/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/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", + "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.7.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", + "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", + "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/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/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/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/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/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/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/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", + "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", + "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", + "dependencies": { + "scheduler": "^0.27.0" + }, + "peerDependencies": { + "react": "^19.2.3" + } + }, + "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/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.55.1", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.55.1.tgz", + "integrity": "sha512-wDv/Ht1BNHB4upNbK74s9usvl7hObDnvVzknxqY/E/O3X6rW1U1rV1aENEfJ54eFZDTNo7zv1f5N4edCluH7+A==", + "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.55.1", + "@rollup/rollup-android-arm64": "4.55.1", + "@rollup/rollup-darwin-arm64": "4.55.1", + "@rollup/rollup-darwin-x64": "4.55.1", + "@rollup/rollup-freebsd-arm64": "4.55.1", + "@rollup/rollup-freebsd-x64": "4.55.1", + "@rollup/rollup-linux-arm-gnueabihf": "4.55.1", + "@rollup/rollup-linux-arm-musleabihf": "4.55.1", + "@rollup/rollup-linux-arm64-gnu": "4.55.1", + "@rollup/rollup-linux-arm64-musl": "4.55.1", + "@rollup/rollup-linux-loong64-gnu": "4.55.1", + "@rollup/rollup-linux-loong64-musl": "4.55.1", + "@rollup/rollup-linux-ppc64-gnu": "4.55.1", + "@rollup/rollup-linux-ppc64-musl": "4.55.1", + "@rollup/rollup-linux-riscv64-gnu": "4.55.1", + "@rollup/rollup-linux-riscv64-musl": "4.55.1", + "@rollup/rollup-linux-s390x-gnu": "4.55.1", + "@rollup/rollup-linux-x64-gnu": "4.55.1", + "@rollup/rollup-linux-x64-musl": "4.55.1", + "@rollup/rollup-openbsd-x64": "4.55.1", + "@rollup/rollup-openharmony-arm64": "4.55.1", + "@rollup/rollup-win32-arm64-msvc": "4.55.1", + "@rollup/rollup-win32-ia32-msvc": "4.55.1", + "@rollup/rollup-win32-x64-gnu": "4.55.1", + "@rollup/rollup-win32-x64-msvc": "4.55.1", + "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/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/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.4.0", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.4.0.tgz", + "integrity": "sha512-3TaVTaAv2gTiMB35i3FiGJaRfwb3Pyn/j3m/bfAvGe8FB7CF6u+LMYqYlDh7reQf7UNvoTvdfAqHGmPGOSsPmA==", + "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", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/typescript-eslint": { + "version": "8.52.0", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.52.0.tgz", + "integrity": "sha512-atlQQJ2YkO4pfTVQmQ+wvYQwexPDOIgo+RaVcD7gHgzy/IQA+XTyuxNM9M9TVXvttkF7koBHmcwisKdOAf2EcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/eslint-plugin": "8.52.0", + "@typescript-eslint/parser": "8.52.0", + "@typescript-eslint/typescript-estree": "8.52.0", + "@typescript-eslint/utils": "8.52.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/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/vite": { + "version": "7.3.1", + "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz", + "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==", + "dev": true, + "license": "MIT", + "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.3.5", + "resolved": "https://registry.npmjs.org/zod/-/zod-4.3.5.tgz", + "integrity": "sha512-k7Nwx6vuWx1IJ9Bjuf4Zt1PEllcwe7cls3VNzm4CQ1/hgtFUK2bRNG3rvnpPUhFjmqJKAKtjV576KnUkHocg/g==", + "dev": true, + "license": "MIT", + "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/frontend-development/react-example-tutorial/vite-project/package.json b/frontend-development/react-example-tutorial/vite-project/package.json new file mode 100644 index 0000000..cc26d77 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/package.json @@ -0,0 +1,30 @@ +{ + "name": "vite-project", + "private": true, + "version": "0.0.0", + "type": "module", + "scripts": { + "dev": "vite", + "build": "tsc -b && vite build", + "lint": "eslint .", + "preview": "vite preview" + }, + "dependencies": { + "react": "^19.2.0", + "react-dom": "^19.2.0" + }, + "devDependencies": { + "@eslint/js": "^9.39.1", + "@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", + "typescript": "~5.9.3", + "typescript-eslint": "^8.46.4", + "vite": "^7.2.4" + } +} diff --git a/frontend-development/react-example-tutorial/vite-project/public/vite.svg b/frontend-development/react-example-tutorial/vite-project/public/vite.svg new file mode 100644 index 0000000..e7b8dfb --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/public/vite.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/frontend-development/react-example-tutorial/vite-project/src/App.css b/frontend-development/react-example-tutorial/vite-project/src/App.css new file mode 100644 index 0000000..b9d355d --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/src/App.css @@ -0,0 +1,42 @@ +#root { + max-width: 1280px; + margin: 0 auto; + padding: 2rem; + text-align: center; +} + +.logo { + height: 6em; + padding: 1.5em; + will-change: filter; + transition: filter 300ms; +} +.logo:hover { + filter: drop-shadow(0 0 2em #646cffaa); +} +.logo.react:hover { + filter: drop-shadow(0 0 2em #61dafbaa); +} + +@keyframes logo-spin { + from { + transform: rotate(0deg); + } + to { + transform: rotate(360deg); + } +} + +@media (prefers-reduced-motion: no-preference) { + a:nth-of-type(2) .logo { + animation: logo-spin infinite 20s linear; + } +} + +.card { + padding: 2em; +} + +.read-the-docs { + color: #888; +} diff --git a/frontend-development/react-example-tutorial/vite-project/src/App.tsx b/frontend-development/react-example-tutorial/vite-project/src/App.tsx new file mode 100644 index 0000000..ea05386 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/src/App.tsx @@ -0,0 +1,5 @@ +import { HomePage } from "./pages/HomePage"; + +export default function App() { + return ; +} diff --git a/frontend-development/react-example-tutorial/vite-project/src/assets/react.svg b/frontend-development/react-example-tutorial/vite-project/src/assets/react.svg new file mode 100644 index 0000000..6c87de9 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/src/assets/react.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/frontend-development/react-example-tutorial/vite-project/src/components/Counter.tsx b/frontend-development/react-example-tutorial/vite-project/src/components/Counter.tsx new file mode 100644 index 0000000..1969984 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/src/components/Counter.tsx @@ -0,0 +1,22 @@ +import { useState } from "react"; + +type CounterProps = { + maxValue: number; +}; + +export function Counter({ maxValue }: CounterProps) { + const [value, setValue] = useState(0); + + const inc = () => setValue((v) => Math.min(v + 1, maxValue)); + const reset = () => setValue(0); + + return ( +
+
Value: {value}
+ + +
+ ); +} diff --git a/frontend-development/react-example-tutorial/vite-project/src/index.css b/frontend-development/react-example-tutorial/vite-project/src/index.css new file mode 100644 index 0000000..08a3ac9 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/src/index.css @@ -0,0 +1,68 @@ +:root { + font-family: system-ui, Avenir, Helvetica, Arial, sans-serif; + line-height: 1.5; + font-weight: 400; + + color-scheme: light dark; + color: rgba(255, 255, 255, 0.87); + background-color: #242424; + + font-synthesis: none; + text-rendering: optimizeLegibility; + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; +} + +a { + font-weight: 500; + color: #646cff; + text-decoration: inherit; +} +a:hover { + color: #535bf2; +} + +body { + margin: 0; + display: flex; + place-items: center; + min-width: 320px; + min-height: 100vh; +} + +h1 { + font-size: 3.2em; + line-height: 1.1; +} + +button { + border-radius: 8px; + border: 1px solid transparent; + padding: 0.6em 1.2em; + font-size: 1em; + font-weight: 500; + font-family: inherit; + background-color: #1a1a1a; + cursor: pointer; + transition: border-color 0.25s; +} +button:hover { + border-color: #646cff; +} +button:focus, +button:focus-visible { + outline: 4px auto -webkit-focus-ring-color; +} + +@media (prefers-color-scheme: light) { + :root { + color: #213547; + background-color: #ffffff; + } + a:hover { + color: #747bff; + } + button { + background-color: #f9f9f9; + } +} diff --git a/frontend-development/react-example-tutorial/vite-project/src/main.tsx b/frontend-development/react-example-tutorial/vite-project/src/main.tsx new file mode 100644 index 0000000..bef5202 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/src/main.tsx @@ -0,0 +1,10 @@ +import { StrictMode } from 'react' +import { createRoot } from 'react-dom/client' +import './index.css' +import App from './App.tsx' + +createRoot(document.getElementById('root')!).render( + + + , +) diff --git a/frontend-development/react-example-tutorial/vite-project/src/pages/HomePage.tsx b/frontend-development/react-example-tutorial/vite-project/src/pages/HomePage.tsx new file mode 100644 index 0000000..9807558 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/src/pages/HomePage.tsx @@ -0,0 +1,10 @@ +import { Counter } from "../components/Counter"; + +export function HomePage() { + return ( +
+

This is my counter

+ +
+ ); +} diff --git a/frontend-development/react-example-tutorial/vite-project/tsconfig.app.json b/frontend-development/react-example-tutorial/vite-project/tsconfig.app.json new file mode 100644 index 0000000..a9b5a59 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/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/frontend-development/react-example-tutorial/vite-project/tsconfig.json b/frontend-development/react-example-tutorial/vite-project/tsconfig.json new file mode 100644 index 0000000..1ffef60 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/tsconfig.json @@ -0,0 +1,7 @@ +{ + "files": [], + "references": [ + { "path": "./tsconfig.app.json" }, + { "path": "./tsconfig.node.json" } + ] +} diff --git a/frontend-development/react-example-tutorial/vite-project/tsconfig.node.json b/frontend-development/react-example-tutorial/vite-project/tsconfig.node.json new file mode 100644 index 0000000..8a67f62 --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/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/frontend-development/react-example-tutorial/vite-project/vite.config.ts b/frontend-development/react-example-tutorial/vite-project/vite.config.ts new file mode 100644 index 0000000..8b0f57b --- /dev/null +++ b/frontend-development/react-example-tutorial/vite-project/vite.config.ts @@ -0,0 +1,7 @@ +import { defineConfig } from 'vite' +import react from '@vitejs/plugin-react' + +// https://vite.dev/config/ +export default defineConfig({ + plugins: [react()], +}) From f77b88b6bc5b8441233f6e2ac2fbb6f5f7fdbf21 Mon Sep 17 00:00:00 2001 From: qwazzarr Date: Mon, 12 Jan 2026 16:26:48 +0000 Subject: [PATCH 02/16] added styles --- .../react-example-tutorial/README.MD | 79 ++++++++++++++++++- 1 file changed, 75 insertions(+), 4 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 09dd83c..51c508f 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -120,7 +120,7 @@ Code `src/components/Counter.tsx` -~~~ +~~~typescript import { useState } from "react"; type CounterProps = { @@ -147,7 +147,7 @@ export function Counter({ maxValue }: CounterProps) { `src/pages/HomePage.tsx` -~~~ +~~~typescript import { Counter } from "../components/Counter"; export function HomePage() { @@ -205,7 +205,7 @@ useEffect(() => { ~~~ - Fetch data safely (avoid setting state if unmounted): -~~~ +~~~typescript useEffect(() => { const controller = new AbortController(); @@ -227,6 +227,77 @@ For bigger apps: - Context (global state): https://react.dev/learn/passing-data-deeply-with-context +## Styling in React (quick overview) + +There is **no single “correct” way** to style React apps. For hackathons, pick the fastest option your team already knows. + +### 1) Plain CSS (`.css` files) +The simplest and most explicit approach. + +**How it works** +- Write normal CSS +- Import it into a component or entry file + +Example: +```css +/* src/styles/main.css */ +.container { + display: flex; + justify-content: center; + align-items: center; +} +``` + +```typescript +import "./styles/main.css"; + +export function HomePage() { + return
Hello
; +} +``` + +### 2) CSS Modules (recommended if using plain CSS) + +Same as CSS, but scoped by default. + +File name **must be** `*.module.css.` + +```css +/* Counter.module.css */ +.wrapper { + padding: 16px; +} +``` + +```typescript +import styles from "./Counter.module.css"; + +export function Counter() { + return
Counter
; +} +``` +Pros : No class name collisions. + +### Inline styles (what you already used) + +~~~typescript +
+~~~ +Pros : no extra files + +### Tailwind CSS + +Utility-first CSS framework. You style directly in `className` +Website: https://tailwindcss.com/ + +~~~typescript +
+

This is my counter

+
+~~~ +Pros: fast development + + ## Deploy (Vite build + serving with backend) ### Build commands @@ -253,7 +324,7 @@ React still runs in the browser, but now it’s bundled + optimized for producti If your backend is Express, you can serve the `dist/` folder at `/`: -~~~ +~~~js import express from "express"; import path from "path"; From 3e6c68ded8088ca6305f850d3ad611e0cc72436d Mon Sep 17 00:00:00 2001 From: qwazzarr Date: Mon, 12 Jan 2026 16:27:59 +0000 Subject: [PATCH 03/16] fix --- frontend-development/react-example-tutorial/README.MD | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 51c508f..64d503c 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -1,4 +1,4 @@ -# React Hackathon Frontend Mini-Guide (with Vite) +# React Hackathon Frontend Mini-Guide ## 1) What is React (and why it’s perfect for hackathons) **React** is a JavaScript library for building user interfaces by composing **reusable components**. You write UI as a function of state, and React updates the DOM efficiently when state changes. From 9445d6cf117689637c316706e1693204cbc48c3f Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 00:43:18 +0000 Subject: [PATCH 04/16] markdown linting --- .../react-example-tutorial/README.MD | 109 +++++++++++------- 1 file changed, 66 insertions(+), 43 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 64d503c..24b0a3a 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -1,29 +1,34 @@ # React Hackathon Frontend Mini-Guide -## 1) What is React (and why it’s perfect for hackathons) +## What is React? (and why it’s perfect for hackathons) + **React** is a JavaScript library for building user interfaces by composing **reusable components**. You write UI as a function of state, and React updates the DOM efficiently when state changes. Why it’s great for hackathons: + - **Fast iteration**: instant updates while you code (Hot Module Reloading). - **Component reuse**: build small pieces once, reuse everywhere. - **Huge ecosystem**: UI libs, routers, state tools, deploy platforms. - **Team-friendly**: clear structure; easy to split work (“you take this component/page”). -Official docs: https://react.dev/ +Official docs: --- -## 2) How to start +## How to start ### Required JS/TS + You can use plain **JavaScript**, but **TypeScript (TS)** is strongly recommended. TS is basically **JS + types**, which catches dumb bugs early and makes teamwork easier. -TypeScript docs: https://www.typescriptlang.org/ +TypeScript docs: ### Repo structure (recommended) + If your hackathon repo has backend + frontend, keep them separated: -~~~ + +~~~txt my-project/ backend/ frontend @@ -32,11 +37,12 @@ frontend This prevents dependency/config chaos and makes deploy easier. ### Create a React app with Vite (recommended) + **Vite** is a modern dev server + build tool. It’s fast because it uses native ES modules in dev and bundles for production. -Vite: https://vitejs.dev/ +Vite: -~~~ +~~~bash mkdir frontend cd frontend @@ -44,13 +50,14 @@ npm create vite@latest . -- --template react-ts npm install npm run dev ~~~ -Open the URL printed in the terminal (usually http://localhost:5173) + +Open the URL printed in the terminal (usually ) ## What Vite created (and what the files mean) Key files you’ll see: -~~~ +~~~txt package.json ~~~ @@ -58,65 +65,68 @@ Your project metadata + scripts + dependencies. Example scripts: "dev", "build", "preview" -~~~ +~~~txt package-lock.json (npm) / pnpm-lock.yaml / yarn.lock ~~~ Locks exact dependency versions so everyone gets the same installs. -~~~ +~~~txt tsconfig.json (+ sometimes tsconfig.app.json, tsconfig.node.json) ~~~ TypeScript compiler options (strictness, module settings, path aliases, etc.) -~~~ +~~~txt vite.config.ts ~~~ Vite configuration (plugins, aliases, proxies, build options). -~~~ +~~~txt index.html ~~~ The single HTML entry point (Vite injects your JS into it). -~~~ +~~~txt src/main.tsx ~~~ + The real entry file. It mounts React into the DOM. -~~~ +~~~txt src/App.tsx ~~~ + The starter component you’ll edit first. ### No restart required -When you edit `src/App.tsx` (or any component), Vite does HMR: updates the page instantly without restarting the server. +When you edit `src/App.tsx` (or any component), Vite does HMR: updates the page instantly without restarting the server. This is why React dev feels “live”. ## React Components (what they actually are) A component is a reusable UI unit. In modern React, components are usually functions (not classes). They: + - take **props** (inputs) - return **JSX** (HTML-like syntax) - can have **state** via hooks (e.g `useState`) Common structure: -~~~ +~~~bash src/ components/ # reusable UI building blocks (buttons, cards, Counter, etc.) pages/ # full screens/routes (HomePage, DashboardPage, etc.) App.tsx ~~~ -## Example: Page using a `` +## *Example*: Page using a `` -Code +Code `src/components/Counter.tsx` @@ -162,7 +172,7 @@ export function HomePage() { `src/App.tsx` -~~~ +~~~txt import { HomePage } from "./pages/HomePage"; export default function App() { @@ -179,7 +189,7 @@ export default function App() { - `useRef` — mutable value that doesn’t trigger rerenders; also DOM refs. - `useContext` — share data across many components without prop-drilling -Hooks reference: https://react.dev/reference/react +Hooks reference: ## Rerender mechanics + the `useEffect` trap @@ -188,7 +198,8 @@ Hooks reference: https://react.dev/reference/react The common `useEffect` trap (infinite loop) Bad: -~~~ + +~~~typescript useEffect(() => { setValue(value + 1); }, [value]); @@ -197,14 +208,17 @@ useEffect(() => { This updates `value`, which triggers the effect again, forever. Better patterns: + - Only run once on mount -~~~ + +~~~typescript useEffect(() => { // run once }, []); ~~~ - Fetch data safely (avoid setting state if unmounted): + ~~~typescript useEffect(() => { const controller = new AbortController(); @@ -218,64 +232,69 @@ useEffect(() => { return () => controller.abort(); }, []); ~~~ + If you feel stuck: read Effects properly (it’s where most beginner bugs come from): -https://react.dev/learn/synchronizing-with-effects + For bigger apps: -- Router (pages + URLs): https://reactrouter.com/ +- Router (pages + URLs): -- Context (global state): https://react.dev/learn/passing-data-deeply-with-context +- Context (global state): ## Styling in React (quick overview) There is **no single “correct” way** to style React apps. For hackathons, pick the fastest option your team already knows. -### 1) Plain CSS (`.css` files) +### Plain CSS (`.css` files) + The simplest and most explicit approach. -**How it works** +#### How it works + - Write normal CSS - Import it into a component or entry file Example: -```css + +~~~css /* src/styles/main.css */ .container { display: flex; justify-content: center; align-items: center; } -``` +~~~ -```typescript +~~~typescript import "./styles/main.css"; export function HomePage() { return
Hello
; } -``` +~~~ -### 2) CSS Modules (recommended if using plain CSS) +### CSS Modules (recommended if using plain CSS) Same as CSS, but scoped by default. File name **must be** `*.module.css.` -```css +~~~css /* Counter.module.css */ .wrapper { padding: 16px; } -``` +~~~ -```typescript +~~~typescript import styles from "./Counter.module.css"; export function Counter() { return
Counter
; } -``` +~~~ + Pros : No class name collisions. ### Inline styles (what you already used) @@ -283,37 +302,41 @@ Pros : No class name collisions. ~~~typescript
~~~ + Pros : no extra files ### Tailwind CSS Utility-first CSS framework. You style directly in `className` -Website: https://tailwindcss.com/ +Website: ~~~typescript

This is my counter

~~~ -Pros: fast development +Pros: fast development ## Deploy (Vite build + serving with backend) ### Build commands - Dev server: -~~~ + +~~~bash npm run dev ~~~ - Production build (outputs static files): -~~~ + +~~~bash npm run build ~~~ - Preview the production build locally: -~~~ + +~~~bash npm run preview ~~~ @@ -342,8 +365,8 @@ app.listen(3000, () => console.log("Server running on http://localhost:3000")); ~~~ ### Other options + - Deploy frontend separately (simplest) and call your backend via HTTP: - Vercel, Netlify, Cloudflare Pages, GitHub Pages - Or host `dist/` on any static server (NGINX, S3, etc.) - From 75d334f9aacb1725dc5ee206a487067cefaed61a Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 00:46:44 +0000 Subject: [PATCH 05/16] updated introduction --- frontend-development/react-example-tutorial/README.MD | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 24b0a3a..fc194e5 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -1,19 +1,17 @@ # React Hackathon Frontend Mini-Guide -## What is React? (and why it’s perfect for hackathons) +## What is React? -**React** is a JavaScript library for building user interfaces by composing **reusable components**. You write UI as a function of state, and React updates the DOM efficiently when state changes. +**React** is a JavaScript library for building user interfaces by composing **reusable components**. You write UI as a function of state, and React updates the '**DOM**' ([Document Object Model](https://legacy.reactjs.org/docs/faq-internals.html)) efficiently when state changes. -Why it’s great for hackathons: +### Why it’s great for hackathons - **Fast iteration**: instant updates while you code (Hot Module Reloading). - **Component reuse**: build small pieces once, reuse everywhere. - **Huge ecosystem**: UI libs, routers, state tools, deploy platforms. - **Team-friendly**: clear structure; easy to split work (“you take this component/page”). -Official docs: - ---- +[Official docs](https://react.dev/). ## How to start From f343b39d818468086ee4c404cd9064bf6ee97dc5 Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 00:53:01 +0000 Subject: [PATCH 06/16] added actual links --- .../react-example-tutorial/README.MD | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index fc194e5..ca8df65 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -20,7 +20,7 @@ You can use plain **JavaScript**, but **TypeScript (TS)** is strongly recommended. TS is basically **JS + types**, which catches dumb bugs early and makes teamwork easier. -TypeScript docs: +[TypeScript docs](https://www.typescriptlang.org/). ### Repo structure (recommended) @@ -38,7 +38,7 @@ This prevents dependency/config chaos and makes deploy easier. **Vite** is a modern dev server + build tool. It’s fast because it uses native ES modules in dev and bundles for production. -Vite: +[Vite](https://vitejs.dev/). ~~~bash mkdir frontend @@ -49,7 +49,7 @@ npm install npm run dev ~~~ -Open the URL printed in the terminal (usually ) +Open the URL printed in the terminal (usually ). ## What Vite created (and what the files mean) @@ -187,7 +187,7 @@ export default function App() { - `useRef` — mutable value that doesn’t trigger rerenders; also DOM refs. - `useContext` — share data across many components without prop-drilling -Hooks reference: +[Hooks reference](https://react.dev/reference/react/). ## Rerender mechanics + the `useEffect` trap @@ -231,14 +231,13 @@ useEffect(() => { }, []); ~~~ -If you feel stuck: read Effects properly (it’s where most beginner bugs come from): - +If you feel stuck: read the [docs on Effects](https://react.dev/learn/synchronizing-with-effects) properly (it’s where most beginner bugs come from): For bigger apps: -- Router (pages + URLs): +- [Router (pages + URLs)](https://reactrouter.com/). -- Context (global state): +- [Context (global state)](https://react.dev/learn/passing-data-deeply-with-context). ## Styling in React (quick overview) @@ -305,8 +304,9 @@ Pros : no extra files ### Tailwind CSS -Utility-first CSS framework. You style directly in `className` -Website: +Utility-first CSS framework. You style directly in `className`. + +Refer to [the website](https://tailwindcss.com/). ~~~typescript
From 33aa3877f8480455409f17b39933229d69f9ed98 Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:08:07 +0000 Subject: [PATCH 07/16] clarified notes on 'How to start' and refactored section on files created by Vite into that section --- .../react-example-tutorial/README.MD | 66 ++++++------------- 1 file changed, 19 insertions(+), 47 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index ca8df65..946e0ae 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -18,13 +18,13 @@ ### Required JS/TS You can use plain **JavaScript**, but **TypeScript (TS)** is strongly recommended. -TS is basically **JS + types**, which catches dumb bugs early and makes teamwork easier. +TS can be thought of as **JS + types**, which catches dumb bugs early and makes teamwork easier. [TypeScript docs](https://www.typescriptlang.org/). ### Repo structure (recommended) -If your hackathon repo has backend + frontend, keep them separated: +If your IC Hack repo has both a backend and frontend component, keep them separated: ~~~txt my-project/ @@ -32,13 +32,11 @@ backend/ frontend ~~~ -This prevents dependency/config chaos and makes deploy easier. +This prevents dependency/configuration chaos and makes deployment easier. ### Create a React app with Vite (recommended) -**Vite** is a modern dev server + build tool. It’s fast because it uses native ES modules in dev and bundles for production. - -[Vite](https://vitejs.dev/). +[**Vite**](https://vitejs.dev/) is a modern development server + build tool. It’s fast because it uses native ES modules in development and bundles for production. ~~~bash mkdir frontend @@ -49,59 +47,33 @@ npm install npm run dev ~~~ -Open the URL printed in the terminal (usually ). - -## What Vite created (and what the files mean) - -Key files you’ll see: - -~~~txt -package.json -~~~ - -Your project metadata + scripts + dependencies. - -Example scripts: "dev", "build", "preview" - -~~~txt -package-lock.json (npm) / pnpm-lock.yaml / yarn.lock -~~~ - -Locks exact dependency versions so everyone gets the same installs. +Open the URL printed in the terminal (usually in the format , for your Vite server's dedicated port). -~~~txt -tsconfig.json (+ sometimes tsconfig.app.json, tsconfig.node.json) -~~~ +### Files created by Vite -TypeScript compiler options (strictness, module settings, path aliases, etc.) +**`package.json`** is an important file that you'll come across. It contains your project metadata, scripts, and dependencies. -~~~txt -vite.config.ts -~~~ +You might also see some **example scripts**: `dev`, `build` & `preview`. -Vite configuration (plugins, aliases, proxies, build options). +The files below **lock the exact dependency versions** on your project so everyone gets the same installs. -~~~txt -index.html -~~~ + ~~~txt + package-lock.json (npm) / pnpm-lock.yaml / yarn.lock + ~~~ -The single HTML entry point (Vite injects your JS into it). +**`tsconfig.json`** (with the optional addition of `tsconfig.app.json` & `tsconfig.node.json`) specifies **TypeScript compiler options** (strictness, module settings, path aliases, etc.) -~~~txt -src/main.tsx -~~~ +**`vite.config.ts`** gives your **Vite configuration** (plugins, aliases, proxies, build options). -The real entry file. It mounts React into the DOM. +**`index.html`** is the single **HTML entry point** (Vite injects your JS into it) for your web app. -~~~txt -src/App.tsx -~~~ +**`src/main.tsx`** is the **real entry file**. It mounts React into the DOM. -The starter component you’ll edit first. +**`src/App.tsx`** is the starter React component that you’ll edit first. -### No restart required +#### *'No restart required'* -When you edit `src/App.tsx` (or any component), Vite does HMR: updates the page instantly without restarting the server. +When you edit `src/App.tsx` (or any React component), Vite does '**HMR**' (Hot Module Replacement), updating the page instantly without restarting the server. This is why React dev feels “live”. ## React Components (what they actually are) From 94c362bff3b28362284f0eaec91624691bfac21c Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:12:32 +0000 Subject: [PATCH 08/16] some clarifications on component explanation --- .../react-example-tutorial/README.MD | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 946e0ae..a59a491 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -76,16 +76,16 @@ The files below **lock the exact dependency versions** on your project so every When you edit `src/App.tsx` (or any React component), Vite does '**HMR**' (Hot Module Replacement), updating the page instantly without restarting the server. This is why React dev feels “live”. -## React Components (what they actually are) +## What are React components? -A component is a reusable UI unit. In modern React, components are usually functions (not classes). +A **component** is a reusable UI unit. In modern React, components are usually functions (not classes). They: -- take **props** (inputs) -- return **JSX** (HTML-like syntax) -- can have **state** via hooks (e.g `useState`) +- take **props** (inputs), +- return **JSX** (HTML-like syntax), +- and can have **state** via hooks (e.g `useState`). -Common structure: +A common repository structure for a React app using components might look like the following: ~~~bash src/ From 2d7d6a6609c64a640735418e74d3cbada7afec04 Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:17:07 +0000 Subject: [PATCH 09/16] better formatting for page example --- .../react-example-tutorial/README.MD | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index a59a491..8b63a87 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -94,11 +94,13 @@ src/ App.tsx ~~~ -## *Example*: Page using a `` +### *Example*: Page using a `Counter maxValue={...}` -Code +To develop our understanding of components further, let's take a look at how we could **develop a page** in React using a **`Counter` component**. -`src/components/Counter.tsx` +All code snippets below are available in the [example project](/frontend-development/react-example-tutorial/vite-project/). + +[`src/components/Counter.tsx`](/frontend-development/react-example-tutorial/vite-project/src/components/Counter.tsx) ~~~typescript import { useState } from "react"; @@ -125,7 +127,7 @@ export function Counter({ maxValue }: CounterProps) { } ~~~ -`src/pages/HomePage.tsx` +[`src/pages/HomePage.tsx`](/frontend-development/react-example-tutorial/vite-project/src/pages/HomePage.tsx) ~~~typescript import { Counter } from "../components/Counter"; @@ -140,9 +142,9 @@ export function HomePage() { } ~~~ -`src/App.tsx` +[`src/App.tsx`](/frontend-development/react-example-tutorial/vite-project/src/App.tsx) -~~~txt +~~~typescript import { HomePage } from "./pages/HomePage"; export default function App() { From e8b171aebbc75d9dd160a34105f46ceae15d6128 Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:18:58 +0000 Subject: [PATCH 10/16] more concise hooks section --- frontend-development/react-example-tutorial/README.MD | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 8b63a87..dd9180d 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -152,7 +152,7 @@ export default function App() { } ~~~ -## Main React Hooks (short, useful) +## Some short and useful [React hooks](https://react.dev/reference/react/) - `useState` — local component state. - `useEffect` — run side effects (fetching, subscriptions, timers) @@ -161,8 +161,6 @@ export default function App() { - `useRef` — mutable value that doesn’t trigger rerenders; also DOM refs. - `useContext` — share data across many components without prop-drilling -[Hooks reference](https://react.dev/reference/react/). - ## Rerender mechanics + the `useEffect` trap **Rerender rule** : A component rerenders when its state, props, or context changes. From d96e045d0834e899028680ab5240dfee6f9e9bdc Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:22:02 +0000 Subject: [PATCH 11/16] complete sentences in `useEffect` trap section --- .../react-example-tutorial/README.MD | 21 ++++++++----------- 1 file changed, 9 insertions(+), 12 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index dd9180d..a311cac 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -161,25 +161,22 @@ export default function App() { - `useRef` — mutable value that doesn’t trigger rerenders; also DOM refs. - `useContext` — share data across many components without prop-drilling -## Rerender mechanics + the `useEffect` trap +## Rerender mechanics and the `useEffect` trap -**Rerender rule** : A component rerenders when its state, props, or context changes. - -The common `useEffect` trap (infinite loop) - -Bad: +The '**rerender rule**' describes how a component rerenders when its state, props, or context changes. +The common `useEffect` trap, which some people can fall into and which causes an infinite loop, can be seen below. ~~~typescript useEffect(() => { setValue(value + 1); }, [value]); ~~~ -This updates `value`, which triggers the effect again, forever. +The `setValue()` call updates `value`, which triggers the `useEffect()` again, forever. -Better patterns: +Some *better* patterns can be seen below. -- Only run once on mount +- Only run the effect once on **mount**. ~~~typescript useEffect(() => { @@ -187,7 +184,7 @@ useEffect(() => { }, []); ~~~ -- Fetch data safely (avoid setting state if unmounted): +- Fetch data safely (and avoid setting state if unmounted). ~~~typescript useEffect(() => { @@ -203,9 +200,9 @@ useEffect(() => { }, []); ~~~ -If you feel stuck: read the [docs on Effects](https://react.dev/learn/synchronizing-with-effects) properly (it’s where most beginner bugs come from): +If you feel stuck on this code, read the [docs on Effects](https://react.dev/learn/synchronizing-with-effects) properly (it’s where most beginner bugs come from): -For bigger apps: +For bigger apps, you might find these further resources useful too: - [Router (pages + URLs)](https://reactrouter.com/). From e401174eb05812796ff47befc33b3be24d709df9 Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:22:14 +0000 Subject: [PATCH 12/16] MD lint --- frontend-development/react-example-tutorial/README.MD | 1 + 1 file changed, 1 insertion(+) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index a311cac..56a3e41 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -166,6 +166,7 @@ export default function App() { The '**rerender rule**' describes how a component rerenders when its state, props, or context changes. The common `useEffect` trap, which some people can fall into and which causes an infinite loop, can be seen below. + ~~~typescript useEffect(() => { setValue(value + 1); From 551c0a1308656d7d2871d466792776c5829217b3 Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:33:30 +0000 Subject: [PATCH 13/16] clearer section on styling --- .../react-example-tutorial/README.MD | 30 +++++++++---------- 1 file changed, 14 insertions(+), 16 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 56a3e41..107b9ed 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -211,7 +211,7 @@ For bigger apps, you might find these further resources useful too: ## Styling in React (quick overview) -There is **no single “correct” way** to style React apps. For hackathons, pick the fastest option your team already knows. +There is **no single “correct” way** to style React apps. For IC Hack, pick the fastest option your team already knows, or go with whatever looks most understandable out of the options we give. ### Plain CSS (`.css` files) @@ -219,10 +219,8 @@ The simplest and most explicit approach. #### How it works -- Write normal CSS -- Import it into a component or entry file - -Example: +- Write ['normal CSS'](https://www.w3schools.com/csSref/index.php) +- Import it directly into a React component or entry file ~~~css /* src/styles/main.css */ @@ -241,11 +239,11 @@ export function HomePage() { } ~~~ -### CSS Modules (recommended if using plain CSS) +### CSS Modules -Same as CSS, but scoped by default. +Same as CSS, but *scoped* by default. **This approach is recommended** if your team ends up using plain CSS. -File name **must be** `*.module.css.` +File name **must be** in the format `*.module.css.` ~~~css /* Counter.module.css */ @@ -262,21 +260,21 @@ export function Counter() { } ~~~ -Pros : No class name collisions. +This approach gives us the benefit of avoiding **class name collisions**. + +### Inline styles -### Inline styles (what you already used) +You would have already come across this approach in the earlier examples. ~~~typescript
~~~ -Pros : no extra files - -### Tailwind CSS +Here, we remove the need for **extra files** to define our CSS styles. -Utility-first CSS framework. You style directly in `className`. +### [Tailwind CSS](https://tailwindcss.com/) -Refer to [the website](https://tailwindcss.com/). +A utility-first CSS framework. You style directly in the `className` prop of a component. ~~~typescript
@@ -284,7 +282,7 @@ Refer to [the website](https://tailwindcss.com/).
~~~ -Pros: fast development +This enables **fast development**. ## Deploy (Vite build + serving with backend) From bd18bc3ed97725899e5f31db3dfba18bcfc2ae3f Mon Sep 17 00:00:00 2001 From: Adam Kassam Date: Thu, 15 Jan 2026 01:39:23 +0000 Subject: [PATCH 14/16] clearer deployment section --- .../react-example-tutorial/README.MD | 40 ++++++++----------- 1 file changed, 16 insertions(+), 24 deletions(-) diff --git a/frontend-development/react-example-tutorial/README.MD b/frontend-development/react-example-tutorial/README.MD index 107b9ed..a455f76 100644 --- a/frontend-development/react-example-tutorial/README.MD +++ b/frontend-development/react-example-tutorial/README.MD @@ -284,34 +284,27 @@ A utility-first CSS framework. You style directly in the `className` prop of a c This enables **fast development**. -## Deploy (Vite build + serving with backend) +## Deployment + +We will cover how to **build your React app with Vite** and also serve it with a **backend**. ### Build commands -- Dev server: +You will probably find the below commands useful to try out, build and run your application through the Vite server. -~~~bash -npm run dev -~~~ +- **`npm run dev`** starts a Vite **development server**. +- **`npm run build`** generates a **production build**, which will output static files in the process. +- **`npm run preview`** allows you to **preview the production build** locally. -- Production build (outputs static files): +--- -~~~bash -npm run build -~~~ +Vite builds your React app into **vanilla JS/CSS/HTML assets** in `dist/` when you are ready for an actual production build. -- Preview the production build locally: +Your React app will still be running in the browser, but now it’s bundled and optimised for production. -~~~bash -npm run preview -~~~ - -Vite builds your React app into **vanilla JS/CSS/HTML assets** in `dist/` -React still runs in the browser, but now it’s bundled + optimized for production. +### **Express** *example*: Serve the built frontend from a Node backend -### Serve the built frontend from a Node backend (Express example) - -If your backend is Express, you can serve the `dist/` folder at `/`: +If your backend is written in [Express](https://expressjs.com/), you can serve the `dist/` folder at `/`: ~~~js import express from "express"; @@ -330,9 +323,8 @@ app.get("*", (req, res) => { app.listen(3000, () => console.log("Server running on http://localhost:3000")); ~~~ -### Other options - -- Deploy frontend separately (simplest) and call your backend via HTTP: - - Vercel, Netlify, Cloudflare Pages, GitHub Pages +### Other deployment options -- Or host `dist/` on any static server (NGINX, S3, etc.) +- Deploy the frontend for your application separately (simplest) and call your backend via **HTTP**. + - *Example backends*: Vercel, Netlify, Cloudflare Pages, GitHub Pages. +- Or **host your static assets** from `dist/` on any static server (NGINX, S3, etc.). From f4706dff7955f4052aea04e1b34d3c2493bb7c92 Mon Sep 17 00:00:00 2001 From: qwazzarr Date: Mon, 19 Jan 2026 04:33:40 +0000 Subject: [PATCH 15/16] Resolved some comments --- .idea/.gitignore | 8 -------- .idea/discord.xml | 7 ------- .idea/ichack-hackpacks.iml | 12 ------------ .idea/inspectionProfiles/Project_Default.xml | 6 ------ .idea/modules.xml | 8 -------- .idea/vcs.xml | 6 ------ .../react-example-tutorial/assets/img.png | Bin 0 -> 15623 bytes .../vite-project/src/components/Counter.tsx | 2 +- .../vite-project/src/pages/HomePage.tsx | 5 ++++- 9 files changed, 5 insertions(+), 49 deletions(-) delete mode 100644 .idea/.gitignore delete mode 100644 .idea/discord.xml delete mode 100644 .idea/ichack-hackpacks.iml delete mode 100644 .idea/inspectionProfiles/Project_Default.xml delete mode 100644 .idea/modules.xml delete mode 100644 .idea/vcs.xml create mode 100644 frontend-development/react-example-tutorial/assets/img.png diff --git a/.idea/.gitignore b/.idea/.gitignore deleted file mode 100644 index 13566b8..0000000 --- a/.idea/.gitignore +++ /dev/null @@ -1,8 +0,0 @@ -# Default ignored files -/shelf/ -/workspace.xml -# Editor-based HTTP Client requests -/httpRequests/ -# Datasource local storage ignored files -/dataSources/ -/dataSources.local.xml diff --git a/.idea/discord.xml b/.idea/discord.xml deleted file mode 100644 index 30bab2a..0000000 --- a/.idea/discord.xml +++ /dev/null @@ -1,7 +0,0 @@ - - - - - \ No newline at end of file diff --git a/.idea/ichack-hackpacks.iml b/.idea/ichack-hackpacks.iml deleted file mode 100644 index 24643cc..0000000 --- a/.idea/ichack-hackpacks.iml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml deleted file mode 100644 index 03d9549..0000000 --- a/.idea/inspectionProfiles/Project_Default.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml deleted file mode 100644 index 91b69a1..0000000 --- a/.idea/modules.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml deleted file mode 100644 index 35eb1dd..0000000 --- a/.idea/vcs.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/frontend-development/react-example-tutorial/assets/img.png b/frontend-development/react-example-tutorial/assets/img.png new file mode 100644 index 0000000000000000000000000000000000000000..a84b9ad9b73d2486cf6b1f5e8c2bf2edfc7183b1 GIT binary patch literal 15623 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 setValue(0); return ( -
+
Value: {value}
+
; +} +``` + +### `useEffect` and its side effects +`useEffect` is used for side effects — code that interacts with the outside world. + +Common use cases: + +- fetching data +```typescript + useEffect(() => { + async function fetchUsers() { + const res = await fetch("https://jsonplaceholder.typicode.com/users"); + const data = await res.json(); + setUsers(data); + setLoading(false); + } + + fetchUsers(); + }, []); + + return ( +
    {users.map((u) => ( +
  • {u.name}
    • + ))} +
+ ); +``` +- timers (to start a timer the first time person comes to a page) + +- subscriptions + +- logging (e.g logging every time the component rerenders) + +- syncing with browser APIs (e.g `window.addEventListener("resize", onResize);`) + +Basic example that runs once per load of the page: +~~~ +useEffect(() => { + console.log("Component rendered"); +}, []); +~~~ + +It runs after render and dependency array (empty in basic case `[]`) controls on what state changes it runs. + +Dependency pattern: + +~~~ typescript +useEffect(() => { ... }, []) // run once (on mount) +useEffect(() => { ... }, [count]) // run when `count` changes +useEffect(() => { ... }) // run after every render +~~~ + +Clean Up in `useEffect` is important thing to avoid unnecessary behaviour. + +~~~ +useEffect(() => { + const id = setInterval(() => {}, 1000); + return () => clearInterval(id); +}, []); +~~~ + +This removes Interval after the component is *Unmounted* (disappears from DOM) + +### Rerender mechanics and the `useEffect` trap + +The '**rerender rule**' describes how a component rerenders when its state, props, or context changes. + +The common `useEffect` trap, which some people can fall into and which causes an infinite loop, can be seen below. + +~~~typescript +useEffect(() => { + setValue(value + 1); +}, [value]); +~~~ + +The `setValue()` call updates `value`, which triggers the `useEffect()` again, forever. + +Some *better* patterns can be seen below. + +- Only run the effect once on **mount**. + +~~~typescript +useEffect(() => { + // run once +}, []); +~~~ + +- Fetch data safely (and avoid setting state if unmounted). + +~~~typescript +useEffect(() => { + const controller = new AbortController(); + + (async () => { + const res = await fetch("/api/data", { signal: controller.signal }); + const json = await res.json(); + // setState(json) + })(); + + return () => controller.abort(); +}, []); +~~~ + +If you feel stuck on this code, read the [docs on Effects](https://react.dev/learn/synchronizing-with-effects) properly (it’s where most beginner bugs come from): + + +## *Example*: Page using a `Counter maxValue={...}` To develop our understanding of components further, let's take a look at how we could **develop a page** in React using a **`Counter` component**. +It will have a simple counter with two buttons (reset and increment) as well as maxValue that will make the increment button disabled. All code snippets below are available in the [example project](/frontend-development/react-example-tutorial/vite-project/). @@ -152,7 +351,13 @@ export default function App() { } ~~~ -## Some short and useful [React hooks](https://react.dev/reference/react/) +You should get something like this in the end: + +![img.png](assets/img.png) + +## Some short and useful [hooks](https://react.dev/reference/react/) + +There is a lots of other functionality in React hooks besides remembering the state. - `useState` — local component state. - `useEffect` — run side effects (fetching, subscriptions, timers) @@ -161,48 +366,6 @@ export default function App() { - `useRef` — mutable value that doesn’t trigger rerenders; also DOM refs. - `useContext` — share data across many components without prop-drilling -## Rerender mechanics and the `useEffect` trap - -The '**rerender rule**' describes how a component rerenders when its state, props, or context changes. - -The common `useEffect` trap, which some people can fall into and which causes an infinite loop, can be seen below. - -~~~typescript -useEffect(() => { - setValue(value + 1); -}, [value]); -~~~ - -The `setValue()` call updates `value`, which triggers the `useEffect()` again, forever. - -Some *better* patterns can be seen below. - -- Only run the effect once on **mount**. - -~~~typescript -useEffect(() => { - // run once -}, []); -~~~ - -- Fetch data safely (and avoid setting state if unmounted). - -~~~typescript -useEffect(() => { - const controller = new AbortController(); - - (async () => { - const res = await fetch("/api/data", { signal: controller.signal }); - const json = await res.json(); - // setState(json) - })(); - - return () => controller.abort(); -}, []); -~~~ - -If you feel stuck on this code, read the [docs on Effects](https://react.dev/learn/synchronizing-with-effects) properly (it’s where most beginner bugs come from): - For bigger apps, you might find these further resources useful too: - [Router (pages + URLs)](https://reactrouter.com/). @@ -241,7 +404,8 @@ export function HomePage() { ### CSS Modules -Same as CSS, but *scoped* by default. **This approach is recommended** if your team ends up using plain CSS. +Same as CSS, but *scoped* by default. **This approach is recommended** if your team ends up using plain CSS , since +styles will be applied only to the components that import them , avoiding mess. File name **must be** in the format `*.module.css.` @@ -260,7 +424,7 @@ export function Counter() { } ~~~ -This approach gives us the benefit of avoiding **class name collisions**. +This approach also gives us the benefit of avoiding **class name collisions**. ### Inline styles @@ -282,11 +446,19 @@ A utility-first CSS framework. You style directly in the `className` prop of a c
~~~ -This enables **fast development**. +This enables **fast development** , since: + +- you don’t switch context between JSX and separate CSS files +- no need to invent or maintain class names +- styles are applied instantly without writing new CSS +- layout and spacing are predictable and consistent +- No need for extra css classes + +The downside is learning Tailwind syntax, which is a bit different from plain CSS. ## Deployment -We will cover how to **build your React app with Vite** and also serve it with a **backend**. +We will cover how to create a build file from your React project which can be later pulled from a backend API. ### Build commands @@ -322,9 +494,38 @@ app.get("*", (req, res) => { app.listen(3000, () => console.log("Server running on http://localhost:3000")); ~~~ +### *FastAPI* default path frontend serving. + +```python +from fastapi import FastAPI +from fastapi.staticfiles import StaticFiles +from fastapi.responses import FileResponse +from pathlib import Path + +app = FastAPI() + +dist_path = Path(__file__).parent / "frontend" / "dist" + +# Serve static assets (JS, CSS, images) +app.mount("/assets", StaticFiles(directory=dist_path / "assets"), name="assets") + +@app.get("/{full_path:path}") +def serve_spa(full_path: str): +return FileResponse(dist_path / "index.html") +``` ### Other deployment options - Deploy the frontend for your application separately (simplest) and call your backend via **HTTP**. - *Example backends*: Vercel, Netlify, Cloudflare Pages, GitHub Pages. - Or **host your static assets** from `dist/` on any static server (NGINX, S3, etc.). + +## Key takeaways + +By this point, you should understand the core ideas behind a modern React-based web app: + +- React builds UIs from **components** +- **State** drives the UI; React handles DOM updates for you +- **Hooks** (`useState`, `useEffect`) let function components store data and run side effects +- Styling can be done quickly with **Tailwind CSS** or safely with **CSS Modules** +- Frontend apps are typically built and then **served by a backend** (e.g. Express or FastAPI)