feat(env-options): Generalize type of getEnvironmentOptions so it will produce unions for tuples

Author: kriskowal

packages/env-options/src/env-options.js

@@ -50,11 +50,12 @@ export const makeEnvironmentCaptor = (aGlobal, dropNames = false) => {
    * Gets an environment option by name and returns the option value or the
    * given default.
    *
-   * @param {string} optionName
-   * @param {string} defaultSetting
-   * @param {string[]} [optOtherValues]
+   * @template {string} T
+   * @param {T} optionName
+   * @param {T} defaultSetting
+   * @param {T[]} [optOtherValues]
    * If provided, the option value must be included or match `defaultSetting`.
-   * @returns {string}
+   * @returns {T}
    */
   const getEnvironmentOption = (
     optionName,
@@ -95,7 +96,7 @@ export const makeEnvironmentCaptor = (aGlobal, dropNames = false) => {
       Fail`Unrecognized ${q(optionName)} value ${q(
         setting,
       )}. Expected one of ${q([defaultSetting, ...optOtherValues])}`;
-    return setting;
+    return /** @type {T} */ (setting);
   };
   freeze(getEnvironmentOption);