@openclaw/matrix 2026.8.2 → 2026.8.34

package/node_modules/markdown-it/dist/markdown-it.d.mts

@@ -43,21 +43,43 @@ interface Delimiter {
  * @category Main
  */
 interface MarkdownItOptions {
-  /** Enable HTML tags in source. */
+  /**
+   * Enable HTML tags in source.
+   *
+   * @defaultValue `false` (`true` for `'commonmark'` preset only)
+   */
   html?: boolean;
-  /** Use '/' to close single tags (`<br />`). */
+  /**
+   * Use '/' to close single tags (`<br />`).
+   *
+   * @defaultValue `false` (`true` for `'commonmark'` preset only)
+   */
   xhtmlOut?: boolean;
-  /** Convert '\n' in paragraphs into `<br>`. */
+  /**
+   * Convert '\n' in paragraphs into `<br>`.
+   *
+   * @defaultValue `false`
+   */
   breaks?: boolean;
-  /** CSS language prefix for fenced blocks, used by external syntax highlighters. */
+  /**
+   * CSS language prefix for fenced blocks, used by external syntax highlighters.
+   *
+   * @defaultValue `'language-'`
+   */
   langPrefix?: string;
-  /** Autoconvert URL-like text to links. */
+  /**
+   * Autoconvert URL-like text to links.
+   *
+   * @defaultValue `false`
+   */
   linkify?: boolean;
   /**
    * Enable language-neutral replacements and quotes beautification.
    *
    * See the [replacement rules](https://github.com/markdown-it/markdown-it/blob/master/src/rules_core/replacements.ts)
    * for the full list.
+   *
+   * @defaultValue `false`
    */
   typographer?: boolean;
   /**
@@ -66,6 +88,8 @@ interface MarkdownItOptions {
    *
    * For example, use `'«»„“'` for Russian, `'„“‚‘'` for German, and
    * `['«\xA0', '\xA0»', '‹\xA0', '\xA0›']` for French (including nbsp).
+   *
+   * @defaultValue `'“”‘’'`
    */
   quotes?: string | string[];
   /**
@@ -114,9 +138,15 @@ interface MarkdownItOptions {
    *   }
    * });
    * ```
+   *
+   * @defaultValue `null`
    */
   highlight?: ((str: string, lang: string, attrs: string) => string) | null;
-  /** Internal protection against excessive recursion. */
+  /**
+   * Internal protection against excessive recursion.
+   *
+   * @defaultValue `100`
+   */
   maxNesting?: number;
 }
 declare namespace utils_d_exports {
@@ -376,24 +406,23 @@ type RuleOptions = {
  * {@link MarkdownIt.use}.
  */
 declare class Ruler<Args extends unknown[], Result> {
+  /** @internal */
   __rules__: Array<{
     name: string;
     enabled: boolean;
     fn: (...args: Args) => Result;
     alt: string[];
   }>;
+  /** @internal */
   __cache__: Record<string, Array<(...args: Args) => Result>> | null;
+  /** @internal */
   __find__(name: string): number;
+  /** @internal */
   __compile__(): void;
   /**
    * Replace rule by name with new function & options. Throws error if name not
    * found.
    *
-   * @param name Rule name to replace.
-   * @param fn New rule function.
-   * @param options Rule options. `alt` is an array with names of "alternate"
-   * chains.
-   *
    * @example Replace existing typographer replacement rule with new one
    * ```javascript
    * import MarkdownIt from 'markdown-it'
@@ -409,12 +438,6 @@ declare class Ruler<Args extends unknown[], Result> {
    * Add new rule to chain before one with given name. See also
    * {@link Ruler.after}, {@link Ruler.push}.
    *
-   * @param beforeName New rule will be added before this one.
-   * @param ruleName Name of added rule.
-   * @param fn Rule function.
-   * @param options Rule options. `alt` is an array with names of "alternate"
-   * chains.
-   *
    * @example
    * ```javascript
    * import MarkdownIt from 'markdown-it'
@@ -430,12 +453,6 @@ declare class Ruler<Args extends unknown[], Result> {
    * Add new rule to chain after one with given name. See also
    * {@link Ruler.before}, {@link Ruler.push}.
    *
-   * @param afterName New rule will be added after this one.
-   * @param ruleName Name of added rule.
-   * @param fn Rule function.
-   * @param options Rule options. `alt` is an array with names of "alternate"
-   * chains.
-   *
    * @example
    * ```javascript
    * import MarkdownIt from 'markdown-it'
@@ -451,11 +468,6 @@ declare class Ruler<Args extends unknown[], Result> {
    * Push new rule to the end of chain. See also
    * {@link Ruler.before}, {@link Ruler.after}.
    *
-   * @param ruleName Name of added rule.
-   * @param fn Rule function.
-   * @param options Rule options. `alt` is an array with names of "alternate"
-   * chains.
-   *
    * @example
    * ```javascript
    * import MarkdownIt from 'markdown-it'
@@ -473,9 +485,7 @@ declare class Ruler<Args extends unknown[], Result> {
    *
    * See also {@link Ruler.disable}, {@link Ruler.enableOnly}.
    *
-   * @param list List of rule names to enable.
-   * @param ignoreInvalid Set `true` to ignore errors when rule not found.
-   * @returns List of found rule names (if no exception happened).
+   * Returns list of found rule names (if no exception happened).
    */
   enable(list: string | string[], ignoreInvalid?: boolean): string[];
   /**
@@ -483,9 +493,6 @@ declare class Ruler<Args extends unknown[], Result> {
    * not found - throw Error. Errors can be disabled by second param.
    *
    * See also {@link Ruler.disable}, {@link Ruler.enable}.
-   *
-   * @param list List of rule names to enable (whitelist).
-   * @param ignoreInvalid Set `true` to ignore errors when rule not found.
    */
   enableOnly(list: string | string[], ignoreInvalid?: boolean): void;
   /**
@@ -494,9 +501,7 @@ declare class Ruler<Args extends unknown[], Result> {
    *
    * See also {@link Ruler.enable}, {@link Ruler.enableOnly}.
    *
-   * @param list List of rule names to disable.
-   * @param ignoreInvalid Set `true` to ignore errors when rule not found.
-   * @returns List of found rule names (if no exception happened).
+   * Returns list of found rule names (if no exception happened).
    */
   disable(list: string | string[], ignoreInvalid?: boolean): string[];
   /**
@@ -553,37 +558,21 @@ declare class Renderer {
   /**
    * Default token renderer. Can be overriden by custom function
    * in {@link Renderer.rules}.
-   *
-   * @param tokens List of tokens.
-   * @param idx Token index to render.
-   * @param options Params of parser instance.
    */
   renderToken(tokens: Token[], idx: number, options: Required<MarkdownItOptions>): string;
   /**
    * The same as {@link Renderer.render}, but for single token of `inline` type.
-   *
-   * @param tokens List on block tokens to render.
-   * @param options Params of parser instance.
-   * @param env Additional data from parsed input (references, for example).
    */
   renderInline(tokens: Token[], options: Required<MarkdownItOptions>, env: Env | undefined): string;
   /**
    * Special kludge for image `alt` attributes to conform CommonMark spec.
    * Don't try to use it! Spec requires to show `alt` content with stripped markup,
    * instead of simple escaping.
-   *
-   * @param tokens List on block tokens to render.
-   * @param options Params of parser instance.
-   * @param env Additional data from parsed input (references, for example).
    */
   renderInlineAsText(tokens: Token[], options: Required<MarkdownItOptions>, env: Env | undefined): string;
   /**
    * Takes token stream and generates HTML. Probably, you will never need to call
    * this method directly.
-   *
-   * @param tokens List on block tokens to render.
-   * @param options Params of parser instance.
-   * @param env Additional data from parsed input (references, for example).
    */
   render(tokens: Token[], options: Required<MarkdownItOptions>, env?: Env): string;
 }
@@ -873,9 +862,6 @@ declare class MarkdownIt {
    * containing rules with given names. If rule not found, and `ignoreInvalid`
    * not set - throws exception.
    *
-   * @param list Rule name or list of rule names to enable.
-   * @param ignoreInvalid Set `true` to ignore errors when rule not found.
-   *
    * @example
    * ```javascript
    * import MarkdownIt from 'markdown-it'
@@ -888,9 +874,6 @@ declare class MarkdownIt {
   enable(list: string | string[], ignoreInvalid?: boolean): this;
   /**
    * The same as {@link MarkdownIt.enable}, but turn specified rules off.
-   *
-   * @param list Rule name or list of rule names to disable.
-   * @param ignoreInvalid Set `true` to ignore errors when rule not found.
    */
   disable(list: string | string[], ignoreInvalid?: boolean): this;
   /**
@@ -919,9 +902,6 @@ declare class MarkdownIt {
    * metadata like reference info, needed for the renderer. It also can be used to
    * inject data in specific cases. Usually, you will be ok to pass `{}`,
    * and then pass updated object to renderer.
-   *
-   * @param src Source string.
-   * @param env Environment sandbox.
    */
   parse(src: string, env: Env): Token[];
   /**
@@ -930,26 +910,17 @@ declare class MarkdownIt {
    * `env` can be used to inject additional metadata (`{}` by default).
    * But you will not need it with high probability. See also comment
    * in {@link MarkdownIt.parse}.
-   *
-   * @param src Source string.
-   * @param env Environment sandbox.
    */
   render(src: string, env?: Env): string;
   /**
    * The same as {@link MarkdownIt.parse} but skip all block rules. It returns
    * the block tokens list with the single `inline` element, containing parsed
    * inline tokens in `children` property. Also updates `env` object.
-   *
-   * @param src Source string.
-   * @param env Environment sandbox.
    */
   parseInline(src: string, env: Env): Token[];
   /**
    * Similar to {@link MarkdownIt.render} but for single paragraph content.
    * Result will NOT be wrapped into `<p>` tags.
-   *
-   * @param src Source string.
-   * @param env Environment sandbox.
    */
   renderInline(src: string, env?: Env): string;
   static Token: typeof Token;