update docs for utils

Author: ECorreia45

docs/documentation/utilities/is-&-isnot.md

@@ -16,7 +16,7 @@ const [status, setStatus] = state('pending')
 html`${when(is(status, 'pending'), html`<p>loading...</p>`, html`<p>done</p>`)}`
 ```
 
-Both the `is` and `isNot` take two arguments, a state or some data, and a value or a checker. They will always return a boolean as the result.
+Both the `is` and `isNot` take two arguments, a state or some data, and a value or a checker. They will always return a boolean as the result. The second argument is optional and when not provided, it will check if the value is [truthy](https://developer.mozilla.org/en-US/docs/Glossary/Truthy) or [falsy](https://developer.mozilla.org/en-US/docs/Glossary/Falsy)
 
 ### RegExp
 

package.json

@@ -1,6 +1,6 @@
 {
     "name": "@beforesemicolon/markup",
-    "version": "1.17.4",
+    "version": "1.18.0",
     "description": "Reactive HTML Templating System",
     "engines": {
         "node": ">=18.16.0"

src/helpers/is-not.helper.spec.ts

@@ -3,6 +3,9 @@ import {isNot} from "./is-not.helper.ts";
 describe('isNot', () => { // @ts-ignore
 
 	it('should handle isNot', () => {
+		expect(isNot(12)()).toBe(false)
+		expect(isNot(0)()).toBe(true)
+		expect(isNot(() => true)()).toBe(false)
 		expect(isNot(() => true, true)()).toBe(false)
 		expect(isNot(() => true, false)()).toBe(true)
 		expect(isNot(() => true, () => false)()).toBe(true)

src/helpers/is-not.helper.ts

@@ -13,7 +13,7 @@ import { is } from './is.helper.ts'
 export const isNot =
     <T>(
         st: T | StateGetter<T>,
-        dataOrCheckerFn: HelperValueChecker<T> | AnythingButAFunction<T>
+        dataOrCheckerFn?: HelperValueChecker<T> | AnythingButAFunction<T>
     ) =>
     () =>
         !is(st, dataOrCheckerFn)()

src/helpers/is.helper.spec.ts

@@ -3,6 +3,9 @@ import {is} from "./is.helper.ts";
 describe('is', () => { // @ts-ignore
 
 	it('should handle is', () => {
+		expect(is(12)()).toBe(true)
+		expect(is(0)()).toBe(false)
+		expect(is(() => true)()).toBe(true)
 		expect(is(() => true, true)()).toBe(true)
 		expect(is(() => true, false)()).toBe(false)
 		expect(is(() => true, () => false)()).toBe(false)

src/helpers/is.helper.ts

@@ -13,7 +13,7 @@ import { val } from './val.ts'
 export const is =
     <T>(
         st: T | StateGetter<T>,
-        dataOrCheckerFn: HelperValueChecker<T> | AnythingButAFunction<T>
+        dataOrCheckerFn?: HelperValueChecker<T> | AnythingButAFunction<T>
     ) =>
     () => {
         const value = val<T>(st)
@@ -26,5 +26,9 @@ export const is =
             return dataOrCheckerFn.test(String(value))
         }
 
+        if (dataOrCheckerFn === undefined) {
+            return Boolean(value)
+        }
+
         return value === dataOrCheckerFn
     }