diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 000000000..21fea1503 --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,11 @@ +{ + "name": "Angular Challenges", + "image": "mcr.microsoft.com/devcontainers/typescript-node:22", + "postCreateCommand": "corepack enable pnpm && pnpm install", + "forwardPorts": [4200], + "customizations": { + "vscode": { + "extensions": ["angular.ng-template", "nrwl.angular-console"] + } + } +} diff --git a/cli/README.md b/cli/README.md new file mode 100644 index 000000000..96d4ac834 --- /dev/null +++ b/cli/README.md @@ -0,0 +1,42 @@ +# angular-challenges CLI + +Try a challenge from [Angular Challenges](https://angular-challenges.vercel.app) with one command: + +```bash +npx angular-challenges start 19 +``` + +This will: + +1. find your GitHub account (via the `gh` CLI if signed in, otherwise it asks), +2. fork `tomalaforge/angular-challenges` to your account (or reuse your fork), +3. ask where to clone your fork — default `./angular-challenges` (or reuse an existing clone), +4. create an `answer-19` branch from the latest upstream `main`, +5. run `pnpm install`, +6. open the project in your editor (VS Code, Cursor, Windsurf or JetBrains), and +7. serve the challenge app. + +When your solution is ready: + +```bash +npx angular-challenges submit +``` + +pushes your branch and opens a pre-filled pull request page (`Answer:19`). + +## Options + +- `--dir ` — clone location. Skips the question, so it also works in scripts: + `npx angular-challenges start 19 --dir ~/code`. If the folder already has files + in it, the clone goes into `/angular-challenges`. + +## Requirements + +- Node.js ≥ 20 and git. `pnpm` is enabled automatically through corepack. +- A GitHub account. The [GitHub CLI](https://cli.github.com) is optional but makes forking seamless. + +## Publishing (maintainers) + +```bash +cd cli && npm publish +``` diff --git a/cli/index.mjs b/cli/index.mjs new file mode 100644 index 000000000..436065b50 --- /dev/null +++ b/cli/index.mjs @@ -0,0 +1,369 @@ +#!/usr/bin/env node +/** + * angular-challenges — try a challenge with one command. + * + * npx angular-challenges start [--dir ] + * fork + clone + install + branch + open IDE + serve + * npx angular-challenges submit push your answer branch and open the PR page + * + * Zero dependencies; needs git and Node >= 20. Uses the GitHub CLI (gh) when + * available, and falls back to the browser for anything that needs an account. + */ +import { spawnSync } from 'node:child_process'; +import { existsSync, readdirSync, readFileSync } from 'node:fs'; +import { homedir } from 'node:os'; +import { join, resolve } from 'node:path'; +import { createInterface } from 'node:readline/promises'; + +const UPSTREAM = 'tomalaforge/angular-challenges'; +const REPO_NAME = 'angular-challenges'; +const WEBSITE = 'https://angular-challenges.vercel.app'; + +const bold = (s) => `\x1b[1m${s}\x1b[0m`; +const dim = (s) => `\x1b[2m${s}\x1b[0m`; +const pink = (s) => `\x1b[35m${s}\x1b[0m`; +const green = (s) => `\x1b[32m${s}\x1b[0m`; +const red = (s) => `\x1b[31m${s}\x1b[0m`; +const step = (s) => console.log(`\n${pink('▸')} ${bold(s)}`); +const info = (s) => console.log(` ${s}`); + +const isWindows = process.platform === 'win32'; + +function run(command, args, options = {}) { + const result = spawnSync(command, args, { stdio: 'inherit', shell: isWindows, ...options }); + if (result.status !== 0 && !options.allowFailure) { + console.error(red(`\n✗ \`${command} ${args.join(' ')}\` failed.`)); + process.exit(1); + } + return result.status === 0; +} + +function capture(command, args, options = {}) { + const result = spawnSync(command, args, { encoding: 'utf8', shell: isWindows, ...options }); + return result.status === 0 ? result.stdout.trim() : null; +} + +function has(command) { + return capture(isWindows ? 'where' : 'which', [command]) !== null; +} + +function openInBrowser(url) { + const opener = isWindows ? 'start' : process.platform === 'darwin' ? 'open' : 'xdg-open'; + spawnSync(opener, [url], { shell: isWindows, stdio: 'ignore' }); + info(`Opened ${dim(url)}`); +} + +async function ask(question, fallback = '') { + // Piped/CI runs have no one to answer — take the default instead of hanging. + if (!process.stdin.isTTY) { + return fallback; + } + const rl = createInterface({ input: process.stdin, output: process.stdout }); + const answer = (await rl.question(` ${question}`)).trim(); + rl.close(); + return answer || fallback; +} + +async function forkExists(login) { + try { + const response = await fetch(`https://api.github.com/repos/${login}/${REPO_NAME}`, { + headers: { Accept: 'application/vnd.github+json', 'User-Agent': 'angular-challenges-cli' }, + }); + if (response.status !== 200) { + return false; + } + const repo = await response.json(); + return repo.fork === true || repo.full_name.toLowerCase() !== UPSTREAM; + } catch { + return false; + } +} + +/** GitHub login: gh CLI, then git config, then ask. */ +async function githubLogin() { + const fromGh = capture('gh', ['api', 'user', '-q', '.login']); + if (fromGh) { + return fromGh; + } + const fromConfig = capture('git', ['config', '--global', 'github.user']); + if (fromConfig) { + return fromConfig; + } + return await ask('Your GitHub username: '); +} + +/** Root of the clone: cwd if already inside one, ./angular-challenges, or null. */ +function findExistingClone() { + const gitRoot = capture('git', ['rev-parse', '--show-toplevel']); + if (gitRoot) { + const origin = capture('git', ['remote', 'get-url', 'origin'], { cwd: gitRoot }) ?? ''; + if (origin.includes(`/${REPO_NAME}`)) { + return gitRoot; + } + } + const local = resolve(REPO_NAME); + if (existsSync(join(local, '.git'))) { + return local; + } + return null; +} + +function expandHome(path) { + return path === '~' || path.startsWith('~/') ? join(homedir(), path.slice(1)) : path; +} + +function isRepoClone(dir) { + if (!existsSync(join(dir, '.git'))) { + return false; + } + const origin = capture('git', ['remote', 'get-url', 'origin'], { cwd: dir }) ?? ''; + return origin.includes(`/${REPO_NAME}`); +} + +function isEmptyDir(dir) { + try { + return readdirSync(dir).length === 0; + } catch { + return false; + } +} + +/** + * Where the clone should live. A folder the user names is used as-is when it is + * empty (or already the repo); otherwise we create `/angular-challenges`. + */ +async function chooseCloneDir(preset) { + const suggestion = resolve(REPO_NAME); + while (true) { + const answer = preset ?? (await ask(`Where should I clone it? [${dim(suggestion)}] `)); + preset = undefined; + const target = answer ? resolve(expandHome(answer)) : suggestion; + + if (!existsSync(target) || isEmptyDir(target) || isRepoClone(target)) { + return target; + } + const nested = join(target, REPO_NAME); + if (!existsSync(nested) || isEmptyDir(nested) || isRepoClone(nested)) { + info(`${dim(target)} is not empty — using ${dim(nested)}.`); + return nested; + } + console.log(red(` ${nested} already exists and is not an angular-challenges clone.`)); + if (!process.stdin.isTTY) { + process.exit(1); + } + } +} + +function findChallengeApp(repoDir, number) { + const appsDir = join(repoDir, 'apps'); + for (const category of readdirSync(appsDir)) { + const categoryDir = join(appsDir, category); + let entries; + try { + entries = readdirSync(categoryDir); + } catch { + continue; + } + for (const dir of entries) { + if (dir.startsWith(`${number}-`)) { + let project = null; + try { + project = JSON.parse(readFileSync(join(categoryDir, dir, 'project.json'), 'utf8')).name; + } catch { + /* project.json is optional */ + } + return { path: `apps/${category}/${dir}`, project }; + } + } + } + return null; +} + +function openEditor(repoDir, challengePath) { + for (const editor of ['code', 'cursor', 'windsurf', 'webstorm', 'idea']) { + if (has(editor)) { + const args = + editor === 'code' || editor === 'cursor' || editor === 'windsurf' + ? [repoDir, ...(challengePath ? ['--goto', join(repoDir, challengePath, 'README.md')] : [])] + : [repoDir]; + spawnSync(editor, args, { shell: isWindows, stdio: 'ignore' }); + info(`Opened the project in ${bold(editor)}.`); + return; + } + } + info(dim('No editor CLI found (code/cursor/windsurf/webstorm/idea) — open the folder manually.')); +} + +async function start(number, dir) { + if (!Number.isInteger(number) || number <= 0) { + console.error(red('Usage: npx angular-challenges start [--dir ]')); + process.exit(1); + } + if (!has('git')) { + console.error(red('git is required: https://git-scm.com')); + process.exit(1); + } + + console.log(`\n${bold(`Angular Challenges — challenge #${number}`)}`); + + step('GitHub account'); + const login = await githubLogin(); + if (!login) { + console.error(red('A GitHub account is required to submit your answer.')); + process.exit(1); + } + info(`Hi ${bold('@' + login)}!`); + + step('Fork'); + if (await forkExists(login)) { + info(`Fork ${dim(`${login}/${REPO_NAME}`)} already exists.`); + } else if (has('gh') && capture('gh', ['auth', 'status'])) { + run('gh', ['repo', 'fork', UPSTREAM, '--clone=false']); + } else { + info('Opening GitHub so you can fork the repository…'); + openInBrowser(`https://github.com/${UPSTREAM}/fork`); + await ask('Press Enter once the fork is created… '); + if (!(await forkExists(login))) { + console.error(red(`Could not find ${login}/${REPO_NAME} on GitHub.`)); + process.exit(1); + } + } + + step('Clone'); + let repoDir = dir ? resolve(expandHome(dir)) : findExistingClone(); + if (repoDir && isRepoClone(repoDir)) { + info(`Reusing existing clone at ${dim(repoDir)}.`); + } else { + repoDir = await chooseCloneDir(dir); + run('git', ['clone', `https://github.com/${login}/${REPO_NAME}.git`, repoDir]); + } + const git = (args, options = {}) => run('git', args, { cwd: repoDir, ...options }); + if (!capture('git', ['remote', 'get-url', 'upstream'], { cwd: repoDir })) { + git(['remote', 'add', 'upstream', `https://github.com/${UPSTREAM}.git`]); + } + git(['fetch', 'upstream', 'main']); + + step(`Branch answer-${number}`); + const branch = `answer-${number}`; + const currentBranch = capture('git', ['branch', '--show-current'], { cwd: repoDir }); + if (currentBranch !== branch) { + // Uncommitted work would silently ride along to the new branch. + const dirty = capture('git', ['status', '--porcelain'], { cwd: repoDir }); + if (dirty) { + console.log(red(` You have uncommitted changes on "${currentBranch}":`)); + console.log(dim(dirty.split('\n').slice(0, 8).map((l) => ` ${l}`).join('\n'))); + const answer = await ask('Commit them to the current branch first? [Y/n] '); + if (answer.toLowerCase() !== 'n') { + run('git', ['add', '-A'], { cwd: repoDir }); + run('git', ['commit', '-m', `wip: ${currentBranch}`], { cwd: repoDir }); + } else { + info(dim('Continuing — the changes will follow you to the new branch.')); + } + } + } + const exists = capture('git', ['rev-parse', '--verify', branch], { cwd: repoDir }); + if (exists) { + git(['switch', branch]); + info(`Switched to existing branch ${dim(branch)}.`); + } else { + git(['switch', '-c', branch, 'upstream/main']); + } + + step('Install dependencies'); + if (!has('pnpm')) { + info('pnpm not found — enabling it via corepack…'); + run('corepack', ['enable', 'pnpm'], { allowFailure: true }); + } + run(has('pnpm') ? 'pnpm' : 'npm', ['install'], { cwd: repoDir }); + + const challenge = findChallengeApp(repoDir, number); + + step('Open your editor'); + openEditor(repoDir, challenge?.path); + + console.log(` +${green('✓ You are all set!')} + + Challenge code: ${bold(challenge?.path ?? 'see the challenge doc — this one lives outside apps/')} + When you are done: ${bold(`npx angular-challenges submit`)} ${dim('(from the repo folder)')} +`); + + if (challenge?.project) { + step(`Serve (npx nx serve ${challenge.project}) — Ctrl+C to stop`); + run('npx', ['nx', 'serve', challenge.project], { cwd: repoDir, allowFailure: true }); + } +} + +async function submit() { + const repoDir = findExistingClone(); + if (!repoDir) { + console.error(red('Run this from inside your angular-challenges clone.')); + process.exit(1); + } + const branch = capture('git', ['branch', '--show-current'], { cwd: repoDir }); + const match = branch?.match(/^answer-(\d+)$/); + if (!match) { + console.error(red(`Current branch is "${branch}" — expected an answer- branch.`)); + process.exit(1); + } + const number = match[1]; + + const dirty = capture('git', ['status', '--porcelain'], { cwd: repoDir }); + if (dirty) { + step('Commit'); + const answer = await ask( + `Commit all changes as "feat: answer challenge #${number}"? [Y/n] `, + ); + if (answer.toLowerCase() !== 'n') { + run('git', ['add', '-A'], { cwd: repoDir }); + run('git', ['commit', '-m', `feat: answer challenge #${number}`], { cwd: repoDir }); + } + } + + step(`Push ${branch}`); + run('git', ['push', '-u', 'origin', branch], { cwd: repoDir }); + + const origin = capture('git', ['remote', 'get-url', 'origin'], { cwd: repoDir }) ?? ''; + const login = origin.match(/github\.com[/:]([^/]+)\//)?.[1]; + + step('Open the pull request'); + const title = encodeURIComponent(`Answer:${number}`); + const url = `https://github.com/${UPSTREAM}/compare/main...${login}:${branch}?quick_pull=1&title=${title}`; + openInBrowser(url); + console.log(` +${green('✓ Almost there!')} Review the diff and click ${bold('Create pull request')}. + ${dim(`Keep the title "Answer:${number}" so your PR is picked up automatically.`)} +`); +} + +const argv = process.argv.slice(2); +const dirFlag = argv.findIndex((a) => a === '--dir' || a.startsWith('--dir=')); +let dir; +if (dirFlag !== -1) { + const [flag, inline] = argv[dirFlag].split('='); + dir = inline ?? argv[dirFlag + 1]; + argv.splice(dirFlag, inline ? 1 : 2); + if (!dir) { + console.error(red(`${flag} needs a path.`)); + process.exit(1); + } +} +const [command, argument] = argv; +switch (command) { + case 'start': + await start(Number(argument), dir); + break; + case 'submit': + await submit(); + break; + default: + console.log(` +${bold('angular-challenges')} — solve challenges from ${WEBSITE} + + ${bold('npx angular-challenges start ')} fork, clone, install, branch, serve + ${bold('npx angular-challenges submit')} push your answer and open the PR page + + ${dim('--dir where to clone (skips the question; default ./angular-challenges)')} +`); + process.exit(command ? 1 : 0); +} diff --git a/cli/package.json b/cli/package.json new file mode 100644 index 000000000..890bb66cf --- /dev/null +++ b/cli/package.json @@ -0,0 +1,28 @@ +{ + "name": "angular-challenges", + "version": "0.2.0", + "description": "Start and submit Angular Challenges (https://angular-challenges.vercel.app) from your terminal: fork, clone, install, branch, serve and open a PR.", + "license": "MIT", + "type": "module", + "bin": { + "angular-challenges": "index.mjs" + }, + "files": [ + "index.mjs", + "README.md" + ], + "engines": { + "node": ">=20.0.0" + }, + "repository": { + "type": "git", + "url": "git+https://github.com/tomalaforge/angular-challenges.git", + "directory": "cli" + }, + "keywords": [ + "angular", + "challenges", + "training", + "cli" + ] +} diff --git a/website/.editorconfig b/website/.editorconfig new file mode 100644 index 000000000..f166060da --- /dev/null +++ b/website/.editorconfig @@ -0,0 +1,17 @@ +# Editor configuration, see https://editorconfig.org +root = true + +[*] +charset = utf-8 +indent_style = space +indent_size = 2 +insert_final_newline = true +trim_trailing_whitespace = true + +[*.ts] +quote_type = single +ij_typescript_use_double_quotes = false + +[*.md] +max_line_length = off +trim_trailing_whitespace = false diff --git a/website/.gitignore b/website/.gitignore new file mode 100644 index 000000000..7201e6eab --- /dev/null +++ b/website/.gitignore @@ -0,0 +1,51 @@ +# See https://docs.github.com/get-started/getting-started-with-git/ignoring-files for more about ignoring files. + +# Compiled output +/dist +/tmp +/out-tsc +/bazel-out + +# Node +/node_modules +npm-debug.log +yarn-error.log + +# IDEs and editors +.idea/ +.project +.classpath +.c9/ +*.launch +.settings/ +*.sublime-workspace + +# Visual Studio Code +.vscode/* +!.vscode/settings.json +!.vscode/tasks.json +!.vscode/launch.json +!.vscode/extensions.json +!.vscode/mcp.json +.history/* + +# Miscellaneous +/.angular/cache +.sass-cache/ +/connect.lock +/coverage +/libpeerconnection.log +testem.log +/typings +__screenshots__/ + +# System files +.DS_Store +Thumbs.db +.vercel +.env* + +# generated content +src/app/generated/ +.vercel +.env.local diff --git a/website/.postcssrc.json b/website/.postcssrc.json new file mode 100644 index 000000000..e092dc7c1 --- /dev/null +++ b/website/.postcssrc.json @@ -0,0 +1,5 @@ +{ + "plugins": { + "@tailwindcss/postcss": {} + } +} diff --git a/website/.prettierrc b/website/.prettierrc new file mode 100644 index 000000000..d6c16d7ee --- /dev/null +++ b/website/.prettierrc @@ -0,0 +1,12 @@ +{ + "printWidth": 100, + "singleQuote": true, + "overrides": [ + { + "files": "*.html", + "options": { + "parser": "angular" + } + } + ] +} diff --git a/website/.vscode/extensions.json b/website/.vscode/extensions.json new file mode 100644 index 000000000..77b374577 --- /dev/null +++ b/website/.vscode/extensions.json @@ -0,0 +1,4 @@ +{ + // For more information, visit: https://go.microsoft.com/fwlink/?linkid=827846 + "recommendations": ["angular.ng-template"] +} diff --git a/website/.vscode/launch.json b/website/.vscode/launch.json new file mode 100644 index 000000000..925af8370 --- /dev/null +++ b/website/.vscode/launch.json @@ -0,0 +1,20 @@ +{ + // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 + "version": "0.2.0", + "configurations": [ + { + "name": "ng serve", + "type": "chrome", + "request": "launch", + "preLaunchTask": "npm: start", + "url": "http://localhost:4200/" + }, + { + "name": "ng test", + "type": "chrome", + "request": "launch", + "preLaunchTask": "npm: test", + "url": "http://localhost:9876/debug.html" + } + ] +} diff --git a/website/.vscode/tasks.json b/website/.vscode/tasks.json new file mode 100644 index 000000000..244306f98 --- /dev/null +++ b/website/.vscode/tasks.json @@ -0,0 +1,42 @@ +{ + // For more information, visit: https://go.microsoft.com/fwlink/?LinkId=733558 + "version": "2.0.0", + "tasks": [ + { + "type": "npm", + "script": "start", + "isBackground": true, + "problemMatcher": { + "owner": "typescript", + "pattern": "$tsc", + "background": { + "activeOnStart": true, + "beginsPattern": { + "regexp": "Changes detected" + }, + "endsPattern": { + "regexp": "bundle generation (complete|failed)" + } + } + } + }, + { + "type": "npm", + "script": "test", + "isBackground": true, + "problemMatcher": { + "owner": "typescript", + "pattern": "$tsc", + "background": { + "activeOnStart": true, + "beginsPattern": { + "regexp": "Changes detected" + }, + "endsPattern": { + "regexp": "bundle generation (complete|failed)" + } + } + } + } + ] +} diff --git a/website/README.md b/website/README.md new file mode 100644 index 000000000..79d57f4b3 --- /dev/null +++ b/website/README.md @@ -0,0 +1,59 @@ +# AngularChallengesWebsite + +This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 22.1.4. + +## Development server + +To start a local development server, run: + +```bash +ng serve +``` + +Once the server is running, open your browser and navigate to `http://localhost:4200/`. The application will automatically reload whenever you modify any of the source files. + +## Code scaffolding + +Angular CLI includes powerful code scaffolding tools. To generate a new component, run: + +```bash +ng generate component component-name +``` + +For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run: + +```bash +ng generate --help +``` + +## Building + +To build the project run: + +```bash +ng build +``` + +This will compile your project and store the build artifacts in the `dist/` directory. By default, the production build optimizes your application for performance and speed. + +## Running unit tests + +To execute unit tests with the [Vitest](https://vitest.dev/) test runner, use the following command: + +```bash +ng test +``` + +## Running end-to-end tests + +For end-to-end (e2e) testing, run: + +```bash +ng e2e +``` + +Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs. + +## Additional Resources + +For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page. diff --git a/website/SPEC.md b/website/SPEC.md new file mode 100644 index 000000000..5f72e1e74 --- /dev/null +++ b/website/SPEC.md @@ -0,0 +1,150 @@ +# Angular Challenges Website — Rework Spec + +Replacement of the Astro/Starlight docs (`docs/`) with a fully standalone **Angular v22 SSR** application living in `website/`. English only for v1. Deployed as a **new Vercel project**. + +## Goals + +1. Modern landing page. +2. Same documentation structure as today: left sidebar with **Guides**, **Leaderboard**, **Challenges**. +3. **Main goal:** browse community solutions directly on the website — list of solution PRs per challenge, and a GitHub-like **split diff viewer** when you open one. +4. (Phase 2 — later) Embedded editor to solve a challenge in the browser and submit it as a PR. + +## Tech stack + +| Concern | Choice | +|---|---| +| Framework | Angular v22, standalone components, signals, zoneless | +| SSR | `@angular/ssr` with Express server (server routes for API + OAuth) | +| Styling | Tailwind CSS v4 | +| Content | Markdown files (copied from `docs/src/content/docs`, English only), rendered server-side with `marked` + `shiki` for syntax highlighting | +| Diff rendering | PR patches from GitHub API, parsed and rendered with a custom split-diff component (Shiki-highlighted) | +| Package manager | pnpm (own workspace, standalone from the Nx monorepo — allows Angular v22 while the monorepo stays on 21.x) | +| Hosting | Vercel (SSR server as a Vercel serverless function, static assets on the CDN) | +| Analytics | Google Analytics (same tag `G-6BXJ62W6G5`), Google AdSense (same client id) | +| Comments | giscus (same repo/category config as today) | +| Newsletter | SendPulse embedded form (same form id) | + +## Directory layout + +``` +website/ + SPEC.md + package.json # standalone, not part of the Nx workspace + angular.json + vercel.json + src/ + server.ts # Express + Angular SSR + API routes + main.ts / main.server.ts + content/ + guides/*.md # copied from docs (en only) + challenges//*.md + leaderboard/*.md # intro texts + app/ + layout/ # shell: header, sidebar, footer, mobile menu + pages/ + landing/ + guides/ + leaderboard/ + challenges/ + challenge-detail/ + solutions-list/ + solution-diff/ + shared/ # markdown renderer, diff viewer, github api client, ui bits + public/ +``` + +## Routes (Angular Router, SSR) + +| Route | Render mode | Description | +|---|---|---| +| `/` | prerender | Landing page | +| `/guides/:slug` | prerender | 7 guides (getting-started, resolve-challenge, checkout-answer, create-challenge, contribute, rebase, faq) | +| `/leaderboard/answers` `/leaderboard/challenges` `/leaderboard/commit` | SSR | Leaderboards from GitHub API | +| `/challenges/:category/:slug` | prerender (ISR-refreshable) | Challenge doc page | +| `/challenges/:category/:slug/solutions` | SSR | **NEW** — list of solution PRs | +| `/challenges/:category/:slug/solutions/:prNumber` | SSR | **NEW** — split diff view of one PR | +| `/auth/authorize`, `/auth/callback`, `/auth/logout` | server route | GitHub OAuth flow | +| `/api/*` | server route | JSON endpoints backing the pages (GitHub proxy + cache) | + +Prerendered content pages get correct SEO meta (title, description, og tags) from the markdown frontmatter, matching what Starlight produces today. + +## Layout & pages + +### Landing page (rework) + +Modern Tailwind design, dark-mode first (with light mode toggle), keeping today's content blocks: + +- Sponsor banner (sponsor avatars via `/api/sponsors`, "Become a sponsor" CTA) — sponsors fetched with the server token, same as the current `api/sponsors.js`. +- Hero: logo, tagline "Start now and become an Angular Expert!", CTAs: *Get Started*, *Latest challenge*, *GitHub star*. +- Live GitHub stats strip (stars, forks, contributors, PRs merged) — cached server-side. +- Card grid: 65+ challenges, newsletter subscription, OSS maintainer, learn alongside others, contribute, interview prep. +- Footer: social links (GitHub, LinkedIn, X), attribution. + +### Docs shell + +- Left sidebar identical in structure to today: **Guides** (flat list), **Leaderboard** (3 entries, collapsible), **Challenges** (grouped by category: Angular, Forms, Nx, Performance, RxJS, …, ordered by `sidebar.order` / challenge number), with active-route highlighting, search-free v1 (see Open questions), mobile drawer. +- Right column: table of contents generated from markdown headings (desktop only). +- Header: logo + title, GitHub/LinkedIn/X icons, theme toggle, **Sign in with GitHub** button (avatar + logout when connected). + +### Challenge detail page + +- Markdown body (same content as today, including HTML `
` tips blocks). +- Info asides: how to get started, `npx nx serve ` with copy-to-clipboard. +- Footer metadata: author + contributors (avatars linking to GitHub), video/blog links when present in frontmatter. +- **NEW prominent "Browse solutions" button** → solutions list. +- giscus comment section (mapping: title, same as today). + +### Solutions list (NEW — main goal) + +`GET /api/challenges/:number/solutions` → GitHub search: PRs in `tomalaforge/angular-challenges` with labels `` + `answer` (and `answer author` surfaced separately as the author's solution), sorted by 👍 reactions. + +UI: card list — author avatar/login, PR title, state (open/merged), 👍 count, comments count, created date, link to GitHub. Clicking a card opens the in-site diff view. + +### Solution diff view (NEW — like the attached screenshot) + +`GET /api/pulls/:number/files` → GitHub `pulls/:number/files` (per-file `patch`). + +- **Split (side-by-side) view** like the screenshot: old/new line numbers, red removed / green added line backgrounds with char-level emphasis, collapsed unchanged regions with "N unmodified lines" expanders. +- Unified view toggle for mobile. +- File list header (tree or flat list) with per-file +/− counts; syntax highlighting via Shiki. +- Header: PR title, author, link to the PR on GitHub, 👍 reaction count. A reaction button ("this solution helped me 👍") when signed in. +- Handles GitHub API caveats: files without patches (binary/too large) show a "view on GitHub" fallback; >300 files pagination (never happens for challenges, but no crash). + +### Leaderboards + +Same three boards as today (challenges answered, challenges created, contributions), fed by cached server endpoints instead of client-side GitHub calls, so they render on the server and work for anonymous visitors without burning user rate limits. + +## Authentication & GitHub API strategy + +- **Reuse the existing GitHub OAuth app** (`GITHUB_CLIENT_ID` / `GITHUB_CLIENT_SECRET` env vars) — one new callback URL must be added to it: `https:///auth/callback`. +- Token stored in an **httpOnly secure cookie** (improvement over today's localStorage), refresh handled server-side like today's `auth/refresh`. +- Signing in unlocks: reacting to solutions, higher rate limits for browsing, and (Phase 2) submitting challenges. Read-only browsing works anonymously. +- Server holds a **read-only PAT** (`GITHUB_TOKEN`) used for anonymous traffic, with an in-memory + `Cache-Control`/Vercel CDN cache (solutions list: 5 min; diffs: 1 h; leaderboards/stats/sponsors: 15 min) to stay far below rate limits. + +## Vercel deployment + +- New Vercel project (suggested name: `angular-challenges-website`) rooted at `website/`. +- Build: `pnpm build` (Angular SSR build) + `vercel.json` routing all non-static paths to the SSR function (Node 22 runtime). +- Env vars: `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`, `GITHUB_TOKEN`. +- Old docs project untouched; when the new site is validated, swap the domain over and retire `docs/`. + +## Phase 2 (out of scope for now, spec'd later) + +- "Try this challenge" button → embedded editor (StackBlitz WebContainers or Monaco — TBD). +- Submit flow: fork → branch → commit → PR from the user's account with correct title/labels (counts for the leaderboard). + +## Milestones + +1. **Scaffold**: Angular v22 SSR + Tailwind + Express server + Vercel deploy of a hello-world shell. ✅ deployable from day one. +2. **Content**: markdown pipeline, guides + challenge pages, sidebar, TOC, SEO meta. +3. **Solutions**: API endpoints + solutions list + split diff viewer. +4. **GitHub extras**: OAuth sign-in, leaderboards, stats, sponsors, reactions. +5. **Landing page** rework + giscus + newsletter + analytics. +6. Polish: 404, loading states, mobile, dark/light, redirects from old URLs. + +## Open questions + +1. **Search**: Starlight ships Pagefind search. v1 without search, or include a simple client-side search over titles? *(default: include a lightweight title/description search in the sidebar — cheap to do)* +2. **Old URL compatibility**: keep the exact Starlight paths (`/challenges/forms/48-avoid-losing-form-data/`) so existing links keep working when the domain swaps — assumed **yes**. +3. **Vercel access**: `vercel` CLI is not installed/authenticated on this machine, and login is interactive. Either run `vercel login` once in this workspace terminal, or create a token (vercel.com → Settings → Tokens) and provide it (`VERCEL_TOKEN`), and I'll create/link/deploy the project myself. +4. **Server PAT**: a fine-grained read-only `GITHUB_TOKEN` is needed for anonymous-traffic caching — to be created by Thomas and added to Vercel env (I'll list exact scopes: public repo read only). diff --git a/website/angular.json b/website/angular.json new file mode 100644 index 000000000..87434cdc1 --- /dev/null +++ b/website/angular.json @@ -0,0 +1,81 @@ +{ + "$schema": "./node_modules/@angular/cli/lib/config/schema.json", + "version": 1, + "cli": { + "packageManager": "pnpm" + }, + "newProjectRoot": "projects", + "projects": { + "angular-challenges-website": { + "projectType": "application", + "schematics": {}, + "root": "", + "sourceRoot": "src", + "prefix": "app", + "architect": { + "build": { + "builder": "@angular/build:application", + "options": { + "browser": "src/main.ts", + "tsConfig": "tsconfig.app.json", + "assets": [ + { + "glob": "**/*", + "input": "public" + } + ], + "styles": [ + "src/styles.css" + ], + "server": "src/main.server.ts", + "outputMode": "server", + "security": { + "allowedHosts": [] + }, + "ssr": { + "entry": "src/server.ts" + } + }, + "configurations": { + "production": { + "budgets": [ + { + "type": "initial", + "maximumWarning": "500kB", + "maximumError": "1MB" + }, + { + "type": "anyComponentStyle", + "maximumWarning": "4kB", + "maximumError": "8kB" + } + ], + "outputHashing": "all" + }, + "development": { + "optimization": false, + "extractLicenses": false, + "sourceMap": true + } + }, + "defaultConfiguration": "production" + }, + "serve": { + "builder": "@angular/build:dev-server", + "configurations": { + "production": { + "buildTarget": "angular-challenges-website:build:production" + }, + "development": { + "buildTarget": "angular-challenges-website:build:development" + } + }, + "defaultConfiguration": "development" + }, + "test": { + "builder": "@angular/build:unit-test" + } + } + } + } +} diff --git a/website/api/ssr.js b/website/api/ssr.js new file mode 100644 index 000000000..3ba901e4e --- /dev/null +++ b/website/api/ssr.js @@ -0,0 +1,27 @@ +// Vercel serverless entry: delegates every non-static request to the Angular SSR server. +// CommonJS on purpose — Vercel's Node launcher require()s the handler, and CJS can +// still dynamic-import the ESM server bundle. +let handlerPromise; + +module.exports = async (req, res) => { + try { + handlerPromise ??= import('../dist/angular-challenges-website/server/server.mjs').catch( + (error) => { + // Don't cache a rejected import: the next request on this warm instance retries. + handlerPromise = undefined; + throw error; + }, + ); + const { reqHandler } = await handlerPromise; + return reqHandler(req, res); + } catch (error) { + console.error('SSR handler failed', error); + if (res.headersSent) { + res.destroy(error); + return; + } + res.statusCode = 500; + res.setHeader('content-type', 'text/plain'); + res.end('Internal server error'); + } +}; diff --git a/website/package.json b/website/package.json new file mode 100644 index 000000000..117d0fe62 --- /dev/null +++ b/website/package.json @@ -0,0 +1,51 @@ +{ + "name": "angular-challenges-website", + "version": "0.0.0", + "scripts": { + "ng": "ng", + "start": "pnpm generate && ng serve", + "generate": "node tools/generate-content.mjs", + "build": "pnpm generate && ng build", + "watch": "ng build --watch --configuration development", + "deploy": "vercel pull --yes --environment=production && vercel build --prod && vercel deploy --prebuilt --prod --yes", + "test": "ng test", + "serve:ssr:angular-challenges-website": "node dist/angular-challenges-website/server/server.mjs" + }, + "private": true, + "packageManager": "pnpm@10.23.0", + "dependencies": { + "@angular/common": "^22.1.0", + "@angular/compiler": "^22.1.0", + "@angular/core": "^22.1.0", + "@angular/forms": "^22.1.0", + "@angular/platform-browser": "^22.1.0", + "@angular/platform-server": "^22.1.0", + "@angular/router": "^22.1.0", + "@angular/ssr": "^22.1.4", + "@shikijs/langs": "4.4.3", + "@shikijs/themes": "4.4.3", + "@tailwindcss/postcss": "^4.3.3", + "express": "^5.1.0", + "postcss": "^8.5.26", + "rxjs": "~7.8.0", + "tailwindcss": "^4.3.3", + "tslib": "^2.3.0" + }, + "devDependencies": { + "@angular/build": "^22.1.4", + "@angular/cli": "^22.1.4", + "@angular/compiler-cli": "^22.1.0", + "@tailwindcss/typography": "^0.5.20", + "@types/express": "^5.0.1", + "@types/node": "^20.17.19", + "github-slugger": "^2.0.0", + "gray-matter": "^4.0.3", + "jsdom": "^28.0.0", + "marked": "^18.0.9", + "playwright": "^1.62.1", + "prettier": "^3.8.1", + "shiki": "^4.4.3", + "typescript": "~6.0.2", + "vitest": "^4.0.8" + } +} \ No newline at end of file diff --git a/website/pnpm-lock.yaml b/website/pnpm-lock.yaml new file mode 100644 index 000000000..589754422 --- /dev/null +++ b/website/pnpm-lock.yaml @@ -0,0 +1,5626 @@ +lockfileVersion: '9.0' + +settings: + autoInstallPeers: true + excludeLinksFromLockfile: false + +importers: + + .: + dependencies: + '@angular/common': + specifier: ^22.1.0 + version: 22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2) + '@angular/compiler': + specifier: ^22.1.0 + version: 22.1.2 + '@angular/core': + specifier: ^22.1.0 + version: 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + '@angular/forms': + specifier: ^22.1.0 + version: 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2) + '@angular/platform-browser': + specifier: ^22.1.0 + version: 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)) + '@angular/platform-server': + specifier: ^22.1.0 + version: 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/compiler@22.1.2)(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2) + '@angular/router': + specifier: ^22.1.0 + version: 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2) + '@angular/ssr': + specifier: ^22.1.4 + version: 22.1.4(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-server@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/compiler@22.1.2)(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2))(@angular/router@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2)) + '@shikijs/langs': + specifier: 4.4.3 + version: 4.4.3 + '@shikijs/themes': + specifier: 4.4.3 + version: 4.4.3 + '@tailwindcss/postcss': + specifier: ^4.3.3 + version: 4.3.3 + express: + specifier: ^5.1.0 + version: 5.2.1 + postcss: + specifier: ^8.5.26 + version: 8.5.26 + rxjs: + specifier: ~7.8.0 + version: 7.8.2 + tailwindcss: + specifier: ^4.3.3 + version: 4.3.3 + tslib: + specifier: ^2.3.0 + version: 2.8.1 + devDependencies: + '@angular/build': + specifier: ^22.1.4 + version: 22.1.4(7294df6f0b8344c299db30de3d3b64fb) + '@angular/cli': + specifier: ^22.1.4 + version: 22.1.4(@types/node@20.19.43)(chokidar@5.0.0) + '@angular/compiler-cli': + specifier: ^22.1.0 + version: 22.1.2(@angular/compiler@22.1.2)(typescript@6.0.3) + '@tailwindcss/typography': + specifier: ^0.5.20 + version: 0.5.20(tailwindcss@4.3.3) + '@types/express': + specifier: ^5.0.1 + version: 5.0.6 + '@types/node': + specifier: ^20.17.19 + version: 20.19.43 + github-slugger: + specifier: ^2.0.0 + version: 2.0.0 + gray-matter: + specifier: ^4.0.3 + version: 4.0.3 + jsdom: + specifier: ^28.0.0 + version: 28.1.0 + marked: + specifier: ^18.0.9 + version: 18.0.9 + playwright: + specifier: ^1.62.1 + version: 1.62.1 + prettier: + specifier: ^3.8.1 + version: 3.9.6 + shiki: + specifier: ^4.4.3 + version: 4.4.3 + typescript: + specifier: ~6.0.2 + version: 6.0.3 + vitest: + specifier: ^4.0.8 + version: 4.1.10(@types/node@20.19.43)(jsdom@28.1.0)(vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0)) + +packages: + + '@acemir/cssom@0.9.31': + resolution: {integrity: sha512-ZnR3GSaH+/vJ0YlHau21FjfLYjMpYVIzTD8M8vIEQvIGxeOXyXdzCI140rrCY862p/C/BbzWsjc1dgnM9mkoTA==} + + '@alloc/quick-lru@5.2.0': + resolution: {integrity: sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==} + engines: {node: '>=10'} + + '@ampproject/remapping@2.3.0': + resolution: {integrity: sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==} + engines: {node: '>=6.0.0'} + + '@angular-devkit/architect@0.2201.4': + resolution: {integrity: sha512-a2J9hdBYFobhMx9G0KwCdo6+LrWIOOyIeijrA/QSZiPOjg8dAprhMh7BEQkF3eT6R1q7wDGP+IElVR9LsBlXQw==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0, npm: ^6.11.0 || ^7.5.6 || >=8.0.0, yarn: '>= 1.13.0'} + hasBin: true + + '@angular-devkit/core@22.1.4': + resolution: {integrity: sha512-40jG/6chng9fQuWtpg1kadPO17sRTurNh0aav6Uxebn65PfNpTpvhPIYVIcRgv4tCKdMd++YH95A8SiaIOwqig==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0, npm: ^6.11.0 || ^7.5.6 || >=8.0.0, yarn: '>= 1.13.0'} + peerDependencies: + chokidar: ^5.0.0 + peerDependenciesMeta: + chokidar: + optional: true + + '@angular-devkit/schematics@22.1.4': + resolution: {integrity: sha512-UBJ7jc7B0vRfmrVwlvpmuudo1D7AfpO6ugf1BxvkM4sw5m8cJpZtaIJFKBorv0QZo78CyDOroQfQdXaijjB2ZA==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0, npm: ^6.11.0 || ^7.5.6 || >=8.0.0, yarn: '>= 1.13.0'} + + '@angular/build@22.1.4': + resolution: {integrity: sha512-y5wxiyUu1DjYNG5jiFjjgFp7O5bkyYjWzy2kfyTGq+DjKMEveTzNH3tBkZrE33EJ4wYyfx+rQ01IG9nZbhfdvA==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0, npm: ^6.11.0 || ^7.5.6 || >=8.0.0, yarn: '>= 1.13.0'} + peerDependencies: + '@angular/compiler': ^22.0.0 + '@angular/compiler-cli': ^22.0.0 + '@angular/core': ^22.0.0 + '@angular/localize': ^22.0.0 + '@angular/platform-browser': ^22.0.0 + '@angular/platform-server': ^22.0.0 + '@angular/service-worker': ^22.0.0 + '@angular/ssr': ^22.1.4 + istanbul-lib-instrument: ^6.0.0 + karma: ^6.4.0 + less: ^4.2.0 + ng-packagr: ^22.0.0 + postcss: ^8.4.0 + rollup: ^4.0.0 + tailwindcss: ^2.0.0 || ^3.0.0 || ^4.0.0 + tslib: ^2.3.0 + typescript: '>=6.0 <6.1' + vitest: ^4.0.8 + peerDependenciesMeta: + '@angular/core': + optional: true + '@angular/localize': + optional: true + '@angular/platform-browser': + optional: true + '@angular/platform-server': + optional: true + '@angular/service-worker': + optional: true + '@angular/ssr': + optional: true + istanbul-lib-instrument: + optional: true + karma: + optional: true + less: + optional: true + ng-packagr: + optional: true + postcss: + optional: true + rollup: + optional: true + tailwindcss: + optional: true + vitest: + optional: true + + '@angular/cli@22.1.4': + resolution: {integrity: sha512-Yt6q7a1vXh0ICFHnRdUOmx/gEXZ87zpkvE1eUWREUqeQ3ARkwqNZVzF3IP+s9NpDDrnc+EB9cqel9SnGZ/0z2Q==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0, npm: ^6.11.0 || ^7.5.6 || >=8.0.0, yarn: '>= 1.13.0'} + hasBin: true + + '@angular/common@22.1.2': + resolution: {integrity: sha512-8TzyYPBDvSItV8Vqq8k5u8a9fWaomC9bMEr8z1vVLRZDIPhNQ/UcCyuTYbC7GZkeqrrKGu5m8tjUrA09RCwuaQ==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + peerDependencies: + '@angular/core': 22.1.2 + rxjs: ^6.5.3 || ^7.4.0 + + '@angular/compiler-cli@22.1.2': + resolution: {integrity: sha512-GWRtvQQz/LvKejF/Zpls+hGnnJkvaPPtd3TZnxfZQ1fYCs7b7gpi0YM9PP02TJz51vhlsgkPYJwgtJAKDJEHNQ==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + hasBin: true + peerDependencies: + '@angular/compiler': 22.1.2 + typescript: '>=6.0 <6.1' + peerDependenciesMeta: + typescript: + optional: true + + '@angular/compiler@22.1.2': + resolution: {integrity: sha512-aQv0p5MeXuguCeftUUxK4H8Hbw1hC5Zyu+cFsGbsi025LZ9Ngw+BW+iUHDQZAcqHvWDw2wgGOdKh4e7IkcfRyQ==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + + '@angular/core@22.1.2': + resolution: {integrity: sha512-t7BrgfdeqbdSbFe3CsGX8ySMeKDlZNBPxFMCOanAAqd6W0H1Kh1WFILBs3DIg0NfjpybfSRJAzKcagOFQWNtiw==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + peerDependencies: + '@angular/compiler': 22.1.2 + rxjs: ^6.5.3 || ^7.4.0 + zone.js: ~0.15.0 || ~0.16.0 + peerDependenciesMeta: + '@angular/compiler': + optional: true + zone.js: + optional: true + + '@angular/forms@22.1.2': + resolution: {integrity: sha512-pKDYSNKje/jox74KzswBdX4sL7kJ8OFkJwLnqng8oc7a/NVl/Vf4/Xq4kyowRAdtPcZfLTUnZG6s0qbegfV5mg==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + peerDependencies: + '@angular/common': 22.1.2 + '@angular/core': 22.1.2 + '@angular/platform-browser': 22.1.2 + rxjs: ^6.5.3 || ^7.4.0 + + '@angular/platform-browser@22.1.2': + resolution: {integrity: sha512-MQO735ve/tk4gLsWbw8NyBD/DxPfbbmf1pM/vp6K7tZz2xyysMXilqF/k8PBdQBZVOofST8S13inZHQ35nHuRA==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + peerDependencies: + '@angular/animations': 22.1.2 + '@angular/common': 22.1.2 + '@angular/core': 22.1.2 + peerDependenciesMeta: + '@angular/animations': + optional: true + + '@angular/platform-server@22.1.2': + resolution: {integrity: sha512-RRKARqF95NTK1MCxa6HgU1tZsv8goLdgwnGZRN+8+Q2ujZmbblXo+3nnIsbwUvMr2KyexHnQ3sslfXBgq6B1Dg==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + peerDependencies: + '@angular/common': 22.1.2 + '@angular/compiler': 22.1.2 + '@angular/core': 22.1.2 + '@angular/platform-browser': 22.1.2 + rxjs: ^6.5.3 || ^7.4.0 + + '@angular/router@22.1.2': + resolution: {integrity: sha512-C2c6NJ9HZUfb1L07M554Zpgvi0TvpOBO6Og9L36v/jsv42m7tpOenvqQVPa8R3va7eqLEszCL7wLFcWeJ8naew==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0} + peerDependencies: + '@angular/common': 22.1.2 + '@angular/core': 22.1.2 + '@angular/platform-browser': 22.1.2 + rxjs: ^6.5.3 || ^7.4.0 + + '@angular/ssr@22.1.4': + resolution: {integrity: sha512-9F+st3Wu6D1fjXFLMkeuVxSZc6yDnBak/5/lw2nssgQU2/ph5isTOkXRQ8GA5wTZkJGOjQZabctCUx4IOTYs3w==} + peerDependencies: + '@angular/common': ^22.0.0 + '@angular/core': ^22.0.0 + '@angular/platform-server': ^22.0.0 + '@angular/router': ^22.0.0 + peerDependenciesMeta: + '@angular/platform-server': + optional: true + + '@asamuzakjp/css-color@5.1.11': + resolution: {integrity: sha512-KVw6qIiCTUQhByfTd78h2yD1/00waTmm9uy/R7Ck/ctUyAPj+AEDLkQIdJW0T8+qGgj3j5bpNKK7Q3G+LedJWg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + '@asamuzakjp/dom-selector@6.8.1': + resolution: {integrity: sha512-MvRz1nCqW0fsy8Qz4dnLIvhOlMzqDVBabZx6lH+YywFDdjXhMY37SmpV1XFX3JzG5GWHn63j6HX6QPr3lZXHvQ==} + + '@asamuzakjp/generational-cache@1.0.1': + resolution: {integrity: sha512-wajfB8KqzMCN2KGNFdLkReeHncd0AslUSrvHVvvYWuU8ghncRJoA50kT3zP9MVL0+9g4/67H+cdvBskj9THPzg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + '@asamuzakjp/nwsapi@2.3.9': + resolution: {integrity: sha512-n8GuYSrI9bF7FFZ/SjhwevlHc8xaVlb/7HmHelnc/PZXBD2ZR49NnN9sMMuDdEGPeeRQ5d0hqlSlEpgCX3Wl0Q==} + + '@babel/code-frame@8.0.0': + resolution: {integrity: sha512-dYYg153EyN2Ekbqw2zAsbd6/JR+9N2SEoC7YV2GyyqMM7x9bLDTjBD6XBhSMLH0wtIVyJj03jWNriQhaN+eoCw==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/compat-data@8.0.0': + resolution: {integrity: sha512-DOjnob/cXOUgDOozCDeq/aK2p5y8dUIVdf6tNhEV1HQRd6I8aQ4f4fbtHRVEvb6lP3BGomrKHiS8ICAASSVQSw==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/core@8.0.1': + resolution: {integrity: sha512-5FgxM4dLQpMJHSiVATk8foW263dVHQHBVpXYiimNECVWG01f4nFyEbQixeT6Mwvg7TayREJ2gpKl3o2RoMdnqw==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/generator@8.0.0': + resolution: {integrity: sha512-NT9NrVwJsbSV6Y2FSstWa71EETOnzrjkL5/wX3D2mYHtKM+qvqB1DvR4D0Setb/gDBsHzRICifwEWMO8CnTF6g==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/helper-annotate-as-pure@8.0.0': + resolution: {integrity: sha512-NSpMkMsvvZqzThJ0p1B02cbtA2ObEyfBvq950bmNkyxsxvcxwhvvCB036rKhlEnuBBo30bOrk13u3FzlKSoRrw==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/helper-compilation-targets@8.0.0': + resolution: {integrity: sha512-JwculLABZvyPvyLBpwU/E/IbH2uM3mnxNtIJpxnIfb24y1PrdVxK5Dqjle4DpgqpGRnwgC7G8IkzPdSXZrO1Ew==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/helper-globals@8.0.0': + resolution: {integrity: sha512-lLozHOM6sWWlxNo8CYqHy4MBZeTvHXNgVPBfPOGsjPKUzHC2Az9QwB6gxdQmpwHl6GlQtbGgS+lj5887guDiLw==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/helper-split-export-declaration@7.24.7': + resolution: {integrity: sha512-oy5V7pD+UvfkEATUKvIjvIAH/xCzfsFVw7ygW2SI6NClZzquT+mwdTfgfdbUiceh6iQO0CHtCPsyze/MZ2YbAA==} + engines: {node: '>=6.9.0'} + + '@babel/helper-string-parser@7.29.7': + resolution: {integrity: sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==} + engines: {node: '>=6.9.0'} + + '@babel/helper-string-parser@8.0.0': + resolution: {integrity: sha512-6mJgmFFFIIO82vvoLt9XtRC7/TkzXfts1t/SpRX4IHSzMgqoPYCWesVu1udUPUWioAE/2fcG6WuI8zrkE1gwrg==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/helper-validator-identifier@7.29.7': + resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==} + engines: {node: '>=6.9.0'} + + '@babel/helper-validator-identifier@8.0.4': + resolution: {integrity: sha512-4wFaiLd0bVo4cIoTXI3zKI038NIWE/cr3jvBjejOVYVxV/m8Ltav1USiGzG1fmS5J2RhgEOgXNNK46cRPnRsrg==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/helper-validator-option@8.0.0': + resolution: {integrity: sha512-U4Dybxh4WESWHt5XhBeExi4DrY0/DNK1aHpQbsrQXCUbFHuMweT0TpLEWKvaraV2Y6fS+ZXunsZ8zIuZIgvF2Q==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/helpers@8.0.0': + resolution: {integrity: sha512-wfbi91pM3py96oIiJEz7qIpyXDytgr9zQC1HEWwlGNVRAEmItuU/0a41ZUKu1sJGyhhOIpc4t5vk4PYzt8wpsg==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/parser@8.0.4': + resolution: {integrity: sha512-srpptsAkEbbNIC/q8nT7o+m6CQe8CJUTV/t7MYc9NnWlgYVtHOb7JH6SorxMhN0kuRJjVqXbKClG6xSbPtzz+g==} + engines: {node: ^22.18.0 || >=24.11.0} + hasBin: true + + '@babel/template@8.0.0': + resolution: {integrity: sha512-eAD0QW/AlbamBbw0FeGiwasbCVPq5ncW0HNVyLP3B9czqLyh4gvw+5JTSNt6le9+ziAU7mqDZsKTHf3jTb4chQ==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/traverse@8.0.4': + resolution: {integrity: sha512-bZnmqzGG8UZneG1lLxBoWIH0G6Gr1D846Yu4/3XnY6FhCndMR49u26nTY08u/dAxWmLWF9vGQOuC+84FfIUoeg==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@babel/types@7.29.8': + resolution: {integrity: sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==} + engines: {node: '>=6.9.0'} + + '@babel/types@8.0.4': + resolution: {integrity: sha512-eY+Yn3dCqTGmyiq2QRU66lA5FL8lqqqvecHt0fF3uHONIa7ToYsaCiWV8lOKqAs0Rb2SjixiKFROngnulPtt2g==} + engines: {node: ^22.18.0 || >=24.11.0} + + '@bramus/specificity@2.4.2': + resolution: {integrity: sha512-ctxtJ/eA+t+6q2++vj5j7FYX3nRu311q1wfYH3xjlLOsczhlhxAg2FWNUXhpGvAw3BWo1xBcvOV6/YLc2r5FJw==} + hasBin: true + + '@csstools/color-helpers@6.1.0': + resolution: {integrity: sha512-064IFJdjTfUqnjpCVpMOdbr8FLQBhinbZj6yRv2An2E41O/pLEXqfFRWqGq/SxlE5PEUYTlvWsG2r8MswAVvkg==} + engines: {node: '>=20.19.0'} + + '@csstools/css-calc@3.3.0': + resolution: {integrity: sha512-c5ihYsPkdG6JCkU2zTMm4+k6r7RXuGxtWYhu5DHMIiF1FHzrfmHL5so11AoFpUv/tu61xfcmT4AmKoFfMPoqdQ==} + engines: {node: '>=20.19.0'} + peerDependencies: + '@csstools/css-parser-algorithms': ^4.0.0 + '@csstools/css-tokenizer': ^4.0.0 + + '@csstools/css-color-parser@4.1.10': + resolution: {integrity: sha512-UZhQLIUyJaaMepqehrCODwCg2KW25vFvLWBmqYFaPclYvvxzj/sG8LBOhBFCp11i9uE7t1EyS+RAoV9tztPFyw==} + engines: {node: '>=20.19.0'} + peerDependencies: + '@csstools/css-parser-algorithms': ^4.0.0 + '@csstools/css-tokenizer': ^4.0.0 + + '@csstools/css-parser-algorithms@4.0.0': + resolution: {integrity: sha512-+B87qS7fIG3L5h3qwJ/IFbjoVoOe/bpOdh9hAjXbvx0o8ImEmUsGXN0inFOnk2ChCFgqkkGFQ+TpM5rbhkKe4w==} + engines: {node: '>=20.19.0'} + peerDependencies: + '@csstools/css-tokenizer': ^4.0.0 + + '@csstools/css-syntax-patches-for-csstree@1.1.7': + resolution: {integrity: sha512-fQ+05118eQS1cofO3aJpB5efgpBZMvIzwr/sbC8kDLVA5XLG8q1kJV5yzrUAI1f7lvhPnm8fgIjzFB8/O/5Dig==} + peerDependencies: + css-tree: ^3.2.1 + peerDependenciesMeta: + css-tree: + optional: true + + '@csstools/css-tokenizer@4.0.0': + resolution: {integrity: sha512-QxULHAm7cNu72w97JUNCBFODFaXpbDg+dP8b/oWFAZ2MTRppA3U00Y2L1HqaS4J6yBqxwa/Y3nMBaxVKbB/NsA==} + engines: {node: '>=20.19.0'} + + '@emnapi/core@1.11.1': + resolution: {integrity: sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==} + + '@emnapi/core@1.11.2': + resolution: {integrity: sha512-TC8MkTuZUtcTSiFeuC0ksCh9QIJ5+F21MvZ4Wn4ORfYaFJ/0dsiudv5tVkejgwZlwQ39jL9WWDe2lz8x0WglOA==} + + '@emnapi/runtime@1.11.1': + resolution: {integrity: sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==} + + '@emnapi/runtime@1.11.2': + resolution: {integrity: sha512-kyOl3X0DuTiT1h2ft8r2fYO8JYtU9a9Xis/zBSiGArNaagCOWx90N1k2wxp18czFDH+OgcWGb5ZP/XMt3dcyPA==} + + '@emnapi/wasi-threads@1.2.2': + resolution: {integrity: sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==} + + '@esbuild/aix-ppc64@0.28.2': + resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [aix] + + '@esbuild/android-arm64@0.28.2': + resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==} + engines: {node: '>=18'} + cpu: [arm64] + os: [android] + + '@esbuild/android-arm@0.28.2': + resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==} + engines: {node: '>=18'} + cpu: [arm] + os: [android] + + '@esbuild/android-x64@0.28.2': + resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==} + engines: {node: '>=18'} + cpu: [x64] + os: [android] + + '@esbuild/darwin-arm64@0.28.2': + resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [darwin] + + '@esbuild/darwin-x64@0.28.2': + resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==} + engines: {node: '>=18'} + cpu: [x64] + os: [darwin] + + '@esbuild/freebsd-arm64@0.28.2': + resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [freebsd] + + '@esbuild/freebsd-x64@0.28.2': + resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==} + engines: {node: '>=18'} + cpu: [x64] + os: [freebsd] + + '@esbuild/linux-arm64@0.28.2': + resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==} + engines: {node: '>=18'} + cpu: [arm64] + os: [linux] + + '@esbuild/linux-arm@0.28.2': + resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==} + engines: {node: '>=18'} + cpu: [arm] + os: [linux] + + '@esbuild/linux-ia32@0.28.2': + resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==} + engines: {node: '>=18'} + cpu: [ia32] + os: [linux] + + '@esbuild/linux-loong64@0.28.2': + resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==} + engines: {node: '>=18'} + cpu: [loong64] + os: [linux] + + '@esbuild/linux-mips64el@0.28.2': + resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==} + engines: {node: '>=18'} + cpu: [mips64el] + os: [linux] + + '@esbuild/linux-ppc64@0.28.2': + resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [linux] + + '@esbuild/linux-riscv64@0.28.2': + resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==} + engines: {node: '>=18'} + cpu: [riscv64] + os: [linux] + + '@esbuild/linux-s390x@0.28.2': + resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==} + engines: {node: '>=18'} + cpu: [s390x] + os: [linux] + + '@esbuild/linux-x64@0.28.2': + resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [linux] + + '@esbuild/netbsd-arm64@0.28.2': + resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [netbsd] + + '@esbuild/netbsd-x64@0.28.2': + resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==} + engines: {node: '>=18'} + cpu: [x64] + os: [netbsd] + + '@esbuild/openbsd-arm64@0.28.2': + resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openbsd] + + '@esbuild/openbsd-x64@0.28.2': + resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==} + engines: {node: '>=18'} + cpu: [x64] + os: [openbsd] + + '@esbuild/openharmony-arm64@0.28.2': + resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openharmony] + + '@esbuild/sunos-x64@0.28.2': + resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==} + engines: {node: '>=18'} + cpu: [x64] + os: [sunos] + + '@esbuild/win32-arm64@0.28.2': + resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [win32] + + '@esbuild/win32-ia32@0.28.2': + resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==} + engines: {node: '>=18'} + cpu: [ia32] + os: [win32] + + '@esbuild/win32-x64@0.28.2': + resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==} + engines: {node: '>=18'} + cpu: [x64] + os: [win32] + + '@exodus/bytes@1.15.1': + resolution: {integrity: sha512-S6mL0yNB/Abt9Ei4tq8gDhcczc4S3+vQ4ra7vxnAf+YHC02srtqxKKZghx2Dq6p0e66THKwR6r8N6P95wEty7Q==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + peerDependencies: + '@noble/hashes': ^1.8.0 || ^2.0.0 + peerDependenciesMeta: + '@noble/hashes': + optional: true + + '@harperfast/extended-iterable@1.0.3': + resolution: {integrity: sha512-sSAYhQca3rDWtQUHSAPeO7axFIUJOI6hn1gjRC5APVE1a90tuyT8f5WIgRsFhhWA7htNkju2veB9eWL6YHi/Lw==} + + '@hono/node-server@2.1.1': + resolution: {integrity: sha512-ELuehkj5VCBdgEw9zs+ivkKwyzzUCSQuE96YmiPvn1ECBoZCczbFXJLeEGMTYjphP6gydh4pHMqEYPVMYUVgQg==} + engines: {node: '>=20'} + peerDependencies: + hono: ^4 + + '@inquirer/ansi@2.0.7': + resolution: {integrity: sha512-3eTuUO1vH2cZm2ZKHeQxnOqlTi9EfZDGgIe3BL3I4u+rJHocr9Fz86M4fjYABPvFnQG/gGK551HqDiIcETwU6Q==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + + '@inquirer/checkbox@5.2.1': + resolution: {integrity: sha512-b6xmA/VlTe0ZgDQHDui+Nav470u7u49nRd8/iuhOcQPO9Ch7lGuogydhi2VOmNlZ+zXcM8IcPuNSwQcdJaF/kw==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/confirm@6.1.1': + resolution: {integrity: sha512-eb8DBZcz/2qHWQda4rk2JiQk5h9QV/cVHi1yjt0f69WFZMRFn0sJTye3EAP8icut8UDMjQPsaH5KbcOogefrFQ==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/core@11.2.1': + resolution: {integrity: sha512-Qd6GJT1yVyrZZCfN8W2qKF5ApmqryXRhRKCuip8h01x2w/esJQ2XIYc6f9abMIHgKQdBfFTSOdbHRLAhuM09UA==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/editor@5.2.2': + resolution: {integrity: sha512-ZRVd/oD+sYsUd5zVm0NflqEzlqfYCyHNsqkHl2oWXEUHs12tCbcSFi+wVFEvD8+LGRaMUsVrE7qeo6lSG/S1Vg==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/expand@5.1.1': + resolution: {integrity: sha512-YmQpenjbFSHAK3sOd44puHh3V1KXXr+JiNpUztoSQ4drLh2rTVzTap/YtlAVu/5xavifIlBfNEzJ/neZJ1a/1g==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/external-editor@3.0.3': + resolution: {integrity: sha512-6thf5I8q7lZwzGLAxPaaGEREEkZ3nyePPDQ1oyobblxmEE8mqTLguScP7pDjUTAibiyb4hfXl+qjUEJ+di/aNA==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/figures@2.0.7': + resolution: {integrity: sha512-aJ8TBPOGB6f/2qziPfElISTCEd5XOYTFckA2SGjhNmiKzfK/u4ot3v0DUzGVdUnKjN10EqnnEPck36BkyfLnJw==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + + '@inquirer/input@5.1.2': + resolution: {integrity: sha512-9K/DDBSQpOyZSkt6sOVP9Vo0TR7atX2kuILsUu0x3wVcVbe97lJwIJKMLdMw25tDYuXl/qp6erT0Xs1rfmcfZg==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/number@4.1.1': + resolution: {integrity: sha512-XF4IXAbPnGPgw0wsbC/i2tPcyfdZgDpUlhsqU0SfT4IRIGWha6Xm9VRgN5yYxJq+jnyXlfXI/nQ3ulfk0iEICA==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/password@5.1.1': + resolution: {integrity: sha512-3XBfF7DAsp5qeDsvN5Rd1HmbNokVvEQoUM0QLrRcybC9nX96w3Pbmu7qUsb3IT3J3jBvs2+mTXaKHOUsgHMLzg==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/prompts@8.5.2': + resolution: {integrity: sha512-IYR/3C/paEVVQYQvdDlFZVjRCJVYHHON0XXMH91KO9GSxs0TdKYWlUdvfQl2EfAHDxUaN3IBffkE/BDTh5nJ6g==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/rawlist@5.3.1': + resolution: {integrity: sha512-QqdTqQddL3qPX/PPrjobpsO25NZ4dWXgTLenrR445L2ptLEYE6Z+PD5c5CNDJNx4ugRgELAIpSIJxZaO2jJ2Og==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/search@4.2.1': + resolution: {integrity: sha512-xJj8QWKRSrfKoBIITLZK61dD3zwo0Rz11fgDImku30/Oe81zMdIdGgrLY2h6RkJ+KZ/GhNYIRMKnH/62qBTA5g==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/select@5.2.1': + resolution: {integrity: sha512-FlDndEUww8m7BfukO2nJa25vhD+H5jxxCv4oGioKqzyWz3nPHhhw4LKdYRSlXuAx7DsdWia7iyaBPKKS95Evfw==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@inquirer/type@4.0.7': + resolution: {integrity: sha512-t28inv14nMQ1PhKpsJPY+kEs/c00qzeCOS2gTNRyTjG5d6qsVA2fItxW4hkvGZ5lvanGLdtCzVIx5dwdRpN1+g==} + engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'} + peerDependencies: + '@types/node': '>=18' + peerDependenciesMeta: + '@types/node': + optional: true + + '@jridgewell/gen-mapping@0.3.13': + resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==} + + '@jridgewell/remapping@2.3.5': + resolution: {integrity: sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==} + + '@jridgewell/resolve-uri@3.1.2': + resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==} + engines: {node: '>=6.0.0'} + + '@jridgewell/sourcemap-codec@1.5.5': + resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==} + + '@jridgewell/trace-mapping@0.3.31': + resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==} + + '@listr2/prompt-adapter-inquirer@4.2.4': + resolution: {integrity: sha512-/KRI2DMD7JGSYaREF0Ygl7AefJ/2ase4Gc5cBiKqT5l4tFjsSJfhFGcc5nSkgl0Sp9LkCQNzl/cqbVJYP2L3dw==} + engines: {node: '>=22.13.0'} + peerDependencies: + '@inquirer/prompts': '>= 3 < 9' + listr2: 10.2.1 + + '@lmdb/lmdb-darwin-arm64@3.5.6': + resolution: {integrity: sha512-mY5FG4TjPAkY4P0w+OhHaUka5mDh2TX2WKYIwuKzJ1zeW3VvRgxdam/lGJTquI+bthTx5CSHDW+BAQCnNAzkEA==} + cpu: [arm64] + os: [darwin] + + '@lmdb/lmdb-darwin-x64@3.5.6': + resolution: {integrity: sha512-foa+pwitysO8k+xhs7psBFfTKnVgR69NlZRRTHaFVDqphh7AdGpLeyRzKw/ofatr/sN6TiHRRW6mmop0ZrrppQ==} + cpu: [x64] + os: [darwin] + + '@lmdb/lmdb-linux-arm64@3.5.6': + resolution: {integrity: sha512-HmiyFFdJa38s1heCMSooSPaBSFTHJ3C+ERPp28xAPlDX1YiALJVOgbry065nXd8Y7KISWjnw05zpG1RX8IfftA==} + cpu: [arm64] + os: [linux] + + '@lmdb/lmdb-linux-arm@3.5.6': + resolution: {integrity: sha512-QR4YRyR5h5Z8eGXrNQjiyo2NNDfqi3tCc9dQG5Is1blCt+qWw1ZoBWhlWAr5d+jshkifMIJjVHzHGKbkKzF8Tw==} + cpu: [arm] + os: [linux] + + '@lmdb/lmdb-linux-x64@3.5.6': + resolution: {integrity: sha512-ADzCuCF2cTNiX9kDScqcz1fjnAkxPpQNneV3KFTdV3wWtVlI2sTGzySoMTgDpinkMMFj1NTJlxA6XR8fwc4hlA==} + cpu: [x64] + os: [linux] + + '@lmdb/lmdb-win32-arm64@3.5.6': + resolution: {integrity: sha512-J7A9aEQsQiv0TYtBGL7NDIPp2lOS8nnl+zm4sWZm1xlsTTaQ4PgD096Adzdrk27rw3UxCkDXdCUa4ax41oztBQ==} + cpu: [arm64] + os: [win32] + + '@lmdb/lmdb-win32-x64@3.5.6': + resolution: {integrity: sha512-1g7G0knRX2iV/voDu54yxrGqw5Dk0w2oIYb7dgJq8IkOi+m7wbD8Q3QpPFjh0C01G58S88dqGn03len6UPCXsg==} + cpu: [x64] + os: [win32] + + '@modelcontextprotocol/sdk@1.30.0': + resolution: {integrity: sha512-xKd8OIzlqNzcqcNumGAa6g+PW2kjD5vrpcKOnfldAUPP3j7lnqMPwlTXQm8gF+UwH72z0lqaRbjr9hqGz0eITA==} + engines: {node: '>=18'} + peerDependencies: + '@cfworker/json-schema': ^4.1.1 + zod: ^3.25 || ^4.0 + peerDependenciesMeta: + '@cfworker/json-schema': + optional: true + + '@msgpackr-extract/msgpackr-extract-darwin-arm64@3.0.4': + resolution: {integrity: sha512-LCkGo6JDfaBhgST7UpPWgNgLINpcpabaHfyz5OBx75nUYxBsaEPxjnyNjWpeb/xBup/682QnBfRBy2/LvPutZQ==} + cpu: [arm64] + os: [darwin] + + '@msgpackr-extract/msgpackr-extract-darwin-x64@3.0.4': + resolution: {integrity: sha512-zExlW9zUJKZH/tOtVMttwjKa4Xm/3KcNjnE3dPN92uCktwavMxpgCA3MoJK/DOnTWsQgo224OaST27/mPNAf+w==} + cpu: [x64] + os: [darwin] + + '@msgpackr-extract/msgpackr-extract-linux-arm64@3.0.4': + resolution: {integrity: sha512-dgX0P/9wGPJeHFBG+ZmhgE6bmtMt7NP5CRBGyyktpopdk/mW4POnrpQsSLtKI1dwpc+pPLuXHDh6vvskyQE/sw==} + cpu: [arm64] + os: [linux] + + '@msgpackr-extract/msgpackr-extract-linux-arm@3.0.4': + resolution: {integrity: sha512-Tg3yX65f5GbtXLkrYEHE5oibZG9epyYWas7FogTTEJeDEF9JlXJzKgXaNhT3UXlTOeA+AfZpYZYZ0uPj7Cfquw==} + cpu: [arm] + os: [linux] + + '@msgpackr-extract/msgpackr-extract-linux-x64@3.0.4': + resolution: {integrity: sha512-8TNXMEjJc3QEy7R/x1INhgiU+XakDAFUzBhaz7+Rbrs8NH5UQeHQxxmzsSBJGyV6I1jW79undiQm8tOI+D+8FQ==} + cpu: [x64] + os: [linux] + + '@msgpackr-extract/msgpackr-extract-win32-x64@3.0.4': + resolution: {integrity: sha512-CmCXPQrkbwExx3j946/PtHWHbYJiCRBRDl4BlkRQcJB/YOwQxJRTpoo7aTsortjgoJ1x7opzTSxn7C+ASSLVjQ==} + cpu: [x64] + os: [win32] + + '@napi-rs/nice-android-arm-eabi@1.1.1': + resolution: {integrity: sha512-kjirL3N6TnRPv5iuHw36wnucNqXAO46dzK9oPb0wj076R5Xm8PfUVA9nAFB5ZNMmfJQJVKACAPd/Z2KYMppthw==} + engines: {node: '>= 10'} + cpu: [arm] + os: [android] + + '@napi-rs/nice-android-arm64@1.1.1': + resolution: {integrity: sha512-blG0i7dXgbInN5urONoUCNf+DUEAavRffrO7fZSeoRMJc5qD+BJeNcpr54msPF6qfDD6kzs9AQJogZvT2KD5nw==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [android] + + '@napi-rs/nice-darwin-arm64@1.1.1': + resolution: {integrity: sha512-s/E7w45NaLqTGuOjC2p96pct4jRfo61xb9bU1unM/MJ/RFkKlJyJDx7OJI/O0ll/hrfpqKopuAFDV8yo0hfT7A==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [darwin] + + '@napi-rs/nice-darwin-x64@1.1.1': + resolution: {integrity: sha512-dGoEBnVpsdcC+oHHmW1LRK5eiyzLwdgNQq3BmZIav+9/5WTZwBYX7r5ZkQC07Nxd3KHOCkgbHSh4wPkH1N1LiQ==} + engines: {node: '>= 10'} + cpu: [x64] + os: [darwin] + + '@napi-rs/nice-freebsd-x64@1.1.1': + resolution: {integrity: sha512-kHv4kEHAylMYmlNwcQcDtXjklYp4FCf0b05E+0h6nDHsZ+F0bDe04U/tXNOqrx5CmIAth4vwfkjjUmp4c4JktQ==} + engines: {node: '>= 10'} + cpu: [x64] + os: [freebsd] + + '@napi-rs/nice-linux-arm-gnueabihf@1.1.1': + resolution: {integrity: sha512-E1t7K0efyKXZDoZg1LzCOLxgolxV58HCkaEkEvIYQx12ht2pa8hoBo+4OB3qh7e+QiBlp1SRf+voWUZFxyhyqg==} + engines: {node: '>= 10'} + cpu: [arm] + os: [linux] + + '@napi-rs/nice-linux-arm64-gnu@1.1.1': + resolution: {integrity: sha512-CIKLA12DTIZlmTaaKhQP88R3Xao+gyJxNWEn04wZwC2wmRapNnxCUZkVwggInMJvtVElA+D4ZzOU5sX4jV+SmQ==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [linux] + + '@napi-rs/nice-linux-arm64-musl@1.1.1': + resolution: {integrity: sha512-+2Rzdb3nTIYZ0YJF43qf2twhqOCkiSrHx2Pg6DJaCPYhhaxbLcdlV8hCRMHghQ+EtZQWGNcS2xF4KxBhSGeutg==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [linux] + + '@napi-rs/nice-linux-ppc64-gnu@1.1.1': + resolution: {integrity: sha512-4FS8oc0GeHpwvv4tKciKkw3Y4jKsL7FRhaOeiPei0X9T4Jd619wHNe4xCLmN2EMgZoeGg+Q7GY7BsvwKpL22Tg==} + engines: {node: '>= 10'} + cpu: [ppc64] + os: [linux] + + '@napi-rs/nice-linux-riscv64-gnu@1.1.1': + resolution: {integrity: sha512-HU0nw9uD4FO/oGCCk409tCi5IzIZpH2agE6nN4fqpwVlCn5BOq0MS1dXGjXaG17JaAvrlpV5ZeyZwSon10XOXw==} + engines: {node: '>= 10'} + cpu: [riscv64] + os: [linux] + + '@napi-rs/nice-linux-s390x-gnu@1.1.1': + resolution: {integrity: sha512-2YqKJWWl24EwrX0DzCQgPLKQBxYDdBxOHot1KWEq7aY2uYeX+Uvtv4I8xFVVygJDgf6/92h9N3Y43WPx8+PAgQ==} + engines: {node: '>= 10'} + cpu: [s390x] + os: [linux] + + '@napi-rs/nice-linux-x64-gnu@1.1.1': + resolution: {integrity: sha512-/gaNz3R92t+dcrfCw/96pDopcmec7oCcAQ3l/M+Zxr82KT4DljD37CpgrnXV+pJC263JkW572pdbP3hP+KjcIg==} + engines: {node: '>= 10'} + cpu: [x64] + os: [linux] + + '@napi-rs/nice-linux-x64-musl@1.1.1': + resolution: {integrity: sha512-xScCGnyj/oppsNPMnevsBe3pvNaoK7FGvMjT35riz9YdhB2WtTG47ZlbxtOLpjeO9SqqQ2J2igCmz6IJOD5JYw==} + engines: {node: '>= 10'} + cpu: [x64] + os: [linux] + + '@napi-rs/nice-openharmony-arm64@1.1.1': + resolution: {integrity: sha512-6uJPRVwVCLDeoOaNyeiW0gp2kFIM4r7PL2MczdZQHkFi9gVlgm+Vn+V6nTWRcu856mJ2WjYJiumEajfSm7arPQ==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [openharmony] + + '@napi-rs/nice-win32-arm64-msvc@1.1.1': + resolution: {integrity: sha512-uoTb4eAvM5B2aj/z8j+Nv8OttPf2m+HVx3UjA5jcFxASvNhQriyCQF1OB1lHL43ZhW+VwZlgvjmP5qF3+59atA==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [win32] + + '@napi-rs/nice-win32-ia32-msvc@1.1.1': + resolution: {integrity: sha512-CNQqlQT9MwuCsg1Vd/oKXiuH+TcsSPJmlAFc5frFyX/KkOh0UpBLEj7aoY656d5UKZQMQFP7vJNa1DNUNORvug==} + engines: {node: '>= 10'} + cpu: [ia32] + os: [win32] + + '@napi-rs/nice-win32-x64-msvc@1.1.1': + resolution: {integrity: sha512-vB+4G/jBQCAh0jelMTY3+kgFy00Hlx2f2/1zjMoH821IbplbWZOkLiTYXQkygNTzQJTq5cvwBDgn2ppHD+bglQ==} + engines: {node: '>= 10'} + cpu: [x64] + os: [win32] + + '@napi-rs/nice@1.1.1': + resolution: {integrity: sha512-xJIPs+bYuc9ASBl+cvGsKbGrJmS6fAKaSZCnT0lhahT5rhA2VVy9/EcIgd2JhtEuFOJNx7UHNn/qiTPTY4nrQw==} + engines: {node: '>= 10'} + + '@napi-rs/wasm-runtime@1.2.3': + resolution: {integrity: sha512-UMduMbqO5s5zF2NkNacMT/yK5Y5QiKvWr2+50bzIIxFDwVJ2h49b+oyjaCGPhJxd2/gC2x39EHv/gHVuu36x2Q==} + engines: {node: ^20.19.0 || ^22.13.0 || >=23.5.0} + peerDependencies: + '@emnapi/core': ^1.7.1 || ^2.0.0-alpha.4 + '@emnapi/runtime': ^1.7.1 || ^2.0.0-alpha.4 + + '@oxc-parser/binding-android-arm-eabi@0.142.0': + resolution: {integrity: sha512-ZiRGDutGsv1G6bL/ozy/koC0Sv39T1DqyoC4KD1DOy9ZoACm1O5UWhEK2c02Qdk+4lfLVkvFa/mQ0fm/4h1BtQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [android] + + '@oxc-parser/binding-android-arm64@0.142.0': + resolution: {integrity: sha512-WZkvGRLNQTz8lR9zP5nLjUdlroRCopBu3g9zF1p/laE6DzT1UbQo8Rdz5MWhaJUPYg/6gp+jo7HUgsyKaN1FtQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@oxc-parser/binding-darwin-arm64@0.142.0': + resolution: {integrity: sha512-l4khS8LQOOVYsGRVARo1gSaCT/aBSceUVXgtovWc2+drnxVuDr082WA3OCHVdVzIz5JIrP/y9CWsSKxBDNmYGg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@oxc-parser/binding-darwin-x64@0.142.0': + resolution: {integrity: sha512-QBsNF3nqlXmcH2B1YOPqQYmCJoy4HuIjUxGbBO/k5JAJUl68ghU2psRY2zPk+RyBaWqKP/qfL4oaFgEMCdwskA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@oxc-parser/binding-freebsd-x64@0.142.0': + resolution: {integrity: sha512-b7Q7m4Cqc6XqNhri3R+QhU+GVy646Pn+bkdhrDdWym/Fdi0ZUa+d73H9dm5H91JtbtAQ/z1d8XKMW3oOV8a4tQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@oxc-parser/binding-linux-arm-gnueabihf@0.142.0': + resolution: {integrity: sha512-3riVS5IhdH3uCZj1Y9ftDQlR0dvLsIlw/edrRqk8JhgNd5K0XSs+UBtgh50N13CAlW9/TXj6sVGXaKNBocd0Yg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@oxc-parser/binding-linux-arm-musleabihf@0.142.0': + resolution: {integrity: sha512-NmXUOpgpTSkhl795TiXmWppTwmSJ92RC1qvD6e4XOF+slgmo3e6Ah+kEu+6AN8s7NAOEwqGmir58MgSQSWmBSA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@oxc-parser/binding-linux-arm64-gnu@0.142.0': + resolution: {integrity: sha512-gc0EXsKtXgerujmU2Bql3u1L1HsSQ2774R83idq/FoNMPVV/RY/1ErFsvnit7KoiP/sLvzQixeUo4Ut0ic0wmw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + + '@oxc-parser/binding-linux-arm64-musl@0.142.0': + resolution: {integrity: sha512-F2XvmWSE0uWpie+jHKKIFgdVOe9ypGhkEZxKx5DuW215K6cbAC274yYaPkcM7EqY4Df3Weyhpcz3lsURyH2LVg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + + '@oxc-parser/binding-linux-ppc64-gnu@0.142.0': + resolution: {integrity: sha512-wLMbT21U/QxknQsk+VvNF0b9D2/aGWhcaQQQ+VYlE8FwD5+GoWZIPPXNzyHmkYyhm0KB3itL+TBavjMatqNnYA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + + '@oxc-parser/binding-linux-riscv64-gnu@0.142.0': + resolution: {integrity: sha512-+G8F/4ckwT7FCJV4H2bt09xEzJbjNCfuL4Sp1AYNaFtFMVtgIGMuJlteT82U+K0UIZ/DzAR/LDlMFnEuajG7Kw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [riscv64] + os: [linux] + + '@oxc-parser/binding-linux-riscv64-musl@0.142.0': + resolution: {integrity: sha512-hTsHtTLxMAfCo+rpF5K3qZJKW2NpPN/CHd4mYB3y7XlSdspHkd2gehDIofP64AacA9nWQw2tY3O7wR6UY8IVOA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [riscv64] + os: [linux] + + '@oxc-parser/binding-linux-s390x-gnu@0.142.0': + resolution: {integrity: sha512-6y7qYY3TCUDYjqswImdTGl92y+KA/80twALegQPN27kfY+bG7Ib1+L3jbmrCZQx6wrVnai9IPsEZp07I0hx7JQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + + '@oxc-parser/binding-linux-x64-gnu@0.142.0': + resolution: {integrity: sha512-i69kAWU+2LgoH5bR+zWiiu+UzAw7Oxkwv7COeJTeY19pn4e70nKQcr9Pm6cL2Z0Z54d+gl9qADlK/0yyuCPiBA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + + '@oxc-parser/binding-linux-x64-musl@0.142.0': + resolution: {integrity: sha512-4SQs678MmjYVrmhAgCWD4o0vpaFszXw9xLX5p2Z9MMFcltxiLkA88wQjh80YHjPrXtpyZ2CWI5m+1yNKM0m2Pw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + + '@oxc-parser/binding-openharmony-arm64@0.142.0': + resolution: {integrity: sha512-YHpx9N7Ln3a++Tc8rv+H7mrK1zyJQOAwCFg8LZ3lTs1T5afGWeZrLPhPT9HLnIwSjCyJqPWVMIrMxbjcmBr2oQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@oxc-parser/binding-wasm32-wasi@0.142.0': + resolution: {integrity: sha512-3pLDyY3+oogW73RM5uehNgAiR/Xfb7fvO2Q1Z1gIqZ2+50XDVQmBVlRkHXZTU4gKnQHpwETNsYQVsJ3joVB2iA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [wasm32] + + '@oxc-parser/binding-win32-arm64-msvc@0.142.0': + resolution: {integrity: sha512-Had/VeVY28Oyb0K+Q4FV8KCzoBycIh93oDK6pCbya9lkzdq+ikMHMgBubsdqqlybjJmQRawCQRrnBRHyQwYvcQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@oxc-parser/binding-win32-ia32-msvc@0.142.0': + resolution: {integrity: sha512-GGi3+YphVHavvgs6gum2UXoNCqzHAmPt/nXkn8ZQZstV2Q1qZD1Mn8fz/nWrDkefHQtrG/+1/XrbMxsBTo6Svw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ia32] + os: [win32] + + '@oxc-parser/binding-win32-x64-msvc@0.142.0': + resolution: {integrity: sha512-Ny/Wv4Us1LGC/ljwNTp+Hx3r/pH15EFfeDF0p+n898gt+TtRd6C9SccHcuUhDiNTb8s5tt7jdeAMDRQZ4Vq6hg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@oxc-project/types@0.139.0': + resolution: {integrity: sha512-r9gHphtCs+1M7J0pw6Sn/hh/Wpa/iQrOOkrNAlVLF/gHq+/CJmHIWKKUUhdWjcD6CIa8idarspCsASiXCXvFUw==} + + '@oxc-project/types@0.140.0': + resolution: {integrity: sha512-h5LUOzGArYemnW1NMz/DuuQhBi96J6JL2Bk8zE4kvqxB5Sg3jxmCiH4uyOWHDkiKSt5vWlG4FIwCR/DbstcNRQ==} + + '@oxc-project/types@0.142.0': + resolution: {integrity: sha512-7W+2q5AKQVU36fkaryontrHn3YDt1RyUYXatw9i5H8ocYe2sPKSFB6eS8WNPeRKiN1qAWWZUPm7gwFzJGrccqQ==} + + '@parcel/watcher-android-arm64@2.6.0': + resolution: {integrity: sha512-trgpLSCKRC/huFjXX/Smh+0sWe4+YtKfktIToiMl59ghz7z+qkH6kMvNnUbLyRs9N11t8l4svSCs1+5B3rOAhA==} + engines: {node: '>= 10.0.0'} + cpu: [arm64] + os: [android] + + '@parcel/watcher-darwin-arm64@2.6.0': + resolution: {integrity: sha512-Y3QV0gl7Q1zbfueunkWIERICbEojQFCgpyG7YqOGNFLsckXyI1xu9mAIUpKY9QBYzBtSkN8dBPwd3yiAO9ovMw==} + engines: {node: '>= 10.0.0'} + cpu: [arm64] + os: [darwin] + + '@parcel/watcher-darwin-x64@2.6.0': + resolution: {integrity: sha512-Ohv6OpzhUfKYD7Beb8kDvG0jbIxORCYY1JRdZnaBtnjjkJxgD7ZVL0nw2sCYd0yTMKTvz3nnTnOF3cDifK+kvw==} + engines: {node: '>= 10.0.0'} + cpu: [x64] + os: [darwin] + + '@parcel/watcher-freebsd-x64@2.6.0': + resolution: {integrity: sha512-5HmXvDgs8VK+74jF9y9/2FE3/OnlcKmc56tjmSrEuZjpSZOGL+fvAu+HKJBdPs9uwoP2hE6TlSUpXZ/C5jUFmQ==} + engines: {node: '>= 10.0.0'} + cpu: [x64] + os: [freebsd] + + '@parcel/watcher-linux-arm-glibc@2.6.0': + resolution: {integrity: sha512-Ps/hui3A+vMbjdqlqAowK2ZL8+BO8dBjxeWXj6npTBs3jx4wWmbPpaLuqwrQrSqIVMCnpWo238bJ1U37GhQOYg==} + engines: {node: '>= 10.0.0'} + cpu: [arm] + os: [linux] + + '@parcel/watcher-linux-arm-musl@2.6.0': + resolution: {integrity: sha512-9c6AUHgHoG+IY88MRIHupztQiQnrbqHYQjkM2btA+Bf/wQnQMuiD0Wfk1EVv3TlNT3x41uU71rn6E4xh/+zvkw==} + engines: {node: '>= 10.0.0'} + cpu: [arm] + os: [linux] + + '@parcel/watcher-linux-arm64-glibc@2.6.0': + resolution: {integrity: sha512-yHRqS2owEXe6Hic9z6Mh1ECsCd+ODVOGvZDyciqRd21+v+o+DnXMOrw50DSpIG2sb8GPEaPPmfeCAWKPJdq46g==} + engines: {node: '>= 10.0.0'} + cpu: [arm64] + os: [linux] + + '@parcel/watcher-linux-arm64-musl@2.6.0': + resolution: {integrity: sha512-WhB2e/V7rqdHHWZusBSPuy5Ei8S6lSz6FE5TKKQz5h3a0O+C+mhY7vxU9b/stqvMb8beLnPY82ZrFTLKs+SrKA==} + engines: {node: '>= 10.0.0'} + cpu: [arm64] + os: [linux] + + '@parcel/watcher-linux-x64-glibc@2.6.0': + resolution: {integrity: sha512-ulGE6x6Oz6iAwg75T8YQSoguBWasniIbX+QWpaYPcCnDOpdWX3k+4xbEYPZVLxOuoJI+svJJPD3sEj8G7lrQ3A==} + engines: {node: '>= 10.0.0'} + cpu: [x64] + os: [linux] + + '@parcel/watcher-linux-x64-musl@2.6.0': + resolution: {integrity: sha512-tkBYKt7YQrjIJWYDnto2YgO8MRkjlMTSNoRHzsXinBqbLdeOM3L32wPZJvIZxqaLMfSlS/4sUjH/6STVP/XDLw==} + engines: {node: '>= 10.0.0'} + cpu: [x64] + os: [linux] + + '@parcel/watcher-win32-arm64@2.6.0': + resolution: {integrity: sha512-gIZAP23jaHjGWasY/TY6yL7NHFClf0Ga7FN+iINvk+KN94rhm94lYZhFsbYFNcA04/onvGD9kKmiJLJB2HbNwQ==} + engines: {node: '>= 10.0.0'} + cpu: [arm64] + os: [win32] + + '@parcel/watcher-win32-x64@2.6.0': + resolution: {integrity: sha512-cA+/pXV2YkfxlIcXOQ5fSWqAzzPyD78/x5qbK/I0vUkrlYHA8TIz+MXjAbGouguKVSI4bOmkTSJ1/poVSsgt+A==} + engines: {node: '>= 10.0.0'} + cpu: [x64] + os: [win32] + + '@parcel/watcher@2.6.0': + resolution: {integrity: sha512-7FNeNl8NCE7aINx7WXiKQrPYZWC/hvrTsmk6zmxbI7LTXE7hVek/n8AfVgpe2y82zl3w0HvCHN0bVKMBoJcC0w==} + engines: {node: '>= 10.0.0'} + + '@rolldown/binding-android-arm64@1.1.5': + resolution: {integrity: sha512-lZg8fqIv2v7FF237bwMgzGZEJvGL79/s5knJ/i6FmsGF4XXlzccZ4jb+TrFIxtSSxFtIpdsgrPZeMk1I9AFcyQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@rolldown/binding-android-arm64@1.2.0': + resolution: {integrity: sha512-9yB1l95IrJuNGDFdOYe79vdApdz6WWBCObE+rQ2LUliYUlcyFwSYIb2xb5/Ifw7dAtMy2ZqNyd8QTSOc7duAKw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@rolldown/binding-darwin-arm64@1.1.5': + resolution: {integrity: sha512-51Bnx9pNiMRKSUNtBfySkNJ9vMU9Hh3I1ozDd6gyPPYzaXCfnptUcEZxXGYFn+ul2dtcMUiqGR1Yai2K10uoTw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@rolldown/binding-darwin-arm64@1.2.0': + resolution: {integrity: sha512-pexNaW9ACLUOaBITOpU6qVu4VrsOFIjTv6bzgu0YUATo4eUJx0V605PxwZfndpPOn0ilqGqvGQ0M8UW0IE24jg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@rolldown/binding-darwin-x64@1.1.5': + resolution: {integrity: sha512-Tm+gbfC0aHu1tBA/JvKQh32S0K6YgCHkiAF4/W6xX0K0RmNuc94VeK419dJoE65R5aRxmo+noZQSWrAMF6yb6g==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@rolldown/binding-darwin-x64@1.2.0': + resolution: {integrity: sha512-NqKYaq0355ZmNMG4QGpxtEDxsc7tGDhjhCm4PpE0cwnBW+5Il95LJyq414niEiaKLVjnVHBEjSo1wngKxJNiFw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@rolldown/binding-freebsd-x64@1.1.5': + resolution: {integrity: sha512-JMzDKCCXq93YccG5gz3hvOs1oXRKAf0XYpfOS88e+wZrC8Iugj6j68867vrYZkvpDDpKn/KoKORThmchMpF6TA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@rolldown/binding-freebsd-x64@1.2.0': + resolution: {integrity: sha512-3vPoHzh6eBTz9IbB0/qZdSr0Qeks2echn+I4cHu2joV74VriPDdldswksEDzrl1mBB+oPRi+67+3Ib59paxIPQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@rolldown/binding-linux-arm-gnueabihf@1.1.5': + resolution: {integrity: sha512-uML21j2K5TfPGutKxub+M+nLjZIrWjXQ5Grx4lCe/nimTj9B4L63zHpjXLl4y0L3mcm2htEQIb06oCG/szerNw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@rolldown/binding-linux-arm-gnueabihf@1.2.0': + resolution: {integrity: sha512-E6NNefZ1bUVmKJq2tJkf45J4Zyczj7qm9rUT7NY+Xo2474Y13qWAwc2tvBt0BAVbmtXR1llkxXg0Ou1jbDf2SQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@rolldown/binding-linux-arm64-gnu@1.1.5': + resolution: {integrity: sha512-navSiuTMogvnQoZoM/v+l3ZWo50/NTwSHSzheABx/RCnmUPaKwq9qSo4Br2OYRs21+Fz8uFqITZM3H4opOB0/Q==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + + '@rolldown/binding-linux-arm64-gnu@1.2.0': + resolution: {integrity: sha512-D+TgkdgM1vu+7/Fpf8+v0ARW+RXEP9Ccazgm8zQ4JFFd9Q7SrYQ2TakU5S5ihazQDgpKyAgZDOcIFsvoHmTZ8w==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + + '@rolldown/binding-linux-arm64-musl@1.1.5': + resolution: {integrity: sha512-lAryqH7IteztmCXQXk0etKj4wBQ7Gx5S6LjKhsgp9zb8I5bsuvU/2llH1hDQcjsFeqIsovMVN339/8pUDDBXxA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + + '@rolldown/binding-linux-arm64-musl@1.2.0': + resolution: {integrity: sha512-wUqdwJBbAv0APN87GecstdMUtLjjNTs0hBALpxETD73mccFxdmt/XeizXDtN5RAlBwNKmI+Tg+blect2G+8IeQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + + '@rolldown/binding-linux-ppc64-gnu@1.1.5': + resolution: {integrity: sha512-fsK/sNBnxzBlL4O1JNrZakVQxPspqpED5dLtNsZS9oOKmtSpdNIzxH2kkol5HYTWJN47sE20ztMJPxfZ89qGOg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + + '@rolldown/binding-linux-ppc64-gnu@1.2.0': + resolution: {integrity: sha512-9DtF35qR9/NrfhM4oxLplCzVVjE+KKm8Pjemi0i/sdhAWkUasjmSo8WTTubNJClhSHCfyk2yeyoXDQEDPtDAAw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + + '@rolldown/binding-linux-s390x-gnu@1.1.5': + resolution: {integrity: sha512-gLYb4BIadlfTOYT5gO503n8zQjXflgzpD0FcyKh0Mzx3rqCZKnHoJWV9xe1KXUJ5lx2JfcSHr/mhzS0PC/McAA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + + '@rolldown/binding-linux-s390x-gnu@1.2.0': + resolution: {integrity: sha512-RzuHrBh8X8Hntd2N4VR02QGEciq/9JhcZoTpR/Cee6otRrlILGCf3cg2ygHuih+ZebUnWmMrDX6ITI85btO6rQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + + '@rolldown/binding-linux-x64-gnu@1.1.5': + resolution: {integrity: sha512-FjcpEKUyJygHgs1o50VYNvkt5+7Le/VEdYt0AkRpkL33MnyQfwr8l5mXwMmfmTbyMPr5vJLC+8/Gd9gXnwU1QQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + + '@rolldown/binding-linux-x64-gnu@1.2.0': + resolution: {integrity: sha512-MK7L0018jjh1jR3mh21G2j1zAVcpscJBlPo2z19pRjv2XOYGRhaV4LyiD8HO6nCDdZln9IFgCMIV5yt4E3klGQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + + '@rolldown/binding-linux-x64-musl@1.1.5': + resolution: {integrity: sha512-Me+PfPI2TMeOQk0gYWfLQZtTktrmzbr8cDboqX83XKc7UrgAi55gF+2dUkWdxd19n55Essp2yeca+O9N5rBxHg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + + '@rolldown/binding-linux-x64-musl@1.2.0': + resolution: {integrity: sha512-gyrxLQ9NfGb/9LoVnC4kb9miUghw1mghnkfYvNHSnVIXriabnfgGPUP4RLcJm87q3KgYz4FYUG8IDiWUT+CpSw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + + '@rolldown/binding-openharmony-arm64@1.1.5': + resolution: {integrity: sha512-yc5WrLzXks6zCQfn9Oxr8pORKyl/pF+QjHmW/Qx3qu0oyrrNC+y2JLTU1E2rcWYAmzlnqngWXHQjy51VzW70Vw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@rolldown/binding-openharmony-arm64@1.2.0': + resolution: {integrity: sha512-/6VFMQGRmrhP77KXDC+StIxGzcNp5JOIyYtw0CQ8gPlzhpiIRucYfoM5FaFamHd5BJYIdH86yfP46l1p3WdrFA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@rolldown/binding-wasm32-wasi@1.1.5': + resolution: {integrity: sha512-VbQGPX2b4r48TAMIM2cjgluIM1HYutm4pcTEJsle7iEP7sB1dFqtPLBVbdLAZCxy1txCcPxf4QFf4v8uvltPqA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [wasm32] + + '@rolldown/binding-wasm32-wasi@1.2.0': + resolution: {integrity: sha512-rwdbUL465kisF24WEJLvP3JrEG6E5GRuIHt5wpMwHGERtHe4Wm2CIvtf5gTBgr2tGOHKh5NdKEAFS2VkOPE91g==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [wasm32] + + '@rolldown/binding-win32-arm64-msvc@1.1.5': + resolution: {integrity: sha512-gHv82k63z4qpV5+Q1y/12KrK0ltWBukVDI8nZcbT7Tt/ZlOIVwppazneq0F93oDxTo3IgAMEDIoQh3E2n6mVsw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@rolldown/binding-win32-arm64-msvc@1.2.0': + resolution: {integrity: sha512-+5suHwRiKGmhwyUaNT8a5QbrBvLFh2DbO910TEmGRH1aSxwrCezodvGQnulv4uiWEIv1Kq4ypRsJ5+O+ry1DiA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@rolldown/binding-win32-x64-msvc@1.1.5': + resolution: {integrity: sha512-tTZuDBPw85tEN5PQi1pnEBzDy0Z49HtScLAbD5t6hyeU92A95pRWaSMw1GZZi/RwgSgUIl0xrSlXIT/9QzvYSA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@rolldown/binding-win32-x64-msvc@1.2.0': + resolution: {integrity: sha512-WfFv6/qGufotqBSBzBYwgpCkJBk8Nj7697LL9vTz/XWc67e0r3oewu8iMRwQj3AUL45GVD7wVsPjCsAAtW66Wg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@rolldown/pluginutils@1.0.1': + resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==} + + '@schematics/angular@22.1.4': + resolution: {integrity: sha512-uiYKuiCnkTEbs4eOU1QJlM5NPw6BR1qgpct8VlrhS4n861WCCjTy5cxiAWJ3Doc0R72d44j3uoBfAEp7KEVn2w==} + engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0, npm: ^6.11.0 || ^7.5.6 || >=8.0.0, yarn: '>= 1.13.0'} + + '@shikijs/core@4.4.3': + resolution: {integrity: sha512-QCR4q2ZO/ILJEuwiBMel4wdcTDb1JGwfjKTxPDF6x8ixOaluPrVqIn06C99AcRPhmYlBR56d/Fb+GN58GzExpg==} + engines: {node: '>=20'} + + '@shikijs/engine-javascript@4.4.3': + resolution: {integrity: sha512-FbOjFJp9VLdo1Wevs10BBtVxiTWwNLqZh5Gkhjgda/ioL15YOgeSl9n+6XMa3qRlPQzfhFNe641SrynFHYG0nQ==} + engines: {node: '>=20'} + + '@shikijs/engine-oniguruma@4.4.3': + resolution: {integrity: sha512-EcOQkxdxGQrc1Row/cC2c96/v1dbZqGnEVu1qTuT/MJmp6+cXCvQussowVmCv5Tqr3KuY3c7IbM6HTW3LJ1k9w==} + engines: {node: '>=20'} + + '@shikijs/langs@4.4.3': + resolution: {integrity: sha512-ePic0yfAJGOF83D5wBHK/00EjK65oahBYxFk5epgq33WRv7X9UuxLEV8PtR0szC0z8dl7INIpIodB99JRFlR+A==} + engines: {node: '>=20'} + + '@shikijs/primitive@4.4.3': + resolution: {integrity: sha512-m0wBeLDQDeIxRdUmrCPdQqfuUamDwRL5isCfYbguKD6NiaKpVbsv+3J81DyIKgNW5h4WAIIr8T4EkgQrBBxvaQ==} + engines: {node: '>=20'} + + '@shikijs/themes@4.4.3': + resolution: {integrity: sha512-w8UHjeUnIR965KMWJHUPXOc2mNJUnK3vpVLYLvw5IYU2mnTTJ89E24OrJDBNiJDQ0qzb0tc4l7mrIXx5cFeIyw==} + engines: {node: '>=20'} + + '@shikijs/types@4.4.3': + resolution: {integrity: sha512-UEJxmRR++MAGR6hugn0vgVS2W/6lWAts84FFSrnlH9sP0LNol7E5+NQ792pH8liWUhyMyjhTgSUH3k7iD7tc5g==} + engines: {node: '>=20'} + + '@shikijs/vscode-textmate@10.0.2': + resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==} + + '@standard-schema/spec@1.1.0': + resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==} + + '@tailwindcss/node@4.3.3': + resolution: {integrity: sha512-/T8IKEsf9VTU6tLjgC7+sv2mOPtQxzE2jMw7u4Tt40Tx+QSZxpzh95/H6cMKoja9XuW7iMdLJYBB0o9G1CaAgg==} + + '@tailwindcss/oxide-android-arm64@4.3.3': + resolution: {integrity: sha512-Y85A2gmPSkl5Ve5qR86GL4HT509cFqQh1aes9p3sSkyTPwt0Pppf3GkwGe4JPACcRYjgJIEhQgM6dBClnr0NYw==} + engines: {node: '>= 20'} + cpu: [arm64] + os: [android] + + '@tailwindcss/oxide-darwin-arm64@4.3.3': + resolution: {integrity: sha512-BiaWatpBcERQFDlOjRDpIVXuFK5PJez5SA4JMg6VYZdBYU+qKfV/vqjcIs+IYmtitf1xYQZTwXvU/8y4lfZUGw==} + engines: {node: '>= 20'} + cpu: [arm64] + os: [darwin] + + '@tailwindcss/oxide-darwin-x64@4.3.3': + resolution: {integrity: sha512-fAeUqfV5ndhxRwai8cXGzdLvul9utWOmeTkv69unv4ZXixjn61Z+p9lCWdwOwA3TYboG3BwdVuN/RDjhBRl0mw==} + engines: {node: '>= 20'} + cpu: [x64] + os: [darwin] + + '@tailwindcss/oxide-freebsd-x64@4.3.3': + resolution: {integrity: sha512-iyf5bV6+wnAlflVeEy7R25dupxTNECZN5QMI0qNT6eT+EgaGdZcKhGkr5SdoaWiLJ3spLqIY9VCeSGrwmtg4kw==} + engines: {node: '>= 20'} + cpu: [x64] + os: [freebsd] + + '@tailwindcss/oxide-linux-arm-gnueabihf@4.3.3': + resolution: {integrity: sha512-aAYUprJAJQWWbRrPvtjdroZ56Md+JM8pMiopS6xGEwDfLhqj+2ver2p4nU4Mb3CRqcMmNBjo8KkUgcxhkzVQGQ==} + engines: {node: '>= 20'} + cpu: [arm] + os: [linux] + + '@tailwindcss/oxide-linux-arm64-gnu@4.3.3': + resolution: {integrity: sha512-nDxldcEENOxZRzC2uu9jrutZdAAQtb+8WWDCSnWL1zvBk1+FN+x6MtDViPB5AJMfttVCUhehGWus3XBPgatM/w==} + engines: {node: '>= 20'} + cpu: [arm64] + os: [linux] + + '@tailwindcss/oxide-linux-arm64-musl@4.3.3': + resolution: {integrity: sha512-Md44bD6veX/PC5iyF8cDVnw4HBIANZepRZZ7a8DQOvkfo5WUBwcp6iAuCUz23u+4SUkhJlD3eL7hNdW8ezd/kA==} + engines: {node: '>= 20'} + cpu: [arm64] + os: [linux] + + '@tailwindcss/oxide-linux-x64-gnu@4.3.3': + resolution: {integrity: sha512-tx7us1muwOKAKWao2v/GaafFeQboE6aj88vC6ziN2NCGcRm8gWUhwjzg+YdVB1e4boAtdtma4L43onunI6NS4w==} + engines: {node: '>= 20'} + cpu: [x64] + os: [linux] + + '@tailwindcss/oxide-linux-x64-musl@4.3.3': + resolution: {integrity: sha512-SJxX60smvHgasZoBy11dX6YRjXJFovwWBoedhbQPOBzgFWBHGB+TVPWB9BxzR7TTxU8FQZAI2AyiNCMzFm8Img==} + engines: {node: '>= 20'} + cpu: [x64] + os: [linux] + + '@tailwindcss/oxide-wasm32-wasi@4.3.3': + resolution: {integrity: sha512-jx1+rPhY/5Ympkktd656HBWEBLxP7dH06losBLjjf5vgCODXvi9KhtftWcMIwTFIDqBr7cRnQkdLnAG+IOlGvQ==} + engines: {node: '>=14.0.0'} + cpu: [wasm32] + bundledDependencies: + - '@napi-rs/wasm-runtime' + - '@emnapi/core' + - '@emnapi/runtime' + - '@tybys/wasm-util' + - '@emnapi/wasi-threads' + - tslib + + '@tailwindcss/oxide-win32-arm64-msvc@4.3.3': + resolution: {integrity: sha512-3rc292Ca2ceK6Ulcc/bAVnTs/3nDtoPhyEKlgPv+yQJQi/JS/AMJlqzxvlDacL1nekbrcf6bTqp/jV4qgnPxNQ==} + engines: {node: '>= 20'} + cpu: [arm64] + os: [win32] + + '@tailwindcss/oxide-win32-x64-msvc@4.3.3': + resolution: {integrity: sha512-yJ0pwIVc/nYeGoV02WtsN8KYyLQv7kyI2wDnkezyJlGGjkd4QLwDGAwl47YpPJeuI0M0ObaXGSPjvWDPeTPggw==} + engines: {node: '>= 20'} + cpu: [x64] + os: [win32] + + '@tailwindcss/oxide@4.3.3': + resolution: {integrity: sha512-krXjAikiaFSPaK/FkAQT5UTx3VormQaiZ5hBFlJZ9UFQGB/rwg1MZIhHAG9smMQRTdyJxP6Qt5MwMtdyU5FWrA==} + engines: {node: '>= 20'} + + '@tailwindcss/postcss@4.3.3': + resolution: {integrity: sha512-JTSZZGQi1AyKirbLN3azmjVzef92tcX7h+iSqPdaeStyFpGpDlKvvpxeOE8njhbUanbRwr3z8DyzhICWnMtQeg==} + + '@tailwindcss/typography@0.5.20': + resolution: {integrity: sha512-hwbzQuNUfcPvbegQFatVPl/MY/tcM9KLl963hQ5laJKPh81TEZ1+dNG9PirGvcaDBkp+BCshExAyKVPW91dozw==} + peerDependencies: + tailwindcss: '>=3.0.0 || >=4.0.0 || insiders' + + '@tybys/wasm-util@0.10.3': + resolution: {integrity: sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==} + + '@types/body-parser@1.19.6': + resolution: {integrity: sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==} + + '@types/chai@5.2.3': + resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==} + + '@types/connect@3.4.38': + resolution: {integrity: sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==} + + '@types/deep-eql@4.0.2': + resolution: {integrity: sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==} + + '@types/estree@1.0.9': + resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==} + + '@types/express-serve-static-core@5.1.3': + resolution: {integrity: sha512-dPfW8NFiOF4wOHc7+N/QSxlY9cfSsenewGbAz8C8U/MULPd/YZ27LvJUIlzaXie7e6Ove9YunJGgC9tbHD2cKw==} + + '@types/express@5.0.6': + resolution: {integrity: sha512-sKYVuV7Sv9fbPIt/442koC7+IIwK5olP1KWeD88e/idgoJqDm3JV/YUiPwkoKK92ylff2MGxSz1CSjsXelx0YA==} + + '@types/gensync@1.0.5': + resolution: {integrity: sha512-MbsRCT7mTikHwKZ0X+LVUTLRrZZRLipTuXEO9qOYO+zmjMVk81axyClMROf6uoPD9MRVu46bx8zoR0Ad9q3NAg==} + + '@types/hast@3.0.5': + resolution: {integrity: sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g==} + + '@types/http-errors@2.0.5': + resolution: {integrity: sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==} + + '@types/jsesc@2.5.1': + resolution: {integrity: sha512-9VN+6yxLOPLOav+7PwjZbxiID2bVaeq0ED4qSQmdQTdjnXJSaCVKTR58t15oqH1H5t8Ng2ZX1SabJVoN9Q34bw==} + + '@types/mdast@4.0.4': + resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==} + + '@types/node@20.19.43': + resolution: {integrity: sha512-6oYBAi5ikg4Pl+kGsoYtawUMBT2zZMCvPNF7pVLnHZfd1zf38DRiWn/gT01RYCdUqkv7Fhr+C9ot4/tb+2sVvA==} + + '@types/qs@6.15.1': + resolution: {integrity: sha512-GZHUBZR9hckSUhrxmp1nG6NwdpM9fCunJwyThLW1X3AyHgd9IlHb6VANpQQqDr2o/qQp6McZ3y/IA2rVzKzSbw==} + + '@types/range-parser@1.2.7': + resolution: {integrity: sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==} + + '@types/send@1.2.1': + resolution: {integrity: sha512-arsCikDvlU99zl1g69TcAB3mzZPpxgw0UQnaHeC1Nwb015xp8bknZv5rIfri9xTOcMuaVgvabfIRA7PSZVuZIQ==} + + '@types/serve-static@2.2.0': + resolution: {integrity: sha512-8mam4H1NHLtu7nmtalF7eyBH14QyOASmcxHhSfEoRyr0nP/YdoesEtU+uSRvMe96TW/HPTtkoKqQLl53N7UXMQ==} + + '@types/unist@3.0.3': + resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==} + + '@ungap/structured-clone@1.3.3': + resolution: {integrity: sha512-60YRaenCQcVjYEKOcG824+DRGGIQ3VKErcBoAEDJZz5bKIs2ZG+X/H9Nk+Q6EVkwJk5QNApxbrc5QtBSwtrXAg==} + + '@vitejs/plugin-basic-ssl@2.3.0': + resolution: {integrity: sha512-bdyo8rB3NnQbikdMpHaML9Z1OZPBu6fFOBo+OtxsBlvMJtysWskmBcnbIDhUqgC8tcxNv/a+BcV5U+2nQMm1OQ==} + engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0} + peerDependencies: + vite: ^6.0.0 || ^7.0.0 || ^8.0.0 + + '@vitest/expect@4.1.10': + resolution: {integrity: sha512-YsCn+qAk1GWjQOWFEsEcL2gNQ0zmVmQu3T03qP6UyjhtmdtwtbuI+DASn/7iQB3HGTXkdBwGddzxPlmiql5vlA==} + + '@vitest/mocker@4.1.10': + resolution: {integrity: sha512-v0xaezt+DKEmKfaxg133ldzADrwLGd7Ze1MfQQTYfvs8OqZIwbxyxaYURivwV7sWy5fqn3rH5uOrSp07bp44Ow==} + peerDependencies: + msw: ^2.4.9 + vite: ^6.0.0 || ^7.0.0 || ^8.0.0 + peerDependenciesMeta: + msw: + optional: true + vite: + optional: true + + '@vitest/pretty-format@4.1.10': + resolution: {integrity: sha512-W1HsjSH4MXQ9YfmmhLAoIYf1HRfekQCGngeIgcei6MP5QQGWUe0gkopdZQaVCFO+JDJMrAJGwa5pRpNpvy4P8Q==} + + '@vitest/runner@4.1.10': + resolution: {integrity: sha512-IKI6kpIH+LmpROplyLwBBaCfMgOZOMsygVa6BARD6ahA04VRuJSa6OaVG7kRvSEMD870Vd91rSSw0eegtWyLGg==} + + '@vitest/snapshot@4.1.10': + resolution: {integrity: sha512-xRkfOT1qpTAi/Ti4Y1LtfRc3kEuqxGw59eN2jN9pRWMtS/XDevekhcFSqvQqjUNGksfjMJu3Y+oJ+4Ypn2OaJw==} + + '@vitest/spy@4.1.10': + resolution: {integrity: sha512-PLf/Ugvoq5wO/b4rwYCR1h2PSIdXz7wnkQFMiUpLdtM7l6pqVFcQIBEHyT1+l+cj7mNwAfZHzqXqDyjvOuwbDw==} + + '@vitest/utils@4.1.10': + resolution: {integrity: sha512-fy9am/HWxbaGt/Sawrp90vt6Y6jQwf1RX77cz3uwoJwJVMli/e1IEwRPnMNJ7vKfPTwo0diXifkpPvwH9v7nGA==} + + accepts@2.0.0: + resolution: {integrity: sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==} + engines: {node: '>= 0.6'} + + agent-base@7.1.4: + resolution: {integrity: sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==} + engines: {node: '>= 14'} + + agent-base@9.0.0: + resolution: {integrity: sha512-TQf59BsZnytt8GdJKLPfUZ54g/iaUL2OWDSFCCvMOhsHduDQxO8xC4PNeyIkVcA5KwL2phPSv0douC0fgWzmnA==} + engines: {node: '>= 20'} + + ajv-formats@3.0.1: + resolution: {integrity: sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==} + peerDependencies: + ajv: ^8.0.0 + peerDependenciesMeta: + ajv: + optional: true + + ajv@8.20.0: + resolution: {integrity: sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==} + + ansi-escapes@7.3.0: + resolution: {integrity: sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==} + engines: {node: '>=18'} + + ansi-regex@6.3.0: + resolution: {integrity: sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==} + engines: {node: '>=12'} + + ansi-styles@6.2.3: + resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==} + engines: {node: '>=12'} + + argparse@1.0.10: + resolution: {integrity: sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==} + + assertion-error@2.0.1: + resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==} + engines: {node: '>=12'} + + baseline-browser-mapping@2.11.14: + resolution: {integrity: sha512-JyJ954WzuIR8/FFzX0o5krdSTrBAkcCSRfWSleRsIHSWV+cZe2FI1PKggVkFke1hBldRs+LRxUczzE9iPmgZww==} + engines: {node: '>=6.0.0'} + hasBin: true + + beasties@0.4.3: + resolution: {integrity: sha512-fIIeLOcbAB/K1kb1HBVJoiq1alHL4RCYBSo5e7HzrNkkgMggXR1Vqt/Z9JWnkfe/qdCo66Ux3QRwZioAIBdWRA==} + engines: {node: '>=18.0.0'} + + bidi-js@1.0.3: + resolution: {integrity: sha512-RKshQI1R3YQ+n9YJz2QQ147P66ELpa1FQEg20Dk8oW9t2KgLbpDLLp9aGZ7y8WHSshDknG0bknqGw5/tyCs5tw==} + + body-parser@2.3.0: + resolution: {integrity: sha512-2cGmJupaNgg+QUwVLAucDuWuoMZ6EX9iHDRswZ5lsNYEmwPaRknMPCLZz07yTzVq/83p4o/wzbDZbBrTvGGTIw==} + engines: {node: '>=18'} + + boolbase@1.0.0: + resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==} + + browserslist@4.28.8: + resolution: {integrity: sha512-V2NpofLblG64mfOtSgDhOJESZEGogzDMBv/q+W6oc4LXWP/q75eOXoOaaOu1EOadB9U4Bwx/e0yzbvwKH8zalA==} + engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7} + hasBin: true + + buffer-from@1.1.2: + resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==} + + bytes@3.1.2: + resolution: {integrity: sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==} + engines: {node: '>= 0.8'} + + call-bind-apply-helpers@1.0.2: + resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==} + engines: {node: '>= 0.4'} + + call-bound@1.0.4: + resolution: {integrity: sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==} + engines: {node: '>= 0.4'} + + caniuse-lite@1.0.30001809: + resolution: {integrity: sha512-xxWVywk6a6Arlk+hymeycyn/VgqEfLDxupvhH/xiY5SJ/18kmi9o6MiO320DCUzypORHLtvh0I4i04tUhCNHNQ==} + + ccount@2.0.1: + resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==} + + chai@6.2.2: + resolution: {integrity: sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==} + engines: {node: '>=18'} + + chalk@5.6.2: + resolution: {integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==} + engines: {node: ^12.17.0 || ^14.13 || >=16.0.0} + + character-entities-html4@2.1.0: + resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==} + + character-entities-legacy@3.0.0: + resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==} + + chardet@2.2.0: + resolution: {integrity: sha512-rddelWYNPRrXq6PtNEN2S3f6t9ILzvqaN5pVgi4kqt9jHQaXIial9PznB5iSPVlQSLNaaH22ItWz3EJtQ10+OA==} + + chokidar@5.0.0: + resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==} + engines: {node: '>= 20.19.0'} + + cli-cursor@5.0.0: + resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==} + engines: {node: '>=18'} + + cli-spinners@3.4.0: + resolution: {integrity: sha512-bXfOC4QcT1tKXGorxL3wbJm6XJPDqEnij2gQ2m7ESQuE+/z9YFIWnl/5RpTiKWbMq3EVKR4fRLJGn6DVfu0mpw==} + engines: {node: '>=18.20'} + + cli-truncate@5.2.0: + resolution: {integrity: sha512-xRwvIOMGrfOAnM1JYtqQImuaNtDEv9v6oIYAs4LIHwTiKee8uwvIi363igssOC0O5U04i4AlENs79LQLu9tEMw==} + engines: {node: '>=20'} + + cli-width@4.1.0: + resolution: {integrity: sha512-ouuZd4/dm2Sw5Gmqy6bGyNNNe1qt9RpmxveLSO7KcgsTnU7RXfsw+/bukWGo1abgBiMAic068rclZsO4IWmmxQ==} + engines: {node: '>= 12'} + + cliui@9.0.1: + resolution: {integrity: sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==} + engines: {node: '>=20'} + + comma-separated-tokens@2.0.3: + resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==} + + content-disposition@1.1.0: + resolution: {integrity: sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==} + engines: {node: '>=18'} + + content-type@1.0.5: + resolution: {integrity: sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==} + engines: {node: '>= 0.6'} + + content-type@2.1.0: + resolution: {integrity: sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==} + engines: {node: '>=18'} + + convert-source-map@1.9.0: + resolution: {integrity: sha512-ASFBup0Mz1uyiIjANan1jzLQami9z1PoYSZCiiYW2FczPbenXc45FZdBZLzOT+r6+iciuEModtmCti+hjaAk0A==} + + convert-source-map@2.0.0: + resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==} + + cookie-signature@1.2.2: + resolution: {integrity: sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==} + engines: {node: '>=6.6.0'} + + cookie@0.7.2: + resolution: {integrity: sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==} + engines: {node: '>= 0.6'} + + cors@2.8.6: + resolution: {integrity: sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==} + engines: {node: '>= 0.10'} + + cross-spawn@7.0.6: + resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==} + engines: {node: '>= 8'} + + css-select@6.0.0: + resolution: {integrity: sha512-rZZVSLle8v0+EY8QAkDWrKhpgt6SA5OtHsgBnsj6ZaLb5dmDVOWUDtQitd9ydxxvEjhewNudS6eTVU7uOyzvXw==} + + css-tree@3.2.1: + resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==} + engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0} + + css-what@7.0.0: + resolution: {integrity: sha512-wD5oz5xibMOPHzy13CyGmogB3phdvcDaB5t0W/Nr5Z2O/agcB8YwOz6e2Lsp10pNDzBoDO9nVa3RGs/2BttpHQ==} + engines: {node: '>= 6'} + + cssesc@3.0.0: + resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==} + engines: {node: '>=4'} + hasBin: true + + cssstyle@6.2.0: + resolution: {integrity: sha512-Fm5NvhYathRnXNVndkUsCCuR63DCLVVwGOOwQw782coXFi5HhkXdu289l59HlXZBawsyNccXfWRYvLzcDCdDig==} + engines: {node: '>=20'} + + data-urls@7.0.0: + resolution: {integrity: sha512-23XHcCF+coGYevirZceTVD7NdJOqVn+49IHyxgszm+JIiHLoB2TkmPtsYkNWT1pvRSGkc35L6NHs0yHkN2SumA==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + debug@4.4.3: + resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==} + engines: {node: '>=6.0'} + peerDependencies: + supports-color: '*' + peerDependenciesMeta: + supports-color: + optional: true + + decimal.js@10.6.0: + resolution: {integrity: sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==} + + depd@2.0.0: + resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==} + engines: {node: '>= 0.8'} + + dequal@2.0.3: + resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==} + engines: {node: '>=6'} + + detect-libc@2.1.2: + resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} + engines: {node: '>=8'} + + devlop@1.1.0: + resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==} + + dom-serializer@2.0.0: + resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==} + + domelementtype@2.3.0: + resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==} + + domhandler@5.0.3: + resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==} + engines: {node: '>= 4'} + + domutils@3.2.2: + resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==} + + dunder-proto@1.0.1: + resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==} + engines: {node: '>= 0.4'} + + ee-first@1.1.1: + resolution: {integrity: sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==} + + electron-to-chromium@1.5.406: + resolution: {integrity: sha512-hWH5ORBi3d0IipnMh7BN5GDTaAmrSSSWmznwt2zltdiRNEWoEQyTwF0FFSBxzHO7hLSRT6loQu3IQGV0wg/Tvg==} + + emoji-regex@10.6.0: + resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==} + + empathic@2.0.1: + resolution: {integrity: sha512-YGRs8knHhKHVShLkFET/rWAU8kmHbOV5LwN938RHI0pljAJ1Gf6SzXsSmRaEzcXTtOOmVqJ5+WtQPL5uigY50Q==} + engines: {node: '>=14'} + + encodeurl@2.0.0: + resolution: {integrity: sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==} + engines: {node: '>= 0.8'} + + enhanced-resolve@5.24.5: + resolution: {integrity: sha512-L1l8TNvomm6UVW5B253AGxQagSQr+vGwhMlrrfRS2qmhx46AMpMVJKQYLvWYbysTMY8VoicOvzHzoHMbyzB+4A==} + engines: {node: '>=10.13.0'} + + entities@4.5.0: + resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==} + engines: {node: '>=0.12'} + + entities@7.0.1: + resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==} + engines: {node: '>=0.12'} + + entities@8.0.0: + resolution: {integrity: sha512-zwfzJecQ/Uej6tusMqwAqU/6KL2XaB2VZ2Jg54Je6ahNBGNH6Ek6g3jjNCF0fG9EWQKGZNddNjU5F1ZQn/sBnA==} + engines: {node: '>=20.19.0'} + + environment@1.1.0: + resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==} + engines: {node: '>=18'} + + es-define-property@1.0.1: + resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==} + engines: {node: '>= 0.4'} + + es-errors@1.3.0: + resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==} + engines: {node: '>= 0.4'} + + es-module-lexer@2.3.1: + resolution: {integrity: sha512-shc1dbU90Yl/xq1QrC7QRtfcwURZuVRfPhZbDoldJ1cn1gzDvBaBWlv0eFolj5+0znnPJz5TXLxsN77X/12KTA==} + + es-object-atoms@1.1.2: + resolution: {integrity: sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==} + engines: {node: '>= 0.4'} + + esbuild@0.28.2: + resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==} + engines: {node: '>=18'} + hasBin: true + + escalade@3.2.0: + resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==} + engines: {node: '>=6'} + + escape-html@1.0.3: + resolution: {integrity: sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==} + + esprima@4.0.1: + resolution: {integrity: sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==} + engines: {node: '>=4'} + hasBin: true + + estree-walker@3.0.3: + resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==} + + etag@1.8.1: + resolution: {integrity: sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==} + engines: {node: '>= 0.6'} + + eventemitter3@5.0.4: + resolution: {integrity: sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==} + + eventsource-parser@3.1.1: + resolution: {integrity: sha512-EKN1vKAMcZ8MlYMpaNuxN6R9yakzH6uajHcHVTqWJzvu5pWw9DyhbP35HH8MVBQ+dZjAfDxk+A8NiR9KWaXiyQ==} + engines: {node: '>=18.0.0'} + + eventsource@3.0.7: + resolution: {integrity: sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==} + engines: {node: '>=18.0.0'} + + expect-type@1.4.0: + resolution: {integrity: sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==} + engines: {node: '>=12.0.0'} + + express-rate-limit@8.6.2: + resolution: {integrity: sha512-YH4ru+eOJxQABscKFfRCy9R7x9QFGdezclVMwwgFFndzS2Xnm0uo6B0ABZsLhcpeptGv2qvuJVWlQr9gQZoC3A==} + engines: {node: '>= 16'} + peerDependencies: + express: '>= 4.11' + + express@5.2.1: + resolution: {integrity: sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==} + engines: {node: '>= 18'} + + extend-shallow@2.0.1: + resolution: {integrity: sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==} + engines: {node: '>=0.10.0'} + + fast-deep-equal@3.1.3: + resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==} + + fast-string-truncated-width@3.0.3: + resolution: {integrity: sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==} + + fast-string-width@3.0.2: + resolution: {integrity: sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==} + + fast-uri@3.1.5: + resolution: {integrity: sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==} + + fast-wrap-ansi@0.2.2: + resolution: {integrity: sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==} + + fdir@6.5.0: + resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} + engines: {node: '>=12.0.0'} + peerDependencies: + picomatch: ^3 || ^4 + peerDependenciesMeta: + picomatch: + optional: true + + finalhandler@2.1.1: + resolution: {integrity: sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==} + engines: {node: '>= 18.0.0'} + + forwarded@0.2.0: + resolution: {integrity: sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==} + engines: {node: '>= 0.6'} + + fresh@2.0.0: + resolution: {integrity: sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==} + engines: {node: '>= 0.8'} + + fsevents@2.3.2: + resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==} + engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} + os: [darwin] + + fsevents@2.3.3: + resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==} + engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} + os: [darwin] + + function-bind@1.1.2: + resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==} + + gensync@1.0.0-beta.2: + resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==} + engines: {node: '>=6.9.0'} + + get-caller-file@2.0.5: + resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==} + engines: {node: 6.* || 8.* || >= 10.*} + + get-east-asian-width@1.6.0: + resolution: {integrity: sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==} + engines: {node: '>=18'} + + get-intrinsic@1.3.0: + resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==} + engines: {node: '>= 0.4'} + + get-proto@1.0.1: + resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==} + engines: {node: '>= 0.4'} + + github-slugger@2.0.0: + resolution: {integrity: sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==} + + gopd@1.2.0: + resolution: {integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==} + engines: {node: '>= 0.4'} + + graceful-fs@4.2.11: + resolution: {integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==} + + gray-matter@4.0.3: + resolution: {integrity: sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==} + engines: {node: '>=6.0'} + + has-symbols@1.1.0: + resolution: {integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==} + engines: {node: '>= 0.4'} + + hasown@2.0.4: + resolution: {integrity: sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==} + engines: {node: '>= 0.4'} + + hast-util-to-html@9.0.5: + resolution: {integrity: sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==} + + hast-util-whitespace@3.0.0: + resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==} + + hono@4.13.2: + resolution: {integrity: sha512-JydRilDRkYBQMt9qR9U92mXxmbGqsqSn/IKOrh4e7/gEbn+0zSr8igTu0obwJoNGN4sez28DIql7FBHWydoJpA==} + engines: {node: '>=16.9.0'} + + hosted-git-info@10.1.1: + resolution: {integrity: sha512-DeOnSPAvOndYKfw075gt8yZzQ7S2hNztw34zBTfhIzLhmBTswIBg5/y+pqu/VD5cYWm5goAFTusDmUEmKZ0PEQ==} + engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0} + + html-encoding-sniffer@6.0.0: + resolution: {integrity: sha512-CV9TW3Y3f8/wT0BRFc1/KAVQ3TUHiXmaAb6VW9vtiMFf7SLoMd1PdAc4W3KFOFETBJUb90KatHqlsZMWV+R9Gg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + html-void-elements@3.0.0: + resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==} + + htmlparser2@10.1.0: + resolution: {integrity: sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ==} + + http-errors@2.0.1: + resolution: {integrity: sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==} + engines: {node: '>= 0.8'} + + http-proxy-agent@7.0.2: + resolution: {integrity: sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==} + engines: {node: '>= 14'} + + https-proxy-agent@7.0.6: + resolution: {integrity: sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==} + engines: {node: '>= 14'} + + https-proxy-agent@9.1.0: + resolution: {integrity: sha512-ag87y7cJJ9/3+GxFr8Oy4O5faDsGRGnBGsJj/YjOSsSx/5eadKLYTMPlzuR6obgoCDDm0abAAZitXXQkMOPSpA==} + engines: {node: '>= 20'} + + iconv-lite@0.7.3: + resolution: {integrity: sha512-IKXpvIzjnC9XTAUbVBcMfGS0EPaIXtW6v+zr+RRp+hqULEpo0owZax6wyRwPOJbWbzjYspQwusTsfVr0ifh4uQ==} + engines: {node: '>=0.10.0'} + + immutable@5.1.9: + resolution: {integrity: sha512-m8nVez3rwrgmWxtLMt1ZYXB2Lv7OKYn/disyxAlSDYAlKSlFoPPfIAmAM/M5xqL4m4C/wAPw7S2/CNaUii1Hxg==} + + import-meta-resolve@4.2.0: + resolution: {integrity: sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==} + + inherits@2.0.4: + resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==} + + ip-address@10.5.0: + resolution: {integrity: sha512-R5SnVLJmgYYvf2F2ZgwSBnelz5G4q5AxIC277GDfUaNbrZKNANcBC7RHqYYePlszf4kBolVkJauG0ZjHHFh55g==} + engines: {node: '>= 12'} + + ipaddr.js@1.9.1: + resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==} + engines: {node: '>= 0.10'} + + is-extendable@0.1.1: + resolution: {integrity: sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==} + engines: {node: '>=0.10.0'} + + is-extglob@2.1.1: + resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==} + engines: {node: '>=0.10.0'} + + is-fullwidth-code-point@5.1.0: + resolution: {integrity: sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ==} + engines: {node: '>=18'} + + is-glob@4.0.3: + resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==} + engines: {node: '>=0.10.0'} + + is-interactive@2.0.0: + resolution: {integrity: sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==} + engines: {node: '>=12'} + + is-potential-custom-element-name@1.0.1: + resolution: {integrity: sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==} + + is-promise@4.0.0: + resolution: {integrity: sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==} + + is-unicode-supported@2.1.0: + resolution: {integrity: sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==} + engines: {node: '>=18'} + + isexe@2.0.0: + resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==} + + jiti@2.7.0: + resolution: {integrity: sha512-AC/7JofJvZGrrneWNaEnJeOLUx+JlGt7tNa0wZiRPT4MY1wmfKjt2+6O2p2uz2+skll8OZZmJMNqeke7kKbNgQ==} + hasBin: true + + jose@6.2.8: + resolution: {integrity: sha512-Bsdjwm3Qsd/P0jR+BHDe3LytDfY7WBq2HmCCLIwuVRHMuEC9ae7/R474GIUdF1NgCyZjzVo/A9DOiOBtXq8ZoQ==} + + js-tokens@10.0.0: + resolution: {integrity: sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==} + + js-yaml@3.15.1: + resolution: {integrity: sha512-S99WuO3HlhO3XN41EtYUNl9zzXjoJx7QvmipxsJVxtCBT0YHEFy+iOJhjSvrmV12nYhWpZaM8lPHkJm0yUMbag==} + hasBin: true + + jsdom@28.1.0: + resolution: {integrity: sha512-0+MoQNYyr2rBHqO1xilltfDjV9G7ymYGlAUazgcDLQaUf8JDHbuGwsxN6U9qWaElZ4w1B2r7yEGIL3GdeW3Rug==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + peerDependencies: + canvas: ^3.0.0 + peerDependenciesMeta: + canvas: + optional: true + + jsesc@3.1.0: + resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==} + engines: {node: '>=6'} + hasBin: true + + json-schema-traverse@1.0.0: + resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==} + + json-schema-typed@8.0.2: + resolution: {integrity: sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==} + + json5@2.2.3: + resolution: {integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==} + engines: {node: '>=6'} + hasBin: true + + jsonc-parser@3.3.1: + resolution: {integrity: sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==} + + kind-of@6.0.3: + resolution: {integrity: sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==} + engines: {node: '>=0.10.0'} + + lightningcss-android-arm64@1.32.0: + resolution: {integrity: sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [android] + + lightningcss-android-arm64@1.33.0: + resolution: {integrity: sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [android] + + lightningcss-darwin-arm64@1.32.0: + resolution: {integrity: sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [darwin] + + lightningcss-darwin-arm64@1.33.0: + resolution: {integrity: sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [darwin] + + lightningcss-darwin-x64@1.32.0: + resolution: {integrity: sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [darwin] + + lightningcss-darwin-x64@1.33.0: + resolution: {integrity: sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [darwin] + + lightningcss-freebsd-x64@1.32.0: + resolution: {integrity: sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [freebsd] + + lightningcss-freebsd-x64@1.33.0: + resolution: {integrity: sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [freebsd] + + lightningcss-linux-arm-gnueabihf@1.32.0: + resolution: {integrity: sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==} + engines: {node: '>= 12.0.0'} + cpu: [arm] + os: [linux] + + lightningcss-linux-arm-gnueabihf@1.33.0: + resolution: {integrity: sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm] + os: [linux] + + lightningcss-linux-arm64-gnu@1.32.0: + resolution: {integrity: sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + + lightningcss-linux-arm64-gnu@1.33.0: + resolution: {integrity: sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + + lightningcss-linux-arm64-musl@1.32.0: + resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + + lightningcss-linux-arm64-musl@1.33.0: + resolution: {integrity: sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + + lightningcss-linux-x64-gnu@1.32.0: + resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + + lightningcss-linux-x64-gnu@1.33.0: + resolution: {integrity: sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + + lightningcss-linux-x64-musl@1.32.0: + resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + + lightningcss-linux-x64-musl@1.33.0: + resolution: {integrity: sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + + lightningcss-win32-arm64-msvc@1.32.0: + resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [win32] + + lightningcss-win32-arm64-msvc@1.33.0: + resolution: {integrity: sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [win32] + + lightningcss-win32-x64-msvc@1.32.0: + resolution: {integrity: sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [win32] + + lightningcss-win32-x64-msvc@1.33.0: + resolution: {integrity: sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [win32] + + lightningcss@1.32.0: + resolution: {integrity: sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==} + engines: {node: '>= 12.0.0'} + + lightningcss@1.33.0: + resolution: {integrity: sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==} + engines: {node: '>= 12.0.0'} + + listr2@10.2.2: + resolution: {integrity: sha512-JtNtbZj8q5BnDMR7trpwvwk3RIrANtIVzEUm8w7amp6xelLgyuq+4WZoTH913XaQAoH/cNdYhaNzBPA2U3xbDw==} + engines: {node: '>=22.13.0'} + + lmdb@3.5.6: + resolution: {integrity: sha512-j3uE8ReKNyUWDjhfEFSJqE/1DLtfTR5Z8yFzVHvBjAk37wNg7HdScjcv8ttPHRvrdgPQMPWxFFI0SsdBzI5lBw==} + hasBin: true + + log-symbols@7.0.1: + resolution: {integrity: sha512-ja1E3yCr9i/0hmBVaM0bfwDjnGy8I/s6PP4DFp+yP+a+mrHO4Rm7DtmnqROTUkHIkqffC84YY7AeqX6oFk0WFg==} + engines: {node: '>=18'} + + log-update@6.1.0: + resolution: {integrity: sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==} + engines: {node: '>=18'} + + lru-cache@11.5.2: + resolution: {integrity: sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==} + engines: {node: 20 || >=22} + + magic-string@0.30.21: + resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==} + + magic-string@1.0.0: + resolution: {integrity: sha512-CGvjzMN08iv6w1mm4/x3Gh1hLb4VnyRUA15FFpl6CsCIGGoe36k7kY5KNz9QDbSBN5I/fWHM6ZlIkUTa5xdUEA==} + + marked@18.0.9: + resolution: {integrity: sha512-/Sa4qiiHZxf0/FQdBBowr9q4r10krCwMvpK48FUBdXdUXScDxiQGR9zCPrFgRVR5LU3iySOiIjy09ZQvADir1w==} + engines: {node: '>= 20'} + hasBin: true + + math-intrinsics@1.1.0: + resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==} + engines: {node: '>= 0.4'} + + mdast-util-to-hast@13.2.1: + resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==} + + mdn-data@2.27.1: + resolution: {integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==} + + media-typer@1.1.1: + resolution: {integrity: sha512-yz3xRaG20c6/BOzvYoDaGtPmGscs7YivItZEEqe6GbwNfHuxu9YNmvnEkMzKldAGY4/80pRcQRZSEnhquk9XuQ==} + engines: {node: '>= 0.8'} + + merge-descriptors@2.0.0: + resolution: {integrity: sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==} + engines: {node: '>=18'} + + micromark-util-character@2.1.1: + resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==} + + micromark-util-encode@2.0.1: + resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==} + + micromark-util-sanitize-uri@2.0.1: + resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==} + + micromark-util-symbol@2.0.1: + resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==} + + micromark-util-types@2.0.2: + resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==} + + mime-db@1.54.0: + resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==} + engines: {node: '>= 0.6'} + + mime-types@3.0.2: + resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==} + engines: {node: '>=18'} + + mimic-function@5.0.1: + resolution: {integrity: sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==} + engines: {node: '>=18'} + + mrmime@2.0.1: + resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==} + engines: {node: '>=10'} + + ms@2.1.3: + resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==} + + msgpackr-extract@3.0.4: + resolution: {integrity: sha512-4kmO/MdyUIkLIvTPr8VHLil4AtoKIoniWPIEk5+CDy0xnWC84azhSFmuJ7PxZdsYtiP5kEeQsORAVIeMgxT+Hw==} + hasBin: true + + msgpackr@1.12.1: + resolution: {integrity: sha512-4EUH9tQHnMmEgzW/MdAP0KIfa1T9AF+htl0ffe2n5vb2EKn9y2co8ccpgWko6S52Jy1PQZKwRnx5/KkYjtd9MQ==} + + mute-stream@3.0.0: + resolution: {integrity: sha512-dkEJPVvun4FryqBmZ5KhDo0K9iDXAwn08tMLDinNdRBNPcYEDiWYysLcc6k3mjTMlbP9KyylvRpd4wFtwrT9rw==} + engines: {node: ^20.17.0 || >=22.9.0} + + nanoid@3.3.18: + resolution: {integrity: sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==} + engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} + hasBin: true + + negotiator@1.0.0: + resolution: {integrity: sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==} + engines: {node: '>= 0.6'} + + node-addon-api@6.1.0: + resolution: {integrity: sha512-+eawOlIgy680F0kBzPUNFhMZGtJ1YmqM6l4+Crf4IkImjYrO/mqPwRMh352g23uIaQKFItcQ64I7KMaJxHgAVA==} + + node-addon-api@7.1.1: + resolution: {integrity: sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==} + + node-gyp-build-optional-packages@5.2.2: + resolution: {integrity: sha512-s+w+rBWnpTMwSFbaE0UXsRlg7hU4FjekKU4eyAih5T8nJuNZT1nNsskXpxmeqSK9UzkBl6UgRlnKc8hz8IEqOw==} + hasBin: true + + node-releases@2.0.53: + resolution: {integrity: sha512-D9UOmYG3UH1V+ENW56t5QXBwJw1YEY18ruVeus89Rw+SyIgjPkCO84bRzO3uNIYosJbNwiabWVn48o3uJLjxFQ==} + engines: {node: '>=18'} + + npm-package-arg@14.0.0: + resolution: {integrity: sha512-69XQh3k+dtGa1p+7RaR57IuG3rCko96xr/nUfN4yDYBXbTYICiWcOpsFKLN2GtGE9cyIljE+f1exnaYt9MvM+Q==} + engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0} + + nth-check@2.1.1: + resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==} + + object-assign@4.1.1: + resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==} + engines: {node: '>=0.10.0'} + + object-inspect@1.13.4: + resolution: {integrity: sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==} + engines: {node: '>= 0.4'} + + obug@2.1.4: + resolution: {integrity: sha512-4a+OsYv9UktOJKE+l1A4OufDgdRF9PifWj+tJnHURo/P+WOxpG4GzUFL9qCalmWauao6ogiG+QvnCovwPoyAWA==} + engines: {node: '>=12.20.0'} + + on-finished@2.4.1: + resolution: {integrity: sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==} + engines: {node: '>= 0.8'} + + once@1.4.0: + resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==} + + onetime@7.0.0: + resolution: {integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==} + engines: {node: '>=18'} + + oniguruma-parser@0.12.2: + resolution: {integrity: sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==} + + oniguruma-to-es@4.3.6: + resolution: {integrity: sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==} + + ora@9.4.1: + resolution: {integrity: sha512-6VlU9MLXbjVQD04AZCMX28hVtA5bUoadvUqO76MUCVA0ilwJbMiHsITRPfyVm6p/BC0Av/BXMujx39WCe1LEqw==} + engines: {node: '>=20'} + + ordered-binary@1.6.1: + resolution: {integrity: sha512-QkCdPooczexPLiXIrbVOPYkR3VO3T6v2OyKRkR1Xbhpy7/LAVXwahnRCgRp78Oe/Ehf0C/HATAxfSr6eA1oX+w==} + + oxc-parser@0.142.0: + resolution: {integrity: sha512-kKR+jPiRJYJDexVoziIg/FVGvr1fT1FZSSJOk6tVoMKKSlsf1Cso+cgGCJkOEDWOP174vRntCPFKg+AS7InWvw==} + engines: {node: ^20.19.0 || >=22.12.0} + + parse5-html-rewriting-stream@8.0.1: + resolution: {integrity: sha512-NaRku2aMpUN1Sh1Gyk1KWUh2A7EJx2c6qYzvwsPtqhoHoaURshdrceYK3LunVCm3WHhm6FS7Vcczbvdh3/UIVw==} + + parse5-sax-parser@8.0.0: + resolution: {integrity: sha512-/dQ8UzHZwnrzs3EvDj6IkKrD/jIZyTlB+8XrHJvcjNgRdmWruNdN9i9RK/JtxakmlUdPwKubKPTCqvbTgzGhrw==} + + parse5@8.0.1: + resolution: {integrity: sha512-z1e/HMG90obSGeidlli3hj7cbocou0/wa5HacvI3ASx34PecNjNQeaHNo5WIZpWofN9kgkqV1q5YvXe3F0FoPw==} + + parseurl@1.3.3: + resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==} + engines: {node: '>= 0.8'} + + path-key@3.1.1: + resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==} + engines: {node: '>=8'} + + path-to-regexp@8.4.2: + resolution: {integrity: sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==} + + pathe@2.0.3: + resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==} + + picocolors@1.1.1: + resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==} + + picomatch@4.0.5: + resolution: {integrity: sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==} + engines: {node: '>=12'} + + piscina@5.2.0: + resolution: {integrity: sha512-DszUCKeVN/5G5QKo6jAVHL8fmKnkJvQ0ACiVgY7YGCq3TUB2oznAOayvZPIAdEThvhczkXR+qm3IHsNXpFCYfA==} + engines: {node: '>=20.x'} + + pkce-challenge@5.0.1: + resolution: {integrity: sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==} + engines: {node: '>=16.20.0'} + + playwright-core@1.62.1: + resolution: {integrity: sha512-wPYSwEBJY9GHraISXqyqtx0na0LpO3XEX7jNDhntbex7tzUS7kLnZsOlFruFJB4Hi/rhDMjXGqHewDZ68nYZVw==} + engines: {node: '>=20'} + hasBin: true + + playwright@1.62.1: + resolution: {integrity: sha512-0M+L3LAD8/nm554LOla9Ayx0j0tmFZ0FBcoQ7F1VuVHpM/XpiC8RcDzBQB8W5+hA8L22THxELzeF+2WcUzvcLg==} + engines: {node: '>=20'} + hasBin: true + + postcss-media-query-parser@0.2.3: + resolution: {integrity: sha512-3sOlxmbKcSHMjlUXQZKQ06jOswE7oVkXPxmZdoB1r5l0q6gTFTQSHxNxOrCccElbW7dxNytifNEo8qidX2Vsig==} + + postcss-safe-parser@7.0.1: + resolution: {integrity: sha512-0AioNCJZ2DPYz5ABT6bddIqlhgwhpHZ/l65YAYo0BCIn0xiDpsnTHz0gnoTGk0OXZW0JRs+cDwL8u/teRdz+8A==} + engines: {node: '>=18.0'} + peerDependencies: + postcss: ^8.4.31 + + postcss-selector-parser@6.0.10: + resolution: {integrity: sha512-IQ7TZdoaqbT+LCpShg46jnZVlhWD2w6iQYAcYXfHARZ7X1t/UGhhceQDs5X0cGqKvYlHNOuv7Oa1xmb0oQuA3w==} + engines: {node: '>=4'} + + postcss@8.5.26: + resolution: {integrity: sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==} + engines: {node: ^10 || ^12 || >=14} + + prettier@3.9.6: + resolution: {integrity: sha512-OpN0zzVdiaiAhxpuuj5efpIS4sY9j7bY6uR5mnj5yPzGkdkjNKSJeUThPb60Jw29QuAZgA4o+/iB49kFiaBX6g==} + engines: {node: '>=14'} + hasBin: true + + proc-log@7.0.0: + resolution: {integrity: sha512-FYgfaA69XZ93zaXLoMNQ+ViDXGGBgR8aLh03txzcFhV+9xOXx7+8DLCULrKKpR9+GsH9ZfHm82aSUPpozX0Ztg==} + engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0} + + property-information@7.2.0: + resolution: {integrity: sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==} + + proxy-addr@2.0.7: + resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==} + engines: {node: '>= 0.10'} + + proxy-agent-negotiate@1.1.0: + resolution: {integrity: sha512-N8IBcM3UgCVzz2L2Lqv8DVntDnnC8/hiV4nEDUPkqq72TPUgYWjQc+bdZlBPZK9LzPAvOY//gAt0S0DApoOXWQ==} + engines: {node: '>= 20'} + peerDependencies: + kerberos: ^2.0.0 + peerDependenciesMeta: + kerberos: + optional: true + + punycode@2.3.1: + resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==} + engines: {node: '>=6'} + + qs@6.15.3: + resolution: {integrity: sha512-O9gl3zCl5h5blw1KGUzQKhA5oUXSl8rwUIM5o0S3nCXMliSvy5Dzx7/DJcI+SwgICv+IneSZwhBh1oSyEHA71A==} + engines: {node: '>=0.6'} + + range-parser@1.3.0: + resolution: {integrity: sha512-hek2mFQpPuI4E1BBKrSto+BU3e3x4xuarsbiwr3+lf7p44juvFMV0XFWQAP3xUyqXA4RrXLIoaSUGbSt056ZMw==} + engines: {node: '>= 0.6'} + + raw-body@3.0.2: + resolution: {integrity: sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==} + engines: {node: '>= 0.10'} + + readdirp@5.1.1: + resolution: {integrity: sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==} + engines: {node: '>= 20.19.0'} + + reflect-metadata@0.2.2: + resolution: {integrity: sha512-urBwgfrvVP/eAyXx4hluJivBKzuEbSQs9rKWCrCkbSxNv8mxPcUZKeuoF3Uy4mJl3Lwprp6yy5/39VWigZ4K6Q==} + + regex-recursion@6.0.2: + resolution: {integrity: sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==} + + regex-utilities@2.3.0: + resolution: {integrity: sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==} + + regex@6.1.0: + resolution: {integrity: sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==} + + require-from-string@2.0.2: + resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==} + engines: {node: '>=0.10.0'} + + restore-cursor@5.1.0: + resolution: {integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==} + engines: {node: '>=18'} + + rfdc@1.4.1: + resolution: {integrity: sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==} + + rolldown@1.1.5: + resolution: {integrity: sha512-t9z29cJjXf/vxQ8dyhCSpt6H6aSwHTk8cT5I3iy6SMXuFpk5mB6PL6XfC8PCwrPTx93udwKUm9HRteAlTGBLiA==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + + rolldown@1.2.0: + resolution: {integrity: sha512-u7tgm5l4Yw1iTqUL4EcYOAt7fFvCgQMLeidrnD4GALlC6aOznCjezYajgxeyKw27u0Q5N7fwgCzjVyPIWzwuBA==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + + router@2.2.0: + resolution: {integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==} + engines: {node: '>= 18'} + + rxjs@7.8.2: + resolution: {integrity: sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==} + + safer-buffer@2.1.2: + resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==} + + sass@1.101.0: + resolution: {integrity: sha512-OL3GoQyoUdDt843DpVmDO6y2k1sc5IhUDSpu8XucEI+35neq5QivZ1iuegnpraEVTJXlQGK1gl27zKcTLEPbQw==} + engines: {node: '>=20.19.0'} + hasBin: true + + saxes@6.0.0: + resolution: {integrity: sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==} + engines: {node: '>=v12.22.7'} + + section-matter@1.0.0: + resolution: {integrity: sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==} + engines: {node: '>=4'} + + semver@7.8.5: + resolution: {integrity: sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==} + engines: {node: '>=10'} + hasBin: true + + send@1.2.1: + resolution: {integrity: sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==} + engines: {node: '>= 18'} + + serve-static@2.2.1: + resolution: {integrity: sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==} + engines: {node: '>= 18'} + + setprototypeof@1.2.0: + resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==} + + shebang-command@2.0.0: + resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==} + engines: {node: '>=8'} + + shebang-regex@3.0.0: + resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==} + engines: {node: '>=8'} + + shiki@4.4.3: + resolution: {integrity: sha512-Mb/GvXPHBAXdgGIcnfU5L3ldpn1XcxrGkPHwqgRx17/I2XRfqlFKk2vGkHWINn1kdXvzJZeuO3is6I9KLPFm0g==} + engines: {node: '>=20'} + + side-channel-list@1.0.1: + resolution: {integrity: sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==} + engines: {node: '>= 0.4'} + + side-channel-map@1.0.1: + resolution: {integrity: sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==} + engines: {node: '>= 0.4'} + + side-channel-weakmap@1.0.2: + resolution: {integrity: sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==} + engines: {node: '>= 0.4'} + + side-channel@1.1.1: + resolution: {integrity: sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==} + engines: {node: '>= 0.4'} + + siginfo@2.0.0: + resolution: {integrity: sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==} + + signal-exit@4.1.0: + resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==} + engines: {node: '>=14'} + + slice-ansi@7.1.2: + resolution: {integrity: sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w==} + engines: {node: '>=18'} + + slice-ansi@8.0.0: + resolution: {integrity: sha512-stxByr12oeeOyY2BlviTNQlYV5xOj47GirPr4yA1hE9JCtxfQN0+tVbkxwCtYDQWhEKWFHsEK48ORg5jrouCAg==} + engines: {node: '>=20'} + + source-map-js@1.2.1: + resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==} + engines: {node: '>=0.10.0'} + + source-map-support@0.5.21: + resolution: {integrity: sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==} + + source-map@0.6.1: + resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==} + engines: {node: '>=0.10.0'} + + source-map@0.7.6: + resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==} + engines: {node: '>= 12'} + + space-separated-tokens@2.0.2: + resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==} + + sprintf-js@1.0.3: + resolution: {integrity: sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==} + + stackback@0.0.2: + resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==} + + statuses@2.0.2: + resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==} + engines: {node: '>= 0.8'} + + std-env@4.2.0: + resolution: {integrity: sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw==} + + stdin-discarder@0.3.2: + resolution: {integrity: sha512-eCPu1qRxPVkl5605OTWF8Wz40b4Mf45NY5LQmVPQ599knfs5QhASUm9GbJ5BDMDOXgrnh0wyEdvzmL//YMlw0A==} + engines: {node: '>=18'} + + string-width@7.2.0: + resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==} + engines: {node: '>=18'} + + string-width@8.2.2: + resolution: {integrity: sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==} + engines: {node: '>=20'} + + stringify-entities@4.0.4: + resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==} + + strip-ansi@7.2.0: + resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==} + engines: {node: '>=12'} + + strip-bom-string@1.0.0: + resolution: {integrity: sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==} + engines: {node: '>=0.10.0'} + + symbol-tree@3.2.4: + resolution: {integrity: sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==} + + tailwindcss@4.3.3: + resolution: {integrity: sha512-gOhV3P7ufE62QDGg1zVaTgCR+EtPv92k2nIhVcVKcLmxT1sUBsQGhnZj175j+MqRt4zLF7ic+sCYjfhxMxj7YQ==} + + tapable@2.3.3: + resolution: {integrity: sha512-uxc/zpqFg6x7C8vOE7lh6Lbda8eEL9zmVm/PLeTPBRhh1xCgdWaQ+J1CUieGpIfm2HdtsUpRv+HshiasBMcc6A==} + engines: {node: '>=6'} + + tinybench@2.9.0: + resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==} + + tinyexec@1.3.0: + resolution: {integrity: sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==} + engines: {node: '>=18'} + + tinyglobby@0.2.17: + resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==} + engines: {node: '>=12.0.0'} + + tinyrainbow@3.1.1: + resolution: {integrity: sha512-yau8yJdTt989Mm0Bd/236QnzEiPf2xLLTqUZRUJOo/3CB078LSwzei343DgtJVmfJKJE3TMINY1u42SQsP6mXw==} + engines: {node: '>=14.0.0'} + + tldts-core@7.4.10: + resolution: {integrity: sha512-KnQjp53ZekKgm/r3l+u8kJGGzYgrWdP8+Mql7a4vijh2WE0IrZWspQj/TpTxDho/YxO+AnOZnIjQcCD+q6iJsw==} + + tldts@7.4.10: + resolution: {integrity: sha512-GgouD1B+sWwvkaEq8vXC15DjQitxbvs12oIXELpconwm+Tg3zfcEv4jgzq3vtKverDXsg3VI8aRgNL2Nra0Iog==} + hasBin: true + + toidentifier@1.0.1: + resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==} + engines: {node: '>=0.6'} + + tough-cookie@6.0.2: + resolution: {integrity: sha512-exgYmnmL/sJpR3upZfXG5PoatXQii55xAiXGXzY+sROLZ/Y+SLcp9PgJNI9Vz37HpQ74WvDcLT8eqm+kV3FzrA==} + engines: {node: '>=16'} + + tr46@6.0.0: + resolution: {integrity: sha512-bLVMLPtstlZ4iMQHpFHTR7GAGj2jxi8Dg0s2h2MafAE4uSWF98FC/3MomU51iQAMf8/qDUbKWf5GxuvvVcXEhw==} + engines: {node: '>=20'} + + trim-lines@3.0.1: + resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==} + + tslib@2.8.1: + resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==} + + type-is@2.1.0: + resolution: {integrity: sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA==} + engines: {node: '>= 18'} + + typescript@6.0.3: + resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==} + engines: {node: '>=14.17'} + hasBin: true + + undici-types@6.21.0: + resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==} + + undici@7.29.0: + resolution: {integrity: sha512-IDxfleLmmbSskfWSUATiN1nfn2rDuvnMOqb5CWR92iIfojA0Ud+ulOAAEQ57LPr9rWmsreUyf5lwyao+7GNNVw==} + engines: {node: '>=20.18.1'} + + unist-util-is@6.0.1: + resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==} + + unist-util-position@5.0.0: + resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==} + + unist-util-stringify-position@4.0.0: + resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==} + + unist-util-visit-parents@6.0.2: + resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==} + + unist-util-visit@5.1.0: + resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==} + + unpipe@1.0.0: + resolution: {integrity: sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==} + engines: {node: '>= 0.8'} + + update-browserslist-db@1.3.1: + resolution: {integrity: sha512-ZZ61DsRsOnakl74HAmp3oSN4aXUmEWXf+i/yv0h7tIBfICc3VdrFErQKUUKPgu3AMsTUMbcongALEN4l6GSUrQ==} + hasBin: true + peerDependencies: + browserslist: '>= 4.21.0' + + util-deprecate@1.0.2: + resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==} + + validate-npm-package-name@8.0.0: + resolution: {integrity: sha512-SCv6OOV6Xj2/3cXy3dGmADluJTNcL3o7hZAglNPTe+WYuEuvxgJzxPrSDLZhF+CwyQOubqgecjMmTJGMVLWjYQ==} + engines: {node: ^22.22.2 || ^24.15.0 || >=26.0.0} + + vary@1.1.2: + resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==} + engines: {node: '>= 0.8'} + + vfile-message@4.0.3: + resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==} + + vfile@6.0.3: + resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==} + + vite@8.1.5: + resolution: {integrity: sha512-7ULLwsCdYx/nRyrpiEwvqb5TFHrMVZyBt+rg/OAXT7rgj/z+DtTDyKFeLAdDkubDVDKD8jOsndmy7m55XcfUsw==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + '@types/node': ^20.19.0 || >=22.12.0 + '@vitejs/devtools': ^0.3.0 + esbuild: ^0.27.0 || ^0.28.0 + jiti: '>=1.21.0' + less: ^4.0.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 + '@vitejs/devtools': + optional: true + esbuild: + optional: true + jiti: + optional: true + less: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + tsx: + optional: true + yaml: + optional: true + + vitest@4.1.10: + resolution: {integrity: sha512-R9jUTe5S4Qb0HCd4TNqpC7oGcrMssMRGXLW80ubjWsW9VH5GF8y1Y0SFLY9AbqSk6nt0PnOx4H4WNJYZ13GUPw==} + engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0} + hasBin: true + peerDependencies: + '@edge-runtime/vm': '*' + '@opentelemetry/api': ^1.9.0 + '@types/node': ^20.0.0 || ^22.0.0 || >=24.0.0 + '@vitest/browser-playwright': 4.1.10 + '@vitest/browser-preview': 4.1.10 + '@vitest/browser-webdriverio': 4.1.10 + '@vitest/coverage-istanbul': 4.1.10 + '@vitest/coverage-v8': 4.1.10 + '@vitest/ui': 4.1.10 + happy-dom: '*' + jsdom: '*' + vite: ^6.0.0 || ^7.0.0 || ^8.0.0 + peerDependenciesMeta: + '@edge-runtime/vm': + optional: true + '@opentelemetry/api': + optional: true + '@types/node': + optional: true + '@vitest/browser-playwright': + optional: true + '@vitest/browser-preview': + optional: true + '@vitest/browser-webdriverio': + optional: true + '@vitest/coverage-istanbul': + optional: true + '@vitest/coverage-v8': + optional: true + '@vitest/ui': + optional: true + happy-dom: + optional: true + jsdom: + optional: true + + w3c-xmlserializer@5.0.0: + resolution: {integrity: sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==} + engines: {node: '>=18'} + + watchpack@2.5.2: + resolution: {integrity: sha512-6i/00NBjP4yGPs+caKSyRfpTF/8Torsu0MOW3mMzIbhgISFder8i7xbqgHlLMwJrdiN8ndBV3UA1/AfzPSr+jg==} + engines: {node: '>=10.13.0'} + + weak-lru-cache@1.2.2: + resolution: {integrity: sha512-DEAoo25RfSYMuTGc9vPJzZcZullwIqRDSI9LOy+fkCJPi6hykCnfKaXTuPBDuXAUcqHXyOgFtHNp/kB2FjYHbw==} + + webidl-conversions@8.0.1: + resolution: {integrity: sha512-BMhLD/Sw+GbJC21C/UgyaZX41nPt8bUTg+jWyDeg7e7YN4xOM05YPSIXceACnXVtqyEw/LMClUQMtMZ+PGGpqQ==} + engines: {node: '>=20'} + + whatwg-mimetype@5.0.0: + resolution: {integrity: sha512-sXcNcHOC51uPGF0P/D4NVtrkjSU2fNsm9iog4ZvZJsL3rjoDAzXZhkm2MWt1y+PUdggKAYVoMAIYcs78wJ51Cw==} + engines: {node: '>=20'} + + whatwg-url@16.0.1: + resolution: {integrity: sha512-1to4zXBxmXHV3IiSSEInrreIlu02vUOvrhxJJH5vcxYTBDAx51cqZiKdyTxlecdKNSjj8EcxGBxNf6Vg+945gw==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + which@2.0.2: + resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==} + engines: {node: '>= 8'} + hasBin: true + + why-is-node-running@2.3.0: + resolution: {integrity: sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==} + engines: {node: '>=8'} + hasBin: true + + wrap-ansi@10.0.0: + resolution: {integrity: sha512-SGcvg80f0wUy2/fXES19feHMz8E0JoXv2uNgHOu4Dgi2OrCy1lqwFYEJz1BLbDI0exjPMe/ZdzZ/YpGECBG/aQ==} + engines: {node: '>=20'} + + wrap-ansi@9.0.2: + resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==} + engines: {node: '>=18'} + + wrappy@1.0.2: + resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==} + + xhr2@0.2.1: + resolution: {integrity: sha512-sID0rrVCqkVNUn8t6xuv9+6FViXjUVXq8H5rWOH2rz9fDNQEd4g0EA2XlcEdJXRz5BMEn4O1pJFdT+z4YHhoWw==} + engines: {node: '>= 6'} + + xml-name-validator@5.0.0: + resolution: {integrity: sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==} + engines: {node: '>=18'} + + xmlchars@2.2.0: + resolution: {integrity: sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==} + + y18n@5.0.8: + resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==} + engines: {node: '>=10'} + + yargs-parser@22.0.0: + resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==} + engines: {node: ^20.19.0 || ^22.12.0 || >=23} + + yargs@18.1.0: + resolution: {integrity: sha512-2rAgRKu54VsHkqI0/tYkmluGXHD4KW7yZoycuqDQ15QOTnc2VVfy0nN/1eMhnQLO00A+dwtK20xuCnc1YGeUyg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=23} + + yoctocolors@2.2.0: + resolution: {integrity: sha512-xYqdZFUK/VYazNl/oCDYN+3WloWQwMfZxBoiNt6qNyk+xfOdi598muWE42rNZFp1kNOiqW936q5RhUdnpqElSg==} + engines: {node: '>=18'} + + zod-to-json-schema@3.25.2: + resolution: {integrity: sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA==} + peerDependencies: + zod: ^3.25.28 || ^4 + + zod@4.4.3: + resolution: {integrity: sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==} + + zwitch@2.0.4: + resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==} + +snapshots: + + '@acemir/cssom@0.9.31': {} + + '@alloc/quick-lru@5.2.0': {} + + '@ampproject/remapping@2.3.0': + dependencies: + '@jridgewell/gen-mapping': 0.3.13 + '@jridgewell/trace-mapping': 0.3.31 + + '@angular-devkit/architect@0.2201.4(chokidar@5.0.0)': + dependencies: + '@angular-devkit/core': 22.1.4(chokidar@5.0.0) + rxjs: 7.8.2 + transitivePeerDependencies: + - chokidar + + '@angular-devkit/core@22.1.4(chokidar@5.0.0)': + dependencies: + ajv: 8.20.0 + ajv-formats: 3.0.1(ajv@8.20.0) + jsonc-parser: 3.3.1 + picomatch: 4.0.5 + rxjs: 7.8.2 + source-map: 0.7.6 + optionalDependencies: + chokidar: 5.0.0 + + '@angular-devkit/schematics@22.1.4(chokidar@5.0.0)': + dependencies: + '@angular-devkit/core': 22.1.4(chokidar@5.0.0) + jsonc-parser: 3.3.1 + magic-string: 1.0.0 + ora: 9.4.1 + rxjs: 7.8.2 + transitivePeerDependencies: + - chokidar + + '@angular/build@22.1.4(7294df6f0b8344c299db30de3d3b64fb)': + dependencies: + '@ampproject/remapping': 2.3.0 + '@angular-devkit/architect': 0.2201.4(chokidar@5.0.0) + '@angular/compiler': 22.1.2 + '@angular/compiler-cli': 22.1.2(@angular/compiler@22.1.2)(typescript@6.0.3) + '@babel/core': 8.0.1 + '@babel/helper-annotate-as-pure': 8.0.0 + '@babel/helper-split-export-declaration': 7.24.7 + '@inquirer/confirm': 6.1.1(@types/node@20.19.43) + '@vitejs/plugin-basic-ssl': 2.3.0(vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0)) + beasties: 0.4.3 + browserslist: 4.28.8 + esbuild: 0.28.2 + https-proxy-agent: 9.1.0 + jsonc-parser: 3.3.1 + listr2: 10.2.2 + magic-string: 1.0.0 + mrmime: 2.0.1 + oxc-parser: 0.142.0 + parse5-html-rewriting-stream: 8.0.1 + picomatch: 4.0.5 + piscina: 5.2.0 + rolldown: 1.2.0 + sass: 1.101.0 + semver: 7.8.5 + source-map-support: 0.5.21 + tinyglobby: 0.2.17 + tslib: 2.8.1 + typescript: 6.0.3 + vite: 8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0) + watchpack: 2.5.2 + optionalDependencies: + '@angular/core': 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + '@angular/platform-browser': 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)) + '@angular/platform-server': 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/compiler@22.1.2)(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2) + '@angular/ssr': 22.1.4(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-server@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/compiler@22.1.2)(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2))(@angular/router@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2)) + lmdb: 3.5.6 + postcss: 8.5.26 + tailwindcss: 4.3.3 + vitest: 4.1.10(@types/node@20.19.43)(jsdom@28.1.0)(vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0)) + transitivePeerDependencies: + - '@types/node' + - '@vitejs/devtools' + - chokidar + - jiti + - kerberos + - sass-embedded + - stylus + - sugarss + - supports-color + - terser + - tsx + - yaml + + '@angular/cli@22.1.4(@types/node@20.19.43)(chokidar@5.0.0)': + dependencies: + '@angular-devkit/architect': 0.2201.4(chokidar@5.0.0) + '@angular-devkit/core': 22.1.4(chokidar@5.0.0) + '@angular-devkit/schematics': 22.1.4(chokidar@5.0.0) + '@inquirer/prompts': 8.5.2(@types/node@20.19.43) + '@listr2/prompt-adapter-inquirer': 4.2.4(@inquirer/prompts@8.5.2(@types/node@20.19.43))(@types/node@20.19.43)(listr2@10.2.2) + '@modelcontextprotocol/sdk': 1.30.0(zod@4.4.3) + '@schematics/angular': 22.1.4(chokidar@5.0.0) + jsonc-parser: 3.3.1 + listr2: 10.2.2 + npm-package-arg: 14.0.0 + parse5-html-rewriting-stream: 8.0.1 + semver: 7.8.5 + yargs: 18.1.0 + zod: 4.4.3 + transitivePeerDependencies: + - '@cfworker/json-schema' + - '@types/node' + - chokidar + - supports-color + + '@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2)': + dependencies: + '@angular/core': 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + rxjs: 7.8.2 + tslib: 2.8.1 + + '@angular/compiler-cli@22.1.2(@angular/compiler@22.1.2)(typescript@6.0.3)': + dependencies: + '@angular/compiler': 22.1.2 + '@babel/core': 8.0.1 + '@jridgewell/sourcemap-codec': 1.5.5 + chokidar: 5.0.0 + convert-source-map: 1.9.0 + reflect-metadata: 0.2.2 + semver: 7.8.5 + tslib: 2.8.1 + yargs: 18.1.0 + optionalDependencies: + typescript: 6.0.3 + + '@angular/compiler@22.1.2': + dependencies: + tslib: 2.8.1 + + '@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)': + dependencies: + rxjs: 7.8.2 + tslib: 2.8.1 + optionalDependencies: + '@angular/compiler': 22.1.2 + + '@angular/forms@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2)': + dependencies: + '@angular/common': 22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2) + '@angular/core': 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + '@angular/platform-browser': 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)) + '@standard-schema/spec': 1.1.0 + rxjs: 7.8.2 + tslib: 2.8.1 + zod: 4.4.3 + + '@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))': + dependencies: + '@angular/common': 22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2) + '@angular/core': 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + tslib: 2.8.1 + + '@angular/platform-server@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/compiler@22.1.2)(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2)': + dependencies: + '@angular/common': 22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2) + '@angular/compiler': 22.1.2 + '@angular/core': 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + '@angular/platform-browser': 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)) + rxjs: 7.8.2 + tslib: 2.8.1 + xhr2: 0.2.1 + + '@angular/router@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2)': + dependencies: + '@angular/common': 22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2) + '@angular/core': 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + '@angular/platform-browser': 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)) + rxjs: 7.8.2 + tslib: 2.8.1 + + '@angular/ssr@22.1.4(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-server@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/compiler@22.1.2)(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2))(@angular/router@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2))': + dependencies: + '@angular/common': 22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2) + '@angular/core': 22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2) + '@angular/router': 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2) + tslib: 2.8.1 + optionalDependencies: + '@angular/platform-server': 22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/compiler@22.1.2)(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(@angular/platform-browser@22.1.2(@angular/common@22.1.2(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2))(rxjs@7.8.2))(@angular/core@22.1.2(@angular/compiler@22.1.2)(rxjs@7.8.2)))(rxjs@7.8.2) + + '@asamuzakjp/css-color@5.1.11': + dependencies: + '@asamuzakjp/generational-cache': 1.0.1 + '@csstools/css-calc': 3.3.0(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) + '@csstools/css-color-parser': 4.1.10(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) + '@csstools/css-parser-algorithms': 4.0.0(@csstools/css-tokenizer@4.0.0) + '@csstools/css-tokenizer': 4.0.0 + + '@asamuzakjp/dom-selector@6.8.1': + dependencies: + '@asamuzakjp/nwsapi': 2.3.9 + bidi-js: 1.0.3 + css-tree: 3.2.1 + is-potential-custom-element-name: 1.0.1 + lru-cache: 11.5.2 + + '@asamuzakjp/generational-cache@1.0.1': {} + + '@asamuzakjp/nwsapi@2.3.9': {} + + '@babel/code-frame@8.0.0': + dependencies: + '@babel/helper-validator-identifier': 8.0.4 + js-tokens: 10.0.0 + + '@babel/compat-data@8.0.0': {} + + '@babel/core@8.0.1': + dependencies: + '@babel/code-frame': 8.0.0 + '@babel/generator': 8.0.0 + '@babel/helper-compilation-targets': 8.0.0 + '@babel/helpers': 8.0.0 + '@babel/parser': 8.0.4 + '@babel/template': 8.0.0 + '@babel/traverse': 8.0.4 + '@babel/types': 8.0.4 + '@types/gensync': 1.0.5 + convert-source-map: 2.0.0 + empathic: 2.0.1 + gensync: 1.0.0-beta.2 + import-meta-resolve: 4.2.0 + json5: 2.2.3 + obug: 2.1.4 + semver: 7.8.5 + + '@babel/generator@8.0.0': + dependencies: + '@babel/parser': 8.0.4 + '@babel/types': 8.0.4 + '@jridgewell/gen-mapping': 0.3.13 + '@jridgewell/trace-mapping': 0.3.31 + '@types/jsesc': 2.5.1 + jsesc: 3.1.0 + + '@babel/helper-annotate-as-pure@8.0.0': + dependencies: + '@babel/types': 8.0.4 + + '@babel/helper-compilation-targets@8.0.0': + dependencies: + '@babel/compat-data': 8.0.0 + '@babel/helper-validator-option': 8.0.0 + browserslist: 4.28.8 + lru-cache: 11.5.2 + semver: 7.8.5 + + '@babel/helper-globals@8.0.0': {} + + '@babel/helper-split-export-declaration@7.24.7': + dependencies: + '@babel/types': 7.29.8 + + '@babel/helper-string-parser@7.29.7': {} + + '@babel/helper-string-parser@8.0.0': {} + + '@babel/helper-validator-identifier@7.29.7': {} + + '@babel/helper-validator-identifier@8.0.4': {} + + '@babel/helper-validator-option@8.0.0': {} + + '@babel/helpers@8.0.0': + dependencies: + '@babel/template': 8.0.0 + '@babel/types': 8.0.4 + + '@babel/parser@8.0.4': + dependencies: + '@babel/types': 8.0.4 + + '@babel/template@8.0.0': + dependencies: + '@babel/code-frame': 8.0.0 + '@babel/parser': 8.0.4 + '@babel/types': 8.0.4 + + '@babel/traverse@8.0.4': + dependencies: + '@babel/code-frame': 8.0.0 + '@babel/generator': 8.0.0 + '@babel/helper-globals': 8.0.0 + '@babel/parser': 8.0.4 + '@babel/template': 8.0.0 + '@babel/types': 8.0.4 + obug: 2.1.4 + + '@babel/types@7.29.8': + dependencies: + '@babel/helper-string-parser': 7.29.7 + '@babel/helper-validator-identifier': 7.29.7 + + '@babel/types@8.0.4': + dependencies: + '@babel/helper-string-parser': 8.0.0 + '@babel/helper-validator-identifier': 8.0.4 + + '@bramus/specificity@2.4.2': + dependencies: + css-tree: 3.2.1 + + '@csstools/color-helpers@6.1.0': {} + + '@csstools/css-calc@3.3.0(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0)': + dependencies: + '@csstools/css-parser-algorithms': 4.0.0(@csstools/css-tokenizer@4.0.0) + '@csstools/css-tokenizer': 4.0.0 + + '@csstools/css-color-parser@4.1.10(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0)': + dependencies: + '@csstools/color-helpers': 6.1.0 + '@csstools/css-calc': 3.3.0(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) + '@csstools/css-parser-algorithms': 4.0.0(@csstools/css-tokenizer@4.0.0) + '@csstools/css-tokenizer': 4.0.0 + + '@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0)': + dependencies: + '@csstools/css-tokenizer': 4.0.0 + + '@csstools/css-syntax-patches-for-csstree@1.1.7(css-tree@3.2.1)': + optionalDependencies: + css-tree: 3.2.1 + + '@csstools/css-tokenizer@4.0.0': {} + + '@emnapi/core@1.11.1': + dependencies: + '@emnapi/wasi-threads': 1.2.2 + tslib: 2.8.1 + optional: true + + '@emnapi/core@1.11.2': + dependencies: + '@emnapi/wasi-threads': 1.2.2 + tslib: 2.8.1 + optional: true + + '@emnapi/runtime@1.11.1': + dependencies: + tslib: 2.8.1 + optional: true + + '@emnapi/runtime@1.11.2': + dependencies: + tslib: 2.8.1 + optional: true + + '@emnapi/wasi-threads@1.2.2': + dependencies: + tslib: 2.8.1 + optional: true + + '@esbuild/aix-ppc64@0.28.2': + optional: true + + '@esbuild/android-arm64@0.28.2': + optional: true + + '@esbuild/android-arm@0.28.2': + optional: true + + '@esbuild/android-x64@0.28.2': + optional: true + + '@esbuild/darwin-arm64@0.28.2': + optional: true + + '@esbuild/darwin-x64@0.28.2': + optional: true + + '@esbuild/freebsd-arm64@0.28.2': + optional: true + + '@esbuild/freebsd-x64@0.28.2': + optional: true + + '@esbuild/linux-arm64@0.28.2': + optional: true + + '@esbuild/linux-arm@0.28.2': + optional: true + + '@esbuild/linux-ia32@0.28.2': + optional: true + + '@esbuild/linux-loong64@0.28.2': + optional: true + + '@esbuild/linux-mips64el@0.28.2': + optional: true + + '@esbuild/linux-ppc64@0.28.2': + optional: true + + '@esbuild/linux-riscv64@0.28.2': + optional: true + + '@esbuild/linux-s390x@0.28.2': + optional: true + + '@esbuild/linux-x64@0.28.2': + optional: true + + '@esbuild/netbsd-arm64@0.28.2': + optional: true + + '@esbuild/netbsd-x64@0.28.2': + optional: true + + '@esbuild/openbsd-arm64@0.28.2': + optional: true + + '@esbuild/openbsd-x64@0.28.2': + optional: true + + '@esbuild/openharmony-arm64@0.28.2': + optional: true + + '@esbuild/sunos-x64@0.28.2': + optional: true + + '@esbuild/win32-arm64@0.28.2': + optional: true + + '@esbuild/win32-ia32@0.28.2': + optional: true + + '@esbuild/win32-x64@0.28.2': + optional: true + + '@exodus/bytes@1.15.1': {} + + '@harperfast/extended-iterable@1.0.3': + optional: true + + '@hono/node-server@2.1.1(hono@4.13.2)': + dependencies: + hono: 4.13.2 + + '@inquirer/ansi@2.0.7': {} + + '@inquirer/checkbox@5.2.1(@types/node@20.19.43)': + dependencies: + '@inquirer/ansi': 2.0.7 + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/figures': 2.0.7 + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/confirm@6.1.1(@types/node@20.19.43)': + dependencies: + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/core@11.2.1(@types/node@20.19.43)': + dependencies: + '@inquirer/ansi': 2.0.7 + '@inquirer/figures': 2.0.7 + '@inquirer/type': 4.0.7(@types/node@20.19.43) + cli-width: 4.1.0 + fast-wrap-ansi: 0.2.2 + mute-stream: 3.0.0 + signal-exit: 4.1.0 + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/editor@5.2.2(@types/node@20.19.43)': + dependencies: + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/external-editor': 3.0.3(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/expand@5.1.1(@types/node@20.19.43)': + dependencies: + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/external-editor@3.0.3(@types/node@20.19.43)': + dependencies: + chardet: 2.2.0 + iconv-lite: 0.7.3 + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/figures@2.0.7': {} + + '@inquirer/input@5.1.2(@types/node@20.19.43)': + dependencies: + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/number@4.1.1(@types/node@20.19.43)': + dependencies: + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/password@5.1.1(@types/node@20.19.43)': + dependencies: + '@inquirer/ansi': 2.0.7 + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/prompts@8.5.2(@types/node@20.19.43)': + dependencies: + '@inquirer/checkbox': 5.2.1(@types/node@20.19.43) + '@inquirer/confirm': 6.1.1(@types/node@20.19.43) + '@inquirer/editor': 5.2.2(@types/node@20.19.43) + '@inquirer/expand': 5.1.1(@types/node@20.19.43) + '@inquirer/input': 5.1.2(@types/node@20.19.43) + '@inquirer/number': 4.1.1(@types/node@20.19.43) + '@inquirer/password': 5.1.1(@types/node@20.19.43) + '@inquirer/rawlist': 5.3.1(@types/node@20.19.43) + '@inquirer/search': 4.2.1(@types/node@20.19.43) + '@inquirer/select': 5.2.1(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/rawlist@5.3.1(@types/node@20.19.43)': + dependencies: + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/search@4.2.1(@types/node@20.19.43)': + dependencies: + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/figures': 2.0.7 + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/select@5.2.1(@types/node@20.19.43)': + dependencies: + '@inquirer/ansi': 2.0.7 + '@inquirer/core': 11.2.1(@types/node@20.19.43) + '@inquirer/figures': 2.0.7 + '@inquirer/type': 4.0.7(@types/node@20.19.43) + optionalDependencies: + '@types/node': 20.19.43 + + '@inquirer/type@4.0.7(@types/node@20.19.43)': + optionalDependencies: + '@types/node': 20.19.43 + + '@jridgewell/gen-mapping@0.3.13': + dependencies: + '@jridgewell/sourcemap-codec': 1.5.5 + '@jridgewell/trace-mapping': 0.3.31 + + '@jridgewell/remapping@2.3.5': + dependencies: + '@jridgewell/gen-mapping': 0.3.13 + '@jridgewell/trace-mapping': 0.3.31 + + '@jridgewell/resolve-uri@3.1.2': {} + + '@jridgewell/sourcemap-codec@1.5.5': {} + + '@jridgewell/trace-mapping@0.3.31': + dependencies: + '@jridgewell/resolve-uri': 3.1.2 + '@jridgewell/sourcemap-codec': 1.5.5 + + '@listr2/prompt-adapter-inquirer@4.2.4(@inquirer/prompts@8.5.2(@types/node@20.19.43))(@types/node@20.19.43)(listr2@10.2.2)': + dependencies: + '@inquirer/prompts': 8.5.2(@types/node@20.19.43) + '@inquirer/type': 4.0.7(@types/node@20.19.43) + listr2: 10.2.2 + transitivePeerDependencies: + - '@types/node' + + '@lmdb/lmdb-darwin-arm64@3.5.6': + optional: true + + '@lmdb/lmdb-darwin-x64@3.5.6': + optional: true + + '@lmdb/lmdb-linux-arm64@3.5.6': + optional: true + + '@lmdb/lmdb-linux-arm@3.5.6': + optional: true + + '@lmdb/lmdb-linux-x64@3.5.6': + optional: true + + '@lmdb/lmdb-win32-arm64@3.5.6': + optional: true + + '@lmdb/lmdb-win32-x64@3.5.6': + optional: true + + '@modelcontextprotocol/sdk@1.30.0(zod@4.4.3)': + dependencies: + '@hono/node-server': 2.1.1(hono@4.13.2) + ajv: 8.20.0 + ajv-formats: 3.0.1(ajv@8.20.0) + content-type: 1.0.5 + cors: 2.8.6 + cross-spawn: 7.0.6 + eventsource: 3.0.7 + eventsource-parser: 3.1.1 + express: 5.2.1 + express-rate-limit: 8.6.2(express@5.2.1) + hono: 4.13.2 + jose: 6.2.8 + json-schema-typed: 8.0.2 + pkce-challenge: 5.0.1 + raw-body: 3.0.2 + zod: 4.4.3 + zod-to-json-schema: 3.25.2(zod@4.4.3) + transitivePeerDependencies: + - supports-color + + '@msgpackr-extract/msgpackr-extract-darwin-arm64@3.0.4': + optional: true + + '@msgpackr-extract/msgpackr-extract-darwin-x64@3.0.4': + optional: true + + '@msgpackr-extract/msgpackr-extract-linux-arm64@3.0.4': + optional: true + + '@msgpackr-extract/msgpackr-extract-linux-arm@3.0.4': + optional: true + + '@msgpackr-extract/msgpackr-extract-linux-x64@3.0.4': + optional: true + + '@msgpackr-extract/msgpackr-extract-win32-x64@3.0.4': + optional: true + + '@napi-rs/nice-android-arm-eabi@1.1.1': + optional: true + + '@napi-rs/nice-android-arm64@1.1.1': + optional: true + + '@napi-rs/nice-darwin-arm64@1.1.1': + optional: true + + '@napi-rs/nice-darwin-x64@1.1.1': + optional: true + + '@napi-rs/nice-freebsd-x64@1.1.1': + optional: true + + '@napi-rs/nice-linux-arm-gnueabihf@1.1.1': + optional: true + + '@napi-rs/nice-linux-arm64-gnu@1.1.1': + optional: true + + '@napi-rs/nice-linux-arm64-musl@1.1.1': + optional: true + + '@napi-rs/nice-linux-ppc64-gnu@1.1.1': + optional: true + + '@napi-rs/nice-linux-riscv64-gnu@1.1.1': + optional: true + + '@napi-rs/nice-linux-s390x-gnu@1.1.1': + optional: true + + '@napi-rs/nice-linux-x64-gnu@1.1.1': + optional: true + + '@napi-rs/nice-linux-x64-musl@1.1.1': + optional: true + + '@napi-rs/nice-openharmony-arm64@1.1.1': + optional: true + + '@napi-rs/nice-win32-arm64-msvc@1.1.1': + optional: true + + '@napi-rs/nice-win32-ia32-msvc@1.1.1': + optional: true + + '@napi-rs/nice-win32-x64-msvc@1.1.1': + optional: true + + '@napi-rs/nice@1.1.1': + optionalDependencies: + '@napi-rs/nice-android-arm-eabi': 1.1.1 + '@napi-rs/nice-android-arm64': 1.1.1 + '@napi-rs/nice-darwin-arm64': 1.1.1 + '@napi-rs/nice-darwin-x64': 1.1.1 + '@napi-rs/nice-freebsd-x64': 1.1.1 + '@napi-rs/nice-linux-arm-gnueabihf': 1.1.1 + '@napi-rs/nice-linux-arm64-gnu': 1.1.1 + '@napi-rs/nice-linux-arm64-musl': 1.1.1 + '@napi-rs/nice-linux-ppc64-gnu': 1.1.1 + '@napi-rs/nice-linux-riscv64-gnu': 1.1.1 + '@napi-rs/nice-linux-s390x-gnu': 1.1.1 + '@napi-rs/nice-linux-x64-gnu': 1.1.1 + '@napi-rs/nice-linux-x64-musl': 1.1.1 + '@napi-rs/nice-openharmony-arm64': 1.1.1 + '@napi-rs/nice-win32-arm64-msvc': 1.1.1 + '@napi-rs/nice-win32-ia32-msvc': 1.1.1 + '@napi-rs/nice-win32-x64-msvc': 1.1.1 + optional: true + + '@napi-rs/wasm-runtime@1.2.3(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)': + dependencies: + '@emnapi/core': 1.11.1 + '@emnapi/runtime': 1.11.1 + '@tybys/wasm-util': 0.10.3 + optional: true + + '@napi-rs/wasm-runtime@1.2.3(@emnapi/core@1.11.2)(@emnapi/runtime@1.11.2)': + dependencies: + '@emnapi/core': 1.11.2 + '@emnapi/runtime': 1.11.2 + '@tybys/wasm-util': 0.10.3 + optional: true + + '@oxc-parser/binding-android-arm-eabi@0.142.0': + optional: true + + '@oxc-parser/binding-android-arm64@0.142.0': + optional: true + + '@oxc-parser/binding-darwin-arm64@0.142.0': + optional: true + + '@oxc-parser/binding-darwin-x64@0.142.0': + optional: true + + '@oxc-parser/binding-freebsd-x64@0.142.0': + optional: true + + '@oxc-parser/binding-linux-arm-gnueabihf@0.142.0': + optional: true + + '@oxc-parser/binding-linux-arm-musleabihf@0.142.0': + optional: true + + '@oxc-parser/binding-linux-arm64-gnu@0.142.0': + optional: true + + '@oxc-parser/binding-linux-arm64-musl@0.142.0': + optional: true + + '@oxc-parser/binding-linux-ppc64-gnu@0.142.0': + optional: true + + '@oxc-parser/binding-linux-riscv64-gnu@0.142.0': + optional: true + + '@oxc-parser/binding-linux-riscv64-musl@0.142.0': + optional: true + + '@oxc-parser/binding-linux-s390x-gnu@0.142.0': + optional: true + + '@oxc-parser/binding-linux-x64-gnu@0.142.0': + optional: true + + '@oxc-parser/binding-linux-x64-musl@0.142.0': + optional: true + + '@oxc-parser/binding-openharmony-arm64@0.142.0': + optional: true + + '@oxc-parser/binding-wasm32-wasi@0.142.0': + dependencies: + '@emnapi/core': 1.11.2 + '@emnapi/runtime': 1.11.2 + '@napi-rs/wasm-runtime': 1.2.3(@emnapi/core@1.11.2)(@emnapi/runtime@1.11.2) + optional: true + + '@oxc-parser/binding-win32-arm64-msvc@0.142.0': + optional: true + + '@oxc-parser/binding-win32-ia32-msvc@0.142.0': + optional: true + + '@oxc-parser/binding-win32-x64-msvc@0.142.0': + optional: true + + '@oxc-project/types@0.139.0': {} + + '@oxc-project/types@0.140.0': {} + + '@oxc-project/types@0.142.0': {} + + '@parcel/watcher-android-arm64@2.6.0': + optional: true + + '@parcel/watcher-darwin-arm64@2.6.0': + optional: true + + '@parcel/watcher-darwin-x64@2.6.0': + optional: true + + '@parcel/watcher-freebsd-x64@2.6.0': + optional: true + + '@parcel/watcher-linux-arm-glibc@2.6.0': + optional: true + + '@parcel/watcher-linux-arm-musl@2.6.0': + optional: true + + '@parcel/watcher-linux-arm64-glibc@2.6.0': + optional: true + + '@parcel/watcher-linux-arm64-musl@2.6.0': + optional: true + + '@parcel/watcher-linux-x64-glibc@2.6.0': + optional: true + + '@parcel/watcher-linux-x64-musl@2.6.0': + optional: true + + '@parcel/watcher-win32-arm64@2.6.0': + optional: true + + '@parcel/watcher-win32-x64@2.6.0': + optional: true + + '@parcel/watcher@2.6.0': + dependencies: + detect-libc: 2.1.2 + is-glob: 4.0.3 + node-addon-api: 7.1.1 + picomatch: 4.0.5 + optionalDependencies: + '@parcel/watcher-android-arm64': 2.6.0 + '@parcel/watcher-darwin-arm64': 2.6.0 + '@parcel/watcher-darwin-x64': 2.6.0 + '@parcel/watcher-freebsd-x64': 2.6.0 + '@parcel/watcher-linux-arm-glibc': 2.6.0 + '@parcel/watcher-linux-arm-musl': 2.6.0 + '@parcel/watcher-linux-arm64-glibc': 2.6.0 + '@parcel/watcher-linux-arm64-musl': 2.6.0 + '@parcel/watcher-linux-x64-glibc': 2.6.0 + '@parcel/watcher-linux-x64-musl': 2.6.0 + '@parcel/watcher-win32-arm64': 2.6.0 + '@parcel/watcher-win32-x64': 2.6.0 + optional: true + + '@rolldown/binding-android-arm64@1.1.5': + optional: true + + '@rolldown/binding-android-arm64@1.2.0': + optional: true + + '@rolldown/binding-darwin-arm64@1.1.5': + optional: true + + '@rolldown/binding-darwin-arm64@1.2.0': + optional: true + + '@rolldown/binding-darwin-x64@1.1.5': + optional: true + + '@rolldown/binding-darwin-x64@1.2.0': + optional: true + + '@rolldown/binding-freebsd-x64@1.1.5': + optional: true + + '@rolldown/binding-freebsd-x64@1.2.0': + optional: true + + '@rolldown/binding-linux-arm-gnueabihf@1.1.5': + optional: true + + '@rolldown/binding-linux-arm-gnueabihf@1.2.0': + optional: true + + '@rolldown/binding-linux-arm64-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-arm64-gnu@1.2.0': + optional: true + + '@rolldown/binding-linux-arm64-musl@1.1.5': + optional: true + + '@rolldown/binding-linux-arm64-musl@1.2.0': + optional: true + + '@rolldown/binding-linux-ppc64-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-ppc64-gnu@1.2.0': + optional: true + + '@rolldown/binding-linux-s390x-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-s390x-gnu@1.2.0': + optional: true + + '@rolldown/binding-linux-x64-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-x64-gnu@1.2.0': + optional: true + + '@rolldown/binding-linux-x64-musl@1.1.5': + optional: true + + '@rolldown/binding-linux-x64-musl@1.2.0': + optional: true + + '@rolldown/binding-openharmony-arm64@1.1.5': + optional: true + + '@rolldown/binding-openharmony-arm64@1.2.0': + optional: true + + '@rolldown/binding-wasm32-wasi@1.1.5': + dependencies: + '@emnapi/core': 1.11.1 + '@emnapi/runtime': 1.11.1 + '@napi-rs/wasm-runtime': 1.2.3(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1) + optional: true + + '@rolldown/binding-wasm32-wasi@1.2.0': + dependencies: + '@emnapi/core': 1.11.2 + '@emnapi/runtime': 1.11.2 + '@napi-rs/wasm-runtime': 1.2.3(@emnapi/core@1.11.2)(@emnapi/runtime@1.11.2) + optional: true + + '@rolldown/binding-win32-arm64-msvc@1.1.5': + optional: true + + '@rolldown/binding-win32-arm64-msvc@1.2.0': + optional: true + + '@rolldown/binding-win32-x64-msvc@1.1.5': + optional: true + + '@rolldown/binding-win32-x64-msvc@1.2.0': + optional: true + + '@rolldown/pluginutils@1.0.1': {} + + '@schematics/angular@22.1.4(chokidar@5.0.0)': + dependencies: + '@angular-devkit/core': 22.1.4(chokidar@5.0.0) + '@angular-devkit/schematics': 22.1.4(chokidar@5.0.0) + jsonc-parser: 3.3.1 + typescript: 6.0.3 + transitivePeerDependencies: + - chokidar + + '@shikijs/core@4.4.3': + dependencies: + '@shikijs/primitive': 4.4.3 + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + hast-util-to-html: 9.0.5 + + '@shikijs/engine-javascript@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + oniguruma-to-es: 4.3.6 + + '@shikijs/engine-oniguruma@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + + '@shikijs/langs@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + + '@shikijs/primitive@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + + '@shikijs/themes@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + + '@shikijs/types@4.4.3': + dependencies: + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + + '@shikijs/vscode-textmate@10.0.2': {} + + '@standard-schema/spec@1.1.0': {} + + '@tailwindcss/node@4.3.3': + dependencies: + '@jridgewell/remapping': 2.3.5 + enhanced-resolve: 5.24.5 + jiti: 2.7.0 + lightningcss: 1.32.0 + magic-string: 0.30.21 + source-map-js: 1.2.1 + tailwindcss: 4.3.3 + + '@tailwindcss/oxide-android-arm64@4.3.3': + optional: true + + '@tailwindcss/oxide-darwin-arm64@4.3.3': + optional: true + + '@tailwindcss/oxide-darwin-x64@4.3.3': + optional: true + + '@tailwindcss/oxide-freebsd-x64@4.3.3': + optional: true + + '@tailwindcss/oxide-linux-arm-gnueabihf@4.3.3': + optional: true + + '@tailwindcss/oxide-linux-arm64-gnu@4.3.3': + optional: true + + '@tailwindcss/oxide-linux-arm64-musl@4.3.3': + optional: true + + '@tailwindcss/oxide-linux-x64-gnu@4.3.3': + optional: true + + '@tailwindcss/oxide-linux-x64-musl@4.3.3': + optional: true + + '@tailwindcss/oxide-wasm32-wasi@4.3.3': + optional: true + + '@tailwindcss/oxide-win32-arm64-msvc@4.3.3': + optional: true + + '@tailwindcss/oxide-win32-x64-msvc@4.3.3': + optional: true + + '@tailwindcss/oxide@4.3.3': + optionalDependencies: + '@tailwindcss/oxide-android-arm64': 4.3.3 + '@tailwindcss/oxide-darwin-arm64': 4.3.3 + '@tailwindcss/oxide-darwin-x64': 4.3.3 + '@tailwindcss/oxide-freebsd-x64': 4.3.3 + '@tailwindcss/oxide-linux-arm-gnueabihf': 4.3.3 + '@tailwindcss/oxide-linux-arm64-gnu': 4.3.3 + '@tailwindcss/oxide-linux-arm64-musl': 4.3.3 + '@tailwindcss/oxide-linux-x64-gnu': 4.3.3 + '@tailwindcss/oxide-linux-x64-musl': 4.3.3 + '@tailwindcss/oxide-wasm32-wasi': 4.3.3 + '@tailwindcss/oxide-win32-arm64-msvc': 4.3.3 + '@tailwindcss/oxide-win32-x64-msvc': 4.3.3 + + '@tailwindcss/postcss@4.3.3': + dependencies: + '@alloc/quick-lru': 5.2.0 + '@tailwindcss/node': 4.3.3 + '@tailwindcss/oxide': 4.3.3 + postcss: 8.5.26 + tailwindcss: 4.3.3 + + '@tailwindcss/typography@0.5.20(tailwindcss@4.3.3)': + dependencies: + postcss-selector-parser: 6.0.10 + tailwindcss: 4.3.3 + + '@tybys/wasm-util@0.10.3': + dependencies: + tslib: 2.8.1 + optional: true + + '@types/body-parser@1.19.6': + dependencies: + '@types/connect': 3.4.38 + '@types/node': 20.19.43 + + '@types/chai@5.2.3': + dependencies: + '@types/deep-eql': 4.0.2 + assertion-error: 2.0.1 + + '@types/connect@3.4.38': + dependencies: + '@types/node': 20.19.43 + + '@types/deep-eql@4.0.2': {} + + '@types/estree@1.0.9': {} + + '@types/express-serve-static-core@5.1.3': + dependencies: + '@types/node': 20.19.43 + '@types/qs': 6.15.1 + '@types/range-parser': 1.2.7 + '@types/send': 1.2.1 + + '@types/express@5.0.6': + dependencies: + '@types/body-parser': 1.19.6 + '@types/express-serve-static-core': 5.1.3 + '@types/serve-static': 2.2.0 + + '@types/gensync@1.0.5': {} + + '@types/hast@3.0.5': + dependencies: + '@types/unist': 3.0.3 + + '@types/http-errors@2.0.5': {} + + '@types/jsesc@2.5.1': {} + + '@types/mdast@4.0.4': + dependencies: + '@types/unist': 3.0.3 + + '@types/node@20.19.43': + dependencies: + undici-types: 6.21.0 + + '@types/qs@6.15.1': {} + + '@types/range-parser@1.2.7': {} + + '@types/send@1.2.1': + dependencies: + '@types/node': 20.19.43 + + '@types/serve-static@2.2.0': + dependencies: + '@types/http-errors': 2.0.5 + '@types/node': 20.19.43 + + '@types/unist@3.0.3': {} + + '@ungap/structured-clone@1.3.3': {} + + '@vitejs/plugin-basic-ssl@2.3.0(vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0))': + dependencies: + vite: 8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0) + + '@vitest/expect@4.1.10': + dependencies: + '@standard-schema/spec': 1.1.0 + '@types/chai': 5.2.3 + '@vitest/spy': 4.1.10 + '@vitest/utils': 4.1.10 + chai: 6.2.2 + tinyrainbow: 3.1.1 + + '@vitest/mocker@4.1.10(vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0))': + dependencies: + '@vitest/spy': 4.1.10 + estree-walker: 3.0.3 + magic-string: 0.30.21 + optionalDependencies: + vite: 8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0) + + '@vitest/pretty-format@4.1.10': + dependencies: + tinyrainbow: 3.1.1 + + '@vitest/runner@4.1.10': + dependencies: + '@vitest/utils': 4.1.10 + pathe: 2.0.3 + + '@vitest/snapshot@4.1.10': + dependencies: + '@vitest/pretty-format': 4.1.10 + '@vitest/utils': 4.1.10 + magic-string: 0.30.21 + pathe: 2.0.3 + + '@vitest/spy@4.1.10': {} + + '@vitest/utils@4.1.10': + dependencies: + '@vitest/pretty-format': 4.1.10 + convert-source-map: 2.0.0 + tinyrainbow: 3.1.1 + + accepts@2.0.0: + dependencies: + mime-types: 3.0.2 + negotiator: 1.0.0 + + agent-base@7.1.4: {} + + agent-base@9.0.0: {} + + ajv-formats@3.0.1(ajv@8.20.0): + optionalDependencies: + ajv: 8.20.0 + + ajv@8.20.0: + dependencies: + fast-deep-equal: 3.1.3 + fast-uri: 3.1.5 + json-schema-traverse: 1.0.0 + require-from-string: 2.0.2 + + ansi-escapes@7.3.0: + dependencies: + environment: 1.1.0 + + ansi-regex@6.3.0: {} + + ansi-styles@6.2.3: {} + + argparse@1.0.10: + dependencies: + sprintf-js: 1.0.3 + + assertion-error@2.0.1: {} + + baseline-browser-mapping@2.11.14: {} + + beasties@0.4.3: + dependencies: + css-select: 6.0.0 + css-what: 7.0.0 + dom-serializer: 2.0.0 + domhandler: 5.0.3 + htmlparser2: 10.1.0 + picocolors: 1.1.1 + postcss: 8.5.26 + postcss-media-query-parser: 0.2.3 + postcss-safe-parser: 7.0.1(postcss@8.5.26) + + bidi-js@1.0.3: + dependencies: + require-from-string: 2.0.2 + + body-parser@2.3.0: + dependencies: + bytes: 3.1.2 + content-type: 2.1.0 + debug: 4.4.3 + http-errors: 2.0.1 + iconv-lite: 0.7.3 + on-finished: 2.4.1 + qs: 6.15.3 + raw-body: 3.0.2 + type-is: 2.1.0 + transitivePeerDependencies: + - supports-color + + boolbase@1.0.0: {} + + browserslist@4.28.8: + dependencies: + baseline-browser-mapping: 2.11.14 + caniuse-lite: 1.0.30001809 + electron-to-chromium: 1.5.406 + node-releases: 2.0.53 + update-browserslist-db: 1.3.1(browserslist@4.28.8) + + buffer-from@1.1.2: {} + + bytes@3.1.2: {} + + call-bind-apply-helpers@1.0.2: + dependencies: + es-errors: 1.3.0 + function-bind: 1.1.2 + + call-bound@1.0.4: + dependencies: + call-bind-apply-helpers: 1.0.2 + get-intrinsic: 1.3.0 + + caniuse-lite@1.0.30001809: {} + + ccount@2.0.1: {} + + chai@6.2.2: {} + + chalk@5.6.2: {} + + character-entities-html4@2.1.0: {} + + character-entities-legacy@3.0.0: {} + + chardet@2.2.0: {} + + chokidar@5.0.0: + dependencies: + readdirp: 5.1.1 + + cli-cursor@5.0.0: + dependencies: + restore-cursor: 5.1.0 + + cli-spinners@3.4.0: {} + + cli-truncate@5.2.0: + dependencies: + slice-ansi: 8.0.0 + string-width: 8.2.2 + + cli-width@4.1.0: {} + + cliui@9.0.1: + dependencies: + string-width: 7.2.0 + strip-ansi: 7.2.0 + wrap-ansi: 9.0.2 + + comma-separated-tokens@2.0.3: {} + + content-disposition@1.1.0: {} + + content-type@1.0.5: {} + + content-type@2.1.0: {} + + convert-source-map@1.9.0: {} + + convert-source-map@2.0.0: {} + + cookie-signature@1.2.2: {} + + cookie@0.7.2: {} + + cors@2.8.6: + dependencies: + object-assign: 4.1.1 + vary: 1.1.2 + + cross-spawn@7.0.6: + dependencies: + path-key: 3.1.1 + shebang-command: 2.0.0 + which: 2.0.2 + + css-select@6.0.0: + dependencies: + boolbase: 1.0.0 + css-what: 7.0.0 + domhandler: 5.0.3 + domutils: 3.2.2 + nth-check: 2.1.1 + + css-tree@3.2.1: + dependencies: + mdn-data: 2.27.1 + source-map-js: 1.2.1 + + css-what@7.0.0: {} + + cssesc@3.0.0: {} + + cssstyle@6.2.0: + dependencies: + '@asamuzakjp/css-color': 5.1.11 + '@csstools/css-syntax-patches-for-csstree': 1.1.7(css-tree@3.2.1) + css-tree: 3.2.1 + lru-cache: 11.5.2 + + data-urls@7.0.0: + dependencies: + whatwg-mimetype: 5.0.0 + whatwg-url: 16.0.1 + transitivePeerDependencies: + - '@noble/hashes' + + debug@4.4.3: + dependencies: + ms: 2.1.3 + + decimal.js@10.6.0: {} + + depd@2.0.0: {} + + dequal@2.0.3: {} + + detect-libc@2.1.2: {} + + devlop@1.1.0: + dependencies: + dequal: 2.0.3 + + dom-serializer@2.0.0: + dependencies: + domelementtype: 2.3.0 + domhandler: 5.0.3 + entities: 4.5.0 + + domelementtype@2.3.0: {} + + domhandler@5.0.3: + dependencies: + domelementtype: 2.3.0 + + domutils@3.2.2: + dependencies: + dom-serializer: 2.0.0 + domelementtype: 2.3.0 + domhandler: 5.0.3 + + dunder-proto@1.0.1: + dependencies: + call-bind-apply-helpers: 1.0.2 + es-errors: 1.3.0 + gopd: 1.2.0 + + ee-first@1.1.1: {} + + electron-to-chromium@1.5.406: {} + + emoji-regex@10.6.0: {} + + empathic@2.0.1: {} + + encodeurl@2.0.0: {} + + enhanced-resolve@5.24.5: + dependencies: + graceful-fs: 4.2.11 + tapable: 2.3.3 + + entities@4.5.0: {} + + entities@7.0.1: {} + + entities@8.0.0: {} + + environment@1.1.0: {} + + es-define-property@1.0.1: {} + + es-errors@1.3.0: {} + + es-module-lexer@2.3.1: {} + + es-object-atoms@1.1.2: + dependencies: + es-errors: 1.3.0 + + esbuild@0.28.2: + optionalDependencies: + '@esbuild/aix-ppc64': 0.28.2 + '@esbuild/android-arm': 0.28.2 + '@esbuild/android-arm64': 0.28.2 + '@esbuild/android-x64': 0.28.2 + '@esbuild/darwin-arm64': 0.28.2 + '@esbuild/darwin-x64': 0.28.2 + '@esbuild/freebsd-arm64': 0.28.2 + '@esbuild/freebsd-x64': 0.28.2 + '@esbuild/linux-arm': 0.28.2 + '@esbuild/linux-arm64': 0.28.2 + '@esbuild/linux-ia32': 0.28.2 + '@esbuild/linux-loong64': 0.28.2 + '@esbuild/linux-mips64el': 0.28.2 + '@esbuild/linux-ppc64': 0.28.2 + '@esbuild/linux-riscv64': 0.28.2 + '@esbuild/linux-s390x': 0.28.2 + '@esbuild/linux-x64': 0.28.2 + '@esbuild/netbsd-arm64': 0.28.2 + '@esbuild/netbsd-x64': 0.28.2 + '@esbuild/openbsd-arm64': 0.28.2 + '@esbuild/openbsd-x64': 0.28.2 + '@esbuild/openharmony-arm64': 0.28.2 + '@esbuild/sunos-x64': 0.28.2 + '@esbuild/win32-arm64': 0.28.2 + '@esbuild/win32-ia32': 0.28.2 + '@esbuild/win32-x64': 0.28.2 + + escalade@3.2.0: {} + + escape-html@1.0.3: {} + + esprima@4.0.1: {} + + estree-walker@3.0.3: + dependencies: + '@types/estree': 1.0.9 + + etag@1.8.1: {} + + eventemitter3@5.0.4: {} + + eventsource-parser@3.1.1: {} + + eventsource@3.0.7: + dependencies: + eventsource-parser: 3.1.1 + + expect-type@1.4.0: {} + + express-rate-limit@8.6.2(express@5.2.1): + dependencies: + debug: 4.4.3 + express: 5.2.1 + ip-address: 10.5.0 + transitivePeerDependencies: + - supports-color + + express@5.2.1: + dependencies: + accepts: 2.0.0 + body-parser: 2.3.0 + content-disposition: 1.1.0 + content-type: 1.0.5 + cookie: 0.7.2 + cookie-signature: 1.2.2 + debug: 4.4.3 + depd: 2.0.0 + encodeurl: 2.0.0 + escape-html: 1.0.3 + etag: 1.8.1 + finalhandler: 2.1.1 + fresh: 2.0.0 + http-errors: 2.0.1 + merge-descriptors: 2.0.0 + mime-types: 3.0.2 + on-finished: 2.4.1 + once: 1.4.0 + parseurl: 1.3.3 + proxy-addr: 2.0.7 + qs: 6.15.3 + range-parser: 1.3.0 + router: 2.2.0 + send: 1.2.1 + serve-static: 2.2.1 + statuses: 2.0.2 + type-is: 2.1.0 + vary: 1.1.2 + transitivePeerDependencies: + - supports-color + + extend-shallow@2.0.1: + dependencies: + is-extendable: 0.1.1 + + fast-deep-equal@3.1.3: {} + + fast-string-truncated-width@3.0.3: {} + + fast-string-width@3.0.2: + dependencies: + fast-string-truncated-width: 3.0.3 + + fast-uri@3.1.5: {} + + fast-wrap-ansi@0.2.2: + dependencies: + fast-string-width: 3.0.2 + + fdir@6.5.0(picomatch@4.0.5): + optionalDependencies: + picomatch: 4.0.5 + + finalhandler@2.1.1: + dependencies: + debug: 4.4.3 + encodeurl: 2.0.0 + escape-html: 1.0.3 + on-finished: 2.4.1 + parseurl: 1.3.3 + statuses: 2.0.2 + transitivePeerDependencies: + - supports-color + + forwarded@0.2.0: {} + + fresh@2.0.0: {} + + fsevents@2.3.2: + optional: true + + fsevents@2.3.3: + optional: true + + function-bind@1.1.2: {} + + gensync@1.0.0-beta.2: {} + + get-caller-file@2.0.5: {} + + get-east-asian-width@1.6.0: {} + + get-intrinsic@1.3.0: + dependencies: + call-bind-apply-helpers: 1.0.2 + es-define-property: 1.0.1 + es-errors: 1.3.0 + es-object-atoms: 1.1.2 + function-bind: 1.1.2 + get-proto: 1.0.1 + gopd: 1.2.0 + has-symbols: 1.1.0 + hasown: 2.0.4 + math-intrinsics: 1.1.0 + + get-proto@1.0.1: + dependencies: + dunder-proto: 1.0.1 + es-object-atoms: 1.1.2 + + github-slugger@2.0.0: {} + + gopd@1.2.0: {} + + graceful-fs@4.2.11: {} + + gray-matter@4.0.3: + dependencies: + js-yaml: 3.15.1 + kind-of: 6.0.3 + section-matter: 1.0.0 + strip-bom-string: 1.0.0 + + has-symbols@1.1.0: {} + + hasown@2.0.4: + dependencies: + function-bind: 1.1.2 + + hast-util-to-html@9.0.5: + dependencies: + '@types/hast': 3.0.5 + '@types/unist': 3.0.3 + ccount: 2.0.1 + comma-separated-tokens: 2.0.3 + hast-util-whitespace: 3.0.0 + html-void-elements: 3.0.0 + mdast-util-to-hast: 13.2.1 + property-information: 7.2.0 + space-separated-tokens: 2.0.2 + stringify-entities: 4.0.4 + zwitch: 2.0.4 + + hast-util-whitespace@3.0.0: + dependencies: + '@types/hast': 3.0.5 + + hono@4.13.2: {} + + hosted-git-info@10.1.1: + dependencies: + lru-cache: 11.5.2 + + html-encoding-sniffer@6.0.0: + dependencies: + '@exodus/bytes': 1.15.1 + transitivePeerDependencies: + - '@noble/hashes' + + html-void-elements@3.0.0: {} + + htmlparser2@10.1.0: + dependencies: + domelementtype: 2.3.0 + domhandler: 5.0.3 + domutils: 3.2.2 + entities: 7.0.1 + + http-errors@2.0.1: + dependencies: + depd: 2.0.0 + inherits: 2.0.4 + setprototypeof: 1.2.0 + statuses: 2.0.2 + toidentifier: 1.0.1 + + http-proxy-agent@7.0.2: + dependencies: + agent-base: 7.1.4 + debug: 4.4.3 + transitivePeerDependencies: + - supports-color + + https-proxy-agent@7.0.6: + dependencies: + agent-base: 7.1.4 + debug: 4.4.3 + transitivePeerDependencies: + - supports-color + + https-proxy-agent@9.1.0: + dependencies: + agent-base: 9.0.0 + debug: 4.4.3 + proxy-agent-negotiate: 1.1.0 + transitivePeerDependencies: + - kerberos + - supports-color + + iconv-lite@0.7.3: + dependencies: + safer-buffer: 2.1.2 + + immutable@5.1.9: {} + + import-meta-resolve@4.2.0: {} + + inherits@2.0.4: {} + + ip-address@10.5.0: {} + + ipaddr.js@1.9.1: {} + + is-extendable@0.1.1: {} + + is-extglob@2.1.1: + optional: true + + is-fullwidth-code-point@5.1.0: + dependencies: + get-east-asian-width: 1.6.0 + + is-glob@4.0.3: + dependencies: + is-extglob: 2.1.1 + optional: true + + is-interactive@2.0.0: {} + + is-potential-custom-element-name@1.0.1: {} + + is-promise@4.0.0: {} + + is-unicode-supported@2.1.0: {} + + isexe@2.0.0: {} + + jiti@2.7.0: {} + + jose@6.2.8: {} + + js-tokens@10.0.0: {} + + js-yaml@3.15.1: + dependencies: + argparse: 1.0.10 + esprima: 4.0.1 + + jsdom@28.1.0: + dependencies: + '@acemir/cssom': 0.9.31 + '@asamuzakjp/dom-selector': 6.8.1 + '@bramus/specificity': 2.4.2 + '@exodus/bytes': 1.15.1 + cssstyle: 6.2.0 + data-urls: 7.0.0 + decimal.js: 10.6.0 + html-encoding-sniffer: 6.0.0 + http-proxy-agent: 7.0.2 + https-proxy-agent: 7.0.6 + is-potential-custom-element-name: 1.0.1 + parse5: 8.0.1 + saxes: 6.0.0 + symbol-tree: 3.2.4 + tough-cookie: 6.0.2 + undici: 7.29.0 + w3c-xmlserializer: 5.0.0 + webidl-conversions: 8.0.1 + whatwg-mimetype: 5.0.0 + whatwg-url: 16.0.1 + xml-name-validator: 5.0.0 + transitivePeerDependencies: + - '@noble/hashes' + - supports-color + + jsesc@3.1.0: {} + + json-schema-traverse@1.0.0: {} + + json-schema-typed@8.0.2: {} + + json5@2.2.3: {} + + jsonc-parser@3.3.1: {} + + kind-of@6.0.3: {} + + lightningcss-android-arm64@1.32.0: + optional: true + + lightningcss-android-arm64@1.33.0: + optional: true + + lightningcss-darwin-arm64@1.32.0: + optional: true + + lightningcss-darwin-arm64@1.33.0: + optional: true + + lightningcss-darwin-x64@1.32.0: + optional: true + + lightningcss-darwin-x64@1.33.0: + optional: true + + lightningcss-freebsd-x64@1.32.0: + optional: true + + lightningcss-freebsd-x64@1.33.0: + optional: true + + lightningcss-linux-arm-gnueabihf@1.32.0: + optional: true + + lightningcss-linux-arm-gnueabihf@1.33.0: + optional: true + + lightningcss-linux-arm64-gnu@1.32.0: + optional: true + + lightningcss-linux-arm64-gnu@1.33.0: + optional: true + + lightningcss-linux-arm64-musl@1.32.0: + optional: true + + lightningcss-linux-arm64-musl@1.33.0: + optional: true + + lightningcss-linux-x64-gnu@1.32.0: + optional: true + + lightningcss-linux-x64-gnu@1.33.0: + optional: true + + lightningcss-linux-x64-musl@1.32.0: + optional: true + + lightningcss-linux-x64-musl@1.33.0: + optional: true + + lightningcss-win32-arm64-msvc@1.32.0: + optional: true + + lightningcss-win32-arm64-msvc@1.33.0: + optional: true + + lightningcss-win32-x64-msvc@1.32.0: + optional: true + + lightningcss-win32-x64-msvc@1.33.0: + optional: true + + lightningcss@1.32.0: + dependencies: + detect-libc: 2.1.2 + optionalDependencies: + lightningcss-android-arm64: 1.32.0 + lightningcss-darwin-arm64: 1.32.0 + lightningcss-darwin-x64: 1.32.0 + lightningcss-freebsd-x64: 1.32.0 + lightningcss-linux-arm-gnueabihf: 1.32.0 + lightningcss-linux-arm64-gnu: 1.32.0 + lightningcss-linux-arm64-musl: 1.32.0 + lightningcss-linux-x64-gnu: 1.32.0 + lightningcss-linux-x64-musl: 1.32.0 + lightningcss-win32-arm64-msvc: 1.32.0 + lightningcss-win32-x64-msvc: 1.32.0 + + lightningcss@1.33.0: + dependencies: + detect-libc: 2.1.2 + optionalDependencies: + lightningcss-android-arm64: 1.33.0 + lightningcss-darwin-arm64: 1.33.0 + lightningcss-darwin-x64: 1.33.0 + lightningcss-freebsd-x64: 1.33.0 + lightningcss-linux-arm-gnueabihf: 1.33.0 + lightningcss-linux-arm64-gnu: 1.33.0 + lightningcss-linux-arm64-musl: 1.33.0 + lightningcss-linux-x64-gnu: 1.33.0 + lightningcss-linux-x64-musl: 1.33.0 + lightningcss-win32-arm64-msvc: 1.33.0 + lightningcss-win32-x64-msvc: 1.33.0 + + listr2@10.2.2: + dependencies: + cli-truncate: 5.2.0 + eventemitter3: 5.0.4 + log-update: 6.1.0 + rfdc: 1.4.1 + wrap-ansi: 10.0.0 + + lmdb@3.5.6: + dependencies: + '@harperfast/extended-iterable': 1.0.3 + msgpackr: 1.12.1 + node-addon-api: 6.1.0 + node-gyp-build-optional-packages: 5.2.2 + ordered-binary: 1.6.1 + weak-lru-cache: 1.2.2 + optionalDependencies: + '@lmdb/lmdb-darwin-arm64': 3.5.6 + '@lmdb/lmdb-darwin-x64': 3.5.6 + '@lmdb/lmdb-linux-arm': 3.5.6 + '@lmdb/lmdb-linux-arm64': 3.5.6 + '@lmdb/lmdb-linux-x64': 3.5.6 + '@lmdb/lmdb-win32-arm64': 3.5.6 + '@lmdb/lmdb-win32-x64': 3.5.6 + optional: true + + log-symbols@7.0.1: + dependencies: + is-unicode-supported: 2.1.0 + yoctocolors: 2.2.0 + + log-update@6.1.0: + dependencies: + ansi-escapes: 7.3.0 + cli-cursor: 5.0.0 + slice-ansi: 7.1.2 + strip-ansi: 7.2.0 + wrap-ansi: 9.0.2 + + lru-cache@11.5.2: {} + + magic-string@0.30.21: + dependencies: + '@jridgewell/sourcemap-codec': 1.5.5 + + magic-string@1.0.0: + dependencies: + '@jridgewell/sourcemap-codec': 1.5.5 + + marked@18.0.9: {} + + math-intrinsics@1.1.0: {} + + mdast-util-to-hast@13.2.1: + dependencies: + '@types/hast': 3.0.5 + '@types/mdast': 4.0.4 + '@ungap/structured-clone': 1.3.3 + devlop: 1.1.0 + micromark-util-sanitize-uri: 2.0.1 + trim-lines: 3.0.1 + unist-util-position: 5.0.0 + unist-util-visit: 5.1.0 + vfile: 6.0.3 + + mdn-data@2.27.1: {} + + media-typer@1.1.1: {} + + merge-descriptors@2.0.0: {} + + micromark-util-character@2.1.1: + dependencies: + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-encode@2.0.1: {} + + micromark-util-sanitize-uri@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-encode: 2.0.1 + micromark-util-symbol: 2.0.1 + + micromark-util-symbol@2.0.1: {} + + micromark-util-types@2.0.2: {} + + mime-db@1.54.0: {} + + mime-types@3.0.2: + dependencies: + mime-db: 1.54.0 + + mimic-function@5.0.1: {} + + mrmime@2.0.1: {} + + ms@2.1.3: {} + + msgpackr-extract@3.0.4: + dependencies: + node-gyp-build-optional-packages: 5.2.2 + optionalDependencies: + '@msgpackr-extract/msgpackr-extract-darwin-arm64': 3.0.4 + '@msgpackr-extract/msgpackr-extract-darwin-x64': 3.0.4 + '@msgpackr-extract/msgpackr-extract-linux-arm': 3.0.4 + '@msgpackr-extract/msgpackr-extract-linux-arm64': 3.0.4 + '@msgpackr-extract/msgpackr-extract-linux-x64': 3.0.4 + '@msgpackr-extract/msgpackr-extract-win32-x64': 3.0.4 + optional: true + + msgpackr@1.12.1: + optionalDependencies: + msgpackr-extract: 3.0.4 + optional: true + + mute-stream@3.0.0: {} + + nanoid@3.3.18: {} + + negotiator@1.0.0: {} + + node-addon-api@6.1.0: + optional: true + + node-addon-api@7.1.1: + optional: true + + node-gyp-build-optional-packages@5.2.2: + dependencies: + detect-libc: 2.1.2 + optional: true + + node-releases@2.0.53: {} + + npm-package-arg@14.0.0: + dependencies: + hosted-git-info: 10.1.1 + proc-log: 7.0.0 + semver: 7.8.5 + validate-npm-package-name: 8.0.0 + + nth-check@2.1.1: + dependencies: + boolbase: 1.0.0 + + object-assign@4.1.1: {} + + object-inspect@1.13.4: {} + + obug@2.1.4: {} + + on-finished@2.4.1: + dependencies: + ee-first: 1.1.1 + + once@1.4.0: + dependencies: + wrappy: 1.0.2 + + onetime@7.0.0: + dependencies: + mimic-function: 5.0.1 + + oniguruma-parser@0.12.2: {} + + oniguruma-to-es@4.3.6: + dependencies: + oniguruma-parser: 0.12.2 + regex: 6.1.0 + regex-recursion: 6.0.2 + + ora@9.4.1: + dependencies: + chalk: 5.6.2 + cli-cursor: 5.0.0 + cli-spinners: 3.4.0 + is-interactive: 2.0.0 + is-unicode-supported: 2.1.0 + log-symbols: 7.0.1 + stdin-discarder: 0.3.2 + string-width: 8.2.2 + + ordered-binary@1.6.1: + optional: true + + oxc-parser@0.142.0: + dependencies: + '@oxc-project/types': 0.142.0 + optionalDependencies: + '@oxc-parser/binding-android-arm-eabi': 0.142.0 + '@oxc-parser/binding-android-arm64': 0.142.0 + '@oxc-parser/binding-darwin-arm64': 0.142.0 + '@oxc-parser/binding-darwin-x64': 0.142.0 + '@oxc-parser/binding-freebsd-x64': 0.142.0 + '@oxc-parser/binding-linux-arm-gnueabihf': 0.142.0 + '@oxc-parser/binding-linux-arm-musleabihf': 0.142.0 + '@oxc-parser/binding-linux-arm64-gnu': 0.142.0 + '@oxc-parser/binding-linux-arm64-musl': 0.142.0 + '@oxc-parser/binding-linux-ppc64-gnu': 0.142.0 + '@oxc-parser/binding-linux-riscv64-gnu': 0.142.0 + '@oxc-parser/binding-linux-riscv64-musl': 0.142.0 + '@oxc-parser/binding-linux-s390x-gnu': 0.142.0 + '@oxc-parser/binding-linux-x64-gnu': 0.142.0 + '@oxc-parser/binding-linux-x64-musl': 0.142.0 + '@oxc-parser/binding-openharmony-arm64': 0.142.0 + '@oxc-parser/binding-wasm32-wasi': 0.142.0 + '@oxc-parser/binding-win32-arm64-msvc': 0.142.0 + '@oxc-parser/binding-win32-ia32-msvc': 0.142.0 + '@oxc-parser/binding-win32-x64-msvc': 0.142.0 + + parse5-html-rewriting-stream@8.0.1: + dependencies: + entities: 8.0.0 + parse5: 8.0.1 + parse5-sax-parser: 8.0.0 + + parse5-sax-parser@8.0.0: + dependencies: + parse5: 8.0.1 + + parse5@8.0.1: + dependencies: + entities: 8.0.0 + + parseurl@1.3.3: {} + + path-key@3.1.1: {} + + path-to-regexp@8.4.2: {} + + pathe@2.0.3: {} + + picocolors@1.1.1: {} + + picomatch@4.0.5: {} + + piscina@5.2.0: + optionalDependencies: + '@napi-rs/nice': 1.1.1 + + pkce-challenge@5.0.1: {} + + playwright-core@1.62.1: {} + + playwright@1.62.1: + dependencies: + playwright-core: 1.62.1 + optionalDependencies: + fsevents: 2.3.2 + + postcss-media-query-parser@0.2.3: {} + + postcss-safe-parser@7.0.1(postcss@8.5.26): + dependencies: + postcss: 8.5.26 + + postcss-selector-parser@6.0.10: + dependencies: + cssesc: 3.0.0 + util-deprecate: 1.0.2 + + postcss@8.5.26: + dependencies: + nanoid: 3.3.18 + picocolors: 1.1.1 + source-map-js: 1.2.1 + + prettier@3.9.6: {} + + proc-log@7.0.0: {} + + property-information@7.2.0: {} + + proxy-addr@2.0.7: + dependencies: + forwarded: 0.2.0 + ipaddr.js: 1.9.1 + + proxy-agent-negotiate@1.1.0: {} + + punycode@2.3.1: {} + + qs@6.15.3: + dependencies: + es-define-property: 1.0.1 + side-channel: 1.1.1 + + range-parser@1.3.0: {} + + raw-body@3.0.2: + dependencies: + bytes: 3.1.2 + http-errors: 2.0.1 + iconv-lite: 0.7.3 + unpipe: 1.0.0 + + readdirp@5.1.1: {} + + reflect-metadata@0.2.2: {} + + regex-recursion@6.0.2: + dependencies: + regex-utilities: 2.3.0 + + regex-utilities@2.3.0: {} + + regex@6.1.0: + dependencies: + regex-utilities: 2.3.0 + + require-from-string@2.0.2: {} + + restore-cursor@5.1.0: + dependencies: + onetime: 7.0.0 + signal-exit: 4.1.0 + + rfdc@1.4.1: {} + + rolldown@1.1.5: + dependencies: + '@oxc-project/types': 0.139.0 + '@rolldown/pluginutils': 1.0.1 + optionalDependencies: + '@rolldown/binding-android-arm64': 1.1.5 + '@rolldown/binding-darwin-arm64': 1.1.5 + '@rolldown/binding-darwin-x64': 1.1.5 + '@rolldown/binding-freebsd-x64': 1.1.5 + '@rolldown/binding-linux-arm-gnueabihf': 1.1.5 + '@rolldown/binding-linux-arm64-gnu': 1.1.5 + '@rolldown/binding-linux-arm64-musl': 1.1.5 + '@rolldown/binding-linux-ppc64-gnu': 1.1.5 + '@rolldown/binding-linux-s390x-gnu': 1.1.5 + '@rolldown/binding-linux-x64-gnu': 1.1.5 + '@rolldown/binding-linux-x64-musl': 1.1.5 + '@rolldown/binding-openharmony-arm64': 1.1.5 + '@rolldown/binding-wasm32-wasi': 1.1.5 + '@rolldown/binding-win32-arm64-msvc': 1.1.5 + '@rolldown/binding-win32-x64-msvc': 1.1.5 + + rolldown@1.2.0: + dependencies: + '@oxc-project/types': 0.140.0 + '@rolldown/pluginutils': 1.0.1 + optionalDependencies: + '@rolldown/binding-android-arm64': 1.2.0 + '@rolldown/binding-darwin-arm64': 1.2.0 + '@rolldown/binding-darwin-x64': 1.2.0 + '@rolldown/binding-freebsd-x64': 1.2.0 + '@rolldown/binding-linux-arm-gnueabihf': 1.2.0 + '@rolldown/binding-linux-arm64-gnu': 1.2.0 + '@rolldown/binding-linux-arm64-musl': 1.2.0 + '@rolldown/binding-linux-ppc64-gnu': 1.2.0 + '@rolldown/binding-linux-s390x-gnu': 1.2.0 + '@rolldown/binding-linux-x64-gnu': 1.2.0 + '@rolldown/binding-linux-x64-musl': 1.2.0 + '@rolldown/binding-openharmony-arm64': 1.2.0 + '@rolldown/binding-wasm32-wasi': 1.2.0 + '@rolldown/binding-win32-arm64-msvc': 1.2.0 + '@rolldown/binding-win32-x64-msvc': 1.2.0 + + router@2.2.0: + dependencies: + debug: 4.4.3 + depd: 2.0.0 + is-promise: 4.0.0 + parseurl: 1.3.3 + path-to-regexp: 8.4.2 + transitivePeerDependencies: + - supports-color + + rxjs@7.8.2: + dependencies: + tslib: 2.8.1 + + safer-buffer@2.1.2: {} + + sass@1.101.0: + dependencies: + chokidar: 5.0.0 + immutable: 5.1.9 + source-map-js: 1.2.1 + optionalDependencies: + '@parcel/watcher': 2.6.0 + + saxes@6.0.0: + dependencies: + xmlchars: 2.2.0 + + section-matter@1.0.0: + dependencies: + extend-shallow: 2.0.1 + kind-of: 6.0.3 + + semver@7.8.5: {} + + send@1.2.1: + dependencies: + debug: 4.4.3 + encodeurl: 2.0.0 + escape-html: 1.0.3 + etag: 1.8.1 + fresh: 2.0.0 + http-errors: 2.0.1 + mime-types: 3.0.2 + ms: 2.1.3 + on-finished: 2.4.1 + range-parser: 1.3.0 + statuses: 2.0.2 + transitivePeerDependencies: + - supports-color + + serve-static@2.2.1: + dependencies: + encodeurl: 2.0.0 + escape-html: 1.0.3 + parseurl: 1.3.3 + send: 1.2.1 + transitivePeerDependencies: + - supports-color + + setprototypeof@1.2.0: {} + + shebang-command@2.0.0: + dependencies: + shebang-regex: 3.0.0 + + shebang-regex@3.0.0: {} + + shiki@4.4.3: + dependencies: + '@shikijs/core': 4.4.3 + '@shikijs/engine-javascript': 4.4.3 + '@shikijs/engine-oniguruma': 4.4.3 + '@shikijs/langs': 4.4.3 + '@shikijs/themes': 4.4.3 + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + + side-channel-list@1.0.1: + dependencies: + es-errors: 1.3.0 + object-inspect: 1.13.4 + + side-channel-map@1.0.1: + dependencies: + call-bound: 1.0.4 + es-errors: 1.3.0 + get-intrinsic: 1.3.0 + object-inspect: 1.13.4 + + side-channel-weakmap@1.0.2: + dependencies: + call-bound: 1.0.4 + es-errors: 1.3.0 + get-intrinsic: 1.3.0 + object-inspect: 1.13.4 + side-channel-map: 1.0.1 + + side-channel@1.1.1: + dependencies: + es-errors: 1.3.0 + object-inspect: 1.13.4 + side-channel-list: 1.0.1 + side-channel-map: 1.0.1 + side-channel-weakmap: 1.0.2 + + siginfo@2.0.0: {} + + signal-exit@4.1.0: {} + + slice-ansi@7.1.2: + dependencies: + ansi-styles: 6.2.3 + is-fullwidth-code-point: 5.1.0 + + slice-ansi@8.0.0: + dependencies: + ansi-styles: 6.2.3 + is-fullwidth-code-point: 5.1.0 + + source-map-js@1.2.1: {} + + source-map-support@0.5.21: + dependencies: + buffer-from: 1.1.2 + source-map: 0.6.1 + + source-map@0.6.1: {} + + source-map@0.7.6: {} + + space-separated-tokens@2.0.2: {} + + sprintf-js@1.0.3: {} + + stackback@0.0.2: {} + + statuses@2.0.2: {} + + std-env@4.2.0: {} + + stdin-discarder@0.3.2: {} + + string-width@7.2.0: + dependencies: + emoji-regex: 10.6.0 + get-east-asian-width: 1.6.0 + strip-ansi: 7.2.0 + + string-width@8.2.2: + dependencies: + get-east-asian-width: 1.6.0 + strip-ansi: 7.2.0 + + stringify-entities@4.0.4: + dependencies: + character-entities-html4: 2.1.0 + character-entities-legacy: 3.0.0 + + strip-ansi@7.2.0: + dependencies: + ansi-regex: 6.3.0 + + strip-bom-string@1.0.0: {} + + symbol-tree@3.2.4: {} + + tailwindcss@4.3.3: {} + + tapable@2.3.3: {} + + tinybench@2.9.0: {} + + tinyexec@1.3.0: {} + + tinyglobby@0.2.17: + dependencies: + fdir: 6.5.0(picomatch@4.0.5) + picomatch: 4.0.5 + + tinyrainbow@3.1.1: {} + + tldts-core@7.4.10: {} + + tldts@7.4.10: + dependencies: + tldts-core: 7.4.10 + + toidentifier@1.0.1: {} + + tough-cookie@6.0.2: + dependencies: + tldts: 7.4.10 + + tr46@6.0.0: + dependencies: + punycode: 2.3.1 + + trim-lines@3.0.1: {} + + tslib@2.8.1: {} + + type-is@2.1.0: + dependencies: + content-type: 2.1.0 + media-typer: 1.1.1 + mime-types: 3.0.2 + + typescript@6.0.3: {} + + undici-types@6.21.0: {} + + undici@7.29.0: {} + + unist-util-is@6.0.1: + dependencies: + '@types/unist': 3.0.3 + + unist-util-position@5.0.0: + dependencies: + '@types/unist': 3.0.3 + + unist-util-stringify-position@4.0.0: + dependencies: + '@types/unist': 3.0.3 + + unist-util-visit-parents@6.0.2: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + + unist-util-visit@5.1.0: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + unist-util-visit-parents: 6.0.2 + + unpipe@1.0.0: {} + + update-browserslist-db@1.3.1(browserslist@4.28.8): + dependencies: + browserslist: 4.28.8 + escalade: 3.2.0 + picocolors: 1.1.1 + + util-deprecate@1.0.2: {} + + validate-npm-package-name@8.0.0: {} + + vary@1.1.2: {} + + vfile-message@4.0.3: + dependencies: + '@types/unist': 3.0.3 + unist-util-stringify-position: 4.0.0 + + vfile@6.0.3: + dependencies: + '@types/unist': 3.0.3 + vfile-message: 4.0.3 + + vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0): + dependencies: + lightningcss: 1.33.0 + picomatch: 4.0.5 + postcss: 8.5.26 + rolldown: 1.1.5 + tinyglobby: 0.2.17 + optionalDependencies: + '@types/node': 20.19.43 + esbuild: 0.28.2 + fsevents: 2.3.3 + jiti: 2.7.0 + sass: 1.101.0 + + vitest@4.1.10(@types/node@20.19.43)(jsdom@28.1.0)(vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0)): + dependencies: + '@vitest/expect': 4.1.10 + '@vitest/mocker': 4.1.10(vite@8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0)) + '@vitest/pretty-format': 4.1.10 + '@vitest/runner': 4.1.10 + '@vitest/snapshot': 4.1.10 + '@vitest/spy': 4.1.10 + '@vitest/utils': 4.1.10 + es-module-lexer: 2.3.1 + expect-type: 1.4.0 + magic-string: 0.30.21 + obug: 2.1.4 + pathe: 2.0.3 + picomatch: 4.0.5 + std-env: 4.2.0 + tinybench: 2.9.0 + tinyexec: 1.3.0 + tinyglobby: 0.2.17 + tinyrainbow: 3.1.1 + vite: 8.1.5(@types/node@20.19.43)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.101.0) + why-is-node-running: 2.3.0 + optionalDependencies: + '@types/node': 20.19.43 + jsdom: 28.1.0 + transitivePeerDependencies: + - msw + + w3c-xmlserializer@5.0.0: + dependencies: + xml-name-validator: 5.0.0 + + watchpack@2.5.2: + dependencies: + graceful-fs: 4.2.11 + + weak-lru-cache@1.2.2: + optional: true + + webidl-conversions@8.0.1: {} + + whatwg-mimetype@5.0.0: {} + + whatwg-url@16.0.1: + dependencies: + '@exodus/bytes': 1.15.1 + tr46: 6.0.0 + webidl-conversions: 8.0.1 + transitivePeerDependencies: + - '@noble/hashes' + + which@2.0.2: + dependencies: + isexe: 2.0.0 + + why-is-node-running@2.3.0: + dependencies: + siginfo: 2.0.0 + stackback: 0.0.2 + + wrap-ansi@10.0.0: + dependencies: + ansi-styles: 6.2.3 + string-width: 8.2.2 + strip-ansi: 7.2.0 + + wrap-ansi@9.0.2: + dependencies: + ansi-styles: 6.2.3 + string-width: 7.2.0 + strip-ansi: 7.2.0 + + wrappy@1.0.2: {} + + xhr2@0.2.1: {} + + xml-name-validator@5.0.0: {} + + xmlchars@2.2.0: {} + + y18n@5.0.8: {} + + yargs-parser@22.0.0: {} + + yargs@18.1.0: + dependencies: + cliui: 9.0.1 + escalade: 3.2.0 + get-caller-file: 2.0.5 + string-width: 8.2.2 + y18n: 5.0.8 + yargs-parser: 22.0.0 + + yoctocolors@2.2.0: {} + + zod-to-json-schema@3.25.2(zod@4.4.3): + dependencies: + zod: 4.4.3 + + zod@4.4.3: {} + + zwitch@2.0.4: {} diff --git a/website/pnpm-workspace.yaml b/website/pnpm-workspace.yaml new file mode 100644 index 000000000..3334c0e43 --- /dev/null +++ b/website/pnpm-workspace.yaml @@ -0,0 +1 @@ +packages: [] diff --git a/website/public/angular-challenge.ico b/website/public/angular-challenge.ico new file mode 100644 index 000000000..29d85cde0 Binary files /dev/null and b/website/public/angular-challenge.ico differ diff --git a/website/public/angular-challenge.webp b/website/public/angular-challenge.webp new file mode 100644 index 000000000..743d5aaab Binary files /dev/null and b/website/public/angular-challenge.webp differ diff --git a/website/public/docs-assets/4/unknown-person.png b/website/public/docs-assets/4/unknown-person.png new file mode 100644 index 000000000..9ab0a2e7d Binary files /dev/null and b/website/public/docs-assets/4/unknown-person.png differ diff --git a/website/public/docs-assets/4/unknown-student.png b/website/public/docs-assets/4/unknown-student.png new file mode 100644 index 000000000..247a29e91 Binary files /dev/null and b/website/public/docs-assets/4/unknown-student.png differ diff --git a/website/public/docs-assets/PR-code-btn-modal.png b/website/public/docs-assets/PR-code-btn-modal.png new file mode 100644 index 000000000..2cc4b1b27 Binary files /dev/null and b/website/public/docs-assets/PR-code-btn-modal.png differ diff --git a/website/public/docs-assets/PR-header.png b/website/public/docs-assets/PR-header.png new file mode 100644 index 000000000..bb76c8cf6 Binary files /dev/null and b/website/public/docs-assets/PR-header.png differ diff --git a/website/public/docs-assets/angular-challenge.webp b/website/public/docs-assets/angular-challenge.webp new file mode 100644 index 000000000..743d5aaab Binary files /dev/null and b/website/public/docs-assets/angular-challenge.webp differ diff --git a/website/public/docs-assets/codespaces.png b/website/public/docs-assets/codespaces.png new file mode 100644 index 000000000..2b8e8a43c Binary files /dev/null and b/website/public/docs-assets/codespaces.png differ diff --git a/website/public/docs-assets/fork-sync.png b/website/public/docs-assets/fork-sync.png new file mode 100644 index 000000000..7374facc0 Binary files /dev/null and b/website/public/docs-assets/fork-sync.png differ diff --git a/website/public/docs-assets/header-github.png b/website/public/docs-assets/header-github.png new file mode 100644 index 000000000..08da88dca Binary files /dev/null and b/website/public/docs-assets/header-github.png differ diff --git a/website/public/docs-assets/new-pull-request.png b/website/public/docs-assets/new-pull-request.png new file mode 100644 index 000000000..085acccee Binary files /dev/null and b/website/public/docs-assets/new-pull-request.png differ diff --git a/website/public/docs-assets/performance/34/profiler-record.png b/website/public/docs-assets/performance/34/profiler-record.png new file mode 100644 index 000000000..febcbd2a0 Binary files /dev/null and b/website/public/docs-assets/performance/34/profiler-record.png differ diff --git a/website/public/docs-assets/performance/35/memoize-profiler.png b/website/public/docs-assets/performance/35/memoize-profiler.png new file mode 100644 index 000000000..0520fde45 Binary files /dev/null and b/website/public/docs-assets/performance/35/memoize-profiler.png differ diff --git a/website/public/docs-assets/performance/profiler-tab.png b/website/public/docs-assets/performance/profiler-tab.png new file mode 100644 index 000000000..a6d228d73 Binary files /dev/null and b/website/public/docs-assets/performance/profiler-tab.png differ diff --git a/website/public/docs-assets/rxjs/49/prototype.gif b/website/public/docs-assets/rxjs/49/prototype.gif new file mode 100644 index 000000000..32c33528c Binary files /dev/null and b/website/public/docs-assets/rxjs/49/prototype.gif differ diff --git a/website/public/docs-assets/sync-fork-update.png b/website/public/docs-assets/sync-fork-update.png new file mode 100644 index 000000000..c8a1eea7d Binary files /dev/null and b/website/public/docs-assets/sync-fork-update.png differ diff --git a/website/src/app/app.config.server.ts b/website/src/app/app.config.server.ts new file mode 100644 index 000000000..41031f116 --- /dev/null +++ b/website/src/app/app.config.server.ts @@ -0,0 +1,12 @@ +import { mergeApplicationConfig, ApplicationConfig } from '@angular/core'; +import { provideServerRendering, withRoutes } from '@angular/ssr'; +import { appConfig } from './app.config'; +import { serverRoutes } from './app.routes.server'; + +const serverConfig: ApplicationConfig = { + providers: [ + provideServerRendering(withRoutes(serverRoutes)) + ] +}; + +export const config = mergeApplicationConfig(appConfig, serverConfig); diff --git a/website/src/app/app.config.ts b/website/src/app/app.config.ts new file mode 100644 index 000000000..9726923ea --- /dev/null +++ b/website/src/app/app.config.ts @@ -0,0 +1,26 @@ +import { ApplicationConfig, provideBrowserGlobalErrorListeners } from '@angular/core'; +import { + provideRouter, + withComponentInputBinding, + withInMemoryScrolling, +} from '@angular/router'; + +import { provideHttpClient, withFetch } from '@angular/common/http'; +import { routes } from './app.routes'; +import { provideClientHydration } from '@angular/platform-browser'; + +export const appConfig: ApplicationConfig = { + providers: [ + provideBrowserGlobalErrorListeners(), + provideRouter( + routes, + withComponentInputBinding(), + withInMemoryScrolling({ + anchorScrolling: 'enabled', + scrollPositionRestoration: 'enabled', + }), + ), + provideClientHydration(), + provideHttpClient(withFetch()), + ], +}; diff --git a/website/src/app/app.css b/website/src/app/app.css new file mode 100644 index 000000000..e69de29bb diff --git a/website/src/app/app.html b/website/src/app/app.html new file mode 100644 index 000000000..dabcba218 --- /dev/null +++ b/website/src/app/app.html @@ -0,0 +1,2 @@ + + diff --git a/website/src/app/app.routes.server.ts b/website/src/app/app.routes.server.ts new file mode 100644 index 000000000..e1837defc --- /dev/null +++ b/website/src/app/app.routes.server.ts @@ -0,0 +1,40 @@ +import { RenderMode, ServerRoute } from '@angular/ssr'; +import { MANIFEST } from './generated/manifest'; + +export const serverRoutes: ServerRoute[] = [ + { + path: '', + renderMode: RenderMode.Prerender, + }, + { + path: 'guides/:slug', + renderMode: RenderMode.Prerender, + async getPrerenderParams() { + return MANIFEST.guides.map((g) => ({ slug: g.url.split('/').pop()! })); + }, + }, + { + path: 'challenges/:category', + renderMode: RenderMode.Prerender, + async getPrerenderParams() { + return MANIFEST.challenges + .filter((g) => g.items.some((i) => i.url === `/challenges/${g.category}`)) + .map((g) => ({ category: g.category })); + }, + }, + { + path: 'challenges/:category/:slug', + renderMode: RenderMode.Prerender, + async getPrerenderParams() { + return MANIFEST.challenges.flatMap((g) => + g.items + .filter((i) => i.url !== `/challenges/${g.category}`) + .map((i) => ({ category: g.category, slug: i.url.split('/').pop()! })), + ); + }, + }, + { + path: '**', + renderMode: RenderMode.Server, + }, +]; diff --git a/website/src/app/app.routes.ts b/website/src/app/app.routes.ts new file mode 100644 index 000000000..68dc4eed2 --- /dev/null +++ b/website/src/app/app.routes.ts @@ -0,0 +1,51 @@ +import { Routes } from '@angular/router'; +import { docResolver } from './pages/docs/doc-resolver'; + +export const routes: Routes = [ + { + path: '', + pathMatch: 'full', + loadComponent: () => import('./pages/landing/landing').then((m) => m.Landing), + }, + { + path: '', + loadComponent: () => import('./layout/docs-layout').then((m) => m.DocsLayout), + children: [ + { + path: 'guides/:slug', + resolve: { doc: docResolver }, + loadComponent: () => import('./pages/docs/doc-page').then((m) => m.DocPage), + }, + { + path: 'challenges/:category', + resolve: { doc: docResolver }, + loadComponent: () => import('./pages/docs/doc-page').then((m) => m.DocPage), + }, + { + path: 'challenges/:category/:slug', + resolve: { doc: docResolver }, + loadComponent: () => import('./pages/docs/doc-page').then((m) => m.DocPage), + }, + { + path: 'challenges/:category/:slug/solutions', + resolve: { doc: docResolver }, + loadComponent: () => + import('./pages/solutions/solutions-list').then((m) => m.SolutionsList), + }, + { + path: 'challenges/:category/:slug/solutions/:pr', + resolve: { doc: docResolver }, + loadComponent: () => + import('./pages/solutions/solution-diff').then((m) => m.SolutionDiff), + }, + { + path: 'leaderboard/:board', + loadComponent: () => import('./pages/leaderboard/leaderboard').then((m) => m.Leaderboard), + }, + ], + }, + { + path: '**', + loadComponent: () => import('./pages/not-found/not-found').then((m) => m.NotFound), + }, +]; diff --git a/website/src/app/app.ts b/website/src/app/app.ts new file mode 100644 index 000000000..6f6cdde59 --- /dev/null +++ b/website/src/app/app.ts @@ -0,0 +1,13 @@ +import { Component, signal } from '@angular/core'; +import { RouterOutlet } from '@angular/router'; +import { ConsentBanner } from './shared/consent-banner'; + +@Component({ + selector: 'app-root', + imports: [RouterOutlet, ConsentBanner], + templateUrl: './app.html', + styleUrl: './app.css' +}) +export class App { + protected readonly title = signal('angular-challenges-website'); +} diff --git a/website/src/app/auth.ts b/website/src/app/auth.ts new file mode 100644 index 000000000..bdca41740 --- /dev/null +++ b/website/src/app/auth.ts @@ -0,0 +1,33 @@ +import { Injectable, PLATFORM_ID, computed, inject } from '@angular/core'; +import { isPlatformBrowser } from '@angular/common'; +import { httpResource } from '@angular/common/http'; + +export interface Me { + login: string; + avatar: string; +} + +@Injectable({ providedIn: 'root' }) +export class Auth { + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + + private readonly meResource = httpResource(() => + this.isBrowser ? '/api/me' : undefined, + ); + + readonly me = computed(() => + this.meResource.error() ? null : (this.meResource.value() ?? null), + ); + + readonly pending = computed(() => this.meResource.isLoading()); + + signInUrl(): string { + const here = this.isBrowser ? location.pathname : '/'; + return `/auth/authorize?redirect_uri=${encodeURIComponent(here)}`; + } + + signOutUrl(): string { + const here = this.isBrowser ? location.pathname : '/'; + return `/auth/logout?redirect_uri=${encodeURIComponent(here)}`; + } +} diff --git a/website/src/app/consent.ts b/website/src/app/consent.ts new file mode 100644 index 000000000..b56938c85 --- /dev/null +++ b/website/src/app/consent.ts @@ -0,0 +1,147 @@ +import { DOCUMENT, isPlatformBrowser } from '@angular/common'; +import { Injectable, PLATFORM_ID, computed, inject, signal } from '@angular/core'; + +const GA_MEASUREMENT_ID = 'G-6BXJ62W6G5'; +const ADSENSE_CLIENT = 'ca-pub-2438923752868254'; +const STORAGE_KEY = 'ac-consent'; + +export type ConsentChoice = 'granted' | 'denied'; + +declare global { + interface Window { + dataLayer?: unknown[]; + gtag?: (...args: unknown[]) => void; + } +} + +/** + * Cookie consent for the Google tags. Nothing from Google is requested until the + * visitor accepts: `index.html` only declares Consent Mode v2 defaults (all denied), + * and this service injects gtag.js and AdSense — and flips the signals to granted — + * once, on acceptance. The choice is remembered in `localStorage`. + */ +@Injectable({ providedIn: 'root' }) +export class Consent { + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + private readonly document = inject(DOCUMENT); + + private readonly choice = signal(null); + private tagsInjected = false; + + /** Null until the visitor has answered the banner. */ + readonly decision = this.choice.asReadonly(); + readonly granted = computed(() => this.choice() === 'granted'); + + /** The banner is browser-only: SSR must not render it into the cached HTML. */ + readonly bannerVisible = signal(false); + + constructor() { + if (!this.isBrowser) { + return; + } + const stored = this.read(); + this.choice.set(stored); + if (stored === 'granted') { + this.injectTags(); + } + this.bannerVisible.set(stored === null); + } + + accept(): void { + this.persist('granted'); + this.update('granted'); + this.injectTags(); + this.bannerVisible.set(false); + } + + reject(): void { + this.persist('denied'); + // The tags may already be loaded from an earlier "accept": tell them to stop + // using storage, and drop the cookies they set in the meantime. + this.update('denied'); + this.clearAnalyticsCookies(); + this.bannerVisible.set(false); + } + + /** Lets the visitor change their mind — wired to the "Cookie settings" footer link. */ + reopen(): void { + this.bannerVisible.set(true); + } + + private read(): ConsentChoice | null { + try { + const stored = localStorage.getItem(STORAGE_KEY); + return stored === 'granted' || stored === 'denied' ? stored : null; + } catch { + // Storage can be unavailable (private mode, blocked cookies): ask again. + return null; + } + } + + private persist(choice: ConsentChoice): void { + this.choice.set(choice); + try { + localStorage.setItem(STORAGE_KEY, choice); + } catch { + // The choice still applies to this page view, it just isn't remembered. + } + } + + private update(choice: ConsentChoice): void { + window.gtag?.('consent', 'update', { + ad_storage: choice, + ad_user_data: choice, + ad_personalization: choice, + analytics_storage: choice, + personalization_storage: choice, + }); + } + + private injectTags(): void { + if (this.tagsInjected) { + return; + } + this.tagsInjected = true; + + this.loadScript(`https://www.googletagmanager.com/gtag/js?id=${GA_MEASUREMENT_ID}`); + window.gtag?.('js', new Date()); + window.gtag?.('config', GA_MEASUREMENT_ID); + + const ads = this.loadScript( + `https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=${ADSENSE_CLIENT}`, + ); + ads.crossOrigin = 'anonymous'; + } + + private loadScript(src: string): HTMLScriptElement { + const script = this.document.createElement('script'); + script.async = true; + script.src = src; + this.document.head.appendChild(script); + return script; + } + + private clearAnalyticsCookies(): void { + const labels = location.hostname.split('.'); + // "www.example.com" -> ["www.example.com", "example.com"]: the tag writes on + // the registrable domain, which is not always the exact host. + const domains = labels + .map((_, index) => labels.slice(index).join('.')) + .filter((domain) => domain.includes('.')); + // Analytics (_ga, _gid) plus the AdSense cookies a previous "accept" allowed. + const scopes = [ + '', + ...domains.flatMap((domain) => [`; domain=${domain}`, `; domain=.${domain}`]), + ]; + + for (const cookie of this.document.cookie.split(';')) { + const name = cookie.split('=')[0].trim(); + if (!/^(_ga|_gid|_gac|_gcl|__gads)/.test(name)) { + continue; + } + for (const scope of scopes) { + this.document.cookie = `${name}=; Path=/; Max-Age=0${scope}`; + } + } + } +} diff --git a/website/src/app/doc.model.ts b/website/src/app/doc.model.ts new file mode 100644 index 000000000..c7f04ce01 --- /dev/null +++ b/website/src/app/doc.model.ts @@ -0,0 +1,61 @@ +export interface TocEntry { + id: string; + text: string; + depth: number; +} + +export interface VideoLink { + link: string; + alt?: string; + flag?: string; +} + +export type Difficulty = 'easy' | 'medium' | 'hard'; + +export interface DocAuthor { + name: string; + githubLogin?: string; + twitter?: string; + linkedin?: string; + youtube?: string; +} + +export interface Doc { + collection: 'guides' | 'challenges'; + category?: string; + categoryLabel?: string; + slug: string; + url: string; + title: string; + difficulty?: Difficulty; + description: string; + author?: DocAuthor; + contributors: string[]; + challengeNumber?: number; + command?: string; + blogLink?: string; + videoLinks?: VideoLink[]; + noComments?: boolean; + html: string; + toc: TocEntry[]; +} + +export interface NavItem { + title: string; + difficulty?: Difficulty; + url: string; + order: number; + description: string; + challengeNumber?: number; +} + +export interface NavGroup { + label: string; + category: string; + items: NavItem[]; +} + +export interface DocsManifest { + guides: NavItem[]; + challenges: NavGroup[]; +} diff --git a/website/src/app/layout/docs-layout.html b/website/src/app/layout/docs-layout.html new file mode 100644 index 000000000..a31e4e2de --- /dev/null +++ b/website/src/app/layout/docs-layout.html @@ -0,0 +1,131 @@ + + +
+ + + + @if (menuOpen()) { + + } + + +
+ +
+
diff --git a/website/src/app/layout/docs-layout.ts b/website/src/app/layout/docs-layout.ts new file mode 100644 index 000000000..df4ec392f --- /dev/null +++ b/website/src/app/layout/docs-layout.ts @@ -0,0 +1,56 @@ +import { Component, computed, inject, signal } from '@angular/core'; +import { NavigationEnd, Router, RouterLink, RouterLinkActive, RouterOutlet } from '@angular/router'; +import { toSignal } from '@angular/core/rxjs-interop'; +import { filter, map } from 'rxjs'; +import { MANIFEST } from '../generated/manifest'; +import { Consent } from '../consent'; +import { SiteHeader } from './site-header'; + +@Component({ + selector: 'app-docs-layout', + imports: [RouterOutlet, RouterLink, RouterLinkActive, SiteHeader], + templateUrl: './docs-layout.html', +}) +export class DocsLayout { + private readonly router = inject(Router); + + protected readonly consent = inject(Consent); + protected readonly manifest = MANIFEST; + protected readonly menuOpen = signal(false); + protected readonly query = signal(''); + + protected readonly currentUrl = toSignal( + this.router.events.pipe( + filter((e) => e instanceof NavigationEnd), + map((e) => e.urlAfterRedirects.split('#')[0].split('?')[0]), + ), + { initialValue: this.router.url.split('#')[0].split('?')[0] }, + ); + + protected readonly searchResults = computed(() => { + const q = this.query().trim().toLowerCase(); + if (q.length < 2) { + return []; + } + const all = [ + ...this.manifest.guides, + ...this.manifest.challenges.flatMap((g) => g.items), + ]; + return all + .filter( + (item) => + item.title.toLowerCase().includes(q) || + item.description.toLowerCase().includes(q), + ) + .slice(0, 10); + }); + + protected isCategoryOpen(category: string): boolean { + return this.currentUrl().startsWith(`/challenges/${category}`); + } + + protected closeMenu(): void { + this.menuOpen.set(false); + this.query.set(''); + } +} diff --git a/website/src/app/layout/site-header.html b/website/src/app/layout/site-header.html new file mode 100644 index 000000000..2d6c93892 --- /dev/null +++ b/website/src/app/layout/site-header.html @@ -0,0 +1,99 @@ +
+
+ + + + + +
+ @if (auth.me(); as me) { +
+ + +
+ } @else if (!auth.pending()) { + + Sign in + + } + + + + + + + + + + + + + + @if (stars(); as count) { + + {{ count }} + + } + + + + +
+
+
diff --git a/website/src/app/layout/site-header.ts b/website/src/app/layout/site-header.ts new file mode 100644 index 000000000..b1616185a --- /dev/null +++ b/website/src/app/layout/site-header.ts @@ -0,0 +1,31 @@ +import { Component, PLATFORM_ID, computed, inject, output } from '@angular/core'; +import { isPlatformBrowser } from '@angular/common'; +import { httpResource } from '@angular/common/http'; +import { RouterLink } from '@angular/router'; +import { Auth } from '../auth'; +import { Theme } from '../theme'; + +@Component({ + selector: 'app-site-header', + imports: [RouterLink], + templateUrl: './site-header.html', +}) +export class SiteHeader { + readonly menuToggled = output(); + protected readonly auth = inject(Auth); + protected readonly theme = inject(Theme); + + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + + private readonly statsResource = httpResource<{ stars: number }>(() => + this.isBrowser ? '/api/stats' : undefined, + ); + + protected readonly stars = computed(() => { + const stars = this.statsResource.value()?.stars; + if (!stars) { + return null; + } + return stars >= 1000 ? `${(stars / 1000).toFixed(1)}k` : `${stars}`; + }); +} diff --git a/website/src/app/pages/coming-soon/coming-soon.ts b/website/src/app/pages/coming-soon/coming-soon.ts new file mode 100644 index 000000000..63ed96e83 --- /dev/null +++ b/website/src/app/pages/coming-soon/coming-soon.ts @@ -0,0 +1,18 @@ +import { Component, input } from '@angular/core'; + +@Component({ + selector: 'app-coming-soon', + template: ` +
+

{{ title() }}

+

+ This page is being rebuilt and will land here soon. In the meantime it is still available on + the current docs site. +

+
+ `, +}) +export class ComingSoon { + readonly title = input.required(); + readonly fallback = input.required(); +} diff --git a/website/src/app/pages/docs/doc-page.html b/website/src/app/pages/docs/doc-page.html new file mode 100644 index 000000000..3a8460dd7 --- /dev/null +++ b/website/src/app/pages/docs/doc-page.html @@ -0,0 +1,168 @@ +
+
+ @if (doc().collection === 'challenges' && doc().challengeNumber) { +
+ + +
+ + {{ doc().categoryLabel }} + + + Challenge #{{ doc().challengeNumber }} + + @if (doc().difficulty; as difficulty) { + + + {{ difficulty }} + + } +
+ +

{{ doc().title }}

+ +
+ + + + + + Browse solutions + + @if (doc().blogLink; as blog) { + + + + + Blog post + + } + @for (video of doc().videoLinks ?? []; track video.link) { + + + + + Video + @if (videoFlag(video.flag); as flag) { + + } + + } +
+
+ } @else { +

{{ doc().title }}

+ } + +
+ + @if (npxCommand(); as command) { + + } + + @if (doc().author || doc().contributors.length > 0) { +
+
+ @if (doc().author; as author) { +
+ Author: + @if (author.githubLogin; as login) { + + + {{ author.name }} + + } @else { + {{ author.name }} + } +
+ } + @if (doc().contributors.length > 0) { +
+ Contributors: +
+ @for (contributor of doc().contributors; track contributor) { + + + + } +
+
+ } +
+
+ } + + @if (!doc().noComments) { + + } +
+ + + @if (doc().toc.length > 0) { + + } +
diff --git a/website/src/app/pages/docs/doc-page.ts b/website/src/app/pages/docs/doc-page.ts new file mode 100644 index 000000000..6bee6f330 --- /dev/null +++ b/website/src/app/pages/docs/doc-page.ts @@ -0,0 +1,65 @@ +import { Component, computed, effect, inject, input, signal } from '@angular/core'; +import { DomSanitizer, SafeHtml } from '@angular/platform-browser'; +import { Meta, Title } from '@angular/platform-browser'; +import { RouterLink } from '@angular/router'; +import { Doc } from '../../doc.model'; +import { Comments } from '../../shared/comments'; +import { TryChallenge } from './try-challenge'; + +@Component({ + selector: 'app-doc-page', + imports: [RouterLink, Comments, TryChallenge], + templateUrl: './doc-page.html', +}) +export class DocPage { + private readonly sanitizer = inject(DomSanitizer); + private readonly title = inject(Title); + private readonly meta = inject(Meta); + + /** Provided by the route resolver via component input binding. */ + readonly doc = input.required(); + + protected readonly html = computed(() => + this.sanitizer.bypassSecurityTrustHtml(this.doc().html), + ); + + protected readonly npxCommand = computed(() => + this.doc().command ? `npx nx serve ${this.doc().command}` : null, + ); + + protected readonly copied = signal(false); + + protected readonly difficultyClasses: Record = { + easy: 'bg-emerald-500/10 text-emerald-700 ring-1 ring-inset ring-emerald-500/30 dark:text-emerald-400', + medium: + 'bg-amber-500/10 text-amber-700 ring-1 ring-inset ring-amber-500/30 dark:text-amber-400', + hard: 'bg-rose-500/10 text-rose-700 ring-1 ring-inset ring-rose-500/30 dark:text-rose-400', + }; + + protected videoFlag(flag?: string): string | null { + return { FR: '🇫🇷', ES: '🇪🇸' }[flag ?? ''] ?? null; + } + + constructor() { + effect(() => { + const doc = this.doc(); + this.title.setTitle(`${doc.title} | Angular Challenges`); + this.meta.updateTag({ name: 'description', content: doc.description }); + this.meta.updateTag({ property: 'og:title', content: doc.title }); + this.meta.updateTag({ property: 'og:description', content: doc.description }); + }); + } + + protected copyCommand(): void { + const command = this.npxCommand(); + if (command) { + navigator.clipboard?.writeText(command); + this.copied.set(true); + setTimeout(() => this.copied.set(false), 2000); + } + } + + protected avatar(login: string): string { + return `https://github.com/${login}.png?size=64`; + } +} diff --git a/website/src/app/pages/docs/doc-resolver.ts b/website/src/app/pages/docs/doc-resolver.ts new file mode 100644 index 000000000..2e57824a2 --- /dev/null +++ b/website/src/app/pages/docs/doc-resolver.ts @@ -0,0 +1,20 @@ +import { ResolveFn, RedirectCommand, Router } from '@angular/router'; +import { inject } from '@angular/core'; +import { Doc } from '../../doc.model'; +import { CONTENT_MAP } from '../../generated/content-map'; + +export const docResolver: ResolveFn = async (route) => { + let segments = route.url.map((s) => s.path); + // Solution routes resolve the underlying challenge doc. + const solutionsIndex = segments.indexOf('solutions'); + if (solutionsIndex !== -1) { + segments = segments.slice(0, solutionsIndex); + } + const url = '/' + segments.join('/'); + const load = CONTENT_MAP[url.replace(/\/$/, '')]; + if (!load) { + const router = inject(Router); + return new RedirectCommand(router.parseUrl('/not-found'), { skipLocationChange: true }); + } + return load(); +}; diff --git a/website/src/app/pages/docs/try-challenge.html b/website/src/app/pages/docs/try-challenge.html new file mode 100644 index 000000000..3c1a0fa11 --- /dev/null +++ b/website/src/app/pages/docs/try-challenge.html @@ -0,0 +1,136 @@ + + +@if (open()) { +
+ +
+} diff --git a/website/src/app/pages/docs/try-challenge.ts b/website/src/app/pages/docs/try-challenge.ts new file mode 100644 index 000000000..254f1d2cb --- /dev/null +++ b/website/src/app/pages/docs/try-challenge.ts @@ -0,0 +1,33 @@ +import { Component, computed, input, signal } from '@angular/core'; +import { RouterLink } from '@angular/router'; +import { Doc } from '../../doc.model'; + +const UPSTREAM = 'tomalaforge/angular-challenges'; + +/** + * "Try this challenge" button + dialog: the ways to go from reading the doc + * to a running challenge — one-command CLI, manual setup guides, Codespaces. + */ +@Component({ + selector: 'app-try-challenge', + imports: [RouterLink], + templateUrl: './try-challenge.html', +}) +export class TryChallenge { + readonly doc = input.required(); + + protected readonly open = signal(false); + protected readonly copied = signal(false); + + protected readonly npxCommand = computed( + () => `npx angular-challenges@latest start ${this.doc().challengeNumber}`, + ); + + protected readonly codespacesUrl = `https://codespaces.new/${UPSTREAM}?quickstart=1`; + + protected copyCommand(): void { + navigator.clipboard?.writeText(this.npxCommand()); + this.copied.set(true); + setTimeout(() => this.copied.set(false), 2000); + } +} diff --git a/website/src/app/pages/landing/landing.html b/website/src/app/pages/landing/landing.html new file mode 100644 index 000000000..9b1940d61 --- /dev/null +++ b/website/src/app/pages/landing/landing.html @@ -0,0 +1,213 @@ +
+ + + + + + +
+
+
+ This project is sustained by its sponsors + @if (sponsors().length > 0) { + + @for (sponsor of sponsors(); track sponsor.login) { + + + + } + + } +
+ + + + + Become a sponsor + +
+
+ + +
+
+ +

+ + Free & open source — {{ challengeCount }}+ challenges and counting +

+

+ Start now and become an + Angular Expert +

+

+ Real-world challenges on Angular, Nx, RxJS, NgRx and TypeScript. + Solve them, browse community solutions and climb the leaderboard. +

+
+ + Get started + + + + + @if (latestChallengeUrl) { + + + + + Latest challenge + + } + + + + + Star on GitHub + +
+ + +
+
+
{{ challengeCount }}
+
Challenges
+
+
+
+ {{ statsResource.value()?.stars ?? '—' }} +
+
GitHub stars
+
+
+
+ {{ statsResource.value()?.forks ?? '—' }} +
+
Forks
+
+
+
+ + +
+ @for (card of cards; track card.title) { +
+
+ + @switch (card.icon) { + @case ('zap') { + + } + @case ('code') { + + } + @case ('branch') { + + } + @case ('users') { + + } + @case ('plus') { + + } + @case ('briefcase') { + + } + } + +
+

{{ card.title }}

+

{{ card.body }}

+
+ } +
+ + +
+ +

Never miss a new challenge

+

+ Subscribe to get notified when a new challenge lands. +

+
+
+
+
+ +
+
+ +
+
+
+
+
+
+ + + +
diff --git a/website/src/app/pages/landing/landing.ts b/website/src/app/pages/landing/landing.ts new file mode 100644 index 000000000..dff611248 --- /dev/null +++ b/website/src/app/pages/landing/landing.ts @@ -0,0 +1,93 @@ +import { + Component, + PLATFORM_ID, + afterNextRender, + computed, + inject, +} from '@angular/core'; +import { isPlatformBrowser } from '@angular/common'; +import { httpResource } from '@angular/common/http'; +import { RouterLink } from '@angular/router'; +import { MANIFEST } from '../../generated/manifest'; +import { Consent } from '../../consent'; +import { SiteHeader } from '../../layout/site-header'; + +interface Sponsor { + login: string; + avatar: string; +} + +@Component({ + selector: 'app-landing', + imports: [RouterLink, SiteHeader], + templateUrl: './landing.html', +}) +export class Landing { + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + + protected readonly consent = inject(Consent); + + protected readonly challengeCount = MANIFEST.challenges + .flatMap((g) => g.items) + .filter((i) => i.challengeNumber).length; + + protected readonly latestChallengeUrl = MANIFEST.challenges + .flatMap((g) => g.items) + .filter((i) => i.challengeNumber) + .sort((a, b) => (b.challengeNumber ?? 0) - (a.challengeNumber ?? 0))[0]?.url; + + protected readonly statsResource = httpResource<{ stars: number; forks: number }>(() => + this.isBrowser ? '/api/stats' : undefined, + ); + + protected readonly sponsorsResource = httpResource<{ sponsors: Sponsor[] }>(() => + this.isBrowser ? '/api/sponsors' : undefined, + ); + + protected readonly sponsors = computed( + () => this.sponsorsResource.value()?.sponsors ?? [], + ); + + protected readonly cards = [ + { + icon: 'zap', + title: `${this.challengeCount} Challenges`, + body: 'Real-life issues and specific features on Angular, Nx, RxJS, NgRx and TypeScript to elevate your skills.', + }, + { + icon: 'code', + title: 'Browse every solution', + body: 'Every community pull request is browsable right here — compare approaches with a side-by-side diff without leaving the site.', + }, + { + icon: 'branch', + title: 'Become an OSS maintainer', + body: 'These challenges lower the barrier to open source: you learn the fork/PR/review workflow used by every OSS project.', + }, + { + icon: 'users', + title: 'Learn alongside others', + body: 'Anyone can comment or offer assistance. Learning alone is great, but learning alongside others will get you further.', + }, + { + icon: 'plus', + title: 'Contribute', + body: 'An issue, an interesting bug, or an idea? Create your own challenge and get on the leaderboard.', + }, + { + icon: 'briefcase', + title: 'Prepare for interviews', + body: 'Completing these challenges gets you ready for the technical questions of your next Angular interview.', + }, + ]; + + constructor() { + // SendPulse newsletter embed script (same form as the previous site). + afterNextRender(() => { + const script = document.createElement('script'); + script.src = '//web.webformscr.com/apps/fc3/build/default-handler.js?1705909791474'; + script.async = true; + document.body.appendChild(script); + }); + } +} diff --git a/website/src/app/pages/leaderboard/leaderboard.html b/website/src/app/pages/leaderboard/leaderboard.html new file mode 100644 index 000000000..58bb07ea6 --- /dev/null +++ b/website/src/app/pages/leaderboard/leaderboard.html @@ -0,0 +1,46 @@ +
+

{{ config().title }}

+

+ {{ config().intro }} + guide. +

+ + @if (myPosition(); as position) { +
+ You are ranked #{{ position }} — + jump to my position +
+ } + + @if (boardResource.isLoading()) { +
+ @for (i of [1, 2, 3, 4, 5, 6, 7, 8]; track i) { +
+ } +
+ } @else if (boardResource.error()) { +
+ Could not load the leaderboard from GitHub right now — please try again in a few minutes. +
+ } @else { +
    + @for (entry of entries(); track entry.login) { +
  1. + + + {{ medal($index) ?? '#' + ($index + 1) }} + + + {{ entry.login }} + + {{ entry.count }} {{ config().unit }} + + +
    2. + } +
+ } +
diff --git a/website/src/app/pages/leaderboard/leaderboard.ts b/website/src/app/pages/leaderboard/leaderboard.ts new file mode 100644 index 000000000..82c02b303 --- /dev/null +++ b/website/src/app/pages/leaderboard/leaderboard.ts @@ -0,0 +1,74 @@ +import { Component, PLATFORM_ID, computed, effect, inject, input } from '@angular/core'; +import { isPlatformBrowser } from '@angular/common'; +import { httpResource } from '@angular/common/http'; +import { Title } from '@angular/platform-browser'; +import { RouterLink } from '@angular/router'; +import { Auth } from '../../auth'; + +interface LeaderboardEntry { + login: string; + avatar: string; + count: number; +} + +const BOARDS: Record = { + answers: { + title: 'Challenges answered', + unit: 'challenges solved', + intro: 'Join the list and start your Angular Challenges journey by reading the', + link: '/guides/getting-started', + }, + challenges: { + title: 'Challenges created', + unit: 'challenges created', + intro: 'A challenge is missing? Create your own one and get on the leaderboard — read the', + link: '/guides/create-challenge', + }, + commit: { + title: 'Contributions', + unit: 'contributions', + intro: 'Typos, docs, tooling — every contribution counts. Read the', + link: '/guides/contribute', + }, +}; + +@Component({ + selector: 'app-leaderboard', + imports: [RouterLink], + templateUrl: './leaderboard.html', +}) +export class Leaderboard { + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + private readonly title = inject(Title); + protected readonly auth = inject(Auth); + + /** Route param: answers | challenges | commit. */ + readonly board = input.required(); + + protected readonly config = computed(() => BOARDS[this.board()] ?? BOARDS['answers']); + + protected readonly boardResource = httpResource<{ entries: LeaderboardEntry[] }>(() => + this.isBrowser && BOARDS[this.board()] ? `/api/leaderboard/${this.board()}` : undefined, + ); + + protected readonly entries = computed(() => this.boardResource.value()?.entries ?? []); + + protected readonly myPosition = computed(() => { + const login = this.auth.me()?.login; + if (!login) { + return null; + } + const index = this.entries().findIndex((e) => e.login === login); + return index === -1 ? null : index + 1; + }); + + constructor() { + effect(() => { + this.title.setTitle(`${this.config().title} | Angular Challenges`); + }); + } + + protected medal(index: number): string | null { + return ['🥇', '🥈', '🥉'][index] ?? null; + } +} diff --git a/website/src/app/pages/not-found/not-found.ts b/website/src/app/pages/not-found/not-found.ts new file mode 100644 index 000000000..30a57b245 --- /dev/null +++ b/website/src/app/pages/not-found/not-found.ts @@ -0,0 +1,28 @@ +import { Component, inject } from '@angular/core'; +import { RESPONSE_INIT } from '@angular/core'; +import { RouterLink } from '@angular/router'; + +@Component({ + selector: 'app-not-found', + imports: [RouterLink], + template: ` +
+

404

+

This page could not be found.

+ + Back to home + +
+ `, +}) +export class NotFound { + constructor() { + const responseInit = inject(RESPONSE_INIT, { optional: true }); + if (responseInit) { + responseInit.status = 404; + } + } +} diff --git a/website/src/app/pages/solutions/diff-highlighter.ts b/website/src/app/pages/solutions/diff-highlighter.ts new file mode 100644 index 000000000..1f137aa99 --- /dev/null +++ b/website/src/app/pages/solutions/diff-highlighter.ts @@ -0,0 +1,99 @@ +import type { HighlighterCore } from 'shiki/core'; +import { DiffLine, Hunk } from './diff-parser'; + +/** Same themes as the build-time markdown highlighting (tools/generate-content.mjs). */ +const THEMES = { + light: 'github-light-default', + dark: 'github-dark-default', +} as const; + +/** Languages a solution diff can realistically contain. */ +export type DiffLanguage = + 'angular-ts' | 'angular-html' | 'javascript' | 'css' | 'scss' | 'json' | 'markdown' | 'yaml'; + +const LANG_BY_EXT: Record = { + ts: 'angular-ts', + html: 'angular-html', + js: 'javascript', + mjs: 'javascript', + css: 'css', + scss: 'scss', + json: 'json', + md: 'markdown', + yml: 'yaml', + yaml: 'yaml', +}; + +let highlighterPromise: Promise | null = null; + +/** + * Lazily builds a shiki highlighter with only the grammars a diff can need. + * Everything is dynamically imported so shiki stays out of the initial bundle. + */ +async function getHighlighter(): Promise { + highlighterPromise ??= (async () => { + const [{ createHighlighterCore }, { createJavaScriptRegexEngine }] = await Promise.all([ + import('shiki/core'), + import('shiki/engine/javascript'), + ]); + return createHighlighterCore({ + themes: [ + import('@shikijs/themes/github-light-default'), + import('@shikijs/themes/github-dark-default'), + ], + langs: [ + import('@shikijs/langs/angular-ts'), + import('@shikijs/langs/angular-html'), + import('@shikijs/langs/javascript'), + import('@shikijs/langs/css'), + import('@shikijs/langs/scss'), + import('@shikijs/langs/json'), + import('@shikijs/langs/markdown'), + import('@shikijs/langs/yaml'), + ], + engine: createJavaScriptRegexEngine({ forgiving: true }), + }); + })(); + return highlighterPromise; +} + +export function languageFor(filename: string): DiffLanguage | null { + const ext = filename.slice(filename.lastIndexOf('.') + 1).toLowerCase(); + return LANG_BY_EXT[ext] ?? null; +} + +/** + * Attaches syntax-highlighting tokens to every line of the given hunks. + * Each side of the diff (old = context + deletions, new = context + additions) + * is highlighted as one block so multi-line constructs keep their context. + */ +export async function highlightHunks(lang: DiffLanguage, hunks: Hunk[]): Promise { + const highlighter = await getHighlighter(); + for (const hunk of hunks) { + highlightSide( + highlighter, + lang, + hunk.lines.filter((line) => line.type !== 'add'), + ); + highlightSide( + highlighter, + lang, + hunk.lines.filter((line) => line.type !== 'del'), + ); + } +} + +function highlightSide(highlighter: HighlighterCore, lang: DiffLanguage, lines: DiffLine[]): void { + if (!lines.length) { + return; + } + const code = lines.map((line) => line.text).join('\n'); + const tokens = highlighter.codeToTokensWithThemes(code, { lang, themes: THEMES }); + lines.forEach((line, i) => { + line.tokens = (tokens[i] ?? []).map((token) => ({ + text: token.content, + light: token.variants['light']?.color, + dark: token.variants['dark']?.color, + })); + }); +} diff --git a/website/src/app/pages/solutions/diff-parser.ts b/website/src/app/pages/solutions/diff-parser.ts new file mode 100644 index 000000000..9b7d13c74 --- /dev/null +++ b/website/src/app/pages/solutions/diff-parser.ts @@ -0,0 +1,89 @@ +export interface DiffLine { + type: 'context' | 'add' | 'del'; + oldNum: number | null; + newNum: number | null; + text: string; + /** Syntax-highlighting tokens, attached asynchronously by diff-highlighter. */ + tokens?: { text: string; light?: string; dark?: string }[]; +} + +/** One visual row of a split (side-by-side) diff. */ +export interface SplitRow { + left: DiffLine | null; + right: DiffLine | null; +} + +export interface Hunk { + /** Unchanged lines skipped between the previous hunk and this one. */ + skipped: number; + lines: DiffLine[]; + rows: SplitRow[]; +} + +/** + * Parses a GitHub unified `patch` string into hunks with both a unified line + * list and paired split rows (deletions zipped with the additions that + * replace them, GitHub-style). + */ +export function parsePatch(patch: string): Hunk[] { + const hunks: Hunk[] = []; + let oldNum = 0; + let newNum = 0; + let previousOldEnd = 1; + let current: Hunk | null = null; + + for (const raw of patch.split('\n')) { + const header = raw.match(/^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/); + if (header) { + oldNum = Number(header[1]); + newNum = Number(header[3]); + current = { skipped: Math.max(0, oldNum - previousOldEnd), lines: [], rows: [] }; + previousOldEnd = oldNum + Number(header[2] ?? 1); + hunks.push(current); + continue; + } + if (!current || raw.startsWith('\\')) { + continue; // "\ No newline at end of file" + } + const text = raw.slice(1); + if (raw.startsWith('+')) { + current.lines.push({ type: 'add', oldNum: null, newNum: newNum++, text }); + } else if (raw.startsWith('-')) { + current.lines.push({ type: 'del', oldNum: oldNum++, newNum: null, text }); + } else { + current.lines.push({ type: 'context', oldNum: oldNum++, newNum: newNum++, text }); + } + } + + for (const hunk of hunks) { + hunk.rows = toSplitRows(hunk.lines); + } + return hunks; +} + +function toSplitRows(lines: DiffLine[]): SplitRow[] { + const rows: SplitRow[] = []; + let i = 0; + while (i < lines.length) { + const line = lines[i]; + if (line.type === 'context') { + rows.push({ left: line, right: line }); + i++; + continue; + } + // Collect a run of deletions followed by a run of additions and zip them. + const dels: DiffLine[] = []; + const adds: DiffLine[] = []; + while (i < lines.length && lines[i].type === 'del') { + dels.push(lines[i++]); + } + while (i < lines.length && lines[i].type === 'add') { + adds.push(lines[i++]); + } + const max = Math.max(dels.length, adds.length); + for (let j = 0; j < max; j++) { + rows.push({ left: dels[j] ?? null, right: adds[j] ?? null }); + } + } + return rows; +} diff --git a/website/src/app/pages/solutions/solution-diff.html b/website/src/app/pages/solutions/solution-diff.html new file mode 100644 index 000000000..10be2e03c --- /dev/null +++ b/website/src/app/pages/solutions/solution-diff.html @@ -0,0 +1,160 @@ +
+ + ← All solutions for {{ doc().title }} + + + @if (failed()) { +
+ Could not load this pull request from GitHub right now. + + Open it on GitHub + + or try again later. +
+ } @else if (!loaded()) { +
+
+
+
+ } @else { + + @if (meta(); as m) { +
+ +
+

{{ m.title }}

+

+ #{{ m.number }} by {{ m.login }} + · + @if (m.merged) { + merged + } @else { + {{ m.state }} + } + · {{ m.changedFiles }} files + +{{ m.additions }} + −{{ m.deletions }} +

+
+
+ +
+ + +
+ + View on GitHub + +
+
+ } + + +
+ @for (file of files(); track file.filename) { +
+
+ + @if (file.previousFilename) { + {{ file.previousFilename }} → + } + {{ file.filename }} + + @if (file.status === 'added') { + added + } @else if (file.status === 'removed') { + removed + } + + +{{ file.additions }} + −{{ file.deletions }} + +
+ + @if (!file.patch) { +

+ No text diff available for this file (binary or too large) — + view it on GitHub. +

+ } @else { +
+ + + @for (hunk of file.hunks; track $index) { + @if (hunk.skipped > 0) { + + + + } + @if (mode() === 'split') { + @for (row of hunk.rows; track $index) { + + + + + + + } + } @else { + @for (line of hunk.lines; track $index) { + + + + + + + } + } + } + +
⋯ {{ hunk.skipped }} unmodified lines
+ {{ row.left?.oldNum }} + @if (row.left; as l) {@if (l.tokens) {@for (t of l.tokens; track $index) {{{ t.text }}}} @else {{{ l.text }}}} + {{ row.right?.newNum }} + @if (row.right; as l) {@if (l.tokens) {@for (t of l.tokens; track $index) {{{ t.text }}}} @else {{{ l.text }}}}
{{ line.oldNum }} + {{ line.newNum }} + + {{ line.type === 'add' ? '+' : line.type === 'del' ? '−' : '' }} + @if (line.tokens) {@for (t of line.tokens; track $index) {{{ t.text }}}} @else {{{ line.text }}}
+
+ } +
+ } +
+ } +
diff --git a/website/src/app/pages/solutions/solution-diff.ts b/website/src/app/pages/solutions/solution-diff.ts new file mode 100644 index 000000000..e6fce6d6e --- /dev/null +++ b/website/src/app/pages/solutions/solution-diff.ts @@ -0,0 +1,151 @@ +import { + Component, + PLATFORM_ID, + computed, + effect, + inject, + input, + linkedSignal, + signal, + untracked, +} from '@angular/core'; +import { isPlatformBrowser } from '@angular/common'; +import { HttpClient, httpResource } from '@angular/common/http'; +import { Title } from '@angular/platform-browser'; +import { RouterLink } from '@angular/router'; +import { Auth } from '../../auth'; +import { Theme } from '../../theme'; +import { Doc } from '../../doc.model'; +import { PullFile, PullMeta } from './solution.model'; +import { Hunk, parsePatch } from './diff-parser'; +import { highlightHunks, languageFor } from './diff-highlighter'; + +interface FileView extends PullFile { + hunks: Hunk[]; +} + +@Component({ + selector: 'app-solution-diff', + imports: [RouterLink], + templateUrl: './solution-diff.html', +}) +export class SolutionDiff { + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + private readonly title = inject(Title); + private readonly http = inject(HttpClient); + protected readonly auth = inject(Auth); + protected readonly theme = inject(Theme); + protected readonly isDark = computed(() => this.theme.current() === 'dark'); + + /** Provided by the route resolver / router input binding. */ + readonly doc = input.required(); + readonly pr = input.required(); + + /** + * The component is reused when only `:pr` changes, so the reaction state is + * derived from `pr()` — it falls back to 'idle' for every new PR instead of + * keeping the previous one's 'done' (which would leave the button disabled). + */ + protected readonly reaction = linkedSignal({ + source: this.pr, + computation: () => 'idle', + }); + + /** 'split' on desktop, toggleable; unified is friendlier on mobile. */ + protected readonly mode = signal<'split' | 'unified'>( + this.isBrowser && window.matchMedia('(max-width: 639px)').matches ? 'unified' : 'split', + ); + + protected readonly metaResource = httpResource(() => + this.isBrowser ? `/api/pulls/${this.pr()}` : undefined, + ); + + protected readonly filesResource = httpResource<{ files: PullFile[] }>(() => + this.isBrowser ? `/api/pulls/${this.pr()}/files` : undefined, + ); + + protected readonly meta = computed(() => this.metaResource.value() ?? null); + + private readonly parsedFiles = computed(() => + (this.filesResource.value()?.files ?? []).map((file) => ({ + ...file, + hunks: file.patch ? parsePatch(file.patch) : [], + })), + ); + + /** Bumped once syntax-highlighting tokens have been attached to the parsed lines. */ + private readonly highlightVersion = signal(0); + + protected readonly files = computed(() => { + // Fresh array on every recompute: the lines are mutated in place by the + // highlighter, so an identical reference would be swallowed by the + // computed's Object.is equality check and never reach the template. + this.highlightVersion(); + return [...this.parsedFiles()]; + }); + + /** + * Both resources are disabled during SSR, so neither reports "loading" there. + * The template branches on this instead: it stays false until both responses + * arrive, which keeps the server HTML from rendering an empty diff. + */ + protected readonly loaded = computed( + () => this.metaResource.status() === 'resolved' && this.filesResource.status() === 'resolved', + ); + + protected readonly failed = computed( + () => !!this.metaResource.error() || !!this.filesResource.error(), + ); + + constructor() { + effect(() => { + const meta = this.meta(); + this.title.setTitle( + meta + ? `PR #${meta.number} by ${meta.login} — ${this.doc().title} | Angular Challenges` + : `Solution — ${this.doc().title} | Angular Challenges`, + ); + }); + + effect(() => { + const files = this.parsedFiles(); + if (this.isBrowser && files.length) { + untracked(() => this.highlightFiles(files)); + } + }); + } + + private async highlightFiles(files: FileView[]): Promise { + try { + for (const file of files) { + const lang = languageFor(file.filename); + if (lang) { + await highlightHunks(lang, file.hunks); + } + } + this.highlightVersion.update((v) => v + 1); + } catch { + // Highlighting is progressive enhancement — the plain-text diff stays readable. + } + } + + protected react(): void { + if (!this.auth.me()) { + location.href = this.auth.signInUrl(); + return; + } + const pr = this.pr(); + this.reaction.set('saving'); + this.http.post(`/api/pulls/${pr}/react`, {}).subscribe({ + // A response that lands after navigating to another PR must not touch its state. + next: () => this.settle(pr, 'done'), + error: () => this.settle(pr, 'error'), + }); + } + + private settle(pr: string, state: 'done' | 'error'): void { + if (this.pr() === pr) { + this.reaction.set(state); + } + } +} diff --git a/website/src/app/pages/solutions/solution.model.ts b/website/src/app/pages/solutions/solution.model.ts new file mode 100644 index 000000000..5ace2a04c --- /dev/null +++ b/website/src/app/pages/solutions/solution.model.ts @@ -0,0 +1,37 @@ +export interface Solution { + number: number; + title: string; + login: string; + avatar: string; + isAuthor: boolean; + state: 'open' | 'closed'; + merged: boolean; + thumbsUp: number; + comments: number; + createdAt: string; + htmlUrl: string; +} + +export interface PullMeta { + number: number; + title: string; + login: string; + avatar: string; + state: 'open' | 'closed'; + merged: boolean; + createdAt: string; + htmlUrl: string; + additions: number; + deletions: number; + changedFiles: number; +} + +export interface PullFile { + filename: string; + previousFilename?: string; + status: 'added' | 'removed' | 'modified' | 'renamed' | string; + additions: number; + deletions: number; + patch: string | null; + blobUrl: string; +} diff --git a/website/src/app/pages/solutions/solutions-list.html b/website/src/app/pages/solutions/solutions-list.html new file mode 100644 index 000000000..8feb4ed40 --- /dev/null +++ b/website/src/app/pages/solutions/solutions-list.html @@ -0,0 +1,78 @@ +
+ + ← {{ doc().title }} + +

Community solutions

+

+ Every pull request submitted for challenge #{{ doc().challengeNumber }} — click one to read + the full diff without leaving the site. +

+ + @if (solutionsResource.error()) { +
+ Could not load the solutions from GitHub right now. + View them on GitHub + or try again later. +
+ } @else if (!loaded()) { +
+ @for (i of [1, 2, 3, 4]; track i) { +
+ } +
+ } @else if (solutions().length === 0) { +
+ No solution submitted yet — be the first! + + How to submit yours + +
+ } @else { + +

+ Also available + on GitHub. +

+ } +
diff --git a/website/src/app/pages/solutions/solutions-list.ts b/website/src/app/pages/solutions/solutions-list.ts new file mode 100644 index 000000000..209944834 --- /dev/null +++ b/website/src/app/pages/solutions/solutions-list.ts @@ -0,0 +1,44 @@ +import { Component, PLATFORM_ID, computed, effect, inject, input } from '@angular/core'; +import { DatePipe, isPlatformBrowser } from '@angular/common'; +import { httpResource } from '@angular/common/http'; +import { Title } from '@angular/platform-browser'; +import { RouterLink } from '@angular/router'; +import { Doc } from '../../doc.model'; +import { Solution } from './solution.model'; + +@Component({ + selector: 'app-solutions-list', + imports: [RouterLink, DatePipe], + templateUrl: './solutions-list.html', +}) +export class SolutionsList { + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + private readonly title = inject(Title); + + /** Provided by the route resolver via component input binding. */ + readonly doc = input.required(); + + protected readonly solutionsResource = httpResource<{ solutions: Solution[] }>(() => + this.isBrowser ? `/api/challenges/${this.doc().challengeNumber}/solutions` : undefined, + ); + + protected readonly solutions = computed(() => this.solutionsResource.value()?.solutions ?? []); + + /** + * The resource is disabled during SSR, so it never reports "loading" there. + * Templates branch on this instead: it stays false until a response arrives, + * which keeps the server HTML from claiming that no solution exists. + */ + protected readonly loaded = computed(() => this.solutionsResource.status() === 'resolved'); + + protected readonly githubSearchUrl = computed( + () => + `https://github.com/tomalaforge/angular-challenges/pulls?q=label%3A${this.doc().challengeNumber}+label%3Aanswer`, + ); + + constructor() { + effect(() => { + this.title.setTitle(`Solutions — ${this.doc().title} | Angular Challenges`); + }); + } +} diff --git a/website/src/app/shared/comments.ts b/website/src/app/shared/comments.ts new file mode 100644 index 000000000..72d640b62 --- /dev/null +++ b/website/src/app/shared/comments.ts @@ -0,0 +1,63 @@ +import { + Component, + ElementRef, + PLATFORM_ID, + effect, + inject, + input, + viewChild, +} from '@angular/core'; +import { isPlatformBrowser } from '@angular/common'; +import { Theme } from '../theme'; + +/** giscus comment thread — same repo/category config as the previous docs site. */ +@Component({ + selector: 'app-comments', + template: ` +
+
+
+ `, +}) +export class Comments { + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + private readonly theme = inject(Theme); + private readonly host = viewChild.required>('host'); + + /** Changing term reloads the thread (component instance is reused across routes). */ + readonly term = input.required(); + + constructor() { + effect(() => { + this.term(); + if (!this.isBrowser) { + return; + } + const container = this.host().nativeElement; + container.innerHTML = ''; + const script = document.createElement('script'); + script.src = 'https://giscus.app/client.js'; + script.async = true; + script.crossOrigin = 'anonymous'; + const attrs: Record = { + 'data-repo': 'tomalaforge/angular-challenges', + 'data-repo-id': 'R_kgDOIXXIfw', + 'data-category': 'Announcements', + 'data-category-id': 'DIC_kwDOIXXIf84CSZF_', + 'data-mapping': 'specific', + 'data-term': this.term(), + 'data-strict': '0', + 'data-reactions-enabled': '1', + 'data-emit-metadata': '0', + 'data-input-position': 'bottom', + 'data-theme': this.theme.current(), + 'data-lang': 'en', + 'data-loading': 'lazy', + }; + for (const [key, value] of Object.entries(attrs)) { + script.setAttribute(key, value); + } + container.appendChild(script); + }); + } +} diff --git a/website/src/app/shared/consent-banner.html b/website/src/app/shared/consent-banner.html new file mode 100644 index 000000000..24a465c78 --- /dev/null +++ b/website/src/app/shared/consent-banner.html @@ -0,0 +1,56 @@ +@if (consent.bannerVisible()) { + + + + +} diff --git a/website/src/app/shared/consent-banner.ts b/website/src/app/shared/consent-banner.ts new file mode 100644 index 000000000..7027fdf8b --- /dev/null +++ b/website/src/app/shared/consent-banner.ts @@ -0,0 +1,11 @@ +import { ChangeDetectionStrategy, Component, inject } from '@angular/core'; +import { Consent } from '../consent'; + +@Component({ + selector: 'app-consent-banner', + templateUrl: './consent-banner.html', + changeDetection: ChangeDetectionStrategy.OnPush, +}) +export class ConsentBanner { + protected readonly consent = inject(Consent); +} diff --git a/website/src/app/theme.ts b/website/src/app/theme.ts new file mode 100644 index 000000000..619ce532a --- /dev/null +++ b/website/src/app/theme.ts @@ -0,0 +1,47 @@ +import { DOCUMENT, isPlatformBrowser } from '@angular/common'; +import { Injectable, PLATFORM_ID, effect, inject, signal } from '@angular/core'; + +const STORAGE_KEY = 'ac-theme'; + +export type ThemeName = 'light' | 'dark'; + +/** + * Light/dark mode. The inline script in index.html applies the same resolution + * (stored choice, then OS preference) before first paint to avoid a flash; + * this service takes over from there and persists explicit toggles. + */ +@Injectable({ providedIn: 'root' }) +export class Theme { + private readonly document = inject(DOCUMENT); + private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID)); + + readonly current = signal(this.initial()); + + constructor() { + effect(() => { + const theme = this.current(); + if (this.isBrowser) { + this.document.documentElement.classList.toggle('dark', theme === 'dark'); + } + }); + } + + toggle(): void { + const next: ThemeName = this.current() === 'dark' ? 'light' : 'dark'; + this.current.set(next); + if (this.isBrowser) { + localStorage.setItem(STORAGE_KEY, next); + } + } + + private initial(): ThemeName { + if (!this.isBrowser) { + return 'dark'; + } + const stored = localStorage.getItem(STORAGE_KEY); + if (stored === 'light' || stored === 'dark') { + return stored; + } + return matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark'; + } +} diff --git a/website/src/content/authors/Ioannis-Tsironis.json b/website/src/content/authors/Ioannis-Tsironis.json new file mode 100644 index 000000000..9cb257672 --- /dev/null +++ b/website/src/content/authors/Ioannis-Tsironis.json @@ -0,0 +1,5 @@ +{ + "name": "Ioannis Tsironis", + "github": "https://github.com/tsironis13", + "linkedin": "https://www.linkedin.com/in/giannis-tsironis/" +} diff --git a/website/src/content/authors/devesh-chaudhari.json b/website/src/content/authors/devesh-chaudhari.json new file mode 100644 index 000000000..c1bc4bfb4 --- /dev/null +++ b/website/src/content/authors/devesh-chaudhari.json @@ -0,0 +1,4 @@ +{ + "name": "Devesh Chaudhari", + "twitter": "https://twitter.com/DeveshChau" +} diff --git a/website/src/content/authors/lance-finney.json b/website/src/content/authors/lance-finney.json new file mode 100644 index 000000000..be44e3e89 --- /dev/null +++ b/website/src/content/authors/lance-finney.json @@ -0,0 +1,6 @@ +{ + "name": "Lance Finney", + "twitter": "https://twitter.com/LMFinneyCoder", + "linkedin": "https://www.linkedin.com/in/lmfinney/", + "github": "https://github.com/LMFinney" +} diff --git a/website/src/content/authors/stanislav-gavrilov.json b/website/src/content/authors/stanislav-gavrilov.json new file mode 100644 index 000000000..7fa793099 --- /dev/null +++ b/website/src/content/authors/stanislav-gavrilov.json @@ -0,0 +1,5 @@ +{ + "name": "Stanislav Gavrilov", + "linkedin": "https://www.linkedin.com/in/stgavrilov/", + "github": "https://github.com/stillst" +} diff --git a/website/src/content/authors/sven-brodny.json b/website/src/content/authors/sven-brodny.json new file mode 100644 index 000000000..3372743d8 --- /dev/null +++ b/website/src/content/authors/sven-brodny.json @@ -0,0 +1,5 @@ +{ + "name": "Sven Brodny", + "linkedin": "https://www.linkedin.com/in/sven-brodny-0ba603237/", + "github": "https://github.com/svenson95" +} diff --git a/website/src/content/authors/thomas-laforge.json b/website/src/content/authors/thomas-laforge.json new file mode 100644 index 000000000..2bfd96588 --- /dev/null +++ b/website/src/content/authors/thomas-laforge.json @@ -0,0 +1,6 @@ +{ + "name": "Thomas Laforge", + "twitter": "https://twitter.com/laforge_toma", + "linkedin": "https://www.linkedin.com/in/thomas-laforge-2b05a945/", + "github": "https://github.com/tomalaforge" +} diff --git a/website/src/content/authors/timothy-alcaide.json b/website/src/content/authors/timothy-alcaide.json new file mode 100644 index 000000000..a50cd7643 --- /dev/null +++ b/website/src/content/authors/timothy-alcaide.json @@ -0,0 +1,7 @@ +{ + "name": "Timothy Alcaide", + "github": "https://github.com/alcaidio", + "youtube": "https://www.youtube.com/@timothyalcaide", + "twitter": "https://twitter.com/alcaidio", + "linkedin": "https://www.linkedin.com/in/timothyalcaide" +} diff --git a/website/src/content/authors/wandrille-guesdon.json b/website/src/content/authors/wandrille-guesdon.json new file mode 100644 index 000000000..a240cba89 --- /dev/null +++ b/website/src/content/authors/wandrille-guesdon.json @@ -0,0 +1,5 @@ +{ + "name": "Wandrille Guesdon", + "linkedin": "https://www.linkedin.com/in/wandrille-guesdon-53a54684/", + "github": "https://github.com/wandri" +} diff --git a/website/src/content/challenges/angular/1-projection.md b/website/src/content/challenges/angular/1-projection.md new file mode 100644 index 000000000..127530f03 --- /dev/null +++ b/website/src/content/challenges/angular/1-projection.md @@ -0,0 +1,51 @@ +--- +title: 🟢 Projection +description: Challenge 1 is about learning how to project DOM element through components +author: thomas-laforge +contributors: + - tomalaforge + - jdegand + - dmmishchenko + - kabrunko-dev + - svenson95 +challengeNumber: 1 +command: angular-projection +blogLink: https://medium.com/@thomas.laforge/create-a-highly-customizable-component-cc3a9805e4c5 +videoLinks: + - link: https://www.youtube.com/watch?v=npyEyUZxoIw&ab_channel=ArthurLannelucq + alt: Projection video by Arthur Lannelucq + flag: FR + - link: https://www.youtube.com/watch?v=yNrfvu7vTa4 + alt: Projection video by Amos Lucian Isaila + flag: ES +sidebar: + order: 1 +--- + +## Information + +In Angular, content projection is a powerful technique for creating highly customizable components. Utilizing and understanding the concepts of ng-content and ngTemplateOutlet can significantly enhance your ability to create shareable components. + +You can learn all about ng-content [here](https://angular.dev/guide/components/content-projection) from simple projection to more complex ones. + +To learn about ngTemplateOutlet, you can find the API documentation [here](https://angular.dev/api/common/NgTemplateOutlet) along with some basic examples. + +With these two tools in hand, you are now ready to take on the challenge. + +## Statement + +You will start with a fully functional application that includes a dashboard containing a teacher card and a student card. The goal is to implement the city card. + +While the application works, the developer experience is far from being optimal. Every time you need to implement a new card, you have to modify the `card.component.ts`. In real-life projects, this component can be shared among many applications. The goal of the challenge is to create a `CardComponent` that can be customized without any modifications. Once you've created this component, you can begin implementing the `CityCardComponent` and ensure you are not touching the `CardComponent`. + +## Constraints + +- You must refactor the `CardComponent` and `ListItemComponent`. +- The `@for` must be declared and remain inside the `CardComponent`. You might be tempted to move it to the `ParentCardComponent` like `TeacherCardComponent`. +- `CardComponent` should not contain any conditions. +- CSS: try to avoid using `::ng-deep`. Find a better way to handle CSS styling. + +## Bonus Challenges + +- Use the signal API to manage your components state (documentation [here](https://angular.dev/guide/signals)) +- To reference the template, use a directive instead of magic strings ([What is wrong with magic strings?](https://softwareengineering.stackexchange.com/a/365344)) diff --git a/website/src/content/challenges/angular/10-utility-wrapper-pipe.md b/website/src/content/challenges/angular/10-utility-wrapper-pipe.md new file mode 100644 index 000000000..f74bb1612 --- /dev/null +++ b/website/src/content/challenges/angular/10-utility-wrapper-pipe.md @@ -0,0 +1,39 @@ +--- +title: 🔴 Utility Wrapper Pipe +description: Challenge 10 is about creating a pipe to wrap utilities +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - LMFinney +challengeNumber: 10 +command: angular-utility-wrapper-pipe +sidebar: + order: 202 +--- + +## Information + +This is the third of three `@Pipe()` challenges. The goal of this series is to master **pipes** in Angular. + +Pipes are a very powerful way to transform data in your template. The difference between calling a function and a pipe is that pure pipes are memoized. So, they won't be recalculated every change detection cycle if their inputs haven't changed. + +Pipes are designed to be efficient and optimized for performance. They use change detection mechanisms to only recalculate the value if the input changes, to minimize unnecessary calculations and improve rendering performance. + +By default, a pipe is pure. You should be aware that setting `pure` to false is prone to be inefficient, because it increases the amount of rerenders. + +:::note +A **pure** pipe is only called when the value changes.\ +A **impure** pipe is called every change detection cycle. +::: + +There are some useful predefined pipes like the DatePipe, UpperCasePipe and CurrencyPipe. To learn more about pipes in Angular, check the API documentation [here](https://angular.dev/guide/pipes). + +## Statement + +In this exercise, you want to access utils functions. Currently, you cannot access them directly from your template. The goal is to create a specific pipe for this utils file, where you will need to pass the name of the function you want to call and the needed arguments. + +## Constraints + +- Must be strongly typed diff --git a/website/src/content/challenges/angular/13-highly-customizable-css.md b/website/src/content/challenges/angular/13-highly-customizable-css.md new file mode 100644 index 000000000..b08786ea3 --- /dev/null +++ b/website/src/content/challenges/angular/13-highly-customizable-css.md @@ -0,0 +1,24 @@ +--- +title: 🟠 Highly Customizable CSS +description: Challenge 13 is about creating highly customizable CSS styles +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - kabrunko-dev + - LMFinney +challengeNumber: 13 +command: angular-highly-customizable-css +sidebar: + order: 104 +--- + +## Information + +Styling is an important aspect of a frontend developer's day job, but it is often underestimated. In Angular applications, I frequently see people using `@Input()` to customize the style of their components. However, `@Input()` should only be used for logic. Other techniques, such as **CSS variables** and **host-context**, should be used for styling. + +In this challenge, you will need to use both CSS variables and `:host-context` to remove all `@Input()` from your code. + +## Constraints + +- In your final submission, your component should not contain any lines of code. All styling should be handled within the decorator _(or external css files if you prefer)_ diff --git a/website/src/content/challenges/angular/16-master-dependency-injection.md b/website/src/content/challenges/angular/16-master-dependency-injection.md new file mode 100644 index 000000000..caf99bd90 --- /dev/null +++ b/website/src/content/challenges/angular/16-master-dependency-injection.md @@ -0,0 +1,30 @@ +--- +title: 🔴 Master Dependency Injection +description: Challenge 16 is about mastering how dependancy injection works +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - kabrunko-dev +challengeNumber: 16 +command: angular-master-dependency-injection +sidebar: + order: 203 +--- + +## Information + +To successfully complete this challenge, you will need to have a good understanding of how [Dependency Injection](https://angular.dev/guide/di/dependency-injection) works inside Angular. + +The goal is to provide the `CurrencyService` at the row level, so that each row displays the correct currency. Currently, the `CurrencyService` is only provided at the table level, which results in an error as the same currency is displayed for each row, despite each product having a different currency. + +One way to achieve this is by adding a second argument to the pipe, but this is not allowed for this challenge. + +## Statement + +- Your task is to display the correct currency for each row. + +## Constraints + +- You cannot modify the pipe. +- You cannot wrap the row inside a component, as this will break the layout. diff --git a/website/src/content/challenges/angular/21-anchor-navigation.md b/website/src/content/challenges/angular/21-anchor-navigation.md new file mode 100644 index 000000000..f094023b8 --- /dev/null +++ b/website/src/content/challenges/angular/21-anchor-navigation.md @@ -0,0 +1,21 @@ +--- +title: 🟢 Anchor Navigation +description: Challenge 21 is about navigating inside the page with anchor +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 +challengeNumber: 21 +command: angular-anchor-navigation +sidebar: + order: 4 +--- + +## Information + +You begin with an application that has basic navigation and anchor navigation in the `HomeComponent`. However, using `href` recreates the path each time and refreshes the page. + +## Statement + +- Your task is to refactor this application to use the built-in navigation tool to better fit within the Angular Framework. You can explore the router, but it's better to stay within the template and use the `RouterLink` directive. +- To improve the user experience, add smooth scrolling. diff --git a/website/src/content/challenges/angular/22-router-input.md b/website/src/content/challenges/angular/22-router-input.md new file mode 100644 index 000000000..1a5127e89 --- /dev/null +++ b/website/src/content/challenges/angular/22-router-input.md @@ -0,0 +1,31 @@ +--- +title: 🟢 @RouterInput() +description: Challenge 22 is about using the @Input decorator to retrieve router params. +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - LMFinney +challengeNumber: 22 +command: angular-router-input +blogLink: https://medium.com/ngconf/accessing-route-params-in-angular-1f8e12770617 +sidebar: + order: 5 +--- + +## Information + +In this application, we retrieve three pieces of information inside our `TestComponent` provided by the router: + +- We want to retrieve `testId` found inside the params of the URL. +- We want to obtain `user` located within the query parameters of the URL. +- We want to access `permission` set inside the `data` object of the route. + +In Angular versions 15 or earlier, we use `ActivatedRoute` to obtain all this information and receive them through observables to listen for URL changes. + +In version 16, Angular introduced a new `Input` that can listen to route data. You can read more about it [here](https://medium.com/ngconf/accessing-route-params-in-angular-1f8e12770617). + +## Statement + +The goal of this exercise is to refactor the code to use the new `RouterInput` strategy. diff --git a/website/src/content/challenges/angular/31-module-to-standalone.md b/website/src/content/challenges/angular/31-module-to-standalone.md new file mode 100644 index 000000000..93b0850ef --- /dev/null +++ b/website/src/content/challenges/angular/31-module-to-standalone.md @@ -0,0 +1,29 @@ +--- +title: 🟢 Module to Standalone +description: Challenge 31 is about migrating a module based application to a standalone application. +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 31 +command: angular-module-to-standalone +sidebar: + order: 6 +--- + +## Information + +In v14, standalone components were released and made stable in v15. If you haven't played with them, it's never too late. You can try them out in this challenge. + +Moreover, the goal is to see how **Nx** and **standalone components** work together, and experience the process of decoupling your app with Nx lib and standalone components. + +Finally, standalone components are very simple to understand, but **routing/lazy-loaded components** can be a bit harder to grasp. This challenge will allow you to manipulate components at different levels of nesting and work with lazy loaded routes. + +After completing this challenge, standalone components will no longer hold any secrets for you. + +## Statement + +The goal of this challenge is to migrate your application from module based components to standalone components. + +## Note + +You can also test the [Angular schematic](https://angular.dev/reference/migrations/standalone) to migrate NgModule to Standalone components. _(Since we are using nx, start your command with nx instead of ng)_ diff --git a/website/src/content/challenges/angular/32-change-detection-bug.md b/website/src/content/challenges/angular/32-change-detection-bug.md new file mode 100644 index 000000000..633d41721 --- /dev/null +++ b/website/src/content/challenges/angular/32-change-detection-bug.md @@ -0,0 +1,46 @@ +--- +title: 🟠 Change Detection Bug +description: Challenge 32 is about debugging an application that has issue when change detection is triggered +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - jdegand + - LMFinney +challengeNumber: 32 +command: angular-change-detection-bug +blogLink: https://medium.com/ngconf/function-calls-inside-template-are-dangerous-15f9822a6629 +sidebar: + order: 105 +--- + +:::note +This challenge is inspired by a real-life example that I simplified to create this nice challenge. +::: + +## Information + +In this small application, we have a navigation menu to route our application to either `BarComponent` or `FooComponent`. However, our application is not loading and no errors are displayed inside the console. + +## Statement + +The goal of the challenge is to debug this application and make it work. + +:::note +Without knowing the exact reason for the issue, you can "fix" the error and get the program to function. One such approach would be to memoize `getMenu`. The application might work again, but make sure you really understand the problem and its consequences. Making it work isn't always enough; fixing this bug in the wrong way can cause a loss of performance or lead to other problems later on. +::: + +## Hints + +
+ Hint 1 + + If you comment out `routerLinkActive="isSelected"` inside `NavigationComponent`, the application loads correctly. +
+ +
+ Hint 2 + +If you open the [`RouterLinkActive` source code](https://github.com/angular/angular/blob/main/packages/router/src/directives/router_link_active.ts) and go to **line 196**, Angular is calling `this.cdr.markForCheck` inside a microTask, which triggers a new CD cycle. If you comment out this line, the application loads again, however, the bug should not be fixed by changing the Angular source code. 😅😯 + +
diff --git a/website/src/content/challenges/angular/33-decoupling-components.md b/website/src/content/challenges/angular/33-decoupling-components.md new file mode 100644 index 000000000..2b900c7a6 --- /dev/null +++ b/website/src/content/challenges/angular/33-decoupling-components.md @@ -0,0 +1,35 @@ +--- +title: 🟠 Decoupling Components +description: Challenge 33 is about decoupling two strongly coupled components using Injection Token +author: thomas-laforge +contributors: + - tomalaforge + - jdegand + - LMFinney +challengeNumber: 33 +command: angular-decoupling-components +sidebar: + order: 106 +--- + +> Big thanks to **Robin Goetz** and his [Spartan Project](https://github.com/goetzrobin/spartan). +> This challenge was proposed by Robin and is strongly inspired by his project. + +## Information + +The goal of this challenge is to separate the behavior of a component from its style. For the purpose of this challenge, we will be working on a button element. When we click on it, we will toggle a _disabled_ property which will change the style of the element. This is quite useless in real life but the challenge aims to demonstrate a useful concept. + +The behavior of the component (referred to as the _brain_ in the Spartan stack) is located in the brain library. The styling part (referred to as the _helmet_) is located inside the helmet library. Both libraries cannot depend on each other because we want to be able to publish them separately. To help us address the issue, we are using the Nx `enforce-module-boundaries` eslint rule. You can find more details [here](https://nx.dev/core-features/enforce-module-boundaries). + +However, the button's helmet needs to access the state of the component to style the button differently based on its state. As mentioned above, we cannot import the `BtnDisabledDirective` directly into the helmet library as done currently. If you go to [`BtnHelmetDirective`](../../libs/decoupling/helmet/src/lib/btn-style.directive.ts), you will encounter a linting error. **A project tagged with `type:hlm` can only depend on libs tagged with `type:core`**. + +## Statement + +The goal of this challenge is to find a way to decouple both Directives. + +### Hint + +
+ Hint 1 + Carefully read the title of the challenge 😇 +
diff --git a/website/src/content/challenges/angular/39-injection-token.md b/website/src/content/challenges/angular/39-injection-token.md new file mode 100644 index 000000000..4e2f3119d --- /dev/null +++ b/website/src/content/challenges/angular/39-injection-token.md @@ -0,0 +1,38 @@ +--- +title: 🟠 InjectionToken +description: Challenge 39 is about learning the power of dependency injection +author: thomas-laforge +contributors: + - tomalaforge + - jdegand + - LMFinney +challengeNumber: 39 +command: angular-injection-token +videoLinks: + - link: https://www.youtube.com/watch?v=ntggdQycFyc + alt: Injection Token by Arthur Lannelucq + flag: FR +sidebar: + order: 118 +--- + +## Information + +In this small application, we start with a `VideoComponent` containing a **1-second** timer. The development team decided to use a global constant to store the timer value: `DEFAULT_TIMER`. However, a few weeks later, the product team wants to add a new screen for phone calls called `PhoneComponent`, and we want to reuse the `TimerComponent`. However, the product team wants a timer of **2 seconds**. How can we achieve this? + +## Statement + +Currently, the timer is still 1 second for the `PhoneComponent`. The goal of this challenge is to change the timer value to 2 seconds for the `PhoneComponent`. + +## Constraints + +The use of `@Input` is forbidden. This example is basic, and using `@Input` could be a good option, but in more complex applications, the component we need to update can be deeply nested, making the use of `@Input` a really bad design. + +## Hint + +
+ Hint 1 + +Looking at this [blog post](https://itnext.io/stop-being-scared-of-injectiontokens-ab22f72f0fe9) can be of great help. + +
diff --git a/website/src/content/challenges/angular/4-typed-context-outlet.md b/website/src/content/challenges/angular/4-typed-context-outlet.md new file mode 100644 index 000000000..86d43e5f1 --- /dev/null +++ b/website/src/content/challenges/angular/4-typed-context-outlet.md @@ -0,0 +1,46 @@ +--- +title: 🔴 Typed ContextOutlet +description: Challenge 4 is about strongly typing ngContextOutlet directives +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - jdegand + - LMFinney +challengeNumber: 4 +command: angular-typed-context-outlet +blogLink: https://medium.com/@thomas.laforge/ngtemplateoutlet-type-checking-5d2dcb07a2c6 +sidebar: + order: 201 +--- + +## Information + +You can improve template type checking for custom directives by adding template guard properties to your directive definition. Angular offers the static function [`ngTemplateContextGuard`](https://angular.dev/guide/directives/structural-directives#improving-template-type-checking-for-custom-directives) to strongly type structural directives. + +However, the context of **NgTemplateOutlet** type is **Object**. But with the help of the above guard, we can improve that behavior. + +## Statement + +In this exercise, we want to learn how to strongly type our `ng-template` in our `AppComponent`. + +This exercise has two levels of complexity. + +### Level 1: Known Interface + +Currently, we have the following piece of code. + +![Unknown Person](../../../../assets/4/unknown-person.png 'Unknown Person') + +As we can see, `name` is of type `any`. We want to infer the correct type using the custom directive `PersonDirective`. + +### Level 2: Generic Interface + +Currently, we have the following piece of code. + +![Unknown Student](../../../../assets/4/unknown-student.png 'Unknown Student') + +As we can see, `student` is of type `any`. We want to infer the correct type using the custom directive `ListDirective`. + +But in this part, we want to pass a list of **any object** to `ListComponent`. And we still want the correct type to be inferred. diff --git a/website/src/content/challenges/angular/44-view-transition.md b/website/src/content/challenges/angular/44-view-transition.md new file mode 100644 index 000000000..e760863a8 --- /dev/null +++ b/website/src/content/challenges/angular/44-view-transition.md @@ -0,0 +1,87 @@ +--- +title: 🔴 View Transition +description: Challenge 44 is about learning the new view transition animation API +author: thomas-laforge +contributors: + - tomalaforge + - jdegand + - LMFinney +challengeNumber: 44 +command: angular-view-transition +sidebar: + order: 208 +--- + +## Information + +This is the second of two animation challenges. The goal of this series is to master animations in Angular. + +The View Transition API is a brand-new API that provides a set of features that allow developers to control and manipulate the transitions and animations between views within an application. +It plays a pivotal role in enhancing the user experience (UX), bringing applications to life with engaging and captivating transitions to guide users through different pages or sections of the app. + +The goal of this challenge is to learn about and manipulate all types of transitions proposed by the API. + +To use the API, Angular provides a function `withViewTransitions()` that needs to be injected inside the router config. + +I would advise you to read the [Chrome documentation](https://developer.chrome.com/docs/web-platform/view-transitions). You will learn everything that is necessary to successfully complete the challenge. + +Here, however, is a short summary: +Firstly, each target DOM element has two states: an `old` one when the element is leaving the page, and a `new` one when it's entering the page: + +```css +::view-transition-old(root) { +/ / animation +} + +::view-transition-new(root) { +/ / animation +} +``` + +In order to target a specific element, you must add the selector `view-transition-name` to a CSS class on the DOM node, as shown below: + +```css +.specific-element { + view-transition-name: specific-element; +} +``` + +This allows you to create an animation for this element only. + +Lastly, if the same element is present in both views, you can automate the transition by assigning the same **transition name**. + +:::danger +Remember, a page can use as many different `view-transition-name` values as you need, but +each name must identify only ONE rendered element per view. The same name is what pairs the +old and the new instance of an element; if two elements share it in the same view, the +transition is aborted. +::: + +## Statement + +The goal of this challenge is to transition from the state shown in this video: + + + +To the final state shown in the following video: + + + +Observe the following: + +- The header slides in and out. +- Each element smoothly transitions to its new location. + +### Level 1 + +Focus only on the first thumbnail and create a seamless and pleasing transition. + +### Level 2 + +Create the same appealing transition for all thumbnails without duplicating the `view-transition-name`. Note that this page has only 3 thumbnails; in a real-life scenario, you could have significantly more. + +### Level 3 + +Shift to the correct Y location when navigating back and forth. diff --git a/website/src/content/challenges/angular/45-react-in-angular.md b/website/src/content/challenges/angular/45-react-in-angular.md new file mode 100644 index 000000000..6feea1c60 --- /dev/null +++ b/website/src/content/challenges/angular/45-react-in-angular.md @@ -0,0 +1,81 @@ +--- +title: 🔴 React in angular +description: Challenge 45 is about learning how to benefit from the numerous libraries in React +author: wandrille-guesdon +contributors: + - wandri + - tomalaforge + - jdegand + - LMFinney +challengeNumber: 45 +command: angular-react-in-angular +sidebar: + order: 209 +--- + +The goal of this challenge is to use a React component inside an Angular application. + +Many components are available in React, and it can be interesting to use them in an Angular application. The goal is to create a React component and use it in an Angular application. + +## Information + +In this challenge, we have a simple application and a React component `ReactPost` in `app/react` to illustrate a React component from a library. + +## Statement + +- Your task is to display the posts with the React component `ReactPost`. +- When you select a post, the post should be highlighted. + +In order to play with the React component, you should start by installing the React dependencies. + +```bash +pnpm add react react-dom +pnpm add -D @types/react @types/react-dom +``` + +## Constraints + +- Do not transform the React component into an Angular component. The React component is pretty simple and can be written with ease in Angular. But **the goal is to use the React component**. + +### Hint + +
+ Hint 1 - Configuration + Allow the React files in tsconfig.json + +``` +{ +... +"compilerOptions": { + ... + "jsx": "react" +}, +... +} +``` + +
+ +
+ Hint 2 - Initialization + Create a React root with `createRoot(...)` +
+ +
+ Hint 3 - Display + To render the component, it should look like this: + + ``` + .render( + + ... + + ) + ``` + +
+ +
+ Hint 4 - Design + Do not forget to allow the React file in Tailwind. +
diff --git a/website/src/content/challenges/angular/46-simple-animations.md b/website/src/content/challenges/angular/46-simple-animations.md new file mode 100644 index 000000000..aa8887977 --- /dev/null +++ b/website/src/content/challenges/angular/46-simple-animations.md @@ -0,0 +1,49 @@ +--- +title: 🟢 Simple Animations +description: Challenge 46 is about learning Angular's integrated animation API +author: sven-brodny +contributors: + - svenson95 + - LMFinney +challengeNumber: 46 +command: angular-simple-animations +sidebar: + order: 17 +--- + +## Information + +This is the first of two animation challenges. The goal of this series is to master animations in Angular. + +Well-designed animations can make your application more fun and straightforward to use, but they aren't just cosmetic. Animations can improve your application and user experience in a number of ways: + +- Without animations, web page transitions can seem abrupt and jarring. +- Motion greatly enhances the user experience, so animations give users a chance to detect the application's response to their actions. +- Good animations intuitively call the user's attention to where it is needed. + +I would recommend you read the [official documentation](https://angular.dev/guide/animations). You will learn everything that is necessary to successfully complete the challenge. + +Otherwise, look at this [working example](https://svenson95.github.io/ng-xmp-animations/) and [git repo](https://github.com/svenson95/ng-xmp-animations) to get inspired. + +## Statement + +The goal of this challenge is to add animations, they should run when the user arrives on the page or reload the page. + +## Constraints + +- Don't use any CSS and utilize Angular's integrated `@angular/animations` API. +- Don't trigger the animations with a button like in the examples, rather when the user enter or reload the page. + +### Level 1 + +Add a fading or moving animation for the paragraphs on the left side. + + + +### Level 2 + +Add a stagger animation for the list on the right side. + + diff --git a/website/src/content/challenges/angular/5-crud-application.md b/website/src/content/challenges/angular/5-crud-application.md new file mode 100644 index 000000000..fb403ef1c --- /dev/null +++ b/website/src/content/challenges/angular/5-crud-application.md @@ -0,0 +1,58 @@ +--- +title: 🟢 Crud application +description: Challenge 5 is about refactoring a crud application +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - jdegand + - LMFinney +challengeNumber: 5 +command: angular-crud-application +sidebar: + order: 2 +--- + +## Information + +Communicating and having a global/local state in sync with your backend is the heart of any application. You will need to master these following best practises to build strong and reliable Angular Applications. + +## Statement + +In this exercise, you have a small CRUD application, which get a list of TODOS, update and delete some todos. + +Currently, we have a working example but filled with lots of bad practices. + +### Step 1: refactor with best practices + +What you will need to do: + +- Avoid **any** as a type. Using Interface to leverage Typescript type system prevent errors +- Use a **separate service** for all your http calls and use a **Signal** for your todoList +- Don't **mutate** data + +```typescript +// Avoid this +this.todos[todoUpdated.id - 1] = todoUpdated; + +// Prefer something like this: an immutable update that keeps the original order +this.todoList.update((todos) => + todos.map((todo) => (todo.id === todoUpdated.id ? todoUpdated : todo)), +); +``` + +### Step 2: Improve + +- Add a **Delete** button: _Doc of fake API_ +- Handle **errors** correctly. _(Globally)_ +- Add a Global **loading** indicator. _You can use MatProgressSpinnerModule_ + +### Step 3: Maintainability!! add some test + +- Add 2/3 tests + +### Step 4: Awesomeness!!! master your state. + +- Use the **component store of ngrx**, **ngrx/store**, **rxAngular**, **tanstack-query** or **ngrx/signal-store** as a local state of your component. +- Have a **localized** Loading/Error indicator, e.g. only on the Todo being processed and **disable** all buttons of the processed Todo. _(Hint: you will need to create an ItemComponent)_ diff --git a/website/src/content/challenges/angular/52-lazy-load-component.md b/website/src/content/challenges/angular/52-lazy-load-component.md new file mode 100644 index 000000000..f71c57d48 --- /dev/null +++ b/website/src/content/challenges/angular/52-lazy-load-component.md @@ -0,0 +1,48 @@ +--- +title: 🟢 Lazy Load a Component +description: Challenge 52 is about understanding how to lazy load a component in Angular. +author: lance-finney +contributors: + - LMFinney +challengeNumber: 52 +command: angular-lazy-load-component +sidebar: + order: 21 +--- + +## Information + +Angular has long had route-based lazy loading for entire modules, but lazy loading individual components was much more complicated. This challenge is about understanding how to lazy load a component easily with a feature that was introduced in Angular 17. + +## Statement + +This is a simple application that can display a `TopComponent` that we are pretending would slow the application down if it were part of the initial bundle (it actually contains just a bit of text, but we are pretending). + +The current implementation shows a `PlaceholderComponent` until the user clicks a button to display the `TopComponent`. However, even though the `TopComponent` isn't visible until the button is clicked, it is still loaded as part of the initial bundle. + +Use a new feature of Angular 17 to lazy load the `TopComponent` so that it is visible _and loaded_ when the user clicks the button to display it. + +When you are done, you should be able to see the `TopComponent` being loaded into the browser in a separate bundle when you click the button to display it. In Chrome, you should see this by opening the DevTools, going to the Network tab, and then clicking the button to display the `TopComponent`. + +## Hints + +
+ Hint 1 + +You should be able to remove the `topLoaded` signal when you are done. + +
+ +
+ Hint 2 + +The new Angular feature will hide the `TopComponent` from view, but it will still be loaded in the initial bundle unless you change how both `AppComponent` and `TopComponent` are defined in their decorators. This challenge start with the old `NgModule`-based architecture, but you will need to change it to use the new feature. + +
+ +
+ Hint 3 + +The new feature is [Deferrable Views](https://angular.dev/guide/defer), which provides several different triggers. One of them is ideal for this challenge. + +
diff --git a/website/src/content/challenges/angular/55-back-button-navigation.md b/website/src/content/challenges/angular/55-back-button-navigation.md new file mode 100644 index 000000000..3ad3f0568 --- /dev/null +++ b/website/src/content/challenges/angular/55-back-button-navigation.md @@ -0,0 +1,56 @@ +--- +title: 🟠 Back-Button-Navigation +description: Challenge 55 is about overriding browser back button navigation +author: ioannis-tsironis +contributors: + - tsironis13 +challengeNumber: 55 +command: angular-back-button-navigation +sidebar: + order: 123 +--- + +## Information + +The goal of this challenge is to override the default behavior of the browser back button in Angular applications. + +We have been prompted by the team's PO to provide a specific implementation when displaying dialog components and +native browser back button is clicked. Currently, Angular's default behavior when the native back button is clicked is +to remove the current history entry and go back to the previous route. + +The initial state of the application is as follows: +When any dialog is displayed and the back button is clicked, any opened dialog is closed, and the app redirects to the previous page. + +This behavior should be changed according to these requirements: + +1. The requirements dictate a few different behaviors depending on which type of dialog is currently visible. +2. For example, we have a simple + action dialog that should be closed on the back button click, but we **MUST** remain on the current visited route (/simple-action). +3. In addition, we have sensitive dialogs like the one on the '/sensitive-action' page that must open a confirmation dialog on a back button click. +4. The confirmation dialog in combination with the back button click should behave like the simple dialog action one; the confirmation dialog must be closed, and we must remain on the '/sensitive-action' page with the initial dialog still visible. + +## Statement + +Provide an abstract, generic approach to handling any type of dialog behavior when the native browser back button is clicked. +Some Typescript design patterns, in combination with the Angular features, could be utilized to support this kind of infrastructure. + +## Constraints + +- The implementation must not be static depending on the 2 dialog type behaviors presenting on this challenge but also scalable to support any + new behavior requirements may arise in the future. + +### Hint + +
+ Hint 1 + +Use the `CanDeactivate` functional guard + +
+ +
+ Hint 2 + +Material Design dialog documentation can be found [here](https://material.angular.io/components/dialog/overview) + +
diff --git a/website/src/content/challenges/angular/57-content-projection-default.md b/website/src/content/challenges/angular/57-content-projection-default.md new file mode 100644 index 000000000..68bc9454a --- /dev/null +++ b/website/src/content/challenges/angular/57-content-projection-default.md @@ -0,0 +1,36 @@ +--- +title: 🟢 Content Projection Default +description: Challenge 57 is about content projection default container +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 57 +command: angular-content-projection-default +sidebar: + order: 22 +--- + +## Information + +Content projection in Angular allows developers to create flexible and customizable components by passing content from the parent component to the child component dynamically using ``. + +Currently, we have a shared component that relies on `input` properties to receive and display data. However, we want to improve its flexibility by replacing all `inputs` with content projection while maintaining the same appearance and behavior. + +## Statement + +Your task is to refactor the existing shared component to remove all `input` properties and instead use Angular’s `` for content projection. After your modifications, the application should look and function exactly as before, but without any `input`. + +### Steps to complete: + +- Identify all `input` properties in the shared component. +- Remove them and replace them with appropriate `` containers. +- Adjust the parent component to pass the necessary content using content projection instead of binding to `input`s. +- Ensure that the application still displays the same UI and behavior after the changes. + +## Constraints + +- You must not use any `input` in the shared component. +- The application’s UI and functionality must remain unchanged after the refactoring. +- You must use `` for content projection. +- Do not introduce additional properties or services to pass data. +- Ensure that projected content is correctly styled and positioned as before. diff --git a/website/src/content/challenges/angular/58-content-projection-condition.md b/website/src/content/challenges/angular/58-content-projection-condition.md new file mode 100644 index 000000000..7dead94de --- /dev/null +++ b/website/src/content/challenges/angular/58-content-projection-condition.md @@ -0,0 +1,38 @@ +--- +title: 🟠 Content Projection Condition +description: Challenge 58 is about conditional content projection in Angular +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 58 +command: angular-content-projection-condition +sidebar: + order: 124 +--- + +## Information + +Content projection in Angular allows you to create flexible and reusable components by dynamically inserting content from a parent component using ``. However, debugging content projection issues can sometimes be tricky. + +In this challenge, we have a `CardComponent` that supports a small mode, which conditionally changes how the projected content is displayed. However, there is a bug: when `small` is `false`, the card does not render properly. + +Your task is to identify and fix this issue without adding `inputs` while ensuring that the intended behavior remains unchanged. + +## Statement + +Your goal is to fix the issue where the `CardComponent` does not render when `small` is `false`. + +## Steps to complete: + +- Analyze how the `small` property is used inside the template. +- Identify why the content is not displayed when `small` is `false`. +- Modify the component to ensure that both cases (`small` = `true` and `small` = `false`) work as expected, while keeping the same structure and behavior. +- Ensure that no new `input` properties are introduced in the component. + +## Constraints + +- You must not add any new `input` properties. +- The expected UI and behavior must remain unchanged. +- The `@if` directive must be correctly handled to ensure content projection works. +- Do not introduce additional services or state management solutions. +- The fix should be minimal and focused on resolving the rendering issue. diff --git a/website/src/content/challenges/angular/59-content-projection-defer.md b/website/src/content/challenges/angular/59-content-projection-defer.md new file mode 100644 index 000000000..32b4e0114 --- /dev/null +++ b/website/src/content/challenges/angular/59-content-projection-defer.md @@ -0,0 +1,27 @@ +--- +title: 🔴 content-projection-defer +description: Challenge 59 is about deferring fetching data +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 59 +command: angular-content-projection-defer +sidebar: + order: 212 +--- + +# Challenge: Deferred Loading for Expandable Card Content + +## Information + +Within the application, specifically on page2, there is an expandable card component. This component consists of a permanently visible title and a content section that is hidden until the card is expanded. This content section is populated with a list of posts retrieved via a backend API call. The current implementation presents an issue: upon navigating to page2, although the card defaults to a collapsed state, the API call to load the list of posts is triggered immediately during the page load process, before the user has chosen to expand the card and view the content. + +## Statement + +The goal of this challenge is to optimize the data loading behavior for the expandable card component on `page2`. Modify the implementation so that the backend API call to fetch the list of posts is **deferred**. The data should **only** be fetched when the user explicitly interacts with the card to **expand** it. No data fetching for the post list should occur upon the initial load of `page2` while the card remains collapsed. + +## Constraints + +- The expandable card must retain its core functionality: display a title, be initially collapsed (on `page2` load), and expand/collapse upon user interaction. +- When the card is expanded, the list of posts must be fetched from the backend and displayed within the content area. +- The data fetching mechanism itself (e.g., the API endpoint) should not be changed, only _when_ it is triggered. diff --git a/website/src/content/challenges/angular/6-structural-directive.md b/website/src/content/challenges/angular/6-structural-directive.md new file mode 100644 index 000000000..48cae6f56 --- /dev/null +++ b/website/src/content/challenges/angular/6-structural-directive.md @@ -0,0 +1,63 @@ +--- +title: 🟠 Structural Directive +description: Challenge 6 is about creating a structural directive to handle permissions +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - kabrunko-dev + - svenson95 +challengeNumber: 6 +command: angular-structural-directive +blogLink: https://medium.com/@thomas.laforge/create-a-custom-structural-directive-to-manage-permissions-like-a-pro-11a1acad30ad +sidebar: + order: 102 +--- + +## Information + +Structural directives are directives which change the DOM layout by adding and removing DOM elements. This is an important concept you'll need to improve your angular skills and knowledge. This will be the first part of this challenge. For more information check out the [official documentation](https://angular.dev/guide/directives/structural-directives). + +Guards like `CanActivate` or `CanMatch` are also very important, since you'll need it in the most application's you build. If you're not very familiar with route guards, check out this two articles. + +- [Everything you need to know about route Guard in Angular](https://itnext.io/everything-you-need-to-know-about-route-guard-in-angular-697a062d3198) +- [Create a route Guard to manage permissions](https://medium.com/@thomas.laforge/create-a-route-guard-to-manage-permissions-26f16cc9a1ca) + +## Statement + +In `LoginComponent` you'll find 6 buttons corresponding to 6 different user's role. + +- Admin +- Manager +- Reader +- Writer +- Reader and Writer +- Client +- Everyone + +## Step 1 + +In `InformationComponent` you'll need to display the correct piece of information for each role using a structural directive. + +### Constraints + +- No `ngIf` or `@if` inside `InformationComponent`. +- Importing the store inside `InformationComponent` is not allowed. + +You should end up with something like below: + +```html +
Info for Role1
+``` + +```html +
Info for Role1 and Role2
+``` + +```html +
Info Only for superadmin
+``` + +## Step 2 + +In `Routes.ts` you should route all users to the correct `DashboardComponent` using `CanMatch` guard. diff --git a/website/src/content/challenges/angular/60-async-redirect.md b/website/src/content/challenges/angular/60-async-redirect.md new file mode 100644 index 000000000..dcaabfd2b --- /dev/null +++ b/website/src/content/challenges/angular/60-async-redirect.md @@ -0,0 +1,22 @@ +--- +title: 🟢 async-redirect +description: Challenge 60 is about using the new `redirectTo` function in Angular Router to modernize navigation logic. +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 60 +command: angular-async-redirect +sidebar: + order: 23 +--- + +## Statement + +In this challenge, you are working with an Angular application that currently uses a custom `navigate` method in `dashboard.ts` to handle route changes. With the introduction of the new `redirectTo` function in the Angular Router in v20, the goal is to modernize the codebase by removing the old `navigate` method and refactoring the application to use `redirectTo` for all redirection logic. + +Your task is to: + +- Locate and delete the `navigate` method in `dashboard.ts`. +- Refactor the application to use the new `redirectTo` function from the Angular Router wherever navigation is required. + +This will help ensure the application leverages the latest Angular routing features and maintains best practices for navigation and redirection. diff --git a/website/src/content/challenges/angular/8-pure-pipe.md b/website/src/content/challenges/angular/8-pure-pipe.md new file mode 100644 index 000000000..c981cda55 --- /dev/null +++ b/website/src/content/challenges/angular/8-pure-pipe.md @@ -0,0 +1,41 @@ +--- +title: 🟢 Pure Pipe +description: Challenge 8 is about creating a pure pipe +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - kabrunko-dev + - svenson95 + - LMFinney +challengeNumber: 8 +command: angular-pure-pipe +blogLink: https://medium.com/ngconf/deep-dive-into-angular-pipes-c040588cd15d +sidebar: + order: 3 +--- + +## Information + +This is the first of three `@Pipe()` challenges. The goal of this series is to master **pipes** in Angular. + +Pipes are a very powerful way to transform data in your template. The difference between calling a function and a pipe is that pure pipes are memoized. So, they won't be recalculated every change detection cycle if their inputs haven't changed. + +Pipes are designed to be efficient and optimized for performance. They use change detection mechanisms to only recalculate the value if the input changes, to minimize unnecessary calculations and improve rendering performance. + +By default, a pipe is pure. You should be aware that setting `pure` to false is prone to be inefficient, because it increases the amount of rerenders. + +:::note +A **pure** pipe is only called when the value changes.\ +A **impure** pipe is called every change detection cycle. +::: + +There are some useful predefined pipes like the DatePipe, UpperCasePipe and CurrencyPipe. To learn more about pipes in Angular, check the API documentation [here](https://angular.dev/guide/pipes). + +## Statement + +In this exercise, you need to refactor a transform function inside a component, which is called inside your template. The goal is to convert this function to a pipe. + +## Constraints + +- Must be strongly typed diff --git a/website/src/content/challenges/angular/9-wrap-function-pipe.md b/website/src/content/challenges/angular/9-wrap-function-pipe.md new file mode 100644 index 000000000..5213fb079 --- /dev/null +++ b/website/src/content/challenges/angular/9-wrap-function-pipe.md @@ -0,0 +1,42 @@ +--- +title: 🟠 Wrap Function Pipe +description: Challenge 9 is about creating a pipe to wrap component fonctions +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - kabrunko-dev + - svenson95 + - LMFinney +challengeNumber: 9 +command: angular-wrap-function-pipe +blogLink: https://medium.com/ngconf/boost-your-apps-performance-by-wrapping-your-functions-inside-a-pipe-7e889a901d1d +sidebar: + order: 103 +--- + +## Information + +This is the second of three `@Pipe()` challenges. The goal of this series is to master **pipes** in Angular. + +Pipes are a very powerful way to transform data in your template. The difference between calling a function and a pipe is that pure pipes are memoized. So, they won't be recalculated every change detection cycle if their inputs haven't changed. + +Pipes are designed to be efficient and optimized for performance. They use change detection mechanisms to only recalculate the value if the input changes, to minimize unnecessary calculations and improve rendering performance. + +By default, a pipe is pure. You should be aware that setting `pure` to false is prone to be inefficient, because it increases the amount of rerenders. + +:::note +A **pure** pipe is only called when the value changes.\ +A **impure** pipe is called every change detection cycle. +::: + +There are some useful predefined pipes like the DatePipe, UpperCasePipe and CurrencyPipe. To learn more about pipes in Angular, check the API documentation [here](https://angular.dev/guide/pipes). + +## Statement + +In this exercise, you are calling multiple functions inside your template. You can create a specific pipe for each of the functions, but this will be too cumbersome. +The goal is to create a `wrapFn` pipe to wrap your callback function through a pipe. Your function MUST remain inside your component. **`WrapFn` must be highly reusable.** + +## Constraints + +- Must be strongly typed diff --git a/website/src/content/challenges/forms/41-control-value-accessor.md b/website/src/content/challenges/forms/41-control-value-accessor.md new file mode 100644 index 000000000..738daf1e1 --- /dev/null +++ b/website/src/content/challenges/forms/41-control-value-accessor.md @@ -0,0 +1,43 @@ +--- +title: 🟠 Control Value Accessor +description: Challenge 41 is about creating a custom form control that implements Control Value Accessor interface. +author: stanislav-gavrilov +contributors: + - stillst +challengeNumber: 41 +command: forms-control-value-accessor +sidebar: + order: 101 +--- + +## Information + +In this challenge, the goal is to create a custom form field that is using the Form API of Angular `ControlValueAccessor`. You can find the documentation [here](https://angular.dev/api/forms/ControlValueAccessor). This interface is crucial for creating custom form controls that can interact seamlessly with Angular's forms API. + +## Statement + +The primary goal is to use control in the `feedbackForm` to eliminate the need for using `@Output` to retrieve the value and inject it into the `FormGroup`. +Additionally, you are required to integrate validation for the new control to ensure that rating data exist. (The form submission button should be disabled if the form is invalid). + +Currently, rating is coded this way: + +```html + +``` + +```ts +rating: string | null = null; + +onFormSubmit(): void { + this.feedBackSubmit.emit({ + ...this.feedbackForm.value, + rating: this.rating, // not inside the FormGroup and no validation + }); +} +``` + +The goal is to include rating into the `FormGroup` + +```html + +``` diff --git a/website/src/content/challenges/forms/48-avoid-losing-form-data.md b/website/src/content/challenges/forms/48-avoid-losing-form-data.md new file mode 100644 index 000000000..843f4b716 --- /dev/null +++ b/website/src/content/challenges/forms/48-avoid-losing-form-data.md @@ -0,0 +1,41 @@ +--- +title: 🟠 Avoid losing form data +description: Challenge 48 is about Bob 🧙‍♂️ the product owner, he wants to develop a new feature in response to customer complaints about losing form input information. +author: timothy-alcaide +contributors: + - alcaidio + - svenson95 + - LMFinney +challengeNumber: 48 +command: forms-avoid-losing-form-data +sidebar: + order: 121 +--- + +## Context + +As a member of the development team, you need to address a specific request from the product owner, 🧙‍♂️ Bob. He wants to develop a new feature in response to customer complaints about losing form input information. + +## User Story + +Here's the feature expressed as a user story with a functional expectation: + +> As a user, I would like to have an alert dialog box that appears when +> I attempt to navigate away from the page, after I have started +> entering information into the form. + +## Acceptance Criteria + +1. If one of the form fields is not empty and the user tries to navigate to a **different route inside the app**, show your own alert dialog to _avoid losing form data_. +2. If the user reloads the page, closes the tab, or leaves the document, the browser's native confirmation prompt must be triggered instead — a custom dialog cannot be rendered at that point. +3. The content of `dialog.component.ts` must be used for the in-app alert. +4. The appearance and behavior of the alert dialog box must comply with W3C conventions, see [alert dialog pattern](https://www.w3.org/WAI/ARIA/apg/patterns/alertdialog/). +5. Maximize the use of the new concepts and syntax in the latest version of Angular. + +
+ Tips 🤫 (if you really need it and after careful consideration) +
    +
  • Use the Material CDK Dialog or Overlay - don't forget to add @import '@angular/cdk/overlay-prebuilt.css' in styles.css
    • +
  • Use the CanDeactivate guard in the new functional approach for in-app navigation, and the beforeunload event for reloads and tab closes.
    • +
+
diff --git a/website/src/content/challenges/forms/61-simplest-signal-form.md b/website/src/content/challenges/forms/61-simplest-signal-form.md new file mode 100644 index 000000000..f2fda4208 --- /dev/null +++ b/website/src/content/challenges/forms/61-simplest-signal-form.md @@ -0,0 +1,58 @@ +--- +title: 🟢 Simplest Signal Form +description: Challenge 61 is about migrating from Reactive Forms to the new Signal-based Forms API in Angular +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 61 +command: forms-simplest-signal-form +sidebar: + order: 24 +--- + +## Information + +Angular has introduced a new way to work with forms using Signals. This modern approach provides better type safety, reactivity, and a more intuitive API compared to traditional Reactive Forms. You can find more information about Signal-based forms in the [Angular documentation](https://angular.dev/guide/forms). + +In this challenge, you will learn how to migrate a simple form from Reactive Forms (`FormControl` and `FormGroup`) to the new Signal-based Forms API. + +## Statement + +The application currently contains a simple form built with Reactive Forms using `FormControl` and `FormGroup`. The form includes the following fields: + +- **Name** (required) +- **Last Name** (optional) +- **Age** (must be between 1 and 99) +- **Note** (optional) + +Your goal is to **refactor this form to use Angular's new Signal-based Forms API** while maintaining the same functionality and validation rules. + +### Current Implementation + +The form currently uses: + +- `FormGroup` to group form controls +- `FormControl` for individual fields +- `Validators` for validation rules +- `ReactiveFormsModule` for form directives + +### Expected Result + +After completing the challenge, your form should: + +- Use Signal-based form instead of `FormControl` and `FormGroup` +- Maintain all existing validation rules +- Keep the same UI and user experience +- Display validation errors appropriately +- Submit and reset functionality should work as before +- **All existing tests should continue to pass** when running `nx test forms-simplest-signal-form` + +:::tip[TDD Approach] +You can run tests in watch mode to refactor using Test-Driven Development (TDD): + +```bash +nx test forms-simplest-signal-form +``` + +This will re-run tests automatically as you make changes, helping you ensure all tests continue to pass during your refactoring. +::: diff --git a/website/src/content/challenges/forms/62-crossfield-validation-signal-form.md b/website/src/content/challenges/forms/62-crossfield-validation-signal-form.md new file mode 100644 index 000000000..25c314036 --- /dev/null +++ b/website/src/content/challenges/forms/62-crossfield-validation-signal-form.md @@ -0,0 +1,92 @@ +--- +title: 🟢 Crossfield Validation with Signal Forms +description: Challenge 62 is about implementing crossfield validation using Angular Signal Forms where one field's validation depends on another field's value +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 62 +command: forms-crossfield-validation-signal-form +sidebar: + order: 25 +--- + +## Information + +Crossfield validation is a common requirement in forms where the validity of one field depends on the value of another field. For example: + +- Password confirmation must match the password field +- End date must be after start date +- Conditional required fields based on another field's value + +Angular Signal Forms provides powerful tools to implement crossfield validation using custom validators. This challenge will teach you how to create custom validators that access multiple form controls and update validation dynamically. + +You can learn more about form validation in the [Angular Forms documentation](https://angular.dev/guide/forms/reactive-forms#validating-form-input). + +## Statement + +The application contains a registration form built with Angular Reactive Forms (`FormGroup` and `FormControl`). The form includes the following fields: + +- **Email** (required, must be a valid email) +- **Password** (required, minimum 6 characters) +- **Confirm Password** (required, must match the password field) 🔗 +- **Start Date** (required) +- **End Date** (required, must be after start date) 🔗 + +The 🔗 symbol indicates fields with crossfield validation that depend on other fields. + +### Current Implementation + +The form currently uses: + +- `FormGroup` to group form controls +- `FormControl` for individual fields +- `Validators` for basic validation rules +- **Custom crossfield validators** for password matching and date range validation +- `ReactiveFormsModule` for form directives + +### Key Features Demonstrated + +1. **Password Match Validator**: A custom validator that checks if the confirm password matches the password field +2. **Date Range Validator**: A custom validator that ensures the end date is after the start date +3. **Dynamic Validation Updates**: When the password or start date changes, the dependent fields are automatically re-validated + +### Challenge Goal + +Your goal is to **understand how crossfield validation works** and then **migrate this form to use Angular's new Signal-based Forms API** while maintaining all the crossfield validation logic. + +### What You'll Learn + +- How to create custom validators that access multiple form controls +- How to implement crossfield validation in Reactive Forms +- How to dynamically re-validate fields when their dependencies change +- How to migrate crossfield validation to Signal-based forms + +### Expected Result + +After completing the challenge, your form should: + +- Use Signal-based forms instead of `FormControl` and `FormGroup` +- Maintain all existing crossfield validation rules +- Keep the same UI and user experience +- Display validation errors appropriately for crossfield validations +- Submit and reset functionality should work as before +- Ensure that when the password field changes, the confirm password is re-validated +- Ensure that when the start date changes, the end date is re-validated + +:::tip[TDD Approach] +You can run tests in watch mode to refactor using Test-Driven Development (TDD): + +```bash +nx test forms-crossfield-validation-signal-form +``` + +This will re-run tests automatically as you make changes, helping you ensure all functionality works correctly during your migration. +::: + +## Constraints + +- You must use only Signal-based forms (no `FormGroup` or `FormControl`) +- All crossfield validation logic must be preserved +- The password confirmation must update its validation when the password changes +- The end date must update its validation when the start date changes +- All existing tests must pass diff --git a/website/src/content/challenges/forms/63-child-forms.md b/website/src/content/challenges/forms/63-child-forms.md new file mode 100644 index 000000000..2fe1f6afb --- /dev/null +++ b/website/src/content/challenges/forms/63-child-forms.md @@ -0,0 +1,63 @@ +--- +title: 🟠 Child Forms +description: Refactor the checkout form to Signal-based forms with reusable address component and shared validators +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 63 +command: forms-child-forms +sidebar: + order: 125 +--- + +## Information + +You already built a checkout form with Reactive Forms (FormGroup / FormControl). Now you will refactor it to **Signal-based forms** while keeping the UX, validations, and billing toggle behavior. + +You can learn more about Signal-based forms in the [Angular documentation](https://angular.dev/guide/forms/signals-based-forms). + +## Statement + +The application contains a single-page checkout form with the following fields: + +- **Last name** (required) +- **First name** (required) +- **Shipping address**: street, ZIP code, city (all required) +- **Billing address**: street, ZIP code, city (all required when visible) +- **Billing address same as shipping** toggle + +Current behavior: + +- When the toggle is on, billing is hidden and disabled. +- When toggling on, the billing form copies the current shipping values. +- Submit marks all controls touched and prevents submission when invalid. +- Error hints show when a control is invalid and touched/dirty. + +### Goal + +Refactor the form to **Signal-based forms** and extract reusable pieces: + +1. Migrate all controls to Signal-based forms, preserving validation and submit behavior. +2. Create a reusable **AddressFormComponent** for street/ZIP/city. +3. Define a shared **custom validator schema** for the address group and reuse it for shipping and billing. +4. Keep the toggle behavior (copy shipping to billing, disable billing when same-as-shipping is true). +5. Preserve the UI and Tailwind styling. + +## Constraints + +- Use Signal-based forms only (no `FormGroup` / `FormControl`). +- Keep the same validations (all fields required, billing required when visible). +- Use a shared address validator schema applied to both shipping and billing subforms. +- Move address fields into a standalone `AddressFormComponent` +- Maintain the preview and status text. +- All existing tests must pass. + +:::tip[TDD Approach] +You can run tests in watch mode to refactor using Test-Driven Development (TDD): + +```bash +nx test forms-child-forms +``` + +This will re-run tests automatically as you make changes, helping you ensure all functionality works correctly during your migration. +::: diff --git a/website/src/content/challenges/forms/64-form-array.md b/website/src/content/challenges/forms/64-form-array.md new file mode 100644 index 000000000..79cd95df8 --- /dev/null +++ b/website/src/content/challenges/forms/64-form-array.md @@ -0,0 +1,70 @@ +--- +title: 🟠 Form Array +description: Challenge 64 is about building dynamic lists with FormArray and migrating the form to Signal-based forms +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 64 +command: forms-form-array +sidebar: + order: 126 +--- + +## Information + +You already built a registration form with Reactive Forms (FormGroup / FormControl / FormArray). Now you will refactor it to **Signal-based forms** while keeping the UX, validations, and dynamic add/remove behavior. + +You can learn more about Signal-based forms in the [Angular documentation](https://angular.dev/guide/forms/signals-based-forms). + +## Statement + +The application contains a single-page registration form with: + +- **Name** (required) +- **Pseudo** (required) +- **Contacts** (FormArray) + - First name (required) + - Last name (required) + - Relation (required) + - Email (required, valid email) +- **Emails** (FormArray) + - Type (required) + - Email (required, valid email) + +Current behavior: + +- Users can add or remove contacts and emails. +- Submit marks all controls as touched and blocks submission when the form is invalid. +- Validation errors appear when fields are touched/dirty or after submitting. +- Submitted data is displayed as JSON after a successful submission. + +### Challenge Goal + +Refactor the form to **Signal-based forms** while preserving the UI, validations, and dynamic FormArray behavior. + +### Expected Result + +After completing the challenge, your form should: + +- Use Signal-based forms instead of `FormGroup`, `FormControl`, and `FormArray`. +- Keep the same validation rules for all fields. +- Preserve add/remove behavior for contacts and emails. +- Keep the submit gating and submitted data preview. +- Pass all existing tests. + +## Constraints + +- Use only Signal-based forms (no `FormGroup`, `FormControl`, or `FormArray`). +- Preserve all current validations (required + email). +- Keep the same UX and Tailwind styling. +- All existing tests must pass. + +:::tip[TDD Approach] +You can run tests in watch mode to refactor using Test-Driven Development (TDD): + +```bash +nx test forms-form-array +``` + +This will re-run tests automatically as you make changes, helping you ensure all functionality works correctly during your migration. +::: diff --git a/website/src/content/challenges/forms/65-signal-form-edition.md b/website/src/content/challenges/forms/65-signal-form-edition.md new file mode 100644 index 000000000..f3457e5b7 --- /dev/null +++ b/website/src/content/challenges/forms/65-signal-form-edition.md @@ -0,0 +1,63 @@ +--- +title: 🟠 signal-form-edition +description: Refactor a user management form to use Angular's new Signal-based Forms API. +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 65 +command: forms-signal-form-edition +sidebar: + order: 127 + badge: New +--- + +## Information + +Angular has introduced a new way to work with forms using Signals. This modern approach provides better reactivity and a more intuitive API compared to traditional Reactive Forms. + +In this challenge, you will refactor a user management application. The current implementation uses traditional Reactive Forms. Your goal is to migrate it to the new Signal-based Forms API. + +## Statement + +The application allows listing, adding, and editing users. It includes: + +- **User List**: Displays all users with "Edit" and "Delete" actions. +- **User Form**: A form used for both adding and editing users. +- **Fake Backend**: Simulates HTTP calls with a 500ms delay. + +Your goal is to **refactor the `UserFormComponent` to use Angular's Signal-based Forms API** while maintaining exactly the same functionality and validation rules. + +### Current Implementation + +The form currently uses: + +- `FormGroup` and `FormControl` for the user fields. +- `Validators` for mandatory fields (`firstname`, `lastname`, `age`) and minimum age. +- `patchValue` and `reset` for managing form state during edition. + +The application also uses `rxResource` to load users and navigation to handle the editing context. + +### Expected Result + +After completing the challenge: + +- Use Signal-based form instead of `FormControl` and `FormGroup` in `UserFormComponent`. +- Maintain all existing validation rules and error messages. +- Correctly handle the transition between "Add" and "Edit" modes. +- Maintain the same UI and user experience. + +## Testing + +A comprehensive test suite is provided to ensure your refactoring doesn't break any functionality. You can run the tests using: + +```bash +npx nx test forms-signal-form-edition +``` + +These tests verify the entire user management flow, including adding, editing, and deleting users, as well as form validation. + +## Constraints + +- Do not modify the `FakeBackendService` or `User` model. +- You can refactor other components if necessary, but the primary focus is the `UserFormComponent`. +- The form must properly validate inputs before submission. diff --git a/website/src/content/challenges/nx/25-generator-lib-ext.md b/website/src/content/challenges/nx/25-generator-lib-ext.md new file mode 100644 index 000000000..891be9b16 --- /dev/null +++ b/website/src/content/challenges/nx/25-generator-lib-ext.md @@ -0,0 +1,56 @@ +--- +title: 🔴 Extend Lib Generator +description: Challenge 25 is about creating a Nx generator to extend the built-in Library Generator +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 25 +sidebar: + order: 207 +--- + +## Information + +Welcome to the marvelous world of Nx generators. + +Generators are awesome tools that can help you and your team generate code more quickly, especially for pieces of code that you use frequently. While using Nx, you create libraries regularly, but sometimes the default generator doesn't perfectly meet your needs. + +## Statement + +The goal of this challenge is to create a generator that extends the default library generator of Nx. You will need to override the default `jest.config.ts` and a `eslintrc.json` with a custom one. + +You can either use all the default parameters of the Nx library generator or choose to modify some and keep others as defaults. The choice is yours. + +## Constraints + +You should only override the jest configuration is the `unitTestRunner` option is set at `jest`, and you should only update the eslint configuration if the `linter` is set to `eslint`. + +--- + +`jest.config.ts` + +```ts +/* eslint-disable */ +export default { + displayName: '< libName >', // 👈 lib name + preset: '../../../jest.preset.js', // 👈 be careful with the path + setupFilesAfterEnv: ['/src/subscription-setup.ts'], + transform: { + '^.+\\.(ts|mjs|js|html)$': [ + 'jest-preset-angular', + { + tsconfig: '/tsconfig.spec.json', + stringifyContentPathRegex: '\\.(html|svg)$', + }, + ], + }, + transformIgnorePatterns: ['node_modules/(?!(.*\\.mjs$|lodash-es))'], +}; +``` + +--- + +`eslintrc.json` + +Add the rule `"@typescript-eslint/member-ordering": "off"` inside the rules properties of ts files. diff --git a/website/src/content/challenges/nx/26-generator-comp.md b/website/src/content/challenges/nx/26-generator-comp.md new file mode 100644 index 000000000..ae1505459 --- /dev/null +++ b/website/src/content/challenges/nx/26-generator-comp.md @@ -0,0 +1,148 @@ +--- +title: 🟠 Component Generator +description: Challenge 26 is about creating a Nx generator to create a custom component +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - Sagardevkota + - LMFinney +challengeNumber: 26 +sidebar: + order: 116 +--- + +## Information + +Welcome to the marvelous world of Nx generators. + +Generators are awesome tools that can help you and your team generate code more quickly, especially for pieces of code that you use frequently. Inside an enterprise project, you often have to create components that look similar. And most of the time, you end up copy/pasting other components. In Nx, you can create this boilerplate in a simple command using generators. + +## Statement + +The goal of this challenge is to create a generator that will create all the boilerplate of a component for you. + +Below are the end result of your generator for a `UserComponent` associated with a `@ngrx/component-store`. + +## Options + +- name : name of your component/store/service +- createService: flag to tell if a http service should be created + - yes : create as below + - no: don't create the inject/import/effect/function call (anything related to the service call) +- inlineTemplate: flag to decide if template should be inline or in a separate file + +--- + +`user.component.ts` + +```ts +@Component({ + selector: 'app-user', + imports: [LetDirective], + providers: [provideComponentStore(UserStore)], + template: ` + // do things + `, + changeDetection: ChangeDetectionStrategy.OnPush, +}) +export class UserComponent { + private userStore = inject(UserStore); + + readonly vm$ = this.userStore.vm$; +} +``` + +--- + +`user.store.ts` + +```ts +import { Injectable, inject } from '@angular/core'; +import { ComponentStore, OnStateInit, OnStoreInit } from '@ngrx/component-store'; +import { tapResponse } from '@ngrx/operators'; +import { mergeMap, pipe, tap } from 'rxjs'; +import { User } from './user.model'; +import { UserService } from './user.service'; + +export interface UserState { + users: User[]; + loading: boolean; + error?: string; +} + +const initialState: UserState = { + users: [], + loading: false, + error: undefined, +}; + +@Injectable() +export class UserStore extends ComponentStore implements OnStateInit, OnStoreInit { + private userService = inject(UserService); + + private readonly users$ = this.select((state) => state.users); + private readonly loading$ = this.select((state) => state.loading); + private readonly error$ = this.select((state) => state.error); + + readonly vm$ = this.select( + { + users: this.users$, + loading: this.loading$, + error: this.error$, + }, + { debounce: true }, + ); + + ngrxOnStateInit() { + this.setState(initialState); + } + + ngrxOnStoreInit() { + this.loadUsers(); + } + + readonly loadUsers = this.effect( + pipe( + tap(() => this.patchState({ loading: true })), + mergeMap(() => + this.userService.loadUsers().pipe( + tapResponse( + (users) => this.patchState({ users, loading: false }), + (err: string) => this.patchState({ error: err, loading: false }), + ), + ), + ), + ), + ); +} +``` + +--- + +`user.service.ts` + +```ts +import { BASE_URL } from '@angular-challenges/fake-utils'; +import { HttpClient } from '@angular/common/http'; +import { Injectable, inject } from '@angular/core'; +import { User } from './user.model'; + +@Injectable({ providedIn: 'root' }) +export class UserService { + private http = inject(HttpClient); + private BASE_URL = inject(BASE_URL); + + loadUsers = () => this.http.get(`${this.BASE_URL}/users`); +} +``` + +--- + +`user.model.ts` + +```ts +export interface User { + name: string; +} +``` diff --git a/website/src/content/challenges/nx/27-forbid-enum-rule.md b/website/src/content/challenges/nx/27-forbid-enum-rule.md new file mode 100644 index 000000000..998e11c49 --- /dev/null +++ b/website/src/content/challenges/nx/27-forbid-enum-rule.md @@ -0,0 +1,27 @@ +--- +title: 🟢 Custom Eslint Rule +description: Challenge 27 is about creating a custom ESLint Rule to forbid enums +author: thomas-laforge +contributors: + - tomalaforge + - jdegand +challengeNumber: 27 +sidebar: + order: 12 +--- + +## Information + +ESLint is an amazing tool that helps developers avoid simple mistakes and adhere to company style guides. + +In this first example, we will create a rule that forbids the use of enums. The rule will suggest using string unions instead of enums whenever an enum is present in this repo's code. This is a straightforward rule for learning how to create rules. + +You will also need to write tests to verify the rule's functionality. + +The starter code for this challenge can be found (from the root folder) inside `tools/eslint-rules/rules`. + +To test the rule inside your project, add `"@nx/workspace/forbidden-enum": "error"` to the `eslintrc.json`. You can navigate to Challenge 47, `Enums vs. Union Types', and you should immediately see an error. + +To assist you with AST (Abstract Syntax Tree) definitions, you can visit the [AST Explorer](https://astexplorer.net/) and use `JavaScript`, `@typescript-eslint/parser`, and `ESLint-v8` as the transformation methods. However, please note that you will only get the `type` information there. The transformation function may not work for TypeScript types since the editor is in JavaScript. + +You can also check this [repo](https://github.com/typescript-eslint/typescript-eslint/tree/master/packages/eslint-plugin/src/rules) for ESLint rule examples. diff --git a/website/src/content/challenges/nx/42-static-vs-dynamic-import.md b/website/src/content/challenges/nx/42-static-vs-dynamic-import.md new file mode 100644 index 000000000..2e04e1447 --- /dev/null +++ b/website/src/content/challenges/nx/42-static-vs-dynamic-import.md @@ -0,0 +1,31 @@ +--- +title: 🟢 Static vs Dynamic Import +description: Challenge 42 is about understanding and fixing the eslint rule - Static imports of lazy-loaded libraries are forbidden. +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 42 +command: nx-static-vs-dynamic-import +sidebar: + order: 15 +--- + +## Information + +If you are using **Nx**, you might have encountered this error: + +```ts +Static imports of lazy-loaded libraries are forbidden. + +Library "users" is lazy-loaded in these files: + +- apps/nx/static-dynamic-import/src/app/app.config.ts eslint@nx/enforce-module-boundaries +``` + +This error is part of the ESLint rule embedded by Nx to prevent people from mixing lazy-loading and eagerly-loading code from the same library. Although this error will not break at runtime or build time, it can lead to consequences for bundle size. The lazy-loaded code will end up in the main bundle, nullifying all the benefits of lazy-loading a library. + +## Statement + +The goal of this challenge is to improve the code architecture to eliminate this ESLint error. + +You will learn how to create a library and how to rearrange code. diff --git a/website/src/content/challenges/performance/12-optimize-change-detection.md b/website/src/content/challenges/performance/12-optimize-change-detection.md new file mode 100644 index 000000000..5fa698a43 --- /dev/null +++ b/website/src/content/challenges/performance/12-optimize-change-detection.md @@ -0,0 +1,41 @@ +--- +title: 🟠 Optimize Change Detection +description: Challenge 12 about optimizing the number of change detection cycle while scrolling +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 12 +command: performance-optimize-change-detection +sidebar: + order: 107 +--- + +## Information + +In Angular, there is a library called Zone.js that performs a lot of magic to simplify a developer's life. Zone.js monkey patches all DOM events so that it will recheck and rerender the view when something has changed inside the application. The developer doesn't have to manually trigger change detection. + +However, sometimes Zone.js triggers a lot more change detection than needed. For example, when you are listening to a scroll event, each scroll event will dispatch a new change detection cycle. + +In this challenge, we only need to refresh the view at a specific scroll position to display or hide a button. All other cycles are unnecessary. + +To have a better visualization of the problem, profile your application with Angular Dev Tools. + +:::note +If you don't know how to use it, read [the performance introduction page](/challenges/performance/) first and come back after. +::: + +You can learn more details about zone pollution and how to resolve it [here](https://angular.dev/best-practices/zone-pollution). + +The following video will explain more in-depth the issue of this application. + + + +## Statement + +Your goal for this challenge is to avoid all unnecessary change detection cycles and trigger a change detection only when needed. + +## Constraint: + +You cannot opt out of Zone.js globally. If this code is part of a large project, and you opt out of Zone.js, you will break your application without any doubt. diff --git a/website/src/content/challenges/performance/34-default-vs-onpush.md b/website/src/content/challenges/performance/34-default-vs-onpush.md new file mode 100644 index 000000000..779af5324 --- /dev/null +++ b/website/src/content/challenges/performance/34-default-vs-onpush.md @@ -0,0 +1,57 @@ +--- +title: 🟢 Default vs OnPush +description: Challenge 34 is about learning the difference between Default and OnPush Change Detection Strategy. +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 34 +command: performance-default-vs-onpush +sidebar: + order: 7 +--- + +## Information + +In this challenge, we will explore the differences and impacts of using `ChangeDetectionStrategy.Default` versus `ChangeDetectionStrategy.OnPush`. + +You can read the [Angular documentation](https://angular.dev/best-practices/skipping-subtrees) to learn more about the differences between these strategies. + +In this challenge, all components start with the `Default` strategy. When you type letters inside the input field, you will notice that all components are highlighted in orange. + +:::note +I added color highlighting to each component and each row to provide a better visualization of when a component is rerendered. +::: + +As you can see, each letter triggers a new change detection cycle, and all components are rerendered, causing performance issues. + +Let's use the Angular DevTool to profile our application and understand how this tool can help us understand what is happening inside our application. + +:::note +If you don't know how to use it, read [the performance introduction page](/challenges/performance/) first and come back after. +::: + +Now, start profiling your application and type some letters inside the input field to trigger some change detection cycles. + +If you click on one of the bars (indicated by the yellow arrow in the picture below), you can see that `PersonListComponent`, `RandomComponent`, and all the `MatListItem` are impacted by the change detection cycle, even when we only interact with the input field. + +![profiler record](../../../../assets/performance/34/profiler-record.png 'Profiler Record') + +## Statement + +The goal of this challenge is to improve the clustering of change detection within the application using the `OnPush` change detection strategy, but not only... + +## Hints: + +
+ Hint 1 + +Use `ChangeDetectionStrategy.OnPush` but this will not be enough. + +
+ +
+ Hint 2 + +Create smaller components to better separate the input field from the list. + +
diff --git a/website/src/content/challenges/performance/35-memoization.md b/website/src/content/challenges/performance/35-memoization.md new file mode 100644 index 000000000..52f61389b --- /dev/null +++ b/website/src/content/challenges/performance/35-memoization.md @@ -0,0 +1,51 @@ +--- +title: 🟢 Memoization +description: Challenge 35 is about learning how pure pipe works +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 35 +command: performance-memoization +sidebar: + order: 8 +--- + +## Information + +In Angular, pure Pipes are very powerful because the value is memoized, which means if the input value doesn't change, the `transform` function of the pipe is not recomputed, and the cached value is outputted. + +You can learn more about pipes in the [Angular documentation](https://angular.dev/guide/pipes) and inside this [deep dive article](https://medium.com/ngconf/deep-dive-into-angular-pipes-c040588cd15d). + +In this challenge, we start with a button to load a list of people. Each person is associated with a number, and we will use the Fibonacci calculation to create a heavy computation that will slow down the application. + +Once the list is loaded, try typing some letters inside the input field. You will notice that the application is very slow, even though you are only performing very basic typing. + +:::note +We will not focus on the initial loading of the list in this challenge. +::: + +Let's use the Angular DevTool to profile our application and understand how this tool can help us understand what is happening inside our application. + +:::note +If you don't know how to use it, read [the performance introduction page](/challenges/performance/) first and come back after. +::: + +Now, start profiling your application and type some letters inside the input field. You will see some red bars showing up inside the profiler panel. + +If you click on one of the bars (indicated by the yellow arrow in the picture below), you will see that the change detection cycle is taking more than 3s in `PersonListComponent`. + +![profiler record](../../../../assets/performance/35/memoize-profiler.png 'Profiler Record') + +## Statement + +The goal of this challenge is to understand what is causing this latency and to improve it. + +## Hints: + +
+ Hint 1 + +Use `Pipes` to memoize the Fibonacci computation. + +
diff --git a/website/src/content/challenges/performance/36-ngfor-optimization.md b/website/src/content/challenges/performance/36-ngfor-optimization.md new file mode 100644 index 000000000..336f525fa --- /dev/null +++ b/website/src/content/challenges/performance/36-ngfor-optimization.md @@ -0,0 +1,34 @@ +--- +title: 🟢 NgFor Optimization +description: Challenge 36 is about learning how trackby works +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 36 +command: performance-ngfor-optimization +sidebar: + order: 13 +--- + +## Information + +In this application, we have a list of individuals that we can add, delete or update. If you open the developer Chrome panel by pressing **F12**, go to the Elements tab, and expand the element to see the list, you will notice that each time you add, delete or update a list item, all the DOM elements are destroyed and initialized again. (See video below). + + + +We can also use the Angular DevTool to profile our application and understand what is happening inside our application. I will show you how to do it inside the following video. + + + +:::note +If you don't know how to use it, read [the performance introduction page](/challenges/performance/) first and come back after. +::: + +If you need more information about `NgFor`, I invite you to read the [documentation](https://angular.dev/api/common/NgFor) first. + +## Statement + +The goal of this challenge is to understand what is causing this DOM refresh and to solve it. diff --git a/website/src/content/challenges/performance/37-optimize-big-list.md b/website/src/content/challenges/performance/37-optimize-big-list.md new file mode 100644 index 000000000..daeb5aec9 --- /dev/null +++ b/website/src/content/challenges/performance/37-optimize-big-list.md @@ -0,0 +1,39 @@ +--- +title: 🟠 Optimize Big List +description: Challenge 37 is about learning how virtualization optimize big list rendering +author: thomas-laforge +contributors: + - tomalaforge + - jdegand + - LMFinney +challengeNumber: 37 +command: performance-optimize-big-list +sidebar: + order: 117 +--- + +## Information + +In this application, we will render a list of 100,000 individuals by clicking on the **loadList** button. If you open the Chrome developer panel by pressing **F12**, go to the Elements tab, and expand the element to see the list, you will notice that all 100,000 elements are rendered in the DOM, even though we can only see about 20 elements in the viewport. This process takes a lot of time, which is why the application is very slow at displaying the list. + +We can use the Angular DevTool to profile our application and understand what is happening inside our application. I will show you how to do it inside the following video. + + + +:::note +If you don't know how to use it, read [the performance introduction page](/challenges/performance/) first and come back after. +::: + +## Statement + +The goal of this challenge is to implement a better alternative to display big list of items. + +## Hints: + +
+ Hint 1 + +If you're unsure where to begin, I recommend reading the [Angular CDK virtualization documentation](https://material.angular.io/cdk/scrolling/overview). + +
diff --git a/website/src/content/challenges/performance/40-web-worker.md b/website/src/content/challenges/performance/40-web-worker.md new file mode 100644 index 000000000..522e19d28 --- /dev/null +++ b/website/src/content/challenges/performance/40-web-worker.md @@ -0,0 +1,36 @@ +--- +title: 🟠 Web workers +description: Challenge 40 is about learning how to create and use a web worker +author: thomas-laforge +contributors: + - tomalaforge + - jdegand +challengeNumber: 40 +command: performance-web-workers +sidebar: + order: 119 +--- + +## Information + +This challenge has been created for [Angular Advent Calendar](https://angularchristmascalendar.com) 2023. + +This application is basic. We click on the **Discover** button to reveal the surprise hidden behind the black screen. However, the current application provides an awful user experience. When we click on the button, the page freezes, and after a while, it reveals the secret all at once without a smooth animation. + +> Note: To create the application freeze, the loader is based on a very heavy computation function. We could have used a basic timer, but that's not the point of this challenge. + +Since JavaScript is single-threaded, when we perform a heavy task, the browser cannot update the UI or respond to mouse clicks or any events. To free the main thread, the goal is to isolate the heavy computation into a different thread. To do so, we will need to use web workers. Web workers can run any scripts in the background, in isolation from the main thread, allowing the browser to still provide your user with a good experience. + +In Angular, this technology is often underused, however, it's straightforward to create one. There is a schematic that you can find [here](https://angular.dev/ecosystem/web-workers). + +## Statement + +The goal of this challenge is to create a smooth animation by isolating the heavy computation function into a web worker. + +First, create a web worker using a schematic, then move the issuing function. Finally, the animation should be smooth and the progress percentage should update, which will provide an awesome user experience. + +:::note +Since we are inside an Nx workspace, simply replace the `ng` command with `nx` when running the schematic. + +If `nx` is not installed globally on your machine, prefix your command with `npx`. +::: diff --git a/website/src/content/challenges/performance/index.mdx b/website/src/content/challenges/performance/index.mdx new file mode 100644 index 000000000..5a7bb0abe --- /dev/null +++ b/website/src/content/challenges/performance/index.mdx @@ -0,0 +1,71 @@ +--- +title: Angular Performance +prev: false +next: false +contributors: + - tomalaforge + - tomer953 + - LMFinney +description: Learn how to use the Angular Devtool chrome extension. +noCommentSection: true +sidebar: + order: 1 +--- + +import { LinkCard } from '@astrojs/starlight/components'; + +In this series of challenges about performance, you will learn how to optimize and enhance the performance of your Angular application. + +Before starting to resolve any challenge, I invite you to download the [Angular DevTools Chrome extension](https://chrome.google.com/webstore/detail/angular-devtools/ienfalfjdbdpebioblfackkekamfmbnh) if you haven't already done so. + +This extension allows you to profile your application and detect performance issues, which is very useful for understanding where performance issues can occur. + +## How to use it + +When you serve an Angular application, you can inspect a page by pressing F12, which will open the Chrome developer tools. Then navigate to the Angular tab. From there, you can select the Profiler tab as shown below. + +![profiler tab](../../../../assets/performance/profiler-tab.png 'Profiler tab') + +You can now profile your application by clicking on the record button. You can play with your application and see when change detection is triggered and which components are rerendered. + +:::tip[Learn more] +You can learn more on the [documentation page](https://angular.io/guide/devtools). +::: + +Now that you know how to use the Angular DevTool, you can choose a challenge, profile it, and resolve it. + + + + + + + + + + + + diff --git a/website/src/content/challenges/rxjs/11-high-order-operator-bug.md b/website/src/content/challenges/rxjs/11-high-order-operator-bug.md new file mode 100644 index 000000000..dbc0b53d0 --- /dev/null +++ b/website/src/content/challenges/rxjs/11-high-order-operator-bug.md @@ -0,0 +1,32 @@ +--- +title: 🟠 High Order Operator Bug +description: Challenge 11 is about resolving a Rxjs bug because of high order operators +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 11 +command: rxjs-high-order-operator-bug +sidebar: + order: 114 +--- + +Let's dive inside the wonderful word of RxJS. + +This challenge is inspired by a real-life example. + +## Information + +### User Story + +We need a button for each `Topic`. When we click on it, we delete all objects with this `Topic` in our database _(Fake DB in our case)_. Finally, we display **All [topic] have been deleted** if everything was deleted successfully or **Error: deletion of some [topic] failed** if some deletions failed + +### Constraints + +We can only pass one object to our DB for deletion at the time. The DB will respond true if the data was successfully deleted and false otherwise. + +### Statement + +The QA team reports a **bug**. The UI shows **All [topic] have been deleted** all the time, even if some deletions fail. + +👉 Spot the bug and correct it. diff --git a/website/src/content/challenges/rxjs/14-race-condition.md b/website/src/content/challenges/rxjs/14-race-condition.md new file mode 100644 index 000000000..b4fbb8d95 --- /dev/null +++ b/website/src/content/challenges/rxjs/14-race-condition.md @@ -0,0 +1,30 @@ +--- +title: 🟢 Race Condition +description: Challenge 14 is about race condition in Rxjs +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 14 +command: rxjs-race-condition +sidebar: + order: 11 +--- + +## Information + +The goal of this application is to display a list of topics in a modal when a button is clicked. The application functions correctly. However, your tech lead has asked you to add tests and they are failing. + +## Statement + +Correct your application to pass the test + +## Constraints + +- I can see you coming 🤣 => You CANNOT change the test (the test is working fine) 😳 +- You CANNOT change the `fakeGetHttpTopic` method. A delay has been added to fake a slow network. + +## Run the test + +HEADLESS : `npx nx test rxjs-race-condition` +WATCH MODE : `npx nx test rxjs-race-condition --watch` diff --git a/website/src/content/challenges/rxjs/38-rxjs-catch-error.md b/website/src/content/challenges/rxjs/38-rxjs-catch-error.md new file mode 100644 index 000000000..5680d1544 --- /dev/null +++ b/website/src/content/challenges/rxjs/38-rxjs-catch-error.md @@ -0,0 +1,37 @@ +--- +title: 🟢 catchError +description: Challenge 38 is about learning observable completion. +author: devesh-chaudhari +command: rxjs-catch-error +contributors: + - DeveshChau + - tomalaforge + - LMFinney +challengeNumber: 38 +sidebar: + order: 14 +--- + +## Information + +### How to Use the Application + +Our application features a form with a text input box and a "Fetch" button. Upon clicking the "Fetch" button, data is retrieved from a [free API](https://jsonplaceholder.typicode.com/). + +The correct values for a successful response are limited to: posts, comments, albums, photos, todos, and users. Any other values will result in an error response. + +### Bug + +A bug has been identified in our application. Users are only able to successfully fetch data until an invalid request is sent. Once an error response is received, users are unable to send additional requests. + +### Learnings + +This application provides an opportunity to understand the correct placement of a [`catchError`](https://rxjs.dev/api/operators/catchError) operator. If placed incorrectly, the overall subscription will be completed, preventing users from sending more requests. The goal is to preserve the overall subscription by handling error notifications from inner observables appropriately. + +## Statement + +The goal is to use the catchError operator to handle error management inside your Rxjs stream. + +## Constraints + +Users should be able to log the value/error each time they click the "Fetch" button. diff --git a/website/src/content/challenges/rxjs/49-hold-to-save-button.md b/website/src/content/challenges/rxjs/49-hold-to-save-button.md new file mode 100644 index 000000000..050ccc48a --- /dev/null +++ b/website/src/content/challenges/rxjs/49-hold-to-save-button.md @@ -0,0 +1,46 @@ +--- +title: 🟠 Hold to save button +description: You're tasked with implementing Lucie's button design, requiring holding it for a set time to save, taking over from Sacha; functionalities include configuring duration, countdown initiation on "mousedown", progress bar reset on "mouseleave" or "mouseup", reflecting remaining time, and simulating save request on hold completion, using RxJS operators and ensuring declarative code. +author: timothy-alcaide +contributors: + - alcaidio + - LMFinney +challengeNumber: 49 +command: rxjs-hold-to-save-button +sidebar: + order: 19 +--- + +## Context + +As a member of the development team, you have to respond to a specific request from the UX designer, 👩🏻‍🎨 Lucie, who has designed a button that must be held down for X amount of time to save a save request. + +Sacha 👶🏼 the trainee has already integrated the design but doesn't know how to perform the "holdable" functionality. + +So you're going to take over from him. + +## Functional expectation + +> "As a user, I would like to save something by holding down the button for a certain amount of time." + +Here is the prototype made by Lucie: + +![prototype gif](../../../../assets/rxjs/49/prototype.gif) + +## Acceptance Criteria + +1. We should be able to configure a maintenance duration in milliseconds. +2. Pressing and holding the button triggers the countdown on the `mousedown` event. +3. On `mouseleave` or `mouseup` events, the progress bar is reset to 0. +4. The progress bar representing the remaining relative time should reflect the remaining time. +5. Simulates a backend request when the hold time is over (console log or alert). +6. You must maximize the use of RxJS operators and be as declarative as possible. + +
+ Tips 🤫 (if you really need it and after careful consideration) +
    +
  • Create the `HoldableDirective`
    • +
  • Use `TemplateRef` and `fromEvent` from RxJS to catch events or `@HostListener`
    • +
  • Perhaps the following RxJS operators can help you: interval, takeUntil, switchMap, takeWhile/retry...
    • +
+
diff --git a/website/src/content/challenges/signal/30-interop-rxjs-signal.md b/website/src/content/challenges/signal/30-interop-rxjs-signal.md new file mode 100644 index 000000000..08489c8f7 --- /dev/null +++ b/website/src/content/challenges/signal/30-interop-rxjs-signal.md @@ -0,0 +1,22 @@ +--- +title: 🔴 Interoperability Rxjs/Signal +description: Challenge 30 is about learning how to mix signal with Rxjs +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 +challengeNumber: 30 +command: signal-interop-rxjs-signal +sidebar: + order: 204 +--- + +## Information + +In this challenge, we have a small reactive application using **RxJS** and **NgRx/Component-Store**. + +The goal of this challenge is to use the new **Signal API** introduced in Angular v16. However, we should not convert everything. Certain portions of the code are better suited for RxJS rather than Signal. It is up to you to determine the threshold and observe how **Signal and RxJS coexist**, as well as how the interoperability is achieved in Angular. + +## Note + +- You can use any third party library if you want to like **ngrx/signal-store**, **tanstack-query** or **rxAngular**. diff --git a/website/src/content/challenges/signal/43-signal-input.md b/website/src/content/challenges/signal/43-signal-input.md new file mode 100644 index 000000000..0ab0498e5 --- /dev/null +++ b/website/src/content/challenges/signal/43-signal-input.md @@ -0,0 +1,55 @@ +--- +title: 🟢 Signal Input +description: Challenge 43 is about learning how to use signal inputs +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 43 +command: signal-signal-input +sidebar: + order: 16 +--- + +## Information + +Finally, the day has arrived when the Angular team introduces a reactive input. This highly requested feature has been awaited for many years. Version 17.1 introduces `SignalInput`. Instead of utilizing the well-known `@Input` decorator, you now have a function that returns a signal. + +```ts +// old way +@Input() age?: number; + +// new way +age = input() +``` + +If you want required inputs + +```ts +// old way +@Input({required: true}) age!: number; + +// new way +age = input.required() +``` + +If you wanted to obtain a signal from an input, you had to go through a setter to configure your signal from the input. + +```ts +// old way +age = signal(0) +@Input({alias: 'age'}) set _age(age: number){ + this.age.set(age) +}; + +// new way +age = input() +``` + +You can read more about signal inputs [here](https://angular.dev/guide/signals/inputs). + +## Statement + +In this small application, the goal is to refactor the `UserComponent` to utilize `SignalInput`. + +- You have required and optional inputs. +- You can use the `transform` function for the `age` input to directly convert the property to a number. diff --git a/website/src/content/challenges/signal/50-bug-effect-signal.md b/website/src/content/challenges/signal/50-bug-effect-signal.md new file mode 100644 index 000000000..46f07c6bd --- /dev/null +++ b/website/src/content/challenges/signal/50-bug-effect-signal.md @@ -0,0 +1,40 @@ +--- +title: 🟢 Bug in Effect +description: Challenge 50 is about understanding why an effect is not triggered. +author: thomas-laforge +contributors: + - tomalaforge + - svenson95 + - LMFinney +challengeNumber: 50 +command: signal-bug-in-effect +sidebar: + order: 19 +--- + +## Information + +In this basic exercise, we aim to display an alert whenever at least one checkbox is checked. You are in the process of buying a MacBook, which can be upgraded with some extras, like more drive space, more RAM or a better GPU. + +Bildschirmfoto 2024-05-09 um 08 57 57 + +## Statement + +The actual implementation doesn't work as expected, and your task is to fix a bug that your team discovered. An alert should be shown if at least one of the three checkboxes is checked (independent of any other checkboxes). But if the first one is checked, checking one or both of the other two checkboxes does not cause the alert to display. Why does this happen? + +The objective of this challenge is to understand the issue and fix the problem that prevents the alert from appearing when the second checkbox is clicked. + +## Acceptance Criteria + +To ensure this feature works properly, try this out to reproduce the bug after solving the challenge, to check if the bug is gone. + +- Check box 1 (Alert should be shown) +- Check box 2 (Alert should be shown) +- Uncheck box 1 +- Check box 3 (Alert should be shown) +- Uncheck box 2 +- Uncheck box 3 + +## Bonus Challenge + +- Try to implement this feature with a `computed` signal. diff --git a/website/src/content/challenges/signal/51-function-call-effect.md b/website/src/content/challenges/signal/51-function-call-effect.md new file mode 100644 index 000000000..e2a94694c --- /dev/null +++ b/website/src/content/challenges/signal/51-function-call-effect.md @@ -0,0 +1,25 @@ +--- +title: 🟢 Function call in effect +description: Challenge 51 is about understanding why an effect is triggered too often. +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 51 +command: signal-function-call-effect +sidebar: + order: 20 +--- + +## Information + +In this second challenge focusing on Signal effects, we've introduced an input select that allows users to choose an action. Whenever an action is selected, it is logged in the console. The application also permits changes to the selected user. + +## Problem Statement + +Ideally, the system should log an action only when one is specifically selected. However, we currently face an issue where changing the user also triggers a log entry, even though we do not explicitly monitor user changes. + +The objective of this challenge is to identify and resolve the cause of these extra triggers. We aim to ensure that logging only occurs when an action is selected. + +## Constraints + +- You cannot modify the `UserService` file. diff --git a/website/src/content/challenges/signal/53-big-signal-performance.md b/website/src/content/challenges/signal/53-big-signal-performance.md new file mode 100644 index 000000000..d3b4ea4a2 --- /dev/null +++ b/website/src/content/challenges/signal/53-big-signal-performance.md @@ -0,0 +1,24 @@ +--- +title: 🟠 Big Signal Performance +description: Challenge 53 is about performance while using big signal object +author: thomas-laforge +contributors: + - tomalaforge + - jdegand +challengeNumber: 53 +command: signal-big-signal-performance +sidebar: + order: 122 +--- + +## Information + +For this challenge, you can imagine a large-scale application where you use a service to save and retrieve your user state at any time within the application. + +The problem is that updating a single user property updates the entire application. + +I added the `CDFlashingDirective` to visualize when one component is rendering. + +## Statement + +With signals, you can now be more fine-grained in what the UI is rendering. The goal of this challenge is to understand why everything is re-rendering and to refactor the application to be more performant. diff --git a/website/src/content/challenges/signal/54-pipe-observable-to-signal.md b/website/src/content/challenges/signal/54-pipe-observable-to-signal.md new file mode 100644 index 000000000..2b88b528f --- /dev/null +++ b/website/src/content/challenges/signal/54-pipe-observable-to-signal.md @@ -0,0 +1,22 @@ +--- +title: 🔴 Pipe Observable to Signal +description: Challenge 54 is about refactoring an application using observable to signals +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 54 +command: signal-pipe-observable-to-signal +sidebar: + order: 210 +--- + +## Information + +We have a legacy application that is using observables to store a state. Signals are a very good fit for that. + +## Statement + +So, the goal of this challenge is to refactor the following application to be a fully signal-based application. When you are done, neither the pipe nor the service should import RxJS. + +Be careful along the way; everything might not work as you wish. diff --git a/website/src/content/challenges/signal/56-forms-and-signal.md b/website/src/content/challenges/signal/56-forms-and-signal.md new file mode 100644 index 000000000..077fd822f --- /dev/null +++ b/website/src/content/challenges/signal/56-forms-and-signal.md @@ -0,0 +1,27 @@ +--- +title: 🔴 forms and signal +description: Challenge 56 is about working with reactive forms and signals +author: thomas-laforge +contributors: + - tomalaforge +challengeNumber: 56 +command: signal-forms-and-signal +sidebar: + order: 211 +--- + +## Information + +We are working within a large e-commerce codebase that utilizes a substantial number of forms. The team predominantly uses reactive forms, and since the release of signals, we have been integrating them extensively. + +The current feature in development is a multi-step form process. The steps include: selecting a product, choosing the quantity, and finally proceeding to the checkout step to complete the billing details. However, an issue has been identified: when a user navigates back from the checkout step to the quantity step, the previously selected quantity is not retained. This needs to be fixed. + +## Challenge Statement + +The objective of this challenge is to make sure that the selected quantity is preserved when navigating back from the checkout step to the quantity step. + +## Constraints + +The solution must use reactive forms and signals. + +Additionally, as an optional side challenge, you may refactor the code to use template-driven forms. diff --git a/website/src/content/challenges/testing/17-router.md b/website/src/content/challenges/testing/17-router.md new file mode 100644 index 000000000..2af0c8d77 --- /dev/null +++ b/website/src/content/challenges/testing/17-router.md @@ -0,0 +1,28 @@ +--- +title: 🟠 Router +description: Challenge 17 is about testing the router +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 17 +command: testing-router +sidebar: + order: 108 +--- + +## Information + +We have a functional application that lists available books for borrowing inside a library. If the book you searched for is available, you will be directed to the corresponding book(s), otherwise, you will end up on an error page. + +The file named `app.component.spec.ts` will let you test your application using [Angular Testing Library](https://testing-library.com/) . To run the test suites, you need to run `npx nx test testing-router-outlet`. You can also install [Jest Runner](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner) to execute your test by clicking on the `Run` button above each `describe` or `it` blocks. + +For testing with Cypress, you will execute your test inside the `app.component.cy.ts` and run `npx nx component-test testing-router-outlet` to execute your test suites. You can add the `--watch` flag to execute your test in watch mode. + +# Statement + +The goal is to test multiple behaviors of the application described in each test file using [Angular Testing Library](https://testing-library.com/) and [Cypress Component Testing](https://docs.cypress.io/guides/component-testing/overview). + +:::note +I have created some `it` blocks but feel free to add more tests if you want. +::: diff --git a/website/src/content/challenges/testing/18-nested-components.md b/website/src/content/challenges/testing/18-nested-components.md new file mode 100644 index 000000000..d7ba391c2 --- /dev/null +++ b/website/src/content/challenges/testing/18-nested-components.md @@ -0,0 +1,32 @@ +--- +title: 🟠 Nested Components +description: Challenge 18 is about testing nested components +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 18 +command: testing-nested-components +sidebar: + order: 109 +--- + +## Information + +We have a small application that sends a title to a fake backend when the user types the value into an input. +If the title is correctly typed, you can send the request; otherwise you receive an error, and the request is not sent. +The application is created with nested components. `ChildComponent` is the container that includes four components: `ResultComponent`, `ButtonComponent`, `InputComponent` and `ErrorComponent`. However, since we are testing our component as a black box, the architecture of our components doesn't change anything. You can create your test, change how the components are structured, and your tests should still pass. That's the goal of integration tests. Never test internal implementation details!!!. + +You can play with it by running : `npx nx serve testing-nested`. + +The file named `child.component.spec.ts` will let you test your application using [Angular Testing Library](https://testing-library.com/) . To run the test suites, you need to run `npx nx test testing-nested`. You can also install [Jest Runner](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner) to execute your test by clicking on the `Run` button above each `describe` or `it` blocks. + +For testing with Cypress, you will execute your test inside the `child.component.cy.ts` and run `npx nx component-test testing-nested` to execute your test suites. You can add the `--watch` flag to execute your test in watch mode. + +# Statement + +The goal is to test multiple behaviors of the application describe inside each test files using [Angular Testing Library](https://testing-library.com/) and [Cypress Component Testing](https://docs.cypress.io/guides/component-testing/overview). + +:::note +I have created some `it` blocks but feel free to add more tests if you want. +::: diff --git a/website/src/content/challenges/testing/19-input-output.md b/website/src/content/challenges/testing/19-input-output.md new file mode 100644 index 000000000..3752816ad --- /dev/null +++ b/website/src/content/challenges/testing/19-input-output.md @@ -0,0 +1,33 @@ +--- +title: 🟠 Input Output +description: Challenge 19 is about testing inputs and ouputs +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - jdegand + - LMFinney +challengeNumber: 19 +command: testing-input-output +sidebar: + order: 110 +--- + +## Information + +We have a small counter application that increments or decrements a number. The `CounterComponent` takes an initial value as an `@Input` and emits the result of the counter as an `@Output` when we click on the **Send** button. Since we are testing our component as a black box, we only have access to our inputs and listen to the output values. We should not rely on any internal implementation details!!! + +You can play with it by running : `npx nx serve testing-input-output`. + +The file named `counter.component.spec.ts` will let you test your application using [Angular Testing Library](https://testing-library.com/) . To run the test suites, you need to run `npx nx test testing-input-output`. You can also install [Jest Runner](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner) to execute your test by clicking on the `Run` button above each `describe` or `it` blocks. + +For testing with Cypress, you will execute your test inside the `counter.component.cy.ts` and run `npx nx component-test testing-input-output` to execute your test suites. You can add the `--watch` flag to execute your test in watch mode. + +# Statement + +The goal is to test multiple behaviors of the application described inside each test file using [Angular Testing Library](https://testing-library.com/) and [Cypress Component Testing](https://docs.cypress.io/guides/component-testing/overview). + +:::note +I have created some `it` blocks but feel free to add more tests if you want. +::: diff --git a/website/src/content/challenges/testing/20-modal.md b/website/src/content/challenges/testing/20-modal.md new file mode 100644 index 000000000..8a1d34c8b --- /dev/null +++ b/website/src/content/challenges/testing/20-modal.md @@ -0,0 +1,37 @@ +--- +title: 🟠 Modal +description: Challenge 20 is about testing modals +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - jdegand + - LMFinney +challengeNumber: 20 +command: testing-modal +sidebar: + order: 111 +--- + +## Information + +In this small application, you have an input prompting you to enter a name, and a **Confirm** button to submit your form. +If you enter a name, a confirmation modal will appear; otherwise an error modal will be displayed. +In the confirmation modal, if you click the **Confirm** button, a message confirming the submission of the form will appear. If the user clicks on **Cancel**, an error message will be displayed. + +The goal of this challenge is to test the dialogs inside your application. To do so, we will test the full application like an end-to-end test will do. This means, we will test the `AppComponent` as a black box and react to events on the page. No internal details should be tested. The difference between an e2e test and integration test is that we will mock all API calls. _(All http requests are faked inside this application, but this would not be the case in a real enterprise application.)_ + +You can play with it by running : `npx nx serve testing-modal`. + +The file named `app.component.spec.ts` will let you test your application using [Angular Testing Library](https://testing-library.com/) . To run the test suites, you need to run `npx nx test testing-modal`. You can also install [Jest Runner](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner) to execute your test by clicking on the `Run` button above each `describe` or `it` blocks. + +For testing with Cypress, you will execute your test inside `app.component.cy.ts` and run `npx nx component-test testing-modal` to execute your test suites. You can add the `--watch` flag to execute your test in watch mode. + +# Statement + +The goal is to test multiple behaviors of the application described inside each test file using [Angular Testing Library](https://testing-library.com/) and [Cypress Component Testing](https://docs.cypress.io/guides/component-testing/overview). + +:::note +I have created some `it` blocks but feel free to add more tests if you want. +::: diff --git a/website/src/content/challenges/testing/23-harness.md b/website/src/content/challenges/testing/23-harness.md new file mode 100644 index 000000000..629ffdf5d --- /dev/null +++ b/website/src/content/challenges/testing/23-harness.md @@ -0,0 +1,30 @@ +--- +title: 🟢 Harness +description: Challenge 23 is about testing with component harnesses +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - jdegand + - LMFinney +challengeNumber: 23 +command: testing-harness +sidebar: + order: 9 +--- + +## Information + +A component harness is a class that lets a test interact with a component via a supported API. + +The objective of this challenge is to have a better understanding of the CDK test harness API. In this initial challenge, we will only use Angular Material's built-in harnesses. + +Documentation for CDK Component Harness is [here](https://material.angular.io/cdk/test-harnesses/overview#api-for-test-authors). +Documentation for Angular Material component is [here](https://material.angular.io/components/button/overview). + +## Statement + +Test the functionality of `child.component.ts`, which consists of some inputs & checkboxes related to a `mat-slider`. Implement the prepared test suite, but feel free to include additional tests as well. + +**Note:** You are welcome to use [Angular Testing Library](https://testing-library.com/) if you wish. diff --git a/website/src/content/challenges/testing/24-harness-creation.md b/website/src/content/challenges/testing/24-harness-creation.md new file mode 100644 index 000000000..d60456b01 --- /dev/null +++ b/website/src/content/challenges/testing/24-harness-creation.md @@ -0,0 +1,48 @@ +--- +title: 🟠 Harness Creation +description: Challenge 24 is about creating a component harness. +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - jdegand +challengeNumber: 24 +command: testing-harness-creation +sidebar: + order: 112 +--- + +## Information + +The goal of this challenge is to create a test harness for `slider.component.ts`. The harness file, `slider.harness.ts`, has already been created. + +The following API needs to be implemented: + +```ts + async clickPlus(): Promise ; + + async clickMinus(): Promise; + + async getValue(): Promise ; + + async getMinValue(): Promise; + + async disabled(): Promise; + + async setValue(value: number): Promise; +``` + +Additionally, you should create a `HarnessPredicate` with the default predicate and the `minValue` property. + +```ts + static with( + this: ComponentHarnessConstructor, + options: SliderHarnessFilters = {} + ): HarnessPredicate; +``` + +Lastly, you will need to create the test suite for `app.component`. Some default tests have already been written, but feel free to add as many tests as you want and create as many harness methods as you need. + +> Angular Material documentation can be found [here](https://material.angular.io/cdk/test-harnesses/overview). + +Good luck !!! 💪 diff --git a/website/src/content/challenges/testing/28-checkbox.md b/website/src/content/challenges/testing/28-checkbox.md new file mode 100644 index 000000000..15b66eb73 --- /dev/null +++ b/website/src/content/challenges/testing/28-checkbox.md @@ -0,0 +1,30 @@ +--- +title: 🟢 Checkbox +description: Challenge 28 is about testing a simple checkbox +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - jdegand + - LMFinney +challengeNumber: 28 +command: testing-checkbox +sidebar: + order: 10 +--- + +## Information + +This application is very simple. It consists of a checkbox that enables or disables a button. The primary goal of this application is to become familiar with the debug API of [Angular Testing Library](https://testing-library.com/). Knowing how to debug your tests is a crucial tool you need to have in your toolkit. + +You can find the documentation about debugging in Angular Testing Library [here](https://testing-library.com/docs/dom-testing-library/api-debugging#screenlogtestingplaygroundurl). + +The main functions to remember are as follows: + +- `logRoles(myDOMElement)`: prints out all ARIA roles within the tree of the given DOM element. ARIA roles are the primary selectors you should reach for in the first place. +- `screen.debug()` or `screen.debug(myDOMElement)`: prints the DOM inside the console. +- `screen.logTestingPlaygroundURL()` or `screen.logTestingPlaygroundURL(myDOMElement)`: this function is very powerful. It will create a playground to expose all elements, and you can interact with it to see the selectors you should choose for a DOM element. + +## Statement + +The goal of this challenge is not to submit an answer, but you can if you want. It's more about using the debugging API to play around. These tools will be of great help for the upcoming testing challenges. diff --git a/website/src/content/challenges/testing/29-real-life-application.md b/website/src/content/challenges/testing/29-real-life-application.md new file mode 100644 index 000000000..fdbb84407 --- /dev/null +++ b/website/src/content/challenges/testing/29-real-life-application.md @@ -0,0 +1,38 @@ +--- +title: 🔴 Real-life Application +description: Challenge 29 is about testing a real-life application +author: thomas-laforge +contributors: + - tomalaforge + - tomer953 + - svenson95 + - LMFinney +challengeNumber: 29 +command: testing-real-life-application +sidebar: + order: 205 +--- + +## Information + +This application presents a greater challenge because it closely resembles a real-life application that you might encounter in your day-to-day activities as an Angular developer. What makes it more difficult is the need to handle asynchronous tasks and create appropriate mocks. + +The application is a typical todo list application. You can filter tickets, create new ones, assign each ticket, close others, and navigate to the details of each ticket. + +In this challenge, you will write tests for the `ListComponent`, which represents the global view, and the `RowComponent`, which represents a specific ticket. Additionally, you will need to write unit tests for the `TicketStoreService` using [Angular Testing Library](https://testing-library.com/) . _This library allows you to test services effectively._ + +Handling asynchronous tasks will be particularly challenging. It's important not to introduce any explicit waits in your tests, as this would introduce unnecessary delays. Instead, it's better to look for an element that needs to appear or disappear from the DOM. In this case, the test will naturally wait for the correct period of time, as the waits are already implemented within both libraries. Take advantage of these built-in functionalities to create efficient and reliable tests. + +You can play with it by running : `npx nx serve testing-real-life-application`. + +To run [Angular Testing Library](https://testing-library.com/) test suites, you need to run `npx nx test testing-real-life-application`. You can also install [Jest Runner](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner) to execute your test by clicking on the `Run` button above each `describe` or `it` blocks. + +For testing with Cypress, you will execute your test inside the `child.component.cy.ts` and run `npx nx component-test testing-real-life-application` to execute your test suites. You can add the `--watch` flag to execute your test in watch mode. + +# Statement + +The goal is to test multiple behaviors of the application describe inside each test files using [Angular Testing Library](https://testing-library.com/) and [Cypress Component Testing](https://docs.cypress.io/guides/component-testing/overview). + +:::note +I have created some `it` blocks but feel free to add more tests if you want. +::: diff --git a/website/src/content/challenges/testing/index.mdx b/website/src/content/challenges/testing/index.mdx new file mode 100644 index 000000000..0231ad2ed --- /dev/null +++ b/website/src/content/challenges/testing/index.mdx @@ -0,0 +1,74 @@ +--- +title: Testing +prev: false +next: false +contributors: + - tomalaforge + - LMFinney +description: Introduction to testing challenges. +noCommentSection: true +sidebar: + order: 1 +--- + +import { LinkCard } from '@astrojs/starlight/components'; + +Testing is a crucial step in building scalable, maintainable, and trustworthy applications. +Testing should never be avoided, even in the face of short deadlines or strong pressure from the product team. +Nowadays, there are numerous awesome tools available that make it easy to test your code and provide a great developer experience. + +In this series of testing exercises, we will learn and master [Angular Testing Library](https://testing-library.com/docs/) and [Cypress Component Testing](https://docs.cypress.io/guides/component-testing/angular/overview) that simplifies DOM manipulation for testing any Angular component. + +The benefits of using Angular Testing Library or Cypress Component Testing are to test your component as a black box. You will only interact with what the user can do on the UI. However, the difference with end-to-end tests is that the backend is mocked, which makes the tests faster and more maintainable. +The goal is to mock as little as possible to test your component at a higher level than unit testing, which will make refactoring easier. +Within a real application, integration tests are the tests you will write the most. Learning how to write them will make your application more robust and more maintainable. + +Here is a series of 8 challenges that you can take in any order. + + + + + + + + + + + + + + + + diff --git a/website/src/content/challenges/typescript/15-function-overload.md b/website/src/content/challenges/typescript/15-function-overload.md new file mode 100644 index 000000000..44d289a77 --- /dev/null +++ b/website/src/content/challenges/typescript/15-function-overload.md @@ -0,0 +1,27 @@ +--- +title: 🟠 Function Overload +description: Challenge 15 is about creating overload functions +author: thomas-laforge +contributors: + - tomalaforge + - LMFinney +challengeNumber: 15 +command: typescript-function-overload +blogLink: https://medium.com/ngconf/function-overloading-in-typescript-8236706b2c05 +sidebar: + order: 115 +--- + +## Information + +Angular uses TypeScript, and mastering TypeScript can help you avoid runtime errors by catching them at compile time. + +In this challenge, we have a function to create a vehicle. However, each vehicle type requires different mandatory properties. +Currently, we are getting an error at runtime if one property is missing, and we don't get the return Type, which is not ideal. +One solution would be to create a separate function for each vehicle type, but for this challenge, I want to use the same function and have TypeScript automatically complete the properties depending on the type passed as the first parameter. + +To achieve this, we will use overload functions. + +## Statement + +- Use function overload diff --git a/website/src/content/challenges/typescript/47-enums-vs-union-types.md b/website/src/content/challenges/typescript/47-enums-vs-union-types.md new file mode 100644 index 000000000..6ae54a72e --- /dev/null +++ b/website/src/content/challenges/typescript/47-enums-vs-union-types.md @@ -0,0 +1,80 @@ +--- +title: 🟢 Enums vs Union Types +description: Challenge 47 is about the comparison between enums and union types +author: sven-brodny +contributors: + - svenson95 + - jdegand + - LMFinney +challengeNumber: 47 +command: typescript-enums-vs-union-types +sidebar: + order: 18 +--- + +## Information + +[Enums](https://www.typescriptlang.org/docs/handbook/enums.html) allow developers to define a set of named constants that represent a specific type. TypeScript provides both numeric and string-based enums. + +```typescript +enum Difficulty { + EASY = 'EASY', + NORMAL = 'NORMAL', +} +``` + +On the other hand, [Union Types](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) are simpler than enums, as they don't require any additional runtime or compilation overhead. + +```typescript +type Difficulty = 'EASY' | 'NORMAL'; +``` + +### Reasons to use Union Types + +Enums are a concept borrowed from languages like C# and Java. TypeScript enums are compiled into JavaScript objects with keys for both the names and values of the enum members. This results in larger output files and additional memory consumption, which can be particularly problematic in performance-critical applications. + +Enums have some more pitfalls as well: + +- Non-const enums do not fit the concept of "a typed superset of JavaScript." They violate the concept by emitting global JavaScript objects that live in runtime with a syntax that is not compatible with JavaScript (JavaScript uses dynamic typing rather than static typing; enums are a form of static typing). Since JavaScript has no compilation step, there is little or no value in having static typing. +- Const enums, in contrast, cannot be transpiled with Babel. But there are workarounds for this issue, e.g., using the `babel-plugin-const-enum` plugin. The TypeScript documentation about [const enums](https://www.typescriptlang.org/docs/handbook/enums.html#const-enums) says "_Do not use const enums at all_". +- To use enums, you have to import them. If you want to use enum values in a template, you'll need to declare a variable in your component too. +- Numeric enums are not type safe ... + +```typescript +enum Difficulty { + EASY = 0, + NORMAL = 1, +} +const hard: Difficulty = 2; // no error +``` + +### Reasons to use Enums + +Enums are the best option for code maintainability. It is easy to find all usages of a value in a project and enforce constraints. If you stick to assigning strings to the enum keys all the time, you can avoid a lot of issues. + +It's true that enums produce larger output files, but that's not always a real problem. As long as the enum does its job without any problems, it shouldn't be something you care that much about. + +Another good thing is that the necessary enum prefixes add meaning to otherwise meaningless values, so they can improve readability. For example, `HttpStatus.Forbidden` gives more information than `Forbidden`. + +### Mapped types + +A [mapped type](https://learntypescript.dev/08/l2-mapped-type) is the process of creating a new type by mapping type information from an existing type. + +```typescript +type Difficulty = { [K in 'EASY' | 'NORMAL']: string }; +``` + +### Conclusion + +Enums are not redundant, but in most cases, union types are preferred. Unless you care a lot about maintainability, enums may fit better. Here are some more interesting articles discussing this subject: + +- [Should You Use Enums or Union Types in Typescript?](https://www.bam.tech/article/should-you-use-enums-or-union-types-in-typescript) +- [Typescript has unions, so are enums redundant?](https://stackoverflow.com/questions/40275832/typescript-has-unions-so-are-enums-redundant) +- [Tidy TypeScript: Prefer union types over enums](https://fettblog.eu/tidy-typescript-avoid-enums/) + +## Statement + +The goal of this challenge is to refactor the enums `Difficulty` and `Direction`. + +- Refactor the `Difficulty` enum to **union type**. +- Refactor the `Direction` enum to **mapped type**. diff --git a/website/src/content/guides/checkout-answer.md b/website/src/content/guides/checkout-answer.md new file mode 100644 index 000000000..2e56ce162 --- /dev/null +++ b/website/src/content/guides/checkout-answer.md @@ -0,0 +1,57 @@ +--- +title: Check out Somebody's Answer +description: Guide to checking out someone else's answer. +contributors: + - tomalaforge + - gsgonzalez88 + - 1fbr + - jdegand +sidebar: + order: 3 +--- + +All Angular Challenges answers will be presented in the form of a pull request (PR). To view and follow them, navigate through the **Files Changes** page on GitHub. However, understanding and following this process may not be straightforward if you are not familiar with the interface. In many cases, you may prefer to check out the branch and review the solution in your preferred IDE. + +## Install the GitHub CLI + +Follow the instructions for your operating system [here](https://github.com/cli/cli#installation). + +## Checkout a PR locally from someone else + +### Sync your repository + +First, you need to synchronize your fork to ensure it is up-to-date with the forked repository. + +This can be achieved by clicking the **Sync fork** button on the main page of your fork. + +![Sync project header](../../../assets/fork-sync.png) + +The image above shows that my branch is behind the main branch by 8 commits, and I need to synchronize it to be up to date. + +![Sync project update modal](../../../assets/sync-fork-update.png) + +### Checkout locally + +Navigate to the PR you wish to check out locally and obtain its ID. You will find it in the title of the PR (as shown below). + +![PR header](../../../assets/PR-header.png) + +Next, go to any terminal within your project directory and run the following command: + +```bash +gh pr checkout +``` + +If you don't remember the command, click on the Code button on the right side of the header, and you can easily copy/paste the command. + +![PR code modal](../../../assets/PR-code-btn-modal.png) + +:::note +If the command doesn't work or fails, GitHub CLI will guide you through the process. +::: + +🔥 You can now navigate through the solution locally and serve it to test it. 🔥 + +### Checkout with GitHub Codespaces + +You can checkout any **open** PR with GitHub Codespaces. After clicking the code button, you can navigate to the codespaces tab and click the green button to create a codespace on the PR's branch. After the codespace initializes, you can serve the app. diff --git a/website/src/content/guides/contribute.md b/website/src/content/guides/contribute.md new file mode 100644 index 000000000..45f164a4f --- /dev/null +++ b/website/src/content/guides/contribute.md @@ -0,0 +1,25 @@ +--- +title: Contribute +description: Guide to contribute +contributors: + - tomalaforge + - jdegand +sidebar: + order: 4 +--- + +You can contribute to this repository in many ways: + +🔥 Create a new challenge by following these [instructions](/guides/create-challenge). + +🔥 Answer challenges and submit the results (guide [here](/guides/resolve-challenge)). + +🔥 Give caring, constructive feedback on other people's solutions. + +🔥 Correct typos within the documentation. + +🔥 Assist with the documentation's translation. + +🔥 File an issue to suggest new challenge ideas or report a bug. + +🔥 Sponsor the project [here](https://github.com/sponsors/tomalaforge). diff --git a/website/src/content/guides/create-challenge.md b/website/src/content/guides/create-challenge.md new file mode 100644 index 000000000..f30505a02 --- /dev/null +++ b/website/src/content/guides/create-challenge.md @@ -0,0 +1,74 @@ +--- +title: Create your own challenge +description: Guide to create your own challenge +contributors: + - tomalaforge + - gsgonzalez88 + - jdegand +sidebar: + order: 5 +--- + +You have an idea you want to share, an interesting bug you are struggling with in one of your private or side projects, or an Angular trick you discovered. All of these possibilities are a good starting point to create a challenge and share the solution with others. + +How do you start creating these challenges? + +## Boilerplate Setup + +To streamline the process, I have created an Nx generator that will set up all the boilerplate for you. The easiest way to run it is by using the Nx console: go to the Nx Console > generate > @angular-challenges/cli - challenge. + +Alternatively, you may utilize your IDE's [Nx Console extension](https://nx.dev/getting-started/editor-setup) to generate the files. + +### Parameters + +#### mandatory parameters + +- title: The title you want to give to your challenge. + :::note + The title must be a maximum of 25 characters. + ::: + +- author: Your name + :::note + Your name should be in kebab-case. (e.g. john-doe) + ::: + :::note + Don't forget to update your personal information inside the file at your name. + ::: + +- challengeDifficulty: The difficulty you think your challenge has. There are three difficulty levels : 🟢 easy / 🟠 medium / 🔴 hard + +- category: The category of your challenge. It matches one of the folders under `website/src/content/challenges`: `angular`, `forms`, `nx`, `performance`, `rxjs`, `signal`, `testing` or `typescript`. + +#### optional parameters + +- challengeNumber: You can specify a challenge number if a challenge is being submitted. (If empty, the number will be the next one). +- directory: If you want your application to be located in a specific folder inside `apps`. +- addTest: If you want to add test configuration. + +### What is created? + +- The generator will create all the files needed to have a new working application. All these files will be created inside `apps/${directory}/${name}`. +- A Markdown file with minimal setup will be created inside `docs/src/content/docs/challenges/${category}`. + +:::caution +The generator still writes to the legacy `docs/` folder, which is still built today — so **copy**, +don't move, the generated Markdown file to `website/src/content/challenges/${category}/` and keep +both copies in sync until the legacy site is retired. Without that copy, +`website/tools/generate-content.mjs` will not pick it up and your challenge will not appear on this +site. The author file follows the same rule: `website/src/content/authors/${author}.json`. +::: + +## Challenge Creation + +The only thing left to do is create your challenge. 🚀 + +:::danger +Don't forget to update the docs to introduce your challenge and provide your instructions. +::: + +It's your turn to act!!! 💪 + +## Solution Submission + +After one week or so, provide a pull request of your solution to your challenge. diff --git a/website/src/content/guides/faq.md b/website/src/content/guides/faq.md new file mode 100644 index 000000000..524e0f1e1 --- /dev/null +++ b/website/src/content/guides/faq.md @@ -0,0 +1,20 @@ +--- +title: FAQ +description: Answer to question +contributors: + - tomalaforge + - jdegand +sidebar: + order: 7 +--- + +
+ Why is my application not starting, or why do I encounter errors in my terminal when I run `nx serve`? + + Most of the time, this issue arises because your node_modules are outdated, and you need to update them by running `pnpm i --frozen-lockfile`. + +If the installation process fails, you can resolve it by deleting your node_modules folder using the command `rm -rf node_modules` or `npx npkill` and then re-running `pnpm i --frozen-lockfile`. + +If the problem persists, please report the issue [here](https://github.com/tomalaforge/angular-challenges/issues/new). + +
diff --git a/website/src/content/guides/getting-started.md b/website/src/content/guides/getting-started.md new file mode 100644 index 000000000..fdebab874 --- /dev/null +++ b/website/src/content/guides/getting-started.md @@ -0,0 +1,82 @@ +--- +title: Getting Started +description: A guide on how to get started with Angular Challenges. +contributors: + - tomalaforge + - 1fbr + - ho-ssain + - jdegand +sidebar: + order: 1 +--- + +To get started with Angular Challenges, follow these steps: + +## Create a GitHub Account + +If you wish to submit an answer, you will need to have your own GitHub account. Additionally, having a GitHub account is always beneficial, and it's free. + +## Fork the GitHub project + +Navigate to the [Angular Challenges Repository](https://github.com/tomalaforge/angular-challenges) and click on the Fork button in the header. This will create a copy of this repository on your own GitHub profile. + +## Clone the repository to your local machine + +Select a directory on your local computer and clone this repository. + +Open a terminal, navigate to the chosen directory, and type the following command: + +```bash +git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git +``` + +:::note +You can find the clone URL by clicking on the <> Code button in your own instance of the Angular Challenges repository. + +![Header of GitHub workspace](../../../assets/header-github.png) + +::: + +## Open the project in your favourite IDE + +Open the project in any IDE of your choice. + +## Install all dependencies + +```bash +pnpm i --frozen-lockfile +``` + +## Choose a challenge + +Your project is now up and running. The only remaining step is to choose a challenge 🚀 + +Each challenge consists of: + +- Name: indicating what the challenge is about. +- Number: order of creation. The number doesn't have any particular meaning but helps for reference in GitHub Pull Request section. +- Badge: helps visualize the degree of difficulty. It's entirely subjective 😅 + - 🟢 easy + - 🟠 medium + - 🔴 difficult + +## (Alternately) Use GitHub Codespaces + +From your own instance of the Angular Challenges repository, click the code button and navigate to the codespaces tab. + +![Codespaces tab](../../../assets/codespaces.png) + +Click the `Create codespace on main` button, and you will navigate to a GitHub codespace. + +If you never used a GitHub codespace before, I would recommend you try this short interactive [GitHub Skills Tutorial](https://github.com/skills/code-with-codespaces). + +When you navigate to the codespace, there will be a prompt to install the recommended `VS Code` plugins. If you plan on creating a challenge, you can use the `Nx plugin` to generate the starter code. Either way, the codespace will install the dependencies, and you can create a new branch, tackle any challenge, and create a pull request. + +When you push to a branch, you do not have to provide a GitHub token. + +Once you are finished, remember to pause or delete your codespace. If you don't, GitHub will automatically pause an idle codespace after 30 minutes. You do have a generous amount of free codespace time per month, but it is still important not to waste your allotment. + +In the GitHub codespace, copy and paste will be blocked until you give permission. + +The GitHub codespace uses port forwarding to serve the projects. Click the prompt after running `npx nx serve [project-name]` to navigate to `localhost:4200`. diff --git a/website/src/content/guides/rebase.md b/website/src/content/guides/rebase.md new file mode 100644 index 000000000..1b50f4c9f --- /dev/null +++ b/website/src/content/guides/rebase.md @@ -0,0 +1,62 @@ +--- +title: Rebase your branch +description: Guide to rebase a branch to latest change +contributors: + - tomalaforge +sidebar: + order: 6 +--- + +Sometimes, changes may be added to the project. I'll attempt to make changes that won't break anything, but sometimes it's inevitable. + +Most of the time, you won't need to rebase your solution, but here is a guide to help you know how to do it. + +:::note +This guide is applicable to any Open Source Project. +::: + +## Steps to rebase your branch + +### Sync your repository + +First, you need to synchronize your fork to ensure it's up to date with the forked repository. + +You can achieve this by clicking the Sync fork button on the main page of your fork. + +![Sync project header](../../../assets/fork-sync.png) + +The image above shows that my branch is behind of the main branch by 8 commits, and I need to synchronize it to be up to date. + +![Sync project update modal](../../../assets/sync-fork-update.png) + +### Open a terminal + +Open any terminal of your choice, either the one from your favorite IDE or a standalone instance. + +### Git + +Follow the following commands to rebase your local branch: + +- git checkout main +- git pull +- git checkout [your branch] +- git rebase main +- Resolve Conflicts + +At this step, the rebase may stop because your local branch has conflicting files with the main branch. Correct them. After this is done: + +- git add . +- git rebase --continue + +If your branch doesn't have any conflicts, a success message will be shown. + +### Push your work back to the remote branch + +Finally, push your work back to GitHub: + +- git push --force-with-lease origin [your branch] + +:::note +`--force-with-lease` is safer than `-f`: it refuses to push if someone else has added commits to +the remote branch since your last fetch, instead of silently overwriting their work. +::: diff --git a/website/src/content/guides/resolve-challenge.md b/website/src/content/guides/resolve-challenge.md new file mode 100644 index 000000000..0d3b345fd --- /dev/null +++ b/website/src/content/guides/resolve-challenge.md @@ -0,0 +1,110 @@ +--- +title: Resolve a Challenge +description: Guide to resolve a challenge +contributors: + - tomalaforge + - 1fbr + - gsgonzalez88 +sidebar: + order: 2 +--- + +In this guide, you will learn how to resolve a challenge and submit an answer to the main GitHub repository. + +## Introduction + +This repository is powered by [Nx](https://nx.dev/getting-started/intro). Nx is a monorepository that allows you to store multiple applications inside the same workspace. Each challenge is a separate application. If you open the `apps` directory, you will find multiple directories, each related to a specific challenge. Each directory represents a complete standalone `Nx` application. To run and start with one, open your terminal and run: + +```bash +npx nx serve +``` + +:::note +If you are unsure of your `APPLICATION_NAME`, open the README.md file. The `serve` command is written there, with a link to the challenge documentation. +::: + +:::note +If `nx` is installed globally on your device, you can skip using `pnpm exec`. + +To install `nx` globally, run + +```bash +pnpm add -g nx +``` + +or + +```bash +npm i -g nx +``` + +::: + +## Create a Git Branch + +Before you start implementing your solution to resolve a challenge, create a git branch to commit your work. + +```bash +git checkout -b +``` + +## Resolve the Challenge + +Follow the instructions to resolve the challenge. + +## Commit and Push your Work + +The last step is to commit your work following the [Conventional Guidelines](https://www.conventionalcommits.org/en/v1.0.0/). + +Finally, push your work to the remote repository with the following command + +```bash + git push --set-upstream origin +``` + +:::tip[Don't remember it] +You don't have to remember the command precisely. You just need to remember `git push` and if it's the first time you are pushing this branch, `git` will provide you with the complete command. +::: + +## Submit your Work to the Main Repository + +Now, all your work is located insite your local instance of the Angular Challenges repository. + +The next step is to go to the main [Angular Challenges page](https://github.com/tomalaforge/angular-challenges) and create a new Pull Request. + +GitHub should display a notification header to help you create the pull request. + +If it's not the case, you either have done one of the previous steps incorrectly or you can go to the Pull Request tab and click the button New pull request. + +Once you have chosen the two branches to compare, you should arrive on the following page: + +![New pull request screen](../../../assets/new-pull-request.png) + +In the title section, start with Answer: followed by your challenge number. After that, you are free to add anything you would like. + +:::danger +This is very important. It lets others know which challenge you are attempting to resolve. +::: + +In the description section, you can add questions, troubles you encountered, or anything else you want to share. You can leave it empty if you don't have anything to say. + +You can now click on Create pull request. + +## Get a review + +To continue providing valuable feedback and reviews, support the project on Github: + +
    +
  • $5 per review
    • +
  • $30 for lifetime reviews
    • +
+ +:::note +You should still submit your PR to join the list of answered challenges. And you can still be reviewed by a community member. 🔥 + +Everyone is welcome to comment and read other PRs. 💪 +::: + +:::tip[OSS champion] +🔥 Once you have completed this tutorial, you are ready to contribute to any other public GitHub repository and submit a PR. It is as easy as that. 🔥 +::: diff --git a/website/src/index.html b/website/src/index.html new file mode 100644 index 000000000..620da3991 --- /dev/null +++ b/website/src/index.html @@ -0,0 +1,44 @@ + + + + + Angular Challenges + + + + + + + + + + + + + diff --git a/website/src/main.server.ts b/website/src/main.server.ts new file mode 100644 index 000000000..723e001fb --- /dev/null +++ b/website/src/main.server.ts @@ -0,0 +1,8 @@ +import { BootstrapContext, bootstrapApplication } from '@angular/platform-browser'; +import { App } from './app/app'; +import { config } from './app/app.config.server'; + +const bootstrap = (context: BootstrapContext) => + bootstrapApplication(App, config, context); + +export default bootstrap; diff --git a/website/src/main.ts b/website/src/main.ts new file mode 100644 index 000000000..5df75f9c8 --- /dev/null +++ b/website/src/main.ts @@ -0,0 +1,6 @@ +import { bootstrapApplication } from '@angular/platform-browser'; +import { appConfig } from './app/app.config'; +import { App } from './app/app'; + +bootstrapApplication(App, appConfig) + .catch((err) => console.error(err)); diff --git a/website/src/server.ts b/website/src/server.ts new file mode 100644 index 000000000..f1cf30179 --- /dev/null +++ b/website/src/server.ts @@ -0,0 +1,83 @@ +import { + AngularNodeAppEngine, + createNodeRequestHandler, + isMainModule, + writeResponseToNodeResponse, +} from '@angular/ssr/node'; +import express from 'express'; +import { join } from 'node:path'; +import { githubApi } from './server/github-api'; +import { authRoutes } from './server/auth'; + +const browserDistFolder = join(import.meta.dirname, '../browser'); + +const app = express(); +// Custom domains can be added later via the NG_ALLOWED_HOSTS env var (takes precedence). +const angularApp = new AngularNodeAppEngine({ + allowedHosts: ['localhost', '*.vercel.app'], +}); + +/** + * Example Express Rest API endpoints can be defined here. + * Uncomment and define endpoints as necessary. + * + * Example: + * ```ts + * app.get('/api/{*splat}', (req, res) => { + * // Handle API request + * }); + * ``` + */ + +/** + * JSON API backed by the GitHub REST API (cached server-side). + */ +app.use('/api', githubApi); + +/** + * GitHub OAuth sign-in flow (sets an httpOnly cookie). + */ +app.use('/auth', authRoutes); + +/** + * Serve static files from /browser + */ +app.use( + express.static(browserDistFolder, { + maxAge: '1y', + index: false, + redirect: false, + }), +); + +/** + * Handle all other requests by rendering the Angular application. + */ +app.use((req, res, next) => { + angularApp + .handle(req) + .then((response) => + response ? writeResponseToNodeResponse(response, res) : next(), + ) + .catch(next); +}); + +/** + * Start the server if this module is the main entry point, or it is ran via PM2. + * The server listens on the port defined by the `PORT` environment variable, or defaults to 4000. + */ +if (isMainModule(import.meta.url) || process.env['pm_id']) { + const port = process.env['PORT'] || 4000; + app.listen(port, (error) => { + if (error) { + throw error; + } + + console.log(`Node Express server listening on http://localhost:${port}`); + }); +} + +/** + * Request handler used by the Angular CLI (for dev-server and during build) or Firebase Cloud Functions. + */ +export const reqHandler = createNodeRequestHandler(app); diff --git a/website/src/server/auth.ts b/website/src/server/auth.ts new file mode 100644 index 000000000..ec1c50aa2 --- /dev/null +++ b/website/src/server/auth.ts @@ -0,0 +1,139 @@ +import { randomBytes, timingSafeEqual } from 'node:crypto'; +import { Router, Request } from 'express'; + +export const AUTH_COOKIE = 'gh_token'; +const STATE_COOKIE = 'gh_oauth_state'; + +/** Reads a single cookie value from the request `Cookie` header. */ +export function readCookie(req: Request, name: string): string | null { + const header = req.headers.cookie; + if (!header) { + return null; + } + for (const part of header.split(';')) { + const [key, ...rest] = part.trim().split('='); + if (key === name) { + return decodeURIComponent(rest.join('=')); + } + } + return null; +} + +export function readAuthCookie(req: Request): string | null { + return readCookie(req, AUTH_COOKIE); +} + +/** + * Resolves the public origin of the site. `SITE_ORIGIN` wins when configured, because + * forwarded headers are client-supplied and must not decide the OAuth `redirect_uri` + * nor whether cookies get the `Secure` attribute. + */ +function siteOrigin(req: Request): string { + const configured = process.env['SITE_ORIGIN']; + if (configured) { + return configured.replace(/\/+$/, ''); + } + const forwardedHost = String(req.headers['x-forwarded-host'] ?? '') + .split(',')[0] + .trim(); + const host = forwardedHost || req.headers.host || 'localhost:4000'; + const forwardedProto = String(req.headers['x-forwarded-proto'] ?? '') + .split(',')[0] + .trim(); + const proto = forwardedProto || (isLocalHost(host) ? 'http' : 'https'); + return `${proto}://${host}`; +} + +function isLocalHost(host: string): boolean { + const hostname = host.split(':')[0]; + return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '[::1]'; +} + +function safeEqual(a: string, b: string): boolean { + const left = Buffer.from(a); + const right = Buffer.from(b); + return left.length === right.length && timingSafeEqual(left, right); +} + +/** Only same-site paths are allowed as post-login redirect targets. */ +function safePath(value: unknown): string { + const path = String(value ?? '/'); + return path.startsWith('/') && !path.startsWith('//') ? path : '/'; +} + +export const authRoutes = Router(); + +authRoutes.get('/authorize', (req, res) => { + const clientId = process.env['GITHUB_CLIENT_ID']; + if (!clientId) { + res.status(503).send('GitHub sign-in is not configured yet (missing GITHUB_CLIENT_ID).'); + return; + } + const origin = siteOrigin(req); + const secure = origin.startsWith('https') ? '; Secure' : ''; + const nonce = randomBytes(16).toString('hex'); + res.setHeader( + 'Set-Cookie', + `${STATE_COOKIE}=${nonce}; Path=/auth; HttpOnly; SameSite=Lax; Max-Age=600${secure}`, + ); + const params = new URLSearchParams({ + client_id: clientId, + redirect_uri: `${origin}/auth/callback`, + scope: 'public_repo', + state: `${nonce}:${safePath(req.query['redirect_uri'])}`, + }); + res.redirect(302, `https://github.com/login/oauth/authorize?${params}`); +}); + +authRoutes.get('/callback', async (req, res) => { + const clientId = process.env['GITHUB_CLIENT_ID']; + const clientSecret = process.env['GITHUB_CLIENT_SECRET']; + const [nonce, ...pathParts] = String(req.query['state'] ?? '').split(':'); + const returnTo = safePath(pathParts.join(':')); + const expectedNonce = readCookie(req, STATE_COOKIE); + const code = req.query['code']; + + const secure = siteOrigin(req).startsWith('https') ? '; Secure' : ''; + const clearState = `${STATE_COOKIE}=; Path=/auth; HttpOnly; SameSite=Lax; Max-Age=0${secure}`; + + // The nonce ties the callback to the browser that started the flow: without it an + // attacker could plant their own authorization code in a victim's session. + if ( + !clientId || + !clientSecret || + !code || + req.query['error'] || + !expectedNonce || + !safeEqual(nonce, expectedNonce) + ) { + res.setHeader('Set-Cookie', clearState); + res.redirect(302, returnTo); + return; + } + + try { + const response = await fetch('https://github.com/login/oauth/access_token', { + method: 'POST', + headers: { Accept: 'application/json', 'Content-Type': 'application/json' }, + body: JSON.stringify({ client_id: clientId, client_secret: clientSecret, code }), + }); + const data = (await response.json()) as { access_token?: string }; + if (data.access_token) { + res.setHeader('Set-Cookie', [ + clearState, + `${AUTH_COOKIE}=${encodeURIComponent(data.access_token)}; Path=/; HttpOnly; SameSite=Lax; Max-Age=${60 * 60 * 24 * 7}${secure}`, + ]); + } + } catch { + // Fall through: user comes back logged out. + } + if (!res.hasHeader('Set-Cookie')) { + res.setHeader('Set-Cookie', clearState); + } + res.redirect(302, returnTo); +}); + +authRoutes.get('/logout', (req, res) => { + res.setHeader('Set-Cookie', `${AUTH_COOKIE}=; Path=/; HttpOnly; SameSite=Lax; Max-Age=0`); + res.redirect(302, safePath(req.query['redirect_uri'])); +}); diff --git a/website/src/server/github-api.ts b/website/src/server/github-api.ts new file mode 100644 index 000000000..e9db180d5 --- /dev/null +++ b/website/src/server/github-api.ts @@ -0,0 +1,551 @@ +import { Router } from 'express'; +import { readAuthCookie } from './auth'; + +const REPO = 'tomalaforge/angular-challenges'; +const REPO_FIRST_YEAR = 2022; +const EXCLUDED_USERS = new Set(['allcontributors[bot]', 'tomalaforge']); +const GITHUB_API = 'https://api.github.com'; + +interface CacheEntry { + expires: number; + status: number; + data: unknown; +} + +/** Tiny in-memory TTL cache — enough to stay far below GitHub rate limits. */ +const cache = new Map(); +/** Per-PR paths would otherwise make the cache grow without bound on a warm instance. */ +const CACHE_MAX_ENTRIES = 500; +const REQUEST_TIMEOUT_MS = 10_000; +const RATE_LIMIT_RETRIES = 2; + +/** Writes an entry, evicting the least recently written ones once the cap is reached. */ +function setCache(key: string, entry: CacheEntry): void { + cache.delete(key); + cache.set(key, entry); + while (cache.size > CACHE_MAX_ENTRIES) { + const oldest = cache.keys().next(); + if (oldest.done) { + break; + } + cache.delete(oldest.value); + } +} + +function delay(ms: number): Promise { + return new Promise((resolve) => setTimeout(resolve, ms)); +} + +/** Retry-After / X-RateLimit-Reset aware backoff, capped so a request never hangs a page. */ +function retryDelayMs(response: Response, attempt: number): number { + const retryAfter = Number(response.headers.get('retry-after')); + if (Number.isFinite(retryAfter) && retryAfter > 0) { + return Math.min(retryAfter * 1000, 10_000); + } + return Math.min(1000 * 2 ** attempt, 8000); +} + +async function githubFetch(path: string, headers: Record): Promise { + return fetch(`${GITHUB_API}${path}`, { + headers, + signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), + }); +} + +async function github( + path: string, + ttlSeconds: number, +): Promise<{ status: number; data: unknown }> { + const cached = cache.get(path); + if (cached && cached.expires > Date.now()) { + return cached; + } + const headers: Record = { + Accept: 'application/vnd.github+json', + 'X-GitHub-Api-Version': '2022-11-28', + 'User-Agent': 'angular-challenges-website', + }; + const token = process.env['GITHUB_TOKEN']; + if (token) { + headers['Authorization'] = `Bearer ${token}`; + } + + let response: Response; + try { + response = await githubFetch(path, headers); + // 403/429 are GitHub's primary and secondary rate limits: back off and retry. + for (let attempt = 0; attempt < RATE_LIMIT_RETRIES; attempt++) { + if (response.status !== 403 && response.status !== 429) { + break; + } + await delay(retryDelayMs(response, attempt)); + response = await githubFetch(path, headers); + } + } catch (error) { + if (cached) { + // Serve stale data instead of surfacing a network or timeout error. + return cached; + } + console.error('GitHub request failed', path, error); + return { status: 503, data: { error: 'github request failed' } }; + } + + const data = await response.json().catch(() => null); + const entry = { status: response.status, data, expires: Date.now() + ttlSeconds * 1000 }; + if (response.ok) { + setCache(path, entry); + } else if (cached) { + // Serve stale data instead of surfacing a rate-limit error. + return cached; + } + return entry; +} + +interface GithubLabel { + name: string; +} + +/** Maps items concurrently, at most `limit` at a time. */ +async function mapLimit( + items: T[], + limit: number, + fn: (item: T) => Promise, +): Promise { + const results: R[] = new Array(items.length); + let next = 0; + const workers = Array.from({ length: Math.min(limit, items.length) }, async () => { + while (next < items.length) { + const index = next++; + results[index] = await fn(items[index]); + } + }); + await Promise.all(workers); + return results; +} + +/** + * Runs a search query across all result pages, concurrently but capped to + * stay clear of GitHub's secondary rate limits. The search API caps a single + * query at 1000 results (10 pages), so the query is additionally partitioned + * per creation year; each year's page 1 reveals via total_count how many more + * pages need fetching. + * + * A failing page marks the result `partial` rather than discarding every page + * already fetched; `null` is only returned when no page at all could be read. + */ +async function searchAllIssues( + baseQuery: string, + ttlSeconds: number, +): Promise<{ items: any[]; partial: boolean } | null> { + const currentYear = new Date().getFullYear(); + const years = Array.from( + { length: currentYear - REPO_FIRST_YEAR + 1 }, + (_, i) => REPO_FIRST_YEAR + i, + ); + const pageUrl = (year: number, page: number) => { + const query = encodeURIComponent( + `repo:${REPO} is:pr ${baseQuery} created:${year}-01-01..${year}-12-31`, + ); + return `/search/issues?q=${query}&per_page=100&page=${page}`; + }; + + const firstPages = await mapLimit(years, 4, (year) => github(pageUrl(year, 1), ttlSeconds)); + + const items: any[] = []; + const remaining: string[] = []; + let partial = false; + let succeeded = 0; + for (const [index, { status, data }] of firstPages.entries()) { + if (status !== 200) { + partial = true; + continue; + } + succeeded++; + const { items: batch = [], total_count: total = 0 } = data as { + items: any[]; + total_count: number; + }; + items.push(...batch); + const pageCount = Math.min(Math.ceil(total / 100), 10); + for (let page = 2; page <= pageCount; page++) { + remaining.push(pageUrl(years[index], page)); + } + } + + if (succeeded === 0) { + return null; + } + + const restPages = await mapLimit(remaining, 4, (url) => github(url, ttlSeconds)); + for (const { status, data } of restPages) { + if (status !== 200) { + partial = true; + continue; + } + items.push(...((data as { items: any[] }).items ?? [])); + } + return { items, partial }; +} + +interface LeaderboardEntry { + login: string; + avatar: string; + count: number; +} + +function toLeaderboard( + counts: Map }>, +): LeaderboardEntry[] { + return [...counts.entries()] + .filter(([login]) => !EXCLUDED_USERS.has(login)) + .map(([login, entry]) => ({ login, avatar: entry.avatar, count: entry.values.size })) + .sort((a, b) => b.count - a.count); +} + +function accumulate( + counts: Map }>, + item: any, + value: string | number, +): void { + const login = item.user?.login; + if (!login) { + return; + } + const entry = counts.get(login) ?? { avatar: item.user.avatar_url, values: new Set() }; + entry.values.add(value); + counts.set(login, entry); +} + +export const githubApi = Router(); + +/** The signed-in user, based on the auth cookie. */ +githubApi.get('/me', async (req, res) => { + const token = readAuthCookie(req); + if (!token) { + res.status(401).json({ error: 'not signed in' }); + return; + } + let response: Response; + try { + response = await fetch(`${GITHUB_API}/user`, { + headers: { + Accept: 'application/vnd.github+json', + Authorization: `Bearer ${token}`, + 'User-Agent': 'angular-challenges-website', + }, + signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), + }); + } catch { + res.status(503).json({ error: 'github request failed' }); + return; + } + if (!response.ok) { + res.status(401).json({ error: 'invalid token' }); + return; + } + const user = (await response.json()) as any; + res.set('Cache-Control', 'private, no-store'); + res.json({ login: user.login, avatar: user.avatar_url }); +}); + +/** 👍 a solution PR on behalf of the signed-in user. */ +githubApi.post('/pulls/:number/react', async (req, res) => { + const token = readAuthCookie(req); + if (!token) { + res.status(401).json({ error: 'not signed in' }); + return; + } + const number = Number(req.params['number']); + if (!Number.isInteger(number) || number <= 0) { + res.status(400).json({ error: 'invalid PR number' }); + return; + } + let response: Response; + try { + response = await fetch(`${GITHUB_API}/repos/${REPO}/issues/${number}/reactions`, { + method: 'POST', + headers: { + Accept: 'application/vnd.github+json', + Authorization: `Bearer ${token}`, + 'User-Agent': 'angular-challenges-website', + 'Content-Type': 'application/json', + }, + body: JSON.stringify({ content: '+1' }), + signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), + }); + } catch { + res.status(503).json({ error: 'github request failed' }); + return; + } + if (!response.ok) { + res.status(response.status).json({ error: 'reaction failed' }); + return; + } + res.status(201).json({ ok: true }); +}); + +const BOARD_QUERIES: Record = { + answers: 'label:"answer"', + challenges: 'label:"challenge-creation"', + commit: 'no:label', +}; + +async function buildLeaderboard( + board: string, +): Promise<{ entries: LeaderboardEntry[]; partial: boolean } | null> { + const result = await searchAllIssues(BOARD_QUERIES[board], 1800); + if (!result) { + return null; + } + const counts = new Map }>(); + for (const item of result.items) { + if (board === 'answers') { + const challenge = item.labels + ?.map((l: GithubLabel) => Number(l.name)) + .find((n: number) => Number.isInteger(n) && n > 0); + if (challenge) { + accumulate(counts, item, challenge); + } + } else { + accumulate(counts, item, item.number); + } + } + return { entries: toLeaderboard(counts), partial: result.partial }; +} + +/** + * Aggregated leaderboards with stale-while-revalidate semantics: a stale + * board is served immediately while a single refresh runs in the background. + */ +const boardCache = new Map(); +const boardRefreshing = new Map>(); +const BOARD_TTL_MS = 30 * 60 * 1000; +/** A board built from an incomplete page set is cached briefly, then retried. */ +const BOARD_PARTIAL_TTL_MS = 5 * 60 * 1000; + +function refreshBoard(board: string): Promise { + let inflight = boardRefreshing.get(board); + if (!inflight) { + inflight = buildLeaderboard(board) + .then((result) => { + if (!result) { + return null; + } + boardCache.set(board, { + expires: Date.now() + (result.partial ? BOARD_PARTIAL_TTL_MS : BOARD_TTL_MS), + entries: result.entries, + }); + return result.entries; + }) + .finally(() => boardRefreshing.delete(board)); + boardRefreshing.set(board, inflight); + } + return inflight; +} + +/** Leaderboards, aggregated server-side and cached for 30 minutes. */ +githubApi.get('/leaderboard/:board', async (req, res) => { + const board = req.params['board']; + if (!BOARD_QUERIES[board]) { + res.status(404).json({ error: 'unknown leaderboard' }); + return; + } + + const cached = boardCache.get(board); + if (cached) { + if (cached.expires <= Date.now()) { + // Stale: kick off one background refresh, still answer instantly. + void refreshBoard(board).catch(() => undefined); + } + res.set('Cache-Control', 'public, s-maxage=1800, stale-while-revalidate=86400'); + res.json({ entries: cached.entries }); + return; + } + + const entries = await refreshBoard(board); + if (!entries) { + res.status(503).json({ error: 'github request failed' }); + return; + } + res.set('Cache-Control', 'public, s-maxage=1800, stale-while-revalidate=86400'); + res.json({ entries }); +}); + +/** Repository stats for the landing page. */ +githubApi.get('/stats', async (_req, res) => { + const { status, data } = await github(`/repos/${REPO}`, 900); + if (status !== 200) { + res.status(503).json({ error: 'github request failed' }); + return; + } + const repo = data as any; + res.set('Cache-Control', 'public, s-maxage=900, stale-while-revalidate=3600'); + res.json({ + stars: repo.stargazers_count, + forks: repo.forks_count, + openIssues: repo.open_issues_count, + }); +}); + +/** Active sponsors (needs a GITHUB_TOKEN with sponsorship read access). */ +githubApi.get('/sponsors', async (_req, res) => { + const token = process.env['GITHUB_TOKEN']; + if (!token) { + res.set('Cache-Control', 'public, s-maxage=900'); + res.json({ sponsors: [] }); + return; + } + const cached = cache.get('sponsors'); + if (cached && cached.expires > Date.now()) { + res.set('Cache-Control', 'public, s-maxage=900, stale-while-revalidate=86400'); + res.json(cached.data); + return; + } + const query = `query { + user(login: "tomalaforge") { + sponsorshipsAsMaintainer(activeOnly: true, first: 100) { + nodes { + sponsorEntity { + ... on User { login avatarUrl } + ... on Organization { login avatarUrl } + } + } + } + } + }`; + try { + const response = await fetch('https://api.github.com/graphql', { + method: 'POST', + headers: { + Authorization: `Bearer ${token}`, + 'Content-Type': 'application/json', + 'User-Agent': 'angular-challenges-website', + }, + body: JSON.stringify({ query }), + signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS), + }); + const data = (await response.json()) as any; + if (data?.errors) { + console.error('sponsors graphql failed', JSON.stringify(data.errors)); + res.status(503).json({ error: data.errors[0]?.message ?? 'graphql failed' }); + return; + } + const sponsors = + data?.data?.user?.sponsorshipsAsMaintainer?.nodes + ?.map((n: any) => n?.sponsorEntity) + .filter(Boolean) + .map((s: any) => ({ login: s.login, avatar: s.avatarUrl })) ?? []; + const payload = { sponsors }; + setCache('sponsors', { expires: Date.now() + 900_000, status: 200, data: payload }); + res.set('Cache-Control', 'public, s-maxage=900, stale-while-revalidate=86400'); + res.json(payload); + } catch { + res.status(503).json({ error: 'github request failed' }); + } +}); + +/** All solution PRs for a challenge, author solutions first, then by 👍. */ +githubApi.get('/challenges/:number/solutions', async (req, res) => { + const number = Number(req.params['number']); + if (!Number.isInteger(number) || number <= 0) { + res.status(400).json({ error: 'invalid challenge number' }); + return; + } + const query = encodeURIComponent(`repo:${REPO} is:pr label:${number}`); + const { status, data } = await github( + `/search/issues?q=${query}&per_page=100&sort=reactions-+1&order=desc`, + 300, + ); + if (status !== 200) { + res.status(status === 403 ? 503 : status).json({ error: 'github request failed' }); + return; + } + const items = (data as { items: any[] }).items ?? []; + const solutions = items + .filter((item) => + item.labels?.some((l: GithubLabel) => l.name === 'answer' || l.name === 'answer author'), + ) + .map((item) => ({ + number: item.number, + title: item.title, + login: item.user?.login, + avatar: item.user?.avatar_url, + isAuthor: item.labels.some((l: GithubLabel) => l.name === 'answer author'), + state: item.state, + merged: !!item.pull_request?.merged_at, + thumbsUp: item.reactions?.['+1'] ?? 0, + comments: item.comments ?? 0, + createdAt: item.created_at, + htmlUrl: item.html_url, + })) + .sort((a, b) => Number(b.isAuthor) - Number(a.isAuthor) || b.thumbsUp - a.thumbsUp); + + res.set('Cache-Control', 'public, s-maxage=300, stale-while-revalidate=600'); + res.json({ solutions }); +}); + +/** PR metadata for the diff header. */ +githubApi.get('/pulls/:number', async (req, res) => { + const number = Number(req.params['number']); + if (!Number.isInteger(number) || number <= 0) { + res.status(400).json({ error: 'invalid PR number' }); + return; + } + const { status, data } = await github(`/repos/${REPO}/pulls/${number}`, 3600); + if (status !== 200) { + res.status(status === 403 ? 503 : status).json({ error: 'github request failed' }); + return; + } + const pr = data as any; + res.set('Cache-Control', 'public, s-maxage=3600, stale-while-revalidate=86400'); + res.json({ + number: pr.number, + title: pr.title, + login: pr.user?.login, + avatar: pr.user?.avatar_url, + state: pr.state, + merged: pr.merged, + createdAt: pr.created_at, + htmlUrl: pr.html_url, + additions: pr.additions, + deletions: pr.deletions, + changedFiles: pr.changed_files, + }); +}); + +/** Changed files with patches for the diff view. */ +githubApi.get('/pulls/:number/files', async (req, res) => { + const number = Number(req.params['number']); + if (!Number.isInteger(number) || number <= 0) { + res.status(400).json({ error: 'invalid PR number' }); + return; + } + const files: any[] = []; + for (let page = 1; page <= 3; page++) { + const { status, data } = await github( + `/repos/${REPO}/pulls/${number}/files?per_page=100&page=${page}`, + 3600, + ); + if (status !== 200) { + res.status(status === 403 ? 503 : status).json({ error: 'github request failed' }); + return; + } + const batch = data as any[]; + files.push(...batch); + if (batch.length < 100) { + break; + } + } + res.set('Cache-Control', 'public, s-maxage=3600, stale-while-revalidate=86400'); + res.json({ + files: files.map((f) => ({ + filename: f.filename, + previousFilename: f.previous_filename, + status: f.status, + additions: f.additions, + deletions: f.deletions, + patch: f.patch ?? null, + blobUrl: f.blob_url, + })), + }); +}); diff --git a/website/src/styles.css b/website/src/styles.css new file mode 100644 index 000000000..e111f3dcc --- /dev/null +++ b/website/src/styles.css @@ -0,0 +1,245 @@ +@import 'tailwindcss'; +@plugin '@tailwindcss/typography'; + +/* Dark mode is driven by the `.dark` class on (see src/app/theme.ts), + not by the OS preference alone. */ +@custom-variant dark (&:where(.dark, .dark *)); + +/* --- Markdown document styling ------------------------------------------ */ + +/* Mobile safety: long tokens (npx commands, file paths, URLs) must never + force the page wider than the viewport, and wide tables scroll in place. */ +.doc-prose { + overflow-wrap: break-word; +} + +.doc-prose table { + display: block; + max-width: 100%; + overflow-x: auto; +} + +/* Inline code: drop the literal backticks Tailwind Typography renders and + style it as a highlighted chip instead. */ +.doc-prose :where(code):not(:where(pre code))::before, +.doc-prose :where(code):not(:where(pre code))::after { + content: none; +} + +.doc-prose :where(code):not(:where(pre code)) { + background: color-mix(in srgb, var(--color-neutral-200) 70%, transparent); + border: 1px solid var(--color-neutral-300); + border-radius: 0.375rem; + padding: 0.125rem 0.375rem; + font-size: 0.85em; + font-weight: 500; + color: var(--color-neutral-800); +} + +.dark .doc-prose :where(code):not(:where(pre code)) { + background: color-mix(in srgb, var(--color-neutral-800) 70%, transparent); + border-color: var(--color-neutral-700); + color: var(--color-neutral-100); +} + +.doc-prose pre.shiki { + border-radius: 0.5rem; + padding: 1rem; + overflow-x: auto; + font-size: 0.875rem; + line-height: 1.6; + border: 1px solid var(--color-neutral-200); +} + +.dark .doc-prose pre.shiki { + border-color: var(--color-neutral-800); +} + +/* Shiki dual-theme output: light colors are inline, dark colors live in + `--shiki-dark*` custom properties (see tools/generate-content.mjs). */ +.dark .shiki, +.dark .shiki span { + color: var(--shiki-dark) !important; + background-color: var(--shiki-dark-bg) !important; + font-style: var(--shiki-dark-font-style) !important; + font-weight: var(--shiki-dark-font-weight) !important; + text-decoration: var(--shiki-dark-text-decoration) !important; +} + +.doc-prose .doc-aside { + border: 1px solid; + border-radius: 0.5rem; + padding: 1rem; + margin: 1.25rem 0; +} + +.doc-prose .doc-aside__title { + font-weight: 600; + margin: 0 0 0.5rem; +} + +.doc-prose .doc-aside__content > :first-child { + margin-top: 0; +} +.doc-prose .doc-aside__content > :last-child { + margin-bottom: 0; +} + +.doc-prose .doc-aside--note { + border-color: var(--color-blue-200); + background: color-mix(in srgb, var(--color-blue-50) 60%, transparent); +} +.doc-prose .doc-aside--tip { + border-color: var(--color-violet-200); + background: color-mix(in srgb, var(--color-violet-50) 60%, transparent); +} +.doc-prose .doc-aside--caution { + border-color: var(--color-amber-200); + background: color-mix(in srgb, var(--color-amber-50) 60%, transparent); +} +.doc-prose .doc-aside--danger { + border-color: var(--color-red-200); + background: color-mix(in srgb, var(--color-red-50) 60%, transparent); +} + +.dark .doc-prose .doc-aside--note { + border-color: var(--color-blue-800); + background: color-mix(in srgb, var(--color-blue-950) 40%, transparent); +} +.dark .doc-prose .doc-aside--tip { + border-color: var(--color-violet-800); + background: color-mix(in srgb, var(--color-violet-950) 40%, transparent); +} +.dark .doc-prose .doc-aside--caution { + border-color: var(--color-amber-800); + background: color-mix(in srgb, var(--color-amber-950) 40%, transparent); +} +.dark .doc-prose .doc-aside--danger { + border-color: var(--color-red-800); + background: color-mix(in srgb, var(--color-red-950) 40%, transparent); +} + +.doc-prose a.doc-linkcard { + display: block; + border: 1px solid var(--color-neutral-200); + border-radius: 0.5rem; + padding: 1rem 1.25rem; + margin: 0.75rem 0; + text-decoration: none; + transition: border-color 150ms; +} +.dark .doc-prose a.doc-linkcard { + border-color: var(--color-neutral-800); +} +.doc-prose a.doc-linkcard:hover { + border-color: var(--color-pink-600); +} +.doc-prose a.doc-linkcard strong { + display: block; + margin-bottom: 0.25rem; +} +.doc-prose a.doc-linkcard span { + color: var(--color-neutral-500); + font-size: 0.875rem; +} +.dark .doc-prose a.doc-linkcard span { + color: var(--color-neutral-400); +} + +/* GitHub-style button hints used inside guide texts */ +.doc-prose .github-success-btn, +.doc-prose .github-neutral-btn { + display: inline-flex; + align-items: center; + gap: 0.25rem; + border-radius: 0.375rem; + padding: 0.125rem 0.5rem; + font-size: 0.8125rem; + vertical-align: middle; +} +.doc-prose .github-success-btn { + background: #238636; + color: #fff; +} +.doc-prose .github-neutral-btn { + background: #f6f8fa; + border: 1px solid #d1d9e0; + color: #25292e; +} +.dark .doc-prose .github-neutral-btn { + background: #21262d; + border-color: #363b42; + color: #c9d1d9; +} +.doc-prose .github-neutral-btn svg { + fill: currentColor; +} + +.doc-prose details { + border: 1px solid var(--color-neutral-200); + border-radius: 0.5rem; + padding: 0.75rem 1rem; + margin: 1.25rem 0; +} +.dark .doc-prose details { + border-color: var(--color-neutral-800); +} +.doc-prose details summary { + cursor: pointer; + font-weight: 600; +} + +/* --- SendPulse newsletter form ------------------------------------------- */ +/* The embed script injects its own stylesheet; force it back on-brand. */ + +.sp-form-outer .sp-form { + background: transparent !important; + border: none !important; + padding: 0 !important; + width: 100% !important; + max-width: 100% !important; +} + +.sp-form .sp-form-control { + background: color-mix(in srgb, var(--color-white) 60%, transparent) !important; + border: 1px solid var(--color-neutral-300) !important; + border-radius: 0.5rem !important; + color: var(--color-neutral-900) !important; + font-size: 0.875rem !important; + height: 2.5rem !important; +} + +.dark .sp-form .sp-form-control { + background: color-mix(in srgb, var(--color-neutral-950) 60%, transparent) !important; + border-color: var(--color-neutral-700) !important; + color: var(--color-neutral-100) !important; +} + +.sp-form .sp-form-control::placeholder { + color: var(--color-neutral-400) !important; +} + +.dark .sp-form .sp-form-control::placeholder { + color: var(--color-neutral-500) !important; +} + +.sp-form .sp-form-control:focus { + border-color: var(--color-pink-600) !important; + outline: none !important; +} + +.sp-form .sp-button { + background: linear-gradient(to right, var(--color-pink-600), var(--color-fuchsia-600)) !important; + border: none !important; + border-radius: 0.5rem !important; + color: #fff !important; + font-weight: 600 !important; + font-size: 0.875rem !important; + font-family: inherit !important; + height: 2.5rem !important; + padding: 0 1.5rem !important; +} + +.sp-form .sp-button:hover { + filter: brightness(1.1); +} diff --git a/website/tools/generate-content.mjs b/website/tools/generate-content.mjs new file mode 100644 index 000000000..f8ef8077d --- /dev/null +++ b/website/tools/generate-content.mjs @@ -0,0 +1,300 @@ +/** + * Compiles the markdown content in src/content into TypeScript modules under + * src/app/generated: one lazy-loadable module per document, a sidebar manifest + * and a url -> lazy import map. Runs before every build (see "prebuild"). + */ +import { readdirSync, readFileSync, rmSync, mkdirSync, writeFileSync } from 'node:fs'; +import { join, basename } from 'node:path'; +import matter from 'gray-matter'; +import { Marked } from 'marked'; +import { createHighlighter } from 'shiki'; +import GithubSlugger from 'github-slugger'; + +const CONTENT_DIR = new URL('../src/content', import.meta.url).pathname; +const OUT_DIR = new URL('../src/app/generated', import.meta.url).pathname; + +const CATEGORY_LABELS = { + angular: 'Angular', + forms: 'Forms', + nx: 'Nx', + performance: 'Performance', + rxjs: 'RxJS', + signal: 'Signal', + testing: 'Testing', + typescript: 'TypeScript', +}; + +const DIFFICULTIES = [ + ['🟢', 'easy'], + ['🟠', 'medium'], + ['🔴', 'hard'], +]; + +/** `🟢 Projection` -> { title: 'Projection', difficulty: 'easy' } */ +function parseTitle(rawTitle = '') { + for (const [emoji, difficulty] of DIFFICULTIES) { + if (rawTitle.startsWith(emoji)) { + return { title: rawTitle.slice(emoji.length).trim(), difficulty }; + } + } + return { title: rawTitle, difficulty: undefined }; +} + +/** + * Author profiles keyed by lowercase file slug: the `author` frontmatter + * references a JSON file in src/content/authors (e.g. thomas-laforge.json, + * which maps to the GitHub handle tomalaforge). + */ +const AUTHORS = new Map( + readdirSync(join(CONTENT_DIR, 'authors')) + .filter((file) => file.endsWith('.json')) + .map((file) => { + const data = JSON.parse(readFileSync(join(CONTENT_DIR, 'authors', file), 'utf8')); + const githubLogin = data.github?.match(/github\.com\/([^/]+)/)?.[1]; + return [basename(file, '.json').toLowerCase(), { ...data, githubLogin }]; + }), +); + +function resolveAuthor(slug) { + if (!slug) { + return undefined; + } + const author = AUTHORS.get(slug.toLowerCase()); + if (!author) { + console.warn(`Unknown author "${slug}" — no matching file in src/content/authors.`); + return { name: slug }; + } + return { + name: author.name, + githubLogin: author.githubLogin, + twitter: author.twitter, + linkedin: author.linkedin, + youtube: author.youtube, + }; +} + +const SHIKI_LANGS = [ + 'typescript', 'javascript', 'html', 'css', 'json', 'bash', 'shell', + 'yaml', 'diff', 'angular-html', 'angular-ts', 'jsx', 'tsx', +]; + +/** Light colors inline, dark colors in `--shiki-dark*` vars (see styles.css). */ +const SHIKI_THEMES = { + light: 'github-light-default', + dark: 'github-dark-default', +}; + +const highlighter = await createHighlighter({ + themes: Object.values(SHIKI_THEMES), + langs: SHIKI_LANGS, +}); + +/** Per-document state collected by the renderer. */ +let toc = []; +let slugger = new GithubSlugger(); + +const marked = new Marked({ + renderer: { + heading({ tokens, depth }) { + const text = this.parser.parseInline(tokens); + const plain = text.replace(/<[^>]+>/g, ''); + const id = slugger.slug(plain); + if (depth === 2 || depth === 3) { + toc.push({ id, text: plain, depth }); + } + return `${text}\n`; + }, + code({ text, lang }) { + const language = SHIKI_LANGS.includes(lang) ? lang + : lang === 'ts' ? 'typescript' + : lang === 'js' ? 'javascript' + : lang === 'sh' ? 'shell' + : 'text'; + return highlighter.codeToHtml(text, { + lang: language === 'text' ? 'text' : language, + themes: SHIKI_THEMES, + }); + }, + }, +}); + +function rewriteAssetPaths(markdown) { + return markdown.replace(/(\.\.\/)+assets\//g, '/docs-assets/'); +} + +/** `import ... from '...';` lines at the top of .mdx files. */ +function stripMdxImports(markdown) { + return markdown.replace(/^import\s+.*?from\s+['"].*?['"];?\s*$/gm, ''); +} + +/** `` -> plain HTML card. */ +function replaceLinkCards(markdown) { + return markdown.replace(//g, (_, attrs) => { + const attr = (name) => { + const m = attrs.match(new RegExp(`${name}="([^"]*)"`)); + return m ? m[1] : ''; + }; + const title = attr('title'); + const description = marked.parseInline(attr('description')); + const href = attr('href'); + return `${title}${description}`; + }); +} + +/** Starlight `:::note[Title] ... :::` asides -> HTML, content markdown-rendered. */ +function extractAsides(markdown) { + const asides = []; + const replaced = markdown.replace( + /^:::(note|tip|caution|danger)(?:\[([^\]]*)\])?\s*\n([\s\S]*?)\n:::\s*$/gm, + (_, kind, title, content) => { + asides.push({ kind, title, content }); + return `%%ASIDE_${asides.length - 1}%%`; + }, + ); + return { replaced, asides }; +} + +function renderAside({ kind, title, content }) { + const label = title || { note: 'Note', tip: 'Tip', caution: 'Caution', danger: 'Danger' }[kind]; + const body = marked.parse(content); + return ``; +} + +function renderDocument(raw) { + const { data, content } = matter(raw); + let md = rewriteAssetPaths(stripMdxImports(content)); + const { replaced, asides } = extractAsides(md); + md = replaceLinkCards(replaced); + + toc = []; + slugger = new GithubSlugger(); + let html = marked.parse(md); + html = html.replace(/(?:

)?%%ASIDE_(\d+)%%(?:<\/p>)?/g, (_, i) => + renderAside(asides[Number(i)]), + ); + return { data, html, toc }; +} + +function tsModule(doc, outFile) { + const depth = outFile.split('/').length; + const modelPath = '../'.repeat(depth) + 'doc.model'; + return `// Generated by tools/generate-content.mjs — do not edit. +import { Doc } from '${modelPath}'; + +export const doc: Doc = ${JSON.stringify(doc, null, 2)}; +`; +} + +rmSync(OUT_DIR, { recursive: true, force: true }); +mkdirSync(join(OUT_DIR, 'content', 'guides'), { recursive: true }); + +const mapEntries = []; +const manifest = { guides: [], challenges: [] }; + +function emit(doc, outFile) { + writeFileSync(join(OUT_DIR, outFile), tsModule(doc, outFile)); + const importPath = './' + outFile.replace(/\.ts$/, ''); + mapEntries.push(` '${doc.url}': () => import('${importPath}').then((m) => m.doc),`); +} + +// --- Guides --------------------------------------------------------------- +for (const file of readdirSync(join(CONTENT_DIR, 'guides')).sort()) { + const raw = readFileSync(join(CONTENT_DIR, 'guides', file), 'utf8'); + const { data, html, toc } = renderDocument(raw); + const slug = basename(file).replace(/\.mdx?$/, ''); + const url = `/guides/${slug}`; + const doc = { + collection: 'guides', + slug, + url, + title: data.title, + description: data.description ?? '', + contributors: data.contributors ?? [], + noComments: data.noCommentSection === true, + html, + toc, + }; + emit(doc, `content/guides/${slug}.ts`); + manifest.guides.push({ + title: data.title, + url, + order: data.sidebar?.order ?? 999, + description: data.description ?? '', + }); +} +manifest.guides.sort((a, b) => a.order - b.order); + +// --- Challenges ----------------------------------------------------------- +const categories = readdirSync(join(CONTENT_DIR, 'challenges')).sort(); +for (const category of categories) { + mkdirSync(join(OUT_DIR, 'content', 'challenges', category), { recursive: true }); + const group = { + label: CATEGORY_LABELS[category] ?? category, + category, + items: [], + }; + for (const file of readdirSync(join(CONTENT_DIR, 'challenges', category)).sort()) { + const raw = readFileSync(join(CONTENT_DIR, 'challenges', category, file), 'utf8'); + const { data, html, toc } = renderDocument(raw); + const isIndex = /^index\.mdx?$/.test(file); + const slug = isIndex ? '' : basename(file).replace(/\.mdx?$/, ''); + const url = isIndex ? `/challenges/${category}` : `/challenges/${category}/${slug}`; + const { title, difficulty } = parseTitle(data.title); + const doc = { + collection: 'challenges', + category, + categoryLabel: CATEGORY_LABELS[category] ?? category, + slug, + url, + title, + difficulty, + description: data.description ?? '', + author: resolveAuthor(data.author), + contributors: data.contributors ?? [], + challengeNumber: data.challengeNumber, + command: data.command, + blogLink: data.blogLink, + videoLinks: data.videoLinks ?? [], + noComments: data.noCommentSection === true, + html, + toc, + }; + emit(doc, `content/challenges/${category}/${slug || 'index'}.ts`); + group.items.push({ + title, + difficulty, + url, + order: isIndex ? -1 : (data.sidebar?.order ?? 999), + description: data.description ?? '', + challengeNumber: data.challengeNumber, + }); + } + group.items.sort((a, b) => a.order - b.order); + manifest.challenges.push(group); +} + +// --- Manifest + import map -------------------------------------------------- +writeFileSync( + join(OUT_DIR, 'manifest.ts'), + `// Generated by tools/generate-content.mjs — do not edit. +import { DocsManifest } from '../doc.model'; + +export const MANIFEST: DocsManifest = ${JSON.stringify(manifest, null, 2)}; +`, +); + +writeFileSync( + join(OUT_DIR, 'content-map.ts'), + `// Generated by tools/generate-content.mjs — do not edit. +import { Doc } from '../doc.model'; + +export const CONTENT_MAP: Record Promise> = { +${mapEntries.join('\n')} +}; +`, +); + +console.log( + `Generated ${mapEntries.length} documents, ` + + `${manifest.guides.length} guides, ${manifest.challenges.length} challenge categories.`, +); diff --git a/website/tsconfig.app.json b/website/tsconfig.app.json new file mode 100644 index 000000000..11c10da69 --- /dev/null +++ b/website/tsconfig.app.json @@ -0,0 +1,16 @@ +/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */ +/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */ +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "types": [ + "node" + ] + }, + "include": [ + "src/**/*.ts" + ], + "exclude": [ + "src/**/*.spec.ts" + ] +} diff --git a/website/tsconfig.json b/website/tsconfig.json new file mode 100644 index 000000000..d2fbb9c2b --- /dev/null +++ b/website/tsconfig.json @@ -0,0 +1,31 @@ +/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */ +/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */ +{ + "compileOnSave": false, + "compilerOptions": { + "noImplicitOverride": true, + "noPropertyAccessFromIndexSignature": true, + "noImplicitReturns": true, + "noFallthroughCasesInSwitch": true, + "skipLibCheck": true, + "isolatedModules": true, + "experimentalDecorators": true, + "importHelpers": true, + "target": "ES2022", + "module": "preserve" + }, + "angularCompilerOptions": { + "enableI18nLegacyMessageIdFormat": false, + "strictInjectionParameters": true, + "strictInputAccessModifiers": true + }, + "files": [], + "references": [ + { + "path": "./tsconfig.app.json" + }, + { + "path": "./tsconfig.spec.json" + } + ] +} diff --git a/website/tsconfig.spec.json b/website/tsconfig.spec.json new file mode 100644 index 000000000..9c8efb9b7 --- /dev/null +++ b/website/tsconfig.spec.json @@ -0,0 +1,14 @@ +/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */ +/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */ +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "types": [ + "vitest/globals" + ] + }, + "include": [ + "src/**/*.d.ts", + "src/**/*.spec.ts" + ] +} diff --git a/website/vercel.json b/website/vercel.json new file mode 100644 index 000000000..1946eec5c --- /dev/null +++ b/website/vercel.json @@ -0,0 +1,7 @@ +{ + "$schema": "https://openapi.vercel.sh/vercel.json", + "installCommand": "pnpm install", + "buildCommand": "pnpm build", + "outputDirectory": "dist/angular-challenges-website/browser", + "rewrites": [{ "source": "/(.*)", "destination": "/api/ssr" }] +}