@leeoohoo/ui-apps-devkit 0.1.1 → 0.1.3

package/src/commands/init.js

@@ -1,142 +1,143 @@
-import path from 'path';
-import readline from 'readline';
-
-import { ensureDir, isDirectory, isFile, rmForce, writeText } from '../lib/fs.js';
-import {
-  copyTemplate,
-  listTemplates,
-  readTemplateMeta,
-  maybeReplaceTokensInFile,
-  writeScaffoldConfig,
-  writeScaffoldManifest,
-  writeScaffoldPackageJson,
-} from '../lib/template.js';
-
-function canPrompt() {
-  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
-
-async function promptLine(question, { defaultValue = '' } = {}) {
-  if (!canPrompt()) throw new Error(`Missing required value: ${question}`);
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const answer = await new Promise((resolve) => rl.question(question, resolve));
-    const v = String(answer || '').trim();
-    return v || defaultValue;
-  } finally {
-    rl.close();
-  }
-}
-
-export async function cmdInit({ positionals, flags }) {
-  const list = Boolean(flags['list-templates'] || flags.listTemplates);
-  if (list) {
-    const templates = listTemplates();
-    if (templates.length === 0) {
-      // eslint-disable-next-line no-console
-      console.log('No templates found.');
-      return;
-    }
-    const lines = templates.map((t) => `- ${t.name}${t.description ? `: ${t.description}` : ''}`).join('\n');
-    // eslint-disable-next-line no-console
-    console.log(`Templates:\n${lines}\n\nUse:\n  chatos-uiapp init my-app --template <name>\n`);
-    return;
-  }
-
-  const dirArg = String(positionals[0] || '').trim();
-  if (!dirArg) throw new Error('init requires <dir>');
-
-  const templateName = String(flags.template || flags.t || '').trim() || 'basic';
-  const templateMeta = readTemplateMeta(templateName);
-
-  const destDir = path.resolve(process.cwd(), dirArg);
-  const force = Boolean(flags.force);
-
-  if (isDirectory(destDir)) {
-    const entries = await (async () => {
-      try {
-        return (await import('fs')).default.readdirSync(destDir);
-      } catch {
-        return [];
-      }
-    })();
-    if (entries.length > 0 && !force) {
-      throw new Error(`Target directory is not empty: ${destDir} (use --force to overwrite)`);
-    }
-    if (force) rmForce(destDir);
-  }
-
-  ensureDir(destDir);
-  copyTemplate({ templateName, destDir });
-
-  const pluginId =
-    String(flags['plugin-id'] || flags.pluginId || '').trim() || (await promptLine('pluginId (e.g. com.example.myapp): '));
-  const pluginName =
-    String(flags.name || '').trim() ||
-    (await promptLine('plugin name (display): ', { defaultValue: String(templateMeta?.defaults?.pluginName || '').trim() || pluginId }));
-
-  const defaultAppId = String(templateMeta?.defaults?.appId || '').trim() || 'app';
-  const appId =
-    String(flags['app-id'] || flags.appId || '').trim() ||
-    (await promptLine('appId (e.g. manager): ', { defaultValue: defaultAppId }));
-
-  const version = String(flags.version || '').trim() || String(templateMeta?.defaults?.version || '').trim() || '0.1.0';
-
-  const pluginDir = path.join(destDir, 'plugin');
-  ensureDir(pluginDir);
-
-  if (!isFile(path.join(pluginDir, 'plugin.json'))) {
-    const withBackend = templateMeta?.defaults?.withBackend !== false;
-    writeScaffoldManifest({ destPluginDir: pluginDir, pluginId, pluginName, version, appId, withBackend });
-  }
-  writeScaffoldPackageJson({ destDir, projectName: path.basename(destDir) });
-  writeScaffoldConfig({ destDir, pluginDir: 'plugin', appId });
-
-  // rename template app folder "app" -> actual appId
-  const srcAppDir = path.join(pluginDir, 'apps', 'app');
-  const dstAppDir = path.join(pluginDir, 'apps', appId);
-  try {
-    const fs = (await import('fs')).default;
-    if (fs.existsSync(srcAppDir) && fs.statSync(srcAppDir).isDirectory()) {
-      ensureDir(path.dirname(dstAppDir));
-      fs.renameSync(srcAppDir, dstAppDir);
-    }
-  } catch {
-    // ignore
-  }
-
-  // Token replacements inside README/template code.
-  const replacements = {
-    __PLUGIN_ID__: pluginId,
-    __PLUGIN_NAME__: pluginName,
-    __APP_ID__: appId,
-    __VERSION__: version,
-  };
-
-  maybeReplaceTokensInFile(path.join(destDir, 'README.md'), replacements);
-  maybeReplaceTokensInFile(path.join(destDir, 'chatos.config.json'), replacements);
-  if (isFile(path.join(pluginDir, 'plugin.json'))) {
-    maybeReplaceTokensInFile(path.join(pluginDir, 'plugin.json'), replacements);
-  }
-  maybeReplaceTokensInFile(path.join(pluginDir, 'backend', 'index.mjs'), replacements);
-  maybeReplaceTokensInFile(path.join(dstAppDir, 'index.mjs'), replacements);
-  maybeReplaceTokensInFile(path.join(dstAppDir, 'compact.mjs'), replacements);
-  maybeReplaceTokensInFile(path.join(dstAppDir, 'mcp-server.mjs'), replacements);
-  maybeReplaceTokensInFile(path.join(dstAppDir, 'mcp-prompt.zh.md'), replacements);
-  maybeReplaceTokensInFile(path.join(dstAppDir, 'mcp-prompt.en.md'), replacements);
-
-  // Ensure a helpful note exists even if template is edited later.
-  writeText(
-    path.join(destDir, '.gitignore'),
-    `node_modules/\n.DS_Store\n.chatos/\n*.log\n\n# build outputs (if you add bundling later)\ndist/\n`
-  );
-
-  // eslint-disable-next-line no-console
-  console.log(`Created: ${destDir}
-
-Next:
-  cd ${dirArg}
-  npm install
-  npm run dev
-`);
-}
+import path from 'path';
+import readline from 'readline';
+
+import { ensureDir, isDirectory, isFile, rmForce, writeText } from '../lib/fs.js';
+import {
+  copyTemplate,
+  listTemplates,
+  readTemplateMeta,
+  maybeReplaceTokensInFile,
+  writeScaffoldConfig,
+  writeScaffoldManifest,
+  writeScaffoldPackageJson,
+} from '../lib/template.js';
+import { COMPAT_STATE_ROOT_DIRNAME, STATE_ROOT_DIRNAME } from '../lib/state-constants.js';
+
+function canPrompt() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
+async function promptLine(question, { defaultValue = '' } = {}) {
+  if (!canPrompt()) throw new Error(`Missing required value: ${question}`);
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await new Promise((resolve) => rl.question(question, resolve));
+    const v = String(answer || '').trim();
+    return v || defaultValue;
+  } finally {
+    rl.close();
+  }
+}
+
+export async function cmdInit({ positionals, flags }) {
+  const list = Boolean(flags['list-templates'] || flags.listTemplates);
+  if (list) {
+    const templates = listTemplates();
+    if (templates.length === 0) {
+      // eslint-disable-next-line no-console
+      console.log('No templates found.');
+      return;
+    }
+    const lines = templates.map((t) => `- ${t.name}${t.description ? `: ${t.description}` : ''}`).join('\n');
+    // eslint-disable-next-line no-console
+    console.log(`Templates:\n${lines}\n\nUse:\n  chatos-uiapp init my-app --template <name>\n`);
+    return;
+  }
+
+  const dirArg = String(positionals[0] || '').trim();
+  if (!dirArg) throw new Error('init requires <dir>');
+
+  const templateName = String(flags.template || flags.t || '').trim() || 'basic';
+  const templateMeta = readTemplateMeta(templateName);
+
+  const destDir = path.resolve(process.cwd(), dirArg);
+  const force = Boolean(flags.force);
+
+  if (isDirectory(destDir)) {
+    const entries = await (async () => {
+      try {
+        return (await import('fs')).default.readdirSync(destDir);
+      } catch {
+        return [];
+      }
+    })();
+    if (entries.length > 0 && !force) {
+      throw new Error(`Target directory is not empty: ${destDir} (use --force to overwrite)`);
+    }
+    if (force) rmForce(destDir);
+  }
+
+  ensureDir(destDir);
+  copyTemplate({ templateName, destDir });
+
+  const pluginId =
+    String(flags['plugin-id'] || flags.pluginId || '').trim() || (await promptLine('pluginId (e.g. com.example.myapp): '));
+  const pluginName =
+    String(flags.name || '').trim() ||
+    (await promptLine('plugin name (display): ', { defaultValue: String(templateMeta?.defaults?.pluginName || '').trim() || pluginId }));
+
+  const defaultAppId = String(templateMeta?.defaults?.appId || '').trim() || 'app';
+  const appId =
+    String(flags['app-id'] || flags.appId || '').trim() ||
+    (await promptLine('appId (e.g. manager): ', { defaultValue: defaultAppId }));
+
+  const version = String(flags.version || '').trim() || String(templateMeta?.defaults?.version || '').trim() || '0.1.0';
+
+  const pluginDir = path.join(destDir, 'plugin');
+  ensureDir(pluginDir);
+
+  if (!isFile(path.join(pluginDir, 'plugin.json'))) {
+    const withBackend = templateMeta?.defaults?.withBackend !== false;
+    writeScaffoldManifest({ destPluginDir: pluginDir, pluginId, pluginName, version, appId, withBackend });
+  }
+  writeScaffoldPackageJson({ destDir, projectName: path.basename(destDir) });
+  writeScaffoldConfig({ destDir, pluginDir: 'plugin', appId });
+
+  // rename template app folder "app" -> actual appId
+  const srcAppDir = path.join(pluginDir, 'apps', 'app');
+  const dstAppDir = path.join(pluginDir, 'apps', appId);
+  try {
+    const fs = (await import('fs')).default;
+    if (fs.existsSync(srcAppDir) && fs.statSync(srcAppDir).isDirectory()) {
+      ensureDir(path.dirname(dstAppDir));
+      fs.renameSync(srcAppDir, dstAppDir);
+    }
+  } catch {
+    // ignore
+  }
+
+  // Token replacements inside README/template code.
+  const replacements = {
+    __PLUGIN_ID__: pluginId,
+    __PLUGIN_NAME__: pluginName,
+    __APP_ID__: appId,
+    __VERSION__: version,
+  };
+
+  maybeReplaceTokensInFile(path.join(destDir, 'README.md'), replacements);
+  maybeReplaceTokensInFile(path.join(destDir, 'chatos.config.json'), replacements);
+  if (isFile(path.join(pluginDir, 'plugin.json'))) {
+    maybeReplaceTokensInFile(path.join(pluginDir, 'plugin.json'), replacements);
+  }
+  maybeReplaceTokensInFile(path.join(pluginDir, 'backend', 'index.mjs'), replacements);
+  maybeReplaceTokensInFile(path.join(dstAppDir, 'index.mjs'), replacements);
+  maybeReplaceTokensInFile(path.join(dstAppDir, 'compact.mjs'), replacements);
+  maybeReplaceTokensInFile(path.join(dstAppDir, 'mcp-server.mjs'), replacements);
+  maybeReplaceTokensInFile(path.join(dstAppDir, 'mcp-prompt.zh.md'), replacements);
+  maybeReplaceTokensInFile(path.join(dstAppDir, 'mcp-prompt.en.md'), replacements);
+
+  // Ensure a helpful note exists even if template is edited later.
+  writeText(
+    path.join(destDir, '.gitignore'),
+    `node_modules/\n.DS_Store\n${STATE_ROOT_DIRNAME}/\n${COMPAT_STATE_ROOT_DIRNAME}/\n*.log\n\n# build outputs (if you add bundling later)\ndist/\n`
+  );
+
+  // eslint-disable-next-line no-console
+  console.log(`Created: ${destDir}
+
+Next:
+  cd ${dirArg}
+  npm install
+  npm run dev
+`);
+}

