docs: propagate fixes from develop (2026-06-25)#13133
Draft
Planeshifter wants to merge 3 commits into
Draft
Conversation
…ations Propagates fix from 1977f92 ("docs: update documented default value for `submode` option") and 3db7157 ("docs: update documented `submode` option default") to TypeScript declaration files in `ndarray/*` packages where JSDoc still annotated the `submode` default as `['throw']`. The runtime default is `[options.mode]` per `ndarray/ctor/lib/main.js`.
Propagates fix from d9e748f ("chore: fix EditorConfig lint errors") to sibling `math/base/special/*` packages whose `manifest.json` files contained a `dependencies` array entry indented with 7 leading spaces while sibling entries use 8.
Drops the `submode` JSDoc default propagation in `ndarray/fancy/docs/types/index.d.ts`. The file's pre-existing `@example` blocks reference an undeclared `FancyArray` symbol, which fails the `stdlib/tsdoc-declarations-doctest` rule whenever the file enters CI's changed-files set. The pre-existing failure is unrelated to the propagation pattern; the JSDoc default in this file remains at `['throw']` for now and should be fixed alongside the `FancyArray` example resolution.
Contributor
Coverage Report
The above coverage report was generated for the changes in this PR. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Propagating fixes merged to
developbetween 2026-06-24 23:26 PDT and 2026-06-25 03:24 PDT to sibling packages.docs:
submodedefault valuePropagates the JSDoc correction from commits
1977f92and3db7157: thesubmodeoption default was documented as['throw']but the runtime sets it to[options.mode]. Updated TypeScript declaration files to match.Affected packages:
@stdlib/ndarray/array@stdlib/ndarray/ctor@stdlib/ndarray@stdlib/ndarray/ndarraylike2ndarraychore:
manifest.jsonindentationPropagates the fix from
d9e748f(PR #13115), which corrected 7-space-indenteddependenciesentries inceil10/manifest.jsonthat should use 8 spaces to match the surrounding array. The same off-by-one defect appears in 11 sites across 6 sibling packages.Affected packages:
@stdlib/math/base/special/floor10@stdlib/math/base/special/truncsd@stdlib/math/base/special/ceilsd@stdlib/math/base/special/digamma@stdlib/math/base/special/besselj1@stdlib/math/base/special/cschRelated Issues
None.
Questions
No.
Other
Validation. Each target file was read in full by two independent validation passes to confirm the defect is present and surrounding context does not change the semantics. A style-consistency pass confirmed each proposed patch matches the surrounding package's JSDoc / JSON style. Search scope:
lib/node_modules/@stdlib/**/*.d.tsfor thesubmodedefault andlib/node_modules/@stdlib/**/manifest.jsonfor the indent defect.Deliberately excluded.
fix:candidate in the 24h window (92b5eb47— error-message argument interpolation inndarray/matrix/ctor/lib/main.js) had no remaining sibling sites: a sweep across allndarray/**/main.jsfiles confirmed every<ordinal> argumentvalidation block matches itsargNreference.e6cc42btypo / C-example fix had no remaining propagation sites either: bareNaNas a C literal no longer appears in C code blocks or@examplefunction-call arguments across the repo.build:workflow fix (7b03f88) targeted a single workflow with a uniquegh api DELETE + force-with-lease pushpattern; no other workflow uses that pattern.Bot-generated docs (related-packages regen, namespace TOC, type-decl regen) were not considered since they re-emit on the next bot run.
Dropped after CI signal. The
@stdlib/ndarray/fancysite was initially included but dropped (commit9fb0955) — the file's pre-existing@exampleblocks reference an undeclaredFancyArraysymbol, which failsstdlib/tsdoc-declarations-doctestwhenever the file enters CI's changed-files set. The doctest failure is unrelated to the propagation; thesubmodedefault in that file remains at['throw']until theFancyArrayexample issue is resolved separately.Checklist
AI Assistance
If you answered "yes" above, how did you use AI assistance?
Disclosure
This PR was authored by Claude Code running the fix-propagation routine, which scans recent
developcommits, identifies propagatable defect patterns, validates candidate target sites through independent agents, and applies mechanical fixes. Each propagation site was verified to contain the same defect as the source commit's fix.@stdlib-js/reviewers