blacktrigram 0.7.2

package/lib/types/facial.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Facial animation types for realistic combat emotion and damage
+ *
+ * Defines facial expression system with damage tracking, eye tracking,
+ * and smooth expression transitions for authentic human-like combat feedback.
+ *
+ * @module types/facial
+ * @category Type Definitions
+ * @korean 얼굴애니메이션타입
+ */
+import * as THREE from "three";
+/**
+ * Facial expression states for combat
+ *
+ * Represents emotional and physical states visible on fighter's face.
+ * Each expression corresponds to specific combat situations.
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 얼굴표정
+ */
+export declare enum FacialExpression {
+    /** Calm, ready state */
+    NEUTRAL = "neutral",
+    /** Concentrated, ready to attack */
+    FOCUSED = "focused",
+    /** Pain response after hit */
+    PAINED = "pained",
+    /** Low stamina, heavy breathing */
+    EXHAUSTED = "exhausted",
+    /** Brief satisfaction after successful strike */
+    VICTORIOUS = "victorious",
+    /** Knocked out, unconscious */
+    DEFEATED = "defeated"
+}
+/**
+ * Bilingual names for facial expressions
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 표정이름
+ */
+export declare const FACIAL_EXPRESSION_NAMES: Record<FacialExpression, {
+    korean: string;
+    english: string;
+    romanized: string;
+}>;
+/**
+ * Facial damage state tracking
+ *
+ * Tracks accumulated damage to face for visual feedback.
+ * Includes bruising, swelling, and bleeding effects.
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 얼굴손상상태
+ */
+export interface FacialDamageState {
+    /** Left eye swelling (0-1, 0=none, 1=fully swollen) */
+    readonly leftEyeSwelling: number;
+    /** Right eye swelling (0-1, 0=none, 1=fully swollen) */
+    readonly rightEyeSwelling: number;
+    /** Mouth/lip bleeding intensity (0-1) */
+    readonly mouthBleeding: number;
+    /** Nose bleeding intensity (0-1) */
+    readonly noseBleeding: number;
+    /** Bruise intensity on left cheek (0-1) */
+    readonly leftCheekBruise: number;
+    /** Bruise intensity on right cheek (0-1) */
+    readonly rightCheekBruise: number;
+    /** Forehead bruise/cut intensity (0-1) */
+    readonly foreheadBruise: number;
+    /** Jaw bruise intensity (0-1) */
+    readonly jawBruise: number;
+    /** Total facial damage accumulation (0-100) */
+    readonly totalFacialDamage: number;
+}
+/**
+ * Expression state with transition timing
+ *
+ * Manages current expression and smooth transition to next expression.
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 표정상태
+ */
+export interface ExpressionState {
+    /** Current facial expression */
+    readonly expression: FacialExpression;
+    /** Expression intensity (0-1, affects degree of expression) */
+    readonly intensity: number;
+    /** Time to transition to new expression (seconds) */
+    readonly transitionTime: number;
+    /** Previous expression (for blending) */
+    readonly previousExpression?: FacialExpression;
+    /** Transition progress (0-1, 0=start, 1=complete) */
+    readonly transitionProgress?: number;
+}
+/**
+ * Eye openness values for expressions
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 눈개방도
+ */
+export declare const EYE_OPENNESS: Record<FacialExpression, number>;
+/**
+ * Mouth openness values for expressions
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 입개방도
+ */
+export declare const MOUTH_OPENNESS: Record<FacialExpression, number>;
+/**
+ * Head movement animation type
+ *
+ * Defines types of head movements for combat reactions.
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 머리움직임타입
+ */
+export declare enum HeadMovementType {
+    /** Head snaps back when hit */
+    RECOIL = "recoil",
+    /** Slight nod forward during attack */
+    NOD = "nod",
+    /** Head tilts to avoid strike */
+    TILT = "tilt",
+    /** Head turns to track opponent */
+    TURN = "turn",
+    /** Head shakes when stunned */
+    SHAKE = "shake",
+    /** Head drops when defeated */
+    DROP = "drop"
+}
+/**
+ * Head movement animation keyframes
+ *
+ * Sequence of Euler rotations for head movement animations.
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 머리움직임키프레임
+ */
+export interface HeadMovementKeyframes {
+    /** Movement type identifier */
+    readonly type: HeadMovementType;
+    /** Sequence of rotation keyframes */
+    readonly rotations: readonly THREE.Euler[];
+    /** Duration of each keyframe in seconds */
+    readonly frameDuration: number;
+    /** Total animation duration in seconds */
+    readonly totalDuration: number;
+    /** Whether animation loops */
+    readonly loop: boolean;
+}
+/**
+ * Eye tracking state
+ *
+ * Manages eye direction and pupil position for opponent tracking.
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 눈추적상태
+ */
+export interface EyeTrackingState {
+    /** Target position to look at (opponent position) */
+    readonly targetPosition: THREE.Vector3;
+    /** Current look direction (normalized) */
+    readonly lookDirection: THREE.Vector3;
+    /** Pupil offset from center (-1 to 1 for each axis) */
+    readonly pupilOffset: {
+        x: number;
+        y: number;
+    };
+    /** Tracking speed (smoothing factor) */
+    readonly trackingSpeed: number;
+    /** Whether tracking is enabled */
+    readonly enabled: boolean;
+}
+/**
+ * Default facial damage state (no damage)
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 기본얼굴손상상태
+ */
+export declare const DEFAULT_FACIAL_DAMAGE: FacialDamageState;
+/**
+ * Default expression state (neutral)
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 기본표정상태
+ */
+export declare const DEFAULT_EXPRESSION_STATE: ExpressionState;
+/**
+ * Default eye tracking state
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 기본눈추적상태
+ */
+export declare const DEFAULT_EYE_TRACKING: EyeTrackingState;
+/**
+ * Face3D component props
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 얼굴3D속성
+ */
+export interface Face3DProps {
+    /** Current facial expression */
+    readonly expression: FacialExpression;
+    /** Facial damage state */
+    readonly damage: FacialDamageState;
+    /** Opponent position for eye tracking */
+    readonly opponentPosition: THREE.Vector3;
+    /** Current head rotation (Euler angles) */
+    readonly headRotation: THREE.Euler;
+    /** Enable eye tracking (default: true) */
+    readonly enableEyeTracking?: boolean;
+    /** Enable damage visualization (default: true) */
+    readonly enableDamageVisuals?: boolean;
+    /** Mobile mode (simplified rendering) */
+    readonly isMobile?: boolean;
+    /** Skin tone color (default: 0xffdbac) */
+    readonly skinColor?: number;
+}
+/**
+ * Eye component props
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 눈3D속성
+ */
+export interface EyeProps {
+    /** Eye position relative to head */
+    readonly position: [number, number, number];
+    /** Current facial expression */
+    readonly expression: FacialExpression;
+    /** Look direction for pupil tracking */
+    readonly lookDirection: THREE.Vector3;
+    /** Eye swelling amount (0-1) */
+    readonly swelling: number;
+    /** Whether this is the left or right eye */
+    readonly side: "left" | "right";
+}
+/**
+ * Mouth component props
+ *
+ * @public
+ * @category Facial Animation
+ * @korean 입3D속성
+ */
+export interface MouthProps {
+    /** Mouth position relative to head */
+    readonly position: [number, number, number];
+    /** Current facial expression */
+    readonly expression: FacialExpression;
+    /** Bleeding intensity (0-1) */
+    readonly bleeding: number;
+}
+//# sourceMappingURL=facial.d.ts.map

