feat: rule.if

[hirasso]

Description

It's time! For a current project I finally need rule.if. This is a rewrite of #47

• added a new test
• also manually tested the behavior in the project where I need it

Questions

• naming: rule.if or rule.predicate? Currently, the property is if, the type if Predicate.
• currently, rule.if will prevent a rule from being matched if it returns a falsy value (if (!this.if)...). Would it make sense to make that more strict? (if (this.if === false))?

Drive-By

• cleaned up some code comments

Checks

• The PR is submitted to the master branch
• The code was linted before pushing (npm run lint)
• All tests are passing (npm run test)
• New or updated tests are included
• The documentation was updated as required

[github-actions]

Playwright test results

 12 passed

Details

 12 tests across 1 suite
 
 d973886

[daun]

Yeah, been looking forward to this 🥯 Calling it if makes more sense to me than predicate, in terms of readability. Loose boolean matching is probably also fine -- as long as ommitting the if function is equivalent to () => true.

[hirasso]

as long as ommitting the if function is equivalent to () => true

Yes, it is. ok great!