This pull request introduces improvements across workflow configuration, API documentation, and exception handling. The most significant changes include enhanced public API documentation for core types and exceptions, more robust and descriptive error classes, and updates to GitHub Actions workflows for better caching and triggering. These updates improve maintainability, developer experience, and the clarity of the public API.

API Documentation and Public Type Annotations

• Added @public JSDoc annotations to all major exception classes, result containers, and type definitions in src/Exception.ts, src/ImageResult.ts, src/InfoResult.ts, and src/PDFParse.ts, ensuring clear documentation and public visibility for consumers. (F9dc440bL3R3, [1] [2] [3]
• Updated docs/README.api.md to reflect new public annotations, improving the generated API reference for all exported classes and interfaces. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

Exception Handling Improvements

• Rewrote all exception classes in src/Exception.ts with detailed JSDoc comments, constructor documentation, and improved error messaging, making error handling more robust and developer-friendly. (F9dc440bL3R3, [1] [2] [3] [4] [5] [6]
• Enhanced the getException utility to normalize thrown values and preserve type information, improving error mapping and diagnostics.

GitHub Actions Workflow Updates

• Improved caching and dependency management in .github/workflows/test.yml, switching to lts/* Node.js, enabling npm caching, and optimizing install commands for faster and more reliable CI runs.
• Refined workflow triggers for test and deployment workflows to better match release and branch policies, and added explicit empty objects for workflow_dispatch where needed. [1] [2] [3] [4]

Tooling and Configuration

• Updated api-extractor.json to include forgotten exports and adjust report folder location, ensuring the API extractor outputs more complete documentation. [1] [2] [3]
• Added tsdoc-metadata.json association to .vscode/settings.json for improved editor support for JSONC files.

Minor Documentation and Typo Fixes

• Improved parameter documentation in PDFParse constructor for clarity and consistency.
• Fixed HTML entity encoding in JSDoc comments for types.

Let me know if you want to discuss any specific part of these changes in more detail!