@shiqianjiang/ceru-plugin-cli 0.2.4 → 0.2.6
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 +1 -1
- package/assets/core-contracts.js +1 -1
- package/assets/playground.js +5 -1
- package/assets/sandbox.js +16 -16
- package/dist/index.js +1 -1
- package/dist/project.js +67 -19
- package/package.json +71 -71
- package/schemas/config.schema.json +93 -0
- package/templates/connected-library/js/package.json +22 -22
- package/templates/connected-library/ts/package.json +22 -22
- 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/package.json +22 -22
- package/templates/web-surface/ts/package.json +22 -22
package/README.md
CHANGED
|
@@ -24,7 +24,7 @@ ceru-plugin sign dist/plugin.js --key .keys/publisher.private.pem
|
|
|
24
24
|
|
|
25
25
|
Vue/React 生产运行代码会直接打入发行文件,不依赖宿主提供框架。执行 `ceru-plugin preview dist/plugin.js` 可以只加载最终文件验证页面。0.2.0 起发行格式使用静态 `exports.manifest / exports.activate / exports.surfaces`,并支持手写单文件插件。
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
构建产物先用 `const` 定义具名入口(如 `LogicMain`、`UiStudioSurface`)及模块表,再在文件末尾集中写入 `exports.activate / exports.surfaces / exports.resources`,方便阅读单文件产物和定位错误堆栈。插件源码仍可按需要使用函数或 class;构建器不会强制某一种编程风格。
|
|
28
28
|
|
|
29
29
|
`ceru.plugin.json` 的顶层 `config` 可直接写 JSON 对象,也可写 `@./path/config.ts` 引用 JSON/JS/TS 配置模块。字符串 `@@value` 表示字面量 `@value`。构建器递归展开引用,校验为 JSON 兼容对象,并合并到单文件的 `exports.manifest.config` 中。dev/build 会生成不包含配置值的 `@ceru/plugin-config` 类型声明。
|
|
30
30
|
|
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
|
|
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};
|
package/assets/playground.js
CHANGED
|
@@ -245,6 +245,9 @@ function openPlaylistImport(importerId, initialValue = '') {
|
|
|
245
245
|
const title = document.createElement('h3'); title.textContent = meta.title
|
|
246
246
|
const description = document.createElement('p'); description.textContent = meta.description || '粘贴歌单链接或 ID'
|
|
247
247
|
const input = document.createElement('input'); input.placeholder = meta.placeholder || '歌单链接或 ID'; input.value = initialValue
|
|
248
|
+
const examples = document.createElement('ul')
|
|
249
|
+
for (const example of meta.examples || []) { const li = document.createElement('li'); li.textContent = example.label + ':' + example.value; examples.append(li) }
|
|
250
|
+
for (const note of meta.instructions || []) { const li = document.createElement('li'); li.textContent = note; examples.append(li) }
|
|
248
251
|
const load = document.createElement('button'); load.textContent = '读取歌曲'
|
|
249
252
|
const close = document.createElement('button'); close.textContent = '关闭'; close.onclick = () => dialog.close()
|
|
250
253
|
const detail = document.createElement('pre')
|
|
@@ -265,7 +268,7 @@ function openPlaylistImport(importerId, initialValue = '') {
|
|
|
265
268
|
} catch (error) { detail.textContent = error.message }
|
|
266
269
|
finally { load.disabled = false }
|
|
267
270
|
}
|
|
268
|
-
dialog.append(title, description, input, load, close, hint, detail)
|
|
271
|
+
dialog.append(title, description, input, examples, load, close, hint, detail)
|
|
269
272
|
document.body.append(dialog); dialog.showModal()
|
|
270
273
|
dialog.addEventListener('close', () => dialog.remove(), { once: true })
|
|
271
274
|
}
|
|
@@ -511,6 +514,7 @@ window.addEventListener('message', async (event) => {
|
|
|
511
514
|
? state.manifest.contributes?.providers?.some((p) => p.id === data.id)
|
|
512
515
|
: data.kind === 'playlist-importer'
|
|
513
516
|
? state.manifest.contributes?.playlistImporters?.some((p) => p.id === data.id)
|
|
517
|
+
: data.kind === 'lyric-converter' ? state.manifest.contributes?.lyricConverters?.some((p) => p.id === data.id)
|
|
514
518
|
: state.manifest.contributes?.commands?.some((p) => p.action === data.id)
|
|
515
519
|
if (valid) {
|
|
516
520
|
registrations.set(data.kind + ':' + data.id, { ...data, frame })
|