@neuxnet/neux-cli 0.2.3

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@neuxnet/neux-cli",
+  "version": "0.2.3",
+  "description": "Standalone CLI and Node API for Neux mini program build, pack, preview, and CI automation.",
+  "type": "module",
+  "bin": {
+    "neux": "src/bin/cli.js"
+  },
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "scripts",
+    "assets/container",
+    "assets/init",
+    "vendor/dimina-compiler",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "scripts": {
+    "sync:container": "node ./scripts/sync-web-container.js",
+    "sync:compiler": "node ./scripts/sync-compiler.js",
+    "prepare:publish": "npm run sync:compiler && npm run sync:container",
+    "generate:init-types": "node ./scripts/generate-init-types.js",
+    "test": "node --test",
+    "smoke:help": "node ./src/bin/cli.js --help",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@vue/compiler-sfc": "^3.5.34",
+    "autoprefixer": "^10.5.0",
+    "cheerio": "^1.2.0",
+    "chokidar": "^4.0.3",
+    "commander": "^14.0.3",
+    "cssnano": "^8.0.1",
+    "esbuild": "^0.28.0",
+    "htmlparser2": "^12.0.0",
+    "less": "^4.6.4",
+    "listr2": "^9.0.5",
+    "magic-string": "^0.30.21",
+    "oxc-parser": "^0.132.0",
+    "oxc-walker": "^1.0.0",
+    "postcss": "^8.5.14",
+    "postcss-selector-parser": "^7.1.1",
+    "qrcode": "^1.5.4",
+    "sass": "^1.99.0",
+    "source-map-js": "^1.2.1"
+  },
+  "keywords": [
+    "miniapp",
+    "cli",
+    "ci",
+    "preview"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "jsqr": "^1.4.0",
+    "pngjs": "^5.0.0"
+  }
+}

package/scripts/generate-init-types.js

