create-songloft-plugin 2.0.0-alpha.1

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/dist/index.js ADDED
@@ -0,0 +1,184 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/index.ts
4
+ import { readdirSync, statSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, existsSync } from "fs";
5
+ import { dirname, join, relative, resolve } from "path";
6
+ import { fileURLToPath } from "url";
7
+ import { input, select, checkbox, confirm } from "@inquirer/prompts";
8
+ var __filename = fileURLToPath(import.meta.url);
9
+ var __dirname = dirname(__filename);
10
+ var SDK_VERSION = "^2.0.0-alpha.1";
11
+ var BUILDER_VERSION = "^2.0.0-alpha.1";
12
+ var AVAILABLE_PERMISSIONS = [
13
+ { name: "storage (\u6301\u4E45\u5316\u5B58\u50A8 - storage API)", value: "storage" },
14
+ { name: "songs.read (\u8BFB\u53D6\u6B4C\u66F2\u5217\u8868/\u5143\u6570\u636E)", value: "songs.read" },
15
+ { name: "songs.write (\u5199\u5165/\u4FEE\u6539\u6B4C\u66F2\u5143\u6570\u636E)", value: "songs.write" },
16
+ { name: "playlists.read (\u8BFB\u53D6\u6B4C\u5355\u53CA\u6B4C\u5355\u4E2D\u7684\u6B4C\u66F2)", value: "playlists.read" },
17
+ { name: "playlists.write (\u521B\u5EFA/\u4FEE\u6539/\u5220\u9664\u6B4C\u5355\u53CA\u5176\u6B4C\u66F2)", value: "playlists.write" },
18
+ { name: "inter-plugin (\u4E0E\u5176\u4ED6\u63D2\u4EF6\u901A\u4FE1)", value: "inter-plugin" },
19
+ { name: "command (\u6267\u884C\u5BBF\u4E3B\u63D0\u4F9B\u7684\u6307\u4EE4)", value: "command" }
20
+ ];
21
+ function parseArgs(argv) {
22
+ const args = argv.slice(2);
23
+ const out = {};
24
+ for (const a of args) {
25
+ if (!a.startsWith("-")) {
26
+ out.targetDir = a;
27
+ break;
28
+ }
29
+ }
30
+ return out;
31
+ }
32
+ function validateIdentifier(v) {
33
+ if (!v || !v.trim()) return "\u4E0D\u80FD\u4E3A\u7A7A";
34
+ if (v.length > 64) return "\u6700\u957F 64 \u4E2A\u5B57\u7B26";
35
+ return true;
36
+ }
37
+ function validateEntryPath(v) {
38
+ if (!v || !v.trim()) return "\u4E0D\u80FD\u4E3A\u7A7A";
39
+ if (!/^[a-z0-9][a-z0-9\-_]*$/.test(v)) return "\u4EC5\u5141\u8BB8\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u8FDE\u5B57\u7B26\u3001\u4E0B\u5212\u7EBF\uFF0C\u4E14\u5FC5\u987B\u4EE5\u5B57\u6BCD\u6570\u5B57\u5F00\u5934";
40
+ if (v.length > 64) return "\u6700\u957F 64 \u4E2A\u5B57\u7B26";
41
+ return true;
42
+ }
43
+ async function prompt(initialTarget) {
44
+ const targetDir = initialTarget ? initialTarget : await input({ message: "\u76EE\u6807\u76EE\u5F55\u540D\u79F0", default: "my-songloft-plugin", validate: validateIdentifier });
45
+ const defaultEntryPath = targetDir.toLowerCase().replace(/[^a-z0-9_-]/g, "-").replace(/^-+|-+$/g, "").replace(/--+/g, "-") || "my-plugin";
46
+ const name = await input({
47
+ message: "\u63D2\u4EF6\u663E\u793A\u540D\u79F0 (name)",
48
+ default: targetDir,
49
+ validate: validateIdentifier
50
+ });
51
+ const entryPath = await input({
52
+ message: "\u63D2\u4EF6\u5165\u53E3\u8DEF\u5F84 entryPath (URL \u8DEF\u5F84\u6BB5\uFF0C\u552F\u4E00\u6807\u8BC6)",
53
+ default: defaultEntryPath,
54
+ validate: validateEntryPath
55
+ });
56
+ const description = await input({
57
+ message: "\u63D2\u4EF6\u7B80\u4ECB",
58
+ default: "A Songloft plugin"
59
+ });
60
+ const author = await input({
61
+ message: "\u4F5C\u8005",
62
+ default: ""
63
+ });
64
+ const permissions = await checkbox({
65
+ message: "\u9009\u62E9\u63D2\u4EF6\u9700\u8981\u7684\u6743\u9650\uFF08\u53EF\u591A\u9009\uFF09",
66
+ choices: AVAILABLE_PERMISSIONS
67
+ });
68
+ const packageManager = await select({
69
+ message: "\u9009\u62E9\u5305\u7BA1\u7406\u5668",
70
+ choices: [
71
+ { name: "pnpm", value: "pnpm" },
72
+ { name: "npm", value: "npm" },
73
+ { name: "yarn", value: "yarn" }
74
+ ],
75
+ default: "pnpm"
76
+ });
77
+ return { targetDir, name, entryPath, description, author, permissions, packageManager };
78
+ }
79
+ function resolveTemplateRoot() {
80
+ const candidate = resolve(__dirname, "..", "templates", "basic");
81
+ if (existsSync(candidate)) return candidate;
82
+ throw new Error(`\u6A21\u677F\u76EE\u5F55\u4E0D\u5B58\u5728: ${candidate}`);
83
+ }
84
+ function walk(dir, base, out) {
85
+ for (const entry of readdirSync(dir)) {
86
+ const abs = join(dir, entry);
87
+ const rel = relative(base, abs);
88
+ if (statSync(abs).isDirectory()) {
89
+ walk(abs, base, out);
90
+ } else {
91
+ out.push(rel);
92
+ }
93
+ }
94
+ }
95
+ function renderTemplate(content, vars) {
96
+ return content.replace(/\{\{(\w+)\}\}/g, (_m, key) => {
97
+ return Object.prototype.hasOwnProperty.call(vars, key) ? vars[key] : _m;
98
+ });
99
+ }
100
+ function writeWithDirs(targetFile, content) {
101
+ mkdirSync(dirname(targetFile), { recursive: true });
102
+ if (typeof content === "string") {
103
+ writeFileSync(targetFile, content, "utf8");
104
+ } else {
105
+ writeFileSync(targetFile, content);
106
+ }
107
+ }
108
+ async function scaffold(answers) {
109
+ const cwd = process.cwd();
110
+ const targetAbs = resolve(cwd, answers.targetDir);
111
+ if (existsSync(targetAbs)) {
112
+ const items = readdirSync(targetAbs);
113
+ if (items.length > 0) {
114
+ const ok = await confirm({
115
+ message: `\u76EE\u5F55 ${answers.targetDir} \u975E\u7A7A\uFF0C\u662F\u5426\u7EE7\u7EED\uFF08\u5DF2\u6709\u540C\u540D\u6587\u4EF6\u4F1A\u88AB\u8986\u76D6\uFF09?`,
116
+ default: false
117
+ });
118
+ if (!ok) {
119
+ console.log("\u5DF2\u53D6\u6D88\u3002");
120
+ process.exit(1);
121
+ }
122
+ }
123
+ } else {
124
+ mkdirSync(targetAbs, { recursive: true });
125
+ }
126
+ const templateRoot = resolveTemplateRoot();
127
+ const files = [];
128
+ walk(templateRoot, templateRoot, files);
129
+ const textExts = /* @__PURE__ */ new Set([".json", ".ts", ".js", ".md", ".yml", ".yaml", ".html", ".css"]);
130
+ const textBasenames = /* @__PURE__ */ new Set(["_gitignore", ".gitignore", "README", "LICENSE"]);
131
+ const vars = {
132
+ name: answers.name,
133
+ entryPath: answers.entryPath,
134
+ description: answers.description,
135
+ author: answers.author,
136
+ permissions: JSON.stringify(answers.permissions),
137
+ year: String((/* @__PURE__ */ new Date()).getFullYear())
138
+ };
139
+ for (const rel of files) {
140
+ const src = join(templateRoot, rel);
141
+ const relRenamed = rel.split(/[\\/]/).map((seg) => seg === "_gitignore" ? ".gitignore" : seg).join("/");
142
+ const dst = join(targetAbs, relRenamed);
143
+ const dotIdx = rel.lastIndexOf(".");
144
+ const ext = dotIdx >= 0 ? rel.slice(dotIdx).toLowerCase() : "";
145
+ const base = rel.split(/[\\/]/).pop() ?? rel;
146
+ const isText = textExts.has(ext) || textBasenames.has(base);
147
+ if (!isText) {
148
+ mkdirSync(dirname(dst), { recursive: true });
149
+ copyFileSync(src, dst);
150
+ continue;
151
+ }
152
+ let content = readFileSync(src, "utf8");
153
+ content = renderTemplate(content, vars);
154
+ if (base === "package.json") {
155
+ content = content.replace(/"@songloft\/plugin-sdk":\s*"workspace:\^?"/g, `"@songloft/plugin-sdk": "${SDK_VERSION}"`).replace(/"@songloft\/plugin-builder":\s*"workspace:\^?"/g, `"@songloft/plugin-builder": "${BUILDER_VERSION}"`);
156
+ }
157
+ writeWithDirs(dst, content);
158
+ }
159
+ console.log("");
160
+ console.log(`\u2705 \u5DF2\u521B\u5EFA ${answers.targetDir}`);
161
+ console.log("");
162
+ console.log("\u4E0B\u4E00\u6B65\uFF1A");
163
+ console.log(` cd ${answers.targetDir}`);
164
+ console.log(` ${answers.packageManager} install`);
165
+ console.log(` ${answers.packageManager} run build`);
166
+ console.log("");
167
+ console.log("\u6784\u5EFA\u4EA7\u7269\u4F4D\u4E8E dist/ \u76EE\u5F55\uFF0C\u53EF\u5728 Songloft \u540E\u53F0\u4E0A\u4F20\u3002");
168
+ }
169
+ async function main() {
170
+ const { targetDir } = parseArgs(process.argv);
171
+ try {
172
+ const answers = await prompt(targetDir);
173
+ await scaffold(answers);
174
+ } catch (err) {
175
+ if (err instanceof Error && err.name === "ExitPromptError") {
176
+ console.log("\n\u5DF2\u53D6\u6D88\u3002");
177
+ process.exit(130);
178
+ }
179
+ console.error("\u521B\u5EFA\u5931\u8D25:", err);
180
+ process.exit(1);
181
+ }
182
+ }
183
+ void main();
184
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { readdirSync, statSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, existsSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { input, select, checkbox, confirm } from '@inquirer/prompts';\n\n/**\n * CLI 入口:\n * npx create-songloft-plugin <target-dir>\n * pnpm create songloft-plugin <target-dir>\n *\n * 流程:\n * 1. 确定目标目录(命令行参数 > 交互输入)\n * 2. 交互式询问 name / description / author / entryPath / permissions / package-manager\n * 3. 从 templates/basic/ 拷贝文件到目标目录\n * 4. 将 {{name}} / {{entryPath}} / {{description}} / {{author}} / {{permissions}} / {{year}} 占位符替换为实际值\n * 5. _gitignore 重命名为 .gitignore\n * 6. package.json 中的 workspace:^ 替换为实际 semver(开发期使用,发布后为正常版本号)\n */\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// 发布版依赖版本(与 monorepo 同步发布,维护时需跟随 npm 最新稳定版)\nconst SDK_VERSION = '^2.0.0-alpha.1';\nconst BUILDER_VERSION = '^2.0.0-alpha.1';\n\nconst AVAILABLE_PERMISSIONS = [\n { name: 'storage (持久化存储 - storage API)', value: 'storage' },\n { name: 'songs.read (读取歌曲列表/元数据)', value: 'songs.read' },\n { name: 'songs.write (写入/修改歌曲元数据)', value: 'songs.write' },\n { name: 'playlists.read (读取歌单及歌单中的歌曲)', value: 'playlists.read' },\n { name: 'playlists.write (创建/修改/删除歌单及其歌曲)', value: 'playlists.write' },\n { name: 'inter-plugin (与其他插件通信)', value: 'inter-plugin' },\n { name: 'command (执行宿主提供的指令)', value: 'command' },\n];\n\ninterface Answers {\n targetDir: string;\n name: string;\n entryPath: string;\n description: string;\n author: string;\n permissions: string[];\n packageManager: 'pnpm' | 'npm' | 'yarn';\n}\n\nfunction parseArgs(argv: string[]): { targetDir?: string } {\n const args = argv.slice(2);\n const out: { targetDir?: string } = {};\n for (const a of args) {\n if (!a.startsWith('-')) {\n out.targetDir = a;\n break;\n }\n }\n return out;\n}\n\nfunction validateIdentifier(v: string): string | true {\n if (!v || !v.trim()) return '不能为空';\n if (v.length > 64) return '最长 64 个字符';\n return true;\n}\n\nfunction validateEntryPath(v: string): string | true {\n if (!v || !v.trim()) return '不能为空';\n if (!/^[a-z0-9][a-z0-9\\-_]*$/.test(v)) return '仅允许小写字母、数字、连字符、下划线,且必须以字母数字开头';\n if (v.length > 64) return '最长 64 个字符';\n return true;\n}\n\nasync function prompt(initialTarget?: string): Promise<Answers> {\n const targetDir = initialTarget\n ? initialTarget\n : await input({ message: '目标目录名称', default: 'my-songloft-plugin', validate: validateIdentifier });\n\n const defaultEntryPath = targetDir\n .toLowerCase()\n .replace(/[^a-z0-9_-]/g, '-')\n .replace(/^-+|-+$/g, '')\n .replace(/--+/g, '-') || 'my-plugin';\n\n const name = await input({\n message: '插件显示名称 (name)',\n default: targetDir,\n validate: validateIdentifier,\n });\n\n const entryPath = await input({\n message: '插件入口路径 entryPath (URL 路径段,唯一标识)',\n default: defaultEntryPath,\n validate: validateEntryPath,\n });\n\n const description = await input({\n message: '插件简介',\n default: 'A Songloft plugin',\n });\n\n const author = await input({\n message: '作者',\n default: '',\n });\n\n const permissions = await checkbox({\n message: '选择插件需要的权限(可多选)',\n choices: AVAILABLE_PERMISSIONS,\n });\n\n const packageManager = (await select({\n message: '选择包管理器',\n choices: [\n { name: 'pnpm', value: 'pnpm' },\n { name: 'npm', value: 'npm' },\n { name: 'yarn', value: 'yarn' },\n ],\n default: 'pnpm',\n })) as 'pnpm' | 'npm' | 'yarn';\n\n return { targetDir, name, entryPath, description, author, permissions, packageManager };\n}\n\nfunction resolveTemplateRoot(): string {\n // 发布后 dist/index.js 在 package 根目录 dist 下,模板在 package 根目录 templates/basic 下\n const candidate = resolve(__dirname, '..', 'templates', 'basic');\n if (existsSync(candidate)) return candidate;\n throw new Error(`模板目录不存在: ${candidate}`);\n}\n\nfunction walk(dir: string, base: string, out: string[]): void {\n for (const entry of readdirSync(dir)) {\n const abs = join(dir, entry);\n const rel = relative(base, abs);\n if (statSync(abs).isDirectory()) {\n walk(abs, base, out);\n } else {\n out.push(rel);\n }\n }\n}\n\nfunction renderTemplate(content: string, vars: Record<string, string>): string {\n return content.replace(/\\{\\{(\\w+)\\}\\}/g, (_m, key: string) => {\n return Object.prototype.hasOwnProperty.call(vars, key) ? vars[key] : _m;\n });\n}\n\nfunction writeWithDirs(targetFile: string, content: string | Buffer): void {\n mkdirSync(dirname(targetFile), { recursive: true });\n if (typeof content === 'string') {\n writeFileSync(targetFile, content, 'utf8');\n } else {\n writeFileSync(targetFile, content);\n }\n}\n\nasync function scaffold(answers: Answers): Promise<void> {\n const cwd = process.cwd();\n const targetAbs = resolve(cwd, answers.targetDir);\n\n if (existsSync(targetAbs)) {\n const items = readdirSync(targetAbs);\n if (items.length > 0) {\n const ok = await confirm({\n message: `目录 ${answers.targetDir} 非空,是否继续(已有同名文件会被覆盖)?`,\n default: false,\n });\n if (!ok) {\n console.log('已取消。');\n process.exit(1);\n }\n }\n } else {\n mkdirSync(targetAbs, { recursive: true });\n }\n\n const templateRoot = resolveTemplateRoot();\n const files: string[] = [];\n walk(templateRoot, templateRoot, files);\n\n // 纯文本后缀(会进行变量替换 + workspace 依赖重写)\n const textExts = new Set(['.json', '.ts', '.js', '.md', '.yml', '.yaml', '.html', '.css']);\n // 视为无后缀纯文本的特殊文件名\n const textBasenames = new Set(['_gitignore', '.gitignore', 'README', 'LICENSE']);\n\n const vars: Record<string, string> = {\n name: answers.name,\n entryPath: answers.entryPath,\n description: answers.description,\n author: answers.author,\n permissions: JSON.stringify(answers.permissions),\n year: String(new Date().getFullYear()),\n };\n\n for (const rel of files) {\n const src = join(templateRoot, rel);\n // _gitignore -> .gitignore\n const relRenamed = rel.split(/[\\\\/]/).map((seg) => (seg === '_gitignore' ? '.gitignore' : seg)).join('/');\n const dst = join(targetAbs, relRenamed);\n\n const dotIdx = rel.lastIndexOf('.');\n const ext = dotIdx >= 0 ? rel.slice(dotIdx).toLowerCase() : '';\n const base = rel.split(/[\\\\/]/).pop() ?? rel;\n const isText = textExts.has(ext) || textBasenames.has(base);\n\n if (!isText) {\n mkdirSync(dirname(dst), { recursive: true });\n copyFileSync(src, dst);\n continue;\n }\n\n let content = readFileSync(src, 'utf8');\n content = renderTemplate(content, vars);\n\n // package.json 特殊处理:workspace:^ → 实际发布版本\n if (base === 'package.json') {\n content = content\n .replace(/\"@songloft\\/plugin-sdk\":\\s*\"workspace:\\^?\"/g, `\"@songloft/plugin-sdk\": \"${SDK_VERSION}\"`)\n .replace(/\"@songloft\\/plugin-builder\":\\s*\"workspace:\\^?\"/g, `\"@songloft/plugin-builder\": \"${BUILDER_VERSION}\"`);\n }\n\n writeWithDirs(dst, content);\n }\n\n console.log('');\n console.log(`✅ 已创建 ${answers.targetDir}`);\n console.log('');\n console.log('下一步:');\n console.log(` cd ${answers.targetDir}`);\n console.log(` ${answers.packageManager} install`);\n console.log(` ${answers.packageManager} run build`);\n console.log('');\n console.log('构建产物位于 dist/ 目录,可在 Songloft 后台上传。');\n}\n\nasync function main(): Promise<void> {\n const { targetDir } = parseArgs(process.argv);\n try {\n const answers = await prompt(targetDir);\n await scaffold(answers);\n } catch (err) {\n if (err instanceof Error && err.name === 'ExitPromptError') {\n console.log('\\n已取消。');\n process.exit(130);\n }\n console.error('创建失败:', err);\n process.exit(1);\n }\n}\n\nvoid main();\n"],"mappings":"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","names":[]}
package/package.json ADDED
@@ -0,0 +1,45 @@
1
+ {
2
+ "name": "create-songloft-plugin",
3
+ "version": "2.0.0-alpha.1",
4
+ "description": "Scaffolding tool for Songloft JS plugin projects",
5
+ "type": "module",
6
+ "bin": {
7
+ "create-songloft-plugin": "./dist/index.js"
8
+ },
9
+ "files": [
10
+ "dist",
11
+ "templates",
12
+ "README.md"
13
+ ],
14
+ "dependencies": {
15
+ "@inquirer/prompts": "^7.0.0"
16
+ },
17
+ "devDependencies": {
18
+ "tsup": "^8.0.0",
19
+ "typescript": "^5.7.0",
20
+ "@types/node": "^22.0.0"
21
+ },
22
+ "keywords": [
23
+ "songloft",
24
+ "plugin",
25
+ "create",
26
+ "scaffolding"
27
+ ],
28
+ "repository": {
29
+ "type": "git",
30
+ "url": "git+https://github.com/songloft-org/plugin-toolchain.git",
31
+ "directory": "packages/create-songloft-plugin"
32
+ },
33
+ "homepage": "https://github.com/songloft-org/plugin-toolchain/tree/main/packages/create-songloft-plugin#readme",
34
+ "bugs": {
35
+ "url": "https://github.com/songloft-org/plugin-toolchain/issues"
36
+ },
37
+ "license": "Apache-2.0",
38
+ "publishConfig": {
39
+ "access": "public"
40
+ },
41
+ "scripts": {
42
+ "build": "tsup",
43
+ "test": "echo \"no tests yet\" && exit 0"
44
+ }
45
+ }
@@ -0,0 +1,48 @@
1
+ name: Release Plugin
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ inputs:
6
+ version:
7
+ description: 'Plugin version (e.g. 1.0.0). Leave blank to auto-use plugin.json version.'
8
+ required: false
9
+
10
+ jobs:
11
+ release:
12
+ runs-on: ubuntu-latest
13
+ permissions:
14
+ contents: write
15
+ steps:
16
+ - uses: actions/checkout@v4
17
+
18
+ - uses: actions/setup-node@v4
19
+ with:
20
+ node-version: 20
21
+
22
+ - name: Install dependencies
23
+ run: npm ci
24
+
25
+ - name: Build
26
+ run: npm run build
27
+
28
+ - name: Resolve version
29
+ id: version
30
+ run: |
31
+ if [ -n "${{ github.event.inputs.version }}" ]; then
32
+ VERSION="${{ github.event.inputs.version }}"
33
+ else
34
+ VERSION=$(node -p "require('./plugin.json').version")
35
+ fi
36
+ ENTRY_PATH=$(node -p "require('./plugin.json').entryPath")
37
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
38
+ echo "entryPath=$ENTRY_PATH" >> $GITHUB_OUTPUT
39
+
40
+ - name: Create GitHub Release
41
+ env:
42
+ GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
43
+ run: |
44
+ TAG="jsplugin-${{ steps.version.outputs.entryPath }}-${{ steps.version.outputs.version }}"
45
+ gh release create "$TAG" \
46
+ "dist/${{ steps.version.outputs.entryPath }}.jsplugin.zip" \
47
+ --title "$TAG" \
48
+ --generate-notes
@@ -0,0 +1,24 @@
1
+ # {{name}}
2
+
3
+ A Songloft JS plugin generated by `create-songloft-plugin`.
4
+
5
+ ## Development
6
+
7
+ ```bash
8
+ npm install
9
+ npm run dev # watch + auto-upload to local Songloft
10
+ npm run build # produce dist/{{entryPath}}.jsplugin.zip
11
+ npm run validate # verify plugin.json hashes
12
+ ```
13
+
14
+ ## Description
15
+
16
+ {{description}}
17
+
18
+ ## Author
19
+
20
+ {{author}}
21
+
22
+ ## License
23
+
24
+ Apache-2.0 © {{year}} {{author}}
@@ -0,0 +1,4 @@
1
+ node_modules/
2
+ dist/
3
+ *.log
4
+ .DS_Store
@@ -0,0 +1,17 @@
1
+ {
2
+ "name": "{{entryPath}}",
3
+ "version": "0.1.0",
4
+ "description": "{{description}}",
5
+ "private": true,
6
+ "scripts": {
7
+ "build": "songloft-plugin build",
8
+ "dev": "songloft-plugin dev",
9
+ "validate": "songloft-plugin validate",
10
+ "publish:release": "songloft-plugin publish"
11
+ },
12
+ "devDependencies": {
13
+ "@songloft/plugin-sdk": "workspace:^",
14
+ "@songloft/plugin-builder": "workspace:^",
15
+ "typescript": "^5.7.0"
16
+ }
17
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "$schema": "https://raw.githubusercontent.com/songloft-org/plugin-toolchain/main/schemas/plugin.schema.json",
3
+ "name": "{{name}}",
4
+ "version": "0.1.0",
5
+ "description": "{{description}}",
6
+ "author": "{{author}}",
7
+ "homepage": "",
8
+ "license": "Apache-2.0",
9
+ "entryPath": "{{entryPath}}",
10
+ "main": "main.js",
11
+ "minHostVersion": "1.3.0",
12
+ "permissions": {{permissions}},
13
+ "updateUrl": "",
14
+ "entryHash": "",
15
+ "zipHash": ""
16
+ }
@@ -0,0 +1,32 @@
1
+ /// <reference types="@songloft/plugin-sdk" />
2
+ import { jsonResponse, createRouter } from '@songloft/plugin-sdk';
3
+
4
+ // Router 支持 async handler。所有 songloft.* / fetch 调用必须 await。
5
+
6
+ const router = createRouter();
7
+
8
+ router.get('/hello', (req) => {
9
+ return jsonResponse({ message: 'Hello from {{name}}!', query: req.query });
10
+ });
11
+
12
+ router.get('/songs', async () => {
13
+ const songs = await songloft.songs.list({ limit: 10 });
14
+ return jsonResponse({ count: songs.length, songs });
15
+ });
16
+
17
+ async function onInit(): Promise<void> {
18
+ songloft.log.info('{{name}} initialized');
19
+ }
20
+
21
+ async function onDeinit(): Promise<void> {
22
+ songloft.log.info('{{name}} deinitialized');
23
+ }
24
+
25
+ async function onHTTPRequest(req: HTTPRequest): Promise<HTTPResponse> {
26
+ return await router.handle(req);
27
+ }
28
+
29
+ // 暴露为全局(QuickJS 需要显式声明)
30
+ globalThis.onInit = onInit;
31
+ globalThis.onDeinit = onDeinit;
32
+ globalThis.onHTTPRequest = onHTTPRequest;
@@ -0,0 +1,22 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <title>{{name}}</title>
6
+ <style>
7
+ body { font-family: system-ui, sans-serif; padding: 2rem; }
8
+ h1 { color: #6366f1; }
9
+ pre { background: #f5f5f5; padding: 1rem; border-radius: 4px; }
10
+ </style>
11
+ </head>
12
+ <body>
13
+ <h1>{{name}}</h1>
14
+ <p>Plugin entry UI. Replace this with your own frontend.</p>
15
+ <pre id="out">Loading...</pre>
16
+ <script>
17
+ fetch('./hello').then(r => r.json()).then(data => {
18
+ document.getElementById('out').textContent = JSON.stringify(data, null, 2);
19
+ });
20
+ </script>
21
+ </body>
22
+ </html>
@@ -0,0 +1,14 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2020",
4
+ "module": "ESNext",
5
+ "moduleResolution": "bundler",
6
+ "strict": true,
7
+ "esModuleInterop": true,
8
+ "skipLibCheck": true,
9
+ "forceConsistentCasingInFileNames": true,
10
+ "types": ["@songloft/plugin-sdk"],
11
+ "noEmit": true
12
+ },
13
+ "include": ["src"]
14
+ }