@hfd-sdk/keyboard-kit 1.0.0

package/dist/runtime.es.js

@@ -0,0 +1,44 @@
+import { k as p, c as _, x as y, l as d, o as m, a as w, m as b, r as k, s as v, p as x, t as z, w as h } from "./runtime-core.es.js";
+function s(e) {
+  const n = {};
+  for (const [o, t] of Object.entries(e))
+    n[o] = typeof t == "function" ? { __fn__: !0, body: t.toString() } : t;
+  return n;
+}
+function a(e) {
+  const n = {};
+  for (const [o, t] of Object.entries(e)) {
+    const r = t;
+    n[o] = r && typeof r == "object" && r.__fn__ ? c(r.body) : t;
+  }
+  return n;
+}
+function c(e) {
+  try {
+    return new Function(`return (${e})`)();
+  } catch {
+    return new Function(`return function ${e}`)();
+  }
+}
+function u(e) {
+  return s(e);
+}
+function i(e) {
+  return a(e);
+}
+export {
+  p as clearInterval,
+  _ as computed,
+  y as defineCustomElement,
+  i as deserializePreset,
+  d as nextTick,
+  m as onBeforeUnmount,
+  w as onMounted,
+  b as onScopeDispose,
+  k as ref,
+  u as serializePreset,
+  v as setInterval,
+  x as shallowRef,
+  z as toValue,
+  h as watch
+};

package/dist/shared/composables/useKeySampler.d.ts

@@ -0,0 +1,8 @@
+import { KeyboardSyncConfig, KeyElementRef, RgbColor } from '../types';
+export declare function discoverKeyElements(root: HTMLElement): KeyElementRef[];
+export interface SampleKeysOptions {
+    canvas: HTMLCanvasElement;
+    keyboardConfig: KeyboardSyncConfig;
+    getKeyElements: () => KeyElementRef[];
+}
+export declare function sampleKeysFromCanvas(options: SampleKeysOptions): RgbColor[][] | null;

package/dist/shared/hardware/assert-hfd-device.d.ts

@@ -0,0 +1,3 @@
+import { HFDSDKDevice } from '../types';
+/** 校验 init.device 必须为 @hfd-sdk/keyboard-sdk 的 HFDDevice 实例，拒绝第三方 mock */
+export declare function assertHFDSDKDevice(device: unknown): Promise<HFDSDKDevice>;

package/dist/shared/hardware/build-music-data.d.ts

@@ -0,0 +1,4 @@
+import { KeyboardSyncConfig, RgbColor } from '../types';
+export declare function getMusicGridCol(keyboardConfig: KeyboardSyncConfig, rowIndex: number, colIndex: number): number;
+export declare function createKeysRgbGrid(keyboardConfig: KeyboardSyncConfig): RgbColor[][];
+export declare function buildMusicData(keysRgb: RgbColor[][], keyboardConfig: KeyboardSyncConfig): number[];

package/dist/shared/serialize.d.ts

@@ -0,0 +1,4 @@
+export declare function serialize(data: Record<string, unknown>): Record<string, unknown>;
+export declare function deserialize(data: Record<string, unknown>): Record<string, unknown>;
+export declare function serializePreset(preset: import('./types').AiLightingPreset): Record<string, unknown>;
+export declare function deserializePreset(raw: Record<string, unknown>): import('./types').AiLightingPreset;

package/dist/shared/types.d.ts

