From 54732e54d44c4e9838bc2e1a464c6259d448463d Mon Sep 17 00:00:00 2001 From: Byron Wall Date: Fri, 6 Nov 2026 18:35:47 -0500 Subject: [PATCH 1/2] feat(site): add public landing page and user guides --- .github/workflows/site.yml | 39 + .gitignore | 3 + README.md | 2 + docs/CODE_MAP.md | 8 + site/DEPLOY.md | 13 + site/DESIGN.md | 20 + site/README.md | 35 + site/index.html | 15 + site/package.json | 28 + site/playwright.config.ts | 19 + site/pnpm-lock.yaml | 1293 ++++++++++++++++++++++++++ site/pnpm-workspace.yaml | 2 + site/public/favicon.svg | 1 + site/scripts/deploy.mjs | 47 + site/scripts/prerender.mjs | 63 ++ site/src/App.tsx | 129 +++ site/src/Landing.tsx | 72 ++ site/src/docs/pages/cli.md | 83 ++ site/src/docs/pages/configuration.md | 41 + site/src/docs/pages/data-flow.md | 32 + site/src/docs/pages/explore.md | 37 + site/src/docs/pages/findings.md | 36 + site/src/docs/pages/get-started.md | 54 ++ site/src/docs/pages/metrics.md | 30 + site/src/docs/pages/reports.md | 60 ++ site/src/main.tsx | 9 + site/src/server.tsx | 6 + site/src/site.css | 297 ++++++ site/tests/site.spec.ts | 68 ++ site/tsconfig.json | 16 + site/vite.config.ts | 9 + 31 files changed, 2567 insertions(+) create mode 100644 .github/workflows/site.yml create mode 100644 site/DEPLOY.md create mode 100644 site/DESIGN.md create mode 100644 site/README.md create mode 100644 site/index.html create mode 100644 site/package.json create mode 100644 site/playwright.config.ts create mode 100644 site/pnpm-lock.yaml create mode 100644 site/pnpm-workspace.yaml create mode 100644 site/public/favicon.svg create mode 100644 site/scripts/deploy.mjs create mode 100644 site/scripts/prerender.mjs create mode 100644 site/src/App.tsx create mode 100644 site/src/Landing.tsx create mode 100644 site/src/docs/pages/cli.md create mode 100644 site/src/docs/pages/configuration.md create mode 100644 site/src/docs/pages/data-flow.md create mode 100644 site/src/docs/pages/explore.md create mode 100644 site/src/docs/pages/findings.md create mode 100644 site/src/docs/pages/get-started.md create mode 100644 site/src/docs/pages/metrics.md create mode 100644 site/src/docs/pages/reports.md create mode 100644 site/src/main.tsx create mode 100644 site/src/server.tsx create mode 100644 site/src/site.css create mode 100644 site/tests/site.spec.ts create mode 100644 site/tsconfig.json create mode 100644 site/vite.config.ts diff --git a/.github/workflows/site.yml b/.github/workflows/site.yml new file mode 100644 index 00000000..2845f6fe --- /dev/null +++ b/.github/workflows/site.yml @@ -0,0 +1,39 @@ +name: Public site + +on: + pull_request: + paths: + - 'site/**' + - '.github/workflows/site.yml' + - '.github/workflows/pages.yml' + workflow_dispatch: + +permissions: + contents: read + +jobs: + site: + runs-on: ubuntu-latest + timeout-minutes: 10 + defaults: + run: + working-directory: site + steps: + - uses: actions/checkout@v4 + - uses: pnpm/action-setup@v4 + with: + version: 11.9.0 + - uses: actions/setup-node@v4 + with: + node-version: 24 + cache: pnpm + cache-dependency-path: site/pnpm-lock.yaml + - run: pnpm install --frozen-lockfile + - run: pnpm build + - run: pnpm exec playwright install --with-deps chromium + - run: pnpm test + - uses: actions/upload-artifact@v4 + if: failure() + with: + name: site-test-results + path: site/test-results diff --git a/.gitignore b/.gitignore index 14cd20a6..a62cdec9 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,9 @@ # General .DS_Store node_modules/ +.pnpm-store/ +site/.ssr/ +site/test-results/ # Screenshots, briefs and scratch output (never committed). tmp/ # Per-worktree ports, written by scripts/bootstrap.sh. diff --git a/README.md b/README.md index 58e237a6..04419f7a 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ Srcly is an interactive codebase treemap and metrics viewer. It combines [Lizard Project background and screenshots: [Srcly project page](https://byroni.us/projects/srcly). +[Website and user guides](https://byronwall.github.io/srcly/) · [Get started](https://byronwall.github.io/srcly/docs/get-started/) · [CLI reference](https://byronwall.github.io/srcly/docs/cli/) + To try it in your current folder, run: ``` diff --git a/docs/CODE_MAP.md b/docs/CODE_MAP.md index 428e0049..5dfa2fd4 100644 --- a/docs/CODE_MAP.md +++ b/docs/CODE_MAP.md @@ -28,6 +28,14 @@ Browser ## Features +### Public site + +| Feature | Where | +| --- | --- | +| Landing page, interactive treemap example, shared navigation | `site/src/App.tsx`, `site/src/Landing.tsx`, `site/src/site.css` | +| User guides, search, table of contents | `site/src/App.tsx`, `site/src/docs/` | +| Static HTML, page metadata, sitemap, and GitHub Pages base path | `site/src/server.tsx`, `site/scripts/prerender.mjs`, `site/vite.config.ts` | + ### CLI and process lifecycle | Feature | Where | diff --git a/site/DEPLOY.md b/site/DEPLOY.md new file mode 100644 index 00000000..3d58698b --- /dev/null +++ b/site/DEPLOY.md @@ -0,0 +1,13 @@ +# Deploy + +Build the static site, then deploy it from the repository checkout: + +```sh +cd site +pnpm build +node scripts/deploy.mjs +``` + +The script publishes `dist/` to the `gh-pages` branch and adds `.nojekyll`. +It uses a temporary clone, keeps existing branch history, and pushes without force. +The commit author and committer are Byron Wall (`byron@byroni.us`). diff --git a/site/DESIGN.md b/site/DESIGN.md new file mode 100644 index 00000000..149a59f4 --- /dev/null +++ b/site/DESIGN.md @@ -0,0 +1,20 @@ +# Public site + +The public site extends Srcly's light application palette and Draftably's demonstration-first structure. +It serves developers who want to inspect a local codebase or generate a report for an agent. + +The landing page pairs a direct setup command with an interactive, labeled example. +The example explains tile area, metric color, and file selection before the longer product copy. +Guides use grouped navigation, content search, section links, and previous/next links. + +## Tokens + +- Canvas: `#f8fafc`; paper: `#fff`; ink: `#17212e`. +- Body detail: `#526273`; rules: `#dce3ea`. +- Links and actions: `#1769aa`; hover: `#0e548d`. +- Type: Inter for text; IBM Plex Mono for code and measurements. +- Page width: 1160px; hero type: 42–68px; body: 15px. +- Controls have visible focus outlines. Motion respects reduced-motion settings. + +The treemap and terminal output are illustrations. Keep that labeling visible. +Do not imply the public site scans files or that missing measurements equal zero. diff --git a/site/README.md b/site/README.md new file mode 100644 index 00000000..87097ceb --- /dev/null +++ b/site/README.md @@ -0,0 +1,35 @@ +# Srcly public site + +The landing page and user guides deploy to [GitHub Pages](https://byronwall.github.io/srcly/). +The analysis app still runs locally through `uvx srcly`. + +```sh +cd site +pnpm install --frozen-lockfile +pnpm dev +pnpm build +pnpm test +``` + +Open the printed development URL with `/srcly/` appended. +The build writes `site/dist/`. Each guide has a complete HTML page, with page metadata and a canonical URL. +The browser adds the interactive example, guide search, and copy buttons. + +Edit user guides in `src/docs/pages/`. Keep command examples in sync with `server/app/run.py`. +Add new pages to the navigation in `src/App.tsx` when required. +The build reads page titles and introductions from Markdown for search metadata. + +The site uses its own dependencies and build. It does not ship inside the Python wheel. +Pull requests build the site and run its browser checks. See [DEPLOY.md](DEPLOY.md) to publish the build to GitHub Pages. + +## Reference and design + +Draftably's public site supplied the structure: an interactive product example, direct setup actions, and searchable task guides. +Srcly keeps its light surfaces, blue links, Inter type, and IBM Plex Mono commands. +The treemap uses clearly labeled example data. It does not scan visitor files. + +## Verification + +`pnpm test` runs a browser against the built site under `/srcly/`. +It checks direct guide links, rendered content, navigation, search, the example controls, and narrow screens. +Keep screenshot evidence under the repository's ignored `tmp/` directory. diff --git a/site/index.html b/site/index.html new file mode 100644 index 00000000..1a991fd7 --- /dev/null +++ b/site/index.html @@ -0,0 +1,15 @@ + + + + + + + + Srcly — See where your code needs attention + + + +
+ + + diff --git a/site/package.json b/site/package.json new file mode 100644 index 00000000..6094ad65 --- /dev/null +++ b/site/package.json @@ -0,0 +1,28 @@ +{ + "name": "srcly-site", + "private": true, + "version": "0.0.0", + "type": "module", + "packageManager": "pnpm@11.9.0", + "scripts": { + "dev": "vite --host 127.0.0.1", + "typecheck": "tsc --noEmit", + "build": "pnpm typecheck && vite build && vite build --ssr src/server.tsx --outDir .ssr && node scripts/prerender.mjs", + "preview": "vite preview --host 127.0.0.1", + "test": "playwright test" + }, + "dependencies": { + "@fontsource-variable/inter": "^5.3.0", + "@fontsource/ibm-plex-mono": "^5.3.0", + "lucide-solid": "^1.49.0", + "marked": "^17.0.6", + "solid-js": "^1.9.18" + }, + "devDependencies": { + "@playwright/test": "1.62.0", + "@types/node": "^24.19.2", + "typescript": "~5.9.3", + "vite": "^7.3.7", + "vite-plugin-solid": "^2.11.15" + } +} diff --git a/site/playwright.config.ts b/site/playwright.config.ts new file mode 100644 index 00000000..933a8336 --- /dev/null +++ b/site/playwright.config.ts @@ -0,0 +1,19 @@ +import { defineConfig, devices } from "@playwright/test"; + +export default defineConfig({ + testDir: "./tests", + fullyParallel: false, + workers: 1, + retries: process.env.CI ? 1 : 0, + reporter: "list", + use: { + baseURL: "http://127.0.0.1:18588/srcly/", + trace: "retain-on-failure", + }, + projects: [{ name: "chromium", use: { ...devices["Desktop Chrome"], viewport: { width: 1440, height: 1000 } } }], + webServer: { + command: "pnpm preview --port 18588 --strictPort", + url: "http://127.0.0.1:18588/srcly/", + reuseExistingServer: !process.env.CI, + }, +}); diff --git a/site/pnpm-lock.yaml b/site/pnpm-lock.yaml new file mode 100644 index 00000000..b5a94088 --- /dev/null +++ b/site/pnpm-lock.yaml @@ -0,0 +1,1293 @@ +lockfileVersion: '9.0' + +settings: + autoInstallPeers: true + excludeLinksFromLockfile: false + +importers: + + .: + dependencies: + '@fontsource-variable/inter': + specifier: ^5.3.0 + version: 5.3.0 + '@fontsource/ibm-plex-mono': + specifier: ^5.3.0 + version: 5.3.0 + lucide-solid: + specifier: ^1.49.0 + version: 1.49.0(solid-js@1.9.18) + marked: + specifier: ^17.0.6 + version: 17.0.6 + solid-js: + specifier: ^1.9.18 + version: 1.9.18 + devDependencies: + '@playwright/test': + specifier: 1.62.0 + version: 1.62.0 + '@types/node': + specifier: ^24.19.2 + version: 24.19.2 + typescript: + specifier: ~5.9.3 + version: 5.9.3 + vite: + specifier: ^7.3.7 + version: 7.3.7(@types/node@24.19.2) + vite-plugin-solid: + specifier: ^2.11.15 + version: 2.11.15(solid-js@1.9.18)(vite@7.3.7(@types/node@24.19.2)) + +packages: + + '@babel/code-frame@7.29.7': + resolution: {integrity: sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==} + engines: {node: '>=6.9.0'} + + '@babel/compat-data@7.29.7': + resolution: {integrity: sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==} + engines: {node: '>=6.9.0'} + + '@babel/core@7.29.13': + resolution: {integrity: sha512-j1nvOQCZYSgp7HLmisnCXFTpVvFODiijQ9QHkORfGKWH6YDtskTEeCJS7eV545GZ9UBzrq0e2xsOd5QQ5PjIqw==} + engines: {node: '>=6.9.0'} + + '@babel/generator@7.29.13': + resolution: {integrity: sha512-T5FRo+RzVHvGjWOuF1Ljc44b+NXAOazodHkGUHp4I3zCkQ4/sNVJm56h1S278LMR0bY5xBhztGziSbli8zObIw==} + engines: {node: '>=6.9.0'} + + '@babel/helper-compilation-targets@7.29.13': + resolution: {integrity: sha512-8WxJ4/Vmes3ghacj8VOJy3NW8eyHiFY/4thU/LSBuBE470+igjR/j1ZTNn8fV5VdNrLx6iXUwig526UdOvfP0w==} + engines: {node: '>=6.9.0'} + + '@babel/helper-globals@7.29.7': + resolution: {integrity: sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==} + engines: {node: '>=6.9.0'} + + '@babel/helper-module-imports@7.18.6': + resolution: {integrity: sha512-0NFvs3VkuSYbFi1x2Vd6tKrywq+z/cLeYC/RJNFrIX/30Bf5aiGYbtvGXolEktzJH8o5E5KJ3tT+nkxuuZFVlA==} + engines: {node: '>=6.9.0'} + + '@babel/helper-module-imports@7.29.7': + resolution: {integrity: sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==} + engines: {node: '>=6.9.0'} + + '@babel/helper-module-transforms@7.29.13': + resolution: {integrity: sha512-/U96wOz+SCoZ7Da/8kjDGltcNY280JPQcRNPK0Hk3PTbdpaiBDQImtC6JsbVwb1HGMr3usZQU2WsWVjhYNmRzw==} + engines: {node: '>=6.9.0'} + peerDependencies: + '@babel/core': ^7.0.0 + + '@babel/helper-plugin-utils@7.29.7': + resolution: {integrity: sha512-G7sHYigPY17oO5SYWnfD/0MTBwVR781S/JI643e/JhUYgVgWE/61SoW3NH9KWUKyKq5LVh3npif99Wkt6j86Jw==} + engines: {node: '>=6.9.0'} + + '@babel/helper-string-parser@7.29.13': + resolution: {integrity: sha512-fWegr+WsEsiMVW4KUNdIIzzMTZSzNiqhy0//6+2MRi2d5NFNsL/AYwBQW8eBnRbTBVRnDVzjaJEUqKaCWjMMdQ==} + engines: {node: '>=6.9.0'} + + '@babel/helper-validator-identifier@7.29.7': + resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==} + engines: {node: '>=6.9.0'} + + '@babel/helper-validator-option@7.29.7': + resolution: {integrity: sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==} + engines: {node: '>=6.9.0'} + + '@babel/helpers@7.29.13': + resolution: {integrity: sha512-laoRpD/kO/iA4CDlgJbixHekg7oPvWALK0PQyK3Ob2I2njZRvVAD77RfWCIImtqWCq6KijoBoZK7bp/HlTWASQ==} + engines: {node: '>=6.9.0'} + + '@babel/parser@7.29.13': + resolution: {integrity: sha512-fJM50YYjlTiBhgdkGmC1tBpv+FMAyo4annf2X6Aks+0yRlaiVkYW/3f07xAfVVkYIoZ9fFZp+mEThUFnuybhkQ==} + engines: {node: '>=6.0.0'} + hasBin: true + + '@babel/plugin-syntax-jsx@7.29.7': + resolution: {integrity: sha512-TSu8+mHCoEaaCDEZ0I3+6mvTBYR4PCxQwf2z9/r5Tbztv6NaLR3B9thGTTxX2WGuGHJqRiAbKPeGTJ5XWXVg6A==} + engines: {node: '>=6.9.0'} + peerDependencies: + '@babel/core': ^7.0.0-0 + + '@babel/template@7.29.7': + resolution: {integrity: sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==} + engines: {node: '>=6.9.0'} + + '@babel/traverse@7.29.13': + resolution: {integrity: sha512-0ve0xMlFA73dgY1oyJRY6RoW+/bncdcOQqg6jjYcVfXBK90OdLXjm9R6lmRetdZVrPjXkKIoMVBqYFPjcAlZ4Q==} + engines: {node: '>=6.9.0'} + + '@babel/types@7.29.11': + resolution: {integrity: sha512-WCsemW40Cpc6gouC1SrY6PBaZ+oLRlEVY9XBvZBI7il/HyUrb2nJ505wE1MHEFyDZNnrWDEuy4jL50WVHfTTSQ==} + engines: {node: '>=6.9.0'} + + '@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] + + '@fontsource-variable/inter@5.3.0': + resolution: {integrity: sha512-OupL48va4JNofb97w6NYeF9S7W/kHNKM0Er8Dem5nqi4jeOLrVJDoE8tZEpnMJmtkvNbB1EIPPwHcdkF6b1oUA==} + + '@fontsource/ibm-plex-mono@5.3.0': + resolution: {integrity: sha512-eTgnZjZEGk1QtD3ZstF+Vclo2HLAni8YMy34/DxllwZvyz1lR/1RF/xTiAquOBO7MvqBx8D2Ig2WCPMVfdZu7Q==} + + '@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.6.0': + resolution: {integrity: sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==} + + '@jridgewell/trace-mapping@0.3.31': + resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==} + + '@playwright/test@1.62.0': + resolution: {integrity: sha512-9zOJ6ZQRAena31MpOH9VSzIz8Ou3YJ/wtY/eQm5T2uhfhG7/U3COrMS8xOtUrZrp9OgdmzEnIYODye3nY1VqzA==} + engines: {node: '>=20'} + hasBin: true + + '@rollup/rollup-android-arm-eabi@4.67.5': + resolution: {integrity: sha512-FdWPeulkH+FH+rBzyKBD59tuVN4tRKvmVilSJm0OcnoYsQTpd9UhD78OaPcsYqo2fX6hCwAG0YIjrDLoQ3pR3g==} + cpu: [arm] + os: [android] + + '@rollup/rollup-android-arm64@4.67.5': + resolution: {integrity: sha512-bmkDuBGnF+Ji8atWlXcNjxIC52ShCbdXPbW7Nz0lRoCFi1lrvsO0XobJY36kTj7duc1vOmGJeQ9vtVuGjnzihA==} + cpu: [arm64] + os: [android] + + '@rollup/rollup-android-x64@4.67.5': + resolution: {integrity: sha512-6KvVfnqPTqmbQ5YobMl9HYiSymAsCt8HlNeriDshwJQcveXwT+vIMW6wGL1RcJbXH9+r3BAJvjab5+rIgtSEqA==} + cpu: [x64] + os: [android] + + '@rollup/rollup-darwin-arm64@4.67.5': + resolution: {integrity: sha512-SNamgdrY69oPdBrQV9fKGo6PSmKcVhyn0D0jnDmcqgRJvrxQGGBhtekOHTUJ7TCgkW0nE8XMH9v2CwXmjNIzVA==} + cpu: [arm64] + os: [darwin] + + '@rollup/rollup-darwin-x64@4.67.5': + resolution: {integrity: sha512-HNdl34thiJtHDSglogjmAlQ296L8cc8zA7ODH65nnmY7E+jPP55WEbh8J5583rWFLMjxyYywxZuwPOwRvEi5tA==} + cpu: [x64] + os: [darwin] + + '@rollup/rollup-freebsd-arm64@4.67.5': + resolution: {integrity: sha512-WvZYtANNswfHzSNHaJAoG6Ipfc4SyZIDYuIjFdHv07xXxhHl+Xx8o+bNDWsxpOADFT2mKXcXVrfOG4OlWTLo8Q==} + cpu: [arm64] + os: [freebsd] + + '@rollup/rollup-freebsd-x64@4.67.5': + resolution: {integrity: sha512-EUU+Wgf9NyHekceC+DxAdm42f6bq2ezH/7DEb/JnCb8SAUhG2xph5BiVukxplWal2m5pP8CzJZE+FLwRopywjQ==} + cpu: [x64] + os: [freebsd] + + '@rollup/rollup-linux-arm-gnueabihf@4.67.5': + resolution: {integrity: sha512-dgU1CvUuE2IkaJBAeuAbxpDdMHAdZBT5oth5u22DtuoMg4gXXYr2+Sm30RigPJG1F2VEoiGJUziGLuIh9+jPxA==} + cpu: [arm] + os: [linux] + libc: [glibc] + + '@rollup/rollup-linux-arm-musleabihf@4.67.5': + resolution: {integrity: sha512-rdgJcJig2VngYlcTCRQw2BA8kLWM6QwDFe9uLFo81lya0jPC1r8wZu92sAvTUIv48GWlkRVi6/fpsa5CoFSKoQ==} + cpu: [arm] + os: [linux] + libc: [musl] + + '@rollup/rollup-linux-arm64-gnu@4.67.5': + resolution: {integrity: sha512-+jtCiQnrEFHWAUAcUpP7wppb1p6HKOgBP3mXx75cEYpDF2Y5MEqBky2HNz+osFuVx5uX44gnMTmbe5RJauzn6A==} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@rollup/rollup-linux-arm64-musl@4.67.5': + resolution: {integrity: sha512-heflX7ENhL8eHmLcUxDEHCSK8CKLyPprysb2JGoSTh5Ip7nHrzIRc+2USyxul3nxi98H8pGxJIEDEpURlS1X5A==} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@rollup/rollup-linux-loong64-gnu@4.67.5': + resolution: {integrity: sha512-rRtNU0zBfRHkJ8pscHN9qRtUYLq8Rao4EX7aVWvKcFmJUANkCCXFRU7ovNBEMhpEONyUEB/3DRVDXwDDguSfHA==} + cpu: [loong64] + os: [linux] + libc: [glibc] + + '@rollup/rollup-linux-loong64-musl@4.67.5': + resolution: {integrity: sha512-/6auyi9yj8MD/Q+8P+f2ay57jQ7a0j7Yp1JK86pecH6ZnRViQZ5GOjoRSjGArFeTSHFznRbM2QPQcBgDPyNMfQ==} + cpu: [loong64] + os: [linux] + libc: [musl] + + '@rollup/rollup-linux-ppc64-gnu@4.67.5': + resolution: {integrity: sha512-Hsc0vlt+vPvqzUkHKffWKf3YE/yexrY+yeFf7IsUvDC6PV7YGCsA/gJvPa+WJdgxGJnwuoO1HmLkbahaLKabYQ==} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@rollup/rollup-linux-ppc64-musl@4.67.5': + resolution: {integrity: sha512-Jx5TMMSPJwHY7F/JwPdS6nuBwny2ECRK+EsAJV5HZrfiddeSS6ZrohkLkFZm3rjqBUuQ4FPX5gGMtakUuQO6fQ==} + cpu: [ppc64] + os: [linux] + libc: [musl] + + '@rollup/rollup-linux-riscv64-gnu@4.67.5': + resolution: {integrity: sha512-fGWcq2lo/XCqAkBLOokg66D/z+MUouryB8i+QdU9RR6O5knG7rucc0WFPqWYL1Wk/wuiJouDfmyBxmZKRM9bag==} + cpu: [riscv64] + os: [linux] + libc: [glibc] + + '@rollup/rollup-linux-riscv64-musl@4.67.5': + resolution: {integrity: sha512-JwO/Ys3jybc0UW3V5XO2CMnp0RhvoczDDQTgAEE1IctT+HRY3W5parIIWLUpmAK4gHSeeYJofm2iQPFA62K6ag==} + cpu: [riscv64] + os: [linux] + libc: [musl] + + '@rollup/rollup-linux-s390x-gnu@4.67.5': + resolution: {integrity: sha512-vVD4iqel6J6A1xAJlb4mxEO9i1wOJ4/SkcKoDKAuK/wqEBPOA7/P5dDyZvNx46ocHwOUwzo3WjhTdKqET9kEAg==} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@rollup/rollup-linux-x64-gnu@4.67.5': + resolution: {integrity: sha512-HmEfNh5Cdd/NHxgqwMzKnjlvicQQA+D+w+vQXDJSV0x/aHiQSjVwh1Th5RoA7QsMieIaxibt/5iJq68BraTSUg==} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@rollup/rollup-linux-x64-musl@4.67.5': + resolution: {integrity: sha512-NfmALpbe009nYzZ2QqlSW6nzbGddXpqk3nwualrIr+4QflQCTGMzt3QKK20yARiAnSV9fJdM5WNwIYUf31x3uA==} + cpu: [x64] + os: [linux] + libc: [musl] + + '@rollup/rollup-openbsd-x64@4.67.5': + resolution: {integrity: sha512-ngcE7Udpy/iJ3lexVhYcbpUV2OJIakRGus3snc6K52BnAAJetDBG1Ku5Eh3CECtnW3mpBYWg5VCD4tTaOXKOVQ==} + cpu: [x64] + os: [openbsd] + + '@rollup/rollup-openharmony-arm64@4.67.5': + resolution: {integrity: sha512-DZ01A2EdTYX8xVeGoGiWkJBRWDh+/BOflwGPVsBay43PDxcq8ez0xuovZnPnk1xjE3CdI0pdZXxsJp/Xjmf7uQ==} + cpu: [arm64] + os: [openharmony] + + '@rollup/rollup-win32-arm64-msvc@4.67.5': + resolution: {integrity: sha512-nJKiMKDO140DUCEcQZl+f4HiGPMBxrW2webjuWJ2E3qPeoruHf2zByml4TP52lA1zDi6L4I92D/5stxeA/6pig==} + cpu: [arm64] + os: [win32] + + '@rollup/rollup-win32-ia32-msvc@4.67.5': + resolution: {integrity: sha512-ykLkBCf+Kls24QmqM3IRf1T4sGMh0rXPyymtj+hXlWKPJnXbXraHqUUsKtOIxqLasjT1i7DhfQGAaZYeiHbSOw==} + cpu: [ia32] + os: [win32] + + '@rollup/rollup-win32-x64-gnu@4.67.5': + resolution: {integrity: sha512-NiFPUFw8cHhkmBlL1k1eaz+5AXXm89rztj+DQdDuQ7VGPM0+ADFhezQ2KcBMF50UEFzGUr0+DVjVND743XwKWQ==} + cpu: [x64] + os: [win32] + + '@rollup/rollup-win32-x64-msvc@4.67.5': + resolution: {integrity: sha512-Khj/vrKCpdbiAWYbJAeSy4D5iep+qwW/86lNoKvdleJYGxgbRE7h87+5d5T9D7gt8NcqhNFpreRgIg8T4bLzKQ==} + cpu: [x64] + os: [win32] + + '@types/babel__core@7.20.5': + resolution: {integrity: sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==} + + '@types/babel__generator@7.27.0': + resolution: {integrity: sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==} + + '@types/babel__template@7.4.4': + resolution: {integrity: sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==} + + '@types/babel__traverse@7.28.0': + resolution: {integrity: sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==} + + '@types/estree@1.0.10': + resolution: {integrity: sha512-lTyOMnOcmRBzdCv6/4zUZCrEhV0xrqQiUZBZtVcbmLHBXKLnN8q89v/wKRF/Q0HbwVsqbIG3o5HDoFl9sduM+g==} + + '@types/node@24.19.2': + resolution: {integrity: sha512-93d49wCWJkCyN87MxLpNN6KXPCwFw7bVUg79mGUV1OS40JGWwVCr8n61DXCSqz7CV6/VfPkb7xec7uP2M+QHWQ==} + + babel-plugin-jsx-dom-expressions@0.40.11: + resolution: {integrity: sha512-k7TkOv7uVYnrq/bYyVvG5cWOC9IObAGfmyW3aMkG8l2sq2qt/5THkUBja69PMLEGGi8G+fXB2Fh7eS4OwZRBoQ==} + peerDependencies: + '@babel/core': ^7.20.12 + + babel-preset-solid@1.9.16: + resolution: {integrity: sha512-+0h40Qk2oBfkQ4OGDBHIDtvq/XQiOnCfzjNHmMxriAr8MmdsaIbyJgqYglDs4d70sF8O08sSpx61TKdpUt3oRw==} + peerDependencies: + '@babel/core': ^7.0.0 + solid-js: ^1.9.16 + peerDependenciesMeta: + solid-js: + optional: true + + baseline-browser-mapping@2.11.35: + resolution: {integrity: sha512-GNk8KX52CHqeNKGk8+7tZnQab/2k1t/BgrUHPKNdijzpEhF1saPQZHVKb6m5loSAxB39gyrTYw34Qf9CQ3u1qQ==} + engines: {node: '>=6.0.0'} + hasBin: true + + browserslist@4.29.5: + resolution: {integrity: sha512-khTmKu5NGYTotqcYo8Bew2k4RAE9PuXRSFRXG2lQBrCEQHyeQ/vX6gKMxfokwywBsLiXZMnHsmWMG1pnO8J7uQ==} + engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7} + hasBin: true + + caniuse-lite@1.0.30001822: + resolution: {integrity: sha512-Y3fvWQWzc69dlCyr07tuNrEhotv+db5FpMSPD3slZnkPKwRNOKwFBz2dP966XUmWMXLTOt+YShkFoQoom3U7hg==} + + convert-source-map@2.0.0: + resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==} + + csstype@3.2.3: + resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==} + + debug@4.4.3: + resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==} + engines: {node: '>=6.0'} + peerDependencies: + supports-color: '*' + peerDependenciesMeta: + supports-color: + optional: true + + electron-to-chromium@1.5.477: + resolution: {integrity: sha512-PN++F4zWZoVDGWinxMnSCpVqKhqFOJfLXxdU8bYJKudAEsHL/XKVITOKWVbfMt1r276Mi9RDLU9VHx9uKJ4RMQ==} + + entities@6.0.1: + resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==} + engines: {node: '>=0.12'} + + 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'} + + fdir@6.5.0: + resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} + engines: {node: '>=12.0.0'} + peerDependencies: + picomatch: ^3 || ^4 + peerDependenciesMeta: + picomatch: + optional: true + + 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] + + gensync@1.0.0-beta.2: + resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==} + engines: {node: '>=6.9.0'} + + html-entities@2.3.3: + resolution: {integrity: sha512-DV5Ln36z34NNTDgnz0EWGBLZENelNAtkiFA4kyNOG2tDI6Mz1uSWiq1wAKdyjnJwyDiDO7Fa2SO1CTxPXL8VxA==} + + is-what@4.1.16: + resolution: {integrity: sha512-ZhMwEosbFJkA0YhFnNDgTM4ZxDRsS6HqTo7qsZM08fehyRYIYa0yHu5R6mgo1n/8MgaPBXiPimPD77baVFYg+A==} + engines: {node: '>=12.13'} + + js-tokens@4.0.0: + resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} + + jsesc@3.1.0: + resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==} + engines: {node: '>=6'} + hasBin: true + + json5@2.2.3: + resolution: {integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==} + engines: {node: '>=6'} + hasBin: true + + lru-cache@5.1.1: + resolution: {integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==} + + lucide-solid@1.49.0: + resolution: {integrity: sha512-ULoV0vXTdfZOODX/FdS/h2V7gj6BnxKfK++XY0NhiX3f7TR8jYdE1pw0gfHBctdfSIqZZB3BnIiOUuSbYGpf9Q==} + peerDependencies: + solid-js: ^1.4.7 + + marked@17.0.6: + resolution: {integrity: sha512-gB0gkNafnonOw0obSTEGZTT86IuhILt2Wfx0mWH/1Au83kybTayroZ/V6nS25mN7u8ASy+5fMhgB3XPNrOZdmA==} + engines: {node: '>= 20'} + hasBin: true + + merge-anything@5.1.7: + resolution: {integrity: sha512-eRtbOb1N5iyH0tkQDAoQ4Ipsp/5qSR79Dzrz8hEPxRX10RWWR/iQXdoKmBSRCThY1Fh5EhISDtpSc93fpxUniQ==} + engines: {node: '>=12.13'} + + ms@2.1.3: + resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==} + + nanoid@3.3.20: + resolution: {integrity: sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==} + engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} + hasBin: true + + node-releases@2.0.63: + resolution: {integrity: sha512-6li2QanLsAXpIH2R6j77MzRyvOyrvdTqlKtO4CgBdHGNvN99ZZfyxszHc5o5+IZBWD5u6Hzwg83JoGXmqZNG9Q==} + engines: {node: '>=18'} + + parse5@7.3.0: + resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==} + + picocolors@1.1.1: + resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==} + + picomatch@4.0.7: + resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==} + engines: {node: '>=12'} + + playwright-core@1.62.0: + resolution: {integrity: sha512-nsNRyq0r2zsG8AcRHWknc9QRA5XCueC7gWMrs+Gx2tlZn9hcl8zudfh00lhJPY1DE7NmZ6bDsT9g2yey8mXljA==} + engines: {node: '>=20'} + hasBin: true + + playwright@1.62.0: + resolution: {integrity: sha512-Z14dG305dgaLu6foB1TXQagFiW8JfSUIUaUuPaKQ6NtBPKF1P/qXcqfh6c6K/icPqdy37JmjbiBXf6JNg6Sylw==} + engines: {node: '>=20'} + hasBin: true + + postcss@8.5.32: + resolution: {integrity: sha512-LJlKCCAUFKOuZxipUdYw1NzIITEsPcgyOG9LkvRJvuKj/bRzbuRY0ARXvL0pWGpsZvn8jku+LMep2eU0seHp8g==} + engines: {node: ^10 || ^12 || >=14} + + rollup@4.67.5: + resolution: {integrity: sha512-3Ve5VH1hacCVutdpbmu/htg4kz+JCOIWgy4Q3hjHPYGHeHeIElNHJ0LcJ3rCfIsd5G7qOl5k5mwpzGMj9kdHPA==} + engines: {node: '>=18.0.0', npm: '>=8.0.0'} + hasBin: true + + semver@6.3.2: + resolution: {integrity: sha512-GYrCADwpu6yV5OAvchkQ27Z5wwMxWAEMg5NNWjyHh/5DboFFqbdbvYNIvZouQpxXyeMPoTOh0vdPYKlf0ZswdQ==} + hasBin: true + + seroval-plugins@1.6.12: + resolution: {integrity: sha512-+reiwp/lYxiyctSrdvX7OQ1YLrcbWYgBiZrhSFL+V43b0/DGRLNVSDyZINbQe+tWplPOI2fw2dPrdv6hcc09kQ==} + engines: {node: '>=10'} + peerDependencies: + seroval: ^1.0 + + seroval@1.6.12: + resolution: {integrity: sha512-CqbIVfk/7GL3ITwZI55lcPbpQbjHZ2DD5cUj4iH7E9YsCfHNJV1mx7yNp86Z84w5IpmkZZS/2s5vPOWmVWSdQg==} + engines: {node: '>=10'} + + solid-js@1.9.18: + resolution: {integrity: sha512-CHGO5YFk6Y9m/1YSxVtKnXfrW7JD3Tmof8HmR4z6TmCPsS8efo8LnzIR8CQh3cUvffqYm6DWyBFfk8dQw1CNQQ==} + + solid-refresh@0.6.3: + resolution: {integrity: sha512-F3aPsX6hVw9ttm5LYlth8Q15x6MlI/J3Dn+o3EQyRTtTxidepSTwAYdozt01/YA+7ObcciagGEyXIopGZzQtbA==} + peerDependencies: + solid-js: ^1.3 + + source-map-js@1.2.2: + resolution: {integrity: sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==} + engines: {node: '>=0.10.0'} + + tinyglobby@0.2.17: + resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==} + engines: {node: '>=12.0.0'} + + typescript@5.9.3: + resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==} + engines: {node: '>=14.17'} + hasBin: true + + undici-types@7.24.6: + resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==} + + update-browserslist-db@1.3.4: + resolution: {integrity: sha512-t8wonIOdQyOjtPd2VktlBu6QjTVTks6v8bSi7kd0r2Vll8TK1JYDZtRRdbmCHOAMphkZgrzK+L+vXK4pyZ8t4A==} + hasBin: true + peerDependencies: + browserslist: '>= 4.21.0' + + vite-plugin-solid@2.11.15: + resolution: {integrity: sha512-twDNPdUDbhem+UOXVu5PyRJvwHFmxSJ3+NxbCgT9iFL42EmWS7lBfFskVM/HXLwd86fh1BgHKJBfGCWkTu2zEg==} + peerDependencies: + '@testing-library/jest-dom': ^5.16.6 || ^5.17.0 || ^6.0.0 || ^7.0.0 + solid-js: ^1.7.2 + vite: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0 || ^9.0.0 + peerDependenciesMeta: + '@testing-library/jest-dom': + optional: true + + vite@7.3.7: + resolution: {integrity: sha512-AHEzTORMbi7/7aXp7w7KZ5+DCUdSeLsJz0grY8xHpc9DHdYb0vQu6DqJfm2tOw3gDExNgPgnJTXxM6syYFHaCA==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + '@types/node': ^20.19.0 || >=22.12.0 + jiti: '>=1.21.0' + less: ^4.0.0 + lightningcss: ^1.21.0 + sass: ^1.70.0 + sass-embedded: ^1.70.0 + stylus: '>=0.54.8' + sugarss: ^5.0.0 + terser: ^5.16.0 + tsx: ^4.8.1 + yaml: ^2.4.2 + peerDependenciesMeta: + '@types/node': + optional: true + jiti: + optional: true + less: + optional: true + lightningcss: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + tsx: + optional: true + yaml: + optional: true + + vitefu@1.1.3: + resolution: {integrity: sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==} + peerDependencies: + vite: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0 + peerDependenciesMeta: + vite: + optional: true + + yallist@3.1.1: + resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==} + +snapshots: + + '@babel/code-frame@7.29.7': + dependencies: + '@babel/helper-validator-identifier': 7.29.7 + js-tokens: 4.0.0 + picocolors: 1.1.1 + + '@babel/compat-data@7.29.7': {} + + '@babel/core@7.29.13': + dependencies: + '@babel/code-frame': 7.29.7 + '@babel/generator': 7.29.13 + '@babel/helper-compilation-targets': 7.29.13 + '@babel/helper-module-transforms': 7.29.13(@babel/core@7.29.13) + '@babel/helpers': 7.29.13 + '@babel/parser': 7.29.13 + '@babel/template': 7.29.7 + '@babel/traverse': 7.29.13 + '@babel/types': 7.29.11 + '@jridgewell/remapping': 2.3.5 + convert-source-map: 2.0.0 + debug: 4.4.3 + gensync: 1.0.0-beta.2 + json5: 2.2.3 + semver: 6.3.2 + transitivePeerDependencies: + - supports-color + + '@babel/generator@7.29.13': + dependencies: + '@babel/parser': 7.29.13 + '@babel/types': 7.29.11 + '@jridgewell/gen-mapping': 0.3.13 + '@jridgewell/trace-mapping': 0.3.31 + jsesc: 3.1.0 + + '@babel/helper-compilation-targets@7.29.13': + dependencies: + '@babel/compat-data': 7.29.7 + '@babel/helper-validator-option': 7.29.7 + browserslist: 4.29.5 + lru-cache: 5.1.1 + semver: 6.3.2 + + '@babel/helper-globals@7.29.7': {} + + '@babel/helper-module-imports@7.18.6': + dependencies: + '@babel/types': 7.29.11 + + '@babel/helper-module-imports@7.29.7': + dependencies: + '@babel/traverse': 7.29.13 + '@babel/types': 7.29.11 + transitivePeerDependencies: + - supports-color + + '@babel/helper-module-transforms@7.29.13(@babel/core@7.29.13)': + dependencies: + '@babel/core': 7.29.13 + '@babel/helper-module-imports': 7.29.7 + '@babel/helper-validator-identifier': 7.29.7 + '@babel/traverse': 7.29.13 + transitivePeerDependencies: + - supports-color + + '@babel/helper-plugin-utils@7.29.7': {} + + '@babel/helper-string-parser@7.29.13': {} + + '@babel/helper-validator-identifier@7.29.7': {} + + '@babel/helper-validator-option@7.29.7': {} + + '@babel/helpers@7.29.13': + dependencies: + '@babel/template': 7.29.7 + '@babel/types': 7.29.11 + + '@babel/parser@7.29.13': + dependencies: + '@babel/types': 7.29.11 + + '@babel/plugin-syntax-jsx@7.29.7(@babel/core@7.29.13)': + dependencies: + '@babel/core': 7.29.13 + '@babel/helper-plugin-utils': 7.29.7 + + '@babel/template@7.29.7': + dependencies: + '@babel/code-frame': 7.29.7 + '@babel/parser': 7.29.13 + '@babel/types': 7.29.11 + + '@babel/traverse@7.29.13': + dependencies: + '@babel/code-frame': 7.29.7 + '@babel/generator': 7.29.13 + '@babel/helper-globals': 7.29.7 + '@babel/parser': 7.29.13 + '@babel/template': 7.29.7 + '@babel/types': 7.29.11 + debug: 4.4.3 + transitivePeerDependencies: + - supports-color + + '@babel/types@7.29.11': + dependencies: + '@babel/helper-string-parser': 7.29.13 + '@babel/helper-validator-identifier': 7.29.7 + + '@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 + + '@fontsource-variable/inter@5.3.0': {} + + '@fontsource/ibm-plex-mono@5.3.0': {} + + '@jridgewell/gen-mapping@0.3.13': + dependencies: + '@jridgewell/sourcemap-codec': 1.6.0 + '@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.6.0': {} + + '@jridgewell/trace-mapping@0.3.31': + dependencies: + '@jridgewell/resolve-uri': 3.1.2 + '@jridgewell/sourcemap-codec': 1.6.0 + + '@playwright/test@1.62.0': + dependencies: + playwright: 1.62.0 + + '@rollup/rollup-android-arm-eabi@4.67.5': + optional: true + + '@rollup/rollup-android-arm64@4.67.5': + optional: true + + '@rollup/rollup-android-x64@4.67.5': + optional: true + + '@rollup/rollup-darwin-arm64@4.67.5': + optional: true + + '@rollup/rollup-darwin-x64@4.67.5': + optional: true + + '@rollup/rollup-freebsd-arm64@4.67.5': + optional: true + + '@rollup/rollup-freebsd-x64@4.67.5': + optional: true + + '@rollup/rollup-linux-arm-gnueabihf@4.67.5': + optional: true + + '@rollup/rollup-linux-arm-musleabihf@4.67.5': + optional: true + + '@rollup/rollup-linux-arm64-gnu@4.67.5': + optional: true + + '@rollup/rollup-linux-arm64-musl@4.67.5': + optional: true + + '@rollup/rollup-linux-loong64-gnu@4.67.5': + optional: true + + '@rollup/rollup-linux-loong64-musl@4.67.5': + optional: true + + '@rollup/rollup-linux-ppc64-gnu@4.67.5': + optional: true + + '@rollup/rollup-linux-ppc64-musl@4.67.5': + optional: true + + '@rollup/rollup-linux-riscv64-gnu@4.67.5': + optional: true + + '@rollup/rollup-linux-riscv64-musl@4.67.5': + optional: true + + '@rollup/rollup-linux-s390x-gnu@4.67.5': + optional: true + + '@rollup/rollup-linux-x64-gnu@4.67.5': + optional: true + + '@rollup/rollup-linux-x64-musl@4.67.5': + optional: true + + '@rollup/rollup-openbsd-x64@4.67.5': + optional: true + + '@rollup/rollup-openharmony-arm64@4.67.5': + optional: true + + '@rollup/rollup-win32-arm64-msvc@4.67.5': + optional: true + + '@rollup/rollup-win32-ia32-msvc@4.67.5': + optional: true + + '@rollup/rollup-win32-x64-gnu@4.67.5': + optional: true + + '@rollup/rollup-win32-x64-msvc@4.67.5': + optional: true + + '@types/babel__core@7.20.5': + dependencies: + '@babel/parser': 7.29.13 + '@babel/types': 7.29.11 + '@types/babel__generator': 7.27.0 + '@types/babel__template': 7.4.4 + '@types/babel__traverse': 7.28.0 + + '@types/babel__generator@7.27.0': + dependencies: + '@babel/types': 7.29.11 + + '@types/babel__template@7.4.4': + dependencies: + '@babel/parser': 7.29.13 + '@babel/types': 7.29.11 + + '@types/babel__traverse@7.28.0': + dependencies: + '@babel/types': 7.29.11 + + '@types/estree@1.0.10': {} + + '@types/node@24.19.2': + dependencies: + undici-types: 7.24.6 + + babel-plugin-jsx-dom-expressions@0.40.11(@babel/core@7.29.13): + dependencies: + '@babel/core': 7.29.13 + '@babel/helper-module-imports': 7.18.6 + '@babel/plugin-syntax-jsx': 7.29.7(@babel/core@7.29.13) + '@babel/types': 7.29.11 + html-entities: 2.3.3 + parse5: 7.3.0 + + babel-preset-solid@1.9.16(@babel/core@7.29.13)(solid-js@1.9.18): + dependencies: + '@babel/core': 7.29.13 + babel-plugin-jsx-dom-expressions: 0.40.11(@babel/core@7.29.13) + optionalDependencies: + solid-js: 1.9.18 + + baseline-browser-mapping@2.11.35: {} + + browserslist@4.29.5: + dependencies: + baseline-browser-mapping: 2.11.35 + caniuse-lite: 1.0.30001822 + electron-to-chromium: 1.5.477 + node-releases: 2.0.63 + update-browserslist-db: 1.3.4(browserslist@4.29.5) + + caniuse-lite@1.0.30001822: {} + + convert-source-map@2.0.0: {} + + csstype@3.2.3: {} + + debug@4.4.3: + dependencies: + ms: 2.1.3 + + electron-to-chromium@1.5.477: {} + + entities@6.0.1: {} + + 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: {} + + fdir@6.5.0(picomatch@4.0.7): + optionalDependencies: + picomatch: 4.0.7 + + fsevents@2.3.2: + optional: true + + fsevents@2.3.3: + optional: true + + gensync@1.0.0-beta.2: {} + + html-entities@2.3.3: {} + + is-what@4.1.16: {} + + js-tokens@4.0.0: {} + + jsesc@3.1.0: {} + + json5@2.2.3: {} + + lru-cache@5.1.1: + dependencies: + yallist: 3.1.1 + + lucide-solid@1.49.0(solid-js@1.9.18): + dependencies: + solid-js: 1.9.18 + + marked@17.0.6: {} + + merge-anything@5.1.7: + dependencies: + is-what: 4.1.16 + + ms@2.1.3: {} + + nanoid@3.3.20: {} + + node-releases@2.0.63: {} + + parse5@7.3.0: + dependencies: + entities: 6.0.1 + + picocolors@1.1.1: {} + + picomatch@4.0.7: {} + + playwright-core@1.62.0: {} + + playwright@1.62.0: + dependencies: + playwright-core: 1.62.0 + optionalDependencies: + fsevents: 2.3.2 + + postcss@8.5.32: + dependencies: + nanoid: 3.3.20 + picocolors: 1.1.1 + source-map-js: 1.2.2 + + rollup@4.67.5: + dependencies: + '@types/estree': 1.0.10 + optionalDependencies: + '@rollup/rollup-android-arm-eabi': 4.67.5 + '@rollup/rollup-android-arm64': 4.67.5 + '@rollup/rollup-android-x64': 4.67.5 + '@rollup/rollup-darwin-arm64': 4.67.5 + '@rollup/rollup-darwin-x64': 4.67.5 + '@rollup/rollup-freebsd-arm64': 4.67.5 + '@rollup/rollup-freebsd-x64': 4.67.5 + '@rollup/rollup-linux-arm-gnueabihf': 4.67.5 + '@rollup/rollup-linux-arm-musleabihf': 4.67.5 + '@rollup/rollup-linux-arm64-gnu': 4.67.5 + '@rollup/rollup-linux-arm64-musl': 4.67.5 + '@rollup/rollup-linux-loong64-gnu': 4.67.5 + '@rollup/rollup-linux-loong64-musl': 4.67.5 + '@rollup/rollup-linux-ppc64-gnu': 4.67.5 + '@rollup/rollup-linux-ppc64-musl': 4.67.5 + '@rollup/rollup-linux-riscv64-gnu': 4.67.5 + '@rollup/rollup-linux-riscv64-musl': 4.67.5 + '@rollup/rollup-linux-s390x-gnu': 4.67.5 + '@rollup/rollup-linux-x64-gnu': 4.67.5 + '@rollup/rollup-linux-x64-musl': 4.67.5 + '@rollup/rollup-openbsd-x64': 4.67.5 + '@rollup/rollup-openharmony-arm64': 4.67.5 + '@rollup/rollup-win32-arm64-msvc': 4.67.5 + '@rollup/rollup-win32-ia32-msvc': 4.67.5 + '@rollup/rollup-win32-x64-gnu': 4.67.5 + '@rollup/rollup-win32-x64-msvc': 4.67.5 + fsevents: 2.3.3 + + semver@6.3.2: {} + + seroval-plugins@1.6.12(seroval@1.6.12): + dependencies: + seroval: 1.6.12 + + seroval@1.6.12: {} + + solid-js@1.9.18: + dependencies: + csstype: 3.2.3 + seroval: 1.6.12 + seroval-plugins: 1.6.12(seroval@1.6.12) + + solid-refresh@0.6.3(solid-js@1.9.18): + dependencies: + '@babel/generator': 7.29.13 + '@babel/helper-module-imports': 7.29.7 + '@babel/types': 7.29.11 + solid-js: 1.9.18 + transitivePeerDependencies: + - supports-color + + source-map-js@1.2.2: {} + + tinyglobby@0.2.17: + dependencies: + fdir: 6.5.0(picomatch@4.0.7) + picomatch: 4.0.7 + + typescript@5.9.3: {} + + undici-types@7.24.6: {} + + update-browserslist-db@1.3.4(browserslist@4.29.5): + dependencies: + browserslist: 4.29.5 + escalade: 3.2.0 + picocolors: 1.1.1 + + vite-plugin-solid@2.11.15(solid-js@1.9.18)(vite@7.3.7(@types/node@24.19.2)): + dependencies: + '@babel/core': 7.29.13 + '@types/babel__core': 7.20.5 + babel-preset-solid: 1.9.16(@babel/core@7.29.13)(solid-js@1.9.18) + merge-anything: 5.1.7 + solid-js: 1.9.18 + solid-refresh: 0.6.3(solid-js@1.9.18) + vite: 7.3.7(@types/node@24.19.2) + vitefu: 1.1.3(vite@7.3.7(@types/node@24.19.2)) + transitivePeerDependencies: + - supports-color + + vite@7.3.7(@types/node@24.19.2): + dependencies: + esbuild: 0.28.2 + fdir: 6.5.0(picomatch@4.0.7) + picomatch: 4.0.7 + postcss: 8.5.32 + rollup: 4.67.5 + tinyglobby: 0.2.17 + optionalDependencies: + '@types/node': 24.19.2 + fsevents: 2.3.3 + + vitefu@1.1.3(vite@7.3.7(@types/node@24.19.2)): + optionalDependencies: + vite: 7.3.7(@types/node@24.19.2) + + yallist@3.1.1: {} diff --git a/site/pnpm-workspace.yaml b/site/pnpm-workspace.yaml new file mode 100644 index 00000000..5ed0b5af --- /dev/null +++ b/site/pnpm-workspace.yaml @@ -0,0 +1,2 @@ +allowBuilds: + esbuild: true diff --git a/site/public/favicon.svg b/site/public/favicon.svg new file mode 100644 index 00000000..abdda760 --- /dev/null +++ b/site/public/favicon.svg @@ -0,0 +1 @@ + diff --git a/site/scripts/deploy.mjs b/site/scripts/deploy.mjs new file mode 100644 index 00000000..5213a9a2 --- /dev/null +++ b/site/scripts/deploy.mjs @@ -0,0 +1,47 @@ +import { cpSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from 'node:fs'; +import { tmpdir } from 'node:os'; +import { join, resolve } from 'node:path'; +import { spawnSync } from 'node:child_process'; + +const siteDir = resolve(import.meta.dirname, '..'); +const distDir = join(siteDir, 'dist'); +const repoDir = resolve(siteDir, '..'); +const tempDir = mkdtempSync(join(tmpdir(), 'srcly-pages-')); + +function git(args, cwd = tempDir) { + const result = spawnSync('git', args, { cwd, encoding: 'utf8' }); + if (result.status !== 0) { + process.stderr.write(result.stderr); + process.exit(result.status ?? 1); + } + return result.stdout.trim(); +} + +try { + if (!readdirSync(distDir).length) throw new Error(`Build output is empty: ${distDir}`); + const remote = git(['remote', 'get-url', 'origin'], repoDir); + const refs = git(['ls-remote', '--heads', remote, 'gh-pages']); + const hasBranch = refs.length > 0; + + if (hasBranch) { + git(['clone', '--quiet', '--single-branch', '--branch', 'gh-pages', remote, tempDir]); + } else { + git(['init', '--quiet', '--initial-branch=gh-pages']); + git(['remote', 'add', 'origin', remote]); + } + + for (const name of readdirSync(tempDir)) { + if (name !== '.git') rmSync(join(tempDir, name), { recursive: true, force: true }); + } + cpSync(distDir, tempDir, { recursive: true }); + writeFileSync(join(tempDir, '.nojekyll'), ''); + + git(['config', 'user.name', 'Byron Wall']); + git(['config', 'user.email', 'byron@byroni.us']); + git(['add', '--all']); + git(['commit', '--allow-empty', '-m', 'Deploy site']); + git(['push', 'origin', 'HEAD:gh-pages']); + process.stdout.write('Published site/dist to gh-pages.\n'); +} finally { + rmSync(tempDir, { recursive: true, force: true }); +} diff --git a/site/scripts/prerender.mjs b/site/scripts/prerender.mjs new file mode 100644 index 00000000..1556bb21 --- /dev/null +++ b/site/scripts/prerender.mjs @@ -0,0 +1,63 @@ +import assert from "node:assert/strict"; +import { mkdir, readFile, readdir, writeFile } from "node:fs/promises"; +import { renderPage } from "../.ssr/server.js"; + +const origin = "https://byronwall.github.io"; +const base = "/srcly/"; +const template = await readFile("dist/index.html", "utf8"); +const escape = (value) => value.replace(/[&<>"']/g, (character) => ({ + "&": "&", "<": "<", ">": ">", '"': """, "'": "'", +})[character]); + +const pages = [{ + route: "", + title: "Srcly — See where your code needs attention", + description: "Explore your codebase as a treemap. Find complexity, inspect findings, trace data flow, and give coding agents focused reports. Run Srcly locally with uvx srcly.", +}]; + +for (const filename of (await readdir("src/docs/pages")).filter((name) => name.endsWith(".md"))) { + const markdown = await readFile(`src/docs/pages/${filename}`, "utf8"); + const title = markdown.match(/^# (.+)$/m)?.[1]; + assert(title, `Missing page title: ${filename}`); + const description = markdown.split(/\n\s*\n/).find((block) => !block.startsWith("#")) + ?.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/[`*_]/g, "").replace(/\s+/g, " ").slice(0, 200); + assert(description, `Missing page introduction: ${filename}`); + pages.push({ route: `docs/${filename.slice(0, -3)}/`, title: `${title} · Srcly docs`, description }); +} + +function html(page) { + const canonical = `${origin}${base}${page.route}`; + const metadata = [ + ``, + ``, + ``, + ``, + ``, + ``, + ``, + ``, + ].join("\n "); + assert.equal(template.match(/.*?<\/title>/g)?.length, 1); + assert.equal(template.match(/<!-- page-meta -->/g)?.length, 1); + assert.equal(template.match(/<div id="root"><\/div>/g)?.length, 1); + return template + .replace(/<title>.*?<\/title>/, `<title>${escape(page.title)}`) + .replace("", metadata) + .replace('
', () => `
${renderPage(`${base}${page.route}`)}
`); +} + +for (const page of pages) { + const directory = `dist/${page.route}`; + await mkdir(directory, { recursive: true }); + await writeFile(`${directory}/index.html`, html(page)); +} + +// Keep the docs entry point readable on static hosts, including without JavaScript. +const start = pages.find((page) => page.route === "docs/get-started/"); +assert(start, "The docs need a get-started page"); +await writeFile("dist/docs/index.html", html(start)); +await writeFile("dist/404.html", html({ route: "404/", title: "Page not found · Srcly", description: "Find Srcly documentation and setup guides." }).replace('\n${pages.map((page) => `${origin}${base}${page.route}`).join("")}\n`); +console.log(`Prerendered ${pages.length} pages, docs entry point, and 404 page.`); diff --git a/site/src/App.tsx b/site/src/App.tsx new file mode 100644 index 00000000..e1799c6b --- /dev/null +++ b/site/src/App.tsx @@ -0,0 +1,129 @@ +import { For, Show, createMemo, createSignal, onCleanup } from 'solid-js'; +import { marked } from 'marked'; +import { ArrowRight, BookOpen, ChevronDown, ChevronLeft, ChevronRight, Code2, ExternalLink, Search, X } from 'lucide-solid'; +import { Landing } from './Landing'; + +const docs = import.meta.glob('./docs/pages/*.md', { query: '?raw', import: 'default', eager: true }) as Record; + +export const pages = [ + { slug: 'get-started', title: 'Get started', description: 'Install Srcly and analyze your first codebase.' }, + { slug: 'explore', title: 'Explore a codebase', description: 'Navigate the treemap, hotspots, explorer, and code view.' }, + { slug: 'metrics', title: 'Metrics', description: 'Understand metric values, scope, and coverage.' }, + { slug: 'findings', title: 'Findings', description: 'Read checker findings and understand what Srcly measured.' }, + { slug: 'data-flow', title: 'Data flow', description: 'Trace TypeScript and JavaScript values through the codebase.' }, + { slug: 'reports', title: 'Reports', description: 'Write compact, reviewable analysis artifacts.' }, + { slug: 'cli', title: 'Command line', description: 'Use Srcly commands in scripts and agent workflows.' }, + { slug: 'configuration', title: 'Configuration', description: 'Set project rules, ignores, and analysis options.' }, +]; + +const groups = [ + { title: 'Start', slugs: ['get-started', 'explore'] }, + { title: 'Understand', slugs: ['metrics', 'findings', 'data-flow'] }, + { title: 'Automate', slugs: ['reports', 'cli'] }, + { title: 'Configure', slugs: ['configuration'] }, +]; +const base = import.meta.env.BASE_URL; + +export default function App(props: { path?: string }) { + const pathname = props.path ?? '/'; + const localPath = pathname.startsWith(base) ? pathname.slice(base.length) : pathname.replace(/^\//, ''); + const slug = localPath.replace(/^docs\/?/, '').replace(/\/$/, '') || (localPath === 'docs' ? 'get-started' : ''); + const page = pages.find(item => item.slug === slug); + if (localPath === '' || localPath === 'index.html') return ; + if (page) return ; + return ; +} + +function DocsPage(props: { page: (typeof pages)[number]; base: string }) { + const docKey = `./docs/pages/${props.page.slug}.md`; + const source = docs[docKey] ?? `# ${props.page.title}\n\nThis guide is being prepared. Start with [Get started](${props.base}docs/get-started/).`; + const normalizedSource = source.replace(/\]\(\.\.\/([a-z0-9-]+)\/?(#[^)]+)?\)/gi, (_match, target: string, hash = '') => `](${props.base}docs/${target}/${hash})`); + const parsed = marked.parse(normalizedSource) as string; + const headings: { title: string; id: string; depth: number }[] = []; + const body = parsed.replace(/(.*?)<\/h\1>/g, (_full, level: string, raw: string) => { + const title = raw.replace(/<[^>]+>/g, '').replace(/&/g, '&').replace(/'|'/g, "'").replace(/"/g, '"'); + const id = slugify(title); + headings.push({ title, id, depth: Number(level) }); + return `${raw}`; + }); + const [query, setQuery] = createSignal(''); + const [menuOpen, setMenuOpen] = createSignal(false); + const [copied, setCopied] = createSignal(''); + let copyTimer: ReturnType | undefined; + onCleanup(() => clearTimeout(copyTimer)); + const searchResults = createMemo(() => { + const q = query().trim().toLowerCase(); + if (!q) return []; + return pages.flatMap(candidate => { + const text = docs[`./docs/pages/${candidate.slug}.md`] ?? ''; + const at = text.toLowerCase().indexOf(q); + return (candidate.title.toLowerCase().includes(q) || at >= 0) + ? [{ ...candidate, excerpt: at >= 0 ? excerpt(text, at) : candidate.description }] + : []; + }); + }); + const idx = pages.findIndex(p => p.slug === props.page.slug); + const previous = pages[idx - 1]; + const next = pages[idx + 1]; + const copyCode = async (button: HTMLButtonElement, code: string) => { + try { + await navigator.clipboard.writeText(code); + setCopied(button.dataset.codeId ?? ''); + clearTimeout(copyTimer); + copyTimer = setTimeout(() => setCopied(''), 1200); + } catch { /* The code stays selectable when clipboard access is unavailable. */ } + }; + let codeIndex = 0; + const contentHtml = body.replace(/
]*)>([\s\S]*?)<\/code><\/pre>/g, (full: string) => {
+    const id = `code-${codeIndex++}`;
+    return `
${full}
`; + }); + return
+
+ +
Documentation{props.page.title}
+
+ +
+ +
{p => {p.title}}
+

