feat: Make env/internal/shared.ts optional in strict layout (dev/v0)

[yamcodes]

Fixes #1448

Summary

• Strict layout auto-detect and findSchemaPath now treat client.ts + server.ts as enough; internal/shared.ts is optional (empty when absent)
• Explicit layout: "strict" only requires client.ts
• Docs updated to describe shared as optional; CLI still scaffolds it by default

Test plan

• Confirm pnpm run typecheck / pnpm run test -- --run / pnpm run fix pass
• Strict env/ with only client.ts + server.ts auto-detects as strict
• layout: "strict" succeeds without internal/shared.ts
• CLI init --strict still scaffolds shared.ts

Made with Cursor

[changeset-bot]

🦋 Changeset detected

Latest commit: 8884fae

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@arkenv/build	Patch
@arkenv/nextjs	Patch
@arkenv/nuxt	Patch
@arkenv/bun-plugin	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

Open in StackBlitz

arkenv

npm i https://pkg.pr.new/arkenv@1503

@arkenv/build

npm i https://pkg.pr.new/@arkenv/build@1503

@arkenv/bun-plugin

npm i https://pkg.pr.new/@arkenv/bun-plugin@1503

@arkenv/cli

npm i https://pkg.pr.new/@arkenv/cli@1503

@arkenv/fumadocs-ui

npm i https://pkg.pr.new/@arkenv/fumadocs-ui@1503

@arkenv/nextjs

npm i https://pkg.pr.new/@arkenv/nextjs@1503

@arkenv/nuxt

npm i https://pkg.pr.new/@arkenv/nuxt@1503

@arkenv/vite-plugin

npm i https://pkg.pr.new/@arkenv/vite-plugin@1503

commit: 8884fae

[arkenv-bot]

📦 Bundle Size Report

Package	Size	Limit	Diff	Status
@arkenv/nextjs	1.32 kB	2.93 kB	0.0%	✅
@arkenv/nextjs/shared	1.15 kB	1.46 kB	0.0%	✅
@arkenv/nextjs/server	1.21 kB	1.95 kB	0.0%	✅
@arkenv/nextjs/client	1.21 kB	1.95 kB	0.0%	✅
@arkenv/nextjs/config	3.55 kB	3.91 kB	-0.3%	✅

✅ All size limits passed!

[pullfrog]

✅ No new issues found.

Reviewed changes — makes env/internal/shared.ts optional in strict layout by extracting a shared isStrictLayoutDir() helper and relaxing the auto-detection and explicit-validation checks to require only client.ts + server.ts.

• Extract isStrictLayoutDir() — new exported function in packages/build/src/index.ts that checks for client.ts + server.ts without touching shared.ts. Replaces the old inline checkStrict closure at all 4 call sites.
• Relax resolveLayout explicit validation — layout: "strict" now only requires client.ts to exist; the sharedPath check is removed. Error message updated accordingly.
• Update findSchemaPath — uses isStrictLayoutDir() so directories without shared.ts are discovered as strict layouts.
• Documentation updates — Next.js and Nuxt strict-layout docs, plus JSDoc on both ArkEnvConfigOptions.layout types now describe shared.ts as optional.
• Tests — 4 new tests in packages/build/src/index.test.ts covering auto-detection, findSchemaPath, and explicit-strict-without-client error path.

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) (GPT Sol not used — the program covers this model; add its provider key to run your pick) ｜ 𝕏}