@cityholdings/minicube-dev 0.1.2 → 0.1.3

package/README.md

@@ -36,8 +36,13 @@ npm publish
 
 Optional tools, used only by the commands that need them: `adb` (Android preview), Xcode
 command-line tools (`xcrun`, iOS simulator/device preview), `kubectl` (token administration or
-`transport: "kube"`), `cube-pack` (inline card images), and the mini program compiler
-`mini-pkg-builder`.
+`transport: "kube"`), `cube-pack` (inline card images), and the official mPaaS mini program IDE
+(`mPaaS小程序开发者工具`).
+
+Mini programs are compiled with the IDE's own `mini-pkg-builder` (and its `esbuild`), found
+automatically in the default install locations: `/Applications` or `~/Applications` on macOS;
+`%LOCALAPPDATA%\Programs`, `%ProgramFiles%` or the installer's recorded folder on Windows. No
+configuration is needed; `builders.mini` / `MINICUBE_MINI_BUILDER` only override it.
 
 Card projects must install ACT v4 themselves (`npm i -D @antdigital/cube@4`). minicube-dev uses only
 that copy, found from the card directory upwards, and stops if it is missing or older than v4; a
@@ -63,16 +68,15 @@ by `MINICUBE_DEV_CONFIG` / `--config`. Create a skeleton with `minicube-dev conf
   "devices": {
     "android": { "package": "<android application id>", "cubeConnectActivity": "<debug activity accepting cubeActHost/cubeActPort>" },
     "ios": { "bundleId": "<bundle id, physical devices only>" }
-  },
-  "builders": { "mini": "/path/to/mini-pkg-builder" }
+  }
 }
 ```
 
 * `token` or `tokenEnv` (name of an environment variable holding it) per environment.
 * Without `baseUrl` (or with `"transport": "kube"`) requests go through `kubectl port-forward`
   using your local kubeconfig.
