Improve Customizer JSDoc - #10743

Closed

westonruter wants to merge 48 commits into

WordPress:trunkfrom

westonruter:trac-40831

Commits on Jan 15, 2026

https://core.trac.wordpress.org/attachment/ticket/40831/40831.diff

committed
a603e94
Fix additional jsdoc

westonruter
and
gemini-code-assist[bot]
committed
a45b863
Further improve jsdoc

westonruter
and
gemini-code-assist[bot]
committed
9817e3f

Commits on Jan 16, 2026

Add blank line in jsdoc

westonruter
and
mukeshpanchal27
authored
a2396e2

Commits on Aug 28, 2026

Merge branch 'trunk' into trac-40831
westonruter
committed
9a5e1a7
Improve Customizer JSDoc and replace `arguments` with rest parameters.

westonruter
and
claude
committed
c633c29
Consume the `wp` argument passed into the Customizer IIFEs.

committed
5221d35
Replace the last use of `arguments` in `wp.customize.Class`.

westonruter
and
claude
committed
1835ade
Correct the direction described by `wp.customize.Value#link()`.

westonruter
and
claude
committed
162a1f1
Cover the variadic parts of the Customizer base classes.

westonruter
and
claude
committed
cef3122
Replace the `mixed` JSDoc type with `*` in the Customizer.

westonruter
and
claude
committed
55be81e

Commits on Aug 29, 2026

Use resolvable names for the Customizer JSDoc types.

westonruter
and
claude
committed
6ddae5a
Correct the types documented for the Customizer IIFE arguments.

westonruter
and
claude
committed
c7f407f
Fix further JSDoc defects in the Customizer.

westonruter
and
claude
committed
d512ff3
Drop the hyphen before Customizer JSDoc parameter descriptions.

westonruter
and
claude
committed
a5c5d5f
Document the arguments of three more Customizer functions.

westonruter
and
claude
committed
3d17619
Check both directions when unsyncing two values.

westonruter
and
claude
committed
d944c5c
Describe optional parameters and member types accurately in the Customizer.

westonruter
and
claude
committed
5ca507b
Mark the remaining optional Customizer parameters as optional.

westonruter
and
claude
committed
ab9eb85
Widen the type of the value passed to `wp.customize.Value#set()`.

westonruter
and
claude
committed
31e8243
Mark the callback optional for `wp.customize.control()` and `panel()`.

westonruter
and
claude
committed
1fa8f87
Spell the Customizer's generic object types consistently.

westonruter
and
claude
committed
11ffe58
Correct the return documented for `wp.customize.Loader.open()`.

westonruter
and
claude
committed
182301e
Describe what `wp.customize.Class` returns, and two Placement details.

westonruter
and
claude
committed
9b65262
Correct three Customizer types that misdescribe their values.

westonruter
and
claude
committed
a19d5df
Correct three more Customizer parameters in customize-base.js.

westonruter
and
claude
committed
32e8753

Commits on Aug 31, 2026

Document the arguments of the remaining Customizer functions.

committed
bc02b24
Name the WordPress global `wp` in customize-base.js.

committed
de984b7
Put the `@output` docblock first in customize-widgets.js.

westonruter
and
claude
committed
8645a76
Name the Underscore and jQuery promise types in the Customizer.

westonruter
and
claude
committed
ffa1007
Use the jQuery namespace as it is actually declared.

westonruter
and
claude
committed
1485310
Say what the Customizer's arrays contain.

westonruter
and
claude
committed
4f8350c
Merge branch 'trunk' into trac-40831
westonruter
authored
7106b2a

Commits on Sep 1, 2026

Tidy the Customizer docblocks after code review.

westonruter
and
claude
committed
63bb030
Require the nav menu arguments the partial constructor insists on.

westonruter
and
claude
committed
54c5826
Align the docblock lines that continue a description.

westonruter
and
claude
committed
5ceb336
Correct two parameter descriptions that describe the wrong thing.

westonruter
and
claude
committed
a95cec6
Finish the parameter descriptions that were left incomplete.

westonruter
and
claude
committed
49ddca4
Merge branch 'trunk' of https://github.com/WordPress/wordpress-develop into trac-40831
westonruter
committed
d1c9b66
Name the jQuery collection type so it resolves to a collection.

westonruter
and
claude
committed
cda7c0e
Type the partial refresh promises as the jQuery promises they are.

westonruter
and
claude
committed
384799f
Say what `this` actually is in the field toggle handler.

westonruter
and
claude
committed
e49b63e
Fix three structural tags that name or classify the wrong thing.

westonruter
and
claude
committed
51b1a2d
Name the selective refresh classes instead of inferring them.

westonruter
and
claude
committed
8279851

Commits on Sep 2, 2026

Finish the tag descriptions that trailed off mid-phrase.

westonruter
and
claude
committed
bb77c4b
Return the header image model, not a set of cropper options.

westonruter
and
claude
committed
d9f3663

Commits on Sep 3, 2026

Describe the parameters that were named but never explained.

westonruter
and
claude
committed
9576a7a
Correct three things the parameter tags got wrong.

westonruter
and
claude
committed
1287025