feat(types): DecoratorTarget

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

src/types/__tests__/decorator-target.spec-d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file Type Tests - DecoratorTarget
+ * @module tutils/types/tests/unit-d/DecoratorTarget
+ */
+
+import type AbstractConstructor from '../constructor-abstract'
+import type TestSubject from '../decorator-target'
+import type Objectify from '../objectify'
+
+describe('unit-d:types/DecoratorTarget', () => {
+  it('should extract AbstractConstructor<any>', () => {
+    expectTypeOf<TestSubject>()
+      .extract<AbstractConstructor<any>>()
+      .not.toBeNever()
+  })
+
+  it('should extract Objectify<any>', () => {
+    expectTypeOf<TestSubject>()
+      .exclude<AbstractConstructor<any>>()
+      .toEqualTypeOf<Objectify<any>>()
+  })
+})

src/types/decorator-target.ts

@@ -0,0 +1,16 @@
+/**
+ * @file Type Definitions - MethodDecorator
+ * @module tutils/types/MethodDecorator
+ */
+
+import type AbstractConstructor from './constructor-abstract'
+import type Objectify from './objectify'
+
+/**
+ * A class declaration or prototype passed as a decorator target.
+ *
+ * @see https://mirone.me/a-complete-guide-to-typescript-decorator
+ */
+type DecoratorTarget = AbstractConstructor<any> | Objectify<any>
+
+export type { DecoratorTarget as default }

src/types/index.ts

@@ -17,6 +17,7 @@ export type { default as Constructor } from './constructor'
 export type { default as AbstractConstructor } from './constructor-abstract'
 export type { default as ContinuousValue } from './continuous-value'
 export type { default as Crush } from './crush'
+export type { default as DecoratorTarget } from './decorator-target'
 export type { default as Defaults } from './defaults'
 export type { default as Digit } from './digit'
 export type { default as Dot } from './dot'