types: add type definitions for micromark

buffer.d.ts

@@ -0,0 +1,5 @@
+// TypeScript Version: 3.0
+
+import buffer = require('./lib')
+
+export = buffer

index.d.ts

@@ -0,0 +1,5 @@
+// TypeScript Version: 3.0
+
+import buffer = require('./buffer')
+
+export = buffer

lib/compile/html.d.ts

@@ -0,0 +1,3 @@
+declare function compileHTML(): void
+
+export = compileHTML

lib/index.d.ts

@@ -0,0 +1,5 @@
+import {ParserOptions} from './parse'
+
+declare function buffer(options?: ParserOptions): void
+
+export = buffer

lib/parse.d.ts

@@ -0,0 +1,11 @@
+import {Parser} from '../shared-types'
+
+declare namespace createParser {
+  interface ParserOptions {
+    extensions: unknown[]
+  }
+}
+
+declare function createParser(options?: createParser.ParserOptions): Parser
+
+export = createParser

lib/postprocess.d.ts

@@ -0,0 +1,3 @@
+declare function postprocess(): void
+
+export = postprocess

lib/preprocess.d.ts

@@ -0,0 +1,3 @@
+declare function preprocess(): void
+
+export = preprocess

lib/steam.d.ts

@@ -0,0 +1,5 @@
+import {ParserOptions} from './parse'
+
+declare function stream(options?: ParserOptions): void
+
+export = stream

lib/util/classify-character.d.ts

@@ -0,0 +1,3 @@
+declare function classifyCharacter(code: number): number
+
+export = classifyCharacter

lib/util/create-tokenizer.d.ts

@@ -0,0 +1,9 @@
+import {Parser, Point, Tokenizer} from '../../shared-types'
+
+declare function createTokenizer(
+  parser: Parser,
+  initialize: unknown,
+  from: Point
+): Tokenizer
+
+export = createTokenizer

lib/util/flat-map.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @param array array to flatten
+ * @param map mapping function
+ * @param a passed to map function
+ * @typeParam T shape of item input to flatMap
+ * @typeParam U shape of item returned by flatMap
+ * @typeParam A shape of additional attribute passed
+ */
+declare function flatMap<T, U, A>(
+  array: T[][],
+  map: (array: T[], a: A) => U[],
+  a?: A
+): U[]
+
+export = flatMap

lib/util/lowercase.d.ts

@@ -0,0 +1,3 @@
+declare function lowercase(code: number): number
+
+export = lowercase

lib/util/move-point.d.ts

@@ -0,0 +1,5 @@
+import {Point} from 'shared-types'
+
+declare function movePoint(point: Point, offset: number): Point
+
+export = movePoint

lib/util/normalize-identifier.d.ts

@@ -0,0 +1,3 @@
+declare function normalizeIdentifier(value: string): string
+
+export = normalizeIdentifier

lib/util/normalize-uri.d.ts

@@ -0,0 +1,3 @@
+declare function normalizeUri(url: string): string
+
+export = normalizeUri

lib/util/prefix-size.d.ts

@@ -0,0 +1,5 @@
+import {Event, Type} from '../../shared-types'
+
+declare function prefixSize(events: Event[], type: Type): number
+
+export = prefixSize

lib/util/safe-from-int.d.ts

@@ -0,0 +1,3 @@
+declare function safeFromInt(value: string, base?: number): string
+
+export = safeFromInt

lib/util/serialize-chunks.d.ts

@@ -0,0 +1,3 @@
+declare function serializeChunks(chunks: Array<string | number>): string
+
+export = serializeChunks

lib/util/shallow.d.ts

@@ -0,0 +1,3 @@
+declare function shallow<T>(object: T): T
+
+export = shallow

lib/util/slice-chunks.d.ts

@@ -0,0 +1,5 @@
+import {Token} from '../../shared-types'
+
+declare function sliceChunks(chunks: string[], token: Token): string[]
+
+export = sliceChunks

lib/util/subtokenize.d.ts

@@ -0,0 +1,5 @@
+import {Event} from '../../shared-types'
+
+declare function subtokenize(events: Event[]): {done: boolean; events: Event[]}
+
+export = subtokenize

micromark.test.ts

@@ -0,0 +1,5 @@
+import micromarkBuffer = require('micromark')
+import micromarkStream = require('micromark/stream')
+
+micromarkBuffer()
+micromarkStream()

package.json

@@ -64,6 +64,7 @@
     "browserify": "^16.0.0",
     "commonmark.json": "^0.29.0",
     "concat-stream": "^2.0.0",
+    "dtslint": "^4.0.0",
     "gzip-size-cli": "^3.0.0",
     "ms": "^2.0.0",
     "nyc": "^15.0.0",
