feat: export isRole function

Author: daybrush

package-lock.json

@@ -1,6 +1,6 @@
 {
     "name": "scenejs",
-    "version": "1.4.3",
+    "version": "1.5.0",
     "description": "JavaScript & CSS timeline-based animation library",
     "main": "dist/scene.cjs.js",
     "module": "dist/scene.esm.js",
@@ -48,7 +48,7 @@
     "homepage": "https://daybrush.com/scenejs",
     "devDependencies": {
         "@daybrush/builder": "^0.1.0",
-        "@daybrush/jsdoc": "^0.3.7",
+        "@daybrush/jsdoc": "^0.3.10",
         "@daybrush/page": "^0.2.0",
         "@daybrush/release": "^0.2.4",
         "@types/karma-chai": "^0.1.1",

package.json

@@ -8,5 +8,5 @@ export * from "./easing";
 export * from "./presets";
 export * from "./types";
 export { OPTIONS, EVENTS, FIXED, ROLES, NAME_SEPARATOR } from "./consts";
-export { setRole, setAlias } from "./utils";
+export { setRole, setAlias, isRole } from "./utils";
 export { Scene as default };

src/index.ts

@@ -98,7 +98,7 @@ export function getValueByNames(
     }
     return value;
 }
-export function isInProperties(roles: IObject<any>, args: NameType[], isCheckTrue?: boolean) {
+export function isInProperties(roles: IObject<any>, args: NameType[], isLast?: boolean) {
     const length = args.length;
     let role: any = roles;
 
@@ -110,14 +110,19 @@ export function isInProperties(roles: IObject<any>, args: NameType[], isCheckTru
             return false;
         }
         role = role[args[i]];
-        if (!role || (!isCheckTrue && role === true)) {
+        if (!role || (!isLast && role === true)) {
             return false;
         }
     }
     return true;
 }
-export function isRole(args: NameType[], isCheckTrue?: boolean) {
-    return isInProperties(ROLES, args, isCheckTrue);
+/**
+ * @memberof Scene
+ * @param - Property names
+ * @param - Whether the property is the last property that cannot be an object (non-partitionable)
+ */
+export function isRole(args: NameType[], isLast?: boolean): boolean {
+    return isInProperties(ROLES, args, isLast);
 }
 export function isFixed(args: NameType[]) {
     return isInProperties(FIXED, args, true);