feat: default value functions

ark/schema/structure/optional.ts

@@ -1,4 +1,4 @@
-import { printable, throwParseError, unset } from "@ark/util"
+import { printable, throwParseError, unset, type Primitive } from "@ark/util"
 import type { BaseRoot } from "../roots/root.ts"
 import type { declareNode } from "../shared/declare.ts"
 import { ArkErrors } from "../shared/errors.ts"
@@ -95,23 +95,36 @@ export const Optional = {
 	Node: OptionalNode
 }
 
+const isPrimitive = (value: unknown): value is Primitive =>
+	typeof value === "object" ? value === null : typeof value !== "function"
+
 export const assertDefaultValueAssignability = (
 	node: BaseRoot,
 	value: unknown,
 	key = ""
 ): unknown => {
-	const out = node.in(value)
+	if (!isPrimitive(value) && typeof value !== "function")
+		throwParseError(writeNonPrimitiveNonFunctionDefaultValueMessage(key))
+
+	const out = node.in(typeof value === "function" ? value() : value)
 	if (out instanceof ArkErrors)
 		throwParseError(writeUnassignableDefaultValueMessage(out.message, key))
+
 	return value
 }
 
 export const writeUnassignableDefaultValueMessage = (
 	message: string,
 	key = ""
-): string => `Default value${key && ` for key ${key}`} ${message}`
+): string =>
+	`Default value${key && ` for key ${key}`} is not assignable: ${message}`
 
 export type writeUnassignableDefaultValueMessage<
 	baseDef extends string,
 	defaultValue extends string
 > = `Default value ${defaultValue} is not assignable to ${baseDef}`
+
+export const writeNonPrimitiveNonFunctionDefaultValueMessage = (
+	key: string
+): string =>
+	`Default value${key && ` for key ${key}`} is not primitive so it should be specified as a function like () => ({my: 'object'})`

ark/schema/structure/prop.ts

@@ -122,16 +122,11 @@ export abstract class BaseProp<
 		return result
 	}
 
-	private premorphedDefaultValue: unknown =
-		this.hasDefault() ?
-			this.value.includesMorph ?
-				this.value.assert(this.default)
-			:	this.default
-		:	undefined
+	private morphedDefaultFactory: () => unknown = this.getMorphedFactory()
 
 	private defaultValueMorphs: Morph[] = [
 		data => {
-			data[this.key] = this.premorphedDefaultValue
+			data[this.key] = this.morphedDefaultFactory()
 			return data
 		}
 	]
@@ -143,6 +138,18 @@ export abstract class BaseProp<
 	hasDefault(): this is Optional.Node & { default: unknown } {
 		return "default" in this
 	}
+	getDefaultFactory(): () => unknown {
+		if (!this.hasDefault()) return () => undefined
+		if (typeof this.default === "function") return this.default as () => unknown
+		return () => this.default
+	}
+	getMorphedFactory(): () => unknown {
+		if (!this.hasDefault()) return () => undefined
+		const factory = this.getDefaultFactory()
+		return this.value.includesMorph ?
+				() => this.value.assert(factory())
+			:	factory
+	}
 
 	traverseAllows: TraverseAllows<object> = (data, ctx) => {
 		if (this.key in data) {