create-songloft-plugin 2.15.0 → 2.17.0

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 CHANGED
@@ -7,9 +7,9 @@ import { fileURLToPath } from "url";
7
7
  import { input, select, checkbox, confirm } from "@inquirer/prompts";
8
8
  var __filename = fileURLToPath(import.meta.url);
9
9
  var __dirname = dirname(__filename);
10
- var SDK_VERSION = "^2.15.0";
11
- var CLIENT_SDK_VERSION = "^2.15.0";
12
- var BUILDER_VERSION = "^2.15.0";
10
+ var SDK_VERSION = "^2.17.0";
11
+ var CLIENT_SDK_VERSION = "^2.17.0";
12
+ var BUILDER_VERSION = "^2.17.0";
13
13
  var AVAILABLE_PERMISSIONS = [
14
14
  { name: "storage (\u6301\u4E45\u5316\u5B58\u50A8 - storage API)", value: "storage" },
15
15
  { name: "persistent-storage (\u5378\u8F7D\u540E\u4FDD\u7559\u7684\u6301\u4E45\u5316\u5B58\u50A8)", value: "persistent-storage" },
@@ -89,7 +89,6 @@ async function prompt(initialTarget) {
89
89
  choices: [
90
90
  { name: "Vanilla JS (\u4F20\u7EDF\u9759\u6001\u9875\u9762)", value: "vanilla" },
91
91
  { name: "Vue 3 + Vite (\u73B0\u4EE3\u5316\u5F00\u53D1\u4F53\u9A8C)", value: "vue" },
92
- { name: "WebF \u539F\u751F\u6E32\u67D3 (Vue 3 + \u5BBF\u4E3B\u539F\u751F\u7EC4\u4EF6\uFF0CrenderEngine=webf)", value: "webf" },
93
92
  { name: "Lynx \u539F\u751F\u6E32\u67D3 (ReactLynx + \u8DE8\u5E73\u53F0\u539F\u751F UI\uFF0CrenderEngine=lynx)", value: "lynx" }
94
93
  ],
95
94
  default: "vanilla"
@@ -115,10 +114,6 @@ function resolveTemplateDirs(templateType, features) {
115
114
  const vueDir = join(templatesRoot, "with-vue");
116
115
  if (existsSync(vueDir)) dirs.push(vueDir);
117
116
  }
118
- if (templateType === "webf") {
119
- const webfDir = join(templatesRoot, "with-webf");
120
- if (existsSync(webfDir)) dirs.push(webfDir);
121
- }
122
117
  if (templateType === "lynx") {
123
118
  const lynxDir = join(templatesRoot, "with-lynx");
124
119
  if (existsSync(lynxDir)) dirs.push(lynxDir);
package/dist/index.js.map CHANGED
@@ -1 +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 / features / package-manager\n * 3. 根据选择的功能,合并 templates/base/ + 选中的叠加层到目标目录\n * 4. 将 {{name}} / {{entryPath}} 等占位符替换为实际值\n * 5. _gitignore 重命名为 .gitignore\n * 6. package.json 中的 workspace:^ 替换为实际 semver\n */\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst SDK_VERSION = '^2.15.0';\nconst CLIENT_SDK_VERSION = '^2.15.0';\nconst BUILDER_VERSION = '^2.15.0';\n\nconst AVAILABLE_PERMISSIONS = [\n { name: 'storage (持久化存储 - storage API)', value: 'storage' },\n { name: 'persistent-storage (卸载后保留的持久化存储)', value: 'persistent-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 { name: 'jsenv (创建/执行子 JS 沙箱环境)', value: 'jsenv' },\n { name: 'fs (插件数据目录文件读写)', value: 'fs' },\n { name: 'fs:music (访问 music_path 音乐目录)', value: 'fs:music' },\n { name: 'fs:external (访问管理员配置的外部目录)', value: 'fs:external' },\n { name: 'websocket (处理插件 WebSocket 连接)', value: 'websocket' },\n { name: 'net (UDP socket / SSDP / DLNA 发现)', value: 'net' },\n { name: 'net:insecure-tls (fetch 跳过 TLS 证书校验 — 仅自签/裸 IP 访问的自建设备)', value: 'net:insecure-tls' },\n { name: 'tags.read (读取歌曲标签)', value: 'tags.read' },\n { name: 'tags.write (修改歌曲标签)', value: 'tags.write' },\n];\n\nconst AVAILABLE_FEATURES = [\n { name: '静态页面 (static/) — 包含 HTML 模板和入口 JS,公共资源由主程序自动注入', value: 'static' },\n { name: '可执行文件管理 (bin/) — 打包/下载/运行外部程序', value: 'bin' },\n];\n\ninterface Answers {\n targetDir: string;\n name: string;\n entryPath: string;\n description: string;\n author: string;\n permissions: string[];\n features: string[];\n templateType: 'vanilla' | 'vue' | 'webf' | 'lynx';\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 features = await checkbox({\n message: '选择附加功能(可多选,可跳过)',\n choices: AVAILABLE_FEATURES,\n });\n\n const templateType = (await select({\n message: '选择前端开发模式',\n choices: [\n { name: 'Vanilla JS (传统静态页面)', value: 'vanilla' },\n { name: 'Vue 3 + Vite (现代化开发体验)', value: 'vue' },\n { name: 'WebF 原生渲染 (Vue 3 + 宿主原生组件,renderEngine=webf)', value: 'webf' },\n { name: 'Lynx 原生渲染 (ReactLynx + 跨平台原生 UI,renderEngine=lynx)', value: 'lynx' },\n ],\n default: 'vanilla',\n })) as 'vanilla' | 'vue' | 'webf' | 'lynx';\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, features, templateType, packageManager };\n}\n\nfunction resolveTemplateDirs(templateType: string, features: string[]): string[] {\n const templatesRoot = resolve(__dirname, '..', 'templates');\n const dirs: string[] = [];\n\n const baseDir = join(templatesRoot, 'base');\n if (!existsSync(baseDir)) throw new Error(`模板目录不存在: ${baseDir}`);\n dirs.push(baseDir);\n\n if (templateType === 'vue') {\n const vueDir = join(templatesRoot, 'with-vue');\n if (existsSync(vueDir)) dirs.push(vueDir);\n }\n\n if (templateType === 'webf') {\n const webfDir = join(templatesRoot, 'with-webf');\n if (existsSync(webfDir)) dirs.push(webfDir);\n }\n\n if (templateType === 'lynx') {\n const lynxDir = join(templatesRoot, 'with-lynx');\n if (existsSync(lynxDir)) dirs.push(lynxDir);\n }\n\n if (features.includes('static')) {\n const staticDir = join(templatesRoot, 'with-static');\n if (existsSync(staticDir)) dirs.push(staticDir);\n }\n\n if (features.includes('bin')) {\n const binDir = join(templatesRoot, 'with-bin');\n if (existsSync(binDir)) dirs.push(binDir);\n }\n\n return dirs;\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 templateDirs = resolveTemplateDirs(answers.templateType, answers.features);\n\n // 收集所有文件(后者覆盖前者的同名文件)\n const fileMap = new Map<string, string>(); // rel -> srcDir\n for (const dir of templateDirs) {\n const files: string[] = [];\n walk(dir, dir, files);\n for (const rel of files) {\n fileMap.set(rel, dir);\n }\n }\n\n // .vue 也算文本:否则 App.vue 里的 {{name}} 等占位符不会被替换(renderTemplate 只作用于\n // 文本文件)。renderTemplate 的正则是 \\{\\{(\\w+)\\}\\},Vue 的插值 `{{ expr }}` 带空格/点号\n // 不会被误匹配;未登记的 {{xxx}} 也原样保留,故对普通 Vue 代码安全。\n const textExts = new Set(['.json', '.ts', '.js', '.md', '.yml', '.yaml', '.html', '.css', '.vue']);\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, srcDir] of fileMap) {\n const src = join(srcDir, rel);\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 if (base === 'package.json') {\n content = content\n .replace(/\"@songloft\\/plugin-sdk\":\\s*\"workspace:\\^?\"/g, `\"@songloft/plugin-sdk\": \"${SDK_VERSION}\"`)\n .replace(/\"@songloft\\/client-sdk\":\\s*\"workspace:\\^?\"/g, `\"@songloft/client-sdk\": \"${CLIENT_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\n if (answers.features.length > 0) {\n console.log(` 附加功能: ${answers.features.join(', ')}`);\n }\n\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":[]}
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 / features / package-manager\n * 3. 根据选择的功能,合并 templates/base/ + 选中的叠加层到目标目录\n * 4. 将 {{name}} / {{entryPath}} 等占位符替换为实际值\n * 5. _gitignore 重命名为 .gitignore\n * 6. package.json 中的 workspace:^ 替换为实际 semver\n */\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst SDK_VERSION = '^2.17.0';\nconst CLIENT_SDK_VERSION = '^2.17.0';\nconst BUILDER_VERSION = '^2.17.0';\n\nconst AVAILABLE_PERMISSIONS = [\n { name: 'storage (持久化存储 - storage API)', value: 'storage' },\n { name: 'persistent-storage (卸载后保留的持久化存储)', value: 'persistent-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 { name: 'jsenv (创建/执行子 JS 沙箱环境)', value: 'jsenv' },\n { name: 'fs (插件数据目录文件读写)', value: 'fs' },\n { name: 'fs:music (访问 music_path 音乐目录)', value: 'fs:music' },\n { name: 'fs:external (访问管理员配置的外部目录)', value: 'fs:external' },\n { name: 'websocket (处理插件 WebSocket 连接)', value: 'websocket' },\n { name: 'net (UDP socket / SSDP / DLNA 发现)', value: 'net' },\n { name: 'net:insecure-tls (fetch 跳过 TLS 证书校验 — 仅自签/裸 IP 访问的自建设备)', value: 'net:insecure-tls' },\n { name: 'tags.read (读取歌曲标签)', value: 'tags.read' },\n { name: 'tags.write (修改歌曲标签)', value: 'tags.write' },\n];\n\nconst AVAILABLE_FEATURES = [\n { name: '静态页面 (static/) — 包含 HTML 模板和入口 JS,公共资源由主程序自动注入', value: 'static' },\n { name: '可执行文件管理 (bin/) — 打包/下载/运行外部程序', value: 'bin' },\n];\n\ninterface Answers {\n targetDir: string;\n name: string;\n entryPath: string;\n description: string;\n author: string;\n permissions: string[];\n features: string[];\n templateType: 'vanilla' | 'vue' | 'lynx';\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 features = await checkbox({\n message: '选择附加功能(可多选,可跳过)',\n choices: AVAILABLE_FEATURES,\n });\n\n const templateType = (await select({\n message: '选择前端开发模式',\n choices: [\n { name: 'Vanilla JS (传统静态页面)', value: 'vanilla' },\n { name: 'Vue 3 + Vite (现代化开发体验)', value: 'vue' },\n { name: 'Lynx 原生渲染 (ReactLynx + 跨平台原生 UI,renderEngine=lynx)', value: 'lynx' },\n ],\n default: 'vanilla',\n })) as 'vanilla' | 'vue' | 'lynx';\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, features, templateType, packageManager };\n}\n\nfunction resolveTemplateDirs(templateType: string, features: string[]): string[] {\n const templatesRoot = resolve(__dirname, '..', 'templates');\n const dirs: string[] = [];\n\n const baseDir = join(templatesRoot, 'base');\n if (!existsSync(baseDir)) throw new Error(`模板目录不存在: ${baseDir}`);\n dirs.push(baseDir);\n\n if (templateType === 'vue') {\n const vueDir = join(templatesRoot, 'with-vue');\n if (existsSync(vueDir)) dirs.push(vueDir);\n }\n\n if (templateType === 'lynx') {\n const lynxDir = join(templatesRoot, 'with-lynx');\n if (existsSync(lynxDir)) dirs.push(lynxDir);\n }\n\n if (features.includes('static')) {\n const staticDir = join(templatesRoot, 'with-static');\n if (existsSync(staticDir)) dirs.push(staticDir);\n }\n\n if (features.includes('bin')) {\n const binDir = join(templatesRoot, 'with-bin');\n if (existsSync(binDir)) dirs.push(binDir);\n }\n\n return dirs;\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 templateDirs = resolveTemplateDirs(answers.templateType, answers.features);\n\n // 收集所有文件(后者覆盖前者的同名文件)\n const fileMap = new Map<string, string>(); // rel -> srcDir\n for (const dir of templateDirs) {\n const files: string[] = [];\n walk(dir, dir, files);\n for (const rel of files) {\n fileMap.set(rel, dir);\n }\n }\n\n // .vue 也算文本:否则 App.vue 里的 {{name}} 等占位符不会被替换(renderTemplate 只作用于\n // 文本文件)。renderTemplate 的正则是 \\{\\{(\\w+)\\}\\},Vue 的插值 `{{ expr }}` 带空格/点号\n // 不会被误匹配;未登记的 {{xxx}} 也原样保留,故对普通 Vue 代码安全。\n const textExts = new Set(['.json', '.ts', '.js', '.md', '.yml', '.yaml', '.html', '.css', '.vue']);\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, srcDir] of fileMap) {\n const src = join(srcDir, rel);\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 if (base === 'package.json') {\n content = content\n .replace(/\"@songloft\\/plugin-sdk\":\\s*\"workspace:\\^?\"/g, `\"@songloft/plugin-sdk\": \"${SDK_VERSION}\"`)\n .replace(/\"@songloft\\/client-sdk\":\\s*\"workspace:\\^?\"/g, `\"@songloft/client-sdk\": \"${CLIENT_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\n if (answers.features.length > 0) {\n console.log(` 附加功能: ${answers.features.join(', ')}`);\n }\n\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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-songloft-plugin",
3
- "version": "2.15.0",
3
+ "version": "2.17.0",
4
4
  "description": "Scaffolding tool for Songloft JS plugin projects",
5
5
  "type": "module",
6
6
  "bin": {
@@ -1,17 +0,0 @@
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.0, viewport-fit=cover" />
6
- <title>{{name}}</title>
7
- <!--
8
- 刻意不引 common.css / common.js:宿主会在 <head> 里自动注入
9
- (顺序 base → auth bridge → common.css → common.js,全部 render-blocking),
10
- 插件自己引会重复加载。页面的色板 / reset / 字体 / --sl-safe-* 全部来自 common.css。
11
- -->
12
- </head>
13
- <body>
14
- <div id="app"></div>
15
- <script type="module" src="./src/main.js"></script>
16
- </body>
17
- </html>
@@ -1,18 +0,0 @@
1
- {
2
- "name": "frontend",
3
- "version": "1.0.0",
4
- "private": true,
5
- "type": "module",
6
- "scripts": {
7
- "dev": "vite",
8
- "build": "vite build",
9
- "preview": "vite preview"
10
- },
11
- "dependencies": {
12
- "vue": "^3.5.13"
13
- },
14
- "devDependencies": {
15
- "@vitejs/plugin-vue": "^5.2.1",
16
- "vite": "^6.1.0"
17
- }
18
- }
@@ -1,4 +0,0 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" width="48" height="48">
2
- <rect width="48" height="48" rx="10" fill="#6750A4"/>
3
- <path d="M18 14h12a4 4 0 0 1 4 4v12a4 4 0 0 1-4 4H18a4 4 0 0 1-4-4V18a4 4 0 0 1 4-4Zm2 6v8m4-8v8m4-8v8" stroke="#fff" stroke-width="2.4" stroke-linecap="round" fill="none"/>
4
- </svg>
@@ -1,159 +0,0 @@
1
- <script setup>
2
- import { ref, onMounted, onUnmounted, nextTick } from 'vue';
3
- import { state, loadSongs } from './store.js';
4
- import { mode, applyMode, installLayout, onResize, measureListHeight, pageBottomGap } from './layout.js';
5
- import { isWebFRuntime } from './engine.js';
6
- import SlButton from './ui/SlButton.vue';
7
- import SlIcon from './ui/SlIcon.vue';
8
- import SlInput from './ui/SlInput.vue';
9
- import SlSwitch from './ui/SlSwitch.vue';
10
- import SlCheckbox from './ui/SlCheckbox.vue';
11
- import SlSelect from './ui/SlSelect.vue';
12
- import SlListView from './ui/SlListView.vue';
13
-
14
- // ── 这是一个「WebF 原生渲染」推荐模板的演示页 ─────────────────────────────────
15
- //
16
- // 它把几件事凑在一起做示范,替换成你自己的业务时可逐块删改:
17
- // · 三种打开方式(tab / fullscreen / browser)下页头的自绘与否(见 layout.js);
18
- // · 全套表单控件包装(ui/Sl*.vue)——同一套业务代码在 WebF 与浏览器两条分支都能跑;
19
- // · 设置页用**覆盖层**而非 v-if 换页(避免 WebF 大规模拆除渲染树导致的白屏);
20
- // · 硬件返回键对接(onHostBack);
21
- // · <webf-list-view> 的确定高度由 JS 实测(measureListHeight)。
22
-
23
- const page = ref('main'); // 'main' | 'settings'
24
- const listRef = ref(null);
25
-
26
- const selectOptions = [
27
- { value: 'a', label: '选项 A' },
28
- { value: 'b', label: '选项 B' },
29
- { value: 'c', label: '选项 C' },
30
- ];
31
-
32
- // ── 列表高度实测(约束 ⑤)────────────────────────────────────────────────────
33
- // WebF 异步渲染,首帧可能量到 top=0,故失败就下一帧重试几次。
34
- function remeasure(retries = 8) {
35
- const inst = listRef.value;
36
- const el = inst && (inst.$el || inst);
37
- if (measureListHeight(el, pageBottomGap())) return;
38
- if (retries > 0) requestAnimationFrame(() => remeasure(retries - 1));
39
- }
40
-
41
- // ── 返回键:让硬件返回键先退回主页(见下方注释)──────────────────────────────
42
- //
43
- // WebF 不实现 SPA history 路由,也不 fire popstate,所以**不要**用 history.pushState
44
- // (宿主返回键会认定已被消费而变成死键)。宿主提供 `onHostBack`:返回 true 表示本次返回
45
- // 由页面消费。只对 WebF 生效;其它环境返回键直接离开插件页,页头返回按钮在所有模式下都在。
46
- function installBackIntegration() {
47
- if (!isWebFRuntime) return;
48
- const P = window.SongloftPlugin;
49
- if (!P || typeof P.onHostBack !== 'function') return; // 老客户端优雅降级
50
- P.onHostBack(() => {
51
- if (page.value !== 'main') {
52
- page.value = 'main';
53
- return true;
54
- }
55
- return false;
56
- });
57
- }
58
-
59
- onMounted(() => {
60
- // 判定打开方式要在 mount 之后:window.webf / flutter_inappwebview 的注入时序没有契约。
61
- applyMode();
62
- installLayout();
63
- installBackIntegration();
64
- onResize(() => remeasure());
65
- loadSongs().then(() => nextTick(() => remeasure()));
66
- nextTick(() => remeasure());
67
- });
68
-
69
- onUnmounted(() => {});
70
- </script>
71
-
72
- <template>
73
- <div class="sl-container">
74
- <!-- tab / browser 模式自绘页头;fullscreen 模式宿主已有 AppBar,不画避免双标题。 -->
75
- <div v-if="mode !== 'fullscreen'" class="sl-appbar">
76
- <span class="sl-appbar-title">{{name}}</span>
77
- <SlButton icon-only icon="settings" label="设置" @click="page = 'settings'" />
78
- </div>
79
- <div v-else style="text-align: right">
80
- <SlButton icon-only icon="settings" label="设置" @click="page = 'settings'" />
81
- </div>
82
-
83
- <!-- 演示卡片:各表单控件(两条渲染分支同一套代码)。 -->
84
- <div class="card sl-card">
85
- <div class="sl-card-body">
86
- <div class="sl-section-title">表单控件示例</div>
87
-
88
- <div class="sl-switch-row">
89
- <span class="sl-switch-label">开关(SlSwitch)</span>
90
- <SlSwitch v-model="state.demoSwitch" aria-label="演示开关" />
91
- </div>
92
-
93
- <div class="sl-switch-row">
94
- <span class="sl-switch-label">复选框(SlCheckbox)</span>
95
- <SlCheckbox v-model="state.demoChecked" aria-label="演示复选框" />
96
- </div>
97
-
98
- <div class="sl-field">
99
- <label class="sl-field-label">文本输入(SlInput)</label>
100
- <SlInput v-model="state.demoText" placeholder="输入点什么…" aria-label="演示输入" />
101
- </div>
102
-
103
- <div class="sl-field">
104
- <label class="sl-field-label">下拉选择(SlSelect)</label>
105
- <SlSelect v-model="state.demoSelect" :options="selectOptions" placeholder="请选择" aria-label="演示下拉" />
106
- </div>
107
-
108
- <SlButton variant="filled" label="重新加载歌曲" icon="refresh" @click="loadSongs" />
109
- </div>
110
- </div>
111
-
112
- <!-- 歌曲列表:<webf-list-view> 高度由 JS 实测(约束 ⑤)。 -->
113
- <div class="sl-section-title">歌曲(来自后端 /songs)</div>
114
- <SlListView ref="listRef">
115
- <div v-if="state.loading" class="sl-empty">加载中…</div>
116
- <div v-else-if="state.songs.length === 0" class="sl-empty">暂无歌曲</div>
117
- <div v-for="song in state.songs" :key="song.id" class="sl-row">
118
- <div class="sl-row-main">
119
- <span class="sl-title" :title="song.title">{{ song.title }}</span>
120
- <span class="sl-sub" :title="song.artist">{{ song.artist }}</span>
121
- </div>
122
- </div>
123
- </SlListView>
124
- </div>
125
-
126
- <!--
127
- 设置页用覆盖层(v-if 只挂设置页那几件控件),主页始终挂在底下。
128
- ⚠️ 不要用 v-if 在主页/设置页之间整片切换:WebF 的大规模渲染树拆除会留下已 dispose
129
- 却仍被引用的 render object,触发每帧刷断言 → 整页白屏。覆盖层是纯挂载/纯卸载,安全。
130
- -->
131
- <div v-if="page === 'settings'" class="sl-page-overlay">
132
- <div class="sl-container">
133
- <div class="sl-appbar">
134
- <SlButton icon-only icon="back" label="返回" @click="page = 'main'" />
135
- <span class="sl-appbar-title">设置</span>
136
- </div>
137
- <div class="card sl-card">
138
- <div class="sl-card-body">
139
- <div class="sl-empty">在这里放你的设置项。</div>
140
- </div>
141
- </div>
142
- </div>
143
- </div>
144
- </template>
145
-
146
- <style>
147
- /* 设置页覆盖层:fixed 四边分开写(inset 简写是 chrome61 之后语法);不用 transform(约束 ③);
148
- * 底色不透明(surface)否则露出底下主页。 */
149
- .sl-page-overlay {
150
- position: fixed;
151
- top: 0;
152
- right: 0;
153
- bottom: 0;
154
- left: 0;
155
- z-index: 100;
156
- background: var(--md-surface);
157
- overflow-y: auto;
158
- }
159
- </style>
@@ -1,26 +0,0 @@
1
- // 与插件后端(src/main.ts 的 router)通信。
2
- //
3
- // 走宿主注入的 window.SongloftPlugin.apiGet / apiPost —— 它们负责补 baseURL、带上
4
- // access_token、并在 WebF / WebView / iframe 三条路径上统一行为。刻意不用裸 fetch:
5
- // 鉴权与 base path 的处理都在宿主那一层。
6
- //
7
- // 端点路径与 src/main.ts 里 router 注册的路径**一一对应**(脚手架默认后端有 /hello、/songs)。
8
-
9
- const P = () => window.SongloftPlugin;
10
-
11
- /** GET,失败返回 null(宿主的 apiGet 已吞掉网络错误并返回 null)。 */
12
- export function get(path) {
13
- return P().apiGet(path);
14
- }
15
-
16
- export function post(path, body) {
17
- return P().apiPost(path, body);
18
- }
19
-
20
- export function fetchHello() {
21
- return get('/hello');
22
- }
23
-
24
- export function fetchSongs() {
25
- return get('/songs');
26
- }
@@ -1,51 +0,0 @@
1
- // 渲染引擎能力探测 —— 决定 ui/ 下的包装组件走 webf-ui 原生元素还是 HTML 回落。
2
- //
3
- // ── 为什么是「特性探测」而不是「引擎探测」 ──────────────────────────────────
4
- //
5
- // 直觉写法是 `!!window.webf`,但那是错的。客户端与插件是**各自独立发版**的:
6
- // plugin.json 的 minHostVersion 只约束**服务端**版本,没有任何字段能约束客户端。
7
- // 于是「新插件 + 老客户端(还没有 webf_cupertino_ui)」这个组合必然出现,
8
- // 那时 <flutter-cupertino-*> 会落到 WebF 的空盒子(_UnknownHTMLElement)——
9
- // 用户看到的是**所有控件凭空消失**,而且不报任何错。
10
- //
11
- // 所以判据必须是「这些元素到底注册上了没有」,而不是「我是不是跑在 WebF 里」。
12
- //
13
- // 元素注册上时,webf_cupertino_ui 的 bindings 会在实例上定义 `checked` 属性;
14
- // 没注册上就是空盒子,其上没有这个属性 → undefined。用 switch 做探针是因为它属性
15
- // 最少;任一 cupertino 元素注册失败都是同一个 install 调用整体失败,探一个等于探全部。
16
-
17
- /** 是否跑在 WebF 运行时里。判据与宿主 common.js 的 isWebFEngine() 一致。 */
18
- export const isWebFRuntime = typeof window !== 'undefined' && !!window.webf;
19
-
20
- function detectNativeUI() {
21
- if (!isWebFRuntime) return false;
22
- try {
23
- return document.createElement('flutter-cupertino-switch').checked !== undefined;
24
- } catch (e) {
25
- return false;
26
- }
27
- }
28
-
29
- /**
30
- * 是否使用 webf-ui 原生元素。
31
- *
32
- * 模块级常量:渲染引擎在页面生命周期内不会变,没必要做成响应式。
33
- * false 时全部包装组件走 HTML 分支 —— 覆盖浏览器 / 系统 WebView / Web iframe,
34
- * 以及上面说的「老客户端」情形。
35
- */
36
- export const useNativeUI = detectNativeUI();
37
-
38
- /**
39
- * webf-list-view 是 webf 包**内建**的(不依赖 webf_cupertino_ui),所以它的
40
- * 可用性与 cupertino 元素是两件事,单独探测。判据:注册上时会定义 finishLoad 方法。
41
- */
42
- function detectListView() {
43
- if (!isWebFRuntime) return false;
44
- try {
45
- return typeof document.createElement('webf-list-view').finishLoad === 'function';
46
- } catch (e) {
47
- return false;
48
- }
49
- }
50
-
51
- export const useNativeListView = detectListView();
@@ -1,124 +0,0 @@
1
- // 布局环境:打开方式、列表可用高度、resize 钩子。
2
- //
3
- // ⚠️ **必须是独立模块**(同 ui/select-open-state.js 的理由):`<script setup>` 顶层的
4
- // `const` 会被编译进 `setup()`,那是**每个组件实例一份**。这里的东西都必须全页唯一,
5
- // 放进组件里会静默变成「各组件各看到一份」。
6
-
7
- import { ref } from 'vue';
8
-
9
- // ── 打开方式 ───────────────────────────────────────────────────────────────
10
- //
11
- // 插件页有三种打开方式,宿主给的 chrome 完全不同,页头要不要自己画取决于它:
12
- //
13
- // tab 注册成主程序 tab(URL 带 `embed`)。宿主**没有** AppBar,
14
- // 底部是 Flutter 的 NavigationBar。→ 页头要自己画。
15
- // fullscreen 从首页点进的全屏页。宿主**有** AppBar(插件名 / 返回 / 关闭 /
16
- // 在浏览器打开)。→ 页头不能自己画,否则双标题。
17
- // browser 从上面那个全屏页「在浏览器中打开」跳出去。完全裸页面。→ 页头必须自己画。
18
- //
19
- // 判据:`embed` class 由 common.js 在 <head> 同步阶段加上;fullscreen 与 browser 的
20
- // URL 逐字节相同,唯一可靠判据是 `SongloftPlugin.host.isAvailable()`(把 WebF
21
- // methodChannel / native callHandler / iframe parent 三条传输链路 OR 在一起)。
22
- export const mode = ref('browser');
23
-
24
- export function detectMode() {
25
- if (document.documentElement.classList.contains('embed')) return 'tab';
26
- // isAvailable() 现算,但 window.webf / window.flutter_inappwebview 的注入时序没有契约,
27
- // 所以调用点放在 mount 之后(见 App.vue),不在模块初始化时。
28
- try {
29
- const h = window.SongloftPlugin && window.SongloftPlugin.host;
30
- if (h && h.isAvailable()) return 'fullscreen';
31
- } catch (e) {
32
- /* 探测失败按「没有宿主」处理:多画一个页头比少一个入口好 */
33
- }
34
- return 'browser';
35
- }
36
-
37
- /**
38
- * 把判定结果同步到 `<html>` 的 class,供 CSS 分三套布局用。
39
- * 用自定义的 `sl-mode-*` 而不是复用宿主的类:宿主 `html.embed` 那段全带 `!important`,
40
- * 自己的类不带才好覆盖。
41
- */
42
- export function applyMode() {
43
- const m = detectMode();
44
- mode.value = m;
45
- const de = document.documentElement;
46
- de.classList.remove('sl-mode-tab', 'sl-mode-fullscreen', 'sl-mode-browser');
47
- de.classList.add('sl-mode-' + m);
48
- return m;
49
- }
50
-
51
- // ── 列表可用高度 ───────────────────────────────────────────────────────────
52
- //
53
- // WebF 约束:`<webf-list-view shrink-wrap="false">` 必须有**确定 height**(只能是
54
- // `height`,`max-height` 会把无界约束透进 hosted Flutter 子树,撞 `Infinity or NaN toInt`),
55
- // 而竖向 flex 又不许用(约束 ⑧)。于是只能算:量出列表顶边到视口底的距离,写成内联 height。
56
- // CSS 里有 `calc(100vh - 常量)` 的兜底值保证首帧满足约束,这里以实测为权威覆盖它。
57
- const MIN_LIST_HEIGHT = 240;
58
- const FALLBACK_BOTTOM_PAD = 16;
59
-
60
- /**
61
- * 列表下方到视口底的固定占位(容器 padding-bottom)。必须**读解析值**而不是写死:
62
- * CSS 里它是 `calc(16px + var(--sl-safe-bottom))`,刘海屏 / 手势条上会大一截。
63
- * 读 getComputedStyle 的**标准属性**没问题;WebF 只有对**自定义属性**才一律返回空串。
64
- */
65
- export function pageBottomGap() {
66
- let pad = FALLBACK_BOTTOM_PAD;
67
- try {
68
- const el = document.querySelector('.sl-container');
69
- if (el && typeof window.getComputedStyle === 'function') {
70
- const v = parseFloat(window.getComputedStyle(el).paddingBottom);
71
- if (isFinite(v) && v >= 0) pad = v;
72
- }
73
- } catch (e) {
74
- /* 读不到就用兜底值 */
75
- }
76
- return pad;
77
- }
78
-
79
- /**
80
- * @param {HTMLElement|null} el 列表元素(`<webf-list-view>` 或 HTML 回落的 div)
81
- * @param {number} bottomGap 列表下方要留出的空白,见 pageBottomGap()
82
- * @returns {boolean} 是否成功写入(首帧未 layout 时返回 false,调用方下一帧重试)
83
- */
84
- export function measureListHeight(el, bottomGap) {
85
- if (!el || typeof el.getBoundingClientRect !== 'function') return false;
86
- const top = el.getBoundingClientRect().top;
87
- // WebF 是**异步渲染**的,首帧可能还没 layout、量出来是 0。此时什么都不做,
88
- // 让 CSS 兜底值继续生效,由调用方在下一帧重试。也不接受负值。
89
- if (!(top > 0)) return false;
90
- const h = Math.round(window.innerHeight - top - bottomGap);
91
- // 只能写内联 style,**不能**读 CSS 变量再算:WebF 的 getComputedStyle 对自定义属性
92
- // 一律返回空串。
93
- el.style.height = Math.max(MIN_LIST_HEIGHT, h) + 'px';
94
- return true;
95
- }
96
-
97
- // ── 一次性安装的 resize 监听 ─────────────────────────────────────────────────
98
- //
99
- // 挂在模块级、只装一次:组件会随切页反复挂卸,装在组件里就会漏。
100
- let installed = false;
101
- const resizeHooks = [];
102
-
103
- /** 注册一个 resize 回调(用于重量列表高度)。返回反注册函数。 */
104
- export function onResize(fn) {
105
- resizeHooks.push(fn);
106
- return () => {
107
- const i = resizeHooks.indexOf(fn);
108
- if (i >= 0) resizeHooks.splice(i, 1);
109
- };
110
- }
111
-
112
- export function installLayout() {
113
- if (installed) return;
114
- installed = true;
115
- window.addEventListener('resize', () => {
116
- for (let i = 0; i < resizeHooks.length; i++) {
117
- try {
118
- resizeHooks[i]();
119
- } catch (e) {
120
- /* 单个回调出错不该连带打掉其它的 */
121
- }
122
- }
123
- });
124
- }
@@ -1,14 +0,0 @@
1
- import { createApp } from 'vue';
2
- import App from './App.vue';
3
- import './style.css';
4
-
5
- // 宿主注入的 common.js 是 render-blocking 且在 <head>,而本脚本被 builder 挪到
6
- // </body> 之前,所以到这里 window.SongloftPlugin 一定已存在。仍做一次断言:
7
- // 万一注入链路出问题,让失败带上可归因信息,而不是在别处抛
8
- // "Cannot read properties of undefined"。
9
- if (!window.SongloftPlugin) {
10
- document.getElementById('app').textContent =
11
- '宿主脚本未注入(window.SongloftPlugin 不存在),插件页无法工作。';
12
- } else {
13
- createApp(App).mount('#app');
14
- }
@@ -1,29 +0,0 @@
1
- // 全局状态。用 Vue 的 reactive 而非 pinia:插件页通常足够简单,一个模块级 reactive
2
- // 对象就够了;需要更强的状态管理时再自行引入。
3
- //
4
- // ⚠️ 模块级单例(在这里 new 一次)—— 不要把它写进某个组件的 `<script setup>` 顶层,
5
- // 那样会每个实例各一份(同 layout.js / select-open-state.js 的理由)。
6
-
7
- import { reactive } from 'vue';
8
- import { fetchSongs } from './api.js';
9
-
10
- export const state = reactive({
11
- songs: [],
12
- loading: false,
13
- // 演示各表单控件的双向绑定:
14
- demoSwitch: true,
15
- demoChecked: false,
16
- demoText: '',
17
- demoSelect: '',
18
- });
19
-
20
- export async function loadSongs() {
21
- state.loading = true;
22
- try {
23
- const res = await fetchSongs();
24
- // base/src/main.ts 的 /songs 返回 { count, songs }
25
- state.songs = (res && res.songs) || [];
26
- } finally {
27
- state.loading = false;
28
- }
29
- }