@webassemblyjs/helper-numbers 1.13.2: parse32F, parse32I, parse64F

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/%40webassemblyjs/helper-numbers@1.13.2
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40webassemblyjs/helper-numbers@1.13.2
Demonstrate these symbols/APIs:
  - parse32F
  - parse32I
  - parse64F
  - parse64I
  - parseU32

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:7a755081f2558bf5f82e401fe495ad551fc467b96e2ffefdb11ab4091bf5e970","contract":["parse32I parses decimal and hexadecimal integer strings into 32-bit signed integers","parseU32 parses non-negative integer strings and throws CompileError for negative values","parse64I parses decimal and hexadecimal strings into 64-bit integer objects with high and low parts","parse32F parses 32-bit floating point, hex float, infinity, and NaN literal strings","parse64F parses 64-bit floating point, hex float, infinity, and NaN literal strings"],"goal":"verify pkg:npm/%40webassemblyjs/helper-numbers@1.13.2","kind":"HOW","packages":["pkg:npm/%40webassemblyjs/helper-numbers@1.13.2"],"schemaVersion":1,"symbols":["parse32F","parse32I","parse64F","parse64I","parseU32"]},"contractCommand":["node","test/contract.js"],"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/%40webassemblyjs/helper-numbers@1.13.2"],"schemaVersion":1,"subject":"pkg:npm/%40webassemblyjs/helper-numbers@1.13.2","symbols":["parse32F","parse32I","parse64F","parse64I","parseU32"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-webassemblyjs-helper-numbers",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-webassemblyjs-helper-numbers",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "@webassemblyjs/helper-numbers": "1.13.2"
      }
    },
    "node_modules/@webassemblyjs/floating-point-hex-parser": {
      "version": "1.13.2",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.13.2.tgz",
      "integrity": "sha512-6oXyTOzbKxGH4steLbLNOu71Oj+C8Lg34n6CqRvqfS2O71BxY6ByfMDRhBytzknj9yGUPVJ1qIKhRlAwO1AovA==",
      "license": "MIT"
    },
    "node_modules/@webassemblyjs/helper-api-error": {
      "version": "1.13.2",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.13.2.tgz",
      "integrity": "sha512-U56GMYxy4ZQCbDZd6JuvvNV/WFildOjsaWD3Tzzvmw/mas3cXzRJPMjP83JqEsgSbyrmaGjBfDtV7KDXV9UzFQ==",
      "license": "MIT"
    },
    "node_modules/@webassemblyjs/helper-numbers": {
      "version": "1.13.2",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-numbers/-/helper-numbers-1.13.2.tgz",
      "integrity": "sha512-FE8aCmS5Q6eQYcV3gI35O4J789wlQA+7JrqTTpJqn5emA4U2hvwJmvFRC0HODS+3Ye6WioDklgd6scJ3+PLnEA==",
      "license": "MIT",
      "dependencies": {
        "@webassemblyjs/floating-point-hex-parser": "1.13.2",
        "@webassemblyjs/helper-api-error": "1.13.2",
        "@xtuc/long": "4.2.2"
      }
    },
    "node_modules/@xtuc/long": {
      "version": "4.2.2",
      "resolved": "https://registry.npmjs.org/@xtuc/long/-/long-4.2.2.tgz",
      "integrity": "sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==",
      "license": "Apache-2.0"
    }
  }
}

{
  "name": "sample-webassemblyjs-helper-numbers",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification for @webassemblyjs/helper-numbers number parsing utility",
  "main": "src/index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "@webassemblyjs/helper-numbers": "1.13.2"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/%40webassemblyjs/helper-numbers@1.13.2",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40webassemblyjs/helper-numbers@1.13.2"
  ],
  "symbols": [
    "parse32F",
    "parse32I",
    "parse64F",
    "parse64I",
    "parseU32"
  ]
}

const {
  parse32F,
  parse64F,
  parse32I,
  parseU32,
  parse64I,
  isInfLiteral,
  isNanLiteral,
} = require('@webassemblyjs/helper-numbers');

