@shiqianjiang/ceru-plugin-cli 0.3.1 → 0.3.3

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 +4 -0
  2. package/assets/core-contracts.js +1 -1
  3. package/assets/native-view.js +125 -0
  4. package/assets/playground.js +84 -1
  5. package/assets/sandbox.js +19 -19
  6. package/assets/style.css +57 -0
  7. package/dist/dev.js +2 -1
  8. package/package.json +3 -3
  9. package/schemas/config.schema.json +43 -2
  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
@@ -1,5 +1,7 @@
1
1
  # Ceru Plugin CLI
2
2
 
3
+ 0.3.3 支持原生 Surface、账号退出菜单、登录弹框关闭及浏览器公共播放服务。
4
+
3
5
  构建、调试和发行单文件 Ceru v2 插件。支持 TS/JS、Vue SFC、Vue TSX、React 和已有网页产物。
4
6
 
5
7
  ```bash
@@ -12,6 +14,8 @@ npm run build
12
14
 
13
15
  Dev 启动独立 Electron 工作台,实际执行插件并支持 TS 源码断点、日志、搜索/解析、页面预览、权限模拟和宿主资源。VS Code 配置由脚手架生成。
14
16
 
17
+ `connected-library` 模板包含原生歌单网格、歌曲列表、账号菜单、导入与播放动作示例。`kind: 'native'` 的 Surface 使用逻辑端 `defineNativeView` 返回标准内容数据,工作台在 Host DOM 中预览;澜音用现有组件渲染并接入原生详情页和播放器。Vue/React 仍可用于插件自己的账号或设置页面。详见[原生 Surface 教程](https://github.com/CeruMusic/CeruMusic-Plugin-Cli/blob/main/docs/NATIVE-SURFACES.md)。
18
+
15
19
  0.3.1 的播放解析结果可返回 `requestHeaders`。适用于要求 `Referer`、`Origin`、`User-Agent` 或认证头的临时媒体 URL;这些值由 Host 按完整 URL 注入,不应写入页面状态、日志或分享数据。
16
20
 
17
21
  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,15 @@ let state,
14
16
  viewId = null,
15
17
  currentInvocation
16
18
  let viewSession
19
+ let nativePreview
20
+ let viewMountInfo
17
21
  let viewTransition = Promise.resolve()
18
22
  const frames = new Map(),
19
23
  calls = new Map(),
20
24
  registrations = new Map(),
21
25
  surfaceStates = new Map()
26
+ const accountButtons = new Map()
27
+ const accountLogoutButtons = new Map()
22
28
  const api = async (path, data) => {
23
29
  const response = await fetch('/api/' + path, {
24
30
  method: data === undefined ? 'GET' : 'POST',
@@ -54,6 +60,9 @@ function post(frame, type, data) {
54
60
  frame.element.contentWindow?.postMessage({ type, data, generation: frame.generation }, '*')
55
61
  }
56
62
  function removeFrames() {
63
+ nativePreview?.dispose()
64
+ nativePreview = undefined
65
+ $('preview').replaceChildren()
57
66
  void viewSession?.close().catch(error => log('error', error.message))
58
67
  viewSession = undefined
59
68
  void api('rpc', { method: 'sockets.closeAll' }).catch(() => {})
@@ -345,11 +354,20 @@ function showView(id, mountInfo = { kind: 'page' }) {
345
354
  viewTransition = viewTransition.catch(() => {}).then(async () => {
346
355
  await closeView()
347
356
  if (stopped) return
357
+ viewMountInfo = mountInfo
358
+ const logicEntry = state.manifest.modules.logic?.entry
359
+ if (logicEntry && !frames.get(logicEntry)?.active) {
360
+ viewId = id
361
+ $('preview').textContent = '正在启动插件…'
362
+ return
363
+ }
348
364
  mountView(id, mountInfo)
349
365
  })
350
366
  return viewTransition.catch(error => log('error', error.message))
351
367
  }
352
368
  async function closeView() {
369
+ nativePreview?.dispose()
370
+ nativePreview = undefined
353
371
  const previous = viewSession
354
372
  viewSession = undefined
355
373
  viewId = null
@@ -376,6 +394,15 @@ function mountView(id, mountInfo) {
376
394
  frame.surfaceId = id
377
395
  frame.session = viewSession
378
396
  }
397
+ else if (view?.kind === 'native') {
398
+ viewSession = new SurfaceSession(view, state.manifest, runAction)
399
+ nativePreview = new NativeSurfacePreview(
400
+ $('preview'), viewSession,
401
+ new Set(state.manifest.contributes?.commands?.map(command => command.action)),
402
+ error => log('error', error.message),
403
+ )
404
+ void nativePreview.open()
405
+ }
379
406
  else if (view?.kind === 'schema')
380
407
  renderSchema(
381
408
  state.resources[view.entry]?.value?.root,
@@ -392,6 +419,33 @@ function drawStatic() {
392
419
  $('plugin-meta').textContent =
393
420
  state.manifest.id + ' · v' + state.manifest.version + ' · revision ' + revision
394
421
  $('views').replaceChildren()
422
+ accountButtons.clear()
423
+ accountLogoutButtons.clear()
424
+ for (const account of state.manifest.contributes?.accountItems ?? []) {
425
+ const item = document.createElement('div')
426
+ item.className = 'account-item'
427
+ const button = document.createElement('button')
428
+ button.textContent = '账号 · ' + account.title
429
+ button.onclick = () => showView(account.view)
430
+ button.disabled = true
431
+ accountButtons.set(account.id, button)
432
+ item.append(button)
433
+ if (account.logoutAction) {
434
+ const logout = document.createElement('button')
435
+ logout.textContent = '退出登录'
436
+ logout.className = 'account-logout'
437
+ logout.hidden = true
438
+ logout.onclick = async () => {
439
+ logout.disabled = true
440
+ try { await runAction(account.logoutAction); await refreshAccountItems(account.view) }
441
+ catch (error) { log('error', error.message) }
442
+ finally { logout.disabled = false }
443
+ }
444
+ accountLogoutButtons.set(account.id, logout)
445
+ item.append(logout)
446
+ }
447
+ $('views').append(item)
448
+ }
395
449
  for (const view of [
396
450
  ...(state.manifest.modules.surfaces || []),
397
451
  ...(state.manifest.contributes?.guestAdapters || []),
@@ -513,6 +567,25 @@ function drawStatic() {
513
567
  $('static-assets').append(card)
514
568
  }
515
569
  }
570
+ async function refreshAccountItems(surfaceId) {
571
+ await Promise.all((state.manifest.contributes?.accountItems ?? []).map(async account => {
572
+ if ((surfaceId && account.view !== surfaceId) || !registrations.has('action:' + account.action)) return
573
+ const button = accountButtons.get(account.id)
574
+ if (!button) return
575
+ try {
576
+ const summary = await runAction(account.action)
577
+ assertAccountSummary(summary)
578
+ button.textContent = '账号 · ' + summary.displayName + (summary.badge ? ' · ' + summary.badge : '')
579
+ button.disabled = false
580
+ const logout = accountLogoutButtons.get(account.id)
581
+ if (logout) logout.hidden = !summary.signedIn
582
+ } catch (error) {
583
+ button.textContent = '账号 · ' + account.title
584
+ button.disabled = false
585
+ log('error', error.message)
586
+ }
587
+ }))
588
+ }
516
589
  window.addEventListener('message', async (event) => {
517
590
  const frame = [...frames.values()].find((f) => f.element.contentWindow === event.source)
518
591
  if (!frame || !event.data?.type) return
@@ -539,7 +612,10 @@ window.addEventListener('message', async (event) => {
539
612
  if (frame.kind === 'web') {
540
613
  post(frame, 'state', surfaceStates.get(frame.surfaceId) ?? {})
541
614
  void frame.session.open().catch(error => log('error', error.message))
542
- } else if (frame.kind === 'logic' && viewId) void showView(viewId)
615
+ } else if (frame.kind === 'logic') {
616
+ void refreshAccountItems()
617
+ if (viewId) void showView(viewId, viewMountInfo)
618
+ }
543
619
  }
544
620
  if (message.type === 'failed') {
545
621
  frame.failed = true
@@ -554,6 +630,10 @@ window.addEventListener('message', async (event) => {
554
630
  if (message.type === 'log') log(data.level, data.values)
555
631
  if (message.type === 'notify') log(data.level, data.message)
556
632
  if (message.type === 'open-view' && frame.kind === 'logic') void showView(data.surfaceId)
633
+ if (message.type === 'close-view' &&
634
+ ((frame.kind === 'logic' && data.surfaceId === viewId) ||
635
+ (frame.kind === 'web' && frame.surfaceId === viewId)))
636
+ void closeView().catch(error => log('error', error.message))
557
637
  if (message.type === 'register') {
558
638
  if (frame.kind !== 'logic') return
559
639
  const valid =
@@ -573,7 +653,10 @@ window.addEventListener('message', async (event) => {
573
653
  drawRegistrations()
574
654
  }
575
655
  if (message.type === 'state' && frame.kind === 'logic') {
656
+ const changed = JSON.stringify(surfaceStates.get(data.surfaceId)) !== JSON.stringify(data.state)
576
657
  surfaceStates.set(data.surfaceId, data.state)
658
+ if (changed) void refreshAccountItems(data.surfaceId)
659
+ if (changed && viewId === data.surfaceId) void nativePreview?.refresh()
577
660
  for (const view of frames.values()) if (view.kind === 'web' && view.surfaceId === data.surfaceId) post(view, 'state', data.state)
578
661
  if (
579
662
  viewId === data.surfaceId &&