xcliintfc

type Quantifiable interface {
	~int | ~float64 | time.Duration | time.Time
}

type ValueParser interface {
	// ParseAndValidate orchestrates the complete parsing, conversion, and constraint
	// evaluation lifecycle for a single command-line option value.
	//
	// Arguments:
	//   - flag: The primary diagnostic label representing the active terminal token (e.g., "--timeout").
	//   - raw: The raw unparsed text payload extracted from the command arguments collection.
	//   - spec: The complete metadata layout structure defining constraints, defaults, and validations.
	//
	// Returns:
	//   - any: The fully converted, type-safe native Go primitive or slice instance.
	//   - error: Returns an xerrors.IErrorCLI capturing visual telemetry diagnostics if any rule fails.
	ParseAndValidate(flag string, raw string, spec xclistruc.Flag) (any, error)
}