@kdcloudjs/cli 0.0.1

package/src/actions/project/create/validate.js

@@ -0,0 +1,45 @@
+const { error } = require('../../../utils/log')
+const { PROJECT_TYPES, FRAMEWORKS } = require('../constants')
+
+module.exports = function validate({ name, type, framework }) {
+  if (!name) {
+    error('Component/Page name cannot be empty')
+    process.exit(1)
+  }
+
+  if (!type) {
+    error('Please specify --type kwc or --type page')
+    process.exit(1)
+  }
+
+  if (!Object.values(PROJECT_TYPES).includes(type)) {
+    error(`Invalid type: ${type}, supported types: kwc | page`)
+    process.exit(1)
+  }
+
+  // 创建的是组件
+  if (type === PROJECT_TYPES.KWC) {
+    switch (framework) {
+      case FRAMEWORKS.LWC:
+        if (!/^[a-z][a-zA-Z0-9]*$/.test(name)) {
+          error('LWC component name must be lowercase or camelCase')
+          process.exit(1)
+        }
+        break
+      case FRAMEWORKS.React:
+        if (!/^[A-Z][a-zA-Z0-9]*$/.test(name) && !/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(name)) {
+          error('React component name must follow PascalCase (start with uppercase) or kebab-case (hyphen-separated)')
+          process.exit(1)
+        }
+        break
+      case FRAMEWORKS.Vue:
+        if (!/^[A-Z][a-zA-Z0-9]*$/.test(name)) {
+          error('Vue component name must follow PascalCase (start with uppercase)')
+          process.exit(1)
+        }
+        break
+      default:
+        break
+    }
+  }
+}

package/src/actions/project/create/writeKwcFiles/index.js

@@ -0,0 +1,15 @@
+const { FRAMEWORKS } = require('../../constants')
+const writeLwcFiles = require('./lwc')
+const writeReactFiles = require('./react')
+const writeVueFiles = require('./vue')
+module.exports = function writeKwcFiles(config) {
+  const { framework } = config
+
+  if (framework === FRAMEWORKS.LWC) {
+    writeLwcFiles(config)
+  } else if (framework === FRAMEWORKS.React) {
+    writeReactFiles(config)
+  } else if (framework === FRAMEWORKS.Vue) {
+    writeVueFiles(config)
+  }
+}

package/src/actions/project/create/writeKwcFiles/lwc.js

@@ -0,0 +1,25 @@
+const fs = require('fs')
+const path = require('path')
+const { capitalize } = require('../../../../utils/index')
+const createMetaXml = require('../createMetaXml')
+module.exports = function writeLwcFiles(config) {
+  const { dir, name, moduleId, framework } = config
+  fs.writeFileSync(
+    path.join(dir, `${name}.html`),
+    `<template>
+</template>
+`
+  )
+  fs.writeFileSync(
+    path.join(dir, `${name}.js`),
+    `import { KingdeeElement } from '@kdcloudjs/kwc';
+
+export default class ${capitalize(name)} extends KingdeeElement {
+}
+`
+  )
+  fs.writeFileSync(
+    path.join(dir, `${name}.js-meta.kwc`),
+    createMetaXml({ name, moduleId, framework })
+  )
+}

package/src/actions/project/create/writeKwcFiles/react.js

