effect 4.0.0-rc.112 → 4.0.0-rc.113

package/dist/Config.d.ts

@@ -7,7 +7,7 @@
  *
  * @since 4.0.0
  */
-import type { SourceError } from "./ConfigProvider.ts";
+import type { Path, SourceError } from "./ConfigProvider.ts";
 import * as ConfigProvider from "./ConfigProvider.ts";
 import * as Effect from "./Effect.ts";
 import * as LogLevel_ from "./LogLevel.ts";
@@ -28,7 +28,7 @@ declare const TypeId = "~effect/Config";
  * ```ts import.meta.vitest
  * import { Config } from "effect"
  *
- * Config.isConfig(Config.string("HOST")) // => true
+ * Config.isConfig(Config.String("HOST")) // => true
  * Config.isConfig("not a config") // => false
  * ```
  *
@@ -102,7 +102,7 @@ export interface Config<out T> extends Effect.Effect<T, ConfigError> {
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const upper = Config.string("name").pipe(
+ * const upper = Config.String("name").pipe(
  *   Config.map((s) => s.toUpperCase())
  * )
  *
@@ -110,7 +110,7 @@ export interface Config<out T> extends Effect.Effect<T, ConfigError> {
  * Effect.runSync(upper.parse(provider)) // => "ALICE"
  * ```
  *
- * @see {@link mapOrFail} – when the transformation can fail
+ * @see {@link mapEffect} – when the transformation can fail
  *
  * @category mapping
  * @since 2.0.0
@@ -129,7 +129,7 @@ export declare const map: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const upper = Config.string("name").pipe(
+     * const upper = Config.String("name").pipe(
      *   Config.map((s) => s.toUpperCase())
      * )
      *
@@ -137,7 +137,7 @@ export declare const map: {
      * Effect.runSync(upper.parse(provider)) // => "ALICE"
      * ```
      *
-     * @see {@link mapOrFail} – when the transformation can fail
+     * @see {@link mapEffect} – when the transformation can fail
      *
      * @category mapping
      * @since 2.0.0
@@ -156,7 +156,7 @@ export declare const map: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const upper = Config.string("name").pipe(
+     * const upper = Config.String("name").pipe(
      *   Config.map((s) => s.toUpperCase())
      * )
      *
@@ -164,7 +164,7 @@ export declare const map: {
      * Effect.runSync(upper.parse(provider)) // => "ALICE"
      * ```
      *
-     * @see {@link mapOrFail} – when the transformation can fail
+     * @see {@link mapEffect} – when the transformation can fail
      *
      * @category mapping
      * @since 2.0.0
@@ -184,8 +184,8 @@ export declare const map: {
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const trimmed = Config.string("name").pipe(
- *   Config.mapOrFail((s) => Effect.succeed(s.trim()))
+ * const trimmed = Config.String("name").pipe(
+ *   Config.mapEffect((s) => Effect.succeed(s.trim()))
  * )
  * const provider = ConfigProvider.fromUnknown({ name: " Alice " })
  * Effect.runSync(trimmed.parse(provider)) // => "Alice"
@@ -196,7 +196,7 @@ export declare const map: {
  * @category mapping
  * @since 2.0.0
  */
-export declare const mapOrFail: {
+export declare const mapEffect: {
     /**
      * Transforms the parsed value with a function that may fail.
      *
@@ -210,8 +210,8 @@ export declare const mapOrFail: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const trimmed = Config.string("name").pipe(
-     *   Config.mapOrFail((s) => Effect.succeed(s.trim()))
+     * const trimmed = Config.String("name").pipe(
+     *   Config.mapEffect((s) => Effect.succeed(s.trim()))
      * )
      * const provider = ConfigProvider.fromUnknown({ name: " Alice " })
      * Effect.runSync(trimmed.parse(provider)) // => "Alice"
@@ -236,8 +236,8 @@ export declare const mapOrFail: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const trimmed = Config.string("name").pipe(
-     *   Config.mapOrFail((s) => Effect.succeed(s.trim()))
+     * const trimmed = Config.String("name").pipe(
+     *   Config.mapEffect((s) => Effect.succeed(s.trim()))
      * )
      * const provider = ConfigProvider.fromUnknown({ name: " Alice " })
      * Effect.runSync(trimmed.parse(provider)) // => "Alice"
@@ -276,7 +276,7 @@ export declare const mapOrFail: {
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const hostConfig = Config.string("HOST").pipe(
+ * const hostConfig = Config.String("HOST").pipe(
  *   Config.orElse(() => Config.succeed("localhost"))
  * )
  * const provider = ConfigProvider.fromUnknown({})
@@ -315,7 +315,7 @@ export declare const orElse: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const hostConfig = Config.string("HOST").pipe(
+     * const hostConfig = Config.String("HOST").pipe(
      *   Config.orElse(() => Config.succeed("localhost"))
      * )
      * const provider = ConfigProvider.fromUnknown({})
@@ -354,7 +354,7 @@ export declare const orElse: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const hostConfig = Config.string("HOST").pipe(
+     * const hostConfig = Config.String("HOST").pipe(
      *   Config.orElse(() => Config.succeed("localhost"))
      * )
      * const provider = ConfigProvider.fromUnknown({})
@@ -396,8 +396,8 @@ export declare const orElse: {
  * import { Config, ConfigProvider, Effect } from "effect"
  *
  * const dbConfig = Config.all({
- *   host: Config.string("host"),
- *   port: Config.number("port")
+ *   host: Config.String("host"),
+ *   port: Config.Number("port")
  * })
  *
  * const provider = ConfigProvider.fromUnknown({ host: "localhost", port: 5432 })
@@ -435,7 +435,7 @@ export declare function all<const Arg extends Iterable<Config<any>> | Record<str
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const port = Config.number("port").pipe(Config.withDefault(3000))
+ * const port = Config.Number("port").pipe(Config.withDefault(3000))
  *
  * const provider = ConfigProvider.fromUnknown({})
  * Effect.runSync(port.parse(provider)) // => 3000
@@ -469,7 +469,7 @@ export declare const withDefault: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const port = Config.number("port").pipe(Config.withDefault(3000))
+     * const port = Config.Number("port").pipe(Config.withDefault(3000))
      *
      * const provider = ConfigProvider.fromUnknown({})
      * Effect.runSync(port.parse(provider)) // => 3000
@@ -503,7 +503,7 @@ export declare const withDefault: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const port = Config.number("port").pipe(Config.withDefault(3000))
+     * const port = Config.Number("port").pipe(Config.withDefault(3000))
      *
      * const provider = ConfigProvider.fromUnknown({})
      * Effect.runSync(port.parse(provider)) // => 3000
@@ -538,7 +538,7 @@ export declare const withDefault: {
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect, Option } from "effect"
  *
- * const maybePort = Config.option(Config.number("port"))
+ * const maybePort = Config.option(Config.Number("port"))
  *
  * const provider = ConfigProvider.fromUnknown({})
  * Effect.runSync(maybePort.parse(provider)) // => Option.none()
@@ -612,7 +612,7 @@ type IsPlainObject<A> = [A] extends [Record<string, any>] ? [keyof A] extends [n
  * const makeConfig = (config: Config.Wrap<Options>): Config.Config<Options> =>
  *   Config.unwrap(config)
  *
- * const config = makeConfig({ key: Config.string("key") })
+ * const config = makeConfig({ key: Config.String("key") })
  * const provider = ConfigProvider.fromUnknown({ key: "value" })
  * Effect.runSync(config.parse(provider)) // => { key: "value" }
  * ```
@@ -637,7 +637,7 @@ export declare const unwrap: <T>(wrapped: Wrap<T>) => Config<T>;
  * {@link nested} calls. Pass a single string for a flat key or an array for
  * nested paths.
  *
- * Convenience constructors such as `string`, `number`, and `boolean` delegate
+ * Convenience constructors such as `String`, `Number`, and `Boolean` delegate
  * to this API.
  *
  * The codec is converted to its canonical `StringTree` form. Its encoded shape
@@ -698,133 +698,20 @@ export declare const unwrap: <T>(wrapped: Wrap<T>) => Config<T>;
  * Effect.runSync(DbConfig.parse(provider)) // => { host: "localhost", port: 5432 }
  * ```
  *
- * @see {@link string} / {@link number} / {@link boolean} – shortcuts for
+ * @see {@link String} / {@link Number} / {@link Boolean} – shortcuts for
  *   single-value configs
  *
  * @category schemas
  * @since 4.0.0
  */
 export declare function schema<T>(codec: Schema.ConstraintCodec<T, unknown>, path?: string | ConfigProvider.Path): Config<T>;
-/**
- * Schema for boolean values encoded as strings.
- *
- * **When to use**
- *
- * Use when you need the reusable boolean schema value for `Config.schema` with
- * custom paths.
- *
- * **Details**
- *
- * Accepted string values: `true`, `false`, `yes`, `no`, `on`, `off`, `1`,
- * `0`, `y`, `n` (case-sensitive).
- *
- * @see {@link boolean} – convenience constructor
- *
- * @category schemas
- * @since 4.0.0
- */
-export declare const Boolean: Schema.decodeTo<Schema.Boolean, Schema.Literals<readonly ["true", "yes", "on", "1", "y", "false", "no", "off", "0", "n"]>, never, never>;
-/**
- * Schema for port numbers (integers in 1–65535).
- *
- * **When to use**
- *
- * Use when you need the reusable port schema value for `Config.schema` with
- * custom paths.
- *
- * @see {@link port} – convenience constructor
- *
- * @category schemas
- * @since 4.0.0
- */
-export declare const Port: Schema.Int;
-/**
- * Schema for `LogLevel` string literals.
- *
- * **When to use**
- *
- * Use when you need the reusable log-level schema value for `Config.schema`
- * with custom paths.
- *
- * **Details**
- *
- * Accepted values: `"All"`, `"Fatal"`, `"Error"`, `"Warn"`, `"Info"`,
- * `"Debug"`, `"Trace"`, `"None"`.
- *
- * @see {@link logLevel} – convenience constructor
- *
- * @category schemas
- * @since 4.0.0
- */
-export declare const LogLevel: Schema.Literals<readonly LogLevel_.LogLevel[]>;
-/**
- * Schema for key-value record types that can also be parsed from
- * a flat comma-separated string.
- *
- * **When to use**
- *
- * Use when reading key-value maps from a single env var (e.g. OpenTelemetry
- *   resource attributes).
- *
- * **Details**
- *
- * Accepts either a JSON-like record from the provider or a flat string like
- * `"key1=val1,key2=val2"`. The `separator` (default `","`) and
- * `keyValueSeparator` (default `"="`) can be customized.
- *
- * **Example** (Parsing a comma-separated record)
- *
- * ```ts import.meta.vitest
- * import { Config, ConfigProvider, Effect, Schema } from "effect"
- *
- * const schema = Config.Record(Schema.String, Schema.String)
- * const config = Config.schema(schema, "OTEL_RESOURCE_ATTRIBUTES")
- *
- * const provider = ConfigProvider.fromEnv({
- *   env: {
- *     OTEL_RESOURCE_ATTRIBUTES:
- *       "service.name=my-service,service.version=1.0.0,custom.attribute=value"
- *   }
- * })
- *
- * const result = Effect.runSync(config.parse(provider))
- * result["service.name"] // => "my-service"
- * result["service.version"] // => "1.0.0"
- * result["custom.attribute"] // => "value"
- * ```
- *
- * @see {@link Array} for separated or structural array input
- *
- * @category schemas
- * @since 4.0.0
- */
-export declare const Record: <K extends Schema.Record.Key, V extends Schema.Constraint>(key: K, value: V, options?: {
+interface ArrayOptions {
     readonly separator?: string | undefined;
-    readonly keyValueSeparator?: string | undefined;
-}) => Schema.Union<readonly [Schema.$Record<K, V>, Schema.decodeTo<Schema.toCodecStringTree<Schema.$Record<K, V>>, Schema.String, never, never>]>;
-declare const ArrayConfig: <V extends Schema.Constraint>(value: V, options?: {
+}
+interface RecordOptions {
     readonly separator?: string | undefined;
-}) => Schema.Union<readonly [Schema.decodeTo<Schema.toCodecStringTree<Schema.$Array<V>>, Schema.String, never, never>, Schema.$Array<V>]>;
-export { 
-/**
- * Schema for array types that can also be parsed from a flat separated string.
- *
- * **When to use**
- *
- * Use when reading array values from a single env var, such as comma-separated
- * exporter names.
- *
- * **Details**
- *
- * Accepts either a JSON-like array from the provider or a flat string like
- * `"a,b,c"`. The `separator` defaults to `","` and can be customized.
- *
- * @see {@link Record} for separated or structural record input
- *
- * @category schemas
- * @since 4.0.0
- */
-ArrayConfig as Array };
+    readonly keyValueSeparator?: string | undefined;
+}
 /**
  * Creates a config that always fails with the given error.
  *
@@ -851,7 +738,7 @@ export declare function fail(err: SourceError | Schema.SchemaError): Config<unkn
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const host = Config.string("HOST").pipe(
+ * const host = Config.String("HOST").pipe(
  *   Config.orElse(() => Config.succeed("localhost"))
  * )
  * const provider = ConfigProvider.fromUnknown({})
@@ -878,19 +765,19 @@ export declare function succeed<T>(value: T): Config<T>;
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const host = Config.string("HOST")
+ * const host = Config.String("HOST")
  *
  * const provider = ConfigProvider.fromUnknown({ HOST: "localhost" })
  * Effect.runSync(host.parse(provider)) // => "localhost"
  * ```
  *
- * @see {@link nonEmptyString} – rejects empty strings
+ * @see {@link NonEmptyString} – rejects empty strings
  * @see {@link schema} – for more complex types
  *
  * @category constructors
  * @since 2.0.0
  */
-export declare function string(name?: string): Config<string>;
+export declare function String(name?: string): Config<string>;
 /**
  * Creates a config for a non-empty string value. Fails if the value is an
  * empty string.
@@ -903,12 +790,12 @@ export declare function string(name?: string): Config<string>;
  *
  * Shortcut for `Config.schema(Schema.NonEmptyString, name)`.
  *
- * @see {@link string} for allowing empty strings
+ * @see {@link String} for allowing empty strings
  *
  * @category constructors
  * @since 3.7.0
  */
-export declare function nonEmptyString(name?: string): Config<string>;
+export declare function NonEmptyString(name?: string): Config<string>;
 /**
  * Creates a config for a numeric value (including `NaN`, `Infinity`).
  *
@@ -921,13 +808,13 @@ export declare function nonEmptyString(name?: string): Config<string>;
  *
  * Shortcut for `Config.schema(Schema.Number, name)`.
  *
- * @see {@link finite} for rejecting `NaN` and `Infinity`
- * @see {@link int} for accepting only integers
+ * @see {@link Finite} for rejecting `NaN` and `Infinity`
+ * @see {@link Int} for accepting only integers
  *
  * @category constructors
  * @since 2.0.0
  */
-export declare function number(name?: string): Config<number>;
+export declare function Number(name?: string): Config<number>;
 /**
  * Creates a config for a finite number (rejects `NaN` and `Infinity`).
  *
@@ -939,13 +826,13 @@ export declare function number(name?: string): Config<number>;
  *
  * Shortcut for `Config.schema(Schema.Finite, name)`.
  *
- * @see {@link number} for accepting `NaN` and `Infinity`
- * @see {@link int} for accepting only integers
+ * @see {@link Number} for accepting `NaN` and `Infinity`
+ * @see {@link Int} for accepting only integers
  *
  * @category constructors
  * @since 4.0.0
  */
-export declare function finite(name?: string): Config<number>;
+export declare function Finite(name?: string): Config<number>;
 /**
  * Creates a config for an integer value. Rejects floats.
  *
@@ -957,13 +844,13 @@ export declare function finite(name?: string): Config<number>;
  *
  * Shortcut for `Config.schema(Schema.Int, name)`.
  *
- * @see {@link number} for accepting any number
- * @see {@link port} for accepting only integers in `1` through `65535`
+ * @see {@link Number} for accepting any number
+ * @see {@link Port} for accepting only integers in `1` through `65535`
  *
  * @category constructors
  * @since 4.0.0
  */
-export declare function int(name?: string): Config<number>;
+export declare function Int(name?: string): Config<number>;
 /**
  * Creates a config that only accepts a specific literal value.
  *
@@ -980,16 +867,16 @@ export declare function int(name?: string): Config<number>;
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const env = Config.literal("production", "ENV")
+ * const env = Config.Literal("production", "ENV")
  * const provider = ConfigProvider.fromUnknown({ ENV: "production" })
  * Effect.runSync(env.parse(provider)) // => "production"
  * ```
  *
- * @see {@link literals} – accepts multiple literal values
+ * @see {@link Literals} – accepts multiple literal values
  * @category constructors
  * @since 2.0.0
  */
-export declare function literal<L extends SchemaAST.LiteralValue>(literal: L, name?: string): Config<L>;
+export declare function Literal<L extends SchemaAST.LiteralValue>(literal: L, name?: string): Config<L>;
 /**
  * Creates a config that only accepts one of the specified literal values.
  *
@@ -1006,17 +893,87 @@ export declare function literal<L extends SchemaAST.LiteralValue>(literal: L, na
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const env = Config.literals(["development", "production"], "ENV")
+ * const env = Config.Literals(["development", "production"], "ENV")
  * const provider = ConfigProvider.fromUnknown({ ENV: "development" })
  * Effect.runSync(env.parse(provider)) // => "development"
  * ```
  *
- * @see {@link literal} for accepting one specific literal value
+ * @see {@link Literal} for accepting one specific literal value
  *
  * @category constructors
  * @since 4.0.0
  */
-export declare function literals<const L extends ReadonlyArray<SchemaAST.LiteralValue>>(literals: L, name?: string): Config<L[number]>;
+export declare function Literals<const L extends ReadonlyArray<SchemaAST.LiteralValue>>(literals: L, name?: string): Config<L[number]>;
+/**
+ * Creates a config for array values that may also be read from a separated string.
+ *
+ * **When to use**
+ *
+ * Use when you need to read either structural array input or a flat value such as
+ * `"otlp,console"` from an environment variable.
+ *
+ * **Details**
+ *
+ * Pass a string or `ConfigProvider.Path` as the second argument to set the lookup
+ * path. When no path is needed, pass the options object directly. The `separator`
+ * defaults to `","`.
+ *
+ * **Example** (Reading a comma-separated array)
+ *
+ * ```ts import.meta.vitest
+ * import { Config, ConfigProvider, Effect, Schema } from "effect"
+ *
+ * const config = Config.Array(Schema.String, "EXPORTERS")
+ * const provider = ConfigProvider.fromEnv({ env: { EXPORTERS: "otlp,console" } })
+ *
+ * Effect.runSync(config.parse(provider)) // => ["otlp", "console"]
+ * ```
+ *
+ * @see {@link Record} for key-value input from structural records or separated strings.
+ * @category constructors
+ * @since 4.0.0
+ */
+export declare function Array<V extends Schema.ConstraintCodec<unknown, unknown>>(value: V, options?: ArrayOptions): Config<ReadonlyArray<V["Type"]>>;
+export declare function Array<V extends Schema.ConstraintCodec<unknown, unknown>>(value: V, path: string | Path, options?: ArrayOptions): Config<ReadonlyArray<V["Type"]>>;
+/**
+ * Creates a config for record values that may also be read from a separated key-value string.
+ *
+ * **When to use**
+ *
+ * Use when you need to read either structural record input or a flat value such as
+ * `"service.name=my-service,service.version=1.0.0"` from an environment variable.
+ *
+ * **Details**
+ *
+ * Pass a string or `ConfigProvider.Path` as the third argument to set the lookup
+ * path. When no path is needed, pass the options object directly. The `separator`
+ * defaults to `","` and `keyValueSeparator` defaults to `"="`.
+ *
+ * **Example** (Reading a comma-separated record)
+ *
+ * ```ts import.meta.vitest
+ * import { Config, ConfigProvider, Effect, Schema } from "effect"
+ *
+ * const config = Config.Record(Schema.String, Schema.String, "OTEL_RESOURCE_ATTRIBUTES")
+ * const provider = ConfigProvider.fromEnv({
+ *   env: {
+ *     OTEL_RESOURCE_ATTRIBUTES:
+ *       "service.name=my-service,service.version=1.0.0,custom.attribute=value"
+ *   }
+ * })
+ *
+ * const result = Effect.runSync(config.parse(provider))
+ * result["service.name"] // => "my-service"
+ * result["service.version"] // => "1.0.0"
+ * result["custom.attribute"] // => "value"
+ * ```
+ *
+ * @see {@link Array} for array input from structural arrays or separated strings.
+ * @category constructors
+ * @since 4.0.0
+ */
+export declare function Record<K extends Schema.Record.Key & Schema.ConstraintCodec<unknown, unknown>, V extends Schema.ConstraintCodec<unknown, unknown>>(key: K, value: V, options?: RecordOptions): Config<Schema.Record.Type<K, V>>;
+export declare function Record<K extends Schema.Record.Key & Schema.ConstraintCodec<unknown, unknown>, V extends Schema.ConstraintCodec<unknown, unknown>>(key: K, value: V, path: string | Path, options?: RecordOptions): Config<Schema.Record.Type<K, V>>;
 /**
  * Creates a config for a boolean value parsed from common string
  * representations.
@@ -1027,8 +984,6 @@ export declare function literals<const L extends ReadonlyArray<SchemaAST.Literal
  *
  * **Details**
  *
- * Shortcut for `Config.schema(Config.Boolean, name)`.
- *
  * Accepted values: `true`, `false`, `yes`, `no`, `on`, `off`, `1`, `0`,
  * `y`, `n`.
  *
@@ -1037,7 +992,7 @@ export declare function literals<const L extends ReadonlyArray<SchemaAST.Literal
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const program = Config.boolean("FEATURE_FLAG")
+ * const program = Config.Boolean("FEATURE_FLAG")
  *
  * const provider = ConfigProvider.fromEnv({
  *   env: {
@@ -1050,12 +1005,10 @@ export declare function literals<const L extends ReadonlyArray<SchemaAST.Literal
  * ) // => true
  * ```
  *
- * @see {@link Boolean} for the underlying boolean codec
- *
  * @category constructors
  * @since 2.0.0
  */
-export declare function boolean(name?: string): Config<boolean>;
+export declare function Boolean(name?: string): Config<boolean>;
 /**
  * Creates a config for a `Duration` value parsed from a human-readable
  * string.
@@ -1076,7 +1029,7 @@ export declare function boolean(name?: string): Config<boolean>;
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Duration, Effect } from "effect"
  *
- * const program = Config.duration("DURATION").pipe(Effect.map(Duration.toMillis))
+ * const program = Config.Duration("DURATION").pipe(Effect.map(Duration.toMillis))
  *
  * const provider = ConfigProvider.fromEnv({
  *   env: {
@@ -1094,7 +1047,19 @@ export declare function boolean(name?: string): Config<boolean>;
  * @category constructors
  * @since 2.5.0
  */
-export declare function duration(name?: string): Config<import("./Duration.ts").Duration>;
+export declare function Duration(name?: string): Config<import("./Duration.ts").Duration>;
+/**
+ * Creates a config for an exact, human-readable byte-size value.
+ *
+ * **Details**
+ *
+ * Decimal symbols such as `kB` use powers of 1,000, while binary symbols such
+ * as `KiB` use powers of 1,024.
+ *
+ * @category constructors
+ * @since 4.0.0
+ */
+export declare function ByteSize(name?: string): Config<import("./ByteSize.ts").ByteSize>;
 /**
  * Creates a config for a port number (integer in 1–65535).
  *
@@ -1104,14 +1069,14 @@ export declare function duration(name?: string): Config<import("./Duration.ts").
  *
  * **Details**
  *
- * Shortcut for `Config.schema(Config.Port, name)`.
+ * Accepts integers from `1` through `65535`.
  *
  * **Example** (Reading a port)
  *
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const program = Config.port("PORT")
+ * const program = Config.Port("PORT")
  *
  * const provider = ConfigProvider.fromEnv({
  *   env: {
@@ -1124,13 +1089,12 @@ export declare function duration(name?: string): Config<import("./Duration.ts").
  * ) // => 8080
  * ```
  *
- * @see {@link int} for integer config values outside the port range
- * @see {@link Port} for the underlying port codec
+ * @see {@link Int} for integer config values outside the port range
  *
  * @category constructors
  * @since 3.16.0
  */
-export declare function port(name?: string): Config<number>;
+export declare function Port(name?: string): Config<number>;
 /**
  * Creates a config for a log level string.
  *
@@ -1140,8 +1104,6 @@ export declare function port(name?: string): Config<number>;
  *
  * **Details**
  *
- * Shortcut for `Config.schema(Config.LogLevel, name)`.
- *
  * Accepted values: `"All"`, `"Fatal"`, `"Error"`, `"Warn"`, `"Info"`,
  * `"Debug"`, `"Trace"`, `"None"`.
  *
@@ -1150,7 +1112,7 @@ export declare function port(name?: string): Config<number>;
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const program = Config.logLevel("LOG_LEVEL")
+ * const program = Config.LogLevel("LOG_LEVEL")
  *
  * const provider = ConfigProvider.fromEnv({
  *   env: {
@@ -1163,12 +1125,10 @@ export declare function port(name?: string): Config<number>;
  * ) // => "Info"
  * ```
  *
- * @see {@link LogLevel} for the underlying log-level codec
- *
  * @category constructors
  * @since 2.0.0
  */
-export declare function logLevel(name?: string): Config<LogLevel_.LogLevel>;
+export declare function LogLevel(name?: string): Config<LogLevel_.LogLevel>;
 /**
  * Creates a config for a redacted string value. The parsed result is wrapped
  * in a `Redacted` container that hides the value from logs and `toString`.
@@ -1187,7 +1147,7 @@ export declare function logLevel(name?: string): Config<LogLevel_.LogLevel>;
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const program = Config.redacted("API_KEY").pipe(Effect.map(String))
+ * const program = Config.Redacted("API_KEY").pipe(Effect.map(String))
  *
  * const provider = ConfigProvider.fromEnv({
  *   env: {
@@ -1200,12 +1160,12 @@ export declare function logLevel(name?: string): Config<LogLevel_.LogLevel>;
  * ) // => "<redacted>"
  * ```
  *
- * @see {@link string} for non-secret string settings
+ * @see {@link String} for non-secret string settings
  *
  * @category constructors
  * @since 2.0.0
  */
-export declare function redacted(name?: string): Config<import("./Redacted.ts").Redacted<string>>;
+export declare function Redacted(name?: string): Config<import("./Redacted.ts").Redacted<string>>;
 /**
  * Creates a config for a `URL` value parsed from a string.
  *
@@ -1226,7 +1186,7 @@ export declare function redacted(name?: string): Config<import("./Redacted.ts").
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const program = Config.url("URL").pipe(Effect.map((url) => url.href))
+ * const program = Config.URL("URL").pipe(Effect.map((url) => url.href))
  *
  * const provider = ConfigProvider.fromEnv({
  *   env: {
@@ -1244,7 +1204,7 @@ export declare function redacted(name?: string): Config<import("./Redacted.ts").
  * @category constructors
  * @since 3.11.0
  */
-export declare function url(name?: string): Config<URL>;
+export declare function URL(name?: string): Config<URL>;
 /**
  * Creates a config for a `Date` value parsed from a string.
  *
@@ -1265,7 +1225,7 @@ export declare function url(name?: string): Config<URL>;
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const createdAt = Config.date("CREATED_AT")
+ * const createdAt = Config.Date("CREATED_AT")
  *
  * const provider = ConfigProvider.fromUnknown({ CREATED_AT: "2024-01-15" })
  * Effect.runSync(createdAt.parse(provider)).toISOString() // => "2024-01-15T00:00:00.000Z"
@@ -1274,7 +1234,7 @@ export declare function url(name?: string): Config<URL>;
  * @category constructors
  * @since 2.0.0
  */
-export declare function date(name?: string): Config<Date>;
+export declare function Date(name?: string): Config<Date>;
 /**
  * Scopes a config under a named prefix.
  *
@@ -1297,8 +1257,8 @@ export declare function date(name?: string): Config<Date>;
  * import { Config, ConfigProvider, Effect } from "effect"
  *
  * const dbConfig = Config.all({
- *   host: Config.string("host"),
- *   port: Config.number("port")
+ *   host: Config.String("host"),
+ *   port: Config.Number("port")
  * }).pipe(Config.nested("database"))
  *
  * const provider = ConfigProvider.fromUnknown({
@@ -1312,7 +1272,7 @@ export declare function date(name?: string): Config<Date>;
  * ```ts import.meta.vitest
  * import { Config, ConfigProvider, Effect } from "effect"
  *
- * const host = Config.string("host").pipe(Config.nested("database"))
+ * const host = Config.String("host").pipe(Config.nested("database"))
  *
  * const provider = ConfigProvider.fromEnv({
  *   env: { database_host: "localhost" }
@@ -1349,8 +1309,8 @@ export declare const nested: {
      * import { Config, ConfigProvider, Effect } from "effect"
      *
      * const dbConfig = Config.all({
-     *   host: Config.string("host"),
-     *   port: Config.number("port")
+     *   host: Config.String("host"),
+     *   port: Config.Number("port")
      * }).pipe(Config.nested("database"))
      *
      * const provider = ConfigProvider.fromUnknown({
@@ -1364,7 +1324,7 @@ export declare const nested: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const host = Config.string("host").pipe(Config.nested("database"))
+     * const host = Config.String("host").pipe(Config.nested("database"))
      *
      * const provider = ConfigProvider.fromEnv({
      *   env: { database_host: "localhost" }
@@ -1401,8 +1361,8 @@ export declare const nested: {
      * import { Config, ConfigProvider, Effect } from "effect"
      *
      * const dbConfig = Config.all({
-     *   host: Config.string("host"),
-     *   port: Config.number("port")
+     *   host: Config.String("host"),
+     *   port: Config.Number("port")
      * }).pipe(Config.nested("database"))
      *
      * const provider = ConfigProvider.fromUnknown({
@@ -1416,7 +1376,7 @@ export declare const nested: {
      * ```ts import.meta.vitest
      * import { Config, ConfigProvider, Effect } from "effect"
      *
-     * const host = Config.string("host").pipe(Config.nested("database"))
+     * const host = Config.String("host").pipe(Config.nested("database"))
      *
      * const provider = ConfigProvider.fromEnv({
      *   env: { database_host: "localhost" }
@@ -1432,4 +1392,5 @@ export declare const nested: {
      */
     <A>(self: Config<A>, name: string): Config<A>;
 };
+export {};
 //# sourceMappingURL=Config.d.ts.map