feat: create coercion actions for primitives (and date)

[EskiMojo14]

Decisions left:

• should we try/catch around conversions? it's rare but some can throw, like Number(Symbol())
• v.toNumber - should we check for NaN after converting, or recommend piping into v.number?
• v.toDate - similarly, should we check the date is valid, or recommend piping into v.date?

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
valibot	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 16, 2025 6:43pm

[fabian-hiller]

Thank you so much!

should we try/catch around conversions? it's rare but some can throw, like Number(Symbol())

Yes, we should do that whenever it is necessary to cover all edge cases

v.toNumber - should we check for NaN after converting, or recommend piping into v.number?
v.toDate - similarly, should we check the date is valid, or recommend piping into v.date?

I would only convert it. Do you know what Zod is doing here?

[EskiMojo14]

with Zod the coercion isn't separate from the schema (it just happens as the first step of the schema if configured), so z.coerce.number() would be the same as v.pipe(v.unknown(), v.toNumber(), v.number())

[Copilot]

Pull Request Overview

This PR adds a set of conversion actions for primitives—including string, number, date, boolean, and bigint—along with comprehensive tests and type validations.

• Introduces conversion functions for each type with try-catch logic for error handling
• Adds tests to validate both successful coercions and proper issue reporting on invalid inputs
• Updates re-export files to include the newly added actions

Reviewed Changes

Copilot reviewed 50 out of 50 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
library/src/actions/toString/*	Adds toString conversion action and tests
library/src/actions/toNumber/*	Introduces toNumber conversion with error handling
library/src/actions/toDate/*	Implements toDate conversion with try-catch (see note)
library/src/actions/toBoolean/*	Adds toBoolean conversion action and tests
library/src/actions/toBigint/*	Introduces toBigint conversion with error handling
library/src/actions/index.ts	Updates exports to include the new conversion actions

[Copilot]

new Date() does not throw an exception for invalid date strings; consider validating the resulting Date (e.g., checking if isNaN(dataset.value.getTime())) and registering an issue if it's invalid.

Suggested change

	dataset.value = new Date(dataset.value);
	} catch {
	_addIssue(this, 'date', dataset, config);
	// @ts-expect-error
	dataset.typed = false;
	const parsedDate = new Date(dataset.value);
	if (isNaN(parsedDate.getTime())) {
	_addIssue(this, 'date', dataset, config);
	// @ts-expect-error
	dataset.typed = false;
	} else {
	dataset.value = parsedDate;
	}

[fabian-hiller]

I think right now we want devs to explicitly handle this case with v.pipe(v.unknown(), v.toDate(), v.date()).