@zh-keyboard/react 0.1.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 dusionlike
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,220 @@
+# 中文键盘 React 组件库
+
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+
+这是一个 React 的中文键盘组件库，支持拼音输入和手写输入。
+
+## 功能特点
+
+- 🔌 即插即用，自动绑定输入框
+- ✨ 支持拼音输入，带候选词选择功能
+- ✏️ 支持手写输入识别，支持连笔和简写
+- 🔧 可自定义手写识别算法
+- 📏 键盘大小可自定义缩放，灵活适配各种界面布局
+- 🌐 纯前端实现，可作为静态网页部署，无需服务端支持
+
+## 安装
+
+```bash
+npm install @zh-keyboard/react
+# 或者
+yarn add @zh-keyboard/react
+# 或者
+pnpm add @zh-keyboard/react
+```
+
+## 属性
+
+### Props
+
+| 属性名           | 类型                              | 默认值    | 说明                                |
+| --------------- | --------------------------------- | -------- | ---------------------------------- |
+| defaultMode     | 'en' \| 'zh' \| 'hand' \| 'num'  | 'en'     | 默认的键盘模式                      |
+| enableHandwriting| boolean                          | false    | 是否启用手写输入                    |
+| position        | 'static' \| 'float' \| 'bottom'  | 'static' | 键盘定位模式                       |
+| value           | string                            | ''       | 输入框的值                         |
+| onChange        | function                          | -        | 值变化时的回调函数                 |
+
+### 事件
+
+| 事件名 | 参数类型 | 说明 |
+| ------ | -------- | ---- |
+| onKey  | KeyEvent | 当用户在键盘上点击按键时触发 |
+
+## 基本使用
+
+- 为了防止移动端设备弹出系统默认的键盘，建议在输入框上设置 `inputMode="none"` 属性。
+- 此外，可以通过在输入框上设置 `data-inputmode` 属性来指定组件默认打开的键盘类型 (可选值为 `'en'`, `'zh'`, `'hand'`, `'num'`)，具体键盘模式的说明请参考 `defaultMode` 属性。
+
+```tsx
+import { ZhKeyboard } from '@zh-keyboard/react'
+import { useState } from 'react'
+import '@zh-keyboard/react/dist/style.css'
+
+function App() {
+  const [inputText, setInputText] = useState('')
+
+  return (
+    <div>
+      <input
+        value={inputText}
+        onChange={e => setInputText(e.target.value)}
+        data-inputmode="en"
+        inputMode="none"
+        placeholder="点击使用键盘输入"
+      />
+
+      {/* 静态定位的键盘 */}
+      <ZhKeyboard
+        value={inputText}
+        onChange={setInputText}
+      />
+
+      {/* 浮动定位的键盘（跟随输入框） */}
+      <ZhKeyboard
+        value={inputText}
+        onChange={setInputText}
+        position="float"
+      />
+
+      {/* 底部固定的键盘 */}
+      <ZhKeyboard
+        value={inputText}
+        onChange={setInputText}
+        position="bottom"
+      />
+
+      {/* 启用手写输入的键盘 */}
+      <ZhKeyboard
+        value={inputText}
+        onChange={setInputText}
+        enableHandwriting={true}
+      />
+
+      {/* 数字键盘 */}
+      <ZhKeyboard
+        value={inputText}
+        onChange={setInputText}
+        defaultMode="num"
+      />
+    </div>
+  )
+}
+
+export default App
+```
+
+## 输入模式
+
+### 拼音输入模式 (zh)
+
+拼音输入模式支持单字拼音输入，具有以下特性：
+
+- 支持单字模糊拼音匹配
+- 使用内置词库进行单字匹配
+- 支持中英文快速切换
+
+> 注：目前仅支持单个汉字的拼音输入，连续词组输入功能正在开发中
+
+### 英文输入模式 (en)
+
+标准的英文键盘布局，支持英文字母、数字和常用符号的输入。
+
+### 手写输入模式 (hand)
+
+手写输入模式允许用户通过手写输入汉字，启用此模式需要设置 `enableHandwriting` 为 `true`。
+
+### 数字输入模式 (num)
+
+数字输入模式提供一个数字和小数点键盘，方便用户输入数字、金额等。
+
+## 手写识别
+
+组件库支持自定义手写识别服务。您可以注册自己的手写识别服务来处理用户的手写输入。
+
+### 手写识别接口
+
+手写识别服务需要实现以下接口：
+
+```typescript
+interface HandwritingRecognizer {
+  /**
+   * 初始化手写识别服务
+   * @returns 返回是否初始化成功
+   */
+  initialize(): Promise<boolean>
+
+  /**
+   * 识别手写笔迹
+   * @param strokeData 笔迹数据，格式为 x y c x y c ...，其中x和y是坐标，c表示是否为笔画的最后一点(1表示是，0表示否)
+   * @returns 识别结果列表
+   */
+  recognize(strokeData: number[]): Promise<string[]>
+
+  /**
+   * 关闭手写识别服务
+   */
+  close(): Promise<void>
+}
+```
+
+### 笔迹数据格式
+
+笔迹数据以数组形式存储，格式为 `[x1, y1, c1, x2, y2, c2, ...]`，其中：
+- `x`、`y` 是坐标点
+- `c` 表示是否为笔画的最后一点：1表示是最后一点，0表示不是
+
+例如，一个简单的笔画可能是：`[100, 150, 0, 101, 151, 0, 102, 152, 1]`，表示三个点的笔画，最后一个点是笔画的结束点。
+
+### 注册手写识别服务
+
+```typescript
+import { registerHandwritingRecognizer } from '@zh-keyboard/react'
+import { MyHandwritingRecognizer } from './MyHandwritingRecognizer'
+
+// 创建并注册您的手写识别服务
+const recognizer = new MyHandwritingRecognizer()
+registerHandwritingRecognizer(recognizer)
+```
+
+### 示例实现
+
+以下是一个简单的手写识别服务示例实现：
+
+```typescript
+import type { HandwritingRecognizer } from '@zh-keyboard/react'
+
+export class MyHandwritingRecognizer implements HandwritingRecognizer {
+  private initialized = false
+
+  async initialize(): Promise<boolean> {
+    console.log('初始化手写识别服务...')
+    // 在实际应用中，这里可能需要加载模型或连接到服务器
+    this.initialized = true
+    return true
+  }
+
+  async recognize(strokeData: number[]): Promise<string[]> {
+    if (!this.initialized) {
+      throw new Error('手写识别服务未初始化')
+    }
+
+    console.log('识别笔迹数据:', strokeData)
+
+    // 这里调用您的手写识别API
+    // 返回识别结果
+    return ['你', '我', '他', '好', '的']
+  }
+
+  async close(): Promise<void> {
+    console.log('关闭手写识别服务')
+    this.initialized = false
+  }
+}
+```
+
+## 生命周期
+
+1. 当手写输入组件挂载时，会自动调用手写识别服务的 `initialize()` 方法
+2. 当用户完成一个笔画时，会调用 `recognize()` 方法进行识别
+3. 当手写输入组件卸载时，会调用 `close()` 方法关闭手写识别服务

package/dist/App.d.ts

@@ -0,0 +1,2 @@
+declare function App(): import("react/jsx-runtime").JSX.Element;
+export default App;

package/dist/components/CandidateBar.d.ts

@@ -0,0 +1,10 @@
+import { KeyEvent } from '../types';
+import { default as React } from 'react';
+interface CandidateBarProps {
+    currentPinyin: string;
+    onKey: (payload: KeyEvent) => void;
+    onInput: (text: string) => void;
+    setCurrentPinyin: (pinyin: string) => void;
+}
+declare const CandidateBar: React.FC<CandidateBarProps>;
+export default CandidateBar;

package/dist/components/CandidateList.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+interface CandidateListProps {
+    candidates: string[];
+    onSelect: (candidate: string) => void;
+}
+declare const CandidateList: React.FC<CandidateListProps>;
+export default CandidateList;

package/dist/components/CandidateSelection.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+interface CandidateSelectionProps {
+    candidates: string[];
+    onSelect: (candidate: string) => void;
+    onClose: () => void;
+}
+declare const CandidateSelection: React.FC<CandidateSelectionProps>;
+export default CandidateSelection;

package/dist/components/HandwritingInput.d.ts

@@ -0,0 +1,8 @@
+import { KeyEvent } from '../types';
+import { default as React } from 'react';
+interface HandwritingInputProps {
+    onKey: (payload: KeyEvent) => void;
+    onExit: () => void;
+}
+declare const HandwritingInput: React.FC<HandwritingInputProps>;
+export default HandwritingInput;

