/** * 反馈语义模型(module 13 task 246):成功/错误/警告统一文案与 busy 防重入。 * 纯逻辑、不依赖 Element;UI 接线见 admin-feedback-ui.ts。 */ export type AdminFeedbackKind = 'success' | 'error' | 'warning' export const FEEDBACK_TEXT = { successDefault: '操作成功', errorDefault: '操作失败,请稍后重试', warningDefault: '请确认后再继续', busySuffix: '中…', } as const export interface NormalizedFeedback { kind: AdminFeedbackKind message: string } const KIND_DEFAULT: Record = { success: FEEDBACK_TEXT.successDefault, error: FEEDBACK_TEXT.errorDefault, warning: FEEDBACK_TEXT.warningDefault, } /** 归一反饋消息:显式 message 保留并去首尾空白,空值按 kind 落默认文案。 */ export function normalizeFeedback(message?: string, kind?: AdminFeedbackKind): NormalizedFeedback { const k: AdminFeedbackKind = kind ?? 'warning' const trimmed = typeof message === 'string' ? message.trim() : '' return { kind: k, message: trimmed ? trimmed : KIND_DEFAULT[k] } } /** 忙碌按钮文案:「保存」→「保存中…」;已以「中」结尾则不重复补。 */ export function busyLabel(verb: string): string { const v = (verb || '处理').trim() return v.endsWith('中') ? `${v}…` : `${v}${FEEDBACK_TEXT.busySuffix}` } /** 把 Error/字符串/未知错误转成可行动错误文案;空值回默认错误。 */ export function actionableErrorText(error: unknown): string { if (error instanceof Error && error.message && error.message.trim()) return error.message.trim() if (typeof error === 'string' && error.trim()) return error.trim() return FEEDBACK_TEXT.errorDefault } // busy 单例锁:表单提交/导出等防重复进入。 let busy = false export function tryBeginBusy(): boolean { if (busy) return false busy = true return true } export function endBusy(): void { busy = false } export function isBusy(): boolean { return busy }