word-wrap 1.2.5: wordWrap

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: verify wordWrap in pkg:npm/word-wrap@1.2.5
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/word-wrap@1.2.5
Demonstrate these symbols/APIs:
  - wordWrap

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:82ca2a2a099bfd377be18858bcca569159fbf41444ec74fc71dff0fb89246d07","contract":["word-wrap package metadata declares version 1.2.5 and main entry point","word-wrap exports a function as default export","wordWrap wraps text exceeding default width (50) with default indentation of two spaces","wordWrap wraps text at word boundaries to specified width","wordWrap strips trailing whitespace from wrapped lines when trim is true","wordWrap applies custom line indentation to all wrapped lines","wordWrap joins wrapped lines with a custom newline string","wordWrap breaks words longer than the specified width when cut is true","wordWrap preserves unbroken words exceeding the width when cut is false","wordWrap transforms each matched line using a custom escape function","wordWrap returns null or undefined unchanged when provided as input"],"goal":"verify wordWrap in pkg:npm/word-wrap@1.2.5","kind":"HOW","packages":["pkg:npm/word-wrap@1.2.5"],"schemaVersion":1,"symbols":["wordWrap"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/word-wrap@1.2.5"],"schemaVersion":1,"subject":"pkg:npm/word-wrap@1.2.5","symbols":["wordWrap"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-word-wrap-verify",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-word-wrap-verify",
      "version": "1.0.0",
      "license": "MIT-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": "sample-word-wrap-verify",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "license": "MIT-0",
  "dependencies": {
    "word-wrap": "1.2.5"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify wordWrap in pkg:npm/word-wrap@1.2.5",
  "kind": "HOW",
  "packages": [
    "pkg:npm/word-wrap@1.2.5"
  ],
  "symbols": [
    "wordWrap"
  ]
}

import assert from 'node:assert/strict';
import fs from 'node:fs';
import { createRequire } from 'node:module';
import wrap from 'word-wrap';

const require = createRequire(import.meta.url);

// Contract 1: word-wrap package metadata declares version 1.2.5 and main entry point
{
  const pkgJsonPath = require.resolve('word-wrap/package.json');
  assert.ok(fs.existsSync(pkgJsonPath));
  const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
  assert.strictEqual(pkgJson.name, 'word-wrap');
  assert.strictEqual(pkgJson.version, '1.2.5');
  assert.strictEqual(pkgJson.main, 'index.js');
}

// Contract 2: word-wrap exports a function as default export
{
  assert.strictEqual(typeof wrap, 'function');
}

// Contract 3: wordWrap wraps text exceeding default width (50) with default indentation of two spaces
{
  const text = 'The quick brown fox jumps over the lazy dog and runs through the forest with great agility.';
  const result = wrap(text);
  assert.strictEqual(typeof result, 'string');
  assert.ok(result.startsWith('  '));
  const lines = result.split('\n');
  assert.ok(lines.length > 1);
  for (const line of lines) {
    assert.ok(line.startsWith('  '));
  }
}

// Contract 4: wordWrap wraps text at word boundaries to specified width
{
  const text = 'hello world lorem ipsum dolor sit amet';
  const result = wrap(text, { width: 12, indent: '', trim: true });
  assert.strictEqual(result, 'hello world\nlorem ipsum\ndolor sit\namet');
}

// Contract 5: wordWrap strips trailing whitespace from wrapped lines when trim is true
{
  const text = 'hello world lorem ipsum dolor sit amet';
  const resultWithoutTrim = wrap(text, { width: 12, indent: '', trim: false });
  assert.strictEqual(resultWithoutTrim, 'hello world \nlorem ipsum \ndolor sit \namet');

  const resultWithTrim = wrap(text, { width: 12, indent: '', trim: true });
  assert.strictEqual(resultWithTrim, 'hello world\nlorem ipsum\ndolor sit\namet');
}

// Contract 6: wordWrap applies custom line indentation to all wrapped lines
{
  const text = 'alpha beta gamma delta';
  const result = wrap(text, { width: 15, indent: '>> ', trim: true });
  const lines = result.split('\n');
  assert.strictEqual(lines.length, 2);
  assert.strictEqual(lines[0], '>> alpha beta');
  assert.strictEqual(lines[1], '>> gamma delta');
}

// Contract 7: wordWrap joins wrapped lines with a custom newline string
{
  const text = 'alpha beta gamma delta';
  const result = wrap(text, { width: 15, indent: '', newline: '<br/>' });
  assert.strictEqual(result, 'alpha beta <br/>gamma delta');
}

// Contract 8: wordWrap breaks words longer than the specified width when cut is true
{
  const text = 'supercalifragilistic';
  const result = wrap(text, { width: 5, indent: '', cut: true });
  assert.strictEqual(result, 'super\ncalif\nragil\nistic');
}

// Contract 9: wordWrap preserves unbroken words exceeding the width when cut is false
{
  const text = 'supercalifragilistic is very long';
  const result = wrap(text, { width: 8, indent: '', cut: false, trim: true });
  assert.strictEqual(result, 'supercalifragilistic\nis very\nlong');
}

// Contract 10: wordWrap transforms each matched line using a custom escape function
{
  const text = 'foo bar baz';
  const result = wrap(text, {
    width: 6,
    indent: '',
    escape: (line) => line.toUpperCase()
  });
  assert.strictEqual(result, 'FOO \nBAR \nBAZ');
}

// Contract 11: wordWrap returns null or undefined unchanged when provided as input
{
  assert.strictEqual(wrap(null), null);
  assert.strictEqual(wrap(undefined), undefined);
}

console.log('All word-wrap contract tests passed.');