create-enum-es 2.0.1 → 3.0.0

package/README.md

@@ -1,70 +1,333 @@
+# create-enum-es
+
+> 零依赖、类型安全的前端枚举工具，为 TypeScript 项目提供完整的枚举管理方案。
+
+## 安装
+
+```bash
+npm install create-enum-es
+```
+
+## 快速开始
+
 ```ts
 import createEnum from "create-enum-es";
 
-const base = createEnum({
-  AA: [11, "AA-"],
-  BB: [22, "BB-"],
+const Status = createEnum({
+  ACTIVE:   [1, "激活", { color: "green" }],
+  INACTIVE: [0, "未激活", { color: "gray" }],
+  PENDING:  [2, "待审核", { color: "orange" }],
 } as const);
 
-console.log("base.AA :>> ", base.AA);
-// 11
+Status.ACTIVE;          // 1（直接属性访问）
+Status.label("ACTIVE"); // '激活'
+Status.label(1);        // '激活'（通过 value 查 label）
+Status.extra("ACTIVE"); // { color: 'green' }
+```
+
+> **重要：** 定义时需要在对象末尾加上 `as const` 以获得完整的类型推导。
+
+## API
+
+### `createEnum(enumMap)`
+
+创建一个冻结的枚举实例。参数格式：
+
+```ts
+{
+  KEY: [value, label, extra?] // extra 可选
+} as const
+```
+
+---
+
+### 属性访问
+
+```ts
+Status.ACTIVE   // 1
+Status.INACTIVE // 0
+```
+
+直接通过 Key 获取 Value，享受完整的类型提示。
+
+---
+
+### `value(key)`
+
+通过 Key 获取 Value。
+
+```ts
+Status.value("ACTIVE"); // 1
+```
+
+---
+
+### `values(...keys?)`
+
+获取多个枚举值。不传参返回所有值。
+
+```ts
+Status.values();                   // [1, 0, 2]
+Status.values("ACTIVE", "PENDING"); // [1, 2]
+```
+
+---
+
+### `keys()`
+
+获取所有枚举 Key。
+
+```ts
+Status.keys(); // ['ACTIVE', 'INACTIVE', 'PENDING']
+```
+
+---
+
+### `label(keyOrValue)`
+
+通过 Key 或 Value 获取 Label，支持双向查找。
+
+```ts
+Status.label("ACTIVE"); // '激活'
+Status.label(1);        // '激活'
+```
+
+---
+
+### `extra(keyOrValue)`
+
+通过 Key 或 Value 获取附加数据。
+
+```ts
+Status.extra("ACTIVE"); // { color: 'green' }
+Status.extra(1);        // { color: 'green' }
+```
+
+---
+
+### `keyOf(value)`
+
+通过 Value 反查 Key。
+
+```ts
+Status.keyOf(1); // 'ACTIVE'
+Status.keyOf(0); // 'INACTIVE'
+```
+
+---
+
+### `check(val, key)`
+
+检测一个值是否等于指定 Key 对应的枚举值。
+
+```ts
+Status.check(1, "ACTIVE");   // true
+Status.check(1, "INACTIVE"); // false
+```
+
+---
+
+### `has(val)`
+
+判断一个值是否属于该枚举（类型守卫）。
+
+```ts
+Status.has(1);  // true
+Status.has(99); // false
+
+// 类型守卫：
+const val: unknown = 1;
+if (Status.has(val)) {
+  // val 在此分支中被收窄为 TEValue<typeof Status>
+}
+```
+
+---
+
+### `size`
+
+获取枚举项数量。
 
-console.log("base.BB :>> ", base.BB);
-// 22
+```ts
+Status.size; // 3
+```
+
+---
+
+### `options(...keys?)`
+
+获取枚举选项列表，适配 Select/Radio/Checkbox 等 UI 组件。不传参返回所有。
 
-console.log("base.options() :>> ", base.options());
+```ts
+Status.options();
 // [
-//   {
-//     "value": 11,
-//     "label": "AA-"
-//   },
-//   {
-//     "value": 22,
-//     "label": "BB-"
-//   }
+//   { value: 1, label: '激活', extra: { color: 'green' } },
+//   { value: 0, label: '未激活', extra: { color: 'gray' } },
+//   { value: 2, label: '待审核', extra: { color: 'orange' } },
 // ]
 
-const enumInstance = createEnum({
-  A: [1, "A-", { a: "axx" }],
-  B: [2, "B-", { b: "bxx" }],
-} as const);
+Status.options("ACTIVE", "PENDING");
+// 只返回指定项
+```
+
+---
+
+### `pick(...keys)`
+
+选取指定 Key，生成新的枚举实例。
+
+```ts
+const ActiveOnly = Status.pick("ACTIVE", "PENDING");
+ActiveOnly.ACTIVE;  // 1
+ActiveOnly.PENDING; // 2
+// ActiveOnly.INACTIVE  ← 类型错误，不存在
+```
+
+---
+
+### `omit(...keys)`
+
+排除指定 Key，生成新的枚举实例。
+
+```ts
+const WithoutPending = Status.omit("PENDING");
+WithoutPending.ACTIVE;   // 1
+WithoutPending.INACTIVE; // 0
+// WithoutPending.PENDING  ← 类型错误，不存在
+```
+
+---
 
-const value = enumInstance.value("A");
-console.log("value :>> ", value);
-// 1
+### `filter(predicate)`
 
-const values = enumInstance.values();
-console.log("values :>> ", values);
-// [1, 2]
+按条件过滤枚举项，返回满足条件的 options 数组。
 
-const options = enumInstance.options();
-console.log("options :>> ", options);
+```ts
+// 过滤掉 INACTIVE
+Status.filter((value) => value !== 0);
 // [
-//   {
-//     "value": 1,
-//     "label": "A-",
-//     "extra": {
-//       "a": "axx"
-//     }
-//   },
-//   {
-//     "value": 2,
-//     "label": "B-",
-//     "extra": {
-//       "b": "bxx"
-//     }
-//   }
+//   { value: 1, label: '激活', extra: { color: 'green' } },
+//   { value: 2, label: '待审核', extra: { color: 'orange' } },
 // ]
 
-const label = enumInstance.label("A");
-console.log("label :>> ", label);
-// 'A-'
+// 根据 extra 过滤
+Status.filter((_v, _l, _k, extra) => extra?.color === "green");
+```
+
+回调参数：`(value, label, key, extra) => boolean`
+
+---
+
+### `forEach(callback)`
+
+遍历所有枚举项。
+
+```ts
+Status.forEach((value, label, key, extra) => {
+  console.log(`${key}: ${value} - ${label}`, extra);
+});
+```
+
+---
+
+### `for...of` 迭代
+
+枚举实例实现了 `Symbol.iterator`，支持 `for...of` 和展开运算符。
+
+```ts
+for (const { key, value, label, extra } of Status) {
+  console.log(key, value, label, extra);
+}
+
+const items = [...Status]; // 展开为数组
+```
+
+---
+
+### `toMap()`
+
+转为 `Map<value, label>`。
+
+```ts
+Status.toMap();
+// Map { 1 => '激活', 0 => '未激活', 2 => '待审核' }
+```
+
+---
+
+### `toRecord()`
+
+转为 `{ [value]: label }` 对象。
+
+```ts
+Status.toRecord();
+// { 1: '激活', 0: '未激活', 2: '待审核' }
+```
+
+---
+
+## TypeScript 类型支持
+
+所有 API 均提供完整的类型推导：
+
+```ts
+const Status = createEnum({
+  ACTIVE:   [1, "激活", { color: "green" }],
+  INACTIVE: [0, "未激活", { color: "gray" }],
+} as const);
+
+Status.ACTIVE;          // 类型为 1（字面量）
+Status.value("ACTIVE"); // 类型为 number
+Status.label("ACTIVE"); // 类型为 string
+Status.extra("ACTIVE"); // 类型为 { readonly color: "green" }
+
+// pick/omit 返回类型正确收窄
+const picked = Status.pick("ACTIVE");
+picked.ACTIVE;   // ✅
+picked.INACTIVE; // ❌ 类型错误
+```
+
+## 典型场景
+
+### 配合 Select 组件
+
+```tsx
+const Status = createEnum({ ... } as const);
+
+// React / Vue
+<Select options={Status.options()} />
+
+// 只展示部分选项
+<Select options={Status.options("ACTIVE", "PENDING")} />
 
-const extra = enumInstance.extra("A");
-console.log("extra :>> ", extra);
-// {"a": "axx"}
+// 动态过滤
+<Select options={Status.filter((v) => v !== 0)} />
+```
+
+### 表格列渲染
 
-const check = enumInstance.check(1, "A");
-console.log("check :>> ", check);
-// true
+```tsx
+const columns = [
+  {
+    title: "状态",
+    render: (val) => Status.label(val),
+  },
+];
 ```
+
+### 条件判断
+
+```ts
+if (Status.check(row.status, "ACTIVE")) {
+  // ...
+}
+
+// 或者
+if (row.status === Status.ACTIVE) {
+  // ...
+}
+```
+
+## License
+
+ISC

package/dist/create-enum.cjs.js

