config: Add capability to disable/hide config options (#594)

This adds two optional properties to config options, `disabled` and
`hidden`, that can access the values of other config options in the
config group and programmatically be hidden or disabled as other config
options change. Essentially, this allows the ability to create "child"
config options that will only appear or only be modifiable if their
"parent" is set a certain way.

I originally had a stronger use case for this with some FRU p4 stuff I
was working on, but I figured out an alternative way to do it without
needing configs. I was going to shelve this, but someone in discord
recently requested an option to have relative (vs. true) directions
called out for P3 Ultimate Relativity, so there is at least a potential
use for this now.

Some completely made up mockups below to illustrate:

Parent Strat is `none`, so both sub-options are hidden:

![demo1](https://github.com/user-attachments/assets/e41733ab-0e21-4552-8ae3-ad0b438a7a01)

Parent strat set; both sub-options visible; but checkbox is false, so
the final sub-option is disabled:

![demo2](https://github.com/user-attachments/assets/2d1510a0-7dfb-410f-a67b-4b21991fc9f5)

Checkbox now true, so the final sub-option is enabled:

![demo3](https://github.com/user-attachments/assets/ed7492d5-fce6-4563-a515-010be922d6dc)

Author: wexxlee

docs/RaidbossGuide.md

@@ -80,6 +80,9 @@ By default, you should not pick a particular strategy if there are multiple.
 
 See: [P12S](../ui/raidboss/data/06-ew/raid/p12s.ts) for an example of many different tower and classical concept options.
 
+You can also use the `disabled` and/or `hidden` properties to programmatically hide or disable options based on the values of other options.
+This allows you to effectively create sub-options that will only appear or be modifiable if the "parent" option is set to a particular value.
+
 TODO: update this guide to explain the structure of the config section better
 
 ### Trigger Implementation Guidelines for Developers
@@ -130,6 +133,15 @@ export default {
       },
       type: 'checkbox',
       default: false,
+      // optional properties below
+      disabled: (values) => {
+        // code that returns true or false; if true, the input field will be disabled in the UI
+        // can access current values of other config options via values.[id of config option]
+      },
+      hidden: (values) => {
+        // code that returns true or false; if true, the config text and input will be hidden in the UI
+        // can access current values of other config options via values.[id of config option]
+      },
     },
   ],
   resetWhenOutOfCombat: true,

resources/user_config.ts

@@ -56,6 +56,10 @@ export type UserFileCallback = (
   basePath: string,
 ) => void;
 export type ConfigValue = string | number | boolean;
+// Map of config ids to current value
+export type ConfigIdToValueMap = { [id: string]: ConfigValue };
+// Map of ConfigEntries to an array containing the leftDiv and inputDiv elements
+export type ConfigEntryToDivMap = Map<ConfigEntry, [HTMLElement, HTMLElement]>;
 export type ConfigEntry = {
   id: string;
   comment?: Partial<LocaleText>;
@@ -65,6 +69,10 @@ export type ConfigEntry = {
   // This must be a valid option even if there is a setterFunc, as `_getOptionLeafHelper`
   // for the config ui reads from the SavedConfig directly rather than post-setterFunc.
   default: ConfigValue | ((options: BaseOptions) => ConfigValue);
+  // If true, the leftDiv and inputDiv will be shown, but inputs in the inputDiv will be disabled.
+  disabled?: (values: ConfigIdToValueMap) => boolean;
+  // If true, both the leftDiv and the inputDiv will be hidden.
+  hidden?: (values: ConfigIdToValueMap) => boolean;
   debug?: boolean;
   debugOnly?: boolean;
   // For select.
@@ -81,8 +89,12 @@ export type ConfigEntry = {
   ) => ConfigValue | void | undefined;
 };
 
-export interface NamedConfigEntry<NameUnion> extends Omit<ConfigEntry, 'id'> {
+export type NamedConfigIdToValueMap<NameUnion extends string> = Record<NameUnion, ConfigValue>;
+export interface NamedConfigEntry<NameUnion extends string>
+  extends Omit<ConfigEntry, 'id' | 'disabled' | 'hidden'> {
   id: NameUnion;
+  disabled?: (values: NamedConfigIdToValueMap<NameUnion>) => boolean;
+  hidden?: (values: NamedConfigIdToValueMap<NameUnion>) => boolean;
 }
 
 export type OptionsTemplate = {