fix(dpip): [PKG-DPIP-04] preserve factory type and export compatibility

packages/artplayer-plugin-document-pip/ARCHITECTURE.md

@@ -3,8 +3,14 @@
 The public factory still returns a synchronous plugin initializer. Its result has
 `name`, readonly runtime getters `isSupported`/`isActive`, async `open`/`close`
 returning `Promise<void>`, and synchronous `toggle` returning `undefined`.
-The published declarations currently describe void actions and writable flags;
-public declaration compatibility is tracked separately in PKG-DPIP-04.
+The public `Result` preserves published void actions and writable flags for legacy
+assignments. `AsyncResult` is an opt-in precise view for an unmodified runtime
+result, and the implementation is checked against it. The default factory keeps
+its exact published required-argument signature, including plain replacement
+function assignments. RuntimeFactory explicitly describes omitted options and
+self `.default` access. `.d.mts` and `.d.cts` wrappers map ESM/CJS consumers; old resolvers
+use the base declaration and legacy typesVersions path. A self `.default` alias
+supports the two historical runtime export shapes without adding named exports.
 
 | File | Responsibility |
 | --- | --- |
@@ -68,5 +74,7 @@ file for browser verification and never silently falls back to source.
 The iframe matrix uses real DOM with controlled window APIs. It does not prove
 native Document PiP activation, window focus/keyboard, continuous playback or
 device support. Native video/Canvas/Mediabunny combinations and the observed
-WebKit dimension reports remain PKG-DPIP-05. Full archive/demo/type acceptance is
-PKG-DPIP-04/06. See the repository `refactor/dpip-validation.md` for exact evidence.
+WebKit dimension reports remain PKG-DPIP-05. Full archive/demo acceptance is
+PKG-DPIP-06. Installed type consumers are verified by `yarn test:dpip-types-package`;
+historical missing runtime/type entry errors are exact negative cases, not waived
+candidate failures. See the repository `refactor/dpip-validation.md` for evidence.

packages/artplayer-plugin-document-pip/README.md

