@gateweb/react-utils 1.14.1 → 1.14.3

package/dist/cjs/index.d.ts

@@ -373,18 +373,75 @@ declare const isEqual: (value1: unknown, value2: unknown) => boolean;
  * @param valueKey value 的 key
  *
  * @example
- *
- * ```js
  * const myObj = {
- *    A: { value: 'a' },
- *    B: { value: 'b', other: 'other' },
- * }
- *
+ *   A: { value: 'a' },
+ *   B: { value: 'b', other: 'other' },
+ * } as const;
  * const enumCode = extractEnumLikeObject(myObj, 'value');
- * console.log(enumCode); // { A: 'a', B: 'b' }
- * ```
+ * // => { A: 'a', B: 'b' }
  */
 declare const extractEnumLikeObject: <T extends Record<string, { [P in K]: any; }>, K extends string>(enumObject: T, valueKey: K) => { [key in keyof T]: T[key][K]; };
+type EnumMap<T extends Record<string, any>, VK extends keyof T[keyof T] & string> = {
+    [K in keyof T]: T[K][VK];
+};
+type NormalList<T extends Record<string, any>> = Array<{
+    key: string;
+} & T[keyof T]>;
+type ScenesList<T extends Record<string, {
+    scenes: Record<string, Record<string, any>>;
+}>, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string> = Array<{
+    key: string;
+    value: T[keyof T][VK];
+} & T[keyof T]['scenes'][Scene]>;
+type NormalReturn<T extends Record<string, any>, VK extends keyof T[keyof T] & string> = {
+    Enum: EnumMap<T, VK>;
+    List: NormalList<T>;
+    getLabel: (value: T[keyof T][VK]) => string;
+};
+type ScenesReturn<T extends Record<string, {
+    scenes: Record<string, Record<string, any>>;
+}>, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string> = {
+    Enum: EnumMap<T, VK>;
+    List: ScenesList<T, Scene, VK>;
+    getLabel: (value: T[keyof T][VK]) => string;
+};
+type AsNamed<R, N extends string> = {
+    [K in keyof R as K extends 'Enum' ? `Enum${N}` : K extends 'List' ? `${N}List` : K extends 'getLabel' ? `get${N}Label` : never]: R[K];
+};
+/**
+ * 指定 value 欄位的鍵名選項。
+ * @template VK value 對應的鍵名型別
+ */
+type ValueKeyOption<VK extends string> = {
+    /**
+     * 指定 value 欄位的鍵名，當輸入物件的值欄位不是 `value` 時使用，預設為 `'value'`。
+     */
+    valueKey?: VK;
+};
+/**
+ * 命名選項，用於產生 `Enum${name}`、`${name}List`、`get${name}Label`。
+ * @template N 自訂名稱型別
+ */
+type NamedOption<N extends string> = {
+    /**
+     * 自訂輸出鍵名的名稱，用於產生 `Enum${name}`、`${name}List`、`get${name}Label`。
+     */
+    name: N;
+};
+/**
+ * 場景選項，指定要取用的場景 key。
+ * @template Scene 場景鍵名型別
+ */
+type SceneOption<Scene extends string> = {
+    /**
+     * 指定要取用的場景 key，會從 `scenes[scene]` 中取出 label 與其餘屬性。
+     */
+    scene: Scene;
+};
+type NormalNamedOptions<N extends string, VK extends string> = NamedOption<N> & ValueKeyOption<VK>;
+type NormalOptions<VK extends string> = ValueKeyOption<VK>;
+type ScenesNamedOptions<N extends string, Scene extends string, VK extends string> = NamedOption<N> & SceneOption<Scene> & ValueKeyOption<VK>;
+type ScenesOptions<Scene extends string, VK extends string> = SceneOption<Scene> & ValueKeyOption<VK>;
 /**
  * 將指定格式的物件生成 enum 物件、enum 列表、取得 label 的方法
  *
@@ -402,8 +459,9 @@ declare const extractEnumLikeObject: <T extends Record<string, { [P in K]: any;
  *
  * 取得 label 的方法 - 傳入 value 可以取得對應的 label
  *
- * @param obj 要處理的物件
- * @param name 生成的 enum 名稱
+ * 參數：
+ *  - obj：要處理的物件
+ *  - options：設定物件（可選）。若未提供 name，將使用預設鍵名：`Enum`、`List`、`getLabel`。
  *
  * @remarks
  * 若需多場景 label，請傳入第三參數 scene，詳細用法請見範例。
@@ -412,50 +470,52 @@ declare const extractEnumLikeObject: <T extends Record<string, { [P in K]: any;
  *
  * ```ts
  *
- * // 一般使用
+ * // 一般使用（命名版）
  * const Status = { Enabled: { value: 'enabled', label: '啟用' }, Disabled: { value: 'disabled', label: '停用' }};
- * const { EnumStatus, StatusList, getStatusLabel } = createEnumLikeObject(Status, 'Status');
+ * const { EnumStatus, StatusList, getStatusLabel } = createEnumLikeObject(Status, { name: 'Status' });
  * console.log(EnumStatus); // { Enabled: 'enabled', Disabled: 'disabled' }
  * console.log(StatusList); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
  * console.log(getStatusLabel('enabled')); // '啟用'
  *
+ * // 一般使用（未命名，使用預設鍵名）
+ * const { Enum, List, getLabel } = createEnumLikeObject(Status);
+ * console.log(Enum); // { Enabled: 'enabled', Disabled: 'disabled' }
+ * console.log(List); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
+ * console.log(getLabel('enabled')); // '啟用'
+ *
  * // scenes 版本
  *
  * const Status = { Enabled: { value: 'enabled', scenes: { webA: { label: '啟用' }, webB: { label: '激活' } } }, Disabled: { value: 'disabled', scenes: { webA: { label: '停用' }, webB: { label: '停止' }}}}
- * const { EnumStatusA, StatusAList, getStatusALabel } = createEnumLikeObject(Status, 'StatusA', 'webA');
+ * const { EnumStatusA, StatusAList, getStatusALabel } = createEnumLikeObject(Status, { name: 'StatusA', scene: 'webA' });
  * console.log(EnumStatusA); // { Enabled: 'enabled', Disabled: 'disabled' }
  * console.log(StatusAList); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
  * console.log(getStatusALabel('enabled')); // '啟用'
  *
- * const { EnumStatusA, StatusAList, getStatusALabel } = createEnumLikeObject(Status, 'StatusB', 'webB');
+ * const { EnumStatusB, StatusBList, getStatusBLabel } = createEnumLikeObject(Status, { name: 'StatusB', scene: 'webB' });
  * console.log(EnumStatusB); // { Enabled: 'enabled', Disabled: 'disabled' }
  * console.log(StatusBList); // [ { key: 'Enabled', value: 'enabled', label: '激活' }, { key: 'Disabled', value: 'disabled', label: '停止' }]
  * console.log(getStatusBLabel('enabled')); // '激活'
  *
+ * // scenes 版本（未命名，使用預設鍵名）
+ * const { Enum, List, getLabel } = createEnumLikeObject(Status, { scene: 'webA' });
+ * console.log(Enum); // { Enabled: 'enabled', Disabled: 'disabled' }
+ * console.log(List); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
+ * console.log(getLabel('enabled')); // '啟用'
  * ```
  *
  */
