Versioning and support
#Versions
All packages follow semantic versioning. Releases and changelogs are managed with changesets, and every release is listed in each package's CHANGELOG.md.
While the version is 0.x:
- A minor release (
0.1→0.2) may contain breaking changes. Each one is listed under its changelog entry with migration steps. - A patch release (
0.1.0→0.1.1) only contains fixes and additions.
Pin a minor range (~0.1.0 or ^0.1.0, which npm treats the same way below 1.0) and read the changelog before upgrading. 1.0 will mark the API below as stable.
Upgrade @inflector/keeno, @inflector/keeno-compiler and @inflector/vite-plugin-keeno together. Compiled components call helpers from @inflector/keeno/internal, and the compiler and the runtime are released in lockstep.
#Public API
Public, and covered by semver:
- Everything exported from
@inflector/keeno(see the API reference),@inflector/keeno/serverand@inflector/keeno-router. - The
.knfile format and the template and script rules in these docs. - The options of
@inflector/vite-plugin-keeno, thekeeno-checkCLI, andcompile()from@inflector/keeno-compiler.
Not public: @inflector/keeno/internal, the shape of the compiler's output, class names starting with keeno-, and anything marked @internal. These can change in any release.
#Supported environments
| Supported | |
|---|---|
| Browsers | Last 2 versions of Chrome, Edge, Firefox and Safari (the end-to-end tests run in Chromium, Firefox and WebKit) |
| Node.js | 18 and later for the compiler, Vite plugin, keeno-check and server rendering (CI tests Node 20 and 22) |
| Bun | 1.4 and later |
| Vite | 5, 6, 7 and 8 (CI builds a test app with each) |
| TypeScript | 5.0 and later |
| Editors | VS Code 1.90 and later, and editors based on it (Cursor) |