@jiaozi-dev/kit 0.0.2 → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Yuxiang Liu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -24,22 +24,44 @@ pnpm add @jiaozi-dev/kit
 ## Enum
 
 ```typescript
-import { Enum } from "@jiaozi-dev/kit";
+import { Enum, getEnumKeys, getEnumValues, getEnumEntries, hasEnumKey, getEnumValue } from "@jiaozi-dev/kit";
 
 const STATUS = Enum({
     Success: "success",
     Warning: "warning",
     Error: "error",
 });
+// inferred as
+// const STATUS: Readonly<{
+//     readonly Success: "success";
+//     readonly Warning: "warning";
+//     readonly Error: "error";
+// }>;
+
 type STATUS = Enum<typeof STATUS>;
+// inferred as
+// type STATUS = "success" | "warning" | "error";
+
+getEnumKeys(STATUS);
+// inferred as
+// Readonly<["Success", "Warning", "Error"]>
+
+getEnumValues(STATUS);
+// inferred as
+// Readonly<["success", "warning", "error"]>
+
+getEnumEntries(STATUS);
+// inferred as
+// Readonly<[["Success", "success"], ["Warning", "warning"], ["Error", "error"]]>
+
+hasEnumKey(STATUS, "Success");
+// inferred as
+// true
 
+STATUS.Success;
+getEnumValue(STATUS, "Success");
 // inferred as
-const STATUS: Readonly<{
-    readonly Success: "success";
-    readonly Warning: "warning";
-    readonly Error: "error";
-}>;
-type STATUS = "success" | "warning" | "error";
+// "success"
 ```
 
 ## ...

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/enum/Enum.ts"],"sourcesContent":["//\r\ntype EnumKey = string;\r\ntype EnumValue = any;\r\ntype EnumObject = Record<EnumKey, EnumValue>;\r\n\r\n//\r\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\r\ntype LastOf<T> = UnionToIntersection<T extends any ? () => T : never> extends () => infer R ? R : never;\r\ntype UnionToTuple<T, L = LastOf<T>> = [T] extends [never] ? [] : [...UnionToTuple<Exclude<T, L>>, L];\r\n\r\ntype EntriesToTuple<T extends EnumObject, U extends keyof T = keyof T> = [U] extends [never]\r\n    ? []\r\n    : LastOf<U> extends infer L extends keyof T\r\n      ? [...EntriesToTuple<T, Exclude<U, L>>, readonly [L, T[L]]]\r\n      : [];\r\n\r\n/**\r\n * @example\r\n * ```typescript\r\n    const STATUS = Enum({\r\n        Success: \"success\",\r\n        Warning: \"warning\",\r\n        Error: \"error\",\r\n    });\r\n    type STATUS = Enum<typeof STATUS>;\r\n    ```\r\n */\r\nexport function Enum<const T extends EnumObject>(enumObject: T): Readonly<T> {\r\n    return Object.freeze(enumObject);\r\n}\r\nexport type Enum<T extends EnumObject> = T[keyof T];\r\n\r\n//\r\nexport function getEnumKeys<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<keyof T>> {\r\n    return Object.freeze(Object.keys(enumObject)) as unknown as Readonly<UnionToTuple<keyof T>>;\r\n}\r\nexport function getEnumValues<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<T[keyof T]>> {\r\n    return Object.freeze(Object.values(enumObject)) as unknown as Readonly<UnionToTuple<T[keyof T]>>;\r\n}\r\nexport function getEnumEntries<const T extends EnumObject>(enumObject: T): Readonly<EntriesToTuple<T>> {\r\n    return Object.freeze(Object.entries(enumObject)) as unknown as Readonly<EntriesToTuple<T>>;\r\n}\r\n\r\n//\r\nexport function hasEnumKey<const T extends EnumObject, const K extends EnumKey>(\r\n    enumObject: T,\r\n    key: K\r\n): key is K & keyof T {\r\n    return key in enumObject;\r\n}\r\n/**\r\n * @returns enumObject[key]\r\n */\r\nexport function getEnumValue<const T extends EnumObject, K extends keyof T>(enumObject: T, key: K): T[K] {\r\n    return enumObject[key];\r\n}\r\n"],"mappings":"mEA2BA,SAAgB,EAAiC,EAA4B,CACzE,OAAO,OAAO,OAAO,EAAW,CAKpC,SAAgB,EAAwC,EAAgD,CACpG,OAAO,OAAO,OAAO,OAAO,KAAK,EAAW,CAAC,CAEjD,SAAgB,EAA0C,EAAmD,CACzG,OAAO,OAAO,OAAO,OAAO,OAAO,EAAW,CAAC,CAEnD,SAAgB,EAA2C,EAA4C,CACnG,OAAO,OAAO,OAAO,OAAO,QAAQ,EAAW,CAAC,CAIpD,SAAgB,EACZ,EACA,EACkB,CAClB,OAAO,KAAO,EAKlB,SAAgB,EAA4D,EAAe,EAAc,CACrG,OAAO,EAAW"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/enum/Enum.ts"],"sourcesContent":["//\r\ntype EnumKey = string;\r\ntype EnumValue = any;\r\ntype EnumObject = Record<EnumKey, EnumValue>;\r\n\r\n//\r\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\r\ntype LastOf<T> = UnionToIntersection<T extends any ? () => T : never> extends () => infer R ? R : never;\r\ntype UnionToTuple<T, L = LastOf<T>> = [T] extends [never] ? [] : [...UnionToTuple<Exclude<T, L>>, L];\r\n\r\n//\r\ntype EntriesToTuple<T extends EnumObject, U extends keyof T = keyof T> = [U] extends [never]\r\n    ? []\r\n    : LastOf<U> extends infer L extends keyof T\r\n      ? [...EntriesToTuple<T, Exclude<U, L>>, readonly [L, T[L]]]\r\n      : [];\r\n\r\n//\r\nexport function Enum<const T extends EnumObject>(enumObject: T): Readonly<T> {\r\n    return Object.freeze(enumObject);\r\n}\r\n\r\nexport type Enum<T extends EnumObject> = T[keyof T];\r\n\r\n//\r\nexport function getEnumKeys<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<keyof T>> {\r\n    return Object.freeze(Object.keys(enumObject)) as unknown as Readonly<UnionToTuple<keyof T>>;\r\n}\r\n\r\nexport function getEnumValues<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<T[keyof T]>> {\r\n    return Object.freeze(Object.values(enumObject)) as unknown as Readonly<UnionToTuple<T[keyof T]>>;\r\n}\r\n\r\nexport function getEnumEntries<const T extends EnumObject>(enumObject: T): Readonly<EntriesToTuple<T>> {\r\n    return Object.freeze(Object.entries(enumObject)) as unknown as Readonly<EntriesToTuple<T>>;\r\n}\r\n\r\n//\r\nexport function hasEnumKey<const T extends EnumObject, const K extends EnumKey>(\r\n    enumObject: T,\r\n    key: K\r\n): key is K & keyof T {\r\n    return key in enumObject;\r\n}\r\n\r\nexport function getEnumValue<const T extends EnumObject, K extends keyof T>(enumObject: T, key: K): T[K] {\r\n    return enumObject[key];\r\n}\r\n"],"mappings":"mEAkBA,SAAgB,EAAiC,EAA4B,CACzE,OAAO,OAAO,OAAO,EAAW,CAMpC,SAAgB,EAAwC,EAAgD,CACpG,OAAO,OAAO,OAAO,OAAO,KAAK,EAAW,CAAC,CAGjD,SAAgB,EAA0C,EAAmD,CACzG,OAAO,OAAO,OAAO,OAAO,OAAO,EAAW,CAAC,CAGnD,SAAgB,EAA2C,EAA4C,CACnG,OAAO,OAAO,OAAO,OAAO,QAAQ,EAAW,CAAC,CAIpD,SAAgB,EACZ,EACA,EACkB,CAClB,OAAO,KAAO,EAGlB,SAAgB,EAA4D,EAAe,EAAc,CACrG,OAAO,EAAW"}