package/src/commands/install.js

@@ -1,55 +1,56 @@
-import os from 'os';
-import path from 'path';
-
-import { copyDir, ensureDir, isDirectory, rmForce, sanitizeDirComponent } from '../lib/fs.js';
-import { loadDevkitConfig } from '../lib/config.js';
-import { findPluginDir, loadPluginManifest } from '../lib/plugin.js';
-
-function defaultStateDir(hostApp) {
-  const app = typeof hostApp === 'string' && hostApp.trim() ? hostApp.trim() : 'chatos';
-  return path.join(os.homedir(), '.deepseek_cli', app);
-}
-
-function copyPluginDir(srcDir, destDir) {
-  ensureDir(path.dirname(destDir));
-  rmForce(destDir);
-  copyDir(srcDir, destDir, {
-    filter: (src) => {
-      const base = path.basename(src);
-      if (base === 'node_modules') return false;
-      if (base === '.git') return false;
-      if (base === '.DS_Store') return false;
-      if (base.endsWith('.map')) return false;
-      return true;
-    },
-  });
-}
-
-export async function cmdInstall({ flags }) {
-  const { config } = loadDevkitConfig(process.cwd());
-  const pluginDir = findPluginDir(process.cwd(), flags['plugin-dir'] || flags.pluginDir || config?.pluginDir);
-  const { pluginId, name, version } = loadPluginManifest(pluginDir);
-
-  const hostApp = String(flags['host-app'] || flags.hostApp || 'chatos').trim() || 'chatos';
-  const stateDir = String(flags['state-dir'] || flags.stateDir || defaultStateDir(hostApp)).trim();
-  if (!stateDir) throw new Error('stateDir is required');
-
-  const pluginsRoot = path.join(stateDir, 'ui_apps', 'plugins');
-  ensureDir(pluginsRoot);
-
-  const dirName = sanitizeDirComponent(pluginId);
-  if (!dirName) throw new Error(`Invalid plugin id: ${pluginId}`);
-
-  const destDir = path.join(pluginsRoot, dirName);
-  const replaced = isDirectory(destDir);
-  copyPluginDir(pluginDir, destDir);
-
-  // eslint-disable-next-line no-console
-  console.log(
-    `Installed: ${pluginId} (${name}@${version})\n` +
-      `  -> ${destDir}\n` +
-      `  replaced: ${replaced}\n\n` +
-      `Open ChatOS -> 应用 -> 刷新（同 id 覆盖生效）。`
-  );
-}
-
+import os from 'os';
+import path from 'path';
+
+import { copyDir, ensureDir, isDirectory, rmForce, sanitizeDirComponent } from '../lib/fs.js';
+import { loadDevkitConfig } from '../lib/config.js';
+import { findPluginDir, loadPluginManifest } from '../lib/plugin.js';
+import { STATE_ROOT_DIRNAME } from '../lib/state-constants.js';
+
+function defaultStateDir(hostApp) {
+  const app = typeof hostApp === 'string' && hostApp.trim() ? hostApp.trim() : 'chatos';
+  return path.join(os.homedir(), STATE_ROOT_DIRNAME, app);
+}
+
+function copyPluginDir(srcDir, destDir) {
+  ensureDir(path.dirname(destDir));
+  rmForce(destDir);
+  copyDir(srcDir, destDir, {
+    filter: (src) => {
+      const base = path.basename(src);
+      if (base === 'node_modules') return false;
+      if (base === '.git') return false;
+      if (base === '.DS_Store') return false;
+      if (base.endsWith('.map')) return false;
+      return true;
+    },
+  });
+}
+
+export async function cmdInstall({ flags }) {
+  const { config } = loadDevkitConfig(process.cwd());
+  const pluginDir = findPluginDir(process.cwd(), flags['plugin-dir'] || flags.pluginDir || config?.pluginDir);
+  const { pluginId, name, version } = loadPluginManifest(pluginDir);
+
+  const hostApp = String(flags['host-app'] || flags.hostApp || 'chatos').trim() || 'chatos';
+  const stateDir = String(flags['state-dir'] || flags.stateDir || defaultStateDir(hostApp)).trim();
+  if (!stateDir) throw new Error('stateDir is required');
+
+  const pluginsRoot = path.join(stateDir, 'ui_apps', 'plugins');
+  ensureDir(pluginsRoot);
+
+  const dirName = sanitizeDirComponent(pluginId);
+  if (!dirName) throw new Error(`Invalid plugin id: ${pluginId}`);
+
+  const destDir = path.join(pluginsRoot, dirName);
+  const replaced = isDirectory(destDir);
+  copyPluginDir(pluginDir, destDir);
+
+  // eslint-disable-next-line no-console
+  console.log(
+    `Installed: ${pluginId} (${name}@${version})\n` +
+      `  -> ${destDir}\n` +
+      `  replaced: ${replaced}\n\n` +
+      `Open ChatOS -> 应用 -> 刷新（同 id 覆盖生效）。`
+  );
+}
+

