A zero dependency deterministic placeholder text generator in TypeScript

1 hour ago 1

npm Zero Dependencies TypeScript  MIT

A zero dependency corpus based placeholder text generator with deterministic output.

import { generateText, Corpus } from "placetext"; const text = generateText({ corpus: Corpus.Classic, sentences: 5 }); console.log(text);

Generates text using a selected corpus.

Common options:

  • corpus Corpus or string array
  • words number
  • sentences number
  • paragraphs number
  • seed number

Only one of words, sentences, or paragraphs should be provided.

createGenerator(corpus, options)

Low level generator for custom flows.

import { createGenerator } from "placetext"; const g = createGenerator(["alpha", "beta", "gamma"], { seed: 7 }); console.log(g.sentences(2));

Short samples so users know what they get.

generateText({ corpus: Corpus.Classic, sentences: 1 }); // "Lorem ipsum dolor sit amet consectetur adipiscing elit."
generateText({ corpus: Corpus.Tech, sentences: 1 }); // "Algorithm buffer async backend protocol interface."
generateText({ corpus: Corpus.Startup, sentences: 1 }); // "Leverage synergy accelerate innovative paradigm solution."
generateText({ corpus: Corpus.Concise, sentences: 1 }); // "Time moves fast people learn quickly things change often."
generateText({ corpus: Corpus.Musk, sentences: 1 }); // "Mars starship neural rocket accelerate future."
const words = ["apple", "banana", "cherry"]; generateText({ corpus: words, sentences: 2 });
const a = generateText({ corpus: Corpus.Tech, sentences: 3, seed: 42 }); const b = generateText({ corpus: Corpus.Tech, sentences: 3, seed: 42 }); // a and b are identical

Import only what you need to reduce bundle size.

import { createGenerator } from "placetext/core"; import { tech } from "placetext/corpora/tech"; const g = createGenerator(tech);

Most placeholder generators are tied to lorem ipsum, include unnecessary dependencies, or lack deterministic output. placetext provides:

  • zero dependencies
  • full TypeScript implementation
  • deterministic mode for tests
  • multiple built in corpora
  • low level and high level APIs

MIT

Pull requests and issues are welcome.

Read Entire Article