feat(number): add number/uint64/ctor

[impawstarlight]

Resolves none.

Description

What is the purpose of this pull request?

This pull request:

• Implements a constructor for creating 64-bit unsigned integers

Related Issues

Does this pull request have any related issues?

No

Questions

Any questions for reviewers of this pull request?

I've put various questions throughout the code as TODO comments

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

A lot of package structure stuff are missing and I committed with --no-verify since I wanted an early review. Also, how to run lint only for a specific package? I found filter env vars for running examples, tests, benchmarks but not for lint.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

• Read, understood, and followed the contributing guidelines.

AI Assistance

When authoring the changes proposed in this PR, did you use any kind of AI assistance?

• Yes
• No

If you answered "yes" above, how did you use AI assistance?

• Code generation (e.g., when writing an implementation or fixing a bug)
• Test/benchmark generation
• Documentation (including examples)
• Research and understanding

Disclosure

If you answered "yes" to using AI assistance, please provide a short disclosure indicating how you used AI assistance. This helps reviewers determine how much scrutiny to apply when reviewing your contribution. Example disclosures: "This PR was written primarily by Claude Code." or "I consulted ChatGPT to understand the codebase, but the proposed changes were fully authored manually by myself.".

I used Gemini and Copilot for discussing ideas, resolving errors and generating tests but the main implementation is fully done by hand.

---

@stdlib-js/reviewers

[impawstarlight]

@kgryte I've worked out an initial implementation of the uint64/ctor

[stdlib-bot]

Coverage Report

Package	Statements	Branches	Functions	Lines
number/uint64/ctor	$\color{red}986/1022$ $\color{green}+0.00%$	$\color{red}72/80$ $\color{green}+0.00%$	$\color{green}10/10$ $\color{green}+0.00%$	$\color{red}986/1022$ $\color{green}+0.00%$

The above coverage report was generated for the changes in this PR.

[kgryte]

@impawstarlight Thank you for opening this PR. I went ahead and did a fair amount of surgery in hopes of simplifying the constructor and reducing the size of the implementation.

In particular, I moved support for materializing a Uint64 from a string to a separate stubbed package, which still needs to be completed.

I added various FIXMEs and TODOs for things which need follow-ups. The tests in particular I removed, as they need to be replaced with something more inline with stdlib conventions.

Ultimately, I think this and Int64 will be welcome additions and will help pave the way for Int64Array and Uint64Array arrays, which will be nice to have for other work we are currently doing with ndarrays.

Have to discuss further, but hopefully, this should provide some direction.

[kgryte]

@impawstarlight Also, looks like you'll want to go ahead and setup verified commits. This will make editing your PRs a bit easier going forward.

[impawstarlight]

Why do we use any here instead of the exact object shape?

[kgryte]

Feel free to replace with an interface. Agreed that this is under-typed, as is the complex number constructors.