chore: remove unnecessary @public annotations and guidelines

[serhalp]

🔗 Linked issue

N/A - cleanup

🧭 Context

Previously, knip didn't understand nuxt auto-imports, so we used @public jsdoc annotations as some sort of funny workaround

knip supports this now; so this is an outdated guideline

📚 Description

• Remove guideline about this
• Clean up some remaining uses of this pattern

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
npmx.dev	Ready	Preview, Comment	Feb 23, 2026 3:50am

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ignored		Feb 23, 2026 3:50am
npmx-lunaria	Ignored		Feb 23, 2026 3:50am

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

---

📝 Walkthrough

Walkthrough

This PR removes @public JSDoc annotations from numerous exported functions, types, and constants across the codebase, and deletes documentation instructions about annotating auto-imported exports with @public. The function signatures, type declarations, and runtime behaviour remain unchanged; only documentation metadata is affected.

Possibly related PRs

• chore: minor cleanups #1286: Modifies app/composables/useActiveTocItem.ts where the main PR removes the @public JSDoc tag
• chore: clean up deps & add comments to knip #849: Relates to knip configuration changes that address the @public annotation guidance being removed from CONTRIBUTING.md

Suggested reviewers

• danielroe

🚥 Pre-merge checks | ✅ 1

✅ Passed checks (1 passed)

Check name	Status	Explanation
Description check	✅ Passed	The pull request description clearly explains the purpose of removing @public annotations and the rationale—knip now supports Nuxt auto-imports, making the workaround outdated.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch chore/remove-public-jsdoc

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}