fix(types): [PKG-FACTORY-01] preserve published factory compatibility

packages/artplayer-plugin-ambilight/types/artplayer-plugin-ambilight.d.cts

@@ -1,4 +0,0 @@
-// eslint-disable-next-line ts/no-require-imports -- Preserve the CommonJS export-assignment namespace.
-import artplayerPluginAmbilight = require('./artplayer-plugin-ambilight.js')
-
-export = artplayerPluginAmbilight

packages/artplayer-plugin-ambilight/types/artplayer-plugin-ambilight.d.mts

@@ -1,2 +0,0 @@
-export { default } from './artplayer-plugin-ambilight.js'
-export type { Callable, Factory, Option, Result } from './artplayer-plugin-ambilight.js'

packages/artplayer-plugin-ambilight/types/artplayer-plugin-ambilight.d.ts

@@ -1,40 +1,35 @@
-/* eslint-disable ts/no-redeclare -- Callable and public type namespace intentionally merge. */
 import type Artplayer from 'artplayer'
 
-declare namespace artplayerPluginAmbilight {
-  interface Option {
-    /** CSS blur radius. @default '50px' */
-    blur?: string
-    /** Grid cell opacity. @default 0.5 */
-    opacity?: number
-    /** Maximum sampling frequency in frames per second. @default 10 */
-    frequency?: number
-    /** Historical input retained for compatibility; runtime uses a fixed z-index of 9. */
-    zIndex?: number
-    /** Background color transition duration in seconds. @default 0.3 */
-    duration?: number
-  }
-
-  interface Result {
-    name: 'artplayerPluginAmbilight'
-    /** Start sampling; does nothing after the player is destroyed. */
-    start: () => void
-    /** Stop sampling while retaining the last colors. */
-    stop: () => void
-  }
-
-  interface Callable {
-    (option?: Option): (art: Artplayer) => Result
-    /** Keep Parameters extraction identical to the published 1.1.0 signature. */
-    (option: Option): (art: Artplayer) => Result
-  }
-
-  interface Factory extends Callable {
-    /** Same function, including historical require(package).default calls. */
-    readonly default: Factory
-  }
+export interface Option {
+  /** CSS blur radius. @default '50px' */
+  blur?: string
+  /** Grid cell opacity. @default 0.5 */
+  opacity?: number
+  /** Maximum sampling frequency in frames per second. @default 10 */
+  frequency?: number
+  /** Historical input retained for compatibility; runtime uses a fixed z-index of 9. */
+  zIndex?: number
+  /** Background color transition duration in seconds. @default 0.3 */
+  duration?: number
 }
 
-declare const artplayerPluginAmbilight: artplayerPluginAmbilight.Factory
-export = artplayerPluginAmbilight
-export as namespace artplayerPluginAmbilight
+export interface Result {
+  name: 'artplayerPluginAmbilight'
+  /** Start sampling; does nothing after the player is destroyed. */
+  start: () => void
+  /** Stop sampling while retaining the last colors. */
+  stop: () => void
+}
+
+/** Published 1.1.0 factory shape; the options argument remains required. */
+export type Callable = (option: Option) => (art: Artplayer) => Result
+export type Factory = Callable
+
+/** Accurate optional invocation and CommonJS self alias, exposed by /runtime. */
+export interface RuntimeFactory {
+  (option?: Option): (art: Artplayer) => Result
+  readonly default: RuntimeFactory
+}
+
+declare const artplayerPluginAmbilight: (option: Option) => (art: Artplayer) => Result
+export default artplayerPluginAmbilight

packages/artplayer-plugin-ambilight/types/runtime.d.cts

@@ -0,0 +1,10 @@
+import type { RuntimeFactory } from './artplayer-plugin-ambilight.js'
+
+declare const artplayerPluginAmbilight: RuntimeFactory
+// eslint-disable-next-line ts/no-redeclare -- Ambient merge exposes types on the CommonJS factory.
+declare namespace artplayerPluginAmbilight {
+  type Option = import('./artplayer-plugin-ambilight.js').Option
+  type Result = import('./artplayer-plugin-ambilight.js').Result
+  type RuntimeFactory = import('./artplayer-plugin-ambilight.js').RuntimeFactory
+}
+export = artplayerPluginAmbilight

packages/artplayer-plugin-ambilight/types/runtime.d.mts

@@ -0,0 +1,5 @@
+import type { RuntimeFactory } from './artplayer-plugin-ambilight.js'
+
+declare const artplayerPluginAmbilight: RuntimeFactory
+export default artplayerPluginAmbilight
+export type { Option, Result, RuntimeFactory } from './artplayer-plugin-ambilight.js'

packages/artplayer-plugin-ambilight/types/runtime.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeFactory } from './artplayer-plugin-ambilight.js'
+
+declare const artplayerPluginAmbilight: RuntimeFactory
+// eslint-disable-next-line ts/no-redeclare -- Ambient merge exposes types on the CommonJS factory.
+declare namespace artplayerPluginAmbilight {
+  type Option = import('./artplayer-plugin-ambilight.js').Option
+  type Result = import('./artplayer-plugin-ambilight.js').Result
+  type RuntimeFactory = import('./artplayer-plugin-ambilight.js').RuntimeFactory
+}
+export = artplayerPluginAmbilight