blacktrigram 0.7.2

package/lib/utils/hapticFeedback.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Haptic feedback utilities for mobile touch interactions
+ *
+ * Provides vibration feedback for button presses and combat actions
+ * with support for different intensity levels on iOS and Android.
+ *
+ * This module provides an enhanced haptic feedback API with typed intensity levels
+ * and pattern support. For legacy compatibility with basic vibration patterns,
+ * see src/utils/haptics.ts
+ *
+ * @module utils/hapticFeedback
+ * @category Mobile Utilities
+ * @korean 햅틱피드백유틸리티
+ */
+/**
+ * Haptic feedback intensity levels
+ *
+ * @category Haptic Feedback
+ * @korean 햅틱강도
+ */
+export type HapticIntensity = "light" | "medium" | "heavy";
+/**
+ * Check if haptic feedback is supported
+ *
+ * @returns Whether haptic feedback is available
+ *
+ * @example
+ * ```typescript
+ * if (isHapticSupported()) {
+ *   triggerHapticFeedback('medium');
+ * }
+ * ```
+ *
+ * @public
+ * @korean 햅틱지원여부
+ */
+export declare function isHapticSupported(): boolean;
+/**
+ * Trigger haptic feedback with specified intensity
+ *
+ * @param intensity - Feedback intensity level
+ * @returns Whether feedback was triggered successfully
+ *
+ * @example
+ * ```typescript
+ * // Light feedback for menu navigation
+ * triggerHapticFeedback('light');
+ *
+ * // Medium feedback for button press
+ * triggerHapticFeedback('medium');
+ *
+ * // Heavy feedback for critical hit
+ * triggerHapticFeedback('heavy');
+ * ```
+ *
+ * @public
+ * @korean 햅틱피드백트리거
+ */
+export declare function triggerHapticFeedback(intensity: HapticIntensity): boolean;
+/**
+ * Trigger custom haptic pattern
+ * Useful for complex feedback sequences
+ *
+ * @param pattern - Array of vibration durations and pauses (ms)
+ * @returns Whether pattern was triggered successfully
+ *
+ * @example
+ * ```typescript
+ * // Double tap feedback: vibrate 50ms, pause 50ms, vibrate 50ms
+ * triggerHapticPattern([50, 50, 50]);
+ * ```
+ *
+ * @public
+ * @korean 햅틱패턴트리거
+ */
+export declare function triggerHapticPattern(pattern: readonly number[]): boolean;
+/**
+ * Haptic feedback for UI interactions
+ * Pre-configured patterns for common UI elements
+ *
+ * @category Haptic Feedback
+ * @korean UI햅틱피드백
+ */
+export declare const UIHaptics: {
+    /**
+     * Button tap feedback
+     * @korean 버튼탭피드백
+     */
+    readonly buttonTap: () => boolean;
+    /**
+     * Menu hover/navigation feedback
+     * @korean 메뉴호버피드백
+     */
+    readonly menuHover: () => boolean;
+    /**
+     * Stance change feedback
+     * @korean 자세변경피드백
+     */
+    readonly stanceChange: () => boolean;
+    /**
+     * Attack execution feedback
+     * @korean 공격실행피드백
+     */
+    readonly attackExecution: () => boolean;
+    /**
+     * Critical hit feedback
+     * @korean 치명타피드백
+     */
+    readonly criticalHit: () => boolean;
+    /**
+     * Vital point strike feedback
+     * @korean 급소타격피드백
+     */
+    readonly vitalPointStrike: () => boolean;
+    /**
+     * Block/defend feedback
+     * @korean 방어피드백
+     */
+    readonly blockDefend: () => boolean;
+    /**
+     * Error/invalid action feedback
+     * @korean 오류피드백
+     */
+    readonly error: () => boolean;
+    /**
+     * Success/achievement feedback
+     * @korean 성공피드백
+     */
+    readonly success: () => boolean;
+};
+/**
+ * Combat haptic feedback manager
+ * Provides context-aware haptic feedback for combat actions
+ *
+ * @category Haptic Feedback
+ * @korean 전투햅틱피드백
+ */
+export declare const CombatHaptics: {
+    /**
+     * Normal hit feedback
+     * @korean 일반타격피드백
+     */
+    readonly normalHit: () => boolean;
+    /**
+     * Critical hit feedback with double pulse
+     * @korean 치명타피드백
+     */
+    readonly criticalHit: () => boolean;
+    /**
+     * Perfect strike feedback (triple pulse)
+     * @korean 완벽타격피드백
+     */
+    readonly perfectStrike: () => boolean;
+    /**
+     * Vital point strike feedback (intense pattern)
+     * @korean 급소타격피드백
+     */
+    readonly vitalPointHit: () => boolean;
+    /**
+     * Blocked attack feedback (sharp double pulse)
+     * @korean 방어성공피드백
+     */
+    readonly attackBlocked: () => boolean;
+    /**
+     * Miss feedback (quick light pulse)
+     * @korean 빗나감피드백
+     */
+    readonly attackMissed: () => boolean;
+    /**
+     * Counter-attack feedback (building intensity)
+     * @korean 반격피드백
+     */
+    readonly counterAttack: () => boolean;
+    /**
+     * Combo hit feedback (rhythmic pattern)
+     * @korean 콤보타격피드백
+     */
+    readonly comboHit: (comboCount: number) => boolean;
+    /**
+     * Heavy damage taken feedback (long intense pulse)
+     * @korean 큰피해피드백
+     */
+    readonly heavyDamage: () => boolean;
+    /**
+     * Knockout feedback (dramatic pattern)
+     * @korean 녹다운피드백
+     */
+    readonly knockout: () => boolean;
+};
+/**
+ * Training mode haptic feedback
+ * Provides feedback for training exercises
+ *
+ * @category Haptic Feedback
+ * @korean 훈련햅틱피드백
+ */
+export declare const TrainingHaptics: {
+    /**
+     * Correct technique feedback
+     * @korean 정확한기술피드백
+     */
+    readonly correctTechnique: () => boolean;
+    /**
+     * Incorrect technique feedback
+     * @korean 부정확한기술피드백
+     */
+    readonly incorrectTechnique: () => boolean;
+    /**
+     * Target hit feedback
+     * @korean 표적명중피드백
+     */
+    readonly targetHit: () => boolean;
+    /**
+     * Perfect timing feedback
+     * @korean 완벽한타이밍피드백
+     */
+    readonly perfectTiming: () => boolean;
+    /**
+     * New skill unlocked feedback
+     * @korean 새기술해금피드백
+     */
+    readonly skillUnlocked: () => boolean;
+};
+//# sourceMappingURL=hapticFeedback.d.ts.map

