@kehto/paja 0.21.4 → 0.24.0

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/README.md CHANGED
@@ -59,7 +59,7 @@ warning, when the target would block the sandboxed frame.
59
59
 
60
60
  Every drawer section is a flush, independent native accordion: **Pointer** (in
61
61
  runtime-pointer mode), **Interfaces**, **ACL**, **Signer**, **Resource servers**,
62
- then **Messages** last. Headers support Enter/Space, visible keyboard focus and
62
+ **Messages**, then **Events** last. Headers support Enter/Space, visible keyboard focus and
63
63
  state chevrons; bodies keep their padding and live controls when hidden. Sections
64
64
  start expanded unless a validated origin-local boolean preference says otherwise.
65
65
  The collapsed map uses `kehto:paja:sidebar-sections:v1`, separately from whole-drawer
@@ -129,7 +129,20 @@ bounded range reads, canonical padded-base64 writes, replace/append/patch,
129
129
  revisions and preconditions, recursive mkdir/remove, atomic handle moves when
130
130
  the browser supports them, and advisory watches over actual storage. Host
131
131
  paths and handles never cross the NIP-5D boundary. This implementation follows
132
- draft [NAP-FS `b640cf33`](https://github.com/napplet/naps/blob/b640cf337c0481f0f9a0216c00843f797a5c6df6/naps/NAP-FS.md).
132
+ draft [NAP-FS `bd1b9e91`](https://github.com/napplet/naps/blob/bd1b9e912f05203bf38f7a1b04f920744fe6d625/naps/NAP-FS.md).
133
+
134
+ Workspace storage and native pickers have separate browser requirements. Firefox
135
+ can provide OPFS while lacking `showOpenFilePicker`, `showSaveFilePicker`, and
136
+ `showDirectoryPicker`. In that environment, workspace operations remain usable
137
+ and the corresponding picker requests return the canonical `unsupported` result.
138
+ The Interfaces panel shows workspace and open/save/directory picker availability
139
+ separately; the message log names a missing picker API when one caused that result.
140
+ Green `fs:read` and `fs:write` ACL controls indicate permission, not browser API
141
+ support. See the [picker compatibility reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/showOpenFilePicker#browser_compatibility).
142
+
143
+ The focused host regression runs in Chromium and Firefox after `pnpm build`:
144
+ `pnpm exec playwright install firefox`, then
145
+ `pnpm exec playwright test --config playwright.paja-fs.config.ts`.
133
146
 
134
147
  Other domains are equally capability-bound. Relay, outbox, and count require
135
148
  live relays; count uses NIP-45 `COUNT` without downloading events. Storage
@@ -185,6 +198,8 @@ runtime tabs in local storage so returning to `/web/paja/` restores the previous
185
198
  pointer set. An explicit pointer in the URL still takes precedence over restored
186
199
  tabs.
187
200
 
201
+ The browser page title follows the active napplet tab name, including when switching or closing tabs. With no active napplet, the title is `@kehto/paja`.
202
+
188
203
  The static artifact defaults to Paja's standard live relays and memory uploads.
189
204
  To point it at specific live relays or Blossom upload servers, pass
190
205
  comma-separated host lists when generating the artifact:
@@ -239,6 +254,14 @@ catalog. Entries preserve exact conventions and ordered parameter names under
239
254
  publisher/kind-safe opaque IDs, including nameless root and snapshot artifacts.
240
255
  The target's resolved `intent` domain must be available; INC is not required.
241
256
 
257
+ Catalog installs, replacements, removals, and user default-handler updates emit
258
+ `intent.changed` to eligible open napplets (`napplet.intent.onChanged(...)`).
259
+ Replacements notify both removed and added archetypes, once per slug, using the
260
+ current filtered catalog. A `no handler` rejection remains terminal: callers must
261
+ retry explicitly; installing a handler does not replay the failed invocation.
262
+ This follows `napplet/naps` NAP-INTENT on master (last changed at `e5308ac`), whose
263
+ runtime behavior recommends notifications on catalog/default changes.
264
+
242
265
  Selection uses exact contracts and user-owned default, chooser, recommendation,
243
266
  and explicit-authorization policy. Explicit handler IDs require sender-aware
244
267
  authorization and cannot address an arbitrary running frame.
@@ -535,3 +558,7 @@ remain a documented upstream spec gap; no host sender identity is invented.
535
558
  ## GAMEPAD integration
536
559
 
537
560
  This non-normative guidance defers to the living [NAP-GAMEPAD](https://github.com/napplet/naps/pull/108). Services export `createGamepadService` and `browserGamepadOptions`; shell exports `denyNappletControllerAccess`. Paja and the playground register one host reader and deny native gamepad/HID/USB paths before frame execution. Source-bound subscriptions receive immediate full snapshots; only the visible host's input owner gets live controls. Focus loss supplies neutral controls and timestamp zero; unsubscribe, window destruction, and service removal release polling. Non-browser or denied native readers report the proposal's unavailable reasons. See [Controller input](https://github.com/kehto/web/blob/main/docs/gamepad.md).
561
+
562
+ ## Controller diagnostics
563
+
564
+ Paja shows a numbered controller icon directly beside the console arrow for each controller the browser detects. Each slot has its own color and input animation; hover for the controller model and activity state. Buttons and stick movement light up only that controller (stick movement below 0.12 is ignored). Quick taps retain the highlight briefly so they are easy to spot. Reduced-motion settings keep the activity highlight without animation. Disconnecting removes the icon. Browsers may require a button press before exposing a newly connected controller. These host diagnostics work without a napplet gamepad subscription and do not change focus-scoped input delivery.