docs: the Store in the framework (shared catalog format, keys, tooling, trust model, adding it)

- docs/STORE.md: one signed catalog for every app (format 2, `apps` per item, field rules), Ed25519
  signing and key rotation, `waybetter store build|sign|verify` with an app config, install links,
  the trust model, and how an app adds the Store (StoreConfig, command wrappers, InstallHost,
  StoreView, tokens, strings).
- README: `store` in the layout and in what the host gives an app; the shell's Store modules.
- npm README: the Store components, models, schema and command.
This commit is contained in:
CRTkafa 2026-09-29 11:21:17 +07:00
parent 7b258e0941
commit 69751c2765
3 changed files with 176 additions and 1 deletions

View file

@ -12,6 +12,10 @@ heavy Electron client alike: every wayBetter app is the same shell, runtime and
- **`waybetter/shell/*`**: pure models for the app chrome around the pages: address bar chips,
dock/split-pane rules, dragged links, account profiles, the update chip, command palette
ranking and window controls. The Tauri window API is passed in by the caller, never imported.
And the wayBetter Store: the install screen and the Store view as React components (React is an
optional peer; everything else has no dependencies), their controller and models.
- **`waybetter store build|sign|verify`** and **`waybetter/store-catalog.schema.json`**: the tooling
and JSON Schema of the shared, signed wayBetter Store catalog.
Plain ESM with `.d.ts` types. Zero dependencies.
@ -63,6 +67,14 @@ pieces. The source comments document each module's contract.
- `profileModel`: the account profile model.
- `updateModel`: the titlebar update chip model.
- `windowControls`: native window calls for the titlebar, resize grips and caption buttons.
- `storeModel`, `storeMessages`: Store wire types, item states (install, update, changed locally, built in), permission badges, search; the English of every `wb.store.*`, `wb.install.*`, `wb.permission.*` message (translations in `waybetter/locales/*.json`).
- `installController`: the install screen's state (install links, dropped files, store items, confirm), given the app's native bridge and theme adapter.
- `InstallDialog` (`InstallHost`), `StoreView`, `store.css`: the install screen, the window drop target and the Store view, themed with `--wb-*` tokens. See docs/STORE.md in the repository.
**Command line**
- `waybetter store build --config store.config.mjs`: builds an app's part of the shared store folder (its items only, validated with the apps' own rules).
- `waybetter store sign [--init] --key <private key>` / `waybetter store verify --pub <key file>`: Ed25519 signature over the exact catalog bytes; any listed public key verifies (rotation). The private key is never printed or copied.
## Plugin UI kit (`runtime/ui`)