feat(interfaces): ImportAssertions

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

Author: unicornware

src/index.ts

@@ -4,3 +4,4 @@
  */
 
 export * from './enums'
+export * from './interfaces'

src/interfaces/__tests__/import-assertions.spec-d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file Type Tests - ImportAssertions
+ * @module esm-types/interfaces/tests/unit-d/ImportAssertions
+ */
+
+import type { AssertType } from '#src/enums'
+import type { LiteralUnion } from '@flex-development/tutils'
+import type TestSubject from '../import-assertions'
+
+describe('unit-d:interfaces/ImportAssertions', () => {
+  it('should allow empty object', () => {
+    assertType<TestSubject>({})
+  })
+
+  it('should allow only string values', () => {
+    expectTypeOf<TestSubject[string]>().toBeString()
+  })
+
+  it('should match [type?: LiteralUnion<AssertType, string>]', () => {
+    expectTypeOf<TestSubject>()
+      .toHaveProperty('type')
+      .toEqualTypeOf<LiteralUnion<AssertType, string> | undefined>()
+  })
+})

src/interfaces/import-assertions.ts

@@ -0,0 +1,24 @@
+/**
+ * @file Interfaces - ImportAssertions
+ * @module esm-types/interfaces/ImportAssertions
+ */
+
+import type { AssertType } from '#src/enums'
+import type { LiteralUnion } from '@flex-development/tutils'
+
+/**
+ * `import` assertions schema.
+ *
+ * @see {@linkcode AssertType}
+ * @see https://github.com/tc39/proposal-import-assertions
+ */
+interface ImportAssertions {
+  [key: string]: string
+
+  /**
+   * Assertion type.
+   */
+  type?: LiteralUnion<AssertType, string>
+}
+
+export type { ImportAssertions as default }

src/interfaces/index.ts

@@ -0,0 +1,6 @@
+/**
+ * @file Entry Point - Interfaces
+ * @module esm-types/interfaces
+ */
+
+export type { default as ImportAssertions } from './import-assertions'