mdream 1.3.0 → 1.4.1

package/README.md

@@ -213,6 +213,13 @@ interface MdreamOptions {
 
   /** Override tag rendering behavior. String values act as aliases. */
   tagOverrides?: Record<string, TagOverride | string>
+
+  /**
+   * Hard-wrap prose at this many characters, breaking on word boundaries.
+   * Applied inline during conversion (zero-cost when unset). Code blocks,
+   * tables, and headings are never wrapped. `0` (or unset) disables wrapping.
+   */
+  wrapWidth?: number
 }
 ```
 
@@ -230,6 +237,13 @@ interface EngineOptions {
   origin?: string
   clean?: boolean | CleanOptions
   plugins?: BuiltinPlugins
+
+  /**
+   * Hard-wrap prose at this many characters, breaking on word boundaries.
+   * Code blocks, tables, and headings are never wrapped. `0` (or unset)
+   * disables wrapping.
+   */
+  wrapWidth?: number
 }
 
 interface BuiltinPlugins {
@@ -872,6 +886,7 @@ cat index.html \
 |--------|-------------|
 | `--origin <url>` | Base URL for resolving relative links and images |
 | `--preset minimal` | Enable the minimal preset |
+| `--wrap-width <n>` | Hard-wrap prose at `n` characters (code, tables, and headings are never wrapped) |
 | `-h`, `--help` | Display help information |
 
 The CLI reads HTML from stdin and writes Markdown to stdout. It uses the streaming API internally.

package/bin/mdream.mjs

@@ -5,6 +5,7 @@ import { streamHtmlToMarkdown } from 'mdream'
 const args = process.argv.slice(2)
 let origin
 let preset
+let wrapWidth
 for (let i = 0; i < args.length; i++) {
   if (args[i] === '--origin' && args[i + 1]) {
     origin = args[++i]
@@ -12,13 +13,16 @@ for (let i = 0; i < args.length; i++) {
   else if (args[i] === '--preset' && args[i + 1]) {
     preset = args[++i]
   }
+  else if (args[i] === '--wrap-width' && args[i + 1]) {
+    wrapWidth = Number.parseInt(args[++i], 10) || undefined
+  }
   else if (args[i] === '-h' || args[i] === '--help') {
-    process.stdout.write('Usage: mdream [--origin <url>] [--preset minimal]\nPipe HTML via stdin, outputs Markdown to stdout.\n')
+    process.stdout.write('Usage: mdream [--origin <url>] [--preset minimal] [--wrap-width <n>]\nPipe HTML via stdin, outputs Markdown to stdout.\n')
     process.exit(0)
   }
 }
 
-const options = { origin, minimal: preset === 'minimal' }
+const options = { origin, minimal: preset === 'minimal', wrapWidth }
 const stream = Readable.toWeb(process.stdin)
 for await (const chunk of streamHtmlToMarkdown(stream, options)) {
   if (chunk?.length)