Manually fix up TOC

Author: eps1lon

README.md

@@ -63,92 +63,59 @@
 
 <summary><b>Expand Table of Contents</b></summary>
 
-- [Section 1: Setup TypeScript with React](#section-1-setup-typescript-with-react)
+- [Section 1: Setup TypeScript with React](#section-1--setup-typescript-with-react)
+  <!--START-SECTION:setup-toc-->
   - [Prerequisites](#prerequisites)
+  - [VS Code Extensions](#vs-code-extensions)
   - [React + TypeScript Starter Kits](#react--typescript-starter-kits)
   - [Import React](#import-react)
-- [Section 2: Getting Started](#section-2-getting-started)
+  - [Video Tutorial](#video-tutorial)<!--END-SECTION:setup-toc-->
+- [Section 2: Getting Started](#section-2--getting-started)
   - [Function Components](#function-components)
   - [Hooks](#hooks)
   - [useState](#usestate)
   - [useReducer](#usereducer)
-  - [useEffect](#useeffect--uselayouteffect)
+  - [useEffect / useLayoutEffect](#useeffect---uselayouteffect)
   - [useRef](#useref)
+    - [Option 1: DOM element ref](#option-1--dom-element-ref)
+    - [Option 2: Mutable value ref](#option-2--mutable-value-ref)
+    - [See also](#see-also)
   - [useImperativeHandle](#useimperativehandle)
   - [Custom Hooks](#custom-hooks)
+  - [More Hooks + TypeScript reading:](#more-hooks---typescript-reading-)
+  - [Example React Hooks + TypeScript Libraries:](#example-react-hooks---typescript-libraries-)
   - [Class Components](#class-components)
-  - [You May Not Need `defaultProps`](#you-may-not-need-defaultprops)
-  - [Typing `defaultProps`](#typing-defaultprops)
+  - [Typing getDerivedStateFromProps](#typing-getderivedstatefromprops)
+  - [You May Not Need `defaultProps`](#you-may-not-need--defaultprops-)
+  - [Typing `defaultProps`](#typing--defaultprops-)
   - [Consuming Props of a Component with defaultProps](#consuming-props-of-a-component-with-defaultprops)
     - [Problem Statement](#problem-statement)
     - [Solution](#solution)
   - [Misc Discussions and Knowledge](#misc-discussions-and-knowledge)
+  - [Typing Component Props](#typing-component-props)
   - [Basic Prop Types Examples](#basic-prop-types-examples)
   - [Useful React Prop Type Examples](#useful-react-prop-type-examples)
-  - [getDerivedStateFromProps](#getderivedstatefromprops)
-  - [Forms and Events](#forms-and-events)
-  - [Context](#context)
-  - [Basic Example](#basic-example)
-  - [Extended Example](#extended-example)
-  - [forwardRef/createRef](#forwardrefcreateref)
-  - [Portals](#portals)
-  - [Error Boundaries](#error-boundaries)
-    - [Option 1: Using react-error-boundary](#option-1-using-react-error-boundary)
-    - [Options 2: Writing your custom error boundary component](#options-2-writing-your-custom-error-boundary-component)
-  - [Concurrent React/React Suspense](#concurrent-reactreact-suspense)
-- [Troubleshooting Handbook: Types](#troubleshooting-handbook-types)
-  - [Union Types and Type Guarding](#union-types-and-type-guarding)
-  - [Optional Types](#optional-types)
-  - [Enum Types](#enum-types)
-  - [Type Assertion](#type-assertion)
-  - [Simulating Nominal Types](#simulating-nominal-types)
-  - [Intersection Types](#intersection-types)
-  - [Union Types](#union-types)
-  - [Overloading Function Types](#overloading-function-types)
-  - [Using Inferred Types](#using-inferred-types)
-  - [Using Partial Types](#using-partial-types)
-  - [The Types I need weren't exported!](#the-types-i-need-werent-exported)
-  - [The Types I need don't exist!](#the-types-i-need-dont-exist)
-    - [Slapping `any` on everything](#slapping-any-on-everything)
-    - [Autogenerate types](#autogenerate-types)
-    - [Typing Exported Hooks](#typing-exported-hooks)
-    - [Typing Exported Components](#typing-exported-components)
-- [Troubleshooting Handbook: Operators](#troubleshooting-handbook-operators)
-- [Troubleshooting Handbook: Utilities](#troubleshooting-handbook-utilities)
-- [Troubleshooting Handbook: tsconfig.json](#troubleshooting-handbook-tsconfigjson)
-- [Troubleshooting Handbook: Fixing bugs in official typings](#troubleshooting-handbook-fixing-bugs-in-official-typings)
-- [Troubleshooting Handbook: Globals, Images and other non-TS files](#troubleshooting-handbook-globals-images-and-other-non-ts-files)
-- [Other React + TypeScript resources](#other-react--typescript-resources)
-- [Editor Tooling and Integration](#editor-tooling-and-integration)
-- [Linting](#linting)
-- [Other React + TypeScript resources](#other-react--typescript-resources-1)
-- [Recommended React + TypeScript talks](#recommended-react--typescript-talks)
-- [Time to Really Learn TypeScript](#time-to-really-learn-typescript)
-- [Example App](#example-app)
-- [My question isn't answered here!](#my-question-isnt-answered-here)
-  - [Contributors](#contributors)
-  <!--START-SECTION:setup-toc-->
-  - [Prerequisites](#prerequisites)
-  - [VS Code Extensions](#vs-code-extensions)
-  - [React + TypeScript Starter Kits](#react--typescript-starter-kits)
-  - [Import React](#import-react)
-  - [Video Tutorial](#video-tutorial)<!--END-SECTION:setup-toc-->
-- [Section 2: Getting Started](#section-2-getting-started)
-  - [Function Components](#function-components)
-  - [Hooks](#hooks)
-  - [Class Components](#class-components)
-  - [Typing defaultProps](#typing-defaultprops)
-  - [Types or Interfaces?](#types-or-interfaces)
-  - [Basic Prop Types Examples](#basic-prop-types-examples)
-  - [Useful React Prop Type Examples](#useful-react-prop-type-examples)
-  - [getDerivedStateFromProps](#getDerivedStateFromProps)
-  - [Forms and Events](#forms-and-events)
-  - [Context](#context)
-  - [forwardRef/createRef](#forwardrefcreateref)
-  - [Portals](#portals)
-  - [Error Boundaries](#error-boundaries)
-  - [Concurrent React/React Suspense](#concurrent-reactreact-suspense)
-- [Basic Troubleshooting Handbook: Types](#basic-troubleshooting-handbook-types)
+  - [Types or Interfaces?](#types-or-interfaces-)
+    - [TL;DR](#tl-dr)
+    - [More Advice](#more-advice)
+    - [Useful table for Types vs Interfaces](#useful-table-for-types-vs-interfaces)
+- [getDerivedStateFromProps](#getderivedstatefromprops)
+- [Forms and Events](#forms-and-events)
+- [List of event types](#list-of-event-types)
+- [Context](#context)
+- [Basic Example](#basic-example)
+- [Extended Example](#extended-example)
+- [forwardRef/createRef](#forwardref-createref)
+- [Generic forwardRefs](#generic-forwardrefs)
+- [Option 1 - Wrapper component](#option-1---wrapper-component)
+- [Option 2 - Redeclare forwardRef](#option-2---redeclare-forwardref)
+- [More Info](#more-info)
+- [Portals](#portals)
+- [Error Boundaries](#error-boundaries)
+- [Option 1: Using react-error-boundary](#option-1--using-react-error-boundary)
+- [Options 2: Writing your custom error boundary component](#options-2--writing-your-custom-error-boundary-component)
+- [Concurrent React/React Suspense](#concurrent-react-react-suspense)
+- [Troubleshooting Handbook: Types](#troubleshooting-handbook--types)
   <!--START-SECTION:types-toc-->
   - [Union Types and Type Guarding](#union-types-and-type-guarding)
   - [Optional Types](#optional-types)
@@ -169,19 +136,19 @@
   - [Frequent Known Problems with TypeScript](#frequent-known-problems-with-typescript)
     - [TypeScript doesn't narrow after an object element null check](#typescript-doesnt-narrow-after-an-object-element-null-check)
     - [TypeScript doesn't let you restrict the type of children](#typescript-doesnt-let-you-restrict-the-type-of-children)<!--END-SECTION:types-toc-->
-- [Troubleshooting Handbook: Operators](#troubleshooting-handbook-operators)
-- [Troubleshooting Handbook: Utilties](#troubleshooting-handbook-utilities)
-- [Troubleshooting Handbook: tsconfig.json](#troubleshooting-handbook-tsconfigjson)
-- [Troubleshooting Handbook: Bugs in official typings](#troubleshooting-handbook-bugs-in-official-typings)
-- [Recommended React + TypeScript codebases to learn from](#recommended-react--typescript-codebases-to-learn-from)
+- [Troubleshooting Handbook: Operators](#troubleshooting-handbook--operators)
+- [Troubleshooting Handbook: Utilities](#troubleshooting-handbook--utilities)
+- [Troubleshooting Handbook: tsconfig.json](#troubleshooting-handbook--tsconfigjson)
+- [Troubleshooting Handbook: Fixing bugs in official typings](#troubleshooting-handbook--fixing-bugs-in-official-typings)
+- [Troubleshooting Handbook: Globals, Images and other non-TS files](#troubleshooting-handbook--globals--images-and-other-non-ts-files)
 - [Editor Tooling and Integration](#editor-tooling-and-integration)
 - [Linting](#linting)
-- [Other React + TypeScript resources](#other-react--typescript-resources)
-- [Recommended React + TypeScript talks](#recommended-react--typescript-talks)
+- [Other React + TypeScript resources](#other-react---typescript-resources)
+- [Recommended React + TypeScript talks](#recommended-react---typescript-talks)
 - [Time to Really Learn TypeScript](#time-to-really-learn-typescript)
 - [Example App](#example-app)
-- [My question isn't answered here!](#my-question-isnt-answered-here)
-  </details>
+
+    </details>
 
 <!--START-SECTION:setup-->