foldkit-primitives 0.15.4 → 0.16.0

package/dist/device/fullscreen.d.ts

@@ -0,0 +1,28 @@
+import { Schema, Stream } from "effect";
+import { Command } from "foldkit/command";
+export declare const FullscreenMessage: import("foldkit/message").MessageUnion<{
+  readonly Changed: {
+    active: Schema.Boolean;
+  };
+  readonly Entered: {};
+  readonly Exited: {};
+  readonly Failed: {
+    message: Schema.String;
+  };
+}>;
+export type FullscreenMessage = typeof FullscreenMessage.Type;
+/**
+ * Requests fullscreen for an element. The capability is feature-checked on
+ * the element itself (SVG and HTML elements both qualify), falling back to
+ * the legacy `webkit` prefix; a platform with neither yields `Failed`
+ * instead of throwing.
+ */
+export declare const enterFullscreen: (element: Element) => Command<FullscreenMessage, never, never>;
+/** Leaves fullscreen, with the same legacy fallback. Without a document API it yields `Failed`, not a throw. */
+export declare const exitFullscreen: () => Command<FullscreenMessage, never, never>;
+/**
+ * `Changed` whenever fullscreen state flips, starting with the current
+ * answer. Without a document the stream is empty instead of throwing.
+ */
+export declare const fullscreenChanges: () => Stream.Stream<FullscreenMessage>;
+//# sourceMappingURL=fullscreen.d.ts.map

package/dist/device/fullscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullscreen.d.ts","names":[],"sources":["../../src/device/fullscreen.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"}

package/dist/device/fullscreen.js

@@ -0,0 +1,69 @@
+import { Effect, Schema, Stream } from "effect";
+import { defineMessageUnion } from "foldkit/message";
+// src/device/fullscreen.ts
+/**
+* Fullscreen as Commands plus an entry — not a bundle, because the document
+* owns the state: `document.fullscreenElement` is the fact, and the entry
+* reports it as `Changed`. Commands yield `Entered`/`Exited` on success and
+* `Failed` otherwise (rejected request, missing API), so `update` handles
+* both outcomes as Messages.
+*/
+const FullscreenMessage = defineMessageUnion({
+	Changed: { active: Schema.Boolean },
+	Entered: {},
+	Exited: {},
+	Failed: { message: Schema.String }
+});
+const failMessage = (error) => error instanceof Error ? error.message : String(error);
+/**
+* Requests fullscreen for an element. The capability is feature-checked on
+* the element itself (SVG and HTML elements both qualify), falling back to
+* the legacy `webkit` prefix; a platform with neither yields `Failed`
+* instead of throwing.
+*/
+const enterFullscreen = (element) => ({
+	name: "Fullscreen.enter",
+	args: {},
+	effect: Effect.matchEffect(Effect.tryPromise({
+		try: () => {
+			const requestable = element;
+			const request = requestable.requestFullscreen ?? requestable.webkitRequestFullscreen;
+			if (typeof request !== "function") throw new Error("fullscreen is unavailable");
+			return request.call(element);
+		},
+		catch: (error) => error
+	}), {
+		onFailure: (error) => Effect.succeed(FullscreenMessage.Failed({ message: failMessage(error) })),
+		onSuccess: () => Effect.succeed(FullscreenMessage.Entered())
+	})
+});
+/** Leaves fullscreen, with the same legacy fallback. Without a document API it yields `Failed`, not a throw. */
+const exitFullscreen = () => ({
+	name: "Fullscreen.exit",
+	args: {},
+	effect: Effect.matchEffect(Effect.tryPromise({
+		try: () => {
+			if (typeof document === "undefined") throw new Error("fullscreen is unavailable");
+			const api = document;
+			const exit = api.exitFullscreen ?? api.webkitExitFullscreen;
+			if (typeof exit !== "function") throw new Error("fullscreen is unavailable");
+			return exit.call(document);
+		},
+		catch: (error) => error
+	}), {
+		onFailure: (error) => Effect.succeed(FullscreenMessage.Failed({ message: failMessage(error) })),
+		onSuccess: () => Effect.succeed(FullscreenMessage.Exited())
+	})
+});
+/**
+* `Changed` whenever fullscreen state flips, starting with the current
+* answer. Without a document the stream is empty instead of throwing.
+*/
+const fullscreenChanges = () => {
+	if (typeof document === "undefined" || typeof document.addEventListener !== "function") return Stream.empty;
+	const isActive = () => document.fullscreenElement !== null && document.fullscreenElement !== void 0;
+	return Stream.concat(Stream.make(FullscreenMessage.Changed({ active: isActive() })), Stream.fromEventListener(document, "fullscreenchange").pipe(Stream.map(() => FullscreenMessage.Changed({ active: isActive() }))));
+};
+export { FullscreenMessage, enterFullscreen, exitFullscreen, fullscreenChanges };
+
+//# sourceMappingURL=fullscreen.js.map

