feat: add isClass function

[MarlonPassos-git]

Tip

The owner of this PR can publish a preview release by commenting /publish in this PR. Afterwards, anyone can try it out by running pnpm add radashi@pr<PR_NUMBER>.

Summary

Add the isClass function

 isClass(class CustomClass {}) // => true
 isClass('abc') // => false
 isClass({}) // => false

In the documentation, I emphasized that this function primarily validates whether a value is a custom class using the class syntax, rather than checking if the value is compatible with new. If we wanted to handle all cases of instantiable objects, including old-school function-based classes and “native classes”, we should implement separate functions for these cases. This function does not account for function constructors or native classes that can still be instantiated with new.

If we were to address this, we could consider implementing a separate utility, perhaps using an approach like this: https://www.npmjs.com/package/isclass?activeTab=code

Related issue, if any:

For any code change,

• Related documentation has been updated, if needed
• Related tests have been added or updated, if needed
• Related benchmarks have been added or updated, if needed

Does this PR introduce a breaking change?

No

Bundle impact

Status	File	Size 1	Difference
A	src/typed/isClass.ts	148	+148

Footnotes

1. Function size includes the import dependencies of the function. ↩

[aleclarson]

Thank you for this 😎

I tweaked the Class type and the return type of isClass to be even more robust. Also added more “type test” cases.

[aleclarson]

Hey! There's a new requirement for PRs that introduce new features. Without this requirement met, we won't be able to merge this. Note that this PR can still be included in a beta prerelease before this requirement is fulfilled.

• Edit the next-minor.md file

[MarlonPassos-git]

@aleclarson i fix the next-minor.md but now this PR broken the Benchmark CI, and i don't know why. when i try to run the command pnpm bench isClass or pnpm bench in my device work well.

[radashi-bot]

Benchmark Results

Name	Current
isClass: with class	579,482 ops/sec ±6.26%
isClass: with non-class	3,905,610.91 ops/sec ±0.06%

Performance regressions of 30% or more should be investigated, unless they were anticipated. Smaller regressions may be due to normal variability, as we don't use dedicated CI infrastructure.

[radashi-bot]

A stable release 12.3.0 has been published to NPM. 🚀

To install:

pnpm add [email protected]