comment

src/@types/State.ts

@@ -18,6 +18,7 @@ import Tip from './TipId'
 
 interface State {
   absoluteContextTime?: Timestamp
+  /** A dismissable informational popup. See actions/alert.ts and components/Alert.tsx. */
   alert?: Alert | null
   archived?: boolean
   authenticated: boolean
@@ -70,11 +71,12 @@ interface State {
    * Is there a state value we can subscribe to re-render only thoughts that are needed?
    */
   editableNonce: number
+  /** True if there is an active browser selection, or on mobile when the virtual keyboard is up. On mobile the first tap moves the cursor, and the second tap opens the keyboard. */
   editing: boolean | null
-  /** Show the latest activated shortcuts at the bottom of the screen for webcasts.. */
+  /** Show the latest activated shortcuts at the bottom of the screen for webcasts. */
   enableLatestShortcutsDiagram: boolean
   error?: string | null
-  /** Keyed by hashPath(path). */
+  /** A map of all Paths that are expanded. Recalculated whenever the cursor moves or the thoughts change. Keyed by hashPath(path). */
   expanded: Index<Path>
   expandHoverDownPaths: Index<Path>
   expandHoverUpPath?: Path | null