-* `builders.mini` is the mini-pkg-builder executable (`mini-pkg-builder-macos-arm64`,
-  `mini-pkg-builder-win-x64.exe`, …) or its runtime `index.js`; `MINICUBE_MINI_BUILDER` overrides it.
+* Optional `"builders": { "mini": "<path>" }` (or `MINICUBE_MINI_BUILDER`) points at another
+  mini-pkg-builder executable or runtime `index.js`, e.g. when the IDE is installed elsewhere.
 
 `minicube-dev doctor` checks the toolchain and every environment's token.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cityholdings/minicube-dev",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Command-line workflow for mPaaS mini programs, H5 offline packages and Cube cards: build, debug upload, device preview and release",
   "type": "module",
   "bin": {

package/src/build.js

@@ -3,7 +3,7 @@ import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFil
 import os from 'node:os';
 import path from 'node:path';
 import { CliError, log } from './log.js';
-import { run, which } from './proc.js';
+import { run, runSync, which } from './proc.js';
 import { listFiles, zipDirectory } from './zip.js';
 
 export const OUT_DIR = '.minicube';
@@ -39,19 +39,73 @@ function ensureGitIgnored(root) {
 const MINI_REQUIRED_OUTPUTS = ['appConfig.json', 'index.html', 'index.js', 'index.worker.js', 'manifest.json'];
 const MINI_SOURCE_EXCLUDES = new Set([OUT_DIR, '.git', '.idea', '.vscode', '.DS_Store']);
 
+const IDE_NAME = 'mPaaS小程序开发者工具';
+
+/** Where the official mPaaS mini program IDE keeps its compiler (`<app>/builder/`). */
+export function ideBuilderDirs(platform = process.platform, env = process.env, home = os.homedir()) {
+  if (platform === 'darwin') {
+    return ['/Applications', path.join(home, 'Applications')].map((dir) =>
+      path.join(dir, `${IDE_NAME}.app`, 'Contents', 'Resources', 'app', 'builder'));
+  }
+  if (platform === 'win32') {
+    const roots = [
+      env.LOCALAPPDATA && path.win32.join(env.LOCALAPPDATA, 'Programs'),
+      env.ProgramFiles,
+      env['ProgramFiles(x86)'],
+    ].filter(Boolean);
+    return [...roots.map((root) => path.win32.join(root, IDE_NAME)), ...windowsInstallLocations()]
+      .map((dir) => path.win32.join(dir, 'resources', 'app', 'builder'));
+  }
+  return [];
+}
+
+/** Install folders of the IDE recorded by its Windows installer (covers custom locations). */
+function windowsInstallLocations() {
+  const found = [];
+  for (const hive of ['HKCU', 'HKLM']) {
+    try {
+      const { code, stdout } = runSync('reg', ['query', `${hive}\\Software\\Microsoft\\Windows\\CurrentVersion\\Uninstall`, '/s', '/f', IDE_NAME, '/d']);
+      if (code !== 0) continue;
+      for (const key of stdout.split(/\r?\n/).filter((line) => line.startsWith('HKEY_'))) {
+        const value = runSync('reg', ['query', key, '/v', 'InstallLocation']).stdout.match(/InstallLocation\s+REG_\w+\s+(.+)/);
+        if (value) found.push(value[1].trim().replace(/^"|"$/g, ''));
+      }
+    } catch {
+      // reg.exe unavailable: fall back to the default folders
+    }
+  }
+  return found;
+}
+
+/**
+ * The mini program compiler: MINICUBE_MINI_BUILDER, then builders.mini in the config, then the
+ * copy inside an installed mPaaS mini program IDE. `env` carries the IDE's esbuild, which the
+ * compiler (like the IDE) finds through ESBUILD_BINARY_PATH.
+ */
 export function resolveMiniBuilder(globalConfig) {
   const configured = process.env.MINICUBE_MINI_BUILDER ?? globalConfig.data.builders?.mini;
-  if (!configured || String(configured).includes('<')) {
-    throw new CliError(
-      'No mini program builder configured',
-      'Set builders.mini in the minicube-dev config to the mini-pkg-builder executable (or its runtime index.js), or export MINICUBE_MINI_BUILDER.',
-    );
+  if (configured && !String(configured).includes('<')) {
+    const resolved = which(String(configured)) ?? path.resolve(String(configured));
+    if (!existsSync(resolved)) throw new CliError(`Mini program builder not found: ${resolved}`);
+    return builderAt(resolved);
   }
-  const resolved = which(String(configured)) ?? path.resolve(String(configured));
-  if (!existsSync(resolved)) throw new CliError(`Mini program builder not found: ${resolved}`);
-  return resolved.endsWith('.js') || resolved.endsWith('.mjs')
-    ? { command: process.execPath, prefix: [resolved] }
-    : { command: resolved, prefix: [] };
+  const exe = process.platform === 'win32' ? '.exe' : '';
+  for (const dir of ideBuilderDirs()) {
+    const file = path.join(dir, `mini-pkg-builder${exe}`);
+    if (existsSync(file)) return builderAt(file);
+  }
+  throw new CliError(
+    'No mini program builder found',
+    `Install the mPaaS mini program IDE (${IDE_NAME}), or set builders.mini in the minicube-dev config / MINICUBE_MINI_BUILDER to a mini-pkg-builder executable.`,
+  );
+}
+
+function builderAt(file) {
+  const esbuild = path.join(path.dirname(file), process.platform === 'win32' ? 'esbuild.exe' : 'esbuild');
+  const env = existsSync(esbuild) && !process.env.ESBUILD_BINARY_PATH ? { ESBUILD_BINARY_PATH: esbuild } : {};
+  return file.endsWith('.js') || file.endsWith('.mjs')
+    ? { command: process.execPath, prefix: [file], path: file, env }
+    : { command: file, prefix: [], path: file, env };
 }
 
 function readMiniProjectConfig(sourceDir) {
@@ -87,8 +141,9 @@ async function buildMini(project, globalConfig, outRoot) {
     '--prod', '--no-minify',
   ];
   log.step(`Compiling mini program ${id}`);
+  log.detail(`Compiler ${builder.path}`);
   const logFile = path.join(outRoot, 'mini-build.log');
-  const result = await run(builder.command, args, { cwd: input, capture: true, env: { FORCE_COLOR: '0', NO_COLOR: '1' } });
+  const result = await run(builder.command, args, { cwd: input, capture: true, env: { ...builder.env, FORCE_COLOR: '0', NO_COLOR: '1' } });
   writeFileSync(logFile, `${result.stdout}\n${result.stderr}`);
   rmSync(work, { recursive: true, force: true });
   if (result.code !== 0) {

package/src/cli.js

@@ -385,7 +385,7 @@ const COMMANDS = {
     const config = loadGlobalConfig(ctx.flags);
     add('config', config.exists, config.file);
     try {
-      add('mini builder', true, resolveMiniBuilder(config).prefix[0] ?? resolveMiniBuilder(config).command);
+      add('mini builder', true, resolveMiniBuilder(config).path);
     } catch (e) {
       add('mini builder', false, e.message);
     }

package/src/config.js

@@ -58,9 +58,6 @@ export const CONFIG_TEMPLATE = {
       bundleId: '<ios bundle id>',
     },
   },
-  builders: {
-    mini: '<path to mini-pkg-builder executable or its runtime index.js>',
-  },
 };
 
 /**