@@ -6,6 +6,59 @@ Document PIP plugin for ArtPlayer
 
 [https://artplayer.org](https://artplayer.org/?libs=./uncompiled/artplayer-plugin-document-pip/index.js&example=document.pip)
 
+## TypeScript and module formats
+
+```ts
+import Artplayer from 'artplayer'
+import type { AsyncResult } from 'artplayer-plugin-document-pip'
+import documentPip from 'artplayer-plugin-document-pip'
+
+const art = new Artplayer({
+  container: '#player',
+  url: 'video.mp4',
+  plugins: [documentPip({ width: 480, height: 270 })],
+})
+
+// Use this view for an unmodified plugin result when precise Promise types are needed.
+const pip = art.plugins.artplayerPluginDocumentPip as AsyncResult
+await pip.open()
+await pip.close()
+```
+
+At runtime, options may be omitted. Width and height default to 480 and 270, and
+`fallbackToVideoPiP` defaults to true. `placeholder` sets the text left in the
+original player container while its document window is active.
+
+The default `Result` retains the published writable boolean fields and void
+actions so old assignments and inferred initializer types still compile.
+At runtime, `isSupported` and `isActive` are readonly getters, `open` and `close`
+return `Promise<void>`, and `toggle` returns `undefined`. The opt-in `AsyncResult`
+describes those runtime values; it should not be applied to a mock or a result
+whose methods have been replaced. It does not change any runtime behavior.
+
+The default factory declaration keeps the exact published required-argument
+signature, including assignment of an old replacement function to `typeof
+documentPip`. Automatically adding an optional overload or a required `.default`
+property would break such assignments. `Option`, `Result`, `AsyncResult`, `Factory`
+and `RuntimeFactory` are available as named types. Use the explicit runtime view
+to type omitted options, self `.default` access and precise async results:
+
+```ts
+import type { RuntimeFactory } from 'artplayer-plugin-document-pip'
+const runtimeFactory = documentPip as RuntimeFactory
+runtimeFactory() // precise initializer for the unmodified runtime factory
+```
+
+ESM uses the default import. CommonJS supports both `require(package)(options)`
+and the historical `require(package).default(options)` shape; `.default` is the
+same factory. The `/legacy` entry and generated browser editor declarations have
+matching types. These syntax targets do not add native Document PiP support to
+browsers that lack the API.
+
+The historical TypeScript `import plugin = require(package)` module view retains
+`plugin.default(options)`. Direct CommonJS calls are available at runtime; use
+`RuntimeFactory` for an explicitly typed direct-call view.
+
 ## Maintenance
 
 Source is split into strict TypeScript modules for window ownership, DOM migration,

packages/artplayer-plugin-document-pip/dist/artplayer-plugin-document-pip.js

@@ -4,4 +4,4 @@
  * (c) 2017-2026 Harvey Zhao
  * Released under the MIT License.
  */
-!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(e.artplayerPluginDocumentPip=t(),define(function(){return e.artplayerPluginDocumentPip})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerPluginDocumentPip=t()}(this,function(){"use strict";function e(e){const t=[];for(const o of e)try{o()}catch(n){t.push(n)}return t}const t=".artplayer-document-pip.art-video-player{width:100%!important;height:100%!important}";function n(t){let n=!1,o=0,i=null,r=null,c=null;const l=()=>!n&&t.alive(),s=e=>e===o&&l();function u(){o++,r?.finish(),r=null,c?.cancel(),c=null}function a(t){const n=e(t.releases.splice(0));return n.push(...e([()=>t.window.close()])),n}async function d(e){if(!s(e))return;const n=function(){let e;const t=new Promise(t=>{e=t});let n=setTimeout(()=>{n=null,e()},100);return{promise:t,cancel(){null!==n&&clearTimeout(n),n=null,e()}}}();c=n,await n.promise,c===n&&(c=null),s(e)&&t.resize()}async function p(){u();const e=o,n=i;if(i=null,!n)return;const r=a(n);if(n.announced)try{t.activate(!1)}catch(c){r.push(c)}r.length&&l()&&t.report("close",r[0]),s(e)&&await d(e)}return{get active(){return null!==i},get opening(){return null!==r},open:async function(){if(!l()||i)return;if(r)return r.promise;u();const n=o;let c,f;const m=new Promise((e,t)=>{c=e,f=t}),h={promise:m,finish:c};r=h;const y=()=>{r===h&&(r=null),c()},g=o=>{if(s(n)){const n=i;i=null,n&&(a(n),n.announced&&e([()=>t.activate(!1)]));try{t.report("open",o)}catch(r){f(r)}}},v=async o=>{if(!s(n))return void(i?.window!==o&&e([()=>o.close()]));const r={window:o,releases:[],announced:!1};i=r;try{const e=t.project(o.document);if(r.releases.push(e.destroy),e.mount(),!s(n))return void a(r);for(const[i,c]of[["resize",()=>{s(n)&&t.nativeResize()}],["pagehide",()=>{p()}],["unload",()=>{p()}]])if(r.releases.unshift(()=>o.removeEventListener(i,c)),o.addEventListener(i,c),!s(n))return void a(r);r.announced=!0,t.activate(!0),await d(n)}catch(c){g(c)}};try{const e=t.request();Promise.resolve(e).then(v,g).then(y,e=>{s(n)&&f(e),y()})}catch(w){try{g(w)}finally{y()}}return m},close:p,destroy(){n||(n=!0,p().catch(()=>{}))}}}return"undefined"!==typeof document&&function(e){const n="artplayer-plugin-document-pip",o=e.getElementById(n);if(o)return void(o.textContent=t);const i=e.createElement("style");i.id=n,i.textContent=t;const r=()=>{e.removeEventListener("DOMContentLoaded",r);const o=e.getElementById(n);o?o.textContent=t:(e.head||e.documentElement).appendChild(i)};"loading"===e.readyState?e.addEventListener("DOMContentLoaded",r):r()}(document),function(t={}){const o={width:480,height:270,fallbackToVideoPiP:!0,placeholder:"Playing in Document Picture-in-Picture",...t};return t=>{const i=window,r="documentPictureInPicture"in i&&"function"===typeof i.documentPictureInPicture?.requestWindow;let c=t,l=t.template.$player,s=t.isDestroy;const u=t.constructor.utils,a=()=>!s&&!!c&&!c.isDestroy,d=n({alive:a,request:()=>i.documentPictureInPicture.requestWindow({width:o.width,height:o.height}),project:t=>function(t,n,o){const i=t.ownerDocument,r=t.parentNode,c=t.nextSibling;if(!r)throw new Error("Document Picture-in-Picture requires a mounted player");const l=i.createElement("div");l.className="artplayer-document-pip-placeholder",l.style.cssText="display:flex;justify-content:center;align-items:center;width:100%;height:100%;",l.textContent=o??"";const s=n.createElement("div");s.id="__art_dpip_root";const u=[];let a=!1;const d=()=>{const e=l.parentNode===r?l:c?.parentNode===r?c:null;if(t.parentNode!==r||t.nextSibling!==e)try{r.insertBefore(t,e)}catch(n){throw i.body.appendChild(t),n}},p=()=>{const t=e([d,()=>l.remove(),...u.splice(0).map(e=>()=>e.remove()),()=>s.remove()]);if(t.length)throw t[0]};return{mount(){if(!a){if(r.insertBefore(l,c?.parentNode===r?c:null),a||n.body.appendChild(s),a||function(e,t,n,o){const i=e=>{o()&&(n(e),t.head.appendChild(e),o()||e.remove())},r=t.createElement("style");if(r.textContent="\n    html, body { margin:0; padding:0; width:100%; height:100%; background:#000; overflow:hidden; }\n    #__art_dpip_root { position:absolute; inset:0; display:flex; }\n    #__art_dpip_root > * { width:100% !important; height:100% !important; }\n  ",i(r),!t.querySelector('meta[name="viewport"]')){const e=t.createElement("meta");e.name="viewport",e.content="width=device-width,initial-scale=1",i(e)}try{e.querySelectorAll('link[rel="stylesheet"]').forEach(e=>{const n=t.createElement("link");n.rel="stylesheet",n.href=e.href,e.media&&(n.media=e.media),e.crossOrigin&&(n.crossOrigin=e.crossOrigin),e.referrerPolicy&&(n.referrerPolicy=e.referrerPolicy),i(n)})}catch{}try{e.querySelectorAll("style").forEach(e=>{const n=t.createElement("style");n.textContent=e.textContent,i(n)})}catch{}}(i,n,e=>u.push(e),()=>!a),!a){const e=n.adoptNode(t);a||s.appendChild(e)}a&&p()}},destroy(){a||(a=!0,p())}}}(l,t,o.placeholder),activate(e){c&&l&&(e?u.addClass(l,"artplayer-document-pip"):u.removeClass(l,"artplayerLine truncated
+!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(e.artplayerPluginDocumentPip=t(),define(function(){return e.artplayerPluginDocumentPip})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerPluginDocumentPip=t()}(this,function(){"use strict";function e(e){const t=[];for(const o of e)try{o()}catch(n){t.push(n)}return t}const t=".artplayer-document-pip.art-video-player{width:100%!important;height:100%!important}";function n(t){let n=!1,o=0,i=null,r=null,c=null;const l=()=>!n&&t.alive(),s=e=>e===o&&l();function u(){o++,r?.finish(),r=null,c?.cancel(),c=null}function a(t){const n=e(t.releases.splice(0));return n.push(...e([()=>t.window.close()])),n}async function d(e){if(!s(e))return;const n=function(){let e;const t=new Promise(t=>{e=t});let n=setTimeout(()=>{n=null,e()},100);return{promise:t,cancel(){null!==n&&clearTimeout(n),n=null,e()}}}();c=n,await n.promise,c===n&&(c=null),s(e)&&t.resize()}async function p(){u();const e=o,n=i;if(i=null,!n)return;const r=a(n);if(n.announced)try{t.activate(!1)}catch(c){r.push(c)}r.length&&l()&&t.report("close",r[0]),s(e)&&await d(e)}return{get active(){return null!==i},get opening(){return null!==r},open:async function(){if(!l()||i)return;if(r)return r.promise;u();const n=o;let c,f;const m=new Promise((e,t)=>{c=e,f=t}),h={promise:m,finish:c};r=h;const y=()=>{r===h&&(r=null),c()},g=o=>{if(s(n)){const n=i;i=null,n&&(a(n),n.announced&&e([()=>t.activate(!1)]));try{t.report("open",o)}catch(r){f(r)}}},v=async o=>{if(!s(n))return void(i?.window!==o&&e([()=>o.close()]));const r={window:o,releases:[],announced:!1};i=r;try{const e=t.project(o.document);if(r.releases.push(e.destroy),e.mount(),!s(n))return void a(r);for(const[i,c]of[["resize",()=>{s(n)&&t.nativeResize()}],["pagehide",()=>{p()}],["unload",()=>{p()}]])if(r.releases.unshift(()=>o.removeEventListener(i,c)),o.addEventListener(i,c),!s(n))return void a(r);r.announced=!0,t.activate(!0),await d(n)}catch(c){g(c)}};try{const e=t.request();Promise.resolve(e).then(v,g).then(y,e=>{s(n)&&f(e),y()})}catch(w){try{g(w)}finally{y()}}return m},close:p,destroy(){n||(n=!0,p().catch(()=>{}))}}}function o(t={}){const o={width:480,height:270,fallbackToVideoPiP:!0,placeholder:"Playing in Document Picture-in-Picture",...t};return t=>{const i=window,r="documentPictureInPicture"in i&&"function"===typeof i.documentPictureInPicture?.requestWindow;let c=t,l=t.template.$player,s=t.isDestroy;const u=t.constructor.utils,a=()=>!s&&!!c&&!c.isDestroy,d=n({alive:a,request:()=>i.documentPictureInPicture.requestWindow({width:o.width,height:o.height}),project:t=>function(t,n,o){const i=t.ownerDocument,r=t.parentNode,c=t.nextSibling;if(!r)throw new Error("Document Picture-in-Picture requires a mounted player");const l=i.createElement("div");l.className="artplayer-document-pip-placeholder",l.style.cssText="display:flex;justify-content:center;align-items:center;width:100%;height:100%;",l.textContent=o??"";const s=n.createElement("div");s.id="__art_dpip_root";const u=[];let a=!1;const d=()=>{const e=l.parentNode===r?l:c?.parentNode===r?c:null;if(t.parentNode!==r||t.nextSibling!==e)try{r.insertBefore(t,e)}catch(n){throw i.body.appendChild(t),n}},p=()=>{const t=e([d,()=>l.remove(),...u.splice(0).map(e=>()=>e.remove()),()=>s.remove()]);if(t.length)throw t[0]};return{mount(){if(!a){if(r.insertBefore(l,c?.parentNode===r?c:null),a||n.body.appendChild(s),a||function(e,t,n,o){const i=e=>{o()&&(n(e),t.head.appendChild(e),o()||e.remove())},r=t.createElement("style");if(r.textContent="\n    html, body { margin:0; padding:0; width:100%; height:100%; background:#000; overflow:hidden; }\n    #__art_dpip_root { position:absolute; inset:0; display:flex; }\n    #__art_dpip_root > * { width:100% !important; height:100% !important; }\n  ",i(r),!t.querySelector('meta[name="viewport"]')){const e=t.createElement("meta");e.name="viewport",e.content="width=device-width,initial-scale=1",i(e)}try{e.querySelectorAll('link[rel="stylesheet"]').forEach(e=>{const n=t.createElement("link");n.rel="stylesheet",n.href=e.href,e.media&&(n.media=e.media),e.crossOrigin&&(n.crossOrigin=e.crossOrigin),e.referrerPolicy&&(n.referrerPolicy=e.referrerPolicy),i(n)})}catch{}try{e.querySelectorAll("style").forEach(e=>{const n=t.createElement("style");n.textContent=e.textContent,i(n)})}catch{}}(i,n,e=>u.push(e),()=>!a),!a){const e=n.adoptNode(t);a||s.appendChild(e)}a&&p()}},destroy(){a||(a=!0,p())}}}(l,t,o.placeholder),activate(e){c&&l&&(e?u.addClass(l,"artplayer-document-pip"):u.removeClass(l,"artplayer-document-pip"),a()&&(c.events.bindGlobalEvents?.(),a()&&c.emit("document-pip",e)))},resize:()=>{a()&&c.emit("resize")},nativeResize:()=>{a()&&c.resize?.()},report(e,t){a()&&(c.notice.show=`Document Picture-in-Picture ${e} failed`,console.warn(`[artplayer-plugin-document-pip] ${e} failed:`,t))}});async function p(){if(a())return!r&&o.fallbackToVideoPiP?(c.pip=!0,void console.warn("[artplayer-plugin-document-pip] Document PiLine truncated

packages/artplayer-plugin-document-pip/dist/artplayer-plugin-document-pip.legacy.js

@@ -4,4 +4,4 @@
  * (c) 2017-2026 Harvey Zhao
  * Released under the MIT License.
  */
-!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(e.artplayerPluginDocumentPip=t(),define(function(){return e.artplayerPluginDocumentPip})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerPluginDocumentPip=t()}(this,function(){"use strict";var e=Object.defineProperty,t=Object.getOwnPropertySymbols,n=Object.prototype.hasOwnProperty,o=Object.prototype.propertyIsEnumerable,r=(t,n,o)=>n in t?e(t,n,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[n]=o,i=(e,t,n)=>new Promise((o,r)=>{var i=e=>{try{c(n.next(e))}catch(t){r(t)}},l=e=>{try{c(n.throw(e))}catch(t){r(t)}},c=e=>e.done?o(e.value):Promise.resolve(e.value).then(i,l);c((n=n.apply(e,t)).next())});function l(e){const t=[];for(const o of e)try{o()}catch(n){t.push(n)}return t}const c=".artplayer-document-pip.art-video-player{width:100%!important;height:100%!important}";function u(e){let t=!1,n=0,o=null,r=null,c=null;const u=()=>!t&&e.alive(),s=e=>e===n&&u();function a(){n++,null==r||r.finish(),r=null,null==c||c.cancel(),c=null}function d(e){const t=l(e.releases.splice(0));return t.push(...l([()=>e.window.close()])),t}function p(t){return i(this,null,function*(){if(!s(t))return;const n=function(){let e;const t=new Promise(t=>{e=t});let n=setTimeout(()=>{n=null,e()},100);return{promise:t,cancel(){null!==n&&clearTimeout(n),n=null,e()}}}();c=n,yield n.promise,c===n&&(c=null),s(t)&&e.resize()})}function f(){return i(this,null,function*(){a();const t=n,r=o;if(o=null,!r)return;const i=d(r);if(r.announced)try{e.activate(!1)}catch(l){i.push(l)}i.length&&u()&&e.report("close",i[0]),s(t)&&(yield p(t))})}return{get active(){return null!==o},get opening(){return null!==r},open:function(){return i(this,null,function*(){if(!u()||o)return;if(r)return r.promise;a();const t=n;let c,m;const h=new Promise((e,t)=>{c=e,m=t}),y={promise:h,finish:c};r=y;const v=()=>{r===y&&(r=null),c()},g=n=>{if(s(t)){const t=o;o=null,t&&(d(t),t.announced&&l([()=>e.activate(!1)]));try{e.report("open",n)}catch(r){m(r)}}},P=n=>i(null,null,function*(){if(!s(t))return void((null==o?void 0:o.window)!==n&&l([()=>n.close()]));const r={window:n,releases:[],announced:!1};o=r;try{const o=e.project(n.document);if(r.releases.push(o.destroy),o.mount(),!s(t))return void d(r);for(const[i,l]of[["resize",()=>{s(t)&&e.nativeResize()}],["pagehide",()=>{f()}],["unload",()=>{f()}]])if(r.releases.unshift(()=>n.removeEventListener(i,l)),n.addEventListener(i,l),!s(t))return void d(r);r.announced=!0,e.activate(!0),yield p(t)}catch(i){g(i)}});try{const n=e.request();Promise.resolve(n).then(P,g).then(v,e=>{s(t)&&m(e),v()})}catch(w){try{g(w)}finally{v()}}return h})},close:f,destroy(){t||(t=!0,f().catch(()=>{}))}}}return"undefined"!==typeof document&&function(e){const t="artplayer-plugin-document-pip",n=e.getElementById(t);if(n)return void(n.textContent=c);const o=e.createElement("style");o.id=t,o.textContent=c;const r=()=>{e.removeEventListener("DOMContentLoaded",r);const n=e.getElementById(t);n?n.textContent=c:(e.head||e.documentElement).appendChild(o)};"loading"===e.readyState?e.addEventListener("DOMContentLoaded",r):r()}(document),function(e={}){const c=((e,i)=>{for(var l in i||(i={}))n.call(i,l)&&r(e,l,i[l]);if(t)for(var l of t(i))o.call(i,l)&&r(e,l,i[l]);return e})({width:480,height:270,fallbackToVideoPiP:!0,placeholder:"Playing in Document Picture-in-Picture"},e);return e=>{var t;const n=window,o="documentPictureInPicture"in n&&"function"===typeof(null==(t=n.documentPictureInPicture)?void 0:t.requestWindow);let r=e,s=e.template.$player,a=e.isDestroy;const d=e.constructor.utils,p=()=>!a&&!!r&&!r.isDestroy,f=u({alive:p,request:()=>n.documentPictureInPicture.requestWindow({width:c.width,height:c.height}),project:e=>function(e,t,n){const o=e.ownerDocument,r=e.parentNode,i=e.nextSibling;if(!r)throw new Error("Document Picture-in-Picture requires a mounted player");const c=o.createElement("div");c.className="artplayer-document-pip-placeholder",c.style.cssText="display:flex;justify-content:center;align-items:center;width:100%;height:100%;",c.textContent=null!=n?n:"";const u=t.createElement("div");u.id="__art_dpip_root";const s=[];let a=!1;const d=()=>{const t=c.parentNode===r?c:(null==i?void 0:i.parentNode)===r?i:null;if(e.parentNode!==r||e.nextSibling!==t)try{r.insertBefore(e,t)}catch(n){throw o.body.appendChild(e),n}},p=()=>{const e=l([d,()=>c.remove(),...s.splice(0).map(e=>()=>e.remove()),()=>u.remove()]);if(e.length)throw e[0]};return{mount(){if(!a){if(r.insertBefore(c,(null==i?void 0:i.parentNode)===r?i:null),a||t.body.appendChild(u),a||function(e,t,n,o){const r=e=>{o()&&(n(e),t.head.appendChild(e),o()||e.remove())},i=t.createElement("style");if(i.textContent="\n    html, body { margin:0; padding:0; width:100%; height:100%; background:#000; overflow:hidden; }\n    #__art_dpip_root { position:absolute; inset:0; display:flex; }\n    #__art_dpip_root > * { width:100% !important; height:100% !important; }\n  ",r(i),!t.querySelectorLine truncated
+!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(e.artplayerPluginDocumentPip=t(),define(function(){return e.artplayerPluginDocumentPip})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerPluginDocumentPip=t()}(this,function(){"use strict";var e=Object.defineProperty,t=Object.getOwnPropertySymbols,n=Object.prototype.hasOwnProperty,o=Object.prototype.propertyIsEnumerable,r=(t,n,o)=>n in t?e(t,n,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[n]=o,i=(e,t,n)=>new Promise((o,r)=>{var i=e=>{try{c(n.next(e))}catch(t){r(t)}},l=e=>{try{c(n.throw(e))}catch(t){r(t)}},c=e=>e.done?o(e.value):Promise.resolve(e.value).then(i,l);c((n=n.apply(e,t)).next())});function l(e){const t=[];for(const o of e)try{o()}catch(n){t.push(n)}return t}const c=".artplayer-document-pip.art-video-player{width:100%!important;height:100%!important}";function u(e){let t=!1,n=0,o=null,r=null,c=null;const u=()=>!t&&e.alive(),s=e=>e===n&&u();function a(){n++,null==r||r.finish(),r=null,null==c||c.cancel(),c=null}function d(e){const t=l(e.releases.splice(0));return t.push(...l([()=>e.window.close()])),t}function p(t){return i(this,null,function*(){if(!s(t))return;const n=function(){let e;const t=new Promise(t=>{e=t});let n=setTimeout(()=>{n=null,e()},100);return{promise:t,cancel(){null!==n&&clearTimeout(n),n=null,e()}}}();c=n,yield n.promise,c===n&&(c=null),s(t)&&e.resize()})}function f(){return i(this,null,function*(){a();const t=n,r=o;if(o=null,!r)return;const i=d(r);if(r.announced)try{e.activate(!1)}catch(l){i.push(l)}i.length&&u()&&e.report("close",i[0]),s(t)&&(yield p(t))})}return{get active(){return null!==o},get opening(){return null!==r},open:function(){return i(this,null,function*(){if(!u()||o)return;if(r)return r.promise;a();const t=n;let c,m;const h=new Promise((e,t)=>{c=e,m=t}),y={promise:h,finish:c};r=y;const v=()=>{r===y&&(r=null),c()},g=n=>{if(s(t)){const t=o;o=null,t&&(d(t),t.announced&&l([()=>e.activate(!1)]));try{e.report("open",n)}catch(r){m(r)}}},P=n=>i(null,null,function*(){if(!s(t))return void((null==o?void 0:o.window)!==n&&l([()=>n.close()]));const r={window:n,releases:[],announced:!1};o=r;try{const o=e.project(n.document);if(r.releases.push(o.destroy),o.mount(),!s(t))return void d(r);for(const[i,l]of[["resize",()=>{s(t)&&e.nativeResize()}],["pagehide",()=>{f()}],["unload",()=>{f()}]])if(r.releases.unshift(()=>n.removeEventListener(i,l)),n.addEventListener(i,l),!s(t))return void d(r);r.announced=!0,e.activate(!0),yield p(t)}catch(i){g(i)}});try{const n=e.request();Promise.resolve(n).then(P,g).then(v,e=>{s(t)&&m(e),v()})}catch(w){try{g(w)}finally{v()}}return h})},close:f,destroy(){t||(t=!0,f().catch(()=>{}))}}}function s(e={}){const c=((e,i)=>{for(var l in i||(i={}))n.call(i,l)&&r(e,l,i[l]);if(t)for(var l of t(i))o.call(i,l)&&r(e,l,i[l]);return e})({width:480,height:270,fallbackToVideoPiP:!0,placeholder:"Playing in Document Picture-in-Picture"},e);return e=>{var t;const n=window,o="documentPictureInPicture"in n&&"function"===typeof(null==(t=n.documentPictureInPicture)?void 0:t.requestWindow);let r=e,s=e.template.$player,a=e.isDestroy;const d=e.constructor.utils,p=()=>!a&&!!r&&!r.isDestroy,f=u({alive:p,request:()=>n.documentPictureInPicture.requestWindow({width:c.width,height:c.height}),project:e=>function(e,t,n){const o=e.ownerDocument,r=e.parentNode,i=e.nextSibling;if(!r)throw new Error("Document Picture-in-Picture requires a mounted player");const c=o.createElement("div");c.className="artplayer-document-pip-placeholder",c.style.cssText="display:flex;justify-content:center;align-items:center;width:100%;height:100%;",c.textContent=null!=n?n:"";const u=t.createElement("div");u.id="__art_dpip_root";const s=[];let a=!1;const d=()=>{const t=c.parentNode===r?c:(null==i?void 0:i.parentNode)===r?i:null;if(e.parentNode!==r||e.nextSibling!==t)try{r.insertBefore(e,t)}catch(n){throw o.body.appendChild(e),n}},p=()=>{const e=l([d,()=>c.remove(),...s.splice(0).map(e=>()=>e.remove()),()=>u.remove()]);if(e.length)throw e[0]};return{mount(){if(!a){if(r.insertBefore(c,(null==i?void 0:i.parentNode)===r?i:null),a||t.body.appendChild(u),a||function(e,t,n,o){const r=e=>{o()&&(n(e),t.head.appendChild(e),o()||e.remove())},i=t.createElement("style");if(i.textContent="\n    html, body { margin:0; padding:0; width:100%; height:100%; background:#000; overflow:hidden; }\n    #__art_dpip_root { position:absolute; inset:0; display:flex; }\n    #__art_dpip_root > * { width:100% !important; height:100% !important; }\n  ",r(i),!t.querySelector('meta[name="viewport"]')){const e=t.createElement("meta");e.name="viewport",e.content="width=device-width,initial-scale=1",r(e)}try{e.querySelectorAll('link[rel="stylesheet"]').forEach(e=>{const n=t.createElement("link");n.rel="stylesheet",n.href=e.href,e.media&&(n.media=e.media),e.crossOrigin&&(n.crossOrigin=e.crossOrigin),e.referrerPolicy&&(n.referrerPolicy=e.referrerPolicy),r(n)})}catch(l){}try{e.querySelectorAll("styleLine truncated

packages/artplayer-plugin-document-pip/dist/artplayer-plugin-document-pip.mjs

@@ -473,8 +473,9 @@ function artplayerPluginDocumentPip(userOptions = {}) {
     return result;
   };
 }
+const index = Object.assign(artplayerPluginDocumentPip, { default: artplayerPluginDocumentPip });
 if (typeof document !== "undefined")
   installStyle(document);
 export {
-  artplayerPluginDocumentPip as default
+  index as default
 };

packages/artplayer-plugin-document-pip/package.json

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

packages/artplayer-plugin-document-pip/src/index.ts

@@ -1,5 +1,5 @@
 import type Artplayer from 'artplayer'
-import type PublicPlugin from '../types/artplayer-plugin-document-pip'
+import type { AsyncResult, Option } from '../types/artplayer-plugin-document-pip'
 import type { WindowApi } from './window-session'
 import { createControl } from './control'
 import { createProjection } from './projection'
@@ -7,9 +7,7 @@ import { releaseAll } from './resources'
 import { installStyle } from './styles'
 import { createWindowSession } from './window-session'
 
-type Option = Parameters<typeof PublicPlugin>[0]
-
-export default function artplayerPluginDocumentPip(userOptions: Option = {}) {
+function artplayerPluginDocumentPip(userOptions: Option = {}) {
   const options = { width: 480, height: 270, fallbackToVideoPiP: true, placeholder: 'Playing in Document Picture-in-Picture', ...userOptions }
   return (art: Artplayer) => {
     const browser = window as Window & { documentPictureInPicture?: WindowApi }
@@ -83,7 +81,7 @@ export default function artplayerPluginDocumentPip(userOptions: Option = {}) {
       if (errors.length)
         console.warn('[artplayer-plugin-document-pip] cleanup failed:', errors[0])
     }
-    const result = {
+    const result: AsyncResult = {
       name: 'artplayerPluginDocumentPip' as const,
       get isSupported() { return isSupported },
       get isActive() { return session.active },
@@ -111,5 +109,7 @@ export default function artplayerPluginDocumentPip(userOptions: Option = {}) {
   }
 }
 
+export default Object.assign(artplayerPluginDocumentPip, { default: artplayerPluginDocumentPip })
+
 if (typeof document !== 'undefined')
   installStyle(document)

packages/artplayer-plugin-document-pip/tsconfig.json

@@ -1,5 +1,5 @@
 {
   "extends": "../../tsconfig.base.json",
   "compilerOptions": { "allowJs": false },
-  "include": ["src/**/*.ts", "types/**/*.d.ts", "../../types/assets.d.ts"]
+  "include": ["src/**/*.ts", "types/**/*.d.ts", "types/**/*.d.mts", "types/**/*.d.cts", "../../types/assets.d.ts"]
 }

packages/artplayer-plugin-document-pip/types/artplayer-plugin-document-pip.d.cts

@@ -0,0 +1,5 @@
+import type { Factory } from './artplayer-plugin-document-pip.js'
+
+declare const artplayerPluginDocumentPip: Factory
+export default artplayerPluginDocumentPip
+export type { AsyncResult, Factory, Option, Result, RuntimeFactory } from './artplayer-plugin-document-pip.js'

packages/artplayer-plugin-document-pip/types/artplayer-plugin-document-pip.d.mts

@@ -0,0 +1,5 @@
+import type { Factory } from './artplayer-plugin-document-pip.js'
+
+declare const artplayerPluginDocumentPip: Factory
+export default artplayerPluginDocumentPip
+export type { AsyncResult, Factory, Option, Result, RuntimeFactory } from './artplayer-plugin-document-pip.js'

packages/artplayer-plugin-document-pip/types/artplayer-plugin-document-pip.d.ts

@@ -1,21 +1,47 @@
 import type Artplayer from 'artplayer'
 
-interface Option {
+export interface Option {
+  /** Requested window width. @default 480 */
   width?: number
+  /** Requested window height. @default 270 */
   height?: number
+  /** Text displayed in the original player container while the window is active. */
   placeholder?: string
+  /** Use the core video PiP property when Document PiP is unavailable. @default true */
   fallbackToVideoPiP?: boolean
 }
 
-interface Result {
+/** Historical assignable result; preserved for direct and extracted return types. */
+export interface Result {
   name: 'artplayerPluginDocumentPip'
+  /** Runtime is a readonly capability snapshot; the published field stays assignable. */
   isSupported: boolean
+  /** Runtime is a readonly live getter; the published field stays assignable. */
   isActive: boolean
+  /** Runtime returns Promise<void>; the published void action remains assignable here. */
   open: () => void
+  /** Runtime returns Promise<void>; the published void action remains assignable here. */
   close: () => void
   toggle: () => void
 }
 
-declare const artplayerPluginDocumentPip: (option: Option) => (art: Artplayer) => Result
+/** Exact view of an unmodified runtime result. */
+export interface AsyncResult extends Omit<Result, 'isSupported' | 'isActive' | 'open' | 'close'> {
+  readonly isSupported: boolean
+  readonly isActive: boolean
+  open: () => Promise<void>
+  close: () => Promise<void>
+}
 
+/** Exact published factory signature, including compatibility with replacement functions. */
+export type Factory = (option: Option) => (art: Artplayer) => Result
+
+/** Opt-in runtime view with omitted options, self default and precise async actions. */
+export interface RuntimeFactory {
+  (option?: Option): (art: Artplayer) => AsyncResult
+  readonly default: RuntimeFactory
+}
+
+/** Keep the published callable type; use RuntimeFactory explicitly for its broader runtime shape. */
+declare function artplayerPluginDocumentPip(option: Option): (art: Artplayer) => Result
 export default artplayerPluginDocumentPip