{props.page.title}

{props.page.description}

Edit this page
+
+
{ + el.addEventListener('click', event => { + const button = (event.target as Element).closest('.code-copy'); + if (!button) return; + const pre = button.closest('.code-wrap')?.querySelector('code'); + if (pre) void copyCode(button, pre.textContent ?? ''); + }); + }} /> + +
+ +
+
+
+ Code copied +
; +} + +function slugify(text: string) { return text.toLowerCase().replace(/<[^>]*>/g, '').replace(/[^\w\s-]/g, '').trim().replace(/[\s]+/g, '-'); } +function excerpt(text: string, at: number) { return text.slice(Math.max(0, at - 48), at + 90).replace(/[#*`\[\]()>]/g, ' ').replace(/\s+/g, ' ').trim(); } + +function Header(props: { base: string; active?: string }) { + return ; +} +function Mark() { return ; } +function Footer(props: { base: string }) { return ; } +function NotFound(props: { base: string }) { return

This page is not here.

Choose a guide from the documentation.

Open the docs
; } diff --git a/site/src/Landing.tsx b/site/src/Landing.tsx new file mode 100644 index 00000000..ec8b2182 --- /dev/null +++ b/site/src/Landing.tsx @@ -0,0 +1,72 @@ +import { For, createSignal } from 'solid-js'; +import { ArrowDownRight, ArrowRight, Check, CircleHelp, Compass, Code2, FileCode2, Layers3 } from 'lucide-solid'; + +type Metric = 'complexity' | 'comment noise'; +type DemoFile = { name: string; loc: number; complexity: number; comments: number; note: string }; +const files: DemoFile[] = [ + { name: 'scan.ts', loc: 346, complexity: 21, comments: 4, note: 'Several paths converge here. Start with the largest branches.' }, + { name: 'report.ts', loc: 228, complexity: 13, comments: 2, note: 'A central report module with a few high-complexity functions.' }, + { name: 'cache.ts', loc: 146, complexity: 5, comments: 7, note: 'More commentary than executable code in this sample.' }, + { name: 'tree.ts', loc: 119, complexity: 8, comments: 1, note: 'Small aggregation helpers. Values shown are sample data.' }, + { name: 'schema.ts', loc: 91, complexity: 3, comments: 3, note: 'Type and schema definitions are compact in this sample.' }, + { name: 'paths.ts', loc: 73, complexity: 4, comments: 1, note: 'A small path utility file.' }, + { name: 'format.ts', loc: 54, complexity: 2, comments: 2, note: 'Low measured complexity in this sample.' }, + { name: 'types.ts', loc: 39, complexity: 1, comments: 1, note: 'A few shared types.' }, +]; + +export function Landing(props: { base: string }) { + const [metric, setMetric] = createSignal('complexity'); + const [selected, setSelected] = createSignal(files[0]); + return
+
+ +
+
+
+

See where the code gets hard.

+

Srcly maps a codebase into an explorable view of files, functions, and the signals that matter. Start local. Follow the evidence.

+ +

Runs on your machine. No account or upload.

+
+ +
+
+

A map you can follow.

Area shows lines of code. Color shows a selected metric. Click a file to see what the sample contains.

+

Start at the whole tree

Folders contain files. Files can contain functions and nested scopes. Zoom in when a region needs a closer look.

Compare useful signals

Rank hotspots by complexity, size, structure, or supported language signals. A missing measurement stays named as unavailable.

Open the source

Inspect a file or function with its metrics and findings in context. Srcly points to code; you decide what to change.

+
+

From a quick look to a repeatable review.

Use the browser to explore a project. Use the CLI to produce evidence that fits into a pull request or an agent's working context.

See report output
terminallocal analysis
$ uvx srcly report . --out .srcly
+
+✓ report.md
+✓ findings.json
+✓ hotspots.json
+✓ metrics.schema.json
+
+Analysis: 1,248 files · 6 tools · 42 unavailable

Illustrative terminal output

+

Useful signals, with their limits in view.

Srcly combines broad source metrics with language-aware analysis where available. The supported signals vary by language and tool setup; a metric that does not apply is N/A, never zero.

Data-flow analysis covers TypeScript, JavaScript, and Python. It runs with Node.js 18 or newer. Without Node, the rest of Srcly still works and data flow shows the reason it was not analyzed.

How to read the metrics
+

Start with your codebase.

One command opens the local explorer. The guides cover reports, findings, metrics, and configuration.

Read the guide
+
+
+
; +} + +function TreemapDemo(props: { metric: () => Metric; setMetric: (v: Metric) => void; selected: () => DemoFile; setSelected: (f: DemoFile) => void }) { + const shown = () => props.selected(); + return
+
srcly / example-projectSample data
Illustration
+
src/analyzer
Color
+
+ {(file, i) => } + AREA · LOC +
+
lowerhigher {props.metric()} Example values, not a live scan
+
; +} + +function Header(props: { base: string }) { return ; } +function Mark() { return ; } +function Footer(props: { base: string }) { return ; } +function CopyCommand(props: { text: string }) { + const [copied, setCopied] = createSignal(false); let timer: ReturnType | undefined; + const run = async () => { try { await navigator.clipboard.writeText(props.text); setCopied(true); clearTimeout(timer); timer = setTimeout(() => setCopied(false), 1300); } catch { /* Keep the command visible and selectable. */ } }; + return ; +} diff --git a/site/src/docs/pages/cli.md b/site/src/docs/pages/cli.md new file mode 100644 index 00000000..28f3b8bc --- /dev/null +++ b/site/src/docs/pages/cli.md @@ -0,0 +1,83 @@ +# Command-line reference + +Srcly has an interactive command and headless commands for scripts, agents, and CI. Run `uvx srcly --help` or `uvx srcly --help` for the options available in your installed version. + +## Open the interactive app + +```bash +uvx srcly +uvx srcly /path/to/repository +``` + +The server binds to `127.0.0.1` by default and opens the browser. You can set `--port` to choose a port or `--host` to choose an interface. The app reads local repository files through this server. Keep the server on a trusted local interface. + +## Scan and summarize + +`scan` writes the raw analysis tree as JSON. The default filename is `codebase_mri.json`. + +```bash +uvx srcly scan . --out tree.json +``` + +`report` writes the Markdown and JSON artifacts described in [Reports](../reports/). Use `--stdout` for one bundled JSON payload, `--refresh` to rerun analysis and checks, and `--verbose` for progress. + +```bash +uvx srcly report . --out .srcly --profile python +``` + +## Rank or explain + +`hotspots` ranks files or functions by one metric. The default metric is complexity; the default cohort is files. + +```bash +uvx srcly hotspots . --metric complexity --cohort function --limit 20 --format json +``` + +`explain` prints a summary for a repository, folder, file, or symbol. Use `file::symbol` to select a symbol. Paths are relative to the analyzed root; `--at` can also use a line location copied from the report. + +```bash +uvx srcly explain . --at src/app.tsx +uvx srcly explain . --at "src/app.tsx::App" +``` + +## Compare refs + +`compare` compares Git refs. By default, it compares the merge base with the current working tree, including uncommitted edits. You can provide explicit refs or output JSON: + +```bash +uvx srcly compare main HEAD --json +``` + +Unavailable measurements stay null. If a file is measured on only one side, Srcly records a coverage change and does not count that missing measurement as a zero delta. + +## Fix and check + +`fix` prints a diff of supported mechanical fixes. It only applies them with `--write`: + +```bash +uvx srcly fix . +uvx srcly fix . --write +``` + +The `unreachable-file` rule can delete files. It runs only when you name it, and only with `--write`; inspect its diff first: + +```bash +uvx srcly fix . --rule unreachable-file +``` + +`check` requires `--ratchet` and an existing budget. First create the budget with `report`: + +```bash +uvx srcly report . --out .srcly +uvx srcly check . --ratchet +``` + +The budget tracks code files above 5,000 estimated tokens (file bytes divided by four). The check exits 1 when a tracked file grows above its baseline, or a new file crosses that threshold. A missing budget exits 2. + +The budget comes from `.srcly/size_budget.json`. If you use another report directory, pass its budget file with `--budget`: + +```bash +uvx srcly check . --ratchet --budget /tmp/srcly-report/size_budget.json +``` + +See [Configuration](../configuration/) and [Reports](../reports/) for related settings and artifacts. diff --git a/site/src/docs/pages/configuration.md b/site/src/docs/pages/configuration.md new file mode 100644 index 00000000..618ea2e3 --- /dev/null +++ b/site/src/docs/pages/configuration.md @@ -0,0 +1,41 @@ +# Configuration + +Most users can start Srcly without a configuration file. This page covers the project settings and environment variables that change scan behavior or optional checks. + +## Choose the scan root + +Pass a directory to `srcly` or a headless command to select the root. Without a path, Srcly uses the enclosing Git repository, or the current directory when it is not inside one. Srcly follows Git ignore rules and skips common generated, hidden, dependency, and build directories. + +```bash +uvx srcly /path/to/repository +uvx srcly report /path/to/repository --out .srcly +``` + +The interactive server binds to `127.0.0.1` by default and chooses an available port. `--host` and `--port` select another interface or port. Use the local default for local code browsing. + +## Add TypeScript reachability entries + +Srcly detects common TypeScript entry points from routes, package metadata, scripts, and configuration. If your application uses an entry pattern that Srcly does not detect, add globs to `srcly.toml` at the Git root. Patterns are relative to that file. + +```toml +[reachability] +entries = ["app/scripts/**/*.ts"] +``` + +Reachability applies to the TypeScript and JavaScript import graph. Treat an unreachable-file finding as a prompt to check your runtime entry points, dynamic loading, and project structure. + +## Add ast-grep rules + +Put ast-grep YAML rule files in `.srcly/rules/`. Srcly discovers `.yml` and `.yaml` files there and reports their matches with its other findings. Install the ast-grep CLI in the project or on `PATH`, or select it with `SRCLY_AST_GREP`. If it is not available, Srcly reports the check as unavailable. + +See the [rule-pack examples](https://github.com/byronwall/srcly/tree/main/docs/rule-packs) for rule syntax and examples. + +## Environment variables + +- `SRCLY_NODE` selects the Node.js executable used by data-flow analysis. The default is `node` on `PATH`; Node.js 18 or newer is required. +- `SRCLY_CACHE_DIR` changes the local cache directory. By default, the cache is in the operating system's user cache location. +- `SRCLY_FINDINGS_TIMEOUT` sets the timeout for checker jobs. +- `SRCLY_DATAFLOW_TIMEOUT` overrides data-flow request timeouts. +- `SRCLY_AST_GREP` selects the ast-grep executable and overrides project and `PATH` discovery. + +For the full list of command options, run `uvx srcly --help` or see the [CLI reference](../cli/). Use [Reports](../reports/) to select an output directory without changing cache settings. diff --git a/site/src/docs/pages/data-flow.md b/site/src/docs/pages/data-flow.md new file mode 100644 index 00000000..1e4f05ab --- /dev/null +++ b/site/src/docs/pages/data-flow.md @@ -0,0 +1,32 @@ +# Data-flow analysis + +Data flow traces how values move through supported source code. Use it to investigate where a request is handled, what a function does with an input, or where a value is written or returned. It is a separate feature from the TypeScript and TSX import dependency graph. + +## Open a trace + +In the app, switch to **Data flow** from a selected file or function. Choose an anchor, such as a route, exported function, or file. Depending on the anchor and language, Srcly can show a route, a value-flow trace, or function effects. Select a graph item to inspect its source location and relations. + +For a repository summary or an agent workflow, use the headless commands first: + +```bash +uvx srcly report . --out .srcly +uvx srcly explain . --at src/app.tsx +``` + +The data-flow graph is currently an interactive app view; the headless examples above provide general scan and scope context. + +## Requirements and language support + +The bundled engine requires Node.js 18 or newer on `PATH`. Set `SRCLY_NODE` if you need to select a specific Node executable. If Node or the engine is unavailable, Srcly names the reason and keeps the rest of the scan available. + +The engine analyzes TypeScript, JavaScript, and Python roots. TypeScript and JavaScript projects are detected from project configuration or source files. Python projects are detected from Python project files or `.py` files. Loose TypeScript or JavaScript files can also be analyzed. Without project type configuration, some guarantees about null values are unavailable. + +Python analysis has a different feature set from TypeScript. Python routes can open their handler in anchor mode; the TypeScript route graph does not apply to Python. Unsupported constructs or incomplete evidence can stop a trace early. + +## Read outcomes honestly + +Trace results name their outcome. A result can be complete, partial, stale, or not analyzed, with a reason where applicable. A partial result may include an assumed relationship or an unmodeled handoff. Do not treat an empty graph or a missing edge as proof that a value cannot flow. + +The engine models selected language constructs and libraries; it is not a whole-program proof. Coverage depends on the code, available project configuration, and the models Srcly supports. Review the trace's assumptions and source locations, then verify important conclusions in the code and tests. + +See [Explore](../explore/) for the related views and [Configuration](../configuration/) for choosing the Node executable. diff --git a/site/src/docs/pages/explore.md b/site/src/docs/pages/explore.md new file mode 100644 index 00000000..200aba7e --- /dev/null +++ b/site/src/docs/pages/explore.md @@ -0,0 +1,37 @@ +# Explore a codebase + +Srcly offers linked views of one scan: a treemap, a file explorer, Hot Spots, a 2×2 view, a code viewer, and dependency or data-flow graphs where supported. Each view helps you move from a broad signal to the source behind it. + +## Treemap + +The treemap shows folders, files, functions, and code fragments as nested rectangles. Area represents lines of code (LOC). Choose a metric to color the rectangles and change the legend. A folder or file can be opened to focus the map on that part of the repository. + +Use the path and file-type controls to focus the view. You can also hide selected paths from the current view. These view controls change what you see; they do not rewrite the source files. + +## Explorer and Hot Spots + +The explorer lists the scanned tree with sortable columns. Which columns apply depends on the selected node and metric. Select a row to focus the corresponding node and open its code where available. + +Hot Spots ranks files or functions against peers of the same type for one metric. Use it to find a high value to inspect, then open the row and check its witness, source lines, and measurement availability. A ranking is a prompt for review, not a diagnosis. + +## The 2×2 view + +The 2×2 view places files, functions, or supported components on two metric axes. Srcly includes presets such as activity, blast radius, component weight, comment noise, and findings. The view groups points into quadrants; you can adjust the cut-offs and select a group to inspect its members. + +Some presets or cohorts do not apply to every project. Srcly omits unavailable points or explains why a view has no usable data. A point's position reflects the selected metrics and cut-offs, not an overall quality grade. + +## Inspect source and relationships + +Select a file or function to open the code viewer. Metrics and findings can link to lines that contributed to a result. Use the dependency graph to inspect TypeScript and TSX import relationships. It can include external packages and nearby TypeScript path aliases. + +The separate Data flow view traces modeled routes, values, and function effects. Its supported language and analysis limits differ from the dependency graph. See [Data-flow analysis](../data-flow/). + +## A useful review sequence + +1. Choose a metric that matches the question you have. +2. Find a folder or file with a high or unexpected value. +3. Open its code and check the metric's definition and witness. +4. Check whether related findings or dependencies add context. +5. Confirm any suspected issue in the source and with your project tools. + +This sequence avoids treating file size, complexity, or a static-analysis message as proof of a bug. See [Understand metrics](../metrics/) and [Read findings](../findings/) for how Srcly reports these signals. diff --git a/site/src/docs/pages/findings.md b/site/src/docs/pages/findings.md new file mode 100644 index 00000000..b6d77c4f --- /dev/null +++ b/site/src/docs/pages/findings.md @@ -0,0 +1,36 @@ +# Findings and check coverage + +Findings bring selected checker results into Srcly's explorer, code viewer, and reports. Use them to locate code that may need attention, then inspect the source and confirm the issue. A finding is a triage signal, not a confirmed bug. + +## Checks Srcly can run + +Srcly selects checks based on the code and tools it finds: + +- For TypeScript projects, it runs the project's TypeScript compiler when `tsc` and a TypeScript configuration are available. +- It runs ESLint when the project has ESLint and its configuration. +- It runs Ruff for Python. Srcly uses the project's Ruff configuration when present; otherwise it uses a small built-in set of bug-finding rules, identified as Srcly defaults. +- For TypeScript files outside project checker coverage, Srcly has rules for selected patterns, including explicit `any`, suppression directives without a reason, and chains of non-null assertions. +- Srcly also checks selected TypeScript patterns, including Solid-specific rules, await-in-loop patterns, and import-graph reachability. +- Optional ast-grep YAML rules under `.srcly/rules/` can add project-specific checks when ast-grep is installed. + +Checks run independently and have time limits. If a required tool is missing, fails, or times out, Srcly reports that status and reason. It does not turn a missing check into a clean result or a count of zero. Check the tool coverage line in the report before using findings as a complete review. + +## Understand the findings queue + +The report queue ranks code files using a selected profile. Profiles include `general`, `frontend`, `backend`, `typescript`, `python`, and `docs`. They weight available risk-related metrics to help choose a review order. You can also rank files and functions by one metric with `hotspots`. + +Some paths are classified as tests, documentation, styles, fixtures, generated files, vendored code, configuration, or data. The report explains which classes it left out and why. Use `--include-class` when you want one of those classes ranked too. + +When you open a finding, review its location, checker, rule, message, and evidence. Different checkers can have different assumptions and coverage. A finding score does not replace the checker's own output or your review. + +## Improve coverage + +Install and configure the checkers your project uses, then rerun with `--refresh` to bypass cached results: + +```bash +uvx srcly report . --refresh --out .srcly +``` + +For reachability findings, Srcly detects common entries from routes, package metadata, scripts, and configuration. If your TypeScript entry points are not detected, add them under `[reachability] entries` in `srcly.toml`; see [Configuration](../configuration/). + +See [Metrics](../metrics/) for N/A values and [Reports](../reports/) for checker coverage artifacts. diff --git a/site/src/docs/pages/get-started.md b/site/src/docs/pages/get-started.md new file mode 100644 index 00000000..774e9149 --- /dev/null +++ b/site/src/docs/pages/get-started.md @@ -0,0 +1,54 @@ +# Get started + +Srcly turns a local codebase into an interactive map. Use the treemap and file explorer to find areas to inspect, then open code and metrics in context. You can also generate Markdown and JSON reports for scripts and coding agents. + +## Install and launch + +Install [uv](https://docs.astral.sh/uv/) if it is not already available. Then run Srcly with `uvx`; this downloads and runs the tool without a global Srcly install. + +```bash +uvx srcly +``` + +Srcly starts a local web server and opens the app in your browser. By default, the server binds to `127.0.0.1` and selects an available port. Keep the terminal open while you use the app. Press `Ctrl+C` there to stop the server. + +The command uses the enclosing Git repository as its initial root. If the current directory is not in a Git repository, it uses that directory. You can pass a path to choose another root: + +```bash +uvx srcly . +uvx srcly ../another-project +uvx srcly /path/to/repository +``` + +The packaged Srcly release requires Python 3.13 or newer. The Python files you analyze do not need to use that Python version. + +## Run your first scan + +When the app opens, enter or paste a path in the path bar, or keep the suggested path. Click **Analyze**. Srcly reads source files under that path and shows scan progress. The first scan can take longer than later visits; unchanged results are cached on your computer. + +Start in the treemap. Each rectangle represents a folder, file, function, or code fragment. Area represents lines of code. Choose a color metric from the view controls, then select a folder or file to inspect it. The explorer and Hot Spots list provide sortable and ranked views of the same analysis. + +Use the code viewer to inspect the source behind a metric or finding. Srcly's measurements help you choose where to look; they do not prove that code is wrong or unsafe. See [Explore the views](../explore/) and [Understand metrics](../metrics/) for details. + +## Generate a report + +For a terminal workflow, create a report without opening the browser: + +```bash +uvx srcly report . --out .srcly +``` + +This writes a Markdown summary and JSON artifacts under `.srcly/`. Review `report.md` first. The report includes measurement coverage and names unavailable results where applicable. See [Reports for agents and CI](../reports/) for output details. + +## What Srcly analyzes + +Srcly uses Lizard for broad source metrics and adds tree-sitter analysis for TypeScript and TSX, CSS and SCSS, Markdown, notebooks, and Python. The metrics differ by language and file type. A metric that does not apply or could not be measured is shown as N/A, not zero. + +The optional data-flow views require Node.js 18 or newer. Without Node.js, the treemap, metrics, and other scan features remain available. Read [Data-flow analysis](../data-flow/) for its language scope and limits. + +## Next steps + +- [Explore the views](../explore/) +- [Read findings and coverage](../findings/) +- [Use the headless CLI](../cli/) +- [Configure entries and rules](../configuration/) diff --git a/site/src/docs/pages/metrics.md b/site/src/docs/pages/metrics.md new file mode 100644 index 00000000..3100fae1 --- /dev/null +++ b/site/src/docs/pages/metrics.md @@ -0,0 +1,30 @@ +# Understand metrics + +Srcly measures source structure and selected language signals. Metrics appear in the treemap, explorer, Hot Spots, reports, and code viewer. Each metric has a defined scope and aggregation rule; interpret it with its label and availability. + +## Common measurements + +- **LOC** counts nonblank, noncomment lines of code. Folder and file totals aggregate child values. +- **Complexity** is cyclomatic complexity (CCN). A function has its own value. A file or folder shows the maximum among its functions and names the function that sets it. The average complexity is a separate metric. +- **Cognitive complexity** estimates branching and nesting using Sonar's rules. It is available for TypeScript, JavaScript, and Python. +- **Nesting depth, function length, and parameter count** describe code shape. Their aggregation can differ; the metric catalog and UI identify the measure. +- **Component metrics** describe detected React or Solid components, including component LOC, hooks, effects, JSX depth, props, inline handlers, and conditionals. +- **TypeScript signals** include explicit `any` and TypeScript suppression directives. +- **Comment noise** flags selected patterns such as long comment blocks or commented-out code. It is a heuristic, not a style verdict. +- **Git activity** includes commit count and churn over a selected history window. It depends on available Git history. + +Other measurements include file size, imports, exports, TODOs, Markdown data URLs, and language-specific metrics. Detail metrics provide context; they are not all risk scores. + +## Why a metric can be N/A + +N/A means a metric does not apply to that node, its analyzer did not measure it, or required data was unavailable. For example, component metrics do not apply to a file with no detected component. Some checks depend on project configuration or tools. Git activity can be unavailable when Git history is missing. + +Srcly preserves N/A as a distinct state. It is never zero. In comparisons, a metric available on only one side is a coverage change and has no delta. This prevents a missing measurement from appearing to be an improvement. + +## Read aggregated values carefully + +Folder values summarize children according to the metric's rule. Some sum; some use the maximum; others use an average. For complexity, a folder's maximum points to a witness function. Do not read that maximum as the total complexity of all code in the folder. + +Metrics help compare similar code and direct attention. They do not measure correctness, security, or maintainability as a single objective score. Validate a signal against the source, tests, and the project's own standards. + +For exact metric definitions and ranking options, see the UI metric details and `metrics.schema.json` generated by [a report](../reports/). For context on checks that add findings, see [Findings and coverage](../findings/). diff --git a/site/src/docs/pages/reports.md b/site/src/docs/pages/reports.md new file mode 100644 index 00000000..6d87a0bf --- /dev/null +++ b/site/src/docs/pages/reports.md @@ -0,0 +1,60 @@ +# Reports for agents and CI + +Use `report` to scan a repository and write a compact Markdown summary plus JSON artifacts. The output gives a developer or coding agent a starting point for review. It does not make changes to the analyzed source tree beyond the output directory you choose. + +## Create a report + +```bash +uvx srcly report . --out .srcly +``` + +The default output directory is `.srcly`. The report command scans the current repository when you omit the path. Choose a different path when needed: + +```bash +uvx srcly report /path/to/repository --out /tmp/srcly-report +``` + +The main files include: + +- `report.md`: summary, scan and checker coverage, ranked file and function tables, and a compact tree breakdown. +- `findings.json`: machine-readable ranked findings with evidence and suggested prompts. +- `findings.top.json`: a compact top set for an agent to read first. +- `tree.summary.json`: a compressed repository tree. +- `hotspots.json`: file and function rankings for the selected metric. +- `metrics.schema.json`: metric definitions and interpretation hints. +- `agent-skill.md`: guidance for an agent that reads the generated artifacts. +- `size_budget.json`: baseline for the size ratchet used by `check`. + +Artifact formats can be set with `--format markdown`, `--format json`, or `--format both`. The default is `both`. To include the complete analysis tree, add `--include-tree`. To include the TypeScript and TSX dependency graph, add `--include-dependencies`. + +## Choose the ranking + +The findings queue uses a profile. Set one of `general`, `frontend`, `backend`, `typescript`, `python`, or `docs`: + +```bash +uvx srcly report . --profile frontend --out .srcly +``` + +The top file and function tables use one metric. If you omit `--metric`, Srcly chooses the profile's lead metric. Select one explicitly when you want to focus on it: + +```bash +uvx srcly report . --metric complexity --limit 30 --out .srcly +``` + +Add a named 2×2 preset to the report with `--quadrant activity`, `blast_radius`, `component_weight`, `comment_noise`, or `findings`. The `quadrants.json` artifact contains the member lists. Use `--quadrant-cohort file`, `function`, or `component` to choose the point type where the preset supports it. + +## Use JSON on stdout + +For a one-shot agent call, emit the bundled report as JSON on standard output: + +```bash +uvx srcly report . --stdout +``` + +Machine-readable output is kept on stdout. Version information and progress go to stderr. The static metric schema and agent guide are written with `--out`, not included as generated files when using stdout alone. + +## Refresh and interpret results + +Srcly reuses cached results when files and checker signatures are unchanged. Pass `--refresh` to rescan and rerun the checks. `--verbose` prints per-file progress to stderr. + +Read the report's analysis and coverage information before acting on a finding. Missing or failed tools can leave coverage N/A with a reason. Metric N/A values remain different from zero. Rankings help prioritize code review; they are not proof of a defect. See [Findings](../findings/) and [Metrics](../metrics/) for interpretation guidance. diff --git a/site/src/main.tsx b/site/src/main.tsx new file mode 100644 index 00000000..9d883728 --- /dev/null +++ b/site/src/main.tsx @@ -0,0 +1,9 @@ +import { render } from 'solid-js/web'; +import App from './App'; +import './site.css'; + +const root = document.getElementById('root'); +if (root) { + root.replaceChildren(); + render(() => , root); +} diff --git a/site/src/server.tsx b/site/src/server.tsx new file mode 100644 index 00000000..ef7c7a51 --- /dev/null +++ b/site/src/server.tsx @@ -0,0 +1,6 @@ +import { renderToString } from "solid-js/web"; +import App from "./App"; + +export function renderPage(path: string) { + return renderToString(() => ); +} diff --git a/site/src/site.css b/site/src/site.css new file mode 100644 index 00000000..268e1e4b --- /dev/null +++ b/site/src/site.css @@ -0,0 +1,297 @@ +@import '@fontsource-variable/inter'; +@import '@fontsource/ibm-plex-mono'; + +:root { + color-scheme: light; + --bg: #f8fafc; + --paper: #fff; + --ink: #17212e; + --muted: #526273; + --quiet: #69798a; + --line: #dce3ea; + --line-strong: #bdc9d6; + --blue: #1769aa; + --blue-dark: #0e548d; + --blue-soft: #eaf3fa; + --teal: #268c87; + --gold: #c18a39; + --mono: 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace; + --sans: 'Inter Variable', Inter, ui-sans-serif, system-ui, sans-serif; + font-family: var(--sans); + color: var(--ink); + background: var(--bg); + font-synthesis: none; + text-rendering: optimizeLegibility; + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; +} +* { box-sizing: border-box; } +html { scroll-behavior: smooth; scrollbar-color: #9eafbf #eef2f5; } +body { margin: 0; min-width: 320px; font-size: 15px; line-height: 1.6; } +::selection { color: #102c43; background: #cce5f4; } +a { color: var(--blue); text-decoration: none; text-underline-offset: 3px; transition: color 140ms ease-out; } +a:hover { color: var(--blue-dark); text-decoration: underline; } +button, input { font: inherit; } +button { color: inherit; } +:where(a,button,input):focus-visible { outline: 2px solid #1475bc; outline-offset: 3px; border-radius: 3px; } +code, pre { font-family: var(--mono); font-variant-ligatures: none; } +.sr-only { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; } +.skip-link { position: absolute; left: -10000px; top: 0; z-index: 20; padding: 8px 12px; color: #fff; background: var(--blue-dark); } +.skip-link:focus { left: 12px; top: 8px; } +.site-shell { min-height: 100vh; display: flex; flex-direction: column; } +.site-header { height: 64px; width: min(1160px, calc(100% - 64px)); margin: 0 auto; display: flex; align-items: center; justify-content: space-between; border-bottom: 1px solid var(--line); } +.brand { display: inline-flex; align-items: center; gap: 9px; color: var(--ink); font-size: 19px; font-weight: 750; letter-spacing: -.045em; } +.brand:hover { color: var(--ink); text-decoration: none; } +.brand-mark { width: 25px; height: 25px; color: var(--blue); } +.site-header nav { display: flex; align-items: center; gap: 28px; } +.site-header nav a { display: inline-flex; gap: 6px; align-items: center; color: #465a6d; font-size: 14px; font-weight: 550; } +.site-header nav a:hover, .site-header nav a.active { color: var(--blue-dark); } +.landing-shell main { flex: 1; } +.hero-frame { max-width: 1160px; margin: 0 auto; padding: 66px 0 44px; display: grid; grid-template-columns: minmax(280px, .74fr) minmax(550px, 1.26fr); gap: 48px; align-items: center; } +.hero-copy h1 { margin: 0; max-width: 520px; font-size: clamp(42px, 5.2vw, 68px); line-height: 1.03; letter-spacing: -.055em; font-weight: 720; text-wrap: balance; } +.hero-deck { max-width: 425px; margin: 23px 0 24px; color: #425466; font-size: 17px; line-height: 1.65; } +.hero-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 10px; } +.command-button, .button { height: 44px; border-radius: 4px; display: inline-flex; align-items: center; justify-content: space-between; gap: 18px; padding: 0 13px; border: 1px solid var(--line-strong); background: var(--paper); color: var(--ink); cursor: pointer; } +.command-button { min-width: 169px; } +.command-button code { font-size: 13px; font-weight: 550; } +.command-button code span { color: var(--blue); } +.command-copy { min-width: 30px; text-align: right; color: var(--muted); font-size: 12px; } +.button { justify-content: center; font-size: 14px; font-weight: 650; } +.button:hover, .command-button:hover { background: #f0f5f8; text-decoration: none; } +.button-primary { color: #fff; background: var(--blue); border-color: var(--blue); } +.button-primary:hover { color: #fff; background: var(--blue-dark); } +.hero-note { margin: 10px 0 0; color: var(--muted); font-size: 12px; } +.demo { min-width: 0; background: var(--paper); border: 1px solid var(--line-strong); box-shadow: 0 9px 25px rgb(39 60 80 / 8%); } +.demo-top { height: 43px; padding: 0 13px; border-bottom: 1px solid var(--line); display: flex; align-items: center; justify-content: space-between; } +.demo-title { font: 550 12px var(--mono); color: #34485a; } +.demo-sample { margin-left: 9px; color: var(--quiet); font-size: 11px; } +.demo-status { display: flex; align-items: center; gap: 6px; color: #657687; font-size: 11px; } +.demo-status span, .selected-dot { width: 7px; height: 7px; border-radius: 50%; background: var(--teal); } +.demo-toolbar { min-height: 47px; padding: 7px 12px; display: flex; justify-content: space-between; align-items: center; gap: 10px; border-bottom: 1px solid var(--line); } +.demo-crumb { display: flex; gap: 8px; align-items: center; color: #657687; font: 12px var(--mono); } +.demo-crumb strong { color: #23394d; font-weight: 550; } +.metric-control { display: flex; align-items: center; gap: 4px; } +.metric-control > span { color: #627487; margin-right: 4px; font-size: 11px; } +.metric-control button { border: 0; background: transparent; border-radius: 3px; color: #506276; cursor: pointer; font-size: 11px; padding: 5px 7px; } +.metric-control button:hover { background: #f0f4f7; } +.metric-control button.chosen { color: #125788; background: #e7f2fa; font-weight: 650; } +.demo-body { display: grid; grid-template-columns: minmax(0, 1fr) 194px; gap: 12px; padding: 12px; } +.tile-map { min-height: 257px; display: grid; grid-template-columns: 1.32fr 1fr .83fr .67fr; grid-template-rows: 1.23fr 1fr .72fr; gap: 3px; position: relative; padding-bottom: 18px; } +.map-tile { min-width: 0; padding: 8px; border: 1px solid transparent; border-radius: 2px; display: flex; flex-direction: column; justify-content: space-between; align-items: flex-start; cursor: pointer; text-align: left; color: #19324a; transition: background-color 140ms ease-out, border-color 140ms ease-out; } +.map-tile:hover { border-color: #4e87aa; } +.map-tile.selected { border: 2px solid #125e92; padding: 7px; } +.map-tile span { font: 550 11px var(--mono); overflow-wrap: anywhere; } +.map-tile small { color: #3d566e; font-size: 10px; } +.tile-0 { grid-column: 1 / 3; grid-row: 1 / 3; background: #8cb9ce; } +.tile-1 { grid-column: 3 / 5; grid-row: 1; background: #a9c8d3; } +.tile-2 { grid-column: 3; grid-row: 2 / 4; background: #d3e1e2; } +.tile-3 { grid-column: 4; grid-row: 2; background: #bdd2d5; } +.tile-4 { grid-column: 1; grid-row: 3; background: #c2d7dc; } +.tile-5 { grid-column: 2; grid-row: 3; background: #d3e2e3; } +.tile-6 { grid-column: 4; grid-row: 3; background: #e1e9e9; } +.tile-7 { grid-column: 3; grid-row: 1; transform: translateY(calc(100% + 3px)); height: calc(100% - 3px); z-index: 1; opacity: .95; } +.map-tile.tile-7 { display: none; } +.tile-label { position: absolute; bottom: 0; left: 0; color: #708193; font: 10px var(--mono); letter-spacing: .02em; } +.demo-detail { min-width: 0; min-height: 257px; padding: 9px 3px; } +.detail-top { display: flex; align-items: center; justify-content: space-between; color: #627487; text-transform: uppercase; letter-spacing: .07em; font-size: 9px; font-weight: 650; } +.demo-detail > strong { display: block; margin: 11px 0 14px; color: #173955; font: 550 15px var(--mono); } +.demo-detail dl { margin: 0; } +.demo-detail dl div { display: flex; justify-content: space-between; gap: 4px; padding: 5px 0; border-top: 1px solid #e8edf1; } +.demo-detail dt { color: #526578; font-size: 10px; } +.demo-detail dd { margin: 0; color: #263f56; font: 11px var(--mono); font-variant-numeric: tabular-nums; } +.demo-detail p { min-height: 52px; margin: 11px 0 13px; color: #536779; font-size: 10px; line-height: 1.55; } +.metric-swatch { display: inline-flex; align-items: center; gap: 5px; color: #586b7d; font-size: 9px; } +.metric-swatch i { width: 10px; height: 10px; background: #4b9ac1; border-radius: 1px; } +.metric-swatch.warm i { background: #d19c54; } +.demo-legend { min-height: 36px; border-top: 1px solid var(--line); padding: 0 14px; display: flex; align-items: center; gap: 13px; color: #657687; font-size: 10px; } +.demo-legend span { display: inline-flex; align-items: center; gap: 5px; } +.demo-legend i { width: 9px; height: 9px; border-radius: 1px; } +.legend-low { background: #dce8e8; }.legend-high { background: #5e9dbc; } +.demo-footnote { margin-left: auto; } +.demo-footnote svg { color: #718396; } +.how-section, .workflow-section, .coverage-section, .docs-cta { max-width: 1160px; margin: 0 auto; } +.how-section { border-top: 1px solid var(--line); padding: 41px 0 43px; } +.section-heading { display: flex; align-items: baseline; justify-content: space-between; gap: 30px; margin-bottom: 30px; } +.section-heading h2, .workflow-copy h2, .coverage-section h2, .docs-cta h2 { margin: 0; font-size: clamp(25px, 3vw, 36px); letter-spacing: -.045em; line-height: 1.15; font-weight: 680; } +.section-heading p { max-width: 485px; margin: 0; color: #536678; font-size: 14px; } +.explore-row { display: grid; grid-template-columns: 1fr 32px 1fr 32px 1fr; gap: 19px; align-items: start; } +.flow-step { display: flex; gap: 14px; } +.step-mark { flex: 0 0 32px; height: 32px; display: grid; place-items: center; color: var(--blue); background: #e7f1f7; } +.flow-step h3 { margin: 0 0 7px; font-size: 15px; line-height: 1.4; font-weight: 650; } +.flow-step p { margin: 0; max-width: 290px; color: #536678; font-size: 13px; line-height: 1.55; } +.flow-arrow { margin-top: 5px; color: #8193a3; } +.workflow-section { border-top: 1px solid var(--line); padding: 42px 0; display: grid; grid-template-columns: 1fr 1fr; gap: 72px; align-items: center; } +.workflow-copy p, .coverage-copy p, .docs-cta p { max-width: 520px; color: #506375; font-size: 15px; line-height: 1.65; } +.workflow-copy .text-link, .coverage-copy .text-link { display: inline-flex; align-items: center; gap: 6px; margin-top: 5px; font-size: 14px; font-weight: 550; } +.workflow-code { background: #f0f4f6; border: 1px solid var(--line); } +.code-title { height: 36px; display: flex; align-items: center; justify-content: space-between; padding: 0 12px; border-bottom: 1px solid var(--line); color: #617486; font-size: 10px; } +.code-title span:first-child { font-family: var(--mono); color: #40576b; } +.workflow-code pre { margin: 0; padding: 14px 16px 6px; white-space: pre-wrap; overflow-wrap: anywhere; color: #2d4358; font-size: 11px; line-height: 1.75; } +.terminal-muted { color: #77899a; }.terminal-green { color: #208570; } +.sample-caption { margin: 0; padding: 0 16px 10px; color: #758595; text-align: right; font-size: 10px; } +.coverage-section { border-top: 1px solid var(--line); padding: 41px 0 44px; display: grid; grid-template-columns: .9fr 1.1fr; gap: 68px; } +.coverage-copy p:first-child { margin-top: 0; } +.docs-cta { margin-bottom: 52px; padding: 26px 28px; border: 1px solid var(--line-strong); background: #f1f6f8; display: flex; align-items: center; justify-content: space-between; gap: 30px; } +.docs-cta h2 { font-size: 25px; } +.docs-cta p { margin: 7px 0 0; font-size: 13px; } +.docs-cta .button { flex: 0 0 auto; } +.site-footer { max-width: 1160px; width: 100%; margin: auto auto 0; min-height: 75px; border-top: 1px solid var(--line); display: flex; align-items: center; gap: 21px; color: #68798a; font-size: 12px; } +.footer-brand { font-size: 15px; } +.footer-brand .brand-mark { width: 19px; height: 19px; } +.site-footer > div { display: flex; align-items: center; gap: 20px; margin-left: auto; } +.site-footer > div a { display: inline-flex; align-items: center; gap: 5px; color: #506375; } +.not-found { flex: 1; max-width: 760px; width: calc(100% - 40px); margin: 90px auto; } +.not-found h1 { font-size: 40px; letter-spacing: -.04em; } +.text-link { display: inline-flex; align-items: center; gap: 6px; font-weight: 550; } +.docs-topline { width: min(1160px, calc(100% - 64px)); margin: 0 auto; padding: 16px 0 0; display: flex; gap: 10px; color: #607284; font-size: 12px; } +.docs-layout { width: min(1160px, calc(100% - 64px)); margin: 0 auto; flex: 1; display: grid; grid-template-columns: 220px minmax(0, 1fr); gap: 55px; padding: 24px 0 64px; } +.docs-sidebar { position: relative; border-right: 1px solid var(--line); padding: 1px 22px 48px 0; } +.sidebar-label { margin: 0 0 12px; color: #566a7c; font-size: 11px; text-transform: uppercase; letter-spacing: .07em; font-weight: 650; } +.search-box { height: 34px; border: 1px solid var(--line-strong); background: var(--paper); display: flex; align-items: center; gap: 7px; padding: 0 8px; color: #65798a; } +.search-box:focus-within { border-color: var(--blue); } +.search-box input { min-width: 0; width: 100%; border: 0; padding: 0; background: transparent; color: var(--ink); font-size: 12px; outline: none; } +.search-box input::placeholder { color: #647689; opacity: 1; } +.search-box button { display: grid; place-items: center; border: 0; background: none; cursor: pointer; padding: 2px; color: #536a7e; } +.nav-group { margin-top: 25px; } +.nav-group h2 { margin: 0 0 7px; color: #768595; font-size: 10px; font-weight: 650; letter-spacing: .08em; text-transform: uppercase; } +.side-link { display: block; margin-left: -9px; padding: 5px 8px; border-radius: 3px; color: #455a6e; font-size: 13px; } +.side-link:hover { background: #edf2f5; text-decoration: none; } +.side-link.current { color: #155e91; background: #e8f1f7; font-weight: 650; } +.sidebar-bottom { position: absolute; bottom: 7px; left: 0; } +.sidebar-bottom a { display: flex; align-items: center; gap: 6px; color: #566a7c; font-size: 11px; } +.search-results { padding-top: 14px; } +.search-result { display: block; padding: 10px 2px; border-bottom: 1px solid var(--line); color: inherit; } +.search-result strong { display: block; color: var(--blue-dark); font-size: 13px; } +.search-result span { display: block; margin-top: 3px; color: #586c7e; font-size: 11px; line-height: 1.45; } +.empty-search { color: #586c7e; font-size: 12px; } +.docs-article { min-width: 0; } +.article-head { display: flex; justify-content: space-between; align-items: end; gap: 24px; padding: 4px 0 24px; border-bottom: 1px solid var(--line); } +.breadcrumb { margin: 0 0 11px; display: flex; gap: 9px; align-items: center; color: #67798b; font-size: 11px; } +.breadcrumb span { color: #a0acb7; } +.article-head h1 { margin: 0; font-size: clamp(32px, 4vw, 45px); line-height: 1.12; letter-spacing: -.05em; font-weight: 700; } +.article-summary { margin: 9px 0 0; color: #536678; font-size: 15px; } +.edit-link { flex: 0 0 auto; display: inline-flex; gap: 5px; align-items: center; margin-bottom: 5px; color: #627588; font-size: 11px; } +.article-grid { display: grid; grid-template-columns: minmax(0, 1fr) 160px; gap: 32px; padding-top: 27px; } +.markdown { min-width: 0; max-width: 74ch; color: #28394a; font-size: 15px; line-height: 1.72; } +.markdown > :first-child { margin-top: 0; } +.markdown h2 { margin: 2.2em 0 .65em; color: #1b2b3a; font-size: 25px; line-height: 1.25; letter-spacing: -.035em; font-weight: 670; } +.markdown h3 { margin: 1.9em 0 .55em; color: #25384b; font-size: 18px; line-height: 1.35; letter-spacing: -.02em; } +.markdown p { margin: .85em 0; } +.markdown ul, .markdown ol { padding-left: 1.45em; margin: .8em 0 1.1em; } +.markdown li { padding-left: .2em; margin: .3em 0; } +.markdown li::marker { color: #617b91; } +.markdown strong { color: #203247; font-weight: 650; } +.markdown a { font-weight: 520; } +.markdown blockquote { margin: 1.3em 0; padding: 3px 15px; border-left: 2px solid #8aaec5; color: #415a70; background: #f1f6f8; } +.markdown code:not(pre code) { padding: 2px 4px; background: #eef2f4; border-radius: 2px; color: #254b68; font-size: .9em; } +.code-wrap { position: relative; margin: 1.1em 0 1.4em; } +.markdown pre { margin: 0; padding: 13px 15px; overflow-x: auto; border: 1px solid #d9e1e7; background: #f1f5f7; color: #273d51; white-space: pre-wrap; overflow-wrap: anywhere; font-size: 12px; line-height: 1.65; } +.markdown pre code { color: inherit; } +.code-copy { position: absolute; top: 6px; right: 7px; width: 28px; height: 26px; display: grid; place-items: center; border: 1px solid transparent; border-radius: 3px; background: transparent; color: #536b7e; cursor: pointer; } +.code-copy:hover { background: #e6edf1; border-color: #d5e0e7; } +.code-copy.is-copied { color: #147663; } +.markdown table { display: block; width: max-content; max-width: 100%; overflow-x: auto; border-collapse: collapse; margin: 1.2em 0 1.5em; font-size: 13px; line-height: 1.5; } +.markdown th, .markdown td { padding: 8px 11px; border: 1px solid #d9e1e7; text-align: left; vertical-align: top; } +.markdown th { background: #edf2f5; color: #31475a; font-weight: 650; } +.markdown hr { margin: 2em 0; border: 0; border-top: 1px solid var(--line); } +.markdown img { max-width: 100%; height: auto; } +.toc { align-self: start; position: sticky; top: 18px; padding: 0 0 0 13px; border-left: 1px solid var(--line); } +.toc h2 { margin: 0 0 9px; color: #526779; font-size: 10px; text-transform: uppercase; letter-spacing: .07em; } +.toc a { display: block; padding: 4px 0; color: #586b7c; font-size: 11px; line-height: 1.4; } +.toc a.indent { padding-left: 10px; } +.toc p { color: #68798a; font-size: 11px; } +.page-nav { margin-top: 42px; border-top: 1px solid var(--line); padding-top: 15px; display: flex; justify-content: space-between; gap: 12px; } +.page-nav > a { min-width: 0; display: inline-flex; gap: 7px; align-items: center; padding: 7px 0; color: #41596e; } +.page-nav .next-page { margin-left: auto; text-align: right; } +.page-nav small { display: block; color: #778798; font-size: 10px; } +.page-nav strong { display: block; font-size: 13px; font-weight: 600; } +.topics-toggle, .mobile-topics { display: none; } + +@media (max-width: 1200px) { + .hero-frame, .how-section, .workflow-section, .coverage-section, .docs-cta, .site-footer { width: calc(100% - 64px); } + .hero-frame { gap: 32px; grid-template-columns: minmax(250px, .72fr) minmax(500px, 1.28fr); } +} +@media (max-width: 900px) { + .hero-frame { grid-template-columns: 1fr; padding-top: 43px; gap: 32px; } + .hero-copy { max-width: 700px; } + .hero-copy h1 { max-width: 620px; } + .hero-deck { max-width: 620px; margin: 15px 0 17px; } + .demo { max-width: 760px; width: 100%; justify-self: center; } + .explore-row { gap: 12px; } + .flow-step { gap: 9px; } + .workflow-section, .coverage-section { gap: 35px; } + .docs-layout { grid-template-columns: 190px minmax(0, 1fr); gap: 30px; } + .article-grid { grid-template-columns: minmax(0, 1fr); } + .toc { display: none; } +} +@media (max-width: 640px) { + body { font-size: 14px; } + .site-header, .docs-topline, .docs-layout { width: calc(100% - 36px); } + .site-header { height: 57px; } + .brand { font-size: 17px; } + .brand-mark { width: 22px; height: 22px; } + .site-header nav { gap: 15px; } + .site-header nav a { font-size: 12px; } + .hero-frame, .how-section, .workflow-section, .coverage-section, .docs-cta, .site-footer { width: calc(100% - 36px); } + .hero-frame { padding: 35px 0 30px; gap: 26px; } + .hero-copy h1 { font-size: clamp(39px, 11vw, 54px); } + .hero-deck { font-size: 15px; } + .hero-actions { gap: 8px; } + .button, .command-button { height: 42px; } + .demo-top { padding: 0 9px; } + .demo-title { font-size: 10px; } + .demo-sample { font-size: 9px; margin-left: 5px; } + .demo-status { font-size: 9px; } + .demo-toolbar { align-items: flex-start; flex-direction: column; padding: 8px 9px; gap: 5px; } + .metric-control { flex-wrap: wrap; } + .metric-control button { padding: 4px 6px; font-size: 10px; } + .demo-body { grid-template-columns: minmax(0, 1fr) 123px; padding: 8px; gap: 8px; } + .tile-map, .demo-detail { min-height: 235px; } + .map-tile { padding: 5px; } + .map-tile.selected { padding: 4px; } + .map-tile span { font-size: 9px; } + .map-tile small { font-size: 8px; } + .demo-detail { padding: 6px 0; } + .demo-detail > strong { font-size: 12px; } + .demo-detail dt { font-size: 9px; } + .demo-detail dd { font-size: 9px; } + .demo-detail p { font-size: 9px; } + .demo-legend { padding: 0 9px; gap: 9px; font-size: 9px; } + .demo-footnote { font-size: 0 !important; } + .demo-footnote svg { width: 14px; height: 14px; } + .how-section { padding: 30px 0; } + .section-heading { display: block; margin-bottom: 22px; } + .section-heading p { margin-top: 9px; } + .explore-row { grid-template-columns: 1fr; gap: 17px; } + .flow-step p { max-width: 100%; } + .flow-arrow { display: none; } + .workflow-section, .coverage-section { padding: 30px 0; grid-template-columns: 1fr; gap: 20px; } + .coverage-section { gap: 6px; } + .docs-cta { margin-bottom: 34px; padding: 18px; align-items: flex-start; flex-direction: column; gap: 12px; } + .docs-cta h2 { font-size: 23px; } + .site-footer { min-height: 70px; flex-wrap: wrap; gap: 6px 12px; padding: 12px 0; } + .site-footer > span { font-size: 10px; } + .site-footer > div { gap: 12px; } + .docs-topline { padding-top: 12px; } + .docs-layout { display: block; padding-top: 12px; } + .docs-sidebar { display: none; } + .topics-toggle { width: 100%; display: flex; justify-content: flex-start; align-items: center; gap: 8px; padding: 8px 10px; border: 1px solid var(--line-strong); background: var(--paper); cursor: pointer; color: #3c5468; font-size: 12px; } + .topics-toggle svg:last-child { margin-left: auto; transition: transform 140ms; } + .topics-toggle svg.rotated { transform: rotate(180deg); } + .mobile-topics { display: grid; grid-template-columns: 1fr 1fr; border: 1px solid var(--line); border-top: 0; background: #fff; padding: 7px; } + .mobile-topics a { padding: 7px; color: #455b6f; font-size: 12px; } + .mobile-topics a[aria-current] { color: var(--blue-dark); font-weight: 650; } + .article-head { padding: 19px 0 17px; display: block; } + .article-head h1 { font-size: 35px; } + .article-summary { font-size: 13px; } + .edit-link { margin-top: 13px; } + .article-grid { padding-top: 20px; } + .markdown { font-size: 14px; line-height: 1.68; } + .markdown h2 { font-size: 22px; } + .markdown h3 { font-size: 17px; } + .markdown pre { font-size: 11px; padding: 12px; } + .page-nav { margin-top: 30px; } +} +@media (prefers-reduced-motion: reduce) { + *, *::before, *::after { scroll-behavior: auto !important; transition-duration: .01ms !important; animation-duration: .01ms !important; } +} diff --git a/site/tests/site.spec.ts b/site/tests/site.spec.ts new file mode 100644 index 00000000..41422050 --- /dev/null +++ b/site/tests/site.spec.ts @@ -0,0 +1,68 @@ +import { expect, test } from "@playwright/test"; + +const guides = ["get-started", "explore", "metrics", "findings", "data-flow", "reports", "cli", "configuration"]; + +test("every guide has readable static HTML and valid local links", async ({ browser, request }) => { + const context = await browser.newContext({ javaScriptEnabled: false }); + const page = await context.newPage(); + const links = new Set(); + for (const slug of guides) { + const response = await page.goto(`http://127.0.0.1:18588/srcly/docs/${slug}/`); + expect(response?.status()).toBe(200); + await expect(page.locator(".markdown")).toContainText("Srcly"); + await expect(page.locator(".markdown h2").first()).toBeVisible(); + expect(await page.locator('link[rel="canonical"]').getAttribute("href")).toBe(`https://byronwall.github.io/srcly/docs/${slug}/`); + for (const link of await page.locator("a[href]").evaluateAll((nodes) => nodes.map((node) => (node as HTMLAnchorElement).href))) { + if (link.startsWith("http://127.0.0.1:18588/")) links.add(link.split("#")[0]); + } + for (const id of await page.locator('.toc a[href^="#"]').evaluateAll((nodes) => nodes.map((node) => node.getAttribute("href")!.slice(1)))) { + expect(await page.locator(`[id="${id}"]`).count()).toBe(1); + } + } + for (const link of links) { + const response = await request.get(link); + expect(response.status(), link).toBe(200); + expect(await response.text(), link).not.toContain("This page is not here."); + } + await context.close(); +}); + +test("the example responds to file and metric selection", async ({ page }) => { + const errors: string[] = []; + page.on("pageerror", (error) => errors.push(error.message)); + await page.goto("./"); + await page.locator('[data-file="cache.ts"]').focus(); + await page.keyboard.press("Enter"); + await expect(page.locator("[data-selected-file]")).toHaveText("cache.ts"); + const before = await page.locator('[data-file="cache.ts"]').evaluate((element) => getComputedStyle(element).backgroundColor); + await page.locator('[data-metric="comment-noise"]').click(); + await expect(page.locator('[data-metric="comment-noise"]')).toHaveAttribute("aria-pressed", "true"); + const after = await page.locator('[data-file="cache.ts"]').evaluate((element) => getComputedStyle(element).backgroundColor); + expect(after).not.toBe(before); + expect(errors).toEqual([]); +}); + +test("search finds guide content and direct navigation survives reload", async ({ page }) => { + await page.goto("docs/get-started/"); + await page.locator("[data-doc-search]").fill("ratchet"); + await expect(page.locator('[data-search-result="cli"]')).toBeVisible(); + await page.locator('[data-search-result="cli"]').click(); + await expect(page).toHaveURL(/\/srcly\/docs\/cli\/$/); + await page.reload(); + await expect(page.locator(".markdown")).toContainText("--ratchet"); + await page.locator("[data-doc-search]").fill("no-such-feature-9281"); + await expect(page.locator(".empty-search")).toBeVisible(); +}); + +test("mobile navigation works without page overflow", async ({ page }) => { + await page.setViewportSize({ width: 390, height: 844 }); + for (const route of ["./", "docs/get-started/", "docs/cli/"]) { + await page.goto(route); + expect(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth), route).toBe(true); + } + await page.locator("[data-topics-toggle]").click(); + await expect(page.locator("[data-topics-toggle]")).toHaveAttribute("aria-expanded", "true"); + await page.locator('[data-mobile-topics] a[href$="/metrics/"]').click(); + await expect(page).toHaveURL(/\/srcly\/docs\/metrics\/$/); + await expect(page.locator(".markdown")).toContainText("N/A"); +}); diff --git a/site/tsconfig.json b/site/tsconfig.json new file mode 100644 index 00000000..ba91dd6c --- /dev/null +++ b/site/tsconfig.json @@ -0,0 +1,16 @@ +{ + "compilerOptions": { + "target": "ES2022", + "lib": ["ES2022", "DOM", "DOM.Iterable"], + "module": "ESNext", + "moduleResolution": "Bundler", + "jsx": "preserve", + "jsxImportSource": "solid-js", + "noEmit": true, + "strict": true, + "skipLibCheck": true, + "esModuleInterop": true, + "types": ["vite/client", "node"] + }, + "include": ["src", "vite.config.ts", "playwright.config.ts", "tests"] +} diff --git a/site/vite.config.ts b/site/vite.config.ts new file mode 100644 index 00000000..819ad888 --- /dev/null +++ b/site/vite.config.ts @@ -0,0 +1,9 @@ +import { defineConfig } from "vite"; +import solid from "vite-plugin-solid"; + +export default defineConfig({ + base: "/srcly/", + plugins: [solid()], + ssr: { noExternal: ["lucide-solid"] }, + build: { target: "es2022" }, +}); From 653037aac239c22ef8720e50f652cf6cd4d91dc0 Mon Sep 17 00:00:00 2001 From: Byron Wall Date: Fri, 6 Nov 2026 18:37:06 -0500 Subject: [PATCH 2/2] fix(site): keep guide titles and terminal output clear --- site/src/App.tsx | 2 +- site/src/Landing.tsx | 12 ++++++------ 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/site/src/App.tsx b/site/src/App.tsx index e1799c6b..3e68084f 100644 --- a/site/src/App.tsx +++ b/site/src/App.tsx @@ -38,7 +38,7 @@ function DocsPage(props: { page: (typeof pages)[number]; base: string }) { const docKey = `./docs/pages/${props.page.slug}.md`; const source = docs[docKey] ?? `# ${props.page.title}\n\nThis guide is being prepared. Start with [Get started](${props.base}docs/get-started/).`; const normalizedSource = source.replace(/\]\(\.\.\/([a-z0-9-]+)\/?(#[^)]+)?\)/gi, (_match, target: string, hash = '') => `](${props.base}docs/${target}/${hash})`); - const parsed = marked.parse(normalizedSource) as string; + const parsed = marked.parse(normalizedSource.replace(/^# .+\n+/, '')) as string; const headings: { title: string; id: string; depth: number }[] = []; const body = parsed.replace(/(.*?)<\/h\1>/g, (_full, level: string, raw: string) => { const title = raw.replace(/<[^>]+>/g, '').replace(/&/g, '&').replace(/'|'/g, "'").replace(/"/g, '"'); diff --git a/site/src/Landing.tsx b/site/src/Landing.tsx index ec8b2182..c2516c14 100644 --- a/site/src/Landing.tsx +++ b/site/src/Landing.tsx @@ -34,14 +34,14 @@ export function Landing(props: { base: string }) {

A map you can follow.

Area shows lines of code. Color shows a selected metric. Click a file to see what the sample contains.

Start at the whole tree

Folders contain files. Files can contain functions and nested scopes. Zoom in when a region needs a closer look.

Compare useful signals

Rank hotspots by complexity, size, structure, or supported language signals. A missing measurement stays named as unavailable.

Open the source

Inspect a file or function with its metrics and findings in context. Srcly points to code; you decide what to change.

-

From a quick look to a repeatable review.

Use the browser to explore a project. Use the CLI to produce evidence that fits into a pull request or an agent's working context.

See report output
terminallocal analysis
$ uvx srcly report . --out .srcly
+      

From a quick look to a repeatable review.

Use the browser to explore a project. Use the CLI to produce evidence that fits into a pull request or an agent's working context.

See report output
terminallocal analysis
{`$ uvx srcly report . --out .srcly
 
-✓ report.md
-✓ findings.json
-✓ hotspots.json
-✓ metrics.schema.json
+report.md
+findings.json
+hotspots.json
+metrics.schema.json
 
-Analysis: 1,248 files · 6 tools · 42 unavailable

Illustrative terminal output

+Analysis: 1,248 files · 6 tools · 42 unavailable`}

Illustrative terminal output

Useful signals, with their limits in view.

Srcly combines broad source metrics with language-aware analysis where available. The supported signals vary by language and tool setup; a metric that does not apply is N/A, never zero.

Data-flow analysis covers TypeScript, JavaScript, and Python. It runs with Node.js 18 or newer. Without Node, the rest of Srcly still works and data flow shows the reason it was not analyzed.

How to read the metrics

Start with your codebase.

One command opens the local explorer. The guides cover reports, findings, metrics, and configuration.

Read the guide