키 (keys)

type SlotMatch = 'all' | 'any';
 
// 슬롯은 단일 키 문자열 또는 멀티 키 바인딩입니다:
// - match: 'any': 멤버 키 중 하나만 눌러도 슬롯 활성 (택일)
// - match: 'all': 멤버 키를 전부 동시에 눌러야 슬롯 활성 (동시)
interface MultiKeySlot {
  keys: string[]; // 멤버 키 2~8개
  match: SlotMatch;
}
 
type KeySlot = string | MultiKeySlot;
type KeyMappings = Record<string, KeySlot[]>;
// { "4key": ["D", { keys: ["F", "NUMPAD 4"], match: "any" }, ...], ... }

const mappings = await dmn.keys.get();
console.log('4key 매핑:', mappings['4key']);

const current = await dmn.keys.get();
current['4key'] = ['S', 'D', 'J', 'K'];
await dmn.keys.update(current);

await dmn.keys.update(current, { multiKey: true });

interface KeyPosition {
  id?: string; // 요소 안정 ID (UUID). 앱이 발급·소유
  dx: number;
  dy: number;
  width: number;
  height: number;
  activeImage?: string;
  inactiveImage?: string;
  activeTransparent?: boolean;
  idleTransparent?: boolean;
  imageMode?: 'replace' | 'overlay'; // 이미지 배치. 없으면 replace(이미지가 키를 대체)
  idleImageTransform?: { offsetX: number; offsetY: number; rotation: number; scale: number }; // 없으면 identity
  activeImageTransform?: { offsetX: number; offsetY: number; rotation: number; scale: number };
  count: number;
  noteColor: string | { type: 'gradient'; top: string; bottom: string };
  noteOpacity: number;
  noteOpacityTop?: number;
  noteOpacityBottom?: number;
  noteGradient?: GradientSpec | null;
  noteEffectEnabled: boolean;
  noteGlowEnabled: boolean;
  noteGlowSyncPaint?: boolean;
  noteGlowSize: number;
  noteGlowOpacity: number;
  noteGlowOpacityTop?: number;
  noteGlowOpacityBottom?: number;
  noteGlowColor?: string | { type: 'gradient'; top: string; bottom: string };
  noteGlowGradient?: GradientSpec | null;
  noteBorderColor?: string;
  noteBorderGradient?: GradientSpec | null;
  noteAutoYCorrection: boolean;
  className?: string;
  zIndex?: number;
  counter: KeyCounterSettings;
  backgroundColor?: string;
  activeBackgroundColor?: string;
  borderColor?: string;
  activeBorderColor?: string;
  borderWidth?: number; // px, 미지정 시 기본 1. 0이면 테두리 없음
  backgroundGradient?: GradientSpec | null;
  activeBackgroundGradient?: GradientSpec | null;
  borderGradient?: GradientSpec | null;
  activeBorderGradient?: GradientSpec | null;
  fontColor?: string;
  activeFontColor?: string;
  fontGradient?: GradientSpec | null;
  activeFontGradient?: GradientSpec | null;
  shadow?: ElementShadowSpec;
  activeShadow?: ElementShadowSpec;
}
 
interface KeyCounterSettings {
  // ...배치, 글자, 애니메이션 필드...
  fill: { idle: string; active: string };
  fillIdleGradient?: GradientSpec | null;
  fillActiveGradient?: GradientSpec | null;
}
 
interface GradientSpec {
  angle: number; // 0 이상 360 미만. 360은 0으로 정규화 (CSS 기준, 0 = 위·시계 방향)
  stops: { color: string; pos: number }[]; // 2–8개, pos는 0–1 오름차순
}
 
interface ElementShadowSpec {
  enabled: boolean;
  color: string; // 알파값으로 농도 조절
  offsetX: number; // px, -100~100
  offsetY: number; // px, -100~100
  blur: number; // px, 0~100
}

const positions = await dmn.keys.getPositions();
console.log('4key 위치:', positions['4key']);

const current = await dmn.keys.getPositions();
current['4key'][0].dx = 100;
await dmn.keys.updatePositions(current);

interface KeysWithPositionsResult {
  keys: KeyMappings;
  positions: KeyPositions;
}
 
const result = await dmn.keys.updateWithPositions(mappings, positions, {
  multiKey: true,
});

const result = await dmn.keys.setMode('8key');
console.log('모드 변경 성공:', result.success);