@@ -0,0 +1,210 @@
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url))
+const projectRoot = path.resolve(scriptDir, '../..')
+const sourceRoot = path.join(projectRoot, 'fe/packages/service/src/api')
+const docsRoot = path.resolve(projectRoot, '../neuminiappdoc/content/en/4.api-reference')
+const output = path.join(scriptDir, '../assets/init/types/neux-api.d.ts')
+const names = new Set()
+const internalNames = new Set([
+  'env',
+  'fileSystemManagerAPINames',
+  'invokeAPI',
+  'invokePromiseAPI',
+  'registerEnumerableApiNames',
+  'replaceSyncStorageSnapshot',
+])
+const apiMetadata = {
+  request: {
+    description: 'Sends an HTTP request and invokes the success, fail, and complete callbacks.',
+    params: 'URL, method, headers, data, timeout, and lifecycle callbacks.',
+    typeName: 'NeuxRequestOptions',
+  },
+  showToast: {
+    description: 'Displays a short feedback message to the user.',
+    params: 'title, icon, image, duration, and mask.',
+    typeName: 'NeuxShowToastOptions',
+  },
+  showModal: {
+    description: 'Displays a modal dialog with optional cancel and confirm actions.',
+    params: 'title, content, showCancel, cancelText, confirmText, and callbacks.',
+    typeName: 'NeuxShowModalOptions',
+  },
+  showLoading: {
+    description: 'Displays a loading indicator until hideLoading is called.',
+    params: 'title and mask.',
+    typeName: 'NeuxShowLoadingOptions',
+  },
+  navigateTo: {
+    description: 'Opens a new page and keeps the current page in the navigation stack.',
+    params: 'url, events, and success, fail, and complete callbacks.',
+    typeName: 'NeuxNavigateOptions',
+  },
+  redirectTo: {
+    description: 'Closes the current page and navigates to another page.',
+    params: 'url and success, fail, and complete callbacks.',
+    typeName: 'NeuxNavigateOptions',
+  },
+  reLaunch: {
+    description: 'Closes all pages and opens the target page.',
+    params: 'url and success, fail, and complete callbacks.',
+    typeName: 'NeuxNavigateOptions',
+  },
+  switchTab: {
+    description: 'Navigates to a tab bar page and closes other non-tab pages.',
+    params: 'url and success, fail, and complete callbacks.',
+    typeName: 'NeuxNavigateOptions',
+  },
+  setStorage: {
+    description: 'Stores a value in the mini app storage namespace.',
+    params: 'key, data, and success, fail, and complete callbacks.',
+    typeName: 'NeuxSetStorageOptions',
+  },
+  getStorage: {
+    description: 'Reads a value from the mini app storage namespace.',
+    params: 'key and success, fail, and complete callbacks.',
+    typeName: 'NeuxGetStorageOptions',
+  },
+  setClipboardData: {
+    description: 'Writes text to the system clipboard.',
+    params: 'data and success, fail, and complete callbacks.',
+    typeName: 'NeuxSetClipboardDataOptions',
+  },
+  getClipboardData: {
+    description: 'Reads text from the system clipboard.',
+    params: 'success, fail, and complete callbacks.',
+    typeName: 'NeuxCallbackOptions',
+  },
+  chooseImage: {
+    description: 'Opens the image picker or camera and returns selected image files.',
+    params: 'count, sizeType, sourceType, and lifecycle callbacks.',
+    typeName: 'NeuxChooseImageOptions',
+  },
+  scanCode: {
+    description: 'Scans a QR code or barcode using the host camera.',
+    params: 'onlyFromCamera, scanType, and lifecycle callbacks.',
+    typeName: 'NeuxScanCodeOptions',
+  },
+  login: {
+    description: 'Requests a login code from the host application.',
+    params: 'success, fail, and complete callbacks.',
+    typeName: 'NeuxCallbackOptions',
+  },
+  getLocation: {
+    description: 'Reads the current device location after authorization.',
+    params: 'type, altitude, isHighAccuracy, and lifecycle callbacks.',
+    typeName: 'NeuxGetLocationOptions',
+  },
+  setNavigationBarTitle: {
+    description: 'Changes the title displayed in the current page navigation bar.',
+    params: 'title and success, fail, and complete callbacks.',
+    typeName: 'NeuxSetNavigationBarTitleOptions',
+  },
+}
+
+async function visit(directory) {
+  for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
+    const filePath = path.join(directory, entry.name)
+    if (entry.isDirectory()) await visit(filePath)
+    if (entry.name !== 'index.js') continue
+    const source = await fs.readFile(filePath, 'utf8')
+    for (const match of source.matchAll(/export\s+(?:async\s+)?function\s+([A-Za-z_$][\w$]*)|export\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)|export\s*\{([^}]+)\}/g)) {
+      if (match[1] || match[2]) names.add(match[1] || match[2])
+      if (match[3]) {
+        for (const item of match[3].split(',')) {
+          const name = item.trim().split(/\s+as\s+/)[0]
+          if (/^[A-Za-z_$][\w$]*$/.test(name)) names.add(name)
+        }
+      }
+    }
+  }
+}
+
+await visit(sourceRoot)
+const apiNames = [...names]
+  .filter(name => !name.startsWith('__') && !name.startsWith('notify') && !internalNames.has(name))
+  .sort()
+const docsLinks = new Map()
+
+function routePath(relativePath) {
+  return relativePath
+    .slice(0, -3)
+    .split(path.sep)
+    .map(segment => segment.replace(/^\d+\./, ''))
+    .join('/')
+}
+
+async function collectDocLinks(directory = docsRoot, relative = '') {
+  try {
+    for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
+      const filePath = path.join(directory, entry.name)
+      const fileRelative = path.join(relative, entry.name)
+      if (entry.isDirectory()) await collectDocLinks(filePath, fileRelative)
+      if (!entry.isFile() || !entry.name.endsWith('.md') || entry.name === 'index.md') continue
+      const slug = entry.name.slice(0, -3)
+      const apiName = slug.split('-').map((part, index) => index === 0 ? part : `${part[0].toUpperCase()}${part.slice(1)}`).join('')
+      docsLinks.set(apiName, `/en/api-reference/${routePath(fileRelative)}`)
+    }
+  }
+  catch (error) {
+    if (error.code !== 'ENOENT') throw error
+  }
+}
+
+await collectDocLinks()
+const docsBaseUrl = 'https://demo-c.paas.superapp.neuvision.cn/miniappdoc'
+const optionTypes = [
+  'type NeuxCallback = (result?: any) => void;',
+  'type NeuxCallbackOptions = { success?: NeuxCallback; fail?: NeuxCallback; complete?: NeuxCallback; };',
+  'type NeuxRequestOptions = NeuxCallbackOptions & { url: string; method?: string; header?: Record<string, string>; data?: any; timeout?: number; };',
+  'type NeuxShowToastOptions = NeuxCallbackOptions & { title: string; icon?: \'success\' | \'error\' | \'loading\' | \'none\'; image?: string; duration?: number; mask?: boolean; };',
+  'type NeuxShowModalOptions = NeuxCallbackOptions & { title?: string; content?: string; showCancel?: boolean; cancelText?: string; confirmText?: string; cancelColor?: string; confirmColor?: string; };',
+  'type NeuxShowLoadingOptions = NeuxCallbackOptions & { title: string; mask?: boolean; };',
+  'type NeuxNavigateOptions = NeuxCallbackOptions & { url: string; events?: Record<string, NeuxCallback>; };',
+  'type NeuxSetStorageOptions = NeuxCallbackOptions & { key: string; data: any; };',
+  'type NeuxGetStorageOptions = NeuxCallbackOptions & { key: string; };',
+  'type NeuxSetClipboardDataOptions = NeuxCallbackOptions & { data: string; };',
+  'type NeuxChooseImageOptions = NeuxCallbackOptions & { count?: number; sizeType?: string[]; sourceType?: string[]; };',
+  'type NeuxScanCodeOptions = NeuxCallbackOptions & { onlyFromCamera?: boolean; scanType?: string[]; };',
+  'type NeuxGetLocationOptions = NeuxCallbackOptions & { type?: string; altitude?: boolean; isHighAccuracy?: boolean; };',
+  'type NeuxSetNavigationBarTitleOptions = NeuxCallbackOptions & { title: string; };',
+].join('\n')
+const methods = apiNames.map(name => {
+  const metadata = apiMetadata[name] || {
+    description: `Provides the ${name} mini app capability.`,
+    params: 'API-specific arguments. See the linked API reference for the exact signature.',
+  }
+  const link = `${docsBaseUrl}${docsLinks.get(name) || '/en/api-reference'}`
+  return [
+    '  /**',
+    `   * ${metadata.description}`,
+    `   * @param options ${metadata.params}`,
+    `   * @see ${link}`,
+    '   */',
+    `  ${metadata.typeName ? `${name}(options?: ${metadata.typeName}): any;` : `${name}(...args: any[]): any;`}`,
+  ].join('\n')
+}).join('\n')
+const content = [
+  optionTypes,
+  '',
+  'declare type NeuxApi = {',
+  methods,
+  '}',
+  '',
+  'declare const wx: NeuxApi',
+  'declare const nx: NeuxApi',
+  'declare const custom: NeuxApi',
+  '',
+  'declare function App<T extends Record<string, any> = Record<string, any>>(options: T): T',
+  'declare function Page<T extends Record<string, any> = Record<string, any>>(options: T): T',
+  'declare function Component<T extends Record<string, any> = Record<string, any>>(options: T): T',
+  'declare function Behavior<T extends Record<string, any> = Record<string, any>>(options: T): T',
+  'declare function getApp<T extends Record<string, any> = Record<string, any>>(): T',
+  'declare function getCurrentPages<T extends Record<string, any> = Record<string, any>>(): T[]',
+  '',
+].join('\n')
+await fs.mkdir(path.dirname(output), { recursive: true })
+await fs.writeFile(output, content, 'utf8')
+console.log(`Generated ${apiNames.length} API declarations.`)

