import type { FunctionDocumentationEntry } from '../types';

/**
 * inventory_use
 *
 * 在背包中消耗一个可用物品的面板动作 function。
 */
export const INVENTORY_USE_FUNCTION: FunctionDocumentationEntry = {
  id: 'inventory_use',
  domain: 'panel',
  title: '使用背包物品',
  source: 'src/data/functionCatalog/panel/inventoryUse.ts',
  summary: '从背包面板结算药品、灵力物或 build buff 道具。',
  detailedDescription:
    '它不属于场景探索目录，而是 UI 面板动作。点击具体物品后，本地规则会先结算回复与 buff，再把结果写回剧情历史。',
  trigger: '玩家在 InventoryPanel 中点击可使用物品时触发。',
  execution:
    '本地结算 hp / mana / cooldown / buildBuffs，然后通过 commitGeneratedState 把结果挂回主故事。',
  result: '物品数量减少，角色资源更新，故事文本会明确记录“使用了什么”。',
  active: true,
};