@effect/platform-browser 4.0.0-beta.74 → 4.0.0-beta.75

package/dist/BrowserHttpClient.d.ts

@@ -42,8 +42,8 @@ export type XHRResponseType = "arraybuffer" | "text";
  *
  * **When to use**
  *
- * Use when XHR-backed HTTP requests need to receive response bodies as text or
- * as raw `ArrayBuffer` values.
+ * Use when you need XHR-backed HTTP requests to receive response bodies as text
+ * or raw `ArrayBuffer` values.
  *
  * @see {@link XHRResponseType} for the allowed response body modes
  * @see {@link withXHRArrayBuffer} for scoping XHR response handling to `ArrayBuffer`

package/dist/BrowserHttpClient.js

@@ -81,8 +81,8 @@ RequestInit } from "effect/unstable/http/FetchHttpClient";
  *
  * **When to use**
  *
- * Use when XHR-backed HTTP requests need to receive response bodies as text or
- * as raw `ArrayBuffer` values.
+ * Use when you need XHR-backed HTTP requests to receive response bodies as text
+ * or raw `ArrayBuffer` values.
  *
  * @see {@link XHRResponseType} for the allowed response body modes
  * @see {@link withXHRArrayBuffer} for scoping XHR response handling to `ArrayBuffer`

package/dist/BrowserKeyValueStore.d.ts

@@ -20,8 +20,8 @@ export declare const layerSessionStorage: Layer.Layer<KeyValueStore.KeyValueStor
  *
  * **When to use**
  *
- * Use when a browser `KeyValueStore` needs persistent asynchronous IndexedDB
- * storage instead of the synchronous Web Storage APIs.
+ * Use when you need persistent asynchronous IndexedDB storage for a browser
+ * `KeyValueStore` instead of the synchronous Web Storage APIs.
  *
  * **Details**
  *

package/dist/BrowserKeyValueStore.js

