Skip to content

docs: update TypeScript documentation and fix whitespace in nlp/lda declarations#12730

Merged
kgryte merged 1 commit into
developfrom
philipp/nlp-lda-dts-docs-fixes
Jun 10, 2026
Merged

docs: update TypeScript documentation and fix whitespace in nlp/lda declarations#12730
kgryte merged 1 commit into
developfrom
philipp/nlp-lda-dts-docs-fixes

Conversation

@Planeshifter

Copy link
Copy Markdown
Member

Description

What is the purpose of this pull request?

This pull request fixes TSDoc completeness and a whitespace inconsistency in the @stdlib/nlp/lda TypeScript declaration file (docs/types/index.d.ts). The changes are documentation-only and do not affect type-checking or runtime behavior:

  • Adds the missing @throws first argument must be an array of strings tag, which the implementation (lib/main.js) documents and throws at runtime but the declaration omitted.
  • Documents the alpha/beta defaults (50/K and 0.1) on their @param lines, matching the Options interface, the implementation, and the file's own convention (e.g. the getTerms no param already states (default: 10)).
  • Removes a stray double space after the asterisk in the Options.beta description.

Related Issues

Does this pull request have any related issues?

No.

Questions

Any questions for reviewers of this pull request?

No.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

No.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

AI Assistance

When authoring the changes proposed in this PR, did you use any kind of AI assistance?

  • Yes
  • No

If you answered "yes" above, how did you use AI assistance?

  • Code generation (e.g., when writing an implementation or fixing a bug)
  • Test/benchmark generation
  • Documentation (including examples)
  • Research and understanding

Disclosure

If you answered "yes" to using AI assistance, please provide a short disclosure indicating how you used AI assistance.

The declaration issues were surfaced by a Claude Code TypeScript-declarations audit and verified against the implementation; the fixes were reviewed and applied with Claude Code.


@stdlib-js/reviewers

Add the missing `@throws first argument must be an array of strings` tag,
document the `alpha`/`beta` defaults on their `@param` lines, and remove a
stray double space after the asterisk in the `Options.beta` description.

These bring the declaration TSDoc in line with the implementation
(lib/main.js) and the file's own conventions.

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown_pkg_readmes
    status: na
  - task: lint_markdown_docs
    status: na
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: passed
  - task: lint_license_headers
    status: passed
---
@Planeshifter Planeshifter marked this pull request as ready for review June 9, 2026 05:19
@Planeshifter Planeshifter requested review from a team and kgryte June 9, 2026 05:19
@stdlib-bot stdlib-bot added the Needs Review A pull request which needs code review. label Jun 9, 2026
@stdlib-bot

Copy link
Copy Markdown
Contributor

Coverage Report

Package Statements Branches Functions Lines
nlp/lda $\color{red}464/858$
$\color{green}+54.08\%$
$\color{green}18/18$
$\color{green}+100.00\%$
$\color{red}1/11$
$\color{green}+9.09\%$
$\color{red}464/858$
$\color{green}+54.08\%$

The above coverage report was generated for the changes in this PR.

@kgryte kgryte added Documentation Improvements, additions, or changes to documentation. and removed Needs Review A pull request which needs code review. labels Jun 10, 2026
@kgryte kgryte changed the title docs: fix TSDoc completeness and whitespace in nlp/lda declarations docs: update TypeScript documentation and fix whitespace in nlp/lda declarations Jun 10, 2026
@kgryte kgryte merged commit dd5048f into develop Jun 10, 2026
54 checks passed
@kgryte kgryte deleted the philipp/nlp-lda-dts-docs-fixes branch June 10, 2026 02:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements, additions, or changes to documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants