Merge branch 'v0'

Author: serkodev

packages/markdown-exit/src/common/utils.ts

@@ -1,13 +1,8 @@
-/**
- * markdown-exit notes:
- * - drop re-export mdurl and ucmicro
- * - drop `assign` with `Object.assign`
- */
-
 // Utilities
 //
 
 import { decodeHTML } from 'entities'
+import * as mdurl from 'mdurl'
 import * as ucmicro from 'uc.micro'
 
 const _hasOwnProperty = Object.prototype.hasOwnProperty
@@ -16,6 +11,31 @@ export function has(object: object, key: string | number | symbol): boolean {
   return _hasOwnProperty.call(object, key)
 }
 
+// Utility: turn a union into an intersection (A | B) -> (A & B)
+type UnionToIntersection<U> =
+  (U extends unknown ? (x: U) => void : never) extends (x: infer R) => void ? R : never
+
+/**
+ * Merge objects
+ */
+export function assign<
+  T extends object,
+  S extends readonly (object | null | undefined)[],
+>(target: T, ...sources: S): T & UnionToIntersection<NonNullable<S[number]>>
+
+// Implementation signature
+export function assign(target: object, ...sources: unknown[]): any {
+  for (const s of sources) {
+    if (!s)
+      continue
+    if (typeof s !== 'object') {
+      throw new TypeError('source must be object')
+    }
+    Object.assign(target, s as object)
+  }
+  return target
+}
+
 // Remove element from array and put another array at those position.
 // Useful for some operations with tokens
 export function arrayReplaceAt<T>(src: readonly T[], pos: number, newElements: readonly T[]): T[] {
@@ -260,3 +280,10 @@ export function normalizeReference(str: string): string {
 export function isPromiseLike<T = unknown>(v: any): v is Promise<T> {
   return typeof v?.then === 'function'
 }
+
+/**
+ * Re-export libraries commonly used in both markdown-it and its plugins,
+ * so plugins won't have to depend on them explicitly, which reduces their
+ * bundled size (e.g. a browser build).
+ */
+export const lib = { mdurl, ucmicro }

packages/markdown-exit/src/index.ts

@@ -229,7 +229,7 @@ export class MarkdownExit {
    * Link components parser functions, useful to write plugins. See details
    * [here](https://github.com/serkodev/markdown-exit/tree/main/packages/markdown-exit/src/helpers).
    */
-  helpers: typeof helpers = Object.assign({}, helpers)
+  helpers = utils.assign({}, helpers)
 
   options: Required<MarkdownExitOptions> = { ...config.default.options }
 
@@ -267,7 +267,7 @@ export class MarkdownExit {
    * config.
    */
   set(options: MarkdownExitOptions): this {
-    Object.assign(this.options, options)
+    utils.assign(this.options, options)
     return this
   }
 

packages/markdown-exit/src/renderer.ts

@@ -9,7 +9,7 @@
 import type Token from './token'
 import type { HTMLAttribute } from './token'
 import type { MarkdownExitEnv } from './types/shared'
-import { escapeHtml, isPromiseLike, unescapeAll } from './common/utils'
+import { assign, escapeHtml, isPromiseLike, unescapeAll } from './common/utils'
 
 export interface RenderOptions {
   /**
@@ -188,7 +188,7 @@ export default class Renderer {
    *
    * @see https://github.com/serkodev/markdown-exit/tree/main/packages/markdown-exit/src/renderer.ts
    */
-  rules: RenderRuleRecord = Object.assign({}, default_rules)
+  rules: RenderRuleRecord = assign({}, default_rules)
 
   /**
    * Creates new {@link Renderer} instance and fill {@link Renderer#rules} with defaults.

packages/markdown-exit/tests/utils.test.ts

@@ -23,6 +23,16 @@ describe('utils', () => {
     assert.strictEqual(isValidEntityCode(0x7F), false)
   })
 
+  it('assign', () => {
+    const assign = utils.assign
+
+    assert.deepEqual(assign({ a: 1 }, null, { b: 2 }), { a: 1, b: 2 })
+    assert.throws(() => {
+      // @ts-expect-error expect throw
+      assign({}, 123)
+    })
+  })
+
   it('escapeRE', () => {
     const escapeRE = utils.escapeRE