Skip to content

Commit 02bc1d4

Browse files
authored
docs: clarify Linaria 7 requirements (#1467)
1 parent 39c2efd commit 02bc1d4

File tree

2 files changed

+2
-0
lines changed

2 files changed

+2
-0
lines changed

.changeset/bump-wyw-1-0-x.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ This release updates Linaria's build-time evaluation engine (WyW). See https://w
1717

1818
Notes:
1919

20+
- Linaria 7 requires Node.js 20+ (aligned with WyW 1.x).
2021
- If you import JSON from code that is evaluated by WyW, add `.json` to `extensions` and ensure `.json` is ignored by evaluation rules (so it's parsed as JSON, not by Babel).
2122
- Rollup users: WyW 1.x serializes `transform()` by default (`serializeTransform: true`). If you hit Rollup "Unexpected early exit" (unresolved plugin promises / deadlock during resolve), set `serializeTransform: false` (see `examples/rollup/rollup.config.mjs`).
2223
- WyW 1.x promotes fully-statically-evaluatable modules to `only: ['*']` and can re-evaluate modules when cached exports are incomplete (cached export values might not be reused).

docs/MIGRATION_GUIDE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@
77
Linaria 7 updates the WyW toolchain (`@wyw-in-js/*`) to `^1.0.0` (stable). This affects build-time evaluation (CSS extraction) and can surface previously hidden issues in evaluated modules.
88

99
- Review https://wyw-in-js.dev/stability for the evaluation model, common pitfalls, and performance guidance.
10+
- Linaria 7 requires Node.js 20+ (aligned with WyW 1.x).
1011
- If you rely on WyW cache internals, note that WyW 1.x can promote fully-statically-evaluatable modules to `only: ['*']` and may re-evaluate modules when cached exports are incomplete.
1112
- If you import JSON from code that is evaluated by WyW, add `.json` to `extensions` and ensure `.json` is ignored by evaluation rules (so it's parsed as JSON, not by Babel).
1213
- Rollup users on WyW 1.0.6: WyW serializes `transform()` by default; if you hit Rollup "Unexpected early exit" (unresolved plugin promises), try `serializeTransform: false` in the WyW Rollup plugin config.

0 commit comments

Comments
 (0)