Refactor

Author: wooorm

lib/join.js

@@ -5,7 +5,7 @@
 import {formatCodeAsIndented} from './util/format-code-as-indented.js'
 import {formatHeadingAsSetext} from './util/format-heading-as-setext.js'
 
-/** @type {Array.<Join>} */
+/** @type {Array<Join>} */
 export const join = [joinDefaults]
 
 /** @type {Join} */

lib/types.js

@@ -25,14 +25,14 @@
 
 /**
  * @typedef Context
- * @property {string[]} stack
+ * @property {Array<string>} stack
  *   Stack of labels.
- * @property {number[]} indexStack
+ * @property {Array<number>} indexStack
  *   Positions of children in their parents.
  * @property {Enter} enter
  * @property {Options} options
- * @property {Array.<Unsafe>} unsafe
- * @property {Array.<Join>} join
+ * @property {Array<Unsafe>} unsafe
+ * @property {Array<Join>} join
  * @property {Handle} handle
  * @property {Handlers} handlers
  * @property {string|undefined} bulletCurrent
@@ -66,8 +66,8 @@
 /**
  * @typedef Unsafe
  * @property {string} character
- * @property {string|Array.<string>} [inConstruct]
- * @property {string|Array.<string>} [notInConstruct]
+ * @property {string|Array<string>} [inConstruct]
+ * @property {string|Array<string>} [notInConstruct]
  * @property {string} [after]
  * @property {string} [before]
  * @property {boolean} [atBreak]
@@ -95,10 +95,10 @@
  * @property {boolean} [setext]
  * @property {'_'|'*'} [strong]
  * @property {boolean} [tightDefinitions]
- * @property {Array.<Options>} [extensions]
+ * @property {Array<Options>} [extensions]
  * @property {Handlers} [handlers]
- * @property {Array.<Join>} [join]
- * @property {Array.<Unsafe>} [unsafe]
+ * @property {Array<Join>} [join]
+ * @property {Array<Unsafe>} [unsafe]
  */
 
 export {}

lib/unsafe.js

@@ -17,7 +17,7 @@ const fullPhrasingSpans = [
   'titleApostrophe'
 ]
 
-/** @type {Array.<Unsafe>} */
+/** @type {Array<Unsafe>} */
 export const unsafe = [
   {character: '\t', after: '[\\r\\n]', inConstruct: 'phrasing'},
   {character: '\t', before: '[\\r\\n]', inConstruct: 'phrasing'},

lib/util/container-flow.js

@@ -13,7 +13,7 @@
 export function containerFlow(parent, context) {
   const indexStack = context.indexStack
   const children = parent.children || []
-  /** @type {Array.<string>} */
+  /** @type {Array<string>} */
   const results = []
   let index = -1
 

lib/util/container-phrasing.js

@@ -14,7 +14,7 @@
 export function containerPhrasing(parent, context, safeOptions) {
   const indexStack = context.indexStack
   const children = parent.children || []
-  /** @type {Array.<string>} */
+  /** @type {Array<string>} */
   const results = []
   let index = -1
   let before = safeOptions.before

lib/util/indent-lines.js

@@ -14,7 +14,7 @@ const eol = /\r?\n|\r/g
  * @returns {string}
  */
 export function indentLines(value, map) {
-  /** @type {Array.<string>} */
+  /** @type {Array<string>} */
   const result = []
   let start = 0
   let line = 0

lib/util/pattern-in-scope.js

@@ -3,7 +3,7 @@
  */
 
 /**
- * @param {Array.<string>} stack
+ * @param {Array<string>} stack
  * @param {Unsafe} pattern
  * @returns {boolean}
  */
@@ -15,7 +15,7 @@ export function patternInScope(stack, pattern) {
 }
 
 /**
- * @param {Array.<string>} stack
+ * @param {Array<string>} stack
  * @param {Unsafe['inConstruct']} list
  * @param {boolean} none
  * @returns {boolean}

lib/util/safe.js

@@ -9,14 +9,14 @@ import {patternInScope} from './pattern-in-scope.js'
 /**
  * @param {Context} context
  * @param {string|null|undefined} input
- * @param {SafeOptions & {encode?: Array.<string>}} config
+ * @param {SafeOptions & {encode?: Array<string>}} config
  * @returns {string}
  */
 export function safe(context, input, config) {
   const value = (config.before || '') + (input || '') + (config.after || '')
-  /** @type {Array.<number>} */
+  /** @type {Array<number>} */
   const positions = []
-  /** @type {Array.<string>} */
+  /** @type {Array<string>} */
   const result = []
   /** @type {Record<number, {before: boolean, after: boolean}>} */
   const infos = {}
@@ -129,9 +129,9 @@ function numerical(a, b) {
  */
 function escapeBackslashes(value, after) {
   const expression = /\\(?=[!-/:-@[-`{-~])/g
-  /** @type {Array.<number>} */
+  /** @type {Array<number>} */
   const positions = []
-  /** @type {Array.<string>} */
+  /** @type {Array<string>} */
   const results = []
   const whole = value + after
   let index = -1

readme.md

@@ -246,7 +246,7 @@ Take a look at [`lib/unsafe.js`][unsafe] for examples.
 
 ###### `options.extensions`
 
-List of extensions (`Array.<ToMarkdownExtension>`).
+List of extensions (`Array<ToMarkdownExtension>`).
 Each `ToMarkdownExtension` is an object with the same interface as `options`
 here.
 

test/index.js

@@ -2608,7 +2608,7 @@ test('listItem', (t) => {
   )
 
   /**
-   * @param {BlockContent|BlockContent[]} [d]
+   * @param {BlockContent|Array<BlockContent>} [d]
    * @returns {List}
    */
   function createList(d) {