effect 4.0.0-beta.102 → 4.0.0-beta.103

package/dist/unstable/cli/Primitive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Primitive.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/Primitive.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAKzC,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,KAAK,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,QAAA,MAAM,MAAM,0BAA0B,CAAA;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,SAAS,CAAC,GAAG,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;CACzE;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;;;OAKG;IACH,UAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC7B,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE;YACjB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;SAC1B,CAAA;KACF;CACF;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,OAAO,CAGtC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,CAAC,MAAM,CAGnC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,CAAC,MAAM,CAGrC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,IAAI,EAAE,SAAS,CAAC,IAAI,CAGhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,CAAC,MAAM,CAA6D,CAAA;AAElG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,WACb,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAC3C,SAAS,CAAC,CAAC,CAUb,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,IAAI,aACL,QAAQ,cACN,OAAO,KAClB,SAAS,CAAC,MAAM,CAsChB,CAAA;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAGzD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,MAAM,CAuCtC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CACnD,CAAA;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,SAAS,aAAc,gBAAgB,KAAG,SAAS,CAAC,OAAO,CAgBvE,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAC7C,gBAAgB,GAAG;IACjB,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;CACxD,CACF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,UAClB,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,WAAW,CAAC,YACtC,iBAAiB,GAAG,SAAS,KACtC,SAAS,CAAC,CAAC,CAYb,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiB1D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,IAAI,EAAE,SAAS,CAAC,KAAK,CAAkF,CAAA;AAEpH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,aAAa,SAAS,CAAC,CAAC,CAAC,KAAG,MA+BxD,CAAA"}
+{"version":3,"file":"Primitive.d.ts","sourceRoot":"","sources":["../../../src/unstable/cli/Primitive.ts"],"names":[],"mappings":"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"}

package/dist/unstable/cli/Primitive.js