-declare function createEnumLikeObject<T extends Record<string, {
-    value: any;
-    label: string;
-}>, N extends string>(obj: T, name: N): {
-    [K in `Enum${N}` | `${N}List` | `get${N}Label`]: K extends `Enum${N}` ? {
-        [key in keyof T]: T[key]['value'];
-    } : K extends `${N}List` ? Array<{
-        key: string;
-    } & T[keyof T]> : (value: T[keyof T]['value']) => string;
-};
-declare function createEnumLikeObject<T extends Record<string, {
-    value: any;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
     scenes: Record<string, Record<string, any>>;
-}>, N extends string, Scene extends keyof T[keyof T]['scenes']>(obj: T, name: N, scene: Scene): {
-    [K in `Enum${N}` | `${N}List` | `get${N}Label`]: K extends `Enum${N}` ? {
-        [key in keyof T]: T[key]['value'];
-    } : K extends `${N}List` ? Array<{
-        key: string;
-        value: T[keyof T]['value'];
-    } & T[keyof T]['scenes'][Scene]> : (value: T[keyof T]['value']) => string;
-};
+}>, N extends string, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string>(obj: T, options: ScenesNamedOptions<N, Scene, VK>): AsNamed<ScenesReturn<T, Scene, VK>, N>;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
+    scenes: Record<string, Record<string, any>>;
+}>, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string>(obj: T, options: ScenesOptions<Scene, VK>): ScenesReturn<T, Scene, VK>;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
+    label: string;
+}>, N extends string, VK extends keyof T[keyof T] & string>(obj: T, options: NormalNamedOptions<N, VK>): AsNamed<NormalReturn<T, VK>, N>;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
+    label: string;
+}>, VK extends keyof T[keyof T] & string>(obj: T, options?: NormalOptions<VK>): NormalReturn<T, VK>;
 
 /**
  * simulate a fake api request

package/dist/cjs/index.js

@@ -164,49 +164,59 @@ const FILE_SIZE_UNITS$1 = [
  * @param valueKey value 的 key
  *
  * @example
- *
- * ```js
  * const myObj = {
- *    A: { value: 'a' },
- *    B: { value: 'b', other: 'other' },
- * }
- *
+ *   A: { value: 'a' },
+ *   B: { value: 'b', other: 'other' },
+ * } as const;
  * const enumCode = extractEnumLikeObject(myObj, 'value');
- * console.log(enumCode); // { A: 'a', B: 'b' }
- * ```
+ * // => { A: 'a', B: 'b' }
  */ const extractEnumLikeObject = (enumObject, valueKey)=>Object.entries(enumObject).reduce((acc, [key, value])=>({
             ...acc,
             [key]: value[valueKey]
         }), {});
 // 實作
