aeon-ui-engine 1.10.1 → 1.10.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.10.2] - 2026-10-22
+
+### Changed
+
+- Describe this release.
+
 ## [Unreleased]
 
 ## [1.10.1] - 2026-10-22
@@ -12,7 +18,7 @@
 
 ### Added
 
-- **App store (`@aeon-ui/primitives`).** `createAeonStore({ id, slices, persist?, sync? })` keeps an app's data in one place: each entity once, by id, in its slice (`defineSlice({ idOf, load?, ttl?, tags? })`). Every change is an event: `ENTITY.UPSERT`, `ENTITY.PATCH` and `ENTITY.REMOVE`, plus optimistic `WRITE.BEGIN`, which marks entities pending until `WRITE.CONFIRM` or `WRITE.ROLLBACK` (restores the old value and marks it failed). Queries run on the chart cache (`QUERY.FETCH`, `QUERY.REFRESH`, `QUERY.INVALIDATE`, `STORE.INVALIDATE`). `select`, `query` and `entity` return the same object until their data changes. `queryAttrs` and `entityAttrs` project state onto `data-aeon-state`. Persistence saves only confirmed values through an adapter (`memoryAdapter`, `webStorageAdapter`), with `version` and `migrate`. `sync` feeds server pushes in as events, and `STORE.CLEAR` wipes memory, running loads and the saved copy. Charts read it by invoking `store.actor`. Store ids, slice names and entity fields that name secrets, keys or spend decisions are refused.
+- **App store (`@aeon-ui/primitives`, optional).** `createAeonStore({ id, slices, persist?, sync? })` keeps an app's data in one place: each entity once, by id, in its slice (`defineSlice({ idOf, load?, ttl?, tags? })`). Every change is an event: `ENTITY.UPSERT`, `ENTITY.PATCH` and `ENTITY.REMOVE`, plus optimistic `WRITE.BEGIN`, which marks entities pending until `WRITE.CONFIRM` or `WRITE.ROLLBACK` (restores the old value and marks it failed). Queries run on the chart cache (`QUERY.FETCH`, `QUERY.REFRESH`, `QUERY.INVALIDATE`, `STORE.INVALIDATE`). `select`, `query` and `entity` return the same object until their data changes. `queryAttrs` and `entityAttrs` project state onto `data-aeon-state`. Persistence saves only confirmed values through an adapter (`memoryAdapter`, `webStorageAdapter`), with `version` and `migrate`. `sync` feeds server pushes in as events, and `STORE.CLEAR` wipes memory, running loads and the saved copy. Charts read it by invoking `store.actor`. Store ids, slice names and entity fields that name secrets, keys or spend decisions are refused.
 - **`useAeonSelector` and `useAeonQuery` (`@aeon-ui/react`).** Read the store; a component re-renders only when the value it selects changes.
 
 ## [1.9.0] - 2026-10-21

package/README.md

