[Jason3S]

Summary

An error for a wrong argument now states the rule and stops: it no longer says what was given. Seven functions that threw a plain Error for a wrong value now throw a TypeError, so every rejected argument reports the same error class.

• No message ends in , got … or quotes the value any more.
• Code that matches the old message text, or checks for Error by name, needs updating.

Messages

Each line is a whole message.

• heading depth must be a number from 1 to 6
• a list start must be a whole number from 0 to 999999999
• column alignment must be 'left', 'center', 'right' or a delimiter such as ':---'
• a placeholder name must be parts joined by '.', each of ASCII letters, digits, '_' and '-', and not starting with '-'
• an HTML entity must be a character, a name HTML defines, or a reference such as ' '
• table header must be an array, and the same for table rows, a table row, list entries and definition list entries
• heading content must be inline, and the same wherever only text, links, formatting or code can go
• document content must be blocks, and the same wherever only blocks can go
• definition list entry must be a [term, definition] pair
• expected a string or a Markdown element
• {@ name @} is inside code and takes only a string, text, a placeholder or an HTML entity
• {@ name @} is inside a URL and takes only a string, text or a placeholder

Error class

These threw Error and now throw TypeError:

• heading, for a wrong depth
• table and htmlTable, for a wrong column alignment
• placeholder and blockPlaceholder, for a wrong name
• inlineTemplate, for text of more than one paragraph
• htmlEntity, for an unknown name

Usage

import * as md from '@streetsidesoftware/markdown-toolkit';

try {
  md.heading(7, 'Title');
} catch (error) {
  error instanceof TypeError;
  // true. It was a plain Error before.
  error.message;
  // heading depth must be a number from 1 to 6
}