@deepseek-ai/schemastery 3.18.2 → 3.18.4

package/README.md

@@ -387,3 +387,7 @@ const schema2 = new Schema(JSON.parse(JSON.stringify(schema1)))
 
 Schemastery also exposes the Standard Schema `~standard` property, so compatible
 tools can validate values without depending on Schemastery-specific APIs.
+
+## Volatile configuration
+
+`.volatile()` preserves a field's schema type and metadata while parsing its value into a stable reference read with `.get()`. Defaults remain ordinary data; absent optional fields return references containing `undefined`. `simplify()` unwraps references for persistence. See the [configuration guide](../../docs/cordis-tutorial/05-config.md#volatile-fields) for supported placements and Cordis update semantics.

package/lib/index.cjs

@@ -175,6 +175,7 @@ Schema.prototype.pattern = function pattern(regexp) {
 	return schema;
 };
 Schema.prototype.simplify = function simplify(value) {
+	if ((0, _deepseek_ai_cosmokit.isVolatile)(value)) value = value.get();
 	if ((0, _deepseek_ai_cosmokit.deepEqual)(value, this.meta.default, this.type === "dict")) return null;
 	if ((0, _deepseek_ai_cosmokit.isNullable)(value)) return value;
 	if (this.type === "object" || this.type === "dict") {
@@ -231,12 +232,49 @@ for (const key of [
 	};
 	return schema;
 } });
+Schema.prototype.volatile = function volatile() {
+	if (this.meta.volatile) throw new TypeError("volatile schema is already wrapped");
+	return this.extra("volatile", true);
+};
 const resolvers = {};
+const checkedVolatile = Symbol("checked-volatile-schema");
+function validateVolatileSchema(schema, path = [], blocked = false, seen = /* @__PURE__ */ new Map()) {
+	const states = seen.get(schema) ?? /* @__PURE__ */ new Set();
+	if (states.has(blocked)) return;
+	states.add(blocked);
+	seen.set(schema, states);
+	if (schema.meta?.volatile && blocked) throw new ValidationError("volatile fields require a fixed object path without an enclosing volatile field", { path });
+	const nested = blocked || !!schema.meta?.volatile;
+	if (schema.dict) for (const [key, child] of Object.entries(schema.dict)) validateVolatileSchema(child, [...path, key], nested, seen);
+	if (schema.sKey) validateVolatileSchema(schema.sKey, [...path, "<key>"], true, seen);
+	if (schema.inner && (schema.type !== "lazy" || schema.inner[kSchema])) validateVolatileSchema(schema.inner, [...path, "*"], true, seen);
+	if (schema.list) for (let index = 0; index < schema.list.length; index++) validateVolatileSchema(schema.list[index], [...path, String(index)], true, seen);
+}
 Schema.extend = function extend(type, resolve) {
 	resolvers[type] = resolve;
 };
 Schema.resolve = function resolve(data, schema, options = {}, strict = false) {
 	if (!schema) return [data];
+	if (!options[checkedVolatile]) {
+		validateVolatileSchema(schema, options.path);
+		options = {
+			...options,
+			[checkedVolatile]: true
+		};
+	}
+	if (schema.meta?.volatile) {
+		const inner = Schema(schema);
+		inner.meta = {
+			...schema.meta,
+			volatile: false
+		};
+		const [value, adapted] = Schema.resolve(data, inner, options, strict);
+		try {
+			return [(0, _deepseek_ai_cosmokit.createVolatile)(value), adapted];
+		} catch (error) {
+			throw new ValidationError(error instanceof Error ? error.message : String(error), options);
+		}
+	}
 	if (options.ignore?.(data, schema)) return [data];
 	if ((0, _deepseek_ai_cosmokit.isNullable)(data) && schema.type !== "lazy") {
 		if (schema.meta.required) throw new ValidationError(`missing required value`, options);
@@ -339,6 +377,7 @@ Schema.extend("lazy", (data, schema, options, strict) => {
 			...schema.meta,
 			...schema.inner.meta
 		};
+		validateVolatileSchema(schema.inner, options.path, true);
 	}
 	return Schema.resolve(data, schema.inner, options, strict);
 });