package/lib/utils/hapticFeedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hapticFeedback.d.ts","sourceRoot":"","sources":["../../src/utils/hapticFeedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAkC3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAQ3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAyBzE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAoBxE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;IACxB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;oCACoB,MAAM;IAQ7B;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;IAC1B;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC"}

package/lib/utils/hapticFeedback.js

@@ -0,0 +1,143 @@
+//#region src/utils/hapticFeedback.ts
+/**
+* Haptic patterns for different intensities
+* 
+* @category Haptic Feedback
+* @korean 햅틱패턴
+*/
+var HAPTIC_PATTERNS = {
+	light: {
+		duration: 10,
+		pattern: [10]
+	},
+	medium: {
+		duration: 50,
+		pattern: [50]
+	},
+	heavy: {
+		duration: 100,
+		pattern: [100]
+	}
+};
+/**
+* Check if haptic feedback is supported
+* 
+* @returns Whether haptic feedback is available
+* 
+* @example
+* ```typescript
+* if (isHapticSupported()) {
+*   triggerHapticFeedback('medium');
+* }
+* ```
+* 
+* @public
+* @korean 햅틱지원여부
+*/
+function isHapticSupported() {
+	if (typeof navigator === "undefined") return false;
+	const nav = navigator;
+	return "vibrate" in navigator || !!nav.webkitVibrate;
+}
+/**
+* Trigger haptic feedback with specified intensity
+* 
+* @param intensity - Feedback intensity level
+* @returns Whether feedback was triggered successfully
+* 
+* @example
+* ```typescript
+* // Light feedback for menu navigation
+* triggerHapticFeedback('light');
+* 
+* // Medium feedback for button press
+* triggerHapticFeedback('medium');
+* 
+* // Heavy feedback for critical hit
+* triggerHapticFeedback('heavy');
+* ```
+* 
+* @public
+* @korean 햅틱피드백트리거
+*/
+function triggerHapticFeedback(intensity) {
+	if (!isHapticSupported()) return false;
+	const pattern = HAPTIC_PATTERNS[intensity];
+	try {
+		if ("vibrate" in navigator) return navigator.vibrate(pattern.duration);
+		const nav = navigator;
+		if (nav.webkitVibrate) return nav.webkitVibrate(pattern.duration);
+	} catch (error) {
+		if (process.env.NODE_ENV !== "production") console.warn("Haptic feedback failed:", error);
+	}
+	return false;
+}
+/**
+* Trigger custom haptic pattern
+* Useful for complex feedback sequences
+* 
+* @param pattern - Array of vibration durations and pauses (ms)
+* @returns Whether pattern was triggered successfully
+* 
+* @example
+* ```typescript
+* // Double tap feedback: vibrate 50ms, pause 50ms, vibrate 50ms
+* triggerHapticPattern([50, 50, 50]);
+* ```
+* 
+* @public
+* @korean 햅틱패턴트리거
+*/
+function triggerHapticPattern(pattern) {
+	if (!isHapticSupported()) return false;
+	try {
+		if ("vibrate" in navigator) return navigator.vibrate(pattern);
+		const nav = navigator;
+		if (nav.webkitVibrate) return nav.webkitVibrate(pattern);
+	} catch (error) {
+		console.warn("Haptic pattern failed:", error);
+	}
+	return false;
+}
+/**
+* Haptic feedback for UI interactions
+* Pre-configured patterns for common UI elements
+* 
+* @category Haptic Feedback
+* @korean UI햅틱피드백
+*/
+var UIHaptics = {
+	buttonTap: () => triggerHapticFeedback("medium"),
+	menuHover: () => triggerHapticFeedback("light"),
+	stanceChange: () => triggerHapticFeedback("light"),
+	attackExecution: () => triggerHapticFeedback("medium"),
+	criticalHit: () => triggerHapticPattern([
+		50,
+		30,
+		100
+	]),
+	vitalPointStrike: () => triggerHapticPattern([
+		100,
+		50,
+		100,
+		50,
+		100
+	]),
+	blockDefend: () => triggerHapticFeedback("medium"),
+	error: () => triggerHapticPattern([
+		50,
+		50,
+		50
+	]),
+	success: () => triggerHapticPattern([
+		30,
+		30,
+		30,
+		30,
+		100
+	])
+};
+//#endregion
+export { UIHaptics };
+
+//# sourceMappingURL=hapticFeedback.js.map

