refactor: regex literals only, drop JS mirrors and hand-written d.ts

src/index.ts

@@ -1,10 +1,10 @@
 /**
  * markdown-regex
  *
- * A set of ready-to-use RegExp constants for parsing and extracting
- * elements from Markdown content.
- *
+ * Ready-to-use RegExp constants for parsing Markdown.
  * Zero runtime dependencies. Works in Node, browsers, and bundlers.
+ *
+ * @packageDocumentation
  */
 
 export {

src/lists/empty-ol.ts

@@ -1,7 +1,8 @@
 /**
- * Matches consecutive ordered list HTML tags with optional whitespace.
- * Useful for cleaning up generated HTML.
+ * Matches consecutive empty ordered-list HTML tags.
+ * Useful when cleaning generated HTML.
  *
- * Example: </ol><ol> or </ol> <ol>
+ * @example </ol><ol>
+ * @example </ol> <ol>
  */
 export const REGEXP_EMPTY_OL = /<\/ol>\s?<ol>/g;

src/lists/empty-ul.ts

@@ -1,7 +1,8 @@
 /**
- * Matches consecutive unordered list HTML tags with optional whitespace.
- * Useful for cleaning up generated HTML.
+ * Matches consecutive empty unordered-list HTML tags.
+ * Useful when cleaning generated HTML.
  *
- * Example: </ul><ul> or </ul> <ul>
+ * @example </ul><ul>
+ * @example </ul> <ul>
  */
 export const REGEXP_EMPTY_UL = /<\/ul>\s?<ul>/g;

src/lists/ol.ts

@@ -1,4 +1,6 @@
-import { NEWLINE } from '../utils';
-
-/** Matches ordered list items: 1. item */
-export const REGEXP_OL_LIST = new RegExp(NEWLINE + '[0-9]+\\.(.*)', 'g');
+/**
+ * Matches an ordered list item (number + period after a newline).
+ *
+ * @example 1. first item
+ */
+export const REGEXP_OL_LIST = /(?:\r\n|\r|\n)\d+\.(.*)/g;

src/lists/ul.ts

@@ -1,15 +1,9 @@
-import { NEWLINE } from '../utils';
-
 /**
- * Matches unordered list items (lines starting with *).
- * Supports optional leading indentation (4 spaces).
- * Platform-agnostic newline handling.
+ * Matches an unordered list item (`*` after a newline).
+ * Optional 4-space indent is allowed.
  *
- * Example:
- * * item one
- * * item two
+ * @example
+ *   * item one
+ *   * item two
  */
-export const REGEXP_UL_LIST = new RegExp(
-  `${NEWLINE}(((?:\\s{4})?\\*(.*?)${NEWLINE}){1,})`,
-  'g'
-);
+export const REGEXP_UL_LIST = /(?:\r\n|\r|\n)(?:\s{4})?\*(.*)/g;

src/tags/blockquote.ts

@@ -1,9 +1,7 @@
-import { NEWLINE } from '../utils';
-
 /**
- * Matches blockquote lines starting with > or >.
- * Platform-agnostic newline handling.
+ * Matches blockquote lines starting with `>` or `>` after a newline.
  *
- * Example: > blockquote text
+ * @example
+ *   > quoted paragraph
  */
-export const REGEXP_BLOCKQUOTE = new RegExp(`${NEWLINE}(>|>)(.*)`, 'g');
+export const REGEXP_BLOCKQUOTE = /(?:\r\n|\r|\n)(?:>|>)(.*)/g;

src/tags/br.ts

@@ -1,7 +1,7 @@
-import { NEWLINE } from '../utils';
-
 /**
  * Matches two or more consecutive newlines (paragraph / line breaks).
- * Platform-agnostic.
+ * Understands `\n`, `\r\n` and `\r`.
+ *
+ * @example a\\n\\nb
  */
-export const REGEXP_BR = new RegExp(`((${NEWLINE}){2,})`, 'g');
+export const REGEXP_BR = /(?:\r\n|\r|\n){2,}/g;

src/tags/code.ts

@@ -1,6 +1,6 @@
 /**
  * Matches inline code using single backtick delimiters.
  *
- * Example: `code`
+ * @example `code`
  */
-export const REGEXP_CODE = /`(.*?)`/g;
+export const REGEXP_CODE = /`(.+?)`/g;

src/tags/del.ts

@@ -1,6 +1,6 @@
 /**
- * Matches strikethrough text using ~~ delimiters.
+ * Matches strikethrough text using `~~` delimiters.
  *
- * Example: ~~strikethrough~~
+ * @example ~~deleted~~
  */
-export const REGEXP_DEL = /~~(.*?)~~/g;
+export const REGEXP_DEL = /~~(.+?)~~/g;

src/tags/empty-blockquote.ts

@@ -1,7 +1,7 @@
 /**
  * Matches consecutive empty blockquote HTML tags.
- * Useful for cleaning up generated HTML.
+ * Useful when cleaning generated HTML.
  *
- * Example: </blockquote><blockquote>
+ * @example </blockquote><blockquote>
  */
 export const REGEXP_EMPTY_BLOCKQUOTE = /<\/blockquote><blockquote>/g;

src/tags/header.ts

@@ -1,6 +1,26 @@
-/** ATX headers after start-of-string or a newline. */
+/**
+ * Matches ATX markdown headers (lines starting with 1–6 `#` characters).
+ * Matches at the start of the string or after a newline (Unix / Windows / old Mac).
+ *
+ * Captures: [1] the newline or start, [2] the `#` run, [3] the heading text.
+ *
+ * @example
+ *   # Heading 1
+ *   ## Heading 2
+ *   ### Heading 3
+ */
 export const REGEXP_HEADER = /(^|\r\n|\r|\n)(#{1,6})\s+(.*)/gm;
 
+/**
+ * Matches level-2 headers only (`## …`).
+ *
+ * @example ## Heading 2
+ */
 export const REGEXP_H2 = /^##\s+(.*)$/gim;
 
+/**
+ * Matches level-3 headers only (`### …`).
+ *
+ * @example ### Heading 3
+ */
 export const REGEXP_H3 = /^###\s+(.*)$/gim;

src/tags/hr.ts

@@ -1,9 +1,6 @@
-import { NEWLINE } from '../utils';
-
 /**
- * Matches horizontal rule lines (5 or more dashes).
- * Platform-agnostic newline handling.
+ * Matches a horizontal rule: 5 or more dashes on their own line.
  *
- * Example: -----
+ * @example -----\n
  */
-export const REGEXP_HR = new RegExp(`${NEWLINE}-{5,}`, 'g');
+export const REGEXP_HR = /(?:\r\n|\r|\n)-{5,}/g;