@lark-apaas/coding-templates 0.1.43-alpha.8 → 0.1.43-beta.0

package/template-vite-react/.spark/meta.json.example

@@ -1,8 +0,0 @@
-{
-  "appId": "app_xxxxxxxxxxxxxx",
-  "template": "vite-react",
-  "version": "0.1.0",
-  "archType": 2,
-  "features": ["client"],
-  "appUrl": "https://bytedance.aiforce.cloud/app/app_xxxxxxxxxxxxxx"
-}

package/template-vite-react/.spark_project

@@ -1,18 +0,0 @@
-run = ["npm", "run", "dev"]
-lint = ["npm", "run", "lint"]
-hidden = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", "tmp", ".spark_project", ".playwright-cli"]
-
-[deployment]
-build = ["npm", "run", "build"]
-
-[files]
-[files.restrict]
-pathPatterns = ["package.json", ".spark_project", ".spark/meta.json", ".gitignore"]
-[files.hidden]
-pathPatterns = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", "tmp", ".spark_project", ".playwright-cli"]
-
-[sandbox]
-# 临时兼容老沙箱硬编码探测的 3000 / 8001 端口。
-# 这两个端口由 scripts/mock-health.cjs 占位，Vite dev server 实际监听 CLIENT_DEV_PORT(默认 8080)。
-# 沙箱链路切到新协议后，可改回 [8080]，并删掉 mock-health.cjs。
-healthCheck = [8001, 3000]

package/template-vite-react/scripts/dev.cjs

@@ -1,109 +0,0 @@
-#!/usr/bin/env node
-/**
- * jsPage 模板 dev launcher。
- *
- * 跟全栈 dev.js 对齐：每个子进程的 stdout/stderr 经 readline 逐行拼上
- * 时间戳 + [name] 前缀，同时写到 logs/<name>.std.log（沙箱外壳 dev-logs
- * middleware 监听的标准路径）和当前 stdout。
- *
- * jsPage 只需要 client(vite) + health 两个进程，没有 server。
- * 端口约定（保持跟 .spark_project healthCheck 一致）：
- *   - vite      → 8001（CLIENT_DEV_PORT 可覆盖）
- *   - mock-health → 3000（占位，老沙箱探针兼容用）
- *
- * Ctrl+C / SIGTERM 时 kill 整个进程组。
- */
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-const { spawn } = require('child_process');
-
-const ROOT = path.resolve(__dirname, '..');
-process.chdir(ROOT);
-
-const LOG_DIR = process.env.LOG_DIR || 'logs';
-const CLIENT_DEV_PORT = process.env.CLIENT_DEV_PORT || '8001';
-
-fs.mkdirSync(LOG_DIR, { recursive: true });
-
-function timestamp() {
-  const now = new Date();
-  const pad = (n) => String(n).padStart(2, '0');
-  return (
-    `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ` +
-    `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`
-  );
-}
-
-const managed = [];
-
-function startProcess({ name, command, args, logFileName }) {
-  const logFd = logFileName
-    ? fs.openSync(path.join(LOG_DIR, logFileName), 'a')
-    : null;
-
-  const child = spawn(command, args, {
-    stdio: ['ignore', 'pipe', 'pipe'],
-    shell: false,
-    cwd: ROOT,
-    env: process.env,
-    detached: true,
-  });
-
-  const pipeLines = (stream) => {
-    const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
-    rl.on('line', (line) => {
-      const msg = `[${timestamp()}] [${name}] ${line}\n`;
-      try { process.stdout.write(msg); } catch {}
-      if (logFd != null) {
-        try { fs.writeSync(logFd, msg); } catch {}
-      }
-    });
-  };
-  pipeLines(child.stdout);
-  pipeLines(child.stderr);
-
-  managed.push({ name, child });
-  return child;
-}
-
-startProcess({
-  name: 'client',
-  command: 'npx',
-  args: ['vite', '--port', CLIENT_DEV_PORT, '--host', '0.0.0.0'],
-  logFileName: 'client.std.log',
-});
-
-startProcess({
-  name: 'health',
-  command: 'node',
-  args: ['scripts/mock-health.cjs'],
-  // health 进程不单独写 log，透传到 stdout 就够
-});
-
-let stopping = false;
-function cleanup(signal) {
-  if (stopping) return;
-  stopping = true;
-  for (const { child } of managed) {
-    if (!child.pid) continue;
-    try { process.kill(-child.pid, signal || 'SIGTERM'); } catch {}
-  }
-  setTimeout(() => {
-    for (const { child } of managed) {
-      if (!child.pid) continue;
-      try { process.kill(-child.pid, 'SIGKILL'); } catch {}
-    }
-    process.exit(0);
-  }, 2000);
-}
-
-process.on('SIGINT', () => cleanup('SIGTERM'));
-process.on('SIGTERM', () => cleanup('SIGTERM'));
-
-// 任意子进程退出就触发整体 cleanup，避免半残留
-Promise.race(
-  managed.map(({ child }) => new Promise((r) => child.on('exit', r)))
-).then(() => cleanup('SIGTERM'));

