@OptionSet has not been officially added to Swift. All such additions to Swift would be reviewed as an Evolution proposal and there is no such proposal. (This has nothing to do with Foundation.)
IIRC, @OptionSetwas added as an example as part of the original macro proposal, but then removed because its addition hadn't been reviewed. But it got most of the way through Apple's beta process before that happened, so all the docs were generated and published, but not removed after it was no longer available.