@@ -0,0 +1,49 @@
+const fs = require('fs')
+const path = require('path')
+const { toPascalCase } = require('../../../../utils/index')
+const createMetaXml = require('../createMetaXml')
+const { LANGUAGES } = require('../../constants')
+
+module.exports = function writeReactFiles(config) {
+  const { dir, name, moduleId, framework, language } = config
+  const componentName = toPascalCase(name)
+
+  fs.mkdirSync(path.join(dir, '__tests__'), { recursive: true })
+
+  fs.writeFileSync(
+    path.join(dir, `${name}.module.scss`),
+    ''
+  )
+  fs.writeFileSync(
+    path.join(dir, `${name}.js-meta.kwc`),
+    createMetaXml({ name, moduleId, framework })
+  )
+
+  if (language === LANGUAGES.JavaScript) {
+    fs.writeFileSync(
+      path.join(dir, `${name}.jsx`),
+      `import styles from './${name}.module.scss';
+
+export default function ${componentName} (config) {
+    return (
+        <div>
+        </div>
+    );
+}
+`
+    )
+  } else if (language === LANGUAGES.TypeScript) {
+    fs.writeFileSync(
+      path.join(dir, `${name}.tsx`),
+      `import styles from './${name}.module.scss';
+
+export default function ${componentName}(config: KwcConfig) {
+    return (
+        <div>
+        </div>
+    );
+}
+`
+    )
+  }
+}

package/src/actions/project/create/writeKwcFiles/vue.js

@@ -0,0 +1,48 @@
+const fs = require('fs')
+const path = require('path')
+const { capitalize } = require('../../../../utils/index')
+const createMetaXml = require('../createMetaXml')
+const { LANGUAGES } = require('../../constants')
+
+module.exports = function writeVueFiles(config) {
+  const { dir, name, moduleId, framework, language } = config
+
+  fs.mkdirSync(path.join(dir, '__tests__'), { recursive: true })
+
+  fs.writeFileSync(
+    path.join(dir, `${name}.js-meta.kwc`),
+    createMetaXml({ name, moduleId, framework })
+  )
+
+  if (language === LANGUAGES.JavaScript) {
+    fs.writeFileSync(
+      path.join(dir, `${name}.ce.vue`),
+      `<script setup>
+</script>
+
+<template>
+  <div>
+  </div>
+</template>
+
+<style lang="scss" scoped>
+</style>
+`
+    )
+  } else if (language === LANGUAGES.TypeScript) {
+    fs.writeFileSync(
+      path.join(dir, `${name}.ce.vue`),
+      `<script setup lang="ts">
+</script>
+
+<template>
+  <div>
+  </div>
+</template>
+
+<style lang="scss" scoped>
+</style>
+`
+    )
+  }
+}

package/src/actions/project/deploy/collect.js

@@ -0,0 +1,43 @@
+const fs = require('fs')
+const path = require('path')
+
+function walk(dir, files = []) {
+  fs.readdirSync(dir).forEach(name => {
+    const full = path.join(dir, name)
+    const stat = fs.statSync(full)
+    stat.isDirectory()
+      ? walk(full, files)
+      : files.push(full)
+  })
+  return files
+}
+
+exports.collectMeta = function ({ baseDir, projectRoot, hasSourceDir }) {
+  const results = []
+
+  const files = walk(baseDir)
+
+  files.forEach(file => {
+    if (file.endsWith('.js-meta.kwc')) {
+      results.push({
+        type: 'kwc',
+        path: file
+      })
+    }
+    if (file.endsWith('.page-meta.kwp')) {
+      results.push({
+        type: 'page',
+        path: file
+      })
+    }
+  })
+
+  // 如果不是指定 -d，限制只能上传 app/kwc 和 app/pages
+  if (!hasSourceDir) {
+    return results.filter(f =>
+      f.path.startsWith(path.join(projectRoot, 'app'))
+    )
+  }
+
+  return results
+}

package/src/actions/project/deploy/context.js

@@ -0,0 +1,26 @@
+const path = require('path')
+const { findProjectRoot, isProjectRoot } = require('./projectRoot')
+
+exports.resolveContext = function (options) {
+  const cwd = process.cwd()
+  const sourceDir = options.sourceDir
+
+  let baseDir
+  if (sourceDir) {
+    baseDir = path.isAbsolute(sourceDir)
+      ? path.resolve(sourceDir)
+      : path.resolve(cwd, sourceDir)
+  } else {
+    baseDir = cwd
+  }
+
+  const projectRoot = findProjectRoot(baseDir)
+
+  return {
+    cwd,
+    baseDir,
+    projectRoot,
+    hasSourceDir: !!sourceDir,
+    isRoot: isProjectRoot(cwd)
+  }
+}