package/scripts/sync-compiler.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const packageRoot = path.resolve(__dirname, '..')
+const defaultSource = path.resolve(packageRoot, '../fe/packages/compiler/dist')
+const source = path.resolve(process.argv[2] || defaultSource)
+const target = path.join(packageRoot, 'vendor/dimina-compiler')
+
+if (!fs.existsSync(path.join(source, 'index.js'))) {
+  console.error(`Compiler dist not found: ${source}`)
+  console.error('Run `pnpm --dir ../fe --filter @dimina/compiler build` first or pass a compiler dist directory.')
+  process.exit(1)
+}
+
+fs.rmSync(target, { recursive: true, force: true })
+fs.mkdirSync(target, { recursive: true })
+fs.cpSync(source, target, { recursive: true })
+console.log(`Synced compiler: ${source} -> ${target}`)

package/scripts/sync-web-container.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const packageRoot = path.resolve(__dirname, '..')
+const defaultSource = path.resolve(packageRoot, '../fe/packages/container/dist')
+const source = path.resolve(process.argv[2] || defaultSource)
+const target = path.join(packageRoot, 'assets/container')
+const entries = [
+  'index.html',
+  'pageFrame.html',
+  'favicon.ico',
+  'assets',
+  'images',
+]
+
+if (!fs.existsSync(path.join(source, 'index.html'))) {
+  console.error(`Container dist not found: ${source}`)
+  console.error('Run `pnpm --dir ../fe --filter @dimina/container build` first or pass a source directory.')
+  process.exit(1)
+}
+
+fs.rmSync(target, { recursive: true, force: true })
+fs.mkdirSync(target, { recursive: true })
+for (const entry of entries) {
+  const from = path.join(source, entry)
+  if (fs.existsSync(from)) {
+    fs.cpSync(from, path.join(target, entry), { recursive: true })
+  }
+}
+console.log(`Synced web container: ${source} -> ${target}`)