@shiqianjiang/ceru-plugin-cli 0.2.6 → 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.
- package/README.md +8 -0
- package/assets/core-contracts.js +1 -1
- package/assets/index.html +94 -94
- package/assets/native-view.js +125 -0
- package/assets/playground.js +109 -11
- package/assets/sandbox.js +22 -22
- package/assets/style.css +46 -0
- package/dist/dev.js +9 -14
- package/dist/storage.d.ts +12 -0
- package/dist/storage.js +65 -0
- package/package.json +71 -71
- package/schemas/config.schema.json +166 -1
- package/templates/connected-library/js/README.md +6 -2
- package/templates/connected-library/js/ceru.plugin.json +11 -2
- package/templates/connected-library/js/package.json +22 -22
- package/templates/connected-library/js/src/index.js +52 -1
- package/templates/connected-library/ts/README.md +6 -2
- package/templates/connected-library/ts/ceru.plugin.json +11 -2
- package/templates/connected-library/ts/package.json +22 -22
- package/templates/connected-library/ts/src/index.ts +52 -1
- package/templates/guest-adapter/js/package.json +22 -22
- package/templates/guest-adapter/ts/package.json +22 -22
- package/templates/importer/js/package.json +22 -22
- package/templates/importer/ts/package.json +22 -22
- package/templates/react/js/package.json +26 -26
- package/templates/react/ts/package.json +26 -26
- package/templates/snapshot.json +1 -1
- package/templates/source/js/package.json +22 -22
- package/templates/source/ts/package.json +22 -22
- package/templates/vue/js/package.json +23 -23
- package/templates/vue/ts/package.json +23 -23
- package/templates/vue-tsx/js/package.json +23 -23
- package/templates/vue-tsx/ts/package.json +23 -23
- package/templates/web-dist/js/package.json +22 -22
- package/templates/web-dist/ts/package.json +22 -22
- package/templates/web-surface/js/ceru.plugin.json +31 -2
- package/templates/web-surface/js/package.json +22 -22
- package/templates/web-surface/js/src/index.js +7 -0
- package/templates/web-surface/ts/ceru.plugin.json +31 -2
- package/templates/web-surface/ts/package.json +22 -22
- package/templates/web-surface/ts/src/index.ts +7 -0
package/README.md
CHANGED
|
@@ -12,6 +12,14 @@ 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
|
+
|
|
17
|
+
0.3.1 的播放解析结果可返回 `requestHeaders`。适用于要求 `Referer`、`Origin`、`User-Agent` 或认证头的临时媒体 URL;这些值由 Host 按完整 URL 注入,不应写入页面状态、日志或分享数据。
|
|
18
|
+
|
|
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 也打包进最终单文件。
|
|
20
|
+
|
|
21
|
+
预览的“关闭页面”可验证清理逻辑。`ctx.ui.setState(id, state)` 只发送给对应页面;`ctx.subscribe` 接收最新状态。开发存储保存在工程 `.ceru-dev/storage/`,重启保留且不打入产物;修改 `manifest.id` 会使用独立存储。生产宿主提供自己的隔离存储和通用播放器服务,开发无需启动澜音。
|
|
22
|
+
|
|
15
23
|
```text
|
|
16
24
|
ceru-plugin list-templates
|
|
17
25
|
ceru-plugin build --out dist/plugin.js
|
package/assets/core-contracts.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
var i=r=>!!r&&typeof r=="object"&&!Array.isArray(r),s=(r,e=4096)=>typeof r=="string"&&r.length<=e,o=r=>Number.isFinite(r)&&Number(r)>=0;function l(r){if(!i(r)||!["pluginId","providerId","kind","id"].every(e=>s(r[e],2048)&&r[e].length>0))throw new Error("Invalid resource reference");if(r.data!==void 0){if(!i(r.data))throw new Error("Invalid resource private data");let e;try{e=JSON.stringify(r.data)}catch{throw new Error("Resource private data must be JSON")}if(new TextEncoder().encode(e).byteLength>64*1024)throw new Error("Resource private data exceeds 64 KiB")}}function d(r){if(!i(r)||!Array.isArray(r.items)||r.items.length>1e4)throw new Error("Invalid content page");if(r.nextCursor!=null&&(!s(r.nextCursor,2048)||!r.nextCursor.length))throw new Error("Invalid pagination cursor");for(let e of r.items){if(!i(e)||!s(e.title)||!Array.isArray(e.capabilities)||!e.capabilities.every(t=>s(t,128)))throw new Error("Invalid content item");if(l(e.ref),e.ref.kind==="track"){if(!i(e.metadata)||!Array.isArray(e.metadata.artists)||!e.metadata.artists.every(t=>s(t)))throw new Error("Track metadata must contain artists");if(e.metadata.durationMs!==void 0&&!o(e.metadata.durationMs))throw new Error("Invalid track duration")}if(e.ref.kind==="playlist"&&e.playlist!==void 0){if(!i(e.playlist))throw new Error("Invalid playlist metadata");if(e.playlist.trackCount!==void 0&&(!Number.isInteger(e.playlist.trackCount)||e.playlist.trackCount<0))throw new Error("Invalid playlist track count")}if(e.ref.kind==="chart"&&e.chart!==void 0&&!i(e.chart))throw new Error("Invalid chart metadata")}}function p(r){if(!i(r)||typeof r.ok!="boolean")throw new Error("Invalid resolve result");if(r.ok){if(!s(r.url,8192))throw new Error("Invalid playback URL");let e=new URL(r.url);if(!["http:","https:"].includes(e.protocol))throw new Error("Invalid playback protocol");if(r.expiresAt!==void 0&&!o(r.expiresAt))throw new Error("Invalid playback expiry");return}if(!i(r.error)||!s(r.error.code,128)||!s(r.error.message,65536))throw new Error("Invalid music fault")}function m(r){if(!i(r)||r.format!=="crlyric"||r.version!==1||!Number.isFinite(r.offsetMs)||!Array.isArray(r.lines)||r.lines.length>2e4)throw new Error("Invalid lyrics document");if(l(r.track),r.track.kind!=="track")throw new Error("Lyrics must reference a track");let e=-1;for(let t of r.lines){if(!i(t)||!o(t.startTimeMs)||t.startTimeMs<e||!s(t.text,65536))throw new Error("Invalid lyric line");if(e=t.startTimeMs,t.endTimeMs!==void 0&&(!o(t.endTimeMs)||t.endTimeMs<t.startTimeMs))throw new Error("Invalid lyric line end");for(let a of["translation","romanization"])if(t[a]!==void 0&&!s(t[a],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 a=t.startTimeMs;for(let n of t.words){if(!i(n)||!o(n.startTimeMs)||!o(n.endTimeMs)||n.endTimeMs<n.startTimeMs||n.startTimeMs<a||!s(n.text,65536))throw new Error("Invalid lyric word");a=n.startTimeMs}}}if(r.plainText!==void 0&&!s(r.plainText,1048576))throw new Error("Invalid plain lyrics")}var c={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 u(r){return Object.keys(c).find(e=>c[e].permissions.includes(r))}export{c as PERMISSION_GROUPS,d as assertContentPage,m as assertLyricsDocument,p as assertResolveResult,l as assertResourceRef,u 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};
|
package/assets/index.html
CHANGED
|
@@ -1,94 +1,94 @@
|
|
|
1
|
-
<!doctype html>
|
|
2
|
-
<html lang="zh-CN">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="utf-8" />
|
|
5
|
-
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
|
6
|
-
<title>Ceru Plugin Dev</title>
|
|
7
|
-
<link rel="stylesheet" href="/style.css" />
|
|
8
|
-
</head>
|
|
9
|
-
<body>
|
|
10
|
-
<header>
|
|
11
|
-
<div>
|
|
12
|
-
<span class="badge">CERU / DEV HOST</span>
|
|
13
|
-
<h1 id="plugin-name">插件调试工作台</h1>
|
|
14
|
-
<p id="plugin-meta">TypeScript · 单文件构建 · 隔离运行</p>
|
|
15
|
-
</div>
|
|
16
|
-
<div class="header-actions">
|
|
17
|
-
<span id="status" class="status">启动中</span><button id="restart">重新运行</button
|
|
18
|
-
><button id="stop">停止</button>
|
|
19
|
-
</div>
|
|
20
|
-
</header>
|
|
21
|
-
<div id="build-error" class="error hidden"></div>
|
|
22
|
-
<main>
|
|
23
|
-
<aside>
|
|
24
|
-
<section>
|
|
25
|
-
<h2>能力注册</h2>
|
|
26
|
-
<div id="registrations"></div>
|
|
27
|
-
</section>
|
|
28
|
-
<section>
|
|
29
|
-
<h2>界面与兼容模块</h2>
|
|
30
|
-
<div id="views"></div>
|
|
31
|
-
</section>
|
|
32
|
-
<section>
|
|
33
|
-
<h2>运行时配置</h2>
|
|
34
|
-
<p class="hint">仅保存在当前开发会话中。</p>
|
|
35
|
-
<textarea id="config" spellcheck="false">{}</textarea
|
|
36
|
-
><button id="apply-config">应用配置并重载</button>
|
|
37
|
-
</section>
|
|
38
|
-
<section>
|
|
39
|
-
<h2>权限模拟</h2>
|
|
40
|
-
<div id="permissions"></div>
|
|
41
|
-
</section>
|
|
42
|
-
</aside>
|
|
43
|
-
<article>
|
|
44
|
-
<section>
|
|
45
|
-
<h2>搜索与解析</h2>
|
|
46
|
-
<div class="row">
|
|
47
|
-
<select id="provider" disabled aria-label="搜索来源"></select
|
|
48
|
-
><input id="query" placeholder="输入关键词" disabled /><button id="search" class="primary" disabled>
|
|
49
|
-
调用搜索</button
|
|
50
|
-
><button id="cancel" disabled>取消调用</button>
|
|
51
|
-
</div>
|
|
52
|
-
<p id="search-status" class="hint" role="status" aria-live="polite">正在读取插件能力…</p>
|
|
53
|
-
<div id="results" class="results">
|
|
54
|
-
<div class="empty">插件启动后可以调用已注册的搜索方法。</div>
|
|
55
|
-
</div>
|
|
56
|
-
<pre id="result-detail"></pre>
|
|
57
|
-
</section>
|
|
58
|
-
<section>
|
|
59
|
-
<h2>界面预览</h2>
|
|
60
|
-
<div id="preview" class="preview"><div class="empty">选择左侧的页面。</div></div>
|
|
61
|
-
</section>
|
|
62
|
-
<section>
|
|
63
|
-
<h2>宿主资源</h2>
|
|
64
|
-
<p class="hint">
|
|
65
|
-
平台图标可直接写入 Manifest:<code>icon: { kind: 'host', name: 'platform.tx' }</code>
|
|
66
|
-
</p>
|
|
67
|
-
<div id="icons" class="icons"></div>
|
|
68
|
-
<div id="static-assets" class="static-assets"></div>
|
|
69
|
-
<p class="hint">工具:<code>ctx.utils.lodash</code> · 64 个带类型提示的常用方法</p>
|
|
70
|
-
</section>
|
|
71
|
-
</article>
|
|
72
|
-
<section class="log-column">
|
|
73
|
-
<div class="row">
|
|
74
|
-
<h2>运行日志</h2>
|
|
75
|
-
<button id="clear-log">清空</button>
|
|
76
|
-
</div>
|
|
77
|
-
<p class="hint">
|
|
78
|
-
使用 VS Code 的 “Attach to Ceru plugin” 或 Electron DevTools 调试 TS
|
|
79
|
-
源码。日志已对常见敏感字段脱敏。
|
|
80
|
-
</p>
|
|
81
|
-
<div id="logs"></div>
|
|
82
|
-
</section>
|
|
83
|
-
</main>
|
|
84
|
-
<div id="runners" class="hidden"></div>
|
|
85
|
-
<footer>
|
|
86
|
-
这是开发 Host。实际运行逻辑与界面;网络默认拒绝。生产安装授权、凭据保险箱、Guest
|
|
87
|
-
安装及完整音乐业务仍由正式 Host 实现。
|
|
88
|
-
</footer>
|
|
89
|
-
<script nonce="{{NONCE}}">
|
|
90
|
-
window.CERU_DEV_TOKEN={{TOKEN}};
|
|
91
|
-
</script>
|
|
92
|
-
<script type="module" src="/playground.js"></script>
|
|
93
|
-
</body>
|
|
94
|
-
</html>
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="zh-CN">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8" />
|
|
5
|
+
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
|
6
|
+
<title>Ceru Plugin Dev</title>
|
|
7
|
+
<link rel="stylesheet" href="/style.css" />
|
|
8
|
+
</head>
|
|
9
|
+
<body>
|
|
10
|
+
<header>
|
|
11
|
+
<div>
|
|
12
|
+
<span class="badge">CERU / DEV HOST</span>
|
|
13
|
+
<h1 id="plugin-name">插件调试工作台</h1>
|
|
14
|
+
<p id="plugin-meta">TypeScript · 单文件构建 · 隔离运行</p>
|
|
15
|
+
</div>
|
|
16
|
+
<div class="header-actions">
|
|
17
|
+
<span id="status" class="status">启动中</span><button id="restart">重新运行</button
|
|
18
|
+
><button id="stop">停止</button>
|
|
19
|
+
</div>
|
|
20
|
+
</header>
|
|
21
|
+
<div id="build-error" class="error hidden"></div>
|
|
22
|
+
<main>
|
|
23
|
+
<aside>
|
|
24
|
+
<section>
|
|
25
|
+
<h2>能力注册</h2>
|
|
26
|
+
<div id="registrations"></div>
|
|
27
|
+
</section>
|
|
28
|
+
<section>
|
|
29
|
+
<h2>界面与兼容模块</h2>
|
|
30
|
+
<div id="views"></div>
|
|
31
|
+
</section>
|
|
32
|
+
<section>
|
|
33
|
+
<h2>运行时配置</h2>
|
|
34
|
+
<p class="hint">仅保存在当前开发会话中。</p>
|
|
35
|
+
<textarea id="config" spellcheck="false">{}</textarea
|
|
36
|
+
><button id="apply-config">应用配置并重载</button>
|
|
37
|
+
</section>
|
|
38
|
+
<section>
|
|
39
|
+
<h2>权限模拟</h2>
|
|
40
|
+
<div id="permissions"></div>
|
|
41
|
+
</section>
|
|
42
|
+
</aside>
|
|
43
|
+
<article>
|
|
44
|
+
<section>
|
|
45
|
+
<h2>搜索与解析</h2>
|
|
46
|
+
<div class="row">
|
|
47
|
+
<select id="provider" disabled aria-label="搜索来源"></select
|
|
48
|
+
><input id="query" placeholder="输入关键词" disabled /><button id="search" class="primary" disabled>
|
|
49
|
+
调用搜索</button
|
|
50
|
+
><button id="cancel" disabled>取消调用</button>
|
|
51
|
+
</div>
|
|
52
|
+
<p id="search-status" class="hint" role="status" aria-live="polite">正在读取插件能力…</p>
|
|
53
|
+
<div id="results" class="results">
|
|
54
|
+
<div class="empty">插件启动后可以调用已注册的搜索方法。</div>
|
|
55
|
+
</div>
|
|
56
|
+
<pre id="result-detail"></pre>
|
|
57
|
+
</section>
|
|
58
|
+
<section>
|
|
59
|
+
<div class="row"><h2>界面预览</h2><button id="close-view">关闭页面</button></div>
|
|
60
|
+
<div id="preview" class="preview"><div class="empty">选择左侧的页面。</div></div>
|
|
61
|
+
</section>
|
|
62
|
+
<section>
|
|
63
|
+
<h2>宿主资源</h2>
|
|
64
|
+
<p class="hint">
|
|
65
|
+
平台图标可直接写入 Manifest:<code>icon: { kind: 'host', name: 'platform.tx' }</code>
|
|
66
|
+
</p>
|
|
67
|
+
<div id="icons" class="icons"></div>
|
|
68
|
+
<div id="static-assets" class="static-assets"></div>
|
|
69
|
+
<p class="hint">工具:<code>ctx.utils.lodash</code> · 64 个带类型提示的常用方法</p>
|
|
70
|
+
</section>
|
|
71
|
+
</article>
|
|
72
|
+
<section class="log-column">
|
|
73
|
+
<div class="row">
|
|
74
|
+
<h2>运行日志</h2>
|
|
75
|
+
<button id="clear-log">清空</button>
|
|
76
|
+
</div>
|
|
77
|
+
<p class="hint">
|
|
78
|
+
使用 VS Code 的 “Attach to Ceru plugin” 或 Electron DevTools 调试 TS
|
|
79
|
+
源码。日志已对常见敏感字段脱敏。
|
|
80
|
+
</p>
|
|
81
|
+
<div id="logs"></div>
|
|
82
|
+
</section>
|
|
83
|
+
</main>
|
|
84
|
+
<div id="runners" class="hidden"></div>
|
|
85
|
+
<footer>
|
|
86
|
+
这是开发 Host。实际运行逻辑与界面;网络默认拒绝。生产安装授权、凭据保险箱、Guest
|
|
87
|
+
安装及完整音乐业务仍由正式 Host 实现。
|
|
88
|
+
</footer>
|
|
89
|
+
<script nonce="{{NONCE}}">
|
|
90
|
+
window.CERU_DEV_TOKEN={{TOKEN}};
|
|
91
|
+
</script>
|
|
92
|
+
<script type="module" src="/playground.js"></script>
|
|
93
|
+
</body>
|
|
94
|
+
</html>
|
|
@@ -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
|
+
}
|
package/assets/playground.js
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
import {
|
|
2
2
|
assertContentPage,
|
|
3
|
+
assertAccountSummary,
|
|
3
4
|
assertLyricsDocument,
|
|
4
5
|
assertResolveResult,
|
|
5
6
|
PERMISSION_GROUPS,
|
|
6
7
|
permissionGroup,
|
|
8
|
+
SurfaceSession,
|
|
7
9
|
} from './core-contracts.js'
|
|
10
|
+
import { NativeSurfacePreview } from './native-view.js'
|
|
8
11
|
const $ = (id) => document.getElementById(id)
|
|
9
12
|
let state,
|
|
10
13
|
revision = 0,
|
|
@@ -12,10 +15,14 @@ let state,
|
|
|
12
15
|
stopped = false,
|
|
13
16
|
viewId = null,
|
|
14
17
|
currentInvocation
|
|
18
|
+
let viewSession
|
|
19
|
+
let nativePreview
|
|
20
|
+
let viewTransition = Promise.resolve()
|
|
15
21
|
const frames = new Map(),
|
|
16
22
|
calls = new Map(),
|
|
17
23
|
registrations = new Map(),
|
|
18
24
|
surfaceStates = new Map()
|
|
25
|
+
const accountButtons = new Map()
|
|
19
26
|
const api = async (path, data) => {
|
|
20
27
|
const response = await fetch('/api/' + path, {
|
|
21
28
|
method: data === undefined ? 'GET' : 'POST',
|
|
@@ -51,9 +58,14 @@ function post(frame, type, data) {
|
|
|
51
58
|
frame.element.contentWindow?.postMessage({ type, data, generation: frame.generation }, '*')
|
|
52
59
|
}
|
|
53
60
|
function removeFrames() {
|
|
61
|
+
nativePreview?.dispose()
|
|
62
|
+
nativePreview = undefined
|
|
63
|
+
$('preview').replaceChildren()
|
|
64
|
+
void viewSession?.close().catch(error => log('error', error.message))
|
|
65
|
+
viewSession = undefined
|
|
54
66
|
void api('rpc', { method: 'sockets.closeAll' }).catch(() => {})
|
|
55
67
|
document.getElementById('host-playlist-import')?.remove()
|
|
56
|
-
for (const frame of frames.values()) frame.element.remove()
|
|
68
|
+
for (const frame of frames.values()) { post(frame, 'dispose'); frame.element.remove() }
|
|
57
69
|
frames.clear()
|
|
58
70
|
registrations.clear()
|
|
59
71
|
for (const call of calls.values()) {
|
|
@@ -61,6 +73,7 @@ function removeFrames() {
|
|
|
61
73
|
call.reject(new Error('Plugin reloaded or stopped'))
|
|
62
74
|
}
|
|
63
75
|
calls.clear()
|
|
76
|
+
surfaceStates.clear()
|
|
64
77
|
currentInvocation = null
|
|
65
78
|
$('results').replaceChildren()
|
|
66
79
|
$('result-detail').textContent = ''
|
|
@@ -89,7 +102,7 @@ function start() {
|
|
|
89
102
|
$('status').textContent = '加载中'
|
|
90
103
|
if (state.manifest.modules.logic) mount(state.manifest.modules.logic.entry, 'logic', $('runners'))
|
|
91
104
|
else $('status').textContent = '无后台入口'
|
|
92
|
-
|
|
105
|
+
// Views open only after logic activation, when their actions have registered.
|
|
93
106
|
updateSearchControls()
|
|
94
107
|
}
|
|
95
108
|
function hasProtocol(providerId, protocol) {
|
|
@@ -183,14 +196,24 @@ function drawRegistrations() {
|
|
|
183
196
|
$('registrations').textContent = stopped ? '插件已停止' : '等待后台模块注册命令或能力'
|
|
184
197
|
updateSearchControls()
|
|
185
198
|
}
|
|
186
|
-
function invoke(frame, kind, target, method, args) {
|
|
199
|
+
function invoke(frame, kind, target, method, args, signal) {
|
|
187
200
|
const id = 'call-' + ++sequence
|
|
188
201
|
currentInvocation = { frame, id }
|
|
189
202
|
log('info', { call: kind === 'action' ? target : target + '.' + method })
|
|
190
203
|
return new Promise((resolve, reject) => {
|
|
204
|
+
const cancel = () => {
|
|
205
|
+
const call = calls.get(id)
|
|
206
|
+
if (!call) return
|
|
207
|
+
clearTimeout(call.timer)
|
|
208
|
+
calls.delete(id)
|
|
209
|
+
post(frame, 'cancel', { id })
|
|
210
|
+
reject(new Error('Surface invocation cancelled'))
|
|
211
|
+
}
|
|
212
|
+
signal?.addEventListener('abort', cancel, { once: true })
|
|
191
213
|
calls.set(id, {
|
|
192
214
|
frame,
|
|
193
215
|
resolve: (value) => {
|
|
216
|
+
signal?.removeEventListener('abort', cancel)
|
|
194
217
|
try {
|
|
195
218
|
if (
|
|
196
219
|
kind === 'playlist-importer' ||
|
|
@@ -203,14 +226,16 @@ function invoke(frame, kind, target, method, args) {
|
|
|
203
226
|
resolve(value)
|
|
204
227
|
} catch (error) { reject(error) }
|
|
205
228
|
},
|
|
206
|
-
reject,
|
|
229
|
+
reject: error => { signal?.removeEventListener('abort', cancel); reject(error) },
|
|
207
230
|
timer: setTimeout(() => {
|
|
208
231
|
calls.delete(id)
|
|
209
232
|
updateSearchControls()
|
|
210
233
|
post(frame, 'cancel', { id })
|
|
234
|
+
signal?.removeEventListener('abort', cancel)
|
|
211
235
|
reject(new Error('Invocation timed out'))
|
|
212
236
|
}, 20000),
|
|
213
237
|
})
|
|
238
|
+
if (signal?.aborted) { cancel(); return }
|
|
214
239
|
updateSearchControls()
|
|
215
240
|
post(frame, 'invoke', { id, kind, target, method, args })
|
|
216
241
|
})
|
|
@@ -227,10 +252,10 @@ function showResult(value) {
|
|
|
227
252
|
}
|
|
228
253
|
return value
|
|
229
254
|
}
|
|
230
|
-
function runAction(action, input) {
|
|
255
|
+
function runAction(action, input = {}, signal) {
|
|
231
256
|
const item = registrations.get('action:' + action)
|
|
232
257
|
if (!item) return Promise.reject(new Error('Action is not registered: ' + action))
|
|
233
|
-
return invoke(item.frame, 'action', action, '', [input])
|
|
258
|
+
return invoke(item.frame, 'action', action, '', [input], signal)
|
|
234
259
|
}
|
|
235
260
|
|
|
236
261
|
// A single Host-owned preview for all importers. Plugins contribute data callbacks only.
|
|
@@ -324,6 +349,28 @@ function renderSchema(node, values, container) {
|
|
|
324
349
|
container.append(text)
|
|
325
350
|
}
|
|
326
351
|
function showView(id, mountInfo = { kind: 'page' }) {
|
|
352
|
+
viewTransition = viewTransition.catch(() => {}).then(async () => {
|
|
353
|
+
await closeView()
|
|
354
|
+
if (stopped) return
|
|
355
|
+
mountView(id, mountInfo)
|
|
356
|
+
})
|
|
357
|
+
return viewTransition.catch(error => log('error', error.message))
|
|
358
|
+
}
|
|
359
|
+
async function closeView() {
|
|
360
|
+
nativePreview?.dispose()
|
|
361
|
+
nativePreview = undefined
|
|
362
|
+
const previous = viewSession
|
|
363
|
+
viewSession = undefined
|
|
364
|
+
viewId = null
|
|
365
|
+
for (const [key, frame] of frames) if (frame.kind !== 'logic') {
|
|
366
|
+
post(frame, 'dispose')
|
|
367
|
+
frame.element.remove()
|
|
368
|
+
frames.delete(key)
|
|
369
|
+
}
|
|
370
|
+
$('preview').replaceChildren()
|
|
371
|
+
await previous?.close()
|
|
372
|
+
}
|
|
373
|
+
function mountView(id, mountInfo) {
|
|
327
374
|
viewId = id
|
|
328
375
|
for (const [key, frame] of frames)
|
|
329
376
|
if (frame.kind !== 'logic') {
|
|
@@ -332,7 +379,21 @@ function showView(id, mountInfo = { kind: 'page' }) {
|
|
|
332
379
|
}
|
|
333
380
|
$('preview').replaceChildren()
|
|
334
381
|
const view = state.manifest.modules.surfaces?.find((v) => v.id === id)
|
|
335
|
-
if (view?.kind === 'web')
|
|
382
|
+
if (view?.kind === 'web') {
|
|
383
|
+
viewSession = new SurfaceSession(view, state.manifest, runAction)
|
|
384
|
+
const frame = mount(view.entry, 'web', $('preview'), mountInfo)
|
|
385
|
+
frame.surfaceId = id
|
|
386
|
+
frame.session = viewSession
|
|
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
|
+
}
|
|
336
397
|
else if (view?.kind === 'schema')
|
|
337
398
|
renderSchema(
|
|
338
399
|
state.resources[view.entry]?.value?.root,
|
|
@@ -349,6 +410,15 @@ function drawStatic() {
|
|
|
349
410
|
$('plugin-meta').textContent =
|
|
350
411
|
state.manifest.id + ' · v' + state.manifest.version + ' · revision ' + revision
|
|
351
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
|
+
}
|
|
352
422
|
for (const view of [
|
|
353
423
|
...(state.manifest.modules.surfaces || []),
|
|
354
424
|
...(state.manifest.contributes?.guestAdapters || []),
|
|
@@ -470,6 +540,23 @@ function drawStatic() {
|
|
|
470
540
|
$('static-assets').append(card)
|
|
471
541
|
}
|
|
472
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
|
+
}
|
|
473
560
|
window.addEventListener('message', async (event) => {
|
|
474
561
|
const frame = [...frames.values()].find((f) => f.element.contentWindow === event.source)
|
|
475
562
|
if (!frame || !event.data?.type) return
|
|
@@ -478,7 +565,7 @@ window.addEventListener('message', async (event) => {
|
|
|
478
565
|
post(frame, 'init', {
|
|
479
566
|
generation: frame.generation,
|
|
480
567
|
kind: frame.kind,
|
|
481
|
-
manifest: state.manifest,
|
|
568
|
+
manifest: frame.kind === 'web' ? { ...state.manifest, config: {} } : state.manifest,
|
|
482
569
|
catalog: state.catalog,
|
|
483
570
|
resources: state.resources,
|
|
484
571
|
mount: frame.mountInfo,
|
|
@@ -493,6 +580,13 @@ window.addEventListener('message', async (event) => {
|
|
|
493
580
|
$('status').textContent = '运行中'
|
|
494
581
|
log('info', frame.moduleId + ' activated')
|
|
495
582
|
drawRegistrations()
|
|
583
|
+
if (frame.kind === 'web') {
|
|
584
|
+
post(frame, 'state', surfaceStates.get(frame.surfaceId) ?? {})
|
|
585
|
+
void frame.session.open().catch(error => log('error', error.message))
|
|
586
|
+
} else if (frame.kind === 'logic') {
|
|
587
|
+
void refreshAccountItems()
|
|
588
|
+
if (viewId) void showView(viewId)
|
|
589
|
+
}
|
|
496
590
|
}
|
|
497
591
|
if (message.type === 'failed') {
|
|
498
592
|
frame.failed = true
|
|
@@ -506,7 +600,7 @@ window.addEventListener('message', async (event) => {
|
|
|
506
600
|
}
|
|
507
601
|
if (message.type === 'log') log(data.level, data.values)
|
|
508
602
|
if (message.type === 'notify') log(data.level, data.message)
|
|
509
|
-
if (message.type === 'open-view') showView(data.surfaceId)
|
|
603
|
+
if (message.type === 'open-view' && frame.kind === 'logic') void showView(data.surfaceId)
|
|
510
604
|
if (message.type === 'register') {
|
|
511
605
|
if (frame.kind !== 'logic') return
|
|
512
606
|
const valid =
|
|
@@ -526,8 +620,11 @@ window.addEventListener('message', async (event) => {
|
|
|
526
620
|
drawRegistrations()
|
|
527
621
|
}
|
|
528
622
|
if (message.type === 'state' && frame.kind === 'logic') {
|
|
623
|
+
const changed = JSON.stringify(surfaceStates.get(data.surfaceId)) !== JSON.stringify(data.state)
|
|
529
624
|
surfaceStates.set(data.surfaceId, data.state)
|
|
530
|
-
|
|
625
|
+
if (changed) void refreshAccountItems(data.surfaceId)
|
|
626
|
+
if (changed && viewId === data.surfaceId) void nativePreview?.refresh()
|
|
627
|
+
for (const view of frames.values()) if (view.kind === 'web' && view.surfaceId === data.surfaceId) post(view, 'state', data.state)
|
|
531
628
|
if (
|
|
532
629
|
viewId === data.surfaceId &&
|
|
533
630
|
state.manifest.modules.surfaces?.find((v) => v.id === viewId)?.kind === 'schema'
|
|
@@ -547,7 +644,7 @@ window.addEventListener('message', async (event) => {
|
|
|
547
644
|
try {
|
|
548
645
|
let value
|
|
549
646
|
if (data.method === 'surface.invoke' && frame.kind === 'web')
|
|
550
|
-
value =
|
|
647
|
+
value = await frame.session.invoke(data.data.action, data.data.input ?? {})
|
|
551
648
|
else if (frame.kind !== 'logic')
|
|
552
649
|
throw new Error('This Surface/Guest cannot call a logic Host API directly')
|
|
553
650
|
else if (data.method === 'permissions.requestGroup') {
|
|
@@ -670,6 +767,7 @@ $('stop').onclick = () => {
|
|
|
670
767
|
$('status').textContent = '已停止'
|
|
671
768
|
}
|
|
672
769
|
$('clear-log').onclick = () => $('logs').replaceChildren()
|
|
770
|
+
$('close-view').onclick = () => { void closeView().catch(error => log('error', error.message)) }
|
|
673
771
|
$('apply-config').onclick = async () => {
|
|
674
772
|
try {
|
|
675
773
|
await api('config', JSON.parse($('config').value))
|