yamcodes · yamcodes · Jan 5, 2026 · Jan 4, 2026
diff --git a/.changeset/silly-bats-rush.md b/.changeset/silly-bats-rush.md
diff --git a/.changeset/smooth-garlics-lay.md b/.changeset/smooth-garlics-lay.md
diff --git a/packages/arkenv/CHANGELOG.md b/packages/arkenv/CHANGELOG.md
@@ -1,5 +1,52 @@
 # ArkEnv
 
+## 0.8.2
+
+### Patch Changes
+
+- #### Array coercion _[`#693`](https://github.com/yamcodes/arkenv/pull/693) [`7919b6d`](https://github.com/yamcodes/arkenv/commit/7919b6dcd171553d0e6e6e819a862408284e1f71) [@yamcodes](https://github.com/yamcodes)_
+
+  ArkEnv now coerces arrays when the `coerce` option is enabled (true by default).
+  Arrays are parsed using trimmed, comma-separated values by default.
+
+  You can customize this behavior with the `arrayFormat` option:
+
+  - `comma` (default): Strings are split by comma-separated values and trimmed.
+  - `json`: Strings are parsed as JSON.
+
+  Example:
+
+  ```dotenv
+  MY_ARRAY=one,two,three
+  MY_JSON_ARRAY=["a", "b"]
+  ```
+
+  ```ts
+  const env = arkenv(
+    {
+      MY_ARRAY: "string[]",
+    },
+    {
+      // optional, 'comma' is default
+      arrayFormat: "comma",
+    }
+  );
+
+  console.log(env.MY_ARRAY); // ["one", "two", "three"]
+
+  // Using JSON format
+  const jsonEnv = arkenv(
+    {
+      MY_JSON_ARRAY: "string[]",
+    },
+    {
+      arrayFormat: "json",
+    }
+  );
+
+  console.log(jsonEnv.MY_JSON_ARRAY); // ["a", "b"]
+  ```
+
 ## 0.8.1
 
 ### Patch Changes

diff --git a/packages/arkenv/package.json b/packages/arkenv/package.json
@@ -1,7 +1,7 @@
 {
 	"name": "arkenv",
 	"type": "module",
-	"version": "0.8.1",
+	"version": "0.8.2",
 	"main": "./dist/index.cjs",
 	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",

diff --git a/packages/bun-plugin/CHANGELOG.md b/packages/bun-plugin/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @arkenv/bun-plugin
 
+## 0.0.7
+
+### Patch Changes
+
+<details><summary>Updated 1 dependency</summary>
+
+<small>
+
+[`7919b6d`](https://github.com/yamcodes/arkenv/commit/7919b6dcd171553d0e6e6e819a862408284e1f71)
+
+</small>
+
+- `arkenv@0.8.2`
+
+</details>
+
 ## 0.0.6
 
 ### Patch Changes

diff --git a/packages/bun-plugin/package.json b/packages/bun-plugin/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "@arkenv/bun-plugin",
-	"version": "0.0.6",
+	"version": "0.0.7",
 	"author": "Yam Borodetsky <yam@yam.codes>",
 	"repository": {
 		"type": "git",

diff --git a/packages/internal/keywords/CHANGELOG.md b/packages/internal/keywords/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @repo/keywords
 
+## 0.2.0
+
+### Minor Changes
+
+- #### Rename `maybeParsedNumber`/`maybeParsedBoolean` to `maybeNumber`/`maybeBoolean` _[`#693`](https://github.com/yamcodes/arkenv/pull/693) [`7919b6d`](https://github.com/yamcodes/arkenv/commit/7919b6dcd171553d0e6e6e819a862408284e1f71) [@yamcodes](https://github.com/yamcodes)_
+
+  Rename these types for brevity and clarity.
+
 ## 0.1.0
 
 ### Minor Changes

diff --git a/packages/internal/keywords/package.json b/packages/internal/keywords/package.json
@@ -2,7 +2,7 @@
 	"name": "@repo/keywords",
 	"private": true,
 	"type": "module",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"main": "./dist/index.cjs",
 	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",

diff --git a/packages/internal/scope/CHANGELOG.md b/packages/internal/scope/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @repo/scope
 
+## 0.1.1
+
+### Patch Changes
+
+<details><summary>Updated 1 dependency</summary>
+
+<small>
+
+[`7919b6d`](https://github.com/yamcodes/arkenv/commit/7919b6dcd171553d0e6e6e819a862408284e1f71)
+
+</small>
+
+- `@repo/keywords@0.2.0`
+
+</details>
+
 ## 0.1.0
 
 ### Minor Changes

diff --git a/packages/internal/scope/package.json b/packages/internal/scope/package.json
@@ -2,7 +2,7 @@
 	"name": "@repo/scope",
 	"private": true,
 	"type": "module",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"main": "./dist/index.cjs",
 	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",

diff --git a/packages/internal/types/CHANGELOG.md b/packages/internal/types/CHANGELOG.md
@@ -1,5 +1,19 @@
 # @repo/types
 
+## 0.0.5
+
+### Patch Changes
+
+<details><summary>Updated 1 dependency</summary>
+
+<small>
+
+</small>
+
+- `@repo/scope@0.1.1`
+
+</details>
+
 ## 0.0.4
 
 ### Patch Changes

diff --git a/packages/internal/types/package.json b/packages/internal/types/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "@repo/types",
-	"version": "0.0.4",
+	"version": "0.0.5",
 	"type": "module",
 	"private": true,
 	"description": "Internal TypeScript types shared across ArkEnv packages",

diff --git a/packages/vite-plugin/CHANGELOG.md b/packages/vite-plugin/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @arkenv/vite-plugin
 
+## 0.0.25
+
+### Patch Changes
+
+<details><summary>Updated 1 dependency</summary>
+
+<small>
+
+[`7919b6d`](https://github.com/yamcodes/arkenv/commit/7919b6dcd171553d0e6e6e819a862408284e1f71)
+
+</small>
+
+- `arkenv@0.8.2`
+
+</details>
+
 ## 0.0.24
 
 ### Patch Changes

diff --git a/packages/vite-plugin/package.json b/packages/vite-plugin/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "@arkenv/vite-plugin",
-	"version": "0.0.24",
+	"version": "0.0.25",
 	"author": "Yam Borodetsky <yam@yam.codes>",
 	"repository": {
 		"type": "git",