package/lib/utils/hapticFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hapticFeedback.js","names":[],"sources":["../../src/utils/hapticFeedback.ts"],"sourcesContent":["/**\n * Haptic feedback utilities for mobile touch interactions\n * \n * Provides vibration feedback for button presses and combat actions\n * with support for different intensity levels on iOS and Android.\n * \n * This module provides an enhanced haptic feedback API with typed intensity levels\n * and pattern support. For legacy compatibility with basic vibration patterns,\n * see src/utils/haptics.ts\n * \n * @module utils/hapticFeedback\n * @category Mobile Utilities\n * @korean 햅틱피드백유틸리티\n */\n\n/**\n * Haptic feedback intensity levels\n * \n * @category Haptic Feedback\n * @korean 햅틱강도\n */\nexport type HapticIntensity = \"light\" | \"medium\" | \"heavy\";\n\n/**\n * Haptic feedback pattern configuration\n * \n * @category Haptic Feedback\n * @korean 햅틱패턴설정\n */\ninterface HapticPattern {\n  readonly duration: number; // Duration in milliseconds\n  readonly pattern?: readonly number[]; // For Android pattern vibration\n}\n\n/**\n * Haptic patterns for different intensities\n * \n * @category Haptic Feedback\n * @korean 햅틱패턴\n */\nconst HAPTIC_PATTERNS: Record<HapticIntensity, HapticPattern> = {\n  light: {\n    duration: 10,\n    pattern: [10],\n  },\n  medium: {\n    duration: 50,\n    pattern: [50],\n  },\n  heavy: {\n    duration: 100,\n    pattern: [100],\n  },\n};\n\n/**\n * Check if haptic feedback is supported\n * \n * @returns Whether haptic feedback is available\n * \n * @example\n * ```typescript\n * if (isHapticSupported()) {\n *   triggerHapticFeedback('medium');\n * }\n * ```\n * \n * @public\n * @korean 햅틱지원여부\n */\nexport function isHapticSupported(): boolean {\n  if (typeof navigator === \"undefined\") {\n    return false;\n  }\n  \n  // Check for modern vibrate API or webkit prefixed version\n  const nav = navigator as Navigator & { webkitVibrate?: (pattern: number | number[]) => boolean };\n  return \"vibrate\" in navigator || !!nav.webkitVibrate;\n}\n\n/**\n * Trigger haptic feedback with specified intensity\n * \n * @param intensity - Feedback intensity level\n * @returns Whether feedback was triggered successfully\n * \n * @example\n * ```typescript\n * // Light feedback for menu navigation\n * triggerHapticFeedback('light');\n * \n * // Medium feedback for button press\n * triggerHapticFeedback('medium');\n * \n * // Heavy feedback for critical hit\n * triggerHapticFeedback('heavy');\n * ```\n * \n * @public\n * @korean 햅틱피드백트리거\n */\nexport function triggerHapticFeedback(intensity: HapticIntensity): boolean {\n  if (!isHapticSupported()) {\n    return false;\n  }\n\n  const pattern = HAPTIC_PATTERNS[intensity];\n\n  try {\n    // Try modern Vibration API\n    if (\"vibrate\" in navigator) {\n      return navigator.vibrate(pattern.duration);\n    }\n\n    // Try webkit prefixed version for older devices\n    const nav = navigator as Navigator & { webkitVibrate?: (pattern: number | number[]) => boolean };\n    if (nav.webkitVibrate) {\n      return nav.webkitVibrate(pattern.duration);\n    }\n  } catch (error) {\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\"Haptic feedback failed:\", error);\n    }\n  }\n\n  return false;\n}\n\n/**\n * Trigger custom haptic pattern\n * Useful for complex feedback sequences\n * \n * @param pattern - Array of vibration durations and pauses (ms)\n * @returns Whether pattern was triggered successfully\n * \n * @example\n * ```typescript\n * // Double tap feedback: vibrate 50ms, pause 50ms, vibrate 50ms\n * triggerHapticPattern([50, 50, 50]);\n * ```\n * \n * @public\n * @korean 햅틱패턴트리거\n */\nexport function triggerHapticPattern(pattern: readonly number[]): boolean {\n  if (!isHapticSupported()) {\n    return false;\n  }\n\n  try {\n    if (\"vibrate\" in navigator) {\n      return navigator.vibrate(pattern as number[]);\n    }\n\n    // Try webkit prefixed version for older devices\n    const nav = navigator as Navigator & { webkitVibrate?: (pattern: number | number[]) => boolean };\n    if (nav.webkitVibrate) {\n      return nav.webkitVibrate(pattern as number[]);\n    }\n  } catch (error) {\n    console.warn(\"Haptic pattern failed:\", error);\n  }\n\n  return false;\n}\n\n/**\n * Haptic feedback for UI interactions\n * Pre-configured patterns for common UI elements\n * \n * @category Haptic Feedback\n * @korean UI햅틱피드백\n */\nexport const UIHaptics = {\n  /**\n   * Button tap feedback\n   * @korean 버튼탭피드백\n   */\n  buttonTap: () => triggerHapticFeedback(\"medium\"),\n\n  /**\n   * Menu hover/navigation feedback\n   * @korean 메뉴호버피드백\n   */\n  menuHover: () => triggerHapticFeedback(\"light\"),\n\n  /**\n   * Stance change feedback\n   * @korean 자세변경피드백\n   */\n  stanceChange: () => triggerHapticFeedback(\"light\"),\n\n  /**\n   * Attack execution feedback\n   * @korean 공격실행피드백\n   */\n  attackExecution: () => triggerHapticFeedback(\"medium\"),\n\n  /**\n   * Critical hit feedback\n   * @korean 치명타피드백\n   */\n  criticalHit: () => triggerHapticPattern([50, 30, 100]),\n\n  /**\n   * Vital point strike feedback\n   * @korean 급소타격피드백\n   */\n  vitalPointStrike: () => triggerHapticPattern([100, 50, 100, 50, 100]),\n\n  /**\n   * Block/defend feedback\n   * @korean 방어피드백\n   */\n  blockDefend: () => triggerHapticFeedback(\"medium\"),\n\n  /**\n   * Error/invalid action feedback\n   * @korean 오류피드백\n   */\n  error: () => triggerHapticPattern([50, 50, 50]),\n\n  /**\n   * Success/achievement feedback\n   * @korean 성공피드백\n   */\n  success: () => triggerHapticPattern([30, 30, 30, 30, 100]),\n} as const;\n\n/**\n * Combat haptic feedback manager\n * Provides context-aware haptic feedback for combat actions\n * \n * @category Haptic Feedback\n * @korean 전투햅틱피드백\n */\nexport const CombatHaptics = {\n  /**\n   * Normal hit feedback\n   * @korean 일반타격피드백\n   */\n  normalHit: () => triggerHapticFeedback(\"medium\"),\n\n  /**\n   * Critical hit feedback with double pulse\n   * @korean 치명타피드백\n   */\n  criticalHit: () => triggerHapticPattern([50, 30, 100]),\n\n  /**\n   * Perfect strike feedback (triple pulse)\n   * @korean 완벽타격피드백\n   */\n  perfectStrike: () => triggerHapticPattern([30, 30, 30, 30, 100]),\n\n  /**\n   * Vital point strike feedback (intense pattern)\n   * @korean 급소타격피드백\n   */\n  vitalPointHit: () => triggerHapticPattern([100, 50, 100, 50, 100]),\n\n  /**\n   * Blocked attack feedback (sharp double pulse)\n   * @korean 방어성공피드백\n   */\n  attackBlocked: () => triggerHapticPattern([30, 30, 30]),\n\n  /**\n   * Miss feedback (quick light pulse)\n   * @korean 빗나감피드백\n   */\n  attackMissed: () => triggerHapticFeedback(\"light\"),\n\n  /**\n   * Counter-attack feedback (building intensity)\n   * @korean 반격피드백\n   */\n  counterAttack: () => triggerHapticPattern([30, 20, 50, 20, 100]),\n\n  /**\n   * Combo hit feedback (rhythmic pattern)\n   * @korean 콤보타격피드백\n   */\n  comboHit: (comboCount: number) => {\n    const pattern = Array(Math.min(comboCount, 5))\n      .fill(null)\n      .flatMap(() => [30, 20]);\n    pattern.push(50); // Final pulse\n    return triggerHapticPattern(pattern);\n  },\n\n  /**\n   * Heavy damage taken feedback (long intense pulse)\n   * @korean 큰피해피드백\n   */\n  heavyDamage: () => triggerHapticPattern([150, 50, 150]),\n\n  /**\n   * Knockout feedback (dramatic pattern)\n   * @korean 녹다운피드백\n   */\n  knockout: () => triggerHapticPattern([100, 50, 100, 50, 200]),\n} as const;\n\n/**\n * Training mode haptic feedback\n * Provides feedback for training exercises\n * \n * @category Haptic Feedback\n * @korean 훈련햅틱피드백\n */\nexport const TrainingHaptics = {\n  /**\n   * Correct technique feedback\n   * @korean 정확한기술피드백\n   */\n  correctTechnique: () => triggerHapticPattern([30, 30, 100]),\n\n  /**\n   * Incorrect technique feedback\n   * @korean 부정확한기술피드백\n   */\n  incorrectTechnique: () => triggerHapticPattern([50, 50, 50]),\n\n  /**\n   * Target hit feedback\n   * @korean 표적명중피드백\n   */\n  targetHit: () => triggerHapticFeedback(\"medium\"),\n\n  /**\n   * Perfect timing feedback\n   * @korean 완벽한타이밍피드백\n   */\n  perfectTiming: () => triggerHapticPattern([20, 20, 20, 20, 80]),\n\n  /**\n   * New skill unlocked feedback\n   * @korean 새기술해금피드백\n   */\n  skillUnlocked: () => triggerHapticPattern([50, 30, 50, 30, 50, 30, 150]),\n} as const;\n"],"mappings":";;;;;;;AAwCA,IAAM,kBAA0D;CAC9D,OAAO;EACL,UAAU;EACV,SAAS,CAAC,GAAG;EACd;CACD,QAAQ;EACN,UAAU;EACV,SAAS,CAAC,GAAG;EACd;CACD,OAAO;EACL,UAAU;EACV,SAAS,CAAC,IAAI;EACf;CACF;;;;;;;;;;;;;;;;AAiBD,SAAgB,oBAA6B;AAC3C,KAAI,OAAO,cAAc,YACvB,QAAO;CAIT,MAAM,MAAM;AACZ,QAAO,aAAa,aAAa,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;AAwBzC,SAAgB,sBAAsB,WAAqC;AACzE,KAAI,CAAC,mBAAmB,CACtB,QAAO;CAGT,MAAM,UAAU,gBAAgB;AAEhC,KAAI;AAEF,MAAI,aAAa,UACf,QAAO,UAAU,QAAQ,QAAQ,SAAS;EAI5C,MAAM,MAAM;AACZ,MAAI,IAAI,cACN,QAAO,IAAI,cAAc,QAAQ,SAAS;UAErC,OAAO;AACd,MAAA,QAAA,IAAA,aAA6B,aAC3B,SAAQ,KAAK,2BAA2B,MAAM;;AAIlD,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,qBAAqB,SAAqC;AACxE,KAAI,CAAC,mBAAmB,CACtB,QAAO;AAGT,KAAI;AACF,MAAI,aAAa,UACf,QAAO,UAAU,QAAQ,QAAoB;EAI/C,MAAM,MAAM;AACZ,MAAI,IAAI,cACN,QAAO,IAAI,cAAc,QAAoB;UAExC,OAAO;AACd,UAAQ,KAAK,0BAA0B,MAAM;;AAG/C,QAAO;;;;;;;;;AAUT,IAAa,YAAY;CAKvB,iBAAiB,sBAAsB,SAAS;CAMhD,iBAAiB,sBAAsB,QAAQ;CAM/C,oBAAoB,sBAAsB,QAAQ;CAMlD,uBAAuB,sBAAsB,SAAS;CAMtD,mBAAmB,qBAAqB;EAAC;EAAI;EAAI;EAAI,CAAC;CAMtD,wBAAwB,qBAAqB;EAAC;EAAK;EAAI;EAAK;EAAI;EAAI,CAAC;CAMrE,mBAAmB,sBAAsB,SAAS;CAMlD,aAAa,qBAAqB;EAAC;EAAI;EAAI;EAAG,CAAC;CAM/C,eAAe,qBAAqB;EAAC;EAAI;EAAI;EAAI;EAAI;EAAI,CAAC;CAC3D"}