package/dist/index.d.cts

@@ -6,26 +6,12 @@ type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (
 type LastOf<T> = UnionToIntersection<T extends any ? () => T : never> extends (() => infer R) ? R : never;
 type UnionToTuple<T, L = LastOf<T>> = [T] extends [never] ? [] : [...UnionToTuple<Exclude<T, L>>, L];
 type EntriesToTuple<T extends EnumObject, U extends keyof T = keyof T> = [U] extends [never] ? [] : LastOf<U> extends infer L extends keyof T ? [...EntriesToTuple<T, Exclude<U, L>>, readonly [L, T[L]]] : [];
-/**
- * @example
- * ```typescript
-    const STATUS = Enum({
-        Success: "success",
-        Warning: "warning",
-        Error: "error",
-    });
-    type STATUS = Enum<typeof STATUS>;
-    ```
- */
 declare function Enum<const T extends EnumObject>(enumObject: T): Readonly<T>;
 type Enum<T extends EnumObject> = T[keyof T];
 declare function getEnumKeys<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<keyof T>>;
 declare function getEnumValues<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<T[keyof T]>>;
 declare function getEnumEntries<const T extends EnumObject>(enumObject: T): Readonly<EntriesToTuple<T>>;
 declare function hasEnumKey<const T extends EnumObject, const K extends EnumKey>(enumObject: T, key: K): key is K & keyof T;
-/**
- * @returns enumObject[key]
- */
 declare function getEnumValue<const T extends EnumObject, K extends keyof T>(enumObject: T, key: K): T[K];
 //#endregion
 export { Enum, getEnumEntries, getEnumKeys, getEnumValue, getEnumValues, hasEnumKey };

package/dist/index.d.ts

@@ -6,26 +6,12 @@ type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (
 type LastOf<T> = UnionToIntersection<T extends any ? () => T : never> extends (() => infer R) ? R : never;
 type UnionToTuple<T, L = LastOf<T>> = [T] extends [never] ? [] : [...UnionToTuple<Exclude<T, L>>, L];
 type EntriesToTuple<T extends EnumObject, U extends keyof T = keyof T> = [U] extends [never] ? [] : LastOf<U> extends infer L extends keyof T ? [...EntriesToTuple<T, Exclude<U, L>>, readonly [L, T[L]]] : [];
-/**
- * @example
- * ```typescript
-    const STATUS = Enum({
-        Success: "success",
-        Warning: "warning",
-        Error: "error",
-    });
-    type STATUS = Enum<typeof STATUS>;
-    ```
- */
 declare function Enum<const T extends EnumObject>(enumObject: T): Readonly<T>;
 type Enum<T extends EnumObject> = T[keyof T];
 declare function getEnumKeys<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<keyof T>>;
 declare function getEnumValues<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<T[keyof T]>>;
 declare function getEnumEntries<const T extends EnumObject>(enumObject: T): Readonly<EntriesToTuple<T>>;
 declare function hasEnumKey<const T extends EnumObject, const K extends EnumKey>(enumObject: T, key: K): key is K & keyof T;
-/**
- * @returns enumObject[key]
- */
 declare function getEnumValue<const T extends EnumObject, K extends keyof T>(enumObject: T, key: K): T[K];
 //#endregion
 export { Enum, getEnumEntries, getEnumKeys, getEnumValue, getEnumValues, hasEnumKey };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/enum/Enum.ts"],"sourcesContent":["//\r\ntype EnumKey = string;\r\ntype EnumValue = any;\r\ntype EnumObject = Record<EnumKey, EnumValue>;\r\n\r\n//\r\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\r\ntype LastOf<T> = UnionToIntersection<T extends any ? () => T : never> extends () => infer R ? R : never;\r\ntype UnionToTuple<T, L = LastOf<T>> = [T] extends [never] ? [] : [...UnionToTuple<Exclude<T, L>>, L];\r\n\r\ntype EntriesToTuple<T extends EnumObject, U extends keyof T = keyof T> = [U] extends [never]\r\n    ? []\r\n    : LastOf<U> extends infer L extends keyof T\r\n      ? [...EntriesToTuple<T, Exclude<U, L>>, readonly [L, T[L]]]\r\n      : [];\r\n\r\n/**\r\n * @example\r\n * ```typescript\r\n    const STATUS = Enum({\r\n        Success: \"success\",\r\n        Warning: \"warning\",\r\n        Error: \"error\",\r\n    });\r\n    type STATUS = Enum<typeof STATUS>;\r\n    ```\r\n */\r\nexport function Enum<const T extends EnumObject>(enumObject: T): Readonly<T> {\r\n    return Object.freeze(enumObject);\r\n}\r\nexport type Enum<T extends EnumObject> = T[keyof T];\r\n\r\n//\r\nexport function getEnumKeys<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<keyof T>> {\r\n    return Object.freeze(Object.keys(enumObject)) as unknown as Readonly<UnionToTuple<keyof T>>;\r\n}\r\nexport function getEnumValues<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<T[keyof T]>> {\r\n    return Object.freeze(Object.values(enumObject)) as unknown as Readonly<UnionToTuple<T[keyof T]>>;\r\n}\r\nexport function getEnumEntries<const T extends EnumObject>(enumObject: T): Readonly<EntriesToTuple<T>> {\r\n    return Object.freeze(Object.entries(enumObject)) as unknown as Readonly<EntriesToTuple<T>>;\r\n}\r\n\r\n//\r\nexport function hasEnumKey<const T extends EnumObject, const K extends EnumKey>(\r\n    enumObject: T,\r\n    key: K\r\n): key is K & keyof T {\r\n    return key in enumObject;\r\n}\r\n/**\r\n * @returns enumObject[key]\r\n */\r\nexport function getEnumValue<const T extends EnumObject, K extends keyof T>(enumObject: T, key: K): T[K] {\r\n    return enumObject[key];\r\n}\r\n"],"mappings":"AA2BA,SAAgB,EAAiC,EAA4B,CACzE,OAAO,OAAO,OAAO,EAAW,CAKpC,SAAgB,EAAwC,EAAgD,CACpG,OAAO,OAAO,OAAO,OAAO,KAAK,EAAW,CAAC,CAEjD,SAAgB,EAA0C,EAAmD,CACzG,OAAO,OAAO,OAAO,OAAO,OAAO,EAAW,CAAC,CAEnD,SAAgB,EAA2C,EAA4C,CACnG,OAAO,OAAO,OAAO,OAAO,QAAQ,EAAW,CAAC,CAIpD,SAAgB,EACZ,EACA,EACkB,CAClB,OAAO,KAAO,EAKlB,SAAgB,EAA4D,EAAe,EAAc,CACrG,OAAO,EAAW"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/enum/Enum.ts"],"sourcesContent":["//\r\ntype EnumKey = string;\r\ntype EnumValue = any;\r\ntype EnumObject = Record<EnumKey, EnumValue>;\r\n\r\n//\r\ntype UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;\r\ntype LastOf<T> = UnionToIntersection<T extends any ? () => T : never> extends () => infer R ? R : never;\r\ntype UnionToTuple<T, L = LastOf<T>> = [T] extends [never] ? [] : [...UnionToTuple<Exclude<T, L>>, L];\r\n\r\n//\r\ntype EntriesToTuple<T extends EnumObject, U extends keyof T = keyof T> = [U] extends [never]\r\n    ? []\r\n    : LastOf<U> extends infer L extends keyof T\r\n      ? [...EntriesToTuple<T, Exclude<U, L>>, readonly [L, T[L]]]\r\n      : [];\r\n\r\n//\r\nexport function Enum<const T extends EnumObject>(enumObject: T): Readonly<T> {\r\n    return Object.freeze(enumObject);\r\n}\r\n\r\nexport type Enum<T extends EnumObject> = T[keyof T];\r\n\r\n//\r\nexport function getEnumKeys<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<keyof T>> {\r\n    return Object.freeze(Object.keys(enumObject)) as unknown as Readonly<UnionToTuple<keyof T>>;\r\n}\r\n\r\nexport function getEnumValues<const T extends EnumObject>(enumObject: T): Readonly<UnionToTuple<T[keyof T]>> {\r\n    return Object.freeze(Object.values(enumObject)) as unknown as Readonly<UnionToTuple<T[keyof T]>>;\r\n}\r\n\r\nexport function getEnumEntries<const T extends EnumObject>(enumObject: T): Readonly<EntriesToTuple<T>> {\r\n    return Object.freeze(Object.entries(enumObject)) as unknown as Readonly<EntriesToTuple<T>>;\r\n}\r\n\r\n//\r\nexport function hasEnumKey<const T extends EnumObject, const K extends EnumKey>(\r\n    enumObject: T,\r\n    key: K\r\n): key is K & keyof T {\r\n    return key in enumObject;\r\n}\r\n\r\nexport function getEnumValue<const T extends EnumObject, K extends keyof T>(enumObject: T, key: K): T[K] {\r\n    return enumObject[key];\r\n}\r\n"],"mappings":"AAkBA,SAAgB,EAAiC,EAA4B,CACzE,OAAO,OAAO,OAAO,EAAW,CAMpC,SAAgB,EAAwC,EAAgD,CACpG,OAAO,OAAO,OAAO,OAAO,KAAK,EAAW,CAAC,CAGjD,SAAgB,EAA0C,EAAmD,CACzG,OAAO,OAAO,OAAO,OAAO,OAAO,EAAW,CAAC,CAGnD,SAAgB,EAA2C,EAA4C,CACnG,OAAO,OAAO,OAAO,OAAO,QAAQ,EAAW,CAAC,CAIpD,SAAgB,EACZ,EACA,EACkB,CAClB,OAAO,KAAO,EAGlB,SAAgB,EAA4D,EAAe,EAAc,CACrG,OAAO,EAAW"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jiaozi-dev/kit",
-    "version": "0.0.2",
+    "version": "0.0.4",
     "description": "A modern, type-safe TypeScript utility kit.",
     "type": "module",
     "main": "./dist/index.cjs",
@@ -30,6 +30,10 @@
         "enum"
     ],
     "sideEffects": false,
-    "author": "yxdtg",
-    "license": "MIT"
+    "author": "Yuxiang Liu",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/jiaozi-dev/jiaozi-dev-kit.git"
+    }
 }