feat(types): TypesVersions

Signed-off-by: Lexus Drumgold <[email protected]>

.eslintrc.cjs

@@ -11,7 +11,15 @@
 const config = {
   root: true,
   extends: ['./.eslintrc.base.cjs'],
-  overrides: [...require('./.eslintrc.base.cjs').overrides]
+  overrides: [
+    ...require('./.eslintrc.base.cjs').overrides,
+    {
+      files: ['./src/types/__tests__/types-versions.spec-d.ts'],
+      rules: {
+        'sort-keys': 0
+      }
+    }
+  ]
 }
 
 module.exports = config

src/index.ts

@@ -3,4 +3,4 @@
  * @module pkg-types
  */
 
-export {}
+export * from './types'

src/types/__tests__/types-versions.spec-d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file Unit Tests - TypesVersions
+ * @module pkg-types/types/tests/TypesVersions
+ */
+
+import type TestSubject from '../types-versions'
+
+describe('unit:types/TypesVersions', () => {
+  it('should allow empty object', () => {
+    assertType<TestSubject>({})
+  })
+
+  it('should allow object with version mappings', () => {
+    assertType<TestSubject>({
+      '>=4.0': { '*': ['ts4.0/*'] },
+      '>=3.2': { '*': ['ts3.2/*'] },
+      '>=3.1': { '*': ['ts3.1/*'] }
+    })
+  })
+})

src/types/index.ts

@@ -0,0 +1,6 @@
+/**
+ * @file Entry Point - Type Definitions
+ * @module tsconfig-types/types
+ */
+
+export type { default as TypesVersions } from './types-versions'

src/types/types-versions.ts

@@ -0,0 +1,13 @@
+/**
+ * @file Type Definitions - TypesVersions
+ * @module pkg-types/types/TypesVersions
+ */
+
+/**
+ * TypeScript version selection map.
+ *
+ * @see https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html#version-selection-with-typesversions
+ */
+type TypesVersions = Partial<Record<string, Partial<Record<string, string[]>>>>
+
+export type { TypesVersions as default }