@webassemblyjs/wast-parser 1.14.1: parse32I

audit=false
fund=false
update-notifier=false

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 @webassemblyjs/wast-parser.parse32I in pkg:npm/%40webassemblyjs/wast-parser@1.14.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40webassemblyjs/wast-parser@1.14.1
Demonstrate these symbols/APIs:
  - @webassemblyjs/wast-parser.parse32I

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:fc464d55ff837f532840d913481763d7f1ad253de14da3cb9f2db1a3483f4c3f","constraints":{"executionContext":"node"},"contract":["parse32I converts positive and negative decimal integer literal strings into signed 32-bit integers","parse32I converts hexadecimal integer literal strings into signed 32-bit integers","parse32I truncates two's complement 32-bit hexadecimal values into negative signed 32-bit integers","parseSigned32Int wrapper parses decimal and hexadecimal WebAssembly integer literals using parse32I","parse32I throws an Error when encountering decimal exponent literals that are not yet implemented"],"goal":"verify @webassemblyjs/wast-parser.parse32I in pkg:npm/%40webassemblyjs/wast-parser@1.14.1","kind":"HOW","packages":["pkg:npm/%40webassemblyjs/wast-parser@1.14.1"],"schemaVersion":1,"symbols":["@webassemblyjs/wast-parser.parse32I"]},"contractCommand":["node","test/contract.mjs"],"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/%40webassemblyjs/wast-parser@1.14.1"],"schemaVersion":1,"subject":"pkg:npm/%40webassemblyjs/wast-parser@1.14.1","symbols":["@webassemblyjs/wast-parser.parse32I"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-wast-parser-parse32i",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-wast-parser-parse32i",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "@webassemblyjs/wast-parser": "1.14.1"
      }
    },
    "node_modules/@webassemblyjs/ast": {
      "version": "1.14.1",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.14.1.tgz",
      "integrity": "sha512-nuBEDgQfm1ccRp/8bCQrx1frohyufl4JlbMMZ4P1wpeOfDhF6FQkxZJ1b/e+PLwr6X1Nhw6OLme5usuBWYBvuQ==",
      "license": "MIT",
      "dependencies": {
        "@webassemblyjs/helper-numbers": "1.13.2",
        "@webassemblyjs/helper-wasm-bytecode": "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-code-frame": {
      "version": "1.14.1",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-code-frame/-/helper-code-frame-1.14.1.tgz",
      "integrity": "sha512-ZwPmnx/YswXJSgsNODu1V8//QDsbGXHq+YKtgACIJktSEVIHJ2rGr/TWCAhGStbWoufwOdTmuKBF5RU+wdMeEg==",
      "license": "MIT",
      "dependencies": {
        "@webassemblyjs/wast-printer": "1.14.1"
      }
    },
    "node_modules/@webassemblyjs/helper-fsm": {
      "version": "1.13.2",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-fsm/-/helper-fsm-1.13.2.tgz",
      "integrity": "sha512-vtjQm5RN9GaL1MfWbY9U/L7a+uJ0rTqG0uHBz/PRH5K2FIFcYdcaUv0Kjfn3GTJPnXuq7sakINnIEZFho0xbfA==",
      "license": "ISC"
    },
    "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/@webassemblyjs/helper-wasm-bytecode": {
      "version": "1.13.2",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.13.2.tgz",
      "integrity": "sha512-3QbLKy93F0EAIXLh0ogEVR6rOubA9AoZ+WRYhNbFyuB70j3dRdwH9g+qXhLAO0kiYGlg3TxDV+I4rQTr/YNXkA==",
      "license": "MIT"
    },
    "node_modules/@webassemblyjs/wast-parser": {
      "version": "1.14.1",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-parser/-/wast-parser-1.14.1.tgz",
      "integrity": "sha512-XLBrfinR+Nw83hSFkgmAtQxQlC00lU92zJSBpMcpKfXalLWCHRpU7lPgSqelA/09BUgArEPCm8TiiUllZQjMnw==",
      "license": "MIT",
      "dependencies": {
        "@webassemblyjs/ast": "1.14.1",
        "@webassemblyjs/floating-point-hex-parser": "1.13.2",
        "@webassemblyjs/helper-api-error": "1.13.2",
        "@webassemblyjs/helper-code-frame": "1.14.1",
        "@webassemblyjs/helper-fsm": "1.13.2",
        "@xtuc/long": "4.2.2"
      }
    },
    "node_modules/@webassemblyjs/wast-printer": {
      "version": "1.14.1",
      "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.14.1.tgz",
      "integrity": "sha512-kPSSXE6De1XOR820C90RIo2ogvZG+c3KiHzqUoO/F34Y2shGzesfqv7o57xrxovZJH/MetF5UjroJ/R/3isoiw==",
      "license": "MIT",
      "dependencies": {
        "@webassemblyjs/ast": "1.14.1",
        "@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-wast-parser-parse32i",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "@webassemblyjs/wast-parser": "1.14.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify @webassemblyjs/wast-parser.parse32I in pkg:npm/%40webassemblyjs/wast-parser@1.14.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40webassemblyjs/wast-parser@1.14.1"
  ],
  "symbols": [
    "@webassemblyjs/wast-parser.parse32I"
  ]
}

import { parse32I } from "@webassemblyjs/wast-parser";

export function parseSigned32Int(literal) {
  return parse32I(literal);
}

import assert from "node:assert/strict";
import { parse32I } from "@webassemblyjs/wast-parser";
import { parseSigned32Int } from "../src/index.mjs";

// Test 1: parse32I converts positive and negative decimal integer literal strings into signed 32-bit integers
{
  assert.equal(parse32I("42"), 42);
  assert.equal(parse32I("+100"), 100);
  assert.equal(parse32I("-250"), -250);
  assert.equal(parse32I("0"), 0);
}

// Test 2: parse32I converts hexadecimal integer literal strings into signed 32-bit integers
{
  assert.equal(parse32I("0x10"), 16);
  assert.equal(parse32I("0x7fffffff"), 2147483647);
  assert.equal(parse32I("-0x20"), -32);
  assert.equal(parse32I("0x0"), 0);
}

// Test 3: parse32I truncates two's complement 32-bit hexadecimal values into negative signed 32-bit integers
{
  assert.equal(parse32I("0xffffffff"), -1);
  assert.equal(parse32I("0x80000000"), -2147483648);
  assert.equal(parse32I("0xfffffffe"), -2);
}

// Test 4: parseSigned32Int wrapper parses decimal and hexadecimal WebAssembly integer literals using parse32I
{
  assert.equal(parseSigned32Int("12345"), 12345);
  assert.equal(parseSigned32Int("-0x100"), -256);
  assert.equal(parseSigned32Int("0xabcdef"), 11259375);
}

// Test 5: parse32I throws an Error when encountering decimal exponent literals that are not yet implemented
{
  assert.throws(
    () => parse32I("1e3"),
    {
      name: "Error",
      message: /This number literal format is yet to be implemented\./
    }
  );
  assert.throws(
    () => parse32I("2.5e2"),
    {
      name: "Error",
      message: /This number literal format is yet to be implemented\./
    }
  );
}

console.log("All contract tests passed successfully.");