@shiqianjiang/ceru-plugin-cli 0.3.1 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/README.md +2 -0
  2. package/assets/core-contracts.js +1 -1
  3. package/assets/native-view.js +125 -0
  4. package/assets/playground.js +51 -1
  5. package/assets/sandbox.js +17 -17
  6. package/assets/style.css +46 -0
  7. package/dist/dev.js +2 -1
  8. package/package.json +3 -3
  9. package/schemas/config.schema.json +35 -1
  10. package/templates/connected-library/js/README.md +6 -2
  11. package/templates/connected-library/js/ceru.plugin.json +11 -2
  12. package/templates/connected-library/js/package.json +2 -2
  13. package/templates/connected-library/js/src/index.js +52 -1
  14. package/templates/connected-library/ts/README.md +6 -2
  15. package/templates/connected-library/ts/ceru.plugin.json +11 -2
  16. package/templates/connected-library/ts/package.json +2 -2
  17. package/templates/connected-library/ts/src/index.ts +52 -1
  18. package/templates/guest-adapter/js/package.json +2 -2
  19. package/templates/guest-adapter/ts/package.json +2 -2
  20. package/templates/importer/js/package.json +2 -2
  21. package/templates/importer/ts/package.json +2 -2
  22. package/templates/react/js/package.json +2 -2
  23. package/templates/react/ts/package.json +2 -2
  24. package/templates/snapshot.json +1 -1
  25. package/templates/source/js/package.json +2 -2
  26. package/templates/source/ts/package.json +2 -2
  27. package/templates/vue/js/package.json +2 -2
  28. package/templates/vue/ts/package.json +2 -2
  29. package/templates/vue-tsx/js/package.json +2 -2
  30. package/templates/vue-tsx/ts/package.json +2 -2
  31. package/templates/web-dist/js/package.json +2 -2
  32. package/templates/web-dist/ts/package.json +2 -2
  33. package/templates/web-surface/js/package.json +2 -2
  34. package/templates/web-surface/ts/package.json +2 -2
package/README.md CHANGED
@@ -12,6 +12,8 @@ npm run build
12
12
 
13
13
  Dev 启动独立 Electron 工作台,实际执行插件并支持 TS 源码断点、日志、搜索/解析、页面预览、权限模拟和宿主资源。VS Code 配置由脚手架生成。
14
14
 