@@ -1 +1 @@
-"use strict";function t(t,e){return t===e||t!=t&&e!=e}function e(e,r){for(var n=e.length;n--;)if(t(e[n][0],r))return n;return-1}var r=Array.prototype.splice;function n(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}n.prototype.clear=function(){this.__data__=[],this.size=0},n.prototype.delete=function(t){var n=this.__data__,o=e(n,t);return!(o<0)&&(o==n.length-1?n.pop():r.call(n,o,1),--this.size,!0)},n.prototype.get=function(t){var r=this.__data__,n=e(r,t);return n<0?void 0:r[n][1]},n.prototype.has=function(t){return e(this.__data__,t)>-1},n.prototype.set=function(t,r){var n=this.__data__,o=e(n,t);return o<0?(++this.size,n.push([t,r])):n[o][1]=r,this};var o="object"==typeof global&&global&&global.Object===Object&&global,a="object"==typeof self&&self&&self.Object===Object&&self,c=o||a||Function("return this")(),u=c.Symbol,i=Object.prototype,s=i.hasOwnProperty,p=i.toString,f=u?u.toStringTag:void 0;var l=Object.prototype.toString;var b=u?u.toStringTag:void 0;function y(t){return null==t?void 0===t?"[object Undefined]":"[object Null]":b&&b in Object(t)?function(t){var e=s.call(t,f),r=t[f];try{t[f]=void 0;var n=!0}catch(t){}var o=p.call(t);return n&&(e?t[f]=r:delete t[f]),o}(t):function(t){return l.call(t)}(t)}function _(t){var e=typeof t;return null!=t&&("object"==e||"function"==e)}function j(t){if(!_(t))return!1;var e=y(t);return"[object Function]"==e||"[object GeneratorFunction]"==e||"[object AsyncFunction]"==e||"[object Proxy]"==e}var h,v=c["__core-js_shared__"],d=(h=/[^.]+$/.exec(v&&v.keys&&v.keys.IE_PROTO||""))?"Symbol(src)_1."+h:"";var g=Function.prototype.toString;function O(t){if(null!=t){try{return g.call(t)}catch(t){}try{return t+""}catch(t){}}return""}var m=/^\[object .+?Constructor\]$/,w=Function.prototype,A=Object.prototype,x=w.toString,z=A.hasOwnProperty,M=RegExp("^"+x.call(z).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");function S(t){return!(!_(t)||(e=t,d&&d in e))&&(j(t)?M:m).test(O(t));var e}function E(t,e){var r=function(t,e){return null==t?void 0:t[e]}(t,e);return S(r)?r:void 0}var P=E(c,"Map"),F=E(Object,"create");var U=Object.prototype.hasOwnProperty;var I=Object.prototype.hasOwnProperty;function T(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}function k(t,e){var r,n,o=t.__data__;return("string"==(n=typeof(r=e))||"number"==n||"symbol"==n||"boolean"==n?"__proto__"!==r:null===r)?o["string"==typeof e?"string":"hash"]:o.map}function B(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}T.prototype.clear=function(){this.__data__=F?F(null):{},this.size=0},T.prototype.delete=function(t){var e=this.has(t)&&delete this.__data__[t];return this.size-=e?1:0,e},T.prototype.get=function(t){var e=this.__data__;if(F){var r=e[t];return"__lodash_hash_undefined__"===r?void 0:r}return U.call(e,t)?e[t]:void 0},T.prototype.has=function(t){var e=this.__data__;return F?void 0!==e[t]:I.call(e,t)},T.prototype.set=function(t,e){var r=this.__data__;return this.size+=this.has(t)?0:1,r[t]=F&&void 0===e?"__lodash_hash_undefined__":e,this},B.prototype.clear=function(){this.size=0,this.__data__={hash:new T,map:new(P||n),string:new T}},B.prototype.delete=function(t){var e=k(this,t).delete(t);return this.size-=e?1:0,e},B.prototype.get=function(t){return k(this,t).get(t)},B.prototype.has=function(t){return k(this,t).has(t)},B.prototype.set=function(t,e){var r=k(this,t),n=r.size;return r.set(t,e),this.size+=r.size==n?0:1,this};function D(t){var e=this.__data__=new n(t);this.size=e.size}D.prototype.clear=function(){this.__data__=new n,this.size=0},D.prototype.delete=function(t){var e=this.__data__,r=e.delete(t);return this.size=e.size,r},D.prototype.get=function(t){return this.__data__.get(t)},D.prototype.has=function(t){return this.__data__.has(t)},D.prototype.set=function(t,e){var r=this.__data__;if(r instanceof n){var o=r.__data__;if(!P||o.length<199)return o.push([t,e]),this.size=++r.size,this;r=this.__data__=new B(o)}return r.set(t,e),this.size=r.size,this};var $=function(){try{var t=E(Object,"defineProperty");return t({},"",{}),t}catch(t){}}();var L=Object.prototype.hasOwnProperty;function R(e,r,n){var o=e[r];L.call(e,r)&&t(o,n)&&(void 0!==n||r in e)||function(t,e,r){"__proto__"==e&&$?$(t,e,{configurable:!0,enumerable:!0,value:r,writable:!0}):t[e]=r}(e,r,n)}function V(t){return null!=t&&"object"==typeof t}function C(t){return V(t)&&"[object Arguments]"==y(t)}var N=Object.prototype,W=N.hasOwnProperty,q=N.propertyIsEnumerable,G=C(function(){return arguments}())?C:function(t){return V(t)&&W.call(t,"callee")&&!q.call(t,"callee")},H=Array.isArray;var J="object"==typeof exports&&exports&&!exports.nodeType&&exports,K=J&&"object"==typeof module&&module&&!module.nodeType&&module,Q=K&&K.exports===J?c.Buffer:void 0,X=(Q?Q.isBuffer:void 0)||function(){return!1},Y=/^(?:0|[1-9]\d*)$/;function Z(t,e){var r=typeof t;return!!(e=null==e?9007199254740991:e)&&("number"==r||"symbol"!=r&&Y.test(t))&&t>-1&&t%1==0&&t<e}function tt(t){return"number"==typeof t&&t>-1&&t%1==0&&t<=9007199254740991}var et={};function rt(t){return function(e){return t(e)}}et["[object Float32Array]"]=et["[object Float64Array]"]=et["[object Int8Array]"]=et["[object Int16Array]"]=et["[object Int32Array]"]=et["[object Uint8Array]"]=et["[object Uint8ClampedArray]"]=et["[object Uint16Array]"]=et["[object Uint32Array]"]=!0,et["[object Arguments]"]=et["[object Array]"]=et["[object ArrayBuffer]"]=et["[object Boolean]"]=et["[object DataView]"]=et["[object Date]"]=et["[object Error]"]=et["[object Function]"]=et["[object Map]"]=et["[object Number]"]=et["[object Object]"]=et["[object RegExp]"]=et["[object Set]"]=et["[object String]"]=et["[object WeakMap]"]=!1;var nt="object"==typeof exports&&exports&&!exports.nodeType&&exports,ot=nt&&"object"==typeof module&&module&&!module.nodeType&&module,at=ot&&ot.exports===nt&&o.process,ct=function(){try{var t=ot&&ot.require&&ot.require("util").types;return t||at&&at.binding&&at.binding("util")}catch(t){}}(),ut=ct&&ct.isTypedArray,it=ut?rt(ut):function(t){return V(t)&&tt(t.length)&&!!et[y(t)]},st=Object.prototype.hasOwnProperty;function pt(t,e){var r=H(t),n=!r&&G(t),o=!r&&!n&&X(t),a=!r&&!n&&!o&&it(t),c=r||n||o||a,u=c?function(t,e){for(var r=-1,n=Array(t);++r<t;)n[r]=e(r);return n}(t.length,String):[],i=u.length;for(var s in t)!st.call(t,s)||c&&("length"==s||o&&("offset"==s||"parent"==s)||a&&("buffer"==s||"byteLength"==s||"byteOffset"==s)||Z(s,i))||u.push(s);return u}var ft=Object.prototype;function lt(t){var e=t&&t.constructor;return t===("function"==typeof e&&e.prototype||ft)}function bt(t,e){return function(r){return t(e(r))}}var yt=bt(Object.keys,Object),_t=Object.prototype.hasOwnProperty;function jt(t){if(!lt(t))return yt(t);var e=[];for(var r in Object(t))_t.call(t,r)&&"constructor"!=r&&e.push(r);return e}function ht(t){return null!=t&&tt(t.length)&&!j(t)}function vt(t){return ht(t)?pt(t):jt(t)}var dt="object"==typeof exports&&exports&&!exports.nodeType&&exports,gt=dt&&"object"==typeof module&&module&&!module.nodeType&&module,Ot=gt&&gt.exports===dt?c.Buffer:void 0;Ot&&Ot.allocUnsafe;var mt=Object.prototype.propertyIsEnumerable,wt=Object.getOwnPropertySymbols,At=wt?function(t){return null==t?[]:(t=Object(t),function(t,e){for(var r=-1,n=null==t?0:t.length,o=0,a=[];++r<n;){var c=t[r];e(c,r,t)&&(a[o++]=c)}return a}(wt(t),function(e){return mt.call(t,e)}))}:function(){return[]};var xt=bt(Object.getPrototypeOf,Object);function zt(t){return function(t,e,r){var n=e(t);return H(t)?n:function(t,e){for(var r=-1,n=e.length,o=t.length;++r<n;)t[o+r]=e[r];return t}(n,r(t))}(t,vt,At)}var Mt=E(c,"DataView"),St=E(c,"Promise"),Et=E(c,"Set"),Pt=E(c,"WeakMap"),Ft="[object Map]",Ut="[object Promise]",It="[object Set]",Tt="[object WeakMap]",kt="[object DataView]",Bt=O(Mt),Dt=O(P),$t=O(St),Lt=O(Et),Rt=O(Pt),Vt=y;(Mt&&Vt(new Mt(new ArrayBuffer(1)))!=kt||P&&Vt(new P)!=Ft||St&&Vt(St.resolve())!=Ut||Et&&Vt(new Et)!=It||Pt&&Vt(new Pt)!=Tt)&&(Vt=function(t){var e=y(t),r="[object Object]"==e?t.constructor:void 0,n=r?O(r):"";if(n)switch(n){case Bt:return kt;case Dt:return Ft;case $t:return Ut;case Lt:return It;case Rt:return Tt}return e});var Ct=Object.prototype.hasOwnProperty;var Nt=c.Uint8Array;function Wt(t){var e=new t.constructor(t.byteLength);return new Nt(e).set(new Nt(t)),e}var qt=/\w*$/;var Gt=u?u.prototype:void 0,Ht=Gt?Gt.valueOf:void 0;function Jt(t,e,r){var n,o,a,c,u,i=t.constructor;switch(e){case"[object ArrayBuffer]":return Wt(t);case"[object Boolean]":case"[object Date]":return new i(+t);case"[object DataView]":return u=Wt((c=t).buffer),new c.constructor(u,c.byteOffset,c.byteLength);case"[object Float32Array]":case"[object Float64Array]":case"[object Int8Array]":case"[object Int16Array]":case"[object Int32Array]":case"[object Uint8Array]":case"[object Uint8ClampedArray]":case"[object Uint16Array]":case"[object Uint32Array]":return function(t){var e=Wt(t.buffer);return new t.constructor(e,t.byteOffset,t.length)}(t);case"[object Map]":case"[object Set]":return new i;case"[object Number]":case"[object String]":return new i(t);case"[object RegExp]":return(a=new(o=t).constructor(o.source,qt.exec(o))).lastIndex=o.lastIndex,a;case"[object Symbol]":return n=t,Ht?Object(Ht.call(n)):{}}}var Kt=Object.create,Qt=function(){function t(){}return function(e){if(!_(e))return{};if(Kt)return Kt(e);t.prototype=e;var r=new t;return t.prototype=void 0,r}}();var Xt=ct&&ct.isMap,Yt=Xt?rt(Xt):function(t){return V(t)&&"[object Map]"==Vt(t)};var Zt=ct&&ct.isSet,te=Zt?rt(Zt):function(t){return V(t)&&"[object Set]"==Vt(t)},ee="[object Arguments]",re="[object Function]",ne="[object Object]",oe={};function ae(t,e,r,n,o,a){var c;if(void 0!==c)return c;if(!_(t))return t;var u=H(t);if(u)c=function(t){var e=t.length,r=new t.constructor(e);return e&&"string"==typeof t[0]&&Ct.call(t,"index")&&(r.index=t.index,r.input=t.input),r}(t);else{var i=Vt(t),s=i==re||"[object GeneratorFunction]"==i;if(X(t))return t.slice();if(i==ne||i==ee||s&&!o)c=s?{}:function(t){return"function"!=typeof t.constructor||lt(t)?{}:Qt(xt(t))}(t);else{if(!oe[i])return o?t:{};c=Jt(t,i)}}a||(a=new D);var p=a.get(t);if(p)return p;a.set(t,c),te(t)?t.forEach(function(n){c.add(ae(n,e,r,n,t,a))}):Yt(t)&&t.forEach(function(n,o){c.set(o,ae(n,e,r,o,t,a))});var f=u?void 0:zt(t);return function(t,e){for(var r=-1,n=null==t?0:t.length;++r<n&&!1!==e(t[r],r,t););}(f||t,function(n,o){f&&(n=t[o=n]),R(c,o,ae(n,e,r,o,t,a))}),c}oe[ee]=oe["[object Array]"]=oe["[object ArrayBuffer]"]=oe["[object DataView]"]=oe["[object Boolean]"]=oe["[object Date]"]=oe["[object Float32Array]"]=oe["[object Float64Array]"]=oe["[object Int8Array]"]=oe["[object Int16Array]"]=oe["[object Int32Array]"]=oe["[object Map]"]=oe["[object Number]"]=oe[ne]=oe["[object RegExp]"]=oe["[object Set]"]=oe["[object String]"]=oe["[object Symbol]"]=oe["[object Uint8Array]"]=oe["[object Uint8ClampedArray]"]=oe["[object Uint16Array]"]=oe["[object Uint32Array]"]=!0,oe["[object Error]"]=oe[re]=oe["[object WeakMap]"]=!1;var ce=Object.prototype.hasOwnProperty;var ue=Function.prototype,ie=Object.prototype,se=ue.toString,pe=ie.hasOwnProperty,fe=se.call(Object);function le(t){return!function(t){if(null==t)return!0;if(ht(t)&&(H(t)||"string"==typeof t||"function"==typeof t.splice||X(t)||it(t)||G(t)))return!t.length;var e=Vt(t);if("[object Map]"==e||"[object Set]"==e)return!t.size;if(lt(t))return!jt(t).length;for(var r in t)if(ce.call(t,r))return!1;return!0}(t)&&t.every(t=>"string"==typeof t)}class be{__enumMap__;__enumLabelMap__;__enumExtraMap__;constructor(t){if(!function(t){if(!V(t)||"[object Object]"!=y(t))return!1;var e=xt(t);if(null===e)return!0;var r=pe.call(e,"constructor")&&e.constructor;return"function"==typeof r&&r instanceof r&&se.call(r)==fe}(t))throw new TypeError("初始化参数值必须是一个object！");this.#t(ae(t,5))}#t(t){const e={},r={};Object.keys(t).forEach(n=>{const o=t[n];if(!H(o))throw new TypeError("初始化参数对象字段的值必是一个array！");this[n]=o[0],e[n]=o[1],e[o[0]]=o[1],r[n]=o[2],r[o[0]]=o[2]}),this.__enumMap__=Object.freeze(t),this.__enumLabelMap__=Object.freeze(e),this.__enumExtraMap__=Object.freeze(r)}value(t){return this[t]}values(...t){let e=Object.keys(this.__enumMap__);return le(t)&&(e=Array.from(t)),e.map(t=>this.value(t))}options(...t){let e=Object.keys(this.__enumMap__);return le(t)&&(e=Array.from(t)),e.map(t=>({value:this.value(t),label:this.label(t),extra:this.extra(t)}))}label(t){return this.__enumLabelMap__[t]}extra(t){return this.__enumExtraMap__[t]}check(t,e){return this.value(e)===t}}module.exports=t=>{const e=new be(t);return Object.freeze(e)};
+"use strict";class e{__enumMap__;__enumLabelMap__;__enumExtraMap__;__valueKeyMap__;constructor(e){if(null===e||"object"!=typeof e||Array.isArray(e))throw new TypeError("初始化参数值必须是一个 object！");const t={},_={},r={},n=Object.keys(e);for(let a=0;a<n.length;a++){const s=n[a],u=e[s];if(!Array.isArray(u))throw new TypeError(`初始化参数对象字段 "${s}" 的值必须是一个 array！`);this[s]=u[0],t[s]=u[1],t[u[0]]=u[1],_[s]=u[2],_[u[0]]=u[2],r[u[0]]=s}this.__enumMap__=Object.freeze(e),this.__enumLabelMap__=Object.freeze(t),this.__enumExtraMap__=Object.freeze(_),this.__valueKeyMap__=Object.freeze(r)}keys(){return Object.keys(this.__enumMap__)}value(e){return this[e]}values(...e){return(e.length>0?e:this.keys()).map(e=>this.value(e))}options(...e){return(e.length>0?e:this.keys()).map(e=>({value:this.value(e),label:this.label(e),extra:this.extra(e)}))}label(e){return this.__enumLabelMap__[e]}extra(e){return this.__enumExtraMap__[e]}keyOf(e){return this.__valueKeyMap__[e]}check(e,t){return this.value(t)===e}has(e){return this.__valueKeyMap__.hasOwnProperty(e)}get size(){return Object.keys(this.__enumMap__).length}omit(...e){const _={},r=new Set(e),n=Object.keys(this.__enumMap__);for(let e=0;e<n.length;e++){const t=n[e];r.has(t)||(_[t]=this.__enumMap__[t])}return t(_)}pick(...e){const _={};for(let t=0;t<e.length;t++){const r=e[t];this.__enumMap__.hasOwnProperty(r)&&(_[r]=this.__enumMap__[r])}return t(_)}forEach(e){const t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const r=t[_];e(this.value(r),this.__enumLabelMap__[r],r,this.__enumExtraMap__[r])}}toMap(){const e=new Map,t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const r=t[_],n=this.__enumMap__[r];e.set(n[0],n[1])}return e}toRecord(){const e={},t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const r=t[_],n=this.__enumMap__[r];e[n[0]]=n[1]}return e}filter(e){const t=[],_=Object.keys(this.__enumMap__);for(let r=0;r<_.length;r++){const n=_[r],a=this.value(n),s=this.__enumLabelMap__[n],u=this.__enumExtraMap__[n];e(a,s,n,u)&&t.push({value:a,label:s,extra:u})}return t}[Symbol.iterator](){const e=Object.keys(this.__enumMap__);let t=0;const _=this;return{next(){if(t<e.length){const r=e[t++];return{done:!1,value:{key:r,value:_.value(r),label:_.__enumLabelMap__[r],extra:_.__enumExtraMap__[r]}}}return{done:!0,value:void 0}}}}}const t=t=>{const _=new e(t);return Object.freeze(_)};module.exports=t;

