@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 +29 -2
- package/dist/browser-host.js +916 -364
- package/dist/browser-host.js.map +1 -1
- package/dist/{chunk-HG2CUTQC.js → chunk-ZRAED35O.js} +105 -9
- package/dist/chunk-ZRAED35O.js.map +1 -0
- package/dist/cli.js +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.js +1 -1
- package/package.json +5 -5
- package/dist/chunk-HG2CUTQC.js.map +0 -1
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 **
|
|
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 `
|
|
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.
|