@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.
- package/README.md +2 -0
- package/assets/core-contracts.js +1 -1
- package/assets/native-view.js +125 -0
- package/assets/playground.js +51 -1
- package/assets/sandbox.js +17 -17
- package/assets/style.css +46 -0
- package/dist/dev.js +2 -1
- package/package.json +3 -3
- package/schemas/config.schema.json +35 -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 +2 -2
- 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 +2 -2
- package/templates/connected-library/ts/src/index.ts +52 -1
- package/templates/guest-adapter/js/package.json +2 -2
- package/templates/guest-adapter/ts/package.json +2 -2
- package/templates/importer/js/package.json +2 -2
- package/templates/importer/ts/package.json +2 -2
- package/templates/react/js/package.json +2 -2
- package/templates/react/ts/package.json +2 -2
- package/templates/snapshot.json +1 -1
- package/templates/source/js/package.json +2 -2
- package/templates/source/ts/package.json +2 -2
- package/templates/vue/js/package.json +2 -2
- package/templates/vue/ts/package.json +2 -2
- package/templates/vue-tsx/js/package.json +2 -2
- package/templates/vue-tsx/ts/package.json +2 -2
- package/templates/web-dist/js/package.json +2 -2
- package/templates/web-dist/ts/package.json +2 -2
- package/templates/web-surface/js/package.json +2 -2
- 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 也打包进最终单文件。
|
package/assets/core-contracts.js
CHANGED
|
@@ -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
|
+
}
|
package/assets/playground.js
CHANGED
|
@@ -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'
|
|
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 &&
|