package/dist/create-enum.es.js

@@ -1 +1 @@
-function t(t,e){return t===e||t!=t&&e!=e}function e(e,r){for(var n=e.length;n--;)if(t(e[n][0],r))return n;return-1}var r=Array.prototype.splice;function n(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}n.prototype.clear=function(){this.__data__=[],this.size=0},n.prototype.delete=function(t){var n=this.__data__,o=e(n,t);return!(o<0)&&(o==n.length-1?n.pop():r.call(n,o,1),--this.size,!0)},n.prototype.get=function(t){var r=this.__data__,n=e(r,t);return n<0?void 0:r[n][1]},n.prototype.has=function(t){return e(this.__data__,t)>-1},n.prototype.set=function(t,r){var n=this.__data__,o=e(n,t);return o<0?(++this.size,n.push([t,r])):n[o][1]=r,this};var o="object"==typeof global&&global&&global.Object===Object&&global,a="object"==typeof self&&self&&self.Object===Object&&self,c=o||a||Function("return this")(),u=c.Symbol,i=Object.prototype,s=i.hasOwnProperty,p=i.toString,f=u?u.toStringTag:void 0;var l=Object.prototype.toString;var b=u?u.toStringTag:void 0;function y(t){return null==t?void 0===t?"[object Undefined]":"[object Null]":b&&b in Object(t)?function(t){var e=s.call(t,f),r=t[f];try{t[f]=void 0;var n=!0}catch(t){}var o=p.call(t);return n&&(e?t[f]=r:delete t[f]),o}(t):function(t){return l.call(t)}(t)}function _(t){var e=typeof t;return null!=t&&("object"==e||"function"==e)}function j(t){if(!_(t))return!1;var e=y(t);return"[object Function]"==e||"[object GeneratorFunction]"==e||"[object AsyncFunction]"==e||"[object Proxy]"==e}var h,v=c["__core-js_shared__"],d=(h=/[^.]+$/.exec(v&&v.keys&&v.keys.IE_PROTO||""))?"Symbol(src)_1."+h:"";var g=Function.prototype.toString;function O(t){if(null!=t){try{return g.call(t)}catch(t){}try{return t+""}catch(t){}}return""}var m=/^\[object .+?Constructor\]$/,w=Function.prototype,A=Object.prototype,x=w.toString,z=A.hasOwnProperty,M=RegExp("^"+x.call(z).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");function S(t){return!(!_(t)||(e=t,d&&d in e))&&(j(t)?M:m).test(O(t));var e}function E(t,e){var r=function(t,e){return null==t?void 0:t[e]}(t,e);return S(r)?r:void 0}var P=E(c,"Map"),F=E(Object,"create");var U=Object.prototype.hasOwnProperty;var I=Object.prototype.hasOwnProperty;function T(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}function k(t,e){var r,n,o=t.__data__;return("string"==(n=typeof(r=e))||"number"==n||"symbol"==n||"boolean"==n?"__proto__"!==r:null===r)?o["string"==typeof e?"string":"hash"]:o.map}function B(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}T.prototype.clear=function(){this.__data__=F?F(null):{},this.size=0},T.prototype.delete=function(t){var e=this.has(t)&&delete this.__data__[t];return this.size-=e?1:0,e},T.prototype.get=function(t){var e=this.__data__;if(F){var r=e[t];return"__lodash_hash_undefined__"===r?void 0:r}return U.call(e,t)?e[t]:void 0},T.prototype.has=function(t){var e=this.__data__;return F?void 0!==e[t]:I.call(e,t)},T.prototype.set=function(t,e){var r=this.__data__;return this.size+=this.has(t)?0:1,r[t]=F&&void 0===e?"__lodash_hash_undefined__":e,this},B.prototype.clear=function(){this.size=0,this.__data__={hash:new T,map:new(P||n),string:new T}},B.prototype.delete=function(t){var e=k(this,t).delete(t);return this.size-=e?1:0,e},B.prototype.get=function(t){return k(this,t).get(t)},B.prototype.has=function(t){return k(this,t).has(t)},B.prototype.set=function(t,e){var r=k(this,t),n=r.size;return r.set(t,e),this.size+=r.size==n?0:1,this};function D(t){var e=this.__data__=new n(t);this.size=e.size}D.prototype.clear=function(){this.__data__=new n,this.size=0},D.prototype.delete=function(t){var e=this.__data__,r=e.delete(t);return this.size=e.size,r},D.prototype.get=function(t){return this.__data__.get(t)},D.prototype.has=function(t){return this.__data__.has(t)},D.prototype.set=function(t,e){var r=this.__data__;if(r instanceof n){var o=r.__data__;if(!P||o.length<199)return o.push([t,e]),this.size=++r.size,this;r=this.__data__=new B(o)}return r.set(t,e),this.size=r.size,this};var $=function(){try{var t=E(Object,"defineProperty");return t({},"",{}),t}catch(t){}}();var L=Object.prototype.hasOwnProperty;function R(e,r,n){var o=e[r];L.call(e,r)&&t(o,n)&&(void 0!==n||r in e)||function(t,e,r){"__proto__"==e&&$?$(t,e,{configurable:!0,enumerable:!0,value:r,writable:!0}):t[e]=r}(e,r,n)}function V(t){return null!=t&&"object"==typeof t}function C(t){return V(t)&&"[object Arguments]"==y(t)}var N=Object.prototype,W=N.hasOwnProperty,q=N.propertyIsEnumerable,G=C(function(){return arguments}())?C:function(t){return V(t)&&W.call(t,"callee")&&!q.call(t,"callee")},H=Array.isArray;var J="object"==typeof exports&&exports&&!exports.nodeType&&exports,K=J&&"object"==typeof module&&module&&!module.nodeType&&module,Q=K&&K.exports===J?c.Buffer:void 0,X=(Q?Q.isBuffer:void 0)||function(){return!1},Y=/^(?:0|[1-9]\d*)$/;function Z(t,e){var r=typeof t;return!!(e=null==e?9007199254740991:e)&&("number"==r||"symbol"!=r&&Y.test(t))&&t>-1&&t%1==0&&t<e}function tt(t){return"number"==typeof t&&t>-1&&t%1==0&&t<=9007199254740991}var et={};function rt(t){return function(e){return t(e)}}et["[object Float32Array]"]=et["[object Float64Array]"]=et["[object Int8Array]"]=et["[object Int16Array]"]=et["[object Int32Array]"]=et["[object Uint8Array]"]=et["[object Uint8ClampedArray]"]=et["[object Uint16Array]"]=et["[object Uint32Array]"]=!0,et["[object Arguments]"]=et["[object Array]"]=et["[object ArrayBuffer]"]=et["[object Boolean]"]=et["[object DataView]"]=et["[object Date]"]=et["[object Error]"]=et["[object Function]"]=et["[object Map]"]=et["[object Number]"]=et["[object Object]"]=et["[object RegExp]"]=et["[object Set]"]=et["[object String]"]=et["[object WeakMap]"]=!1;var nt="object"==typeof exports&&exports&&!exports.nodeType&&exports,ot=nt&&"object"==typeof module&&module&&!module.nodeType&&module,at=ot&&ot.exports===nt&&o.process,ct=function(){try{var t=ot&&ot.require&&ot.require("util").types;return t||at&&at.binding&&at.binding("util")}catch(t){}}(),ut=ct&&ct.isTypedArray,it=ut?rt(ut):function(t){return V(t)&&tt(t.length)&&!!et[y(t)]},st=Object.prototype.hasOwnProperty;function pt(t,e){var r=H(t),n=!r&&G(t),o=!r&&!n&&X(t),a=!r&&!n&&!o&&it(t),c=r||n||o||a,u=c?function(t,e){for(var r=-1,n=Array(t);++r<t;)n[r]=e(r);return n}(t.length,String):[],i=u.length;for(var s in t)!st.call(t,s)||c&&("length"==s||o&&("offset"==s||"parent"==s)||a&&("buffer"==s||"byteLength"==s||"byteOffset"==s)||Z(s,i))||u.push(s);return u}var ft=Object.prototype;function lt(t){var e=t&&t.constructor;return t===("function"==typeof e&&e.prototype||ft)}function bt(t,e){return function(r){return t(e(r))}}var yt=bt(Object.keys,Object),_t=Object.prototype.hasOwnProperty;function jt(t){if(!lt(t))return yt(t);var e=[];for(var r in Object(t))_t.call(t,r)&&"constructor"!=r&&e.push(r);return e}function ht(t){return null!=t&&tt(t.length)&&!j(t)}function vt(t){return ht(t)?pt(t):jt(t)}var dt="object"==typeof exports&&exports&&!exports.nodeType&&exports,gt=dt&&"object"==typeof module&&module&&!module.nodeType&&module,Ot=gt&&gt.exports===dt?c.Buffer:void 0;Ot&&Ot.allocUnsafe;var mt=Object.prototype.propertyIsEnumerable,wt=Object.getOwnPropertySymbols,At=wt?function(t){return null==t?[]:(t=Object(t),function(t,e){for(var r=-1,n=null==t?0:t.length,o=0,a=[];++r<n;){var c=t[r];e(c,r,t)&&(a[o++]=c)}return a}(wt(t),function(e){return mt.call(t,e)}))}:function(){return[]};var xt=bt(Object.getPrototypeOf,Object);function zt(t){return function(t,e,r){var n=e(t);return H(t)?n:function(t,e){for(var r=-1,n=e.length,o=t.length;++r<n;)t[o+r]=e[r];return t}(n,r(t))}(t,vt,At)}var Mt=E(c,"DataView"),St=E(c,"Promise"),Et=E(c,"Set"),Pt=E(c,"WeakMap"),Ft="[object Map]",Ut="[object Promise]",It="[object Set]",Tt="[object WeakMap]",kt="[object DataView]",Bt=O(Mt),Dt=O(P),$t=O(St),Lt=O(Et),Rt=O(Pt),Vt=y;(Mt&&Vt(new Mt(new ArrayBuffer(1)))!=kt||P&&Vt(new P)!=Ft||St&&Vt(St.resolve())!=Ut||Et&&Vt(new Et)!=It||Pt&&Vt(new Pt)!=Tt)&&(Vt=function(t){var e=y(t),r="[object Object]"==e?t.constructor:void 0,n=r?O(r):"";if(n)switch(n){case Bt:return kt;case Dt:return Ft;case $t:return Ut;case Lt:return It;case Rt:return Tt}return e});var Ct=Object.prototype.hasOwnProperty;var Nt=c.Uint8Array;function Wt(t){var e=new t.constructor(t.byteLength);return new Nt(e).set(new Nt(t)),e}var qt=/\w*$/;var Gt=u?u.prototype:void 0,Ht=Gt?Gt.valueOf:void 0;function Jt(t,e,r){var n,o,a,c,u,i=t.constructor;switch(e){case"[object ArrayBuffer]":return Wt(t);case"[object Boolean]":case"[object Date]":return new i(+t);case"[object DataView]":return u=Wt((c=t).buffer),new c.constructor(u,c.byteOffset,c.byteLength);case"[object Float32Array]":case"[object Float64Array]":case"[object Int8Array]":case"[object Int16Array]":case"[object Int32Array]":case"[object Uint8Array]":case"[object Uint8ClampedArray]":case"[object Uint16Array]":case"[object Uint32Array]":return function(t){var e=Wt(t.buffer);return new t.constructor(e,t.byteOffset,t.length)}(t);case"[object Map]":case"[object Set]":return new i;case"[object Number]":case"[object String]":return new i(t);case"[object RegExp]":return(a=new(o=t).constructor(o.source,qt.exec(o))).lastIndex=o.lastIndex,a;case"[object Symbol]":return n=t,Ht?Object(Ht.call(n)):{}}}var Kt=Object.create,Qt=function(){function t(){}return function(e){if(!_(e))return{};if(Kt)return Kt(e);t.prototype=e;var r=new t;return t.prototype=void 0,r}}();var Xt=ct&&ct.isMap,Yt=Xt?rt(Xt):function(t){return V(t)&&"[object Map]"==Vt(t)};var Zt=ct&&ct.isSet,te=Zt?rt(Zt):function(t){return V(t)&&"[object Set]"==Vt(t)},ee="[object Arguments]",re="[object Function]",ne="[object Object]",oe={};function ae(t,e,r,n,o,a){var c;if(void 0!==c)return c;if(!_(t))return t;var u=H(t);if(u)c=function(t){var e=t.length,r=new t.constructor(e);return e&&"string"==typeof t[0]&&Ct.call(t,"index")&&(r.index=t.index,r.input=t.input),r}(t);else{var i=Vt(t),s=i==re||"[object GeneratorFunction]"==i;if(X(t))return t.slice();if(i==ne||i==ee||s&&!o)c=s?{}:function(t){return"function"!=typeof t.constructor||lt(t)?{}:Qt(xt(t))}(t);else{if(!oe[i])return o?t:{};c=Jt(t,i)}}a||(a=new D);var p=a.get(t);if(p)return p;a.set(t,c),te(t)?t.forEach(function(n){c.add(ae(n,e,r,n,t,a))}):Yt(t)&&t.forEach(function(n,o){c.set(o,ae(n,e,r,o,t,a))});var f=u?void 0:zt(t);return function(t,e){for(var r=-1,n=null==t?0:t.length;++r<n&&!1!==e(t[r],r,t););}(f||t,function(n,o){f&&(n=t[o=n]),R(c,o,ae(n,e,r,o,t,a))}),c}oe[ee]=oe["[object Array]"]=oe["[object ArrayBuffer]"]=oe["[object DataView]"]=oe["[object Boolean]"]=oe["[object Date]"]=oe["[object Float32Array]"]=oe["[object Float64Array]"]=oe["[object Int8Array]"]=oe["[object Int16Array]"]=oe["[object Int32Array]"]=oe["[object Map]"]=oe["[object Number]"]=oe[ne]=oe["[object RegExp]"]=oe["[object Set]"]=oe["[object String]"]=oe["[object Symbol]"]=oe["[object Uint8Array]"]=oe["[object Uint8ClampedArray]"]=oe["[object Uint16Array]"]=oe["[object Uint32Array]"]=!0,oe["[object Error]"]=oe[re]=oe["[object WeakMap]"]=!1;var ce=Object.prototype.hasOwnProperty;var ue=Function.prototype,ie=Object.prototype,se=ue.toString,pe=ie.hasOwnProperty,fe=se.call(Object);function le(t){return!function(t){if(null==t)return!0;if(ht(t)&&(H(t)||"string"==typeof t||"function"==typeof t.splice||X(t)||it(t)||G(t)))return!t.length;var e=Vt(t);if("[object Map]"==e||"[object Set]"==e)return!t.size;if(lt(t))return!jt(t).length;for(var r in t)if(ce.call(t,r))return!1;return!0}(t)&&t.every(t=>"string"==typeof t)}class be{__enumMap__;__enumLabelMap__;__enumExtraMap__;constructor(t){if(!function(t){if(!V(t)||"[object Object]"!=y(t))return!1;var e=xt(t);if(null===e)return!0;var r=pe.call(e,"constructor")&&e.constructor;return"function"==typeof r&&r instanceof r&&se.call(r)==fe}(t))throw new TypeError("初始化参数值必须是一个object！");this.#t(ae(t,5))}#t(t){const e={},r={};Object.keys(t).forEach(n=>{const o=t[n];if(!H(o))throw new TypeError("初始化参数对象字段的值必是一个array！");this[n]=o[0],e[n]=o[1],e[o[0]]=o[1],r[n]=o[2],r[o[0]]=o[2]}),this.__enumMap__=Object.freeze(t),this.__enumLabelMap__=Object.freeze(e),this.__enumExtraMap__=Object.freeze(r)}value(t){return this[t]}values(...t){let e=Object.keys(this.__enumMap__);return le(t)&&(e=Array.from(t)),e.map(t=>this.value(t))}options(...t){let e=Object.keys(this.__enumMap__);return le(t)&&(e=Array.from(t)),e.map(t=>({value:this.value(t),label:this.label(t),extra:this.extra(t)}))}label(t){return this.__enumLabelMap__[t]}extra(t){return this.__enumExtraMap__[t]}check(t,e){return this.value(e)===t}}const ye=t=>{const e=new be(t);return Object.freeze(e)};export{ye as default};
+class e{__enumMap__;__enumLabelMap__;__enumExtraMap__;__valueKeyMap__;constructor(e){if(null===e||"object"!=typeof e||Array.isArray(e))throw new TypeError("初始化参数值必须是一个 object！");const t={},_={},r={},a=Object.keys(e);for(let n=0;n<a.length;n++){const s=a[n],u=e[s];if(!Array.isArray(u))throw new TypeError(`初始化参数对象字段 "${s}" 的值必须是一个 array！`);this[s]=u[0],t[s]=u[1],t[u[0]]=u[1],_[s]=u[2],_[u[0]]=u[2],r[u[0]]=s}this.__enumMap__=Object.freeze(e),this.__enumLabelMap__=Object.freeze(t),this.__enumExtraMap__=Object.freeze(_),this.__valueKeyMap__=Object.freeze(r)}keys(){return Object.keys(this.__enumMap__)}value(e){return this[e]}values(...e){return(e.length>0?e:this.keys()).map(e=>this.value(e))}options(...e){return(e.length>0?e:this.keys()).map(e=>({value:this.value(e),label:this.label(e),extra:this.extra(e)}))}label(e){return this.__enumLabelMap__[e]}extra(e){return this.__enumExtraMap__[e]}keyOf(e){return this.__valueKeyMap__[e]}check(e,t){return this.value(t)===e}has(e){return this.__valueKeyMap__.hasOwnProperty(e)}get size(){return Object.keys(this.__enumMap__).length}omit(...e){const _={},r=new Set(e),a=Object.keys(this.__enumMap__);for(let e=0;e<a.length;e++){const t=a[e];r.has(t)||(_[t]=this.__enumMap__[t])}return t(_)}pick(...e){const _={};for(let t=0;t<e.length;t++){const r=e[t];this.__enumMap__.hasOwnProperty(r)&&(_[r]=this.__enumMap__[r])}return t(_)}forEach(e){const t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const r=t[_];e(this.value(r),this.__enumLabelMap__[r],r,this.__enumExtraMap__[r])}}toMap(){const e=new Map,t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const r=t[_],a=this.__enumMap__[r];e.set(a[0],a[1])}return e}toRecord(){const e={},t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const r=t[_],a=this.__enumMap__[r];e[a[0]]=a[1]}return e}filter(e){const t=[],_=Object.keys(this.__enumMap__);for(let r=0;r<_.length;r++){const a=_[r],n=this.value(a),s=this.__enumLabelMap__[a],u=this.__enumExtraMap__[a];e(n,s,a,u)&&t.push({value:n,label:s,extra:u})}return t}[Symbol.iterator](){const e=Object.keys(this.__enumMap__);let t=0;const _=this;return{next(){if(t<e.length){const r=e[t++];return{done:!1,value:{key:r,value:_.value(r),label:_.__enumLabelMap__[r],extra:_.__enumExtraMap__[r]}}}return{done:!0,value:void 0}}}}}const t=t=>{const _=new e(t);return Object.freeze(_)};export{t as default};

