Skip to content

fix: widen mode option type in ndarray/sub2ind to accept a single mode#12628

Draft
Planeshifter wants to merge 1 commit into
developfrom
philipp/fix-ndarray-sub2ind-mode-type
Draft

fix: widen mode option type in ndarray/sub2ind to accept a single mode#12628
Planeshifter wants to merge 1 commit into
developfrom
philipp/fix-ndarray-sub2ind-mode-type

Conversation

@Planeshifter
Copy link
Copy Markdown
Member

Description

What is the purpose of this pull request?

This pull request:

  • widens the mode option type in the @stdlib/ndarray/sub2ind declaration from Array<string> to Mode | Array<Mode>. The implementation accepts a single mode string (e.g. { 'mode': 'wrap' }), which the previous type rejected, and the element type should be the Mode union rather than a loose string (mirroring the sibling ind2sub package). Also adds the missing @throws options argument must be an object, fixes a much match -> must match typo, capitalizes the order option description, and adds a positive single-string mode test case.

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?

Found during a TypeScript-declaration audit of the ndarray namespace.

Checklist

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

These changes were identified by a Claude Code audit of the ndarray namespace's TypeScript declarations and applied with Claude Code assistance; the changes were reviewed by myself.


@stdlib-js/reviewers

… mode

The `mode` option was typed as `Array<string>`, but the implementation
also accepts a single mode string (e.g. `{ 'mode': 'wrap' }`), and the
element type should be the `Mode` union rather than a loose `string`.
Import `Mode` and type the option as `Mode | Array<Mode>`, mirroring the
sibling `ind2sub` package, and add a positive single-string test case.

Also corrects the accompanying declaration TSDoc: adds the missing
`@throws options argument must be an object` (thrown by the
implementation), fixes the `much match` -> `must match` typo, and
capitalizes the `order` option description for consistency with the
`mode` description.

---
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
---
@stdlib-bot
Copy link
Copy Markdown
Contributor

Coverage Report

Package Statements Branches Functions Lines
ndarray/sub2ind $\color{green}242/242$
$\color{green}+100.00\%$
$\color{green}30/30$
$\color{green}+100.00\%$
$\color{green}2/2$
$\color{green}+100.00\%$
$\color{green}242/242$
$\color{green}+100.00\%$

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants