@composy/keyboard-core 0.0.1 → 0.0.2

package/es/managers/keyboard-manager.js

@@ -2,15 +2,15 @@
 * ***********************************
 * @composy/keyboard-core v0.0.1   *
 * Built with rollup               *
-* Build time: 2024-08-17 11:33:29 *
+* Build time: 2024-10-12 17:29:15 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
 */
 import { getLayout } from "../layouts/index.js";
-import { EventEmitter } from "../utils/event-emitter.js";
 import { isMobile, vibrate } from "../utils/device.js";
 import { deleteCharBeforeCursor, getInputCursorPosition, insertTextAtCursor, setInputCursorPosition } from "../utils/dom.js";
+import { EventEmitter } from "../utils/event-emitter.js";
 //#region src/managers/keyboard-manager.ts
 const DEFAULT_OPTIONS = {
 	type: "qwerty",
@@ -22,14 +22,28 @@ const DEFAULT_OPTIONS = {
 	enableVibrate: true,
 	customLayouts: {}
 };
+function normalizeMaxLength(value) {
+	if (value === void 0 || !Number.isFinite(value)) return void 0;
+	return Math.max(0, Math.floor(value));
+}
+function clampValue(value, maxLength) {
+	return maxLength === void 0 ? value : value.slice(0, maxLength);
+}
 var KeyboardManager = class extends EventEmitter {
 	constructor(options = {}) {
 		super();
 		/** 当前布局配置 */
 		this.currentLayout = null;
+		this.destroyed = false;
+		const maxLength = normalizeMaxLength(options.maxLength);
 		this.options = {
 			...DEFAULT_OPTIONS,
-			...options
+			...options,
+			maxLength,
+			customLayouts: {
+				...DEFAULT_OPTIONS.customLayouts,
+				...options.customLayouts ?? {}
+			}
 		};
 		if (options.customLayouts) Object.entries(options.customLayouts).forEach(([name, layout]) => {
 			this.options.customLayouts[name] = layout;
@@ -38,8 +52,8 @@ var KeyboardManager = class extends EventEmitter {
 			visible: false,
 			type: this.options.type,
 			isUpperCase: this.options.defaultUpperCase,
-			value: this.options.value,
-			cursorPosition: this.options.value.length,
+			value: clampValue(this.options.value, this.options.maxLength),
+			cursorPosition: clampValue(this.options.value, this.options.maxLength).length,
 			maxLength: this.options.maxLength,
 			inputElement: null
 		};
@@ -61,7 +75,10 @@ var KeyboardManager = class extends EventEmitter {
 	* 获取配置选项
 	*/
 	getOptions() {
-		return { ...this.options };
+		return {
+			...this.options,
+			customLayouts: { ...this.options.customLayouts }
+		};
 	}
 	/**
 	* 加载键盘布局
@@ -81,7 +98,11 @@ var KeyboardManager = class extends EventEmitter {
 	* 显示键盘
 	*/
 	show(inputElement) {
-		if (this.state.visible) return;
+		if (this.destroyed) return;
+		if (this.state.visible) {
+			if (inputElement && this.state.inputElement !== inputElement) this.bindInput(inputElement);
+			return;
+		}
 		this.state.visible = true;
 		this.state.inputElement = inputElement ?? null;
 		if (inputElement) {
@@ -95,6 +116,7 @@ var KeyboardManager = class extends EventEmitter {
 	* 隐藏键盘
 	*/
 	hide() {
+		if (this.destroyed) return;
 		if (!this.state.visible) return;
 		const prevType = this.state.type;
 		this.state.visible = false;
@@ -106,6 +128,7 @@ var KeyboardManager = class extends EventEmitter {
 	* 切换键盘显示/隐藏
 	*/
 	toggle(inputElement) {
+		if (this.destroyed) return;
 		if (this.state.visible) this.hide();
 		else this.show(inputElement);
 	}
@@ -113,6 +136,7 @@ var KeyboardManager = class extends EventEmitter {
 	* 切换键盘类型
 	*/
 	switchType(type) {
+		if (this.destroyed) return;
 		if (this.state.type === type) return;
 		const fromType = this.state.type;
 		if (!this.loadLayout(type)) return;
@@ -127,6 +151,7 @@ var KeyboardManager = class extends EventEmitter {
 	* 切换大小写
 	*/
 	toggleShift() {
+		if (this.destroyed) return;
 		if (!this.currentLayout?.supportShift) return;
 		this.state.isUpperCase = !this.state.isUpperCase;
 		this.emitStateChange();
@@ -136,6 +161,7 @@ var KeyboardManager = class extends EventEmitter {
 	* 设置大小写状态
 	*/
 	setShift(isUpperCase) {
+		if (this.destroyed) return;
 		if (!this.currentLayout?.supportShift) return;
 		if (this.state.isUpperCase === isUpperCase) return;
 		this.state.isUpperCase = isUpperCase;
@@ -146,6 +172,7 @@ var KeyboardManager = class extends EventEmitter {
 	* 处理按键
 	*/
 	handleKey(key) {
+		if (this.destroyed) return;
 		if (this.options.enableVibrate && isMobile()) vibrate(10);
 		this.emit("keypress", {
 			key,
@@ -191,12 +218,15 @@ var KeyboardManager = class extends EventEmitter {
 			setInputCursorPosition(input, result.cursorPosition);
 			this.state.value = result.value;
 			this.state.cursorPosition = result.cursorPosition;
-			input.dispatchEvent(new Event("input", { bubbles: true }));
+			this.dispatchInputEvent(input);
 		} else {
-			if (this.state.maxLength && this.state.value.length >= this.state.maxLength) return;
-			const newValue = this.state.value.slice(0, this.state.cursorPosition) + keyValue + this.state.value.slice(this.state.cursorPosition);
+			if (this.state.maxLength !== void 0 && this.state.value.length >= this.state.maxLength) return;
+			const availableLength = this.state.maxLength === void 0 ? keyValue.length : this.state.maxLength - this.state.value.length;
+			const valueToInsert = keyValue.slice(0, Math.max(0, availableLength));
+			if (!valueToInsert) return;
+			const newValue = this.state.value.slice(0, this.state.cursorPosition) + valueToInsert + this.state.value.slice(this.state.cursorPosition);
 			this.state.value = newValue;
-			this.state.cursorPosition += keyValue.length;
+			this.state.cursorPosition += valueToInsert.length;
 		}
 		this.emitStateChange();
 		this.emit("input", {
@@ -216,7 +246,7 @@ var KeyboardManager = class extends EventEmitter {
 			setInputCursorPosition(input, result.cursorPosition);
 			this.state.value = result.value;
 			this.state.cursorPosition = result.cursorPosition;
-			input.dispatchEvent(new Event("input", { bubbles: true }));
+			this.dispatchInputEvent(input);
 			this.emitStateChange();
 			this.emit("backspace", {
 				deletedChar: result.deletedChar,
@@ -255,7 +285,7 @@ var KeyboardManager = class extends EventEmitter {
 		const previousValue = this.state.value;
 		if (this.state.inputElement) {
 			this.state.inputElement.value = "";
-			this.state.inputElement.dispatchEvent(new Event("input", { bubbles: true }));
+			this.dispatchInputEvent(this.state.inputElement);
 		}
 		this.state.value = "";
 		this.state.cursorPosition = 0;
@@ -297,11 +327,14 @@ var KeyboardManager = class extends EventEmitter {
 	* 设置值
 	*/
 	setValue(value) {
-		this.state.value = value;
-		this.state.cursorPosition = value.length;
+		if (this.destroyed) return;
+		const nextValue = clampValue(value, this.state.maxLength);
+		this.state.value = nextValue;
+		this.state.cursorPosition = nextValue.length;
 		if (this.state.inputElement) {
-			this.state.inputElement.value = value;
-			setInputCursorPosition(this.state.inputElement, value.length);
+			this.state.inputElement.value = nextValue;
+			setInputCursorPosition(this.state.inputElement, nextValue.length);
+			this.dispatchInputEvent(this.state.inputElement);
 		}
 		this.emitStateChange();
 		this.autoSwitchLicensePlate();
@@ -310,6 +343,7 @@ var KeyboardManager = class extends EventEmitter {
 	* 追加值（在光标位置插入文本）
 	*/
 	appendValue(text) {
+		if (this.destroyed) return;
 		if (!text) return;
 		const input = this.state.inputElement;
 		if (input) {
@@ -318,9 +352,10 @@ var KeyboardManager = class extends EventEmitter {
 			setInputCursorPosition(input, result.cursorPosition);
 			this.state.value = result.value;
 			this.state.cursorPosition = result.cursorPosition;
-			input.dispatchEvent(new Event("input", { bubbles: true }));
+			this.dispatchInputEvent(input);
 		} else {
-			if (this.state.maxLength && this.state.value.length + text.length > this.state.maxLength) text = text.slice(0, this.state.maxLength - this.state.value.length);
+			if (this.state.maxLength !== void 0) text = text.slice(0, Math.max(0, this.state.maxLength - this.state.value.length));
+			if (!text) return;
 			const newValue = this.state.value.slice(0, this.state.cursorPosition) + text + this.state.value.slice(this.state.cursorPosition);
 			this.state.value = newValue;
 			this.state.cursorPosition += text.length;
@@ -331,22 +366,38 @@ var KeyboardManager = class extends EventEmitter {
 	* 设置最大长度
 	*/
 	setMaxLength(maxLength) {
-		this.state.maxLength = maxLength;
+		if (this.destroyed) return;
+		const normalizedMaxLength = normalizeMaxLength(maxLength);
+		this.state.maxLength = normalizedMaxLength;
+		const nextValue = clampValue(this.state.value, normalizedMaxLength);
+		const changed = nextValue !== this.state.value;
+		this.state.value = nextValue;
+		this.state.cursorPosition = Math.min(this.state.cursorPosition, nextValue.length);
+		if (this.state.inputElement && this.state.inputElement.value !== nextValue) {
+			this.state.inputElement.value = nextValue;
+			setInputCursorPosition(this.state.inputElement, this.state.cursorPosition);
+			this.dispatchInputEvent(this.state.inputElement);
+		}
 		this.emitStateChange();
+		if (changed) this.autoSwitchLicensePlate();
 	}
 	/**
 	* 绑定输入框
 	*/
 	bindInput(input) {
+		if (this.destroyed) return;
 		this.state.inputElement = input;
-		this.state.value = input.value;
-		this.state.cursorPosition = getInputCursorPosition(input);
+		const nextValue = clampValue(input.value, this.state.maxLength);
+		if (input.value !== nextValue) input.value = nextValue;
+		this.state.value = nextValue;
+		this.state.cursorPosition = Math.min(getInputCursorPosition(input), nextValue.length);
 		this.emitStateChange();
 	}
 	/**
 	* 解绑输入框
 	*/
 	unbindInput() {
+		if (this.destroyed) return;
 		this.state.inputElement = null;
 		this.emitStateChange();
 	}
@@ -356,13 +407,19 @@ var KeyboardManager = class extends EventEmitter {
 	emitStateChange() {
 		this.emit("stateChange", { ...this.state });
 	}
+	dispatchInputEvent(input) {
+		const EventConstructor = input.ownerDocument.defaultView?.Event ?? Event;
+		input.dispatchEvent(new EventConstructor("input", { bubbles: true }));
+	}
 	/**
 	* 销毁
 	*/
 	destroy() {
+		if (this.destroyed) return;
 		this.hide();
 		this.clear();
 		this.state.inputElement = null;
+		this.destroyed = true;
 	}
 };
 function createKeyboardManager(options) {

package/es/managers/keyboard-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard-manager.js","names":[],"sources":["../../src/managers/keyboard-manager.ts"],"sourcesContent":["/**\n * 键盘管理器\n * @module managers/keyboard-manager\n */\n\nimport type {\n  KeyboardConfig,\n  KeyboardEventMap,\n  KeyboardOptions,\n  KeyboardState,\n  KeyboardType,\n  KeyDefinition,\n} from '../types'\nimport { getLayout } from '../layouts'\nimport { EventEmitter } from '../utils/event-emitter'\nimport { isMobile, vibrate } from '../utils/device'\nimport {\n  deleteCharBeforeCursor,\n  getInputCursorPosition,\n  insertTextAtCursor,\n  setInputCursorPosition,\n} from '../utils/dom'\n\n/**\n * 默认键盘选项\n */\nconst DEFAULT_OPTIONS: Required<KeyboardOptions> = {\n  type: 'qwerty',\n  value: '',\n  maxLength: undefined as unknown as number,\n  defaultUpperCase: false,\n  closeOnClickOutside: true,\n  enableSound: false,\n  enableVibrate: true,\n  customLayouts: {},\n}\n\n/**\n * 键盘管理器类\n * 处理键盘状态管理、输入处理等核心逻辑\n */\nexport class KeyboardManager extends EventEmitter<KeyboardEventMap> {\n  /** 配置选项 */\n  private options: Required<KeyboardOptions>\n\n  /** 当前状态 */\n  private state: KeyboardState\n\n  /** 当前布局配置 */\n  private currentLayout: KeyboardConfig | null = null\n\n  constructor(options: KeyboardOptions = {}) {\n    super()\n    this.options = { ...DEFAULT_OPTIONS, ...options }\n\n    // 注册自定义布局\n    if (options.customLayouts) {\n      Object.entries(options.customLayouts).forEach(([name, layout]) => {\n        // 这里不用 registerLayout 以避免覆盖内置布局的警告\n        this.options.customLayouts[name] = layout\n      })\n    }\n\n    // 初始化状态\n    this.state = {\n      visible: false,\n      type: this.options.type,\n      isUpperCase: this.options.defaultUpperCase,\n      value: this.options.value,\n      cursorPosition: this.options.value.length,\n      maxLength: this.options.maxLength,\n      inputElement: null,\n    }\n\n    // 加载初始布局\n    this.loadLayout(this.options.type)\n  }\n\n  /**\n   * 获取当前状态\n   */\n  getState(): Readonly<KeyboardState> {\n    return { ...this.state }\n  }\n\n  /**\n   * 获取当前布局配置\n   */\n  getLayout(): KeyboardConfig | null {\n    return this.currentLayout\n  }\n\n  /**\n   * 获取配置选项\n   */\n  getOptions(): Readonly<Required<KeyboardOptions>> {\n    return { ...this.options }\n  }\n\n  /**\n   * 加载键盘布局\n   */\n  private loadLayout(type: KeyboardType | string): boolean {\n    // 先从自定义布局查找\n    let layout = this.options.customLayouts[type]\n\n    // 再从内置布局查找\n    if (!layout) {\n      layout = getLayout(type) as KeyboardConfig\n    }\n\n    if (!layout) {\n      console.error(`[KeyboardManager] Layout \"${type}\" not found`)\n      return false\n    }\n\n    this.currentLayout = layout\n\n    // 更新大小写状态\n    if (layout.supportShift) {\n      this.state.isUpperCase = layout.defaultUpperCase ?? this.options.defaultUpperCase\n    }\n\n    return true\n  }\n\n  /**\n   * 显示键盘\n   */\n  show(inputElement?: HTMLInputElement | HTMLTextAreaElement): void {\n    if (this.state.visible) return\n\n    this.state.visible = true\n    this.state.inputElement = inputElement ?? null\n\n    // 同步输入框的值\n    if (inputElement) {\n      this.state.value = inputElement.value\n      this.state.cursorPosition = getInputCursorPosition(inputElement)\n    }\n\n    this.emitStateChange()\n    this.emit('show', { type: this.state.type })\n  }\n\n  /**\n   * 隐藏键盘\n   */\n  hide(): void {\n    if (!this.state.visible) return\n\n    const prevType = this.state.type\n    this.state.visible = false\n    this.state.inputElement = null\n\n    this.emitStateChange()\n    this.emit('hide', { type: prevType })\n  }\n\n  /**\n   * 切换键盘显示/隐藏\n   */\n  toggle(inputElement?: HTMLInputElement | HTMLTextAreaElement): void {\n    if (this.state.visible) {\n      this.hide()\n    }\n    else {\n      this.show(inputElement)\n    }\n  }\n\n  /**\n   * 切换键盘类型\n   */\n  switchType(type: KeyboardType | string): void {\n    if (this.state.type === type) return\n\n    const fromType = this.state.type\n    if (!this.loadLayout(type)) return\n\n    this.state.type = type as KeyboardType\n\n    this.emitStateChange()\n    this.emit('switch', { from: fromType, to: type as KeyboardType })\n  }\n\n  /**\n   * 切换大小写\n   */\n  toggleShift(): void {\n    if (!this.currentLayout?.supportShift) return\n\n    this.state.isUpperCase = !this.state.isUpperCase\n    this.emitStateChange()\n    this.emit('shift', { isUpperCase: this.state.isUpperCase })\n  }\n\n  /**\n   * 设置大小写状态\n   */\n  setShift(isUpperCase: boolean): void {\n    if (!this.currentLayout?.supportShift) return\n    if (this.state.isUpperCase === isUpperCase) return\n\n    this.state.isUpperCase = isUpperCase\n    this.emitStateChange()\n    this.emit('shift', { isUpperCase })\n  }\n\n  /**\n   * 处理按键\n   */\n  handleKey(key: KeyDefinition): void {\n    // 触发震动反馈\n    if (this.options.enableVibrate && isMobile()) {\n      vibrate(10)\n    }\n\n    this.emit('keypress', { key, value: this.state.value })\n\n    switch (key.type) {\n      case 'char':\n      case 'space':\n        this.handleCharKey(key)\n        break\n      case 'backspace':\n        this.handleBackspace()\n        break\n      case 'shift':\n        this.toggleShift()\n        break\n      case 'clear':\n        this.handleClear()\n        break\n      case 'enter':\n      case 'done':\n        this.handleConfirm()\n        break\n      case 'close':\n        this.hide()\n        break\n      case 'tab':\n        this.handleTab(key)\n        break\n      case 'custom':\n        // 自定义按键，只触发事件\n        break\n    }\n  }\n\n  /**\n   * 处理字符输入\n   */\n  private handleCharKey(key: KeyDefinition): void {\n    const keyValue = this.getKeyValue(key)\n    if (!keyValue) return\n\n    const input = this.state.inputElement\n\n    if (input) {\n      // 如果有绑定输入框，直接操作输入框\n      const result = insertTextAtCursor(input, keyValue, this.state.maxLength)\n      input.value = result.value\n      setInputCursorPosition(input, result.cursorPosition)\n      this.state.value = result.value\n      this.state.cursorPosition = result.cursorPosition\n\n      // 触发原生 input 事件\n      input.dispatchEvent(new Event('input', { bubbles: true }))\n    }\n    else {\n      // 没有输入框，直接修改内部值\n      if (this.state.maxLength && this.state.value.length >= this.state.maxLength) {\n        return\n      }\n      const newValue = this.state.value.slice(0, this.state.cursorPosition)\n        + keyValue\n        + this.state.value.slice(this.state.cursorPosition)\n      this.state.value = newValue\n      this.state.cursorPosition += keyValue.length\n    }\n\n    this.emitStateChange()\n    this.emit('input', { value: this.state.value, key })\n\n    // 车牌号智能切换\n    this.autoSwitchLicensePlate()\n  }\n\n  /**\n   * 处理退格\n   */\n  private handleBackspace(): void {\n    const input = this.state.inputElement\n\n    if (input) {\n      const result = deleteCharBeforeCursor(input)\n      input.value = result.value\n      setInputCursorPosition(input, result.cursorPosition)\n      this.state.value = result.value\n      this.state.cursorPosition = result.cursorPosition\n\n      // 触发原生 input 事件\n      input.dispatchEvent(new Event('input', { bubbles: true }))\n\n      this.emitStateChange()\n      this.emit('backspace', { deletedChar: result.deletedChar, value: this.state.value })\n    }\n    else {\n      if (this.state.cursorPosition === 0) return\n\n      const deletedChar = this.state.value.charAt(this.state.cursorPosition - 1)\n      this.state.value = this.state.value.slice(0, this.state.cursorPosition - 1)\n        + this.state.value.slice(this.state.cursorPosition)\n      this.state.cursorPosition--\n\n      this.emitStateChange()\n      this.emit('backspace', { deletedChar, value: this.state.value })\n    }\n\n    // 车牌号智能切换\n    this.autoSwitchLicensePlate()\n  }\n\n  /**\n   * 车牌号智能切换逻辑\n   * 根据当前值长度自动切换键盘布局\n   * 只有 2 种布局：省份键盘（第1位）和 字母+数字混合键盘（第2-8位）\n   */\n  private autoSwitchLicensePlate(): void {\n    // 只在车牌键盘类型时生效\n    if (!this.state.type.startsWith('license-plate')) return\n\n    const len = this.state.value.length\n    let targetType: string | null = null\n\n    if (len === 0) {\n      // 第1位：省份简称\n      targetType = 'license-plate-province'\n    }\n    else {\n      // 第2-8位：字母+数字混合键盘\n      // （第2位虽然只能输入字母，但显示混合键盘，用户自己知道不能输入数字）\n      targetType = 'license-plate-alphanumeric'\n    }\n\n    // 如果需要切换\n    if (targetType && this.state.type !== targetType) {\n      this.switchType(targetType)\n    }\n  }\n\n  /**\n   * 处理清空\n   */\n  private handleClear(): void {\n    const previousValue = this.state.value\n\n    if (this.state.inputElement) {\n      this.state.inputElement.value = ''\n      this.state.inputElement.dispatchEvent(new Event('input', { bubbles: true }))\n    }\n\n    this.state.value = ''\n    this.state.cursorPosition = 0\n\n    this.emitStateChange()\n    this.emit('clear', { previousValue })\n    \n    // 车牌号智能切换\n    this.autoSwitchLicensePlate()\n  }\n\n  /**\n   * 处理确认\n   */\n  private handleConfirm(): void {\n    this.emit('confirm', { value: this.state.value })\n    this.hide()\n  }\n\n  /**\n   * 处理切换键盘\n   */\n  private handleTab(key: KeyDefinition): void {\n    const targetType = key.data?.targetType as KeyboardType | string | undefined\n    if (targetType) {\n      this.switchType(targetType)\n    }\n  }\n\n  /**\n   * 获取按键的实际输出值\n   */\n  private getKeyValue(key: KeyDefinition): string {\n    const value = key.value ?? key.label\n\n    if (typeof value === 'string') {\n      return value\n    }\n\n    return this.state.isUpperCase ? value.upper : value.lower\n  }\n\n  /**\n   * 获取按键的显示文本\n   */\n  getKeyLabel(key: KeyDefinition): string {\n    const label = key.label\n\n    if (typeof label === 'string') {\n      return label\n    }\n\n    return this.state.isUpperCase ? label.upper : label.lower\n  }\n\n  /**\n   * 设置值\n   */\n  setValue(value: string): void {\n    this.state.value = value\n    this.state.cursorPosition = value.length\n\n    if (this.state.inputElement) {\n      this.state.inputElement.value = value\n      setInputCursorPosition(this.state.inputElement, value.length)\n    }\n\n    this.emitStateChange()\n    \n    // 车牌号智能切换\n    this.autoSwitchLicensePlate()\n  }\n\n  /**\n   * 追加值（在光标位置插入文本）\n   */\n  appendValue(text: string): void {\n    if (!text) return\n\n    const input = this.state.inputElement\n\n    if (input) {\n      const result = insertTextAtCursor(input, text, this.state.maxLength)\n      input.value = result.value\n      setInputCursorPosition(input, result.cursorPosition)\n      this.state.value = result.value\n      this.state.cursorPosition = result.cursorPosition\n\n      // 触发原生 input 事件\n      input.dispatchEvent(new Event('input', { bubbles: true }))\n    }\n    else {\n      if (this.state.maxLength && this.state.value.length + text.length > this.state.maxLength) {\n        text = text.slice(0, this.state.maxLength - this.state.value.length)\n      }\n      const newValue = this.state.value.slice(0, this.state.cursorPosition)\n        + text\n        + this.state.value.slice(this.state.cursorPosition)\n      this.state.value = newValue\n      this.state.cursorPosition += text.length\n    }\n\n    this.emitStateChange()\n  }\n\n  /**\n   * 设置最大长度\n   */\n  setMaxLength(maxLength?: number): void {\n    this.state.maxLength = maxLength\n    this.emitStateChange()\n  }\n\n  /**\n   * 绑定输入框\n   */\n  bindInput(input: HTMLInputElement | HTMLTextAreaElement): void {\n    this.state.inputElement = input\n    this.state.value = input.value\n    this.state.cursorPosition = getInputCursorPosition(input)\n    this.emitStateChange()\n  }\n\n  /**\n   * 解绑输入框\n   */\n  unbindInput(): void {\n    this.state.inputElement = null\n    this.emitStateChange()\n  }\n\n  /**\n   * 发送状态变化事件\n   */\n  private emitStateChange(): void {\n    this.emit('stateChange', { ...this.state })\n  }\n\n  /**\n   * 销毁\n   */\n  destroy(): void {\n    this.hide()\n    this.clear()\n    this.state.inputElement = null\n  }\n}\n\n/**\n * 创建键盘管理器实例\n */\nexport function createKeyboardManager(options?: KeyboardOptions): KeyboardManager {\n  return new KeyboardManager(options)\n}\n"],"mappings":";;;;;;;;;;;;;;AA0BA,MAAM,kBAA6C;CACjD,MAAM;CACN,OAAO;CACP,WAAW,KAAA;CACX,kBAAkB;CAClB,qBAAqB;CACrB,aAAa;CACb,eAAe;CACf,eAAe,CAAC;AAClB;AAMO,IAAM,kBAAN,cAA8B,aAA+B;CAUlE,YAAY,UAA2B,CAAC,GAAG;EACzC,MAAM;;EAHR,KAAQ,gBAAuC;EAI7C,KAAK,UAAU;GAAE,GAAG;GAAiB,GAAG;EAAQ;EAGhD,IAAI,QAAQ,eACV,OAAO,QAAQ,QAAQ,aAAa,CAAA,CAAE,SAAS,CAAC,MAAM,YAAY;GAEhE,KAAK,QAAQ,cAAc,QAAQ;EACrC,CAAC;EAIH,KAAK,QAAQ;GACX,SAAS;GACT,MAAM,KAAK,QAAQ;GACnB,aAAa,KAAK,QAAQ;GAC1B,OAAO,KAAK,QAAQ;GACpB,gBAAgB,KAAK,QAAQ,MAAM;GACnC,WAAW,KAAK,QAAQ;GACxB,cAAc;EAChB;EAGA,KAAK,WAAW,KAAK,QAAQ,IAAI;CACnC;;;;CAKA,WAAoC;EAClC,OAAO,EAAE,GAAG,KAAK,MAAM;CACzB;;;;CAKA,YAAmC;EACjC,OAAO,KAAK;CACd;;;;CAKA,aAAkD;EAChD,OAAO,EAAE,GAAG,KAAK,QAAQ;CAC3B;;;;CAKQ,WAAW,MAAsC;EAEvD,IAAI,SAAS,KAAK,QAAQ,cAAc;EAGxC,IAAI,CAAC,QACH,SAAS,UAAU,IAAI;EAGzB,IAAI,CAAC,QAAQ;GACX,QAAQ,MAAM,6BAA6B,KAAI,YAAa;GAC5D,OAAO;EACT;EAEA,KAAK,gBAAgB;EAGrB,IAAI,OAAO,cACT,KAAK,MAAM,cAAc,OAAO,oBAAoB,KAAK,QAAQ;EAGnE,OAAO;CACT;;;;CAKA,KAAK,cAA6D;EAChE,IAAI,KAAK,MAAM,SAAS;EAExB,KAAK,MAAM,UAAU;EACrB,KAAK,MAAM,eAAe,gBAAgB;EAG1C,IAAI,cAAc;GAChB,KAAK,MAAM,QAAQ,aAAa;GAChC,KAAK,MAAM,iBAAiB,uBAAuB,YAAY;EACjE;EAEA,KAAK,gBAAgB;EACrB,KAAK,KAAK,QAAQ,EAAE,MAAM,KAAK,MAAM,KAAK,CAAC;CAC7C;;;;CAKA,OAAa;EACX,IAAI,CAAC,KAAK,MAAM,SAAS;EAEzB,MAAM,WAAW,KAAK,MAAM;EAC5B,KAAK,MAAM,UAAU;EACrB,KAAK,MAAM,eAAe;EAE1B,KAAK,gBAAgB;EACrB,KAAK,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;CACtC;;;;CAKA,OAAO,cAA6D;EAClE,IAAI,KAAK,MAAM,SACb,KAAK,KAAK;OAGV,KAAK,KAAK,YAAY;CAE1B;;;;CAKA,WAAW,MAAmC;EAC5C,IAAI,KAAK,MAAM,SAAS,MAAM;EAE9B,MAAM,WAAW,KAAK,MAAM;EAC5B,IAAI,CAAC,KAAK,WAAW,IAAI,GAAG;EAE5B,KAAK,MAAM,OAAO;EAElB,KAAK,gBAAgB;EACrB,KAAK,KAAK,UAAU;GAAE,MAAM;GAAU,IAAI;EAAqB,CAAC;CAClE;;;;CAKA,cAAoB;EAClB,IAAI,CAAC,KAAK,eAAe,cAAc;EAEvC,KAAK,MAAM,cAAc,CAAC,KAAK,MAAM;EACrC,KAAK,gBAAgB;EACrB,KAAK,KAAK,SAAS,EAAE,aAAa,KAAK,MAAM,YAAY,CAAC;CAC5D;;;;CAKA,SAAS,aAA4B;EACnC,IAAI,CAAC,KAAK,eAAe,cAAc;EACvC,IAAI,KAAK,MAAM,gBAAgB,aAAa;EAE5C,KAAK,MAAM,cAAc;EACzB,KAAK,gBAAgB;EACrB,KAAK,KAAK,SAAS,EAAE,YAAY,CAAC;CACpC;;;;CAKA,UAAU,KAA0B;EAElC,IAAI,KAAK,QAAQ,iBAAiB,SAAS,GACzC,QAAQ,EAAE;EAGZ,KAAK,KAAK,YAAY;GAAE;GAAK,OAAO,KAAK,MAAM;EAAM,CAAC;EAEtD,QAAQ,IAAI,MAAZ;GACE,KAAK;GACL,KAAK;IACH,KAAK,cAAc,GAAG;IACtB;GACF,KAAK;IACH,KAAK,gBAAgB;IACrB;GACF,KAAK;IACH,KAAK,YAAY;IACjB;GACF,KAAK;IACH,KAAK,YAAY;IACjB;GACF,KAAK;GACL,KAAK;IACH,KAAK,cAAc;IACnB;GACF,KAAK;IACH,KAAK,KAAK;IACV;GACF,KAAK;IACH,KAAK,UAAU,GAAG;IAClB;GACF,KAAK,UAEH;EACJ;CACF;;;;CAKQ,cAAc,KAA0B;EAC9C,MAAM,WAAW,KAAK,YAAY,GAAG;EACrC,IAAI,CAAC,UAAU;EAEf,MAAM,QAAQ,KAAK,MAAM;EAEzB,IAAI,OAAO;GAET,MAAM,SAAS,mBAAmB,OAAO,UAAU,KAAK,MAAM,SAAS;GACvE,MAAM,QAAQ,OAAO;GACrB,uBAAuB,OAAO,OAAO,cAAc;GACnD,KAAK,MAAM,QAAQ,OAAO;GAC1B,KAAK,MAAM,iBAAiB,OAAO;GAGnC,MAAM,cAAc,IAAI,MAAM,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;EAC3D,OACK;GAEH,IAAI,KAAK,MAAM,aAAa,KAAK,MAAM,MAAM,UAAU,KAAK,MAAM,WAChE;GAEF,MAAM,WAAW,KAAK,MAAM,MAAM,MAAM,GAAG,KAAK,MAAM,cAAc,IAChE,WACA,KAAK,MAAM,MAAM,MAAM,KAAK,MAAM,cAAc;GACpD,KAAK,MAAM,QAAQ;GACnB,KAAK,MAAM,kBAAkB,SAAS;EACxC;EAEA,KAAK,gBAAgB;EACrB,KAAK,KAAK,SAAS;GAAE,OAAO,KAAK,MAAM;GAAO;EAAI,CAAC;EAGnD,KAAK,uBAAuB;CAC9B;;;;CAKQ,kBAAwB;EAC9B,MAAM,QAAQ,KAAK,MAAM;EAEzB,IAAI,OAAO;GACT,MAAM,SAAS,uBAAuB,KAAK;GAC3C,MAAM,QAAQ,OAAO;GACrB,uBAAuB,OAAO,OAAO,cAAc;GACnD,KAAK,MAAM,QAAQ,OAAO;GAC1B,KAAK,MAAM,iBAAiB,OAAO;GAGnC,MAAM,cAAc,IAAI,MAAM,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;GAEzD,KAAK,gBAAgB;GACrB,KAAK,KAAK,aAAa;IAAE,aAAa,OAAO;IAAa,OAAO,KAAK,MAAM;GAAM,CAAC;EACrF,OACK;GACH,IAAI,KAAK,MAAM,mBAAmB,GAAG;GAErC,MAAM,cAAc,KAAK,MAAM,MAAM,OAAO,KAAK,MAAM,iBAAiB,CAAC;GACzE,KAAK,MAAM,QAAQ,KAAK,MAAM,MAAM,MAAM,GAAG,KAAK,MAAM,iBAAiB,CAAC,IACtE,KAAK,MAAM,MAAM,MAAM,KAAK,MAAM,cAAc;GACpD,KAAK,MAAM;GAEX,KAAK,gBAAgB;GACrB,KAAK,KAAK,aAAa;IAAE;IAAa,OAAO,KAAK,MAAM;GAAM,CAAC;EACjE;EAGA,KAAK,uBAAuB;CAC9B;;;;;;CAOQ,yBAA+B;EAErC,IAAI,CAAC,KAAK,MAAM,KAAK,WAAW,eAAe,GAAG;EAElD,MAAM,MAAM,KAAK,MAAM,MAAM;EAC7B,IAAI,aAA4B;EAEhC,IAAI,QAAQ,GAEV,aAAa;OAKb,aAAa;EAIf,IAAI,cAAc,KAAK,MAAM,SAAS,YACpC,KAAK,WAAW,UAAU;CAE9B;;;;CAKQ,cAAoB;EAC1B,MAAM,gBAAgB,KAAK,MAAM;EAEjC,IAAI,KAAK,MAAM,cAAc;GAC3B,KAAK,MAAM,aAAa,QAAQ;GAChC,KAAK,MAAM,aAAa,cAAc,IAAI,MAAM,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;EAC7E;EAEA,KAAK,MAAM,QAAQ;EACnB,KAAK,MAAM,iBAAiB;EAE5B,KAAK,gBAAgB;EACrB,KAAK,KAAK,SAAS,EAAE,cAAc,CAAC;EAGpC,KAAK,uBAAuB;CAC9B;;;;CAKQ,gBAAsB;EAC5B,KAAK,KAAK,WAAW,EAAE,OAAO,KAAK,MAAM,MAAM,CAAC;EAChD,KAAK,KAAK;CACZ;;;;CAKQ,UAAU,KAA0B;EAC1C,MAAM,aAAa,IAAI,MAAM;EAC7B,IAAI,YACF,KAAK,WAAW,UAAU;CAE9B;;;;CAKQ,YAAY,KAA4B;EAC9C,MAAM,QAAQ,IAAI,SAAS,IAAI;EAE/B,IAAI,OAAO,UAAU,UACnB,OAAO;EAGT,OAAO,KAAK,MAAM,cAAc,MAAM,QAAQ,MAAM;CACtD;;;;CAKA,YAAY,KAA4B;EACtC,MAAM,QAAQ,IAAI;EAElB,IAAI,OAAO,UAAU,UACnB,OAAO;EAGT,OAAO,KAAK,MAAM,cAAc,MAAM,QAAQ,MAAM;CACtD;;;;CAKA,SAAS,OAAqB;EAC5B,KAAK,MAAM,QAAQ;EACnB,KAAK,MAAM,iBAAiB,MAAM;EAElC,IAAI,KAAK,MAAM,cAAc;GAC3B,KAAK,MAAM,aAAa,QAAQ;GAChC,uBAAuB,KAAK,MAAM,cAAc,MAAM,MAAM;EAC9D;EAEA,KAAK,gBAAgB;EAGrB,KAAK,uBAAuB;CAC9B;;;;CAKA,YAAY,MAAoB;EAC9B,IAAI,CAAC,MAAM;EAEX,MAAM,QAAQ,KAAK,MAAM;EAEzB,IAAI,OAAO;GACT,MAAM,SAAS,mBAAmB,OAAO,MAAM,KAAK,MAAM,SAAS;GACnE,MAAM,QAAQ,OAAO;GACrB,uBAAuB,OAAO,OAAO,cAAc;GACnD,KAAK,MAAM,QAAQ,OAAO;GAC1B,KAAK,MAAM,iBAAiB,OAAO;GAGnC,MAAM,cAAc,IAAI,MAAM,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;EAC3D,OACK;GACH,IAAI,KAAK,MAAM,aAAa,KAAK,MAAM,MAAM,SAAS,KAAK,SAAS,KAAK,MAAM,WAC7E,OAAO,KAAK,MAAM,GAAG,KAAK,MAAM,YAAY,KAAK,MAAM,MAAM,MAAM;GAErE,MAAM,WAAW,KAAK,MAAM,MAAM,MAAM,GAAG,KAAK,MAAM,cAAc,IAChE,OACA,KAAK,MAAM,MAAM,MAAM,KAAK,MAAM,cAAc;GACpD,KAAK,MAAM,QAAQ;GACnB,KAAK,MAAM,kBAAkB,KAAK;EACpC;EAEA,KAAK,gBAAgB;CACvB;;;;CAKA,aAAa,WAA0B;EACrC,KAAK,MAAM,YAAY;EACvB,KAAK,gBAAgB;CACvB;;;;CAKA,UAAU,OAAqD;EAC7D,KAAK,MAAM,eAAe;EAC1B,KAAK,MAAM,QAAQ,MAAM;EACzB,KAAK,MAAM,iBAAiB,uBAAuB,KAAK;EACxD,KAAK,gBAAgB;CACvB;;;;CAKA,cAAoB;EAClB,KAAK,MAAM,eAAe;EAC1B,KAAK,gBAAgB;CACvB;;;;CAKQ,kBAAwB;EAC9B,KAAK,KAAK,eAAe,EAAE,GAAG,KAAK,MAAM,CAAC;CAC5C;;;;CAKA,UAAgB;EACd,KAAK,KAAK;EACV,KAAK,MAAM;EACX,KAAK,MAAM,eAAe;CAC5B;AACF;AAKO,SAAS,sBAAsB,SAA4C;CAChF,OAAO,IAAI,gBAAgB,OAAO;AACpC"}
+{"version":3,"file":"keyboard-manager.js","names":[],"sources":["../../src/managers/keyboard-manager.ts"],"sourcesContent":["/**\r\n * 键盘管理器\r\n * @module managers/keyboard-manager\r\n */\r\n\r\nimport type {\r\n  KeyboardConfig,\r\n  KeyboardEventMap,\r\n  KeyboardOptions,\r\n  KeyboardState,\r\n  KeyboardType,\r\n  KeyDefinition,\r\n} from '../types'\r\nimport { getLayout } from '../layouts'\r\nimport { isMobile, vibrate } from '../utils/device'\r\nimport {\r\n  deleteCharBeforeCursor,\r\n  getInputCursorPosition,\r\n  insertTextAtCursor,\r\n  setInputCursorPosition,\r\n} from '../utils/dom'\r\nimport { EventEmitter } from '../utils/event-emitter'\r\n\r\n/**\r\n * 默认键盘选项\r\n */\r\nconst DEFAULT_OPTIONS: Required<KeyboardOptions> = {\r\n  type: 'qwerty',\r\n  value: '',\r\n  maxLength: undefined as unknown as number,\r\n  defaultUpperCase: false,\r\n  closeOnClickOutside: true,\r\n  enableSound: false,\r\n  enableVibrate: true,\r\n  customLayouts: {},\r\n}\r\n\r\nfunction normalizeMaxLength(value: number | undefined): number | undefined {\r\n  if (value === undefined || !Number.isFinite(value)) return undefined\r\n  return Math.max(0, Math.floor(value))\r\n}\r\n\r\nfunction clampValue(value: string, maxLength: number | undefined): string {\r\n  return maxLength === undefined ? value : value.slice(0, maxLength)\r\n}\r\n\r\n/**\r\n * 键盘管理器类\r\n * 处理键盘状态管理、输入处理等核心逻辑\r\n */\r\nexport class KeyboardManager extends EventEmitter<KeyboardEventMap> {\r\n  /** 配置选项 */\r\n  private options: Required<KeyboardOptions>\r\n\r\n  /** 当前状态 */\r\n  private state: KeyboardState\r\n\r\n  /** 当前布局配置 */\r\n  private currentLayout: KeyboardConfig | null = null\r\n\r\n  private destroyed = false\r\n\r\n  constructor(options: KeyboardOptions = {}) {\r\n    super()\r\n    const maxLength = normalizeMaxLength(options.maxLength)\r\n    this.options = {\r\n      ...DEFAULT_OPTIONS,\r\n      ...options,\r\n      maxLength,\r\n      customLayouts: {\r\n        ...DEFAULT_OPTIONS.customLayouts,\r\n        ...(options.customLayouts ?? {}),\r\n      },\r\n    }\r\n\r\n    // 注册自定义布局\r\n    if (options.customLayouts) {\r\n      Object.entries(options.customLayouts).forEach(([name, layout]) => {\r\n        // 这里不用 registerLayout 以避免覆盖内置布局的警告\r\n        this.options.customLayouts[name] = layout\r\n      })\r\n    }\r\n\r\n    // 初始化状态\r\n    this.state = {\r\n      visible: false,\r\n      type: this.options.type,\r\n      isUpperCase: this.options.defaultUpperCase,\r\n      value: clampValue(this.options.value, this.options.maxLength),\r\n      cursorPosition: clampValue(this.options.value, this.options.maxLength)\r\n        .length,\r\n      maxLength: this.options.maxLength,\r\n      inputElement: null,\r\n    }\r\n\r\n    // 加载初始布局\r\n    this.loadLayout(this.options.type)\r\n  }\r\n\r\n  /**\r\n   * 获取当前状态\r\n   */\r\n  getState(): Readonly<KeyboardState> {\r\n    return { ...this.state }\r\n  }\r\n\r\n  /**\r\n   * 获取当前布局配置\r\n   */\r\n  getLayout(): KeyboardConfig | null {\r\n    return this.currentLayout\r\n  }\r\n\r\n  /**\r\n   * 获取配置选项\r\n   */\r\n  getOptions(): Readonly<Required<KeyboardOptions>> {\r\n    return { ...this.options, customLayouts: { ...this.options.customLayouts } }\r\n  }\r\n\r\n  /**\r\n   * 加载键盘布局\r\n   */\r\n  private loadLayout(type: KeyboardType | string): boolean {\r\n    // 先从自定义布局查找\r\n    let layout = this.options.customLayouts[type]\r\n\r\n    // 再从内置布局查找\r\n    if (!layout) {\r\n      layout = getLayout(type) as KeyboardConfig\r\n    }\r\n\r\n    if (!layout) {\r\n      console.error(`[KeyboardManager] Layout \"${type}\" not found`)\r\n      return false\r\n    }\r\n\r\n    this.currentLayout = layout\r\n\r\n    // 更新大小写状态\r\n    if (layout.supportShift) {\r\n      this.state.isUpperCase =\r\n        layout.defaultUpperCase ?? this.options.defaultUpperCase\r\n    }\r\n\r\n    return true\r\n  }\r\n\r\n  /**\r\n   * 显示键盘\r\n   */\r\n  show(inputElement?: HTMLInputElement | HTMLTextAreaElement): void {\r\n    if (this.destroyed) return\r\n    if (this.state.visible) {\r\n      if (inputElement && this.state.inputElement !== inputElement) {\r\n        this.bindInput(inputElement)\r\n      }\r\n      return\r\n    }\r\n\r\n    this.state.visible = true\r\n    this.state.inputElement = inputElement ?? null\r\n\r\n    // 同步输入框的值\r\n    if (inputElement) {\r\n      this.state.value = inputElement.value\r\n      this.state.cursorPosition = getInputCursorPosition(inputElement)\r\n    }\r\n\r\n    this.emitStateChange()\r\n    this.emit('show', { type: this.state.type })\r\n  }\r\n\r\n  /**\r\n   * 隐藏键盘\r\n   */\r\n  hide(): void {\r\n    if (this.destroyed) return\r\n    if (!this.state.visible) return\r\n\r\n    const prevType = this.state.type\r\n    this.state.visible = false\r\n    this.state.inputElement = null\r\n\r\n    this.emitStateChange()\r\n    this.emit('hide', { type: prevType })\r\n  }\r\n\r\n  /**\r\n   * 切换键盘显示/隐藏\r\n   */\r\n  toggle(inputElement?: HTMLInputElement | HTMLTextAreaElement): void {\r\n    if (this.destroyed) return\r\n    if (this.state.visible) {\r\n      this.hide()\r\n    } else {\r\n      this.show(inputElement)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 切换键盘类型\r\n   */\r\n  switchType(type: KeyboardType | string): void {\r\n    if (this.destroyed) return\r\n    if (this.state.type === type) return\r\n\r\n    const fromType = this.state.type\r\n    if (!this.loadLayout(type)) return\r\n\r\n    this.state.type = type as KeyboardType\r\n\r\n    this.emitStateChange()\r\n    this.emit('switch', { from: fromType, to: type as KeyboardType })\r\n  }\r\n\r\n  /**\r\n   * 切换大小写\r\n   */\r\n  toggleShift(): void {\r\n    if (this.destroyed) return\r\n    if (!this.currentLayout?.supportShift) return\r\n\r\n    this.state.isUpperCase = !this.state.isUpperCase\r\n    this.emitStateChange()\r\n    this.emit('shift', { isUpperCase: this.state.isUpperCase })\r\n  }\r\n\r\n  /**\r\n   * 设置大小写状态\r\n   */\r\n  setShift(isUpperCase: boolean): void {\r\n    if (this.destroyed) return\r\n    if (!this.currentLayout?.supportShift) return\r\n    if (this.state.isUpperCase === isUpperCase) return\r\n\r\n    this.state.isUpperCase = isUpperCase\r\n    this.emitStateChange()\r\n    this.emit('shift', { isUpperCase })\r\n  }\r\n\r\n  /**\r\n   * 处理按键\r\n   */\r\n  handleKey(key: KeyDefinition): void {\r\n    if (this.destroyed) return\r\n    // 触发震动反馈\r\n    if (this.options.enableVibrate && isMobile()) {\r\n      vibrate(10)\r\n    }\r\n\r\n    this.emit('keypress', { key, value: this.state.value })\r\n\r\n    switch (key.type) {\r\n      case 'char':\r\n      case 'space':\r\n        this.handleCharKey(key)\r\n        break\r\n      case 'backspace':\r\n        this.handleBackspace()\r\n        break\r\n      case 'shift':\r\n        this.toggleShift()\r\n        break\r\n      case 'clear':\r\n        this.handleClear()\r\n        break\r\n      case 'enter':\r\n      case 'done':\r\n        this.handleConfirm()\r\n        break\r\n      case 'close':\r\n        this.hide()\r\n        break\r\n      case 'tab':\r\n        this.handleTab(key)\r\n        break\r\n      case 'custom':\r\n        // 自定义按键，只触发事件\r\n        break\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 处理字符输入\r\n   */\r\n  private handleCharKey(key: KeyDefinition): void {\r\n    const keyValue = this.getKeyValue(key)\r\n    if (!keyValue) return\r\n\r\n    const input = this.state.inputElement\r\n\r\n    if (input) {\r\n      // 如果有绑定输入框，直接操作输入框\r\n      const result = insertTextAtCursor(input, keyValue, this.state.maxLength)\r\n      input.value = result.value\r\n      setInputCursorPosition(input, result.cursorPosition)\r\n      this.state.value = result.value\r\n      this.state.cursorPosition = result.cursorPosition\r\n\r\n      // 触发原生 input 事件\r\n      this.dispatchInputEvent(input)\r\n    } else {\r\n      // 没有输入框，直接修改内部值\r\n      if (\r\n        this.state.maxLength !== undefined &&\r\n        this.state.value.length >= this.state.maxLength\r\n      ) {\r\n        return\r\n      }\r\n      const availableLength =\r\n        this.state.maxLength === undefined\r\n          ? keyValue.length\r\n          : this.state.maxLength - this.state.value.length\r\n      const valueToInsert = keyValue.slice(0, Math.max(0, availableLength))\r\n      if (!valueToInsert) return\r\n      const newValue =\r\n        this.state.value.slice(0, this.state.cursorPosition) +\r\n        valueToInsert +\r\n        this.state.value.slice(this.state.cursorPosition)\r\n      this.state.value = newValue\r\n      this.state.cursorPosition += valueToInsert.length\r\n    }\r\n\r\n    this.emitStateChange()\r\n    this.emit('input', { value: this.state.value, key })\r\n\r\n    // 车牌号智能切换\r\n    this.autoSwitchLicensePlate()\r\n  }\r\n\r\n  /**\r\n   * 处理退格\r\n   */\r\n  private handleBackspace(): void {\r\n    const input = this.state.inputElement\r\n\r\n    if (input) {\r\n      const result = deleteCharBeforeCursor(input)\r\n      input.value = result.value\r\n      setInputCursorPosition(input, result.cursorPosition)\r\n      this.state.value = result.value\r\n      this.state.cursorPosition = result.cursorPosition\r\n\r\n      // 触发原生 input 事件\r\n      this.dispatchInputEvent(input)\r\n\r\n      this.emitStateChange()\r\n      this.emit('backspace', {\r\n        deletedChar: result.deletedChar,\r\n        value: this.state.value,\r\n      })\r\n    } else {\r\n      if (this.state.cursorPosition === 0) return\r\n\r\n      const deletedChar = this.state.value.charAt(this.state.cursorPosition - 1)\r\n      this.state.value =\r\n        this.state.value.slice(0, this.state.cursorPosition - 1) +\r\n        this.state.value.slice(this.state.cursorPosition)\r\n      this.state.cursorPosition--\r\n\r\n      this.emitStateChange()\r\n      this.emit('backspace', { deletedChar, value: this.state.value })\r\n    }\r\n\r\n    // 车牌号智能切换\r\n    this.autoSwitchLicensePlate()\r\n  }\r\n\r\n  /**\r\n   * 车牌号智能切换逻辑\r\n   * 根据当前值长度自动切换键盘布局\r\n   * 只有 2 种布局：省份键盘（第1位）和 字母+数字混合键盘（第2-8位）\r\n   */\r\n  private autoSwitchLicensePlate(): void {\r\n    // 只在车牌键盘类型时生效\r\n    if (!this.state.type.startsWith('license-plate')) return\r\n\r\n    const len = this.state.value.length\r\n    let targetType: string | null = null\r\n\r\n    if (len === 0) {\r\n      // 第1位：省份简称\r\n      targetType = 'license-plate-province'\r\n    } else {\r\n      // 第2-8位：字母+数字混合键盘\r\n      // （第2位虽然只能输入字母，但显示混合键盘，用户自己知道不能输入数字）\r\n      targetType = 'license-plate-alphanumeric'\r\n    }\r\n\r\n    // 如果需要切换\r\n    if (targetType && this.state.type !== targetType) {\r\n      this.switchType(targetType)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 处理清空\r\n   */\r\n  private handleClear(): void {\r\n    const previousValue = this.state.value\r\n\r\n    if (this.state.inputElement) {\r\n      this.state.inputElement.value = ''\r\n      this.dispatchInputEvent(this.state.inputElement)\r\n    }\r\n\r\n    this.state.value = ''\r\n    this.state.cursorPosition = 0\r\n\r\n    this.emitStateChange()\r\n    this.emit('clear', { previousValue })\r\n\r\n    // 车牌号智能切换\r\n    this.autoSwitchLicensePlate()\r\n  }\r\n\r\n  /**\r\n   * 处理确认\r\n   */\r\n  private handleConfirm(): void {\r\n    this.emit('confirm', { value: this.state.value })\r\n    this.hide()\r\n  }\r\n\r\n  /**\r\n   * 处理切换键盘\r\n   */\r\n  private handleTab(key: KeyDefinition): void {\r\n    const targetType = key.data?.targetType as KeyboardType | string | undefined\r\n    if (targetType) {\r\n      this.switchType(targetType)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 获取按键的实际输出值\r\n   */\r\n  private getKeyValue(key: KeyDefinition): string {\r\n    const value = key.value ?? key.label\r\n\r\n    if (typeof value === 'string') {\r\n      return value\r\n    }\r\n\r\n    return this.state.isUpperCase ? value.upper : value.lower\r\n  }\r\n\r\n  /**\r\n   * 获取按键的显示文本\r\n   */\r\n  getKeyLabel(key: KeyDefinition): string {\r\n    const label = key.label\r\n\r\n    if (typeof label === 'string') {\r\n      return label\r\n    }\r\n\r\n    return this.state.isUpperCase ? label.upper : label.lower\r\n  }\r\n\r\n  /**\r\n   * 设置值\r\n   */\r\n  setValue(value: string): void {\r\n    if (this.destroyed) return\r\n    const nextValue = clampValue(value, this.state.maxLength)\r\n    this.state.value = nextValue\r\n    this.state.cursorPosition = nextValue.length\r\n\r\n    if (this.state.inputElement) {\r\n      this.state.inputElement.value = nextValue\r\n      setInputCursorPosition(this.state.inputElement, nextValue.length)\r\n      this.dispatchInputEvent(this.state.inputElement)\r\n    }\r\n\r\n    this.emitStateChange()\r\n\r\n    // 车牌号智能切换\r\n    this.autoSwitchLicensePlate()\r\n  }\r\n\r\n  /**\r\n   * 追加值（在光标位置插入文本）\r\n   */\r\n  appendValue(text: string): void {\r\n    if (this.destroyed) return\r\n    if (!text) return\r\n\r\n    const input = this.state.inputElement\r\n\r\n    if (input) {\r\n      const result = insertTextAtCursor(input, text, this.state.maxLength)\r\n      input.value = result.value\r\n      setInputCursorPosition(input, result.cursorPosition)\r\n      this.state.value = result.value\r\n      this.state.cursorPosition = result.cursorPosition\r\n\r\n      // 触发原生 input 事件\r\n      this.dispatchInputEvent(input)\r\n    } else {\r\n      if (this.state.maxLength !== undefined) {\r\n        text = text.slice(\r\n          0,\r\n          Math.max(0, this.state.maxLength - this.state.value.length)\r\n        )\r\n      }\r\n      if (!text) return\r\n      const newValue =\r\n        this.state.value.slice(0, this.state.cursorPosition) +\r\n        text +\r\n        this.state.value.slice(this.state.cursorPosition)\r\n      this.state.value = newValue\r\n      this.state.cursorPosition += text.length\r\n    }\r\n\r\n    this.emitStateChange()\r\n  }\r\n\r\n  /**\r\n   * 设置最大长度\r\n   */\r\n  setMaxLength(maxLength?: number): void {\r\n    if (this.destroyed) return\r\n    const normalizedMaxLength = normalizeMaxLength(maxLength)\r\n    this.state.maxLength = normalizedMaxLength\r\n    const nextValue = clampValue(this.state.value, normalizedMaxLength)\r\n    const changed = nextValue !== this.state.value\r\n    this.state.value = nextValue\r\n    this.state.cursorPosition = Math.min(\r\n      this.state.cursorPosition,\r\n      nextValue.length\r\n    )\r\n    if (\r\n      this.state.inputElement &&\r\n      this.state.inputElement.value !== nextValue\r\n    ) {\r\n      this.state.inputElement.value = nextValue\r\n      setInputCursorPosition(this.state.inputElement, this.state.cursorPosition)\r\n      this.dispatchInputEvent(this.state.inputElement)\r\n    }\r\n    this.emitStateChange()\r\n    if (changed) this.autoSwitchLicensePlate()\r\n  }\r\n\r\n  /**\r\n   * 绑定输入框\r\n   */\r\n  bindInput(input: HTMLInputElement | HTMLTextAreaElement): void {\r\n    if (this.destroyed) return\r\n    this.state.inputElement = input\r\n    const nextValue = clampValue(input.value, this.state.maxLength)\r\n    if (input.value !== nextValue) input.value = nextValue\r\n    this.state.value = nextValue\r\n    this.state.cursorPosition = Math.min(\r\n      getInputCursorPosition(input),\r\n      nextValue.length\r\n    )\r\n    this.emitStateChange()\r\n  }\r\n\r\n  /**\r\n   * 解绑输入框\r\n   */\r\n  unbindInput(): void {\r\n    if (this.destroyed) return\r\n    this.state.inputElement = null\r\n    this.emitStateChange()\r\n  }\r\n\r\n  /**\r\n   * 发送状态变化事件\r\n   */\r\n  private emitStateChange(): void {\r\n    this.emit('stateChange', { ...this.state })\r\n  }\r\n\r\n  private dispatchInputEvent(\r\n    input: HTMLInputElement | HTMLTextAreaElement\r\n  ): void {\r\n    const EventConstructor = input.ownerDocument.defaultView?.Event ?? Event\r\n    input.dispatchEvent(new EventConstructor('input', { bubbles: true }))\r\n  }\r\n\r\n  /**\r\n   * 销毁\r\n   */\r\n  destroy(): void {\r\n    if (this.destroyed) return\r\n    this.hide()\r\n    this.clear()\r\n    this.state.inputElement = null\r\n    this.destroyed = true\r\n  }\r\n}\r\n\r\n/**\r\n * 创建键盘管理器实例\r\n */\r\nexport function createKeyboardManager(\r\n  options?: KeyboardOptions\r\n): KeyboardManager {\r\n  return new KeyboardManager(options)\r\n}\r\n"],"mappings":"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"}

package/es/managers/keyboard-renderer.d.ts

@@ -3,8 +3,8 @@
  * 框架无关的键盘渲染器，用于原生 JS 项目
  * @module managers/keyboard-renderer
  */
-import type { KeyboardOptions, KeyboardType, PopupPositionConfig } from '../types';
 import type { ThemeConfig } from '../themes/types';
+import type { KeyboardOptions, KeyboardType, PopupPositionConfig } from '../types';
 import { KeyboardManager } from './keyboard-manager';
 /**
  * 渲染器配置
@@ -48,6 +48,8 @@ export declare class KeyboardRenderer {
     private targetEl;
     /** 清理函数 */
     private cleanupFns;
+    private inputCleanupFns;
+    private styleDocument;
     /** 是否已销毁 */
     private destroyed;
     constructor(options?: KeyboardRendererOptions);
@@ -112,4 +114,3 @@ export declare class KeyboardRenderer {
  * 创建键盘渲染器
  */
 export declare function createKeyboardRenderer(options?: KeyboardRendererOptions): KeyboardRenderer;
-//# sourceMappingURL=keyboard-renderer.d.ts.map

package/es/managers/keyboard-renderer.js

@@ -2,18 +2,19 @@
 * ***********************************
 * @composy/keyboard-core v0.0.1   *
 * Built with rollup               *
-* Build time: 2024-08-17 11:33:29 *
+* Build time: 2024-10-12 17:29:15 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
 */
 import { isMobile } from "../utils/device.js";
-import { onClickOutside } from "../utils/dom.js";
+import { onClickOutside, sanitizeSvgIcon } from "../utils/dom.js";
 import { KeyboardManager } from "./keyboard-manager.js";
-import { PositionManager } from "./position-manager.js";
 import { defaultTheme } from "../themes/presets.js";
 import { getTheme, themeToCSS } from "../themes/index.js";
+import { PositionManager } from "./position-manager.js";
 //#region src/managers/keyboard-renderer.ts
+const rendererStyles = /* @__PURE__ */ new WeakMap();
 var KeyboardRenderer = class {
 	constructor(options = {}) {
 		/** DOM 元素 */
@@ -24,10 +25,14 @@ var KeyboardRenderer = class {
 		this.targetEl = null;
 		/** 清理函数 */
 		this.cleanupFns = [];
+		this.inputCleanupFns = /* @__PURE__ */ new Set();
+		this.styleDocument = null;
 		/** 是否已销毁 */
 		this.destroyed = false;
 		this.options = options;
-		this.container = options.container || document.body;
+		const container = options.container ?? (typeof document !== "undefined" ? document.body : null);
+		if (!container) throw new Error("[KeyboardRenderer] A DOM container is required in non-browser environments");
+		this.container = container;
 		this.manager = new KeyboardManager(options);
 		this.positionManager = new PositionManager(options.position);
 		if (typeof options.theme === "string") this.theme = getTheme(options.theme);
@@ -49,17 +54,12 @@ var KeyboardRenderer = class {
 		this.manager.on("confirm", ({ value }) => {
 			this.options.onConfirm?.(value);
 		});
-		this.manager.on("switch", () => {
-			if (this.manager.getState().visible) this.render();
-		});
-		this.manager.on("shift", () => {
-			if (this.manager.getState().visible) this.render();
-		});
 	}
 	/**
 	* 打开键盘
 	*/
 	open(target) {
+		if (this.destroyed) return;
 		this.targetEl = target ?? null;
 		this.manager.show(target);
 	}
@@ -67,19 +67,23 @@ var KeyboardRenderer = class {
 	* 关闭键盘
 	*/
 	close() {
+		if (this.destroyed) return;
+		const wasVisible = this.manager.getState().visible;
 		this.manager.hide();
-		this.options.onClose?.();
+		if (wasVisible) this.options.onClose?.();
 	}
 	/**
 	* 切换键盘类型
 	*/
 	switchType(type) {
+		if (this.destroyed) return;
 		this.manager.switchType(type);
 	}
 	/**
 	* 设置主题
 	*/
 	setTheme(theme) {
+		if (this.destroyed) return;
 		if (typeof theme === "string") this.theme = getTheme(theme);
 		else this.theme = theme;
 		if (this.manager.getState().visible) this.render();
@@ -94,12 +98,14 @@ var KeyboardRenderer = class {
 	* 设置值
 	*/
 	setValue(value) {
+		if (this.destroyed) return;
 		this.manager.setValue(value);
 	}
 	/**
 	* 渲染键盘 DOM
 	*/
 	render() {
+		if (this.destroyed) return;
 		const layout = this.manager.getLayout();
 		if (!layout) return;
 		this.unmount();
@@ -109,14 +115,18 @@ var KeyboardRenderer = class {
 		if (isMobileDevice) {
 			this.maskEl = document.createElement("div");
 			this.maskEl.className = "lk-mask";
-			this.maskEl.addEventListener("click", () => this.close());
+			this.maskEl.addEventListener("click", () => {
+				if (this.positionManager.isMaskClosable()) this.close();
+			});
 			this.rootEl.appendChild(this.maskEl);
 		}
 		this.keyboardEl = document.createElement("div");
 		this.keyboardEl.className = `lk-popup lk-popup--${isMobileDevice ? "mobile" : "desktop"}`;
 		const cssVars = themeToCSS(this.theme);
+		const keyboardElement = this.keyboardEl;
+		if (!keyboardElement) return;
 		Object.entries(cssVars).forEach(([key, value]) => {
-			if (value) this.keyboardEl.style.setProperty(key, value);
+			if (value) keyboardElement.style.setProperty(key, value);
 		});
 		const contentEl = this.renderKeyboard(layout);
 		this.keyboardEl.appendChild(contentEl);
@@ -145,7 +155,7 @@ var KeyboardRenderer = class {
 		});
 		if (this.options.closeOnClickOutside !== false && this.keyboardEl) {
 			const cleanup = onClickOutside(this.keyboardEl, (event) => {
-				if (this.targetEl && this.targetEl.contains(event.target)) return;
+				if (this.targetEl && event.target instanceof Node && this.targetEl.contains(event.target)) return;
 				this.close();
 			});
 			this.cleanupFns.push(cleanup);
@@ -177,8 +187,11 @@ var KeyboardRenderer = class {
 				btnEl.type = "button";
 				btnEl.className = this.getKeyClass(key, state.isUpperCase);
 				if (key.disabled) btnEl.disabled = true;
-				if (key.icon) btnEl.innerHTML = key.icon;
-				else btnEl.textContent = typeof key.label === "string" ? key.label : state.isUpperCase ? key.label.upper : key.label.lower;
+				if (key.icon) {
+					const safeIcon = sanitizeSvgIcon(key.icon);
+					if (safeIcon) btnEl.innerHTML = safeIcon;
+					else btnEl.textContent = key.icon;
+				} else btnEl.textContent = typeof key.label === "string" ? key.label : state.isUpperCase ? key.label.upper : key.label.lower;
 				const handler = (e) => {
 					e.preventDefault();
 					e.stopPropagation();
@@ -218,49 +231,67 @@ var KeyboardRenderer = class {
 	* 注入样式（单例）
 	*/
 	injectStyles() {
-		if (document.getElementById("lk-renderer-styles")) return;
-		const style = document.createElement("style");
-		style.id = "lk-renderer-styles";
+		const styleDocument = this.container.ownerDocument;
+		if (this.styleDocument === styleDocument) return;
+		const existing = rendererStyles.get(styleDocument);
+		if (existing) {
+			existing.users += 1;
+			this.styleDocument = styleDocument;
+			return;
+		}
+		const style = styleDocument.createElement("style");
 		style.textContent = `
-      .lk-renderer-root { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; }
-      .lk-mask { position: fixed; inset: 0; background: rgba(0,0,0,0.4); z-index: 9999; opacity: 0; transition: opacity 0.3s ease; }
+      .lk-renderer-root { font-family: var(--ld-font-family); }
+      .lk-mask { position: fixed; inset: 0; z-index: 9999; background: var(--keyboard-mask-bg); opacity: 0; transition: opacity var(--ld-duration-fast); }
       .lk-mask--visible { opacity: 1; }
-      .lk-popup { background: var(--keyboard-bg, #d1d5db); box-shadow: 0 -2px 16px rgba(0,0,0,0.15); overflow: hidden; transform: translateY(20px); opacity: 0; transition: transform 0.3s cubic-bezier(0.4,0,0.2,1), opacity 0.2s ease; }
+      .lk-popup { overflow: hidden; background: var(--keyboard-bg); box-shadow: var(--ld-shadow-md, none); transform: translateY(var(--ld-px-20)); opacity: 0; transition: transform var(--ld-duration-fast), opacity var(--ld-duration-fast); }
       .lk-popup--visible { transform: translateY(0); opacity: 1; }
-      .lk-popup--desktop { border-radius: 12px; box-shadow: 0 8px 32px rgba(0,0,0,0.18), 0 2px 8px rgba(0,0,0,0.1); min-width: 320px; }
-      .lk-popup--mobile { border-top-left-radius: 16px; border-top-right-radius: 16px; padding-bottom: env(safe-area-inset-bottom, 0); }
-      .lk-keyboard { display: flex; flex-direction: column; gap: var(--keyboard-key-gap, 6px); padding: var(--keyboard-padding, 6px); user-select: none; -webkit-user-select: none; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif; }
-      .lk-row { display: flex; justify-content: center; gap: var(--keyboard-key-gap, 6px); padding: 0 2px; }
+      .lk-popup--desktop { min-width: var(--ld-px-280); border-radius: var(--ld-radius-lg); box-shadow: var(--ld-shadow-lg, none); }
+      .lk-popup--mobile { border-top-left-radius: var(--ld-radius-lg); border-top-right-radius: var(--ld-radius-lg); padding-bottom: env(safe-area-inset-bottom, var(--ld-px-0)); }
+      .lk-keyboard { display: flex; flex-direction: column; gap: var(--keyboard-key-gap); padding: var(--keyboard-padding); user-select: none; -webkit-user-select: none; font-family: var(--ld-font-family); }
+      .lk-row { display: flex; justify-content: center; gap: var(--keyboard-key-gap); padding: 0 var(--ld-px-2); }
       .lk-row.numpad-row { justify-content: stretch; }
       .lk-row.numpad-row .lk-key-wrapper { flex: 1; }
       .lk-key-wrapper { position: relative; display: inline-flex; }
-      .lk-key { display: inline-flex; align-items: center; justify-content: center; height: var(--keyboard-key-height, 42px); min-width: 32px; width: 100%; padding: 0 6px; border: none; border-radius: var(--keyboard-key-radius, 6px); background: var(--keyboard-key-bg, #fff); color: var(--keyboard-key-color, #333); font-size: var(--keyboard-font-size, 16px); font-weight: 500; cursor: pointer; touch-action: manipulation; box-shadow: var(--keyboard-key-shadow, 0 1px 3px rgba(0,0,0,0.1)); transition: background-color 0.1s, transform 0.1s; }
-      .lk-key:active { background: var(--keyboard-key-active-bg, #e0e0e0); transform: scale(0.95); }
+      .lk-key { display: inline-flex; align-items: center; justify-content: center; width: 100%; min-width: var(--ld-px-32); height: var(--keyboard-key-height); padding: 0 var(--ld-spacing-xs); border: 0; border-radius: var(--keyboard-key-radius); background: var(--keyboard-key-bg); color: var(--keyboard-key-color); font-size: var(--keyboard-font-size); font-weight: 500; cursor: pointer; touch-action: manipulation; box-shadow: var(--keyboard-key-shadow); transition: background-color var(--ld-duration-fast), transform var(--ld-duration-fast); }
+      .lk-key:active { background: var(--keyboard-key-active-bg); transform: scale(0.95); }
       .lk-key--disabled { opacity: 0.4; cursor: not-allowed; }
-      .lk-key--disabled:active { transform: none; background: var(--keyboard-key-bg, #fff); }
-      .lk-key--backspace, .lk-key--shift, .lk-key--tab, .lk-key--clear, .lk-key--close { background: var(--keyboard-fn-key-bg, #d4d6dc); color: var(--keyboard-fn-key-color, #333); font-size: var(--keyboard-fn-font-size, 14px); }
-      .lk-key--backspace:active, .lk-key--shift:active, .lk-key--tab:active, .lk-key--clear:active, .lk-key--close:active { background: var(--keyboard-fn-key-active-bg, #b8bac0); }
-      .lk-key--active { background: var(--keyboard-key-active-bg, #007aff) !important; color: #fff !important; }
-      .lk-key--done, .lk-key--enter { background: var(--keyboard-primary-bg, #007aff); color: var(--keyboard-primary-color, #fff); font-size: var(--keyboard-fn-font-size, 14px); }
-      .lk-key--done:active, .lk-key--enter:active { background: var(--keyboard-primary-active-bg, #0062cc); }
-      .lk-key--space { background: var(--keyboard-key-bg, #fff); }
+      .lk-key--disabled:active { transform: none; background: var(--keyboard-key-bg); }
+      .lk-key--backspace, .lk-key--shift, .lk-key--tab, .lk-key--clear, .lk-key--close { background: var(--keyboard-fn-key-bg); color: var(--keyboard-fn-key-color); font-size: var(--keyboard-fn-font-size); }
+      .lk-key--backspace:active, .lk-key--shift:active, .lk-key--tab:active, .lk-key--clear:active, .lk-key--close:active { background: var(--keyboard-fn-key-active-bg); }
+      .lk-key--active { background: var(--keyboard-key-active-bg) !important; color: var(--ld-text-inverse) !important; }
+      .lk-key--done, .lk-key--enter { background: var(--keyboard-primary-bg); color: var(--keyboard-primary-color); font-size: var(--keyboard-fn-font-size); }
+      .lk-key--done:active, .lk-key--enter:active { background: var(--keyboard-primary-active-bg); }
+      .lk-key--space { background: var(--keyboard-key-bg); }
       .lk-key svg { pointer-events: none; }
     `;
-		document.head.appendChild(style);
+		style.id = "lk-renderer-styles";
+		styleDocument.head?.appendChild(style);
+		rendererStyles.set(styleDocument, {
+			element: style,
+			users: 1
+		});
+		this.styleDocument = styleDocument;
 	}
 	/**
 	* 绑定到输入框（聚焦时自动打开键盘）
 	*/
 	bindInput(input) {
+		if (this.destroyed) return () => void 0;
 		const handleFocus = () => this.open(input);
 		input.addEventListener("focus", handleFocus);
 		input.setAttribute("readonly", "readonly");
 		input.style.caretColor = "transparent";
-		return () => {
+		let cleaned = false;
+		const cleanup = () => {
+			if (cleaned) return;
+			cleaned = true;
 			input.removeEventListener("focus", handleFocus);
 			input.removeAttribute("readonly");
 			input.style.caretColor = "";
 		};
+		this.inputCleanupFns.add(cleanup);
+		return cleanup;
 	}
 	/**
 	* 销毁渲染器
@@ -269,9 +300,20 @@ var KeyboardRenderer = class {
 		if (this.destroyed) return;
 		this.destroyed = true;
 		this.unmount();
+		this.inputCleanupFns.forEach((cleanup) => cleanup());
+		this.inputCleanupFns.clear();
 		this.manager.destroy();
-		const styleEl = document.getElementById("lk-renderer-styles");
-		if (styleEl) styleEl.remove();
+		if (this.styleDocument) {
+			const entry = rendererStyles.get(this.styleDocument);
+			if (entry) {
+				entry.users -= 1;
+				if (entry.users <= 0) {
+					entry.element.remove();
+					rendererStyles.delete(this.styleDocument);
+				}
+			}
+			this.styleDocument = null;
+		}
 	}
 };
 function createKeyboardRenderer(options) {