package/dist/create-enum.umd.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?module.exports=e():"function"==typeof define&&define.amd?define(e):(t="undefined"!=typeof globalThis?globalThis:t||self).$Enum=e()}(this,function(){"use strict";function t(t,e){return t===e||t!=t&&e!=e}function e(e,r){for(var n=e.length;n--;)if(t(e[n][0],r))return n;return-1}var r=Array.prototype.splice;function n(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}n.prototype.clear=function(){this.__data__=[],this.size=0},n.prototype.delete=function(t){var n=this.__data__,o=e(n,t);return!(o<0)&&(o==n.length-1?n.pop():r.call(n,o,1),--this.size,!0)},n.prototype.get=function(t){var r=this.__data__,n=e(r,t);return n<0?void 0:r[n][1]},n.prototype.has=function(t){return e(this.__data__,t)>-1},n.prototype.set=function(t,r){var n=this.__data__,o=e(n,t);return o<0?(++this.size,n.push([t,r])):n[o][1]=r,this};var o="object"==typeof global&&global&&global.Object===Object&&global,a="object"==typeof self&&self&&self.Object===Object&&self,c=o||a||Function("return this")(),i=c.Symbol,u=Object.prototype,s=u.hasOwnProperty,f=u.toString,p=i?i.toStringTag:void 0;var l=Object.prototype.toString;var b=i?i.toStringTag:void 0;function y(t){return null==t?void 0===t?"[object Undefined]":"[object Null]":b&&b in Object(t)?function(t){var e=s.call(t,p),r=t[p];try{t[p]=void 0;var n=!0}catch(t){}var o=f.call(t);return n&&(e?t[p]=r:delete t[p]),o}(t):function(t){return l.call(t)}(t)}function _(t){var e=typeof t;return null!=t&&("object"==e||"function"==e)}function j(t){if(!_(t))return!1;var e=y(t);return"[object Function]"==e||"[object GeneratorFunction]"==e||"[object AsyncFunction]"==e||"[object Proxy]"==e}var h,v=c["__core-js_shared__"],d=(h=/[^.]+$/.exec(v&&v.keys&&v.keys.IE_PROTO||""))?"Symbol(src)_1."+h:"";var g=Function.prototype.toString;function O(t){if(null!=t){try{return g.call(t)}catch(t){}try{return t+""}catch(t){}}return""}var m=/^\[object .+?Constructor\]$/,w=Function.prototype,A=Object.prototype,x=w.toString,z=A.hasOwnProperty,M=RegExp("^"+x.call(z).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");function S(t){return!(!_(t)||(e=t,d&&d in e))&&(j(t)?M:m).test(O(t));var e}function E(t,e){var r=function(t,e){return null==t?void 0:t[e]}(t,e);return S(r)?r:void 0}var P=E(c,"Map"),F=E(Object,"create");var U=Object.prototype.hasOwnProperty;var I=Object.prototype.hasOwnProperty;function T(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}function k(t,e){var r,n,o=t.__data__;return("string"==(n=typeof(r=e))||"number"==n||"symbol"==n||"boolean"==n?"__proto__"!==r:null===r)?o["string"==typeof e?"string":"hash"]:o.map}function B(t){var e=-1,r=null==t?0:t.length;for(this.clear();++e<r;){var n=t[e];this.set(n[0],n[1])}}T.prototype.clear=function(){this.__data__=F?F(null):{},this.size=0},T.prototype.delete=function(t){var e=this.has(t)&&delete this.__data__[t];return this.size-=e?1:0,e},T.prototype.get=function(t){var e=this.__data__;if(F){var r=e[t];return"__lodash_hash_undefined__"===r?void 0:r}return U.call(e,t)?e[t]:void 0},T.prototype.has=function(t){var e=this.__data__;return F?void 0!==e[t]:I.call(e,t)},T.prototype.set=function(t,e){var r=this.__data__;return this.size+=this.has(t)?0:1,r[t]=F&&void 0===e?"__lodash_hash_undefined__":e,this},B.prototype.clear=function(){this.size=0,this.__data__={hash:new T,map:new(P||n),string:new T}},B.prototype.delete=function(t){var e=k(this,t).delete(t);return this.size-=e?1:0,e},B.prototype.get=function(t){return k(this,t).get(t)},B.prototype.has=function(t){return k(this,t).has(t)},B.prototype.set=function(t,e){var r=k(this,t),n=r.size;return r.set(t,e),this.size+=r.size==n?0:1,this};function $(t){var e=this.__data__=new n(t);this.size=e.size}$.prototype.clear=function(){this.__data__=new n,this.size=0},$.prototype.delete=function(t){var e=this.__data__,r=e.delete(t);return this.size=e.size,r},$.prototype.get=function(t){return this.__data__.get(t)},$.prototype.has=function(t){return this.__data__.has(t)},$.prototype.set=function(t,e){var r=this.__data__;if(r instanceof n){var o=r.__data__;if(!P||o.length<199)return o.push([t,e]),this.size=++r.size,this;r=this.__data__=new B(o)}return r.set(t,e),this.size=r.size,this};var D=function(){try{var t=E(Object,"defineProperty");return t({},"",{}),t}catch(t){}}();var L=Object.prototype.hasOwnProperty;function R(e,r,n){var o=e[r];L.call(e,r)&&t(o,n)&&(void 0!==n||r in e)||function(t,e,r){"__proto__"==e&&D?D(t,e,{configurable:!0,enumerable:!0,value:r,writable:!0}):t[e]=r}(e,r,n)}function V(t){return null!=t&&"object"==typeof t}function C(t){return V(t)&&"[object Arguments]"==y(t)}var N=Object.prototype,W=N.hasOwnProperty,q=N.propertyIsEnumerable,G=C(function(){return arguments}())?C:function(t){return V(t)&&W.call(t,"callee")&&!q.call(t,"callee")},H=Array.isArray;var J="object"==typeof exports&&exports&&!exports.nodeType&&exports,K=J&&"object"==typeof module&&module&&!module.nodeType&&module,Q=K&&K.exports===J?c.Buffer:void 0,X=(Q?Q.isBuffer:void 0)||function(){return!1},Y=/^(?:0|[1-9]\d*)$/;function Z(t,e){var r=typeof t;return!!(e=null==e?9007199254740991:e)&&("number"==r||"symbol"!=r&&Y.test(t))&&t>-1&&t%1==0&&t<e}function tt(t){return"number"==typeof t&&t>-1&&t%1==0&&t<=9007199254740991}var et={};function rt(t){return function(e){return t(e)}}et["[object Float32Array]"]=et["[object Float64Array]"]=et["[object Int8Array]"]=et["[object Int16Array]"]=et["[object Int32Array]"]=et["[object Uint8Array]"]=et["[object Uint8ClampedArray]"]=et["[object Uint16Array]"]=et["[object Uint32Array]"]=!0,et["[object Arguments]"]=et["[object Array]"]=et["[object ArrayBuffer]"]=et["[object Boolean]"]=et["[object DataView]"]=et["[object Date]"]=et["[object Error]"]=et["[object Function]"]=et["[object Map]"]=et["[object Number]"]=et["[object Object]"]=et["[object RegExp]"]=et["[object Set]"]=et["[object String]"]=et["[object WeakMap]"]=!1;var nt="object"==typeof exports&&exports&&!exports.nodeType&&exports,ot=nt&&"object"==typeof module&&module&&!module.nodeType&&module,at=ot&&ot.exports===nt&&o.process,ct=function(){try{var t=ot&&ot.require&&ot.require("util").types;return t||at&&at.binding&&at.binding("util")}catch(t){}}(),it=ct&&ct.isTypedArray,ut=it?rt(it):function(t){return V(t)&&tt(t.length)&&!!et[y(t)]},st=Object.prototype.hasOwnProperty;function ft(t,e){var r=H(t),n=!r&&G(t),o=!r&&!n&&X(t),a=!r&&!n&&!o&&ut(t),c=r||n||o||a,i=c?function(t,e){for(var r=-1,n=Array(t);++r<t;)n[r]=e(r);return n}(t.length,String):[],u=i.length;for(var s in t)!st.call(t,s)||c&&("length"==s||o&&("offset"==s||"parent"==s)||a&&("buffer"==s||"byteLength"==s||"byteOffset"==s)||Z(s,u))||i.push(s);return i}var pt=Object.prototype;function lt(t){var e=t&&t.constructor;return t===("function"==typeof e&&e.prototype||pt)}function bt(t,e){return function(r){return t(e(r))}}var yt=bt(Object.keys,Object),_t=Object.prototype.hasOwnProperty;function jt(t){if(!lt(t))return yt(t);var e=[];for(var r in Object(t))_t.call(t,r)&&"constructor"!=r&&e.push(r);return e}function ht(t){return null!=t&&tt(t.length)&&!j(t)}function vt(t){return ht(t)?ft(t):jt(t)}var dt="object"==typeof exports&&exports&&!exports.nodeType&&exports,gt=dt&&"object"==typeof module&&module&&!module.nodeType&&module,Ot=gt&&gt.exports===dt?c.Buffer:void 0;Ot&&Ot.allocUnsafe;var mt=Object.prototype.propertyIsEnumerable,wt=Object.getOwnPropertySymbols,At=wt?function(t){return null==t?[]:(t=Object(t),function(t,e){for(var r=-1,n=null==t?0:t.length,o=0,a=[];++r<n;){var c=t[r];e(c,r,t)&&(a[o++]=c)}return a}(wt(t),function(e){return mt.call(t,e)}))}:function(){return[]};var xt=bt(Object.getPrototypeOf,Object);function zt(t){return function(t,e,r){var n=e(t);return H(t)?n:function(t,e){for(var r=-1,n=e.length,o=t.length;++r<n;)t[o+r]=e[r];return t}(n,r(t))}(t,vt,At)}var Mt=E(c,"DataView"),St=E(c,"Promise"),Et=E(c,"Set"),Pt=E(c,"WeakMap"),Ft="[object Map]",Ut="[object Promise]",It="[object Set]",Tt="[object WeakMap]",kt="[object DataView]",Bt=O(Mt),$t=O(P),Dt=O(St),Lt=O(Et),Rt=O(Pt),Vt=y;(Mt&&Vt(new Mt(new ArrayBuffer(1)))!=kt||P&&Vt(new P)!=Ft||St&&Vt(St.resolve())!=Ut||Et&&Vt(new Et)!=It||Pt&&Vt(new Pt)!=Tt)&&(Vt=function(t){var e=y(t),r="[object Object]"==e?t.constructor:void 0,n=r?O(r):"";if(n)switch(n){case Bt:return kt;case $t:return Ft;case Dt:return Ut;case Lt:return It;case Rt:return Tt}return e});var Ct=Object.prototype.hasOwnProperty;var Nt=c.Uint8Array;function Wt(t){var e=new t.constructor(t.byteLength);return new Nt(e).set(new Nt(t)),e}var qt=/\w*$/;var Gt=i?i.prototype:void 0,Ht=Gt?Gt.valueOf:void 0;function Jt(t,e,r){var n,o,a,c,i,u=t.constructor;switch(e){case"[object ArrayBuffer]":return Wt(t);case"[object Boolean]":case"[object Date]":return new u(+t);case"[object DataView]":return i=Wt((c=t).buffer),new c.constructor(i,c.byteOffset,c.byteLength);case"[object Float32Array]":case"[object Float64Array]":case"[object Int8Array]":case"[object Int16Array]":case"[object Int32Array]":case"[object Uint8Array]":case"[object Uint8ClampedArray]":case"[object Uint16Array]":case"[object Uint32Array]":return function(t){var e=Wt(t.buffer);return new t.constructor(e,t.byteOffset,t.length)}(t);case"[object Map]":case"[object Set]":return new u;case"[object Number]":case"[object String]":return new u(t);case"[object RegExp]":return(a=new(o=t).constructor(o.source,qt.exec(o))).lastIndex=o.lastIndex,a;case"[object Symbol]":return n=t,Ht?Object(Ht.call(n)):{}}}var Kt=Object.create,Qt=function(){function t(){}return function(e){if(!_(e))return{};if(Kt)return Kt(e);t.prototype=e;var r=new t;return t.prototype=void 0,r}}();var Xt=ct&&ct.isMap,Yt=Xt?rt(Xt):function(t){return V(t)&&"[object Map]"==Vt(t)};var Zt=ct&&ct.isSet,te=Zt?rt(Zt):function(t){return V(t)&&"[object Set]"==Vt(t)},ee="[object Arguments]",re="[object Function]",ne="[object Object]",oe={};function ae(t,e,r,n,o,a){var c;if(void 0!==c)return c;if(!_(t))return t;var i=H(t);if(i)c=function(t){var e=t.length,r=new t.constructor(e);return e&&"string"==typeof t[0]&&Ct.call(t,"index")&&(r.index=t.index,r.input=t.input),r}(t);else{var u=Vt(t),s=u==re||"[object GeneratorFunction]"==u;if(X(t))return t.slice();if(u==ne||u==ee||s&&!o)c=s?{}:function(t){return"function"!=typeof t.constructor||lt(t)?{}:Qt(xt(t))}(t);else{if(!oe[u])return o?t:{};c=Jt(t,u)}}a||(a=new $);var f=a.get(t);if(f)return f;a.set(t,c),te(t)?t.forEach(function(n){c.add(ae(n,e,r,n,t,a))}):Yt(t)&&t.forEach(function(n,o){c.set(o,ae(n,e,r,o,t,a))});var p=i?void 0:zt(t);return function(t,e){for(var r=-1,n=null==t?0:t.length;++r<n&&!1!==e(t[r],r,t););}(p||t,function(n,o){p&&(n=t[o=n]),R(c,o,ae(n,e,r,o,t,a))}),c}oe[ee]=oe["[object Array]"]=oe["[object ArrayBuffer]"]=oe["[object DataView]"]=oe["[object Boolean]"]=oe["[object Date]"]=oe["[object Float32Array]"]=oe["[object Float64Array]"]=oe["[object Int8Array]"]=oe["[object Int16Array]"]=oe["[object Int32Array]"]=oe["[object Map]"]=oe["[object Number]"]=oe[ne]=oe["[object RegExp]"]=oe["[object Set]"]=oe["[object String]"]=oe["[object Symbol]"]=oe["[object Uint8Array]"]=oe["[object Uint8ClampedArray]"]=oe["[object Uint16Array]"]=oe["[object Uint32Array]"]=!0,oe["[object Error]"]=oe[re]=oe["[object WeakMap]"]=!1;var ce=Object.prototype.hasOwnProperty;var ie=Function.prototype,ue=Object.prototype,se=ie.toString,fe=ue.hasOwnProperty,pe=se.call(Object);function le(t){return!function(t){if(null==t)return!0;if(ht(t)&&(H(t)||"string"==typeof t||"function"==typeof t.splice||X(t)||ut(t)||G(t)))return!t.length;var e=Vt(t);if("[object Map]"==e||"[object Set]"==e)return!t.size;if(lt(t))return!jt(t).length;for(var r in t)if(ce.call(t,r))return!1;return!0}(t)&&t.every(t=>"string"==typeof t)}class be{__enumMap__;__enumLabelMap__;__enumExtraMap__;constructor(t){if(!function(t){if(!V(t)||"[object Object]"!=y(t))return!1;var e=xt(t);if(null===e)return!0;var r=fe.call(e,"constructor")&&e.constructor;return"function"==typeof r&&r instanceof r&&se.call(r)==pe}(t))throw new TypeError("初始化参数值必须是一个object！");this.#t(ae(t,5))}#t(t){const e={},r={};Object.keys(t).forEach(n=>{const o=t[n];if(!H(o))throw new TypeError("初始化参数对象字段的值必是一个array！");this[n]=o[0],e[n]=o[1],e[o[0]]=o[1],r[n]=o[2],r[o[0]]=o[2]}),this.__enumMap__=Object.freeze(t),this.__enumLabelMap__=Object.freeze(e),this.__enumExtraMap__=Object.freeze(r)}value(t){return this[t]}values(...t){let e=Object.keys(this.__enumMap__);return le(t)&&(e=Array.from(t)),e.map(t=>this.value(t))}options(...t){let e=Object.keys(this.__enumMap__);return le(t)&&(e=Array.from(t)),e.map(t=>({value:this.value(t),label:this.label(t),extra:this.extra(t)}))}label(t){return this.__enumLabelMap__[t]}extra(t){return this.__enumExtraMap__[t]}check(t,e){return this.value(e)===t}}return t=>{const e=new be(t);return Object.freeze(e)}});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).$Enum=t()}(this,function(){"use strict";class e{__enumMap__;__enumLabelMap__;__enumExtraMap__;__valueKeyMap__;constructor(e){if(null===e||"object"!=typeof e||Array.isArray(e))throw new TypeError("初始化参数值必须是一个 object！");const t={},_={},n={},r=Object.keys(e);for(let a=0;a<r.length;a++){const s=r[a],u=e[s];if(!Array.isArray(u))throw new TypeError(`初始化参数对象字段 "${s}" 的值必须是一个 array！`);this[s]=u[0],t[s]=u[1],t[u[0]]=u[1],_[s]=u[2],_[u[0]]=u[2],n[u[0]]=s}this.__enumMap__=Object.freeze(e),this.__enumLabelMap__=Object.freeze(t),this.__enumExtraMap__=Object.freeze(_),this.__valueKeyMap__=Object.freeze(n)}keys(){return Object.keys(this.__enumMap__)}value(e){return this[e]}values(...e){return(e.length>0?e:this.keys()).map(e=>this.value(e))}options(...e){return(e.length>0?e:this.keys()).map(e=>({value:this.value(e),label:this.label(e),extra:this.extra(e)}))}label(e){return this.__enumLabelMap__[e]}extra(e){return this.__enumExtraMap__[e]}keyOf(e){return this.__valueKeyMap__[e]}check(e,t){return this.value(t)===e}has(e){return this.__valueKeyMap__.hasOwnProperty(e)}get size(){return Object.keys(this.__enumMap__).length}omit(...e){const _={},n=new Set(e),r=Object.keys(this.__enumMap__);for(let e=0;e<r.length;e++){const t=r[e];n.has(t)||(_[t]=this.__enumMap__[t])}return t(_)}pick(...e){const _={};for(let t=0;t<e.length;t++){const n=e[t];this.__enumMap__.hasOwnProperty(n)&&(_[n]=this.__enumMap__[n])}return t(_)}forEach(e){const t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const n=t[_];e(this.value(n),this.__enumLabelMap__[n],n,this.__enumExtraMap__[n])}}toMap(){const e=new Map,t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const n=t[_],r=this.__enumMap__[n];e.set(r[0],r[1])}return e}toRecord(){const e={},t=Object.keys(this.__enumMap__);for(let _=0;_<t.length;_++){const n=t[_],r=this.__enumMap__[n];e[r[0]]=r[1]}return e}filter(e){const t=[],_=Object.keys(this.__enumMap__);for(let n=0;n<_.length;n++){const r=_[n],a=this.value(r),s=this.__enumLabelMap__[r],u=this.__enumExtraMap__[r];e(a,s,r,u)&&t.push({value:a,label:s,extra:u})}return t}[Symbol.iterator](){const e=Object.keys(this.__enumMap__);let t=0;const _=this;return{next(){if(t<e.length){const n=e[t++];return{done:!1,value:{key:n,value:_.value(n),label:_.__enumLabelMap__[n],extra:_.__enumExtraMap__[n]}}}return{done:!0,value:void 0}}}}}const t=t=>{const _=new e(t);return Object.freeze(_)};return t});

package/dist/index.d.ts

@@ -1,62 +1,184 @@
-type IEMap = Readonly<Record<any, readonly [any, any] | readonly [any, any, any]>>;
+/**
+ * 宽化字面量类型
+ */
+type WidenLiteral<T> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T;
+/**
+ * 枚举 Map 约束类型：{ KEY: [value, label, extra?] }
+ */
+type IEMap = Readonly<Record<string, readonly [any, any, any?]>>;
+/**
+ * 枚举 Key 联合类型
+ */
 type TEUnion<T extends IEMap> = keyof T;
-type TEValue<T extends IEMap> = T[TEUnion<T>][0];
+/**
+ * 枚举 Value 联合类型
+ */
+type TEValue<T extends IEMap> = T[keyof T][0];
+/**
+ * 根据 Key 获取 Value 类型
+ */
+type TValue<K, T extends IEMap> = WidenLiteral<T[K & keyof T][0]>;
+/**
+ * 根据 Key 获取 Label 类型
+ */
+type TULabel<K, T extends IEMap> = WidenLiteral<T[K & keyof T][1]>;
+/**
+ * 根据 Value 获取 Label 类型
+ */
+type TVLabel<V, T extends IEMap> = WidenLiteral<Extract<T[keyof T], readonly [V, any, any?]>[1]>;
+/**
+ * 根据 Key 获取 Extra 类型
+ */
+type TUExtra<K, T extends IEMap> = WidenLiteral<T[K & keyof T][2]>;
+/**
+ * 根据 Value 获取 Extra 类型
+ */
+type TVExtra<V, T extends IEMap> = WidenLiteral<Extract<T[keyof T], readonly [V, any, any?]>[2]>;
+/**
+ * 根据 Value 反查 Key 类型
+ */
+type TKeyOfValue<V, T extends IEMap> = {
+    [K in keyof T]: T[K][0] extends V ? K : never;
+}[keyof T];
+/**
+ * Option 项类型
+ */
+type TOption<K extends keyof T, T extends IEMap> = {
+    value: TValue<K, T>;
+    label: TULabel<K, T>;
+    extra: TUExtra<K, T>;
+};
+/**
+ * 排除指定 Key 后的枚举类型
+ */
+type TOmitEnum<T extends IEMap, K extends keyof T> = Omit<T, K> extends infer R ? R extends IEMap ? R : never : never;
+/**
+ * 选取指定 Key 的枚举类型
+ */
+type TPickEnum<T extends IEMap, K extends keyof T> = Pick<T, K> extends infer R ? R extends IEMap ? R : never : never;
+/**
+ * 最终暴露的枚举实例类型
+ */
 type IEnum<T extends IEMap> = {
-    readonly [K in keyof T]: T[K] extends readonly [infer V, any] ? V : any;
+    readonly [K in keyof T]: T[K][0];
 } & Enum<T>;
 declare class Enum<T extends IEMap> {
-    #private;
-    protected __enumMap__: T;
-    protected __enumLabelMap__: any;
-    protected __enumExtraMap__: any;
+    protected readonly __enumMap__: T;
+    protected readonly __enumLabelMap__: Record<string | number, unknown>;
+    protected readonly __enumExtraMap__: Record<string | number, unknown>;
+    protected readonly __valueKeyMap__: Record<string | number, string>;
+    constructor(enumMap: T);
     /**
-     * @param {Object} enumMap 枚举map
+     * 获取所有枚举 Key 列表
      */
-    constructor(enumMap: T);
+    keys(): TEUnion<T>[];
     /**
      * 获取枚举值
-     * @param {String} key 枚举KEY
-     * @return {Number} 枚举值
+     * @param key 枚举 Key
      */
-    value(key: TEUnion<T>): TEValue<T>;
+    value<K extends TEUnion<T>>(key: K): TValue<K, T>;
     /**
-     * 获取多个枚举值
-     * @param {Array} param 多个枚举KEY
-     * @return {Array} {[枚举值]}
+     * 获取多个枚举值，不传参则返回所有
+     * @param args 枚举 Key 列表
      */
-    values(...args: TEUnion<T>[]): any | TEValue<T>[];
+    values<K extends TEUnion<T>>(...args: K[]): TValue<K, T>[];
     /**
-     * 获取多个枚举值Map
-     * @param {Array} param 多个枚举KEY，如果不传递则返回所有
-     * @return {Object} {[枚举key]:枚举值}
+     * 获取枚举选项列表（适配 Select/Radio 等组件），不传参则返回所有
+     * @param args 枚举 Key 列表
      */
-    options<V extends TEUnion<T>>(...args: V[]): {
-        value: TEValue<T>;
-        label: string;
-        extra: any;
-    }[];
+    options<K extends TEUnion<T>>(...args: K[]): TOption<K, T>[];
+    /**
+     * 获取枚举名称（通过 Key 或 Value）
+     * @param keyOrVal 枚举 Key 或 Value
+     */
+    label<K extends TEUnion<T>>(key: K): TULabel<K, T>;
+    label<V extends TEValue<T>>(val: V): TVLabel<V, T>;
+    /**
+     * 获取枚举附加数据（通过 Key 或 Value）
+     * @param keyOrVal 枚举 Key 或 Value
+     */
+    extra<K extends TEUnion<T>>(key: K): TUExtra<K, T>;
+    extra<V extends TEValue<T>>(val: V): TVExtra<V, T>;
+    /**
+     * 通过 Value 反查 Key
+     * @param val 枚举 Value
+     */
+    keyOf<V extends TEValue<T>>(val: V): TKeyOfValue<V, T>;
+    /**
+     * 检测值是否等于指定枚举 Key 对应的值
+     * @param val 待检测的值
+     * @param key 枚举 Key
+     */
+    check<K extends TEUnion<T>>(val: unknown, key: K): boolean;
+    /**
+     * 检测值是否属于该枚举的任意一个值
+     * @param val 待检测的值
+     */
+    has(val: unknown): val is TEValue<T>;
+    /**
+     * 获取枚举项数量
+     */
+    get size(): number;
+    /**
+     * 排除指定 Key，生成新的枚举实例
+     * @param args 要排除的 Key 列表
+     */
+    omit<K extends TEUnion<T>>(...args: K[]): Readonly<IEnum<TOmitEnum<T, K>>>;
+    /**
+     * 选取指定 Key，生成新的枚举实例
+     * @param args 要保留的 Key 列表
+     */
+    pick<K extends TEUnion<T>>(...args: K[]): Readonly<IEnum<TPickEnum<T, K & string>>>;
+    /**
+     * 遍历枚举项
+     * @param callback 回调函数 (value, label, key, extra) => void
+     */
+    forEach(callback: (value: TEValue<T>, label: unknown, key: TEUnion<T>, extra: unknown) => void): void;
     /**
-     * 获取枚举名称
-     * @param {String} keyOrVal 枚举KEY或枚举值
-     * @return {String} 枚举名称
+     * 将枚举转为 Map 对象 { value => label }
      */
-    label(keyOrVal: TEUnion<T> | TEValue<T>): string;
-    label(keyOrVal: any): any;
+    toMap(): Map<TEValue<T>, unknown>;
     /**
-     * 获取枚举关联参数
-     * @param {String} keyOrVal 枚举KEY或枚举值
-     * @return {String} 枚举名称
+     * 将枚举转为 Record 对象 { [value]: label }
      */
-    extra(keyOrVal: TEUnion<T> | TEValue<T>): any;
-    extra(keyOrVal: any): any;
+    toRecord(): Record<string | number, unknown>;
     /**
-     * 检测字段类型
-     * @param {Number} typeVal 类型
-     * @param {String} typeKey 类型key
-     * @return {Boolean}
+     * 过滤枚举项，返回满足条件的 options
+     * @param predicate 过滤函数
      */
-    check(typeVal: any, typeKey: TEUnion<T>): boolean;
+    filter(predicate: (value: TEValue<T>, label: unknown, key: TEUnion<T>, extra: unknown) => boolean): TOption<TEUnion<T>, T>[];
+    /**
+     * 支持 for...of 迭代
+     */
+    [Symbol.iterator](): Iterator<{
+        key: TEUnion<T>;
+        value: TEValue<T>;
+        label: unknown;
+        extra: unknown;
+    }>;
 }
+/**
+ * 创建枚举实例
+ * @param enumMap 枚举定义对象，格式：{ KEY: [value, label, extra?] as const }
+ *
+ * @example
+ * const Status = createEnum({
+ *   ACTIVE:   [1, '激活', { color: 'green' }],
+ *   INACTIVE: [0, '未激活', { color: 'gray' }],
+ * } as const);
+ *
+ * Status.ACTIVE          // 1
+ * Status.value('ACTIVE') // 1
+ * Status.label('ACTIVE') // '激活'
+ * Status.label(1)        // '激活'
+ * Status.extra('ACTIVE') // { color: 'green' }
+ * Status.keyOf(1)        // 'ACTIVE'
+ * Status.has(1)          // true
+ * Status.has(99)         // false
+ * Status.options()       // [{ value: 1, label: '激活', extra: {...} }, ...]
+ * Status.pick('ACTIVE')  // 新枚举，仅包含 ACTIVE
+ * Status.omit('INACTIVE')// 新枚举，排除 INACTIVE
+ */
 declare const createEnum: <T extends IEMap>(enumMap: T) => Readonly<IEnum<T>>;
 
 export { createEnum as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-enum-es",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "description": "处理前端枚举的工具方法，支持ts类型检测",
   "main": "dist/create-enum.es.js",
   "types": "dist/index.d.ts",
@@ -24,7 +24,7 @@
   ],
   "type": "module",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "vitest --run",
     "build": "rollup -c",
     "dev": "rollup -cw"
   },
@@ -36,9 +36,7 @@
     "@rollup/plugin-typescript": "^11.1.6",
     "rollup": "^4.45.1",
     "rollup-plugin-dts": "^6.1.1",
-    "typescript": "^5.5.3"
-  },
-  "dependencies": {
-    "lodash-es": "^4.17.21"
+    "typescript": "^5.5.3",
+    "vitest": "^4.1.9"
   }
 }