feat(types): Engine

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Author: unicornware

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

@@ -0,0 +1,20 @@
+/**
+ * @file Unit Tests - Engine
+ * @module pkg-types/types/tests/Engine
+ */
+
+import type TestSubject from '../engine'
+
+describe('unit:types/Engine', () => {
+  it('should allow "node"', () => {
+    assertType<TestSubject>('node')
+  })
+
+  it('should allow "npm"', () => {
+    assertType<TestSubject>('npm')
+  })
+
+  it('should allow "yarn"', () => {
+    assertType<TestSubject>('yarn')
+  })
+})

src/types/engine.ts

@@ -0,0 +1,15 @@
+/**
+ * @file Type Definitions - Engine
+ * @module pkg-types/types/Engine
+ */
+
+import type { LiteralUnion } from '@flex-development/tutils'
+
+/**
+ * Engines a package runs on.
+ *
+ * @see https://docs.npmjs.com/cli/configuring-npm/package-json#engines
+ */
+type Engine = LiteralUnion<'node' | 'npm' | 'yarn', string>
+
+export type { Engine as default }

src/types/index.ts

@@ -5,6 +5,7 @@
 
 export type { default as Access } from './access'
 export type { default as CPU } from './cpu'
+export type { default as Engine } from './engine'
 export type { default as HoistingLimits } from './hoisiting-limits'
 export type { default as Type } from './type'
 export type { default as TypesVersions } from './types-versions'