Levrage BigInt to represent int64/uint64

[minggangw]

Due to double precision floating point format, JavaScript can only safely represent integers between -(2^53 – 1) to 2^53 – 1, meanwhile, Number.MAX_SAFE_INTEGER is defined to represent the maximum safe integer in JavaScript, which is 9007199254740991. Per ROS2 message types, it has int64/uint64, which may be out of the range above.

For current implementation, we leverage ref to read/write values from int64_t and uint64_t data of C++, which can be type of:

1. number: when value in [-Number.MAX_SAFE_INTEGER Number.MAX_SAFE_INTEGER].
2. string: otherwise.

This brings the problem that the type of int64/uint64 be ununified in JavaScript. Along with BigInt introduced, it becomes possible to make the type consistent.

This patch implements to leverage BigInt to represent int64/uint64, including:

1. Update message.dot to use BigInt when hitting int64/uint64.
2. Update rosidl_parser.js to convert int64/uint64 to string in JSON object.
3. Update message_translator.js to add bigint as primitive.
4. Update parameter.js to use BigInt for integer and its ts definition parameter.d.ts.
5. Update tests targeting on messages that include int64/uint64.

Fix: #836, #1025

[Copilot]

Copilot reviewed 7 out of 22 changed files in this pull request and generated no comments.

Files not reviewed (15)

• package.json: Language not supported
• rosidl_gen/templates/message.dot: Language not supported
• test/test-service-with-async-callback.js: Evaluated as low risk
• test/test-interactive.js: Evaluated as low risk
• test/test-fixed-array.js: Evaluated as low risk
• test/client_setup.js: Evaluated as low risk
• test/test-bounded-sequences.js: Evaluated as low risk
• test/test-security-related.js: Evaluated as low risk
• test/test-message-translator-primitive.js: Evaluated as low risk
• rosidl_gen/packages.js: Evaluated as low risk
• rosidl_gen/message_translator.js: Evaluated as low risk
• test/test-parameter-service.js: Evaluated as low risk
• test/test-service-introspection.js: Evaluated as low risk
• test/test-parameters.js: Evaluated as low risk
• test/test-primitive-msg-type-check.js: Evaluated as low risk

Comments suppressed due to low confidence (1)

rosidl_parser/rosidl_parser.js:49

• The context parameter is only available in Node.js versions >= 21.0.0.0. Ensure that the version check correctly handles this and that context.source is always available.

return JSON.parse(str, (key, value, context) => {