Next upgrade plan

Goal

Upgrade apps/www to the latest stable Next release using the official Next/Vercel upgrade path, then fix any repo-local fallout and verify the app still passes the required checks.

Relevant learnings

• apps/www has custom Next dev aliasing and TS path behavior for workspace packages; do not casually rewrite those configs.
• next-env.d.ts is generated and may differ between dev and prod typegen paths.
• Template sync/check flows already have TS6-era config carve-outs; avoid regressing those while upgrading the app.

Steps

1. Confirm latest stable Next version and official upgrade guidance.
2. Inspect all Next-dependent files in apps/www.
3. Apply the upgrade with the official path.
4. Fix any generated/config/API fallout.
5. Verify with build-first typecheck sequence plus lint.

Notes

• User asked to use “next mcp”; using official Vercel/Next docs plus the repo-local app/package state.
• Latest stable resolved to [email protected].
• The official upgrader also bumped react and react-dom in apps/www from 19.2.3 to 19.2.4.
• pnpm -C apps/www exec next upgrade . --revision latest --verbose updated manifests and the lockfile, but its internal pnpm install failed on the repo's existing root prepare script (bun x skiller@latest apply -> invalid claude agent config). I finished install sync with pnpm install --ignore-scripts.
• Root cause for that prepare failure was stale skiller config in .claude/skiller.toml: skiller now requires canonical agent ids, so claude had to become claude-code in both default_agents and [agents.<id>].
• .claude/.skiller.json still uses sourceType: "claude" for project-managed items after a successful apply. That field is generated metadata, not the validated config surface.
• The upgrade exposed a latent SSR issue in @platejs/dnd: pages that prerender client editor demos (/cn, /dev, /blocks/editor-ai) crashed with Invariant Violation: Expected drag drop context.
• Root cause was not missing providers in apps/www; react-dnd hooks were still being called during server prerender. The fix is package-level: @platejs/dnd now returns inert drag/drop connectors when DOM DnD is unavailable.
• The homepage hydration mismatch came from static demo values generating random node IDs plus unstable createdAt metadata across server and client.
• The first fix lived in apps/www, but the user wants that normalization moved into the package layer.
• Keep normalizeNodeId focused on IDs. Export a separate helper from @platejs/core for hydration-safe static demo normalization.

Outcome

• Upgraded apps/www to [email protected] and @next/[email protected].
• Kept the fix in packages/dnd so app routes do not need dynamic(..., { ssr: false }) wrappers just to survive prerender.
• Static demo normalization is being moved from apps/www into @platejs/core so docs/demo consumers can use a package API instead of app-local glue.
• Restored the root prepare path by updating .claude/skiller.toml from claude to claude-code and rerunning bun x skiller@latest apply.

Verification

• bun test packages/dnd/src/components/useDraggable.spec.tsx
• pnpm --filter @platejs/dnd build
• pnpm --filter @platejs/dnd typecheck
• pnpm -C apps/www build
• pnpm -C apps/www typecheck
• pnpm lint:fix
• bun x skiller@latest apply