rattail 1.3.1 → 1.4.0

package/lib/index.cjs

@@ -76,6 +76,7 @@ __export(src_exports, {
   duration: () => duration,
   ensurePrefix: () => ensurePrefix,
   ensureSuffix: () => ensureSuffix,
+  enumOf: () => enumOf,
   find: () => find,
   floor: () => floor,
   genNumberKey: () => genNumberKey,
@@ -862,6 +863,7 @@ __export(util_exports, {
   doubleRaf: () => doubleRaf,
   download: () => download,
   duration: () => duration,
+  enumOf: () => enumOf,
   getAllParentScroller: () => getAllParentScroller,
   getParentScroller: () => getParentScroller,
   getRect: () => getRect,
@@ -1171,6 +1173,157 @@ function download(val, filename = "file") {
   document.body.removeChild(a);
 }
 
+// src/function/call.ts
+function call(fn, ...args) {
+  if (isArray(fn)) {
+    return fn.map((f) => f(...args));
+  }
+  if (fn) {
+    return fn(...args);
+  }
+}
+
+// src/function/once.ts
+function once(fn) {
+  let called = false;
+  let result;
+  return function(...args) {
+    if (called) {
+      return result;
+    }
+    called = true;
+    result = fn.apply(this, args);
+    return result;
+  };
+}
+
+// src/function/debounce.ts
+function debounce(fn, delay2 = 0) {
+  let timer;
+  return function(...args) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      fn.apply(this, args);
+    }, delay2);
+  };
+}
+
+// src/function/throttle.ts
+function throttle(fn, delay2 = 200) {
+  let timer;
+  let start = 0;
+  return function loop(...args) {
+    const now = performance.now();
+    const elapsed = now - start;
+    if (!start) {
+      start = now;
+    }
+    if (timer) {
+      clearTimeout(timer);
+    }
+    if (elapsed >= delay2) {
+      fn.apply(this, args);
+      start = now;
+    } else {
+      timer = setTimeout(() => {
+        loop.apply(this, args);
+      }, delay2 - elapsed);
+    }
+  };
+}
+
+// src/function/NOOP.ts
+function NOOP() {
+}
+
+// src/function/callOrReturn.ts
+function callOrReturn(fnOrValue, ...args) {
+  if (isFunction(fnOrValue)) {
+    return fnOrValue(...args);
+  }
+  return fnOrValue;
+}
+
+// src/util/enumOf.ts
+function enumOf(config) {
+  const extractValues = Object.entries(config).reduce((result, [key3, value]) => {
+    result[key3] = isPlainObject(value) ? value.value : value;
+    return result;
+  }, {});
+  const configValues = Object.values(config);
+  function label(v) {
+    const valueObject = getValueObject(v);
+    return (valueObject == null ? void 0 : valueObject.label) ? callOrReturn(valueObject.label) : "";
+  }
+  function description(v) {
+    const valueObject = getValueObject(v);
+    return (valueObject == null ? void 0 : valueObject.description) ? callOrReturn(valueObject.description) : "";
+  }
+  function values() {
+    return configValues.map((option2) => isPlainObject(option2) ? option2.value : option2);
+  }
+  function labels() {
+    return configValues.map((option2) => {
+      if (isPlainObject(option2)) {
+        return option2.label ? callOrReturn(option2.label) : "";
+      }
+      return "";
+    });
+  }
+  function descriptions() {
+    return configValues.map((option2) => {
+      if (isPlainObject(option2)) {
+        return option2.description ? callOrReturn(option2.description) : "";
+      }
+      return "";
+    });
+  }
+  function resolveOption(option2) {
+    const result = {};
+    for (const key3 of Object.keys(option2)) {
+      result[key3] = callOrReturn(option2[key3]);
+    }
+    return result;
+  }
+  function option(v) {
+    const valueObject = getValueObject(v);
+    if (valueObject) {
+      return resolveOption(valueObject);
+    }
+    return {
+      value: v,
+      label: "",
+      description: ""
+    };
+  }
+  function options() {
+    return configValues.map((option2) => {
+      if (isPlainObject(option2)) {
+        return resolveOption(option2);
+      }
+      return {
+        value: option2,
+        label: "",
+        description: ""
+      };
+    });
+  }
+  function getValueObject(v) {
+    return configValues.find((option2) => isPlainObject(option2) && option2.value === v);
+  }
+  return __spreadProps(__spreadValues({}, extractValues), {
+    values,
+    label,
+    description,
+    labels,
+    descriptions,
+    option,
+    options
+  });
+}
+
 // src/util/motion.ts
 function motion(options) {
   const {
@@ -1347,79 +1500,6 @@ var import_mitt = __toESM(require("mitt"), 1);
 // src/index.ts
 __reExport(src_exports, util_exports, module.exports);
 
-// src/function/call.ts
-function call(fn, ...args) {
-  if (isArray(fn)) {
-    return fn.map((f) => f(...args));
-  }
-  if (fn) {
-    return fn(...args);
-  }
-}
-
-// src/function/once.ts
-function once(fn) {
-  let called = false;
-  let result;
-  return function(...args) {
-    if (called) {
-      return result;
-    }
-    called = true;
-    result = fn.apply(this, args);
-    return result;
-  };
-}
-
-// src/function/debounce.ts
-function debounce(fn, delay2 = 0) {
-  let timer;
-  return function(...args) {
-    if (timer) {
-      clearTimeout(timer);
-    }
-    timer = setTimeout(() => {
-      fn.apply(this, args);
-    }, delay2);
-  };
-}
-
-// src/function/throttle.ts
-function throttle(fn, delay2 = 200) {
-  let timer;
-  let start = 0;
-  return function loop(...args) {
-    const now = performance.now();
-    const elapsed = now - start;
-    if (!start) {
-      start = now;
-    }
-    if (timer) {
-      clearTimeout(timer);
-    }
-    if (elapsed >= delay2) {
-      fn.apply(this, args);
-      start = now;
-    } else {
-      timer = setTimeout(() => {
-        loop.apply(this, args);
-      }, delay2 - elapsed);
-    }
-  };
-}
-
-// src/function/NOOP.ts
-function NOOP() {
-}
-
-// src/function/callOrReturn.ts
-function callOrReturn(fnOrValue, ...args) {
-  if (isFunction(fnOrValue)) {
-    return fnOrValue(...args);
-  }
-  return fnOrValue;
-}
-
 // src/collection/cloneDeepWith.ts
 function cloneDeepWith(value, fn) {
   const cache = /* @__PURE__ */ new WeakMap();
@@ -1712,6 +1792,7 @@ function ceil(val, precision = 0) {
   duration,
   ensurePrefix,
   ensureSuffix,
+  enumOf,
   find,
   floor,
   genNumberKey,

package/lib/index.d.cts

@@ -120,6 +120,51 @@ declare function tryParseJSON<T>(json: string): T | undefined;
 
 declare function download(val: string | Blob | File, filename?: string): void;
 
+type ValueOf<T> = T[keyof T];
+type EnumOfValue = string | number | boolean;
+type EnumOfStringOrGetter = string | (() => string);
+type EnumOfValueObject = {
+    value: EnumOfValue;
+    label?: EnumOfStringOrGetter;
+    description?: EnumOfStringOrGetter;
+};
+type EnumOfConfigValue = EnumOfValue | (EnumOfValueObject & Record<string, unknown>);
+type EnumOfNormalizeToOption<V> = V extends {
+    value: unknown;
+} ? V : {
+    value: V;
+    label?: EnumOfStringOrGetter;
+    description?: EnumOfStringOrGetter;
+};
+type EnumOfResolvedField<V> = V extends (...args: any[]) => infer R ? R : V;
+type EnumOfResolvedOption<O> = O extends unknown ? {
+    [K in keyof O]: EnumOfResolvedField<O[K]>;
+} : never;
+type EnumOfExtractOptionShape<T extends Record<string, EnumOfConfigValue>> = EnumOfResolvedOption<EnumOfNormalizeToOption<ValueOf<T>>>;
+type EnumOfExtractValues<T extends object> = {
+    [P in keyof T]: T[P] extends {
+        value: infer V;
+    } ? V : T[P];
+};
+type EnumOfKeyForValue<T extends object, V> = {
+    [K in keyof T]: EnumOfExtractValues<T>[K] extends V ? (V extends EnumOfExtractValues<T>[K] ? K : never) : never;
+}[keyof T];
+type EnumOfOptionForValue<T extends Record<string, EnumOfConfigValue>, Value> = Value extends infer V ? EnumOfKeyForValue<T, V> extends keyof T ? EnumOfResolvedOption<EnumOfNormalizeToOption<T[EnumOfKeyForValue<T, V>]>> : EnumOfExtractOptionShape<T> : never;
+type EnumOfResultMethods<V, T extends Record<string, EnumOfConfigValue>> = {
+    values(): V[];
+    label(v: V): string;
+    labels(): string[];
+    description(v: V): string;
+    descriptions(): string[];
+    option<Value extends V>(v: Value): EnumOfOptionForValue<T, Value>;
+    options(): EnumOfExtractOptionShape<T>[];
+};
+type EnumOfResult<T extends Record<string, EnumOfConfigValue>> = EnumOfExtractValues<T> & EnumOfResultMethods<ValueOf<EnumOfExtractValues<T>>, T>;
+declare function enumOf<const T extends Record<string, EnumOfConfigValue>>(config: T): EnumOfResult<T>;
+type EnumOf<T extends {
+    values: () => any[];
+}> = ReturnType<T['values']>[number];
+
 interface MotionOptions {
     from: number;
     to: number;
@@ -339,4 +384,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type CreateCacheManagerOptions, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createCacheManager, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type CreateCacheManagerOptions, type DurationContext, type EnumOf, type EnumOfConfigValue, type EnumOfExtractOptionShape, type EnumOfExtractValues, type EnumOfKeyForValue, type EnumOfNormalizeToOption, type EnumOfOptionForValue, type EnumOfResolvedField, type EnumOfResolvedOption, type EnumOfResult, type EnumOfResultMethods, type EnumOfStringOrGetter, type EnumOfValue, type EnumOfValueObject, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createCacheManager, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, enumOf, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.d.ts

@@ -120,6 +120,51 @@ declare function tryParseJSON<T>(json: string): T | undefined;
 
 declare function download(val: string | Blob | File, filename?: string): void;
 
+type ValueOf<T> = T[keyof T];
+type EnumOfValue = string | number | boolean;
+type EnumOfStringOrGetter = string | (() => string);
+type EnumOfValueObject = {
+    value: EnumOfValue;
+    label?: EnumOfStringOrGetter;
+    description?: EnumOfStringOrGetter;
+};
+type EnumOfConfigValue = EnumOfValue | (EnumOfValueObject & Record<string, unknown>);
+type EnumOfNormalizeToOption<V> = V extends {
+    value: unknown;
+} ? V : {
+    value: V;
+    label?: EnumOfStringOrGetter;
+    description?: EnumOfStringOrGetter;
+};
+type EnumOfResolvedField<V> = V extends (...args: any[]) => infer R ? R : V;
+type EnumOfResolvedOption<O> = O extends unknown ? {
+    [K in keyof O]: EnumOfResolvedField<O[K]>;
+} : never;
+type EnumOfExtractOptionShape<T extends Record<string, EnumOfConfigValue>> = EnumOfResolvedOption<EnumOfNormalizeToOption<ValueOf<T>>>;
+type EnumOfExtractValues<T extends object> = {
+    [P in keyof T]: T[P] extends {
+        value: infer V;
+    } ? V : T[P];
+};
+type EnumOfKeyForValue<T extends object, V> = {
+    [K in keyof T]: EnumOfExtractValues<T>[K] extends V ? (V extends EnumOfExtractValues<T>[K] ? K : never) : never;
+}[keyof T];
+type EnumOfOptionForValue<T extends Record<string, EnumOfConfigValue>, Value> = Value extends infer V ? EnumOfKeyForValue<T, V> extends keyof T ? EnumOfResolvedOption<EnumOfNormalizeToOption<T[EnumOfKeyForValue<T, V>]>> : EnumOfExtractOptionShape<T> : never;
+type EnumOfResultMethods<V, T extends Record<string, EnumOfConfigValue>> = {
+    values(): V[];
+    label(v: V): string;
+    labels(): string[];
+    description(v: V): string;
+    descriptions(): string[];
+    option<Value extends V>(v: Value): EnumOfOptionForValue<T, Value>;
+    options(): EnumOfExtractOptionShape<T>[];
+};
+type EnumOfResult<T extends Record<string, EnumOfConfigValue>> = EnumOfExtractValues<T> & EnumOfResultMethods<ValueOf<EnumOfExtractValues<T>>, T>;
+declare function enumOf<const T extends Record<string, EnumOfConfigValue>>(config: T): EnumOfResult<T>;
+type EnumOf<T extends {
+    values: () => any[];
+}> = ReturnType<T['values']>[number];
+
 interface MotionOptions {
     from: number;
     to: number;
@@ -339,4 +384,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type CreateCacheManagerOptions, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createCacheManager, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type CreateCacheManagerOptions, type DurationContext, type EnumOf, type EnumOfConfigValue, type EnumOfExtractOptionShape, type EnumOfExtractValues, type EnumOfKeyForValue, type EnumOfNormalizeToOption, type EnumOfOptionForValue, type EnumOfResolvedField, type EnumOfResolvedOption, type EnumOfResult, type EnumOfResultMethods, type EnumOfStringOrGetter, type EnumOfValue, type EnumOfValueObject, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createCacheManager, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, enumOf, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.global.js

@@ -66,6 +66,7 @@ var Rattail = (() => {
     duration: () => duration,
     ensurePrefix: () => ensurePrefix,
     ensureSuffix: () => ensureSuffix,
+    enumOf: () => enumOf,
     find: () => find,
     floor: () => floor,
     genNumberKey: () => genNumberKey,
@@ -1130,6 +1131,157 @@ var Rattail = (() => {
     document.body.removeChild(a);
   }
 
+  // src/function/call.ts
+  function call(fn, ...args) {
+    if (isArray(fn)) {
+      return fn.map((f) => f(...args));
+    }
+    if (fn) {
+      return fn(...args);
+    }
+  }
+
+  // src/function/once.ts
+  function once(fn) {
+    let called = false;
+    let result;
+    return function(...args) {
+      if (called) {
+        return result;
+      }
+      called = true;
+      result = fn.apply(this, args);
+      return result;
+    };
+  }
+
+  // src/function/debounce.ts
+  function debounce(fn, delay2 = 0) {
+    let timer;
+    return function(...args) {
+      if (timer) {
+        clearTimeout(timer);
+      }
+      timer = setTimeout(() => {
+        fn.apply(this, args);
+      }, delay2);
+    };
+  }
+
+  // src/function/throttle.ts
+  function throttle(fn, delay2 = 200) {
+    let timer;
+    let start = 0;
+    return function loop(...args) {
+      const now = performance.now();
+      const elapsed = now - start;
+      if (!start) {
+        start = now;
+      }
+      if (timer) {
+        clearTimeout(timer);
+      }
+      if (elapsed >= delay2) {
+        fn.apply(this, args);
+        start = now;
+      } else {
+        timer = setTimeout(() => {
+          loop.apply(this, args);
+        }, delay2 - elapsed);
+      }
+    };
+  }
+
+  // src/function/NOOP.ts
+  function NOOP() {
+  }
+
+  // src/function/callOrReturn.ts
+  function callOrReturn(fnOrValue, ...args) {
+    if (isFunction(fnOrValue)) {
+      return fnOrValue(...args);
+    }
+    return fnOrValue;
+  }
+
+  // src/util/enumOf.ts
+  function enumOf(config) {
+    const extractValues = Object.entries(config).reduce((result, [key3, value]) => {
+      result[key3] = isPlainObject(value) ? value.value : value;
+      return result;
+    }, {});
+    const configValues = Object.values(config);
+    function label(v) {
+      const valueObject = getValueObject(v);
+      return (valueObject == null ? void 0 : valueObject.label) ? callOrReturn(valueObject.label) : "";
+    }
+    function description(v) {
+      const valueObject = getValueObject(v);
+      return (valueObject == null ? void 0 : valueObject.description) ? callOrReturn(valueObject.description) : "";
+    }
+    function values() {
+      return configValues.map((option2) => isPlainObject(option2) ? option2.value : option2);
+    }
+    function labels() {
+      return configValues.map((option2) => {
+        if (isPlainObject(option2)) {
+          return option2.label ? callOrReturn(option2.label) : "";
+        }
+        return "";
+      });
+    }
+    function descriptions() {
+      return configValues.map((option2) => {
+        if (isPlainObject(option2)) {
+          return option2.description ? callOrReturn(option2.description) : "";
+        }
+        return "";
+      });
+    }
+    function resolveOption(option2) {
+      const result = {};
+      for (const key3 of Object.keys(option2)) {
+        result[key3] = callOrReturn(option2[key3]);
+      }
+      return result;
+    }
+    function option(v) {
+      const valueObject = getValueObject(v);
+      if (valueObject) {
+        return resolveOption(valueObject);
+      }
+      return {
+        value: v,
+        label: "",
+        description: ""
+      };
+    }
+    function options() {
+      return configValues.map((option2) => {
+        if (isPlainObject(option2)) {
+          return resolveOption(option2);
+        }
+        return {
+          value: option2,
+          label: "",
+          description: ""
+        };
+      });
+    }
+    function getValueObject(v) {
+      return configValues.find((option2) => isPlainObject(option2) && option2.value === v);
+    }
+    return __spreadProps(__spreadValues({}, extractValues), {
+      values,
+      label,
+      description,
+      labels,
+      descriptions,
+      option,
+      options
+    });
+  }
+
   // src/util/motion.ts
   function motion(options) {
     const {
@@ -1317,79 +1469,6 @@ var Rattail = (() => {
     } };
   }
 
-  // src/function/call.ts
-  function call(fn, ...args) {
-    if (isArray(fn)) {
-      return fn.map((f) => f(...args));
-    }
-    if (fn) {
-      return fn(...args);
-    }
-  }
-
-  // src/function/once.ts
-  function once(fn) {
-    let called = false;
-    let result;
-    return function(...args) {
-      if (called) {
-        return result;
-      }
-      called = true;
-      result = fn.apply(this, args);
-      return result;
-    };
-  }
-
-  // src/function/debounce.ts
-  function debounce(fn, delay2 = 0) {
-    let timer;
-    return function(...args) {
-      if (timer) {
-        clearTimeout(timer);
-      }
-      timer = setTimeout(() => {
-        fn.apply(this, args);
-      }, delay2);
-    };
-  }
-
-  // src/function/throttle.ts
-  function throttle(fn, delay2 = 200) {
-    let timer;
-    let start = 0;
-    return function loop(...args) {
-      const now = performance.now();
-      const elapsed = now - start;
-      if (!start) {
-        start = now;
-      }
-      if (timer) {
-        clearTimeout(timer);
-      }
-      if (elapsed >= delay2) {
-        fn.apply(this, args);
-        start = now;
-      } else {
-        timer = setTimeout(() => {
-          loop.apply(this, args);
-        }, delay2 - elapsed);
-      }
-    };
-  }
-
-  // src/function/NOOP.ts
-  function NOOP() {
-  }
-
-  // src/function/callOrReturn.ts
-  function callOrReturn(fnOrValue, ...args) {
-    if (isFunction(fnOrValue)) {
-      return fnOrValue(...args);
-    }
-    return fnOrValue;
-  }
-
   // src/collection/cloneDeepWith.ts
   function cloneDeepWith(value, fn) {
     const cache = /* @__PURE__ */ new WeakMap();

package/lib/index.js

@@ -64,6 +64,7 @@ __export(src_exports, {
   duration: () => duration,
   ensurePrefix: () => ensurePrefix,
   ensureSuffix: () => ensureSuffix,
+  enumOf: () => enumOf,
   find: () => find,
   floor: () => floor,
   genNumberKey: () => genNumberKey,
@@ -849,6 +850,7 @@ __export(util_exports, {
   doubleRaf: () => doubleRaf,
   download: () => download,
   duration: () => duration,
+  enumOf: () => enumOf,
   getAllParentScroller: () => getAllParentScroller,
   getParentScroller: () => getParentScroller,
   getRect: () => getRect,
@@ -1158,6 +1160,157 @@ function download(val, filename = "file") {
   document.body.removeChild(a);
 }
 
+// src/function/call.ts
+function call(fn, ...args) {
+  if (isArray(fn)) {
+    return fn.map((f) => f(...args));
+  }
+  if (fn) {
+    return fn(...args);
+  }
+}
+
+// src/function/once.ts
+function once(fn) {
+  let called = false;
+  let result;
+  return function(...args) {
+    if (called) {
+      return result;
+    }
+    called = true;
+    result = fn.apply(this, args);
+    return result;
+  };
+}
+
+// src/function/debounce.ts
+function debounce(fn, delay2 = 0) {
+  let timer;
+  return function(...args) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      fn.apply(this, args);
+    }, delay2);
+  };
+}
+
+// src/function/throttle.ts
+function throttle(fn, delay2 = 200) {
+  let timer;
+  let start = 0;
+  return function loop(...args) {
+    const now = performance.now();
+    const elapsed = now - start;
+    if (!start) {
+      start = now;
+    }
+    if (timer) {
+      clearTimeout(timer);
+    }
+    if (elapsed >= delay2) {
+      fn.apply(this, args);
+      start = now;
+    } else {
+      timer = setTimeout(() => {
+        loop.apply(this, args);
+      }, delay2 - elapsed);
+    }
+  };
+}
+
+// src/function/NOOP.ts
+function NOOP() {
+}
+
+// src/function/callOrReturn.ts
+function callOrReturn(fnOrValue, ...args) {
+  if (isFunction(fnOrValue)) {
+    return fnOrValue(...args);
+  }
+  return fnOrValue;
+}
+
+// src/util/enumOf.ts
+function enumOf(config) {
+  const extractValues = Object.entries(config).reduce((result, [key3, value]) => {
+    result[key3] = isPlainObject(value) ? value.value : value;
+    return result;
+  }, {});
+  const configValues = Object.values(config);
+  function label(v) {
+    const valueObject = getValueObject(v);
+    return (valueObject == null ? void 0 : valueObject.label) ? callOrReturn(valueObject.label) : "";
+  }
+  function description(v) {
+    const valueObject = getValueObject(v);
+    return (valueObject == null ? void 0 : valueObject.description) ? callOrReturn(valueObject.description) : "";
+  }
+  function values() {
+    return configValues.map((option2) => isPlainObject(option2) ? option2.value : option2);
+  }
+  function labels() {
+    return configValues.map((option2) => {
+      if (isPlainObject(option2)) {
+        return option2.label ? callOrReturn(option2.label) : "";
+      }
+      return "";
+    });
+  }
+  function descriptions() {
+    return configValues.map((option2) => {
+      if (isPlainObject(option2)) {
+        return option2.description ? callOrReturn(option2.description) : "";
+      }
+      return "";
+    });
+  }
+  function resolveOption(option2) {
+    const result = {};
+    for (const key3 of Object.keys(option2)) {
+      result[key3] = callOrReturn(option2[key3]);
+    }
+    return result;
+  }
+  function option(v) {
+    const valueObject = getValueObject(v);
+    if (valueObject) {
+      return resolveOption(valueObject);
+    }
+    return {
+      value: v,
+      label: "",
+      description: ""
+    };
+  }
+  function options() {
+    return configValues.map((option2) => {
+      if (isPlainObject(option2)) {
+        return resolveOption(option2);
+      }
+      return {
+        value: option2,
+        label: "",
+        description: ""
+      };
+    });
+  }
+  function getValueObject(v) {
+    return configValues.find((option2) => isPlainObject(option2) && option2.value === v);
+  }
+  return __spreadProps(__spreadValues({}, extractValues), {
+    values,
+    label,
+    description,
+    labels,
+    descriptions,
+    option,
+    options
+  });
+}
+
 // src/util/motion.ts
 function motion(options) {
   const {
@@ -1335,79 +1488,6 @@ import { default as default2 } from "mitt";
 // src/index.ts
 __reExport(src_exports, util_exports);
 
-// src/function/call.ts
-function call(fn, ...args) {
-  if (isArray(fn)) {
-    return fn.map((f) => f(...args));
-  }
-  if (fn) {
-    return fn(...args);
-  }
-}
-
-// src/function/once.ts
-function once(fn) {
-  let called = false;
-  let result;
-  return function(...args) {
-    if (called) {
-      return result;
-    }
-    called = true;
-    result = fn.apply(this, args);
-    return result;
-  };
-}
-
-// src/function/debounce.ts
-function debounce(fn, delay2 = 0) {
-  let timer;
-  return function(...args) {
-    if (timer) {
-      clearTimeout(timer);
-    }
-    timer = setTimeout(() => {
-      fn.apply(this, args);
-    }, delay2);
-  };
-}
-
-// src/function/throttle.ts
-function throttle(fn, delay2 = 200) {
-  let timer;
-  let start = 0;
-  return function loop(...args) {
-    const now = performance.now();
-    const elapsed = now - start;
-    if (!start) {
-      start = now;
-    }
-    if (timer) {
-      clearTimeout(timer);
-    }
-    if (elapsed >= delay2) {
-      fn.apply(this, args);
-      start = now;
-    } else {
-      timer = setTimeout(() => {
-        loop.apply(this, args);
-      }, delay2 - elapsed);
-    }
-  };
-}
-
-// src/function/NOOP.ts
-function NOOP() {
-}
-
-// src/function/callOrReturn.ts
-function callOrReturn(fnOrValue, ...args) {
-  if (isFunction(fnOrValue)) {
-    return fnOrValue(...args);
-  }
-  return fnOrValue;
-}
-
 // src/collection/cloneDeepWith.ts
 function cloneDeepWith(value, fn) {
   const cache = /* @__PURE__ */ new WeakMap();
@@ -1699,6 +1779,7 @@ export {
   duration,
   ensurePrefix,
   ensureSuffix,
+  enumOf,
   find,
   floor,
   genNumberKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rattail",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "A utilities library for front-end developers, lightweight and ts-friendly",
   "keywords": [
     "utilities library",