feat: support typesVersions

Author: shijistar

.gitignore

@@ -4,6 +4,7 @@ es-legacy
 umd
 tslib
 tses
+types-legacy/*/**
 node_modules
 npm-debug.log
 e2e/fixtures/scripts

package.json

@@ -1,6 +1,6 @@
 {
   "name": "enum-plus",
-  "version": "3.0.0-alpha.3",
+  "version": "3.0.0-alpha.4",
   "description": "A drop-in replacement for native enum. Like native enum but much better!",
   "keywords": [
     "enum",
@@ -45,12 +45,19 @@
       "browser-legacy": "./es-legacy/index.js",
       "default": "./lib/index.js"
     },
-    "./enum-collection": {
-      "types": "./lib/enum-collection.d.ts",
-      "import": "./es/enum-collection.js",
-      "require": "./lib/enum-collection.js",
-      "browser-legacy": "./es-legacy/enum-collection.js",
-      "default": "./lib/enum-collection.js"
+    "./enum": {
+      "types": "./lib/enum.d.ts",
+      "import": "./es/enum.js",
+      "require": "./lib/enum.js",
+      "browser-legacy": "./es-legacy/enum.js",
+      "default": "./lib/enum.js"
+    },
+    "./enum-items": {
+      "types": "./lib/enum-items.d.ts",
+      "import": "./es/enum-items.js",
+      "require": "./lib/enum-items.js",
+      "browser-legacy": "./es-legacy/enum-items.js",
+      "default": "./lib/enum-items.js"
     },
     "./enum-item": {
       "types": "./lib/enum-item.d.ts",
@@ -59,22 +66,66 @@
       "browser-legacy": "./es-legacy/enum-item.js",
       "default": "./lib/enum-item.js"
     },
+    "./utils": {
+      "types": "./lib/utils.d.ts",
+      "import": "./es/utils.js",
+      "require": "./lib/utils.js",
+      "browser-legacy": "./es-legacy/utils.js",
+      "default": "./lib/utils.js"
+    },
+    "./localize-interface": {
+      "types": "./lib/localize-interface.d.ts",
+      "import": "./es/localize-interface.js",
+      "require": "./lib/localize-interface.js",
+      "browser-legacy": "./es-legacy/localize-interface.js",
+      "default": "./lib/localize-interface.js"
+    },
     "./es-legacy": {
       "types": "./es-legacy/index.d.ts",
       "import": "./es-legacy/index.js",
       "require": "./es-legacy/index.js",
       "default": "./es-legacy/index.js"
     },
     "./types": "./lib/types.d.ts",
+    "./extension": "./lib/extension.d.ts",
     "./package.json": "./package.json"
   },
   "main": "lib/index.js",
   "module": "es-legacy/index.js",
   "types": "lib/index.d.ts",
+  "typesVersions": {
+    "<5.0": {
+      ".": [
+        "./lib/index.d.ts"
+      ],
+      "./enum": [
+        "./types-legacy/pre-v5/enum.d.ts"
+      ],
+      "./enum-items": [
+        "./lib/enum-items.d.ts"
+      ],
+      "./enum-item": [
+        "./lib/enum-item.d.ts"
+      ],
+      "./utils": [
+        "./lib/utils.d.ts"
+      ],
+      "./localize-interface": [
+        "./lib/localize-interface.d.ts"
+      ],
+      "./types": [
+        "./lib/types.d.ts"
+      ],
+      "./extension": [
+        "./lib/extension.d.ts"
+      ]
+    }
+  },
   "files": [
     "lib",
     "es",
     "es-legacy",
+    "types-legacy",
     "umd",
     "LICENSE",
     "CHANGELOG.md",
@@ -89,7 +140,7 @@
     "build": "run-p build:*",
     "build:es": "run-s task:build-es task:add-umd-banner task:add-es-extensions",
     "build:es-legacy": "cross-env LEGACY=1 run-s task:build-es-legacy task:add-umd-banner task:add-es-legacy-extensions",
-    "build:lib": "run-s ts2lib task:copy-dts task:copy-lib",
+    "build:lib": "run-s ts2lib task:copy-lib task:copy-dts task:types-legacy",
     "build:tses": "run-s ts2es task:add-tses-extensions",
     "e2e": "run-s task:bundle-e2e task:run-e2e",
     "e2e:debug": "run-s task:bundle-e2e task:run-e2e-debug",
@@ -106,6 +157,7 @@
     "task:bundle-e2e": "tsx scripts/make-e2e-bundle.ts",
     "task:copy-dts": "shx cp ./src/*.d.ts ./lib",
     "task:copy-lib": "tsx scripts/copy-lib.ts",
+    "task:types-legacy": "tsx scripts/gen-legacy-type.ts",
     "task:jest": "jest --coverage",
     "task:jest-cjs": "jest --coverage -c jest-cjs.config.js",
     "task:jest-esm": "jest --coverage -c jest-esm.config.js",
@@ -118,12 +170,6 @@
     "ts2es": "tsc -p tsconfig.es.json",
     "ts2lib": "tsc -p tsconfig.lib.json"
   },
-  "overrides": {
-    "@umijs/babel-preset-umi": {
-      "@babel/runtime": "^7.27.1"
-    },
-    "esbuild": "^0.25.4"
-  },
   "devDependencies": {
     "@playwright/test": "^1.52.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
@@ -150,5 +196,11 @@
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
+  },
+  "overrides": {
+    "@umijs/babel-preset-umi": {
+      "@babel/runtime": "^7.27.1"
+    },
+    "esbuild": "^0.25.4"
   }
 }

scripts/gen-legacy-type.ts

@@ -0,0 +1,4 @@
+import { readFileSync, writeFileSync } from 'fs';
+
+const enumDeclaration = readFileSync('./tslib/src/enum.d.ts', 'utf-8');
+writeFileSync('./types-legacy/pre-v5/enum.d.ts', enumDeclaration.replace(/const\s+(\w+\s+extends)/g, '$1'));

src/enum-collection.ts

@@ -1,8 +1,8 @@
 import type { EnumExtension } from 'enum-plus-extend';
 import type { EnumItemOptions } from './enum-item';
 import { EnumItemClass } from './enum-item';
-import type { IEnumItems, ToListConfig } from './enum-values';
-import { EnumItemsArray } from './enum-values';
+import type { IEnumItems, ToListConfig } from './enum-items';
+import { EnumItemsArray } from './enum-items';
 import { localizer } from './localize';
 import type {
   ColumnFilterItem,
@@ -30,6 +30,7 @@ export class EnumExtensionClass<
   K extends EnumKey<T> = EnumKey<T>,
   V extends EnumValue = ValueTypeFromSingleInit<T[K], K>,
 > implements EnumExtension<T, K, V> {}
+
 /**
  * - **EN:** Enum collection
  * - **CN:** 枚举项集合

src/enum-values.ts src/enum-items.tssrc/enum-values.ts renamed to src/enum-items.ts

@@ -1,7 +1,7 @@
 import type { EnumExtension } from 'enum-plus-extend';
 import { EnumCollectionClass, EnumExtensionClass } from './enum-collection';
 import type { EnumItemClass, EnumItemOptions } from './enum-item';
-import type { IEnumItems } from './enum-values';
+import type { IEnumItems } from './enum-items';
 import { localizer } from './localize';
 import type {
   ArrayToMap,

src/enum.ts

@@ -11,7 +11,7 @@ export type {
   ArrayToMap,
 } from './types';
 export type { LocalizeInterface } from './localize-interface';
-export type { ToListConfig, IEnumItems } from './enum-values';
+export type { ToListConfig, IEnumItems } from './enum-items';
 export type { EnumItemClass, EnumItemOptions } from './enum-item';
 export type { IEnum, EnumInterface, EnumInitOptions } from './enum';
 

src/index.ts

@@ -5,5 +5,5 @@
     // ensure that nobody can accidentally use this config for a build
     "noEmit": true
   },
-  "include": ["src", "scripts", "test", "e2e", "packages", "*.ts", ".*.ts"]
+  "include": ["src", "scripts", "test", "e2e", "tslib", "tses", "types-legacy", "packages", "*.ts", ".*.ts"]
 }

tsconfig.eslint.json

@@ -31,5 +31,5 @@
     }
   },
   "include": ["src", "scripts", "test", "test-browser", "*.ts", ".*.ts"],
-  "exclude": ["node_modules", "es", "es-legacy", "lib", "tslib"]
+  "exclude": ["node_modules", "es", "es-legacy", "lib", "tslib", "tses", "types-legacy"]
 }