I don't understand why you are focused on what returning 0 could possibly mean in others situations, it is not relevant, we are talking about one specific situation (basically, using nonzero values for the delay and the repetition) and in this one specific situation:
-the value returned by $timer().secs does not match the definition of the help file
-it cannot be observed that $timer().secs returns the number of seconds left until the timer triggers
since indeed, the timer has reached its last repetition, it is not going to trigger again, therefore it's not going to trigger in 2 seconds, unlike what my example suggests. That is all that is being reported.
What you are requesting is for .secs to return 0 in this context even though it could mean either "about to trigger again immediately" or "is never going to trigger again". That makes no sense. The only change that could make sense is for .secs to return -1 if it is not going to trigger again. However, this could have backwards-compatibility side-effects, so it cannot be changed.
No, what we are requesting is first, an aknowledgement that $timer().secs is indeed returning a wrong value because of X, or that, no, $timer().secs is not returning a wrong value because of Y. It's not much that we need $timer().secs to return that or this value, (given the context we can check that .reps is 0 and therefore we could workaround .secs not returning 0) it's just an observation that $timer().secs simply does not do what it's supposed to do (according to the help file) in this situation, we are not even looking at others situations, they are not relevant to the observation.
Of course, according to the help file, for me, $timer().secs should be returning 0 in this last repetition.
There's no relationship between this situation returning 0 for .secs and a different "/timer N 0" situation also returning 0, it looks like you are viewing the fact that both situation can return 0 for .secs as a problem but it is absolutely not a problem as far as I can see, I don't see the concern here but if there is one, please enlighten me!