15
+ `connected-library` 模板包含原生歌单网格、歌曲列表、账号菜单、导入与播放动作示例。`kind: 'native'` 的 Surface 使用逻辑端 `defineNativeView` 返回标准内容数据,工作台在 Host DOM 中预览;澜音用现有组件渲染并接入原生详情页和播放器。Vue/React 仍可用于插件自己的账号或设置页面。详见[原生 Surface 教程](https://github.com/CeruMusic/CeruMusic-Plugin-Cli/blob/main/docs/NATIVE-SURFACES.md)。
16
+
15
17
  0.3.1 的播放解析结果可返回 `requestHeaders`。适用于要求 `Referer`、`Origin`、`User-Agent` 或认证头的临时媒体 URL;这些值由 Host 按完整 URL 注入,不应写入页面状态、日志或分享数据。
16
18
 
17
19
  0.3.0 的 `web-surface` 模板包含通用页面生命周期示例。`modules.surfaces[]` 可声明 `title`、`presentation: { kind: 'drawer', placement: 'right', size: 480 }` 和 `lifecycle: { openAction: 'page.open', closeAction: 'page.close' }`。生命周期动作须在 `contributes.commands` 声明;打开完成后执行 openAction,关闭时取消页面请求并执行 closeAction。扫码、轮询、账号表单和校验全部写在插件工程中,Vue/React 也打包进最终单文件。
@@ -1 +1 @@
1
- var n=e=>!!e&&typeof e=="object"&&!Array.isArray(e),o=(e,r=4096)=>typeof e=="string"&&e.length<=r,a=e=>Number.isFinite(e)&&Number(e)>=0;function c(e){if(!n(e)||!["pluginId","providerId","kind","id"].every(r=>o(e[r],2048)&&e[r].length>0))throw new Error("Invalid resource reference");if(e.data!==void 0){if(!n(e.data))throw new Error("Invalid resource private data");let r;try{r=JSON.stringify(e.data)}catch{throw new Error("Resource private data must be JSON")}if(new TextEncoder().encode(r).byteLength>64*1024)throw new Error("Resource private data exceeds 64 KiB")}}function p(e){if(!n(e)||!Array.isArray(e.items)||e.items.length>1e4)throw new Error("Invalid content page");if(e.nextCursor!=null&&(!o(e.nextCursor,2048)||!e.nextCursor.length))throw new Error("Invalid pagination cursor");for(let r of e.items){if(!n(r)||!o(r.title)||!Array.isArray(r.capabilities)||!r.capabilities.every(t=>o(t,128)))throw new Error("Invalid content item");if(c(r.ref),r.ref.kind==="track"){if(!n(r.metadata)||!Array.isArray(r.metadata.artists)||!r.metadata.artists.every(t=>o(t)))throw new Error("Track metadata must contain artists");if(r.metadata.durationMs!==void 0&&!a(r.metadata.durationMs))throw new Error("Invalid track duration")}if(r.ref.kind==="playlist"&&r.playlist!==void 0){if(!n(r.playlist))throw new Error("Invalid playlist metadata");if(r.playlist.trackCount!==void 0&&(!Number.isInteger(r.playlist.trackCount)||r.playlist.trackCount<0))throw new Error("Invalid playlist track count")}if(r.ref.kind==="chart"&&r.chart!==void 0&&!n(r.chart))throw new Error("Invalid chart metadata")}}function f(e){if(!n(e)||typeof e.ok!="boolean")throw new Error("Invalid resolve result");if(e.ok){if(!o(e.url,8192))throw new Error("Invalid playback URL");let r=new URL(e.url);if(!["http:","https:"].includes(r.protocol))throw new Error("Invalid playback protocol");if(e.expiresAt!==void 0&&!a(e.expiresAt))throw new Error("Invalid playback expiry");if(e.requestHeaders!==void 0){if(!n(e.requestHeaders)||Object.keys(e.requestHeaders).length>32)throw new Error("Invalid playback request headers");for(let[t,s]of Object.entries(e.requestHeaders))if(!/^[!#$%&'*+.^_`|~0-9A-Za-z-]{1,128}$/.test(t)||/^(host|connection|content-length|transfer-encoding|proxy-.*|upgrade)$/i.test(t)||typeof s!="string"||s.length>8192||/[\r\n]/.test(s))throw new Error("Invalid playback request header")}return}if(!n(e.error)||!o(e.error.code,128)||!o(e.error.message,65536))throw new Error("Invalid music fault")}function m(e){if(!n(e)||e.format!=="crlyric"||e.version!==1||!Number.isFinite(e.offsetMs)||!Array.isArray(e.lines)||e.lines.length>2e4)throw new Error("Invalid lyrics document");if(c(e.track),e.track.kind!=="track")throw new Error("Lyrics must reference a track");let r=-1;for(let t of e.lines){if(!n(t)||!a(t.startTimeMs)||t.startTimeMs<r||!o(t.text,65536))throw new Error("Invalid lyric line");if(r=t.startTimeMs,t.endTimeMs!==void 0&&(!a(t.endTimeMs)||t.endTimeMs<t.startTimeMs))throw new Error("Invalid lyric line end");for(let s of["translation","romanization"])if(t[s]!==void 0&&!o(t[s],65536))throw new Error("Invalid lyric translation");if(t.words!==void 0){if(!Array.isArray(t.words)||t.words.length>1e4)throw new Error("Invalid lyric words");let s=t.startTimeMs;for(let i of t.words){if(!n(i)||!a(i.startTimeMs)||!a(i.endTimeMs)||i.endTimeMs<i.startTimeMs||i.startTimeMs<s||!o(i.text,65536))throw new Error("Invalid lyric word");s=i.startTimeMs}}}if(e.plainText!==void 0&&!o(e.plainText,1048576))throw new Error("Invalid plain lyrics")}var l={network:{title:"\u8BBF\u95EE\u516C\u7F51\u670D\u52A1",permissions:["network.request","network.socket"]},localNetwork:{title:"\u8BBF\u95EE\u5C40\u57DF\u7F51\u4E0E\u672C\u673A\u670D\u52A1",permissions:["network.private","network.discovery"]},account:{title:"\u8BFB\u53D6\u767B\u5F55\u72B6\u6001\u4E0E\u57FA\u672C\u8D26\u53F7\u8D44\u6599",permissions:["account.profile"]},libraryRead:{title:"\u8BFB\u53D6\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.read"]},libraryManage:{title:"\u521B\u5EFA\u548C\u4FEE\u6539\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.write"]},libraryDelete:{title:"\u5220\u9664\u6B4C\u5355\u4E0E\u6B4C\u66F2\u8BB0\u5F55",permissions:["library.delete"]},playbackRead:{title:"\u8BFB\u53D6\u64AD\u653E\u72B6\u6001\u548C\u961F\u5217",permissions:["player.read"]},playbackControl:{title:"\u63A7\u5236\u64AD\u653E\u548C\u64AD\u653E\u961F\u5217",permissions:["player.control","playback.fallback.hold"]},downloads:{title:"\u7BA1\u7406\u4E0B\u8F7D\u4EFB\u52A1",permissions:["downloads.create","downloads.manage"]},files:{title:"\u4F7F\u7528\u7528\u6237\u9009\u5B9A\u7684\u6587\u4EF6",permissions:["files.read","files.write"]},localMusic:{title:"\u7D22\u5F15\u672C\u5730\u97F3\u4E50\u548C\u7F16\u8F91\u6807\u7B7E",permissions:["localMusic.read","localMusic.write"]},clipboardRead:{title:"\u8BFB\u53D6\u526A\u8D34\u677F",permissions:["clipboard.read"]},clipboardWrite:{title:"\u5199\u5165\u526A\u8D34\u677F",permissions:["clipboard.write"]},notifications:{title:"\u53D1\u9001\u7CFB\u7EDF\u901A\u77E5",permissions:["notifications.system"]},external:{title:"\u5728\u7CFB\u7EDF\u6D4F\u89C8\u5668\u6253\u5F00\u94FE\u63A5",permissions:["external.open"]},settingsRead:{title:"\u8BFB\u53D6\u8F6F\u4EF6\u504F\u597D",permissions:["settings.read"]},settingsWrite:{title:"\u4FEE\u6539\u8F6F\u4EF6\u504F\u597D",permissions:["settings.write"]},window:{title:"\u63A7\u5236\u8F6F\u4EF6\u7A97\u53E3",permissions:["window.control"]},hotkeys:{title:"\u6CE8\u518C\u5168\u5C40\u5FEB\u6377\u952E",permissions:["hotkeys.register"]},sharing:{title:"\u53D1\u5E03\u548C\u64A4\u9500\u5206\u4EAB",permissions:["sharing.publish","sharing.revoke"]},roomsRead:{title:"\u8BFB\u53D6\u4E00\u8D77\u542C\u623F\u95F4\u72B6\u6001",permissions:["rooms.read"]},roomsControl:{title:"\u52A0\u5165\u623F\u95F4\u548C\u63A7\u5236\u4E00\u8D77\u542C",permissions:["rooms.control"]},ai:{title:"\u4F7F\u7528\u8F6F\u4EF6 AI \u670D\u52A1",permissions:["ai.use"]},devices:{title:"\u63A7\u5236\u97F3\u9891\u8BBE\u5907\u4E0E\u6295\u653E",permissions:["devices.control"]},uiAppearance:{title:"\u4FEE\u6539\u8F6F\u4EF6\u5168\u5C40\u5916\u89C2",permissions:["ui.styles.global"]},background:{title:"\u540E\u53F0\u4EFB\u52A1",permissions:["background.run"]},credentials:{title:"\u4F7F\u7528\u672C\u63D2\u4EF6\u5DF2\u4FDD\u5B58\u7684\u8FDE\u63A5\u51ED\u636E",permissions:["credentials.use"]},credentialExport:{title:"\u8BFB\u53D6\u672C\u63D2\u4EF6\u8FDE\u63A5\u51ED\u636E\u660E\u6587",permissions:["credentials.read"]},guestPlugins:{title:"\u5B89\u88C5\u548C\u8FD0\u884C\u517C\u5BB9\u5B50\u63D2\u4EF6",permissions:["guests.manage","guests.run"]},services:{title:"\u8C03\u7528\u5176\u4ED6\u63D2\u4EF6\u63D0\u4F9B\u7684\u670D\u52A1",permissions:["services.consume"]}};function w(e){return Object.keys(l).find(r=>l[r].permissions.includes(e))}var d=class{constructor(r,t,s){this.surface=r;this.dispatch=s;this.actions=new Set(t.contributes?.commands?.map(i=>i.action));for(let i of Object.values(r.lifecycle??{}))if(!this.actions.has(i))throw new Error("Unknown surface lifecycle action: "+i)}surface;dispatch;closed=!1;opened=!1;opening;closing;pending=new Set;actions;open(){return this.closed?Promise.reject(new Error("Surface is closed")):(this.opened||(this.opened=!0,this.opening=this.surface.lifecycle?.openAction?this.invoke(this.surface.lifecycle.openAction,{}):Promise.resolve()),this.opening)}async invoke(r,t={}){if(this.closed)throw new Error("Surface is closed");if(!this.actions.has(r))throw new Error("Undeclared surface action: "+r);if(this.pending.size>=32||JSON.stringify(t).length>128*1024)throw new Error("Surface request exceeds limit");let s=new AbortController;this.pending.add(s);try{let i=await this.dispatch(r,t,s.signal);if(this.closed)throw new Error("Surface is closed");return i}finally{this.pending.delete(s)}}close(){if(this.closing)return this.closing;this.closed=!0;for(let t of this.pending)t.abort();this.pending.clear();let r=this.surface.lifecycle?.closeAction;return this.closing=Promise.resolve().then(async()=>{r&&await this.dispatch(r,{})}),this.closing}};export{l as PERMISSION_GROUPS,d as SurfaceSession,p as assertContentPage,m as assertLyricsDocument,f as assertResolveResult,c as assertResourceRef,w as permissionGroup};
1
+ var a=e=>!!e&&typeof e=="object"&&!Array.isArray(e),c=(e,t=4096)=>typeof e=="string"&&e.length<=t,d=e=>Number.isFinite(e)&&Number(e)>=0;function y(e){if(!a(e)||!["pluginId","providerId","kind","id"].every(t=>c(e[t],2048)&&e[t].length>0))throw new Error("Invalid resource reference");if(e.data!==void 0){if(!a(e.data))throw new Error("Invalid resource private data");let t;try{t=JSON.stringify(e.data)}catch{throw new Error("Resource private data must be JSON")}if(new TextEncoder().encode(t).byteLength>64*1024)throw new Error("Resource private data exceeds 64 KiB")}}function w(e){if(!a(e)||!Array.isArray(e.items)||e.items.length>1e4)throw new Error("Invalid content page");if(e.nextCursor!=null&&(!c(e.nextCursor,2048)||!e.nextCursor.length))throw new Error("Invalid pagination cursor");for(let t of e.items){if(!a(t)||!c(t.title)||!Array.isArray(t.capabilities)||!t.capabilities.every(r=>c(r,128)))throw new Error("Invalid content item");if(y(t.ref),t.ref.kind==="track"){if(!a(t.metadata)||!Array.isArray(t.metadata.artists)||!t.metadata.artists.every(r=>c(r)))throw new Error("Track metadata must contain artists");if(t.metadata.durationMs!==void 0&&!d(t.metadata.durationMs))throw new Error("Invalid track duration")}if(t.ref.kind==="playlist"&&t.playlist!==void 0){if(!a(t.playlist))throw new Error("Invalid playlist metadata");if(t.playlist.trackCount!==void 0&&(!Number.isInteger(t.playlist.trackCount)||t.playlist.trackCount<0))throw new Error("Invalid playlist track count")}if(t.ref.kind==="chart"&&t.chart!==void 0&&!a(t.chart))throw new Error("Invalid chart metadata")}}function A(e){if(!a(e)||typeof e.ok!="boolean")throw new Error("Invalid resolve result");if(e.ok){if(!c(e.url,8192))throw new Error("Invalid playback URL");let t=new URL(e.url);if(!["http:","https:"].includes(t.protocol))throw new Error("Invalid playback protocol");if(e.expiresAt!==void 0&&!d(e.expiresAt))throw new Error("Invalid playback expiry");if(e.requestHeaders!==void 0){if(!a(e.requestHeaders)||Object.keys(e.requestHeaders).length>32)throw new Error("Invalid playback request headers");for(let[r,n]of Object.entries(e.requestHeaders))if(!/^[!#$%&'*+.^_`|~0-9A-Za-z-]{1,128}$/.test(r)||/^(host|connection|content-length|transfer-encoding|proxy-.*|upgrade)$/i.test(r)||typeof n!="string"||n.length>8192||/[\r\n]/.test(n))throw new Error("Invalid playback request header")}return}if(!a(e.error)||!c(e.error.code,128)||!c(e.error.message,65536))throw new Error("Invalid music fault")}function M(e){if(!a(e)||e.format!=="crlyric"||e.version!==1||!Number.isFinite(e.offsetMs)||!Array.isArray(e.lines)||e.lines.length>2e4)throw new Error("Invalid lyrics document");if(y(e.track),e.track.kind!=="track")throw new Error("Lyrics must reference a track");let t=-1;for(let r of e.lines){if(!a(r)||!d(r.startTimeMs)||r.startTimeMs<t||!c(r.text,65536))throw new Error("Invalid lyric line");if(t=r.startTimeMs,r.endTimeMs!==void 0&&(!d(r.endTimeMs)||r.endTimeMs<r.startTimeMs))throw new Error("Invalid lyric line end");for(let n of["translation","romanization"])if(r[n]!==void 0&&!c(r[n],65536))throw new Error("Invalid lyric translation");if(r.words!==void 0){if(!Array.isArray(r.words)||r.words.length>1e4)throw new Error("Invalid lyric words");let n=r.startTimeMs;for(let o of r.words){if(!a(o)||!d(o.startTimeMs)||!d(o.endTimeMs)||o.endTimeMs<o.startTimeMs||o.startTimeMs<n||!c(o.text,65536))throw new Error("Invalid lyric word");n=o.startTimeMs}}}if(e.plainText!==void 0&&!c(e.plainText,1048576))throw new Error("Invalid plain lyrics")}function N(e){return async(t,r)=>{let n=await e(t,r);return E(n),n}}function h(e,t=new Set){if(!(e===null||typeof e=="string"||typeof e=="boolean")&&!(typeof e=="number"&&Number.isFinite(e))){if(!e||typeof e!="object"||t.has(e))throw new Error("Native view must contain JSON data only");if(!Array.isArray(e)&&Object.getPrototypeOf(e)!==Object.prototype&&Object.getPrototypeOf(e)!==null)throw new Error("Native view must contain JSON data only");t.add(e);for(let r of Object.values(e))r!==void 0&&h(r,t);t.delete(e)}}function E(e,t){h(e);let r=e,n=(i,s=500)=>typeof i=="string"&&i.length<=s,o=i=>n(i,128)&&!!i&&(!t||t.has(i));if(!r||r.type!=="page"||!Array.isArray(r.sections)||r.sections.length>24||r.title!==void 0&&!n(r.title)||r.description!==void 0&&!n(r.description,4e3))throw new Error("Invalid native view");let p=i=>{if(i!==void 0&&(!Array.isArray(i)||i.length>16))throw new Error("Invalid native actions");for(let s of i??[])if(!s||!n(s.label,100)||!s.label||!o(s.action)||s.primary!==void 0&&typeof s.primary!="boolean"||JSON.stringify(s.input??{}).length>16384)throw new Error("Invalid native action")};p(r.actions);let f=new Set;for(let i of r.sections){if(!i||!n(i.id,128)||!i.id||f.has(i.id)||!["grid","list"].includes(i.layout)||i.title!==void 0&&!n(i.title)||i.onOpen!==void 0&&!o(i.onOpen)||i.onPlay!==void 0&&!o(i.onPlay))throw new Error("Invalid native section");f.add(i.id),p(i.itemActions),w({items:i.items})}}function P(e){let t=e;if(!t||typeof t!="object"||Array.isArray(t)||typeof t.signedIn!="boolean"||typeof t.displayName!="string"||!t.displayName.length||t.displayName.length>200||t.badge!==void 0&&(typeof t.badge!="string"||t.badge.length>80))throw new Error("Invalid account summary");if(t.avatarUrl!==void 0&&(typeof t.avatarUrl!="string"||t.avatarUrl.length>8192||!/^https?:\/\//i.test(t.avatarUrl)))throw new Error("Invalid account avatar URL")}var g={network:{title:"\u8BBF\u95EE\u516C\u7F51\u670D\u52A1",permissions:["network.request","network.socket"]},localNetwork:{title:"\u8BBF\u95EE\u5C40\u57DF\u7F51\u4E0E\u672C\u673A\u670D\u52A1",permissions:["network.private","network.discovery"]},account:{title:"\u8BFB\u53D6\u767B\u5F55\u72B6\u6001\u4E0E\u57FA\u672C\u8D26\u53F7\u8D44\u6599",permissions:["account.profile"]},libraryRead:{title:"\u8BFB\u53D6\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.read"]},libraryManage:{title:"\u521B\u5EFA\u548C\u4FEE\u6539\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.write"]},libraryDelete:{title:"\u5220\u9664\u6B4C\u5355\u4E0E\u6B4C\u66F2\u8BB0\u5F55",permissions:["library.delete"]},playbackRead:{title:"\u8BFB\u53D6\u64AD\u653E\u72B6\u6001\u548C\u961F\u5217",permissions:["player.read"]},playbackControl:{title:"\u63A7\u5236\u64AD\u653E\u548C\u64AD\u653E\u961F\u5217",permissions:["player.control","playback.fallback.hold"]},downloads:{title:"\u7BA1\u7406\u4E0B\u8F7D\u4EFB\u52A1",permissions:["downloads.create","downloads.manage"]},files:{title:"\u4F7F\u7528\u7528\u6237\u9009\u5B9A\u7684\u6587\u4EF6",permissions:["files.read","files.write"]},localMusic:{title:"\u7D22\u5F15\u672C\u5730\u97F3\u4E50\u548C\u7F16\u8F91\u6807\u7B7E",permissions:["localMusic.read","localMusic.write"]},clipboardRead:{title:"\u8BFB\u53D6\u526A\u8D34\u677F",permissions:["clipboard.read"]},clipboardWrite:{title:"\u5199\u5165\u526A\u8D34\u677F",permissions:["clipboard.write"]},notifications:{title:"\u53D1\u9001\u7CFB\u7EDF\u901A\u77E5",permissions:["notifications.system"]},external:{title:"\u5728\u7CFB\u7EDF\u6D4F\u89C8\u5668\u6253\u5F00\u94FE\u63A5",permissions:["external.open"]},settingsRead:{title:"\u8BFB\u53D6\u8F6F\u4EF6\u504F\u597D",permissions:["settings.read"]},settingsWrite:{title:"\u4FEE\u6539\u8F6F\u4EF6\u504F\u597D",permissions:["settings.write"]},window:{title:"\u63A7\u5236\u8F6F\u4EF6\u7A97\u53E3",permissions:["window.control"]},hotkeys:{title:"\u6CE8\u518C\u5168\u5C40\u5FEB\u6377\u952E",permissions:["hotkeys.register"]},sharing:{title:"\u53D1\u5E03\u548C\u64A4\u9500\u5206\u4EAB",permissions:["sharing.publish","sharing.revoke"]},roomsRead:{title:"\u8BFB\u53D6\u4E00\u8D77\u542C\u623F\u95F4\u72B6\u6001",permissions:["rooms.read"]},roomsControl:{title:"\u52A0\u5165\u623F\u95F4\u548C\u63A7\u5236\u4E00\u8D77\u542C",permissions:["rooms.control"]},ai:{title:"\u4F7F\u7528\u8F6F\u4EF6 AI \u670D\u52A1",permissions:["ai.use"]},devices:{title:"\u63A7\u5236\u97F3\u9891\u8BBE\u5907\u4E0E\u6295\u653E",permissions:["devices.control"]},uiAppearance:{title:"\u4FEE\u6539\u8F6F\u4EF6\u5168\u5C40\u5916\u89C2",permissions:["ui.styles.global"]},background:{title:"\u540E\u53F0\u4EFB\u52A1",permissions:["background.run"]},credentials:{title:"\u4F7F\u7528\u672C\u63D2\u4EF6\u5DF2\u4FDD\u5B58\u7684\u8FDE\u63A5\u51ED\u636E",permissions:["credentials.use"]},credentialExport:{title:"\u8BFB\u53D6\u672C\u63D2\u4EF6\u8FDE\u63A5\u51ED\u636E\u660E\u6587",permissions:["credentials.read"]},guestPlugins:{title:"\u5B89\u88C5\u548C\u8FD0\u884C\u517C\u5BB9\u5B50\u63D2\u4EF6",permissions:["guests.manage","guests.run"]},services:{title:"\u8C03\u7528\u5176\u4ED6\u63D2\u4EF6\u63D0\u4F9B\u7684\u670D\u52A1",permissions:["services.consume"]}};function C(e){return Object.keys(g).find(t=>g[t].permissions.includes(e))}var l=e=>!!e&&typeof e=="object"&&!Array.isArray(e),u=(e,t=4096)=>typeof e=="string"&&e.length<=t,v=e=>Number.isFinite(e)&&Number(e)>=0;function I(e){if(!l(e)||!["pluginId","providerId","kind","id"].every(t=>u(e[t],2048)&&e[t].length>0))throw new Error("Invalid resource reference");if(e.data!==void 0){if(!l(e.data))throw new Error("Invalid resource private data");let t;try{t=JSON.stringify(e.data)}catch{throw new Error("Resource private data must be JSON")}if(new TextEncoder().encode(t).byteLength>64*1024)throw new Error("Resource private data exceeds 64 KiB")}}function b(e){if(!l(e)||!Array.isArray(e.items)||e.items.length>1e4)throw new Error("Invalid content page");if(e.nextCursor!=null&&(!u(e.nextCursor,2048)||!e.nextCursor.length))throw new Error("Invalid pagination cursor");for(let t of e.items){if(!l(t)||!u(t.title)||!Array.isArray(t.capabilities)||!t.capabilities.every(r=>u(r,128)))throw new Error("Invalid content item");if(I(t.ref),t.ref.kind==="track"){if(!l(t.metadata)||!Array.isArray(t.metadata.artists)||!t.metadata.artists.every(r=>u(r)))throw new Error("Track metadata must contain artists");if(t.metadata.durationMs!==void 0&&!v(t.metadata.durationMs))throw new Error("Invalid track duration")}if(t.ref.kind==="playlist"&&t.playlist!==void 0){if(!l(t.playlist))throw new Error("Invalid playlist metadata");if(t.playlist.trackCount!==void 0&&(!Number.isInteger(t.playlist.trackCount)||t.playlist.trackCount<0))throw new Error("Invalid playlist track count")}if(t.ref.kind==="chart"&&t.chart!==void 0&&!l(t.chart))throw new Error("Invalid chart metadata")}}function k(e,t=new Set){if(!(e===null||typeof e=="string"||typeof e=="boolean")&&!(typeof e=="number"&&Number.isFinite(e))){if(!e||typeof e!="object"||t.has(e))throw new Error("Native view must contain JSON data only");if(!Array.isArray(e)&&Object.getPrototypeOf(e)!==Object.prototype&&Object.getPrototypeOf(e)!==null)throw new Error("Native view must contain JSON data only");t.add(e);for(let r of Object.values(e))r!==void 0&&k(r,t);t.delete(e)}}function m(e,t){k(e);let r=e,n=(i,s=500)=>typeof i=="string"&&i.length<=s,o=i=>n(i,128)&&!!i&&(!t||t.has(i));if(!r||r.type!=="page"||!Array.isArray(r.sections)||r.sections.length>24||r.title!==void 0&&!n(r.title)||r.description!==void 0&&!n(r.description,4e3))throw new Error("Invalid native view");let p=i=>{if(i!==void 0&&(!Array.isArray(i)||i.length>16))throw new Error("Invalid native actions");for(let s of i??[])if(!s||!n(s.label,100)||!s.label||!o(s.action)||s.primary!==void 0&&typeof s.primary!="boolean"||JSON.stringify(s.input??{}).length>16384)throw new Error("Invalid native action")};p(r.actions);let f=new Set;for(let i of r.sections){if(!i||!n(i.id,128)||!i.id||f.has(i.id)||!["grid","list"].includes(i.layout)||i.title!==void 0&&!n(i.title)||i.onOpen!==void 0&&!o(i.onOpen)||i.onPlay!==void 0&&!o(i.onPlay))throw new Error("Invalid native section");f.add(i.id),p(i.itemActions),b({items:i.items})}}var x=class{constructor(t,r,n){this.surface=t;this.dispatch=n;if(this.actions=new Set(r.contributes?.commands?.map(o=>o.action)),t.kind==="native"&&!this.actions.has(t.entry))throw new Error("Missing native render action: "+t.entry);for(let o of Object.values(t.lifecycle??{}))if(!this.actions.has(o))throw new Error("Unknown surface lifecycle action: "+o)}surface;dispatch;closed=!1;opened=!1;opening;closing;pending=new Set;actions;open(){return this.closed?Promise.reject(new Error("Surface is closed")):(this.opened||(this.opened=!0,this.opening=this.surface.lifecycle?.openAction?this.invoke(this.surface.lifecycle.openAction,{}):Promise.resolve()),this.opening)}async invoke(t,r={}){if(this.closed)throw new Error("Surface is closed");if(!this.actions.has(t))throw new Error("Undeclared surface action: "+t);if(this.pending.size>=32||JSON.stringify(r).length>128*1024)throw new Error("Surface request exceeds limit");let n=new AbortController;this.pending.add(n);try{let o=await this.dispatch(t,r,n.signal);if(this.closed)throw new Error("Surface is closed");return this.surface.kind==="native"&&t===this.surface.entry&&m(o,this.actions),o}finally{this.pending.delete(n)}}close(){if(this.closing)return this.closing;this.closed=!0;for(let r of this.pending)r.abort();this.pending.clear();let t=this.surface.lifecycle?.closeAction;return this.closing=Promise.resolve().then(async()=>{t&&await this.dispatch(t,{})}),this.closing}};export{g as PERMISSION_GROUPS,x as SurfaceSession,P as assertAccountSummary,w as assertContentPage,M as assertLyricsDocument,E as assertNativeView,A as assertResolveResult,y as assertResourceRef,N as defineNativeView,C as permissionGroup};
@@ -0,0 +1,125 @@
1
+ import { assertNativeView } from './core-contracts.js'
2
+
3
+ /** Preview Host components, rendered in the Host DOM; plugin code remains in the logic sandbox. */
4
+ export class NativeSurfacePreview {
5
+ constructor(container, session, actions, onError = () => {}) {
6
+ this.container = container
7
+ this.session = session
8
+ this.actions = actions
9
+ this.onError = onError
10
+ this.closed = false
11
+ this.revision = 0
12
+ this.container.classList.add('native-preview')
13
+ }
14
+
15
+ async open() {
16
+ try {
17
+ await this.session.open()
18
+ if (!this.closed) await this.refresh()
19
+ } catch (error) { this.fail(error) }
20
+ }
21
+
22
+ refresh() {
23
+ if (this.closed) return Promise.resolve()
24
+ this.revision++
25
+ if (this.rendering) return this.rendering
26
+ this.rendering = (async () => {
27
+ let rendered
28
+ do {
29
+ rendered = this.revision
30
+ const view = await this.session.invoke(this.session.surface.entry, {})
31
+ if (this.closed) return
32
+ assertNativeView(view, this.actions)
33
+ if (rendered === this.revision) this.render(view)
34
+ } while (!this.closed && rendered !== this.revision)
35
+ })().catch(error => this.fail(error)).finally(() => { this.rendering = undefined })
36
+ return this.rendering
37
+ }
38
+
39
+ dispose() {
40
+ this.closed = true
41
+ this.container.classList.remove('native-preview')
42
+ }
43
+
44
+ fail(error) {
45
+ if (this.closed) return
46
+ this.container.replaceChildren(this.element('p', error.message, 'error'))
47
+ this.onError(error)
48
+ }
49
+
50
+ element(tag, text, className) {
51
+ const element = this.container.ownerDocument.createElement(tag)
52
+ if (text !== undefined) element.textContent = text
53
+ if (className) element.className = className
54
+ return element
55
+ }
56
+
57
+ button(label, action, input, primary = false) {
58
+ const button = this.element('button', label, primary ? 'primary' : '')
59
+ button.type = 'button'
60
+ button.onclick = async () => {
61
+ button.disabled = true
62
+ try {
63
+ await this.session.invoke(action, input)
64
+ if (!this.closed) await this.refresh()
65
+ } catch (error) { if (!this.closed) this.onError(error) }
66
+ finally { button.disabled = false }
67
+ }
68
+ return button
69
+ }
70
+
71
+ render(view) {
72
+ const page = this.element('div', undefined, 'native-page')
73
+ if (view.title) page.append(this.element('h2', view.title))
74
+ if (view.description) page.append(this.element('p', view.description, 'hint'))
75
+ const toolbar = this.element('div', undefined, 'native-actions')
76
+ for (const action of view.actions ?? [])
77
+ toolbar.append(this.button(action.label, action.action, action.input ?? {}, action.primary))
78
+ page.append(toolbar)
79
+ for (const section of view.sections) {
80
+ const group = this.element('div', undefined, 'native-section')
81
+ group.dataset.section = section.id
82
+ if (section.title) group.append(this.element('h3', section.title))
83
+ const items = this.element('div', undefined, 'native-' + section.layout)
84
+ const refs = section.items.map(item => item.ref)
85
+ for (const item of section.items) {
86
+ const card = this.element('div', undefined, 'native-item')
87
+ const content = this.element('div', undefined, 'native-item-content')
88
+ const artwork = item.playlist?.artworkUrl ?? item.metadata?.artworkUrl ?? item.chart?.artworkUrl
89
+ if (typeof artwork === 'string' && /^(https?:\/\/|data:image\/)/i.test(artwork)) {
90
+ const image = this.element('img', '', 'native-artwork')
91
+ image.src = artwork
92
+ image.alt = ''
93
+ image.loading = 'lazy'
94
+ image.referrerPolicy = 'no-referrer'
95
+ content.append(image)
96
+ }
97
+ const details = this.element('div', undefined, 'native-item-details')
98
+ const title = section.onOpen
99
+ ? this.button(item.title, section.onOpen, { ref: item.ref })
100
+ : this.element('strong', item.title)
101
+ title.classList.add('native-item-title')
102
+ details.append(title)
103
+ const subtitle = item.subtitle ?? item.playlist?.description ?? item.metadata?.artists.join(' / ')
104
+ if (subtitle) details.append(this.element('p', subtitle, 'hint'))
105
+ if (item.playlist?.trackCount !== undefined)
106
+ details.append(this.element('small', item.playlist.trackCount + ' 首', 'hint'))
107
+ content.append(details)
108
+ card.append(content)
109
+ const buttons = this.element('div', undefined, 'native-actions')
110
+ if (section.onPlay) buttons.append(this.button('播放', section.onPlay, { ref: item.ref, refs }))
111
+ for (const action of section.itemActions ?? []) {
112
+ const input = action.input && typeof action.input === 'object' && !Array.isArray(action.input)
113
+ ? action.input : {}
114
+ buttons.append(this.button(action.label, action.action, { ...input, ref: item.ref }, action.primary))
115
+ }
116
+ card.append(buttons)
117
+ items.append(card)
118
+ }
119
+ if (!section.items.length) items.append(this.element('p', '暂无内容', 'empty'))
120
+ group.append(items)
121
+ page.append(group)
122
+ }
123
+ this.container.replaceChildren(page)
124
+ }
125
+ }
@@ -1,11 +1,13 @@
1
1
  import {
2
2
  assertContentPage,
3
+ assertAccountSummary,
3
4
  assertLyricsDocument,
4
5
  assertResolveResult,
5
6
  PERMISSION_GROUPS,
6
7
  permissionGroup,
7
8
  SurfaceSession,
8
9
  } from './core-contracts.js'
10
+ import { NativeSurfacePreview } from './native-view.js'
9
11
  const $ = (id) => document.getElementById(id)
10
12
  let state,
11
13
  revision = 0,
@@ -14,11 +16,13 @@ let state,
14
16
  viewId = null,
15
17
  currentInvocation
16
18
  let viewSession
19
+ let nativePreview
17
20
  let viewTransition = Promise.resolve()
18
21
  const frames = new Map(),
19
22
  calls = new Map(),
20
23
  registrations = new Map(),
21
24
  surfaceStates = new Map()
25
+ const accountButtons = new Map()
22
26
  const api = async (path, data) => {
23
27
  const response = await fetch('/api/' + path, {
24
28
  method: data === undefined ? 'GET' : 'POST',
@@ -54,6 +58,9 @@ function post(frame, type, data) {
54
58
  frame.element.contentWindow?.postMessage({ type, data, generation: frame.generation }, '*')
55
59
  }
56
60
  function removeFrames() {
61
+ nativePreview?.dispose()
62
+ nativePreview = undefined
63
+ $('preview').replaceChildren()
57
64
  void viewSession?.close().catch(error => log('error', error.message))
58
65
  viewSession = undefined
59
66
  void api('rpc', { method: 'sockets.closeAll' }).catch(() => {})
@@ -350,6 +357,8 @@ function showView(id, mountInfo = { kind: 'page' }) {
350
357
  return viewTransition.catch(error => log('error', error.message))
351
358
  }
352
359
  async function closeView() {
360
+ nativePreview?.dispose()
361
+ nativePreview = undefined
353
362
  const previous = viewSession
354
363
  viewSession = undefined
355
364
  viewId = null
@@ -376,6 +385,15 @@ function mountView(id, mountInfo) {
376
385
  frame.surfaceId = id
377
386
  frame.session = viewSession
378
387
  }
388
+ else if (view?.kind === 'native') {
389
+ viewSession = new SurfaceSession(view, state.manifest, runAction)
390
+ nativePreview = new NativeSurfacePreview(
391
+ $('preview'), viewSession,
392
+ new Set(state.manifest.contributes?.commands?.map(command => command.action)),
393
+ error => log('error', error.message),
394
+ )
395
+ void nativePreview.open()
396
+ }
379
397
  else if (view?.kind === 'schema')
380
398
  renderSchema(
381
399
  state.resources[view.entry]?.value?.root,
@@ -392,6 +410,15 @@ function drawStatic() {
392
410
  $('plugin-meta').textContent =
393
411
  state.manifest.id + ' · v' + state.manifest.version + ' · revision ' + revision
394
412
  $('views').replaceChildren()
413
+ accountButtons.clear()
414
+ for (const account of state.manifest.contributes?.accountItems ?? []) {
415
+ const button = document.createElement('button')
416
+ button.textContent = '账号 · ' + account.title
417
+ button.onclick = () => showView(account.view)
418
+ button.disabled = true
419
+ accountButtons.set(account.id, button)
420
+ $('views').append(button)
421
+ }
395
422
  for (const view of [
396
423
  ...(state.manifest.modules.surfaces || []),
397
424
  ...(state.manifest.contributes?.guestAdapters || []),
@@ -513,6 +540,23 @@ function drawStatic() {
513
540
  $('static-assets').append(card)
514
541
  }
515
542
  }
543
+ async function refreshAccountItems(surfaceId) {
544
+ await Promise.all((state.manifest.contributes?.accountItems ?? []).map(async account => {
545
+ if ((surfaceId && account.view !== surfaceId) || !registrations.has('action:' + account.action)) return
546
+ const button = accountButtons.get(account.id)
547
+ if (!button) return
548
+ try {
549
+ const summary = await runAction(account.action)
550
+ assertAccountSummary(summary)
551
+ button.textContent = '账号 · ' + summary.displayName + (summary.badge ? ' · ' + summary.badge : '')
552
+ button.disabled = false
553
+ } catch (error) {
554
+ button.textContent = '账号 · ' + account.title
555
+ button.disabled = false
556
+ log('error', error.message)
557
+ }
558
+ }))
559
+ }
516
560
  window.addEventListener('message', async (event) => {
517
561
  const frame = [...frames.values()].find((f) => f.element.contentWindow === event.source)
518
562
  if (!frame || !event.data?.type) return
@@ -539,7 +583,10 @@ window.addEventListener('message', async (event) => {
539
583
  if (frame.kind === 'web') {
540
584
  post(frame, 'state', surfaceStates.get(frame.surfaceId) ?? {})
541
585
  void frame.session.open().catch(error => log('error', error.message))
542
- } else if (frame.kind === 'logic' && viewId) void showView(viewId)
586
+ } else if (frame.kind === 'logic') {
587
+ void refreshAccountItems()
588
+ if (viewId) void showView(viewId)
589
+ }
543
590
  }
544
591
  if (message.type === 'failed') {
545
592
  frame.failed = true
@@ -573,7 +620,10 @@ window.addEventListener('message', async (event) => {
573
620
  drawRegistrations()
574
621
  }
575
622
  if (message.type === 'state' && frame.kind === 'logic') {
623
+ const changed = JSON.stringify(surfaceStates.get(data.surfaceId)) !== JSON.stringify(data.state)
576
624
  surfaceStates.set(data.surfaceId, data.state)
625
+ if (changed) void refreshAccountItems(data.surfaceId)
626
+ if (changed && viewId === data.surfaceId) void nativePreview?.refresh()
577
627
  for (const view of frames.values()) if (view.kind === 'web' && view.surfaceId === data.surfaceId) post(view, 'state', data.state)
578
628
  if (
579
629
  viewId === data.surfaceId &&