clay / claycli / 35011276654

83%

master: 83%

Pull #263

github

🍕 Document the nodeGlobals / serverOnlyPackages config landed in #260

#260's console output (scanBareNodeGlobals's end-of-build summary) already
pointed readers at "CLAY-VITE.md § Node globals in browser bundles" -- that
section never actually existed. Adds it: the v5 insert-module-globals
history (so "why doesn't Vite just polyfill this" isn't re-litigated), the
no-blanket-polyfill policy, the bare-Buffer diagnostic, the nodeGlobals
contract and its two modes, the browser-native (btoa) exit path that
motivated this in the first place, and serverOnlyPackages as the more
general shape of the same leak.

Placed directly after "Kiln plugin PostCSS chain" under Section 8, matching
that section's own established depth and voice.

Docs only -- no .js file touched. npm test (lint + 456 tests) green.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

784 of 1040 branches covered (75.38%)

Branch coverage included in aggregate %.

1685 of 1934 relevant lines covered (87.13%)

10.75 hits per line