package/src/actions/project/deploy/index.js

@@ -0,0 +1,38 @@
+
+const resolveEnv = require('../../env/resolveEnv')
+const { resolveContext } = require('./context')
+const { validateDeploy } = require('./validate')
+const updateIsv = require('./updateIsv')
+const { collectMeta } = require('./collect')
+const { upload } = require('./upload')
+const { error } = require('../../../utils/log')
+module.exports = async function deploy(options = {}) {
+      const { targetEnv } = options
+      const { env } = resolveEnv(targetEnv) || {}
+      if (!env) return
+      if (!env.access_token) {
+        error(
+          `Environment not authenticated. Please run "kd env auth" first`
+        )
+        return
+      }
+      const ctx = resolveContext(options)
+
+      validateDeploy(ctx)
+
+      const files = collectMeta(ctx)
+
+      if(!files || files.length === 0) {
+        error('No files to deploy')
+        return
+      }
+
+      // 更新isv信息到元数据描述文件 updateIsv
+      // 在上传前，统一注入 ISV
+      updateIsv(files, env?.isv)
+
+      await upload(files, env)
+
+      // success('部署完成')
+
+}

package/src/actions/project/deploy/projectRoot.js

@@ -0,0 +1,32 @@
+const fs = require('fs')
+const path = require('path')
+
+const ROOT_MARKS = [
+  '.kd',
+  'app/kwc',
+  'package.json'
+]
+
+function isProjectRoot(dir) {
+  return ROOT_MARKS.every(mark =>
+    fs.existsSync(path.join(dir, mark))
+  )
+}
+
+function findProjectRoot(startDir) {
+  let current = path.resolve(startDir)
+
+  while (true) {
+    if (isProjectRoot(current)) return current
+
+    const parent = path.dirname(current)
+    if (parent === current) return null
+
+    current = parent
+  }
+}
+
+module.exports = {
+  isProjectRoot,
+  findProjectRoot
+}

package/src/actions/project/deploy/updateIsv.js

@@ -0,0 +1,109 @@
+const fs = require('fs')
+const path = require('path')
+const { info, error } = require('../../../utils/log')
+const { findProjectRoot } = require('./projectRoot')
+
+/**
+ * 更新元数据文件中的 <isv> 信息
+ * @param {Array} files collectMeta 返回的文件列表
+ * @param {string} isv ISV 标识
+ */
+module.exports = function updateIsv(files, isv) {
+  if (!isv) return
+  try {
+    files.forEach(file => {
+        if (!['kwc', 'page'].includes(file.type)) return
+
+        const filePath = file.path
+        if (!fs.existsSync(filePath)) return
+
+        let content = fs.readFileSync(filePath, 'utf-8')
+
+        // 更新isv标签
+        // 已存在 <isv> 标签 → 直接替换
+        if (/<isv>[\s\S]*?<\/isv>/.test(content)) {
+        content = content.replace(
+            /<isv>[\s\S]*?<\/isv>/,
+            `<isv>${isv}</isv>`
+        )
+        } else {
+        // 不存在 <isv> 标签 → 插入
+        content = injectIsvTag(content, isv)
+        }
+        
+        // 更新name标签 这里在name标签前加上isv前缀
+        if (file.type === 'page') {
+            content = content.replace(
+                /<name>([\s\S]*?)<\/name>/,
+                (match, p1) => {
+                    if (p1.startsWith(`${isv}_`)) {
+                        return match
+                    }
+                    return `<name>${isv}_${p1}</name>`
+                }
+            )
+        }
+
+        fs.writeFileSync(filePath, content, 'utf-8')
+    })
+
+    // 更新根目录下.kd/config.json 填充开发商标识
+    const projectRoot = findProjectRoot(process.cwd())
+    if (projectRoot) {
+        const kdDir = path.join(projectRoot, '.kd')
+        const kdConfigPath = path.join(kdDir, 'config.json')
+
+        let kdConfig = {}
+
+        if (fs.existsSync(kdConfigPath)) {
+        try {
+            kdConfig = JSON.parse(fs.readFileSync(kdConfigPath, 'utf-8'))
+        } catch {
+            // ignore
+        }
+        }
+
+        kdConfig.isv = isv
+
+        if (!fs.existsSync(kdDir)) {
+        fs.mkdirSync(kdDir, { recursive: true })
+        }
+
+        fs.writeFileSync(
+        kdConfigPath,
+        JSON.stringify(kdConfig, null, 2),
+        'utf-8'
+        )
+    }
+    // info(`ℹ️  Updated ISV info for ${files.length} metadata files`)
+  } catch (e) {
+    error(`Failed to update ISV info: ${e.message}`)
+  }
+}
+
+/**
+ * 将 <isv> 标签插入到合适位置
+ * 优先放在 <name> / <masterLabel> 后面
+ */
+function injectIsvTag(xml, isv) {
+  // 常见安全插入点
+  const candidates = [
+    /<\/masterLabel>/,
+    /<\/name>/
+  ]
+
+  for (const reg of candidates) {
+    if (reg.test(xml)) {
+      return xml.replace(
+        reg,
+        match => `${match}\n    <isv>${isv}</isv>`
+      )
+    }
+  }
+
+  // fallback：直接插到根节点内
+  return xml.replace(
+    /(<[^>]+>)/,
+    `$1\n    <isv>${isv}</isv>`
+  )
+}