package/template-vite-react/scripts/measure-boot.sh

@@ -1,219 +0,0 @@
-#!/usr/bin/env bash
-# 测沙箱（或本机）模板从 0 到"预览可访问"的耗时拆解。
-# 默认只测 dev 启动那段（不跑 npm install），符合沙箱里依赖已装好的常见场景。
-#
-# 用法：
-#   bash scripts/measure-boot.sh                      # 默认：只测 dev 启动（warm）
-#   bash scripts/measure-boot.sh --cold               # 冷启动：清光 vite 预打包缓存
-#   bash scripts/measure-boot.sh --with-install       # 顺带跑一次 npm install 测装包耗时
-#   bash scripts/measure-boot.sh --with-install --cold # 模拟首次冷启（清 node_modules + .vite）
-#   bash scripts/measure-boot.sh --port 18001         # 临时换端口
-#   bash scripts/measure-boot.sh --base /app/whatever # 临时换 CLIENT_BASE_PATH
-#
-# 兼容：--skip-install 等同于不传（默认就是跳过），保留作为 no-op 防止旧脚本/手势失败。
-#
-# 输出：每段耗时 + 总耗时，写到 ./logs/boot-timing.log（同时打到 stdout）
-
-set -uo pipefail
-T1=0; T2=0
-DEV_PID=0
-
-WITH_INSTALL=0
-COLD=0
-PORT=""
-BASE="/app/probe"
-LOG_DIR="./logs"
-LOG_FILE="$LOG_DIR/boot-timing.log"
-
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --with-install) WITH_INSTALL=1; shift ;;
-    --skip-install) shift ;;  # no-op，兼容旧手势；默认就是跳过
-    --cold) COLD=1; shift ;;
-    --port) PORT="$2"; shift 2 ;;
-    --base) BASE="$2"; shift 2 ;;
-    *) echo "未知参数: $1"; exit 1 ;;
-  esac
-done
-
-mkdir -p "$LOG_DIR"
-: > "$LOG_FILE"
-
-now_ms() {
-  # GNU date 支持 %N，macOS 的 BSD date 不支持——优先用 python3 兜底，避免 sandbox 上 BSD 镜像出错。
-  if command -v python3 >/dev/null 2>&1; then
-    python3 -c 'import time; print(int(time.time()*1000))'
-  else
-    local raw="$(date +%s%3N)"
-    case "$raw" in
-      *N) echo $(($(date +%s) * 1000));;  # date 不支持 %N，降级到秒级精度
-      *) echo "$raw";;
-    esac
-  fi
-}
-log() {
-  local msg="[$(date +%H:%M:%S)] $*"
-  echo "$msg" | tee -a "$LOG_FILE"
-}
-
-# 自动从 package.json 提取 vite 端口
-if [ -z "$PORT" ]; then
-  PORT=$(grep -oE -- '--port[[:space:]]+[0-9]+' package.json 2>/dev/null | head -1 | awk '{print $2}')
-  PORT="${PORT:-8001}"
-fi
-
-export CLIENT_BASE_PATH="$BASE"
-
-log "=============================================="
-log "Boot timing — port=$PORT base=$BASE with-install=$WITH_INSTALL cold=$COLD"
-log "=============================================="
-
-# ── 冷启动：清光本地缓存（不计入耗时，T_TOTAL_START 之前完成）────────
-if [ "$COLD" = "1" ]; then
-  log "[cold] 清缓存以模拟冷启动..."
-  # vite 依赖预打包缓存（永远要清，热启动的最大区别就在这）
-  if [ -d node_modules/.vite ]; then
-    log "  - rm -rf node_modules/.vite"
-    rm -rf node_modules/.vite
-  fi
-  # 本脚本上轮日志
-  if [ -d "$LOG_DIR" ]; then
-    log "  - 清 $LOG_DIR/dev.log（避免 grep 命中旧 ready 行）"
-    : > "$LOG_DIR/dev.log" 2>/dev/null || true
-  fi
-  # 项目级 dist（一般不影响 dev，但顺手）
-  [ -d dist ] && rm -rf dist
-  # 默认保留 node_modules（典型冷启动对照：装好依赖、只清 .vite）
-  # 仅 --with-install 模式才清 node_modules 触发 npm install 重装
-  if [ "$WITH_INSTALL" = "1" ]; then
-    if [ -d node_modules ]; then
-      log "  - rm -rf node_modules（--with-install 模式：清依赖以模拟首次冷启）"
-      rm -rf node_modules
-    fi
-    # npm 全局缓存留着（不动 /tmp/.npmcache / ~/.npm），不然太慢且不真实
-  else
-    log "  - 保留 node_modules（默认模式：只清 .vite 缓存）"
-  fi
-  log "[cold] 缓存清理完成"
-fi
-
-T_TOTAL_START=$(now_ms)
-
-# ── 阶段 1: npm install ──────────────────────────────────────────────
-if [ "$WITH_INSTALL" = "1" ]; then
-  log "[1/4] npm install ..."
-  T1=$(now_ms)
-  npm install --silent > "$LOG_DIR/install.log" 2>&1
-  RC=$?
-  T2=$(now_ms)
-  if [ $RC -ne 0 ]; then
-    log "  ❌ npm install 失败（exit=$RC，详见 $LOG_DIR/install.log）"
-    exit 1
-  fi
-  log "  ✅ 耗时 $((T2 - T1)) ms"
-else
-  log "[1/4] 跳过 npm install（默认；用 --with-install 启用）"
-fi
-
-# ── 阶段 2: 启动 dev（进程拉起到出现 \"VITE ready\" 提示）──────────────
-log "[2/4] npm run dev — 等 vite ready 提示 ..."
-
-# 杀光占用目标端口的所有进程（不依赖进程名匹配，沙箱里 vite 可能被各种 wrapper 拉起）
-kill_port() {
-  local p="$1"
-  local pids
-  pids=$(lsof -tiTCP:"$p" -sTCP:LISTEN 2>/dev/null | tr '\n' ' ')
-  if [ -n "$pids" ]; then
-    log "  清理 :$p 上的进程: $pids"
-    # shellcheck disable=SC2086
-    kill -9 $pids 2>/dev/null || true
-  fi
-}
-kill_port "$PORT"
-kill_port 3000
-# 再保险一道：按名字
-pkill -f 'concurrently.*vite' 2>/dev/null || true
-pkill -f 'mock-health' 2>/dev/null || true
-sleep 1
-
-# 二次校验：端口必须真的空了
-if lsof -tiTCP:"$PORT" -sTCP:LISTEN >/dev/null 2>&1; then
-  log "  ❌ 清理后 :$PORT 仍被占用，请手动 kill 后重试"
-  log "      lsof -i :$PORT"
-  exit 1
-fi
-
-# 截断 log 文件确保 grep 命中的是本次启动的输出（不是旧 log 残留）
-: > "$LOG_DIR/dev.log"
-
-T3=$(now_ms)
-nohup npm run dev > "$LOG_DIR/dev.log" 2>&1 &
-DEV_PID=$!
-
-# 等 vite ready 提示（最多 60s）
-T_READY=""
-for i in $(seq 1 600); do
-  if grep -q 'VITE.*ready' "$LOG_DIR/dev.log" 2>/dev/null; then
-    T_READY=$(now_ms)
-    break
-  fi
-  # 短路：如果 dev 进程已经退出且没出现 ready，提早失败
-  if ! kill -0 "$DEV_PID" 2>/dev/null; then
-    log "  ❌ dev 进程提前退出，看 $LOG_DIR/dev.log"
-    tail -20 "$LOG_DIR/dev.log" | sed 's/^/      /' | tee -a "$LOG_FILE"
-    exit 1
-  fi
-  sleep 0.1
-done
-
-if [ -z "$T_READY" ]; then
-  log "  ❌ 60s 内未看到 vite ready 提示，看 $LOG_DIR/dev.log"
-  kill ${DEV_PID} 2>/dev/null
-  exit 1
-fi
-log "  ✅ 耗时 $((T_READY - T3)) ms"
-
-# ── 阶段 3: 端口可 TCP 连接 ──────────────────────────────────────────
-log "[3/4] 端口 :$PORT 接受 TCP 连接 ..."
-T4=$(now_ms)
-T_TCP=""
-for i in $(seq 1 100); do
-  if (echo > /dev/tcp/127.0.0.1/$PORT) 2>/dev/null; then
-    T_TCP=$(now_ms)
-    break
-  fi
-  sleep 0.05
-done
-if [ -z "$T_TCP" ]; then
-  log "  ❌ 5s 内端口不可连接"
-  kill ${DEV_PID} 2>/dev/null
-  exit 1
-fi
-log "  ✅ 耗时 $((T_TCP - T4)) ms（自 ready 后再 $((T_TCP - T_READY)) ms）"
-
-# ── 阶段 4: 首屏 HTML 200 ─────────────────────────────────────────────
-log "[4/4] curl 首屏（含 base normalize rewrite 路径）..."
-T5=$(now_ms)
-URL="http://127.0.0.1:$PORT${BASE}?probe=1"
-HTTP_CODE=$(curl -sS -o "$LOG_DIR/first.html" -w '%{http_code}' --max-time 10 "$URL" 2>&1)
-T6=$(now_ms)
-SIZE=$(wc -c < "$LOG_DIR/first.html" 2>/dev/null | tr -d ' ')
-
-log "  URL=$URL"
-log "  HTTP=$HTTP_CODE size=${SIZE}B 耗时 $((T6 - T5)) ms"
-
-if [ "$HTTP_CODE" != "200" ]; then
-  log "  ⚠️  非 200，看 $LOG_DIR/first.html"
-fi
-
-# ── 汇总 ──────────────────────────────────────────────────────────────
-T_TOTAL_END=$(now_ms)
-log "=============================================="
-log "总耗时 $((T_TOTAL_END - T_TOTAL_START)) ms"
-log "dev 进程 PID=${DEV_PID}（kill 后退出：kill ${DEV_PID}）"
-log "  install:           $([ $WITH_INSTALL = 1 ] && echo "$((T2 - T1)) ms" || echo skipped)"
-log "  vite ready:        $((T_READY - T3)) ms"
-log "  tcp accept after ready: $((T_TCP - T_READY)) ms"
-log "  first html curl:   $((T6 - T5)) ms"
-log "=============================================="
-log "详细日志：$LOG_FILE / $LOG_DIR/dev.log"

