word-wrap 1.2.5: Wrap strings with custom width, indent, newline, and trim options using word-wrap

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: Wrap strings with custom width, indent, newline, and trim options using word-wrap
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/word-wrap@1.2.5
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - runtime: node@22.23.2

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:5ea1dd05c098ea4b9b4ee68bc7e26141727d938b1924900891d430883c593e08","constraints":{"executionContext":"node"},"contract":["assert wrap(text, { width: 20 }) wraps words at whitespace boundaries with default 2-space indentation","assert wrap(text, { width: 20, indent: '' }) removes indentation prefix from all wrapped lines","assert wrap(text, { width: 20, indent: '', newline: '\u003cbr\u003e' }) joins wrapped lines using custom newline delimiter","assert wrap(longWord, { width: 10, indent: '', cut: true }) forcefully breaks words exceeding width when cut is true","assert wrap(textWithSpaces, { width: 20, indent: '', trim: true }) trims trailing whitespace from each line","assert wrap(text, { width: 5, indent: '', newline: '\\n', escape: fn }) transforms each wrapped line through the escape function","assert wrap(null) and wrap(undefined) return null and undefined without throwing"],"goal":"Wrap strings with custom width, indent, newline, and trim options using word-wrap","kind":"HOW","packages":["pkg:npm/word-wrap@1.2.5"],"schemaVersion":1},"contractCommand":["node","test/contract.cjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/word-wrap@1.2.5"],"schemaVersion":1,"subject":"pkg:npm/word-wrap@1.2.5","verifierAdapter":"node-typescript@1"}

const wrap = require('word-wrap');

function formatParagraph(text, options) {
  return wrap(text, options);
}

module.exports = {
  formatParagraph,
};

{
  "name": "word-wrap-sample",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "word-wrap-sample",
      "version": "1.0.0",
      "dependencies": {
        "word-wrap": "1.2.5"
      }
    },
    "node_modules/word-wrap": {
      "version": "1.2.5",
      "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
      "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==",
      "license": "MIT",
      "engines": {
        "node": ">=0.10.0"
      }
    }
  }
}

{
  "name": "word-wrap-sample",
  "version": "1.0.0",
  "private": true,
  "description": "Wrap strings with custom width, indent, newline, and trim options using word-wrap",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.cjs"
  },
  "dependencies": {
    "word-wrap": "1.2.5"
  }
}

{
  "schemaVersion": 1,
  "goal": "Wrap strings with custom width, indent, newline, and trim options using word-wrap",
  "kind": "HOW",
  "packages": [
    "pkg:npm/word-wrap@1.2.5"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "runtime": "node@22.23.2"
  }
}

const assert = require('node:assert/strict');
const wrap = require('word-wrap');

// 1. Default indentation and width wrapping at whitespace
const text1 = 'The quick brown fox jumps over the lazy dog.';
const wrapped1 = wrap(text1, { width: 20 });
assert.equal(wrapped1, '  The quick brown fox \n  jumps over the lazy \n  dog.');

// 2. Custom indent (empty string)
const wrapped2 = wrap(text1, { width: 20, indent: '' });
assert.equal(wrapped2, 'The quick brown fox \njumps over the lazy \ndog.');

// 3. Custom newline delimiter
const wrapped3 = wrap(text1, { width: 20, indent: '', newline: '<br>' });
assert.equal(wrapped3, 'The quick brown fox <br>jumps over the lazy <br>dog.');

// 4. cut: true forcefully breaks long words
const longWord = 'supercalifragilisticexpialidocious';
const wrapped4 = wrap(longWord, { width: 10, indent: '', cut: true });
assert.equal(wrapped4, 'supercalif\nragilistic\nexpialidoc\nious');

// 5. trim: true trims trailing whitespace from each line
const paddedText = 'hello   \nworld   ';
const wrapped5 = wrap(paddedText, { width: 20, indent: '', trim: true });
assert.equal(wrapped5, 'hello\nworld');

// 6. escape function transforms each line
const wrapped6 = wrap('foo bar baz', {
  width: 5,
  indent: '',
  newline: '\n',
  escape: (line) => '[' + line.trim() + ']',
});
assert.equal(wrapped6, '[foo]\n[bar]\n[baz]');

// 7. null and undefined handling
assert.equal(wrap(null), null);
assert.equal(wrap(undefined), undefined);

console.log('Contract passed.');