package/src/actions/project/deploy/upload.js

@@ -0,0 +1,60 @@
+const ora = require('ora')
+const path = require('path')
+const { updateKwcMeta, updatePageMeta } = require('../../../api/uploader')
+const printTable = require('../../../utils/printTable')
+exports.upload = async function upload(files, env) {
+  const spinner = ora(`🚀 Uploading metadata files (${files.length})...`).start()
+  console.time(`🕒 Upload duration`)
+
+  const tasks = files.map(file => {
+    return (async () => {
+      const record = {
+        type: file.type,
+        path: file.path,
+        status: 'success'
+      }
+
+      try {
+        if (file.type === 'kwc') {
+          await updateKwcMeta(file.path, env)
+        } else if (file.type === 'page') {
+          await updatePageMeta(file.path, env)
+        } else {
+          throw new Error(`Unsupported metadata type: ${file.type}`)
+        }
+      } catch (err) {
+        record.status = 'failed'
+        record.message = err?.message || 'unknown error'
+      }
+
+      return record
+    })()
+  })
+
+  // ⭐ 核心：并行执行，永不抛异常
+  const settledResults = await Promise.allSettled(tasks)
+
+  spinner.stop()
+
+  // 提取结果
+  const results = settledResults.map(r =>
+    r.status === 'fulfilled'
+      ? r.value
+      : {
+          type: 'unknown',
+          path: '',
+          status: 'failed',
+          message: r.reason?.message || 'unknown error'
+        }
+  )
+  const headers = ['Type', 'File', 'Status', 'Message']
+  const rows = results.map(file => [
+    file.type,
+    file.path,
+    file.status === 'success' ? '✔' : '✖',
+    file.status === 'failed' ? `Failed: ${file.message}` : 'Success'
+  ])
+  printTable(headers, rows)
+  console.timeEnd(`🕒 Upload duration`)
+  return results
+}

package/src/actions/project/deploy/validate.js

@@ -0,0 +1,13 @@
+const { error } = require('../../../utils/log')
+
+exports.validateDeploy = function (ctx) {
+  if (!ctx.projectRoot) {
+    error('Current directory is not a KWC project, deployment aborted')
+    process.exit(1)
+  }
+
+  if (!ctx.hasSourceDir && !ctx.isRoot) {
+    error('Please run in the project root directory or use -d to specify a path')
+    process.exit(1)
+  }
+}

package/src/actions/project/init/index.js