@@ -85,7 +86,8 @@
     "format": "remark . -qfo && prettier . --write && xo --fix",
     "test-api": "node test",
     "test-coverage": "nyc --reporter lcov tape test/index.js",
-    "test": "npm run generate && npm run format && npm run test-coverage"
+    "test-types": "dtslint .",
+    "test": "npm run generate && npm run format && npm run test-coverage && npm run test-types"
   },
   "nyc": {
     "check-coverage": true,

shared-types.d.ts

@@ -0,0 +1,147 @@
+// TypeScript Version: 3.0
+
+/**
+ * A location in a string or buffer
+ */
+export interface Point {
+  line: number
+  column: number
+  offset: number
+  _index?: number
+  _bufferIndex?: number
+}
+
+/**
+ * A token type
+ *
+ * TODO: enumerate token types
+ */
+export type Type = string
+
+/**
+ *
+ */
+export interface Token {
+  start: Point
+  end: Point
+  type: Type
+  contentType: 'flow' | 'content' | 'string' | 'text'
+  previous: Token
+  next: Token
+
+  // TODO move these to interfaces extending Token, or move these to a `data` property similar to unist (would require code refactor)
+  /**
+   * Used for whitespace in several places which needs to account for tab stops
+   */
+  _size?: number
+
+  /**
+   * ends with a CR, LF, or CRLF.
+   */
+  _break?: boolean
+
+  /**
+   * Used when dealing with linked tokens. A child tokenizer is needed to tokenize them, which is stored on those tokens
+   */
+  _tokenizer?: Tokenizer
+
+  /**
+   * Used for attention (emphasis, strong).
+   *
+   * could be (enter emphasis, enter emphasisMarker, exit emphasisMarker, enter strong, enter strongMarker, exit strongMarker, enter data, exit data)
+   */
+  _events?: Event[]
+  _subevents?: Event[]
+  _contentTokenized?: unknown
+  _close?: unknown
+  _marker?: unknown
+  _open?: unknown
+  _side?: number
+  _tabs?: unknown
+}
+
+/**
+ *
+ */
+export type Event = [string, Token, unknown]
+
+/**
+ * These these are transitions to update the CommonMark State Machine (CSMS)
+ */
+export interface Effects {
+  enter: (type: Type) => Token
+  consume: (code: number) => void
+  exit: (type: Type) => Token
+  attempt: (
+    one: unknown,
+    two: unknown,
+    three?: unknown
+  ) => (code: number) => unknown
+  interrupt: (
+    one: unknown,
+    two: unknown,
+    three: unknown
+  ) => (code: number) => unknown
+  check: (
+    one: unknown,
+    two: unknown,
+    three?: unknown
+  ) => (code: number) => unknown
+  lazy: (one: unknown, ok: Okay, nok: NotOkay) => void
+}
+
+/**
+ *
+ */
+export interface Okay {
+  (code: number): void
+}
+
+/**
+ *
+ */
+export interface NotOkay {
+  (code: number): void
+}
+
+/**
+ *
+ */
+export interface Tokenizer {
+  previous: Token
+  events: Event[]
+  parser: Parser
+  sliceStream: (token: Token) => string[]
+  sliceSerialize: (token: Token) => string
+  now: () => Point
+  defineSkip: (value: Point) => void
+  write: (value: number) => Event[]
+}
+
+/**
+ *
+ */
+export interface Parser {
+  hooks: {
+    [key: string]: unknown
+  }
+  flow: (something: unknown) => unknown
+  defined: unknown[]
+}
+
+/**
+ *
+ */
+export interface TokenizerThis {
+  events: Event[]
+  interrupt: unknown
+  lazy: unknown
+  containerState: {
+    marker: number
+    type: Type
+    initialBlankLine: unknown
+    size: number
+    _closeFlow: unknown
+    furtherBlankLines: unknown
+  }
+}

stream.d.ts

@@ -0,0 +1,5 @@
+// TypeScript Version: 3.0
+
+import stream = require('./lib/steam')
+
+export = stream

tsconfig.json

@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "moduleResolution": "node",
+        "lib": [
+            "ES5"
+        ],
+        "strict": true,
+        "baseUrl": ".",
+        "paths": {
+            "micromark": [
+                "index.d.ts"
+            ],
+            "micromark/stream": [
+                "stream.d.ts"
+            ]
+        }
+    }
+}

tslint.json

@@ -0,0 +1,7 @@
+{
+    "extends": "dtslint/dtslint.json",
+    "rules": {
+        "semicolon": false,
+        "whitespace": false
+    }
+}