@@ -53,23 +53,36 @@ const makeSchemaPrimitive = (tag, schema) => {
  *
  * **Example** (Parsing boolean values)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
- * const parseBoolean = Effect.gen(function*() {
- *   const result1 = yield* Primitive.boolean.parse("true")
- *   console.log(result1) // true
- *
- *   const result2 = yield* Primitive.boolean.parse("yes")
- *   console.log(result2) // true
- *
- *   const result3 = yield* Primitive.boolean.parse("false")
- *   console.log(result3) // false
+ * const parseBoolean = Effect.all([
+ *   Primitive.boolean.parse("true"),
+ *   Primitive.boolean.parse("yes"),
+ *   Primitive.boolean.parse("false"),
+ *   Primitive.boolean.parse("0")
+ * ])
  *
- *   const result4 = yield* Primitive.boolean.parse("0")
- *   console.log(result4) // false
- * })
+ * await Effect.runPromise(parseBoolean.pipe(Effect.provide(CliTestLayer))) // => [true, true, false, false]
  * ```
  *
  * @category constructors
@@ -81,20 +94,35 @@ export const boolean = /*#__PURE__*/makeSchemaPrimitive("Boolean", Config.Boolea
  *
  * **Example** (Parsing floating-point numbers)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
- * const parseFloat = Effect.gen(function*() {
- *   const result1 = yield* Primitive.float.parse("3.14")
- *   console.log(result1) // 3.14
- *
- *   const result2 = yield* Primitive.float.parse("-42.5")
- *   console.log(result2) // -42.5
+ * const parseFloat = Effect.all([
+ *   Primitive.float.parse("3.14"),
+ *   Primitive.float.parse("-42.5"),
+ *   Primitive.float.parse("0")
+ * ])
  *
- *   const result3 = yield* Primitive.float.parse("0")
- *   console.log(result3) // 0
- * })
+ * await Effect.runPromise(parseFloat.pipe(Effect.provide(CliTestLayer))) // => [3.14, -42.5, 0]
  * ```
  *
  * @category constructors
@@ -106,20 +134,35 @@ export const float = /*#__PURE__*/makeSchemaPrimitive("Float", Schema.Finite);
  *
  * **Example** (Parsing integer values)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
- * const parseInteger = Effect.gen(function*() {
- *   const result1 = yield* Primitive.integer.parse("42")
- *   console.log(result1) // 42
- *
- *   const result2 = yield* Primitive.integer.parse("-123")
- *   console.log(result2) // -123
+ * const parseInteger = Effect.all([
+ *   Primitive.integer.parse("42"),
+ *   Primitive.integer.parse("-123"),
+ *   Primitive.integer.parse("0")
+ * ])
  *
- *   const result3 = yield* Primitive.integer.parse("0")
- *   console.log(result3) // 0
- * })
+ * await Effect.runPromise(parseInteger.pipe(Effect.provide(CliTestLayer))) // => [42, -123, 0]
  * ```
  *
  * @category constructors
@@ -131,20 +174,34 @@ export const integer = /*#__PURE__*/makeSchemaPrimitive("Integer", Schema.Int);
  *
  * **Example** (Parsing date values)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * const parseDate = Effect.gen(function*() {
- *   const result1 = yield* Primitive.date.parse("2023-12-25")
- *   console.log(result1) // Date object for December 25, 2023
- *
- *   const result2 = yield* Primitive.date.parse("2023-12-25T10:30:00Z")
- *   console.log(result2) // Date object with time
- *
- *   const result3 = yield* Primitive.date.parse("Dec 25, 2023")
- *   console.log(result3) // Date object parsed from natural format
+ *   const result = yield* Primitive.date.parse("2023-12-25")
+ *   return result.toISOString()
  * })
+ *
+ * await Effect.runPromise(parseDate.pipe(Effect.provide(CliTestLayer))) // => "2023-12-25T00:00:00.000Z"
  * ```
  *
  * @category constructors
@@ -156,20 +213,35 @@ export const date = /*#__PURE__*/makeSchemaPrimitive("Date", Schema.Date);
  *
  * **Example** (Parsing string values)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
- * const parseString = Effect.gen(function*() {
- *   const result1 = yield* Primitive.string.parse("hello world")
- *   console.log(result1) // "hello world"
- *
- *   const result2 = yield* Primitive.string.parse("")
- *   console.log(result2) // ""
+ * const parseString = Effect.all([
+ *   Primitive.string.parse("hello world"),
+ *   Primitive.string.parse(""),
+ *   Primitive.string.parse("123")
+ * ])
  *
- *   const result3 = yield* Primitive.string.parse("123")
- *   console.log(result3) // "123"
- * })
+ * await Effect.runPromise(parseString.pipe(Effect.provide(CliTestLayer))) // => ["hello world", "", "123"]
  * ```
  *
  * @category constructors
@@ -181,9 +253,27 @@ export const string = /*#__PURE__*/makePrimitive("String", value => Effect.succe
  *
  * **Example** (Parsing choices)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * type LogLevel = "debug" | "info" | "warn" | "error"
  *
@@ -194,13 +284,12 @@ export const string = /*#__PURE__*/makePrimitive("String", value => Effect.succe
  *   ["error", "error"]
  * ])
  *
- * const parseLogLevel = Effect.gen(function*() {
- *   const result1 = yield* logLevelPrimitive.parse("info")
- *   console.log(result1) // "info"
+ * const parseLogLevel = Effect.all([
+ *   logLevelPrimitive.parse("info"),
+ *   logLevelPrimitive.parse("debug")
+ * ])
  *
- *   const result2 = yield* logLevelPrimitive.parse("debug")
- *   console.log(result2) // "debug"
- * })
+ * await Effect.runPromise(parseLogLevel.pipe(Effect.provide(CliTestLayer))) // => ["info", "debug"]
  * ```
  *
  * @category constructors
@@ -224,26 +313,38 @@ export const choice = choices => {
  *
  * **Example** (Parsing file system paths)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const services = Layer.mergeAll(
+ *   Path.layer,
+ *   FileSystem.layerNoop({
+ *     exists: () => Effect.succeed(true),
+ *     stat: () => Effect.succeed({ type: "File" } as FileSystem.File.Info)
+ *   }),
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * const program = Effect.gen(function*() {
- *   // Parse a file path that must exist
  *   const filePrimitive = Primitive.path("file", true)
  *   const filePath = yield* filePrimitive.parse("./package.json")
- *   console.log(filePath) // Absolute path to package.json
+ *   return filePath.endsWith("/package.json")
+ * }).pipe(Effect.provide(services))
  *
- *   // Parse a directory path
- *   const dirPrimitive = Primitive.path("directory", false)
- *   const dirPath = yield* dirPrimitive.parse("./src")
- *   console.log(dirPath) // Absolute path to src directory
- *
- *   // Parse any path type
- *   const anyPrimitive = Primitive.path("either", false)
- *   const anyPath = yield* anyPrimitive.parse("./some/path")
- *   console.log(anyPath) // Absolute path
- * })
+ * await Effect.runPromise(program) // => true
  * ```
  *
  * @category constructors
@@ -282,15 +383,34 @@ export const path = (pathType, mustExist) => makePrimitive("Path", Effect.fnUntr
  *
  * **Example** (Parsing redacted values)
  *
- * ```ts
- * import { Effect, Redacted } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Redacted, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * const parseRedacted = Effect.gen(function*() {
  *   const result = yield* Primitive.redacted.parse("secret-password")
- *   console.log(Redacted.value(result)) // "secret-password"
- *   console.log(String(result)) // "<redacted>"
+ *   return [Redacted.value(result), String(result)] as const
  * })
+ *
+ * await Effect.runPromise(parseRedacted.pipe(Effect.provide(CliTestLayer))) // => ["secret-password", "<redacted>"]
  * ```
  *
  * @category constructors
@@ -302,27 +422,38 @@ export const redacted = /*#__PURE__*/makePrimitive("Redacted", value => Effect.s
  *
  * **Example** (Reading file text)
  *
- * ```ts
- * import { Effect, Schema } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
- *
- * const ConfigSchema = Schema.Struct({
- *   name: Schema.String,
- *   version: Schema.String,
- *   port: Schema.Number
- * })
- * const decodeConfig = Schema.decodeUnknownEffect(
- *   Schema.fromJsonString(ConfigSchema)
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const services = Layer.mergeAll(
+ *   Path.layer,
+ *   FileSystem.layerNoop({
+ *     exists: () => Effect.succeed(true),
+ *     stat: () => Effect.succeed({ type: "File" } as FileSystem.File.Info),
+ *     readFileString: () => Effect.succeed('{"private":true}')
+ *   }),
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
  * )
  *
  * const readConfigFile = Effect.gen(function*() {
- *   const content = yield* Primitive.fileText.parse("./config.json")
- *   console.log(content) // {"name":"my-app","version":"1.0.0","port":3000}
+ *   const content = yield* Primitive.fileText.parse("./package.json")
+ *   return JSON.parse(content) as { private: boolean }
+ * }).pipe(Effect.provide(services))
  *
- *   const config = yield* decodeConfig(content)
- *   console.log(config) // { name: "my-app", version: "1.0.0", port: 3000 }
- *   return config
- * })
+ * await Effect.runPromise(readConfigFile) // => { private: true }
  * ```
  *
  * @category constructors
@@ -365,17 +496,40 @@ const fileParsers = {
  *
  * **Example** (Parsing file content)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const services = Layer.mergeAll(
+ *   Path.layer,
+ *   FileSystem.layerNoop({
+ *     exists: () => Effect.succeed(true),
+ *     stat: () => Effect.succeed({ type: "File" } as FileSystem.File.Info),
+ *     readFileString: () => Effect.succeed('{"private":true}')
+ *   }),
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
- * const tomlFilePrimitive = Primitive.fileParse({ format: "toml" })
+ * const jsonFilePrimitive = Primitive.fileParse({ format: "json" })
  *
  * const loadConfig = Effect.gen(function*() {
- *   const config = yield* tomlFilePrimitive.parse("./config.toml")
- *   console.log(config) // { name: "my-app", version: "1.0.0", port: 3000 }
- *   return config
- * })
+ *   const config = yield* jsonFilePrimitive.parse("./package.json")
+ *   return config as { private: boolean }
+ * }).pipe(Effect.provide(services))
+ *
+ * await Effect.runPromise(loadConfig) // => { private: true }
  * ```
  *
  * @category constructors
