effect 4.0.0-beta.99 → 4.0.0-rc.108

package/src/Struct.ts

@@ -14,6 +14,7 @@
 import * as Combiner from "./Combiner.ts"
 import * as Equivalence from "./Equivalence.ts"
 import { dual } from "./Function.ts"
+import * as InternalRecord from "./internal/record.ts"
 import * as order from "./Order.ts"
 import * as Reducer from "./Reducer.ts"
 
@@ -31,7 +32,7 @@ import * as Reducer from "./Reducer.ts"
  *
  * **Example** (Flattening an intersection)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import type { Struct } from "effect"
  *
  * type Original = { a: string } & { b: number }
@@ -39,6 +40,8 @@ import * as Reducer from "./Reducer.ts"
  * // Without Simplify, the type displays as `{ a: string } & { b: number }`
  * type Simplified = Struct.Simplify<Original>
  * // { a: string; b: number }
+ *
+ * const witness: Simplified = { a: "value", b: 1 }
  * ```
  *
  * @see {@link Mutable} – also flattens but removes `readonly`
@@ -62,12 +65,16 @@ export type Simplify<T> = { [K in keyof T]: T[K] } & {}
  *
  * **Example** (Making a readonly type mutable)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import type { Struct } from "effect"
  *
  * type ReadOnly = { readonly a: string; readonly b: number }
  * type Writable = Struct.Mutable<ReadOnly>
  * // { a: string; b: number }
+ *
+ * const witness: Writable = { a: "value", b: 1 }
+ * witness.b = 2
+ * witness // => { a: "value", b: 2 }
  * ```
  *
  * @see {@link Simplify} – flattens intersections without removing `readonly`
