@dybai/dsh-editor 0.11.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -102,6 +102,30 @@
102
102
  - 跨窗口实时生效:任一偏好写入成功后经 `BroadcastChannel` 广播(不可用时降级 localStorage 通知),其他窗口收到后立即重读全部偏好缓存并生效;窗口重新聚焦 / 页面恢复可见时再兜底刷新一次。双窗口同时改同一项由 Host 侧 CAS 拒绝后写者(提示后重读,不静默覆盖);
103
103
  - 覆盖面与边界:外观 / 行为 / 换行作用于所有已挂载编辑器与之后新开的文件。第三方模式仍经组件 prop `wordWrap` 收到**当前文件的三层链最终值**,不感知层级(见 [docs/contracts.md](docs/contracts.md) §5.5 / §8);设置中心本身是纯 UI 演进,不新增第三方契约面(第三方设置分区座位本期不开放)。
104
104
 
105
+ **空白字符显示**(0.12.0):
106
+
107
+ - 设置中心「外观」分区新增「空白字符显示」分组的三行开关:**显示空格**(空格字符渲染为浅色间隔号 `·`)、**显示制表符**(制表符渲染为浅色箭头 `→` 并补位到下一制表停位,4 列默认)、**显示换行符**(每个行断的行尾渲染浅色回车符 `↵`,**每个真实行断都显示**——`a\nb\n` 显示 `a↵\nb↵`,文件末尾回车立即反馈,不再有「补画一次」的滞后)。三行相互独立、默认全关,全局持久化,对所有已挂载编辑器立即生效,并经既有跨窗口同步(`BroadcastChannel`,不可用时降级 localStorage 通知)实时生效到其他窗口;
108
+ - 字形为浅色:取标签色约 25% 不透明度、随主题自适应,垫在正文之下不干扰阅读;被选中文本内的字形由原生选区背景覆盖(v1 接受的取舍);
109
+ - 不折行与折行两种模式下对齐保真:不折行时字形层按行高窗口算术定位(可视行 ±2 行缓冲),折行时与框架折行机器共享同一套逐视觉行文本切片——`↵` 只出现在逻辑行的**最后一个视觉行**行尾,字形进宽由 CSS 强制为一字宽、行 span 不自行折行,字形与正文逐行对位;
110
+ - 纯显示层:字形只画在独立的覆盖层里,文件内容一个字符都不会被改写,保存回磁盘的仍是原始文本;三个开关全关时字形层不挂载、零成本;
111
+ - 第三方模式志愿接入:`showWhitespace` prop(`{ spaces, tabs, newlines }` 实时布尔对象)直接送达到每个挂载的模式组件,无描述符声明字段,自行绘制空白字形的模式可据此对齐用户意图,不支持的模式安全忽略(见 [docs/contracts.md](docs/contracts.md) §5.1 / §5.5)。
112
+
113
+ **Tab 缩进**(0.13.0):
114
+
115
+ - 内置纯文本模式编辑区**固定占用 Tab / Shift+Tab**(缩进 / 反缩进,不可录制、不受键位自定义影响),且**四相位(加载中 / 就绪 / 保存中 / 失败)一律吞键,焦点永不逃逸**编辑区——再也不会按一下 Tab 把焦点丢到窗格外;
116
+ - 三种选区形态全覆盖:**折叠光标**插入一个缩进单位、**单行选区**被缩进单位替换、**跨行选区**整块缩进(每个触及行行首插入单位);Shift+Tab 反缩进逐行删去一个前导制表符或最多一个宽度单位的前导空格,所有触及行都无可删时吞键不写回;
117
+ - 缩进模式「**自动探测**」按文件本身判定:扫描前 200 个非空行,任一行以制表符开头立即判定制表符缩进;否则统计 1–16 列的前导空格宽度、出现最频者胜(并列取更小宽度);文件无任何信号时回退到设置的缩进宽度(默认 4);
118
+ - 设置中心新增「**缩进**」分区:**模式**(自动探测 / 制表符 / 空格)与**宽度**(2 / 4 / 8)两个分段选择器,写入全局设置、对所有已挂载编辑器立即生效,并经既有跨窗口同步(`BroadcastChannel`,不可用时降级 localStorage 通知)实时生效到其他窗口;宽度行仅在「空格」模式下可用,其余模式禁用并注明「自动探测无信号时也用它作回退宽度」;
119
+ - **撤销保真**:写入走 `document.execCommand('insertText')` 主路径,保留浏览器**原生撤销栈**——一次缩进(含整块跨行缩进)Ctrl+Z 一步回退;execCommand 不可用或反缩进拼接形状不安全时回退机器内容写命令(与删行同模式:功能可用,但该步不进原生撤销);
120
+ - **键位录制器**扩展保留组合规则:裸 Tab 与 Shift+Tab 拒绝录制(编辑器缩进固定占用),快捷键分区的保留组合提示同步更新(见 [docs/contracts.md](docs/contracts.md) §5.1 / §6 / §8)。
121
+
122
+ **行尾保留**(0.13.0):
123
+
124
+ - 打开 CRLF / CR 文件后编辑保存,**行尾不再被改写成 LF**:读入时探测文件行尾(混合行尾按主导行尾归一),保存时把编辑内容还原为该行尾写盘(VS Code 同构);此前 CRLF 文件经「打开→保存」会被静默转换为 LF;
125
+ - 编辑器内部与显示层恒为 LF(textarea 硬约束,`\r` 无法在文本区呈现)——空白字符显示的 `↵` 按 LF 断行绘制,与行尾保留互不影响;新建文件默认 LF;
126
+ - 无新增契约面:`writeFile` 的 wire 形状不变,`content` 携带文件原生行尾(见 [docs/contracts.md](docs/contracts.md) §1 / §8);
127
+ - 显示层同步区分:换行符显示开启时,CRLF 文件的每个行断画 **␍+↵ 双记号**(与文件字节一对一)、CR 文件画 **␍**、LF 维持 **↵**;混合行尾按主导行尾显示(与保存归一一致);机器公共 state 新增 additive 字段 `eol`(第三方模式可经 controller 订阅读取,见 [docs/contracts.md](docs/contracts.md) §4.2)。
128
+
105
129
  ## 集成接口摘要
106
130
 
107
131
  | 契约面 | 入口 | 一句话 |