@@ -176,9 +176,9 @@ function AsyncSurface() {
 
 See [docs/PRIMITIVE_COVERAGE.md](./docs/PRIMITIVE_COVERAGE.md).
 
-## App data: one store
+## App data: optional store
 
-Each app keeps its data in one `createAeonStore`: every entity once, by id, in its slice. Components never copy it. They read through selectors and show state through `data-aeon-*` attributes. Every change is an event sent to the store.
+Apps **can** keep shared entity data in one `createAeonStore` (optional). Charts, machines, and `data-aeon-state` work without it — HandCash and Alignity stay on their own machines and `createChartCache` until they choose the store. When you do use it: every entity once, by id, in its slice; components read through selectors; every change is an event.
 
 ```tsx
 import { createAeonStore, defineSlice, entityAttrs, queryAttrs, webStorageAdapter } from '@aeon-ui/primitives'
@@ -207,7 +207,7 @@ function PaymentRow({ id }: { id: string }) {
 - **Queries:** `QUERY.FETCH`, `QUERY.REFRESH` and `QUERY.INVALIDATE { query | tag }` run on the chart cache's states (`idle`, `loading`, `ready`, `stale`, `refreshing`, `failed`). `STORE.INVALIDATE` reloads every watched query (for reconnect or window focus). `STORE.CLEAR` drops all data, running loads and the saved copy (for lock or account switch).
 - **Persistence:** only confirmed values are saved, after a short quiet delay. A `version` bump runs `migrate`; without one, older saved data is dropped. Data written during start-up wins over the saved copy. Slices with `persist: false` stay in memory.
 - **Charts:** invoke `store.actor` with `input: { select }` to get `STORE.UPDATE` whenever the selection changes. Store events sent to it are forwarded to the store.
-- **Never stored:** store ids, slice names and entity fields at any depth that name secrets, keys, seeds, passwords or spend are refused.
+- **When used — never stored:** if you adopt the store, ids, slice names and entity fields at any depth that name secrets, keys, seeds, passwords or spend are refused. Apps that skip the store are unaffected.
 
 ## Example
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aeon-ui-engine",
-  "version": "1.10.1",
+  "version": "1.10.2",
   "private": false,
   "type": "module",
   "bin": {

package/packages/schemas/prompts/cursorrules.md

@@ -17,6 +17,9 @@ You are building UI with **Aeon UI**, a React component library powered by finit
 7. Prefer `@aeon-ui/react` (headless) or `@aeon-ui/ui` (styled). Relative TS imports use `.js` extensions inside the Aeon monorepo only.
 8. Primitives stay **universal** — never invent niche components (dating, colour-blind test, pong). Compose from generic parts.
 
+## App store (optional)
+`createAeonStore` / `useAeonSelector` / `useAeonQuery` are optional caching for shared entity state. Do **not** migrate an app onto them unless the user asked. Existing XState machines, `createChartCache`, and `data-aeon-state` on charts stay valid on their own — never block HandCash or Alignity work on adopting the store.
+
 ## DOM contract
 Every interactive surface sets anatomy via `partAttrs` from `@aeon-ui/core`:
 - `data-aeon-scope` — family (`button`, `async`, `field`, …)

package/packages/schemas/prompts/system.md

@@ -17,6 +17,9 @@ You are building UI with **Aeon UI**, a React component library powered by finit
 7. Prefer `@aeon-ui/react` (headless) or `@aeon-ui/ui` (styled). Relative TS imports use `.js` extensions inside the Aeon monorepo only.
 8. Primitives stay **universal** — never invent niche components (dating, colour-blind test, pong). Compose from generic parts.
 
+## App store (optional)
+`createAeonStore` / `useAeonSelector` / `useAeonQuery` are optional caching for shared entity state. Do **not** migrate an app onto them unless the user asked. Existing XState machines, `createChartCache`, and `data-aeon-state` on charts stay valid on their own — never block HandCash or Alignity work on adopting the store.
+
 ## DOM contract
 Every interactive surface sets anatomy via `partAttrs` from `@aeon-ui/core`:
 - `data-aeon-scope` — family (`button`, `async`, `field`, …)

package/packages/schemas/src/prompts.ts

@@ -22,6 +22,9 @@ You are building UI with **Aeon UI**, a React component library powered by finit
 7. Prefer \`@aeon-ui/react\` (headless) or \`@aeon-ui/ui\` (styled). Relative TS imports use \`.js\` extensions inside the Aeon monorepo only.
 8. Primitives stay **universal** — never invent niche components (dating, colour-blind test, pong). Compose from generic parts.
 
+## App store (optional)
+\`createAeonStore\` / \`useAeonSelector\` / \`useAeonQuery\` are optional caching for shared entity state. Do **not** migrate an app onto them unless the user asked. Existing XState machines, \`createChartCache\`, and \`data-aeon-state\` on charts stay valid on their own — never block HandCash or Alignity work on adopting the store.
+
 ## DOM contract
 Every interactive surface sets anatomy via \`partAttrs\` from \`@aeon-ui/core\`:
 - \`data-aeon-scope\` — family (\`button\`, \`async\`, \`field\`, …)