docs: fix TSDoc errors in @stdlib/assert declarations

[Planeshifter]

Description

What is the purpose of this pull request?

This pull request corrects documentation-only defects (TSDoc comments only; no type or runtime changes) across @stdlib/assert ambient declaration files:

• Fixes copy-pasted/wrong @returns and summary prose: is-symbol-array ("array of strings" -> symbols), is-probability-array ("positive integer" -> probabilities), is-undefined-or-null (omitted "or null"), is-nonpositive-number-array ("integer" -> "number"), and is-nonpositive-finite (missing "finite").
• Fixes incorrect @example annotations: is-positive-finite (Infinity marked "returns true"), is-iterable-like (placeholder // returns <boolean>), and is-nan-array (missing // returns).
• In is-bigint and is-symbol, demonstrates the main function in the top-level @example blocks (previously only sub-methods were shown) while retaining .isPrimitive/.isObject examples, and removes a duplicated @example block.
• Repairs HasFunction summaries/examples in deep-has-own-property and deep-has-property to describe the returned one-argument tester.
• Miscellaneous: strips JSDoc-style {*}/{boolean} tags in is-nonnegative-finite, converts backtick example strings to single quotes in is-kebabcase, gives continuation examples their own @example tags in is-startcase, adds the missing ## Notes block in is-same-typed-array-like, and removes stray/double whitespace.

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?

Identified via a TypeScript-declaration audit of the @stdlib/assert namespace. Non-documentation (type/signature) fixes are submitted as separate pull requests. The auto-generated namespace aggregator declaration (docs/types/index.d.ts) is intentionally left untouched.

Checklist

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

• Read, understood, and followed the contributing guidelines.

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

This PR was authored primarily by Claude Code (Anthropic's CLI), which audited the @stdlib/assert TypeScript declarations and proposed and applied the documentation fixes. I reviewed the changes.

---

@stdlib-js/reviewers

[stdlib-bot]

Coverage Report

Package	Statements	Branches	Functions	Lines
assert/contains	$\color{green}155/155$ $\color{green}+0.00\%$	$\color{green}18/18$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}155/155$ $\color{green}+0.00\%$
assert/deep-has-own-property	$\color{green}438/438$ $\color{green}+0.00\%$	$\color{green}47/47$ $\color{green}+0.00\%$	$\color{green}6/6$ $\color{green}+0.00\%$	$\color{green}438/438$ $\color{green}+0.00\%$
assert/deep-has-property	$\color{green}454/454$ $\color{green}+0.00\%$	$\color{green}47/47$ $\color{green}+0.00\%$	$\color{green}6/6$ $\color{green}+0.00\%$	$\color{green}454/454$ $\color{green}+0.00\%$
assert/is-bigint	$\color{green}327/327$ $\color{green}+0.00\%$	$\color{green}17/17$ $\color{green}+0.00\%$	$\color{green}4/4$ $\color{green}+0.00\%$	$\color{green}327/327$ $\color{green}+0.00\%$
assert/is-boolean-array	$\color{green}78/78$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}0/0$ $\color{green}+0.00\%$	$\color{green}78/78$ $\color{green}+0.00\%$
assert/is-integer-array	$\color{green}82/82$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}0/0$ $\color{green}+0.00\%$	$\color{green}82/82$ $\color{green}+0.00\%$
assert/is-iterable-like	$\color{green}120/120$ $\color{green}+0.00\%$	$\color{green}8/8$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}120/120$ $\color{green}+0.00\%$
assert/is-kebabcase	$\color{green}101/101$ $\color{green}+0.00\%$	$\color{green}4/4$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}101/101$ $\color{green}+0.00\%$
assert/is-leap-year	$\color{green}131/131$ $\color{green}+0.00\%$	$\color{green}12/12$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}131/131$ $\color{green}+0.00\%$
assert/is-nan-array	$\color{green}73/73$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}0/0$ $\color{green}+0.00\%$	$\color{green}73/73$ $\color{green}+0.00\%$
assert/is-nonnegative-finite	$\color{green}273/273$ $\color{green}+0.00\%$	$\color{green}10/10$ $\color{green}+0.00\%$	$\color{green}3/3$ $\color{green}+0.00\%$	$\color{green}273/273$ $\color{green}+0.00\%$
assert/is-nonpositive-finite	$\color{green}213/213$ $\color{green}+0.00\%$	$\color{green}12/12$ $\color{green}+0.00\%$	$\color{green}3/3$ $\color{green}+0.00\%$	$\color{green}213/213$ $\color{green}+0.00\%$
assert/is-nonpositive-number-array	$\color{green}76/76$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}0/0$ $\color{green}+0.00\%$	$\color{green}76/76$ $\color{green}+0.00\%$
assert/is-number-array	$\color{green}76/76$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}0/0$ $\color{green}+0.00\%$	$\color{green}76/76$ $\color{green}+0.00\%$
assert/is-positive-finite	$\color{green}263/263$ $\color{green}+0.00\%$	$\color{green}12/12$ $\color{green}+0.00\%$	$\color{green}3/3$ $\color{green}+0.00\%$	$\color{green}263/263$ $\color{green}+0.00\%$
assert/is-probability-array	$\color{green}79/79$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}0/0$ $\color{green}+0.00\%$	$\color{green}79/79$ $\color{green}+0.00\%$
assert/is-readable-property	$\color{green}130/130$ $\color{green}+0.00\%$	$\color{green}5/5$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}130/130$ $\color{green}+0.00\%$
assert/is-same-typed-array-like	$\color{green}119/119$ $\color{green}+0.00\%$	$\color{green}5/5$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}119/119$ $\color{green}+0.00\%$
assert/is-startcase	$\color{green}95/95$ $\color{green}+0.00\%$	$\color{green}4/4$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}95/95$ $\color{green}+0.00\%$
assert/is-symbol-array	$\color{green}76/76$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}0/0$ $\color{green}+0.00\%$	$\color{green}76/76$ $\color{green}+0.00\%$
assert/is-symbol	$\color{green}384/384$ $\color{green}+0.00\%$	$\color{green}20/20$ $\color{green}+0.00\%$	$\color{green}5/5$ $\color{green}+0.00\%$	$\color{green}384/384$ $\color{green}+0.00\%$
assert/is-undefined-or-null	$\color{green}96/96$ $\color{green}+0.00\%$	$\color{green}4/4$ $\color{green}+0.00\%$	$\color{green}1/1$ $\color{green}+0.00\%$	$\color{green}96/96$ $\color{green}+0.00\%$

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