Add TypeDoc for API documentation generation

[Hector Hernandez (hectorhdzg)]

• Add typedoc as a dev dependency
• Add typedoc.json config with src/index.ts as entry point
• Add 'npm run docs' script to generate HTML docs to docs/
• Add docs/ to .gitignore (generated output)
• Add docs generation step to PR validation CI (reuses existing quality job)

[Copilot]

Pull request overview

This PR introduces TypeDoc-based API documentation generation for the package, wiring it into local scripts and PR validation CI to ensure docs remain buildable from the public entrypoint.

Changes:

• Add typedoc as a dev dependency and a typedoc.json config targeting src/index.ts.
• Add npm run docs to generate HTML docs into docs/.
• Ignore generated docs/ output and run doc generation during PR validation.

Reviewed changes

Copilot reviewed 3 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
typedoc.json	Adds TypeDoc configuration (entrypoint src/index.ts, output docs/, excludes private/internal/external symbols).
package.json	Adds docs script and typedoc dev dependency.
package-lock.json	Locks TypeDoc and its transitive dependencies.
.gitignore	Ignores generated docs/ output.
.github/workflows/pr-validation.yml	Runs npm run docs as part of the existing quality job.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.