refactor(ambilight): [PKG-AMBILIGHT-04] preserve published types and dual CommonJS exports

packages/artplayer-plugin-ambilight/.npmignore

@@ -2,4 +2,5 @@ node_modules
 .DS_Store
 yarn.lock
 package-lock.json
-src
+src
+tsconfig.json

packages/artplayer-plugin-ambilight/ARCHITECTURE.md

@@ -2,7 +2,8 @@
 
 Read the frozen published contracts in `refactor/baselines/ambilight-contract.md`
 before changing the public factory or distribution. Source is strict TypeScript;
-the existing public declaration remains the input contract until task 04.
+`types/artplayer-plugin-ambilight.d.ts` owns the public options and result contract.
+The runtime derives its option type from that declaration; do not duplicate it.
 
 | Module | Responsibility |
 | --- | --- |
@@ -42,5 +43,22 @@ and `yarn test:browser test/browser/ambilight-lifecycle.spec.js`. Historical tes
 in `test/ambilight.test.js` and `test/browser/ambilight.spec.js` intentionally retain
 the old failures. Candidate tests must remain separate. The browser suite runs real
 video/canvas with a lexical native RAF observer across published cores 5.1.7/5.4.0
-and candidate core in Chromium/Firefox/WebKit. Proxy/device, packed consumer and
-public type acceptance remain tasks 04-06; see `refactor/ambilight-validation.md`.
+and candidate core in Chromium/Firefox/WebKit. Proxy/device and complete packed
+browser/demo acceptance remain tasks 05-06; see `refactor/ambilight-validation.md`.
+
+Public types merge a callable value with a type-only namespace. An optional first
+overload permits omitted/undefined options; the required final overload preserves
+the published 1.1.0 `Parameters` extraction. Do not reorder these signatures. The
+runtime factory has a self-referencing `default` property to support both historical
+CommonJS forms. `.d.mts`/`.d.cts` forward to the same declaration for the actual ESM/
+CommonJS entry kinds; `typesVersions` supplies `/legacy` to older resolvers. The
+editor global is generated by `yarn build:ts` through the semantic plugin generator.
+
+Run `node --test refactor/scripts/ambilight-types.test.mjs` for public/editor/format
+contracts and `yarn test:ambilight-types-package` for offline tarball installations
+outside the workspace. The latter verifies two actual published plugin archives and
+candidate against the same packed candidate core, five compiler modes plus two
+candidate modes with interop disabled, and ten negative uses. Published 1.1.0 fails
+NodeNext ESM with its old declarations; candidate must not inherit that failure.
+Published 1.0.0 required all option fields; 1.1.0 already made them optional. Current
+inference follows 1.1.0 while retaining valid calls from both generations.

packages/artplayer-plugin-ambilight/README.md

@@ -9,6 +9,23 @@ failures are skipped and retried, allowing a later readable source to recover.
 
 Internal modules and compatibility tests are documented in [ARCHITECTURE.md](ARCHITECTURE.md).
 
