@qnroa/qtype 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -13,6 +13,46 @@ can land in any minor bump (`0.x.0`).
 
 ## [Unreleased]
 
+## [0.2.4] — 2026-09-08
+
+Bug-fix + refactor pass around the ignore-punctuation setting and the
+plumbing that surfaces settings in the command palette and HUD menu.
+
+### Fixed
+- **Ignore-punctuation used to eat operators.** `+`, `-`, `*`, `/`,
+  `=`, `<`, `>`, `(`, `)` and other code / math symbols were treated
+  as punctuation, so turning the setting on rewrote whole code
+  passages into runs of blanks. The punctuation set is now the same
+  9 ASCII marks keybr / ptype / Monkeytype recognise
+  (`. , ! ? ; : ' " -` — sentence and clause marks only) plus the
+  corresponding CJK sentence marks, smart quotes, and Chinese book /
+  corner-bracket pairs. Operators and brackets pass through
+  unchanged.
+- **Arena stale-render after toggling ignore-punctuation.** Switching
+  the setting mid-card left the arena rendered against the previous
+  engine's target for a tick, so punctuation slots appeared to
+  linger until the next event. The arena is now keyed on
+  `${card.id}::${engine.target}`, forcing a full remount whenever
+  the engine's effective target changes — no stale
+  `useSyncExternalStore` subscription, no leftover DOM.
+
+### Changed
+- **HUD ⋮ menu is now registry-driven.** Every settings entry that
+  opts in via `hud: { icon, order? }` shows up as a quick toggle
+  during typing. `hint`, `ignoreCase`, `ignorePunctuation`,
+  `allowBackspace`, `showKeyboard`, `showHands` land in the menu by
+  default; `showPhonetic`, `showGloss`, `autoSpeak` show up on word
+  / sentence cards. Adding a new HUD toggle is now one registry
+  line.
+- **Command palette lists every setting.** The palette walks the
+  settings registry and emits a `setting.<id>` command per entry —
+  bool settings toggle inline; enum / number / action settings open
+  the settings dialog scrolled to the row. No more manually adding
+  palette entries for each new setting.
+- **`useHint()` extracted.** Three call sites were inlining the
+  same `usePersistedState<HintMode>('settings', 'hint', ...)` block;
+  they all use the shared hook now.
+
 ## [0.2.3] — 2026-09-07
 
 Fixes long-standing bugs around Chinese IME input on the typing arena

package/CHANGELOG.zh.md

