@kumbatio/energy-system 2.2.0 → 2.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +35 -26
- package/README.md +4 -1
- package/api-surface.json +1 -1
- package/conformance.json +1 -1
- package/package.json +46 -26
package/CHANGELOG.md
CHANGED
|
@@ -14,6 +14,19 @@ all. Prose returned by `describe()` is not covered; wording is a product decisio
|
|
|
14
14
|
|
|
15
15
|
## [Unreleased]
|
|
16
16
|
|
|
17
|
+
## [2.2.1] - 2026-10-20
|
|
18
|
+
|
|
19
|
+
### Changed
|
|
20
|
+
|
|
21
|
+
- The React and `@types/react` peer floor is `>=19.2.0` again (previously `>=19.3.1`). React 19.2 added `<Activity>`, the only 19.2+ API the React entry imports, and the higher floor made `npm install` fail with `ERESOLVE` in any app not on the newest React patch.
|
|
22
|
+
- Node.js 22 or later is now the `engines` floor (previously `>=24.21.0`). The published JavaScript runs on Node 22; 24.21 is only needed to develop the package, where the source runs on native type stripping.
|
|
23
|
+
- `package.json` now carries `repository`, `bugs`, `homepage` and `keywords`, so the npm page links to the source and the issue tracker.
|
|
24
|
+
|
|
25
|
+
### Fixed
|
|
26
|
+
|
|
27
|
+
- The 2.1.4 changelog section contained a pasted drafting note instead of release notes. It now lists the two tooling changes that release covered.
|
|
28
|
+
- The Meltemi link in the README points to meltemi.email; meltemi.app no longer serves the site.
|
|
29
|
+
|
|
17
30
|
## [2.2.0] - 2026-10-19
|
|
18
31
|
|
|
19
32
|
### Changed
|
|
@@ -22,14 +35,9 @@ all. Prose returned by `describe()` is not covered; wording is a product decisio
|
|
|
22
35
|
|
|
23
36
|
## [2.1.4] - 2026-09-28
|
|
24
37
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
Most of the commits you listed are already out. The repo has a `v2.1.3` tag (2c412b8), cut after v2.1.2. Every fix, spec change and docs change in your list (e69a145, 53a9f6f, a9078d4, eda186a, aece94f, 7517d79, 21fb98b, and the `.ts` specifier change) is under `## [2.1.3] - 2026-09-28` in `CHANGELOG.md`. Putting them in 2.1.4 would announce them twice.
|
|
28
|
-
|
|
29
|
-
Only two commits come after v2.1.3, and both are dev-tooling chores that your rules say to leave out:
|
|
38
|
+
### Changed
|
|
30
39
|
|
|
31
|
-
-
|
|
32
|
-
- **645086a:** updates release-kit (dev dependency) to `^2.11.0`, and refreshes pnpm and the TypeScript nightly in the lockfile.
|
|
40
|
+
- Development tooling only; nothing user-visible changed. The pinned pnpm package manager was updated ([dcf6b0d](https://github.com/kumbatio/energy-system/commit/dcf6b0d)), and release-kit moved to `^2.11.0` with pnpm and the TypeScript nightly re-resolved in the lockfile ([645086a](https://github.com/kumbatio/energy-system/commit/645086a)).
|
|
33
41
|
|
|
34
42
|
## [2.1.3] - 2026-09-28
|
|
35
43
|
|
|
@@ -275,22 +283,23 @@ strategies, the DOM adapter, the React provider and hooks, persistence adapters
|
|
|
275
283
|
with external observation, deterministic clocks, derived metrics, and legacy
|
|
276
284
|
level compatibility mapping.
|
|
277
285
|
|
|
278
|
-
[Unreleased]: https://github.com/kumbatio/energy-system/compare
|
|
279
|
-
[2.2.
|
|
280
|
-
[2.
|
|
281
|
-
[2.1.
|
|
282
|
-
[2.1.
|
|
283
|
-
[2.1.
|
|
284
|
-
[2.1.
|
|
285
|
-
[2.0
|
|
286
|
-
[2.0.
|
|
287
|
-
[2.0.
|
|
288
|
-
[2.0.
|
|
289
|
-
[2.0.
|
|
290
|
-
[2.0.
|
|
291
|
-
[2.0.
|
|
292
|
-
[
|
|
293
|
-
[0.
|
|
294
|
-
[0.
|
|
295
|
-
[0.4
|
|
296
|
-
[0.
|
|
286
|
+
[Unreleased]: https://github.com/kumbatio/energy-system/compare/v2.2.1...HEAD
|
|
287
|
+
[2.2.1]: https://github.com/kumbatio/energy-system/compare/v2.2.0...v2.2.1
|
|
288
|
+
[2.2.0]: https://github.com/kumbatio/energy-system/compare/v2.1.4...v2.2.0
|
|
289
|
+
[2.1.4]: https://github.com/kumbatio/energy-system/compare/v2.1.3...v2.1.4
|
|
290
|
+
[2.1.3]: https://github.com/kumbatio/energy-system/compare/v2.1.2...v2.1.3
|
|
291
|
+
[2.1.2]: https://github.com/kumbatio/energy-system/compare/v2.1.1...v2.1.2
|
|
292
|
+
[2.1.1]: https://github.com/kumbatio/energy-system/compare/v2.1.0...v2.1.1
|
|
293
|
+
[2.1.0]: https://github.com/kumbatio/energy-system/compare/v2.0.6...v2.1.0
|
|
294
|
+
[2.0.6]: https://github.com/kumbatio/energy-system/compare/v2.0.5...v2.0.6
|
|
295
|
+
[2.0.5]: https://github.com/kumbatio/energy-system/compare/v2.0.4...v2.0.5
|
|
296
|
+
[2.0.4]: https://github.com/kumbatio/energy-system/compare/v2.0.3...v2.0.4
|
|
297
|
+
[2.0.3]: https://github.com/kumbatio/energy-system/compare/v2.0.2...v2.0.3
|
|
298
|
+
[2.0.2]: https://github.com/kumbatio/energy-system/compare/v2.0.1...v2.0.2
|
|
299
|
+
[2.0.1]: https://github.com/kumbatio/energy-system/compare/v2.0.0...v2.0.1
|
|
300
|
+
[2.0.0]: https://github.com/kumbatio/energy-system/compare/v1.0.0...v2.0.0
|
|
301
|
+
[1.0.0]: https://github.com/kumbatio/energy-system/compare/v0.6.0...v1.0.0
|
|
302
|
+
[0.6.0]: https://github.com/kumbatio/energy-system/compare/v0.5.4...v0.6.0
|
|
303
|
+
[0.5.4]: https://github.com/kumbatio/energy-system/compare/v0.4.0...v0.5.4
|
|
304
|
+
[0.4.0]: https://github.com/kumbatio/energy-system/compare/v0.1.0...v0.4.0
|
|
305
|
+
[0.1.0]: https://github.com/kumbatio/energy-system/releases/tag/v0.1.0
|
package/README.md
CHANGED
|
@@ -616,6 +616,9 @@ that means more than the type signatures:
|
|
|
616
616
|
|
|
617
617
|
## Development
|
|
618
618
|
|
|
619
|
+
The source runs on Node's native type stripping, so developing the package needs Node 24.21 or
|
|
620
|
+
later. The published JavaScript runs on Node 22 or later.
|
|
621
|
+
|
|
619
622
|
```bash
|
|
620
623
|
pnpm run validate # format, lint, types, tests, packaging - what CI runs
|
|
621
624
|
```
|
|
@@ -643,7 +646,7 @@ adapters (e.g., SQLite-backed desktop stores) should live in consuming apps.
|
|
|
643
646
|
## Who uses this
|
|
644
647
|
|
|
645
648
|
- **[Anasa](https://anasa.md)** - Kumbatio's local-first writing and thinking workspace, in public alpha. Runs its entire adaptive shell on the engine: custom settings-backed persistence, energy-gated AI surfaces, notification filtering, and task-complexity guidance.
|
|
646
|
-
- **[Meltemi](https://meltemi.
|
|
649
|
+
- **[Meltemi](https://meltemi.email)** - an email client in private beta from [entro314 labs](https://github.com/entro314-labs) (the studio behind Kumbatio), built outside the Kumbatio product line. Uses the notification gate (defer, never drop), focus sessions, deferral ordering, interaction forgiveness, and demand admission - integrated without the React adapter. Its demand binding is the reference one: originator tiers come from its VIP list, obligation is classified from RFC 3834 header evidence and its own sender lanes, acknowledgments go out as `Auto-Submitted: auto-replied` auto-replies, and the capture is a snooze to the horizon `deferralStrategy` picked.
|
|
647
650
|
- **[kumbat.io](https://kumbat.io)** - the site itself runs on this model; change the energy level there and watch the interface adapt.
|
|
648
651
|
|
|
649
652
|
The integration patterns these apps proved out are documented in the [Production Patterns guide](https://docs.kumbat.io/docs/energy-system/guides/production-patterns). If you ship something with `energy-system`, tell us: [hello@kumbat.io](mailto:hello@kumbat.io).
|
package/api-surface.json
CHANGED
package/conformance.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "./spec/conformance.schema.json",
|
|
3
|
-
"version": "2.2.
|
|
3
|
+
"version": "2.2.1",
|
|
4
4
|
"timezone": "UTC",
|
|
5
5
|
"note": "Generated from the built library by scripts/extract-conformance.ts. See SPEC.md for the normative rules these vectors encode, including the runtime invariants that no vector can express.",
|
|
6
6
|
"levels": [
|
package/package.json
CHANGED
|
@@ -1,9 +1,31 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kumbatio/energy-system",
|
|
3
|
-
"version": "2.2.
|
|
3
|
+
"version": "2.2.1",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Framework-agnostic TypeScript library for energy-aware application behavior.",
|
|
6
|
+
"keywords": [
|
|
7
|
+
"accessibility",
|
|
8
|
+
"adaptive-ui",
|
|
9
|
+
"adhd",
|
|
10
|
+
"capacity",
|
|
11
|
+
"cognitive-load",
|
|
12
|
+
"energy",
|
|
13
|
+
"focus",
|
|
14
|
+
"neurodivergent",
|
|
15
|
+
"notifications",
|
|
16
|
+
"react",
|
|
17
|
+
"state",
|
|
18
|
+
"typescript"
|
|
19
|
+
],
|
|
20
|
+
"homepage": "https://docs.kumbat.io/docs/energy-system",
|
|
21
|
+
"bugs": {
|
|
22
|
+
"url": "https://github.com/kumbatio/energy-system/issues"
|
|
23
|
+
},
|
|
6
24
|
"license": "MIT",
|
|
25
|
+
"repository": {
|
|
26
|
+
"type": "git",
|
|
27
|
+
"url": "git+https://github.com/kumbatio/energy-system.git"
|
|
28
|
+
},
|
|
7
29
|
"files": [
|
|
8
30
|
"dist",
|
|
9
31
|
"src/energy.css",
|
|
@@ -47,26 +69,6 @@
|
|
|
47
69
|
"publishConfig": {
|
|
48
70
|
"access": "public"
|
|
49
71
|
},
|
|
50
|
-
"scripts": {
|
|
51
|
-
"build:ts": "tsc -p tsconfig.build.json",
|
|
52
|
-
"build": "pnpm run build:ts && pnpm run api:surface && pnpm run conformance",
|
|
53
|
-
"api:surface": "node scripts/extract-api-surface.ts",
|
|
54
|
-
"api:surface:check": "node scripts/extract-api-surface.ts --check",
|
|
55
|
-
"check-types": "tsc --noEmit -p tsconfig.json",
|
|
56
|
-
"test": "pnpm run build:ts && node --test 'test/**/*.test.ts'",
|
|
57
|
-
"validate": "pnpm run format:check && pnpm run lint && pnpm run check-types && pnpm run test && pnpm run pack:dry-run",
|
|
58
|
-
"prepack": "pnpm run format:check && pnpm run lint && pnpm run check-types && pnpm run test",
|
|
59
|
-
"pack:dry-run": "pnpm pack --dry-run",
|
|
60
|
-
"format": "oxfmt --write .",
|
|
61
|
-
"format:check": "oxfmt --check .",
|
|
62
|
-
"lint": "oxlint --type-aware --type-check .",
|
|
63
|
-
"lint:fix": "oxlint --type-aware --type-check --fix . && oxfmt --write .",
|
|
64
|
-
"lint:fix-unsafe": "oxlint --type-aware --type-check --fix --fix-suggestions --fix-dangerously . && oxfmt --write .",
|
|
65
|
-
"check:fix-suggestions": "oxlint --type-aware --type-check --fix --fix-suggestions . && oxfmt --write .",
|
|
66
|
-
"conformance": "TZ=UTC node scripts/extract-conformance.ts",
|
|
67
|
-
"conformance:check": "TZ=UTC node scripts/extract-conformance.ts --check",
|
|
68
|
-
"release": "release-kit"
|
|
69
|
-
},
|
|
70
72
|
"devDependencies": {
|
|
71
73
|
"@entro314labs/release-kit": "^2.11.0",
|
|
72
74
|
"@happy-dom/global-registrator": "^21.0.3",
|
|
@@ -82,8 +84,8 @@
|
|
|
82
84
|
"typescript": "next"
|
|
83
85
|
},
|
|
84
86
|
"peerDependencies": {
|
|
85
|
-
"@types/react": ">=19.
|
|
86
|
-
"react": ">=19.
|
|
87
|
+
"@types/react": ">=19.2.0",
|
|
88
|
+
"react": ">=19.2.0"
|
|
87
89
|
},
|
|
88
90
|
"peerDependenciesMeta": {
|
|
89
91
|
"@types/react": {
|
|
@@ -94,7 +96,25 @@
|
|
|
94
96
|
}
|
|
95
97
|
},
|
|
96
98
|
"engines": {
|
|
97
|
-
"node": ">=
|
|
99
|
+
"node": ">=22"
|
|
98
100
|
},
|
|
99
|
-
"
|
|
100
|
-
|
|
101
|
+
"scripts": {
|
|
102
|
+
"build:ts": "tsc -p tsconfig.build.json",
|
|
103
|
+
"build": "pnpm run build:ts && pnpm run api:surface && pnpm run conformance",
|
|
104
|
+
"api:surface": "node scripts/extract-api-surface.ts",
|
|
105
|
+
"api:surface:check": "node scripts/extract-api-surface.ts --check",
|
|
106
|
+
"check-types": "tsc --noEmit -p tsconfig.json",
|
|
107
|
+
"test": "pnpm run build:ts && node --test 'test/**/*.test.ts'",
|
|
108
|
+
"validate": "pnpm run format:check && pnpm run lint && pnpm run check-types && pnpm run test && pnpm run pack:dry-run",
|
|
109
|
+
"pack:dry-run": "pnpm pack --dry-run",
|
|
110
|
+
"format": "oxfmt --write .",
|
|
111
|
+
"format:check": "oxfmt --check .",
|
|
112
|
+
"lint": "oxlint --type-aware --type-check .",
|
|
113
|
+
"lint:fix": "oxlint --type-aware --type-check --fix . && oxfmt --write .",
|
|
114
|
+
"lint:fix-unsafe": "oxlint --type-aware --type-check --fix --fix-suggestions --fix-dangerously . && oxfmt --write .",
|
|
115
|
+
"check:fix-suggestions": "oxlint --type-aware --type-check --fix --fix-suggestions . && oxfmt --write .",
|
|
116
|
+
"conformance": "TZ=UTC node scripts/extract-conformance.ts",
|
|
117
|
+
"conformance:check": "TZ=UTC node scripts/extract-conformance.ts --check",
|
|
118
|
+
"release": "release-kit"
|
|
119
|
+
}
|
|
120
|
+
}
|