@junerver/vue-touch-ime 0.0.0-stage → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 junerver
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,157 @@
-# Temporary Holding Version
+# vue-touch-ime
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vue 3 触摸屏软键盘（内置中文拼音输入法）——零接线焦点接管、按输入类型限制，适配无物理键盘的触屏工控 / 车载 / 自助终端 / 便携采集设备
+
+![screenshot](media/screenshot.png)
+
+## 功能特性
+
+- **零接线接管** - 组件挂到页面根部后，文档级焦点监听自动接管所有文本输入框（聚焦弹出、失焦收起），无需逐个绑定
+- **中文拼音输入** - 内置拼音词典（421 音节、汉字按字频排序 + 147 条常用短语），短语候选优先，支持一次上屏
+- **输入类型限制** - 从 input 自身属性推断：`type=number` + 小数 `step` → 仅数字与一个小数点；整数 `step` → 仅数字；`inputmode` 同样生效；`data-vti-kb` 可显式覆盖
+- **中 / 英 / 数 三模式** - 拼音、英文（单次大写）、数字键盘；数字与标点在拼音模式下直接上屏
+- **v-model 友好** - 写值自动派发 `input` 事件，兼容 `v-model` 与 `@input` 受控写法
+- **可换肤** - 一组 CSS 变量覆盖主色 / 背景 / 按键尺寸 / 圆角 / 字体
+- **零运行时依赖** - 仅 peer 依赖 `vue`，拼音词典静态编译进包
+- **单例 / 多实例** - 默认单例开箱即用，也可 `createSoftKeyboard()` 创建独立实例互不干扰
+
+## 安装
+
+```bash
+npm install @junerver/vue-touch-ime
+```
+
+## 快速上手
+
+```vue
+<script setup lang="ts">
+import { SoftKeyboard } from '@junerver/vue-touch-ime'
+import '@junerver/vue-touch-ime/style.css'
+import { ref } from 'vue'
+
+const name = ref('')
+const weight = ref<number | null>(null)
+</script>
+
+<template>
+  <input v-model="name" type="text" placeholder="名称（试试输入 dahuang）" />
+  <input v-model="weight" type="number" step="0.1" placeholder="体重（仅数字+小数点）" />
+  <!-- 放在页面根部即可，输入框自动接管 -->
+  <SoftKeyboard />
+</template>
+```
+
+> 键盘只在挂载了 `<SoftKeyboard />` 的页面生效；不挂载的页面（如桌面大屏版）完全不受影响。
+
+## 输入类型限制
+
+| 输入框写法 | 键盘行为 |
+| --- | --- |
+| `<input type="number" step="0.1">` | 数字键盘，仅数字 + 一个小数点 |
+| `<input type="number">`（整数 step） | 数字键盘，仅数字 |
+| `<input type="text" inputmode="decimal">` | 数字键盘，仅数字 + 一个小数点 |
+| `<input type="text" inputmode="numeric\|tel">` | 数字键盘，仅数字 |
+| 其余文本输入框 | 拼音（可切英文 / 数字） |
+
+### `data-vti-kb` 显式覆盖
+
+属性推断不符时用 `data-vti-kb="text|decimal|digits"` 强制指定：
+
+```vue
+<!-- 编号输入框强制只接受数字（含前导零） -->
+<input v-model="code" type="text" data-vti-kb="digits" placeholder="0083" />
+```
+
+> 注意：`type=number` 的输入框受浏览器值消毒约束（非数字内容会被直接清空），
+> 中文请用文本输入框。
+
+## 拼音输入说明
+
+- 字母进入候选缓冲（顶部回显拼音，不进输入框），空格或点击候选上屏
+- 候选顺序：短语优先（`dahuang` → 「大黄」），再按音节前缀从长到短出单字，单字按字频排序（`da` → 大 打 达…）
+- `ü` 用 `v` 输入（`nv` → 女）
+- 「完成」：整段拼音能被单个候选吃掉则上屏候选，否则按原始拉丁字母上屏（方便输入编号 / 编码）；随后收起键盘并触发输入框 `blur`
+- 退格先删拼音缓冲，缓冲清空后删输入框内容
+
+## 主题定制
+
+### 快捷换肤：`accent` / `background` prop
+
+```vue
+<!-- 主色调换成橙色：完成键 / 高亮 / 派生色自动跟随 -->
+<SoftKeyboard accent="#ff5500" background="rgba(20, 16, 12, 0.97)" />
+```
+
+| Prop | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `instance` | `SoftKeyboardInstance` | 模块单例 | 自定义键盘实例（多键盘并存时用 `createSoftKeyboard()` 创建） |
+| `accent` | `string` | `#3ef2c0` | 主色调（完成键 / 高亮 / 派生色自动跟随） |
+| `background` | `string` | `rgba(7,20,24,0.97)` | 面板背景色 |
+
+### 细粒度：CSS 变量
+
+覆盖 `.vti-kb` 上的 CSS 变量即可（`--vti-accent-strong` 默认由 `--vti-accent`
+自动派生，一般无需单独覆盖）：
+
+```css
+.vti-kb {
+  --vti-accent: #3ef2c0;        /* 主色（高亮 / 完成键） */
+  --vti-accent-strong: color-mix(in srgb, var(--vti-accent) 72%, #000); /* 派生暗端 */
+  --vti-on-accent: #06241c;     /* 主色按键上的文字色 */
+  --vti-bg: rgba(7, 20, 24, 0.97); /* 面板背景 */
+  --vti-key-bg: linear-gradient(180deg, rgba(24, 56, 60, 0.95), rgba(13, 34, 38, 0.95));
+  --vti-key-fg: #d7e2e0;        /* 按键文字 */
+  --vti-key-h: 54px;            /* 按键高度 */
+  --vti-key-radius: 10px;       /* 按键圆角 */
+  --vti-font: "Microsoft YaHei", sans-serif;
+}
+```
+
+## API
+
+### 组合式
+
+```ts
+import { useSoftKeyboard, createSoftKeyboard } from '@junerver/vue-touch-ime'
+
+const kb = useSoftKeyboard() // 模块单例
+const other = createSoftKeyboard() // 独立实例
+
+kb.state // reactive：visible / mode / kind / buffer / draft / replaceAll / shift
+kb.candidates // 当前拼音候选（ComputedRef<SoftCandidate[]>）
+kb.press('a') // 按键：单字符 | 'backspace' | 'space' | 'done' | 'shift' | 'mode:zh|en|num|back'
+kb.pickCandidate(candidate) // 候选上屏
+kb.openFor(inputElement) // 手动接管指定输入框
+kb.close(blur?) // 收起键盘
+kb.attach(root) / kb.detach() // 焦点监听挂载/卸载（组件内部已自动处理）
+```
+
+### 纯逻辑（`@junerver/vue-touch-ime/ime`）
+
+不依赖 Vue，可在任意框架 / 原生页面复用：`resolveSoftKind` / `resolveSoftKindWithOverride` /
+`candidatesFor` / `resolveBufferCommit` / `insertIntoTextInput` / `backspaceTextInput` /
+`writeInputValue` / 数字草稿工具（`applyCharToDraft` / `draftToDomValue` 等）。
+
+### 词典（`@junerver/vue-touch-ime/dict`）
+
+`PINYIN_CHARS`（音节 → 汉字串，串序即候选序）与 `PINYIN_PHRASES`（拼音 → 短语）。
+
+## 词典再生成
+
+词典是构建期生成的静态资产（`src/pinyinDict.ts`，勿手工编辑）：
+
+```bash
+python scripts/gen-pinyin-dict.py
+```
+
+原料：Jun Da 现代汉语单字字频表（决定候选顺序）+ `pinyin` 包单字表（补全读音）+
+脚本内维护的常用短语表。短语表可按业务领域增删后重新生成。
+
+## 浏览器兼容
+
+现代浏览器（Chrome / Edge / Safari），依赖 Pointer Events 与 CSS `color-mix`。
+面向触屏设备使用；桌面端鼠标操作同样可用。
+
+## License
+
+[MIT](LICENSE) © junerver