package/lib/utils/haptics.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Haptic Feedback Utility
+ *
+ * Provides tactile feedback for mobile touch interactions
+ * Uses Vibration API for physical response on button presses and combat hits
+ *
+ * @module utils/haptics
+ * @category Mobile Controls
+ * @korean 햅틱 피드백 유틸리티
+ */
+/**
+ * Haptic intensity levels for different interactions
+ */
+export type HapticIntensity = 'light' | 'medium' | 'heavy';
+/**
+ * Check if haptic feedback is supported by the device
+ *
+ * @returns True if Vibration API is available
+ * @korean 햅틱 지원 확인
+ *
+ * @example
+ * ```typescript
+ * if (isHapticSupported()) {
+ *   triggerHaptic('medium');
+ * }
+ * ```
+ */
+export declare function isHapticSupported(): boolean;
+/**
+ * Trigger haptic feedback with specified intensity
+ *
+ * Provides tactile response for:
+ * - Light: Menu selections, button taps
+ * - Medium: Attack actions, stance changes
+ * - Heavy: Critical hits, successful vital point strikes
+ *
+ * Falls back gracefully if Vibration API is not supported
+ *
+ * @param intensity - Haptic intensity level
+ * @korean 햅틱 피드백 실행
+ *
+ * @example
+ * ```typescript
+ * // Light feedback for UI interaction
+ * triggerHaptic('light');
+ *
+ * // Medium feedback for combat action
+ * triggerHaptic('medium');
+ *
+ * // Heavy feedback for critical hit
+ * triggerHaptic('heavy');
+ * ```
+ *
+ * @public
+ */
+export declare function triggerHaptic(intensity: HapticIntensity): void;
+/**
+ * Custom haptic pattern for specific game events
+ * Allows creating complex vibration sequences
+ *
+ * @param pattern - Array of vibration durations in milliseconds
+ * @korean 커스텀 햅틱 패턴
+ *
+ * @example
+ * ```typescript
+ * // Combo hit feedback: buzz, pause, buzz
+ * triggerCustomHaptic([30, 20, 30]);
+ *
+ * // Critical vital point strike: long buzz
+ * triggerCustomHaptic([200]);
+ * ```
+ *
+ * @public
+ */
+export declare function triggerCustomHaptic(pattern: number[]): void;
+/**
+ * Stop any ongoing haptic feedback
+ * Useful for interrupting long vibrations
+ *
+ * @korean 햅틱 피드백 중지
+ *
+ * @example
+ * ```typescript
+ * // Cancel ongoing vibration
+ * stopHaptic();
+ * ```
+ *
+ * @public
+ */
+export declare function stopHaptic(): void;
+/**
+ * Combat-specific haptic feedback patterns
+ * Pre-configured patterns for common combat scenarios
+ *
+ * @korean 전투 햅틱 패턴
+ */
+export declare const CombatHaptics: {
+    /**
+     * Standard attack hit feedback
+     * @korean 일반 공격
+     */
+    readonly attack: () => void;
+    /**
+     * Block successful feedback
+     * @korean 방어 성공
+     */
+    readonly block: () => void;
+    /**
+     * Critical hit feedback with double pulse
+     * @korean 크리티컬 히트
+     */
+    readonly criticalHit: () => void;
+    /**
+     * Vital point strike feedback
+     * @korean 급소 타격
+     */
+    readonly vitalPointStrike: () => void;
+    /**
+     * Stance change feedback
+     * @korean 자세 변경
+     */
+    readonly stanceChange: () => void;
+    /**
+     * Combo counter increment
+     * @korean 콤보 카운터
+     */
+    readonly comboIncrement: () => void;
+    /**
+     * Player KO feedback with extended pattern
+     * @korean 플레이어 KO
+     */
+    readonly knockout: () => void;
+    /**
+     * Error or invalid action feedback
+     * @korean 오류 피드백
+     */
+    readonly error: () => void;
+};
+//# sourceMappingURL=haptics.d.ts.map

