mdat 2.3.6 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/readme.md CHANGED
@@ -6,8 +6,8 @@
6
6
 
7
7
  <!-- badges -->
8
8
 
9
- [![NPM Package mdat](https://img.shields.io/npm/v/mdat.svg)](https://npmjs.com/package/mdat)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/license/mit/)
9
+ [![NPM Package mdat](https://img.shields.io/npm/v/mdat.svg)](https://www.npmjs.com/package/mdat)
10
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/license/mit)
11
11
  [![CI](https://github.com/kitschpatrol/mdat/actions/workflows/ci.yml/badge.svg)](https://github.com/kitschpatrol/mdat/actions/workflows/ci.yml)
12
12
 
13
13
  <!-- /badges -->
@@ -103,7 +103,7 @@ The `<!-- title -->` comment was expanded with content derived from your project
103
103
 
104
104
  ### Dependencies
105
105
 
106
- Node 22+ (specifically `>=22.17.0`). Written in TypeScript with bundled type definitions.
106
+ Node 24+ (specifically `>=24.16.0`). Written in TypeScript with bundled type definitions.
107
107
 
108
108
  ### Installation
109
109
 
@@ -176,7 +176,7 @@ pnpm install --global mdat
176
176
  }
177
177
  ```
178
178
 
179
- See the [bundled rules](src/lib/readme/rules) for more complex examples.
179
+ See the [bundled rules](./src/lib/readme/rules) for more complex examples.
180
180
 
181
181
  JSON files can also be used as rule sets. MDAT flattens them so any dot-notated key path becomes a comment keyword.
182
182
 
@@ -192,7 +192,7 @@ pnpm install --global mdat
192
192
 
193
193
  Compound rules combine several individual rules into a single comment keyword.
194
194
 
195
- See [`<!-- header -->`](src/lib/readme/rules/header.ts) for an example.
195
+ See [`<!-- header -->`](./src/lib/readme/rules/header.ts) for an example.
196
196
 
197
197
  8. **Polyglot metadata**
198
198
 
@@ -531,9 +531,7 @@ type Rule =
531
531
  | string
532
532
  | {
533
533
  content:
534
- | ((options: JsonValue, context: RuleContext) => Promise<string> | string)
535
- | Rule[]
536
- | string
534
+ ((options: JsonValue, context: RuleContext) => Promise<string> | string) | Rule[] | string
537
535
  order?: number
538
536
  }
539
537
 
@@ -550,7 +548,7 @@ When multiple config files are loaded, they are merged. CLI `--config` takes pre
550
548
 
551
549
  ### Creating custom rules
552
550
 
553
- See the [Examples section](https://github.com/kitschpatrol/remark-mdat#examples) of the `remark-mdat` readme, or look at the [bundled rules](src/lib/readme/rules) for complex examples.
551
+ See the [Examples section](https://github.com/kitschpatrol/remark-mdat#examples) of the `remark-mdat` readme, or look at the [bundled rules](./src/lib/readme/rules) for complex examples.
554
552
 
555
553
  ### Bundled rules
556
554
 
@@ -566,7 +564,7 @@ See the [Examples section](https://github.com/kitschpatrol/remark-mdat#examples)
566
564
 
567
565
  - ##### `<!-- badges -->`
568
566
 
569
- Generates badges based on project metadata. Supports NPM version, license, and CI status badges.
567
+ Generates badges based on project metadata. Supports NPM version, license, CI status, and Git LFS badges.
570
568
 
571
569
  - ##### `<!-- description -->`
572
570
 
@@ -580,6 +578,10 @@ See the [Examples section](https://github.com/kitschpatrol/remark-mdat#examples)
580
578
 
581
579
  Documents platform requirements and peer dependencies. Lists runtime platforms (Node, Python, Rust, Go, Ruby, etc.) with version constraints from `engines` or equivalent metadata, supported operating systems, and peer dependencies with links to npm.
582
580
 
581
+ - ##### `<!-- development-dependencies -->`
582
+
583
+ Documents the tools needed to work on the project itself, derived from the `devEngines` and `packageManager` fields in `package.json`. Lists required runtimes and package managers with links and version constraints. Also aliased as `<!-- dev-dependencies -->`.
584
+
583
585
  - ##### `<!-- table-of-contents -->`
584
586
 
585
587
  Auto-generated via [mdast-util-toc](https://github.com/syntax-tree/mdast-util-toc). Also aliased as `<!-- toc -->`.