package/dist/SoftKeyboard.vue.d.ts

@@ -0,0 +1,12 @@
+import { type SoftKeyboard } from './useSoftKeyboard';
+type __VLS_Props = {
+    /** 自定义键盘实例（缺省用模块单例；多键盘并存时传入 createSoftKeyboard() 的产物） */
+    instance?: SoftKeyboard;
+    /** 主色调（覆盖 --vti-accent，完成键/高亮/派生色自动跟随） */
+    accent?: string;
+    /** 面板背景色（覆盖 --vti-bg） */
+    background?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/ime.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./pinyinDict.cjs");var t=6,n=20,r=[`text`,`decimal`,`digits`];function i(e){return r.includes(e??``)}function a(e){let t=String(e.type||`text`).toLowerCase(),n=String(e.inputMode||``).toLowerCase();if(t===`number`){let t=String(e.step??``).trim();if(t===`any`)return`decimal`;let n=Number(t);return t!==``&&Number.isFinite(n)&&Math.abs(n%1)>1e-9?`decimal`:`digits`}return n===`decimal`?`decimal`:n===`numeric`||n===`tel`||t===`tel`?`digits`:`text`}function o(e,t){return i(t)?t:a(e)}function s(e,t){return t.length===1?e===`text`?!0:e===`digits`?t>=`0`&&t<=`9`:t>=`0`&&t<=`9`||t===`.`:!1}function c(e,t,n,r){let i=`${r} ${n}`;t.has(i)||(t.add(i),e.push({text:n,consumed:r}))}function l(r,i=n){if(!r)return[];let a=[],o=new Set,s=[];for(let t of Object.keys(e.PINYIN_PHRASES))r.startsWith(t)&&s.push({text:e.PINYIN_PHRASES[t],consumed:t.length});s.sort((e,t)=>t.consumed-e.consumed);for(let e of s)c(a,o,e.text,e.consumed);for(let n=Math.min(t,r.length);n>=1;n--){let t=e.PINYIN_CHARS[r.slice(0,n)];if(!t)continue;let s=Math.min(t.length,Math.max(1,i));for(let e=0;e<s;e++)c(a,o,t[e],n)}return a}function u(e){if(!e)return null;let t=l(e,1)[0];return t&&t.consumed===e.length?t.text:e}function d(e,t){let n=t;if(e===`digits`)return n.replace(/[^0-9]/g,``);if(e===`decimal`){n=n.replace(/[^0-9.]/g,``);let e=n.indexOf(`.`);return e>=0&&(n=n.slice(0,e+1)+n.slice(e+1).replace(/\./g,``)),n}return n}function f(e,t){let n=d(e,t);return e===`decimal`&&n.endsWith(`.`)?n.slice(0,-1):n}function p(e,t,n,r){let i=r?``:t;return e===`decimal`&&n===`.`?i.includes(`.`)?d(e,i):d(e,i===``?`0.`:i+`.`):d(e,i+n)}function m(e,t){return t?``:e.slice(0,-1)}function h(e){try{let t=e.selectionStart,n=e.selectionEnd;return t==null||n==null?null:{start:t,end:n}}catch{return null}}function g(e,t){try{e.setSelectionRange(t,t)}catch{}}function _(e){return e.maxLength>0?e.maxLength:1/0}function v(e,t){e.value!==t&&(e.value=t,e.dispatchEvent(new Event(`input`,{bubbles:!0})))}function y(e){let t=h(e);return t?e.value.length>0&&t.start===0&&t.end===e.value.length:e.value.length>0}function b(e,t,n=!1){let r=_(e),i=e.value,a=h(e);if(n||a!=null&&i.length>0&&a.start===0&&a.end===i.length){v(e,t.slice(0,r)),g(e,Math.min(t.length,r));return}if(!a){v(e,(i+t).slice(0,r));return}let o=(i.slice(0,a.start)+t+i.slice(a.end)).slice(0,r);v(e,o),g(e,Math.min(a.start+t.length,o.length))}function x(e){let t=e.value,n=h(e);n?n.start===n.end?n.start<=0||(v(e,t.slice(0,n.start-1)+t.slice(n.start)),g(e,n.start-1)):(v(e,t.slice(0,n.start)+t.slice(n.end)),g(e,n.start)):v(e,t.slice(0,-1))}function S(e,t,n){v(e,f(t,n))}exports.KIND_OVERRIDE_VALUES=r,exports.applyCharToDraft=p,exports.backspaceDraft=m,exports.backspaceTextInput=x,exports.candidatesFor=l,exports.draftToDomValue=f,exports.hasFullSelection=y,exports.insertIntoTextInput=b,exports.isCharAllowed=s,exports.normalizeDraft=d,exports.resolveBufferCommit=u,exports.resolveSoftKind=a,exports.resolveSoftKindWithOverride=o,exports.writeDraft=S,exports.writeInputValue=v;

package/dist/ime.d.ts

@@ -0,0 +1,63 @@
+export type SoftKbKind = 'text' | 'decimal' | 'digits';
+export type SoftKbMode = 'zh' | 'en' | 'num';
+export interface SoftCandidate {
+    /** 候选文本（短语或单字） */
+    text: string;
+    /** 上屏后应从拼音缓冲里吃掉的字母数 */
+    consumed: number;
+}
+/** `data-vti-kb` 显式覆盖值 */
+export declare const KIND_OVERRIDE_VALUES: readonly ["text", "decimal", "digits"];
+/**
+ * 从输入框属性推断限制类型。
+ * - type=number + step 含小数 → decimal（体重 step=0.1）；
+ * - type=number 整数 step / 缺省 step → digits（月龄）；
+ * - inputmode=decimal/numeric/tel → 对应 decimal/digits；
+ * - 其余（text/search…）→ text。
+ */
+export declare function resolveSoftKind(el: {
+    type?: string | null;
+    step?: string | null;
+    inputMode?: string | null;
+}): SoftKbKind;
+/**
+ * 解析输入限制：`data-vti-kb="text|decimal|digits"` 优先于属性推断。
+ * 传入带 data 集的元素即可（HTMLInputElement.dataset.vtiKb）。
+ */
+export declare function resolveSoftKindWithOverride(el: {
+    type?: string | null;
+    step?: string | null;
+    inputMode?: string | null;
+}, override?: string | null): SoftKbKind;
+/** 该限制类型允许的单字符键（软键盘按此过滤） */
+export declare function isCharAllowed(kind: SoftKbKind, ch: string): boolean;
+/**
+ * 拼音缓冲 → 候选列表。
+ * 1) 短语：拼音为缓冲前缀的短语，长的在前（"dahuangniu" 先出「大黄」）；
+ * 2) 单字：音节前缀从长到短（"xian" 先出「现…」再出「夏…」再出「西…」），
+ *    单字顺序即词典字频顺序。
+ */
+export declare function candidatesFor(buffer: string, perGroupLimit?: number): SoftCandidate[];
+/**
+ * 拼音缓冲上屏（完成键）：整个缓冲能被单个候选吃掉就上屏候选，
+ * 否则按用户原始拉丁字母上屏（方便输入编号/编码类内容）。
+ */
+export declare function resolveBufferCommit(buffer: string): string | null;
+/** 草稿净化：digits 只留数字；decimal 留数字且至多一个小数点 */
+export declare function normalizeDraft(kind: SoftKbKind, draft: string): string;
+/** 草稿 → 可写进 DOM 的值（剥掉尾部未完成的小数点，浏览器会把它消毒成 ""） */
+export declare function draftToDomValue(kind: SoftKbKind, draft: string): string;
+/** 数字草稿按键：追加一个字符（replaceAll 时先清空旧值） */
+export declare function applyCharToDraft(kind: SoftKbKind, draft: string, ch: string, replaceAll: boolean): string;
+/** 数字草稿退格：只支持尾部删除（type=number 拿不到光标） */
+export declare function backspaceDraft(draft: string, replaceAll: boolean): string;
+/** 写值并派发 input 事件，让 v-model / @input 同步 */
+export declare function writeInputValue(el: HTMLInputElement, value: string): void;
+/** 当前是否为「全选」状态（行内编辑进场即全选的输入框） */
+export declare function hasFullSelection(el: HTMLInputElement): boolean;
+/** 文本类插入：按原生光标插入（全选/replaceAll 时整体替换） */
+export declare function insertIntoTextInput(el: HTMLInputElement, text: string, replaceAll?: boolean): void;
+/** 文本类退格：有选区删选区，否则删光标前一个字符 */
+export declare function backspaceTextInput(el: HTMLInputElement): void;
+/** 数字类写值：把草稿净化后落 DOM（含 pending 小数点处理） */
+export declare function writeDraft(el: HTMLInputElement, kind: SoftKbKind, draft: string): void;

package/dist/ime.js

@@ -0,0 +1,124 @@
+import { PINYIN_CHARS as e, PINYIN_PHRASES as t } from "./pinyinDict.js";
+//#region src/ime.ts
+var n = 6, r = 20, i = [
+	"text",
+	"decimal",
+	"digits"
+];
+function a(e) {
+	return i.includes(e ?? "");
+}
+function o(e) {
+	let t = String(e.type || "text").toLowerCase(), n = String(e.inputMode || "").toLowerCase();
+	if (t === "number") {
+		let t = String(e.step ?? "").trim();
+		if (t === "any") return "decimal";
+		let n = Number(t);
+		return t !== "" && Number.isFinite(n) && Math.abs(n % 1) > 1e-9 ? "decimal" : "digits";
+	}
+	return n === "decimal" ? "decimal" : n === "numeric" || n === "tel" || t === "tel" ? "digits" : "text";
+}
+function s(e, t) {
+	return a(t) ? t : o(e);
+}
+function c(e, t) {
+	return t.length === 1 ? e === "text" ? !0 : e === "digits" ? t >= "0" && t <= "9" : t >= "0" && t <= "9" || t === "." : !1;
+}
+function l(e, t, n, r) {
+	let i = `${r} ${n}`;
+	t.has(i) || (t.add(i), e.push({
+		text: n,
+		consumed: r
+	}));
+}
+function u(i, a = r) {
+	if (!i) return [];
+	let o = [], s = /* @__PURE__ */ new Set(), c = [];
+	for (let e of Object.keys(t)) i.startsWith(e) && c.push({
+		text: t[e],
+		consumed: e.length
+	});
+	c.sort((e, t) => t.consumed - e.consumed);
+	for (let e of c) l(o, s, e.text, e.consumed);
+	for (let t = Math.min(n, i.length); t >= 1; t--) {
+		let n = e[i.slice(0, t)];
+		if (!n) continue;
+		let r = Math.min(n.length, Math.max(1, a));
+		for (let e = 0; e < r; e++) l(o, s, n[e], t);
+	}
+	return o;
+}
+function d(e) {
+	if (!e) return null;
+	let t = u(e, 1)[0];
+	return t && t.consumed === e.length ? t.text : e;
+}
+function f(e, t) {
+	let n = t;
+	if (e === "digits") return n.replace(/[^0-9]/g, "");
+	if (e === "decimal") {
+		n = n.replace(/[^0-9.]/g, "");
+		let e = n.indexOf(".");
+		return e >= 0 && (n = n.slice(0, e + 1) + n.slice(e + 1).replace(/\./g, "")), n;
+	}
+	return n;
+}
+function p(e, t) {
+	let n = f(e, t);
+	return e === "decimal" && n.endsWith(".") ? n.slice(0, -1) : n;
+}
+function m(e, t, n, r) {
+	let i = r ? "" : t;
+	return e === "decimal" && n === "." ? i.includes(".") ? f(e, i) : f(e, i === "" ? "0." : i + ".") : f(e, i + n);
+}
+function h(e, t) {
+	return t ? "" : e.slice(0, -1);
+}
+function g(e) {
+	try {
+		let t = e.selectionStart, n = e.selectionEnd;
+		return t == null || n == null ? null : {
+			start: t,
+			end: n
+		};
+	} catch {
+		return null;
+	}
+}
+function _(e, t) {
+	try {
+		e.setSelectionRange(t, t);
+	} catch {}
+}
+function v(e) {
+	return e.maxLength > 0 ? e.maxLength : Infinity;
+}
+function y(e, t) {
+	e.value !== t && (e.value = t, e.dispatchEvent(new Event("input", { bubbles: !0 })));
+}
+function b(e) {
+	let t = g(e);
+	return t ? e.value.length > 0 && t.start === 0 && t.end === e.value.length : e.value.length > 0;
+}
+function x(e, t, n = !1) {
+	let r = v(e), i = e.value, a = g(e);
+	if (n || a != null && i.length > 0 && a.start === 0 && a.end === i.length) {
+		y(e, t.slice(0, r)), _(e, Math.min(t.length, r));
+		return;
+	}
+	if (!a) {
+		y(e, (i + t).slice(0, r));
+		return;
+	}
+	let o = (i.slice(0, a.start) + t + i.slice(a.end)).slice(0, r);
+	y(e, o), _(e, Math.min(a.start + t.length, o.length));
+}
+function S(e) {
+	let t = e.value, n = g(e);
+	n ? n.start === n.end ? n.start <= 0 || (y(e, t.slice(0, n.start - 1) + t.slice(n.start)), _(e, n.start - 1)) : (y(e, t.slice(0, n.start) + t.slice(n.end)), _(e, n.start)) : y(e, t.slice(0, -1));
+}
+function C(e, t, n) {
+	y(e, p(t, n));
+}
+//#endregion
+export { i as KIND_OVERRIDE_VALUES, m as applyCharToDraft, h as backspaceDraft, S as backspaceTextInput, u as candidatesFor, p as draftToDomValue, b as hasFullSelection, x as insertIntoTextInput, c as isCharAllowed, f as normalizeDraft, d as resolveBufferCommit, o as resolveSoftKind, s as resolveSoftKindWithOverride, C as writeDraft, y as writeInputValue };

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./pinyinDict.cjs"),t=require("./ime.cjs");let n=require("vue");var r=new Set([`text`,`search`,`tel`,`email`,`url`,`number`,``]);function i(e){return!(e instanceof HTMLInputElement)||e.disabled||e.readOnly?!1:r.has((e.type||`text`).toLowerCase())}function a(){let e=(0,n.reactive)({visible:!1,mode:`zh`,kind:`text`,buffer:``,draft:``,replaceAll:!1,shift:!1,prevTextMode:`zh`}),r=null,a=null,o=!1,s=0,c=(0,n.computed)(()=>e.visible&&e.mode===`zh`?t.candidatesFor(e.buffer):[]);function l(n){if(r===n&&e.visible)return;s+=1,r=n;let i=t.resolveSoftKindWithOverride(n,n.dataset?.vtiKb);e.kind=i,e.mode=i===`text`?`zh`:`num`,e.prevTextMode=`zh`,e.buffer=``,e.shift=!1,e.replaceAll=i===`text`?t.hasFullSelection(n):n.value.length>0,e.draft=i===`text`?``:n.value,e.visible=!0;try{n.scrollIntoView({block:`center`})}catch{}}function u(t=!1){s+=1,e.visible=!1,e.buffer=``,e.shift=!1;let n=r;if(r=null,t&&n)try{n.blur()}catch{}}function d(){return!r||!r.isConnected?(u(!1),null):r}function f(n){let r=d();if(r&&n){if(e.kind===`text`)t.insertIntoTextInput(r,n,e.replaceAll);else if(n.length===1)e.draft=t.applyCharToDraft(e.kind,e.draft,n,e.replaceAll),t.writeDraft(r,e.kind,e.draft);else{let i=e.replaceAll?``:e.draft;e.draft=t.normalizeDraft(e.kind,i+n),t.writeDraft(r,e.kind,e.draft)}e.replaceAll=!1}}function p(){let n=d();n&&(e.kind===`text`?t.backspaceTextInput(n):(e.draft=t.backspaceDraft(e.draft,e.replaceAll),t.writeDraft(n,e.kind,e.draft)),e.replaceAll=!1)}function m(){let n=t.resolveBufferCommit(e.buffer);e.buffer=``,f(n??``)}function h(t){d()&&(e.buffer=e.buffer.slice(t.consumed),f(t.text))}function g(t){e.mode===`zh`&&e.buffer&&m(),t===`num`&&e.mode!==`num`&&(e.prevTextMode=e.mode),e.mode=t,e.shift=!1}function _(n){if(!e.visible||!d())return;if(n===`backspace`){if(e.mode===`zh`&&e.buffer){e.buffer=e.buffer.slice(0,-1);return}p();return}if(n===`space`){if(e.mode===`zh`&&e.buffer){let e=c.value[0];e?h(e):m();return}e.kind===`text`&&f(` `);return}if(n===`done`){m(),u(!0);return}if(n===`shift`){e.shift=!e.shift;return}if(n===`mode:back`){g(e.prevTextMode);return}if(n.startsWith(`mode:`)){g(n.slice(5));return}let r=n;if(r.length===1&&(e.kind===`text`||t.isCharAllowed(e.kind,r))){if(e.mode===`zh`){if(r>=`a`&&r<=`z`){e.buffer+=r;return}if(r>=`A`&&r<=`Z`){e.buffer+=r.toLowerCase();return}m(),f(r)}else e.mode===`en`&&(r>=`a`&&r<=`z`||r>=`A`&&r<=`Z`)&&(r=e.shift?r.toUpperCase():r.toLowerCase(),e.shift=!1),f(r)}}function v(e){let t=e.target;i(t)&&(a&&t instanceof Node&&a.contains(t)||l(t))}function y(e){if(e.target!==r)return;let t=s;window.setTimeout(()=>{s===t&&u(!1)},0)}function b(e){a=e,!o&&(o=!0,document.addEventListener(`focusin`,v),document.addEventListener(`focusout`,y))}function x(){o&&=(document.removeEventListener(`focusin`,v),document.removeEventListener(`focusout`,y),!1),a=null,u(!1)}return{state:e,candidates:c,attach:b,detach:x,openFor:l,close:u,press:_,pickCandidate:h,getTarget:()=>r}}var o=a();function s(){return o}var c={class:`vti-kb__panel`},l={class:`vti-kb__strip`},u={class:`vti-kb__buffer`},d={key:0,class:`vti-kb__cands`},f=[`onPointerdown`],p={key:0,class:`vti-kb__hint`},m={key:1,class:`vti-kb__hint`},h=[`onPointerdown`],g={class:`vti-kb__row vti-kb__row--last`},_={key:0,type:`button`,class:`vti-kb__key vti-kb__key--ghost`,disabled:``},v={key:1,type:`button`,class:`vti-kb__key vti-kb__key--ghost`,disabled:``},y=[`onPointerdown`],b={class:`vti-kb__row vti-kb__row--num`},x=(0,n.defineComponent)({__name:`SoftKeyboard`,props:{instance:{},accent:{},background:{}},setup(e){let t=e,r=t.instance??o,i=(0,n.ref)(null),a=r.candidates,s=(0,n.computed)(()=>{let e={};return t.accent&&(e[`--vti-accent`]=t.accent),t.background&&(e[`--vti-bg`]=t.background),Object.keys(e).length>0?e:void 0});(0,n.onMounted)(()=>r.attach(i.value)),(0,n.onBeforeUnmount)(()=>r.detach());function x(e){e.preventDefault(),e.stopPropagation()}function S(e,t){x(e),r.press(t)}function C(e,t){x(e),r.pickCandidate(t)}let w=[[`q`,`w`,`e`,`r`,`t`,`y`,`u`,`i`,`o`,`p`],[`a`,`s`,`d`,`f`,`g`,`h`,`j`,`k`,`l`],[`z`,`x`,`c`,`v`,`b`,`n`,`m`]],T=[[`7`,`8`,`9`,`backspace`],[`4`,`5`,`6`,`.`],[`1`,`2`,`3`,`mode:back`]];function E(e){return r.state.mode===`en`&&r.state.shift?e.toUpperCase():e}function D(){return r.state.prevTextMode===`zh`?`拼音`:`英文`}return(e,t)=>((0,n.openBlock)(),(0,n.createElementBlock)(`div`,{ref_key:`rootRef`,ref:i,class:(0,n.normalizeClass)([`vti-kb`,{show:(0,n.unref)(r).state.visible}]),style:(0,n.normalizeStyle)(s.value),onPointerdown:x,onMousedown:x,onTouchstart:x,onClick:x,onContextmenu:t[10]||=(0,n.withModifiers)(()=>{},[`prevent`])},[(0,n.createElementVNode)(`div`,c,[(0,n.createElementVNode)(`div`,l,[(0,n.createElementVNode)(`span`,u,(0,n.toDisplayString)((0,n.unref)(r).state.mode===`zh`?(0,n.unref)(r).state.buffer:(0,n.unref)(r).state.draft),1),(0,n.unref)(r).state.mode===`zh`?((0,n.openBlock)(),(0,n.createElementBlock)(`div`,d,[((0,n.openBlock)(!0),(0,n.createElementBlock)(n.Fragment,null,(0,n.renderList)((0,n.unref)(a),(e,t)=>((0,n.openBlock)(),(0,n.createElementBlock)(`button`,{key:`${e.consumed}-${e.text}-${t}`,type:`button`,class:`vti-kb__cand`,onPointerdown:t=>C(t,e)},(0,n.toDisplayString)(e.text),41,f))),128)),(0,n.unref)(a).length===0?((0,n.openBlock)(),(0,n.createElementBlock)(`span`,p,`候选`)):(0,n.createCommentVNode)(``,!0)])):((0,n.openBlock)(),(0,n.createElementBlock)(`span`,m,(0,n.toDisplayString)((0,n.unref)(r).state.kind===`text`?`英文/数字`:(0,n.unref)(r).state.kind===`decimal`?`数字 · 小数`:`数字`),1))]),(0,n.unref)(r).state.mode===`num`?((0,n.openBlock)(),(0,n.createElementBlock)(n.Fragment,{key:1},[((0,n.openBlock)(),(0,n.createElementBlock)(n.Fragment,null,(0,n.renderList)(T,(e,t)=>(0,n.createElementVNode)(`div`,{key:`n${t}`,class:`vti-kb__row vti-kb__row--num`},[((0,n.openBlock)(!0),(0,n.createElementBlock)(n.Fragment,null,(0,n.renderList)(e,e=>((0,n.openBlock)(),(0,n.createElementBlock)(n.Fragment,{key:e},[e===`.`&&(0,n.unref)(r).state.kind===`digits`?((0,n.openBlock)(),(0,n.createElementBlock)(`button`,_,` · `)):e===`mode:back`&&(0,n.unref)(r).state.kind!==`text`?((0,n.openBlock)(),(0,n.createElementBlock)(`button`,v,` · `)):((0,n.openBlock)(),(0,n.createElementBlock)(`button`,{key:2,type:`button`,class:`vti-kb__key`,onPointerdown:t=>S(t,e)},(0,n.toDisplayString)(e===`backspace`?`退格`:e===`mode:back`?D():e),41,y))],64))),128))])),64)),(0,n.createElementVNode)(`div`,b,[(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--zero`,onPointerdown:t[8]||=e=>S(e,`0`)},` 0 `,32),(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--done`,onPointerdown:t[9]||=e=>S(e,`done`)},` 完成 `,32)])],64)):((0,n.openBlock)(),(0,n.createElementBlock)(n.Fragment,{key:0},[((0,n.openBlock)(),(0,n.createElementBlock)(n.Fragment,null,(0,n.renderList)(w,(e,i)=>(0,n.createElementVNode)(`div`,{key:`l${i}`,class:`vti-kb__row`},[i===2?((0,n.openBlock)(),(0,n.createElementBlock)(`button`,{key:0,type:`button`,class:(0,n.normalizeClass)([`vti-kb__key vti-kb__key--fn`,{on:(0,n.unref)(r).state.shift}]),onPointerdown:t[0]||=e=>S(e,`shift`)},` ⇧ `,34)):(0,n.createCommentVNode)(``,!0),((0,n.openBlock)(!0),(0,n.createElementBlock)(n.Fragment,null,(0,n.renderList)(e,e=>((0,n.openBlock)(),(0,n.createElementBlock)(`button`,{key:e,type:`button`,class:`vti-kb__key vti-kb__key--letter`,onPointerdown:t=>S(t,e)},(0,n.toDisplayString)(E(e)),41,h))),128)),i===2?((0,n.openBlock)(),(0,n.createElementBlock)(`button`,{key:1,type:`button`,class:`vti-kb__key vti-kb__key--fn`,onPointerdown:t[1]||=e=>S(e,`backspace`)},` 退格 `,32)):(0,n.createCommentVNode)(``,!0)])),64)),(0,n.createElementVNode)(`div`,g,[(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--fn`,onPointerdown:t[2]||=e=>S(e,`mode:num`)},` 123 `,32),(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--fn`,onPointerdown:t[3]||=e=>S(e,(0,n.unref)(r).state.mode===`zh`?`mode:en`:`mode:zh`)},(0,n.toDisplayString)((0,n.unref)(r).state.mode===`zh`?`英`:`拼`),33),(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--space`,onPointerdown:t[4]||=e=>S(e,`space`)},` 空格 `,32),(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--fn`,onPointerdown:t[5]||=e=>S(e,(0,n.unref)(r).state.mode===`zh`?`，`:`,`)},(0,n.toDisplayString)((0,n.unref)(r).state.mode===`zh`?`，`:`,`),33),(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--fn`,onPointerdown:t[6]||=e=>S(e,(0,n.unref)(r).state.mode===`zh`?`。`:`.`)},(0,n.toDisplayString)((0,n.unref)(r).state.mode===`zh`?`。`:`.`),33),(0,n.createElementVNode)(`button`,{type:`button`,class:`vti-kb__key vti-kb__key--done`,onPointerdown:t[7]||=e=>S(e,`done`)},` 完成 `,32)])],64))])],38))}});exports.KIND_OVERRIDE_VALUES=t.KIND_OVERRIDE_VALUES,exports.PINYIN_CHARS=e.PINYIN_CHARS,exports.PINYIN_PHRASES=e.PINYIN_PHRASES,exports.SoftKeyboard=x,exports.applyCharToDraft=t.applyCharToDraft,exports.backspaceDraft=t.backspaceDraft,exports.backspaceTextInput=t.backspaceTextInput,exports.candidatesFor=t.candidatesFor,exports.createSoftKeyboard=a,exports.draftToDomValue=t.draftToDomValue,exports.hasFullSelection=t.hasFullSelection,exports.insertIntoTextInput=t.insertIntoTextInput,exports.isCharAllowed=t.isCharAllowed,exports.isSoftInput=i,exports.normalizeDraft=t.normalizeDraft,exports.resolveBufferCommit=t.resolveBufferCommit,exports.resolveSoftKind=t.resolveSoftKind,exports.resolveSoftKindWithOverride=t.resolveSoftKindWithOverride,exports.softKeyboard=o,exports.useSoftKeyboard=s,exports.writeDraft=t.writeDraft,exports.writeInputValue=t.writeInputValue;

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * vue-touch-ime · 公开 API
+ *
+ * - SoftKeyboard：软键盘组件（挂到页面根部即可，输入框自动接管）
+ * - useSoftKeyboard / createSoftKeyboard：键盘会话（单例 / 独立实例）
+ * - 纯逻辑（也可从 `@junerver/vue-touch-ime/ime` 引入）：类型推断、拼音候选、
+ *   input 写值工具
+ * - 词典（也可从 `@junerver/vue-touch-ime/dict` 引入）：PINYIN_CHARS / PINYIN_PHRASES
+ */
+export { default as SoftKeyboard } from './SoftKeyboard.vue';
+export { createSoftKeyboard, isSoftInput, softKeyboard, useSoftKeyboard, type SoftKeyboard as SoftKeyboardInstance, type SoftKeyboardState, } from './useSoftKeyboard';
+export { applyCharToDraft, backspaceDraft, backspaceTextInput, candidatesFor, draftToDomValue, hasFullSelection, insertIntoTextInput, isCharAllowed, KIND_OVERRIDE_VALUES, normalizeDraft, resolveBufferCommit, resolveSoftKind, resolveSoftKindWithOverride, writeDraft, writeInputValue, type SoftCandidate, type SoftKbKind, type SoftKbMode, } from './ime';
+export { PINYIN_CHARS, PINYIN_PHRASES } from './pinyinDict';