ipsumify 2.5.0 → 2.6.0

package/README.md

@@ -6,6 +6,8 @@ Lorem ipsum for the command line and Node: markdown-ready placeholder text with
 npx ipsumify
 ```
 
+![Terminal output of npx ipsumify with a theme, headings, and a list](https://raw.githubusercontent.com/ICJIA/ipsumify-next-2026/main/documentation/screenshot-cli.png)
+
 With no arguments it prints five paragraphs of classic lorem ipsum. Nothing to install, no dependencies, Node 18.3 or later.
 
 It uses the same engine as [ipsumify.com](https://ipsumify.com) and its API: the same theme, block count, seed, and options give the same text in all three.
@@ -14,7 +16,7 @@ It uses the same engine as [ipsumify.com](https://ipsumify.com) and its API: the
 
 | Option | Short | What it does |
 | ------ | ----- | ------------ |
-| `--blocks <n>` | `-b` | Number of paragraphs, 1–20. Default 5. Also accepted as the first argument (`npx ipsumify 3`) or as `--paragraphs` / `-p` |
+| `--blocks <n>` | `-b` | Number of paragraphs, 1–20. Default 5. Also accepted as the first argument (`npx ipsumify 3`) or as `--paragraphs` / `-p`; give it one way only |
 | `--theme <id>` | `-t` | `lorem` (default), `dog`, `cat`, `baked`, `bbq` |
 | `--seed <n>` | `-s` | Whole number from 0 to 2,147,483,647. The same seed always gives the same text. Random when omitted |
 | `--headings` | | Add markdown headings (also `--headers`) |
@@ -148,7 +150,7 @@ themes                                              // [{ id: 'lorem', label: 'L
 | `noWrap` | boolean | `false` | Everything on one line |
 | `format` | string | `'markdown'` | `markdown`, `text`, `html` |
 
-An unknown theme or format, or a `blocks` or `seed` out of range, throws a `RangeError`. The package is ESM only and ships its own TypeScript types.
+An unknown theme or format, or a `blocks` or `seed` out of range, throws a `RangeError`. Options that are not an object, or a switch that is not `true` or `false`, throw a `TypeError`. `paragraphs()` ignores `format`. The package is ESM only and ships its own TypeScript types.
 
 ## Links
 

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   paragraphs,
   randomSeed,
   themes
-} from "./shared-YONSI3TH.js";
+} from "./shared-B3DMJ5UC.js";
 
 // packages/ipsumify/src/run.ts
 import { parseArgs } from "node:util";
@@ -57,14 +57,14 @@ Examples
   npx ipsumify --all --format html > sample.html
   npx ipsumify | pbcopy
 `;
-var MD_NAMES = {
-  headings: "headers",
-  headers: "headers",
-  code: "code",
-  quotes: "quotes",
-  lists: "lists",
-  links: "links"
-};
+var MD_NAMES = /* @__PURE__ */ new Map([
+  ["headings", "headers"],
+  ["headers", "headers"],
+  ["code", "code"],
+  ["quotes", "quotes"],
+  ["lists", "lists"],
+  ["links", "links"]
+]);
 function fail(message) {
   return { code: 1, stdout: "", stderr: `ipsumify: ${message}
 Run "ipsumify --help" for usage.
@@ -119,7 +119,11 @@ function run(argv, version = "0.0.0") {
     if (positionals.length > 1) {
       throw new RangeError(`Unexpected argument "${positionals[1]}".`);
     }
-    const blocksArg = values.blocks ?? values.paragraphs ?? positionals[0];
+    const blockCounts = [values.blocks, values.paragraphs, positionals[0]].filter((value) => value !== void 0);
+    if (blockCounts.length > 1) {
+      throw new RangeError("The number of blocks is given more than once. Use one of: a first argument, --blocks, --paragraphs.");
+    }
+    const blocksArg = blockCounts[0];
     const options = {
       theme: values.theme,
       blocks: blocksArg === void 0 ? void 0 : wholeNumber("blocks", blocksArg),
@@ -135,7 +139,7 @@ function run(argv, version = "0.0.0") {
     };
     if (values.md !== void 0) {
       for (const name of values.md.split(",").map((part) => part.trim()).filter(Boolean)) {
-        const key = MD_NAMES[name];
+        const key = MD_NAMES.get(name);
         if (!key) {
           throw new RangeError(`Invalid --md value "${name}". Valid values: headings, code, quotes, lists, links`);
         }
@@ -174,7 +178,7 @@ function run(argv, version = "0.0.0") {
 }
 
 // packages/ipsumify/src/cli.ts
-var result = run(process.argv.slice(2), "2.5.0");
+var result = run(process.argv.slice(2), "2.6.0");
 if (result.stdout) process.stdout.write(result.stdout);
 if (result.stderr) process.stderr.write(result.stderr);
 process.exitCode = result.code;

package/dist/index.d.ts

@@ -41,12 +41,15 @@ export declare function randomSeed(): number
 /**
  * Generates placeholder text.
  * @throws {RangeError} For an unknown theme or format, or blocks or seed out of range
+ * @throws {TypeError} If options is not an object, or a switch is not a boolean
  */
 export declare function ipsumify(options?: IpsumifyOptions): string
 
 /**
  * Generates the body paragraphs as an array, one string per block, without markdown elements.
+ * `format` is ignored.
  * @throws {RangeError} For an unknown theme, or blocks or seed out of range
+ * @throws {TypeError} If options is not an object, or a switch is not a boolean
  */
 export declare function paragraphs(options?: IpsumifyOptions): string[]
 

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   randomSeed,
   src_default,
   themes
-} from "./shared-YONSI3TH.js";
+} from "./shared-B3DMJ5UC.js";
 export {
   DEFAULT_BLOCKS,
   DEFAULT_THEME,