@@ -12,6 +12,38 @@ English: [CHANGELOG.md](https://www.npmjs.com/package/@qnroa/qtype?activeTab=cod
 
 ## [Unreleased]
 
+## [0.2.4] — 2026-09-08
+
+围绕"忽略标点"设置和"命令面板 / HUD 菜单如何呈现设置"两件事,
+做了一轮修复和小重构。
+
+### 修复
+- **忽略标点误伤运算符。** 之前 `+ - * / = < > ( )` 等代码 / 数学
+  符号都被当成标点,一开设置就把整段代码替换成空格。改成和
+  keybr / ptype / Monkeytype 一致的 9 个 ASCII 句读
+  (`. , ! ? ; : ' " -`),加上对应的中文句号 / 逗号 / 冒号 / 分号 /
+  问号 / 感叹号 / 顿号 + 中文引号 / 书名号 / 角括号。运算符和括号
+  一律不动。
+- **切换忽略标点后 arena 一瞬间残留旧渲染。** 卡片打字中途切设置,
+  引擎重建了但 arena 的 fiber 被复用,`useSyncExternalStore`
+  订阅还挂在旧 engine 上,标点位置视觉错乱,得刷新才好。arena
+  的 React key 改成 `${card.id}::${engine.target}`,engine 目标
+  一变就整棵重挂,零残留。
+
+### 变更
+- **HUD ⋮ 菜单改为注册表驱动。** 设置条目里加 `hud: { icon, order? }`
+  就自动出现在打字时的快捷菜单。默认加入的:显示提示、忽略大小写、
+  忽略标点、允许退格、显示键盘、显示手位;word / sentence 卡片
+  额外多显示音标 / 释义 / 自动朗读。加一个 HUD 快捷开关现在只需
+  改注册表一行。
+- **命令面板列出所有设置。** 面板遍历设置注册表,给每个条目生成一条
+  `setting.<id>` 命令。bool 类型直接就地翻转;枚举 / 数字 / action
+  打开设置对话框并高亮那一行。新增设置不再需要单独往命令面板加
+  条目。
+- **抽出 `useHint()` hook。** 之前 3 个地方内联同样的
+  `usePersistedState<HintMode>('settings', 'hint', ...)`,现在统一用
+  这个 hook。
+
 ## [0.2.3] — 2026-09-07
 
 修复打字界面在中文输入法下的一系列老问题,并把"忽略标点"的行为

package/dist/core/typing/engine/TypingInput.js

@@ -216,35 +216,56 @@ function sameLetter(a, b) {
     return false;
 }
 /**
- * Rough Unicode punctuation test — ASCII punctuation + CJK
- * fullwidth range + common typographic marks. Kept explicit
- * (no `\p{P}` regex) so the check is fast and predictable.
+ * Sentence / clause punctuation, per keybr + ptype + Monkeytype
+ * conventions. Explicitly excludes math operators (`+ - * / = < >`),
+ * brackets (`( ) [ ] { }`), and code-symbol characters (`_ | \ @ # $
+ * % & ^ ~ \``) — those show up in real prose and code and should be
+ * typed as-is, not silently rewritten to space.
+ *
+ * Uses an inline set of codepoints instead of `\p{P}` — the Unicode
+ * punctuation category also matches math / brackets / dashes we want
+ * to leave alone, which is exactly why every mainstream typing app
+ * hard-codes its own list.
  */
 function isPunctuation(cp) {
-    // ASCII punctuation:  ! " # $ % & ' ( ) * + , - . /   : ; < = > ? @
-    // [ \ ] ^ _ `   { | } ~
-    if (cp >= 0x21 && cp <= 0x2f)
-        return true;
-    if (cp >= 0x3a && cp <= 0x40)
-        return true;
-    if (cp >= 0x5b && cp <= 0x60)
-        return true;
-    if (cp >= 0x7b && cp <= 0x7e)
-        return true;
-    // CJK Symbols and Punctuation
-    if (cp >= 0x3000 && cp <= 0x303f)
-        return true;
-    // Fullwidth ASCII forms (includes fullwidth punctuation)
-    if (cp >= 0xff01 && cp <= 0xff0f)
-        return true;
-    if (cp >= 0xff1a && cp <= 0xff20)
-        return true;
-    if (cp >= 0xff3b && cp <= 0xff40)
-        return true;
-    if (cp >= 0xff5b && cp <= 0xff65)
-        return true;
-    // General Punctuation block
-    if (cp >= 0x2000 && cp <= 0x206f)
-        return true;
-    return false;
+    switch (cp) {
+        // ASCII sentence / clause marks.  .  ,  !  ?  ;  :  '  "
+        case 0x2e:
+        case 0x2c:
+        case 0x21:
+        case 0x3f:
+        case 0x3b:
+        case 0x3a:
+        case 0x27:
+        case 0x22:
+        // CJK sentence marks:  。  、
+        case 0x3001:
+        case 0x3002:
+        // Fullwidth forms:  ！  ？  ，  ：  ；  ＇  ＂
+        case 0xff01:
+        case 0xff1f:
+        case 0xff0c:
+        case 0xff1a:
+        case 0xff1b:
+        case 0xff07:
+        case 0xff02:
+        // Smart quotes:  " "  ' '
+        case 0x201c:
+        case 0x201d:
+        case 0x2018:
+        case 0x2019:
+        // Book title marks:  《 》  〈 〉
+        case 0x300a:
+        case 0x300b:
+        case 0x3008:
+        case 0x3009:
+        // CJK corner brackets:  「 」  『 』
+        case 0x300c:
+        case 0x300d:
+        case 0x300e:
+        case 0x300f:
+            return true;
+        default:
+            return false;
+    }
 }