package/lib/types/facial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facial.d.ts","sourceRoot":"","sources":["../../src/types/facial.ts"],"names":[],"mappings":"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"}

package/lib/types/facial.js

@@ -0,0 +1,92 @@
+import * as THREE from "three";
+//#region src/types/facial.ts
+/**
+* Facial animation types for realistic combat emotion and damage
+* 
+* Defines facial expression system with damage tracking, eye tracking,
+* and smooth expression transitions for authentic human-like combat feedback.
+* 
+* @module types/facial
+* @category Type Definitions
+* @korean 얼굴애니메이션타입
+*/
+/**
+* Facial expression states for combat
+* 
+* Represents emotional and physical states visible on fighter's face.
+* Each expression corresponds to specific combat situations.
+* 
+* @public
+* @category Facial Animation
+* @korean 얼굴표정
+*/
+var FacialExpression = /* @__PURE__ */ function(FacialExpression) {
+	/** Calm, ready state */
+	FacialExpression["NEUTRAL"] = "neutral";
+	/** Concentrated, ready to attack */
+	FacialExpression["FOCUSED"] = "focused";
+	/** Pain response after hit */
+	FacialExpression["PAINED"] = "pained";
+	/** Low stamina, heavy breathing */
+	FacialExpression["EXHAUSTED"] = "exhausted";
+	/** Brief satisfaction after successful strike */
+	FacialExpression["VICTORIOUS"] = "victorious";
+	/** Knocked out, unconscious */
+	FacialExpression["DEFEATED"] = "defeated";
+	return FacialExpression;
+}({});
+FacialExpression.NEUTRAL, FacialExpression.FOCUSED, FacialExpression.PAINED, FacialExpression.EXHAUSTED, FacialExpression.VICTORIOUS, FacialExpression.DEFEATED;
+/**
+* Eye openness values for expressions
+* 
+* @public
+* @category Facial Animation
+* @korean 눈개방도
+*/
+var EYE_OPENNESS = {
+	[FacialExpression.NEUTRAL]: 1,
+	[FacialExpression.FOCUSED]: .7,
+	[FacialExpression.PAINED]: .3,
+	[FacialExpression.EXHAUSTED]: .5,
+	[FacialExpression.VICTORIOUS]: .9,
+	[FacialExpression.DEFEATED]: 0
+};
+/**
+* Mouth openness values for expressions
+* 
+* @public
+* @category Facial Animation
+* @korean 입개방도
+*/
+var MOUTH_OPENNESS = {
+	[FacialExpression.NEUTRAL]: 0,
+	[FacialExpression.FOCUSED]: 0,
+	[FacialExpression.PAINED]: .8,
+	[FacialExpression.EXHAUSTED]: .4,
+	[FacialExpression.VICTORIOUS]: .2,
+	[FacialExpression.DEFEATED]: .1
+};
+/**
+* Default facial damage state (no damage)
+* 
+* @public
+* @category Facial Animation
+* @korean 기본얼굴손상상태
+*/
+var DEFAULT_FACIAL_DAMAGE = {
+	leftEyeSwelling: 0,
+	rightEyeSwelling: 0,
+	mouthBleeding: 0,
+	noseBleeding: 0,
+	leftCheekBruise: 0,
+	rightCheekBruise: 0,
+	foreheadBruise: 0,
+	jawBruise: 0,
+	totalFacialDamage: 0
+};
+FacialExpression.NEUTRAL;
+new THREE.Vector3(0, 1.9, 5), new THREE.Vector3(0, 0, 1);
+//#endregion
+export { DEFAULT_FACIAL_DAMAGE, EYE_OPENNESS, FacialExpression, MOUTH_OPENNESS };
+
+//# sourceMappingURL=facial.js.map