module.exports = {
  parse32F,
  parse64F,
  parse32I,
  parseU32,
  parse64I,
  isInfLiteral,
  isNanLiteral,
};

const assert = require('node:assert');
const {
  parse32F,
  parse64F,
  parse32I,
  parseU32,
  parse64I,
  isInfLiteral,
  isNanLiteral,
} = require('../src/index.js');

// 1. parse32I parses decimal and hexadecimal integer strings into 32-bit signed integers
assert.strictEqual(parse32I('42'), 42);
assert.strictEqual(parse32I('0'), 0);
assert.strictEqual(parse32I('-100'), -100);
assert.strictEqual(parse32I('0x1f'), 31);
assert.strictEqual(parse32I('-0x10'), -16);
assert.throws(() => parse32I('1e5'), /This number literal format is yet to be implemented/);

// 2. parseU32 parses non-negative integer strings and throws CompileError for negative values
assert.strictEqual(parseU32('0'), 0);
assert.strictEqual(parseU32('12345'), 12345);
assert.strictEqual(parseU32('0x2a'), 42);
assert.throws(() => parseU32('-1'), /Illegal value for u32: -1/);
assert.throws(() => parseU32('-100'), /Illegal value for u32: -100/);

// 3. parse64I parses decimal and hexadecimal strings into 64-bit integer objects with high and low parts
const i64Small = parse64I('42');
assert.strictEqual(typeof i64Small, 'object');
assert.strictEqual(i64Small.high, 0);
assert.strictEqual(i64Small.low, 42);

const i64Hex = parse64I('0x100000000');
assert.strictEqual(i64Hex.high, 1);
assert.strictEqual(i64Hex.low, 0);

const i64Negative = parse64I('-1');
assert.strictEqual(i64Negative.high, -1);
assert.strictEqual(i64Negative.low, -1);

assert.throws(() => parse64I('1e10'), /This number literal format is yet to be implemented/);

// 4. parse32F parses 32-bit floating point, hex float, infinity, and NaN literal strings
assert.strictEqual(parse32F('3.14'), 3.14);
assert.strictEqual(parse32F('0.0'), 0);
assert.strictEqual(parse32F('0x1.0p0'), 1);
assert.strictEqual(parse32F('+inf'), 1);
assert.strictEqual(parse32F('-inf'), -1);
assert.strictEqual(parse32F('inf'), 1);
assert.strictEqual(parse32F('nan'), 0x400000);
assert.strictEqual(parse32F('+nan'), 0x400000);
assert.strictEqual(parse32F('-nan'), -0x400000);
assert.strictEqual(parse32F('nan:0x123'), 0x123);

// 5. parse64F parses 64-bit floating point, hex float, infinity, and NaN literal strings
assert.strictEqual(parse64F('3.14'), 3.14);
assert.strictEqual(parse64F('0.0'), 0);
assert.strictEqual(parse64F('0x1.0p0'), 1);
assert.strictEqual(parse64F('+inf'), 1);
assert.strictEqual(parse64F('-inf'), -1);
assert.strictEqual(parse64F('inf'), 1);
assert.strictEqual(parse64F('nan'), 0x8000000000000);
assert.strictEqual(parse64F('+nan'), 0x8000000000000);
assert.strictEqual(parse64F('-nan'), -0x8000000000000);
assert.strictEqual(parse64F('nan:0x456'), 0x456);

// Literal helpers
assert.strictEqual(isInfLiteral('inf'), true);
assert.strictEqual(isInfLiteral('+INF'), true);
assert.strictEqual(isInfLiteral('-inf'), true);
assert.strictEqual(isInfLiteral('123'), false);

assert.strictEqual(isNanLiteral('nan'), true);
assert.strictEqual(isNanLiteral('+NAN'), true);
assert.strictEqual(isNanLiteral('-nan'), true);
assert.strictEqual(isNanLiteral('123'), false);

console.log('All contract assertions passed successfully.');