@@ -75,8 +75,8 @@ export const layerSessionStorage = /*#__PURE__*/KeyValueStore.layerStorage(() =>
  *
  * **When to use**
  *
- * Use when a browser `KeyValueStore` needs persistent asynchronous IndexedDB
- * storage instead of the synchronous Web Storage APIs.
+ * Use when you need persistent asynchronous IndexedDB storage for a browser
+ * `KeyValueStore` instead of the synchronous Web Storage APIs.
  *
  * **Details**
  *

package/dist/BrowserSocket.d.ts

@@ -45,8 +45,8 @@ import * as Socket from "effect/unstable/socket/Socket";
  *
  * **When to use**
  *
- * Use when browser or client-side code needs a complete `Socket` layer
- * connected to a WebSocket URL.
+ * Use when you need browser code to satisfy the platform socket service from a
+ * URL without wiring the browser constructor service separately.
  *
  * **Details**
  *

package/dist/BrowserSocket.js

@@ -45,8 +45,8 @@ import * as Socket from "effect/unstable/socket/Socket";
  *
  * **When to use**
  *
- * Use when browser or client-side code needs a complete `Socket` layer
- * connected to a WebSocket URL.
+ * Use when you need browser code to satisfy the platform socket service from a
+ * URL without wiring the browser constructor service separately.
  *
  * **Details**
  *

package/dist/BrowserWorker.d.ts

@@ -5,8 +5,8 @@ import * as Worker from "effect/unstable/workers/Worker";
  *
  * **When to use**
  *
- * Use when browser parent or client code needs both the browser
- * `WorkerPlatform` and a `Spawner` from one layer.
+ * Use when you need both the browser `WorkerPlatform` and a `Spawner` from one
+ * layer.
  *
  * **Details**
  *

package/dist/BrowserWorker.js

@@ -47,8 +47,8 @@ import { WorkerError, WorkerReceiveError } from "effect/unstable/workers/WorkerE
  *
  * **When to use**
  *
- * Use when browser parent or client code needs both the browser
- * `WorkerPlatform` and a `Spawner` from one layer.
+ * Use when you need both the browser `WorkerPlatform` and a `Spawner` from one
+ * layer.
  *
  * **Details**
  *

package/dist/BrowserWorkerRunner.d.ts

@@ -12,8 +12,8 @@ export declare const make: (self: MessagePort | Window) => WorkerRunner.WorkerRu
  *
  * **When to use**
  *
- * Use when a browser worker entry point uses the ambient `self` object as the
- * worker transport.
+ * Use when you need a browser worker entry point to use the ambient `self`
+ * object as the worker transport.
  *
  * **Details**
  *

package/dist/BrowserWorkerRunner.js

@@ -167,8 +167,8 @@ export const make = self => ({
  *
  * **When to use**
  *
- * Use when a browser worker entry point uses the ambient `self` object as the
- * worker transport.
+ * Use when you need a browser worker entry point to use the ambient `self`
+ * object as the worker transport.
  *
  * **Details**
  *

package/dist/Clipboard.d.ts

@@ -41,6 +41,11 @@ declare const ErrorTypeId = "~@effect/platform-browser/Clipboard/ClipboardError"
 /**
  * Defines the service interface for reading from, writing to, and clearing the browser clipboard.
  *
+ * **When to use**
+ *
+ * Use when an application needs clipboard operations through an Effect service
+ * so browser failures stay in the error channel.
+ *
  * **Details**
  *
  * `read` and `write` work with `ClipboardItem` arrays. `readString` and
@@ -86,8 +91,8 @@ export declare class ClipboardError extends ClipboardError_base<{
  *
  * **When to use**
  *
- * Use when an Effect needs to require or provide clipboard capabilities through
- * the context.
+ * Use when you need to require or provide clipboard capabilities through
+ * Effect's context.
  *
  * @see {@link make} for building a custom clipboard service
  * @see {@link layer} for providing the browser-backed clipboard service

package/dist/Clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Clipboard.d.ts","sourceRoot":"","sources":["../src/Clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,QAAA,MAAM,MAAM,wCAAwC,CAAA;AACpD,QAAA,MAAM,WAAW,uDAAuD,CAAA;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC1D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IAC9E,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IAC3E,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;CACpD;;;;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;IACA,QAAQ,CAAC,CAAC,WAAW,CAAC,wDAAc;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAsC,CAAA;AAElG;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,MAAM,CAAC,KAC3D,SAMC,CAAA;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAsCxC,CAAA"}
+{"version":3,"file":"Clipboard.d.ts","sourceRoot":"","sources":["../src/Clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,QAAA,MAAM,MAAM,wCAAwC,CAAA;AACpD,QAAA,MAAM,WAAW,uDAAuD,CAAA;AAExE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC1D,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IAC9E,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IAC3E,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;CACpD;;;;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;IACA,QAAQ,CAAC,CAAC,WAAW,CAAC,wDAAc;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAsC,CAAA;AAElG;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,GAAG,OAAO,MAAM,CAAC,KAC3D,SAMC,CAAA;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAsCxC,CAAA"}

package/dist/Clipboard.js

@@ -53,8 +53,8 @@ export class ClipboardError extends /*#__PURE__*/Data.TaggedError("ClipboardErro
  *
  * **When to use**
  *
- * Use when an Effect needs to require or provide clipboard capabilities through
- * the context.
+ * Use when you need to require or provide clipboard capabilities through
+ * Effect's context.
  *
  * @see {@link make} for building a custom clipboard service
  * @see {@link layer} for providing the browser-backed clipboard service

package/dist/Clipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"Clipboard.js","names":["Context","Data","Effect","Layer","TypeId","ErrorTypeId","ClipboardError","TaggedError","Clipboard","Service","make","impl","of","clear","writeString","writeBlob","blob","write","ClipboardItem","type","layer","succeed","read","tryPromise","try","navigator","clipboard","catch","cause","s","readString","readText","text","writeText"],"sources":["../src/Clipboard.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,OAAO,KAAKA,OAAO,MAAM,gBAAgB;AACzC,OAAO,KAAKC,IAAI,MAAM,aAAa;AACnC,OAAO,KAAKC,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,KAAK,MAAM,cAAc;AAErC,MAAMC,MAAM,GAAG,qCAAqC;AACpD,MAAMC,WAAW,GAAG,oDAAoD;AA+BxE;;;;;;AAMA,OAAM,MAAOC,cAAe,sBAAQL,IAAI,CAACM,WAAW,CAAC,gBAAgB,CAGnE;EACS,CAACF,WAAW,IAAIA,WAAW;;AAGtC;;;;;;;;;;;;;;AAcA,OAAO,MAAMG,SAAS,gBAA0CR,OAAO,CAACS,OAAO,CAAYL,MAAM,CAAC;AAElG;;;;;;AAMA,OAAO,MAAMM,IAAI,GACfC,IAA4D,IAE5DH,SAAS,CAACI,EAAE,CAAC;EACX,GAAGD,IAAI;EACP,CAACP,MAAM,GAAGA,MAAM;EAChBS,KAAK,EAAEF,IAAI,CAACG,WAAW,CAAC,EAAE,CAAC;EAC3BC,SAAS,EAAGC,IAAU,IAAKL,IAAI,CAACM,KAAK,CAAC,CAAC,IAAIC,aAAa,CAAC;IAAE,CAACF,IAAI,CAACG,IAAI,GAAGH;EAAI,CAAE,CAAC,CAAC;CACjF,CAAC;AAEJ;;;;;;AAMA,OAAO,MAAMI,KAAK,gBAA2BjB,KAAK,CAACkB,OAAO,CACxDb,SAAS,eACTE,IAAI,CAAC;EACHY,IAAI,eAAEpB,MAAM,CAACqB,UAAU,CAAC;IACtBC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACJ,IAAI,EAAE;IACrCK,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ,CAAC;EACFX,KAAK,EAAGY,CAAuB,IAC7B3B,MAAM,CAACqB,UAAU,CAAC;IAChBC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACT,KAAK,CAACY,CAAC,CAAC;IACvCF,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ,CAAC;EACJE,UAAU,eAAE5B,MAAM,CAACqB,UAAU,CAAC;IAC5BC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACK,QAAQ,EAAE;IACzCJ,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ,CAAC;EACFd,WAAW,EAAGkB,IAAY,IACxB9B,MAAM,CAACqB,UAAU,CAAC;IAChBC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACO,SAAS,CAACD,IAAI,CAAC;IAC9CL,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ;CACJ,CAAC,CACH","ignoreList":[]}
+{"version":3,"file":"Clipboard.js","names":["Context","Data","Effect","Layer","TypeId","ErrorTypeId","ClipboardError","TaggedError","Clipboard","Service","make","impl","of","clear","writeString","writeBlob","blob","write","ClipboardItem","type","layer","succeed","read","tryPromise","try","navigator","clipboard","catch","cause","s","readString","readText","text","writeText"],"sources":["../src/Clipboard.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,OAAO,KAAKA,OAAO,MAAM,gBAAgB;AACzC,OAAO,KAAKC,IAAI,MAAM,aAAa;AACnC,OAAO,KAAKC,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,KAAK,MAAM,cAAc;AAErC,MAAMC,MAAM,GAAG,qCAAqC;AACpD,MAAMC,WAAW,GAAG,oDAAoD;AAoCxE;;;;;;AAMA,OAAM,MAAOC,cAAe,sBAAQL,IAAI,CAACM,WAAW,CAAC,gBAAgB,CAGnE;EACS,CAACF,WAAW,IAAIA,WAAW;;AAGtC;;;;;;;;;;;;;;AAcA,OAAO,MAAMG,SAAS,gBAA0CR,OAAO,CAACS,OAAO,CAAYL,MAAM,CAAC;AAElG;;;;;;AAMA,OAAO,MAAMM,IAAI,GACfC,IAA4D,IAE5DH,SAAS,CAACI,EAAE,CAAC;EACX,GAAGD,IAAI;EACP,CAACP,MAAM,GAAGA,MAAM;EAChBS,KAAK,EAAEF,IAAI,CAACG,WAAW,CAAC,EAAE,CAAC;EAC3BC,SAAS,EAAGC,IAAU,IAAKL,IAAI,CAACM,KAAK,CAAC,CAAC,IAAIC,aAAa,CAAC;IAAE,CAACF,IAAI,CAACG,IAAI,GAAGH;EAAI,CAAE,CAAC,CAAC;CACjF,CAAC;AAEJ;;;;;;AAMA,OAAO,MAAMI,KAAK,gBAA2BjB,KAAK,CAACkB,OAAO,CACxDb,SAAS,eACTE,IAAI,CAAC;EACHY,IAAI,eAAEpB,MAAM,CAACqB,UAAU,CAAC;IACtBC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACJ,IAAI,EAAE;IACrCK,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ,CAAC;EACFX,KAAK,EAAGY,CAAuB,IAC7B3B,MAAM,CAACqB,UAAU,CAAC;IAChBC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACT,KAAK,CAACY,CAAC,CAAC;IACvCF,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ,CAAC;EACJE,UAAU,eAAE5B,MAAM,CAACqB,UAAU,CAAC;IAC5BC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACK,QAAQ,EAAE;IACzCJ,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ,CAAC;EACFd,WAAW,EAAGkB,IAAY,IACxB9B,MAAM,CAACqB,UAAU,CAAC;IAChBC,GAAG,EAAEA,CAAA,KAAMC,SAAS,CAACC,SAAS,CAACO,SAAS,CAACD,IAAI,CAAC;IAC9CL,KAAK,EAAGC,KAAK,IACX,IAAItB,cAAc,CAAC;MACjBsB,KAAK;MACL,SAAS,EAAE;KACZ;GACJ;CACJ,CAAC,CACH","ignoreList":[]}

package/dist/Geolocation.d.ts

@@ -78,8 +78,8 @@ export interface Geolocation {
  *
  * **When to use**
  *
- * Use when an Effect needs to access or provide geolocation capabilities
- * through the context.
+ * Use when you need to access or provide geolocation capabilities through
+ * Effect's context.
  *
  * @see {@link layer} for providing the browser-backed geolocation service
  *

package/dist/Geolocation.js

@@ -47,8 +47,8 @@ const ErrorTypeId = "~@effect/platform-browser/Geolocation/GeolocationError";
  *
  * **When to use**
  *
- * Use when an Effect needs to access or provide geolocation capabilities
- * through the context.
+ * Use when you need to access or provide geolocation capabilities through
+ * Effect's context.
  *
  * @see {@link layer} for providing the browser-backed geolocation service
  *

package/dist/IndexedDb.d.ts

@@ -57,8 +57,8 @@ export declare const IDBValidKey: Schema.Union<readonly [Schema.Union<readonly [
  *
  * **When to use**
  *
- * Use when defining numeric key-path fields for `IndexedDbTable` definitions
- * that use IndexedDB auto-increment keys.
+ * Use when you need to define numeric key-path fields for `IndexedDbTable`
+ * definitions that use IndexedDB auto-increment keys.
  *
  * **Details**
  *

package/dist/IndexedDb.js

@@ -49,8 +49,8 @@ export const IDBValidKey = /*#__PURE__*/Schema.Union([IDBFlatKey, /*#__PURE__*/S
  *
  * **When to use**
  *
- * Use when defining numeric key-path fields for `IndexedDbTable` definitions
- * that use IndexedDB auto-increment keys.
+ * Use when you need to define numeric key-path fields for `IndexedDbTable`
+ * definitions that use IndexedDB auto-increment keys.
  *
  * **Details**
  *

package/dist/IndexedDbDatabase.d.ts

@@ -75,7 +75,7 @@ declare const IndexedDbDatabase_base: Context.ServiceClass<IndexedDbDatabase, "~
  *
  * **When to use**
  *
- * Use when an effect needs access to the live database service after an
+ * Use when you need access to the live database service after an
  * `IndexedDbSchema` layer has been provided, especially for `rebuild` or
  * lower-level database primitives.
  *

package/dist/IndexedDbDatabase.js

@@ -94,7 +94,7 @@ export class IndexedDbDatabaseError extends /*#__PURE__*/Data.TaggedError("Index
  *
  * **When to use**
  *
- * Use when an effect needs access to the live database service after an
+ * Use when you need access to the live database service after an
  * `IndexedDbSchema` layer has been provided, especially for `rebuild` or
  * lower-level database primitives.
  *

package/dist/IndexedDbVersion.d.ts

@@ -72,6 +72,11 @@ export type SchemaWithName<Db extends Any, TableName extends string> = IndexedDb
 /**
  * Creates an `IndexedDbVersion` from one or more table definitions.
  *
+ * **When to use**
+ *
+ * Use when you need a typed description of the target IndexedDB schema that a
+ * database migration will materialize.
+ *
  * **Details**
  *
  * The returned version exposes a `tables` map keyed by each table's

package/dist/IndexedDbVersion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexedDbVersion.d.ts","sourceRoot":"","sources":["../src/IndexedDbVersion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAE1D,QAAA,MAAM,MAAM,+CAA+C,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAC/B,GAAG,CAAC,MAAM,SAAS,cAAc,CAAC,YAAY,CAC9C,SAAQ,QAAQ;IAChB,KAAI,CAAC,EAAE,KAAK,GAAG,EAAE,CAAA;IACjB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;AAExE;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,EAAE,SAAS,gBAAgB,CAAC,MAAM,OAAO,CAAC,GAAG,OAAO,GAAG,KAAK,CAAA;AAEjG;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CACvB,EAAE,SAAS,GAAG,EACd,SAAS,SAAS,MAAM,IACtB,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;AAElD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CACxB,EAAE,SAAS,GAAG,EACd,SAAS,SAAS,MAAM,IACtB,cAAc,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;AAmB9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,IAAI,GACf,KAAK,CAAC,MAAM,SAAS,qBAAqB,CAAC,cAAc,CAAC,YAAY,CAAC,EAEvE,GAAG,QAAQ,MAAM,KAChB,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAG9B,CAAA"}
+{"version":3,"file":"IndexedDbVersion.d.ts","sourceRoot":"","sources":["../src/IndexedDbVersion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAE1D,QAAA,MAAM,MAAM,+CAA+C,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAC/B,GAAG,CAAC,MAAM,SAAS,cAAc,CAAC,YAAY,CAC9C,SAAQ,QAAQ;IAChB,KAAI,CAAC,EAAE,KAAK,GAAG,EAAE,CAAA;IACjB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;AAExE;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,EAAE,SAAS,gBAAgB,CAAC,MAAM,OAAO,CAAC,GAAG,OAAO,GAAG,KAAK,CAAA;AAEjG;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CACvB,EAAE,SAAS,GAAG,EACd,SAAS,SAAS,MAAM,IACtB,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;AAElD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CACxB,EAAE,SAAS,GAAG,EACd,SAAS,SAAS,MAAM,IACtB,cAAc,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;AAmB9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,IAAI,GACf,KAAK,CAAC,MAAM,SAAS,qBAAqB,CAAC,cAAc,CAAC,YAAY,CAAC,EAEvE,GAAG,QAAQ,MAAM,KAChB,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAG9B,CAAA"}

package/dist/IndexedDbVersion.js

@@ -16,6 +16,11 @@ const makeProto = options => {
 /**
  * Creates an `IndexedDbVersion` from one or more table definitions.
  *
+ * **When to use**
+ *
+ * Use when you need a typed description of the target IndexedDB schema that a
+ * database migration will materialize.
+ *
  * **Details**
  *
  * The returned version exposes a `tables` map keyed by each table's

package/dist/IndexedDbVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"IndexedDbVersion.js","names":["pipeArguments","TypeId","Proto","pipe","arguments","makeProto","options","Version","Object","assign","tables","make","Map","map","table","tableName"],"sources":["../src/IndexedDbVersion.ts"],"sourcesContent":[null],"mappings":"AAqBA,SAASA,aAAa,QAAQ,iBAAiB;AAG/C,MAAMC,MAAM,GAAG,4CAA4C;AAgE3D,MAAMC,KAAK,GAAG;EACZ,CAACD,MAAM,GAAGA,MAAM;EAChBE,IAAIA,CAAA;IACF,OAAOH,aAAa,CAAC,IAAI,EAAEI,SAAS,CAAC;EACvC;CACD;AAED,MAAMC,SAAS,GAAgDC,OAE9D,IAA8B;EAC7B;EACA,MAAMC,OAAO;EACbC,MAAM,CAACC,MAAM,CAACF,OAAO,EAAEL,KAAK,CAAC;EAC3BK,OAAe,CAACG,MAAM,GAAGJ,OAAO,CAACI,MAAM;EACzC,OAAOH,OAAc;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,MAAMI,IAAI,GAAGA,CAGlB,GAAGD,MAAc,KAEjBL,SAAS,CAAC;EACRK,MAAM,EAAE,IAAIE,GAAG,CAACF,MAAM,CAACG,GAAG,CAAEC,KAAK,IAAK,CAACA,KAAK,CAACC,SAAS,EAAED,KAAK,CAAC,CAAC;CAChE,CAAC","ignoreList":[]}
+{"version":3,"file":"IndexedDbVersion.js","names":["pipeArguments","TypeId","Proto","pipe","arguments","makeProto","options","Version","Object","assign","tables","make","Map","map","table","tableName"],"sources":["../src/IndexedDbVersion.ts"],"sourcesContent":[null],"mappings":"AAqBA,SAASA,aAAa,QAAQ,iBAAiB;AAG/C,MAAMC,MAAM,GAAG,4CAA4C;AAgE3D,MAAMC,KAAK,GAAG;EACZ,CAACD,MAAM,GAAGA,MAAM;EAChBE,IAAIA,CAAA;IACF,OAAOH,aAAa,CAAC,IAAI,EAAEI,SAAS,CAAC;EACvC;CACD;AAED,MAAMC,SAAS,GAAgDC,OAE9D,IAA8B;EAC7B;EACA,MAAMC,OAAO;EACbC,MAAM,CAACC,MAAM,CAACF,OAAO,EAAEL,KAAK,CAAC;EAC3BK,OAAe,CAACG,MAAM,GAAGJ,OAAO,CAACI,MAAM;EACzC,OAAOH,OAAc;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,OAAO,MAAMI,IAAI,GAAGA,CAGlB,GAAGD,MAAc,KAEjBL,SAAS,CAAC;EACRK,MAAM,EAAE,IAAIE,GAAG,CAACF,MAAM,CAACG,GAAG,CAAEC,KAAK,IAAK,CAACA,KAAK,CAACC,SAAS,EAAED,KAAK,CAAC,CAAC;CAChE,CAAC","ignoreList":[]}

package/dist/Permissions.d.ts

@@ -112,8 +112,8 @@ export declare class PermissionsError extends PermissionsError_base<{
  *
  * **When to use**
  *
- * Use when an Effect needs to require or provide browser permission querying
- * through the context.
+ * Use when you need to require or provide browser permission querying through
+ * Effect's context.
  *
  * @category services
  * @since 4.0.0
@@ -124,8 +124,8 @@ export declare const Permissions: Context.Service<Permissions, Permissions>;
  *
  * **When to use**
  *
- * Use when browser programs need a live `Permissions` service backed by the
- * ambient `navigator.permissions` implementation.
+ * Use when you need a live browser `Permissions` service backed by the ambient
+ * `navigator.permissions` implementation.
  *
  * **Details**
  *

package/dist/Permissions.js

@@ -84,8 +84,8 @@ export class PermissionsError extends /*#__PURE__*/Data.TaggedError("Permissions
  *
  * **When to use**
  *
- * Use when an Effect needs to require or provide browser permission querying
- * through the context.
+ * Use when you need to require or provide browser permission querying through
+ * Effect's context.
  *
  * @category services
  * @since 4.0.0
@@ -96,8 +96,8 @@ export const Permissions = /*#__PURE__*/Context.Service(TypeId);
  *
  * **When to use**
  *
- * Use when browser programs need a live `Permissions` service backed by the
- * ambient `navigator.permissions` implementation.
+ * Use when you need a live browser `Permissions` service backed by the ambient
+ * `navigator.permissions` implementation.
  *
  * **Details**
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@effect/platform-browser",
   "type": "module",
-  "version": "4.0.0-beta.74",
+  "version": "4.0.0-beta.75",
   "license": "MIT",
   "description": "Platform specific implementations for the browser",
   "homepage": "https://effect.website",
@@ -45,12 +45,12 @@
     "provenance": true
   },
   "peerDependencies": {
-    "effect": "^4.0.0-beta.74"
+    "effect": "^4.0.0-beta.75"
   },
   "devDependencies": {
     "mock-xmlhttprequest": "^8.4.1",
     "fake-indexeddb": "^6.2.5",
-    "effect": "^4.0.0-beta.74"
+    "effect": "^4.0.0-beta.75"
   },
   "dependencies": {
     "multipasta": "^0.2.7"

package/src/BrowserHttpClient.ts

@@ -101,8 +101,8 @@ export type XHRResponseType = "arraybuffer" | "text"
  *
  * **When to use**
  *
- * Use when XHR-backed HTTP requests need to receive response bodies as text or
- * as raw `ArrayBuffer` values.
+ * Use when you need XHR-backed HTTP requests to receive response bodies as text
+ * or raw `ArrayBuffer` values.
  *
  * @see {@link XHRResponseType} for the allowed response body modes
  * @see {@link withXHRArrayBuffer} for scoping XHR response handling to `ArrayBuffer`

package/src/BrowserKeyValueStore.ts

@@ -82,8 +82,8 @@ export const layerSessionStorage: Layer.Layer<KeyValueStore.KeyValueStore> = Key
  *
  * **When to use**
  *
- * Use when a browser `KeyValueStore` needs persistent asynchronous IndexedDB
- * storage instead of the synchronous Web Storage APIs.
+ * Use when you need persistent asynchronous IndexedDB storage for a browser
+ * `KeyValueStore` instead of the synchronous Web Storage APIs.
  *
  * **Details**
  *

package/src/BrowserSocket.ts

@@ -46,8 +46,8 @@ import * as Socket from "effect/unstable/socket/Socket"
  *
  * **When to use**
  *
- * Use when browser or client-side code needs a complete `Socket` layer
- * connected to a WebSocket URL.
+ * Use when you need browser code to satisfy the platform socket service from a
+ * URL without wiring the browser constructor service separately.
  *
  * **Details**
  *

package/src/BrowserWorker.ts

@@ -48,8 +48,8 @@ import { WorkerError, WorkerReceiveError } from "effect/unstable/workers/WorkerE
  *
  * **When to use**
  *
- * Use when browser parent or client code needs both the browser
- * `WorkerPlatform` and a `Spawner` from one layer.
+ * Use when you need both the browser `WorkerPlatform` and a `Spawner` from one
+ * layer.
  *
  * **Details**
  *

package/src/BrowserWorkerRunner.ts

@@ -187,8 +187,8 @@ export const make = (self: MessagePort | Window): WorkerRunner.WorkerRunnerPlatf
  *
  * **When to use**
  *
- * Use when a browser worker entry point uses the ambient `self` object as the
- * worker transport.
+ * Use when you need a browser worker entry point to use the ambient `self`
+ * object as the worker transport.
  *
  * **Details**
  *

package/src/Clipboard.ts

@@ -44,6 +44,11 @@ const ErrorTypeId = "~@effect/platform-browser/Clipboard/ClipboardError"
 /**
  * Defines the service interface for reading from, writing to, and clearing the browser clipboard.
  *
+ * **When to use**
+ *
+ * Use when an application needs clipboard operations through an Effect service
+ * so browser failures stay in the error channel.
+ *
  * **Details**
  *
  * `read` and `write` work with `ClipboardItem` arrays. `readString` and
@@ -88,8 +93,8 @@ export class ClipboardError extends Data.TaggedError("ClipboardError")<{
  *
  * **When to use**
  *
- * Use when an Effect needs to require or provide clipboard capabilities through
- * the context.
+ * Use when you need to require or provide clipboard capabilities through
+ * Effect's context.
  *
  * @see {@link make} for building a custom clipboard service
  * @see {@link layer} for providing the browser-backed clipboard service

package/src/Geolocation.ts

@@ -89,8 +89,8 @@ export interface Geolocation {
  *
  * **When to use**
  *
- * Use when an Effect needs to access or provide geolocation capabilities
- * through the context.
+ * Use when you need to access or provide geolocation capabilities through
+ * Effect's context.
  *
  * @see {@link layer} for providing the browser-backed geolocation service
  *

package/src/IndexedDb.ts

@@ -75,8 +75,8 @@ export const IDBValidKey = Schema.Union([IDBFlatKey, Schema.Array(IDBFlatKey)])
  *
  * **When to use**
  *
- * Use when defining numeric key-path fields for `IndexedDbTable` definitions
- * that use IndexedDB auto-increment keys.
+ * Use when you need to define numeric key-path fields for `IndexedDbTable`
+ * definitions that use IndexedDB auto-increment keys.
  *
  * **Details**
  *

package/src/IndexedDbDatabase.ts

@@ -125,7 +125,7 @@ export class IndexedDbDatabaseError extends Data.TaggedError(
  *
  * **When to use**
  *
- * Use when an effect needs access to the live database service after an
+ * Use when you need access to the live database service after an
  * `IndexedDbSchema` layer has been provided, especially for `rebuild` or
  * lower-level database primitives.
  *

package/src/IndexedDbVersion.ts

@@ -106,6 +106,11 @@ const makeProto = <Tables extends IndexedDbTable.AnyWithProps>(options: {
 /**
  * Creates an `IndexedDbVersion` from one or more table definitions.
  *
+ * **When to use**
+ *
+ * Use when you need a typed description of the target IndexedDB schema that a
+ * database migration will materialize.
+ *
  * **Details**
  *
  * The returned version exposes a `tables` map keyed by each table's

package/src/Permissions.ts

@@ -128,8 +128,8 @@ export class PermissionsError extends Data.TaggedError("PermissionsError")<{
  *
  * **When to use**
  *
- * Use when an Effect needs to require or provide browser permission querying
- * through the context.
+ * Use when you need to require or provide browser permission querying through
+ * Effect's context.
  *
  * @category services
  * @since 4.0.0
@@ -141,8 +141,8 @@ export const Permissions: Context.Service<Permissions, Permissions> = Context.Se
  *
  * **When to use**
  *
- * Use when browser programs need a live `Permissions` service backed by the
- * ambient `navigator.permissions` implementation.
+ * Use when you need a live browser `Permissions` service backed by the ambient
+ * `navigator.permissions` implementation.
  *
  * **Details**
  *