await dmn.keys.resetMode('4key');

const reset = await dmn.keys.resetAll();

const counters = await dmn.keys.getCounters();
console.log('4key 카운터:', counters['4key']);

await dmn.keys.setCounters({
  '4key': { D: 100, F: 200, J: 150, K: 180 },
});

await dmn.keys.resetCounters();

await dmn.keys.resetCountersMode('4key');

await dmn.keys.resetSingleCounter('4key', 'D');

interface KeyStatePayload {
  key: string; // canonical 슬롯 식별자 (예: "D", "F|NUMPAD 4")
  state: string; // "DOWN" | "UP"
  mode: string; // 현재 모드
  // 입력 수신~emit 경과 시간(ms).
  // `performance.now() - eventAgeMs`로 실제 입력 시각 복원
  eventAgeMs?: number;
  // UP 이벤트 한정. 같은 물리 입력이 canonical DOWN과 UP을 만든 경우
  // 입력 데몬이 측정한 물리 눌림 지속 시간(ms). source가 다르거나
  // 불명확하면 생략됨
  holdDurationMs?: number;
}

const unsub = dmn.keys.onKeyState(({ key, state, mode }) => {
  console.log(`[${mode}] ${key} is ${state}`);
});

const unsub = dmn.keys.onKeyState(handler);
await unsub.ready; // 이 시점부터 구독이 활성

interface KeysResetPayload {
  reason: string; // 예: "hook_restart"
}

dmn.keys.onKeysReset(({ reason }) => {
  console.log(`키 상태 리셋: ${reason}`);
});

interface RawInputPayload {
  device: 'keyboard' | 'mouse' | 'gamepad' | 'unknown';
  label: string; // "D", "MOUSE1", "HIDB:1ccf:101c:9:3" 등
  labels: string[]; // 모든 레이블 목록
  state: string; // "DOWN" | "UP"
}

const unsub = dmn.keys.onRawInput(({ device, label, state }) => {
  console.log(`[${device}] ${label} ${state}`);
});

const unsub = dmn.keys.onChanged((mappings) => {
  console.log('키 매핑 변경:', mappings);
});

const unsub = dmn.keys.onPositionsChanged((positions) => {
  console.log('키 위치 변경:', positions);
});

const unsub = dmn.keys.onModeChanged(({ mode }) => {
  console.log('모드 변경:', mode);
});

const unsub = dmn.keys.onCounterChanged(
  ({ mode, key, count, sessionId, revision }) => {
    console.log(
      `[${mode}] ${key}: ${count} (${sessionId}, revision ${revision})`,
    );
  },
);

const unsub = dmn.keys.onCountersChanged((counters) => {
  console.log('카운터:', counters);
});

const tabs = await dmn.keys.customTabs.list();

const result = await dmn.keys.customTabs.create('My Keys');
if (result.error) {
  // "invalid-name" | "name-too-long" | "reserved-name"
  // "duplicate-name" | "max-reached"
  console.error(result.error);
} else {
  console.log('생성됨:', result.result);
}

const result = await dmn.keys.customTabs.delete('custom-123');

await dmn.keys.customTabs.select('custom-123');

await dmn.keys.customTabs.restore(
  [{ id: 'custom-123', name: 'My Keys' }],
  'custom-123',
);

const unsub = dmn.keys.customTabs.onChanged(
  ({
    customTabs,
    tabOrder,
    barCount,
    selectedKeyType,
    selectionAuthoritative,
  }) => {
    console.log('선택된 탭:', selectedKeyType);
    console.log('바에 있는 탭:', tabOrder.slice(0, barCount));
    console.log('이벤트가 선택을 소유함:', selectionAuthoritative);
  },
);

interface KeyStatsPayload {
  kps: number; // 현재 KPS (초당 키 입력 수)
  kpsAvg: number; // 평균 KPS
  kpsMax: number; // 최대 KPS
  total: number; // 현재 탭의 전체 키 카운트 합계
}

const unsub = dmn.stats.subscribe(({ kps, kpsAvg, kpsMax, total }) => {
  console.log(`KPS: ${kps}, AVG: ${kpsAvg}, MAX: ${kpsMax}, TOTAL: ${total}`);
});
 
// 구독 해제
unsub();

const stats = dmn.stats.get();
console.log(`현재 KPS: ${stats.kps}`);

dmn.stats.reset();