refactor(ads): [PKG-ADS-04] reconcile public types and historical imports

packages/artplayer-plugin-ads/src/index.ts

@@ -4,7 +4,7 @@ import { normalizeOptions } from './options'
 import { createSession } from './session'
 import style from './style.less?inline'
 
-export default function artplayerPluginAds(input?: Input) {
+function artplayerPluginAds(input?: Input) {
   return (art: Artplayer): Result => {
     // Legacy core declarations type instance.constructor as Function. Check the
     // actual capabilities before using its existing static validator/utilities.
@@ -17,6 +17,8 @@ export default function artplayerPluginAds(input?: Input) {
   }
 }
 
+export default Object.assign(artplayerPluginAds, { default: artplayerPluginAds })
+
 if (typeof document !== 'undefined' && !document.getElementById('artplayer-plugin-ads')) {
   const element = document.createElement('style')
   element.id = 'artplayer-plugin-ads'

packages/artplayer-plugin-ads/src/options.ts

@@ -2,6 +2,8 @@ import type Artplayer from 'artplayer'
 import type { Input, Options } from './types'
 
 export function normalizeOptions(input: Input | undefined, validate: typeof Artplayer.validator): Options {
+  // The legacy declaration accepts strings, but this unchanged validator proves
+  // numeric runtime durations before the result crosses the declaration boundary.
   return validate({
     html: '',
     video: '',
@@ -24,5 +26,5 @@ export function normalizeOptions(input: Input | undefined, validate: typeof Artp
     totalDuration: 'number',
     muted: '?boolean',
     i18n: { close: 'string', countdown: 'string', detail: 'string', canBeClosed: 'string' },
-  })
+  }) as Options
 }

packages/artplayer-plugin-ads/src/types.ts

@@ -1,31 +1,18 @@
 import type Artplayer from 'artplayer'
+import type { CompatOption, Option, Result as PublicResult, Translations as PublicTranslations } from '../types/artplayer-plugin-ads'
 
-export interface Translations {
-  close: string
-  countdown: string
-  detail: string
-  canBeClosed: string
-}
+export type Translations = PublicTranslations
 
-export interface Options {
-  html?: string
-  video?: string
-  url?: string
+export interface Options extends Option {
   playDuration: number
   totalDuration: number
-  muted?: boolean
   i18n: Translations
 }
 
-export type Input = Partial<Options>
+export type Input = CompatOption
 export type Host = Pick<Artplayer, 'on' | 'off' | 'emit' | 'play' | 'pause' | 'template' | 'icons' | 'fullscreen' | 'isDestroy'>
 export type Utilities = Pick<typeof Artplayer.utils, 'append' | 'query' | 'setStyle'>
 export type Icons = Pick<Artplayer['icons'], 'volume' | 'volumeClose' | 'fullscreenOn' | 'fullscreenOff' | 'loading'>
 export type Cleanup = () => void
 
-export interface Result {
-  name: 'artplayerPluginAds'
-  skip: Cleanup
-  pause: Cleanup
-  play: Cleanup
-}
+export type Result = PublicResult