npm / temporal-polyfill
temporal-polyfill
What changed in temporal-polyfill 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-24.
1 performance8 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli inittemporal-polyfill 19 changes
Performance 1
Tree-shakeable API imports are 27.30% smaller on average after minification and gzip.
Fixes and other changes 8
Disallowed duration units now produce a clearer error, naming the invalid unit and the allowed range.
Fixes a load-time ReferenceError under ESM loaders that wrap modules, such as OpenTelemetry's import-in-the-middle.
Preserves transitions at epoch nanoseconds 0n instead of returning null in both class-based and tree-shakeable APIs.
Sub-hour difference functions preserve fractional precision and return positive zero for results that round to zero.
Improves parity with class-based APIs for year, month, week, and day differences, including rounding, validation, precision, and range handling.
Tree-shakeable helpers now use correct non-ISO calendar boundaries instead of mixing calendar year/month values with ISO fields.
The /full entrypoint now defers to native Temporal.
The tree-shakeable API is now CJS-friendly for require(esm).