@arkenv/core 1.0.0-alpha.5 → 1.0.0-alpha.7

package/dist/index.cjs

@@ -487,6 +487,38 @@ function getSchemaKeys(schema) {
 	} catch {}
 	return Object.keys(schema);
 }
+const SCHEMA_CAPTURE_KEY = "__ARKENV_SCHEMA_CAPTURE__";
+/**
+* Read the process-global schema-capture bag so separately loaded copies of
+* `@arkenv/core` / `@arkenv/standard` (for example via Jiti) share one flag.
+*
+* @returns The shared capture state
+*/
+function getSchemaCaptureState() {
+	const globals = globalThis;
+	if (!globals[SCHEMA_CAPTURE_KEY]) globals[SCHEMA_CAPTURE_KEY] = {
+		capturing: false,
+		definitions: []
+	};
+	return globals[SCHEMA_CAPTURE_KEY];
+}
+/**
+* Report whether schema capture mode is active.
+*
+* @returns `true` when {@link beginSchemaCapture} is in effect
+*/
+function isCapturingSchema() {
+	return getSchemaCaptureState().capturing;
+}
+/**
+* Record an `arkenv()` schema definition while capture mode is active.
+*
+* @param def The schema definition passed to `arkenv()`
+*/
+function recordSchemaCapture(def) {
+	const state = getSchemaCaptureState();
+	if (state.capturing) state.definitions.push(def);
+}
 
 //#endregion
 //#region src/arktype/index.ts
@@ -604,13 +636,17 @@ function parse(def, config) {
 		};
 	} : void 0);
 	const validatedEnv = schemaWithKeys(coercedEnv);
-	if (validatedEnv instanceof arktype.ArkErrors) throw new ArkEnvError(arkErrorsToIssues(validatedEnv, config));
+	if (validatedEnv instanceof arktype.ArkErrors || validatedEnv && typeof validatedEnv === "object" && (validatedEnv[" arkKind"] === "errors" || "byPath" in validatedEnv && typeof validatedEnv.byPath === "object")) throw new ArkEnvError(arkErrorsToIssues(validatedEnv, config));
 	return validatedEnv;
 }
 
 //#endregion
 //#region src/arkenv.ts
 function arkenv(def, config = {}) {
+	if (isCapturingSchema()) {
+		recordSchemaCapture(def);
+		return {};
+	}
 	if (config.safe) return safeExecute(() => parse(def, config));
 	return parse(def, config);
 }

package/dist/index.d.cts

@@ -6102,15 +6102,12 @@ type SafeArkEnvResult<T> = {
  * @returns An array of extracted key names
  */
 declare function getSchemaKeys(schema: any): string[]; //#endregion
-//#region src/utils/errors.d.ts
+//#region src/schema-capture.d.ts
 /**
- * Map a Standard Schema validation issue to a normalized EnvIssueCode.
+ * Start recording `arkenv()` schema arguments instead of validating the environment.
  *
- * @param engineCode The raw issue code from the Standard Schema engine
- * @param message The error message associated with the issue
- * @param receivedVal The raw value received by the validator
- * @returns The normalized EnvIssueCode classification
- * @internal
+ * CLI-supporting API: tools such as the ArkEnv CLI use this to inspect a user's
+ * schema module without requiring `process.env` to be populated.
  */
 //#endregion
 //#region ../internal/scope/dist/index.d.ts
@@ -6457,7 +6454,7 @@ type ArkenvOutput<T extends SchemaShape, D> = distill.Out<type$1.infer<T, $$1>>
  *
  * @param def The schema definition
  * @param config The evaluation configuration
- * @returns The parsed environment variables, or a SafeArkEnvResult if `{ safe: true }` is configured
+ * @returns The parsed environment variables, a SafeArkEnvResult if `{ safe: true }` is configured, or a value-less stub when schema capture is active
  * @throws An {@link ArkEnvError | error} if the environment variables are invalid and `safe` is not enabled
  */
 declare function arkenv<const T extends SchemaShape>(def: EnvSchema<T>, config?: ArkEnvConfig & {