@bdky/aaas-pilot-kit 1.0.4 → 1.0.5

package/dist/libs/aaas-pilot-kit/src/lib/utils/AudioDeviceDetector.d.ts

@@ -0,0 +1,138 @@
+/**
+ * WebRTC 音频设备严谨检测工具类
+ *
+ * 实现了 4 层渐进式检测逻辑，从基础 API 支持到实际音频流获取验证
+ *
+ * @example
+ * ```typescript
+ * const detector = new AudioDeviceDetector();
+ * const result = await detector.checkAudioDevice();
+ *
+ * if (result.available) {
+ *   console.log('设备可用，可以开始录音');
+ *   // 调用 getUserMedia
+ * } else {
+ *   console.error('设备不可用:', result.error, result.message);
+ *   // 根据错误类型给用户提示
+ * }
+ * ```
+ */
+/**
+ * 音频设备检测错误类型枚举
+ */
+export declare enum AudioDeviceError {
+    /** 浏览器不支持 MediaDevices API */
+    NO_API_SUPPORT = "NO_API_SUPPORT",
+    /** 非 HTTPS 安全上下文 (localhost 除外) */
+    INSECURE_CONTEXT = "INSECURE_CONTEXT",
+    /** 通过 enumerateDevices 未找到音频输入设备 */
+    NO_DEVICE_FOUND = "NO_DEVICE_FOUND",
+    /** 用户拒绝麦克风权限 */
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    /** 用户关闭/忽略权限弹窗 */
+    PERMISSION_DISMISSED = "PERMISSION_DISMISSED",
+    /** 设备被其他程序占用 */
+    DEVICE_IN_USE = "DEVICE_IN_USE",
+    /** 检测超时 */
+    TIMEOUT = "TIMEOUT",
+    /** 未知错误 */
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * 音频设备检测结果
+ */
+export interface AudioDeviceCheckResult {
+    /** 设备是否可用 */
+    available: boolean;
+    /** 错误类型 (仅在 available = false 时存在) */
+    error?: AudioDeviceError;
+    /** 错误详细信息 */
+    message?: string;
+    /** 检测通过的层级 (1-4) */
+    passedLevel?: number;
+    /** 找到的音频设备列表 */
+    devices?: MediaDeviceInfo[];
+    /** 权限状态 (如果浏览器支持) */
+    permissionState?: PermissionState;
+}
+/**
+ * 检测配置选项
+ */
+export interface AudioDetectorOptions {
+    /** 超时时间 (毫秒)，默认 5000ms */
+    timeout?: number;
+    /** 是否在检测完成后自动释放资源，默认 true */
+    autoCleanup?: boolean;
+}
+/**
+ * WebRTC 音频设备检测器
+ */
+export declare class AudioDeviceDetector {
+    private mediaStream;
+    private readonly options;
+    constructor(options?: AudioDetectorOptions);
+    /**
+     * 手动释放资源
+     *
+     * 注意: 如果 autoCleanup = true，会在 checkAudioDevice 完成后自动调用
+     */
+    cleanup(): void;
+    /**
+     * 执行完整的音频设备检测
+     *
+     * @returns 检测结果
+     */
+    checkAudioDevice(): Promise<AudioDeviceCheckResult>;
+    /**
+     * 执行实际的检测流程
+     */
+    private performCheck;
+    /**
+     * Level 1: 检查浏览器 API 支持
+     */
+    private checkAPISupport;
+    /**
+     * Level 2: 检查设备枚举
+     */
+    private checkDeviceEnumeration;
+    /**
+     * Level 3: 检查权限状态 (可选，Safari 不支持)
+     */
+    private checkPermissionState;
+    /**
+     * Level 4: 获取实际音频流
+     */
+    private checkMediaStream;
+    /**
+     * 创建错误结果
+     */
+    private createErrorResult;
+    /**
+     * 添加超时控制
+     */
+    private withTimeout;
+}
+/**
+ * 快捷函数：执行音频设备检测
+ *
+ * @param options 检测选项
+ * @returns 检测结果
+ *
+ * @example
+ * ```typescript
+ * const result = await checkAudioDevice();
+ * if (result.available) {
+ *   // 开始录音
+ * } else {
+ *   alert(result.message);
+ * }
+ * ```
+ */
+export declare function checkAudioDevice(options?: AudioDetectorOptions): Promise<AudioDeviceCheckResult>;
+/**
+ * 根据错误类型获取用户友好的提示信息
+ *
+ * @param error 错误类型
+ * @returns 用户提示信息
+ */
+export declare const getErrorMessage: (error: AudioDeviceError) => string;

package/dist/libs/aaas-pilot-kit/src/lib/utils/agentResponseHelper.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file AgentResponse 工具函数
+ * @description 简化 AgentResponse 的订阅和使用
+ */
+import { type AgentResponse } from '../service/agent/agentResponse';
+export interface ISubscribeAgentResponseOptions<T> {
+    /**
+     * 当响应更新时的回调
+     */
+    onUpdate?: (response: AgentResponse<T>) => void;
+    /**
+     * 当响应完成时的回调
+     */
+    onComplete?: (response: AgentResponse<T>) => void;
+}
+/**
+ * 订阅 AgentResponse 的更新
+ * 自动处理已完成和未完成的情况,在完成时自动取消订阅
+ *
+ * @param agentResponse - Agent 响应对象
+ * @param options - 订阅选项
+ * @returns 取消订阅函数
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = subscribeAgentResponse(
+ *     agentResponse,
+ *     {
+ *         onUpdate: response => {
+ *             console.log('更新:', response.getChunks());
+ *         },
+ *         onComplete: response => {
+ *             console.log('完成:', response.getFullText());
+ *         }
+ *     }
+ * );
+ *
+ * // 手动取消订阅(通常不需要,完成时会自动取消)
+ * unsubscribe();
+ * ```
+ */
+export declare function subscribeAgentResponse<T = unknown>(agentResponse: AgentResponse<T> | null | undefined, options: ISubscribeAgentResponseOptions<T>): () => void;

package/dist/libs/aaas-pilot-kit/src/lib/utils/language-mapper.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 语言映射工具
+ *
+ * 用于将 SDK 统一语言代码映射为不同服务的语言格式
+ */
+/**
+ * 统一语言代码常量
+ *
+ * 用于配置 ASR 识别语言和 TTS 合成语言
+ *
+ * @example
+ * ```ts
+ * import {Language} from '@bdky/aaas-pilot-kit';
+ *
+ * const kit = createAaaSPilotKit({
+ *   lang: Language.ENGLISH,  // 使用常量
+ *   // 或
+ *   lang: 'en',  // 直接使用字符串
+ *   // ...
+ * });
+ * ```
+ */
+export declare const Language: {
+    /** 中文(普通话) - Chinese (Mandarin) */
+    readonly CHINESE: "zh";
+    /** 英语 - English */
+    readonly ENGLISH: "en";
+    /** 日语 - Japanese */
+    readonly JAPANESE: "ja";
+    /** 西班牙语 - Spanish */
+    readonly SPANISH: "es";
+    /** 俄语 - Russian */
+    readonly RUSSIAN: "ru";
+    /** 韩语 - Korean */
+    readonly KOREAN: "ko";
+    /** 越南语 - Vietnamese */
+    readonly VIETNAMESE: "vi";
+    /** 德语 - German */
+    readonly GERMAN: "de";
+    /** 印尼语 - Indonesian */
+    readonly INDONESIAN: "id";
+    /** 泰语 - Thai */
+    readonly THAI: "th";
+};
+/**
+ * 语言代码类型
+ */
+export type LanguageCode = typeof Language[keyof typeof Language];
+/**
+ * 将 SDK 统一语言代码映射为 BRTC 语言代码
+ *
+ * @param sdkLang SDK 语言代码
+ * @returns BRTC 语言代码
+ */
+export declare const mapLangToBRTC: (sdkLang?: string) => string;
+/**
+ * 将 SDK 统一语言代码映射为数字人 ttsLang
+ *
+ * @param sdkLang SDK 语言代码
+ * @returns 数字人 ttsLang 值
+ */
+export declare const mapLangToDigitalHuman: (sdkLang?: string) => string;
+/**
+ * 检查语言代码是否被 BRTC 支持
+ */
+export declare const isBRTCLangSupported: (sdkLang: string) => boolean;
+/**
+ * 检查语言代码是否被数字人支持
+ */
+export declare const isDigitalHumanLangSupported: (sdkLang: string) => boolean;

package/dist/libs/aaas-pilot-kit/src/types/config.d.ts

@@ -8,9 +8,12 @@ import Emittery from 'emittery';
 import { AnyConversation, type IConversationBeanSnapshot } from '../lib/service/conversation';
 import type { IErrorEventPayload } from '../lib/error';
 import { NAbstractDigitalHumanService } from '../lib/service/digital-human/BaseDigitalHumanService';
-import { IAsrMessageEventPayload, IBusyEventPayload, IInterruptEventPayload } from '../lib/controller';
+import { IAsrMessageEventPayload, IBusyEventPayload, IInterruptEventPayload, IReplyStartEventPayload } from '../lib/controller';
 import { NDigitalHumanService } from '../lib/service/digital-human/CloudDigitalHumanService';
+import { Language, type LanguageCode } from '../lib/utils/language-mapper';
 type TFormatter = (input: string) => string;
+export { Language };
+export type { LanguageCode };
 export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
     /**
      * 🆔【必填】数字员工形象 ID —— 从平台获取的唯一形象资源标识
@@ -39,11 +42,21 @@ export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
      */
     ttsSample?: number;
     /**
-     * 🖥️【选填】渲染模式：云端推流 or 本地2D渲染
-     * - 'cloud'（默认）→ 高保真动态形象，需网络 + RTC 支持（推荐）
-     * - 'client' → 本地静态图+口型动画 2D 渲染，低资源消耗，离线可用
+     * 🖥️【选填】渲染模式：选择数字人服务的技术实现方式
+     *
+     * - 'cloud'（默认）→ 云端推流渲染（iframe 方式）
+     *   - 适用场景：PC 端
+     *   - 特点：高保真动态形象，需网络 + RTC 支持
+     *
+     * - 'cloud-native' → 云端推流渲染（原生 SDK 集成）
+     *   - 适用场景：移动端（规避 iframe 点击限制）
+     *   - 特点：高保真动态形象，需网络 + RTC 支持
+     *
+     * - 'client' → 本地 2D 渲染（静态图 + 口型动画）
+     *   - 适用场景：离线场景或低资源消耗需求
+     *   - 特点：低资源消耗，离线可用
      */
-    rendererMode?: 'cloud' | 'client';
+    rendererMode?: 'cloud' | 'cloud-native' | 'client';
     /**
      * 🖼️【选填】仅 rendererMode='client' 时生效 —— 配置本地渲染参数
      * 包含形象资源路径、口型映射、TTS 驱动参数等
@@ -179,25 +192,46 @@ export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
     /**
      * ⚡【选填】TTS 模型版本
      * - undefined → 标准版（稳定，低延迟）
-     * - '02-turbo' → 加速版（响应更快，适合实时对话）
+     * - 'turbo_v2' → 加速版（响应更快，适合实时对话）
+     * - 'quality_v2' → 质量版（质量优先，声音的音频质量更高，时间延迟会有提升）
      */
-    ttsModel?: '02-turbo' | undefined;
+    ttsModel?: 'turbo_v2' | undefined;
     /**
      * ASR 语音端点检测（VAD）的静音超时时长（单位：毫秒）
-     * —— 用于判断用户“说完一句话”的停顿阈值。
+     * —— 用于判断用户"说完一句话"的停顿阈值。
      *
      * 🎯 通俗理解：你停顿多久，系统就认为你说完了，开始识别。
-     *    - 值越大 → 越“耐心”，适合语速慢/爱思考的用户；
-     *    - 值越小 → 越“灵敏”，适合语速快/想快速响应的场景。
+     *    - 值越大 → 越"耐心"，适合语速慢/爱思考的用户；
+     *    - 值越小 → 越"灵敏"，适合语速快/想快速响应的场景。
      *
      * ✅ 推荐值：
      *    - 默认 600ms（适合大多数对话场景）
      *    - 快速问答可设 300~400ms
      *    - 慢速/英文教学场景可设 800~1000ms
      *
-     * ⚠️ 注意：过小可能导致话没说完就被打断，过大会让用户觉得“反应迟钝”。
+     * ⚠️ 注意：过小可能导致话没说完就被打断，过大会让用户觉得"反应迟钝"。
      */
     asrVad?: number;
+    /**
+     * 🎙️【选填】ASR 启动前检查音频设备可用性
+     * —— 执行 4 层渐进式检测（API 支持、HTTPS、设备枚举、权限、流获取）
+     *
+     * ✅ 开启后（默认 false）：
+     *   - 在 ASR 启动前自动调用 checkAudioDevice()
+     *   - 如果检测失败，直接阻止 ASR 启动并上报详细错误
+     *   - 用户可通过监听 device_check_completed 事件获取诊断结果
+     *
+     * ⚠️ 性能影响：
+     *   - 首次检测增加 ~100-500ms（主要是 getUserMedia）
+     *   - 5 秒内缓存结果，重复调用 <1ms
+     *
+     * 💡 推荐场景：
+     *   - 对用户体验要求高的场景（提前发现问题）
+     *   - 需要精准错误提示的场景（区分「无设备」「权限拒绝」「设备占用」）
+     *
+     * @default true
+     */
+    checkAudioDeviceBeforeStart?: boolean;
     /**
      * 🌐【选填】运行环境
      * - 'development' → 开发调试（日志全开）
@@ -243,6 +277,42 @@ export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
      * ❌ 设为 false → 保留原始背景（适合已有透明通道的素材）
      */
     autoChromaKey?: boolean;
+    /**
+     * 🌐【选填】语言配置
+     *
+     * 用于配置 ASR 语音识别和 TTS 语音合成的语言
+     *
+     * **支持的语言:**
+     * - `Language.CHINESE` / `'zh'` - 中文(普通话)
+     * - `Language.ENGLISH` / `'en'` - 英语
+     * - `Language.JAPANESE` / `'ja'` - 日语
+     * - `Language.SPANISH` / `'es'` - 西班牙语
+     * - `Language.RUSSIAN` / `'ru'` - 俄语
+     * - `Language.KOREAN` / `'ko'` - 韩语
+     * - `Language.VIETNAMESE` / `'vi'` - 越南语
+     * - `Language.GERMAN` / `'de'` - 德语
+     * - `Language.INDONESIAN` / `'id'` - 印尼语
+     * - `Language.THAI` / `'th'` - 泰语
+     *
+     * **注意:**
+     * - 影响 ASR 语音识别的语言模型
+     * - 影响 TTS 语音合成的发音效果
+     * - 不支持的语言代码会自动回退到中文
+     *
+     * @default 'zh'
+     *
+     * @example
+     * ```ts
+     * import {Language} from '@bdky/aaas-pilot-kit';
+     *
+     * // 使用常量
+     * {lang: Language.ENGLISH}
+     *
+     * // 使用字符串
+     * {lang: 'en'}
+     * ```
+     */
+    lang?: LanguageCode;
     /**
      * 🔌【隐藏参数】RTC 应用 ID（内部使用）
      * ✅ 默认：'apprjff5d4wek7t'
@@ -253,7 +323,7 @@ export interface IOptions<AS extends BaseAgentService = BaseAgentService> {
 export declare const DEFAULT_OPTIONS: {
     readonly enableDebugMode: false;
     readonly minSplitLen: 5;
-    readonly ttsModel: "02-turbo";
+    readonly ttsModel: "turbo_v2";
     readonly env: "production";
     readonly asrVad: 600;
     readonly interruptible: true;
@@ -261,14 +331,16 @@ export declare const DEFAULT_OPTIONS: {
     readonly autoChromaKey: true;
     readonly typeDelay: 163;
     readonly enTypeDelay: 45;
+    readonly lang: "zh";
     readonly inactivityPrompt: "您这么久没讲话，是不是有其它事情要忙，那我先挂断了";
     readonly getMountContainer: () => HTMLElement;
     readonly hotWordReplacementRules: ReplacementRule[];
+    readonly checkAudioDeviceBeforeStart: true;
     readonly rtcID: "appreimunmd7utp";
 };
 type DefaultedOptionKeys = keyof typeof DEFAULT_OPTIONS;
 export type IResolvedOptions<AS extends BaseAgentService = BaseAgentService> = IOptions<AS> & Required<Pick<IOptions<AS>, DefaultedOptionKeys>>;
-export interface IAaaSPilotKitEmitter {
+export interface IAaaSPilotKitEmitter<AS extends BaseAgentService = BaseAgentService> {
     /**
      * 🔇【状态事件】静音状态变更
      * —— 当调用 .mute(true/false) 时触发
@@ -377,6 +449,10 @@ export interface IAaaSPilotKitEmitter {
      * @payload { text: string; sessionId: string; timestamp: number }
      */
     render_start: NAbstractDigitalHumanService.IEmitter['render_subtitle'] & NBaseAgentService.IEventWithSessionIdPayload;
+    /**
+     * TODO: 命名和注释待完善
+     */
+    reply_start: IReplyStartEventPayload<AS>;
     /**
      * ⏸️【低频】用户长时间无交互（触发 opts.inactivityPrompt）
      * —— 在配置的不活跃时间后触发，数字人将播报提醒语
@@ -407,10 +483,10 @@ export interface IAaaSPilotKitEmitter {
      */
     interrupt: IInterruptEventPayload;
     /**
-     * 🖼️【状态同步】数字员工渲染/播报状态变更 —— 实时反映是否“正在说话中”
+     * 🖼️【状态同步】数字员工渲染/播报状态变更 —— 实时反映是否"正在说话中"
      *
      * 💡 核心用途：
-     *   - 控制 UI：显示“正在播报…”加载态、禁用发送按钮
+     *   - 控制 UI：显示"正在播报…"加载态、禁用发送按钮
      *   - 体验优化：避免用户在播报中途误操作导致体验割裂
      *   - ...
      *
@@ -419,12 +495,62 @@ export interface IAaaSPilotKitEmitter {
      *   - false → **播报完成，空闲可交互**（此时可安全输入或执行后续动作）
      *
      * ⚠️ 注意：
-     *   - 此状态仅反映“数字员工是否在播报”，不反映 ASR 或 Agent 是否在工作
+     *   - 此状态仅反映"数字员工是否在播报"，不反映 ASR 或 Agent 是否在工作
      */
     is_rendering_change: boolean;
+    /**
+     * 🎙️【设备检测】麦克风设备可用性检测结果
+     * —— 执行音频设备检测后触发，提供用户友好的错误提示
+     *
+     * 💡 触发时机：
+     *   - 调用 controller.checkAudioDevice() 时
+     *   - ASR 启动前（如果配置了 checkAudioDeviceBeforeStart: true）
+     *
+     * 🎯 使用场景：
+     *   - 实时显示设备状态提示："麦克风不可用，请检查设备"
+     *   - 根据不同错误类型展示针对性解决方案
+     *   - 采集设备统计数据（设备数量、权限状态等）
+     *
+     * @payload {
+     *   available: boolean;           // 设备是否可用
+     *   error?: AudioDeviceError;      // 错误类型（仅当 available=false 时）
+     *   userMessage?: string;          // 用户友好的错误提示文案
+     *   devices?: MediaDeviceInfo[];   // 检测到的音频设备列表
+     *   permissionState?: PermissionState; // 权限状态（'granted'|'denied'|'prompt'）
+     * }
+     *
+     * ⚠️ 注意：
+     *   - userMessage 是经过优化的用户提示，可直接用于 UI 展示
+     *   - 如果 available=true，error 和 userMessage 为 undefined
+     *   - permissionState 可能为 undefined（Safari 不支持 Permissions API）
+     *
+     * @example 监听设备检测结果
+     * ```typescript
+     * controller.emitter.on('microphone_available', (result) => {
+     *   if (!result.available) {
+     *     // 显示用户友好的错误提示
+     *     showToast(result.userMessage);
+     *
+     *     // 或根据错误类型做特殊处理
+     *     if (result.error === 'PERMISSION_DENIED') {
+     *       showPermissionGuide(); // 引导用户开启权限
+     *     }
+     *   } else {
+     *     console.log('设备可用，找到', result.devices?.length, '个音频设备');
+     *   }
+     * });
+     * ```
+     */
+    microphone_available: {
+        available: boolean;
+        error?: import('../lib/utils/AudioDeviceDetector').AudioDeviceError;
+        userMessage?: string;
+        devices?: MediaDeviceInfo[];
+        permissionState?: PermissionState;
+    };
 }