-function createEnumLikeObject(obj, name, scene) {
-    const Enum = extractEnumLikeObject(obj, 'value');
+function createEnumLikeObject(obj, options) {
+    const name = options?.name;
+    const scene = options?.scene;
+    const valueKey = options?.valueKey ?? 'value';
+    const Enum = extractEnumLikeObject(obj, valueKey);
     // List：根據有無 scene 做不同處理
     let list;
     if (scene) {
         // scenes 版本：解構指定 scene 的 label
         list = Object.entries(obj).map(([key, item])=>({
                 key,
-                value: item.value,
+                value: item?.[valueKey],
                 ...item.scenes?.[scene] ?? {}
             }));
     } else {
         // label only 版本
         list = Object.entries(obj).map(([key, item])=>({
                 key,
+                value: item?.[valueKey],
                 ...item
             }));
     }
     function getLabel(value) {
-        const targetItem = list.find((item)=>item.value === value);
+        const targetItem = list.find((item)=>// 如果 list 項目內含有 valueKey 對應欄位，優先以該欄位比對；否則以 value 欄位比對
+            valueKey in item ? item[valueKey] === value : item.value === value);
         if (!targetItem) return String(value);
         if ('label' in targetItem) return targetItem.label;
         return String(value);
     }
+    if (name) {
+        // 命名版：使用 Enum${name}, ${name}List, get${name}Label 鍵名
+        return {
+            [`Enum${name}`]: Enum,
+            [`${name}List`]: list,
+            [`get${name}Label`]: getLabel
+        };
+    }
+    // 未命名：提供預設鍵名 Enum, List, getLabel
     return {
-        [`Enum${name}`]: Enum,
-        [`${name}List`]: list,
-        [`get${name}Label`]: getLabel
+        Enum,
+        List: list,
+        getLabel
     };
 }
 

package/dist/es/index.d.mts

@@ -373,18 +373,75 @@ declare const isEqual: (value1: unknown, value2: unknown) => boolean;
  * @param valueKey value 的 key
  *
  * @example
- *
- * ```js
  * const myObj = {
- *    A: { value: 'a' },
- *    B: { value: 'b', other: 'other' },
- * }
- *
+ *   A: { value: 'a' },
+ *   B: { value: 'b', other: 'other' },
+ * } as const;
  * const enumCode = extractEnumLikeObject(myObj, 'value');
- * console.log(enumCode); // { A: 'a', B: 'b' }
- * ```
+ * // => { A: 'a', B: 'b' }
  */
 declare const extractEnumLikeObject: <T extends Record<string, { [P in K]: any; }>, K extends string>(enumObject: T, valueKey: K) => { [key in keyof T]: T[key][K]; };
+type EnumMap<T extends Record<string, any>, VK extends keyof T[keyof T] & string> = {
+    [K in keyof T]: T[K][VK];
+};
+type NormalList<T extends Record<string, any>> = Array<{
+    key: string;
+} & T[keyof T]>;
+type ScenesList<T extends Record<string, {
+    scenes: Record<string, Record<string, any>>;
+}>, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string> = Array<{
+    key: string;
+    value: T[keyof T][VK];
+} & T[keyof T]['scenes'][Scene]>;
+type NormalReturn<T extends Record<string, any>, VK extends keyof T[keyof T] & string> = {
+    Enum: EnumMap<T, VK>;
+    List: NormalList<T>;
+    getLabel: (value: T[keyof T][VK]) => string;
+};
+type ScenesReturn<T extends Record<string, {
+    scenes: Record<string, Record<string, any>>;
+}>, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string> = {
+    Enum: EnumMap<T, VK>;
+    List: ScenesList<T, Scene, VK>;
+    getLabel: (value: T[keyof T][VK]) => string;
+};
+type AsNamed<R, N extends string> = {
+    [K in keyof R as K extends 'Enum' ? `Enum${N}` : K extends 'List' ? `${N}List` : K extends 'getLabel' ? `get${N}Label` : never]: R[K];
+};
+/**
+ * 指定 value 欄位的鍵名選項。
+ * @template VK value 對應的鍵名型別
+ */
+type ValueKeyOption<VK extends string> = {
+    /**
+     * 指定 value 欄位的鍵名，當輸入物件的值欄位不是 `value` 時使用，預設為 `'value'`。
+     */
+    valueKey?: VK;
+};
+/**
+ * 命名選項，用於產生 `Enum${name}`、`${name}List`、`get${name}Label`。
+ * @template N 自訂名稱型別
+ */
+type NamedOption<N extends string> = {
+    /**
+     * 自訂輸出鍵名的名稱，用於產生 `Enum${name}`、`${name}List`、`get${name}Label`。
+     */
+    name: N;
+};
+/**
+ * 場景選項，指定要取用的場景 key。
+ * @template Scene 場景鍵名型別
+ */
+type SceneOption<Scene extends string> = {
+    /**
+     * 指定要取用的場景 key，會從 `scenes[scene]` 中取出 label 與其餘屬性。
+     */
+    scene: Scene;
+};
+type NormalNamedOptions<N extends string, VK extends string> = NamedOption<N> & ValueKeyOption<VK>;
+type NormalOptions<VK extends string> = ValueKeyOption<VK>;
+type ScenesNamedOptions<N extends string, Scene extends string, VK extends string> = NamedOption<N> & SceneOption<Scene> & ValueKeyOption<VK>;
+type ScenesOptions<Scene extends string, VK extends string> = SceneOption<Scene> & ValueKeyOption<VK>;
 /**
  * 將指定格式的物件生成 enum 物件、enum 列表、取得 label 的方法
  *
@@ -402,8 +459,9 @@ declare const extractEnumLikeObject: <T extends Record<string, { [P in K]: any;
  *
  * 取得 label 的方法 - 傳入 value 可以取得對應的 label
  *
- * @param obj 要處理的物件
- * @param name 生成的 enum 名稱
+ * 參數：
+ *  - obj：要處理的物件
+ *  - options：設定物件（可選）。若未提供 name，將使用預設鍵名：`Enum`、`List`、`getLabel`。
  *
  * @remarks
  * 若需多場景 label，請傳入第三參數 scene，詳細用法請見範例。
@@ -412,50 +470,52 @@ declare const extractEnumLikeObject: <T extends Record<string, { [P in K]: any;
  *
  * ```ts
  *
- * // 一般使用
+ * // 一般使用（命名版）
  * const Status = { Enabled: { value: 'enabled', label: '啟用' }, Disabled: { value: 'disabled', label: '停用' }};
- * const { EnumStatus, StatusList, getStatusLabel } = createEnumLikeObject(Status, 'Status');
+ * const { EnumStatus, StatusList, getStatusLabel } = createEnumLikeObject(Status, { name: 'Status' });
  * console.log(EnumStatus); // { Enabled: 'enabled', Disabled: 'disabled' }
  * console.log(StatusList); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
  * console.log(getStatusLabel('enabled')); // '啟用'
  *
+ * // 一般使用（未命名，使用預設鍵名）
+ * const { Enum, List, getLabel } = createEnumLikeObject(Status);
+ * console.log(Enum); // { Enabled: 'enabled', Disabled: 'disabled' }
+ * console.log(List); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
+ * console.log(getLabel('enabled')); // '啟用'
+ *
  * // scenes 版本
  *
  * const Status = { Enabled: { value: 'enabled', scenes: { webA: { label: '啟用' }, webB: { label: '激活' } } }, Disabled: { value: 'disabled', scenes: { webA: { label: '停用' }, webB: { label: '停止' }}}}
- * const { EnumStatusA, StatusAList, getStatusALabel } = createEnumLikeObject(Status, 'StatusA', 'webA');
+ * const { EnumStatusA, StatusAList, getStatusALabel } = createEnumLikeObject(Status, { name: 'StatusA', scene: 'webA' });
  * console.log(EnumStatusA); // { Enabled: 'enabled', Disabled: 'disabled' }
  * console.log(StatusAList); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
  * console.log(getStatusALabel('enabled')); // '啟用'
  *
- * const { EnumStatusA, StatusAList, getStatusALabel } = createEnumLikeObject(Status, 'StatusB', 'webB');
+ * const { EnumStatusB, StatusBList, getStatusBLabel } = createEnumLikeObject(Status, { name: 'StatusB', scene: 'webB' });
  * console.log(EnumStatusB); // { Enabled: 'enabled', Disabled: 'disabled' }
  * console.log(StatusBList); // [ { key: 'Enabled', value: 'enabled', label: '激活' }, { key: 'Disabled', value: 'disabled', label: '停止' }]
  * console.log(getStatusBLabel('enabled')); // '激活'
  *
+ * // scenes 版本（未命名，使用預設鍵名）
+ * const { Enum, List, getLabel } = createEnumLikeObject(Status, { scene: 'webA' });
+ * console.log(Enum); // { Enabled: 'enabled', Disabled: 'disabled' }
+ * console.log(List); // [ { key: 'Enabled', value: 'enabled', label: '啟用' }, { key: 'Disabled', value: 'disabled', label: '停用' }]
+ * console.log(getLabel('enabled')); // '啟用'
  * ```
  *
  */
-declare function createEnumLikeObject<T extends Record<string, {
-    value: any;
-    label: string;
-}>, N extends string>(obj: T, name: N): {
-    [K in `Enum${N}` | `${N}List` | `get${N}Label`]: K extends `Enum${N}` ? {
-        [key in keyof T]: T[key]['value'];
-    } : K extends `${N}List` ? Array<{
-        key: string;
-    } & T[keyof T]> : (value: T[keyof T]['value']) => string;
-};
-declare function createEnumLikeObject<T extends Record<string, {
-    value: any;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
     scenes: Record<string, Record<string, any>>;
-}>, N extends string, Scene extends keyof T[keyof T]['scenes']>(obj: T, name: N, scene: Scene): {
-    [K in `Enum${N}` | `${N}List` | `get${N}Label`]: K extends `Enum${N}` ? {
-        [key in keyof T]: T[key]['value'];
-    } : K extends `${N}List` ? Array<{
-        key: string;
-        value: T[keyof T]['value'];
-    } & T[keyof T]['scenes'][Scene]> : (value: T[keyof T]['value']) => string;
-};
+}>, N extends string, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string>(obj: T, options: ScenesNamedOptions<N, Scene, VK>): AsNamed<ScenesReturn<T, Scene, VK>, N>;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
+    scenes: Record<string, Record<string, any>>;
+}>, Scene extends keyof T[keyof T]['scenes'] & string, VK extends keyof T[keyof T] & string>(obj: T, options: ScenesOptions<Scene, VK>): ScenesReturn<T, Scene, VK>;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
+    label: string;
+}>, N extends string, VK extends keyof T[keyof T] & string>(obj: T, options: NormalNamedOptions<N, VK>): AsNamed<NormalReturn<T, VK>, N>;
+declare function createEnumLikeObject<T extends Record<string, Record<VK, any> & {
+    label: string;
+}>, VK extends keyof T[keyof T] & string>(obj: T, options?: NormalOptions<VK>): NormalReturn<T, VK>;
 
 /**
  * simulate a fake api request

package/dist/es/index.mjs

@@ -157,49 +157,59 @@ const FILE_SIZE_UNITS$1 = [
  * @param valueKey value 的 key
  *
  * @example
- *
- * ```js
  * const myObj = {
- *    A: { value: 'a' },
- *    B: { value: 'b', other: 'other' },
- * }
- *
+ *   A: { value: 'a' },
+ *   B: { value: 'b', other: 'other' },
+ * } as const;
  * const enumCode = extractEnumLikeObject(myObj, 'value');
- * console.log(enumCode); // { A: 'a', B: 'b' }
- * ```
+ * // => { A: 'a', B: 'b' }
  */ const extractEnumLikeObject = (enumObject, valueKey)=>Object.entries(enumObject).reduce((acc, [key, value])=>({
             ...acc,
             [key]: value[valueKey]
         }), {});
 // 實作
