@hfd-sdk/keyboard-kit 1.0.0 → 1.1.0

package/dist/assert-hfd-device.js

@@ -0,0 +1,65 @@
+function h(e, n, t) {
+  var f, k;
+  const { keyList: i, musicConfig: r } = e, o = i[n], u = o == null ? void 0 : o[t];
+  if (!u) return t;
+  let s = 0;
+  for (let l = 0; l < t; l++) {
+    const y = (f = r == null ? void 0 : r.keyOffset) == null ? void 0 : f.find((d) => {
+      var D;
+      return d.value === ((D = o[l]) == null ? void 0 : D.value);
+    });
+    y && (s += y.offsetX);
+  }
+  let c = t + s;
+  const a = (k = r == null ? void 0 : r.keyOffset) == null ? void 0 : k.find((l) => l.value === u.value);
+  return a && (c += a.offsetX), c;
+}
+function w(e) {
+  const { keyList: n, musicConfig: t } = e, i = n.reduce((u, s) => Math.max(u, s.length), 0), r = (t == null ? void 0 : t.maxColOffset) || 0, o = i + r + 1;
+  return Array.from({ length: n.length }, () => Array.from({ length: o }, () => ({ r: 0, g: 0, b: 0 })));
+}
+function m(e, n) {
+  var u;
+  const { keyList: t, musicConfig: i } = n, r = t.flatMap((s, c) => {
+    let a = 0;
+    return s.map((f, k) => {
+      let l = k + a;
+      if (i != null && i.keyOffset) {
+        const y = i.keyOffset.find((d) => d.value === f.value);
+        y && (l += y.offsetX, a += y.offsetX);
+      }
+      return {
+        row: c,
+        col: l,
+        value: f.value
+      };
+    });
+  }), o = new Array(r.length * 4).fill(0);
+  for (let s = 0; s < r.length; s++) {
+    const c = r[s], a = ((u = e[c.row]) == null ? void 0 : u[c.col]) ?? { r: 0, g: 0, b: 0 }, f = s * 4;
+    o[f] = c.value, o[f + 1] = a.r, o[f + 2] = a.g, o[f + 3] = a.b;
+  }
+  return o;
+}
+const v = ["setMusicData", "getDeviceId", "isConnected", "getDevice"];
+function b(e) {
+  if (!e || typeof e != "object") return !1;
+  const n = e;
+  return v.every((t) => typeof n[t] == "function");
+}
+async function g(e) {
+  if (!e)
+    throw new Error("[keyboard-kit] init.device is required");
+  if (!b(e))
+    throw new Error("[keyboard-kit] init.device must be an @hfd-sdk/keyboard-sdk HFDDevice instance");
+  const { HFDDevice: n } = await import("@hfd-sdk/keyboard-sdk");
+  if (!(e instanceof n))
+    throw new Error("[keyboard-kit] init.device must be created via new HFDDevice() from @hfd-sdk/keyboard-sdk");
+  return e;
+}
+export {
+  g as a,
+  m as b,
+  w as c,
+  h as g
+};

package/dist/music-v2/engine.d.ts

@@ -0,0 +1,8 @@
+import { MusicV2Engine, MusicV2EngineOptions } from './types';
+/**
+ * 创建音乐律动 V2 引擎（框架无关）。
+ *
+ * 工作流程：定时（默认 50ms，worker-timers 不受页面隐藏节流）采样振幅 →
+ * 按当前模式绘制按键 RGB 网格 → 串行下发到键盘硬件。
+ */
+export declare function createMusicV2Engine(options: MusicV2EngineOptions): Promise<MusicV2Engine>;

package/dist/music-v2/index.d.ts

@@ -0,0 +1,12 @@
+export { createMusicV2Engine } from './engine';
+export { MusicV2Renderer } from './visualizers';
+export type { MusicV2RenderParams } from './visualizers';
+export { createSystemAudioSource } from './system-audio';
+export type { SystemAudioSource, SystemAudioFrequencyBands } from './system-audio';
+export { createMusicV2PluginClient } from './plugin-client';
+export type { MusicV2PluginClient, MusicV2PluginClientOptions } from './plugin-client';
+export { RING_68_KEY_POSITIONS, RING_87_KEY_POSITIONS, RING_108_KEY_POSITIONS, VOLCANO_64_KEY_POSITIONS, VOLCANO_84_ISO_KEY_POSITIONS, VOLCANO_87_KEY_POSITIONS, VOLCANO_98_KEY_POSITIONS, getMusicRingKeyPositions, getMusicVolcanoKeyPositions, } from './key-positions';
+export { HSVtoRGB, hexToRgb } from '../shared/color';
+export { buildMusicData, createKeysRgbGrid, getMusicGridCol } from '../shared/hardware/build-music-data';
+export type { MusicV2Mode, MusicV2BackgroundMode, MusicV2AmplitudeSource, MusicV2ScreenLightClient, MusicV2LedConfig, MusicV2EngineOptions, MusicV2State, MusicV2Engine, } from './types';
+export type { keyPosition, volcanoMountainPositions, KeyboardConfig, } from '../shared/types';