foldkit-primitives 0.8.0 → 0.10.0

package/dist/device/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["failMessage","failMessage","isDenied","failMessage"],"sources":["../../src/device/fullscreen.ts","../../src/device/geolocation.ts","../../src/device/media-devices.ts","../../src/device/media-stream.ts","../../src/device/permissions.ts"],"sourcesContent":["/**\n * Fullscreen as Commands plus an entry — not a bundle, because the document\n * owns the state: `document.fullscreenElement` is the fact, and the entry\n * reports it as `Changed`. Commands yield `Entered`/`Exited` on success and\n * `Failed` otherwise (rejected request, missing API), so `update` handles\n * both outcomes as Messages.\n */\nimport { Effect, Schema, Stream } from 'effect'\nimport type { Command } from 'foldkit/command'\nimport { defineMessageUnion } from 'foldkit/message'\n\nexport const FullscreenMessage = defineMessageUnion({\n  Changed: { active: Schema.Boolean },\n  Entered: {},\n  Exited: {},\n  Failed: { message: Schema.String },\n})\nexport type FullscreenMessage = typeof FullscreenMessage.Type\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\n/**\n * Requests fullscreen for an element. The capability is feature-checked on\n * the element itself (SVG and HTML elements both qualify), falling back to\n * the legacy `webkit` prefix; a platform with neither yields `Failed`\n * instead of throwing.\n */\nexport const enterFullscreen = (element: Element): Command<FullscreenMessage, never, never> => ({\n  name: 'Fullscreen.enter',\n  args: {},\n  effect: Effect.matchEffect(\n    Effect.tryPromise({\n      try: () => {\n        const requestable = element as unknown as {\n          readonly requestFullscreen?: unknown\n          readonly webkitRequestFullscreen?: unknown\n        }\n        const request = requestable.requestFullscreen ?? requestable.webkitRequestFullscreen\n        if (typeof request !== 'function') {\n          throw new Error('fullscreen is unavailable')\n        }\n        return (request as () => Promise<void>).call(element)\n      },\n      catch: (error: unknown) => error,\n    }),\n    {\n      onFailure: error => Effect.succeed(FullscreenMessage.Failed({ message: failMessage(error) })),\n      onSuccess: () => Effect.succeed(FullscreenMessage.Entered()),\n    },\n  ),\n})\n\n/** Leaves fullscreen, with the same legacy fallback. Without a document API it yields `Failed`, not a throw. */\nexport const exitFullscreen = (): Command<FullscreenMessage, never, never> => ({\n  name: 'Fullscreen.exit',\n  args: {},\n  effect: Effect.matchEffect(\n    Effect.tryPromise({\n      try: () => {\n        if (typeof document === 'undefined') {\n          throw new Error('fullscreen is unavailable')\n        }\n        const api = document as unknown as {\n          readonly exitFullscreen?: unknown\n          readonly webkitExitFullscreen?: unknown\n        }\n        const exit = api.exitFullscreen ?? api.webkitExitFullscreen\n        if (typeof exit !== 'function') {\n          throw new Error('fullscreen is unavailable')\n        }\n        return (exit as () => Promise<void>).call(document)\n      },\n      catch: (error: unknown) => error,\n    }),\n    {\n      onFailure: error => Effect.succeed(FullscreenMessage.Failed({ message: failMessage(error) })),\n      onSuccess: () => Effect.succeed(FullscreenMessage.Exited()),\n    },\n  ),\n})\n\n/**\n * `Changed` whenever fullscreen state flips, starting with the current\n * answer. Without a document the stream is empty instead of throwing.\n */\nexport const fullscreenChanges = (): Stream.Stream<FullscreenMessage> => {\n  if (typeof document === 'undefined' || typeof document.addEventListener !== 'function') {\n    return Stream.empty\n  }\n  // Incomplete DOMs leave fullscreenElement undefined instead of null.\n  const isActive = (): boolean =>\n    document.fullscreenElement !== null && document.fullscreenElement !== undefined\n  return Stream.concat(\n    Stream.make(FullscreenMessage.Changed({ active: isActive() })),\n    Stream.fromEventListener(document, 'fullscreenchange').pipe(\n      Stream.map(() => FullscreenMessage.Changed({ active: isActive() })),\n    ),\n  )\n}\n","/**\n * Geolocation as a bundle: the device position in the Model, watched while\n * placed. Permission denial is its own status (actionable UI); transient\n * failures keep the last fix and note the error. No geolocation API yields\n * an empty stream instead of throwing.\n */\nimport { Effect, Queue, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as Subscription from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const Coordinates = Schema.Struct({\n  latitude: Schema.Number,\n  longitude: Schema.Number,\n  accuracy: Schema.Number,\n})\nexport type Coordinates = typeof Coordinates.Type\n\nexport const GeolocationModel = Schema.Struct({\n  status: Schema.Literals(['unknown', 'ready', 'denied']),\n  coords: Schema.NullOr(Coordinates),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type GeolocationModel = typeof GeolocationModel.Type\n\nexport const GeolocationMessage = defineMessageUnion({\n  Located: {\n    latitude: Schema.Number,\n    longitude: Schema.Number,\n    accuracy: Schema.Number,\n  },\n  Denied: {},\n  Failed: { message: Schema.String },\n})\nexport type GeolocationMessage = typeof GeolocationMessage.Type\n\ntype PositionCallback = (position: {\n  readonly coords: {\n    readonly latitude: number\n    readonly longitude: number\n    readonly accuracy: number\n  }\n}) => void\ntype ErrorCallback = (error: { readonly code: number; readonly message: string }) => void\n\nconst watchStream = (): Stream.Stream<GeolocationMessage> => {\n  if (\n    typeof navigator === 'undefined' ||\n    typeof navigator.geolocation?.watchPosition !== 'function'\n  ) {\n    return Stream.empty\n  }\n  const geolocation = navigator.geolocation\n  return Stream.unwrap(\n    Effect.gen(function* () {\n      const queue = yield* Queue.unbounded<GeolocationMessage>()\n      const onLocated: PositionCallback = position => {\n        Effect.runFork(\n          Queue.offer(\n            queue,\n            GeolocationMessage.Located({\n              latitude: position.coords.latitude,\n              longitude: position.coords.longitude,\n              accuracy: position.coords.accuracy,\n            }),\n          ),\n        )\n      }\n      const onError: ErrorCallback = error => {\n        Effect.runFork(\n          Queue.offer(\n            queue,\n            error.code === 1\n              ? GeolocationMessage.Denied()\n              : GeolocationMessage.Failed({ message: error.message }),\n          ),\n        )\n      }\n      const watchId = geolocation.watchPosition(onLocated, onError)\n      yield* Effect.addFinalizer(() => Effect.sync(() => geolocation.clearWatch(watchId)))\n      return Stream.fromQueue(queue)\n    }),\n  )\n}\n\nexport const Geolocation = Bundle.make<\n  'Geolocation',\n  GeolocationModel,\n  GeolocationMessage,\n  void,\n  never,\n  never,\n  never,\n  void,\n  {},\n  {}\n>('Geolocation', {\n  Model: GeolocationModel,\n  Message: GeolocationMessage,\n  init: () => ({ model: { status: 'unknown', coords: null, lastError: null } }),\n  update: (model, message) =>\n    GeolocationMessage.match<\n      Update.ReturnWithOutMessage<GeolocationModel, GeolocationMessage, never>\n    >(message, {\n      // A watch repeats a fix that has not moved.\n      Located: ({ latitude, longitude, accuracy }) =>\n        model.status === 'ready' &&\n        model.coords !== null &&\n        model.coords.latitude === latitude &&\n        model.coords.longitude === longitude &&\n        model.coords.accuracy === accuracy\n          ? { model }\n          : {\n              model: {\n                ...model,\n                status: 'ready' as const,\n                coords: { latitude, longitude, accuracy },\n              },\n            },\n      Denied: () => ({ model: unlessSame(model, { ...model, status: 'denied' }) }),\n      Failed: ({ message }) => ({ model: unlessSame(model, { ...model, lastError: message }) }),\n    }),\n  subscriptions: (): Subscription.Subscriptions<GeolocationModel, GeolocationMessage> =>\n    Subscription.make<GeolocationModel, GeolocationMessage>()(() => ({\n      watch: Subscription.persistent(watchStream()),\n    })),\n})\n","/**\n * Media devices as a bundle factory: the enumerated device list in the\n * Model, scanned on placement and re-scanned on every `devicechange`.\n * Denial lands as `denied` while keeping the last list (actionable UI over\n * stale data, like Geolocation's last fix); any other failure keeps the\n * list and notes the error. No media-devices API yields an empty stream\n * and a `Failed` scan instead of throwing.\n */\nimport { Effect, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as Subscription from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const MediaDevice = Schema.Struct({\n  deviceId: Schema.String,\n  groupId: Schema.String,\n  kind: Schema.Literals(['audioinput', 'audiooutput', 'videoinput']),\n  label: Schema.String,\n})\nexport type MediaDevice = typeof MediaDevice.Type\n\nexport const MediaDevicesModel = Schema.Struct({\n  status: Schema.Literals(['unknown', 'ready', 'denied']),\n  devices: Schema.Array(MediaDevice),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type MediaDevicesModel = typeof MediaDevicesModel.Type\n\nexport const MediaDevicesMessage = defineMessageUnion({\n  Scan: {},\n  DevicesChanged: {},\n  Refreshed: { devices: Schema.Array(MediaDevice) },\n  Denied: {},\n  Failed: { message: Schema.String },\n})\nexport type MediaDevicesMessage = typeof MediaDevicesMessage.Type\n\nconst sameDevices = (a: ReadonlyArray<MediaDevice>, b: ReadonlyArray<MediaDevice>): boolean =>\n  a.length === b.length &&\n  a.every(\n    (device, index) =>\n      device.deviceId === b[index]!.deviceId &&\n      device.groupId === b[index]!.groupId &&\n      device.kind === b[index]!.kind &&\n      device.label === b[index]!.label,\n  )\n\n/** The slice of MediaDevices the bundle needs; satisfied by the platform object. */\nexport interface MediaDevicesHandle {\n  enumerateDevices(): Promise<\n    ReadonlyArray<{\n      readonly deviceId: string\n      readonly groupId: string\n      readonly kind: string\n      readonly label: string\n    }>\n  >\n  addEventListener(type: string, listener: () => void): void\n  removeEventListener(type: string, listener: () => void): void\n}\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\nconst isDenied = (error: unknown): boolean =>\n  typeof (error as { readonly name?: unknown } | null)?.name === 'string' &&\n  ['NotAllowedError', 'SecurityError'].includes((error as { readonly name: string }).name)\n\nexport const mediaDevices = <const Name extends string>(config: {\n  readonly name: Name\n  /** Read lazily so tests can substitute a double, like the SSE bundle. */\n  readonly create?: ((navigator: Navigator) => MediaDevicesHandle | null) | undefined\n}) => {\n  const handle = (): MediaDevicesHandle | null => {\n    if (typeof navigator === 'undefined') return null\n    if (config.create !== undefined) return config.create(navigator)\n    const devices = navigator.mediaDevices as unknown as MediaDevicesHandle | undefined\n    return devices ?? null\n  }\n\n  const scanEffect = Effect.matchEffect(\n    Effect.tryPromise({\n      try: async () => {\n        const devices = handle()\n        if (devices === null) throw new Error('media devices are unavailable')\n        const listed = await devices.enumerateDevices()\n        // The platform constrains kind to three values; anything else is a\n        // boundary violation, so it fails the scan instead of entering the Model.\n        return listed.map(item => {\n          if (\n            item.kind !== 'audioinput' &&\n            item.kind !== 'audiooutput' &&\n            item.kind !== 'videoinput'\n          ) {\n            throw new Error(`unknown device kind: ${item.kind}`)\n          }\n          // Guarded by the check above: only the three platform kinds reach here.\n          return {\n            deviceId: item.deviceId,\n            groupId: item.groupId,\n            kind: item.kind as MediaDevice['kind'],\n            label: item.label,\n          }\n        })\n      },\n      catch: (error: unknown) => error,\n    }),\n    {\n      onFailure: error =>\n        Effect.succeed(\n          isDenied(error)\n            ? MediaDevicesMessage.Denied()\n            : MediaDevicesMessage.Failed({ message: failMessage(error) }),\n        ),\n      onSuccess: devices =>\n        Effect.succeed(MediaDevicesMessage.Refreshed({ devices: [...devices] })),\n    },\n  )\n\n  const scan = () => ({ name: `${config.name}.scan`, effect: scanEffect })\n\n  const changedStream = (): Stream.Stream<MediaDevicesMessage> => {\n    const devices = handle()\n    if (devices === null) return Stream.empty\n    // The handle carries only the slice the bundle needs, not the full\n    // EventTarget surface, so the listener attaches through a cast.\n    return Stream.fromEventListener(devices as unknown as EventTarget, 'devicechange').pipe(\n      Stream.map(() => MediaDevicesMessage.DevicesChanged()),\n    )\n  }\n\n  return Bundle.make<Name, MediaDevicesModel, MediaDevicesMessage>(config.name, {\n    Model: MediaDevicesModel,\n    Message: MediaDevicesMessage,\n    init: () => ({\n      model: { status: 'unknown', devices: [], lastError: null },\n      commands: [scan()],\n    }),\n    update: (model, message) =>\n      MediaDevicesMessage.match<\n        Update.ReturnWithOutMessage<MediaDevicesModel, MediaDevicesMessage, never>\n      >(message, {\n        Scan: () => ({ model, commands: [scan()] }),\n        DevicesChanged: () => ({ model, commands: [scan()] }),\n        // One plug-in fires several `devicechange`s, and each rescan finds the same list.\n        Refreshed: ({ devices }) =>\n          model.status === 'ready' && sameDevices(model.devices, devices)\n            ? { model }\n            : { model: { ...model, status: 'ready' as const, devices } },\n        Denied: () => ({ model: unlessSame(model, { ...model, status: 'denied' }) }),\n        Failed: ({ message }) => ({ model: unlessSame(model, { ...model, lastError: message }) }),\n      }),\n    subscriptions: (): Subscription.Subscriptions<MediaDevicesModel, MediaDevicesMessage> =>\n      Subscription.make<MediaDevicesModel, MediaDevicesMessage>()(() => ({\n        changes: Subscription.persistent(changedStream()),\n      })),\n  })\n}\n","/**\n * A camera/mic stream as a bundle factory: one live MediaStream held in a\n * Managed Resource while the Model asks for it. `Started` requests,\n * `Stopped` releases; denial parks at `denied` (actionable UI), any other\n * acquire failure parks at `idle` with the error noted — both clear\n * requirements, so a failing device never spins an acquire loop. Release\n * stops every track. No media-devices API fails the acquire instead of\n * throwing.\n */\nimport { Effect, Option, Schema } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as ManagedResource from 'foldkit/managedResource'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const MediaStreamModel = Schema.Struct({\n  status: Schema.Literals(['idle', 'requesting', 'live', 'denied']),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type MediaStreamModel = typeof MediaStreamModel.Type\n\nexport const MediaStreamMessage = defineMessageUnion({\n  Started: {},\n  Stopped: {},\n  Live: {},\n  Ended: {},\n  Denied: {},\n  Failed: { message: Schema.String },\n})\nexport type MediaStreamMessage = typeof MediaStreamMessage.Type\n\n/** A single media track: stopped on release. */\nexport interface MediaTrackHandle {\n  stop(): void\n}\n\n/** The live stream: its tracks stop on release. */\nexport interface MediaStreamHandle {\n  getTracks(): ReadonlyArray<MediaTrackHandle>\n}\n\nexport interface MediaStreamConstraints {\n  readonly audio: boolean\n  readonly video: boolean\n}\n\n/** The live stream, for commands that attach it to an element. One assembly holds one. */\nexport const LiveStream = ManagedResource.tag<MediaStreamHandle>()('media-stream')\n\n/** The stream service a placed camera requires. */\nexport type LiveStreamService = ManagedResource.ServiceOf<typeof LiveStream>\n\ntype StreamResources = Readonly<{\n  stream: ManagedResource.Entry<\n    MediaStreamModel,\n    MediaStreamMessage,\n    Option.Option<MediaStreamConstraints>,\n    MediaStreamHandle,\n    LiveStreamService,\n    () => MediaStreamMessage\n  >\n}>\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\nconst isDenied = (error: unknown): boolean =>\n  typeof (error as { readonly name?: unknown } | null)?.name === 'string' &&\n  ['NotAllowedError', 'SecurityError'].includes((error as { readonly name: string }).name)\n\nexport const mediaStream = <const Name extends string>(config: {\n  readonly name: Name\n  /** Read lazily so tests can substitute a double, like the SSE bundle. */\n  readonly request?:\n    ((constraints: MediaStreamConstraints) => Promise<MediaStreamHandle>) | undefined\n}) => {\n  const request = (constraints: MediaStreamConstraints): Promise<MediaStreamHandle> => {\n    if (config.request !== undefined) return config.request(constraints)\n    if (\n      typeof navigator === 'undefined' ||\n      typeof navigator.mediaDevices?.getUserMedia !== 'function'\n    ) {\n      return Promise.reject(new Error('media devices are unavailable'))\n    }\n    return navigator.mediaDevices.getUserMedia(constraints)\n  }\n\n  return Bundle.make(config.name, {\n    Model: MediaStreamModel,\n    Message: MediaStreamMessage,\n    args: Schema.Struct({ audio: Schema.Boolean, video: Schema.Boolean }),\n    init: () => ({ model: { status: 'idle' as const, lastError: null } }),\n    update: (model, message) =>\n      MediaStreamMessage.match<\n        Update.ReturnWithOutMessage<MediaStreamModel, MediaStreamMessage, never>\n      >(message, {\n        // Starting a live stream would wait at `requesting` for an acquire\n        // that never comes: the requirements are the same.\n        Started: () =>\n          model.status === 'requesting' || model.status === 'live'\n            ? { model }\n            : { model: { ...model, status: 'requesting' as const } },\n        Stopped: () => ({ model: unlessSame(model, { ...model, status: 'idle' }) }),\n        Live: () => ({ model: unlessSame(model, { ...model, status: 'live', lastError: null }) }),\n        // Stopping releases the stream, whose release reports it ended.\n        Ended: () => ({ model: unlessSame(model, { ...model, status: 'idle' }) }),\n        Denied: () => ({ model: unlessSame(model, { ...model, status: 'denied' }) }),\n        Failed: ({ message }) => ({\n          model: unlessSame(model, { ...model, status: 'idle', lastError: message }),\n        }),\n      }),\n    resources: args =>\n      ManagedResource.make<MediaStreamModel, MediaStreamMessage>()(entry => ({\n        stream: entry(\n          Schema.Option(Schema.Struct({ audio: Schema.Boolean, video: Schema.Boolean })),\n          {\n            resource: LiveStream,\n            modelToMaybeRequirements: model =>\n              model.status === 'requesting' || model.status === 'live'\n                ? Option.some({ audio: args.audio, video: args.video })\n                : Option.none(),\n            acquire: (constraints: MediaStreamConstraints) =>\n              Effect.tryPromise({\n                try: () => request(constraints),\n                catch: (error: unknown) => error,\n              }),\n            onAcquired: () => MediaStreamMessage.Live(),\n            onReleased: () => MediaStreamMessage.Ended(),\n            onAcquireError: error =>\n              isDenied(error)\n                ? MediaStreamMessage.Denied()\n                : MediaStreamMessage.Failed({ message: failMessage(error) }),\n            release: stream =>\n              Effect.sync(() => {\n                for (const track of stream.getTracks()) track.stop()\n              }),\n          },\n        ),\n      })),\n  })\n}\n","/**\n * Permission states as a bundle factory: queried on placement, kept current\n * by each status object's `onchange`. A resource holds the status objects\n * (they cannot live in the Model); its queue feeds the subscription, and\n * release detaches every handler. An unknown permission name fails the\n * acquire; an unknown state string fails it too — both become `Failed`,\n * never Model facts.\n */\nimport { Effect, Option, Queue, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as ManagedResource from 'foldkit/managedResource'\nimport * as Subscription from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const PermissionState = Schema.Literals(['granted', 'denied', 'prompt'])\nexport type PermissionState = typeof PermissionState.Type\n\nexport const PermissionsModel = Schema.Struct({\n  states: Schema.Record(Schema.String, PermissionState),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type PermissionsModel = typeof PermissionsModel.Type\n\nexport const PermissionsMessage = defineMessageUnion({\n  Snapshot: { states: Schema.Record(Schema.String, PermissionState) },\n  Changed: { name: Schema.String, state: PermissionState },\n  Cleared: {},\n  Failed: { message: Schema.String },\n})\nexport type PermissionsMessage = typeof PermissionsMessage.Type\n\n/** A queried permission status; `onchange` fires while watched. */\nexport interface PermissionStatusHandle {\n  readonly state: string\n  onchange: (() => void) | null\n}\n\n/** The slice of the Permissions API the bundle needs. */\nexport interface PermissionsHandle {\n  query(descriptor: { readonly name: string }): Promise<PermissionStatusHandle>\n}\n\ninterface Acquired {\n  readonly statuses: ReadonlyMap<string, PermissionStatusHandle>\n  readonly snapshot: Readonly<Record<string, PermissionState>>\n  readonly events: Queue.Queue<PermissionsMessage>\n}\n\n/** The watched statuses, for the changes subscription. One assembly holds one. */\nexport const Watch = ManagedResource.tag<Acquired>()('permissions')\n\n/** The watch service a placed Permissions bundle requires. */\nexport type WatchService = ManagedResource.ServiceOf<typeof Watch>\n\ntype WatchResources = Readonly<{\n  watch: ManagedResource.Entry<\n    PermissionsModel,\n    PermissionsMessage,\n    Option.Option<ReadonlyArray<string>>,\n    Acquired,\n    WatchService,\n    (acquired: Acquired) => PermissionsMessage\n  >\n}>\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\nconst readState = (state: string, name: string): PermissionState => {\n  if (state !== 'granted' && state !== 'denied' && state !== 'prompt') {\n    throw new Error(`unknown permission state for ${name}: ${state}`)\n  }\n  return state\n}\n\nexport const permissions = <const Name extends string>(config: {\n  readonly name: Name\n  /** Read lazily so tests can substitute a double, like the SSE bundle. */\n  readonly create?: ((navigator: Navigator) => PermissionsHandle | null) | undefined\n}) => {\n  const handle = (): PermissionsHandle | null => {\n    if (typeof navigator === 'undefined') return null\n    if (config.create !== undefined) return config.create(navigator)\n    const api = navigator.permissions as unknown as PermissionsHandle | undefined\n    return api ?? null\n  }\n\n  return Bundle.make<\n    Name,\n    PermissionsModel,\n    PermissionsMessage,\n    { readonly names: ReadonlyArray<string> },\n    never,\n    never,\n    WatchService,\n    void,\n    WatchResources,\n    {}\n  >(config.name, {\n    Model: PermissionsModel,\n    Message: PermissionsMessage,\n    args: Schema.Struct({ names: Schema.Array(Schema.String) }),\n    init: () => ({ model: { states: {}, lastError: null } }),\n    update: (model, message) =>\n      PermissionsMessage.match<\n        Update.ReturnWithOutMessage<PermissionsModel, PermissionsMessage, never>\n      >(message, {\n        Snapshot: ({ states }) => {\n          const next = unlessSame(model.states, { ...states })\n          return next === model.states ? { model } : { model: { ...model, states: next } }\n        },\n        Changed: ({ name, state }) =>\n          Object.hasOwn(model.states, name) && model.states[name] === state\n            ? { model }\n            : { model: { ...model, states: { ...model.states, [name]: state } } },\n        Cleared: () =>\n          Object.keys(model.states).length === 0 ? { model } : { model: { ...model, states: {} } },\n        Failed: ({ message }) => ({ model: unlessSame(model, { ...model, lastError: message }) }),\n      }),\n    resources: args => {\n      const names = Option.some([...new Set(args.names)])\n      return ManagedResource.make<PermissionsModel, PermissionsMessage>()(entry => ({\n        watch: entry(Schema.Option(Schema.Array(Schema.String)), {\n          resource: Watch,\n          modelToMaybeRequirements: () => names,\n          acquire: (names: ReadonlyArray<string>) =>\n            Effect.gen(function* () {\n              const api = handle()\n              if (api === null) throw new Error('permissions are unavailable')\n              const events = yield* Queue.unbounded<PermissionsMessage>()\n              const statuses = new Map<string, PermissionStatusHandle>()\n              // Offers run in arrival order; see the WebSocket bundle.\n              let tail: Promise<void> = Promise.resolve()\n              const offer = (message: PermissionsMessage) => {\n                const run = () =>\n                  Effect.runPromise(Queue.offer(events, message)).then(\n                    () => undefined,\n                    () => undefined,\n                  )\n                tail = tail.then(run, run)\n              }\n              // Two phases: query and validate everything first, so a later\n              // name failing cannot abandon handlers attached to earlier ones.\n              const queried: Array<readonly [string, PermissionStatusHandle, PermissionState]> = []\n              for (const name of names) {\n                const status = yield* Effect.tryPromise({\n                  try: () => api.query({ name }),\n                  catch: (error: unknown) => error,\n                })\n                queried.push([name, status, readState(status.state, name)] as const)\n              }\n              const snapshot: Record<string, PermissionState> = {}\n              for (const [name, status, state] of queried) {\n                status.onchange = () => {\n                  try {\n                    offer(\n                      PermissionsMessage.Changed({ name, state: readState(status.state, name) }),\n                    )\n                  } catch {\n                    // readState evaluates before offer runs, so a state the\n                    // schema rejects lands here instead of crashing the handler.\n                    offer(\n                      PermissionsMessage.Failed({\n                        message: `unknown permission state for ${name}`,\n                      }),\n                    )\n                  }\n                }\n                statuses.set(name, status)\n                snapshot[name] = state\n              }\n              return { statuses, snapshot, events }\n            }),\n          // The snapshot is captured during acquire, so onAcquired cannot\n          // throw re-reading a state that changed mid-acquire.\n          onAcquired: ({ snapshot }) => PermissionsMessage.Snapshot({ states: { ...snapshot } }),\n          onReleased: () => PermissionsMessage.Cleared(),\n          onAcquireError: error => PermissionsMessage.Failed({ message: failMessage(error) }),\n          release: ({ statuses, events }) =>\n            Effect.asVoid(\n              Effect.andThen(\n                Effect.sync(() => {\n                  for (const status of statuses.values()) status.onchange = null\n                }),\n                Queue.shutdown(events),\n              ),\n            ),\n        }),\n      }))\n    },\n    subscriptions: (): Subscription.Subscriptions<\n      PermissionsModel,\n      PermissionsMessage,\n      WatchService\n    > =>\n      Subscription.make<PermissionsModel, PermissionsMessage, WatchService>()(() => ({\n        // No model gate: the queue outlives every state change, and release\n        // ends the stream through teardown, not through dependencies.\n        changes: Subscription.persistent(\n          Stream.unwrap(\n            Effect.matchEffect(Watch.get, {\n              // Released between placement and attach: end quietly.\n              onFailure: () => Effect.succeed(Stream.empty),\n              onSuccess: ({ events }) => Effect.succeed(Stream.fromQueue(events)),\n            }),\n          ),\n        ),\n      })),\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["failMessage","failMessage","isDenied","failMessage"],"sources":["../../src/device/fullscreen.ts","../../src/device/geolocation.ts","../../src/device/media-devices.ts","../../src/device/media-stream.ts","../../src/device/permissions.ts"],"sourcesContent":["/**\n * Fullscreen as Commands plus an entry — not a bundle, because the document\n * owns the state: `document.fullscreenElement` is the fact, and the entry\n * reports it as `Changed`. Commands yield `Entered`/`Exited` on success and\n * `Failed` otherwise (rejected request, missing API), so `update` handles\n * both outcomes as Messages.\n */\nimport { Effect, Schema, Stream } from 'effect'\nimport type { Command } from 'foldkit/command'\nimport { defineMessageUnion } from 'foldkit/message'\n\nexport const FullscreenMessage = defineMessageUnion({\n  Changed: { active: Schema.Boolean },\n  Entered: {},\n  Exited: {},\n  Failed: { message: Schema.String },\n})\nexport type FullscreenMessage = typeof FullscreenMessage.Type\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\n/**\n * Requests fullscreen for an element. The capability is feature-checked on\n * the element itself (SVG and HTML elements both qualify), falling back to\n * the legacy `webkit` prefix; a platform with neither yields `Failed`\n * instead of throwing.\n */\nexport const enterFullscreen = (element: Element): Command<FullscreenMessage, never, never> => ({\n  name: 'Fullscreen.enter',\n  args: {},\n  effect: Effect.matchEffect(\n    Effect.tryPromise({\n      try: () => {\n        const requestable = element as unknown as {\n          readonly requestFullscreen?: unknown\n          readonly webkitRequestFullscreen?: unknown\n        }\n        const request = requestable.requestFullscreen ?? requestable.webkitRequestFullscreen\n        if (typeof request !== 'function') {\n          throw new Error('fullscreen is unavailable')\n        }\n        return (request as () => Promise<void>).call(element)\n      },\n      catch: (error: unknown) => error,\n    }),\n    {\n      onFailure: error => Effect.succeed(FullscreenMessage.Failed({ message: failMessage(error) })),\n      onSuccess: () => Effect.succeed(FullscreenMessage.Entered()),\n    },\n  ),\n})\n\n/** Leaves fullscreen, with the same legacy fallback. Without a document API it yields `Failed`, not a throw. */\nexport const exitFullscreen = (): Command<FullscreenMessage, never, never> => ({\n  name: 'Fullscreen.exit',\n  args: {},\n  effect: Effect.matchEffect(\n    Effect.tryPromise({\n      try: () => {\n        if (typeof document === 'undefined') {\n          throw new Error('fullscreen is unavailable')\n        }\n        const api = document as unknown as {\n          readonly exitFullscreen?: unknown\n          readonly webkitExitFullscreen?: unknown\n        }\n        const exit = api.exitFullscreen ?? api.webkitExitFullscreen\n        if (typeof exit !== 'function') {\n          throw new Error('fullscreen is unavailable')\n        }\n        return (exit as () => Promise<void>).call(document)\n      },\n      catch: (error: unknown) => error,\n    }),\n    {\n      onFailure: error => Effect.succeed(FullscreenMessage.Failed({ message: failMessage(error) })),\n      onSuccess: () => Effect.succeed(FullscreenMessage.Exited()),\n    },\n  ),\n})\n\n/**\n * `Changed` whenever fullscreen state flips, starting with the current\n * answer. Without a document the stream is empty instead of throwing.\n */\nexport const fullscreenChanges = (): Stream.Stream<FullscreenMessage> => {\n  if (typeof document === 'undefined' || typeof document.addEventListener !== 'function') {\n    return Stream.empty\n  }\n  // Incomplete DOMs leave fullscreenElement undefined instead of null.\n  const isActive = (): boolean =>\n    document.fullscreenElement !== null && document.fullscreenElement !== undefined\n  return Stream.concat(\n    Stream.make(FullscreenMessage.Changed({ active: isActive() })),\n    Stream.fromEventListener(document, 'fullscreenchange').pipe(\n      Stream.map(() => FullscreenMessage.Changed({ active: isActive() })),\n    ),\n  )\n}\n","import { Effect, Queue, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as Subscription from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const Coordinates = Schema.Struct({\n  latitude: Schema.Number,\n  longitude: Schema.Number,\n  accuracy: Schema.Number,\n})\nexport type Coordinates = typeof Coordinates.Type\n\nexport const GeolocationModel = Schema.Struct({\n  status: Schema.Literals(['unknown', 'ready', 'denied']),\n  coords: Schema.NullOr(Coordinates),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type GeolocationModel = typeof GeolocationModel.Type\n\nexport const GeolocationMessage = defineMessageUnion({\n  Located: {\n    latitude: Schema.Number,\n    longitude: Schema.Number,\n    accuracy: Schema.Number,\n  },\n  Denied: {},\n  Failed: { message: Schema.String },\n})\nexport type GeolocationMessage = typeof GeolocationMessage.Type\n\ntype PositionCallback = (position: {\n  readonly coords: {\n    readonly latitude: number\n    readonly longitude: number\n    readonly accuracy: number\n  }\n}) => void\ntype ErrorCallback = (error: { readonly code: number; readonly message: string }) => void\n\nconst watchStream = (): Stream.Stream<GeolocationMessage> => {\n  if (\n    typeof navigator === 'undefined' ||\n    typeof navigator.geolocation?.watchPosition !== 'function'\n  ) {\n    return Stream.empty\n  }\n  const geolocation = navigator.geolocation\n  return Stream.unwrap(\n    Effect.gen(function* () {\n      const queue = yield* Queue.unbounded<GeolocationMessage>()\n      const onLocated: PositionCallback = position => {\n        Effect.runFork(\n          Queue.offer(\n            queue,\n            GeolocationMessage.Located({\n              latitude: position.coords.latitude,\n              longitude: position.coords.longitude,\n              accuracy: position.coords.accuracy,\n            }),\n          ),\n        )\n      }\n      const onError: ErrorCallback = error => {\n        Effect.runFork(\n          Queue.offer(\n            queue,\n            error.code === 1\n              ? GeolocationMessage.Denied()\n              : GeolocationMessage.Failed({ message: error.message }),\n          ),\n        )\n      }\n      const watchId = geolocation.watchPosition(onLocated, onError)\n      yield* Effect.addFinalizer(() => Effect.sync(() => geolocation.clearWatch(watchId)))\n      return Stream.fromQueue(queue)\n    }),\n  )\n}\n\n/**\n * Geolocation as a bundle: the device position in the Model, watched while\n * placed. Permission denial is its own status (actionable UI); transient\n * failures keep the last fix and note the error. No geolocation API yields\n * an empty stream instead of throwing.\n */\nexport const Geolocation = Bundle.make<\n  'Geolocation',\n  GeolocationModel,\n  GeolocationMessage,\n  void,\n  never,\n  never,\n  never,\n  void,\n  {},\n  {}\n>('Geolocation', {\n  Model: GeolocationModel,\n  Message: GeolocationMessage,\n  init: () => ({ model: { status: 'unknown', coords: null, lastError: null } }),\n  update: (model, message) =>\n    GeolocationMessage.match<\n      Update.ReturnWithOutMessage<GeolocationModel, GeolocationMessage, never>\n    >(message, {\n      // A watch repeats a fix that has not moved.\n      Located: ({ latitude, longitude, accuracy }) =>\n        model.status === 'ready' &&\n        model.coords !== null &&\n        model.coords.latitude === latitude &&\n        model.coords.longitude === longitude &&\n        model.coords.accuracy === accuracy\n          ? { model }\n          : {\n              model: {\n                ...model,\n                status: 'ready' as const,\n                coords: { latitude, longitude, accuracy },\n              },\n            },\n      Denied: () => ({ model: unlessSame(model, { ...model, status: 'denied' }) }),\n      Failed: ({ message }) => ({ model: unlessSame(model, { ...model, lastError: message }) }),\n    }),\n  subscriptions: (): Subscription.Subscriptions<GeolocationModel, GeolocationMessage> =>\n    Subscription.make<GeolocationModel, GeolocationMessage>()(() => ({\n      watch: Subscription.persistentEntry(watchStream()),\n    })),\n})\n","import { Effect, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as Subscription from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const MediaDevice = Schema.Struct({\n  deviceId: Schema.String,\n  groupId: Schema.String,\n  kind: Schema.Literals(['audioinput', 'audiooutput', 'videoinput']),\n  label: Schema.String,\n})\nexport type MediaDevice = typeof MediaDevice.Type\n\nexport const MediaDevicesModel = Schema.Struct({\n  status: Schema.Literals(['unknown', 'ready', 'denied']),\n  devices: Schema.Array(MediaDevice),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type MediaDevicesModel = typeof MediaDevicesModel.Type\n\nexport const MediaDevicesMessage = defineMessageUnion({\n  Scan: {},\n  DevicesChanged: {},\n  Refreshed: { devices: Schema.Array(MediaDevice) },\n  Denied: {},\n  Failed: { message: Schema.String },\n})\nexport type MediaDevicesMessage = typeof MediaDevicesMessage.Type\n\nconst sameDevices = (a: ReadonlyArray<MediaDevice>, b: ReadonlyArray<MediaDevice>): boolean =>\n  a.length === b.length &&\n  a.every(\n    (device, index) =>\n      device.deviceId === b[index]!.deviceId &&\n      device.groupId === b[index]!.groupId &&\n      device.kind === b[index]!.kind &&\n      device.label === b[index]!.label,\n  )\n\n/** The slice of MediaDevices the bundle needs; satisfied by the platform object. */\nexport interface MediaDevicesHandle {\n  enumerateDevices(): Promise<\n    ReadonlyArray<{\n      readonly deviceId: string\n      readonly groupId: string\n      readonly kind: string\n      readonly label: string\n    }>\n  >\n  addEventListener(type: string, listener: () => void): void\n  removeEventListener(type: string, listener: () => void): void\n}\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\nconst isDenied = (error: unknown): boolean =>\n  typeof (error as { readonly name?: unknown } | null)?.name === 'string' &&\n  ['NotAllowedError', 'SecurityError'].includes((error as { readonly name: string }).name)\n\n/**\n * Media devices as a bundle factory: the enumerated device list in the\n * Model, scanned on placement and re-scanned on every `devicechange`.\n * Denial lands as `denied` while keeping the last list (actionable UI over\n * stale data, like Geolocation's last fix); any other failure keeps the\n * list and notes the error. No media-devices API yields an empty stream\n * and a `Failed` scan instead of throwing.\n */\nexport const mediaDevices = <const Name extends string>(config: {\n  readonly name: Name\n  /** Read lazily so tests can substitute a double, like the SSE bundle. */\n  readonly create?: ((navigator: Navigator) => MediaDevicesHandle | null) | undefined\n}) => {\n  const handle = (): MediaDevicesHandle | null => {\n    if (typeof navigator === 'undefined') return null\n    if (config.create !== undefined) return config.create(navigator)\n    const devices = navigator.mediaDevices as unknown as MediaDevicesHandle | undefined\n    return devices ?? null\n  }\n\n  const scanEffect = Effect.matchEffect(\n    Effect.tryPromise({\n      try: async () => {\n        const devices = handle()\n        if (devices === null) throw new Error('media devices are unavailable')\n        const listed = await devices.enumerateDevices()\n        // The platform constrains kind to three values; anything else is a\n        // boundary violation, so it fails the scan instead of entering the Model.\n        return listed.map(item => {\n          if (\n            item.kind !== 'audioinput' &&\n            item.kind !== 'audiooutput' &&\n            item.kind !== 'videoinput'\n          ) {\n            throw new Error(`unknown device kind: ${item.kind}`)\n          }\n          // Guarded by the check above: only the three platform kinds reach here.\n          return {\n            deviceId: item.deviceId,\n            groupId: item.groupId,\n            kind: item.kind as MediaDevice['kind'],\n            label: item.label,\n          }\n        })\n      },\n      catch: (error: unknown) => error,\n    }),\n    {\n      onFailure: error =>\n        Effect.succeed(\n          isDenied(error)\n            ? MediaDevicesMessage.Denied()\n            : MediaDevicesMessage.Failed({ message: failMessage(error) }),\n        ),\n      onSuccess: devices =>\n        Effect.succeed(MediaDevicesMessage.Refreshed({ devices: [...devices] })),\n    },\n  )\n\n  const scan = () => ({ name: `${config.name}.scan`, effect: scanEffect })\n\n  const changedStream = (): Stream.Stream<MediaDevicesMessage> => {\n    const devices = handle()\n    if (devices === null) return Stream.empty\n    // The handle carries only the slice the bundle needs, not the full\n    // EventTarget surface, so the listener attaches through a cast.\n    return Stream.fromEventListener(devices as unknown as EventTarget, 'devicechange').pipe(\n      Stream.map(() => MediaDevicesMessage.DevicesChanged()),\n    )\n  }\n\n  return Bundle.make<Name, MediaDevicesModel, MediaDevicesMessage>(config.name, {\n    Model: MediaDevicesModel,\n    Message: MediaDevicesMessage,\n    init: () => ({\n      model: { status: 'unknown', devices: [], lastError: null },\n      commands: [scan()],\n    }),\n    update: (model, message) =>\n      MediaDevicesMessage.match<\n        Update.ReturnWithOutMessage<MediaDevicesModel, MediaDevicesMessage, never>\n      >(message, {\n        Scan: () => ({ model, commands: [scan()] }),\n        DevicesChanged: () => ({ model, commands: [scan()] }),\n        // One plug-in fires several `devicechange`s, and each rescan finds the same list.\n        Refreshed: ({ devices }) =>\n          model.status === 'ready' && sameDevices(model.devices, devices)\n            ? { model }\n            : { model: { ...model, status: 'ready' as const, devices } },\n        Denied: () => ({ model: unlessSame(model, { ...model, status: 'denied' }) }),\n        Failed: ({ message }) => ({ model: unlessSame(model, { ...model, lastError: message }) }),\n      }),\n    subscriptions: (): Subscription.Subscriptions<MediaDevicesModel, MediaDevicesMessage> =>\n      Subscription.make<MediaDevicesModel, MediaDevicesMessage>()(() => ({\n        changes: Subscription.persistentEntry(changedStream()),\n      })),\n  })\n}\n","import { Effect, Option, Schema } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as ManagedResource from 'foldkit/managedResource'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const MediaStreamModel = Schema.Struct({\n  status: Schema.Literals(['idle', 'requesting', 'live', 'denied']),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type MediaStreamModel = typeof MediaStreamModel.Type\n\nexport const MediaStreamMessage = defineMessageUnion({\n  Started: {},\n  Stopped: {},\n  Live: {},\n  Ended: {},\n  Denied: {},\n  Failed: { message: Schema.String },\n})\nexport type MediaStreamMessage = typeof MediaStreamMessage.Type\n\n/** A single media track: stopped on release. */\nexport interface MediaTrackHandle {\n  stop(): void\n}\n\n/** The live stream: its tracks stop on release. */\nexport interface MediaStreamHandle {\n  getTracks(): ReadonlyArray<MediaTrackHandle>\n}\n\n/** Which tracks `mediaStream` asks `getUserMedia` for. */\nexport interface MediaStreamConstraints {\n  readonly audio: boolean\n  readonly video: boolean\n}\n\n/** The live stream, for commands that attach it to an element. One assembly holds one. */\nexport const LiveStream = ManagedResource.tag<MediaStreamHandle>()('media-stream')\n\n/** The stream service a placed camera requires. */\nexport type LiveStreamService = ManagedResource.ServiceOf<typeof LiveStream>\n\ntype StreamResources = Readonly<{\n  stream: ManagedResource.Entry<\n    MediaStreamModel,\n    MediaStreamMessage,\n    Option.Option<MediaStreamConstraints>,\n    MediaStreamHandle,\n    LiveStreamService,\n    () => MediaStreamMessage\n  >\n}>\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\nconst isDenied = (error: unknown): boolean =>\n  typeof (error as { readonly name?: unknown } | null)?.name === 'string' &&\n  ['NotAllowedError', 'SecurityError'].includes((error as { readonly name: string }).name)\n\n/**\n * A camera/mic stream as a bundle factory: one live MediaStream held in a\n * Managed Resource while the Model asks for it. `Started` requests,\n * `Stopped` releases; denial parks at `denied` (actionable UI), any other\n * acquire failure parks at `idle` with the error noted — both clear\n * requirements, so a failing device never spins an acquire loop. Release\n * stops every track. No media-devices API fails the acquire instead of\n * throwing.\n */\nexport const mediaStream = <const Name extends string>(config: {\n  readonly name: Name\n  /** Read lazily so tests can substitute a double, like the SSE bundle. */\n  readonly request?:\n    ((constraints: MediaStreamConstraints) => Promise<MediaStreamHandle>) | undefined\n}) => {\n  const request = (constraints: MediaStreamConstraints): Promise<MediaStreamHandle> => {\n    if (config.request !== undefined) return config.request(constraints)\n    if (\n      typeof navigator === 'undefined' ||\n      typeof navigator.mediaDevices?.getUserMedia !== 'function'\n    ) {\n      return Promise.reject(new Error('media devices are unavailable'))\n    }\n    return navigator.mediaDevices.getUserMedia(constraints)\n  }\n\n  return Bundle.make(config.name, {\n    Model: MediaStreamModel,\n    Message: MediaStreamMessage,\n    args: Schema.Struct({ audio: Schema.Boolean, video: Schema.Boolean }),\n    init: () => ({ model: { status: 'idle' as const, lastError: null } }),\n    update: (model, message) =>\n      MediaStreamMessage.match<\n        Update.ReturnWithOutMessage<MediaStreamModel, MediaStreamMessage, never>\n      >(message, {\n        // Starting a live stream would wait at `requesting` for an acquire\n        // that never comes: the requirements are the same.\n        Started: () =>\n          model.status === 'requesting' || model.status === 'live'\n            ? { model }\n            : { model: { ...model, status: 'requesting' as const } },\n        Stopped: () => ({ model: unlessSame(model, { ...model, status: 'idle' }) }),\n        Live: () => ({ model: unlessSame(model, { ...model, status: 'live', lastError: null }) }),\n        // Stopping releases the stream, whose release reports it ended.\n        Ended: () => ({ model: unlessSame(model, { ...model, status: 'idle' }) }),\n        Denied: () => ({ model: unlessSame(model, { ...model, status: 'denied' }) }),\n        Failed: ({ message }) => ({\n          model: unlessSame(model, { ...model, status: 'idle', lastError: message }),\n        }),\n      }),\n    resources: args =>\n      ManagedResource.make<MediaStreamModel, MediaStreamMessage>()(entry => ({\n        stream: entry(\n          Schema.Option(Schema.Struct({ audio: Schema.Boolean, video: Schema.Boolean })),\n          {\n            resource: LiveStream,\n            modelToMaybeRequirements: model =>\n              model.status === 'requesting' || model.status === 'live'\n                ? Option.some({ audio: args.audio, video: args.video })\n                : Option.none(),\n            acquire: (constraints: MediaStreamConstraints) =>\n              Effect.tryPromise({\n                try: () => request(constraints),\n                catch: (error: unknown) => error,\n              }),\n            onAcquired: () => MediaStreamMessage.Live(),\n            onReleased: () => MediaStreamMessage.Ended(),\n            onAcquireError: error =>\n              isDenied(error)\n                ? MediaStreamMessage.Denied()\n                : MediaStreamMessage.Failed({ message: failMessage(error) }),\n            release: stream =>\n              Effect.sync(() => {\n                for (const track of stream.getTracks()) track.stop()\n              }),\n          },\n        ),\n      })),\n  })\n}\n","import { Effect, Option, Queue, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as ManagedResource from 'foldkit/managedResource'\nimport * as Subscription from 'foldkit/subscription'\nimport type * as Update from 'foldkit/update'\nimport { Bundle } from 'foldkit-bundle'\nimport { unlessSame } from '../internal.js'\n\nexport const PermissionState = Schema.Literals(['granted', 'denied', 'prompt'])\nexport type PermissionState = typeof PermissionState.Type\n\nexport const PermissionsModel = Schema.Struct({\n  states: Schema.Record(Schema.String, PermissionState),\n  lastError: Schema.NullOr(Schema.String),\n})\nexport type PermissionsModel = typeof PermissionsModel.Type\n\nexport const PermissionsMessage = defineMessageUnion({\n  Snapshot: { states: Schema.Record(Schema.String, PermissionState) },\n  Changed: { name: Schema.String, state: PermissionState },\n  Cleared: {},\n  Failed: { message: Schema.String },\n})\nexport type PermissionsMessage = typeof PermissionsMessage.Type\n\n/** A queried permission status; `onchange` fires while watched. */\nexport interface PermissionStatusHandle {\n  readonly state: string\n  onchange: (() => void) | null\n}\n\n/** The slice of the Permissions API the bundle needs. */\nexport interface PermissionsHandle {\n  query(descriptor: { readonly name: string }): Promise<PermissionStatusHandle>\n}\n\ninterface Acquired {\n  readonly statuses: ReadonlyMap<string, PermissionStatusHandle>\n  readonly snapshot: Readonly<Record<string, PermissionState>>\n  readonly events: Queue.Queue<PermissionsMessage>\n}\n\n/** The watched statuses, for the changes subscription. One assembly holds one. */\nexport const Watch = ManagedResource.tag<Acquired>()('permissions')\n\n/** The watch service a placed Permissions bundle requires. */\nexport type WatchService = ManagedResource.ServiceOf<typeof Watch>\n\ntype WatchResources = Readonly<{\n  watch: ManagedResource.Entry<\n    PermissionsModel,\n    PermissionsMessage,\n    Option.Option<ReadonlyArray<string>>,\n    Acquired,\n    WatchService,\n    (acquired: Acquired) => PermissionsMessage\n  >\n}>\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\nconst readState = (state: string, name: string): PermissionState => {\n  if (state !== 'granted' && state !== 'denied' && state !== 'prompt') {\n    throw new Error(`unknown permission state for ${name}: ${state}`)\n  }\n  return state\n}\n\n/**\n * Permission states as a bundle factory: queried on placement, kept current\n * by each status object's `onchange`. A resource holds the status objects\n * (they cannot live in the Model); its queue feeds the subscription, and\n * release detaches every handler. An unknown permission name fails the\n * acquire; an unknown state string fails it too — both become `Failed`,\n * never Model facts.\n */\nexport const permissions = <const Name extends string>(config: {\n  readonly name: Name\n  /** Read lazily so tests can substitute a double, like the SSE bundle. */\n  readonly create?: ((navigator: Navigator) => PermissionsHandle | null) | undefined\n}) => {\n  const handle = (): PermissionsHandle | null => {\n    if (typeof navigator === 'undefined') return null\n    if (config.create !== undefined) return config.create(navigator)\n    const api = navigator.permissions as unknown as PermissionsHandle | undefined\n    return api ?? null\n  }\n\n  return Bundle.make<\n    Name,\n    PermissionsModel,\n    PermissionsMessage,\n    { readonly names: ReadonlyArray<string> },\n    never,\n    never,\n    WatchService,\n    void,\n    WatchResources,\n    {}\n  >(config.name, {\n    Model: PermissionsModel,\n    Message: PermissionsMessage,\n    args: Schema.Struct({ names: Schema.Array(Schema.String) }),\n    init: () => ({ model: { states: {}, lastError: null } }),\n    update: (model, message) =>\n      PermissionsMessage.match<\n        Update.ReturnWithOutMessage<PermissionsModel, PermissionsMessage, never>\n      >(message, {\n        Snapshot: ({ states }) => {\n          const next = unlessSame(model.states, { ...states })\n          return next === model.states ? { model } : { model: { ...model, states: next } }\n        },\n        Changed: ({ name, state }) =>\n          Object.hasOwn(model.states, name) && model.states[name] === state\n            ? { model }\n            : { model: { ...model, states: { ...model.states, [name]: state } } },\n        Cleared: () =>\n          Object.keys(model.states).length === 0 ? { model } : { model: { ...model, states: {} } },\n        Failed: ({ message }) => ({ model: unlessSame(model, { ...model, lastError: message }) }),\n      }),\n    resources: args => {\n      const names = Option.some([...new Set(args.names)])\n      return ManagedResource.make<PermissionsModel, PermissionsMessage>()(entry => ({\n        watch: entry(Schema.Option(Schema.Array(Schema.String)), {\n          resource: Watch,\n          modelToMaybeRequirements: () => names,\n          acquire: (names: ReadonlyArray<string>) =>\n            Effect.gen(function* () {\n              const api = handle()\n              if (api === null) throw new Error('permissions are unavailable')\n              const events = yield* Queue.unbounded<PermissionsMessage>()\n              const statuses = new Map<string, PermissionStatusHandle>()\n              // Offers run in arrival order; see the WebSocket bundle.\n              let tail: Promise<void> = Promise.resolve()\n              const offer = (message: PermissionsMessage) => {\n                const run = () =>\n                  Effect.runPromise(Queue.offer(events, message)).then(\n                    () => undefined,\n                    () => undefined,\n                  )\n                tail = tail.then(run, run)\n              }\n              // Two phases: query and validate everything first, so a later\n              // name failing cannot abandon handlers attached to earlier ones.\n              const queried: Array<readonly [string, PermissionStatusHandle, PermissionState]> = []\n              for (const name of names) {\n                const status = yield* Effect.tryPromise({\n                  try: () => api.query({ name }),\n                  catch: (error: unknown) => error,\n                })\n                queried.push([name, status, readState(status.state, name)] as const)\n              }\n              const snapshot: Record<string, PermissionState> = {}\n              for (const [name, status, state] of queried) {\n                status.onchange = () => {\n                  try {\n                    offer(\n                      PermissionsMessage.Changed({ name, state: readState(status.state, name) }),\n                    )\n                  } catch {\n                    // readState evaluates before offer runs, so a state the\n                    // schema rejects lands here instead of crashing the handler.\n                    offer(\n                      PermissionsMessage.Failed({\n                        message: `unknown permission state for ${name}`,\n                      }),\n                    )\n                  }\n                }\n                statuses.set(name, status)\n                snapshot[name] = state\n              }\n              return { statuses, snapshot, events }\n            }),\n          // The snapshot is captured during acquire, so onAcquired cannot\n          // throw re-reading a state that changed mid-acquire.\n          onAcquired: ({ snapshot }) => PermissionsMessage.Snapshot({ states: { ...snapshot } }),\n          onReleased: () => PermissionsMessage.Cleared(),\n          onAcquireError: error => PermissionsMessage.Failed({ message: failMessage(error) }),\n          release: ({ statuses, events }) =>\n            Effect.asVoid(\n              Effect.andThen(\n                Effect.sync(() => {\n                  for (const status of statuses.values()) status.onchange = null\n                }),\n                Queue.shutdown(events),\n              ),\n            ),\n        }),\n      }))\n    },\n    subscriptions: (): Subscription.Subscriptions<\n      PermissionsModel,\n      PermissionsMessage,\n      WatchService\n    > =>\n      Subscription.make<PermissionsModel, PermissionsMessage, WatchService>()(() => ({\n        // No model gate: the queue outlives every state change, and release\n        // ends the stream through teardown, not through dependencies.\n        changes: Subscription.persistentEntry(\n          Stream.unwrap(\n            Effect.matchEffect(Watch.get, {\n              // Released between placement and attach: end quietly.\n              onFailure: () => Effect.succeed(Stream.empty),\n              onSuccess: ({ events }) => Effect.succeed(Stream.fromQueue(events)),\n            }),\n          ),\n        ),\n      })),\n  })\n}\n"],"mappings":"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"}

package/dist/dom/index.d.mts

@@ -1,10 +1,18 @@
-import { A as ScrollLock, C as targetOf, D as MoveStarted, E as MoveEnded, M as tabbableWithin, O as Moved, S as Targets, T as Move, _ as boxOf, a as TextEdited, b as TargetHovered, c as DRAG_THRESHOLD, d as DragFact, f as DragPlace, g as PointerDrag, h as DraggedOver, i as TextCommitted, j as FocusScope, k as HideOutside, l as DragCancelled, m as DragZone, n as EditableText, o as TextFact, p as DragStarted, r as TextCancelled, s as textOf, t as EditAsked, u as DragDropped, v as zoneOf, w as Fact, x as TargetPressed, y as TargetFact } from "../editable-text-BbsPOATY.mjs";
+import { A as ScrollLock, C as targetOf, D as MoveStarted, E as MoveEnded, M as tabbableWithin, O as Moved, S as Targets, T as Move, _ as boxOf, a as TextEdited, b as TargetHovered, c as DRAG_THRESHOLD, d as DragFact, f as DragPlace, g as PointerDrag, h as DraggedOver, i as TextCommitted, j as FocusScope, k as HideOutside, l as DragCancelled, m as DragZone, n as EditableText, o as TextFact, p as DragStarted, r as TextCancelled, s as textOf, t as EditAsked, u as DragDropped, v as zoneOf, w as Fact, x as TargetPressed, y as TargetFact } from "../editable-text-Dvm-Fuqs.mjs";
 import { Schema, Stream } from "effect";
 import * as Mount from "foldkit/mount";
+import { Url } from "foldkit/url";
 import { Command } from "foldkit/command";
 //#region src/dom/autofocus.d.ts
 export declare const Focused: Schema.TaggedStruct<"Focused", {}>;
 export type Focused = typeof Focused.Type;
+/**
+ * Autofocus as a Mount: focuses the element on insert, then emits `Focused`.
+ * The message means focus was requested — a non-focusable element or a
+ * hidden tab may decline, and the browser does not report that. Plain
+ * `focus()`, no scroll options: scroll behavior stays the application's
+ * choice.
+ */
 export declare const Autofocus: Mount.MountDefinitionNoArgs<"Autofocus", {
   readonly _tag: "Focused";
 }>;
@@ -13,16 +21,16 @@ export declare const Autofocus: Mount.MountDefinitionNoArgs<"Autofocus", {
 export declare const ClipboardMessage: import("foldkit/message").MessageUnion<{
   readonly Copied: {};
   readonly CopyFailed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type ClipboardMessage = typeof ClipboardMessage.Type;
 export declare const ClipboardReadMessage: import("foldkit/message").MessageUnion<{
   readonly Read: {
-    readonly text: Schema.String;
+    text: Schema.String;
   };
   readonly ReadFailed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type ClipboardReadMessage = typeof ClipboardReadMessage.Type;
@@ -39,15 +47,31 @@ export declare const copyText: (text: string) => Command<ClipboardMessage, never
 export declare const readText: () => Command<ClipboardReadMessage, never, never>;
 //#endregion
 //#region src/dom/input-mask.d.ts
+/** What `InputMask` reports after each edit: the masked text shown, and the characters typed. */
 export declare const Input: Schema.TaggedStruct<"Input", {
   readonly value: Schema.String;
   readonly raw: Schema.String;
 }>;
 export type Input = typeof Input.Type;
+/**
+ * The mask as a pure function: `#` takes a digit, `A` a letter, `*` either, and
+ * any other character of the pattern is written in once input reaches past it.
+ * Input that fits no placeholder is skipped. `masked` is what the field shows;
+ * `raw` is only the characters typed.
+ */
 export declare const applyMask: (value: string, pattern: string) => {
   readonly masked: string;
   readonly raw: string;
 };
+/**
+ * An input mask as a Mount plus a pure mask function. The pattern language
+ * is three placeholders — `#` digit, `A` letter, `*` either, all ASCII —
+ * with every other character literal. Literals appear only once a later placeholder
+ * consumes input, so partial values never dangle a separator. The Mount
+ * rewrites the field, restores the caret approximately, and emits `Input`
+ * with both the masked and raw values; the parent owns the state, like any
+ * controlled input.
+ */
 export declare const InputMask: Mount.MountDefinitionWithArgs<"InputMask", {
   pattern: Schema.String;
 }, {
@@ -57,6 +81,15 @@ export declare const InputMask: Mount.MountDefinitionWithArgs<"InputMask", {
 }>;
 //#endregion
 //#region src/dom/keep-in-view.d.ts
+/**
+ * Keeps what is marked in view as a Mount: whenever an element in the mounted
+ * one's subtree newly matches `selector`, such as the row just selected in a
+ * list, it is scrolled into view the least amount that shows it (`nearest`).
+ * The element keeps its identity and its focus: nothing is redrawn to move it.
+ *
+ * It watches with a `MutationObserver` for as long as it is mounted, which is as
+ * long as the list or canvas that can change what is marked.
+ */
 export declare const KeepInView: Mount.MountDefinitionWithArgs<"KeepInView", {
   /** What is marked, as a selector within the element: `[aria-selected="true"]`. */
   selector: Schema.String;
@@ -66,7 +99,7 @@ export declare const KeepInView: Mount.MountDefinitionWithArgs<"KeepInView", {
 export declare const ScriptMessage: import("foldkit/message").MessageUnion<{
   readonly Loaded: {};
   readonly LoadFailed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type ScriptMessage = typeof ScriptMessage.Type;
@@ -84,7 +117,7 @@ export declare const ShareMessage: import("foldkit/message").MessageUnion<{
   readonly Shared: {};
   readonly Dismissed: {};
   readonly ShareFailed: {
-    readonly message: Schema.String;
+    message: Schema.String;
   };
 }>;
 export type ShareMessage = typeof ShareMessage.Type;
@@ -100,26 +133,43 @@ export declare const measured: (name: string) => {
   readonly h: `--fk-${string}-h`;
   readonly display: `--fk-${string}-display`;
 };
+/**
+ * Measures marked elements as a Mount, for a view to draw something over them,
+ * such as an editor's selection outline, with no Message and no Model: where
+ * an element is, is presentation, known to the DOM and to no transition.
+ *
+ * For each named target, the first element in the mounted one's subtree that
+ * matches its selector is measured relative to the mounted element's scroll
+ * box, which is what an absolutely placed child of it is laid out in. The
+ * mounted element gets `--fk-<name>-x`, `-y`, `-w` and `-h` in pixels, and
+ * `--fk-<name>-display`: `block` while a target is found, `none` while none is.
+ *
+ * It measures again when the subtree changes (a selection moves), in the
+ * frame the change is drawn in; and, at most once a frame, when the mounted
+ * element scrolls, the window resizes, the mounted element or a measured one
+ * changes size, an image or a font inside loads, and on every frame of a
+ * transition or an animation inside. What moves a target by any other way,
+ * such as a stylesheet added that shifts it without resizing it, is seen at
+ * the next of these.
+ */
 export declare const Measure: Mount.MountDefinitionWithArgs<"Measure", {
   /** Each target by name, as a selector within the element: `{ selected: '[aria-selected="true"]' }`. */
   targets: Schema.$Record<Schema.String, Schema.String>;
 }, never>;
 //#endregion
 //#region src/dom/follow-tab-stop.d.ts
+/**
+ * Keeps focus that is inside a container of roving tab stops on its stop, as a
+ * Mount: when a transition moves the stop (a row made current by a command the
+ * container did not see, such as a duplicate) or removes the focused
+ * descendant (a deleted row), focus goes to the descendant with
+ * `tabindex="0"`. It sends no Message. Focus outside the container is never
+ * taken, and focus the user moved away stays where it went.
+ */
 export declare const FollowTabStop: Mount.MountDefinitionNoArgs<"FollowTabStop", never>;
 //#endregion
 //#region src/dom/scroll.d.ts
-/** The part of the Navigation API used here: TypeScript's DOM library does not declare it yet. */
-interface Navigation extends EventTarget {
-  readonly currentEntry: {
-    readonly key: string;
-  } | null;
-}
-declare global {
-  interface Window {
-    readonly navigation?: Navigation;
-  }
-}
+/** How `keepScroll` remembers and restores each history entry's offset. */
 export interface KeepScrollOptions {
   /** The `sessionStorage` key holding entry offsets. Default `'foldkit:scroll'`. */
   readonly storageKey?: string | undefined;
@@ -135,9 +185,19 @@ export interface KeepScrollOptions {
  * Keeps the window's scroll across same-document navigations: a pushed entry
  * starts at the top, and Back, Forward or a reload return where that entry
  * was. Without a window the stream is empty instead of throwing. Lift with
- * `Subscription.persistent`; the stream sends no Messages.
+ * `Subscription.persistentEntry`; the stream sends no Messages.
  */
 export declare const keepScroll: (options?: KeepScrollOptions) => Stream.Stream<never>;
 //#endregion
+//#region src/dom/pointed-links.d.ts
+/**
+ * The address of the link a reader points at or tabs to, on the page's own
+ * origin: where they may go next, for a `Data.preload` before they go. Each
+ * link once while they stay on it, since crossing its text sends one event
+ * per element inside it. Without a document the stream is empty. Lift with
+ * `Subscription.persistentEntry`, mapping each address to a Message.
+ */
+export declare const pointedLinks: () => Stream.Stream<Url>;
+//#endregion
 export { DRAG_THRESHOLD, DragCancelled, DragDropped, DragFact, DragPlace, DragStarted, DragZone, DraggedOver, EditAsked, EditableText, Fact, FocusScope, HideOutside, Move, MoveEnded, MoveStarted, Moved, PointerDrag, ScrollLock, TargetFact, TargetHovered, TargetPressed, Targets, TextCancelled, TextCommitted, TextEdited, TextFact, boxOf, tabbableWithin, targetOf, textOf, zoneOf };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/dom/autofocus.ts","../../src/dom/clipboard.ts","../../src/dom/input-mask.ts","../../src/dom/keep-in-view.ts","../../src/dom/script-loader.ts","../../src/dom/share.ts","../../src/dom/measure.ts","../../src/dom/follow-tab-stop.ts","../../src/dom/scroll.ts"],"mappings":";;;;;qBAUa,SAAO,OAAA;YACR,iBAAiB,QAAQ;qBAExB,WAAS,MAAA;;;;;qBCJT,4CAAgB;;;sBAAhB,OAAA;;;YAID,0BAA0B,iBAAiB;qBAE1C,gDAAoB;;;;;;;;YAIrB,8BAA8B,qBAAqB;;;;;;qBAUlD,WAAY,iBAAe,QAAQ;;;;;qBAsBnC,gBAAe,QAAQ;;;qBCvCvB,OAAK,OAAA;;;;YAIN,eAAe,MAAM;qBA2BpB,YACX,eACA;WACY;WAAyB;;qBAoC1B,WAAS,MAAA;;;;;;;;;qBCtET,YAAU,MAAA;;;;;;qBCDV,yCAAa;;;sBAAb,OAAA;;;YAID,uBAAuB,cAAc;;qBASpC,aAAc,gBAAc,QAAQ;;;qBCbpC,WAAS,OAAA;;;;;YAKV,mBAAmB,UAAU;qBAE5B,wCAAY;;;;sBAAZ,OAAA;;;YAKD,sBAAsB,aAAa;;qBAUlC,QAAS,MAAM,cAAY,QAAQ;;;;qBCVnC,WAAY;;;;;;;qBASZ,SAAO,MAAA;;;;;;qBCrBP,eAAa,MAAA;;;;UCuBhB,mBAAmB;WAClB;aAAyB;;;QAE5B;YACI;aACC,aAAa;;;iBAIT;;WAEN;;WAEA;;;;;WAKA;;;;;;;;qBAqHE,aAAc,UAAS,sBAAyB,OAAO"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/dom/autofocus.ts","../../src/dom/clipboard.ts","../../src/dom/input-mask.ts","../../src/dom/keep-in-view.ts","../../src/dom/script-loader.ts","../../src/dom/share.ts","../../src/dom/measure.ts","../../src/dom/follow-tab-stop.ts","../../src/dom/scroll.ts","../../src/dom/pointed-links.ts"],"mappings":";;;;;;qBAGa,SAAO,OAAA;YACR,iBAAiB,QAAQ;;;;;;;;qBASxB,WAAS,MAAA;;;;;qBCJT,4CAAgB;;;IAEb,SAAO,OAAA;;;YAEX,0BAA0B,iBAAiB;qBAE1C,gDAAoB;;IACvB,MAAI,OAAA;;;IACE,SAAO,OAAA;;;YAEX,8BAA8B,qBAAqB;;;;;;qBAUlD,WAAQ,iBAAmB,QAAQ;;;;;qBAsBnC,gBAAe,QAAQ;;;;qBC/CvB,OAAK,OAAA;;;;YAIN,eAAe,MAAM;;;;;;;qBAiCpB,YAAS,eACP;WAED;WAAyB;;;;;;;;;;;qBA6C1B,WAAS,MAAA;WAAT,OAAA;;;;;;;;;;;;;;;;;qBC7EA,YAAU,MAAA;;YAAV,OAAA;;;;qBCDA,yCAAa;;;IAEV,SAAO,OAAA;;;YAEX,uBAAuB,cAAc;;qBASpC,aAAU,gBAAkB,QAAQ;;;qBCbpC,WAAS,OAAA;;;;;YAKV,mBAAmB,UAAU;qBAE5B,wCAAY;;;;IAGR,SAAO,OAAA;;;YAEZ,sBAAsB,aAAa;;qBAUlC,QAAK,MAAU,cAAY,QAAQ;;;;qBC7BnC,WAAQ;WAEjB;WACA;WACA;WACA;WACA;;;;;;;;;;;;;;;;;;;;;qBAsBS,SAAO,MAAA;;;;;;;;;;;;;;qBCrBP,eAAa,MAAA;;;;iBCuBT;;WAEN;;WAEA;;;;;WAKA;;;;;;;;qBAuHE,aAAU,UAAa,sBAAyB,OAAO;;;;;;;;;;qBCvJvD,oBAAmB,OAAO,OAAO"}

package/dist/dom/index.mjs

@@ -1,8 +1,11 @@
-import { C as MoveEnded, D as ScrollLock, E as HideOutside, O as FocusScope, S as Move, T as Moved, _ as zoneOf, a as TextCommitted, b as Targets, c as DRAG_THRESHOLD, d as DragPlace, f as DragStarted, g as boxOf, h as PointerDrag, i as TextCancelled, k as tabbableWithin, l as DragCancelled, m as DraggedOver, n as EditAsked, o as TextEdited, p as DragZone, r as EditableText, s as textOf, t as FollowTabStop, u as DragDropped, v as TargetHovered, w as MoveStarted, x as targetOf, y as TargetPressed } from "../follow-tab-stop-BDxyoUPQ.mjs";
+import { C as MoveEnded, D as ScrollLock, E as HideOutside, O as FocusScope, S as Move, T as Moved, _ as zoneOf, a as TextCommitted, b as Targets, c as DRAG_THRESHOLD, d as DragPlace, f as DragStarted, g as boxOf, h as PointerDrag, i as TextCancelled, k as tabbableWithin, l as DragCancelled, m as DraggedOver, n as EditAsked, o as TextEdited, p as DragZone, r as EditableText, s as textOf, t as FollowTabStop, u as DragDropped, v as TargetHovered, w as MoveStarted, x as targetOf, y as TargetPressed } from "../follow-tab-stop-Ci1tqAIW.mjs";
 import { Effect, Option, Queue, Schema, Stream } from "effect";
 import * as Mount from "foldkit/mount";
 import { defineMessageUnion } from "foldkit/message";
+import * as Dom from "foldkit/dom";
+import { fromString, toString } from "foldkit/url";
 //#region src/dom/autofocus.ts
+const Focused = Schema.TaggedStruct("Focused", {});
 /**
 * Autofocus as a Mount: focuses the element on insert, then emits `Focused`.
 * The message means focus was requested — a non-focusable element or a
@@ -10,7 +13,6 @@ import { defineMessageUnion } from "foldkit/message";
 * `focus()`, no scroll options: scroll behavior stays the application's
 * choice.
 */
-const Focused = Schema.TaggedStruct("Focused", {});
 const Autofocus = Mount.define("Autofocus", {
 	messages: [Focused],
 	execute: ({ element }) => Effect.sync(() => {
@@ -67,15 +69,7 @@ const readText = () => ({
 });
 //#endregion
 //#region src/dom/input-mask.ts
-/**
-* An input mask as a Mount plus a pure mask function. The pattern language
-* is three placeholders — `#` digit, `A` letter, `*` either, all ASCII —
-* with every other character literal. Literals appear only once a later placeholder
-* consumes input, so partial values never dangle a separator. The Mount
-* rewrites the field, restores the caret approximately, and emits `Input`
-* with both the masked and raw values; the parent owns the state, like any
-* controlled input.
-*/
+/** What `InputMask` reports after each edit: the masked text shown, and the characters typed. */
 const Input = Schema.TaggedStruct("Input", {
 	value: Schema.String,
 	raw: Schema.String
@@ -93,6 +87,12 @@ const fillable = (pattern, from, value, at) => {
 	}
 	return false;
 };
+/**
+* The mask as a pure function: `#` takes a digit, `A` a letter, `*` either, and
+* any other character of the pattern is written in once input reaches past it.
+* Input that fits no placeholder is skipped. `masked` is what the field shows;
+* `raw` is only the characters typed.
+*/
 const applyMask = (value, pattern) => {
 	let masked = "";
 	let raw = "";
@@ -117,6 +117,15 @@ const asField = (element) => {
 	const field = element;
 	return typeof field.value === "string" && typeof field.addEventListener === "function" ? field : null;
 };
+/**
+* An input mask as a Mount plus a pure mask function. The pattern language
+* is three placeholders — `#` digit, `A` letter, `*` either, all ASCII —
+* with every other character literal. Literals appear only once a later placeholder
+* consumes input, so partial values never dangle a separator. The Mount
+* rewrites the field, restores the caret approximately, and emits `Input`
+* with both the masked and raw values; the parent owns the state, like any
+* controlled input.
+*/
 const InputMask = Mount.defineStream("InputMask", {
 	messages: [Input],
 	args: { pattern: Schema.String },
@@ -267,6 +276,14 @@ const share = (data) => ({
 });
 //#endregion
 //#region src/dom/measure.ts
+/** The custom properties `Measure` writes for a target named `name`. */
+const measured = (name) => ({
+	x: `--fk-${name}-x`,
+	y: `--fk-${name}-y`,
+	w: `--fk-${name}-w`,
+	h: `--fk-${name}-h`,
+	display: `--fk-${name}-display`
+});
 /**
 * Measures marked elements as a Mount, for a view to draw something over them,
 * such as an editor's selection outline, with no Message and no Model: where
@@ -286,14 +303,6 @@ const share = (data) => ({
 * such as a stylesheet added that shifts it without resizing it, is seen at
 * the next of these.
 */
-/** The custom properties `Measure` writes for a target named `name`. */
-const measured = (name) => ({
-	x: `--fk-${name}-x`,
-	y: `--fk-${name}-y`,
-	w: `--fk-${name}-w`,
-	h: `--fk-${name}-h`,
-	display: `--fk-${name}-display`
-});
 const Measure = Mount.defineStream("Measure", {
 	messages: [Schema.Never],
 	args: { 
@@ -401,7 +410,7 @@ targets: Schema.Record(Schema.String, Schema.String) },
 *    the stream attaches nothing and leaves the browser's own behaviour
 *    alone.
 *
-* Lift with `Subscription.persistent`; the stream sends no Messages. Only
+* Lift with `Subscription.persistentEntry`; the stream sends no Messages. Only
 * the window scrolls: a nested container is the route graph's to know, when
 * `Site.transition` arrives.
 */
@@ -501,7 +510,7 @@ const attach = (storageKey, kept, patience) => {
 * Keeps the window's scroll across same-document navigations: a pushed entry
 * starts at the top, and Back, Forward or a reload return where that entry
 * was. Without a window the stream is empty instead of throwing. Lift with
-* `Subscription.persistent`; the stream sends no Messages.
+* `Subscription.persistentEntry`; the stream sends no Messages.
 */
 const keepScroll = (options = {}) => {
 	if (typeof window === "undefined") return Stream.empty;
@@ -511,6 +520,31 @@ const keepScroll = (options = {}) => {
 	return Stream.callback(() => Effect.acquireRelease(Effect.sync(() => attach(storageKey, kept, patience)), (detach) => Effect.sync(detach)));
 };
 //#endregion
-export { Autofocus, ClipboardMessage, ClipboardReadMessage, DRAG_THRESHOLD, DragCancelled, DragDropped, DragPlace, DragStarted, DragZone, DraggedOver, EditAsked, EditableText, FocusScope, Focused, FollowTabStop, HideOutside, Input, InputMask, KeepInView, Measure, Move, MoveEnded, MoveStarted, Moved, PointerDrag, ScriptMessage, ScrollLock, ShareData, ShareMessage, TargetHovered, TargetPressed, Targets, TextCancelled, TextCommitted, TextEdited, applyMask, boxOf, copyText, keepScroll, loadScript, measured, readText, share, tabbableWithin, targetOf, textOf, zoneOf };
+//#region src/dom/pointed-links.ts
+/**
+* The address of the link a reader points at or tabs to, on the page's own
+* origin: where they may go next, for a `Data.preload` before they go. Each
+* link once while they stay on it, since crossing its text sends one event
+* per element inside it. Without a document the stream is empty. Lift with
+* `Subscription.persistentEntry`, mapping each address to a Message.
+*/
+const pointedLinks = () => {
+	if (typeof document === "undefined") return Stream.empty;
+	const linkOf = (event) => {
+		const link = event.target instanceof Element ? event.target.closest("a[href]") : null;
+		return link instanceof HTMLAnchorElement && link.origin === window.location.origin ? fromString(link.href) : Option.none();
+	};
+	return Stream.merge(Dom.streamFromEventFilterMap({
+		target: document,
+		type: "pointerover",
+		filterMapEvent: linkOf
+	}), Dom.streamFromEventFilterMap({
+		target: document,
+		type: "focusin",
+		filterMapEvent: linkOf
+	})).pipe(Stream.changesWith((a, b) => toString(a) === toString(b)));
+};
+//#endregion
+export { Autofocus, ClipboardMessage, ClipboardReadMessage, DRAG_THRESHOLD, DragCancelled, DragDropped, DragPlace, DragStarted, DragZone, DraggedOver, EditAsked, EditableText, FocusScope, Focused, FollowTabStop, HideOutside, Input, InputMask, KeepInView, Measure, Move, MoveEnded, MoveStarted, Moved, PointerDrag, ScriptMessage, ScrollLock, ShareData, ShareMessage, TargetHovered, TargetPressed, Targets, TextCancelled, TextCommitted, TextEdited, applyMask, boxOf, copyText, keepScroll, loadScript, measured, pointedLinks, readText, share, tabbableWithin, targetOf, textOf, zoneOf };
 
 //# sourceMappingURL=index.mjs.map