foldkit-primitives 0.8.0 → 0.10.0

package/README.md

@@ -106,7 +106,7 @@ import * as Subscription from 'foldkit/subscription'
 import { keyboardEvents } from 'foldkit-primitives/events'
 
 const subscriptions = Subscription.make<GameModel, GameMessage>()(() => ({
-  keys: Subscription.persistent(
+  keys: Subscription.persistentEntry(
     keyboardEvents({ preventDefault: press => press.key.startsWith('Arrow') }).pipe(
       Stream.filter(event => event._tag === 'Pressed'),
       Stream.map(({ key }) => GameMessage.PressedKey({ key })),
@@ -138,6 +138,36 @@ const copy = (model: NoteModel): Update.Return<NoteModel, NoteMessage> => ({
 })
 ```
 
+## Find one by the job
+
+| You want to | Reach for | In |
+| --- | --- | --- |
+| Follow the color scheme, reduced motion or any media query | `MediaQuery`, `PrefersDark`, `PrefersReducedMotion` | [media](./media/README.md) |
+| Change the layout at named widths | `Breakpoints` | [media](./media/README.md) |
+| Know whether the tab is visible, the window's size, or the user idle | `Visibility`, `WindowSize`, `Idle` | [events](./events/README.md) |
+| Answer keyboard shortcuts | `keyboardEvents` with `matchHotkey` | [events](./events/README.md) |
+| Count ticks, or run something on an interval | `Timer`, `Interval`, `ticks` | [time](./time/README.md) |
+| Wait until typing stops, or limit how often something runs | `debounce`, `Throttle` | [time](./time/README.md) |
+| Say "3 minutes ago" | `formatRelativeTime` | [time](./time/README.md) |
+| Page through a list | `Pagination`, `range` | [state](./state/README.md) |
+| Undo and redo | `history` | [state](./state/README.md) |
+| Draw only the visible rows of a long list | `Virtual` | [state](./state/README.md) |
+| Animate a value, or let an element leave before it is removed | `Tween`, `Spring`, `Presence` | [motion](./motion/README.md) |
+| Move with arrow keys through a toolbar, list, grid or tree | `RovingTabindex`, `ListNavigation`, `GridNavigation`, `TreeNavigation` | [interaction](./interaction/README.md) |
+| Close a popup on Escape or an outside press | `DismissLayer`, `Overlay` | [interaction](./interaction/README.md) |
+| Press, long-press or drag | `Press`, `LongPress`, `Move`, `PointerDrag` | [interaction](./interaction/README.md) |
+| Edit text in place | `EditableText` | [interaction](./interaction/README.md) |
+| Tell a screen reader what changed | `LiveAnnounce` | [interaction](./interaction/README.md) |
+| Know whether the browser is online, or talk over a socket | `Online`, `websocket`, `sse` | [net](./net/README.md) |
+| Talk between tabs | `broadcastMessages`, `SharedHost` | [net](./net/README.md) |
+| Use the camera, the location or a permission | `mediaStream`, `Geolocation`, `permissions` | [device](./device/README.md) |
+| Track one element's size or visibility | `Resize`, `Intersection`, `Bounds` | [observers](./observers/README.md) |
+| Focus, mask or keep an element in view | `Autofocus`, `InputMask`, `KeepInView` | [dom](./dom/README.md) |
+| Copy, share, load a script or restore scroll | `copyText`, `share`, `loadScript`, `keepScroll` | [dom](./dom/README.md) |
+
+Working widgets built from the interaction primitives are listed under
+[In the examples](./interaction/README.md#in-the-examples).
+
 ## The map
 
 Each subpath is one concern and one import. Its README has the full
@@ -154,7 +184,7 @@ reference: every Model shape, Message, argument, and failure rule.
 | [`device`](./device/README.md) | hardware | `Geolocation`, `mediaDevices`, `mediaStream`, `permissions`, fullscreen |
 | [`events`](./events/README.md) | raw window events | `Visibility`, `WindowSize`, `Idle`, `InputModality`, `keyboardEvents`, `pointerEvents`, `scrollEvents`, `activeElementEvents`, `matchHotkey` |
 | [`observers`](./observers/README.md) | element observers | `Resize`, `Intersection`, `Mutation`, `Bounds` |
-| [`dom`](./dom/README.md) | element Mounts and one-shot Commands | `Autofocus`, `InputMask`, `KeepInView`, `Measure`, `FocusScope`, `FollowTabStop`, `ScrollLock`, `HideOutside`, `copyText`, `readText`, `share`, `loadScript`, `keepScroll` |
+| [`dom`](./dom/README.md) | element Mounts and one-shot Commands | `Autofocus`, `InputMask`, `KeepInView`, `Measure`, `FocusScope`, `FollowTabStop`, `ScrollLock`, `HideOutside`, `copyText`, `readText`, `share`, `loadScript`, `keepScroll`, `pointedLinks` |
 
 ## Rules every primitive keeps
 

package/dist/device/index.d.mts

@@ -5,12 +5,12 @@ import { Command } from "foldkit/command";
 //#region src/device/fullscreen.d.ts
 export declare const FullscreenMessage: import("foldkit/message").MessageUnion<{
   readonly Changed: {
-    readonly active: Schema.Boolean;
+    active: Schema.Boolean;
   };
   readonly Entered: {};
   readonly Exited: {};
   readonly Failed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type FullscreenMessage = typeof FullscreenMessage.Type;
@@ -48,18 +48,24 @@ export declare const GeolocationModel: Schema.Struct<{
 export type GeolocationModel = typeof GeolocationModel.Type;
 export declare const GeolocationMessage: import("foldkit/message").MessageUnion<{
   readonly Located: {
-    readonly latitude: Schema.Number;
-    readonly longitude: Schema.Number;
-    readonly accuracy: Schema.Number;
+    latitude: Schema.Number;
+    longitude: Schema.Number;
+    accuracy: Schema.Number;
   };
   readonly Denied: {};
   readonly Failed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type GeolocationMessage = typeof GeolocationMessage.Type;
+/**
+ * Geolocation as a bundle: the device position in the Model, watched while
+ * placed. Permission denial is its own status (actionable UI); transient
+ * failures keep the last fix and note the error. No geolocation API yields
+ * an empty stream instead of throwing.
+ */
 export declare const Geolocation: Bundle.Bundle<"Geolocation", void, {
-  readonly status: "unknown" | "denied" | "ready";
+  readonly status: "denied" | "ready" | "unknown";
   readonly coords: {
     readonly latitude: number;
     readonly longitude: number;
@@ -67,6 +73,8 @@ export declare const Geolocation: Bundle.Bundle<"Geolocation", void, {
   } | null;
   readonly lastError: string | null;
 }, {
+  readonly _tag: "Denied";
+} | {
   readonly _tag: "Failed";
   readonly message: string;
 } | {
@@ -74,8 +82,6 @@ export declare const Geolocation: Bundle.Bundle<"Geolocation", void, {
   readonly latitude: number;
   readonly longitude: number;
   readonly accuracy: number;
-} | {
-  readonly _tag: "Denied";
 }, never, never, never, void, {}, {}>;
 //#endregion
 //#region src/device/media-devices.d.ts
@@ -101,7 +107,7 @@ export declare const MediaDevicesMessage: import("foldkit/message").MessageUnion
   readonly Scan: {};
   readonly DevicesChanged: {};
   readonly Refreshed: {
-    readonly devices: Schema.$Array<Schema.Struct<{
+    devices: Schema.$Array<Schema.Struct<{
       readonly deviceId: Schema.String;
       readonly groupId: Schema.String;
       readonly kind: Schema.Literals<readonly ["audioinput", "audiooutput", "videoinput"]>;
@@ -110,7 +116,7 @@ export declare const MediaDevicesMessage: import("foldkit/message").MessageUnion
   };
   readonly Denied: {};
   readonly Failed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type MediaDevicesMessage = typeof MediaDevicesMessage.Type;
@@ -125,12 +131,20 @@ export interface MediaDevicesHandle {
   addEventListener(type: string, listener: () => void): void;
   removeEventListener(type: string, listener: () => void): void;
 }
+/**
+ * Media devices as a bundle factory: the enumerated device list in the
+ * Model, scanned on placement and re-scanned on every `devicechange`.
+ * Denial lands as `denied` while keeping the last list (actionable UI over
+ * stale data, like Geolocation's last fix); any other failure keeps the
+ * list and notes the error. No media-devices API yields an empty stream
+ * and a `Failed` scan instead of throwing.
+ */
 export declare const mediaDevices: <const Name extends string>(config: {
   readonly name: Name;
   /** Read lazily so tests can substitute a double, like the SSE bundle. */
   readonly create?: ((navigator: Navigator) => MediaDevicesHandle | null) | undefined;
 }) => Bundle.Bundle<Name, void, {
-  readonly status: "unknown" | "denied" | "ready";
+  readonly status: "denied" | "ready" | "unknown";
   readonly devices: readonly {
     readonly deviceId: string;
     readonly groupId: string;
@@ -140,13 +154,11 @@ export declare const mediaDevices: <const Name extends string>(config: {
   readonly lastError: string | null;
 }, {
   readonly _tag: "Denied";
+} | {
+  readonly _tag: "DevicesChanged";
 } | {
   readonly _tag: "Failed";
   readonly message: string;
-} | {
-  readonly _tag: "Scan";
-} | {
-  readonly _tag: "DevicesChanged";
 } | {
   readonly _tag: "Refreshed";
   readonly devices: readonly {
@@ -155,6 +167,8 @@ export declare const mediaDevices: <const Name extends string>(config: {
     readonly kind: "audioinput" | "audiooutput" | "videoinput";
     readonly label: string;
   }[];
+} | {
+  readonly _tag: "Scan";
 }, never, never, never, void, {}, {}>;
 //#endregion
 //#region src/device/media-stream.d.ts
@@ -170,7 +184,7 @@ export declare const MediaStreamMessage: import("foldkit/message").MessageUnion<
   readonly Ended: {};
   readonly Denied: {};
   readonly Failed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type MediaStreamMessage = typeof MediaStreamMessage.Type;
@@ -182,6 +196,7 @@ export interface MediaTrackHandle {
 export interface MediaStreamHandle {
   getTracks(): ReadonlyArray<MediaTrackHandle>;
 }
+/** Which tracks `mediaStream` asks `getUserMedia` for. */
 export interface MediaStreamConstraints {
   readonly audio: boolean;
   readonly video: boolean;
@@ -190,6 +205,15 @@ export interface MediaStreamConstraints {
 export declare const LiveStream: ManagedResource.ManagedResource<MediaStreamHandle, ManagedResource.ManagedResourceService<"media-stream">>;
 /** The stream service a placed camera requires. */
 export type LiveStreamService = ManagedResource.ServiceOf<typeof LiveStream>;
+/**
+ * A camera/mic stream as a bundle factory: one live MediaStream held in a
+ * Managed Resource while the Model asks for it. `Started` requests,
+ * `Stopped` releases; denial parks at `denied` (actionable UI), any other
+ * acquire failure parks at `idle` with the error noted — both clear
+ * requirements, so a failing device never spins an acquire loop. Release
+ * stops every track. No media-devices API fails the acquire instead of
+ * throwing.
+ */
 export declare const mediaStream: <const Name extends string>(config: {
   readonly name: Name;
   /** Read lazily so tests can substitute a double, like the SSE bundle. */
@@ -198,7 +222,7 @@ export declare const mediaStream: <const Name extends string>(config: {
   readonly audio: boolean;
   readonly video: boolean;
 }, {
-  readonly status: "denied" | "idle" | "requesting" | "live";
+  readonly status: "denied" | "idle" | "live" | "requesting";
   readonly lastError: string | null;
 }, {
   readonly _tag: "Started";
@@ -207,15 +231,15 @@ export declare const mediaStream: <const Name extends string>(config: {
 } | {
   readonly _tag: "Denied";
 } | {
-  readonly _tag: "Live";
+  readonly _tag: "Ended";
 } | {
   readonly _tag: "Failed";
   readonly message: string;
 } | {
-  readonly _tag: "Ended";
+  readonly _tag: "Live";
 }, never, never, never, void, {
   stream: ManagedResource.Entry<{
-    readonly status: "denied" | "idle" | "requesting" | "live";
+    readonly status: "denied" | "idle" | "live" | "requesting";
     readonly lastError: string | null;
   }, {
     readonly _tag: "Started";
@@ -224,12 +248,12 @@ export declare const mediaStream: <const Name extends string>(config: {
   } | {
     readonly _tag: "Denied";
   } | {
-    readonly _tag: "Live";
+    readonly _tag: "Ended";
   } | {
     readonly _tag: "Failed";
     readonly message: string;
   } | {
-    readonly _tag: "Ended";
+    readonly _tag: "Live";
   }, Option.Option<{
     readonly audio: boolean;
     readonly video: boolean;
@@ -248,15 +272,15 @@ export declare const PermissionsModel: Schema.Struct<{
 export type PermissionsModel = typeof PermissionsModel.Type;
 export declare const PermissionsMessage: import("foldkit/message").MessageUnion<{
   readonly Snapshot: {
-    readonly states: Schema.$Record<Schema.String, Schema.Literals<readonly ["granted", "denied", "prompt"]>>;
+    states: Schema.$Record<Schema.String, Schema.Literals<readonly ["granted", "denied", "prompt"]>>;
   };
   readonly Changed: {
-    readonly name: Schema.String;
-    readonly state: Schema.Literals<readonly ["granted", "denied", "prompt"]>;
+    name: Schema.String;
+    state: Schema.Literals<readonly ["granted", "denied", "prompt"]>;
   };
   readonly Cleared: {};
   readonly Failed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type PermissionsMessage = typeof PermissionsMessage.Type;
@@ -280,6 +304,14 @@ interface Acquired {
 export declare const Watch: ManagedResource.ManagedResource<Acquired, ManagedResource.ManagedResourceService<"permissions">>;
 /** The watch service a placed Permissions bundle requires. */
 export type WatchService = ManagedResource.ServiceOf<typeof Watch>;
+/**
+ * Permission states as a bundle factory: queried on placement, kept current
+ * by each status object's `onchange`. A resource holds the status objects
+ * (they cannot live in the Model); its queue feeds the subscription, and
+ * release detaches every handler. An unknown permission name fails the
+ * acquire; an unknown state string fails it too — both become `Failed`,
+ * never Model facts.
+ */
 export declare const permissions: <const Name extends string>(config: {
   readonly name: Name;
   /** Read lazily so tests can substitute a double, like the SSE bundle. */
@@ -288,7 +320,7 @@ export declare const permissions: <const Name extends string>(config: {
   readonly names: ReadonlyArray<string>;
 }, {
   readonly states: {
-    readonly [x: string]: "granted" | "denied" | "prompt";
+    readonly [x: string]: "denied" | "granted" | "prompt";
   };
   readonly lastError: string | null;
 }, {
@@ -296,17 +328,18 @@ export declare const permissions: <const Name extends string>(config: {
 } | {
   readonly _tag: "Changed";
   readonly name: string;
-  readonly state: "granted" | "denied" | "prompt";
+  readonly state: "denied" | "granted" | "prompt";
+} | {
+  readonly _tag: "Failed";
+  readonly message: string;
 } | {
   readonly _tag: "Snapshot";
   readonly states: {
-    readonly [x: string]: "granted" | "denied" | "prompt";
+    readonly [x: string]: "denied" | "granted" | "prompt";
   };
-} | {
-  readonly _tag: "Failed";
-  readonly message: string;
 }, never, never, ManagedResource.ManagedResourceService<"permissions">, void, Readonly<{
   watch: ManagedResource.Entry<PermissionsModel, PermissionsMessage, Option.Option<ReadonlyArray<string>>, Acquired, WatchService, (acquired: Acquired) => PermissionsMessage>;
 }>, {}>;
 //#endregion
+export {};
 //# sourceMappingURL=index.d.mts.map

package/dist/device/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/device/fullscreen.ts","../../src/device/geolocation.ts","../../src/device/media-devices.ts","../../src/device/media-stream.ts","../../src/device/permissions.ts"],"mappings":";;;;;qBAWa,6CAAiB;;;;;;;;;;YAMlB,2BAA2B,kBAAkB;;;;;;;qBAW5C,kBAAmB,SAAS,YAAU,QAAQ;;qBA0B9C,sBAAqB,QAAQ;;;;;qBAgC7B,yBAAwB,OAAO,OAAO;;;qBCzEtC,aAAW,OAAA;;;;;YAKZ,qBAAqB,YAAY;qBAEhC,kBAAgB,OAAA;;;;;;;;;YAKjB,0BAA0B,iBAAiB;qBAE1C,8CAAkB;;;;;;;;;;;YASnB,4BAA4B,mBAAmB;qBAmD9C,aAAW,OAAA;;;;;;;;;;;;;;;;;;;;;qBCxEX,aAAW,OAAA;;;;;;YAMZ,qBAAqB,YAAY;qBAEhC,mBAAiB,OAAA;;;;;;;;;;YAKlB,2BAA2B,kBAAkB;qBAE5C,+CAAmB;;;;;;;;;;;;;;;;YAOpB,6BAA6B,oBAAoB;;iBAa5C;EACf,oBAAoB,QAClB;aACW;aACA;aACA;aACA;;EAGb,iBAAiB,cAAc;EAC/B,oBAAoB,cAAc;;qBAUvB,qBAAsB,qBAAqB;WAC7C,MAAM;;WAEN,WAAW,WAAW,cAAc;MAC9C,OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBC1DY,kBAAgB,OAAA;;;;YAIjB,0BAA0B,iBAAiB;qBAE1C,8CAAkB;;;;;;;sBAAlB,OAAA;;;YAQD,4BAA4B,mBAAmB;;iBAG1C;EACf;;;iBAIe;EACf,aAAa,cAAc;;iBAGZ;WACN;WACA;;;qBAIE,YAAU,gBAAA,gBAAA,mBAAA,gBAAA;;YAGX,oBAAoB,gBAAgB,iBAAiB;qBAoBpD,oBAAqB,qBAAqB;WAC5C,MAAM;;WAEN,YACL,aAAa,2BAA2B,QAAQ;MACrD,OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBC5DY,iBAAe,OAAA;YAChB,yBAAyB,gBAAgB;qBAExC,kBAAgB,OAAA;;;;YAIjB,0BAA0B,iBAAiB;qBAE1C,8CAAkB;;;;;;;;;;;;;YAMnB,4BAA4B,mBAAmB;;iBAG1C;WACN;EACT;;;iBAIe;EACf,MAAM;aAAuB;MAAiB,QAAQ;;UAG9C;WACC,UAAU,oBAAoB;WAC9B,UAAU,SAAS,eAAe;WAClC,QAAQ,MAAM,MAAM;;;qBAIlB,OAAK,gBAAA,gBAAA,UAAA,gBAAA;;YAGN,eAAe,gBAAgB,iBAAiB;qBAuB/C,oBAAqB,qBAAqB;WAC5C,MAAM;;WAEN,WAAW,WAAW,cAAc;MAC9C,OAAA,OAAA;WAYqB,OAAA;;;;;;;;;;;;;;;;;;;;;EApCb,OAAA,gBAAgB,MACrB,kBACA,oBACA,OAAO,OAAO,wBACd,UACA,eACC,UAAU,aAAa"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/device/fullscreen.ts","../../src/device/geolocation.ts","../../src/device/media-devices.ts","../../src/device/media-stream.ts","../../src/device/permissions.ts"],"mappings":";;;;;qBAWa,6CAAiB;;IACjB,QAAM,OAAA;;;;;IAGP,SAAO,OAAA;;;YAEP,2BAA2B,kBAAkB;;;;;;;qBAW5C,kBAAe,SAAa,YAAU,QAAQ;;qBA0B9C,sBAAqB,QAAQ;;;;;qBAgC7B,yBAAwB,OAAO,OAAO;;;qBC/EtC,aAAW,OAAA;;;;;YAKZ,qBAAqB,YAAY;qBAEhC,kBAAgB,OAAA;;;;;;;;;YAKjB,0BAA0B,iBAAiB;qBAE1C,8CAAkB;;IAE3B,UAAQ,OAAA;IACR,WAAS,OAAA;IACT,UAAQ,OAAA;;;;IAGA,SAAO,OAAA;;;YAEP,4BAA4B,mBAAmB;;;;;;;qBAyD9C,aAAW,OAAA;;;;;;;;;;;;;;;;;;;;;qBChFX,aAAW,OAAA;;;;;;YAMZ,qBAAqB,YAAY;qBAEhC,mBAAiB,OAAA;;;;;;;;;;YAKlB,2BAA2B,kBAAkB;qBAE5C,+CAAmB;;;;IAGjB,SAAO,OAAA,OAAA,OAAA;;;;;;;;;IAEV,SAAO,OAAA;;;YAEP,6BAA6B,oBAAoB;;iBAa5C;EACf,oBAAoB,QAClB;aACW;aACA;aACA;aACA;;EAGb,iBAAiB,cAAc;EAC/B,oBAAoB,cAAc;;;;;;;;;;qBAkBvB,qBAAsB,qBAAmB;WAC3C,MAAM;;WAEN,WAAW,WAAW,cAAc;MAC9C,OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBCnEY,kBAAgB,OAAA;;;;YAIjB,0BAA0B,iBAAiB;qBAE1C,8CAAkB;;;;;;;IAMnB,SAAO,OAAA;;;YAEP,4BAA4B,mBAAmB;;iBAG1C;EACf;;;iBAIe;EACf,aAAa,cAAc;;;iBAIZ;WACN;WACA;;;qBAIE,YAAU,gBAAA,gBAAA,mBAAA,gBAAA;;YAGX,oBAAoB,gBAAgB,iBAAiB;;;;;;;;;;qBA6BpD,oBAAqB,qBAAmB;WAC1C,MAAM;;WAEN,YACL,aAAa,2BAA2B,QAAQ;MACrD,OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBCrEY,iBAAe,OAAA;YAChB,yBAAyB,gBAAgB;qBAExC,kBAAgB,OAAA;;;;YAIjB,0BAA0B,iBAAiB;qBAE1C,8CAAkB;;IACjB,QAAM,OAAA,QAAA,OAAA,QAAA,OAAA;;;IACP,MAAI,OAAA;IAAiB,OAAK,OAAA;;;;IAE3B,SAAO,OAAA;;;YAEP,4BAA4B,mBAAmB;;iBAG1C;WACN;EACT;;;iBAIe;EACf,MAAM;aAAuB;MAAiB,QAAQ;;UAG9C;WACC,UAAU,oBAAoB;WAC9B,UAAU,SAAS,eAAe;WAClC,QAAQ,MAAM,MAAM;;;qBAIlB,OAAK,gBAAA,gBAAA,UAAA,gBAAA;;YAGN,eAAe,gBAAgB,iBAAiB;;;;;;;;;qBA+B/C,oBAAqB,qBAAmB;WAC1C,MAAM;;WAEN,WAAW,WAAW,cAAc;MAC9C,OAAA,OAAA;WAYqB,OAAA;;;;;;;;;;;;;;;;;;;;;EA5Cb,OAAA,gBAAgB,MACrB,kBACA,oBACA,OAAO,OAAO,wBACd,UACA,eACC,UAAU,aAAa"}

package/dist/device/index.mjs

@@ -70,12 +70,6 @@ const fullscreenChanges = () => {
 };
 //#endregion
 //#region src/device/geolocation.ts
-/**
-* Geolocation as a bundle: the device position in the Model, watched while
-* placed. Permission denial is its own status (actionable UI); transient
-* failures keep the last fix and note the error. No geolocation API yields
-* an empty stream instead of throwing.
-*/
 const Coordinates = Schema.Struct({
 	latitude: Schema.Number,
 	longitude: Schema.Number,
@@ -119,6 +113,12 @@ const watchStream = () => {
 		return Stream.fromQueue(queue);
 	}));
 };
+/**
+* Geolocation as a bundle: the device position in the Model, watched while
+* placed. Permission denial is its own status (actionable UI); transient
+* failures keep the last fix and note the error. No geolocation API yields
+* an empty stream instead of throwing.
+*/
 const Geolocation = Bundle.make("Geolocation", {
 	Model: GeolocationModel,
 	Message: GeolocationMessage,
@@ -146,18 +146,10 @@ const Geolocation = Bundle.make("Geolocation", {
 			lastError: message
 		}) })
 	}),
-	subscriptions: () => Subscription.make()(() => ({ watch: Subscription.persistent(watchStream()) }))
+	subscriptions: () => Subscription.make()(() => ({ watch: Subscription.persistentEntry(watchStream()) }))
 });
 //#endregion
 //#region src/device/media-devices.ts
-/**
-* Media devices as a bundle factory: the enumerated device list in the
-* Model, scanned on placement and re-scanned on every `devicechange`.
-* Denial lands as `denied` while keeping the last list (actionable UI over
-* stale data, like Geolocation's last fix); any other failure keeps the
-* list and notes the error. No media-devices API yields an empty stream
-* and a `Failed` scan instead of throwing.
-*/
 const MediaDevice = Schema.Struct({
 	deviceId: Schema.String,
 	groupId: Schema.String,
@@ -187,6 +179,14 @@ const MediaDevicesMessage = defineMessageUnion({
 const sameDevices = (a, b) => a.length === b.length && a.every((device, index) => device.deviceId === b[index].deviceId && device.groupId === b[index].groupId && device.kind === b[index].kind && device.label === b[index].label);
 const failMessage$2 = (error) => error instanceof Error ? error.message : String(error);
 const isDenied$1 = (error) => typeof error?.name === "string" && ["NotAllowedError", "SecurityError"].includes(error.name);
+/**
+* Media devices as a bundle factory: the enumerated device list in the
+* Model, scanned on placement and re-scanned on every `devicechange`.
+* Denial lands as `denied` while keeping the last list (actionable UI over
+* stale data, like Geolocation's last fix); any other failure keeps the
+* list and notes the error. No media-devices API yields an empty stream
+* and a `Failed` scan instead of throwing.
+*/
 const mediaDevices = (config) => {
 	const handle = () => {
 		if (typeof navigator === "undefined") return null;
@@ -255,20 +255,11 @@ const mediaDevices = (config) => {
 				lastError: message
 			}) })
 		}),
-		subscriptions: () => Subscription.make()(() => ({ changes: Subscription.persistent(changedStream()) }))
+		subscriptions: () => Subscription.make()(() => ({ changes: Subscription.persistentEntry(changedStream()) }))
 	});
 };
 //#endregion
 //#region src/device/media-stream.ts
-/**
-* A camera/mic stream as a bundle factory: one live MediaStream held in a
-* Managed Resource while the Model asks for it. `Started` requests,
-* `Stopped` releases; denial parks at `denied` (actionable UI), any other
-* acquire failure parks at `idle` with the error noted — both clear
-* requirements, so a failing device never spins an acquire loop. Release
-* stops every track. No media-devices API fails the acquire instead of
-* throwing.
-*/
 const MediaStreamModel = Schema.Struct({
 	status: Schema.Literals([
 		"idle",
@@ -290,6 +281,15 @@ const MediaStreamMessage = defineMessageUnion({
 const LiveStream = ManagedResource.tag()("media-stream");
 const failMessage$1 = (error) => error instanceof Error ? error.message : String(error);
 const isDenied = (error) => typeof error?.name === "string" && ["NotAllowedError", "SecurityError"].includes(error.name);
+/**
+* A camera/mic stream as a bundle factory: one live MediaStream held in a
+* Managed Resource while the Model asks for it. `Started` requests,
+* `Stopped` releases; denial parks at `denied` (actionable UI), any other
+* acquire failure parks at `idle` with the error noted — both clear
+* requirements, so a failing device never spins an acquire loop. Release
+* stops every track. No media-devices API fails the acquire instead of
+* throwing.
+*/
 const mediaStream = (config) => {
 	const request = (constraints) => {
 		if (config.request !== void 0) return config.request(constraints);
@@ -359,14 +359,6 @@ const mediaStream = (config) => {
 };
 //#endregion
 //#region src/device/permissions.ts
-/**
-* Permission states as a bundle factory: queried on placement, kept current
-* by each status object's `onchange`. A resource holds the status objects
-* (they cannot live in the Model); its queue feeds the subscription, and
-* release detaches every handler. An unknown permission name fails the
-* acquire; an unknown state string fails it too — both become `Failed`,
-* never Model facts.
-*/
 const PermissionState = Schema.Literals([
 	"granted",
 	"denied",
@@ -392,6 +384,14 @@ const readState = (state, name) => {
 	if (state !== "granted" && state !== "denied" && state !== "prompt") throw new Error(`unknown permission state for ${name}: ${state}`);
 	return state;
 };
+/**
+* Permission states as a bundle factory: queried on placement, kept current
+* by each status object's `onchange`. A resource holds the status objects
+* (they cannot live in the Model); its queue feeds the subscription, and
+* release detaches every handler. An unknown permission name fails the
+* acquire; an unknown state string fails it too — both become `Failed`,
+* never Model facts.
+*/
 const permissions = (config) => {
 	const handle = () => {
 		if (typeof navigator === "undefined") return null;
@@ -486,7 +486,7 @@ const permissions = (config) => {
 				}), Queue.shutdown(events)))
 			}) }));
 		},
-		subscriptions: () => Subscription.make()(() => ({ changes: Subscription.persistent(Stream.unwrap(Effect.matchEffect(Watch.get, {
+		subscriptions: () => Subscription.make()(() => ({ changes: Subscription.persistentEntry(Stream.unwrap(Effect.matchEffect(Watch.get, {
 			onFailure: () => Effect.succeed(Stream.empty),
 			onSuccess: ({ events }) => Effect.succeed(Stream.fromQueue(events))
 		}))) }))