package/dist/device/fullscreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullscreen.js","names":[],"sources":["../../src/device/fullscreen.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"],"mappings":";;;;;;;;;;AAWA,MAAa,oBAAoB,mBAAmB;CAClD,SAAS,EAAE,QAAQ,OAAO,QAAQ;CAClC,SAAS,CAAC;CACV,QAAQ,CAAC;CACT,QAAQ,EAAE,SAAS,OAAO,OAAO;AACnC,CAAC;AAGD,MAAM,eAAe,UACnB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;;;;;;;AAQvD,MAAa,mBAAmB,aAAgE;CAC9F,MAAM;CACN,MAAM,CAAC;CACP,QAAQ,OAAO,YACb,OAAO,WAAW;EAChB,WAAW;GACT,MAAM,cAAc;GAIpB,MAAM,UAAU,YAAY,qBAAqB,YAAY;GAC7D,IAAI,OAAO,YAAY,YACrB,MAAM,IAAI,MAAM,2BAA2B;GAE7C,OAAQ,QAAgC,KAAK,OAAO;EACtD;EACA,QAAQ,UAAmB;CAC7B,CAAC,GACD;EACE,YAAW,UAAS,OAAO,QAAQ,kBAAkB,OAAO,EAAE,SAAS,YAAY,KAAK,EAAE,CAAC,CAAC;EAC5F,iBAAiB,OAAO,QAAQ,kBAAkB,QAAQ,CAAC;CAC7D,CACF;AACF;;AAGA,MAAa,wBAAkE;CAC7E,MAAM;CACN,MAAM,CAAC;CACP,QAAQ,OAAO,YACb,OAAO,WAAW;EAChB,WAAW;GACT,IAAI,OAAO,aAAa,aACtB,MAAM,IAAI,MAAM,2BAA2B;GAE7C,MAAM,MAAM;GAIZ,MAAM,OAAO,IAAI,kBAAkB,IAAI;GACvC,IAAI,OAAO,SAAS,YAClB,MAAM,IAAI,MAAM,2BAA2B;GAE7C,OAAQ,KAA6B,KAAK,QAAQ;EACpD;EACA,QAAQ,UAAmB;CAC7B,CAAC,GACD;EACE,YAAW,UAAS,OAAO,QAAQ,kBAAkB,OAAO,EAAE,SAAS,YAAY,KAAK,EAAE,CAAC,CAAC;EAC5F,iBAAiB,OAAO,QAAQ,kBAAkB,OAAO,CAAC;CAC5D,CACF;AACF;;;;;AAMA,MAAa,0BAA4D;CACvE,IAAI,OAAO,aAAa,eAAe,OAAO,SAAS,qBAAqB,YAC1E,OAAO,OAAO;CAGhB,MAAM,iBACJ,SAAS,sBAAsB,QAAQ,SAAS,sBAAsB,KAAA;CACxE,OAAO,OAAO,OACZ,OAAO,KAAK,kBAAkB,QAAQ,EAAE,QAAQ,SAAS,EAAE,CAAC,CAAC,GAC7D,OAAO,kBAAkB,UAAU,kBAAkB,CAAC,CAAC,KACrD,OAAO,UAAU,kBAAkB,QAAQ,EAAE,QAAQ,SAAS,EAAE,CAAC,CAAC,CACpE,CACF;AACF"}

package/dist/device/geolocation.d.ts

