Add improved docs

Author: wooorm

index.js

@@ -2,16 +2,19 @@
  * @typedef {import('./lib/types.js').Info} SafeOptions
  *   To do: remove next major: renamed because it doesn’t really reflect
  *   options, but instead info on the surrounding of the generated thing.
+ * @typedef {import('./lib/types.js').State} Context
+ *   To do: remove next major: renamed because the word state more clearly
+ *   represents one thing that is passed down to everything and is changed.
  */
 
 /**
- * @typedef {import('./lib/types.js').Info} Info
- * @typedef {import('./lib/types.js').Context} Context
  * @typedef {import('./lib/types.js').Handle} Handle
  * @typedef {import('./lib/types.js').Handlers} Handlers
+ * @typedef {import('./lib/types.js').Info} Info
  * @typedef {import('./lib/types.js').Join} Join
- * @typedef {import('./lib/types.js').Unsafe} Unsafe
  * @typedef {import('./lib/types.js').Options} Options
+ * @typedef {import('./lib/types.js').State} State
+ * @typedef {import('./lib/types.js').Unsafe} Unsafe
  * @typedef {import('./lib/util/indent-lines.js').Map} Map
  */
 

lib/configure.js

@@ -1,12 +1,12 @@
 /**
  * @typedef {import('./types.js').Options} Options
- * @typedef {import('./types.js').Context} Context
+ * @typedef {import('./types.js').State} State
  */
 
 /**
- * @param {Context} base
+ * @param {State} base
  * @param {Options} extension
- * @returns {Context}
+ * @returns {State}
  */
 export function configure(base, extension) {
   let index = -1