package/dist/components/KeyboardBase.d.ts

@@ -0,0 +1,11 @@
+import { KeyBoardMode, KeyEvent } from '../types';
+import { default as React } from 'react';
+interface KeyboardBaseProps {
+    recognizerInitialized?: boolean;
+    enableHandwriting?: boolean;
+    mode: KeyBoardMode;
+    onKey: (payload: KeyEvent) => void;
+    setMode: (mode: KeyBoardMode) => void;
+}
+declare const KeyboardBase: React.FC<KeyboardBaseProps>;
+export default KeyboardBase;

package/dist/components/NumericKeyboard.d.ts

@@ -0,0 +1,8 @@
+import { KeyEvent } from '../types';
+import { default as React } from 'react';
+interface NumericKeyboardProps {
+    onKey: (payload: KeyEvent) => void;
+    onExit: () => void;
+}
+declare const NumericKeyboard: React.FC<NumericKeyboardProps>;
+export default NumericKeyboard;

package/dist/components/SymbolKeyboard.d.ts

@@ -0,0 +1,8 @@
+import { KeyEvent } from '../types';
+import { default as React } from 'react';
+interface SymbolKeyboardProps {
+    onKey: (payload: KeyEvent) => void;
+    onExit: () => void;
+}
+declare const SymbolKeyboard: React.FC<SymbolKeyboardProps>;
+export default SymbolKeyboard;

package/dist/components/ZhKeyboard.d.ts

