/**
 * dsh-notifier —— 投递理由的 code 闭集（纯数据，无 import）。
 *
 * 为什么两端共用一份：`reasonLegacy` 此前在客户端是一份**靠注释维系的同值字面量**
 * （`const LEGACY_CODE = "reasonLegacy"`，注释自述「与服务端 REASON_LEGACY 同值」），而没有任何
 * 断言锁住两者相等——改一边就是一个读不出来的历史行。收口后客户端只消费这里这个值。
 *
 * 值函数（reason / normalizeReason / reasonFromCause / clampReasonDetail / sameReasonShape）不在这里：
 * 它们依赖 src/server/shared/text.ts 的截断实现，属宿主端，进不了零 import 的共享面。
 *
 * 生产侧闭集在本地，读侧仍是开放 string（磁盘上的旧行与跨版本数据不受本版编译期约束）。
 * 客户端字典必须覆盖 REASON_CODES 的每一项，跨端一致性由 test/client-unit/reason-text.test.ts 的
 * 直连断言守（客户端只把 REASON_LEGACY 当值用，REASON_CODES 只作类型来源）。
 */
/**
 * 升级前的散文理由。这一条是唯一「code 不含文案」的取值：原文整句进 `detail`，客户端逐字渲染。
 * 它只在割接产物上出现（见 upgrade 域的 reason 形态迁移），但会随历史记录长期留在磁盘上。
 */
export declare const REASON_LEGACY = "reasonLegacy";
/**
 * 本版会生产的 code 清单。命名即字典 key：`t(code, params)` 直接取文案，不另建一张
 * code → key 的映射表，少一处能漂的地方。
 */
export declare const REASON_CODES: readonly ["reasonLegacy", "reasonSkipConfig", "reasonSkipEnvironment", "reasonSystemPopupFailed", "reasonSystemSoundFailed", "reasonSystemToastScriptMissing", "reasonSystemToneUnwritable", "reasonBarkRequestFailed", "reasonBarkHttp", "reasonBarkRejected", "reasonBarkBodyUnreadable", "reasonWebhookTemplateInvalid", "reasonWebhookRequestFailed", "reasonWebhookHttp", "reasonUnknownTarget", "reasonChannelThrew", "reasonThrottled", "reasonDispatchCanceled"];
export type ReasonCode = (typeof REASON_CODES)[number];
/** 理由参数：只收能被字典插值的标量——对象与数组进不来，文案层不必再判嵌套。 */
export type ReasonParams = Readonly<Record<string, string | number>>;
/**
 * 声音警告的窄识别表：`ok` 随行的 soundWarning 只接受这三个 code。
 *
 * 为什么另立窄表而不是复用 REASON_CODES：主理由的读面是开放的（旧散文、未知 code 都要
 * 收编成可渲染的中性文案），而警告是新写面——手改磁盘把 `reasonChannelThrew` 这类任意 code
 * 塞进 soundWarning 时，必须丢该字段保主记录，不能把它当事实渲染出来。三个取值各有事实：
 * 链全失败（soundFailed）、临时文件写不进去（toneUnwritable）、自播需要但无可执行声音
 * （skipEnvironment）。不新增 code，表内三项全是既有 code。
 */
export declare const SOUND_WARNING_CODES: readonly ["reasonSkipEnvironment", "reasonSystemSoundFailed", "reasonSystemToneUnwritable"];
export type SoundWarningCode = (typeof SOUND_WARNING_CODES)[number];
/** 是否声音警告 code（纯函数，零 import，可进两端共享面）。 */
export declare function isSoundWarningCode(code: string): code is SoundWarningCode;