Generate Property Test

Generate a property-based test for the

{{ method }}

Project Conventions

This project uses fast-check for property-based testing. Follow these patterns:

Custom Arbitrary

Use the existing

decimalArb

src/core/decimal.property.test.ts

import * as fc from "fast-check";
import { Decimal } from "./decimal";

// Arbitrary for valid decimal values
const decimalArb = fc
  .tuple(
    fc.bigInt({ min: -10n ** 18n, max: 10n ** 18n }),
    fc.integer({ min: 0, max: 8 })
  )
  .map(([significand, scale]) => {
    const str = significand.toString();
    if (scale === 0) return Decimal.from(str);
    const insertPoint = str.length - scale;
    if (insertPoint <= 0) {
      return Decimal.from(`0.${"0".repeat(-insertPoint)}${str.replace("-", "")}`);
    }
    return Decimal.from(`${str.slice(0, insertPoint)}.${str.slice(insertPoint)}`);
  });

Test Structure

import { describe, test, expect } from "bun:test";
import * as fc from "fast-check";

describe("{{ method }} properties", () => {
  test("property name", () => {
    fc.assert(
      fc.property(decimalArb, (a) => {
        // Return boolean for invariant
        return /* invariant expression */;
      })
    );
  });
});

Mathematical Invariants to Consider

For arithmetic operations, consider these properties:

a.op(identity) = a

a.op(b) = b.op(a)

(a.op(b)).op(c) = a.op(b.op(c))

a.op(a.inverse()) = identity

a.mul(b.add(c)) = a.mul(b).add(a.mul(c))

op(a, a) = a

min(a, max(a, b)) = a

Output Location

Add tests to:

src/core/decimal.property.test.ts

Your Task

1. Read

   src/core/decimal.property.test.ts

   to understand existing patterns
2. Read

   src/core/decimal.ts

   to understand the

   {{ method }}

   implementation
3. Generate property tests for

   {{ method }}

   covering relevant invariants
4. Add tests to the existing property test file in the appropriate describe block