@@ -400,14 +554,34 @@ export const fileParse = options => {
  *
  * **Example** (Parsing file content with a schema)
  *
- * ```ts
- * import { Effect, Schema } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Schema, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const services = Layer.mergeAll(
+ *   Path.layer,
+ *   FileSystem.layerNoop({
+ *     exists: () => Effect.succeed(true),
+ *     stat: () => Effect.succeed({ type: "File" } as FileSystem.File.Info),
+ *     readFileString: () => Effect.succeed('{"private":true}')
+ *   }),
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * const ConfigSchema = Schema.Struct({
- *   name: Schema.String,
- *   version: Schema.String,
- *   port: Schema.Number
+ *   private: Schema.Boolean
  * })
  *
  * const jsonConfigPrimitive = Primitive.fileSchema(ConfigSchema, {
@@ -415,10 +589,10 @@ export const fileParse = options => {
  * })
  *
  * const loadConfig = Effect.gen(function*() {
- *   const config = yield* jsonConfigPrimitive.parse("./config.json")
- *   console.log(config) // { name: "my-app", version: "1.0.0", port: 3000 }
- *   return config
- * })
+ *   return yield* jsonConfigPrimitive.parse("./package.json")
+ * }).pipe(Effect.provide(services))
+ *
+ * await Effect.runPromise(loadConfig) // => { private: true }
  * ```
  *
  * @category constructors
@@ -436,20 +610,36 @@ export const fileSchema = (schema, options) => {
  *
  * **Example** (Parsing key-value pairs)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
- * const parseKeyValue = Effect.gen(function*() {
- *   const result1 = yield* Primitive.keyValuePair.parse("name=john")
- *   console.log(result1) // { name: "john" }
- *
- *   const result2 = yield* Primitive.keyValuePair.parse("port=3000")
- *   console.log(result2) // { port: "3000" }
+ * const parseKeyValue = Effect.all([
+ *   Primitive.keyValuePair.parse("name=john"),
+ *   Primitive.keyValuePair.parse("port=3000"),
+ *   Primitive.keyValuePair.parse("debug=true")
+ * ])
  *
- *   const result3 = yield* Primitive.keyValuePair.parse("debug=true")
- *   console.log(result3) // { debug: "true" }
- * })
+ * const result = await Effect.runPromise(parseKeyValue.pipe(Effect.provide(CliTestLayer)))
+ * result // => [{ name: "john" }, { port: "3000" }, { debug: "true" }]
  * ```
  *
  * @category constructors
@@ -477,16 +667,34 @@ export const keyValuePair = /*#__PURE__*/makePrimitive("KeyValuePair", /*#__PURE
  *
  * **Example** (Rejecting option values)
  *
- * ```ts
- * import { Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path, Stdio, Terminal } from "effect"
  * import { Primitive } from "effect/unstable/cli"
+ * import { ChildProcessSpawner } from "effect/unstable/process"
+ *
+ * const CliTestLayer = Layer.mergeAll(
+ *   FileSystem.layerNoop({}),
+ *   Path.layer,
+ *   Stdio.layerTest({}),
+ *   Layer.succeed(Terminal.Terminal, Terminal.make({
+ *     columns: Effect.succeed(80),
+ *     rows: Effect.succeed(24),
+ *     readInput: Effect.die("unused"),
+ *     readLine: Effect.die("unused"),
+ *     display: () => Effect.void
+ *   })),
+ *   Layer.succeed(
+ *     ChildProcessSpawner.ChildProcessSpawner,
+ *     ChildProcessSpawner.make(() => Effect.die("unused"))
+ *   )
+ * )
  *
  * const program = Effect.gen(function*() {
  *   // This will always fail - useful for boolean flags
  *   return yield* Primitive.none.parse("any-value")
  * })
  *
- * // The above effect will fail with "This option does not accept values"
+ * await Effect.runPromise(Effect.flip(program).pipe(Effect.provide(CliTestLayer))) // => "This option does not accept values"
  * ```
  *
  * @category constructors
@@ -503,20 +711,20 @@ export const none = /*#__PURE__*/makePrimitive("None", () => Effect.fail("This o
  *
  * **Example** (Getting primitive type names)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Primitive } from "effect/unstable/cli"
  *
- * console.log(Primitive.getTypeName(Primitive.string)) // "string"
- * console.log(Primitive.getTypeName(Primitive.integer)) // "integer"
- * console.log(Primitive.getTypeName(Primitive.boolean)) // "boolean"
- * console.log(Primitive.getTypeName(Primitive.date)) // "date"
- * console.log(Primitive.getTypeName(Primitive.keyValuePair)) // "key=value"
+ * Primitive.getTypeName(Primitive.string) // => "string"
+ * Primitive.getTypeName(Primitive.integer) // => "integer"
+ * Primitive.getTypeName(Primitive.boolean) // => "boolean"
+ * Primitive.getTypeName(Primitive.date) // => "date"
+ * Primitive.getTypeName(Primitive.keyValuePair) // => "key=value"
  *
  * const logLevelChoice = Primitive.choice([
  *   ["debug", "debug"],
  *   ["info", "info"]
  * ])
- * console.log(Primitive.getTypeName(logLevelChoice)) // "choice"
+ * Primitive.getTypeName(logLevelChoice) // => "choice"
  * ```
  *
  * @category getters