-function createEnumLikeObject(obj, name, scene) {
-    const Enum = extractEnumLikeObject(obj, 'value');
+function createEnumLikeObject(obj, options) {
+    const name = options?.name;
+    const scene = options?.scene;
+    const valueKey = options?.valueKey ?? 'value';
+    const Enum = extractEnumLikeObject(obj, valueKey);
     // List：根據有無 scene 做不同處理
     let list;
     if (scene) {
         // scenes 版本：解構指定 scene 的 label
         list = Object.entries(obj).map(([key, item])=>({
                 key,
-                value: item.value,
+                value: item?.[valueKey],
                 ...item.scenes?.[scene] ?? {}
             }));
     } else {
         // label only 版本
         list = Object.entries(obj).map(([key, item])=>({
                 key,
+                value: item?.[valueKey],
                 ...item
             }));
     }
     function getLabel(value) {
-        const targetItem = list.find((item)=>item.value === value);
+        const targetItem = list.find((item)=>// 如果 list 項目內含有 valueKey 對應欄位，優先以該欄位比對；否則以 value 欄位比對
+            valueKey in item ? item[valueKey] === value : item.value === value);
         if (!targetItem) return String(value);
         if ('label' in targetItem) return targetItem.label;
         return String(value);
     }
+    if (name) {
+        // 命名版：使用 Enum${name}, ${name}List, get${name}Label 鍵名
+        return {
+            [`Enum${name}`]: Enum,
+            [`${name}List`]: list,
+            [`get${name}Label`]: getLabel
+        };
+    }
+    // 未命名：提供預設鍵名 Enum, List, getLabel
     return {
-        [`Enum${name}`]: Enum,
-        [`${name}List`]: list,
-        [`get${name}Label`]: getLabel
+        Enum,
+        List: list,
+        getLabel
     };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gateweb/react-utils",
-  "version": "1.14.1",
+  "version": "1.14.3",
   "description": "React Utils for GateWeb",
   "homepage": "https://github.com/GatewebSolutions/react-utils",
   "files": [