Add round and sumAll functions to BigDecimal

[jrudder]

Add round and sumAll functions to BigDecimal

Type

• Refactor
• Feature
• Bug Fix
• Optimization
• Documentation Update

Description

The round function supports rounding at an arbitrary scale/position and the following 10 rounding modes:

• ceil: round towards positive infinity
• floor: round towards negative infinity
• to-zero: round towards zero
• from-zero: round away from zero
• half-ceil: round to the nearest neighbor; if equidistant round towards positive infinity
• half-floor: round to the nearest neighbor; if equidistant round towards negative infinity
• half-to-zero: round to the nearest neighbor; if equidistant round towards zero
• half-from-zero: round to the nearest neighbor; if equidistant round away from zero
• half-even: round to the nearest neighbor; if equidistant round to the neighbor with an even digit at the specified scale
• half-odd: round to the nearest neighbor; if equidistant round to the neighbor with an odd digit at the specified scale

The default scale is 0 (round to integer), and the default mode is half-from-zero.

The sumAll function mirrors that of BigInt.sumAll.

Related

None

[changeset-bot]

🦋 Changeset detected

Latest commit: b4d1d24

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 32 packages

Name	Type
effect	Minor
@effect/cli	Major
@effect/cluster	Major
@effect/experimental	Major
@effect/opentelemetry	Major
@effect/platform-browser	Major
@effect/platform-bun	Major
@effect/platform-node-shared	Major
@effect/platform-node	Major
@effect/platform	Major
@effect/printer-ansi	Major
@effect/printer	Major
@effect/rpc	Major
@effect/sql-clickhouse	Major
@effect/sql-d1	Major
@effect/sql-drizzle	Major
@effect/sql-kysely	Major
@effect/sql-libsql	Major
@effect/sql-mssql	Major
@effect/sql-mysql2	Major
@effect/sql-pg	Major
@effect/sql-sqlite-bun	Major
@effect/sql-sqlite-do	Major
@effect/sql-sqlite-node	Major
@effect/sql-sqlite-react-native	Major
@effect/sql-sqlite-wasm	Major
@effect/sql	Major
@effect/typeclass	Major
@effect/vitest	Major
@effect/ai	Major
@effect/ai-anthropic	Major
@effect/ai-openai	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[fubhy]

Thanks! Support for rounding has been sorely missing.

[fubhy]

Can you make these rounding functions dual (data last)

[jrudder]

@fubhy Thank you for looking into this so quickly.

I have now:

• updated the functions to use dual
• cleaned up the JSDoc examples
• changed digitAt to use self (like the existing normalize and other functions, including the others I added)

[jrudder]

This last fix to the docs should get the builds working. Please let me know if there are any other changes you would like to see.

[fubhy]

This looks great. Thanks!