-export interface IAaaSPilotKitController {
-    emitter: Emittery<IAaaSPilotKitEmitter>;
+export interface IAaaSPilotKitController<AS extends BaseAgentService = BaseAgentService> {
+    emitter: Emittery<IAaaSPilotKitEmitter<AS>>;
     /**
      * 🧩 挂载数字员工到指定 DOM 容器
      *
@@ -535,7 +661,7 @@ export interface IAaaSPilotKitController {
      */
     input(text: string): IAaaSPilotKitController;
     /**
-     * 🔄 动态切换“是否允许打断”
+     * 🔄 动态切换"是否允许打断"
      * —— 可在对话中随时调整，立即生效
      *
      * @param interruptible - 是否允许打断
@@ -543,7 +669,36 @@ export interface IAaaSPilotKitController {
      */
     setInterruptible(interruptible: boolean): IAaaSPilotKitController;
     /**
-     * 🚦 检测是否需要“手动激活”（如浏览器策略阻止自动播放）
+     * 🎙️ 检查音频设备可用性
+     *
+     * 执行 4 层渐进式检测：
+     *   - Level 1: API 支持检查 (MediaDevices API)
+     *   - Level 2: 设备枚举 (enumerateDevices)
+     *   - Level 3: 权限状态查询 (Permissions API, Safari 可能不支持)
+     *   - Level 4: 实际流获取 (getUserMedia + 轨道状态检查)
+     *
+     * 🚀 性能优化：5 秒内缓存结果，避免重复检测
+     *
+     * @param options - 检测配置选项
+     * @returns 检测结果
+     *
+     * @example
+     * ```typescript
+     * const result = await controller.checkAudioDevice();
+     * if (!result.available) {
+     *     // 根据 result.error 显示不同的用户提示
+     *     import { getErrorMessage } from '@bdky/aaas-pilot-kit';
+     *     alert(getErrorMessage(result.error));
+     * }
+     * ```
+     */
+    checkAudioDevice(options?: {
+        timeout?: number;
+        autoCleanup?: boolean;
+        forceCheck?: boolean;
+    }): Promise<import('../lib/utils/AudioDeviceDetector').AudioDeviceCheckResult>;
+    /**
+     * 🚦 检测是否需要"手动激活"（如浏览器策略阻止自动播放）
      *
      * 🔹 返回 true 时，必须调用 activateManually() 用户交互后才能播放音频
      * —— 常见于移动端/静音浏览器首次播放
@@ -575,4 +730,3 @@ export interface IAaaSPilotKitController {
      */
     keepAlive(): IAaaSPilotKitController;
 }
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bdky/aaas-pilot-kit",
-    "version": "1.0.4",
+    "version": "1.0.5",
     "license": "MIT",
     "contributors": [
         {
@@ -33,21 +33,24 @@
     },
     "scripts": {
         "build": "npx rslib build",
+        "watch": "npx rslib build --watch",
         "dev": "npx rsbuild dev --open",
         "analyze": "RSDOCTOR=true npx rslib build"
     },
     "dependencies": {
         "@bddh/starling-dh-picture-client": "^1.0.52",
         "@bddh/starling-dhiframe": "^2.1.9",
+        "@bddh/starling-realtime-client": "^2.0.8",
         "@types/ua-parser-js": "^0.7.39",
         "abort-signal-polyfill": "^1.0.0",
+        "baidurtc": "^1.2.21",
         "core-js": "^3.44.0",
         "emittery": "^1.2.0",
         "fast-xml-parser": "^5.2.5",
-        "inversify": "^7.5.2",
-        "ky": "^1.8.1",
+        "inversify": "^7.10.4",
+        "ky": "^1.14.0",
         "p-defer": "^4.0.1",
-        "p-queue": "^8.1.0",
+        "p-queue": "^9.0.0",
         "reflect-metadata": "^0.2.2",
         "type-fest": "^4.41.0",
         "typewriter-effect": "^2.22.0",