@@ -0,0 +1,56 @@
+import { Option, Schema } from "effect";
+import { Bundle } from "foldkit-bundle";
+export declare const Coordinates: Schema.Struct<{
+  readonly latitude: Schema.Number;
+  readonly longitude: Schema.Number;
+  readonly accuracy: Schema.Number;
+}>;
+export type Coordinates = typeof Coordinates.Type;
+export declare const GeolocationModel: Schema.Struct<{
+  readonly status: Schema.Literals<readonly ["unknown", "ready", "denied"]>;
+  readonly coords: Schema.OptionFromNullOr<Schema.Struct<{
+    readonly latitude: Schema.Number;
+    readonly longitude: Schema.Number;
+    readonly accuracy: Schema.Number;
+  }>>;
+  readonly lastError: Schema.OptionFromNullOr<Schema.String>;
+}>;
+export type GeolocationModel = typeof GeolocationModel.Type;
+export declare const GeolocationMessage: import("foldkit/message").MessageUnion<{
+  readonly Located: {
+    latitude: Schema.Number;
+    longitude: Schema.Number;
+    accuracy: Schema.Number;
+  };
+  readonly Denied: {};
+  readonly Failed: {
+    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: "denied" | "ready" | "unknown";
+  readonly coords: Option.Option<{
+    readonly latitude: number;
+    readonly longitude: number;
+    readonly accuracy: number;
+  }>;
+  readonly lastError: Option.Option<string>;
+}, {
+  readonly _tag: "Denied";
+} | {
+  readonly _tag: "Failed";
+  readonly message: string;
+} | {
+  readonly _tag: "Located";
+  readonly latitude: number;
+  readonly longitude: number;
+  readonly accuracy: number;
+}, never, never, never, void, {}, {}>;
+//# sourceMappingURL=geolocation.d.ts.map

package/dist/device/geolocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.d.ts","names":[],"sources":["../../src/device/geolocation.ts"],"mappings":";;qBAOa,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"}

package/dist/device/geolocation.js

@@ -0,0 +1,87 @@
+import { Effect, Option, Queue, Schema, Stream } from "effect";
+import { defineMessageUnion } from "foldkit/message";
+import * as Subscription from "foldkit/subscription";
+import { Bundle } from "foldkit-bundle";
+import { unlessSame } from "../internal.js";
+// src/device/geolocation.ts
+const Coordinates = Schema.Struct({
+	latitude: Schema.Number,
+	longitude: Schema.Number,
+	accuracy: Schema.Number
+});
+const GeolocationModel = Schema.Struct({
+	status: Schema.Literals([
+		"unknown",
+		"ready",
+		"denied"
+	]),
+	coords: Schema.OptionFromNullOr(Coordinates),
+	lastError: Schema.OptionFromNullOr(Schema.String)
+});
+const GeolocationMessage = defineMessageUnion({
+	Located: {
+		latitude: Schema.Number,
+		longitude: Schema.Number,
+		accuracy: Schema.Number
+	},
+	Denied: {},
+	Failed: { message: Schema.String }
+});
+const watchStream = () => {
+	if (typeof navigator === "undefined" || typeof navigator.geolocation?.watchPosition !== "function") return Stream.empty;
+	const geolocation = navigator.geolocation;
+	return Stream.unwrap(Effect.gen(function* () {
+		const queue = yield* Queue.unbounded();
+		const onLocated = (position) => {
+			Effect.runFork(Queue.offer(queue, GeolocationMessage.Located({
+				latitude: position.coords.latitude,
+				longitude: position.coords.longitude,
+				accuracy: position.coords.accuracy
+			})));
+		};
+		const onError = (error) => {
+			Effect.runFork(Queue.offer(queue, error.code === 1 ? GeolocationMessage.Denied() : GeolocationMessage.Failed({ message: error.message })));
+		};
+		const watchId = geolocation.watchPosition(onLocated, onError);
+		yield* Effect.addFinalizer(() => Effect.sync(() => geolocation.clearWatch(watchId)));
+		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,
+	init: () => ({ model: {
+		status: "unknown",
+		coords: Option.none(),
+		lastError: Option.none()
+	} }),
+	update: (model, message) => GeolocationMessage.match(message, {
+		Located: ({ latitude, longitude, accuracy }) => model.status === "ready" && Option.exists(model.coords, (coords) => coords.latitude === latitude && coords.longitude === longitude && coords.accuracy === accuracy) ? { model } : { model: {
+			...model,
+			status: "ready",
+			coords: Option.some({
+				latitude,
+				longitude,
+				accuracy
+			})
+		} },
+		Denied: () => ({ model: unlessSame(model, {
+			...model,
+			status: "denied"
+		}) }),
+		Failed: ({ message }) => ({ model: unlessSame(model, {
+			...model,
+			lastError: Option.some(message)
+		}) })
+	}),
+	subscriptions: () => Subscription.make()(() => ({ watch: Subscription.persistentEntry(watchStream()) }))
+});
+export { Coordinates, Geolocation, GeolocationMessage, GeolocationModel };
+
+//# sourceMappingURL=geolocation.js.map

package/dist/device/geolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.js","names":[],"sources":["../../src/device/geolocation.ts"],"sourcesContent":["import { Effect, Option, 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.OptionFromNullOr(Coordinates),\n  lastError: Schema.OptionFromNullOr(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('Geolocation', {\n  Model: GeolocationModel,\n  Message: GeolocationMessage,\n  init: () => ({ model: { status: 'unknown', coords: Option.none(), lastError: Option.none() } }),\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        Option.exists(\n          model.coords,\n          coords =>\n            coords.latitude === latitude &&\n            coords.longitude === longitude &&\n            coords.accuracy === accuracy,\n        )\n          ? { model }\n          : {\n              model: {\n                ...model,\n                status: 'ready' as const,\n                coords: Option.some({ latitude, longitude, accuracy }),\n              },\n            },\n      Denied: () => ({ model: unlessSame(model, { ...model, status: 'denied' }) }),\n      Failed: ({ message }) => ({\n        model: unlessSame(model, { ...model, lastError: Option.some(message) }),\n      }),\n    }),\n  subscriptions: (): Subscription.Subscriptions<GeolocationModel, GeolocationMessage> =>\n    Subscription.make<GeolocationModel, GeolocationMessage>()(() => ({\n      watch: Subscription.persistentEntry(watchStream()),\n    })),\n})\n"],"mappings":";;;;;;AAOA,MAAa,cAAc,OAAO,OAAO;CACvC,UAAU,OAAO;CACjB,WAAW,OAAO;CAClB,UAAU,OAAO;AACnB,CAAC;AAGD,MAAa,mBAAmB,OAAO,OAAO;CAC5C,QAAQ,OAAO,SAAS;EAAC;EAAW;EAAS;CAAQ,CAAC;CACtD,QAAQ,OAAO,iBAAiB,WAAW;CAC3C,WAAW,OAAO,iBAAiB,OAAO,MAAM;AAClD,CAAC;AAGD,MAAa,qBAAqB,mBAAmB;CACnD,SAAS;EACP,UAAU,OAAO;EACjB,WAAW,OAAO;EAClB,UAAU,OAAO;CACnB;CACA,QAAQ,CAAC;CACT,QAAQ,EAAE,SAAS,OAAO,OAAO;AACnC,CAAC;AAYD,MAAM,oBAAuD;CAC3D,IACE,OAAO,cAAc,eACrB,OAAO,UAAU,aAAa,kBAAkB,YAEhD,OAAO,OAAO;CAEhB,MAAM,cAAc,UAAU;CAC9B,OAAO,OAAO,OACZ,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,OAAO,MAAM,UAA8B;EACzD,MAAM,aAA8B,aAAY;GAC9C,OAAO,QACL,MAAM,MACJ,OACA,mBAAmB,QAAQ;IACzB,UAAU,SAAS,OAAO;IAC1B,WAAW,SAAS,OAAO;IAC3B,UAAU,SAAS,OAAO;GAC5B,CAAC,CACH,CACF;EACF;EACA,MAAM,WAAyB,UAAS;GACtC,OAAO,QACL,MAAM,MACJ,OACA,MAAM,SAAS,IACX,mBAAmB,OAAO,IAC1B,mBAAmB,OAAO,EAAE,SAAS,MAAM,QAAQ,CAAC,CAC1D,CACF;EACF;EACA,MAAM,UAAU,YAAY,cAAc,WAAW,OAAO;EAC5D,OAAO,OAAO,mBAAmB,OAAO,WAAW,YAAY,WAAW,OAAO,CAAC,CAAC;EACnF,OAAO,OAAO,UAAU,KAAK;CAC/B,CAAC,CACH;AACF;;;;;;;AAQA,MAAa,cAAc,OAAO,KAAK,eAAe;CACpD,OAAO;CACP,SAAS;CACT,aAAa,EAAE,OAAO;EAAE,QAAQ;EAAW,QAAQ,OAAO,KAAK;EAAG,WAAW,OAAO,KAAK;CAAE,EAAE;CAC7F,SAAS,OAAO,YACd,mBAAmB,MAEjB,SAAS;EAET,UAAU,EAAE,UAAU,WAAW,eAC/B,MAAM,WAAW,WACjB,OAAO,OACL,MAAM,SACN,WACE,OAAO,aAAa,YACpB,OAAO,cAAc,aACrB,OAAO,aAAa,QACxB,IACI,EAAE,MAAM,IACR,EACE,OAAO;GACL,GAAG;GACH,QAAQ;GACR,QAAQ,OAAO,KAAK;IAAE;IAAU;IAAW;GAAS,CAAC;EACvD,EACF;EACN,eAAe,EAAE,OAAO,WAAW,OAAO;GAAE,GAAG;GAAO,QAAQ;EAAS,CAAC,EAAE;EAC1E,SAAS,EAAE,eAAe,EACxB,OAAO,WAAW,OAAO;GAAE,GAAG;GAAO,WAAW,OAAO,KAAK,OAAO;EAAE,CAAC,EACxE;CACF,CAAC;CACH,qBACE,aAAa,KAA2C,CAAC,QAAQ,EAC/D,OAAO,aAAa,gBAAgB,YAAY,CAAC,EACnD,EAAE;AACN,CAAC"}

package/dist/device/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./fullscreen.js";
+export * from "./geolocation.js";
+export * from "./media-devices.js";
+export * from "./media-stream.js";
+export * from "./permissions.js";

package/dist/device/index.js

@@ -0,0 +1,6 @@
+export * from "./fullscreen.js";
+export * from "./geolocation.js";
+export * from "./media-devices.js";
+export * from "./media-stream.js";
+export * from "./permissions.js";
+export {};

package/dist/device/media-devices.d.ts

@@ -0,0 +1,88 @@
+import { Option, Schema } from "effect";
+import { Bundle } from "foldkit-bundle";
+export declare const MediaDevice: Schema.Struct<{
+  readonly deviceId: Schema.String;
+  readonly groupId: Schema.String;
+  readonly kind: Schema.Literals<readonly ["audioinput", "audiooutput", "videoinput"]>;
+  readonly label: Schema.String;
+}>;
+export type MediaDevice = typeof MediaDevice.Type;
+export declare const MediaDevicesModel: Schema.Struct<{
+  readonly status: Schema.Literals<readonly ["unknown", "ready", "denied"]>;
+  readonly devices: Schema.$Array<Schema.Struct<{
+    readonly deviceId: Schema.String;
+    readonly groupId: Schema.String;
+    readonly kind: Schema.Literals<readonly ["audioinput", "audiooutput", "videoinput"]>;
+    readonly label: Schema.String;
+  }>>;
+  readonly lastError: Schema.OptionFromNullOr<Schema.String>;
+}>;
+export type MediaDevicesModel = typeof MediaDevicesModel.Type;
+export declare const MediaDevicesMessage: import("foldkit/message").MessageUnion<{
+  readonly Scan: {};
+  readonly DevicesChanged: {};
+  readonly Refreshed: {
+    devices: Schema.$Array<Schema.Struct<{
+      readonly deviceId: Schema.String;
+      readonly groupId: Schema.String;
+      readonly kind: Schema.Literals<readonly ["audioinput", "audiooutput", "videoinput"]>;
+      readonly label: Schema.String;
+    }>>;
+  };
+  readonly Denied: {};
+  readonly Failed: {
+    message: Schema.String;
+  };
+}>;
+export type MediaDevicesMessage = typeof MediaDevicesMessage.Type;
+/** The slice of MediaDevices the bundle needs; satisfied by the platform object. */
+export interface MediaDevicesHandle {
+  enumerateDevices(): Promise<ReadonlyArray<{
+    readonly deviceId: string;
+    readonly groupId: string;
+    readonly kind: string;
+    readonly label: string;
+  }>>;
+  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: "denied" | "ready" | "unknown";
+  readonly devices: readonly {
+    readonly deviceId: string;
+    readonly groupId: string;
+    readonly kind: "audioinput" | "audiooutput" | "videoinput";
+    readonly label: string;
+  }[];
+  readonly lastError: Option.Option<string>;
+}, {
+  readonly _tag: "Denied";
+} | {
+  readonly _tag: "DevicesChanged";
+} | {
+  readonly _tag: "Failed";
+  readonly message: string;
+} | {
+  readonly _tag: "Refreshed";
+  readonly devices: readonly {
+    readonly deviceId: string;
+    readonly groupId: string;
+    readonly kind: "audioinput" | "audiooutput" | "videoinput";
+    readonly label: string;
+  }[];
+} | {
+  readonly _tag: "Scan";
+}, never, never, never, void, {}, {}>;
+//# sourceMappingURL=media-devices.d.ts.map

package/dist/device/media-devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-devices.d.ts","names":[],"sources":["../../src/device/media-devices.ts"],"mappings":";;qBAOa,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"}

package/dist/device/media-devices.js

@@ -0,0 +1,117 @@
+import { Effect, Option, Schema, Stream } from "effect";
+import { defineMessageUnion } from "foldkit/message";
+import * as Subscription from "foldkit/subscription";
+import { Bundle } from "foldkit-bundle";
+import { unlessSame } from "../internal.js";
+// src/device/media-devices.ts
+const MediaDevice = Schema.Struct({
+	deviceId: Schema.String,
+	groupId: Schema.String,
+	kind: Schema.Literals([
+		"audioinput",
+		"audiooutput",
+		"videoinput"
+	]),
+	label: Schema.String
+});
+const MediaDevicesModel = Schema.Struct({
+	status: Schema.Literals([
+		"unknown",
+		"ready",
+		"denied"
+	]),
+	devices: Schema.Array(MediaDevice),
+	lastError: Schema.OptionFromNullOr(Schema.String)
+});
+const MediaDevicesMessage = defineMessageUnion({
+	Scan: {},
+	DevicesChanged: {},
+	Refreshed: { devices: Schema.Array(MediaDevice) },
+	Denied: {},
+	Failed: { message: Schema.String }
+});
+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 = (error) => error instanceof Error ? error.message : String(error);
+const isDenied = (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;
+		if (config.create !== void 0) return config.create(navigator);
+		return navigator.mediaDevices ?? null;
+	};
+	const scanEffect = Effect.matchEffect(Effect.tryPromise({
+		try: async () => {
+			const devices = handle();
+			if (devices === null) throw new Error("media devices are unavailable");
+			return (await devices.enumerateDevices()).map((item) => {
+				if (item.kind !== "audioinput" && item.kind !== "audiooutput" && item.kind !== "videoinput") throw new Error(`unknown device kind: ${item.kind}`);
+				return {
+					deviceId: item.deviceId,
+					groupId: item.groupId,
+					kind: item.kind,
+					label: item.label
+				};
+			});
+		},
+		catch: (error) => error
+	}), {
+		onFailure: (error) => Effect.succeed(isDenied(error) ? MediaDevicesMessage.Denied() : MediaDevicesMessage.Failed({ message: failMessage(error) })),
+		onSuccess: (devices) => Effect.succeed(MediaDevicesMessage.Refreshed({ devices: [...devices] }))
+	});
+	const scan = () => ({
+		name: `${config.name}.scan`,
+		effect: scanEffect
+	});
+	const changedStream = () => {
+		const devices = handle();
+		if (devices === null) return Stream.empty;
+		return Stream.fromEventListener(devices, "devicechange").pipe(Stream.map(() => MediaDevicesMessage.DevicesChanged()));
+	};
+	return Bundle.make(config.name, {
+		Model: MediaDevicesModel,
+		Message: MediaDevicesMessage,
+		init: () => ({
+			model: {
+				status: "unknown",
+				devices: [],
+				lastError: Option.none()
+			},
+			commands: [scan()]
+		}),
+		update: (model, message) => MediaDevicesMessage.match(message, {
+			Scan: () => ({
+				model,
+				commands: [scan()]
+			}),
+			DevicesChanged: () => ({
+				model,
+				commands: [scan()]
+			}),
+			Refreshed: ({ devices }) => model.status === "ready" && sameDevices(model.devices, devices) ? { model } : { model: {
+				...model,
+				status: "ready",
+				devices
+			} },
+			Denied: () => ({ model: unlessSame(model, {
+				...model,
+				status: "denied"
+			}) }),
+			Failed: ({ message }) => ({ model: unlessSame(model, {
+				...model,
+				lastError: Option.some(message)
+			}) })
+		}),
+		subscriptions: () => Subscription.make()(() => ({ changes: Subscription.persistentEntry(changedStream()) }))
+	});
+};
+export { MediaDevice, MediaDevicesMessage, MediaDevicesModel, mediaDevices };
+
+//# sourceMappingURL=media-devices.js.map

package/dist/device/media-devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-devices.js","names":[],"sources":["../../src/device/media-devices.ts"],"sourcesContent":["import { Effect, Option, 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.OptionFromNullOr(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(config.name, {\n    Model: MediaDevicesModel,\n    Message: MediaDevicesMessage,\n    init: () => ({\n      model: { status: 'unknown', devices: [], lastError: Option.none() },\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 }) => ({\n          model: unlessSame(model, { ...model, lastError: Option.some(message) }),\n        }),\n      }),\n    subscriptions: (): Subscription.Subscriptions<MediaDevicesModel, MediaDevicesMessage> =>\n      Subscription.make<MediaDevicesModel, MediaDevicesMessage>()(() => ({\n        changes: Subscription.persistentEntry(changedStream()),\n      })),\n  })\n}\n"],"mappings":"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"}

package/dist/device/media-stream.d.ts

@@ -0,0 +1,93 @@
+import { Option, Schema } from "effect";
+import { Bundle } from "foldkit-bundle";
+import * as ManagedResource from "foldkit/managedResource";
+export declare const MediaStreamModel: Schema.Struct<{
+  readonly status: Schema.Literals<readonly ["idle", "requesting", "live", "denied"]>;
+  readonly lastError: Schema.OptionFromNullOr<Schema.String>;
+}>;
+export type MediaStreamModel = typeof MediaStreamModel.Type;
+export declare const MediaStreamMessage: import("foldkit/message").MessageUnion<{
+  readonly Started: {};
+  readonly Stopped: {};
+  readonly Live: {};
+  readonly Ended: {};
+  readonly Denied: {};
+  readonly Failed: {
+    message: Schema.String;
+  };
+}>;
+export type MediaStreamMessage = typeof MediaStreamMessage.Type;
+/** A single media track: stopped on release. */
+export interface MediaTrackHandle {
+  stop(): void;
+}
+/** The live stream: its tracks stop on release. */
+export interface MediaStreamHandle {
+  getTracks(): ReadonlyArray<MediaTrackHandle>;
+}
+/** Which tracks `mediaStream` asks `getUserMedia` for. */
+export interface MediaStreamConstraints {
+  readonly audio: boolean;
+  readonly video: boolean;
+}
+/** The live stream, for commands that attach it to an element. One assembly holds one. */
+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. */
+  readonly request?: ((constraints: MediaStreamConstraints) => Promise<MediaStreamHandle>) | undefined;
+}) => Bundle.Bundle<Name, {
+  readonly audio: boolean;
+  readonly video: boolean;
+}, {
+  readonly status: "denied" | "idle" | "live" | "requesting";
+  readonly lastError: Option.Option<string>;
+}, {
+  readonly _tag: "Denied";
+} | {
+  readonly _tag: "Ended";
+} | {
+  readonly _tag: "Failed";
+  readonly message: string;
+} | {
+  readonly _tag: "Live";
+} | {
+  readonly _tag: "Started";
+} | {
+  readonly _tag: "Stopped";
+}, never, never, never, void, {
+  stream: ManagedResource.Entry<{
+    readonly status: "denied" | "idle" | "live" | "requesting";
+    readonly lastError: Option.Option<string>;
+  }, {
+    readonly _tag: "Denied";
+  } | {
+    readonly _tag: "Ended";
+  } | {
+    readonly _tag: "Failed";
+    readonly message: string;
+  } | {
+    readonly _tag: "Live";
+  } | {
+    readonly _tag: "Started";
+  } | {
+    readonly _tag: "Stopped";
+  }, Option.Option<{
+    readonly audio: boolean;
+    readonly video: boolean;
+  }>, MediaStreamHandle, ManagedResource.ManagedResourceService<"media-stream">, () => {
+    readonly _tag: "Live";
+  }>;
+}, {}>;
+//# sourceMappingURL=media-stream.d.ts.map

package/dist/device/media-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-stream.d.ts","names":[],"sources":["../../src/device/media-stream.ts"],"mappings":";;;qBAOa,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,YACH,aAAa,2BAA2B,QAAQ;MAEvD,OAAA,OAAA"}