boardgameio / boardgame.io / 29204914796

100%

master: 100%

push

github

feat(packaging): add exports map and ESM server build (#1263)

boardgame.io predates Node's exports-map resolution: subpath imports
work only through generated proxy directories, which bundlers and the
CJS resolver understand but the Node ESM resolver does not. Any
"type": "module" project — the default for Vite-era tooling — fails
on import { Server } from 'boardgame.io/server' (#902, #1136, #1152),
and the docs still recommended the long-dead esm require hook (#844).

Changes:
- exports map covering the root, all 11 subpackages, ./server and
  ./package.json, with types/import/require conditions per entry.
  Legacy main/module/types fields and proxy dirs are kept for older
  resolvers, so existing consumers are unaffected.
- the server entry is now also built as ESM (its dependencies all
  ship ESM entry points or import cleanly from ESM).
- packages/main.js joins the dual-format build so the root export
  has format-correct files; dist/esm and dist/cjs gain package.json
  format markers, without which Node would parse them by the root
  package's implicit CJS type.
- integration test now smoke-tests Node ESM import and CJS require
  of the packed tarball, and runs publint (strict) plus
  arethetypeswrong (informational: attw crashes on this package's
  layout even for the published 0.50.2, so it cannot gate).
- docs no longer instruct users to install the esm shim.

Known caveat: a single .d.ts serves both import and require
conditions, so TS under nodenext treats the import types as
CJS-flavored. Benign for this API (named exports only); verified
with tsc against the packed tarball under both nodenext and bundler
resolution.

Closes #844. Fixes #1136.

1995 of 1995 branches covered (100.0%)

Branch coverage included in aggregate %.

2873 of 2873 relevant lines covered (100.0%)

26698.92 hits per line