@@ -0,0 +1,123 @@
+export interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+export interface KeyOffset {
+    value: number;
+    offsetX: number;
+}
+export interface KeyboardKeyMeta {
+    value: number;
+    keyCode: number;
+    name?: string;
+}
+export interface KeyboardSyncConfig {
+    keys: KeyboardKeyMeta[][];
+    musicConfig?: {
+        keyOffset?: KeyOffset[];
+        maxColOffset?: number;
+    };
+}
+export interface KeyboardLayoutState {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+}
+export interface KeyElementRef {
+    row: number;
+    col: number;
+    el: HTMLElement;
+}
+export type AiLightingPresetParamValue = number | string | boolean;
+export interface AiLightingPresetParamOption {
+    label: string;
+    value: number | string;
+}
+export interface AiLightingPresetParam {
+    key: string;
+    name?: string;
+    type?: 'slider' | 'color' | 'select' | 'switch';
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: AiLightingPresetParamOption[];
+    default?: AiLightingPresetParamValue;
+}
+export interface AiLightingPresetContext {
+    canvas2d: CanvasRenderingContext2D;
+    width: number;
+    height: number;
+}
+export interface AiLightingPreset {
+    id: string;
+    name: string;
+    icon?: string;
+    description?: string;
+    params?: AiLightingPresetParam[];
+    initialize: (ctx: AiLightingPresetContext, params: Record<string, AiLightingPresetParamValue>) => unknown;
+    render: (ctx: AiLightingPresetContext, state: unknown, frame: {
+        deltaTime: number;
+        elapsedTime: number;
+    }, params: Record<string, AiLightingPresetParamValue>) => void;
+    shutdown: (ctx: AiLightingPresetContext, state: unknown) => void;
+}
+/** `@hfd-sdk/keyboard-sdk` 的 HFDDevice 实例（init 必填，运行时 instanceof 校验） */
+export interface HFDSDKDevice {
+    setMusicData(musicData: number[], amplitude?: number, isUSBDevice?: boolean, lightingVersion?: number): Promise<boolean>;
+}
+export interface ParamChangePayload {
+    key: string;
+    value: AiLightingPresetParamValue;
+    params: Record<string, AiLightingPresetParamValue>;
+}
+export interface ImportPresetPayload {
+    code: number;
+    message: string;
+}
+export interface AiLightingInitOptions {
+    presets?: AiLightingPreset[];
+    importedPresets?: AiLightingPreset[];
+    selectedPresetId?: string;
+    defaultParams?: Partial<Record<string, AiLightingPresetParamValue>>;
+    keyboardConfig: KeyboardSyncConfig;
+    device: HFDSDKDevice;
+    isUSBDevice?: boolean;
+    lightingVersion?: number;
+    syncIntervalMs?: number;
+    canvasWidth?: number;
+    canvasHeight?: number;
+    getKeyElements?: () => KeyElementRef[];
+    initialLayout?: KeyboardLayoutState;
+}
+/** 与 Vue Ref 结构兼容，供素材库 UI 读取列表/选中态 */
+export interface KitRef<T> {
+    value: T;
+}
+/** 只读预设状态（`getPresetState()`） */
+export interface AiLightingPresetState {
+    presetList: KitRef<AiLightingPreset[]>;
+    selectedPresetId: KitRef<string>;
+    selectedPreset(): AiLightingPreset | null;
+    isInitialPreset(id: string): boolean;
+}
+/** `<hfd-ai-lighting>` 实例 API */
+export interface HfdAiLightingElementInstance extends HTMLElement {
+    init(options: AiLightingInitOptions): Promise<void>;
+    selectPreset(id: string): void;
+    deletePreset(id: string): Promise<void>;
+    importPreset(code: string): Promise<AiLightingPreset | null>;
+    setParam(key: string, value: AiLightingPresetParamValue): void;
+    getParamValues(): Record<string, AiLightingPresetParamValue>;
+    getPresetState(): AiLightingPresetState;
+    resetKeyboardLayout(): Promise<void>;
+    getKeyElements(): KeyElementRef[];
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hfd-ai-lighting': HfdAiLightingElementInstance;
+        'hfd-ai-lighting-keyboard-overlay': HTMLElement;
+    }
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@hfd-sdk/keyboard-kit",
+  "version": "1.0.0",
+  "description": "HFD keyboard kit",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/keyboard-kit.es.js",
+  "module": "./dist/keyboard-kit.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/keyboard-kit.es.js"
+    },
+    "./ai-lighting": {
+      "types": "./dist/ai-lighting/index.d.ts",
+      "import": "./dist/ai-lighting/index.es.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime.es.js"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && node scripts/clean-dts.js",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "hfd-sdk",
+    "keyboard-kit"
+  ],
+  "author": "htw",
+  "license": "ISC",
+  "peerDependencies": {
+    "@hfd-sdk/keyboard-sdk": "^2.0.2"
+  },
+  "dependencies": {
+    "worker-timers": "^8.0.23"
+  },
+  "devDependencies": {
+    "@hfd-sdk/keyboard-sdk": "^2.0.2",
+    "@iconify/json": "^2.2.510",
+    "@iconify/utils": "^3.1.4",
+    "@types/node": "^22.19.17",
+    "@unocss/preset-rem-to-px": "^66.6.8",
+    "@vitejs/plugin-vue": "^5.2.4",
+    "typescript": "~5.8.3",
+    "unocss": "^66.6.8",
+    "vite": "^6.4.2",
+    "vite-plugin-dts": "^4.5.4",
+    "vue": "^3.5.33",
+    "vue-tsc": "^2.2.12"
+  }
+}