package/lib/types/facial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facial.js","names":[],"sources":["../../src/types/facial.ts"],"sourcesContent":["/**\n * Facial animation types for realistic combat emotion and damage\n * \n * Defines facial expression system with damage tracking, eye tracking,\n * and smooth expression transitions for authentic human-like combat feedback.\n * \n * @module types/facial\n * @category Type Definitions\n * @korean 얼굴애니메이션타입\n */\n\nimport * as THREE from \"three\";\n\n/**\n * Facial expression states for combat\n * \n * Represents emotional and physical states visible on fighter's face.\n * Each expression corresponds to specific combat situations.\n * \n * @public\n * @category Facial Animation\n * @korean 얼굴표정\n */\nexport enum FacialExpression {\n  /** Calm, ready state */\n  NEUTRAL = \"neutral\",\n  /** Concentrated, ready to attack */\n  FOCUSED = \"focused\",\n  /** Pain response after hit */\n  PAINED = \"pained\",\n  /** Low stamina, heavy breathing */\n  EXHAUSTED = \"exhausted\",\n  /** Brief satisfaction after successful strike */\n  VICTORIOUS = \"victorious\",\n  /** Knocked out, unconscious */\n  DEFEATED = \"defeated\",\n}\n\n/**\n * Bilingual names for facial expressions\n * \n * @public\n * @category Facial Animation\n * @korean 표정이름\n */\nexport const FACIAL_EXPRESSION_NAMES: Record<\n  FacialExpression,\n  { korean: string; english: string; romanized: string }\n> = {\n  [FacialExpression.NEUTRAL]: {\n    korean: \"평온\",\n    english: \"Neutral\",\n    romanized: \"pyeong-on\",\n  },\n  [FacialExpression.FOCUSED]: {\n    korean: \"집중\",\n    english: \"Focused\",\n    romanized: \"jipjung\",\n  },\n  [FacialExpression.PAINED]: {\n    korean: \"고통\",\n    english: \"Pained\",\n    romanized: \"gotong\",\n  },\n  [FacialExpression.EXHAUSTED]: {\n    korean: \"지침\",\n    english: \"Exhausted\",\n    romanized: \"jichim\",\n  },\n  [FacialExpression.VICTORIOUS]: {\n    korean: \"승리\",\n    english: \"Victorious\",\n    romanized: \"seungri\",\n  },\n  [FacialExpression.DEFEATED]: {\n    korean: \"패배\",\n    english: \"Defeated\",\n    romanized: \"paebae\",\n  },\n};\n\n/**\n * Facial damage state tracking\n * \n * Tracks accumulated damage to face for visual feedback.\n * Includes bruising, swelling, and bleeding effects.\n * \n * @public\n * @category Facial Animation\n * @korean 얼굴손상상태\n */\nexport interface FacialDamageState {\n  /** Left eye swelling (0-1, 0=none, 1=fully swollen) */\n  readonly leftEyeSwelling: number;\n  \n  /** Right eye swelling (0-1, 0=none, 1=fully swollen) */\n  readonly rightEyeSwelling: number;\n  \n  /** Mouth/lip bleeding intensity (0-1) */\n  readonly mouthBleeding: number;\n  \n  /** Nose bleeding intensity (0-1) */\n  readonly noseBleeding: number;\n  \n  /** Bruise intensity on left cheek (0-1) */\n  readonly leftCheekBruise: number;\n  \n  /** Bruise intensity on right cheek (0-1) */\n  readonly rightCheekBruise: number;\n  \n  /** Forehead bruise/cut intensity (0-1) */\n  readonly foreheadBruise: number;\n  \n  /** Jaw bruise intensity (0-1) */\n  readonly jawBruise: number;\n  \n  /** Total facial damage accumulation (0-100) */\n  readonly totalFacialDamage: number;\n}\n\n/**\n * Expression state with transition timing\n * \n * Manages current expression and smooth transition to next expression.\n * \n * @public\n * @category Facial Animation\n * @korean 표정상태\n */\nexport interface ExpressionState {\n  /** Current facial expression */\n  readonly expression: FacialExpression;\n  \n  /** Expression intensity (0-1, affects degree of expression) */\n  readonly intensity: number;\n  \n  /** Time to transition to new expression (seconds) */\n  readonly transitionTime: number;\n  \n  /** Previous expression (for blending) */\n  readonly previousExpression?: FacialExpression;\n  \n  /** Transition progress (0-1, 0=start, 1=complete) */\n  readonly transitionProgress?: number;\n}\n\n/**\n * Eye openness values for expressions\n * \n * @public\n * @category Facial Animation\n * @korean 눈개방도\n */\nexport const EYE_OPENNESS: Record<FacialExpression, number> = {\n  [FacialExpression.NEUTRAL]: 1.0, // Fully open\n  [FacialExpression.FOCUSED]: 0.7, // Narrowed\n  [FacialExpression.PAINED]: 0.3, // Squinted\n  [FacialExpression.EXHAUSTED]: 0.5, // Half-closed\n  [FacialExpression.VICTORIOUS]: 0.9, // Nearly fully open\n  [FacialExpression.DEFEATED]: 0.0, // Closed\n};\n\n/**\n * Mouth openness values for expressions\n * \n * @public\n * @category Facial Animation\n * @korean 입개방도\n */\nexport const MOUTH_OPENNESS: Record<FacialExpression, number> = {\n  [FacialExpression.NEUTRAL]: 0.0, // Closed\n  [FacialExpression.FOCUSED]: 0.0, // Closed, determined\n  [FacialExpression.PAINED]: 0.8, // Open, yelling\n  [FacialExpression.EXHAUSTED]: 0.4, // Panting\n  [FacialExpression.VICTORIOUS]: 0.2, // Slight smile\n  [FacialExpression.DEFEATED]: 0.1, // Slack\n};\n\n/**\n * Head movement animation type\n * \n * Defines types of head movements for combat reactions.\n * \n * @public\n * @category Facial Animation\n * @korean 머리움직임타입\n */\nexport enum HeadMovementType {\n  /** Head snaps back when hit */\n  RECOIL = \"recoil\",\n  /** Slight nod forward during attack */\n  NOD = \"nod\",\n  /** Head tilts to avoid strike */\n  TILT = \"tilt\",\n  /** Head turns to track opponent */\n  TURN = \"turn\",\n  /** Head shakes when stunned */\n  SHAKE = \"shake\",\n  /** Head drops when defeated */\n  DROP = \"drop\",\n}\n\n/**\n * Head movement animation keyframes\n * \n * Sequence of Euler rotations for head movement animations.\n * \n * @public\n * @category Facial Animation\n * @korean 머리움직임키프레임\n */\nexport interface HeadMovementKeyframes {\n  /** Movement type identifier */\n  readonly type: HeadMovementType;\n  \n  /** Sequence of rotation keyframes */\n  readonly rotations: readonly THREE.Euler[];\n  \n  /** Duration of each keyframe in seconds */\n  readonly frameDuration: number;\n  \n  /** Total animation duration in seconds */\n  readonly totalDuration: number;\n  \n  /** Whether animation loops */\n  readonly loop: boolean;\n}\n\n/**\n * Eye tracking state\n * \n * Manages eye direction and pupil position for opponent tracking.\n * \n * @public\n * @category Facial Animation\n * @korean 눈추적상태\n */\nexport interface EyeTrackingState {\n  /** Target position to look at (opponent position) */\n  readonly targetPosition: THREE.Vector3;\n  \n  /** Current look direction (normalized) */\n  readonly lookDirection: THREE.Vector3;\n  \n  /** Pupil offset from center (-1 to 1 for each axis) */\n  readonly pupilOffset: { x: number; y: number };\n  \n  /** Tracking speed (smoothing factor) */\n  readonly trackingSpeed: number;\n  \n  /** Whether tracking is enabled */\n  readonly enabled: boolean;\n}\n\n/**\n * Default facial damage state (no damage)\n * \n * @public\n * @category Facial Animation\n * @korean 기본얼굴손상상태\n */\nexport const DEFAULT_FACIAL_DAMAGE: FacialDamageState = {\n  leftEyeSwelling: 0,\n  rightEyeSwelling: 0,\n  mouthBleeding: 0,\n  noseBleeding: 0,\n  leftCheekBruise: 0,\n  rightCheekBruise: 0,\n  foreheadBruise: 0,\n  jawBruise: 0,\n  totalFacialDamage: 0,\n};\n\n/**\n * Default expression state (neutral)\n * \n * @public\n * @category Facial Animation\n * @korean 기본표정상태\n */\nexport const DEFAULT_EXPRESSION_STATE: ExpressionState = {\n  expression: FacialExpression.NEUTRAL,\n  intensity: 1.0,\n  transitionTime: 0.2,\n};\n\n/**\n * Default eye tracking state\n * \n * @public\n * @category Facial Animation\n * @korean 기본눈추적상태\n */\nexport const DEFAULT_EYE_TRACKING: EyeTrackingState = {\n  targetPosition: new THREE.Vector3(0, 1.9, 5), // Looking forward\n  lookDirection: new THREE.Vector3(0, 0, 1), // Forward\n  pupilOffset: { x: 0, y: 0 },\n  trackingSpeed: 0.1,\n  enabled: true,\n};\n\n/**\n * Face3D component props\n * \n * @public\n * @category Facial Animation\n * @korean 얼굴3D속성\n */\nexport interface Face3DProps {\n  /** Current facial expression */\n  readonly expression: FacialExpression;\n  \n  /** Facial damage state */\n  readonly damage: FacialDamageState;\n  \n  /** Opponent position for eye tracking */\n  readonly opponentPosition: THREE.Vector3;\n  \n  /** Current head rotation (Euler angles) */\n  readonly headRotation: THREE.Euler;\n  \n  /** Enable eye tracking (default: true) */\n  readonly enableEyeTracking?: boolean;\n  \n  /** Enable damage visualization (default: true) */\n  readonly enableDamageVisuals?: boolean;\n  \n  /** Mobile mode (simplified rendering) */\n  readonly isMobile?: boolean;\n  \n  /** Skin tone color (default: 0xffdbac) */\n  readonly skinColor?: number;\n}\n\n/**\n * Eye component props\n * \n * @public\n * @category Facial Animation\n * @korean 눈3D속성\n */\nexport interface EyeProps {\n  /** Eye position relative to head */\n  readonly position: [number, number, number];\n  \n  /** Current facial expression */\n  readonly expression: FacialExpression;\n  \n  /** Look direction for pupil tracking */\n  readonly lookDirection: THREE.Vector3;\n  \n  /** Eye swelling amount (0-1) */\n  readonly swelling: number;\n  \n  /** Whether this is the left or right eye */\n  readonly side: \"left\" | \"right\";\n}\n\n/**\n * Mouth component props\n * \n * @public\n * @category Facial Animation\n * @korean 입3D속성\n */\nexport interface MouthProps {\n  /** Mouth position relative to head */\n  readonly position: [number, number, number];\n  \n  /** Current facial expression */\n  readonly expression: FacialExpression;\n  \n  /** Bleeding intensity (0-1) */\n  readonly bleeding: number;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAY,mBAAL,yBAAA,kBAAA;;AAEL,kBAAA,aAAA;;AAEA,kBAAA,aAAA;;AAEA,kBAAA,YAAA;;AAEA,kBAAA,eAAA;;AAEA,kBAAA,gBAAA;;AAEA,kBAAA,cAAA;;KACD;AAaE,iBAAiB,SAKjB,iBAAiB,SAKjB,iBAAiB,QAKjB,iBAAiB,WAKjB,iBAAiB,YAKjB,iBAAiB;;;;;;;;AA+EpB,IAAa,eAAiD;EAC3D,iBAAiB,UAAU;EAC3B,iBAAiB,UAAU;EAC3B,iBAAiB,SAAS;EAC1B,iBAAiB,YAAY;EAC7B,iBAAiB,aAAa;EAC9B,iBAAiB,WAAW;CAC9B;;;;;;;;AASD,IAAa,iBAAmD;EAC7D,iBAAiB,UAAU;EAC3B,iBAAiB,UAAU;EAC3B,iBAAiB,SAAS;EAC1B,iBAAiB,YAAY;EAC7B,iBAAiB,aAAa;EAC9B,iBAAiB,WAAW;CAC9B;;;;;;;;AAqFD,IAAa,wBAA2C;CACtD,iBAAiB;CACjB,kBAAkB;CAClB,eAAe;CACf,cAAc;CACd,iBAAiB;CACjB,kBAAkB;CAClB,gBAAgB;CAChB,WAAW;CACX,mBAAmB;CACpB;AAUa,iBAAiB;AAab,IAAI,MAAM,QAAQ,GAAG,KAAK,EAAE,EAC7B,IAAI,MAAM,QAAQ,GAAG,GAAG,EAAE"}