@@ -438,7 +477,7 @@ function property(data, key, schema, options) {
 	} catch (e) {
 		if (!options?.autofix) throw e;
 		delete data[key];
-		return schema.meta.default;
+		return schema.meta.volatile ? (0, _deepseek_ai_cosmokit.createVolatile)(schema.meta.default) : schema.meta.default;
 	}
 }
 Schema.extend("array", (data, { inner, meta }, options) => {

package/lib/index.mjs

@@ -1,4 +1,4 @@
-import { Binary, clone, deepEqual, filterKeys, isNullable, isPlainObject, pick, valueMap } from "@deepseek-ai/cosmokit";
+import { Binary, clone, createVolatile, deepEqual, filterKeys, isNullable, isPlainObject, isVolatile, pick, valueMap } from "@deepseek-ai/cosmokit";
 //#region lib/types/index.js
 const kSchema = Symbol.for("schemastery");
 const kValidationError = Symbol.for("ValidationError");
@@ -175,6 +175,7 @@ Schema.prototype.pattern = function pattern(regexp) {
 	return schema;
 };
 Schema.prototype.simplify = function simplify(value) {
+	if (isVolatile(value)) value = value.get();
 	if (deepEqual(value, this.meta.default, this.type === "dict")) return null;
 	if (isNullable(value)) return value;
 	if (this.type === "object" || this.type === "dict") {
@@ -231,12 +232,49 @@ for (const key of [
 	};
 	return schema;
 } });
+Schema.prototype.volatile = function volatile() {
+	if (this.meta.volatile) throw new TypeError("volatile schema is already wrapped");
+	return this.extra("volatile", true);
+};
 const resolvers = {};
+const checkedVolatile = Symbol("checked-volatile-schema");
+function validateVolatileSchema(schema, path = [], blocked = false, seen = /* @__PURE__ */ new Map()) {
+	const states = seen.get(schema) ?? /* @__PURE__ */ new Set();
+	if (states.has(blocked)) return;
+	states.add(blocked);
+	seen.set(schema, states);
+	if (schema.meta?.volatile && blocked) throw new ValidationError("volatile fields require a fixed object path without an enclosing volatile field", { path });
+	const nested = blocked || !!schema.meta?.volatile;
+	if (schema.dict) for (const [key, child] of Object.entries(schema.dict)) validateVolatileSchema(child, [...path, key], nested, seen);
+	if (schema.sKey) validateVolatileSchema(schema.sKey, [...path, "<key>"], true, seen);
+	if (schema.inner && (schema.type !== "lazy" || schema.inner[kSchema])) validateVolatileSchema(schema.inner, [...path, "*"], true, seen);
+	if (schema.list) for (let index = 0; index < schema.list.length; index++) validateVolatileSchema(schema.list[index], [...path, String(index)], true, seen);
+}
 Schema.extend = function extend(type, resolve) {
 	resolvers[type] = resolve;
 };
 Schema.resolve = function resolve(data, schema, options = {}, strict = false) {
 	if (!schema) return [data];
+	if (!options[checkedVolatile]) {
+		validateVolatileSchema(schema, options.path);
+		options = {
+			...options,
+			[checkedVolatile]: true
+		};
+	}
+	if (schema.meta?.volatile) {
+		const inner = Schema(schema);
+		inner.meta = {
+			...schema.meta,
+			volatile: false
+		};
+		const [value, adapted] = Schema.resolve(data, inner, options, strict);
+		try {
+			return [createVolatile(value), adapted];
+		} catch (error) {
+			throw new ValidationError(error instanceof Error ? error.message : String(error), options);
+		}
+	}
 	if (options.ignore?.(data, schema)) return [data];
 	if (isNullable(data) && schema.type !== "lazy") {
 		if (schema.meta.required) throw new ValidationError(`missing required value`, options);
@@ -339,6 +377,7 @@ Schema.extend("lazy", (data, schema, options, strict) => {
 			...schema.meta,
 			...schema.inner.meta
 		};
+		validateVolatileSchema(schema.inner, options.path, true);
 	}
 	return Schema.resolve(data, schema.inner, options, strict);
 });
@@ -438,7 +477,7 @@ function property(data, key, schema, options) {
 	} catch (e) {
 		if (!options?.autofix) throw e;
 		delete data[key];
-		return schema.meta.default;
+		return schema.meta.volatile ? createVolatile(schema.meta.default) : schema.meta.default;
 	}
 }
 Schema.extend("array", (data, { inner, meta }, options) => {

package/lib/types/index.d.ts

@@ -1,12 +1,13 @@
 import { Binary, type Dict } from '@deepseek-ai/cosmokit';
+import { type Volatile } from '@deepseek-ai/cosmokit';
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 declare const kSchema: unique symbol;
 declare global {
     namespace Schemastery {
         /** Convert primitive constructors, constants, and existing schemas into a schema type. */
-        type From<X> = X extends string | number | boolean ? Schema<X> : X extends Schema ? X : X extends typeof String ? Schema<string> : X extends typeof Number ? Schema<number> : X extends typeof Boolean ? Schema<boolean> : X extends typeof Function ? Schema<Function, (...args: any[]) => any> : X extends Constructor<infer S> ? Schema<S> : never;
-        type TypeS1<X> = X extends Schema<infer S, unknown> ? S : never;
-        type Inverse<X> = X extends Schema<any, infer Y> ? (arg: Y) => void : never;
+        type From<X> = X extends string | number | boolean ? Schema<X> : X extends Schema<any, any, SchemaMode> ? X : X extends typeof String ? Schema<string> : X extends typeof Number ? Schema<number> : X extends typeof Boolean ? Schema<boolean> : X extends typeof Function ? Schema<Function, (...args: any[]) => any> : X extends Constructor<infer S> ? Schema<S> : never;
+        type TypeS1<X> = X extends Schema<infer S, infer _T, infer _M> ? S : never;
+        type Inverse<X> = X extends Schema<infer _S, infer T, infer M> ? (arg: SchemaOutput<T, M>) => void : never;
         /** Input type accepted by a schema-like value. */
         type TypeS<X> = TypeS1<From<X>>;
         /** Output type returned by a schema-like value after validation. */
@@ -14,7 +15,7 @@ declare global {
         /** Resolver callback used by custom schema types registered with `Schema.extend()`. */
         type Resolve = (data: any, schema: Schema, options: Options, strict?: boolean) => [any, any?];
         /** Input type accepted by one schema in an intersection. */
-        type IntersectS<X> = From<X> extends Schema<infer S, unknown> ? S : never;
+        type IntersectS<X> = From<X> extends Schema<infer S, infer _T, infer _M> ? S : never;
         /** Output type returned by one schema in an intersection. */
         type IntersectT<X> = Inverse<From<X>> extends ((arg: infer T) => void) ? T : never;
         type TupleS<X extends readonly any[]> = X extends readonly [infer L, ...infer R] ? [TypeS<L>?, ...TupleS<R>] : any[];
@@ -73,8 +74,8 @@ declare global {
             dict<X, Y extends Schema<any, string> = Schema<string>>(inner: X, sKey?: Y): Schema<Dict<TypeS<X>, TypeS<Y>>, Dict<TypeT<X>, TypeT<Y>>>;
             /** Accept tuple arrays where each index matches the corresponding schema. */
             tuple<const X extends readonly any[]>(list: X): Schema<TupleS<X>, TupleT<X>>;
-            /** Accept plain objects whose declared properties match the schema dictionary. */
-            object<X extends Dict>(dict: X): Schema<ObjectS<X>, ObjectT<X>>;
+            /** Accept plain objects; infer fields from the dictionary, not the enclosing schema's output type. */
+            object<X extends Dict>(dict: X): Schema<ObjectS<NoInfer<X>>, ObjectT<NoInfer<X>>>;
             /** Accept values matching at least one schema in `list`. */
             union<const X>(list: readonly X[]): Schema<TypeS<X>, TypeT<X>>;
             /** Accept values matching every schema in `list`, merging object outputs. */
@@ -82,7 +83,7 @@ declare global {
             /** Validate with `inner`, then convert the result with `callback`. */
             transform<X, T>(inner: X, callback: (value: TypeS<X>, options: Schemastery.Options) => T, preserve?: boolean): Schema<TypeS<X>, T>;
             /** Defer construction of a recursive schema until validation or serialization. */
-            lazy<X extends Schema>(callback: () => X): X;
+            lazy<X extends Schema<any, any, SchemaMode>>(callback: () => X): X;
             ValidationError: typeof ValidationError;
         }
         /** Runtime validation options shared by all schema calls. */
@@ -98,6 +99,8 @@ declare global {
         interface Meta<T = any> {
             default?: T extends {} ? Partial<T> : T;
             required?: boolean;
+            /** Parse this node as a stable config reference; its type and UI metadata remain unchanged. */
+            volatile?: boolean;
             disabled?: boolean;
             collapse?: boolean;
             badges?: {
@@ -121,9 +124,9 @@ declare global {
         }
     }
     /** Callable schema instance that validates input and returns normalized output. */
-    interface Schemastery<S = any, T = S> {
-        (data?: S | null, options?: Schemastery.Options): T;
-        new (data?: S | null, options?: Schemastery.Options): T;
+    interface Schemastery<S = any, T = S, Mode extends SchemaMode = 'plain'> {
+        (data?: S | null, options?: Schemastery.Options): SchemaOutput<T, Mode>;
+        new (data?: S | null, options?: Schemastery.Options): SchemaOutput<T, Mode>;
         [kSchema]: true;
         uid: number;
         meta: Schemastery.Meta<T>;
@@ -143,49 +146,54 @@ declare global {
         /** Format this schema as a compact TypeScript-like type string. */
         toString(inline?: boolean): string;
         /** Serialize this schema, preserving shared and recursive references. */
-        toJSON(): Schema<S, T>;
+        toJSON(): Schema<S, T, Mode>;
         /** Mark nullable input as invalid unless a default supplies a fallback. */
-        required(value?: boolean): Schema<S, T>;
+        required<R extends boolean = true>(value?: R): Schema<S, T, SetRequired<Mode, R>>;
+        /**
+         * Parse this config field as a stable reference containing immutable data.
+         * @returns a schema whose output supports get(), including when the field is absent.
+         */
+        volatile(): Schema<NoInfer<S>, NoInfer<T>, Mode extends 'defined' | 'volatile-defined' ? 'volatile-defined' : 'volatile'>;
         /** Hide this schema node from UI renderers. */
-        hidden(value?: boolean): Schema<S, T>;
+        hidden(value?: boolean): Schema<S, T, Mode>;
         /** Return the default value instead of throwing when validation fails. */
-        loose(value?: boolean): Schema<S, T>;
+        loose(value?: boolean): Schema<S, T, Mode>;
         /** Attach a renderer role and optional role-specific metadata. */
-        role(text: string, extra?: any): Schema<S, T>;
+        role(text: string, extra?: any): Schema<S, T, Mode>;
         /** Attach an external documentation link. */
-        link(link: string): Schema<S, T>;
+        link(link: string): Schema<S, T, Mode>;
         /** Set the fallback value used for nullable input. */
-        default(value: T): Schema<S, T>;
+        default(value: T | NoInfer<Partial<S>>): Schema<S, T, SetRequired<Mode, true>>;
         /** Attach an auxiliary comment for documentation or form UIs. */
-        comment(text: string): Schema<S, T>;
+        comment(text: string): Schema<S, T, Mode>;
         /** Attach a localized or plain description for documentation or form UIs. */
-        description(text: string): Schema<S, T>;
+        description(text: string): Schema<S, T, Mode>;
         /** Mark this schema node as disabled for form UIs. */
-        disabled(value?: boolean): Schema<S, T>;
+        disabled(value?: boolean): Schema<S, T, Mode>;
         /** Request collapsed rendering for nested form UIs. */
-        collapse(value?: boolean): Schema<S, T>;
+        collapse(value?: boolean): Schema<S, T, Mode>;
         /** Add a deprecated badge to this schema node. */
-        deprecated(): Schema<S, T>;
+        deprecated(): Schema<S, T, Mode>;
         /** Add an experimental badge to this schema node. */
-        experimental(): Schema<S, T>;
+        experimental(): Schema<S, T, Mode>;
         /** Require strings to match a regular expression. */
-        pattern(regexp: RegExp): Schema<S, T>;
+        pattern(regexp: RegExp): Schema<S, T, Mode>;
         /** Set an inclusive maximum for numbers or collection lengths. */
-        max(value: number): Schema<S, T>;
+        max(value: number): Schema<S, T, Mode>;
         /** Set an inclusive minimum for numbers or collection lengths. */
-        min(value: number): Schema<S, T>;
+        min(value: number): Schema<S, T, Mode>;
         /** Set the numeric increment constraint. */
-        step(value: number): Schema<S, T>;
+        step(value: number): Schema<S, T, Mode>;
         /** Add or replace an object property schema. */
-        set(key: string, value: Schema): Schema<S, T>;
+        set(key: string, value: Schema): Schema<S, T, Mode>;
         /** Append a tuple, union, or intersection member schema. */
-        push(value: Schema): Schema<S, T>;
+        push(value: Schema): Schema<S, T, Mode>;
         /** Remove values equal to schema defaults from normalized output. */
         simplify(value?: any): any;
         /** Return a schema clone with descriptions merged from locale messages. */
-        i18n(messages: Dict): Schema<S, T>;
+        i18n(messages: Dict): Schema<S, T, Mode>;
         /** Attach arbitrary metadata consumed by form renderers and downstream tools. */
-        extra<K extends keyof Schemastery.Meta>(key: K, value: Schemastery.Meta[K]): Schema<S, T>;
+        extra<K extends keyof Schemastery.Meta>(key: K, value: Schemastery.Meta[K]): Schema<S, T, Mode>;
     }
 }
 declare class ValidationError extends TypeError {
@@ -194,7 +202,10 @@ declare class ValidationError extends TypeError {
     constructor(message: string, options: Schemastery.Options);
     static is(error: any): error is ValidationError;
 }
-type Schema<S = any, T = S> = Schemastery<S, T>;
+type SchemaMode = 'plain' | 'defined' | 'volatile' | 'volatile-defined';
+type SchemaOutput<T, M extends SchemaMode> = M extends 'volatile' ? Volatile<T | undefined> : M extends 'volatile-defined' ? Volatile<T> : T;
+type SetRequired<M extends SchemaMode, R extends boolean> = M extends 'volatile' | 'volatile-defined' ? R extends true ? 'volatile-defined' : 'volatile' : R extends true ? 'defined' : 'plain';
+type Schema<S = any, T = S, Mode extends SchemaMode = 'plain'> = Schemastery<S, T, Mode>;
 declare const Schema: Schemastery.Static;
 export default Schema;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/schemastery",
   "description": "Type driven schema validator",
-  "version": "3.18.2",
+  "version": "3.18.4",
   "publishConfig": {
     "access": "public"
   },
@@ -34,6 +34,6 @@
   "license": "MIT",
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@deepseek-ai/cosmokit": "^1.8.3"
+    "@deepseek-ai/cosmokit": "~1.8.5"
   }
 }

package/src/index.ts

@@ -1,4 +1,5 @@
 import { Binary, clone, deepEqual, filterKeys, isNullable, isPlainObject, pick, valueMap, type Dict } from '@deepseek-ai/cosmokit'
+import { createVolatile, isVolatile, type Volatile } from '@deepseek-ai/cosmokit'
 import type { StandardSchemaV1 } from '@standard-schema/spec'
 
 const kSchema = Symbol.for('schemastery')
@@ -9,7 +10,7 @@ declare global {
     /** Convert primitive constructors, constants, and existing schemas into a schema type. */
     export type From<X> =
       | X extends string | number | boolean ? Schema<X>
-      : X extends Schema ? X
+      : X extends Schema<any, any, SchemaMode> ? X
       : X extends typeof String ? Schema<string>
       : X extends typeof Number ? Schema<number>
       : X extends typeof Boolean ? Schema<boolean>
@@ -17,8 +18,8 @@ declare global {
       : X extends Constructor<infer S> ? Schema<S>
       : never
 
-    type TypeS1<X> = X extends Schema<infer S, unknown> ? S : never
-    type Inverse<X> = X extends Schema<any, infer Y> ? (arg: Y) => void : never
+    type TypeS1<X> = X extends Schema<infer S, infer _T, infer _M> ? S : never
+    type Inverse<X> = X extends Schema<infer _S, infer T, infer M> ? (arg: SchemaOutput<T, M>) => void : never
 
     /** Input type accepted by a schema-like value. */
     export type TypeS<X> = TypeS1<From<X>>
@@ -28,7 +29,7 @@ declare global {
     export type Resolve = (data: any, schema: Schema, options: Options, strict?: boolean) => [any, any?]
 
     /** Input type accepted by one schema in an intersection. */
-    export type IntersectS<X> = From<X> extends Schema<infer S, unknown> ? S : never
+    export type IntersectS<X> = From<X> extends Schema<infer S, infer _T, infer _M> ? S : never
     /** Output type returned by one schema in an intersection. */
     export type IntersectT<X> = Inverse<From<X>> extends ((arg: infer T) => void) ? T : never
 
@@ -85,8 +86,8 @@ declare global {
       dict<X, Y extends Schema<any, string> = Schema<string>>(inner: X, sKey?: Y): Schema<Dict<TypeS<X>, TypeS<Y>>, Dict<TypeT<X>, TypeT<Y>>>
       /** Accept tuple arrays where each index matches the corresponding schema. */
       tuple<const X extends readonly any[]>(list: X): Schema<TupleS<X>, TupleT<X>>
-      /** Accept plain objects whose declared properties match the schema dictionary. */
-      object<X extends Dict>(dict: X): Schema<ObjectS<X>, ObjectT<X>>
+      /** Accept plain objects; infer fields from the dictionary, not the enclosing schema's output type. */
+      object<X extends Dict>(dict: X): Schema<ObjectS<NoInfer<X>>, ObjectT<NoInfer<X>>>
       /** Accept values matching at least one schema in `list`. */
       union<const X>(list: readonly X[]): Schema<TypeS<X>, TypeT<X>>
       /** Accept values matching every schema in `list`, merging object outputs. */
@@ -94,7 +95,7 @@ declare global {
       /** Validate with `inner`, then convert the result with `callback`. */
       transform<X, T>(inner: X, callback: (value: TypeS<X>, options: Schemastery.Options) => T, preserve?: boolean): Schema<TypeS<X>, T>
       /** Defer construction of a recursive schema until validation or serialization. */
-      lazy<X extends Schema>(callback: () => X): X
+      lazy<X extends Schema<any, any, SchemaMode>>(callback: () => X): X
       ValidationError: typeof ValidationError
     }
 
@@ -112,6 +113,8 @@ declare global {
     export interface Meta<T = any> {
       default?: T extends {} ? Partial<T> : T
       required?: boolean
+      /** Parse this node as a stable config reference; its type and UI metadata remain unchanged. */
+      volatile?: boolean
       disabled?: boolean
       collapse?: boolean
       badges?: { text: string; type: string }[]
@@ -130,9 +133,9 @@ declare global {
   }
 
   /** Callable schema instance that validates input and returns normalized output. */
-  interface Schemastery<S = any, T = S> {
-    (data?: S | null, options?: Schemastery.Options): T
-    new (data?: S | null, options?: Schemastery.Options): T
+  interface Schemastery<S = any, T = S, Mode extends SchemaMode = 'plain'> {
+    (data?: S | null, options?: Schemastery.Options): SchemaOutput<T, Mode>
+    new (data?: S | null, options?: Schemastery.Options): SchemaOutput<T, Mode>
     [kSchema]: true
     uid: number
     meta: Schemastery.Meta<T>
@@ -152,49 +155,54 @@ declare global {
     /** Format this schema as a compact TypeScript-like type string. */
     toString(inline?: boolean): string
     /** Serialize this schema, preserving shared and recursive references. */
-    toJSON(): Schema<S, T>
+    toJSON(): Schema<S, T, Mode>
     /** Mark nullable input as invalid unless a default supplies a fallback. */
-    required(value?: boolean): Schema<S, T>
+    required<R extends boolean = true>(value?: R): Schema<S, T, SetRequired<Mode, R>>
+    /**
+     * Parse this config field as a stable reference containing immutable data.
+     * @returns a schema whose output supports get(), including when the field is absent.
+     */
+    volatile(): Schema<NoInfer<S>, NoInfer<T>, Mode extends 'defined' | 'volatile-defined' ? 'volatile-defined' : 'volatile'>
     /** Hide this schema node from UI renderers. */
-    hidden(value?: boolean): Schema<S, T>
+    hidden(value?: boolean): Schema<S, T, Mode>
     /** Return the default value instead of throwing when validation fails. */
-    loose(value?: boolean): Schema<S, T>
+    loose(value?: boolean): Schema<S, T, Mode>
     /** Attach a renderer role and optional role-specific metadata. */
-    role(text: string, extra?: any): Schema<S, T>
+    role(text: string, extra?: any): Schema<S, T, Mode>
     /** Attach an external documentation link. */
-    link(link: string): Schema<S, T>
+    link(link: string): Schema<S, T, Mode>
     /** Set the fallback value used for nullable input. */
-    default(value: T): Schema<S, T>
+    default(value: T | NoInfer<Partial<S>>): Schema<S, T, SetRequired<Mode, true>>
     /** Attach an auxiliary comment for documentation or form UIs. */
-    comment(text: string): Schema<S, T>
+    comment(text: string): Schema<S, T, Mode>
     /** Attach a localized or plain description for documentation or form UIs. */
-    description(text: string): Schema<S, T>
+    description(text: string): Schema<S, T, Mode>
     /** Mark this schema node as disabled for form UIs. */
-    disabled(value?: boolean): Schema<S, T>
+    disabled(value?: boolean): Schema<S, T, Mode>
     /** Request collapsed rendering for nested form UIs. */
-    collapse(value?: boolean): Schema<S, T>
+    collapse(value?: boolean): Schema<S, T, Mode>
     /** Add a deprecated badge to this schema node. */
-    deprecated(): Schema<S, T>
+    deprecated(): Schema<S, T, Mode>
     /** Add an experimental badge to this schema node. */
-    experimental(): Schema<S, T>
+    experimental(): Schema<S, T, Mode>
     /** Require strings to match a regular expression. */
-    pattern(regexp: RegExp): Schema<S, T>
+    pattern(regexp: RegExp): Schema<S, T, Mode>
     /** Set an inclusive maximum for numbers or collection lengths. */
-    max(value: number): Schema<S, T>
+    max(value: number): Schema<S, T, Mode>
     /** Set an inclusive minimum for numbers or collection lengths. */
-    min(value: number): Schema<S, T>
+    min(value: number): Schema<S, T, Mode>
     /** Set the numeric increment constraint. */
-    step(value: number): Schema<S, T>
+    step(value: number): Schema<S, T, Mode>
     /** Add or replace an object property schema. */
-    set(key: string, value: Schema): Schema<S, T>
+    set(key: string, value: Schema): Schema<S, T, Mode>
     /** Append a tuple, union, or intersection member schema. */
-    push(value: Schema): Schema<S, T>
+    push(value: Schema): Schema<S, T, Mode>
     /** Remove values equal to schema defaults from normalized output. */
     simplify(value?: any): any
     /** Return a schema clone with descriptions merged from locale messages. */
-    i18n(messages: Dict): Schema<S, T>
+    i18n(messages: Dict): Schema<S, T, Mode>
     /** Attach arbitrary metadata consumed by form renderers and downstream tools. */
-    extra<K extends keyof Schemastery.Meta>(key: K, value: Schemastery.Meta[K]): Schema<S, T>
+    extra<K extends keyof Schemastery.Meta>(key: K, value: Schemastery.Meta[K]): Schema<S, T, Mode>
   }
 }
 
@@ -234,7 +242,14 @@ Object.defineProperty(ValidationError.prototype, kValidationError, {
   value: true,
 })
 
-type Schema<S = any, T = S> = Schemastery<S, T>
+type SchemaMode = 'plain' | 'defined' | 'volatile' | 'volatile-defined'
+type SchemaOutput<T, M extends SchemaMode> = M extends 'volatile' ? Volatile<T | undefined>
+  : M extends 'volatile-defined' ? Volatile<T> : T
+type SetRequired<M extends SchemaMode, R extends boolean> = M extends 'volatile' | 'volatile-defined'
+  ? R extends true ? 'volatile-defined' : 'volatile'
+  : R extends true ? 'defined' : 'plain'
+
+type Schema<S = any, T = S, Mode extends SchemaMode = 'plain'> = Schemastery<S, T, Mode>
 
 const Schema = function (options: Schema) {
   const schema = function (data: any, options: Schemastery.Options = {}) {
@@ -405,6 +420,7 @@ Schema.prototype.pattern = function pattern(regexp) {
 }
 
 Schema.prototype.simplify = function simplify(this: Schema, value) {
+  if (isVolatile(value)) value = value.get()
   if (deepEqual(value, this.meta.default, this.type === 'dict')) return null
   if (isNullable(value)) return value
   if (this.type === 'object' || this.type === 'dict') {
@@ -461,7 +477,36 @@ for (const key of ['default', 'link', 'comment', 'description', 'max', 'min', 's
   })
 }
 
+Schema.prototype.volatile = function volatile() {
+  if (this.meta.volatile) throw new TypeError('volatile schema is already wrapped')
+  return this.extra('volatile', true)
+}
+
 const resolvers: Dict<Schemastery.Resolve> = {}
+const checkedVolatile = Symbol('checked-volatile-schema')
+
+function validateVolatileSchema(schema: Schema, path: (keyof any)[] = [], blocked = false, seen = new Map<Schema, Set<boolean>>()) {
+  const states = seen.get(schema) ?? new Set<boolean>()
+  if (states.has(blocked)) return
+  states.add(blocked)
+  seen.set(schema, states)
+  if (schema.meta?.volatile && blocked) {
+    throw new ValidationError('volatile fields require a fixed object path without an enclosing volatile field', { path })
+  }
+  const nested = blocked || !!schema.meta?.volatile
+  if (schema.dict) {
+    for (const [key, child] of Object.entries(schema.dict)) validateVolatileSchema(child, [...path, key], nested, seen)
+  }
+  if (schema.sKey) validateVolatileSchema(schema.sKey, [...path, '<key>'], true, seen)
+  if (schema.inner && (schema.type !== 'lazy' || schema.inner[kSchema])) {
+    validateVolatileSchema(schema.inner, [...path, '*'], true, seen)
+  }
+  if (schema.list) {
+    for (let index = 0; index < schema.list.length; index++) {
+      validateVolatileSchema(schema.list[index]!, [...path, String(index)], true, seen)
+    }
+  }
+}
 
 Schema.extend = function extend(type, resolve) {
   resolvers[type] = resolve
@@ -469,6 +514,20 @@ Schema.extend = function extend(type, resolve) {
 
 Schema.resolve = function resolve(data, schema, options = {}, strict = false) {
   if (!schema) return [data]
+  if (!(options as Schemastery.Options & { [checkedVolatile]?: boolean })[checkedVolatile]) {
+    validateVolatileSchema(schema, options.path)
+    options = { ...options, [checkedVolatile]: true } as Schemastery.Options
+  }
+  if (schema.meta?.volatile) {
+    const inner = Schema(schema)
+    inner.meta = { ...schema.meta, volatile: false }
+    const [value, adapted] = Schema.resolve(data, inner, options, strict)
+    try {
+      return [createVolatile(value), adapted]
+    } catch (error) {
+      throw new ValidationError(error instanceof Error ? error.message : String(error), options)
+    }
+  }
   if (options.ignore?.(data, schema)) return [data]
 
   if (isNullable(data) && schema.type !== 'lazy') {
@@ -582,6 +641,7 @@ Schema.extend('lazy', (data, schema, options, strict) => {
   if (!schema.inner![kSchema]) {
     schema.inner = schema.builder!()
     schema.inner!.meta = { ...schema.meta, ...schema.inner!.meta }
+    validateVolatileSchema(schema.inner!, options.path, true)
   }
   return Schema.resolve(data, schema.inner!, options, strict)
 })
@@ -706,7 +766,7 @@ function property(data: any, key: keyof any, schema: Schema, options: Schemaster
   } catch (e) {
     if (!options?.autofix) throw e
     delete data[key]
-    return schema.meta.default
+    return schema.meta.volatile ? createVolatile(schema.meta.default) : schema.meta.default
   }
 }