Chore/upstream 202604

[craftzdog]

Status

• Phase 1 — Snapshot & branch (chore/upstream-202604, checked out by user)
• Phase 2 — Dependencies + lockfile (drop @svgr/webpack, autoprefixer; bumped next 16.2.2 → 16.2.4 to clear security advisory)
• Phase 3 — Tooling configs (postcss / prettier / eslint flat config / tsconfig jsx:react-jsx)
• Phase 4 — Tailwind v4 CSS migration (rewrite tailwind.css with @theme/@plugin, prism.css theme() → var(), deleted tailwind.config.ts, preserved font-proxyma and --container-8xl)
• Phase 5 — Tailwind class sweep (bg-gradient-to-* → bg-linear-to-, backdrop-blur → -sm, flex-grow → grow, break-words → wrap-break-word, outline-none → outline-hidden, theme(colors.) → var(--color-*))
• Phase 6 — Port upstream component diffs (14 component files + 6 icon files)
• Phase 7 — Convert 30 SVGs to TSX:
  • Used a custom Node converter (/tmp/svg-convert/convert.mjs) that lifts inline <defs><style>.a{...}</style> rules onto elements, strips XML declarations, titles, descs, xlink/svgjs namespaces, then emits typed React components matching the InstallationIcon.tsx convention ((props: React.ComponentPropsWithoutRef<'svg'>) => <svg ...{...props}>).
  • Output: 30 *Icon.tsx files in src/components/icons/.
  • Naming collision: search.svg → SearchGlyphIcon.tsx to avoid clashing with the existing SearchIcon in Search.tsx.
  • Rewrote SvgIcon.jsx → SvgIcon.tsx with a typed IconName union; registry key 'search' still maps for docs {% icon name="search" /%}.
  • Deleted the 30 source .svg files (kept the unused ones for follow-up cleanup).
• Phase 8 — Simplify next.config.mjs (no webpack block, added nextjsExports: ['revalidate'])
• Phase 9 — React 19 / TypeScript polish (tsc --noEmit clean, ESLint clean, added one react-hooks/immutability disable in Search.tsx for the autocomplete self-reference inside navigate)
• Phase 10 — Smoke test:
  • npm run build → all 72 routes generated successfully
  • npm run dev → home (200, 110KB) and /start-guide/how-to-write-markdown-notes (200, 114KB) render
  • font-proxyma class present in HTML
  • Cog SVG path M10.546… rendered twice on a docs page (matches the two {% icon name="cog" /%} markdown calls)
• Phase 11 — Commit on chore/upstream-202604

Outcome

Completed. Notes:

• Deviation from upstream: Bumped next to 16.2.4 (upstream pinned 16.2.2) to clear a high-severity advisory.
• Open follow-up: 2 transitive vulnerabilities remain in next's nested postcss. The only suggested "fix" is downgrading next to 9.3.3 (absurd). Accepted as-is until a future Next patch ships.
• Open follow-up: ~50 unused .svg files remain in src/components/icons/. Out of scope for this PR; safe to delete in a follow-up cleanup PR.
• Open follow-up: Fence.tsx's require('prismjs/components/prism-bash') may be redundant since v2 of prism-react-renderer includes a base bundle. Did not verify; left untouched per "leave working code alone" principle.
• Did NOT push — branch chore/upstream-202604 is local. Open a PR when ready.

Files changed

.eslintrc.json                              D
eslint.config.mjs                           A
next.config.mjs                             M  (drop SVGR webpack, add nextjsExports)
package-lock.json                           M
package.json                                M
postcss.config.js                           M  (drop autoprefixer, use @tailwindcss/postcss)
prettier.config.js                          M  (add tailwindStylesheet)
src/app/not-found.tsx                       M
src/components/Button.tsx                   M
src/components/Callout.tsx                  M
src/components/DocsLayout.tsx               M
src/components/Hero.tsx                     M
src/components/Icon.tsx                     M
src/components/Layout.tsx                   M
src/components/MobileNavigation.tsx         M
src/components/Navigation.tsx               M
src/components/Prose.tsx                    M
src/components/QuickLinks.tsx               M
src/components/Search.tsx                   M
src/components/SnippetWindow.jsx            M
src/components/SvgIcon.jsx                  D
src/components/SvgIcon.tsx                  A
src/components/TableOfContents.tsx          M
src/components/ThemeSelector.tsx            M
src/components/ThumbLinks.jsx               M
src/components/icons/{Installation,Lightbulb,Plugins,Presets,Theming,Warning}Icon.tsx  M
src/components/icons/<30 new>Icon.tsx       A
src/components/icons/<30 used>.svg          D
src/styles/prism.css                        M
src/styles/tailwind.css                     M
tailwind.config.ts                          D
tsconfig.json                               M