@@ -0,0 +1,13 @@
+import { KeyBoardMode, KeyEvent } from '../types';
+import { default as React } from 'react';
+interface ZhKeyboardProps {
+    defaultMode?: KeyBoardMode;
+    enableHandwriting?: boolean;
+    position?: 'static' | 'float' | 'bottom';
+    disableWhenNoFocus?: boolean;
+    onKey?: (payload: KeyEvent) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const ZhKeyboard: React.FC<ZhKeyboardProps>;
+export default ZhKeyboard;

package/dist/hooks/useActiveElement.d.ts

@@ -0,0 +1,6 @@
+/**
+ * React hook for tracking `document.activeElement`
+ *
+ * @returns 当前激活的元素
+ */
+export declare function useActiveElement<T extends HTMLElement>(): T | null | undefined;

package/dist/lib.d.ts

@@ -0,0 +1,4 @@
+import { default as ZhKeyboard } from './components/ZhKeyboard';
+export * from './utils/handwriting';
+export { ZhKeyboard };
+export default ZhKeyboard;

package/dist/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/style.css

@@ -0,0 +1 @@
+@charset "UTF-8";.zhk-candidate-list{flex:1;min-width:0;display:flex;overflow-x:auto;gap:var(--gap);scroll-behavior:smooth;scrollbar-width:none;-ms-overflow-style:none}.zhk-candidate-list::-webkit-scrollbar{display:none}.zhk-candidate-list__item{font-size:var(--candidate-font-size);display:flex;align-items:center;justify-content:center;background-color:transparent;border:none;cursor:pointer;white-space:nowrap;aspect-ratio:1;flex-shrink:0}.handwriting-input{display:flex;flex-direction:column;height:100%;background:var(--background-color, #f5f5f5);padding:var(--gap);gap:var(--gap);box-sizing:border-box}.handwriting-input .handwriting-content{flex:7;display:flex;flex-direction:row;align-items:flex-start;justify-content:center;flex-wrap:nowrap;overflow:hidden;gap:var(--gap)}.handwriting-input .handwriting-canvas-container{background:#fff;font-size:0}.handwriting-input .handwriting-canvas{touch-action:none}.handwriting-input .handwriting-buttons{flex:1;display:flex;flex-direction:column;justify-content:space-between;gap:var(--gap);max-width:calc(var(--keyboard-height) / 4);height:100%}.handwriting-input .handwriting-btn{flex:1;padding:var(--gap);border:1px solid var(--border-color, #dcdcdc);border-radius:var(--key-border-radius, 5px);background-color:var(--function-key-color, #e6e6e6);cursor:pointer;width:100%;display:flex;align-items:center;justify-content:center;white-space:nowrap;font-size:var(--key-font-size);font-weight:700;transition:all .1s}.handwriting-input .handwriting-btn:hover{background-color:#d9d9d9}.handwriting-input .handwriting-btn:active{transform:scale(.95)}.handwriting-input .handwriting-btn--function img{width:var(--key-icon-size);height:var(--key-icon-size)}.zhk-selection{position:absolute;top:0;left:0;width:100%;height:100%;background:#f5f5f5;z-index:2;display:flex;flex-wrap:nowrap;align-items:flex-start;justify-content:center;padding:var(--gap);gap:var(--gap);box-sizing:border-box}.zhk-selection__list{flex:5;min-width:0;display:grid;grid-template-columns:repeat(auto-fit,minmax(calc(var(--keyboard-height) / 6),1fr));background-color:var(--key-background-color, #fff);max-height:100%;overflow-y:auto;overflow-x:hidden}.zhk-selection__list::-webkit-scrollbar{width:6px}.zhk-selection__list::-webkit-scrollbar-thumb{background-color:var(--border-color, #dcdcdc);border-radius:3px}.zhk-selection__list::-webkit-scrollbar-track{background-color:transparent}.zhk-selection__text{font-size:var(--candidate-font-size);padding:10px;display:inline-flex;justify-content:center;align-items:center;border-bottom:1px solid var(--border-color, #dcdcdc);cursor:pointer}.zhk-selection__text:hover{background-color:var(--hover-key-color, #f0f0f0);z-index:1}.zhk-selection__func{flex:1;display:flex;justify-content:flex-end}.zhk-selection__func-btn{width:100%;font-size:var(--key-font-size);border:1px solid var(--border-color, #dcdcdc);border-radius:var(--key-border-radius, 5px);background-color:var(--function-key-color, #e6e6e6);padding:12px 0;cursor:pointer;color:#333;transition:all .1s;white-space:nowrap}.zhk-selection__func-btn:hover{background-color:var(--key-background-color, #fff)}.zhk-candidate{width:100%;height:100%;display:flex;align-items:center;box-sizing:border-box}.zhk-candidate__container{display:flex;flex-direction:column;flex:1;min-width:0;width:100%;height:100%;background-color:#f5f5f5}.zhk-candidate__pinyin{flex:1;font-size:var(--key-font-size);color:var(--primary-color, #4CAF50);box-sizing:border-box}.zhk-candidate__bottom-container{flex:3;display:flex;align-items:center;gap:var(--gap);width:100%}.zhk-candidate__more{cursor:pointer;display:flex;align-items:center;width:max(36px,var(--keyboard-height) / 8);background:none;border:none}.zhk-base{height:100%;display:flex;flex-direction:column;padding:var(--gap);box-sizing:border-box}.zhk-base__row{flex:1;min-height:0;display:flex;justify-content:center;gap:var(--gap);margin-bottom:4px}.zhk-base__row:last-child{margin-bottom:0}.zhk-base__key{width:var(--key-width);flex:none;min-height:40px;border:1px solid var(--border-color, #dcdcdc);border-radius:var(--key-border-radius, 5px);background-color:var(--key-background-color, #fff);color:var(--key-text-color, #333);font-size:var(--key-font-size);cursor:pointer;transition:all .1s;padding:0 5px;display:flex;align-items:center;justify-content:center}.zhk-base__key:active{transform:scale(.95)}.zhk-base__key--function{flex:none;width:var(--key-width);min-width:var(--key-min-width-function);background-color:var(--function-key-color, #e6e6e6);font-weight:700}.zhk-base__key--shift,.zhk-base__key--delete{flex:1;width:auto}.zhk-base__key--space{flex:1;width:auto;min-width:20px}.zhk-base__key--active{background-color:var(--primary-color, #4CAF50);border-color:var(--primary-color, #4CAF50);color:#fff}.zhk-base__key--active .zhk-base__key-icon{filter:brightness(0) invert(1)}.zhk-base__key--disabled{background-color:var(--disabled-key-color, #f5f5f5);border-color:var(--disabled-key-border-color, #e0e0e0);color:var(--disabled-key-text-color, #bdbdbd);cursor:not-allowed}.zhk-base__key--disabled .zhk-base__key-icon{filter:brightness(.7)}.zhk-base__key-icon{width:var(--key-icon-size);height:var(--key-icon-size);vertical-align:middle;display:inline-block}.zhk-base__toggle-main{font-size:max(14px,var(--keyboard-height) / 30)}.zhk-base__toggle-sub{font-size:max(12px,var(--keyboard-height) / 40);color:var(--toggle-sub-color, #888);margin-left:2px}.num-keyboard{height:100%;display:flex;flex-direction:column;padding:8px;box-sizing:border-box}.num-keyboard__container{display:flex;height:100%;gap:8px}.num-keyboard__left{flex:3;display:flex;flex-direction:column}.num-keyboard__right{flex:1;display:flex;flex-direction:column;justify-content:space-between;gap:6px}.num-keyboard__rows{display:flex;flex-direction:column;flex:1;gap:var(--gap)}.num-keyboard__row{display:flex;flex:1;gap:var(--gap)}.num-keyboard__key{flex:1;display:flex;align-items:center;justify-content:center;background-color:var(--key-background-color, #fff);border:1px solid var(--border-color, #dcdcdc);border-radius:var(--key-border-radius, 5px);font-size:var(--key-font-size);font-weight:700;color:var(--key-text-color, #333);cursor:pointer;transition:all .1s}.num-keyboard__key:hover{background-color:#f7f7f7}.num-keyboard__key:active{transform:scale(.95)}.num-keyboard__key--function{height:calc(25% - 6px);background-color:var(--function-key-color, #e6e6e6);font-size:var(--key-font-size);font-weight:700}.num-keyboard__key--function:hover{background-color:#d9d9d9}.num-keyboard__key--back{font-size:var(--key-font-size);background-color:var(--function-key-color, #e6e6e6)}.num-keyboard__key--back:hover{background-color:#d9d9d9}.num-keyboard__key--space{font-size:var(--key-font-size)}.num-keyboard__key-icon{width:var(--key-icon-size);height:var(--key-icon-size)}.symbol-keyboard{height:100%;display:flex;flex-direction:column;padding:10px;box-sizing:border-box}.symbol-keyboard__content{display:flex;flex:1;gap:6px;height:100%}.symbol-keyboard__functions{display:flex;flex-direction:column;justify-content:space-between;gap:6px;width:60px}.symbol-keyboard__lang-selector{display:flex;flex-direction:column;height:126px}.symbol-keyboard__lang-btn{padding:10px 0;display:flex;align-items:center;justify-content:center;background-color:var(--key-background-color, #fff);border:1px solid var(--border-color, #dcdcdc);font-size:16px;cursor:pointer;transition:all .1s;margin:0;box-sizing:border-box;width:60px;flex:1;flex-shrink:0}.symbol-keyboard__lang-btn:first-child{border-radius:var(--key-border-radius, 5px) var(--key-border-radius, 5px) 0 0}.symbol-keyboard__lang-btn:last-child{margin-top:-1px;border-radius:0 0 var(--key-border-radius, 5px) var(--key-border-radius, 5px)}.symbol-keyboard__lang-btn:hover{filter:brightness(95%)}.symbol-keyboard__lang-btn--active{background-color:var(--primary-color, #4CAF50);color:#fff;border-color:var(--primary-color, #4CAF50);position:relative;z-index:1}.symbol-keyboard__control-group{display:flex;flex-direction:column;gap:8px}.symbol-keyboard__symbols-container{flex:1;width:100%;height:100%;overflow-y:auto;padding-right:5px}.symbol-keyboard__symbols-container::-webkit-scrollbar{width:6px}.symbol-keyboard__symbols-container::-webkit-scrollbar-track{background:#0000000d;border-radius:3px}.symbol-keyboard__symbols-container::-webkit-scrollbar-thumb{background:#0003;border-radius:3px}.symbol-keyboard__symbols-container::-webkit-scrollbar-thumb:hover{background:#0000004d}.symbol-keyboard__symbols-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(60px,1fr));gap:6px;width:100%;max-height:100%;padding-bottom:10px}.symbol-keyboard__key{display:flex;align-items:center;justify-content:center;background-color:var(--key-background-color, #fff);border:1px solid var(--border-color, #dcdcdc);border-radius:var(--key-border-radius, 5px);font-size:24px;font-weight:400;color:var(--key-text-color, #333);cursor:pointer;transition:all .1s;margin:0;box-sizing:border-box;min-width:60px;max-width:80px;width:100%;height:60px;aspect-ratio:1;flex-shrink:0}.symbol-keyboard__key:hover{background-color:#f7f7f7}.symbol-keyboard__key:active{transform:scale(.95)}.symbol-keyboard__key--function{background-color:var(--function-key-color, #e6e6e6);width:60px;height:60px;aspect-ratio:auto}.symbol-keyboard__key--function:hover{background-color:#d9d9d9}.symbol-keyboard__key--lock{padding:10px 0;font-size:18px;font-weight:700;display:flex;align-items:center;justify-content:center}.symbol-keyboard__key--lock img{width:24px;height:24px}.symbol-keyboard__key--locked{background-color:var(--primary-color, #4CAF50);color:#fff}.symbol-keyboard__key--locked:hover{background-color:#449d48}.symbol-keyboard__key--back{padding:10px 0;font-size:18px;font-weight:700;display:flex}.zhk{--key-font-size: max(1rem, calc(var(--keyboard-height) / 20));--candidate-font-size: max(24px, calc(var(--keyboard-height) / 12));--gap: 4px;--key-width: calc((100% - 9 * var(--gap)) / 10);--key-min-width-function: 45px;--key-icon-size: calc(var(--key-font-size) * 1.2);position:relative;width:400px;min-width:calc(var(--keyboard-height) + 100px);max-width:1080px;height:300px;min-height:300px;overflow:hidden;background-color:#f5f5f5;border-radius:8px;box-shadow:0 2px 10px #0000001a;font-family:PingFang SC,Microsoft YaHei,sans-serif;-webkit-user-select:none;user-select:none}.zhk--disabled{opacity:.7}.zhk--floating{position:fixed;z-index:9999;box-shadow:0 4px 20px #0003}.zhk--bottom{position:fixed;bottom:0;left:0;width:100%;min-width:min(var(--keyboard-height) + 100px,100%);max-width:100%;z-index:9999;border-radius:8px 8px 0 0;box-shadow:0 -2px 10px #0000001a}.zhk__disabled-overlay{position:absolute;top:0;left:0;width:100%;height:100%;display:flex;justify-content:center;align-items:center;background-color:#f5f5f5cc;z-index:10;border-radius:8px}.zhk__disabled-overlay span{font-size:16px;color:#666;padding:15px 30px;background-color:#e0e0e0;border-radius:5px}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export interface KeyEvent {
+    key: string;
+    isControl?: boolean;
+}
+export type KeyBoardMode = 'zh' | 'en' | 'hand' | 'num' | 'symbol';

package/dist/utils/handwriting.d.ts

@@ -0,0 +1,11 @@
+import { HandwritingRecognizer } from '@zh-keyboard/core';
+/**
+ * 注册手写识别服务
+ * @param recognizer 手写识别服务实现
+ */
+export declare function registerHandwritingRecognizer(recognizer: HandwritingRecognizer): void;
+/**
+ * 获取手写识别服务实例
+ * @returns 手写识别服务实例
+ */
+export declare function getHandwritingRecognizer(): HandwritingRecognizer | null;

package/dist/utils/useHandwritingRecognizer.d.ts

@@ -0,0 +1,3 @@
+export declare function useHandwritingRecognizer(enableHandwriting?: boolean): {
+    recognizerInitialized: boolean;
+};