@@ -0,0 +1,42 @@
+const fs = require('fs')
+const path = require('path')
+const collectInitInfo = require('./prompts')
+const { writeProjectConfig, cleanupGitkeep } = require('./post')
+const downloadTemplate = require('../../../utils/download')
+const { error, info, tip } = require('../../../utils/log')
+const { TEMPLATES, INNER_TEMPLATES } = require('../constants')
+
+module.exports = async function initProject({ projectName: _projectName, source }) {
+    try {
+        const { projectName, moduleId, framework, language } = await collectInitInfo(_projectName) || {}
+
+        const targetDir = path.resolve(process.cwd(), projectName)
+
+        if (fs.existsSync(targetDir)) {
+            error(`Directory already exists: ${projectName}`)
+            return
+        }
+
+        tip(`\n🚀 Creating project: ${projectName}\n`)
+        console.time('🕒 Project initialization')
+
+        const templateSource = source === 'outer' ? TEMPLATES[`${framework}_${language}`] : INNER_TEMPLATES[`${framework}_${language}`]
+
+        await downloadTemplate(
+            templateSource,
+            targetDir,
+            projectName
+        )
+
+        writeProjectConfig(targetDir, { moduleId, framework, language })
+
+        cleanupGitkeep(targetDir)
+
+        console.timeEnd('🕒 Project initialization')
+        info('next steps：')
+        info(`  cd ${projectName}`)
+        info('  npm install')
+    } catch (err) {
+        error(err?.message || err)
+    }
+}

package/src/actions/project/init/post.js

@@ -0,0 +1,20 @@
+const fs = require('fs')
+const path = require('path')
+
+exports.writeProjectConfig = function (targetDir, config) {
+  const configFile = path.join(targetDir, '.kd', 'config.json')
+  fs.mkdirSync(path.dirname(configFile), { recursive: true })
+  fs.writeFileSync(configFile, JSON.stringify(config, null, 2))
+}
+
+exports.cleanupGitkeep = function (targetDir) {
+  const gitkeepFiles = [
+    path.join(targetDir, 'app', 'pages', '.gitkeep')
+  ]
+
+  gitkeepFiles.forEach(file => {
+    if (fs.existsSync(file)) {
+      fs.unlinkSync(file)
+    }
+  })
+}

package/src/actions/project/init/prompts.js

@@ -0,0 +1,50 @@
+const { safePrompts } = require('../../../utils/prompts')
+const { FRAMEWORKS, LANGUAGES } = require('../constants')
+
+module.exports = async function runPrompts(name) {
+  let projectName = name
+
+  if (!projectName) {
+    const res = await safePrompts({
+      type: 'text',
+      name: 'projectName',
+      message: 'Please enter the project name',
+      validate: name => name ? true : 'Project name is required'
+    })
+    projectName = res.projectName
+  }
+
+  const { framework } = await safePrompts({
+    type: 'select',
+    name: 'framework',
+    message: 'Please choose the framework',
+    choices: Object.keys(FRAMEWORKS).map(item => ({
+      title: item,
+      value: FRAMEWORKS[item]
+    }))
+  }) || {}
+
+  // 如果框架是vue或者react，可以选择是用ts，还是js
+  let language = LANGUAGES.JavaScript
+  if ([FRAMEWORKS.Vue, FRAMEWORKS.React].includes(framework)) {
+    const { language: _language } = await safePrompts({
+      type: 'select',
+      name: 'language',
+      message: 'Please choose the language',
+      choices: Object.keys(LANGUAGES).map(item => ({
+        title: item,
+        value: LANGUAGES[item]
+      }))
+    }) || {}
+    language = _language
+  }
+
+  const { moduleId } = await safePrompts({
+    type: 'text',
+    name: 'moduleId',
+    message: 'Please enter the domain identifier',
+    validate: id => id ? true : 'Domain identifier is required'
+  }) || {}
+
+  return { projectName, framework, language, moduleId }
+}