feat(markdown): Initial markdown package commit

Author: Danktuary

packages/markdown/.gitignore

@@ -0,0 +1,4 @@
+node_modules
+.DS_Store
+dist
+*.local

packages/markdown/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Brussell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/markdown/README.md

@@ -0,0 +1,60 @@
+# @discord-message-components/markdown
+
+A markdown parser for Discord messages.
+
+**This is an adaption of [discord-markdown](https://github.com/brussell98/discord-markdown) by [brussell98](https://github.com/brussell98).**
+
+## Using
+
+```bash
+yarn add @discord-message-components/markdown
+npm i @discord-message-components/markdown
+```
+
+For browser use, import `dist/markdown.min.js`
+
+```js
+const { parser, htmlOutput, toHTML } = require('@discord-message-components/markdown')
+
+console.log(toHTML('This **is** a __test__'))
+// => This <strong>is</strong> a <u>test</u>
+```
+
+## Options
+
+```js
+const { toHTML } = require('@discord-message-components/markdown')
+toHTML('This **is** a __test__', options)
+```
+
+`options` is an object with the following properties (all are optional):
+
+* `embed`: Boolean (default: false), if it should parse embed contents (rules are slightly different)
+* `escapeHTML`: Boolean (default: true), if it should escape HTML
+* `discordOnly`: Boolean (default: false), if it should only parse the discord-specific stuff
+* `discordCallback`: Object, callbacks used for discord parsing. Each receive an object with different properties, and are expected to return an HTML escaped string
+  * `user`: (`id`: Number) User mentions "@someperson"
+  * `channel`: (`id`: Number) Channel mentions "#somechannel"
+  * `role`: (`id`: Number) Role mentions "@somerole"
+  * `everyone`: () Everyone mention "@everyone"
+  * `here`: () Here mention "@here"
+* `cssModuleNames`: Object, maps CSS class names to CSS module class names
+
+### Mention and Emoji Handling
+
+Using the `discordCallback` option you can define custom functions to handle parsing mention and emoji content. You can use these to turn IDs into names.
+
+Example:
+
+```js
+const { toHTML } = require('@discord-message-components/markdown')
+toHTML('This is a mention for <@95286900801146880>', {
+	discordCallback: {
+		user: node => '@' + users[node.id],
+	},
+}) // -> This is a mention for @Brussell
+```
+
+## Customizing
+
+It is possible to change the rules used by this package. Take a look at the code to see how to create your own modified rule set.

packages/markdown/index.d.ts

@@ -0,0 +1,29 @@
+import * as markdown from 'simple-markdown'
+
+interface DiscordCallback {
+  user?: (node: { id: string }) => string;
+  channel?: (node: { id: string }) => string;
+  role?: (node: { id: string }) => string;
+  everyone?: () => string;
+  here?: () => string;
+}
+
+interface HTMLOptions {
+  embed?: boolean;
+  escapeHTML?: boolean;
+  discordOnly?: boolean;
+  discordCallback: DiscordCallback;
+  cssModuleNames: Record<string, string>;
+}
+
+export function parser(source: string): markdown.SingleASTNode[]
+export function htmlOutput(node: markdown.ASTNode, state?: markdown.OptionalState): unknown;
+export function toHTML(source: string, options?: HTMLOptions): string;
+export function htmlTag(tagName: string, content: string, attributes: Record<string, string>, isClosed?: boolean, state?: markdown.State): string
+
+type MarkdownRules = Record<string, Record<string, unknown>>;
+
+export const rules: MarkdownRules
+export const rulesDiscordOnly: MarkdownRules
+export const rulesEmbed: MarkdownRules
+export const markdownEngine: typeof markdown