docs(VitePress): 📝 Add VitePress documentation

[haskou]

Summary

• Add the VitePress documentation site structure and GitHub Pages workflow.
• Fix reference overview links so VitePress no longer reports dead links during production builds.
• Make yarn docs:preview build the site before serving it, so preview works from a clean checkout without an existing docs/.vitepress/dist directory.

Root Cause

vitepress build docs failed because reference pages linked to /reference while the generated index route is /reference/. vitepress preview docs also expected a built output directory to already exist, so it failed when run before a docs build.

Validation

• yarn docs:build
• yarn docs:preview starts successfully at http://localhost:4173/value-objects/ after cleaning generated VitePress output.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[haskou]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. 👍

Reviewed commit: a8c6f56f2e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".