package/src/commands/pack.js

@@ -1,72 +1,72 @@
-import os from 'os';
-import path from 'path';
-import { spawnSync } from 'child_process';
-
-import { copyDir, ensureDir, rmForce } from '../lib/fs.js';
-import { loadDevkitConfig } from '../lib/config.js';
-import { findPluginDir, loadPluginManifest } from '../lib/plugin.js';
-
-function hasCmd(cmd) {
-  const res = spawnSync('sh', ['-lc', `command -v ${cmd} >/dev/null 2>&1`], { stdio: 'ignore' });
-  return res.status === 0;
-}
-
-function packWithZip({ cwd, srcDir, outFile }) {
-  // zip -r out.zip .  (from within srcDir)
-  const res = spawnSync('zip', ['-r', outFile, '.'], { cwd: srcDir, stdio: 'inherit' });
-  if (res.status !== 0) throw new Error('zip failed');
-}
-
-function packWithPowershell({ srcDir, outFile }) {
-  const script = `Compress-Archive -Path "${srcDir}\\*" -DestinationPath "${outFile}" -Force`;
-  const res = spawnSync('powershell', ['-NoProfile', '-Command', script], { stdio: 'inherit' });
-  if (res.status !== 0) throw new Error('powershell Compress-Archive failed');
-}
-
-export async function cmdPack({ flags }) {
-  const { config } = loadDevkitConfig(process.cwd());
-  const pluginDir = findPluginDir(process.cwd(), flags['plugin-dir'] || flags.pluginDir || config?.pluginDir);
-  const { pluginId, version } = loadPluginManifest(pluginDir);
-
-  const outArg = String(flags.out || '').trim();
-  const outDir = outArg ? path.dirname(path.resolve(process.cwd(), outArg)) : path.join(process.cwd(), 'dist');
-  ensureDir(outDir);
-
-  const outFile = outArg
-    ? path.resolve(process.cwd(), outArg)
-    : path.join(outDir, `${pluginId.replace(/[^a-zA-Z0-9._-]+/g, '-')}-${version || '0.0.0'}.zip`);
-
-  rmForce(outFile);
-
-  const stagingBase = path.join(os.tmpdir(), `chatos-uiapp-pack-${Date.now()}-${Math.random().toString(16).slice(2)}`);
-  ensureDir(stagingBase);
-  try {
-    // mimic ChatOS importer: exclude node_modules/.git/*.map/.DS_Store
-    copyDir(pluginDir, stagingBase, {
-      filter: (src) => {
-        const base = path.basename(src);
-        if (base === 'node_modules') return false;
-        if (base === '.git') return false;
-        if (base === '.DS_Store') return false;
-        if (base.endsWith('.map')) return false;
-        return true;
-      },
-    });
-
-  const platform = process.platform;
-  if (hasCmd('zip')) {
-      packWithZip({ cwd: process.cwd(), srcDir: stagingBase, outFile });
-  } else if (platform === 'win32') {
-      packWithPowershell({ srcDir: stagingBase, outFile });
-  } else {
-    throw new Error('zip command not found (install "zip" or run on Windows with powershell)');
-  }
-
-  // eslint-disable-next-line no-console
-  console.log(`Packed: ${outFile}
-
-ChatOS -> 应用 -> 导入应用包 -> 选择该 zip`);
-  } finally {
-    rmForce(stagingBase);
-  }
-}
+import os from 'os';
+import path from 'path';
+import { spawnSync } from 'child_process';
+
+import { copyDir, ensureDir, rmForce } from '../lib/fs.js';
+import { loadDevkitConfig } from '../lib/config.js';
+import { findPluginDir, loadPluginManifest } from '../lib/plugin.js';
+
+function hasCmd(cmd) {
+  const res = spawnSync('sh', ['-lc', `command -v ${cmd} >/dev/null 2>&1`], { stdio: 'ignore' });
+  return res.status === 0;
+}
+
+function packWithZip({ cwd, srcDir, outFile }) {
+  // zip -r out.zip .  (from within srcDir)
+  const res = spawnSync('zip', ['-r', outFile, '.'], { cwd: srcDir, stdio: 'inherit' });
+  if (res.status !== 0) throw new Error('zip failed');
+}
+
+function packWithPowershell({ srcDir, outFile }) {
+  const script = `Compress-Archive -Path "${srcDir}\\*" -DestinationPath "${outFile}" -Force`;
+  const res = spawnSync('powershell', ['-NoProfile', '-Command', script], { stdio: 'inherit' });
+  if (res.status !== 0) throw new Error('powershell Compress-Archive failed');
+}
+
+export async function cmdPack({ flags }) {
+  const { config } = loadDevkitConfig(process.cwd());
+  const pluginDir = findPluginDir(process.cwd(), flags['plugin-dir'] || flags.pluginDir || config?.pluginDir);
+  const { pluginId, version } = loadPluginManifest(pluginDir);
+
+  const outArg = String(flags.out || '').trim();
+  const outDir = outArg ? path.dirname(path.resolve(process.cwd(), outArg)) : path.join(process.cwd(), 'dist');
+  ensureDir(outDir);
+
+  const outFile = outArg
+    ? path.resolve(process.cwd(), outArg)
+    : path.join(outDir, `${pluginId.replace(/[^a-zA-Z0-9._-]+/g, '-')}-${version || '0.0.0'}.zip`);
+
+  rmForce(outFile);
+
+  const stagingBase = path.join(os.tmpdir(), `chatos-uiapp-pack-${Date.now()}-${Math.random().toString(16).slice(2)}`);
+  ensureDir(stagingBase);
+  try {
+    // mimic ChatOS importer: exclude node_modules/.git/*.map/.DS_Store
+    copyDir(pluginDir, stagingBase, {
+      filter: (src) => {
+        const base = path.basename(src);
+        if (base === 'node_modules') return false;
+        if (base === '.git') return false;
+        if (base === '.DS_Store') return false;
+        if (base.endsWith('.map')) return false;
+        return true;
+      },
+    });
+
+  const platform = process.platform;
+  if (hasCmd('zip')) {
+      packWithZip({ cwd: process.cwd(), srcDir: stagingBase, outFile });
+  } else if (platform === 'win32') {
+      packWithPowershell({ srcDir: stagingBase, outFile });
+  } else {
+    throw new Error('zip command not found (install "zip" or run on Windows with powershell)');
+  }
+
+  // eslint-disable-next-line no-console
+  console.log(`Packed: ${outFile}
+
+ChatOS -> 应用 -> 导入应用包 -> 选择该 zip`);
+  } finally {
+    rmForce(stagingBase);
+  }
+}