package/lib/utils/haptics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../../src/utils/haptics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAgB3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAO9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAMjC;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IACxB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC"}

package/lib/utils/haptics.js

@@ -0,0 +1,66 @@
+//#region src/utils/haptics.ts
+/**
+* Vibration patterns for different haptic intensities
+* - light: Quick tap (10ms) - UI interactions
+* - medium: Moderate pulse (50ms) - Combat actions
+* - heavy: Strong pulse (100ms) - Critical hits
+* 
+* @korean 햅틱 강도 패턴
+*/
+var HAPTIC_PATTERNS = {
+	light: [10],
+	medium: [50],
+	heavy: [100]
+};
+/**
+* Check if haptic feedback is supported by the device
+* 
+* @returns True if Vibration API is available
+* @korean 햅틱 지원 확인
+* 
+* @example
+* ```typescript
+* if (isHapticSupported()) {
+*   triggerHaptic('medium');
+* }
+* ```
+*/
+function isHapticSupported() {
+	return typeof navigator !== "undefined" && "vibrate" in navigator;
+}
+/**
+* Trigger haptic feedback with specified intensity
+* 
+* Provides tactile response for:
+* - Light: Menu selections, button taps
+* - Medium: Attack actions, stance changes
+* - Heavy: Critical hits, successful vital point strikes
+* 
+* Falls back gracefully if Vibration API is not supported
+* 
+* @param intensity - Haptic intensity level
+* @korean 햅틱 피드백 실행
+* 
+* @example
+* ```typescript
+* // Light feedback for UI interaction
+* triggerHaptic('light');
+* 
+* // Medium feedback for combat action
+* triggerHaptic('medium');
+* 
+* // Heavy feedback for critical hit
+* triggerHaptic('heavy');
+* ```
+* 
+* @public
+*/
+function triggerHaptic(intensity) {
+	if (!isHapticSupported()) return;
+	const pattern = HAPTIC_PATTERNS[intensity];
+	navigator.vibrate(pattern);
+}
+//#endregion
+export { triggerHaptic };
+
+//# sourceMappingURL=haptics.js.map