+## Usage and TypeScript
+
+```ts
+import type { Option } from 'artplayer-plugin-ambilight'
+import artplayerPluginAmbilight from 'artplayer-plugin-ambilight'
+
+const option: Option = { blur: '50px', opacity: 0.5, frequency: 10, duration: 0.3 }
+// Add to ArtPlayer's plugins option:
+const plugins = [artplayerPluginAmbilight(option)]
+```
+
+Options can be omitted. `require('artplayer-plugin-ambilight')` and the historical
+`require('artplayer-plugin-ambilight').default` refer to the same factory. The
+`/legacy` entry remains available. The historical `zIndex` input is accepted but
+ignored; the grid uses 9. Option fields stay optional as in version 1.1.0; code
+extracting their types should account for `undefined`.
+
 ## Demo
 
 [https://artplayer.org](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-ambilight/index.js&example=ambilight)

packages/artplayer-plugin-ambilight/dist/artplayer-plugin-ambilight.js

@@ -4,4 +4,4 @@
  * (c) 2017-2026 Harvey Zhao
  * Released under the MIT License.
  */
-!function(t,n){"object"===typeof exports&&"undefined"!==typeof module?module.exports=n():"function"==typeof define&&define.amd?(t.artplayerPluginAmbilight=n(),define(function(){return t.artplayerPluginAmbilight})):(t="undefined"!==typeof globalThis?globalThis:t||self).artplayerPluginAmbilight=n()}(this,function(){"use strict";function t(t,n,e){let r="stopped",o=null,i=0,l=!1,u=0;function c(){const s=i,f=()=>"running"===r&&s===i;l=!0;try{const r=performance.now();if(r-u<1e3/t||!n()||!f())return;u=r,e(f)}finally{l=!1,"running"===r&&null===o&&function(){const t=i;try{o=requestAnimationFrame(()=>{"running"===r&&t===i&&(o=null,c())})}catch(n){throw r="stopped",i++,n}}()}}return{start:function(){"stopped"===r&&(r="running",i++,l||c())},stop:function(){if("destroyed"===r)return;r="stopped",i++;const t=o;o=null,null!==t&&cancelAnimationFrame(t)},destroy:function(){if("destroyed"===r)return;r="destroyed",i++;const t=o;o=null,null!==t&&cancelAnimationFrame(t)}}}return function(n={}){return e=>{let r=e,o=e.isDestroy,i=null,l=null,u=null;const c=[],s={name:"artplayerPluginAmbilight",start(){o||u?.start()},stop(){o||u?.stop()}};if(o)return r=null,s;function f(){const t=[u?.destroy,l?.destroy,i?.destroy];u=null,l=null,i=null;const n=[];for(const r of t)try{r?.()}catch(e){n.push(e)}if(n.length)throw n[0]}function a(){if(o)return;o=!0;const t=r;r=null;const n=[];for(const[r,o]of c.splice(0))try{t?.off(r,o)}catch(e){n.push(e)}try{f()}catch(e){n.push(e)}if(n.length)throw n[0]}function d(t,n){c.push([t,n]),r?.on(t,n)}try{if(d("destroy",a),o)return s;const{$video:c}=e.template,h=e.constructor.utils,{blur:y="50px",opacity:p=.5,frequency:g=10,duration:m=.3}=n;if(o)return s;if(i=function(t){const n=t.createElement("div");n.innerHTML=Array.from({length:9}).fill("<div></div>").join("");const e=Array.from(n.children);return{mount:function(r,o,i){if(i()&&(t.addClass(n,"artplayer-plugin-ambilight"),i()&&(r.parentNode.insertBefore(n,r),i()))){t.setStyles(n,{position:"absolute",top:0,left:0,zIndex:9,inset:0,display:"grid",gridTemplateColumns:"1fr 1fr 1fr",gridTemplateRows:"1fr 1fr 1fr"});for(const n of e){if(!i())return;t.setStyles(n,{opacity:o.opacity,filter:`blur(${o.blur})`,transition:`background-color ${o.duration}s ease`})}}},render:function(t,n){for(let r=0;r<t.length;r++){if(!n())return;const o=e[r],i=t[r];o&&void 0!==i&&(o.style.backgroundColor=i)}},destroy:function(){try{n.parentNode?.removeChild(n)}finally{e.length=0}}}}(h),o||i.mount(c,{blur:y,opacity:p,duration:m},()=>!o),o)return f(),s;const b=h.createElement("canvas");if(o)return b.width=0,b.height=0,s;if(l=function(t,n,e){let r;try{r=t.getContext("2d"),t.width=3,t.height=3}catch(l){throw t.width=0,t.height=0,l}let o=!1,i=!1;return{read:function(l){if(o||!l())return null;const u=n.videoWidth,c=n.videoHeight;if(!Number.isFinite(u)||!Number.isFinite(c)||u<=0||c<=0)return null;const s=u/3,f=c/3,a=[];try{if(i){const n=e();if(o||!l())return n.width=0,n.height=0,null;if(r=null,r=(t=n).getContext("2d"),o||!l())return t.width=0,t.height=0,null;t.width=3,t.height=3,i=!1}if(!r)return null;for(let t=0;t<3;t++)for(let e=0;e<3;e++){if(o||!l())return null;if(r.drawImage(n,e*s,t*f,s,f,0,0,1,1),o||!l())return null;const[i,u,c]=r.getImageData(0,0,1,1).data;a.push(`rgb(${i}, ${u}, ${c})`)}return a}catch{return o||(i=!0,t.width=0,t.height=0),null}},destroy:function(){o||(o=!0,t.width=0,t.height=0)}}}(b,c,()=>h.createElement("canvas")),o)return f(),s;u=t(g,()=>Boolean(r?.playing),t=>{const n=l?.read(t);n&&t()&&i?.render(n,t)}),d("ready",s.start),o&&f()}catch(h){try{a()}catch{}try{f()}catch{}throw h}return s}}});
+!function(t,n){"object"===typeof exports&&"undefined"!==typeof module?module.exports=n():"function"==typeof define&&define.amd?(t.artplayerPluginAmbilight=n(),define(function(){return t.artplayerPluginAmbilight})):(t="undefined"!==typeof globalThis?globalThis:t||self).artplayerPluginAmbilight=n()}(this,function(){"use strict";function t(t,n,e){let r="stopped",i=null,o=0,l=!1,u=0;function c(){const s=o,f=()=>"running"===r&&s===o;l=!0;try{const r=performance.now();if(r-u<1e3/t||!n()||!f())return;u=r,e(f)}finally{l=!1,"running"===r&&null===i&&function(){const t=o;try{i=requestAnimationFrame(()=>{"running"===r&&t===o&&(i=null,c())})}catch(n){throw r="stopped",o++,n}}()}}return{start:function(){"stopped"===r&&(r="running",o++,l||c())},stop:function(){if("destroyed"===r)return;r="stopped",o++;const t=i;i=null,null!==t&&cancelAnimationFrame(t)},destroy:function(){if("destroyed"===r)return;r="destroyed",o++;const t=i;i=null,null!==t&&cancelAnimationFrame(t)}}}function n(n={}){return e=>{let r=e,i=e.isDestroy,o=null,l=null,u=null;const c=[],s={name:"artplayerPluginAmbilight",start(){i||u?.start()},stop(){i||u?.stop()}};if(i)return r=null,s;function f(){const t=[u?.destroy,l?.destroy,o?.destroy];u=null,l=null,o=null;const n=[];for(const r of t)try{r?.()}catch(e){n.push(e)}if(n.length)throw n[0]}function a(){if(i)return;i=!0;const t=r;r=null;const n=[];for(const[r,i]of c.splice(0))try{t?.off(r,i)}catch(e){n.push(e)}try{f()}catch(e){n.push(e)}if(n.length)throw n[0]}function d(t,n){c.push([t,n]),r?.on(t,n)}try{if(d("destroy",a),i)return s;const{$video:c}=e.template,h=e.constructor.utils,{blur:y="50px",opacity:p=.5,frequency:g=10,duration:m=.3}=n;if(i)return s;if(o=function(t){const n=t.createElement("div");n.innerHTML=Array.from({length:9}).fill("<div></div>").join("");const e=Array.from(n.children);return{mount:function(r,i,o){if(o()&&(t.addClass(n,"artplayer-plugin-ambilight"),o()&&(r.parentNode.insertBefore(n,r),o()))){t.setStyles(n,{position:"absolute",top:0,left:0,zIndex:9,inset:0,display:"grid",gridTemplateColumns:"1fr 1fr 1fr",gridTemplateRows:"1fr 1fr 1fr"});for(const n of e){if(!o())return;t.setStyles(n,{opacity:i.opacity,filter:`blur(${i.blur})`,transition:`background-color ${i.duration}s ease`})}}},render:function(t,n){for(let r=0;r<t.length;r++){if(!n())return;const i=e[r],o=t[r];i&&void 0!==o&&(i.style.backgroundColor=o)}},destroy:function(){try{n.parentNode?.removeChild(n)}finally{e.length=0}}}}(h),i||o.mount(c,{blur:y,opacity:p,duration:m},()=>!i),i)return f(),s;const b=h.createElement("canvas");if(i)return b.width=0,b.height=0,s;if(l=function(t,n,e){let r;try{r=t.getContext("2d"),t.width=3,t.height=3}catch(l){throw t.width=0,t.height=0,l}let i=!1,o=!1;return{read:function(l){if(i||!l())return null;const u=n.videoWidth,c=n.videoHeight;if(!Number.isFinite(u)||!Number.isFinite(c)||u<=0||c<=0)return null;const s=u/3,f=c/3,a=[];try{if(o){const n=e();if(i||!l())return n.width=0,n.height=0,null;if(r=null,r=(t=n).getContext("2d"),i||!l())return t.width=0,t.height=0,null;t.width=3,t.height=3,o=!1}if(!r)return null;for(let t=0;t<3;t++)for(let e=0;e<3;e++){if(i||!l())return null;if(r.drawImage(n,e*s,t*f,s,f,0,0,1,1),i||!l())return null;const[o,u,c]=r.getImageData(0,0,1,1).data;a.push(`rgb(${o}, ${u}, ${c})`)}return a}catch{return i||(o=!0,t.width=0,t.height=0),null}},destroy:function(){i||(i=!0,t.width=0,t.height=0)}}}(b,c,()=>h.createElement("canvas")),i)return f(),s;u=t(g,()=>Boolean(r?.playing),t=>{const n=l?.read(t);n&&t()&&o?.render(n,t)}),d("ready",s.start),i&&f()}catch(h){try{a()}catch{}try{f()}catch{}throw h}return s}}return Object.assign(n,{default:n})});

packages/artplayer-plugin-ambilight/dist/artplayer-plugin-ambilight.legacy.js

@@ -4,4 +4,4 @@
  * (c) 2017-2026 Harvey Zhao
  * Released under the MIT License.
  */
-!function(t,n){"object"===typeof exports&&"undefined"!==typeof module?module.exports=n():"function"==typeof define&&define.amd?(t.artplayerPluginAmbilight=n(),define(function(){return t.artplayerPluginAmbilight})):(t="undefined"!==typeof globalThis?globalThis:t||self).artplayerPluginAmbilight=n()}(this,function(){"use strict";function t(t,n,e){let r="stopped",o=null,i=0,l=!1,u=0;function c(){const s=i,f=()=>"running"===r&&s===i;l=!0;try{const r=performance.now();if(r-u<1e3/t||!n()||!f())return;u=r,e(f)}finally{l=!1,"running"===r&&null===o&&function(){const t=i;try{o=requestAnimationFrame(()=>{"running"===r&&t===i&&(o=null,c())})}catch(n){throw r="stopped",i++,n}}()}}return{start:function(){"stopped"===r&&(r="running",i++,l||c())},stop:function(){if("destroyed"===r)return;r="stopped",i++;const t=o;o=null,null!==t&&cancelAnimationFrame(t)},destroy:function(){if("destroyed"===r)return;r="destroyed",i++;const t=o;o=null,null!==t&&cancelAnimationFrame(t)}}}return function(n={}){return e=>{let r=e,o=e.isDestroy,i=null,l=null,u=null;const c=[],s={name:"artplayerPluginAmbilight",start(){o||null==u||u.start()},stop(){o||null==u||u.stop()}};if(o)return r=null,s;function f(){const t=[null==u?void 0:u.destroy,null==l?void 0:l.destroy,null==i?void 0:i.destroy];u=null,l=null,i=null;const n=[];for(const r of t)try{null==r||r()}catch(e){n.push(e)}if(n.length)throw n[0]}function a(){if(o)return;o=!0;const t=r;r=null;const n=[];for(const[r,o]of c.splice(0))try{null==t||t.off(r,o)}catch(e){n.push(e)}try{f()}catch(e){n.push(e)}if(n.length)throw n[0]}function d(t,n){c.push([t,n]),null==r||r.on(t,n)}try{if(d("destroy",a),o)return s;const{$video:c}=e.template,h=e.constructor.utils,{blur:y="50px",opacity:p=.5,frequency:g=10,duration:m=.3}=n;if(o)return s;if(i=function(t){const n=t.createElement("div");n.innerHTML=Array.from({length:9}).fill("<div></div>").join("");const e=Array.from(n.children);return{mount:function(r,o,i){if(i()&&(t.addClass(n,"artplayer-plugin-ambilight"),i()&&(r.parentNode.insertBefore(n,r),i()))){t.setStyles(n,{position:"absolute",top:0,left:0,zIndex:9,inset:0,display:"grid",gridTemplateColumns:"1fr 1fr 1fr",gridTemplateRows:"1fr 1fr 1fr"});for(const n of e){if(!i())return;t.setStyles(n,{opacity:o.opacity,filter:`blur(${o.blur})`,transition:`background-color ${o.duration}s ease`})}}},render:function(t,n){for(let r=0;r<t.length;r++){if(!n())return;const o=e[r],i=t[r];o&&void 0!==i&&(o.style.backgroundColor=i)}},destroy:function(){var t;try{null==(t=n.parentNode)||t.removeChild(n)}finally{e.length=0}}}}(h),o||i.mount(c,{blur:y,opacity:p,duration:m},()=>!o),o)return f(),s;const b=h.createElement("canvas");if(o)return b.width=0,b.height=0,s;if(l=function(t,n,e){let r;try{r=t.getContext("2d"),t.width=3,t.height=3}catch(l){throw t.width=0,t.height=0,l}let o=!1,i=!1;return{read:function(l){if(o||!l())return null;const u=n.videoWidth,c=n.videoHeight;if(!Number.isFinite(u)||!Number.isFinite(c)||u<=0||c<=0)return null;const s=u/3,f=c/3,a=[];try{if(i){const n=e();if(o||!l())return n.width=0,n.height=0,null;if(r=null,r=(t=n).getContext("2d"),o||!l())return t.width=0,t.height=0,null;t.width=3,t.height=3,i=!1}if(!r)return null;for(let t=0;t<3;t++)for(let e=0;e<3;e++){if(o||!l())return null;if(r.drawImage(n,e*s,t*f,s,f,0,0,1,1),o||!l())return null;const[i,u,c]=r.getImageData(0,0,1,1).data;a.push(`rgb(${i}, ${u}, ${c})`)}return a}catch(d){return o||(i=!0,t.width=0,t.height=0),null}},destroy:function(){o||(o=!0,t.width=0,t.height=0)}}}(b,c,()=>h.createElement("canvas")),o)return f(),s;u=t(g,()=>Boolean(null==r?void 0:r.playing),t=>{const n=null==l?void 0:l.read(t);n&&t()&&(null==i||i.render(n,t))}),d("ready",s.start),o&&f()}catch(h){try{a()}catch(y){}try{f()}catch(y){}throw h}return s}}});
+!function(t,n){"object"===typeof exports&&"undefined"!==typeof module?module.exports=n():"function"==typeof define&&define.amd?(t.artplayerPluginAmbilight=n(),define(function(){return t.artplayerPluginAmbilight})):(t="undefined"!==typeof globalThis?globalThis:t||self).artplayerPluginAmbilight=n()}(this,function(){"use strict";function t(t,n,e){let r="stopped",i=null,o=0,l=!1,u=0;function c(){const s=o,f=()=>"running"===r&&s===o;l=!0;try{const r=performance.now();if(r-u<1e3/t||!n()||!f())return;u=r,e(f)}finally{l=!1,"running"===r&&null===i&&function(){const t=o;try{i=requestAnimationFrame(()=>{"running"===r&&t===o&&(i=null,c())})}catch(n){throw r="stopped",o++,n}}()}}return{start:function(){"stopped"===r&&(r="running",o++,l||c())},stop:function(){if("destroyed"===r)return;r="stopped",o++;const t=i;i=null,null!==t&&cancelAnimationFrame(t)},destroy:function(){if("destroyed"===r)return;r="destroyed",o++;const t=i;i=null,null!==t&&cancelAnimationFrame(t)}}}function n(n={}){return e=>{let r=e,i=e.isDestroy,o=null,l=null,u=null;const c=[],s={name:"artplayerPluginAmbilight",start(){i||null==u||u.start()},stop(){i||null==u||u.stop()}};if(i)return r=null,s;function f(){const t=[null==u?void 0:u.destroy,null==l?void 0:l.destroy,null==o?void 0:o.destroy];u=null,l=null,o=null;const n=[];for(const r of t)try{null==r||r()}catch(e){n.push(e)}if(n.length)throw n[0]}function a(){if(i)return;i=!0;const t=r;r=null;const n=[];for(const[r,i]of c.splice(0))try{null==t||t.off(r,i)}catch(e){n.push(e)}try{f()}catch(e){n.push(e)}if(n.length)throw n[0]}function d(t,n){c.push([t,n]),null==r||r.on(t,n)}try{if(d("destroy",a),i)return s;const{$video:c}=e.template,h=e.constructor.utils,{blur:y="50px",opacity:p=.5,frequency:g=10,duration:m=.3}=n;if(i)return s;if(o=function(t){const n=t.createElement("div");n.innerHTML=Array.from({length:9}).fill("<div></div>").join("");const e=Array.from(n.children);return{mount:function(r,i,o){if(o()&&(t.addClass(n,"artplayer-plugin-ambilight"),o()&&(r.parentNode.insertBefore(n,r),o()))){t.setStyles(n,{position:"absolute",top:0,left:0,zIndex:9,inset:0,display:"grid",gridTemplateColumns:"1fr 1fr 1fr",gridTemplateRows:"1fr 1fr 1fr"});for(const n of e){if(!o())return;t.setStyles(n,{opacity:i.opacity,filter:`blur(${i.blur})`,transition:`background-color ${i.duration}s ease`})}}},render:function(t,n){for(let r=0;r<t.length;r++){if(!n())return;const i=e[r],o=t[r];i&&void 0!==o&&(i.style.backgroundColor=o)}},destroy:function(){var t;try{null==(t=n.parentNode)||t.removeChild(n)}finally{e.length=0}}}}(h),i||o.mount(c,{blur:y,opacity:p,duration:m},()=>!i),i)return f(),s;const b=h.createElement("canvas");if(i)return b.width=0,b.height=0,s;if(l=function(t,n,e){let r;try{r=t.getContext("2d"),t.width=3,t.height=3}catch(l){throw t.width=0,t.height=0,l}let i=!1,o=!1;return{read:function(l){if(i||!l())return null;const u=n.videoWidth,c=n.videoHeight;if(!Number.isFinite(u)||!Number.isFinite(c)||u<=0||c<=0)return null;const s=u/3,f=c/3,a=[];try{if(o){const n=e();if(i||!l())return n.width=0,n.height=0,null;if(r=null,r=(t=n).getContext("2d"),i||!l())return t.width=0,t.height=0,null;t.width=3,t.height=3,o=!1}if(!r)return null;for(let t=0;t<3;t++)for(let e=0;e<3;e++){if(i||!l())return null;if(r.drawImage(n,e*s,t*f,s,f,0,0,1,1),i||!l())return null;const[o,u,c]=r.getImageData(0,0,1,1).data;a.push(`rgb(${o}, ${u}, ${c})`)}return a}catch(d){return i||(o=!0,t.width=0,t.height=0),null}},destroy:function(){i||(i=!0,t.width=0,t.height=0)}}}(b,c,()=>h.createElement("canvas")),i)return f(),s;u=t(g,()=>Boolean(null==r?void 0:r.playing),t=>{const n=null==l?void 0:l.read(t);n&&t()&&(null==o||o.render(n,t))}),d("ready",s.start),i&&f()}catch(h){try{a()}catch(y){}try{f()}catch(y){}throw h}return s}}return Object.assign(n,{default:n})});

packages/artplayer-plugin-ambilight/dist/artplayer-plugin-ambilight.mjs

@@ -167,11 +167,11 @@ function createAmbilightView(utils) {
     }
   }
   function render(colors, active) {
-    for (let index = 0; index < colors.length; index++) {
+    for (let index2 = 0; index2 < colors.length; index2++) {
       if (!active())
         return;
-      const item = items[index];
-      const color = colors[index];
+      const item = items[index2];
+      const color = colors[index2];
       if (item && color !== void 0)
         item.style.backgroundColor = color;
     }
@@ -299,6 +299,7 @@ function artplayerPluginAmbilight(option = {}) {
     return result;
   };
 }
+const index = Object.assign(artplayerPluginAmbilight, { default: artplayerPluginAmbilight });
 export {
-  artplayerPluginAmbilight as default
+  index as default
 };

packages/artplayer-plugin-ambilight/package.json

@@ -19,19 +19,36 @@
   ],
   "exports": {
     ".": {
-      "types": "./types/artplayer-plugin-ambilight.d.ts",
-      "import": "./dist/artplayer-plugin-ambilight.mjs",
-      "require": "./dist/artplayer-plugin-ambilight.js"
+      "import": {
+        "types": "./types/artplayer-plugin-ambilight.d.mts",
+        "default": "./dist/artplayer-plugin-ambilight.mjs"
+      },
+      "require": {
+        "types": "./types/artplayer-plugin-ambilight.d.cts",
+        "default": "./dist/artplayer-plugin-ambilight.js"
+      }
     },
     "./legacy": {
-      "types": "./types/artplayer-plugin-ambilight.d.ts",
-      "import": "./dist/artplayer-plugin-ambilight.legacy.js",
-      "require": "./dist/artplayer-plugin-ambilight.legacy.js"
+      "import": {
+        "types": "./types/artplayer-plugin-ambilight.d.cts",
+        "default": "./dist/artplayer-plugin-ambilight.legacy.js"
+      },
+      "require": {
+        "types": "./types/artplayer-plugin-ambilight.d.cts",
+        "default": "./dist/artplayer-plugin-ambilight.legacy.js"
+      }
     }
   },
   "main": "./dist/artplayer-plugin-ambilight.js",
   "module": "./dist/artplayer-plugin-ambilight.mjs",
   "types": "./types/artplayer-plugin-ambilight.d.ts",
   "legacy": "./dist/artplayer-plugin-ambilight.legacy.js",
