// 开发者输入函数签名
function calculateDiscount(price, discountRate, isMember) {
  // 光标停在此处准备写注释
}

// 智能补全系统可能自动生成以下JSDoc注释草案：
/**
 * 计算商品折扣后的价格。
 * @param {number} price - 商品原价。
 * @param {number} discountRate - 折扣率，范围0到1（例如0.2表示八折）。
 * @param {boolean} isMember - 是否为会员，会员可能享有额外折扣。
 * @returns {number} 折扣后的最终价格。
 * @throws {RangeError} 当discountRate不在0到1范围内时抛出。
 */
function calculateDiscount(price, discountRate, isMember) {
  if (discountRate < 0 || discountRate > 1) {
    throw new RangeError('折扣率必须在0到1之间');
  }
  // ... 函数逻辑
}

// 输入
interface UserConfig {
  id: number;
  name: string;
  preferences?: {
    theme: 'light' | 'dark';
    notifications: boolean;
  };
}

async function updateUserProfile(config: UserConfig, forceUpdate: boolean): Promise<boolean> {
  // 光标处触发补全
}

// 智能补全可能生成：
/**
 * 异步更新用户配置文件。
 * @param {UserConfig} config - 用户配置对象。
 * @param {number} config.id - 用户唯一标识符。
 * @param {string} config.name - 用户显示名称。
 * @param {Object} [config.preferences] - 用户偏好设置（可选）。
 * @param {'light' | 'dark'} config.preferences.theme - 界面主题。
 * @param {boolean} config.preferences.notifications - 是否接收通知。
 * @param {boolean} forceUpdate - 是否忽略版本检查强制更新。
 * @returns {Promise<boolean>} 更新成功返回true，否则返回false。
 * @throws {Error} 当网络请求失败或用户不存在时抛出。
 */
async function updateUserProfile(config: UserConfig, forceUpdate: boolean): Promise<boolean> {
  // 实现逻辑
}

// 文件路径： src/utils/stringFormatter.js
// 开发者开始输入
/**
 * 光标在此处，触发补全
 */
export class StringFormatter {
  // ...
}

// 可能被补全为：
/**
 * 提供一系列字符串格式化处理的工具类。
 * 包括但不限于：字符串截断、驼峰转换、模板渲染等。
 * @class StringFormatter
 * @example
 * const formatter = new StringFormatter();
 * const result = formatter.truncate('Hello World', 5); // 'Hello...'
 */
export class StringFormatter {
  // ...
}

// 输入
type ApiResponse<T = any> = {
  // 光标处
};

// 补全后可能为：
/**
 * 标准API响应数据结构。
 * @template T - 响应体中数据字段的具体类型。
 * @property {number} code - 响应状态码。0表示成功，非0表示错误。
 * @property {string} message - 响应的提示信息。
 * @property {T} [data] - 响应承载的数据，可选。
 * @property {number} timestamp - 服务器响应的时间戳（毫秒）。
 */
type ApiResponse<T = any> = {
  code: number;
  message: string;
  data?: T;
  timestamp: number;
};

// 当编写一个数组去重函数时
/**
 * 对数组进行去重，支持基本类型和对象引用。
 * @param {Array} arr - 需要去重的数组。
 * @returns {Array} 去重后的新数组。
 * @example
 * // 基本类型去重
 * unique([1, 2, 2, 3]); // [1, 2, 3]
 * // 对象引用去重（相同引用才视为重复）
 * const obj = {a: 1};
 * unique([obj, obj, {a: 1}]); // [obj, {a: 1}]
 */
function unique(arr) {
  return [...new Set(arr)];
}

// 原始英文注释（由智能补全生成）
/**
 * Fetches user data from the remote API.
 * @param {string} userId - The unique identifier of the user.
 * @returns {Promise<User>} A promise that resolves with the user object.
 */

// 工具可以提示或生成中文注释草案
/**
 * 从远程API获取用户数据。
 * @param {string} userId - 用户的唯一标识符。
 * @returns {Promise<User>} 解析为用户对象的Promise。
 */
async function fetchUser(userId) { }