docs: add descriptive JSDoc comments to core terminal layout utilities

[Rish-2006]

closes #730

Summary by CodeRabbit

• Documentation
  • Enhanced internal documentation for ANSI utilities.

No user-facing changes in this release.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9469f399-8555-476a-8cbe-549ecff0e254

📥 Commits

Reviewing files that changed from the base of the PR and between f90f75c and 47a8476.

📒 Files selected for processing (1)

• packages/core/src/utils/ansi.ts

---

📝 Walkthrough

Walkthrough

This PR adds a module-level documentation comment to packages/core/src/utils/ansi.ts that describes the file's ANSI escape sequence utilities for layout formatting, terminal bell, and notification configuration. No functional code or exported signatures are changed.

Changes

ANSI module documentation

Layer / File(s)	Summary
Module documentation header packages/core/src/utils/ansi.ts	New JSDoc-style module comment inserted at the top of the file describing ANSI escape sequence utilities; file closing brace line adjusted to account for the header insertion.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related issues

• #730: Documentation update to core terminal utility code; both PRs improve inline documentation for ANSI and layout utilities.

Poem

🐰 A comment's grace adorns the code so fine,
ANSI sequences now shine with a helpful line,
The rabbit hops with joy—docs clear and bright,
Each escape sequence known from left to right! ✨

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The PR description is incomplete and largely off-topic. It contains only a single issue reference without following the required template structure, missing sections like Description, Type of Change, and Checklist.	Fill out the complete description template with: a brief Description (1-3 sentences), Type of Change checkbox selection, Related Issue link, Which package(s) section, and the required Checklist items.
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The PR title accurately describes the main change: adding JSDoc comments to the ansi.ts utility module for terminal layout utilities.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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

[Karanjot786]

Thank you so much for your contribution, @Rish-2006!

Your PR #731 added JSDoc comments to the core terminal layout utilities. Every contributor reading that code now has clear inline documentation to work from.

Keep contributing. We appreciate your work.