refactor(core): CORE-05 separate typed defaults and resolved options

packages/artplayer/src/option/defaults.ts

@@ -0,0 +1,75 @@
+import type { ResolvedOption } from './types'
+import { isSafari } from '../utils/compatibility'
+
+export default function createDefaults(): ResolvedOption {
+  return {
+    id: '',
+    container: '#artplayer',
+    url: '',
+    poster: '',
+    type: '',
+    theme: '#f00',
+    volume: 0.7,
+    isLive: false,
+    muted: false,
+    autoplay: false,
+    autoSize: false,
+    autoMini: false,
+    loop: false,
+    flip: false,
+    playbackRate: false,
+    aspectRatio: false,
+    screenshot: false,
+    setting: false,
+    hotkey: true,
+    pip: false,
+    mutex: true,
+    backdrop: true,
+    fullscreen: false,
+    fullscreenWeb: false,
+    subtitleOffset: false,
+    miniProgressBar: false,
+    useSSR: false,
+    playsInline: true,
+    lock: false,
+    gesture: true,
+    fastForward: false,
+    autoPlayback: false,
+    autoOrientation: false,
+    airplay: false,
+    proxy: undefined,
+    layers: [],
+    contextmenu: [],
+    controls: [],
+    settings: [],
+    quality: [],
+    highlight: [],
+    plugins: [],
+    thumbnails: {
+      url: '',
+      number: 60,
+      column: 10,
+      width: 0,
+      height: 0,
+      scale: 1,
+    },
+    subtitle: {
+      url: '',
+      type: '',
+      style: {},
+      name: '',
+      escape: true,
+      encoding: 'utf-8',
+      onVttLoad: vtt => vtt,
+    },
+    moreVideoAttr: {
+      controls: false,
+      preload: isSafari ? 'auto' : 'metadata',
+    },
+    i18n: {},
+    icons: {},
+    cssVar: {},
+    customType: {},
+    lang: navigator?.language.toLowerCase(),
+  }
+}

packages/artplayer/src/option/resolve.ts

@@ -0,0 +1,11 @@
+import type { Option, ResolvedInput, ResolvedOption } from './types'
+import validator from 'option-validator'
+import scheme from '../scheme'
+import { mergeDeep } from '../utils/property'
+
+export default function resolveOption<Input extends Option>(input: Input, defaults: ResolvedOption): ResolvedInput<Input> {
+  const merged = mergeDeep(defaults, input)
+  merged.container = input.container
+  // Keep the existing runtime validator. It checks the known schema, not extension data.
+  return validator(merged, scheme) as ResolvedInput<Input>
+}

packages/artplayer/src/option/types.ts

@@ -0,0 +1,13 @@
+import type { Option, Thumbnails } from '../../types/option'
+import type { Subtitle } from '../../types/subtitle'
+
+export type { Option } from '../../types/option'
+
+// A successfully merged typed input, not a general guard for arbitrary JS objects.
+export interface ResolvedOption extends Omit<Required<Option>, 'proxy' | 'subtitle' | 'thumbnails'> {
+  proxy: Option['proxy']
+  subtitle: Required<Subtitle>
+  thumbnails: Required<Thumbnails>
+}
+
+export type ResolvedInput<Input extends Option> = ResolvedOption & Omit<Input, keyof Option>