package/template-vite-react/scripts/mock-health.cjs

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-/**
- * 沙箱预览态健康检查兜底：在 3000 端口起 HTTP listener。
- *
- * 老沙箱硬编码探测 3000 + 8001 判定"应用启动了"。jsPage 没有真实 Node server，
- * 8001 由 Vite dev server 真正占（预览流量也走 8001），3000 没有任何业务进程，
- * 只能 mock 一个 listener 让健康检查过。
- *
- * 等沙箱链路切到新协议（读 .spark_project [sandbox].healthCheck）后可删除。
- */
-const http = require('node:http');
-
-const PORTS = [3000];
-
-for (const port of PORTS) {
-  const server = http.createServer((_req, res) => {
-    res.writeHead(200, { 'content-type': 'text/plain' });
-    res.end('ok');
-  });
-  server.on('error', (err) => {
-    console.error(`[mock-health] :${port} listen error:`, err.message);
-    if (err.code === 'EADDRINUSE') {
-      // 端口已被占说明业务已起来，mock 退场即可
-      console.warn(`[mock-health] :${port} 已被占用，跳过 mock`);
-      return;
-    }
-    process.exitCode = 1;
-  });
-  server.listen(port, '0.0.0.0', () => {
-    console.log(`[mock-health] listening on :${port}`);
-  });
-}

package/template-vite-react/src/assets/logo.svg

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
-  <rect width="64" height="64" rx="12" fill="currentColor" opacity="0.1"/>
-  <path d="M20 32 L28 40 L44 24" stroke="currentColor" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
-</svg>