Merge branch 'v1' into draft_arkenv_tanstack_blog

Author: yamcodes

.changeset/pre/core-gzip-clawback.md

@@ -0,0 +1,61 @@
+---
+"@arkenv/core": major
+"@arkenv/standard": major
+---
+
+#### Move issue helpers and safe parsing off the default import
+
+The default `@arkenv/core` and `@arkenv/standard` imports are now the throw
+path only. `formatIssues`, `getSchemaKeys`, and the `EnvIssue` types moved
+to `@arkenv/core/issues` (core). `{ safe: true }` is no longer accepted on
+either package's main `arkenv()`; import `arkenv` from `/safe` instead.
+
+```ts
+import arkenv from "@arkenv/core";
+import { formatIssues } from "@arkenv/core/issues";
+import arkenvSafe from "@arkenv/core/safe";
+
+export const env = arkenv({
+  PORT: "number.port = 3000",
+});
+
+const result = arkenvSafe(
+  { PORT: "number.port" },
+  { env: { PORT: "invalid" } },
+);
+
+if (!result.success) {
+  console.error(formatIssues(result.issues));
+}
+```
+
+`@arkenv/standard` mirrors the same shape:
+
+```ts
+import arkenv from "@arkenv/standard";
+import arkenvSafe from "@arkenv/standard/safe";
+```
+
+`@arkenv/core` now sets `"sideEffects": false` so bundlers can tree-shake
+unused subpaths. Framework packages (Next.js, Nuxt, Vite, Bun) do **not**
+ship a `/safe` subpath.
+
+**BREAKING CHANGE**: Issue helpers moved to `@arkenv/core/issues`.
+`{ safe: true }` on `arkenv()` is replaced by `arkenv` from
+`@arkenv/core/safe` / `@arkenv/standard/safe`.
+
+```diff
+- import arkenv, { formatIssues } from "@arkenv/core";
+- const result = arkenv(schema, { safe: true });
++ import arkenv from "@arkenv/core";
++ import { formatIssues } from "@arkenv/core/issues";
++ import arkenvSafe from "@arkenv/core/safe";
++ const result = arkenvSafe(schema);
+```
+
+```diff
+- import arkenv from "@arkenv/standard";
+- const result = arkenv(schema, { safe: true });
++ import arkenv from "@arkenv/standard/safe";
++ const result = arkenv(schema);
+```

.changeset/publish-pure-esm-only.md .changeset/pre/publish-pure-esm-only.md.changeset/publish-pure-esm-only.md renamed to .changeset/pre/publish-pure-esm-only.md

@@ -0,0 +1,27 @@
+---
+"@arkenv/rsbuild-plugin": minor
+---
+
+#### Add `@arkenv/rsbuild-plugin` for Rsbuild and TanStack Start
+
+The new `@arkenv/rsbuild-plugin` brings the same server/client env path as `@arkenv/vite-plugin` to Rsbuild projects, including TanStack Start apps built with Rsbuild:
+
+- **Client rewrite**: in `web` and `web-worker` environments, the `env.ts` module is replaced with a scrubbed client module — public/shared keys (default prefix `PUBLIC_`) are inlined as coerced literals and server-only keys become throwing getters, so secrets never reach the browser bundle.
+- **Server passthrough**: in `node` environments the real `env.ts` runs unchanged against the deployment environment.
+- **Build-time validation**: the schema is validated via `@arkenv/build` before each environment compiles; missing or invalid required variables fail the build before assets are emitted.
+- **Dev reload**: the schema and `.env*` files are registered as build dependencies, so edits re-validate and refresh inlined values during `rsbuild dev`.
+- **Standard Schema**: an `@arkenv/rsbuild-plugin/standard` entry mirrors the ArkType-free path of `@arkenv/vite-plugin/standard`.
+
+Usage:
+
+```ts
+// rsbuild.config.ts
+import { defineConfig } from "@rsbuild/core";
+import { arkenvPlugin } from "@arkenv/rsbuild-plugin";
+
+export default defineConfig({
+  plugins: [arkenvPlugin({ schemaPath: "src/env.ts" })],
+});
+```
+
+Install with `npm install @arkenv/rsbuild-plugin arktype`.

.changeset/pre/rsbuild-plugin.md

@@ -3,8 +3,6 @@ dist
 .output
 .vercel
 .netlify
-.vinxi
-app.config.timestamp_*.js
 
 # Environment
 .env

.changeset/tanstack-start-detection.md …hangeset/pre/tanstack-start-detection.md.changeset/tanstack-start-detection.md renamed to .changeset/pre/tanstack-start-detection.md .changeset/tanstack-start-detection.md renamed to .changeset/pre/tanstack-start-detection.md

@@ -20,14 +20,14 @@ export const env = arkenv({
 });
 ```
 
-```ts title="app.config.ts"
+```ts title="vite.config.ts"
 import arkenvVitePlugin from "@arkenv/vite-plugin";
-import { defineConfig } from "@solidjs/start/config";
+import { solidStart } from "@solidjs/start/config";
+import { nitro } from "nitro/vite";
+import { defineConfig } from "vite";
 
 export default defineConfig({
-  vite: {
-    plugins: [arkenvVitePlugin()],
-  },
+  plugins: [solidStart(), nitro(), arkenvVitePlugin()],
 });
 ```
 
@@ -52,8 +52,8 @@ pnpm dev
 # Build for production
 pnpm build
 
-# Start production server
-pnpm start
+# Locally preview production build
+pnpm preview
 ```
 
 ## Documentation

apps/playgrounds/solid-start/.gitignore

@@ -3,20 +3,21 @@
 	"type": "module",
 	"private": true,
 	"scripts": {
-		"dev": "vinxi dev",
-		"build": "vinxi build",
-		"start": "vinxi start"
+		"dev": "vite dev",
+		"build": "vite build",
+		"preview": "vite preview"
 	},
 	"dependencies": {
 		"@arkenv/core": "workspace:*",
 		"@arkenv/vite-plugin": "workspace:*",
-		"@solidjs/start": "1.3.2",
+		"@solidjs/start": "^2.0.4",
 		"arktype": "catalog:",
+		"nitro": "3.0.260903-beta",
 		"solid-js": "1.9.12",
-		"vinxi": "0.5.11"
+		"vite": "8.0.10"
 	},
 	"engines": {
-		"node": ">=22"
+		"node": ">=24"
 	},
 	"arkenvExamples": [
 		{

apps/playgrounds/solid-start/README.md

@@ -10,7 +10,7 @@
 		"allowJs": true,
 		"strict": true,
 		"noEmit": true,
-		"types": ["vinxi/types/client"],
+		"types": ["@solidjs/start/env"],
 		"isolatedModules": true,
 		"paths": {
 			"~/*": ["./src/*"]

apps/playgrounds/solid-start/app.config.ts

@@ -0,0 +1,8 @@
+import arkenvVitePlugin from "@arkenv/vite-plugin";
+import { solidStart } from "@solidjs/start/config";
+import { nitro } from "nitro/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+	plugins: [solidStart(), nitro(), arkenvVitePlugin()],
+});