-  "browserslist": "last 1 Chrome version"
+  "browserslist": "last 1 Chrome version",
+  "typesVersions": {
+    "*": {
+      "legacy": [
+        "types/artplayer-plugin-ambilight.d.ts"
+      ]
+    }
+  }
 }

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

@@ -7,7 +7,7 @@ import { createAmbilightView } from './view'
 type Option = Parameters<typeof PublicPlugin>[0]
 type Subscription = ['ready' | 'destroy', () => void]
 
-export default function artplayerPluginAmbilight(option: Option = {}) {
+function artplayerPluginAmbilight(option: Option = {}) {
   return (art: Artplayer) => {
     let host: Artplayer | null = art
     let closed = art.isDestroy
@@ -123,3 +123,5 @@ export default function artplayerPluginAmbilight(option: Option = {}) {
     return result
   }
 }
+
+export default Object.assign(artplayerPluginAmbilight, { default: artplayerPluginAmbilight })

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

@@ -0,0 +1,4 @@
+// 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

@@ -0,0 +1,2 @@
+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,19 +1,40 @@
+/* eslint-disable ts/no-redeclare -- Callable and public type namespace intentionally merge. */
 import type Artplayer from 'artplayer'
 
-interface Option {
-  blur?: string
-  opacity?: number
-  frequency?: number
-  zIndex?: number
-  duration?: number
+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
+  }
 }
 
-interface Result {
-  name: 'artplayerPluginAmbilight'
-  start: () => void
-  stop: () => void
-}
-
-declare const artplayerPluginAmbilight: (option: Option) => (art: Artplayer) => Result
-
-export default artplayerPluginAmbilight
+declare const artplayerPluginAmbilight: artplayerPluginAmbilight.Factory
+export = artplayerPluginAmbilight
+export as namespace artplayerPluginAmbilight