@coze-arch/cli 0.0.10-alpha.b1a3b0 → 0.0.11

package/lib/__templates__/expo/AGENTS.md

@@ -54,13 +54,13 @@ Uniwind 官方文档：https://docs.uniwind.dev/llms.txt
 
 ```bash
 # 对 client 和 server 目录同时进行校验
-npm run lint
+pnpm -w lint:all
 
 # 对 client 目录进行校验
-npm run lint:client
+pnpm -w lint:client
 
 # 对 server 目录进行校验
-npm run lint:server
+pnpm -w lint:server
 ```
 
 ## 如何修改主题模式（跟随系统、固定暗色、固定亮色）

package/lib/__templates__/expo/README.md

@@ -54,13 +54,13 @@ Uniwind 官方文档：https://docs.uniwind.dev/llms.txt
 
 ```bash
 # 对 client 和 server 目录同时进行校验
-npm run lint
+pnpm -w lint:all
 
 # 对 client 目录进行校验
-npm run lint:client
+pnpm -w lint:client
 
 # 对 server 目录进行校验
-npm run lint:server
+pnpm -w lint:server
 ```
 
 ## 如何修改主题模式（跟随系统、固定暗色、固定亮色）

package/lib/__templates__/expo/client/eslint.config.mjs

@@ -84,6 +84,8 @@ export default [
       'no-prototype-builtins': 'off',
       'react/react-in-jsx-scope': 'off',
       'react/jsx-uses-react': 'off',
+      'react/display-name': 'off',
+      'react/prop-types': 'off',
       'fontawesome6/valid-name': 'error',
       'reanimated/ban-mix-use': 'error',
       'forbidEmoji/no-emoji': 'error',

package/lib/__templates__/expo/client/heroui/components/button/button.tsx

@@ -1,5 +1,5 @@
 import { forwardRef, useMemo } from 'react';
-import { View } from 'react-native';
+import { Text as RNText } from 'react-native';
 import { useThemeColor } from '../../helpers/external/hooks';
 import { colorKit } from '../../helpers/external/utils';
 import { HeroText } from '../../helpers/internal/components';
@@ -236,7 +236,7 @@ const ButtonRoot = forwardRef<PressableRef, ButtonRootProps>((props, ref) => {
 
 // --------------------------------------------------
 
-const ButtonLabel = forwardRef<View, ButtonLabelProps>((props, ref) => {
+const ButtonLabel = forwardRef<RNText, ButtonLabelProps>((props, ref) => {
   const { children, className, ...restProps } = props;
 
   const { size, variant } = useButton();

package/lib/__templates__/expo/client/heroui/components/chip/chip.tsx

@@ -1,5 +1,5 @@
 import { forwardRef, useMemo } from 'react';
-import { Pressable, View, type StyleProp, type ViewStyle } from 'react-native';
+import { Pressable, Text as RNText, type StyleProp, type ViewStyle } from 'react-native';
 import { HeroText } from '../../helpers/internal/components';
 import { AnimationSettingsProvider } from '../../helpers/internal/contexts';
 import type { PressableRef } from '../../helpers/internal/types';
@@ -78,7 +78,7 @@ const Chip = forwardRef<PressableRef, ChipProps>((props, ref) => {
 
 // --------------------------------------------------
 
-const ChipLabel = forwardRef<View, ChipLabelProps>((props, ref) => {
+const ChipLabel = forwardRef<RNText, ChipLabelProps>((props, ref) => {
   const { children, className, ...restProps } = props;
 
   const { size, variant, color } = useChip();

package/lib/__templates__/expo/client/heroui/components/list-group/list-group.types.ts

@@ -1,4 +1,4 @@
-import type { PressableProps, ViewProps } from 'react-native';
+import type { PressableProps, TextProps, ViewProps } from 'react-native';
 import type { SurfaceVariant } from '../surface/surface.types';
 
 /**
@@ -85,7 +85,7 @@ export interface ListGroupItemContentProps extends ViewProps {
  * Props for the ListGroup.ItemTitle component.
  * Renders the primary text label for an item.
  */
-export interface ListGroupItemTitleProps extends ViewProps {
+export interface ListGroupItemTitleProps extends TextProps {
   /**
    * Title text or custom content
    */
@@ -100,7 +100,7 @@ export interface ListGroupItemTitleProps extends ViewProps {
  * Props for the ListGroup.ItemDescription component.
  * Renders secondary descriptive text below the title.
  */
-export interface ListGroupItemDescriptionProps extends ViewProps {
+export interface ListGroupItemDescriptionProps extends TextProps {
   /**
    * Description text or custom content
    */

package/lib/__templates__/expo/client/heroui/components/pressable-feedback/index.ts

@@ -1,4 +1,3 @@
-/* eslint-disable prettier/prettier */
 export { default as PressableFeedback } from './pressable-feedback';
 export { pressableFeedbackClassNames } from './pressable-feedback.styles';
 export type * from './pressable-feedback.types';

package/lib/__templates__/expo/client/heroui/components/pressable-feedback/pressable-feedback.animation.ts

@@ -1,3 +1,4 @@
+/* eslint-disable react-hooks/preserve-manual-memoization */
 import { useCallback } from 'react';
 import type { GestureResponderEvent } from 'react-native';
 import type { SharedValue } from 'react-native-reanimated';

package/lib/__templates__/expo/client/heroui/components/pressable-feedback/pressable-feedback.styles.ts

@@ -1,4 +1,3 @@
-/* eslint-disable prettier/prettier */
 import { StyleSheet } from 'react-native';
 import { tv } from 'tailwind-variants';
 import { combineStyles } from '../../helpers/internal/utils';

package/lib/__templates__/expo/client/heroui/components/skeleton/skeleton.animation.ts

@@ -1,3 +1,4 @@
+/* eslint-disable react-hooks/immutability */
 import { useEffect, useMemo } from 'react';
 import type { SharedValue } from 'react-native-reanimated';
 import {

package/lib/__templates__/expo/client/heroui/components/toast/toast.tsx

@@ -1,5 +1,5 @@
 import { forwardRef, useMemo } from 'react';
-import { View } from 'react-native';
+import { View, Text as RNText } from 'react-native';
 import { GestureDetector } from 'react-native-gesture-handler';
 import Animated from 'react-native-reanimated';
 import { useThemeColor } from '../../helpers/external/hooks';
@@ -134,7 +134,7 @@ const ToastRoot = forwardRef<ViewRef, ToastRootProps>((props, ref) => {
               {...restProps}
             >
               {children}
-              {/* 
+              {/*
                 When visible toasts have different heights, the toast adapts to the last visible toast height.
                 In cases where a toast originally has one height and gets smaller when a new toast comes to stack,
                 content might be visible behind the last toast without proper padding.
@@ -174,7 +174,7 @@ const ToastRoot = forwardRef<ViewRef, ToastRootProps>((props, ref) => {
 
 // --------------------------------------------------
 
-const ToastTitle = forwardRef<View, ToastTitleProps>((props, ref) => {
+const ToastTitle = forwardRef<RNText, ToastTitleProps>((props, ref) => {
   const { children, className, ...restProps } = props;
 
   const { variant } = useToast();
@@ -193,7 +193,7 @@ const ToastTitle = forwardRef<View, ToastTitleProps>((props, ref) => {
 
 // --------------------------------------------------
 
-const ToastDescription = forwardRef<View, ToastDescriptionProps>(
+const ToastDescription = forwardRef<RNText, ToastDescriptionProps>(
   (props, ref) => {
     const { children, className, ...restProps } = props;
 

package/lib/__templates__/expo/client/heroui/helpers/external/utils/color-kit/index.ts

@@ -1,3 +1,6 @@
+/* eslint-disable regexp/use-ignore-case */
+/* eslint-disable regexp/optimal-quantifier-concatenation */
+/* eslint-disable regexp/no-useless-quantifier */
 /**
  * Color manipulation utilities adapted from reanimated-color-picker
  *
@@ -293,7 +296,7 @@ export const colorKitUI = () => {
   ): ColorFormats | null => {
     // color int
     if (typeof color === 'number') {
-      // eslint-disable-next-line no-bitwise
+       
       if (color >>> 0 === color && color >= 0 && color <= 0xffffffff)
         return 'hex8';
       return null;
@@ -1491,7 +1494,7 @@ export const colorKitUI = () => {
   ): ColorFormats | 'named' | null => {
     // color int
     if (typeof color === 'number') {
-      // eslint-disable-next-line no-bitwise
+       
       if (color >>> 0 === color && color >= 0 && color <= 0xffffffff)
         return 'hex8';
       return null;

package/lib/__templates__/expo/client/heroui/helpers/internal/hooks/use-controllable-state.ts

@@ -39,7 +39,7 @@ type SetStateFn<T> = (prevState?: T) => T;
 function useControllableState<T>({
   prop,
   defaultProp,
-  onChange = () => {},
+  onChange = () => {}, // eslint-disable-line @typescript-eslint/no-empty-function
 }: UseControllableStateParams<T>) {
   const [uncontrolledProp, setUncontrolledProp] = useUncontrolledState({
     defaultProp,

package/lib/__templates__/expo/client/heroui/helpers/internal/hooks/use-dev-info.ts

@@ -31,7 +31,7 @@ export function useDevInfo(devInfo?: DevInfoConfig): void {
           `  - Check component documentation - Each component page includes a link to the component's style source\n` +
           `• If styles are occupied by animation, modify them via the animation prop on components that support it.\n` +
           `• To deactivate animated style completely and apply your own styles, use isAnimatedStyleActive prop.\n` +
-          `${LOG_COLOR.YELLOW}💡 To disable this message, set config.devInfo.stylingPrinciples to false${LOG_COLOR.RESET}`
+          `${LOG_COLOR.YELLOW} To disable this message, set config.devInfo.stylingPrinciples to false${LOG_COLOR.RESET}`
       );
     }
   }, [stylingPrinciples]);

package/lib/__templates__/expo/client/heroui/primitives/slider/slider.tsx

@@ -1,3 +1,4 @@
+/* eslint-disable react-hooks/refs */
 import {
   forwardRef,
   useCallback,

package/lib/__templates__/expo/client/heroui/primitives/slot/slot.tsx

@@ -1,3 +1,4 @@
+/* eslint-disable react-hooks/refs */
 import {
   cloneElement,
   forwardRef,

package/lib/__templates__/expo/package.json

@@ -9,7 +9,7 @@
     "preinstall": "npx only-allow pnpm",
     "lint:client": "npm run lint --prefix ./client",
     "lint:server": "npm run lint --prefix ./server",
-    "lint": "npm run lint --prefix ./client; npm run lint --prefix ./server"
+    "lint:all": "npm run lint --prefix ./client; npm run lint --prefix ./server"
   },
   "dependencies": {},
   "devDependencies": {},

package/lib/__templates__/nextjs/AGENTS.md

@@ -42,13 +42,15 @@
 
 ## 开发规范
 
-- **项目理解加速**：初始可以依赖项目下`package.json`文件理解项目类型，如果没有或无法理解退化成阅读其他文件。
-- **Hydration 错误预防**：严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。
+### Hydration 问题防范
 
+1. 严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。**必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染**；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。
+2. **禁止使用 head 标签**，优先使用 metadata，详见文档：https://nextjs.org/docs/app/api-reference/functions/generate-metadata
+   1. 三方 CSS、字体等资源可在 `globals.css` 中顶部通过 `@import` 引入或使用 next/font
+   2. preload, preconnect, dns-prefetch 通过 ReactDOM 的 preload、preconnect、dns-prefetch 方法引入
+   3. json-ld 可阅读 https://nextjs.org/docs/app/guides/json-ld
 
 ## UI 设计与组件规范 (UI & Styling Standards)
 
 - 模板默认预装核心组件库 `shadcn/ui`，位于`src/components/ui/`目录下
 - Next.js 项目**必须默认**采用 shadcn/ui 组件、风格和规范，**除非用户指定用其他的组件和规范。**
-
-

package/lib/__templates__/nextjs/eslint.config.mjs

@@ -2,12 +2,21 @@ import nextTs from 'eslint-config-next/typescript';
 import nextVitals from 'eslint-config-next/core-web-vitals';
 import { defineConfig, globalIgnores } from 'eslint/config';
 
+const syntaxRules = [
+  {
+    selector: 'JSXOpeningElement[name.name="head"]',
+    message:
+      '禁止使用 head 标签，优先使用 metadata。三方 CSS、字体等资源可以在 globals.css 中顶部通过 @import 引入或者使用 next/font；preload, preconnect, dns-prefetch 通过 ReactDOM 的 preload、preconnect、dns-prefetch 方法引入；json-ld 可阅读 https://nextjs.org/docs/app/guides/json-ld',
+  },
+];
+
 const eslintConfig = defineConfig([
   ...nextVitals,
   ...nextTs,
   {
     rules: {
       'react-hooks/set-state-in-effect': 'off',
+      'no-restricted-syntax': ['error', ...syntaxRules],
     },
   },
   // Override default ignores of eslint-config-next.

package/lib/__templates__/taro/.coze

@@ -1,4 +1,6 @@
 [project]
+template = "taro"
+version = "legacy.2"
 entrypoint = "server.js"
 requires = ["nodejs-24"]
 

package/lib/__templates__/taro/.cozeproj/scripts/pack.sh

@@ -1,5 +1,4 @@
 # build_weapp.sh - 通过 PID 文件精确杀掉自己上次的构建进程
-export OUTPUT_ROOT=dist
 PID_FILE="/tmp/coze-build_weapp.pid"
 
 # 杀掉上次的构建进程组
@@ -15,7 +14,7 @@ if [ -f "$PID_FILE" ]; then
 fi
 
 # 用 setsid 创建新的进程组，方便下次整组杀掉
-setsid pnpm build:weapp &
+setsid pnpm pack &
 echo $! > "$PID_FILE"
 
 echo "构建已启动 (PID: $(cat $PID_FILE))"

package/lib/__templates__/taro/config/index.ts

@@ -37,7 +37,7 @@ const generateTTProjectConfig = (outputRoot: string) => {
 // https://taro-docs.jd.com/docs/next/config#defineconfig-辅助函数
 export default defineConfig<'vite'>(async (merge, _env) => {
   const outputRootMap: Record<string, string> = {
-    weapp: 'dist-weapp',
+    weapp: 'dist',
     tt: 'dist-tt',
     h5: 'dist-web',
   };

package/lib/__templates__/taro/package.json

@@ -21,6 +21,7 @@
     "lint:build": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\" --max-warnings=0",
     "lint:fix": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\" --fix",
     "new": "taro new",
+    "pack": "pnpm exec concurrently --kill-others-on-fail --kill-signal SIGKILL -n weapp,tt -c yellow,cyan \"pnpm build:weapp\" \"pnpm build:tt\"",
     "preview:tt": "taro build --type tt --preview",
     "preview:weapp": "taro build --type weapp --preview",
     "tsc": "npx tsc --noEmit --skipLibCheck",

package/lib/__templates__/taro/project.config.json

@@ -12,5 +12,5 @@
     "minified": false
   },
   "compileType": "miniprogram",
-  "packOptions": {"ignore": [{"type": "folder","value": "./assets"}]}
+  "packOptions": { "ignore": [{ "type": "folder", "value": "./assets" }] }
 }

package/lib/cli.js

@@ -2106,7 +2106,7 @@ const EventBuilder = {
 };
 
 var name = "@coze-arch/cli";
-var version = "0.0.10-alpha.b1a3b0";
+var version = "0.0.11";
 var description = "coze coding devtools cli";
 var license = "MIT";
 var author = "fanwenjie.fe@bytedance.com";
@@ -2179,7 +2179,7 @@ var devDependencies = {
 	"json-schema-to-typescript": "^15.0.3",
 	minimatch: "^10.0.1",
 	playwright: "~1.55.0",
-	rollup: "^4.41.1",
+	rollup: "^4.60.1",
 	sucrase: "^3.35.0",
 	"tree-kill": "^1.2.2",
 	tsx: "^4.20.6",
@@ -3401,118 +3401,6 @@ function safeJsonParse(
   }
 }
 
-function _optionalChain$g(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-
-/**
- * 检测并解析配置文件内容
- *
- * @param content - 文件内容
- * @returns 解析后的配置对象
- */
-const parseConfigContent = (content) => {
-  // 1. 尝试 TOML 格式 (默认)
-  try {
-    const config = toml.parse(content);
-    return config ;
-  } catch (error) {
-    // TOML 解析失败，继续尝试其他格式
-
-    console.debug('TOML parse failed:', error);
-  }
-
-  // 2. 尝试 YAML 格式
-  try {
-    const config = jsYaml.load(content);
-    if (config && typeof config === 'object') {
-      return config ;
-    }
-  } catch (error) {
-    // YAML 解析失败，继续尝试其他格式
-
-    console.debug('YAML parse failed:', error);
-  }
-
-  // 3. 尝试 JSON 格式
-  const config = safeJsonParse(content);
-  if (config) {
-    return config;
-  }
-
-  return null;
-};
-
-/**
- * 加载 .coze 配置文件
- *
- * @param projectPath - 项目目录路径
- * @returns .coze 配置对象
- */
-const loadCozeConfig = async (
-  projectPath = process.cwd(),
-) => {
-  const cozeConfigPath = path.join(projectPath, '.coze');
-
-  let content;
-  try {
-    content = await fs$1.readFile(cozeConfigPath, 'utf-8');
-  } catch (error) {
-    throw new Error(
-      `.coze config file not found in ${projectPath}\n` +
-        'Please ensure you are in a project directory initialized with coze-coding.\n' +
-        `Error: ${error instanceof Error ? error.message : String(error)}`,
-    );
-  }
-
-  const config = parseConfigContent(content);
-  if (!config) {
-    throw new Error(
-      'Failed to parse .coze config file.\n' +
-        'Please ensure the file is in valid TOML, YAML, or JSON format.',
-    );
-  }
-
-  return config;
-};
-
-/**
- * 获取指定命令的配置
- *
- * @param config - .coze 配置对象
- * @param commandName - 命令名称 (dev/build/start)
- * @returns 命令配置数组
- */
-const getCommandConfig = (
-  config,
-  commandName,
-) => {
-  let commandConfig;
-
-  // 根据命令名称映射到配置路径
-  switch (commandName) {
-    case 'dev':
-      commandConfig = _optionalChain$g([config, 'access', _ => _.dev, 'optionalAccess', _2 => _2.run]);
-      break;
-    case 'build':
-      commandConfig = _optionalChain$g([config, 'access', _3 => _3.deploy, 'optionalAccess', _4 => _4.build]);
-      break;
-    case 'start':
-      commandConfig = _optionalChain$g([config, 'access', _5 => _5.deploy, 'optionalAccess', _6 => _6.run]);
-      break;
-    default:
-      throw new Error(`Unknown command: ${commandName}`);
-  }
-
-  if (!commandConfig || commandConfig.length === 0) {
-    throw new Error(
-      `Command '${commandName}' is not configured in .coze file.\n` +
-        'Please add the corresponding configuration to your .coze file.',
-    );
-  }
-
-  return commandConfig;
-};
-
 const ALIAS = Symbol.for('yaml.alias');
 const DOC = Symbol.for('yaml.document');
 const MAP = Symbol.for('yaml.map');
@@ -3548,7 +3436,7 @@ function isNode(node) {
 }
 const hasAnchor = (node) => (isScalar(node) || isCollection(node)) && !!node.anchor;
 
-function _optionalChain$f(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$g(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 const BREAK = Symbol('break visit');
 const SKIP = Symbol('skip children');
 const REMOVE = Symbol('remove node');
@@ -3661,15 +3549,15 @@ function callVisitor(key, node, visitor, path) {
     if (typeof visitor === 'function')
         return visitor(key, node, path);
     if (isMap(node))
-        return _optionalChain$f([visitor, 'access', _ => _.Map, 'optionalCall', _2 => _2(key, node, path)]);
+        return _optionalChain$g([visitor, 'access', _ => _.Map, 'optionalCall', _2 => _2(key, node, path)]);
     if (isSeq(node))
-        return _optionalChain$f([visitor, 'access', _3 => _3.Seq, 'optionalCall', _4 => _4(key, node, path)]);
+        return _optionalChain$g([visitor, 'access', _3 => _3.Seq, 'optionalCall', _4 => _4(key, node, path)]);
     if (isPair(node))
-        return _optionalChain$f([visitor, 'access', _5 => _5.Pair, 'optionalCall', _6 => _6(key, node, path)]);
+        return _optionalChain$g([visitor, 'access', _5 => _5.Pair, 'optionalCall', _6 => _6(key, node, path)]);
     if (isScalar(node))
-        return _optionalChain$f([visitor, 'access', _7 => _7.Scalar, 'optionalCall', _8 => _8(key, node, path)]);
+        return _optionalChain$g([visitor, 'access', _7 => _7.Scalar, 'optionalCall', _8 => _8(key, node, path)]);
     if (isAlias(node))
-        return _optionalChain$f([visitor, 'access', _9 => _9.Alias, 'optionalCall', _10 => _10(key, node, path)]);
+        return _optionalChain$g([visitor, 'access', _9 => _9.Alias, 'optionalCall', _10 => _10(key, node, path)]);
     return undefined;
 }
 function replaceNode(key, path, node) {
@@ -3760,7 +3648,7 @@ function applyReviver(reviver, obj, key, val) {
     return reviver.call(obj, key, val);
 }
 
-function _optionalChain$e(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$f(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 /**
  * Recursively convert any node or its contents to native JavaScript
  *
@@ -3790,7 +3678,7 @@ function toJS(value, arg, ctx) {
             ctx.onCreate(res);
         return res;
     }
-    if (typeof value === 'bigint' && !_optionalChain$e([ctx, 'optionalAccess', _ => _.keep]))
+    if (typeof value === 'bigint' && !_optionalChain$f([ctx, 'optionalAccess', _ => _.keep]))
         return Number(value);
     return value;
 }
@@ -3828,7 +3716,7 @@ class NodeBase {
     }
 }
 
-function _optionalChain$d(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$e(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 class Alias extends NodeBase {
     constructor(source) {
         super(ALIAS);
@@ -3845,7 +3733,7 @@ class Alias extends NodeBase {
      */
     resolve(doc, ctx) {
         let nodes;
-        if (_optionalChain$d([ctx, 'optionalAccess', _ => _.aliasResolveCache])) {
+        if (_optionalChain$e([ctx, 'optionalAccess', _ => _.aliasResolveCache])) {
             nodes = ctx.aliasResolveCache;
         }
         else {
@@ -3884,7 +3772,7 @@ class Alias extends NodeBase {
             data = anchors.get(source);
         }
         /* istanbul ignore if */
-        if (_optionalChain$d([data, 'optionalAccess', _2 => _2.res]) === undefined) {
+        if (_optionalChain$e([data, 'optionalAccess', _2 => _2.res]) === undefined) {
             const msg = 'This should not happen: Alias anchor was not resolved?';
             throw new ReferenceError(msg);
         }
@@ -3936,7 +3824,7 @@ function getAliasCount(doc, node, anchors) {
     return 1;
 }
 
-function _optionalChain$c(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$d(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 const isScalarValue = (value) => !value || (typeof value !== 'function' && typeof value !== 'object');
 class Scalar extends NodeBase {
     constructor(value) {
@@ -3944,7 +3832,7 @@ class Scalar extends NodeBase {
         this.value = value;
     }
     toJSON(arg, ctx) {
-        return _optionalChain$c([ctx, 'optionalAccess', _ => _.keep]) ? this.value : toJS(this.value, arg, ctx);
+        return _optionalChain$d([ctx, 'optionalAccess', _ => _.keep]) ? this.value : toJS(this.value, arg, ctx);
     }
     toString() {
         return String(this.value);
@@ -3956,7 +3844,7 @@ Scalar.PLAIN = 'PLAIN';
 Scalar.QUOTE_DOUBLE = 'QUOTE_DOUBLE';
 Scalar.QUOTE_SINGLE = 'QUOTE_SINGLE';
 
-function _nullishCoalesce$6(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$b(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _nullishCoalesce$6(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$c(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 const defaultTagPrefix = 'tag:yaml.org,2002:';
 function findTagObject(value, tagName, tags) {
     if (tagName) {
@@ -3966,7 +3854,7 @@ function findTagObject(value, tagName, tags) {
             throw new Error(`Tag ${tagName} not found`);
         return tagObj;
     }
-    return tags.find(t => _optionalChain$b([t, 'access', _ => _.identify, 'optionalCall', _2 => _2(value)]) && !t.format);
+    return tags.find(t => _optionalChain$c([t, 'access', _ => _.identify, 'optionalCall', _2 => _2(value)]) && !t.format);
 }
 function createNode(value, tagName, ctx) {
     if (isDocument(value))
@@ -3974,7 +3862,7 @@ function createNode(value, tagName, ctx) {
     if (isNode(value))
         return value;
     if (isPair(value)) {
-        const map = _optionalChain$b([ctx, 'access', _3 => _3.schema, 'access', _4 => _4[MAP], 'access', _5 => _5.createNode, 'optionalCall', _6 => _6(ctx.schema, null, ctx)]);
+        const map = _optionalChain$c([ctx, 'access', _3 => _3.schema, 'access', _4 => _4[MAP], 'access', _5 => _5.createNode, 'optionalCall', _6 => _6(ctx.schema, null, ctx)]);
         map.items.push(value);
         return map;
     }
@@ -4001,7 +3889,7 @@ function createNode(value, tagName, ctx) {
             sourceObjects.set(value, ref);
         }
     }
-    if (_optionalChain$b([tagName, 'optionalAccess', _7 => _7.startsWith, 'call', _8 => _8('!!')]))
+    if (_optionalChain$c([tagName, 'optionalAccess', _7 => _7.startsWith, 'call', _8 => _8('!!')]))
         tagName = defaultTagPrefix + tagName.slice(2);
     let tagObj = findTagObject(value, tagName, schema.tags);
     if (!tagObj) {
@@ -4026,9 +3914,9 @@ function createNode(value, tagName, ctx) {
         onTagObj(tagObj);
         delete ctx.onTagObj;
     }
-    const node = _optionalChain$b([tagObj, 'optionalAccess', _9 => _9.createNode])
+    const node = _optionalChain$c([tagObj, 'optionalAccess', _9 => _9.createNode])
         ? tagObj.createNode(ctx.schema, value, ctx)
-        : typeof _optionalChain$b([tagObj, 'optionalAccess', _10 => _10.nodeClass, 'optionalAccess', _11 => _11.from]) === 'function'
+        : typeof _optionalChain$c([tagObj, 'optionalAccess', _10 => _10.nodeClass, 'optionalAccess', _11 => _11.from]) === 'function'
             ? tagObj.nodeClass.from(ctx.schema, value, ctx)
             : new Scalar(value);
     if (tagName)
@@ -4346,7 +4234,7 @@ function consumeMoreIndentedLines(text, i, indent) {
     return end;
 }
 
-function _optionalChain$a(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$b(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 const getFoldOptions = (ctx, isBlock) => ({
     indentAtStart: isBlock ? ctx.indent.length : ctx.indentAtStart,
     lineWidth: ctx.options.lineWidth,
@@ -4631,9 +4519,9 @@ function plainString(item, ctx, onComment, onChompKeep) {
     // booleans get parsed with those types in v1.2 (e.g. '42', 'true' & '0.9e-3'),
     // and others in v1.1.
     if (actualString) {
-        const test = (tag) => tag.default && tag.tag !== 'tag:yaml.org,2002:str' && _optionalChain$a([tag, 'access', _ => _.test, 'optionalAccess', _2 => _2.test, 'call', _3 => _3(str)]);
+        const test = (tag) => tag.default && tag.tag !== 'tag:yaml.org,2002:str' && _optionalChain$b([tag, 'access', _ => _.test, 'optionalAccess', _2 => _2.test, 'call', _3 => _3(str)]);
         const { compat, tags } = ctx.doc.schema;
-        if (tags.some(test) || _optionalChain$a([compat, 'optionalAccess', _4 => _4.some, 'call', _5 => _5(test)]))
+        if (tags.some(test) || _optionalChain$b([compat, 'optionalAccess', _4 => _4.some, 'call', _5 => _5(test)]))
             return quotedString(value, ctx);
     }
     return implicitKey
@@ -4679,7 +4567,7 @@ function stringifyString(item, ctx, onComment, onChompKeep) {
     return res;
 }
 
-function _nullishCoalesce$5(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$9(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _nullishCoalesce$5(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$a(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 function createStringifyContext(doc, options) {
     const opt = Object.assign({
         blockQuote: true,
@@ -4697,6 +4585,7 @@ function createStringifyContext(doc, options) {
         nullStr: 'null',
         simpleKeys: false,
         singleQuote: null,
+        trailingComma: false,
         trueStr: 'true',
         verifyAliasOrder: true
     }, doc.schema.toStringOptions, options);
@@ -4731,7 +4620,7 @@ function getTagObject(tags, item) {
     let obj;
     if (isScalar(item)) {
         obj = item.value;
-        let match = tags.filter(t => _optionalChain$9([t, 'access', _ => _.identify, 'optionalCall', _2 => _2(obj)]));
+        let match = tags.filter(t => _optionalChain$a([t, 'access', _ => _.identify, 'optionalCall', _2 => _2(obj)]));
         if (match.length > 1) {
             const testMatch = match.filter(t => t.test);
             if (testMatch.length > 0)
@@ -4745,7 +4634,7 @@ function getTagObject(tags, item) {
         tagObj = tags.find(t => t.nodeClass && obj instanceof t.nodeClass);
     }
     if (!tagObj) {
-        const name = _nullishCoalesce$5(_optionalChain$9([obj, 'optionalAccess', _3 => _3.constructor, 'optionalAccess', _4 => _4.name]), () => ( (obj === null ? 'null' : typeof obj)));
+        const name = _nullishCoalesce$5(_optionalChain$a([obj, 'optionalAccess', _3 => _3.constructor, 'optionalAccess', _4 => _4.name]), () => ( (obj === null ? 'null' : typeof obj)));
         throw new Error(`Tag not resolved for ${name} value`);
     }
     return tagObj;
@@ -4771,7 +4660,7 @@ function stringify(item, ctx, onComment, onChompKeep) {
     if (isAlias(item)) {
         if (ctx.doc.directives)
             return item.toString(ctx);
-        if (_optionalChain$9([ctx, 'access', _5 => _5.resolvedAliases, 'optionalAccess', _6 => _6.has, 'call', _7 => _7(item)])) {
+        if (_optionalChain$a([ctx, 'access', _5 => _5.resolvedAliases, 'optionalAccess', _6 => _6.has, 'call', _7 => _7(item)])) {
             throw new TypeError(`Cannot stringify circular structure without alias nodes`);
         }
         else {
@@ -4953,7 +4842,7 @@ function warn(logLevel, warning) {
     }
 }
 
-function _optionalChain$8(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$9(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 // If the value associated with a merge key is a single mapping node, each of
 // its key/value pairs is inserted into the current mapping, unless the key
 // already exists in it. If the value associated with the merge key is a
@@ -4977,7 +4866,7 @@ const isMergeKey = (ctx, key) => (merge.identify(key) ||
     (isScalar(key) &&
         (!key.type || key.type === Scalar.PLAIN) &&
         merge.identify(key.value))) &&
-    _optionalChain$8([ctx, 'optionalAccess', _ => _.doc, 'access', _2 => _2.schema, 'access', _3 => _3.tags, 'access', _4 => _4.some, 'call', _5 => _5(tag => tag.tag === merge.tag && tag.default)]);
+    _optionalChain$9([ctx, 'optionalAccess', _ => _.doc, 'access', _2 => _2.schema, 'access', _3 => _3.tags, 'access', _4 => _4.some, 'call', _5 => _5(tag => tag.tag === merge.tag && tag.default)]);
 function addMergeToJSMap(ctx, map, value) {
     value = ctx && isAlias(value) ? value.resolve(ctx.doc) : value;
     if (isSeq(value))
@@ -5014,7 +4903,7 @@ function mergeValue(ctx, map, value) {
     return map;
 }
 
-function _optionalChain$7(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$8(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 function addPairToJSMap(ctx, map, { key, value }) {
     if (isNode(key) && key.addToJSMap)
         key.addToJSMap(ctx, map, value);
@@ -5051,7 +4940,7 @@ function stringifyKey(key, jsKey, ctx) {
     // eslint-disable-next-line @typescript-eslint/no-base-to-string
     if (typeof jsKey !== 'object')
         return String(jsKey);
-    if (isNode(key) && _optionalChain$7([ctx, 'optionalAccess', _ => _.doc])) {
+    if (isNode(key) && _optionalChain$8([ctx, 'optionalAccess', _ => _.doc])) {
         const strCtx = createStringifyContext(ctx.doc, {});
         strCtx.anchors = new Set();
         for (const node of ctx.anchors.keys())
@@ -5071,7 +4960,7 @@ function stringifyKey(key, jsKey, ctx) {
     return JSON.stringify(jsKey);
 }
 
-function _optionalChain$6(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$7(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 function createPair(key, value, ctx) {
     const k = createNode(key, undefined, ctx);
     const v = createNode(value, undefined, ctx);
@@ -5092,17 +4981,17 @@ class Pair {
         return new Pair(key, value);
     }
     toJSON(_, ctx) {
-        const pair = _optionalChain$6([ctx, 'optionalAccess', _2 => _2.mapAsMap]) ? new Map() : {};
+        const pair = _optionalChain$7([ctx, 'optionalAccess', _2 => _2.mapAsMap]) ? new Map() : {};
         return addPairToJSMap(ctx, pair, this);
     }
     toString(ctx, onComment, onChompKeep) {
-        return _optionalChain$6([ctx, 'optionalAccess', _3 => _3.doc])
+        return _optionalChain$7([ctx, 'optionalAccess', _3 => _3.doc])
             ? stringifyPair(this, ctx, onComment, onChompKeep)
             : JSON.stringify(this);
     }
 }
 
-function _nullishCoalesce$3(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$5(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _nullishCoalesce$3(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$6(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 function stringifyCollection(collection, ctx, options) {
     const flow = _nullishCoalesce$3(ctx.inFlow, () => ( collection.flow));
     const stringify = flow ? stringifyFlowCollection : stringifyBlockCollection;
@@ -5196,19 +5085,29 @@ function stringifyFlowCollection({ items }, ctx, { flowChars, itemIndent }) {
                 if (iv.commentBefore)
                     reqNewline = true;
             }
-            else if (item.value == null && _optionalChain$5([ik, 'optionalAccess', _ => _.comment])) {
+            else if (item.value == null && _optionalChain$6([ik, 'optionalAccess', _ => _.comment])) {
                 comment = ik.comment;
             }
         }
         if (comment)
             reqNewline = true;
         let str = stringify(item, itemCtx, () => (comment = null));
-        if (i < items.length - 1)
+        reqNewline || (reqNewline = lines.length > linesAtValue || str.includes('\n'));
+        if (i < items.length - 1) {
             str += ',';
+        }
+        else if (ctx.options.trailingComma) {
+            if (ctx.options.lineWidth > 0) {
+                reqNewline || (reqNewline = lines.reduce((sum, line) => sum + line.length + 2, 2) +
+                    (str.length + 2) >
+                    ctx.options.lineWidth);
+            }
+            if (reqNewline) {
+                str += ',';
+            }
+        }
         if (comment)
             str += lineComment(str, itemIndent, commentString(comment));
-        if (!reqNewline && (lines.length > linesAtValue || str.includes('\n')))
-            reqNewline = true;
         lines.push(str);
         linesAtValue = lines.length;
     }
@@ -5241,7 +5140,7 @@ function addCommentBefore({ indent, options: { commentString } }, lines, comment
     }
 }
 
-function _nullishCoalesce$2(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$4(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _nullishCoalesce$2(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$5(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 function findPair(items, key) {
     const k = isScalar(key) ? key.value : key;
     for (const it of items) {
@@ -5302,12 +5201,12 @@ class YAMLMap extends Collection {
             _pair = pair;
         else if (!pair || typeof pair !== 'object' || !('key' in pair)) {
             // In TypeScript, this never happens.
-            _pair = new Pair(pair, _optionalChain$4([pair, 'optionalAccess', _2 => _2.value]));
+            _pair = new Pair(pair, _optionalChain$5([pair, 'optionalAccess', _2 => _2.value]));
         }
         else
             _pair = new Pair(pair.key, pair.value);
         const prev = findPair(this.items, _pair.key);
-        const sortEntries = _optionalChain$4([this, 'access', _3 => _3.schema, 'optionalAccess', _4 => _4.sortMapEntries]);
+        const sortEntries = _optionalChain$5([this, 'access', _3 => _3.schema, 'optionalAccess', _4 => _4.sortMapEntries]);
         if (prev) {
             if (!overwrite)
                 throw new Error(`Key ${_pair.key} already set`);
@@ -5337,7 +5236,7 @@ class YAMLMap extends Collection {
     }
     get(key, keepScalar) {
         const it = findPair(this.items, key);
-        const node = _optionalChain$4([it, 'optionalAccess', _5 => _5.value]);
+        const node = _optionalChain$5([it, 'optionalAccess', _5 => _5.value]);
         return _nullishCoalesce$2((!keepScalar && isScalar(node) ? node.value : node), () => ( undefined));
     }
     has(key) {
@@ -5352,8 +5251,8 @@ class YAMLMap extends Collection {
      * @returns Instance of Type, Map, or Object
      */
     toJSON(_, ctx, Type) {
-        const map = Type ? new Type() : _optionalChain$4([ctx, 'optionalAccess', _6 => _6.mapAsMap]) ? new Map() : {};
-        if (_optionalChain$4([ctx, 'optionalAccess', _7 => _7.onCreate]))
+        const map = Type ? new Type() : _optionalChain$5([ctx, 'optionalAccess', _6 => _6.mapAsMap]) ? new Map() : {};
+        if (_optionalChain$5([ctx, 'optionalAccess', _7 => _7.onCreate]))
             ctx.onCreate(map);
         for (const item of this.items)
             addPairToJSMap(ctx, map, item);
@@ -5378,7 +5277,7 @@ class YAMLMap extends Collection {
     }
 }
 
-function _optionalChain$3(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$4(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 class YAMLSeq extends Collection {
     static get tagName() {
         return 'tag:yaml.org,2002:seq';
@@ -5441,7 +5340,7 @@ class YAMLSeq extends Collection {
     }
     toJSON(_, ctx) {
         const seq = [];
-        if (_optionalChain$3([ctx, 'optionalAccess', _2 => _2.onCreate]))
+        if (_optionalChain$4([ctx, 'optionalAccess', _2 => _2.onCreate]))
             ctx.onCreate(seq);
         let i = 0;
         for (const item of this.items)
@@ -5520,7 +5419,7 @@ function createPairs(schema, iterable, ctx) {
     return pairs;
 }
 
-function _optionalChain$2(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+function _optionalChain$3(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 class YAMLOMap extends YAMLSeq {
     constructor() {
         super();
@@ -5539,7 +5438,7 @@ class YAMLOMap extends YAMLSeq {
         if (!ctx)
             return super.toJSON(_);
         const map = new Map();
-        if (_optionalChain$2([ctx, 'optionalAccess', _2 => _2.onCreate]))
+        if (_optionalChain$3([ctx, 'optionalAccess', _2 => _2.onCreate]))
             ctx.onCreate(map);
         for (const pair of this.items) {
             let key, value;
@@ -5913,6 +5812,118 @@ const isProjectType = async (
   return result.detected && result.type === expectedType;
 };
 
+function _optionalChain$2(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+/**
+ * 检测并解析配置文件内容
+ *
+ * @param content - 文件内容
+ * @returns 解析后的配置对象
+ */
+const parseConfigContent = (content) => {
+  // 1. 尝试 TOML 格式 (默认)
+  try {
+    const config = toml.parse(content);
+    return config ;
+  } catch (error) {
+    // TOML 解析失败，继续尝试其他格式
+
+    console.debug('TOML parse failed:', error);
+  }
+
+  // 2. 尝试 YAML 格式
+  try {
+    const config = jsYaml.load(content);
+    if (config && typeof config === 'object') {
+      return config ;
+    }
+  } catch (error) {
+    // YAML 解析失败，继续尝试其他格式
+
+    console.debug('YAML parse failed:', error);
+  }
+
+  // 3. 尝试 JSON 格式
+  const config = safeJsonParse(content);
+  if (config) {
+    return config;
+  }
+
+  return null;
+};
+
+/**
+ * 加载 .coze 配置文件
+ *
+ * @param projectPath - 项目目录路径
+ * @returns .coze 配置对象
+ */
+const loadCozeConfig = async (
+  projectPath = process.cwd(),
+) => {
+  const cozeConfigPath = path.join(projectPath, '.coze');
+
+  let content;
+  try {
+    content = await fs$1.readFile(cozeConfigPath, 'utf-8');
+  } catch (error) {
+    throw new Error(
+      `.coze config file not found in ${projectPath}\n` +
+        'Please ensure you are in a project directory initialized with coze-coding.\n' +
+        `Error: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  const config = parseConfigContent(content);
+  if (!config) {
+    throw new Error(
+      'Failed to parse .coze config file.\n' +
+        'Please ensure the file is in valid TOML, YAML, or JSON format.',
+    );
+  }
+
+  return config;
+};
+
+/**
+ * 获取指定命令的配置
+ *
+ * @param config - .coze 配置对象
+ * @param commandName - 命令名称 (dev/build/start)
+ * @returns 命令配置数组
+ */
+const getCommandConfig = (
+  config,
+  commandName,
+) => {
+  let commandConfig;
+
+  // 根据命令名称映射到配置路径
+  switch (commandName) {
+    case 'dev':
+      commandConfig = _optionalChain$2([config, 'access', _ => _.dev, 'optionalAccess', _2 => _2.run]);
+      break;
+    case 'build':
+      commandConfig = _optionalChain$2([config, 'access', _3 => _3.deploy, 'optionalAccess', _4 => _4.build]);
+      break;
+    case 'start':
+      commandConfig = _optionalChain$2([config, 'access', _5 => _5.deploy, 'optionalAccess', _6 => _6.run]);
+      break;
+    default:
+      throw new Error(`Unknown command: ${commandName}`);
+  }
+
+  if (!commandConfig || commandConfig.length === 0) {
+    throw new Error(
+      `Command '${commandName}' is not configured in .coze file.\n` +
+        'Please add the corresponding configuration to your .coze file.',
+    );
+  }
+
+  return commandConfig;
+};
+
 // ABOUTME: Fix rule to replace npx commands with pnpm in shell scripts (dev.sh, build.sh)
 // ABOUTME: This fixes module resolution issues when using npx in certain project types
 // ABOUTME: See: /Users/bytedance/Downloads/projects2/docs/npx-pnpm-module-resolution-issue.md
@@ -6426,18 +6437,50 @@ const createLogStream = (logFilePath) => {
   const logDir = path.dirname(logFilePath);
 
   // 确保日志目录存在
+  // eslint-disable-next-line security/detect-non-literal-fs-filename -- resolved from config, not raw user input
   if (!fs.existsSync(logDir)) {
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- resolved from config, not raw user input
     fs.mkdirSync(logDir, { recursive: true });
   }
 
   // 使用 'w' 标志覆盖之前的日志
+  // eslint-disable-next-line security/detect-non-literal-fs-filename -- resolved from config, not raw user input
   return fs.createWriteStream(logFilePath, { flags: 'w' });
 };
 
 /**
  * 执行命令的内部实现
  */
-// eslint-disable-next-line @coze-arch/max-line-per-function, max-lines-per-function
+const reportFailureAndExit = (
+  error,
+  exitCode,
+  context
+
+
+
+
+
+,
+) => {
+  const { commandName, cmdStartTime, options, categories, errorContext } =
+    context;
+  reportError(error, { command: commandName, ...errorContext });
+  reportCommandComplete(commandName, false, Date.now() - cmdStartTime, {
+    args: JSON.stringify(options),
+    errorCode: exitCode,
+    errorMessage: error.message,
+    categories,
+  });
+  flushSlardar()
+    .then(() => {
+      process.exit(exitCode);
+    })
+    .catch(() => {
+      process.exit(exitCode);
+    });
+};
+
+// eslint-disable-next-line @coze-arch/max-line-per-function, max-lines-per-function -- orchestrates fix+build+reporting
 const executeRun = async (
   commandName,
   options = {},
@@ -6445,12 +6488,17 @@ const executeRun = async (
   const cmdStartTime = Date.now();
   let fixDuration = 0;
   let buildStartTime = 0;
+  let projectType = 'unknown';
 
   try {
     logger.info(`Running ${commandName} command...`);
 
+    // 检测项目类型，用于上报
+    const projectDetection = await detectProjectType(process.cwd());
+    projectType = projectDetection.type;
+
     // 上报命令开始
-    reportCommandStart(commandName, JSON.stringify(options));
+    reportCommandStart(commandName, JSON.stringify(options), { projectType });
 
     // 1. 对于 build 命令，先执行 fix 以确保项目配置正确
     if (['dev', 'build'].includes(commandName)) {
@@ -6458,9 +6506,9 @@ const executeRun = async (
       const fixStartTime = Date.now();
       try {
         await executeFix();
-        // eslint-disable-next-line @coze-arch/no-empty-catch
-      } catch (e) {
-        // just ignore
+        // eslint-disable-next-line @coze-arch/no-empty-catch, @coze-arch/use-error-in-catch -- intentionally ignored
+      } catch (_e) {
+        // fix errors are intentionally ignored to allow the main command to proceed
       }
       fixDuration = Date.now() - fixStartTime;
       logger.info('');
@@ -6517,25 +6565,23 @@ const executeRun = async (
           logger.error(`Check log file for details: ${logFilePath}`);
 
           // 上报命令失败
-          reportError(new Error(errorMessage), {
-            command: commandName,
-            exitCode: String(_nullishCoalesce$1(code, () => ( 'unknown'))),
-            signal: _nullishCoalesce$1(signal, () => ( 'none')),
-            logFile: logFilePath,
-          });
-          reportCommandComplete(commandName, false, Date.now() - cmdStartTime, {
-            args: JSON.stringify(options),
-            errorCode: _nullishCoalesce$1(code, () => ( 1)),
-            errorMessage,
+          reportFailureAndExit(new Error(errorMessage), code || 1, {
+            commandName,
+            cmdStartTime,
+            options,
+            categories: {
+              fixDuration: String(fixDuration),
+              buildDuration: String(buildDuration),
+              exitCode: String(_nullishCoalesce$1(code, () => ( 'unknown'))),
+              projectType,
+            },
+            errorContext: {
+              exitCode: String(_nullishCoalesce$1(code, () => ( 'unknown'))),
+              signal: _nullishCoalesce$1(signal, () => ( 'none')),
+              logFile: logFilePath,
+              projectType,
+            },
           });
-          flushSlardar()
-            .then(() => {
-              process.exit(code || 1);
-            })
-            .catch(() => {
-              // Catch any errors in the promise chain to prevent unhandled rejections
-              process.exit(code || 1);
-            });
         } else {
           logger.success('Command completed successfully');
           logger.info(`Log file: ${logFilePath}`);
@@ -6547,6 +6593,7 @@ const executeRun = async (
               fixDuration: String(fixDuration),
               buildDuration: String(buildDuration),
               exitCode: '0',
+              projectType,
             },
           });
           // flush 由 main 函数统一处理
@@ -6565,65 +6612,21 @@ const executeRun = async (
         const buildDuration = Date.now() - buildStartTime;
 
         // 上报错误
-        reportError(error, {
-          command: commandName,
-          type: 'child_process_error',
-        });
-        reportCommandComplete(commandName, false, Date.now() - cmdStartTime, {
-          args: JSON.stringify(options),
-          errorCode: 1,
-          errorMessage: error.message,
+        reportFailureAndExit(error, 1, {
+          commandName,
+          cmdStartTime,
+          options,
           categories: {
             fixDuration: String(fixDuration),
             buildDuration: String(buildDuration),
             exitCode: 'error',
+            errorType: 'child_process_error',
+            projectType,
           },
+          errorContext: { type: 'child_process_error', projectType },
         });
-        flushSlardar()
-          .then(() => {
-            process.exit(1);
-          })
-          .catch(() => {
-            // Catch any errors in the promise chain to prevent unhandled rejections
-            process.exit(1);
-          });
       });
     });
-
-    childProcess.on('error', (error) => {
-      logger.error('Failed to execute command:');
-      logger.error(`Error: ${error.message}`);
-      if (error.stack) {
-        logger.error(`Stack trace:\n${error.stack}`);
-      }
-      logStream.end();
-
-      const buildDuration = Date.now() - buildStartTime;
-
-      // 上报错误
-      reportError(error, {
-        command: commandName,
-        type: 'child_process_error',
-      });
-      reportCommandComplete(commandName, false, Date.now() - cmdStartTime, {
-        args: JSON.stringify(options),
-        errorCode: 1,
-        errorMessage: error.message,
-        categories: {
-          fixDuration: String(fixDuration),
-          buildDuration: String(buildDuration),
-          errorType: 'child_process_error',
-        },
-      });
-      flushSlardar()
-        .then(() => {
-          process.exit(1);
-        })
-        .catch(() => {
-          // Catch any errors in the promise chain to prevent unhandled rejections
-          process.exit(1);
-        });
-    });
   } catch (error) {
     const err = error instanceof Error ? error : new Error(String(error));
     logger.error(`Failed to run ${commandName} command:`);
@@ -6632,28 +6635,18 @@ const executeRun = async (
     const buildDuration = buildStartTime > 0 ? Date.now() - buildStartTime : 0;
 
     // 上报错误
-    reportError(err, {
-      command: commandName,
-      type: 'execution_error',
-    });
-    reportCommandComplete(commandName, false, Date.now() - cmdStartTime, {
-      args: JSON.stringify(options),
-      errorCode: 1,
-      errorMessage: err.message,
+    reportFailureAndExit(err, 1, {
+      commandName,
+      cmdStartTime,
+      options,
       categories: {
         fixDuration: String(fixDuration),
         buildDuration: String(buildDuration),
         errorType: 'execution_error',
+        projectType,
       },
+      errorContext: { type: 'execution_error', projectType },
     });
-    flushSlardar()
-      .then(() => {
-        process.exit(1);
-      })
-      .catch(() => {
-        // Catch any errors in the promise chain to prevent unhandled rejections
-        process.exit(1);
-      });
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.10-alpha.b1a3b0",
+  "version": "0.0.11",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -73,7 +73,7 @@
     "json-schema-to-typescript": "^15.0.3",
     "minimatch": "^10.0.1",
     "playwright": "~1.55.0",
-    "rollup": "^4.41.1",
+    "rollup": "^4.60.1",
     "sucrase": "^3.35.0",
     "tree-kill": "^1.2.2",
     "tsx": "^4.20.6",