cliui 8.0.1

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 pkg:npm/cliui@8.0.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/cliui@8.0.1

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:f4be0599d1be12ed4f8eff577e82933989673aea8a52a9470718e362762aa26c","contract":["cliui initializes a layout instance with custom options such as width","div arranges multiple column objects into formatted text according to column widths","div handles column alignment such as right-aligned columns","div supports padding options for column spacing","resetOutput clears the buffer so subsequent toString calls return an empty string","formatColumns renders multiple rows with structured column layouts"],"goal":"verify pkg:npm/cliui@8.0.1","kind":"HOW","packages":["pkg:npm/cliui@8.0.1"],"schemaVersion":1},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/cliui@8.0.1"],"schemaVersion":1,"subject":"pkg:npm/cliui@8.0.1","verifierAdapter":"node-typescript@1"}

{
  "name": "sample-cliui",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-cliui",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "cliui": "8.0.1"
      }
    },
    "node_modules/ansi-regex": {
      "version": "5.0.1",
      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/ansi-styles": {
      "version": "4.3.0",
      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
      "license": "MIT",
      "dependencies": {
        "color-convert": "^2.0.1"
      },
      "engines": {
        "node": ">=8"
      },
      "funding": {
        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
      }
    },
    "node_modules/cliui": {
      "version": "8.0.1",
      "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
      "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==",
      "license": "ISC",
      "dependencies": {
        "string-width": "^4.2.0",
        "strip-ansi": "^6.0.1",
        "wrap-ansi": "^7.0.0"
      },
      "engines": {
        "node": ">=12"
      }
    },
    "node_modules/color-convert": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
      "license": "MIT",
      "dependencies": {
        "color-name": "~1.1.4"
      },
      "engines": {
        "node": ">=7.0.0"
      }
    },
    "node_modules/color-name": {
      "version": "1.1.4",
      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
      "license": "MIT"
    },
    "node_modules/emoji-regex": {
      "version": "8.0.0",
      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
      "license": "MIT"
    },
    "node_modules/is-fullwidth-code-point": {
      "version": "3.0.0",
      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/string-width": {
      "version": "4.2.3",
      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
      "license": "MIT",
      "dependencies": {
        "emoji-regex": "^8.0.0",
        "is-fullwidth-code-point": "^3.0.0",
        "strip-ansi": "^6.0.1"
      },
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/strip-ansi": {
      "version": "6.0.1",
      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
      "license": "MIT",
      "dependencies": {
        "ansi-regex": "^5.0.1"
      },
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/wrap-ansi": {
      "version": "7.0.0",
      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
      "license": "MIT",
      "dependencies": {
        "ansi-styles": "^4.0.0",
        "string-width": "^4.1.0",
        "strip-ansi": "^6.0.0"
      },
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
      }
    }
  }
}

{
  "name": "sample-cliui",
  "version": "1.0.0",
  "private": true,
  "description": "verify pkg:npm/cliui@8.0.1",
  "main": "src/index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "cliui": "8.0.1"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/cliui@8.0.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/cliui@8.0.1"
  ]
}

const cliui = require('cliui');

function createUI(options) {
  return cliui(options);
}

function formatColumns(rows, options) {
  const ui = cliui(options);
  for (const row of rows) {
    if (Array.isArray(row)) {
      ui.div(...row);
    } else {
      ui.div(row);
    }
  }
  return ui.toString();
}

module.exports = {
  cliui,
  createUI,
  formatColumns
};

const assert = require('node:assert');
const cliui = require('cliui');
const { createUI, formatColumns } = require('../src/index.js');

// 1. cliui initializes a layout instance with custom options such as width
const ui1 = createUI({ width: 60 });
assert.strictEqual(ui1.width, 60, 'UI width should match the configured option');

// 2. div arranges multiple column objects into formatted text according to column widths
ui1.div(
  { text: 'colA', width: 20 },
  { text: 'colB', width: 20 }
);
const out1 = ui1.toString();
assert.strictEqual(out1, 'colA                colB', 'Columns should be positioned according to specified width');

// 3. div handles column alignment such as right-aligned columns
const ui2 = createUI({ width: 40 });
ui2.div(
  { text: 'Left', width: 20 },
  { text: 'Right', width: 20, align: 'right' }
);
const out2 = ui2.toString();
assert.strictEqual(out2, 'Left                               Right', 'Right alignment should pad content appropriately');

// 4. div supports padding options for column spacing
const ui3 = createUI({ width: 40 });
ui3.div(
  { text: 'Item', width: 10, padding: [0, 2, 0, 2] },
  { text: 'Val', width: 10 }
);
const out3 = ui3.toString();
assert.strictEqual(out3, '  Item    Val', 'Padding should add leading and trailing spaces around column text');

// 5. resetOutput clears the buffer so subsequent toString calls return an empty string
ui3.resetOutput();
assert.strictEqual(ui3.toString(), '', 'Buffer should be empty after resetOutput');

// 6. formatColumns helper correctly renders multiple rows
const multiRowOutput = formatColumns([
  [{ text: 'Header1', width: 15 }, { text: 'Header2', width: 15 }],
  [{ text: 'Row1', width: 15 }, { text: 'Row2', width: 15 }]
], { width: 30 });
assert.strictEqual(
  multiRowOutput,
  'Header1        Header2\nRow1           Row2',
  'formatColumns should format multiple rows of column layouts'
);

console.log('Contract tests passed successfully.');
process.exit(0);