@@ -91,13 +98,15 @@ export type Mutable<T> = { -readonly [K in keyof T]: T[K] } & {}
  *
  * **Example** (Merging two types with overlapping keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import type { Struct } from "effect"
  *
  * type A = { a: string; b: number }
  * type B = { b: boolean; c: string }
  * type Merged = Struct.Assign<A, B>
  * // { a: string; b: boolean; c: string }
+ *
+ * const witness: Merged = { a: "value", b: true, c: "other" }
  * ```
  *
  * @see {@link assign} – the runtime equivalent
@@ -120,11 +129,10 @@ export type Assign<T, U> = Simplify<keyof T & keyof U extends never ? T & U : Om
  *
  * **Example** (Extracting a property in a pipeline)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
- * const name = pipe({ name: "Alice", age: 30 }, Struct.get("name"))
- * console.log(name) // "Alice"
+ * pipe({ name: "Alice", age: 30 }, Struct.get("name")) // => "Alice"
  * ```
  *
  * @see {@link keys} – list all string keys of a struct
@@ -146,11 +154,10 @@ export const get: {
    *
    * **Example** (Extracting a property in a pipeline)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
-   * const name = pipe({ name: "Alice", age: 30 }, Struct.get("name"))
-   * console.log(name) // "Alice"
+   * pipe({ name: "Alice", age: 30 }, Struct.get("name")) // => "Alice"
    * ```
    *
    * @see {@link keys} – list all string keys of a struct
@@ -172,11 +179,10 @@ export const get: {
    *
    * **Example** (Extracting a property in a pipeline)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
-   * const name = pipe({ name: "Alice", age: 30 }, Struct.get("name"))
-   * console.log(name) // "Alice"
+   * pipe({ name: "Alice", age: 30 }, Struct.get("name")) // => "Alice"
    * ```
    *
    * @see {@link keys} – list all string keys of a struct
@@ -201,18 +207,18 @@ export const get: {
  *
  * **Example** (Reading typed keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Struct } from "effect"
  *
  * const user = { name: "Alice", age: 30, [Symbol.for("id")]: 1 }
  *
  * const k: Array<"name" | "age"> = Struct.keys(user)
- * console.log(k) // ["name", "age"]
+ * k // => ["name", "age"]
  * ```
  *
  * @see {@link get} – access a single key's value
  * @see {@link pick} – select a subset of keys into a new struct
- * @category Key utilities
+ * @category getters
  * @since 3.6.0
  */
 export const keys = <S extends object>(self: S): Array<(keyof S) & string> =>
@@ -231,12 +237,11 @@ export const keys = <S extends object>(self: S): Array<(keyof S) & string> =>
  *
  * **Example** (Selecting specific properties)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * const user = { name: "Alice", age: 30, admin: true }
- * const nameAndAge = pipe(user, Struct.pick(["name", "age"]))
- * console.log(nameAndAge) // { name: "Alice", age: 30 }
+ * pipe(user, Struct.pick(["name", "age"])) // => { name: "Alice", age: 30 }
  * ```
  *
  * @see {@link omit} – the inverse (exclude keys instead)
@@ -258,12 +263,11 @@ export const pick: {
    *
    * **Example** (Selecting specific properties)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const user = { name: "Alice", age: 30, admin: true }
-   * const nameAndAge = pipe(user, Struct.pick(["name", "age"]))
-   * console.log(nameAndAge) // { name: "Alice", age: 30 }
+   * pipe(user, Struct.pick(["name", "age"])) // => { name: "Alice", age: 30 }
    * ```
    *
    * @see {@link omit} – the inverse (exclude keys instead)
@@ -285,12 +289,11 @@ export const pick: {
    *
    * **Example** (Selecting specific properties)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const user = { name: "Alice", age: 30, admin: true }
-   * const nameAndAge = pipe(user, Struct.pick(["name", "age"]))
-   * console.log(nameAndAge) // { name: "Alice", age: 30 }
+   * pipe(user, Struct.pick(["name", "age"])) // => { name: "Alice", age: 30 }
    * ```
    *
    * @see {@link omit} – the inverse (exclude keys instead)
@@ -319,12 +322,11 @@ export const pick: {
  *
  * **Example** (Removing a property)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * const user = { name: "Alice", age: 30, password: "secret" }
- * const safe = pipe(user, Struct.omit(["password"]))
- * console.log(safe) // { name: "Alice", age: 30 }
+ * pipe(user, Struct.omit(["password"])) // => { name: "Alice", age: 30 }
  * ```
  *
  * @see {@link pick} – the inverse (keep only specified keys)
@@ -345,12 +347,11 @@ export const omit: {
    *
    * **Example** (Removing a property)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const user = { name: "Alice", age: 30, password: "secret" }
-   * const safe = pipe(user, Struct.omit(["password"]))
-   * console.log(safe) // { name: "Alice", age: 30 }
+   * pipe(user, Struct.omit(["password"])) // => { name: "Alice", age: 30 }
    * ```
    *
    * @see {@link pick} – the inverse (keep only specified keys)
@@ -371,12 +372,11 @@ export const omit: {
    *
    * **Example** (Removing a property)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const user = { name: "Alice", age: 30, password: "secret" }
-   * const safe = pipe(user, Struct.omit(["password"]))
-   * console.log(safe) // { name: "Alice", age: 30 }
+   * pipe(user, Struct.omit(["password"])) // => { name: "Alice", age: 30 }
    * ```
    *
    * @see {@link pick} – the inverse (keep only specified keys)
@@ -405,13 +405,12 @@ export const omit: {
  *
  * **Example** (Merging structs with overlapping keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * const defaults = { theme: "light", lang: "en" }
  * const overrides = { theme: "dark", fontSize: 14 }
- * const config = pipe(defaults, Struct.assign(overrides))
- * console.log(config) // { theme: "dark", lang: "en", fontSize: 14 }
+ * pipe(defaults, Struct.assign(overrides)) // => { theme: "dark", lang: "en", fontSize: 14 }
  * ```
  *
  * @see {@link Assign} – the type-level equivalent
@@ -434,13 +433,12 @@ export const assign: {
    *
    * **Example** (Merging structs with overlapping keys)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const defaults = { theme: "light", lang: "en" }
    * const overrides = { theme: "dark", fontSize: 14 }
-   * const config = pipe(defaults, Struct.assign(overrides))
-   * console.log(config) // { theme: "dark", lang: "en", fontSize: 14 }
+   * pipe(defaults, Struct.assign(overrides)) // => { theme: "dark", lang: "en", fontSize: 14 }
    * ```
    *
    * @see {@link Assign} – the type-level equivalent
@@ -463,13 +461,12 @@ export const assign: {
    *
    * **Example** (Merging structs with overlapping keys)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const defaults = { theme: "light", lang: "en" }
    * const overrides = { theme: "dark", fontSize: 14 }
-   * const config = pipe(defaults, Struct.assign(overrides))
-   * console.log(config) // { theme: "dark", lang: "en", fontSize: 14 }
+   * pipe(defaults, Struct.assign(overrides)) // => { theme: "dark", lang: "en", fontSize: 14 }
    * ```
    *
    * @see {@link Assign} – the type-level equivalent
@@ -506,7 +503,7 @@ type Evolved<S, E> = Simplify<
  *
  * **Example** (Transforming selected values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * const result = pipe(
@@ -516,7 +513,7 @@ type Evolved<S, E> = Simplify<
  *     age: (n) => n + 1
  *   })
  * )
- * console.log(result) // { name: "ALICE", age: 31, active: true }
+ * result // => { name: "ALICE", age: 31, active: true }
  * ```
  *
  * @see {@link evolveKeys} – transform keys instead of values
@@ -541,7 +538,7 @@ export const evolve: {
    *
    * **Example** (Transforming selected values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
@@ -551,7 +548,7 @@ export const evolve: {
    *     age: (n) => n + 1
    *   })
    * )
-   * console.log(result) // { name: "ALICE", age: 31, active: true }
+   * result // => { name: "ALICE", age: 31, active: true }
    * ```
    *
    * @see {@link evolveKeys} – transform keys instead of values
@@ -576,7 +573,7 @@ export const evolve: {
    *
    * **Example** (Transforming selected values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
@@ -586,7 +583,7 @@ export const evolve: {
    *     age: (n) => n + 1
    *   })
    * )
-   * console.log(result) // { name: "ALICE", age: 31, active: true }
+   * result // => { name: "ALICE", age: 31, active: true }
    * ```
    *
    * @see {@link evolveKeys} – transform keys instead of values
@@ -624,7 +621,7 @@ type KeyEvolved<S, E> = Simplify<
  *
  * **Example** (Renaming keys with functions)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * const result = pipe(
@@ -633,13 +630,13 @@ type KeyEvolved<S, E> = Simplify<
  *     name: (k) => k.toUpperCase()
  *   })
  * )
- * console.log(result) // { NAME: "Alice", age: 30 }
+ * result // => { NAME: "Alice", age: 30 }
  * ```
  *
  * @see {@link renameKeys} – rename keys with a static mapping
  * @see {@link evolve} – transform values instead of keys
  * @see {@link evolveEntries} – transform both keys and values
- * @category Key utilities
+ * @category transforming
  * @since 4.0.0
  */
 export const evolveKeys: {
@@ -658,7 +655,7 @@ export const evolveKeys: {
    *
    * **Example** (Renaming keys with functions)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
@@ -667,13 +664,13 @@ export const evolveKeys: {
    *     name: (k) => k.toUpperCase()
    *   })
    * )
-   * console.log(result) // { NAME: "Alice", age: 30 }
+   * result // => { NAME: "Alice", age: 30 }
    * ```
    *
    * @see {@link renameKeys} – rename keys with a static mapping
    * @see {@link evolve} – transform values instead of keys
    * @see {@link evolveEntries} – transform both keys and values
-   * @category Key utilities
+   * @category transforming
    * @since 4.0.0
    */
   <S extends object, E extends KeyEvolver<S>>(e: E): (self: S) => KeyEvolved<S, E>
@@ -692,7 +689,7 @@ export const evolveKeys: {
    *
    * **Example** (Renaming keys with functions)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
@@ -701,13 +698,13 @@ export const evolveKeys: {
    *     name: (k) => k.toUpperCase()
    *   })
    * )
-   * console.log(result) // { NAME: "Alice", age: 30 }
+   * result // => { NAME: "Alice", age: 30 }
    * ```
    *
    * @see {@link renameKeys} – rename keys with a static mapping
    * @see {@link evolve} – transform values instead of keys
    * @see {@link evolveEntries} – transform both keys and values
-   * @category Key utilities
+   * @category transforming
    * @since 4.0.0
    */
   <S extends object, E extends KeyEvolver<S>>(self: S, e: E): KeyEvolved<S, E>
@@ -745,7 +742,7 @@ type EntryEvolved<S, E> = {
  *
  * **Example** (Transforming keys and values together)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * const result = pipe(
@@ -755,7 +752,7 @@ type EntryEvolved<S, E> = {
  *     label: (k, v) => [k, v.toUpperCase()]
  *   })
  * )
- * console.log(result) // { amountCents: 10000, label: "TOTAL" }
+ * result // => { amountCents: 10000, label: "TOTAL" }
  * ```
  *
  * @see {@link evolve} – transform values only
@@ -779,7 +776,7 @@ export const evolveEntries: {
    *
    * **Example** (Transforming keys and values together)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
@@ -789,7 +786,7 @@ export const evolveEntries: {
    *     label: (k, v) => [k, v.toUpperCase()]
    *   })
    * )
-   * console.log(result) // { amountCents: 10000, label: "TOTAL" }
+   * result // => { amountCents: 10000, label: "TOTAL" }
    * ```
    *
    * @see {@link evolve} – transform values only
@@ -813,7 +810,7 @@ export const evolveEntries: {
    *
    * **Example** (Transforming keys and values together)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
@@ -823,7 +820,7 @@ export const evolveEntries: {
    *     label: (k, v) => [k, v.toUpperCase()]
    *   })
    * )
-   * console.log(result) // { amountCents: 10000, label: "TOTAL" }
+   * result // => { amountCents: 10000, label: "TOTAL" }
    * ```
    *
    * @see {@link evolve} – transform values only
@@ -853,19 +850,19 @@ export const evolveEntries: {
  *
  * **Example** (Renaming keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * const result = pipe(
  *   { firstName: "Alice", lastName: "Smith", age: 30 },
  *   Struct.renameKeys({ firstName: "first", lastName: "last" })
  * )
- * console.log(result) // { first: "Alice", last: "Smith", age: 30 }
+ * result // => { first: "Alice", last: "Smith", age: 30 }
  * ```
  *
  * @see {@link evolveKeys} – rename keys using functions
  * @see {@link evolveEntries} – rename keys and transform values
- * @category Key utilities
+ * @category transforming
  * @since 4.0.0
  */
 export const renameKeys: {
@@ -883,19 +880,19 @@ export const renameKeys: {
    *
    * **Example** (Renaming keys)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
    *   { firstName: "Alice", lastName: "Smith", age: 30 },
    *   Struct.renameKeys({ firstName: "first", lastName: "last" })
    * )
-   * console.log(result) // { first: "Alice", last: "Smith", age: 30 }
+   * result // => { first: "Alice", last: "Smith", age: 30 }
    * ```
    *
    * @see {@link evolveKeys} – rename keys using functions
    * @see {@link evolveEntries} – rename keys and transform values
-   * @category Key utilities
+   * @category transforming
    * @since 4.0.0
    */
   <S extends object, const M extends { readonly [K in keyof S]?: PropertyKey }>(mapping: M): (self: S) => { [K in keyof S as K extends keyof M ? M[K] extends PropertyKey ? M[K] : K : K]: S[K] }
@@ -913,19 +910,19 @@ export const renameKeys: {
    *
    * **Example** (Renaming keys)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * const result = pipe(
    *   { firstName: "Alice", lastName: "Smith", age: 30 },
    *   Struct.renameKeys({ firstName: "first", lastName: "last" })
    * )
-   * console.log(result) // { first: "Alice", last: "Smith", age: 30 }
+   * result // => { first: "Alice", last: "Smith", age: 30 }
    * ```
    *
    * @see {@link evolveKeys} – rename keys using functions
    * @see {@link evolveEntries} – rename keys and transform values
-   * @category Key utilities
+   * @category transforming
    * @since 4.0.0
    */
   <S extends object, const M extends { readonly [K in keyof S]?: PropertyKey }>(self: S, mapping: M): { [K in keyof S as K extends keyof M ? M[K] extends PropertyKey ? M[K] : K : K]: S[K] }
@@ -951,7 +948,7 @@ export const renameKeys: {
  *
  * **Example** (Comparing structs for equivalence)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Equivalence, Struct } from "effect"
  *
  * const PersonEquivalence = Struct.makeEquivalence({
@@ -959,10 +956,8 @@ export const renameKeys: {
  *   age: Equivalence.strictEqual<number>()
  * })
  *
- * console.log(PersonEquivalence({ name: "Alice", age: 30 }, { name: "Alice", age: 30 }))
- * // true
- * console.log(PersonEquivalence({ name: "Alice", age: 30 }, { name: "Bob", age: 30 }))
- * // false
+ * PersonEquivalence({ name: "Alice", age: 30 }, { name: "Alice", age: 30 }) // => true
+ * PersonEquivalence({ name: "Alice", age: 30 }, { name: "Bob", age: 30 }) // => false
  * ```
  *
  * @see {@link makeOrder} – create an `Order` for structs
@@ -988,7 +983,7 @@ export const makeEquivalence = Equivalence.Struct
  *
  * **Example** (Ordering structs by name then age)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number, String, Struct } from "effect"
  *
  * const PersonOrder = Struct.makeOrder({
@@ -996,8 +991,7 @@ export const makeEquivalence = Equivalence.Struct
  *   age: Number.Order
  * })
  *
- * console.log(PersonOrder({ name: "Alice", age: 30 }, { name: "Bob", age: 25 }))
- * // -1 (Alice comes before Bob)
+ * PersonOrder({ name: "Alice", age: 30 }, { name: "Bob", age: 25 }) // => -1
  * ```
  *
  * @see {@link makeEquivalence} – create an `Equivalence` for structs
@@ -1023,18 +1017,20 @@ export const makeOrder = order.Struct
  *
  * **Example** (Defining a lambda type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import type { Struct } from "effect"
  *
  * interface ToString extends Struct.Lambda {
  *   readonly "~lambda.out": string
  * }
+ *
+ * const witness: ToString = { "~lambda.in": 1, "~lambda.out": "1" }
  * ```
  *
  * @see {@link Apply} – apply a Lambda to a concrete type
  * @see {@link lambda} – create a runtime lambda value
  * @see {@link map} – use a lambda to transform all struct values
- * @category Lambda
+ * @category utility types
  * @since 4.0.0
  */
 export interface Lambda {
@@ -1058,19 +1054,21 @@ export interface Lambda {
  *
  * **Example** (Computing the output type of a lambda)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import type { Struct } from "effect"
  *
  * interface ToString extends Struct.Lambda {
  *   readonly "~lambda.out": string
  * }
  *
- * // Result is `string`
+ * // string
  * type Result = Struct.Apply<ToString, number>
+ *
+ * const witness: Result = "value"
  * ```
  *
  * @see {@link Lambda} – the base interface
- * @category Lambda
+ * @category utility types
  * @since 4.0.0
  */
 export type Apply<L extends Lambda, V> = (L & { readonly "~lambda.in": V })["~lambda.out"]
@@ -1093,7 +1091,7 @@ export type Apply<L extends Lambda, V> = (L & { readonly "~lambda.in": V })["~la
  *
  * **Example** (Wrapping values in arrays)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * interface AsArray extends Struct.Lambda {
@@ -1103,12 +1101,12 @@ export type Apply<L extends Lambda, V> = (L & { readonly "~lambda.in": V })["~la
  *
  * const asArray = Struct.lambda<AsArray>((a) => [a])
  * const result = pipe({ x: 1, y: "hello" }, Struct.map(asArray))
- * console.log(result) // { x: [1], y: ["hello"] }
+ * result // => { x: [1], y: ["hello"] }
  * ```
  *
  * @see {@link Lambda} – the type-level interface
  * @see {@link map} – apply a lambda to all struct values
- * @category Lambda
+ * @category constructors
  * @since 4.0.0
  */
 export const lambda = <L extends (a: any) => any>(
@@ -1129,7 +1127,7 @@ export const lambda = <L extends (a: any) => any>(
  *
  * **Example** (Wrapping every value in an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * interface AsArray extends Struct.Lambda {
@@ -1139,7 +1137,7 @@ export const lambda = <L extends (a: any) => any>(
  *
  * const asArray = Struct.lambda<AsArray>((a) => [a])
  * const result = pipe({ width: 10, height: 20 }, Struct.map(asArray))
- * console.log(result) // { width: [10], height: [20] }
+ * result // => { width: [10], height: [20] }
  * ```
  *
  * @see {@link mapPick} – apply a lambda only to selected keys
@@ -1163,7 +1161,7 @@ export const map: {
    *
    * **Example** (Wrapping every value in an array)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * interface AsArray extends Struct.Lambda {
@@ -1173,7 +1171,7 @@ export const map: {
    *
    * const asArray = Struct.lambda<AsArray>((a) => [a])
    * const result = pipe({ width: 10, height: 20 }, Struct.map(asArray))
-   * console.log(result) // { width: [10], height: [20] }
+   * result // => { width: [10], height: [20] }
    * ```
    *
    * @see {@link mapPick} – apply a lambda only to selected keys
@@ -1197,7 +1195,7 @@ export const map: {
    *
    * **Example** (Wrapping every value in an array)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * interface AsArray extends Struct.Lambda {
@@ -1207,7 +1205,7 @@ export const map: {
    *
    * const asArray = Struct.lambda<AsArray>((a) => [a])
    * const result = pipe({ width: 10, height: 20 }, Struct.map(asArray))
-   * console.log(result) // { width: [10], height: [20] }
+   * result // => { width: [10], height: [20] }
    * ```
    *
    * @see {@link mapPick} – apply a lambda only to selected keys
@@ -1234,7 +1232,7 @@ export const map: {
  *
  * **Example** (Wrapping only selected values in arrays)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * interface AsArray extends Struct.Lambda {
@@ -1247,7 +1245,7 @@ export const map: {
  *   { x: 1, y: 2, z: 3 },
  *   Struct.mapPick(["x", "z"], asArray)
  * )
- * console.log(result) // { x: [1], y: 2, z: [3] }
+ * result // => { x: [1], y: 2, z: [3] }
  * ```
  *
  * @see {@link map} – apply a lambda to all keys
@@ -1266,7 +1264,7 @@ export const mapPick: {
    *
    * **Example** (Wrapping only selected values in arrays)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * interface AsArray extends Struct.Lambda {
@@ -1279,7 +1277,7 @@ export const mapPick: {
    *   { x: 1, y: 2, z: 3 },
    *   Struct.mapPick(["x", "z"], asArray)
    * )
-   * console.log(result) // { x: [1], y: 2, z: [3] }
+   * result // => { x: [1], y: 2, z: [3] }
    * ```
    *
    * @see {@link map} – apply a lambda to all keys
@@ -1300,7 +1298,7 @@ export const mapPick: {
    *
    * **Example** (Wrapping only selected values in arrays)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * interface AsArray extends Struct.Lambda {
@@ -1313,7 +1311,7 @@ export const mapPick: {
    *   { x: 1, y: 2, z: 3 },
    *   Struct.mapPick(["x", "z"], asArray)
    * )
-   * console.log(result) // { x: [1], y: 2, z: [3] }
+   * result // => { x: [1], y: 2, z: [3] }
    * ```
    *
    * @see {@link map} – apply a lambda to all keys
@@ -1343,7 +1341,7 @@ export const mapPick: {
  *
  * **Example** (Wrapping all values except one in arrays)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { pipe, Struct } from "effect"
  *
  * interface AsArray extends Struct.Lambda {
@@ -1356,7 +1354,7 @@ export const mapPick: {
  *   { x: 1, y: 2, z: 3 },
  *   Struct.mapOmit(["y"], asArray)
  * )
- * console.log(result) // { x: [1], y: 2, z: [3] }
+ * result // => { x: [1], y: 2, z: [3] }
  * ```
  *
  * @see {@link map} – apply a lambda to all keys
@@ -1375,7 +1373,7 @@ export const mapOmit: {
    *
    * **Example** (Wrapping all values except one in arrays)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * interface AsArray extends Struct.Lambda {
@@ -1388,7 +1386,7 @@ export const mapOmit: {
    *   { x: 1, y: 2, z: 3 },
    *   Struct.mapOmit(["y"], asArray)
    * )
-   * console.log(result) // { x: [1], y: 2, z: [3] }
+   * result // => { x: [1], y: 2, z: [3] }
    * ```
    *
    * @see {@link map} – apply a lambda to all keys
@@ -1409,7 +1407,7 @@ export const mapOmit: {
    *
    * **Example** (Wrapping all values except one in arrays)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { pipe, Struct } from "effect"
    *
    * interface AsArray extends Struct.Lambda {
@@ -1422,7 +1420,7 @@ export const mapOmit: {
    *   { x: 1, y: 2, z: 3 },
    *   Struct.mapOmit(["y"], asArray)
    * )
-   * console.log(result) // { x: [1], y: 2, z: [3] }
+   * result // => { x: [1], y: 2, z: [3] }
    * ```
    *
    * @see {@link map} – apply a lambda to all keys
@@ -1464,7 +1462,7 @@ function buildStruct<
     const res = f(k, source[k])
     if (res) {
       const [nk, nv] = res
-      out[nk] = nv
+      InternalRecord.assignProperty(out, nk, nv)
     }
   }
   return out
@@ -1487,7 +1485,7 @@ function buildStruct<
  *
  * **Example** (Combining struct properties)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number, String, Struct } from "effect"
  *
  * const C = Struct.makeCombiner<{ readonly n: number; readonly s: string }>({
@@ -1495,8 +1493,7 @@ function buildStruct<
  *   s: String.ReducerConcat
  * })
  *
- * const result = C.combine({ n: 1, s: "hello" }, { n: 2, s: " world" })
- * console.log(result) // { n: 3, s: "hello world" }
+ * C.combine({ n: 1, s: "hello" }, { n: 2, s: " world" }) // => { n: 3, s: "hello world" }
  * ```
  *
  * @see {@link makeReducer} – like `makeCombiner` but with an initial value
@@ -1516,7 +1513,7 @@ export function makeCombiner<A>(
     for (const key of keys) {
       const merge = combiners[key].combine(self[key], that[key])
       if (omitKeyWhen(merge)) continue
-      out[key] = merge
+      InternalRecord.assignProperty(out as object, key, merge)
     }
     return out
   })
@@ -1540,7 +1537,7 @@ export function makeCombiner<A>(
  *
  * **Example** (Reducing a collection of structs)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number, String, Struct } from "effect"
  *
  * const R = Struct.makeReducer<{ readonly n: number; readonly s: string }>({
@@ -1553,7 +1550,7 @@ export function makeCombiner<A>(
  *   { n: 2, s: "b" },
  *   { n: 3, s: "c" }
  * ])
- * console.log(result) // { n: 6, s: "abc" }
+ * result // => { n: 6, s: "abc" }
  * ```
  *
  * @see {@link makeCombiner} – like `makeReducer` but without an initial value
@@ -1571,7 +1568,7 @@ export function makeReducer<A>(
   for (const key of Reflect.ownKeys(reducers) as Array<keyof A>) {
     const iv = reducers[key].initialValue
     if (options?.omitKeyWhen?.(iv)) continue
-    initialValue[key] = iv
+    InternalRecord.assignProperty(initialValue as object, key, iv)
   }
   return Reducer.make(combine, initialValue)
 }
@@ -1585,11 +1582,10 @@ export function makeReducer<A>(
  *
  * **Example** (Creating a record)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Struct } from "effect"
  *
- * const record = Struct.Record(["a", "b"], "value")
- * console.log(record) // { a: "value", b: "value" }
+ * Struct.Record(["a", "b"], "value") // => { a: "value", b: "value" }
  * ```
  *
  * @category constructors
@@ -1601,7 +1597,7 @@ export function Record<const Keys extends ReadonlyArray<string | symbol>, Value>
 ): Record<Keys[number], Value> {
   const out: any = {}
   for (const key of keys) {
-    out[key] = value
+    InternalRecord.assignProperty(out, key, value)
   }
   return out
 }