refactor(vtt-thumbnail): [PKG-VTT-THUMB-04] preserve legacy types and expose async runtime entry

test/types/vtt-thumbnail-public.ts

@@ -0,0 +1,45 @@
+import type { Factory, Option, Result, RuntimeFactory } from 'artplayer-plugin-vtt-thumbnail'
+import Artplayer from 'artplayer'
+import legacy from 'artplayer-plugin-vtt-thumbnail'
+import legacyEntry from 'artplayer-plugin-vtt-thumbnail/legacy'
+import runtime from 'artplayer-plugin-vtt-thumbnail/runtime'
+
+type Equal<A, B> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? true : false
+type Assert<T extends true> = T
+type ExactOptions = Assert<Equal<Parameters<typeof legacy>, [option: Option]>>
+type ExactFactory = Assert<Equal<typeof legacy, Factory>>
+type ExactResult = Assert<Equal<ReturnType<ReturnType<typeof legacy>>, Result>>
+type ActualResult = Assert<Equal<ReturnType<ReturnType<typeof runtime>>, Promise<Result>>>
+
+const option: Option = { vtt: '/cues.vtt', style: { opacity: '0.8' } }
+const art = new Artplayer({ container: '#player', url: '/video.mp4', plugins: [legacy(option), runtime(option)] })
+const old: Result = legacy(option)(art)
+const oldReplacement: typeof legacy = (_option: Option) => (_art: Artplayer) => ({ name: 'artplayerPluginVttThumbnail' })
+legacyEntry(option)
+const factory: RuntimeFactory = runtime
+const pending: Promise<Result> = factory(option)(art)
+const alias: Promise<Result> = factory.default.default(option)(art)
+factory.default = runtime
+const awaitedName: Promise<'artplayerPluginVttThumbnail'> = pending.then(result => result.name)
+// @ts-expect-error Published extraction keeps the option object required.
+const absent: Parameters<typeof legacy>[0] = undefined
+// @ts-expect-error Root declarations preserve historical synchronous extraction.
+const changed: Promise<Result> = old
+// @ts-expect-error Runtime entry does not invent a synchronous result field.
+void pending.name
+// @ts-expect-error Runtime options remain required.
+runtime()
+// @ts-expect-error Required option object is not undefined.
+runtime(undefined)
+// @ts-expect-error URL remains a string.
+runtime({ vtt: 1 })
+// @ts-expect-error CSS width remains a string.
+runtime({ style: { width: 80 } })
+// @ts-expect-error Unknown options are not silently accepted.
+runtime({ unknown: true })
+// @ts-expect-error A host is required.
+runtime({})()
+// @ts-expect-error The runtime entry cannot be replaced with a synchronous registrar.
+const wrong: typeof runtime = oldReplacement
+void [alias, awaitedName, absent, changed, wrong]
+export type { ActualResult, ExactFactory, ExactOptions, ExactResult }