package/lib/utils/haptics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.js","names":[],"sources":["../../src/utils/haptics.ts"],"sourcesContent":["/**\n * Haptic Feedback Utility\n * \n * Provides tactile feedback for mobile touch interactions\n * Uses Vibration API for physical response on button presses and combat hits\n * \n * @module utils/haptics\n * @category Mobile Controls\n * @korean 햅틱 피드백 유틸리티\n */\n\n/**\n * Haptic intensity levels for different interactions\n */\nexport type HapticIntensity = 'light' | 'medium' | 'heavy';\n\n/**\n * Vibration patterns for different haptic intensities\n * - light: Quick tap (10ms) - UI interactions\n * - medium: Moderate pulse (50ms) - Combat actions\n * - heavy: Strong pulse (100ms) - Critical hits\n * \n * @korean 햅틱 강도 패턴\n */\nconst HAPTIC_PATTERNS: Record<HapticIntensity, number[]> = {\n  light: [10],\n  medium: [50],\n  heavy: [100],\n} as const;\n\n/**\n * Check if haptic feedback is supported by the device\n * \n * @returns True if Vibration API is available\n * @korean 햅틱 지원 확인\n * \n * @example\n * ```typescript\n * if (isHapticSupported()) {\n *   triggerHaptic('medium');\n * }\n * ```\n */\nexport function isHapticSupported(): boolean {\n  return typeof navigator !== 'undefined' && 'vibrate' in navigator;\n}\n\n/**\n * Trigger haptic feedback with specified intensity\n * \n * Provides tactile response for:\n * - Light: Menu selections, button taps\n * - Medium: Attack actions, stance changes\n * - Heavy: Critical hits, successful vital point strikes\n * \n * Falls back gracefully if Vibration API is not supported\n * \n * @param intensity - Haptic intensity level\n * @korean 햅틱 피드백 실행\n * \n * @example\n * ```typescript\n * // Light feedback for UI interaction\n * triggerHaptic('light');\n * \n * // Medium feedback for combat action\n * triggerHaptic('medium');\n * \n * // Heavy feedback for critical hit\n * triggerHaptic('heavy');\n * ```\n * \n * @public\n */\nexport function triggerHaptic(intensity: HapticIntensity): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  const pattern = HAPTIC_PATTERNS[intensity];\n  navigator.vibrate(pattern);\n}\n\n/**\n * Custom haptic pattern for specific game events\n * Allows creating complex vibration sequences\n * \n * @param pattern - Array of vibration durations in milliseconds\n * @korean 커스텀 햅틱 패턴\n * \n * @example\n * ```typescript\n * // Combo hit feedback: buzz, pause, buzz\n * triggerCustomHaptic([30, 20, 30]);\n * \n * // Critical vital point strike: long buzz\n * triggerCustomHaptic([200]);\n * ```\n * \n * @public\n */\nexport function triggerCustomHaptic(pattern: number[]): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  navigator.vibrate(pattern);\n}\n\n/**\n * Stop any ongoing haptic feedback\n * Useful for interrupting long vibrations\n * \n * @korean 햅틱 피드백 중지\n * \n * @example\n * ```typescript\n * // Cancel ongoing vibration\n * stopHaptic();\n * ```\n * \n * @public\n */\nexport function stopHaptic(): void {\n  if (!isHapticSupported()) {\n    return;\n  }\n\n  navigator.vibrate(0);\n}\n\n/**\n * Combat-specific haptic feedback patterns\n * Pre-configured patterns for common combat scenarios\n * \n * @korean 전투 햅틱 패턴\n */\nexport const CombatHaptics = {\n  /**\n   * Standard attack hit feedback\n   * @korean 일반 공격\n   */\n  attack: () => triggerHaptic('medium'),\n\n  /**\n   * Block successful feedback\n   * @korean 방어 성공\n   */\n  block: () => triggerHaptic('light'),\n\n  /**\n   * Critical hit feedback with double pulse\n   * @korean 크리티컬 히트\n   */\n  criticalHit: () => triggerCustomHaptic([50, 30, 100]),\n\n  /**\n   * Vital point strike feedback\n   * @korean 급소 타격\n   */\n  vitalPointStrike: () => triggerHaptic('heavy'),\n\n  /**\n   * Stance change feedback\n   * @korean 자세 변경\n   */\n  stanceChange: () => triggerHaptic('light'),\n\n  /**\n   * Combo counter increment\n   * @korean 콤보 카운터\n   */\n  comboIncrement: () => triggerHaptic('light'),\n\n  /**\n   * Player KO feedback with extended pattern\n   * @korean 플레이어 KO\n   */\n  knockout: () => triggerCustomHaptic([100, 50, 100, 50, 200]),\n\n  /**\n   * Error or invalid action feedback\n   * @korean 오류 피드백\n   */\n  error: () => triggerCustomHaptic([20, 10, 20]),\n} as const;\n"],"mappings":";;;;;;;;;AAwBA,IAAM,kBAAqD;CACzD,OAAO,CAAC,GAAG;CACX,QAAQ,CAAC,GAAG;CACZ,OAAO,CAAC,IAAI;CACb;;;;;;;;;;;;;;AAeD,SAAgB,oBAA6B;AAC3C,QAAO,OAAO,cAAc,eAAe,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B1D,SAAgB,cAAc,WAAkC;AAC9D,KAAI,CAAC,mBAAmB,CACtB;CAGF,MAAM,UAAU,gBAAgB;AAChC,WAAU,QAAQ,QAAQ"}