@uxf/core 10.0.0 → 10.10.0

package/README.md

@@ -328,86 +328,6 @@ queryParamToNumber(ctx.query.id);
 queryParamToString(ctx.query.name);
 ```
 
-## Utils
-```tsx
-import { cameCaseToDash } from "@uxf/core/utils/cameCaseToDash";
-
-const example = cameCaseToDash("fooBar") /* returns "foo-bar" */
-```
-```tsx
-import { composeRefs } from "@uxf/core/utils/composeRefs";
-
-const firstRef = useRef<HTMLDivElement>(null);
-const secondRef = useRef<HTMLDivElement>(null);
-
-const example = <div ref={composeRefs(firstRef, secondRef)} />;
-```
-```tsx
-import { cx } from "@uxf/core/utils/cx";
-
-/* fork of https://github.com/lukeed/clsx */
-const example = cx("foo", true && "bar", "baz", false && "bam", undefined) /* returns "foo bar baz" */
-```
-```tsx
-import { forwardRef } from "@uxf/core/utils/forwardRef";
-
-interface Props {
-    className?: string;
-}
-
-// will enforce 'displayName'
-export const ExampleComponent = forwardRef<HTMLDivElement, Props>("ExampleComponent", (props, ref) => {
-    return <div className={props.className} ref={ref} />;
-});
-```
-```tsx
-import { isBrowser } from "@uxf/core/utils/isBrowser";
-import { isServer } from "@uxf/core/utils/isServer";
-
-const browserExample = isBrowser; /* returns true if DOM is available */
-const serverExample = isServer; /* returns true if DOM is NOT available */
-```
-```tsx
-import { slugify } from "@uxf/core/utils/slugify";
-
-const example = slugify("Jak se dnes máte?") /* returns "jak-se-dnes-mate" */
-```
-```tsx
-import { trimTrailingZeros } from "@uxf/core/utils/trimTrailingZeros";
-
-const example = trimTrailingZeros("120,450") /* returns "120,45" */
-```
-
-```tsx
-import { filterNullish } from "@uxf/core/utils/filter-nullish";
-
-filterNullish([0, "text", null, undefined, [], {}]) /* returns [0, "text", [], {}]  */
-```
-
-```tsx
-import { isNil } from "@uxf/core/utils/is-nil";
-
-isNil(null)      /* returns true */
-isNil(undefined) /* returns true */
-isNil(true)      /* returns false */
-isNil(1)         /* returns false */
-isNil(0)         /* returns false */
-isNil([])        /* returns false */
-isNil("string")  /* returns false */
-```
-
-```tsx
-import { isNotNil } from "@uxf/core/utils/is-not-nil";
-
-isNotNil(null)      /* returns false */
-isNotNil(undefined) /* returns false */
-isNotNil(true)      /* returns true */
-isNotNil(1)         /* returns true */
-isNotNil(0)         /* returns true */
-isNotNil([])        /* returns true */
-isNotNil("string")  /* returns true */
-```
-
 ## Validators
 ```tsx
 import { Validator } from "@uxf/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uxf/core",
-  "version": "10.0.0",
+  "version": "10.10.0",
   "description": "UXF Core",
   "author": "Petr Vejvoda <vejvoda@uxf.cz>",
   "homepage": "https://gitlab.com/uxf-npm/core#readme",

package/utils/assert-not-nil.d.ts

@@ -0,0 +1,2 @@
+import { Nullish } from "../types";
+export declare function assertNotNil<T>(value: T | Nullish, errorMessage?: string): asserts value is T;

package/utils/assert-not-nil.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNotNil = void 0;
+const is_nil_1 = require("./is-nil");
+function assertNotNil(value, errorMessage = "Value is nil.") {
+    if ((0, is_nil_1.isNil)(value)) {
+        throw new Error(errorMessage);
+    }
+}
+exports.assertNotNil = assertNotNil;

package/utils/is-empty.d.ts

@@ -0,0 +1 @@
+export declare function isEmpty(value: any[] | string): boolean;

package/utils/is-empty.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmpty = void 0;
+function isEmpty(value) {
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    return value === "";
+}
+exports.isEmpty = isEmpty;

package/utils/is-empty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/is-empty.test.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const is_empty_1 = require("./is-empty");
+test("is-empty", () => {
+    expect((0, is_empty_1.isEmpty)(["1"])).toBeFalsy();
+    expect((0, is_empty_1.isEmpty)([])).toBeTruthy();
+    expect((0, is_empty_1.isEmpty)("not-empty")).toBeFalsy();
+    expect((0, is_empty_1.isEmpty)("")).toBeTruthy();
+});

package/utils/last.d.ts

@@ -0,0 +1 @@
+export declare function last<T>(value: T[]): T | undefined;

package/utils/last.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.last = void 0;
+function last(value) {
+    if (value.length === 0) {
+        return undefined;
+    }
+    return value[value.length - 1];
+}
+exports.last = last;

package/utils/last.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/last.test.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const last_1 = require("./last");
+test("last", () => {
+    expect((0, last_1.last)(["1"])).toStrictEqual("1");
+    expect((0, last_1.last)(["1", "2", "3"])).toStrictEqual("3");
+    expect((0, last_1.last)([])).toBeUndefined();
+});