Improve Customizer JSDoc - #10743

Open

westonruter wants to merge 33 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