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/dist/bin/cli.js +205 -103
- package/dist/lib/index.d.ts +22 -1
- package/dist/lib/index.js +159 -66
- package/package.json +26 -32
- package/readme.md +12 -10
package/readme.md
CHANGED
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
<!-- badges -->
|
|
8
8
|
|
|
9
|
-
[](https://npmjs.com/package/mdat)
|
|
10
|
-
[](https://opensource.org/license/mit
|
|
9
|
+
[](https://www.npmjs.com/package/mdat)
|
|
10
|
+
[](https://opensource.org/license/mit)
|
|
11
11
|
[](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
|
|
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
|
-
|
|
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,
|
|
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 -->`.
|